Merge pull request #3 from A8Cl233395/feat/reasoning-content

feat: return reasoning content as reasoning_content field

Author: yelixir-dev

README.ko.md

@@ -208,6 +208,10 @@ curl -sS http://127.0.0.1:9992/v1/chat/completions \
 
 ### 설정과 운영
 
+**Reasoning 출력 변경:** `INCLUDE_REASONING=true`이면 reasoning을 `content`에 붙이지 않고 스트리밍은 `delta.reasoning_content`, 비스트리밍은 `message.reasoning_content`로 따로 반환합니다. Reasoning을 표시하는 클라이언트는 이 필드를 읽어야 합니다. Provider 비스트리밍 재시도에서는 옵션이 켜졌을 때만 reasoning을 보이는 출력으로 세므로, 숨겨진 reasoning만 있는 빈 응답의 성공 처리와 노출된 reasoning의 불필요한 재시도를 방지합니다.
+
+Alpha와 Provider 모두 CLI 1.53.0의 텍스트 전용 모델 목록과 별칭에 대해 이미지 입력을 제거합니다. 가장 최근 이미지 메시지에는 번호가 붙은 텍스트 마커를 넣고 과거 이미지는 생략합니다. 비전 모델의 이미지는 유지하며, 알 수 없는 모델이나 custom 모델은 CLI와 같이 이미지 입력을 허용하지만 실제 비전 지원을 보장하지는 않습니다. Alpha는 base64 data URI를 `mimeType`이 있는 네이티브 이미지 파트로 보내고, 원격 URL은 내려받지 않고 텍스트 자리표시자로 유지합니다.
+
 저장된 dashboard catalog에서 업그레이드하면 현재 model의 enabled state와 모든 custom model은 보존하고, built-in metadata는 1.53.0 canonical 정의로 갱신합니다. Ox Alpha와 MiniMax M3/M2.7 Free를 포함한 retired built-in은 unknown upstream model로 전달하지 않으며, 제거된 default가 설정돼 있으면 `deepseek/deepseek-v4-pro`로 안전하게 fallback합니다.
 
 브라우저에 key가 저장된 기존 사용자는 그대로 동작합니다. 새 브라우저에서는 저장·재시작 전에 **현재 Admin API Key**에 기존 key를 한 번 입력합니다. key 없는 runtime은 실제 loopback 연결이며 Host도 loopback인 경우에만 bootstrap할 수 있습니다.

README.md

@@ -208,6 +208,10 @@ Open `http://127.0.0.1:9992/dashboard`. The mobile-first UI stores its Korean/En
 
 ### Configuration and operations
 
+**Reasoning output change:** with `INCLUDE_REASONING=true`, reasoning is returned separately as `delta.reasoning_content` (streaming) or `message.reasoning_content` (non-streaming), not appended to `content`. Clients that display reasoning must read that field. Non-streaming Provider retries count reasoning as visible only when enabled, avoiding both blank success with hidden reasoning and unnecessary retries for exposed reasoning.
+
+Image inputs are removed for the CLI 1.53.0 text-only model list in both Alpha and Provider modes, including aliases. The newest image-bearing message gets numbered text markers; historical images are omitted. Vision models retain images, while unknown/custom models follow the CLI's image-capable fallback, not a guarantee of actual vision support. Alpha sends base64 data URIs as native image parts with `mimeType`; remote URLs remain text placeholders and are not downloaded.
+
 Upgrades from a persisted dashboard catalog preserve each current model's enabled state and all custom models, while refreshing built-in metadata from the 1.53.0 canonical definitions. Retired built-ins, including Ox Alpha and the MiniMax M3/M2.7 Free models, are removed rather than forwarded as unknown upstream models; a retired configured default falls back to `deepseek/deepseek-v4-pro`.
 
 Existing browsers with a saved key continue without interruption. On a fresh browser, enter the current key in **Current Admin API Key** before saving or restarting. A runtime with no key can bootstrap only from a real loopback connection whose Host is also loopback.

