@agentic-surfaces/core 0.1.12 → 0.1.13

package/dist/handlers/cache.d.ts

@@ -0,0 +1,24 @@
+import type { NodeHandler } from "../types.js";
+/**
+ * task.cache-unseen — filter a list down to the items NOT yet marked seen.
+ *
+ *   config:
+ *     items: <jsonata → array>     # the list to filter (e.g. fetchComments.comments)
+ *     key:   <jsonata over EACH item → string>   # the stable surface id (e.g. "id")
+ *     namespace?: <string>         # seen-set scope; defaults to the workflow name
+ *
+ * Read-only — it never marks anything. Pair it with task.cache-mark to record items
+ * as seen once they've actually been handled.
+ */
+export declare const cacheUnseenHandler: NodeHandler;
+/**
+ * task.cache-mark — record one or more keys as seen.
+ *
+ *   config:
+ *     keys: <jsonata → string | string[]>   # the key(s) to mark (e.g. "trigger.id" or "x.comments.id")
+ *     namespace?: <string>                   # must match the cache-unseen namespace; defaults to workflow name
+ *
+ * Place it wherever "we've handled this" should become true — typically after the
+ * agent/action node has succeeded.
+ */
+export declare const cacheMarkHandler: NodeHandler;

package/dist/scheduler.js

@@ -7,6 +7,7 @@ import { httpHandler } from "./handlers/http.js";
 import { agentHandler } from "./handlers/agent.js";
 import { foreachHandler } from "./handlers/foreach.js";
 import { runWorkflowHandler } from "./handlers/run-workflow.js";
+import { cacheUnseenHandler, cacheMarkHandler } from "./handlers/cache.js";
 import { ConsoleObserver } from "./observer.js";
 const passthrough = (type) => ({
     type,
@@ -25,6 +26,8 @@ export function defaultRegistry() {
     r.register(passthrough("trigger.command"));
     r.register(foreachHandler);
     r.register(runWorkflowHandler);
+    r.register(cacheUnseenHandler);
+    r.register(cacheMarkHandler);
     return r;
 }
 export async function runWorkflowOnce(workflow, opts) {

package/dist/schema.js

@@ -4,6 +4,7 @@ const nodeType = z.enum([
     "trigger.cron", "trigger.webhook", "trigger.command",
     "task.http", "task.transform", "task.branch",
     "task.run-workflow", "task.foreach",
+    "task.cache-unseen", "task.cache-mark",
     "agent.run",
 ]);
 const retry = z.object({ maxAttempts: z.number().int().min(1), backoffMs: z.number().int().min(0) });
@@ -56,6 +57,21 @@ const workflow = z.object({
                 ctx.addIssue({ code: "custom", message: `node "${n.id}" (task.foreach) requires a non-empty config.workflow string` });
             }
         }
+        if (n.type === "task.cache-unseen") {
+            const cfg = n.config;
+            if (typeof cfg.items !== "string" || cfg.items.trim() === "") {
+                ctx.addIssue({ code: "custom", message: `node "${n.id}" (task.cache-unseen) requires a non-empty config.items string` });
+            }
+            if (typeof cfg.key !== "string" || cfg.key.trim() === "") {
+                ctx.addIssue({ code: "custom", message: `node "${n.id}" (task.cache-unseen) requires a non-empty config.key string` });
+            }
+        }
+        if (n.type === "task.cache-mark") {
+            const cfg = n.config;
+            if (typeof cfg.keys !== "string" || cfg.keys.trim() === "") {
+                ctx.addIssue({ code: "custom", message: `node "${n.id}" (task.cache-mark) requires a non-empty config.keys string` });
+            }
+        }
     }
 });
 export function loadWorkflow(yamlText) {

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 import type { AgentRunner, McpServerRef } from "@agentic-surfaces/agent";
 import type { AgentDefinition } from "./agents.js";
 export type { AgentRunner, McpServerRef };
-export type NodeType = "trigger.cron" | "trigger.webhook" | "trigger.command" | "task.http" | "task.transform" | "task.branch" | "task.run-workflow" | "task.foreach" | "agent.run";
+export type NodeType = "trigger.cron" | "trigger.webhook" | "trigger.command" | "task.http" | "task.transform" | "task.branch" | "task.run-workflow" | "task.foreach" | "task.cache-unseen" | "task.cache-mark" | "agent.run";
 export interface RetryPolicy {
     maxAttempts: number;
     backoffMs: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentic-surfaces/core",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "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.12"
+    "@agentic-surfaces/agent": "0.1.13"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",