@oomol-lab/open-flow 0.1.0-beta.84 → 0.1.0-beta.86

package/dist/common/control-api.js

@@ -1,6 +1,6 @@
 //#region src/runtime/common/engineContract.ts
-/** v10 adds persistent Flow State to the published v9 Node compatibility and fetch contract. */
-var currentEngineContract = "open-flow-engine/v10";
+/** v11 adds Provider API requests through Connector Proxy. */
+var currentEngineContract = "open-flow-engine/v11";
 /** 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)}
@@ -50,13 +50,19 @@ var v9Contract = {
 	codeFetch: true,
 	platformSource: platformSource("open-flow-engine/v9")
 };
-var currentContract = {
+var v10Contract = {
 	...v9Contract,
 	flowState: true,
+	platformSource: platformSource("open-flow-engine/v10")
+};
+var currentContract = {
+	...v10Contract,
+	connectorProxy: true,
 	platformSource: platformSource(currentEngineContract)
 };
 function findEngineContract(contract) {
-	if (contract == "open-flow-engine/v10") return currentContract;
+	if (contract == "open-flow-engine/v11") return currentContract;
+	if (contract == "open-flow-engine/v10") return v10Contract;
 	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;
@@ -76,7 +82,7 @@ function findEngineContract(contract) {
 	};
 }
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/core/util.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/core/util.js
 function getEnumValues(entries) {
 	const numericValues = Object.values(entries).filter((v) => typeof v === "number");
 	return Object.entries(entries).filter(([k, _]) => numericValues.indexOf(+k) === -1).map(([_, v]) => v);
@@ -401,6 +407,17 @@ function prefixIssues(path, issues) {
 function unwrapMessage(message) {
 	return typeof message === "string" ? message : message?.message;
 }
+/** The leading size checks of `defChecks` that set an upper bound, each paired with it. */
+function sizeCaps(defChecks) {
+	const caps = [];
+	for (const ch of defChecks ?? []) {
+		const d = ch._zod.def;
+		if (!/_(length|size)$|_equals$/.test(d.check)) break;
+		const max = d.maximum ?? d.length ?? d.size;
+		if (max >= 0) caps.push([max, ch]);
+	}
+	return caps;
+}
 function attachSchema(issues, start, inst) {
 	var _a;
 	for (let i = start; i < issues.length; i++) (_a = issues[i]).schema ?? (_a.schema = inst);
@@ -617,7 +634,7 @@ function constantCatch(value) {
 	return fn;
 }
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/core/core.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/core/core.js
 var _a$1;
 var _zodDesc = {
 	value: void 0,
@@ -723,7 +740,7 @@ function config(newConfig) {
 	return globalConfig;
 }
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/core/errors.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/core/errors.js
 function _getMessage() {
 	const internals = this._zod;
 	internals.message ?? (internals.message = JSON.stringify(internals.def, jsonStringifyReplacer, 2));
@@ -839,7 +856,7 @@ function formatError(error, mapper = (issue) => issue.message) {
 	return fieldErrors;
 }
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/core/parse.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/core/parse.js
 function finalizeParams(callee, params) {
 	return {
 		callee: params?.callee ?? callee,
@@ -1042,7 +1059,7 @@ var _safeDecodeAsync = (_Err) => async (schema, value, _ctx) => {
 	return _safeParseAsync(_Err)(schema, value, _ctx);
 };
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/core/regexes.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/core/regexes.js
 /**
 * @deprecated CUID v1 is deprecated by its authors due to information leakage
 * (timestamps embedded in the id). Use {@link cuid2} instead.
@@ -1115,7 +1132,7 @@ var _null$2 = /^null$/i;
 var lowercase = /^[^A-Z]*$/;
 var uppercase = /^[^a-z]*$/;
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/core/checks.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/core/checks.js
 var $ZodCheck = /*@__PURE__*/ $constructor("$ZodCheck", (inst, def) => {
 	var _a;
 	inst._zod ?? (inst._zod = {});
@@ -1411,7 +1428,7 @@ var $ZodCheckOverwrite = /*@__PURE__*/ $constructor("$ZodCheckOverwrite", (inst,
 	};
 });
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/core/doc.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/core/doc.js
 var Doc = class {
 	constructor(args = [], closed = {}) {
 		this.content = [];
@@ -1445,14 +1462,14 @@ var Doc = class {
 	}
 };
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/core/versions.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/core/versions.js
 var version = {
 	major: 4,
 	minor: 6,
-	patch: 5
+	patch: 7
 };
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/core/schemas.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/core/schemas.js
 var $ZodType = /*@__PURE__*/ $constructor("$ZodType", (inst, def) => {
 	var _a;
 	inst ?? (inst = {});
@@ -1965,6 +1982,26 @@ var $ZodNever = /*@__PURE__*/ $constructor("$ZodNever", (inst, def) => {
 		return payload;
 	};
 });
+function capSize(inst, size) {
+	const caps = sizeCaps(inst._zod.def.checks);
+	if (!caps.length) return;
+	const cap = Math.min(...caps.map((c) => c[0]));
+	const parse = inst._zod.parse;
+	inst._zod.parse = (payload, ctx) => {
+		const n = size(payload.value);
+		if (n > cap && !ctx?.skipChecks && ctx?.direction !== "backward") {
+			for (const [max, ch] of sizeCaps(inst._zod.def.checks)) if (n > max && ch._zod.def.when(payload)) {
+				const start = payload.issues.length;
+				ch._zod.check(payload);
+				payload.issues[start].continue = false;
+				attachSchema(payload.issues, start, inst);
+				return payload;
+			}
+		}
+		return parse(payload, ctx);
+	};
+}
+var arraySize = (input) => Array.isArray(input) ? input.length : -1;
 function handleArrayResult(result, final, index) {
 	if (result.issues.length) final.issues.push(...prefixIssues(index, result.issues));
 	final.value[index] = result.value;
@@ -2002,6 +2039,7 @@ var $ZodArray = /*@__PURE__*/ $constructor("$ZodArray", (inst, def) => {
 		if (proms.length) return Promise.all(proms).then(() => payload);
 		return payload;
 	};
+	capSize(inst, arraySize);
 });
 function handlePropertyResult(result, final, key, input, optin, optout) {
 	const isPresent = key in input;
@@ -2920,7 +2958,7 @@ function handleRefineResult(result, payload, input, inst) {
 	}
 }
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/core/memoizer.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/core/memoizer.js
 var $ZodCyclicError = class extends Error {
 	constructor() {
 		super(`Cannot parse a reference cycle that closes through a transform`);
@@ -3173,7 +3211,7 @@ function isBackEdge(ctx, value) {
 	return backEdges !== void 0 && isRef(value) && backEdges.has(value);
 }
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/locales/en.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/locales/en.js
 var error = () => {
 	const Sizable = {
 		string: {
@@ -3281,7 +3319,7 @@ function en_default() {
 	return { localeError: error() };
 }
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/core/registries.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/core/registries.js
 var _a;
 var $ZodRegistry = class {
 	constructor() {
@@ -3328,7 +3366,7 @@ function registry() {
 (_a = globalThis).__zod_globalRegistry ?? (_a.__zod_globalRegistry = registry());
 var globalRegistry = globalThis.__zod_globalRegistry;
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/core/api.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/core/api.js
 function snapshotChecks(def) {
 	if (def.checks) def.checks = [...def.checks];
 	return def;
@@ -3844,7 +3882,7 @@ function _check(fn, params) {
 	return ch;
 }
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/core/to-json-schema.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/core/to-json-schema.js
 function assignProps(target, ...sources) {
 	for (const source of sources) for (const key of Reflect.ownKeys(source)) if (Object.prototype.propertyIsEnumerable.call(source, key)) assignProp(target, key, source[key]);
 	return target;
@@ -4288,7 +4326,7 @@ var createStandardJSONSchemaMethod = (schema, io, processors = {}) => (params) =
 	return finalize(ctx, schema);
 };
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/core/json-schema-processors.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/core/json-schema-processors.js
 var narrowMin = (agg, key, value) => {
 	if (agg[key] === void 0 || value > agg[key]) agg[key] = value;
 };
@@ -4749,7 +4787,7 @@ var lazyProcessor = (schema, ctx, _json, params) => {
 	seen.ref = innerType;
 };
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/classic/errors.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/classic/errors.js
 var _installedErrorProtos = /* @__PURE__ */ new WeakSet([Object.prototype, Error.prototype]);
 function _lazyMethod(proto, key, make) {
 	Object.defineProperty(proto, key, {
@@ -4799,7 +4837,7 @@ var initializer = (inst, issues) => {
 };
 var ZodRealError = /*@__PURE__*/ $constructor("ZodError", initializer, void 0, { Parent: Error });
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/classic/parse.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/classic/parse.js
 var parse = /* @__PURE__ */ _parse(ZodRealError);
 var parseAsync = /* @__PURE__ */ _parseAsync(ZodRealError);
 var safeParse = /* @__PURE__ */ _safeParse(ZodRealError);
@@ -4813,7 +4851,7 @@ var safeDecode = /* @__PURE__ */ _safeDecode(ZodRealError);
 var safeEncodeAsync = /* @__PURE__ */ _safeEncodeAsync(ZodRealError);
 var safeDecodeAsync = /* @__PURE__ */ _safeDecodeAsync(ZodRealError);
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/classic/schemas.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/classic/schemas.js
 function _ensureDefaultLocale() {
 	if (!globalConfig.localeError) config(en_default());
 }
@@ -5745,7 +5783,7 @@ function preprocess(fn, schema) {
 	});
 }
 //#endregion
-//#region ../../node_modules/.bun/zod@4.6.5/node_modules/zod/v4/classic/iso.js
+//#region ../../node_modules/.bun/zod@4.6.7/node_modules/zod/v4/classic/iso.js
 function datetime(params) {
 	return /* @__PURE__ */ _isoDateTime(ZodISODateTime, params);
 }
@@ -8691,6 +8729,35 @@ function webhookSupportsBody(method) {
 	return method !== "GET";
 }
 //#endregion
+//#region src/flow/common/requestParameters.ts
+var requestParameterSchema = strictObject({
+	mode: _enum(["fields", "object"]).default("fields"),
+	names: array(string$1()).default([])
+});
+//#endregion
+//#region src/connector/common/proxy.ts
+var connectorProxyConfigSchema = strictObject({
+	providerId: string$1().min(1),
+	connectionId: string$1().optional(),
+	method: _enum([
+		"GET",
+		"POST",
+		"PUT",
+		"PATCH",
+		"DELETE"
+	]).default("GET"),
+	query: requestParameterSchema.default({
+		mode: "fields",
+		names: []
+	}),
+	headers: requestParameterSchema.default({
+		mode: "fields",
+		names: []
+	}),
+	bodyFormat: _enum(["none", "json"]).default("none")
+});
+var connectorProxyExecutorSchema = connectorProxyConfigSchema.extend({ kind: literal("connector-proxy") });
+//#endregion
 //#region src/decision/common/decision.ts
 function isDecisionExecutor(executor) {
 	return executor.kind === "decision";
@@ -8799,10 +8866,6 @@ function isHttpHost(value) {
 }
 //#endregion
 //#region src/http/common/httpRequest.ts
-var parameterSchema = strictObject({
-	mode: _enum(["fields", "object"]).default("fields"),
-	names: array(string$1()).default([])
-});
 var httpRequestConfigSchema = strictObject({
 	method: _enum([
 		"GET",
@@ -8813,11 +8876,11 @@ var httpRequestConfigSchema = strictObject({
 		"HEAD",
 		"OPTIONS"
 	]).default("GET"),
-	query: parameterSchema.default({
+	query: requestParameterSchema.default({
 		mode: "fields",
 		names: []
 	}),
-	headers: parameterSchema.default({
+	headers: requestParameterSchema.default({
 		mode: "fields",
 		names: []
 	}),
@@ -9141,7 +9204,8 @@ var managedFields = object({
 			revisionId: text
 		}),
 		httpRequestExecutorSchema,
-		skipDuplicatesExecutorSchema
+		skipDuplicatesExecutorSchema,
+		connectorProxyExecutorSchema
 	])
 });
 var managed = managedFields.transform(limitDecisionTask);
@@ -9186,7 +9250,7 @@ var condition = {
 		})) }))
 	}))
 };
-var wait = {
+var wait$1 = {
 	inputDefinitions: array(input),
 	prompt: text
 };
@@ -9299,12 +9363,12 @@ var node = union([
 	strictObject({
 		...base,
 		kind: literal("approval"),
-		...wait
+		...wait$1
 	}).omit({ timeoutMs: true }),
 	strictObject({
 		...base,
 		kind: literal("wait"),
-		...wait,
+		...wait$1,
 		autoContinue: waitAutoContinueDraftSchema.optional()
 	}).omit({ timeoutMs: true }),
 	object({
@@ -9360,7 +9424,7 @@ var authoringDefinitionSchemas = {
 	port: port$1,
 	ports: ports$1,
 	condition: strictObject(condition),
-	wait: strictObject(wait),
+	wait: strictObject(wait$1),
 	waitAutoContinue: waitAutoContinueSchema,
 	webhook: strictObject(webhook),
 	schedule: triggerScheduleSchema,
@@ -9412,7 +9476,8 @@ var revision = object({
 		literal(10),
 		literal(11),
 		literal(12),
-		literal(13)
+		literal(13),
+		literal(14)
 	]),
 	document,
 	modules: record$2(text, module)
@@ -9546,11 +9611,11 @@ var shapes = {
 	"graph.node.resolution.set": {
 		...at,
 		before: strictObject({
-			...wait,
+			...wait$1,
 			autoContinue: waitAutoContinueDraftSchema.optional()
 		}),
 		value: strictObject({
-			...wait,
+			...wait$1,
 			autoContinue: waitAutoContinueDraftSchema.optional()
 		})
 	},
@@ -9613,6 +9678,7 @@ array(union([...new Map(Object.entries(shapes).map(([kind, shape]) => [kind, sha
 	...shape
 })])).values()])).min(1);
 function checkModelVersion(content) {
+	if (content.modelVersion < 14 && Object.values(content.document.graph.nodes).some((candidateNode) => candidateNode.kind === "task" && "executor" in candidateNode.task && candidateNode.task.executor.kind === "connector-proxy")) throw new TypeError("Custom API Request requires Flow model v14.");
 	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.");
@@ -9677,6 +9743,7 @@ var type = _enum([
 	"integration",
 	"code",
 	"connector",
+	"connector-proxy",
 	"agent",
 	"llm",
 	"decision",
@@ -9811,6 +9878,7 @@ var authoringConfigurations = {
 		capabilities: authoringCapabilities.optional()
 	}),
 	"connector": authoringDefinitionSchemas.connector.omit({ outputMode: true }).strict(),
+	"connector-proxy": connectorProxyConfigSchema,
 	"openapi": authoringOpenApiSchema,
 	"http-request": httpRequestConfigSchema,
 	"skip-duplicates": skipDuplicatesConfigSchema,
@@ -10757,7 +10825,7 @@ function clearNodeConnections(graph, connectionId) {
 					const { connectionId: _, ...rest } = value;
 					return rest;
 				};
-				if (executor.kind == "connector") return [id, {
+				if (executor.kind == "connector" || executor.kind == "connector-proxy") return [id, {
 					...node,
 					task: {
 						...node.task,
@@ -12087,6 +12155,118 @@ function readResult(value, query = {}) {
 	};
 }
 //#endregion
+//#region src/control/common/catalogCache.ts
+function cachedResponse(value) {
+	if (value == null || typeof value != "object" || Array.isArray(value)) return;
+	const entry = value;
+	if (entry.version !== 1 || !Object.hasOwn(entry, "body") || !(entry.etag === null || typeof entry.etag == "string") || typeof entry.validatedAt != "number" || !Number.isFinite(entry.validatedAt) || entry.validatedAt < 0) return;
+	return {
+		version: 1,
+		body: jsonValue(entry.body),
+		etag: entry.etag,
+		validatedAt: entry.validatedAt
+	};
+}
+/** Cancellation belongs to each waiter, not the shared metadata request. */
+function wait(promise, signal) {
+	if (signal == null) return promise;
+	if (signal.aborted) {
+		promise.catch(() => {});
+		return Promise.reject(signal.reason);
+	}
+	return new Promise((resolve, reject) => {
+		const abort = () => reject(signal.reason);
+		signal.addEventListener("abort", abort, { once: true });
+		promise.then(resolve, reject).finally(() => signal.removeEventListener("abort", abort));
+	});
+}
+/** Complete Flow API responses, never a merged store of catalog entities. */
+var ControlCatalogCache = class {
+	#pending = /* @__PURE__ */ new Map();
+	constructor(options) {
+		this.options = options;
+		if (!options.scope.trim()) throw new TypeError("Control cache scope must be nonempty.");
+		if (options.maxAgeMs != null && (!Number.isFinite(options.maxAgeMs) || options.maxAgeMs < 0)) throw new TypeError("Control cache maxAgeMs must be finite and nonnegative.");
+	}
+	async read(query, load, maxAgeMs, signal, fresh = false) {
+		signal?.throwIfAborted();
+		const key = JSON.stringify([
+			"open-flow:catalog",
+			1,
+			this.options.scope,
+			query.path
+		]);
+		const result = await wait(this.#request(key, query, load, this.options.maxAgeMs ?? maxAgeMs, fresh || this.options.mode == "refresh"), signal);
+		const data = query.decode(structuredClone(result.body));
+		try {
+			this.options.onRead?.({
+				...result,
+				body: structuredClone(result.body)
+			});
+		} catch {}
+		return {
+			data,
+			etag: result.etag
+		};
+	}
+	#request(key, query, load, maxAgeMs, fresh) {
+		const previous = this.#pending.get(key);
+		if (previous != null) {
+			if (!fresh || previous.fresh) return previous.promise;
+			return previous.promise.catch(() => void 0).then(() => this.#request(key, query, load, maxAgeMs, true));
+		}
+		const promise = this.#load(key, query, load, maxAgeMs, fresh).finally(() => {
+			if (this.#pending.get(key)?.promise === promise) this.#pending.delete(key);
+		});
+		this.#pending.set(key, {
+			fresh,
+			promise
+		});
+		return promise;
+	}
+	async #load(key, query, load, maxAgeMs, fresh) {
+		let cached;
+		try {
+			const stored = await this.options.delegate.get(key);
+			cached = cachedResponse(stored);
+			if (cached != null) query.decode(structuredClone(cached.body));
+			if (stored !== void 0 && cached == null) await this.options.delegate.delete(key);
+		} catch {
+			cached = void 0;
+			try {
+				await this.options.delegate.delete(key);
+			} catch {}
+		}
+		const now = Date.now();
+		const stale = cached == null || cached.validatedAt > now || now - cached.validatedAt >= maxAgeMs;
+		if (cached != null && (this.options.mode == "offline" || !fresh && !stale)) return {
+			...cached,
+			path: query.path,
+			source: "cache",
+			stale
+		};
+		if (this.options.mode == "offline") throw new ApiError(503, "catalog.cache-miss", `No compatible cached response for ${query.path}.`);
+		const result = await load(cached?.etag ?? null);
+		if (!result.modified && cached == null) throw new ApiError(502, "response.invalid", "A catalog returned 304 without a cached response.");
+		const entry = {
+			version: 1,
+			body: result.modified ? result.data : cached.body,
+			etag: result.etag ?? (result.modified ? null : cached.etag),
+			validatedAt: Date.now()
+		};
+		query.decode(structuredClone(entry.body));
+		try {
+			await this.options.delegate.set(key, structuredClone({ ...entry }));
+		} catch {}
+		return {
+			...entry,
+			path: query.path,
+			source: result.modified ? "network" : "revalidated",
+			stale: false
+		};
+	}
+};
+//#endregion
 //#region src/control/common/checkDecoders.ts
 function schemaPath(value) {
 	if (!Array.isArray(value)) return invalidResponse();
@@ -12171,6 +12351,23 @@ function connectorActionQuery(actionId, flowId, locale) {
 		}
 	};
 }
+function connectorActionMetadataQuery(actionId, flowId, locale) {
+	const parameters = new URLSearchParams({
+		...flowId == null ? {} : { flowId },
+		...locale == null ? {} : { locale }
+	}).toString();
+	return {
+		path: `/v1/connector/action-metadata/${encodeURIComponent(actionId)}${parameters ? `?${parameters}` : ""}`,
+		decode: (value) => {
+			const source = record(value);
+			requiredFields(source, ["action", "version"]);
+			if (source.version != 1) return invalidResponse();
+			const action = connectorActionMetadata(source.action);
+			if (action.actionId != actionId) return invalidResponse("action.actionId: does not match the requested Action.");
+			return action;
+		}
+	};
+}
 function allConnectorConnectionsQuery(flowId) {
 	return {
 		path: `/v1/connector/connections${scope(flowId)}`,
@@ -12863,7 +13060,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 !== "skip-duplicates" && 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 !== "connector-proxy" && 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,
@@ -12972,9 +13169,11 @@ function operationKey(operation) {
 	return `${operation}-${randomId()}`;
 }
 var ControlClient = class {
-	constructor(requestControl, channel = "api") {
+	constructor(requestControl, channel = "api", options = {}) {
+		this.options = options;
 		this.channel = channel;
 		this.requestControl = requestControl;
+		if (options.cache != null) this.catalogCache = new ControlCatalogCache(options.cache);
 	}
 	async loadOpenApiDocument(url, signal) {
 		const result = record(await this.request("/v1/openapi/document", {
@@ -13269,6 +13468,16 @@ var ControlClient = class {
 		};
 	}
 	async getTriggerCatalog(locale, cached, signal) {
+		if (this.catalogCache != null) {
+			const result = await this.catalogResponse({
+				path: `/v1/trigger-keys/catalog?locale=${encodeURIComponent(locale)}`,
+				decode: decodeTriggerCatalog
+			}, 3e5, signal);
+			return {
+				data: result.data,
+				etag: result.etag
+			};
+		}
 		const headers = new Headers();
 		if (cached?.etag) headers.set("if-none-match", cached.etag);
 		const response = await this.response(`/v1/trigger-keys/catalog?locale=${encodeURIComponent(locale)}`, {
@@ -13288,6 +13497,16 @@ var ControlClient = class {
 		};
 	}
 	async getTriggerKey(key, signal) {
+		if (this.catalogCache != null) return (await this.catalogResponse({
+			path: `/v1/trigger-keys/${segment(key)}`,
+			decode: (value) => {
+				const source = record(value);
+				if (source.version != 1) return invalidResponse();
+				const definition = triggerKey(source.definition);
+				if (definition.key != key) return invalidResponse("Trigger key does not match the requested definition.");
+				return definition;
+			}
+		}, 3e5, signal)).data;
 		const source = record(await this.request(`/v1/trigger-keys/${segment(key)}`, { signal }));
 		if (source.version != 1) return invalidResponse();
 		return triggerKey(source.definition);
@@ -13403,6 +13622,7 @@ var ControlClient = class {
 	}
 	async listConnectorProviders(signal, flowId, locale) {
 		const query = connectorProvidersQuery(flowId, locale);
+		if (this.catalogCache != null) return (await this.catalogResponse(query, 3e5, signal)).data;
 		return this.connectorRequest(query.path, "providers", signal, query.decode);
 	}
 	async listLeinaBots(flowId, signal) {
@@ -13483,6 +13703,23 @@ var ControlClient = class {
 		const query = connectorActionQuery(actionId, flowId, locale);
 		return this.connectorRequest(query.path, "actions", signal, query.decode, fresh);
 	}
+	async listConnectorActionMetadata(serviceId, signal, flowId, locale) {
+		return this.connectorMetadata({
+			...serviceId == null ? {} : { service: serviceId },
+			...flowId == null ? {} : { flowId },
+			...locale == null ? {} : { locale }
+		}, signal);
+	}
+	async searchConnectorActionMetadata(query, signal, flowId, locale) {
+		return this.connectorMetadata({
+			q: query.trim(),
+			...flowId == null ? {} : { flowId },
+			...locale == null ? {} : { locale }
+		}, signal);
+	}
+	async getConnectorActionMetadata(actionId, signal, flowId, locale, fresh = false) {
+		return (await this.catalogResponse(connectorActionMetadataQuery(actionId, flowId, locale), 3e4, signal, fresh)).data;
+	}
 	async listAllConnectorConnections(signal, flowId, fresh = false) {
 		const query = allConnectorConnectionsQuery(flowId);
 		return this.connectorRequest(query.path, "connections", signal, query.decode, fresh);
@@ -13714,6 +13951,30 @@ var ControlClient = class {
 			method: "POST"
 		}));
 	}
+	async catalogResponse(query, maxAgeMs, signal, fresh = false) {
+		if (this.catalogCache != null) return this.catalogCache.read(query, (etag) => this.readCatalog({
+			path: query.path,
+			decode: jsonValue
+		}, etag), maxAgeMs, signal, fresh);
+		const response = await this.readCatalog(query, null, signal);
+		if (!response.modified) return invalidResponse();
+		return {
+			data: response.data,
+			etag: response.etag
+		};
+	}
+	async connectorMetadata(parameters, signal) {
+		const query = new URLSearchParams(parameters).toString();
+		return (await this.catalogResponse({
+			path: `/v1/connector/action-metadata${query ? `?${query}` : ""}`,
+			decode: (value) => {
+				const source = record(value);
+				requiredFields(source, ["actions", "version"]);
+				if (source.version != 1 || !Array.isArray(source.actions)) return invalidResponse();
+				return source.actions.map(connectorActionMetadata);
+			}
+		}, 3e4, signal)).data;
+	}
 	async connectorActions(parameters, signal) {
 		const query = Object.entries(parameters).map(([key, value]) => `${segment(key)}=${segment(value)}`).join("&");
 		const suffix = query == "" ? "" : `?${query}`;
@@ -13728,6 +13989,7 @@ var ControlClient = class {
 		return decode(await this.request(path, { signal }));
 	}
 	async response(path, init, allowNotModified = false) {
+		if (this.options.cache?.mode == "offline") throw new ApiError(503, "control.offline", "Network requests are disabled for this Control client.");
 		const headers = new Headers(init.headers);
 		if (init.body != null) headers.set("content-type", "application/json");
 		const response = await this.requestControl(path, {