@hibanacloud/core 0.3.15

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

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, expect, it } from 'vitest';
+import { isShellCommandReadOnly } from './shellReadOnlyChecker.js';
+describe('evaluateShellCommandReadOnly', () => {
+    it('allows simple read-only command', () => {
+        const result = isShellCommandReadOnly('ls -la');
+        expect(result).toBe(true);
+    });
+    it('rejects mutating commands like rm', () => {
+        const result = isShellCommandReadOnly('rm -rf temp');
+        expect(result).toBe(false);
+    });
+    it('rejects redirection output', () => {
+        const result = isShellCommandReadOnly('ls > out.txt');
+        expect(result).toBe(false);
+    });
+    it('rejects command substitution', () => {
+        const result = isShellCommandReadOnly('echo $(touch file)');
+        expect(result).toBe(false);
+    });
+    it('allows git status but rejects git commit', () => {
+        expect(isShellCommandReadOnly('git status')).toBe(true);
+        const commitResult = isShellCommandReadOnly('git commit -am "msg"');
+        expect(commitResult).toBe(false);
+    });
+    it('rejects find with exec', () => {
+        const result = isShellCommandReadOnly('find . -exec rm {} \\;');
+        expect(result).toBe(false);
+    });
+    it('rejects sed in-place', () => {
+        const result = isShellCommandReadOnly("sed -i 's/foo/bar/' file");
+        expect(result).toBe(false);
+    });
+    it('rejects empty command', () => {
+        const result = isShellCommandReadOnly('   ');
+        expect(result).toBe(false);
+    });
+    it('respects environment prefix followed by allowed command', () => {
+        const result = isShellCommandReadOnly('FOO=bar ls');
+        expect(result).toBe(true);
+    });
+});
+//# sourceMappingURL=shellReadOnlyChecker.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shellReadOnlyChecker.test.js","sourceRoot":"","sources":["../../../src/utils/shellReadOnlyChecker.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,MAAM,GAAG,sBAAsB,CAAC,cAAc,CAAC,CAAC;QACtD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,MAAM,GAAG,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,YAAY,GAAG,sBAAsB,CAAC,sBAAsB,CAAC,CAAC;QACpE,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,MAAM,GAAG,sBAAsB,CAAC,wBAAwB,CAAC,CAAC;QAChE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,MAAM,GAAG,sBAAsB,CAAC,0BAA0B,CAAC,CAAC;QAClE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,MAAM,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;QACpD,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+export interface SubagentGeneratedContent {
+    name: string;
+    description: string;
+    systemPrompt: string;
+}
+/**
+ * Generates subagent configuration content using LLM.
+ *
+ * @param userDescription - The user's description of what the subagent should do
+ * @param geminiClient - Initialized GeminiClient instance
+ * @param abortSignal - AbortSignal for cancelling the request
+ * @returns Promise resolving to generated subagent content
+ */
+export declare function subagentGenerator(userDescription: string, config: Config, abortSignal: AbortSignal): Promise<SubagentGeneratedContent>;

package/dist/src/utils/subagentGenerator.js

