@jsonstudio/llms 0.6.2125 → 0.6.2172

package/dist/servertool/handlers/stop-message-auto/iflow-followup.js

@@ -0,0 +1,503 @@
+import * as childProcess from 'node:child_process';
+import { readRuntimeMetadata } from '../../../conversion/shared/runtime-metadata.js';
+import { extractTextFromMessageContent } from './blocked-report.js';
+const STOP_MESSAGE_AUTOMESSAGE_IFLOW_TIMEOUT_MS = 300_000;
+const STOP_MESSAGE_AUTOMESSAGE_IFLOW_TIMEOUT_MAX_MS = 300_000;
+const STOP_MESSAGE_AUTOMESSAGE_IFLOW_TIMEOUT_TEST_CAP_MS = 800;
+const STOP_MESSAGE_AUTOMESSAGE_PROMPT_MAX_CHARS = 18_000;
+const STOP_MESSAGE_AUTOMESSAGE_OUTPUT_MAX_CHARS = 1_600;
+const STOP_MESSAGE_AUTOMESSAGE_LOG_SUMMARY_MAX_CHARS = 200;
+const ANSI_ESCAPE_PATTERN = /\x1B\[[0-?]*[ -/]*[@-~]/g;
+export function renderStopMessageAutoFollowupViaIflow(args) {
+    if (!isStopMessageAutoMessageIflowEnabled()) {
+        return null;
+    }
+    const command = resolveStopMessageAutoMessageIflowCommand();
+    if (!command) {
+        return null;
+    }
+    const prompt = buildStopMessageAutoMessageIflowPrompt(args);
+    if (!prompt) {
+        return null;
+    }
+    const timeoutMs = resolveStopMessageAutoMessageIflowTimeoutMs();
+    const maxOutputChars = resolveStopMessageAutoMessageIflowOutputMaxChars();
+    const requestSummary = summarizeStopMessageAutoMessageLog([
+        `base=${args.baseStopMessageText || ''}`,
+        `candidate=${args.candidateFollowupText || ''}`,
+        `assistant=${args.responseSnapshot.assistantText || ''}`,
+        `reasoning=${args.responseSnapshot.reasoningText || ''}`
+    ].join(' | '), STOP_MESSAGE_AUTOMESSAGE_LOG_SUMMARY_MAX_CHARS);
+    logStopMessageAutoMessageIflow({
+        requestId: args.requestId,
+        stage: 'request',
+        requestSummary
+    });
+    try {
+        const result = childProcess.spawnSync(command, ['-p', prompt], {
+            encoding: 'utf8',
+            timeout: timeoutMs,
+            maxBuffer: 1024 * 1024
+        });
+        if (result.error || result.status !== 0) {
+            const responseSummary = summarizeStopMessageAutoMessageLog(sanitizeStopMessageAutoMessageOutput(result.stderr || result.stdout, STOP_MESSAGE_AUTOMESSAGE_OUTPUT_MAX_CHARS), STOP_MESSAGE_AUTOMESSAGE_LOG_SUMMARY_MAX_CHARS);
+            logStopMessageAutoMessageIflow({
+                requestId: args.requestId,
+                stage: 'response',
+                status: result.status ?? -1,
+                requestSummary,
+                responseSummary,
+                error: result.error ? String(result.error) : 'non_zero_exit'
+            });
+            return null;
+        }
+        const stdout = sanitizeStopMessageAutoMessageOutput(result.stdout, maxOutputChars);
+        if (stdout) {
+            logStopMessageAutoMessageIflow({
+                requestId: args.requestId,
+                stage: 'response',
+                status: result.status ?? 0,
+                requestSummary,
+                responseSummary: summarizeStopMessageAutoMessageLog(stdout, STOP_MESSAGE_AUTOMESSAGE_LOG_SUMMARY_MAX_CHARS)
+            });
+            return stdout;
+        }
+        const stderr = sanitizeStopMessageAutoMessageOutput(result.stderr, maxOutputChars);
+        logStopMessageAutoMessageIflow({
+            requestId: args.requestId,
+            stage: 'response',
+            status: result.status ?? 0,
+            requestSummary,
+            responseSummary: summarizeStopMessageAutoMessageLog(stderr, STOP_MESSAGE_AUTOMESSAGE_LOG_SUMMARY_MAX_CHARS)
+        });
+        return stderr || null;
+    }
+    catch (error) {
+        logStopMessageAutoMessageIflow({
+            requestId: args.requestId,
+            stage: 'response',
+            status: -1,
+            requestSummary,
+            error: error instanceof Error ? error.message : String(error ?? 'unknown_error')
+        });
+        return null;
+    }
+}
+export function extractStopMessageAutoResponseSnapshot(base, adapterContext) {
+    const providerProtocol = extractStopMessageProviderProtocol(adapterContext);
+    if (!base || typeof base !== 'object' || Array.isArray(base)) {
+        return { ...(providerProtocol ? { providerProtocol } : {}) };
+    }
+    const payload = base;
+    const choices = Array.isArray(payload.choices) ? payload.choices : [];
+    if (choices.length > 0) {
+        const targetChoice = choices.find((choice) => toNonEmptyText(asRecord(choice)?.finish_reason).toLowerCase() === 'stop') || choices[0];
+        const choiceRecord = asRecord(targetChoice);
+        const message = asRecord(choiceRecord?.message);
+        const finishReason = toNonEmptyText(choiceRecord?.finish_reason).toLowerCase() || undefined;
+        const assistantText = message ? extractStopMessageAssistantText(message) : '';
+        const reasoningText = message ? extractStopMessageReasoningText(message) : '';
+        return {
+            ...(providerProtocol ? { providerProtocol } : {}),
+            ...(finishReason ? { finishReason } : {}),
+            ...(assistantText ? { assistantText } : {}),
+            ...(reasoningText ? { reasoningText } : {}),
+            responseExcerpt: buildStopMessageResponseExcerpt(choiceRecord || payload)
+        };
+    }
+    const anthropicContent = extractTextFromMessageContent(payload.content);
+    const anthropicReasoning = extractStopMessageReasoningFromContent(payload.content);
+    const anthropicFinishReason = toNonEmptyText(payload.stop_reason).toLowerCase() || undefined;
+    const responsesText = extractResponsesOutputText(payload);
+    const responsesReasoning = extractResponsesReasoningText(payload);
+    const responseFinishReason = anthropicFinishReason ||
+        toNonEmptyText(payload.finish_reason).toLowerCase() ||
+        toNonEmptyText(payload.status).toLowerCase() ||
+        undefined;
+    const assistantText = responsesText || anthropicContent;
+    const reasoningText = responsesReasoning || anthropicReasoning;
+    return {
+        ...(providerProtocol ? { providerProtocol } : {}),
+        ...(responseFinishReason ? { finishReason: responseFinishReason } : {}),
+        ...(assistantText ? { assistantText } : {}),
+        ...(reasoningText ? { reasoningText } : {}),
+        responseExcerpt: buildStopMessageResponseExcerpt(payload)
+    };
+}
+export function extractResponsesOutputText(base) {
+    const raw = base.output_text;
+    if (typeof raw === 'string') {
+        return raw.trim();
+    }
+    if (Array.isArray(raw)) {
+        const texts = raw
+            .map((entry) => (typeof entry === 'string' ? entry : ''))
+            .filter((entry) => entry.trim().length > 0);
+        if (texts.length > 0) {
+            return texts.join('\n').trim();
+        }
+    }
+    const output = Array.isArray(base.output) ? (base.output) : [];
+    const chunks = [];
+    for (const item of output) {
+        if (!item || typeof item !== 'object' || Array.isArray(item))
+            continue;
+        if (typeof item.type !== 'string')
+            continue;
+        const type = String(item.type).trim().toLowerCase();
+        if (type !== 'message')
+            continue;
+        const content = Array.isArray(item.content) ? (item.content) : [];
+        for (const part of content) {
+            if (!part || typeof part !== 'object' || Array.isArray(part))
+                continue;
+            const pType = typeof part.type === 'string'
+                ? String(part.type).trim().toLowerCase()
+                : '';
+            if (pType === 'output_text') {
+                const text = typeof part.text === 'string' ? String(part.text) : '';
+                if (text.trim().length)
+                    chunks.push(text.trim());
+            }
+        }
+    }
+    return chunks.join('\n').trim();
+}
+export function hasToolLikeOutput(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return false;
+    }
+    const typeRaw = value.type;
+    const type = typeof typeRaw === 'string' ? typeRaw.trim().toLowerCase() : '';
+    if (!type) {
+        return false;
+    }
+    return (type === 'tool_call' ||
+        type === 'tool_use' ||
+        type === 'function_call' ||
+        type.includes('tool'));
+}
+function isStopMessageAutoMessageIflowEnabled() {
+    const raw = String(process.env.ROUTECODEX_STOPMESSAGE_AUTOMESSAGE_IFLOW || '')
+        .trim()
+        .toLowerCase();
+    if (!raw) {
+        return true;
+    }
+    if (raw === '0' || raw === 'false' || raw === 'no' || raw === 'off') {
+        return false;
+    }
+    return true;
+}
+function resolveStopMessageAutoMessageIflowCommand() {
+    const raw = String(process.env.ROUTECODEX_STOPMESSAGE_AUTOMESSAGE_IFLOW_BIN || '').trim();
+    return raw || 'iflow';
+}
+function resolveStopMessageAutoMessageIflowTimeoutMs() {
+    const raw = String(process.env.ROUTECODEX_STOPMESSAGE_AUTOMESSAGE_TIMEOUT_MS || '').trim();
+    const parsed = Number(raw);
+    const explicitTimeout = Number.isFinite(parsed) && parsed > 0
+        ? Math.max(200, Math.min(STOP_MESSAGE_AUTOMESSAGE_IFLOW_TIMEOUT_MAX_MS, Math.floor(parsed)))
+        : STOP_MESSAGE_AUTOMESSAGE_IFLOW_TIMEOUT_MS;
+    let resolvedTimeout = explicitTimeout;
+    const explicitCommand = String(process.env.ROUTECODEX_STOPMESSAGE_AUTOMESSAGE_IFLOW_BIN || '').trim();
+    const usingDefaultIflowCommand = !explicitCommand || explicitCommand === 'iflow';
+    if (process.env.JEST_WORKER_ID && usingDefaultIflowCommand) {
+        resolvedTimeout = Math.min(resolvedTimeout, STOP_MESSAGE_AUTOMESSAGE_IFLOW_TIMEOUT_TEST_CAP_MS);
+    }
+    const followupTimeoutRaw = String(process.env.ROUTECODEX_SERVERTOOL_FOLLOWUP_TIMEOUT_MS || '').trim();
+    const followupTimeoutParsed = Number(followupTimeoutRaw);
+    if (Number.isFinite(followupTimeoutParsed) && followupTimeoutParsed > 0) {
+        const boundedFollowupTimeout = Math.max(100, Math.min(STOP_MESSAGE_AUTOMESSAGE_IFLOW_TIMEOUT_MAX_MS, Math.floor(followupTimeoutParsed)));
+        resolvedTimeout = Math.min(resolvedTimeout, boundedFollowupTimeout);
+    }
+    return resolvedTimeout;
+}
+function resolveStopMessageAutoMessageIflowOutputMaxChars() {
+    const raw = String(process.env.ROUTECODEX_STOPMESSAGE_AUTOMESSAGE_OUTPUT_MAX_CHARS || '').trim();
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        return STOP_MESSAGE_AUTOMESSAGE_OUTPUT_MAX_CHARS;
+    }
+    return Math.max(128, Math.min(8_000, Math.floor(parsed)));
+}
+function sanitizeStopMessageAutoMessageOutput(raw, maxChars) {
+    const text = typeof raw === 'string' ? raw : '';
+    if (!text.trim()) {
+        return '';
+    }
+    const withoutAnsi = text.replace(ANSI_ESCAPE_PATTERN, '');
+    const withoutCodeFence = withoutAnsi
+        .replace(/^```[a-zA-Z0-9_-]*\s*/g, '')
+        .replace(/\s*```$/g, '');
+    const cleaned = withoutCodeFence.trim();
+    if (!cleaned) {
+        return '';
+    }
+    return cleaned.length > maxChars ? cleaned.slice(0, maxChars).trim() : cleaned;
+}
+function truncateStopMessageAutoMessagePrompt(value, maxChars) {
+    const text = typeof value === 'string' ? value.trim() : '';
+    if (!text) {
+        return '';
+    }
+    if (text.length <= maxChars) {
+        return text;
+    }
+    return `${text.slice(0, maxChars)}...`;
+}
+function buildStopMessageAutoMessageIflowPrompt(args) {
+    const lines = [
+        '你是 RouteCodex 的 stopMessage followup 文案生成器。',
+        '目标：基于本轮 finish_reason=stop 的模型原始响应，生成“下一步用户 followup 消息文本”。',
+        '输出要求（严格）：',
+        '1) 只输出一段可直接注入的用户消息文本；不要解释、不要 JSON、不要代码块。',
+        '2) 必须基于 assistantText / reasoningText / responseExcerpt 的实际内容给出具体下一步动作。',
+        '3) 必须包含至少一个可执行动作（如具体文件、命令、检查点、验证目标）。',
+        '4) 禁止输出空泛短答：如“继续”“继续执行”“好的”“收到”“ok”。',
+        '5) 语气直接，不要复述流程，不要问选择题。',
+        '',
+        `baseStopMessage: ${args.baseStopMessageText || 'n/a'}`,
+        `candidateFollowup: ${args.candidateFollowupText || 'n/a'}`,
+        `repeat: ${Math.max(0, args.usedRepeats) + 1}/${Math.max(0, args.maxRepeats)}`,
+        `requestId: ${args.requestId || 'n/a'}`,
+        `sessionId: ${args.sessionId || 'n/a'}`,
+        `providerKey: ${args.providerKey || 'n/a'}`,
+        `model: ${args.model || 'n/a'}`,
+        '',
+        '本轮模型响应（结构化摘录）：',
+        `responseProtocol: ${args.responseSnapshot.providerProtocol || 'n/a'}`,
+        `finishReason: ${args.responseSnapshot.finishReason || 'n/a'}`,
+        '',
+        'assistantText:',
+        truncateStopMessageAutoMessagePrompt(args.responseSnapshot.assistantText || 'n/a', 3_600),
+        '',
+        'reasoningText:',
+        truncateStopMessageAutoMessagePrompt(args.responseSnapshot.reasoningText || 'n/a', 3_600),
+        '',
+        'responseExcerpt:',
+        truncateStopMessageAutoMessagePrompt(args.responseSnapshot.responseExcerpt || 'n/a', 6_000)
+    ];
+    lines.push('', '现在直接输出下一步 followup 消息文本。');
+    const prompt = lines.join('\n').trim();
+    return truncateStopMessageAutoMessagePrompt(prompt, STOP_MESSAGE_AUTOMESSAGE_PROMPT_MAX_CHARS);
+}
+function summarizeStopMessageAutoMessageLog(value, maxChars) {
+    const text = typeof value === 'string' ? value : '';
+    if (!text.trim()) {
+        return '';
+    }
+    const singleLine = text
+        .replace(ANSI_ESCAPE_PATTERN, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+    if (singleLine.length <= maxChars) {
+        return singleLine;
+    }
+    return `${singleLine.slice(0, maxChars)}...`;
+}
+function isStopMessageAutoMessageIflowTraceEnabled() {
+    const raw = String(process.env.ROUTECODEX_STOPMESSAGE_IFLOW_TRACE || '').trim().toLowerCase();
+    if (!raw) {
+        return true;
+    }
+    if (raw === '0' || raw === 'false' || raw === 'no' || raw === 'off') {
+        return false;
+    }
+    return true;
+}
+function logStopMessageAutoMessageIflow(args) {
+    if (!isStopMessageAutoMessageIflowTraceEnabled()) {
+        return;
+    }
+    const requestIdPart = args.requestId ? ` requestId=${args.requestId}` : '';
+    try {
+        if (args.stage === 'request') {
+            const request = args.requestSummary || '';
+            // cyan: outbound request summary
+            // eslint-disable-next-line no-console
+            console.log(`\x1b[38;5;45m[servertool][iflow-automessage] SEND${requestIdPart} ${request}\x1b[0m`);
+            return;
+        }
+        const response = args.responseSummary || '';
+        if (args.error || (typeof args.status === 'number' && args.status !== 0)) {
+            const statusPart = typeof args.status === 'number' ? ` status=${args.status}` : '';
+            const errorPart = args.error ? ` error=${args.error}` : '';
+            // red: failed response summary
+            // eslint-disable-next-line no-console
+            console.log(`\x1b[38;5;196m[servertool][iflow-automessage] RECV${requestIdPart}${statusPart}${errorPart} ${response}\x1b[0m`);
+            return;
+        }
+        // green: successful response summary
+        // eslint-disable-next-line no-console
+        console.log(`\x1b[38;5;46m[servertool][iflow-automessage] RECV${requestIdPart} ${response}\x1b[0m`);
+    }
+    catch {
+        // ignore logging failures
+    }
+}
+function extractStopMessageProviderProtocol(adapterContext) {
+    const direct = toNonEmptyText(asRecord(adapterContext)?.providerProtocol);
+    if (direct) {
+        return direct;
+    }
+    const runtime = readRuntimeMetadata(asRecord(adapterContext) || {});
+    const fromRuntime = toNonEmptyText(asRecord(runtime)?.providerProtocol);
+    return fromRuntime || undefined;
+}
+function extractStopMessageAssistantText(message) {
+    const contentText = extractTextFromMessageContent(message.content);
+    if (contentText) {
+        return contentText;
+    }
+    return extractUnknownText(message.content);
+}
+function extractStopMessageReasoningText(message) {
+    const explicitKeys = [
+        'reasoning_content',
+        'reasoning',
+        'reasoning_text',
+        'thinking',
+        'thought',
+        'analysis'
+    ];
+    const chunks = [];
+    for (const key of explicitKeys) {
+        const text = extractUnknownText(message[key]);
+        if (text) {
+            chunks.push(text);
+        }
+    }
+    const contentReasoning = extractStopMessageReasoningFromContent(message.content);
+    if (contentReasoning) {
+        chunks.push(contentReasoning);
+    }
+    return dedupeAndJoinTexts(chunks);
+}
+function extractResponsesReasoningText(payload) {
+    const chunks = [];
+    const directReasoning = extractUnknownText(payload.reasoning);
+    if (directReasoning) {
+        chunks.push(directReasoning);
+    }
+    const output = Array.isArray(payload.output) ? payload.output : [];
+    for (const item of output) {
+        const record = asRecord(item);
+        if (!record) {
+            continue;
+        }
+        const type = toNonEmptyText(record.type).toLowerCase();
+        if (type.includes('reason') || type.includes('think') || type.includes('analysis')) {
+            const text = extractUnknownText(record.summary) || extractUnknownText(record.content) || extractUnknownText(record.text);
+            if (text) {
+                chunks.push(text);
+            }
+            continue;
+        }
+        if (type === 'message') {
+            const contentReasoning = extractStopMessageReasoningFromContent(record.content);
+            if (contentReasoning) {
+                chunks.push(contentReasoning);
+            }
+        }
+    }
+    return dedupeAndJoinTexts(chunks);
+}
+function extractStopMessageReasoningFromContent(content) {
+    if (!Array.isArray(content)) {
+        return '';
+    }
+    const chunks = [];
+    for (const item of content) {
+        const record = asRecord(item);
+        if (!record) {
+            continue;
+        }
+        const type = toNonEmptyText(record.type).toLowerCase();
+        if (!type.includes('reason') && !type.includes('think') && !type.includes('analysis')) {
+            continue;
+        }
+        const text = extractUnknownText(record.text) ||
+            extractUnknownText(record.summary) ||
+            extractUnknownText(record.content) ||
+            extractUnknownText(record.value);
+        if (text) {
+            chunks.push(text);
+        }
+    }
+    return dedupeAndJoinTexts(chunks);
+}
+function extractUnknownText(value, depth = 0) {
+    if (depth > 4 || value === null || value === undefined) {
+        return '';
+    }
+    if (typeof value === 'string') {
+        return value.trim();
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        const parts = value
+            .map((entry) => extractUnknownText(entry, depth + 1))
+            .filter((entry) => entry.length > 0);
+        return dedupeAndJoinTexts(parts);
+    }
+    if (typeof value !== 'object') {
+        return '';
+    }
+    const record = value;
+    const priorityKeys = ['text', 'content', 'value', 'summary', 'reasoning', 'thinking', 'analysis'];
+    const parts = [];
+    for (const key of priorityKeys) {
+        if (!(key in record)) {
+            continue;
+        }
+        const text = extractUnknownText(record[key], depth + 1);
+        if (text) {
+            parts.push(text);
+        }
+    }
+    if (parts.length === 0) {
+        for (const raw of Object.values(record)) {
+            if (typeof raw !== 'string') {
+                continue;
+            }
+            const text = raw.trim();
+            if (text) {
+                parts.push(text);
+            }
+        }
+    }
+    return dedupeAndJoinTexts(parts);
+}
+function dedupeAndJoinTexts(parts) {
+    const unique = Array.from(new Set(parts
+        .map((entry) => (typeof entry === 'string' ? entry.trim() : ''))
+        .filter((entry) => entry.length > 0)));
+    return unique.join('\n').trim();
+}
+function buildStopMessageResponseExcerpt(value) {
+    try {
+        const raw = JSON.stringify(value);
+        if (!raw) {
+            return '';
+        }
+        if (raw.length <= 3_000) {
+            return raw;
+        }
+        return `${raw.slice(0, 3_000)}...`;
+    }
+    catch {
+        return '';
+    }
+}
+function asRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+function toNonEmptyText(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : '';
+}

package/dist/servertool/handlers/stop-message-auto/routing-state.d.ts

@@ -0,0 +1,38 @@
+import type { RoutingInstructionState } from '../../../router/virtual-router/routing-instructions.js';
+export declare function hasArmedStopMessageState(state: RoutingInstructionState): boolean;
+export declare function normalizeStopMessageModeValue(value: unknown): 'on' | 'off' | 'auto' | undefined;
+export declare function normalizeStopMessageStageMode(value: unknown): 'on' | 'off' | 'auto' | undefined;
+export declare function resolveStopMessageMaxRepeats(value: unknown, stageMode: 'on' | 'off' | 'auto' | undefined): number;
+export declare function resolveStopMessageSnapshot(raw: unknown): {
+    text: string;
+    maxRepeats: number;
+    used: number;
+    source?: string;
+    updatedAt?: number;
+    lastUsedAt?: number;
+    stage?: string;
+    stageMode?: 'on' | 'off' | 'auto';
+    observationHash?: string;
+    observationStableCount?: number;
+    bdWorkState?: string;
+    assignedIssueId?: string;
+    assignedIssueSource?: 'in_progress' | 'ready' | 'open';
+    noTaskSummaryUsed?: boolean;
+} | null;
+export declare function createStopMessageState(snapshot: {
+    text: string;
+    maxRepeats: number;
+    used: number;
+    source?: string;
+    updatedAt?: number;
+    lastUsedAt?: number;
+    stage?: string;
+    stageMode?: 'on' | 'off' | 'auto';
+    observationHash?: string;
+    observationStableCount?: number;
+    bdWorkState?: string;
+    assignedIssueId?: string;
+    assignedIssueSource?: 'in_progress' | 'ready' | 'open';
+    noTaskSummaryUsed?: boolean;
+}): RoutingInstructionState;
+export declare function clearStopMessageState(state: RoutingInstructionState, now: number): void;

package/dist/servertool/handlers/stop-message-auto/routing-state.js

@@ -0,0 +1,149 @@
+import { DEFAULT_STOP_MESSAGE_MAX_REPEATS } from '../../../router/virtual-router/routing-stop-message-state-codec.js';
+export function hasArmedStopMessageState(state) {
+    const text = typeof state.stopMessageText === 'string' ? state.stopMessageText.trim() : '';
+    const stageMode = normalizeStopMessageModeValue(state.stopMessageStageMode);
+    const maxRepeats = resolveStopMessageMaxRepeats(state.stopMessageMaxRepeats, stageMode);
+    const allowModeOnlyState = !text &&
+        maxRepeats > 0 &&
+        (stageMode === 'on' || stageMode === 'auto');
+    return (text.length > 0 || allowModeOnlyState) && maxRepeats > 0;
+}
+export function normalizeStopMessageModeValue(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'on' || normalized === 'off' || normalized === 'auto') {
+        return normalized;
+    }
+    return undefined;
+}
+export function normalizeStopMessageStageMode(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'on' || normalized === 'off' || normalized === 'auto') {
+        return normalized;
+    }
+    return undefined;
+}
+export function resolveStopMessageMaxRepeats(value, stageMode) {
+    const parsed = typeof value === 'number' && Number.isFinite(value)
+        ? Math.floor(value)
+        : 0;
+    if (parsed > 0) {
+        return parsed;
+    }
+    if (stageMode === 'on' || stageMode === 'auto') {
+        return DEFAULT_STOP_MESSAGE_MAX_REPEATS;
+    }
+    return 0;
+}
+export function resolveStopMessageSnapshot(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return null;
+    }
+    const record = raw;
+    const text = typeof record.stopMessageText === 'string' ? record.stopMessageText.trim() : '';
+    const stageMode = normalizeStopMessageStageMode(record.stopMessageStageMode);
+    const maxRepeats = resolveStopMessageMaxRepeats(record.stopMessageMaxRepeats, stageMode);
+    const allowModeOnlyState = !text &&
+        maxRepeats > 0 &&
+        (stageMode === 'on' || stageMode === 'auto');
+    if ((!text && !allowModeOnlyState) || maxRepeats <= 0) {
+        return null;
+    }
+    const used = typeof record.stopMessageUsed === 'number' && Number.isFinite(record.stopMessageUsed)
+        ? Math.max(0, Math.floor(record.stopMessageUsed))
+        : 0;
+    const updatedAt = typeof record.stopMessageUpdatedAt === 'number' && Number.isFinite(record.stopMessageUpdatedAt)
+        ? record.stopMessageUpdatedAt
+        : undefined;
+    const lastUsedAt = typeof record.stopMessageLastUsedAt === 'number' && Number.isFinite(record.stopMessageLastUsedAt)
+        ? record.stopMessageLastUsedAt
+        : undefined;
+    const source = typeof record.stopMessageSource === 'string' && record.stopMessageSource.trim()
+        ? record.stopMessageSource.trim()
+        : undefined;
+    const stage = typeof record.stopMessageStage === 'string' && record.stopMessageStage.trim()
+        ? record.stopMessageStage.trim()
+        : undefined;
+    const observationHash = typeof record.stopMessageObservationHash === 'string' && record.stopMessageObservationHash.trim()
+        ? record.stopMessageObservationHash.trim()
+        : undefined;
+    const observationStableCount = typeof record.stopMessageObservationStableCount === 'number' && Number.isFinite(record.stopMessageObservationStableCount)
+        ? Math.max(0, Math.floor(record.stopMessageObservationStableCount))
+        : undefined;
+    const bdWorkState = typeof record.stopMessageBdWorkState === 'string' && record.stopMessageBdWorkState.trim()
+        ? record.stopMessageBdWorkState.trim()
+        : undefined;
+    const assignedIssueId = typeof record.stopMessageAssignedIssueId === 'string' && record.stopMessageAssignedIssueId.trim()
+        ? record.stopMessageAssignedIssueId.trim()
+        : undefined;
+    const sourceRaw = typeof record.stopMessageAssignedIssueSource === 'string'
+        ? record.stopMessageAssignedIssueSource.trim().toLowerCase()
+        : '';
+    const assignedIssueSource = sourceRaw === 'in_progress' || sourceRaw === 'ready' || sourceRaw === 'open'
+        ? sourceRaw
+        : undefined;
+    const noTaskSummaryUsed = typeof record.stopMessageNoTaskSummaryUsed === 'boolean'
+        ? record.stopMessageNoTaskSummaryUsed
+        : undefined;
+    return {
+        text,
+        maxRepeats,
+        used,
+        ...(source ? { source } : {}),
+        ...(updatedAt ? { updatedAt } : {}),
+        ...(lastUsedAt ? { lastUsedAt } : {}),
+        ...(stage ? { stage } : {}),
+        ...(stageMode ? { stageMode } : {}),
+        ...(observationHash ? { observationHash } : {}),
+        ...(typeof observationStableCount === 'number' ? { observationStableCount } : {}),
+        ...(bdWorkState ? { bdWorkState } : {}),
+        ...(assignedIssueId ? { assignedIssueId } : {}),
+        ...(assignedIssueSource ? { assignedIssueSource } : {}),
+        ...(typeof noTaskSummaryUsed === 'boolean' ? { noTaskSummaryUsed } : {})
+    };
+}
+export function createStopMessageState(snapshot) {
+    return {
+        forcedTarget: undefined,
+        stickyTarget: undefined,
+        allowedProviders: new Set(),
+        disabledProviders: new Set(),
+        disabledKeys: new Map(),
+        disabledModels: new Map(),
+        stopMessageSource: snapshot.source && snapshot.source.trim() ? snapshot.source.trim() : 'explicit',
+        stopMessageText: snapshot.text,
+        stopMessageMaxRepeats: snapshot.maxRepeats,
+        stopMessageUsed: snapshot.used,
+        stopMessageUpdatedAt: snapshot.updatedAt,
+        stopMessageLastUsedAt: snapshot.lastUsedAt,
+        stopMessageStage: snapshot.stage,
+        stopMessageStageMode: snapshot.stageMode,
+        stopMessageObservationHash: snapshot.observationHash,
+        stopMessageObservationStableCount: snapshot.observationStableCount,
+        stopMessageBdWorkState: snapshot.bdWorkState,
+        stopMessageAssignedIssueId: snapshot.assignedIssueId,
+        stopMessageAssignedIssueSource: snapshot.assignedIssueSource,
+        stopMessageNoTaskSummaryUsed: snapshot.noTaskSummaryUsed
+    };
+}
+export function clearStopMessageState(state, now) {
+    state.stopMessageText = undefined;
+    state.stopMessageMaxRepeats = undefined;
+    state.stopMessageUsed = undefined;
+    state.stopMessageSource = undefined;
+    state.stopMessageStage = undefined;
+    state.stopMessageStageMode = undefined;
+    state.stopMessageObservationHash = undefined;
+    state.stopMessageObservationStableCount = undefined;
+    state.stopMessageBdWorkState = undefined;
+    state.stopMessageAssignedIssueId = undefined;
+    state.stopMessageAssignedIssueSource = undefined;
+    state.stopMessageNoTaskSummaryUsed = undefined;
+    state.stopMessageUpdatedAt = now;
+    state.stopMessageLastUsedAt = now;
+}