Skip to main content

Module core

Module core 

Source
Expand description

Core infrastructure — config, session, auth, logging, error types, protocol.

Modules§

auth
OAuth 2.0 Authorization Code + PKCE flow for Anthropic (Claude Pro/Max).
chain
Chain pointer management — named bookmarks that auto-advance on compaction.
compaction
Task 30 — typed compaction summary provenance (spec §9.3).
config
context_head
Frontend acknowledgement for a context-head persistence barrier.
context_policy
Pure, task-aware context pressure policy. No I/O, clocks, prompts, or tools.
disclosure
Task 34 — per-record/event disclosure classes (spec §9.7).
error
logging
memstat
Process memory instrumentation (§3.7): the numbers mem.sh reads from /proc, available in-process and via synaps status --memory — no root, no smem.
models
Curated list of Claude models known to work with this CLI. Centralized so the settings dropdown, defaults, and subagent hints agree.
private_fs
Private filesystem helpers for sensitive application state.
protocol
reasoning
Typed named reasoning level — single source of truth across providers.
retention
Task 34 — unified retention (spec §9.7): one sweep across sessions (including compaction parents), memory records, derived memory indexes, traces, and logs, with max-age and disk budgets and headless inspect/export/forget operations.
rpc_dispatch
Pure helper functions for the synaps rpc command dispatcher.
rpc_protocol
RPC protocol types for the synaps-bridge parent↔child IPC channel.
session
session_index
session_journal
Session snapshots with opt-in delta journals and durable checkpoints.
session_lock
Per-session journal ownership lock.
shell_config
Shell session configuration — parsed from ~/.synaps-cli/config shell.* keys. Lives in core so that core::config can embed it without a back-edge into tools.
stream_types
Core streaming event types shared across agent-core (rpc_dispatch) and the engine layer (runtime, engine). Defined here so agent-core is a clean leaf with no upward dependencies into the engine layer.
watcher_types