@luckydraw/cumulus 1.0.27 → 1.0.29

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

@@ -0,0 +1,96 @@
+/**
+ * Stall detection (task 164; model-agnostic classifier per task 165).
+ *
+ * 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).
+ *
+ * The classifier runs on WHATEVER model the operator configured
+ * (`stallClassifierModel`), not just a Claude sub-model (task 165). It routes
+ * through `resolveModelProvider` — the same single source of truth every other
+ * model in the gateway uses — and branches: a Claude CLI sub-model runs as a
+ * one-off `claude --print --model <id>` call; any other catalog model runs as a
+ * one-shot HTTP `chat()` through the provider the resolver picks. The prompt
+ * and the fail-closed contract are identical on both branches.
+ */
+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;
+/**
+ * Everything the classifier needs to decide WHICH provider runs the configured
+ * model and HOW to reach it. Mirrors the fields `server.ts` already threads into
+ * every turn's `sendMessage`, so the classifier resolves its model exactly the way
+ * a turn does — no second notion of "how do I run a non-Claude model."
+ */
+export interface StallClassifierContext {
+    /** Direct-provider catalog (HF / OpenAI / custom entries). */
+    models?: Array<{
+        id: string;
+        provider?: string;
+        contextWindow?: number;
+    }>;
+    /** Claude CLI sub-model catalog (Opus / Sonnet / Haiku variants). */
+    claudeModels?: Array<{
+        id: string;
+    }>;
+    hfApiKey?: string;
+    openaiApiKey?: string;
+    customProviders?: Array<{
+        id: string;
+        baseUrl: string;
+        apiKey?: string;
+    }>;
+}
+/**
+ * Resolve the configured stall-classifier model id against BOTH catalogs.
+ *
+ * An id naming a `claudeModels[]` entry runs as a Claude CLI sub-model; an id
+ * naming a `models[]` entry runs on that entry's direct provider (task 165). An
+ * id that names nothing in either (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;
+}>, models?: Array<{
+    id: string;
+}>): string;
+export interface ClassifyStallOptions {
+    timeoutMs?: number;
+    /**
+     * The configured model id. When no `context` is supplied this is used directly
+     * as a Claude CLI sub-model (the task-164 behavior, preserved for callers and
+     * tests that don't care about provider routing).
+     */
+    model?: string;
+    /**
+     * Full provider-resolution context. When present, the configured `model` is
+     * routed through `resolveModelProvider` and run on whatever provider that
+     * names — a Claude CLI sub-model or a direct-provider HTTP model (task 165).
+     */
+    context?: StallClassifierContext;
+}
+/**
+ * Cheap-model classification for the "trails off with no `<todo>` at all" case.
+ *
+ * Routes the configured model through `resolveModelProvider` and runs it on
+ * whatever provider that names: a Claude CLI sub-model as a one-off
+ * `claude --print --model <id>` call, any other catalog model as a one-shot
+ * HTTP `chat()` (task 165). Fails closed on every branch.
+ */
+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>;
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAYH,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;AAeD;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,qEAAqE;IACrE,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,oBAAoB,EAAE,MAAM,GAAG,SAAS,EACxC,YAAY,CAAC,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,EACpC,MAAM,CAAC,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7B,MAAM,CAMR;AAID,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC;AA2HD;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,OAAO,CAAC,CAqClB;AAED,qFAAqF;AACrF,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,OAAO,CAAC,CAG/F"}

package/dist/gateway/stall-detection.js