README.zh.md

@@ -208,6 +208,10 @@ curl -sS http://127.0.0.1:9992/v1/chat/completions \
 
 ### 配置与运维
 
+**Reasoning 输出变更：** 启用 `INCLUDE_REASONING=true` 时，reasoning 不再追加到 `content`，而是通过流式的 `delta.reasoning_content` 或非流式的 `message.reasoning_content` 单独返回。需要展示 reasoning 的客户端必须读取该字段。Provider 非流式重试仅在启用时将 reasoning 计为可见输出，避免隐藏 reasoning 导致空响应被当作成功，也避免对已展示的 reasoning 进行不必要的重试。
+
+Alpha 和 Provider 均根据 CLI 1.53.0 的纯文本模型列表移除图片输入，别名也适用。最新的图片消息会得到带编号的文本标记，历史图片则被省略。视觉模型保留图片；未知或自定义模型遵循 CLI 允许图片的默认行为，但这不保证实际支持视觉。Alpha 将 base64 data URI 作为带有 `mimeType` 的原生图片部分发送；远程 URL 保留为文本占位符，不会被下载。
+
 从持久化的 dashboard catalog 升级时，会保留当前 model 的 enabled state 和所有 custom model，并用 1.53.0 canonical 定义刷新 built-in metadata。包括 Ox Alpha 和 MiniMax M3/M2.7 Free 在内的 retired built-in 不会作为 unknown upstream model 转发；若 default 已退役，则安全回退到 `deepseek/deepseek-v4-pro`。
 
 浏览器已保存 key 的现有用户可继续使用。新浏览器在保存或重启前，需要在 **当前管理员 API Key** 中输入一次现有 key。无 key runtime 仅在真实 loopback 连接且 Host 也是 loopback 时允许 bootstrap。

docs/DEPLOYMENT.ko.md

@@ -375,17 +375,17 @@ npm run smoke
 
 ### 서버와 client auth 옵션
 
-| 변수                       | 기본값      | 설명                                                                                                                  |
-| -------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------- |
-| `HOST`                     | `127.0.0.1` | bind 주소입니다. local-only면 `127.0.0.1`, Tailscale/VPN/reverse proxy 뒤에서 접근하려면 `0.0.0.0`을 사용합니다.      |
-| `PORT`                     | `9992`      | HTTP listen port입니다.                                                                                               |
-| `BRIDGE_API_KEY`           | 미설정      | client-facing bearer key입니다. 강력 권장합니다. Admin endpoint는 이 값이 설정되어 있어야 접근 가능합니다.            |
-| `REQUEST_BODY_LIMIT_BYTES` | `1048576`   | Fastify request body limit입니다. 매우 큰 prompt/tool schema를 받을 때만 늘리십시오.                                  |
-| `RATE_LIMIT_MAX`           | `60`        | client별 rate-limit window 안에서 허용할 최대 request 수입니다.                                                       |
-| `RATE_LIMIT_WINDOW`        | `1 minute`  | `@fastify/rate-limit`이 이해하는 window 문자열입니다.                                                                 |
-| `LOG_LEVEL`                | `info`      | Pino/Fastify log level입니다. 보통 `debug`, `info`, `warn`, `error`, `silent`를 사용합니다.                           |
-| `CORS_ORIGIN`              | 미설정      | browser client 특정 origin에 CORS를 열 때 사용합니다. CLI/server client만 쓰면 비워두십시오.                          |
-| `INCLUDE_REASONING`        | `false`     | `true`면 reasoning delta를 visible content에 붙입니다. 일반 OpenAI-compatible client에서는 `false` 유지가 안전합니다. |
+| 변수                       | 기본값      | 설명                                                                                                                                            |
+| -------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `HOST`                     | `127.0.0.1` | bind 주소입니다. local-only면 `127.0.0.1`, Tailscale/VPN/reverse proxy 뒤에서 접근하려면 `0.0.0.0`을 사용합니다.                                |
+| `PORT`                     | `9992`      | HTTP listen port입니다.                                                                                                                         |
+| `BRIDGE_API_KEY`           | 미설정      | client-facing bearer key입니다. 강력 권장합니다. Admin endpoint는 이 값이 설정되어 있어야 접근 가능합니다.                                      |
+| `REQUEST_BODY_LIMIT_BYTES` | `1048576`   | Fastify request body limit입니다. 매우 큰 prompt/tool schema를 받을 때만 늘리십시오.                                                            |
+| `RATE_LIMIT_MAX`           | `60`        | client별 rate-limit window 안에서 허용할 최대 request 수입니다.                                                                                 |
+| `RATE_LIMIT_WINDOW`        | `1 minute`  | `@fastify/rate-limit`이 이해하는 window 문자열입니다.                                                                                           |
+| `LOG_LEVEL`                | `info`      | Pino/Fastify log level입니다. 보통 `debug`, `info`, `warn`, `error`, `silent`를 사용합니다.                                                     |
+| `CORS_ORIGIN`              | 미설정      | browser client 특정 origin에 CORS를 열 때 사용합니다. CLI/server client만 쓰면 비워두십시오.                                                    |
+| `INCLUDE_REASONING`        | `false`     | `true`면 reasoning delta가 `content` 대신 `reasoning_content` 필드로 반환됩니다. 일반 OpenAI-compatible client에서는 `false` 유지가 안전합니다. |
 
 ### CommandCode upstream 옵션
 
