@jsonstudio/rcc 0.89.1348 → 0.89.1457

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jsonstudio/rcc",
-  "version": "0.89.1348",
+  "version": "0.89.1457",
   "description": "Multi-provider OpenAI proxy server with anthropic/responses/chat support (release)",
   "type": "module",
   "main": "dist/index.js",
@@ -39,7 +39,12 @@
     "dev": "tsx watch src/index.ts",
     "jest:run": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js",
     "test": "npm run test:routing-instructions && npm run mock:regressions",
-    "test:routing-instructions": "npm run jest:run -- --runTestsByPath tests/server/runtime/request-executor.single-attempt.spec.ts tests/server/runtime/executor-provider.retryable.spec.ts tests/providers/core/runtime/gemini-cli-http-provider.unit.test.ts tests/providers/core/runtime/antigravity-quota-client.unit.test.ts tests/manager/quota/provider-quota-center.spec.ts tests/manager/quota/provider-quota-store.spec.ts tests/manager/quota/quota-manager-refresh.spec.ts tests/manager/quota/provider-quota-daemon-module.spec.ts tests/manager/quota/provider-key-normalization.spec.ts tests/server/http-server/daemon-admin.e2e.spec.ts tests/server/http-server/quota-view-injection.spec.ts tests/server/http-server/quota-refresh-triggers.e2e.spec.ts tests/server/http-server/hub-policy-injection.spec.ts tests/server/http-server/session-header-injection.spec.ts tests/server/http-server/session-dir.spec.ts tests/server/handlers/sse-timeout.spec.ts tests/utils/is-direct-execution.test.ts tests/utils/windows-netstat.test.ts tests/servertool/virtual-router-context-fallback.spec.ts tests/servertool/virtual-router-longcontext-fallback.spec.ts tests/servertool/virtual-router-series-cooldown.spec.ts tests/servertool/recursive-detection-guard.spec.ts tests/servertool/routing-instructions.spec.ts tests/servertool/stop-message-auto.spec.ts tests/servertool/stopmessage-session-scope.spec.ts tests/servertool/stopmessage-anthropic-stop-sequence.spec.ts tests/servertool/servertool-progress-logging.spec.ts tests/unified-hub/hub-v1-single-path-imports.spec.ts",
+    "test:ci:jest": "node scripts/tests/ci-jest.mjs",
+    "test:ci:jest:coverage": "node scripts/tests/ci-jest.mjs --coverage",
+    "test:ci": "npm run test:ci:jest && npm run mock:regressions",
+    "test:ci:coverage": "npm run test:ci:jest:coverage",
+    "verify:repo-sanity": "node scripts/ci/repo-sanity.mjs",
+    "test:routing-instructions": "npm run jest:run -- --runTestsByPath tests/server/runtime/request-executor.single-attempt.spec.ts tests/server/runtime/executor-provider.retryable.spec.ts tests/providers/auth/tokenfile-auth.iflow.spec.ts tests/providers/core/runtime/gemini-cli-http-provider.unit.test.ts tests/providers/core/runtime/antigravity-quota-client.unit.test.ts tests/manager/quota/provider-quota-center.spec.ts tests/manager/quota/provider-quota-store.spec.ts tests/manager/quota/quota-manager-refresh.spec.ts tests/manager/quota/provider-quota-daemon-module.spec.ts tests/manager/quota/provider-key-normalization.spec.ts tests/server/http-server/daemon-admin.e2e.spec.ts tests/server/http-server/quota-view-injection.spec.ts tests/server/http-server/quota-refresh-triggers.e2e.spec.ts tests/server/http-server/hub-policy-injection.spec.ts tests/server/http-server/session-header-injection.spec.ts tests/server/http-server/session-dir.spec.ts tests/server/handlers/sse-timeout.spec.ts tests/utils/is-direct-execution.test.ts tests/utils/windows-netstat.test.ts tests/servertool/virtual-router-context-fallback.spec.ts tests/servertool/virtual-router-longcontext-fallback.spec.ts tests/servertool/virtual-router-series-cooldown.spec.ts tests/servertool/recursive-detection-guard.spec.ts tests/servertool/routing-instructions.spec.ts tests/servertool/stop-message-auto.spec.ts tests/servertool/stopmessage-session-scope.spec.ts tests/servertool/stopmessage-anthropic-stop-sequence.spec.ts tests/servertool/servertool-progress-logging.spec.ts tests/servertool/servertool-clock.spec.ts tests/sharedmodule/gemini-mapper-functioncall-args.spec.ts tests/sharedmodule/mcp-tool-descriptions.spec.ts tests/unified-hub/hub-v1-single-path-imports.spec.ts",
     "test:cli": "npm run jest:run -- --runTestsByPath tests/cli/clean-command.spec.ts tests/cli/code-command.spec.ts tests/cli/config-command.spec.ts tests/cli/env-command.spec.ts tests/cli/env-output.spec.ts tests/cli/examples-command.spec.ts tests/cli/port-command.spec.ts tests/cli/port-utils.spec.ts tests/cli/restart-command.spec.ts tests/cli/smoke.spec.ts tests/cli/start-command.spec.ts tests/cli/status-command.spec.ts tests/cli/stop-command.spec.ts",
     "test:watch": "npm run jest:run -- --watch",
     "test:coverage": "npm run jest:run -- --coverage",
