@office-ai/aioncli-core 0.26.0 → 0.30.1

package/dist/src/scheduler/confirmation.js

@@ -0,0 +1,204 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { on } from 'node:events';
+import { randomUUID } from 'node:crypto';
+import { MessageBusType, } from '../confirmation-bus/types.js';
+import { ToolConfirmationOutcome, } from '../tools/tools.js';
+import { CoreToolCallStatus, } from './types.js';
+import { resolveEditorAsync, NO_EDITOR_AVAILABLE_ERROR, } from '../utils/editor.js';
+import { debugLogger } from '../utils/debugLogger.js';
+import { coreEvents } from '../utils/events.js';
+/**
+ * Waits for a confirmation response with the matching correlationId.
+ *
+ * NOTE: It is the caller's responsibility to manage the lifecycle of this wait
+ * via the provided AbortSignal. To prevent memory leaks and "zombie" listeners
+ * in the event of a lost connection (e.g. IDE crash), it is strongly recommended
+ * to use a signal with a timeout (e.g. AbortSignal.timeout(ms)).
+ *
+ * @param messageBus The MessageBus to listen on.
+ * @param correlationId The correlationId to match.
+ * @param signal An AbortSignal to cancel the wait and cleanup listeners.
+ */
+export async function awaitConfirmation(messageBus, correlationId, signal) {
+    if (signal.aborted) {
+        throw new Error('Operation cancelled');
+    }
+    try {
+        for await (const [msg] of on(messageBus, MessageBusType.TOOL_CONFIRMATION_RESPONSE, { signal })) {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+            const response = msg;
+            if (response.correlationId === correlationId) {
+                return {
+                    outcome: response.outcome ??
+                        // TODO: Remove legacy confirmed boolean fallback once migration complete
+                        (response.confirmed
+                            ? ToolConfirmationOutcome.ProceedOnce
+                            : ToolConfirmationOutcome.Cancel),
+                    payload: response.payload,
+                };
+            }
+        }
+    }
+    catch (error) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+        if (signal.aborted || error.name === 'AbortError') {
+            throw new Error('Operation cancelled');
+        }
+        throw error;
+    }
+    // This point should only be reached if the iterator closes without resolving,
+    // which generally means the signal was aborted.
+    throw new Error('Operation cancelled');
+}
+/**
+ * Manages the interactive confirmation loop, handling user modifications
+ * via inline diffs or external editors (Vim).
+ */
+export async function resolveConfirmation(toolCall, signal, deps) {
+    const { state, onWaitingForConfirmation } = deps;
+    const callId = toolCall.request.callId;
+    let outcome = ToolConfirmationOutcome.ModifyWithEditor;
+    let lastDetails;
+    // Loop exists to allow the user to modify the parameters and see the new
+    // diff.
+    while (outcome === ToolConfirmationOutcome.ModifyWithEditor) {
+        if (signal.aborted)
+            throw new Error('Operation cancelled');
+        const currentCall = state.getToolCall(callId);
+        if (!currentCall || !('invocation' in currentCall)) {
+            throw new Error(`Tool call ${callId} lost during confirmation loop`);
+        }
+        const currentInvocation = currentCall.invocation;
+        const details = await currentInvocation.shouldConfirmExecute(signal);
+        if (!details) {
+            outcome = ToolConfirmationOutcome.ProceedOnce;
+            break;
+        }
+        await notifyHooks(deps, details);
+        const correlationId = randomUUID();
+        const serializableDetails = details;
+        lastDetails = serializableDetails;
+        const ideConfirmation = 'ideConfirmation' in details ? details.ideConfirmation : undefined;
+        state.updateStatus(callId, CoreToolCallStatus.AwaitingApproval, {
+            confirmationDetails: serializableDetails,
+            correlationId,
+        });
+        onWaitingForConfirmation?.(true);
+        const response = await waitForConfirmation(deps.messageBus, correlationId, signal, ideConfirmation);
+        onWaitingForConfirmation?.(false);
+        outcome = response.outcome;
+        if ('onConfirm' in details && typeof details.onConfirm === 'function') {
+            await details.onConfirm(outcome, response.payload);
+        }
+        if (outcome === ToolConfirmationOutcome.ModifyWithEditor) {
+            const modResult = await handleExternalModification(deps, toolCall, signal);
+            // Editor is not available - emit error feedback and stay in the loop
+            // to return to previous confirmation screen.
+            if (modResult.error) {
+                coreEvents.emitFeedback('error', modResult.error);
+            }
+        }
+        else if (response.payload && 'newContent' in response.payload) {
+            await handleInlineModification(deps, toolCall, response.payload, signal);
+            outcome = ToolConfirmationOutcome.ProceedOnce;
+        }
+    }
+    return { outcome, lastDetails };
+}
+/**
+ * Fires hook notifications.
+ */
+async function notifyHooks(deps, details) {
+    if (deps.config.getHookSystem()) {
+        await deps.config.getHookSystem()?.fireToolNotificationEvent({
+            ...details,
+            // Pass no-op onConfirm to satisfy type definition; side-effects via
+            // callbacks are disallowed.
+            onConfirm: async () => { },
+        });
+    }
+}
+/**
+ * Handles modification via an external editor (e.g. Vim).
+ * Returns a result indicating success or failure with an error message.
+ */
+async function handleExternalModification(deps, toolCall, signal) {
+    const { state, modifier, getPreferredEditor } = deps;
+    const preferredEditor = getPreferredEditor();
+    const editor = await resolveEditorAsync(preferredEditor, signal);
+    if (!editor) {
+        // No editor available - return failure with error message
+        return { error: NO_EDITOR_AVAILABLE_ERROR };
+    }
+    const result = await modifier.handleModifyWithEditor(
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    state.firstActiveCall, editor, signal);
+    if (result) {
+        const newInvocation = toolCall.tool.build(result.updatedParams);
+        state.updateArgs(toolCall.request.callId, result.updatedParams, newInvocation);
+    }
+    return {};
+}
+/**
+ * Handles modification via inline payload (e.g. from IDE or TUI).
+ */
+async function handleInlineModification(deps, toolCall, payload, signal) {
+    const { state, modifier } = deps;
+    const result = await modifier.applyInlineModify(
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+    state.firstActiveCall, payload, signal);
+    if (result) {
+        const newInvocation = toolCall.tool.build(result.updatedParams);
+        state.updateArgs(toolCall.request.callId, result.updatedParams, newInvocation);
+    }
+}
+/**
+ * Waits for user confirmation, allowing either the MessageBus (TUI) or IDE to
+ * resolve it.
+ */
+async function waitForConfirmation(messageBus, correlationId, signal, ideConfirmation) {
+    // Create a controller to abort the bus listener if the IDE wins (or vice versa)
+    const raceController = new AbortController();
+    const raceSignal = raceController.signal;
+    // Propagate the parent signal's abort to our race controller
+    const onParentAbort = () => raceController.abort();
+    if (signal.aborted) {
+        raceController.abort();
+    }
+    else {
+        signal.addEventListener('abort', onParentAbort);
+    }
+    try {
+        const busPromise = awaitConfirmation(messageBus, correlationId, raceSignal);
+        if (!ideConfirmation) {
+            return await busPromise;
+        }
+        // Wrap IDE promise to match ConfirmationResult signature
+        const idePromise = ideConfirmation
+            .then((resolution) => ({
+            outcome: resolution.status === 'accepted'
+                ? ToolConfirmationOutcome.ProceedOnce
+                : ToolConfirmationOutcome.Cancel,
+            payload: resolution.content
+                ? { newContent: resolution.content }
+                : undefined,
+        }))
+            .catch((error) => {
+            debugLogger.warn('Error waiting for confirmation via IDE', error);
+            // Return a never-resolving promise so the race continues with the bus
+            return new Promise(() => { });
+        });
+        return await Promise.race([busPromise, idePromise]);
+    }
+    finally {
+        // Cleanup: remove parent listener and abort the race signal to ensure
+        // the losing listener (e.g. bus iterator) is closed.
+        signal.removeEventListener('abort', onParentAbort);
+        raceController.abort();
+    }
+}
+//# sourceMappingURL=confirmation.js.map

