@agentic-surfaces/core 0.1.17 → 0.1.19

package/dist/cache.d.ts

@@ -6,6 +6,14 @@ export declare class SqliteCache implements Cache {
     setCursor(k: string, v: string): void;
     isSeen(k: string): boolean;
     markSeen(k: string): void;
+    entries(): {
+        seen: string[];
+        cursors: Array<{
+            key: string;
+            value: string;
+        }>;
+    };
+    forget(k: string): void;
     wipe(): void;
     close(): void;
 }

package/dist/cache.js

@@ -21,6 +21,15 @@ export class SqliteCache {
     markSeen(k) {
         this.db.prepare("INSERT OR IGNORE INTO seen(key) VALUES(?)").run(k);
     }
+    entries() {
+        const seen = this.db.prepare("SELECT key FROM seen ORDER BY key").all().map((r) => r.key);
+        const cursors = this.db.prepare("SELECT key, value FROM cursors ORDER BY key").all();
+        return { seen, cursors };
+    }
+    forget(k) {
+        this.db.prepare("DELETE FROM seen WHERE key = ?").run(k);
+        this.db.prepare("DELETE FROM cursors WHERE key = ?").run(k);
+    }
     wipe() {
         this.db.exec("DELETE FROM cursors; DELETE FROM seen;");
     }

package/dist/executor.js

@@ -11,7 +11,7 @@ export async function runWorkflow(opts) {
     };
     const queue = [triggerNodeId];
     const visited = new Set();
-    observer?.onRunStart?.(workflow.name);
+    observer?.onRunStart?.(workflow.name, ctx.triggerPayload);
     while (queue.length > 0) {
         const id = queue.shift();
         if (visited.has(id))

package/dist/schema.js

@@ -23,6 +23,7 @@ const node = z.object({
 const edge = z.object({ from: z.string().min(1), to: z.string().min(1), when: z.string().optional() });
 const workflow = z.object({
     name: z.string().min(1),
+    title: z.string().min(1).optional(),
     nodes: z.array(node).min(1),
     edges: z.array(edge).default([]),
 }).superRefine((wf, ctx) => {

package/dist/types.d.ts

@@ -20,6 +20,8 @@ export interface WorkflowEdge {
 }
 export interface Workflow {
     name: string;
+    /** Human-readable display name for the UI (falls back to `name` when omitted). */
+    title?: string;
     nodes: WorkflowNode[];
     edges: WorkflowEdge[];
 }
@@ -32,6 +34,16 @@ export interface Cache {
     setCursor(k: string, v: string): void;
     isSeen(k: string): boolean;
     markSeen(k: string): void;
+    /** Inspect all cache contents (seen-set + cursors) — for the dashboard's cache view. */
+    entries(): {
+        seen: string[];
+        cursors: Array<{
+            key: string;
+            value: string;
+        }>;
+    };
+    /** Forget a single key (seen + cursor) so it gets reprocessed. */
+    forget(k: string): void;
     wipe(): void;
 }
 export interface Services {
@@ -65,7 +77,7 @@ export interface NodeHandler {
     execute(node: WorkflowNode, ctx: RunContext): Promise<NodeResult>;
 }
 export interface RunObserver {
-    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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentic-surfaces/core",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -23,7 +23,7 @@
     "jsonata": "^2.2.1",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
-    "@agentic-surfaces/agent": "0.1.17"
+    "@agentic-surfaces/agent": "0.1.19"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",