npm - @agentic-surfaces/server - Versions diffs - 0.1.28 → 0.1.30 - Mend

@agentic-surfaces/server 0.1.28 → 0.1.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/dist/editor/assets/{index-CQrXDTe4.css → index-D-uLRZZ-.css} +1 -1
package/dist/editor/assets/index-Vur7bXRy.js +298 -0
package/dist/editor/index.html +2 -2
package/dist/http.d.ts +10 -1
package/dist/http.js +97 -13
package/dist/serve.d.ts +4 -0
package/dist/serve.js +8 -2
package/dist/streaming-observer.d.ts +10 -1
package/dist/streaming-observer.js +47 -5
package/package.json +2 -2
package/dist/editor/assets/index-C7_sNeWL.js +0 -298

package/dist/editor/index.html CHANGED Viewed

@@ -4,8 +4,8 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>agentic-surfaces — workflow editor</title>
-    <script type="module" crossorigin src="/assets/index-C7_sNeWL.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-CQrXDTe4.css">
+    <script type="module" crossorigin src="/assets/index-Vur7bXRy.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-D-uLRZZ-.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/http.d.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 import http from "node:http";
-import type { Workflow, AgentDefinition } from "@agentic-surfaces/core";
+import type { Workflow, AgentDefinition, PlanUsage } from "@agentic-surfaces/core";
 import type { StreamingObserver } from "./streaming-observer.js";
 /** Minimal run record kept in-memory for the /api/runs endpoint. */
 export interface RunRecord {
@@ -54,6 +54,15 @@ export interface ServerOptions {
         pause(): void;
         resume(): void;
     };
+    /** Best-effort claude.ai plan usage provider, surfaced (cached) at GET /api/usage. */
+    planUsage?: () => Promise<PlanUsage | null>;
+    /**
+     * Hot-reload hook (POST /api/reload). Re-scans the workflows + agents dirs and project config,
+     * rebuilds the in-memory workflow map, and re-registers the scheduler in place. Returns the new
+     * workflow set so the server can serve it from /api/workflows and /api/run without a restart.
+     * When omitted, POST /api/reload is 405 (reload not available in this mode, e.g. run-once).
+     */
+    onReload?: () => Promise<Workflow[]> | Workflow[];
 }
 /** Build an http.Server that serves the workflow-engine API and optional static files. */
 export declare function createServer(opts: ServerOptions): http.Server;

package/dist/http.js CHANGED Viewed

