aliyun-codex-bridge 0.1.0

package/docs/DIFF_WITH_DIONANOS_MAIN.md

@@ -0,0 +1,96 @@
+# Diff Record vs DioNanos/zai-codex-bridge
+
+Generated on: 2026-03-04  
+Baseline: `https://github.com/DioNanos/zai-codex-bridge` `main` @ `e1a5392`
+
+## Summary
+
+- Modified files: 8
+- Added local files (not in baseline): 2
+- `git diff --stat dionanos/main`: 139 insertions, 303 deletions
+
+## Modified Files
+
+### `src/server.js`
+
+- Rebranded header/log text from `zai-codex-bridge` to `aliyun-codex-bridge`.
+- Replaced single upstream env var with prioritized base URL chain:
+  `AI_BASE` -> `AI_BASE_URL` -> `ZAI_BASE_URL`.
+- Changed role toggle default:
+  `ALLOW_SYSTEM` now defaults to enabled (`!== '0'`).
+- Added `FORCE_ENV_AUTH` (default enabled) to avoid forwarding caller auth unless explicitly allowed.
+- Added `extractToolCallsFromChoice()`:
+  supports `delta.tool_calls`, `choice.message.tool_calls`, `choice.tool_calls`.
+- Added `normalizeToolName()` and broadened tool normalization:
+  accepts non-function shapes, normalizes names, bridges `input_schema`.
+- Changed `developer` role mapping:
+  now maps to `system` when `ALLOW_SYSTEM` is enabled.
+- Added `status` to function-call output items:
+  `in_progress` for `response.output_item.added`,
+  `completed` for `response.output_item.done` and non-streaming output.
+- Auth env var family switched from `ZAI_API_KEY*` to `AI_API_KEY*` (+ fallback `OPENAI_API_KEY`).
+- If no env auth and forwarding disabled, now fails fast with explicit missing-key error.
+- Startup logging now prints `AI_BASE_URL`.
+- File mode changed from `100755` to `100644`.
+
+### `package.json`
+
+- Package name changed:
+  `@mmmbuto/zai-codex-bridge` -> `aliyun-codex-bridge`.
+- Added second bin entry:
+  `aliyun-codex-bridge` -> `bin/aliyun-codex-bridge`.
+- Repository URL changed to:
+  `https://github.com/sea-monsters/aliyun-codex-bridge.git`.
+
+### `bin/zai-codex-bridge`
+
+- Replaced full CLI implementation with thin wrapper:
+  now only `require('./aliyun-codex-bridge')`.
+- Previous in-file argument parser/help/update logic removed from this file and moved to shared/new CLI entry.
+
+### `README.md`
+
+- Project/package/repo names rebranded to `aliyun-codex-bridge`.
+- Install/command examples switched from `zai-codex-bridge` to `aliyun-codex-bridge`.
+- CLI option docs changed from `--zai-base-url` to `--ai-base-url` (with alias support noted elsewhere).
+- Environment examples changed:
+  `ZAI_BASE_URL` -> `AI_BASE`,
+  `ZAI_API_KEY*` -> `AI_API_KEY*`.
+- `ALLOW_SYSTEM` guidance inverted to disable on incompat providers (`ALLOW_SYSTEM=0`).
+
+### `docs/guide.md`
+
+- Rebranded all path/command references to `aliyun-codex-bridge`.
+- Env var examples changed from `ZAI_API_KEY_*` to `AI_API_KEY_*`.
+- Log file names and troubleshooting commands renamed accordingly.
+
+### `scripts/test-curl.js`
+
+- Rebranded script banner and comments to `aliyun-codex-bridge`.
+- Switched auth env var lookup and messaging:
+  `ZAI_API_KEY*` -> `AI_API_KEY*`.
+- Authorization header now uses `AI_API_KEY` variable.
+
+### `RELEASING.md`
+
+- Rebranded package name in release docs.
+- API key export sample changed to `AI_API_KEY`.
+- Version policy examples changed to align with `0.1.0`.
+
+### `CHANGELOG.md`
+
+- Added unreleased fix notes for:
+  1) stream tool-call extraction from multiple chunk shapes,
+  2) `function_call` status fields for Responses API compatibility.
+
+## Added Local Files (Not in Baseline)
+
+### `bin/aliyun-codex-bridge`
+
+- New primary CLI entry containing:
+  argument parsing, help text, config loading, optional auto-update, and server bootstrap.
+- Supports `--ai-base-url` and compatibility alias `--zai-base-url`.
+
+### `package-lock.json`
+
+- New npm lockfile (lockfileVersion 3) matching package metadata and bin entries.

