@oomol-lab/open-flow 0.1.0-beta.51 → 0.1.0-beta.53

package/dist/browser/workbenchSelect-BqUPacsr.js

@@ -0,0 +1,31 @@
+import { Ir as cn, ct as SelectContent, ft as SelectTrigger, lt as SelectGroup, ot as Select, pt as SelectValue, ut as SelectItem } from "./icons-0s-Q_3lp.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/workbench/browser/runtime/shell/workbenchSelect.tsx
+function WorkbenchSelect({ ariaLabel, className, disabled = false, id, onValueChange, options, portalRoot, size, value, variant }) {
+	return /* @__PURE__ */ jsxs(Select, {
+		disabled,
+		onValueChange: (next) => {
+			if (next != null) onValueChange(next);
+		},
+		value,
+		children: [/* @__PURE__ */ jsx(SelectTrigger, {
+			"aria-label": ariaLabel,
+			className: cn("min-w-32", className),
+			id,
+			size,
+			variant,
+			children: /* @__PURE__ */ jsx(SelectValue, { children: options.find((option) => option.value == value)?.label ?? value })
+		}), /* @__PURE__ */ jsx(SelectContent, {
+			align: "end",
+			alignItemWithTrigger: false,
+			container: portalRoot,
+			children: /* @__PURE__ */ jsx(SelectGroup, { children: options.map((option) => /* @__PURE__ */ jsx(SelectItem, {
+				disabled: option.disabled,
+				value: option.value,
+				children: option.label
+			}, option.value)) })
+		})]
+	});
+}
+//#endregion
+export { WorkbenchSelect as t };

package/dist/common/authoringExamples.d.ts

@@ -1,11 +1,12 @@
 import type { DraftOperation } from './draftOperations.js';
 declare const descriptions: {
     readonly manual: 'A Manual start node.';
-    readonly error: 'An Error Trigger. Publish and enable this Flow before selecting it as another Flow’s error workflow.';
+    readonly error: 'A Flow Error node. Select upstream Flows, then publish and enable this Flow to listen for failures in their automatic runs.';
     readonly webhook: 'A Webhook start node.';
     readonly cron: 'An hourly scheduled start node.';
     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 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.';
     readonly code: 'A JavaScript module and its node. Use Code for custom computation; use Connector Tasks for existing actions.';
     readonly condition: 'A condition with true and false execution branches.';
@@ -19,8 +20,8 @@ declare const descriptions: {
 };
 export declare const authoringExampleNames: (keyof typeof descriptions)[];
 export declare const authoringExamples: {
-    name: "agent" | "approval" | "code" | "condition" | "connector" | "cron" | "error" | "integration" | "llm-chat" | "llm-json" | "manual" | "poll" | "poll-notification" | "value" | "wait" | "webhook";
-    description: "A Connector Task and its node. Replace ACTION_ID, CONNECTION_ID and port definitions using connector_get / connector show." | "A JavaScript module and its node. Use Code for custom computation; use Connector Tasks for existing actions." | "A Manual start node." | "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 value node." | "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 Error Trigger. Publish and enable this Flow before selecting it as another Flow’s error workflow." | "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" | "error" | "integration" | "llm-chat" | "llm-json" | "manual" | "openapi" | "poll" | "poll-notification" | "value" | "wait" | "webhook";
+    description: "A Connector Task and its node. Replace ACTION_ID, CONNECTION_ID and port definitions using connector_get / connector show." | "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 Manual start node." | "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." | "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 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.";
 }[];
 export declare function authoringExample(name: string): {
     version: 1;

package/dist/common/connector-proxy.d.ts

@@ -1,3 +1,34 @@
+import type { JsonValue } from '../browser/flow-change.js';
+export type TriggerOperationRequest = {
+    readonly operation: 'read';
+    readonly config: Readonly<Record<string, JsonValue>>;
+    readonly checkpoint: JsonValue;
+} | {
+    readonly operation: 'options';
+    readonly config: Readonly<Record<string, JsonValue>>;
+    readonly field: string;
+} | {
+    readonly operation: 'reconcile';
+    readonly subscriptionId?: string;
+    readonly config: Readonly<Record<string, JsonValue>>;
+    readonly requestKey: string;
+    readonly endpointUrl: string;
+    readonly active: boolean;
+} | {
+    readonly operation: 'receive';
+    readonly subscriptionId: string;
+    readonly method: string;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly query: Readonly<Record<string, string>>;
+    readonly rawBody: string;
+    readonly admit: boolean;
+    readonly current: boolean;
+} | {
+    readonly operation: 'resource';
+    readonly config: Readonly<Record<string, JsonValue>>;
+    readonly requestKey: string;
+    readonly active: boolean;
+};
 export interface ConnectorProxyRequest {
     readonly body?: unknown;
     readonly endpoint: string;
@@ -10,5 +41,6 @@ export interface ConnectorProxyResult {
     readonly status: number;
 }
 export interface ConnectorProxy {
+    trigger?(request: TriggerOperationRequest, signal?: AbortSignal): Promise<unknown>;
     execute(request: ConnectorProxyRequest, signal?: AbortSignal): Promise<ConnectorProxyResult>;
 }

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

@@ -5799,6 +5799,15 @@ function json$3(params) {
 	});
 	return jsonSchema;
 }
+//#endregion
+//#region src/openapi/common/authBindings.ts
+/** Never allow credentials to enter a Revision as literal node inputs. */
+function assertOpenApiAuthBindings(document) {
+	for (const graph of [document.graph, ...Object.values(document.subflows).map((subflow) => subflow.graph)]) for (const node of Object.values(graph.nodes)) {
+		if (node.kind != "task" || node.taskId == null || document.tasks[node.taskId]?.executor.kind != "openapi") continue;
+		for (const [handle, mapping] of Object.entries(node.inputs)) if (handle.startsWith("auth.") && (mapping.kind == "value" || mapping.kind == "sources" && mapping.sources.some((source) => source.kind == "flow"))) throw new TypeError("OpenAPI authentication accepts deployment variables and upstream outputs only.");
+	}
+}
 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);