@@ -0,0 +1,120 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DEFAULT_QWEN_MODEL } from '../config/models.js';
+const SYSTEM_PROMPT = `You are an elite AI agent architect specializing in crafting high-performance agent configurations. Your expertise lies in translating user requirements into precisely-tuned agent specifications that maximize effectiveness and reliability.
+
+**Important Context**: You may have access to project-specific instructions from QWEN.md files and other context that may include coding standards, project structure, and custom requirements. Consider this context when creating agents to ensure they align with the project's established patterns and practices.
+
+When a user describes what they want an agent to do, you will:
+
+1. **Extract Core Intent**: Identify the fundamental purpose, key responsibilities, and success criteria for the agent. Look for both explicit requirements and implicit needs. Consider any project-specific context from QWEN.md files. For agents that are meant to review code, you should assume that the user is asking to review recently written code and not the whole codebase, unless the user has explicitly instructed you otherwise.
+
+2. **Design Expert Persona**: Create a compelling expert identity that embodies deep domain knowledge relevant to the task. The persona should inspire confidence and guide the agent's decision-making approach.
+
+3. **Architect Comprehensive Instructions**: Develop a system prompt that:
+   - Establishes clear behavioral boundaries and operational parameters
+   - Provides specific methodologies and best practices for task execution
+   - Anticipates edge cases and provides guidance for handling them
+   - Incorporates any specific requirements or preferences mentioned by the user
+   - Defines output format expectations when relevant
+   - Aligns with project-specific coding standards and patterns from QWEN.md
+
+4. **Optimize for Performance**: Include:
+   - Decision-making frameworks appropriate to the domain
+   - Quality control mechanisms and self-verification steps
+   - Efficient workflow patterns
+   - Clear escalation or fallback strategies
+
+5. **Create Identifier**: Design a concise, descriptive identifier that:
+   - Uses lowercase letters, numbers, and hyphens only
+   - Is typically 2-4 words joined by hyphens
+   - Clearly indicates the agent's primary function
+   - Is memorable and easy to type
+   - Avoids generic terms like "helper" or "assistant"
+
+6 **Example agent descriptions**:
+ - in the 'whenToUse' field of the JSON object, you should include examples of when this agent should be used.
+ - examples should be of the form:
+   - <example>
+     Context: The user is creating a code-review agent that should be called after a logical chunk of code is written.
+     user: "Please write a function that checks if a number is prime"
+     assistant: "Here is the relevant function: "
+     <function call omitted for brevity only for this example>
+     <commentary>
+     Since the user is greeting, use the Task tool to launch the greeting-responder agent to respond with a friendly joke. 
+     </commentary>
+     assistant: "Now let me use the code-reviewer agent to review the code"
+   </example>
+   - <example>
+     Context: User is creating an agent to respond to the word "hello" with a friendly jok.
+     user: "Hello"
+     assistant: "I'm going to use the Task tool to launch the greeting-responder agent to respond with a friendly joke"
+     <commentary>
+     Since the user is greeting, use the greeting-responder agent to respond with a friendly joke. 
+     </commentary>
+   </example>
+ - If the user mentioned or implied that the agent should be used proactively, you should include examples of this.
+- NOTE: Ensure that in the examples, you are making the assistant use the Agent tool and not simply respond directly to the task.
+
+Key principles for your system prompts:
+- Be specific rather than generic - avoid vague instructions
+- Include concrete examples when they would clarify behavior
+- Balance comprehensiveness with clarity - every instruction should add value
+- Ensure the agent has enough context to handle variations of the core task
+- Make the agent proactive in seeking clarification when needed
+- Build in quality assurance and self-correction mechanisms
+
+Remember: The agents you create should be autonomous experts capable of handling their designated tasks with minimal additional guidance. Your system prompts are their complete operational manual.
+`;
+const createUserPrompt = (userInput) => `Create an agent configuration based on this request: "${userInput}"`;
+const RESPONSE_SCHEMA = {
+    type: 'object',
+    properties: {
+        name: {
+            type: 'string',
+            description: "A unique, descriptive identifier using lowercase letters, numbers, and hyphens (e.g., 'code-reviewer', 'api-docs-writer', 'test-generator')",
+        },
+        description: {
+            type: 'string',
+            description: "A precise, actionable description starting with 'Use this agent when...' that clearly defines the triggering conditions and use cases",
+        },
+        systemPrompt: {
+            type: 'string',
+            description: "The complete system prompt that will govern the agent's behavior, written in second person ('You are...', 'You will...') and structured for maximum clarity and effectiveness",
+        },
+    },
+    required: ['name', 'description', 'systemPrompt'],
+};
+/**
+ * Generates subagent configuration content using LLM.
+ *
+ * @param userDescription - The user's description of what the subagent should do
+ * @param geminiClient - Initialized GeminiClient instance
+ * @param abortSignal - AbortSignal for cancelling the request
+ * @returns Promise resolving to generated subagent content
+ */
+export async function subagentGenerator(userDescription, config, abortSignal) {
+    if (!userDescription.trim()) {
+        throw new Error('User description cannot be empty');
+    }
+    const userPrompt = createUserPrompt(userDescription);
+    const contents = [{ role: 'user', parts: [{ text: userPrompt }] }];
+    const parsedResponse = (await config.getBaseLlmClient().generateJson({
+        model: config.getModel() || DEFAULT_QWEN_MODEL,
+        contents,
+        schema: RESPONSE_SCHEMA,
+        abortSignal,
+        systemInstruction: SYSTEM_PROMPT,
+    }));
+    if (!parsedResponse ||
+        !parsedResponse.name ||
+        !parsedResponse.description ||
+        !parsedResponse.systemPrompt) {
+        throw new Error('Invalid response from LLM: missing required fields');
+    }
+    return parsedResponse;
+}
+//# sourceMappingURL=subagentGenerator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagentGenerator.js","sourceRoot":"","sources":["../../../src/utils/subagentGenerator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzD,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgErB,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,SAAiB,EAAU,EAAE,CACrD,yDAAyD,SAAS,GAAG,CAAC;AAExE,MAAM,eAAe,GAA4B;IAC/C,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,6IAA6I;SAChJ;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,uIAAuI;SAC1I;QACD,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,+KAA+K;SAClL;KACF;IACD,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,cAAc,CAAC;CAClD,CAAC;AAQF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,eAAuB,EACvB,MAAc,EACd,WAAwB;IAExB,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;IAE9E,MAAM,cAAc,GAAG,CAAC,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC,YAAY,CAAC;QACnE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,kBAAkB;QAC9C,QAAQ;QACR,MAAM,EAAE,eAAe;QACvB,WAAW;QACX,iBAAiB,EAAE,aAAa;KACjC,CAAC,CAAwC,CAAC;IAE3C,IACE,CAAC,cAAc;QACf,CAAC,cAAc,CAAC,IAAI;QACpB,CAAC,cAAc,CAAC,WAAW;QAC3B,CAAC,cAAc,CAAC,YAAY,EAC5B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC"}

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

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

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

