@oomol-lab/open-flow 0.1.0-beta.3 → 0.1.0-beta.30

package/dist/common/trigger-catalog.d.ts

@@ -0,0 +1,17 @@
+import type { TriggerKeySnapshot } from '../browser/flow-change.js';
+import type { UiLanguage } from './localization.js';
+export interface TriggerDisplay {
+    readonly displayName: string;
+    readonly description: string;
+}
+export interface TriggerCatalog {
+    readonly version: 1;
+    readonly locale: UiLanguage;
+    readonly definitions: readonly TriggerKeySnapshot[];
+    readonly display: Readonly<Record<string, TriggerDisplay>>;
+}
+export interface TriggerCatalogCache {
+    readonly data: TriggerCatalog;
+    readonly etag: string | null;
+}
+export declare function decodeTriggerCatalog(value: unknown): TriggerCatalog;

package/dist/common/trigger-config-options.d.ts

@@ -0,0 +1,13 @@
+import type { ConnectorProxy } from './connector-proxy.js';
+import type { JsonValue } from '../browser/flow-change.js';
+export interface TriggerConfigOption {
+    readonly value: string;
+    readonly label: string;
+    readonly color?: string;
+}
+export interface TriggerConfigOptionsContext {
+    readonly field: string;
+    readonly config: Readonly<Record<string, JsonValue>>;
+    readonly connector: ConnectorProxy;
+    readonly signal?: AbortSignal;
+}

package/dist/common/trigger-contract.d.ts

@@ -0,0 +1,5 @@
+import type { JsonValue, Port, PortDefinition, TriggerNode } from '../browser/flow-change.js';
+export declare const webhookOutputs: readonly Port[];
+export declare function triggerOutputDefinitions(trigger: TriggerNode): readonly Port[];
+export declare function triggerOutputPorts(trigger: TriggerNode): Readonly<Record<string, PortDefinition>>;
+export declare function matchesTriggerOutputs(trigger: TriggerNode, outputs: unknown): outputs is Readonly<Record<string, JsonValue>>;

package/dist/common/trigger-localization.d.ts

@@ -0,0 +1,7 @@
+import type { TriggerDisplay } from './trigger-catalog.js';
+import type { TriggerKeySnapshot } from '../browser/flow-change.js';
+import type { UiLanguage } from './localization.js';
+type Translations = Readonly<Record<string, Partial<TriggerDisplay>>>;
+export declare function loadTriggerTranslations(locale: UiLanguage): Promise<Translations>;
+export declare function localizeTrigger(definition: TriggerKeySnapshot, locale: UiLanguage): Promise<TriggerDisplay>;
+export {};

package/dist/common/webhook-trigger.d.ts

