@desplega.ai/agent-swarm 1.166.0 → 1.168.0

package/templates/skills/work-on-task/SKILL.md

@@ -13,4 +13,8 @@ When the task names a skill (`researching`, `planning`, `implementing`), use it.
 
 Finish the task with one of the four endings in your operating contract: `completed`, `defer-task`, `request-human-input`, or `failed`. Then stop.
 
+Resuming (a resume task, or work cut by a graceful shutdown): read the parent's last progress line, then re-read live state once (PR state and head SHA, branch, `git status`) before new work. Re-run controls only if the head moved. Never redo a pushed commit or open a second PR for the same branch. Store a progress line with branch, PR number and head SHA each time you push.
+
+Write times in replies, outputs and defer notes in the requester's timezone when the Requester Profile names one, never raw UTC.
+
 If the user interrupts, follow their instructions. To resume, call `/work-on-task <taskId>` again.

package/templates/skills/work-on-task/content.md

@@ -8,4 +8,8 @@ When the task names a skill (`researching`, `planning`, `implementing`), use it.
 
 Finish the task with one of the four endings in your operating contract: `completed`, `defer-task`, `request-human-input`, or `failed`. Then stop.
 
+Resuming (a resume task, or work cut by a graceful shutdown): read the parent's last progress line, then re-read live state once (PR state and head SHA, branch, `git status`) before new work. Re-run controls only if the head moved. Never redo a pushed commit or open a second PR for the same branch. Store a progress line with branch, PR number and head SHA each time you push.
+
+Write times in replies, outputs and defer notes in the requester's timezone when the Requester Profile names one, never raw UTC.
+
 If the user interrupts, follow their instructions. To resume, call `/work-on-task <taskId>` again.

package/templates/skills/workflow-iterate/content.md

@@ -173,6 +173,15 @@ Afterwards, a `warnings` entry on `create-workflow` or a patch tool means the ke
 - Do not set `retry` or `validation.retry` on a `system-one-decision` node. It retries connection errors, 408, 429, and 5xx itself (`config.maxRetries`, 0 to 3, default 2) inside `config.timeoutMs` (default 30000). A 401, a 422, or an answer that fails validation ends after one attempt.
 - The node reads its provider's key (`TYPESAFE_API_KEY`, `OPENROUTER_API_KEY`, `LAYA_API_KEY`, `OPENAI_DECISIONS_API_KEY`, or `CLOUDFLARE_API_TOKEN`, plus `LAYA_URL` for `laya` and `CLOUDFLARE_ACCOUNT_ID` for `cloudflare`) server-side. The key never appears in the definition, the step output, or an error. A run whose key or `LAYA_URL` is missing fails before any node executes, and a 401 or 403 fails the step as `<KEY> was rejected`. An unresolved `{{token}}` fails the step before any request.
 
