octoflow-core 1.0.0

package/dist/runtime/bridge/openai-gateway-converters.js

@@ -0,0 +1,279 @@
+import crypto from "node:crypto";
+import {
+  instructionsToPromptParts,
+  responseFormatToPromptParts,
+  toolDefinitionsToPromptParts
+} from "./openai-gateway-prompt-parts.js";
+function isRecord(value) {
+  return value != null && typeof value === "object" && !Array.isArray(value);
+}
+function optionalString(value) {
+  return typeof value === "string" ? value : void 0;
+}
+function optionalBoolean(value) {
+  return typeof value === "boolean" ? value : void 0;
+}
+function optionalContent(value) {
+  if (typeof value === "string" || value === null) return value;
+  if (!Array.isArray(value)) return void 0;
+  const parts = [];
+  for (const item of value) {
+    if (!isRecord(item) || typeof item.type !== "string") return void 0;
+    parts.push({ ...item, type: item.type });
+  }
+  return parts;
+}
+function isOpenAiRole(value) {
+  return value === "system" || value === "developer" || value === "user" || value === "assistant" || value === "tool";
+}
+function readToolCalls(value) {
+  if (!Array.isArray(value)) return void 0;
+  const calls = [];
+  for (const item of value) {
+    if (!isRecord(item)) continue;
+    const rawFn = isRecord(item.function) ? item.function : void 0;
+    const fn = rawFn ? {
+      name: optionalString(rawFn.name),
+      arguments: optionalString(rawFn.arguments)
+    } : void 0;
+    calls.push({
+      id: optionalString(item.id),
+      type: item.type === "function" ? "function" : void 0,
+      function: fn
+    });
+  }
+  return calls.length > 0 ? calls : void 0;
+}
+function normalizeOpenAiMessage(value) {
+  const role = isOpenAiRole(value.role) ? value.role : void 0;
+  const content = optionalContent(value.content);
+  const toolCalls = readToolCalls(value.tool_calls);
+  const name = optionalString(value.name);
+  const toolCallId = optionalString(value.tool_call_id);
+  if (role) {
+    return {
+      role,
+      content,
+      name,
+      tool_call_id: toolCallId,
+      tool_calls: toolCalls
+    };
+  }
+  if (content !== void 0) {
+    return { role: "user", content };
+  }
+  return null;
+}
+import {
+  embeddingFor,
+  normalizeEmbeddingInput
+} from "./openai-gateway-embeddings.js";
+function roleToBridge(role) {
+  if (role === "assistant") return "agent";
+  if (role === "tool") return "tool";
+  if (role === "system" || role === "developer") return "system";
+  return "user";
+}
+function imageUrlFromPart(part) {
+  if (part.type === "image_url") {
+    const image = part.image_url;
+    return optionalString(image) ?? (isRecord(image) ? optionalString(image.url) : void 0);
+  }
+  if (part.type === "input_image") {
+    return optionalString(part.image_url) ?? optionalString(part.file_id);
+  }
+  return void 0;
+}
+function readCacheControl(part) {
+  const raw = part.cache_control;
+  if (!isRecord(raw)) return void 0;
+  const type = optionalString(raw.type);
+  if (type === "ephemeral") {
+    const ttl = optionalString(raw.ttl);
+    if (ttl === "5m" || ttl === "1h") return { type: "ephemeral", ttl };
+    return { type: "ephemeral" };
+  }
+  if (type === "static") return { type: "static" };
+  return void 0;
+}
+function partToBridge(part) {
+  const cache = readCacheControl(part);
+  if (part.type === "text" || part.type === "input_text" || part.type === "output_text") {
+    const textValue = optionalString(part.text);
+    if (!textValue) return null;
+    const text = { kind: "text", text: textValue };
+    if (cache) text.cacheControl = cache;
+    return text;
+  }
+  const imageUrl = imageUrlFromPart(part);
+  if (imageUrl) {
+    const metadata = { sourceType: part.type };
+    if (cache) metadata.cacheControl = cache;
+    return {
+      kind: "file",
+      file: { uri: imageUrl, mimeType: "image/*" },
+      metadata
+    };
+  }
+  if (part.type === "input_audio") {
+    const audio = isRecord(part.input_audio) ? part.input_audio : void 0;
+    const data = optionalString(audio?.data) ?? optionalString(part.data);
+    const format = optionalString(audio?.format) ?? optionalString(part.format) ?? "mpeg";
+    if (!data) return null;
+    return {
+      kind: "file",
+      file: { bytes: data, mimeType: `audio/${format}` },
+      metadata: { sourceType: part.type }
+    };
+  }
+  if (part.type === "file") {
+    const file = isRecord(part.file) ? part.file : void 0;
+    const data = optionalString(file?.file_data) ?? optionalString(part.file_data);
+    const id = optionalString(file?.file_id) ?? optionalString(part.file_id);
+    return {
+      kind: "file",
+      file: {
+        name: optionalString(file?.filename),
+        bytes: data,
+        uri: id,
+        mimeType: "application/octet-stream"
+      }
+    };
+  }
+  if (part.type === "tool_use") {
+    const name = optionalString(part.name);
+    if (!name) return null;
+    return {
+      kind: "tool_call",
+      id: optionalString(part.id) ?? crypto.randomUUID(),
+      name,
+      input: part.input ?? {}
+    };
+  }
+  if (part.type === "tool_result") {
+    return {
+      kind: "tool_result",
+      callId: optionalString(part.tool_use_id) ?? "",
+      output: part.content ?? "",
+      isError: optionalBoolean(part.is_error)
+    };
+  }
+  return {
+    kind: "data",
+    data: part,
+    metadata: { contentType: part.type }
+  };
+}
+function contentToParts(content) {
+  if (typeof content === "string") {
+    return content ? [{ kind: "text", text: content }] : [];
+  }
+  if (!Array.isArray(content)) return [];
+  return content.map(partToBridge).filter((part) => part != null);
+}
+function openAiMessageToBridge(message, index) {
+  const parts = contentToParts(message.content);
+  if (message.tool_calls) {
+    for (const call of message.tool_calls) {
+      const name = call.function?.name;
+      if (!name) continue;
+      let input = {};
+      const rawArgs = call.function?.arguments;
+      if (rawArgs) {
+        try {
+          input = JSON.parse(rawArgs);
+        } catch {
+          input = rawArgs;
+        }
+      }
+      parts.push({
+        kind: "tool_call",
+        id: call.id ?? crypto.randomUUID(),
+        name,
+        input
+      });
+    }
+  }
+  if (message.role === "tool" && message.tool_call_id && !parts.some((p) => p.kind === "tool_result")) {
+    parts.push({
+      kind: "tool_result",
+      callId: message.tool_call_id,
+      output: typeof message.content === "string" ? message.content : message.content ?? ""
+    });
+  }
+  return {
+    kind: "message",
+    messageId: `openai-${index}-${crypto.randomUUID()}`,
+    role: roleToBridge(message.role),
+    parts,
+    metadata: message.name ? { name: message.name } : void 0
+  };
+}
+function inputToMessages(input) {
+  if (typeof input === "string") return [{ role: "user", content: input }];
+  if (Array.isArray(input)) {
+    return input.map((entry) => {
+      if (typeof entry === "string") {
+        return { role: "user", content: entry };
+      }
+      if (entry && typeof entry === "object") {
+        const obj = entry;
+        const normalized = normalizeOpenAiMessage(obj);
+        if (normalized) return normalized;
+      }
+      return { role: "user", content: JSON.stringify(entry) };
+    });
+  }
+  if (input && typeof input === "object") return [input];
+  return [];
+}
+function requestToBridgeMessage(body) {
+  const source = body.messages ?? inputToMessages(body.input);
+  if (source.length === 0) return "";
+  const toolPromptParts = toolDefinitionsToPromptParts(body);
+  const instructionParts = instructionsToPromptParts(body);
+  const responseFormatParts = responseFormatToPromptParts(body);
+  const prefixParts = [
+    ...instructionParts,
+    ...responseFormatParts,
+    ...toolPromptParts
+  ];
+  if (prefixParts.length === 0 && source.length === 1 && source[0]?.role === "user" && typeof source[0].content === "string") {
+    return source[0].content;
+  }
+  const parts = [...prefixParts];
+  for (const [index, message] of source.entries()) {
+    const bridge = openAiMessageToBridge(message, index);
+    const label = message.role === "developer" ? "developer" : bridge.role;
+    if (label === "system") {
+      const systemText = bridge.parts.filter((p) => p.kind === "text").map((p) => p.text).join("\n");
+      if (systemText) {
+        parts.push({ kind: "text", text: `[system]
+${systemText}` });
+      }
+      continue;
+    }
+    if (label === "developer") {
+      const developerText = bridge.parts.filter((p) => p.kind === "text").map((p) => p.text).join("\n");
+      if (developerText) {
+        parts.push({ kind: "text", text: `[developer]
+${developerText}` });
+      }
+      continue;
+    }
+    parts.push({ kind: "text", text: `[${label}]` });
+    parts.push(...bridge.parts);
+  }
+  return {
+    kind: "message",
+    messageId: `openai-${crypto.randomUUID()}`,
+    role: "user",
+    parts
+  };
+}
+export {
+  embeddingFor,
+  normalizeEmbeddingInput,
+  requestToBridgeMessage
+};
+//# sourceMappingURL=openai-gateway-converters.js.map