@@ -1,15 +1,15 @@
-import type { JsonValue, WebhookInputDefinition, WebhookOptions } from '../browser/flow-change.js';
+import type { JsonValue, WebhookBodyField, WebhookOptions } from '../browser/flow-change.js';
 export declare const maximumWebhookBodyBytes: number;
 export declare function webhookEndpointId(url: URL): string | undefined;
 export declare function webhookOccurrenceId(endpointId: string, runtimeVersion: number, key: string | null): Promise<string | undefined>;
 export interface WebhookConformanceFixture {
-    readonly inputsDef: readonly WebhookInputDefinition[];
+    readonly bodyFields: readonly WebhookBodyField[];
     readonly options?: WebhookOptions;
 }
 export interface WebhookConformanceHarness {
     readonly endpointUrl: string;
     dispose(): Promise<void>;
-    payloads(): Promise<readonly JsonValue[]>;
+    outputs(): Promise<readonly Readonly<Record<string, JsonValue>>[]>;
     republish(): Promise<void>;
     request(request: Request): Promise<Response>;
     retire(): Promise<void>;

package/dist/common/webhook-trigger.js

@@ -27,7 +27,7 @@ async function o(e, t, n) {
 	if (n == null) return `webhook_${crypto.randomUUID().replaceAll("-", "")}`;
 	if (n.trim().length == 0 || n.length > 256) return;
 	let r = JSON.stringify([
-		1,
+		2,
 		"webhook-occurrence",
 		e,
 		t,
@@ -60,7 +60,53 @@ var u = [], d = [{
 	nullable: !1
 }], f = { event: { message: "hello" } }, p = [
 	{
-		fixture: { inputsDef: u },
+		fixture: {
+			bodyFields: d,
+			options: { allowedMethods: ["POST", "PUT"] }
+		},
+		name: "stores complete outputs and compares method query and body for idempotency",
+		async verify(e) {
+			let t = `${e.endpointUrl}?tag=a&tag=b&single=x&__proto__=safe&constructor=value`, n = {
+				url: t,
+				body: JSON.stringify(f),
+				headers: {
+					"Idempotency-Key": "output-contract",
+					"X-Request-ID": "first",
+					"Content-Type": "application/json"
+				}
+			};
+			s((await Promise.all([l(e, n), l(e, n)])).map((e) => e.status), [200, 200], "Concurrent retry statuses");
+			let r = await e.outputs();
+			s(r.length, 1, "One admitted Run");
+			let i = r[0];
+			s(Object.keys(i).toSorted(), [
+				"body",
+				"headers",
+				"query",
+				"webhookUrl"
+			], "Exact output handles"), s(i.body, f, "Body"), s(i.query, JSON.parse("{\"tag\":[\"a\",\"b\"],\"single\":\"x\",\"__proto__\":\"safe\",\"constructor\":\"value\"}"), "Query"), s(i.webhookUrl, e.endpointUrl, "Endpoint without query"), s(i.headers["x-request-id"], "first", "Lowercase headers"), await c(await l(e, {
+				...n,
+				headers: {
+					...n.headers,
+					"X-Request-ID": "retry"
+				}
+			}), { status: 200 }, "Changed header retry"), await c(await l(e, {
+				...n,
+				url: t.replace(new URL(t).host, "retry.example.com")
+			}), { status: 200 }, "Changed request URL host"), s(await e.outputs(), r, "First outputs remain unchanged"), await c(await l(e, {
+				...n,
+				method: "PUT"
+			}), { status: 409 }, "Changed method"), await c(await l(e, {
+				...n,
+				url: `${t}&extra=1`
+			}), { status: 409 }, "Changed query"), await c(await l(e, {
+				...n,
+				body: JSON.stringify({ event: { message: "changed" } })
+			}), { status: 409 }, "Changed body");
+		}
+	},
+	{
+		fixture: { bodyFields: u },
 		name: "rejects malformed and unknown endpoint identities",
 		async verify(e) {
 			let t = new URL(e.endpointUrl);
@@ -76,7 +122,7 @@ var u = [], d = [{
 		}
 	},
 	{
-		fixture: { inputsDef: u },
+		fixture: { bodyFields: u },
 		name: "uses POST by default and decodes an empty body as an empty object",
 		async verify(e) {
 			await c(await l(e, { method: "GET" }), {
@@ -89,12 +135,12 @@ var u = [], d = [{
 				body: "",
 				headers: { "cache-control": "no-store" },
 				status: 200
-			}, "Empty payload"), s(await e.payloads(), [{}], "Decoded empty payloads");
+			}, "Empty payload"), s((await e.outputs()).map((e) => e.body), [{}], "Decoded empty payloads");
 		}
 	},
 	{
 		fixture: {
-			inputsDef: u,
+			bodyFields: u,
 			options: {
 				allowedMethods: ["PUT"],
 				allowedOrigins: ["https://client.example"],
@@ -146,7 +192,7 @@ var u = [], d = [{
 	},
 	{
 		fixture: {
-			inputsDef: u,
+			bodyFields: u,
 			options: {
 				responseData: "<script>globalThis.compromised = true<\/script>",
 				responseHeaders: {
@@ -179,7 +225,7 @@ var u = [], d = [{
 		}
 	},
 	{
-		fixture: { inputsDef: d },
+		fixture: { bodyFields: d },
 		name: "rejects invalid JSON, invalid payloads, invalid idempotency keys, and oversized bodies",
 		async verify(e) {
 			await c(await l(e, { body: "{" }), {
@@ -208,11 +254,11 @@ var u = [], d = [{
 				body: "",
 				headers: { "cache-control": "no-store" },
 				status: 413
-			}, "Oversized body"), s(await e.payloads(), [], "Rejected payloads");
+			}, "Oversized body"), s((await e.outputs()).map((e) => e.body), [], "Rejected payloads");
 		}
 	},
 	{
-		fixture: { inputsDef: d },
+		fixture: { bodyFields: d },
 		name: "replays one idempotent occurrence and rejects conflicting payloads",
 		async verify(e) {
 			let t = { "idempotency-key": "delivery-1" };
@@ -229,19 +275,19 @@ var u = [], d = [{
 				body: "",
 				headers: { "cache-control": "no-store" },
 				status: 409
-			}, "Conflicting delivery"), s(await e.payloads(), [f], "Idempotent payloads");
+			}, "Conflicting delivery"), s((await e.outputs()).map((e) => e.body), [f], "Idempotent payloads");
 		}
 	},
 	{
-		fixture: { inputsDef: d },
+		fixture: { bodyFields: d },
 		name: "admits requests without an idempotency key as separate occurrences",
 		async verify(e) {
 			let t = JSON.stringify(f);
-			await c(await l(e, { body: t }), { status: 200 }, "First unkeyed delivery"), await c(await l(e, { body: t }), { status: 200 }, "Second unkeyed delivery"), s(await e.payloads(), [f, f], "Unkeyed payloads");
+			await c(await l(e, { body: t }), { status: 200 }, "First unkeyed delivery"), await c(await l(e, { body: t }), { status: 200 }, "Second unkeyed delivery"), s((await e.outputs()).map((e) => e.body), [f, f], "Unkeyed payloads");
 		}
 	},
 	{
-		fixture: { inputsDef: d },
+		fixture: { bodyFields: d },
 		name: "scopes occurrence identity to the current runtime version",
 		async verify(e) {
 			let t = JSON.stringify(f), n = { "idempotency-key": "delivery-across-publish" };
@@ -253,23 +299,23 @@ var u = [], d = [{
 			await e.republish(), s(e.endpointUrl, r, "Endpoint after publish"), await c(await l(e, {
 				body: t,
 				headers: n
-			}), { status: 200 }, "Delivery after publish"), s(await e.payloads(), [f, f], "Payloads across publish");
+			}), { status: 200 }, "Delivery after publish"), s((await e.outputs()).map((e) => e.body), [f, f], "Payloads across publish");
 		}
 	},
 	{
-		fixture: { inputsDef: u },
+		fixture: { bodyFields: u },
 		name: "fails closed after its trigger is retired",
 		async verify(e) {
 			await e.retire(), await c(await l(e, { body: "{}" }), {
 				body: "",
 				headers: { "cache-control": "no-store" },
 				status: 404
-			}, "Retired endpoint"), s(await e.payloads(), [], "Payloads after retirement");
+			}, "Retired endpoint"), s((await e.outputs()).map((e) => e.body), [], "Payloads after retirement");
 		}
 	},
 	{
 		fixture: {
-			inputsDef: u,
+			bodyFields: u,
 			options: {
 				responseData: "ignored",
 				responseStatusCode: 204
@@ -285,7 +331,7 @@ var u = [], d = [{
 	},
 	{
 		fixture: {
-			inputsDef: u,
+			bodyFields: u,
 			options: {
 				allowedMethods: ["HEAD"],
 				responseData: "ignored"

package/dist/common/zh-CN-ByQ6nYam.js

@@ -0,0 +1,93 @@
+//#region src/trigger/providers/airtable/locales/zh-CN.json
+var e = { "airtable.on_record_changed": {
+	displayName: "记录创建或更新",
+	description: "轮询 Airtable 表，按时间字段排序，在记录创建或更新时触发。"
+} }, t = { "feishu_app_bot.on_event": {
+	displayName: "应用事件",
+	description: "通过共享事件源接收所选飞书应用事件。"
+} }, n = {
+	"github.on_repo_event": {
+		displayName: "仓库事件",
+		description: "在仓库发生所选 GitHub webhook 事件时触发。"
+	},
+	"github.watch_pull_request": {
+		displayName: "关注拉取请求",
+		description: "通过通知和定期检查关注一个拉取请求。从当前状态开始，报告观察到的变化，不保证每次中间状态转换或评审事件都被报告。"
+	}
+}, r = { "gitlab.on_project_event": {
+	displayName: "项目事件",
+	description: "在项目发生所选 GitLab webhook 事件时触发。"
+} }, i = { "gmail.on_message_received": {
+	displayName: "收到新邮件",
+	description: "轮询 Gmail 邮箱，在收到新邮件时触发。"
+} }, a = { "googlecalendar.on_event_changed": {
+	displayName: "日历事件变更",
+	description: "轮询 Google 日历，在事件创建、更新或取消时触发。"
+} }, o = {
+	"googledrive.changes_detected": {
+		displayName: "检测到变更",
+		description: "使用 Google Drive changes.watch 通道，在有云端硬盘变更可用时触发。"
+	},
+	"googledrive.watch_changes": {
+		displayName: "关注变更",
+		description: "通过通知和对同一变更流的定期扫描监控云端硬盘变更。"
+	},
+	"googledrive.on_file_change": {
+		displayName: "文件夹内的文件或文件夹变更",
+		description: "轮询一个 Google Drive 文件夹，在其直属文件或文件夹创建或更新时触发。"
+	}
+}, s = { "googlesheets.on_row_added": {
+	displayName: "新增行",
+	description: "轮询工作表，在上次已知的末行下方追加新行时，为每个新行触发一次。"
+} }, c = { "linear.on_issue_changed": {
+	displayName: "议题创建或更新",
+	description: "定期检查 Linear 团队中新建和更新的议题。从现在开始，不触发已有议题。报告观察到的当前状态，不报告删除，也不保证涵盖每次中间状态变化。"
+} }, l = { "notion.on_database_page_event": {
+	displayName: "数据库页面新增或更新",
+	description: "轮询 Notion 数据库，在新增页面或编辑现有页面时触发。"
+} }, u = { "one_drive.on_item_changed": {
+	displayName: "文件或文件夹变更",
+	description: "轮询 OneDrive 变更流，在文件或文件夹创建、更新或删除时触发。"
+} }, d = { "outlook.on_message_received": {
+	displayName: "收到新邮件",
+	description: "轮询 Microsoft Outlook 邮件文件夹，在新邮件到达时触发。"
+} }, f = { "shopify.on_shop_event": {
+	displayName: "商店事件",
+	description: "在已连接商店发生所选 Shopify webhook 主题对应的事件时触发。"
+} }, p = { "slack.on_message_posted": {
+	displayName: "频道新消息",
+	description: "轮询一个 Slack 会话，在有新消息发布时触发。"
+} }, m = { "stripe.on_event": {
+	displayName: "账户事件",
+	description: "在已连接账户发生所选 Stripe 事件时触发。"
+} }, h = { "telegram.on_update": {
+	displayName: "机器人更新",
+	description: "在已连接的 Telegram 机器人收到所选更新时触发。"
+} }, g = { "woocommerce.on_store_event": {
+	displayName: "商店事件",
+	description: "在发生所选 WooCommerce 商店事件时触发。"
+} }, _ = { "zendesk.on_event": {
+	displayName: "事件订阅",
+	description: "在发生任一所选 Zendesk 账户事件时触发。"
+} }, v = {
+	...e,
+	...t,
+	...n,
+	...r,
+	...i,
+	...a,
+	...o,
+	...s,
+	...c,
+	...l,
+	...u,
+	...d,
+	...f,
+	...p,
+	...m,
+	...h,
+	...g,
+	..._
+};
+//#endregion
+export { v as default };

package/dist/common/zh-TW-QjIarvX9.js

@@ -0,0 +1,93 @@
+//#region src/trigger/providers/airtable/locales/zh-TW.json
+var e = { "airtable.on_record_changed": {
+	displayName: "記錄建立或更新",
+	description: "輪詢 Airtable 資料表，依時間欄位排序，在記錄建立或更新時觸發。"
+} }, t = { "feishu_app_bot.on_event": {
+	displayName: "應用程式事件",
+	description: "透過共用事件來源接收所選飛書應用程式事件。"
+} }, n = {
+	"github.on_repo_event": {
+		displayName: "儲存庫事件",
+		description: "在儲存庫發生所選 GitHub webhook 事件時觸發。"
+	},
+	"github.watch_pull_request": {
+		displayName: "追蹤提取要求",
+		description: "透過通知與定期檢查追蹤一個提取要求。從目前狀態開始，回報觀察到的變更，不保證涵蓋每次中間狀態轉換或審查事件。"
+	}
+}, r = { "gitlab.on_project_event": {
+	displayName: "專案事件",
+	description: "在專案發生所選 GitLab webhook 事件時觸發。"
+} }, i = { "gmail.on_message_received": {
+	displayName: "收到新郵件",
+	description: "輪詢 Gmail 信箱，在收到新郵件時觸發。"
+} }, a = { "googlecalendar.on_event_changed": {
+	displayName: "日曆事件變更",
+	description: "輪詢 Google 日曆，在事件建立、更新或取消時觸發。"
+} }, o = {
+	"googledrive.changes_detected": {
+		displayName: "偵測到變更",
+		description: "使用 Google Drive changes.watch 通道，在有雲端硬碟變更可用時觸發。"
+	},
+	"googledrive.watch_changes": {
+		displayName: "追蹤變更",
+		description: "透過通知與對同一變更串流的定期掃描監控雲端硬碟變更。"
+	},
+	"googledrive.on_file_change": {
+		displayName: "資料夾內的檔案或資料夾變更",
+		description: "輪詢一個 Google Drive 資料夾，在其直屬檔案或資料夾建立或更新時觸發。"
+	}
+}, s = { "googlesheets.on_row_added": {
+	displayName: "新增列",
+	description: "輪詢工作表，在上次已知的最後一列下方附加新列時，為每個新列觸發一次。"
+} }, c = { "linear.on_issue_changed": {
+	displayName: "議題建立或更新",
+	description: "定期檢查 Linear 團隊中新建與更新的議題。從現在開始，不觸發既有議題。回報觀察到的目前狀態，不回報刪除，也不保證涵蓋每次中間狀態變更。"
+} }, l = { "notion.on_database_page_event": {
+	displayName: "資料庫頁面新增或更新",
+	description: "輪詢 Notion 資料庫，在新增頁面或編輯現有頁面時觸發。"
+} }, u = { "one_drive.on_item_changed": {
+	displayName: "檔案或資料夾變更",
+	description: "輪詢 OneDrive 變更串流，在檔案或資料夾建立、更新或刪除時觸發。"
+} }, d = { "outlook.on_message_received": {
+	displayName: "收到新郵件",
+	description: "輪詢 Microsoft Outlook 郵件資料夾，在新郵件到達時觸發。"
+} }, f = { "shopify.on_shop_event": {
+	displayName: "商店事件",
+	description: "在已連線商店發生所選 Shopify webhook 主題對應的事件時觸發。"
+} }, p = { "slack.on_message_posted": {
+	displayName: "頻道新訊息",
+	description: "輪詢一個 Slack 對話，在有新訊息發布時觸發。"
+} }, m = { "stripe.on_event": {
+	displayName: "帳戶事件",
+	description: "在已連線帳戶發生所選 Stripe 事件時觸發。"
+} }, h = { "telegram.on_update": {
+	displayName: "機器人更新",
+	description: "在已連線的 Telegram 機器人收到所選更新時觸發。"
+} }, g = { "woocommerce.on_store_event": {
+	displayName: "商店事件",
+	description: "在發生所選 WooCommerce 商店事件時觸發。"
+} }, _ = { "zendesk.on_event": {
+	displayName: "事件訂閱",
+	description: "在發生任一所選 Zendesk 帳戶事件時觸發。"
+} }, v = {
+	...e,
+	...t,
+	...n,
+	...r,
+	...i,
+	...a,
+	...o,
+	...s,
+	...c,
+	...l,
+	...u,
+	...d,
+	...f,
+	...p,
+	...m,
+	...h,
+	...g,
+	..._
+};
+//#endregion
+export { v as default };

package/dist/index.d.ts

@@ -48,19 +48,20 @@ export interface TaskLogger {
     warn(message: string, data?: unknown): void;
     error(message: string, data?: unknown): void;
 }
-export interface TaskContext<Outputs extends object = Record<string, unknown>> {
+export interface TaskContext<Actions extends object = Record<string, never>> {
+    readonly actions: Actions;
     readonly signal: AbortSignal;
     readonly flowId: string;
+    readonly inputs: Readonly<Record<string, unknown>>;
     readonly runId: string;
     readonly blockId: string;
     readonly artifact: ArtifactCapability;
     readonly fetch: typeof fetch;
     readonly logger: TaskLogger;
-    output<Handle extends keyof Outputs & string>(handle: Handle, value: Outputs[Handle]): Promise<void>;
     preview(payload: PreviewPayload, id?: string): Promise<void>;
     reportProgress(progress: number): Promise<void>;
 }
-export type TaskResult<Outputs extends object> = Partial<Outputs> | void;
-export interface Task<Inputs extends object = Record<string, unknown>, Outputs extends object = Record<string, unknown>> {
-    (inputs: Inputs, context: TaskContext<Outputs>): TaskResult<Outputs> | Promise<TaskResult<Outputs>>;
+export type TaskResult<Outputs extends object> = keyof Outputs extends never ? Outputs | void : Outputs;
+export interface Task<Inputs extends object = Record<string, unknown>, Outputs extends object = Record<string, unknown>, Actions extends object = Record<string, never>> {
+    (inputs: Inputs, context: TaskContext<Actions>): TaskResult<Outputs> | Promise<TaskResult<Outputs>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oomol-lab/open-flow",
-  "version": "0.1.0-beta.3",
+  "version": "0.1.0-beta.30",
   "description": "TypeScript contracts and Browser runtime for Open Flow.",
   "license": "Apache-2.0",
   "repository": {
@@ -21,6 +21,14 @@
       "types": "./dist/common/connector-proxy.d.ts",
       "import": "./dist/common/connector-proxy.js"
     },
+    "./mcp": {
+      "types": "./dist/common/mcp.d.ts",
+      "import": "./dist/common/mcp.js"
+    },
+    "./control-requests": {
+      "types": "./dist/common/control-requests.d.ts",
+      "import": "./dist/common/control-requests.js"
+    },
     "./control-api": {
       "types": "./dist/common/control-api.d.ts",
       "import": "./dist/common/control-api.js"
@@ -85,10 +93,22 @@
       "types": "./dist/common/webhook-trigger.d.ts",
       "import": "./dist/common/webhook-trigger.js"
     },
+    "./workbench-host-conformance": {
+      "types": "./dist/browser/host-conformance.d.ts",
+      "import": "./dist/browser/host-conformance.js"
+    },
     "./workbench": {
       "types": "./dist/browser/workbench.d.ts",
       "import": "./dist/browser/workbench.js"
     },
+    "./ui": {
+      "types": "./dist/browser/ui.d.ts",
+      "import": "./dist/browser/ui.js"
+    },
+    "./ui.css": {
+      "types": "./dist/browser/ui.css.d.ts",
+      "default": "./dist/browser/ui.css"
+    },
     "./workbench.css": {
       "types": "./dist/browser/workbench.css.d.ts",
       "default": "./dist/browser/workbench.css"