npm - @agentic-surfaces/server - Versions diffs - 0.1.27 → 0.1.29 - Mend

@agentic-surfaces/server 0.1.27 → 0.1.29

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-CQwBaAEq.css → index-HQKltIcN.css} +1 -1
package/dist/editor/assets/index-kTJFLfkQ.js +298 -0
package/dist/editor/index.html +2 -2
package/dist/http.d.ts +4 -1
package/dist/http.js +25 -1
package/dist/serve.d.ts +3 -0
package/dist/serve.js +1 -0
package/dist/streaming-observer.d.ts +7 -5
package/dist/streaming-observer.js +10 -10
package/package.json +2 -2
package/dist/editor/assets/index-CS8llYsy.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-CS8llYsy.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-CQwBaAEq.css">
+    <script type="module" crossorigin src="/assets/index-kTJFLfkQ.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-HQKltIcN.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 {
@@ -29,6 +29,7 @@ export interface ServerOptions {
             effort?: string;
         };
         version?: string;
+        atlassianSite?: string;
     };
     /** File-based agent definitions, surfaced at GET /api/agents (for the node detail view). */
     agents?: AgentDefinition[];
@@ -53,6 +54,8 @@ export interface ServerOptions {
         pause(): void;
         resume(): void;
     };
+    /** Best-effort claude.ai plan usage provider, surfaced (cached) at GET /api/usage. */
+    planUsage?: () => Promise<PlanUsage | null>;
 }
 /** 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,8 +26,26 @@ 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 { observer, workflows = [], staticDir, onRun, config, agents = [], cache, pause, planUsage } = opts;
     const workflowByName = new Map(workflows.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;
@@ -145,6 +163,12 @@ export function createServer(opts) {
             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") {
             if (!pause) {
                 json(res, { error: "pause not available" }, 405);

package/dist/serve.d.ts CHANGED Viewed

@@ -19,6 +19,7 @@ export interface ServeOptions {
             effort?: string;
         };
         version?: string;
+        atlassianSite?: string;
     };
     /** Agent definitions surfaced at GET /api/agents. */
     agents?: AgentDefinition[];
@@ -43,6 +44,8 @@ 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>;
 }
 /**
  * Locate the built editor assets to serve. Checks, in order:

package/dist/serve.js CHANGED Viewed

@@ -38,6 +38,7 @@ export function serve(opts = {}) {
         agents: opts.agents,
         cache: opts.cache,
         pause: opts.pause,
+        planUsage: opts.planUsage,
     });
     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" | "node:activity" | "run:finish";
     workflow: string;
+    /** Which run this event belongs to (from the executor) — lets the UI separate concurrent runs. */
+    runId?: string;
     /** Short human label for the content this run is processing (from the trigger payload). */
     label?: string;
     nodeId?: string;
@@ -33,9 +35,9 @@ export declare class StreamingObserver implements RunObserver {
     getEvents(): readonly RunEvent[];
     /** Clear the event buffer (useful between test runs). */
     clear(): void;
-    onRunStart(workflow: string, payload?: unknown): void;
-    onNodeStart(nodeId: string): void;
-    onNodeActivity(nodeId: string, activity: unknown): void;
-    onNodeFinish(nodeId: string, status: "success" | "failed", meta?: unknown): void;
-    onRunFinish(workflow: string, status: "success" | "failed"): void;
+    onRunStart(workflow: string, payload?: unknown, runId?: string): void;
+    onNodeStart(nodeId: string, runId?: string): void;
+    onNodeActivity(nodeId: string, activity: unknown, runId?: string): void;
+    onNodeFinish(nodeId: string, status: "success" | "failed", meta?: unknown, runId?: string): void;
+    onRunFinish(workflow: string, status: "success" | "failed", runId?: string): void;
 }

package/dist/streaming-observer.js CHANGED Viewed

@@ -82,18 +82,18 @@ export class StreamingObserver {
         this.events = [];
     }
     // ── RunObserver interface ──────────────────────────────────────────────────
-    onRunStart(workflow, payload) {
-        this.emit({ type: "run:start", workflow, label: runLabel(payload), ts: Date.now() });
+    onRunStart(workflow, payload, runId) {
+        this.emit({ type: "run:start", workflow, runId, label: runLabel(payload), ts: Date.now() });
     }
-    onNodeStart(nodeId) {
+    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: "", nodeId, ts: Date.now() });
+        this.emit({ type: "node:start", workflow: "", runId, nodeId, ts: Date.now() });
     }
-    onNodeActivity(nodeId, activity) {
-        this.emit({ type: "node:activity", workflow: "", nodeId, meta: activity, ts: Date.now() });
+    onNodeActivity(nodeId, activity, runId) {
+        this.emit({ type: "node:activity", workflow: "", runId, nodeId, meta: activity, ts: Date.now() });
     }
-    onNodeFinish(nodeId, status, meta) {
+    onNodeFinish(nodeId, status, meta, runId) {
         // Normalize meta to { output?, error? }. `output` is the node's result (capped for the
         // wire) so the UI can show what each node fetched/produced; `error` carries failures.
         // `usage` is lifted out as a structured field (agent nodes only) so the UI can sum a run total.
@@ -103,9 +103,9 @@ export class StreamingObserver {
             output: "output" in m ? previewOutput(m.output) : undefined,
             usage: extractUsage(m.output),
         };
-        this.emit({ type: "node:finish", workflow: "", nodeId, status, meta: wireMeta, ts: Date.now() });
+        this.emit({ type: "node:finish", workflow: "", runId, nodeId, status, meta: wireMeta, ts: Date.now() });
     }
-    onRunFinish(workflow, status) {
-        this.emit({ type: "run:finish", workflow, status, 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.27",
+  "version": "0.1.29",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -22,7 +22,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@agentic-surfaces/core": "0.1.27"
+    "@agentic-surfaces/core": "0.1.29"
   },
   "repository": {
     "type": "git",