@codeproxy/core 0.1.0

package/README.md

@@ -0,0 +1,85 @@
+# @codeproxy/core
+
+> **中文版** → [README.zh-CN.md](./README.zh-CN.md)
+
+**@codeproxy/core** is a zero-dependency TypeScript library that converts upstream LLM responses in **Chat Completions** or **Anthropic Messages** format into the **OpenAI Responses API** format, so that AI coding agents like Codex and Claude Code can work with any language model.
+
+The goal: **let any language model work directly in Codex or Claude Code**, no matter what API format the upstream provider speaks.
+
+## Quick Start
+
+```ts
+import OpenAI from 'openai';
+import { createResponsesFetch } from '@codeproxy/core';
+
+const client = new OpenAI({
+  fetch: createResponsesFetch({
+    upstreamFormat: 'openai-chat',
+    baseUrl: 'https://api.deepseek.com/v1',
+    defaultHeaders: {
+      authorization: `Bearer ${process.env.DEEPSEEK_API_KEY}`,
+    },
+  }),
+});
+
+const response = await client.responses.create({
+  model: 'deepseek-v4-pro',
+  input: 'Hello!',
+});
+```
+
+## How it works
+
+```
+Upstream API (Chat Completions / Anthropic Messages)
+        │
+        ▼  createResponsesFetch translates automatically
+        │
+OpenAI Responses API ←── consumed by Codex / Claude Code
+```
+
+## Install
+
+```bash
+npm install @codeproxy/core
+```
+
+## API
+
+### `createResponsesFetch(options)`
+
+Creates a `fetch` wrapper that translates Responses API traffic to the configured upstream format.
+
+| Option | Type | Description |
+|---|---|---|
+| `upstreamFormat` | `'anthropic'` \| `'openai-chat'` | Upstream API format (inferred from `baseUrl` if omitted) |
+| `baseUrl` | `string` | Upstream endpoint URL |
+| `apiVersion` | `string` | Override Anthropic version header |
+| `model` | `string` | Override the model for all requests |
+| `defaultHeaders` | `Record<string, string>` | Extra headers sent to upstream |
+| `dropImages` | `boolean` | Strip image parts from messages (text-only models) |
+| `timeoutMs` | `number` | Upstream request timeout |
+| `onCacheStats` | `(stats) => void` | Receive cache usage stats |
+| `fallbackUpstream` | `object` | When `dropImages: true` and the request contains images, automatically route to this upstream instead (e.g. a vision-capable model) |
+
+### Translators
+
+Low-level translators are also available by namespace:
+
+- `anthropic.translateRequest` / `anthropic.translateResponse` / `anthropic.translateStream`
+- `openai.translateRequest` / `openai.translateResponse` / `openai.translateStream`
+- `translate.*` — unified re-exports
+
+### Types
+
+All Responses API, Anthropic, and OpenAI Chat types are exported from the package root.
+
+### Utilities
+
+- `parseSseStream(stream)` — Consume `ReadableStream` → parsed SSE messages
+- `encodeSseEvent(event, data)` — Serialize SSE event to wire format
+- `makeId(prefix)` — Generate monotonic-ish IDs
+
+## License
+
+MIT

package/README.zh-CN.md

@@ -0,0 +1,85 @@
+# @codeproxy/core
+
+> **English** → [README.md](./README.md)
+
+**@codeproxy/core** 是一个零依赖的 TypeScript 库，将上游 LLM 的 Chat Completions 或 Anthropic Messages 格式**转换为 OpenAI Responses API 格式**，让 Codex、Claude Code 等 AI 编码代理能够直接调用任意语言模型。
+
+目标：**让任何语言模型都能直接在 Codex 或 Claude Code 中使用**，无论上游提供商使用什么 API 格式。
+
+## 快速开始
+
+```ts
+import OpenAI from 'openai';
+import { createResponsesFetch } from '@codeproxy/core';
+
+const client = new OpenAI({
+  fetch: createResponsesFetch({
+    upstreamFormat: 'openai-chat',
+    baseUrl: 'https://api.deepseek.com/v1',
+    defaultHeaders: {
+      authorization: `Bearer ${process.env.DEEPSEEK_API_KEY}`,
+    },
+  }),
+});
+
+const response = await client.responses.create({
+  model: 'deepseek-v4-pro',
+  input: 'Hello!',
+});
+```
+
+## 工作原理
+
+```
+上游 API (Chat Completions / Anthropic Messages)
+        │
+        ▼  createResponsesFetch 自动转换
+        │
+OpenAI Responses API ←── 供 Codex / Claude Code 消费
+```
+
+## 安装
+
+```bash
+npm install @codeproxy/core
+```
+
+## API
+
+### `createResponsesFetch(options)`
+
+创建一个 `fetch` 包装器，自动将 Responses API 流量转换到配置的上游格式。
+
+| 参数 | 类型 | 说明 |
+|---|---|---|
+| `upstreamFormat` | `'anthropic'` \| `'openai-chat'` | 上游 API 格式（省略时从 baseUrl 推断） |
+| `baseUrl` | `string` | 上游端点 URL |
+| `apiVersion` | `string` | 覆盖 Anthropic 版本头 |
+| `model` | `string` | 为所有请求覆盖模型名 |
+| `defaultHeaders` | `Record<string, string>` | 发送给上游的额外请求头 |
+| `dropImages` | `boolean` | 从消息中移除图片部分（纯文本模型） |
+| `timeoutMs` | `number` | 上游请求超时 |
+| `onCacheStats` | `(stats) => void` | 接收缓存使用统计 |
+| `fallbackUpstream` | `object` | 当 `dropImages: true` 且请求包含图片时，自动切换到该上游（如支持视觉的模型） |
+
+### 转换器
+
+底层转换器也按命名空间导出：
+
+- `anthropic.translateRequest` / `anthropic.translateResponse` / `anthropic.translateStream`
+- `openai.translateRequest` / `openai.translateResponse` / `openai.translateStream`
+- `translate.*` — 统一重新导出
+
+### 类型
+
+所有 Responses API、Anthropic 和 OpenAI Chat 类型均从包根目录导出。
+
+### 工具函数
+
+- `parseSseStream(stream)` — 消费 `ReadableStream` → 解析后的 SSE 消息
+- `encodeSseEvent(event, data)` — 序列化 SSE 事件为线格式
+- `makeId(prefix)` — 生成单调递增的 ID
+
+## 协议
+
+MIT