package/dist/runtime/bridge/openai-gateway-converters.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/openai-gateway-converters.ts"],
+  "sourcesContent": ["import crypto from 'node:crypto';\n\nimport type { CacheControl } from '../../domain/core-cache-types.js';\nimport type {\n  DataPart,\n  FilePart,\n  Message,\n  Part,\n  TextPart,\n  ToolCallPart,\n  ToolResultPart,\n} from '../../domain/core-task.js';\nimport {\n  instructionsToPromptParts,\n  type OpenAiReasoningOptions,\n  type OpenAiResponseFormat,\n  type OpenAiToolDefinition,\n  responseFormatToPromptParts,\n  toolDefinitionsToPromptParts,\n} from './openai-gateway-prompt-parts.js';\n\ntype OpenAiRole = 'system' | 'developer' | 'user' | 'assistant' | 'tool';\n\ninterface OpenAiMessage {\n  role: OpenAiRole;\n  content?: string | OpenAiContentPart[] | null;\n  name?: string;\n  tool_call_id?: string;\n  tool_calls?: Array<{\n    id?: string;\n    type?: 'function';\n    function?: { name?: string; arguments?: string };\n  }>;\n}\n\ntype OpenAiContentPart = { type: string; [key: string]: unknown };\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction optionalString(value: unknown): string | undefined {\n  return typeof value === 'string' ? value : undefined;\n}\n\nfunction optionalBoolean(value: unknown): boolean | undefined {\n  return typeof value === 'boolean' ? value : undefined;\n}\n\nfunction optionalContent(\n  value: unknown\n): OpenAiMessage['content'] | undefined {\n  if (typeof value === 'string' || value === null) return value;\n  if (!Array.isArray(value)) return undefined;\n  const parts: OpenAiContentPart[] = [];\n  for (const item of value) {\n    if (!isRecord(item) || typeof item.type !== 'string') return undefined;\n    parts.push({ ...item, type: item.type });\n  }\n  return parts;\n}\n\nfunction isOpenAiRole(value: unknown): value is OpenAiRole {\n  return (\n    value === 'system' ||\n    value === 'developer' ||\n    value === 'user' ||\n    value === 'assistant' ||\n    value === 'tool'\n  );\n}\n\nfunction readToolCalls(value: unknown): OpenAiMessage['tool_calls'] | undefined {\n  if (!Array.isArray(value)) return undefined;\n  const calls: NonNullable<OpenAiMessage['tool_calls']> = [];\n  for (const item of value) {\n    if (!isRecord(item)) continue;\n    const rawFn = isRecord(item.function) ? item.function : undefined;\n    const fn = rawFn\n      ? {\n          name: optionalString(rawFn.name),\n          arguments: optionalString(rawFn.arguments),\n        }\n      : undefined;\n    calls.push({\n      id: optionalString(item.id),\n      type: item.type === 'function' ? 'function' : undefined,\n      function: fn,\n    });\n  }\n  return calls.length > 0 ? calls : undefined;\n}\n\nfunction normalizeOpenAiMessage(value: Record<string, unknown>): OpenAiMessage | null {\n  const role = isOpenAiRole(value.role) ? value.role : undefined;\n  const content = optionalContent(value.content);\n  const toolCalls = readToolCalls(value.tool_calls);\n  const name = optionalString(value.name);\n  const toolCallId = optionalString(value.tool_call_id);\n  if (role) {\n    return {\n      role,\n      content,\n      name,\n      tool_call_id: toolCallId,\n      tool_calls: toolCalls,\n    };\n  }\n  if (content !== undefined) {\n    return { role: 'user', content };\n  }\n  return null;\n}\n\nexport interface ChatCompletionRequest {\n  model?: string;\n  messages?: OpenAiMessage[];\n  input?: unknown;\n  stream?: boolean;\n  max_tokens?: number;\n  max_completion_tokens?: number;\n  temperature?: number;\n  top_p?: number;\n  metadata?: Record<string, unknown>;\n  tools?: OpenAiToolDefinition[];\n  tool_choice?: unknown;\n  parallel_tool_calls?: boolean;\n  response_format?: OpenAiResponseFormat;\n  user?: string;\n  // Responses-only fields (also accepted on Chat Completions and ignored\n  // gracefully when the outbound backend has no equivalent).\n  /** System-prompt-style preamble used by the Responses API. */\n  instructions?: string;\n  /**\n   * Echoed back in `responseBody` to support stateful client flows. The\n   * gateway does not persist responses today; pass-through only.\n   */\n  previous_response_id?: string;\n  /**\n   * Indicates whether the caller wants OpenAI's hosted response storage. The\n   * gateway is stateless; preserved on the request type so callers are not\n   * rejected.\n   */\n  store?: boolean;\n  /** Reasoning configuration for the Responses API. */\n  reasoning?: OpenAiReasoningOptions;\n}\n\nexport type { EmbeddingsRequest } from './openai-gateway-embeddings.js';\nexport {\n  embeddingFor,\n  normalizeEmbeddingInput,\n} from './openai-gateway-embeddings.js';\nexport type {\n  OpenAiReasoningOptions,\n  OpenAiResponseFormat,\n  OpenAiToolDefinition,\n} from './openai-gateway-prompt-parts.js';\n\nexport interface ToolInvokeRequest {\n  name?: string;\n  tool?: string;\n  arguments?: Record<string, unknown>;\n  input?: Record<string, unknown>;\n  contextId?: string;\n  taskId?: string;\n}\n\nfunction roleToBridge(role: OpenAiRole): Message['role'] {\n  if (role === 'assistant') return 'agent';\n  if (role === 'tool') return 'tool';\n  if (role === 'system' || role === 'developer') return 'system';\n  return 'user';\n}\n\nfunction imageUrlFromPart(part: OpenAiContentPart): string | undefined {\n  if (part.type === 'image_url') {\n    const image = part.image_url;\n    return (\n      optionalString(image) ??\n      (isRecord(image) ? optionalString(image.url) : undefined)\n    );\n  }\n  if (part.type === 'input_image') {\n    return optionalString(part.image_url) ?? optionalString(part.file_id);\n  }\n  return undefined;\n}\n\nfunction readCacheControl(part: OpenAiContentPart): CacheControl | undefined {\n  const raw = part.cache_control;\n  if (!isRecord(raw)) return undefined;\n  const type = optionalString(raw.type);\n  if (type === 'ephemeral') {\n    const ttl = optionalString(raw.ttl);\n    if (ttl === '5m' || ttl === '1h') return { type: 'ephemeral', ttl };\n    return { type: 'ephemeral' };\n  }\n  if (type === 'static') return { type: 'static' };\n  return undefined;\n}\n\nfunction partToBridge(part: OpenAiContentPart): Part | null {\n  const cache = readCacheControl(part);\n  if (\n    part.type === 'text' ||\n    part.type === 'input_text' ||\n    part.type === 'output_text'\n  ) {\n    const textValue = optionalString(part.text);\n    if (!textValue) return null;\n    const text: TextPart = { kind: 'text', text: textValue };\n    if (cache) text.cacheControl = cache;\n    return text;\n  }\n  const imageUrl = imageUrlFromPart(part);\n  if (imageUrl) {\n    const metadata: Record<string, unknown> = { sourceType: part.type };\n    if (cache) metadata.cacheControl = cache;\n    return {\n      kind: 'file',\n      file: { uri: imageUrl, mimeType: 'image/*' },\n      metadata,\n    } satisfies FilePart;\n  }\n  if (part.type === 'input_audio') {\n    const audio = isRecord(part.input_audio) ? part.input_audio : undefined;\n    const data = optionalString(audio?.data) ?? optionalString(part.data);\n    const format =\n      optionalString(audio?.format) ?? optionalString(part.format) ?? 'mpeg';\n    if (!data) return null;\n    return {\n      kind: 'file',\n      file: { bytes: data, mimeType: `audio/${format}` },\n      metadata: { sourceType: part.type },\n    } satisfies FilePart;\n  }\n  if (part.type === 'file') {\n    const file = isRecord(part.file) ? part.file : undefined;\n    const data =\n      optionalString(file?.file_data) ?? optionalString(part.file_data);\n    const id = optionalString(file?.file_id) ?? optionalString(part.file_id);\n    return {\n      kind: 'file',\n      file: {\n        name: optionalString(file?.filename),\n        bytes: data,\n        uri: id,\n        mimeType: 'application/octet-stream',\n      },\n    } satisfies FilePart;\n  }\n  if (part.type === 'tool_use') {\n    const name = optionalString(part.name);\n    if (!name) return null;\n    return {\n      kind: 'tool_call',\n      id: optionalString(part.id) ?? crypto.randomUUID(),\n      name,\n      input: part.input ?? {},\n    } satisfies ToolCallPart;\n  }\n  if (part.type === 'tool_result') {\n    return {\n      kind: 'tool_result',\n      callId: optionalString(part.tool_use_id) ?? '',\n      output: part.content ?? '',\n      isError: optionalBoolean(part.is_error),\n    } satisfies ToolResultPart;\n  }\n  return {\n    kind: 'data',\n    data: part,\n    metadata: { contentType: part.type },\n  } satisfies DataPart;\n}\n\nfunction contentToParts(content: OpenAiMessage['content']): Part[] {\n  if (typeof content === 'string') {\n    return content ? [{ kind: 'text', text: content }] : [];\n  }\n  if (!Array.isArray(content)) return [];\n  return content.map(partToBridge).filter((part): part is Part => part != null);\n}\n\nfunction openAiMessageToBridge(message: OpenAiMessage, index: number): Message {\n  const parts = contentToParts(message.content);\n  if (message.tool_calls) {\n    for (const call of message.tool_calls) {\n      const name = call.function?.name;\n      if (!name) continue;\n      let input: unknown = {};\n      const rawArgs = call.function?.arguments;\n      if (rawArgs) {\n        try {\n          input = JSON.parse(rawArgs);\n        } catch {\n          input = rawArgs;\n        }\n      }\n      parts.push({\n        kind: 'tool_call',\n        id: call.id ?? crypto.randomUUID(),\n        name,\n        input,\n      });\n    }\n  }\n  if (\n    message.role === 'tool' &&\n    message.tool_call_id &&\n    !parts.some((p) => p.kind === 'tool_result')\n  ) {\n    parts.push({\n      kind: 'tool_result',\n      callId: message.tool_call_id,\n      output:\n        typeof message.content === 'string'\n          ? message.content\n          : (message.content ?? ''),\n    });\n  }\n  return {\n    kind: 'message',\n    messageId: `openai-${index}-${crypto.randomUUID()}`,\n    role: roleToBridge(message.role),\n    parts,\n    metadata: message.name ? { name: message.name } : undefined,\n  };\n}\n\nfunction inputToMessages(input: unknown): OpenAiMessage[] {\n  if (typeof input === 'string') return [{ role: 'user', content: input }];\n  if (Array.isArray(input)) {\n    return input.map((entry) => {\n      if (typeof entry === 'string') {\n        return { role: 'user' as const, content: entry };\n      }\n      if (entry && typeof entry === 'object') {\n        const obj = entry as Record<string, unknown>;\n        const normalized = normalizeOpenAiMessage(obj);\n        if (normalized) return normalized;\n      }\n      return { role: 'user' as const, content: JSON.stringify(entry) };\n    });\n  }\n  if (input && typeof input === 'object') return [input as OpenAiMessage];\n  return [];\n}\n\nexport function requestToBridgeMessage(\n  body: ChatCompletionRequest\n): Message | string {\n  const source = body.messages ?? inputToMessages(body.input);\n  if (source.length === 0) return '';\n  const toolPromptParts = toolDefinitionsToPromptParts(body);\n  const instructionParts = instructionsToPromptParts(body);\n  const responseFormatParts = responseFormatToPromptParts(body);\n  const prefixParts: Part[] = [\n    ...instructionParts,\n    ...responseFormatParts,\n    ...toolPromptParts,\n  ];\n  if (\n    prefixParts.length === 0 &&\n    source.length === 1 &&\n    source[0]?.role === 'user' &&\n    typeof source[0].content === 'string'\n  ) {\n    return source[0].content;\n  }\n  const parts: Part[] = [...prefixParts];\n  for (const [index, message] of source.entries()) {\n    const bridge = openAiMessageToBridge(message, index);\n    const label = message.role === 'developer' ? 'developer' : bridge.role;\n    if (label === 'system') {\n      const systemText = bridge.parts\n        .filter((p): p is TextPart => p.kind === 'text')\n        .map((p) => p.text)\n        .join('\\n');\n      if (systemText) {\n        parts.push({ kind: 'text', text: `[system]\\n${systemText}` });\n      }\n      continue;\n    }\n    if (label === 'developer') {\n      const developerText = bridge.parts\n        .filter((p): p is TextPart => p.kind === 'text')\n        .map((p) => p.text)\n        .join('\\n');\n      if (developerText) {\n        parts.push({ kind: 'text', text: `[developer]\\n${developerText}` });\n      }\n      continue;\n    }\n    parts.push({ kind: 'text', text: `[${label}]` });\n    parts.push(...bridge.parts);\n  }\n  return {\n    kind: 'message',\n    messageId: `openai-${crypto.randomUUID()}`,\n    role: 'user',\n    parts,\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/runtime/bridge/openai-gateway-embeddings.d.ts

@@ -0,0 +1,8 @@
+export interface EmbeddingsRequest {
+    input?: string | string[] | Array<number> | Array<Array<number>>;
+    model?: string;
+    dimensions?: number;
+}
+export declare function embeddingFor(textValue: string, dimensions: number): number[];
+export declare function normalizeEmbeddingInput(input: EmbeddingsRequest['input']): string[];
+//# sourceMappingURL=openai-gateway-embeddings.d.ts.map

package/dist/runtime/bridge/openai-gateway-embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-gateway-embeddings.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/openai-gateway-embeddings.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAe5E;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAChC,MAAM,EAAE,CAQV"}

package/dist/runtime/bridge/openai-gateway-embeddings.js

@@ -0,0 +1,28 @@
+import crypto from "node:crypto";
+function embeddingFor(textValue, dimensions) {
+  const out = [];
+  let counter = 0;
+  while (out.length < dimensions) {
+    const hash = crypto.createHash("sha256").update(`${counter}:${textValue}`).digest();
+    for (const byte of hash) {
+      out.push(byte / 127.5 - 1);
+      if (out.length === dimensions) break;
+    }
+    counter += 1;
+  }
+  return out;
+}
+function normalizeEmbeddingInput(input) {
+  if (typeof input === "string") return [input];
+  if (!Array.isArray(input)) return [""];
+  if (input.length === 0) return [];
+  if (typeof input[0] === "number") return [input.join(" ")];
+  return input.map(
+    (entry) => Array.isArray(entry) ? entry.join(" ") : String(entry)
+  );
+}
+export {
+  embeddingFor,
+  normalizeEmbeddingInput
+};
+//# sourceMappingURL=openai-gateway-embeddings.js.map

package/dist/runtime/bridge/openai-gateway-embeddings.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/openai-gateway-embeddings.ts"],
+  "sourcesContent": ["/**\n * Deterministic embedding helpers for the OpenAI-compatible inbound gateway.\n *\n * Lives in its own file so the converter file stays under the 400-line cap.\n * The synthesized embeddings are deterministic but otherwise meaningless \u2014\n * they exist so harnesses that probe `/v1/embeddings` while bringing up an\n * OctoFlow gateway do not crash. Real embeddings should be wired through a\n * `GatewayEmbedFn` at `MakeGatewayOptions.embed`.\n */\nimport crypto from 'node:crypto';\n\nexport interface EmbeddingsRequest {\n  input?: string | string[] | Array<number> | Array<Array<number>>;\n  model?: string;\n  dimensions?: number;\n}\n\nexport function embeddingFor(textValue: string, dimensions: number): number[] {\n  const out: number[] = [];\n  let counter = 0;\n  while (out.length < dimensions) {\n    const hash = crypto\n      .createHash('sha256')\n      .update(`${counter}:${textValue}`)\n      .digest();\n    for (const byte of hash) {\n      out.push(byte / 127.5 - 1);\n      if (out.length === dimensions) break;\n    }\n    counter += 1;\n  }\n  return out;\n}\n\nexport function normalizeEmbeddingInput(\n  input: EmbeddingsRequest['input']\n): string[] {\n  if (typeof input === 'string') return [input];\n  if (!Array.isArray(input)) return [''];\n  if (input.length === 0) return [];\n  if (typeof input[0] === 'number') return [(input as number[]).join(' ')];\n  return (input as Array<string | number[]>).map((entry) =>\n    Array.isArray(entry) ? entry.join(' ') : String(entry)\n  );\n}\n"],
+  "mappings": "AASA,OAAO,YAAY;AAQZ,SAAS,aAAa,WAAmB,YAA8B;AAC5E,QAAM,MAAgB,CAAC;AACvB,MAAI,UAAU;AACd,SAAO,IAAI,SAAS,YAAY;AAC9B,UAAM,OAAO,OACV,WAAW,QAAQ,EACnB,OAAO,GAAG,OAAO,IAAI,SAAS,EAAE,EAChC,OAAO;AACV,eAAW,QAAQ,MAAM;AACvB,UAAI,KAAK,OAAO,QAAQ,CAAC;AACzB,UAAI,IAAI,WAAW,WAAY;AAAA,IACjC;AACA,eAAW;AAAA,EACb;AACA,SAAO;AACT;AAEO,SAAS,wBACd,OACU;AACV,MAAI,OAAO,UAAU,SAAU,QAAO,CAAC,KAAK;AAC5C,MAAI,CAAC,MAAM,QAAQ,KAAK,EAAG,QAAO,CAAC,EAAE;AACrC,MAAI,MAAM,WAAW,EAAG,QAAO,CAAC;AAChC,MAAI,OAAO,MAAM,CAAC,MAAM,SAAU,QAAO,CAAE,MAAmB,KAAK,GAAG,CAAC;AACvE,SAAQ,MAAmC;AAAA,IAAI,CAAC,UAC9C,MAAM,QAAQ,KAAK,IAAI,MAAM,KAAK,GAAG,IAAI,OAAO,KAAK;AAAA,EACvD;AACF;",
+  "names": []
+}

