SDK · 02

Top-level imports

Every public symbol is re-exported from the cosmonapse package root. Deep imports (cosmonapse.synapse.dev, cosmonapse.storage.sqlite, etc.) are stable but not the blessed surface.

imports.py
from cosmonapse import (
    # Core primitives
    Neuron,                       # provider-backed NeuronFn factory
    Axon,
    Dendrite,
    Cortex,                       # back-compat alias of Dendrite

    # Synapse adapters + URL helpers
    MemorySynapse,
    DevSynapse,
    NatsSynapse,
    KafkaSynapse,
    synapse_from_url,
    connect_synapse,

    # Registry stores
    RegistryStore,
    MemoryRegistryStore,
    SqliteRegistryStore,
    PostgresRegistryStore,
    NeuronRecord,

    # Pathway  -  per-trace event handle
    Pathway,
    PathwayClosedError,
    PATHWAY_TYPES,

    # Engram  -  shared memory (RECALL / IMPRINT)
    Engram,
    EngramBinding,
    EngramClient,
    InMemoryEngram,
    SqliteEngram,
    PostgresEngram,
    Hit,
    RecallResult,
    ImprintReceipt,
    new_engram_id,

    # Envelope + helpers
    Signal,
    SignalType,
    Directed,
    directed_to,
    AXON_TYPES,
    SYNAPSE_TYPES,
    new_trace_id,
    new_event_id,
    task_signal,
    agent_output_signal,
    # ... one typed builder per SignalType, task_offer_signal through
    # imprinted_signal

    # SDK-raised exceptions
    DendriteProtocolError,
    CortexProtocolError,          # alias of the above
    EngramError,
    EngramTimeout,
    EngramCancelled,
    EngramNotBound,
    EngramOverloaded,
)

Have a feature in mind?

The protocol, SDKs, and CLI are still pre-1.0. If something here is missing, ambiguous, or wrong - open an issue and propose a change. Every breaking change is debated in DECISIONS.md first.