@agentic-surfaces/cli 0.1.0

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { run } from "./index.js";
+run(process.argv.slice(2)).then(code => process.exit(code));

package/dist/index.d.ts

@@ -0,0 +1 @@
+export declare function run(argv: string[]): Promise<number>;

package/dist/index.js

@@ -0,0 +1,46 @@
+import { readFileSync, readdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { loadWorkflow, runWorkflowOnce, Scheduler, loadProjectConfig } from "@agentic-surfaces/core";
+import { buildServices } from "./services.js";
+export async function run(argv) {
+    const [cmd, ...rest] = argv;
+    try {
+        if (cmd === "validate") {
+            loadWorkflow(readFileSync(rest[0], "utf8"));
+            console.log("OK:", rest[0]);
+            return 0;
+        }
+        if (cmd === "run-once") {
+            const file = rest.find(a => !a.startsWith("--"));
+            if (!file) {
+                console.error("run-once: missing workflow file");
+                return 1;
+            }
+            const fake = rest.includes("--fake");
+            const pc = loadProjectConfig(dirname(file));
+            const wf = loadWorkflow(readFileSync(file, "utf8"));
+            const services = buildServices(fake ? { fakeAgent: [{ text: "fake reply" }], projectConfig: pc } : { projectConfig: pc });
+            const outputs = await runWorkflowOnce(wf, { services });
+            console.log("ran", wf.name, "->", [...outputs.keys()].join(", "));
+            return 0;
+        }
+        if (cmd === "start") {
+            const dir = rest[0] ?? ".";
+            const pc = loadProjectConfig(dir);
+            const workflowsDir = pc?.workflows ? join(dir, pc.workflows) : dir;
+            const services = buildServices({ projectConfig: pc });
+            const sched = new Scheduler(services);
+            for (const f of readdirSync(workflowsDir).filter(f => f.endsWith(".yaml") && f !== "agentic-surfaces.config.yaml"))
+                sched.add(loadWorkflow(readFileSync(join(workflowsDir, f), "utf8")));
+            sched.start();
+            console.log("scheduler started; watching", workflowsDir);
+            return 0;
+        }
+        console.error("usage: flow <validate|run-once|start> ...");
+        return 1;
+    }
+    catch (err) {
+        console.error("error:", err instanceof Error ? err.message : String(err));
+        return 1;
+    }
+}

package/dist/services.d.ts

@@ -0,0 +1,7 @@
+import { type ProjectConfig } from "@agentic-surfaces/core";
+import { type AgentResult } from "@agentic-surfaces/agent";
+import type { Services } from "@agentic-surfaces/core";
+export declare function buildServices(opts?: {
+    fakeAgent?: AgentResult[];
+    projectConfig?: ProjectConfig;
+}): Services;

package/dist/services.js

@@ -0,0 +1,18 @@
+import { SqliteCache } from "@agentic-surfaces/core";
+import { ClaudeAgentRunner } from "@agentic-surfaces/agent";
+import { FakeAgentRunner } from "@agentic-surfaces/agent/testing";
+export function buildServices(opts = {}) {
+    const pc = opts.projectConfig;
+    return {
+        agent: opts.fakeAgent ? new FakeAgentRunner(opts.fakeAgent) : new ClaudeAgentRunner({ model: pc?.agent?.model }),
+        cache: new SqliteCache(".flow-cache.sqlite"),
+        logger: { info: (m, meta) => console.log(m, meta ?? ""), error: (m, meta) => console.error(m, meta ?? "") },
+        fetch: globalThis.fetch,
+        dryRun: pc?.dryRun ?? false,
+        agentDefaults: pc ? {
+            model: pc.agent?.model,
+            runner: pc.agent?.runner,
+            mcpServers: pc.agent?.mcpServers,
+        } : undefined,
+    };
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@agentic-surfaces/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "flow": "dist/bin.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@agentic-surfaces/core": "0.1.0",
+    "@agentic-surfaces/agent": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run --root ../.."
+  }
+}