@desplega.ai/agent-swarm 1.149.0 → 1.149.1

package/src/tests/seed-schedules.test.ts

@@ -39,6 +39,35 @@ function scheduleSource(cron = "0 9 * * *", description = "Seeded schedule.") {
   } satisfies ScheduleTemplateSource;
 }
 
+/** A zero-config candidate: no requires, no placeholders — eligible for auto-enable. */
+function zeroConfigScheduleSource(opts?: {
+  name?: string;
+  templateEnabled?: boolean;
+  autoEnableCandidate?: boolean;
+}) {
+  const name = opts?.name ?? "test-zero-config-schedule";
+  const templateEnabled = opts?.templateEnabled ?? true;
+  return {
+    config: JSON.stringify({
+      name,
+      title: "Test zero-config schedule",
+      description: "Zero-config seeded schedule.",
+      placeholders: [],
+      requires: [],
+      runAllSeedersCandidate: true,
+      autoEnableCandidate: opts?.autoEnableCandidate ?? true,
+      tags: ["fixture"],
+    }),
+    content: `# Test\n\n## Schedule\n\n\`\`\`json\n${JSON.stringify({
+      cron: "0 9 * * *",
+      timezone: "UTC",
+      enabled: templateEnabled,
+    })}\n\`\`\`\n\n## Scheduled Task\n\nRun work.`,
+  } satisfies ScheduleTemplateSource;
+}
+
+const ORIGINAL_SEED_AUTOMATIONS_ENABLED = process.env.SEED_AUTOMATIONS_ENABLED;
+
 beforeEach(async () => {
   await removeDbFiles();
   initDb(TEST_DB_PATH);
@@ -47,15 +76,29 @@ beforeEach(async () => {
 afterEach(async () => {
   closeDb();
   await removeDbFiles();
+  if (ORIGINAL_SEED_AUTOMATIONS_ENABLED === undefined) {
+    delete process.env.SEED_AUTOMATIONS_ENABLED;
+  } else {
+    process.env.SEED_AUTOMATIONS_ENABLED = ORIGINAL_SEED_AUTOMATIONS_ENABLED;
+  }
 });
 
 describe("schedules seeder", () => {
-  test("loads only the four starter candidates, including the unfenced schedule block", () => {
+  test("loads only the five starter candidates, including the unfenced schedule block", () => {
     const schedules = loadSeedSchedules();
-    expect(schedules).toHaveLength(4);
+    expect(schedules).toHaveLength(5);
+    // Zero-config, requires:[], placeholders:[], template enabled:true -> auto-enabled
+    // under the default (unset -> on) SEED_AUTOMATIONS_ENABLED switch.
     expect(schedules.find((schedule) => schedule.name === "daily-status-report")).toMatchObject({
       cronExpression: "15 2 * * *",
-      enabled: false,
+      enabled: true,
+      requiredParams: [],
+      requires: [],
+    });
+    expect(
+      schedules.find((schedule) => schedule.name === "daily-swarm-update-check"),
+    ).toMatchObject({
+      enabled: true,
       requiredParams: [],
       requires: [],
     });
@@ -65,6 +108,59 @@ describe("schedules seeder", () => {
     );
   });
 
+  test("SEED_AUTOMATIONS_ENABLED=false keeps every candidate disabled, including zero-config ones", () => {
+    process.env.SEED_AUTOMATIONS_ENABLED = "false";
+    const schedules = loadSeedSchedules();
+    expect(schedules.every((schedule) => schedule.enabled === false)).toBe(true);
+  });
+
+  test("switch on: a zero-config candidate auto-enables via createSchedulesSeeder/apply", async () => {
+    delete process.env.SEED_AUTOMATIONS_ENABLED;
+    const seeder = createSchedulesSeeder([zeroConfigScheduleSource()]);
+    await runSeeder(seeder, { quiet: true });
+    expect(await getScheduledTaskByName("test-zero-config-schedule")).toMatchObject({
+      enabled: true,
+    });
+  });
+
+  test("switch on: an item with unmet requires stays disabled", async () => {
+    delete process.env.SEED_AUTOMATIONS_ENABLED;
+    const seeder = createSchedulesSeeder([scheduleSource()]);
+    await runSeeder(seeder, { quiet: true });
+    expect(await getScheduledTaskByName("test-seeded-schedule")).toMatchObject({
+      enabled: false,
+    });
+  });
+
+  test("switch off: a zero-config candidate stays disabled", async () => {
+    process.env.SEED_AUTOMATIONS_ENABLED = "false";
+    const seeder = createSchedulesSeeder([zeroConfigScheduleSource()]);
+    await runSeeder(seeder, { quiet: true });
+    expect(await getScheduledTaskByName("test-zero-config-schedule")).toMatchObject({
+      enabled: false,
+    });
+  });
+
+  test("switch on: a zero-config candidate whose template recommends staying off stays disabled", async () => {
+    delete process.env.SEED_AUTOMATIONS_ENABLED;
+    const seeder = createSchedulesSeeder([zeroConfigScheduleSource({ templateEnabled: false })]);
+    await runSeeder(seeder, { quiet: true });
+    expect(await getScheduledTaskByName("test-zero-config-schedule")).toMatchObject({
+      enabled: false,
+    });
+  });
+
+  test("switch on: a zero-config candidate without an explicit autoEnableCandidate opt-in stays disabled", async () => {
+    delete process.env.SEED_AUTOMATIONS_ENABLED;
+    const seeder = createSchedulesSeeder([
+      zeroConfigScheduleSource({ autoEnableCandidate: false }),
+    ]);
+    await runSeeder(seeder, { quiet: true });
+    expect(await getScheduledTaskByName("test-zero-config-schedule")).toMatchObject({
+      enabled: false,
+    });
+  });
+
   test("seeds a schedule with setup metadata and re-runs as a no-op", async () => {
     const seeder = createSchedulesSeeder([scheduleSource()]);
     const first = await runSeeder(seeder, { quiet: true });

package/src/tests/seed-workflows.test.ts

@@ -35,10 +35,36 @@ function workflowSource(template = "Do the work.", description = "Seeded workflo
   } satisfies WorkflowTemplateSource;
 }
 
+/** A zero-config candidate: no requires, no placeholders — eligible for auto-enable. */
+function zeroConfigWorkflowSource(opts?: {
+  name?: string;
+  templateEnabled?: boolean;
+  autoEnableCandidate?: boolean;
+}) {
+  const name = opts?.name ?? "test-zero-config-workflow";
+  const payloadEnabled = opts?.templateEnabled === false ? { enabled: false } : {};
+  return {
+    config: JSON.stringify({
+      name,
+      description: "Zero-config seeded workflow.",
+      placeholders: [],
+      requires: [],
+      runAllSeedersCandidate: true,
+      autoEnableCandidate: opts?.autoEnableCandidate ?? true,
+    }),
+    content: `# Test\n\n\`\`\`json\n${JSON.stringify({
+      nodes: [{ id: "work", type: "agent-task", config: { template: "Do the work." } }],
+      ...payloadEnabled,
+    })}\n\`\`\``,
+  } satisfies WorkflowTemplateSource;
+}
+
 async function getWorkflow(name = "test-seeded-workflow") {
   return (await listWorkflows()).find((workflow) => workflow.name === name) ?? null;
 }
 
+const ORIGINAL_SEED_AUTOMATIONS_ENABLED = process.env.SEED_AUTOMATIONS_ENABLED;
+
 beforeEach(async () => {
   await removeDbFiles();
   initDb(TEST_DB_PATH);
@@ -47,6 +73,11 @@ beforeEach(async () => {
 afterEach(async () => {
   closeDb();
   await removeDbFiles();
+  if (ORIGINAL_SEED_AUTOMATIONS_ENABLED === undefined) {
+    delete process.env.SEED_AUTOMATIONS_ENABLED;
+  } else {
+    process.env.SEED_AUTOMATIONS_ENABLED = ORIGINAL_SEED_AUTOMATIONS_ENABLED;
+  }
 });
 
 describe("workflows seeder", () => {
@@ -65,6 +96,49 @@ describe("workflows seeder", () => {
     expect(workflows.some((workflow) => workflow.name === "gsc-topic-miner")).toBe(false);
   });
 
+  test("SEED_AUTOMATIONS_ENABLED=false keeps every candidate disabled, including zero-config ones", () => {
+    process.env.SEED_AUTOMATIONS_ENABLED = "false";
+    const workflows = loadSeedWorkflows();
+    expect(workflows.every((workflow) => workflow.enabled === false)).toBe(true);
+  });
+
+  test("switch on: a zero-config candidate auto-enables via createWorkflowsSeeder/apply", async () => {
+    delete process.env.SEED_AUTOMATIONS_ENABLED;
+    const seeder = createWorkflowsSeeder([zeroConfigWorkflowSource()]);
+    await runSeeder(seeder, { quiet: true });
+    expect(await getWorkflow("test-zero-config-workflow")).toMatchObject({ enabled: true });
+  });
+
+  test("switch on: an item with unmet requires stays disabled", async () => {
+    delete process.env.SEED_AUTOMATIONS_ENABLED;
+    const seeder = createWorkflowsSeeder([workflowSource()]);
+    await runSeeder(seeder, { quiet: true });
+    expect(await getWorkflow()).toMatchObject({ enabled: false });
+  });
+
+  test("switch off: a zero-config candidate stays disabled", async () => {
+    process.env.SEED_AUTOMATIONS_ENABLED = "false";
+    const seeder = createWorkflowsSeeder([zeroConfigWorkflowSource()]);
+    await runSeeder(seeder, { quiet: true });
+    expect(await getWorkflow("test-zero-config-workflow")).toMatchObject({ enabled: false });
+  });
+
+  test("switch on: a zero-config candidate whose template recommends staying off stays disabled", async () => {
+    delete process.env.SEED_AUTOMATIONS_ENABLED;
+    const seeder = createWorkflowsSeeder([zeroConfigWorkflowSource({ templateEnabled: false })]);
+    await runSeeder(seeder, { quiet: true });
+    expect(await getWorkflow("test-zero-config-workflow")).toMatchObject({ enabled: false });
+  });
+
+  test("switch on: a zero-config candidate without an explicit autoEnableCandidate opt-in stays disabled", async () => {
+    delete process.env.SEED_AUTOMATIONS_ENABLED;
+    const seeder = createWorkflowsSeeder([
+      zeroConfigWorkflowSource({ autoEnableCandidate: false }),
+    ]);
+    await runSeeder(seeder, { quiet: true });
+    expect(await getWorkflow("test-zero-config-workflow")).toMatchObject({ enabled: false });
+  });
+
   test("seeds a workflow and re-runs as a no-op", async () => {
     const seeder = createWorkflowsSeeder([workflowSource()]);
     const first = await runSeeder(seeder, { quiet: true });

package/templates/schedules/daily-blocker-digest/config.json

@@ -10,5 +10,10 @@
   "placeholders": [],
   "requires": [],
   "runAllSeedersCandidate": true,
-  "tags": ["operations", "slack", "digest"]
+  "autoEnableCandidate": true,
+  "tags": [
+    "operations",
+    "slack",
+    "digest"
+  ]
 }

package/templates/schedules/daily-compounding-reflection/config.json

@@ -10,6 +10,7 @@
   "placeholders": [],
   "requires": [],
   "runAllSeedersCandidate": true,
+  "autoEnableCandidate": true,
   "tags": [
     "memory",
     "skills",

package/templates/schedules/daily-status-report/config.json

@@ -10,5 +10,10 @@
   "placeholders": [],
   "requires": [],
   "runAllSeedersCandidate": true,
-  "tags": ["operations", "status", "digest"]
+  "autoEnableCandidate": true,
+  "tags": [
+    "operations",
+    "status",
+    "digest"
+  ]
 }

package/templates/schedules/daily-swarm-update-check/config.json

@@ -0,0 +1,19 @@
+{
+  "kind": "schedule",
+  "name": "daily-swarm-update-check",
+  "displayName": "Daily Agent-Swarm Update Check",
+  "slug": "daily-swarm-update-check",
+  "title": "Daily Agent-Swarm Update Check",
+  "description": "Compare the running agent-swarm version against the latest published GitHub release and flag the operator when an upgrade is available. Zero-config: no repo clone, no integration required.",
+  "version": "1.0.0",
+  "category": "schedules",
+  "placeholders": [],
+  "requires": [],
+  "runAllSeedersCandidate": true,
+  "autoEnableCandidate": true,
+  "tags": [
+    "operations",
+    "release",
+    "upgrade"
+  ]
+}

package/templates/schedules/daily-swarm-update-check/content.md

@@ -0,0 +1,49 @@
+# Daily Agent-Swarm Update Check
+
+Zero-config auto-update watchdog: compares the swarm's own running version against the latest published GitHub release of `desplega-ai/agent-swarm`, and flags the operator when an upgrade is available. No placeholders and no integration required — every install gets this by default.
+
+## Schedule
+
+```json
+{"cron":"0 9 * * *","timezone":"UTC","agentRole":"lead","enabled":true}
+```
+
+## Scheduled Task
+
+This schedule runs by default. It needs no repository clone and no integration — it only reads its own task metadata and calls the public GitHub API.
+
+Task Type: Daily Agent-Swarm Update Check
+
+You are Lead. Determine whether a newer `desplega-ai/agent-swarm` release is published than the version currently running on this install, and tell the operator if so.
+
+## Phase 1 — Determine the running version
+
+Call `get-task-details` for THIS task's own id and read `task.swarmVersion` — the API server stamps every task with the `package.json` version it was running at task-creation time, so this is the version currently deployed on this install.
+
+If `swarmVersion` is missing or empty (an older install, or the field predates this schedule), complete with `output`: `"Unable to determine running version — swarmVersion not set on this task."` and stop. Do not guess a version.
+
+## Phase 2 — Fetch the latest published release
+
+```bash
+curl -fsSL https://api.github.com/repos/desplega-ai/agent-swarm/releases/latest
+```
+
+Read `.tag_name` (strip a leading `v` if present) and `.html_url`. If the request fails (network, rate limit, non-200), complete with `output`: `"Could not reach GitHub releases API: <error>"` and stop — do not retry in a loop.
+
+## Phase 3 — Compare and act
+
+Compare the two versions as dotted numeric triples (major.minor.patch) — never as plain strings (`"1.9.0" < "1.10.0"` is false as strings).
+
+- **Latest <= running:** complete with `output`: `"Up to date: running <running>, latest published <latest>."` No further action.
+- **Latest > running:** raise it for the operator:
+  1. Post a short message to your configured admin delivery channel (or the in-app fallback if none is configured) naming the running version, the new version, and the release URL.
+  2. Complete `store-progress` with `status: "completed"` and `output`: `"Update available: running <running>, latest <latest> — <releaseUrl>"`.
+
+Do not attempt the upgrade yourself — this schedule only detects and reports. `weekly-harness-upgrade-check` is the separate routine that bumps pinned harness versions inside the repo; this schedule is about the agent-swarm release itself.
+
+## Anti-patterns
+
+- ❌ Cloning the repo or reading `package.json` from disk — this schedule must work on any install, including ones where the API pod has no repo checkout.
+- ❌ String-comparing versions.
+- ❌ Treating a missing `swarmVersion` as "no update available" — it's "unknown", say so explicitly.
+- ❌ Retrying a failed GitHub API call in a loop.

package/templates/schedules/daily-workflow-health-audit/config.json

@@ -10,5 +10,10 @@
   "placeholders": [],
   "requires": [],
   "runAllSeedersCandidate": true,
-  "tags": ["workflows", "schedules", "reliability"]
+  "autoEnableCandidate": true,
+  "tags": [
+    "workflows",
+    "schedules",
+    "reliability"
+  ]
 }