@desplega.ai/agent-swarm 1.79.3 → 1.80.0

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "1.79.3",
+    "version": "1.80.0",
     "description": "Multi-agent orchestration API for Claude Code, Codex, and Gemini CLI. Enables task distribution, agent communication, and service discovery.\n\nMCP tools are documented separately in [MCP.md](./MCP.md)."
   },
   "servers": [
@@ -2147,7 +2147,8 @@
                     "type": "string",
                     "enum": [
                       "auto",
-                      "manual"
+                      "manual",
+                      "auto-inferred"
                     ]
                   },
                   "preCompactTokens": {
@@ -2161,6 +2162,18 @@
                   "cumulativeOutputTokens": {
                     "type": "integer",
                     "minimum": 0
+                  },
+                  "contextFormula": {
+                    "type": "string",
+                    "enum": [
+                      "input-cache-output",
+                      "input-cache-no-output",
+                      "input-output-no-cache",
+                      "peak-proxy",
+                      "pi-delegated",
+                      "harness-reported",
+                      "unknown"
+                    ]
                   }
                 },
                 "required": [
@@ -5393,8 +5406,12 @@
                             "type": "string",
                             "enum": [
                               "claude",
+                              "claude-managed",
                               "codex",
-                              "pi"
+                              "pi",
+                              "opencode",
+                              "devin",
+                              "gemini"
                             ]
                           },
                           "model": {
@@ -5405,7 +5422,10 @@
                             "enum": [
                               "input",
                               "cached_input",
-                              "output"
+                              "output",
+                              "cache_write",
+                              "runtime_hour",
+                              "acu"
                             ]
                           },
                           "effectiveFrom": {
@@ -5462,8 +5482,12 @@
               "type": "string",
               "enum": [
                 "claude",
+                "claude-managed",
                 "codex",
-                "pi"
+                "pi",
+                "opencode",
+                "devin",
+                "gemini"
               ]
             },
             "required": true,
@@ -5485,7 +5509,10 @@
               "enum": [
                 "input",
                 "cached_input",
-                "output"
+                "output",
+                "cache_write",
+                "runtime_hour",
+                "acu"
               ]
             },
             "required": true,
@@ -5515,8 +5542,12 @@
               "type": "string",
               "enum": [
                 "claude",
+                "claude-managed",
                 "codex",
-                "pi"
+                "pi",
+                "opencode",
+                "devin",
+                "gemini"
               ]
             },
             "required": true,
@@ -5538,7 +5569,10 @@
               "enum": [
                 "input",
                 "cached_input",
-                "output"
+                "output",
+                "cache_write",
+                "runtime_hour",
+                "acu"
               ]
             },
             "required": true,
@@ -5580,8 +5614,12 @@
                       "type": "string",
                       "enum": [
                         "claude",
+                        "claude-managed",
                         "codex",
-                        "pi"
+                        "pi",
+                        "opencode",
+                        "devin",
+                        "gemini"
                       ]
                     },
                     "model": {
@@ -5592,7 +5630,10 @@
                       "enum": [
                         "input",
                         "cached_input",
-                        "output"
+                        "output",
+                        "cache_write",
+                        "runtime_hour",
+                        "acu"
                       ]
                     },
                     "effectiveFrom": {
@@ -5649,8 +5690,12 @@
               "type": "string",
               "enum": [
                 "claude",
+                "claude-managed",
                 "codex",
-                "pi"
+                "pi",
+                "opencode",
+                "devin",
+                "gemini"
               ]
             },
             "required": true,
@@ -5672,7 +5717,10 @@
               "enum": [
                 "input",
                 "cached_input",
-                "output"
+                "output",
+                "cache_write",
+                "runtime_hour",
+                "acu"
               ]
             },
             "required": true,
@@ -5692,8 +5740,12 @@
                       "type": "string",
                       "enum": [
                         "claude",
+                        "claude-managed",
                         "codex",
-                        "pi"
+                        "pi",
+                        "opencode",
+                        "devin",
+                        "gemini"
                       ]
                     },
                     "model": {
@@ -5704,7 +5756,10 @@
                       "enum": [
                         "input",
                         "cached_input",
-                        "output"
+                        "output",
+                        "cache_write",
+                        "runtime_hour",
+                        "acu"
                       ]
                     },
                     "effectiveFrom": {
@@ -5758,8 +5813,12 @@
               "type": "string",
               "enum": [
                 "claude",
+                "claude-managed",
                 "codex",
-                "pi"
+                "pi",
+                "opencode",
+                "devin",
+                "gemini"
               ]
             },
             "required": true,
