nodes schema (301-450)

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.

Node definitions — machines in the cluster.

Previous Next

Field path	Type	Required	Default	Canonical description
└ `nodes.speech.stt.agent.smart_append`	`bool`	optional	false	Whether smart append (per-chunk cleanup) is enabled.
└ `nodes.speech.stt.agent.enter_after_completed`	`bool`	optional	false	Send Enter keypress after transcription completes.
└ `nodes.speech.stt.terminal`	`map`	optional		Per-target STT config for terminal/shell panes.
└ `nodes.speech.stt.terminal.rewriting`	`bool`	optional	false	Whether smart rewriting is enabled for this target.
└ `nodes.speech.stt.terminal.smart_append`	`bool`	optional	false	Whether smart append (per-chunk cleanup) is enabled.
└ `nodes.speech.stt.terminal.enter_after_completed`	`bool`	optional	false	Send Enter keypress after transcription completes.
└ `nodes.speech.stt.scratchpad`	`map`	optional		Per-target STT config for scratchpad notes.
└ `nodes.speech.stt.scratchpad.rewriting`	`bool`	optional	false	Whether smart rewriting is enabled for this target.
└ `nodes.speech.stt.scratchpad.smart_append`	`bool`	optional	false	Whether smart append (per-chunk cleanup) is enabled.
└ `nodes.speech.stt.scratchpad.enter_after_completed`	`bool`	optional	false	Send Enter keypress after transcription completes.
└ `nodes.speech.stt.text_field`	`map`	optional		Per-target STT config for text fields / chat compose.
└ `nodes.speech.stt.text_field.rewriting`	`bool`	optional	false	Whether smart rewriting is enabled for this target.
└ `nodes.speech.stt.text_field.smart_append`	`bool`	optional	false	Whether smart append (per-chunk cleanup) is enabled.
└ `nodes.speech.stt.text_field.enter_after_completed`	`bool`	optional	false	Send Enter keypress after transcription completes.
└ `nodes.speech.stt.bead`	`map`	optional		Per-target STT config for bead create form fields.
└ `nodes.speech.stt.bead.rewriting`	`bool`	optional	false	Whether smart rewriting is enabled for this target.
└ `nodes.speech.stt.bead.smart_append`	`bool`	optional	false	Whether smart append (per-chunk cleanup) is enabled.
└ `nodes.speech.stt.bead.enter_after_completed`	`bool`	optional	false	Send Enter keypress after transcription completes.
└ `nodes.speech.io`	`map`	optional		Audio I/O routing.
└ `nodes.speech.io.output`	`map`	optional		Output audio routing.
└ `nodes.speech.io.output.mode`	`string`	optional		Routing mode: local-default, local-device, pulse-default, or a named pulse output.
└ `nodes.speech.io.output.device`	`string`	optional		Explicit device identifier (only for local-device mode).
└ `nodes.speech.io.input`	`map`	optional		Input audio routing.
└ `nodes.speech.io.input.mode`	`string`	optional		Routing mode: local-default, local-device, pulse-default, or a named pulse output.
└ `nodes.speech.io.input.device`	`string`	optional		Explicit device identifier (only for local-device mode).
└ `nodes.speech.io.outputs`	`list[map]`	optional		Named PulseAudio output endpoints for TUI cycle rotation.
└ `nodes.speech.io.outputs.server`	`string`	required		PulseAudio server address (host:port).
└ `nodes.speech.io.outputs.name`	`string`	required		Human-readable name used in TUI cycle and io.output.mode.
└ `nodes.speech.io.outputs.device`	`string`	optional		Optional PulseAudio sink name; uses the server default when omitted.
└ `nodes.speech.io.inputs`	`map[string, map]`	optional		Named audio input sources.
└ `nodes.speech.io.inputs.type`	`string`	required		Input source type: alsa, pulse, ssh_pulse, or device_mic.
└ `nodes.speech.io.inputs.device`	`string`	optional	default	Audio input device/source name.
└ `nodes.speech.io.inputs.server`	`string`	optional		PulseAudio server address for pulse inputs.
└ `nodes.speech.io.inputs.node`	`string`	optional		Target node name for ssh_pulse inputs.
└ `nodes.speech.io.inputs.scheme`	`string`	optional		Device URI scheme for device_mic inputs: android, iphone, or watchos.
└ `nodes.speech.io.inputs.host`	`string`	optional		Device host/IP reachable from the daemon for device_mic inputs.
└ `nodes.speech.io.inputs.port`	`u16`	optional		Device in-app HTTP server port serving /mic for device_mic inputs.
└ `nodes.speech.io.inputs.token`	`string`	optional		Bearer token for the device_mic /mic endpoint. May be supplied here or resolved from a daemon-known device token at capture time.
└ `nodes.speech.read_messages_aloud`	`bool`	optional	false	Auto read-aloud incoming messages on startup.
└ `nodes.speech.agent_audio`	`map[agent_id, agent_audio_override]`	optional		Per-agent audio overrides (mute, voice, voice_filter, speed). Independent from daemon-side mute. See.
└ `nodes.speech.audio`	`map`	optional		Cluster-wide and dimension-scoped audio mute policy: global_mute, default_agent_mute, and by_project/by_node/by_surface/by_profile/by_agent_role/by_agent_name. See and.
└ `nodes.sync`	`map`	optional		Node-level sync overrides.
└ `nodes.tui`	`map`	optional		Node-level TUI overrides.
└ `nodes.services`	`map`	optional		Node-scoped service listeners.
└ `nodes.services.caco-daemon`	`map`	required		Daemon listener for this node.
└ `nodes.services.caco-daemon.port`	`u16`	required		Local service port.
└ `nodes.services.caco-daemon.cluster_port`	`u16`	optional	port + 1000	Cluster-facing port.
└ `nodes.services.caco-daemon.public_cluster_port`	`u16`	optional	cluster_port	Externally advertised cluster port.
└ `nodes.services.caco-daemon.bind_host`	`string`	optional	node.host	Explicit cluster-listener bind host; literal 'tailnet' is temporarily rejected after pending a one-node socket/peer-connectivity canary with rollback.
└ `nodes.services.caco-daemon.local_bind_host`	`string`	optional	127.0.0.1	Explicit local bearer-API bind host; adds a loopback-plus-Tailnet candidate, but literal 'tailnet' remains rejected pending the one-node runtime canary with rollback.
└ `nodes.services.caco-daemon.sidecar`	`u16`	optional		Sidecar port.
└ `nodes.services.caco-daemon.sidecar_cluster_port`	`u16`	optional	sidecar + 1000	Sidecar cluster port.
└ `nodes.services.caco-tts-daemon`	`map \| list[map]`	optional		Headless TTS daemon for this node.
└ `nodes.services.caco-tts-daemon.name`	`string`	optional	default	Instance name for multi-daemon setups. Defaults to 'default'.
└ `nodes.services.caco-tts-daemon.tts`	`map`	optional		Override TTS settings for this daemon instance.
└ `nodes.services.caco-tts-daemon.tts.n`	`u32`	optional	1	Maximum simultaneous agent speech slots. Default/effective 1; values <=1 play sequentially, values >1 allow that many concurrent TTS daemon playback slots.
└ `nodes.services.caco-tts-daemon.tts.overlap_secs`	`u64`	optional		Optional cap on concurrent TTS daemon playback overlap. Omitted allows full-slot overlap; 0 disables intentional overlap; positive values cap overlap to that many seconds.
└ `nodes.services.caco-tts-daemon.tts.chime`	`map`	optional		Deterministic per-agent chime prepended before TTS playback (generalized note count/length/gap config). Omit to disable; present defaults to a 3-note C minor chime with no transposition.
└ `nodes.services.caco-tts-daemon.tts.chime.enabled`	`bool`	optional	true	Enable or disable this chime object.
└ `nodes.services.caco-tts-daemon.tts.chime.root_note`	`string`	optional	C	Scale root note such as C, C#, Db, F sharp, or Bb.
└ `nodes.services.caco-tts-daemon.tts.chime.scale`	`string`	optional	minor	Scale type for note slots: major or minor.
└ `nodes.services.caco-tts-daemon.tts.chime.transpose_semitones`	`i32`	optional	0	Semitone transposition applied after root/scale resolution. Aliases: transpose, transposition.
└ `nodes.services.caco-tts-daemon.tts.chime.num_notes`	`u32`	optional	3	Number of notes derived from the agent id (1..=16). Defaults to 3, the historical fixed chime.
└ `nodes.services.caco-tts-daemon.tts.chime.note_length_ms`	`u32 or list`	optional	130	Per-note duration in ms: a single uniform value or a per-note list (short lists pad with the 130ms default).
└ `nodes.services.caco-tts-daemon.tts.chime.gap_length_ms`	`u32 or list`	optional	35	Gap between notes in ms: a single uniform value or a per-gap list of length num_notes-1 (short lists pad with the 35ms default).
└ `nodes.services.caco-tts-daemon.tts.model`	`string`	optional		TTS model identifier (provider-dependent).
└ `nodes.services.caco-tts-daemon.tts.command_template`	`string`	optional		Shell command template for ad-hoc TTS adapters. Uses env vars such as $BODY and optional $OUTPUT_FILE.
└ `nodes.services.caco-tts-daemon.tts.voice`	`string`	optional		Default voice name.
└ `nodes.services.caco-tts-daemon.tts.voices`	`list[string]`	optional		Additional voice names merged into the capabilities voice list.
└ `nodes.services.caco-tts-daemon.tts.voice_rotation`	`bool`	optional	true	Auto-assign distinct voices per agent sender.
└ `nodes.services.caco-tts-daemon.tts.speed`	`f32`	optional		Playback speed multiplier (0.25–4.0). 1.0 = normal.
└ `nodes.services.caco-tts-daemon.tts.speed_queue_modifier`	`f32`	optional	0.0	Queue-length-aware speed modifier. Effective speed = min(base + speed_queue_modifier * shared_pending_queue_depth, max_speed). 0.0 (default) preserves base speed.
└ `nodes.services.caco-tts-daemon.tts.max_speed`	`f32`	optional	3.0	Upper bound for queue-aware effective playback speed. Default 3.0.
└ `nodes.services.caco-tts-daemon.tts.agent_dms`	`map`	optional		Optional direct agent-message readout overlay. Inherits normal TTS settings unless fields here override them.
└ `nodes.services.caco-tts-daemon.tts.agent_dms.read_aloud`	`bool`	optional	false	Read direct agent-message feed events aloud. Default false.
└ `nodes.services.caco-tts-daemon.tts.agent_dms.speed`	`f32`	optional		Optional speed override for direct-message readout.
└ `nodes.services.caco-tts-daemon.tts.agent_dms.speed_queue_modifier`	`f32`	optional	0.0	Queue-aware speed modifier for agent-DM readout (see speech.tts.speed_queue_modifier). 0.0 default preserves base.
└ `nodes.services.caco-tts-daemon.tts.agent_dms.max_speed`	`f32`	optional	3.0	Upper bound for queue-aware agent-DM speed. Default 3.0.
└ `nodes.services.caco-tts-daemon.tts.lang`	`list[string]`	optional		Ordered preferred TTS language codes. First non-blank entry is the default synthesis language; later entries are alternates/fallbacks. Empty or omitted resolves to en-US. The resolved default persists in TTS daemon runtime state across restarts.
└ `nodes.services.caco-tts-daemon.tts.voice_filter`	`map`	optional		Sox-based voice filter applied post-TTS. Preset, custom sox chain, or rotation pool.
└ `nodes.services.caco-tts-daemon.tts.voice_filter.preset`	`string`	optional		Named filter preset: telephone, hall, lofi, underwater, radio, whisper, cave, megaphone, robot, vintage.
└ `nodes.services.caco-tts-daemon.tts.voice_filter.custom`	`string`	optional		Raw sox effect chain string (e.g. "reverb 50 highpass 300").
└ `nodes.services.caco-tts-daemon.tts.voice_filter.rotation`	`map`	optional		Rotation pool for per-agent filter assignment.
└ `nodes.services.caco-tts-daemon.tts.voice_filter.rotation.presets`	`list[string]`	optional		Pool of preset names to rotate through.
└ `nodes.services.caco-tts-daemon.tts.voice_filter.rotation.combine_with_voice`	`bool`	optional	true	Combine filter rotation with voice rotation for unique agent identities.
└ `nodes.services.caco-tts-daemon.tts.disable_voice_filters`	`bool`	optional	false	Disable voice filters even if configured. Debugging kill switch.
└ `nodes.services.caco-tts-daemon.tts.daemon_sync`	`bool`	optional		Proxy TUI speech controls to TTS daemon instead of local playback.
└ `nodes.services.caco-tts-daemon.tts.profiles`	`map`	optional		Named runtime-selectable TTS profile/effect bundles keyed by logical profile name. Each value uses the speech.tts shape; command-template profiles advertise their model label as profile.model or the map key.
└ `nodes.services.caco-tts-daemon.tts.profiles.<profile>.model`	`string`	optional		Runtime model label for this profile; defaults to the profile key when command_template is set.
└ `nodes.services.caco-tts-daemon.tts.profiles.<profile>.command_template`	`string`	optional		Shell command/effect wrapper for this profile.
└ `nodes.services.caco-tts-daemon.tts.profiles.<profile>.voice`	`string`	optional		Default voice for this profile.
└ `nodes.services.caco-tts-daemon.tts.profiles.<profile>.voices`	`list[string]`	optional		Additional voices exposed while this profile registry is configured.
└ `nodes.services.caco-tts-daemon.tts.profiles.<profile>.speed`	`f32`	optional		Default playback speed for this profile.
└ `nodes.services.caco-tts-daemon.tts.personas`	`map`	optional		Declarative TTS persona/category mappings keyed by persona name. Each persona may provide profile/model/voice/speed/filter/director-note defaults while explicit per-event overrides still win.
└ `nodes.services.caco-tts-daemon.tts.personas.<persona>.profile`	`string`	optional		Named TTS profile/effect bundle for this persona.
└ `nodes.services.caco-tts-daemon.tts.personas.<persona>.model`	`string`	optional		TTS model override for this persona.
└ `nodes.services.caco-tts-daemon.tts.personas.<persona>.voice`	`string`	optional		TTS voice override for this persona.
└ `nodes.services.caco-tts-daemon.tts.personas.<persona>.speed`	`f32`	optional		Playback speed override for this persona.
└ `nodes.services.caco-tts-daemon.tts.personas.<persona>.director_note`	`string`	optional		Optional director note for downstream TTS resolvers.
└ `nodes.services.caco-tts-daemon.tts.hrtf`	`map`	optional		Optional disabled-by-default HRTF processing seam for decoded TTS audio. Requires operator-provided dataset path and license/provenance metadata before processing is considered available.
└ `nodes.services.caco-tts-daemon.tts.hrtf.enabled`	`bool`	optional	false	Enable HRTF processing. Default false/no-op.
└ `nodes.services.caco-tts-daemon.tts.hrtf.dataset_path`	`string`	optional		Path or documented built-in token for impulse-response data.
└ `nodes.services.caco-tts-daemon.tts.hrtf.dataset_license`	`string`	optional		License/provenance note for the selected dataset.
└ `nodes.services.caco-tts-daemon.tts.hrtf.backend`	`string`	optional		Processing backend identifier such as identity_stereo for deterministic tests.
└ `nodes.services.caco-tts-daemon.io`	`map`	optional		Override audio I/O settings for this daemon instance.
└ `nodes.services.caco-tts-daemon.io.output`	`map`	optional		Output audio routing.
└ `nodes.services.caco-tts-daemon.io.output.mode`	`string`	optional		Routing mode: local-default, local-device, pulse-default, or a named pulse output.
└ `nodes.services.caco-tts-daemon.io.output.device`	`string`	optional		Explicit device identifier (only for local-device mode).
└ `nodes.services.caco-tts-daemon.io.input`	`map`	optional		Input audio routing.
└ `nodes.services.caco-tts-daemon.io.input.mode`	`string`	optional		Routing mode: local-default, local-device, pulse-default, or a named pulse output.
└ `nodes.services.caco-tts-daemon.io.input.device`	`string`	optional		Explicit device identifier (only for local-device mode).
└ `nodes.services.caco-tts-daemon.io.outputs`	`list[map]`	optional		Named PulseAudio output endpoints for TUI cycle rotation.
└ `nodes.services.caco-tts-daemon.io.outputs.server`	`string`	required		PulseAudio server address (host:port).
└ `nodes.services.caco-tts-daemon.io.outputs.name`	`string`	required		Human-readable name used in TUI cycle and io.output.mode.
└ `nodes.services.caco-tts-daemon.io.outputs.device`	`string`	optional		Optional PulseAudio sink name; uses the server default when omitted.
└ `nodes.services.caco-tts-daemon.io.inputs`	`map[string, map]`	optional		Named audio input sources.
└ `nodes.services.caco-tts-daemon.io.inputs.type`	`string`	required		Input source type: alsa, pulse, ssh_pulse, or device_mic.
└ `nodes.services.caco-tts-daemon.io.inputs.device`	`string`	optional	default	Audio input device/source name.
└ `nodes.services.caco-tts-daemon.io.inputs.server`	`string`	optional		PulseAudio server address for pulse inputs.
└ `nodes.services.caco-tts-daemon.io.inputs.node`	`string`	optional		Target node name for ssh_pulse inputs.
└ `nodes.services.caco-tts-daemon.io.inputs.scheme`	`string`	optional		Device URI scheme for device_mic inputs: android, iphone, or watchos.
└ `nodes.services.caco-tts-daemon.io.inputs.host`	`string`	optional		Device host/IP reachable from the daemon for device_mic inputs.
└ `nodes.services.caco-tts-daemon.io.inputs.port`	`u16`	optional		Device in-app HTTP server port serving /mic for device_mic inputs.
└ `nodes.services.caco-tts-daemon.io.inputs.token`	`string`	optional		Bearer token for the device_mic /mic endpoint. May be supplied here or resolved from a daemon-known device token at capture time.
└ `nodes.services.caco-stt-daemon`	`map \| list[map]`	optional		Headless STT daemon for this node. Starts muted unless unmuted is explicitly true.
└ `nodes.services.caco-stt-daemon.name`	`string`	optional	default	File-safe instance name for multi-daemon setups (ASCII letters, digits, '-' or '_'). Defaults to 'default'.
└ `nodes.services.caco-stt-daemon.model`	`string`	optional		STT model override for this daemon instance.
└ `nodes.services.caco-stt-daemon.language`	`string`	optional		Transcription language override.
└ `nodes.services.caco-stt-daemon.input`	`string`	optional		Named STT input route override.
└ `nodes.services.caco-stt-daemon.device`	`string`	optional		STT capture device override.
└ `nodes.services.caco-stt-daemon.scratchpad_id`	`string`	optional		Scratchpad note ID that receives ambient transcript markers (defaults to transcription:ambient:<instance> at runtime).
└ `nodes.services.caco-stt-daemon.unmuted`	`bool`	optional	false	Start capture immediately instead of the muted default.
└ `nodes.services.caco-stt-daemon.transcript_max_entries`	`usize`	optional	1000	Maximum retained transcript entries.
└ `nodes.services.caco-stt-daemon.transcript_max_bytes`	`u64`	optional	1048576	Maximum retained transcript bytes.
└ `nodes.services.caco-stt-daemon.passthrough`	`map`	optional		Mirror an external transcript producer instead of capturing: exactly one of url or command. Requires activation capability stt_passthrough_v1, and stt_passthrough_v2 for command/resume/stream/initial or tailnet ws://.
└ `nodes.services.caco-stt-daemon.passthrough.url`	`string`	optional		WebSocket endpoint: wss:// anywhere, ws:// only on loopback or the tailnet (100.64.0.0/10, fd7a:115c:a1e0::/48, *.ts.net). No userinfo, query or fragment.
└ `nodes.services.caco-stt-daemon.passthrough.command`	`list[string]`	optional		Producer argv (no shell) whose stdout carries one frame per line, e.g. [lifetail, --json, follow]. Runs in its own process group with a minimal environment; stderr is discarded.
└ `nodes.services.caco-stt-daemon.passthrough.resume_args`	`list[string]`	optional		Arguments appended to command when a resume cursor is known; {after} becomes the last adopted sequence, e.g. [--after, "{after}"].
└ `nodes.services.caco-stt-daemon.passthrough.resume_query`	`string`	optional		Query parameter appended to url carrying the last adopted sequence, e.g. after.
└ `nodes.services.caco-stt-daemon.passthrough.stream`	`string`	optional	upstream	Stream identity for sequenced frames without one (lifetail records).
└ `nodes.services.caco-stt-daemon.passthrough.initial`	`string`	optional	head	Start without a stored cursor (first start or upstream reset): head follows live text; all replays from sequence 0.
└ `nodes.services.caco-stt-daemon.passthrough.token_file`	`string`	optional		Bearer token file for url, re-read on every reconnect; never used with command.
└ `nodes.services.caco-stt-daemon.passthrough.stale_after_secs`	`u64`	optional	120	Seconds without text or liveness before health reports upstream_stale (1-86400).
└ `nodes.services.caco-stt-daemon.passthrough.reconnect_max_secs`	`u64`	optional	60	Maximum reconnect/respawn backoff (1-300).
└ `nodes.services.caco-stt-daemon.passthrough.max_message_bytes`	`usize`	optional	65536	Maximum message or stdout line size (1 B-1 MiB).
└ `nodes.services.caco-git-daemon`	`map`	optional		Node-scoped repository-service placement override for isolated canaries; omitted values inherit top-level services.caco-git-daemon.
└ `nodes.services.caco-git-daemon.mode`	`string`	optional	inherit	Repository-service owner: embedded or standalone.
└ `nodes.services.caco-git-daemon.max_concurrent`	`usize`	optional	4	Maximum node-wide concurrent repository mutations.
└ `nodes.services.caco-git-daemon.max_queued`	`usize`	optional	64	Maximum active plus queued repository mutations.
└ `nodes.services.caco-git-daemon.transport`	`map`	optional	{ kind: auto }	Owner-private local transport used in standalone mode.

Previous Next