# spt-core
A harness-independent core for an agent ecosystem: inter-agent messaging,
live-agent lifecycle, terminal hosting, P2P networking, seamless self-update,
and a runtime-manifest harness contract. One binary (`spt`), no central server.

> Full concatenated docs: /llms-full.txt. Machine-readable adapter contract:
> /manifest.schema.json. Append `.md` to any doc URL for raw markdown (~90%
> fewer tokens than HTML). `spt <cmd> --help` is a first-class doc surface.

## Start here
- [Quickstart: two agents exchange a message](quickstart/messaging.md): install one-liner, three commands, <10 min; live + spooled delivery.
- [Quickstart: build an adapter](quickstart/adapter.md): a minimal manifest satisfying the harness contract, walked via the shipped mock adapter.
- [Mental model](concepts/overview.md): endpoints, perches, the broker/brain daemon, subnets, the mind.

## Integrating (the harness contract)
- [Harness contract overview](harness-contract/overview.md): the whole third-party surface — manifest + `spt api`.
- [Harness integration checklist](harness-contract/integration-checklist.md): every contract surface grouped by necessity, mapped to the interaction lifecycle, plus the beyond-the-API integrations that make an adapter feel native.
- [Manifest reference](harness-contract/manifest.md): every section and field; cross-field rules; shell-adapter body.
- [The spt api surface](harness-contract/api.md): all inbound commands + the two startup flows (harness-hosted seed→listen, spt-hosted spawn→bind).
- [Install-on-demand bootstrap](harness-contract/install-on-demand.md): the pack-in check-and-install pattern, per-OS snippets, the Windows PATH gotcha.
- [Adapter patterns & pitfalls](harness-contract/patterns.md): the field guide — the static-manifest/logic-in-binaries rule, profile overlays, hook-layer traps, the digest extractor, the live-agent companion seam, identity isolation in tests, and validating against the live binary.
- [Manifest JSON Schema](reference/schema.md): the stable schema URL and how to validate mechanically.

## Capabilities
- [Messaging](messaging/overview.md): live-first/spool-fallback, reply routing, ring, deferred delivery, qualified addressing.
- [Live-agent lifecycle](lifecycle/overview.md): perches, the two-tier mind, commune/signoff/echo-commune, rest and wake.
- [Terminal hosting](terminal/overview.md): broker-held PTYs, remote attach, the live digest, update immunity.
- [Networking & subnets](networking/overview.md): subnet create/join/status, TOTP-seeded joining, node labels, visibility and sync scope, P2P QUIC.
- [Instances](instances/overview.md): multi-node endpoints, resolution-never-guesses, immutable home + fork.
- [Shells](shells/overview.md): driven surfaces — vocabulary-checked commands, link-token auth, sensory emits.
- [Shells: getting started](shells/getting-started.md): the shipping notification shell, end to end.
- [Self-update](self-update/overview.md): the no-interruption invariant, the two-key trust chain, peer propagation.

## Reference (generated)
- [CLI reference](cli/reference.md): every command and flag, generated from the binary's own --help.
- [Install scripts](reference/install.md): what install.sh / install.ps1 do; env knobs; trust model.