@luckydraw/cumulus 1.0.27 → 1.0.28

package/dist/gateway/stall-detection.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Stall detection (task 164).
+ *
+ * A thread that ends a turn on a promised-but-untaken next action ("Let me
+ * look at how X renders.") with nothing after it is not empty (task 150/156
+ * doesn't catch it) and may never have armed a `schedule_trigger` (task 156
+ * only helps if the model remembers to). This module supplies the two
+ * detection signals `server.ts` uses on the busy→idle edge:
+ *
+ *   1. `hasUncheckedTodo` — free, structural: the thread's own `<todo>` block
+ *      still has an open item.
+ *   2. `classifyStall` — a cheap-model fallback for the harder case: no todo
+ *      block at all, prose just trails off. Deliberately conservative — the
+ *      caller must default to "no nudge" on anything it isn't sure about,
+ *      since prodding a thread that finished and is waiting on the user is
+ *      the worse failure (Karl, 2026-08-30).
+ */
+export declare function hasUncheckedTodo(text: string): boolean;
+/** Last `n` sentences of a message — the classifier only needs the tail, not the whole thing. */
+export declare function lastSentences(text: string, n?: number): string;
+/** The single dangling sentence to quote back in the nudge message. */
+export declare function extractDanglingSentence(text: string): string;
+export interface ClassifyStallOptions {
+    timeoutMs?: number;
+    /** Claude CLI sub-model id (e.g. "haiku"). Defaults to "haiku". */
+    model?: string;
+}
+/**
+ * Cheap-model classification for the "trails off with no `<todo>` at all" case.
+ *
+ * A one-off `claude --print --model <model>` call, not a full agentic turn. Fails
+ * closed: any error, non-zero exit, timeout, or non-"YES" response resolves to
+ * `false` (no nudge).
+ *
+ * The prompt goes in as PLAIN TEXT on stdin — not `--input-format stream-json`.
+ * That flag requires a matching `--output-format stream-json --verbose`, and without
+ * it the CLI errors before reaching the model (`Error: --input-format=stream-json
+ * requires output-format=stream-json.`), so the classifier would fail closed on every
+ * call and the fallback signal would be dead. Plain text on stdin is the form that
+ * actually works and sidesteps ARG_MAX for long prompts.
+ */
+export declare function classifyStall(text: string, opts?: ClassifyStallOptions): Promise<boolean>;
+/** Is the last message from the thread's own `<todo>`/classifier signals a stall? */
+export declare function isStalled(text: string, opts?: ClassifyStallOptions): Promise<boolean>;
+/**
+ * Resolve the configured stall-classifier model id to a Claude CLI sub-model.
+ *
+ * The classifier is a one-off `claude --print --model <id>` call, so it can only run
+ * on a Claude CLI sub-model — an id from `models[]` (a direct-provider model) has no
+ * meaning here. An id that names nothing in `claudeModels[]` (absent, blank, or stale
+ * after a catalog edit) falls back to "haiku" rather than failing closed, since the
+ * classifier is a best-effort fallback signal, not a correctness gate.
+ */
+export declare function resolveStallClassifierModel(stallClassifierModel: string | undefined, claudeModels?: Array<{
+    id: string;
+}>): string;
+//# sourceMappingURL=stall-detection.d.ts.map

package/dist/gateway/stall-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stall-detection.d.ts","sourceRoot":"","sources":["../../src/gateway/stall-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUtD;AAkCD,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,MAAM,CAEzD;AAED,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5D;AAaD,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,OAAO,CAAC,CA6DlB;AAED,qFAAqF;AACrF,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC,CAG/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,oBAAoB,EAAE,MAAM,GAAG,SAAS,EACxC,YAAY,CAAC,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GACnC,MAAM,CAIR"}

package/dist/gateway/stall-detection.js

