@workglow/openai 0.3.37 → 0.3.39

package/dist/ai.browser.js.map

@@ -2,16 +2,16 @@
   "version": 3,
   "sources": ["../src/ai/common/OpenAI_Client.ts", "../src/ai/common/OpenAI_Constants.ts", "../src/ai/common/OpenAI_ModelSchema.ts", "../src/ai/registerOpenAi.ts", "../src/ai/OpenAiQueuedProvider.ts", "../src/ai/common/OpenAI_CapabilitySets.ts", "../src/ai/common/OpenAI_Capabilities.ts", "../src/ai/common/OpenAI_ImageValidation.ts"],
   "sourcesContent": [
-    "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { isBrowserLike, resolveApiKey, validateProviderBaseUrl } from \"@workglow/ai/provider-utils\";\nimport type { OpenAiModelConfig } from \"./OpenAI_ModelSchema\";\n\n/**\n * Hostnames (or hostname suffixes) accepted for OpenAI `base_url` without\n * the explicit `trustedBaseUrl` opt-out. Includes Azure OpenAI tenants.\n */\nexport const OPENAI_ALLOWED_HOSTS: readonly string[] = [\"api.openai.com\", \".openai.azure.com\"];\n\ntype OpenAIClientClass = new (config: any) => any;\n\nlet _loadPromise: Promise<OpenAIClientClass> | undefined;\n\n// NOTE: we do not want to de-dup this in the provider-utils, vite wants direct import with string literals.\nexport async function loadOpenAISDK(): Promise<OpenAIClientClass> {\n  _loadPromise ??= import(/* @vite-ignore */ \"openai\")\n\n    .then((mod) => mod.default as OpenAIClientClass)\n    .catch(() => {\n      _loadPromise = undefined;\n      throw new Error(\"openai is required for OpenAI tasks. Install it with: bun add openai\");\n    });\n  return _loadPromise;\n}\n\ninterface ResolvedProviderConfig {\n  readonly credential_key?: string;\n  readonly api_key?: string;\n  readonly model_name?: string;\n  readonly base_url?: string;\n  readonly organization?: string;\n  readonly prompt_cache_key?: string;\n  readonly reasoning?: { readonly effort?: string; readonly mode?: string };\n  /**\n   * When `true`, accept the `base_url` even if its hostname is not in\n   * {@link OPENAI_ALLOWED_HOSTS}. Use only for known-good custom enterprise\n   * gateways. The URL still has to parse and use a safe scheme.\n   */\n  readonly trustedBaseUrl?: boolean;\n}\n\nexport async function getClient(model: OpenAiModelConfig | undefined) {\n  const OpenAI = await loadOpenAISDK();\n  const config = model?.provider_config as ResolvedProviderConfig | undefined;\n  const apiKey = resolveApiKey({\n    config,\n    envVar: \"OPENAI_API_KEY\",\n    providerLabel: \"OpenAI\",\n  });\n  // Throw before SDK construction on a rejected base_url so the API key is\n  // never sent to an unvalidated host.\n  const baseURL = validateProviderBaseUrl(config?.base_url, {\n    vendor: \"openai\",\n    allowHosts: OPENAI_ALLOWED_HOSTS,\n    trustedBaseUrl: config?.trustedBaseUrl,\n    providerLabel: \"OpenAI\",\n  });\n  try {\n    return new OpenAI({\n      apiKey,\n      baseURL,\n      organization: config?.organization || undefined,\n      dangerouslyAllowBrowser: isBrowserLike(),\n    });\n  } catch (err) {\n    throw new Error(\n      `Failed to create OpenAI client: ${err instanceof Error ? err.message : \"unknown error\"}`\n    );\n  }\n}\n\nexport function getModelName(model: OpenAiModelConfig | undefined): string {\n  const name = model?.provider_config?.model_name;\n  if (!name) {\n    throw new Error(\"Missing model name in provider_config.model_name.\");\n  }\n  return name;\n}\n\n/**\n * Resolves the configured `reasoning` object for reasoning-capable models\n * (the GPT-5.6 sol/terra/luna family and the o-series), sent verbatim as the\n * Responses `reasoning` parameter. Returns `undefined` when unset so\n * non-reasoning models and callers that don't opt in send no reasoning field.\n */\nexport function getReasoningConfig(\n  model: OpenAiModelConfig | undefined\n): { effort?: string; mode?: string } | undefined {\n  const reasoning = (model?.provider_config as ResolvedProviderConfig | undefined)?.reasoning;\n  if (!reasoning || (reasoning.effort === undefined && reasoning.mode === undefined)) {\n    return undefined;\n  }\n  return reasoning;\n}\n\n/** Deterministic 32-bit FNV-1a hash → 8-char hex. Worker-safe (no crypto import). */\nfunction fnv1aHex(input: string): string {\n  let hash = 0x811c9dc5;\n  for (let i = 0; i < input.length; i++) {\n    hash ^= input.charCodeAt(i);\n    hash = Math.imul(hash, 0x01000193);\n  }\n  return (hash >>> 0).toString(16).padStart(8, \"0\");\n}\n\n/**\n * Resolves the Responses `prompt_cache_key`. Uses an explicit\n * `provider_config.prompt_cache_key` override when set, otherwise derives a\n * stable key from the request's cache-relevant prefix (model + system\n * instructions + tools) so requests sharing that prefix converge on one key and\n * hit the cache. GPT-5.6 bills cache writes, so a stable key (not a random one)\n * is the cost-correct default.\n */\nexport function resolvePromptCacheKey(\n  model: OpenAiModelConfig | undefined,\n  params: { model?: unknown; instructions?: unknown; tools?: unknown }\n): string {\n  const override = (model?.provider_config as ResolvedProviderConfig | undefined)?.prompt_cache_key;\n  if (override) return override;\n  const material = JSON.stringify([\n    params.model ?? \"\",\n    params.instructions ?? \"\",\n    params.tools ?? null,\n  ]);\n  return `wg-${fnv1aHex(material)}`;\n}\n\n/**\n * Applies the per-request Responses fields common to every OpenAI text run-fn:\n * the model's `reasoning` config (when set) and a stable `prompt_cache_key`.\n * Mutates and returns `params` so callers can inline it into the create call.\n * Call this last, after model/instructions/tools are populated, so the cache\n * key sees the full prefix.\n */\nexport function finalizeResponsesRequest(\n  model: OpenAiModelConfig | undefined,\n  params: Record<string, unknown>\n): Record<string, unknown> {\n  const reasoning = getReasoningConfig(model);\n  if (reasoning !== undefined) params.reasoning = reasoning;\n  params.prompt_cache_key = resolvePromptCacheKey(model, params);\n  return params;\n}\n",
+    "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { isModelEffort, type ModelEffort } from \"@workglow/ai\";\nimport { isBrowserLike, resolveApiKey, validateProviderBaseUrl } from \"@workglow/ai/provider-utils\";\nimport type { OpenAiModelConfig } from \"./OpenAI_ModelSchema\";\n\n/** Maps coarse {@link ModelEffort} to OpenAI Responses `reasoning.effort`. */\nconst EFFORT_TO_OPENAI: Record<ModelEffort, string> = {\n  none: \"none\",\n  low: \"low\",\n  medium: \"medium\",\n  high: \"high\",\n  extra: \"xhigh\",\n  ultra: \"max\",\n};\n\n/**\n * Hostnames (or hostname suffixes) accepted for OpenAI `base_url` without\n * the explicit `trustedBaseUrl` opt-out. Includes Azure OpenAI tenants.\n */\nexport const OPENAI_ALLOWED_HOSTS: readonly string[] = [\"api.openai.com\", \".openai.azure.com\"];\n\ntype OpenAIClientClass = new (config: any) => any;\n\nlet _loadPromise: Promise<OpenAIClientClass> | undefined;\n\n// NOTE: we do not want to de-dup this in the provider-utils, vite wants direct import with string literals.\nexport async function loadOpenAISDK(): Promise<OpenAIClientClass> {\n  _loadPromise ??= import(/* @vite-ignore */ \"openai\")\n\n    .then((mod) => mod.default as OpenAIClientClass)\n    .catch(() => {\n      _loadPromise = undefined;\n      throw new Error(\"openai is required for OpenAI tasks. Install it with: bun add openai\");\n    });\n  return _loadPromise;\n}\n\ninterface ResolvedProviderConfig {\n  readonly credential_key?: string;\n  readonly api_key?: string;\n  readonly model_name?: string;\n  readonly base_url?: string;\n  readonly organization?: string;\n  readonly prompt_cache_key?: string;\n  readonly reasoning?: { readonly effort?: string; readonly mode?: string };\n  /**\n   * When `true`, accept the `base_url` even if its hostname is not in\n   * {@link OPENAI_ALLOWED_HOSTS}. Use only for known-good custom enterprise\n   * gateways. The URL still has to parse and use a safe scheme.\n   */\n  readonly trustedBaseUrl?: boolean;\n}\n\nlet _testClient: unknown;\n\n/**\n * Override the client returned by {@link getClient} so runtime tests can\n * capture the requests the OpenAI run-fns build without a live SDK, API key,\n * or network call. Pass `undefined` to restore normal SDK-backed creation.\n * This lives in the runtime module (not a `vi.mock` of `openai`) so it works\n * identically whether the provider resolves to `src` or the bundled `dist`,\n * and is immune to duplicate SDK copies across the workspace defeating\n * module-level mocks.\n */\nfunction setOpenAIClientForTests(client: unknown): void {\n  _testClient = client;\n}\n\n/**\n * @internal Symbols exported only for use by `@workglow/test`. Not part of the\n * stable public API. Surfaced on the `ai-runtime` barrel (via `export *`) and\n * merged into the `/ai` barrel's `_testOnly`.\n */\nexport const _testOnly = {\n  setOpenAIClientForTests,\n} as const;\n\nexport async function getClient(model: OpenAiModelConfig | undefined) {\n  if (_testClient) return _testClient as InstanceType<OpenAIClientClass>;\n  const OpenAI = await loadOpenAISDK();\n  const config = model?.provider_config as ResolvedProviderConfig | undefined;\n  const apiKey = resolveApiKey({\n    config,\n    envVar: \"OPENAI_API_KEY\",\n    providerLabel: \"OpenAI\",\n  });\n  // Throw before SDK construction on a rejected base_url so the API key is\n  // never sent to an unvalidated host.\n  const baseURL = validateProviderBaseUrl(config?.base_url, {\n    vendor: \"openai\",\n    allowHosts: OPENAI_ALLOWED_HOSTS,\n    trustedBaseUrl: config?.trustedBaseUrl,\n    providerLabel: \"OpenAI\",\n  });\n  try {\n    return new OpenAI({\n      apiKey,\n      baseURL,\n      organization: config?.organization || undefined,\n      dangerouslyAllowBrowser: isBrowserLike(),\n    });\n  } catch (err) {\n    throw new Error(\n      `Failed to create OpenAI client: ${err instanceof Error ? err.message : \"unknown error\"}`\n    );\n  }\n}\n\nexport function getModelName(model: OpenAiModelConfig | undefined): string {\n  const name = model?.provider_config?.model_name;\n  if (!name) {\n    throw new Error(\"Missing model name in provider_config.model_name.\");\n  }\n  return name;\n}\n\n/**\n * Resolves the `reasoning` object for reasoning-capable models (GPT-5.6\n * sol/terra/luna and the o-series). Native `provider_config.reasoning` wins;\n * otherwise map `model.effort`. Returns `undefined` when neither is set.\n */\nexport function getReasoningConfig(\n  model: OpenAiModelConfig | undefined\n): { effort?: string; mode?: string } | undefined {\n  const reasoning = (model?.provider_config as ResolvedProviderConfig | undefined)?.reasoning;\n  if (reasoning && (reasoning.effort !== undefined || reasoning.mode !== undefined)) {\n    return reasoning;\n  }\n  if (isModelEffort(model?.effort)) {\n    return { effort: EFFORT_TO_OPENAI[model.effort] };\n  }\n  return undefined;\n}\n\n/** Deterministic 32-bit FNV-1a hash → 8-char hex. Worker-safe (no crypto import). */\nfunction fnv1aHex(input: string): string {\n  let hash = 0x811c9dc5;\n  for (let i = 0; i < input.length; i++) {\n    hash ^= input.charCodeAt(i);\n    hash = Math.imul(hash, 0x01000193);\n  }\n  return (hash >>> 0).toString(16).padStart(8, \"0\");\n}\n\n/**\n * Resolves the Responses `prompt_cache_key`. Uses an explicit\n * `provider_config.prompt_cache_key` override when set, otherwise derives a\n * stable key from the request's cache-relevant prefix (model + system\n * instructions + tools) so requests sharing that prefix converge on one key and\n * hit the cache. GPT-5.6 bills cache writes, so a stable key (not a random one)\n * is the cost-correct default.\n */\nexport function resolvePromptCacheKey(\n  model: OpenAiModelConfig | undefined,\n  params: { model?: unknown; instructions?: unknown; tools?: unknown }\n): string {\n  const override = (model?.provider_config as ResolvedProviderConfig | undefined)?.prompt_cache_key;\n  if (override) return override;\n  const material = JSON.stringify([\n    params.model ?? \"\",\n    params.instructions ?? \"\",\n    params.tools ?? null,\n  ]);\n  return `wg-${fnv1aHex(material)}`;\n}\n\n/**\n * Applies the per-request Responses fields common to every OpenAI text run-fn:\n * the model's `reasoning` config and a stable `prompt_cache_key`. Mutates and\n * returns `params` so callers can inline it into the create call. Call this\n * last, after model/instructions/tools/temperature are populated, so the cache\n * key sees the full prefix and the reasoning default can see the temperature.\n *\n * When the caller pinned a `temperature` but expressed no reasoning preference,\n * reasoning is forced off. The two are not independently selectable on the\n * reasoning families: `gpt-5.6-luna` answers `temperature` alone with\n * `400 Unsupported parameter: 'temperature' is not supported with this model`,\n * yet accepts `{reasoning: {effort: \"none\"}, temperature: 0}`. A caller asking\n * for a specific temperature is asking for controlled sampling, so honouring\n * that request — rather than failing it — is the useful reading. An explicit\n * `reasoning` in the model config always wins.\n */\nexport function finalizeResponsesRequest(\n  model: OpenAiModelConfig | undefined,\n  params: Record<string, unknown>\n): Record<string, unknown> {\n  const reasoning = getReasoningConfig(model);\n  if (reasoning !== undefined) params.reasoning = reasoning;\n  else if (params.temperature !== undefined) params.reasoning = { effort: \"none\" };\n  params.prompt_cache_key = resolvePromptCacheKey(model, params);\n  return params;\n}\n",
     "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nexport const OPENAI = \"OPENAI\";\n",
-    "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { ModelConfigSchema, ModelRecordSchema } from \"@workglow/ai/worker\";\nimport { DataPortSchemaObject, FromSchema } from \"@workglow/util/worker\";\nimport { OPENAI } from \"./OpenAI_Constants\";\n\nexport const OpenAiModelSchema = {\n  type: \"object\",\n  properties: {\n    provider: {\n      const: OPENAI,\n      description: \"Discriminator: OpenAI cloud provider.\",\n    },\n    provider_config: {\n      type: \"object\",\n      description: \"OpenAI-specific configuration.\",\n      properties: {\n        model_name: {\n          type: \"string\",\n          description: \"The OpenAI model identifier (e.g., 'gpt-4o', 'text-embedding-3-small').\",\n        },\n        credential_key: {\n          type: \"string\",\n          format: \"credential\",\n          description: \"Key to look up in the credential store for the API key.\",\n          \"x-ui-hidden\": true,\n        },\n        base_url: {\n          type: \"string\",\n          description: \"Base URL for the OpenAI API. Useful for Azure OpenAI or proxy servers.\",\n          default: \"https://api.openai.com/v1\",\n        },\n        trustedBaseUrl: {\n          type: \"boolean\",\n          description:\n            \"When true, accept a base_url whose hostname is not in the built-in allow-list. Use only for known-good custom enterprise gateways — otherwise an attacker can exfiltrate the API key by pointing base_url at their own server.\",\n          default: false,\n          \"x-ui-hidden\": true,\n        },\n        organization: {\n          type: \"string\",\n          description: \"OpenAI organization ID (optional).\",\n        },\n        prompt_cache_key: {\n          type: \"string\",\n          description:\n            \"Overrides the auto-derived Responses prompt_cache_key. Requests sharing a key share a cached prefix; leave unset to derive a stable key from the model + system instructions + tools.\",\n          \"x-ui-hidden\": true,\n        },\n        reasoning: {\n          type: \"object\",\n          description:\n            \"Reasoning controls for reasoning-capable models (e.g. the GPT-5.6 sol/terra/luna family), sent on the Responses API.\",\n          properties: {\n            effort: {\n              type: \"string\",\n              enum: [\"none\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\", \"max\"],\n              description: \"Reasoning effort. Higher effort trades latency and cost for quality.\",\n            },\n            mode: {\n              type: \"string\",\n              enum: [\"pro\"],\n              description:\n                \"Set to 'pro' for the quality-first pro configuration on supported models.\",\n            },\n          },\n          additionalProperties: false,\n        },\n      },\n      required: [\"model_name\"],\n      additionalProperties: false,\n    },\n  },\n  required: [\"provider\", \"provider_config\"],\n  additionalProperties: true,\n} as const satisfies DataPortSchemaObject;\n\nexport const OpenAiModelRecordSchema = {\n  type: \"object\",\n  properties: {\n    ...ModelRecordSchema.properties,\n    ...OpenAiModelSchema.properties,\n  },\n  required: [...ModelRecordSchema.required, ...OpenAiModelSchema.required],\n  additionalProperties: false,\n} as const satisfies DataPortSchemaObject;\n\nexport type OpenAiModelRecord = FromSchema<typeof OpenAiModelRecordSchema>;\n\nexport const OpenAiModelConfigSchema = {\n  type: \"object\",\n  properties: {\n    ...ModelConfigSchema.properties,\n    ...OpenAiModelSchema.properties,\n  },\n  required: [...ModelConfigSchema.required, ...OpenAiModelSchema.required],\n  additionalProperties: false,\n} as const satisfies DataPortSchemaObject;\n\nexport type OpenAiModelConfig = FromSchema<typeof OpenAiModelConfigSchema>;\n",
+    "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { WithModelPricing } from \"@workglow/ai/worker\";\nimport { ModelConfigSchema, ModelRecordSchema } from \"@workglow/ai/worker\";\nimport type { DataPortSchemaObject, FromSchema } from \"@workglow/util/worker\";\nimport { OPENAI } from \"./OpenAI_Constants\";\n\nexport const OpenAiModelSchema = {\n  type: \"object\",\n  properties: {\n    provider: {\n      const: OPENAI,\n      description: \"Discriminator: OpenAI cloud provider.\",\n    },\n    provider_config: {\n      type: \"object\",\n      description: \"OpenAI-specific configuration.\",\n      properties: {\n        model_name: {\n          type: \"string\",\n          description: \"The OpenAI model identifier (e.g., 'gpt-4o', 'text-embedding-3-small').\",\n        },\n        credential_key: {\n          type: \"string\",\n          format: \"credential\",\n          description: \"Key to look up in the credential store for the API key.\",\n          \"x-ui-hidden\": true,\n        },\n        base_url: {\n          type: \"string\",\n          description: \"Base URL for the OpenAI API. Useful for Azure OpenAI or proxy servers.\",\n          default: \"https://api.openai.com/v1\",\n        },\n        trustedBaseUrl: {\n          type: \"boolean\",\n          description:\n            \"When true, accept a base_url whose hostname is not in the built-in allow-list. Use only for known-good custom enterprise gateways — otherwise an attacker can exfiltrate the API key by pointing base_url at their own server.\",\n          default: false,\n          \"x-ui-hidden\": true,\n        },\n        organization: {\n          type: \"string\",\n          description: \"OpenAI organization ID (optional).\",\n        },\n        prompt_cache_key: {\n          type: \"string\",\n          description:\n            \"Overrides the auto-derived Responses prompt_cache_key. Requests sharing a key share a cached prefix; leave unset to derive a stable key from the model + system instructions + tools.\",\n          \"x-ui-hidden\": true,\n        },\n        reasoning: {\n          type: \"object\",\n          description:\n            \"Reasoning controls for reasoning-capable models (e.g. the GPT-5.6 sol/terra/luna family), sent on the Responses API.\",\n          properties: {\n            effort: {\n              type: \"string\",\n              enum: [\"none\", \"minimal\", \"low\", \"medium\", \"high\", \"xhigh\", \"max\"],\n              description: \"Reasoning effort. Higher effort trades latency and cost for quality.\",\n            },\n            mode: {\n              type: \"string\",\n              enum: [\"pro\"],\n              description:\n                \"Set to 'pro' for the quality-first pro configuration on supported models.\",\n            },\n          },\n          additionalProperties: false,\n        },\n      },\n      required: [\"model_name\"],\n      additionalProperties: false,\n    },\n  },\n  required: [\"provider\", \"provider_config\"],\n  additionalProperties: true,\n} as const satisfies DataPortSchemaObject;\n\nexport const OpenAiModelRecordSchema = {\n  type: \"object\",\n  properties: {\n    ...ModelRecordSchema.properties,\n    ...OpenAiModelSchema.properties,\n  },\n  required: [...ModelRecordSchema.required, ...OpenAiModelSchema.required],\n  additionalProperties: false,\n} as const satisfies DataPortSchemaObject;\n\nexport type OpenAiModelRecord = WithModelPricing<FromSchema<typeof OpenAiModelRecordSchema>>;\n\nexport const OpenAiModelConfigSchema = {\n  type: \"object\",\n  properties: {\n    ...ModelConfigSchema.properties,\n    ...OpenAiModelSchema.properties,\n  },\n  required: [...ModelConfigSchema.required, ...OpenAiModelSchema.required],\n  additionalProperties: false,\n} as const satisfies DataPortSchemaObject;\n\nexport type OpenAiModelConfig = WithModelPricing<FromSchema<typeof OpenAiModelConfigSchema>>;\n",
     "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { AiProviderRegisterOptions } from \"@workglow/ai\";\nimport { registerProviderWithWorker } from \"@workglow/ai/provider-utils\";\nimport { OpenAiQueuedProvider } from \"./OpenAiQueuedProvider\";\nimport { registerOpenAiImageValidator } from \"./common/OpenAI_ImageValidation\";\n\nexport async function registerOpenAi(\n  options: AiProviderRegisterOptions & {\n    worker: Worker | (() => Worker);\n  }\n): Promise<void> {\n  registerOpenAiImageValidator();\n  await registerProviderWithWorker(new OpenAiQueuedProvider(), \"OpenAI\", options);\n}\n",
     "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { Capability, ModelRecord } from \"@workglow/ai\";\nimport { AiProvider } from \"@workglow/ai\";\nimport { createCloudProviderClass } from \"@workglow/ai/provider-utils\";\nimport { inferOpenAiCapabilities, openAiWorkerRunFnSpecs } from \"./common/OpenAI_Capabilities\";\nimport { OPENAI } from \"./common/OpenAI_Constants\";\nimport type { OpenAiModelConfig } from \"./common/OpenAI_ModelSchema\";\n\n/**\n * Main-thread registration shell for OpenAI. Used both for inline mode\n * (constructed with the run-fn registrations array) and worker-backed mode\n * (constructed empty so the base class registers worker proxies). No queue\n * is created — OpenAI uses {@link DirectExecutionStrategy}.\n */\nexport class OpenAiQueuedProvider extends createCloudProviderClass<OpenAiModelConfig>(AiProvider, {\n  name: OPENAI,\n  displayName: \"OpenAI\",\n}) {\n  override inferCapabilities(model: ModelRecord): readonly Capability[] {\n    return inferOpenAiCapabilities(model);\n  }\n\n  protected override workerRunFnSpecs(): readonly { serves: readonly Capability[] }[] {\n    return openAiWorkerRunFnSpecs();\n  }\n}\n",
-    "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { Capability } from \"@workglow/ai/worker\";\n\n/**\n * Single source of truth for OpenAI's capability sets.\n *\n * Both `OPENAI_RUN_FNS` (the worker-side registration list) and\n * `workerRunFnSpecs()` (the main-thread proxy declaration) derive their\n * `serves` arrays from these named exports. SDK-free so the main thread\n * can import without paying the OpenAI client cost.\n *\n * To add a new capability set: declare a new `as const` constant here,\n * then reference it from both `OPENAI_RUN_FNS` and `OPENAI_RUN_FN_SPECS`.\n */\nexport const OPENAI_TEXT_GENERATION = [\"text.generation\"] as const satisfies Capability[];\nexport const OPENAI_TOOL_USE = [\"text.generation\", \"tool-use\"] as const satisfies Capability[];\nexport const OPENAI_JSON_MODE = [\"text.generation\", \"json-mode\"] as const satisfies Capability[];\nexport const OPENAI_TEXT_REWRITER = [\"text.rewriter\"] as const satisfies Capability[];\nexport const OPENAI_TEXT_SUMMARY = [\"text.summary\"] as const satisfies Capability[];\nexport const OPENAI_TEXT_EMBEDDING = [\"text.embedding\"] as const satisfies Capability[];\nexport const OPENAI_IMAGE_GENERATION = [\"image.generation\"] as const satisfies Capability[];\nexport const OPENAI_IMAGE_EDITING = [\"image.editing\"] as const satisfies Capability[];\nexport const OPENAI_COUNT_TOKENS = [\"model.count-tokens\"] as const satisfies Capability[];\nexport const OPENAI_MODEL_SEARCH = [\"model.search\"] as const satisfies Capability[];\nexport const OPENAI_MODEL_INFO = [\"model.info\"] as const satisfies Capability[];\n\n/** Aggregated list — for `workerRunFnSpecs()` derivation. Order MUST match `OPENAI_RUN_FNS`. */\nexport const OPENAI_CAPABILITY_SETS = [\n  OPENAI_TEXT_GENERATION,\n  OPENAI_TOOL_USE,\n  OPENAI_JSON_MODE,\n  OPENAI_TEXT_REWRITER,\n  OPENAI_TEXT_SUMMARY,\n  OPENAI_TEXT_EMBEDDING,\n  OPENAI_IMAGE_GENERATION,\n  OPENAI_IMAGE_EDITING,\n  OPENAI_COUNT_TOKENS,\n  OPENAI_MODEL_SEARCH,\n  OPENAI_MODEL_INFO,\n] as const;\n",
-    "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { Capability, ModelRecord } from \"@workglow/ai/worker\";\nimport { OPENAI_CAPABILITY_SETS } from \"./OpenAI_CapabilitySets\";\n\n/**\n * Closed list of capability-set specs the OpenAI provider serves. Derived\n * from {@link OPENAI_CAPABILITY_SETS}. Used by the main-thread provider\n * shells when registering worker-mode proxies so the dispatcher can route\n * requests to the worker proxy.\n */\nexport const OPENAI_RUN_FN_SPECS = OPENAI_CAPABILITY_SETS.map((serves) => ({ serves }));\n\nexport function openAiWorkerRunFnSpecs(): readonly { readonly serves: readonly Capability[] }[] {\n  return OPENAI_RUN_FN_SPECS;\n}\n\n/**\n * Shape used by the model-name regexes — `model_id` is required, the rest\n * is loosely-typed metadata only used to opportunistically widen the\n * inferred capability set.\n */\ntype CapabilityHints = Pick<ModelRecord, \"model_id\" | \"provider_config\" | \"capabilities\">;\n\n/**\n * Heuristic capability inference for an OpenAI {@link ModelRecord}. Pattern-\n * matches the canonical OpenAI model id strings (and the `provider_config.\n * model_name` if present) to a closed set of {@link Capability}s. Falls back\n * to the model's stored `capabilities` array (or a baseline of search +\n * info) when no pattern matches.\n *\n * Main-thread method only — workers do not run capability inference.\n */\nexport function inferOpenAiCapabilities(model: CapabilityHints): readonly Capability[] {\n  const id = String(\n    model.model_id ??\n      (model.provider_config as { model_name?: string } | undefined)?.model_name ??\n      \"\"\n  );\n\n  // Embedding models — text-embedding-3-{small,large}, text-embedding-ada-002.\n  if (/^text-embedding/i.test(id)) {\n    return [\"text.embedding\", \"model.count-tokens\", \"model.info\", \"model.search\"];\n  }\n\n  // Image models — DALL-E and gpt-image families.\n  if (/^dall-e/i.test(id)) {\n    // DALL-E 2/3 do NOT support edit consistently — gpt-image-* does. Cover\n    // generation only here; the gpt-image branch below adds editing.\n    return [\"image.generation\", \"model.info\", \"model.search\"];\n  }\n  if (/^gpt-image/i.test(id)) {\n    return [\"image.generation\", \"image.editing\", \"model.info\", \"model.search\"];\n  }\n\n  // Chat / reasoning models — gpt-3.5/4/4o/5/...; o-series reasoning models (o1, o3, o4, future).\n  // GPT-4o, gpt-4-vision-*, gpt-4-turbo, and all o-series additionally accept image inputs.\n  if (/^gpt-/i.test(id) || /^o\\d/i.test(id)) {\n    const caps: Capability[] = [\n      \"text.generation\",\n      \"text.rewriter\",\n      \"text.summary\",\n      \"tool-use\",\n      \"json-mode\",\n      \"model.count-tokens\",\n      \"model.info\",\n      \"model.search\",\n    ];\n    const supportsVision =\n      /gpt-4o|gpt-4\\.1|gpt-5|gpt-4-vision|gpt-4-turbo/i.test(id) || /^o\\d/i.test(id);\n    if (supportsVision) {\n      caps.push(\"vision-input\");\n    }\n    return caps;\n  }\n\n  // Unknown model — fall back to whatever the record declared, or just\n  // expose the meta-ops so the model can still be searched / inspected.\n  const declared = (model.capabilities as readonly Capability[] | undefined) ?? [];\n  if (declared.length > 0) return declared;\n  return [\"model.search\", \"model.info\"];\n}\n",
+    "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { Capability } from \"@workglow/ai/worker\";\n\n/**\n * Single source of truth for OpenAI's capability sets.\n *\n * Both `OPENAI_RUN_FNS` (the worker-side registration list) and\n * `workerRunFnSpecs()` (the main-thread proxy declaration) derive their\n * `serves` arrays from these named exports. SDK-free so the main thread\n * can import without paying the OpenAI client cost.\n *\n * To add a new capability set: declare a new `as const` constant here,\n * then reference it from both `OPENAI_RUN_FNS` and `OPENAI_RUN_FN_SPECS`.\n */\nexport const OPENAI_TEXT_GENERATION = [\"text.generation\"] as const satisfies Capability[];\nexport const OPENAI_TOOL_USE = [\"text.generation\", \"tool-use\"] as const satisfies Capability[];\nexport const OPENAI_JSON_MODE = [\"text.generation\", \"json-mode\"] as const satisfies Capability[];\nexport const OPENAI_TEXT_REWRITER = [\"text.rewriter\"] as const satisfies Capability[];\nexport const OPENAI_TEXT_SUMMARY = [\"text.summary\"] as const satisfies Capability[];\nexport const OPENAI_TEXT_EMBEDDING = [\"text.embedding\"] as const satisfies Capability[];\nexport const OPENAI_IMAGE_GENERATION = [\"image.generation\"] as const satisfies Capability[];\nexport const OPENAI_IMAGE_EDITING = [\"image.editing\"] as const satisfies Capability[];\nexport const OPENAI_COUNT_TOKENS = [\"model.count-tokens\"] as const satisfies Capability[];\nexport const OPENAI_MODEL_SEARCH = [\"model.search\"] as const satisfies Capability[];\nexport const OPENAI_MODEL_INFO = [\"model.info\"] as const satisfies Capability[];\nexport const OPENAI_CACHE_CHECKPOINT = [\"cache.checkpoint\"] as const satisfies Capability[];\n\n/** Aggregated list — for `workerRunFnSpecs()` derivation. Order MUST match `OPENAI_RUN_FNS`. */\nexport const OPENAI_CAPABILITY_SETS = [\n  OPENAI_TEXT_GENERATION,\n  OPENAI_TOOL_USE,\n  OPENAI_JSON_MODE,\n  OPENAI_TEXT_REWRITER,\n  OPENAI_TEXT_SUMMARY,\n  OPENAI_TEXT_EMBEDDING,\n  OPENAI_IMAGE_GENERATION,\n  OPENAI_IMAGE_EDITING,\n  OPENAI_COUNT_TOKENS,\n  OPENAI_MODEL_SEARCH,\n  OPENAI_MODEL_INFO,\n  OPENAI_CACHE_CHECKPOINT,\n] as const;\n",
+    "/**\n * @license\n * Copyright 2026 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { Capability, ModelRecord } from \"@workglow/ai/worker\";\nimport { OPENAI_CAPABILITY_SETS } from \"./OpenAI_CapabilitySets\";\n\n/**\n * Closed list of capability-set specs the OpenAI provider serves. Derived\n * from {@link OPENAI_CAPABILITY_SETS}. Used by the main-thread provider\n * shells when registering worker-mode proxies so the dispatcher can route\n * requests to the worker proxy.\n */\nexport const OPENAI_RUN_FN_SPECS = OPENAI_CAPABILITY_SETS.map((serves) => ({ serves }));\n\nexport function openAiWorkerRunFnSpecs(): readonly { readonly serves: readonly Capability[] }[] {\n  return OPENAI_RUN_FN_SPECS;\n}\n\n/**\n * Shape used by the model-name regexes — `model_id` is required, the rest\n * is loosely-typed metadata only used to opportunistically widen the\n * inferred capability set.\n */\ntype CapabilityHints = Pick<ModelRecord, \"model_id\" | \"provider_config\" | \"capabilities\">;\n\n/**\n * Heuristic capability inference for an OpenAI {@link ModelRecord}. Pattern-\n * matches the canonical OpenAI model id strings (and the `provider_config.\n * model_name` if present) to a closed set of {@link Capability}s. Falls back\n * to the model's stored `capabilities` array (or a baseline of search +\n * info) when no pattern matches.\n *\n * Main-thread method only — workers do not run capability inference.\n */\nexport function inferOpenAiCapabilities(model: CapabilityHints): readonly Capability[] {\n  const id = String(\n    model.model_id ??\n      (model.provider_config as { model_name?: string } | undefined)?.model_name ??\n      \"\"\n  );\n\n  // Embedding models — text-embedding-3-{small,large}, text-embedding-ada-002.\n  if (/^text-embedding/i.test(id)) {\n    return [\"text.embedding\", \"model.count-tokens\", \"model.info\", \"model.search\"];\n  }\n\n  // Image models — DALL-E and gpt-image families.\n  if (/^dall-e/i.test(id)) {\n    // DALL-E 2/3 do NOT support edit consistently — gpt-image-* does. Cover\n    // generation only here; the gpt-image branch below adds editing.\n    return [\"image.generation\", \"model.info\", \"model.search\"];\n  }\n  if (/^gpt-image/i.test(id)) {\n    return [\"image.generation\", \"image.editing\", \"model.info\", \"model.search\"];\n  }\n\n  // Chat / reasoning models — gpt-3.5/4/4o/5/...; o-series reasoning models (o1, o3, o4, future).\n  // GPT-4o, gpt-4-vision-*, gpt-4-turbo, and all o-series additionally accept image inputs.\n  if (/^gpt-/i.test(id) || /^o\\d/i.test(id)) {\n    const caps: Capability[] = [\n      \"text.generation\",\n      \"text.rewriter\",\n      \"text.summary\",\n      \"tool-use\",\n      \"json-mode\",\n      \"cache.checkpoint\",\n      \"model.count-tokens\",\n      \"model.info\",\n      \"model.search\",\n    ];\n    const supportsVision =\n      /gpt-4o|gpt-4\\.1|gpt-5|gpt-4-vision|gpt-4-turbo/i.test(id) || /^o\\d/i.test(id);\n    if (supportsVision) {\n      caps.push(\"vision-input\");\n    }\n    return caps;\n  }\n\n  // Unknown model — fall back to whatever the record declared, or just\n  // expose the meta-ops so the model can still be searched / inspected.\n  const declared = (model.capabilities as readonly Capability[] | undefined) ?? [];\n  if (declared.length > 0) return declared;\n  return [\"model.search\", \"model.info\"];\n}\n",
     "/**\n * @license\n * Copyright 2025 Steven Roussey <sroussey@gmail.com>\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport type { ModelConfig } from \"@workglow/ai\";\nimport { AiImageOutputTask, ProviderUnsupportedFeatureError } from \"@workglow/ai\";\n\nimport { OPENAI } from \"./OpenAI_Constants\";\n\n/**\n * Registers the OpenAI per-provider image validator. Called at provider registration time\n * (both inline and worker-backed paths) so it runs on the main thread before any dispatch.\n *\n * Currently validates:\n * - DALL-E 2 + non-empty `additionalImages` → throws (single-image edit only).\n *   DALL-E 3 + ImageEditTask is rejected upstream by the model registry task-array check.\n */\nexport function registerOpenAiImageValidator(): void {\n  AiImageOutputTask.registerProviderImageValidator(\n    OPENAI,\n    (taskType, input, model: ModelConfig) => {\n      if (taskType !== \"ImageEditTask\") return;\n      const modelName =\n        (model.provider_config as { model_name?: string } | undefined)?.model_name ?? \"\";\n      const additional = input[\"additionalImages\"] as unknown[] | undefined;\n      if (modelName.startsWith(\"dall-e-2\") && Array.isArray(additional) && additional.length > 0) {\n        throw new ProviderUnsupportedFeatureError(\n          \"additionalImages\",\n          model.model_id ?? modelName,\n          \"DALL-E 2 only supports single-image edits\"\n        );\n      }\n    }\n  );\n}\n"
   ],
