@agent-compose/cli 0.2.1 → 0.3.0

package/README.md

@@ -102,11 +102,14 @@ Claude Code session running inside this repo:
 | Skill | What it does |
 |---|---|
 | `/ac:setup` | Walks first-time setup against an existing server |
-| `/ac:demo` | Guided first-run walkthrough |
+| `/ac:tutorial` | Hands-on tutorial — register, invoke, schedule, emit events, capture snapshots (~10 min) |
 | `/ac:register` | Bundle + register the current workflow |
 | `/ac:invoke` | Dispatch a registered workflow with input |
 | `/ac:register-invoke` | Register-then-invoke combo for fast iteration |
+| `/ac:schedule` | Create / list / delete cron schedules on a registered workflow |
 | `/ac:logs` | Tail logs for a running run |
+| `/ac:events` | Send / list run events |
+| `/ac:snapshots` | List / inspect / delete captured sandbox snapshots |
 | `/ac:secrets` | Manage per-workflow secrets |
 | `/ac:generate-workflow` | Scaffold a new workflow from a plain-English description |
 | `/ac:generate-agent` | Scaffold an agent prompt + iteration logic |

package/dist/index.js

@@ -3,8 +3,8 @@ import { createRequire } from "node:module";
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // src/index.ts
-import { readFileSync as readFileSync5 } from "node:fs";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
+import { readFileSync as readFileSync6 } from "node:fs";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
 import { program } from "commander";
 
 // src/commands/register.ts
@@ -1159,14 +1159,95 @@ var listCommand2 = new Command13("list").description("List events for a run, or
 });
 var eventsCommand = new Command13("events").description("Send or list run events (Events API)").addCommand(sendCommand).addCommand(listCommand2);
 
-// src/update-check.ts
+// src/commands/schedule.ts
+import { Command as Command14 } from "commander";
+var sharedOpts2 = (cmd) => cmd.option("--factory <slug>", `Factory the schedule lives in (default: ${defaultFactory})`, defaultFactory).option("--url <url>", "Server URL", parseUrlFlag, defaultUrl).option("--api-key <key>", "API key", defaultApiKey);
+var scheduleCommand = new Command14("schedule").description("Manage cron schedules attached to registered workflows");
+sharedOpts2(scheduleCommand.command("create <name>").description("Create a new schedule for a workflow").requiredOption("--workflow <name>", "The registered workflow this schedule should fire").requiredOption("--cron <expr>", "Cron expression (UTC) — e.g. '0 9 * * *'")).action(async (name, opts) => {
+  const client = makeClient(opts);
+  const created = await client.createSchedule({
+    name,
+    workflow: opts.workflow,
+    cron: opts.cron,
+    factorySlug: opts.factory
+  });
+  console.log(`✓ Schedule "${created.name}" → workflow "${created.workflow}" @ "${created.cron}" (${created.id})`);
+});
+sharedOpts2(scheduleCommand.command("list").description("List schedules in a factory")).action(async (opts) => {
+  const client = makeClient(opts);
+  const rows = await client.listSchedules(opts.factory);
+  if (rows.length === 0) {
+    console.log(`No schedules in factory "${opts.factory}"`);
+    return;
+  }
+  console.log(`Schedules in factory "${opts.factory}":`);
+  for (const s of rows) {
+    const next = s.nextFireAt ? new Date(s.nextFireAt).toLocaleString() : "—";
+    console.log(`  ${s.name.padEnd(24)} ${s.workflowName.padEnd(20)} ${s.cron.padEnd(16)} next: ${next}  ${s.id}`);
+  }
+});
+sharedOpts2(scheduleCommand.command("delete <id>").description("Delete a schedule by id")).action(async (id, opts) => {
+  const client = makeClient(opts);
+  await client.deleteSchedule(id, opts.factory);
+  console.log(`✓ Schedule ${id} deleted from factory "${opts.factory}"`);
+});
+
+// src/commands/upgrade.ts
+import { Command as Command15 } from "commander";
 import { spawnSync } from "node:child_process";
