@didim365/agent-cli-core 0.1.0

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

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Content } from '@google/genai';
+/**
+ * @deprecated Use {@link isToolResultMessage} from './llmUtils.js' for provider-independent code.
+ * This Content-based helper will be removed after full migration to LlmMessage types.
+ */
+export declare function isFunctionResponse(content: Content): boolean;
+/**
+ * @deprecated Use {@link isToolCallMessage} from './llmUtils.js' for provider-independent code.
+ * This Content-based helper will be removed after full migration to LlmMessage types.
+ */
+export declare function isFunctionCall(content: Content): boolean;

package/dist/src/utils/messageInspectors.js

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * @deprecated Use {@link isToolResultMessage} from './llmUtils.js' for provider-independent code.
+ * This Content-based helper will be removed after full migration to LlmMessage types.
+ */
+export function isFunctionResponse(content) {
+    return (content.role === 'user' &&
+        !!content.parts &&
+        content.parts.every((part) => !!part.functionResponse));
+}
+/**
+ * @deprecated Use {@link isToolCallMessage} from './llmUtils.js' for provider-independent code.
+ * This Content-based helper will be removed after full migration to LlmMessage types.
+ */
+export function isFunctionCall(content) {
+    return (content.role === 'model' &&
+        !!content.parts &&
+        content.parts.every((part) => !!part.functionCall));
+}
+//# sourceMappingURL=messageInspectors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messageInspectors.js","sourceRoot":"","sources":["../../../src/utils/messageInspectors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO,CACL,OAAO,CAAC,IAAI,KAAK,MAAM;QACvB,CAAC,CAAC,OAAO,CAAC,KAAK;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CACvD,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,OAAO,CACL,OAAO,CAAC,IAAI,KAAK,OAAO;QACxB,CAAC,CAAC,OAAO,CAAC,KAAK;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CACnD,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { BaseLlmClient } from '../core/baseLlmClient.js';
+import type { GeminiChat } from '../core/geminiChat.js';
+export interface NextSpeakerResponse {
+    reasoning: string;
+    next_speaker: 'user' | 'model';
+}
+export declare function checkNextSpeaker(chat: GeminiChat, baseLlmClient: BaseLlmClient, abortSignal: AbortSignal, promptId: string): Promise<NextSpeakerResponse | null>;

package/dist/src/utils/nextSpeakerChecker.js

