@desplega.ai/agent-swarm 2.2.0 → 2.4.0

package/templates/skills/swarm-scripts/SKILL.md

@@ -104,6 +104,9 @@ const { stdout, exitCode } = await ctx.sh("grep -rn TODO /afs/notes | sort | hea
 
 `launch-script-run` runs a script as a durable, journaled run with a different `ctx`: `ctx.run` (`id`, `agentId`, `args`) and `ctx.step.rawLlm(label, config)`, `ctx.step.agentTask(label, config)`, `ctx.step.swarmScript(label, config)`, plus `ctx.swarm.*`, `ctx.stdlib`, `ctx.logger`. Durable runs have no `ctx.api`, no `ctx.mcp`, no `ctx.fs`, no `ctx.sh`, and no `ctx.swarm.config`. A configured `ctx.step.agentTask` `agentId` records `human_pinned` unless `routingReason` is supplied. Call a connection or the drive from an inner script through `ctx.step.swarmScript`. See the `script-workflows` skill.
 
+- Each `ctx.step.agentTask` step is a normal worker task (`taskType: "script-run-step"`). When it finishes, the lead gets the usual "Worker task completed — review needed" follow-up, even while the run is still awaiting that step. The step config has no `followUpConfig` field, so a value passed there is dropped. Let the script's own judge step be the gate and close those follow-ups with a one-line accept.
+- When a crash supersedes an in-flight step and resumes it as a new task, the run does not follow the new task id: it can stay `failed` (for example `write EPIPE`) while the resumed task completes. Check the resumed task's output before you re-launch the run.
+
 ## Inline script pattern
 
 ```typescript
@@ -173,6 +176,9 @@ function rowsToObjects(res: any): any[] {
 - `script_run` returns an envelope (`result`, `truncated`, `durationMs`, `stdout`, `stderr`, `exitCode`). The callee payload is at `.result`. Take key names from a real response: a guessed key that is absent reads as a false zero.
 - An `argsSchema` validation error fires before the body runs and repeats on every retry. Fix the args instead of retrying.
 - Write a dedup or idempotency marker only after the step succeeds. A marker written after a failure blocks the next real attempt.
+- `kv_set` returns `success: false` instead of throwing when a key has a character outside `[a-zA-Z0-9._:/-]` (for example `#` or `|` from a git ref). Check `success` after every write.
+- `script_run` without `scope` runs an agent-scoped row of the same name before the global one, so a stale private copy silently wins. Pass `scope: "global"` for a shared script.
+- A nested `script_run` does not overlap with the caller's own `ctx.stdlib.fetch` calls: started alongside them it added about 8 s to one measured run. Start it after the caller's own queries.
 
 Common tables: `agent_tasks`, `session_logs`, `agent_memory`, `scheduled_tasks`, `agents`. `session_logs` has no `tool_name` column. Tool names sit inside the `content` JSON column. Extract them with `instr` and `substr` in SQL, or parse the JSON in the script.
 

package/templates/skills/swarm-scripts/content.md

@@ -99,6 +99,9 @@ const { stdout, exitCode } = await ctx.sh("grep -rn TODO /afs/notes | sort | hea
 
 `launch-script-run` runs a script as a durable, journaled run with a different `ctx`: `ctx.run` (`id`, `agentId`, `args`) and `ctx.step.rawLlm(label, config)`, `ctx.step.agentTask(label, config)`, `ctx.step.swarmScript(label, config)`, plus `ctx.swarm.*`, `ctx.stdlib`, `ctx.logger`. Durable runs have no `ctx.api`, no `ctx.mcp`, no `ctx.fs`, no `ctx.sh`, and no `ctx.swarm.config`. A configured `ctx.step.agentTask` `agentId` records `human_pinned` unless `routingReason` is supplied. Call a connection or the drive from an inner script through `ctx.step.swarmScript`. See the `script-workflows` skill.
 
+- Each `ctx.step.agentTask` step is a normal worker task (`taskType: "script-run-step"`). When it finishes, the lead gets the usual "Worker task completed — review needed" follow-up, even while the run is still awaiting that step. The step config has no `followUpConfig` field, so a value passed there is dropped. Let the script's own judge step be the gate and close those follow-ups with a one-line accept.
+- When a crash supersedes an in-flight step and resumes it as a new task, the run does not follow the new task id: it can stay `failed` (for example `write EPIPE`) while the resumed task completes. Check the resumed task's output before you re-launch the run.
+
 ## Inline script pattern
 
 ```typescript
@@ -168,6 +171,9 @@ function rowsToObjects(res: any): any[] {
 - `script_run` returns an envelope (`result`, `truncated`, `durationMs`, `stdout`, `stderr`, `exitCode`). The callee payload is at `.result`. Take key names from a real response: a guessed key that is absent reads as a false zero.
 - An `argsSchema` validation error fires before the body runs and repeats on every retry. Fix the args instead of retrying.
 - Write a dedup or idempotency marker only after the step succeeds. A marker written after a failure blocks the next real attempt.
+- `kv_set` returns `success: false` instead of throwing when a key has a character outside `[a-zA-Z0-9._:/-]` (for example `#` or `|` from a git ref). Check `success` after every write.
+- `script_run` without `scope` runs an agent-scoped row of the same name before the global one, so a stale private copy silently wins. Pass `scope: "global"` for a shared script.
+- A nested `script_run` does not overlap with the caller's own `ctx.stdlib.fetch` calls: started alongside them it added about 8 s to one measured run. Start it after the caller's own queries.
 
 Common tables: `agent_tasks`, `session_logs`, `agent_memory`, `scheduled_tasks`, `agents`. `session_logs` has no `tool_name` column. Tool names sit inside the `content` JSON column. Extract them with `instr` and `substr` in SQL, or parse the JSON in the script.
 

package/dist/handlers-t5pbabwf.js

@@ -1,37 +0,0 @@
-import {
-  isUserAllowed2,
-  registerMessageHandler2
-} from "./cli-xnp2vkx7.js";
-import"./cli-8c1m9mhy.js";
-import"./cli-5ks6x36q.js";
-import"./cli-bddxamg7.js";
-import"./cli-rdr166ht.js";
-import"./cli-vmbakbq0.js";
-import"./cli-qz93y3x5.js";
-import"./cli-mvsfbbgq.js";
-import"./cli-3h26v7yj.js";
-import"./cli-7a91w22y.js";
-import"./cli-3ggwdtb0.js";
-import"./cli-xx13gqf3.js";
-import"./cli-mnry16kh.js";
-import"./cli-jhhb2v9n.js";
-import"./cli-8w65vwee.js";
-import"./cli-qje9k2nh.js";
-import"./cli-dw0njd9q.js";
-import"./cli-hwc4a9xm.js";
-import"./cli-8cvvytad.js";
-import"./cli-vjfpshn3.js";
-import"./cli-13p25grh.js";
-import"./cli-0adyhvq2.js";
-import"./cli-tba8fxf9.js";
-import"./cli-ztcxv5nv.js";
-import"./cli-h23mr2s6.js";
-import"./cli-445c1vp7.js";
-import"./cli-kvzgak7c.js";
-import"./cli-6q7pyd3k.js";
-import"./cli-4c7k75rq.js";
-import"./cli-ptkpaqfy.js";
-export {
-  isUserAllowed2 as isUserAllowed,
-  registerMessageHandler2 as registerMessageHandler
-};

package/dist/index-qyjbb7br.js

@@ -1,39 +0,0 @@
-import"./cli-ns59dc6r.js";
-import {
-  startHeartbeat2,
-  stopHeartbeat2
-} from "./cli-0k9rcwfy.js";
-import"./cli-z3dk189k.js";
-import"./cli-raejy0mp.js";
-import"./cli-bddxamg7.js";
-import"./cli-rdr166ht.js";
-import"./cli-vmbakbq0.js";
-import"./cli-qz93y3x5.js";
-import"./cli-mvsfbbgq.js";
-import"./cli-3h26v7yj.js";
-import"./cli-7a91w22y.js";
-import"./cli-3ggwdtb0.js";
-import"./cli-xx13gqf3.js";
-import"./cli-mnry16kh.js";
-import"./cli-jhhb2v9n.js";
-import"./cli-8w65vwee.js";
-import"./cli-qje9k2nh.js";
-import"./cli-dw0njd9q.js";
-import"./cli-hwc4a9xm.js";
-import"./cli-8cvvytad.js";
-import"./cli-vjfpshn3.js";
-import"./cli-13p25grh.js";
-import"./cli-0adyhvq2.js";
-import"./cli-tba8fxf9.js";
-import"./cli-ztcxv5nv.js";
-import"./cli-h23mr2s6.js";
-import"./cli-445c1vp7.js";
-import"./cli-kvzgak7c.js";
-import"./cli-b2mz5mjc.js";
-import"./cli-6q7pyd3k.js";
-import"./cli-4c7k75rq.js";
-import"./cli-ptkpaqfy.js";
-export {
-  startHeartbeat2 as startHeartbeat,
-  stopHeartbeat2 as stopHeartbeat
-};

package/dist/{cli-n5mrsg0f.js → cli-60cgh1rv.js}

@@ -7,13 +7,13 @@ import {
 import {
   retryProviderRequest
 } from "./cli-w6pm0v4s.js";
+import {
+  require_p_retry
+} from "./cli-952zgdwp.js";
 import {
   require_ecdsa_sig_formatter,
   require_jws
 } from "./cli-vh8v90yv.js";
-import {
-  require_p_retry
-} from "./cli-952zgdwp.js";
 import {
   getJsonSchemaToolParameters,
   resolveJsonSchemaStrictSampling,