@jsonstudio/rcc 0.90.367 → 0.90.701

package/config/providers/ali-coding-plan.json

@@ -19,6 +19,7 @@
       "displayName": "Qwen 3 Max",
       "description": "Qwen 3 Max (2026-01-23) - Text generation, deep thinking",
       "capabilities": ["text", "reasoning", "thinking"],
+      "thinking": "high",
       "maxTokens": 128000
     },
     {
@@ -40,6 +41,7 @@
       "displayName": "GLM 5",
       "description": "GLM 5 - Text generation, deep thinking",
       "capabilities": ["text", "reasoning", "thinking"],
+      "thinking": "high",
       "maxTokens": 128000
     },
     {
@@ -47,6 +49,7 @@
       "displayName": "GLM 4.7",
       "description": "GLM 4.7 - Text generation, deep thinking",
       "capabilities": ["text", "reasoning", "thinking"],
+      "thinking": "high",
       "maxTokens": 128000
     },
     {
@@ -54,6 +57,7 @@
       "displayName": "Kimi K2.5",
       "description": "Kimi K2.5 - Text generation, deep thinking, vision understanding",
       "capabilities": ["text", "reasoning", "vision", "thinking"],
+      "thinking": "high",
       "maxTokens": 128000
     },
     {
@@ -61,6 +65,7 @@
       "displayName": "MiniMax M2.5",
       "description": "MiniMax M2.5 - Text generation, deep thinking",
       "capabilities": ["text", "reasoning", "thinking"],
+      "thinking": "high",
       "maxTokens": 128000
     }
   ],

package/dist/build-info.js

@@ -1,6 +1,6 @@
 export const buildInfo = {
     mode: 'release',
-    version: '0.90.367',
-    buildTime: '2026-03-13T17:00:54.327Z'
+    version: '0.90.701',
+    buildTime: '2026-03-22T02:49:44.209Z'
 };
 //# sourceMappingURL=build-info.js.map

package/dist/cli/commands/codex.js

@@ -1,20 +1,34 @@
+import fs from 'node:fs';
+import path from 'node:path';
 import { createLauncherCommand, normalizeOpenAiBaseUrl } from './launcher-kernel.js';
