@alumnium/codex 0.0.0-stage → 0.24.0-alpha.2

package/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Alexey Rodionov, Tatiana Shepeleva
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -1,3 +1,3 @@
-# Temporary Holding Version
+# @alumnium/codex
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Alumnium Codex LLM provider. See [the main `alumnium` package page](https://www.npmjs.com/package/alumnium) for more details.

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@alumnium/codex",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.24.0-alpha.2",
+  "description": "Alumnium Codex LLM provider",
+  "license": "MIT",
+  "author": "Alex Rodionov <p0deje@gmail.com>",
+  "contributors": [
+    "Alex Rodionov <p0deje@gmail.com>",
+    "Sasha Koss <koss@nocorp.me>",
+    "Tatiana Shepeleva <tati.shep@gmail.com>"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alumnium-hq/alumnium.git"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./src/index.d.ts",
+        "default": "./src/index.js"
+      },
+      "require": {
+        "types": "./src/index.d.ts",
+        "default": "./src/index.cjs"
+      }
+    }
+  },
+  "dependencies": {
+    "@ai-sdk/openai": "^4.0.46",
+    "@ai-sdk/provider": "^4.0.7",
+    "@alumnium/core": "0.24.0-alpha.2",
+    "ai": "^7.0.78",
+    "openai-oauth": "1.0.2"
+  }
+}

package/src/index.cjs

@@ -0,0 +1,341 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap()).get(from),
+    desc;
+  if (entry) return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if ((from && typeof from === "object") || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable,
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name),
+    });
+};
+
+// codex/src/index.ts
+var exports_src = {};
+__export(exports_src, {
+  CodexLanguageModel: () => CodexLanguageModel,
+  codexProviders: () => codexProviders,
+});
+module.exports = __toCommonJS(exports_src);
+
+// codex/src/llm/CodexLanguageModel.ts
+var import_openai = require("@ai-sdk/openai");
+var import_openai_oauth = require("openai-oauth");
+var import_internal = require("@alumnium/core/internal");
+var DUMMY_API_KEY = "codex-oauth";
+var LITTERBOX_URL = "https://litterbox.catbox.moe/resources/internals/api.php";
+var STRUCTURED_OUTPUT_TOOL = "__alumnium_structured_output";
+
+class CodexLanguageModel {
+  specificationVersion = "v4";
+  provider = "codex";
+  modelId;
+  supportedUrls = {};
+  #server;
+  #serverPromise;
+  #delegate;
+  #options;
+  #uploader;
+  #litterboxUpload;
+  constructor(options) {
+    this.modelId = options.modelId;
+    this.#options = options;
+    this.#litterboxUpload =
+      options.litterboxUpload ??
+      import_internal.Env.LANGCHAIN_CODEX_LITTERBOX_UPLOAD;
+    this.#uploader = new LitterboxUploader(
+      options.litterboxTtl ?? "1h",
+      options.fetch ?? globalThis.fetch,
+    );
+  }
+  async doGenerate(options) {
+    const structuredTool = structuredOutputToolName(options);
+    const delegate = await this.#ensureDelegate();
+    const result = await delegate.doGenerate(
+      await this.#prepareOptions(options, structuredTool),
+    );
+    return structuredTool
+      ? translateStructuredResult(result, structuredTool)
+      : result;
+  }
+  async doStream(options) {
+    const structuredTool = structuredOutputToolName(options);
+    const delegate = await this.#ensureDelegate();
+    const result = await delegate.doStream(
+      await this.#prepareOptions(options, structuredTool),
+    );
+    if (!structuredTool) return result;
+    return {
+      ...result,
+      stream: result.stream.pipeThrough(structuredOutputStream(structuredTool)),
+    };
+  }
+  async close() {
+    if (!this.#serverPromise) return;
+    const server = await this.#serverPromise;
+    await server.close();
+    this.#server = undefined;
+    this.#serverPromise = undefined;
+    this.#delegate = undefined;
+  }
+  async #prepareOptions(options, structuredTool) {
+    const prompt = await replaceBase64Images(
+      options.prompt,
+      this.#litterboxUpload,
+      this.#uploader,
+    );
+    if (!structuredTool || options.responseFormat?.type !== "json") {
+      return { ...options, prompt };
+    }
+    return {
+      ...options,
+      prompt,
+      responseFormat: { type: "text" },
+      tools: [
+        ...(options.tools ?? []),
+        {
+          type: "function",
+          name: structuredTool,
+          description:
+            options.responseFormat.description ??
+            "Return the response in the required structured format.",
+          inputSchema: options.responseFormat.schema ?? { type: "object" },
+          strict: true,
+        },
+      ],
+      toolChoice: { type: "tool", toolName: structuredTool },
+    };
+  }
+  async #ensureDelegate() {
+    if (this.#delegate) return this.#delegate;
+    const server = await this.#ensureServer();
+    const createDelegate =
+      this.#options.createDelegate ?? defaultCreateDelegate;
+    this.#delegate = createDelegate(server.url, this.modelId);
+    return this.#delegate;
+  }
+  #ensureServer() {
+    if (this.#server) return Promise.resolve(this.#server);
+    if (!this.#serverPromise) {
+      const startServer =
+        this.#options.startServer ?? import_openai_oauth.startOpenAIOAuthServer;
+      this.#serverPromise = startServer({
+        host: "127.0.0.1",
+        port: 0,
+        ...this.#options.oauthServerOptions,
+      }).then((server) => {
+        this.#server = server;
+        server.server.unref();
+        return server;
+      });
+    }
+    return this.#serverPromise;
+  }
+}
+function defaultCreateDelegate(baseURL, modelId) {
+  return import_openai
+    .createOpenAI({ baseURL, apiKey: DUMMY_API_KEY, name: "codex" })
+    .chat(modelId);
+}
+function structuredOutputToolName(options) {
+  if (options.responseFormat?.type !== "json") return;
+  let name = STRUCTURED_OUTPUT_TOOL;
+  const toolNames = new Set(
+    options.tools?.map((tool) =>
+      tool.type === "function" ? tool.name : tool.name,
+    ),
+  );
+  while (toolNames.has(name)) name += "_";
+  return name;
+}
+function translateStructuredResult(result, toolName) {
+  const content = result.content.flatMap((part) =>
+    part.type === "tool-call" && part.toolName === toolName
+      ? [{ type: "text", text: part.input }]
+      : [part],
+  );
+  const hasText = content.some(
+    (part) => part.type === "text" && part.text.trim(),
+  );
+  return {
+    ...result,
+    content,
+    finishReason:
+      result.finishReason.unified === "tool-calls" ||
+      (result.finishReason.unified === "other" && hasText)
+        ? { unified: "stop", raw: result.finishReason.raw }
+        : result.finishReason,
+  };
+}
+function structuredOutputStream(toolName) {
+  let isStructuredTool = false;
+  return new TransformStream({
+    transform(part, controller) {
+      if (part.type === "tool-input-start" && part.toolName === toolName) {
+        isStructuredTool = true;
+        controller.enqueue({ type: "text-start", id: part.id });
+      } else if (part.type === "tool-input-delta" && isStructuredTool) {
+        controller.enqueue({
+          type: "text-delta",
+          id: part.id,
+          delta: part.delta,
+        });
+      } else if (part.type === "tool-input-end" && isStructuredTool) {
+        controller.enqueue({ type: "text-end", id: part.id });
+        isStructuredTool = false;
+      } else if (part.type === "tool-call" && part.toolName === toolName) {
+      } else if (
+        part.type === "finish" &&
+        part.finishReason.unified === "tool-calls"
+      ) {
+        controller.enqueue({
+          ...part,
+          finishReason: { unified: "stop", raw: part.finishReason.raw },
+        });
+      } else {
+        controller.enqueue(part);
+      }
+    },
+  });
+}
+async function replaceBase64Images(prompt, enabled, uploader) {
+  return Promise.all(
+    prompt.map(async (message) => {
+      if (message.role === "user") {
+        const content = await Promise.all(
+          message.content.map((part) =>
+            replaceBase64Image(part, enabled, uploader),
+          ),
+        );
+        return { ...message, content };
+      }
+      if (message.role === "assistant") {
+        const content = await Promise.all(
+          message.content.map((part) =>
+            replaceBase64Image(part, enabled, uploader),
+          ),
+        );
+        return { ...message, content };
+      }
+      return message;
+    }),
+  );
+}
+async function replaceBase64Image(part, enabled, uploader) {
+  if (
+    !part ||
+    typeof part !== "object" ||
+    !("type" in part) ||
+    part.type !== "file" ||
+    !("mediaType" in part) ||
+    typeof part.mediaType !== "string" ||
+    !part.mediaType.startsWith("image/") ||
+    !("data" in part) ||
+    !part.data ||
+    typeof part.data !== "object" ||
+    !("type" in part.data) ||
+    part.data.type !== "data" ||
+    !("data" in part.data) ||
+    (typeof part.data.data !== "string" &&
+      !(part.data.data instanceof Uint8Array))
+  ) {
+    return part;
+  }
+  if (!enabled) {
+    throw new Error(
+      "Codex models do not support inline images. Enable litterboxUpload or set LANGCHAIN_CODEX_LITTERBOX_UPLOAD=true to upload images to Litterbox.",
+    );
+  }
+  const base64 = imageBase64(part.data.data);
+  const url = await uploader.upload(base64, part.mediaType);
+  return { ...part, data: { type: "url", url } };
+}
+function imageBase64(data) {
+  if (typeof data !== "string") return Buffer.from(data).toString("base64");
+  const match = data.match(/^data:image\/[^;]+;base64,(.+)$/s);
+  return match?.[1] ?? data;
+}
+
+class LitterboxUploader {
+  #cache = new Map();
+  #ttl;
+  #fetch;
+  constructor(ttl, fetch) {
+    this.#ttl = ttl;
+    this.#fetch = fetch;
+  }
+  async upload(base64, mediaType) {
+    const hash = fnv1aHash(base64);
+    const cached = this.#cache.get(hash);
+    if (cached) return cached;
+    const extension = mediaType.split("/")[1] ?? "png";
+    const form = new FormData();
+    form.set("reqtype", "fileupload");
+    form.set("time", this.#ttl);
+    form.set(
+      "fileToUpload",
+      new File([Buffer.from(base64, "base64")], `image.${extension}`, {
+        type: mediaType,
+      }),
+    );
+    const response = await this.#fetch(LITTERBOX_URL, {
+      method: "POST",
+      body: form,
+    });
+    const url = (await response.text()).trim();
+    if (!url.startsWith("https://")) {
+      throw new Error(`Litterbox upload failed: ${url}`);
+    }
+    this.#cache.set(hash, url);
+    return url;
+  }
+}
+function fnv1aHash(value) {
+  let hash = 0xcbf29ce484222325n;
+  for (let index = 0; index < value.length; index++) {
+    hash ^= BigInt(value.charCodeAt(index));
+    hash = (hash * 0x100000001b3n) & 0xffffffffffffffffn;
+  }
+  return hash.toString(16);
+}
+// codex/src/llm/codexProviders.ts
+var import_internal2 = require("@alumnium/core/internal");
+var logger = import_internal2.Logger.get(
+  "packages/typescript/codex/src/llm/codexProviders.ts",
+);
+var codexProviders = {
+  codex: (model) => {
+    logger.debug(`Creating Codex LLM with model ${model.name}`);
+    return new CodexLanguageModel({ modelId: model.name });
+  },
+};
+import_internal2.LlmFactory.register(codexProviders);
+
+//# debugId=8827D8B09394EDF464756E2164756E21
+//# sourceMappingURL=index.cjs.map