package/dist/src/scheduler/confirmation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation.js","sourceRoot":"","sources":["../../../src/scheduler/confirmation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,cAAc,GAGf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,uBAAuB,GAGxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAGL,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAIpB,OAAO,EACL,kBAAkB,EAElB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAehD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAsB,EACtB,aAAqB,EACrB,MAAmB;IAEnB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAC1B,UAAU,EACV,cAAc,CAAC,0BAA0B,EACzC,EAAE,MAAM,EAAE,CACX,EAAE,CAAC;YACF,uEAAuE;YACvE,MAAM,QAAQ,GAAG,GAA+B,CAAC;YACjD,IAAI,QAAQ,CAAC,aAAa,KAAK,aAAa,EAAE,CAAC;gBAC7C,OAAO;oBACL,OAAO,EACL,QAAQ,CAAC,OAAO;wBAChB,yEAAyE;wBACzE,CAAC,QAAQ,CAAC,SAAS;4BACjB,CAAC,CAAC,uBAAuB,CAAC,WAAW;4BACrC,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC;oBACrC,OAAO,EAAE,QAAQ,CAAC,OAAO;iBAC1B,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,uEAAuE;QACvE,IAAI,MAAM,CAAC,OAAO,IAAK,KAAe,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,8EAA8E;IAC9E,gDAAgD;IAChD,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAA4B,EAC5B,MAAmB,EACnB,IAQC;IAED,MAAM,EAAE,KAAK,EAAE,wBAAwB,EAAE,GAAG,IAAI,CAAC;IACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;IACvC,IAAI,OAAO,GAAG,uBAAuB,CAAC,gBAAgB,CAAC;IACvD,IAAI,WAAwD,CAAC;IAE7D,yEAAyE;IACzE,QAAQ;IACR,OAAO,OAAO,KAAK,uBAAuB,CAAC,gBAAgB,EAAE,CAAC;QAC5D,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAE3D,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,YAAY,IAAI,WAAW,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,aAAa,MAAM,gCAAgC,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,iBAAiB,GAAG,WAAW,CAAC,UAAU,CAAC;QAEjD,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QACrE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,uBAAuB,CAAC,WAAW,CAAC;YAC9C,MAAM;QACR,CAAC;QAED,MAAM,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEjC,MAAM,aAAa,GAAG,UAAU,EAAE,CAAC;QACnC,MAAM,mBAAmB,GAAG,OAA0C,CAAC;QACvE,WAAW,GAAG,mBAAmB,CAAC;QAElC,MAAM,eAAe,GACnB,iBAAiB,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;QAErE,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,kBAAkB,CAAC,gBAAgB,EAAE;YAC9D,mBAAmB,EAAE,mBAAmB;YACxC,aAAa;SACd,CAAC,CAAC;QAEH,wBAAwB,EAAE,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CACxC,IAAI,CAAC,UAAU,EACf,aAAa,EACb,MAAM,EACN,eAAe,CAChB,CAAC;QACF,wBAAwB,EAAE,CAAC,KAAK,CAAC,CAAC;QAClC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QAE3B,IAAI,WAAW,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;YACtE,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QACrD,CAAC;QAED,IAAI,OAAO,KAAK,uBAAuB,CAAC,gBAAgB,EAAE,CAAC;YACzD,MAAM,SAAS,GAAG,MAAM,0BAA0B,CAChD,IAAI,EACJ,QAAQ,EACR,MAAM,CACP,CAAC;YACF,qEAAqE;YACrE,6CAA6C;YAC7C,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;gBACpB,UAAU,CAAC,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;aAAM,IAAI,QAAQ,CAAC,OAAO,IAAI,YAAY,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YAChE,MAAM,wBAAwB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACzE,OAAO,GAAG,uBAAuB,CAAC,WAAW,CAAC;QAChD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,WAAW,CACxB,IAAgD,EAChD,OAAoC;IAEpC,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,CAAC;QAChC,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,yBAAyB,CAAC;YAC3D,GAAG,OAAO;YACV,oEAAoE;YACpE,4BAA4B;YAC5B,SAAS,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;SACK,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAWD;;;GAGG;AACH,KAAK,UAAU,0BAA0B,CACvC,IAIC,EACD,QAA4B,EAC5B,MAAmB;IAEnB,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IAErD,MAAM,eAAe,GAAG,kBAAkB,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAEjE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,0DAA0D;QAC1D,OAAO,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,sBAAsB;IAClD,uEAAuE;IACvE,KAAK,CAAC,eAAkC,EACxC,MAAM,EACN,MAAM,CACP,CAAC;IACF,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAChE,KAAK,CAAC,UAAU,CACd,QAAQ,CAAC,OAAO,CAAC,MAAM,EACvB,MAAM,CAAC,aAAa,EACpB,aAAa,CACd,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,wBAAwB,CACrC,IAAyE,EACzE,QAA4B,EAC5B,OAAgC,EAChC,MAAmB;IAEnB,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IACjC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,iBAAiB;IAC7C,uEAAuE;IACvE,KAAK,CAAC,eAAkC,EACxC,OAAO,EACP,MAAM,CACP,CAAC;IACF,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAChE,KAAK,CAAC,UAAU,CACd,QAAQ,CAAC,OAAO,CAAC,MAAM,EACvB,MAAM,CAAC,aAAa,EACpB,aAAa,CACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,mBAAmB,CAChC,UAAsB,EACtB,aAAqB,EACrB,MAAmB,EACnB,eAA2C;IAE3C,gFAAgF;IAChF,MAAM,cAAc,GAAG,IAAI,eAAe,EAAE,CAAC;IAC7C,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC;IAEzC,6DAA6D;IAC7D,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IACnD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,cAAc,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,iBAAiB,CAAC,UAAU,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;QAE5E,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,MAAM,UAAU,CAAC;QAC1B,CAAC;QAED,yDAAyD;QACzD,MAAM,UAAU,GAAG,eAAe;aAC/B,IAAI,CACH,CAAC,UAAU,EAAE,EAAE,CACb,CAAC;YACC,OAAO,EACL,UAAU,CAAC,MAAM,KAAK,UAAU;gBAC9B,CAAC,CAAC,uBAAuB,CAAC,WAAW;gBACrC,CAAC,CAAC,uBAAuB,CAAC,MAAM;YACpC,OAAO,EAAE,UAAU,CAAC,OAAO;gBACzB,CAAC,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,OAAO,EAAE;gBACpC,CAAC,CAAC,SAAS;SACd,CAAuB,CAC3B;aACA,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,WAAW,CAAC,IAAI,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;YAClE,sEAAsE;YACtE,OAAO,IAAI,OAAO,CAAqB,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEL,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;IACtD,CAAC;YAAS,CAAC;QACT,sEAAsE;QACtE,qDAAqD;QACrD,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACnD,cAAc,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/src/scheduler/confirmation.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/scheduler/confirmation.test.js

