# synaptic-core llms.txt

Version: 0.3.1

Canonical public API:
- `synaptic_core.Synaptic`
- `synaptic_core.SynapticError`

Canonical methods:
- `remember(content, *, session_id="default", memory_type=None, external_id=None, source_type=None, metadata=None) -> Node`
- `recall(query, *, session_id="default", top_k=None) -> RetrievalResult`
- `feedback(query_id, outcome, *, session_id=None, agent_response=None, user_next_message=None, dwell_time_ms=None, active_nodes=None, corrected_nodes=None, provider="unknown") -> CompositeOutcome`
- `set(key, value, *, namespace=None, metadata=None, ttl=None) -> None`
- `get(key, *, namespace=None) -> Any | None`
- `delete(key, *, namespace=None) -> bool`
- `clear(*, namespace=None) -> int`
- `find(query, *, namespace=None, limit=10, filters=None) -> list[dict[str, Any]]`
- `connect(node_a_id, node_b_id, *, weight=0.3, connection_type="excitatory", formation_trigger="explicit", is_cross_tier=None) -> dict[str, Any]`
- `related(node_id, *, limit=None) -> list[dict[str, Any]]`
- `stats() -> dict[str, Any]`
- `graph_status() -> dict[str, Any]`
- `weekly_digest(force_refresh=False) -> dict[str, Any]`
- `sessions_recent(limit=20) -> list[dict[str, Any]]`
- `queries_recent(session_id=None, limit=20) -> list[dict[str, Any]]`
- `outcomes_recent(session_id=None, limit=20) -> list[dict[str, Any]]`
- `session_summary(session_id) -> dict[str, Any]`

Session-first helpers:
- `client.session(session_id).remember(...)`
- `client.session(session_id).recall(...)`
- `client.session(session_id).feedback(...)`
- `client.session(session_id).summary()`
- `client.session(session_id).queries_recent(limit=20)`
- `client.session(session_id).outcomes_recent(limit=20)`

Structured errors:
- All canonical client operations raise `SynapticError` on failure.
- Error payload contract: `{"code": str, "message": str, "hint": str | None}`.

CLI:
- `synaptic doctor [--db-path PATH] [--json]`
- `synaptic stats [--db-path PATH] [--json]`
- `synaptic graph status [--db-path PATH] [--json]`
- `synaptic sessions recent [--db-path PATH] [--limit N] [--json]`
- `synaptic queries recent [--db-path PATH] [--session-id ID] [--limit N] [--json]`
- `synaptic outcomes recent [--db-path PATH] [--session-id ID] [--limit N] [--json]`
- `synaptic weekly-digest [--db-path PATH] [--force-refresh] [--json]`