-function hasProfileArg(rawArgv) {
-    for (let index = 0; index < rawArgv.length; index += 1) {
-        const token = typeof rawArgv[index] === 'string' ? rawArgv[index].trim() : '';
-        if (!token) {
-            continue;
-        }
-        if (token === '--profile' || token === '-p') {
-            return true;
+function readDefaultRouteCodexCodexProfile(ctx) {
+    const explicit = (typeof ctx.env.ROUTECODEX_CODEX_PROFILE === 'string' && ctx.env.ROUTECODEX_CODEX_PROFILE.trim())
+        ? ctx.env.ROUTECODEX_CODEX_PROFILE.trim()
+        : ((typeof ctx.env.RCC_CODEX_PROFILE === 'string' && ctx.env.RCC_CODEX_PROFILE.trim())
+            ? ctx.env.RCC_CODEX_PROFILE.trim()
+            : '');
+    if (explicit) {
+        return explicit;
+    }
+    const fsImpl = ctx.fsImpl ?? fs;
+    const pathImpl = ctx.pathImpl ?? path;
+    const configPath = pathImpl.join(ctx.homedir(), '.codex', 'config.toml');
+    try {
+        if (!fsImpl.existsSync(configPath)) {
+            return null;
         }
-        if (token.startsWith('--profile=')) {
-            return true;
+        const content = fsImpl.readFileSync(configPath, 'utf8');
+        if (/\[profiles\.rcm\]/m.test(content) && /\[model_providers\.rcm\]/m.test(content)) {
+            return 'rcm';
         }
     }
-    return false;
+    catch {
+        return null;
+    }
+    return null;
 }
 export function createCodexCommand(program, ctx) {
+    const defaultRouteCodexProfile = readDefaultRouteCodexCodexProfile(ctx);
     createLauncherCommand(program, ctx, {
         commandName: 'codex',
         displayName: 'Codex',
@@ -33,42 +47,30 @@ export function createCodexCommand(program, ctx) {
             if (typeof options.model === 'string' && options.model.trim()) {
                 args.push('--model', options.model.trim());
             }
-            if (typeof options.profile === 'string' && options.profile.trim()) {
-                args.push('--profile', options.profile.trim());
+            const resolvedProfile = (typeof options.profile === 'string' && options.profile.trim())
+                ? options.profile.trim()
+                : defaultRouteCodexProfile;
+            if (resolvedProfile) {
+                args.push('--profile', resolvedProfile);
             }
             return args;
         },
-        buildEnv: ({ env, baseUrl, configuredApiKey, cwd, options }) => {
+        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);
-            const profileName = typeof options.profile === 'string' ? options.profile.trim() : '';
-            const useProfileMode = profileName.length > 0 || hasProfileArg(ctx.rawArgv);
-            const nextEnv = {
+            return {
                 ...env,
                 PWD: cwd,
                 RCC_WORKDIR: cwd,
                 ROUTECODEX_WORKDIR: cwd,
-                CODEX_WORKDIR: cwd
-            };
-            if (!useProfileMode) {
-                nextEnv.OPENAI_BASE_URL = openAiBase;
-                nextEnv.OPENAI_API_BASE = openAiBase;
-                nextEnv.OPENAI_API_BASE_URL = openAiBase;
-                nextEnv.OPENAI_API_KEY = proxyApiKey;
-            }
-            else {
-                // In profile mode, let Codex resolve endpoint/base URL from its profile config.
-                // Keep the launcher-scoped proxy key so tmux/session scope still reaches RouteCodex.
-                delete nextEnv.OPENAI_BASE_URL;
-                delete nextEnv.OPENAI_API_BASE;
-                delete nextEnv.OPENAI_API_BASE_URL;
-                nextEnv.OPENAI_API_KEY = proxyApiKey;
-            }
-            return {
-                ...nextEnv
+                CODEX_WORKDIR: cwd,
+                OPENAI_BASE_URL: openAiBase,
+                OPENAI_API_BASE: openAiBase,
+                OPENAI_API_BASE_URL: openAiBase,
+                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,SAAS,aAAa,CAAC,OAA0B;IAC/C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS;QACX,CAAC;QACD,IAAI,KAAK,KAAK,WAAW,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,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,OAAO,EAAE,EAAE,EAAE;YAC7D,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,MAAM,WAAW,GAAG,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtF,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC5E,MAAM,OAAO,GAAsB;gBACjC,GAAG,GAAG;gBACN,GAAG,EAAE,GAAG;gBACR,WAAW,EAAE,GAAG;gBAChB,kBAAkB,EAAE,GAAG;gBACvB,aAAa,EAAE,GAAG;aACnB,CAAC;YACF,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,OAAO,CAAC,eAAe,GAAG,UAAU,CAAC;gBACrC,OAAO,CAAC,eAAe,GAAG,UAAU,CAAC;gBACrC,OAAO,CAAC,mBAAmB,GAAG,UAAU,CAAC;gBACzC,OAAO,CAAC,cAAc,GAAG,WAAW,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACN,gFAAgF;gBAChF,qFAAqF;gBACrF,OAAO,OAAO,CAAC,eAAe,CAAC;gBAC/B,OAAO,OAAO,CAAC,eAAe,CAAC;gBAC/B,OAAO,OAAO,CAAC,mBAAmB,CAAC;gBACnC,OAAO,CAAC,cAAc,GAAG,WAAW,CAAC;YACvC,CAAC;YACD,OAAO;gBACL,GAAG,OAAO;aACU,CAAC;QACzB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../src/cli/commands/codex.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/heartbeat.d.ts

@@ -0,0 +1,20 @@
+import type { Command } from 'commander';
+import type { LoadedRouteCodexConfig } from '../../config/routecodex-config-loader.js';
+type LoggerLike = {
+    info: (msg: string) => void;
+    warning: (msg: string) => void;
+    success: (msg: string) => void;
+    error: (msg: string) => void;
+};
+export type HeartbeatCommandContext = {
+    isDevPackage: boolean;
+    defaultDevPort: number;
+    logger: LoggerLike;
+    log: (line: string) => void;
+    loadConfig: (explicitPath?: string) => Promise<LoadedRouteCodexConfig>;
+    fetch: typeof fetch;
+    env: NodeJS.ProcessEnv;
+    exit: (code: number) => never;
+};
+export declare function createHeartbeatCommand(program: Command, ctx: HeartbeatCommandContext): void;
+export {};

package/dist/cli/commands/heartbeat.js

@@ -0,0 +1,322 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { LOCAL_HOSTS } from '../../constants/index.js';
+import { resolveRccUserDir } from '../../config/user-data-paths.js';
+import { normalizeConnectHost, normalizePort } from '../utils/normalize.js';
+function normalizeString(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function resolveConfigApiKeyValue(raw, env) {
+    const trimmed = normalizeString(raw);
+    if (!trimmed) {
+        return '';
+    }
+    const envMatch = trimmed.match(/^\$\{([A-Z0-9_]+)\}$/i);
+    if (envMatch) {
+        return normalizeString(env[envMatch[1]]);
+    }
+    if (/^[A-Z][A-Z0-9_]+$/.test(trimmed)) {
+        return normalizeString(env[trimmed]);
+    }
+    return trimmed;
+}
+function normalizeBaseUrl(raw) {
+    const trimmed = String(raw || '').trim();
+    if (!trimmed) {
+        throw new Error('--url is empty');
+    }
+    let parsed;
+    try {
+        parsed = new URL(trimmed);
+    }
+    catch {
+        parsed = new URL(`http://${trimmed}`);
+    }
+    const protocol = parsed.protocol === 'https:' ? 'https:' : 'http:';
+    const pathname = !parsed.pathname || parsed.pathname === '/' ? '' : parsed.pathname.replace(/\/+$/, '');
+    return `${protocol}//${parsed.host}${pathname}`;
+}
+function readPortHostFromConfig(loaded) {
+    const cfg = (loaded?.userConfig || {});
+    const host = typeof cfg?.httpserver?.host === 'string'
+        ? cfg.httpserver.host
+        : typeof cfg?.server?.host === 'string'
+            ? cfg.server.host
+            : typeof cfg?.host === 'string'
+                ? cfg.host
+                : undefined;
+    const port = normalizePort(cfg?.httpserver?.port ?? cfg?.server?.port ?? cfg?.port);
+    return { host, port };
+}
+function resolveApiKeyFromConfig(ctx, loaded) {
+    const fromEnv = normalizeString(ctx.env.ROUTECODEX_HTTP_APIKEY) || normalizeString(ctx.env.RCC_HTTP_APIKEY);
+    if (fromEnv) {
+        return fromEnv;
+    }
+    const cfg = (loaded?.userConfig || {});
+    return resolveConfigApiKeyValue(cfg?.httpserver?.apikey ?? cfg?.modules?.httpserver?.config?.apikey ?? cfg?.server?.apikey, ctx.env);
+}
+async function resolveBaseUrl(ctx, options) {
+    if (typeof options.url === 'string' && options.url.trim()) {
+        return normalizeBaseUrl(options.url);
+    }
+    let loaded = null;
+    try {
+        loaded = await ctx.loadConfig(typeof options.config === 'string' ? options.config : undefined);
+    }
+    catch {
+        loaded = null;
+    }
+    const configPick = readPortHostFromConfig(loaded);
+    const host = normalizeConnectHost(options.host || configPick.host || LOCAL_HOSTS.LOCALHOST, LOCAL_HOSTS.IPV4);
+    const explicitPortFromFlag = normalizePort(options.port);
+    const hasExplicitPort = Number.isFinite(explicitPortFromFlag) && explicitPortFromFlag > 0;
+    let port = normalizePort(options.port);
+    if (!Number.isFinite(port) || port <= 0) {
+        port = configPick.port;
+    }
+    if (!Number.isFinite(port) || port <= 0) {
+        port = normalizePort(ctx.env.ROUTECODEX_PORT || ctx.env.RCC_PORT);
+    }
+    if ((!Number.isFinite(port) || port <= 0) && ctx.isDevPackage) {
+        port = ctx.defaultDevPort;
+    }
+    if (!hasExplicitPort &&
+        Number.isFinite(port) &&
+        port > 0 &&
+        !(await probeServerHealth(ctx, host, port))) {
+        const discovered = await resolveDiscoveredActiveServerPort(ctx, host, new Set([port]));
+        if (typeof discovered === 'number' && Number.isFinite(discovered) && discovered > 0) {
+            ctx.logger.warning(`Configured heartbeat endpoint ${host}:${port} is unavailable; switched to active server ${host}:${discovered}.`);
+            port = discovered;
+        }
+    }
+    if (!Number.isFinite(port) || port <= 0) {
+        const discovered = await resolveDiscoveredActiveServerPort(ctx, host);
+        if (typeof discovered === 'number' && Number.isFinite(discovered) && discovered > 0) {
+            port = discovered;
+            ctx.logger.info(`Auto-discovered active RouteCodex server on ${host}:${port} (heartbeat is tmux-scoped).`);
+        }
+    }
+    if (!Number.isFinite(port) || port <= 0) {
+        throw new Error('Missing server port. Use --port / --url, env, or config file.');
+    }
+    return `http://${host}:${Math.floor(port)}`;
+}
+function normalizePositiveInt(value) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed)) {
+        return undefined;
+    }
+    const floored = Math.floor(parsed);
+    return floored > 0 ? floored : undefined;
+}
+async function probeServerHealth(ctx, host, port) {
+    if (!Number.isFinite(port) || port <= 0) {
+        return false;
+    }
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => {
+            try {
+                controller.abort();
+            }
+            catch {
+                // ignore
+            }
+        }, 800);
+        const response = await ctx.fetch(`http://${host}:${port}/health`, {
+            method: 'GET',
+            signal: controller.signal
+        });
+        clearTimeout(timer);
+        if (!response.ok) {
+            return false;
+        }
+        const payload = await response.json().catch(() => null);
+        const status = typeof payload?.status === 'string' ? payload.status.toLowerCase() : '';
+        return Boolean(payload &&
+            (status === 'healthy' || status === 'ready' || status === 'ok' || payload?.ready === true || payload?.pipelineReady === true));
+    }
+    catch {
+        return false;
+    }
+}
+async function collectCandidatePortsFromUserDir(userDir) {
+    const out = new Set();
+    try {
+        const entries = await fs.readdir(userDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isFile()) {
+                continue;
+            }
+            const match = entry.name.match(/^server-(\d+)\.pid$/);
+            if (!match || !match[1]) {
+                continue;
+            }
+            const parsed = normalizePositiveInt(match[1]);
+            if (parsed) {
+                out.add(parsed);
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    try {
+        const lifecycleDir = path.join(userDir, 'state', 'runtime-lifecycle');
+        const entries = await fs.readdir(lifecycleDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isFile()) {
+                continue;
+            }
+            const match = entry.name.match(/^server-(\d+)\.json$/);
+            if (!match || !match[1]) {
+                continue;
+            }
+            const parsed = normalizePositiveInt(match[1]);
+            if (parsed) {
+                out.add(parsed);
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return Array.from(out);
+}
+async function resolveDiscoveredActiveServerPort(ctx, host, excludePorts) {
+    const userDir = resolveRccUserDir();
+    const candidates = await collectCandidatePortsFromUserDir(userDir);
+    for (const port of candidates) {
+        if (excludePorts?.has(port)) {
+            continue;
+        }
+        if (await probeServerHealth(ctx, host, port)) {
+            return port;
+        }
+    }
+    return undefined;
+}
+async function callJson(ctx, url, method, apiKey, body) {
+    const response = await ctx.fetch(url, {
+        method,
+        headers: {
+            ...(method === 'POST' ? { 'content-type': 'application/json' } : {}),
+            ...(apiKey ? { 'x-api-key': apiKey } : {})
+        },
+        ...(body ? { body: JSON.stringify(body) } : {})
+    });
+    const text = await response.text().catch(() => '');
+    const data = text ? JSON.parse(text) : null;
+    if (!response.ok) {
+        throw new Error(`heartbeat request failed (${response.status}): ${text}`);
+    }
+    return data;
+}
+function buildTarget(options) {
+    const tmuxSessionId = normalizeString(options.tmuxSessionId);
+    const sessionId = normalizeString(options.sessionId);
+    const daemonId = normalizeString(options.daemonId);
+    return {
+        ...(tmuxSessionId ? { tmuxSessionId } : {}),
+        ...(sessionId ? { sessionId } : {}),
+        ...(daemonId ? { daemonId } : {})
+    };
+}
+export function createHeartbeatCommand(program, ctx) {
+    const base = (command) => command
+        .option('--port <port>', 'RouteCodex server port')
+        .option('--host <host>', 'RouteCodex server host')
+        .option('--url <url>', 'RouteCodex base URL')
+        .option('-c, --config <config>', 'RouteCodex configuration file path')
+        .option('--tmux-session-id <tmuxSessionId>', 'Target tmux session id')
+        .option('--session-id <sessionId>', 'Alias for tmux session id / conversation session id')
+        .option('--daemon-id <daemonId>', 'Resolve target tmux session from daemon id')
+        .option('--json', 'Print JSON output');
+    const print = (options, payload) => {
+        if (options.json) {
+            ctx.log(JSON.stringify(payload, null, 2));
+            return;
+        }
+        ctx.log(JSON.stringify(payload, null, 2));
+    };
+    const command = program.command('heartbeat').description('Manage tmux heartbeat state and trigger heartbeat injections');
+    base(command.command('list').description('List all heartbeat states')).action(async (options) => {
+        const loaded = await ctx.loadConfig(typeof options.config === 'string' ? options.config : undefined).catch(() => null);
+        const baseUrl = await resolveBaseUrl(ctx, options);
+        const apiKey = resolveApiKeyFromConfig(ctx, loaded);
+        const payload = await callJson(ctx, `${baseUrl}/daemon/heartbeat/list`, 'GET', apiKey);
+        print(options, payload);
+    });
+    base(command.command('status').description('Show one heartbeat state')).action(async (options) => {
+        const loaded = await ctx.loadConfig(typeof options.config === 'string' ? options.config : undefined).catch(() => null);
+        const baseUrl = await resolveBaseUrl(ctx, options);
+        const apiKey = resolveApiKeyFromConfig(ctx, loaded);
+        const params = new URLSearchParams();
+        const target = buildTarget(options);
+        for (const [key, value] of Object.entries(target)) {
+            if (typeof value === 'string' && value.trim()) {
+                params.set(key, value);
+            }
+        }
+        const payload = await callJson(ctx, `${baseUrl}/daemon/heartbeat?${params.toString()}`, 'GET', apiKey);
+        print(options, payload);
+    });
+    base(command.command('on').description('Enable heartbeat and attempt immediate trigger')).action(async (options) => {
+        const loaded = await ctx.loadConfig(typeof options.config === 'string' ? options.config : undefined).catch(() => null);
+        const baseUrl = await resolveBaseUrl(ctx, options);
+        const apiKey = resolveApiKeyFromConfig(ctx, loaded);
+        const payload = await callJson(ctx, `${baseUrl}/daemon/heartbeat`, 'POST', apiKey, {
+            action: 'on',
+            ...buildTarget(options)
+        });
+        print(options, payload);
+    });
+    base(command.command('off').description('Disable heartbeat')).action(async (options) => {
+        const loaded = await ctx.loadConfig(typeof options.config === 'string' ? options.config : undefined).catch(() => null);
+        const baseUrl = await resolveBaseUrl(ctx, options);
+        const apiKey = resolveApiKeyFromConfig(ctx, loaded);
+        const payload = await callJson(ctx, `${baseUrl}/daemon/heartbeat`, 'POST', apiKey, {
+            action: 'off',
+            ...buildTarget(options)
+        });
+        print(options, payload);
+    });
+    base(command
+        .command('trigger')
+        .description('Trigger one heartbeat dispatch immediately')
+        .option('--dry-run', 'Evaluate gating without injecting')).action(async (options) => {
+        const loaded = await ctx.loadConfig(typeof options.config === 'string' ? options.config : undefined).catch(() => null);
+        const baseUrl = await resolveBaseUrl(ctx, options);
+        const apiKey = resolveApiKeyFromConfig(ctx, loaded);
+        const payload = await callJson(ctx, `${baseUrl}/daemon/heartbeat`, 'POST', apiKey, {
+            action: 'trigger',
+            ...buildTarget(options),
+            ...(options.dryRun ? { dryRun: true } : {})
+        });
+        print(options, payload);
+    });
+    base(command
+        .command('history')
+        .description('Show heartbeat execution history for a tmux session')
+        .option('--limit <limit>', 'Max number of records (default: 100)')).action(async (options) => {
+        const loaded = await ctx.loadConfig(typeof options.config === 'string' ? options.config : undefined).catch(() => null);
+        const baseUrl = await resolveBaseUrl(ctx, options);
+        const apiKey = resolveApiKeyFromConfig(ctx, loaded);
+        const params = new URLSearchParams();
+        const target = buildTarget(options);
+        for (const [key, value] of Object.entries(target)) {
+            if (typeof value === 'string' && value.trim()) {
+                params.set(key, value);
+            }
+        }
+        const limit = normalizePositiveInt(options.limit);
+        if (limit) {
+            params.set('limit', String(limit));
+        }
+        const payload = await callJson(ctx, `${baseUrl}/daemon/heartbeat/history?${params.toString()}`, 'GET', apiKey);
+        print(options, payload);
+    });
+}
+//# sourceMappingURL=heartbeat.js.map

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

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

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

@@ -32,6 +32,7 @@ export type LauncherCommandContext = {
     logger: LoggerLike;
     env: NodeJS.ProcessEnv;
     rawArgv: string[];
+    isInteractiveTerminal?: () => boolean;
     fsImpl?: typeof fs;
     pathImpl?: typeof path;
     homedir: () => string;
@@ -81,7 +82,6 @@ export type LauncherSpec = {
         baseUrl: string;
         configuredApiKey: string | null;
         cwd: string;
-        options: LauncherCommandOptions;
     }) => NodeJS.ProcessEnv;
 };
 export type ResolvedServerConnection = {

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

@@ -330,11 +330,37 @@ export function resolveWorkingDirectory(cwdFn, fsImpl, pathImpl, requested) {
         if (fsImpl.existsSync(resolved)) {
             return resolved;
         }
+        if (requested) {
+            return resolved;
+        }
+    }
+    catch {
+        // fall through to fallback candidates
+    }
+    try {
+        return pathImpl.resolve(getCwd());
     }
     catch {
-        return getCwd();
+        const fallbackCandidates = [
+            typeof process.env.PWD === 'string' ? process.env.PWD : '',
+            typeof process.env.HOME === 'string' ? process.env.HOME : ''
+        ]
+            .map((entry) => String(entry || '').trim())
+            .filter(Boolean);
+        for (const candidate of fallbackCandidates) {
+            try {
+                const resolved = pathImpl.resolve(candidate);
+                const stats = fsImpl.statSync(resolved);
+                if (stats && typeof stats.isDirectory === 'function' && stats.isDirectory()) {
+                    return resolved;
+                }
+            }
+            catch {
+                // try next fallback
+            }
+        }
+        throw new Error('Failed to resolve working directory (uv_cwd). Please rerun with --cwd <dir>.');
     }
-    return getCwd();
 }
 /**
  * Collect pass-through arguments