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

package/dist/common/authoring.d.ts

@@ -10,7 +10,7 @@ export declare class AuthoringError extends Error {
 }
 export declare function authoringNode(content: RevisionContent, ref: string): {
     ref: string;
-    type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "http-request" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "start" | "value" | "wait" | "webhook" | "webhook-response" | "workflow";
+    type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "http-request" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "skip-duplicates" | "start" | "value" | "wait" | "webhook" | "webhook-response" | "workflow";
     name: string;
     readOnly: boolean;
     description?: string | undefined;
@@ -82,7 +82,6 @@ export declare function authoringNode(content: RevisionContent, ref: string): {
     })[];
 };
 export declare function readAuthoring(content: RevisionContent, query?: AuthoringRead): {
-    nodes?: undefined;
     text: {
         node: string;
         field: "code" | "prompt";
@@ -93,12 +92,13 @@ export declare function readAuthoring(content: RevisionContent, query?: Authorin
         nextStart?: number | undefined;
         truncated: boolean;
     };
+    nodes?: undefined;
     edges?: undefined;
 } | {
     text?: undefined;
     nodes: {
         ref: string;
-        type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "http-request" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "start" | "value" | "wait" | "webhook" | "webhook-response" | "workflow";
+        type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "http-request" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "skip-duplicates" | "start" | "value" | "wait" | "webhook" | "webhook-response" | "workflow";
         name: string;
         readOnly: boolean;
         description?: string | undefined;
@@ -174,7 +174,7 @@ export declare function readAuthoring(content: RevisionContent, query?: Authorin
     text?: undefined;
     nodes: {
         ref: string;
-        type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "http-request" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "start" | "value" | "wait" | "webhook" | "webhook-response" | "workflow";
+        type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "http-request" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "skip-duplicates" | "start" | "value" | "wait" | "webhook" | "webhook-response" | "workflow";
         name: string;
         readOnly: boolean;
         inputHandles: string[];

package/dist/common/authoringExamples.d.ts

@@ -8,6 +8,7 @@ declare const descriptions: {
     readonly poll: 'Gmail polling by key; replace CONNECTION_ID with an active Gmail connection.';
     readonly integration: 'Telegram webhook integration by key; replace CONNECTION_ID with an active Telegram connection.';
     readonly decision: 'AI Decision evaluates named questions against target and returns a complete answer object per output. Configure target before running.';
+    readonly '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.';
     readonly 'http-request': 'A single HTTP request. Bind url and request inputs; outputs are body, statusCode and headers.';
     readonly openapi: 'A fixed JSON API operation. Replace the example document and URL before running.';
     readonly 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.';
@@ -23,8 +24,8 @@ declare const descriptions: {
 };
 export declare const authoringExampleNames: (keyof typeof descriptions)[];
 export declare const authoringExamples: {
-    name: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "http-request" | "integration" | "llm-chat" | "llm-json" | "openapi" | "poll" | "poll-notification" | "start" | "value" | "wait" | "webhook" | "webhook-response";
-    description: "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." | "A Flow Error node. Select upstream Flows, then publish and enable this Flow to listen for failures in their automatic runs." | "A JavaScript module and its node. Use Code for custom computation; use Connector Tasks for existing actions." | "A Start node with a required message parameter. Supply it through trigger.outputs." | "A Wait with a continue action and a built-in notification output." | "A Webhook start node." | "A condition with true and false execution branches." | "A fixed JSON API operation. Replace the example document and URL before running." | "A fixed value node." | "A single HTTP request. Bind url and request inputs; outputs are body, statusCode and headers." | "AI Decision evaluates named questions against target and returns a complete answer object per output. Configure target before running." | "An Agent with code computation enabled. Configure a model available in the deployment." | "An Approval with approve and reject decision branches and a built-in notification output." | "An HTTP response node with body, statusCode and headers inputs. Select it from a reachable Webhook." | "An LLM JSON Task and its node; configure a model available in the deployment." | "An LLM chat Task and its node; configure a model available in the deployment." | "An hourly scheduled start node." | "Gmail events → JavaScript text formatting → Connector notification. Replace connection/action IDs and match the notification input ports." | "Gmail polling by key; replace CONNECTION_ID with an active Gmail connection." | "Telegram webhook integration by key; replace CONNECTION_ID with an active Telegram connection.";
+    name: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "http-request" | "integration" | "llm-chat" | "llm-json" | "openapi" | "poll" | "poll-notification" | "skip-duplicates" | "start" | "value" | "wait" | "webhook" | "webhook-response";
+    description: "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." | "A Flow Error node. Select upstream Flows, then publish and enable this Flow to listen for failures in their automatic runs." | "A JavaScript module and its node. Use Code for custom computation; use Connector Tasks for existing actions." | "A Start node with a required message parameter. Supply it through trigger.outputs." | "A Wait with a continue action and a built-in notification output." | "A Webhook start node." | "A condition with true and false execution branches." | "A fixed JSON API operation. Replace the example document and URL before running." | "A fixed value node." | "A single HTTP request. Bind url and request inputs; outputs are body, statusCode and headers." | "AI Decision evaluates named questions against target and returns a complete answer object per output. Configure target before running." | "An Agent with code computation enabled. Configure a model available in the deployment." | "An Approval with approve and reject decision branches and a built-in notification output." | "An HTTP response node with body, statusCode and headers inputs. Select it from a reachable Webhook." | "An LLM JSON Task and its node; configure a model available in the deployment." | "An LLM chat Task and its node; configure a model available in the deployment." | "An hourly scheduled start node." | "Gmail events → JavaScript text formatting → Connector notification. Replace connection/action IDs and match the notification input ports." | "Gmail polling by key; replace CONNECTION_ID with an active Gmail connection." | "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." | "Telegram webhook integration by key; replace CONNECTION_ID with an active Telegram connection.";
 }[];
 export declare function authoringExample(name: string): {
     version: 1;

package/dist/common/authoringSchema.d.ts

@@ -1,6 +1,6 @@
 import type { JsonValue } from '../index.js';
 import { z } from 'zod';
-export declare const authoringTypes: readonly ['start', 'outputs', 'webhook-response', 'workflow', 'webhook', 'cron', 'error', 'poll', 'integration', 'code', 'connector', 'agent', 'llm', 'decision', 'openapi', 'http-request', 'condition', 'value', 'wait', 'approval'];
+export declare const authoringTypes: readonly ['start', 'outputs', 'webhook-response', 'workflow', 'webhook', 'cron', 'error', 'poll', 'integration', 'code', 'connector', 'agent', 'llm', 'decision', 'openapi', 'http-request', 'skip-duplicates', 'condition', 'value', 'wait', 'approval'];
 declare const type: z.ZodEnum<{
     agent: "agent";
     approval: "approval";
@@ -16,6 +16,7 @@ declare const type: z.ZodEnum<{
     openapi: "openapi";
     outputs: "outputs";
     poll: "poll";
+    "skip-duplicates": "skip-duplicates";
     start: "start";
     value: "value";
     wait: "wait";
@@ -303,6 +304,9 @@ export declare const authoringConfigurations: {
             success: "success";
         }>>;
     }, z.core.$strict>;
+    'skip-duplicates': z.ZodObject<{
+        fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>;
     agent: z.ZodObject<{
         code: z.ZodOptional<z.ZodBoolean>;
         model: z.ZodString;
@@ -704,6 +708,7 @@ export declare const authoringEditSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         openapi: "openapi";
         outputs: "outputs";
         poll: "poll";
+        "skip-duplicates": "skip-duplicates";
         start: "start";
         value: "value";
         wait: "wait";
@@ -875,6 +880,7 @@ export declare const authoringRequestSchema: z.ZodObject<{
             openapi: "openapi";
             outputs: "outputs";
             poll: "poll";
+            "skip-duplicates": "skip-duplicates";
             start: "start";
             value: "value";
             wait: "wait";
@@ -1060,6 +1066,7 @@ export declare const authoringSearchSchema: z.ZodObject<{
         openapi: "openapi";
         outputs: "outputs";
         poll: "poll";
+        "skip-duplicates": "skip-duplicates";
         start: "start";
         value: "value";
         wait: "wait";
@@ -1091,6 +1098,7 @@ export declare const authoringSchemaQuery: z.ZodObject<{
         openapi: "openapi";
         outputs: "outputs";
         poll: "poll";
+        "skip-duplicates": "skip-duplicates";
         start: "start";
         value: "value";
         wait: "wait";
@@ -1123,6 +1131,7 @@ export declare function authoringRequestContract(name: string): {
                 openapi: "openapi";
                 outputs: "outputs";
                 poll: "poll";
+                "skip-duplicates": "skip-duplicates";
                 start: "start";
                 value: "value";
                 wait: "wait";
@@ -1305,6 +1314,7 @@ export declare function authoringRequestContract(name: string): {
             openapi: "openapi";
             outputs: "outputs";
             poll: "poll";
+            "skip-duplicates": "skip-duplicates";
             start: "start";
             value: "value";
             wait: "wait";
@@ -1398,7 +1408,7 @@ export declare function authoringRequestContract(name: string): {
 } | undefined;
 export declare function authoringSchema(kind?: AuthoringType): {
     type?: undefined;
-    types: readonly ["start", "outputs", "webhook-response", "workflow", "webhook", "cron", "error", "poll", "integration", "code", "connector", "agent", "llm", "decision", "openapi", "http-request", "condition", "value", "wait", "approval"];
+    types: readonly ["start", "outputs", "webhook-response", "workflow", "webhook", "cron", "error", "poll", "integration", "code", "connector", "agent", "llm", "decision", "openapi", "http-request", "skip-duplicates", "condition", "value", "wait", "approval"];
     request: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
         baseRevision: z.ZodString;
         requestId: z.ZodString;
@@ -1420,6 +1430,7 @@ export declare function authoringSchema(kind?: AuthoringType): {
                 openapi: "openapi";
                 outputs: "outputs";
                 poll: "poll";
+                "skip-duplicates": "skip-duplicates";
                 start: "start";
                 value: "value";
                 wait: "wait";
@@ -1582,7 +1593,7 @@ export declare function authoringSchema(kind?: AuthoringType): {
 } | {
     types?: undefined;
     request?: undefined;
-    type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "http-request" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "start" | "value" | "wait" | "webhook" | "webhook-response" | "workflow";
+    type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "http-request" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "skip-duplicates" | "start" | "value" | "wait" | "webhook" | "webhook-response" | "workflow";
     onError: boolean | {
         enum: string[];
     };
@@ -1596,7 +1607,7 @@ export declare function authoringSchema(kind?: AuthoringType): {
     example: {
         op: string;
         as: string;
-        type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "http-request" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "start" | "value" | "wait" | "webhook" | "webhook-response" | "workflow";
+        type: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "decision" | "error" | "http-request" | "integration" | "llm" | "openapi" | "outputs" | "poll" | "skip-duplicates" | "start" | "value" | "wait" | "webhook" | "webhook-response" | "workflow";
         name: string;
     };
     configuration: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{}, z.core.$strict>>;

package/dist/common/control-api-conformance.js

@@ -8628,6 +8628,44 @@ var httpRequestConfigSchema = strictObject({
 	statusPolicy: _enum(["success", "all"]).default("success")
 });
 var httpRequestExecutorSchema = httpRequestConfigSchema.extend({ kind: literal("http-request") });
+strictObject({
+	scope: _enum(["draft", "live"]),
+	values: boolean().optional()
+});
+strictObject({
+	scope: _enum(["draft", "live"]),
+	key: string$1().min(1).refine((key) => new TextEncoder().encode(key).length <= 256).optional()
+});
+strictObject({
+	scope: _enum(["draft", "live"]),
+	space: string$1().regex(/^(flow|node:.+)$/)
+});
+var skipDuplicatesConfigSchema = strictObject({ fields: array(string$1().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") });
+var flowStateViewSchema = object({
+	version: literal(1),
+	scope: _enum(["draft", "live"]),
+	limits: object({
+		maxValueBytes: number().positive(),
+		maxValues: number().int().positive(),
+		maxSpaces: number().int().positive(),
+		maxIdentities: number().positive(),
+		maxRunWrites: number().positive()
+	}),
+	values: array(object({
+		key: string$1(),
+		size: number().nonnegative(),
+		updatedAt: number(),
+		value: json$4().optional()
+	})),
+	spaces: array(object({
+		space: string$1(),
+		count: number().nonnegative(),
+		pendingCount: number().nonnegative(),
+		reservedCount: number().nonnegative(),
+		updatedAt: number()
+	}))
+});
 function checkJsonDepth(value, depth = 0) {
 	if (depth > 64) throw new TypeError("Value exceeds the maximum JSON depth.");
 	if (value != null && typeof value == "object") for (const child of Object.values(value)) checkJsonDepth(child, depth + 1);
@@ -8916,7 +8954,8 @@ var managedFields = object({
 			flowId: text,
 			revisionId: text
 		}),
-		httpRequestExecutorSchema
+		httpRequestExecutorSchema,
+		skipDuplicatesExecutorSchema
 	])
 });
 var managed = managedFields.transform(limitDecisionTask);
@@ -9186,7 +9225,8 @@ var revision = object({
 		literal(9),
 		literal(10),
 		literal(11),
-		literal(12)
+		literal(12),
+		literal(13)
 	]),
 	document,
 	modules: record$3(text, module)
@@ -9387,6 +9427,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 === "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.");
@@ -9416,10 +9457,10 @@ function upgradeRevisionContent(content) {
 function upgradeDecodedRevisionContent(content) {
 	const graph = content.document.graph;
 	const hasManual = Object.values(graph.nodes).some((node) => node.kind == "manual");
-	if (!hasManual && content.modelVersion == 12) return content;
+	if (!hasManual && content.modelVersion == 13) return content;
 	return {
 		...content,
-		modelVersion: 12,
+		modelVersion: 13,
 		document: {
 			...content.document,
 			graph: hasManual ? {
@@ -9438,8 +9479,8 @@ function upgradeManualTrigger(node) {
 }
 //#endregion
 //#region src/runtime/common/engineContract.ts
-/** v9 is a single contract: the Node compatibility builtins, `context.fetch`, and no `context.egress`. */
-var currentEngineContract = "open-flow-engine/v9";
+/** v10 adds persistent Flow State to the published v9 Node compatibility and fetch contract. */
+var currentEngineContract = "open-flow-engine/v10";
 /** The published v8 Node compatibility contract, retained for existing Publications and Runs. */
 var nodejsEngineContract = "open-flow-engine/v8/nodejs-compat-v1";
 var platformSource = (contract) => `export const engineContract = ${JSON.stringify(contract)}
@@ -9484,13 +9525,19 @@ var nodejsContract = {
 	].flatMap((name) => [name, `node:${name}`])),
 	platformSource: platformSource(nodejsEngineContract)
 };
-var currentContract = {
+var v9Contract = {
 	...nodejsContract,
 	codeFetch: true,
+	platformSource: platformSource("open-flow-engine/v9")
+};
+var currentContract = {
+	...v9Contract,
+	flowState: true,
 	platformSource: platformSource(currentEngineContract)
 };
 function findEngineContract(contract) {
-	if (contract == "open-flow-engine/v9") return currentContract;
+	if (contract == "open-flow-engine/v10") return currentContract;
+	if (contract == "open-flow-engine/v9") return v9Contract;
 	if (contract == "open-flow-engine/v8") return v8Contract;
 	if (contract == "open-flow-engine/v8/nodejs-compat-v1") return nodejsContract;
 	if (contract == "open-flow-engine/v7" || contract == "open-flow-engine/v7/nodejs-compat-v1") return {
@@ -9594,6 +9641,7 @@ var type = _enum([
 	"decision",
 	"openapi",
 	"http-request",
+	"skip-duplicates",
 	"condition",
 	"value",
 	"wait",
@@ -9724,6 +9772,7 @@ var authoringConfigurations = {
 	"connector": authoringDefinitionSchemas.connector.omit({ outputMode: true }).strict(),
 	"openapi": authoringOpenApiSchema,
 	"http-request": httpRequestConfigSchema,
+	"skip-duplicates": skipDuplicatesConfigSchema,
 	"agent": authoringDefinitionSchemas.agent.omit({
 		prompt: true,
 		tools: true
@@ -9954,11 +10003,14 @@ var controlErrorCode = {
 	triggerKeyInvalid: "trigger-key.invalid",
 	triggerKeyNotFound: "trigger-key.not-found",
 	triggerNotFound: "trigger.not-found",
+	tagInvalid: "tag.invalid",
+	tagConflict: "tag.conflict",
+	tagNotFound: "tag.not-found",
 	variableInvalid: "variable.invalid",
 	variableLimitReached: "variable.limit-reached",
 	variableNotFound: "variable.not-found"
 };
-controlErrorCode.eventSourceInvalid, controlErrorCode.eventSourceIdentityUnavailable, controlErrorCode.eventSourceNotFound, controlErrorCode.eventSourceConflict, controlErrorCode.authenticationRequired, controlErrorCode.authorizationDenied, controlErrorCode.bindingUnresolved, controlErrorCode.connectorActionNotFound, controlErrorCode.connectorAccessConflict, controlErrorCode.connectorAccessInvalid, controlErrorCode.connectorAccessRequired, controlErrorCode.connectorAccessUnsupported, controlErrorCode.connectorUnconfigured, controlErrorCode.connectorUnavailable, controlErrorCode.connectorConsoleUnconfigured, controlErrorCode.engineUnavailable, controlErrorCode.engineUnsupported, controlErrorCode.flowInvalid, controlErrorCode.flowRepairRequired, controlErrorCode.flowUpgradeRequired, controlErrorCode.flowNotFound, controlErrorCode.flowBusy, controlErrorCode.flowConflict, controlErrorCode.flowPresentationConflict, controlErrorCode.flowRevisionConflict, controlErrorCode.liveConflict, controlErrorCode.liveNotFound, controlErrorCode.pageInvalidCursor, controlErrorCode.publicationConflict, controlErrorCode.publicationNotFound, controlErrorCode.publicationUnsupported, controlErrorCode.publishOperationNotFound, controlErrorCode.routeNotFound, controlErrorCode.runConflict, controlErrorCode.runEventsExpired, controlErrorCode.runInvalid, controlErrorCode.runNotFound, controlErrorCode.runNotTerminal, controlErrorCode.runOverloaded, controlErrorCode.runWaitNotFound, controlErrorCode.triggerKeyInvalid, controlErrorCode.triggerKeyNotFound, controlErrorCode.triggerNotFound, controlErrorCode.variableInvalid, controlErrorCode.variableLimitReached, controlErrorCode.variableNotFound;
+controlErrorCode.eventSourceInvalid, controlErrorCode.eventSourceIdentityUnavailable, controlErrorCode.eventSourceNotFound, controlErrorCode.eventSourceConflict, controlErrorCode.authenticationRequired, controlErrorCode.authorizationDenied, controlErrorCode.bindingUnresolved, controlErrorCode.connectorActionNotFound, controlErrorCode.connectorAccessConflict, controlErrorCode.connectorAccessInvalid, controlErrorCode.connectorAccessRequired, controlErrorCode.connectorAccessUnsupported, controlErrorCode.connectorUnconfigured, controlErrorCode.connectorUnavailable, controlErrorCode.connectorConsoleUnconfigured, controlErrorCode.engineUnavailable, controlErrorCode.engineUnsupported, controlErrorCode.flowInvalid, controlErrorCode.flowRepairRequired, controlErrorCode.flowUpgradeRequired, controlErrorCode.flowNotFound, controlErrorCode.flowBusy, controlErrorCode.flowConflict, controlErrorCode.flowPresentationConflict, controlErrorCode.flowRevisionConflict, controlErrorCode.liveConflict, controlErrorCode.liveNotFound, controlErrorCode.pageInvalidCursor, controlErrorCode.publicationConflict, controlErrorCode.publicationNotFound, controlErrorCode.publicationUnsupported, controlErrorCode.publishOperationNotFound, controlErrorCode.routeNotFound, controlErrorCode.runConflict, controlErrorCode.runEventsExpired, controlErrorCode.runInvalid, controlErrorCode.runNotFound, controlErrorCode.runNotTerminal, controlErrorCode.runOverloaded, controlErrorCode.runWaitNotFound, controlErrorCode.triggerKeyInvalid, controlErrorCode.triggerKeyNotFound, controlErrorCode.triggerNotFound, controlErrorCode.tagInvalid, controlErrorCode.tagConflict, controlErrorCode.tagNotFound, controlErrorCode.variableInvalid, controlErrorCode.variableLimitReached, controlErrorCode.variableNotFound;
 var ApiError = class extends Error {
 	constructor(status, code, message, details) {
 		super(message);
@@ -11230,6 +11282,7 @@ function flow(value) {
 			publicationId: string(target.publicationId),
 			revisionId: string(target.revisionId)
 		} },
+		tagIds: source.tagIds === void 0 ? [] : strings(source.tagIds),
 		createdAt: string(source.createdAt),
 		...source.connectorTeamId == null ? {} : { connectorTeamId: string(source.connectorTeamId) },
 		draftRevisionId: string(source.draftRevisionId),
@@ -11675,6 +11728,33 @@ function randomId() {
 	return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
 }
 //#endregion
+//#region src/control/common/tags.ts
+function normalizeFlowQuery(query = {}) {
+	return {
+		query: query.query?.trim().toLowerCase() ?? "",
+		tagIds: [...new Set(query.tagIds ?? [])].toSorted(),
+		untagged: query.untagged ?? false
+	};
+}
+function decodeTag(value) {
+	const source = record$1(value);
+	if (source.version != 1) return invalidResponse();
+	return {
+		tagId: string(source.tagId),
+		name: string(source.name),
+		version: 1
+	};
+}
+function decodeTagListItem(value) {
+	const source = record$1(value);
+	const referenceCount = integer(source.referenceCount);
+	if (referenceCount < 0) return invalidResponse();
+	return {
+		...decodeTag(source),
+		referenceCount
+	};
+}
+//#endregion
 //#region src/control/common/api.ts
 function decodeRunEvent(value) {
 	const source = record$1(value);
@@ -11778,7 +11858,7 @@ function decodeRunEvent(value) {
 			switch (kind) {
 				case "node.started": {
 					const nodeKind = payload.nodeKind;
-					if (nodeKind !== void 0 && nodeKind !== "approval" && nodeKind !== "condition" && nodeKind !== "connector" && nodeKind !== "javascript" && nodeKind !== "decision" && nodeKind !== "openapi" && nodeKind !== "http-request" && nodeKind !== "llm" && nodeKind !== "agent" && nodeKind !== "value" && nodeKind !== "outputs" && nodeKind !== "webhook-response" && nodeKind !== "workflow" && nodeKind !== "wait") return invalidResponse();
+					if (nodeKind !== void 0 && nodeKind !== "approval" && nodeKind !== "condition" && nodeKind !== "connector" && nodeKind !== "javascript" && nodeKind !== "decision" && nodeKind !== "openapi" && nodeKind !== "http-request" && nodeKind !== "skip-duplicates" && nodeKind !== "llm" && nodeKind !== "agent" && nodeKind !== "value" && nodeKind !== "outputs" && nodeKind !== "webhook-response" && nodeKind !== "workflow" && nodeKind !== "wait") return invalidResponse();
 					return {
 						...base,
 						kind,
@@ -11905,6 +11985,10 @@ var ControlClient = class {
 	}
 	async listFlows(options = {}) {
 		const parameters = new URLSearchParams();
+		const filter = normalizeFlowQuery(options);
+		if (filter.query) parameters.set("query", filter.query);
+		if (filter.tagIds.length) parameters.set("tagIds", filter.tagIds.join(","));
+		if (filter.untagged) parameters.set("untagged", "true");
 		if (options.cursor != null) parameters.set("cursor", options.cursor);
 		if (options.limit != null) parameters.set("limit", String(options.limit));
 		if (options.includeTotal != null) parameters.set("includeTotal", String(options.includeTotal));
@@ -11994,15 +12078,18 @@ var ControlClient = class {
 				file,
 				name: options.name,
 				teamId: options.teamId,
+				tagIds: options.tagIds,
 				version: 1
 			})
 		}));
 	}
-	async createFlow(name, idempotencyKey = `flow-${randomId()}`, teamId) {
+	async createFlow(name, idempotencyKey = `flow-${randomId()}`, teamId, tagIds, initialPresentation) {
 		return flow(await this.request("/v1/flows", {
 			body: JSON.stringify({
 				name,
 				...teamId == null ? {} : { teamId },
+				...tagIds == null ? {} : { tagIds },
+				...initialPresentation == null ? {} : { presentation: initialPresentation },
 				version: 1
 			}),
 			headers: { "idempotency-key": idempotencyKey },
@@ -12037,15 +12124,68 @@ var ControlClient = class {
 		if (source.version != 1 || !Array.isArray(source.listeners)) return invalidResponse();
 		return source.listeners.map(errorListener);
 	}
-	async renameFlow(flowId, name) {
-		return flow(await this.request(`/v1/flows/${segment(flowId)}`, {
+	async listTags(signal) {
+		const source = record$1(await this.request("/v1/tags", { signal }));
+		if (source.version != 1 || !Array.isArray(source.tags)) return invalidResponse();
+		return {
+			tags: source.tags.map(decodeTagListItem),
+			version: 1
+		};
+	}
+	async createTag(name) {
+		return decodeTag(await this.request("/v1/tags", {
+			method: "POST",
 			body: JSON.stringify({
 				name,
 				version: 1
-			}),
-			method: "PATCH"
+			})
+		}));
+	}
+	async renameTag(tagId, name) {
+		return decodeTag(await this.request(`/v1/tags/${segment(tagId)}`, {
+			method: "PATCH",
+			body: JSON.stringify({
+				name,
+				version: 1
+			})
+		}));
+	}
+	async deleteTag(tagId) {
+		if (record$1(await this.request(`/v1/tags/${segment(tagId)}`, { method: "DELETE" })).version != 1) invalidResponse();
+	}
+	async setFlowTags(flowId, tagIds) {
+		return flow(await this.request(`/v1/flows/${segment(flowId)}/tags`, {
+			method: "PUT",
+			body: JSON.stringify({
+				tagIds,
+				version: 1
+			})
+		}));
+	}
+	async updateFlow(flowId, changes) {
+		return flow(await this.request(`/v1/flows/${segment(flowId)}`, {
+			method: "PATCH",
+			body: JSON.stringify({
+				...changes,
+				version: 1
+			})
 		}));
 	}
+	async getFlowState(flowId, scope, values = false) {
+		const result = flowStateViewSchema.safeParse(await this.request(`/v1/flows/${segment(flowId)}/state?scope=${scope}&values=${values}`));
+		return result.success && result.data.scope === scope ? result.data : invalidResponse();
+	}
+	async clearFlowState(flowId, scope, key) {
+		const source = record$1(await this.request(`/v1/flows/${segment(flowId)}/state?scope=${scope}${key == null ? "" : `&key=${encodeURIComponent(key)}`}`, { method: "DELETE" }));
+		if (source.version !== 1 || source.cleared !== true) invalidResponse();
+	}
+	async clearFlowDedupe(flowId, scope, space) {
+		const source = record$1(await this.request(`/v1/flows/${segment(flowId)}/dedupe?scope=${scope}&space=${encodeURIComponent(space)}`, { method: "DELETE" }));
+		if (source.version !== 1 || source.cleared !== true) invalidResponse();
+	}
+	async renameFlow(flowId, name) {
+		return this.updateFlow(flowId, { name });
+	}
 	async deleteFlow(flowId) {
 		return flow(await this.request(`/v1/flows/${segment(flowId)}`, { method: "DELETE" }));
 	}

package/dist/common/control-api-errors.d.ts

@@ -42,6 +42,9 @@ export declare const controlErrorCode: {
     readonly triggerKeyInvalid: 'trigger-key.invalid';
     readonly triggerKeyNotFound: 'trigger-key.not-found';
     readonly triggerNotFound: 'trigger.not-found';
+    readonly tagInvalid: 'tag.invalid';
+    readonly tagConflict: 'tag.conflict';
+    readonly tagNotFound: 'tag.not-found';
     readonly variableInvalid: 'variable.invalid';
     readonly variableLimitReached: 'variable.limit-reached';
     readonly variableNotFound: 'variable.not-found';
@@ -177,6 +180,15 @@ export declare const controlErrorMetadata: {
     readonly "trigger.not-found": {
         readonly status: 404;
     };
+    readonly "tag.invalid": {
+        readonly status: 400;
+    };
+    readonly "tag.conflict": {
+        readonly status: 409;
+    };
+    readonly "tag.not-found": {
+        readonly status: 404;
+    };
     readonly "variable.invalid": {
         readonly status: 400;
     };

package/dist/common/control-api.d.ts

@@ -1,4 +1,5 @@
 import type { CanvasCommand } from './canvas-commands.js';
+import type { FlowStateView, StateScope } from './flow-state.js';
 export type { CanvasCommand, CanvasCommandSubscriber } from './canvas-commands.js';
 import type { LiveDetails } from './liveDetails.js';
 export { liveEntries } from './liveDetails.js';
@@ -34,6 +35,7 @@ export type { JsonValue, TriggerKeySnapshot, WaitAction } from './flow-change.js
 export type { RunStatus } from './run-lifecycle.js';
 export { ApiError, controlErrorCode, controlErrorMetadata, type ControlErrorCode } from './control-api-errors.js';
 export type { FlowCatalogEvent, FlowChangeEvent } from './flow-notifications.js';
+export { normalizeFlowQuery } from './tags.js';
 export interface CanvasBroadcast {
     readonly version: 1;
     readonly flowId: string;
@@ -59,7 +61,25 @@ export interface FlowResources {
         }[];
     };
 }
+export interface FlowUpdate {
+    readonly name?: string;
+    readonly tagIds?: readonly string[];
+}
+export interface FlowQuery {
+    readonly query?: string;
+    readonly tagIds?: readonly string[];
+    readonly untagged?: boolean;
+}
+export interface Tag {
+    readonly tagId: string;
+    readonly name: string;
+    readonly version: 1;
+}
+export interface TagListItem extends Tag {
+    readonly referenceCount: number;
+}
 export interface Flow {
+    readonly tagIds?: readonly string[];
     readonly live?: {
         readonly enabled: boolean;
         readonly hasStart: boolean;
@@ -81,6 +101,10 @@ export interface PublicationPresentation {
     readonly version: 1;
     readonly presentation: Presentation | null;
 }
+export interface FlowCreationOptions {
+    readonly tagIds?: readonly string[];
+    readonly presentation?: Readonly<Record<string, JsonValue>>;
+}
 export interface Presentation {
     readonly revision: number;
     readonly updatedAt: string;
@@ -740,7 +764,7 @@ export declare class ControlClient {
     private readonly channel;
     constructor(requestControl: ControlRequest, channel?: 'workbench' | 'cli' | 'api');
     loadOpenApiDocument(url: string, signal?: AbortSignal): Promise<JsonValue>;
-    listFlows(options?: {
+    listFlows(options?: FlowQuery & {
         readonly cursor?: string;
         readonly includeTotal?: boolean;
         readonly limit?: number;
@@ -808,11 +832,24 @@ export declare class ControlClient {
         readonly name?: string;
         readonly teamId?: string;
         readonly idempotencyKey?: string;
+        readonly tagIds?: readonly string[];
     }): Promise<Flow>;
-    createFlow(name: string, idempotencyKey?: string, teamId?: string): Promise<Flow>;
+    createFlow(name: string, idempotencyKey?: string, teamId?: string, tagIds?: readonly string[], initialPresentation?: Readonly<Record<string, JsonValue>>): Promise<Flow>;
     broadcastCanvas(flowId: string, command: CanvasCommand): Promise<CanvasBroadcast>;
     getFlow(flowId: string): Promise<Flow>;
     getErrorListeners(flowId: string, signal?: AbortSignal): Promise<readonly ErrorListener[]>;
+    listTags(signal?: AbortSignal): Promise<{
+        readonly tags: readonly TagListItem[];
+        readonly version: 1;
+    }>;
+    createTag(name: string): Promise<Tag>;
+    renameTag(tagId: string, name: string): Promise<Tag>;
+    deleteTag(tagId: string): Promise<void>;
+    setFlowTags(flowId: string, tagIds: readonly string[]): Promise<Flow>;
+    updateFlow(flowId: string, changes: FlowUpdate): Promise<Flow>;
+    getFlowState(flowId: string, scope: StateScope, values?: boolean): Promise<FlowStateView>;
+    clearFlowState(flowId: string, scope: StateScope, key?: string): Promise<void>;
+    clearFlowDedupe(flowId: string, scope: StateScope, space: string): Promise<void>;
     renameFlow(flowId: string, name: string): Promise<Flow>;
     deleteFlow(flowId: string): Promise<Flow>;
     listTriggerKeys(signal?: AbortSignal, locale?: string): Promise<readonly TriggerKeySummary[]>;