@desplega.ai/agent-swarm 1.123.0 → 1.124.0

package/README.md

@@ -136,7 +136,8 @@ Check [our templates](https://templates.agent-swarm.dev) for a quick start.
 - **Scripts as external APIs** — expose a saved script as a public `POST /api/x/script/<id>` endpoint with optional bearer auth, typed input validation, and per-endpoint usage tracking. [Guide →](https://docs.agent-swarm.dev/docs/guides/scripts-external-apis)
 - **Typed script API connections** — lead-managed OpenAPI, GraphQL, and MCP connections generate `ctx.api.*` / `ctx.mcp.*` clients for scripts, with credential bindings and OAuth-backed auth kept server-side. [Guide →](https://docs.agent-swarm.dev/docs/guides/script-connections)
 - **E2B-backed eval harness** — run a scenario × harness-config matrix against real swarm stacks, capture transcripts/artifacts, and grade outcomes with deterministic checks plus LLM or agentic judges. [Guide →](https://docs.agent-swarm.dev/docs/guides/evals-harness)
-- **Harness & LLM agnostic** — run with Claude Code, Claude Bridge, OpenAI Codex, pi-mono (Anthropic, OpenRouter, or Amazon Bedrock), Devin, Claude Managed Agents, raw LLMs, or opencode. Route every OpenRouter-backed harness, workflow, and summarizer through an OpenAI-compatible gateway with `OPENROUTER_BASE_URL`. Tasks, schedules, and workflow agent-task nodes can use portable `modelTier` intent (`smol`, `regular`, `smart`, `ultra`), and operators can set per-agent reasoning effort (`off` → `max`, where supported) without changing task payloads. [Harness config →](https://docs.agent-swarm.dev/docs/guides/harness-configuration) · [Add a new provider →](https://docs.agent-swarm.dev/docs/guides/harness-providers)
+- **Harness & LLM agnostic** — run with Claude Code, Claude Bridge, OpenAI Codex, pi-mono (Anthropic, OpenRouter, or Amazon Bedrock), Devin, Claude Managed Agents, raw LLMs, or opencode. The dashboard model picker follows a live models.dev catalog (with a bundled snapshot fallback), so newly released provider models appear without a redeploy. Route every OpenRouter-backed harness, workflow, and summarizer through an OpenAI-compatible gateway with `OPENROUTER_BASE_URL`. Tasks, schedules, and workflow agent-task nodes can use portable `modelTier` intent (`smol`, `regular`, `smart`, `ultra`), and operators can set per-agent reasoning effort (`off` → `max`, where supported) without changing task payloads. [Harness config →](https://docs.agent-swarm.dev/docs/guides/harness-configuration) · [Add a new provider →](https://docs.agent-swarm.dev/docs/guides/harness-providers)
+- **Published release artifacts** — every release publishes multi-architecture API, full-worker, and slim-worker images alongside versioned E2B templates, the npm CLI package, and the Helm chart. [Artifact inventory →](https://docs.agent-swarm.dev/docs/guides/published-artifacts)
 - **OpenTelemetry traces plus OTLP cost/token metrics** — export API + worker traces and finalized session cost/token counters through the same OTLP pipeline for dashboarding in SigNoz, Datadog, Tempo, or another compatible backend. [Observability →](https://docs.agent-swarm.dev/docs/guides/observability-opentelemetry)
 - **Follow-up continuity across all harnesses** — child tasks inherit a bounded prior-task context preamble built from the task chain, so continuity survives restarts and works the same across every provider. [Task lifecycle →](https://docs.agent-swarm.dev/docs/concepts/task-lifecycle)
 - **Skills & MCP servers** — reusable procedural knowledge, bundled skill reference files, and per-agent MCP servers with scope cascade. [MCP tools →](https://docs.agent-swarm.dev/docs/reference/mcp-tools)

package/dist/{actions-e4c9f0xy.js → actions-z3d0fk7z.js}

@@ -1,14 +1,14 @@
 import {
   resolveSlackUserId
-} from "./cli-n8mf7x4b.js";
-import"./cli-1592nfd6.js";
+} from "./cli-jp4mdj9d.js";
+import"./cli-0925phzv.js";
 import {
   createTaskWithSiblingAwareness
-} from "./cli-kmm1rwmp.js";
+} from "./cli-qwsagsmg.js";
 import {
   buildCancelledBlocks,
   getTaskLink
-} from "./cli-5arfywtm.js";
+} from "./cli-5ncdb7ff.js";
 import"./cli-wspgs9bt.js";
 import"./cli-dh55d5fg.js";
 import {
@@ -19,9 +19,9 @@ import {
   init_context_key,
   init_db,
   slackContextKey
-} from "./cli-8cq4z4x7.js";
+} from "./cli-3z4q09tn.js";
 import"./cli-z2zcxes1.js";
-import"./cli-h2say6xk.js";
+import"./cli-p0zgv8pj.js";
 import"./cli-4j2mrzag.js";
 import"./cli-bw80ck94.js";
 import"./cli-xz9aq0rf.js";

package/dist/{app-vmvmj2v3.js → app-q2rc9tdr.js}

@@ -3,15 +3,15 @@ import {
   initSlackApp,
   startSlackApp,
   stopSlackApp
-} from "./cli-fjf04hpa.js";
+} from "./cli-dq2ssyf0.js";
 import"./cli-rkndnn90.js";
 import"./cli-b0p7rfnd.js";
-import"./cli-5arfywtm.js";
+import"./cli-5ncdb7ff.js";
 import"./cli-wspgs9bt.js";
 import"./cli-dh55d5fg.js";
-import"./cli-8cq4z4x7.js";
+import"./cli-3z4q09tn.js";
 import"./cli-z2zcxes1.js";
-import"./cli-h2say6xk.js";
+import"./cli-p0zgv8pj.js";
 import"./cli-4j2mrzag.js";
 import"./cli-bw80ck94.js";
 import"./cli-xz9aq0rf.js";

package/dist/{assistant-yn7a792a.js → assistant-3stjq7fz.js}

@@ -1,24 +1,24 @@
 import {
   bufferThreadMessage,
   wasEventSeen
-} from "./cli-we91ywvy.js";
+} from "./cli-sqv6c9b8.js";
 import {
   hasOtherUserMention
-} from "./cli-3tv9z4wx.js";
+} from "./cli-92bqgbgy.js";
 import {
   resolveSlackUserId,
   rewriteSlackMentions
-} from "./cli-n8mf7x4b.js";
-import"./cli-1592nfd6.js";
+} from "./cli-jp4mdj9d.js";
+import"./cli-0925phzv.js";
 import {
   createTaskWithSiblingAwareness
-} from "./cli-kmm1rwmp.js";
+} from "./cli-qwsagsmg.js";
 import {
   require_dist
-} from "./cli-fjf04hpa.js";
+} from "./cli-dq2ssyf0.js";
 import"./cli-rkndnn90.js";
 import"./cli-b0p7rfnd.js";
-import"./cli-5arfywtm.js";
+import"./cli-5ncdb7ff.js";
 import"./cli-wspgs9bt.js";
 import"./cli-dh55d5fg.js";
 import {
@@ -32,9 +32,9 @@ import {
   isEnvFlagEnabled,
   resolveTemplate,
   slackContextKey
-} from "./cli-8cq4z4x7.js";
+} from "./cli-3z4q09tn.js";
 import"./cli-z2zcxes1.js";
-import"./cli-h2say6xk.js";
+import"./cli-p0zgv8pj.js";
 import"./cli-4j2mrzag.js";
 import"./cli-bw80ck94.js";
 import"./cli-xz9aq0rf.js";

package/dist/{boot-reembed-xg1r86h2.js → boot-reembed-5867whnb.js}

@@ -3,14 +3,14 @@ import {
   getEmbeddingProvider,
   getMemoryStore,
   init_constants
-} from "./cli-zdp11t8m.js";
+} from "./cli-p0ec4vv6.js";
 import"./cli-q25ejbyn.js";
 import {
   getDb,
   init_db
-} from "./cli-8cq4z4x7.js";
+} from "./cli-3z4q09tn.js";
 import"./cli-z2zcxes1.js";
