@terminai/cli 0.21.0

package/dist/src/validateNonInterActiveAuth.test.js

@@ -0,0 +1,338 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach, } from 'vitest';
+import { validateNonInteractiveAuth } from './validateNonInterActiveAuth.js';
+import { AuthType, OutputFormat, makeFakeConfig, debugLogger, ExitCodes, } from '@terminai/core';
+import * as auth from './config/auth.js';
+import {} from './config/settings.js';
+function createLocalMockConfig(overrides = {}) {
+    const config = makeFakeConfig();
+    Object.assign(config, overrides);
+    return config;
+}
+describe('validateNonInterActiveAuth', () => {
+    let originalEnvGeminiApiKey;
+    let originalEnvVertexAi;
+    let originalEnvGcp;
+    let consoleErrorSpy;
+    let debugLoggerErrorSpy;
+    let processExitSpy;
+    let refreshAuthMock;
+    let mockSettings;
+    beforeEach(() => {
+        originalEnvGeminiApiKey = process.env['GEMINI_API_KEY'];
+        originalEnvVertexAi = process.env['GOOGLE_GENAI_USE_VERTEXAI'];
+        originalEnvGcp = process.env['GOOGLE_GENAI_USE_GCA'];
+        delete process.env['GEMINI_API_KEY'];
+        delete process.env['GOOGLE_GENAI_USE_VERTEXAI'];
+        delete process.env['GOOGLE_GENAI_USE_GCA'];
+        consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+        debugLoggerErrorSpy = vi
+            .spyOn(debugLogger, 'error')
+            .mockImplementation(() => { });
+        processExitSpy = vi
+            .spyOn(process, 'exit')
+            .mockImplementation((code) => {
+            throw new Error(`process.exit(${code}) called`);
+        });
+        vi.spyOn(auth, 'validateAuthMethod').mockReturnValue(null);
+        refreshAuthMock = vi.fn().mockImplementation(async () => 'refreshed');
+        mockSettings = {
+            system: { path: '', settings: {} },
+            systemDefaults: { path: '', settings: {} },
+            user: { path: '', settings: {} },
+            workspace: { path: '', settings: {} },
+            errors: [],
+            setValue: vi.fn(),
+            merged: {
+                security: {
+                    auth: {
+                        enforcedType: undefined,
+                    },
+                },
+            },
+            isTrusted: true,
+            migratedInMemoryScopes: new Set(),
+            forScope: vi.fn(),
+            computeMergedSettings: vi.fn(),
+        };
+    });
+    afterEach(() => {
+        if (originalEnvGeminiApiKey !== undefined) {
+            process.env['GEMINI_API_KEY'] = originalEnvGeminiApiKey;
+        }
+        else {
+            delete process.env['GEMINI_API_KEY'];
+        }
+        if (originalEnvVertexAi !== undefined) {
+            process.env['GOOGLE_GENAI_USE_VERTEXAI'] = originalEnvVertexAi;
+        }
+        else {
+            delete process.env['GOOGLE_GENAI_USE_VERTEXAI'];
+        }
+        if (originalEnvGcp !== undefined) {
+            process.env['GOOGLE_GENAI_USE_GCA'] = originalEnvGcp;
+        }
+        else {
+            delete process.env['GOOGLE_GENAI_USE_GCA'];
+        }
+        vi.restoreAllMocks();
+    });
+    it('exits if no auth type is configured or env vars set', async () => {
+        const nonInteractiveConfig = createLocalMockConfig({
+            refreshAuth: refreshAuthMock,
+            getOutputFormat: vi.fn().mockReturnValue(OutputFormat.TEXT),
+            getContentGeneratorConfig: vi
+                .fn()
+                .mockReturnValue({ authType: undefined }),
+        });
+        try {
+            await validateNonInteractiveAuth(undefined, undefined, nonInteractiveConfig, mockSettings);
+            expect.fail('Should have exited');
+        }
+        catch (e) {
+            expect(e.message).toContain(`process.exit(${ExitCodes.FATAL_AUTHENTICATION_ERROR}) called`);
+        }
+        expect(debugLoggerErrorSpy).toHaveBeenCalledWith(expect.stringContaining('Please set an Auth method'));
+        expect(processExitSpy).toHaveBeenCalledWith(ExitCodes.FATAL_AUTHENTICATION_ERROR);
+    });
+    it('uses LOGIN_WITH_GOOGLE if GOOGLE_GENAI_USE_GCA is set', async () => {
+        process.env['GOOGLE_GENAI_USE_GCA'] = 'true';
+        const nonInteractiveConfig = createLocalMockConfig({
+            refreshAuth: refreshAuthMock,
+        });
+        await validateNonInteractiveAuth(undefined, undefined, nonInteractiveConfig, mockSettings);
+        expect(refreshAuthMock).toHaveBeenCalledWith(AuthType.LOGIN_WITH_GOOGLE);
+    });
+    it('uses USE_GEMINI if GEMINI_API_KEY is set', async () => {
+        process.env['GEMINI_API_KEY'] = 'fake-key';
+        const nonInteractiveConfig = createLocalMockConfig({
+            refreshAuth: refreshAuthMock,
+        });
+        await validateNonInteractiveAuth(undefined, undefined, nonInteractiveConfig, mockSettings);
+        expect(refreshAuthMock).toHaveBeenCalledWith(AuthType.USE_GEMINI);
+    });
+    it('uses USE_VERTEX_AI if GOOGLE_GENAI_USE_VERTEXAI is true (with GOOGLE_CLOUD_PROJECT and GOOGLE_CLOUD_LOCATION)', async () => {
+        process.env['GOOGLE_GENAI_USE_VERTEXAI'] = 'true';
+        process.env['GOOGLE_CLOUD_PROJECT'] = 'test-project';
+        process.env['GOOGLE_CLOUD_LOCATION'] = 'us-central1';
+        const nonInteractiveConfig = createLocalMockConfig({
+            refreshAuth: refreshAuthMock,
+        });
+        await validateNonInteractiveAuth(undefined, undefined, nonInteractiveConfig, mockSettings);
+        expect(refreshAuthMock).toHaveBeenCalledWith(AuthType.USE_VERTEX_AI);
+    });
+    it('uses USE_VERTEX_AI if GOOGLE_GENAI_USE_VERTEXAI is true and GOOGLE_API_KEY is set', async () => {
+        process.env['GOOGLE_GENAI_USE_VERTEXAI'] = 'true';
+        process.env['GOOGLE_API_KEY'] = 'vertex-api-key';
+        const nonInteractiveConfig = createLocalMockConfig({
+            refreshAuth: refreshAuthMock,
+        });
+        await validateNonInteractiveAuth(undefined, undefined, nonInteractiveConfig, mockSettings);
+        expect(refreshAuthMock).toHaveBeenCalledWith(AuthType.USE_VERTEX_AI);
+    });
+    it('uses LOGIN_WITH_GOOGLE if GOOGLE_GENAI_USE_GCA is set, even with other env vars', async () => {
+        process.env['GOOGLE_GENAI_USE_GCA'] = 'true';
+        process.env['GEMINI_API_KEY'] = 'fake-key';
+        process.env['GOOGLE_GENAI_USE_VERTEXAI'] = 'true';
+        process.env['GOOGLE_CLOUD_PROJECT'] = 'test-project';
+        process.env['GOOGLE_CLOUD_LOCATION'] = 'us-central1';
+        const nonInteractiveConfig = createLocalMockConfig({
+            refreshAuth: refreshAuthMock,
+        });
+        await validateNonInteractiveAuth(undefined, undefined, nonInteractiveConfig, mockSettings);
+        expect(refreshAuthMock).toHaveBeenCalledWith(AuthType.LOGIN_WITH_GOOGLE);
+    });
+    it('uses USE_VERTEX_AI if both GEMINI_API_KEY and GOOGLE_GENAI_USE_VERTEXAI are set', async () => {
+        process.env['GEMINI_API_KEY'] = 'fake-key';
+        process.env['GOOGLE_GENAI_USE_VERTEXAI'] = 'true';
+        process.env['GOOGLE_CLOUD_PROJECT'] = 'test-project';
+        process.env['GOOGLE_CLOUD_LOCATION'] = 'us-central1';
+        const nonInteractiveConfig = createLocalMockConfig({
+            refreshAuth: refreshAuthMock,
+        });
+        await validateNonInteractiveAuth(undefined, undefined, nonInteractiveConfig, mockSettings);
+        expect(refreshAuthMock).toHaveBeenCalledWith(AuthType.USE_VERTEX_AI);
+    });
+    it('uses USE_GEMINI if GOOGLE_GENAI_USE_VERTEXAI is false, GEMINI_API_KEY is set, and project/location are available', async () => {
+        process.env['GOOGLE_GENAI_USE_VERTEXAI'] = 'false';
+        process.env['GEMINI_API_KEY'] = 'fake-key';
+        process.env['GOOGLE_CLOUD_PROJECT'] = 'test-project';
+        process.env['GOOGLE_CLOUD_LOCATION'] = 'us-central1';
+        const nonInteractiveConfig = createLocalMockConfig({
+            refreshAuth: refreshAuthMock,
+        });
+        await validateNonInteractiveAuth(undefined, undefined, nonInteractiveConfig, mockSettings);
+        expect(refreshAuthMock).toHaveBeenCalledWith(AuthType.USE_GEMINI);
+    });
+    it('uses configuredAuthType over environment variables', async () => {
+        process.env['GEMINI_API_KEY'] = 'fake-key';
+        const nonInteractiveConfig = createLocalMockConfig({
+            refreshAuth: refreshAuthMock,
+        });
+        await validateNonInteractiveAuth(AuthType.LOGIN_WITH_GOOGLE, undefined, nonInteractiveConfig, mockSettings);
+        expect(refreshAuthMock).toHaveBeenCalledWith(AuthType.LOGIN_WITH_GOOGLE);
+    });
+    it('exits if validateAuthMethod returns error', async () => {
+        // Mock validateAuthMethod to return error
+        vi.spyOn(auth, 'validateAuthMethod').mockReturnValue('Auth error!');
+        const nonInteractiveConfig = createLocalMockConfig({
+            refreshAuth: refreshAuthMock,
+            getOutputFormat: vi.fn().mockReturnValue(OutputFormat.TEXT),
+            getContentGeneratorConfig: vi
+                .fn()
+                .mockReturnValue({ authType: undefined }),
+        });
+        try {
+            await validateNonInteractiveAuth(AuthType.USE_GEMINI, undefined, nonInteractiveConfig, mockSettings);
+            expect.fail('Should have exited');
+        }
+        catch (e) {
+            expect(e.message).toContain(`process.exit(${ExitCodes.FATAL_AUTHENTICATION_ERROR}) called`);
+        }
+        expect(debugLoggerErrorSpy).toHaveBeenCalledWith('Auth error!');
+        expect(processExitSpy).toHaveBeenCalledWith(ExitCodes.FATAL_AUTHENTICATION_ERROR);
+    });
+    it('skips validation if useExternalAuth is true', async () => {
+        // Mock validateAuthMethod to return error to ensure it's not being called
+        const validateAuthMethodSpy = vi
+            .spyOn(auth, 'validateAuthMethod')
+            .mockReturnValue('Auth error!');
+        const nonInteractiveConfig = createLocalMockConfig({
+            refreshAuth: refreshAuthMock,
+        });
+        // Even with an invalid auth type, it should not exit
+        // because validation is skipped.
+        await validateNonInteractiveAuth('invalid-auth-type', true, // useExternalAuth = true
+        nonInteractiveConfig, mockSettings);
+        expect(validateAuthMethodSpy).not.toHaveBeenCalled();
+        expect(debugLoggerErrorSpy).not.toHaveBeenCalled();
+        expect(processExitSpy).not.toHaveBeenCalled();
+        // We still expect refreshAuth to be called with the (invalid) type
+        expect(refreshAuthMock).toHaveBeenCalledWith('invalid-auth-type');
+    });
+    it('succeeds if effectiveAuthType matches enforcedAuthType', async () => {
+        mockSettings.merged.security.auth.enforcedType = AuthType.USE_GEMINI;
+        process.env['GEMINI_API_KEY'] = 'fake-key';
+        const nonInteractiveConfig = createLocalMockConfig({
+            refreshAuth: refreshAuthMock,
+        });
+        await validateNonInteractiveAuth(undefined, undefined, nonInteractiveConfig, mockSettings);
+        expect(refreshAuthMock).toHaveBeenCalledWith(AuthType.USE_GEMINI);
+    });
+    it('exits if configuredAuthType does not match enforcedAuthType', async () => {
+        mockSettings.merged.security.auth.enforcedType =
+            AuthType.LOGIN_WITH_GOOGLE;
+        const nonInteractiveConfig = createLocalMockConfig({
+            refreshAuth: refreshAuthMock,
+            getOutputFormat: vi.fn().mockReturnValue(OutputFormat.TEXT),
+        });
+        try {
+            await validateNonInteractiveAuth(AuthType.USE_GEMINI, undefined, nonInteractiveConfig, mockSettings);
+            expect.fail('Should have exited');
+        }
+        catch (e) {
+            expect(e.message).toContain(`process.exit(${ExitCodes.FATAL_AUTHENTICATION_ERROR}) called`);
+        }
+        expect(debugLoggerErrorSpy).toHaveBeenCalledWith("The enforced authentication type is 'oauth-personal', but the current type is 'gemini-api-key'. Please re-authenticate with the correct type.");
+        expect(processExitSpy).toHaveBeenCalledWith(ExitCodes.FATAL_AUTHENTICATION_ERROR);
+    });
+    it('exits if auth from env var does not match enforcedAuthType', async () => {
+        mockSettings.merged.security.auth.enforcedType =
+            AuthType.LOGIN_WITH_GOOGLE;
+        process.env['GEMINI_API_KEY'] = 'fake-key';
+        const nonInteractiveConfig = createLocalMockConfig({
+            refreshAuth: refreshAuthMock,
+            getOutputFormat: vi.fn().mockReturnValue(OutputFormat.TEXT),
+        });
+        try {
+            await validateNonInteractiveAuth(undefined, undefined, nonInteractiveConfig, mockSettings);
+            expect.fail('Should have exited');
+        }
+        catch (e) {
+            expect(e.message).toContain(`process.exit(${ExitCodes.FATAL_AUTHENTICATION_ERROR}) called`);
+        }
+        expect(debugLoggerErrorSpy).toHaveBeenCalledWith("The enforced authentication type is 'oauth-personal', but the current type is 'gemini-api-key'. Please re-authenticate with the correct type.");
+        expect(processExitSpy).toHaveBeenCalledWith(ExitCodes.FATAL_AUTHENTICATION_ERROR);
+    });
+    describe('JSON output mode', () => {
+        it(`prints JSON error when no auth is configured and exits with code ${ExitCodes.FATAL_AUTHENTICATION_ERROR}`, async () => {
+            const nonInteractiveConfig = createLocalMockConfig({
+                refreshAuth: refreshAuthMock,
+                getOutputFormat: vi.fn().mockReturnValue(OutputFormat.JSON),
+                getContentGeneratorConfig: vi
+                    .fn()
+                    .mockReturnValue({ authType: undefined }),
+            });
+            let thrown;
+            try {
+                await validateNonInteractiveAuth(undefined, undefined, nonInteractiveConfig, mockSettings);
+            }
+            catch (e) {
+                thrown = e;
+            }
+            expect(thrown?.message).toBe(`process.exit(${ExitCodes.FATAL_AUTHENTICATION_ERROR}) called`);
+            const errorArg = consoleErrorSpy.mock.calls[0]?.[0];
+            const payload = JSON.parse(errorArg);
+            expect(payload.error.type).toBe('Error');
+            expect(payload.error.code).toBe(ExitCodes.FATAL_AUTHENTICATION_ERROR);
+            expect(payload.error.message).toContain('Please set an Auth method in your');
+        });
+        it(`prints JSON error when enforced auth mismatches current auth and exits with code ${ExitCodes.FATAL_AUTHENTICATION_ERROR}`, async () => {
+            mockSettings.merged.security.auth.enforcedType = AuthType.USE_GEMINI;
+            const nonInteractiveConfig = createLocalMockConfig({
+                refreshAuth: refreshAuthMock,
+                getOutputFormat: vi.fn().mockReturnValue(OutputFormat.JSON),
+                getContentGeneratorConfig: vi
+                    .fn()
+                    .mockReturnValue({ authType: undefined }),
+            });
+            let thrown;
+            try {
+                await validateNonInteractiveAuth(AuthType.LOGIN_WITH_GOOGLE, undefined, nonInteractiveConfig, mockSettings);
+            }
+            catch (e) {
+                thrown = e;
+            }
+            expect(thrown?.message).toBe(`process.exit(${ExitCodes.FATAL_AUTHENTICATION_ERROR}) called`);
+            {
+                const errorArg = consoleErrorSpy.mock.calls[0]?.[0];
+                const payload = JSON.parse(errorArg);
+                expect(payload.error.type).toBe('Error');
+                expect(payload.error.code).toBe(ExitCodes.FATAL_AUTHENTICATION_ERROR);
+                expect(payload.error.message).toContain("The enforced authentication type is 'gemini-api-key', but the current type is 'oauth-personal'. Please re-authenticate with the correct type.");
+            }
+        });
+        it(`prints JSON error when validateAuthMethod fails and exits with code ${ExitCodes.FATAL_AUTHENTICATION_ERROR}`, async () => {
+            vi.spyOn(auth, 'validateAuthMethod').mockReturnValue('Auth error!');
+            process.env['GEMINI_API_KEY'] = 'fake-key';
+            const nonInteractiveConfig = createLocalMockConfig({
+                refreshAuth: refreshAuthMock,
+                getOutputFormat: vi.fn().mockReturnValue(OutputFormat.JSON),
+                getContentGeneratorConfig: vi
+                    .fn()
+                    .mockReturnValue({ authType: undefined }),
+            });
+            let thrown;
+            try {
+                await validateNonInteractiveAuth(AuthType.USE_GEMINI, undefined, nonInteractiveConfig, mockSettings);
+            }
+            catch (e) {
+                thrown = e;
+            }
+            expect(thrown?.message).toBe(`process.exit(${ExitCodes.FATAL_AUTHENTICATION_ERROR}) called`);
+            {
+                const errorArg = consoleErrorSpy.mock.calls[0]?.[0];
+                const payload = JSON.parse(errorArg);
+                expect(payload.error.type).toBe('Error');
+                expect(payload.error.code).toBe(ExitCodes.FATAL_AUTHENTICATION_ERROR);
+                expect(payload.error.message).toBe('Auth error!');
+            }
+        });
+    });
+});
+//# sourceMappingURL=validateNonInterActiveAuth.test.js.map

