@oomol-lab/open-flow 0.1.0-beta.77 → 0.1.0-beta.78

package/dist/common/control-requests.js

@@ -12485,18 +12485,14 @@ strictObject({
 	scope: _enum(["draft", "live"]),
 	space: string().regex(/^(flow|node:.+)$/)
 });
-var dedupeConfigSchema = strictObject({
-	field: string().default(""),
-	mode: _enum(["new", "increasing"]).default("new"),
-	space: _enum(["node", "flow"]).default("node")
-});
-var dedupeExecutorSchema = dedupeConfigSchema.extend({ kind: literal("dedupe") });
-function dedupeTask(config = dedupeConfigSchema.parse({}), name = "Remove Duplicates") {
+var skipDuplicatesConfigSchema = strictObject({ fields: array(string().refine((field) => field.length > 0 && field.split(".").every((part) => part.length > 0), "Use a nonempty dot-separated field path.")).refine((fields) => new Set(fields).size === fields.length, "Identity fields must be distinct.").default([]) });
+var skipDuplicatesExecutorSchema = skipDuplicatesConfigSchema.extend({ kind: literal("skip-duplicates") });
+function skipDuplicatesTask(config = skipDuplicatesConfigSchema.parse({}), name = "Skip Duplicates") {
 	return {
 		name,
 		executor: {
 			...config,
-			kind: "dedupe"
+			kind: "skip-duplicates"
 		},
 		inputs: [{
 			handle: "items",
@@ -12528,13 +12524,9 @@ object$1({
 	})),
 	spaces: array(object$1({
 		space: string(),
-		mode: _enum(["new", "increasing"]),
 		count: number().nonnegative(),
-		watermark: union([
-			string(),
-			number(),
-			_null()
-		]),
+		pendingCount: number().nonnegative(),
+		reservedCount: number().nonnegative(),
 		updatedAt: number()
 	}))
 });
@@ -12858,7 +12850,7 @@ var managedFields = object$1({
 			revisionId: text$1
 		}),
 		httpRequestExecutorSchema,
-		dedupeExecutorSchema
+		skipDuplicatesExecutorSchema
 	])
 });
 var managed = managedFields.transform(limitDecisionTask);
@@ -13354,7 +13346,7 @@ function changeOperationsSchema(kind) {
 	return toJSONSchema(schema, { io: "input" });
 }
 function checkModelVersion(content) {
-	if (content.modelVersion < 13 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind === "task" && "executor" in candidateNode.task && candidateNode.task.executor.kind === "dedupe")) throw new Error("Deduplication requires Flow model v13.");
+	if (content.modelVersion < 13 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind === "task" && "executor" in candidateNode.task && candidateNode.task.executor.kind === "skip-duplicates")) throw new Error("Skip Duplicates requires Flow model v13.");
 	if (content.modelVersion < 12 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && "moduleId" in candidateNode.task && candidateNode.task.capabilities?.some((item) => item.kind == "http"))) throw new TypeError("Code HTTP access requires Flow model version 12.");
 	if (content.modelVersion < 11 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && "executor" in candidateNode.task && candidateNode.task.executor.kind == "http-request")) throw new TypeError("HTTP Request requires Flow model version 11.");
 	if (content.modelVersion < 11 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && ("moduleId" in candidateNode.task ? candidateNode.task.capabilities?.some((item) => item.kind == "workflow") : candidateNode.task.executor.kind == "agent" && candidateNode.task.executor.tools.some((item) => item.kind == "workflow")))) throw new TypeError("Workflow tools require Flow model version 11.");