-  "mappings": ";;;;;;;;;AAMA;AAOO,IAAM,uBAA0C,CAAC,kBAAkB,mBAAmB;AAI7F,IAAI;AAGJ,eAAsB,aAAa,GAA+B;AAAA,EAChE,iBAA2C,iBAExC,KAAK,CAAC,QAAQ,IAAI,OAA4B,EAC9C,MAAM,MAAM;AAAA,IACX,eAAe;AAAA,IACf,MAAM,IAAI,MAAM,sEAAsE;AAAA,GACvF;AAAA,EACH,OAAO;AAAA;AAmBT,eAAsB,SAAS,CAAC,OAAsC;AAAA,EACpE,MAAM,SAAS,MAAM,cAAc;AAAA,EACnC,MAAM,SAAS,OAAO;AAAA,EACtB,MAAM,SAAS,cAAc;AAAA,IAC3B;AAAA,IACA,QAAQ;AAAA,IACR,eAAe;AAAA,EACjB,CAAC;AAAA,EAGD,MAAM,UAAU,wBAAwB,QAAQ,UAAU;AAAA,IACxD,QAAQ;AAAA,IACR,YAAY;AAAA,IACZ,gBAAgB,QAAQ;AAAA,IACxB,eAAe;AAAA,EACjB,CAAC;AAAA,EACD,IAAI;AAAA,IACF,OAAO,IAAI,OAAO;AAAA,MAChB;AAAA,MACA;AAAA,MACA,cAAc,QAAQ,gBAAgB;AAAA,MACtC,yBAAyB,cAAc;AAAA,IACzC,CAAC;AAAA,IACD,OAAO,KAAK;AAAA,IACZ,MAAM,IAAI,MACR,mCAAmC,eAAe,QAAQ,IAAI,UAAU,iBAC1E;AAAA;AAAA;AAIG,SAAS,YAAY,CAAC,OAA8C;AAAA,EACzE,MAAM,OAAO,OAAO,iBAAiB;AAAA,EACrC,IAAI,CAAC,MAAM;AAAA,IACT,MAAM,IAAI,MAAM,mDAAmD;AAAA,EACrE;AAAA,EACA,OAAO;AAAA;AASF,SAAS,kBAAkB,CAChC,OACgD;AAAA,EAChD,MAAM,YAAa,OAAO,iBAAwD;AAAA,EAClF,IAAI,CAAC,aAAc,UAAU,WAAW,aAAa,UAAU,SAAS,WAAY;AAAA,IAClF;AAAA,EACF;AAAA,EACA,OAAO;AAAA;AAIT,SAAS,QAAQ,CAAC,OAAuB;AAAA,EACvC,IAAI,OAAO;AAAA,EACX,SAAS,IAAI,EAAG,IAAI,MAAM,QAAQ,KAAK;AAAA,IACrC,QAAQ,MAAM,WAAW,CAAC;AAAA,IAC1B,OAAO,KAAK,KAAK,MAAM,QAAU;AAAA,EACnC;AAAA,EACA,QAAQ,SAAS,GAAG,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG;AAAA;AAW3C,SAAS,qBAAqB,CACnC,OACA,QACQ;AAAA,EACR,MAAM,WAAY,OAAO,iBAAwD;AAAA,EACjF,IAAI;AAAA,IAAU,OAAO;AAAA,EACrB,MAAM,WAAW,KAAK,UAAU;AAAA,IAC9B,OAAO,SAAS;AAAA,IAChB,OAAO,gBAAgB;AAAA,IACvB,OAAO,SAAS;AAAA,EAClB,CAAC;AAAA,EACD,OAAO,MAAM,SAAS,QAAQ;AAAA;AAUzB,SAAS,wBAAwB,CACtC,OACA,QACyB;AAAA,EACzB,MAAM,YAAY,mBAAmB,KAAK;AAAA,EAC1C,IAAI,cAAc;AAAA,IAAW,OAAO,YAAY;AAAA,EAChD,OAAO,mBAAmB,sBAAsB,OAAO,MAAM;AAAA,EAC7D,OAAO;AAAA;;AC7IF,IAAM,SAAS;;ACAtB;AAIO,IAAM,oBAAoB;AAAA,EAC/B,MAAM;AAAA,EACN,YAAY;AAAA,IACV,UAAU;AAAA,MACR,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,iBAAiB;AAAA,MACf,MAAM;AAAA,MACN,aAAa;AAAA,MACb,YAAY;AAAA,QACV,YAAY;AAAA,UACV,MAAM;AAAA,UACN,aAAa;AAAA,QACf;AAAA,QACA,gBAAgB;AAAA,UACd,MAAM;AAAA,UACN,QAAQ;AAAA,UACR,aAAa;AAAA,UACb,eAAe;AAAA,QACjB;AAAA,QACA,UAAU;AAAA,UACR,MAAM;AAAA,UACN,aAAa;AAAA,UACb,SAAS;AAAA,QACX;AAAA,QACA,gBAAgB;AAAA,UACd,MAAM;AAAA,UACN,aACE;AAAA,UACF,SAAS;AAAA,UACT,eAAe;AAAA,QACjB;AAAA,QACA,cAAc;AAAA,UACZ,MAAM;AAAA,UACN,aAAa;AAAA,QACf;AAAA,QACA,kBAAkB;AAAA,UAChB,MAAM;AAAA,UACN,aACE;AAAA,UACF,eAAe;AAAA,QACjB;AAAA,QACA,WAAW;AAAA,UACT,MAAM;AAAA,UACN,aACE;AAAA,UACF,YAAY;AAAA,YACV,QAAQ;AAAA,cACN,MAAM;AAAA,cACN,MAAM,CAAC,QAAQ,WAAW,OAAO,UAAU,QAAQ,SAAS,KAAK;AAAA,cACjE,aAAa;AAAA,YACf;AAAA,YACA,MAAM;AAAA,cACJ,MAAM;AAAA,cACN,MAAM,CAAC,KAAK;AAAA,cACZ,aACE;AAAA,YACJ;AAAA,UACF;AAAA,UACA,sBAAsB;AAAA,QACxB;AAAA,MACF;AAAA,MACA,UAAU,CAAC,YAAY;AAAA,MACvB,sBAAsB;AAAA,IACxB;AAAA,EACF;AAAA,EACA,UAAU,CAAC,YAAY,iBAAiB;AAAA,EACxC,sBAAsB;AACxB;AAEO,IAAM,0BAA0B;AAAA,EACrC,MAAM;AAAA,EACN,YAAY;AAAA,OACP,kBAAkB;AAAA,OAClB,kBAAkB;AAAA,EACvB;AAAA,EACA,UAAU,CAAC,GAAG,kBAAkB,UAAU,GAAG,kBAAkB,QAAQ;AAAA,EACvE,sBAAsB;AACxB;AAIO,IAAM,0BAA0B;AAAA,EACrC,MAAM;AAAA,EACN,YAAY;AAAA,OACP,kBAAkB;AAAA,OAClB,kBAAkB;AAAA,EACvB;AAAA,EACA,UAAU,CAAC,GAAG,kBAAkB,UAAU,GAAG,kBAAkB,QAAQ;AAAA,EACvE,sBAAsB;AACxB;;AC9FA;;;ACAA;AACA;;;ACWO,IAAM,yBAAyB,CAAC,iBAAiB;AACjD,IAAM,kBAAkB,CAAC,mBAAmB,UAAU;AACtD,IAAM,mBAAmB,CAAC,mBAAmB,WAAW;AACxD,IAAM,uBAAuB,CAAC,eAAe;AAC7C,IAAM,sBAAsB,CAAC,cAAc;AAC3C,IAAM,wBAAwB,CAAC,gBAAgB;AAC/C,IAAM,0BAA0B,CAAC,kBAAkB;AACnD,IAAM,uBAAuB,CAAC,eAAe;AAC7C,IAAM,sBAAsB,CAAC,oBAAoB;AACjD,IAAM,sBAAsB,CAAC,cAAc;AAC3C,IAAM,oBAAoB,CAAC,YAAY;AAGvC,IAAM,yBAAyB;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;;;AC7BO,IAAM,sBAAsB,uBAAuB,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE;AAE/E,SAAS,sBAAsB,GAA0D;AAAA,EAC9F,OAAO;AAAA;AAmBF,SAAS,uBAAuB,CAAC,OAA+C;AAAA,EACrF,MAAM,KAAK,OACT,MAAM,YACH,MAAM,iBAAyD,cAChE,EACJ;AAAA,EAGA,IAAI,mBAAmB,KAAK,EAAE,GAAG;AAAA,IAC/B,OAAO,CAAC,kBAAkB,sBAAsB,cAAc,cAAc;AAAA,EAC9E;AAAA,EAGA,IAAI,WAAW,KAAK,EAAE,GAAG;AAAA,IAGvB,OAAO,CAAC,oBAAoB,cAAc,cAAc;AAAA,EAC1D;AAAA,EACA,IAAI,cAAc,KAAK,EAAE,GAAG;AAAA,IAC1B,OAAO,CAAC,oBAAoB,iBAAiB,cAAc,cAAc;AAAA,EAC3E;AAAA,EAIA,IAAI,SAAS,KAAK,EAAE,KAAK,QAAQ,KAAK,EAAE,GAAG;AAAA,IACzC,MAAM,OAAqB;AAAA,MACzB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,MAAM,iBACJ,kDAAkD,KAAK,EAAE,KAAK,QAAQ,KAAK,EAAE;AAAA,IAC/E,IAAI,gBAAgB;AAAA,MAClB,KAAK,KAAK,cAAc;AAAA,IAC1B;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EAIA,MAAM,WAAY,MAAM,gBAAsD,CAAC;AAAA,EAC/E,IAAI,SAAS,SAAS;AAAA,IAAG,OAAO;AAAA,EAChC,OAAO,CAAC,gBAAgB,YAAY;AAAA;;;AFjE/B,MAAM,6BAA6B,yBAA4C,YAAY;AAAA,EAChG,MAAM;AAAA,EACN,aAAa;AACf,CAAC,EAAE;AAAA,EACQ,iBAAiB,CAAC,OAA2C;AAAA,IACpE,OAAO,wBAAwB,KAAK;AAAA;AAAA,EAGnB,gBAAgB,GAAiD;AAAA,IAClF,OAAO,uBAAuB;AAAA;AAElC;;;AGvBA;AAYO,SAAS,4BAA4B,GAAS;AAAA,EACnD,kBAAkB,+BAChB,QACA,CAAC,UAAU,OAAO,UAAuB;AAAA,IACvC,IAAI,aAAa;AAAA,MAAiB;AAAA,IAClC,MAAM,YACH,MAAM,iBAAyD,cAAc;AAAA,IAChF,MAAM,aAAa,MAAM;AAAA,IACzB,IAAI,UAAU,WAAW,UAAU,KAAK,MAAM,QAAQ,UAAU,KAAK,WAAW,SAAS,GAAG;AAAA,MAC1F,MAAM,IAAI,gCACR,oBACA,MAAM,YAAY,WAClB,2CACF;AAAA,IACF;AAAA,GAEJ;AAAA;;;AJxBF,eAAsB,cAAc,CAClC,SAGe;AAAA,EACf,6BAA6B;AAAA,EAC7B,MAAM,2BAA2B,IAAI,sBAAwB,UAAU,OAAO;AAAA;",
-  "debugId": "C8884DFB1694D07E64756E2164756E21",
+  "mappings": "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",
+  "debugId": "63C2F7EB0BD183BC64756E2164756E21",
   "names": []
 }

