@anthropic-field/core 0.1.0

package/dist/src/config/storage.js

@@ -0,0 +1,139 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as path from 'node:path';
+import * as os from 'node:os';
+import * as crypto from 'node:crypto';
+import * as fs from 'node:fs';
+import { GEMINI_DIR, homedir } from '../utils/paths.js';
+export const GOOGLE_ACCOUNTS_FILENAME = 'google_accounts.json';
+export const OAUTH_FILE = 'oauth_creds.json';
+const TMP_DIR_NAME = 'tmp';
+const BIN_DIR_NAME = 'bin';
+export class Storage {
+    targetDir;
+    constructor(targetDir) {
+        this.targetDir = targetDir;
+    }
+    static getGlobalGeminiDir() {
+        const homeDir = homedir();
+        if (!homeDir) {
+            return path.join(os.tmpdir(), GEMINI_DIR);
+        }
+        return path.join(homeDir, GEMINI_DIR);
+    }
+    static getMcpOAuthTokensPath() {
+        return path.join(Storage.getGlobalGeminiDir(), 'mcp-oauth-tokens.json');
+    }
+    static getGlobalSettingsPath() {
+        return path.join(Storage.getGlobalGeminiDir(), 'settings.json');
+    }
+    static getInstallationIdPath() {
+        return path.join(Storage.getGlobalGeminiDir(), 'installation_id');
+    }
+    static getGoogleAccountsPath() {
+        return path.join(Storage.getGlobalGeminiDir(), GOOGLE_ACCOUNTS_FILENAME);
+    }
+    static getUserCommandsDir() {
+        return path.join(Storage.getGlobalGeminiDir(), 'commands');
+    }
+    static getUserSkillsDir() {
+        return path.join(Storage.getGlobalGeminiDir(), 'skills');
+    }
+    static getGlobalMemoryFilePath() {
+        return path.join(Storage.getGlobalGeminiDir(), 'memory.md');
+    }
+    static getUserPoliciesDir() {
+        return path.join(Storage.getGlobalGeminiDir(), 'policies');
+    }
+    static getUserAgentsDir() {
+        return path.join(Storage.getGlobalGeminiDir(), 'agents');
+    }
+    static getAcknowledgedAgentsPath() {
+        return path.join(Storage.getGlobalGeminiDir(), 'acknowledgments', 'agents.json');
+    }
+    static getSystemConfigDir() {
+        if (os.platform() === 'darwin') {
+            return '/Library/Application Support/GeminiCli';
+        }
+        else if (os.platform() === 'win32') {
+            return 'C:\\ProgramData\\gemini-cli';
+        }
+        else {
+            return '/etc/gemini-cli';
+        }
+    }
+    static getSystemSettingsPath() {
+        if (process.env['GEMINI_CLI_SYSTEM_SETTINGS_PATH']) {
+            return process.env['GEMINI_CLI_SYSTEM_SETTINGS_PATH'];
+        }
+        return path.join(Storage.getSystemConfigDir(), 'settings.json');
+    }
+    static getSystemPoliciesDir() {
+        return path.join(Storage.getSystemConfigDir(), 'policies');
+    }
+    static getGlobalTempDir() {
+        return path.join(Storage.getGlobalGeminiDir(), TMP_DIR_NAME);
+    }
+    static getGlobalBinDir() {
+        return path.join(Storage.getGlobalTempDir(), BIN_DIR_NAME);
+    }
+    getGeminiDir() {
+        return path.join(this.targetDir, GEMINI_DIR);
+    }
+    getProjectTempDir() {
+        const hash = this.getFilePathHash(this.getProjectRoot());
+        const tempDir = Storage.getGlobalTempDir();
+        return path.join(tempDir, hash);
+    }
+    ensureProjectTempDirExists() {
+        fs.mkdirSync(this.getProjectTempDir(), { recursive: true });
+    }
+    static getOAuthCredsPath() {
+        return path.join(Storage.getGlobalGeminiDir(), OAUTH_FILE);
+    }
+    getProjectRoot() {
+        return this.targetDir;
+    }
+    getFilePathHash(filePath) {
+        return crypto.createHash('sha256').update(filePath).digest('hex');
+    }
+    getHistoryDir() {
+        const hash = this.getFilePathHash(this.getProjectRoot());
+        const historyDir = path.join(Storage.getGlobalGeminiDir(), 'history');
+        return path.join(historyDir, hash);
+    }
+    getWorkspaceSettingsPath() {
+        return path.join(this.getGeminiDir(), 'settings.json');
+    }
+    getProjectCommandsDir() {
+        return path.join(this.getGeminiDir(), 'commands');
+    }
+    getProjectSkillsDir() {
+        return path.join(this.getGeminiDir(), 'skills');
+    }
+    getProjectAgentsDir() {
+        return path.join(this.getGeminiDir(), 'agents');
+    }
+    getProjectTempCheckpointsDir() {
+        return path.join(this.getProjectTempDir(), 'checkpoints');
+    }
+    getProjectTempLogsDir() {
+        return path.join(this.getProjectTempDir(), 'logs');
+    }
+    getProjectTempPlansDir() {
+        return path.join(this.getProjectTempDir(), 'plans');
+    }
+    getExtensionsDir() {
+        return path.join(this.getGeminiDir(), 'extensions');
+    }
+    getExtensionsConfigPath() {
+        return path.join(this.getExtensionsDir(), 'gemini-extension.json');
+    }
+    getHistoryFilePath() {
+        return path.join(this.getProjectTempDir(), 'shell_history');
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/src/config/storage.js.map

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

package/dist/src/confirmation-bus/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from './message-bus.js';
+export * from './types.js';

package/dist/src/confirmation-bus/index.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from './message-bus.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/src/confirmation-bus/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/confirmation-bus/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC"}

package/dist/src/confirmation-bus/message-bus.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { EventEmitter } from 'node:events';
+import type { PolicyEngine } from '../policy/policy-engine.js';
+import { type Message } from './types.js';
+export declare class MessageBus extends EventEmitter {
+    private readonly policyEngine;
+    private readonly debug;
+    constructor(policyEngine: PolicyEngine, debug?: boolean);
+    private isValidMessage;
+    private emitMessage;
+    publish(message: Message): Promise<void>;
+    subscribe<T extends Message>(type: T['type'], listener: (message: T) => void): void;
+    unsubscribe<T extends Message>(type: T['type'], listener: (message: T) => void): void;
+    /**
+     * Request-response pattern: Publish a message and wait for a correlated response
+     * This enables synchronous-style communication over the async MessageBus
+     * The correlation ID is generated internally and added to the request
+     */
+    request<TRequest extends Message, TResponse extends Message>(request: Omit<TRequest, 'correlationId'>, responseType: TResponse['type'], timeoutMs?: number): Promise<TResponse>;
+}

package/dist/src/confirmation-bus/message-bus.js

@@ -0,0 +1,120 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { randomUUID } from 'node:crypto';
+import { EventEmitter } from 'node:events';
+import { PolicyDecision } from '../policy/types.js';
+import { MessageBusType } from './types.js';
+import { safeJsonStringify } from '../utils/safeJsonStringify.js';
+import { debugLogger } from '../utils/debugLogger.js';
+export class MessageBus extends EventEmitter {
+    policyEngine;
+    debug;
+    constructor(policyEngine, debug = false) {
+        super();
+        this.policyEngine = policyEngine;
+        this.debug = debug;
+        this.debug = debug;
+    }
+    isValidMessage(message) {
+        if (!message || !message.type) {
+            return false;
+        }
+        if (message.type === MessageBusType.TOOL_CONFIRMATION_REQUEST &&
+            !('correlationId' in message)) {
+            return false;
+        }
+        return true;
+    }
+    emitMessage(message) {
+        this.emit(message.type, message);
+    }
+    async publish(message) {
+        if (this.debug) {
+            debugLogger.debug(`[MESSAGE_BUS] publish: ${safeJsonStringify(message)}`);
+        }
+        try {
+            if (!this.isValidMessage(message)) {
+                throw new Error(`Invalid message structure: ${safeJsonStringify(message)}`);
+            }
+            if (message.type === MessageBusType.TOOL_CONFIRMATION_REQUEST) {
+                const { decision } = await this.policyEngine.check(message.toolCall, message.serverName);
+                switch (decision) {
+                    case PolicyDecision.ALLOW:
+                        // Directly emit the response instead of recursive publish
+                        this.emitMessage({
+                            type: MessageBusType.TOOL_CONFIRMATION_RESPONSE,
+                            correlationId: message.correlationId,
+                            confirmed: true,
+                        });
+                        break;
+                    case PolicyDecision.DENY:
+                        // Emit both rejection and response messages
+                        this.emitMessage({
+                            type: MessageBusType.TOOL_POLICY_REJECTION,
+                            toolCall: message.toolCall,
+                        });
+                        this.emitMessage({
+                            type: MessageBusType.TOOL_CONFIRMATION_RESPONSE,
+                            correlationId: message.correlationId,
+                            confirmed: false,
+                        });
+                        break;
+                    case PolicyDecision.ASK_USER:
+                        // Pass through to UI for user confirmation
+                        this.emitMessage(message);
+                        break;
+                    default:
+                        throw new Error(`Unknown policy decision: ${decision}`);
+                }
+            }
+            else {
+                // For all other message types, just emit them
+                this.emitMessage(message);
+            }
+        }
+        catch (error) {
+            this.emit('error', error);
+        }
+    }
+    subscribe(type, listener) {
+        this.on(type, listener);
+    }
+    unsubscribe(type, listener) {
+        this.off(type, listener);
+    }
+    /**
+     * Request-response pattern: Publish a message and wait for a correlated response
+     * This enables synchronous-style communication over the async MessageBus
+     * The correlation ID is generated internally and added to the request
+     */
+    async request(request, responseType, timeoutMs = 60000) {
+        const correlationId = randomUUID();
+        return new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+                cleanup();
+                reject(new Error(`Request timed out waiting for ${responseType}`));
+            }, timeoutMs);
+            const cleanup = () => {
+                clearTimeout(timeoutId);
+                this.unsubscribe(responseType, responseHandler);
+            };
+            const responseHandler = (response) => {
+                // Check if this response matches our request
+                if ('correlationId' in response &&
+                    response.correlationId === correlationId) {
+                    cleanup();
+                    resolve(response);
+                }
+            };
+            // Subscribe to responses
+            this.subscribe(responseType, responseHandler);
+            // Publish the request with correlation ID
+            // eslint-disable-next-line @typescript-eslint/no-floating-promises
+            this.publish({ ...request, correlationId });
+        });
+    }
+}
+//# sourceMappingURL=message-bus.js.map

