@oomol-lab/open-flow 0.1.0-beta.89 → 0.1.0-beta.90

package/dist/common/cache.d.ts

@@ -0,0 +1,7 @@
+import type { JsonValue } from '../index.js';
+/** Storage is host-owned. Keys and JSON records are opaque to the delegate. */
+export interface CacheDelegate {
+    get(key: string): Promise<unknown>;
+    set(key: string, value: JsonValue): Promise<void>;
+    delete(key: string): Promise<void>;
+}

package/dist/common/catalogCache.d.ts

@@ -1,10 +1,6 @@
+import type { CacheDelegate } from './cache.js';
 import type { JsonValue } from './flow-change.js';
-/** Storage is host-owned. Keys and records are opaque to the delegate. */
-export interface ControlCacheDelegate {
-    get(key: string): Promise<unknown>;
-    set(key: string, value: JsonValue): Promise<void>;
-    delete(key: string): Promise<void>;
-}
+export type ControlCacheDelegate = CacheDelegate;
 export interface ControlCacheRead {
     readonly path: string;
     readonly source: 'cache' | 'network' | 'revalidated';
@@ -38,7 +34,7 @@ export declare class ControlCatalogCache {
     #private;
     private readonly options;
     constructor(options: ControlCacheOptions);
-    read<Value>(query: CatalogQuery<Value>, load: CatalogLoad, maxAgeMs: number, signal?: AbortSignal, fresh?: boolean): Promise<{
+    read<Value>(query: CatalogQuery<Value>, load: CatalogLoad, maxAgeMs: number, signal?: AbortSignal, fresh?: boolean, cacheOnly?: boolean): Promise<{
         data: Value;
         etag: string | null;
     }>;

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

@@ -11502,7 +11502,7 @@ var ControlCatalogCache = class {
 		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) {
+	async read(query, load, maxAgeMs, signal, fresh = false, cacheOnly = false) {
 		signal?.throwIfAborted();
 		const key = JSON.stringify([
 			"open-flow:catalog",
@@ -11510,7 +11510,7 @@ var ControlCatalogCache = class {
 			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 result = await wait(cacheOnly ? this.#load(key, query, load, this.options.maxAgeMs ?? maxAgeMs, false, true) : 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?.({
@@ -11538,7 +11538,7 @@ var ControlCatalogCache = class {
 		});
 		return promise;
 	}
-	async #load(key, query, load, maxAgeMs, fresh) {
+	async #load(key, query, load, maxAgeMs, fresh, cacheOnly = false) {
 		let cached;
 		try {
 			const stored = await this.options.delegate.get(key);
@@ -11553,13 +11553,13 @@ var ControlCatalogCache = class {
 		}
 		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 {
+		if (cached != null && (cacheOnly || 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}.`);
+		if (cacheOnly || 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 = {
@@ -12939,9 +12939,10 @@ var ControlClient = class {
 			version: 1
 		};
 	}
-	async listConnectorProviders(signal, flowId, locale) {
+	async listConnectorProviders(signal, flowId, locale, options = {}) {
 		const query = connectorProvidersQuery(flowId, locale);
-		if (this.catalogCache != null) return (await this.catalogResponse(query, 3e5, signal)).data;
+		if (this.catalogCache != null) return (await this.catalogResponse(query, 3e5, signal, false, options.cacheOnly)).data;
+		if (options.cacheOnly) throw new ApiError(503, "catalog.cache-miss", "No Provider catalog cache is configured.");
 		return this.connectorRequest(query.path, "providers", signal, query.decode);
 	}
 	async listLeinaBots(flowId, signal) {
@@ -13270,11 +13271,11 @@ var ControlClient = class {
 			method: "POST"
 		}));
 	}
-	async catalogResponse(query, maxAgeMs, signal, fresh = false) {
+	async catalogResponse(query, maxAgeMs, signal, fresh = false, cacheOnly = false) {
 		if (this.catalogCache != null) return this.catalogCache.read(query, (etag) => this.readCatalog({
 			path: query.path,
 			decode: jsonValue
-		}, etag), maxAgeMs, signal, fresh);
+		}, etag), maxAgeMs, signal, fresh, cacheOnly);
 		const response = await this.readCatalog(query, null, signal);
 		if (!response.modified) return invalidResponse();
 		return {

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

@@ -933,7 +933,9 @@ export declare class ControlClient {
         }[];
         version: 1;
     }>;
-    listConnectorProviders(signal?: AbortSignal, flowId?: string, locale?: string): Promise<readonly ConnectorProvider[]>;
+    listConnectorProviders(signal?: AbortSignal, flowId?: string, locale?: string, options?: {
+        readonly cacheOnly?: boolean;
+    }): 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>;

package/dist/common/control-api.js

@@ -12188,7 +12188,7 @@ var ControlCatalogCache = class {
 		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) {
+	async read(query, load, maxAgeMs, signal, fresh = false, cacheOnly = false) {
 		signal?.throwIfAborted();
 		const key = JSON.stringify([
 			"open-flow:catalog",
@@ -12196,7 +12196,7 @@ var ControlCatalogCache = class {
 			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 result = await wait(cacheOnly ? this.#load(key, query, load, this.options.maxAgeMs ?? maxAgeMs, false, true) : 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?.({
@@ -12224,7 +12224,7 @@ var ControlCatalogCache = class {
 		});
 		return promise;
 	}
-	async #load(key, query, load, maxAgeMs, fresh) {
+	async #load(key, query, load, maxAgeMs, fresh, cacheOnly = false) {
 		let cached;
 		try {
 			const stored = await this.options.delegate.get(key);
@@ -12239,13 +12239,13 @@ var ControlCatalogCache = class {
 		}
 		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 {
+		if (cached != null && (cacheOnly || 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}.`);
+		if (cacheOnly || 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 = {
@@ -13628,9 +13628,10 @@ var ControlClient = class {
 			version: 1
 		};
 	}
-	async listConnectorProviders(signal, flowId, locale) {
+	async listConnectorProviders(signal, flowId, locale, options = {}) {
 		const query = connectorProvidersQuery(flowId, locale);
-		if (this.catalogCache != null) return (await this.catalogResponse(query, 3e5, signal)).data;
+		if (this.catalogCache != null) return (await this.catalogResponse(query, 3e5, signal, false, options.cacheOnly)).data;
+		if (options.cacheOnly) throw new ApiError(503, "catalog.cache-miss", "No Provider catalog cache is configured.");
 		return this.connectorRequest(query.path, "providers", signal, query.decode);
 	}
 	async listLeinaBots(flowId, signal) {
@@ -13959,11 +13960,11 @@ var ControlClient = class {
 			method: "POST"
 		}));
 	}
-	async catalogResponse(query, maxAgeMs, signal, fresh = false) {
+	async catalogResponse(query, maxAgeMs, signal, fresh = false, cacheOnly = false) {
 		if (this.catalogCache != null) return this.catalogCache.read(query, (etag) => this.readCatalog({
 			path: query.path,
 			decode: jsonValue
-		}, etag), maxAgeMs, signal, fresh);
+		}, etag), maxAgeMs, signal, fresh, cacheOnly);
 		const response = await this.readCatalog(query, null, signal);
 		if (!response.modified) return invalidResponse();
 		return {

package/dist/common/mcp.js

@@ -11703,7 +11703,7 @@ var ControlCatalogCache = class {
 		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) {
+	async read(query, load, maxAgeMs, signal, fresh = false, cacheOnly = false) {
 		signal?.throwIfAborted();
 		const key = JSON.stringify([
 			"open-flow:catalog",
@@ -11711,7 +11711,7 @@ var ControlCatalogCache = class {
 			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 result = await wait(cacheOnly ? this.#load(key, query, load, this.options.maxAgeMs ?? maxAgeMs, false, true) : 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?.({
@@ -11739,7 +11739,7 @@ var ControlCatalogCache = class {
 		});
 		return promise;
 	}
-	async #load(key, query, load, maxAgeMs, fresh) {
+	async #load(key, query, load, maxAgeMs, fresh, cacheOnly = false) {
 		let cached;
 		try {
 			const stored = await this.options.delegate.get(key);
@@ -11754,13 +11754,13 @@ var ControlCatalogCache = class {
 		}
 		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 {
+		if (cached != null && (cacheOnly || 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}.`);
+		if (cacheOnly || 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 = {
@@ -13129,9 +13129,10 @@ var ControlClient = class {
 			version: 1
 		};
 	}
-	async listConnectorProviders(signal, flowId, locale) {
+	async listConnectorProviders(signal, flowId, locale, options = {}) {
 		const query = connectorProvidersQuery(flowId, locale);
-		if (this.catalogCache != null) return (await this.catalogResponse(query, 3e5, signal)).data;
+		if (this.catalogCache != null) return (await this.catalogResponse(query, 3e5, signal, false, options.cacheOnly)).data;
+		if (options.cacheOnly) throw new ApiError(503, "catalog.cache-miss", "No Provider catalog cache is configured.");
 		return this.connectorRequest(query.path, "providers", signal, query.decode);
 	}
 	async listLeinaBots(flowId, signal) {
@@ -13460,11 +13461,11 @@ var ControlClient = class {
 			method: "POST"
 		}));
 	}
-	async catalogResponse(query, maxAgeMs, signal, fresh = false) {
+	async catalogResponse(query, maxAgeMs, signal, fresh = false, cacheOnly = false) {
 		if (this.catalogCache != null) return this.catalogCache.read(query, (etag) => this.readCatalog({
 			path: query.path,
 			decode: jsonValue
-		}, etag), maxAgeMs, signal, fresh);
+		}, etag), maxAgeMs, signal, fresh, cacheOnly);
 		const response = await this.readCatalog(query, null, signal);
 		if (!response.modified) return invalidResponse();
 		return {

package/dist/common/provider-icons.d.ts

@@ -0,0 +1,35 @@
+import type { CacheDelegate } from './cache.js';
+export type { CacheDelegate } from './cache.js';
+export type ProviderIconRequest = {
+    readonly kind: 'sprite';
+    readonly theme: 'light' | 'dark';
+    readonly url: string;
+    readonly version: string;
+} | {
+    readonly kind: 'image';
+    readonly providerId: string;
+    readonly url: string;
+};
+export interface ProviderIconCacheOptions {
+    /** Non-secret identity of the artwork source or deployment. */
+    readonly scope: string;
+    /** Defaults to instance-local memory. Records contain base64 image bytes. */
+    readonly delegate?: CacheDelegate;
+    readonly mode?: 'default' | 'refresh' | 'offline';
+    readonly fetch?: typeof fetch;
+}
+export interface ProviderIconReadOptions {
+    /** Restricts this read even if another caller is loading the same resource online. */
+    readonly allowNetwork?: boolean;
+}
+/** The browser renderer can consume the same interface over a Node bridge. */
+export interface ProviderIconLoader {
+    get(request: ProviderIconRequest, options?: ProviderIconReadOptions): Promise<string>;
+}
+/** Complete image responses in bounded, identity-checked slots; no catalog entities live here. */
+export declare class ProviderIconCache implements ProviderIconLoader {
+    #private;
+    private readonly options;
+    constructor(options: ProviderIconCacheOptions);
+    get(request: ProviderIconRequest, options?: ProviderIconReadOptions): Promise<string>;
+}

package/dist/common/provider-icons.js

@@ -0,0 +1,134 @@
+//#region src/connector/common/providerIconCache.ts
+var defaultMaxAgeMs = 864e5;
+var dataUrl = (entry) => `data:${entry.contentType};base64,${entry.body}`;
+function decodeRecord(value) {
+	if (value == null || typeof value !== "object") return;
+	const v = value;
+	if (v.formatVersion !== 1 || typeof v.sourceUrl !== "string" || !(v.spriteVersion === null || typeof v.spriteVersion === "string") || typeof v.contentType !== "string" || !/^image\/[\w.+-]+$/i.test(v.contentType) || typeof v.body !== "string" || !v.body || v.body.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/.test(v.body) || !(v.etag === null || typeof v.etag === "string") || !Number.isFinite(v.validatedAt) || v.validatedAt < 0 || !(v.maxAgeMs === null || Number.isFinite(v.maxAgeMs) && v.maxAgeMs >= 0)) return;
+	return v;
+}
+function encodeBytes(bytes) {
+	let text = "";
+	for (let index = 0; index < bytes.length; index += 8192) text += String.fromCharCode(...bytes.subarray(index, index + 8192));
+	return btoa(text);
+}
+function freshness(response, immutable, previous) {
+	const control = response.headers.get("cache-control") ?? "";
+	if (/\bno-cache\b/i.test(control)) return 0;
+	if (immutable) return null;
+	const maxAge = /(?:^|,)\s*max-age\s*=\s*"?(\d+)/i.exec(control);
+	if (maxAge) return Math.max(0, Number(maxAge[1]) * 1e3 - (Number(response.headers.get("age")) || 0) * 1e3);
+	const expires = Date.parse(response.headers.get("expires") ?? "");
+	if (Number.isFinite(expires)) return Math.max(0, expires - Date.parse(response.headers.get("date") ?? (/* @__PURE__ */ new Date()).toUTCString()));
+	return previous?.maxAgeMs ?? defaultMaxAgeMs;
+}
+/** Complete image responses in bounded, identity-checked slots; no catalog entities live here. */
+var ProviderIconCache = class {
+	#memory = /* @__PURE__ */ new Map();
+	#pending = /* @__PURE__ */ new Map();
+	#targets = /* @__PURE__ */ new Map();
+	#writes = /* @__PURE__ */ new Map();
+	constructor(options) {
+		this.options = options;
+		if (!options.scope.trim()) throw new TypeError("Provider icon cache scope must be nonempty.");
+	}
+	get(request, options = {}) {
+		if (request.url.startsWith("data:image/")) return Promise.resolve(request.url);
+		let protocol;
+		try {
+			protocol = new URL(request.url).protocol;
+		} catch (error) {
+			return Promise.reject(error);
+		}
+		if (!["http:", "https:"].includes(protocol)) return Promise.reject(/* @__PURE__ */ new TypeError("Unsupported Provider icon URL."));
+		const slot = JSON.stringify([
+			"open-flow:provider-icons",
+			1,
+			this.options.scope,
+			request.kind,
+			request.kind === "sprite" ? request.theme : request.providerId
+		]);
+		const version = request.kind === "sprite" ? request.version : null;
+		const identity = JSON.stringify([request.url, version]);
+		const offline = options.allowNetwork === false || this.options.mode === "offline";
+		const key = JSON.stringify([
+			slot,
+			identity,
+			offline
+		]);
+		const pending = this.#pending.get(key);
+		if (pending) return pending;
+		if (!offline) this.#targets.set(slot, identity);
+		const promise = this.#load(slot, identity, request.url, version, offline).finally(() => this.#pending.delete(key));
+		this.#pending.set(key, promise);
+		return promise;
+	}
+	async #read(slot, url, version) {
+		const memory = this.#memory.get(slot);
+		if (this.#memory.has(slot) && (!memory || memory.sourceUrl === url && memory.spriteVersion === version)) return memory;
+		if (!this.options.delegate) return this.#memory.get(slot);
+		try {
+			const stored = await this.options.delegate.get(slot);
+			if (stored === void 0) return this.#memory.get(slot);
+			const entry = decodeRecord(stored);
+			if (entry) {
+				this.#memory.set(slot, entry);
+				return entry;
+			}
+			this.#memory.delete(slot);
+			await this.options.delegate.delete(slot);
+		} catch {
+			return this.#memory.get(slot);
+		}
+	}
+	async #store(slot, identity, entry) {
+		const operation = (this.#writes.get(slot) ?? Promise.resolve()).then(async () => {
+			if (this.#targets.get(slot) !== identity) return;
+			this.#memory.set(slot, entry);
+			if (!this.options.delegate) return;
+			try {
+				if (entry) await this.options.delegate.set(slot, { ...entry });
+				else await this.options.delegate.delete(slot);
+			} catch {}
+		});
+		this.#writes.set(slot, operation);
+		try {
+			await operation;
+		} finally {
+			if (this.#writes.get(slot) === operation) this.#writes.delete(slot);
+		}
+	}
+	async #load(slot, identity, url, version, offline) {
+		const stored = await this.#read(slot, url, version);
+		const cached = stored?.sourceUrl === url && stored.spriteVersion === version ? stored : void 0;
+		const age = cached == null ? Infinity : Date.now() - cached.validatedAt;
+		if (cached && (offline || this.options.mode !== "refresh" && age >= 0 && (cached.maxAgeMs === null || age < cached.maxAgeMs))) return dataUrl(cached);
+		if (offline) throw new Error(`Provider icon is not cached: ${url}`);
+		const response = await (this.options.fetch ?? globalThis.fetch)(url, {
+			credentials: "omit",
+			referrerPolicy: "no-referrer",
+			signal: AbortSignal.timeout(15e3),
+			headers: cached?.etag ? { "if-none-match": cached.etag } : {}
+		});
+		if (response.status !== 304 && !response.ok) throw new Error(`Could not load Provider icon: ${response.status}`);
+		if (response.status === 304 && !cached) throw new Error("Provider icon returned 304 without a cached image.");
+		const contentType = response.status === 304 ? cached.contentType : response.headers.get("content-type")?.split(";")[0]?.trim().toLowerCase();
+		if (!contentType || !/^image\/[\w.+-]+$/i.test(contentType)) throw new Error("Provider icon response is not an image.");
+		const body = response.status === 304 ? cached.body : encodeBytes(new Uint8Array(await response.arrayBuffer()));
+		if (!body) throw new Error("Provider icon response is empty.");
+		const entry = {
+			formatVersion: 1,
+			sourceUrl: url,
+			spriteVersion: version,
+			contentType,
+			body,
+			etag: response.headers.get("etag") ?? (response.status === 304 ? cached.etag : null),
+			validatedAt: Date.now(),
+			maxAgeMs: freshness(response, version !== null, response.status === 304 ? cached : void 0)
+		};
+		await this.#store(slot, identity, /\bno-store\b/i.test(response.headers.get("cache-control") ?? "") ? void 0 : entry);
+		return dataUrl(entry);
+	}
+};
+//#endregion
+export { ProviderIconCache };

package/dist/render/browser/runtime.css

@@ -8844,7 +8844,7 @@ svg.react-flow__connectionline {
     filter: blur(var(--tw-exit-blur, 0));
   }
 }
-.ContentIcon_img_4e5d2 {
+.ContentIcon_img_e2c99 {
   width: 1em;
   height: 1em;
   vertical-align: middle;
@@ -8852,7 +8852,16 @@ svg.react-flow__connectionline {
   object-fit: contain;
 }
 
-.ContentIcon_initials_4e5d2 {
+.ContentIcon_pending_e2c99 {
+  display: inline-flex;
+  width: 1em;
+  height: 1em;
+  align-items: center;
+  justify-content: center;
+  vertical-align: middle;
+}
+
+.ContentIcon_initials_e2c99 {
   display: inline-flex;
   width: 1em;
   height: 1em;
@@ -8865,13 +8874,13 @@ svg.react-flow__connectionline {
   vertical-align: middle;
   pointer-events: none;
 }
-.ContentIcon_initials_4e5d2 > span {
+.ContentIcon_initials_e2c99 > span {
   font-size: 0.42em;
   font-weight: 400;
   line-height: 1;
 }
 
-.ContentIcon_sprite_4e5d2 {
+.ContentIcon_sprite_e2c99 {
   display: inline-block;
   position: relative;
   overflow: hidden;
@@ -8881,7 +8890,7 @@ svg.react-flow__connectionline {
   vertical-align: middle;
   pointer-events: none;
 }
-.ContentIcon_sprite_4e5d2 > span {
+.ContentIcon_sprite_e2c99 > span {
   position: absolute;
   background-size: 100% 100%;
   background-repeat: no-repeat;