@desplega.ai/agent-swarm 1.147.0 → 1.149.0

package/dist/{worker-kznxp4qm.js → worker-qmb2d1e2.js}

@@ -1,25 +1,25 @@
 import {
   runAgent
-} from "./cli-tzvk9haz.js";
-import"./cli-0b6y7kxm.js";
-import"./cli-4nr988h6.js";
-import"./cli-cn6mmc7f.js";
+} from "./cli-phsxnkp6.js";
+import"./cli-xm87hzbw.js";
+import"./cli-e95cx1eb.js";
+import"./cli-6664w7y4.js";
 import"./cli-hsxj0yar.js";
 import"./cli-9b13ggd1.js";
-import"./cli-ct0et58h.js";
+import"./cli-5my3bjsd.js";
 import"./cli-5bfdm1ah.js";
 import"./cli-r94z9p1z.js";
 import"./cli-2djtr51b.js";
 import {
   getEnabledCapabilities
-} from "./cli-atcve9y8.js";
-import"./cli-8fc8de14.js";
+} from "./cli-yb9qhqam.js";
+import"./cli-0z2v4nhw.js";
 import"./cli-j490egb5.js";
-import"./cli-719k9j2c.js";
-import"./cli-89xfd7f9.js";
-import"./cli-d8brzxjb.js";
+import"./cli-7smrsr25.js";
+import"./cli-cr12paw2.js";
+import"./cli-4wtq5jjv.js";
 import"./cli-b5b30yzk.js";
-import"./cli-rvqz34y5.js";
+import"./cli-jecc01cb.js";
 import"./cli-hp1n6zq3.js";
 import"./cli-tng3131n.js";
 import"./cli-zm7njwzd.js";
@@ -27,49 +27,49 @@ import"./cli-s25avqg9.js";
 import"./cli-eree7rnv.js";
 import"./cli-xvkmedgn.js";
 import"./cli-4yc5d8fk.js";
-import"./cli-smby5m17.js";
-import"./cli-m8yrsg97.js";
-import"./cli-rw51bq3j.js";
-import"./cli-8v0g1yc8.js";
+import"./cli-ygweqcn4.js";
+import"./cli-sd5pv3b1.js";
+import"./cli-9fy6nk6g.js";
+import"./cli-k0cr4kat.js";
 import"./cli-cmp8g3sw.js";
-import"./cli-de14znh8.js";
+import"./cli-19f354qr.js";
 import"./cli-qgm2pfpq.js";
-import"./cli-f7dsy61y.js";
+import"./cli-mnmsfd1w.js";
 import"./cli-07jd68a1.js";
-import"./cli-yz3djrm0.js";
+import"./cli-6pqcb4q0.js";
 import"./cli-1ebpar1q.js";
 import"./cli-e7d20cty.js";
 import"./cli-3dpj7atn.js";
-import"./cli-3tgwnf43.js";
+import"./cli-aae6hz6a.js";
 import"./cli-epan13p1.js";
-import"./cli-hbv0kq6w.js";
-import"./cli-1th1728g.js";
+import"./cli-2qts1hys.js";
+import"./cli-3q5ejx9p.js";
 import"./cli-y89t4nca.js";
 import"./cli-f14fvzag.js";
-import"./cli-m9sxbkhm.js";
-import"./cli-zhjmqxzh.js";
+import"./cli-zvz62chv.js";
+import"./cli-9hspd3dp.js";
 import"./cli-fad8m16k.js";
 import"./cli-aehm1rbq.js";
 import"./cli-bsakbbkm.js";
 import"./cli-51tf7ac3.js";
-import"./cli-mmemxxdc.js";
+import"./cli-kgz4np97.js";
 import"./cli-jsp14b6c.js";
-import"./cli-p1d5b073.js";
-import"./cli-53s590z8.js";
-import"./cli-b5bq9crk.js";
+import"./cli-gv88e1vf.js";
+import"./cli-q50ef8g0.js";
+import"./cli-d8ftsp62.js";
 import"./cli-q51yprfq.js";
 import"./cli-9d8ntetj.js";
 import"./cli-yatxqynm.js";
