@desplega.ai/agent-swarm 1.92.2 → 1.93.0

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "1.92.2",
+    "version": "1.93.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": [
@@ -2740,6 +2740,59 @@
         }
       }
     },
+    "/api/keys/clear-rate-limit": {
+      "post": {
+        "summary": "Clear rate-limited status for a key after a successful use proves it is healthy",
+        "tags": [
+          "API Keys"
+        ],
+        "security": [
+          {
+            "bearerAuth": []
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "keyType": {
+                    "type": "string"
+                  },
+                  "keySuffix": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 10
+                  },
+                  "scope": {
+                    "type": "string"
+                  },
+                  "scopeId": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "keyType",
+                  "keySuffix"
+                ]
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Rate limit cleared (or key was not rate-limited)"
+          },
+          "400": {
+            "description": "Validation error"
+          },
+          "401": {
+            "description": "Unauthorized"
+          }
+        }
+      }
+    },
     "/api/events": {
       "post": {
         "summary": "Store a single event",
@@ -10711,9 +10764,9 @@
         }
       }
     },
-    "/api/tasks/{id}/claude-session": {
+    "/api/tasks/{id}/session": {
       "put": {
-        "summary": "Update Claude session ID for a task",
+        "summary": "Update provider session ID and harness metadata for a task",
         "tags": [
           "Tasks"
         ],
@@ -10800,6 +10853,13 @@
                       "providerMeta": {
                         "type": "object",
                         "properties": {}
+                      },
+                      "harnessVariant": {
+                        "type": "string"
+                      },
+                      "harnessVariantMeta": {
+                        "type": "object",
+                        "additionalProperties": {}
                       }
                     },
                     "required": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.92.2",
+  "version": "1.93.0",
   "description": "Multi-agent orchestration for Claude Code, Codex, Gemini CLI, and other AI coding assistants",
   "license": "MIT",
   "author": "desplega.sh <contact@desplega.sh>",
@@ -112,11 +112,11 @@
     "@desplega.ai/localtunnel": "^2.2.0",
     "@inkjs/ui": "^2.0.0",
     "@linear/sdk": "^77.0.0",
-    "@earendil-works/pi-agent-core": "^0.78.1",
-    "@earendil-works/pi-ai": "^0.78.1",
-    "@earendil-works/pi-coding-agent": "^0.78.1",
+    "@earendil-works/pi-agent-core": "^0.79.1",
+    "@earendil-works/pi-ai": "^0.79.1",
+    "@earendil-works/pi-coding-agent": "^0.79.1",
     "@modelcontextprotocol/sdk": "^1.25.1",
-    "@openai/codex-sdk": "^0.137.0",
+    "@openai/codex-sdk": "^0.139.0",
     "@opencode-ai/sdk": "^1.16.2",
     "@openfort/openfort-node": "^0.9.1",
     "@opentelemetry/api": "^1.9.1",

package/src/be/db.ts

@@ -65,6 +65,7 @@ import type {
   ScriptRun,
   ScriptRunJournalEntry,
   ScriptRunKind,
+  ScriptRunListItem,
   ScriptRunStatus,
   Service,
   ServiceStatus,
@@ -1041,6 +1042,8 @@ type AgentTaskRow = {
   swarmVersion: string | null;
   provider: string | null;
   providerMeta: string | null;
+  harnessVariant: string | null;
+  harnessVariantMeta: string | null;
   totalCostUsd?: number | null;
 };
 
@@ -1102,7 +1105,7 @@ function rowToAgentTask(row: AgentTaskRow): AgentTask {
     dir: row.dir ?? undefined,
     parentTaskId: row.parentTaskId ?? undefined,
     claudeSessionId: row.claudeSessionId ?? undefined,
-    model: (row.model as "haiku" | "sonnet" | "opus" | null) ?? undefined,
+    model: (row.model as "haiku" | "sonnet" | "opus" | "fable" | null) ?? undefined,
     scheduleId: row.scheduleId ?? undefined,
     workflowRunId: row.workflowRunId ?? undefined,
     workflowRunStepId: row.workflowRunStepId ?? undefined,
@@ -1127,6 +1130,8 @@ function rowToAgentTask(row: AgentTaskRow): AgentTask {
     swarmVersion: row.swarmVersion ?? undefined,
     provider: (row.provider as ProviderName | null) ?? undefined,
     providerMeta: parseProviderMeta(row.provider as ProviderName | null, row.providerMeta),
+    harnessVariant: row.harnessVariant ?? undefined,
+    harnessVariantMeta: row.harnessVariantMeta ? JSON.parse(row.harnessVariantMeta) : undefined,
     totalCostUsd: row.totalCostUsd ?? undefined,
   };
 }
@@ -1398,6 +1403,8 @@ export function updateTaskClaudeSessionId(
   provider?: ProviderName,
   providerMeta?: Record<string, unknown>,
   model?: string,
+  harnessVariant?: string,
+  harnessVariantMeta?: Record<string, unknown>,
 ): AgentTask | null {
   const setClauses = ["claudeSessionId = ?", "lastUpdatedAt = ?"];
   const params: (string | null)[] = [claudeSessionId, new Date().toISOString()];
@@ -1414,6 +1421,14 @@ export function updateTaskClaudeSessionId(
     setClauses.push("model = ?");
     params.push(model);
   }
+  if (harnessVariant !== undefined) {
+    setClauses.push("harnessVariant = ?");
+    params.push(harnessVariant);
+  }
+  if (harnessVariantMeta !== undefined) {
+    setClauses.push("harnessVariantMeta = ?");
+    params.push(JSON.stringify(harnessVariantMeta));
+  }
 
   params.push(taskId);
 
@@ -5291,7 +5306,7 @@ function rowToScheduledTask(row: ScheduledTaskRow): ScheduledTask {
     consecutiveErrors: row.consecutiveErrors ?? 0,
     lastErrorAt: normalizeDate(row.lastErrorAt) ?? undefined,
     lastErrorMessage: row.lastErrorMessage ?? undefined,
-    model: (row.model as "haiku" | "sonnet" | "opus" | null) ?? undefined,
+    model: (row.model as "haiku" | "sonnet" | "opus" | "fable" | null) ?? undefined,
     scheduleType: row.scheduleType as "recurring" | "one_time",
     createdAt: normalizeDateRequired(row.createdAt),
     lastUpdatedAt: normalizeDateRequired(row.lastUpdatedAt),
@@ -10058,6 +10073,28 @@ export function setApiKeyName(
   return result.changes > 0;
 }
 
+/**
+ * Clear a stale rate-limit record after a successful use proves the key is healthy.
+ */
+export function clearKeyRateLimit(
+  keyType: string,
+  keySuffix: string,
+  scope = "global",
+  scopeId: string | null = null,
+): boolean {
+  const now = new Date().toISOString();
+  const effectiveScopeId = scopeId ?? "";
+  const result = getDb()
+    .prepare(
+      `UPDATE api_key_status
+       SET status = 'available', rateLimitedUntil = NULL, updatedAt = ?
+       WHERE keyType = ? AND keySuffix = ? AND scope = ? AND scopeId = ?
+         AND status = 'rate_limited'`,
+    )
+    .run(now, keyType, keySuffix, scope, effectiveScopeId);
+  return result.changes > 0;
+}
+
 /**
  * Get all key status records for a credential type.
  */
@@ -11574,6 +11611,22 @@ type ScriptRunRow = {
   updated_by: string | null;
 };
 
+type ScriptRunListRow = Pick<
+  ScriptRunRow,
+  | "id"
+  | "agentId"
+  | "scriptName"
+  | "kind"
+  | "status"
+  | "pid"
+  | "startedAt"
+  | "finishedAt"
+  | "error"
+  | "last_heartbeat_at"
+  | "idempotencyKey"
+  | "requestedByUserId"
+>;
+
 function parseJsonColumn(value: string | null): unknown | undefined {
   if (value === null) return undefined;
   return JSON.parse(value);
@@ -11599,6 +11652,23 @@ function rowToScriptRun(row: ScriptRunRow): ScriptRun {
   };
 }
 
+function rowToScriptRunListItem(row: ScriptRunListRow): ScriptRunListItem {
+  return {
+    id: row.id,
+    agentId: row.agentId,
+    scriptName: row.scriptName ?? undefined,
+    kind: row.kind as ScriptRunKind,
+    status: row.status as ScriptRunStatus,
+    pid: row.pid ?? undefined,
+    startedAt: row.startedAt,
+    finishedAt: row.finishedAt ?? undefined,
+    error: row.error ?? undefined,
+    lastHeartbeatAt: row.last_heartbeat_at ?? undefined,
+    idempotencyKey: row.idempotencyKey ?? undefined,
+    requestedByUserId: row.requestedByUserId ?? undefined,
+  };
+}
+
 export function createScriptRun(data: {
   id: string;
   agentId: string;
@@ -11733,7 +11803,7 @@ export function listScriptRuns(opts?: {
   agentId?: string;
   limit?: number;
   offset?: number;
-}): ScriptRun[] {
+}): ScriptRunListItem[] {
   const conditions: string[] = [];
   const params: Array<string | number> = [];
   if (opts?.status) {
@@ -11750,11 +11820,26 @@ export function listScriptRuns(opts?: {
   params.push(limit, offset);
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
   const rows = getDb()
-    .prepare<ScriptRunRow, Array<string | number>>(
-      `SELECT * FROM script_runs ${where} ORDER BY startedAt DESC LIMIT ? OFFSET ?`,
+    .prepare<ScriptRunListRow, Array<string | number>>(
+      `SELECT
+        id,
+        agentId,
+        scriptName,
+        kind,
+        status,
+        pid,
+        startedAt,
+        finishedAt,
+        error,
+        last_heartbeat_at,
+        idempotencyKey,
+        requestedByUserId
+       FROM script_runs ${where}
+       ORDER BY startedAt DESC
+       LIMIT ? OFFSET ?`,
     )
     .all(...params);
-  return rows.map(rowToScriptRun);
+  return rows.map(rowToScriptRunListItem);
 }
 
 export function countScriptRuns(opts?: { status?: ScriptRunStatus; agentId?: string }): number {

package/src/be/memory/boot-reembed.ts

@@ -13,7 +13,6 @@ import { getEmbeddingProvider, getMemoryStore } from "./index";
 
 const VECTOR_BYTES = EMBEDDING_DIMENSIONS * Float32Array.BYTES_PER_ELEMENT;
 const BATCH_SIZE = 20;
-const BACKFILL_KV_KEY = "memory:reembed:backfill_complete";
 
 export async function runBootReembed(): Promise<void> {
   const db = getDb();

package/src/be/memory/providers/sqlite-store.ts

@@ -488,29 +488,19 @@ export class SqliteMemoryStore implements MemoryStore {
     }
   }
 
-  list(agentId: string, options: MemoryListOptions = {}): AgentMemory[] {
-    const { scope = "all", limit = 20, offset = 0, isLead = false, source } = options;
-    const db = getDb();
-
+  private buildListWhereClause(
+    agentId: string,
+    options: MemoryListOptions,
+  ): { whereClause: string; params: (Buffer | string | number | null)[] } {
+    const { scope = "all", isLead = false, ownerAgentId, source, sourcePath } = options;
     const conditions: string[] = [];
-    const params: (string | number)[] = [];
+    const params: (Buffer | string | number | null)[] = [];
 
-    if (!isLead) {
-      if (scope === "agent") {
-        conditions.push("agentId = ? AND scope = 'agent'");
-        params.push(agentId);
-      } else if (scope === "swarm") {
-        conditions.push("scope = 'swarm'");
-      } else {
-        conditions.push("(agentId = ? OR scope = 'swarm')");
-        params.push(agentId);
-      }
-    } else {
-      if (scope === "agent") {
-        conditions.push("scope = 'agent'");
-      } else if (scope === "swarm") {
-        conditions.push("scope = 'swarm'");
-      }
+    this.addScopeConditions(conditions, params, agentId, scope, isLead);
+
+    if (ownerAgentId) {
+      conditions.push("agentId = ?");
+      params.push(ownerAgentId);
     }
 
     if (source) {
@@ -518,18 +508,45 @@ export class SqliteMemoryStore implements MemoryStore {
       params.push(source);
     }
 
-    const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
-    params.push(limit, offset);
+    const sourcePathNeedle = sourcePath?.trim().toLowerCase();
+    if (sourcePathNeedle) {
+      conditions.push("instr(lower(coalesce(sourcePath, '')), ?) > 0");
+      params.push(sourcePathNeedle);
+    }
+
+    return {
+      whereClause: conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "",
+      params,
+    };
+  }
+
+  list(agentId: string, options: MemoryListOptions = {}): AgentMemory[] {
+    const { limit = 20, offset = 0 } = options;
+    const db = getDb();
+    const { whereClause, params } = this.buildListWhereClause(agentId, options);
+    const queryParams = [...params, limit, offset];
 
     const rows = db
-      .prepare<AgentMemoryRow, (string | number)[]>(
+      .prepare<AgentMemoryRow, (Buffer | string | number | null)[]>(
         `SELECT * FROM agent_memory ${whereClause} ORDER BY createdAt DESC LIMIT ? OFFSET ?`,
       )
-      .all(...params);
+      .all(...queryParams);
 
     return rows.map(rowToAgentMemory);
   }
 
+  count(agentId: string, options: MemoryListOptions = {}): number {
+    const db = getDb();
+    const { whereClause, params } = this.buildListWhereClause(agentId, options);
+    const row = db
+      .prepare<{ count: number }, (Buffer | string | number | null)[]>(
+        `SELECT COUNT(*) AS count FROM agent_memory ${whereClause}`,
+      )
+      .get(...params);
+
+    return row?.count ?? 0;
+  }
+
   isSourceProtected(source: AgentMemorySource): boolean {
     return PROTECTED_SOURCES.has(source);
   }

package/src/be/memory/raters/llm-client.ts

@@ -75,6 +75,13 @@ AGENT RESPONSE / SUMMARY:
 
 Score 0..1.`;
 
+const PLACEHOLDER_PREFIX = "$";
+const QUERY_PLACEHOLDER = `${PLACEHOLDER_PREFIX}{query}`;
+const MEMORY_ID_PLACEHOLDER = `${PLACEHOLDER_PREFIX}{memoryId}`;
+const MEMORY_NAME_PLACEHOLDER = `${PLACEHOLDER_PREFIX}{memoryName}`;
+const MEMORY_CONTENT_PLACEHOLDER = `${PLACEHOLDER_PREFIX}{memoryContent}`;
+const RESPONSE_PLACEHOLDER = `${PLACEHOLDER_PREFIX}{response}`;
+
 /**
  * `claude -p --output-format json` returns a JSON envelope of the shape
  * `{ result: string, ... }`. We parse the envelope, then JSON-parse the
@@ -83,11 +90,11 @@ Score 0..1.`;
 type ClaudeCliEnvelope = { result?: unknown };
 
 function buildPrompt(input: LlmRaterInput): string {
-  return PROMPT_TEMPLATE.replace("${query}", input.query)
-    .replace("${memoryId}", input.memory.id)
-    .replace("${memoryName}", input.memory.name)
-    .replace("${memoryContent}", input.memory.content)
-    .replace("${response}", input.response);
+  return PROMPT_TEMPLATE.replace(QUERY_PLACEHOLDER, input.query)
+    .replace(MEMORY_ID_PLACEHOLDER, input.memory.id)
+    .replace(MEMORY_NAME_PLACEHOLDER, input.memory.name)
+    .replace(MEMORY_CONTENT_PLACEHOLDER, input.memory.content)
+    .replace(RESPONSE_PLACEHOLDER, input.response);
 }
 
 function parseScoreAndReasoning(raw: unknown): LlmRaterResult | null {

package/src/be/memory/types.ts

@@ -22,6 +22,7 @@ export interface MemoryStore {
   peek(id: string): AgentMemory | null;
   search(embedding: Float32Array, agentId: string, options: MemorySearchOptions): MemoryCandidate[];
   list(agentId: string, options: MemoryListOptions): AgentMemory[];
+  count(agentId: string, options: MemoryListOptions): number;
   isSourceProtected(source: AgentMemorySource): boolean;
   listForCuration(
     agentId?: string,
@@ -80,7 +81,9 @@ export interface MemoryListOptions {
   limit?: number;
   offset?: number;
   isLead?: boolean;
+  ownerAgentId?: string;
   source?: AgentMemorySource;
+  sourcePath?: string;
 }
 
 export interface MemoryStats {

package/src/be/migrations/088_script_runs_list_indexes.sql

@@ -0,0 +1,10 @@
+-- Keep script run list pages fast as historical rows accumulate.
+
+CREATE INDEX IF NOT EXISTS idx_script_runs_startedAt
+  ON script_runs(startedAt DESC);
+
+CREATE INDEX IF NOT EXISTS idx_script_runs_status_startedAt
+  ON script_runs(status, startedAt DESC);
+
+CREATE INDEX IF NOT EXISTS idx_script_runs_agentId_startedAt
+  ON script_runs(agentId, startedAt DESC);

package/src/be/migrations/089_harness_variant.sql

@@ -0,0 +1,2 @@
+ALTER TABLE agent_tasks ADD COLUMN harnessVariant TEXT;
+ALTER TABLE agent_tasks ADD COLUMN harnessVariantMeta TEXT;