@agentic-surfaces/cli 0.1.3 → 0.1.5

package/dist/index.js

@@ -1,7 +1,31 @@
 import { readFileSync, readdirSync } 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 { buildServices } from "./services.js";
+// `--ui`: start the live dashboard (HTTP server + SSE) and return its
+// StreamingObserver so run lifecycle events stream to the browser.
+function startUi() {
+    const port = parseInt(process.env["FLOW_UI_PORT"] ?? "4000", 10);
+    const { observer, port: p } = serve({ port });
+    const url = `http://127.0.0.1:${p}`;
+    openBrowser(url);
+    return { observer, url };
+}
+function openBrowser(url) {
+    if (process.env["FLOW_NO_OPEN"])
+        return; // headless / CI / don't hijack a browser
+    const cmd = process.platform === "darwin" ? "open"
+        : process.platform === "win32" ? "start"
+            : "xdg-open";
+    try {
+        spawn(cmd, [url], { stdio: "ignore", detached: true }).unref();
+    }
+    catch {
+        /* opening the browser is best-effort; the URL is printed regardless */
+    }
+}
 // Walk up from a starting dir to find agentic-surfaces.config.yaml. run-once
 // is pointed at a workflow file (e.g. <proj>/workflows/foo.yaml), but the
 // project config — including the dryRun safety flag — lives at the project
@@ -27,10 +51,10 @@ export async function run(argv) {
             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");
@@ -47,14 +71,30 @@ export async function run(argv) {
                 catch { /* skip unparseable */ }
             }
             const registry = defaultRegistry();
-            const runWorkflowFn = buildWorkflowRunner({ workflows: allWorkflows, registry, services });
+            const session = rest.includes("--ui") ? startUi() : undefined;
+            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 });
-            console.log("ran", wf.name, "->", [...outputs.keys()].join(", "));
-            return 0;
+            // 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${failed ? "  (run failed — see the dashboard)" : ""}`);
+                await new Promise(() => { }); // keep the server up so the run stays viewable
+            }
+            return failed ? 1 : 0;
         }
         if (cmd === "start") {
-            const dir = rest[0] ?? ".";
+            const dir = rest.find(a => !a.startsWith("--")) ?? ".";
             const pc = loadProjectConfig(dir);
             const workflowsDir = pc?.workflows ? join(dir, pc.workflows) : dir;
             const services = buildServices({ projectConfig: pc });
@@ -68,16 +108,20 @@ export async function run(argv) {
                 catch { /* skip unparseable */ }
             }
             const registry = defaultRegistry();
-            const runWorkflowFn = buildWorkflowRunner({ workflows: allWorkflows, registry, services });
+            const session = rest.includes("--ui") ? startUi() : undefined;
+            const observer = session?.observer;
+            const runWorkflowFn = buildWorkflowRunner({ workflows: allWorkflows, registry, services, observer });
             const servicesWithRunner = { ...services, runWorkflow: runWorkflowFn };
-            const sched = new Scheduler(servicesWithRunner, registry);
+            const sched = new Scheduler(servicesWithRunner, registry, observer);
             for (const [, w] of allWorkflows)
                 sched.add(w);
             sched.start();
             console.log("scheduler started; watching", workflowsDir);
+            if (session)
+                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.3",
+  "version": "0.1.5",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -21,8 +21,9 @@
     "dist"
   ],
   "dependencies": {
-    "@agentic-surfaces/agent": "0.1.3",
-    "@agentic-surfaces/core": "0.1.3"
+    "@agentic-surfaces/core": "0.1.5",
+    "@agentic-surfaces/agent": "0.1.5",
+    "@agentic-surfaces/server": "0.1.5"
   },
   "scripts": {
     "build": "tsc -b",