@desplega.ai/agent-swarm 1.153.0 → 1.154.0

package/dist/{worker-cd0nhyv1.js → worker-ec6hvc4m.js}

@@ -1,71 +1,71 @@
 import {
   runAgent
-} from "./cli-s5s1f2yn.js";
-import"./cli-pgj4a5fb.js";
+} from "./cli-5vs0nh43.js";
+import"./cli-71cj99hx.js";
 import"./cli-scwq51gn.js";
 import"./cli-9b13ggd1.js";
 import"./cli-18amys3y.js";
-import"./cli-zy5w9gpt.js";
+import"./cli-95jnpnqg.js";
 import"./cli-5bfdm1ah.js";
-import"./cli-5taqtpze.js";
+import"./cli-q85qhckh.js";
 import"./cli-hsxj0yar.js";
 import"./cli-r94z9p1z.js";
 import"./cli-2djtr51b.js";
-import"./cli-pf9q3696.js";
+import"./cli-927erqqt.js";
 import"./cli-j490egb5.js";
-import"./cli-3bcmp015.js";
-import"./cli-5mbmvxnn.js";
-import"./cli-1hwnb4hc.js";
+import"./cli-kp3qs53m.js";
+import"./cli-1jpjafw4.js";
+import"./cli-09y3tjxz.js";
 import"./cli-tng3131n.js";
 import"./cli-b5b30yzk.js";
 import"./cli-zm7njwzd.js";
 import"./cli-e781c6f9.js";
-import"./cli-mzgyhxbe.js";
+import"./cli-fdzg6jhf.js";
 import"./cli-hp1n6zq3.js";
 import"./cli-eree7rnv.js";
 import"./cli-avkd6mqv.js";
 import {
   getEnabledCapabilities
-} from "./cli-qrqhc31j.js";
+} from "./cli-6r3cgpk2.js";
 import"./cli-0z2v4nhw.js";
-import"./cli-7g9s78jf.js";
+import"./cli-3bkz2p7j.js";
 import"./cli-e7d20cty.js";
 import"./cli-re8z5p8p.js";
 import"./cli-3dpj7atn.js";
-import"./cli-d6hk10xx.js";
-import"./cli-vw03hg5t.js";
-import"./cli-tdh4hjr2.js";
-import"./cli-83wkg402.js";
+import"./cli-8sea27q4.js";
+import"./cli-stwsmd6k.js";
+import"./cli-e0pg4zeh.js";
+import"./cli-e31ehqwy.js";
 import"./cli-ytxs7mn1.js";
-import"./cli-6ks9xf1n.js";
+import"./cli-pf1v8xhb.js";
 import"./cli-epan13p1.js";
 import"./cli-y89t4nca.js";
 import"./cli-f14fvzag.js";
-import"./cli-r8tdds6s.js";
+import"./cli-n62atwh9.js";
 import"./cli-bsakbbkm.js";
 import"./cli-fad8m16k.js";
 import"./cli-jsp14b6c.js";
-import"./cli-ysc1kbet.js";
-import"./cli-7pnz2v6s.js";
-import"./cli-0d9nbqxf.js";
+import"./cli-e3cyf59d.js";
+import"./cli-hws0vn86.js";
+import"./cli-g2h29qar.js";
 import"./cli-aehm1rbq.js";
 import"./cli-51tf7ac3.js";
-import"./cli-n0q9b7j4.js";
+import"./cli-c1v10xb2.js";
 import"./cli-q51yprfq.js";
 import"./cli-3er6gcsn.js";
 import"./cli-yatxqynm.js";
 import"./cli-2658f6at.js";
-import"./cli-djvxhnc4.js";
-import"./cli-zcsyfw2z.js";
-import"./cli-b2g6mzjc.js";
-import"./cli-z61ykvam.js";
+import"./cli-ge67p080.js";
+import"./cli-4k7jazkq.js";
+import"./cli-0e31nm4n.js";
+import"./cli-wg04s9kr.js";
 import"./cli-v4en75c5.js";
 import"./cli-dv6cdjs2.js";
 import"./cli-n7h1kqpf.js";
 import"./cli-ej6gbxfb.js";
 import"./cli-sd0mxa3c.js";
 import"./cli-w5e1d1vv.js";