@@ -0,0 +1,174 @@
+/**
+ * Stall detection (task 164).
+ *
+ * A thread that ends a turn on a promised-but-untaken next action ("Let me
+ * look at how X renders.") with nothing after it is not empty (task 150/156
+ * doesn't catch it) and may never have armed a `schedule_trigger` (task 156
+ * only helps if the model remembers to). This module supplies the two
+ * detection signals `server.ts` uses on the busy→idle edge:
+ *
+ *   1. `hasUncheckedTodo` — free, structural: the thread's own `<todo>` block
+ *      still has an open item.
+ *   2. `classifyStall` — a cheap-model fallback for the harder case: no todo
+ *      block at all, prose just trails off. Deliberately conservative — the
+ *      caller must default to "no nudge" on anything it isn't sure about,
+ *      since prodding a thread that finished and is waiting on the user is
+ *      the worse failure (Karl, 2026-08-30).
+ */
+import { spawn } from 'child_process';
+/** Last (authoritative, full-replacement) `<todo>` block still has an open `[ ]` item. */
+const TODO_BLOCK_RE = /<todo>([\s\S]*?)<\/todo>/g;
+const UNCHECKED_ITEM_RE = /\[\s\]/;
+export function hasUncheckedTodo(text) {
+    if (!text)
+        return false;
+    let lastBlock;
+    let match;
+    TODO_BLOCK_RE.lastIndex = 0;
+    while ((match = TODO_BLOCK_RE.exec(text))) {
+        lastBlock = match[1];
+    }
+    if (!lastBlock)
+        return false;
+    return UNCHECKED_ITEM_RE.test(lastBlock);
+}
+/**
+ * Rough sentence split — good enough to isolate the tail of a message.
+ *
+ * `!` and `?` always end a sentence; `.` only does when it's the end of the
+ * text or followed by whitespace and an uppercase/quote/paren — otherwise a
+ * mid-word period (`inspect.ts`, `e.g.`) would fracture the tail into
+ * fragments and hand the classifier "ts renders claim rows." instead of the
+ * whole dangling sentence.
+ */
+function splitSentences(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return [];
+    const sentences = [];
+    let start = 0;
+    for (let i = 0; i < trimmed.length; i++) {
+        const ch = trimmed[i];
+        if (ch === '!' || ch === '?') {
+            sentences.push(trimmed.slice(start, i + 1).trim());
+            start = i + 1;
+        }
+        else if (ch === '.') {
+            const rest = trimmed.slice(i + 1);
+            const boundary = rest.match(/^\s+(\S)/);
+            if (!rest || (boundary && /[A-Z"'(]/.test(boundary[1]))) {
+                sentences.push(trimmed.slice(start, i + 1).trim());
+                start = i + 1;
+            }
+        }
+    }
+    if (start < trimmed.length)
+        sentences.push(trimmed.slice(start).trim());
+    return sentences.filter(Boolean);
+}
+/** Last `n` sentences of a message — the classifier only needs the tail, not the whole thing. */
+export function lastSentences(text, n = 6) {
+    return splitSentences(text).slice(-n).join(' ').trim();
+}
+/** The single dangling sentence to quote back in the nudge message. */
+export function extractDanglingSentence(text) {
+    const sentences = splitSentences(text);
+    return sentences.length > 0 ? sentences[sentences.length - 1] : text.trim();
+}
+const STALL_CLASSIFIER_PROMPT = (snippet) => `You are checking whether an AI assistant's message ends mid-task — having promised an ` +
+    `immediate next action it never took — versus ending at a normal stopping point.\n\n` +
+    `Message (last portion):\n"""\n${snippet}\n"""\n\n` +
+    `Question: Does this message end with an explicit, concrete statement of an immediate next ` +
+    `action (e.g. "Let me check X", "I'll look at Y now", "Next I'll do Z") that the message does ` +
+    `NOT go on to actually take? Answer YES only if this is unambiguous and obvious. If the ` +
+    `message reads as a completed thought, a finished answer, a question back to the user, an ` +
+    `offer awaiting the user's decision, or anything you are not certain about, answer NO.\n\n` +
+    `Respond with exactly one word: YES or NO.`;
+/**
+ * Cheap-model classification for the "trails off with no `<todo>` at all" case.
+ *
+ * A one-off `claude --print --model <model>` call, not a full agentic turn. Fails
+ * closed: any error, non-zero exit, timeout, or non-"YES" response resolves to
+ * `false` (no nudge).
+ *
+ * The prompt goes in as PLAIN TEXT on stdin — not `--input-format stream-json`.
+ * That flag requires a matching `--output-format stream-json --verbose`, and without
+ * it the CLI errors before reaching the model (`Error: --input-format=stream-json
+ * requires output-format=stream-json.`), so the classifier would fail closed on every
+ * call and the fallback signal would be dead. Plain text on stdin is the form that
+ * actually works and sidesteps ARG_MAX for long prompts.
+ */
+export async function classifyStall(text, opts = {}) {
+    const snippet = lastSentences(text, 6);
+    if (!snippet)
+        return false;
+    const timeoutMs = opts.timeoutMs ?? 10000;
+    const model = opts.model?.trim() || 'haiku';
+    return new Promise(resolve => {
+        const args = ['--print', '--model', model];
+        const cleanEnv = Object.fromEntries(Object.entries(process.env).filter(([key]) => !key.startsWith('CLAUDE') && key !== 'CLAUDECODE'));
+        let claude;
+        try {
+            claude = spawn('claude', args, {
+                stdio: ['pipe', 'pipe', 'pipe'],
+                env: cleanEnv,
+                shell: process.platform === 'win32',
+                windowsHide: true,
+            });
+        }
+        catch {
+            resolve(false);
+            return;
+        }
+        // Plain text on stdin (see doc comment) — no JSON envelope, no --input-format.
+        claude.stdin?.write(STALL_CLASSIFIER_PROMPT(snippet));
+        claude.stdin?.end();
+        let stdout = '';
+        let settled = false;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(result);
+        };
+        const timer = setTimeout(() => {
+            claude.kill();
+            finish(false);
+        }, timeoutMs);
+        timer.unref?.();
+        claude.stdout?.on('data', (data) => {
+            stdout += data.toString();
+        });
+        claude.on('close', code => {
+            if (code !== 0) {
+                finish(false);
+                return;
+            }
+            finish(/^YES\b/i.test(stdout.trim()));
+        });
+        claude.on('error', () => finish(false));
+    });
+}
+/** Is the last message from the thread's own `<todo>`/classifier signals a stall? */
+export async function isStalled(text, opts = {}) {
+    if (hasUncheckedTodo(text))
+        return true;
+    return classifyStall(text, opts);
+}
+/**
+ * Resolve the configured stall-classifier model id to a Claude CLI sub-model.
+ *
+ * The classifier is a one-off `claude --print --model <id>` call, so it can only run
+ * on a Claude CLI sub-model — an id from `models[]` (a direct-provider model) has no
+ * meaning here. An id that names nothing in `claudeModels[]` (absent, blank, or stale
+ * after a catalog edit) falls back to "haiku" rather than failing closed, since the
+ * classifier is a best-effort fallback signal, not a correctness gate.
+ */
+export function resolveStallClassifierModel(stallClassifierModel, claudeModels) {
+    const id = stallClassifierModel?.trim();
+    if (id && claudeModels?.some(entry => entry.id === id))
+        return id;
+    return 'haiku';
+}
+//# sourceMappingURL=stall-detection.js.map

package/dist/gateway/stall-detection.js.map

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

package/dist/gateway/static/widget.js

@@ -139,6 +139,11 @@
       // and re-adding it does not quietly clear the voice setting. The gateway's
       // resolveVoiceModel treats an unmatched id as "no override" anyway.
       voiceModel: typeof config.voiceModel === 'string' ? config.voiceModel : '',
+      // Task 164. Same verbatim rule as voiceModel: an id naming nothing in claudeModels[]
+      // is preserved on round-trip; the gateway's resolveStallClassifierModel falls back to
+      // "haiku" for an unmatched id anyway.
+      stallClassifierModel:
+        typeof config.stallClassifierModel === 'string' ? config.stallClassifierModel : '',
     };
   }
 