package/src/index.cjs.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../../codex/src/llm/CodexLanguageModel.ts", "../../codex/src/llm/codexProviders.ts"],
+  "sourcesContent": [
+    "import { createOpenAI } from \"@ai-sdk/openai\";\nimport type {\n  LanguageModelV4,\n  LanguageModelV4CallOptions,\n  LanguageModelV4GenerateResult,\n  LanguageModelV4StreamPart,\n  LanguageModelV4StreamResult,\n} from \"@ai-sdk/provider\";\nimport {\n  startOpenAIOAuthServer,\n  type OpenAIOAuthServerOptions,\n  type RunningOpenAIOAuthServer,\n} from \"openai-oauth\";\nimport { Env } from \"@alumnium/core/internal\";\n\nconst DUMMY_API_KEY = \"codex-oauth\";\nconst LITTERBOX_URL =\n  \"https://litterbox.catbox.moe/resources/internals/api.php\";\nconst STRUCTURED_OUTPUT_TOOL = \"__alumnium_structured_output\";\n\ntype LitterboxTtl = \"1h\" | \"12h\" | \"24h\" | \"72h\";\ntype CodexFetch = (\n  input: string | URL | Request,\n  init?: RequestInit,\n) => Promise<Response>;\n\nexport interface CodexLanguageModelOptions {\n  modelId: string;\n  oauthServerOptions?: Omit<OpenAIOAuthServerOptions, \"models\">;\n  litterboxUpload?: boolean;\n  litterboxTtl?: LitterboxTtl;\n  fetch?: CodexFetch;\n  startServer?: (\n    options: OpenAIOAuthServerOptions,\n  ) => Promise<RunningOpenAIOAuthServer>;\n  createDelegate?: (baseURL: string, modelId: string) => LanguageModelV4;\n}\n\nexport class CodexLanguageModel implements LanguageModelV4 {\n  readonly specificationVersion = \"v4\";\n  readonly provider = \"codex\";\n  readonly modelId: string;\n  readonly supportedUrls: Record<string, RegExp[]> = {};\n\n  #server: RunningOpenAIOAuthServer | undefined;\n  #serverPromise: Promise<RunningOpenAIOAuthServer> | undefined;\n  #delegate: LanguageModelV4 | undefined;\n  #options: CodexLanguageModelOptions;\n  #uploader: LitterboxUploader;\n  #litterboxUpload: boolean;\n\n  constructor(options: CodexLanguageModelOptions) {\n    this.modelId = options.modelId;\n    this.#options = options;\n    this.#litterboxUpload =\n      options.litterboxUpload ?? Env.LANGCHAIN_CODEX_LITTERBOX_UPLOAD;\n    this.#uploader = new LitterboxUploader(\n      options.litterboxTtl ?? \"1h\",\n      options.fetch ?? globalThis.fetch,\n    );\n  }\n\n  async doGenerate(\n    options: LanguageModelV4CallOptions,\n  ): Promise<LanguageModelV4GenerateResult> {\n    const structuredTool = structuredOutputToolName(options);\n    const delegate = await this.#ensureDelegate();\n    const result = await delegate.doGenerate(\n      await this.#prepareOptions(options, structuredTool),\n    );\n    return structuredTool\n      ? translateStructuredResult(result, structuredTool)\n      : result;\n  }\n\n  async doStream(\n    options: LanguageModelV4CallOptions,\n  ): Promise<LanguageModelV4StreamResult> {\n    const structuredTool = structuredOutputToolName(options);\n    const delegate = await this.#ensureDelegate();\n    const result = await delegate.doStream(\n      await this.#prepareOptions(options, structuredTool),\n    );\n    if (!structuredTool) return result;\n\n    return {\n      ...result,\n      stream: result.stream.pipeThrough(structuredOutputStream(structuredTool)),\n    };\n  }\n\n  async close(): Promise<void> {\n    if (!this.#serverPromise) return;\n\n    const server = await this.#serverPromise;\n    await server.close();\n    this.#server = undefined;\n    this.#serverPromise = undefined;\n    this.#delegate = undefined;\n  }\n\n  async #prepareOptions(\n    options: LanguageModelV4CallOptions,\n    structuredTool: string | undefined,\n  ): Promise<LanguageModelV4CallOptions> {\n    const prompt = await replaceBase64Images(\n      options.prompt,\n      this.#litterboxUpload,\n      this.#uploader,\n    );\n    if (!structuredTool || options.responseFormat?.type !== \"json\") {\n      return { ...options, prompt };\n    }\n\n    return {\n      ...options,\n      prompt,\n      responseFormat: { type: \"text\" },\n      tools: [\n        ...(options.tools ?? []),\n        {\n          type: \"function\",\n          name: structuredTool,\n          description:\n            options.responseFormat.description ??\n            \"Return the response in the required structured format.\",\n          inputSchema: options.responseFormat.schema ?? { type: \"object\" },\n          strict: true,\n        },\n      ],\n      toolChoice: { type: \"tool\", toolName: structuredTool },\n    };\n  }\n\n  async #ensureDelegate(): Promise<LanguageModelV4> {\n    if (this.#delegate) return this.#delegate;\n\n    const server = await this.#ensureServer();\n    const createDelegate =\n      this.#options.createDelegate ?? defaultCreateDelegate;\n    this.#delegate = createDelegate(server.url, this.modelId);\n    return this.#delegate;\n  }\n\n  #ensureServer(): Promise<RunningOpenAIOAuthServer> {\n    if (this.#server) return Promise.resolve(this.#server);\n    if (!this.#serverPromise) {\n      const startServer = this.#options.startServer ?? startOpenAIOAuthServer;\n      this.#serverPromise = startServer({\n        host: \"127.0.0.1\",\n        port: 0,\n        ...this.#options.oauthServerOptions,\n      }).then((server) => {\n        this.#server = server;\n        server.server.unref();\n        return server;\n      });\n    }\n    return this.#serverPromise;\n  }\n}\n\nfunction defaultCreateDelegate(\n  baseURL: string,\n  modelId: string,\n): LanguageModelV4 {\n  return createOpenAI({ baseURL, apiKey: DUMMY_API_KEY, name: \"codex\" }).chat(\n    modelId,\n  );\n}\n\nfunction structuredOutputToolName(\n  options: LanguageModelV4CallOptions,\n): string | undefined {\n  if (options.responseFormat?.type !== \"json\") return undefined;\n\n  let name = STRUCTURED_OUTPUT_TOOL;\n  const toolNames = new Set(\n    options.tools?.map((tool) =>\n      tool.type === \"function\" ? tool.name : tool.name,\n    ),\n  );\n  while (toolNames.has(name)) name += \"_\";\n  return name;\n}\n\nfunction translateStructuredResult(\n  result: LanguageModelV4GenerateResult,\n  toolName: string,\n): LanguageModelV4GenerateResult {\n  const content = result.content.flatMap((part) =>\n    part.type === \"tool-call\" && part.toolName === toolName\n      ? [{ type: \"text\" as const, text: part.input }]\n      : [part],\n  );\n  const hasText = content.some(\n    (part) => part.type === \"text\" && part.text.trim(),\n  );\n\n  return {\n    ...result,\n    content,\n    finishReason:\n      result.finishReason.unified === \"tool-calls\" ||\n      (result.finishReason.unified === \"other\" && hasText)\n        ? { unified: \"stop\", raw: result.finishReason.raw }\n        : result.finishReason,\n  };\n}\n\nfunction structuredOutputStream(\n  toolName: string,\n): TransformStream<LanguageModelV4StreamPart, LanguageModelV4StreamPart> {\n  let isStructuredTool = false;\n  return new TransformStream({\n    transform(part, controller) {\n      if (part.type === \"tool-input-start\" && part.toolName === toolName) {\n        isStructuredTool = true;\n        controller.enqueue({ type: \"text-start\", id: part.id });\n      } else if (part.type === \"tool-input-delta\" && isStructuredTool) {\n        controller.enqueue({\n          type: \"text-delta\",\n          id: part.id,\n          delta: part.delta,\n        });\n      } else if (part.type === \"tool-input-end\" && isStructuredTool) {\n        controller.enqueue({ type: \"text-end\", id: part.id });\n        isStructuredTool = false;\n      } else if (part.type === \"tool-call\" && part.toolName === toolName) {\n        // The streamed input deltas already became text deltas.\n      } else if (\n        part.type === \"finish\" &&\n        part.finishReason.unified === \"tool-calls\"\n      ) {\n        controller.enqueue({\n          ...part,\n          finishReason: { unified: \"stop\", raw: part.finishReason.raw },\n        });\n      } else {\n        controller.enqueue(part);\n      }\n    },\n  });\n}\n\nasync function replaceBase64Images(\n  prompt: LanguageModelV4CallOptions[\"prompt\"],\n  enabled: boolean,\n  uploader: LitterboxUploader,\n): Promise<LanguageModelV4CallOptions[\"prompt\"]> {\n  return Promise.all(\n    prompt.map(async (message) => {\n      if (message.role === \"user\") {\n        const content = await Promise.all(\n          message.content.map((part) =>\n            replaceBase64Image(part, enabled, uploader),\n          ),\n        );\n        return { ...message, content };\n      }\n      if (message.role === \"assistant\") {\n        const content = await Promise.all(\n          message.content.map((part) =>\n            replaceBase64Image(part, enabled, uploader),\n          ),\n        );\n        return { ...message, content };\n      }\n      return message;\n    }),\n  );\n}\n\nasync function replaceBase64Image<Part>(\n  part: Part,\n  enabled: boolean,\n  uploader: LitterboxUploader,\n): Promise<Part> {\n  if (\n    !part ||\n    typeof part !== \"object\" ||\n    !(\"type\" in part) ||\n    part.type !== \"file\" ||\n    !(\"mediaType\" in part) ||\n    typeof part.mediaType !== \"string\" ||\n    !part.mediaType.startsWith(\"image/\") ||\n    !(\"data\" in part) ||\n    !part.data ||\n    typeof part.data !== \"object\" ||\n    !(\"type\" in part.data) ||\n    part.data.type !== \"data\" ||\n    !(\"data\" in part.data) ||\n    (typeof part.data.data !== \"string\" &&\n      !(part.data.data instanceof Uint8Array))\n  ) {\n    return part;\n  }\n  if (!enabled) {\n    throw new Error(\n      \"Codex models do not support inline images. Enable litterboxUpload or set LANGCHAIN_CODEX_LITTERBOX_UPLOAD=true to upload images to Litterbox.\",\n    );\n  }\n\n  const base64 = imageBase64(part.data.data);\n  const url = await uploader.upload(base64, part.mediaType);\n  return { ...part, data: { type: \"url\", url } };\n}\n\nfunction imageBase64(data: string | Uint8Array): string {\n  if (typeof data !== \"string\") return Buffer.from(data).toString(\"base64\");\n  const match = data.match(/^data:image\\/[^;]+;base64,(.+)$/s);\n  return match?.[1] ?? data;\n}\n\nclass LitterboxUploader {\n  #cache = new Map<string, string>();\n  #ttl: LitterboxTtl;\n  #fetch: CodexFetch;\n\n  constructor(ttl: LitterboxTtl, fetch: CodexFetch) {\n    this.#ttl = ttl;\n    this.#fetch = fetch;\n  }\n\n  async upload(base64: string, mediaType: string): Promise<string> {\n    const hash = fnv1aHash(base64);\n    const cached = this.#cache.get(hash);\n    if (cached) return cached;\n\n    const extension = mediaType.split(\"/\")[1] ?? \"png\";\n    const form = new FormData();\n    form.set(\"reqtype\", \"fileupload\");\n    form.set(\"time\", this.#ttl);\n    form.set(\n      \"fileToUpload\",\n      new File([Buffer.from(base64, \"base64\")], `image.${extension}`, {\n        type: mediaType,\n      }),\n    );\n    const response = await this.#fetch(LITTERBOX_URL, {\n      method: \"POST\",\n      body: form,\n    });\n    const url = (await response.text()).trim();\n    if (!url.startsWith(\"https://\")) {\n      throw new Error(`Litterbox upload failed: ${url}`);\n    }\n\n    this.#cache.set(hash, url);\n    return url;\n  }\n}\n\nfunction fnv1aHash(value: string): string {\n  let hash = 0xcbf29ce484222325n;\n  for (let index = 0; index < value.length; index++) {\n    hash ^= BigInt(value.charCodeAt(index));\n    hash = (hash * 0x100000001b3n) & 0xffffffffffffffffn;\n  }\n  return hash.toString(16);\n}\n",
+    "import { LlmFactory, Logger } from \"@alumnium/core/internal\";\nimport { CodexLanguageModel } from \"./CodexLanguageModel.ts\";\n\nconst logger = Logger.get(\"packages/typescript/codex/src/llm/codexProviders.ts\");\n\nexport const codexProviders: LlmFactory.Providers = {\n  codex: (model) => {\n    logger.debug(`Creating Codex LLM with model ${model.name}`);\n    return new CodexLanguageModel({ modelId: model.name });\n  },\n};\n\nLlmFactory.register(codexProviders);\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAA6B,IAA7B;AAYO,IAJP;AAKoB,IAApB;AAEA,IAAM,gBAAgB;AACtB,IAAM,gBACJ;AACF,IAAM,yBAAyB;AAAA;AAoBxB,MAAM,mBAA8C;AAAA,EAChD,uBAAuB;AAAA,EACvB,WAAW;AAAA,EACX;AAAA,EACA,gBAA0C,CAAC;AAAA,EAEpD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA,WAAW,CAAC,SAAoC;AAAA,IAC9C,KAAK,UAAU,QAAQ;AAAA,IACvB,KAAK,WAAW;AAAA,IAChB,KAAK,mBACH,QAAQ,mBAAmB,oBAAI;AAAA,IACjC,KAAK,YAAY,IAAI,kBACnB,QAAQ,gBAAgB,MACxB,QAAQ,SAAS,WAAW,KAC9B;AAAA;AAAA,OAGI,WAAU,CACd,SACwC;AAAA,IACxC,MAAM,iBAAiB,yBAAyB,OAAO;AAAA,IACvD,MAAM,WAAW,MAAM,KAAK,gBAAgB;AAAA,IAC5C,MAAM,SAAS,MAAM,SAAS,WAC5B,MAAM,KAAK,gBAAgB,SAAS,cAAc,CACpD;AAAA,IACA,OAAO,iBACH,0BAA0B,QAAQ,cAAc,IAChD;AAAA;AAAA,OAGA,SAAQ,CACZ,SACsC;AAAA,IACtC,MAAM,iBAAiB,yBAAyB,OAAO;AAAA,IACvD,MAAM,WAAW,MAAM,KAAK,gBAAgB;AAAA,IAC5C,MAAM,SAAS,MAAM,SAAS,SAC5B,MAAM,KAAK,gBAAgB,SAAS,cAAc,CACpD;AAAA,IACA,IAAI,CAAC;AAAA,MAAgB,OAAO;AAAA,IAE5B,OAAO;AAAA,SACF;AAAA,MACH,QAAQ,OAAO,OAAO,YAAY,uBAAuB,cAAc,CAAC;AAAA,IAC1E;AAAA;AAAA,OAGI,MAAK,GAAkB;AAAA,IAC3B,IAAI,CAAC,KAAK;AAAA,MAAgB;AAAA,IAE1B,MAAM,SAAS,MAAM,KAAK;AAAA,IAC1B,MAAM,OAAO,MAAM;AAAA,IACnB,KAAK,UAAU;AAAA,IACf,KAAK,iBAAiB;AAAA,IACtB,KAAK,YAAY;AAAA;AAAA,OAGb,eAAe,CACnB,SACA,gBACqC;AAAA,IACrC,MAAM,SAAS,MAAM,oBACnB,QAAQ,QACR,KAAK,kBACL,KAAK,SACP;AAAA,IACA,IAAI,CAAC,kBAAkB,QAAQ,gBAAgB,SAAS,QAAQ;AAAA,MAC9D,OAAO,KAAK,SAAS,OAAO;AAAA,IAC9B;AAAA,IAEA,OAAO;AAAA,SACF;AAAA,MACH;AAAA,MACA,gBAAgB,EAAE,MAAM,OAAO;AAAA,MAC/B,OAAO;AAAA,QACL,GAAI,QAAQ,SAAS,CAAC;AAAA,QACtB;AAAA,UACE,MAAM;AAAA,UACN,MAAM;AAAA,UACN,aACE,QAAQ,eAAe,eACvB;AAAA,UACF,aAAa,QAAQ,eAAe,UAAU,EAAE,MAAM,SAAS;AAAA,UAC/D,QAAQ;AAAA,QACV;AAAA,MACF;AAAA,MACA,YAAY,EAAE,MAAM,QAAQ,UAAU,eAAe;AAAA,IACvD;AAAA;AAAA,OAGI,eAAe,GAA6B;AAAA,IAChD,IAAI,KAAK;AAAA,MAAW,OAAO,KAAK;AAAA,IAEhC,MAAM,SAAS,MAAM,KAAK,cAAc;AAAA,IACxC,MAAM,iBACJ,KAAK,SAAS,kBAAkB;AAAA,IAClC,KAAK,YAAY,eAAe,OAAO,KAAK,KAAK,OAAO;AAAA,IACxD,OAAO,KAAK;AAAA;AAAA,EAGd,aAAa,GAAsC;AAAA,IACjD,IAAI,KAAK;AAAA,MAAS,OAAO,QAAQ,QAAQ,KAAK,OAAO;AAAA,IACrD,IAAI,CAAC,KAAK,gBAAgB;AAAA,MACxB,MAAM,cAAc,KAAK,SAAS,eAAe;AAAA,MACjD,KAAK,iBAAiB,YAAY;AAAA,QAChC,MAAM;AAAA,QACN,MAAM;AAAA,WACH,KAAK,SAAS;AAAA,MACnB,CAAC,EAAE,KAAK,CAAC,WAAW;AAAA,QAClB,KAAK,UAAU;AAAA,QACf,OAAO,OAAO,MAAM;AAAA,QACpB,OAAO;AAAA,OACR;AAAA,IACH;AAAA,IACA,OAAO,KAAK;AAAA;AAEhB;AAEA,SAAS,qBAAqB,CAC5B,SACA,SACiB;AAAA,EACjB,OAAO,2BAAa,EAAE,SAAS,QAAQ,eAAe,MAAM,QAAQ,CAAC,EAAE,KACrE,OACF;AAAA;AAGF,SAAS,wBAAwB,CAC/B,SACoB;AAAA,EACpB,IAAI,QAAQ,gBAAgB,SAAS;AAAA,IAAQ;AAAA,EAE7C,IAAI,OAAO;AAAA,EACX,MAAM,YAAY,IAAI,IACpB,QAAQ,OAAO,IAAI,CAAC,SAClB,KAAK,SAAS,aAAa,KAAK,OAAO,KAAK,IAC9C,CACF;AAAA,EACA,OAAO,UAAU,IAAI,IAAI;AAAA,IAAG,QAAQ;AAAA,EACpC,OAAO;AAAA;AAGT,SAAS,yBAAyB,CAChC,QACA,UAC+B;AAAA,EAC/B,MAAM,UAAU,OAAO,QAAQ,QAAQ,CAAC,SACtC,KAAK,SAAS,eAAe,KAAK,aAAa,WAC3C,CAAC,EAAE,MAAM,QAAiB,MAAM,KAAK,MAAM,CAAC,IAC5C,CAAC,IAAI,CACX;AAAA,EACA,MAAM,UAAU,QAAQ,KACtB,CAAC,SAAS,KAAK,SAAS,UAAU,KAAK,KAAK,KAAK,CACnD;AAAA,EAEA,OAAO;AAAA,OACF;AAAA,IACH;AAAA,IACA,cACE,OAAO,aAAa,YAAY,gBAC/B,OAAO,aAAa,YAAY,WAAW,UACxC,EAAE,SAAS,QAAQ,KAAK,OAAO,aAAa,IAAI,IAChD,OAAO;AAAA,EACf;AAAA;AAGF,SAAS,sBAAsB,CAC7B,UACuE;AAAA,EACvE,IAAI,mBAAmB;AAAA,EACvB,OAAO,IAAI,gBAAgB;AAAA,IACzB,SAAS,CAAC,MAAM,YAAY;AAAA,MAC1B,IAAI,KAAK,SAAS,sBAAsB,KAAK,aAAa,UAAU;AAAA,QAClE,mBAAmB;AAAA,QACnB,WAAW,QAAQ,EAAE,MAAM,cAAc,IAAI,KAAK,GAAG,CAAC;AAAA,MACxD,EAAO,SAAI,KAAK,SAAS,sBAAsB,kBAAkB;AAAA,QAC/D,WAAW,QAAQ;AAAA,UACjB,MAAM;AAAA,UACN,IAAI,KAAK;AAAA,UACT,OAAO,KAAK;AAAA,QACd,CAAC;AAAA,MACH,EAAO,SAAI,KAAK,SAAS,oBAAoB,kBAAkB;AAAA,QAC7D,WAAW,QAAQ,EAAE,MAAM,YAAY,IAAI,KAAK,GAAG,CAAC;AAAA,QACpD,mBAAmB;AAAA,MACrB,EAAO,SAAI,KAAK,SAAS,eAAe,KAAK,aAAa,UAAU,CAEpE,EAAO,SACL,KAAK,SAAS,YACd,KAAK,aAAa,YAAY,cAC9B;AAAA,QACA,WAAW,QAAQ;AAAA,aACd;AAAA,UACH,cAAc,EAAE,SAAS,QAAQ,KAAK,KAAK,aAAa,IAAI;AAAA,QAC9D,CAAC;AAAA,MACH,EAAO;AAAA,QACL,WAAW,QAAQ,IAAI;AAAA;AAAA;AAAA,EAG7B,CAAC;AAAA;AAGH,eAAe,mBAAmB,CAChC,QACA,SACA,UAC+C;AAAA,EAC/C,OAAO,QAAQ,IACb,OAAO,IAAI,OAAO,YAAY;AAAA,IAC5B,IAAI,QAAQ,SAAS,QAAQ;AAAA,MAC3B,MAAM,UAAU,MAAM,QAAQ,IAC5B,QAAQ,QAAQ,IAAI,CAAC,SACnB,mBAAmB,MAAM,SAAS,QAAQ,CAC5C,CACF;AAAA,MACA,OAAO,KAAK,SAAS,QAAQ;AAAA,IAC/B;AAAA,IACA,IAAI,QAAQ,SAAS,aAAa;AAAA,MAChC,MAAM,UAAU,MAAM,QAAQ,IAC5B,QAAQ,QAAQ,IAAI,CAAC,SACnB,mBAAmB,MAAM,SAAS,QAAQ,CAC5C,CACF;AAAA,MACA,OAAO,KAAK,SAAS,QAAQ;AAAA,IAC/B;AAAA,IACA,OAAO;AAAA,GACR,CACH;AAAA;AAGF,eAAe,kBAAwB,CACrC,MACA,SACA,UACe;AAAA,EACf,IACE,CAAC,QACD,OAAO,SAAS,YAChB,EAAE,UAAU,SACZ,KAAK,SAAS,UACd,EAAE,eAAe,SACjB,OAAO,KAAK,cAAc,YAC1B,CAAC,KAAK,UAAU,WAAW,QAAQ,KACnC,EAAE,UAAU,SACZ,CAAC,KAAK,QACN,OAAO,KAAK,SAAS,YACrB,EAAE,UAAU,KAAK,SACjB,KAAK,KAAK,SAAS,UACnB,EAAE,UAAU,KAAK,SAChB,OAAO,KAAK,KAAK,SAAS,YACzB,EAAE,KAAK,KAAK,gBAAgB,aAC9B;AAAA,IACA,OAAO;AAAA,EACT;AAAA,EACA,IAAI,CAAC,SAAS;AAAA,IACZ,MAAM,IAAI,MACR,+IACF;AAAA,EACF;AAAA,EAEA,MAAM,SAAS,YAAY,KAAK,KAAK,IAAI;AAAA,EACzC,MAAM,MAAM,MAAM,SAAS,OAAO,QAAQ,KAAK,SAAS;AAAA,EACxD,OAAO,KAAK,MAAM,MAAM,EAAE,MAAM,OAAO,IAAI,EAAE;AAAA;AAG/C,SAAS,WAAW,CAAC,MAAmC;AAAA,EACtD,IAAI,OAAO,SAAS;AAAA,IAAU,OAAO,OAAO,KAAK,IAAI,EAAE,SAAS,QAAQ;AAAA,EACxE,MAAM,QAAQ,KAAK,MAAM,kCAAkC;AAAA,EAC3D,OAAO,QAAQ,MAAM;AAAA;AAAA;AAGvB,MAAM,kBAAkB;AAAA,EACtB,SAAS,IAAI;AAAA,EACb;AAAA,EACA;AAAA,EAEA,WAAW,CAAC,KAAmB,OAAmB;AAAA,IAChD,KAAK,OAAO;AAAA,IACZ,KAAK,SAAS;AAAA;AAAA,OAGV,OAAM,CAAC,QAAgB,WAAoC;AAAA,IAC/D,MAAM,OAAO,UAAU,MAAM;AAAA,IAC7B,MAAM,SAAS,KAAK,OAAO,IAAI,IAAI;AAAA,IACnC,IAAI;AAAA,MAAQ,OAAO;AAAA,IAEnB,MAAM,YAAY,UAAU,MAAM,GAAG,EAAE,MAAM;AAAA,IAC7C,MAAM,OAAO,IAAI;AAAA,IACjB,KAAK,IAAI,WAAW,YAAY;AAAA,IAChC,KAAK,IAAI,QAAQ,KAAK,IAAI;AAAA,IAC1B,KAAK,IACH,gBACA,IAAI,KAAK,CAAC,OAAO,KAAK,QAAQ,QAAQ,CAAC,GAAG,SAAS,aAAa;AAAA,MAC9D,MAAM;AAAA,IACR,CAAC,CACH;AAAA,IACA,MAAM,WAAW,MAAM,KAAK,OAAO,eAAe;AAAA,MAChD,QAAQ;AAAA,MACR,MAAM;AAAA,IACR,CAAC;AAAA,IACD,MAAM,OAAO,MAAM,SAAS,KAAK,GAAG,KAAK;AAAA,IACzC,IAAI,CAAC,IAAI,WAAW,UAAU,GAAG;AAAA,MAC/B,MAAM,IAAI,MAAM,4BAA4B,KAAK;AAAA,IACnD;AAAA,IAEA,KAAK,OAAO,IAAI,MAAM,GAAG;AAAA,IACzB,OAAO;AAAA;AAEX;AAEA,SAAS,SAAS,CAAC,OAAuB;AAAA,EACxC,IAAI,OAAO;AAAA,EACX,SAAS,QAAQ,EAAG,QAAQ,MAAM,QAAQ,SAAS;AAAA,IACjD,QAAQ,OAAO,MAAM,WAAW,KAAK,CAAC;AAAA,IACtC,OAAQ,OAAO,iBAAkB;AAAA,EACnC;AAAA,EACA,OAAO,KAAK,SAAS,EAAE;AAAA;;ACvWU,IAAnC;AAGA,IAAM,SAAS,wBAAO,IAAI,qDAAqD;AAExE,IAAM,iBAAuC;AAAA,EAClD,OAAO,CAAC,UAAU;AAAA,IAChB,OAAO,MAAM,iCAAiC,MAAM,MAAM;AAAA,IAC1D,OAAO,IAAI,mBAAmB,EAAE,SAAS,MAAM,KAAK,CAAC;AAAA;AAEzD;AAEA,4BAAW,SAAS,cAAc;",
+  "debugId": "8827D8B09394EDF464756E2164756E21",
+  "names": []
+}

