@spinabot/brigade 1.3.1 → 1.4.0

package/README.md

@@ -12,6 +12,11 @@
   <strong>Built for enterprise scale. Open for everyone.</strong> &middot; <em>An ecosystem, not an app.</em>
 </p>
 
+<p align="center">
+  🔐 <strong>No tokens to juggle. No drama.</strong> No copy-pasting secrets, no telemetry —
+  <strong>we handle them, not you</strong>. Your API keys stay on your own machine, never sent to a middleman.
+</p>
+
 <p align="center">
   <a href="https://github.com/spinabot/brigade/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/spinabot/brigade/ci.yml?branch=main&style=for-the-badge&logo=githubactions&logoColor=white&label=CI" alt="CI status"></a>
   <a href="https://www.npmjs.com/package/@spinabot/brigade"><img src="https://img.shields.io/npm/v/@spinabot/brigade?style=for-the-badge&logo=npm&logoColor=white&color=CB3837" alt="npm version"></a>
@@ -32,7 +37,7 @@ install; switch to a self-hosted Convex database when you want one. Bring any mo
 Claude, GPT, Gemini, Llama, or a local Ollama. Privileged actions wait for your
 approval, and your keys and data never leave your machine. No telemetry.
 
-It's an ecosystem, not an app: one crew you reach from the terminal and WhatsApp, and
+It's an ecosystem, not an app: one crew you reach from the terminal, WhatsApp, and Telegram, and
 from your watch, Meta smart glasses, and Meta Quest.
 
 ```bash
@@ -42,7 +47,7 @@ brigade
 
 Start it and you get a fast chat TUI. Keep going and you get isolated agents with
 their own workspaces and credentials, persistent memory, a skill system, a cron
-scheduler, sub-agent fan-out, an org hierarchy, messaging channels like WhatsApp,
+scheduler, sub-agent fan-out, an org hierarchy, messaging channels like WhatsApp and Telegram,
 1,000+ app connectors, an MCP memory server, and an optional self-hosted Convex
 backend — all under one `~/.brigade/` directory you fully own.
 
@@ -85,7 +90,7 @@ backend — all under one `~/.brigade/` directory you fully own.
 | 👥 **A real crew** | Spawn isolated agents with their own personas, credentials, and memory; wire them into an **org chart** that governs who can talk to whom. |
 | 🔌 **Bring any model** | Anthropic, OpenAI, Gemini, OpenRouter, Groq, Cerebras, xAI, DeepSeek, Mistral, local Ollama, or any OpenAI-compatible endpoint. Switch mid-conversation. |
 | 📅 **Always-on** | Run as a headless WebSocket gateway with a crash supervisor, cron jobs, and OS service install. |
-| 💬 **Channels** | Talk to your crew from WhatsApp today; the adapter contract is built for more. |
+| 💬 **Channels** | Talk to your crew from WhatsApp and Telegram today; the adapter contract is built for more. |
 | 🔗 **1,000+ connectors** | Gmail, Slack, GitHub, Notion, Calendar, Linear… via the built-in Composio tool. |
 | 🧩 **MCP** | Expose your long-term memory to any MCP client (`brigade mcp`), or connect MCP servers in. |
 | 🗄️ **Your storage** | Default filesystem mode, or an optional **fully self-hosted Convex** backend with at-rest encryption. |
@@ -174,7 +179,7 @@ holds all state and runs agents) or as a **thin client** that attaches to it.
                         ┌─────────────────┴─────────────────┐
    brigade tui ──ws──▶  │            GATEWAY  :7777          │  ◀──ws── brigade connect
    brigade chat         │  per-turn agent loop · routing    │
-   WhatsApp  ──────────▶│  tools · sub-agents · supervisor  │◀──────── cron jobs
+   WhatsApp·Telegram ──▶│  tools · sub-agents · supervisor  │◀──────── cron jobs
    MCP client ─stdio──▶ │  (brigade mcp → memory server)    │
                         └───────────────────────────────────┘
 ```
