client_nodes schema

Canonical generated docsThis section is generated from caco config schema --json. The table below preserves the runtime field path, type, required/default markers, and canonical description for every value in this slice.

Daemonless client-only nodes such as mobile apps.

Field path	Type	Required	Canonical description
`client_nodes`	`section`	optional	Daemonless client-only nodes such as mobile apps.
└ `client_nodes.<client-name>`	`map`	optional	Client-only node entry.
└ `client_nodes.<client-name>.name`	`string`	optional	Stable client node name (defaults to map key).
└ `client_nodes.<client-name>.bootstrap_url`	`string`	optional	Daemon/bootstrap URL used to fetch config and certificate material.
└ `client_nodes.<client-name>.bootstrap_token_file`	`string`	optional	Path to bootstrap or node token material for the client.
└ `client_nodes.<client-name>.certificates`	`map`	optional	Client certificate material references.
└ `client_nodes.<client-name>.certificates.ca`	`string`	optional	CA certificate path.
└ `client_nodes.<client-name>.certificates.cert`	`string`	optional	Client certificate path.
└ `client_nodes.<client-name>.certificates.key`	`string`	optional	Client private-key path.
└ `client_nodes.<client-name>.certificates.issue`	`string`	optional	Issuance mode hint such as bootstrap_join or operator_issued.
└ `client_nodes.<client-name>.command_server`	`map`	optional	Daemonless client command-server listener settings.
└ `client_nodes.<client-name>.command_server.bind`	`string`	optional	Local bind host/interface: loopback, wildcard, explicit IP/interface, or literal 'tailnet'.
└ `client_nodes.<client-name>.command_server.host`	`string`	optional	Advertised host for caco remote and callbacks; required for bind=tailnet until live self-discovery supplies the endpoint.
└ `client_nodes.<client-name>.command_server.port`	`u16`	optional	Local command-server port; omitted uses the surface default.
└ `client_nodes.<client-name>.command_server.public_port`	`u16`	optional	Public/tailnet port when distinct from local port.
└ `client_nodes.<client-name>.spawn_defaults`	`map`	optional	Spawn defaults for agents spawned from this client node, overlaid on the global spawn_defaults.
└ `client_nodes.<client-name>.spawn_defaults.node`	`string`	optional	Default placement node for spawns originating from this node; used when a spawn does not name an explicit target.
└ `client_nodes.<client-name>.interactive_defaults`	`map[string, map]`	optional	Interactive agent defaults for sessions launched from this client node, keyed by runtime type.
└ `client_nodes.<client-name>.interactive_defaults.<runtime-type>`	`map`	optional	Defaults for a specific runtime type.
└ `client_nodes.<client-name>.interactive_defaults.<runtime-type>.project`	`string`	optional	Default project for interactive sessions when --project is not provided.
└ `client_nodes.<client-name>.interactive_defaults.<runtime-type>.profile`	`string \| list[string]`	optional	Default profile or profile composition list.
└ `client_nodes.<client-name>.interactive_defaults.<runtime-type>.goal`	`string`	optional	Default goal / task description. Supports {{project}}, {{node}} template expressions.
└ `client_nodes.<client-name>.interactive_defaults.<runtime-type>.model`	`string`	optional	Default model override.
└ `client_nodes.<client-name>.interactive_defaults.<runtime-type>.provider`	`string`	optional	Default provider override.
└ `client_nodes.<client-name>.interactive_defaults.<runtime-type>.env`	`map[string, string]`	optional	Additional environment variables to inject.
└ `client_nodes.<client-name>.interactive_defaults.<runtime-type>.mcp_servers`	`list[string]`	optional	Additional MCP server names to attach.