@anthropic-field/core 0.1.0

package/dist/src/utils/errors.js

@@ -0,0 +1,145 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export function isNodeError(error) {
+    return error instanceof Error && 'code' in error;
+}
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    try {
+        return String(error);
+    }
+    catch {
+        return 'Failed to get error details';
+    }
+}
+export class FatalError extends Error {
+    exitCode;
+    constructor(message, exitCode) {
+        super(message);
+        this.exitCode = exitCode;
+    }
+}
+export class FatalAuthenticationError extends FatalError {
+    constructor(message) {
+        super(message, 41);
+    }
+}
+export class FatalInputError extends FatalError {
+    constructor(message) {
+        super(message, 42);
+    }
+}
+export class FatalSandboxError extends FatalError {
+    constructor(message) {
+        super(message, 44);
+    }
+}
+export class FatalConfigError extends FatalError {
+    constructor(message) {
+        super(message, 52);
+    }
+}
+export class FatalTurnLimitedError extends FatalError {
+    constructor(message) {
+        super(message, 53);
+    }
+}
+export class FatalToolExecutionError extends FatalError {
+    constructor(message) {
+        super(message, 54);
+    }
+}
+export class FatalCancellationError extends FatalError {
+    constructor(message) {
+        super(message, 130); // Standard exit code for SIGINT
+    }
+}
+export class CanceledError extends Error {
+    constructor(message = 'The operation was canceled.') {
+        super(message);
+        this.name = 'CanceledError';
+    }
+}
+export class ForbiddenError extends Error {
+}
+export class UnauthorizedError extends Error {
+}
+export class BadRequestError extends Error {
+}
+export class ChangeAuthRequestedError extends Error {
+    constructor() {
+        super('User requested to change authentication method');
+        this.name = 'ChangeAuthRequestedError';
+    }
+}
+export function toFriendlyError(error) {
+    if (error && typeof error === 'object' && 'response' in error) {
+        const gaxiosError = error;
+        const data = parseResponseData(gaxiosError);
+        if (data && data.error && data.error.message && data.error.code) {
+            switch (data.error.code) {
+                case 400:
+                    return new BadRequestError(data.error.message);
+                case 401:
+                    return new UnauthorizedError(data.error.message);
+                case 403:
+                    // It's import to pass the message here since it might
+                    // explain the cause like "the cloud project you're
+                    // using doesn't have code assist enabled".
+                    return new ForbiddenError(data.error.message);
+                default:
+            }
+        }
+    }
+    return error;
+}
+function parseResponseData(error) {
+    // Inexplicably, Gaxios sometimes doesn't JSONify the response data.
+    if (typeof error.response?.data === 'string') {
+        try {
+            return JSON.parse(error.response?.data);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return error.response?.data;
+}
+/**
+ * Checks if an error is a 401 authentication error.
+ * Uses structured error properties from MCP SDK errors.
+ *
+ * @param error The error to check
+ * @returns true if this is a 401/authentication error
+ */
+export function isAuthenticationError(error) {
+    // Check for MCP SDK errors with code property
+    // (SseError and StreamableHTTPError both have numeric 'code' property)
+    if (error && typeof error === 'object' && 'code' in error) {
+        const errorCode = error.code;
+        if (errorCode === 401) {
+            return true;
+        }
+    }
+    // Check for UnauthorizedError class (from MCP SDK or our own)
+    if (error instanceof Error &&
+        error.constructor.name === 'UnauthorizedError') {
+        return true;
+    }
+    if (error instanceof UnauthorizedError) {
+        return true;
+    }
+    // Fallback: Check for MCP SDK's plain Error messages with HTTP 401
+    // The SDK sometimes throws: new Error(`Error POSTing to endpoint (HTTP 401): ...`)
+    const message = getErrorMessage(error);
+    if (message.includes('401')) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/utils/errors.js.map

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

package/dist/src/utils/events.d.ts

@@ -0,0 +1,211 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { EventEmitter } from 'node:events';
+import type { AgentDefinition } from '../agents/types.js';
+import type { McpClient } from '../tools/mcp-client.js';
+import type { ExtensionEvents } from './extensionLoader.js';
+/**
+ * Defines the severity level for user-facing feedback.
+ * This maps loosely to UI `MessageType`
+ */
+export type FeedbackSeverity = 'info' | 'warning' | 'error';
+/**
+ * Payload for the 'user-feedback' event.
+ */
+export interface UserFeedbackPayload {
+    /**
+     * The severity level determines how the message is rendered in the UI
+     * (e.g. colored text, specific icon).
+     */
+    severity: FeedbackSeverity;
+    /**
+     * The main message to display to the user in the chat history or stdout.
+     */
+    message: string;
+    /**
+     * The original error object, if applicable.
+     * Listeners can use this to extract stack traces for debug logging
+     * or verbose output, while keeping the 'message' field clean for end users.
+     */
+    error?: unknown;
+}
+/**
+ * Payload for the 'model-changed' event.
+ */
+export interface ModelChangedPayload {
+    /**
+     * The new model that was set.
+     */
+    model: string;
+}
+/**
+ * Payload for the 'console-log' event.
+ */
+export interface ConsoleLogPayload {
+    type: 'log' | 'warn' | 'error' | 'debug' | 'info';
+    content: string;
+}
+/**
+ * Payload for the 'output' event.
+ */
+export interface OutputPayload {
+    isStderr: boolean;
+    chunk: Uint8Array | string;
+    encoding?: BufferEncoding;
+}
+/**
+ * Payload for the 'memory-changed' event.
+ */
+export interface MemoryChangedPayload {
+    fileCount: number;
+}
+/**
+ * Base payload for hook-related events.
+ */
+export interface HookPayload {
+    hookName: string;
+    eventName: string;
+}
+/**
+ * Payload for the 'hook-start' event.
+ */
+export interface HookStartPayload extends HookPayload {
+    /**
+     * The 1-based index of the current hook in the execution sequence.
+     * Used for progress indication (e.g. "Hook 1/3").
+     */
+    hookIndex?: number;
+    /**
+     * The total number of hooks in the current execution sequence.
+     */
+    totalHooks?: number;
+}
+/**
+ * Payload for the 'hook-end' event.
+ */
+export interface HookEndPayload extends HookPayload {
+    success: boolean;
+}
+/**
+ * Payload for the 'retry-attempt' event.
+ */
+export interface RetryAttemptPayload {
+    attempt: number;
+    maxAttempts: number;
+    delayMs: number;
+    error?: string;
+    model: string;
+}
+/**
+ * Payload for the 'consent-request' event.
+ */
+export interface ConsentRequestPayload {
+    prompt: string;
+    onConfirm: (confirmed: boolean) => void;
+}
+/**
+ * Payload for the 'agents-discovered' event.
+ */
+export interface AgentsDiscoveredPayload {
+    agents: AgentDefinition[];
+}
+export declare enum CoreEvent {
+    UserFeedback = "user-feedback",
+    ModelChanged = "model-changed",
+    ConsoleLog = "console-log",
+    Output = "output",
+    MemoryChanged = "memory-changed",
+    ExternalEditorClosed = "external-editor-closed",
+    McpClientUpdate = "mcp-client-update",
+    OauthDisplayMessage = "oauth-display-message",
+    SettingsChanged = "settings-changed",
+    HookStart = "hook-start",
+    HookEnd = "hook-end",
+    AgentsRefreshed = "agents-refreshed",
+    AdminSettingsChanged = "admin-settings-changed",
+    RetryAttempt = "retry-attempt",
+    ConsentRequest = "consent-request",
+    AgentsDiscovered = "agents-discovered"
+}
+export interface CoreEvents extends ExtensionEvents {
+    [CoreEvent.UserFeedback]: [UserFeedbackPayload];
+    [CoreEvent.ModelChanged]: [ModelChangedPayload];
+    [CoreEvent.ConsoleLog]: [ConsoleLogPayload];
+    [CoreEvent.Output]: [OutputPayload];
+    [CoreEvent.MemoryChanged]: [MemoryChangedPayload];
+    [CoreEvent.ExternalEditorClosed]: never[];
+    [CoreEvent.McpClientUpdate]: Array<Map<string, McpClient> | never>;
+    [CoreEvent.OauthDisplayMessage]: string[];
+    [CoreEvent.SettingsChanged]: never[];
+    [CoreEvent.HookStart]: [HookStartPayload];
+    [CoreEvent.HookEnd]: [HookEndPayload];
+    [CoreEvent.AgentsRefreshed]: never[];
+    [CoreEvent.AdminSettingsChanged]: never[];
+    [CoreEvent.RetryAttempt]: [RetryAttemptPayload];
+    [CoreEvent.ConsentRequest]: [ConsentRequestPayload];
+    [CoreEvent.AgentsDiscovered]: [AgentsDiscoveredPayload];
+}
+export declare class CoreEventEmitter extends EventEmitter<CoreEvents> {
+    private _eventBacklog;
+    private static readonly MAX_BACKLOG_SIZE;
+    constructor();
+    private _emitOrQueue;
+    /**
+     * Sends actionable feedback to the user.
+     * Buffers automatically if the UI hasn't subscribed yet.
+     */
+    emitFeedback(severity: FeedbackSeverity, message: string, error?: unknown): void;
+    /**
+     * Broadcasts a console log message.
+     */
+    emitConsoleLog(type: 'log' | 'warn' | 'error' | 'debug' | 'info', content: string): void;
+    /**
+     * Broadcasts stdout/stderr output.
+     */
+    emitOutput(isStderr: boolean, chunk: Uint8Array | string, encoding?: BufferEncoding): void;
+    /**
+     * Notifies subscribers that the model has changed.
+     */
+    emitModelChanged(model: string): void;
+    /**
+     * Notifies subscribers that settings have been modified.
+     */
+    emitSettingsChanged(): void;
+    /**
+     * Notifies subscribers that a hook execution has started.
+     */
+    emitHookStart(payload: HookStartPayload): void;
+    /**
+     * Notifies subscribers that a hook execution has ended.
+     */
+    emitHookEnd(payload: HookEndPayload): void;
+    /**
+     * Notifies subscribers that agents have been refreshed.
+     */
+    emitAgentsRefreshed(): void;
+    /**
+     * Notifies subscribers that admin settings have changed.
+     */
+    emitAdminSettingsChanged(): void;
+    /**
+     * Notifies subscribers that a retry attempt is happening.
+     */
+    emitRetryAttempt(payload: RetryAttemptPayload): void;
+    /**
+     * Requests consent from the user via the UI.
+     */
+    emitConsentRequest(payload: ConsentRequestPayload): void;
+    /**
+     * Notifies subscribers that new unacknowledged agents have been discovered.
+     */
+    emitAgentsDiscovered(agents: AgentDefinition[]): void;
+    /**
+     * Flushes buffered messages. Call this immediately after primary UI listener
+     * subscribes.
+     */
+    drainBacklogs(): void;
+}
+export declare const coreEvents: CoreEventEmitter;

package/dist/src/utils/events.js

@@ -0,0 +1,134 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { EventEmitter } from 'node:events';
+export var CoreEvent;
+(function (CoreEvent) {
+    CoreEvent["UserFeedback"] = "user-feedback";
+    CoreEvent["ModelChanged"] = "model-changed";
+    CoreEvent["ConsoleLog"] = "console-log";
+    CoreEvent["Output"] = "output";
+    CoreEvent["MemoryChanged"] = "memory-changed";
+    CoreEvent["ExternalEditorClosed"] = "external-editor-closed";
+    CoreEvent["McpClientUpdate"] = "mcp-client-update";
+    CoreEvent["OauthDisplayMessage"] = "oauth-display-message";
+    CoreEvent["SettingsChanged"] = "settings-changed";
+    CoreEvent["HookStart"] = "hook-start";
+    CoreEvent["HookEnd"] = "hook-end";
+    CoreEvent["AgentsRefreshed"] = "agents-refreshed";
+    CoreEvent["AdminSettingsChanged"] = "admin-settings-changed";
+    CoreEvent["RetryAttempt"] = "retry-attempt";
+    CoreEvent["ConsentRequest"] = "consent-request";
+    CoreEvent["AgentsDiscovered"] = "agents-discovered";
+})(CoreEvent || (CoreEvent = {}));
+export class CoreEventEmitter extends EventEmitter {
+    _eventBacklog = [];
+    static MAX_BACKLOG_SIZE = 10000;
+    constructor() {
+        super();
+    }
+    _emitOrQueue(event, ...args) {
+        if (this.listenerCount(event) === 0) {
+            if (this._eventBacklog.length >= CoreEventEmitter.MAX_BACKLOG_SIZE) {
+                this._eventBacklog.shift();
+            }
+            this._eventBacklog.push({ event, args });
+        }
+        else {
+            this.emit(event, ...args);
+        }
+    }
+    /**
+     * Sends actionable feedback to the user.
+     * Buffers automatically if the UI hasn't subscribed yet.
+     */
+    emitFeedback(severity, message, error) {
+        const payload = { severity, message, error };
+        this._emitOrQueue(CoreEvent.UserFeedback, payload);
+    }
+    /**
+     * Broadcasts a console log message.
+     */
+    emitConsoleLog(type, content) {
+        const payload = { type, content };
+        this._emitOrQueue(CoreEvent.ConsoleLog, payload);
+    }
+    /**
+     * Broadcasts stdout/stderr output.
+     */
+    emitOutput(isStderr, chunk, encoding) {
+        const payload = { isStderr, chunk, encoding };
+        this._emitOrQueue(CoreEvent.Output, payload);
+    }
+    /**
+     * Notifies subscribers that the model has changed.
+     */
+    emitModelChanged(model) {
+        const payload = { model };
+        this.emit(CoreEvent.ModelChanged, payload);
+    }
+    /**
+     * Notifies subscribers that settings have been modified.
+     */
+    emitSettingsChanged() {
+        this.emit(CoreEvent.SettingsChanged);
+    }
+    /**
+     * Notifies subscribers that a hook execution has started.
+     */
+    emitHookStart(payload) {
+        this.emit(CoreEvent.HookStart, payload);
+    }
+    /**
+     * Notifies subscribers that a hook execution has ended.
+     */
+    emitHookEnd(payload) {
+        this.emit(CoreEvent.HookEnd, payload);
+    }
+    /**
+     * Notifies subscribers that agents have been refreshed.
+     */
+    emitAgentsRefreshed() {
+        this.emit(CoreEvent.AgentsRefreshed);
+    }
+    /**
+     * Notifies subscribers that admin settings have changed.
+     */
+    emitAdminSettingsChanged() {
+        this.emit(CoreEvent.AdminSettingsChanged);
+    }
+    /**
+     * Notifies subscribers that a retry attempt is happening.
+     */
+    emitRetryAttempt(payload) {
+        this.emit(CoreEvent.RetryAttempt, payload);
+    }
+    /**
+     * Requests consent from the user via the UI.
+     */
+    emitConsentRequest(payload) {
+        this._emitOrQueue(CoreEvent.ConsentRequest, payload);
+    }
+    /**
+     * Notifies subscribers that new unacknowledged agents have been discovered.
+     */
+    emitAgentsDiscovered(agents) {
+        const payload = { agents };
+        this._emitOrQueue(CoreEvent.AgentsDiscovered, payload);
+    }
+    /**
+     * Flushes buffered messages. Call this immediately after primary UI listener
+     * subscribes.
+     */
+    drainBacklogs() {
+        const backlog = [...this._eventBacklog];
+        this._eventBacklog.length = 0; // Clear in-place
+        for (const item of backlog) {
+            this.emit(item.event, ...item.args);
+        }
+    }
+}
+export const coreEvents = new CoreEventEmitter();
+//# sourceMappingURL=events.js.map

package/dist/src/utils/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/utils/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA0H3C,MAAM,CAAN,IAAY,SAiBX;AAjBD,WAAY,SAAS;IACnB,2CAA8B,CAAA;IAC9B,2CAA8B,CAAA;IAC9B,uCAA0B,CAAA;IAC1B,8BAAiB,CAAA;IACjB,6CAAgC,CAAA;IAChC,4DAA+C,CAAA;IAC/C,kDAAqC,CAAA;IACrC,0DAA6C,CAAA;IAC7C,iDAAoC,CAAA;IACpC,qCAAwB,CAAA;IACxB,iCAAoB,CAAA;IACpB,iDAAoC,CAAA;IACpC,4DAA+C,CAAA;IAC/C,2CAA8B,CAAA;IAC9B,+CAAkC,CAAA;IAClC,mDAAsC,CAAA;AACxC,CAAC,EAjBW,SAAS,KAAT,SAAS,QAiBpB;AA4BD,MAAM,OAAO,gBAAiB,SAAQ,YAAwB;IACpD,aAAa,GAAuB,EAAE,CAAC;IACvC,MAAM,CAAU,gBAAgB,GAAG,KAAK,CAAC;IAEjD;QACE,KAAK,EAAE,CAAC;IACV,CAAC;IAEO,YAAY,CAClB,KAAQ,EACR,GAAG,IAAmB;QAEtB,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,IAAI,gBAAgB,CAAC,gBAAgB,EAAE,CAAC;gBACnE,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;YAC7B,CAAC;YACD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAsB,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YAEJ,IAAI,CAAC,IAIN,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,YAAY,CACV,QAA0B,EAC1B,OAAe,EACf,KAAe;QAEf,MAAM,OAAO,GAAwB,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAClE,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,cAAc,CACZ,IAAiD,EACjD,OAAe;QAEf,MAAM,OAAO,GAAsB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACrD,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,UAAU,CACR,QAAiB,EACjB,KAA0B,EAC1B,QAAyB;QAEzB,MAAM,OAAO,GAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC7D,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,KAAa;QAC5B,MAAM,OAAO,GAAwB,EAAE,KAAK,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAyB;QACrC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAuB;QACjC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,wBAAwB;QACtB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,OAA4B;QAC3C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,OAA8B;QAC/C,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,MAAyB;QAC5C,MAAM,OAAO,GAA4B,EAAE,MAAM,EAAE,CAAC;QACpD,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;QACxC,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,iBAAiB;QAChD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAEzB,IAAI,CAAC,IAIN,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;;AAGH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/src/utils/exitCodes.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const ExitCodes: {
+    readonly SUCCESS: 0;
+    readonly FATAL_AUTHENTICATION_ERROR: 41;
+    readonly FATAL_INPUT_ERROR: 42;
+    readonly FATAL_CONFIG_ERROR: 52;
+    readonly FATAL_CANCELLATION_ERROR: 130;
+};

package/dist/src/utils/exitCodes.js

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const ExitCodes = {
+    SUCCESS: 0,
+    FATAL_AUTHENTICATION_ERROR: 41,
+    FATAL_INPUT_ERROR: 42,
+    FATAL_CONFIG_ERROR: 52,
+    FATAL_CANCELLATION_ERROR: 130,
+};
+//# sourceMappingURL=exitCodes.js.map

package/dist/src/utils/exitCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exitCodes.js","sourceRoot":"","sources":["../../../src/utils/exitCodes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,OAAO,EAAE,CAAC;IACV,0BAA0B,EAAE,EAAE;IAC9B,iBAAiB,EAAE,EAAE;IACrB,kBAAkB,EAAE,EAAE;IACtB,wBAAwB,EAAE,GAAG;CACrB,CAAC"}

package/dist/src/utils/extensionLoader.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { EventEmitter } from 'node:events';
+import type { Config, GeminiCLIExtension } from '../config/config.js';
+export declare abstract class ExtensionLoader {
+    private readonly eventEmitter?;
+    protected config: Config | undefined;
+    protected startingCount: number;
+    protected startCompletedCount: number;
+    protected stoppingCount: number;
+    protected stopCompletedCount: number;
+    private isStarting;
+    constructor(eventEmitter?: EventEmitter<ExtensionEvents> | undefined);
+    /**
+     * All currently known extensions, both active and inactive.
+     */
+    abstract getExtensions(): GeminiCLIExtension[];
+    /**
+     * Fully initializes all active extensions.
+     *
+     * Called within `Config.initialize`, which must already have an
+     * McpClientManager, PromptRegistry, and GeminiChat set up.
+     */
+    start(config: Config): Promise<void>;
+    /**
+     * Unconditionally starts an `extension` and loads all its MCP servers,
+     * context, custom commands, etc. Assumes that `start` has already been called
+     * and we have a Config object.
+     *
+     * This should typically only be called from `start`, most other calls should
+     * go through `maybeStartExtension` which will only start the extension if
+     * extension reloading is enabled and the `config` object is initialized.
+     */
+    protected startExtension(extension: GeminiCLIExtension): Promise<void>;
+    private maybeRefreshMemories;
+    /**
+     * Refreshes the gemini tools list if it is initialized and the extension has
+     * any excludeTools settings.
+     */
+    private maybeRefreshGeminiTools;
+    /**
+     * If extension reloading is enabled and `start` has already been called,
+     * then calls `startExtension` to include all extension features into the
+     * program.
+     */
+    protected maybeStartExtension(extension: GeminiCLIExtension): Promise<void>;
+    /**
+     * Unconditionally stops an `extension` and unloads all its MCP servers,
+     * context, custom commands, etc. Assumes that `start` has already been called
+     * and we have a Config object.
+     *
+     * Most calls should go through `maybeStopExtension` which will only stop the
+     * extension if extension reloading is enabled and the `config` object is
+     * initialized.
+     */
+    protected stopExtension(extension: GeminiCLIExtension): Promise<void>;
+    /**
+     * If extension reloading is enabled and `start` has already been called,
+     * then this also performs all necessary steps to remove all extension
+     * features from the rest of the system.
+     */
+    protected maybeStopExtension(extension: GeminiCLIExtension): Promise<void>;
+    restartExtension(extension: GeminiCLIExtension): Promise<void>;
+}
+export interface ExtensionEvents {
+    extensionsStarting: ExtensionsStartingEvent[];
+    extensionsStopping: ExtensionsStoppingEvent[];
+}
+export interface ExtensionsStartingEvent {
+    total: number;
+    completed: number;
+}
+export interface ExtensionsStoppingEvent {
+    total: number;
+    completed: number;
+}
+export declare class SimpleExtensionLoader extends ExtensionLoader {
+    protected readonly extensions: GeminiCLIExtension[];
+    constructor(extensions: GeminiCLIExtension[], eventEmitter?: EventEmitter<ExtensionEvents>);
+    getExtensions(): GeminiCLIExtension[];
+    loadExtension(extension: GeminiCLIExtension): Promise<void>;
+    unloadExtension(extension: GeminiCLIExtension): Promise<void>;
+}