@@ -13,6 +13,14 @@ function json(res, data, status = 200) {
 function notFound(res) {
     json(res, { error: "not found" }, 404);
 }
+/** Max characters of an agent's instructions body we put on the wire — bounded so a long
+ *  definition can't bloat the payload (mirrors streaming-observer's OUTPUT_PREVIEW_CAP). */
+const AGENT_BODY_CAP = 16_000;
+function capBody(s) {
+    return s.length > AGENT_BODY_CAP
+        ? `${s.slice(0, AGENT_BODY_CAP)}\n…(${s.length - AGENT_BODY_CAP} more chars truncated)`
+        : s;
+}
 function sseHeaders(res) {
     res.writeHead(200, {
         "Content-Type": "text/event-stream",
@@ -26,8 +34,33 @@ function writeEvent(res, event) {
 }
 /** Build an http.Server that serves the workflow-engine API and optional static files. */
 export function createServer(opts) {
-    const { observer, workflows = [], staticDir, onRun, config, agents = [], cache, pause } = opts;
-    const workflowByName = new Map(workflows.map((w) => [w.name, w]));
+    const { observer, staticDir, onRun, config, agents = [], cache, pause, planUsage, onReload, } = opts;
+    // Live workflow set — mutable so POST /api/reload (+ the fs.watch reload path) can swap it in
+    // place without a server restart. /api/workflows, /api/run, and the graph view all read from here.
+    let workflows = opts.workflows ?? [];
+    let workflowByName = new Map(workflows.map((w) => [w.name, w]));
+    function setWorkflows(next) {
+        workflows = next;
+        workflowByName = new Map(next.map((w) => [w.name, w]));
+    }
+    // Cache plan usage briefly — the experimental SDK call spins up a session, so don't hit it per request.
+    let usageCache = null;
+    const PLAN_USAGE_TTL_MS = 5 * 60_000;
+    async function getCachedPlanUsage() {
+        if (!planUsage)
+            return null;
+        if (usageCache && Date.now() - usageCache.at < PLAN_USAGE_TTL_MS)
+            return usageCache.data;
+        let data = null;
+        try {
+            data = await planUsage();
+        }
+        catch {
+            data = null;
+        }
+        usageCache = { data, at: Date.now() };
+        return data;
+    }
     // In-memory run registry — populated by listening to the observer.
     const runs = new Map();
     let runCounter = 0;
@@ -74,7 +107,9 @@ export function createServer(opts) {
                 json: "application/json",
                 woff2: "font/woff2",
             };
-            res.writeHead(200, { "Content-Type": mime[ext] ?? "application/octet-stream" });
+            res.writeHead(200, {
+                "Content-Type": mime[ext] ?? "application/octet-stream",
+            });
             res.end(buf);
             return true;
         }
@@ -87,7 +122,10 @@ export function createServer(opts) {
         const pathname = url.pathname;
         // CORS preflight
         if (req.method === "OPTIONS") {
-            res.writeHead(204, { "Access-Control-Allow-Origin": "*", "Access-Control-Allow-Headers": "*" });
+            res.writeHead(204, {
+                "Access-Control-Allow-Origin": "*",
+                "Access-Control-Allow-Headers": "*",
+            });
             res.end();
             return;
         }
@@ -98,6 +136,8 @@ export function createServer(opts) {
                 return {
                     name: w.name,
                     title: w.title ?? w.name,
+                    // Sidebar grouping (explicit `group:` field or the file's subdir path; undefined = ungrouped).
+                    group: w.group,
                     nodeCount: w.nodes.length,
                     triggerType,
                     // Full graph so the editor can render each workflow without a second fetch.
@@ -111,6 +151,25 @@ export function createServer(opts) {
             }));
             return;
         }
+        // Hot-reload the workflow set (re-scan dirs, rebuild map, re-register the scheduler) without a
+        // restart. The CLI supplies onReload; it returns the freshly-loaded workflows, which we swap into
+        // the live set and broadcast to connected dashboards so they re-fetch.
+        if (pathname === "/api/reload" && req.method === "POST") {
+            if (!onReload) {
+                json(res, { error: "reload is not enabled on this server" }, 405);
+                return;
+            }
+            try {
+                const next = await onReload();
+                setWorkflows(next);
+                observer.notifyWorkflowsChanged();
+                json(res, { reloaded: next.length, workflows: next.map((w) => w.name) }, 200);
+            }
+            catch (err) {
+                json(res, { error: err instanceof Error ? err.message : String(err) }, 500);
+            }
+            return;
+        }
         // Trigger a run from the UI. Fire-and-forget: progress streams via /api/events.
         if (pathname === "/api/run" && req.method === "POST") {
             if (!onRun) {
@@ -118,7 +177,9 @@ export function createServer(opts) {
                 return;
             }
             let body = "";
-            req.on("data", (c) => { body += c; });
+            req.on("data", (c) => {
+                body += c;
+            });
             req.on("end", () => {
                 let parsed;
                 try {
@@ -135,14 +196,27 @@ export function createServer(opts) {
                 }
                 // Don't await — the run streams over SSE; a thrown error is reported
                 // there (and logged by the runner), so the server keeps serving.
-                Promise.resolve(onRun(name, parsed.payload)).catch(() => { });
+                Promise.resolve(onRun(name, parsed.payload)).catch(() => {
+                    /* surfaced via observer */
+                });
                 json(res, { started: name }, 202);
             });
             return;
         }
         // Platform-wide play/pause. GET reports state; POST /api/pause|resume toggles the scheduler.
-        if (pathname === "/api/state" && (req.method === "GET" || req.method === undefined)) {
-            json(res, { paused: pause ? pause.isPaused() : false, controllable: Boolean(pause) });
+        if (pathname === "/api/state" &&
+            (req.method === "GET" || req.method === undefined)) {
+            json(res, {
+                paused: pause ? pause.isPaused() : false,
+                controllable: Boolean(pause),
+            });
+            return;
+        }
+        // Best-effort claude.ai plan usage (session + weekly windows) for the spend/balance box.
+        if (pathname === "/api/usage" &&
+            (req.method === "GET" || req.method === undefined)) {
+            const data = await getCachedPlanUsage();
+            json(res, data ?? { available: false });
             return;
         }
         if (pathname === "/api/pause" && req.method === "POST") {
@@ -164,7 +238,8 @@ export function createServer(opts) {
             return;
         }
         // Inspect / clear the engine seen-cache (debugging dedup state).
-        if (pathname === "/api/cache" && (req.method === "GET" || req.method === undefined)) {
+        if (pathname === "/api/cache" &&
+            (req.method === "GET" || req.method === undefined)) {
             json(res, cache ? cache.entries() : { seen: [], cursors: [] });
             return;
         }
@@ -174,7 +249,9 @@ export function createServer(opts) {
                 return;
             }
             let body = "";
-            req.on("data", (c) => { body += c; });
+            req.on("data", (c) => {
+                body += c;
+            });
             req.on("end", () => {
                 let key;
                 try {
@@ -198,10 +275,17 @@ export function createServer(opts) {
             return;
         }
         if (pathname === "/api/agents") {
-            // Metadata only — not the full instructions body.
+            // Metadata + parsed frontmatter + the instructions body (capped), so the
+            // node-detail view can show an agent node's full definition file.
             json(res, agents.map((a) => ({
-                name: a.name, model: a.model, effort: a.effort,
-                commands: a.commands ?? null, fallback: a.fallback ?? null,
+                name: a.name,
+                model: a.model,
+                effort: a.effort,
+                profile: a.profile ?? null,
+                commands: a.commands ?? null,
+                fallback: a.fallback ?? null,
+                mcpServers: a.mcpServers ?? null,
+                instructions: capBody(a.instructions ?? ""),
             })));
             return;
         }

package/dist/serve.d.ts CHANGED Viewed

@@ -44,6 +44,10 @@ export interface ServeOptions {
         pause(): void;
         resume(): void;
     };
+    /** Best-effort claude.ai plan usage provider, surfaced (cached) at GET /api/usage. */
+    planUsage?: () => Promise<import("@agentic-surfaces/core").PlanUsage | null>;
+    /** Hot-reload hook (POST /api/reload): re-scan + rebuild the workflow set + scheduler in place. */
+    onReload?: () => Promise<Workflow[]> | Workflow[];
 }
 /**
  * Locate the built editor assets to serve. Checks, in order:

package/dist/serve.js CHANGED Viewed

@@ -31,13 +31,18 @@ export function serve(opts = {}) {
     const host = opts.host ?? "127.0.0.1";
     const staticDir = opts.staticDir ?? resolveEditorDir();
     const server = createServer({
-        observer, port, host, staticDir,
+        observer,
+        port,
+        host,
+        staticDir,
         workflows: opts.workflows,
         onRun: opts.onRun,
         config: opts.config,
         agents: opts.agents,
         cache: opts.cache,
         pause: opts.pause,
+        planUsage: opts.planUsage,
+        onReload: opts.onReload,
     });
     server.listen(port, host, () => {
         console.log(`[flow-server] listening on http://${host}:${port}`);
@@ -52,7 +57,8 @@ export function serve(opts = {}) {
 // Only run when executed directly as a script (not when imported as a module).
 const isMain = typeof process !== "undefined" &&
     process.argv[1] != null &&
-    (process.argv[1].endsWith("serve.js") || process.argv[1].endsWith("flow-server"));
+    (process.argv[1].endsWith("serve.js") ||
+        process.argv[1].endsWith("flow-server"));
 if (isMain) {
     const port = parseInt(process.env["PORT"] ?? "4000", 10);
     const staticDir = process.env["STATIC_DIR"];

package/dist/streaming-observer.d.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 import type { RunObserver } from "@agentic-surfaces/core";
 /** A single SSE-ready event that the HTTP layer will broadcast. */
 export interface RunEvent {
-    type: "run:start" | "node:start" | "node:finish" | "node:activity" | "run:finish";
+    type: "run:start" | "node:start" | "node:finish" | "node:activity" | "run:finish" | "workflows:changed";
     workflow: string;
     /** Which run this event belongs to (from the executor) — lets the UI separate concurrent runs. */
     runId?: string;
@@ -29,6 +29,15 @@ export declare class StreamingObserver implements RunObserver {
     private events;
     private listeners;
     private emit;
+    /** Deliver an event to every listener, isolating bad listeners. */
+    private fanout;
+    /**
+     * Notify connected clients that the loaded workflow set changed (after a reload),
+     * so the dashboard re-fetches /api/workflows + refreshes the open graph. This is a
+     * transient signal, NOT part of the run history, so it is fanned out live but NOT
+     * pushed onto the buffer (it must not replay on every SSE reconnect).
+     */
+    notifyWorkflowsChanged(): void;
     /** Subscribe to all future events. Returns an unsubscribe function. */
     subscribe(listener: (event: RunEvent) => void): () => void;
     /** Return a snapshot of all buffered events (safe to call at any time). */

package/dist/streaming-observer.js CHANGED Viewed

@@ -24,7 +24,9 @@ function runLabel(payload) {
 function extractUsage(output) {
     if (output && typeof output === "object" && "usage" in output) {
         const u = output.usage;
-        if (u && typeof u === "object" && typeof u.totalTokens === "number") {
+        if (u &&
+            typeof u === "object" &&
+            typeof u.totalTokens === "number") {
             return u;
         }
     }
@@ -57,6 +59,10 @@ export class StreamingObserver {
     listeners = [];
     emit(event) {
         this.events.push(event);
+        this.fanout(event);
+    }
+    /** Deliver an event to every listener, isolating bad listeners. */
+    fanout(event) {
         for (const listener of this.listeners) {
             try {
                 listener(event);
@@ -66,6 +72,15 @@ export class StreamingObserver {
             }
         }
     }
+    /**
+     * Notify connected clients that the loaded workflow set changed (after a reload),
+     * so the dashboard re-fetches /api/workflows + refreshes the open graph. This is a
+     * transient signal, NOT part of the run history, so it is fanned out live but NOT
+     * pushed onto the buffer (it must not replay on every SSE reconnect).
+     */
+    notifyWorkflowsChanged() {
+        this.fanout({ type: "workflows:changed", workflow: "", ts: Date.now() });
+    }
     /** Subscribe to all future events. Returns an unsubscribe function. */
     subscribe(listener) {
         this.listeners.push(listener);
@@ -83,15 +98,34 @@ export class StreamingObserver {
     }
     // ── RunObserver interface ──────────────────────────────────────────────────
     onRunStart(workflow, payload, runId) {
-        this.emit({ type: "run:start", workflow, runId, label: runLabel(payload), ts: Date.now() });
+        this.emit({
+            type: "run:start",
+            workflow,
+            runId,
+            label: runLabel(payload),
+            ts: Date.now(),
+        });
     }
     onNodeStart(nodeId, runId) {
         // workflow name is unknown at this call-site in the core interface;
         // emit a placeholder so the shape stays consistent.
-        this.emit({ type: "node:start", workflow: "", runId, nodeId, ts: Date.now() });
+        this.emit({
+            type: "node:start",
+            workflow: "",
+            runId,
+            nodeId,
+            ts: Date.now(),
+        });
     }
     onNodeActivity(nodeId, activity, runId) {
-        this.emit({ type: "node:activity", workflow: "", runId, nodeId, meta: activity, ts: Date.now() });
+        this.emit({
+            type: "node:activity",
+            workflow: "",
+            runId,
+            nodeId,
+            meta: activity,
+            ts: Date.now(),
+        });
     }
     onNodeFinish(nodeId, status, meta, runId) {
         // Normalize meta to { output?, error? }. `output` is the node's result (capped for the
@@ -103,7 +137,15 @@ export class StreamingObserver {
             output: "output" in m ? previewOutput(m.output) : undefined,
             usage: extractUsage(m.output),
         };
-        this.emit({ type: "node:finish", workflow: "", runId, nodeId, status, meta: wireMeta, ts: Date.now() });
+        this.emit({
+            type: "node:finish",
+            workflow: "",
+            runId,
+            nodeId,
+            status,
+            meta: wireMeta,
+            ts: Date.now(),
+        });
     }
     onRunFinish(workflow, status, runId) {
         this.emit({ type: "run:finish", workflow, runId, status, ts: Date.now() });

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@agentic-surfaces/server",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -22,7 +22,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@agentic-surfaces/core": "0.1.28"
+    "@agentic-surfaces/core": "0.1.30"
   },
   "repository": {
     "type": "git",