@agentic-surfaces/cli 0.1.8 → 0.1.10

package/dist/index.js

@@ -1,7 +1,7 @@
 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 { loadWorkflow, runWorkflowOnce, Scheduler, loadProjectConfig, buildWorkflowRunner, defaultRegistry, parseAgentFile } from "@agentic-surfaces/core";
 import { serve, StreamingObserver } from "@agentic-surfaces/server";
 import { buildServices } from "./services.js";
 const CONFIG = "agentic-surfaces.config.yaml";
@@ -33,14 +33,62 @@ function loadWorkflows(dir) {
     }
     return map;
 }
-// `--ui`: start the live dashboard (HTTP server + SSE) and return its
-// StreamingObserver so run lifecycle events stream to the browser.
-function startUi() {
+// Load agents/<name>.md from the project into a name→AgentDefinition map.
+// A bad agent file is reported and skipped (consistent with workflow loading).
+function loadAgents(projectDir) {
+    const map = new Map();
+    const agentsDir = join(projectDir, "agents");
+    if (!existsSync(agentsDir))
+        return map;
+    for (const f of readdirSync(agentsDir).filter((f) => f.endsWith(".md"))) {
+        try {
+            const def = parseAgentFile(readFileSync(join(agentsDir, f), "utf8"), f.replace(/\.md$/, ""));
+            map.set(def.name, def);
+        }
+        catch (err) {
+            console.error(`skipping agent ${f}:`, err instanceof Error ? err.message : String(err));
+        }
+    }
+    return map;
+}
+// Walk up to the directory that contains agentic-surfaces.config.yaml.
+function findProjectDir(start) {
+    let dir = resolve(start);
+    for (;;) {
+        if (existsSync(join(dir, CONFIG)))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+// This package's version, shown in the dashboard. npm always ships package.json
+// in the tarball, so it resolves both from source and when installed via npx.
+const VERSION = (() => {
+    try {
+        return JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+    }
+    catch {
+        return "unknown";
+    }
+})();
+// Launch THE dashboard — one full UI, used by every `--ui` path (bare `ui`,
+// `run --ui`, `start --ui`). Always serves the workflow list, Run buttons,
+// agents, config + version. There is no lite variant.
+function launchUi(opts) {
     const port = parseInt(process.env["FLOW_UI_PORT"] ?? "4000", 10);
-    const { observer, port: p } = serve({ port });
+    const { port: p } = serve({
+        port,
+        observer: opts.observer,
+        workflows: [...opts.workflows.values()],
+        agents: [...opts.agents.values()],
+        onRun: opts.onRun,
+        config: { dryRun: opts.dryRun, agent: opts.agentDefaults, version: VERSION },
+    });
     const url = `http://127.0.0.1:${p}`;
     openBrowser(url);
-    return { observer, url };
+    return url;
 }
 function openBrowser(url) {
     if (process.env["FLOW_NO_OPEN"])
@@ -88,27 +136,24 @@ export async function run(argv) {
             const pc = loadProjectConfig(dir);
             const workflowsDir = pc?.workflows ? join(dir, pc.workflows) : dir;
             const allWorkflows = loadWorkflows(workflowsDir);
+            const agents = loadAgents(dir);
             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 };
+            const runWorkflowFn = buildWorkflowRunner({ workflows: allWorkflows, registry, services: { ...services, agents }, observer });
+            const servicesWithRunner = { ...services, agents, 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()],
+            const url = launchUi({
+                observer, workflows: allWorkflows, agents,
                 onRun: (name) => runWorkflowFn(name, undefined),
-                config: { dryRun: pc?.dryRun, agent: { model: pc?.agent?.model, effort: pc?.agent?.effort } },
+                dryRun: pc?.dryRun,
+                agentDefaults: { model: pc?.agent?.model, effort: pc?.agent?.effort },
             });
-            const url = `http://127.0.0.1:${actualPort}`;
-            openBrowser(url);
-            console.log(`\n▶ agentic-surfaces — ${url}`);
+            console.log(`\n▶ agentic-surfaces ${VERSION} — ${url}`);
             console.log(`  project: ${dir}  ·  ${allWorkflows.size} workflow(s)  ·  Ctrl-C to exit`);
             await new Promise(() => { }); // serve until interrupted
             return 0;
@@ -137,11 +182,18 @@ export async function run(argv) {
                 }
                 catch { /* skip unparseable */ }
             }
+            const agents = loadAgents(findProjectDir(dirname(file)) ?? dir);
             const registry = defaultRegistry();
-            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 ui = rest.includes("--ui");
+            const observer = ui ? new StreamingObserver() : undefined;
+            const runWorkflowFn = buildWorkflowRunner({ workflows: allWorkflows, registry, services: { ...services, agents }, observer });
+            const servicesWithRunner = { ...services, agents, runWorkflow: runWorkflowFn };
+            const url = ui ? launchUi({
+                observer: observer, workflows: allWorkflows, agents,
+                onRun: (name) => runWorkflowFn(name, undefined),
+                dryRun: pc?.dryRun,
+                agentDefaults: { model: pc?.agent?.model, effort: pc?.agent?.effort },
+            }) : undefined;
             // 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.
@@ -154,8 +206,8 @@ export async function run(argv) {
                 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)" : ""}`);
+            if (url) {
+                console.log(`\n▶ agentic-surfaces ${VERSION} — ${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;
@@ -174,18 +226,26 @@ export async function run(argv) {
                 }
                 catch { /* skip unparseable */ }
             }
+            const agents = loadAgents(dir);
             const registry = defaultRegistry();
-            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 ui = rest.includes("--ui");
+            const observer = ui ? new StreamingObserver() : undefined;
+            const runWorkflowFn = buildWorkflowRunner({ workflows: allWorkflows, registry, services: { ...services, agents }, observer });
+            const servicesWithRunner = { ...services, agents, runWorkflow: runWorkflowFn };
             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}`);
+            if (ui) {
+                const url = launchUi({
+                    observer: observer, workflows: allWorkflows, agents,
+                    onRun: (name) => runWorkflowFn(name, undefined),
+                    dryRun: pc?.dryRun,
+                    agentDefaults: { model: pc?.agent?.model, effort: pc?.agent?.effort },
+                });
+                console.log(`▶ agentic-surfaces ${VERSION} — ${url}`);
+            }
             return 0;
         }
         console.error("usage: flow <validate|run|start> [workflow|projectDir] [--ui] [--fake]");

package/package.json

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