@@ -51,11 +56,11 @@
     "test:lmstudio-dryrun": "node tests/lmstudio-tools-bidir-dry-run.mjs",
     "test:unified-hub-shadow": "node scripts/tests/unified-hub-shadow-regression.mjs",
     "test:unified-hub-responses-enforce": "node scripts/tests/unified-hub-responses-enforce-safe.mjs",
-    "lint": "eslint --no-eslintrc -c .eslintrc.json src --ext .ts --no-cache",
-    "lint:fix": "eslint --no-eslintrc -c .eslintrc.json src --ext .ts --fix --no-cache",
-    "lint:strict": "eslint --no-eslintrc -c .eslintrc.json src --ext .ts --max-warnings 0 --no-cache",
+    "lint": "ESLINT_USE_FLAT_CONFIG=1 eslint \"src/**/*.ts\" --no-cache",
+    "lint:fix": "ESLINT_USE_FLAT_CONFIG=1 eslint \"src/**/*.ts\" --fix --no-cache",
+    "lint:strict": "ESLINT_USE_FLAT_CONFIG=1 eslint \"src/**/*.ts\" --max-warnings 0 --no-cache",
     "clean": "rm -rf dist coverage",
-    "prebuild": "echo skip-lint",
+    "prebuild": "npm run verify:repo-sanity && echo skip-lint",
     "prepare": "",
     "postinstall": "chmod +x dist/cli.js || true",
     "verify:apply-patch": "node scripts/verify-apply-patch.mjs",
@@ -65,6 +70,7 @@
     "verify:e2e-gemini-followup-sample": "node scripts/verify-e2e-gemini-followup-sample.mjs",
     "install:global": "./scripts/install-global.sh",
     "install:release": "./scripts/install-release.sh",
+    "release:rcc": "npm run pack:rcc",
     "audit:tool-text": "node scripts/audit-tool-text.mjs",
     "start:bg": "bash scripts/run-bg.sh -- 'node dist/index.js'",
     "start:fg": "bash scripts/run-fg-gtimeout.sh 12 -- 'node dist/index.js'",
@@ -81,10 +87,10 @@
     "verify:sse-loop": "node scripts/verify-sse-loop.mjs",
     "snapshot:inspect": "node scripts/snapshot-inspect.mjs",
     "policy:report": "node scripts/policy-violations-report.mjs",