@@ -14039,7 +14031,7 @@ var authoringTypes = [
 	"decision",
 	"openapi",
 	"http-request",
-	"dedupe",
+	"skip-duplicates",
 	"condition",
 	"value",
 	"wait",
@@ -14171,7 +14163,7 @@ var authoringConfigurations = {
 	"connector": authoringDefinitionSchemas.connector.omit({ outputMode: true }).strict(),
 	"openapi": authoringOpenApiSchema,
 	"http-request": httpRequestConfigSchema,
-	"dedupe": dedupeConfigSchema,
+	"skip-duplicates": skipDuplicatesConfigSchema,
 	"agent": authoringDefinitionSchemas.agent.omit({
 		prompt: true,
 		tools: true
@@ -14391,7 +14383,7 @@ function authoringSchema(kind) {
 		guidance: "Read a node type schema before creating or configuring it. Use $alias to reference a preceding node.add in the same batch. Read returns stable node references. Long code and prompt fields use text reads and edits. Changes use the observed baseRevision and a stable requestId."
 	} : {
 		type: kind,
-		onError: kind == "dedupe" || retryNodeTypes.some((nodeType) => nodeType == kind) ? { enum: ["stop", "error"] } : false,
+		onError: kind == "skip-duplicates" || retryNodeTypes.some((nodeType) => nodeType == kind) ? { enum: ["stop", "error"] } : false,
 		retry: retryNodeTypes.some((nodeType) => nodeType == kind) ? toJSONSchema(retryConfigurationSchema) : false,
 		inputSources: ["poll", "integration"].includes(kind) ? [
 			"value",
@@ -14421,7 +14413,7 @@ function authoringSchema(kind) {
 			"wait",
 			"approval"
 		].includes(kind),
-		guidance: kind == "webhook-response" ? "Prepare an HTTP response using fixed inputs body (any JSON, default empty text), statusCode (number, default 200) and headers (scalar-valued object, default {}). Select this node in Webhook options.responseBody as {kind: \"webhook-response\", nodeId: \"node reference\", timeoutMs: 30000}. Its first completion responds immediately while the Run continues. It has no business outputs. Multiple response nodes are allowed; each Webhook selects one reachable node." : kind == "outputs" ? "Declare output fields through config.outputDefs. Set their values through node.add.inputs or input.set. Outputs is a singleton execution sink; it waits for its predecessors and produces workflow business outputs independently of node logs. No downstream edges or data references to Outputs are allowed." : kind == "webhook" ? "Use options.responseBody: {kind: \"webhook-response\", nodeId: \"node ID or $alias\", timeoutMs: 30000} to respond on the selected node’s first completion while the Run continues. Body, statusCode and headers come exclusively from that node; clear workflow-output-only status/header references when switching. Alternatively configure options.responseBody as {kind: \"workflow-outputs\", output?: \"top-level output name\", timeoutMs?: 30000} to respond after the Run succeeds. Omit output for the complete object. Connect Webhook to Outputs. Timeout is 1000–60000 ms; HTTP timeout does not cancel the Run. Strings return text; other values return JSON. Only in this mode, options.responseStatusCodeOutput can select a numeric top-level workflow output as the HTTP status, overriding the preserved fixed responseStatusCode (default 200). Its runtime value must be an integer from 200 to 599, excluding 204, 205, 304; missing or invalid values return 500. Use responseHeaders for fixed text headers. In workflow-output mode, responseHeaderOutputs maps header names to top-level output names; values can be string, number or boolean and are converted to text. Alternatively responseHeadersSource: {kind: \"workflow-outputs\", output?: \"object field\"} replaces the entire header object (omit output for all outputs), preserving but ignoring per-header settings. Missing, null, complex or invalid header values return 500 without fallback. Header restrictions and Content-Type policy still apply. Omit responseBody for immediate responseData. Clear options.responseBody, options.responseStatusCodeOutput, options.responseHeadersSource and options.responseHeaderOutputs explicitly to switch back." : kind == "start" ? "Declare workflow inputs through config.inputDefs; read them in Start node details. REST calls and manual runs supply them as trigger.outputs. Downstream nodes bind these parameters as Start outputs. Start has no input sources or defaults; non-nullable parameters are required, and omitted nullable parameters become null." : kind == "condition" ? "Edit branch operands through config.branches. A branch can test one expression, all expressions, or any alternatives. Unmatched execution uses branch otherwise." : ["poll", "integration"].includes(kind) ? "Configure static parameters with node.add.inputs or input.set. Definitions come from the selected Trigger key; execution output and variable sources are unavailable." : kind == "llm" ? "Configure model settings, message templates and history as defaults. Input bindings with the same names override these defaults; named business inputs can be bound directly. Template strings interpolate {{name}}." : kind == "dedupe" ? "Bind an items array. Configure field (dot-separated identity path, empty for scalar items), mode (new or increasing), and space (node or flow). Outputs are items and duplicates. History persists immediately; downstream failures do not roll it back. Increasing mode accepts finite numbers or RFC 3339 timestamps, never mixed types." : kind == "http-request" ? "Configure method, query/headers modes and names, bodyFormat, authentication, responseFormat and statusPolicy. Bind url, query.<name>/header.<name> or whole query/headers objects, body and auth.token (Basic: auth.username/auth.password). Credentials accept variables or upstream outputs only. Outputs: body, statusCode, headers. Authentication is replaced as a complete choice." : kind == "openapi" ? "Select an operation; the tool resolves its ports and authentication. Read authenticationChoices from node details. authentication is replaced as a complete choice. Bind advertised credentials through inputs." : kind == "workflow" ? "Select another workflow with config.flowId. A workflow cannot call itself, including in a disconnected node. Owned unpublished or unavailable targets may be saved as incomplete drafts. Use node.refresh to load the current published interface." : kind == "agent" ? "Tools accept Connector Actions or {kind: \"workflow\", flowId, name, description, approval, inputs}. Workflow parameter sources use model, input or value. The platform derives the interface. Refresh a workflow tool with node.refresh and tool: its name." : kind == "code" ? codeGuidance : "Supply business configuration and input data. Fixed definitions are assembled by the tool. Existing constraints and defaults are preserved on partial updates.",
+		guidance: kind == "webhook-response" ? "Prepare an HTTP response using fixed inputs body (any JSON, default empty text), statusCode (number, default 200) and headers (scalar-valued object, default {}). Select this node in Webhook options.responseBody as {kind: \"webhook-response\", nodeId: \"node reference\", timeoutMs: 30000}. Its first completion responds immediately while the Run continues. It has no business outputs. Multiple response nodes are allowed; each Webhook selects one reachable node." : kind == "outputs" ? "Declare output fields through config.outputDefs. Set their values through node.add.inputs or input.set. Outputs is a singleton execution sink; it waits for its predecessors and produces workflow business outputs independently of node logs. No downstream edges or data references to Outputs are allowed." : kind == "webhook" ? "Use options.responseBody: {kind: \"webhook-response\", nodeId: \"node ID or $alias\", timeoutMs: 30000} to respond on the selected node’s first completion while the Run continues. Body, statusCode and headers come exclusively from that node; clear workflow-output-only status/header references when switching. Alternatively configure options.responseBody as {kind: \"workflow-outputs\", output?: \"top-level output name\", timeoutMs?: 30000} to respond after the Run succeeds. Omit output for the complete object. Connect Webhook to Outputs. Timeout is 1000–60000 ms; HTTP timeout does not cancel the Run. Strings return text; other values return JSON. Only in this mode, options.responseStatusCodeOutput can select a numeric top-level workflow output as the HTTP status, overriding the preserved fixed responseStatusCode (default 200). Its runtime value must be an integer from 200 to 599, excluding 204, 205, 304; missing or invalid values return 500. Use responseHeaders for fixed text headers. In workflow-output mode, responseHeaderOutputs maps header names to top-level output names; values can be string, number or boolean and are converted to text. Alternatively responseHeadersSource: {kind: \"workflow-outputs\", output?: \"object field\"} replaces the entire header object (omit output for all outputs), preserving but ignoring per-header settings. Missing, null, complex or invalid header values return 500 without fallback. Header restrictions and Content-Type policy still apply. Omit responseBody for immediate responseData. Clear options.responseBody, options.responseStatusCodeOutput, options.responseHeadersSource and options.responseHeaderOutputs explicitly to switch back." : kind == "start" ? "Declare workflow inputs through config.inputDefs; read them in Start node details. REST calls and manual runs supply them as trigger.outputs. Downstream nodes bind these parameters as Start outputs. Start has no input sources or defaults; non-nullable parameters are required, and omitted nullable parameters become null." : kind == "condition" ? "Edit branch operands through config.branches. A branch can test one expression, all expressions, or any alternatives. Unmatched execution uses branch otherwise." : ["poll", "integration"].includes(kind) ? "Configure static parameters with node.add.inputs or input.set. Definitions come from the selected Trigger key; execution output and variable sources are unavailable." : kind == "llm" ? "Configure model settings, message templates and history as defaults. Input bindings with the same names override these defaults; named business inputs can be bound directly. Template strings interpolate {{name}}." : kind == "skip-duplicates" ? "Bind an items array. Configure fields as dot-separated identity paths; an empty list uses each scalar item. Outputs are items and duplicates. History belongs to this node and commits only when the Run completes successfully. Fields accept strings or finite numbers; missing or complex values reject the batch." : kind == "http-request" ? "Configure method, query/headers modes and names, bodyFormat, authentication, responseFormat and statusPolicy. Bind url, query.<name>/header.<name> or whole query/headers objects, body and auth.token (Basic: auth.username/auth.password). Credentials accept variables or upstream outputs only. Outputs: body, statusCode, headers. Authentication is replaced as a complete choice." : kind == "openapi" ? "Select an operation; the tool resolves its ports and authentication. Read authenticationChoices from node details. authentication is replaced as a complete choice. Bind advertised credentials through inputs." : kind == "workflow" ? "Select another workflow with config.flowId. A workflow cannot call itself, including in a disconnected node. Owned unpublished or unavailable targets may be saved as incomplete drafts. Use node.refresh to load the current published interface." : kind == "agent" ? "Tools accept Connector Actions or {kind: \"workflow\", flowId, name, description, approval, inputs}. Workflow parameter sources use model, input or value. The platform derives the interface. Refresh a workflow tool with node.refresh and tool: its name." : kind == "code" ? codeGuidance : "Supply business configuration and input data. Fixed definitions are assembled by the tool. Existing constraints and defaults are preserved on partial updates.",
 		example: {
 			op: "node.add",
 			as: "step",
@@ -14444,12 +14436,8 @@ function authoringSchema(kind) {
 					}]
 				} },
 				"integration": { config: { key: "<Trigger key>" } },
-				"dedupe": {
-					config: {
-						field: "id",
-						mode: "new",
-						space: "node"
-					},
+				"skip-duplicates": {
+					config: { fields: ["id"] },
 					inputs: { items: {
 						kind: "value",
 						value: [{ id: "a" }, { id: "b" }]
@@ -14714,7 +14702,7 @@ var nodeErrorSchema = {
 	}
 };
 function supportsNodeErrorHandling(node) {
-	return supportsNodeRetry(node) || node.kind === "task" && "executor" in node.task && node.task.executor.kind === "dedupe";
+	return supportsNodeRetry(node) || node.kind === "task" && "executor" in node.task && node.task.executor.kind === "skip-duplicates";
 }
 function nodeSystemOutputPorts(node) {
 	return supportsNodeErrorHandling(node) && node.onError == "error" ? { error: {
@@ -16600,7 +16588,7 @@ function authoringNode(content, ref) {
 			inputs: fieldsView([...task.inputs, ...node.kind == "task" ? node.additionalInputs ?? [] : []].filter((port) => !("handle" in port) || !llmReservedInputs.includes(port.handle)))
 		};
 		else if (task.executor.kind == "workflow") config = { flowId: task.executor.flowId };
-		else if (task.executor.kind == "http-request" || task.executor.kind == "dedupe") {
+		else if (task.executor.kind == "http-request" || task.executor.kind == "skip-duplicates") {
 			const { kind: _kind, ...settings } = task.executor;
 			config = settings;
 		} else if (task.executor.kind == "openapi") config = { ...openApiConfigView(task.executor) };
@@ -16990,12 +16978,12 @@ async function compileAuthoring(base, request, host) {
 					};
 				} else task = await connectorTask(config, String(update.name));
 			} else if (type == "decision") task = decisionTask(config.questions, String(update.name));
-			else if (type == "dedupe") task = {
+			else if (type == "skip-duplicates") task = {
 				...before,
 				name: String(update.name),
 				executor: {
-					kind: "dedupe",
-					...dedupeConfigSchema.parse(config)
+					kind: "skip-duplicates",
+					...skipDuplicatesConfigSchema.parse(config)
 				}
 			};
 			else if (type == "http-request") {
@@ -17345,8 +17333,8 @@ async function compileAuthoring(base, request, host) {
 						case "connector":
 							changes = createManagedTask(identity, await connectorTask(config, name));
 							break;
-						case "dedupe":
-							changes = createManagedTask(identity, dedupeTask(dedupeConfigSchema.parse(config), name));
+						case "skip-duplicates":
+							changes = createManagedTask(identity, skipDuplicatesTask(skipDuplicatesConfigSchema.parse(config), name));
 							break;
 						case "http-request":
 							changes = createManagedTask(identity, httpRequestTask(httpRequestConfigSchema.parse(config), name));
@@ -17569,7 +17557,7 @@ var descriptions = {
 	"poll": "Gmail polling by key; replace CONNECTION_ID with an active Gmail connection.",
 	"integration": "Telegram webhook integration by key; replace CONNECTION_ID with an active Telegram connection.",
 	"decision": "AI Decision evaluates named questions against target and returns a complete answer object per output. Configure target before running.",
-	"dedupe": "Filter items using persistent history. Records immediately, including when downstream work fails. Empty field uses each scalar item as identity.",
+	"skip-duplicates": "Skip items already recorded by successful Runs. Configure identity fields; an empty list uses each string or numeric item. History is private to the node and only commits after Run success.",
 	"http-request": "A single HTTP request. Bind url and request inputs; outputs are body, statusCode and headers.",
 	"openapi": "A fixed JSON API operation. Replace the example document and URL before running.",
 	"connector": "A Connector Task and its node. Replace ACTION_ID, CONNECTION_ID and port definitions using connector_get / connector show. Set connectionId to an empty string to defer account configuration; execution will require an account.",
@@ -17614,10 +17602,10 @@ function authoringExample(name) {
 				instructions: "Does the customer need support?"
 			}]);
 			break;
-		case "dedupe":
-			operations = [...createManagedTask({ nodeId: "dedupe" }, dedupeTask()), {
+		case "skip-duplicates":
+			operations = [...createManagedTask({ nodeId: "skip-duplicates" }, skipDuplicatesTask()), {
 				kind: "graph.node.input.set",
-				nodeId: "dedupe",
+				nodeId: "skip-duplicates",
 				handle: "items",
 				value: {
 					kind: "value",
@@ -17907,6 +17895,7 @@ var schemas = {
 		name: flowName,
 		teamId: id.optional(),
 		tagIds: tagIds.optional(),
+		presentation: record$3(string(), json).optional(),
 		version
 	}),
 	saveTag: strictObject({

package/dist/common/flow-authoring.js

@@ -8772,11 +8772,7 @@ strictObject({
 	scope: _enum(["draft", "live"]),
 	space: string().regex(/^(flow|node:.+)$/)
 });
-var dedupeExecutorSchema = strictObject({
-	field: string().default(""),
-	mode: _enum(["new", "increasing"]).default("new"),
-	space: _enum(["node", "flow"]).default("node")
-}).extend({ kind: literal("dedupe") });
+var skipDuplicatesExecutorSchema = strictObject({ fields: array(string().refine((field) => field.length > 0 && field.split(".").every((part) => part.length > 0), "Use a nonempty dot-separated field path.")).refine((fields) => new Set(fields).size === fields.length, "Identity fields must be distinct.").default([]) }).extend({ kind: literal("skip-duplicates") });
 object({
 	version: literal(1),
 	scope: _enum(["draft", "live"]),
@@ -8795,13 +8791,9 @@ object({
 	})),
 	spaces: array(object({
 		space: string(),
-		mode: _enum(["new", "increasing"]),
 		count: number().nonnegative(),
-		watermark: union([
-			string(),
-			number(),
-			_null()
-		]),
+		pendingCount: number().nonnegative(),
+		reservedCount: number().nonnegative(),
 		updatedAt: number()
 	}))
 });
@@ -9101,7 +9093,7 @@ var managedFields = object({
 			revisionId: text
 		}),
 		httpRequestExecutorSchema,
-		dedupeExecutorSchema
+		skipDuplicatesExecutorSchema
 	])
 });
 var managed = managedFields.transform(limitDecisionTask);
@@ -9573,7 +9565,7 @@ array(union([...new Map(Object.entries(shapes).map(([kind, shape]) => [kind, sha
 	...shape
 })])).values()])).min(1);
 function checkModelVersion(content) {
-	if (content.modelVersion < 13 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind === "task" && "executor" in candidateNode.task && candidateNode.task.executor.kind === "dedupe")) throw new Error("Deduplication requires Flow model v13.");
+	if (content.modelVersion < 13 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind === "task" && "executor" in candidateNode.task && candidateNode.task.executor.kind === "skip-duplicates")) throw new Error("Skip Duplicates requires Flow model v13.");
 	if (content.modelVersion < 12 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && "moduleId" in candidateNode.task && candidateNode.task.capabilities?.some((item) => item.kind == "http"))) throw new TypeError("Code HTTP access requires Flow model version 12.");
 	if (content.modelVersion < 11 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && "executor" in candidateNode.task && candidateNode.task.executor.kind == "http-request")) throw new TypeError("HTTP Request requires Flow model version 11.");
 	if (content.modelVersion < 11 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && ("moduleId" in candidateNode.task ? candidateNode.task.capabilities?.some((item) => item.kind == "workflow") : candidateNode.task.executor.kind == "agent" && candidateNode.task.executor.tools.some((item) => item.kind == "workflow")))) throw new TypeError("Workflow tools require Flow model version 11.");
@@ -9652,7 +9644,7 @@ function setConditionInput(node, handle, mapping) {
 //#endregion
 //#region src/flow/common/errorHandling.ts
 function supportsNodeErrorHandling(node) {
-	return supportsNodeRetry(node) || node.kind === "task" && "executor" in node.task && node.task.executor.kind === "dedupe";
+	return supportsNodeRetry(node) || node.kind === "task" && "executor" in node.task && node.task.executor.kind === "skip-duplicates";
 }
 //#endregion
 //#region src/flow/common/change.ts

package/dist/common/flow-change.d.ts

@@ -71,7 +71,7 @@ export interface ConditionNode extends GraphNodeBase {
     readonly matchMode: 'first' | 'all';
     readonly kind: 'condition';
 }
-export type ManagedTaskExecutor = import('./http-request.js').HttpRequestExecutor | import('./flow-state.js').DedupeExecutor | WorkflowExecutor | import('./decision.js').DecisionExecutor | import('./openapi.js').OpenApiExecutor | {
+export type ManagedTaskExecutor = import('./http-request.js').HttpRequestExecutor | import('./flow-state.js').SkipDuplicatesExecutor | WorkflowExecutor | import('./decision.js').DecisionExecutor | import('./openapi.js').OpenApiExecutor | {
     readonly kind: 'connector';
     readonly action: string;
     readonly connectionId?: string;

package/dist/common/flow-change.js

@@ -8845,11 +8845,7 @@ strictObject({
 	scope: _enum(["draft", "live"]),
 	space: string().regex(/^(flow|node:.+)$/)
 });
-var dedupeExecutorSchema = strictObject({
-	field: string().default(""),
-	mode: _enum(["new", "increasing"]).default("new"),
-	space: _enum(["node", "flow"]).default("node")
-}).extend({ kind: literal("dedupe") });
+var skipDuplicatesExecutorSchema = strictObject({ fields: array(string().refine((field) => field.length > 0 && field.split(".").every((part) => part.length > 0), "Use a nonempty dot-separated field path.")).refine((fields) => new Set(fields).size === fields.length, "Identity fields must be distinct.").default([]) }).extend({ kind: literal("skip-duplicates") });
 object({
 	version: literal(1),
 	scope: _enum(["draft", "live"]),
@@ -8868,13 +8864,9 @@ object({
 	})),
 	spaces: array(object({
 		space: string(),
-		mode: _enum(["new", "increasing"]),
 		count: number().nonnegative(),
-		watermark: union([
-			string(),
-			number(),
-			_null()
-		]),
+		pendingCount: number().nonnegative(),
+		reservedCount: number().nonnegative(),
 		updatedAt: number()
 	}))
 });
@@ -9177,7 +9169,7 @@ var managedFields = object({
 			revisionId: text
 		}),
 		httpRequestExecutorSchema,
-		dedupeExecutorSchema
+		skipDuplicatesExecutorSchema
 	])
 });
 var managed = managedFields.transform(limitDecisionTask);
@@ -9673,7 +9665,7 @@ function changeOperationsSchema(kind) {
 	return toJSONSchema(schema, { io: "input" });
 }
 function checkModelVersion(content) {
-	if (content.modelVersion < 13 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind === "task" && "executor" in candidateNode.task && candidateNode.task.executor.kind === "dedupe")) throw new Error("Deduplication requires Flow model v13.");
+	if (content.modelVersion < 13 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind === "task" && "executor" in candidateNode.task && candidateNode.task.executor.kind === "skip-duplicates")) throw new Error("Skip Duplicates requires Flow model v13.");
 	if (content.modelVersion < 12 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && "moduleId" in candidateNode.task && candidateNode.task.capabilities?.some((item) => item.kind == "http"))) throw new TypeError("Code HTTP access requires Flow model version 12.");
 	if (content.modelVersion < 11 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && "executor" in candidateNode.task && candidateNode.task.executor.kind == "http-request")) throw new TypeError("HTTP Request requires Flow model version 11.");
 	if (content.modelVersion < 11 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && ("moduleId" in candidateNode.task ? candidateNode.task.capabilities?.some((item) => item.kind == "workflow") : candidateNode.task.executor.kind == "agent" && candidateNode.task.executor.tools.some((item) => item.kind == "workflow")))) throw new TypeError("Workflow tools require Flow model version 11.");