package/dist/runtime/bridge/openai-gateway-prompt-parts.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Request-side prompt-builders for the OpenAI-compatible gateway.
+ *
+ * Each builder turns a top-level request field (`tools`, `instructions`,
+ * `response_format`) into a list of bridge `Part`s that surfaces the intent
+ * to the outbound backend, so harnesses that depend on these fields don't
+ * silently lose contract when the backend is text-only.
+ *
+ * Lives in its own file so `openai-gateway-converters.ts` stays under the
+ * 400-line cap.
+ */
+import type { Part } from '../../domain/core-task.js';
+/**
+ * Subset of OpenAI's `response_format` request field. Both Chat Completions
+ * and the Responses API accept this shape; the gateway preserves the request
+ * intent (and surfaces a guidance hint to text-only outbound backends) but
+ * does not validate the schema against the agent's reply.
+ */
+export interface OpenAiResponseFormat {
+    type?: 'text' | 'json_object' | 'json_schema';
+    json_schema?: {
+        name?: string;
+        description?: string;
+        schema?: unknown;
+        strict?: boolean;
+    };
+}
+/**
+ * Responses API reasoning configuration. `effort` is the documented field;
+ * the gateway accepts and echoes it but does not currently translate it for
+ * outbound backends that lack a direct equivalent.
+ */
+export interface OpenAiReasoningOptions {
+    effort?: 'minimal' | 'low' | 'medium' | 'high';
+    generate_summary?: 'auto' | 'concise' | 'detailed';
+}
+export interface OpenAiToolDefinition {
+    type?: string;
+    function?: {
+        name?: string;
+        description?: string;
+        parameters?: unknown;
+        strict?: boolean;
+    };
+}
+export interface PromptPartsRequest {
+    tools?: OpenAiToolDefinition[];
+    parallel_tool_calls?: boolean;
+    response_format?: OpenAiResponseFormat;
+    instructions?: string;
+}
+export declare function toolDefinitionsToPromptParts(body: PromptPartsRequest): Part[];
+export declare function responseFormatToPromptParts(body: PromptPartsRequest): Part[];
+export declare function instructionsToPromptParts(body: PromptPartsRequest): Part[];
+//# sourceMappingURL=openai-gateway-prompt-parts.d.ts.map