@@ -0,0 +1,310 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach, } from 'vitest';
+import { EventEmitter } from 'node:events';
+import { resolveConfirmation } from './confirmation.js';
+import { MessageBusType, } from '../confirmation-bus/types.js';
+import { ToolConfirmationOutcome, } from '../tools/tools.js';
+import { ROOT_SCHEDULER_ID } from './types.js';
+import {} from '../utils/editor.js';
+import { randomUUID } from 'node:crypto';
+// Mock Dependencies
+vi.mock('node:crypto', () => ({
+    randomUUID: vi.fn(),
+}));
+vi.mock('../utils/editor.js', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        resolveEditorAsync: () => Promise.resolve('vim'),
+    };
+});
+describe('confirmation.ts', () => {
+    let mockMessageBus;
+    beforeEach(() => {
+        vi.stubEnv('SANDBOX', '');
+        mockMessageBus = new EventEmitter();
+        mockMessageBus.publish = vi.fn().mockResolvedValue(undefined);
+        vi.spyOn(mockMessageBus, 'on');
+        vi.spyOn(mockMessageBus, 'removeListener');
+        vi.mocked(randomUUID).mockReturnValue('123e4567-e89b-12d3-a456-426614174000');
+    });
+    afterEach(() => {
+        vi.unstubAllEnvs();
+        vi.restoreAllMocks();
+    });
+    const emitResponse = (response) => {
+        mockMessageBus.emit(MessageBusType.TOOL_CONFIRMATION_RESPONSE, response);
+    };
+    /**
+     * Helper to wait for a listener to be attached to the bus.
+     * This is more robust than setTimeout for synchronizing with the async iterator.
+     */
+    const waitForListener = (eventName) => new Promise((resolve) => {
+        const handler = (event) => {
+            if (event === eventName) {
+                mockMessageBus.off('newListener', handler);
+                resolve();
+            }
+        };
+        mockMessageBus.on('newListener', handler);
+    });
+    describe('resolveConfirmation', () => {
+        let mockState;
+        let mockModifier;
+        let mockConfig;
+        let getPreferredEditor;
+        let signal;
+        let toolCall;
+        let invocationMock;
+        let toolMock;
+        beforeEach(() => {
+            signal = new AbortController().signal;
+            mockState = {
+                getToolCall: vi.fn(),
+                updateStatus: vi.fn(),
+                updateArgs: vi.fn(),
+            };
+            // Mock accessors via defineProperty
+            Object.defineProperty(mockState, 'firstActiveCall', {
+                get: vi.fn(),
+                configurable: true,
+            });
+            const mockHookSystem = {
+                fireToolNotificationEvent: vi.fn().mockResolvedValue(undefined),
+            };
+            mockConfig = {
+                getEnableHooks: vi.fn().mockReturnValue(true),
+                getHookSystem: vi.fn().mockReturnValue(mockHookSystem),
+            };
+            mockModifier = {
+                handleModifyWithEditor: vi.fn(),
+                applyInlineModify: vi.fn(),
+            };
+            getPreferredEditor = vi.fn().mockReturnValue('vim');
+            invocationMock = {
+                shouldConfirmExecute: vi.fn(),
+            };
+            toolMock = {
+                build: vi.fn(),
+            };
+            toolCall = {
+                status: 'validating',
+                request: {
+                    callId: 'call-1',
+                    name: 'tool',
+                    args: {},
+                    isClientInitiated: false,
+                    prompt_id: 'prompt-1',
+                },
+                invocation: invocationMock,
+                tool: toolMock,
+            };
+            // Default: state returns the current call
+            mockState.getToolCall.mockReturnValue(toolCall);
+            // Default: define firstActiveCall for modifiers
+            vi.spyOn(mockState, 'firstActiveCall', 'get').mockReturnValue(toolCall);
+        });
+        it('should return ProceedOnce immediately if no confirmation needed', async () => {
+            invocationMock.shouldConfirmExecute.mockResolvedValue(false);
+            const result = await resolveConfirmation(toolCall, signal, {
+                config: mockConfig,
+                messageBus: mockMessageBus,
+                state: mockState,
+                modifier: mockModifier,
+                getPreferredEditor,
+                schedulerId: ROOT_SCHEDULER_ID,
+            });
+            expect(result.outcome).toBe(ToolConfirmationOutcome.ProceedOnce);
+            expect(mockState.updateStatus).not.toHaveBeenCalledWith(expect.anything(), 'awaiting_approval', expect.anything());
+        });
+        it('should return ProceedOnce after successful user confirmation', async () => {
+            const details = {
+                type: 'info',
+                prompt: 'Confirm?',
+                title: 'Title',
+                onConfirm: vi.fn(),
+            };
+            invocationMock.shouldConfirmExecute.mockResolvedValue(details);
+            // Wait for listener to attach
+            const listenerPromise = waitForListener(MessageBusType.TOOL_CONFIRMATION_RESPONSE);
+            const promise = resolveConfirmation(toolCall, signal, {
+                config: mockConfig,
+                messageBus: mockMessageBus,
+                state: mockState,
+                modifier: mockModifier,
+                getPreferredEditor,
+                schedulerId: ROOT_SCHEDULER_ID,
+            });
+            await listenerPromise;
+            emitResponse({
+                type: MessageBusType.TOOL_CONFIRMATION_RESPONSE,
+                correlationId: '123e4567-e89b-12d3-a456-426614174000',
+                confirmed: true,
+            });
+            const result = await promise;
+            expect(result.outcome).toBe(ToolConfirmationOutcome.ProceedOnce);
+            expect(mockState.updateStatus).toHaveBeenCalledWith('call-1', 'awaiting_approval', expect.objectContaining({
+                correlationId: '123e4567-e89b-12d3-a456-426614174000',
+            }));
+        });
+        it('should fire hooks if enabled', async () => {
+            const details = {
+                type: 'info',
+                prompt: 'Confirm?',
+                title: 'Title',
+                onConfirm: vi.fn(),
+            };
+            invocationMock.shouldConfirmExecute.mockResolvedValue(details);
+            const promise = resolveConfirmation(toolCall, signal, {
+                config: mockConfig,
+                messageBus: mockMessageBus,
+                state: mockState,
+                modifier: mockModifier,
+                getPreferredEditor,
+                schedulerId: ROOT_SCHEDULER_ID,
+            });
+            await waitForListener(MessageBusType.TOOL_CONFIRMATION_RESPONSE);
+            emitResponse({
+                type: MessageBusType.TOOL_CONFIRMATION_RESPONSE,
+                correlationId: '123e4567-e89b-12d3-a456-426614174000',
+                confirmed: true,
+            });
+            await promise;
+            expect(mockConfig.getHookSystem()?.fireToolNotificationEvent).toHaveBeenCalledWith(expect.objectContaining({
+                type: details.type,
+                prompt: details.prompt,
+                title: details.title,
+            }));
+        });
+        it('should handle ModifyWithEditor loop', async () => {
+            const details = {
+                type: 'info',
+                prompt: 'Confirm?',
+                title: 'Title',
+                onConfirm: vi.fn(),
+            };
+            invocationMock.shouldConfirmExecute.mockResolvedValue(details);
+            // Set up modifier mock before starting the flow
+            mockModifier.handleModifyWithEditor.mockResolvedValue({
+                updatedParams: { foo: 'bar' },
+            });
+            toolMock.build.mockReturnValue({});
+            // Start the confirmation flow
+            const listenerPromise1 = waitForListener(MessageBusType.TOOL_CONFIRMATION_RESPONSE);
+            const promise = resolveConfirmation(toolCall, signal, {
+                config: mockConfig,
+                messageBus: mockMessageBus,
+                state: mockState,
+                modifier: mockModifier,
+                getPreferredEditor,
+                schedulerId: ROOT_SCHEDULER_ID,
+            });
+            await listenerPromise1;
+            // Prepare to detect when the loop re-subscribes after modification
+            const listenerPromise2 = waitForListener(MessageBusType.TOOL_CONFIRMATION_RESPONSE);
+            // First response: User chooses to modify with editor
+            emitResponse({
+                type: MessageBusType.TOOL_CONFIRMATION_RESPONSE,
+                correlationId: '123e4567-e89b-12d3-a456-426614174000',
+                confirmed: true,
+                outcome: ToolConfirmationOutcome.ModifyWithEditor,
+            });
+            // Wait for the loop to process the modification and re-subscribe
+            await listenerPromise2;
+            expect(mockState.updateArgs).toHaveBeenCalled();
+            // Second response: User approves the modified params
+            emitResponse({
+                type: MessageBusType.TOOL_CONFIRMATION_RESPONSE,
+                correlationId: '123e4567-e89b-12d3-a456-426614174000',
+                confirmed: true,
+                outcome: ToolConfirmationOutcome.ProceedOnce,
+            });
+            const result = await promise;
+            expect(result.outcome).toBe(ToolConfirmationOutcome.ProceedOnce);
+            expect(mockModifier.handleModifyWithEditor).toHaveBeenCalled();
+        });
+        it('should handle inline modification (payload)', async () => {
+            const details = {
+                type: 'info',
+                prompt: 'Confirm?',
+                title: 'Title',
+                onConfirm: vi.fn(),
+            };
+            invocationMock.shouldConfirmExecute.mockResolvedValue(details);
+            const listenerPromise = waitForListener(MessageBusType.TOOL_CONFIRMATION_RESPONSE);
+            const promise = resolveConfirmation(toolCall, signal, {
+                config: mockConfig,
+                messageBus: mockMessageBus,
+                state: mockState,
+                modifier: mockModifier,
+                getPreferredEditor,
+                schedulerId: ROOT_SCHEDULER_ID,
+            });
+            await listenerPromise;
+            // Response with payload
+            emitResponse({
+                type: MessageBusType.TOOL_CONFIRMATION_RESPONSE,
+                correlationId: '123e4567-e89b-12d3-a456-426614174000',
+                confirmed: true,
+                outcome: ToolConfirmationOutcome.ProceedOnce, // Ignored if payload present
+                payload: { newContent: 'inline' },
+            });
+            mockModifier.applyInlineModify.mockResolvedValue({
+                updatedParams: { inline: 'true' },
+            });
+            toolMock.build.mockReturnValue({});
+            const result = await promise;
+            expect(result.outcome).toBe(ToolConfirmationOutcome.ProceedOnce);
+            expect(mockModifier.applyInlineModify).toHaveBeenCalled();
+            expect(mockState.updateArgs).toHaveBeenCalled();
+        });
+        it('should resolve immediately if IDE confirmation resolves first', async () => {
+            const idePromise = Promise.resolve({
+                status: 'accepted',
+                content: 'ide-content',
+            });
+            const details = {
+                type: 'info',
+                prompt: 'Confirm?',
+                title: 'Title',
+                onConfirm: vi.fn(),
+                ideConfirmation: idePromise,
+            };
+            invocationMock.shouldConfirmExecute.mockResolvedValue(details);
+            // We don't strictly need to wait for the listener because the race might finish instantly
+            const promise = resolveConfirmation(toolCall, signal, {
+                config: mockConfig,
+                messageBus: mockMessageBus,
+                state: mockState,
+                modifier: mockModifier,
+                getPreferredEditor,
+                schedulerId: ROOT_SCHEDULER_ID,
+            });
+            const result = await promise;
+            expect(result.outcome).toBe(ToolConfirmationOutcome.ProceedOnce);
+        });
+        it('should throw if tool call is lost from state during loop', async () => {
+            invocationMock.shouldConfirmExecute.mockResolvedValue({
+                type: 'info',
+                title: 'Title',
+                onConfirm: vi.fn(),
+                prompt: 'Prompt',
+            });
+            // Simulate state losing the call (undefined)
+            mockState.getToolCall.mockReturnValue(undefined);
+            await expect(resolveConfirmation(toolCall, signal, {
+                config: mockConfig,
+                messageBus: mockMessageBus,
+                state: mockState,
+                modifier: mockModifier,
+                getPreferredEditor,
+                schedulerId: ROOT_SCHEDULER_ID,
+            })).rejects.toThrow(/lost during confirmation loop/);
+        });
+    });
+});
+//# sourceMappingURL=confirmation.test.js.map

