@desplega.ai/agent-swarm 2.7.5 → 2.7.6

package/dist/index-4f2pvxae.js

@@ -0,0 +1,37 @@
+import {
+  getExecutorRegistry2,
+  initWorkflows2,
+  init_workflows
+} from "./cli-shpbx5ee.js";
+import"./cli-zbbwez0r.js";
+import"./cli-89knwags.js";
+import"./cli-c60vetmm.js";
+import"./cli-hr2e2fft.js";
+import"./cli-xnqgpshy.js";
+import"./cli-3xj33nrx.js";
+import"./cli-4necwtsv.js";
+import {
+  retryFailedRun2,
+  cancelWorkflowRun2
+} from "./cli-m48g6p95.js";
+import {
+  startWorkflowExecution2
+} from "./cli-8bc1w0tw.js";
+import"./cli-waqbxg08.js";
+import"./cli-gdhpcbhf.js";
+import"./cli-w6dt9ged.js";
+import"./cli-hgaazk69.js";
+import"./cli-yn4kxs06.js";
+import"./cli-drr5v6av.js";
+import"./cli-rmmmrjkd.js";
+import"./cli-k2gzwsj2.js";
+import"./cli-wx3rhnm0.js";
+init_workflows();
+
+export {
+  cancelWorkflowRun2 as cancelWorkflowRun,
+  getExecutorRegistry2 as getExecutorRegistry,
+  initWorkflows2 as initWorkflows,
+  retryFailedRun2 as retryFailedRun,
+  startWorkflowExecution2 as startWorkflowExecution
+};

package/dist/index-98gz7tmp.js

@@ -0,0 +1,30 @@
+import"./cli-ns59dc6r.js";
+import {
+  startHeartbeat2,
+  stopHeartbeat2
+} from "./cli-zm72anhg.js";
+import"./cli-8snvgs5r.js";
+import"./cli-xnrwazav.js";
+import"./cli-shpbx5ee.js";
+import"./cli-zbbwez0r.js";
+import"./cli-89knwags.js";
+import"./cli-c60vetmm.js";
+import"./cli-hr2e2fft.js";
+import"./cli-xnqgpshy.js";
+import"./cli-3xj33nrx.js";
+import"./cli-4necwtsv.js";
+import"./cli-m48g6p95.js";
+import"./cli-8bc1w0tw.js";
+import"./cli-waqbxg08.js";
+import"./cli-gdhpcbhf.js";
+import"./cli-w6dt9ged.js";
+import"./cli-hgaazk69.js";
+import"./cli-yn4kxs06.js";
+import"./cli-drr5v6av.js";
+import"./cli-rmmmrjkd.js";
+import"./cli-k2gzwsj2.js";
+import"./cli-wx3rhnm0.js";
+export {
+  startHeartbeat2 as startHeartbeat,
+  stopHeartbeat2 as stopHeartbeat
+};

package/dist/{index-5rk6rfzr.js → index-fvzke5kx.js}

@@ -45,7 +45,7 @@ import {
   require_lib,
   require_vary,
   require_express
-} from "./cli-gf5hbmdr.js";
+} from "./cli-yjdgea32.js";
 import {
   require_form_data,
   require_follow_redirects

package/dist/index-k08z2cak.js

@@ -0,0 +1,33 @@
+import {
+  calculateNextRun2,
+  startScheduler2,
+  stopScheduler2,
+  runScheduleNow2,
+  init_scheduler2
+} from "./cli-shpbx5ee.js";
+import"./cli-zbbwez0r.js";
+import"./cli-89knwags.js";
+import"./cli-c60vetmm.js";
+import"./cli-hr2e2fft.js";
+import"./cli-xnqgpshy.js";
+import"./cli-3xj33nrx.js";
+import"./cli-4necwtsv.js";
+import"./cli-m48g6p95.js";
+import"./cli-8bc1w0tw.js";
+import"./cli-waqbxg08.js";
+import"./cli-gdhpcbhf.js";
+import"./cli-w6dt9ged.js";
+import"./cli-hgaazk69.js";
+import"./cli-yn4kxs06.js";
+import"./cli-drr5v6av.js";
+import"./cli-rmmmrjkd.js";
+import"./cli-k2gzwsj2.js";
+import"./cli-wx3rhnm0.js";
+init_scheduler2();
+
+export {
+  calculateNextRun2 as calculateNextRun,
+  runScheduleNow2 as runScheduleNow,
+  startScheduler2 as startScheduler,
+  stopScheduler2 as stopScheduler
+};

package/dist/{index-yqhz88yy.js → index-pxn30mse.js}

@@ -49,14 +49,14 @@ import {
   init_dist
 } from "./cli-q26b9wre.js";
 import {
-  require_dist6,
+  require_dist7,
   require_is_electron,
   require_is_stream,
-  require_dist7,
-  require_eventemitter3,
   require_dist8,
+  require_eventemitter3,
+  require_dist9,
   require_src
-} from "./cli-w3hcrxht.js";
+} from "./cli-m2z8jagn.js";
 import {
   require_form_data,
   require_follow_redirects
@@ -593,8 +593,8 @@ var require_logger = __commonJS(function(exports) {
   Object.defineProperty(exports, "__esModule", { value: true });
   exports.LogLevel = undefined;
   exports.getLogger = getLogger;
-  var logger_1 = require_dist6();
-  var logger_2 = require_dist6();
+  var logger_1 = require_dist7();
+  var logger_2 = require_dist7();
   Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function() {
     return logger_2.LogLevel;
   } });
@@ -7073,7 +7073,7 @@ var require_methods = __commonJS(function(exports) {
     }
   }
   exports.Methods = Methods;
-  __exportStar(require_dist8(), exports);
+  __exportStar(require_dist9(), exports);
 });
 
 // node_modules/@chat-adapter/slack/node_modules/@slack/web-api/dist/WebClient.js