package/dist/src/confirmation-bus/message-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-bus.js","sourceRoot":"","sources":["../../../src/confirmation-bus/message-bus.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAgB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,OAAO,UAAW,SAAQ,YAAY;IAEvB;IACA;IAFnB,YACmB,YAA0B,EAC1B,QAAQ,KAAK;QAE9B,KAAK,EAAE,CAAC;QAHS,iBAAY,GAAZ,YAAY,CAAc;QAC1B,UAAK,GAAL,KAAK,CAAQ;QAG9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEO,cAAc,CAAC,OAAgB;QACrC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IACE,OAAO,CAAC,IAAI,KAAK,cAAc,CAAC,yBAAyB;YACzD,CAAC,CAAC,eAAe,IAAI,OAAO,CAAC,EAC7B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,WAAW,CAAC,OAAgB;QAClC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAgB;QAC5B,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,CAAC,0BAA0B,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CACb,8BAA8B,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAC3D,CAAC;YACJ,CAAC;YAED,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,CAAC,yBAAyB,EAAE,CAAC;gBAC9D,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAChD,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,UAAU,CACnB,CAAC;gBAEF,QAAQ,QAAQ,EAAE,CAAC;oBACjB,KAAK,cAAc,CAAC,KAAK;wBACvB,0DAA0D;wBAC1D,IAAI,CAAC,WAAW,CAAC;4BACf,IAAI,EAAE,cAAc,CAAC,0BAA0B;4BAC/C,aAAa,EAAE,OAAO,CAAC,aAAa;4BACpC,SAAS,EAAE,IAAI;yBAChB,CAAC,CAAC;wBACH,MAAM;oBACR,KAAK,cAAc,CAAC,IAAI;wBACtB,4CAA4C;wBAC5C,IAAI,CAAC,WAAW,CAAC;4BACf,IAAI,EAAE,cAAc,CAAC,qBAAqB;4BAC1C,QAAQ,EAAE,OAAO,CAAC,QAAQ;yBAC3B,CAAC,CAAC;wBACH,IAAI,CAAC,WAAW,CAAC;4BACf,IAAI,EAAE,cAAc,CAAC,0BAA0B;4BAC/C,aAAa,EAAE,OAAO,CAAC,aAAa;4BACpC,SAAS,EAAE,KAAK;yBACjB,CAAC,CAAC;wBACH,MAAM;oBACR,KAAK,cAAc,CAAC,QAAQ;wBAC1B,2CAA2C;wBAC3C,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;wBAC1B,MAAM;oBACR;wBACE,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,8CAA8C;gBAC9C,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,SAAS,CACP,IAAe,EACf,QAA8B;QAE9B,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAED,WAAW,CACT,IAAe,EACf,QAA8B;QAE9B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CACX,OAAwC,EACxC,YAA+B,EAC/B,YAAoB,KAAK;QAEzB,MAAM,aAAa,GAAG,UAAU,EAAE,CAAC;QAEnC,OAAO,IAAI,OAAO,CAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAChD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;gBAChC,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,YAAY,EAAE,CAAC,CAAC,CAAC;YACrE,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,YAAY,CAAC,SAAS,CAAC,CAAC;gBACxB,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;YAClD,CAAC,CAAC;YAEF,MAAM,eAAe,GAAG,CAAC,QAAmB,EAAE,EAAE;gBAC9C,6CAA6C;gBAC7C,IACE,eAAe,IAAI,QAAQ;oBAC3B,QAAQ,CAAC,aAAa,KAAK,aAAa,EACxC,CAAC;oBACD,OAAO,EAAE,CAAC;oBACV,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACpB,CAAC;YACH,CAAC,CAAC;YAEF,yBAAyB;YACzB,IAAI,CAAC,SAAS,CAAY,YAAY,EAAE,eAAe,CAAC,CAAC;YAEzD,0CAA0C;YAC1C,mEAAmE;YACnE,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,OAAO,EAAE,aAAa,EAAc,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/src/confirmation-bus/types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type FunctionCall } from '@google/genai';
+import type { ToolConfirmationOutcome, ToolConfirmationPayload } from '../tools/tools.js';
+import type { ToolCall } from '../scheduler/types.js';
+export declare enum MessageBusType {
+    TOOL_CONFIRMATION_REQUEST = "tool-confirmation-request",
+    TOOL_CONFIRMATION_RESPONSE = "tool-confirmation-response",
+    TOOL_POLICY_REJECTION = "tool-policy-rejection",
+    TOOL_EXECUTION_SUCCESS = "tool-execution-success",
+    TOOL_EXECUTION_FAILURE = "tool-execution-failure",
+    UPDATE_POLICY = "update-policy",
+    TOOL_CALLS_UPDATE = "tool-calls-update",
+    ASK_USER_REQUEST = "ask-user-request",
+    ASK_USER_RESPONSE = "ask-user-response"
+}
+export interface ToolCallsUpdateMessage {
+    type: MessageBusType.TOOL_CALLS_UPDATE;
+    toolCalls: ToolCall[];
+    schedulerId: string;
+}
+export interface ToolConfirmationRequest {
+    type: MessageBusType.TOOL_CONFIRMATION_REQUEST;
+    toolCall: FunctionCall;
+    correlationId: string;
+    serverName?: string;
+    /**
+     * Optional rich details for the confirmation UI (diffs, counts, etc.)
+     */
+    details?: SerializableConfirmationDetails;
+}
+export interface ToolConfirmationResponse {
+    type: MessageBusType.TOOL_CONFIRMATION_RESPONSE;
+    correlationId: string;
+    confirmed: boolean;
+    /**
+     * The specific outcome selected by the user.
+     *
+     * TODO: Make required after migration.
+     */
+    outcome?: ToolConfirmationOutcome;
+    /**
+     * Optional payload (e.g., modified content for 'modify_with_editor').
+     */
+    payload?: ToolConfirmationPayload;
+    /**
+     * When true, indicates that policy decision was ASK_USER and the tool should
+     * show its legacy confirmation UI instead of auto-proceeding.
+     */
+    requiresUserConfirmation?: boolean;
+}
+/**
+ * Data-only versions of ToolCallConfirmationDetails for bus transmission.
+ */
+export type SerializableConfirmationDetails = {
+    type: 'info';
+    title: string;
+    prompt: string;
+    urls?: string[];
+} | {
+    type: 'edit';
+    title: string;
+    fileName: string;
+    filePath: string;
+    fileDiff: string;
+    originalContent: string | null;
+    newContent: string;
+    isModifying?: boolean;
+} | {
+    type: 'exec';
+    title: string;
+    command: string;
+    rootCommand: string;
+    rootCommands: string[];
+    commands?: string[];
+} | {
+    type: 'mcp';
+    title: string;
+    serverName: string;
+    toolName: string;
+    toolDisplayName: string;
+} | {
+    type: 'ask_user';
+    title: string;
+    questions: Question[];
+};
+export interface UpdatePolicy {
+    type: MessageBusType.UPDATE_POLICY;
+    toolName: string;
+    persist?: boolean;
+    argsPattern?: string;
+    commandPrefix?: string | string[];
+    mcpName?: string;
+}
+export interface ToolPolicyRejection {
+    type: MessageBusType.TOOL_POLICY_REJECTION;
+    toolCall: FunctionCall;
+}
+export interface ToolExecutionSuccess<T = unknown> {
+    type: MessageBusType.TOOL_EXECUTION_SUCCESS;
+    toolCall: FunctionCall;
+    result: T;
+}
+export interface ToolExecutionFailure<E = Error> {
+    type: MessageBusType.TOOL_EXECUTION_FAILURE;
+    toolCall: FunctionCall;
+    error: E;
+}
+export interface QuestionOption {
+    label: string;
+    description: string;
+}
+export declare enum QuestionType {
+    CHOICE = "choice",
+    TEXT = "text",
+    YESNO = "yesno"
+}
+export interface Question {
+    question: string;
+    header: string;
+    /** Question type: 'choice' renders selectable options, 'text' renders free-form input, 'yesno' renders a binary Yes/No choice. Defaults to 'choice'. */
+    type?: QuestionType;
+    /** Selectable choices. REQUIRED when type='choice' or omitted. IGNORED for 'text' and 'yesno'. */
+    options?: QuestionOption[];
+    /** Allow multiple selections. Only applies when type='choice'. */
+    multiSelect?: boolean;
+    /** Placeholder hint text. Only applies when type='text'. */
+    placeholder?: string;
+}
+export interface AskUserRequest {
+    type: MessageBusType.ASK_USER_REQUEST;
+    questions: Question[];
+    correlationId: string;
+}
+export interface AskUserResponse {
+    type: MessageBusType.ASK_USER_RESPONSE;
+    correlationId: string;
+    answers: {
+        [questionIndex: string]: string;
+    };
+    /** When true, indicates the user cancelled the dialog without submitting answers */
+    cancelled?: boolean;
+}
+export type Message = ToolConfirmationRequest | ToolConfirmationResponse | ToolPolicyRejection | ToolExecutionSuccess | ToolExecutionFailure | UpdatePolicy | AskUserRequest | AskUserResponse | ToolCallsUpdateMessage;

