@jsonstudio/rcc 0.89.2239 → 0.90.89

package/README.md

@@ -12,6 +12,33 @@ Both provide a **unified gateway for AI providers**, handling **routing + protoc
 
 > **Note**: This README covers both tools. For CLI-specific usage, see `docs/INSTALLATION_AND_QUICKSTART.md`.
 
+## 最新更新 (2026-02-23)
+
+### 进程生命周期管理规范（重要）
+
+本项目已全面清理高危进程终止代码，严格执行**自管理进程**原则：
+
+- **禁止普杀**：代码库中已移除所有 `pkill`、`killall`、`lsof | xargs kill` 等批量终止模式
+- **仅管理已知进程**：只有通过 pid file 或注册表明确记录的进程才能被终止
+- **归属验证**：终止前必须通过 `ps` 验证进程命令归属，防止 PID 复用误杀
+- **自杀优先**：推荐进程通过信号处理自行退出，而非外部强制终止
+
+#### managed tmux 会话生命周期
+- 客户端退出即自动销毁 tmux 会话（`launcher-kernel.ts:921`）
+- SIGTERM 信号下默认销毁 managed tmux（`launcher-kernel.ts:55`）
+- 不再复用旧会话，始终新建（`launcher-kernel.ts:842`）
+
+#### Server 侧 Cleanup 策略
+- Cleanup 端点仅做状态清理，**不终止客户端进程**（`session-client-routes.ts:377`）
+- `allowManagedTermination` 已硬编码为 `false`，确保不会越界终止
+
+#### 启动脚本行为
+- `run-bg.sh` / `run-fg-gtimeout.sh` 偏向"停旧服再起"策略
+- 自动识别 RouteCodex server 进程并优雅替换
+- 非 RouteCodex listener 坚决拒绝终止（防误杀）
+
+详见 [AGENTS.md](./AGENTS.md) 第 1.1 条。
+
 ## 主要功能
 
 - **多入口同时支持（同一服务端口）**

package/dist/build-info.js

@@ -1,6 +1,6 @@
 export const buildInfo = {
     mode: 'release',
-    version: '0.89.2239',
-    buildTime: '2026-02-17T16:17:58.099Z'
+    version: '0.90.089',
+    buildTime: '2026-03-03T09:54:11.611Z'
 };
 //# sourceMappingURL=build-info.js.map