+### `human-in-the-loop` (how approvals render)
+
+The same rules apply to a standalone `request-human-input` call.
+
+- **Dashboard card.** `title` is plain text. Each question's `label` is its heading and renders as markdown. `description` renders as full markdown and is the only field that shows images, so put drafts, diffs, and logs there.
+- **Code.** Fence code, logs, and JSON with a language (```` ```json ````): the block keeps its lines and scrolls. Fence a prose draft with no language: it wraps. A single newline outside a fence becomes a paragraph break.
+- **Images.** Put an `http(s)` URL ending in `.png`, `.jpg`, `.jpeg`, `.gif`, or `.webp` alone on its own line in `description`, or use `![alt](url)`. The link must outlive the request: an expired presigned URL shows an "image unavailable" note.
+- **Slack.** A node's `notifications` post the title, the question labels (each collapsed to one line, capped at 3000 characters in total), a Review button, and the timeout. Descriptions, options, code, and images are not shown, so the title and labels must make sense alone. `request-human-input` posts nothing to Slack: share the returned URL yourself.
+
 ### `swarm-script`
 
 ```json

package/dist/acp-adapter-yzfxn8vj.js

@@ -1,23 +0,0 @@
-import {
-  ACPAdapter,
-  applyConfiguredOptions,
-  sanitizeAcpConfigOptions,
-  toAcpMcpServers
-} from "./cli-3qn4r334.js";
-import"./cli-32bca7nr.js";
-import"./cli-tng3131n.js";
-import"./cli-zp67qg5x.js";
-import"./cli-ttbsse3f.js";
-import"./cli-dpvkp2et.js";
-import"./cli-zt3w1cn1.js";
-import"./cli-zsh093hk.js";
-import"./cli-w5e1d1vv.js";
-import"./cli-4r1sjfc4.js";
-import"./cli-wt7ccy4r.js";
-import"./cli-bc05qbss.js";
-export {
-  ACPAdapter,
-  applyConfiguredOptions,
-  sanitizeAcpConfigOptions,
-  toAcpMcpServers
-};

package/dist/cli-3dpj7atn.js

@@ -1,11 +0,0 @@
-// src/utils/openrouter-base-url.ts
-var DEFAULT_OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
-function getOpenRouterBaseUrl(env = process.env) {
-  const raw = env.OPENROUTER_BASE_URL;
-  if (typeof raw === "string" && raw.trim().length > 0) {
-    return raw.trim().replace(/\/+$/, "");
-  }
-  return DEFAULT_OPENROUTER_BASE_URL;
-}
-
-export { DEFAULT_OPENROUTER_BASE_URL, getOpenRouterBaseUrl };

package/dist/cli-gvcgmx69.js

@@ -1,183 +0,0 @@
-import {
-  retryProviderRequest
-} from "./cli-qbksc292.js";
-import {
-  formatProviderError,
-  normalizeProviderError
-} from "./cli-6map995v.js";
-import {
-  headersToRecord,
-  providerHeadersToRecord
-} from "./cli-7kyk9jr3.js";
-import {
-  calculateCost
-} from "./cli-nexwh8zg.js";
-
-// node_modules/@earendil-works/pi-ai/dist/api/system-one-shared.js
-function httpError(label, response, body) {
-  const error = new Error(`${label} returned ${response.status}`);
-  error.status = response.status;
-  error.headers = response.headers;
-  error.body = body;
-  return error;
-}
-function timeoutError(timeoutMs) {
-  const error = new Error(`Request timed out after ${timeoutMs}ms`);
-  error.name = "TimeoutError";
-  error.status = undefined;
-  error.headers = undefined;
-  error.body = "";
-  return error;
-}
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function requiredNumber(label, value, field) {
-  if (typeof value !== "number" || !Number.isFinite(value)) {
-    throw new Error(`${label} returned an invalid ${field}`);
-  }
-  return value;
-}
-function probabilities(label, value, id) {
-  if (!isRecord(value))
-    throw new Error(`${label} returned invalid probabilities for ${id}`);
-  return Object.fromEntries(Object.entries(value).map(([key, probability]) => [
-    key,
-    requiredNumber(label, probability, `probability for ${id}.${key}`)
-  ]));
-}
-function parseAnswers(label, value, context) {
-  if (!isRecord(value))
-    throw new Error(`${label} returned an unexpected response`);
-  const answers = [];
-  for (const [id, question] of Object.entries(context.questions)) {
-    const answer = value[id];
-    if (!isRecord(answer))
-      throw new Error(`${label} did not return an answer for ${id}`);
-    if (question.type === "choice") {
-      if (answer.type !== "choice" || typeof answer.choice !== "string") {
-        throw new Error(`${label} did not return a choice answer for ${id}`);
-      }
-      answers.push([
-        id,
-        {
-          type: "choice",
-          choice: answer.choice,
-          probabilities: probabilities(label, answer.probabilities, id),
-          confidence: requiredNumber(label, answer.confidence, `confidence for ${id}`)
-        }
-      ]);
-    } else if (question.type === "score") {
-      if (answer.type !== "score")
-        throw new Error(`${label} did not return a score answer for ${id}`);
-      answers.push([
-        id,
-        {
-          type: "score",
-          score: requiredNumber(label, answer.score, `score for ${id}`),
-          confidence: requiredNumber(label, answer.confidence, `confidence for ${id}`)
-        }
-      ]);
-    } else {
-      if (answer.type !== "noul")
-        throw new Error(`${label} did not return a bool answer for ${id}`);
-      answers.push([
-        id,
-        {
-          type: "bool",
-          probability: requiredNumber(label, answer.noul, `probability for ${id}`)
-        }
-      ]);
-    }
-  }
-  return Object.fromEntries(answers);
-}
-function tokenCount(value) {
-  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : 0;
-}
-function parseUsage(value, model) {
-  if (!isRecord(value) || value.input_tokens === undefined && value.output_tokens === undefined)
-    return;
-  const input = tokenCount(value.input_tokens);
-  const output = tokenCount(value.output_tokens);
-  const usage = {
-    input,
-    output,
-    cacheRead: 0,
-    cacheWrite: 0,
-    totalTokens: input + output,
-    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 }
-  };
-  calculateCost(model, usage);
-  return usage;
-}
-function wireRequest(context) {
-  return {
-    state: context.state,
-    questions: Object.fromEntries(Object.entries(context.questions).map(([id, question]) => [
-      id,
-      question.type === "bool" ? { ...question, type: "noul" } : question
-    ]))
-  };
-}
-function requestHeaders(model, apiKey, optionsHeaders) {
-  return providerHeadersToRecord({ authorization: `Bearer ${apiKey}`, "content-type": "application/json" }, model.headers, optionsHeaders) ?? {};
-}
-async function classifySystemOne(transport, model, context, options) {
-  const output = {
-    api: model.api,
-    provider: model.provider,
-    model: model.id,
-    answers: {},
-    stopReason: "stop",
-    timestamp: Date.now()
-  };
-  try {
-    if (model.api !== transport.api)
-      throw new Error(`Unsupported classifier API: ${model.api}`);
-    if (!options?.apiKey)
-      throw new Error(`No API key for provider: ${model.provider}`);
-    const apiKey = options.apiKey;
-    let payload = transport.payload(model, wireRequest(context));
-    const transformed = await options.onPayload?.(payload, model);
-    if (transformed !== undefined)
-      payload = transformed;
-    const requestFetch = options.fetch ?? globalThis.fetch;
-    const { response, body } = await retryProviderRequest(async () => {
-      const timeoutSignal = options.timeoutMs !== undefined ? AbortSignal.timeout(options.timeoutMs) : undefined;
-      const signal = options.signal && timeoutSignal ? AbortSignal.any([options.signal, timeoutSignal]) : options.signal ?? timeoutSignal;
-      try {
-        const next = await requestFetch(transport.url(model), {
-          method: "POST",
-          headers: requestHeaders(model, apiKey, options.headers),
-          body: JSON.stringify(payload),
-          signal
-        });
-        if (!next.ok)
-          throw httpError(transport.label, next, await next.text());
-        return { response: next, body: await next.json() };
-      } catch (error) {
-        if (timeoutSignal?.aborted && !options.signal?.aborted)
-          throw timeoutError(options.timeoutMs);
-        throw error;
-      }
-    }, {
-      maxRetries: options.maxRetries ?? 2,
-      maxRetryDelayMs: options.maxRetryDelayMs,
-      signal: options.signal
-    });
-    await options.onResponse?.({ status: response.status, headers: headersToRecord(response.headers) }, model);
-    const result = transport.output(body);
-    const usage = parseUsage(result.usage, model);
-    if (usage)
-      output.usage = usage;
-    output.answers = parseAnswers(transport.label, result.answers, context);
-    return output;
-  } catch (error) {
-    output.stopReason = options?.signal?.aborted ? "aborted" : "error";
-    output.errorMessage = formatProviderError(normalizeProviderError(error), `${transport.label} error`);
-    return output;
-  }
-}
-
-export { isRecord, classifySystemOne };