@@ -0,0 +1,135 @@
+/**
+ * @license
+ * Copyright 2025 Qwen
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach, } from 'vitest';
+import { subagentGenerator, } from './subagentGenerator.js';
+describe('subagentGenerator', () => {
+    let mockClient;
+    let mockConfig;
+    const abortSignal = new AbortController().signal;
+    beforeEach(() => {
+        // Create a mock client with generateJson method
+        mockClient = {
+            generateJson: vi.fn(),
+        };
+        // Create a mock config that returns the mock client and model
+        mockConfig = {
+            getBaseLlmClient: vi.fn().mockReturnValue(mockClient),
+            getModel: vi.fn().mockReturnValue('qwen3-coder-plus'),
+        };
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+    });
+    it('should throw error for empty user description', async () => {
+        await expect(subagentGenerator('', mockConfig, abortSignal)).rejects.toThrow('User description cannot be empty');
+        await expect(subagentGenerator('   ', mockConfig, abortSignal)).rejects.toThrow('User description cannot be empty');
+        expect(mockClient.generateJson).not.toHaveBeenCalled();
+    });
+    it('should successfully generate content with valid LLM response', async () => {
+        const userDescription = 'help with code reviews and suggestions';
+        const mockApiResponse = {
+            name: 'code-review-assistant',
+            description: 'A specialized subagent that helps with code reviews and provides improvement suggestions.',
+            systemPrompt: 'You are a code review expert. Analyze code for best practices, bugs, and improvements.',
+        };
+        mockClient.generateJson.mockResolvedValue(mockApiResponse);
+        const result = await subagentGenerator(userDescription, mockConfig, abortSignal);
+        expect(result).toEqual(mockApiResponse);
+        expect(mockClient.generateJson).toHaveBeenCalledTimes(1);
+        // Verify the call parameters - now it's a single object parameter
+        const generateJsonCall = mockClient.generateJson.mock.calls[0];
+        const callParams = generateJsonCall[0];
+        // Check the contents
+        expect(callParams.contents).toHaveLength(1);
+        expect(callParams.contents[0]?.role).toBe('user');
+        expect(callParams.contents[0]?.parts?.[0]?.text).toContain(`Create an agent configuration based on this request: "${userDescription}"`);
+        // Check other parameters
+        expect(callParams.abortSignal).toBe(abortSignal);
+        expect(callParams.model).toBe('qwen3-coder-plus');
+        expect(callParams.systemInstruction).toContain('You are an elite AI agent architect');
+    });
+    it('should throw error when LLM response is missing required fields', async () => {
+        const userDescription = 'help with documentation';
+        const incompleteResponse = {
+            name: 'doc-helper',
+            description: 'Helps with documentation',
+            // Missing systemPrompt
+        };
+        mockClient.generateJson.mockResolvedValue(incompleteResponse);
+        await expect(subagentGenerator(userDescription, mockConfig, abortSignal)).rejects.toThrow('Invalid response from LLM: missing required fields');
+        expect(mockClient.generateJson).toHaveBeenCalledTimes(1);
+    });
+    it('should throw error when LLM response has empty fields', async () => {
+        const userDescription = 'database optimization';
+        const emptyFieldsResponse = {
+            name: '',
+            description: 'Helps with database optimization',
+            systemPrompt: 'You are a database expert.',
+        };
+        mockClient.generateJson.mockResolvedValue(emptyFieldsResponse);
+        await expect(subagentGenerator(userDescription, mockConfig, abortSignal)).rejects.toThrow('Invalid response from LLM: missing required fields');
+    });
+    it('should throw error when generateJson throws an error', async () => {
+        const userDescription = 'testing automation';
+        mockClient.generateJson.mockRejectedValue(new Error('API Error'));
+        await expect(subagentGenerator(userDescription, mockConfig, abortSignal)).rejects.toThrow('API Error');
+    });
+    it('should call generateJson with correct schema and model', async () => {
+        const userDescription = 'data analysis';
+        const mockResponse = {
+            name: 'data-analyst',
+            description: 'Analyzes data and provides insights.',
+            systemPrompt: 'You are a data analysis expert.',
+        };
+        mockClient.generateJson.mockResolvedValue(mockResponse);
+        await subagentGenerator(userDescription, mockConfig, abortSignal);
+        expect(mockClient.generateJson).toHaveBeenCalledWith(expect.objectContaining({
+            model: 'qwen3-coder-plus',
+            contents: expect.any(Object),
+            schema: expect.objectContaining({
+                type: 'object',
+                properties: expect.objectContaining({
+                    name: expect.objectContaining({ type: 'string' }),
+                    description: expect.objectContaining({ type: 'string' }),
+                    systemPrompt: expect.objectContaining({ type: 'string' }),
+                }),
+                required: ['name', 'description', 'systemPrompt'],
+            }),
+            abortSignal,
+            systemInstruction: expect.stringContaining('You are an elite AI agent architect'),
+        }));
+    });
+    it('should include user description in the prompt', async () => {
+        const userDescription = 'machine learning model training';
+        const mockResponse = {
+            name: 'ml-trainer',
+            description: 'Trains machine learning models.',
+            systemPrompt: 'You are an ML expert.',
+        };
+        mockClient.generateJson.mockResolvedValue(mockResponse);
+        await subagentGenerator(userDescription, mockConfig, abortSignal);
+        const generateJsonCall = mockClient.generateJson.mock.calls[0];
+        const callParams = generateJsonCall[0];
+        // Check user query (only message)
+        expect(callParams.contents).toHaveLength(1);
+        const userQueryContent = callParams.contents[0]?.parts?.[0]?.text;
+        expect(userQueryContent).toContain(userDescription);
+        expect(userQueryContent).toContain('Create an agent configuration based on this request:');
+        // Check that system prompt is passed correctly
+        expect(callParams.systemInstruction).toContain('You are an elite AI agent architect');
+    });
+    it('should throw error for null response from generateJson', async () => {
+        const userDescription = 'security auditing';
+        mockClient.generateJson.mockResolvedValue(null);
+        await expect(subagentGenerator(userDescription, mockConfig, abortSignal)).rejects.toThrow('Invalid response from LLM: missing required fields');
+    });
+    it('should throw error for undefined response from generateJson', async () => {
+        const userDescription = 'api documentation';
+        mockClient.generateJson.mockResolvedValue(undefined);
+        await expect(subagentGenerator(userDescription, mockConfig, abortSignal)).rejects.toThrow('Invalid response from LLM: missing required fields');
+    });
+});
+//# sourceMappingURL=subagentGenerator.test.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ToolResult } from '../tools/tools.js';
+import type { GeminiClient } from '../core/client.js';
+/**
+ * A function that summarizes the result of a tool execution.
+ *
+ * @param result The result of the tool execution.
+ * @returns The summary of the result.
+ */
+export type Summarizer = (result: ToolResult, geminiClient: GeminiClient, abortSignal: AbortSignal) => Promise<string>;
+/**
+ * The default summarizer for tool results.
+ *
+ * @param result The result of the tool execution.
+ * @param geminiClient The Gemini client to use for summarization.
+ * @param abortSignal The abort signal to use for summarization.
+ * @returns The summary of the result.
+ */
+export declare const defaultSummarizer: Summarizer;
+export declare const llmSummarizer: Summarizer;
+export declare function summarizeToolOutput(textToSummarize: string, geminiClient: GeminiClient, abortSignal: AbortSignal, maxOutputTokens?: number): Promise<string>;