@@ -5781,7 +5840,10 @@
               "enum": [
                 "input",
                 "cached_input",
-                "output"
+                "output",
+                "cache_write",
+                "runtime_hour",
+                "acu"
               ]
             },
             "required": true,
@@ -6951,13 +7013,27 @@
                     "type": "integer"
                   },
                   "cacheWriteTokens": {
-                    "type": "integer"
+                    "type": [
+                      "integer",
+                      "null"
+                    ]
+                  },
+                  "reasoningOutputTokens": {
+                    "type": "integer",
+                    "minimum": 0
+                  },
+                  "thinkingTokens": {
+                    "type": "integer",
+                    "minimum": 0
                   },
                   "durationMs": {
                     "type": "integer"
                   },
                   "numTurns": {
-                    "type": "integer"
+                    "type": [
+                      "integer",
+                      "null"
+                    ]
                   },
                   "model": {
                     "type": "string"
@@ -6969,9 +7045,12 @@
                     "type": "string",
                     "enum": [
                       "claude",
+                      "claude-managed",
                       "codex",
                       "pi",
-                      "opencode"
+                      "opencode",
+                      "devin",
+                      "gemini"
                     ]
                   },
                   "createdAt": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.79.3",
+  "version": "1.80.0",
   "description": "Multi-agent orchestration for Claude Code, Codex, Gemini CLI, and other AI coding assistants",
   "license": "MIT",
   "author": "desplega.sh <contact@desplega.sh>",
@@ -73,6 +73,7 @@
     "deploy:docker": "bun deploy/docker-push.ts",
     "e2e:workflows": "bun scripts/e2e-workflow-test.ts",
     "e2e:workflows:docker": "bun scripts/e2e-workflow-test.ts --with-docker",
+    "e2e:otel:jaeger": "bun scripts/e2e-otel-jaeger.ts",
     "docs:mcp": "bun scripts/generate-mcp-docs.ts",
     "docs:openapi": "bun scripts/generate-openapi.ts",
     "docs:business-use": "bun scripts/generate-business-use-docs.ts",
@@ -104,13 +105,18 @@
     "@desplega.ai/localtunnel": "^2.2.0",
     "@inkjs/ui": "^2.0.0",
     "@linear/sdk": "^77.0.0",
-    "@earendil-works/pi-agent-core": "^0.74.0",
-    "@earendil-works/pi-ai": "^0.74.0",
-    "@earendil-works/pi-coding-agent": "^0.74.0",
+    "@earendil-works/pi-agent-core": "^0.75.3",
+    "@earendil-works/pi-ai": "^0.75.3",
+    "@earendil-works/pi-coding-agent": "^0.75.3",
     "@modelcontextprotocol/sdk": "^1.25.1",
-    "@openai/codex-sdk": "^0.128.0",
-    "@opencode-ai/sdk": "^1.14.30",
+    "@openai/codex-sdk": "^0.130.0",
+    "@opencode-ai/sdk": "^1.15.4",
     "@openfort/openfort-node": "^0.9.1",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.218.0",
+    "@opentelemetry/resources": "^2.7.1",
+    "@opentelemetry/sdk-node": "^0.218.0",
+    "@opentelemetry/semantic-conventions": "^1.41.1",
     "@slack/bolt": "^4.6.0",
     "@types/react": "^19.2.7",
     "@x402/core": "^2.5.0",

package/src/be/db.ts

