@desplega.ai/agent-swarm 1.149.0 → 1.150.0

package/dist/{cli-yb9qhqam.js → cli-3mh119qv.js}

@@ -3,26 +3,50 @@ import {
   composioArgsFromParts,
   executeComposioRequest
 } from "./cli-0z2v4nhw.js";
+import {
+  AGENT_MAX_TASKS_CONFIG_KEY,
+  createTrackerAgentMapping,
+  createTrackerSync,
+  createTrackerSyncIfAbsent,
+  createWorkerTaskFollowUp,
+  deleteTrackerSync,
+  getAllTrackerSyncs,
+  getTrackerSync,
+  getTrackerSyncByExternalId,
+  hasTrackerDelivery,
+  markRuntimeInstanceOffline,
+  markTrackerDelivery,
+  reconcileAgentStatusFromRuntimes,
+  repointTrackerSyncBySwarmId,
+  resetAgentMaxTasksMirror,
+  touchRuntimeInstance,
+  updateTrackerSync,
+  updateTrackerSyncSwarmId,
+  upsertSwarmConfigWithPolicyMirror
+} from "./cli-xjb9wghj.js";
 import {
   LlmRater,
   REFERENCES_SOURCE_MAX_LENGTH,
   sanitizeReferencesSource
 } from "./cli-xvkmedgn.js";
+import {
+  isMultiRuntimeEnabled
+} from "./cli-07jd68a1.js";
 import {
   calculateNextRun,
   reconcileDeferredTaskWaits,
   runScheduleNow
-} from "./cli-ygweqcn4.js";
+} from "./cli-rwp3ksm7.js";
 import {
   startPricingRefreshLoop
-} from "./cli-sd5pv3b1.js";
+} from "./cli-h505yhex.js";
 import {
   seedPricingFromModelsDev
-} from "./cli-9fy6nk6g.js";
+} from "./cli-ceb5y160.js";
 import {
   ensureRbacSeedsSynced,
   getUserGrant
-} from "./cli-k0cr4kat.js";
+} from "./cli-ck1vqzdj.js";
 import {
   can,
   decideAdmission,
@@ -49,34 +73,10 @@ import {
   runSavedScriptAsAgent,
   updateApp,
   upgradeAppDefinition
-} from "./cli-19f354qr.js";
+} from "./cli-q04q68be.js";
 import {
   require_dist as require_dist2
 } from "./cli-qgm2pfpq.js";
-import {
-  AGENT_MAX_TASKS_CONFIG_KEY,
-  createTrackerAgentMapping,
-  createTrackerSync,
-  createTrackerSyncIfAbsent,
-  createWorkerTaskFollowUp,
-  deleteTrackerSync,
-  getAllTrackerSyncs,
-  getTrackerSync,
-  getTrackerSyncByExternalId,
-  hasTrackerDelivery,
-  markRuntimeInstanceOffline,
-  markTrackerDelivery,
-  reconcileAgentStatusFromRuntimes,
-  repointTrackerSyncBySwarmId,
-  resetAgentMaxTasksMirror,
-  touchRuntimeInstance,
-  updateTrackerSync,
-  updateTrackerSyncSwarmId,
-  upsertSwarmConfigWithPolicyMirror
-} from "./cli-mnmsfd1w.js";
-import {
-  isMultiRuntimeEnabled
-} from "./cli-07jd68a1.js";
 import {
   TriggerSchemaError,
   cancelWorkflowRun,
@@ -87,7 +87,7 @@ import {
   snapshotWorkflow,
   startWorkflowExecution,
   validateJsonSchema
-} from "./cli-6pqcb4q0.js";
+} from "./cli-rnsr8asm.js";
 import {
   ConnectionAuthInputSchema,
   SCRIPT_LONG_TIMEOUT_HINT_MS,
@@ -110,7 +110,7 @@ import {
   upsertCredentialBinding,
   upsertScriptConnection,
   validateDefinition
-} from "./cli-aae6hz6a.js";
+} from "./cli-zd21jrrc.js";
 import {
   CANDIDATE_SET_MULTIPLIER,
   computeScore,
@@ -122,7 +122,7 @@ import {
   isGraphExpansionEnabled,
   rerank,
   rowToCandidate
-} from "./cli-3q5ejx9p.js";
+} from "./cli-7kwmt3r5.js";
 import {
   getApiKey
 } from "./cli-f14fvzag.js";
