← Schema index / Config Reference
nodes schema (151-300)
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.
| Field path | Type | Required | Default | Canonical description |
|---|---|---|---|---|
└ nodes.agents.pi_daemon.tool_adapter_dir | string | optional | Owner-private mode-0700 directory for Cacophony per-session neutral filesystem adapter sockets; used only by host_adapter mode. | |
└ nodes.agents.pi_daemon.session_mode | enum | optional | configured_session when api.enabled, otherwise host_adapter | Logical-session launch boundary: configured_session uses the authenticated typed Session API; host_adapter retains filesystem-only protocol-v2 compatibility/isolation. |
└ nodes.agents.pi_daemon.max_line_bytes | usize | optional | 1048576 | Maximum NDJSON command/response bytes accepted by the Cacophony client. |
└ nodes.agents.pi_daemon.max_events_per_request | usize | optional | 4096 | Maximum matching events retained while awaiting one terminal response. |
└ nodes.agents.pi_daemon.max_sessions | u32 | optional | 128 | Maximum resident logical SDK sessions in the standalone host. |
└ nodes.agents.pi_daemon.max_concurrent_turns | u32 | optional | 4 | Maximum concurrent model turns in the standalone host. |
└ nodes.agents.pi_daemon.max_session_queue_depth | u32 | optional | 32 | Maximum queued turns per logical session; zero allows only the active turn. |
└ nodes.agents.pi_daemon.max_connections | u32 | optional | 64 | Maximum Unix control connections in the standalone host, including wakes awaiting settlement. |
└ nodes.agents.pi_daemon.max_api_connections | u32 | optional | 64 | Maximum HTTP and upgraded WebSocket connections, independent of Unix connections. |
└ nodes.agents.pi_daemon.max_rpc_hubs | u32 | optional | 32 | Maximum concurrently attached RPC session generations. |
└ nodes.agents.pi_daemon.max_rpc_replay_bytes | u64 | optional | 2097152 | Replay byte budget per RPC hub. |
└ nodes.agents.pi_daemon.max_rpc_total_replay_bytes | u64 | optional | 67108864 | Aggregate replay budget; must cover max_rpc_hubs multiplied by max_rpc_replay_bytes. |
└ nodes.agents.pi_daemon.max_residency_leases | u32 | optional | 256 | Maximum resident-runtime leases across attached clients. |
└ nodes.agents.pi_daemon.recovery_open_timeout_ms | u64 | optional | 30000 | Startup recovery budget per retained runtime in milliseconds. |
└ nodes.agents.pi_daemon.recovery_total_timeout_ms | u64 | optional | 120000 | Total startup runtime recovery budget in milliseconds. |
└ nodes.agents.pi_daemon.node_max_old_space_size_mb | u32 | optional | V8 old-space MiB for the Pi-Daemon service launch, not sibling services; not an RSS reservation or CPU quota. Node child tools may inherit NODE_OPTIONS. | |
└ nodes.agents.pi_daemon.idle_session_ttl_ms | u64 | optional | 1800000 | Idle SDK-session eviction interval in milliseconds; zero disables eviction. |
└ nodes.agents.pi_daemon.api | map | optional | Authenticated HTTP API listener settings; omission preserves socket-only launch byte-for-byte. | |
└ nodes.agents.pi_daemon.api.enabled | bool | required | Explicitly enable or disable the authenticated HTTP API listener. | |
└ nodes.agents.pi_daemon.api.bind | string | optional | API listener address; non-loopback plaintext also requires allow_insecure_http=true. | |
└ nodes.agents.pi_daemon.api.port | u16 | optional | API listener port; required when enabled and distinct from the embedded Dashboard port. | |
└ nodes.agents.pi_daemon.api.token_file | string | optional | $CACOPHONY_DIR/pi-daemon/api-token | Owner-private bearer-token file reference; bearer bytes are forbidden in config. |
└ nodes.agents.pi_daemon.api.allow_insecure_http | bool | optional | false | Explicit acknowledgement required for non-loopback plaintext API binding. |
└ nodes.agents.pi_daemon.web | map | optional | Embedded browser Dashboard settings in the same supervised pi-daemon process. | |
└ nodes.agents.pi_daemon.web.enabled | bool | required | Explicitly enable or disable the embedded Dashboard in the supervised host process. | |
└ nodes.agents.pi_daemon.web.bind | string | optional | Embedded Dashboard listener address. | |
└ nodes.agents.pi_daemon.web.port | u16 | optional | Dashboard listener port; required when enabled and distinct from the API port. | |
└ nodes.agents.pi_daemon.web.public_origin | string | optional | Exact plaintext HTTP browser origin override, without credentials, path, query, or fragment. | |
└ nodes.agents.pi_daemon.web.allow_insecure_http | bool | optional | Optional upstream plaintext HTTP setting. | |
└ nodes.agents.pi_daemon.ahp | map | optional | pi-daemon 1.0 AHP endpoint; when set, agent messages are delivered as AHP turns instead of socket wakes. | |
└ nodes.agents.pi_daemon.ahp.url | string | required | ws:// or wss:// URL of the AHP host's /ahp endpoint (for example pi-daemon 1.0). | |
└ nodes.agents.pi_daemon.ahp.token_file | string | required | Owner-private bearer-token file reference; bearer bytes are forbidden in config. | |
└ nodes.agents.pi_daemon.ahp.profile | string | optional | cacophony | Host profile (AHP provider) agent sessions are created with. |
└ nodes.agents.pi_daemon.ahp.client_id | string | optional | cacophony | Stable AHP client id; a resent message keeps its request id only while this is unchanged. |
└ nodes.agents.pi_daemon.ahp.request_timeout_secs | u64 | optional | 30 | Connection and request timeout in seconds. |
└ nodes.agents.pi_daemon.ahp.turn_follow_secs | u64 | optional | 3600 | How long Cacophony follows a turn for its end state; only an explicit delivery deadline cancels a turn. |
└ nodes.agents.pi_daemon.ahp.identity | enum[session_env_file, none] | optional | session_env_file | How the host learns the agent's identity: session_env_file writes the agent's session.env beside its checkout for the host profile to load. |
└ nodes.agents.pi_daemon.ahp.kind | enum[ahp, pi-daemon] | optional | ahp | What the host is: pi-daemon hosts also serve /chord and are attached with pi-client; the pi-daemon host defaults to pi-daemon. |
└ nodes.agents.pi_daemon.ahp.chord_url | string | optional | ws:// or wss:// URL of a pi-daemon host's /chord endpoint; defaults to url with its trailing /ahp replaced by /chord. | |
└ nodes.agents.pi_daemon.ahp.apply_to_pi | bool | optional | false | Opt pi and pi-on-demand TUI agents into /chord delivery through this pi-daemon host's node bridge, falling back to their native pane when the bridge has not accepted a message. |
└ nodes.agents.pi_daemon.ahp.adaptor_extension | string | optional | pi-durable-adaptor extension (absolute or ~/ path) that managed pi and pi-on-demand workspaces load with apply_to_pi, so the node's pi-daemon bridge serves their /chord session; unset loads nothing. | |
└ nodes.agents.pi_daemon.security | map | optional | Owner-trusted host posture for a pi-daemon instance the operator owns. | |
└ nodes.agents.pi_daemon.security.allow_authority_root_overlap | bool | optional | false | Permit workloads rooted above pi-daemon state/credentials. |
└ nodes.agents.pi_daemon.security.trusted_host | bool | optional | false | Accept owner-declared session resources without the host's symlink/foreign-owner/foreign-writer authority gate. |
└ nodes.agents.pi_daemon.security.resource_load_policy | enum | optional | strict | strict refuses a session when a declared resource fails to load; lenient records diagnostics like pi does. |
└ nodes.agents.pi_daemon.paratenic_connector | map | optional | Cacophony-owned Paratenic connector whose endpoint and credential reference are derived from this exact Pi-Daemon service. | |
└ nodes.agents.pi_daemon.paratenic_connector.enabled | bool | required | Make Cacophony supervise one Paratenic connector for this exact Pi-Daemon service. | |
└ nodes.agents.pi_daemon.paratenic_connector.provider_id | string | optional | pi-daemon-cacophony | Stable AHP provider namespace, distinct from pi and the standalone pi-daemon provider; must match a configured launch descriptor. |
└ nodes.agents.pi_daemon.paratenic_connector.binary | string | optional | paratenic | Reviewed Paratenic executable path/name. |
└ nodes.agents.pi_daemon.paratenic_connector.poll_interval_ms | u64 | optional | 30000 | Pi-Daemon inventory polling interval in milliseconds. |
└ nodes.agents.pi_daemon.paratenic_connector.request_timeout_ms | u64 | optional | 30000 | Pi-Daemon API and RPC setup timeout in milliseconds. |
└ nodes.agents.pi_daemon.paratenic_connector.launch_presets | string | optional | Owner-private reviewed managed-launch preset descriptor. | |
└ nodes.agents.pi_daemon.session_environment | map[string, string] | optional | Non-secret environment defaults enforced on every configured logical Pi session. | |
└ nodes.agents.ahp_hosts.<name> | map | optional | Node-local named AHP host for ahp agents; replaces the global agents.ahp_hosts entry of the same name. | |
└ nodes.agents.ahp_hosts.<name>.url | string | required | ws:// or wss:// URL of the AHP host's /ahp endpoint (for example pi-daemon 1.0). | |
└ nodes.agents.ahp_hosts.<name>.token_file | string | required | Owner-private bearer-token file reference; bearer bytes are forbidden in config. | |
└ nodes.agents.ahp_hosts.<name>.profile | string | optional | cacophony | Host profile (AHP provider) agent sessions are created with. |
└ nodes.agents.ahp_hosts.<name>.client_id | string | optional | cacophony | Stable AHP client id; a resent message keeps its request id only while this is unchanged. |
└ nodes.agents.ahp_hosts.<name>.request_timeout_secs | u64 | optional | 30 | Connection and request timeout in seconds. |
└ nodes.agents.ahp_hosts.<name>.turn_follow_secs | u64 | optional | 3600 | How long Cacophony follows a turn for its end state; only an explicit delivery deadline cancels a turn. |
└ nodes.agents.ahp_hosts.<name>.identity | enum[session_env_file, none] | optional | session_env_file | How the host learns the agent's identity: session_env_file writes the agent's session.env beside its checkout for the host profile to load. |
└ nodes.agents.ahp_hosts.<name>.kind | enum[ahp, pi-daemon] | optional | ahp | What the host is: pi-daemon hosts also serve /chord and are attached with pi-client; the pi-daemon host defaults to pi-daemon. |
└ nodes.agents.ahp_hosts.<name>.chord_url | string | optional | ws:// or wss:// URL of a pi-daemon host's /chord endpoint; defaults to url with its trailing /ahp replaced by /chord. | |
└ nodes.agents.ahp_hosts.<name>.apply_to_pi | bool | optional | false | Opt pi and pi-on-demand TUI agents into /chord delivery through this pi-daemon host's node bridge, falling back to their native pane when the bridge has not accepted a message. |
└ nodes.agents.ahp_hosts.<name>.adaptor_extension | string | optional | pi-durable-adaptor extension (absolute or ~/ path) that managed pi and pi-on-demand workspaces load with apply_to_pi, so the node's pi-daemon bridge serves their /chord session; unset loads nothing. | |
└ nodes.speech | map | optional | Node-level speech overrides. | |
└ nodes.speech.enabled | bool | optional | true | Whether speech (TTS/STT) is enabled. Set false on headless nodes. |
└ nodes.speech.mute | true|false|local|tts-daemon-running | optional | local | Startup mute policy. true=start muted, false=start unmuted, local=restore last TUI toggle, tts-daemon-running=muted (TTS daemon handles speech). |
└ nodes.speech.tts | map | optional | Text-to-speech defaults. | |
└ nodes.speech.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.speech.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.speech.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.speech.tts.chime.enabled | bool | optional | true | Enable or disable this chime object. |
└ nodes.speech.tts.chime.root_note | string | optional | C | Scale root note such as C, C#, Db, F sharp, or Bb. |
└ nodes.speech.tts.chime.scale | string | optional | minor | Scale type for note slots: major or minor. |
└ nodes.speech.tts.chime.transpose_semitones | i32 | optional | 0 | Semitone transposition applied after root/scale resolution. Aliases: transpose, transposition. |
└ nodes.speech.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.speech.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.speech.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.speech.tts.model | string | optional | TTS model identifier (provider-dependent). | |
└ nodes.speech.tts.command_template | string | optional | Shell command template for ad-hoc TTS adapters. Uses env vars such as $BODY and optional $OUTPUT_FILE. | |
└ nodes.speech.tts.voice | string | optional | Default voice name. | |
└ nodes.speech.tts.voices | list[string] | optional | Additional voice names merged into the capabilities voice list. | |
└ nodes.speech.tts.voice_rotation | bool | optional | true | Auto-assign distinct voices per agent sender. |
└ nodes.speech.tts.speed | f32 | optional | Playback speed multiplier (0.25–4.0). 1.0 = normal. | |
└ nodes.speech.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.speech.tts.max_speed | f32 | optional | 3.0 | Upper bound for queue-aware effective playback speed. Default 3.0. |
└ nodes.speech.tts.agent_dms | map | optional | Optional direct agent-message readout overlay. Inherits normal TTS settings unless fields here override them. | |
└ nodes.speech.tts.agent_dms.read_aloud | bool | optional | false | Read direct agent-message feed events aloud. Default false. |
└ nodes.speech.tts.agent_dms.speed | f32 | optional | Optional speed override for direct-message readout. | |
└ nodes.speech.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.speech.tts.agent_dms.max_speed | f32 | optional | 3.0 | Upper bound for queue-aware agent-DM speed. Default 3.0. |
└ nodes.speech.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.speech.tts.voice_filter | map | optional | Sox-based voice filter applied post-TTS. Preset, custom sox chain, or rotation pool. | |
└ nodes.speech.tts.voice_filter.preset | string | optional | Named filter preset: telephone, hall, lofi, underwater, radio, whisper, cave, megaphone, robot, vintage. | |
└ nodes.speech.tts.voice_filter.custom | string | optional | Raw sox effect chain string (e.g. "reverb 50 highpass 300"). | |
└ nodes.speech.tts.voice_filter.rotation | map | optional | Rotation pool for per-agent filter assignment. | |
└ nodes.speech.tts.voice_filter.rotation.presets | list[string] | optional | Pool of preset names to rotate through. | |
└ nodes.speech.tts.voice_filter.rotation.combine_with_voice | bool | optional | true | Combine filter rotation with voice rotation for unique agent identities. |
└ nodes.speech.tts.disable_voice_filters | bool | optional | false | Disable voice filters even if configured. Debugging kill switch. |
└ nodes.speech.tts.daemon_sync | bool | optional | Proxy TUI speech controls to TTS daemon instead of local playback. | |
└ nodes.speech.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.speech.tts.profiles.<profile>.model | string | optional | Runtime model label for this profile; defaults to the profile key when command_template is set. | |
└ nodes.speech.tts.profiles.<profile>.command_template | string | optional | Shell command/effect wrapper for this profile. | |
└ nodes.speech.tts.profiles.<profile>.voice | string | optional | Default voice for this profile. | |
└ nodes.speech.tts.profiles.<profile>.voices | list[string] | optional | Additional voices exposed while this profile registry is configured. | |
└ nodes.speech.tts.profiles.<profile>.speed | f32 | optional | Default playback speed for this profile. | |
└ nodes.speech.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.speech.tts.personas.<persona>.profile | string | optional | Named TTS profile/effect bundle for this persona. | |
└ nodes.speech.tts.personas.<persona>.model | string | optional | TTS model override for this persona. | |
└ nodes.speech.tts.personas.<persona>.voice | string | optional | TTS voice override for this persona. | |
└ nodes.speech.tts.personas.<persona>.speed | f32 | optional | Playback speed override for this persona. | |
└ nodes.speech.tts.personas.<persona>.director_note | string | optional | Optional director note for downstream TTS resolvers. | |
└ nodes.speech.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.speech.tts.hrtf.enabled | bool | optional | false | Enable HRTF processing. Default false/no-op. |
└ nodes.speech.tts.hrtf.dataset_path | string | optional | Path or documented built-in token for impulse-response data. | |
└ nodes.speech.tts.hrtf.dataset_license | string | optional | License/provenance note for the selected dataset. | |
└ nodes.speech.tts.hrtf.backend | string | optional | Processing backend identifier such as identity_stereo for deterministic tests. | |
└ nodes.speech.stt | map | optional | Speech-to-text defaults. | |
└ nodes.speech.stt.model | string | optional | STT model identifier. | |
└ nodes.speech.stt.language | string | optional | Default STT language hint (ISO 639-1, e.g. en). | |
└ nodes.speech.stt.command_template | string | optional | Shell command template for ad-hoc STT adapters. Uses env vars such as $AUDIO_FILE and optional $TRANSCRIPT_FILE. | |
└ nodes.speech.stt.input | string | optional | Named input source for STT capture (references speech.io.inputs key). | |
└ nodes.speech.stt.vad | map | optional | Top-level VAD config for generic STT chunking. Applied before any STT backend. | |
└ nodes.speech.stt.vad.enabled | bool | optional | true | Whether VAD pre-processing is enabled. |
└ nodes.speech.stt.vad.engine | string | optional | silero | VAD engine identifier (silero, webrtc, etc.). |
└ nodes.speech.stt.vad.threshold | f32 | optional | 0.5 | Speech probability threshold (0.0–1.0). |
└ nodes.speech.stt.vad.min_speech_duration_ms | u32 | optional | 250 | Minimum speech duration in ms; shorter segments are discarded. |
└ nodes.speech.stt.vad.min_silence_duration_ms | u32 | optional | 300 | Minimum silence duration in ms before a segment ends. |
└ nodes.speech.stt.vad.speech_pad_ms | u32 | optional | 100 | Padding in ms added before/after each speech segment. |
└ nodes.speech.stt.vad.model | string | optional | silero-v6.2.0 | VAD model name (e.g. silero-v6.2.0). |
└ nodes.speech.stt.dictation | map | optional | Rolling-capture window config for scratchpad dictation. | |
└ nodes.speech.stt.dictation.chunk_secs | u32 | optional | 10 | Rolling capture window in seconds. |
└ nodes.speech.stt.dictation.overlap_secs | u32 | optional | 1 | Overlap between consecutive chunks in seconds. |
└ nodes.speech.stt.smart_append | map | optional | Per-chunk smart-append cleanup config. | |
└ nodes.speech.stt.smart_append.enabled | bool | optional | true | Whether smart-append is enabled. |
└ nodes.speech.stt.smart_append.model | string | optional | fast | Text model to use for incremental cleanup. |
└ nodes.speech.stt.rewrite | map | optional | Final whole-note rewrite config. | |
└ nodes.speech.stt.rewrite.enabled | bool | optional | true | Whether final rewrite is enabled. |
└ nodes.speech.stt.rewrite.model | string | optional | fast | Text model to use for the final cleanup pass. |
└ nodes.speech.stt.rewrite.mode | string | optional | full | Rewrite mode: full or append. |
└ nodes.speech.stt.scribble | map | optional | Local scribble-based Whisper transcription config. | |
└ nodes.speech.stt.scribble.model | string | optional | large-v3-turbo-q8_0 | Whisper model name. |
└ nodes.speech.stt.scribble.acceleration | string | optional | default | GPU acceleration backend: default, metal, vulkan, cuda, coreml, or cpu. |
└ nodes.speech.stt.scribble.language | string | optional | Optional language hint. | |
└ nodes.speech.stt.scribble.vad | map | optional | Voice activity detection config for scribble. | |
└ nodes.speech.stt.scribble.vad.enabled | bool | optional | true | Whether VAD is enabled. |
└ nodes.speech.stt.scribble.vad.model | string | optional | silero-v6.2.0 | Silero VAD model name. |
└ nodes.speech.stt.agent | map | optional | Per-target STT config for agent panes. | |
└ nodes.speech.stt.agent.rewriting | bool | optional | false | Whether smart rewriting is enabled for this target. |