@@ -9772,7 +9764,7 @@ var nodeErrorSchema = {
 	}
 };
 function supportsNodeErrorHandling(node) {
-	return supportsNodeRetry(node) || node.kind === "task" && "executor" in node.task && node.task.executor.kind === "dedupe";
+	return supportsNodeRetry(node) || node.kind === "task" && "executor" in node.task && node.task.executor.kind === "skip-duplicates";
 }
 function nodeSystemOutputPorts(node) {
 	return supportsNodeErrorHandling(node) && node.onError == "error" ? { error: {

package/dist/common/flow-encoding.js

@@ -8616,11 +8616,7 @@ strictObject({
 	scope: _enum(["draft", "live"]),
 	space: string().regex(/^(flow|node:.+)$/)
 });
-var dedupeExecutorSchema = strictObject({
-	field: string().default(""),
-	mode: _enum(["new", "increasing"]).default("new"),
-	space: _enum(["node", "flow"]).default("node")
-}).extend({ kind: literal("dedupe") });
+var skipDuplicatesExecutorSchema = strictObject({ fields: array(string().refine((field) => field.length > 0 && field.split(".").every((part) => part.length > 0), "Use a nonempty dot-separated field path.")).refine((fields) => new Set(fields).size === fields.length, "Identity fields must be distinct.").default([]) }).extend({ kind: literal("skip-duplicates") });
 object({
 	version: literal(1),
 	scope: _enum(["draft", "live"]),
@@ -8639,13 +8635,9 @@ object({
 	})),
 	spaces: array(object({
 		space: string(),
-		mode: _enum(["new", "increasing"]),
 		count: number().nonnegative(),
-		watermark: union([
-			string(),
-			number(),
-			_null()
-		]),
+		pendingCount: number().nonnegative(),
+		reservedCount: number().nonnegative(),
 		updatedAt: number()
 	}))
 });
@@ -8936,7 +8928,7 @@ var managedFields = object({
 			revisionId: text
 		}),
 		httpRequestExecutorSchema,
-		dedupeExecutorSchema
+		skipDuplicatesExecutorSchema
 	])
 });
 var managed = managedFields.transform(limitDecisionTask);