@@ -0,0 +1,264 @@
+/**
+ * Stall detection (task 164; model-agnostic classifier per task 165).
+ *
+ * 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).
+ *
+ * The classifier runs on WHATEVER model the operator configured
+ * (`stallClassifierModel`), not just a Claude sub-model (task 165). It routes
+ * through `resolveModelProvider` — the same single source of truth every other
+ * model in the gateway uses — and branches: a Claude CLI sub-model runs as a
+ * one-off `claude --print --model <id>` call; any other catalog model runs as a
+ * one-shot HTTP `chat()` through the provider the resolver picks. The prompt
+ * and the fail-closed contract are identical on both branches.
+ */
+import { spawn } from 'child_process';
+import { resolveModelProvider } from '../lib/gateway.js';
+import { HuggingFaceProvider } from '../lib/huggingface-provider.js';
+import { OpenAIResponsesProvider } from '../lib/openai-responses-provider.js';
+/** 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.`;
+/**
+ * Resolve the configured stall-classifier model id against BOTH catalogs.
+ *
+ * An id naming a `claudeModels[]` entry runs as a Claude CLI sub-model; an id
+ * naming a `models[]` entry runs on that entry's direct provider (task 165). An
+ * id that names nothing in either (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, models) {
+    const id = stallClassifierModel?.trim();
+    if (!id)
+        return 'haiku';
+    if (claudeModels?.some(entry => entry.id === id))
+        return id;
+    if (models?.some(entry => entry.id === id))
+        return id;
+    return 'haiku';
+}
+/**
+ * The Claude CLI branch: 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.
+ */
+async function classifyViaClaudeCli(text, model, timeoutMs) {
+    const snippet = lastSentences(text, 6);
+    if (!snippet)
+        return false;
+    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));
+    });
+}
+/**
+ * The direct-provider branch (task 165): a one-shot HTTP `chat()` through the
+ * provider `resolveModelProvider` picked for the configured model. No tools, no
+ * system prompt beyond the classifier prompt, small `maxTokens` (the answer is
+ * one word). Fails closed exactly like the CLI branch: any throw, timeout, or
+ * non-"YES" response resolves to `false`.
+ */
+async function classifyViaHttp(text, modelId, resolved, timeoutMs) {
+    const snippet = lastSentences(text, 6);
+    if (!snippet)
+        return false;
+    const provider = resolved.wireProtocol === 'openai-responses'
+        ? new OpenAIResponsesProvider(resolved.apiKey, resolved.baseUrl)
+        : new HuggingFaceProvider(resolved.apiKey, modelId, resolved.baseUrl);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    timer.unref?.();
+    try {
+        const response = await provider.chat({
+            model: modelId,
+            system: [],
+            messages: [{ role: 'user', content: STALL_CLASSIFIER_PROMPT(snippet) }],
+            tools: [],
+            maxTokens: 16,
+            signal: controller.signal,
+        });
+        const answer = response.content.map(b => (b.type === 'text' ? b.text : '')).join('');
+        return /^YES\b/i.test(answer.trim());
+    }
+    catch {
+        // Any provider error, abort, or malformed response fails closed to "no nudge".
+        return false;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Cheap-model classification for the "trails off with no `<todo>` at all" case.
+ *
+ * Routes the configured model through `resolveModelProvider` and runs it on
+ * whatever provider that names: a Claude CLI sub-model as a one-off
+ * `claude --print --model <id>` call, any other catalog model as a one-shot
+ * HTTP `chat()` (task 165). Fails closed on every branch.
+ */
+export async function classifyStall(text, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? 10000;
+    const ctx = opts.context;
+    // No context: preserve the task-164 behavior — the configured id (or "haiku")
+    // runs directly as a Claude CLI sub-model. This is what unit tests and any
+    // caller without a catalog rely on.
+    if (!ctx) {
+        const model = opts.model?.trim() || 'haiku';
+        return classifyViaClaudeCli(text, model, timeoutMs);
+    }
+    const modelId = resolveStallClassifierModel(opts.model, ctx.claudeModels, ctx.models);
+    // A Claude CLI sub-model runs on the CLI — detected by membership in claudeModels[],
+    // plus the "haiku" fallback (a valid CLI alias). These are NEVER passed to
+    // resolveModelProvider: that resolver's contract is "claude" or a direct-provider id,
+    // and feeding it a Claude sub-model id would fall through to the HF branch and
+    // misroute a Claude model over HTTP when an HF key is present.
+    const isClaudeSub = modelId === 'haiku' || ctx.claudeModels?.some(entry => entry.id === modelId);
+    if (isClaudeSub) {
+        return classifyViaClaudeCli(text, modelId, timeoutMs);
+    }
+    // A direct-provider model: route through the same single source of truth every turn
+    // uses (task 118/147). No second notion of "how do I run a non-Claude model."
+    const resolved = resolveModelProvider(modelId, ctx.models, {
+        hfApiKey: ctx.hfApiKey,
+        openaiApiKey: ctx.openaiApiKey,
+        customProviders: ctx.customProviders,
+    });
+    if (!resolved.isAgentic) {
+        // Gate closed (no credential for the resolved provider) — degrade to the default
+        // Claude sub-model rather than spawning a doomed HTTP loop.
+        return classifyViaClaudeCli(text, 'haiku', timeoutMs);
+    }
+    return classifyViaHttp(text, modelId, resolved, timeoutMs);
+}
+/** 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);
+}
+//# 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,OAAO,EAAE,oBAAoB,EAA8B,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAE9E,0FAA0F;AAC1F,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAClD,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAEnC,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,SAA6B,CAAC;IAClC,IAAI,KAA6B,CAAC;IAClC,aAAa,CAAC,SAAS,GAAG,CAAC,CAAC;IAC5B,OAAO,CAAC,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC1C,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,OAAO,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YAC7B,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACnD,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;aAAM,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YACxC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,EAAE,CAAC;gBACzD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACnD,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,KAAK,GAAG,OAAO,CAAC,MAAM;QAAE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACxE,OAAO,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,CAAC,GAAG,CAAC;IAC/C,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACzD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;AAC/E,CAAC;AAED,MAAM,uBAAuB,GAAG,CAAC,OAAe,EAAU,EAAE,CAC1D,wFAAwF;IACxF,qFAAqF;IACrF,iCAAiC,OAAO,WAAW;IACnD,4FAA4F;IAC5F,+FAA+F;IAC/F,yFAAyF;IACzF,2FAA2F;IAC3F,2FAA2F;IAC3F,2CAA2C,CAAC;AAoB9C;;;;;;;;GAQG;AACH,MAAM,UAAU,2BAA2B,CACzC,oBAAwC,EACxC,YAAoC,EACpC,MAA8B;IAE9B,MAAM,EAAE,GAAG,oBAAoB,EAAE,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,EAAE;QAAE,OAAO,OAAO,CAAC;IACxB,IAAI,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5D,IAAI,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;QAAE,OAAO,EAAE,CAAC;IACtD,OAAO,OAAO,CAAC;AACjB,CAAC;AAoBD;;;;;;;;;;;GAWG;AACH,KAAK,UAAU,oBAAoB,CACjC,IAAY,EACZ,KAAa,EACb,SAAiB;IAEjB,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3B,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE;QAC3B,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAE3C,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CACjC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAChC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,GAAG,KAAK,YAAY,CAC7D,CACF,CAAC;QAEF,IAAI,MAAgC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE;gBAC7B,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;gBAC/B,GAAG,EAAE,QAAQ;gBACb,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;gBACnC,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,KAAK,CAAC,CAAC;YACf,OAAO;QACT,CAAC;QAED,+EAA+E;QAC/E,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;QAEpB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,MAAe,EAAQ,EAAE;YACvC,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,EAAE,SAAS,CAAC,CAAC;QACd,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAEhB,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACzC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE;YACxB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAC;gBACd,OAAO;YACT,CAAC;YACD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,eAAe,CAC5B,IAAY,EACZ,OAAe,EACf,QAA+B,EAC/B,SAAiB;IAEjB,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3B,MAAM,QAAQ,GACZ,QAAQ,CAAC,YAAY,KAAK,kBAAkB;QAC1C,CAAC,CAAC,IAAI,uBAAuB,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC;QAChE,CAAC,CAAC,IAAI,mBAAmB,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAE1E,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAC9D,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC;YACnC,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,CAAC,OAAO,CAAC,EAAE,CAAC;YACvE,KAAK,EAAE,EAAE;YACT,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrF,OAAO,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,+EAA+E;QAC/E,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,OAA6B,EAAE;IAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC;IAEzB,8EAA8E;IAC9E,2EAA2E;IAC3E,oCAAoC;IACpC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC;QAC5C,OAAO,oBAAoB,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,OAAO,GAAG,2BAA2B,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEtF,qFAAqF;IACrF,2EAA2E;IAC3E,sFAAsF;IACtF,+EAA+E;IAC/E,+DAA+D;IAC/D,MAAM,WAAW,GAAG,OAAO,KAAK,OAAO,IAAI,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IACjG,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACxD,CAAC;IAED,oFAAoF;IACpF,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE;QACzD,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,eAAe,EAAE,GAAG,CAAC,eAAe;KACrC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACxB,iFAAiF;QACjF,4DAA4D;QAC5D,OAAO,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC7D,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,OAA6B,EAAE;IAC3E,IAAI,gBAAgB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC"}

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,22 @@
         if (voiceSelect.value !== (gwState.voiceModel || '')) voiceSelect.value = '';
       }
 
+      // Task 165: the classifier runs on ANY catalog model (a Claude CLI sub-model or a
+      // direct-provider model), so this lists the FULL catalog grouped by provider — same
+      // shape as the voice selector — plus a leading "Haiku (default)" clear option. A
+      // stored id naming nothing in either catalog 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);
+        fillModelOptions(stallSelect);
+        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 +7149,7 @@
         renderAddProviderOptions();
         renderDefaultSelect();
         renderVoiceSelect();
+        renderStallSelect();
         renderGwModels();
       }
 

package/package.json

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