package/dist/ai.js

@@ -7,7 +7,16 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // src/ai/common/OpenAI_Client.ts
+import { isModelEffort } from "@workglow/ai";
 import { isBrowserLike, resolveApiKey, validateProviderBaseUrl } from "@workglow/ai/provider-utils";
+var EFFORT_TO_OPENAI = {
+  none: "none",
+  low: "low",
+  medium: "medium",
+  high: "high",
+  extra: "xhigh",
+  ultra: "max"
+};
 var OPENAI_ALLOWED_HOSTS = ["api.openai.com", ".openai.azure.com"];
 var _loadPromise;
 async function loadOpenAISDK() {
@@ -17,7 +26,16 @@ async function loadOpenAISDK() {
   });
   return _loadPromise;
 }
+var _testClient;
+function setOpenAIClientForTests(client) {
+  _testClient = client;
+}
+var _testOnly = {
+  setOpenAIClientForTests
+};
 async function getClient(model) {
+  if (_testClient)
+    return _testClient;
   const OpenAI = await loadOpenAISDK();
   const config = model?.provider_config;
   const apiKey = resolveApiKey({
@@ -51,10 +69,13 @@ function getModelName(model) {
 }
 function getReasoningConfig(model) {
   const reasoning = model?.provider_config?.reasoning;
-  if (!reasoning || reasoning.effort === undefined && reasoning.mode === undefined) {
-    return;
+  if (reasoning && (reasoning.effort !== undefined || reasoning.mode !== undefined)) {
+    return reasoning;
   }
-  return reasoning;
+  if (isModelEffort(model?.effort)) {
+    return { effort: EFFORT_TO_OPENAI[model.effort] };
+  }
+  return;
 }
 function fnv1aHex(input) {
   let hash = 2166136261;
@@ -79,6 +100,8 @@ function finalizeResponsesRequest(model, params) {
   const reasoning = getReasoningConfig(model);
   if (reasoning !== undefined)
     params.reasoning = reasoning;
+  else if (params.temperature !== undefined)
+    params.reasoning = { effort: "none" };
   params.prompt_cache_key = resolvePromptCacheKey(model, params);
   return params;
 }
@@ -275,6 +298,7 @@ var OPENAI_IMAGE_EDITING = ["image.editing"];
 var OPENAI_COUNT_TOKENS = ["model.count-tokens"];
 var OPENAI_MODEL_SEARCH = ["model.search"];
 var OPENAI_MODEL_INFO = ["model.info"];
+var OPENAI_CACHE_CHECKPOINT = ["cache.checkpoint"];
 var OPENAI_CAPABILITY_SETS = [
   OPENAI_TEXT_GENERATION,
   OPENAI_TOOL_USE,
@@ -286,7 +310,8 @@ var OPENAI_CAPABILITY_SETS = [
   OPENAI_IMAGE_EDITING,
   OPENAI_COUNT_TOKENS,
   OPENAI_MODEL_SEARCH,
-  OPENAI_MODEL_INFO
+  OPENAI_MODEL_INFO,
+  OPENAI_CACHE_CHECKPOINT
 ];
 
 // src/ai/common/OpenAI_Capabilities.ts
@@ -312,6 +337,7 @@ function inferOpenAiCapabilities(model) {
       "text.summary",
       "tool-use",
       "json-mode",
+      "cache.checkpoint",
       "model.count-tokens",
       "model.info",
       "model.search"
@@ -346,6 +372,54 @@ async function registerOpenAi(options) {
   registerOpenAiImageValidator();
   await registerProviderWithWorker(new OpenAiQueuedProvider, "OpenAI", options);
 }
+// src/ai/common/OpenAI_CacheCheckpoint.ts
+import {
+  buildResponsesInput,
+  buildResponsesTools,
+  mapOpenAIResponsesUsage
+} from "@workglow/ai/provider-utils";
+import { promptToTailMessages, toOpenAIMessages } from "@workglow/ai/worker";
+function mergeOpenAICheckpointPrefix(session, input) {
+  const prefix = session?.prefix;
+  if (!prefix)
+    return;
+  const tail = Array.isArray(input.messages) && input.messages.length > 0 ? input.messages : promptToTailMessages(input.prompt);
+  return {
+    messages: [...prefix.messages ?? [], ...tail],
+    systemPrompt: input.systemPrompt || prefix.systemPrompt,
+    tools: input.tools && input.tools.length > 0 ? input.tools : prefix.tools
+  };
+}
+var OpenAI_CacheCheckpoint_Stream = async (_input, model, signal, emit, _outputSchema, session) => {
+  const prefix = session?.prefix ?? {};
+  const client = await getClient(model);
+  const messages = toOpenAIMessages({
+    messages: prefix.messages ?? [],
+    systemPrompt: prefix.systemPrompt,
+    prompt: ".",
+    tools: []
+  });
+  const { input: responsesInput, instructions } = buildResponsesInput({ messages });
+  const params = {
+    model: getModelName(model),
+    input: responsesInput,
+    max_output_tokens: 16
+  };
+  if (instructions !== undefined)
+    params.instructions = instructions;
+  if (prefix.tools && prefix.tools.length > 0) {
+    params.tools = buildResponsesTools(prefix.tools);
+  }
+  finalizeResponsesRequest(model, params);
+  const response = await client.responses.create(params, { signal });
+  const usage = mapOpenAIResponsesUsage(response?.usage);
+  emit({
+    type: "finish",
+    data: { checkpoint: session?.sessionId ?? "" },
+    ...usage ? { usage } : {}
+  });
+};
+
 // src/ai/common/OpenAI_CountTokens.ts
 var _tiktoken;
 async function loadTiktoken() {
@@ -563,13 +637,54 @@ var OPENAI_EMBEDDING_DIMENSIONS = {
   "text-embedding-3-large": { native_dimensions: 3072, mrl: true },
   "text-embedding-ada-002": { native_dimensions: 1536, mrl: false }
 };
-var OpenAI_ModelInfo_Stream = async (input, model, _signal, emit) => {
+function modelNameOf(model) {
+  const name = model?.provider_config?.model_name;
+  if (!name) {
+    throw new Error("Missing model name in provider_config.model_name.");
+  }
+  return name;
+}
+function isNotFoundError(err) {
+  if (!err || typeof err !== "object")
+    return false;
+  const status = err.status;
+  const code = err.code;
+  const statusCode = err.statusCode;
+  return status === 404 || statusCode === 404 || code === "model_not_found";
+}
+async function assertOpenAiModelExists(model, signal) {
+  const modelName = modelNameOf(model);
+  const client = await getClient(model);
+  try {
+    await client.models.retrieve(modelName, signal ? { signal } : undefined);
+  } catch (err) {
+    if (isNotFoundError(err)) {
+      throw new Error(`${OPENAI} model "${modelName}" was not found (provider API returned not found)`);
+    }
+    throw err;
+  }
+  return modelName;
+}
+function remoteInfoBase(input) {
+  return {
+    model: input.model,
+    is_local: false,
+    is_remote: true,
+    supports_browser: true,
+    supports_node: true,
+    is_cached: false,
+    is_loaded: false,
+    file_sizes: null
+  };
+}
+var OpenAI_ModelInfo_Stream = async (input, model, signal, emit) => {
+  const modelName = await assertOpenAiModelExists(model, signal);
+  const base = remoteInfoBase(input);
   if (input.detail === "dimensions") {
     const pc = model?.provider_config;
     let native_dimensions = typeof pc?.native_dimensions === "number" ? pc.native_dimensions : undefined;
     let mrl = typeof pc?.mrl === "boolean" ? pc.mrl : undefined;
     if (native_dimensions === undefined) {
-      const modelName = pc?.model_name ?? "";
       const known = OPENAI_EMBEDDING_DIMENSIONS[modelName];
       if (known) {
         native_dimensions = known.native_dimensions;
@@ -579,38 +694,24 @@ var OpenAI_ModelInfo_Stream = async (input, model, _signal, emit) => {
     emit({
       type: "finish",
       data: {
-        model: input.model,
-        is_local: false,
-        is_remote: true,
-        supports_browser: true,
-        supports_node: true,
-        is_cached: false,
-        is_loaded: false,
-        file_sizes: null,
+        ...base,
         ...native_dimensions !== undefined ? { native_dimensions } : {},
         ...mrl !== undefined ? { mrl } : {}
       }
     });
     return;
   }
-  emit({
-    type: "finish",
-    data: {
-      model: input.model,
-      is_local: false,
-      is_remote: true,
-      supports_browser: true,
-      supports_node: true,
-      is_cached: false,
-      is_loaded: false,
-      file_sizes: null
-    }
-  });
+  emit({ type: "finish", data: base });
 };
 
 // src/ai/common/OpenAI_StructuredGeneration.ts
-import { firstNonStrictReason, isStrictCompatibleSchema } from "@workglow/ai/provider-utils";
-import { parsePartialJson } from "@workglow/util/worker";
+import {
+  createEstimatedOutputUsageReporter,
+  firstNonStrictReason,
+  isStrictCompatibleSchema,
+  mapOpenAIResponsesUsage as mapOpenAIResponsesUsage2
+} from "@workglow/ai/provider-utils";
+import { createPartialJsonStream } from "@workglow/util/worker";
 
 // src/ai/common/OpenAI_ResponsesWarnings.ts
 import { getLogger } from "@workglow/util/worker";
@@ -661,15 +762,20 @@ var OpenAI_StructuredGeneration_Stream = async (input, model, signal, emit, outp
   if (input.temperature !== undefined)
     params.temperature = input.temperature;
   finalizeResponsesRequest(model, params);
+  const provisionalUsage = createEstimatedOutputUsageReporter(emit);
+  provisionalUsage.onPrompt(typeof input.prompt === "string" ? input.prompt : "");
   const stream = await client.responses.create({ ...params, stream: true }, { signal });
-  let accumulatedJson = "";
+  const json = createPartialJsonStream();
   let refusal = "";
+  let usage;
   for await (const event of stream) {
-    if (event.type === "response.output_text.delta") {
+    if (event.type === "response.completed" || event.type === "response.incomplete" || event.type === "response.failed") {
+      usage = mapOpenAIResponsesUsage2(event.response?.usage) ?? usage;
+    } else if (event.type === "response.output_text.delta") {
       const delta = event.delta ?? "";
       if (delta) {
-        accumulatedJson += delta;
-        const partial = parsePartialJson(accumulatedJson);
+        provisionalUsage.onText(delta);
+        const partial = json.push(delta);
         if (partial !== undefined) {
           emit({ type: "object-delta", port: "object", objectDelta: partial });
         }
@@ -678,19 +784,19 @@ var OpenAI_StructuredGeneration_Stream = async (input, model, signal, emit, outp
       refusal += event.delta ?? "";
     }
   }
+  provisionalUsage.flush();
   if (refusal) {
     emit({ type: "refusal", refusal });
   }
-  let finalObject;
-  try {
-    finalObject = JSON.parse(accumulatedJson);
-  } catch {
-    finalObject = parsePartialJson(accumulatedJson) ?? {};
-  }
-  emit({ type: "finish", data: { object: finalObject } });
+  emit({
+    type: "finish",
+    data: { object: json.finishObject() },
+    usage
+  });
 };
 
 // src/ai/common/OpenAI_TextEmbedding.ts
+import { toUsageCount, usageOrUndefined } from "@workglow/ai/provider-utils";
 import { getLogger as getLogger2 } from "@workglow/util/worker";
 var OpenAI_TextEmbedding_Stream = async (input, model, signal, emit) => {
   const logger = getLogger2();
@@ -706,25 +812,41 @@ var OpenAI_TextEmbedding_Stream = async (input, model, signal, emit) => {
     const result = Array.isArray(input.text) ? {
       vector: response.data.map((item) => new Float32Array(item.embedding))
     } : { vector: new Float32Array(response.data[0].embedding) };
-    emit({ type: "finish", data: result });
+    const rawUsage = response.usage;
+    const usage = usageOrUndefined({
+      input: toUsageCount(rawUsage?.prompt_tokens),
+      output: undefined,
+      cached: undefined,
+      cacheWrite: undefined,
+      reasoning: undefined,
+      total: toUsageCount(rawUsage?.total_tokens),
+      extra: undefined
+    });
+    emit({ type: "finish", data: result, usage });
   } finally {
     logger.timeEnd(timerLabel, { model: getModelName(model) });
   }
 };
 
 // src/ai/common/OpenAI_TextGeneration.ts
-import { accumulateOpenAIResponsesStream, buildResponsesInput } from "@workglow/ai/provider-utils";
-import { toOpenAIMessages } from "@workglow/ai/worker";
+import {
+  accumulateOpenAIResponsesStream,
+  buildResponsesInput as buildResponsesInput2,
+  buildResponsesTools as buildResponsesTools2,
+  createEstimatedOutputUsageReporter as createEstimatedOutputUsageReporter2,
+  promptTextForResponsesUsageEstimate
+} from "@workglow/ai/provider-utils";
+import { toOpenAIMessages as toOpenAIMessages2 } from "@workglow/ai/worker";
 import { getLogger as getLogger3 } from "@workglow/util/worker";
 function buildResponsesParams(input, model) {
   const hasMessages = Array.isArray(input.messages) && input.messages.length > 0;
-  const messages = hasMessages ? toOpenAIMessages({
+  const messages = hasMessages ? toOpenAIMessages2({
     messages: input.messages,
     systemPrompt: input.systemPrompt,
     prompt: "",
     tools: []
   }) : undefined;
-  const { input: responsesInput, instructions } = buildResponsesInput({
+  const { input: responsesInput, instructions } = buildResponsesInput2({
     messages,
     prompt: hasMessages ? undefined : input.prompt,
     systemPrompt: hasMessages ? undefined : input.systemPrompt
@@ -750,23 +872,38 @@ function buildResponsesParams(input, model) {
   }
   return params;
 }
-var OpenAI_TextGeneration_Stream = async (input, model, signal, emit) => {
+var OpenAI_TextGeneration_Stream = async (input, model, signal, emit, _outputSchema, sessionContext) => {
   const logger = getLogger3();
   const timerLabel = `openai:TextGeneration:${getModelName(model)}`;
   logger.time(timerLabel, { model: getModelName(model) });
   try {
     const client = await getClient(model);
-    const params = finalizeResponsesRequest(model, buildResponsesParams(input, model));
+    const unified = input;
+    const merged = mergeOpenAICheckpointPrefix(sessionContext, unified);
+    const effective = merged ? { ...unified, messages: merged.messages, systemPrompt: merged.systemPrompt, prompt: "" } : unified;
+    const params = buildResponsesParams(effective, model);
+    if (merged?.tools && merged.tools.length > 0) {
+      params.tools = buildResponsesTools2(merged.tools);
+    }
+    finalizeResponsesRequest(model, params);
+    const promptText = promptTextForResponsesUsageEstimate(params);
+    createEstimatedOutputUsageReporter2(emit).onPrompt(promptText);
     const stream = await client.responses.create({ ...params, stream: true }, { signal });
-    await accumulateOpenAIResponsesStream(stream, emit);
-    emit({ type: "finish", data: {} });
+    const usage = await accumulateOpenAIResponsesStream(stream, emit, {
+      promptText
+    });
+    emit({ type: "finish", data: {}, usage });
   } finally {
     logger.timeEnd(timerLabel, { model: getModelName(model) });
   }
 };
 
 // src/ai/common/OpenAI_TextRewriter.ts
-import { accumulateOpenAIResponsesStream as accumulateOpenAIResponsesStream2 } from "@workglow/ai/provider-utils";
+import {
+  accumulateOpenAIResponsesStream as accumulateOpenAIResponsesStream2,
+  createEstimatedOutputUsageReporter as createEstimatedOutputUsageReporter3,
+  promptTextForResponsesUsageEstimate as promptTextForResponsesUsageEstimate2
+} from "@workglow/ai/provider-utils";
 var OpenAI_TextRewriter_Stream = async (input, model, signal, emit) => {
   const client = await getClient(model);
   const params = {
@@ -775,13 +912,21 @@ var OpenAI_TextRewriter_Stream = async (input, model, signal, emit) => {
     input: input.text
   };
   finalizeResponsesRequest(model, params);
+  const promptText = promptTextForResponsesUsageEstimate2(params);
+  createEstimatedOutputUsageReporter3(emit).onPrompt(promptText);
   const stream = await client.responses.create({ ...params, stream: true }, { signal });
-  await accumulateOpenAIResponsesStream2(stream, emit);
-  emit({ type: "finish", data: {} });
+  const usage = await accumulateOpenAIResponsesStream2(stream, emit, {
+    promptText
+  });
+  emit({ type: "finish", data: {}, usage });
 };
 
 // src/ai/common/OpenAI_TextSummary.ts
-import { accumulateOpenAIResponsesStream as accumulateOpenAIResponsesStream3 } from "@workglow/ai/provider-utils";
+import {
+  accumulateOpenAIResponsesStream as accumulateOpenAIResponsesStream3,
+  createEstimatedOutputUsageReporter as createEstimatedOutputUsageReporter4,
+  promptTextForResponsesUsageEstimate as promptTextForResponsesUsageEstimate3
+} from "@workglow/ai/provider-utils";
 var OpenAI_TextSummary_Stream = async (input, model, signal, emit) => {
   const client = await getClient(model);
   const params = {
@@ -790,25 +935,38 @@ var OpenAI_TextSummary_Stream = async (input, model, signal, emit) => {
     input: input.text
   };
   finalizeResponsesRequest(model, params);
+  const promptText = promptTextForResponsesUsageEstimate3(params);
+  createEstimatedOutputUsageReporter4(emit).onPrompt(promptText);
   const stream = await client.responses.create({ ...params, stream: true }, { signal });
-  await accumulateOpenAIResponsesStream3(stream, emit);
-  emit({ type: "finish", data: {} });
+  const usage = await accumulateOpenAIResponsesStream3(stream, emit, {
+    promptText
+  });
+  emit({ type: "finish", data: {}, usage });
 };
 
 // src/ai/common/OpenAI_ToolCalling.ts
 import {
   accumulateOpenAIResponsesStream as accumulateOpenAIResponsesStream4,
-  buildResponsesInput as buildResponsesInput2,
-  buildResponsesTools,
-  mapResponsesToolChoice
+  buildResponsesInput as buildResponsesInput3,
+  buildResponsesTools as buildResponsesTools3,
+  createEstimatedOutputUsageReporter as createEstimatedOutputUsageReporter5,
+  mapResponsesToolChoice,
+  promptTextForResponsesUsageEstimate as promptTextForResponsesUsageEstimate4
 } from "@workglow/ai/provider-utils";
-import { filterValidToolCalls, toOpenAIMessages as toOpenAIMessages2 } from "@workglow/ai/worker";
-var OpenAI_ToolCalling_Stream = async (input, model, signal, emit) => {
+import { filterValidToolCalls, toOpenAIMessages as toOpenAIMessages3 } from "@workglow/ai/worker";
+var OpenAI_ToolCalling_Stream = async (input, model, signal, emit, _outputSchema, sessionContext) => {
   const client = await getClient(model);
   const modelName = getModelName(model);
-  const tools = buildResponsesTools(input.tools);
-  const { input: responsesInput, instructions } = buildResponsesInput2({
-    messages: toOpenAIMessages2(input)
+  const merged = mergeOpenAICheckpointPrefix(sessionContext, input);
+  const toolDefinitions = merged?.tools ?? input.tools;
+  const tools = buildResponsesTools3(toolDefinitions);
+  const { input: responsesInput, instructions } = buildResponsesInput3({
+    messages: toOpenAIMessages3(merged ? {
+      ...input,
+      messages: merged.messages,
+      systemPrompt: merged.systemPrompt,
+      prompt: ""
+    } : input)
   });
   const toolChoice = mapResponsesToolChoice(input.toolChoice);
   const params = {
@@ -824,18 +982,20 @@ var OpenAI_ToolCalling_Stream = async (input, model, signal, emit) => {
   if (input.temperature !== undefined)
     params.temperature = input.temperature;
   finalizeResponsesRequest(model, params);
+  const promptText = promptTextForResponsesUsageEstimate4(params);
+  createEstimatedOutputUsageReporter5(emit).onPrompt(promptText);
   const stream = await client.responses.create({ ...params, stream: true }, { signal });
-  await accumulateOpenAIResponsesStream4(stream, (event) => {
+  const usage = await accumulateOpenAIResponsesStream4(stream, (event) => {
     if (event.type === "object-delta" && event.port === "toolCalls") {
-      const validated = filterValidToolCalls(event.objectDelta, input.tools);
+      const validated = filterValidToolCalls(event.objectDelta, toolDefinitions);
       if (validated.length > 0) {
         emit({ type: "object-delta", port: "toolCalls", objectDelta: validated });
       }
       return;
     }
     emit(event);
-  });
-  emit({ type: "finish", data: { text: "", toolCalls: [] } });
+  }, { promptText });
+  emit({ type: "finish", data: { text: "", toolCalls: [] }, usage });
 };
 
 // src/ai/common/OpenAI_JobRunFns.ts
@@ -850,28 +1010,31 @@ var OPENAI_RUN_FNS = [
   { serves: OPENAI_IMAGE_EDITING, runFn: OpenAI_ImageEdit_Stream },
   { serves: OPENAI_COUNT_TOKENS, runFn: OpenAI_CountTokens_Stream },
   { serves: OPENAI_MODEL_SEARCH, runFn: OpenAI_ModelSearch_Stream },
-  { serves: OPENAI_MODEL_INFO, runFn: OpenAI_ModelInfo_Stream }
+  { serves: OPENAI_MODEL_INFO, runFn: OpenAI_ModelInfo_Stream },
+  { serves: OPENAI_CACHE_CHECKPOINT, runFn: OpenAI_CacheCheckpoint_Stream }
 ];
 var OPENAI_PREVIEW_TASKS = {
   CountTokensTask: OpenAI_CountTokens_Preview
 };
 
 // src/ai/index.ts
-var _testOnly = {
+var _testOnly2 = {
   OpenAiQueuedProvider,
   OPENAI_RUN_FN_SPECS,
   OPENAI_RUN_FNS,
+  finalizeResponsesRequest,
   getReasoningConfig,
   resolvePromptCacheKey,
   isStrictCompatibleSchema,
   warnPenaltyDroppedOnce,
   warnStrictDowngradedOnce,
-  _resetOpenAIResponsesWarnings
+  _resetOpenAIResponsesWarnings,
+  setOpenAIClientForTests: _testOnly.setOpenAIClientForTests
 };
 export {
   registerOpenAiImageValidator,
   registerOpenAi,
-  _testOnly,
+  _testOnly2 as _testOnly,
   OpenAiModelSchema,
   OpenAiModelRecordSchema,
   OpenAiModelConfigSchema,
@@ -880,4 +1043,4 @@ export {
   OPENAI
 };
 
-//# debugId=5C3FAFC1792E85A564756E2164756E21
+//# debugId=9552B65D8C18B6CE64756E2164756E21