@@ -9655,7 +9647,7 @@ array(union([...new Map(Object.entries(shapes).map(([kind, shape]) => [kind, sha
 	...shape
 })])).values()])).min(1);
 function checkModelVersion(content) {
-	if (content.modelVersion < 13 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind === "task" && "executor" in candidateNode.task && candidateNode.task.executor.kind === "dedupe")) throw new Error("Deduplication requires Flow model v13.");
+	if (content.modelVersion < 13 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind === "task" && "executor" in candidateNode.task && candidateNode.task.executor.kind === "skip-duplicates")) throw new Error("Skip Duplicates requires Flow model v13.");
 	if (content.modelVersion < 12 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && "moduleId" in candidateNode.task && candidateNode.task.capabilities?.some((item) => item.kind == "http"))) throw new TypeError("Code HTTP access requires Flow model version 12.");
 	if (content.modelVersion < 11 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && "executor" in candidateNode.task && candidateNode.task.executor.kind == "http-request")) throw new TypeError("HTTP Request requires Flow model version 11.");
 	if (content.modelVersion < 11 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && ("moduleId" in candidateNode.task ? candidateNode.task.capabilities?.some((item) => item.kind == "workflow") : candidateNode.task.executor.kind == "agent" && candidateNode.task.executor.tools.some((item) => item.kind == "workflow")))) throw new TypeError("Workflow tools require Flow model version 11.");

