Python SDK reference.

class Axon(LifecycleHooks):
    def __init__(
        self,
        *,
        neuron_id:       str,
        neuron_fn:       Callable[[dict, list], Awaitable[dict]],
        capabilities:    list[str] | None = None,
        version:         str | None      = None,
        neuron_kind:     str = "neuron",
        context_fetcher: Callable[[str], Awaitable[list]] | None = None,
        engrams:         list[EngramBinding] | None = None,
        output_parser:   OutputParser | None = None,
    ) -> None: ...

    # ── Source-paired factories ─────────────────────────────────
    # Create the Neuron AND the Axon in one call, wired with the
    # matching recogniser. Every factory returns a plain Axon.
    @classmethod
    def from_source(cls, source, *, neuron_id,
                    capabilities=None, version=None, neuron_kind="neuron",
                    context_fetcher=None, engrams=None,
                    recognize=True, teach_intents=None,
                    **source_kwargs) -> "Axon": ...
    # source: ollama | huggingface/hf | openai | anthropic | groq |
    #         openrouter | together | mistral | mcp

    # Shorthands over from_source():
    @classmethod
    def ollama(cls, neuron_id, **kw) -> "Axon": ...       # model= required
    @classmethod
    def huggingface(cls, neuron_id, **kw) -> "Axon": ...  # endpoint= required; alias Axon.hf
    @classmethod
    def openai(cls, neuron_id, **kw) -> "Axon": ...       # model= required; api_key or OPENAI_API_KEY
    @classmethod
    def anthropic(cls, neuron_id, **kw) -> "Axon": ...    # model= required; api_key or ANTHROPIC_API_KEY
    @classmethod
    def mcp(cls, neuron_id, **kw) -> "Axon": ...          # command= or server= (+ args, tool)

    async def handle_task(self, task: Signal) -> Signal: ...
    # Called by the Dendrite. Resolves context_ref, invokes neuron_fn,
    # wraps the result in AGENT_OUTPUT / CLARIFICATION / PERMISSION / ERROR.

    # Pre-task hook  -  transform / validate / reject the TASK input.
    # Return a dict to replace the input, None to pass through, or raise
    # to reject (surfaces as ERROR code NEURON_EXCEPTION).
    @axon.before_task

    # Detectors over the Neuron's RAW output  -  named detects_* to stay
    # distinct from the Dendrite's on_* (which consume inbound Signals).
    # Return the intent's fields (dict) to match, None to fall through.
    # Precedence: error -> clarification -> permission -> output.
    @axon.detects_output           # -> AGENT_OUTPUT payload
    @axon.detects_clarification    # -> {"question": ..., "context": ...}
    @axon.detects_permission       # -> {"action": ..., "scope": ..., "reason": ...}
    @axon.detects_error            # -> {"code": ..., "message": ..., "recoverable": ...}

    # Inherited from LifecycleHooks:
    @axon.on_connect          # after the hosting Dendrite emits REGISTER
    @axon.on_refresh          # each heartbeat tick (reason="heartbeat")
    @axon.on_schedule(every_s=N)  # periodic background coroutine