npm - @agentic-surfaces/server - Versions diffs - 0.1.17 → 0.1.19 - Mend

@agentic-surfaces/server 0.1.17 → 0.1.19

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--mzjNaL0.css → index-6vZGwRHS.css} +1 -1
package/dist/editor/assets/index-aoHYCL_u.js +298 -0
package/dist/editor/index.html +2 -2
package/dist/http.d.ts +15 -4
package/dist/http.js +40 -8
package/dist/serve.d.ts +13 -2
package/dist/serve.js +1 -0
package/dist/streaming-observer.d.ts +3 -1
package/dist/streaming-observer.js +24 -2
package/package.json +2 -2
package/dist/editor/assets/index-DM7JIMkr.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-DM7JIMkr.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index--mzjNaL0.css">
+    <script type="module" crossorigin src="/assets/index-aoHYCL_u.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-6vZGwRHS.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/http.d.ts CHANGED Viewed

@@ -16,11 +16,11 @@ export interface ServerOptions {
     workflows?: Workflow[];
     observer: StreamingObserver;
     /**
-     * Trigger a workflow run by name (POST /api/run). Wired by the CLI to the
-     * engine; events stream back via the observer. When absent, /api/run is 405
-     * (the editor renders read-only).
+     * Trigger a workflow run by name + optional trigger payload (POST /api/run). A payload is
+     * needed to run a `trigger.command` sub-workflow directly (e.g. `{ key: "PD-109" }`). Events
+     * stream back via the observer. When absent, /api/run is 405 (the editor renders read-only).
      */
-    onRun?: (name: string) => void | Promise<unknown>;
+    onRun?: (name: string, payload?: unknown) => void | Promise<unknown>;
     /** Project-level config surfaced at GET /api/config (so the UI shows effective agent defaults + version). */
     config?: {
         dryRun?: boolean;
@@ -32,6 +32,17 @@ export interface ServerOptions {
     };
     /** File-based agent definitions, surfaced at GET /api/agents (for the node detail view). */
     agents?: AgentDefinition[];
+    /** The engine cache, surfaced at GET/DELETE /api/cache so the dashboard can inspect + clear seen-state. */
+    cache?: {
+        entries(): {
+            seen: string[];
+            cursors: Array<{
+                key: string;
+                value: string;
+            }>;
+        };
+        forget(key: string): void;
+    };
 }
 /** 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

@@ -26,7 +26,7 @@ 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 = [] } = opts;
+    const { observer, workflows = [], staticDir, onRun, config, agents = [], cache } = opts;
     const workflowByName = new Map(workflows.map((w) => [w.name, w]));
     // In-memory run registry — populated by listening to the observer.
     const runs = new Map();
@@ -97,15 +97,16 @@ export function createServer(opts) {
                 const triggerType = w.nodes.find((n) => n.type.startsWith("trigger."))?.type ?? null;
                 return {
                     name: w.name,
+                    title: w.title ?? w.name,
                     nodeCount: w.nodes.length,
                     triggerType,
                     // Full graph so the editor can render each workflow without a second fetch.
                     nodes: w.nodes,
                     edges: w.edges,
-                    // Runnable from the browser only for ENTRY workflows. A `trigger.command` workflow is a
-                    // sub-workflow invoked by foreach/run-workflow with a payload — running it standalone
-                    // gives it no trigger payload (empty keys → bad requests), so it isn't directly runnable.
-                    runnable: Boolean(onRun) && triggerType !== "trigger.command",
+                    // Runnable from the browser when a run-trigger is wired. A `trigger.command` sub-workflow
+                    // needs a payload (the editor prompts for one); entry workflows run with no payload.
+                    runnable: Boolean(onRun),
+                    needsPayload: triggerType === "trigger.command",
                 };
             }));
             return;
@@ -119,25 +120,56 @@ export function createServer(opts) {
             let body = "";
             req.on("data", (c) => { body += c; });
             req.on("end", () => {
-                let name;
+                let parsed;
                 try {
-                    name = JSON.parse(body || "{}").workflow;
+                    parsed = JSON.parse(body || "{}");
                 }
                 catch {
                     json(res, { error: "invalid JSON body" }, 400);
                     return;
                 }
+                const name = parsed.workflow;
                 if (!name || !workflowByName.has(name)) {
                     json(res, { error: `unknown workflow: ${name ?? "(none)"}` }, 404);
                     return;
                 }
                 // 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)).catch(() => { });
+                Promise.resolve(onRun(name, parsed.payload)).catch(() => { });
                 json(res, { started: name }, 202);
             });
             return;
         }
+        // Inspect / clear the engine seen-cache (debugging dedup state).
+        if (pathname === "/api/cache" && (req.method === "GET" || req.method === undefined)) {
+            json(res, cache ? cache.entries() : { seen: [], cursors: [] });
+            return;
+        }
+        if (pathname === "/api/cache" && req.method === "DELETE") {
+            if (!cache) {
+                json(res, { error: "cache not available" }, 405);
+                return;
+            }
+            let body = "";
+            req.on("data", (c) => { body += c; });
+            req.on("end", () => {
+                let key;
+                try {
+                    key = JSON.parse(body || "{}").key;
+                }
+                catch {
+                    json(res, { error: "invalid JSON body" }, 400);
+                    return;
+                }
+                if (!key) {
+                    json(res, { error: "missing key" }, 400);
+                    return;
+                }
+                cache.forget(key);
+                json(res, { forgot: key }, 200);
+            });
+            return;
+        }
         if (pathname === "/api/config") {
             json(res, config ?? {});
             return;

package/dist/serve.d.ts CHANGED Viewed

@@ -9,8 +9,8 @@ export interface ServeOptions {
     observer?: StreamingObserver;
     /** Workflows to expose at /api/workflows (graph + run-eligibility). */
     workflows?: Workflow[];
-    /** Trigger a run by name from the UI (POST /api/run). */
-    onRun?: (name: string) => void | Promise<unknown>;
+    /** Trigger a run by name + optional payload from the UI (POST /api/run). */
+    onRun?: (name: string, payload?: unknown) => void | Promise<unknown>;
     /** Project config surfaced at GET /api/config (effective agent defaults, dryRun, version). */
     config?: {
         dryRun?: boolean;
@@ -22,6 +22,17 @@ export interface ServeOptions {
     };
     /** Agent definitions surfaced at GET /api/agents. */
     agents?: AgentDefinition[];
+    /** Engine cache, surfaced at GET/DELETE /api/cache for inspecting + clearing seen-state. */
+    cache?: {
+        entries(): {
+            seen: string[];
+            cursors: Array<{
+                key: string;
+                value: string;
+            }>;
+        };
+        forget(key: string): void;
+    };
 }
 /**
  * Locate the built editor assets to serve. Checks, in order:

package/dist/serve.js CHANGED Viewed

@@ -36,6 +36,7 @@ export function serve(opts = {}) {
         onRun: opts.onRun,
         config: opts.config,
         agents: opts.agents,
+        cache: opts.cache,
     });
     server.listen(port, host, () => {
         console.log(`[flow-server] listening on http://${host}:${port}`);

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

@@ -3,6 +3,8 @@ import type { RunObserver } from "@agentic-surfaces/core";
 export interface RunEvent {
     type: "run:start" | "node:start" | "node:finish" | "run:finish";
     workflow: string;
+    /** Short human label for the content this run is processing (from the trigger payload). */
+    label?: string;
     nodeId?: string;
     status?: "success" | "failed";
     meta?: unknown;
@@ -22,7 +24,7 @@ export declare class StreamingObserver implements RunObserver {
     getEvents(): readonly RunEvent[];
     /** Clear the event buffer (useful between test runs). */
     clear(): void;
-    onRunStart(workflow: string): void;
+    onRunStart(workflow: string, payload?: unknown): void;
     onNodeStart(nodeId: string): void;
     onNodeFinish(nodeId: string, status: "success" | "failed", meta?: unknown): void;
     onRunFinish(workflow: string, status: "success" | "failed"): void;

package/dist/streaming-observer.js CHANGED Viewed

@@ -1,3 +1,25 @@
+/**
+ * A short label for what a run is processing, derived from its trigger payload — so a fan-out
+ * sub-run reads as e.g. "intake-idea · PD-109" instead of just the workflow name. Prefers a
+ * recognisable id field (Jira key/id), else a small JSON preview.
+ */
+function runLabel(payload) {
+    if (payload == null || typeof payload !== "object") {
+        return payload == null ? undefined : String(payload).slice(0, 80);
+    }
+    const p = payload;
+    if (typeof p.key === "string")
+        return p.key; // Jira issue/JPD key (e.g. PD-109)
+    if (typeof p.id === "string" || typeof p.id === "number")
+        return String(p.id);
+    try {
+        const s = JSON.stringify(p);
+        return s.length > 80 ? s.slice(0, 80) + "…" : s;
+    }
+    catch {
+        return undefined;
+    }
+}
 /** Max characters of a node's output we put on the wire — enough to debug, bounded
  *  so a large HTTP response (e.g. a full comment thread) can't bloat the SSE stream. */
 const OUTPUT_PREVIEW_CAP = 16_000;
@@ -50,8 +72,8 @@ export class StreamingObserver {
         this.events = [];
     }
     // ── RunObserver interface ──────────────────────────────────────────────────
-    onRunStart(workflow) {
-        this.emit({ type: "run:start", workflow, ts: Date.now() });
+    onRunStart(workflow, payload) {
+        this.emit({ type: "run:start", workflow, label: runLabel(payload), ts: Date.now() });
     }
     onNodeStart(nodeId) {
         // workflow name is unknown at this call-site in the core interface;

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@agentic-surfaces/server",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -21,7 +21,7 @@
     "dist"
   ],
   "dependencies": {
-    "@agentic-surfaces/core": "0.1.17"
+    "@agentic-surfaces/core": "0.1.19"
   },
   "scripts": {
     "build": "tsc -b",