package/dist/runtime/bridge/openai-gateway-prompt-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-gateway-prompt-parts.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/openai-gateway-prompt-parts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,CAAC;IAC9C,WAAW,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC/C,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;CACpD;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAC/B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,eAAe,CAAC,EAAE,oBAAoB,CAAC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,EAAE,CA4B7E;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,EAAE,CAyB5E;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,EAAE,CAI1E"}

package/dist/runtime/bridge/openai-gateway-prompt-parts.js

@@ -0,0 +1,59 @@
+function toolDefinitionsToPromptParts(body) {
+  if (!body.tools?.length) return [];
+  const tools = body.tools.map((tool) => tool.function).filter(
+    (tool) => Boolean(tool?.name)
+  ).map((tool) => ({
+    name: tool.name,
+    description: tool.description ?? "",
+    parameters: tool.parameters ?? { type: "object", properties: {} },
+    strict: tool.strict
+  }));
+  if (tools.length === 0) return [];
+  const parallelHint = body.parallel_tool_calls === false ? "Call at most one tool per turn; do not emit multiple tool_calls in the same reply." : "";
+  const guidance = [
+    "[available_tools]",
+    JSON.stringify(tools),
+    "",
+    "If a tool is needed, respond with only JSON in this exact shape:",
+    '{"tool_calls":[{"id":"call_<unique>","name":"tool_name","arguments":{}}]}',
+    "Do not execute the tool yourself and do not include explanatory text with a tool call.",
+    ...parallelHint ? [parallelHint] : []
+  ].join("\n");
+  return [{ kind: "text", text: guidance }];
+}
+function responseFormatToPromptParts(body) {
+  const format = body.response_format;
+  if (!format) return [];
+  if (format.type === "json_object") {
+    return [
+      {
+        kind: "text",
+        text: "[response_format] Respond with a single JSON object only \u2014 no markdown, no commentary."
+      }
+    ];
+  }
+  if (format.type === "json_schema" && format.json_schema?.schema) {
+    const name = format.json_schema.name ?? "response";
+    const description = format.json_schema.description ? ` (${format.json_schema.description})` : "";
+    const guidance = [
+      `[response_format:${name}]${description}`,
+      "Respond with a single JSON object that validates against this schema:",
+      JSON.stringify(format.json_schema.schema),
+      "No markdown fences, no commentary, no extra fields."
+    ].join("\n");
+    return [{ kind: "text", text: guidance }];
+  }
+  return [];
+}
+function instructionsToPromptParts(body) {
+  const instructions = body.instructions?.trim();
+  if (!instructions) return [];
+  return [{ kind: "text", text: `[instructions]
+${instructions}` }];
+}
+export {
+  instructionsToPromptParts,
+  responseFormatToPromptParts,
+  toolDefinitionsToPromptParts
+};
+//# sourceMappingURL=openai-gateway-prompt-parts.js.map