package/docs/guide.md

@@ -0,0 +1,406 @@
+# Coding Plan Dashscope Proxy - Complete Guide
+
+**Purpose**: Practical guide for using Coding Plan Dashscope with Codex CLI through the `aliyun-codex-bridge` proxy.
+
+---
+
+## Quick Start
+
+### First Time Setup
+
+```bash
+# 1. Install the proxy globally
+cd ~/Dev/aliyun-codex-bridge
+npm install -g .
+
+# 2. Reload .zshrc for the new functions
+source ~/.zshrc
+
+# 3. Start Codex with GLM-4.7
+codex-glm-a
+```
+
+### Daily Usage
+
+```bash
+# Start with account A
+codex-glm-a
+
+# Start with account P
+codex-glm-p
+
+# Exit Codex
+Ctrl+D
+# Proxy is automatically terminated
+```
+
+---
+
+## Prerequisites
+
+### 1. Environment Variables
+
+Ensure you have API keys in your `.zshrc` or `.zshenv`:
+
+```bash
+# Coding Plan Dashscope API Key
+export AI_API_KEY="sk-your-key"
+```
+
+### 2. Proxy Installed
+
+```bash
+# Global installation (recommended)
+cd ~/Dev/aliyun-codex-bridge
+npm install -g .
+
+# Verify installation
+which aliyun-codex-bridge
+```
+
+### 3. Codex Configuration
+
+The file `~/.codex/config.toml` must contain:
+
+```toml
+[model_providers.ai_proxy]
+name = "Coding Plan Dashscope via local proxy"
+base_url = "http://127.0.0.1:31415/v1"
+env_key = "AI_API_KEY"
+wire_api = "responses"
+stream_idle_timeout_ms = 3000000
+```
+
+---
+
+## How It Works
+
+### Architecture
+
+```
+.zshrc → _codex_glm_with_proxy() → Codex → Proxy (port 31415) → Coding Plan Dashscope API
+                                            ↓
+                                    Translates:
+                                    Responses → Chat
+                                    Chat → Responses
+```
+
+### Execution Flow
+
+1. User runs `codex-glm-a`
+2. Function checks if proxy is active on port 31415
+3. If NO:
+   - Starts proxy in background
+   - Saves PID
+   - Sets trap for cleanup
+   - Waits up to 2 seconds for proxy to be ready
+4. Codex starts with provider `ai_proxy`
+5. Request: Codex → Proxy → Translated to Chat → Coding Plan Dashscope
+6. Response: Coding Plan Dashscope → Chat → Proxy → Translated to Responses → Codex
+7. User exits Codex (Ctrl+D)
+8. Trap kills the proxy (only if this function started it)
+
+---
+
+## Usage Examples
+
+### Example 1: Simple Conversation
+
+```bash
+# Start
+codex-glm-a
+
+# In Codex prompt:
+> What is 23 * 47?
+
+# GLM-4.7 responds:
+> The result of 23 * 47 is 1081.
+
+# Exit
+Ctrl+D
+# Proxy automatically terminated
+```
+
+### Example 2: Code Analysis
+
+```bash
+# Start with additional arguments
+codex-glm-a -s workspace-write
+
+# In Codex prompt:
+> Read main.py and tell me what it does
+
+# Codex will read the file and GLM-4.7 will analyze the code
+```
+
+### Example 3: Multi-Session
+
+```bash
+# Terminal 1
+codex-glm-a
+# Proxy starts (PID 12345)
+
+# Terminal 2 (while terminal 1 is still open)
+codex-glm-a
+# Proxy ALREADY ACTIVE, gets reused
+# No new process spawned
+
+# Terminal 1: Ctrl+D
+# Codex exits but proxy STAYS active (for terminal 2)
+
+# Terminal 2: Ctrl+D
+# Codex exits but proxy STAYS active (didn't start it)
+```
+
+### Example 4: Debug Proxy
+
+```bash
+# Start proxy manually with debug
+aliyun-codex-bridge --log-level debug --port 31415
+
+# In another terminal, test
+curl http://127.0.0.1:31415/health
+# {"ok":true}
+
+# Now start codex manually
+AI_API_KEY="$AI_API_KEY" \
+  codex -m "GLM-4.7" -c model_provider="ai_proxy"
+```
+
+---
+
+## Troubleshooting
+
+### Proxy Won't Start
+
+**Symptom**: `codex-glm-a` hangs or errors
+
+**Solution**:
+```bash
+# Verify installation
+which aliyun-codex-bridge
+
+# If not found, reinstall
+cd ~/Dev/aliyun-codex-bridge
+npm install -g .
+```
+
+### Port Already in Use
+
+**Symptom**: `Error: listen EADDRINUSE: address already in use :::31415`
+
+**Solution**:
+```bash
+# Find process
+lsof -i :31415
+# or
+netstat -tulpn | grep 31415
+
+# If it's an old proxy, kill it
+kill -9 <PID>
+
+# Or use different port - just use:
+codex-glm-a  # will use existing proxy
+```
+
+### Coding Plan Dashscope Error 1214
+
+**Symptom**: `{"error":{"code":"1214","message":"Incorrect role information"}}`
+
+**Cause**: Using wrong provider
+
+**Solution**:
+```bash
+# VERIFY in ~/.codex/config.toml
+# You must use: model_provider="ai_proxy"
+# NOT: deprecated provider aliases
+```
+
+### Proxy Won't Stop
+
+**Symptom**: Proxy remains active after closing Codex
+
+**Solution**:
+```bash
+# Find and kill manually
+ps aux | grep aliyun-codex-bridge
+kill <PID>
+
+# Or use dedicated command
+pkill -f aliyun-codex-bridge
+```
+
+### Debug Logging
+
+```bash
+# Proxy logs are in:
+cat /tmp/aliyun-codex-bridge.log
+
+# For real-time logs:
+tail -f /tmp/aliyun-codex-bridge.log
+
+# Restart with debug:
+codex-glm-a  # proxy will write detailed logs
+```
+
+---
+
+## Health Checks
+
+### Health Check
+
+```bash
+# Verify proxy is active
+curl http://127.0.0.1:31415/health
+# Expected: {"ok":true}
+```
+
+### Verify Configuration
+
+```bash
+# Check provider in config
+grep -A 5 "ai_proxy" ~/.codex/config.toml
+
+# Check functions in .zshrc
+grep -A 30 "_codex_glm_with_proxy" ~/.zshrc
+```
+
+### Full Test
+
+```bash
+# 1. Test proxy
+aliyun-codex-bridge --help
+
+# 2. Test health
+curl http://127.0.0.1:31415/health
+
+# 3. Test Codex
+codex-glm-a --help
+
+# 4. Interactive test
+codex-glm-a
+# > Tell me 2+2
+# Ctrl+D
+```
+
+---
+
+## Function Reference
+
+### `_codex_glm_with_proxy()`
+
+**Parameters**:
+- `$1` - API key to use (`$AI_API_KEY`)
+- `$@` - Additional arguments passed to Codex
+
+**Behavior**:
+1. Checks health at `http://127.0.0.1:31415/health`
+2. If fails:
+   - Starts `aliyun-codex-bridge` in background
+   - Redirects log to `/tmp/aliyun-codex-bridge.log`
+   - Saves PID in `$PROXY_PID`
+   - Sets trap to kill proxy on EXIT
+   - Waits up to 2 seconds for proxy to be ready
+3. Executes `codex` with provider `ai_proxy`
+
+### `codex-glm-a()`
+
+**Usage**: Account A
+```bash
+codex-glm-a [codex options]
+```
+
+**Example**:
+```bash
+codex-glm-a -s workspace-write
+codex-glm-a --help
+```
+
+### `codex-glm-p()`
+
+**Usage**: Account P
+```bash
+codex-glm-p [codex options]
+```
+
+---
+
+## Advanced Configuration
+
+### Change Port
+
+Modify the function in `~/.zshrc`:
+
+```bash
+_codex_glm_with_proxy () {
+  local KEY="$1"; shift
+  local HOST="127.0.0.1"
+  local PORT="8080"  # ← Change here
+  # ...
+}
+```
+
+And update `~/.codex/config.toml`:
+
+```toml
+[model_providers.ai_proxy]
+base_url = "http://127.0.0.1:8080/v1"
+```
+
+### Verbose Logging
+
+Modify the log level in the proxy command:
+
+```bash
+aliyun-codex-bridge --host "$HOST" --port "$PORT" --log-level debug >"$LOGFILE" 2>&1 &
+```
+
+---
+
+## Performance
+
+### Startup Times
+
+| Operation | Time |
+|-----------|------|
+| Health check (proxy running) | ~50ms |
+| Health check (proxy not running) | ~2s |
+| Proxy startup | ~500ms |
+| Codex startup | ~1s |
+| **Total (first time)** | **~3.5s** |
+| **Total (proxy already up)** | **~1.5s** |
+
+### Memory
+
+| Process | RAM |
+|----------|-----|
+| aliyun-codex-bridge | ~30-50MB |
+| codex CLI | ~100-200MB |
+| **Total** | **~130-250MB** |
+
+---
+
+## Setup Checklist
+
+- [ ] Proxy installed: `npm install -g aliyun-codex-bridge`
+- [ ] API key set: `export AI_API_KEY=...`
+- [ ] Provider configured: `[model_providers.ai_proxy]` in config.toml
+- [ ] Functions updated: `source ~/.zshrc`
+- [ ] Test health: `curl http://127.0.0.1:31415/health`
+- [ ] Full test: `codex-glm-a`
+
+---
+
+## Related Files
+
+- **Proxy Code**: `~/Dev/aliyun-codex-bridge/`
+- **Codex Config**: `~/.codex/config.toml`
+- **ZSH Functions**: `~/.zshrc`
+
+---
+
+## License
+
+MIT
+
+

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "aliyun-codex-bridge",
+  "version": "0.1.0",
+  "description": "Local proxy that translates OpenAI Responses API format to Coding Plan Dashscope Chat Completions format for Codex",
+  "main": "src/server.js",
+  "bin": {
+    "aliyun-codex-bridge": "bin/aliyun-codex-bridge",
+    "zai-codex-bridge": "bin/zai-codex-bridge"
+  },
+  "scripts": {
+    "start": "node src/server.js",
+    "test": "node scripts/test-curl.js",
+    "test:curl": "node scripts/test-curl.js",
+    "release:patch": "node scripts/release-patch.js"
+  },
+  "keywords": [
+    "codex",
+    "zai",
+    "glm",
+    "proxy",
+    "openai",
+    "responses-api",
+    "chat-completions"
+  ],
+  "author": "Davide A. Guglielmi",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sea-monsters/aliyun-codex-bridge.git"
+  }
+}

