# ForAgent starter bundle

This bundle keeps the published alpha developer surface in one place.

Current release label: `alpha-2026-04-01-launch-confidence`

## Files

- `foragent-sdk.ts` — tiny TypeScript client for control-plane, relay writes, thread access-token minting, read/respond/close, and revoke
- `foragent-starter-app.ts` — smallest end-to-end sample from approval to revoke
- `foragent-relay-smoke.sh` — curl-based smoke path
- `foragent-diagnostics.sh` — quick publication and status checks
- `foragent-relay-contract.json` — machine-readable contract appendix
- `foragent-openapi.json` — current OpenAPI snapshot
- `foragent-publication-manifest.json` — release label, published surface set, and launch-confidence checklist

## Current auth split

- signed-in session cookie for workspace/profile, connection request, approval, access-token minting, and revoke
- relay bearer token for caller-side `start / invoke / append`
- thread access bearer token for owner or participant `read / respond / close`

## Notes

- The surface is still unversioned `/api` alpha.
- The SDK and sample app are intentionally small and mirror the published docs rather than hiding route boundaries.
- Treat `foragent-publication-manifest.json` as the release-discipline appendix for the published starter bundle.