-    "debug:responses": "tsx tools/responses-debug-client/src/index.ts",
-    "debug:responses:lmstudio:text": "tsx tools/responses-debug-client/src/index.ts --file tools/responses-debug-client/payloads/lmstudio-text.json --baseURL ${LMSTUDIO_BASEURL:-http://127.0.0.1:1234/v1}",
-    "debug:responses:lmstudio:tool": "tsx tools/responses-debug-client/src/index.ts --file tools/responses-debug-client/payloads/lmstudio-tool.json --baseURL ${LMSTUDIO_BASEURL:-http://127.0.0.1:1234/v1}",
-    "capture:responses:lmstudio": "node scripts/capture-responses-sse.mjs --file tools/responses-debug-client/payloads/lmstudio-tool.json",
+    "debug:responses": "tsx scripts/tools-dev/responses-debug-client/src/index.ts",
+    "debug:responses:lmstudio:text": "tsx scripts/tools-dev/responses-debug-client/src/index.ts --file scripts/tools-dev/responses-debug-client/payloads/text.json --baseURL ${LMSTUDIO_BASEURL:-http://127.0.0.1:1234/v1}",
+    "debug:responses:lmstudio:tool": "tsx scripts/tools-dev/responses-debug-client/src/index.ts --file scripts/tools-dev/responses-debug-client/payloads/tool.json --baseURL ${LMSTUDIO_BASEURL:-http://127.0.0.1:1234/v1}",
+    "capture:responses:lmstudio": "node scripts/capture-responses-sse.mjs --file scripts/tools-dev/responses-debug-client/payloads/tool.json",
     "llmswitch:ensure": "node scripts/ensure-llmswitch-mode.mjs",
     "llmswitch:link": "node scripts/link-llmswitch.mjs",
     "llmswitch:unlink": "node scripts/link-llmswitch.mjs unlink",
@@ -140,7 +146,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.65.0",
-    "@jsonstudio/llms": "^0.6.1172",
+    "@jsonstudio/llms": "^0.6.1354",
     "@lmstudio/sdk": "^1.5.0",
     "@radix-ui/react-switch": "^1.2.6",
     "@types/socket.io": "^3.0.1",

package/scripts/build-core.mjs

@@ -13,7 +13,9 @@ const coreRoot = path.join(root, 'sharedmodule', 'llmswitch-core');
 const outDir = path.join(coreRoot, 'dist');
 const requiredOutputs = [
   path.join(outDir, 'bridge', 'routecodex-adapter.js'),
-  path.join(outDir, 'conversion', 'hub', 'response', 'provider-response.js')
+  path.join(outDir, 'conversion', 'hub', 'response', 'provider-response.js'),
+  // RouteCodex runtime loads this module via llmswitch bridge; ensure dev builds produce it.
+  path.join(outDir, 'router', 'virtual-router', 'error-center.js')
 ];
 
 function fail(msg){ console.error(`[build-core] ${msg}`); process.exit(2); }

package/scripts/ci/repo-sanity.mjs

