ZooidConfig

Defined in: types.ts:262

Parsed zooid.yaml shape. Always multi-agent — agents: is required and must have at least one entry. At least one transport must be declared and each agent must reference one by name.

Properties

runtime

runtime: "local" | "docker" | "podman"

Defined in: types.ts:263

---

workstation?

optional workstation?: string

Defined in: types.ts:270

Workstation identity. A short, lowercase, hyphen-separated name that uniquely identifies this daemon instance (e.g. laptop, ec2-prod). When set, the matrix transport derives sender_localpart and user_namespace from it, enabling exclusive per-workstation AS namespaces.

---

container?

optional container?: ZooidContainerConfig

Defined in: types.ts:272

Workforce-wide container defaults. Image only — no workforce-level env. Rejected when runtime: local.

---

transports

transports: Record<string, TransportConfig>

Defined in: types.ts:274

Required. Map of operator-chosen names → transport config. At least one entry.

---

agents

agents: Record<string, AgentConfig>

Defined in: types.ts:276

Required. Must have at least one entry.

---

hooks

hooks: object

Defined in: types.ts:278

Workforce-wide hook defaults. Merged into each agent.hooks at load time.

pre_turn?

optional pre_turn?: string

post_turn?

optional post_turn?: string

---

triggers

triggers: Record<string, TriggerConfig>

Defined in: types.ts:283

Optional. Map of trigger name → trigger. Empty map when the block is absent.