package/dist/{cli-jhm6hzjn.js → cli-mxvnnv5q.js}

@@ -9,13 +9,6 @@ import {
   getSlackConfiguration,
   init_config
 } from "./cli-dmtrxqhg.js";
-import {
-  MAX_PROFILE_FILE_LENGTH,
-  buildAgentFsLiveUrl,
-  buildCombFileUrl,
-  getAppUrl,
-  init_constants
-} from "./cli-gd4favx9.js";
 import {
   init_templates
 } from "./cli-agamgm0p.js";
@@ -23,6 +16,13 @@ import {
   init_resolver,
   resolveTemplateAsync
 } from "./cli-5c2j5yvx.js";
+import {
+  MAX_PROFILE_FILE_LENGTH,
+  buildAgentFsLiveUrl,
+  buildCombFileUrl,
+  getAppUrl,
+  init_constants
+} from "./cli-gd4favx9.js";
 import {
   init_secret_scrubber,
   scrubSecrets

package/dist/{codex-hook-d2rkvf39.js → codex-hook-15dgc4cb.js}

@@ -13,11 +13,11 @@ import {
   isSteeringEnabled
 } from "./cli-7mm2r1kp.js";
 import"./cli-g5erf0zt.js";
+import"./cli-5c2j5yvx.js";
 import {
   getMcpBaseUrl,
   init_constants
 } from "./cli-gd4favx9.js";
-import"./cli-5c2j5yvx.js";
 import"./cli-ej6gbxfb.js";
 import"./cli-bc05qbss.js";