package/dist/src/confirmation-bus/types.js

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {} from '@google/genai';
+export var MessageBusType;
+(function (MessageBusType) {
+    MessageBusType["TOOL_CONFIRMATION_REQUEST"] = "tool-confirmation-request";
+    MessageBusType["TOOL_CONFIRMATION_RESPONSE"] = "tool-confirmation-response";
+    MessageBusType["TOOL_POLICY_REJECTION"] = "tool-policy-rejection";
+    MessageBusType["TOOL_EXECUTION_SUCCESS"] = "tool-execution-success";
+    MessageBusType["TOOL_EXECUTION_FAILURE"] = "tool-execution-failure";
+    MessageBusType["UPDATE_POLICY"] = "update-policy";
+    MessageBusType["TOOL_CALLS_UPDATE"] = "tool-calls-update";
+    MessageBusType["ASK_USER_REQUEST"] = "ask-user-request";
+    MessageBusType["ASK_USER_RESPONSE"] = "ask-user-response";
+})(MessageBusType || (MessageBusType = {}));
+export var QuestionType;
+(function (QuestionType) {
+    QuestionType["CHOICE"] = "choice";
+    QuestionType["TEXT"] = "text";
+    QuestionType["YESNO"] = "yesno";
+})(QuestionType || (QuestionType = {}));
+//# sourceMappingURL=types.js.map

