@agentic-surfaces/cli 0.1.4 → 0.1.6

package/dist/index.js

@@ -1,9 +1,38 @@
-import { readFileSync, readdirSync } from "node:fs";
+import { readFileSync, readdirSync, existsSync } from "node:fs";
 import { join, dirname, resolve } from "node:path";
 import { spawn } from "node:child_process";
 import { loadWorkflow, runWorkflowOnce, Scheduler, loadProjectConfig, buildWorkflowRunner, defaultRegistry } from "@agentic-surfaces/core";
-import { serve } from "@agentic-surfaces/server";
+import { serve, StreamingObserver } from "@agentic-surfaces/server";
 import { buildServices } from "./services.js";
+const CONFIG = "agentic-surfaces.config.yaml";
+// Locate a project folder when none is given: check the dir, its ./agentic-surfaces
+// subfolder (the repo-native convention), then walk up. Lets `agentic-surfaces`
+// be run bare from a repo root and still find the config.
+function discoverProjectDir(start) {
+    let dir = resolve(start);
+    for (;;) {
+        if (existsSync(join(dir, CONFIG)))
+            return dir;
+        if (existsSync(join(dir, "agentic-surfaces", CONFIG)))
+            return join(dir, "agentic-surfaces");
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+// Load every workflow yaml in a folder into a name→Workflow map.
+function loadWorkflows(dir) {
+    const map = new Map();
+    for (const f of readdirSync(dir).filter((f) => f.endsWith(".yaml") && f !== CONFIG)) {
+        try {
+            const w = loadWorkflow(readFileSync(join(dir, f), "utf8"));
+            map.set(w.name, w);
+        }
+        catch { /* skip unparseable */ }
+    }
+    return map;
+}
 // `--ui`: start the live dashboard (HTTP server + SSE) and return its
 // StreamingObserver so run lifecycle events stream to the browser.
 function startUi() {
@@ -46,15 +75,52 @@ function findProjectConfig(startDir) {
 export async function run(argv) {
     const [cmd, ...rest] = argv;
     try {
+        // Default / `ui`: launch the visual control surface. `agentic-surfaces`
+        // (no args) discovers the project from the cwd; `ui <dir>` is explicit.
+        // Workflows are listed + Run-able from the browser; cron ones also fire.
+        if (cmd === undefined || cmd === "ui") {
+            const arg = rest.find((a) => !a.startsWith("--"));
+            const dir = arg ? resolve(arg) : discoverProjectDir(process.cwd());
+            if (!dir) {
+                console.error(`no ${CONFIG} found (looked in . and ./agentic-surfaces, then up).\n  pass a folder:  agentic-surfaces ui <projectDir>`);
+                return 1;
+            }
+            const pc = loadProjectConfig(dir);
+            const workflowsDir = pc?.workflows ? join(dir, pc.workflows) : dir;
+            const allWorkflows = loadWorkflows(workflowsDir);
+            const registry = defaultRegistry();
+            const observer = new StreamingObserver();
+            const services = buildServices({ projectConfig: pc });
+            const runWorkflowFn = buildWorkflowRunner({ workflows: allWorkflows, registry, services, observer });
+            const servicesWithRunner = { ...services, runWorkflow: runWorkflowFn };
+            // Cron-triggered workflows fire on schedule too.
+            const sched = new Scheduler(servicesWithRunner, registry, observer);
+            for (const [, w] of allWorkflows)
+                sched.add(w);
+            sched.start();
+            const port = parseInt(process.env["FLOW_UI_PORT"] ?? "4000", 10);
+            const { port: actualPort } = serve({
+                port,
+                observer,
+                workflows: [...allWorkflows.values()],
+                onRun: (name) => runWorkflowFn(name, undefined),
+            });
+            const url = `http://127.0.0.1:${actualPort}`;
+            openBrowser(url);
+            console.log(`\n▶ agentic-surfaces — ${url}`);
+            console.log(`  project: ${dir}  ·  ${allWorkflows.size} workflow(s)  ·  Ctrl-C to exit`);
+            await new Promise(() => { }); // serve until interrupted
+            return 0;
+        }
         if (cmd === "validate") {
             loadWorkflow(readFileSync(rest[0], "utf8"));
             console.log("OK:", rest[0]);
             return 0;
         }
-        if (cmd === "run-once") {
+        if (cmd === "run-once" || cmd === "run") {
             const file = rest.find(a => !a.startsWith("--"));
             if (!file) {
-                console.error("run-once: missing workflow file");
+                console.error("run: missing workflow file");
                 return 1;
             }
             const fake = rest.includes("--fake");
@@ -75,13 +141,23 @@ export async function run(argv) {
             const observer = session?.observer;
             const runWorkflowFn = buildWorkflowRunner({ workflows: allWorkflows, registry, services, observer });
             const servicesWithRunner = { ...services, runWorkflow: runWorkflowFn };
-            const outputs = await runWorkflowOnce(wf, { registry, services: servicesWithRunner, observer });
-            console.log("ran", wf.name, "->", [...outputs.keys()].join(", "));
+            // A run error must NOT tear down the --ui server: the failure is already
+            // streamed to the dashboard (the failed node + run), so keep serving so it
+            // stays inspectable. Without --ui, an error still exits non-zero.
+            let failed = false;
+            try {
+                const outputs = await runWorkflowOnce(wf, { registry, services: servicesWithRunner, observer });
+                console.log("ran", wf.name, "->", [...outputs.keys()].join(", "));
+            }
+            catch (err) {
+                failed = true;
+                console.error("run failed:", err instanceof Error ? err.message : String(err));
+            }
             if (session) {
-                console.log(`\n▶ Dashboard live at ${session.url} — Ctrl-C to exit`);
+                console.log(`\n▶ Dashboard live at ${session.url} — Ctrl-C to exit${failed ? "  (run failed — see the dashboard)" : ""}`);
                 await new Promise(() => { }); // keep the server up so the run stays viewable
             }
-            return 0;
+            return failed ? 1 : 0;
         }
         if (cmd === "start") {
             const dir = rest.find(a => !a.startsWith("--")) ?? ".";
@@ -111,7 +187,7 @@ export async function run(argv) {
                 console.log(`▶ Dashboard live at ${session.url}`);
             return 0;
         }
-        console.error("usage: flow <validate|run-once|start> ...");
+        console.error("usage: flow <validate|run|start> [workflow|projectDir] [--ui] [--fake]");
         return 1;
     }
     catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentic-surfaces/cli",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -21,9 +21,9 @@
     "dist"
   ],
   "dependencies": {
-    "@agentic-surfaces/core": "0.1.4",
-    "@agentic-surfaces/agent": "0.1.4",
-    "@agentic-surfaces/server": "0.1.4"
+    "@agentic-surfaces/agent": "0.1.6",
+    "@agentic-surfaces/core": "0.1.6",
+    "@agentic-surfaces/server": "0.1.6"
   },
   "scripts": {
     "build": "tsc -b",