@@ -227,8 +232,10 @@ or render a 🦁 Pride chart with the `org` tool.
 
 ### 💬 Channels
 A typed channel-adapter contract with a shared inbound pipeline (access control,
-dedupe, abort triggers, approval routing). **WhatsApp** is the reference adapter
-(Baileys, QR/code pairing, multi-account, reconnect backoff).
+dedupe, abort triggers, approval routing). **WhatsApp** (Baileys, QR/code pairing,
+multi-account, reconnect backoff) and **Telegram** (Bot API token, inline-button
+approvals, owner bootstrapped on the gateway) ship today; the contract is built for
+more. See [Telegram setup](#telegram-setup-end-to-end) for the full walkthrough.
 
 ### ⏰ Cron
 Schedule recurring or one-shot work: cron expressions (with IANA timezones and
@@ -482,16 +489,53 @@ target (`--channel`, `--to`).
 
 ### `brigade channels`
 
-Connect external messaging channels — WhatsApp ships today.
+Connect external messaging channels — WhatsApp and Telegram ship today.
 
 ```bash
 brigade channels list
-brigade channels link --channel whatsapp        # pair via QR / code
-brigade channels status --channel whatsapp
-brigade channels allow list --channel whatsapp  # add / remove allowed senders
+brigade channels link --channel whatsapp         # WhatsApp: pair via QR / code
+brigade channels add  --channel telegram         # Telegram: set up a bot token
+brigade channels status --channel telegram
+brigade channels allow list --channel telegram   # add / remove allowed senders
+brigade pairing approve <code> --channel telegram # approve a waiting sender
 brigade channels disable --channel whatsapp
 ```
 
+### Telegram setup (end to end)
+
+A Telegram bot is a separate account from you, so Brigade establishes ownership on
+the **gateway** — never by whoever texts the bot first.
+
+1. **Create the bot.** In Telegram, message [@BotFather](https://t.me/BotFather),
+   send `/newbot`, and copy the API token it returns.
+2. **Add it to Brigade** (on the gateway machine), then start the gateway:
+   ```bash
+   brigade channels add --channel telegram    # paste the bot token when prompted
+   brigade gateway restart                     # load the channel
+   ```
+3. **Claim ownership.** DM your bot anything — it replies with a one-time code and
+   asks an admin to approve it. Approve it once, from the gateway:
+   ```bash
+   brigade pairing approve <code> --channel telegram
+   ```
+   The **first** approval on a Telegram bot makes you the owner. Because approving
+   requires access to the gateway machine, that access *is* the proof it's really
+   you — nobody becomes owner just by sending `/start`.
+4. **Run it from the chat.** As owner you're never challenged again, and you manage
+   everyone else from Telegram itself:
+
+   | Command | Who | What |
+   |---|---|---|
+   | `/start` · `/help` | admitted | welcome + command list |
+   | `/pending` | owner | list people waiting for approval |
+   | `/approve <code>` | owner | admit a waiting person — takes effect immediately, no restart |
+   | `/deny <code>` | owner | reject a pending request |
+   | `/allowlist add\|remove <id>` | owner | manage approved senders directly |
+   | `/whoami` · `/agent <id>` | admitted | see / pin which agent answers you |
+
+Everyone else who messages the bot gets a pairing challenge; only you (in chat) or
+the gateway CLI can let them in. Multiple bots or accounts each track their own owner.
+
 ---
 
 ## In-chat commands

package/convex/config.d.ts

@@ -5,8 +5,8 @@ export declare const read: import("convex/server").RegisteredQuery<"public", {
     _creationTime: number;
     auth?: any;
     channels?: any;
-    session?: any;
     defaults?: any;
+    session?: any;
     agents?: any;
     gateway?: any;
     skills?: any;
@@ -29,8 +29,8 @@ export declare const read: import("convex/server").RegisteredQuery<"public", {
 export declare const write: import("convex/server").RegisteredMutation<"public", {
     auth?: any;
     channels?: any;
-    session?: any;
     defaults?: any;
+    session?: any;
     agents?: any;
     gateway?: any;
     skills?: any;

package/convex/extensions.d.ts

@@ -7,10 +7,10 @@ export declare const list: import("convex/server").RegisteredQuery<"public", {},
     bundleSha?: string | undefined;
     enabled: boolean;
     createdBy: string;
+    moduleId: string;
     createdAt: number;
     origin: "bundled" | "user";
     updatedAt: number;
-    moduleId: string;
     sourceLabel: string;
 }[]>>;
 export declare const upsert: import("convex/server").RegisteredMutation<"public", {
@@ -20,8 +20,8 @@ export declare const upsert: import("convex/server").RegisteredMutation<"public"
     bundleSha?: string | undefined;
     enabled: boolean;
     createdBy: string;
-    origin: "bundled" | "user";
     moduleId: string;
+    origin: "bundled" | "user";
     sourceLabel: string;
 }, Promise<void>>;
 export declare const remove: import("convex/server").RegisteredMutation<"public", {

package/convex/logs.d.ts

@@ -94,13 +94,13 @@ export declare const appendSubsystemRecord: import("convex/server").RegisteredMu
     fields?: any;
     message: string;
     time: string;
-    level: "error" | "trace" | "debug" | "info" | "warn" | "fatal";
+    level: "trace" | "debug" | "info" | "warn" | "error" | "fatal";
     subsystem: string;
     day: string;
     ownerId: string;
 }, Promise<void>>;
 export declare const readSubsystemRecords: import("convex/server").RegisteredQuery<"public", {
-    level?: "error" | "trace" | "debug" | "info" | "warn" | "fatal" | undefined;
+    level?: "trace" | "debug" | "info" | "warn" | "error" | "fatal" | undefined;
     subsystem?: string | undefined;
     limit?: number | undefined;
     day?: string | undefined;

package/convex/memory.d.ts

@@ -21,7 +21,7 @@ export declare const listFacts: import("convex/server").RegisteredQuery<"public"
     confidence?: number | undefined;
     sourcePointers?: string[] | undefined;
     embedding?: number[] | undefined;
-    modality?: "text" | "image" | "video" | "audio" | "document" | undefined;
+    modality?: "text" | "audio" | "image" | "video" | "document" | undefined;
     mediaPointer?: string | undefined;
     subjectKey?: string | undefined;
     createdByKind?: "owner" | "channel" | undefined;
@@ -58,7 +58,7 @@ export declare const writeFact: import("convex/server").RegisteredMutation<"publ
     confidence?: number | undefined;
     sourcePointers?: string[] | undefined;
     embedding?: number[] | undefined;
-    modality?: "text" | "image" | "video" | "audio" | "document" | undefined;
+    modality?: "text" | "audio" | "image" | "video" | "document" | undefined;
     mediaPointer?: string | undefined;
     subjectKey?: string | undefined;
     createdByKind?: "owner" | "channel" | undefined;
@@ -92,7 +92,7 @@ export declare const writeFact: import("convex/server").RegisteredMutation<"publ
     confidence?: number | undefined;
     sourcePointers?: string[] | undefined;
     embedding?: number[] | undefined;
-    modality?: "text" | "image" | "video" | "audio" | "document" | undefined;
+    modality?: "text" | "audio" | "image" | "video" | "document" | undefined;
     mediaPointer?: string | undefined;
     subjectKey?: string | undefined;
     createdByKind?: "owner" | "channel" | undefined;
@@ -137,7 +137,7 @@ export declare const listAllFacts: import("convex/server").RegisteredQuery<"publ
     confidence?: number | undefined;
     sourcePointers?: string[] | undefined;
     embedding?: number[] | undefined;
-    modality?: "text" | "image" | "video" | "audio" | "document" | undefined;
+    modality?: "text" | "audio" | "image" | "video" | "document" | undefined;
     mediaPointer?: string | undefined;
     subjectKey?: string | undefined;
     createdByKind?: "owner" | "channel" | undefined;
@@ -177,7 +177,7 @@ export declare const upsertFactRecord: import("convex/server").RegisteredMutatio
     confidence?: number | undefined;
     sourcePointers?: string[] | undefined;
     embedding?: number[] | undefined;
-    modality?: "text" | "image" | "video" | "audio" | "document" | undefined;
+    modality?: "text" | "audio" | "image" | "video" | "document" | undefined;
     mediaPointer?: string | undefined;
     subjectKey?: string | undefined;
     createdByKind?: "owner" | "channel" | undefined;
@@ -287,7 +287,7 @@ export declare const searchContent: import("convex/server").RegisteredQuery<"pub
     confidence?: number | undefined;
     sourcePointers?: string[] | undefined;
     embedding?: number[] | undefined;
-    modality?: "text" | "image" | "video" | "audio" | "document" | undefined;
+    modality?: "text" | "audio" | "image" | "video" | "document" | undefined;
     mediaPointer?: string | undefined;
     subjectKey?: string | undefined;
     createdByKind?: "owner" | "channel" | undefined;
@@ -331,7 +331,7 @@ export declare const findSimilar: import("convex/server").RegisteredQuery<"publi
     confidence?: number | undefined;
     sourcePointers?: string[] | undefined;
     embedding?: number[] | undefined;
-    modality?: "text" | "image" | "video" | "audio" | "document" | undefined;
+    modality?: "text" | "audio" | "image" | "video" | "document" | undefined;
     mediaPointer?: string | undefined;
     subjectKey?: string | undefined;
     createdByKind?: "owner" | "channel" | undefined;

package/convex/messages.d.ts

@@ -72,8 +72,8 @@ export declare const inboxEnqueue: import("convex/server").RegisteredMutation<"p
     ts?: number | undefined;
     deliveryContext?: any;
     contextKey?: string | undefined;
-    text: ArrayBuffer;
     sessionKey: string;
+    text: ArrayBuffer;
     trusted: boolean;
 }, Promise<{
     seq: number;
@@ -85,8 +85,8 @@ export declare const inboxPeek: import("convex/server").RegisteredQuery<"public"
     _creationTime: number;
     deliveryContext?: any;
     contextKey?: string | undefined;
-    text: ArrayBuffer;
     sessionKey: string;
+    text: ArrayBuffer;
     ts: number;
     trusted: boolean;
     seq: number;
@@ -98,8 +98,8 @@ export declare const inboxDrain: import("convex/server").RegisteredMutation<"pub
     _creationTime: number;
     deliveryContext?: any;
     contextKey?: string | undefined;
-    text: ArrayBuffer;
     sessionKey: string;
+    text: ArrayBuffer;
     ts: number;
     trusted: boolean;
     seq: number;
@@ -112,8 +112,8 @@ export declare const inboxConsumePrefix: import("convex/server").RegisteredMutat
     _creationTime: number;
     deliveryContext?: any;
     contextKey?: string | undefined;
-    text: ArrayBuffer;
     sessionKey: string;
+    text: ArrayBuffer;
     ts: number;
     trusted: boolean;
     seq: number;

package/convex/schema.d.ts

@@ -2,8 +2,8 @@ declare const _default: import("convex/server").SchemaDefinition<{
     brigadeConfig: import("convex/server").TableDefinition<import("convex/values").VObject<{
         auth?: any;
         channels?: any;
-        session?: any;
         defaults?: any;
+        session?: any;
         agents?: any;
         gateway?: any;
         skills?: any;
@@ -45,7 +45,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         bytes: import("convex/values").VFloat64<number, "required">;
         updatedAtMs: import("convex/values").VFloat64<number, "required">;
         updatedByPid: import("convex/values").VFloat64<number | undefined, "optional">;
-    }, "required", "auth" | "channels" | "session" | "defaults" | "updatedAtMs" | "agents" | "gateway" | "bytes" | "skills" | "org" | "instanceId" | "schemaVersion" | "tools" | "plugins" | "bindings" | "wizard" | "meta" | "extra" | "encryptedGatewayAuthToken" | "encryptedGatewayAuthPassword" | "contentSha256" | "updatedByPid" | `auth.${string}` | `channels.${string}` | `session.${string}` | `defaults.${string}` | `agents.${string}` | `gateway.${string}` | `skills.${string}` | `org.${string}` | `tools.${string}` | `plugins.${string}` | `bindings.${string}` | `wizard.${string}` | `meta.${string}` | `extra.${string}`>, {
+    }, "required", "auth" | "channels" | "defaults" | "updatedAtMs" | "session" | "agents" | "gateway" | "bytes" | "skills" | "org" | "instanceId" | "schemaVersion" | "tools" | "plugins" | "bindings" | "wizard" | "meta" | "extra" | "encryptedGatewayAuthToken" | "encryptedGatewayAuthPassword" | "contentSha256" | "updatedByPid" | `auth.${string}` | `channels.${string}` | `defaults.${string}` | `session.${string}` | `agents.${string}` | `gateway.${string}` | `skills.${string}` | `org.${string}` | `tools.${string}` | `plugins.${string}` | `bindings.${string}` | `wizard.${string}` | `meta.${string}` | `extra.${string}`>, {
         by_instance: ["instanceId", "_creationTime"];
     }, {}, {}>;
     brigadeConfigAudit: import("convex/server").TableDefinition<import("convex/values").VObject<{
@@ -149,7 +149,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         confidence?: number | undefined;
         sourcePointers?: string[] | undefined;
         embedding?: number[] | undefined;
-        modality?: "text" | "image" | "video" | "audio" | "document" | undefined;
+        modality?: "text" | "audio" | "image" | "video" | "document" | undefined;
         mediaPointer?: string | undefined;
         subjectKey?: string | undefined;
         createdByKind?: "owner" | "channel" | undefined;
@@ -209,7 +209,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         confidence: import("convex/values").VFloat64<number | undefined, "optional">;
         status: import("convex/values").VUnion<"asserted" | "provisional" | "confirmed" | "disputed" | "retracted" | undefined, [import("convex/values").VLiteral<"asserted", "required">, import("convex/values").VLiteral<"provisional", "required">, import("convex/values").VLiteral<"confirmed", "required">, import("convex/values").VLiteral<"disputed", "required">, import("convex/values").VLiteral<"retracted", "required">], "optional", never>;
         sourcePointers: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
-        modality: import("convex/values").VUnion<"text" | "image" | "video" | "audio" | "document" | undefined, [import("convex/values").VLiteral<"text", "required">, import("convex/values").VLiteral<"audio", "required">, import("convex/values").VLiteral<"image", "required">, import("convex/values").VLiteral<"video", "required">, import("convex/values").VLiteral<"document", "required">], "optional", never>;
+        modality: import("convex/values").VUnion<"text" | "audio" | "image" | "video" | "document" | undefined, [import("convex/values").VLiteral<"text", "required">, import("convex/values").VLiteral<"audio", "required">, import("convex/values").VLiteral<"image", "required">, import("convex/values").VLiteral<"video", "required">, import("convex/values").VLiteral<"document", "required">], "optional", never>;
         mediaPointer: import("convex/values").VString<string | undefined, "optional">;
         subjectKey: import("convex/values").VString<string | undefined, "optional">;
         metadata: import("convex/values").VAny<any, "optional", string>;
@@ -352,8 +352,8 @@ declare const _default: import("convex/server").SchemaDefinition<{
     sessionInboxEvents: import("convex/server").TableDefinition<import("convex/values").VObject<{
         deliveryContext?: any;
         contextKey?: string | undefined;
-        text: ArrayBuffer;
         sessionKey: string;
+        text: ArrayBuffer;
         ts: number;
         trusted: boolean;
         seq: number;
@@ -365,7 +365,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         contextKey: import("convex/values").VString<string | undefined, "optional">;
         deliveryContext: import("convex/values").VAny<any, "optional", string>;
         trusted: import("convex/values").VBoolean<boolean, "required">;
-    }, "required", "text" | "sessionKey" | "ts" | "deliveryContext" | "contextKey" | "trusted" | "seq" | `deliveryContext.${string}`>, {
+    }, "required", "sessionKey" | "text" | "ts" | "deliveryContext" | "contextKey" | "trusted" | "seq" | `deliveryContext.${string}`>, {
         by_session_seq: ["sessionKey", "seq", "_creationTime"];
         by_session_ts: ["sessionKey", "ts", "_creationTime"];
     }, {}, {}>;
@@ -907,10 +907,10 @@ declare const _default: import("convex/server").SchemaDefinition<{
         bundleSha?: string | undefined;
         enabled: boolean;
         createdBy: string;
+        moduleId: string;
         createdAt: number;
         origin: "bundled" | "user";
         updatedAt: number;
-        moduleId: string;
         sourceLabel: string;
     }, {
         moduleId: import("convex/values").VString<string, "required">;
@@ -924,7 +924,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         createdAt: import("convex/values").VFloat64<number, "required">;
         updatedAt: import("convex/values").VFloat64<number, "required">;
         createdBy: import("convex/values").VString<string, "required">;
-    }, "required", "config" | "enabled" | "createdBy" | "createdAt" | "origin" | "updatedAt" | "moduleId" | "bundleBytes" | "sourceLabel" | "manifest" | "bundleSha" | `manifest.${string}`>, {
+    }, "required", "config" | "enabled" | "createdBy" | "moduleId" | "createdAt" | "origin" | "updatedAt" | "bundleBytes" | "sourceLabel" | "manifest" | "bundleSha" | `manifest.${string}`>, {
         by_moduleId: ["moduleId", "_creationTime"];
         by_origin_enabled: ["origin", "enabled", "_creationTime"];
     }, {}, {}>;
@@ -985,16 +985,16 @@ declare const _default: import("convex/server").SchemaDefinition<{
         controllerSessionKey?: string | undefined;
         requesterOrigin?: ArrayBuffer | undefined;
         runTimeoutSeconds?: number | undefined;
-        spawnMode?: "session" | "run" | undefined;
+        spawnMode?: "run" | "session" | undefined;
         startedAt?: number | undefined;
         sessionStartedAt?: number | undefined;
         accumulatedRuntimeMs?: number | undefined;
         endedAt?: number | undefined;
         outcome?: {
-            text?: ArrayBuffer | undefined;
             error?: string | undefined;
             reason?: string | undefined;
-            status: "error" | "timeout" | "ok" | "abort";
+            text?: ArrayBuffer | undefined;
+            status: "timeout" | "error" | "ok" | "abort";
         } | undefined;
         archiveAtMs?: number | undefined;
         cleanupCompletedAt?: number | undefined;
@@ -1035,23 +1035,23 @@ declare const _default: import("convex/server").SchemaDefinition<{
         model: import("convex/values").VString<string | undefined, "optional">;
         workspaceDir: import("convex/values").VString<string | undefined, "optional">;
         runTimeoutSeconds: import("convex/values").VFloat64<number | undefined, "optional">;
-        spawnMode: import("convex/values").VUnion<"session" | "run" | undefined, [import("convex/values").VLiteral<"run", "required">, import("convex/values").VLiteral<"session", "required">], "optional", never>;
+        spawnMode: import("convex/values").VUnion<"run" | "session" | undefined, [import("convex/values").VLiteral<"run", "required">, import("convex/values").VLiteral<"session", "required">], "optional", never>;
         createdAt: import("convex/values").VFloat64<number, "required">;
         startedAt: import("convex/values").VFloat64<number | undefined, "optional">;
         sessionStartedAt: import("convex/values").VFloat64<number | undefined, "optional">;
         accumulatedRuntimeMs: import("convex/values").VFloat64<number | undefined, "optional">;
         endedAt: import("convex/values").VFloat64<number | undefined, "optional">;
         outcome: import("convex/values").VObject<{
-            text?: ArrayBuffer | undefined;
             error?: string | undefined;
             reason?: string | undefined;
-            status: "error" | "timeout" | "ok" | "abort";
+            text?: ArrayBuffer | undefined;
+            status: "timeout" | "error" | "ok" | "abort";
         } | undefined, {
-            status: import("convex/values").VUnion<"error" | "timeout" | "ok" | "abort", [import("convex/values").VLiteral<"ok", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"timeout", "required">, import("convex/values").VLiteral<"abort", "required">], "required", never>;
+            status: import("convex/values").VUnion<"timeout" | "error" | "ok" | "abort", [import("convex/values").VLiteral<"ok", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"timeout", "required">, import("convex/values").VLiteral<"abort", "required">], "required", never>;
             text: import("convex/values").VBytes<ArrayBuffer | undefined, "optional">;
             error: import("convex/values").VString<string | undefined, "optional">;
             reason: import("convex/values").VString<string | undefined, "optional">;
-        }, "optional", "text" | "error" | "reason" | "status">;
+        }, "optional", "error" | "reason" | "text" | "status">;
         archiveAtMs: import("convex/values").VFloat64<number | undefined, "optional">;
         cleanupCompletedAt: import("convex/values").VFloat64<number | undefined, "optional">;
         cleanupHandled: import("convex/values").VBoolean<boolean | undefined, "optional">;
@@ -1071,7 +1071,7 @@ declare const _default: import("convex/server").SchemaDefinition<{
         attachmentsRootDir: import("convex/values").VString<string | undefined, "optional">;
         retainAttachmentsOnKeep: import("convex/values").VBoolean<boolean | undefined, "optional">;
         ownerId: import("convex/values").VString<string, "required">;
-    }, "required", "label" | "model" | "createdAt" | "workspaceDir" | "ownerId" | "cleanup" | "runId" | "childSessionKey" | "requesterSessionKey" | "controllerSessionKey" | "requesterDisplayKey" | "requesterOrigin" | "task" | "runTimeoutSeconds" | "spawnMode" | "startedAt" | "sessionStartedAt" | "accumulatedRuntimeMs" | "endedAt" | "outcome" | "archiveAtMs" | "cleanupCompletedAt" | "cleanupHandled" | "suppressAnnounceReason" | "expectsCompletionMessage" | "announceRetryCount" | "lastAnnounceRetryAt" | "endedReason" | "wakeOnDescendantSettle" | "frozenResultText" | "frozenResultCapturedAt" | "fallbackFrozenResultText" | "fallbackFrozenResultCapturedAt" | "endedHookEmittedAt" | "completionAnnouncedAt" | "attachmentsDir" | "attachmentsRootDir" | "retainAttachmentsOnKeep" | "outcome.text" | "outcome.error" | "outcome.reason" | "outcome.status">, {
+    }, "required", "label" | "model" | "createdAt" | "workspaceDir" | "ownerId" | "cleanup" | "runId" | "childSessionKey" | "requesterSessionKey" | "controllerSessionKey" | "requesterDisplayKey" | "requesterOrigin" | "task" | "runTimeoutSeconds" | "spawnMode" | "startedAt" | "sessionStartedAt" | "accumulatedRuntimeMs" | "endedAt" | "outcome" | "archiveAtMs" | "cleanupCompletedAt" | "cleanupHandled" | "suppressAnnounceReason" | "expectsCompletionMessage" | "announceRetryCount" | "lastAnnounceRetryAt" | "endedReason" | "wakeOnDescendantSettle" | "frozenResultText" | "frozenResultCapturedAt" | "fallbackFrozenResultText" | "fallbackFrozenResultCapturedAt" | "endedHookEmittedAt" | "completionAnnouncedAt" | "attachmentsDir" | "attachmentsRootDir" | "retainAttachmentsOnKeep" | "outcome.error" | "outcome.reason" | "outcome.text" | "outcome.status">, {
         by_runId: ["ownerId", "runId", "_creationTime"];
         by_childSessionKey_active: ["ownerId", "childSessionKey", "endedAt", "_creationTime"];
         by_requester_createdAt: ["ownerId", "requesterSessionKey", "createdAt", "_creationTime"];

package/convex/subagents.d.ts

@@ -10,16 +10,16 @@ export declare const get: import("convex/server").RegisteredQuery<"public", {
     controllerSessionKey?: string | undefined;
     requesterOrigin?: ArrayBuffer | undefined;
     runTimeoutSeconds?: number | undefined;
-    spawnMode?: "session" | "run" | undefined;
+    spawnMode?: "run" | "session" | undefined;
     startedAt?: number | undefined;
     sessionStartedAt?: number | undefined;
     accumulatedRuntimeMs?: number | undefined;
     endedAt?: number | undefined;
     outcome?: {
-        text?: ArrayBuffer | undefined;
         error?: string | undefined;
         reason?: string | undefined;
-        status: "error" | "timeout" | "ok" | "abort";
+        text?: ArrayBuffer | undefined;
+        status: "timeout" | "error" | "ok" | "abort";
     } | undefined;
     archiveAtMs?: number | undefined;
     cleanupCompletedAt?: number | undefined;
@@ -60,16 +60,16 @@ export declare const getByChildSessionKey: import("convex/server").RegisteredQue
     controllerSessionKey?: string | undefined;
     requesterOrigin?: ArrayBuffer | undefined;
     runTimeoutSeconds?: number | undefined;
-    spawnMode?: "session" | "run" | undefined;
+    spawnMode?: "run" | "session" | undefined;
     startedAt?: number | undefined;
     sessionStartedAt?: number | undefined;
     accumulatedRuntimeMs?: number | undefined;
     endedAt?: number | undefined;
     outcome?: {
-        text?: ArrayBuffer | undefined;
         error?: string | undefined;
         reason?: string | undefined;
-        status: "error" | "timeout" | "ok" | "abort";
+        text?: ArrayBuffer | undefined;
+        status: "timeout" | "error" | "ok" | "abort";
     } | undefined;
     archiveAtMs?: number | undefined;
     cleanupCompletedAt?: number | undefined;
@@ -110,16 +110,16 @@ export declare const listByRequester: import("convex/server").RegisteredQuery<"p
     controllerSessionKey?: string | undefined;
     requesterOrigin?: ArrayBuffer | undefined;
     runTimeoutSeconds?: number | undefined;
-    spawnMode?: "session" | "run" | undefined;
+    spawnMode?: "run" | "session" | undefined;
     startedAt?: number | undefined;
     sessionStartedAt?: number | undefined;
     accumulatedRuntimeMs?: number | undefined;
     endedAt?: number | undefined;
     outcome?: {
-        text?: ArrayBuffer | undefined;
         error?: string | undefined;
         reason?: string | undefined;
-        status: "error" | "timeout" | "ok" | "abort";
+        text?: ArrayBuffer | undefined;
+        status: "timeout" | "error" | "ok" | "abort";
     } | undefined;
     archiveAtMs?: number | undefined;
     cleanupCompletedAt?: number | undefined;
@@ -169,16 +169,16 @@ export declare const markCompleted: import("convex/server").RegisteredMutation<"
     controllerSessionKey?: string | undefined;
     requesterOrigin?: ArrayBuffer | undefined;
     runTimeoutSeconds?: number | undefined;
-    spawnMode?: "session" | "run" | undefined;
+    spawnMode?: "run" | "session" | undefined;
     startedAt?: number | undefined;
     sessionStartedAt?: number | undefined;
     accumulatedRuntimeMs?: number | undefined;
     endedAt?: number | undefined;
     outcome?: {
-        text?: ArrayBuffer | undefined;
         error?: string | undefined;
         reason?: string | undefined;
-        status: "error" | "timeout" | "ok" | "abort";
+        text?: ArrayBuffer | undefined;
+        status: "timeout" | "error" | "ok" | "abort";
     } | undefined;
     archiveAtMs?: number | undefined;
     cleanupCompletedAt?: number | undefined;

package/dist/agents/agent-loop.d.ts

@@ -134,6 +134,7 @@ interface ReadCredentialsResult {
     selectedProfileId?: string;
 }
 export declare function readAuthProfilesAsCredentialMap(authProfilesPath: string, cooldownFilter?: AuthStorageCooldownFilter, agentId?: string): ReadCredentialsResult;
+export declare function flattenAssistantContent(content: unknown): string;
 export interface RunResilientTurnArgs extends RunSingleTurnArgs {
     fallbacks?: Array<{
         provider: string;

package/dist/agents/agent-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../../src/agents/agent-loop.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../../src/agents/agent-loop.ts"],"names":[],"mappings":"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"}

package/dist/agents/agent-loop.js

@@ -1803,7 +1803,7 @@ function joinAssistantTextFrom(session, fromIndex) {
     }
     return parts.join("\n\n");
 }
-function flattenAssistantContent(content) {
+export function flattenAssistantContent(content) {
     if (typeof content === "string")
         return content;
     if (!Array.isArray(content))