package/dist/src/utils/summarizer.js

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DEFAULT_GEMINI_FLASH_LITE_MODEL } from '../config/models.js';
+import { getResponseText, partToString } from './partUtils.js';
+/**
+ * The default summarizer for tool results.
+ *
+ * @param result The result of the tool execution.
+ * @param geminiClient The Gemini client to use for summarization.
+ * @param abortSignal The abort signal to use for summarization.
+ * @returns The summary of the result.
+ */
+export const defaultSummarizer = (result, _geminiClient, _abortSignal) => Promise.resolve(JSON.stringify(result.llmContent));
+const SUMMARIZE_TOOL_OUTPUT_PROMPT = `Summarize the following tool output to be a maximum of {maxOutputTokens} tokens. The summary should be concise and capture the main points of the tool output.
+
+The summarization should be done based on the content that is provided. Here are the basic rules to follow:
+1. If the text is a directory listing or any output that is structural, use the history of the conversation to understand the context. Using this context try to understand what information we need from the tool output and return that as a response.
+2. If the text is text content and there is nothing structural that we need, summarize the text.
+3. If the text is the output of a shell command, use the history of the conversation to understand the context. Using this context try to understand what information we need from the tool output and return a summarization along with the stack trace of any error within the <error></error> tags. The stack trace should be complete and not truncated. If there are warnings, you should include them in the summary within <warning></warning> tags.
+
+
+Text to summarize:
+"{textToSummarize}"
+
+Return the summary string which should first contain an overall summarization of text followed by the full stack trace of errors and warnings in the tool output.
+`;
+export const llmSummarizer = (result, geminiClient, abortSignal) => summarizeToolOutput(partToString(result.llmContent), geminiClient, abortSignal);
+export async function summarizeToolOutput(textToSummarize, geminiClient, abortSignal, maxOutputTokens = 2000) {
+    // There is going to be a slight difference here since we are comparing length of string with maxOutputTokens.
+    // This is meant to be a ballpark estimation of if we need to summarize the tool output.
+    if (!textToSummarize || textToSummarize.length < maxOutputTokens) {
+        return textToSummarize;
+    }
+    const prompt = SUMMARIZE_TOOL_OUTPUT_PROMPT.replace('{maxOutputTokens}', String(maxOutputTokens)).replace('{textToSummarize}', textToSummarize);
+    const contents = [{ role: 'user', parts: [{ text: prompt }] }];
+    const toolOutputSummarizerConfig = {
+        maxOutputTokens,
+    };
+    try {
+        const parsedResponse = (await geminiClient.generateContent(contents, toolOutputSummarizerConfig, abortSignal, DEFAULT_GEMINI_FLASH_LITE_MODEL));
+        return getResponseText(parsedResponse) || textToSummarize;
+    }
+    catch (error) {
+        console.error('Failed to summarize tool output.', error);
+        return textToSummarize;
+    }
+}
+//# sourceMappingURL=summarizer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.js","sourceRoot":"","sources":["../../../src/utils/summarizer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAc/D;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAe,CAC3C,MAAkB,EAClB,aAA2B,EAC3B,YAAyB,EACzB,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;AAExD,MAAM,4BAA4B,GAAG;;;;;;;;;;;;CAYpC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAe,CAAC,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,CAC7E,mBAAmB,CACjB,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,EAC/B,YAAY,EACZ,WAAW,CACZ,CAAC;AAEJ,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,eAAuB,EACvB,YAA0B,EAC1B,WAAwB,EACxB,kBAA0B,IAAI;IAE9B,8GAA8G;IAC9G,wFAAwF;IACxF,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QACjE,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,MAAM,MAAM,GAAG,4BAA4B,CAAC,OAAO,CACjD,mBAAmB,EACnB,MAAM,CAAC,eAAe,CAAC,CACxB,CAAC,OAAO,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;IAEhD,MAAM,QAAQ,GAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1E,MAAM,0BAA0B,GAA0B;QACxD,eAAe;KAChB,CAAC;IACF,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,CAAC,MAAM,YAAY,CAAC,eAAe,CACxD,QAAQ,EACR,0BAA0B,EAC1B,WAAW,EACX,+BAA+B,CAChC,CAAuC,CAAC;QACzC,OAAO,eAAe,CAAC,cAAc,CAAC,IAAI,eAAe,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,eAAe,CAAC;IACzB,CAAC;AACH,CAAC"}

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

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

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