-import"./cli-h2say6xk.js";
+import"./cli-p0zgv8pj.js";
 import"./cli-4j2mrzag.js";
 import"./cli-bw80ck94.js";
 import"./cli-xz9aq0rf.js";

package/dist/{boot-reembed-chxty50a.js → boot-reembed-v6r1df32.js}

@@ -1,15 +1,15 @@
 import {
   embedScript,
   embeddingProvider
-} from "./cli-byv3720g.js";
-import"./cli-zdp11t8m.js";
+} from "./cli-mmk5vagg.js";
+import"./cli-p0ec4vv6.js";
 import"./cli-q25ejbyn.js";
 import {
   getDb,
   init_db
-} from "./cli-8cq4z4x7.js";
+} from "./cli-3z4q09tn.js";
 import"./cli-z2zcxes1.js";
-import"./cli-h2say6xk.js";
+import"./cli-p0zgv8pj.js";
 import"./cli-4j2mrzag.js";
 import"./cli-bw80ck94.js";
 import"./cli-xz9aq0rf.js";

package/dist/{boot-scrub-logs-exwddvp5.js → boot-scrub-logs-8b8jegk3.js}

@@ -1,9 +1,9 @@
 import {
   getDb,
   init_db
-} from "./cli-8cq4z4x7.js";
+} from "./cli-3z4q09tn.js";
 import"./cli-z2zcxes1.js";
-import"./cli-h2say6xk.js";
+import"./cli-p0zgv8pj.js";
 import {
   init_secret_scrubber,
   scrubSecrets

package/dist/{cli-1592nfd6.js → cli-0925phzv.js}

@@ -4,7 +4,7 @@ import {
   incrKv,
   init_db,
   upsertKv
-} from "./cli-8cq4z4x7.js";
+} from "./cli-3z4q09tn.js";
 
 // src/be/users.ts
 init_db();

package/dist/{cli-hbbxmhec.js → cli-2yr6edr7.js}