-import"./cli-ftht3zzj.js";
-import"./cli-y6b6fb76.js";
-import"./cli-kpv03zhj.js";
+import"./cli-yab68w40.js";
+import"./cli-08b07b4r.js";
+import"./cli-3apbzgyk.js";
 import"./cli-e29gmdmw.js";
 import"./cli-c2mk1kgf.js";
 import"./cli-ej6gbxfb.js";
 import"./cli-sd0mxa3c.js";
 import"./cli-w5e1d1vv.js";
-import"./cli-w9kb3bk1.js";
-import"./cli-xqcq9y5e.js";
+import"./cli-kjwt6hdf.js";
+import"./cli-r2ap2czm.js";
 import"./cli-pzxba7gw.js";
 import"./cli-f7kvq46p.js";
 import"./cli-zf8jjwex.js";

package/dist/{x-n2phr5vm.js → x-n3e0v3xa.js}

@@ -3,11 +3,11 @@ import {
   executeComposioRequest,
   formatComposioResultForCli,
   parseComposioArgs
-} from "./cli-8fc8de14.js";
+} from "./cli-0z2v4nhw.js";
 import {
   init_secret_scrubber,
   scrubSecrets
-} from "./cli-xqcq9y5e.js";
+} from "./cli-r2ap2czm.js";
 import"./cli-bc05qbss.js";
 
 // src/commands/x.ts

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "1.147.0",
+    "version": "1.149.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": [
@@ -174,6 +174,20 @@
             ],
             "default": "mcp"
           },