@@ -0,0 +1,138 @@
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+
+function runGit(args) {
+  const out = spawnSync('git', args, { encoding: 'utf8' });
+  if (out.status !== 0) {
+    throw new Error(`git ${args.join(' ')} failed: ${out.stderr || out.stdout}`);
+  }
+  return String(out.stdout || '');
+}
+
+function isIgnoredByGit(p) {
+  const out = spawnSync('git', ['check-ignore', '-q', p], { encoding: 'utf8' });
+  return out.status === 0;
+}
+
+function listRootEntries() {
+  const cwd = process.cwd();
+  return fs
+    .readdirSync(cwd, { withFileTypes: true })
+    .filter((d) => d.name !== '.git')
+    .filter((d) => !isIgnoredByGit(d.name))
+    .map((d) => d.name)
+    .sort();
+}
+
+function isForbiddenRootFile(p) {
+  const base = path.posix.basename(p);
+  const allow = new Set(['AGENTS.md', 'README.md', 'task.md']);
+  if (allow.has(base)) return false;
+  if (/^test-.*\.(mjs|js|ts|py)$/i.test(base)) return true;
+  if (/^debug-.*\.(mjs|js|ts)$/i.test(base)) return true;
+  if (/\.pid$/i.test(base)) return true;
+  if (/\.tgz$/i.test(base)) return true;
+  if (base === 'plan.md') return true;
+  if (base === 'task-fallback.md') return true;
+  if (base === 'task.archive.md') return true;
+  if (base === 'WARP.md') return true;
+  if (base === 'CLAUDE.md') return true;
+  if (/(_SUMMARY|_FIX)_/i.test(base) && base.toLowerCase().endsWith('.md')) return true;
+  // Disallow ad-hoc root markdown by default (docs belong under docs/).
+  if (base.toLowerCase().endsWith('.md')) return true;
+  return false;
+}
+
+function isForbiddenTrackedPath(p) {
+  // Keep the rules narrow and explicit: this is an audit guard, not a policy engine.
+  if (p.startsWith('docs/archive/')) return true;
+  if (p.startsWith('scripts/dev/')) return true;
+  if (p.startsWith('scripts/test-') && p.endsWith('.mjs')) return true;
+  if (p.startsWith('tools/')) return true;
+  if (p.startsWith('replay/')) return true;
+  if (p.startsWith('servertool/')) return true;
+  if (p.startsWith('verified-configs/')) return true;
+  if (p.startsWith('interpreter/')) return true;
+  if (p.startsWith('exporters/')) return true;
+  if (p.startsWith('bin/')) return true;
+  if (p.startsWith('.npm-cache-local/')) return true;
+  if (p.startsWith('.claude/')) return true;
+  if (p.startsWith('.iflow/')) return true;
+  if (p === '.secrets.baseline') return true;
+  if (p.endsWith('/.DS_Store') || p === '.DS_Store') return true;
+  return false;
+}
+
+function checkRootLayout() {
+  // Fixed top-level layout. Adding new root entries requires an explicit policy change.
+  const allowed = new Set([
+    'eslint.config.js',
+    '.github',
+    '.gitignore',
+    'AGENTS.md',
+    'README.md',
+    'config',
+    'configsamples',
+    'dist',
+    'docs',
+    'jest.config.js',
+    'node_modules',
+    'package',
+    'package-lock.json',
+    'package.json',
+    'rcc',
+    'samples',
+    'scripts',
+    'sharedmodule',
+    'src',
+    'task.md',
+    'tests',
+    'tmp',
+    'tsconfig.json',
+    'vendor',
+  ]);
+
+  const rootEntries = listRootEntries();
+  const unexpected = rootEntries.filter((name) => !allowed.has(name));
+  if (unexpected.length) {
+    console.error('[repo-sanity] unexpected root entries (top-level is fixed):');
+    for (const name of unexpected) console.error(`- ${name}`);
+    process.exit(2);
+  }
+}
+
+function checkUntrackedNotIgnored() {
+  // Fail fast if anything new appears outside gitignore (anywhere in repo).
+  const out = runGit(['ls-files', '--others', '--exclude-standard']);
+  const paths = out
+    .split('\n')
+    .map((s) => s.trim())
+    .filter(Boolean);
+  if (paths.length) {
+    console.error('[repo-sanity] untracked files not ignored (add them to git or gitignore):');
+    for (const p of paths.slice(0, 200)) console.error(`- ${p}`);
+    if (paths.length > 200) console.error(`- ... (${paths.length - 200} more)`);
+    process.exit(2);
+  }
+}
+
+const files = runGit(['ls-files']).split('\n').map((s) => s.trim()).filter(Boolean);
+const forbidden = [];
+for (const p of files) {
+  if (isForbiddenTrackedPath(p)) forbidden.push(p);
+  if (!p.includes('/') && isForbiddenRootFile(p)) forbidden.push(p);
+}
+
+if (forbidden.length) {
+  console.error('[repo-sanity] forbidden tracked files detected:');
+  for (const p of Array.from(new Set(forbidden)).sort()) {
+    console.error(`- ${p}`);
+  }
+  process.exit(2);
+}
+
+checkRootLayout();
+checkUntrackedNotIgnored();
+
+console.log('[repo-sanity] ok');

