@didim365/agent-cli-core 0.1.0

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

@@ -0,0 +1,198 @@
+/**
+ * @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 '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",
+    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.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;
+    /**
+     * 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,127 @@
+/**
+ * @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["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);
+    }
+    /**
+     * 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":"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"}

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

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

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

@@ -0,0 +1,237 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { CoreEventEmitter, CoreEvent, } from './events.js';
+describe('CoreEventEmitter', () => {
+    let events;
+    beforeEach(() => {
+        events = new CoreEventEmitter();
+    });
+    it('should emit feedback immediately when a listener is present', () => {
+        const listener = vi.fn();
+        events.on(CoreEvent.UserFeedback, listener);
+        const payload = {
+            severity: 'info',
+            message: 'Test message',
+        };
+        events.emitFeedback(payload.severity, payload.message);
+        expect(listener).toHaveBeenCalledTimes(1);
+        expect(listener).toHaveBeenCalledWith(expect.objectContaining(payload));
+    });
+    it('should buffer feedback when no listener is present', () => {
+        const listener = vi.fn();
+        const payload = {
+            severity: 'warning',
+            message: 'Buffered message',
+        };
+        // Emit while no listeners attached
+        events.emitFeedback(payload.severity, payload.message);
+        expect(listener).not.toHaveBeenCalled();
+        // Attach listener and drain
+        events.on(CoreEvent.UserFeedback, listener);
+        events.drainBacklogs();
+        expect(listener).toHaveBeenCalledTimes(1);
+        expect(listener).toHaveBeenCalledWith(expect.objectContaining(payload));
+    });
+    it('should respect the backlog size limit and maintain FIFO order', () => {
+        const listener = vi.fn();
+        const MAX_BACKLOG_SIZE = 10000;
+        for (let i = 0; i < MAX_BACKLOG_SIZE + 10; i++) {
+            events.emitFeedback('info', `Message ${i}`);
+        }
+        events.on(CoreEvent.UserFeedback, listener);
+        events.drainBacklogs();
+        expect(listener).toHaveBeenCalledTimes(MAX_BACKLOG_SIZE);
+        // Verify strictly that the FIRST call was Message 10 (0-9 dropped)
+        expect(listener.mock.calls[0][0]).toMatchObject({ message: 'Message 10' });
+        // Verify strictly that the LAST call was Message 109
+        expect(listener.mock.lastCall?.[0]).toMatchObject({
+            message: `Message ${MAX_BACKLOG_SIZE + 9}`,
+        });
+    });
+    it('should clear the backlog after draining', () => {
+        const listener = vi.fn();
+        events.emitFeedback('error', 'Test error');
+        events.on(CoreEvent.UserFeedback, listener);
+        events.drainBacklogs();
+        expect(listener).toHaveBeenCalledTimes(1);
+        listener.mockClear();
+        events.drainBacklogs();
+        expect(listener).not.toHaveBeenCalled();
+    });
+    it('should include optional error object in payload', () => {
+        const listener = vi.fn();
+        events.on(CoreEvent.UserFeedback, listener);
+        const error = new Error('Original error');
+        events.emitFeedback('error', 'Something went wrong', error);
+        expect(listener).toHaveBeenCalledWith(expect.objectContaining({
+            severity: 'error',
+            message: 'Something went wrong',
+            error,
+        }));
+    });
+    it('should handle multiple listeners correctly', () => {
+        const listenerA = vi.fn();
+        const listenerB = vi.fn();
+        events.on(CoreEvent.UserFeedback, listenerA);
+        events.on(CoreEvent.UserFeedback, listenerB);
+        events.emitFeedback('info', 'Broadcast message');
+        expect(listenerA).toHaveBeenCalledTimes(1);
+        expect(listenerB).toHaveBeenCalledTimes(1);
+    });
+    it('should stop receiving events after off() is called', () => {
+        const listener = vi.fn();
+        events.on(CoreEvent.UserFeedback, listener);
+        events.emitFeedback('info', 'First message');
+        expect(listener).toHaveBeenCalledTimes(1);
+        events.off(CoreEvent.UserFeedback, listener);
+        events.emitFeedback('info', 'Second message');
+        expect(listener).toHaveBeenCalledTimes(1); // Still 1
+    });
+    it('should handle re-entrant feedback emission during draining safely', () => {
+        events.emitFeedback('info', 'Buffered 1');
+        events.emitFeedback('info', 'Buffered 2');
+        const listener = vi.fn((payload) => {
+            // When 'Buffered 1' is received, immediately emit another event.
+            if (payload.message === 'Buffered 1') {
+                events.emitFeedback('warning', 'Re-entrant message');
+            }
+        });
+        events.on(CoreEvent.UserFeedback, listener);
+        events.drainBacklogs();
+        // Expectation with atomic snapshot:
+        // 1. loop starts with ['Buffered 1', 'Buffered 2']
+        // 2. emits 'Buffered 1'
+        // 3. listener fires for 'Buffered 1', calls emitFeedback('Re-entrant')
+        // 4. emitFeedback sees listener attached, emits 'Re-entrant' synchronously
+        // 5. listener fires for 'Re-entrant'
+        // 6. loop continues, emits 'Buffered 2'
+        // 7. listener fires for 'Buffered 2'
+        expect(listener).toHaveBeenCalledTimes(3);
+        expect(listener.mock.calls[0][0]).toMatchObject({ message: 'Buffered 1' });
+        expect(listener.mock.calls[1][0]).toMatchObject({
+            message: 'Re-entrant message',
+        });
+        expect(listener.mock.calls[2][0]).toMatchObject({ message: 'Buffered 2' });
+    });
+    describe('ConsoleLog Event', () => {
+        it('should emit console log immediately when a listener is present', () => {
+            const listener = vi.fn();
+            events.on(CoreEvent.ConsoleLog, listener);
+            const payload = {
+                type: 'info',
+                content: 'Test log',
+            };
+            events.emitConsoleLog(payload.type, payload.content);
+            expect(listener).toHaveBeenCalledTimes(1);
+            expect(listener).toHaveBeenCalledWith(expect.objectContaining(payload));
+        });
+        it('should buffer console logs when no listener is present', () => {
+            const listener = vi.fn();
+            const payload = {
+                type: 'warn',
+                content: 'Buffered log',
+            };
+            // Emit while no listeners attached
+            events.emitConsoleLog(payload.type, payload.content);
+            expect(listener).not.toHaveBeenCalled();
+            // Attach listener and drain
+            events.on(CoreEvent.ConsoleLog, listener);
+            events.drainBacklogs();
+            expect(listener).toHaveBeenCalledTimes(1);
+            expect(listener).toHaveBeenCalledWith(expect.objectContaining(payload));
+        });
+        it('should respect the backlog size limit for console logs', () => {
+            const listener = vi.fn();
+            const MAX_BACKLOG_SIZE = 10000;
+            for (let i = 0; i < MAX_BACKLOG_SIZE + 10; i++) {
+                events.emitConsoleLog('debug', `Log ${i}`);
+            }
+            events.on(CoreEvent.ConsoleLog, listener);
+            events.drainBacklogs();
+            expect(listener).toHaveBeenCalledTimes(MAX_BACKLOG_SIZE);
+            // Verify strictly that the FIRST call was Log 10 (0-9 dropped)
+            expect(listener.mock.calls[0][0]).toMatchObject({ content: 'Log 10' });
+        });
+    });
+    describe('Output Event', () => {
+        it('should emit output immediately when a listener is present', () => {
+            const listener = vi.fn();
+            events.on(CoreEvent.Output, listener);
+            const payload = {
+                isStderr: false,
+                chunk: 'Test output',
+                encoding: 'utf8',
+            };
+            events.emitOutput(payload.isStderr, payload.chunk, payload.encoding);
+            expect(listener).toHaveBeenCalledTimes(1);
+            expect(listener).toHaveBeenCalledWith(expect.objectContaining(payload));
+        });
+        it('should buffer output when no listener is present', () => {
+            const listener = vi.fn();
+            const payload = {
+                isStderr: true,
+                chunk: 'Buffered output',
+            };
+            // Emit while no listeners attached
+            events.emitOutput(payload.isStderr, payload.chunk);
+            expect(listener).not.toHaveBeenCalled();
+            // Attach listener and drain
+            events.on(CoreEvent.Output, listener);
+            events.drainBacklogs();
+            expect(listener).toHaveBeenCalledTimes(1);
+            expect(listener).toHaveBeenCalledWith(expect.objectContaining(payload));
+        });
+        it('should respect the backlog size limit for output', () => {
+            const listener = vi.fn();
+            const MAX_BACKLOG_SIZE = 10000;
+            for (let i = 0; i < MAX_BACKLOG_SIZE + 10; i++) {
+                events.emitOutput(false, `Output ${i}`);
+            }
+            events.on(CoreEvent.Output, listener);
+            events.drainBacklogs();
+            expect(listener).toHaveBeenCalledTimes(MAX_BACKLOG_SIZE);
+            // Verify strictly that the FIRST call was Output 10 (0-9 dropped)
+            expect(listener.mock.calls[0][0]).toMatchObject({ chunk: 'Output 10' });
+        });
+    });
+    describe('ModelChanged Event', () => {
+        it('should emit ModelChanged event with correct payload', () => {
+            const listener = vi.fn();
+            events.on(CoreEvent.ModelChanged, listener);
+            const newModel = 'gemini-2.5-pro';
+            events.emitModelChanged(newModel);
+            expect(listener).toHaveBeenCalledTimes(1);
+            expect(listener).toHaveBeenCalledWith({ model: newModel });
+        });
+    });
+    describe('Hook Events', () => {
+        it('should emit HookStart event with correct payload using helper', () => {
+            const listener = vi.fn();
+            events.on(CoreEvent.HookStart, listener);
+            const payload = {
+                hookName: 'test-hook',
+                eventName: 'before-agent',
+                hookIndex: 1,
+                totalHooks: 1,
+            };
+            events.emitHookStart(payload);
+            expect(listener).toHaveBeenCalledWith(payload);
+        });
+        it('should emit HookEnd event with correct payload using helper', () => {
+            const listener = vi.fn();
+            events.on(CoreEvent.HookEnd, listener);
+            const payload = {
+                hookName: 'test-hook',
+                eventName: 'before-agent',
+                success: true,
+            };
+            events.emitHookEnd(payload);
+            expect(listener).toHaveBeenCalledWith(payload);
+        });
+    });
+});
+//# sourceMappingURL=events.test.js.map

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

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

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"}