package/src/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./llm/CodexLanguageModel.ts";
+export * from "./llm/codexProviders.ts";

package/src/index.js

@@ -0,0 +1,292 @@
+// codex/src/llm/CodexLanguageModel.ts
+import { createOpenAI } from "@ai-sdk/openai";
+import { startOpenAIOAuthServer } from "openai-oauth";
+import { Env } from "@alumnium/core/internal";
+var DUMMY_API_KEY = "codex-oauth";
+var LITTERBOX_URL = "https://litterbox.catbox.moe/resources/internals/api.php";
+var STRUCTURED_OUTPUT_TOOL = "__alumnium_structured_output";
+
+class CodexLanguageModel {
+  specificationVersion = "v4";
+  provider = "codex";
+  modelId;
+  supportedUrls = {};
+  #server;
+  #serverPromise;
+  #delegate;
+  #options;
+  #uploader;
+  #litterboxUpload;
+  constructor(options) {
+    this.modelId = options.modelId;
+    this.#options = options;
+    this.#litterboxUpload =
+      options.litterboxUpload ?? Env.LANGCHAIN_CODEX_LITTERBOX_UPLOAD;
+    this.#uploader = new LitterboxUploader(
+      options.litterboxTtl ?? "1h",
+      options.fetch ?? globalThis.fetch,
+    );
+  }
+  async doGenerate(options) {
+    const structuredTool = structuredOutputToolName(options);
+    const delegate = await this.#ensureDelegate();
+    const result = await delegate.doGenerate(
+      await this.#prepareOptions(options, structuredTool),
+    );
+    return structuredTool
+      ? translateStructuredResult(result, structuredTool)
+      : result;
+  }
+  async doStream(options) {
+    const structuredTool = structuredOutputToolName(options);
+    const delegate = await this.#ensureDelegate();
+    const result = await delegate.doStream(
+      await this.#prepareOptions(options, structuredTool),
+    );
+    if (!structuredTool) return result;
+    return {
+      ...result,
+      stream: result.stream.pipeThrough(structuredOutputStream(structuredTool)),
+    };
+  }
+  async close() {
+    if (!this.#serverPromise) return;
+    const server = await this.#serverPromise;
+    await server.close();
+    this.#server = undefined;
+    this.#serverPromise = undefined;
+    this.#delegate = undefined;
+  }
+  async #prepareOptions(options, structuredTool) {
+    const prompt = await replaceBase64Images(
+      options.prompt,
+      this.#litterboxUpload,
+      this.#uploader,
+    );
+    if (!structuredTool || options.responseFormat?.type !== "json") {
+      return { ...options, prompt };
+    }
+    return {
+      ...options,
+      prompt,
+      responseFormat: { type: "text" },
+      tools: [
+        ...(options.tools ?? []),
+        {
+          type: "function",
+          name: structuredTool,
+          description:
+            options.responseFormat.description ??
+            "Return the response in the required structured format.",
+          inputSchema: options.responseFormat.schema ?? { type: "object" },
+          strict: true,
+        },
+      ],
+      toolChoice: { type: "tool", toolName: structuredTool },
+    };
+  }
+  async #ensureDelegate() {
+    if (this.#delegate) return this.#delegate;
+    const server = await this.#ensureServer();
+    const createDelegate =
+      this.#options.createDelegate ?? defaultCreateDelegate;
+    this.#delegate = createDelegate(server.url, this.modelId);
+    return this.#delegate;
+  }
+  #ensureServer() {
+    if (this.#server) return Promise.resolve(this.#server);
+    if (!this.#serverPromise) {
+      const startServer = this.#options.startServer ?? startOpenAIOAuthServer;
+      this.#serverPromise = startServer({
+        host: "127.0.0.1",
+        port: 0,
+        ...this.#options.oauthServerOptions,
+      }).then((server) => {
+        this.#server = server;
+        server.server.unref();
+        return server;
+      });
+    }
+    return this.#serverPromise;
+  }
+}
+function defaultCreateDelegate(baseURL, modelId) {
+  return createOpenAI({ baseURL, apiKey: DUMMY_API_KEY, name: "codex" }).chat(
+    modelId,
+  );
+}
+function structuredOutputToolName(options) {
+  if (options.responseFormat?.type !== "json") return;
+  let name = STRUCTURED_OUTPUT_TOOL;
+  const toolNames = new Set(
+    options.tools?.map((tool) =>
+      tool.type === "function" ? tool.name : tool.name,
+    ),
+  );
+  while (toolNames.has(name)) name += "_";
+  return name;
+}
+function translateStructuredResult(result, toolName) {
+  const content = result.content.flatMap((part) =>
+    part.type === "tool-call" && part.toolName === toolName
+      ? [{ type: "text", text: part.input }]
+      : [part],
+  );
+  const hasText = content.some(
+    (part) => part.type === "text" && part.text.trim(),
+  );
+  return {
+    ...result,
+    content,
+    finishReason:
+      result.finishReason.unified === "tool-calls" ||
+      (result.finishReason.unified === "other" && hasText)
+        ? { unified: "stop", raw: result.finishReason.raw }
+        : result.finishReason,
+  };
+}
+function structuredOutputStream(toolName) {
+  let isStructuredTool = false;
+  return new TransformStream({
+    transform(part, controller) {
+      if (part.type === "tool-input-start" && part.toolName === toolName) {
+        isStructuredTool = true;
+        controller.enqueue({ type: "text-start", id: part.id });
+      } else if (part.type === "tool-input-delta" && isStructuredTool) {
+        controller.enqueue({
+          type: "text-delta",
+          id: part.id,
+          delta: part.delta,
+        });
+      } else if (part.type === "tool-input-end" && isStructuredTool) {
+        controller.enqueue({ type: "text-end", id: part.id });
+        isStructuredTool = false;
+      } else if (part.type === "tool-call" && part.toolName === toolName) {
+      } else if (
+        part.type === "finish" &&
+        part.finishReason.unified === "tool-calls"
+      ) {
+        controller.enqueue({
+          ...part,
+          finishReason: { unified: "stop", raw: part.finishReason.raw },
+        });
+      } else {
+        controller.enqueue(part);
+      }
+    },
+  });
+}
+async function replaceBase64Images(prompt, enabled, uploader) {
+  return Promise.all(
+    prompt.map(async (message) => {
+      if (message.role === "user") {
+        const content = await Promise.all(
+          message.content.map((part) =>
+            replaceBase64Image(part, enabled, uploader),
+          ),
+        );
+        return { ...message, content };
+      }
+      if (message.role === "assistant") {
+        const content = await Promise.all(
+          message.content.map((part) =>
+            replaceBase64Image(part, enabled, uploader),
+          ),
+        );
+        return { ...message, content };
+      }
+      return message;
+    }),
+  );
+}
+async function replaceBase64Image(part, enabled, uploader) {
+  if (
+    !part ||
+    typeof part !== "object" ||
+    !("type" in part) ||
+    part.type !== "file" ||
+    !("mediaType" in part) ||
+    typeof part.mediaType !== "string" ||
+    !part.mediaType.startsWith("image/") ||
+    !("data" in part) ||
+    !part.data ||
+    typeof part.data !== "object" ||
+    !("type" in part.data) ||
+    part.data.type !== "data" ||
+    !("data" in part.data) ||
+    (typeof part.data.data !== "string" &&
+      !(part.data.data instanceof Uint8Array))
+  ) {
+    return part;
+  }
+  if (!enabled) {
+    throw new Error(
+      "Codex models do not support inline images. Enable litterboxUpload or set LANGCHAIN_CODEX_LITTERBOX_UPLOAD=true to upload images to Litterbox.",
+    );
+  }
+  const base64 = imageBase64(part.data.data);
+  const url = await uploader.upload(base64, part.mediaType);
+  return { ...part, data: { type: "url", url } };
+}
+function imageBase64(data) {
+  if (typeof data !== "string") return Buffer.from(data).toString("base64");
+  const match = data.match(/^data:image\/[^;]+;base64,(.+)$/s);
+  return match?.[1] ?? data;
+}
+
+class LitterboxUploader {
+  #cache = new Map();
+  #ttl;
+  #fetch;
+  constructor(ttl, fetch) {
+    this.#ttl = ttl;
+    this.#fetch = fetch;
+  }
+  async upload(base64, mediaType) {
+    const hash = fnv1aHash(base64);
+    const cached = this.#cache.get(hash);
+    if (cached) return cached;
+    const extension = mediaType.split("/")[1] ?? "png";
+    const form = new FormData();
+    form.set("reqtype", "fileupload");
+    form.set("time", this.#ttl);
+    form.set(
+      "fileToUpload",
+      new File([Buffer.from(base64, "base64")], `image.${extension}`, {
+        type: mediaType,
+      }),
+    );
+    const response = await this.#fetch(LITTERBOX_URL, {
+      method: "POST",
+      body: form,
+    });
+    const url = (await response.text()).trim();
+    if (!url.startsWith("https://")) {
+      throw new Error(`Litterbox upload failed: ${url}`);
+    }
+    this.#cache.set(hash, url);
+    return url;
+  }
+}
+function fnv1aHash(value) {
+  let hash = 0xcbf29ce484222325n;
+  for (let index = 0; index < value.length; index++) {
+    hash ^= BigInt(value.charCodeAt(index));
+    hash = (hash * 0x100000001b3n) & 0xffffffffffffffffn;
+  }
+  return hash.toString(16);
+}
+// codex/src/llm/codexProviders.ts
+import { LlmFactory, Logger } from "@alumnium/core/internal";
+var logger = Logger.get("packages/typescript/codex/src/llm/codexProviders.ts");
+var codexProviders = {
+  codex: (model) => {
+    logger.debug(`Creating Codex LLM with model ${model.name}`);
+    return new CodexLanguageModel({ modelId: model.name });
+  },
+};
+LlmFactory.register(codexProviders);
+export { CodexLanguageModel, codexProviders };
+
+//# debugId=3C0FB39B12E7B69064756E2164756E21
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../../codex/src/llm/CodexLanguageModel.ts", "../../codex/src/llm/codexProviders.ts"],
+  "sourcesContent": [
+    "import { createOpenAI } from \"@ai-sdk/openai\";\nimport type {\n  LanguageModelV4,\n  LanguageModelV4CallOptions,\n  LanguageModelV4GenerateResult,\n  LanguageModelV4StreamPart,\n  LanguageModelV4StreamResult,\n} from \"@ai-sdk/provider\";\nimport {\n  startOpenAIOAuthServer,\n  type OpenAIOAuthServerOptions,\n  type RunningOpenAIOAuthServer,\n} from \"openai-oauth\";\nimport { Env } from \"@alumnium/core/internal\";\n\nconst DUMMY_API_KEY = \"codex-oauth\";\nconst LITTERBOX_URL =\n  \"https://litterbox.catbox.moe/resources/internals/api.php\";\nconst STRUCTURED_OUTPUT_TOOL = \"__alumnium_structured_output\";\n\ntype LitterboxTtl = \"1h\" | \"12h\" | \"24h\" | \"72h\";\ntype CodexFetch = (\n  input: string | URL | Request,\n  init?: RequestInit,\n) => Promise<Response>;\n\nexport interface CodexLanguageModelOptions {\n  modelId: string;\n  oauthServerOptions?: Omit<OpenAIOAuthServerOptions, \"models\">;\n  litterboxUpload?: boolean;\n  litterboxTtl?: LitterboxTtl;\n  fetch?: CodexFetch;\n  startServer?: (\n    options: OpenAIOAuthServerOptions,\n  ) => Promise<RunningOpenAIOAuthServer>;\n  createDelegate?: (baseURL: string, modelId: string) => LanguageModelV4;\n}\n\nexport class CodexLanguageModel implements LanguageModelV4 {\n  readonly specificationVersion = \"v4\";\n  readonly provider = \"codex\";\n  readonly modelId: string;\n  readonly supportedUrls: Record<string, RegExp[]> = {};\n\n  #server: RunningOpenAIOAuthServer | undefined;\n  #serverPromise: Promise<RunningOpenAIOAuthServer> | undefined;\n  #delegate: LanguageModelV4 | undefined;\n  #options: CodexLanguageModelOptions;\n  #uploader: LitterboxUploader;\n  #litterboxUpload: boolean;\n\n  constructor(options: CodexLanguageModelOptions) {\n    this.modelId = options.modelId;\n    this.#options = options;\n    this.#litterboxUpload =\n      options.litterboxUpload ?? Env.LANGCHAIN_CODEX_LITTERBOX_UPLOAD;\n    this.#uploader = new LitterboxUploader(\n      options.litterboxTtl ?? \"1h\",\n      options.fetch ?? globalThis.fetch,\n    );\n  }\n\n  async doGenerate(\n    options: LanguageModelV4CallOptions,\n  ): Promise<LanguageModelV4GenerateResult> {\n    const structuredTool = structuredOutputToolName(options);\n    const delegate = await this.#ensureDelegate();\n    const result = await delegate.doGenerate(\n      await this.#prepareOptions(options, structuredTool),\n    );\n    return structuredTool\n      ? translateStructuredResult(result, structuredTool)\n      : result;\n  }\n\n  async doStream(\n    options: LanguageModelV4CallOptions,\n  ): Promise<LanguageModelV4StreamResult> {\n    const structuredTool = structuredOutputToolName(options);\n    const delegate = await this.#ensureDelegate();\n    const result = await delegate.doStream(\n      await this.#prepareOptions(options, structuredTool),\n    );\n    if (!structuredTool) return result;\n\n    return {\n      ...result,\n      stream: result.stream.pipeThrough(structuredOutputStream(structuredTool)),\n    };\n  }\n\n  async close(): Promise<void> {\n    if (!this.#serverPromise) return;\n\n    const server = await this.#serverPromise;\n    await server.close();\n    this.#server = undefined;\n    this.#serverPromise = undefined;\n    this.#delegate = undefined;\n  }\n\n  async #prepareOptions(\n    options: LanguageModelV4CallOptions,\n    structuredTool: string | undefined,\n  ): Promise<LanguageModelV4CallOptions> {\n    const prompt = await replaceBase64Images(\n      options.prompt,\n      this.#litterboxUpload,\n      this.#uploader,\n    );\n    if (!structuredTool || options.responseFormat?.type !== \"json\") {\n      return { ...options, prompt };\n    }\n\n    return {\n      ...options,\n      prompt,\n      responseFormat: { type: \"text\" },\n      tools: [\n        ...(options.tools ?? []),\n        {\n          type: \"function\",\n          name: structuredTool,\n          description:\n            options.responseFormat.description ??\n            \"Return the response in the required structured format.\",\n          inputSchema: options.responseFormat.schema ?? { type: \"object\" },\n          strict: true,\n        },\n      ],\n      toolChoice: { type: \"tool\", toolName: structuredTool },\n    };\n  }\n\n  async #ensureDelegate(): Promise<LanguageModelV4> {\n    if (this.#delegate) return this.#delegate;\n\n    const server = await this.#ensureServer();\n    const createDelegate =\n      this.#options.createDelegate ?? defaultCreateDelegate;\n    this.#delegate = createDelegate(server.url, this.modelId);\n    return this.#delegate;\n  }\n\n  #ensureServer(): Promise<RunningOpenAIOAuthServer> {\n    if (this.#server) return Promise.resolve(this.#server);\n    if (!this.#serverPromise) {\n      const startServer = this.#options.startServer ?? startOpenAIOAuthServer;\n      this.#serverPromise = startServer({\n        host: \"127.0.0.1\",\n        port: 0,\n        ...this.#options.oauthServerOptions,\n      }).then((server) => {\n        this.#server = server;\n        server.server.unref();\n        return server;\n      });\n    }\n    return this.#serverPromise;\n  }\n}\n\nfunction defaultCreateDelegate(\n  baseURL: string,\n  modelId: string,\n): LanguageModelV4 {\n  return createOpenAI({ baseURL, apiKey: DUMMY_API_KEY, name: \"codex\" }).chat(\n    modelId,\n  );\n}\n\nfunction structuredOutputToolName(\n  options: LanguageModelV4CallOptions,\n): string | undefined {\n  if (options.responseFormat?.type !== \"json\") return undefined;\n\n  let name = STRUCTURED_OUTPUT_TOOL;\n  const toolNames = new Set(\n    options.tools?.map((tool) =>\n      tool.type === \"function\" ? tool.name : tool.name,\n    ),\n  );\n  while (toolNames.has(name)) name += \"_\";\n  return name;\n}\n\nfunction translateStructuredResult(\n  result: LanguageModelV4GenerateResult,\n  toolName: string,\n): LanguageModelV4GenerateResult {\n  const content = result.content.flatMap((part) =>\n    part.type === \"tool-call\" && part.toolName === toolName\n      ? [{ type: \"text\" as const, text: part.input }]\n      : [part],\n  );\n  const hasText = content.some(\n    (part) => part.type === \"text\" && part.text.trim(),\n  );\n\n  return {\n    ...result,\n    content,\n    finishReason:\n      result.finishReason.unified === \"tool-calls\" ||\n      (result.finishReason.unified === \"other\" && hasText)\n        ? { unified: \"stop\", raw: result.finishReason.raw }\n        : result.finishReason,\n  };\n}\n\nfunction structuredOutputStream(\n  toolName: string,\n): TransformStream<LanguageModelV4StreamPart, LanguageModelV4StreamPart> {\n  let isStructuredTool = false;\n  return new TransformStream({\n    transform(part, controller) {\n      if (part.type === \"tool-input-start\" && part.toolName === toolName) {\n        isStructuredTool = true;\n        controller.enqueue({ type: \"text-start\", id: part.id });\n      } else if (part.type === \"tool-input-delta\" && isStructuredTool) {\n        controller.enqueue({\n          type: \"text-delta\",\n          id: part.id,\n          delta: part.delta,\n        });\n      } else if (part.type === \"tool-input-end\" && isStructuredTool) {\n        controller.enqueue({ type: \"text-end\", id: part.id });\n        isStructuredTool = false;\n      } else if (part.type === \"tool-call\" && part.toolName === toolName) {\n        // The streamed input deltas already became text deltas.\n      } else if (\n        part.type === \"finish\" &&\n        part.finishReason.unified === \"tool-calls\"\n      ) {\n        controller.enqueue({\n          ...part,\n          finishReason: { unified: \"stop\", raw: part.finishReason.raw },\n        });\n      } else {\n        controller.enqueue(part);\n      }\n    },\n  });\n}\n\nasync function replaceBase64Images(\n  prompt: LanguageModelV4CallOptions[\"prompt\"],\n  enabled: boolean,\n  uploader: LitterboxUploader,\n): Promise<LanguageModelV4CallOptions[\"prompt\"]> {\n  return Promise.all(\n    prompt.map(async (message) => {\n      if (message.role === \"user\") {\n        const content = await Promise.all(\n          message.content.map((part) =>\n            replaceBase64Image(part, enabled, uploader),\n          ),\n        );\n        return { ...message, content };\n      }\n      if (message.role === \"assistant\") {\n        const content = await Promise.all(\n          message.content.map((part) =>\n            replaceBase64Image(part, enabled, uploader),\n          ),\n        );\n        return { ...message, content };\n      }\n      return message;\n    }),\n  );\n}\n\nasync function replaceBase64Image<Part>(\n  part: Part,\n  enabled: boolean,\n  uploader: LitterboxUploader,\n): Promise<Part> {\n  if (\n    !part ||\n    typeof part !== \"object\" ||\n    !(\"type\" in part) ||\n    part.type !== \"file\" ||\n    !(\"mediaType\" in part) ||\n    typeof part.mediaType !== \"string\" ||\n    !part.mediaType.startsWith(\"image/\") ||\n    !(\"data\" in part) ||\n    !part.data ||\n    typeof part.data !== \"object\" ||\n    !(\"type\" in part.data) ||\n    part.data.type !== \"data\" ||\n    !(\"data\" in part.data) ||\n    (typeof part.data.data !== \"string\" &&\n      !(part.data.data instanceof Uint8Array))\n  ) {\n    return part;\n  }\n  if (!enabled) {\n    throw new Error(\n      \"Codex models do not support inline images. Enable litterboxUpload or set LANGCHAIN_CODEX_LITTERBOX_UPLOAD=true to upload images to Litterbox.\",\n    );\n  }\n\n  const base64 = imageBase64(part.data.data);\n  const url = await uploader.upload(base64, part.mediaType);\n  return { ...part, data: { type: \"url\", url } };\n}\n\nfunction imageBase64(data: string | Uint8Array): string {\n  if (typeof data !== \"string\") return Buffer.from(data).toString(\"base64\");\n  const match = data.match(/^data:image\\/[^;]+;base64,(.+)$/s);\n  return match?.[1] ?? data;\n}\n\nclass LitterboxUploader {\n  #cache = new Map<string, string>();\n  #ttl: LitterboxTtl;\n  #fetch: CodexFetch;\n\n  constructor(ttl: LitterboxTtl, fetch: CodexFetch) {\n    this.#ttl = ttl;\n    this.#fetch = fetch;\n  }\n\n  async upload(base64: string, mediaType: string): Promise<string> {\n    const hash = fnv1aHash(base64);\n    const cached = this.#cache.get(hash);\n    if (cached) return cached;\n\n    const extension = mediaType.split(\"/\")[1] ?? \"png\";\n    const form = new FormData();\n    form.set(\"reqtype\", \"fileupload\");\n    form.set(\"time\", this.#ttl);\n    form.set(\n      \"fileToUpload\",\n      new File([Buffer.from(base64, \"base64\")], `image.${extension}`, {\n        type: mediaType,\n      }),\n    );\n    const response = await this.#fetch(LITTERBOX_URL, {\n      method: \"POST\",\n      body: form,\n    });\n    const url = (await response.text()).trim();\n    if (!url.startsWith(\"https://\")) {\n      throw new Error(`Litterbox upload failed: ${url}`);\n    }\n\n    this.#cache.set(hash, url);\n    return url;\n  }\n}\n\nfunction fnv1aHash(value: string): string {\n  let hash = 0xcbf29ce484222325n;\n  for (let index = 0; index < value.length; index++) {\n    hash ^= BigInt(value.charCodeAt(index));\n    hash = (hash * 0x100000001b3n) & 0xffffffffffffffffn;\n  }\n  return hash.toString(16);\n}\n",
+    "import { LlmFactory, Logger } from \"@alumnium/core/internal\";\nimport { CodexLanguageModel } from \"./CodexLanguageModel.ts\";\n\nconst logger = Logger.get(\"packages/typescript/codex/src/llm/codexProviders.ts\");\n\nexport const codexProviders: LlmFactory.Providers = {\n  codex: (model) => {\n    logger.debug(`Creating Codex LLM with model ${model.name}`);\n    return new CodexLanguageModel({ modelId: model.name });\n  },\n};\n\nLlmFactory.register(codexProviders);\n"
+  ],
+  "mappings": "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",
+  "debugId": "3C0FB39B12E7B69064756E2164756E21",
+  "names": []
+}

