@desplega.ai/agent-swarm 2.5.4 → 2.7.0

package/templates/skills/researching/content.md

@@ -166,3 +166,5 @@ File-review is on by default (unless Autopilot):
 - Research documents should be self-contained
 - **CRITICAL**: You are a documentarian, not an evaluator
 - **REMEMBER**: Document what IS, not what SHOULD BE
+- Single-page-app blogs (Vite/MDX): the HTML and RSS carry only the title and summary. The post text is compiled into the main JS bundle (`/assets/index-<hash>.js`, referenced in the page HTML). Fetch the bundle and extract string literals with a quote-aware tokenizer started at a function boundary; a naive regex desyncs on quotes.
+- YouTube bot-blocks downloads from sandboxed egress. To describe a video, give its URL to a multimodal model. For the bytes of a brand's own product video, grep the brand's site or changelog HTML for `.mp4` URLs first and match the target by duration.

package/templates/skills/swarm-docs/config.json

@@ -0,0 +1,14 @@
+{
+  "kind": "skill",
+  "name": "swarm-docs",
+  "displayName": "Swarm Docs",
+  "slug": "swarm-docs",
+  "title": "Swarm Docs",
+  "description": "docs.agent-swarm.dev index: general docs, guides and playbooks, when to offer a playbook or guide to a person, and how to fetch a page. Load on demand: when no existing skill, workflow, schedule or memory covers a person's request, or they ask where something is documented.",
+  "version": "1.0.0",
+  "category": "skills",
+  "placeholders": [],
+  "runAllSeedersCandidate": true,
+  "systemDefault": true,
+  "tags": ["docs", "playbooks", "guides", "lead"]
+}

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

