@agentskit/cli 0.10.1 → 0.11.0

package/dist/bin.cjs

@@ -23,6 +23,7 @@ var kleur = require('kleur');
 var chokidar = require('chokidar');
 var rag = require('@agentskit/rag');
 var agentSchema = require('@agentskit/core/agent-schema');
+var yaml = require('yaml');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
@@ -4084,6 +4085,81 @@ function registerAiCommand(program) {
 `);
   });
 }
+async function loadDefinition(file) {
+  const raw = await promises.readFile(path.resolve(file), "utf8");
+  const parsed = file.endsWith(".json") ? JSON.parse(raw) : yaml.parse(raw);
+  if (!parsed || typeof parsed !== "object") throw new Error("flow file must be an object");
+  const def = parsed;
+  if (!def.name || !Array.isArray(def.nodes)) {
+    throw new Error("flow file must have `name` and `nodes[]`");
+  }
+  return def;
+}
+async function loadRegistry(modulePath) {
+  const url$1 = url.pathToFileURL(path.resolve(modulePath)).href;
+  const mod = await import(url$1);
+  const registry = mod.default ?? mod.registry;
+  if (!registry || typeof registry !== "object") {
+    throw new Error(`registry module "${modulePath}" must default-export a FlowRegistry`);
+  }
+  return registry;
+}
+function registerFlowCommand(program) {
+  const flow = program.command("flow").description("Compile and run visual YAML flows as durable DAGs.");
+  flow.command("validate <file>").description("Type-check a flow file: ids, handlers (when --registry given), deps, cycles.").option("--registry <module>", "JS/TS module exporting FlowRegistry as default").action(async (file, options) => {
+    try {
+      const def = await loadDefinition(file);
+      const registry = options.registry ? await loadRegistry(options.registry) : void 0;
+      const result = runtime.validateFlow(def, registry);
+      if (result.ok) {
+        process.stdout.write(`flow "${def.name}" ok \u2014 ${result.order.length} node(s), order: ${result.order.join(" \u2192 ")}
+`);
+        return;
+      }
+      for (const issue of result.issues) {
+        process.stderr.write(`  \u2717 [${issue.code}] ${issue.message}
+`);
+      }
+      process.exit(1);
+    } catch (err) {
+      process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
+`);
+      process.exit(1);
+    }
+  });
+  flow.command("render <file>").description("Emit a Mermaid flowchart for the flow.").action(async (file) => {
+    try {
+      const def = await loadDefinition(file);
+      process.stdout.write(runtime.flowToMermaid(def) + "\n");
+    } catch (err) {
+      process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
+`);
+      process.exit(1);
+    }
+  });
+  flow.command("run <file>").description("Compile and execute a flow with a handler registry.").requiredOption("--registry <module>", "JS/TS module exporting FlowRegistry as default").option("--input <json>", "JSON string passed to handlers as ctx.input").option("--store <path>", "Persist durable step log as JSONL at <path>").option("--run-id <id>", "Resume a previous run by reusing its id").option("--max-attempts <n>", "Retries per node (default 1)", "1").option("--retry-delay <ms>", "Delay between attempts in ms", "0").option("--verbose", "Stream node events to stderr").action(async (file, options) => {
+    try {
+      const def = await loadDefinition(file);
+      const registry = await loadRegistry(options.registry);
+      const compiled = runtime.compileFlow({ definition: def, registry });
+      const input2 = options.input ? JSON.parse(options.input) : void 0;
+      const store = options.store ? await runtime.createFileStepLog(path.resolve(options.store)) : void 0;
+      const onEvent = options.verbose ? (e) => process.stderr.write(JSON.stringify(e) + "\n") : void 0;
+      const outputs = await compiled.run(input2, {
+        runId: options.runId,
+        store,
+        maxAttempts: Number(options.maxAttempts),
+        retryDelayMs: Number(options.retryDelay),
+        onEvent
+      });
+      process.stdout.write(JSON.stringify(outputs, null, 2) + "\n");
+    } catch (err) {
+      process.stderr.write(`Error: ${err instanceof Error ? err.message : String(err)}
+`);
+      process.exit(1);
+    }
+  });
+}
 
 // src/commands/index.ts
 function createCli() {
@@ -4098,6 +4174,7 @@ function createCli() {
   registerTunnelCommand(program);
   registerRagCommand(program);
   registerAiCommand(program);
+  registerFlowCommand(program);
   return program;
 }