package/dist/src/confirmation-bus/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/confirmation-bus/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAqB,MAAM,eAAe,CAAC;AAOlD,MAAM,CAAN,IAAY,cAUX;AAVD,WAAY,cAAc;IACxB,yEAAuD,CAAA;IACvD,2EAAyD,CAAA;IACzD,iEAA+C,CAAA;IAC/C,mEAAiD,CAAA;IACjD,mEAAiD,CAAA;IACjD,iDAA+B,CAAA;IAC/B,yDAAuC,CAAA;IACvC,uDAAqC,CAAA;IACrC,yDAAuC,CAAA;AACzC,CAAC,EAVW,cAAc,KAAd,cAAc,QAUzB;AAgHD,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,6BAAa,CAAA;IACb,+BAAe,CAAA;AACjB,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB"}

package/dist/src/core/apiKeyCredentialStorage.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Load cached API key
+ */
+export declare function loadApiKey(): Promise<string | null>;
+/**
+ * Save API key
+ */
+export declare function saveApiKey(apiKey: string | null | undefined): Promise<void>;
+/**
+ * Clear cached API key
+ */
+export declare function clearApiKey(): Promise<void>;

package/dist/src/core/apiKeyCredentialStorage.js

@@ -0,0 +1,64 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HybridTokenStorage } from '../mcp/token-storage/hybrid-token-storage.js';
+import { debugLogger } from '../utils/debugLogger.js';
+const KEYCHAIN_SERVICE_NAME = 'gemini-cli-api-key';
+const DEFAULT_API_KEY_ENTRY = 'default-api-key';
+const storage = new HybridTokenStorage(KEYCHAIN_SERVICE_NAME);
+/**
+ * Load cached API key
+ */
+export async function loadApiKey() {
+    try {
+        const credentials = await storage.getCredentials(DEFAULT_API_KEY_ENTRY);
+        if (credentials?.token?.accessToken) {
+            return credentials.token.accessToken;
+        }
+        return null;
+    }
+    catch (error) {
+        // Log other errors but don't crash, just return null so user can re-enter key
+        debugLogger.error('Failed to load API key from storage:', error);
+        return null;
+    }
+}
+/**
+ * Save API key
+ */
+export async function saveApiKey(apiKey) {
+    if (!apiKey || apiKey.trim() === '') {
+        try {
+            await storage.deleteCredentials(DEFAULT_API_KEY_ENTRY);
+        }
+        catch (error) {
+            // Ignore errors when deleting, as it might not exist
+            debugLogger.warn('Failed to delete API key from storage:', error);
+        }
+        return;
+    }
+    // Wrap API key in OAuthCredentials format as required by HybridTokenStorage
+    const credentials = {
+        serverName: DEFAULT_API_KEY_ENTRY,
+        token: {
+            accessToken: apiKey,
+            tokenType: 'ApiKey',
+        },
+        updatedAt: Date.now(),
+    };
+    await storage.setCredentials(credentials);
+}
+/**
+ * Clear cached API key
+ */
+export async function clearApiKey() {
+    try {
+        await storage.deleteCredentials(DEFAULT_API_KEY_ENTRY);
+    }
+    catch (error) {
+        debugLogger.error('Failed to clear API key from storage:', error);
+    }
+}
+//# sourceMappingURL=apiKeyCredentialStorage.js.map

