@desplega.ai/agent-swarm 1.87.0 → 1.88.0

package/README.md

@@ -124,7 +124,7 @@ Check [our templates](https://templates.agent-swarm.dev) for a quick start.
 - **Workflow engine with Human-in-the-Loop** — DAG-based automation with approval gates, retries, and structured I/O. [Workflows →](https://docs.agent-swarm.dev/docs/concepts/workflows)
 - **Scheduled & recurring tasks** — cron-based automation for standing work. [Scheduling →](https://docs.agent-swarm.dev/docs/concepts/scheduling)
 - **Harness & LLM agnostic** — run with Claude Code, OpenAI Codex, pi-mono, Devin, Claude Managed Agents, raw LLMs, or opencode. [Harness config →](https://docs.agent-swarm.dev/docs/guides/harness-configuration) · [Add a new provider →](https://docs.agent-swarm.dev/docs/guides/harness-providers)
-- **Follow-up continuity across all harnesses** — child tasks inherit bounded prior-task context even on providers without native session resume, while resumable providers still reuse prior sessions when possible. [Task lifecycle →](https://docs.agent-swarm.dev/docs/concepts/task-lifecycle)
+- **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 and per-agent MCP servers with scope cascade. [MCP tools →](https://docs.agent-swarm.dev/docs/reference/mcp-tools)
 - **DB-backed pages** — agents publish HTML or JSON pages (reports, dashboards, action specs) via the `create_page` MCP tool with public / authed / password modes, version history, view counters, diff helpers, and PDF export. [MCP tools → Pages](https://docs.agent-swarm.dev/docs/reference/mcp-tools#pages-tools)
 - **KV store** — Redis-like namespaced key/value store with auto-scoped context (Slack thread / PR / Linear issue / page). [MCP tools → KV](https://docs.agent-swarm.dev/docs/reference/mcp-tools#kv-tools)
@@ -222,6 +222,7 @@ bunx @desplega.ai/agent-swarm <command>
 | `api`     | Start the API + MCP HTTP server |
 | `worker`  | Run a worker agent |
 | `lead`    | Run a lead agent |
+| `e2b`     | Build E2B templates and launch/manage grouped API + lead + worker swarms |
 | `docs`    | Open documentation (`--open` to launch in browser) |
 
 ## Deployment

package/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Swarm API",
-    "version": "1.87.0",
+    "version": "1.88.0",
     "description": "Multi-agent orchestration API for Claude Code, Codex, and Gemini CLI. Enables task distribution, agent communication, and service discovery.\n\nMCP tools are documented separately in [MCP.md](./MCP.md)."
   },
   "servers": [
@@ -4014,6 +4014,9 @@
                     "items": {
                       "type": "string"
                     }
+                  },
+                  "persistMemory": {
+                    "type": "boolean"
                   }
                 },
                 "required": [
@@ -7620,6 +7623,9 @@
                   },
                   "ownerAgentId": {
                     "type": "string"
+                  },
+                  "systemDefault": {
+                    "type": "boolean"
                   }
                 },
                 "required": [
@@ -7703,6 +7709,9 @@
           "200": {
             "description": "Skill updated"
           },
+          "403": {
+            "description": "System-managed skills cannot be edited"
+          },
           "404": {
             "description": "Skill not found"
           }
@@ -7732,6 +7741,9 @@
           "200": {
             "description": "Skill deleted"
           },
+          "403": {
+            "description": "System-managed skills cannot be deleted"
+          },
           "404": {
             "description": "Skill not found"
           }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@desplega.ai/agent-swarm",
-  "version": "1.87.0",
+  "version": "1.88.0",
   "description": "Multi-agent orchestration for Claude Code, Codex, Gemini CLI, and other AI coding assistants",
   "license": "MIT",
   "author": "desplega.sh <contact@desplega.sh>",
@@ -111,12 +111,12 @@
     "@desplega.ai/localtunnel": "^2.2.0",
     "@inkjs/ui": "^2.0.0",
     "@linear/sdk": "^77.0.0",
-    "@earendil-works/pi-agent-core": "^0.76.0",
-    "@earendil-works/pi-ai": "^0.76.0",
-    "@earendil-works/pi-coding-agent": "^0.76.0",
+    "@earendil-works/pi-agent-core": "^0.78.0",
+    "@earendil-works/pi-ai": "^0.78.0",
+    "@earendil-works/pi-coding-agent": "^0.78.0",
     "@modelcontextprotocol/sdk": "^1.25.1",
     "@openai/codex-sdk": "^0.135.0",
-    "@opencode-ai/sdk": "^1.15.12",
+    "@opencode-ai/sdk": "^1.15.13",
     "@openfort/openfort-node": "^0.9.1",
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/exporter-trace-otlp-http": "^0.218.0",

package/src/be/db.ts

@@ -691,6 +691,14 @@ export function createAgent(
       agent.harnessProvider ?? null,
     );
   if (!row) throw new Error("Failed to create agent");
+  try {
+    installSystemDefaultSkillsForAgent(id);
+  } catch (err) {
+    console.warn(
+      "[db] Failed to install system-default skills for new agent:",
+      (err as Error).message,
+    );
+  }
   try {
     createLogEntry({ eventType: "agent_joined", agentId: id, newValue: agent.status });
   } catch {}
@@ -8247,6 +8255,7 @@ type SkillRow = {
   userInvocable: number;
   version: number;
   isEnabled: number;
+  systemDefault: number;
   createdAt: string;
   lastUpdatedAt: string;
   lastFetchedAt: string | null;
@@ -8276,6 +8285,7 @@ function rowToSkill(row: SkillRow): Skill {
     userInvocable: row.userInvocable === 1,
     version: row.version,
     isEnabled: row.isEnabled === 1,
+    systemDefault: row.systemDefault === 1,
     createdAt: row.createdAt,
     lastUpdatedAt: row.lastUpdatedAt,
     lastFetchedAt: row.lastFetchedAt,
@@ -8300,7 +8310,12 @@ function rowToAgentSkill(row: AgentSkillRow): AgentSkill {
   };
 }
 
-type SkillWithInstallRow = SkillRow & { isActive: number; installedAt: string };
+type SkillWithInstallRow = SkillRow & {
+  isActive: number;
+  installedAt: string;
+  sourceRank?: number;
+  typeRank?: number;
+};
 
 function rowToSkillWithInstall(row: SkillWithInstallRow): SkillWithInstallInfo {
   return {
@@ -8330,6 +8345,7 @@ export interface SkillInsert {
   agent?: string;
   disableModelInvocation?: boolean;
   userInvocable?: boolean;
+  systemDefault?: boolean;
 }
 
 export function createSkill(data: SkillInsert): Skill {
@@ -8342,8 +8358,8 @@ export function createSkill(data: SkillInsert): Skill {
         id, name, description, content, type, scope, ownerAgentId,
         sourceUrl, sourceRepo, sourcePath, sourceBranch, sourceHash, isComplex,
         allowedTools, model, effort, context, agent, disableModelInvocation, userInvocable,
-        version, isEnabled, createdAt, lastUpdatedAt
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, 1, ?, ?) RETURNING *`,
+        version, isEnabled, systemDefault, createdAt, lastUpdatedAt
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, 1, ?, ?, ?) RETURNING *`,
     )
     .get(
       id,
@@ -8366,6 +8382,7 @@ export function createSkill(data: SkillInsert): Skill {
       data.agent ?? null,
       data.disableModelInvocation ? 1 : 0,
       data.userInvocable === false ? 0 : 1,
+      data.systemDefault ? 1 : 0,
       now,
       now,
     );
@@ -8405,6 +8422,10 @@ export function updateSkill(
     sets.push("isEnabled = ?");
     params.push(updates.isEnabled ? 1 : 0);
   }
+  if (updates.systemDefault !== undefined) {
+    sets.push("systemDefault = ?");
+    params.push(updates.systemDefault ? 1 : 0);
+  }
   if (updates.allowedTools !== undefined) {
     sets.push("allowedTools = ?");
     params.push(updates.allowedTools ?? null);
@@ -8516,7 +8537,7 @@ export interface SkillFilters {
  * which is replaced with an empty string so the row still satisfies `Skill`.
  */
 const SKILL_SLIM_COLUMNS =
-  "id, name, description, type, scope, ownerAgentId, sourceUrl, sourceRepo, sourcePath, sourceBranch, sourceHash, isComplex, allowedTools, model, effort, context, agent, disableModelInvocation, userInvocable, version, isEnabled, createdAt, lastUpdatedAt, lastFetchedAt, '' as content";
+  "id, name, description, type, scope, ownerAgentId, sourceUrl, sourceRepo, sourcePath, sourceBranch, sourceHash, isComplex, allowedTools, model, effort, context, agent, disableModelInvocation, userInvocable, version, isEnabled, systemDefault, createdAt, lastUpdatedAt, lastFetchedAt, '' as content";
 
 export function listSkills(filters?: SkillFilters): Skill[] {
   const columns = filters?.includeContent === false ? SKILL_SLIM_COLUMNS : "*";
@@ -8586,6 +8607,19 @@ export function installSkill(agentId: string, skillId: string): AgentSkill {
   return rowToAgentSkill(row);
 }
 
+export function getSystemDefaultSkills(): Skill[] {
+  return getDb()
+    .prepare<SkillRow, []>(
+      "SELECT * FROM skills WHERE systemDefault = 1 AND isEnabled = 1 ORDER BY name ASC",
+    )
+    .all()
+    .map(rowToSkill);
+}
+
+export function installSystemDefaultSkillsForAgent(agentId: string): AgentSkill[] {
+  return getSystemDefaultSkills().map((skill) => installSkill(agentId, skill.id));
+}
+
 export function uninstallSkill(agentId: string, skillId: string): boolean {
   const result = getDb()
     .prepare("DELETE FROM agent_skills WHERE agentId = ? AND skillId = ?")
@@ -8595,15 +8629,23 @@ export function uninstallSkill(agentId: string, skillId: string): boolean {
 
 export function getAgentSkills(agentId: string, activeOnly = true): SkillWithInstallInfo[] {
   const query = `
-    SELECT s.*, as2.isActive, as2.installedAt
+    SELECT s.*, as2.isActive, as2.installedAt, 0 as sourceRank,
+      CASE WHEN s.type = 'personal' THEN 0 ELSE 1 END as typeRank
     FROM skills s
     JOIN agent_skills as2 ON s.id = as2.skillId
     WHERE as2.agentId = ?
       ${activeOnly ? "AND as2.isActive = 1" : ""}
       AND s.isEnabled = 1
+    UNION ALL
+    SELECT s.*, 1 as isActive, s.createdAt as installedAt, 1 as sourceRank,
+      CASE WHEN s.type = 'personal' THEN 0 ELSE 1 END as typeRank
+    FROM skills s
+    WHERE s.systemDefault = 1
+      AND s.isEnabled = 1
     ORDER BY
-      CASE WHEN s.type = 'personal' THEN 0 ELSE 1 END,
-      s.name
+      sourceRank,
+      typeRank,
+      name
   `;
 
   const rows = getDb().prepare<SkillWithInstallRow, [string]>(query).all(agentId);

package/src/be/migrations/080_skill_system_defaults.sql

@@ -0,0 +1,8 @@
+-- 080_skill_system_defaults.sql
+-- Adds a first-class marker for skills that are installed for every agent.
+-- Forward migration: add nullable-safe column with default 0.
+-- Reverse operation, if ever needed: ALTER TABLE skills DROP COLUMN systemDefault;
+
+ALTER TABLE skills ADD COLUMN systemDefault INTEGER NOT NULL DEFAULT 0;
+
+CREATE INDEX IF NOT EXISTS idx_skills_system_default ON skills(systemDefault);