@agentic-surfaces/cli 0.1.2 → 0.1.4

package/dist/index.js

@@ -1,7 +1,48 @@
 import { readFileSync, readdirSync } from "node:fs";
-import { join, dirname } from "node:path";
+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
+// root (<proj>/). Without this, dryRun would default to false and a one-shot
+// run could perform live writes. SAFETY-CRITICAL: do not remove.
+function findProjectConfig(startDir) {
+    let dir = resolve(startDir);
+    for (;;) {
+        const pc = loadProjectConfig(dir);
+        if (pc)
+            return pc;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
 export async function run(argv) {
     const [cmd, ...rest] = argv;
     try {
@@ -17,7 +58,7 @@ export async function run(argv) {
                 return 1;
             }
             const fake = rest.includes("--fake");
-            const pc = loadProjectConfig(dirname(file));
+            const pc = findProjectConfig(dirname(file));
             const wf = loadWorkflow(readFileSync(file, "utf8"));
             const services = buildServices(fake ? { fakeAgent: [{ text: "fake reply" }], projectConfig: pc } : { projectConfig: pc });
             const dir = dirname(file);
@@ -30,14 +71,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 outputs = await runWorkflowOnce(wf, { registry, services: servicesWithRunner });
+            const outputs = await runWorkflowOnce(wf, { registry, services: servicesWithRunner, observer });
             console.log("ran", wf.name, "->", [...outputs.keys()].join(", "));
+            if (session) {
+                console.log(`\n▶ Dashboard live at ${session.url} — Ctrl-C to exit`);
+                await new Promise(() => { }); // keep the server up so the run stays viewable
+            }
             return 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 });
@@ -51,13 +98,17 @@ 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> ...");

package/package.json

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