AgentConfig

Defined in: types.ts:147

Per-agent config inside a multi-agent zooid.yaml. Each agent has its own workspace, hooks, an ACP block describing the shim to spawn, and exactly one transport-kind block (matrix or http).

Properties

name

name: string

Defined in: types.ts:153

Routing name. Always the agent’s key in ZooidConfig.agents — cannot be overridden, and a name: field under an agent is silently ignored. The key must match /^[a-z][a-z0-9-]{0,31}$/.

---

workdir

workdir: string

Defined in: types.ts:158

Host directory for the agent’s workspace.

Default

./agents/<name>

---

hooks

hooks: object

Defined in: types.ts:160

Per-agent hooks. Workforce-wide hooks are merged in at load time.

pre_turn?

optional pre_turn?: string

post_turn?

optional post_turn?: string

---

acp

acp: AcpAgentSpec

Defined in: types.ts:165

Required: how to launch this agent’s ACP shim.

---

approval_timeout_ms

approval_timeout_ms: number

Defined in: types.ts:174

Wall-clock timeout for pending permission requests, in milliseconds. 0 = no timeout. The paused agent’s idle cost is negligible, so opt-in is the right shape — set this only if you’re running in a scale-to-zero / serverless context where unbounded waits would hold resources.

Default

0

---

container?

optional container?: ContainerConfig

Defined in: types.ts:176

Container config. Rejected at parse time when runtime: local.

---

matrix?

optional matrix?: MatrixBinding

Defined in: types.ts:178

Exactly one of matrix / http is set per agent.

---

http?

optional http?: HttpBinding

Defined in: types.ts:179