feat: thinking-control content type (convos.org/thinking-control:1.0)

[yewreeka]

What

Adds the thinking-control content type, convos.org/thinking-control:1.0 — the user-to-agent counterpart of convos.org/thinking:1.0. Where thinking is an agent narrating its own session, a thinking-control message is any conversation member asking the agent to stop that session or resume it.

Payload:

{ "action": "stop" | "resume", "targetMessageId": "<anchor message id>", "agentInboxId": "<agent inbox id>" }

• Keyed by (agentInboxId, targetMessageId) — the same session key the thinking events use. agentInboxId disambiguates when two agents think about the same message.
• Silent like thinking: no fallback text, shouldPush false, never rendered as a chat row.
• Controls are requests, not state transitions — the agent acknowledges via its own thinking events.

Changes

• src/utils/thinkingControl.ts: ThinkingControlCodec, ContentTypeThinkingControl, isThinkingControlMessage, getThinkingControlContent, ThinkingControl/ThinkingControlAction types — mirrors thinking.ts structure exactly. Subpath import @xmtp/convos-cli/utils/thinkingControl works via the existing ./utils/* wildcard export.
• src/utils/client.ts: codec registered in buildClient.
• src/index.ts: root exports.
• agent serve: inbound thinking-control messages emit a thinking_control event (action, targetMessageId, agentInboxId); new thinking-control stdin command sends them.
• test/utils/thinkingControl.test.ts: mirrors the thinking codec suite.
• Changeset: minor bump.

Context

• Sender side (iOS stop/resume button): Add thinking-control content type for stopping and resuming thinking sessions convos-ios#1053
• Behavior plan (herald-lite forwarding + Hermes handling): xmtplabs/convos-assistants#2105 — herald-lite needs this published to import the codec.

Testing

• pnpm typecheck clean.
• pnpm test: 511 passed; the 3 failures (test/commands/identity.test.ts, test/commands/init.test.ts) fail identically on clean origin/main in this environment (pre-existing, unrelated).

🤖 Generated with Claude Code

---

^{Need help on this PR? Tag /codesmith with what you need. Autofix is disabled.}

Note

Add thinking-control content type for agent stop/resume signaling

• Introduces a new convos.org/thinking-control:1.0 content type implemented in src/utils/thinkingControl.ts with a ThinkingControlCodec that encodes/decodes stop and resume actions targeting a specific message and agent inbox.
• Registers the codec in buildClient and exports all related types and helpers from the package's public API.
• Extends agent serve to classify inbound thinking-control messages as a distinct event type and to accept a new thinking-control stdin command with required action, targetMessageId, and agentInboxId fields.
• Messages are sent silently (no push notification, no fallback content); invalid payloads emit errors rather than throwing.

^{Macroscope summarized 2c874c6.}