@@ -0,0 +1,144 @@
+# Swarm docs
+
+docs.agent-swarm.dev documents Agent Swarm: general docs, guides, and playbooks. A playbook is a tested way to run the swarm for one job (on-call, PR review, DORA metrics). Its page lists the agents, workflows, schedules and scripts to set up. The index below is generated from the docs frontmatter and ships with this release, so you can read it offline.
+
+## When to load this skill
+
+Load it on demand. Load it when a person asks for something that no skill, workflow, schedule or memory of yours covers, or asks where something is documented. When you already know how to handle the ask, handle it and leave the docs out.
+
+## Offer a page (lead)
+
+Follow these rules when you reply to a person.
+
+1. Offer only in a reply to a person's request (Slack, DM, dashboard, email). Never offer in a heartbeat, schedule, workflow step, worker follow-up, or task output.
+2. Offer only on a clear match with an entry's `when` line, and never on a `not when` match. With two candidates, offer the better one. Never offer a list.
+3. Make at most one offer per reply. Offer a page at most once per thread, and never again after a no.
+4. Skip the offer when the setup is already in place (`list-workflows` or the schedules list shows it), when one of your skills already covers the ask, or when the person already chose an approach.
+5. Put the offer in one sentence at the end, with the title and the link: "This matches the [Open Oncall playbook](https://docs.agent-swarm.dev/docs/playbooks/open-oncall). Want me to set it up that way?" For a setup request, wait for the answer before you build. For a question, answer it and add the link without asking.
+6. On yes, delegate to a worker: "Follow <page URL>. Read the page with the `swarm-docs` skill." Name the template when the entry has one.
+
+Entries marked "reference" are never offered. Read them when a task touches their topic.
+
+## Read a page (any agent)
+
+Fetch the page as markdown: `curl -fsSL https://docs.agent-swarm.dev/llms.mdx/docs/<slug>`, where `<slug>` is the path after `/docs/` in the index link. Follow the page; it names the agents, templates, schedules and scripts to create.
+
+- A 404 means the slug changed after this release. Fetch `https://docs.agent-swarm.dev/llms.txt` and find the page by title.
+- When the site is unreachable (an offline or air-gapped install), say so in one line, give the page URL, and ask the requester to attach the page. An operator can host `docs-site/` from the agent-swarm repo as a mirror and edit this skill to point at it; the edit survives reseed.
+- A `template` entry names a template that ships with the swarm (`templates/<id>` in the agent-swarm repo). Prefer it over writing the setup from scratch.
+
+<!-- docs-index:start -->
+<!-- Generated by `bun run build:docs-index` from the docs frontmatter. Do not edit by hand. -->
+
+## Playbooks
+
+- [Playbooks](https://docs.agent-swarm.dev/docs/playbooks). Reference.
+- [The rulebook our lead agent wrote for itself](https://docs.agent-swarm.dev/docs/playbooks/lead-agent-rulebook). Reference.
+- [Feature Development](https://docs.agent-swarm.dev/docs/playbooks/feature-development). When: Someone wants feature requests from Slack or Linear turned into reviewed pull requests end to end.
+- [Lead Prospecting](https://docs.agent-swarm.dev/docs/playbooks/lead-prospecting). When: Someone wants prospects found and outreach drafted on a schedule, with a person approving before anything sends.
+- [Content Generation](https://docs.agent-swarm.dev/docs/playbooks/content-generation). When: Someone wants blog posts, social posts, comparison pages or release notes written on a regular cadence.
+- [UX Command Center](https://docs.agent-swarm.dev/docs/playbooks/ux-command-center). When: Someone wants regular UX audits of their product and proposals for usability fixes.
+- [Proactive Customer Support](https://docs.agent-swarm.dev/docs/playbooks/proactive-customer-support). When: Someone wants an agent per key customer that remembers the account and prepares briefings or value reports.
+- [Observability Alert Management](https://docs.agent-swarm.dev/docs/playbooks/code-health-alert-management). When: Someone wants Datadog, Sentry, New Relic or SigNoz alerts filtered for noise, plus recurring production health audits. Not when: Alerts that page a person and should be investigated and fixed as they fire; offer Open Oncall instead.
+- [Code Health](https://docs.agent-swarm.dev/docs/playbooks/code-health-reports). When: Someone wants a recurring report on code hotspots, churn or technical debt in a repository. Template: `community/code-health-reports`.
+- [DORA Metrics](https://docs.agent-swarm.dev/docs/playbooks/dora-metrics). When: Someone wants deploy frequency, lead time or other DORA metrics reported on a schedule. Template: `community/dora-metrics`.
+- [Reports from Multiple Sources](https://docs.agent-swarm.dev/docs/playbooks/reports-multiple-sources). When: Someone wants business questions answered across their warehouse, analytics, billing and other data, with charts.
+- [Self-Documenting & Release Reports](https://docs.agent-swarm.dev/docs/playbooks/self-documenting-release-reports). When: Someone wants docs kept current, release notes written from commits, or release videos made.
+- [Open-Prompt Showreel Videos](https://docs.agent-swarm.dev/docs/playbooks/open-prompt-showreel). When: Someone wants a motion-graphics or showreel video made from a prompt. Template: `community/open-prompt-showreel`.
+- [Email Domain Health](https://docs.agent-swarm.dev/docs/playbooks/email-domain-health). When: Someone wants the domains they send email from watched for SPF, DKIM, DMARC or blocklist problems.
+- [Open Oncall](https://docs.agent-swarm.dev/docs/playbooks/open-oncall). When: Someone wants alerts from PagerDuty, Datadog, Sentry or a webhook investigated and fixed, with a person approving each fix. Not when: A one-off question about a single incident.
+- [PR Review](https://docs.agent-swarm.dev/docs/playbooks/pr-review). When: Someone wants every pull request reviewed automatically before a person looks at it.
+- [Linear Delivery Loop](https://docs.agent-swarm.dev/docs/playbooks/linear-delivery-loop). When: Someone wants agents to take Linear issues through implementation, CI and review to merged pull requests, with a person approving each one. Template: `community/linear-delivery-loop`.
+- [Hot Patterns](https://docs.agent-swarm.dev/docs/playbooks/patterns). Reference.
+- [Pattern: Litmus Tests (LLM-as-Judge Quality Gates)](https://docs.agent-swarm.dev/docs/playbooks/patterns/litmus-tests). When: Someone wants one agent to check another agent's output against a rubric before it ships.
+- [Pattern: Drain Loops (Stacked PRs + Merge Loop)](https://docs.agent-swarm.dev/docs/playbooks/patterns/drain-loops). When: Someone wants a large change split into small stacked pull requests and merged in order.
+- [Pattern: HITL Gates (Human-in-the-Loop Approval)](https://docs.agent-swarm.dev/docs/playbooks/patterns/hitl-gates). When: Someone wants a workflow to wait for a person's approval before it sends, merges, deletes or posts.
+- [Pattern: Per-Customer Working Directories](https://docs.agent-swarm.dev/docs/playbooks/patterns/per-customer-working-directories). When: Someone wants agents to keep long-lived notes per customer or account.
+- [Pattern: No-op When Nothing Changed](https://docs.agent-swarm.dev/docs/playbooks/patterns/no-op-workflows). When: Someone wants a scheduled job that stays silent when nothing changed.
+
+## Guides
+
+- [Deployment Guide](https://docs.agent-swarm.dev/docs/guides/deployment). When: Someone wants to run Agent Swarm on their own server with Docker Compose.
+- [Kubernetes and Helm](https://docs.agent-swarm.dev/docs/guides/kubernetes). When: Someone wants to install Agent Swarm on Kubernetes.
+- [Rootless Podman](https://docs.agent-swarm.dev/docs/guides/podman-rootless). When: Someone wants to run Agent Swarm under rootless Podman.
+- [Published Artifacts](https://docs.agent-swarm.dev/docs/guides/published-artifacts). Reference.
+- [Asset Namespaces](https://docs.agent-swarm.dev/docs/guides/asset-namespaces). Reference.
+- [agent-fs Co-deployment](https://docs.agent-swarm.dev/docs/guides/agent-fs-co-deployment). When: Someone wants shared persistent files for agents on a self-hosted swarm.
+- [Self-Hosted SSO](https://docs.agent-swarm.dev/docs/guides/self-hosted-sso). When: Someone wants their self-hosted swarm dashboard behind single sign-on.
+- [E2B Provider Smoke Tests](https://docs.agent-swarm.dev/docs/guides/e2b-provider-smoke-tests). Reference.
+- [Evals Harness](https://docs.agent-swarm.dev/docs/guides/evals-harness). Reference.
+- [Personalization & Status](https://docs.agent-swarm.dev/docs/guides/personalization). Reference.
+- [Secrets Encryption](https://docs.agent-swarm.dev/docs/guides/secrets-encryption). When: Someone asks how swarm secrets are stored, encrypted or backed up.
+- [Harness Configuration](https://docs.agent-swarm.dev/docs/guides/harness-configuration). When: Someone wants agents to run on a different AI provider or coding CLI.
+- [Provider Capability Matrix](https://docs.agent-swarm.dev/docs/guides/provider-capability-matrix). Reference.
+- [Adding a Harness Provider](https://docs.agent-swarm.dev/docs/guides/harness-providers). Reference.
+- [Steer a Running Task](https://docs.agent-swarm.dev/docs/guides/task-steering). Reference.
+- [Claude Code Mod](https://docs.agent-swarm.dev/docs/guides/claude-code-mod). Reference.
+- [Observability with OpenTelemetry](https://docs.agent-swarm.dev/docs/guides/observability-opentelemetry). When: Someone wants swarm traces and metrics in SigNoz or another OpenTelemetry backend.
+- [Host Requirements & Disk Cleanup](https://docs.agent-swarm.dev/docs/guides/host-requirements). When: Someone asks how big a host their self-hosted swarm needs, or their disk is filling up with Docker images.
+- [Performance & Resource Sizing](https://docs.agent-swarm.dev/docs/guides/performance-resource-sizing). Reference.
+- [Cost & context computation](https://docs.agent-swarm.dev/docs/guides/cost-and-context-computation). Reference.
+- [Extensions](https://docs.agent-swarm.dev/docs/guides/extensions). Reference.
+- [Scripts runtime](https://docs.agent-swarm.dev/docs/guides/scripts-runtime). Reference.
+- [Agent capabilities and tool allowlist](https://docs.agent-swarm.dev/docs/guides/agent-capabilities). Reference.
+- [Scripts-only mode (code-mode)](https://docs.agent-swarm.dev/docs/guides/scripts-only-mode). Reference.
+- [Script connections](https://docs.agent-swarm.dev/docs/guides/script-connections). When: Someone wants the swarm to call an external API, with credentials kept out of the code.
+- [OAuth callback migration](https://docs.agent-swarm.dev/docs/guides/oauth-callback-migration). Reference.
+- [Scripts as external APIs](https://docs.agent-swarm.dev/docs/guides/scripts-external-apis). When: Someone wants a swarm script exposed as a public HTTP endpoint or webhook receiver.
+- [Scripts credential broker](https://docs.agent-swarm.dev/docs/guides/scripts-credential-broker). Reference.
+- [One-off Script Workflow Runs](https://docs.agent-swarm.dev/docs/guides/script-workflow-runs). Reference.
+- [Claude Bridge](https://docs.agent-swarm.dev/docs/guides/claude-bridge-experimental). Reference.
+- [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.
+- [Cursor](https://docs.agent-swarm.dev/docs/guides/provider-auth/cursor). Reference.
+- [Amp](https://docs.agent-swarm.dev/docs/guides/provider-auth/amp). Reference.
+- [Grok](https://docs.agent-swarm.dev/docs/guides/provider-auth/grok). Reference.
+- [DeepSeek Harness (dsh)](https://docs.agent-swarm.dev/docs/guides/provider-auth/dsh). Reference.
+- [x402 Payments](https://docs.agent-swarm.dev/docs/guides/x402-payments). Reference.
+- [Multi-runtime agents](https://docs.agent-swarm.dev/docs/guides/multi-runtime-agents). Reference.
+- [Runtime pools (beta)](https://docs.agent-swarm.dev/docs/guides/runtime-pools). Reference.
+
+## Other docs
+
+- [Introduction](https://docs.agent-swarm.dev/docs)
+- [Getting Started](https://docs.agent-swarm.dev/docs/getting-started)
+- [Architecture Overview](https://docs.agent-swarm.dev/docs/architecture/overview)
+- [Agent Identity & Configuration](https://docs.agent-swarm.dev/docs/architecture/agents)
+- [Memory System](https://docs.agent-swarm.dev/docs/architecture/memory)
+- [Hook System](https://docs.agent-swarm.dev/docs/architecture/hooks)
+- [Task Lifecycle](https://docs.agent-swarm.dev/docs/concepts/task-lifecycle)
+- [Scheduled Tasks](https://docs.agent-swarm.dev/docs/concepts/scheduling)
+- [Workflows](https://docs.agent-swarm.dev/docs/concepts/workflows)
+- [Team Collaboration](https://docs.agent-swarm.dev/docs/features/team-collaboration)
+- [Apps](https://docs.agent-swarm.dev/docs/apps)
+- [App concepts](https://docs.agent-swarm.dev/docs/apps/concepts)
+- [Build an App](https://docs.agent-swarm.dev/docs/apps/build-an-app)
+- [App recipes](https://docs.agent-swarm.dev/docs/apps/recipes)
+- [Overview](https://docs.agent-swarm.dev/docs/ui)
+- [Sessions](https://docs.agent-swarm.dev/docs/ui/sessions)
+- [Configuration](https://docs.agent-swarm.dev/docs/ui/configuration)
+- [Comb (beta)](https://docs.agent-swarm.dev/docs/ui/comb)
+- [Integrations](https://docs.agent-swarm.dev/docs/integrations)
+- [Slack Integration](https://docs.agent-swarm.dev/docs/integrations/slack)
+- [GitHub App Integration](https://docs.agent-swarm.dev/docs/integrations/github)
+- [GitLab Integration](https://docs.agent-swarm.dev/docs/integrations/gitlab)
+- [Azure DevOps Integration](https://docs.agent-swarm.dev/docs/integrations/azure-devops)
+- [Bitbucket Integration](https://docs.agent-swarm.dev/docs/integrations/bitbucket)
+- [Linear](https://docs.agent-swarm.dev/docs/integrations/linear)
+- [Jira Integration](https://docs.agent-swarm.dev/docs/integrations/jira)
+- [Sentry Integration](https://docs.agent-swarm.dev/docs/integrations/sentry)
+- [AgentMail Integration](https://docs.agent-swarm.dev/docs/integrations/agentmail)
+- [Kapso (WhatsApp)](https://docs.agent-swarm.dev/docs/integrations/kapso)
+- [Chat SDK](https://docs.agent-swarm.dev/docs/integrations/chat-sdk)
+- [Composio](https://docs.agent-swarm.dev/docs/integrations/composio)
+- [Salesforce](https://docs.agent-swarm.dev/docs/integrations/salesforce)
+- [Microsoft Graph](https://docs.agent-swarm.dev/docs/integrations/microsoft-graph)
+- [Serply Search](https://docs.agent-swarm.dev/docs/integrations/serply)
+- [MCP Tools Reference](https://docs.agent-swarm.dev/docs/reference/mcp-tools)
+- [Environment Variables](https://docs.agent-swarm.dev/docs/reference/environment-variables)
+- [CLI Reference](https://docs.agent-swarm.dev/docs/reference/cli)
+- [The `x` command](https://docs.agent-swarm.dev/docs/reference/x-command)
+- [Telemetry](https://docs.agent-swarm.dev/docs/reference/telemetry)
+- [Contributing](https://docs.agent-swarm.dev/docs/contributing)
+<!-- docs-index:end -->

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

@@ -175,6 +175,7 @@ function rowsToObjects(res: any): any[] {
 - `kv_get` returns the entry at `data`: read `res.data.value`. The MCP tool shape `entry.value` reads `undefined` in a script.
 - `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.
+- The skill methods disagree on the id field: `skill_get({ id })`, but `skill_update({ skillId, content })`. `skill_update({ id, content })` returns outer `success: true` with inner `data.success: false` ("skillId is required.") and writes nothing. Gate a write on `res.data.success`, then re-read: the version must increase and the content must match the draft.
 - 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.

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

@@ -170,6 +170,7 @@ function rowsToObjects(res: any): any[] {
 - `kv_get` returns the entry at `data`: read `res.data.value`. The MCP tool shape `entry.value` reads `undefined` in a script.
 - `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.
+- The skill methods disagree on the id field: `skill_get({ id })`, but `skill_update({ skillId, content })`. `skill_update({ id, content })` returns outer `success: true` with inner `data.success: false` ("skillId is required.") and writes nothing. Gate a write on `res.data.success`, then re-read: the version must increase and the content must match the draft.
 - 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.

package/dist/cli-7421jzsw.js

@@ -1,84 +0,0 @@
-import {
-  __esm
-} from "./cli-242037k3.js";
-
-// src/utils/model-rate-limit-windows.ts
-function modelFamilyOf(model) {
-  if (!model)
-    return;
-  const lower = model.toLowerCase();
-  const families = ["fable", "opus", "sonnet", "haiku"];
-  for (const family of families) {
-    if (lower.includes(family))
-      return family;
-  }
-  return;
-}
-function windowForModelFamily(family) {
-  switch (family) {
-    case "fable":
-      return FABLE_WINDOW;
-    case "opus":
-      return OPUS_WINDOW;
-    case "sonnet":
-      return SONNET_WINDOW;
-    default:
-      return;
-  }
-}
-function isModelScopedWindow(type) {
-  return Object.hasOwn(MODEL_SCOPED_WINDOWS, type) && MODEL_SCOPED_WINDOWS[type] !== undefined;
-}
-function parseModelLimitMessage(text) {
-  const match = text.match(/reached your (Fable|Opus|Sonnet) limit/i);
-  if (!match)
-    return;
-  return match[1].toLowerCase();
-}
-function parseCreditsRequiredMessage(text) {
-  const match = text.match(/(Fable|Opus|Sonnet)(?:[^.]|\.(?=\d)){0,40}requires usage credits/i);
-  if (!match)
-    return;
-  return match[1].toLowerCase();
-}
-function activeModelBlock(windows, family, nowMs) {
-  if (!windows)
-    return;
-  const window = windowForModelFamily(family);
-  if (!window)
-    return;
-  const entry = windows[window];
-  if (!entry)
-    return;
-  if (entry.status !== "rejected")
-    return;
-  if (typeof entry.resetsAt !== "number" || entry.resetsAt * 1000 <= nowMs)
-    return;
-  return { window, resetsAt: entry.resetsAt };
-}
-function activeModelBlocks(windows, nowMs) {
-  if (!windows)
-    return [];
-  const blocks = [];
-  for (const [window, model] of Object.entries(MODEL_SCOPED_WINDOWS)) {
-    const entry = windows[window];
-    if (!entry)
-      continue;
-    if (entry.status !== "rejected")
-      continue;
-    if (typeof entry.resetsAt !== "number" || entry.resetsAt * 1000 <= nowMs)
-      continue;
-    blocks.push({ model, window, resetsAt: entry.resetsAt });
-  }
-  return blocks;
-}
-var FABLE_WINDOW = "seven_day_overage_included", OPUS_WINDOW = "seven_day_opus", SONNET_WINDOW = "seven_day_sonnet", MODEL_SCOPED_WINDOWS;
-var init_model_rate_limit_windows = __esm(() => {
-  MODEL_SCOPED_WINDOWS = {
-    [FABLE_WINDOW]: "fable",
-    [OPUS_WINDOW]: "opus",
-    [SONNET_WINDOW]: "sonnet"
-  };
-});
-
-export { MODEL_SCOPED_WINDOWS, modelFamilyOf, windowForModelFamily, isModelScopedWindow, parseModelLimitMessage, parseCreditsRequiredMessage, activeModelBlock, activeModelBlocks, init_model_rate_limit_windows };