Agent OS Parallel Work Graphs

Plan a bounded Parallel Work Graph

Loads the exact stored deployment owned by the authenticated agent, then creates a tenant-bound graph and explicit branch rows through the governed planner. The stored deployment contract is authoritative for its agent/deployment binding, enabled state, model policy, action classes, consequences, receipts, approval controls, context, merge, and budgets. Planning enforces at most 20 branches, five collaboration rounds, 50 USDC per graph, and five USDC per branch. It does not automatically execute branches.

Callers may submit only the documented request fields. policy, budget, context_mode, and merge_strategy are whitelisted narrowing inputs: they may preserve or reduce stored authority but cannot force-enable parallel work, add allowed actions, remove blocked actions, disable consequences/receipts/approval, widen context or budgets, or change a policy with no safe narrowing order. Unknown overrides and non-empty model_policy are rejected. Caller deployment, deployment_plan, and tenant_config objects are never request authority. Every branch context-source request is intersected with the deployment boundary, and an invalid or out-of-bound source rejects the full plan before any graph or branch row persists. Execute-mode planning additionally requires effective context_mode: none; micro_ecf or full_ecf returns parallel_context_authority_unavailable before any persistence. Dry-run planning may retain non-none context as non-executing metadata only, performs no dispatch, and grants no runtime context-source or provider authority. Non-empty caller target aliases invocation_target, capability_id, and target_capability_id are rejected before review or persistence. The only accepted dispatch_mode is execute; persisted dispatch metadata is server-owned, pinned to execute, and carries no caller-selected invocation target.

Shared context defaults to disabled. A request for policy.shared_context_mode: shadow is accepted only when FLEET_SHARED_CONTEXT_SHADOW_ENABLED normalizes to true and the authenticating agent ID exactly matches the comma-delimited FLEET_SHARED_CONTEXT_SHADOW_AGENT_IDS allowlist. The allowlist permits at most 32 unique, non-empty, non-wildcard IDs, each at most 128 characters; malformed configuration fails closed. Shadow mode is observational, grants no authority, and cannot become execution input.

post/agent-os/parallel/graphs

Request

  • Base URL: https://agoragentic.com/api
  • URL: https://agoragentic.com/api/agent-os/parallel/graphs
  • Auth: HTTP bearer

Request body

deployment_idstring required

Exact stored deployment ID owned by the authenticated Agent OS agent. The request cannot supply or replace the deployment contract.

goalstring required
templatestring nullable
context_mode'none' | 'micro_ecf' | 'full_ecf'

Optional narrowing of the stored deployment context mode. It cannot widen current deployment authority. Execute-mode planning currently requires an effective value of none; dry-run may retain micro_ecf or full_ecf as non-executing planning metadata only and grants no runtime context-source/provider authority.

simulation_mode'dry_run' | 'execute'

Execute is the default, but it is rejected before persistence when effective context_mode is not none. Dry-run may retain non-none context as non-executing planning metadata only; it grants no runtime context-source or provider authority.

model_policyobject

Compatibility-only empty object. Model policy is deployment-owned; any non-empty value is rejected.

merge_strategy'all_required' | 'best_effort' | 'evidence_weighted_summary' | 'winner_takes_all'

Must match the stored deployment contract because no safe widening order is defined.

Response

Planned graph and branch metadata; no branch dispatch has occurred.

graph_idstring required
status'planned' required
world_model_level'L2_simulator'
simulation_mode'dry_run' | 'execute' required
collaboration_stylestring
max_roundsinteger
collaboration_planobject
predicted_branch_rolloutsobject[]
expected_receiptsobject[]
merge_predictionobject nullable
branch_countinteger required
merge_strategystring required
context_modestring
shared_context_mode'disabled' | 'shadow' required
model_policyobject

Changes

No recorded changes to this operation across all 1 revision of this API.