diff --git a/docs/assets/frontier-agent-workloads/architecture.svg b/docs/assets/frontier-agent-workloads/architecture.svg new file mode 100644 index 00000000..2809882e --- /dev/null +++ b/docs/assets/frontier-agent-workloads/architecture.svg @@ -0,0 +1,79 @@ + + + + + +Recommended OpenShell deployment for long-running frontier workloadsThe trusted control node hosts OpenShell gateway, Policy Advisor, prover, protected provider credentials and supervisor. Operator integrations provide SDK review, a maximum-policy gate, egress inspection and behavior monitoring with trusted stop controls. A separate untrusted sandbox node hosts a disposable VM and agent workload. The recommended external network boundary denies independent internet access. This is a component placement recommendation, not a verified deployment. Administrative channels are omitted and must be secured. + + + + + + + +TASK-SCOPED EXTERNAL SERVICES +Model endpoint · code repositories · approved data and APIs +CONTROL NODE · TRUSTED + +OPENSHELL +OPERATOR INTEGRATIONS + +Gateway +Policy Advisor · policy prover +Provider secrets + protected key storage + +SDK review integration +Task judgment +Fixed maximum-policy gate + +Supervisor +Policy enforcement · credential binding +Opens permitted upstream connections + +Egress watchdog +Inspect supported traffic +Apply task-specific limits + +Agent behavior watchdog +Correlate activity · retain evidence · invoke trusted stop controls + + + + +SANDBOX NODE · UNTRUSTED + + +DISPOSABLE VM +OpenShell workload +Tools · task files · scratch space + +Frontier agent +No raw provider secrets + +External network boundary +No independent internet access +Enforced outside the sandbox node + +MEDIATED +TRAFFIC + + +NO DIRECT EGRESS + + + + diff --git a/docs/assets/frontier-agent-workloads/hero.png b/docs/assets/frontier-agent-workloads/hero.png new file mode 100644 index 00000000..c2439739 Binary files /dev/null and b/docs/assets/frontier-agent-workloads/hero.png differ diff --git a/docs/assets/frontier-agent-workloads/permission-workflow.svg b/docs/assets/frontier-agent-workloads/permission-workflow.svg new file mode 100644 index 00000000..807155d5 --- /dev/null +++ b/docs/assets/frontier-agent-workloads/permission-workflow.svg @@ -0,0 +1,85 @@ + + + + + +Recommended permission review and runtime enforcement workflowThe operator establishes a starting policy, task purpose and protected maximum. The agent requests access through OpenShell Policy Advisor. A human or AI reviewer judges necessity; an operator gate uses the OpenShell prover on the complete effective candidate. Both approvals are required before exact reviewed inputs can be activated and their application confirmed. A retry passes supervisor policy, egress middleware and credential binding before reaching the service. Behavior monitoring, drift detection, trusted evidence and stopping remain active. Unsupported or inconclusive proof withholds the grant. This is a recommended integration, not a native turnkey workflow or host-containment proof. + + + + + + + + +OPERATOR-DETERMINED TASK +Starting policy + authorized purpose +Context for review; agent claims remain untrusted. + +OPERATOR-CONTROLLED MAXIMUM +The agent and reviewer cannot widen this boundary. +Protect the ceiling and gate every policy mutation path. + +BOUNDARY INPUT + +Agent +Requests narrow access +for the task + +Policy Advisor +Validates proposal +Reports added risk + +Reviewer +Human or AI via SDK +Judges task necessity + +Ceiling gate +OpenShell prover +Full effective candidate + +Activate policy +Exact reviewed inputs +Confirm policy loaded + + + + +Rejected, stale or unproven candidates do not activate. + +EVERY RETRIED REQUEST STILL PASSES THROUGH RUNTIME CONTROLS + + +Supervisor policy +Is this request allowed? + +Egress watchdog +Inspect + enforce limits + +Credential binding +Supervisor attaches secret + +Allowed service +Task-scoped operation + + + + +Throughout the run +Behavior monitoring · policy and provider drift checks · trusted evidence · independent stop path + + diff --git a/docs/dev-notes/index.md b/docs/dev-notes/index.md index be6ad9b2..e1359ed6 100644 --- a/docs/dev-notes/index.md +++ b/docs/dev-notes/index.md @@ -50,11 +50,40 @@ hide:
-