@@ -0,0 +1,131 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { GeminiClient } from '../core/client.js';
+import { Config } from '../config/config.js';
+import { summarizeToolOutput, llmSummarizer, defaultSummarizer, } from './summarizer.js';
+// Mock GeminiClient and Config constructor
+vi.mock('../core/client.js');
+vi.mock('../config/config.js');
+describe('summarizers', () => {
+    let mockGeminiClient;
+    let MockConfig;
+    const abortSignal = new AbortController().signal;
+    beforeEach(() => {
+        MockConfig = vi.mocked(Config);
+        const mockConfigInstance = new MockConfig('test-api-key', 'gemini-pro', false, '.', false, undefined, false, undefined, undefined, undefined);
+        mockGeminiClient = new GeminiClient(mockConfigInstance);
+        mockGeminiClient.generateContent = vi.fn();
+        vi.spyOn(console, 'error').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        vi.clearAllMocks();
+        console.error.mockRestore();
+    });
+    describe('summarizeToolOutput', () => {
+        it('should return original text if it is shorter than maxLength', async () => {
+            const shortText = 'This is a short text.';
+            const result = await summarizeToolOutput(shortText, mockGeminiClient, abortSignal, 2000);
+            expect(result).toBe(shortText);
+            expect(mockGeminiClient.generateContent).not.toHaveBeenCalled();
+        });
+        it('should return original text if it is empty', async () => {
+            const emptyText = '';
+            const result = await summarizeToolOutput(emptyText, mockGeminiClient, abortSignal, 2000);
+            expect(result).toBe(emptyText);
+            expect(mockGeminiClient.generateContent).not.toHaveBeenCalled();
+        });
+        it('should call generateContent if text is longer than maxLength', async () => {
+            const longText = 'This is a very long text.'.repeat(200);
+            const summary = 'This is a summary.';
+            mockGeminiClient.generateContent.mockResolvedValue({
+                candidates: [{ content: { parts: [{ text: summary }] } }],
+            });
+            const result = await summarizeToolOutput(longText, mockGeminiClient, abortSignal, 2000);
+            expect(mockGeminiClient.generateContent).toHaveBeenCalledTimes(1);
+            expect(result).toBe(summary);
+        });
+        it('should return original text if generateContent throws an error', async () => {
+            const longText = 'This is a very long text.'.repeat(200);
+            const error = new Error('API Error');
+            mockGeminiClient.generateContent.mockRejectedValue(error);
+            const result = await summarizeToolOutput(longText, mockGeminiClient, abortSignal, 2000);
+            expect(mockGeminiClient.generateContent).toHaveBeenCalledTimes(1);
+            expect(result).toBe(longText);
+            expect(console.error).toHaveBeenCalledWith('Failed to summarize tool output.', error);
+        });
+        it('should construct the correct prompt for summarization', async () => {
+            const longText = 'This is a very long text.'.repeat(200);
+            const summary = 'This is a summary.';
+            mockGeminiClient.generateContent.mockResolvedValue({
+                candidates: [{ content: { parts: [{ text: summary }] } }],
+            });
+            await summarizeToolOutput(longText, mockGeminiClient, abortSignal, 1000);
+            const expectedPrompt = `Summarize the following tool output to be a maximum of 1000 tokens. The summary should be concise and capture the main points of the tool output.
+
+The summarization should be done based on the content that is provided. Here are the basic rules to follow:
+1. If the text is a directory listing or any output that is structural, use the history of the conversation to understand the context. Using this context try to understand what information we need from the tool output and return that as a response.
+2. If the text is text content and there is nothing structural that we need, summarize the text.
+3. If the text is the output of a shell command, use the history of the conversation to understand the context. Using this context try to understand what information we need from the tool output and return a summarization along with the stack trace of any error within the <error></error> tags. The stack trace should be complete and not truncated. If there are warnings, you should include them in the summary within <warning></warning> tags.
+
+
+Text to summarize:
+"${longText}"
+
+Return the summary string which should first contain an overall summarization of text followed by the full stack trace of errors and warnings in the tool output.
+`;
+            const calledWith = mockGeminiClient.generateContent.mock
+                .calls[0];
+            const contents = calledWith[0];
+            expect(contents[0].parts[0].text).toBe(expectedPrompt);
+        });
+    });
+    describe('llmSummarizer', () => {
+        it('should summarize tool output using summarizeToolOutput', async () => {
+            const toolResult = {
+                llmContent: 'This is a very long text.'.repeat(200),
+                returnDisplay: '',
+            };
+            const summary = 'This is a summary.';
+            mockGeminiClient.generateContent.mockResolvedValue({
+                candidates: [{ content: { parts: [{ text: summary }] } }],
+            });
+            const result = await llmSummarizer(toolResult, mockGeminiClient, abortSignal);
+            expect(mockGeminiClient.generateContent).toHaveBeenCalledTimes(1);
+            expect(result).toBe(summary);
+        });
+        it('should handle different llmContent types', async () => {
+            const longText = 'This is a very long text.'.repeat(200);
+            const toolResult = {
+                llmContent: [{ text: longText }],
+                returnDisplay: '',
+            };
+            const summary = 'This is a summary.';
+            mockGeminiClient.generateContent.mockResolvedValue({
+                candidates: [{ content: { parts: [{ text: summary }] } }],
+            });
+            const result = await llmSummarizer(toolResult, mockGeminiClient, abortSignal);
+            expect(mockGeminiClient.generateContent).toHaveBeenCalledTimes(1);
+            const calledWith = mockGeminiClient.generateContent.mock
+                .calls[0];
+            const contents = calledWith[0];
+            expect(contents[0].parts[0].text).toContain(`"${longText}"`);
+            expect(result).toBe(summary);
+        });
+    });
+    describe('defaultSummarizer', () => {
+        it('should stringify the llmContent', async () => {
+            const toolResult = {
+                llmContent: { text: 'some data' },
+                returnDisplay: '',
+            };
+            const result = await defaultSummarizer(toolResult, mockGeminiClient, abortSignal);
+            expect(result).toBe(JSON.stringify({ text: 'some data' }));
+            expect(mockGeminiClient.generateContent).not.toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=summarizer.test.js.map

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

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

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

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Reset the encoding cache - useful for testing
+ */
+export declare function resetEncodingCache(): void;
+/**
+ * Returns the system encoding, caching the result to avoid repeated system calls.
+ * If system encoding detection fails, falls back to detecting from the provided buffer.
+ * Note: Only the system encoding is cached - buffer-based detection runs for each buffer
+ * since different buffers may have different encodings.
+ * @param buffer A buffer to use for detecting encoding if system detection fails.
+ */
+export declare function getCachedEncodingForBuffer(buffer: Buffer): string;
+/**
+ * Detects the system encoding based on the platform.
+ * For Windows, it uses the 'chcp' command to get the current code page.
+ * For Unix-like systems, it checks environment variables like LC_ALL, LC_CTYPE, and LANG.
+ * If those are not set, it tries to run 'locale charmap' to get the encoding.
+ * If detection fails, it returns null.
+ * @returns The system encoding as a string, or null if detection fails.
+ */
+export declare function getSystemEncoding(): string | null;
+/**
+ * Converts a Windows code page number to a corresponding encoding name.
+ * @param cp The Windows code page number (e.g., 437, 850, etc.)
+ * @returns The corresponding encoding name as a string, or null if no mapping exists.
+ */
+export declare function windowsCodePageToEncoding(cp: number): string | null;
+/**
+ * Attempts to detect encoding from a buffer using chardet.
+ * This is useful when system encoding detection fails.
+ * Returns the detected encoding in lowercase, or null if detection fails.
+ * @param buffer The buffer to analyze for encoding.
+ * @return The detected encoding as a lowercase string, or null if detection fails.
+ */
+export declare function detectEncodingFromBuffer(buffer: Buffer): string | null;