-import { mkdirSync as mkdirSync2, readFileSync as readFileSync4, writeFileSync } from "node:fs";
+import { readFileSync as readFileSync4 } from "node:fs";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+import pc4 from "picocolors";
+var PACKAGE_NAME = "@agent-compose/cli";
+var upgradeCommand = new Command15("upgrade").description("Update the agentc CLI to the latest published version").option("--check", "Check for updates without installing", false).action(async (opts) => {
+  const pkg = JSON.parse(readFileSync4(fileURLToPath2(new URL("../../package.json", import.meta.url)), "utf8"));
+  const current = pkg.version;
+  const controller = new AbortController;
+  const timeout = setTimeout(() => controller.abort(), 5000);
+  let latest = null;
+  try {
+    const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, {
+      signal: controller.signal,
+      headers: { Accept: "application/json" }
+    });
+    if (res.ok) {
+      const body = await res.json();
+      if (typeof body.version === "string")
+        latest = body.version;
+    }
+  } catch {} finally {
+    clearTimeout(timeout);
+  }
+  if (!latest) {
+    console.error(`${pc4.red("✗")} Couldn't reach the npm registry. Check your connection and try again.`);
+    process.exit(1);
+  }
+  if (latest === current) {
+    console.log(`${pc4.green("✓")} You're on the latest version (${pc4.bold(current)}).`);
+    return;
+  }
+  console.log(`${pc4.yellow("●")} agentc ${pc4.bold(latest)} is available (you have ${current}).`);
+  if (opts.check) {
+    console.log(`  Run ${pc4.cyan("agentc upgrade")} to install, or ${pc4.cyan("npm install -g " + PACKAGE_NAME + "@latest")} manually.`);
+    return;
+  }
+  console.log(`  Running ${pc4.cyan("npm install -g " + PACKAGE_NAME + "@latest")} …`);
+  const result = spawnSync("npm", ["install", "-g", `${PACKAGE_NAME}@latest`], { stdio: "inherit" });
+  if (result.status !== 0) {
+    console.error(`${pc4.red("✗")} Install failed. Run the command above manually, or check for permission issues (npm prefix / sudo).`);
+    process.exit(1);
+  }
+  console.log(`${pc4.green("✓")} Installed ${pc4.bold(`agentc ${latest}`)}.`);
+});
+
+// src/update-check.ts
+import { spawnSync as spawnSync2 } from "node:child_process";
+import { mkdirSync as mkdirSync2, readFileSync as readFileSync5, writeFileSync } from "node:fs";
 import { homedir as homedir3 } from "node:os";
 import { join as join3 } from "node:path";
 import { createInterface } from "node:readline/promises";