@@ -5929,6 +5938,24 @@ var managed = object({
 			action: text,
 			connectionId: text.optional()
 		}),
+		object({
+			kind: literal("openapi"),
+			sourceUrl: text,
+			method: text,
+			path: text,
+			serverUrl: text,
+			document: json$2,
+			auth: array(object({
+				id: text,
+				type: _enum([
+					"bearer",
+					"basic",
+					"apiKey"
+				]),
+				name: text.optional(),
+				in: _enum(["header", "query"]).optional()
+			}))
+		}),
 		object({
 			kind: literal("llm"),
 			mode: _enum(["chat", "json"])
@@ -6195,6 +6222,7 @@ function decodeRevisionContent(value) {
 	checkJsonDepth(value);
 	const content = revision.parse(value);
 	checkErrorModelVersion(content);
+	assertOpenApiAuthBindings(content.document);
 	return content;
 }
 var shapes = {
@@ -6356,6 +6384,11 @@ var shapes = {
 		before: text.optional(),
 		value: text.optional()
 	},
+	"task.openapi.set": {
+		taskId: text,
+		before: managed,
+		value: managed
+	},
 	"task.agent.set": {
 		taskId: text,
 		before: managed,
@@ -6419,14 +6452,19 @@ function accessPermissions(value) {
 	exact(source, [
 		"actionIds",
 		"allActions",
+		"triggerIds",
+		"allTriggers",
 		"configured",
 		"proxy"
 	]);
-	if (!Array.isArray(source.actionIds) || typeof source.allActions != "boolean" || typeof source.configured != "boolean" || typeof source.proxy != "boolean") return invalidResponse();
+	if (!Array.isArray(source.triggerIds) || typeof source.allTriggers != "boolean" || !Array.isArray(source.actionIds) || typeof source.allActions != "boolean" || typeof source.configured != "boolean" || typeof source.proxy != "boolean") return invalidResponse();
 	const actionIds = source.actionIds.map(string$1);
-	if (new Set(actionIds).size != actionIds.length || source.allActions != (actionIds.length == 0) || source.proxy != (source.allActions && !source.configured)) return invalidResponse();
+	const triggerIds = source.triggerIds.map(string$1);
+	if (new Set(actionIds).size != actionIds.length || source.allActions && actionIds.length != 0 || new Set(triggerIds).size != triggerIds.length || source.allTriggers && triggerIds.length != 0 || source.proxy && (!source.allActions || !source.allTriggers || source.configured)) return invalidResponse();
 	return {
 		actionIds,
+		triggerIds,
+		allTriggers: source.allTriggers,
 		allActions: source.allActions,
 		configured: source.configured,
 		proxy: source.proxy
@@ -9980,6 +10018,7 @@ function flow(value) {
 			revisionId: string$1(target.revisionId)
 		} },
 		createdAt: string$1(source.createdAt),
+		...source.connectorTeamId == null ? {} : { connectorTeamId: string$1(source.connectorTeamId) },
 		draftRevisionId: string$1(source.draftRevisionId),
 		flowId: string$1(source.flowId),
 		name: string$1(source.name),
@@ -10572,7 +10611,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 !== "llm" && nodeKind !== "agent" && nodeKind !== "subflow" && nodeKind !== "value" && nodeKind !== "wait") return invalidResponse();
+					if (nodeKind !== void 0 && nodeKind !== "approval" && nodeKind !== "condition" && nodeKind !== "connector" && nodeKind !== "javascript" && nodeKind !== "openapi" && nodeKind !== "llm" && nodeKind !== "agent" && nodeKind !== "subflow" && nodeKind !== "value" && nodeKind !== "wait") return invalidResponse();
 					return {
 						...base,
 						kind,
@@ -10681,6 +10720,18 @@ var ControlClient = class {
 	constructor(requestControl) {
 		this.requestControl = requestControl;
 	}
+	async loadOpenApiDocument(url, signal) {
+		const result = record$2(await this.request("/v1/openapi/document", {
+			method: "POST",
+			body: JSON.stringify({
+				url,
+				version: 1
+			}),
+			signal
+		}));
+		if (result.version != 1) return invalidResponse();
+		return jsonValue(result.document);
+	}
 	async listFlows(options = {}) {
 		const parameters = new URLSearchParams();
 		if (options.cursor != null) parameters.set("cursor", options.cursor);

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

@@ -40,6 +40,8 @@ export interface Flow {
     readonly createdAt: string;
     readonly draftRevisionId: string;
     readonly flowId: string;
+    /** Connector Team scope used by the OOMOL resource cache. */
+    readonly connectorTeamId?: string;
     readonly name: string;
     readonly status: 'active' | 'retiring';
     readonly updatedAt: string;
@@ -174,6 +176,8 @@ export interface ProviderAccessBindingCandidate extends ProviderAccessIdentity {
     readonly permissions?: {
         readonly actionIds: readonly string[];
         readonly allActions: boolean;
+        readonly triggerIds: readonly string[];
+        readonly allTriggers: boolean;
         readonly configured: boolean;
         readonly proxy: boolean;
     };
@@ -388,6 +392,7 @@ export interface RunPage {
 }
 export type RunEvent = Readonly<ReturnType<typeof decodeRunEvent>>;
 export type RunEventKind = RunEvent['kind'];
+export declare function isRunTerminalEvent(event: RunEvent | undefined): boolean;
 export interface RunEvents {
     readonly done: boolean;
     readonly events: readonly RunEvent[];
@@ -719,6 +724,7 @@ export type ConditionalResult<T> = {
 export declare class ControlClient {
     private readonly requestControl;
     constructor(requestControl: ControlRequest);
+    loadOpenApiDocument(url: string, signal?: AbortSignal): Promise<JsonValue>;
     listFlows(options?: {
         readonly cursor?: string;
         readonly includeTotal?: boolean;

package/dist/common/control-api.js

@@ -5822,6 +5822,15 @@ function json$2(params) {
 	});
 	return jsonSchema;
 }
+//#endregion
+//#region src/openapi/common/authBindings.ts
+/** Never allow credentials to enter a Revision as literal node inputs. */
+function assertOpenApiAuthBindings(document) {
+	for (const graph of [document.graph, ...Object.values(document.subflows).map((subflow) => subflow.graph)]) for (const node of Object.values(graph.nodes)) {
+		if (node.kind != "task" || node.taskId == null || document.tasks[node.taskId]?.executor.kind != "openapi") continue;
+		for (const [handle, mapping] of Object.entries(node.inputs)) if (handle.startsWith("auth.") && (mapping.kind == "value" || mapping.kind == "sources" && mapping.sources.some((source) => source.kind == "flow"))) throw new TypeError("OpenAPI authentication accepts deployment variables and upstream outputs only.");
+	}
+}
 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);
@@ -5955,6 +5964,24 @@ var managed = object({
 			action: text,
 			connectionId: text.optional()
 		}),
+		object({
+			kind: literal("openapi"),
+			sourceUrl: text,
+			method: text,
+			path: text,
+			serverUrl: text,
+			document: json$1,
+			auth: array(object({
+				id: text,
+				type: _enum([
+					"bearer",
+					"basic",
+					"apiKey"
+				]),
+				name: text.optional(),
+				in: _enum(["header", "query"]).optional()
+			}))
+		}),
 		object({
 			kind: literal("llm"),
 			mode: _enum(["chat", "json"])
@@ -6221,6 +6248,7 @@ function decodeRevisionContent(value) {
 	checkJsonDepth(value);
 	const content = revision.parse(value);
 	checkErrorModelVersion(content);
+	assertOpenApiAuthBindings(content.document);
 	return content;
 }
 var shapes = {
@@ -6382,6 +6410,11 @@ var shapes = {
 		before: text.optional(),
 		value: text.optional()
 	},
+	"task.openapi.set": {
+		taskId: text,
+		before: managed,
+		value: managed
+	},
 	"task.agent.set": {
 		taskId: text,
 		before: managed,
@@ -6498,14 +6531,19 @@ function accessPermissions(value) {
 	exact(source, [
 		"actionIds",
 		"allActions",
+		"triggerIds",
+		"allTriggers",
 		"configured",
 		"proxy"
 	]);
-	if (!Array.isArray(source.actionIds) || typeof source.allActions != "boolean" || typeof source.configured != "boolean" || typeof source.proxy != "boolean") return invalidResponse();
+	if (!Array.isArray(source.triggerIds) || typeof source.allTriggers != "boolean" || !Array.isArray(source.actionIds) || typeof source.allActions != "boolean" || typeof source.configured != "boolean" || typeof source.proxy != "boolean") return invalidResponse();
 	const actionIds = source.actionIds.map(string$1);
-	if (new Set(actionIds).size != actionIds.length || source.allActions != (actionIds.length == 0) || source.proxy != (source.allActions && !source.configured)) return invalidResponse();
+	const triggerIds = source.triggerIds.map(string$1);
+	if (new Set(actionIds).size != actionIds.length || source.allActions && actionIds.length != 0 || new Set(triggerIds).size != triggerIds.length || source.allTriggers && triggerIds.length != 0 || source.proxy && (!source.allActions || !source.allTriggers || source.configured)) return invalidResponse();
 	return {
 		actionIds,
+		triggerIds,
+		allTriggers: source.allTriggers,
 		allActions: source.allActions,
 		configured: source.configured,
 		proxy: source.proxy
@@ -10570,6 +10608,7 @@ function flow(value) {
 			revisionId: string$1(target.revisionId)
 		} },
 		createdAt: string$1(source.createdAt),
+		...source.connectorTeamId == null ? {} : { connectorTeamId: string$1(source.connectorTeamId) },
 		draftRevisionId: string$1(source.draftRevisionId),
 		flowId: string$1(source.flowId),
 		name: string$1(source.name),
@@ -11068,6 +11107,9 @@ function randomId() {
 }
 //#endregion
 //#region src/control/common/api.ts
+function isRunTerminalEvent(event) {
+	return event?.kind == "run.completed" || event?.kind == "run.failed" || event?.kind == "run.canceled" || event?.kind == "run.indeterminate";
+}
 function decodeRunEvent(value) {
 	const source = record$1(value);
 	const sequence = integer$1(source.sequence);
@@ -11162,7 +11204,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 !== "llm" && nodeKind !== "agent" && nodeKind !== "subflow" && nodeKind !== "value" && nodeKind !== "wait") return invalidResponse();
+					if (nodeKind !== void 0 && nodeKind !== "approval" && nodeKind !== "condition" && nodeKind !== "connector" && nodeKind !== "javascript" && nodeKind !== "openapi" && nodeKind !== "llm" && nodeKind !== "agent" && nodeKind !== "subflow" && nodeKind !== "value" && nodeKind !== "wait") return invalidResponse();
 					return {
 						...base,
 						kind,
@@ -11271,6 +11313,18 @@ var ControlClient = class {
 	constructor(requestControl) {
 		this.requestControl = requestControl;
 	}
+	async loadOpenApiDocument(url, signal) {
+		const result = record$1(await this.request("/v1/openapi/document", {
+			method: "POST",
+			body: JSON.stringify({
+				url,
+				version: 1
+			}),
+			signal
+		}));
+		if (result.version != 1) return invalidResponse();
+		return jsonValue(result.document);
+	}
 	async listFlows(options = {}) {
 		const parameters = new URLSearchParams();
 		if (options.cursor != null) parameters.set("cursor", options.cursor);
@@ -11832,4 +11886,4 @@ var ControlClient = class {
 	}
 };
 //#endregion
-export { ApiError, ControlClient, actionSummary, controlErrorCode, controlErrorMetadata, connectorAccess as decodeConnectorAccess, connectorAccessSnapshot as decodeConnectorAccessSnapshot, decodeEventSource, decodeEventSources, decodeResultList, decodeResultRead, decodeRunEvent, decodeTriggerCatalog, flowInspection, inspectFlowDraft, nodeDetails, parseProviderAccessSource, parseResultQuery, providerAccessBindingId, providerIconAppearance, readResult, searchTriggerKeys };
+export { ApiError, ControlClient, actionSummary, controlErrorCode, controlErrorMetadata, connectorAccess as decodeConnectorAccess, connectorAccessSnapshot as decodeConnectorAccessSnapshot, decodeEventSource, decodeEventSources, decodeResultList, decodeResultRead, decodeRunEvent, decodeTriggerCatalog, flowInspection, inspectFlowDraft, isRunTerminalEvent, nodeDetails, parseProviderAccessSource, parseResultQuery, providerAccessBindingId, providerIconAppearance, readResult, searchTriggerKeys };

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

@@ -7,6 +7,10 @@ export declare const waitActionBodySchema: {
     };
 };
 export declare const controlRequests: {
+    loadOpenApiDocument: (value: unknown) => {
+        url: string;
+        version: 1;
+    };
     createEventSource: (value: unknown) => {
         version: 1;
         name: string;