package/src/llm/CodexLanguageModel.d.ts

@@ -0,0 +1,42 @@
+import type {
+  LanguageModelV4,
+  LanguageModelV4CallOptions,
+  LanguageModelV4GenerateResult,
+  LanguageModelV4StreamResult,
+} from "@ai-sdk/provider";
+import {
+  type OpenAIOAuthServerOptions,
+  type RunningOpenAIOAuthServer,
+} from "openai-oauth";
+type LitterboxTtl = "1h" | "12h" | "24h" | "72h";
+type CodexFetch = (
+  input: string | URL | Request,
+  init?: RequestInit,
+) => Promise<Response>;
+export interface CodexLanguageModelOptions {
+  modelId: string;
+  oauthServerOptions?: Omit<OpenAIOAuthServerOptions, "models">;
+  litterboxUpload?: boolean;
+  litterboxTtl?: LitterboxTtl;
+  fetch?: CodexFetch;
+  startServer?: (
+    options: OpenAIOAuthServerOptions,
+  ) => Promise<RunningOpenAIOAuthServer>;
+  createDelegate?: (baseURL: string, modelId: string) => LanguageModelV4;
+}
+export declare class CodexLanguageModel implements LanguageModelV4 {
+  #private;
+  readonly specificationVersion = "v4";
+  readonly provider = "codex";
+  readonly modelId: string;
+  readonly supportedUrls: Record<string, RegExp[]>;
+  constructor(options: CodexLanguageModelOptions);
+  doGenerate(
+    options: LanguageModelV4CallOptions,
+  ): Promise<LanguageModelV4GenerateResult>;
+  doStream(
+    options: LanguageModelV4CallOptions,
+  ): Promise<LanguageModelV4StreamResult>;
+  close(): Promise<void>;
+}
+export {};

package/src/llm/codexProviders.d.ts

@@ -0,0 +1,2 @@
+import { LlmFactory } from "@alumnium/core/internal";
+export declare const codexProviders: LlmFactory.Providers;