package/scripts/mock-provider/run-regressions.mjs

@@ -6,6 +6,7 @@ import os from 'os';
 import { fileURLToPath } from 'url';
 import { spawn } from 'child_process';
 import { setTimeout as delay } from 'node:timers/promises';
+import http from 'node:http';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const PROJECT_ROOT = path.resolve(__dirname, '../..');
@@ -251,7 +252,17 @@ async function waitForHealth(port, serverProc, timeoutMs = 20000) {
     try {
       const res = await fetch(`http://127.0.0.1:${port}/health`, { method: 'GET' });
       if (res.ok) {
-        return;
+        // /health becomes reachable before runtime is fully initialized (server starts listening first
+        // to support token portal). Mock regressions must wait until hub pipeline is ready.
+        try {
+          const data = await res.json();
+          const ready = data && (data.ready === true || data.pipelineReady === true || data.status === 'ok');
+          if (ready) {
+            return;
+          }
+        } catch {
+          // ignore JSON errors, retry
+        }
       }
     } catch {
       // retry
@@ -276,6 +287,150 @@ async function stopServer(child, forceTimeout = 5000) {
   child.kill('SIGKILL');
 }
 
+async function createLocalUpstreamServer(handler) {
+  return await new Promise((resolve, reject) => {
+    const server = http.createServer(handler);
+    server.on('error', reject);
+    server.listen(0, '127.0.0.1', () => {
+      const address = server.address();
+      if (!address || typeof address !== 'object') {
+        reject(new Error('Failed to obtain listen address for upstream server'));
+        return;
+      }
+      resolve({
+        server,
+        port: address.port
+      });
+    });
+  });
+}
+
+function buildIflowUaProbeConfig(port, upstreamPort) {
+  return {
+    version: '1.0.0',
+    virtualrouter: {
+      inputProtocol: 'openai',
+      outputProtocol: 'openai',
+      providers: {
+        iflow: {
+          id: 'iflow',
+          enabled: true,
+          type: 'iflow',
+          baseURL: `http://127.0.0.1:${upstreamPort}/v1`,
+          compatibilityProfile: 'chat:iflow',
+          auth: {
+            type: 'apikey',
+            apiKey: 'test-upstream-token'
+          },
+          models: {
+            'glm-4.7': { supportsStreaming: false }
+          }
+        }
+      },
+      routing: {
+        default: ['iflow.glm-4.7']
+      }
+    },
+    httpserver: {
+      host: '127.0.0.1',
+      port
+    }
+  };
+}
+
+async function runIflowUserAgentRegression() {
+  const seen = {
+    path: '',
+    headers: {},
+    body: ''
+  };
+
+  const { server: upstream, port: upstreamPort } = await createLocalUpstreamServer(async (req, res) => {
+    try {
+      seen.path = String(req.url || '');
+      seen.headers = req.headers || {};
+      let raw = '';
+      req.setEncoding('utf8');
+      req.on('data', (chunk) => {
+        raw += chunk;
+      });
+      await new Promise((resolve) => req.on('end', resolve));
+      seen.body = raw;
+    } catch {
+      // ignore
+    }
+
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(
+      JSON.stringify({
+        id: 'chatcmpl_mock_iflow_ua',
+        object: 'chat.completion',
+        created: Math.floor(Date.now() / 1000),
+        model: 'glm-4.7',
+        choices: [
+          {
+            index: 0,
+            message: { role: 'assistant', content: 'ok' },
+            finish_reason: 'stop'
+          }
+        ],
+        usage: { prompt_tokens: 1, completion_tokens: 1, total_tokens: 2 }
+      })
+    );
+  });
+
+  const port = 5750;
+  const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'routecodex-iflow-ua-'));
+  const configPath = path.join(dir, 'config.json');
+  await fs.writeFile(configPath, JSON.stringify(buildIflowUaProbeConfig(port, upstreamPort), null, 2), 'utf-8');
+
+  const entry = path.join(PROJECT_ROOT, 'dist', 'index.js');
+  const child = spawn(process.execPath, [entry], {
+    cwd: PROJECT_ROOT,
+    env: {
+      ...process.env,
+      ROUTECODEX_PORT: String(port),
+      ROUTECODEX_CONFIG_PATH: configPath,
+      RCC_PORT: String(port),
+      RCC_CONFIG_PATH: configPath
+    },
+    stdio: ['ignore', 'pipe', 'pipe']
+  });
+
+  try {
+    await waitForHealth(port, child);
+    const res = await fetch(`http://127.0.0.1:${port}/v1/chat/completions`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        // If UA precedence is wrong, this inbound UA will leak to upstream and break iFlow glm-4.7.
+        'User-Agent': 'curl/8.7.1'
+      },
+      body: JSON.stringify({
+        model: 'iflow.glm-4.7',
+        messages: [{ role: 'user', content: 'hi' }],
+        max_tokens: 16,
+        stream: false
+      })
+    });
+    const text = await res.text();
+    if (!res.ok) {
+      throw new Error(`ua probe request failed: HTTP ${res.status}: ${text}`);
+    }
+
+    const upstreamUa = typeof seen.headers['user-agent'] === 'string' ? seen.headers['user-agent'] : '';
+    if (upstreamUa !== 'iFlow-Cli') {
+      throw new Error(
+        `iflow UA regression: expected upstream user-agent="iFlow-Cli", got ${JSON.stringify(upstreamUa)} (path=${seen.path})`
+      );
+    }
+  } finally {
+    await stopServer(child);
+    await fs.rm(dir, { recursive: true, force: true });
+    await new Promise((resolve) => upstream.close(() => resolve()));
+  }
+}
+
 function collectInvalidNames(payload) {
   const failures = [];
   const check = (value, location) => {
@@ -546,6 +701,7 @@ async function runSample(sample, index) {
 
 async function main() {
   await ensureCliAvailable();
+  await runIflowUserAgentRegression();
   const samples = await loadRegistry();
   const watchedTags = new Set(['invalid_name', 'missing_output', 'missing_tool_call_id', 'require_fc_call_ids', 'regression']);
   const regressionSamples = samples.filter(

package/scripts/run-bg.sh

@@ -40,19 +40,6 @@ if [[ -z "${CMD_STR}" ]]; then
   exit 2
 fi
 
-cleanup_existing_servers() {
-  local killed=0
-  if [[ "${CMD_STR}" == *"dist/index.js"* || "${CMD_STR}" == *"routecodex"* ]]; then
-    echo "[run-bg] ensuring no previous RouteCodex server is running" >&2
-    pkill -f "/opt/homebrew/lib/node_modules/routecodex/dist/index.js" 2>/dev/null && killed=1 || true
-    pkill -f "$(pwd)/dist/index.js" 2>/dev/null && killed=1 || true
-    pkill -f "routecodex/dist/index.js" 2>/dev/null && killed=1 || true
-    if [[ "${killed}" -eq 1 ]]; then
-      sleep 1
-    fi
-  fi
-}
-
 detect_port() {
   local p="${TARGET_PORT}"
   if [[ -n "$p" ]]; then echo "$p"; return; fi
@@ -97,7 +84,6 @@ ensure_singleton() {
   fi
 }
 
-cleanup_existing_servers
 ensure_singleton
 
 ts=$(date +%s)

package/scripts/tests/ci-jest.mjs

@@ -0,0 +1,119 @@
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+import process from 'node:process';
+
+// Keep CI Jest fast and deterministic:
+// - Prefer pure unit tests / mock-provider tests (no external network).
+// - Expand coverage by adding more suites here (don’t run `jest --all` in CI).
+const routingInstructionTests = [
+  'tests/client/gemini/gemini-cli-protocol-client.test.ts',
+  'tests/server/runtime/request-executor.single-attempt.spec.ts',
+  'tests/server/runtime/executor-provider.retryable.spec.ts',
+  'tests/providers/auth/tokenfile-auth.iflow.spec.ts',
+  'tests/providers/core/runtime/gemini-http-provider.unit.test.ts',
+  'tests/providers/core/runtime/gemini-cli-http-provider.unit.test.ts',
+  'tests/providers/core/runtime/base-provider.spec.ts',
+  'tests/providers/core/runtime/http-transport-provider.headers.test.ts',
+  'tests/providers/core/runtime/protocol-http-providers.unit.test.ts',
+  'tests/providers/core/runtime/provider-error-classifier.spec.ts',
+  'tests/providers/core/runtime/antigravity-quota-client.unit.test.ts',
+  'tests/providers/core/utils/http-client.postStream.idle-timeout.spec.ts',
+  'tests/providers/core/utils/snapshot-writer.sse-error-propagation.spec.ts',
+  'tests/manager/quota/provider-quota-center.spec.ts',
+  'tests/manager/quota/provider-quota-store.spec.ts',
+  'tests/manager/quota/quota-manager-refresh.spec.ts',
+  'tests/manager/quota/provider-quota-daemon-module.spec.ts',
+  'tests/manager/quota/provider-key-normalization.spec.ts',
+  'tests/responses/responses-openai-bridge.spec.ts',
+  'tests/server/http-server/daemon-admin.e2e.spec.ts',
+  'tests/server/http-server/daemon-admin-provider-pool.e2e.spec.ts',
+  'tests/server/http-server/apikey-auth.e2e.spec.ts',
+  'tests/server/http-server/quota-view-injection.spec.ts',
+  'tests/server/http-server/quota-refresh-triggers.e2e.spec.ts',
+  'tests/server/http-server/hub-policy-injection.spec.ts',
+  'tests/server/http-server/session-header-injection.spec.ts',
+  'tests/server/http-server/session-dir.spec.ts',
+  'tests/server/http-server/execute-pipeline-failover.spec.ts',
+  'tests/server/runtime/http-server/executor-provider.spec.ts',
+  'tests/server/runtime/http-server/request-executor.spec.ts',
+  'tests/server/utils/http-error-mapper-timeout.spec.ts',
+  'tests/server/utils/http-error-mapper-malformed-request.spec.ts',
+  'tests/server/handlers/handler-utils.apikey-denylist.spec.ts',
+  'tests/server/handlers/sse-timeout.spec.ts',
+  'tests/utils/is-direct-execution.test.ts',
+  'tests/utils/windows-netstat.test.ts',
+  'tests/servertool/virtual-router-context-fallback.spec.ts',
+  'tests/servertool/virtual-router-longcontext-fallback.spec.ts',
+  'tests/servertool/virtual-router-series-cooldown.spec.ts',
+  'tests/servertool/virtual-router-context-weighted.spec.ts',
+  'tests/servertool/virtual-router-engine-update-deps.spec.ts',
+  'tests/servertool/virtual-router-health-weighted-rr.spec.ts',
+  'tests/servertool/virtual-router-priority-selection.spec.ts',
+  'tests/servertool/virtual-router-quota-routing.spec.ts',
+  'tests/servertool/virtual-router-routing-instructions.spec.ts',
+  'tests/servertool/virtual-router-servertool-routing.spec.ts',
+  'tests/servertool/routing-instructions.spec.ts',
+  'tests/servertool/server-side-web-search.spec.ts',
+  'tests/servertool/vision-flow.spec.ts',
+  'tests/servertool/gemini-empty-reply-continue.spec.ts',
+  'tests/servertool/iflow-model-error-retry.spec.ts',
+  'tests/servertool/apply-patch-guard.spec.ts',
+  'tests/servertool/exec-command-guard.spec.ts',
+  'tests/servertool/hub-pipeline-session-headers.spec.ts',
+  'tests/servertool/stopmessage-anthropic-stop-sequence.spec.ts',
+  'tests/servertool/stop-message-auto.spec.ts',
+  'tests/servertool/servertool-clock.spec.ts',
+  'tests/servertool/servertool-progress-logging.spec.ts',
+  'tests/sharedmodule/gemini-mapper-functioncall-args.spec.ts',
+  'tests/sharedmodule/mcp-tool-descriptions.spec.ts',
+  'tests/unified-hub/hub-v1-single-path-imports.spec.ts',
+  'tests/unified-hub/policy-errorsample-write.spec.ts',
+  'tests/unified-hub/policy-observe-shadow.spec.ts',
+  'tests/unified-hub/shadow-runtime-compare.errorsamples.spec.ts'
+];
+
+const cliTests = [
+  'tests/cli/clean-command.spec.ts',
+  'tests/cli/code-command.spec.ts',
+  'tests/cli/config-command.spec.ts',
+  'tests/cli/env-command.spec.ts',
+  'tests/cli/env-output.spec.ts',
+  'tests/cli/examples-command.spec.ts',
+  'tests/cli/port-command.spec.ts',
+  'tests/cli/port-utils.spec.ts',
+  'tests/cli/restart-command.spec.ts',
+  'tests/cli/smoke.spec.ts',
+  'tests/cli/start-command.spec.ts',
+  'tests/cli/status-command.spec.ts',
+  'tests/cli/stop-command.spec.ts'
+];
+
+const wantsCoverage = process.argv.includes('--coverage') || process.env.ROUTECODEX_CI_COVERAGE === '1';
+const allTests = [...routingInstructionTests, ...cliTests];
+
+const jestBin = path.join(process.cwd(), 'node_modules', 'jest', 'bin', 'jest.js');
+
+const args = [
+  '--runTestsByPath',
+  ...allTests,
+  ...(wantsCoverage ? ['--testTimeout=20000'] : []),
+  ...(wantsCoverage
+    ? [
+        '--coverage',
+        ...(process.env.ROUTECODEX_CI_MAX_WORKERS
+          ? [`--maxWorkers=${process.env.ROUTECODEX_CI_MAX_WORKERS}`]
+          : []),
+        '--coverageReporters=json-summary',
+        '--coverageReporters=text',
+        '--coverageDirectory=coverage'
+      ]
+    : [])
+];
+
+const result = spawnSync(
+  process.execPath,
+  ['--experimental-vm-modules', jestBin, ...args],
+  { stdio: 'inherit' }
+);
+
+process.exit(result.status ?? 1);

package/scripts/tools-dev/responses-debug-client/README.md

@@ -0,0 +1,23 @@
+Responses Debug Client (SSE + Tool Loop)
+
+Purpose
+- Minimal client to debug OpenAI Responses API through your RCC server.
+- Starts with SSE event consumption, then completes a basic tool-calls loop.
+
+Run
+- npm run debug:responses -- --file scripts/tools-dev/responses-debug-client/payloads/text.json
+- npm run debug:responses -- --file scripts/tools-dev/responses-debug-client/payloads/tool.json
+
+Options
+- --file <path>       Required. JSON request payload (Responses shape)
+- --baseURL <url>     Default http://127.0.0.1:5520/v1
+- --apiKey <key>      Default dummy
+- --timeout <sec>     Default 120
+- --raw               Print raw events (default off)
+- --save              Save JSONL to logs/ (default off)
+- --maxRounds <n>     Tool rounds limit (default 3)
+
+Notes
+- Only Responses payloads are supported (no Chat conversion).
+- Listens to named SSE events (response.output_text.delta, etc.).
+- Implements minimal local tools: echo, sum, time.

package/scripts/tools-dev/responses-debug-client/payloads/poem.json

@@ -0,0 +1,13 @@
+{
+  "model": "gpt-5",
+  "input": [
+    {
+      "role": "user",
+      "content": [
+        { "type": "input_text", "text": "写一首五言绝句" }
+      ]
+    }
+  ],
+  "stream": true
+}
+