@@ -140,7 +140,7 @@ import {
   listAuthorizationsForApp,
   onAuthorizationRefreshed,
   upsertOAuthApp
-} from "./cli-9hspd3dp.js";
+} from "./cli-vr6qj104.js";
 import {
   ZodFirstPartyTypeKind,
   objectType
@@ -159,7 +159,7 @@ import {
   getFileInfo,
   parseSlackTs,
   uploadFile
-} from "./cli-kgz4np97.js";
+} from "./cli-b8x19vbh.js";
 import {
   AgentFsProvider
 } from "./cli-jsp14b6c.js";
@@ -179,10 +179,10 @@ import {
   resolveIdentityByEmail,
   resolveUserByToken,
   unlinkIdentity
-} from "./cli-gv88e1vf.js";
+} from "./cli-ydk0wjj8.js";
 import {
   createTaskWithSiblingAwareness
-} from "./cli-q50ef8g0.js";
+} from "./cli-n1yj5fd5.js";
 import {
   ensure,
   getAgentDisplayName,
@@ -193,7 +193,7 @@ import {
   startSlackApp,
   stopSlackApp,
   withSpan
-} from "./cli-d8ftsp62.js";
+} from "./cli-kt7wevqh.js";
 import {
   $OpenAPIRegistry,
   $OpenApiGeneratorV31,
@@ -442,13 +442,13 @@ import {
   upsertPromptTemplate,
   upsertService,
   validateConfigValue
-} from "./cli-yab68w40.js";
+} from "./cli-qp69dd5d.js";
 import {
   generateDefaultClaudeMd,
   generateDefaultIdentityMd,
   generateDefaultSoulMd,
   init_defaults
-} from "./cli-08b07b4r.js";
+} from "./cli-hmyynq9b.js";
 import {
   getTemplateDefinition,
   init_registry,
@@ -457,14 +457,14 @@ import {
   interpolate,
   registerTemplate,
   resolveTemplate
-} from "./cli-3apbzgyk.js";
+} from "./cli-n75jt793.js";
 import {
   MAX_PROFILE_FILE_LENGTH,
   getAppUrl,
   getMcpBaseUrl,
   getPublicMcpBaseUrl,
   init_constants
-} from "./cli-e29gmdmw.js";
+} from "./cli-dv6cdjs2.js";
 import {
   init_env_flag,
   isEnvFlagEnabled,
@@ -518,7 +518,7 @@ import {
 import {
   init_package,
   package_default
-} from "./cli-kjwt6hdf.js";
+} from "./cli-gm0fhz13.js";
 import {
   init_secret_scrubber,
   refreshSecretScrubberCache,
@@ -19310,6 +19310,7 @@ ${combinedPreview}`
     const task = await createTaskWithSiblingAwareness(followupResult.text, {
       agentId: first.agentId,
       routingReason: "continuity",
+      routingSource: "engine_default",
       source: "agentmail",
       taskType: "agentmail-reply",
       agentmailInboxId: first.inboxId,
@@ -19437,6 +19438,7 @@ async function handleMessageReceived(payload) {
     const task2 = await createTaskWithSiblingAwareness(followupResult.text, {
       agentId: existingTask.agentId,
       routingReason: existingTask.agentId ? "continuity" : undefined,
+      routingSource: existingTask.agentId ? "engine_default" : undefined,
       source: "agentmail",
       taskType: "agentmail-reply",
       agentmailInboxId: inbox_id,
@@ -19468,6 +19470,7 @@ async function handleMessageReceived(payload) {
         const task3 = await createTaskWithSiblingAwareness(leadResult.text, {
           agentId: agent.id,
           routingReason: "human_pinned",
+          routingSource: "engine_default",
           source: "agentmail",
           taskType: "agentmail-message",
           agentmailInboxId: inbox_id,
@@ -19492,6 +19495,7 @@ async function handleMessageReceived(payload) {
       const task2 = await createTaskWithSiblingAwareness(workerResult.text, {
         agentId: agent.id,
         routingReason: "human_pinned",
+        routingSource: "engine_default",
         source: "agentmail",
         taskType: "agentmail-message",
         agentmailInboxId: inbox_id,
@@ -19520,6 +19524,7 @@ async function handleMessageReceived(payload) {
     const task2 = await createTaskWithSiblingAwareness(unmappedResult.text, {
       agentId: lead.id,
       routingReason: "skill",
+      routingSource: "engine_default",
       source: "agentmail",
       taskType: "agentmail-message",
       agentmailInboxId: inbox_id,
@@ -20328,6 +20333,7 @@ async function handlePullRequest(event) {
     const task2 = await createTaskWithSiblingAwareness(result2.text, {
       agentId: lead2?.id ?? "",
       routingReason: lead2 ? "skill" : undefined,
+      routingSource: lead2 ? "engine_default" : undefined,
       source: "github",
       vcsProvider: "github",
       taskType: "github-pr",
@@ -20401,6 +20407,7 @@ async function handlePullRequest(event) {
     const task2 = await createTaskWithSiblingAwareness(result2.text, {
       agentId: lead2?.id ?? "",
       routingReason: lead2 ? "skill" : undefined,
+      routingSource: lead2 ? "engine_default" : undefined,
       source: "github",
       vcsProvider: "github",
       taskType: "github-pr",
@@ -20470,6 +20477,7 @@ async function handlePullRequest(event) {
     const task2 = await createTaskWithSiblingAwareness(result2.text, {
       agentId: lead2?.id ?? "",
       routingReason: lead2 ? "skill" : undefined,
+      routingSource: lead2 ? "engine_default" : undefined,
       source: "github",
       vcsProvider: "github",
       taskType: "github-pr",
@@ -20529,6 +20537,7 @@ async function handlePullRequest(event) {
   const task = await createTaskWithSiblingAwareness(result.text, {
     agentId: lead?.id ?? "",
     routingReason: lead ? "skill" : undefined,
+    routingSource: lead ? "engine_default" : undefined,
     source: "github",
     vcsProvider: "github",
     taskType: "github-pr",
@@ -20578,6 +20587,7 @@ async function handleIssue(event) {
     const task2 = await createTaskWithSiblingAwareness(result2.text, {
       agentId: lead2?.id ?? "",
       routingReason: lead2 ? "skill" : undefined,
+      routingSource: lead2 ? "engine_default" : undefined,
       source: "github",
       vcsProvider: "github",
       taskType: "github-issue",
@@ -20645,6 +20655,7 @@ async function handleIssue(event) {
     const task2 = await createTaskWithSiblingAwareness(result2.text, {
       agentId: lead2?.id ?? "",
       routingReason: lead2 ? "skill" : undefined,
+      routingSource: lead2 ? "engine_default" : undefined,
       source: "github",
       vcsProvider: "github",
       taskType: "github-issue",
@@ -20694,6 +20705,7 @@ async function handleIssue(event) {
   const task = await createTaskWithSiblingAwareness(result.text, {
     agentId: lead?.id ?? "",
     routingReason: lead ? "skill" : undefined,
+    routingSource: lead ? "engine_default" : undefined,
     source: "github",
     vcsProvider: "github",
     taskType: "github-issue",
@@ -20758,6 +20770,7 @@ async function handleComment(event, eventType) {
   const task = await createTaskWithSiblingAwareness(result.text, {
     agentId: lead?.id ?? "",
     routingReason: lead ? "skill" : undefined,
+    routingSource: lead ? "engine_default" : undefined,
     source: "github",
     vcsProvider: "github",
     taskType: "github-comment",
@@ -20958,6 +20971,7 @@ ${review.body}` : "";
   const task = await createTaskWithSiblingAwareness(result.text, {
     agentId: lead?.id ?? "",
     routingReason: lead ? "skill" : undefined,
+    routingSource: lead ? "engine_default" : undefined,
     source: "github",
     vcsProvider: "github",
     taskType: "github-review",
@@ -21305,6 +21319,7 @@ async function handleMergeRequest(event) {
       const task = await createTaskWithSiblingAwareness(result.text, {
         agentId: lead?.id ?? null,
         routingReason: lead ? "skill" : undefined,
+        routingSource: lead ? "engine_default" : undefined,
         source: "gitlab",
         vcsProvider: "gitlab",
         taskType: "gitlab-mr",
@@ -21388,6 +21403,7 @@ async function handleIssue2(event) {
       const task = await createTaskWithSiblingAwareness(result.text, {
         agentId: lead?.id ?? null,
         routingReason: lead ? "skill" : undefined,
+        routingSource: lead ? "engine_default" : undefined,
         source: "gitlab",
         vcsProvider: "gitlab",
         taskType: "gitlab-issue",
@@ -21471,6 +21487,7 @@ _Note: There's an active task (${existingTask.id}) for this ${entityLabel}._` :
   const task = await createTaskWithSiblingAwareness(noteResult.text, {
     agentId: lead?.id ?? null,
     routingReason: lead ? "skill" : undefined,
+    routingSource: lead ? "engine_default" : undefined,
     source: "gitlab",
     vcsProvider: "gitlab",
     taskType: "gitlab-comment",
@@ -21528,6 +21545,7 @@ async function handlePipeline(event) {
   const task = await createTaskWithSiblingAwareness(pipelineResult.text, {
     agentId: lead?.id ?? null,
     routingReason: lead ? "skill" : undefined,
+    routingSource: lead ? "engine_default" : undefined,
     source: "gitlab",
     vcsProvider: "gitlab",
     taskType: "gitlab-ci",
@@ -22257,6 +22275,7 @@ ${input.descriptionText}
   const task = await createTaskWithSiblingAwareness(result.text, {
     agentId: lead?.id ?? "",
     routingReason: lead ? "skill" : undefined,
+    routingSource: lead ? "engine_default" : undefined,
     source: "jira",
     taskType: "jira-issue",
     requestedByUserId: input.requestedByUserId,
@@ -22287,6 +22306,7 @@ ${input.descriptionText}
   const task = await createTaskWithSiblingAwareness(result.text, {
     agentId: lead?.id ?? "",
     routingReason: lead ? "skill" : undefined,
+    routingSource: lead ? "engine_default" : undefined,
     source: "jira",
     taskType: "jira-issue",
     requestedByUserId: input.requestedByUserId,
@@ -22326,7 +22346,7 @@ async function notifySlack(text) {
     return;
   }
   try {
-    const { getSlackApp: getSlackApp2 } = await import("./app-1hh67x8w.js");
+    const { getSlackApp: getSlackApp2 } = await import("./app-dty7p9hg.js");
     const app = getSlackApp2();
     if (!app) {
       console.warn("[Jira webhook keepalive] Slack not available, cannot send notification");
@@ -22397,7 +22417,7 @@ async function deleteJiraWebhook(webhookId) {
   console.log(`[Jira webhook keepalive] Deleted webhook id=${webhookId}`);
 }
 async function overwriteWebhookIds(next) {
-  const { getDbClient: getDbClient2 } = await import("./db-ggz97zbm.js");
+  const { getDbClient: getDbClient2 } = await import("./db-jxjx6s1b.js");
   await getDbClient2().transaction(async (tx) => {
     const row = await tx.get("SELECT metadata FROM oauth_apps WHERE provider = 'jira'");
     if (!row) {
@@ -94581,6 +94601,7 @@ ${issueDescription}
   const task = await createTaskWithSiblingAwareness(templateResult.text, {
     agentId: lead?.id ?? "",
     routingReason: lead ? "skill" : undefined,
+    routingSource: lead ? "engine_default" : undefined,
     source: "linear",
     taskType: "linear-issue",
     requestedByUserId,
@@ -94775,6 +94796,7 @@ async function handleAgentSessionPrompted(event) {
   const task = await createTaskWithSiblingAwareness(followupResult.text, {
     agentId: lead?.id ?? "",
     routingReason: lead ? "skill" : undefined,
+    routingSource: lead ? "engine_default" : undefined,
     source: "linear",
     taskType: "linear-issue",
     requestedByUserId: promptedRequestedByUserId,
@@ -99991,6 +100013,7 @@ async function handleApps(req, res, pathSegments, queryParams, myAgentId) {
       source: "api",
       agentId: action.agentId ?? lead?.id,
       routingReason: action.agentId ? "human_pinned" : lead ? "skill" : undefined,
+      routingSource: action.agentId || lead ? "engine_default" : undefined,
       key: normalizeAssetKey(`shared/app:${app.id}/action:${parsed.params.name}/`),
       ...actor.startsWith("user:") ? { requestedByUserId: actor.slice("user:".length) } : {}
     });
@@ -103191,6 +103214,7 @@ async function guardTerminalTaskResultWrite(task, write) {
 
 // src/tools/defer-task.ts
 init_types();
+init_constants();
 
 class DeferAbortedError extends Error {
 }
@@ -103203,19 +103227,90 @@ Checks:
 ${checks2.map((c) => `- ${c}`).join(`
 `)}`;
 }
+function partsInTz(date2, tz) {
+  const fmt = new Intl.DateTimeFormat("en-US", {
+    timeZone: tz,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: false
+  });
+  const parts = Object.fromEntries(fmt.formatToParts(date2).map((p) => [p.type, p.value]));
+  const hour = parts.hour === "24" ? "00" : parts.hour;
+  return {
+    year: parts.year,
+    month: parts.month,
+    day: parts.day,
+    hour,
+    minute: parts.minute,
+    second: parts.second
+  };
+}
+function formatDeferralDateTime(target, now, tz) {
+  let zone = tz;
+  try {
+    Intl.DateTimeFormat("en-US", { timeZone: zone });
+  } catch {
+    zone = "UTC";
+  }
+  const t = partsInTz(target, zone);
+  const time = `${t.hour}:${t.minute}:${t.second}`;
+  const n = partsInTz(now, zone);
+  if (t.year === n.year && t.month === n.month && t.day === n.day)
+    return { date: "today", time };
+  const tm = partsInTz(new Date(now.getTime() + 86400000), zone);
+  if (t.year === tm.year && t.month === tm.month && t.day === tm.day) {
+    return { date: "tomorrow", time };
+  }
+  return { date: `${t.month}-${t.day}`, time };
+}
+async function resolveRequesterTimezone(requestedByUserId) {
+  if (requestedByUserId) {
+    const user = await getUserById(requestedByUserId);
+    if (user?.timezone)
+      return { tz: user.timezone, isFallback: false };
+  }
+  return { tz: "UTC", isFallback: true };
+}
+function renderShortDesc(note, max = 100) {
+  const firstLine = (note.split(`
+`)[0] ?? "").trim().replace(/^pending:\s*/i, "");
+  if (firstLine.length <= max)
+    return firstLine;
+  return `${firstLine.slice(0, max - 1).trimEnd()}…`;
+}
+function renderHumanFacingDeferral(note, nextRunAt, scheduleId, tz, isFallbackTz) {
+  const now = new Date;
+  const target = new Date(nextRunAt);
+  const { date: date2, time } = formatDeferralDateTime(target, now, tz);
+  const timeLabel = isFallbackTz ? `${time} UTC` : time;
+  const shortId = scheduleId.slice(0, 8);
+  const link = `[${shortId}](${getAppUrl()}/schedules/${scheduleId})`;
+  const shortDesc = renderShortDesc(note);
+  return `Deferred until ${date2} ${timeLabel} (${link}) -> ${shortDesc}`;
+}
 var registerDeferTaskTool = (server) => {
   createToolRegistrar(server)("defer-task", {
     title: "Defer Task",
     annotations: { destructiveHint: false, idempotentHint: false },
-    description: "Completes this task now with status `completed` and books a wake-up for you. Use when the result needs time: a build, a deploy, a reply. The task reaches its final state on this call; the lead sees your summary as its output unless the task has an outputSchema. For a task with an outputSchema, provide output as a JSON string matching that schema; it is stored verbatim as terminal output, while deferral details remain visible in the task log. A one-off schedule wakes you up later with a child task that carries this task as its parent. Optionally provide wakeOn to wake early when another task completes or fails; delayMs or runAt remains required as the ceiling. Provide delayMs or runAt, a summary of what you did, and a note that says what is pending and what to check.",
+    description: "Completes this task now with status `completed` and books a wake-up for you. Use when the result needs time: a build, a deploy, a reply. The task reaches its final state on this call; the lead sees your summary as its output unless the task has an outputSchema. For a task with an outputSchema, provide output as a JSON string matching that schema; it is stored verbatim as terminal output, while deferral details remain visible in the task log. A one-off schedule wakes you up later with a child task that carries this task as its parent. Optionally provide wakeOn with taskId or taskIds to wake early on task outcomes; mode defaults to all, or use any for the first match. delayMs or runAt remains required as the ceiling for the whole set. Provide delayMs or runAt, a summary of what you did, and a note that says what is pending and what to check.",
     inputSchema: object({
       taskId: string().describe("The ID of the task you are working on."),
       delayMs: number().int().positive().optional().describe("Wake up after this many milliseconds (e.g. 1800000 for 30 min)."),
       runAt: string().datetime().optional().describe("Wake up at this ISO datetime (e.g. '2026-03-06T15:00:00Z'). Must be future."),
       wakeOn: object({
         event: _enum(["task.completed", "task.failed", "settled"]),
-        taskId: string().min(1)
-      }).strict().optional().describe("Wake early on this task event. settled covers completed or failed. Already-terminal tasks are rejected; a delayMs/runAt ceiling is still required."),
+        taskId: string().min(1).optional(),
+        taskIds: array(string().min(1)).min(1).optional(),
+        mode: _enum(["all", "any"]).optional()
+      }).strict().refine((wake) => wake.taskId !== undefined !== (wake.taskIds !== undefined), {
+        message: "Provide exactly one of wakeOn.taskId or wakeOn.taskIds."
+      }).refine((wake) => !wake.taskIds || new Set(wake.taskIds).size === wake.taskIds.length, {
+        message: "wakeOn.taskIds must not contain duplicates."
+      }).optional().describe("Wake early on a task event. Provide taskId or nonempty, unique taskIds. mode defaults to all (every member must match); any wakes on the first match. settled covers completed or failed. Deferred members follow their continuations. Any already-terminal member rejects the request; one delayMs/runAt ceiling is still required for the whole set."),
       summary: string().min(1).max(4000).describe("What you did so far and where things stand. Stored in the task log for tasks with an outputSchema; otherwise becomes the task's output."),
       output: string().optional().describe("Required when the task has an outputSchema: a JSON string matching that schema, stored verbatim as terminal output. Ignored for tasks without an outputSchema."),
       note: string().min(1).max(2000).describe("What is pending, and what to check on wake-up."),
@@ -103261,7 +103356,9 @@ var registerDeferTaskTool = (server) => {
       return toolErr("runAt must be in the future.");
     }
     const nextRunAt = delayMs ? new Date(Date.now() + delayMs).toISOString() : runAt;
-    const wakeDescription = wakeOn ? `on ${wakeOn.event} for task ${wakeOn.taskId}, or by ${nextRunAt}` : `at ${nextRunAt}`;
+    const watchedTaskIds = wakeOn?.taskIds ?? (wakeOn?.taskId ? [wakeOn.taskId] : []);
+    const wakeMode = wakeOn?.mode ?? "all";
+    const wakeDescription = wakeOn ? `on ${wakeOn.event} for ${wakeMode} of tasks ${watchedTaskIds.join(", ")}, or by ${nextRunAt}` : `at ${nextRunAt}`;
     const checksBlock = renderChecks(checks2);
     const taskTemplate = `Resume task ${taskId}: ${note}${checksBlock}`;
     const createdBy = await resolveTaskAuditUserId(requestInfo.sourceTaskId, requestInfo.agentId) ?? undefined;
@@ -103273,16 +103370,17 @@ var registerDeferTaskTool = (server) => {
       if (outputValidationError)
         return toolErr(outputValidationError);
     }
+    const { tz: requesterTz, isFallback: isFallbackTz } = await resolveRequesterTimezone(task.requestedByUserId);
     try {
       const committed = await getDbClient().transaction(async () => {
-        if (wakeOn) {
-          if (wakeOn.taskId === taskId)
+        for (const watchedId of watchedTaskIds) {
+          if (watchedId === taskId)
             throw new DeferAbortedError("Cannot wake on the task being deferred.");
-          const watched = await getTaskById(wakeOn.taskId);
+          const watched = await getTaskById(watchedId);
           if (!watched)
-            throw new DeferAbortedError(`Watched task ${wakeOn.taskId} not found.`);
+            throw new DeferAbortedError(`Watched task ${watchedId} not found.`);
           if (isTerminalTaskStatus(watched.status))
-            throw new DeferAbortedError(`Watched task ${wakeOn.taskId} is already ${watched.status}; read its result instead of deferring.`);
+            throw new DeferAbortedError(`Watched task ${watchedId} is already ${watched.status}; read its result instead of deferring.`);
         }
         const schedule = await createScheduledTask({
           name: `deferred-${taskId.slice(0, 8)}-${Date.now()}-${crypto.randomUUID()}`,
@@ -103301,9 +103399,12 @@ var registerDeferTaskTool = (server) => {
           createdBy
         });
         if (wakeOn) {
-          await getDbClient().run("INSERT INTO deferred_task_waits (scheduleId, taskId, eventName, created_by, updated_by) VALUES (?, ?, ?, ?, ?)", [schedule.id, wakeOn.taskId, wakeOn.event, createdBy ?? null, createdBy ?? null]);
+          await getDbClient().run("INSERT INTO deferred_task_waits (scheduleId, eventName, mode, created_by, updated_by) VALUES (?, ?, ?, ?, ?)", [schedule.id, wakeOn.event, wakeMode, createdBy ?? null, createdBy ?? null]);
+          for (const watchedId of watchedTaskIds) {
+            await getDbClient().run("INSERT INTO deferred_task_wait_members (scheduleId, taskId, created_by, updated_by) VALUES (?, ?, ?, ?)", [schedule.id, watchedId, createdBy ?? null, createdBy ?? null]);
+          }
           getDbClient().afterCommit(() => {
-            reconcileDeferredTaskWaits(wakeOn.taskId).catch((err) => {
+            Promise.all(watchedTaskIds.map((id) => reconcileDeferredTaskWaits(id))).catch((err) => {
               console.error("[defer-task] Event wake reconciliation failed:", err);
             });
           });
@@ -103311,19 +103412,19 @@ var registerDeferTaskTool = (server) => {
         const deferralDetails = `${summary}
 
 Deferred until ${nextRunAt} (schedule ${schedule.id}). Pending: ${note}${checksBlock}`;
-        const terminalOutput = task.outputSchema ? output : deferralDetails;
-        const completed = await completeTask(taskId, terminalOutput);
+        const terminalOutput = task.outputSchema ? output : renderHumanFacingDeferral(note, nextRunAt, schedule.id, requesterTz, isFallbackTz);
+        const completed = await completeTask(taskId, terminalOutput, {
+          addTags: ["deferred"]
+        });
         if (!completed) {
           throw new DeferAbortedError(`Task ${taskId} reached a terminal state before this deferral committed.`);
         }
-        if (task.outputSchema) {
-          await createLogEntry({
-            eventType: "task_progress",
-            taskId,
-            agentId: requestInfo.agentId,
-            newValue: deferralDetails
-          });
-        }
+        await createLogEntry({
+          eventType: "task_progress",
+          taskId,
+          agentId: requestInfo.agentId,
+          newValue: deferralDetails
+        });
         getDbClient().afterCommit(() => {
           ensure({
             id: "completed",
@@ -116271,7 +116372,7 @@ function checkOutputSchemaShape(outputSchema, ctx) {
 var sendTaskInputSchema = object({
   agentId: string().optional().describe("The agent to assign/offer task to. Omit to create unassigned task for pool."),
   routingReason: RoutingReasonSchema.optional().describe("Why this agent was selected. Required when agentId is supplied; omit for pool routing."),
-  routingNote: string().max(200).optional().describe("Optional routing context (maximum 200 characters)."),
+  routingNote: string().max(200).optional().describe("Why this worker fits the task. Required when agentId is supplied: at least 10 characters after trimming whitespace, maximum 200 characters. Optional for implicit parent or pool routing."),
   task: string().min(1).describe("The task description to send."),
   key: AssetKeySchema.optional().describe("Logical namespace key. Child tasks inherit their parent namespace when provided."),
   offerMode: boolean().default(false).describe("If true, offer the task instead of direct assign (agent must accept/reject)."),
@@ -116312,6 +116413,13 @@ var sendTaskInputSchema = object({
       path: ["routingReason"]
     });
   }
+  if (data.agentId !== undefined && (data.routingNote?.trim().length ?? 0) < 10) {
+    ctx.addIssue({
+      code: ZodIssueCode.custom,
+      message: "routingNote is required when agentId is supplied (at least 10 characters after trim).",
+      path: ["routingNote"]
+    });
+  }
   checkOutputSchemaShape(data.outputSchema, ctx);
 });
 var sendTaskOutputSchema = swarmToolOutputSchema({
@@ -116366,6 +116474,9 @@ async function sendTaskHandler(ctx, {
   if (agentId !== undefined && routingReason === undefined) {
     return toolErr("routingReason is required when agentId is supplied.");
   }
+  if (agentId !== undefined && (routingNote?.trim().length ?? 0) < 10) {
+    return toolErr("routingNote is required when agentId is supplied (at least 10 characters after trim).");
+  }
   if (ctx.kind === "owner" && !ctx.agentId) {
     return toolErr('Agent ID not found. The MCP client should define the "X-Agent-ID" header.', {
       data: { yourAgentId: ctx.agentId }
@@ -116425,6 +116536,7 @@ async function sendTaskHandler(ctx, {
   }
   const effectiveRoutingReason = agentId !== undefined ? routingReason : effectiveAgentId ? "continuity" : undefined;
   const effectiveRoutingNote = effectiveRoutingReason ? routingNote : undefined;
+  const effectiveRoutingSource = agentId !== undefined ? "declared" : effectiveAgentId ? "engine_default" : undefined;
   const evaluateDedupGuards = async () => {
     const existingTrackerWork = await findExistingLinearTrackerContextWork(effectiveParentTask?.contextKey);
     if (existingTrackerWork) {
@@ -116499,6 +116611,7 @@ async function sendTaskHandler(ctx, {
         followUpConfig,
         outputSchema,
         routingReason: effectiveRoutingReason,
+        routingSource: effectiveRoutingSource,
         routingNote: effectiveRoutingNote,
         routingAffinity: effectiveLeadOnly || requiredCapabilities?.length ? { leadOnly: effectiveLeadOnly, capabilities: requiredCapabilities ?? [] } : undefined
       });
@@ -116557,6 +116670,7 @@ async function sendTaskHandler(ctx, {
         followUpConfig,
         outputSchema,
         routingReason: effectiveRoutingReason,
+        routingSource: effectiveRoutingSource,
         routingNote: effectiveRoutingNote,
         routingAffinity: effectiveLeadOnly || requiredCapabilities?.length ? { leadOnly: effectiveLeadOnly, capabilities: requiredCapabilities ?? [] } : undefined
       });
@@ -116594,6 +116708,7 @@ async function sendTaskHandler(ctx, {
       followUpConfig,
       outputSchema,
       routingReason: effectiveRoutingReason,
+      routingSource: effectiveRoutingSource,
       routingNote: effectiveRoutingNote,
       routingAffinity: effectiveLeadOnly || requiredCapabilities?.length ? { leadOnly: effectiveLeadOnly, capabilities: requiredCapabilities ?? [] } : undefined
     });
@@ -117135,6 +117250,7 @@ To reject: close this task with a rejection reason.`;
     const task = await createTaskExtended(taskDescription, {
       agentId: leadAgent.id,
       routingReason: "skill",
+      routingSource: "engine_default",
       creatorAgentId: requestInfo.agentId,
       source: "mcp",
       taskType: "skill-approval",
@@ -118911,7 +119027,7 @@ var registerStoreProgressTool = (server) => {
       taskId: uuid().optional().describe("Full task UUID. Defaults to the caller-owned task in X-Source-Task-Id; required outside task context."),
       progress: string().optional().describe("The progress update to store."),
       status: _enum(["completed", "failed", "in_progress", "pending"]).optional().describe("Set to 'completed' or 'failed' to finish the task. 'in_progress' and 'pending' store progress only and do not change task status."),
-      output: string().optional().describe("The task result (used when completing). For Slack-originated tasks, this is published verbatim in the thread's outcome card: provide a concrete summary scaled to what was asked, including only the outcome and any links or IDs the human needs—not process narration, a transcript, or a restatement of the brief."),
+      output: string().optional().describe("The task result (used when completing). For Slack-originated tasks, this is published verbatim in the thread's outcome card. Keep free-text output under 120 words by default. Name the result and every artifact link, plus any IDs the human needs. Link documents instead of inlining them; omit process narration, transcripts, and restatements of the brief. Exceed the target only when requested depth, enumerated results, essential evidence, caveats, or instructions require it, or when the task's outputSchema requires longer output. When the task carries an outputSchema, output must be JSON matching it."),
       failureReason: string().optional().describe("The reason for failure (used when failing)."),
       attachments: array(AttachmentInputSchema).max(20).optional().describe("Pointer-based artifacts produced by this step — agent-fs path, URL, shared-fs path, or swarm Page. No inline file data; upload to agent-fs first and attach by path. Agent-fs pointers are verified before task state changes, using the explicit org/drive pair or the registering agent's configured defaults. May be sent on any call (progress or completion) and accumulates across calls; duplicates are de-duped by sha256 (when present) or by (kind, pointer, name)."),
       persistMemory: boolean().optional().describe("Opt in to task_completion memory persistence for automatic/recurring tasks. Manual tasks are persisted by default; scheduled, system, heartbeat/boot-triage, monitor, and digest tasks are skipped unless this is true."),
@@ -119682,6 +119798,7 @@ async function emitBudgetRefusalSideEffects(ctx, inserted) {
         const followUp = await createTaskExtended(resolved.text, {
           agentId: leadAgent.id,
           routingReason: "skill",
+          routingSource: "engine_default",
           source: "system",
           taskType: "follow-up",
           parentTaskId: ctx.task.id,

package/dist/{cli-ykxrnd1q.js → cli-72xdszyx.js}

@@ -4,12 +4,12 @@ import {
   linkIdentity,
   recordUnmappedIdentity,
   resolveIdentity
-} from "./cli-gv88e1vf.js";
+} from "./cli-ydk0wjj8.js";
 import {
   getKv,
   init_db,
   upsertKv
-} from "./cli-yab68w40.js";
+} from "./cli-qp69dd5d.js";
 
 // src/slack/enrich.ts
 init_db();