@@ -7215,7 +7215,7 @@ var require_WebClient = __commonJS(function(exports) {
   var form_data_1 = __importDefault(require_form_data());
   var is_electron_1 = __importDefault(require_is_electron());
   var is_stream_1 = __importDefault(require_is_stream());
-  var p_queue_1 = __importDefault(require_dist7());
+  var p_queue_1 = __importDefault(require_dist8());
   var p_retry_1 = __importStar(require_p_retry());
   var chat_stream_1 = require_chat_stream();
   var errors_1 = require_errors();

package/dist/{index-6rq3r5zb.js → index-q361cg2f.js}

@@ -21,7 +21,7 @@ import {
   require_scala,
   require_swift,
   require_typescript
-} from "./cli-vqypxzh4.js";
+} from "./cli-0at8w34w.js";
 import {
   __commonJS
 } from "./cli-242037k3.js";

package/dist/{index-7v51awbn.js → index-rvr00sg7.js}

@@ -17,13 +17,13 @@ import {
   deleteSkill2,
   getSkillByName2,
   init_db4
-} from "./cli-1ayk1eas.js";
-import"./cli-8hs41zy2.js";
+} from "./cli-k2gzwsj2.js";
+import"./cli-rmmmrjkd.js";
 import {
   agentFsProvisionSeeder
-} from "./cli-vbyfwh92.js";
-import"./cli-mmwm7zbf.js";
-import"./cli-wvaawacd.js";
+} from "./cli-xds5f77d.js";
+import"./cli-w6dt9ged.js";
+import"./cli-waqbxg08.js";
 import {
   buildSkillContent
 } from "./cli-691vz9mk.js";
@@ -48,11 +48,11 @@ import {
   init_typecheck,
   parseSkillContent,
   init_skill_parser
-} from "./cli-0bxqnvq9.js";
-import"./cli-7wcyk2s5.js";
-import"./cli-spknvxbq.js";
-import"./cli-pywf3eh5.js";
-import"./cli-bhjt02p8.js";
+} from "./cli-hr2e2fft.js";
+import"./cli-xnqgpshy.js";
+import"./cli-8bc1w0tw.js";
+import"./cli-hgaazk69.js";
+import"./cli-drr5v6av.js";
 import {
   __toESM
 } from "./cli-242037k3.js";