package/dist/src/scheduler/confirmation.test.js.map

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

package/dist/src/scheduler/policy.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ToolErrorType } from '../tools/tool-error.js';
+import { type CheckResult, type PolicyRule } from '../policy/types.js';
+import type { Config } from '../config/config.js';
+import type { MessageBus } from '../confirmation-bus/message-bus.js';
+import { type SerializableConfirmationDetails } from '../confirmation-bus/types.js';
+import { ToolConfirmationOutcome, type AnyDeclarativeTool } from '../tools/tools.js';
+import type { ValidatingToolCall } from './types.js';
+/**
+ * Helper to format the policy denial error.
+ */
+export declare function getPolicyDenialError(config: Config, rule?: PolicyRule): {
+    errorMessage: string;
+    errorType: ToolErrorType;
+};
+/**
+ * Queries the system PolicyEngine to determine tool allowance.
+ * @returns The PolicyDecision.
+ * @throws Error if policy requires ASK_USER but the CLI is non-interactive.
+ */
+export declare function checkPolicy(toolCall: ValidatingToolCall, config: Config): Promise<CheckResult>;
+/**
+ * Evaluates the outcome of a user confirmation and dispatches
+ * policy config updates.
+ */
+export declare function updatePolicy(tool: AnyDeclarativeTool, outcome: ToolConfirmationOutcome, confirmationDetails: SerializableConfirmationDetails | undefined, deps: {
+    config: Config;
+    messageBus: MessageBus;
+}): Promise<void>;