package/dist/runtime/bridge/openai-gateway-prompt-parts.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/runtime/bridge/openai-gateway-prompt-parts.ts"],
+  "sourcesContent": ["/**\n * Request-side prompt-builders for the OpenAI-compatible gateway.\n *\n * Each builder turns a top-level request field (`tools`, `instructions`,\n * `response_format`) into a list of bridge `Part`s that surfaces the intent\n * to the outbound backend, so harnesses that depend on these fields don't\n * silently lose contract when the backend is text-only.\n *\n * Lives in its own file so `openai-gateway-converters.ts` stays under the\n * 400-line cap.\n */\nimport type { Part } from '../../domain/core-task.js';\n\n/**\n * Subset of OpenAI's `response_format` request field. Both Chat Completions\n * and the Responses API accept this shape; the gateway preserves the request\n * intent (and surfaces a guidance hint to text-only outbound backends) but\n * does not validate the schema against the agent's reply.\n */\nexport interface OpenAiResponseFormat {\n  type?: 'text' | 'json_object' | 'json_schema';\n  json_schema?: {\n    name?: string;\n    description?: string;\n    schema?: unknown;\n    strict?: boolean;\n  };\n}\n\n/**\n * Responses API reasoning configuration. `effort` is the documented field;\n * the gateway accepts and echoes it but does not currently translate it for\n * outbound backends that lack a direct equivalent.\n */\nexport interface OpenAiReasoningOptions {\n  effort?: 'minimal' | 'low' | 'medium' | 'high';\n  generate_summary?: 'auto' | 'concise' | 'detailed';\n}\n\nexport interface OpenAiToolDefinition {\n  type?: string;\n  function?: {\n    name?: string;\n    description?: string;\n    parameters?: unknown;\n    strict?: boolean;\n  };\n}\n\nexport interface PromptPartsRequest {\n  tools?: OpenAiToolDefinition[];\n  parallel_tool_calls?: boolean;\n  response_format?: OpenAiResponseFormat;\n  instructions?: string;\n}\n\nexport function toolDefinitionsToPromptParts(body: PromptPartsRequest): Part[] {\n  if (!body.tools?.length) return [];\n  const tools = body.tools\n    .map((tool) => tool.function)\n    .filter((tool): tool is NonNullable<OpenAiToolDefinition['function']> =>\n      Boolean(tool?.name)\n    )\n    .map((tool) => ({\n      name: tool.name,\n      description: tool.description ?? '',\n      parameters: tool.parameters ?? { type: 'object', properties: {} },\n      strict: tool.strict,\n    }));\n  if (tools.length === 0) return [];\n  const parallelHint =\n    body.parallel_tool_calls === false\n      ? 'Call at most one tool per turn; do not emit multiple tool_calls in the same reply.'\n      : '';\n  const guidance = [\n    '[available_tools]',\n    JSON.stringify(tools),\n    '',\n    'If a tool is needed, respond with only JSON in this exact shape:',\n    '{\"tool_calls\":[{\"id\":\"call_<unique>\",\"name\":\"tool_name\",\"arguments\":{}}]}',\n    'Do not execute the tool yourself and do not include explanatory text with a tool call.',\n    ...(parallelHint ? [parallelHint] : []),\n  ].join('\\n');\n  return [{ kind: 'text', text: guidance }];\n}\n\nexport function responseFormatToPromptParts(body: PromptPartsRequest): Part[] {\n  const format = body.response_format;\n  if (!format) return [];\n  if (format.type === 'json_object') {\n    return [\n      {\n        kind: 'text',\n        text: '[response_format] Respond with a single JSON object only \u2014 no markdown, no commentary.',\n      },\n    ];\n  }\n  if (format.type === 'json_schema' && format.json_schema?.schema) {\n    const name = format.json_schema.name ?? 'response';\n    const description = format.json_schema.description\n      ? ` (${format.json_schema.description})`\n      : '';\n    const guidance = [\n      `[response_format:${name}]${description}`,\n      'Respond with a single JSON object that validates against this schema:',\n      JSON.stringify(format.json_schema.schema),\n      'No markdown fences, no commentary, no extra fields.',\n    ].join('\\n');\n    return [{ kind: 'text', text: guidance }];\n  }\n  return [];\n}\n\nexport function instructionsToPromptParts(body: PromptPartsRequest): Part[] {\n  const instructions = body.instructions?.trim();\n  if (!instructions) return [];\n  return [{ kind: 'text', text: `[instructions]\\n${instructions}` }];\n}\n"],
+  "mappings": "AAwDO,SAAS,6BAA6B,MAAkC;AAC7E,MAAI,CAAC,KAAK,OAAO,OAAQ,QAAO,CAAC;AACjC,QAAM,QAAQ,KAAK,MAChB,IAAI,CAAC,SAAS,KAAK,QAAQ,EAC3B;AAAA,IAAO,CAAC,SACP,QAAQ,MAAM,IAAI;AAAA,EACpB,EACC,IAAI,CAAC,UAAU;AAAA,IACd,MAAM,KAAK;AAAA,IACX,aAAa,KAAK,eAAe;AAAA,IACjC,YAAY,KAAK,cAAc,EAAE,MAAM,UAAU,YAAY,CAAC,EAAE;AAAA,IAChE,QAAQ,KAAK;AAAA,EACf,EAAE;AACJ,MAAI,MAAM,WAAW,EAAG,QAAO,CAAC;AAChC,QAAM,eACJ,KAAK,wBAAwB,QACzB,uFACA;AACN,QAAM,WAAW;AAAA,IACf;AAAA,IACA,KAAK,UAAU,KAAK;AAAA,IACpB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,GAAI,eAAe,CAAC,YAAY,IAAI,CAAC;AAAA,EACvC,EAAE,KAAK,IAAI;AACX,SAAO,CAAC,EAAE,MAAM,QAAQ,MAAM,SAAS,CAAC;AAC1C;AAEO,SAAS,4BAA4B,MAAkC;AAC5E,QAAM,SAAS,KAAK;AACpB,MAAI,CAAC,OAAQ,QAAO,CAAC;AACrB,MAAI,OAAO,SAAS,eAAe;AACjC,WAAO;AAAA,MACL;AAAA,QACE,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,MAAI,OAAO,SAAS,iBAAiB,OAAO,aAAa,QAAQ;AAC/D,UAAM,OAAO,OAAO,YAAY,QAAQ;AACxC,UAAM,cAAc,OAAO,YAAY,cACnC,KAAK,OAAO,YAAY,WAAW,MACnC;AACJ,UAAM,WAAW;AAAA,MACf,oBAAoB,IAAI,IAAI,WAAW;AAAA,MACvC;AAAA,MACA,KAAK,UAAU,OAAO,YAAY,MAAM;AAAA,MACxC;AAAA,IACF,EAAE,KAAK,IAAI;AACX,WAAO,CAAC,EAAE,MAAM,QAAQ,MAAM,SAAS,CAAC;AAAA,EAC1C;AACA,SAAO,CAAC;AACV;AAEO,SAAS,0BAA0B,MAAkC;AAC1E,QAAM,eAAe,KAAK,cAAc,KAAK;AAC7C,MAAI,CAAC,aAAc,QAAO,CAAC;AAC3B,SAAO,CAAC,EAAE,MAAM,QAAQ,MAAM;AAAA,EAAmB,YAAY,GAAG,CAAC;AACnE;",
+  "names": []
+}