@@ -13066,7 +13066,11 @@ const REASON_PATTERNS: any[] = [
   { key: "context-window", re: /context (window|limit|saturat)|peakcontext|compact/i },
   { key: "reboot-sweep", re: /reboot sweep/i },
   { key: "not-found", re: /not found|404|missing|no such/i },
-  { key: "auth/credentials", re: /unauthorized|401|403|credential|token|forbidden/i },
+  {
+    key: "output-limit",
+    re: /\\bmax_(?:output_)?tokens\\b|\\b(?:maximum|max) output (?:length|tokens)\\b|\\boutput (?:token|length) limit\\b/i,
+  },
+  { key: "auth/credentials", re: /unauthorized|401|403|credential|\\btoken\\b|forbidden/i },
   { key: "ci/checks-failed", re: /\\bci\\b|check.?s? fail|lint|tsc|test.?s? fail/i },
   { key: "network", re: /network|econn|fetch failed|socket|dns|502|503|504/i },
   { key: "cancelled", re: /cancel|aborted/i },
@@ -14605,7 +14609,7 @@ var config_default14 = `{
 `;
 
 // templates/skills/composio-google-docs/content.md
-var content_default14 = '# Composio · Google Docs\n\nToolkit slug: **`googledocs`**. Read the [[composio]] hub first for the call model.\nA document is identified by its `document_id` (the id in the Docs URL).\n\n```bash\nagent-swarm x composio POST /tools/execute/<SLUG> \\\n  --body \'{"user_id":"<connected-account-email>","connected_account_id":"<active-connected-account-id>","arguments":{ … }}\'\n```\n\nFollow the hub\'s **Resolve the user and connected account** procedure, then\nselect the resolved user\'s `googledocs` account whose status is `ACTIVE`.\n\n## Headline tools\n\n| Slug | What | Key args |\n|---|---|---|\n| `GOOGLEDOCS_SEARCH_DOCUMENTS` | Find docs (Drive search) | `query`, `max_results` (def 10), `order_by` (def `modifiedTime desc`), `modified_after`, `created_after`, `starred_only`, `shared_with_me`, `response_detail` (def `minimal`) |\n| `GOOGLEDOCS_GET_DOCUMENT_PLAINTEXT` | Read doc as text | **`document_id`**, `include_tables` (def true), `include_headers`, `include_footers`, `include_footnotes`, `include_tabs_content` |\n| `GOOGLEDOCS_GET_DOCUMENT_BY_ID` | Full structured doc JSON | `document_id` |\n| `GOOGLEDOCS_CREATE_DOCUMENT` | Create blank/with text | `title`, `text` |\n| `GOOGLEDOCS_CREATE_DOCUMENT_MARKDOWN` | Create from markdown | **`title`**, `markdown_text`, `image_assets` |\n| `GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN` | Replace body with markdown | `document_id`, `markdown_text` |\n| `GOOGLEDOCS_INSERT_TEXT_ACTION` | Insert text at index | `document_id`, `text`, `index` |\n| `GOOGLEDOCS_REPLACE_ALL_TEXT` | Find & replace | `document_id`, `find`, `replace` |\n| `GOOGLEDOCS_COPY_DOCUMENT` | Duplicate a doc | `document_id`, `title` |\n| `GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF` | Export to PDF | `document_id` |\n\nFull set: 35 tools — `agent-swarm x composio GET "/tools?toolkit_slug=googledocs&limit=100" | jq -r \'.items[]|"\\(.slug)\\t\\(.name)"\'`.\nPrefer the `*_MARKDOWN` create/update tools for authoring; the granular\n`INSERT_*`/`DELETE_*`/table tools are for surgical structural edits.\n\n## Search recipe\n\n```bash\nagent-swarm x composio POST /tools/execute/GOOGLEDOCS_SEARCH_DOCUMENTS \\\n  --body \'{"connected_account_id":"ca_…","arguments":{"query":"workshop","max_results":5}}\'\n# → results under .data.files[]  (id, name, modifiedTime …)\n```\n- Results are Drive file entries at **`.data.files[]`** — grab `.id` to read.\n- `order_by` defaults to `modifiedTime desc` (most recent first).\n- Use `modified_after` / `shared_with_me` to narrow.\n\n## Read recipe\n\n```bash\nagent-swarm x composio POST /tools/execute/GOOGLEDOCS_GET_DOCUMENT_PLAINTEXT \\\n  --body \'{"connected_account_id":"ca_…","arguments":{"document_id":"<id>","include_tables":true}}\'\n```\nUse `GET_DOCUMENT_PLAINTEXT` for reading content; only reach for\n`GET_DOCUMENT_BY_ID` when you need the structured JSON (styles, indices) for an\nedit.\n\n## Create-from-markdown recipe\n\n```bash\nagent-swarm x composio POST /tools/execute/GOOGLEDOCS_CREATE_DOCUMENT_MARKDOWN \\\n  --body \'{"connected_account_id":"ca_…","arguments":{\n    "title":"Weekly updates","markdown_text":"# Heading\\n\\n- point one\\n- point two"\n  }}\'\n```\n\n## Google Doc to agent-fs\n\n1. Read the source with `GOOGLEDOCS_GET_DOCUMENT_PLAINTEXT` and retain its\n   returned title and display URL as provenance.\n2. Write the converted content to your own agent-fs namespace with a short\n   provenance header naming the source document and import method.\n3. Resolve the destination org and drive from the environment or\n   `agent-fs stat <path> --json`; the `agent-fs` skill documents the canonical\n   storage and share-link workflow. Never copy org or drive IDs from an example.\n4. Read the stored file back and assert several markers: the title, a middle\n   phrase, and the final sentence. A successful byte-count response alone does\n   not prove fidelity.\n\nPlaintext is intentionally lossy. Inline images may become bare `[IMAGE]`\nmarkers, and headings may be flattened into adjacent paragraphs. If those\nfeatures matter, use `GOOGLEDOCS_GET_DOCUMENT_BY_ID` for structured JSON or a\nGoogle Drive export, then preserve or reconstruct the structure explicitly.\nThere is no `GET_DOCUMENT_MARKDOWN` tool; markdown exists on create/update, not\non read.\n\n## Gotchas\n\n- Search returns Drive metadata, not document content — do a second\n  `GET_DOCUMENT_PLAINTEXT` call with the `.id` to read.\n- Doc bodies can be long/token-heavy and may contain secrets — read only what you\n  need (`include_headers/footers/footnotes` default off for a reason).\n- Create/update/replace are **write actions** — only on explicit request.\n';
+var content_default14 = '# Composio · Google Docs\n\nToolkit slug: **`googledocs`**. Read the [[composio]] hub first for the call model.\nA document is identified by its `document_id` (the id in the Docs URL).\n\n```bash\nagent-swarm x composio POST /tools/execute/<SLUG> \\\n  --body \'{"user_id":"<connected-account-email>","connected_account_id":"<active-connected-account-id>","arguments":{ … }}\'\n```\n\nFollow the hub\'s **Resolve the user and connected account** procedure, then\nselect the resolved user\'s `googledocs` account whose status is `ACTIVE`.\n\n## Headline tools\n\n| Slug | What | Key args |\n|---|---|---|\n| `GOOGLEDOCS_SEARCH_DOCUMENTS` | Find docs (Drive search) | `query`, `max_results` (def 10), `order_by` (def `modifiedTime desc`), `modified_after`, `created_after`, `starred_only`, `shared_with_me`, `response_detail` (def `minimal`) |\n| `GOOGLEDOCS_GET_DOCUMENT_PLAINTEXT` | Read doc as text | **`document_id`**, `include_tables` (def true), `include_headers`, `include_footers`, `include_footnotes`, `include_tabs_content` |\n| `GOOGLEDOCS_GET_DOCUMENT_BY_ID` | Full structured doc JSON | `document_id` |\n| `GOOGLEDOCS_CREATE_DOCUMENT` | Create blank/with text | `title`, `text` |\n| `GOOGLEDOCS_CREATE_DOCUMENT_MARKDOWN` | Create from markdown | **`title`**, `markdown_text`, `image_assets` |\n| `GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN` | Replace body with markdown | `document_id`, `markdown_text` |\n| `GOOGLEDOCS_INSERT_TEXT_ACTION` | Insert text at index | `document_id`, `text`, `index` |\n| `GOOGLEDOCS_REPLACE_ALL_TEXT` | Find & replace | `document_id`, `find`, `replace` |\n| `GOOGLEDOCS_COPY_DOCUMENT` | Duplicate a doc | `document_id`, `title` |\n| `GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF` | Export to PDF | `document_id` |\n\nFull set: 35 tools — `agent-swarm x composio GET "/tools?toolkit_slug=googledocs&limit=100" | jq -r \'.items[]|"\\(.slug)\\t\\(.name)"\'`.\nPrefer the `*_MARKDOWN` create/update tools for authoring; the granular\n`INSERT_*`/`DELETE_*`/table tools are for surgical structural edits.\n\n## Search recipe\n\n```bash\nagent-swarm x composio POST /tools/execute/GOOGLEDOCS_SEARCH_DOCUMENTS \\\n  --body \'{"connected_account_id":"ca_…","arguments":{"query":"workshop","max_results":5}}\'\n# → results under .data.files[]  (id, name, modifiedTime …)\n```\n- Results are Drive file entries at **`.data.files[]`** — grab `.id` to read.\n- `order_by` defaults to `modifiedTime desc` (most recent first).\n- Use `modified_after` / `shared_with_me` to narrow.\n\n## Read recipe\n\n```bash\nagent-swarm x composio POST /tools/execute/GOOGLEDOCS_GET_DOCUMENT_PLAINTEXT \\\n  --body \'{"connected_account_id":"ca_…","arguments":{"document_id":"<id>","include_tables":true}}\'\n```\nUse `GET_DOCUMENT_PLAINTEXT` for reading content; only reach for\n`GET_DOCUMENT_BY_ID` when you need the structured JSON (styles, indices) for an\nedit.\n\n## Create-from-markdown recipe\n\n```bash\nagent-swarm x composio POST /tools/execute/GOOGLEDOCS_CREATE_DOCUMENT_MARKDOWN \\\n  --body \'{"connected_account_id":"ca_…","arguments":{\n    "title":"Weekly updates","markdown_text":"# Heading\\n\\n- point one\\n- point two"\n  }}\'\n```\n\n## Google Doc to agent-fs\n\n1. Read the source with `GOOGLEDOCS_GET_DOCUMENT_PLAINTEXT` and retain its\n   returned title and display URL as provenance.\n2. Write the converted content to your own agent-fs namespace with a short\n   provenance header naming the source document and import method.\n3. Resolve the destination org and drive from the environment or\n   `agent-fs stat <path> --json`; the `agent-fs` skill documents the canonical\n   storage and share-link workflow. Never copy org or drive IDs from an example.\n4. Read the stored file back and assert several markers: the title, a middle\n   phrase, and the final sentence. A successful byte-count response alone does\n   not prove fidelity.\n\nPlaintext is intentionally lossy. Inline images may become bare `[IMAGE]`\nmarkers, and headings may be flattened into adjacent paragraphs. If those\nfeatures matter, use `GOOGLEDOCS_GET_DOCUMENT_BY_ID` for structured JSON or a\nGoogle Drive export, then preserve or reconstruct the structure explicitly.\nThere is no `GET_DOCUMENT_MARKDOWN` tool; markdown exists on create/update, not\non read.\n\n## Comments\n\nDoc comments are a Drive feature, not a Docs one: there is no `GOOGLEDOCS_*`\ncomment slug. List them with `GOOGLEDRIVE_LIST_COMMENTS` (replies:\n`GOOGLEDRIVE_LIST_REPLIES`) from the `googledrive` toolkit, so resolve the\nuser\'s `googledrive` connected account instead of their `googledocs` one.\nListing only works when the Drive read scopes are authorized on that account.\n`GOOGLEDRIVE_CREATE_COMMENT` and the update/delete tools are write actions,\nonly on explicit request.\n\n## Gotchas\n\n- Search returns Drive metadata, not document content — do a second\n  `GET_DOCUMENT_PLAINTEXT` call with the `.id` to read.\n- Doc bodies can be long/token-heavy and may contain secrets — read only what you\n  need (`include_headers/footers/footnotes` default off for a reason).\n- Create/update/replace are **write actions** — only on explicit request.\n';
 
 // templates/skills/db-query-guidance/config.json
 var config_default15 = `{
@@ -18703,7 +18707,7 @@ var config_default41 = `{
 `;
 
 // templates/skills/script-workflows/content.md
-var content_default41 = "Use this skill when a user asks to launch, monitor, inspect, or debug a durable script workflow run. This is for the Script Workflows v1 runtime: one-off TypeScript workflow source with journaled `swarm-script`, `raw-llm`, and `agent-task` steps.\n\n## Tool Flow\n\nLoad the script workflow tools with ToolSearch when they are not already visible:\n\n```text\nlaunch-script-run\nget-script-run\nlist-script-runs\n```\n\nUse `launch-script-run` to start a one-off run. It calls the same `/api/script-runs` API as the dashboard, preserves the invoking agent identity, and starts the run in the background.\n\nUse `get-script-run` to read terminal status and journal entries. Poll it when needed, but keep polling bounded and report progress for long runs.\n\nUse `list-script-runs` to find recent runs or filter by `status` / `agentId`.\n\nDo not hand-roll raw HTTP for this flow unless the tool itself is broken and you are explicitly debugging the API. The tool handles auth and `X-Agent-ID` like the existing inline `script-run` tool family.\n\n## Source Shape\n\nAuthor TypeScript workflow source as a default export. The runtime provides `args` and `ctx`.\n\n```ts\nexport default async function main(args, ctx) {\n  const lookup = await ctx.step.swarmScript(\"lookup-data\", {\n    scriptName: \"fetch-readable\",\n    args: { url: args.url },\n  });\n\n  const summary = await ctx.step.rawLlm(\"summarize\", {\n    prompt: `Summarize this for an operator:\\n${JSON.stringify(lookup)}`,\n  });\n\n  const task = await ctx.step.agentTask(\"operator-review\", {\n    task: `Review this summary and flag risks:\\n${JSON.stringify(summary)}`,\n    tags: [\"script-run\"],\n    priority: 50,\n  });\n\n  return { lookup, summary, task };\n}\n```\n\n`ctx.step.agentTask` blocks until the dispatched task reaches a terminal status (default `waitForCompletion: true`, default `timeoutMs` 2h) and journals its real output — a sequential `plan → implement → review` chain will not fan out. Pass `waitForCompletion: false` for the legacy fire-and-poll-yourself shape, or `failOnTaskFailure: false` to receive `{taskId, status: \"failed\", error}` instead of a throw when the task fails/is cancelled.\n\n## Label Rules\n\nStep labels are durability keys. They must be stable and unique for each logical step. Do not reuse the same literal label inside a loop; launch will fail with `label_lint_violation`.\n\nFor looped work, include an item identifier in the label:\n\n```ts\nfor (const item of args.items) {\n  await ctx.step.agentTask(`review-${item.id}`, { task: item.prompt });\n}\n```\n\n## Statuses\n\nTerminal statuses to surface clearly:\n\n- `completed` — run finished and `output` may be present.\n- `failed` — run ended with `error`.\n- `cancelled` — run was cancelled before completion.\n- `aborted_limit` — runtime guardrail stopped the run, usually step count, agent-task count, or wall-clock cap.\n- `label_lint_violation` — launch-time rejection, not a persisted run status.\n\nWhen a run is not terminal, report the current status, journal count, and latest heartbeat if present.\n";
+var content_default41 = "Use this skill when a user asks to launch, monitor, inspect, or debug a durable script workflow run. This is for the Script Workflows v1 runtime: one-off TypeScript workflow source with journaled `swarm-script`, `raw-llm`, and `agent-task` steps.\n\n## Tool Flow\n\nLoad the script workflow tools with ToolSearch when they are not already visible:\n\n```text\nlaunch-script-run\nget-script-run\nlist-script-runs\n```\n\nUse `launch-script-run` to start a one-off run. It calls the same `/api/script-runs` API as the dashboard, preserves the invoking agent identity, and starts the run in the background.\n\nUse `get-script-run` to read terminal status and journal entries. Poll it when needed, but keep polling bounded and report progress for long runs.\n\nUse `list-script-runs` to find recent runs or filter by `status` / `agentId`.\n\nDo not hand-roll raw HTTP for this flow unless the tool itself is broken and you are explicitly debugging the API. The tool handles auth and `X-Agent-ID` like the existing inline `script-run` tool family.\n\n## Source Shape\n\nAuthor TypeScript workflow source as a default export. The runtime provides `args` and `ctx`.\n\n```ts\nexport default async function main(args, ctx) {\n  const lookup = await ctx.step.swarmScript(\"lookup-data\", {\n    scriptName: \"fetch-readable\",\n    args: { url: args.url },\n  });\n\n  const summary = await ctx.step.rawLlm(\"summarize\", {\n    prompt: `Summarize this for an operator:\\n${JSON.stringify(lookup)}`,\n  });\n\n  const task = await ctx.step.agentTask(\"operator-review\", {\n    task: `Review this summary and flag risks:\\n${JSON.stringify(summary)}`,\n    tags: [\"script-run\"],\n    priority: 50,\n  });\n\n  return { lookup, summary, task };\n}\n```\n\n`ctx.step.agentTask` blocks until the dispatched task reaches a terminal status (default `waitForCompletion: true`, default `timeoutMs` 2h) and journals its real output — a sequential `plan → implement → review` chain will not fan out. Pass `failOnTaskFailure: false` to receive `{taskId, status: \"failed\", error}` instead of a throw when the task fails/is cancelled.\n\nA run launched from a `follow-up` task in a Slack thread passes the same re-delegation guard as `send-task`, decided once for the whole run at its first new step: a step that repeats completed thread work, or a run past the thread's dispatch cap (a run counts once), throws with the rule's message, and every later new step of that run throws too. Pass `allowRedelegation: true` on a step only for a deliberate re-run. Do not wrap a single dispatch in a durable run; use `send-task`.\n\n`waitForCompletion: false` does not return right after dispatch. The first call still waits up to ~30s while the server polls the task, then returns one of three shapes:\n\n- The task finished in that window: its output string or `null`, as on success.\n- The task failed or was cancelled in that window: a throw, or `{taskId, status: \"failed\", error}` with `failOnTaskFailure: false`.\n- The task is still running: `{taskId, status}`.\n\nOn success, `ctx.step.agentTask` resolves to the worker's output string (JSON text under `outputSchema`, so parse it yourself; `null` when the task stored none), not a task record. On a string, `step.taskId` and `step.status` are undefined, so a guard such as `step.status !== \"completed\"` or `step?.taskId ?? \"unknown\"` silently misfires. On `null`, `step.taskId` throws a TypeError. Only `failOnTaskFailure: false` with a failed or cancelled task returns `{taskId, status: \"failed\", error}`, and only `waitForCompletion: false` on a task still running returns `{taskId, status}`. To get a step's task id, query by its context key (the label is the step label you passed):\n\n```sql\nSELECT id, status, output FROM agent_tasks\nWHERE contextKey = 'script-run:<runId>:<label>' AND taskType = 'script-run-step'\nORDER BY createdAt DESC, rowid DESC LIMIT 1\n```\n\nInside the run, `<runId>` is `ctx.run.id`.\n\n## Label Rules\n\nStep labels are durability keys. They must be stable and unique for each logical step. Do not reuse the same literal label inside a loop; launch will fail with `label_lint_violation`.\n\nFor looped work, include an item identifier in the label:\n\n```ts\nfor (const item of args.items) {\n  await ctx.step.agentTask(`review-${item.id}`, { task: item.prompt });\n}\n```\n\n## Statuses\n\nTerminal statuses to surface clearly:\n\n- `completed` — run finished and `output` may be present.\n- `failed` — run ended with `error`.\n- `cancelled` — run was cancelled before completion.\n- `aborted_limit` — runtime guardrail stopped the run, usually step count, agent-task count, or wall-clock cap.\n- `label_lint_violation` — launch-time rejection, not a persisted run status.\n\nWhen a run is not terminal, report the current status, journal count, and latest heartbeat if present.\n";
 
 // templates/skills/slack-interaction/config.json
 var config_default42 = '{\n  "kind": "skill",\n  "name": "slack-interaction",\n  "displayName": "Slack Interaction",\n  "slug": "slack-interaction",\n  "title": "Slack Interaction",\n  "description": "Slack: reply, post, read, upload, and the thread rules. What the engine already posts, the one-message rule, `slack-reply`, `slack-post`, `slack-start-thread`, `slack-read`, `slack-upload-file`, `slack-download-file`, `slack-list-channels`, `slack-update`, `slack-delete`, unknown-user registration with `manage-user`, and Slack standing orders. Use before any Slack message.",\n  "version": "1.0.0",\n  "category": "skills",\n  "placeholders": [],\n  "runAllSeedersCandidate": true,\n  "systemDefault": true,\n  "tags": ["slack", "communication"]\n}\n';
@@ -18846,6 +18850,7 @@ Fetch the page as markdown: \`curl -fsSL https://docs.agent-swarm.dev/llms.mdx/d
 - [One-off Script Workflow Runs](https://docs.agent-swarm.dev/docs/guides/script-workflow-runs). Reference.
 - [Dreaming](https://docs.agent-swarm.dev/docs/guides/dreaming). When: Someone asks what the nightly dreaming run changed, how to configure or turn it off, or how to undo one of its changes.
 - [Claude Bridge](https://docs.agent-swarm.dev/docs/guides/claude-bridge-experimental). Reference.
+- [Reading claude.ai Artifacts headless](https://docs.agent-swarm.dev/docs/guides/claude-artifacts-read). When: Someone wants an agent to read a claude.ai Artifact link, such as a design and its canvas.json, from a headless session.
 - [Worker Credential Recovery](https://docs.agent-swarm.dev/docs/guides/worker-credential-recovery). Reference.
 - [Model Gateways](https://docs.agent-swarm.dev/docs/guides/provider-auth/model-gateways). Reference.
 - [Codex OAuth](https://docs.agent-swarm.dev/docs/guides/provider-auth/codex-oauth). Reference.
@@ -19125,6 +19130,8 @@ Named script only when the logic will run two or more times, by you, another age
 
 Reference point: a workflow triage that took about 26 tool calls returns as one result of about 4k tokens in about 13 seconds.
 
+Pick the run mode before you author. A short inline \`script-run\` is for small lookups only. A job that scans a whole population or may run past the inline cap of about 30 s starts as a durable \`launch-script-run\` from the start. A single \`ctx.step.swarmScript\` step has the same cap, so collect in bounded steps: each step takes a cursor, collects one slice in well under 30 s, and returns its rows plus the next cursor. Label each step with its slice (\`collect-\${page}\`) so the journal checkpoints it, then compute from the collected slices in a final step. Restarting a long inline run throws away the work it already did.
+
 ## Loading the tools
 
 The script tools are deferred. Load them with your harness tool search before the first call: \`script-search\`, \`script-run\`, \`script-upsert\`, \`script-query-types\`, \`script-delete\`, and for durable runs \`launch-script-run\`, \`get-script-run\`, \`list-script-runs\`.

package/dist/{index-q4b917zs.js → index-vdygbq10.js}

@@ -3,7 +3,7 @@ import {
   resetEmbeddingProvider2,
   getMemoryStore2,
   init_memory
-} from "./cli-1ayk1eas.js";
+} from "./cli-k2gzwsj2.js";
 init_memory();
 
 export {

package/dist/{keepalive-6cf311t5.js → keepalive-w56f32cg.js}

@@ -1,11 +1,11 @@
 import {
   listKeepAliveAuthorizations,
   init_oauth
-} from "./cli-1ayk1eas.js";
+} from "./cli-k2gzwsj2.js";
 import {
   ensureAuthorizationTokenOrThrow,
   init_ensure_token
-} from "./cli-7wcyk2s5.js";
+} from "./cli-xnqgpshy.js";
 import {
   scrubSecrets,
   init_secret_scrubber
@@ -59,7 +59,7 @@ async function notifySlack(text) {
     return;
   }
   try {
-    const { getSlackApp } = await import("./app-vmp4fgep.js");
+    const { getSlackApp } = await import("./app-909e97cr.js");
     const app = getSlackApp();
     if (!app) {
       console.warn("[OAuth Keepalive] Slack not available, cannot send notification");

package/dist/{lead-fjy418cw.js → lead-enq35nqp.js}

@@ -1,57 +1,58 @@
-import"./cli-1ayk1eas.js";
-import"./cli-8hs41zy2.js";
-import"./cli-6s7vdcta.js";
-import"./cli-nn4d8dne.js";
+import"./cli-k2gzwsj2.js";
+import"./cli-rmmmrjkd.js";
+import"./cli-zbbwez0r.js";
+import"./cli-89knwags.js";
 import"./cli-wx3rhnm0.js";
-import"./cli-mmwm7zbf.js";
-import"./cli-wvaawacd.js";
-import"./cli-g61qxmge.js";
+import"./cli-w6dt9ged.js";
+import"./cli-waqbxg08.js";
+import"./cli-m48g6p95.js";
 import {
   getEnabledCapabilities,
   init_server
-} from "./cli-1338796d.js";
+} from "./cli-shpbx5ee.js";
 import"./cli-3xj33nrx.js";
-import"./cli-mry0qzym.js";
-import"./cli-z8eh3ex8.js";
-import"./cli-rhw40jgb.js";
+import"./cli-yn4kxs06.js";
+import"./cli-4necwtsv.js";
+import"./cli-bjb3z51z.js";
 import"./cli-ftyxyspd.js";
 import {
   runAgent
-} from "./cli-nzxr556s.js";
+} from "./cli-es6va8jk.js";
 import"./cli-98rw5dt5.js";
 import"./cli-77cd6gy8.js";
 import"./cli-mthwvjre.js";
 import"./cli-a22h291q.js";
 import"./cli-dhar9qay.js";
 import"./cli-jc1g9ndz.js";
-import"./cli-afrrppsw.js";
+import"./cli-nwj0ee2w.js";
 import"./cli-jm2vfpfd.js";
-import"./cli-a47xy8eq.js";
+import"./cli-faxe6thg.js";
 import"./cli-d82btycs.js";
 import"./cli-0726awxw.js";
-import"./cli-0731hvbw.js";
-import"./cli-82ae98pz.js";
+import"./cli-decfb6v8.js";
+import"./cli-svj5090z.js";
 import"./cli-4bd1rck6.js";
 import"./cli-98rwmcyc.js";
 import"./cli-318r69gq.js";
 import"./cli-vfym7wmz.js";
 import"./cli-kr5tjjtz.js";
-import"./cli-7a42nfy0.js";
-import"./cli-j3jvnpe8.js";
+import"./cli-0qatpy8q.js";
+import"./cli-wp9sp1qb.js";
 import"./cli-srye3vdt.js";
-import"./cli-bnz7a7qf.js";
-import"./cli-rm6hqj3z.js";
-import"./cli-hn9hxmz9.js";
-import"./cli-zppwg9p9.js";
-import"./cli-zh3fp8v2.js";
-import"./cli-5pag6rmn.js";
+import"./cli-vvpx3gsx.js";
+import"./cli-pd7vagab.js";
+import"./cli-yx4kfngt.js";
+import"./cli-ekwks2vs.js";
+import"./cli-54t00gt8.js";
+import"./cli-3ypk9vk1.js";
 import"./cli-4zsenjhy.js";
-import"./cli-xtjhfmpc.js";
-import"./cli-0bxqnvq9.js";
-import"./cli-7wcyk2s5.js";
-import"./cli-spknvxbq.js";
-import"./cli-pywf3eh5.js";
-import"./cli-bhjt02p8.js";
+import"./cli-c60vetmm.js";
+import"./cli-hr2e2fft.js";
+import"./cli-xnqgpshy.js";
+import"./cli-8bc1w0tw.js";
+import"./cli-gdhpcbhf.js";
+import"./cli-hgaazk69.js";
+import"./cli-drr5v6av.js";
 
 // src/commands/lead.ts
 init_server();

package/dist/{maintenance-a4bm1bmt.js → maintenance-7mdgxcea.js}

@@ -1,7 +1,7 @@
 import {
   reembedAllScripts2,
   init_embeddings
-} from "./cli-1ayk1eas.js";
+} from "./cli-k2gzwsj2.js";
 
 // src/be/scripts/maintenance.ts
 init_embeddings();

package/dist/{oauth-refresh-sweep-3h0dfw1k.js → oauth-refresh-sweep-29txy9vk.js}

@@ -2,11 +2,11 @@ import {
   getAuthorizationById,
   listAuthorizationSweepRows,
   init_oauth
-} from "./cli-1ayk1eas.js";
+} from "./cli-k2gzwsj2.js";
 import {
   forceRefreshAuthorizationOrThrow,
   init_ensure_token
-} from "./cli-7wcyk2s5.js";
+} from "./cli-xnqgpshy.js";
 import {
   isEnvFlagEnabled,
   init_env_flag

package/dist/{onboard-myn5hraa.js → onboard-kpsrkarj.js}

@@ -7,16 +7,16 @@ import {
   Select,
   Spinner,
   TextInput
-} from "./cli-82jg7fp9.js";
+} from "./cli-he5nxaa8.js";
 import {
   require_jsx_dev_runtime
-} from "./cli-kg8hchyg.js";
+} from "./cli-sa02jsqt.js";
 import {
   SERVER_NAME,
   createDefaultSettingsLocal,
   createDefaultMcpJson,
   createHooksConfig
-} from "./cli-p599f1qm.js";
+} from "./cli-0yv5z2pg.js";
 import {
   getSlackConfiguration,
   isSlackConfigured,
@@ -25,7 +25,7 @@ import {
 import {
   init_package,
   package_default
-} from "./cli-tqgg40ek.js";
+} from "./cli-e3r2neck.js";
 import {
   getApiKey,
   init_api_key

package/dist/{opencode-adapter-p2nkb5am.js → opencode-adapter-j25vm3rr.js}

@@ -3,11 +3,11 @@ import {
   applyOpenRouterBaseUrlOverride2,
   buildOpenAICompatibleProviderBlock2,
   OpencodeAdapter2
-} from "./cli-zppwg9p9.js";
-import"./cli-hn9hxmz9.js";
+} from "./cli-ekwks2vs.js";
+import"./cli-yx4kfngt.js";
 import"./cli-4bd1rck6.js";
 import"./cli-jc1g9ndz.js";
-import"./cli-a47xy8eq.js";
+import"./cli-faxe6thg.js";
 import"./cli-0726awxw.js";
 import"./cli-dhar9qay.js";
 import"./cli-98rw5dt5.js";

package/dist/{otel-impl-a1a0ef6b.js → otel-impl-6kkct7a8.js}

@@ -17,7 +17,7 @@ import {
 import {
   init_package,
   package_default
-} from "./cli-tqgg40ek.js";
+} from "./cli-e3r2neck.js";
 import {
   scrubSecrets,
   init_secret_scrubber

package/dist/{pi-mono-adapter-rzmpb72a.js → pi-mono-adapter-exhkzhn2.js}

@@ -11,7 +11,7 @@ import {
   createCodemodeExtension,
   createMcpExtension,
   createToolSearchExtension
-} from "./cli-vqypxzh4.js";
+} from "./cli-0at8w34w.js";
 import {
   contextBoundNoteThreshold,
   createContextBoundNote
@@ -22,8 +22,8 @@ import {
 import"./cli-0726awxw.js";
 import {
   createSwarmHooksExtension
-} from "./cli-hn9hxmz9.js";
-import"./cli-a47xy8eq.js";
+} from "./cli-yx4kfngt.js";
+import"./cli-faxe6thg.js";
 import {
   applyReasoningEffort
 } from "./cli-98rw5dt5.js";
@@ -47,7 +47,7 @@ import {
   getBuiltinModel,
   getBuiltinModels,
   init_all
-} from "./cli-qxnf8z2z.js";
+} from "./cli-436532ck.js";
 import {
   buildPoolRevalidationFailureReason,
   getValidCodexOAuth,

package/dist/{pricing-refresh-83drrnxj.js → pricing-refresh-n2x7jh6k.js}

@@ -2,9 +2,9 @@ import {
   requestModelCatalogRefresh2,
   startPricingRefreshLoop2,
   init_pricing_refresh
-} from "./cli-nn4d8dne.js";
-import"./cli-xtjhfmpc.js";
-import"./cli-1ayk1eas.js";
+} from "./cli-89knwags.js";
+import"./cli-c60vetmm.js";
+import"./cli-k2gzwsj2.js";
 init_pricing_refresh();
 
 export {

package/dist/{rbac-roles-s8y6ecb5.js → rbac-roles-81ypx6es.js}

@@ -3,7 +3,7 @@ import {
   getDbClient2,
   init_telemetry_identity,
   init_db4
-} from "./cli-1ayk1eas.js";
+} from "./cli-k2gzwsj2.js";
 import {
   PermissionVerbSchema,
   init_rbac

package/dist/{rbac-roles-0fb6e7pj.js → rbac-roles-b5htkjby.js}

@@ -9,8 +9,8 @@ import {
   setUserRoles2,
   ensureRbacSeedsSynced2,
   init_rbac_roles
-} from "./cli-8hs41zy2.js";
-import"./cli-1ayk1eas.js";
+} from "./cli-rmmmrjkd.js";
+import"./cli-k2gzwsj2.js";
 init_rbac_roles();
 
 export {

package/dist/{render-v2-twmbgrz4.js → render-v2-qn6jmpk4.js}

@@ -5,9 +5,9 @@ import {
   slackErrorCode2,
   processSlackRenderV22,
   init_render_v2
-} from "./cli-wvaawacd.js";
-import"./cli-mmwm7zbf.js";
-import"./cli-1ayk1eas.js";
+} from "./cli-waqbxg08.js";
+import"./cli-w6dt9ged.js";
+import"./cli-k2gzwsj2.js";
 init_render_v2();
 
 export {

package/dist/{resume-zfqc36xj.js → resume-wd30wx23.js}

@@ -11,12 +11,12 @@ import {
   initWaitBusSubscriptions2,
   subscribeWaitToBus2,
   init_resume
-} from "./cli-g61qxmge.js";
-import"./cli-spknvxbq.js";
-import"./cli-wvaawacd.js";
-import"./cli-mmwm7zbf.js";
-import"./cli-bhjt02p8.js";
-import"./cli-1ayk1eas.js";
+} from "./cli-m48g6p95.js";
+import"./cli-8bc1w0tw.js";
+import"./cli-waqbxg08.js";
+import"./cli-w6dt9ged.js";
+import"./cli-drr5v6av.js";
+import"./cli-k2gzwsj2.js";
 import"./cli-wx3rhnm0.js";
 init_resume();
 

package/dist/{runtime-qwggdpqr.js → runtime-4hsg7h60.js}

@@ -5,7 +5,7 @@ import {
   McpServerLog2,
   createDefaultTransport2,
   McpServerConnection2
-} from "./cli-fqzx7gwa.js";
+} from "./cli-dxae2yg7.js";
 export {
   McpOAuthCredentialStore2 as McpOAuthCredentialStore,
   McpServerConnection2 as McpServerConnection,

package/dist/{session-access-sc9pn9da.js → session-access-5qvfevhk.js}

@@ -13,10 +13,10 @@ import {
   bodySessionDenial2,
   userAgentIdentityDenial2,
   init_session_access
-} from "./cli-z8eh3ex8.js";
-import"./cli-bhjt02p8.js";
-import"./cli-8hs41zy2.js";
-import"./cli-1ayk1eas.js";
+} from "./cli-4necwtsv.js";
+import"./cli-drr5v6av.js";
+import"./cli-rmmmrjkd.js";
+import"./cli-k2gzwsj2.js";
 init_session_access();
 
 export {

package/dist/{session-source-backfill-qh07xr8g.js → session-source-backfill-n1czavbr.js}

@@ -7,12 +7,12 @@ import {
   moveTaskChainKeyInTx2,
   init_session_moves,
   init_db4
-} from "./cli-1ayk1eas.js";
+} from "./cli-k2gzwsj2.js";
 import {
   normalizeAssetKey,
   defaultAssetKey,
   init_key
-} from "./cli-7wspm5gm.js";
+} from "./cli-nhrvpaj7.js";
 import {
   scrubSecrets,
   init_secret_scrubber