@@ -451,6 +451,14 @@ Credential JSON 파일 예시:
 
 이 정책은 reasoning-heavy model이 hidden token만 쓰다가 끝난 응답을 client가 정상 빈 답변으로 오인하지 않게 막습니다.
 
+Provider 비스트리밍 응답에서는 `INCLUDE_REASONING=true`일 때만 `reasoning_content`를 사용자에게 보이는 출력으로 셉니다. 이 경우 reasoning만 있는 응답도 빈 응답 재시도 없이 반환합니다. 옵션을 끄면 숨겨진 reasoning은 빈 `length` 응답의 재시도 소진과 오류 반환을 막지 않습니다. 텍스트와 tool call은 옵션과 관계없이 유효한 출력입니다.
+
+### 모델의 이미지 입력
+
+Alpha와 Provider 요청 변환 모두 `src/model-images.ts`에 기록된 CommandCode CLI 1.53.0 모델 목록을 기준으로 텍스트 전용 모델의 이미지 입력을 제거합니다. 별칭에도 같은 정책을 적용합니다. 이전 이미지 입력은 제거하고, 가장 최근 이미지가 포함된 user 또는 tool 메시지에는 번호가 붙은 텍스트 마커를 넣습니다. 이미지만 있던 과거 메시지에는 생략 마커를 남겨 빈 메시지가 되지 않도록 합니다. 입력 대화 객체는 변경하지 않습니다.
+
+비전 모델의 이미지는 유지합니다. 알 수 없는 모델이나 custom 모델은 CLI와 같이 이미지 입력을 허용하는 기본 동작을 따르므로, 텍스트 전용 목록에 없다고 실제 상류의 비전 지원이 보장되지는 않습니다. 향후 CLI 카탈로그 정렬 시 이 목록도 함께 갱신해야 합니다. Alpha에서는 base64 data URI를 `mimeType`이 있는 네이티브 이미지 파트로 변환하며, 원격 URL은 텍스트 자리표시자로 유지하고 bridge가 내려받지 않습니다.
+
 ### Balance alert 옵션
 
 Balance alert는 기본적으로 꺼져 있습니다.

docs/DEPLOYMENT.md

@@ -376,17 +376,17 @@ npm run smoke
 
 ### Server and client-auth options
 