package/dist/src/validateNonInterActiveAuth.test.js.map

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

package/dist/src/voice/AudioController.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { TtsProvider } from './tts/types.js';
+/**
+ * AudioController wraps the TTS provider with duck/restore/interrupt support.
+ * It uses AbortSignals for fast interruption and attempts best-effort
+ * system-volume ducking when supported on the host.
+ */
+export declare class AudioController {
+    private readonly ttsProvider;
+    private abortController;
+    private currentVolume;
+    private speaking;
+    private baselineVolume;
+    constructor(ttsProvider: TtsProvider | null);
+    isSpeaking(): boolean;
+    speak(text: string): Promise<void>;
+    duck(targetVolume?: number): void;
+    restore(): void;
+    interrupt(): void;
+    private readSystemVolume;
+    private applyVolume;
+}

package/dist/src/voice/AudioController.js

@@ -0,0 +1,121 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { execSync } from 'node:child_process';
+import commandExists from 'command-exists';
+function clampVolume(level) {
+    if (!Number.isFinite(level)) {
+        return 1;
+    }
+    return Math.max(0, Math.min(1, level));
+}
+/**
+ * AudioController wraps the TTS provider with duck/restore/interrupt support.
+ * It uses AbortSignals for fast interruption and attempts best-effort
+ * system-volume ducking when supported on the host.
+ */
+export class AudioController {
+    ttsProvider;
+    abortController = null;
+    currentVolume = 1;
+    speaking = false;
+    baselineVolume = null;
+    constructor(ttsProvider) {
+        this.ttsProvider = ttsProvider;
+    }
+    isSpeaking() {
+        return this.speaking;
+    }
+    async speak(text) {
+        if (!this.ttsProvider) {
+            return;
+        }
+        if (!text.trim()) {
+            return;
+        }
+        this.abortController?.abort();
+        this.abortController = new AbortController();
+        this.speaking = true;
+        try {
+            await this.ttsProvider.speak(text, {
+                signal: this.abortController.signal,
+                volume: this.currentVolume,
+            });
+        }
+        finally {
+            this.speaking = false;
+            this.abortController = null;
+            this.restore();
+        }
+    }
+    duck(targetVolume = 0.25) {
+        this.currentVolume = clampVolume(targetVolume);
+        if (this.baselineVolume === null) {
+            this.baselineVolume = this.readSystemVolume();
+        }
+        this.applyVolume(this.currentVolume);
+    }
+    restore() {
+        this.currentVolume = 1;
+        if (this.baselineVolume !== null) {
+            this.applyVolume(this.baselineVolume);
+            this.baselineVolume = null;
+        }
+        else {
+            this.applyVolume(1);
+        }
+    }
+    interrupt() {
+        if (this.abortController) {
+            this.abortController.abort();
+            this.abortController = null;
+        }
+        this.ttsProvider?.stop?.();
+        this.speaking = false;
+        this.restore();
+    }
+    readSystemVolume() {
+        try {
+            if (process.platform === 'darwin' && commandExists.sync('osascript')) {
+                const output = execSync("osascript -e 'output volume of (get volume settings)'", { encoding: 'utf8' });
+                const asNumber = Number.parseFloat(output.trim());
+                return Number.isFinite(asNumber) ? asNumber / 100 : null;
+            }
+            if (process.platform === 'linux' && commandExists.sync('amixer')) {
+                const output = execSync('amixer get Master', { encoding: 'utf8' });
+                const match = output.match(/(\\d+)%/);
+                if (match) {
+                    const percent = Number.parseInt(match[1] ?? '', 10);
+                    if (Number.isFinite(percent)) {
+                        return clampVolume(percent / 100);
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore volume detection failures; ducking becomes a no-op.
+        }
+        return null;
+    }
+    applyVolume(level) {
+        const clamped = clampVolume(level);
+        try {
+            if (process.platform === 'darwin' && commandExists.sync('osascript')) {
+                execSync(`osascript -e "set volume output volume ${Math.round(clamped * 100)}"`, { stdio: 'ignore' });
+                return;
+            }
+            if (process.platform === 'linux' && commandExists.sync('amixer')) {
+                execSync(`amixer set Master ${Math.round(clamped * 100)}%`, {
+                    stdio: 'ignore',
+                });
+            }
+        }
+        catch {
+            // Swallow errors to avoid crashing the CLI if the host lacks mixers.
+        }
+    }
+}
+//# sourceMappingURL=AudioController.js.map

package/dist/src/voice/AudioController.js.map

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

package/dist/src/voice/ConversationStack.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export type ConversationFrame = {
+    input: string;
+    timestamp: number;
+};
+export type ConversationIntent = {
+    type: 'CANCEL';
+} | {
+    type: 'CORRECTION';
+    newContext: string;
+} | {
+    type: 'REPEAT_LAST';
+} | {
+    type: 'NEW_INPUT';
+    text: string;
+};
+export type ConversationAction = {
+    action: 'CANCEL_LAST_ACTION';
+} | {
+    action: 'REPLACE_INPUT';
+    text: string;
+} | {
+    action: 'SPEAK_LAST_RESPONSE';
+    text: string | null;
+} | {
+    action: 'PROCESS_NORMALLY';
+    text: string;
+};
+export declare class ConversationStack {
+    private readonly stack;
+    private lastResponse;
+    parseIntent(transcript: string): ConversationIntent;
+    handleIntent(intent: ConversationIntent): ConversationAction;
+    setLastResponse(text: string): void;
+    reset(): void;
+    private pushInput;
+}

package/dist/src/voice/ConversationStack.js

@@ -0,0 +1,66 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export class ConversationStack {
+    stack = [];
+    lastResponse = null;
+    parseIntent(transcript) {
+        const normalized = transcript.trim();
+        const lower = normalized.toLowerCase();
+        if (/^(never ?mind|cancel|stop|forget it)\b/.test(lower)) {
+            return { type: 'CANCEL' };
+        }
+        if (/^(wait|actually|no|sorry|i meant)\b/.test(lower)) {
+            const replacement = normalized.replace(/^(wait|actually|no|sorry|i meant)[,.]?\s*/i, '');
+            return { type: 'CORRECTION', newContext: replacement.trim() };
+        }
+        if (/^(huh|repeat|say that again)\b/.test(lower) ||
+            /^(what|pardon)\W*$/.test(lower)) {
+            return { type: 'REPEAT_LAST' };
+        }
+        return { type: 'NEW_INPUT', text: normalized };
+    }
+    handleIntent(intent) {
+        switch (intent.type) {
+            case 'CANCEL': {
+                this.stack.pop();
+                return { action: 'CANCEL_LAST_ACTION' };
+            }
+            case 'CORRECTION': {
+                this.stack.pop();
+                const clean = intent.newContext || '';
+                this.pushInput(clean);
+                return { action: 'REPLACE_INPUT', text: clean };
+            }
+            case 'REPEAT_LAST': {
+                return { action: 'SPEAK_LAST_RESPONSE', text: this.lastResponse };
+            }
+            case 'NEW_INPUT': {
+                const clean = intent.text.trim();
+                this.pushInput(clean);
+                return { action: 'PROCESS_NORMALLY', text: clean };
+            }
+            default:
+                return { action: 'PROCESS_NORMALLY', text: '' };
+        }
+    }
+    setLastResponse(text) {
+        const normalized = text.trim();
+        if (normalized) {
+            this.lastResponse = normalized;
+        }
+    }
+    reset() {
+        this.stack.length = 0;
+        this.lastResponse = null;
+    }
+    pushInput(input) {
+        if (!input)
+            return;
+        this.stack.push({ input, timestamp: Date.now() });
+    }
+}
+//# sourceMappingURL=ConversationStack.js.map

package/dist/src/voice/ConversationStack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationStack.js","sourceRoot":"","sources":["../../../src/voice/ConversationStack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH,MAAM,OAAO,iBAAiB;IACX,KAAK,GAAwB,EAAE,CAAC;IACzC,YAAY,GAAkB,IAAI,CAAC;IAE3C,WAAW,CAAC,UAAkB;QAC5B,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QAEvC,IAAI,wCAAwC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACzD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5B,CAAC;QAED,IAAI,qCAAqC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACtD,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CACpC,4CAA4C,EAC5C,EAAE,CACH,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QAChE,CAAC;QAED,IACE,gCAAgC,CAAC,IAAI,CAAC,KAAK,CAAC;YAC5C,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,EAChC,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QACjC,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACjD,CAAC;IAED,YAAY,CAAC,MAA0B;QACrC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;gBACjB,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;YAC1C,CAAC;YACD,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;gBACjB,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;gBACtC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACtB,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YAClD,CAAC;YACD,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;YACpE,CAAC;YACD,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACjC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACtB,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YACrD,CAAC;YACD;gBACE,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACpD,CAAC;IACH,CAAC;IAED,eAAe,CAAC,IAAY;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC;QACjC,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAEO,SAAS,CAAC,KAAa;QAC7B,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC;CACF"}

package/dist/src/voice/ConversationStack.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};