-import pc4 from "picocolors";
-var PACKAGE_NAME = "@agent-compose/cli";
+import pc5 from "picocolors";
+var PACKAGE_NAME2 = "@agent-compose/cli";
 var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
 var FETCH_TIMEOUT_MS = 2000;
 function cachePath() {
@@ -1201,7 +1282,7 @@ function isNewer(latest, current) {
 }
 function readCache() {
   try {
-    const raw = readFileSync4(cachePath(), "utf8");
+    const raw = readFileSync5(cachePath(), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed.checkedAt !== "number")
       return null;
@@ -1225,7 +1306,7 @@ async function fetchLatest() {
   const controller = new AbortController;
   const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
   try {
-    const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, {
+    const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME2}/latest`, {
       signal: controller.signal,
       headers: { Accept: "application/json" }
     });
@@ -1263,35 +1344,35 @@ async function checkForUpdate(currentVersion) {
   const latest = await resolveLatest();
   if (!latest || !isNewer(latest, currentVersion))
     return;
-  const headline = `${pc4.yellow("●")} agentc ${pc4.bold(latest)} is available (you have ${currentVersion}).`;
+  const headline = `${pc5.yellow("●")} agentc ${pc5.bold(latest)} is available (you have ${currentVersion}).`;
   process.stderr.write(`${headline}
 `);
   if (!process.stdin.isTTY) {
-    process.stderr.write(`  Run ${pc4.cyan("npm install -g " + PACKAGE_NAME + "@latest")} to update.
+    process.stderr.write(`  Run ${pc5.cyan("npm install -g " + PACKAGE_NAME2 + "@latest")} to update.
 `);
     return;
   }
-  const confirm = await promptYesNo(`  Install now? [y/${pc4.bold("N")}] `);
+  const confirm = await promptYesNo(`  Install now? [y/${pc5.bold("N")}] `);
   if (!confirm)
     return;
-  process.stderr.write(`  Running ${pc4.cyan("npm install -g " + PACKAGE_NAME + "@latest")} …
+  process.stderr.write(`  Running ${pc5.cyan("npm install -g " + PACKAGE_NAME2 + "@latest")} …
 `);
-  const result = spawnSync("npm", ["install", "-g", `${PACKAGE_NAME}@latest`], {
+  const result = spawnSync2("npm", ["install", "-g", `${PACKAGE_NAME2}@latest`], {
     stdio: "inherit"
   });
   if (result.status !== 0) {
-    process.stderr.write(`${pc4.red("✗")} Install failed. Run the command above manually.
+    process.stderr.write(`${pc5.red("✗")} Install failed. Run the command above manually.
 `);
     return;
   }
-  process.stderr.write(`${pc4.green("✓")} Installed ${pc4.bold(`agentc ${latest}`)}. ` + `Re-run your command to use the new version.
+  process.stderr.write(`${pc5.green("✓")} Installed ${pc5.bold(`agentc ${latest}`)}. ` + `Re-run your command to use the new version.
 `);
   process.exit(0);
 }
 
 // src/index.ts
-var pkg = JSON.parse(readFileSync5(fileURLToPath2(new URL("../package.json", import.meta.url)), "utf8"));
-program.name("agentc").description("CLI for agent-compose — register, invoke, and monitor workflows").version(pkg.version);
+var pkg = JSON.parse(readFileSync6(fileURLToPath3(new URL("../package.json", import.meta.url)), "utf8"));
+program.name("agentc").description("Coordinate agent production lines.").version(pkg.version);
 program.hook("preAction", async () => {
   try {
     await checkForUpdate(pkg.version);
@@ -1300,14 +1381,34 @@ program.hook("preAction", async () => {
 program.addCommand(registerCommand);
 program.addCommand(invokeCommand);
 program.addCommand(listCommand);
+program.addCommand(cancelCommand);
+program.addCommand(scheduleCommand);
 program.addCommand(logsCommand);
-program.addCommand(initCommand);
+program.addCommand(eventsCommand);
+program.addCommand(factoryCommand);
+program.addCommand(snapshotCommand);
+program.addCommand(secretsCommand);
 program.addCommand(keysCommand);
 program.addCommand(authCommand);
-program.addCommand(secretsCommand);
 program.addCommand(usageCommand);
-program.addCommand(snapshotCommand);
-program.addCommand(factoryCommand);
-program.addCommand(cancelCommand);
-program.addCommand(eventsCommand);
+program.addCommand(initCommand);
+program.addCommand(upgradeCommand);
+program.addHelpText("after", `
+Topics:
+  Workflows         register, invoke, list, cancel
+  Scheduling        schedule
+  Run inspection    logs, events
+  Resources         factory, snapshot, secrets
+  Account           keys, auth, usage
+  Setup             init, upgrade
+
+Examples:
+  $ agentc register ./workflows/pipeline.ts
+  $ agentc invoke pipeline --follow
+  $ agentc schedule create nightly --workflow pipeline --cron '0 9 * * *'
+  $ agentc logs <run-id>
+
+Docs:
+  https://github.com/Layr-Labs/agent-compose
+`);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-compose/cli",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Command-line interface for agent-compose — register, invoke, and monitor workflows from your terminal.",
   "license": "MIT",
   "repository": {
@@ -35,21 +35,21 @@
     "node": ">=20"
   },
   "scripts": {
-    "typecheck":      "tsc --noEmit",
-    "test":           "bun test src/__tests__",
-    "build":          "bun run clean && bun run build:js && bun run build:chmod",
-    "build:js":       "bun build src/index.ts --outdir dist --target node --format esm --packages external --banner='#!/usr/bin/env bun'",
-    "build:chmod":    "chmod +x dist/index.js",
-    "clean":          "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test src/__tests__",
+    "build": "bun run clean && bun run build:js && bun run build:chmod",
+    "build:js": "bun build src/index.ts --outdir dist --target node --format esm --packages external --banner='#!/usr/bin/env bun'",
+    "build:chmod": "chmod +x dist/index.js",
+    "clean": "rm -rf dist",
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@agent-compose/sdk": "^0.3.0",
-    "commander":          "^12.0.0",
-    "picocolors":         "^1.1.1"
+    "@agent-compose/sdk": "^0.4.0",
+    "commander": "^12.0.0",
+    "picocolors": "^1.1.1"
   },
   "devDependencies": {
-    "bun-types":  "latest",
+    "bun-types": "latest",
     "typescript": "^5.8.0"
   },
   "publishConfig": {