@oomol-lab/open-flow 0.1.0-beta.65 → 0.1.0-beta.67

package/dist/browser/event-sources.d.ts

@@ -1,6 +1,9 @@
 import type { ControlClient, EventSource } from '../common/control-api.js';
 import type { UiLanguage } from '../common/localization.js';
+import type { WorkbenchNotification } from './workbench-contract.js';
 interface Props {
+    /** Host notification channel for operation failures; use the same handler as WorkbenchHost.notify. */
+    readonly notify: (notification: WorkbenchNotification) => void;
     readonly client: Pick<ControlClient, 'listEventSources' | 'createEventSource' | 'updateEventSource' | 'deleteEventSource' | 'listEventSourceConnections' | 'createConnectorConnectionPage'>;
     readonly language: UiLanguage;
     readonly onSourcesChange?: (sources: readonly EventSource[]) => void;
@@ -10,7 +13,7 @@ interface Props {
     }[];
 }
 export declare function EventSourcesPage(props: Props): import("react").JSX.Element;
-export declare function SourceForm({ source, existingNames, fixedTeamId, onPendingChange, client, teams, onSaved, onCancel, }: Omit<Props, 'language'> & {
+export declare function SourceForm({ source, existingNames, fixedTeamId, onPendingChange, client, teams, onSaved, onCancel, notify, }: Omit<Props, 'language'> & {
     readonly source?: EventSource;
     readonly existingNames?: readonly string[];
     readonly onPendingChange?: (pending: boolean) => void;

package/dist/browser/flow-authoring-node.d.ts

@@ -1,5 +1,5 @@
 import type { DecisionQuestion } from '../common/decision.js';
-import type { ChangeOperation, CodeModule, ConnectorCapability, GraphNode, InputMapping, InputValues, InputPort, JsonValue, PortDefinition, RevisionContent, TaskDefinition, TriggerKeySnapshot, TriggerNode, TriggerSchedule, WebhookOptions } from './flow-change.js';
+import type { ChangeOperation, CodeModule, ConnectorCapability, Group, GraphNode, InputMapping, InputValues, InputPort, JsonValue, Port, PortDefinition, RevisionContent, TaskDefinition, TriggerKeySnapshot, TriggerNode, TriggerSchedule, WebhookOptions } from './flow-change.js';
 export declare const defaultCodeTaskPorts: Pick<Extract<TaskDefinition, {
     readonly moduleId: string;
 }>, 'inputs' | 'outputs' | 'capabilities'>;
@@ -14,13 +14,17 @@ export interface LlmTaskOptions {
 }
 export type LlmInputHandle = 'input' | 'messages' | 'model' | 'template';
 export declare function defaultNodeName(_content: RevisionContent, node: GraphNode): string;
-export declare function repairNodeNames(content: RevisionContent): readonly ChangeOperation[];
+export declare function repairNodeNames(content: RevisionContent, defaults?: {
+    readonly start?: string;
+}): readonly ChangeOperation[];
 interface TriggerSettingsBase {
     readonly description?: string;
     readonly name: string;
 }
 export type TriggerSettings = (TriggerSettingsBase & {
     readonly kind: 'manual';
+}) | (TriggerSettingsBase & {
+    readonly kind: 'start';
 }) | (TriggerSettingsBase & {
     readonly kind: 'error';
 }) | (TriggerSettingsBase & {
@@ -69,7 +73,7 @@ export declare function createValue(nodeId: string, name: string, values?: reado
 export declare function createWait(nodeId: string, name: string): readonly ChangeOperation[];
 export declare function createApproval(nodeId: string, name: string): readonly ChangeOperation[];
 export declare function createBuiltinTrigger(nodeId: string, node: Extract<TriggerNode, {
-    readonly kind: 'error' | 'cron' | 'manual' | 'webhook';
+    readonly kind: 'error' | 'cron' | 'manual' | 'start' | 'webhook';
 }>): readonly ChangeOperation[];
 export declare function createProviderTrigger(nodeId: string, definition: TriggerKeySnapshot, options: {
     readonly config: Readonly<Record<string, JsonValue>>;
@@ -89,6 +93,10 @@ export declare function setInputSources(content: RevisionContent, nodeId: string
 export declare function setInputVariable(content: RevisionContent, nodeId: string, handle: string, name: string, bindingId: string): readonly ChangeOperation[] | undefined;
 export declare function cleanVariableBindings(content: RevisionContent, operations: readonly ChangeOperation[]): readonly ChangeOperation[];
 export declare function setConnectorConnection(content: RevisionContent, nodeId: string, connectionId: string | undefined): readonly ChangeOperation[] | undefined;
+/** Update one service’s unresolved or explicitly deferred references as one undoable edit. */
+export declare function setServiceConnections(content: RevisionContent, providerId: string, connectionId: string | undefined, previousConnectionId?: ''): readonly ChangeOperation[];
+/** Edit the workflow input contract and preserve references on a single-field rename. */
+export declare function updateStartInputDefs(content: RevisionContent, nodeId: string, value: readonly Port[]): readonly ChangeOperation[];
 export declare function updateTrigger(content: RevisionContent, nodeId: string, settings: TriggerSettings): readonly ChangeOperation[] | undefined;
 export declare function updateTriggerConfig(content: RevisionContent, nodeId: string, name: string, value: JsonValue | undefined): readonly ChangeOperation[] | undefined;
 export declare function updateTriggerSchedule(content: RevisionContent, nodeId: string, schedule: readonly TriggerSchedule[]): readonly ChangeOperation[] | undefined;
@@ -97,4 +105,7 @@ export declare function setCodeActions(content: RevisionContent, nodeId: string,
 export declare function createDecisionTask(identity: {
     readonly nodeId: string;
 }, name?: string, questions?: readonly DecisionQuestion[]): readonly ChangeOperation[];
+/** Edit an Outputs node's definitions and mappings as one undoable change. */
+export declare function updateOutputsDefs(content: RevisionContent, nodeId: string, value: readonly Port[], outputMappings?: Readonly<Record<string, InputMapping>>): readonly ChangeOperation[];
+export declare function renameFlowOutputSources(content: RevisionContent, nodeIds: ReadonlySet<string>, previous: readonly (Port | Group)[], next: readonly (Port | Group)[]): readonly ChangeOperation[];
 export {};

package/dist/browser/flow-authoring.js

@@ -5822,6 +5822,10 @@ function preprocess(fn, schema) {
 		out: schema
 	});
 }
+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);
+}
 //#endregion
 //#region src/flow/common/triggerScheduleSchema.ts
 var triggerScheduleSchema = array(union([object({
@@ -5849,6 +5853,7 @@ var webhookMethods = [
 	"DELETE"
 ];
 var text = string();
+var actionConnection = text.describe("Account selection: omit while unconfigured; use an account ID to select it; use \"\" to explicitly defer configuration. Deferred Actions fail if called; deferred Agent tools are excluded from the callable tool set. Not supported by Triggers.");
 var json = json$1();
 var strings = array(text);
 var port = object({
@@ -5857,6 +5862,7 @@ var port = object({
 	nullable: boolean(),
 	handle: text
 });
+var workflowInputDefs = array(port.strict());
 var input = port.extend({ value: json.optional() });
 var group = object({
 	collapsed: boolean().optional(),
@@ -5903,7 +5909,7 @@ var capability = union([
 		mode: literal("independent"),
 		actions: array(strictObject({
 			action: text,
-			connectionId: text.optional()
+			connectionId: actionConnection.optional()
 		}))
 	}),
 	strictObject({
@@ -5963,7 +5969,7 @@ var managedFields = object({
 		object({
 			kind: literal("connector"),
 			action: text,
-			connectionId: text.optional(),
+			connectionId: actionConnection.optional(),
 			outputMode: literal("value").optional()
 		}),
 		object({
@@ -6003,17 +6009,22 @@ var managedFields = object({
 				name: text,
 				description: text,
 				action: text,
-				connectionId: text.optional(),
+				connectionId: actionConnection.optional(),
 				approval: boolean(),
 				inputs: array(input.extend({ source: agentInput }))
 			})),
 			notification: object({
 				action: text,
-				connectionId: text.optional(),
+				connectionId: actionConnection.optional(),
 				inputDefinitions: array(input),
 				messageHandle: text,
 				inputs: record$1(text, agentValue)
 			}).optional()
+		}),
+		strictObject({
+			kind: literal("workflow"),
+			flowId: text,
+			revisionId: text
 		})
 	])
 });
@@ -6122,6 +6133,12 @@ var base = {
 	timeoutMs: number().optional()
 };
 var node = union([
+	strictObject({
+		...base,
+		kind: literal("outputs"),
+		outputDefs: array(port.strict()),
+		outputMappings: inputs
+	}).omit({ inputs: true }),
 	object({
 		...base,
 		inputs: record$1(text, never()),
@@ -6154,6 +6171,11 @@ var node = union([
 		...trigger,
 		kind: literal("manual")
 	}),
+	strictObject({
+		...trigger,
+		kind: literal("start"),
+		inputDefs: workflowInputDefs
+	}),
 	strictObject({
 		...trigger,
 		kind: literal("error"),
@@ -6218,35 +6240,51 @@ var module = object({
 	imports: strings,
 	source: text
 });
-var document = preprocess(rejectRetiredDefinitions, object({
+var document = preprocess(normalizeDocument, object({
 	bindings: record$1(text, binding),
 	graph
 }));
-object({
+var revision = object({
 	modelVersion: union([
 		literal(2),
 		literal(4),
 		literal(5),
-		literal(6)
+		literal(6),
+		literal(7),
+		literal(8)
 	]),
 	document,
 	modules: record$1(text, module)
-}).extend({
+});
+revision.extend({
 	kind: literal("open-flow-flow-revision"),
 	version: literal(1)
 });
-function rejectRetiredDefinitions(value) {
+function normalizeDocument(value) {
 	const candidate = record(value);
 	if (candidate.tasks !== void 0 && (candidate.tasks === null || typeof candidate.tasks !== "object" || Array.isArray(candidate.tasks) || Object.keys(candidate.tasks).length > 0)) throw new TypeError("Independent Task definitions are no longer supported.");
 	if (Object.values(record(record(candidate.graph).nodes)).some((candidateNode) => Object.hasOwn(record(candidateNode), "taskId"))) throw new TypeError("Task references are no longer supported.");
 	const subflows = candidate.subflows;
 	if (subflows !== void 0 && (subflows === null || typeof subflows !== "object" || Array.isArray(subflows) || Object.keys(subflows).length > 0)) throw new TypeError("Subflows are no longer supported.");
 	if (Object.values(record(record(candidate.graph).nodes)).some((candidateNode) => record(candidateNode).kind === "subflow")) throw new TypeError("Subflow nodes are no longer supported.");
+	if ([
+		"inputDefs",
+		"outputDefs",
+		"outputMappings"
+	].some((field) => Object.hasOwn(candidate, field))) throw new TypeError("Workflow interface configuration must belong to Start and Outputs nodes.");
+	if (Object.values(record(record(candidate.graph).nodes)).some((candidateNode) => record(candidateNode).kind == "start" && Object.hasOwn(record(candidateNode), "parameters"))) throw new TypeError("Legacy Start.parameters is unsupported; configure node.inputDefs.");
 	return value;
 }
 function record(value) {
 	return value != null && typeof value == "object" && !Array.isArray(value) ? value : {};
 }
+function decodeRevisionContent(value) {
+	checkJsonDepth(value);
+	const content = revision.parse(value);
+	checkModelVersion(content);
+	assertOpenApiAuthBindings(content.document);
+	return content;
+}
 var shapes = {
 	"graph.trigger.sources.set": {
 		nodeId: text,
@@ -6399,6 +6437,12 @@ array(union([...new Map(Object.entries(shapes).map(([kind, shape]) => [kind, sha
 	kind: literal(kind),
 	...shape
 })])).values()])).min(1);
+function checkModelVersion(content) {
+	if (content.modelVersion < 8 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "outputs")) throw new TypeError("Workflow outputs require Flow model version 8.");
+	if (content.modelVersion < 7 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "start")) throw new TypeError("Start Triggers require Flow model version 7.");
+	if (content.modelVersion < 6 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind == "task" && "executor" in candidateNode.task)) throw new TypeError("Node-owned managed Tasks require Flow model version 6.");
+	if (content.modelVersion < 5 && Object.values(content.document.graph.nodes).some((itemNode) => itemNode.kind == "error")) throw new TypeError("Error workflows require Flow model version 5.");
+}
 //#endregion
 //#region src/flow/common/condition.ts
 var unaryOperator = (operator) => operator.startsWith("is");
@@ -6418,6 +6462,7 @@ function conditionOperands(node) {
 	}] : []])));
 }
 function nodeInputMappings(node) {
+	if (node.kind == "outputs") return node.outputMappings;
 	if (node.kind != "condition") return "inputs" in node ? node.inputs : {};
 	return Object.fromEntries(conditionOperands(node).flatMap(({ handle, operand }) => operand.kind == "source" ? [[handle, {
 		kind: "sources",
@@ -6477,7 +6522,7 @@ function decodeConnectorCapabilities(value) {
 		const actions = source.actions.map((entry) => {
 			if (entry == null || typeof entry != "object" || Array.isArray(entry)) throw new TypeError("Invalid Connector Action.");
 			const action = entry;
-			if (Object.keys(action).some((key) => !["action", "connectionId"].includes(key)) || typeof action.action != "string" || !/^[A-Za-z0-9_-]+\.[A-Za-z0-9_.-]+$/.test(action.action) || Object.hasOwn(action, "connectionId") && (typeof action.connectionId != "string" || action.connectionId.length == 0)) throw new TypeError("Invalid Connector Action permission.");
+			if (Object.keys(action).some((key) => !["action", "connectionId"].includes(key)) || typeof action.action != "string" || !/^[A-Za-z0-9_-]+\.[A-Za-z0-9_.-]+$/.test(action.action) || Object.hasOwn(action, "connectionId") && typeof action.connectionId != "string") throw new TypeError("Invalid Connector Action permission.");
 			return action.connectionId == null ? { action: action.action } : {
 				action: action.action,
 				connectionId: action.connectionId
@@ -6569,6 +6614,40 @@ function decodeConnectorCapabilities(value) {
 		};
 	});
 }
+function isTriggerNode(node) {
+	return [
+		"manual",
+		"start",
+		"error",
+		"webhook",
+		"cron",
+		"poll",
+		"integration"
+	].includes(node.kind);
+}
+function upgradeDecodedRevisionContent(content) {
+	const graph = content.document.graph;
+	const hasManual = Object.values(graph.nodes).some((node) => node.kind == "manual");
+	if (!hasManual && content.modelVersion == 8) return content;
+	return {
+		...content,
+		modelVersion: 8,
+		document: {
+			...content.document,
+			graph: hasManual ? {
+				...graph,
+				nodes: Object.fromEntries(Object.entries(graph.nodes).map(([id, node]) => [id, upgradeManualTrigger(node)]))
+			} : graph
+		}
+	};
+}
+function upgradeManualTrigger(node) {
+	return node.kind == "manual" ? {
+		...node,
+		kind: "start",
+		inputDefs: []
+	} : node;
+}
 function normalizeNodeName(value) {
 	return value.trim().normalize("NFC");
 }
@@ -6587,8 +6666,9 @@ function invalid(message) {
 	throw new FlowChangeError(message);
 }
 function applyFlowChanges(content, operations) {
-	const document = { ...content.document };
-	const modules = { ...content.modules };
+	const source = content.modelVersion != 8 || Object.values(content.document.graph.nodes).some((node) => node.kind == "manual") ? decodeRevisionContent(content) : content;
+	const document = { ...source.document };
+	const modules = { ...source.modules };
 	for (const operation of operations) switch (operation.kind) {
 		case "graph.trigger.sources.set": {
 			const graph = document.graph;
@@ -6639,8 +6719,9 @@ function applyFlowChanges(content, operations) {
 		case "graph.edge.connect": {
 			const graph = document.graph;
 			if (graph.nodes[operation.edge.source] == null) invalid("The source Node does not exist.");
+			if (graph.nodes[operation.edge.source]?.kind == "outputs") invalid("Outputs cannot have downstream execution edges.");
 			const node = graph.nodes[operation.edge.target];
-			if (node == null || !("inputs" in node)) invalid("The target Node does not accept execution dependencies.");
+			if (node == null || isTriggerNode(node)) invalid("The target Node does not accept execution dependencies.");
 			if (graph.edges.some((edge) => dequal(edge, operation.edge))) invalid("The Nodes are already connected.");
 			Object.assign(document, { graph: {
 				...graph,
@@ -6720,9 +6801,10 @@ function applyFlowChanges(content, operations) {
 			const graph = document.graph;
 			if (graph.nodes[operation.nodeId] != null) invalid("A Node with this ID already exists in the target graph.");
 			if (operation.node.kind == "error" && Object.values(graph.nodes).some((node) => node.kind == "error")) invalid("A graph can contain only one Flow Error node.");
-			if (operation.node.kind == "manual" && Object.values(graph.nodes).some((node) => node.kind == "manual")) invalid("A graph can contain only one manual Trigger.");
+			if ((operation.node.kind == "manual" || operation.node.kind == "start") && Object.values(graph.nodes).some((node) => node.kind == "manual" || node.kind == "start")) invalid("A graph can contain only one Start Trigger.");
 			if (operation.node.kind == "task" && "moduleId" in operation.node.task && operation.node.task.capabilities !== void 0) decodeConnectorCapabilities(operation.node.task.capabilities);
 			if (operation.node.name == null) invalid("A Node name cannot be empty.");
+			if (operation.node.kind == "outputs" && Object.values(graph.nodes).some((node) => node.kind == "outputs")) invalid("A graph can contain only one Outputs node.");
 			const name = normalizeNodeName(operation.node.name);
 			const issue = nodeNameIssue(graph, operation.nodeId, name);
 			if (issue == "empty") invalid("A Node name cannot be empty.");
@@ -6780,11 +6862,24 @@ function applyFlowChanges(content, operations) {
 		case "graph.node.input.set": {
 			const graph = document.graph;
 			const node = graph.nodes[operation.nodeId];
-			if (node == null || !("inputs" in node)) invalid("The Node does not accept inputs.");
+			if (node == null || isTriggerNode(node)) invalid("The Node does not accept inputs.");
 			if (!dequal(nodeInputMappings(node)[operation.handle], operation.before)) invalid("The Node input changed before this operation was applied.");
-			const inputs = { ...node.inputs };
+			const inputs = { ...nodeInputMappings(node) };
 			if (operation.value == null) delete inputs[operation.handle];
 			else inputs[operation.handle] = operation.value;
+			if (node.kind == "outputs") {
+				document.graph = {
+					...graph,
+					nodes: {
+						...graph.nodes,
+						[operation.nodeId]: {
+							...node,
+							outputMappings: inputs
+						}
+					}
+				};
+				break;
+			}
 			Object.assign(document, { graph: {
 				...graph,
 				nodes: {
@@ -7012,11 +7107,11 @@ function applyFlowChanges(content, operations) {
 		}
 	}
 	assertOpenApiAuthBindings(document);
-	return {
+	return upgradeDecodedRevisionContent({
 		document,
-		modelVersion: 6,
+		modelVersion: 8,
 		modules
-	};
+	});
 }
 //#endregion
 //#region src/json-schema-subset/utils.ts
@@ -10136,7 +10231,7 @@ function deleteNodes(content, nodeIds) {
 }
 function updateSettings(content, nodeId, settings) {
 	const node = content.document.graph?.nodes[nodeId];
-	if (node == null || !("inputs" in node)) return;
+	if (node == null || isTriggerNode(node)) return;
 	const operations = [];
 	if (node.name != settings.name) operations.push({
 		before: node.name,
@@ -10163,7 +10258,7 @@ function updateSettings(content, nodeId, settings) {
 }
 function setInputValues(content, nodeId, values) {
 	const node = content.document.graph?.nodes[nodeId];
-	if (node == null || !("inputs" in node)) return;
+	if (node == null || isTriggerNode(node)) return;
 	const operations = [];
 	for (const [handle, value] of Object.entries(values)) {
 		const before = nodeInputMappings(node)[handle];
@@ -10181,7 +10276,7 @@ function setInputValues(content, nodeId, values) {
 }
 function setInputSources(content, nodeId, handle, sources) {
 	const node = content.document.graph?.nodes[nodeId];
-	if (node == null || !("inputs" in node)) return [];
+	if (node == null || isTriggerNode(node)) return [];
 	return cleanVariableBindings(content, [{
 		kind: "graph.node.input.set",
 		nodeId,
@@ -10195,7 +10290,7 @@ function setInputSources(content, nodeId, handle, sources) {
 }
 function setInputVariable(content, nodeId, handle, name, bindingId) {
 	const node = content.document.graph?.nodes[nodeId];
-	if (node == null || !("inputs" in node)) return;
+	if (node == null || isTriggerNode(node)) return;
 	const mapping = nodeInputMappings(node)[handle];
 	const currentId = mapping?.kind == "sources" && mapping.sources.length == 1 && mapping.sources[0]?.kind == "binding" ? mapping.sources[0].bindingId : void 0;
 	const current = currentId == null ? void 0 : content.document.bindings[currentId];
@@ -10245,7 +10340,7 @@ function bindingReferences(document) {
 		references.set(bindingId, (references.get(bindingId) ?? 0) + 1);
 	};
 	for (const node of Object.values(document.graph.nodes)) {
-		if (!("inputs" in node)) continue;
+		if (isTriggerNode(node)) continue;
 		const inputs = Object.values(nodeInputMappings(node));
 		for (const mapping of inputs) {
 			if (mapping.kind != "sources") continue;
@@ -10293,6 +10388,7 @@ function updateTrigger(content, nodeId, settings) {
 		value: settings.description
 	});
 	switch (settings.kind) {
+		case "start":
 		case "error":
 		case "manual":
 			if (trigger.kind != settings.kind) return;

package/dist/browser/flow-change-schema.d.ts

@@ -1,6 +1,6 @@
 import type { ChangeOperation, FlowDocument, JsonValue, RevisionContent } from './flow-change.js';
 import { z } from 'zod';
-export declare const currentFlowModelVersion = 6;
+export declare const currentFlowModelVersion = 8;
 /** Configuration schemas shared by the node authoring boundary. */
 export declare const authoringDefinitionSchemas: {
     input: z.ZodObject<{
@@ -267,6 +267,8 @@ export declare const authoringDefinitionSchemas: {
         }, z.core.$strip>>;
     }, z.core.$strict>;
 };
+/** Explicit storage upgrade only. Normal reads and authoring still reject retired fields. */
+export declare function upgradeWorkflowInterfaceDocument(value: unknown): unknown;
 /** Best-effort recovery for a parseable Revision envelope. Invalid collection entries are discarded. */
 export declare function repairRevisionEnvelope(value: unknown): RevisionContent;
 export declare function decodeFlowDocument(value: unknown): FlowDocument;

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

@@ -108,7 +108,7 @@ export interface ConditionNode extends GraphNodeBase {
     readonly matchMode: 'first' | 'all';
     readonly kind: 'condition';
 }
-export type ManagedTaskExecutor = import('../common/decision.js').DecisionExecutor | import('../common/openapi.js').OpenApiExecutor | {
+export type ManagedTaskExecutor = import('../common/workflow.js').WorkflowExecutor | import('../common/decision.js').DecisionExecutor | import('../common/openapi.js').OpenApiExecutor | {
     readonly kind: 'connector';
     readonly action: string;
     readonly connectionId?: string;
@@ -257,6 +257,9 @@ interface TriggerNodeBase {
 }
 export type TriggerNode = (TriggerNodeBase & {
     readonly kind: 'manual';
+}) | (TriggerNodeBase & {
+    readonly kind: 'start';
+    readonly inputDefs: readonly Port[];
 }) | (TriggerNodeBase & {
     readonly kind: 'error';
     readonly sourceFlowIds?: readonly string[];
@@ -284,7 +287,13 @@ export type TriggerNode = (TriggerNodeBase & {
     };
     readonly kind: 'integration';
 });
-export type GraphNode = ApprovalNode | ConditionNode | TaskNode | TriggerNode | ValueNode | WaitNode;
+export interface OutputsNode extends Omit<GraphNodeBase, 'inputs'> {
+    readonly kind: 'outputs';
+    readonly outputDefs: readonly Port[];
+    readonly outputMappings: Readonly<Record<string, InputMapping>>;
+}
+export declare function isTriggerNode(node: GraphNode): node is TriggerNode;
+export type GraphNode = OutputsNode | ApprovalNode | ConditionNode | TaskNode | TriggerNode | ValueNode | WaitNode;
 export interface FlowDocument {
     readonly bindings: Readonly<Record<string, {
         readonly kind: 'variable';
@@ -299,7 +308,7 @@ export interface CodeModule {
 }
 export interface RevisionContent {
     readonly document: FlowDocument;
-    readonly modelVersion: 2 | 4 | 5 | typeof currentFlowModelVersion;
+    readonly modelVersion: 2 | 4 | 5 | 6 | 7 | typeof currentFlowModelVersion;
     readonly modules: Readonly<Record<string, CodeModule>>;
 }
 export interface GraphEdge {
@@ -307,6 +316,9 @@ export interface GraphEdge {
     readonly sourceHandle?: string;
     readonly target: string;
 }
+/** Lossless upgrade of readable content. Historical content and its encoding stay unchanged. */
+export declare function upgradeRevisionContent(content: RevisionContent): RevisionContent;
+export declare function upgradeManualTrigger(node: GraphNode): GraphNode;
 export declare function normalizeNodeName(value: string): string;
 export declare function nextNodeName(value: string, names: Iterable<string>): string;
 export declare function nodeNameIssue(graph: Graph, nodeId: string, value: string): 'duplicate' | 'empty' | undefined;