@@ -0,0 +1,97 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { isContentToolResultMessage } from '../providers/gemini/typeConversion.js';
+import { debugLogger } from './debugLogger.js';
+const CHECK_PROMPT = `Analyze *only* the content and structure of your immediately preceding response (your last turn in the conversation history). Based *strictly* on that response, determine who should logically speak next: the 'user' or the 'model' (you).
+**Decision Rules (apply in order):**
+1.  **Model Continues:** If your last response explicitly states an immediate next action *you* intend to take (e.g., "Next, I will...", "Now I'll process...", "Moving on to analyze...", indicates an intended tool call that didn't execute), OR if the response seems clearly incomplete (cut off mid-thought without a natural conclusion), then the **'model'** should speak next.
+2.  **Question to User:** If your last response ends with a direct question specifically addressed *to the user*, then the **'user'** should speak next.
+3.  **Waiting for User:** If your last response completed a thought, statement, or task *and* does not meet the criteria for Rule 1 (Model Continues) or Rule 2 (Question to User), it implies a pause expecting user input or reaction. In this case, the **'user'** should speak next.`;
+const RESPONSE_SCHEMA = {
+    type: 'object',
+    properties: {
+        reasoning: {
+            type: 'string',
+            description: "Brief explanation justifying the 'next_speaker' choice based *strictly* on the applicable rule and the content/structure of the preceding turn.",
+        },
+        next_speaker: {
+            type: 'string',
+            enum: ['user', 'model'],
+            description: 'Who should speak next based *only* on the preceding turn and the decision rules',
+        },
+    },
+    required: ['reasoning', 'next_speaker'],
+};
+export async function checkNextSpeaker(chat, baseLlmClient, abortSignal, promptId) {
+    // We need to capture the curated history because there are many moments when the model will return invalid turns
+    // that when passed back up to the endpoint will break subsequent calls. An example of this is when the model decides
+    // to respond with an empty part collection if you were to send that message back to the server it will respond with
+    // a 400 indicating that model part collections MUST have content.
+    const curatedHistory = chat.getHistory(/* curated */ true);
+    // Ensure there's a model response to analyze
+    if (curatedHistory.length === 0) {
+        // Cannot determine next speaker if history is empty.
+        return null;
+    }
+    const comprehensiveHistory = chat.getHistory();
+    // If comprehensiveHistory is empty, there is no last message to check.
+    // This case should ideally be caught by the curatedHistory.length check earlier,
+    // but as a safeguard:
+    if (comprehensiveHistory.length === 0) {
+        return null;
+    }
+    const lastComprehensiveMessage = comprehensiveHistory[comprehensiveHistory.length - 1];
+    // If the last message is a user message containing only function_responses,
+    // then the model should speak next.
+    if (lastComprehensiveMessage &&
+        isContentToolResultMessage(lastComprehensiveMessage)) {
+        return {
+            reasoning: 'The last message was a function response, so the model should speak next.',
+            next_speaker: 'model',
+        };
+    }
+    if (lastComprehensiveMessage &&
+        lastComprehensiveMessage.role === 'model' &&
+        lastComprehensiveMessage.parts &&
+        lastComprehensiveMessage.parts.length === 0) {
+        lastComprehensiveMessage.parts.push({ text: '' });
+        return {
+            reasoning: 'The last message was a filler model message with no content (nothing for user to act on), model should speak next.',
+            next_speaker: 'model',
+        };
+    }
+    // Things checked out. Let's proceed to potentially making an LLM request.
+    const lastMessage = curatedHistory[curatedHistory.length - 1];
+    if (!lastMessage || lastMessage.role !== 'model') {
+        // Cannot determine next speaker if the last turn wasn't from the model
+        // or if history is empty.
+        return null;
+    }
+    const contents = [
+        ...curatedHistory,
+        { role: 'user', parts: [{ text: CHECK_PROMPT }] },
+    ];
+    try {
+        const parsedResponse = (await baseLlmClient.generateJson({
+            modelConfigKey: { model: 'next-speaker-checker' },
+            contents,
+            schema: RESPONSE_SCHEMA,
+            abortSignal,
+            promptId,
+        }));
+        if (parsedResponse &&
+            parsedResponse.next_speaker &&
+            ['user', 'model'].includes(parsedResponse.next_speaker)) {
+            return parsedResponse;
+        }
+        return null;
+    }
+    catch (error) {
+        debugLogger.warn('Failed to talk to Gemini endpoint when seeing if conversation should continue.', error);
+        return null;
+    }
+}
+//# sourceMappingURL=nextSpeakerChecker.js.map

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

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

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

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

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

