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

package/dist/common/canvas-commands.d.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export declare const canvasMinZoom = 0.1;
+export declare const canvasMaxZoom = 3;
+/** Transient operations on each connected canvas's own viewport. */
+export declare const canvasCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"focus">;
+    nodeId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"zoom">;
+    zoom: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"pan">;
+    dx: z.ZodNumber;
+    dy: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"fit">;
+}, z.core.$strict>], "type">;
+export type CanvasCommand = z.infer<typeof canvasCommandSchema>;
+export type CanvasCommandSubscriber = (execute: (command: CanvasCommand) => void) => () => void;

package/dist/common/connectorDecoders.d.ts

@@ -1,4 +1,5 @@
-import type { ConnectorAccess, ConnectorAccessSnapshot, ConnectorAccessCandidates, ConnectorAccessCandidatesBatch, ConnectorAction, ConnectorActionMetadata, ConnectorConnection, ConnectorProvider } from './control-api.js';
+import type { ConnectorAccess, ConnectorAccessSnapshot, ConnectorAccessCandidates, ConnectorAccessCandidatesBatch, ConnectorAction, ConnectorActionMetadata, ConnectorConnection, ConnectorProvider, LeinaBot } from './control-api.js';
+export declare function leinaBots(value: unknown): readonly LeinaBot[];
 export declare function connectorAccess(value: unknown): ConnectorAccess;
 export declare function connectorAccessSnapshot(value: unknown): ConnectorAccessSnapshot;
 export declare function connectorAccessCandidates(value: unknown, providerId: string): ConnectorAccessCandidates;

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

@@ -10065,6 +10065,22 @@ function parseProviderAccessSource(value) {
 }
 //#endregion
 //#region src/control/common/connectorDecoders.ts
+function leinaBots(value) {
+	const source = record$1(value);
+	if (!Array.isArray(source.bots)) return invalidResponse("Leina bots: expected an array.");
+	const bots = source.bots.map((entry) => {
+		const bot = record$1(entry);
+		if (!Array.isArray(bot.platforms)) return invalidResponse("Leina platforms: expected an array.");
+		return {
+			leinaId: string(bot.leinaId),
+			name: string(bot.name),
+			status: string(bot.status),
+			platforms: bot.platforms.map(string)
+		};
+	});
+	if (new Set(bots.map((bot) => bot.leinaId)).size != bots.length) return invalidResponse("Leina bots: duplicate identifiers.");
+	return bots;
+}
 function accessPermissions(value) {
 	const source = record$1(value);
 	exact(source, [
@@ -11468,6 +11484,26 @@ var ControlClient = class {
 			method: "POST"
 		}));
 	}
+	async broadcastCanvas(flowId, command) {
+		const source = record$1(await this.request(`/v1/flows/${segment(flowId)}/canvas`, {
+			method: "POST",
+			body: JSON.stringify({
+				version: 1,
+				command
+			})
+		}));
+		exact(source, [
+			"version",
+			"flowId",
+			"broadcast"
+		]);
+		if (source.version != 1 || source.broadcast !== true || source.flowId !== flowId) return invalidResponse();
+		return {
+			version: 1,
+			flowId: string(source.flowId),
+			broadcast: true
+		};
+	}
 	async getFlow(flowId) {
 		return flow(await this.request(`/v1/flows/${segment(flowId)}`));
 	}
@@ -11648,6 +11684,9 @@ var ControlClient = class {
 		const query = connectorProvidersQuery(flowId, locale);
 		return this.connectorRequest(query.path, "providers", signal, query.decode);
 	}