-| Variable                   | Default     | Description                                                                                                 |
-| -------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------- |
-| `HOST`                     | `127.0.0.1` | Bind address. Use `127.0.0.1` for local-only, `0.0.0.0` for Tailscale/VPN/reverse-proxy exposure.           |
-| `PORT`                     | `9992`      | HTTP listen port.                                                                                           |
-| `BRIDGE_API_KEY`           | unset       | Client-facing bearer key. Strongly recommended; required for admin endpoints.                               |
-| `REQUEST_BODY_LIMIT_BYTES` | `1048576`   | Fastify request body limit. Increase only for unusually large prompts/tool schemas.                         |
-| `RATE_LIMIT_MAX`           | `60`        | Max requests per rate-limit window per client.                                                              |
-| `RATE_LIMIT_WINDOW`        | `1 minute`  | Rate-limit window string accepted by `@fastify/rate-limit`.                                                 |
-| `LOG_LEVEL`                | `info`      | Pino/Fastify log level. Common values: `debug`, `info`, `warn`, `error`, `silent`.                          |
-| `CORS_ORIGIN`              | unset       | Enables CORS for a specific browser origin. Leave unset for non-browser clients.                            |
-| `INCLUDE_REASONING`        | `false`     | If `true`, reasoning deltas are appended to visible content. Keep `false` for normal OpenAI-compatible use. |
+| Variable                   | Default     | Description                                                                                                                              |
+| -------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `HOST`                     | `127.0.0.1` | Bind address. Use `127.0.0.1` for local-only, `0.0.0.0` for Tailscale/VPN/reverse-proxy exposure.                                        |
+| `PORT`                     | `9992`      | HTTP listen port.                                                                                                                        |
+| `BRIDGE_API_KEY`           | unset       | Client-facing bearer key. Strongly recommended; required for admin endpoints.                                                            |
+| `REQUEST_BODY_LIMIT_BYTES` | `1048576`   | Fastify request body limit. Increase only for unusually large prompts/tool schemas.                                                      |
+| `RATE_LIMIT_MAX`           | `60`        | Max requests per rate-limit window per client.                                                                                           |
+| `RATE_LIMIT_WINDOW`        | `1 minute`  | Rate-limit window string accepted by `@fastify/rate-limit`.                                                                              |
+| `LOG_LEVEL`                | `info`      | Pino/Fastify log level. Common values: `debug`, `info`, `warn`, `error`, `silent`.                                                       |
+| `CORS_ORIGIN`              | unset       | Enables CORS for a specific browser origin. Leave unset for non-browser clients.                                                         |
+| `INCLUDE_REASONING`        | `false`     | If `true`, reasoning deltas return in the `reasoning_content` field instead of `content`. Keep `false` for normal OpenAI-compatible use. |
 
 ### CommandCode upstream options
 
@@ -452,6 +452,14 @@ When upgrading a persisted 1.3.1 dashboard catalog, enabled state and custom mod
 
 This protects clients from treating hidden-token exhaustion as a valid empty answer.
 
+For non-streaming Provider responses, `reasoning_content` counts as visible output only when `INCLUDE_REASONING=true`. Reasoning-only responses then return without an empty-response retry. With the flag off, hidden reasoning does not prevent an empty `length` response from exhausting retries and returning an error. Text and tool calls remain valid output regardless of the flag.
+
+### Model image input
+
+Both Alpha and Provider request builders remove image inputs for text-only models using the CommandCode CLI 1.53.0 model list in `src/model-images.ts`. Aliases resolve to the same policy. Older image inputs are removed; the latest image-bearing user or tool message receives numbered text markers instead. Image-only historical messages retain an omission marker so the message is not empty. The input conversation is not mutated.
+
+Vision-capable models keep their images. Unknown/custom models follow the CLI's image-capable fallback; absence from the text-only list is not a guarantee of upstream vision support. Update the list alongside future CLI catalog alignments. Alpha converts base64 data URIs to native image parts with `mimeType`; remote URLs remain text placeholders and are not downloaded by the bridge.
+
 ### Balance alert options
 
 Balance alerts are disabled by default.