package/dist/src/core/apiKeyCredentialStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiKeyCredentialStorage.js","sourceRoot":"","sources":["../../../src/core/apiKeyCredentialStorage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,8CAA8C,CAAC;AAElF,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AACnD,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AAEhD,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;QAExE,IAAI,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;YACpC,OAAO,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC;QACvC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,8EAA8E;QAC9E,WAAW,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,MAAiC;IAEjC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,qDAAqD;YACrD,WAAW,CAAC,IAAI,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;QACpE,CAAC;QACD,OAAO;IACT,CAAC;IAED,4EAA4E;IAC5E,MAAM,WAAW,GAAqB;QACpC,UAAU,EAAE,qBAAqB;QACjC,KAAK,EAAE;YACL,WAAW,EAAE,MAAM;YACnB,SAAS,EAAE,QAAQ;SACpB;QACD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IAEF,MAAM,OAAO,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,iBAAiB,CAAC,qBAAqB,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,WAAW,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

package/dist/src/core/baseLlmClient.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Content, Part, GenerateContentResponse } from '@google/genai';
+import type { Config } from '../config/config.js';
+import type { ContentGenerator } from './contentGenerator.js';
+import type { AuthType } from './contentGenerator.js';
+import type { ModelConfigKey } from '../services/modelConfigService.js';
+/**
+ * Options for the generateJson utility function.
+ */
+export interface GenerateJsonOptions {
+    /** The desired model config. */
+    modelConfigKey: ModelConfigKey;
+    /** The input prompt or history. */
+    contents: Content[];
+    /** The required JSON schema for the output. */
+    schema: Record<string, unknown>;
+    /**
+     * Task-specific system instructions.
+     * If omitted, no system instruction is sent.
+     */
+    systemInstruction?: string | Part | Part[] | Content;
+    /** Signal for cancellation. */
+    abortSignal: AbortSignal;
+    /**
+     * A unique ID for the prompt, used for logging/telemetry correlation.
+     */
+    promptId: string;
+    /**
+     * The maximum number of attempts for the request.
+     */
+    maxAttempts?: number;
+}
+/**
+ * Options for the generateContent utility function.
+ */
+export interface GenerateContentOptions {
+    /** The desired model config. */
+    modelConfigKey: ModelConfigKey;
+    /** The input prompt or history. */
+    contents: Content[];
+    /**
+     * Task-specific system instructions.
+     * If omitted, no system instruction is sent.
+     */
+    systemInstruction?: string | Part | Part[] | Content;
+    /** Signal for cancellation. */
+    abortSignal: AbortSignal;
+    /**
+     * A unique ID for the prompt, used for logging/telemetry correlation.
+     */
+    promptId: string;
+    /**
+     * The maximum number of attempts for the request.
+     */
+    maxAttempts?: number;
+}
+/**
+ * A client dedicated to stateless, utility-focused LLM calls.
+ */
+export declare class BaseLlmClient {
+    private readonly contentGenerator;
+    private readonly config;
+    private readonly authType?;
+    constructor(contentGenerator: ContentGenerator, config: Config, authType?: AuthType | undefined);
+    generateJson(options: GenerateJsonOptions): Promise<Record<string, unknown>>;
+    generateEmbedding(texts: string[]): Promise<number[][]>;
+    private cleanJsonResponse;
+    generateContent(options: GenerateContentOptions): Promise<GenerateContentResponse>;
+    private _generateWithRetry;
+}