package/dist/common/flow-semantics.js

@@ -10374,18 +10374,14 @@ strictObject({
 	scope: _enum(["draft", "live"]),
 	space: string().regex(/^(flow|node:.+)$/)
 });
-var dedupeConfigSchema = strictObject({
-	field: string().default(""),
-	mode: _enum(["new", "increasing"]).default("new"),
-	space: _enum(["node", "flow"]).default("node")
-});
-var dedupeExecutorSchema = dedupeConfigSchema.extend({ kind: literal("dedupe") });
-function dedupeTask(config = dedupeConfigSchema.parse({}), name = "Remove Duplicates") {
+var skipDuplicatesConfigSchema = strictObject({ fields: array(string().refine((field) => field.length > 0 && field.split(".").every((part) => part.length > 0), "Use a nonempty dot-separated field path.")).refine((fields) => new Set(fields).size === fields.length, "Identity fields must be distinct.").default([]) });
+var skipDuplicatesExecutorSchema = skipDuplicatesConfigSchema.extend({ kind: literal("skip-duplicates") });
+function skipDuplicatesTask(config = skipDuplicatesConfigSchema.parse({}), name = "Skip Duplicates") {
 	return {
 		name,
 		executor: {
 			...config,
-			kind: "dedupe"
+			kind: "skip-duplicates"
 		},
 		inputs: [{
 			handle: "items",
@@ -10417,13 +10413,9 @@ object$1({
 	})),
 	spaces: array(object$1({
 		space: string(),
-		mode: _enum(["new", "increasing"]),
 		count: number().nonnegative(),
-		watermark: union([
-			string(),
-			number(),
-			_null()
-		]),
+		pendingCount: number().nonnegative(),
+		reservedCount: number().nonnegative(),
 		updatedAt: number()
 	}))
 });
@@ -10802,7 +10794,7 @@ var managedFields = object$1({
 			revisionId: text
 		}),
 		httpRequestExecutorSchema,
-		dedupeExecutorSchema
+		skipDuplicatesExecutorSchema
 	])
 });
 var managed = managedFields.transform(limitDecisionTask);