+	async listLeinaBots(flowId, signal) {
+		return leinaBots(await this.request(`/v1/connector/leina/bots?flowId=${segment(flowId)}`, { signal }));
+	}
 	async removeConnectionUsage(flowId, connectionId, expectedRevisionId, expectedAccessRevision, idempotencyKey) {
 		return draftChange(await this.request(`/v1/flows/${segment(flowId)}/connection-usage/remove`, {
 			method: "POST",

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

@@ -1,3 +1,5 @@
+import type { CanvasCommand } from './canvas-commands.js';
+export type { CanvasCommand, CanvasCommandSubscriber } from './canvas-commands.js';
 import type { LiveDetails } from './liveDetails.js';
 export { liveEntries } from './liveDetails.js';
 export type { LiveDetails, LiveEntry } from './liveDetails.js';
@@ -30,6 +32,11 @@ export type { JsonValue, TriggerKeySnapshot, WaitAction } from '../browser/flow-
 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 interface CanvasBroadcast {
+    readonly version: 1;
+    readonly flowId: string;
+    readonly broadcast: true;
+}
 export type ControlRequest = (path: string, init?: RequestInit) => Promise<Response>;
 export interface ErrorListener {
     readonly flowId: string;
@@ -194,6 +201,12 @@ export interface ConnectorProvider extends ProviderIconAppearance {
     readonly serviceName: string;
 }
 export type ConnectorAccessMode = 'implicit' | 'selectable';
+export interface LeinaBot {
+    readonly leinaId: string;
+    readonly name: string;
+    readonly status: string;
+    readonly platforms: readonly string[];
+}
 export type ProviderAccessBindingStatus = 'active' | 'forbidden' | 'invalid' | 'missing';
 export type ProviderAccessBinding = ((ProviderAccessIdentity & {
     readonly status: ProviderAccessBindingStatus;
@@ -791,6 +804,7 @@ export declare class ControlClient {
         readonly idempotencyKey?: string;
     }): Promise<Flow>;
     createFlow(name: string, idempotencyKey?: string, teamId?: string): Promise<Flow>;
+    broadcastCanvas(flowId: string, command: CanvasCommand): Promise<CanvasBroadcast>;
     getFlow(flowId: string): Promise<Flow>;
     getErrorListeners(flowId: string, signal?: AbortSignal): Promise<readonly ErrorListener[]>;
     renameFlow(flowId: string, name: string): Promise<Flow>;
@@ -833,6 +847,7 @@ export declare class ControlClient {
         version: 1;
     }>;
     listConnectorProviders(signal?: AbortSignal, flowId?: string, locale?: string): Promise<readonly ConnectorProvider[]>;
+    listLeinaBots(flowId: string, signal?: AbortSignal): Promise<readonly LeinaBot[]>;
     removeConnectionUsage(flowId: string, connectionId: string, expectedRevisionId: string, expectedAccessRevision: number, idempotencyKey: string): Promise<DraftChange>;
     getConnectorAccess(flowId: string, signal?: AbortSignal): Promise<ConnectorAccess>;
     getPublishedConnectorAccess(flowId: string, publicationId: string, signal?: AbortSignal): Promise<ConnectorAccessSnapshot>;

package/dist/common/control-api.js

@@ -10220,6 +10220,22 @@ async function providerAccessBindingId(teamId, identity) {
 }
 //#endregion
 //#region src/control/common/connectorDecoders.ts
+function leinaBots(value) {
+	const source = record(value);
+	if (!Array.isArray(source.bots)) return invalidResponse("Leina bots: expected an array.");
+	const bots = source.bots.map((entry) => {
+		const bot = record(entry);
+		if (!Array.isArray(bot.platforms)) return invalidResponse("Leina platforms: expected an array.");
+		return {
+			leinaId: string(bot.leinaId),
+			name: string(bot.name),
+			status: string(bot.status),
+			platforms: bot.platforms.map(string)
+		};
+	});
+	if (new Set(bots.map((bot) => bot.leinaId)).size != bots.length) return invalidResponse("Leina bots: duplicate identifiers.");
+	return bots;
+}
 function accessPermissions(value) {
 	const source = record(value);
 	exact(source, [
@@ -10736,6 +10752,12 @@ function resolutionOutputPorts(node) {
 		pending: objectPort({
 			inputs,
 			prompt: { type: "string" },
+			pageUrl: { type: "string" },
+			message: {
+				type: "string",
+				minLength: 1,
+				pattern: "\\S"
+			},
 			...Object.fromEntries(actions.map((action) => [`${action}Url`, { type: "string" }])),
 			expiresAt: { type: "string" }
 		}),
@@ -12124,6 +12146,26 @@ var ControlClient = class {
 			method: "POST"
 		}));
 	}
+	async broadcastCanvas(flowId, command) {
+		const source = record(await this.request(`/v1/flows/${segment(flowId)}/canvas`, {
+			method: "POST",
+			body: JSON.stringify({
+				version: 1,
+				command
+			})
+		}));
+		exact(source, [
+			"version",
+			"flowId",
+			"broadcast"
+		]);
+		if (source.version != 1 || source.broadcast !== true || source.flowId !== flowId) return invalidResponse();
+		return {
+			version: 1,
+			flowId: string(source.flowId),
+			broadcast: true
+		};
+	}
 	async getFlow(flowId) {
 		return flow(await this.request(`/v1/flows/${segment(flowId)}`));
 	}
@@ -12304,6 +12346,9 @@ var ControlClient = class {
 		const query = connectorProvidersQuery(flowId, locale);
 		return this.connectorRequest(query.path, "providers", signal, query.decode);
 	}
+	async listLeinaBots(flowId, signal) {
+		return leinaBots(await this.request(`/v1/connector/leina/bots?flowId=${segment(flowId)}`, { signal }));
+	}
 	async removeConnectionUsage(flowId, connectionId, expectedRevisionId, expectedAccessRevision, idempotencyKey) {
 		return draftChange(await this.request(`/v1/flows/${segment(flowId)}/connection-usage/remove`, {
 			method: "POST",

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

@@ -1,3 +1,4 @@
+export { canvasCommandSchema } from './canvas-commands.js';
 export * from './authoring.js';
 import type { JsonValue } from '../browser/flow-change.js';
 import type { DraftOperation } from './draftOperations.js';
@@ -9,6 +10,22 @@ export declare const waitActionBodySchema: {
     };
 };
 export declare const controlRequests: {
+    canvas: (value: unknown) => {
+        command: {
+            type: "focus";
+            nodeId: string;
+        } | {
+            type: "zoom";
+            zoom: number;
+        } | {
+            type: "pan";
+            dx: number;
+            dy: number;
+        } | {
+            type: "fit";
+        };
+        version: 1;
+    };
     authoringCheck: (value: unknown) => {
         revisionId: string;
     };

package/dist/common/control-requests.js

@@ -5852,6 +5852,23 @@ function preprocess(fn, schema) {
 		out: schema
 	});
 }
+/** Transient operations on each connected canvas's own viewport. */
+var canvasCommandSchema = discriminatedUnion("type", [
+	strictObject({
+		type: literal("focus"),
+		nodeId: string().min(1)
+	}),
+	strictObject({
+		type: literal("zoom"),
+		zoom: number().min(.1).max(3)
+	}),
+	strictObject({
+		type: literal("pan"),
+		dx: number(),
+		dy: number()
+	}),
+	strictObject({ type: literal("fit") })
+]);
 //#endregion
 //#region ../../node_modules/.bun/dequal@2.0.3/node_modules/dequal/lite/index.mjs
 var has = Object.prototype.hasOwnProperty;
@@ -12027,6 +12044,41 @@ function connectorOutputMode(schema) {
 	return properties != null && Object.keys(properties).length > 0 || root?.type == "object" && root.additionalProperties === false ? "fields" : "value";
 }
 //#endregion
+//#region src/flow/common/edgeChanges.ts
+function connect(content, edge) {
+	const selected = content.document.graph;
+	if (selected?.edges.some((candidate) => dequal(candidate, edge))) return [];
+	const changes = [{
+		edge,
+		kind: "graph.edge.connect"
+	}];
+	const source = selected.nodes[edge.source];
+	const target = selected.nodes[edge.target];
+	if (edge.sourceHandle == "pending" && (source?.kind == "approval" || source?.kind == "wait") && target?.kind == "task" && "executor" in target.task && target.task.executor.kind == "connector" && target.task.executor.action == "leina.send_notification" && (target.inputs.message == null || target.inputs.message.kind == "unset")) changes.push({
+		kind: "graph.node.input.set",
+		nodeId: edge.target,
+		handle: "message",
+		before: target.inputs.message,
+		value: {
+			kind: "sources",
+			sources: [{
+				kind: "node",
+				nodeId: edge.source,
+				output: "pending",
+				field: "message"
+			}]
+		}
+	});
+	return changes;
+}
+function disconnect(content, edge) {
+	if (!content.document.graph?.edges.some((candidate) => dequal(candidate, edge))) return [];
+	return [{
+		edge,
+		kind: "graph.edge.disconnect"
+	}];
+}
+//#endregion
 //#region src/trigger/common/contract.ts
 var errorOutputs = [
 	{
@@ -12190,6 +12242,12 @@ function resolutionOutputPorts(node) {
 		pending: objectPort({
 			inputs,
 			prompt: { type: "string" },
+			pageUrl: { type: "string" },
+			message: {
+				type: "string",
+				minLength: 1,
+				pattern: "\\S"
+			},
 			...Object.fromEntries(actions.map((action) => [`${action}Url`, { type: "string" }])),
 			expiresAt: { type: "string" }
 		}),
@@ -13113,6 +13171,7 @@ async function compileAuthoring(base, request, host) {
 	let content = base, index = 0, sequence = 0;
 	const operations = [], aliases = {};
 	const touchedModules = /* @__PURE__ */ new Set();
+	const explicitMessages = /* @__PURE__ */ new Set();
 	function fresh(label) {
 		return host.id(`${index}:${label}:${sequence++}`);
 	}
@@ -13422,6 +13481,7 @@ async function compileAuthoring(base, request, host) {
 		});
 	}
 	async function setInput(ref, input, value) {
+		if (input == "message") explicitMessages.add(ref);
 		const node = nodeAt(content, ref);
 		if (node.kind == "condition") fail("input.unsupported", "Edit the branch condition operands through config.branches.", {
 			node: ref,
@@ -13598,11 +13658,8 @@ async function compileAuthoring(base, request, host) {
 						target: to,
 						...edit.branch == null ? {} : { sourceHandle: edit.branch }
 					};
-					const exists = content.document.graph.edges.some((e) => dequal(e, edge));
-					if (edit.op == "edge.connect" != exists) apply([{
-						kind: edit.op == "edge.connect" ? "graph.edge.connect" : "graph.edge.disconnect",
-						edge
-					}]);
+					const changes = edit.op == "edge.connect" ? connect(content, edge) : disconnect(content, edge);
+					apply(explicitMessages.has(to) ? changes.filter((change) => change.kind != "graph.node.input.set") : changes);
 					break;
 				}
 				case "text.set":
@@ -14012,6 +14069,10 @@ var trigger = strictObject({
 	outputs: record$3(string(), json)
 });
 var schemas = {
+	canvas: strictObject({
+		command: canvasCommandSchema,
+		version
+	}),
 	authoringCheck: authoringCheckSchema,
 	authoringEdit: authoringRequestSchema,
 	authoringRead: authoringReadSchema,
@@ -14123,6 +14184,7 @@ function decoder(schema) {
 	return (value) => schema.parse(value);
 }
 var controlRequests = {
+	canvas: decoder(schemas.canvas),
 	authoringCheck: decoder(schemas.authoringCheck),
 	authoringEdit: decoder(schemas.authoringEdit),
 	authoringRead: decoder(schemas.authoringRead),
@@ -14171,4 +14233,4 @@ function controlRequestSchema(name) {
 	return schema;
 }
 //#endregion
-export { AuthoringError, authoringCheckResponse, authoringCheckSchema, authoringConfigurations, authoringDiagnosticSchema, authoringDiagnostics, authoringEditResponse, authoringEditSchema, authoringExample, authoringExamples, authoringNode, authoringReadResponse, authoringReadSchema, authoringRequestContract, authoringRequestSchema, authoringSchema, authoringSchemaQuery, authoringSearchResponse, authoringSearchSchema, authoringSourceSchema, authoringTypes, compileAuthoring, controlRequestSchema, controlRequests, decodeDraftOperations, draftOperationsSchema, readAuthoring, resolveDraftOperations, searchAuthoring, waitActionBodySchema };
+export { AuthoringError, authoringCheckResponse, authoringCheckSchema, authoringConfigurations, authoringDiagnosticSchema, authoringDiagnostics, authoringEditResponse, authoringEditSchema, authoringExample, authoringExamples, authoringNode, authoringReadResponse, authoringReadSchema, authoringRequestContract, authoringRequestSchema, authoringSchema, authoringSchemaQuery, authoringSearchResponse, authoringSearchSchema, authoringSourceSchema, authoringTypes, canvasCommandSchema, compileAuthoring, controlRequestSchema, controlRequests, decodeDraftOperations, draftOperationsSchema, readAuthoring, resolveDraftOperations, searchAuthoring, waitActionBodySchema };

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

@@ -1,3 +1,4 @@
+import type { CanvasCommand } from '../common/canvas-commands.js';
 export type FlowCatalogEvent = {
     readonly kind: 'flows.changed';
     readonly version: 1;
@@ -7,6 +8,11 @@ export type FlowCatalogEvent = {
     readonly version: 1;
 };
 export type FlowChangeEvent = {
+    readonly kind: 'canvas.command';
+    readonly flowId: string;
+    readonly command: CanvasCommand;
+    readonly version: 1;
+} | {
     readonly accessRevision: number;
     readonly flowId: string;
     readonly kind: 'access.changed';

package/dist/common/flow-semantics.js

@@ -12045,6 +12045,12 @@ function resolutionOutputPorts(node) {
 		pending: objectPort({
 			inputs,
 			prompt: { type: "string" },
+			pageUrl: { type: "string" },
+			message: {
+				type: "string",
+				minLength: 1,
+				pattern: "\\S"
+			},
 			...Object.fromEntries(actions.map((action) => [`${action}Url`, { type: "string" }])),
 			expiresAt: { type: "string" }
 		}),

package/dist/common/mcp.d.ts

@@ -3,6 +3,48 @@ import { z } from 'zod';
 export declare const mcpProtocolVersion = "2026-07-28";
 export declare const mcpInstructions: string;
 export declare const mcpTools: {
+    flow_canvas: {
+        description: string;
+        annotations: {
+            readOnlyHint: boolean;
+            destructiveHint: boolean;
+            idempotentHint: boolean;
+            openWorldHint: boolean;
+        };
+        inputSchema: {
+            '~standard': {
+                version: 1;
+                vendor: string;
+                jsonSchema: {
+                    input: () => Record<string, unknown>;
+                    output: () => Record<string, unknown>;
+                };
+                validate(value: unknown): {
+                    value: {
+                        flowId: string;
+                        command: {
+                            type: "focus";
+                            nodeId: string;
+                        } | {
+                            type: "zoom";
+                            zoom: number;
+                        } | {
+                            type: "pan";
+                            dx: number;
+                            dy: number;
+                        } | {
+                            type: "fit";
+                        };
+                    };
+                } | {
+                    issues: {
+                        message: string;
+                        path: string[];
+                    }[];
+                };
+            };
+        };
+    };
     flow_live: {
         description: string;
         annotations: {