@desplega.ai/agent-swarm 1.73.4 → 1.74.0

package/README.md

@@ -89,7 +89,7 @@ flowchart LR
 - **Multi-channel inputs** — Slack, GitHub, GitLab, email, Linear, Jira, and the HTTP API all create tasks. [Integrations](#integrations)
 - **Workflow engine with Human-in-the-Loop** — DAG-based automation with approval gates, retries, and structured I/O. [Workflows →](https://docs.agent-swarm.dev/docs/concepts/workflows)
 - **Scheduled & recurring tasks** — cron-based automation for standing work. [Scheduling →](https://docs.agent-swarm.dev/docs/concepts/scheduling)
-- **Multi-provider** — run with Claude Code, OpenAI Codex, pi-mono, Devin, or Claude Managed Agents. [Harness config →](https://docs.agent-swarm.dev/docs/guides/harness-configuration) · [Add a new provider →](https://docs.agent-swarm.dev/docs/guides/harness-providers)
+- **Multi-provider** — run with Claude Code, OpenAI Codex, pi-mono, Devin, Claude Managed Agents, or opencode. [Harness config →](https://docs.agent-swarm.dev/docs/guides/harness-configuration) · [Add a new provider →](https://docs.agent-swarm.dev/docs/guides/harness-providers)
 - **Skills & MCP servers** — reusable procedural knowledge and per-agent MCP servers with scope cascade. [MCP tools →](https://docs.agent-swarm.dev/docs/reference/mcp-tools)
 - **Real-time dashboard** — monitor agents, tasks, and inter-agent chat. [app.agent-swarm.dev →](https://app.agent-swarm.dev)
 

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "1.73.4",
+    "version": "1.73.5",
     "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": [
@@ -315,6 +315,17 @@
                   },
                   "maxTasks": {
                     "type": "integer"
+                  },
+                  "provider": {
+                    "type": "string",
+                    "enum": [
+                      "claude",
+                      "codex",
+                      "pi",
+                      "devin",
+                      "claude-managed",
+                      "opencode"
+                    ]
                   }
                 },
                 "required": [
@@ -5127,7 +5138,8 @@
                     "enum": [
                       "claude",
                       "codex",
-                      "pi"
+                      "pi",
+                      "opencode"
                     ]
                   },
                   "createdAt": {
@@ -6847,6 +6859,9 @@
                           "devin"
                         ]
                       },
+                      "model": {
+                        "type": "string"
+                      },
                       "providerMeta": {
                         "type": "object",
                         "properties": {
@@ -6884,9 +6899,13 @@
                           "claude",
                           "codex",
                           "pi",
-                          "claude-managed"
+                          "claude-managed",
+                          "opencode"
                         ]
                       },
+                      "model": {
+                        "type": "string"
+                      },
                       "providerMeta": {
                         "type": "object",
                         "properties": {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.73.4",
+  "version": "1.74.0",
   "description": "Multi-agent orchestration for Claude Code, Codex, Gemini CLI, and other AI coding assistants",
   "license": "MIT",
   "author": "desplega.sh <contact@desplega.sh>",
@@ -87,6 +87,7 @@
   "devDependencies": {
     "@biomejs/biome": "^2.3.10",
     "@faker-js/faker": "^10.4.0",
+    "@opencode-ai/plugin": "1.14.30",
     "@types/bun": "latest"
   },
   "peerDependencies": {
@@ -97,17 +98,18 @@
   },
   "dependencies": {
     "@ai-sdk/openai": "^3.0.41",
-    "@anthropic-ai/sdk": "latest",
+    "@anthropic-ai/sdk": "^0.93.0",
     "@asteasolutions/zod-to-openapi": "^8.0.0",
     "@desplega.ai/business-use": "^0.4.2",
     "@desplega.ai/localtunnel": "^2.2.0",
     "@inkjs/ui": "^2.0.0",
     "@linear/sdk": "^77.0.0",
-    "@mariozechner/pi-agent-core": "^0.67.2",
-    "@mariozechner/pi-ai": "^0.67.2",
-    "@mariozechner/pi-coding-agent": "^0.67.2",
+    "@mariozechner/pi-agent-core": "^0.73.0",
+    "@mariozechner/pi-ai": "^0.73.0",
+    "@mariozechner/pi-coding-agent": "^0.73.0",
     "@modelcontextprotocol/sdk": "^1.25.1",
-    "@openai/codex-sdk": "^0.118.0",
+    "@openai/codex-sdk": "^0.125.0",
+    "@opencode-ai/sdk": "^1.14.30",
     "@openfort/openfort-node": "^0.9.1",
     "@slack/bolt": "^4.6.0",
     "@types/react": "^19.2.7",

package/src/be/db.ts

@@ -549,6 +549,7 @@ type AgentRow = {
   toolsMd: string | null;
   heartbeatMd: string | null;
   lastActivityAt: string | null;
+  provider: string | null;
   createdAt: string;
   lastUpdatedAt: string;
 };
@@ -571,6 +572,7 @@ function rowToAgent(row: AgentRow): Agent {
     toolsMd: row.toolsMd ?? undefined,
     heartbeatMd: row.heartbeatMd ?? undefined,
     lastActivityAt: row.lastActivityAt ?? undefined,
+    provider: (row.provider as ProviderName | null) ?? undefined,
     createdAt: row.createdAt,
     lastUpdatedAt: row.lastUpdatedAt,
   };
@@ -578,8 +580,8 @@ function rowToAgent(row: AgentRow): Agent {
 
 export const agentQueries = {
   insert: () =>
-    getDb().prepare<AgentRow, [string, string, number, AgentStatus, number]>(
-      "INSERT INTO agents (id, name, isLead, status, maxTasks, createdAt, lastUpdatedAt) VALUES (?, ?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), strftime('%Y-%m-%dT%H:%M:%fZ', 'now')) RETURNING *",
+    getDb().prepare<AgentRow, [string, string, number, AgentStatus, number, string | null]>(
+      "INSERT INTO agents (id, name, isLead, status, maxTasks, provider, createdAt, lastUpdatedAt) VALUES (?, ?, ?, ?, ?, ?, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'), strftime('%Y-%m-%dT%H:%M:%fZ', 'now')) RETURNING *",
     ),
 
   getById: () => getDb().prepare<AgentRow, [string]>("SELECT * FROM agents WHERE id = ?"),
@@ -601,7 +603,7 @@ export function createAgent(
   const maxTasks = agent.maxTasks ?? 1;
   const row = agentQueries
     .insert()
-    .get(id, agent.name, agent.isLead ? 1 : 0, agent.status, maxTasks);
+    .get(id, agent.name, agent.isLead ? 1 : 0, agent.status, maxTasks, agent.provider ?? null);
   if (!row) throw new Error("Failed to create agent");
   try {
     createLogEntry({ eventType: "agent_joined", agentId: id, newValue: agent.status });
@@ -649,6 +651,16 @@ export function updateAgentMaxTasks(id: string, maxTasks: number): Agent | null
   return row ? rowToAgent(row) : null;
 }
 
+export function updateAgentProvider(id: string, provider: ProviderName): Agent | null {
+  const row = getDb()
+    .prepare<AgentRow, [string, string]>(
+      `UPDATE agents SET provider = ?, lastUpdatedAt = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
+       WHERE id = ? RETURNING *`,
+    )
+    .get(provider, id);
+  return row ? rowToAgent(row) : null;
+}
+
 export function updateAgentActivity(id: string): void {
   getDb()
     .prepare<null, [string]>(
@@ -1078,6 +1090,7 @@ export function updateTaskClaudeSessionId(
   claudeSessionId: string,
   provider?: ProviderName,
   providerMeta?: Record<string, unknown>,
+  model?: string,
 ): AgentTask | null {
   const setClauses = ["claudeSessionId = ?", "lastUpdatedAt = ?"];
   const params: (string | null)[] = [claudeSessionId, new Date().toISOString()];
@@ -1090,6 +1103,10 @@ export function updateTaskClaudeSessionId(
     setClauses.push("providerMeta = ?");
     params.push(JSON.stringify(providerMeta));
   }
+  if (model !== undefined) {
+    setClauses.push("model = ?");
+    params.push(model);
+  }
 
   params.push(taskId);
 
@@ -2016,6 +2033,15 @@ export interface CreateTaskOptions {
   workflowRunId?: string;
   workflowRunStepId?: string;
   sourceTaskId?: string;
+  /**
+   * Optional JSON Schema the agent's final output must conform to.
+   *
+   * Enforced via the MCP `store-progress` tool (validated in
+   * `src/tools/store-progress.ts`). NOT enforced when the task runs on
+   * default-mode Devin (no MCP) — see runbooks/harness-providers.md
+   * ("Per-task outputSchema support"). Callers reading `task.output` for
+   * a schema'd task should be defensive about JSON parsing.
+   */
   outputSchema?: Record<string, unknown>;
   requestedByUserId?: string;
   contextKey?: string;

package/src/be/migrations/048_agent_provider.sql

@@ -0,0 +1 @@
+ALTER TABLE agents ADD COLUMN provider TEXT;

package/src/commands/runner.ts

@@ -551,6 +551,10 @@ export async function ensureTaskFinished(
     body.failureReason = failureReason || `Claude process exited with code ${exitCode}`;
   } else if (providerOutput) {
     // Provider already supplied structured output (e.g. Devin) — use directly.
+    // NOTE: providerOutput is NOT validated against task.outputSchema here.
+    // Known gap for default-mode Devin; see runbooks/harness-providers.md
+    // ("Per-task outputSchema support"). Schema enforcement only happens on
+    // the MCP path via store-progress.
     body.output = providerOutput;
   } else {
     // Try structured output fallback if the task has an outputSchema
@@ -1050,12 +1054,14 @@ async function saveProviderSessionId(
   claudeSessionId: string,
   provider?: ProviderName,
   providerMeta?: Record<string, unknown>,
+  model?: string,
 ): Promise<void> {
   const headers: Record<string, string> = { "Content-Type": "application/json" };
   if (apiKey) headers.Authorization = `Bearer ${apiKey}`;
   const body: Record<string, unknown> = { claudeSessionId };
   if (provider !== undefined) body.provider = provider;
   if (providerMeta !== undefined) body.providerMeta = providerMeta;
+  if (model !== undefined && model !== "") body.model = model;
   await fetch(`${apiUrl}/api/tasks/${taskId}/claude-session`, {
     method: "PUT",
     headers,
@@ -1338,6 +1344,8 @@ async function registerAgent(opts: {
     headers.Authorization = `Bearer ${opts.apiKey}`;
   }
 
+  const provider = (process.env.HARNESS_PROVIDER || "claude") as ProviderName;
+
   const response = await fetch(`${opts.apiUrl}/api/agents`, {
     method: "POST",
     headers,
@@ -1347,6 +1355,7 @@ async function registerAgent(opts: {
       role: opts.role,
       capabilities: opts.capabilities,
       maxTasks: opts.maxTasks,
+      provider,
     }),
   });
 
@@ -1745,6 +1754,7 @@ async function spawnProviderProcess(
             event.sessionId,
             event.provider,
             event.providerMeta,
+            model,
           ).catch((err) => console.warn(`[runner] Failed to save session ID: ${err}`));
         } else {
           // Pool task: save provider session ID on active session so it can be

package/src/hooks/hook.ts

@@ -691,12 +691,6 @@ export async function handleHook(): Promise<void> {
         console.log(tray);
       }
     }
-
-    if (!agentInfo.isLead && agentInfo.status === "busy") {
-      console.log(
-        `Remember to call store-progress periodically to update the lead agent on your progress as you are currently marked as busy. The comments you leave will be helpful for the lead agent to monitor your work.`,
-      );
-    }
   } else {
     console.log(
       `You are not registered in the agent swarm yet. Use the join-swarm tool to register yourself, then check your status with my-agent-info.
@@ -995,10 +989,6 @@ ${hasAgentIdHeader() ? `You have a pre-defined agent ID via header: ${mcpConfig?
               `Task sent successfully.${maybeTaskId ? ` Task ID: ${maybeTaskId}.` : ""} Monitor progress using the get-task-details tool periodically.`,
             );
           }
-        } else {
-          console.log(
-            `Remember to call store-progress periodically to update the lead agent on your progress.`,
-          );
         }
       }
       break;

package/src/http/agents.ts

@@ -14,8 +14,10 @@ import {
   updateAgentMaxTasks,
   updateAgentName,
   updateAgentProfile,
+  updateAgentProvider,
   updateAgentStatus,
 } from "../be/db";
+import { ProviderNameSchema } from "../types";
 import { route } from "./route-def";
 import { agentWithCapacity, json, jsonError } from "./utils";
 
@@ -34,6 +36,7 @@ const registerAgent = route({
     role: z.string().optional(),
     capabilities: z.array(z.string()).optional(),
     maxTasks: z.number().int().optional(),
+    provider: ProviderNameSchema.optional(),
   }),
   responses: {
     200: { description: "Agent re-registered (already existed)" },
@@ -163,6 +166,9 @@ export async function handleAgentRegister(
         if (parsed.body.maxTasks !== undefined && parsed.body.maxTasks !== existingAgent.maxTasks) {
           updateAgentMaxTasks(existingAgent.id, parsed.body.maxTasks);
         }
+        if (parsed.body.provider && parsed.body.provider !== existingAgent.provider) {
+          updateAgentProvider(existingAgent.id, parsed.body.provider);
+        }
         resetEmptyPollCount(existingAgent.id);
         return { agent: getAgentById(agentId), created: false };
       }
@@ -176,6 +182,7 @@ export async function handleAgentRegister(
         role: parsed.body.role,
         capabilities: parsed.body.capabilities ?? [],
         maxTasks: parsed.body.maxTasks ?? 1,
+        provider: parsed.body.provider,
       });
 
       return { agent, created: true };

package/src/http/session-data.ts

@@ -72,10 +72,10 @@ const createSessionCostRoute = route({
     isError: z.boolean().optional(),
     /**
      * Phase 6: when present, drives the codex pricing-table recompute path.
-     * Other providers ('claude' / 'pi') always trust harness-reported USD.
+     * Other providers ('claude' / 'pi' / 'opencode') always trust harness-reported USD.
      * Optional / undefined keeps back-compat for existing callers.
      */
-    provider: z.enum(["claude", "codex", "pi"]).optional(),
+    provider: z.enum(["claude", "codex", "pi", "opencode"]).optional(),
     /**
      * Phase 6: epoch-ms timestamp used as the "active price at time T" lookup
      * basis. Defaults to `Date.now()` when omitted. Including it lets
@@ -193,7 +193,7 @@ export async function handleSessionData(
       // time, recompute `totalCostUsd` from tokens × DB prices and tag the
       // row as 'pricing-table'. If any class has no row, fall back to the
       // worker-reported value with `costSource='harness'` (back-compat for
-      // unseeded models). Claude / pi paths always use 'harness'.
+      // unseeded models). Claude / pi / opencode paths always use 'harness'.
       let totalCostUsd = parsed.body.totalCostUsd;
       let costSource: SessionCostSource = "harness";
 

package/src/http/tasks.ts

@@ -83,6 +83,7 @@ const updateClaudeSession = route({
     z.object({
       claudeSessionId: z.string().min(1),
       provider: z.literal("devin"),
+      model: z.string().optional(),
       providerMeta: z.object({
         sessionUrl: z.string(),
         maxAcuLimit: z.number().optional(),
@@ -92,6 +93,7 @@ const updateClaudeSession = route({
     z.object({
       claudeSessionId: z.string().min(1),
       provider: ProviderNameSchema.exclude(["devin"]).optional(),
+      model: z.string().optional(),
       providerMeta: z.object({}).optional(),
     }),
   ]),
@@ -312,6 +314,7 @@ export async function handleTasks(
       parsed.body.claudeSessionId,
       parsed.body.provider,
       parsed.body.providerMeta,
+      parsed.body.model,
     );
     if (!task) {
       jsonError(res, "Task not found", 404);

package/src/providers/claude-adapter.ts

@@ -7,6 +7,7 @@ import {
   SessionErrorTracker,
   trackErrorFromJson,
 } from "../utils/error-tracker";
+import { fetchInstalledMcpServers } from "../utils/mcp-server-fetcher";
 import { scrubSecrets } from "../utils/secret-scrubber";
 import type {
   CostData,
@@ -42,70 +43,6 @@ async function cleanupTaskFile(pid: number): Promise<void> {
   }
 }
 
-/** Fetch installed MCP servers from the API and return them as .mcp.json-compatible entries */
-async function fetchInstalledMcpServers(
-  apiUrl: string,
-  apiKey: string,
-  agentId: string,
-): Promise<Record<string, Record<string, unknown>> | null> {
-  try {
-    const res = await fetch(`${apiUrl}/api/agents/${agentId}/mcp-servers?resolveSecrets=true`, {
-      headers: {
-        Authorization: `Bearer ${apiKey}`,
-        "X-Agent-ID": agentId,
-      },
-    });
-    if (!res.ok) return null;
-
-    const data = (await res.json()) as {
-      servers: Array<{
-        name: string;
-        transport: string;
-        isActive: boolean;
-        isEnabled: boolean;
-        command?: string;
-        args?: string;
-        url?: string;
-        headers?: string;
-        resolvedEnv?: Record<string, string>;
-        resolvedHeaders?: Record<string, string>;
-      }>;
-    };
-
-    const entries: Record<string, Record<string, unknown>> = {};
-    for (const srv of data.servers.filter((s) => s.isActive && s.isEnabled)) {
-      if (srv.transport === "stdio" && srv.command) {
-        let args: string[] = [];
-        try {
-          args = srv.args ? JSON.parse(srv.args) : [];
-        } catch {
-          // invalid JSON — use empty args
-        }
-        entries[srv.name] = {
-          command: srv.command,
-          args,
-          env: srv.resolvedEnv || {},
-        };
-      } else if ((srv.transport === "http" || srv.transport === "sse") && srv.url) {
-        let parsedHeaders: Record<string, string> = {};
-        try {
-          parsedHeaders = srv.headers ? JSON.parse(srv.headers) : {};
-        } catch {
-          // invalid JSON — use empty headers
-        }
-        entries[srv.name] = {
-          type: srv.transport,
-          url: srv.url,
-          headers: { ...parsedHeaders, ...(srv.resolvedHeaders || {}) },
-        };
-      }
-    }
-    return Object.keys(entries).length > 0 ? entries : null;
-  } catch {
-    return null;
-  }
-}
-
 /**
  * Merge a base MCP config (typically read from `.mcp.json`) with freshly-resolved
  * installed servers from the API, and inject the per-task `X-Source-Task-Id` header
@@ -592,7 +529,7 @@ export class ClaudeAdapter implements ProviderAdapter {
     // Fetch installed MCP servers from API for this agent
     const installedServers =
       config.apiUrl && config.apiKey && config.agentId
-        ? await fetchInstalledMcpServers(config.apiUrl, config.apiKey, config.agentId)
+        ? await fetchInstalledMcpServers(config.apiUrl, config.apiKey, config.agentId, "claude")
         : null;
     if (installedServers) {
       console.log(

package/src/providers/index.ts

@@ -12,6 +12,7 @@ import { ClaudeAdapter } from "./claude-adapter";
 import { ClaudeManagedAdapter } from "./claude-managed-adapter";
 import { CodexAdapter } from "./codex-adapter";
 import { DevinAdapter } from "./devin-adapter";
+import { OpencodeAdapter } from "./opencode-adapter";
 import { PiMonoAdapter } from "./pi-mono-adapter";
 import type { ProviderAdapter } from "./types";
 
@@ -28,9 +29,11 @@ export function createProviderAdapter(provider: string): ProviderAdapter {
       return new ClaudeManagedAdapter();
     case "devin":
       return new DevinAdapter();
+    case "opencode":
+      return new OpencodeAdapter();
     default:
       throw new Error(
-        `Unknown HARNESS_PROVIDER: "${provider}". Supported: claude, pi, codex, devin, claude-managed`,
+        `Unknown HARNESS_PROVIDER: "${provider}". Supported: claude, pi, codex, devin, claude-managed, opencode`,
       );
   }
 }