+          "routingReason": {
+            "type": "string",
+            "enum": [
+              "skill",
+              "continuity",
+              "overflow",
+              "human_pinned",
+              "reroute_fault"
+            ]
+          },
+          "routingNote": {
+            "type": "string",
+            "maxLength": 200
+          },
           "taskType": {
             "type": "string",
             "maxLength": 50
@@ -4065,7 +4079,7 @@
           "config": {
             "type": "object",
             "additionalProperties": {},
-            "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, tags?, priority?, dir?, vcsRepo?, model? }. For script: { runtime, script, args?, timeout? }. For swarm-script: { scriptName, scope?, pinHash?, args?, fsMode?, timeoutMs? (1000-300000) }. Agent-task templates and ordinary config values support {{interpolation}} from the node's inputs context, including trigger and declared upstream aliases. SECURITY: executable source for script/swarm-script nodes does not interpolate trigger.* or upstream node outputs; only input/workflow/swarm/run values are allowed in inline script source, and named swarm-script source is not workflow-interpolated. Pass dynamic values through config.args instead (inline script receives them as argv; swarm-script receives its args object). NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
+            "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, routingReason?, routingNote?, tags?, priority?, dir?, vcsRepo?, model? }; configured agentId defaults routingReason to human_pinned. For script: { runtime, script, args?, timeout? }. For swarm-script: { scriptName, scope?, pinHash?, args?, fsMode?, timeoutMs? (1000-300000) }. Agent-task templates and ordinary config values support {{interpolation}} from the node's inputs context, including trigger and declared upstream aliases. SECURITY: executable source for script/swarm-script nodes does not interpolate trigger.* or upstream node outputs; only input/workflow/swarm/run values are allowed in inline script source, and named swarm-script source is not workflow-interpolated. Pass dynamic values through config.args instead (inline script receives them as argv; swarm-script receives its args object). NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
           },
           "next": {
             "anyOf": [
@@ -4494,7 +4508,7 @@
                     "config": {
                       "type": "object",
                       "additionalProperties": {},
-                      "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, tags?, priority?, dir?, vcsRepo?, model? }. For script: { runtime, script, args?, timeout? }. For swarm-script: { scriptName, scope?, pinHash?, args?, fsMode?, timeoutMs? (1000-300000) }. Agent-task templates and ordinary config values support {{interpolation}} from the node's inputs context, including trigger and declared upstream aliases. SECURITY: executable source for script/swarm-script nodes does not interpolate trigger.* or upstream node outputs; only input/workflow/swarm/run values are allowed in inline script source, and named swarm-script source is not workflow-interpolated. Pass dynamic values through config.args instead (inline script receives them as argv; swarm-script receives its args object). NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
+                      "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, routingReason?, routingNote?, tags?, priority?, dir?, vcsRepo?, model? }; configured agentId defaults routingReason to human_pinned. For script: { runtime, script, args?, timeout? }. For swarm-script: { scriptName, scope?, pinHash?, args?, fsMode?, timeoutMs? (1000-300000) }. Agent-task templates and ordinary config values support {{interpolation}} from the node's inputs context, including trigger and declared upstream aliases. SECURITY: executable source for script/swarm-script nodes does not interpolate trigger.* or upstream node outputs; only input/workflow/swarm/run values are allowed in inline script source, and named swarm-script source is not workflow-interpolated. Pass dynamic values through config.args instead (inline script receives them as argv; swarm-script receives its args object). NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
                     },
                     "next": {
                       "anyOf": [
@@ -33207,6 +33221,20 @@
                   "agentId": {
                     "type": "string"
                   },
+                  "routingReason": {
+                    "type": "string",
+                    "enum": [
+                      "skill",
+                      "continuity",
+                      "overflow",
+                      "human_pinned",
+                      "reroute_fault"
+                    ]
+                  },
+                  "routingNote": {
+                    "type": "string",
+                    "maxLength": 200
+                  },
                   "tags": {
                     "type": "array",
                     "items": {
@@ -40188,6 +40216,20 @@
                   "agentId": {
                     "type": "string"
                   },
+                  "routingReason": {
+                    "type": "string",
+                    "enum": [
+                      "skill",
+                      "continuity",
+                      "overflow",
+                      "human_pinned",
+                      "reroute_fault"
+                    ]
+                  },
+                  "routingNote": {
+                    "type": "string",
+                    "maxLength": 200
+                  },
                   "taskType": {
                     "type": "string"
                   },
@@ -46726,7 +46768,7 @@
                   "config": {
                     "type": "object",
                     "additionalProperties": {},
-                    "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, tags?, priority?, dir?, vcsRepo?, model? }. For script: { runtime, script, args?, timeout? }. For swarm-script: { scriptName, scope?, pinHash?, args?, fsMode?, timeoutMs? (1000-300000) }. Agent-task templates and ordinary config values support {{interpolation}} from the node's inputs context, including trigger and declared upstream aliases. SECURITY: executable source for script/swarm-script nodes does not interpolate trigger.* or upstream node outputs; only input/workflow/swarm/run values are allowed in inline script source, and named swarm-script source is not workflow-interpolated. Pass dynamic values through config.args instead (inline script receives them as argv; swarm-script receives its args object). NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
+                    "description": "Executor-specific config. For agent-task: { template, outputSchema?, agentId?, routingReason?, routingNote?, tags?, priority?, dir?, vcsRepo?, model? }; configured agentId defaults routingReason to human_pinned. For script: { runtime, script, args?, timeout? }. For swarm-script: { scriptName, scope?, pinHash?, args?, fsMode?, timeoutMs? (1000-300000) }. Agent-task templates and ordinary config values support {{interpolation}} from the node's inputs context, including trigger and declared upstream aliases. SECURITY: executable source for script/swarm-script nodes does not interpolate trigger.* or upstream node outputs; only input/workflow/swarm/run values are allowed in inline script source, and named swarm-script source is not workflow-interpolated. Pass dynamic values through config.args instead (inline script receives them as argv; swarm-script receives its args object). NOTE: config.outputSchema on agent-task nodes validates the AGENT's raw JSON output, while node-level outputSchema validates the EXECUTOR's return value ({taskId, taskOutput})."
                   },
                   "next": {
                     "anyOf": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.147.0",
+  "version": "1.149.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",
@@ -111,6 +111,8 @@
     "prepare-release": "bun scripts/prepare-release.ts",
     "refresh:vendored-openapi": "bun scripts/refresh-vendored-openapi.ts",
     "sync-chart-version": "bun scripts/sync-chart-version.ts",
+    "sync-plugin-versions": "bun scripts/sync-plugin-versions.ts",
+    "check:plugin-versions": "bun scripts/sync-plugin-versions.ts --check",
     "bump:agent-fs": "bun scripts/bump-agent-fs.ts",
     "check-chart-version": "bun scripts/sync-chart-version.ts --check-if-package-version-changed",
     "cli": "bun src/cli.tsx",

package/src/agentmail/handlers.ts

@@ -49,6 +49,7 @@ const agentmailBuffer = createIngressBuffer<BufferedAgentMailMessage>({
     if (followupResult.skipped) return;
     const task = await createTaskWithSiblingAwareness(followupResult.text, {
       agentId: first.agentId,
+      routingReason: "continuity",
       source: "agentmail",
       taskType: "agentmail-reply",
       agentmailInboxId: first.inboxId,
@@ -249,6 +250,7 @@ export async function handleMessageReceived(
 
     const task = await createTaskWithSiblingAwareness(followupResult.text, {
       agentId: existingTask.agentId,
+      routingReason: existingTask.agentId ? "continuity" : undefined,
       source: "agentmail",
       taskType: "agentmail-reply",
       agentmailInboxId: inbox_id,
@@ -288,6 +290,7 @@ export async function handleMessageReceived(
 
         const task = await createTaskWithSiblingAwareness(leadResult.text, {
           agentId: agent.id,
+          routingReason: "human_pinned",
           source: "agentmail",
           taskType: "agentmail-message",
           agentmailInboxId: inbox_id,
@@ -318,6 +321,7 @@ export async function handleMessageReceived(
 
       const task = await createTaskWithSiblingAwareness(workerResult.text, {
         agentId: agent.id,
+        routingReason: "human_pinned",
         source: "agentmail",
         taskType: "agentmail-message",
         agentmailInboxId: inbox_id,
@@ -352,6 +356,7 @@ export async function handleMessageReceived(
 
     const task = await createTaskWithSiblingAwareness(unmappedResult.text, {
       agentId: lead.id,
+      routingReason: "skill",
       source: "agentmail",
       taskType: "agentmail-message",
       agentmailInboxId: inbox_id,

package/src/automation-preflight-alert.ts

@@ -0,0 +1,41 @@
+import type { AutomationPreflightResult } from "./be/automation-preflight";
+import { getAppUrl } from "./utils/constants";
+import { scrubSecrets } from "./utils/secret-scrubber";
+
+/** Best-effort alert; callers gate this on a newly recorded preflight refusal. */
+export async function notifyAutomationPreflightFailure(
+  preflight: AutomationPreflightResult,
+): Promise<void> {
+  const channel = process.env.SLACK_ALERTS_CHANNEL?.trim();
+  if (!channel) {
+    console.warn("[Automation Preflight] SLACK_ALERTS_CHANNEL not set; skipping alert");
+    return;
+  }
+
+  try {
+    const { getSlackApp } = await import("./slack/app");
+    const app = getSlackApp();
+    if (!app) {
+      console.warn("[Automation Preflight] Slack not available, cannot send notification");
+      return;
+    }
+    await app.client.chat.postMessage({
+      channel,
+      text: scrubSecrets(
+        `⚠️ Automation needs setup\n` +
+          `Automation: ${preflight.kind} "${preflight.name}"\n` +
+          `Missing params: ${preflight.missing.params.join(", ") || "none"}\n` +
+          `Missing integrations: ${preflight.missing.integrations.join(", ") || "none"}\n` +
+          `Fire SKIPPED. It was not retried or queued.\n` +
+          `Fix setup: ${getAppUrl()}${preflight.fixUrl}`,
+      ),
+      unfurl_links: false,
+      unfurl_media: false,
+    });
+  } catch (error) {
+    console.error(
+      "[Automation Preflight] Failed to send Slack notification:",
+      scrubSecrets(error instanceof Error ? error.message : String(error)),
+    );
+  }
+}

package/src/be/automation-preflight.ts

@@ -380,7 +380,7 @@ export async function recordWorkflowPreflightFailure(input: {
   failureReason: string;
   createdBy?: string;
   now?: Date;
-}): Promise<string> {
+}): Promise<{ runId: string; recorded: boolean }> {
   const now = input.now ?? new Date();
   const bounds = utcDayBounds(now);
   return await getDbClient().transaction(async (tx) => {
@@ -392,7 +392,7 @@ export async function recordWorkflowPreflightFailure(input: {
        ORDER BY startedAt ASC LIMIT 1`,
       [input.workflowId, bounds.start, bounds.end],
     );
-    if (existing) return existing.id;
+    if (existing) return { runId: existing.id, recorded: false };
 
     const runId = crypto.randomUUID();
     const timestamp = now.toISOString();
@@ -413,6 +413,6 @@ export async function recordWorkflowPreflightFailure(input: {
         timestamp,
       ],
     );
-    return runId;
+    return { runId, recorded: true };
   });
 }

package/src/be/budget-refusal-notify.ts

@@ -115,6 +115,7 @@ export async function emitBudgetRefusalSideEffects(
 
         const followUp = await createTaskExtended(resolved.text, {
           agentId: leadAgent.id,
+          routingReason: "skill",
           source: "system",
           taskType: "follow-up",
           parentTaskId: ctx.task.id,

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

@@ -9,6 +9,7 @@ import type {
   ProviderName,
   ReasoningEffort,
   RoutingAffinity,
+  RoutingReason,
 } from "../../../types";
 import {
   FollowUpConfigSchema,
@@ -45,6 +46,8 @@ export type AgentTaskRow = {
   title: string | null;
   status: AgentTaskStatus;
   source: AgentTaskSource;
+  routing_reason: RoutingReason | null;
+  routing_note: string | null;
   taskType: string | null;
   tags: string | null;
   priority: number;
@@ -165,6 +168,8 @@ export function rowToAgentTask(row: AgentTaskRow): AgentTask {
     title: row.title ?? undefined,
     status: row.status,
     source: row.source,
+    routingReason: row.routing_reason ?? undefined,
+    routingNote: row.routing_note ?? undefined,
     taskType: row.taskType ?? undefined,
     tags: row.tags ? JSON.parse(row.tags) : [],
     priority: row.priority ?? 50,

package/src/be/db.ts

@@ -18,6 +18,7 @@ import type {
   AgentLogEventType,
   AgentMcpServer,
   AgentSkill,
+  AgentStatus,
   AgentTask,
   AgentTaskStatus,
   AgentTaskSummary,
@@ -2051,6 +2052,103 @@ export async function findRecentSimilarTasks(opts: {
   return rows.map(rowToAgentTask);
 }
 
+type RoutingDecisionWorkerStatus = {
+  agentId: string;
+  status: AgentStatus;
+  activeTaskCount: number;
+  openTaskCount: number;
+};
+
+type RoutingDecisionCandidate = {
+  taskId: string;
+  agentId: string;
+};
+
+type RoutingDecisionSnapshot = {
+  capturedAt: string;
+  workerStatuses: RoutingDecisionWorkerStatus[];
+  continuityCandidates: {
+    samePr: RoutingDecisionCandidate | null;
+    sameThread: RoutingDecisionCandidate | null;
+    sameRepo: RoutingDecisionCandidate | null;
+  };
+};
+
+const ROUTING_HOLDER_SQL = `CASE
+  WHEN status IN ('draft', 'offered', 'reviewing') AND offeredTo IS NOT NULL THEN offeredTo
+  ELSE COALESCE(agentId, offeredTo)
+END`;
+
+async function findLatestRoutingCandidate(
+  where: string,
+  params: Array<string | number>,
+): Promise<RoutingDecisionCandidate | null> {
+  const row = await getDbClient().get<RoutingDecisionCandidate>(
+    `SELECT id AS taskId, ${ROUTING_HOLDER_SQL} AS agentId
+       FROM agent_tasks
+       WHERE ${where}
+         AND ${ROUTING_HOLDER_SQL} IN (SELECT id FROM agents WHERE isLead = 0)
+       ORDER BY createdAt DESC, rowid DESC
+       LIMIT 1`,
+    params,
+  );
+  return row ?? null;
+}
+
+async function captureRoutingDecisionSnapshot(
+  options: CreateTaskOptions,
+): Promise<RoutingDecisionSnapshot> {
+  const workerStatuses = await getDbClient().query<RoutingDecisionWorkerStatus>(
+    `SELECT agent.id AS agentId, agent.status,
+         COUNT(task.id) AS openTaskCount,
+         SUM(CASE WHEN task.status IN ('in_progress', 'reviewing') THEN 1 ELSE 0 END) AS activeTaskCount
+       FROM agents agent
+       LEFT JOIN agent_tasks task ON
+         (task.agentId = agent.id OR task.offeredTo = agent.id)
+         AND task.status NOT IN ('completed', 'failed', 'cancelled', 'superseded')
+       WHERE agent.isLead = 0
+       GROUP BY agent.id, agent.status
+       ORDER BY agent.id`,
+  );
+
+  const samePr =
+    options.vcsRepo && options.vcsNumber != null
+      ? await findLatestRoutingCandidate("vcsRepo = ? AND vcsNumber = ?", [
+          options.vcsRepo,
+          options.vcsNumber,
+        ])
+      : null;
+
+  let sameThread: RoutingDecisionCandidate | null = null;
+  if (options.slackChannelId && options.slackThreadTs) {
+    sameThread = await findLatestRoutingCandidate("slackChannelId = ? AND slackThreadTs = ?", [
+      options.slackChannelId,
+      options.slackThreadTs,
+    ]);
+  } else if (options.agentmailThreadId) {
+    sameThread = await findLatestRoutingCandidate("agentmailThreadId = ?", [
+      options.agentmailThreadId,
+    ]);
+  }
+
+  const sameRepo = options.vcsRepo
+    ? await findLatestRoutingCandidate("vcsRepo = ?", [options.vcsRepo])
+    : null;
+
+  return {
+    capturedAt: new Date().toISOString(),
+    workerStatuses,
+    continuityCandidates: { samePr, sameThread, sameRepo },
+  };
+}
+
+function logRoutingDecisionFailure(taskId: string, stage: "capture" | "write", error: unknown) {
+  console.warn(
+    `[routing-decision] Failed to ${stage} snapshot for task ${taskId}:`,
+    scrubSecrets(error instanceof Error ? error.message : String(error)),
+  );
+}
+
 export async function createTaskExtended(
   task: string,
   options?: CreateTaskOptions,
@@ -2417,9 +2515,16 @@ export async function createTaskExtended(
       : await findExistingLinearTrackerContextWork(options?.contextKey);
     if (existingTrackerWork) return { existing: existingTrackerWork };
 
+    let routingDecisionSnapshot: RoutingDecisionSnapshot | null = null;
+    try {
+      routingDecisionSnapshot = await captureRoutingDecisionSnapshot(options);
+    } catch (error) {
+      logRoutingDecisionFailure(id, "capture", error);
+    }
+
     const inserted = await getDbClient().get<AgentTaskRow>(
       `INSERT INTO agent_tasks (
-        id, "key", agentId, creatorAgentId, task, status, source,
+        id, "key", agentId, creatorAgentId, task, status, source, routing_reason, routing_note,
         taskType, tags, priority, dependsOn, offeredTo, offeredAt,
         slackChannelId, slackThreadTs, slackTriggerMessageTs, slackUserId,
         vcsProvider, vcsRepo, vcsEventType, vcsNumber, vcsCommentId, vcsAuthor, vcsUrl,
@@ -2427,7 +2532,7 @@ export async function createTaskExtended(
         agentmailInboxId, agentmailMessageId, agentmailThreadId,
         mentionMessageId, mentionChannelId, dir, parentTaskId, model, modelTier, effort, scheduleId,
         workflowRunId, workflowRunStepId, outputSchema, followUpConfig, requestedByUserId, requestedByUserIdInherited, contextKey, routingAffinity, swarmVersion, createdAt, lastUpdatedAt, created_by, updated_by
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`,
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`,
       [
         id,
         assetKey,
@@ -2436,6 +2541,8 @@ export async function createTaskExtended(
         task,
         status,
         options?.source ?? "mcp",
+        options?.routingReason ?? null,
+        options?.routingNote ?? null,
         options?.taskType ?? null,
         JSON.stringify(options?.tags ?? []),
         options?.priority ?? 50,
@@ -2482,6 +2589,28 @@ export async function createTaskExtended(
       ],
     );
     if (!inserted) throw new Error("Failed to create task");
+
+    if (routingDecisionSnapshot) {
+      try {
+        await getDbClient().run(
+          `INSERT INTO routing_decisions (
+             task_id, selected_agent_id, captured_at, worker_statuses,
+             continuity_candidates, created_by, updated_by
+           ) VALUES (?, ?, ?, ?, ?, ?, ?)`,
+          [
+            id,
+            options.offeredTo ?? options.agentId ?? null,
+            routingDecisionSnapshot.capturedAt,
+            JSON.stringify(routingDecisionSnapshot.workerStatuses),
+            JSON.stringify(routingDecisionSnapshot.continuityCandidates),
+            auditUserId,
+            auditUserId,
+          ],
+        );
+      } catch (error) {
+        logRoutingDecisionFailure(id, "write", error);
+      }
+    }
     return { row: inserted };
   });
 
@@ -3520,6 +3649,7 @@ export async function postMessage(
 
       const task = await createTaskExtended(taskDescription, {
         agentId: mentionedAgentId, // Direct assignment
+        routingReason: "human_pinned",
         creatorAgentId: agentId ?? undefined,
         source: "mcp",
         taskType: "task",

package/src/be/migrations/150_deferred_task_waits.sql

@@ -0,0 +1,18 @@
+-- Task deferrals retain their one-time schedule as the deadline. This sibling
+-- to workflow wait_states arbitrates event/deadline dispatch without inventing
+-- a workflow run or step for an ordinary task.
+CREATE TABLE IF NOT EXISTS deferred_task_waits (
+  scheduleId TEXT PRIMARY KEY REFERENCES scheduled_tasks(id) ON DELETE CASCADE,
+  taskId TEXT NOT NULL,
+  eventName TEXT NOT NULL CHECK (eventName IN ('task.completed', 'task.failed', 'settled')),
+  status TEXT NOT NULL DEFAULT 'pending' CHECK (status IN ('pending', 'fired')),
+  firedBy TEXT,
+  childTaskId TEXT,
+  resolvedAt TEXT,
+  created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  created_by TEXT,
+  updated_by TEXT
+);
+CREATE INDEX IF NOT EXISTS idx_deferred_task_waits_pending
+  ON deferred_task_waits(taskId) WHERE status = 'pending';

package/src/be/migrations/151_repair_scheduled_task_required_params.sql

@@ -0,0 +1,39 @@
+-- Migration 141 added requirements by canonical name even when an existing
+-- schedule already contained concrete values instead of template placeholders.
+-- Restore its unbound timezone first so TIMEZONE is pruned in the same pass
+-- unless the task body still references it. Keep operator-supplied bindings.
+UPDATE scheduled_tasks
+SET timezone = 'UTC'
+WHERE name = 'weekly-dependabot-triage'
+  AND timezone = '{{TIMEZONE}}'
+  AND json_extract(params, '$.TIMEZONE') IS NULL;
+
+-- Only remove requirements that the row does not consume. Scope this repair to
+-- the names backfilled by 141; leave custom schedules and integration gates alone.
+-- The EXISTS guard also leaves already-correct JSON byte-for-byte unchanged.
+UPDATE scheduled_tasks
+SET requiredParams = (
+  SELECT json_group_array(value)
+  FROM json_each(scheduled_tasks.requiredParams)
+  WHERE instr(COALESCE(scheduled_tasks.taskTemplate, ''), '{{' || value || '}}') > 0
+     OR instr(COALESCE(scheduled_tasks.timezone, ''), '{{' || value || '}}') > 0
+)
+WHERE name IN (
+  'daily-blocker-digest',
+  'daily-compounding-reflection',
+  'daily-status-report',
+  'daily-workflow-health-audit',
+  'weekly-harness-upgrade-check',
+  'weekly-dependabot-triage',
+  'weekly-code-health-reports',
+  'weekly-dora-metrics',
+  'daily-hn-briefing',
+  'gtm-weekly-review',
+  'dream-daily'
+)
+AND EXISTS (
+  SELECT 1
+  FROM json_each(scheduled_tasks.requiredParams)
+  WHERE instr(COALESCE(scheduled_tasks.taskTemplate, ''), '{{' || value || '}}') = 0
+    AND instr(COALESCE(scheduled_tasks.timezone, ''), '{{' || value || '}}') = 0
+);