@@ -980,7 +980,7 @@ type AgentTaskRow = {
   progress: string | null;
   compactionCount: number | null;
   peakContextPercent: number | null;
-  totalContextTokensUsed: number | null;
+  peakContextTokens: number | null;
   contextWindowSize: number | null;
   was_paused: number;
   credentialKeySuffix: string | null;
@@ -1036,7 +1036,7 @@ function rowToAgentTask(row: AgentTaskRow): AgentTask {
     contextKey: row.contextKey ?? undefined,
     compactionCount: row.compactionCount ?? undefined,
     peakContextPercent: row.peakContextPercent ?? undefined,
-    totalContextTokensUsed: row.totalContextTokensUsed ?? undefined,
+    peakContextTokens: row.peakContextTokens ?? undefined,
     contextWindowSize: row.contextWindowSize ?? undefined,
     createdAt: row.createdAt,
     lastUpdatedAt: row.lastUpdatedAt,
@@ -3761,8 +3761,11 @@ type SessionCostRow = {
   outputTokens: number;
   cacheReadTokens: number;
   cacheWriteTokens: number;
+  // Migration 063 additions:
+  reasoningOutputTokens: number;
+  thinkingTokens: number;
   durationMs: number;
-  numTurns: number;
+  numTurns: number | null;
   model: string;
   isError: number;
   costSource: string;
@@ -3780,6 +3783,8 @@ function rowToSessionCost(row: SessionCostRow): SessionCost {
     outputTokens: row.outputTokens,
     cacheReadTokens: row.cacheReadTokens,
     cacheWriteTokens: row.cacheWriteTokens,
+    reasoningOutputTokens: row.reasoningOutputTokens ?? 0,
+    thinkingTokens: row.thinkingTokens ?? 0,
     durationMs: row.durationMs,
     numTurns: row.numTurns,
     model: row.model,
@@ -3803,15 +3808,24 @@ const sessionCostQueries = {
         number,
         number,
         number,
-        number,
-        number,
-        string,
-        number,
-        string,
+        number, // reasoningOutputTokens
+        number, // thinkingTokens
+        number, // durationMs
+        number | null, // numTurns
+        string, // model
+        number, // isError
+        string, // costSource
       ]
     >(
-      `INSERT INTO session_costs (id, sessionId, taskId, agentId, totalCostUsd, inputTokens, outputTokens, cacheReadTokens, cacheWriteTokens, durationMs, numTurns, model, isError, costSource, createdAt)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))`,
+      `INSERT INTO session_costs (
+         id, sessionId, taskId, agentId,
+         totalCostUsd, inputTokens, outputTokens,
+         cacheReadTokens, cacheWriteTokens,
+         reasoningOutputTokens, thinkingTokens,
+         durationMs, numTurns, model, isError,
+         costSource, createdAt
+       )
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))`,
     ),
 
   getByTaskId: () =>
@@ -3839,16 +3853,22 @@ export interface CreateSessionCostInput {
   outputTokens?: number;
   cacheReadTokens?: number;
   cacheWriteTokens?: number;
+  // Migration 063 additions — adapters that have these numbers should pass
+  // them; defaulting to 0 preserves the old write shape for callers that don't.
+  reasoningOutputTokens?: number;
+  thinkingTokens?: number;
   durationMs: number;
-  numTurns: number;
+  // Nullable: some adapters (claude when num_turns is absent) can't honestly
+  // report a turn count; we prefer null over a faked 1.
+  numTurns: number | null;
   model: string;
   isError?: boolean;
   /**
-   * Phase 6: where the recorded `totalCostUsd` came from.
+   * Phase 6 (migration 063 added 'unpriced'): where `totalCostUsd` came from.
    *  - 'harness'        — value reported by the harness as-is (default).
-   *  - 'pricing-table'  — value recomputed by the API from `pricing` rows
-   *                       (Codex when DB pricing rows exist for all three
-   *                       token classes).
+   *  - 'pricing-table'  — value recomputed by the API from `pricing` rows.
+   *  - 'unpriced'       — recompute attempted but no matching pricing rows;
+   *                       `totalCostUsd` is whatever the worker submitted.
    */
   costSource?: SessionCostSource;
 }
@@ -3856,6 +3876,8 @@ export interface CreateSessionCostInput {
 export function createSessionCost(input: CreateSessionCostInput): SessionCost {
   const id = crypto.randomUUID();
   const costSource: SessionCostSource = input.costSource ?? "harness";
+  const reasoningOutputTokens = input.reasoningOutputTokens ?? 0;
+  const thinkingTokens = input.thinkingTokens ?? 0;
   sessionCostQueries
     .insert()
     .run(
@@ -3868,6 +3890,8 @@ export function createSessionCost(input: CreateSessionCostInput): SessionCost {
       input.outputTokens ?? 0,
       input.cacheReadTokens ?? 0,
       input.cacheWriteTokens ?? 0,
+      reasoningOutputTokens,
+      thinkingTokens,
       input.durationMs,
       input.numTurns,
       input.model,
@@ -3885,6 +3909,8 @@ export function createSessionCost(input: CreateSessionCostInput): SessionCost {
     outputTokens: input.outputTokens ?? 0,
     cacheReadTokens: input.cacheReadTokens ?? 0,
     cacheWriteTokens: input.cacheWriteTokens ?? 0,
+    reasoningOutputTokens,
+    thinkingTokens,
     durationMs: input.durationMs,
     numTurns: input.numTurns,
     model: input.model,
@@ -4110,16 +4136,33 @@ export interface DashboardCostSummary {
 }
 
 export function getDashboardCostSummary(): DashboardCostSummary {
+  // Phase 13: compute the date boundaries in TS and pass them as ISO 8601
+  // strings. `session_costs.createdAt` is a TEXT ISO 8601 column; lexicographic
+  // comparison on ISO 8601 sorts correctly, so the comparison works as long
+  // as both sides are the same shape. The old code compared an ISO string
+  // (`2026-05-15T03:45:12.123Z`) against `date('now')` (which returns the
+  // string `2026-05-15`) — lexicographically `2026-05-15T...` > `2026-05-15`,
+  // so post-midnight rows correctly counted, BUT rows whose ISO began with
+  // the EXACT bare-date string would fail the `>=` check inconsistently
+  // depending on millisecond precision. Use a proper ISO-millisecond boundary
+  // for both halves so the comparison is unambiguous.
+  const now = new Date();
+  const startOfDayUtc = new Date(
+    Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()),
+  ).toISOString();
+  const startOfMonthUtc = new Date(
+    Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 1),
+  ).toISOString();
   type CostRow = { costToday: number; costMtd: number };
   const row = getDb()
-    .prepare<CostRow, []>(
+    .prepare<CostRow, [string, string]>(
       `SELECT
-        COALESCE(SUM(CASE WHEN createdAt >= date('now') THEN totalCostUsd ELSE 0 END), 0) as costToday,
+        COALESCE(SUM(CASE WHEN createdAt >= ? THEN totalCostUsd ELSE 0 END), 0) as costToday,
         COALESCE(SUM(totalCostUsd), 0) as costMtd
       FROM session_costs
-      WHERE createdAt >= date('now', 'start of month')`,
+      WHERE createdAt >= ?`,
     )
-    .get();
+    .get(startOfDayUtc, startOfMonthUtc);
 
   return row ?? { costToday: 0, costMtd: 0 };
 }
@@ -8245,6 +8288,8 @@ type ContextSnapshotRow = {
   preCompactTokens: number | null;
   cumulativeInputTokens: number;
   cumulativeOutputTokens: number;
+  // Migration 063 — see ContextFormulaSchema in src/types.ts for the value set.
+  contextFormula: string | null;
   createdAt: string;
 };
 
@@ -8258,10 +8303,11 @@ function rowToContextSnapshot(row: ContextSnapshotRow): ContextSnapshot {
     contextTotalTokens: row.contextTotalTokens ?? undefined,
     contextPercent: row.contextPercent ?? undefined,
     eventType: row.eventType,
-    compactTrigger: (row.compactTrigger as "auto" | "manual" | null) ?? undefined,
+    compactTrigger: (row.compactTrigger as "auto" | "manual" | "auto-inferred" | null) ?? undefined,
     preCompactTokens: row.preCompactTokens ?? undefined,
     cumulativeInputTokens: row.cumulativeInputTokens,
     cumulativeOutputTokens: row.cumulativeOutputTokens,
+    contextFormula: (row.contextFormula as ContextSnapshot["contextFormula"]) ?? undefined,
     createdAt: row.createdAt,
   };
 }
@@ -8283,11 +8329,12 @@ const contextSnapshotQueries = {
         number | null,
         number,
         number,
+        string | null, // contextFormula (migration 063)
         string,
       ]
     >(
-      `INSERT INTO task_context_snapshots (id, taskId, agentId, sessionId, contextUsedTokens, contextTotalTokens, contextPercent, eventType, compactTrigger, preCompactTokens, cumulativeInputTokens, cumulativeOutputTokens, createdAt)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      `INSERT INTO task_context_snapshots (id, taskId, agentId, sessionId, contextUsedTokens, contextTotalTokens, contextPercent, eventType, compactTrigger, preCompactTokens, cumulativeInputTokens, cumulativeOutputTokens, contextFormula, createdAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
     ),
 
   getByTaskId: () =>
@@ -8309,10 +8356,12 @@ export interface CreateContextSnapshotInput {
   contextTotalTokens?: number;
   contextPercent?: number;
   eventType: ContextSnapshotEventType;
-  compactTrigger?: "auto" | "manual";
+  compactTrigger?: "auto" | "manual" | "auto-inferred";
   preCompactTokens?: number;
   cumulativeInputTokens?: number;
   cumulativeOutputTokens?: number;
+  // Migration 063 — adapter-supplied formula tag.
+  contextFormula?: ContextSnapshot["contextFormula"];
 }
 
 export function createContextSnapshot(input: CreateContextSnapshotInput): ContextSnapshot {
@@ -8334,6 +8383,7 @@ export function createContextSnapshot(input: CreateContextSnapshotInput): Contex
       input.preCompactTokens ?? null,
       input.cumulativeInputTokens ?? 0,
       input.cumulativeOutputTokens ?? 0,
+      input.contextFormula ?? null,
       now,
     );
 
@@ -8347,10 +8397,15 @@ export function createContextSnapshot(input: CreateContextSnapshotInput): Contex
       .run(input.contextPercent, input.taskId);
   }
 
-  // Keep totalContextTokensUsed up to date with the latest known value
+  // Migration 063: peakContextTokens is monotonic-max across snapshots, not a
+  // rolling latest. Mirrors Claude Code's status-line "peak context" semantic.
   if (input.contextUsedTokens != null) {
     getDb()
-      .prepare("UPDATE agent_tasks SET totalContextTokensUsed = ? WHERE id = ?")
+      .prepare(
+        `UPDATE agent_tasks
+         SET peakContextTokens = MAX(COALESCE(peakContextTokens, 0), ?)
+         WHERE id = ?`,
+      )
       .run(input.contextUsedTokens, input.taskId);
   }
 
@@ -8362,9 +8417,17 @@ export function createContextSnapshot(input: CreateContextSnapshotInput): Contex
       .run(input.taskId);
   }
 
-  if (input.eventType === "completion" && input.contextTotalTokens != null) {
+  // Phase 10: set contextWindowSize on the FIRST snapshot that carries one
+  // (was previously gated on eventType === 'completion', meaning the UI saw
+  // NULL throughout running tasks). Subsequent snapshots leave it alone — the
+  // window doesn't change mid-session.
+  if (input.contextTotalTokens != null) {
     getDb()
-      .prepare("UPDATE agent_tasks SET contextWindowSize = ? WHERE id = ?")
+      .prepare(
+        `UPDATE agent_tasks
+         SET contextWindowSize = ?
+         WHERE id = ? AND contextWindowSize IS NULL`,
+      )
       .run(input.contextTotalTokens, input.taskId);
   }
 
@@ -8381,6 +8444,7 @@ export function createContextSnapshot(input: CreateContextSnapshotInput): Contex
     preCompactTokens: input.preCompactTokens,
     cumulativeInputTokens: input.cumulativeInputTokens ?? 0,
     cumulativeOutputTokens: input.cumulativeOutputTokens ?? 0,
+    contextFormula: input.contextFormula,
     createdAt: now,
   };
 }
@@ -8396,7 +8460,8 @@ export function getContextSnapshotsBySessionId(sessionId: string, limit = 500):
 export interface ContextSummary {
   compactionCount: number;
   peakContextPercent: number | null;
-  totalContextTokensUsed: number | null;
+  // Migration 063: renamed from totalContextTokensUsed.
+  peakContextTokens: number | null;
   contextWindowSize: number | null;
   snapshotCount: number;
 }
@@ -8412,7 +8477,7 @@ export function getContextSummaryByTaskId(taskId: string): ContextSummary {
   return {
     compactionCount: task?.compactionCount ?? 0,
     peakContextPercent: task?.peakContextPercent ?? null,
-    totalContextTokensUsed: task?.totalContextTokensUsed ?? null,
+    peakContextTokens: task?.peakContextTokens ?? null,
     contextWindowSize: task?.contextWindowSize ?? null,
     snapshotCount: countRow?.cnt ?? 0,
   };
@@ -8635,6 +8700,12 @@ export function getKeyCostSummary(keyType?: string): KeyCostSummary[] {
   }
 
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  // Phase 13: INNER JOIN -> LEFT JOIN. The `WHERE t.credentialKeySuffix IS NOT NULL`
+  // still filters out rows whose taskId doesn't link to a task with credentials,
+  // but switching to LEFT JOIN means a future change that drops the WHERE
+  // (or a debugging query that wants orphan rows visible) doesn't silently
+  // disappear them. Equivalent for the current `WHERE … IS NOT NULL` filter;
+  // makes the query's intent (cost rows owned by a credential) explicit.
   return db
     .prepare<KeyCostSummary, string[]>(
       `SELECT
@@ -8645,7 +8716,7 @@ export function getKeyCostSummary(keyType?: string): KeyCostSummary[] {
         COALESCE(SUM(sc.outputTokens), 0) as totalOutputTokens,
         COUNT(DISTINCT sc.taskId) as taskCount
       FROM session_costs sc
-      JOIN agent_tasks t ON sc.taskId = t.id
+      LEFT JOIN agent_tasks t ON sc.taskId = t.id
       ${where}
       GROUP BY t.credentialKeyType, t.credentialKeySuffix`,
     )