package/dist/runtime/bridge/openai-gateway-responses.d.ts

@@ -0,0 +1,81 @@
+import type { ServerResponse } from 'node:http';
+import type { ChatCompletionRequest } from './openai-gateway-converters.js';
+import type { OpenAiToolCall } from './openai-gateway-tool-calls.js';
+/**
+ * Detect hosted-tool entries on an inbound request so the response builders
+ * can emit a typed `not_supported` placeholder. Lives next to {@link responseBody}
+ * because it shapes the Responses output items.
+ */
+export declare function buildOutputOptionsFromRequest(body: ChatCompletionRequest): OutputBuilderOptions;
+export interface OutputBuilderOptions {
+    /**
+     * Optional reasoning summary surfaced as a typed `reasoning` item when the
+     * outbound backend returns one. Empty / undefined skips the item.
+     */
+    reasoning?: string;
+    /**
+     * Hosted tool types requested by the inbound caller. For each one a typed
+     * `not_supported` item is emitted in `output[]` so callers detect the gap
+     * explicitly rather than silently losing the call.
+     */
+    requestedHostedTools?: readonly string[];
+    /**
+     * Synthesized prompt token count. When omitted, defaults to 0 — accurate
+     * counts require an outbound backend hook the gateway does not yet have.
+     */
+    inputTokens?: number;
+    /**
+     * If true, the response is marked `status: 'incomplete'` with a typed
+     * `incomplete_details` reason. Used when the outbound backend signals an
+     * unfinished generation.
+     */
+    incomplete?: {
+        reason: 'max_output_tokens' | 'content_filter' | 'cancelled';
+    };
+}
+interface UsageBlock {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+}
+interface ResponseUsageBlock {
+    input_tokens: number;
+    output_tokens: number;
+    total_tokens: number;
+}
+export declare function completionBody(textValue: string, model: string, toolCalls?: OpenAiToolCall[], options?: OutputBuilderOptions): {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: {
+        index: number;
+        message: {
+            tool_calls?: OpenAiToolCall[] | undefined;
+            role: string;
+            content: string | null;
+        };
+        finish_reason: string;
+        logprobs: null;
+    }[];
+    usage: UsageBlock;
+};
+export declare function responseBody(textValue: string, model: string, toolCalls?: OpenAiToolCall[], options?: OutputBuilderOptions): {
+    id: string;
+    object: string;
+    created_at: number;
+    model: string;
+    status: string;
+    error: null;
+    incomplete_details: {
+        reason: "cancelled" | "max_output_tokens" | "content_filter";
+    } | null;
+    output: unknown[];
+    output_text: string;
+    usage: ResponseUsageBlock;
+    parallel_tool_calls: boolean;
+};
+export declare function writeCompletionStream(res: ServerResponse, textValue: string, model: string, toolCalls?: OpenAiToolCall[], options?: OutputBuilderOptions): void;
+export declare function writeResponseStream(res: ServerResponse, textValue: string, model: string, toolCalls?: OpenAiToolCall[], options?: OutputBuilderOptions): void;
+export {};
+//# sourceMappingURL=openai-gateway-responses.d.ts.map

package/dist/runtime/bridge/openai-gateway-responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-gateway-responses.d.ts","sourceRoot":"","sources":["../../../src/runtime/bridge/openai-gateway-responses.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAsCrE;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,qBAAqB,GAC1B,oBAAoB,CAStB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE;QAAE,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,WAAW,CAAA;KAAE,CAAC;CAC/E;AAED,UAAU,UAAU;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,kBAAkB;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAmDD,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,cAAc,EAAO,EAChC,OAAO,GAAE,oBAAyB;;;;;;;;;;;;;;;;EA4BnC;AAmDD,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,cAAc,EAAO,EAChC,OAAO,GAAE,oBAAyB;;;;;;;;;;;;;;EAmBnC;AAED,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,cAAc,EAAO,EAChC,OAAO,GAAE,oBAAyB,GACjC,IAAI,CA6BN;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,cAAc,EAAO,EAChC,OAAO,GAAE,oBAAyB,GACjC,IAAI,CA2CN"}