@@ -200,6 +205,9 @@
       // Task 152: '' means "same as thread" and must reach the server as an explicit
       // null (clear), not as absent — absent would leave the stored value untouched.
       voiceModel: state.voiceModel ? state.voiceModel : null,
+      // Task 164: '' means "haiku" and must reach the server as an explicit null (clear),
+      // not as absent — absent would leave a previously-set classifier model untouched.
+      stallClassifierModel: state.stallClassifierModel ? state.stallClassifierModel : null,
       // Registry travels without credentials — addCredentialPatch fills those
       // in, so an untouched key round-trips as absent and the server preserves it.
       customProviders: (Array.isArray(state.customProviders) ? state.customProviders : []).map(
@@ -6461,6 +6469,24 @@
       voiceCard.appendChild(voiceSelect);
       body.appendChild(voiceCard);
 
+      // Task 164: the stall-detection classifier is a one-off `claude --print --model <id>`
+      // call, so it can only run on a Claude CLI sub-model — this dropdown lists ONLY the
+      // Anthropic sub-models (not the full catalog), with "Haiku (default)" clearing the
+      // setting. Same card shape as the voice model above.
+      var stallCard = document.createElement('div');
+      stallCard.className = 'cumulus-settings-default-card';
+      var stallCardLabel = document.createElement('label');
+      stallCardLabel.textContent = 'Stall-detection classifier uses';
+      var stallSelect = document.createElement('select');
+      stallSelect.className = 'cumulus-settings-select';
+      stallSelect.setAttribute('data-testid', 'webchat-gw-stall-classifier-select');
+      stallSelect.addEventListener('change', function () {
+        gwState.stallClassifierModel = stallSelect.value;
+      });
+      stallCard.appendChild(stallCardLabel);
+      stallCard.appendChild(stallSelect);
+      body.appendChild(stallCard);
+
       var modelsLabel = document.createElement('div');
       modelsLabel.className = 'cumulus-settings-section-label';
       modelsLabel.textContent = 'Model catalog';
@@ -7084,6 +7110,29 @@
         if (voiceSelect.value !== (gwState.voiceModel || '')) voiceSelect.value = '';
       }
 