@@ -0,0 +1,191 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { BaseLlmClient } from '../core/baseLlmClient.js';
+import { checkNextSpeaker } from './nextSpeakerChecker.js';
+import { GeminiChat } from '../core/geminiChat.js';
+// Mock fs module to prevent actual file system operations during tests
+const mockFileSystem = new Map();
+vi.mock('node:fs', () => {
+    const fsModule = {
+        mkdirSync: vi.fn(),
+        writeFileSync: vi.fn((path, data) => {
+            mockFileSystem.set(path, data);
+        }),
+        readFileSync: vi.fn((path) => {
+            if (mockFileSystem.has(path)) {
+                return mockFileSystem.get(path);
+            }
+            throw Object.assign(new Error('ENOENT: no such file or directory'), {
+                code: 'ENOENT',
+            });
+        }),
+        existsSync: vi.fn((path) => mockFileSystem.has(path)),
+        createWriteStream: vi.fn(() => ({
+            write: vi.fn(),
+            on: vi.fn(),
+        })),
+    };
+    return {
+        default: fsModule,
+        ...fsModule,
+    };
+});
+// Mock GeminiClient and Config constructor
+vi.mock('../core/baseLlmClient.js');
+vi.mock('../config/config.js');
+describe('checkNextSpeaker', () => {
+    let chatInstance;
+    let mockConfig;
+    let mockBaseLlmClient;
+    const abortSignal = new AbortController().signal;
+    const promptId = 'test-prompt-id';
+    beforeEach(() => {
+        vi.resetAllMocks();
+        const mockResolvedConfig = {
+            model: 'next-speaker-v1',
+            generateContentConfig: {},
+        };
+        mockConfig = {
+            getProjectRoot: vi.fn().mockReturnValue('/test/project/root'),
+            getSessionId: vi.fn().mockReturnValue('test-session-id'),
+            getModel: () => 'test-model',
+            storage: {
+                getProjectTempDir: vi.fn().mockReturnValue('/test/temp'),
+            },
+            modelConfigService: {
+                getResolvedConfig: vi.fn().mockReturnValue(mockResolvedConfig),
+            },
+        };
+        mockBaseLlmClient = new BaseLlmClient({
+            generateContent: vi.fn(),
+            generateContentStream: vi.fn(),
+            countTokens: vi.fn(),
+            embedContent: vi.fn(),
+        }, mockConfig);
+        // GeminiChat will receive the mocked instances via the mocked GoogleGenAI constructor
+        chatInstance = new GeminiChat(mockConfig, '', // empty system instruction
+        [], // no tools
+        []);
+        // Spy on getHistory for chatInstance
+        vi.spyOn(chatInstance, 'getHistory');
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('should return null if history is empty', async () => {
+        chatInstance.getHistory.mockReturnValue([]);
+        const result = await checkNextSpeaker(chatInstance, mockBaseLlmClient, abortSignal, promptId);
+        expect(result).toBeNull();
+        expect(mockBaseLlmClient.generateJson).not.toHaveBeenCalled();
+    });
+    it('should return null if the last speaker was the user', async () => {
+        vi.mocked(chatInstance.getHistory).mockReturnValue([
+            { role: 'user', parts: [{ text: 'Hello' }] },
+        ]);
+        const result = await checkNextSpeaker(chatInstance, mockBaseLlmClient, abortSignal, promptId);
+        expect(result).toBeNull();
+        expect(mockBaseLlmClient.generateJson).not.toHaveBeenCalled();
+    });
+    it("should return { next_speaker: 'model' } when model intends to continue", async () => {
+        chatInstance.getHistory.mockReturnValue([
+            { role: 'model', parts: [{ text: 'I will now do something.' }] },
+        ]);
+        const mockApiResponse = {
+            reasoning: 'Model stated it will do something.',
+            next_speaker: 'model',
+        };
+        mockBaseLlmClient.generateJson.mockResolvedValue(mockApiResponse);
+        const result = await checkNextSpeaker(chatInstance, mockBaseLlmClient, abortSignal, promptId);
+        expect(result).toEqual(mockApiResponse);
+        expect(mockBaseLlmClient.generateJson).toHaveBeenCalledTimes(1);
+    });
+    it("should return { next_speaker: 'user' } when model asks a question", async () => {
+        chatInstance.getHistory.mockReturnValue([
+            { role: 'model', parts: [{ text: 'What would you like to do?' }] },
+        ]);
+        const mockApiResponse = {
+            reasoning: 'Model asked a question.',
+            next_speaker: 'user',
+        };
+        mockBaseLlmClient.generateJson.mockResolvedValue(mockApiResponse);
+        const result = await checkNextSpeaker(chatInstance, mockBaseLlmClient, abortSignal, promptId);
+        expect(result).toEqual(mockApiResponse);
+    });
+    it("should return { next_speaker: 'user' } when model makes a statement", async () => {
+        chatInstance.getHistory.mockReturnValue([
+            { role: 'model', parts: [{ text: 'This is a statement.' }] },
+        ]);
+        const mockApiResponse = {
+            reasoning: 'Model made a statement, awaiting user input.',
+            next_speaker: 'user',
+        };
+        mockBaseLlmClient.generateJson.mockResolvedValue(mockApiResponse);
+        const result = await checkNextSpeaker(chatInstance, mockBaseLlmClient, abortSignal, promptId);
+        expect(result).toEqual(mockApiResponse);
+    });
+    it('should return null if baseLlmClient.generateJson throws an error', async () => {
+        const consoleWarnSpy = vi
+            .spyOn(console, 'warn')
+            .mockImplementation(() => { });
+        chatInstance.getHistory.mockReturnValue([
+            { role: 'model', parts: [{ text: 'Some model output.' }] },
+        ]);
+        mockBaseLlmClient.generateJson.mockRejectedValue(new Error('API Error'));
+        const result = await checkNextSpeaker(chatInstance, mockBaseLlmClient, abortSignal, promptId);
+        expect(result).toBeNull();
+        consoleWarnSpy.mockRestore();
+    });
+    it('should return null if baseLlmClient.generateJson returns invalid JSON (missing next_speaker)', async () => {
+        chatInstance.getHistory.mockReturnValue([
+            { role: 'model', parts: [{ text: 'Some model output.' }] },
+        ]);
+        mockBaseLlmClient.generateJson.mockResolvedValue({
+            reasoning: 'This is incomplete.',
+        }); // Type assertion to simulate invalid response
+        const result = await checkNextSpeaker(chatInstance, mockBaseLlmClient, abortSignal, promptId);
+        expect(result).toBeNull();
+    });
+    it('should return null if baseLlmClient.generateJson returns a non-string next_speaker', async () => {
+        chatInstance.getHistory.mockReturnValue([
+            { role: 'model', parts: [{ text: 'Some model output.' }] },
+        ]);
+        mockBaseLlmClient.generateJson.mockResolvedValue({
+            reasoning: 'Model made a statement, awaiting user input.',
+            next_speaker: 123, // Invalid type
+        });
+        const result = await checkNextSpeaker(chatInstance, mockBaseLlmClient, abortSignal, promptId);
+        expect(result).toBeNull();
+    });
+    it('should return null if baseLlmClient.generateJson returns an invalid next_speaker string value', async () => {
+        chatInstance.getHistory.mockReturnValue([
+            { role: 'model', parts: [{ text: 'Some model output.' }] },
+        ]);
+        mockBaseLlmClient.generateJson.mockResolvedValue({
+            reasoning: 'Model made a statement, awaiting user input.',
+            next_speaker: 'neither', // Invalid enum value
+        });
+        const result = await checkNextSpeaker(chatInstance, mockBaseLlmClient, abortSignal, promptId);
+        expect(result).toBeNull();
+    });
+    it('should call generateJson with the correct parameters', async () => {
+        chatInstance.getHistory.mockReturnValue([
+            { role: 'model', parts: [{ text: 'Some model output.' }] },
+        ]);
+        const mockApiResponse = {
+            reasoning: 'Model made a statement, awaiting user input.',
+            next_speaker: 'user',
+        };
+        mockBaseLlmClient.generateJson.mockResolvedValue(mockApiResponse);
+        await checkNextSpeaker(chatInstance, mockBaseLlmClient, abortSignal, promptId);
+        expect(mockBaseLlmClient.generateJson).toHaveBeenCalled();
+        const generateJsonCall = mockBaseLlmClient.generateJson.mock
+            .calls[0][0];
+        expect(generateJsonCall.modelConfigKey.model).toBe('next-speaker-checker');
+        expect(generateJsonCall.promptId).toBe(promptId);
+    });
+});
+//# sourceMappingURL=nextSpeakerChecker.test.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type PackageJson as BasePackageJson } from 'read-package-up';
+export type PackageJson = BasePackageJson & {
+    config?: {
+        sandboxImageUri?: string;
+    };
+};
+/**
+ * Reads package.json from the current directory or any parent directory.
+ *
+ * @param cwd - The directory to start searching from (searches upward to filesystem root)
+ * @returns The package.json object if found, or `undefined` if no package.json exists
+ *          in the directory hierarchy. This is expected behavior when called from
+ *          directories outside of a Node.js project.
+ *
+ * @example
+ * ```ts
+ * const pkg = await getPackageJson(__dirname);
+ * const version = pkg?.version ?? 'unknown';
+ * ```
+ */
+export declare function getPackageJson(cwd: string): Promise<PackageJson | undefined>;

package/dist/src/utils/package.js

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { readPackageUp, } from 'read-package-up';
+/**
+ * Reads package.json from the current directory or any parent directory.
+ *
+ * @param cwd - The directory to start searching from (searches upward to filesystem root)
+ * @returns The package.json object if found, or `undefined` if no package.json exists
+ *          in the directory hierarchy. This is expected behavior when called from
+ *          directories outside of a Node.js project.
+ *
+ * @example
+ * ```ts
+ * const pkg = await getPackageJson(__dirname);
+ * const version = pkg?.version ?? 'unknown';
+ * ```
+ */
+export async function getPackageJson(cwd) {
+    const result = await readPackageUp({ cwd });
+    if (!result) {
+        return undefined;
+    }
+    return result.packageJson;
+}
+//# sourceMappingURL=package.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package.js","sourceRoot":"","sources":["../../../src/utils/package.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,aAAa,GAEd,MAAM,iBAAiB,CAAC;AAQzB;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW;IAEX,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC,WAAW,CAAC;AAC5B,CAAC"}

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

@@ -0,0 +1,76 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { GenerateContentResponse, PartListUnion, PartUnion } from '@google/genai';
+import type { LlmContent, LlmMessage } from '../providers/types.js';
+/**
+ * Converts a PartListUnion into a string.
+ * If verbose is true, includes summary representations of non-text parts.
+ *
+ * @deprecated Use {@link contentToString} for provider-independent conversion.
+ */
+export declare function partToString(value: PartListUnion, options?: {
+    verbose?: boolean;
+}): string;
+/**
+ * @deprecated Use {@link getMessageText} for provider-independent text extraction.
+ */
+export declare function getResponseText(response: GenerateContentResponse): string | null;
+/**
+ * Asynchronously maps over a PartListUnion, applying a transformation function
+ * to the text content of each text-based part.
+ *
+ * @param parts The PartListUnion to process.
+ * @param transform A function that takes a string of text and returns a Promise
+ *   resolving to an array of new PartUnions.
+ * @returns A Promise that resolves to a new array of PartUnions with the
+ *   transformations applied.
+ *
+ * @deprecated Use {@link flatMapLlmTextContents} for provider-independent transformation.
+ */
+export declare function flatMapTextParts(parts: PartListUnion, transform: (text: string) => Promise<PartUnion[]>): Promise<PartUnion[]>;
+/**
+ * Appends a string of text to the last text part of a prompt, or adds a new
+ * text part if the last part is not a text part.
+ *
+ * @param prompt The prompt to modify.
+ * @param textToAppend The text to append to the prompt.
+ * @param separator The separator to add between existing text and the new text.
+ * @returns The modified prompt.
+ *
+ * @deprecated Use {@link appendToLastLlmTextContent} for provider-independent operation.
+ */
+export declare function appendToLastTextPart(prompt: PartUnion[], textToAppend: string, separator?: string): PartUnion[];
+/**
+ * Convert LlmContent or LlmContent[] to a string representation.
+ * Provider-independent version of partToString.
+ *
+ * In verbose mode, includes descriptive summaries for non-text content.
+ */
+export declare function contentToString(content: LlmContent | LlmContent[], options?: {
+    verbose?: boolean;
+}): string;
+/**
+ * Extract concatenated text from an LlmMessage.
+ * Provider-independent version of getResponseText.
+ *
+ * Skips non-text and thought contents.
+ * Returns null if no text content found.
+ */
+export declare function getMessageText(message: LlmMessage): string | null;
+/**
+ * Async flat-map over LlmContent[], transforming text contents.
+ * Provider-independent version of flatMapTextParts.
+ *
+ * Non-text contents are passed through unmodified.
+ */
+export declare function flatMapLlmTextContents(contents: LlmContent[], transform: (text: string) => Promise<LlmContent[]>): Promise<LlmContent[]>;
+/**
+ * Append text to the last text content in an LlmContent array.
+ * Provider-independent version of appendToLastTextPart.
+ *
+ * If the last content is not text, a new text content is added.
+ */
+export declare function appendToLastLlmTextContent(contents: LlmContent[], textToAppend: string, separator?: string): LlmContent[];