-import"./cli-ybpp1srm.js";
+import"./cli-myaxtgh8.js";
 import"./cli-r2ap2czm.js";
 import"./cli-5b6b62tz.js";
 import"./cli-btbzvq95.js";

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "1.153.0",
+    "version": "1.154.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": [
@@ -391,6 +391,10 @@
             "type": "boolean",
             "default": false
           },
+          "deferredAt": {
+            "type": "string",
+            "format": "date-time"
+          },
           "compactionCount": {
             "type": "integer",
             "minimum": 0
@@ -4207,6 +4211,9 @@
               "api"
             ]
           },
+          "senderLabel": {
+            "type": "string"
+          },
           "createdByKind": {
             "type": "string",
             "enum": [
@@ -9553,7 +9560,7 @@
       },
       "get": {
         "summary": "List all agents",
-        "description": "Returns agents WITHOUT the six identity-markdown blobs (`claudeMd`/`soulMd`/`identityMd`/`toolsMd`/`heartbeatMd`/`setupScript`) by default — they bloat the list by ~16 KB/agent and the overview never renders them. Pass `fields=full` to restore them, or fetch a single agent via `GET /api/agents/{id}`.",
+        "description": "Returns agents WITHOUT the six identity-markdown blobs (`claudeMd`/`soulMd`/`identityMd`/`toolsMd`/`heartbeatMd`/`setupScript`) by default — they bloat the list by ~16 KB/agent and the overview never renders them. Pass `fields=full` to restore them, or fetch a single agent via `GET /api/agents/{id}`. Extension identities (`ext:<name>`, role `extension`) are never listed; they are API principals, not workers.",
         "tags": [
           "Agents"
         ],
@@ -26692,6 +26699,14 @@
                     "parentTaskId": {
                       "type": "string"
                     },
+                    "requestedDelayMs": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0
+                    },
+                    "requestedRunAt": {
+                      "type": "string",
+                      "format": "date-time"
+                    },
                     "timezone": {
                       "type": "string",
                       "default": "UTC"
@@ -27049,6 +27064,14 @@
                               "parentTaskId": {
                                 "type": "string"
                               },
+                              "requestedDelayMs": {
+                                "type": "integer",
+                                "exclusiveMinimum": 0
+                              },
+                              "requestedRunAt": {
+                                "type": "string",
+                                "format": "date-time"
+                              },
                               "timezone": {
                                 "type": "string",
                                 "default": "UTC"
@@ -27233,6 +27256,14 @@
                               "parentTaskId": {
                                 "type": "string"
                               },
+                              "requestedDelayMs": {
+                                "type": "integer",
+                                "exclusiveMinimum": 0
+                              },
+                              "requestedRunAt": {
+                                "type": "string",
+                                "format": "date-time"
+                              },
                               "timezone": {
                                 "type": "string",
                                 "default": "UTC"
@@ -27460,6 +27491,14 @@
                         "parentTaskId": {
                           "type": "string"
                         },
+                        "requestedDelayMs": {
+                          "type": "integer",
+                          "exclusiveMinimum": 0
+                        },
+                        "requestedRunAt": {
+                          "type": "string",
+                          "format": "date-time"
+                        },
                         "timezone": {
                           "type": "string",
                           "default": "UTC"
@@ -27702,6 +27741,14 @@
                     "parentTaskId": {
                       "type": "string"
                     },
+                    "requestedDelayMs": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0
+                    },
+                    "requestedRunAt": {
+                      "type": "string",
+                      "format": "date-time"
+                    },
                     "timezone": {
                       "type": "string",
                       "default": "UTC"
@@ -28064,6 +28111,14 @@
                     "parentTaskId": {
                       "type": "string"
                     },
+                    "requestedDelayMs": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0
+                    },
+                    "requestedRunAt": {
+                      "type": "string",
+                      "format": "date-time"
+                    },
                     "timezone": {
                       "type": "string",
                       "default": "UTC"
@@ -28447,6 +28502,14 @@
                     "parentTaskId": {
                       "type": "string"
                     },
+                    "requestedDelayMs": {
+                      "type": "integer",
+                      "exclusiveMinimum": 0
+                    },
+                    "requestedRunAt": {
+                      "type": "string",
+                      "format": "date-time"
+                    },
                     "timezone": {
                       "type": "string",
                       "default": "UTC"
@@ -40143,6 +40206,14 @@
                           "parentTaskId": {
                             "type": "string"
                           },
+                          "requestedDelayMs": {
+                            "type": "integer",
+                            "exclusiveMinimum": 0
+                          },
+                          "requestedRunAt": {
+                            "type": "string",
+                            "format": "date-time"
+                          },
                           "timezone": {
                             "type": "string",
                             "default": "UTC"
@@ -41422,7 +41493,7 @@
             }
           },
           "400": {
-            "description": "Validation error",
+            "description": "Validation error, or agentId/offeredTo targets an extension identity",
             "content": {
               "application/json": {
                 "schema": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.153.0",
+  "version": "1.154.0",
   "description": "agent-swarm.dev — an open-source operating system for AI work: a lead agent breaks goals into tasks, routes them to specialized workers such as Claude Code or Codex, runs each worker in an isolated container, and preserves shared memory, tools, schedules, and review gates so delegated work compounds across sessions.",
   "keywords": [
     "agent-swarm.dev",
@@ -41,6 +41,7 @@
     "plugin/commands/",
     "plugin/agents/",
     "plugin/pi-skills/",
+    "plugin/opencode-plugins/lib/memory-raters.ts",
     "templates/",
     "vendored-openapi/",
     "openapi.json"

package/plugin/opencode-plugins/lib/memory-raters.ts

@@ -0,0 +1,7 @@
+/** Unset enables citation ratings and self-rating hints; an explicitly empty value disables all raters. */
+export function getMemoryRaterNames(): string[] {
+  return (process.env.MEMORY_RATERS ?? "implicit-citation,explicit-self")
+    .split(",")
+    .map((name) => name.trim())
+    .filter(Boolean);
+}

package/src/be/db/agents.ts

@@ -206,8 +206,79 @@ export async function getAgentById(id: string): Promise<Agent | null> {
   return row ? rowToAgent(row) : null;
 }
 
-export async function getAllAgents(opts?: { slim?: boolean }): Promise<Agent[]> {
-  const rows = await getDbClient().query<AgentRow>("SELECT * FROM agents ORDER BY name");
+/**
+ * Role stamped on the `ext:<name>` agent row an extension authenticates as
+ * (`src/extensions/identity.ts`). These rows are API identities, not workers:
+ * they are hidden from agent listings and can never be assigned, offered, or
+ * claim tasks. The rows themselves are kept so the extension can keep calling
+ * the API and re-enabling it finds the same identity.
+ */
+export const EXTENSION_AGENT_ROLE = "extension";
+
+/** SQL predicate that drops extension-identity rows from an `agents` scan. */
+export const NOT_EXTENSION_AGENT_SQL = `COALESCE(role, '') != '${EXTENSION_AGENT_ROLE}'`;
+
+export function isExtensionAgent(agent: Pick<Agent, "role"> | null | undefined): boolean {
+  return agent?.role === EXTENSION_AGENT_ROLE;
+}
+
+export function extensionAgentAssignmentError(agent: Pick<Agent, "id" | "name">): string {
+  return `Agent "${agent.name}" (${agent.id}) is an extension identity and cannot be assigned, offered, or scheduled tasks. Target a worker or lead agent instead.`;
+}
+
+/**
+ * Thrown when an ordinary registration or profile update tries to grant the
+ * reserved extension role, or to strip it from an extension identity. Only
+ * `ensureExtensionAgent` may set it.
+ */
+export class ReservedAgentRoleError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "ReservedAgentRoleError";
+  }
+}
+
+/**
+ * Returns the reason a role change is refused, or null when it is allowed.
+ * `allowExtensionRole` is passed only by the extension identity lifecycle.
+ */
+export function reservedRoleViolation(
+  currentRole: string | null | undefined,
+  nextRole: string | undefined,
+  opts?: { allowExtensionRole?: boolean },
+): string | null {
+  if (nextRole === undefined || nextRole === currentRole) return null;
+  if (currentRole === EXTENSION_AGENT_ROLE) {
+    return `Extension identities keep the "${EXTENSION_AGENT_ROLE}" role; it cannot be changed.`;
+  }
+  if (nextRole === EXTENSION_AGENT_ROLE && !opts?.allowExtensionRole) {
+    return `Role "${EXTENSION_AGENT_ROLE}" is reserved for extension identities.`;
+  }
+  return null;
+}
+
+/** Thrown by task creation when the assignee or offer target is an extension identity. */
+export class ExtensionAgentAssignmentError extends Error {
+  constructor(agent: Pick<Agent, "id" | "name">) {
+    super(extensionAgentAssignmentError(agent));
+    this.name = "ExtensionAgentAssignmentError";
+  }
+}
+
+/**
+ * Lists agents ordered by name. Extension identities are excluded unless
+ * `includeExtensions` is set; only the extension identity lifecycle and
+ * name-collision checks need them.
+ */
+export async function getAllAgents(opts?: {
+  slim?: boolean;
+  includeExtensions?: boolean;
+}): Promise<Agent[]> {
+  const rows = await getDbClient().query<AgentRow>(
+    opts?.includeExtensions
+      ? "SELECT * FROM agents ORDER BY name"
+      : `SELECT * FROM agents WHERE ${NOT_EXTENSION_AGENT_SQL} ORDER BY name`,
+  );
   return rows.map((row) => rowToAgent(row, opts?.slim ?? false));
 }
 
@@ -529,6 +600,8 @@ export function isAgentEligibleForTask(
   agent: Pick<Agent, "id" | "isLead" | "role" | "capabilities">,
   task: Pick<AgentTask, "routingAffinity" | "routingAffinityInvalid">,
 ): boolean {
+  // Extension identities are API principals, never task executors.
+  if (isExtensionAgent(agent)) return false;
   const affinity = task.routingAffinity;
   // A malformed persisted blob is a security boundary failure, not an
   // untagged task. Quarantine it from every assignment/claim path.

package/src/be/db/tasks/read.ts

@@ -103,6 +103,7 @@ export type AgentTaskRow = {
   peakContextTokens: number | null;
   contextWindowSize: number | null;
   was_paused: number;
+  deferredAt: string | null;
   credentialKeySuffix: string | null;
   credentialKeyType: string | null;
   requestedByUserId: string | null;
@@ -228,6 +229,7 @@ export function rowToAgentTask(row: AgentTaskRow): AgentTask {
     output: row.output ?? undefined,
     progress: row.progress ?? undefined,
     wasPaused: !!row.was_paused,
+    deferredAt: row.deferredAt ?? undefined,
     credentialKeySuffix: row.credentialKeySuffix ?? undefined,
     credentialKeyType: row.credentialKeyType ?? undefined,
     requestedByUserId: row.requestedByUserId ?? undefined,

package/src/be/db/tasks/write.ts

@@ -326,7 +326,7 @@ export async function updateTaskTitle(
 export async function completeTask(
   id: string,
   output?: string,
-  options?: { addTags?: string[] },
+  options?: { addTags?: string[]; deferredAt?: string },
 ): Promise<AgentTask | null> {
   const oldTask = await getTaskById(id);
   if (!oldTask) return null;
@@ -364,6 +364,12 @@ export async function completeTask(
         [JSON.stringify(nextTags), id],
       );
     }
+    if (completed && options?.deferredAt) {
+      completed = await getDbClient().get<AgentTaskRow>(
+        "UPDATE agent_tasks SET deferredAt = ?, lastUpdatedAt = strftime('%Y-%m-%dT%H:%M:%fZ', 'now') WHERE id = ? RETURNING *",
+        [options.deferredAt, id],
+      );
+    }
     if (completed) {
       await dependencies.reconcileTaskPullRequestAttachments(id, completed.agentId, [
         completed.output,