@desplega.ai/agent-swarm 1.65.0 → 1.66.0

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "1.65.0",
+    "version": "1.66.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": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.65.0",
+  "version": "1.66.0",
   "description": "Multi-agent orchestration for Claude Code, Codex, Gemini CLI, and other AI coding assistants",
   "license": "MIT",
   "author": "desplega.sh <contact@desplega.sh>",

package/src/be/db.ts

@@ -1,4 +1,5 @@
 import { Database } from "bun:sqlite";
+import pkg from "../../package.json";
 import { addEyesReactionOnTaskStart } from "../github/task-reactions";
 import { configureDbResolver } from "../prompts/resolver";
 import type {
@@ -764,6 +765,7 @@ type AgentTaskRow = {
   credentialKeySuffix: string | null;
   credentialKeyType: string | null;
   requestedByUserId: string | null;
+  swarmVersion: string | null;
 };
 
 function rowToAgentTask(row: AgentTaskRow): AgentTask {
@@ -823,6 +825,7 @@ function rowToAgentTask(row: AgentTaskRow): AgentTask {
     credentialKeySuffix: row.credentialKeySuffix ?? undefined,
     credentialKeyType: row.credentialKeyType ?? undefined,
     requestedByUserId: row.requestedByUserId ?? undefined,
+    swarmVersion: row.swarmVersion ?? undefined,
   };
 }
 
@@ -839,10 +842,11 @@ export const taskQueries = {
         string | null,
         string | null,
         string | null,
+        string,
       ]
     >(
-      `INSERT INTO agent_tasks (id, agentId, task, status, source, slackChannelId, slackThreadTs, slackUserId, createdAt, lastUpdatedAt)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), strftime('%Y-%m-%dT%H:%M:%fZ', 'now')) RETURNING *`,
+      `INSERT INTO agent_tasks (id, agentId, task, status, source, slackChannelId, slackThreadTs, slackUserId, swarmVersion, createdAt, lastUpdatedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), strftime('%Y-%m-%dT%H:%M:%fZ', 'now')) RETURNING *`,
     ),
 
   getById: () => getDb().prepare<AgentTaskRow, [string]>("SELECT * FROM agent_tasks WHERE id = ?"),
@@ -913,6 +917,7 @@ export function createTask(
       options?.slackChannelId ?? null,
       options?.slackThreadTs ?? null,
       options?.slackUserId ?? null,
+      pkg.version,
     );
   if (!row) throw new Error("Failed to create task");
   try {
@@ -1952,8 +1957,8 @@ export function createTaskExtended(task: string, options?: CreateTaskOptions): A
         vcsInstallationId, vcsNodeId,
         agentmailInboxId, agentmailMessageId, agentmailThreadId,
         mentionMessageId, mentionChannelId, dir, parentTaskId, model, scheduleId,
-        workflowRunId, workflowRunStepId, outputSchema, requestedByUserId, createdAt, lastUpdatedAt
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`,
+        workflowRunId, workflowRunStepId, outputSchema, requestedByUserId, swarmVersion, createdAt, lastUpdatedAt
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`,
     )
     .get(
       id,
@@ -1993,6 +1998,7 @@ export function createTaskExtended(task: string, options?: CreateTaskOptions): A
       options?.workflowRunStepId ?? null,
       options?.outputSchema ? JSON.stringify(options.outputSchema) : null,
       options?.requestedByUserId ?? null,
+      pkg.version,
       now,
       now,
     );

package/src/be/migrations/037_swarm_version.sql

@@ -0,0 +1,7 @@
+-- Stamp agent-swarm version on each task at creation time.
+-- Enables benchmarking performance (cost, duration, tokens, etc.) across releases.
+-- Existing rows stay NULL; benchmark queries should filter WHERE swarmVersion IS NOT NULL.
+ALTER TABLE agent_tasks ADD COLUMN swarmVersion TEXT;
+
+CREATE INDEX IF NOT EXISTS idx_agent_tasks_swarmVersion
+  ON agent_tasks(swarmVersion);

package/src/tests/task-swarm-version.test.ts

@@ -0,0 +1,81 @@
+import { afterAll, beforeAll, describe, expect, test } from "bun:test";
+import { unlink } from "node:fs/promises";
+import pkg from "../../package.json";
+import {
+  closeDb,
+  createAgent,
+  createTask,
+  createTaskExtended,
+  getDb,
+  getTaskById,
+  initDb,
+} from "../be/db";
+
+const TEST_DB_PATH = "./test-task-swarm-version.sqlite";
+
+describe("Task swarmVersion tracking", () => {
+  beforeAll(async () => {
+    try {
+      await unlink(TEST_DB_PATH);
+    } catch {}
+    initDb(TEST_DB_PATH);
+  });
+
+  afterAll(async () => {
+    closeDb();
+    for (const suffix of ["", "-wal", "-shm"]) {
+      try {
+        await unlink(`${TEST_DB_PATH}${suffix}`);
+      } catch {}
+    }
+  });
+
+  test("createTaskExtended stamps pkg.version on new tasks", () => {
+    const agent = createAgent({
+      id: "swarm-version-agent-1",
+      name: "Swarm Version Agent",
+      isLead: false,
+      status: "idle",
+    });
+
+    const task = createTaskExtended("extended task", { agentId: agent.id });
+
+    expect(task.swarmVersion).toBe(pkg.version);
+
+    const reloaded = getTaskById(task.id);
+    expect(reloaded?.swarmVersion).toBe(pkg.version);
+  });
+
+  test("createTask stamps pkg.version on new tasks", () => {
+    const agent = createAgent({
+      id: "swarm-version-agent-2",
+      name: "Swarm Version Agent 2",
+      isLead: false,
+      status: "idle",
+    });
+
+    const task = createTask(agent.id, "basic task");
+
+    expect(task.swarmVersion).toBe(pkg.version);
+
+    const reloaded = getTaskById(task.id);
+    expect(reloaded?.swarmVersion).toBe(pkg.version);
+  });
+
+  test("column exists and is indexed", () => {
+    const db = getDb();
+    const columns = db
+      .prepare<{ name: string }, []>("PRAGMA table_info(agent_tasks)")
+      .all()
+      .map((c) => c.name);
+    expect(columns).toContain("swarmVersion");
+
+    const indexes = db
+      .prepare<{ name: string }, []>(
+        "SELECT name FROM sqlite_master WHERE type='index' AND tbl_name='agent_tasks'",
+      )
+      .all()
+      .map((i) => i.name);
+    expect(indexes).toContain("idx_agent_tasks_swarmVersion");
+  });
+});

package/src/types.ts

@@ -159,6 +159,10 @@ export const AgentTaskSchema = z.object({
 
   // User identity — canonical user who requested this task
   requestedByUserId: z.string().optional(),
+
+  // agent-swarm package version at task creation time. Enables benchmarking
+  // performance across releases. Nullable for rows created before tracking was added.
+  swarmVersion: z.string().optional(),
 });
 
 // ============================================================================