package/dist/build-info.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-info.js","sourceRoot":"","sources":["../src/build-info.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAc;IAClC,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,WAAW;IACpB,SAAS,EAAE,0BAA0B;CACtC,CAAC"}
+{"version":3,"file":"build-info.js","sourceRoot":"","sources":["../src/build-info.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAc;IAClC,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,UAAU;IACnB,SAAS,EAAE,0BAA0B;CACtC,CAAC"}

package/dist/cli/commands/claude.js

@@ -4,6 +4,7 @@ export function createClaudeCommand(program, ctx) {
         commandName: 'claude',
         displayName: 'Claude',
         description: 'Launch Claude with RouteCodex as proxy (args after this command are passed through)',
+        allowAutoStartServer: false,
         binaryOptionFlags: '--claude-path <path>',
         binaryOptionName: 'claudePath',
         binaryOptionDescription: 'Path to Claude executable',
@@ -24,7 +25,7 @@ export function createClaudeCommand(program, ctx) {
         },
         buildEnv: ({ env, baseUrl, configuredApiKey, cwd }) => {
             // Always prefer the proxy key injected by launcher-kernel (OPENAI_API_KEY),
-            // because it may carry the clock daemon suffix for per-session binding.
+            // because it may carry the session daemon suffix for per-session binding.
             const proxyApiKey = (typeof env.OPENAI_API_KEY === 'string' && env.OPENAI_API_KEY.trim())
                 ? env.OPENAI_API_KEY.trim()
                 : (configuredApiKey || 'rcc-proxy-key');
@@ -36,14 +37,9 @@ export function createClaudeCommand(program, ctx) {
                 CLAUDE_WORKDIR: cwd,
                 ANTHROPIC_BASE_URL: baseUrl,
                 ANTHROPIC_API_URL: baseUrl,
-                ANTHROPIC_API_KEY: proxyApiKey
+                ANTHROPIC_API_KEY: proxyApiKey,
+                ANTHROPIC_AUTH_TOKEN: proxyApiKey
             };
-            try {
-                delete claudeEnv.ANTHROPIC_AUTH_TOKEN;
-            }
-            catch {
-                // ignore
-            }
             try {
                 delete claudeEnv.ANTHROPIC_TOKEN;
             }

package/dist/cli/commands/claude.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../src/cli/commands/claude.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAA+B,MAAM,sBAAsB,CAAC;AAI1F,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,GAAyB;IAC7E,qBAAqB,CAAC,OAAO,EAAE,GAAG,EAAE;QAClC,WAAW,EAAE,QAAQ;QACrB,WAAW,EAAE,QAAQ;QACrB,WAAW,EAAE,qFAAqF;QAClG,iBAAiB,EAAE,sBAAsB;QACzC,gBAAgB,EAAE,YAAY;QAC9B,uBAAuB,EAAE,2BAA2B;QACpD,aAAa,EAAE,QAAQ;QACvB,YAAY,EAAE,aAAa;QAC3B,iBAAiB,EAAE,CAAC,eAAe,EAAE,SAAS,EAAE,WAAW,CAAC;QAC5D,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,IAAI;QACvB,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YACrB,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC9D,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;YACD,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBAClE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,EAAE,EAAE;YACpD,4EAA4E;YAC5E,wEAAwE;YACxE,MAAM,WAAW,GAAG,CAAC,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,IAAI,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;gBACvF,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE;gBAC3B,CAAC,CAAC,CAAC,gBAAgB,IAAI,eAAe,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG;gBAChB,GAAG,GAAG;gBACN,GAAG,EAAE,GAAG;gBACR,WAAW,EAAE,GAAG;gBAChB,kBAAkB,EAAE,GAAG;gBACvB,cAAc,EAAE,GAAG;gBACnB,kBAAkB,EAAE,OAAO;gBAC3B,iBAAiB,EAAE,OAAO;gBAC1B,iBAAiB,EAAE,WAAW;aACV,CAAC;YAEvB,IAAI,CAAC;gBACH,OAAQ,SAAqC,CAAC,oBAAoB,CAAC;YACrE,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YACD,IAAI,CAAC;gBACH,OAAQ,SAAqC,CAAC,eAAe,CAAC;YAChE,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YAED,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../src/cli/commands/claude.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAA+B,MAAM,sBAAsB,CAAC;AAI1F,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,GAAyB;IAC7E,qBAAqB,CAAC,OAAO,EAAE,GAAG,EAAE;QAClC,WAAW,EAAE,QAAQ;QACrB,WAAW,EAAE,QAAQ;QACrB,WAAW,EAAE,qFAAqF;QAClG,oBAAoB,EAAE,KAAK;QAC3B,iBAAiB,EAAE,sBAAsB;QACzC,gBAAgB,EAAE,YAAY;QAC9B,uBAAuB,EAAE,2BAA2B;QACpD,aAAa,EAAE,QAAQ;QACvB,YAAY,EAAE,aAAa;QAC3B,iBAAiB,EAAE,CAAC,eAAe,EAAE,SAAS,EAAE,WAAW,CAAC;QAC5D,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,IAAI;QACvB,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YACrB,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC9D,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;YACD,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBAClE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,EAAE,EAAE;YACpD,4EAA4E;YAC5E,0EAA0E;YAC1E,MAAM,WAAW,GAAG,CAAC,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,IAAI,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;gBACvF,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE;gBAC3B,CAAC,CAAC,CAAC,gBAAgB,IAAI,eAAe,CAAC,CAAC;YAC1C,MAAM,SAAS,GAAG;gBAChB,GAAG,GAAG;gBACN,GAAG,EAAE,GAAG;gBACR,WAAW,EAAE,GAAG;gBAChB,kBAAkB,EAAE,GAAG;gBACvB,cAAc,EAAE,GAAG;gBACnB,kBAAkB,EAAE,OAAO;gBAC3B,iBAAiB,EAAE,OAAO;gBAC1B,iBAAiB,EAAE,WAAW;gBAC9B,oBAAoB,EAAE,WAAW;aACb,CAAC;YAEvB,IAAI,CAAC;gBACH,OAAQ,SAAqC,CAAC,eAAe,CAAC;YAChE,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YAED,OAAO,SAAS,CAAC;QACnB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/commands/codex.js

@@ -4,6 +4,7 @@ export function createCodexCommand(program, ctx) {
         commandName: 'codex',
         displayName: 'Codex',
         description: 'Launch Codex with RouteCodex as proxy (args after this command are passed through)',
+        allowAutoStartServer: false,
         binaryOptionFlags: '--codex-path <path>',
         binaryOptionName: 'codexPath',
         binaryOptionDescription: 'Path to Codex executable',
@@ -23,6 +24,10 @@ export function createCodexCommand(program, ctx) {
             return args;
         },
         buildEnv: ({ env, baseUrl, configuredApiKey, cwd }) => {
+            // Prefer launcher-injected proxy key (may carry session daemon/scope suffix for session binding).
+            const proxyApiKey = (typeof env.OPENAI_API_KEY === 'string' && env.OPENAI_API_KEY.trim())
+                ? env.OPENAI_API_KEY.trim()
+                : (configuredApiKey || 'rcc-proxy-key');
             const openAiBase = normalizeOpenAiBaseUrl(baseUrl);
             return {
                 ...env,
@@ -33,9 +38,7 @@ export function createCodexCommand(program, ctx) {
                 OPENAI_BASE_URL: openAiBase,
                 OPENAI_API_BASE: openAiBase,
                 OPENAI_API_BASE_URL: openAiBase,
-                OPENAI_API_KEY: (typeof env.OPENAI_API_KEY === 'string' && env.OPENAI_API_KEY.trim())
-                    ? env.OPENAI_API_KEY.trim()
-                    : (configuredApiKey || 'rcc-proxy-key')
+                OPENAI_API_KEY: proxyApiKey
             };
         }
     });

package/dist/cli/commands/codex.js.map

@@ -1 +1 @@
-{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../src/cli/commands/codex.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAA+B,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAIlH,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,GAAwB;IAC3E,qBAAqB,CAAC,OAAO,EAAE,GAAG,EAAE;QAClC,WAAW,EAAE,OAAO;QACpB,WAAW,EAAE,OAAO;QACpB,WAAW,EAAE,oFAAoF;QACjG,iBAAiB,EAAE,qBAAqB;QACxC,gBAAgB,EAAE,WAAW;QAC7B,uBAAuB,EAAE,0BAA0B;QACnD,aAAa,EAAE,OAAO;QACtB,YAAY,EAAE,YAAY;QAC1B,iBAAiB,EAAE,CAAC,cAAc,EAAE,SAAS,EAAE,WAAW,CAAC;QAC3D,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,IAAI;QACvB,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YACrB,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC9D,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;YACD,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBAClE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,EAAE,EAAE;YACpD,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;YACnD,OAAO;gBACL,GAAG,GAAG;gBACN,GAAG,EAAE,GAAG;gBACR,WAAW,EAAE,GAAG;gBAChB,kBAAkB,EAAE,GAAG;gBACvB,aAAa,EAAE,GAAG;gBAClB,eAAe,EAAE,UAAU;gBAC3B,eAAe,EAAE,UAAU;gBAC3B,mBAAmB,EAAE,UAAU;gBAC/B,cAAc,EAAE,CAAC,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,IAAI,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;oBACnF,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE;oBAC3B,CAAC,CAAC,CAAC,gBAAgB,IAAI,eAAe,CAAC;aACrB,CAAC;QACzB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../src/cli/commands/codex.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAA+B,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAIlH,MAAM,UAAU,kBAAkB,CAAC,OAAgB,EAAE,GAAwB;IAC3E,qBAAqB,CAAC,OAAO,EAAE,GAAG,EAAE;QAClC,WAAW,EAAE,OAAO;QACpB,WAAW,EAAE,OAAO;QACpB,WAAW,EAAE,oFAAoF;QACjG,oBAAoB,EAAE,KAAK;QAC3B,iBAAiB,EAAE,qBAAqB;QACxC,gBAAgB,EAAE,WAAW;QAC7B,uBAAuB,EAAE,0BAA0B;QACnD,aAAa,EAAE,OAAO;QACtB,YAAY,EAAE,YAAY;QAC1B,iBAAiB,EAAE,CAAC,cAAc,EAAE,SAAS,EAAE,WAAW,CAAC;QAC3D,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,IAAI;QACvB,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;YACrB,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC9D,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;YACD,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBAClE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,EAAE,EAAE;YACpD,kGAAkG;YAClG,MAAM,WAAW,GAAG,CAAC,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,IAAI,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;gBACvF,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE;gBAC3B,CAAC,CAAC,CAAC,gBAAgB,IAAI,eAAe,CAAC,CAAC;YAC1C,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;YACnD,OAAO;gBACL,GAAG,GAAG;gBACN,GAAG,EAAE,GAAG;gBACR,WAAW,EAAE,GAAG;gBAChB,kBAAkB,EAAE,GAAG;gBACvB,aAAa,EAAE,GAAG;gBAClB,eAAe,EAAE,UAAU;gBAC3B,eAAe,EAAE,UAAU;gBAC3B,mBAAmB,EAAE,UAAU;gBAC/B,cAAc,EAAE,WAAW;aACP,CAAC;QACzB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/commands/guardian-daemon.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function createGuardianDaemonCommand(program: Command): void;

package/dist/cli/commands/guardian-daemon.js

@@ -0,0 +1,299 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { createServer } from 'node:http';
+import { randomBytes } from 'node:crypto';
+const MAX_BODY_BYTES = 256 * 1024;
+function nowIso() {
+    return new Date().toISOString();
+}
+function writeLogLine(logFile, message) {
+    const line = `[guardian][${nowIso()}] ${message}\n`;
+    try {
+        fs.mkdirSync(path.dirname(logFile), { recursive: true });
+        fs.appendFileSync(logFile, line, 'utf8');
+    }
+    catch {
+        // ignore daemon logging failures
+    }
+}
+function sendJson(res, statusCode, payload) {
+    const body = JSON.stringify(payload);
+    res.statusCode = statusCode;
+    res.setHeader('content-type', 'application/json; charset=utf-8');
+    res.setHeader('content-length', Buffer.byteLength(body));
+    res.end(body);
+}
+async function readJsonBody(req) {
+    const chunks = [];
+    let total = 0;
+    for await (const piece of req) {
+        const chunk = Buffer.isBuffer(piece) ? piece : Buffer.from(String(piece));
+        total += chunk.length;
+        if (total > MAX_BODY_BYTES) {
+            throw new Error('request body too large');
+        }
+        chunks.push(chunk);
+    }
+    if (!chunks.length) {
+        return {};
+    }
+    const text = Buffer.concat(chunks).toString('utf8');
+    if (!text.trim()) {
+        return {};
+    }
+    const parsed = JSON.parse(text);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('request body must be an object');
+    }
+    return parsed;
+}
+function validateRegistration(body) {
+    const source = typeof body.source === 'string' ? body.source.trim() : '';
+    const pid = Number(body.pid);
+    const ppid = Number(body.ppid);
+    if (!source) {
+        throw new Error('source is required');
+    }
+    if (!Number.isFinite(pid) || pid <= 1) {
+        throw new Error('pid is invalid');
+    }
+    if (!Number.isFinite(ppid) || ppid <= 0) {
+        throw new Error('ppid is invalid');
+    }
+    const registration = {
+        source,
+        pid: Math.floor(pid),
+        ppid: Math.floor(ppid)
+    };
+    const port = Number(body.port);
+    if (Number.isFinite(port) && port > 0) {
+        registration.port = Math.floor(port);
+    }
+    if (typeof body.tmuxSessionId === 'string' && body.tmuxSessionId.trim()) {
+        registration.tmuxSessionId = body.tmuxSessionId.trim();
+    }
+    if (typeof body.tmuxTarget === 'string' && body.tmuxTarget.trim()) {
+        registration.tmuxTarget = body.tmuxTarget.trim();
+    }
+    if (body.metadata && typeof body.metadata === 'object' && !Array.isArray(body.metadata)) {
+        registration.metadata = body.metadata;
+    }
+    return registration;
+}
+function removeStateFileIfOwned(stateFile, pid) {
+    try {
+        if (!fs.existsSync(stateFile)) {
+            return;
+        }
+        const raw = fs.readFileSync(stateFile, 'utf8');
+        const parsed = JSON.parse(raw);
+        const record = parsed && typeof parsed === 'object' ? parsed : null;
+        if (!record) {
+            return;
+        }
+        const filePid = Number(record.pid);
+        if (!Number.isFinite(filePid) || Math.floor(filePid) !== Math.floor(pid)) {
+            return;
+        }
+        fs.unlinkSync(stateFile);
+    }
+    catch {
+        // ignore
+    }
+}
+async function runGuardianDaemon(options) {
+    const stateFile = String(options.stateFile || '').trim();
+    if (!stateFile) {
+        throw new Error('missing --state-file for guardian daemon');
+    }
+    const logFile = String(options.logFile || '').trim() || `${stateFile}.log`;
+    const state = {
+        pid: process.pid,
+        port: 0,
+        token: randomBytes(20).toString('hex'),
+        stopToken: randomBytes(20).toString('hex'),
+        startedAt: nowIso(),
+        updatedAt: nowIso()
+    };
+    const registrations = new Map();
+    const lifecycleRecords = [];
+    let stopping = false;
+    const persistState = () => {
+        state.updatedAt = nowIso();
+        const payload = {
+            ...state,
+            registrations: Array.from(registrations.values()),
+            lifecycleRecords
+        };
+        fs.mkdirSync(path.dirname(stateFile), { recursive: true });
+        fs.writeFileSync(stateFile, `${JSON.stringify(payload, null, 2)}\n`, 'utf8');
+    };
+    const shutdown = (reason) => {
+        if (stopping) {
+            return;
+        }
+        stopping = true;
+        writeLogLine(logFile, `shutdown requested: ${reason}`);
+        heartbeatTimer.unref();
+        server.close(() => {
+            removeStateFileIfOwned(stateFile, process.pid);
+            process.exit(0);
+        });
+        setTimeout(() => {
+            removeStateFileIfOwned(stateFile, process.pid);
+            process.exit(0);
+        }, 2000).unref();
+    };
+    const checkAuth = (req) => {
+        const token = String(req.headers['x-rcc-guardian-token'] || '').trim();
+        return token === state.token;
+    };
+    const server = createServer((req, res) => {
+        const url = req.url || '/';
+        const method = req.method || 'GET';
+        if (method === 'GET' && url === '/health') {
+            if (!checkAuth(req)) {
+                sendJson(res, 401, { ok: false, error: 'unauthorized' });
+                return;
+            }
+            sendJson(res, 200, { ok: true, pid: process.pid, registrations: registrations.size });
+            return;
+        }
+        if (method === 'POST' && url === '/register') {
+            if (!checkAuth(req)) {
+                sendJson(res, 401, { ok: false, error: 'unauthorized' });
+                return;
+            }
+            void (async () => {
+                try {
+                    const body = await readJsonBody(req);
+                    const registration = validateRegistration(body);
+                    const key = `${registration.source}:${registration.pid}`;
+                    registrations.set(key, {
+                        ...registration,
+                        key,
+                        updatedAt: nowIso()
+                    });
+                    persistState();
+                    sendJson(res, 200, { ok: true, key, registrations: registrations.size });
+                }
+                catch (error) {
+                    sendJson(res, 400, {
+                        ok: false,
+                        error: error instanceof Error ? error.message : String(error)
+                    });
+                }
+            })();
+            return;
+        }
+        if (method === 'POST' && url === '/stop') {
+            if (!checkAuth(req)) {
+                sendJson(res, 401, { ok: false, error: 'unauthorized' });
+                return;
+            }
+            const stopToken = String(req.headers['x-rcc-guardian-stop-token'] || '').trim();
+            if (!stopToken || stopToken !== state.stopToken) {
+                sendJson(res, 403, { ok: false, error: 'forbidden' });
+                return;
+            }
+            sendJson(res, 200, { ok: true, stopping: true });
+            shutdown('api-stop');
+            return;
+        }
+        if (method === 'POST' && url === '/lifecycle') {
+            if (!checkAuth(req)) {
+                sendJson(res, 401, { ok: false, error: 'unauthorized' });
+                return;
+            }
+            void (async () => {
+                try {
+                    const body = await readJsonBody(req);
+                    const action = typeof body.action === 'string' ? body.action.trim() : '';
+                    const source = typeof body.source === 'string' ? body.source.trim() : '';
+                    const actorPid = Number(body.actorPid);
+                    if (!action || !source || !Number.isFinite(actorPid) || actorPid <= 0) {
+                        throw new Error('invalid lifecycle event');
+                    }
+                    const item = {
+                        id: randomBytes(8).toString('hex'),
+                        action,
+                        source,
+                        actorPid: Math.floor(actorPid),
+                        createdAt: nowIso()
+                    };
+                    const targetPid = Number(body.targetPid);
+                    if (Number.isFinite(targetPid) && targetPid > 0) {
+                        item.targetPid = Math.floor(targetPid);
+                    }
+                    if (typeof body.signal === 'string' && body.signal.trim()) {
+                        item.signal = body.signal.trim();
+                    }
+                    if (body.metadata && typeof body.metadata === 'object' && !Array.isArray(body.metadata)) {
+                        item.metadata = body.metadata;
+                    }
+                    lifecycleRecords.push(item);
+                    if (lifecycleRecords.length > 200) {
+                        lifecycleRecords.splice(0, lifecycleRecords.length - 200);
+                    }
+                    persistState();
+                    writeLogLine(logFile, `lifecycle action=${item.action} source=${item.source} actorPid=${item.actorPid}`);
+                    sendJson(res, 200, { ok: true, allowed: true, id: item.id });
+                }
+                catch (error) {
+                    sendJson(res, 400, {
+                        ok: false,
+                        error: error instanceof Error ? error.message : String(error)
+                    });
+                }
+            })();
+            return;
+        }
+        sendJson(res, 404, { ok: false, error: 'not_found' });
+    });
+    server.listen(0, '127.0.0.1', () => {
+        const addr = server.address();
+        if (addr && typeof addr === 'object' && Number.isFinite(addr.port)) {
+            state.port = addr.port;
+            persistState();
+            writeLogLine(logFile, `started pid=${process.pid} port=${state.port}`);
+            return;
+        }
+        writeLogLine(logFile, 'failed to resolve listen address; exiting');
+        shutdown('invalid-listen-address');
+    });
+    server.on('error', (error) => {
+        writeLogLine(logFile, `server error: ${error instanceof Error ? error.message : String(error)}`);
+        shutdown('server-error');
+    });
+    const heartbeatTimer = setInterval(() => {
+        if (stopping) {
+            return;
+        }
+        try {
+            persistState();
+        }
+        catch {
+            // ignore transient state write failures
+        }
+    }, 10_000);
+    process.on('SIGINT', () => {
+        writeLogLine(logFile, 'ignored SIGINT');
+    });
+    process.on('SIGTERM', () => {
+        writeLogLine(logFile, 'ignored SIGTERM');
+    });
+    await new Promise(() => {
+        return;
+    });
+}
+export function createGuardianDaemonCommand(program) {
+    program
+        .command('__guardian-daemon', { hidden: true })
+        .description('internal guardian daemon (do not use directly)')
+        .requiredOption('--state-file <path>', 'guardian state file path')
+        .option('--log-file <path>', 'guardian log file path')
+        .action(async (options) => {
+        await runGuardianDaemon(options);
+    });
+}
+//# sourceMappingURL=guardian-daemon.js.map

package/dist/cli/commands/guardian-daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guardian-daemon.js","sourceRoot":"","sources":["../../../src/cli/commands/guardian-daemon.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/init/camoufox.js

@@ -53,7 +53,7 @@ export function maybePrepareCamoufoxEnvironment(ctx, logger, needsCamoufox, opti
         logger.info('Camoufox environment ready.');
     }
     else {
-        logger.warning('Camoufox is unavailable. Install Python + camoufox, or run OAuth/DeepSeek auth once dependencies are ready.');
+        logger.warning('camo CLI is unavailable. Install/enable `camo` first, then retry OAuth/DeepSeek auth.');
     }
 }
 //# sourceMappingURL=camoufox.js.map

package/dist/cli/commands/init/camoufox.js.map

@@ -1 +1 @@
-{"version":3,"file":"camoufox.js","sourceRoot":"","sources":["../../../../src/cli/commands/init/camoufox.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"camoufox.js","sourceRoot":"","sources":["../../../../src/cli/commands/init/camoufox.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/launcher/index.d.ts

@@ -3,5 +3,5 @@
  *
  * Barrel exports for launcher submodules.
  */
-export type { Spinner, LoggerLike, LauncherCommandContext, LauncherCommandOptions, LauncherSpec, ResolvedServerConnection, ClockClientService, ManagedTmuxSession, TmuxSelfHealPolicy, EnvDiff } from './types.js';
+export type { Spinner, LoggerLike, LauncherCommandContext, LauncherCommandOptions, LauncherSpec, ResolvedServerConnection, SessionClientService, ManagedTmuxSession, TmuxSelfHealPolicy, EnvDiff } from './types.js';
 export { resolveBinary, parseServerUrl, resolveBoolFromEnv, resolveIntFromEnv, resolveTmuxSelfHealPolicy, readConfigApiKey, normalizeConnectHost, toIntegerPort, tryReadConfigHostPort, rotateLogFile, isTmuxAvailable, normalizePathForComparison, isReusableIdlePaneCommand, normalizeSessionToken, shellQuote, buildShellCommand, collectChangedEnv, resolveWorkingDirectory, collectPassThroughArgs, normalizeOpenAiBaseUrl } from './utils.js';

package/dist/cli/commands/launcher/types.d.ts

@@ -7,6 +7,7 @@ import type { ChildProcess, SpawnOptions } from 'node:child_process';
 import type fs from 'node:fs';
 import type path from 'node:path';
 import type { spawnSync } from 'node:child_process';
+import type { GuardianLifecycleEvent, GuardianRegistration } from '../../guardian/types.js';
 export type Spinner = {
     start(text?: string): Spinner;
     succeed(text?: string): void;
@@ -39,7 +40,11 @@ export type LauncherCommandContext = {
     fetch: typeof fetch;
     spawn: (command: string, args: string[], options: SpawnOptions) => ChildProcess;
     spawnSyncImpl?: typeof spawnSync;
+    ensureGuardianDaemon?: () => Promise<void>;
+    registerGuardianProcess?: (registration: GuardianRegistration) => Promise<void>;
+    reportGuardianLifecycle?: (event: GuardianLifecycleEvent) => Promise<boolean>;
     getModulesConfigPath: () => string;
+    resolveCliEntryPath?: () => string;
     resolveServerEntryPath: () => string;
     waitForever: () => Promise<void>;
     onSignal?: (signal: NodeJS.Signals, cb: () => void) => void;
@@ -61,6 +66,7 @@ export type LauncherSpec = {
     commandName: string;
     displayName: string;
     description: string;
+    allowAutoStartServer?: boolean;
     binaryOptionFlags: string;
     binaryOptionName: string;
     binaryOptionDescription: string;
@@ -88,7 +94,7 @@ export type ResolvedServerConnection = {
     serverUrl: string;
     configuredApiKey: string | null;
 };
-export type ClockClientService = {
+export type SessionClientService = {
     daemonId: string;
     tmuxSessionId: string;
     tmuxTarget?: string;

package/dist/cli/commands/launcher/utils.d.ts

@@ -45,7 +45,10 @@ export declare function resolveTmuxSelfHealPolicy(env: NodeJS.ProcessEnv): {
  */
 export declare function readConfigApiKey(fsImpl: typeof fs, configPath: string): string | null;
 /**
- * Normalize connect host (convert ::, ::1, localhost to 0.0.0.0)
+ * Normalize connect host.
+ *
+ * When the server binds to 0.0.0.0/::, clients must connect via a concrete
+ * address (typically 127.0.0.1 for local usage).
  */
 export declare function normalizeConnectHost(host: string): string;
 /**

package/dist/cli/commands/launcher/utils.js

@@ -123,24 +123,34 @@ export function readConfigApiKey(fsImpl, configPath) {
         const cfg = JSON.parse(txt);
         const direct = cfg?.httpserver?.apikey ?? cfg?.modules?.httpserver?.config?.apikey ?? cfg?.server?.apikey;
         const value = typeof direct === 'string' ? direct.trim() : '';
-        return value ? value : null;
+        if (!value) {
+            return null;
+        }
+        if (value === 'ROUTECODEX_HTTP_APIKEY' || value === '${ROUTECODEX_HTTP_APIKEY}') {
+            const envValue = process.env.ROUTECODEX_HTTP_APIKEY;
+            return envValue && envValue.trim() ? envValue.trim() : null;
+        }
+        return value;
     }
     catch {
         return null;
     }
 }
 /**
- * Normalize connect host (convert ::, ::1, localhost to 0.0.0.0)
+ * Normalize connect host.
+ *
+ * When the server binds to 0.0.0.0/::, clients must connect via a concrete
+ * address (typically 127.0.0.1 for local usage).
  */
 export function normalizeConnectHost(host) {
-    const value = String(host || '').toLowerCase();
-    if (value === '0.0.0.0') {
-        return '0.0.0.0';
+    const value = String(host || '').trim().toLowerCase();
+    if (!value) {
+        return '127.0.0.1';
     }
-    if (value === '::' || value === '::1' || value === 'localhost') {
-        return '0.0.0.0';
+    if (value === '0.0.0.0' || value === '::' || value === '::1' || value === 'localhost') {
+        return '127.0.0.1';
     }
-    return host || '0.0.0.0';
+    return host;
 }
 /**
  * Convert value to integer port