Connect agent pack

Reviewed source-contract reference. CLI 0.13.4 is released. Hosted pack contracts below are taken from Agent source 573c9a11b1b6674b163ce21273a162a4ed453282; their activation and deployed worked responses remain pending. This draft does not establish settings, shared context or intake acceptance for the existing 70 Codex and 70 Claude agents.

Outcome

Connect portable agent pack identities, scoped continuity and Bytes artifacts through published workspace contracts.

POST /api/agent-packs

Before calling

Discover the exact credential-scoped published action and intended context. Bind the authorized Agent workspace when required. Confirm the declared agents:write permission. Plan and confirm the unchanged mutation; this draft does not authorize it.

Input fields

Source input template

The following schema-based example is illustrative and has not been executed. Every fixture identifier/decision reference must be replaced with a genuinely discovered resource or recorded decision. Do not send it unchanged.

{
  "instanceId": "example-pack-instance",
  "packId": "founder",
  "packVersion": "1.0.0",
  "ownershipScope": "user",
  "bytesWorkspaceId": "fixture_bytes_workspace",
  "bytesScope": "private",
  "roles": [
    {
      "logicalId": "intakes/intake",
      "agentId": "fixture_agent",
      "agentVersionId": "fixture_agent_version",
      "instructions": "Reviewed illustrative intake instructions; start idle."
    }
  ]
}

Interpret and verify

• Call app_topolo_agent.agent_packs.get with instanceId and compare manifestHash, roles, ownership and Bytes workspace.

The exact input and output schemas accompany this draft in the hidden agent layer and contract bundle. No successful/refused deployed response is supplied here; capture and validate it after the original activation/usage proof.

Effects

• Atomically binds existing published agent versions and operating instructions to an immutable pack instance and verified Bytes workspace. Identical input replays the connection. No agent is created, invoked or granted permissions.

Errors and recovery

• 409 state_conflict: Read the existing connection and published agent versions. Never overwrite an instance or steal an agent binding.

Disconnect the pack. Existing agents, memories, histories and Bytes files remain.