@a1hvdy/cc-openclaw 0.9.2 → 0.11.0

package/dist/src/command-router/resume-policy.js

@@ -0,0 +1,236 @@
+/**
+ * resume-policy — /cc+ continuation, /cc resume, rehydrate, and turn-extension logic.
+ *
+ * Extracted from cc-handler.ts (Step 4 of Phase 5 v0.11.0 decomposition).
+ * Each public function takes PolicyDeps as its first argument per PRP §7 Q3.
+ * cc-handler.ts retains ownership of the sessionManager/activeSessions/logger
+ * singletons and threads them in via `_deps()` on every call.
+ *
+ * Callers MUST verify `sessionManager !== null` before constructing deps:
+ * PolicyDeps.sessionManager is typed non-null and these handlers assume it.
+ * The "Claude Code handler not ready — try again in a few seconds." response
+ * is now produced at the dispatcher in cc-handler.ts.
+ */
+import { DEFAULT_CWD, sessionMapKey, saveSession, loadSession, loadSessionById, scanAllSessions, IDLE_TIMEOUT_MS, ACK_TIMEOUT_MS, scheduleIdle, _postTurnContextCheck, } from './launch-policy.js';
+import { sendDirectReply } from './turn-formatter.js';
+const PLUGIN_TAG = '[cc-openclaw/resume-policy]';
+// ── Continuation Handler ──────────────────────────────────────────────────
+export function handleContinuation(deps, prompt, chatId, threadId) {
+    const { sessionManager, activeSessions, logger } = deps;
+    const key = sessionMapKey(chatId, threadId);
+    const active = activeSessions.get(key);
+    if (!active) {
+        return {
+            handled: true,
+            text: 'No active session to continue. Start one with /cc <prompt> or /cc resume',
+        };
+    }
+    if (active.needsRehydration) {
+        if (!active.meta.claudeSessionId) {
+            activeSessions.delete(key);
+            return {
+                handled: true,
+                text: 'Recovered session has no Claude ID — start fresh with /cc <prompt>',
+            };
+        }
+        logger.info(`${PLUGIN_TAG} /cc+ rehydrating recovered session: slug=${active.slug} chat=${chatId} thread=${threadId || 'none'}`);
+        let resolveAckId;
+        const ackIdPromise = new Promise((r) => {
+            resolveAckId = r;
+        });
+        (async () => {
+            try {
+                await rehydrateSession(deps, active.meta, chatId, threadId);
+                active.needsRehydration = false;
+                await continueTurn(deps, active, prompt, chatId, threadId, ackIdPromise);
+            }
+            catch (err) {
+                logger.error(`${PLUGIN_TAG} Rehydrate+continue ${active.slug} failed: ${err instanceof Error ? err.message : String(err)}`);
+                scheduleIdle(deps, key, active);
+            }
+        })();
+        return {
+            handled: true,
+            text: `⏳ [${active.meta.id || '?'}] Resuming & continuing ${active.slug}...`,
+            _resolveAckId: resolveAckId,
+        };
+    }
+    try {
+        sessionManager.getStatus(active.sessionName);
+    }
+    catch {
+        activeSessions.delete(key);
+        return {
+            handled: true,
+            text: 'Previous session expired. Use /cc resume or start fresh with /cc <prompt>',
+        };
+    }
+    if (active.idleTimer)
+        clearTimeout(active.idleTimer);
+    logger.info(`${PLUGIN_TAG} /cc+ continuation: slug=${active.slug} chat=${chatId} thread=${threadId || 'none'}`);
+    let resolveAckId;
+    const ackIdPromise = new Promise((r) => {
+        resolveAckId = r;
+    });
+    continueTurn(deps, active, prompt, chatId, threadId, ackIdPromise).catch((err) => {
+        logger.error(`${PLUGIN_TAG} Continuation ${active.slug} failed: ${err instanceof Error ? err.message : String(err)}`);
+        scheduleIdle(deps, key, active);
+    });
+    return {
+        handled: true,
+        text: `⏳ [${active.meta.id || '?'}] Continuing ${active.slug}...`,
+        _resolveAckId: resolveAckId,
+    };
+}
+// ── Resume Handler ────────────────────────────────────────────────────────
+export function handleResume(deps, chatId, threadId, targetSlug) {
+    const { activeSessions, logger } = deps;
+    const key = sessionMapKey(chatId, threadId);
+    const currentActive = activeSessions.get(key);
+    if (currentActive) {
+        return {
+            handled: true,
+            text: `Already have active session: ${currentActive.slug}\nUse /cc stop first, or /cc+ to continue it.`,
+        };
+    }
+    let meta = null;
+    if (targetSlug) {
+        const isSessionId = /^[0-9a-f]{8}$/i.test(targetSlug);
+        if (isSessionId) {
+            meta = loadSessionById(targetSlug.toLowerCase());
+        }
+        if (!meta) {
+            meta = loadSession(targetSlug);
+        }
+        if (!meta) {
+            return { handled: true, text: `Session "${targetSlug}" not found.` };
+        }
+        if (meta.chatId !== chatId) {
+            return {
+                handled: true,
+                text: `Session "${targetSlug}" belongs to a different chat.`,
+            };
+        }
+    }
+    else {
+        const candidates = scanAllSessions()
+            .filter((s) => s.chatId === chatId &&
+            (s.threadId || undefined) === (threadId || undefined) &&
+            !!s.claudeSessionId)
+            .sort((a, b) => {
+            const timeA = new Date(a.lastContinuedAt || a.completedAt || a.startedAt).getTime();
+            const timeB = new Date(b.lastContinuedAt || b.completedAt || b.startedAt).getTime();
+            return timeB - timeA;
+        });
+        if (candidates.length === 0) {
+            return {
+                handled: true,
+                text: 'No resumable session found. Start fresh with /cc <prompt>',
+            };
+        }
+        meta = candidates[0];
+    }
+    if (!meta.claudeSessionId) {
+        return {
+            handled: true,
+            text: `Session ${meta.slug} has no Claude session ID — cannot resume.\nStart fresh with /cc <prompt>`,
+        };
+    }
+    const { slug, id: resumeId } = meta;
+    logger.info(`${PLUGIN_TAG} /cc resume: id=${resumeId} slug=${slug} claudeId=${meta.claudeSessionId} chat=${chatId} thread=${threadId || 'none'}`);
+    rehydrateSession(deps, meta, chatId, threadId).catch((err) => {
+        logger.error(`${PLUGIN_TAG} Resume ${slug} failed: ${err instanceof Error ? err.message : String(err)}`);
+        meta.state = 'failed';
+        meta.error = `Resume failed: ${err instanceof Error ? err.message : String(err)}`;
+        try {
+            saveSession(meta);
+        }
+        catch { /* best effort */ }
+        const active = activeSessions.get(key);
+        if (active?.slug === slug) {
+            if (active.idleTimer)
+                clearTimeout(active.idleTimer);
+            activeSessions.delete(key);
+        }
+    });
+    return { handled: true, text: `⏳ [${resumeId || '?'}] Resuming ${slug}...` };
+}
+// ── Rehydrate Session ─────────────────────────────────────────────────────
+export async function rehydrateSession(deps, meta, chatId, threadId) {
+    const { sessionManager, activeSessions, logger } = deps;
+    const { slug, sessionName, claudeSessionId } = meta;
+    const key = sessionMapKey(chatId, threadId);
+    logger.info(`${PLUGIN_TAG} Rehydrating ${sessionName} with claudeSessionId=${claudeSessionId}...`);
+    await sessionManager.startSession({
+        name: sessionName,
+        cwd: meta.cwd || DEFAULT_CWD,
+        engine: 'claude',
+        permissionMode: 'bypassPermissions',
+        effort: 'high',
+        resumeSessionId: claudeSessionId,
+    });
+    const prevActive = activeSessions.get(key);
+    if (prevActive && prevActive.sessionName !== sessionName) {
+        if (prevActive.idleTimer)
+            clearTimeout(prevActive.idleTimer);
+        try {
+            await sessionManager.stopSession(prevActive.sessionName);
+        }
+        catch { /* ignore */ }
+    }
+    meta.state = 'idle';
+    meta.threadId = threadId;
+    meta.lastContinuedAt = new Date().toISOString();
+    try {
+        saveSession(meta);
+    }
+    catch { /* best effort */ }
+    const activeEntry = { sessionName, slug, meta, idleTimer: null };
+    activeSessions.set(key, activeEntry);
+    logger.info(`${PLUGIN_TAG} Session ${sessionName} resumed — idle for ${IDLE_TIMEOUT_MS / 1000}s`);
+    scheduleIdle(deps, key, activeEntry);
+}
+// ── Continuation Turn ─────────────────────────────────────────────────────
+export async function continueTurn(deps, active, prompt, chatId, threadId, ackIdPromise) {
+    const { sessionManager, logger } = deps;
+    const { sessionName, meta } = active;
+    const key = sessionMapKey(chatId, threadId);
+    meta.state = 'running';
+    try {
+        saveSession(meta);
+    }
+    catch { /* best effort */ }
+    const opts = { telegramChatId: chatId };
+    if (threadId)
+        opts.telegramThreadId = threadId;
+    const ackMsgId = await Promise.race([
+        ackIdPromise,
+        new Promise((r) => setTimeout(() => r(null), ACK_TIMEOUT_MS)),
+    ]);
+    if (ackMsgId)
+        opts.telegramAckMessageId = ackMsgId;
+    const result = await sessionManager.sendMessage(sessionName, prompt, opts);
+    meta.state = 'idle';
+    meta.turns = (meta.turns || 1) + 1;
+    meta.lastContinuedAt = new Date().toISOString();
+    meta.output = (result?.output || '').slice(0, 2000);
+    meta.claudeSessionId = result?.sessionId ?? meta.claudeSessionId;
+    try {
+        saveSession(meta);
+    }
+    catch { /* best effort */ }
+    // v0.6.0: post-turn context-pressure check (continuation turn).
+    void _postTurnContextCheck(deps, sessionName, chatId, threadId);
+    // 2026-05-07 FIX — direct answer delivery (continuation turn).
+    if (result?.output && chatId) {
+        try {
+            await sendDirectReply(chatId, threadId, result.output, logger);
+        }
+        catch (e) {
+            logger.warn(`${PLUGIN_TAG} Direct answer delivery failed for ${sessionName} (continuation): ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    logger.info(`${PLUGIN_TAG} Session ${sessionName} turn ${meta.turns} complete`);
+    scheduleIdle(deps, key, active);
+}
+//# sourceMappingURL=resume-policy.js.map

package/dist/src/command-router/resume-policy.js.map

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

package/dist/src/command-router/turn-formatter.d.ts

@@ -0,0 +1,19 @@
+/**
+ * turn-formatter — Telegram direct-send + observability formatting helpers.
+ *
+ * Extracted from cc-handler.ts (Step 1 of Phase 5 v0.11.0 decomposition).
+ * Contains: loadBotToken, telegramApiDirect, sendDirectReply,
+ *           buildPhase2FlagsLine, buildObservabilityLines.
+ */
+export declare function loadBotToken(logger?: Console): void;
+export declare function sendDirectReply(chatId: string, threadId: string | undefined, text: string, logger?: Console): Promise<number | null>;
+/** Returns the current BOT_TOKEN (for callers that need to check if it's set). */
+export declare function hasBotToken(): boolean;
+export declare function buildPhase2FlagsLine(): string;
+/**
+ * Pillar C v0.4.0 — compose observability lines for /cc status panel.
+ * Reads from Pillar A metrics, Pillar B trajectory tail, and status-tee
+ * quota snapshot. Each source is independently fault-tolerant: if one
+ * fails, the line shows "?" rather than crashing the panel.
+ */
+export declare function buildObservabilityLines(): string;

package/dist/src/command-router/turn-formatter.js

@@ -0,0 +1,144 @@
+/**
+ * turn-formatter — Telegram direct-send + observability formatting helpers.
+ *
+ * Extracted from cc-handler.ts (Step 1 of Phase 5 v0.11.0 decomposition).
+ * Contains: loadBotToken, telegramApiDirect, sendDirectReply,
+ *           buildPhase2FlagsLine, buildObservabilityLines.
+ */
+import * as fs from 'node:fs';
+import { request as httpsRequest } from 'node:https';
+const PLUGIN_TAG = '[cc-openclaw/command-router]';
+const OPENCLAW_CONFIG_PATH = '/home/a1xai/.openclaw/openclaw.json';
+// ── Telegram Direct Send ──────────────────────────────────────────────────
+let BOT_TOKEN = '';
+export function loadBotToken(logger = console) {
+    if (BOT_TOKEN)
+        return;
+    try {
+        const raw = fs.readFileSync(OPENCLAW_CONFIG_PATH, 'utf8');
+        const cfg = JSON.parse(raw);
+        const tg = cfg.channels?.telegram;
+        if (tg?.accounts) {
+            const acctKey = tg.defaultAccount || 'default';
+            const acct = tg.accounts[acctKey] || {};
+            BOT_TOKEN = acct.botToken || '';
+        }
+        if (BOT_TOKEN)
+            logger.info(`${PLUGIN_TAG} Bot token loaded for direct replies`);
+    }
+    catch (err) {
+        logger.warn(`${PLUGIN_TAG} Failed to load bot token: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+function telegramApiDirect(method, params) {
+    return new Promise((resolve, reject) => {
+        const body = JSON.stringify(params);
+        const options = {
+            hostname: 'api.telegram.org',
+            path: `/bot${BOT_TOKEN}/${method}`,
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Content-Length': Buffer.byteLength(body),
+            },
+        };
+        const req = httpsRequest(options, (res) => {
+            let data = '';
+            res.on('data', (chunk) => (data += chunk));
+            res.on('end', () => {
+                try {
+                    resolve(JSON.parse(data));
+                }
+                catch {
+                    resolve({ ok: false });
+                }
+            });
+        });
+        req.on('error', reject);
+        req.setTimeout(10_000, () => req.destroy(new Error('Telegram API timeout')));
+        req.write(body);
+        req.end();
+    });
+}
+export async function sendDirectReply(chatId, threadId, text, logger = console) {
+    if (!BOT_TOKEN || !chatId)
+        return null;
+    try {
+        const params = {
+            chat_id: chatId,
+            text,
+            disable_web_page_preview: true,
+        };
+        if (threadId)
+            params.message_thread_id = Number(threadId);
+        const res = await telegramApiDirect('sendMessage', params);
+        if (!res.ok) {
+            logger.warn(`${PLUGIN_TAG} Direct reply failed: ${JSON.stringify(res.description || res)}`);
+            return null;
+        }
+        return res.result?.message_id ?? null;
+    }
+    catch (err) {
+        logger.warn(`${PLUGIN_TAG} Direct reply error: ${err instanceof Error ? err.message : String(err)}`);
+        return null;
+    }
+}
+/** Returns the current BOT_TOKEN (for callers that need to check if it's set). */
+export function hasBotToken() {
+    return BOT_TOKEN !== '';
+}
+// ── Phase 2 Flags ─────────────────────────────────────────────────────────
+export function buildPhase2FlagsLine() {
+    const allowBuiltins = process.env.CC_OPENCLAW_ALLOW_BUILTINS === '1';
+    const toolStream = process.env.CC_OPENCLAW_TOOL_STREAM === '1';
+    return `Flags: builtins=${allowBuiltins ? 'on' : 'off'} | toolstream=${toolStream ? 'on' : 'off'}`;
+}
+// ── Observability Lines ───────────────────────────────────────────────────
+/**
+ * Pillar C v0.4.0 — compose observability lines for /cc status panel.
+ * Reads from Pillar A metrics, Pillar B trajectory tail, and status-tee
+ * quota snapshot. Each source is independently fault-tolerant: if one
+ * fails, the line shows "?" rather than crashing the panel.
+ */
+export function buildObservabilityLines() {
+    const lines = [];
+    // Plan quota (status-tee)
+    try {
+        // Lazy require so this file remains testable without status-tee
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { readQuotaSnapshot, formatQuotaLine } = require('../lib/status-tee-reader.js');
+        lines.push(formatQuotaLine(readQuotaSnapshot()));
+    }
+    catch {
+        lines.push('Plan: ?%');
+    }
+    // Workers + uptime + last error (Pillar A metrics)
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { metricsRegistry } = require('../health/metrics.js');
+        const out = metricsRegistry.serializePrometheus();
+        const workersMatch = /cc_openclaw_workers (\d+)/.exec(out);
+        const uptimeMatch = /cc_openclaw_uptime_seconds (\d+)/.exec(out);
+        const lastErrMatch = /cc_openclaw_last_error_seconds (\d+)/.exec(out);
+        const errorsMatch = /cc_openclaw_errors_total (\d+)/.exec(out);
+        const workers = workersMatch ? workersMatch[1] : '?';
+        const uptime = uptimeMatch ? Math.floor(parseInt(uptimeMatch[1], 10) / 60) : '?';
+        lines.push(`Workers: ${workers} | Uptime: ${uptime}m`);
+        const errCount = errorsMatch ? parseInt(errorsMatch[1], 10) : 0;
+        const lastErrTs = lastErrMatch ? parseInt(lastErrMatch[1], 10) : 0;
+        if (errCount === 0 || lastErrTs === 0) {
+            lines.push('Last error: none');
+        }
+        else {
+            const agoSec = Math.floor(Date.now() / 1000) - lastErrTs;
+            const agoLabel = agoSec < 60 ? `${agoSec}s` : agoSec < 3600 ? `${Math.floor(agoSec / 60)}m` : `${Math.floor(agoSec / 3600)}h`;
+            lines.push(`Last error: ${agoLabel} ago (${errCount} total)`);
+        }
+    }
+    catch {
+        lines.push('Workers: ? | Uptime: ?');
+        lines.push('Last error: ?');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=turn-formatter.js.map

package/dist/src/command-router/turn-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-formatter.js","sourceRoot":"","sources":["../../../src/command-router/turn-formatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,UAAU,GAAG,8BAA8B,CAAC;AAClD,MAAM,oBAAoB,GAAG,qCAAqC,CAAC;AAEnE,6EAA6E;AAE7E,IAAI,SAAS,GAAG,EAAE,CAAC;AAEnB,MAAM,UAAU,YAAY,CAAC,SAAkB,OAAO;IACpD,IAAI,SAAS;QAAE,OAAO;IACtB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QACvD,MAAM,EAAE,GAAI,GAAG,CAAC,QAAgD,EAAE,QAErD,CAAC;QACd,IAAI,EAAE,EAAE,QAAQ,EAAE,CAAC;YACjB,MAAM,OAAO,GAAI,EAAE,CAAC,cAAyB,IAAI,SAAS,CAAC;YAC3D,MAAM,IAAI,GAAI,EAAE,CAAC,QAAmD,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACpF,SAAS,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QAClC,CAAC;QACD,IAAI,SAAS;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,sCAAsC,CAAC,CAAC;IAClF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CACT,GAAG,UAAU,8BAA8B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC9F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,MAAc,EACd,MAA+B;IAE/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG;YACd,QAAQ,EAAE,kBAAkB;YAC5B,IAAI,EAAE,OAAO,SAAS,IAAI,MAAM,EAAE;YAClC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;aAC1C;SACF,CAAC;QACF,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxC,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC;YACnD,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;gBACjB,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4E,CAAC,CAAC;gBACvG,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxB,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAC7E,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChB,GAAG,CAAC,GAAG,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAc,EACd,QAA4B,EAC5B,IAAY,EACZ,SAAkB,OAAO;IAEzB,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAA4B;YACtC,OAAO,EAAE,MAAM;YACf,IAAI;YACJ,wBAAwB,EAAE,IAAI;SAC/B,CAAC;QACF,IAAI,QAAQ;YAAE,MAAM,CAAC,iBAAiB,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC3D,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,CAAC,IAAI,CACT,GAAG,UAAU,yBAAyB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,EAAE,CAC/E,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,CAAC,MAAM,EAAE,UAAU,IAAI,IAAI,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CACT,GAAG,UAAU,wBAAwB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACxF,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,WAAW;IACzB,OAAO,SAAS,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,6EAA6E;AAE7E,MAAM,UAAU,oBAAoB;IAClC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,GAAG,CAAC;IACrE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,GAAG,CAAC;IAC/D,OAAO,mBAAmB,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,iBAAiB,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;AACrG,CAAC;AAED,6EAA6E;AAE7E;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,0BAA0B;IAC1B,IAAI,CAAC;QACH,gEAAgE;QAChE,iEAAiE;QACjE,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,6BAA6B,CAGnF,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IAED,mDAAmD;IACnD,IAAI,CAAC;QACH,iEAAiE;QACjE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,sBAAsB,CAIzD,CAAC;QACF,MAAM,GAAG,GAAG,eAAe,CAAC,mBAAmB,EAAE,CAAC;QAClD,MAAM,YAAY,GAAG,2BAA2B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3D,MAAM,WAAW,GAAG,kCAAkC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,YAAY,GAAG,sCAAsC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG,gCAAgC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE/D,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACrD,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,cAAc,MAAM,GAAG,CAAC,CAAC;QAEvD,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,IAAI,QAAQ,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;YACzD,MAAM,QAAQ,GAAG,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC;YAC9H,KAAK,CAAC,IAAI,CAAC,eAAe,QAAQ,SAAS,QAAQ,SAAS,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/src/constants.d.ts

@@ -15,8 +15,39 @@ export declare const GREP_HISTORY_FETCH = 500;
 export declare const SESSION_READY_TIMEOUT_MS = 30000;
 /** Fallback delay before checking if proc is alive (resume path) */
 export declare const SESSION_READY_FALLBACK_MS = 2000;
-/** Default timeout for a send() / turn completion */
-export declare const TURN_TIMEOUT_MS = 300000;
+/** Default timeout for a send() / turn completion.
+ *  v0.10.0: bumped 300_000 → 900_000 to align with the
+ *  `models.providers.cc-openclaw.timeoutSeconds` outer envelope. The
+ *  runtime stalled-session watchdog (STALLED_SESSION_KILL_MS) is the real
+ *  ceiling for stuck subprocesses; this constant just prevents an internal
+ *  per-turn timeout from firing before the outer wall and silently masking
+ *  the stall as a "timeout" rather than a watchdog kill. */
+export declare const TURN_TIMEOUT_MS = 900000;
+/** Runtime watchdog threshold for "stuck" sessions. If a session is
+ *  `isBusy === true` AND its stats.lastActivity hasn't moved in this many
+ *  ms, the SessionManager watchdog aborts + disposes the session. Mirrors
+ *  the boot-time orphan reaper in gateway-pm2-wrapper.sh:53-60, but runs
+ *  continuously on a setInterval. Env-overridable via
+ *  CC_OPENCLAW_STALLED_KILL_MS. v0.10.0. */
+export declare const STALLED_SESSION_KILL_MS = 180000;
+/** How often the stalled-session watchdog scans the sessions Map. */
+export declare const STALLED_WATCH_INTERVAL_MS = 30000;
+/** Runaway-loop watchdog: max new cc-openclaw subprocess spawns within
+ *  RUNAWAY_LOOP_WINDOW_MS before the next spawn is refused.
+ *
+ *  Rationale: when OpenClaw's agent-runner re-fires `before_model_resolve`
+ *  multiple times for one user turn (the 2026-05-11 17:42 incident
+ *  spawned 4 subprocesses in 60s on session 7be69d1b), the cc-openclaw
+ *  side has no signal that it's the same conversation — each request
+ *  carries a fresh runId in the X-Session-Id header, so the existing
+ *  stalled-session watchdog never fires. This second-dimension
+ *  watchdog catches runaway loops by spawn rate across the SessionManager.
+ *
+ *  Env override: CC_OPENCLAW_LOOP_MAX_SUBPROCS. Min 2, max 20.
+ *  v0.10.1. */
+export declare const RUNAWAY_LOOP_MAX_SUBPROCS = 3;
+/** Sliding window for the runaway-loop spawn-rate counter. */
+export declare const RUNAWAY_LOOP_WINDOW_MS = 60000;
 /** Timeout for compact / context summary operations */
 export declare const COMPACT_TIMEOUT_MS = 60000;
 /** Delay before SIGKILL after initial SIGTERM on stop() */

package/dist/src/constants.js

@@ -18,8 +18,39 @@ export const GREP_HISTORY_FETCH = 500;
 export const SESSION_READY_TIMEOUT_MS = 30_000;
 /** Fallback delay before checking if proc is alive (resume path) */
 export const SESSION_READY_FALLBACK_MS = 2_000;
-/** Default timeout for a send() / turn completion */
-export const TURN_TIMEOUT_MS = 300_000;
+/** Default timeout for a send() / turn completion.
+ *  v0.10.0: bumped 300_000 → 900_000 to align with the
+ *  `models.providers.cc-openclaw.timeoutSeconds` outer envelope. The
+ *  runtime stalled-session watchdog (STALLED_SESSION_KILL_MS) is the real
+ *  ceiling for stuck subprocesses; this constant just prevents an internal
+ *  per-turn timeout from firing before the outer wall and silently masking
+ *  the stall as a "timeout" rather than a watchdog kill. */
+export const TURN_TIMEOUT_MS = 900_000;
+/** Runtime watchdog threshold for "stuck" sessions. If a session is
+ *  `isBusy === true` AND its stats.lastActivity hasn't moved in this many
+ *  ms, the SessionManager watchdog aborts + disposes the session. Mirrors
+ *  the boot-time orphan reaper in gateway-pm2-wrapper.sh:53-60, but runs
+ *  continuously on a setInterval. Env-overridable via
+ *  CC_OPENCLAW_STALLED_KILL_MS. v0.10.0. */
+export const STALLED_SESSION_KILL_MS = 180_000;
+/** How often the stalled-session watchdog scans the sessions Map. */
+export const STALLED_WATCH_INTERVAL_MS = 30_000;
+/** Runaway-loop watchdog: max new cc-openclaw subprocess spawns within
+ *  RUNAWAY_LOOP_WINDOW_MS before the next spawn is refused.
+ *
+ *  Rationale: when OpenClaw's agent-runner re-fires `before_model_resolve`
+ *  multiple times for one user turn (the 2026-05-11 17:42 incident
+ *  spawned 4 subprocesses in 60s on session 7be69d1b), the cc-openclaw
+ *  side has no signal that it's the same conversation — each request
+ *  carries a fresh runId in the X-Session-Id header, so the existing
+ *  stalled-session watchdog never fires. This second-dimension
+ *  watchdog catches runaway loops by spawn rate across the SessionManager.
+ *
+ *  Env override: CC_OPENCLAW_LOOP_MAX_SUBPROCS. Min 2, max 20.
+ *  v0.10.1. */
+export const RUNAWAY_LOOP_MAX_SUBPROCS = 3;
+/** Sliding window for the runaway-loop spawn-rate counter. */
+export const RUNAWAY_LOOP_WINDOW_MS = 60_000;
 /** Timeout for compact / context summary operations */
 export const COMPACT_TIMEOUT_MS = 60_000;
 /** Delay before SIGKILL after initial SIGTERM on stop() */

package/dist/src/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,8EAA8E;AAE9E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAE9C,+EAA+E;AAE/E,gFAAgF;AAChF,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,iEAAiE;AACjE,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACxC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAEtC,+EAA+E;AAE/E,oDAAoD;AACpD,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAC/C,oEAAoE;AACpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAC/C,qDAAqD;AACrD,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AACvC,uDAAuD;AACvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AACzC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,wEAAwE;AACxE,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AACxC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAC9C,2CAA2C;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAClD,mCAAmC;AACnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAC1C,oDAAoD;AACpD,MAAM,CAAC,MAAM,6BAA6B,GAAG,KAAK,CAAC;AACnD,4CAA4C;AAC5C,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAC1C,uCAAuC;AACvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAC3C,uCAAuC;AACvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAC;AAC5C,qCAAqC;AACrC,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAC9C,kDAAkD;AAClD,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AACvC,yCAAyC;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAC1C,kDAAkD;AAClD,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC;AACvC,2CAA2C;AAC3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAC3D,+CAA+C;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AACxC,mCAAmC;AACnC,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC;AAElD,+EAA+E;AAE/E,gDAAgD;AAChD,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAC1C,uCAAuC;AACvC,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC;AACvC,iDAAiD;AACjD,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAC3C,0CAA0C;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE3C,+EAA+E;AAE/E,sCAAsC;AACtC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AACjC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAC5C,mDAAmD;AACnD,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC;AAChD,sCAAsC;AACtC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAC3C,kDAAkD;AAClD,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,sDAAsD;AACtD,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AACvC,0CAA0C;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AACzC,kDAAkD;AAClD,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,kCAAkC;AAClC,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAC9C,uCAAuC;AACvC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC,+EAA+E;AAE/E,qCAAqC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,+EAA+E;AAE/E,gDAAgD;AAChD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAC3C,gDAAgD;AAChD,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAK,CAAC;AACrD,mCAAmC;AACnC,MAAM,CAAC,MAAM,8BAA8B,GAAG,OAAO,CAAC;AAEtD,+EAA+E;AAE/E,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;IAC1B,MAAM,EAAE,QAAQ;IAChB,aAAa,EAAE,eAAe;IAC9B,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,cAAc;IAC5B,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;CACN,CAAC;AAIX,gFAAgF;AAEhF,iEAAiE;AACjE,MAAM,CAAC,MAAM,2BAA2B,GAAG,mBAAmB,CAAC;AAC/D,uDAAuD;AACvD,MAAM,CAAC,MAAM,oCAAoC,GAAG,EAAE,CAAC;AACvD,qDAAqD;AACrD,MAAM,CAAC,MAAM,4BAA4B,GAAG,SAAS,CAAC;AACtD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,yCAAyC,GAAG,KAAK,CAAC;AAE/D,+EAA+E;AAE/E;;;2EAG2E;AAC3E,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAC5C;;yEAEyE;AACzE,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/config.d.ts

@@ -53,6 +53,9 @@ export declare function getGeminiApiKey(): string | undefined;
 export declare function getGeminiBin(): string | undefined;
 export declare function getCodexBin(): string | undefined;
 export declare function getCursorBin(): string | undefined;
+export declare function getTtsAutoMode(): 'off' | 'always' | 'inbound' | 'tagged';
+/** Test-only: reset the TTS auto-mode cache so the next call re-reads. */
+export declare function _resetTtsAutoModeCacheForTests(): void;
 export declare function getClaudeBin(): string | undefined;
 /**
  * PATH passed to spawned engine subprocesses. Falls back to the standard

package/dist/src/lib/config.js

@@ -23,6 +23,9 @@
  * `src/lib/route-flag.ts`. Cluster F (v1.0.0) will remove the legacy
  * env-read fallback and hard-fail when ConfigService is missing.
  */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
 import { RATE_LIMIT_MAX_REQUESTS } from '../constants.js';
 import { getConfigService } from './config-service.js';
 // ── Sysprompt strip (PRP_v3 §10) ─────────────────────────────────────────
@@ -202,6 +205,49 @@ export function getCursorBin() {
     const v = process.env.CURSOR_BIN;
     return v === undefined || v === '' ? undefined : v;
 }
+// ── TTS auto-mode (v0.10.2) ─────────────────────────────────────────────────
+// Reads `messages.tts.auto` from `~/.openclaw/openclaw.json` once and caches
+// the result. Used by openai-compat to gate the auto-prepended TTS-syntax
+// rule on `appendSystemPrompt`. Valid values match OpenClaw's TTS_AUTO_MODES
+// enum: 'off' | 'always' | 'inbound' | 'tagged'. Unknown values / missing
+// file → 'off' (safe default — rule is gated off).
+//
+// Why a custom file reader instead of ConfigService: cc-openclaw is loaded
+// into OpenClaw's gateway process but exposes its own
+// `~/.openclaw/openclaw.json` parsing for plugin-side decisions that
+// shouldn't reach back through OpenClaw's typed runtime. Tests that need
+// to override should set OPENCLAW_TTS_AUTO_MODE env var.
+let _ttsAutoModeCache = null;
+let _ttsAutoModeCacheChecked = false;
+export function getTtsAutoMode() {
+    // Test-time override takes precedence
+    const envOverride = process.env.OPENCLAW_TTS_AUTO_MODE?.trim().toLowerCase();
+    if (envOverride === 'off' || envOverride === 'always' || envOverride === 'inbound' || envOverride === 'tagged') {
+        return envOverride;
+    }
+    if (!_ttsAutoModeCacheChecked) {
+        _ttsAutoModeCacheChecked = true;
+        try {
+            const configPath = process.env.OPENCLAW_CONFIG_PATH || join(homedir(), '.openclaw', 'openclaw.json');
+            const raw = readFileSync(configPath, 'utf8');
+            const parsed = JSON.parse(raw);
+            _ttsAutoModeCache = parsed.messages?.tts?.auto ?? null;
+        }
+        catch {
+            // File missing / unreadable / invalid JSON — fall through to 'off'
+            _ttsAutoModeCache = null;
+        }
+    }
+    const value = (_ttsAutoModeCache ?? 'off').toLowerCase();
+    if (value === 'always' || value === 'inbound' || value === 'tagged')
+        return value;
+    return 'off';
+}
+/** Test-only: reset the TTS auto-mode cache so the next call re-reads. */
+export function _resetTtsAutoModeCacheForTests() {
+    _ttsAutoModeCache = null;
+    _ttsAutoModeCacheChecked = false;
+}
 export function getClaudeBin() {
     const cfg = getConfigService();
     if (cfg)