@jsonstudio/rcc 0.90.872 → 0.90.1270

package/node_modules/@jsonstudio/llms/dist/servertool/handlers/reasoning-stop-state.js

@@ -0,0 +1,606 @@
+import { loadRoutingInstructionStateSync, saveRoutingInstructionStateSync } from '../../router/virtual-router/sticky-session-store.js';
+import { readRuntimeMetadata } from '../../conversion/runtime-metadata.js';
+import { resolveStopMessageSessionScope } from './stop-message-auto/runtime-utils.js';
+import { extractCapturedChatSeed } from './followup-request-builder.js';
+const REASONING_STOP_SUMMARY_MAX_CHARS = 4000;
+const STOPLESS_DIRECTIVE_PATTERN = /<\*\*stopless:([a-z0-9_-]+)\*\*>/gi;
+const STOPLESS_DIRECTIVE_STRIP_PATTERN = /<\*\*stopless:[^*]+\*\*>/gi;
+export const DEFAULT_REASONING_STOP_MODE = 'off';
+export const REASONING_STOP_TOOL_DEF = {
+    type: 'function',
+    function: {
+        name: 'reasoning.stop',
+        description: 'Structured stop self-check gate. Stop is allowed only when either: (A) task is completed with completion_evidence; or (B) all feasible attempts are exhausted and the task is irrecoverably blocked, with cannot_complete_reason + blocking_evidence + attempts_exhausted=true; or (C) is_simple_question=true (simple factual question that can be answered directly). If the current task is plan mode / audit / other intentionally read-only work and the requested deliverable is already complete, set is_completed=true, stop_reason=plan_mode, and provide completion_evidence. If user input is required, also provide user_input_required=true and user_question. Required: task_goal, is_completed. If not completed but a concrete next action exists, fill next_step and continue instead of stopping.',
+        parameters: {
+            type: 'object',
+            properties: {
+                task_goal: { type: 'string' },
+                is_completed: { type: 'boolean' },
+                stop_reason: {
+                    type: 'string',
+                    enum: ['completed', 'blocked', 'user_input', 'simple_question', 'plan_mode'],
+                    description: 'Optional structured stop reason. Use plan_mode for plan/audit/other intentionally read-only tasks whose requested deliverable is already complete.'
+                },
+                completion_evidence: { type: 'string' },
+                cannot_complete_reason: { type: 'string' },
+                blocking_evidence: { type: 'string' },
+                attempts_exhausted: { type: 'boolean' },
+                next_step: { type: 'string' },
+                user_input_required: { type: 'boolean' },
+                user_question: { type: 'string' },
+                learning: { type: 'string' },
+                is_simple_question: { type: 'boolean', description: 'True if this is a simple factual question that can be answered directly without further execution' }
+            },
+            required: ['task_goal', 'is_completed'],
+            additionalProperties: false
+        }
+    }
+};
+const REASONING_STOP_DIRECTIVE_MODE_KEYS = [
+    'reasoningStopDirectiveMode',
+    '__reasoningStopDirectiveMode'
+];
+function createEmptyRoutingInstructionState() {
+    return {
+        forcedTarget: undefined,
+        stickyTarget: undefined,
+        preferTarget: undefined,
+        allowedProviders: new Set(),
+        disabledProviders: new Set(),
+        disabledKeys: new Map(),
+        disabledModels: new Map(),
+        stopMessageSource: undefined,
+        stopMessageText: undefined,
+        stopMessageMaxRepeats: undefined,
+        stopMessageUsed: undefined,
+        stopMessageUpdatedAt: undefined,
+        stopMessageLastUsedAt: undefined,
+        stopMessageStageMode: undefined,
+        stopMessageAiMode: undefined,
+        stopMessageAiSeedPrompt: undefined,
+        stopMessageAiHistory: undefined,
+        reasoningStopMode: undefined,
+        reasoningStopArmed: undefined,
+        reasoningStopSummary: undefined,
+        reasoningStopUpdatedAt: undefined,
+        reasoningStopFailCount: undefined,
+        reasoningStopGuardTriggerCount: undefined,
+        reasoningStopGuardTriggerAt: undefined,
+        preCommandSource: undefined,
+        preCommandScriptPath: undefined,
+        preCommandUpdatedAt: undefined
+    };
+}
+function resolveStickyKey(adapterContext) {
+    if (!adapterContext || typeof adapterContext !== 'object' || Array.isArray(adapterContext)) {
+        return '';
+    }
+    const record = adapterContext;
+    const runtime = readRuntimeMetadata(record);
+    const scope = resolveStopMessageSessionScope(record, runtime);
+    return typeof scope === 'string' ? scope.trim() : '';
+}
+function normalizeSummary(value) {
+    if (typeof value !== 'string') {
+        return '';
+    }
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return '';
+    }
+    if (trimmed.length <= REASONING_STOP_SUMMARY_MAX_CHARS) {
+        return trimmed;
+    }
+    return trimmed.slice(0, REASONING_STOP_SUMMARY_MAX_CHARS);
+}
+function readNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? Math.max(0, Math.floor(value)) : undefined;
+}
+function hasReasoningStopState(state) {
+    if (!state) {
+        return false;
+    }
+    const mode = normalizeReasoningStopMode(state.reasoningStopMode);
+    if (mode) {
+        return true;
+    }
+    if (state.reasoningStopArmed === true) {
+        return true;
+    }
+    if (typeof state.reasoningStopSummary === 'string' && state.reasoningStopSummary.trim()) {
+        return true;
+    }
+    return typeof state.reasoningStopUpdatedAt === 'number' && Number.isFinite(state.reasoningStopUpdatedAt);
+}
+function isStateEmpty(state) {
+    const noForced = !state.forcedTarget;
+    const noSticky = !state.stickyTarget;
+    const noPrefer = !state.preferTarget;
+    const noAllowed = state.allowedProviders.size === 0;
+    const noDisabledProviders = state.disabledProviders.size === 0;
+    const noDisabledKeys = state.disabledKeys.size === 0;
+    const noDisabledModels = state.disabledModels.size === 0;
+    const noStopMessage = (!state.stopMessageText || !state.stopMessageText.trim()) &&
+        (typeof state.stopMessageMaxRepeats !== 'number' || !Number.isFinite(state.stopMessageMaxRepeats)) &&
+        (typeof state.stopMessageUsed !== 'number' || !Number.isFinite(state.stopMessageUsed)) &&
+        (typeof state.stopMessageStageMode !== 'string' || !state.stopMessageStageMode.trim()) &&
+        (typeof state.stopMessageAiMode !== 'string' || !state.stopMessageAiMode.trim());
+    const noReasoningStop = (typeof state.reasoningStopMode !== 'string' || !state.reasoningStopMode.trim()) &&
+        state.reasoningStopArmed !== true &&
+        (typeof state.reasoningStopUpdatedAt !== 'number' || !Number.isFinite(state.reasoningStopUpdatedAt)) &&
+        (typeof state.reasoningStopFailCount !== 'number' || !Number.isFinite(state.reasoningStopFailCount));
+    (typeof state.reasoningStopUpdatedAt !== 'number' || !Number.isFinite(state.reasoningStopUpdatedAt));
+    const noPreCommand = (!state.preCommandScriptPath || !state.preCommandScriptPath.trim()) &&
+        (typeof state.preCommandUpdatedAt !== 'number' || !Number.isFinite(state.preCommandUpdatedAt));
+    return (noForced &&
+        noSticky &&
+        noPrefer &&
+        noAllowed &&
+        noDisabledProviders &&
+        noDisabledKeys &&
+        noDisabledModels &&
+        noStopMessage &&
+        noReasoningStop &&
+        noPreCommand);
+}
+function normalizeReasoningStopMode(value) {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'on' || normalized === 'off' || normalized === 'endless') {
+        return normalized;
+    }
+    return undefined;
+}
+function readStoredReasoningStopDirectiveMode(source) {
+    if (!source || typeof source !== 'object' || Array.isArray(source)) {
+        return undefined;
+    }
+    const record = source;
+    for (const key of REASONING_STOP_DIRECTIVE_MODE_KEYS) {
+        const mode = normalizeReasoningStopMode(record[key]);
+        if (mode) {
+            return mode;
+        }
+    }
+    return undefined;
+}
+function storeReasoningStopDirectiveMode(source, mode) {
+    if (!source || typeof source !== 'object' || Array.isArray(source) || !mode) {
+        return;
+    }
+    const record = source;
+    for (const key of REASONING_STOP_DIRECTIVE_MODE_KEYS) {
+        record[key] = mode;
+    }
+}
+function extractMessageContentText(content) {
+    if (typeof content === 'string') {
+        return content.trim();
+    }
+    if (Array.isArray(content)) {
+        const parts = [];
+        for (const item of content) {
+            if (typeof item === 'string') {
+                const text = item.trim();
+                if (text) {
+                    parts.push(text);
+                }
+                continue;
+            }
+            if (!item || typeof item !== 'object') {
+                continue;
+            }
+            const record = item;
+            const text = typeof record.text === 'string' ? record.text.trim() : '';
+            if (text) {
+                parts.push(text);
+            }
+        }
+        return parts.join('\n').trim();
+    }
+    return '';
+}
+function extractLatestUserTextFromCapturedRequest(source) {
+    const seed = extractCapturedChatSeed(source);
+    if (!seed || !Array.isArray(seed.messages) || seed.messages.length === 0) {
+        return '';
+    }
+    for (let i = seed.messages.length - 1; i >= 0; i -= 1) {
+        const msg = seed.messages[i];
+        if (!msg || typeof msg !== 'object') {
+            continue;
+        }
+        const role = typeof msg.role === 'string'
+            ? String(msg.role).trim().toLowerCase()
+            : '';
+        if (role !== 'user') {
+            continue;
+        }
+        const content = msg.content;
+        const text = extractMessageContentText(content);
+        if (text) {
+            return text;
+        }
+    }
+    return '';
+}
+function extractStoplessDirectiveModeFromText(text) {
+    const source = typeof text === 'string' ? text : '';
+    if (!source) {
+        return undefined;
+    }
+    STOPLESS_DIRECTIVE_PATTERN.lastIndex = 0;
+    let matched;
+    for (const match of source.matchAll(STOPLESS_DIRECTIVE_PATTERN)) {
+        const mode = normalizeReasoningStopMode(match[1]);
+        if (mode) {
+            matched = mode;
+        }
+    }
+    return matched;
+}
+function stripStoplessDirectiveMarkersFromText(text) {
+    if (typeof text !== 'string' || !text) {
+        return { text: '', stripped: false };
+    }
+    let stripped = false;
+    STOPLESS_DIRECTIVE_STRIP_PATTERN.lastIndex = 0;
+    const replaced = text.replace(STOPLESS_DIRECTIVE_STRIP_PATTERN, () => {
+        stripped = true;
+        return ' ';
+    });
+    if (!stripped) {
+        return { text, stripped: false };
+    }
+    const compacted = replaced
+        .replace(/[ \t]+\n/g, '\n')
+        .replace(/\n[ \t]+/g, '\n')
+        .replace(/[ \t]{2,}/g, ' ')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+    return { text: compacted, stripped: true };
+}
+function stripStoplessDirectiveMarkersFromContent(content) {
+    if (typeof content === 'string') {
+        const stripped = stripStoplessDirectiveMarkersFromText(content);
+        return { content: stripped.text, stripped: stripped.stripped };
+    }
+    if (!Array.isArray(content)) {
+        return { content, stripped: false };
+    }
+    const nextContent = [];
+    let strippedAny = false;
+    for (const item of content) {
+        if (typeof item === 'string') {
+            const stripped = stripStoplessDirectiveMarkersFromText(item);
+            if (stripped.stripped) {
+                strippedAny = true;
+            }
+            nextContent.push(stripped.text);
+            continue;
+        }
+        if (!item || typeof item !== 'object' || Array.isArray(item)) {
+            nextContent.push(item);
+            continue;
+        }
+        const record = item;
+        if (typeof record.text !== 'string') {
+            nextContent.push(item);
+            continue;
+        }
+        const stripped = stripStoplessDirectiveMarkersFromText(record.text);
+        if (!stripped.stripped) {
+            nextContent.push(item);
+            continue;
+        }
+        strippedAny = true;
+        nextContent.push({
+            ...record,
+            text: stripped.text
+        });
+    }
+    return {
+        content: nextContent,
+        stripped: strippedAny
+    };
+}
+function stripStoplessDirectiveMarkersInMessages(messages) {
+    if (!Array.isArray(messages) || messages.length === 0) {
+        return false;
+    }
+    let strippedAny = false;
+    for (const message of messages) {
+        if (!message || typeof message !== 'object') {
+            continue;
+        }
+        const role = typeof message.role === 'string'
+            ? String(message.role).trim().toLowerCase()
+            : '';
+        if (role !== 'user') {
+            continue;
+        }
+        const originalContent = message.content;
+        const stripped = stripStoplessDirectiveMarkersFromContent(originalContent);
+        if (!stripped.stripped) {
+            continue;
+        }
+        strippedAny = true;
+        message.content = stripped.content;
+    }
+    return strippedAny;
+}
+function stripStoplessDirectiveMarkersFromCapturedRequest(source) {
+    if (!source || typeof source !== 'object' || Array.isArray(source)) {
+        return false;
+    }
+    const record = source;
+    const messages = Array.isArray(record.messages) ? record.messages : [];
+    const input = Array.isArray(record.input) ? record.input : [];
+    const strippedInMessages = stripStoplessDirectiveMarkersInMessages(messages);
+    const strippedInInput = stripStoplessDirectiveMarkersInMessages(input);
+    return strippedInMessages || strippedInInput;
+}
+function extractStoplessDirectiveModeFromAdapterContext(adapterContext) {
+    if (!adapterContext || typeof adapterContext !== 'object' || Array.isArray(adapterContext)) {
+        return undefined;
+    }
+    const record = adapterContext;
+    const captured = record.capturedChatRequest;
+    const storedMode = readStoredReasoningStopDirectiveMode(captured) ?? readStoredReasoningStopDirectiveMode(record);
+    if (storedMode) {
+        return storedMode;
+    }
+    const text = extractLatestUserTextFromCapturedRequest(captured);
+    const mode = extractStoplessDirectiveModeFromText(text);
+    if (mode) {
+        storeReasoningStopDirectiveMode(record, mode);
+        storeReasoningStopDirectiveMode(captured, mode);
+    }
+    // Marker is transport control signal and must never leak into followup payloads,
+    // regardless of whether parsing succeeds.
+    stripStoplessDirectiveMarkersFromCapturedRequest(captured);
+    return mode;
+}
+export function readReasoningStopMode(adapterContext, fallbackMode = DEFAULT_REASONING_STOP_MODE) {
+    const stickyKey = resolveStickyKey(adapterContext);
+    if (!stickyKey) {
+        return fallbackMode;
+    }
+    let state = null;
+    try {
+        state = loadRoutingInstructionStateSync(stickyKey);
+    }
+    catch {
+        return fallbackMode;
+    }
+    return normalizeReasoningStopMode(state?.reasoningStopMode) ?? fallbackMode;
+}
+export function syncReasoningStopModeFromRequest(adapterContext, fallbackMode = DEFAULT_REASONING_STOP_MODE) {
+    const stickyKey = resolveStickyKey(adapterContext);
+    const directiveMode = extractStoplessDirectiveModeFromAdapterContext(adapterContext);
+    if (!stickyKey) {
+        // stopless switch is strictly session-bound. If we cannot bind a session scope,
+        // the directive must be ignored.
+        return fallbackMode;
+    }
+    let state = null;
+    try {
+        state = loadRoutingInstructionStateSync(stickyKey);
+    }
+    catch {
+        state = null;
+    }
+    const persistedMode = normalizeReasoningStopMode(state?.reasoningStopMode) ?? fallbackMode;
+    if (!directiveMode) {
+        return persistedMode;
+    }
+    const next = state ?? createEmptyRoutingInstructionState();
+    next.reasoningStopMode = directiveMode;
+    if (directiveMode === 'off') {
+        next.reasoningStopArmed = undefined;
+        next.reasoningStopSummary = undefined;
+        next.reasoningStopUpdatedAt = undefined;
+    }
+    saveRoutingInstructionStateSync(stickyKey, next);
+    return directiveMode;
+}
+export function readReasoningStopState(adapterContext) {
+    const stickyKey = resolveStickyKey(adapterContext);
+    if (!stickyKey) {
+        return { stickyKey: '', armed: false, summary: '' };
+    }
+    let state = null;
+    try {
+        state = loadRoutingInstructionStateSync(stickyKey);
+    }
+    catch {
+        return { stickyKey, armed: false, summary: '' };
+    }
+    if (!hasReasoningStopState(state)) {
+        return { stickyKey, armed: false, summary: '' };
+    }
+    const summary = normalizeSummary(state?.reasoningStopSummary);
+    const updatedAt = readNumber(state?.reasoningStopUpdatedAt);
+    return {
+        stickyKey,
+        armed: state?.reasoningStopArmed === true && summary.length > 0,
+        summary,
+        ...(typeof updatedAt === 'number' ? { updatedAt } : {})
+    };
+}
+export function armReasoningStopState(adapterContext, summary) {
+    const stickyKey = resolveStickyKey(adapterContext);
+    const normalizedSummary = normalizeSummary(summary);
+    if (!stickyKey || !normalizedSummary) {
+        return false;
+    }
+    let state = null;
+    try {
+        state = loadRoutingInstructionStateSync(stickyKey);
+    }
+    catch {
+        state = null;
+    }
+    const next = state ?? createEmptyRoutingInstructionState();
+    next.reasoningStopArmed = true;
+    next.reasoningStopSummary = normalizedSummary;
+    next.reasoningStopUpdatedAt = Date.now();
+    saveRoutingInstructionStateSync(stickyKey, next);
+    return true;
+}
+export function clearReasoningStopState(adapterContext) {
+    const stickyKey = resolveStickyKey(adapterContext);
+    if (!stickyKey) {
+        return;
+    }
+    let state = null;
+    try {
+        state = loadRoutingInstructionStateSync(stickyKey);
+    }
+    catch {
+        state = null;
+    }
+    if (!state) {
+        return;
+    }
+    state.reasoningStopArmed = undefined;
+    state.reasoningStopSummary = undefined;
+    state.reasoningStopUpdatedAt = undefined;
+    state.reasoningStopFailCount = undefined;
+    if (isStateEmpty(state)) {
+        saveRoutingInstructionStateSync(stickyKey, null);
+        return;
+    }
+    saveRoutingInstructionStateSync(stickyKey, state);
+}
+export function readReasoningStopFailCount(adapterContext) {
+    const stickyKey = resolveStickyKey(adapterContext);
+    if (!stickyKey) {
+        return 0;
+    }
+    let state = null;
+    try {
+        state = loadRoutingInstructionStateSync(stickyKey);
+    }
+    catch {
+        state = null;
+    }
+    if (!state) {
+        return 0;
+    }
+    const count = state.reasoningStopFailCount;
+    return typeof count === 'number' && Number.isFinite(count) ? count : 0;
+}
+export function incrementReasoningStopFailCount(adapterContext) {
+    const stickyKey = resolveStickyKey(adapterContext);
+    if (!stickyKey) {
+        return 0;
+    }
+    let state = null;
+    try {
+        state = loadRoutingInstructionStateSync(stickyKey);
+    }
+    catch {
+        state = null;
+    }
+    const next = state ?? createEmptyRoutingInstructionState();
+    const currentCount = typeof next.reasoningStopFailCount === 'number' && Number.isFinite(next.reasoningStopFailCount)
+        ? next.reasoningStopFailCount
+        : 0;
+    const newCount = currentCount + 1;
+    next.reasoningStopFailCount = newCount;
+    saveRoutingInstructionStateSync(stickyKey, next);
+    return newCount;
+}
+export function resetReasoningStopFailCount(adapterContext) {
+    const stickyKey = resolveStickyKey(adapterContext);
+    if (!stickyKey) {
+        return;
+    }
+    let state = null;
+    try {
+        state = loadRoutingInstructionStateSync(stickyKey);
+    }
+    catch {
+        state = null;
+    }
+    if (!state) {
+        return;
+    }
+    state.reasoningStopFailCount = undefined;
+    if (isStateEmpty(state)) {
+        saveRoutingInstructionStateSync(stickyKey, null);
+        return;
+    }
+    saveRoutingInstructionStateSync(stickyKey, state);
+}
+// Storm protection: guard trigger tracking
+export function readReasoningStopGuardTriggerCount(adapterContext) {
+    const stickyKey = resolveStickyKey(adapterContext);
+    if (!stickyKey) {
+        return { count: 0, lastTriggerAt: undefined };
+    }
+    let state = null;
+    try {
+        state = loadRoutingInstructionStateSync(stickyKey);
+    }
+    catch {
+        state = null;
+    }
+    if (!state) {
+        return { count: 0, lastTriggerAt: undefined };
+    }
+    const count = state.reasoningStopGuardTriggerCount;
+    const lastTriggerAt = state.reasoningStopGuardTriggerAt;
+    return {
+        count: typeof count === 'number' && Number.isFinite(count) ? count : 0,
+        lastTriggerAt: typeof lastTriggerAt === 'number' && Number.isFinite(lastTriggerAt) ? lastTriggerAt : undefined
+    };
+}
+export function incrementReasoningStopGuardTriggerCount(adapterContext) {
+    const stickyKey = resolveStickyKey(adapterContext);
+    if (!stickyKey) {
+        return 0;
+    }
+    let state = null;
+    try {
+        state = loadRoutingInstructionStateSync(stickyKey);
+    }
+    catch {
+        state = null;
+    }
+    const next = state ?? createEmptyRoutingInstructionState();
+    const currentCount = typeof next.reasoningStopGuardTriggerCount === 'number' && Number.isFinite(next.reasoningStopGuardTriggerCount)
+        ? next.reasoningStopGuardTriggerCount
+        : 0;
+    const newCount = currentCount + 1;
+    next.reasoningStopGuardTriggerCount = newCount;
+    next.reasoningStopGuardTriggerAt = Date.now();
+    saveRoutingInstructionStateSync(stickyKey, next);
+    return newCount;
+}
+export function resetReasoningStopGuardTriggerCount(adapterContext) {
+    const stickyKey = resolveStickyKey(adapterContext);
+    if (!stickyKey) {
+        return;
+    }
+    let state = null;
+    try {
+        state = loadRoutingInstructionStateSync(stickyKey);
+    }
+    catch {
+        state = null;
+    }
+    if (!state) {
+        return;
+    }
+    state.reasoningStopGuardTriggerCount = undefined;
+    state.reasoningStopGuardTriggerAt = undefined;
+    if (isStateEmpty(state)) {
+        saveRoutingInstructionStateSync(stickyKey, null);
+        return;
+    }
+    saveRoutingInstructionStateSync(stickyKey, state);
+}