qlogicagent 0.1.0

package/dist/orchestration/transcript-repair.js

@@ -0,0 +1,427 @@
+const TOOL_CALL_NAME_MAX_CHARS = 64;
+const TOOL_CALL_NAME_RE = /^[A-Za-z0-9_-]+$/;
+const TOOL_CALL_TYPES = new Set(["toolCall", "toolUse", "functionCall"]);
+const TRANSIENT_ERROR_RE = /rate limit|rate.limited|overloaded|too many requests|quota exceeded|timed?\s*out|billing|insufficient.*(balance|quota|credit)|try again later/i;
+function isRawToolCallBlock(block) {
+    if (!block || typeof block !== "object") {
+        return false;
+    }
+    const type = block.type;
+    return typeof type === "string" && TOOL_CALL_TYPES.has(type);
+}
+function hasToolCallInput(block) {
+    const hasInput = "input" in block ? block.input !== undefined && block.input !== null : false;
+    const hasArguments = "arguments" in block ? block.arguments !== undefined && block.arguments !== null : false;
+    return hasInput || hasArguments;
+}
+function hasNonEmptyStringField(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function hasToolCallId(block) {
+    return hasNonEmptyStringField(block.id);
+}
+function trimNonEmptyString(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed || undefined;
+}
+function normalizeAllowedToolNames(allowedToolNames) {
+    if (!allowedToolNames) {
+        return null;
+    }
+    const normalized = new Set();
+    for (const name of allowedToolNames) {
+        if (typeof name !== "string") {
+            continue;
+        }
+        const trimmed = name.trim();
+        if (trimmed) {
+            normalized.add(trimmed.toLowerCase());
+        }
+    }
+    return normalized.size > 0 ? normalized : null;
+}
+function hasToolCallName(block, allowedToolNames) {
+    if (typeof block.name !== "string") {
+        return false;
+    }
+    const trimmed = block.name.trim();
+    if (!trimmed) {
+        return false;
+    }
+    if (trimmed.length > TOOL_CALL_NAME_MAX_CHARS || !TOOL_CALL_NAME_RE.test(trimmed)) {
+        return false;
+    }
+    if (!allowedToolNames) {
+        return true;
+    }
+    return allowedToolNames.has(trimmed.toLowerCase());
+}
+function redactSessionsSpawnAttachmentsArgs(value) {
+    if (!value || typeof value !== "object") {
+        return value;
+    }
+    const record = value;
+    const raw = record.attachments;
+    if (!Array.isArray(raw)) {
+        return value;
+    }
+    const next = raw.map((item) => {
+        if (!item || typeof item !== "object") {
+            return item;
+        }
+        const attachment = item;
+        if (!Object.hasOwn(attachment, "content")) {
+            return item;
+        }
+        const { content: _content, ...rest } = attachment;
+        return { ...rest, content: "__OPENCLAW_REDACTED__" };
+    });
+    return { ...record, attachments: next };
+}
+function sanitizeToolCallBlock(block) {
+    const rawName = typeof block.name === "string" ? block.name : undefined;
+    const trimmedName = rawName?.trim();
+    const hasTrimmedName = typeof trimmedName === "string" && trimmedName.length > 0;
+    const normalizedName = hasTrimmedName ? trimmedName : undefined;
+    const nameChanged = hasTrimmedName && rawName !== trimmedName;
+    const isDelegatedSessionSpawnToolCall = normalizedName?.toLowerCase() === "sessions_spawn";
+    if (!isDelegatedSessionSpawnToolCall) {
+        if (!nameChanged) {
+            return block;
+        }
+        return { ...block, name: normalizedName };
+    }
+    const nextArgs = redactSessionsSpawnAttachmentsArgs(block.arguments);
+    const nextInput = redactSessionsSpawnAttachmentsArgs(block.input);
+    if (nextArgs === block.arguments && nextInput === block.input && !nameChanged) {
+        return block;
+    }
+    const next = { ...block };
+    if (nameChanged && normalizedName) {
+        next.name = normalizedName;
+    }
+    if (nextArgs !== block.arguments || Object.hasOwn(block, "arguments")) {
+        next.arguments = nextArgs;
+    }
+    if (nextInput !== block.input || Object.hasOwn(block, "input")) {
+        next.input = nextInput;
+    }
+    return next;
+}
+function normalizeToolResultName(message, fallbackName) {
+    const rawToolName = message.toolName;
+    const normalizedToolName = trimNonEmptyString(rawToolName);
+    if (normalizedToolName) {
+        if (rawToolName === normalizedToolName) {
+            return message;
+        }
+        return { ...message, toolName: normalizedToolName };
+    }
+    const normalizedFallback = trimNonEmptyString(fallbackName);
+    if (normalizedFallback) {
+        return { ...message, toolName: normalizedFallback };
+    }
+    if (typeof rawToolName === "string") {
+        return { ...message, toolName: "unknown" };
+    }
+    return message;
+}
+function extractToolCallsFromAssistantLike(message) {
+    const content = message.content;
+    if (!Array.isArray(content)) {
+        return [];
+    }
+    const toolCalls = [];
+    for (const block of content) {
+        if (!block || typeof block !== "object") {
+            continue;
+        }
+        const record = block;
+        if (typeof record.id !== "string" || !record.id) {
+            continue;
+        }
+        if (typeof record.type === "string" && TOOL_CALL_TYPES.has(record.type)) {
+            toolCalls.push({
+                id: record.id,
+                name: typeof record.name === "string" ? record.name : undefined,
+            });
+        }
+    }
+    return toolCalls;
+}
+function extractToolResultIdLike(message) {
+    if (typeof message.toolCallId === "string" && message.toolCallId) {
+        return message.toolCallId;
+    }
+    if (typeof message.toolUseId === "string" && message.toolUseId) {
+        return message.toolUseId;
+    }
+    return null;
+}
+function defaultMissingToolResult(params) {
+    return {
+        role: "toolResult",
+        toolCallId: params.toolCallId,
+        toolName: params.toolName ?? "unknown",
+        content: [
+            {
+                type: "text",
+                text: "[qlogicagent] missing tool result in session history; inserted synthetic error result for transcript repair.",
+            },
+        ],
+        isError: true,
+        timestamp: 0,
+    };
+}
+export function stripToolResultDetails(messages) {
+    let touched = false;
+    const out = [];
+    for (const message of messages) {
+        if (!message || typeof message !== "object" || message.role !== "toolResult") {
+            out.push(message);
+            continue;
+        }
+        if (!("details" in message)) {
+            out.push(message);
+            continue;
+        }
+        const sanitized = { ...message };
+        delete sanitized.details;
+        touched = true;
+        out.push(sanitized);
+    }
+    return touched ? out : [...messages];
+}
+export function repairToolCallInputs(messages, options) {
+    let droppedToolCalls = 0;
+    let droppedAssistantMessages = 0;
+    let changed = false;
+    const out = [];
+    const allowedToolNames = normalizeAllowedToolNames(options?.allowedToolNames);
+    for (const message of messages) {
+        if (!message || typeof message !== "object") {
+            out.push(message);
+            continue;
+        }
+        if (message.role !== "assistant" || !Array.isArray(message.content)) {
+            out.push(message);
+            continue;
+        }
+        const nextContent = [];
+        let droppedInMessage = 0;
+        let messageChanged = false;
+        for (const block of message.content) {
+            if (isRawToolCallBlock(block) &&
+                (!hasToolCallInput(block) ||
+                    !hasToolCallId(block) ||
+                    !hasToolCallName(block, allowedToolNames))) {
+                droppedToolCalls += 1;
+                droppedInMessage += 1;
+                changed = true;
+                messageChanged = true;
+                continue;
+            }
+            if (isRawToolCallBlock(block)) {
+                const blockName = typeof block.name === "string" ? block.name.trim() : undefined;
+                if (blockName?.toLowerCase() === "sessions_spawn") {
+                    const sanitized = sanitizeToolCallBlock(block);
+                    if (sanitized !== block) {
+                        changed = true;
+                        messageChanged = true;
+                    }
+                    nextContent.push(sanitized);
+                    continue;
+                }
+                if (typeof block.name === "string") {
+                    const trimmedName = block.name.trim();
+                    if (trimmedName && trimmedName !== block.name) {
+                        nextContent.push({ ...block, name: trimmedName });
+                        changed = true;
+                        messageChanged = true;
+                        continue;
+                    }
+                }
+            }
+            nextContent.push(block);
+        }
+        if (droppedInMessage > 0) {
+            if (nextContent.length === 0) {
+                droppedAssistantMessages += 1;
+                changed = true;
+                continue;
+            }
+            out.push({ ...message, content: nextContent });
+            continue;
+        }
+        if (messageChanged) {
+            out.push({ ...message, content: nextContent });
+            continue;
+        }
+        out.push(message);
+    }
+    return {
+        messages: changed ? out : [...messages],
+        droppedToolCalls,
+        droppedAssistantMessages,
+    };
+}
+export function sanitizeToolCallInputs(messages, options) {
+    return repairToolCallInputs(messages, options).messages;
+}
+export function repairToolUseResultPairing(messages, options) {
+    const out = [];
+    const added = [];
+    const seenToolResultIds = new Set();
+    let droppedDuplicateCount = 0;
+    let droppedOrphanCount = 0;
+    let moved = false;
+    let changed = false;
+    const createMissingToolResult = options?.createMissingToolResult ?? (defaultMissingToolResult);
+    const pushToolResult = (message) => {
+        const id = extractToolResultIdLike(message);
+        if (id && seenToolResultIds.has(id)) {
+            droppedDuplicateCount += 1;
+            changed = true;
+            return;
+        }
+        if (id) {
+            seenToolResultIds.add(id);
+        }
+        out.push(message);
+    };
+    for (let i = 0; i < messages.length; i += 1) {
+        const message = messages[i];
+        if (!message || typeof message !== "object") {
+            out.push(message);
+            continue;
+        }
+        if (message.role !== "assistant") {
+            if (message.role !== "toolResult") {
+                out.push(message);
+            }
+            else {
+                droppedOrphanCount += 1;
+                changed = true;
+            }
+            continue;
+        }
+        const stopReason = message.stopReason;
+        if (stopReason === "error" || stopReason === "aborted") {
+            out.push(message);
+            continue;
+        }
+        const toolCalls = extractToolCallsFromAssistantLike(message);
+        if (toolCalls.length === 0) {
+            out.push(message);
+            continue;
+        }
+        const toolCallIds = new Set(toolCalls.map((toolCall) => toolCall.id));
+        const toolCallNamesById = new Map(toolCalls.map((toolCall) => [toolCall.id, toolCall.name]));
+        const spanResultsById = new Map();
+        const remainder = [];
+        let j = i + 1;
+        for (; j < messages.length; j += 1) {
+            const next = messages[j];
+            if (!next || typeof next !== "object") {
+                remainder.push(next);
+                continue;
+            }
+            if (next.role === "assistant") {
+                break;
+            }
+            if (next.role === "toolResult") {
+                const id = extractToolResultIdLike(next);
+                if (id && toolCallIds.has(id)) {
+                    if (seenToolResultIds.has(id)) {
+                        droppedDuplicateCount += 1;
+                        changed = true;
+                        continue;
+                    }
+                    const normalizedToolResult = normalizeToolResultName(next, toolCallNamesById.get(id));
+                    if (normalizedToolResult !== next) {
+                        changed = true;
+                    }
+                    if (!spanResultsById.has(id)) {
+                        spanResultsById.set(id, normalizedToolResult);
+                    }
+                    continue;
+                }
+            }
+            if (next.role !== "toolResult") {
+                remainder.push(next);
+            }
+            else {
+                droppedOrphanCount += 1;
+                changed = true;
+            }
+        }
+        out.push(message);
+        if (spanResultsById.size > 0 && remainder.length > 0) {
+            moved = true;
+            changed = true;
+        }
+        for (const call of toolCalls) {
+            const existing = spanResultsById.get(call.id);
+            if (existing) {
+                pushToolResult(existing);
+            }
+            else {
+                const missing = createMissingToolResult({
+                    toolCallId: call.id,
+                    toolName: call.name,
+                });
+                added.push(missing);
+                changed = true;
+                pushToolResult(missing);
+            }
+        }
+        for (const rem of remainder) {
+            out.push(rem);
+        }
+        i = j - 1;
+    }
+    const changedOrMoved = changed || moved;
+    return {
+        messages: changedOrMoved ? out : [...messages],
+        added,
+        droppedDuplicateCount,
+        droppedOrphanCount,
+        moved: changedOrMoved,
+    };
+}
+export function sanitizeToolUseResultPairing(messages, options) {
+    return repairToolUseResultPairing(messages, options).messages;
+}
+export function stripTransientErrorMessages(messages) {
+    let changed = false;
+    const out = [];
+    for (const message of messages) {
+        if (!message || typeof message !== "object") {
+            out.push(message);
+            continue;
+        }
+        if (message.role !== "assistant" || message.stopReason !== "error") {
+            out.push(message);
+            continue;
+        }
+        const content = message.content;
+        const text = typeof content === "string"
+            ? content
+            : Array.isArray(content)
+                ? content
+                    .filter((block) => block.type === "text")
+                    .map((block) => block.text ?? "")
+                    .join(" ")
+                : "";
+        if (!TRANSIENT_ERROR_RE.test(text)) {
+            out.push(message);
+            continue;
+        }
+        changed = true;
+    }
+    return changed ? out : [...messages];
+}
+//# sourceMappingURL=transcript-repair.js.map

package/dist/orchestration/transcript-repair.js.map

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

package/dist/orchestration/turn-loop-guard.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Turn Loop Guard — Abort signal + token budget warning for preventive termination.
+ *
+ * Aligned with Claude Code's multi-condition termination:
+ * 1. AbortSignal from user cancellation
+ * 2. Token budget pre-check (don't send API call if over budget)
+ * 3. max_output_tokens escalation on truncation
+ * 4. Prompt-too-long reactive compact trigger
+ */
+export interface TurnLoopGuardConfig {
+    /** Context window size in tokens. */
+    contextWindowTokens: number;
+    /** Buffer reserved for response (default: 13000). */
+    responseBufferTokens: number;
+    /** Max output tokens for current model. */
+    maxOutputTokens: number;
+    /** Abort signal for user cancellation. */
+    abortSignal?: AbortSignal;
+    /** Whether reactive compact is available. */
+    reactiveCompactEnabled: boolean;
+    /** Whether max_output_tokens escalation is allowed. */
+    outputEscalationEnabled: boolean;
+}
+export type TokenWarningState = {
+    level: "ok";
+} | {
+    level: "warning";
+    usagePercent: number;
+    remainingTokens: number;
+} | {
+    level: "blocking";
+    usagePercent: number;
+    reason: "prompt_too_long" | "budget_exhausted";
+};
+export interface TurnLoopGuardState {
+    /** Current accumulated prompt tokens. */
+    promptTokens: number;
+    /** Whether reactive compact has already been attempted this turn. */
+    hasAttemptedReactiveCompact: boolean;
+    /** Current max_output_tokens (may escalate). */
+    currentMaxOutputTokens: number;
+    /** Number of consecutive max_tokens truncations. */
+    consecutiveTruncations: number;
+    /** Whether the turn has been aborted. */
+    aborted: boolean;
+}
+/** Initial guard state. */
+export declare function createTurnLoopGuardState(config: TurnLoopGuardConfig): TurnLoopGuardState;
+/**
+ * Calculate token warning state before making an API call.
+ * If level is "blocking", do NOT send the API call.
+ */
+export declare function calculateTokenWarningState(state: TurnLoopGuardState, config: TurnLoopGuardConfig): TokenWarningState;
+/**
+ * Handle API error and determine recovery action.
+ */
+export type ApiErrorRecovery = {
+    action: "reactive_compact";
+} | {
+    action: "escalate_output_tokens";
+    newMax: number;
+} | {
+    action: "retry";
+    reason: string;
+} | {
+    action: "abort";
+    reason: string;
+};
+export declare function resolveApiErrorRecovery(error: {
+    type?: string;
+    status?: number;
+    message?: string;
+}, state: TurnLoopGuardState, config: TurnLoopGuardConfig): ApiErrorRecovery;
+/**
+ * Handle finish_reason === "max_tokens" — escalate max_output_tokens.
+ *
+ * CC pattern: double the output token budget up to model max.
+ */
+export declare function resolveOutputTokenEscalation(state: TurnLoopGuardState, config: TurnLoopGuardConfig, modelMaxOutput: number): {
+    shouldEscalate: boolean;
+    newMax: number;
+};
+/**
+ * Check if the turn should be aborted (user cancellation).
+ */
+export declare function shouldAbortTurn(state: TurnLoopGuardState, config: TurnLoopGuardConfig): boolean;
+//# sourceMappingURL=turn-loop-guard.d.ts.map

package/dist/orchestration/turn-loop-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-loop-guard.d.ts","sourceRoot":"","sources":["../../src/orchestration/turn-loop-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,6CAA6C;IAC7C,sBAAsB,EAAE,OAAO,CAAC;IAChC,uDAAuD;IACvD,uBAAuB,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GACf;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,CAAA;CAAE,CAAC;AAEhG,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,qEAAqE;IACrE,2BAA2B,EAAE,OAAO,CAAC;IACrC,gDAAgD;IAChD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,oDAAoD;IACpD,sBAAsB,EAAE,MAAM,CAAC;IAC/B,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,2BAA2B;AAC3B,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,kBAAkB,CAQxF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,mBAAmB,GAC1B,iBAAiB,CAqBnB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,kBAAkB,CAAA;CAAE,GAC9B;IAAE,MAAM,EAAE,wBAAwB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,wBAAgB,uBAAuB,CACrC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3D,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,mBAAmB,GAC1B,gBAAgB,CAuBlB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,mBAAmB,EAC3B,cAAc,EAAE,MAAM,GACrB;IAAE,cAAc,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAgB7C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAO/F"}

package/dist/orchestration/turn-loop-guard.js

@@ -0,0 +1,93 @@
+/**
+ * Turn Loop Guard — Abort signal + token budget warning for preventive termination.
+ *
+ * Aligned with Claude Code's multi-condition termination:
+ * 1. AbortSignal from user cancellation
+ * 2. Token budget pre-check (don't send API call if over budget)
+ * 3. max_output_tokens escalation on truncation
+ * 4. Prompt-too-long reactive compact trigger
+ */
+/** Initial guard state. */
+export function createTurnLoopGuardState(config) {
+    return {
+        promptTokens: 0,
+        hasAttemptedReactiveCompact: false,
+        currentMaxOutputTokens: config.maxOutputTokens,
+        consecutiveTruncations: 0,
+        aborted: config.abortSignal?.aborted ?? false,
+    };
+}
+/**
+ * Calculate token warning state before making an API call.
+ * If level is "blocking", do NOT send the API call.
+ */
+export function calculateTokenWarningState(state, config) {
+    if (state.aborted) {
+        return { level: "blocking", usagePercent: 100, reason: "budget_exhausted" };
+    }
+    const effectiveLimit = config.contextWindowTokens - config.responseBufferTokens - state.currentMaxOutputTokens;
+    const usagePercent = effectiveLimit > 0 ? (state.promptTokens / effectiveLimit) * 100 : 100;
+    if (state.promptTokens >= effectiveLimit) {
+        if (state.hasAttemptedReactiveCompact || !config.reactiveCompactEnabled) {
+            return { level: "blocking", usagePercent, reason: "prompt_too_long" };
+        }
+        return { level: "blocking", usagePercent, reason: "prompt_too_long" };
+    }
+    // Warning at 85%
+    if (usagePercent >= 85) {
+        return { level: "warning", usagePercent, remainingTokens: effectiveLimit - state.promptTokens };
+    }
+    return { level: "ok" };
+}
+export function resolveApiErrorRecovery(error, state, config) {
+    const msg = error.message?.toLowerCase() ?? "";
+    const status = error.status ?? 0;
+    // Prompt too long (413 or specific error message)
+    if (status === 413 || msg.includes("prompt_too_long") || msg.includes("context_length_exceeded")) {
+        if (!state.hasAttemptedReactiveCompact && config.reactiveCompactEnabled) {
+            return { action: "reactive_compact" };
+        }
+        return { action: "abort", reason: "prompt_too_long_unrecoverable" };
+    }
+    // 5xx transient errors
+    if (status >= 500 && status < 600) {
+        return { action: "retry", reason: `server_error_${status}` };
+    }
+    // Rate limit
+    if (status === 429) {
+        return { action: "retry", reason: "rate_limited" };
+    }
+    return { action: "abort", reason: msg || "unknown_error" };
+}
+/**
+ * Handle finish_reason === "max_tokens" — escalate max_output_tokens.
+ *
+ * CC pattern: double the output token budget up to model max.
+ */
+export function resolveOutputTokenEscalation(state, config, modelMaxOutput) {
+    if (!config.outputEscalationEnabled) {
+        return { shouldEscalate: false, newMax: state.currentMaxOutputTokens };
+    }
+    // Don't escalate more than 3 times
+    if (state.consecutiveTruncations >= 3) {
+        return { shouldEscalate: false, newMax: state.currentMaxOutputTokens };
+    }
+    const newMax = Math.min(state.currentMaxOutputTokens * 2, modelMaxOutput);
+    if (newMax <= state.currentMaxOutputTokens) {
+        return { shouldEscalate: false, newMax: state.currentMaxOutputTokens };
+    }
+    return { shouldEscalate: true, newMax };
+}
+/**
+ * Check if the turn should be aborted (user cancellation).
+ */
+export function shouldAbortTurn(state, config) {
+    if (state.aborted)
+        return true;
+    if (config.abortSignal?.aborted) {
+        state.aborted = true;
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=turn-loop-guard.js.map

package/dist/orchestration/turn-loop-guard.js.map

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

package/dist/orchestration/web-browser-policy.d.ts

@@ -0,0 +1,18 @@
+import type { WebCapabilityDescriptorContract, WebCapabilityFamily, WebDegradationTarget, WebEscalationReason, WebTaskMode } from "qlogicagent-runtime-contracts";
+export interface ResolveWebBrowserPolicyInput {
+    capability?: Pick<WebCapabilityDescriptorContract, "capabilityFamily" | "taskMode" | "degradationTarget" | "upgradeTargets" | "escalationReasons" | "supportsLoginState" | "supportsPersistentProfile" | "supportsTransactionality">;
+    needsInteractiveSession?: boolean;
+    needsLoginState?: boolean;
+    needsPersistentSession?: boolean;
+    needsStateChangingAction?: boolean;
+    browserAvailable?: boolean;
+}
+export interface ResolveWebBrowserPolicyResult {
+    selectedCapabilityFamily: WebCapabilityFamily;
+    selectedTaskMode?: WebTaskMode;
+    shouldEscalateToBrowser: boolean;
+    degradationTarget?: WebDegradationTarget;
+    escalationReasons: WebEscalationReason[];
+}
+export declare function resolveWebBrowserPolicy(params: ResolveWebBrowserPolicyInput): ResolveWebBrowserPolicyResult;
+//# sourceMappingURL=web-browser-policy.d.ts.map

package/dist/orchestration/web-browser-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-browser-policy.d.ts","sourceRoot":"","sources":["../../src/orchestration/web-browser-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,+BAA+B,EAC/B,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACZ,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,4BAA4B;IAC3C,UAAU,CAAC,EAAE,IAAI,CACf,+BAA+B,EAC7B,kBAAkB,GAClB,UAAU,GACV,mBAAmB,GACnB,gBAAgB,GAChB,mBAAmB,GACnB,oBAAoB,GACpB,2BAA2B,GAC3B,0BAA0B,CAC7B,CAAC;IACF,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,6BAA6B;IAC5C,wBAAwB,EAAE,mBAAmB,CAAC;IAC9C,gBAAgB,CAAC,EAAE,WAAW,CAAC;IAC/B,uBAAuB,EAAE,OAAO,CAAC;IACjC,iBAAiB,CAAC,EAAE,oBAAoB,CAAC;IACzC,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;CAC1C;AAQD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,4BAA4B,GACnC,6BAA6B,CAuC/B"}