@terminai/core 0.21.0

package/dist/src/core/coreToolScheduler.js

@@ -0,0 +1,1119 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ToolConfirmationOutcome, ApprovalMode, logToolCall, ToolErrorType, ToolCallEvent, logToolOutputTruncated, ToolOutputTruncatedEvent, runInDevTraceSpan, } from '../index.js';
+import { READ_FILE_TOOL_NAME, SHELL_TOOL_NAME } from '../tools/tool-names.js';
+import { supportsMultimodalFunctionResponse } from '../config/models.js';
+import { isModifiableDeclarativeTool, modifyWithEditor, } from '../tools/modifiable-tool.js';
+import * as Diff from 'diff';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { SHELL_TOOL_NAMES } from '../utils/shell-utils.js';
+import { doesToolInvocationMatch } from '../utils/tool-utils.js';
+import { isShellInvocationAllowlisted } from '../utils/shell-permissions.js';
+import levenshtein from 'fast-levenshtein';
+import { ShellToolInvocation } from '../tools/shell.js';
+import { MessageBusType } from '../confirmation-bus/types.js';
+import { fireToolNotificationHook, executeToolWithHooks, } from './coreToolHookTriggers.js';
+import { debugLogger } from '../utils/debugLogger.js';
+/**
+ * Formats tool output for a Gemini FunctionResponse.
+ */
+function createFunctionResponsePart(callId, toolName, output) {
+    return {
+        functionResponse: {
+            id: callId,
+            name: toolName,
+            response: { output },
+        },
+    };
+}
+export function convertToFunctionResponse(toolName, callId, llmContent, model) {
+    if (typeof llmContent === 'string') {
+        return [createFunctionResponsePart(callId, toolName, llmContent)];
+    }
+    const parts = toParts(llmContent);
+    // Separate text from binary types
+    const textParts = [];
+    const inlineDataParts = [];
+    const fileDataParts = [];
+    for (const part of parts) {
+        if (part.text !== undefined) {
+            textParts.push(part.text);
+        }
+        else if (part.inlineData) {
+            inlineDataParts.push(part);
+        }
+        else if (part.fileData) {
+            fileDataParts.push(part);
+        }
+        else if (part.functionResponse) {
+            if (parts.length > 1) {
+                debugLogger.warn('convertToFunctionResponse received multiple parts with a functionResponse. Only the functionResponse will be used, other parts will be ignored');
+            }
+            // Handle passthrough case
+            return [
+                {
+                    functionResponse: {
+                        id: callId,
+                        name: toolName,
+                        response: part.functionResponse.response,
+                    },
+                },
+            ];
+        }
+        // Ignore other part types
+    }
+    // Build the primary response part
+    const part = {
+        functionResponse: {
+            id: callId,
+            name: toolName,
+            response: textParts.length > 0 ? { output: textParts.join('\n') } : {},
+        },
+    };
+    const isMultimodalFRSupported = supportsMultimodalFunctionResponse(model);
+    const siblingParts = [...fileDataParts];
+    if (inlineDataParts.length > 0) {
+        if (isMultimodalFRSupported) {
+            // Nest inlineData if supported by the model
+            part.functionResponse.parts =
+                inlineDataParts;
+        }
+        else {
+            // Otherwise treat as siblings
+            siblingParts.push(...inlineDataParts);
+        }
+    }
+    // Add descriptive text if the response object is empty but we have binary content
+    if (textParts.length === 0 &&
+        (inlineDataParts.length > 0 || fileDataParts.length > 0)) {
+        const totalBinaryItems = inlineDataParts.length + fileDataParts.length;
+        part.functionResponse.response = {
+            output: `Binary content provided (${totalBinaryItems} item(s)).`,
+        };
+    }
+    if (siblingParts.length > 0) {
+        return [part, ...siblingParts];
+    }
+    return [part];
+}
+function toParts(input) {
+    const parts = [];
+    for (const part of Array.isArray(input) ? input : [input]) {
+        if (typeof part === 'string') {
+            parts.push({ text: part });
+        }
+        else if (part) {
+            parts.push(part);
+        }
+    }
+    return parts;
+}
+const createErrorResponse = (request, error, errorType) => ({
+    callId: request.callId,
+    error,
+    responseParts: [
+        {
+            functionResponse: {
+                id: request.callId,
+                name: request.name,
+                response: { error: error.message },
+            },
+        },
+    ],
+    resultDisplay: error.message,
+    errorType,
+    contentLength: error.message.length,
+});
+export async function truncateAndSaveToFile(content, callId, projectTempDir, threshold, truncateLines) {
+    if (content.length <= threshold) {
+        return { content };
+    }
+    let lines = content.split('\n');
+    let fileContent = content;
+    // If the content is long but has few lines, wrap it to enable line-based truncation.
+    if (lines.length <= truncateLines) {
+        const wrapWidth = 120; // A reasonable width for wrapping.
+        const wrappedLines = [];
+        for (const line of lines) {
+            if (line.length > wrapWidth) {
+                for (let i = 0; i < line.length; i += wrapWidth) {
+                    wrappedLines.push(line.substring(i, i + wrapWidth));
+                }
+            }
+            else {
+                wrappedLines.push(line);
+            }
+        }
+        lines = wrappedLines;
+        fileContent = lines.join('\n');
+    }
+    const head = Math.floor(truncateLines / 5);
+    const beginning = lines.slice(0, head);
+    const end = lines.slice(-(truncateLines - head));
+    const truncatedContent = beginning.join('\n') + '\n... [CONTENT TRUNCATED] ...\n' + end.join('\n');
+    // Sanitize callId to prevent path traversal.
+    const safeFileName = `${path.basename(callId)}.output`;
+    const outputFile = path.join(projectTempDir, safeFileName);
+    try {
+        await fs.writeFile(outputFile, fileContent);
+        return {
+            content: `Tool output was too large and has been truncated.
+The full output has been saved to: ${outputFile}
+To read the complete output, use the ${READ_FILE_TOOL_NAME} tool with the absolute file path above. For large files, you can use the offset and limit parameters to read specific sections:
+- ${READ_FILE_TOOL_NAME} tool with offset=0, limit=100 to see the first 100 lines
+- ${READ_FILE_TOOL_NAME} tool with offset=N to skip N lines from the beginning
+- ${READ_FILE_TOOL_NAME} tool with limit=M to read only M lines at a time
+The truncated output below shows the beginning and end of the content. The marker '... [CONTENT TRUNCATED] ...' indicates where content was removed.
+This allows you to efficiently examine different parts of the output without loading the entire file.
+Truncated part of the output:
+${truncatedContent}`,
+            outputFile,
+        };
+    }
+    catch (_error) {
+        return {
+            content: truncatedContent + `\n[Note: Could not save full output to file]`,
+        };
+    }
+}
+export class CoreToolScheduler {
+    // Static WeakMap to track which MessageBus instances already have a handler subscribed
+    // This prevents duplicate subscriptions when multiple CoreToolScheduler instances are created
+    static subscribedMessageBuses = new WeakMap();
+    toolCalls = [];
+    outputUpdateHandler;
+    onAllToolCallsComplete;
+    onToolCallsUpdate;
+    getPreferredEditor;
+    config;
+    isFinalizingToolCalls = false;
+    isScheduling = false;
+    isCancelling = false;
+    requestQueue = [];
+    toolCallQueue = [];
+    completedToolCallsForBatch = [];
+    activeToolPids = new Map();
+    constructor(options) {
+        this.config = options.config;
+        this.outputUpdateHandler = options.outputUpdateHandler;
+        this.onAllToolCallsComplete = options.onAllToolCallsComplete;
+        this.onToolCallsUpdate = options.onToolCallsUpdate;
+        this.getPreferredEditor = options.getPreferredEditor;
+        // Subscribe to message bus for ASK_USER policy decisions
+        // Use a static WeakMap to ensure we only subscribe ONCE per MessageBus instance
+        // This prevents memory leaks when multiple CoreToolScheduler instances are created
+        // (e.g., on every React render, or for each non-interactive tool call)
+        if (this.config.getEnableMessageBusIntegration()) {
+            const messageBus = this.config.getMessageBus();
+            // Check if we've already subscribed a handler to this message bus
+            if (!CoreToolScheduler.subscribedMessageBuses.has(messageBus)) {
+                // Create a shared handler that will be used for this message bus
+                const sharedHandler = (request) => {
+                    // When ASK_USER policy decision is made, respond with requiresUserConfirmation=true
+                    // to tell tools to use their legacy confirmation flow
+                    // eslint-disable-next-line @typescript-eslint/no-floating-promises
+                    messageBus.publish({
+                        type: MessageBusType.TOOL_CONFIRMATION_RESPONSE,
+                        correlationId: request.correlationId,
+                        confirmed: false,
+                        requiresUserConfirmation: true,
+                    });
+                };
+                messageBus.subscribe(MessageBusType.TOOL_CONFIRMATION_REQUEST, sharedHandler);
+                // Store the handler in the WeakMap so we don't subscribe again
+                CoreToolScheduler.subscribedMessageBuses.set(messageBus, sharedHandler);
+            }
+        }
+    }
+    findToolCall(callId) {
+        return this.toolCalls.find((call) => call.request.callId === callId);
+    }
+    buildAuditEvent(toolCall, eventType, extra) {
+        const invocation = 'invocation' in toolCall ? toolCall.invocation : undefined;
+        const provenance = invocation && typeof invocation.getProvenance === 'function'
+            ? invocation.getProvenance()
+            : toolCall.request.provenance;
+        const normalizedProv = this.normalizeProvenance(provenance);
+        const reviewLevel = extra?.reviewLevel ??
+            (toolCall.status === 'awaiting_approval'
+                ? toolCall.confirmationDetails.reviewLevel
+                : undefined);
+        const extraTool = extra?.tool;
+        const { tool: _ignoredTool, ...restExtra } = extra ?? {};
+        const extrasWithoutTool = restExtra;
+        const toolContext = {
+            callId: toolCall.request.callId,
+            toolName: toolCall.request.name,
+            toolKind: extraTool?.toolKind ?? toolCall.tool?.kind,
+            recipe: extraTool?.recipe ?? toolCall.request.recipe,
+            args: extraTool?.args ?? toolCall.request.args,
+            result: extraTool?.result,
+        };
+        return {
+            version: 1,
+            eventType,
+            timestamp: new Date().toISOString(),
+            sessionId: this.config.getSessionId(),
+            provenance: normalizedProv,
+            reviewLevel,
+            tool: toolContext,
+            ...extrasWithoutTool,
+        };
+    }
+    async recordAuditEvent(toolCall, eventType, extra) {
+        if (!toolCall)
+            return;
+        const ledger = this.config.getAuditLedger?.();
+        if (!ledger)
+            return;
+        try {
+            const event = this.buildAuditEvent(toolCall, eventType, extra);
+            await ledger.append(event);
+        }
+        catch (error) {
+            debugLogger.warn(`Failed to record audit event ${eventType}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    setStatusInternal(targetCallId, newStatus, signal, auxiliaryData) {
+        this.toolCalls = this.toolCalls.map((currentCall) => {
+            if (currentCall.request.callId !== targetCallId ||
+                currentCall.status === 'success' ||
+                currentCall.status === 'error' ||
+                currentCall.status === 'cancelled') {
+                return currentCall;
+            }
+            // currentCall is a non-terminal state here and should have startTime and tool.
+            const existingStartTime = currentCall.startTime;
+            const toolInstance = currentCall.tool;
+            const invocation = currentCall.invocation;
+            const outcome = currentCall.outcome;
+            switch (newStatus) {
+                case 'success': {
+                    const durationMs = existingStartTime
+                        ? Date.now() - existingStartTime
+                        : undefined;
+                    return {
+                        request: currentCall.request,
+                        tool: toolInstance,
+                        invocation,
+                        status: 'success',
+                        response: auxiliaryData,
+                        durationMs,
+                        outcome,
+                    };
+                }
+                case 'error': {
+                    const durationMs = existingStartTime
+                        ? Date.now() - existingStartTime
+                        : undefined;
+                    return {
+                        request: currentCall.request,
+                        status: 'error',
+                        tool: toolInstance,
+                        response: auxiliaryData,
+                        durationMs,
+                        outcome,
+                    };
+                }
+                case 'awaiting_approval':
+                    return {
+                        request: currentCall.request,
+                        tool: toolInstance,
+                        status: 'awaiting_approval',
+                        confirmationDetails: auxiliaryData,
+                        startTime: existingStartTime,
+                        outcome,
+                        invocation,
+                    };
+                case 'scheduled':
+                    return {
+                        request: currentCall.request,
+                        tool: toolInstance,
+                        status: 'scheduled',
+                        startTime: existingStartTime,
+                        outcome,
+                        invocation,
+                    };
+                case 'cancelled': {
+                    const durationMs = existingStartTime
+                        ? Date.now() - existingStartTime
+                        : undefined;
+                    // Preserve diff for cancelled edit operations
+                    let resultDisplay = undefined;
+                    if (currentCall.status === 'awaiting_approval') {
+                        const waitingCall = currentCall;
+                        if (waitingCall.confirmationDetails.type === 'edit') {
+                            resultDisplay = {
+                                fileDiff: waitingCall.confirmationDetails.fileDiff,
+                                fileName: waitingCall.confirmationDetails.fileName,
+                                originalContent: waitingCall.confirmationDetails.originalContent,
+                                newContent: waitingCall.confirmationDetails.newContent,
+                            };
+                        }
+                    }
+                    const errorMessage = `[Operation Cancelled] Reason: ${auxiliaryData}`;
+                    return {
+                        request: currentCall.request,
+                        tool: toolInstance,
+                        invocation,
+                        status: 'cancelled',
+                        response: {
+                            callId: currentCall.request.callId,
+                            responseParts: [
+                                {
+                                    functionResponse: {
+                                        id: currentCall.request.callId,
+                                        name: currentCall.request.name,
+                                        response: {
+                                            error: errorMessage,
+                                        },
+                                    },
+                                },
+                            ],
+                            resultDisplay,
+                            error: undefined,
+                            errorType: undefined,
+                            contentLength: errorMessage.length,
+                        },
+                        durationMs,
+                        outcome,
+                    };
+                }
+                case 'validating':
+                    return {
+                        request: currentCall.request,
+                        tool: toolInstance,
+                        status: 'validating',
+                        startTime: existingStartTime,
+                        outcome,
+                        invocation,
+                    };
+                case 'executing':
+                    return {
+                        request: currentCall.request,
+                        tool: toolInstance,
+                        status: 'executing',
+                        startTime: existingStartTime,
+                        outcome,
+                        invocation,
+                    };
+                default: {
+                    const exhaustiveCheck = newStatus;
+                    return exhaustiveCheck;
+                }
+            }
+        });
+        this.notifyToolCallsUpdate();
+    }
+    setArgsInternal(targetCallId, args) {
+        this.toolCalls = this.toolCalls.map((call) => {
+            // We should never be asked to set args on an ErroredToolCall, but
+            // we guard for the case anyways.
+            if (call.request.callId !== targetCallId || call.status === 'error') {
+                return call;
+            }
+            const invocationOrError = this.buildInvocation(call.tool, args);
+            if (invocationOrError instanceof Error) {
+                const response = createErrorResponse(call.request, invocationOrError, ToolErrorType.INVALID_TOOL_PARAMS);
+                return {
+                    request: { ...call.request, args: args },
+                    status: 'error',
+                    tool: call.tool,
+                    response,
+                };
+            }
+            this.attachInvocationProvenance(invocationOrError, call.request);
+            return {
+                ...call,
+                request: { ...call.request, args: args },
+                invocation: invocationOrError,
+            };
+        });
+    }
+    isRunning() {
+        return (this.isFinalizingToolCalls ||
+            this.toolCalls.some((call) => call.status === 'executing' || call.status === 'awaiting_approval'));
+    }
+    buildInvocation(tool, args) {
+        try {
+            return tool.build(args);
+        }
+        catch (e) {
+            if (e instanceof Error) {
+                return e;
+            }
+            return new Error(String(e));
+        }
+    }
+    normalizeProvenance(provenance) {
+        if (!provenance || provenance.length === 0) {
+            return ['unknown'];
+        }
+        const unique = new Set();
+        const merged = [];
+        for (const entry of provenance) {
+            if (!unique.has(entry)) {
+                unique.add(entry);
+                merged.push(entry);
+            }
+        }
+        return merged;
+    }
+    normalizeRequestProvenance(request) {
+        return {
+            ...request,
+            provenance: this.normalizeProvenance(request.provenance),
+        };
+    }
+    attachInvocationProvenance(invocation, request) {
+        const setter = invocation.setProvenance;
+        if (setter) {
+            setter.call(invocation, this.normalizeProvenance(request.provenance));
+        }
+    }
+    reviewLevelRank(level) {
+        if (level === 'C')
+            return 2;
+        if (level === 'B')
+            return 1;
+        return 0;
+    }
+    applyRequestedReviewFloor(details, requestedLevel) {
+        if (!requestedLevel || requestedLevel === 'A') {
+            return details;
+        }
+        if (!details) {
+            return {
+                type: 'info',
+                title: 'Recipe step approval required',
+                prompt: `This recipe step requires at least Level ${requestedLevel} approval.`,
+                reviewLevel: requestedLevel,
+                requiresPin: requestedLevel === 'C',
+                onConfirm: async () => { },
+            };
+        }
+        const requestedRank = this.reviewLevelRank(requestedLevel);
+        const existingRank = this.reviewLevelRank(details.reviewLevel);
+        const nextLevel = requestedRank > existingRank ? requestedLevel : details.reviewLevel;
+        return {
+            ...details,
+            reviewLevel: nextLevel,
+            requiresPin: details.requiresPin || requestedLevel === 'C',
+        };
+    }
+    /**
+     * Generates a suggestion string for a tool name that was not found in the registry.
+     * It finds the closest matches based on Levenshtein distance.
+     * @param unknownToolName The tool name that was not found.
+     * @param topN The number of suggestions to return. Defaults to 3.
+     * @returns A suggestion string like " Did you mean 'tool'?" or " Did you mean one of: 'tool1', 'tool2'?", or an empty string if no suggestions are found.
+     */
+    getToolSuggestion(unknownToolName, topN = 3) {
+        const allToolNames = this.config.getToolRegistry().getAllToolNames();
+        const matches = allToolNames.map((toolName) => ({
+            name: toolName,
+            distance: levenshtein.get(unknownToolName, toolName),
+        }));
+        matches.sort((a, b) => a.distance - b.distance);
+        const topNResults = matches.slice(0, topN);
+        if (topNResults.length === 0) {
+            return '';
+        }
+        const suggestedNames = topNResults
+            .map((match) => `"${match.name}"`)
+            .join(', ');
+        if (topNResults.length > 1) {
+            return ` Did you mean one of: ${suggestedNames}?`;
+        }
+        else {
+            return ` Did you mean ${suggestedNames}?`;
+        }
+    }
+    schedule(request, signal) {
+        return runInDevTraceSpan({ name: 'schedule' }, async ({ metadata: spanMetadata }) => {
+            spanMetadata.input = request;
+            if (this.isRunning() || this.isScheduling) {
+                return new Promise((resolve, reject) => {
+                    const abortHandler = () => {
+                        // Find and remove the request from the queue
+                        const index = this.requestQueue.findIndex((item) => item.request === request);
+                        if (index > -1) {
+                            this.requestQueue.splice(index, 1);
+                            reject(new Error('Tool call cancelled while in queue.'));
+                        }
+                    };
+                    signal.addEventListener('abort', abortHandler, { once: true });
+                    this.requestQueue.push({
+                        request,
+                        signal,
+                        resolve: () => {
+                            signal.removeEventListener('abort', abortHandler);
+                            resolve();
+                        },
+                        reject: (reason) => {
+                            signal.removeEventListener('abort', abortHandler);
+                            reject(reason);
+                        },
+                    });
+                });
+            }
+            return this._schedule(request, signal);
+        });
+    }
+    cancelAll(signal) {
+        if (this.isCancelling) {
+            return;
+        }
+        this.isCancelling = true;
+        // Cancel the currently active tool call, if there is one.
+        if (this.toolCalls.length > 0) {
+            const activeCall = this.toolCalls[0];
+            // Only cancel if it's in a cancellable state.
+            if (activeCall.status === 'awaiting_approval' ||
+                activeCall.status === 'executing' ||
+                activeCall.status === 'scheduled' ||
+                activeCall.status === 'validating') {
+                this.setStatusInternal(activeCall.request.callId, 'cancelled', signal, 'User cancelled the operation.');
+            }
+        }
+        // Clear the queue and mark all queued items as cancelled for completion reporting.
+        this._cancelAllQueuedCalls();
+        // Finalize the batch immediately.
+        void this.checkAndNotifyCompletion(signal);
+    }
+    async _schedule(request, signal) {
+        this.isScheduling = true;
+        this.isCancelling = false;
+        try {
+            if (this.isRunning()) {
+                throw new Error('Cannot schedule new tool calls while other tool calls are actively running (executing or awaiting approval).');
+            }
+            const requestsToProcess = Array.isArray(request) ? request : [request];
+            this.completedToolCallsForBatch = [];
+            const newToolCalls = requestsToProcess.map((reqInfo) => {
+                const normalizedRequest = this.normalizeRequestProvenance(reqInfo);
+                const toolInstance = this.config
+                    .getToolRegistry()
+                    .getTool(normalizedRequest.name);
+                if (!toolInstance) {
+                    const suggestion = this.getToolSuggestion(normalizedRequest.name);
+                    const errorMessage = `Tool "${normalizedRequest.name}" not found in registry. Tools must use the exact names that are registered.${suggestion}`;
+                    return {
+                        status: 'error',
+                        request: normalizedRequest,
+                        response: createErrorResponse(normalizedRequest, new Error(errorMessage), ToolErrorType.TOOL_NOT_REGISTERED),
+                        durationMs: 0,
+                    };
+                }
+                const invocationOrError = this.buildInvocation(toolInstance, normalizedRequest.args);
+                if (invocationOrError instanceof Error) {
+                    return {
+                        status: 'error',
+                        request: normalizedRequest,
+                        tool: toolInstance,
+                        response: createErrorResponse(normalizedRequest, invocationOrError, ToolErrorType.INVALID_TOOL_PARAMS),
+                        durationMs: 0,
+                    };
+                }
+                this.attachInvocationProvenance(invocationOrError, normalizedRequest);
+                return {
+                    status: 'validating',
+                    request: normalizedRequest,
+                    tool: toolInstance,
+                    invocation: invocationOrError,
+                    startTime: Date.now(),
+                };
+            });
+            this.toolCallQueue.push(...newToolCalls);
+            await this._processNextInQueue(signal);
+        }
+        finally {
+            this.isScheduling = false;
+        }
+    }
+    async _processNextInQueue(signal) {
+        // If there's already a tool being processed, or the queue is empty, stop.
+        if (this.toolCalls.length > 0 || this.toolCallQueue.length === 0) {
+            return;
+        }
+        // If cancellation happened between steps, handle it.
+        if (signal.aborted) {
+            this._cancelAllQueuedCalls();
+            // Finalize the batch.
+            await this.checkAndNotifyCompletion(signal);
+            return;
+        }
+        const toolCall = this.toolCallQueue.shift();
+        // This is now the single active tool call.
+        this.toolCalls = [toolCall];
+        this.notifyToolCallsUpdate();
+        // Handle tools that were already errored during creation.
+        if (toolCall.status === 'error') {
+            // An error during validation means this "active" tool is already complete.
+            // We need to check for batch completion to either finish or process the next in queue.
+            await this.checkAndNotifyCompletion(signal);
+            return;
+        }
+        // This logic is moved from the old `for` loop in `_schedule`.
+        if (toolCall.status === 'validating') {
+            const { request: reqInfo, invocation } = toolCall;
+            try {
+                if (signal.aborted) {
+                    this.setStatusInternal(reqInfo.callId, 'cancelled', signal, 'Tool call cancelled by user.');
+                    // The completion check will handle the cascade.
+                    await this.checkAndNotifyCompletion(signal);
+                    return;
+                }
+                const confirmationDetails = this.applyRequestedReviewFloor(await invocation.shouldConfirmExecute(signal), toolCall.request.requestedReviewLevel);
+                if (!confirmationDetails) {
+                    this.setToolCallOutcome(reqInfo.callId, ToolConfirmationOutcome.ProceedAlways);
+                    this.setStatusInternal(reqInfo.callId, 'scheduled', signal);
+                    void this.recordAuditEvent(this.findToolCall(reqInfo.callId), 'tool.requested');
+                }
+                else {
+                    const requiresPin = confirmationDetails.requiresPin === true;
+                    if (this.isAutoApproved(toolCall) && !requiresPin) {
+                        this.setToolCallOutcome(reqInfo.callId, ToolConfirmationOutcome.ProceedAlways);
+                        this.setStatusInternal(reqInfo.callId, 'scheduled', signal);
+                        void this.recordAuditEvent(this.findToolCall(reqInfo.callId), 'tool.requested');
+                    }
+                    else {
+                        if (!this.config.isInteractive()) {
+                            throw new Error(`Tool execution for "${toolCall.tool.displayName || toolCall.tool.name}" requires user confirmation, which is not supported in non-interactive mode.`);
+                        }
+                        // Fire Notification hook before showing confirmation to user
+                        const messageBus = this.config.getMessageBus();
+                        const hooksEnabled = this.config.getEnableHooks();
+                        if (hooksEnabled && messageBus) {
+                            await fireToolNotificationHook(messageBus, confirmationDetails);
+                        }
+                        // Allow IDE to resolve confirmation
+                        if (confirmationDetails.type === 'edit' &&
+                            confirmationDetails.ideConfirmation) {
+                            // eslint-disable-next-line @typescript-eslint/no-floating-promises
+                            confirmationDetails.ideConfirmation.then((resolution) => {
+                                if (resolution.status === 'accepted') {
+                                    // eslint-disable-next-line @typescript-eslint/no-floating-promises
+                                    this.handleConfirmationResponse(reqInfo.callId, confirmationDetails.onConfirm, ToolConfirmationOutcome.ProceedOnce, signal);
+                                }
+                                else {
+                                    // eslint-disable-next-line @typescript-eslint/no-floating-promises
+                                    this.handleConfirmationResponse(reqInfo.callId, confirmationDetails.onConfirm, ToolConfirmationOutcome.Cancel, signal);
+                                }
+                            });
+                        }
+                        const originalOnConfirm = confirmationDetails.onConfirm;
+                        const wrappedConfirmationDetails = {
+                            ...confirmationDetails,
+                            onConfirm: (outcome, payload) => this.handleConfirmationResponse(reqInfo.callId, originalOnConfirm, outcome, signal, payload),
+                        };
+                        this.setStatusInternal(reqInfo.callId, 'awaiting_approval', signal, wrappedConfirmationDetails);
+                        void this.recordAuditEvent(this.findToolCall(reqInfo.callId), 'tool.awaiting_approval', {
+                            reviewLevel: wrappedConfirmationDetails.type !== 'mcp'
+                                ? wrappedConfirmationDetails.reviewLevel
+                                : undefined,
+                        });
+                    }
+                }
+            }
+            catch (error) {
+                if (signal.aborted) {
+                    this.setStatusInternal(reqInfo.callId, 'cancelled', signal, 'Tool call cancelled by user.');
+                    await this.checkAndNotifyCompletion(signal);
+                }
+                else {
+                    this.setStatusInternal(reqInfo.callId, 'error', signal, createErrorResponse(reqInfo, error instanceof Error ? error : new Error(String(error)), ToolErrorType.UNHANDLED_EXCEPTION));
+                    await this.checkAndNotifyCompletion(signal);
+                }
+            }
+        }
+        await this.attemptExecutionOfScheduledCalls(signal);
+    }
+    async handleConfirmationResponse(callId, originalOnConfirm, outcome, signal, payload) {
+        const toolCall = this.toolCalls.find((c) => c.request.callId === callId && c.status === 'awaiting_approval');
+        if (toolCall && toolCall.status === 'awaiting_approval') {
+            try {
+                const confirmationDetails = toolCall.confirmationDetails;
+                if (confirmationDetails?.requiresPin &&
+                    outcome !== ToolConfirmationOutcome.Cancel) {
+                    const pinLength = confirmationDetails.pinLength ?? 6;
+                    const enteredPin = payload?.pin ?? '';
+                    if (!/^\d+$/.test(enteredPin) || enteredPin.length !== pinLength) {
+                        throw new Error(`Enter a ${pinLength}-digit PIN to proceed.`);
+                    }
+                    const configuredPin = this.config.getApprovalPin();
+                    if (enteredPin !== configuredPin) {
+                        throw new Error('Incorrect PIN. Level C action denied for security reasons.');
+                    }
+                }
+                await originalOnConfirm(outcome, payload);
+            }
+            catch (error) {
+                // Handle errors from onConfirm (e.g., PIN validation failures)
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                this.setStatusInternal(callId, 'error', signal, createErrorResponse(toolCall.request, error instanceof Error ? error : new Error(errorMessage), ToolErrorType.UNHANDLED_EXCEPTION));
+                await this.checkAndNotifyCompletion(signal);
+                return;
+            }
+            const eventType = outcome === ToolConfirmationOutcome.Cancel
+                ? 'tool.denied'
+                : 'tool.approved';
+            const reviewLevel = toolCall.confirmationDetails.type !== 'mcp'
+                ? toolCall.confirmationDetails.reviewLevel
+                : undefined;
+            void this.recordAuditEvent(toolCall, eventType, { reviewLevel });
+        }
+        this.setToolCallOutcome(callId, outcome);
+        if (outcome === ToolConfirmationOutcome.Cancel || signal.aborted) {
+            // Instead of just cancelling one tool, trigger the full cancel cascade.
+            this.cancelAll(signal);
+            return; // `cancelAll` calls `checkAndNotifyCompletion`, so we can exit here.
+        }
+        else if (outcome === ToolConfirmationOutcome.ModifyWithEditor) {
+            const waitingToolCall = toolCall;
+            if (isModifiableDeclarativeTool(waitingToolCall.tool)) {
+                const modifyContext = waitingToolCall.tool.getModifyContext(signal);
+                const editorType = this.getPreferredEditor();
+                if (!editorType) {
+                    return;
+                }
+                this.setStatusInternal(callId, 'awaiting_approval', signal, {
+                    ...waitingToolCall.confirmationDetails,
+                    isModifying: true,
+                });
+                const contentOverrides = waitingToolCall.confirmationDetails.type === 'edit'
+                    ? {
+                        currentContent: waitingToolCall.confirmationDetails.originalContent,
+                        proposedContent: waitingToolCall.confirmationDetails.newContent,
+                    }
+                    : undefined;
+                const { updatedParams, updatedDiff } = await modifyWithEditor(waitingToolCall.request.args, modifyContext, editorType, signal, contentOverrides);
+                this.setArgsInternal(callId, updatedParams);
+                this.setStatusInternal(callId, 'awaiting_approval', signal, {
+                    ...waitingToolCall.confirmationDetails,
+                    fileDiff: updatedDiff,
+                    isModifying: false,
+                });
+            }
+        }
+        else {
+            // If the client provided new content, apply it before scheduling.
+            if (payload?.newContent && toolCall) {
+                await this._applyInlineModify(toolCall, payload, signal);
+            }
+            this.setStatusInternal(callId, 'scheduled', signal);
+        }
+        await this.attemptExecutionOfScheduledCalls(signal);
+    }
+    /**
+     * Applies user-provided content changes to a tool call that is awaiting confirmation.
+     * This method updates the tool's arguments and refreshes the confirmation prompt with a new diff
+     * before the tool is scheduled for execution.
+     * @private
+     */
+    async _applyInlineModify(toolCall, payload, signal) {
+        if (toolCall.confirmationDetails.type !== 'edit' ||
+            !isModifiableDeclarativeTool(toolCall.tool)) {
+            return;
+        }
+        const modifyContext = toolCall.tool.getModifyContext(signal);
+        const currentContent = await modifyContext.getCurrentContent(toolCall.request.args);
+        if (payload.newContent === undefined) {
+            return;
+        }
+        const updatedParams = modifyContext.createUpdatedParams(currentContent, payload.newContent, toolCall.request.args);
+        const updatedDiff = Diff.createPatch(modifyContext.getFilePath(toolCall.request.args), currentContent, payload.newContent, 'Current', 'Proposed');
+        this.setArgsInternal(toolCall.request.callId, updatedParams);
+        this.setStatusInternal(toolCall.request.callId, 'awaiting_approval', signal, {
+            ...toolCall.confirmationDetails,
+            fileDiff: updatedDiff,
+        });
+    }
+    async attemptExecutionOfScheduledCalls(signal) {
+        const allCallsFinalOrScheduled = this.toolCalls.every((call) => call.status === 'scheduled' ||
+            call.status === 'cancelled' ||
+            call.status === 'success' ||
+            call.status === 'error');
+        if (allCallsFinalOrScheduled) {
+            const callsToExecute = this.toolCalls.filter((call) => call.status === 'scheduled');
+            for (const toolCall of callsToExecute) {
+                if (toolCall.status !== 'scheduled')
+                    continue;
+                const scheduledCall = toolCall;
+                const { callId, name: toolName } = scheduledCall.request;
+                const invocation = scheduledCall.invocation;
+                this.setStatusInternal(callId, 'executing', signal);
+                void this.recordAuditEvent(this.findToolCall(callId), 'tool.execution_started');
+                const liveOutputCallback = scheduledCall.tool.canUpdateOutput && this.outputUpdateHandler
+                    ? (outputChunk) => {
+                        if (this.outputUpdateHandler) {
+                            this.outputUpdateHandler(callId, outputChunk);
+                        }
+                        this.toolCalls = this.toolCalls.map((tc) => tc.request.callId === callId && tc.status === 'executing'
+                            ? { ...tc, liveOutput: outputChunk }
+                            : tc);
+                        this.notifyToolCallsUpdate();
+                    }
+                    : undefined;
+                const shellExecutionConfig = this.config.getShellExecutionConfig();
+                const hooksEnabled = this.config.getEnableHooks();
+                const messageBus = this.config.getMessageBus();
+                await runInDevTraceSpan({
+                    name: toolCall.tool.name,
+                    attributes: { type: 'tool-call' },
+                }, async ({ metadata: spanMetadata }) => {
+                    spanMetadata.input = {
+                        request: toolCall.request,
+                    };
+                    // TODO: Refactor to remove special casing for ShellToolInvocation.
+                    // Introduce a generic callbacks object for the execute method to handle
+                    // things like `onPid` and `onLiveOutput`. This will make the scheduler
+                    // agnostic to the invocation type.
+                    let promise;
+                    if (invocation instanceof ShellToolInvocation) {
+                        const setPidCallback = (pid) => {
+                            this.activeToolPids.set(callId, pid);
+                            this.toolCalls = this.toolCalls.map((tc) => tc.request.callId === callId && tc.status === 'executing'
+                                ? { ...tc, pid }
+                                : tc);
+                            this.notifyToolCallsUpdate();
+                        };
+                        promise = executeToolWithHooks(invocation, toolName, signal, messageBus, hooksEnabled, liveOutputCallback, shellExecutionConfig, setPidCallback);
+                    }
+                    else {
+                        promise = executeToolWithHooks(invocation, toolName, signal, messageBus, hooksEnabled, liveOutputCallback, shellExecutionConfig);
+                    }
+                    try {
+                        const toolResult = await promise;
+                        spanMetadata.output = toolResult;
+                        if (signal.aborted) {
+                            this.setStatusInternal(callId, 'cancelled', signal, 'User cancelled tool execution.');
+                        }
+                        else if (toolResult.error === undefined) {
+                            let content = toolResult.llmContent;
+                            let outputFile = undefined;
+                            const contentLength = typeof content === 'string' ? content.length : undefined;
+                            if (typeof content === 'string' &&
+                                toolName === SHELL_TOOL_NAME &&
+                                this.config.getEnableToolOutputTruncation() &&
+                                this.config.getTruncateToolOutputThreshold() > 0 &&
+                                this.config.getTruncateToolOutputLines() > 0) {
+                                const originalContentLength = content.length;
+                                const threshold = this.config.getTruncateToolOutputThreshold();
+                                const lines = this.config.getTruncateToolOutputLines();
+                                const truncatedResult = await truncateAndSaveToFile(content, callId, this.config.storage.getProjectTempDir(), threshold, lines);
+                                content = truncatedResult.content;
+                                outputFile = truncatedResult.outputFile;
+                                if (outputFile) {
+                                    logToolOutputTruncated(this.config, new ToolOutputTruncatedEvent(scheduledCall.request.prompt_id, {
+                                        toolName,
+                                        originalContentLength,
+                                        truncatedContentLength: content.length,
+                                        threshold,
+                                        lines,
+                                    }));
+                                }
+                            }
+                            const response = convertToFunctionResponse(toolName, callId, content, this.config.getActiveModel());
+                            const successResponse = {
+                                callId,
+                                responseParts: response,
+                                resultDisplay: toolResult.returnDisplay,
+                                error: undefined,
+                                errorType: undefined,
+                                outputFile,
+                                contentLength,
+                            };
+                            this.setStatusInternal(callId, 'success', signal, successResponse);
+                            void this.recordAuditEvent(this.findToolCall(callId), 'tool.execution_finished', {
+                                tool: {
+                                    result: {
+                                        success: true,
+                                        outputBytes: contentLength,
+                                    },
+                                },
+                            });
+                        }
+                        else {
+                            // It is a failure
+                            const error = new Error(toolResult.error.message);
+                            const errorResponse = createErrorResponse(scheduledCall.request, error, toolResult.error.type);
+                            this.setStatusInternal(callId, 'error', signal, errorResponse);
+                            void this.recordAuditEvent(this.findToolCall(callId), 'tool.execution_failed', {
+                                tool: {
+                                    result: {
+                                        success: false,
+                                        errorType: toolResult.error.type,
+                                    },
+                                },
+                            });
+                        }
+                    }
+                    catch (executionError) {
+                        spanMetadata.error = executionError;
+                        if (signal.aborted) {
+                            this.setStatusInternal(callId, 'cancelled', signal, 'User cancelled tool execution.');
+                            void this.recordAuditEvent(this.findToolCall(callId), 'tool.execution_failed', {
+                                tool: {
+                                    result: {
+                                        success: false,
+                                        errorType: ToolErrorType.UNHANDLED_EXCEPTION,
+                                    },
+                                },
+                            });
+                        }
+                        else {
+                            this.setStatusInternal(callId, 'error', signal, createErrorResponse(scheduledCall.request, executionError instanceof Error
+                                ? executionError
+                                : new Error(String(executionError)), ToolErrorType.UNHANDLED_EXCEPTION));
+                            void this.recordAuditEvent(this.findToolCall(callId), 'tool.execution_failed', {
+                                tool: {
+                                    result: {
+                                        success: false,
+                                        errorType: ToolErrorType.UNHANDLED_EXCEPTION,
+                                    },
+                                },
+                            });
+                        }
+                    }
+                    await this.checkAndNotifyCompletion(signal);
+                });
+            }
+        }
+    }
+    async checkAndNotifyCompletion(signal) {
+        // This method is now only concerned with the single active tool call.
+        if (this.toolCalls.length === 0) {
+            // It's possible to be called when a batch is cancelled before any tool has started.
+            if (signal.aborted && this.toolCallQueue.length > 0) {
+                this._cancelAllQueuedCalls();
+            }
+        }
+        else {
+            const activeCall = this.toolCalls[0];
+            const isTerminal = activeCall.status === 'success' ||
+                activeCall.status === 'error' ||
+                activeCall.status === 'cancelled';
+            // If the active tool is not in a terminal state (e.g., it's 'executing' or 'awaiting_approval'),
+            // then the scheduler is still busy or paused. We should not proceed.
+            if (!isTerminal) {
+                return;
+            }
+            // The active tool is finished. Move it to the completed batch.
+            const completedCall = activeCall;
+            this.completedToolCallsForBatch.push(completedCall);
+            logToolCall(this.config, new ToolCallEvent(completedCall));
+            // Clear the active tool slot. This is crucial for the sequential processing.
+            this.toolCalls = [];
+        }
+        // Now, check if the entire batch is complete.
+        // The batch is complete if the queue is empty or the operation was cancelled.
+        if (this.toolCallQueue.length === 0 || signal.aborted) {
+            if (signal.aborted) {
+                this._cancelAllQueuedCalls();
+            }
+            // If there's nothing to report and we weren't cancelled, we can stop.
+            // But if we were cancelled, we must proceed to potentially start the next queued request.
+            if (this.completedToolCallsForBatch.length === 0 && !signal.aborted) {
+                return;
+            }
+            if (this.onAllToolCallsComplete) {
+                this.isFinalizingToolCalls = true;
+                // Use the batch array, not the (now empty) active array.
+                await this.onAllToolCallsComplete(this.completedToolCallsForBatch);
+                this.completedToolCallsForBatch = []; // Clear after reporting.
+                this.isFinalizingToolCalls = false;
+            }
+            this.isCancelling = false;
+            this.notifyToolCallsUpdate();
+            // After completion of the entire batch, process the next item in the main request queue.
+            if (this.requestQueue.length > 0) {
+                const next = this.requestQueue.shift();
+                this._schedule(next.request, next.signal)
+                    .then(next.resolve)
+                    .catch(next.reject);
+            }
+        }
+        else {
+            // The batch is not yet complete, so continue processing the current batch sequence.
+            await this._processNextInQueue(signal);
+        }
+    }
+    _cancelAllQueuedCalls() {
+        while (this.toolCallQueue.length > 0) {
+            const queuedCall = this.toolCallQueue.shift();
+            // Don't cancel tools that already errored during validation.
+            if (queuedCall.status === 'error') {
+                this.completedToolCallsForBatch.push(queuedCall);
+                continue;
+            }
+            const durationMs = 'startTime' in queuedCall && queuedCall.startTime
+                ? Date.now() - queuedCall.startTime
+                : undefined;
+            const errorMessage = '[Operation Cancelled] User cancelled the operation.';
+            this.completedToolCallsForBatch.push({
+                request: queuedCall.request,
+                tool: queuedCall.tool,
+                invocation: queuedCall.invocation,
+                status: 'cancelled',
+                response: {
+                    callId: queuedCall.request.callId,
+                    responseParts: [
+                        {
+                            functionResponse: {
+                                id: queuedCall.request.callId,
+                                name: queuedCall.request.name,
+                                response: {
+                                    error: errorMessage,
+                                },
+                            },
+                        },
+                    ],
+                    resultDisplay: undefined,
+                    error: undefined,
+                    errorType: undefined,
+                    contentLength: errorMessage.length,
+                },
+                durationMs,
+                outcome: ToolConfirmationOutcome.Cancel,
+            });
+        }
+    }
+    notifyToolCallsUpdate() {
+        if (this.onToolCallsUpdate) {
+            this.onToolCallsUpdate([
+                ...this.completedToolCallsForBatch,
+                ...this.toolCalls,
+                ...this.toolCallQueue,
+            ]);
+        }
+    }
+    setToolCallOutcome(callId, outcome) {
+        this.toolCalls = this.toolCalls.map((call) => {
+            if (call.request.callId !== callId)
+                return call;
+            return {
+                ...call,
+                outcome,
+            };
+        });
+    }
+    isAutoApproved(toolCall) {
+        if (this.config.getApprovalMode() === ApprovalMode.YOLO) {
+            return true;
+        }
+        const allowedTools = this.config.getAllowedTools() || [];
+        const { tool, invocation } = toolCall;
+        const toolName = typeof tool === 'string' ? tool : tool.name;
+        if (SHELL_TOOL_NAMES.includes(toolName)) {
+            return isShellInvocationAllowlisted(invocation, allowedTools);
+        }
+        return doesToolInvocationMatch(tool, invocation, allowedTools);
+    }
+}
+//# sourceMappingURL=coreToolScheduler.js.map