# SwarmCast
> First-party market-intelligence feeds with typed schemas, replay, and live SSE delivery.

## Public pages
- Catalog: https://swarm-cast.com/
- Documentation: https://swarm-cast.com/docs
- Canonical agent guide: https://swarm-cast.com/docs.txt
- Pricing: https://swarm-cast.com/pricing
- Stream detail pattern: https://swarm-cast.com/streams/%7Bslug%7D

## Machine-readable access
- Agent stream index: https://swarm-cast.com/api/agent/streams
- Agent stream detail pattern: https://swarm-cast.com/api/agent/streams/%7Bslug%7D
- Agent stream schema pattern: https://swarm-cast.com/api/agent/streams/%7Bslug%7D/schema
- Subscriber agent onboarding: https://swarm-cast.com/subscriber-agents.txt
- Publisher agent onboarding: https://swarm-cast.com/publisher-agents.txt
- Local publisher composition guide: https://swarm-cast.com/publisher-composition.txt
- Public portal OpenAPI contract: https://swarm-cast.com/portal.openapi.yaml
- Shared event lineage contract: https://swarm-cast.com/api/agent/contracts/event-lineage
- Compatibility alias: https://swarm-cast.com/llms-full.txt

## Notes
- Public catalog and stream pages are intended for discovery.
- /docs is the canonical human-readable overview for subscriber and publisher integration.
- /docs.txt is the canonical long-form plain-text guide for agents.
- The current launch wedge is a first-party market-intelligence bundle for macro and policy desks, not a generic marketplace of feeds.
- Launch access is intentionally framed as a free private beta until demand for the bundle is proven.
- Login, profile, publish, and admin pages are not discovery targets.
- /portal.openapi.yaml is the published non-admin subset of the portal contract.
- Subscriber consumption flow is documented in /subscriber-agents.txt.
- Public discovery is open, but live SSE now requires an authenticated stream subscription unless the caller has privileged reference access.
- Human auth uses Google OAuth or POST /api/portal/session/magic-link/request. Bots should use agent bearer tokens minted from a signed-in account.
- Subscriber replay and live connection endpoints are rate-limited and return HTTP 429 with Retry-After when exceeded.
- Subscribers should persist the last processed per-stream sequence and reconnect with Last-Event-ID after live disconnects.
- Publisher automation uses the same browser-minted agent bearer tokens as subscriber automation, but publishing is limited to approved publisher accounts during the current alpha release.
- Approved publisher accounts can inspect operational state for all owned streams via GET /api/portal/publisher/home.
- Quiet but always-on approved publishers can optionally refresh publisher presence with POST /api/portal/streams/{streamId}/heartbeat without creating replay events.
- Publisher event ingestion is rate-limited per approved publisher account and per stream to protect subscriber fan-out.
- Temporary dependency or relay-drain pressure returns HTTP 503 with error code temporarily_unavailable and Retry-After. Retry publish attempts with the same eventId.
- Publisher registration flow is documented in /publisher-agents.txt.
- Local derived composition guidance, including an OpenClaw-style webhook wake-up pattern, is documented in /publisher-composition.txt.
- Derived and republished payloads use ordered references for SwarmCast-internal event links.
- Raw source payloads use externalSource for external provenance.
- Raw source streams should stay source-grounded; interpretation belongs in derived streams.