@@ -4,15 +4,15 @@ import {
   handleScheduleTrigger,
   runScript,
   startWorkflowExecution
-} from "./cli-822d4bjk.js";
+} from "./cli-kk58tg33.js";
 import {
   getScript,
   getScriptApiConnectionDescriptors,
   getScriptMcpConnectionDescriptors
-} from "./cli-p11rf59d.js";
+} from "./cli-wn3m6q54.js";
 import {
   createTaskWithSiblingAwareness
-} from "./cli-kmm1rwmp.js";
+} from "./cli-qwsagsmg.js";
 import {
   getDb,
   getDueScheduledTasks,
@@ -24,7 +24,7 @@ import {
   scheduleContextKey,
   telemetry,
   updateScheduledTask
-} from "./cli-8cq4z4x7.js";
+} from "./cli-3z4q09tn.js";
 import {
   __commonJS,
   __require,

package/dist/{cli-8cq4z4x7.js → cli-3z4q09tn.js}

@@ -5,7 +5,7 @@ import {
 import {
   init_package,
   package_default
-} from "./cli-h2say6xk.js";
+} from "./cli-p0zgv8pj.js";
 import {
   init_secret_scrubber,
   scrubSecrets
@@ -643,6 +643,27 @@ function _resolveCloudMode(mcpBaseUrl) {
     return { isCloud: false };
   return { isCloud: isCloudHostname(hostname) };
 }
+function _resolveInstallMethod(raw, isE2b) {
+  const normalized = raw?.trim();
+  if (normalized && KNOWN_INSTALL_METHODS.has(normalized))
+    return normalized;
+  if (isE2b)
+    return "e2b";
+  return "manual";
+}
+function _resolveInstallPreset(raw) {
+  const normalized = raw?.trim();
+  return normalized && KNOWN_INSTALL_PRESETS.has(normalized) ? normalized : undefined;
+}
+function _hasEmbeddingKey(env = process.env) {
+  return !!(env.EMBEDDING_API_KEY || env.OPENAI_API_KEY);
+}
+function _hasSlackChannel(env = process.env) {
+  return !!(env.SLACK_BOT_TOKEN && env.SLACK_APP_TOKEN) && !isEnvFlagEnabled("SLACK_DISABLE", false, env);
+}
+function _hasEmailChannel(env = process.env) {
+  return !!env.AGENTMAIL_WEBHOOK_SECRET && !isEnvFlagEnabled("AGENTMAIL_DISABLE", false, env);
+}
 async function initTelemetry(sourceId, getConfig, setConfig, options = {}) {
   if (!isEnabled())
     return;
@@ -651,14 +672,25 @@ async function initTelemetry(sourceId, getConfig, setConfig, options = {}) {
   const resolved = _resolveCloudMode(process.env.MCP_BASE_URL);
   cachedIsCloud = resolved.isCloud;
   cachedIsE2b = _isE2bSandbox();
-  console.log(`telemetry: cloud=${cachedIsCloud} e2b=${cachedIsE2b}`);
+  cachedHasEmbedding = _hasEmbeddingKey();
+  cachedHasSlackChannel = _hasSlackChannel();
+  cachedHasEmailChannel = _hasEmailChannel();
+  cachedInstallMethod = _resolveInstallMethod(process.env.INSTALL_METHOD, cachedIsE2b);
+  cachedInstallPreset = _resolveInstallPreset(process.env.INSTALL_PRESET);
+  console.log(`telemetry: cloud=${cachedIsCloud} e2b=${cachedIsE2b} install_method=${cachedInstallMethod}`);
   try {
     const existing = await getConfig("telemetry_installation_id");
     if (existing) {
       installationId = existing;
+      const existingInstalledAt = await getConfig("telemetry_installed_at");
+      if (existingInstalledAt) {
+        installedAt = existingInstalledAt;
+      }
     } else if (generateIfMissing) {
-      installationId = `install_${randomUUID().replace(/-/g, "").slice(0, 16)}`;
-      await setConfig("telemetry_installation_id", installationId);
+      const candidateId = `install_${randomUUID().replace(/-/g, "").slice(0, 16)}`;
+      await setConfig("telemetry_installation_id", candidateId);
+      installationId = candidateId;
+      await tryPersistInstalledAt(setConfig);
     }
   } catch {
     if (generateIfMissing) {
@@ -666,6 +698,13 @@ async function initTelemetry(sourceId, getConfig, setConfig, options = {}) {
     }
   }
 }
+async function tryPersistInstalledAt(setConfig) {
+  const candidate = new Date().toISOString();
+  try {
+    await setConfig("telemetry_installed_at", candidate);
+    installedAt = candidate;
+  } catch {}
+}
 function getOrgIdentity() {
   const out = {};
   const orgId = process.env.SWARM_ORG_ID?.trim();
@@ -703,7 +742,12 @@ function track(options) {
         ...options.properties ?? {},
         is_cloud: cachedIsCloud || isCloudDeployment(),
         is_e2b: cachedIsE2b,
-        swarmVersion: package_default.version
+        swarmVersion: package_default.version,
+        has_embedding_key: cachedHasEmbedding,
+        has_slack_channel: cachedHasSlackChannel,
+        has_email_channel: cachedHasEmailChannel,
+        has_notification_channel: cachedHasSlackChannel || cachedHasEmailChannel,
+        install_method: cachedInstallMethod
       },
       metadata: {
         transport: "https",
@@ -711,6 +755,8 @@ function track(options) {
         environment: getTelemetryEnvironment(),
         is_cloud: isCloudDeployment(),
         ...getOrgIdentity(),
+        ...cachedInstallPreset ? { install_preset: cachedInstallPreset } : {},
+        ...installedAt ? { install_created_at: installedAt } : {},
         ...options.metadata
       }
     };
@@ -722,7 +768,7 @@ function track(options) {
     }).catch(() => {});
   } catch {}
 }
-var TELEMETRY_ENDPOINT = "https://proxy.desplega.sh/v1/events", PRODUCT = "agent-swarm", TIMEOUT_MS = 5000, installationId = null, source = "unknown", cachedIsCloud = false, cachedIsE2b = false, CLOUD_HOST_EXACT, CLOUD_HOST_SUFFIXES, telemetry;
+var TELEMETRY_ENDPOINT = "https://proxy.desplega.sh/v1/events", PRODUCT = "agent-swarm", TIMEOUT_MS = 5000, installationId = null, installedAt = null, source = "unknown", cachedIsCloud = false, cachedIsE2b = false, cachedHasEmbedding = false, cachedHasSlackChannel = false, cachedHasEmailChannel = false, cachedInstallMethod = "manual", cachedInstallPreset, CLOUD_HOST_EXACT, CLOUD_HOST_SUFFIXES, KNOWN_INSTALL_METHODS, KNOWN_INSTALL_PRESETS, telemetry;
 var init_telemetry = __esm(() => {
   init_package();
   init_env_flag();
@@ -732,6 +778,8 @@ var init_telemetry = __esm(() => {
     "agent-swarm.cloud"
   ]);
   CLOUD_HOST_SUFFIXES = [".agent-swarm.dev", ".agent-swarm.cloud"];
+  KNOWN_INSTALL_METHODS = new Set(["onboard_interactive", "onboard_noninteractive"]);
+  KNOWN_INSTALL_PRESETS = new Set(["dev", "content", "research", "solo", "custom"]);
   telemetry = {
     taskEvent(event, props) {
       track({ event: `task.${event}`, properties: props });
@@ -3329,9 +3377,8 @@ You also still have \`/workspace/personal/\` for general file persistence.
 You have access to agent-fs — a persistent, searchable filesystem shared across the swarm.
 Use the \`agent-fs\` CLI for all thoughts, research, plans, and shared documents.
 
-The \`agent-fs\` skill (from the agent-fs Claude Code plugin) provides a full CLI reference —
-it auto-injects on relevant Bash tool calls. You can also run \`agent-fs docs\` for
-interactive CLI documentation.
+The \`agent-fs\` skill (installed in your skills directory) provides a full CLI
+reference. You can also run \`agent-fs docs\` for interactive CLI documentation.
 
 ### Writing to your personal drive (default)
 \`\`\`bash
@@ -3421,6 +3468,50 @@ Your source code lives in the \`desplega-ai/agent-swarm\` GitHub repository. Key
 Use this to debug issues and propose improvements to your own infrastructure.
 
 **Proposing changes:** If you want to change how you are built (hooks, runner, prompts, tools), ask the lead agent to follow up with the user in Slack to discuss the change. Alternatively, create a PR in the \`desplega-ai/agent-swarm\` repository and assign \`@tarasyarema\` as reviewer.
+`,
+    variables: [],
+    category: "system"
+  });
+  registerTemplate({
+    eventType: "system.agent.script_authoring_contract",
+    header: "",
+    defaultBody: `
+### Script Authoring Contract (read BEFORE writing any script)
+
+**Entry point — \`args\` FIRST, \`ctx\` SECOND.** A one-parameter \`function (ctx)\` can execute through \`script-run\`, but at runtime that parameter receives \`args\`, so every \`ctx.*\` access throws. \`script-upsert\` also rejects an untyped parameter under strict typechecking. This is the single most common cause of failed script runs.
+
+\`\`\`ts
+import type { ScriptContext } from "swarm-sdk";
+import * as z from "zod";
+
+export const argsSchema = z.object({ taskId: z.string(), limit: z.number().optional() });
+
+export default async function (args: z.infer<typeof argsSchema>, ctx: ScriptContext) {
+  const res = await ctx.swarm.task_get({ taskId: args.taskId });
+  const task = ((res as { data?: unknown }).data ?? res) as { title?: string };
+  return { title: task?.title };
+}
+\`\`\`
+
+**Typechecking:** inline source passed to \`script-run\` executes without a compile-time typecheck. \`script-upsert\` typechecks before saving, so import \`ScriptContext\` from \`"swarm-sdk"\` as shown above to make inline code promotion-safe. Use \`script-query-types\` for the authoritative SDK and stdlib declarations.
+
+**What \`ctx\` actually holds for inline/named scripts (\`script-run\` / \`script-upsert\`) — nothing else:**
+- \`ctx.swarm.*\` — the swarm SDK: \`task_get\`, \`task_send\`, \`task_storeProgress\`, \`task_action\`, \`task_list\`, \`message_post\`, \`message_read\`, \`slack_reply\`, \`memory_search\`, \`kv_get\`/\`kv_set\`/\`kv_del\`/\`kv_incr\`/\`kv_list\`, \`swarm_get\`, \`agent_info\`, and more. Responses are usually wrapped — prefer \`res?.data ?? res\`.
+- \`ctx.swarm.config\` — \`apiKey\`, \`agentId\`, \`mcpBaseUrl\`, plus \`ctx.swarm.config.get("KEY")\` for user values. All are \`Redacted\` wrappers: they stringify to \`<redacted>\`, and you must never unwrap them into a return value, log line, or request body you build by hand.
+- \`ctx.api.<slug>\` / \`ctx.mcp.<slug>\` — typed clients for connections the lead registered (\`ctx.api.<slug>.<operationId>(...)\`, \`ctx.api.<slug>.graphql(query, vars)\`, \`ctx.mcp.<slug>.<toolName>(args)\`). They exist ONLY for registered connections — introspect with \`Object.keys(ctx.api ?? {})\` / \`Object.keys(ctx.mcp ?? {})\` before assuming one is there.
+- \`ctx.stdlib\` — \`fetch\`, \`fetchJson\` (retries + 30s timeout), \`grep\`, \`glob\`, \`table\`, \`Redacted\`.
+- \`ctx.logger\` — \`log\` / \`warn\` / \`error\`.
+
+There is NO ambient task context: \`taskId\` must arrive through \`args\`. \`agentId\` IS propagated automatically (\`X-Agent-ID\` header).
+
+**Durable workflow scripts (\`launch-script-run\`) get a DIFFERENT \`ctx\`:** \`ctx.run\` (\`id\`/\`agentId\`/\`args\`), \`ctx.step.rawLlm(label, config)\` / \`ctx.step.agentTask(label, config)\` / \`ctx.step.swarmScript(label, config)\` (durable, journaled steps), plus \`ctx.swarm.*\`, \`ctx.stdlib\`, \`ctx.logger\` as above. Durable runs have NO \`ctx.api\`/\`ctx.mcp\` connection clients and no \`ctx.swarm.config\` — call connections from an inner script via \`ctx.step.swarmScript\` instead.
+
+**\`argsSchema\` convention:** export a Zod schema named \`argsSchema\` from every named script. \`script-upsert\` converts it to JSON Schema, so callers, schedules, and workflows can see the script's input contract. Without it the script's args are undocumented.
+
+**Secrets — never paste a raw value:**
+- Prefer a registered connection (\`ctx.api.<slug>\` / \`ctx.mcp.<slug>\`): its credentials are attached server-side and never enter the script.
+- Otherwise put the placeholder \`[REDACTED:<CONFIG_KEY>]\` in the header or query value (e.g. \`Authorization: Bearer [REDACTED:GITHUB_TOKEN]\`). The runtime substitutes the real value at egress, and only for that credential binding's allowed hosts.
+- NEVER bake a raw secret — or the output of \`get-config\` with \`includeSecrets: true\` — into script source, script args, a schedule's \`taskTemplate\`, or a task description. Those are stored as plaintext and replayed on every run. Use a connection or a credential binding instead.
 `,
     variables: [],
     category: "system"
@@ -3429,6 +3520,8 @@ Use this to debug issues and propose improvements to your own infrastructure.
     eventType: "system.agent.script_rubric",
     header: "",
     defaultBody: `
+{{@template[system.agent.script_authoring_contract]}}
+
 ### Agent Scripts — for bulk, repetitive, or data-heavy work
 
 Use **scripts** (\`script-upsert\` + \`script-run\`) when a task involves repetitive SDK calls, large data processing, or deterministic multi-step pipelines. Scripts run out-of-process and return only their final result.
@@ -3469,13 +3562,7 @@ The 5 script tools (\`script-search\`, \`script-run\`, \`script-upsert\`, \`scri
 
 This swarm runs in **scripts-only mode**. The ONLY swarm MCP tools available are the script tools: \`script-search\`, \`script-run\`, \`script-upsert\`, \`script-delete\`, \`script-query-types\`, \`launch-script-run\`, \`get-script-run\`, \`list-script-runs\` (your harness may expose them under a prefix, e.g. \`mcp__agent-swarm__script-run\` — use the exact registered tool id). They are already loaded. Named tools like \`store-progress\`, \`send-task\`, \`post-message\`, \`memory-search\` do NOT exist here — do not search for them.
 
-**Script entry signature (memorize — args FIRST, ctx SECOND):**
-
-\`\`\`ts
-export default async function (args: any, ctx: any) { /* ... */ }
-\`\`\`
-
-The full SDK is \`ctx.swarm.*\` — task lifecycle (\`task_get\`, \`task_send\`, \`task_storeProgress\`, \`task_action\`, \`task_list\`), messaging (\`message_post\`, \`message_read\`), Slack (\`slack_reply\`, \`slack_post\`, \`slack_read\`), memory, kv, swarm info (\`swarm_get\`, \`agent_info\`), and more. Responses are usually wrapped — prefer \`res?.data ?? res\`.
+The script authoring contract above (entry signature, \`ctx\` shape, secret handling) applies here unchanged. The full SDK is \`ctx.swarm.*\` — task lifecycle (\`task_get\`, \`task_send\`, \`task_storeProgress\`, \`task_action\`, \`task_list\`), messaging (\`message_post\`, \`message_read\`), Slack (\`slack_reply\`, \`slack_post\`, \`slack_read\`), memory, kv, swarm info (\`swarm_get\`, \`agent_info\`), and more. Responses are usually wrapped — prefer \`res?.data ?? res\`.
 
 **Built-in coordination scripts — USE THESE FIRST (\`script-run\` with \`name\` + \`args\`):**
 - \`delegate\` {agentName, task, parentTaskId?} → subtask for an agent by name; returns {taskId}
@@ -3523,6 +3610,15 @@ You have access to the \`context-mode\` MCP tools (\`batch_execute\`, \`execute\
 
 {{@template[system.agent.script_rubric]}}
 
+{{@template[system.agent.scheduling]}}
+`,
+    variables: [],
+    category: "system"
+  });
+  registerTemplate({
+    eventType: "system.agent.scheduling",
+    header: "",
+    defaultBody: `
 ### Scheduling — Pick the Right targetType
 
 When creating a schedule, match \`targetType\` to the work being fired:
@@ -3781,6 +3877,29 @@ Honor this requester profile in tone, depth, and format where it doesn't conflic
 {{@template[system.agent.filesystem]}}
 {{@template[system.agent.self_awareness]}}
 {{@template[system.agent.script_rubric]}}
+{{@template[system.agent.scheduling]}}
+{{@template[system.agent.seed_scripts]}}
+
+{{@template[system.agent.system]}}
+{{@template[system.agent.share_urls]}}
+{{@template[system.agent.code_quality]}}`,
+    variables: [
+      { name: "role", description: "The agent's role" },
+      { name: "agentId", description: "The agent's unique identifier" }
+    ],
+    category: "session"
+  });
+  registerTemplate({
+    eventType: "system.session.lead.pi",
+    header: "",
+    defaultBody: `{{@template[system.agent.role]}}
+
+{{@template[system.agent.register]}}
+{{@template[system.agent.lead]}}
+{{@template[system.agent.filesystem]}}
+{{@template[system.agent.self_awareness]}}
+{{@template[system.agent.script_rubric]}}
+{{@template[system.agent.scheduling]}}
 {{@template[system.agent.seed_scripts]}}
 
 {{@template[system.agent.system]}}
@@ -4836,6 +4955,7 @@ __export(exports_db, {
   markInboxMessageDelegated: () => markInboxMessageDelegated,
   logQueries: () => logQueries,
   listWorkflows: () => listWorkflows,
+  listWorkflowRunsPage: () => listWorkflowRunsPage,
   listWorkflowRuns: () => listWorkflowRuns,
   listUserFavorites: () => listUserFavorites,
   listTaskTemplates: () => listTaskTemplates,
@@ -5118,6 +5238,7 @@ __export(exports_db, {
   createApprovalRequest: () => createApprovalRequest,
   createAgentMailInboxMapping: () => createAgentMailInboxMapping,
   createAgent: () => createAgent,
+  countWorkflowRuns: () => countWorkflowRuns,
   countSessions: () => countSessions,
   countScriptRuns: () => countScriptRuns,
   countScriptRunJournalSteps: () => countScriptRunJournalSteps,
@@ -9340,8 +9461,50 @@ function updateWorkflowRun(id, data) {
   }
   return run;
 }
-function listWorkflowRuns(workflowId) {
-  return getDb().prepare("SELECT * FROM workflow_runs WHERE workflowId = ? ORDER BY startedAt DESC").all(workflowId).map(rowToWorkflowRun);
+function listWorkflowRuns(workflowId, options = {}) {
+  const conditions = ["workflowId = ?"];
+  const params = [workflowId];
+  if (options.status) {
+    conditions.push("status = ?");
+    params.push(options.status);
+  }
+  let pagination = "";
+  if (options.limit !== undefined) {
+    pagination = " LIMIT ? OFFSET ?";
+    params.push(options.limit, options.offset ?? 0);
+  } else if (options.offset !== undefined) {
+    pagination = " LIMIT -1 OFFSET ?";
+    params.push(options.offset);
+  }
+  return getDb().prepare(`SELECT * FROM workflow_runs
+       WHERE ${conditions.join(" AND ")}
+       ORDER BY startedAt DESC, id DESC${pagination}`).all(...params).map(rowToWorkflowRun);
+}
+function countWorkflowRuns(workflowId, options = {}) {
+  const conditions = ["workflowId = ?"];
+  const params = [workflowId];
+  if (options.status) {
+    conditions.push("status = ?");
+    params.push(options.status);
+  }
+  const row = getDb().prepare(`SELECT COUNT(*) AS count FROM workflow_runs WHERE ${conditions.join(" AND ")}`).get(...params);
+  return row?.count ?? 0;
+}
+function listWorkflowRunsPage(workflowId, options) {
+  const runs = listWorkflowRuns(workflowId, options);
+  const total = countWorkflowRuns(workflowId, { status: options.status });
+  const nextOffset = options.offset + runs.length;
+  const hasMore = nextOffset < total;
+  return {
+    runs,
+    page: {
+      limit: options.limit,
+      offset: options.offset,
+      total,
+      hasMore,
+      ...hasMore ? { nextOffset } : {}
+    }
+  };
 }
 function rowToWorkflowRunStep(row) {
   return {
@@ -12041,4 +12204,4 @@ var init_db = __esm(() => {
   };
 });
 
-export { normalizeAssetKey, parseAssetKey, canWriteAssetKey, init_key, interpolate, deepInterpolate, init_template, registerTemplate, getTemplateDefinition, getAllTemplateDefinitions, init_registry, configureHttpResolver, resolveTemplate, resolveTemplateAsync, init_resolver, slackContextKey, agentmailContextKey, githubContextKey, gitlabContextKey, linearContextKey, buildJiraContextKey, scheduleContextKey, workflowContextKey, agentContextKey, pageContextKey, init_context_key, checkSlackRoutingCoherence, init_slack_routing, parseEnvFlag, isEnvFlagEnabled, init_env_flag, initTelemetry, telemetry, init_telemetry, AssetKeySchema, AssetEntityTypeSchema, ModelTierSchema, ReasoningEffortSchema, splitLegacyModelAlias, resolveTaskModelSelection, AgentTaskStatusSchema, isTerminalTaskStatus, AgentTaskSourceSchema, ProviderNameSchema, SteerModeSchema, SteeringSourceSchema, SteeringMessageSchema, SteerOutcomeSchema, OnUnsupportedSchema, FollowUpConfigSchema, AgentTaskSchema, AttachmentInputSchema, TaskAttachmentSchema, InboxItemTypeSchema, InboxItemStatusSchema, FavoriteItemTypeSchema, TaskTemplateKindSchema, AgentAvatarSchema, AgentSchema, AgentLatestModelSchema, AgentCredStatusSchema, ChannelTypeSchema, ChannelSchema, ChannelMessageSchema, ServiceStatusSchema, ServiceSchema, ResumeReasonSchema, AgentLogSchema, EventCategorySchema, EventStatusSchema, EventSourceSchema, EventNameSchema, ScheduledTaskTargetTypeSchema, SwarmConfigScopeSchema, SwarmConfigSchema, RepoGuidelinesSchema, RepoHooksSchema, SwarmRepoSchema, AgentMemoryScopeSchema, AgentMemorySourceSchema, AgentMemorySchema, WorkflowDefinitionSchema, WorkflowNodePatchSchema, WorkflowPatchSchema, TriggerConfigSchema, CooldownConfigSchema, InputValueSchema, PageContentTypeSchema, PageAuthModeSchema, MetricDefinitionSchema, MetricVersionSchema, WorkflowRunStatusSchema, ScriptRunStatusSchema, TERMINAL_SCRIPT_RUN_STATUSES, PromptTemplateScopeSchema, PromptTemplateStateSchema, PromptTemplateSchema, PromptTemplateHistorySchema, ScriptScopeSchema, ScriptFsModeSchema, ScriptApiAuthModeSchema, ContextSnapshotEventTypeSchema, ContextFormulaSchema, BudgetScopeSchema, BudgetSchema, PricingProviderSchema, PricingTokenClassSchema, PricingRowSchema, BudgetRefusalCauseSchema, BudgetRefusalNotificationSchema, KvValueTypeSchema, KvNamespaceSchema, KvKeySchema, KvEntrySchema, init_types, setRequestAuth, getRequestAuth, getCurrentRequestAuth, init_request_auth_context, auditAssetKeys, init_asset_key_audit, CredentialBindingSchema, placeholderForConfigKey, CredentialBroker, DEFAULT_CREDENTIAL_BINDINGS, init_credential_broker, encryptSecret, decryptSecret, getEncryptionKey, init_crypto, normalizeDate, normalizeDateRequired, init_date_utils, init_session_templates, init_templates, init_templates2 as init_templates1, isSteeringEnabled, init_steering_enabled, SteeringRequestError, isSteeringEnabled2 as isSteeringEnabled1, getTaskSteeringFields, promotePendingSteeringForTask, markSteeringUndeliverable, requestSteering, init_steering, isReservedConfigKey, reservedKeyError, validateConfigValue, init_swarm_config_guard, onTaskStarted, init_task_lifecycle_events, generateDefaultClaudeMd, generateDefaultSoulMd, generateDefaultIdentityMd, generateDefaultToolsMd, init_defaults, isSqliteVecAvailable, initDb, getDb, closeDb, computeContentHash, createContextVersion, getLatestContextVersion, getContextVersion, getContextVersionHistory, agentQueries, updateAgentCredentialState, createAgent, getAgentById, getAllAgents, getLeadAgent, updateAgentStatus, updateAgentMaxTasks, updateAgentProvider, setAgentHarnessProvider, updateAgentCredStatus, listAgentsWithCredStatusByProvider, getAgentHarnessProviders, updateAgentActivity, MAX_EMPTY_POLLS, incrementEmptyPollCount, resetEmptyPollCount, shouldBlockPolling, deleteAgent, getActiveTaskCount, hasCapacity, getRemainingCapacity, updateAgentStatusFromCapacity, isPoolAffinityEnforcementEnabled, buildRoutingAffinityFromAgent, isAgentEligibleForTask, taskQueries, createTask, getPendingTaskForAgent, assignUnassignedTaskPending, startTask, getTaskById, markTaskSlackReplySent, setSlackMessageTracking, getChildTasks, hasNonTerminalResumeChild, hasNonTerminalRerouteDecisionChild, updateTaskClaudeSessionId, updateTaskTitle, updateTaskVcs, getTasksByAgentId, getAgentCurrentTask, getTasksByStatus, findTaskByVcs, findTaskByGitHub, getAllTasks, getTasksCount, getTaskStats, getCompletedSlackTasks, getRecentlyFinishedWorkerTasks, markTasksNotified, resetTasksNotified, getInProgressSlackTasks, getInProgressTasksByContextKey, findExistingLinearTrackerContextWork, getLatestTaskByContextKey, getAgentWorkingOnThread, getLatestActiveTaskInThread, getLatestLeadTaskInThread, getMostRecentTaskInThread, findCompletedTaskInThread, findRecentCancelledTaskInThread, completeTask, failTask, cancelTask, supersedeTask, backfillSupersedeTaskResumeTaskId, pauseTask, resumeTask, getPausedTasksForAgent, getOrphanedInProgressTasksForAgent, resetOrphanedInProgressTasksForAgent, getRecentlyCancelledTasksForAgent, deleteTask, updateTaskProgress, insertTaskAttachment, getAssetKeyMappingByProvider, upsertAssetKeyMapping, getAssetKeyMapping, listAssetSummaries, moveAssetKey, deleteTaskAttachment, replaceTaskAttachment, getTaskAttachments, createSteeringMessage, getSteeringMessagesForTask, getSteeringMessageById, getPendingSteeringForTask, getPendingSteeringForAgent, markSteeringDelivered, markSteeringHandled, markSteeringPromoted, cancelPendingSteeringForTask, hasPendingSteering, getAgentWithTasks, getAllAgentsWithTasks, logQueries, createLogEntry, getLogsByAgentId, getLogsByTaskId, getLogsByTaskIdChronological, getLogsByEventType, getAllLogs, findRecentSimilarTasks, createTaskExtended, claimTask, releaseTask, acceptTask, rejectTask, moveTaskToBacklog, moveTaskFromBacklog, releaseStaleReviewingTasks, getOfferedTasksForAgent, claimOfferedTask, getUnassignedTasksCount, getUnassignedTaskIds, getUnassignedTaskIdsForAgent, checkDependencies, getDependentTasks, cascadeFailDependents, updateAgentProfile, updateAgentName, createChannel, getMessageById, getChannelById, getChannelByName, getAllChannels, deleteChannel, postMessage, getChannelMessages, updateReadState, getLastReadAt, getUnreadMessages, getMentionsForAgent, getInboxSummary, claimMentions, releaseMentionProcessing, releaseStaleMentionProcessing, createService, getServiceById, getServiceByAgentAndName, getServicesByAgentId, getAllServices, updateServiceStatus, deleteService, upsertService, deleteServicesByAgentId, sessionLogQueries, createSessionLogs, getSessionLogsByTaskId, getSessionLogsBySession, createSessionCost, getSessionCostsByTaskId, getSessionCostsByAgentId, getAllSessionCosts, getSessionCostsFiltered, getSessionCostSummary, getDashboardCostSummary, createInboxMessage, getInboxMessageById, getUnreadInboxMessages, claimInboxMessages, markInboxMessageRead, markInboxMessageResponded, markInboxMessageDelegated, releaseStaleProcessingInbox, getConcurrentContext, getScheduledTasks, getScheduledTaskById, getScheduledTaskByName, createScheduledTask, updateScheduledTask, deleteScheduledTask, getDueScheduledTasks, autoEncryptLegacyPlaintextSecrets, maskSecrets, getSwarmConfigs, getInjectableGlobalConfigs, getSwarmConfigById, getSwarmConfigLookupById, upsertSwarmConfig, deleteSwarmConfig, deleteSwarmConfigByKey, getResolvedConfig, getSwarmRepos, getSwarmRepoById, getSwarmRepoByName, getSwarmRepoByUrl, createSwarmRepo, updateSwarmRepo, deleteSwarmRepo, getAgentMailInboxMapping, getAgentMailInboxMappingsByAgent, getAllAgentMailInboxMappings, createAgentMailInboxMapping, deleteAgentMailInboxMapping, findTaskByAgentMailThread, insertActiveSession, deleteActiveSession, deleteActiveSessionById, getActiveSessions, heartbeatActiveSession, cleanupStaleSessions, cleanupAgentSessions, updateActiveSessionProviderSessionId, getActiveSessionForTask, reassociateSessionLogs, getStalledInProgressTasks, getStalePinnedResumes, failPendingResumeIfUnclaimed, getIdleWorkersWithCapacity, getUnassignedPoolTasks, getStaleUnassignedAffinityTasks, getRecentFailedTasks, getRecentCompletedCount, getRecentFailedCount, createWorkflow, getWorkflow, listWorkflows, updateWorkflow, deleteWorkflow, getWorkflowsByScheduleId, createWorkflowRun, getWorkflowRun, updateWorkflowRun, listWorkflowRuns, createWorkflowRunStep, getWorkflowRunStep, updateWorkflowRunStep, getWorkflowRunStepsByRunId, getStuckWorkflowRuns, getLastSuccessfulRun, getLastRunStart, getRetryableSteps, getCompletedStepNodeIds, getTaskByWorkflowRunStepId, getStepByIdempotencyKey, getStepCountForNode, getLatestStepForNode, createWorkflowVersion, getWorkflowVersions, getWorkflowVersion, createPage, getPage, getPageBySlug, getLatestPageBySlug, listPagesByAgent, listAllPages, countAllPages, countPagesByAgent, updatePage, deletePage, incrementPageViewCount, createPageVersion, getPageVersions, getPageVersion, createMetric, getMetric, getMetricBySlug, listMetricsByAgent, listAllMetrics, countAllMetrics, countMetricsByAgent, updateMetric, deleteMetric, createMetricVersion, getMetricVersions, getMetricVersion, getPromptTemplates, getPromptTemplateById, upsertPromptTemplate, deletePromptTemplate, resetPromptTemplateToDefault, getPromptTemplateHistory, resolvePromptTemplate, checkoutPromptTemplate, getAllChannelActivityCursors, getChannelActivityCursor, upsertChannelActivityCursor, createApprovalRequest, getApprovalRequestById, resolveApprovalRequest, updateApprovalRequestNotifications, listApprovalRequests, getStuckApprovalRuns, getApprovalRequestByStepId, getExpiredPendingApprovals, createWaitState, getWaitStateById, getWaitStateByStepId, getDueWaitStates, getPendingEventWaitNames, getPendingWaitsByEvent, resolveWaitState, getStuckWaitRuns, SKILL_FILE_LIMITS, normalizeSkillFilePath, createSkill, updateSkill, listSkillFileManifest, getSkillFiles, getSkillFile, upsertSkillFile, upsertSkillFiles, deleteSkillFile, deleteSkill, getSkillById, getSkillByName, listSkills, searchSkills, installSkill, getSystemDefaultSkills, installSystemDefaultSkillsForAgent, uninstallSkill, getAgentSkills, toggleAgentSkill, createMcpServer, updateMcpServer, deleteMcpServer, getMcpServerById, getMcpServerByName, listMcpServers, installMcpServer, uninstallMcpServer, getAgentMcpServers, createContextSnapshot, getContextSnapshotsByTaskId, getContextSnapshotsBySessionId, getContextSummaryByTaskId, getAvailableKeyIndices, recordKeyUsage, markKeyRateLimited, recordKeyRateLimitWindows, setApiKeyName, clearKeyRateLimit, getKeyStatuses, getKeyCostSummary, getUserById, getAllUsers, createUser, updateUser, deleteUser, listInboxState, upsertInboxState, listFavorites, listUserFavorites, getFavoriteItemIdSet, setFavorite, setUserFavorite, withFavoriteFlags, listTaskTemplates, getRootTaskChain, listRecentSessions, countSessions, getBudget, getBudgets, upsertBudget, deleteBudget, getAllPricingRows, getPricingRows, getActivePricingRow, insertPricingRow, deletePricingRow, getDailySpendForAgent, getDailySpendGlobal, getDailySpendForUser, recordBudgetRefusalNotification, getBudgetRefusalNotification, getRecentBudgetRefusalNotifications, hasBudgetRefusalNotificationToday, setBudgetRefusalFollowUpTaskId, getLiveAgentCounts, getInstanceActivity, getSwarmMetrics, hasFirstCompletedTask, getKv, upsertKv, deleteKv, KvTypeCollisionError, incrKv, listKv, countKv, createScriptRun, recordInlineScriptRun, getScriptRun, getScriptRunByIdempotencyKey, listScriptRuns, countScriptRuns, countActiveScriptRuns, updateScriptRun, getRunningScriptRuns, getScriptRunJournalStep, upsertScriptRunJournalStep, listScriptRunJournalSteps, countScriptRunJournalSteps, countScriptRunJournalAgentTaskSteps, exports_db, init_db };
+export { normalizeAssetKey, parseAssetKey, canWriteAssetKey, init_key, interpolate, deepInterpolate, init_template, registerTemplate, getTemplateDefinition, getAllTemplateDefinitions, init_registry, configureHttpResolver, resolveTemplate, resolveTemplateAsync, init_resolver, slackContextKey, agentmailContextKey, githubContextKey, gitlabContextKey, linearContextKey, buildJiraContextKey, scheduleContextKey, workflowContextKey, agentContextKey, pageContextKey, init_context_key, checkSlackRoutingCoherence, init_slack_routing, parseEnvFlag, isEnvFlagEnabled, init_env_flag, initTelemetry, telemetry, init_telemetry, AssetKeySchema, AssetEntityTypeSchema, ModelTierSchema, ReasoningEffortSchema, splitLegacyModelAlias, resolveTaskModelSelection, AgentTaskStatusSchema, isTerminalTaskStatus, AgentTaskSourceSchema, ProviderNameSchema, SteerModeSchema, SteeringSourceSchema, SteerOutcomeSchema, OnUnsupportedSchema, FollowUpConfigSchema, AttachmentInputSchema, InboxItemTypeSchema, InboxItemStatusSchema, FavoriteItemTypeSchema, TaskTemplateKindSchema, AgentStatusSchema, AgentAvatarSchema, AgentLatestModelSchema, AgentCredStatusSchema, ChannelTypeSchema, ServiceStatusSchema, ResumeReasonSchema, EventCategorySchema, EventStatusSchema, EventSourceSchema, EventNameSchema, ScheduledTaskTargetTypeSchema, SwarmConfigScopeSchema, RepoGuidelinesSchema, RepoHooksSchema, SwarmRepoSchema, AgentMemoryScopeSchema, AgentMemorySourceSchema, WorkflowDefinitionSchema, WorkflowNodePatchSchema, WorkflowPatchSchema, TriggerConfigSchema, CooldownConfigSchema, InputValueSchema, PageContentTypeSchema, PageAuthModeSchema, MetricDefinitionSchema, MetricVersionSchema, WorkflowRunStatusSchema, ScriptRunStatusSchema, TERMINAL_SCRIPT_RUN_STATUSES, PromptTemplateScopeSchema, PromptTemplateStateSchema, ScriptScopeSchema, ScriptFsModeSchema, ScriptApiAuthModeSchema, ContextSnapshotEventTypeSchema, ContextFormulaSchema, BudgetScopeSchema, BudgetSchema, PricingProviderSchema, PricingTokenClassSchema, PricingRowSchema, BudgetRefusalCauseSchema, BudgetRefusalNotificationSchema, KvValueTypeSchema, KvNamespaceSchema, KvKeySchema, init_types, setRequestAuth, getRequestAuth, getCurrentRequestAuth, init_request_auth_context, auditAssetKeys, init_asset_key_audit, CredentialBindingSchema, placeholderForConfigKey, CredentialBroker, DEFAULT_CREDENTIAL_BINDINGS, init_credential_broker, encryptSecret, decryptSecret, getEncryptionKey, init_crypto, normalizeDate, normalizeDateRequired, init_date_utils, init_session_templates, init_templates, init_templates2 as init_templates1, isSteeringEnabled, init_steering_enabled, SteeringRequestError, isSteeringEnabled2 as isSteeringEnabled1, getTaskSteeringFields, promotePendingSteeringForTask, markSteeringUndeliverable, requestSteering, init_steering, isReservedConfigKey, reservedKeyError, validateConfigValue, init_swarm_config_guard, onTaskStarted, init_task_lifecycle_events, generateDefaultClaudeMd, generateDefaultSoulMd, generateDefaultIdentityMd, generateDefaultToolsMd, init_defaults, isSqliteVecAvailable, initDb, getDb, closeDb, computeContentHash, createContextVersion, getLatestContextVersion, getContextVersion, getContextVersionHistory, agentQueries, updateAgentCredentialState, createAgent, getAgentById, getAllAgents, getLeadAgent, updateAgentStatus, updateAgentMaxTasks, updateAgentProvider, setAgentHarnessProvider, updateAgentCredStatus, listAgentsWithCredStatusByProvider, getAgentHarnessProviders, updateAgentActivity, MAX_EMPTY_POLLS, incrementEmptyPollCount, resetEmptyPollCount, shouldBlockPolling, deleteAgent, getActiveTaskCount, hasCapacity, getRemainingCapacity, updateAgentStatusFromCapacity, isPoolAffinityEnforcementEnabled, buildRoutingAffinityFromAgent, isAgentEligibleForTask, taskQueries, createTask, getPendingTaskForAgent, assignUnassignedTaskPending, startTask, getTaskById, markTaskSlackReplySent, setSlackMessageTracking, getChildTasks, hasNonTerminalResumeChild, hasNonTerminalRerouteDecisionChild, updateTaskClaudeSessionId, updateTaskTitle, updateTaskVcs, getTasksByAgentId, getAgentCurrentTask, getTasksByStatus, findTaskByVcs, findTaskByGitHub, getAllTasks, getTasksCount, getTaskStats, getCompletedSlackTasks, getRecentlyFinishedWorkerTasks, markTasksNotified, resetTasksNotified, getInProgressSlackTasks, getInProgressTasksByContextKey, findExistingLinearTrackerContextWork, getLatestTaskByContextKey, getAgentWorkingOnThread, getLatestActiveTaskInThread, getLatestLeadTaskInThread, getMostRecentTaskInThread, findCompletedTaskInThread, findRecentCancelledTaskInThread, completeTask, failTask, cancelTask, supersedeTask, backfillSupersedeTaskResumeTaskId, pauseTask, resumeTask, getPausedTasksForAgent, getOrphanedInProgressTasksForAgent, resetOrphanedInProgressTasksForAgent, getRecentlyCancelledTasksForAgent, deleteTask, updateTaskProgress, insertTaskAttachment, getAssetKeyMappingByProvider, upsertAssetKeyMapping, getAssetKeyMapping, listAssetSummaries, moveAssetKey, deleteTaskAttachment, replaceTaskAttachment, getTaskAttachments, createSteeringMessage, getSteeringMessagesForTask, getSteeringMessageById, getPendingSteeringForTask, getPendingSteeringForAgent, markSteeringDelivered, markSteeringHandled, markSteeringPromoted, cancelPendingSteeringForTask, hasPendingSteering, getAgentWithTasks, getAllAgentsWithTasks, logQueries, createLogEntry, getLogsByAgentId, getLogsByTaskId, getLogsByTaskIdChronological, getLogsByEventType, getAllLogs, findRecentSimilarTasks, createTaskExtended, claimTask, releaseTask, acceptTask, rejectTask, moveTaskToBacklog, moveTaskFromBacklog, releaseStaleReviewingTasks, getOfferedTasksForAgent, claimOfferedTask, getUnassignedTasksCount, getUnassignedTaskIds, getUnassignedTaskIdsForAgent, checkDependencies, getDependentTasks, cascadeFailDependents, updateAgentProfile, updateAgentName, createChannel, getMessageById, getChannelById, getChannelByName, getAllChannels, deleteChannel, postMessage, getChannelMessages, updateReadState, getLastReadAt, getUnreadMessages, getMentionsForAgent, getInboxSummary, claimMentions, releaseMentionProcessing, releaseStaleMentionProcessing, createService, getServiceById, getServiceByAgentAndName, getServicesByAgentId, getAllServices, updateServiceStatus, deleteService, upsertService, deleteServicesByAgentId, sessionLogQueries, createSessionLogs, getSessionLogsByTaskId, getSessionLogsBySession, createSessionCost, getSessionCostsByTaskId, getSessionCostsByAgentId, getAllSessionCosts, getSessionCostsFiltered, getSessionCostSummary, getDashboardCostSummary, createInboxMessage, getInboxMessageById, getUnreadInboxMessages, claimInboxMessages, markInboxMessageRead, markInboxMessageResponded, markInboxMessageDelegated, releaseStaleProcessingInbox, getConcurrentContext, getScheduledTasks, getScheduledTaskById, getScheduledTaskByName, createScheduledTask, updateScheduledTask, deleteScheduledTask, getDueScheduledTasks, autoEncryptLegacyPlaintextSecrets, maskSecrets, getSwarmConfigs, getInjectableGlobalConfigs, getSwarmConfigById, getSwarmConfigLookupById, upsertSwarmConfig, deleteSwarmConfig, deleteSwarmConfigByKey, getResolvedConfig, getSwarmRepos, getSwarmRepoById, getSwarmRepoByName, getSwarmRepoByUrl, createSwarmRepo, updateSwarmRepo, deleteSwarmRepo, getAgentMailInboxMapping, getAgentMailInboxMappingsByAgent, getAllAgentMailInboxMappings, createAgentMailInboxMapping, deleteAgentMailInboxMapping, findTaskByAgentMailThread, insertActiveSession, deleteActiveSession, deleteActiveSessionById, getActiveSessions, heartbeatActiveSession, cleanupStaleSessions, cleanupAgentSessions, updateActiveSessionProviderSessionId, getActiveSessionForTask, reassociateSessionLogs, getStalledInProgressTasks, getStalePinnedResumes, failPendingResumeIfUnclaimed, getIdleWorkersWithCapacity, getUnassignedPoolTasks, getStaleUnassignedAffinityTasks, getRecentFailedTasks, getRecentCompletedCount, getRecentFailedCount, createWorkflow, getWorkflow, listWorkflows, updateWorkflow, deleteWorkflow, getWorkflowsByScheduleId, createWorkflowRun, getWorkflowRun, updateWorkflowRun, listWorkflowRuns, countWorkflowRuns, listWorkflowRunsPage, createWorkflowRunStep, getWorkflowRunStep, updateWorkflowRunStep, getWorkflowRunStepsByRunId, getStuckWorkflowRuns, getLastSuccessfulRun, getLastRunStart, getRetryableSteps, getCompletedStepNodeIds, getTaskByWorkflowRunStepId, getStepByIdempotencyKey, getStepCountForNode, getLatestStepForNode, createWorkflowVersion, getWorkflowVersions, getWorkflowVersion, createPage, getPage, getPageBySlug, getLatestPageBySlug, listPagesByAgent, listAllPages, countAllPages, countPagesByAgent, updatePage, deletePage, incrementPageViewCount, createPageVersion, getPageVersions, getPageVersion, createMetric, getMetric, getMetricBySlug, listMetricsByAgent, listAllMetrics, countAllMetrics, countMetricsByAgent, updateMetric, deleteMetric, createMetricVersion, getMetricVersions, getMetricVersion, getPromptTemplates, getPromptTemplateById, upsertPromptTemplate, deletePromptTemplate, resetPromptTemplateToDefault, getPromptTemplateHistory, resolvePromptTemplate, checkoutPromptTemplate, getAllChannelActivityCursors, getChannelActivityCursor, upsertChannelActivityCursor, createApprovalRequest, getApprovalRequestById, resolveApprovalRequest, updateApprovalRequestNotifications, listApprovalRequests, getStuckApprovalRuns, getApprovalRequestByStepId, getExpiredPendingApprovals, createWaitState, getWaitStateById, getWaitStateByStepId, getDueWaitStates, getPendingEventWaitNames, getPendingWaitsByEvent, resolveWaitState, getStuckWaitRuns, SKILL_FILE_LIMITS, normalizeSkillFilePath, createSkill, updateSkill, listSkillFileManifest, getSkillFiles, getSkillFile, upsertSkillFile, upsertSkillFiles, deleteSkillFile, deleteSkill, getSkillById, getSkillByName, listSkills, searchSkills, installSkill, getSystemDefaultSkills, installSystemDefaultSkillsForAgent, uninstallSkill, getAgentSkills, toggleAgentSkill, createMcpServer, updateMcpServer, deleteMcpServer, getMcpServerById, getMcpServerByName, listMcpServers, installMcpServer, uninstallMcpServer, getAgentMcpServers, createContextSnapshot, getContextSnapshotsByTaskId, getContextSnapshotsBySessionId, getContextSummaryByTaskId, getAvailableKeyIndices, recordKeyUsage, markKeyRateLimited, recordKeyRateLimitWindows, setApiKeyName, clearKeyRateLimit, getKeyStatuses, getKeyCostSummary, getUserById, getAllUsers, createUser, updateUser, deleteUser, listInboxState, upsertInboxState, listFavorites, listUserFavorites, getFavoriteItemIdSet, setFavorite, setUserFavorite, withFavoriteFlags, listTaskTemplates, getRootTaskChain, listRecentSessions, countSessions, getBudget, getBudgets, upsertBudget, deleteBudget, getAllPricingRows, getPricingRows, getActivePricingRow, insertPricingRow, deletePricingRow, getDailySpendForAgent, getDailySpendGlobal, getDailySpendForUser, recordBudgetRefusalNotification, getBudgetRefusalNotification, getRecentBudgetRefusalNotifications, hasBudgetRefusalNotificationToday, setBudgetRefusalFollowUpTaskId, getLiveAgentCounts, getInstanceActivity, getSwarmMetrics, hasFirstCompletedTask, getKv, upsertKv, deleteKv, KvTypeCollisionError, incrKv, listKv, countKv, createScriptRun, recordInlineScriptRun, getScriptRun, getScriptRunByIdempotencyKey, listScriptRuns, countScriptRuns, countActiveScriptRuns, updateScriptRun, getRunningScriptRuns, getScriptRunJournalStep, upsertScriptRunJournalStep, listScriptRunJournalSteps, countScriptRunJournalSteps, countScriptRunJournalAgentTaskSteps, exports_db, init_db };

package/dist/{cli-vz9drmce.js → cli-5jn6wnd9.js}

@@ -2,7 +2,7 @@ import {
   getScriptApiTypes,
   getScriptMcpTypes,
   require_typescript
-} from "./cli-p11rf59d.js";
+} from "./cli-wn3m6q54.js";
 import {
   deleteSwarmConfigByKey,
   getAgentById,
@@ -11,7 +11,7 @@ import {
   getSwarmConfigs,
   init_db,
   upsertSwarmConfig
-} from "./cli-8cq4z4x7.js";
+} from "./cli-3z4q09tn.js";
 import {
   init_secret_scrubber,
   scrubSecrets
@@ -457,7 +457,7 @@ export interface SwarmSdk {
   // --- workflows ---
   workflow_list(args?: { enabled?: boolean; includeFull?: boolean; consecutiveErrorsMin?: number; lastRunStatus?: "running" | "waiting" | "completed" | "failed" | "skipped" | "cancelled" }): Promise<unknown>;
   workflow_get(args: { id: string }): Promise<unknown>;
-  workflow_listRuns(args: { workflowId: string; status?: "running" | "waiting" | "completed" | "failed" | "skipped" | "cancelled" }): Promise<unknown>;
+  workflow_listRuns(args: { workflowId: string; status?: "running" | "waiting" | "completed" | "failed" | "skipped" | "cancelled"; limit?: number; offset?: number }): Promise<unknown>;
   workflow_getRun(args: { id: string }): Promise<unknown>;
   // --- prompt templates ---
   prompt_list(args?: { eventType?: string; scope?: "global" | "agent" | "repo"; scopeId?: string; isDefault?: boolean }): Promise<unknown>;
@@ -646,6 +646,17 @@ export interface ScriptContext {
   logger: ScriptLogger;
 }
 
+/**
+ * A swarm script's default export. \`args\` comes FIRST, \`ctx\` second — never swap them.
+ *
+ * @example
+ * import type { ScriptContext } from "swarm-sdk";
+ *
+ * export default async function (args: { name: string }, ctx: ScriptContext) {
+ *   await ctx.logger.log(\`hello \${args.name}\`);
+ *   return { ok: true };
+ * }
+ */
 // biome-ignore lint/suspicious/noExplicitAny: scripts may narrow their args type at the entrypoint.
 export type ScriptMain = (args: any, ctx: ScriptContext) => unknown | Promise<unknown>;
 `;
@@ -1152,17 +1163,15 @@ void _scriptMain;
   });
   if (diagnostics.length === 0)
     return { ok: true };
-  const formatted = import_typescript.default.formatDiagnosticsWithColorAndContext(diagnostics, {
+  const formatHost = {
     getCanonicalFileName: (fileName) => fileName,
     getCurrentDirectory: () => "/virtual",
     getNewLine: () => `
 `
-  });
+  };
   return {
     ok: false,
-    diagnostics: formatted.split(`
-
-`).filter(Boolean),
+    diagnostics: diagnostics.map((diagnostic) => import_typescript.default.formatDiagnosticsWithColorAndContext([diagnostic], formatHost).trimEnd()),
     structured: diagnostics.map(toStructured)
   };
 }