package/scripts/prepare-clean-release.ps1

@@ -0,0 +1,32 @@
+Param(
+  [switch]$WhatIfOnly
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = "Stop"
+
+$root = Split-Path -Parent $PSScriptRoot
+
+$patterns = @(
+  "response.log",
+  "logs\*.log",
+  "*.tmp",
+  "tmp\*"
+)
+
+Write-Host "[clean] root=$root"
+foreach ($pattern in $patterns) {
+  $path = Join-Path $root $pattern
+  $items = Get-ChildItem -Path $path -Force -ErrorAction SilentlyContinue
+  foreach ($item in $items) {
+    if ($WhatIfOnly) {
+      Write-Host "[clean] would remove $($item.FullName)"
+    } else {
+      Remove-Item -Path $item.FullName -Force -Recurse -ErrorAction SilentlyContinue
+      Write-Host "[clean] removed $($item.FullName)"
+    }
+  }
+}
+
+Write-Host "[clean] done"
+

package/scripts/release-patch.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+
+/**
+ * Safe patch version bumper
+ * Only allows patch releases from 0.1.0 base line
+ * Refuses minor/major bumps
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PACKAGE_PATH = path.join(__dirname, '..', 'package.json');
+
+function bumpPatch(version) {
+  const parts = version.split('.').map(Number);
+
+  if (parts.length !== 3) {
+    throw new Error(`Invalid version format: ${version}`);
+  }
+
+  const [major, minor, patch] = parts;
+
+  // Only allow 0.1.x versions
+  if (major !== 0 || minor !== 1) {
+    console.error(`ERROR: Current version is ${version}`);
+    console.error('This script only supports patch releases for 0.1.x versions.');
+    console.error('For other version changes, edit package.json manually.');
+    process.exit(1);
+  }
+
+  const newVersion = `0.1.${patch + 1}`;
+  return newVersion;
+}
+
+function main() {
+  // Read package.json
+  const pkg = JSON.parse(fs.readFileSync(PACKAGE_PATH, 'utf8'));
+  const currentVersion = pkg.version;
+
+  console.log(`Current version: ${currentVersion}`);
+
+  // Bump patch
+  const newVersion = bumpPatch(currentVersion);
+  console.log(`Bumping to: ${newVersion}`);
+
+  // Update package.json
+  pkg.version = newVersion;
+
+  // Write back
+  fs.writeFileSync(PACKAGE_PATH, JSON.stringify(pkg, null, 2) + '\n');
+
+  console.log('Updated package.json');
+  console.log('\nNext steps:');
+  console.log('  1. Update CHANGELOG.md');
+  console.log('  2. Commit: git add package.json CHANGELOG.md && git commit -m "chore: release v' + newVersion + '"');
+  console.log('  3. Tag: git tag v' + newVersion);
+  console.log('  4. Publish: npm publish');
+}
+
+main();

package/scripts/start-aliyun-codex-bridge.vbs

@@ -0,0 +1,68 @@
+Option Explicit
+
+' Windows autostart launcher for aliyun-codex-bridge
+' Usage:
+'   wscript scripts\start-aliyun-codex-bridge.vbs [host] [port] [ai_base] [log_level]
+' Example:
+'   wscript scripts\start-aliyun-codex-bridge.vbs 127.0.0.1 31415 https://coding.dashscope.aliyuncs.com/v1 info
+
+Const DEFAULT_HOST = "127.0.0.1"
+Const DEFAULT_PORT = "4000"
+Const DEFAULT_LOG_LEVEL = "info"
+
+Dim shell, fso, args
+Dim host, port, aiBase, logLevel
+Dim scriptPath, scriptsDir, repoDir, logsDir, logFile
+Dim checkCmd, startCmd, rc, aiBasePart
+
+Set shell = CreateObject("WScript.Shell")
+Set fso = CreateObject("Scripting.FileSystemObject")
+Set args = WScript.Arguments
+
+host = DEFAULT_HOST
+port = DEFAULT_PORT
+aiBase = ""
+logLevel = DEFAULT_LOG_LEVEL
+
+If args.Count >= 1 Then host = args(0)
+If args.Count >= 2 Then port = args(1)
+If args.Count >= 3 Then aiBase = args(2)
+If args.Count >= 4 Then logLevel = args(3)
+
+scriptPath = WScript.ScriptFullName
+scriptsDir = fso.GetParentFolderName(scriptPath)
+repoDir = fso.GetParentFolderName(scriptsDir)
+
+logsDir = repoDir & "\logs"
+If Not fso.FolderExists(logsDir) Then
+  fso.CreateFolder logsDir
+End If
+logFile = logsDir & "\bridge.log"
+
+' If port already listening, skip startup.
+checkCmd = "powershell -NoProfile -ExecutionPolicy Bypass -Command " & Q("$p=" & port & "; if (Get-NetTCPConnection -LocalPort $p -State Listen -ErrorAction SilentlyContinue) { exit 0 } else { exit 1 }")
+rc = shell.Run(checkCmd, 0, True)
+If rc = 0 Then
+  WScript.Quit 0
+End If
+
+aiBasePart = ""
+If Len(aiBase) > 0 Then
+  aiBasePart = " && set " & Q("AI_API_BASE=" & aiBase)
+End If
+
+startCmd = "cmd.exe /c " & Q( _
+  "cd /d " & Q(repoDir) & _
+  " && set " & Q("HOST=" & host) & _
+  " && set " & Q("PORT=" & port) & _
+  aiBasePart & _
+  " && set " & Q("LOG_LEVEL=" & logLevel) & _
+  " && node src\server.js >> " & Q(logFile) & " 2>&1")
+
+' Hidden window, do not wait
+shell.Run startCmd, 0, False
+WScript.Quit 0
+
+Function Q(ByVal s)
+  Q = Chr(34) & s & Chr(34)
+End Function