+      // Task 164: the classifier only runs on Claude CLI sub-models, so this lists ONLY the
+      // Anthropic sub-models (not the full catalog) plus a "Haiku (default)" clear option. A
+      // stored id naming nothing in claudeModels[] falls back to "Haiku (default)" in the UI —
+      // which is what the gateway does with it too (resolveStallClassifierModel → "haiku").
+      function renderStallSelect() {
+        stallSelect.innerHTML = '';
+        var haiku = document.createElement('option');
+        haiku.value = '';
+        haiku.textContent = 'Haiku (default)';
+        stallSelect.appendChild(haiku);
+        var anthropic = gwState.catalog.filter(function (model) {
+          return model.provider === 'anthropic';
+        });
+        anthropic.forEach(function (model) {
+          var opt = document.createElement('option');
+          opt.value = model.id;
+          opt.textContent = model.label || model.id;
+          stallSelect.appendChild(opt);
+        });
+        stallSelect.value = gwState.stallClassifierModel || '';
+        if (stallSelect.value !== (gwState.stallClassifierModel || '')) stallSelect.value = '';
+      }
+
       // Rebuild the provider list from state before anything reads it, so a
       // provider added or removed this session reaches the cards, the default
       // dropdown and the add-model select in the same pass (task 147).
@@ -7107,6 +7156,7 @@
         renderAddProviderOptions();
         renderDefaultSelect();
         renderVoiceSelect();
+        renderStallSelect();
         renderGwModels();
       }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luckydraw/cumulus",
-  "version": "1.0.27",
+  "version": "1.0.28",
   "description": "RLM-based CLI chat wrapper for Claude with external history context management",
   "type": "module",
   "main": "dist/index.js",