@@ -11419,7 +11411,7 @@ var nodeErrorSchema = {
 	}
 };
 function supportsNodeErrorHandling(node) {
-	return supportsNodeRetry(node) || node.kind === "task" && "executor" in node.task && node.task.executor.kind === "dedupe";
+	return supportsNodeRetry(node) || node.kind === "task" && "executor" in node.task && node.task.executor.kind === "skip-duplicates";
 }
 function nodeSystemOutputPorts(node) {
 	return supportsNodeErrorHandling(node) && node.onError == "error" ? { error: {
@@ -25007,10 +24999,10 @@ async function validateFlow(revision, engine) {
 			message,
 			path: `/document/graph/nodes/${nodeId}/task/executor`
 		});
-		if (task.executor.kind === "dedupe") {
-			const expected = dedupeTask(task.executor);
+		if (task.executor.kind === "skip-duplicates") {
+			const expected = skipDuplicatesTask(task.executor);
 			if (!dequal(httpPortContracts(task.inputs), httpPortContracts(expected.inputs)) || !dequal(httpPortContracts(task.outputs), httpPortContracts(expected.outputs))) checked.diagnostics.push({
-				code: "dedupe.ports-invalid",
+				code: "skip-duplicates.ports-invalid",
 				column: 0,
 				line: 1,
 				message: "Deduplication ports must match the fixed contract.",
@@ -25151,7 +25143,7 @@ var httpPortContracts = (ports) => ports.filter((port) => "handle" in port).map(
 async function prepareFlow(revision, engineContract, triggerId) {
 	const engine = findEngineContract(engineContract);
 	if (engine == null) return { kind: "engine-unsupported" };
-	if (!engine.flowState && Object.values(revision.document.graph.nodes).some((node) => node.kind === "task" && "executor" in node.task && node.task.executor.kind === "dedupe")) return { kind: "engine-unsupported" };
+	if (!engine.flowState && Object.values(revision.document.graph.nodes).some((node) => node.kind === "task" && "executor" in node.task && node.task.executor.kind === "skip-duplicates")) return { kind: "engine-unsupported" };
 	if (!engine.httpRequests && Object.values(revision.document.graph.nodes).some((node) => node.kind == "task" && "executor" in node.task && node.task.executor.kind == "http-request")) return { kind: "engine-unsupported" };
 	if (!engine.codeFetch && Object.values(revision.document.graph.nodes).some((node) => node.kind == "task" && "moduleId" in node.task && node.task.capabilities?.some((item) => item.kind == "http"))) return { kind: "engine-unsupported" };
 	if (!engine.workflowTools && Object.values(revision.document.graph.nodes).some((node) => nodeWorkflowReferences(node).some((ref) => ref.tool != null))) return { kind: "engine-unsupported" };
@@ -25200,11 +25192,13 @@ async function prepareFlow(revision, engineContract, triggerId) {
 }
 function createRuntimeProgram(prepared, entryModuleId, engineDigest) {
 	if (!Object.hasOwn(prepared.modules, entryModuleId)) return;
+	const modules = /* @__PURE__ */ new Set([entryModuleId]);
+	for (const id of modules) for (const imported of prepared.modules[id].imports) modules.add(imported);
 	return {
 		engineContract: prepared.engineContract,
 		engineDigest,
 		entryModuleId,
-		modules: prepared.modules
+		modules: Object.fromEntries([...modules].map((id) => [id, prepared.modules[id]]))
 	};
 }
 function agentActions(flow) {

package/dist/common/flow-state.d.ts

@@ -24,49 +24,29 @@ export declare const dedupeClearSchema: z.ZodObject<{
     space: z.ZodString;
 }, z.core.$strict>;
 export type DedupeIdentity = string | number;
-export declare const dedupeConfigSchema: z.ZodObject<{
-    field: z.ZodDefault<z.ZodString>;
-    mode: z.ZodDefault<z.ZodEnum<{
-        increasing: "increasing";
-        new: "new";
-    }>>;
-    space: z.ZodDefault<z.ZodEnum<{
-        flow: "flow";
-        node: "node";
-    }>>;
+export declare const skipDuplicatesConfigSchema: z.ZodObject<{
+    fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
-export type DedupeConfig = z.infer<typeof dedupeConfigSchema>;
-export interface DedupeExecutor extends DedupeConfig {
-    readonly kind: 'dedupe';
+export type SkipDuplicatesConfig = z.infer<typeof skipDuplicatesConfigSchema>;
+export interface SkipDuplicatesExecutor extends SkipDuplicatesConfig {
+    readonly kind: 'skip-duplicates';
 }
-export declare const dedupeExecutorSchema: z.ZodObject<{
-    field: z.ZodDefault<z.ZodString>;
-    mode: z.ZodDefault<z.ZodEnum<{
-        increasing: "increasing";
-        new: "new";
-    }>>;
-    space: z.ZodDefault<z.ZodEnum<{
-        flow: "flow";
-        node: "node";
-    }>>;
-    kind: z.ZodLiteral<"dedupe">;
+export declare const skipDuplicatesExecutorSchema: z.ZodObject<{
+    fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    kind: z.ZodLiteral<"skip-duplicates">;
 }, z.core.$strict>;
-export declare function dedupeTask(config?: DedupeConfig, name?: string): ManagedTaskDefinitionOf<DedupeExecutor>;
+export declare function skipDuplicatesTask(config?: SkipDuplicatesConfig, name?: string): ManagedTaskDefinitionOf<SkipDuplicatesExecutor>;
 export declare class StateError extends Error {
     readonly retryable = false;
     readonly catchable: boolean;
-    readonly code: 'capability.invalid' | 'capability.denied' | 'dedupe.full' | 'limit-exceeded';
+    readonly code: 'capability.invalid' | 'capability.denied' | 'dedupe.full' | 'limit-exceeded' | 'node.input-invalid';
     constructor(code: StateError['code'], message: string);
 }
 export declare function stateKey(key: unknown): string;
 export declare function dedupeIdentities(value: unknown): DedupeIdentity[];
 export declare function hashIdentities(ids: readonly DedupeIdentity[]): Promise<Uint8Array[]>;
-export declare function watermarkValue(id: DedupeIdentity): number;
-export declare function increasingIdentities(ids: readonly DedupeIdentity[], watermark: DedupeIdentity | null): {
-    inserted: boolean[];
-    watermark: DedupeIdentity | null;
-};
-export declare function itemIdentities(items: JsonValue, field: string): DedupeIdentity[];
+/** Canonical identities include the field definition and preserve scalar types. */
+export declare function skipDuplicatesIdentities(items: JsonValue, fields: readonly string[]): string[];
 export interface FlowStateView {
     readonly version: 1;
     readonly scope: StateScope;
@@ -85,9 +65,9 @@ export interface FlowStateView {
     }[];
     readonly spaces: readonly {
         readonly space: string;
-        readonly mode: 'new' | 'increasing';
         readonly count: number;
-        readonly watermark: DedupeIdentity | null;
+        readonly pendingCount: number;
+        readonly reservedCount: number;
         readonly updatedAt: number;
     }[];
 }
@@ -112,12 +92,9 @@ export declare const flowStateViewSchema: z.ZodObject<{
     }, z.core.$strip>>;
     spaces: z.ZodArray<z.ZodObject<{
         space: z.ZodString;
-        mode: z.ZodEnum<{
-            increasing: "increasing";
-            new: "new";
-        }>;
         count: z.ZodNumber;
-        watermark: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodNull]>;
+        pendingCount: z.ZodNumber;
+        reservedCount: z.ZodNumber;
         updatedAt: z.ZodNumber;
     }, z.core.$strip>>;
 }, z.core.$strip>;