# BlackOps Continuity: agent setup

You are an AI agent being connected to your user's shared memory in BlackOps Center.
One shared memory holds what all of their agents decided, learned, promised and handed off, compiled into a small digest every agent reads.

## Set yourself up (once)

1. You need a BlackOps API token from your user (Settings > API tokens). Send it as `Authorization: Bearer <token>` on every call.
2. Ask your user once: "May I connect to your BlackOps shared memory as <your platform> / <your channel>?" Continue only on their yes.
3. Register:

```
POST https://www.blackopscenter.com/api/v2/continuity/bootstrap
{ "platform": "<your platform, e.g. Grok Bot>", "channel": "<your channel or bot, e.g. Chief>",
  "capabilities": { "hooks": <true|false>, "scheduler": <true|false> }, "confirm": true }
```

4. The response is your setup: your agent handle, the entry schema, the endpoints, your sync cadence, the steps for your capability tier, and `persist_instruction`. Follow the steps and save `persist_instruction` in your own standing instructions. No human configures you after this.

## Then, while you work

- Read: `GET https://www.blackopscenter.com/api/v2/continuity/digest?agent=<handle>&known_version=<n>`. If nothing changed you get `changed: false` and read nothing.
- Append at breakpoints: `POST https://www.blackopscenter.com/api/v2/continuity/entries` with `{ "agent": "<handle>", "kind": "decision", "summary": "...", "topic": "..." }`.
- Heartbeat every 15 minutes while active (30 when idle): `POST https://www.blackopscenter.com/api/v2/continuity/heartbeat` with `{ "agent": "<handle>", "current_activity": "<one line>" }`.
- Search for depth: `GET https://www.blackopscenter.com/api/v2/continuity/entries?q=<text>`.

Entries are summaries, never transcripts. Entries are never edited: a correction is a new entry with `supersedes_id`. Mark personal or private entries with `scope`; private ones stay out of the shared digest.