@office-ai/aioncli-core 0.26.0 → 0.30.0

package/dist/src/tools/definitions/coreTools.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Orchestrator for tool definitions.
+ * Resolves the correct toolset based on model family and provides legacy exports.
+ */
+import type { ToolDefinition, CoreToolSet } from './types.js';
+export { GLOB_TOOL_NAME, GREP_TOOL_NAME, LS_TOOL_NAME, READ_FILE_TOOL_NAME, SHELL_TOOL_NAME, WRITE_FILE_TOOL_NAME, EDIT_TOOL_NAME, WEB_SEARCH_TOOL_NAME, WRITE_TODOS_TOOL_NAME, WEB_FETCH_TOOL_NAME, READ_MANY_FILES_TOOL_NAME, MEMORY_TOOL_NAME, GET_INTERNAL_DOCS_TOOL_NAME, ACTIVATE_SKILL_TOOL_NAME, ASK_USER_TOOL_NAME, EXIT_PLAN_MODE_TOOL_NAME, ENTER_PLAN_MODE_TOOL_NAME, } from './base-declarations.js';
+export { DEFAULT_LEGACY_SET } from './model-family-sets/default-legacy.js';
+export { GEMINI_3_SET } from './model-family-sets/gemini-3.js';
+/**
+ * Resolves the appropriate tool set for a given model ID.
+ */
+export declare function getToolSet(modelId?: string): CoreToolSet;
+export declare const READ_FILE_DEFINITION: ToolDefinition;
+export declare const WRITE_FILE_DEFINITION: ToolDefinition;
+export declare const GREP_DEFINITION: ToolDefinition;
+export declare const RIP_GREP_DEFINITION: ToolDefinition;
+export declare const WEB_SEARCH_DEFINITION: ToolDefinition;
+export declare const EDIT_DEFINITION: ToolDefinition;
+export declare const GLOB_DEFINITION: ToolDefinition;
+export declare const LS_DEFINITION: ToolDefinition;
+export declare const WEB_FETCH_DEFINITION: ToolDefinition;
+export declare const READ_MANY_FILES_DEFINITION: ToolDefinition;
+export declare const MEMORY_DEFINITION: ToolDefinition;
+export declare const WRITE_TODOS_DEFINITION: ToolDefinition;
+export declare const GET_INTERNAL_DOCS_DEFINITION: ToolDefinition;
+export declare const ASK_USER_DEFINITION: ToolDefinition;
+export declare const ENTER_PLAN_MODE_DEFINITION: ToolDefinition;
+export { getShellToolDescription, getCommandDescription, } from './dynamic-declaration-helpers.js';
+export declare function getShellDefinition(enableInteractiveShell: boolean, enableEfficiency: boolean): ToolDefinition;
+export declare function getExitPlanModeDefinition(plansDir: string): ToolDefinition;
+export declare function getActivateSkillDefinition(skillNames: string[]): ToolDefinition;

package/dist/src/tools/definitions/coreTools.js

@@ -0,0 +1,143 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getToolFamily } from './modelFamilyService.js';
+import { DEFAULT_LEGACY_SET } from './model-family-sets/default-legacy.js';
+import { GEMINI_3_SET } from './model-family-sets/gemini-3.js';
+import { getShellDeclaration, getExitPlanModeDeclaration, getActivateSkillDeclaration, } from './dynamic-declaration-helpers.js';
+// Re-export names for compatibility
+export { GLOB_TOOL_NAME, GREP_TOOL_NAME, LS_TOOL_NAME, READ_FILE_TOOL_NAME, SHELL_TOOL_NAME, WRITE_FILE_TOOL_NAME, EDIT_TOOL_NAME, WEB_SEARCH_TOOL_NAME, WRITE_TODOS_TOOL_NAME, WEB_FETCH_TOOL_NAME, READ_MANY_FILES_TOOL_NAME, MEMORY_TOOL_NAME, GET_INTERNAL_DOCS_TOOL_NAME, ACTIVATE_SKILL_TOOL_NAME, ASK_USER_TOOL_NAME, EXIT_PLAN_MODE_TOOL_NAME, ENTER_PLAN_MODE_TOOL_NAME, } from './base-declarations.js';
+// Re-export sets for compatibility
+export { DEFAULT_LEGACY_SET } from './model-family-sets/default-legacy.js';
+export { GEMINI_3_SET } from './model-family-sets/gemini-3.js';
+/**
+ * Resolves the appropriate tool set for a given model ID.
+ */
+export function getToolSet(modelId) {
+    const family = getToolFamily(modelId);
+    switch (family) {
+        case 'gemini-3':
+            return GEMINI_3_SET;
+        case 'default-legacy':
+        default:
+            return DEFAULT_LEGACY_SET;
+    }
+}
+// ============================================================================
+// TOOL DEFINITIONS (LEGACY EXPORTS)
+// ============================================================================
+export const READ_FILE_DEFINITION = {
+    get base() {
+        return DEFAULT_LEGACY_SET.read_file;
+    },
+    overrides: (modelId) => getToolSet(modelId).read_file,
+};
+export const WRITE_FILE_DEFINITION = {
+    get base() {
+        return DEFAULT_LEGACY_SET.write_file;
+    },
+    overrides: (modelId) => getToolSet(modelId).write_file,
+};
+export const GREP_DEFINITION = {
+    get base() {
+        return DEFAULT_LEGACY_SET.grep_search;
+    },
+    overrides: (modelId) => getToolSet(modelId).grep_search,
+};
+export const RIP_GREP_DEFINITION = {
+    get base() {
+        return DEFAULT_LEGACY_SET.grep_search_ripgrep;
+    },
+    overrides: (modelId) => getToolSet(modelId).grep_search_ripgrep,
+};
+export const WEB_SEARCH_DEFINITION = {
+    get base() {
+        return DEFAULT_LEGACY_SET.google_web_search;
+    },
+    overrides: (modelId) => getToolSet(modelId).google_web_search,
+};
+export const EDIT_DEFINITION = {
+    get base() {
+        return DEFAULT_LEGACY_SET.replace;
+    },
+    overrides: (modelId) => getToolSet(modelId).replace,
+};
+export const GLOB_DEFINITION = {
+    get base() {
+        return DEFAULT_LEGACY_SET.glob;
+    },
+    overrides: (modelId) => getToolSet(modelId).glob,
+};
+export const LS_DEFINITION = {
+    get base() {
+        return DEFAULT_LEGACY_SET.list_directory;
+    },
+    overrides: (modelId) => getToolSet(modelId).list_directory,
+};
+export const WEB_FETCH_DEFINITION = {
+    get base() {
+        return DEFAULT_LEGACY_SET.web_fetch;
+    },
+    overrides: (modelId) => getToolSet(modelId).web_fetch,
+};
+export const READ_MANY_FILES_DEFINITION = {
+    get base() {
+        return DEFAULT_LEGACY_SET.read_many_files;
+    },
+    overrides: (modelId) => getToolSet(modelId).read_many_files,
+};
+export const MEMORY_DEFINITION = {
+    get base() {
+        return DEFAULT_LEGACY_SET.save_memory;
+    },
+    overrides: (modelId) => getToolSet(modelId).save_memory,
+};
+export const WRITE_TODOS_DEFINITION = {
+    get base() {
+        return DEFAULT_LEGACY_SET.write_todos;
+    },
+    overrides: (modelId) => getToolSet(modelId).write_todos,
+};
+export const GET_INTERNAL_DOCS_DEFINITION = {
+    get base() {
+        return DEFAULT_LEGACY_SET.get_internal_docs;
+    },
+    overrides: (modelId) => getToolSet(modelId).get_internal_docs,
+};
+export const ASK_USER_DEFINITION = {
+    get base() {
+        return DEFAULT_LEGACY_SET.ask_user;
+    },
+    overrides: (modelId) => getToolSet(modelId).ask_user,
+};
+export const ENTER_PLAN_MODE_DEFINITION = {
+    get base() {
+        return DEFAULT_LEGACY_SET.enter_plan_mode;
+    },
+    overrides: (modelId) => getToolSet(modelId).enter_plan_mode,
+};
+// ============================================================================
+// DYNAMIC TOOL DEFINITIONS (LEGACY EXPORTS)
+// ============================================================================
+export { getShellToolDescription, getCommandDescription, } from './dynamic-declaration-helpers.js';
+export function getShellDefinition(enableInteractiveShell, enableEfficiency) {
+    return {
+        base: getShellDeclaration(enableInteractiveShell, enableEfficiency),
+        overrides: (modelId) => getToolSet(modelId).run_shell_command(enableInteractiveShell, enableEfficiency),
+    };
+}
+export function getExitPlanModeDefinition(plansDir) {
+    return {
+        base: getExitPlanModeDeclaration(plansDir),
+        overrides: (modelId) => getToolSet(modelId).exit_plan_mode(plansDir),
+    };
+}
+export function getActivateSkillDefinition(skillNames) {
+    return {
+        base: getActivateSkillDeclaration(skillNames),
+        overrides: (modelId) => getToolSet(modelId).activate_skill(skillNames),
+    };
+}
+//# sourceMappingURL=coreTools.js.map

package/dist/src/tools/definitions/coreTools.js.map

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

package/dist/src/tools/definitions/coreToolsModelSnapshots.test.d.ts

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

package/dist/src/tools/definitions/coreToolsModelSnapshots.test.js

@@ -0,0 +1,82 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+// Mock node:os BEFORE importing coreTools to ensure it uses the mock
+vi.mock('node:os', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        platform: () => 'linux',
+    };
+});
+import { resolveToolDeclaration } from './resolver.js';
+import { READ_FILE_DEFINITION, WRITE_FILE_DEFINITION, GREP_DEFINITION, RIP_GREP_DEFINITION, GLOB_DEFINITION, LS_DEFINITION, getShellDefinition, EDIT_DEFINITION, WEB_SEARCH_DEFINITION, WEB_FETCH_DEFINITION, READ_MANY_FILES_DEFINITION, MEMORY_DEFINITION, WRITE_TODOS_DEFINITION, GET_INTERNAL_DOCS_DEFINITION, ASK_USER_DEFINITION, ENTER_PLAN_MODE_DEFINITION, getExitPlanModeDefinition, getActivateSkillDefinition, } from './coreTools.js';
+describe('coreTools snapshots for specific models', () => {
+    const mockPlatform = (platform) => {
+        vi.stubGlobal('process', Object.create(process, {
+            platform: {
+                get: () => platform,
+            },
+        }));
+    };
+    beforeEach(() => {
+        vi.resetAllMocks();
+        // Stub process.platform to 'linux' by default for deterministic snapshots across OSes
+        mockPlatform('linux');
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    const modelIds = ['gemini-2.5-pro', 'gemini-3-pro-preview'];
+    const tools = [
+        { name: 'read_file', definition: READ_FILE_DEFINITION },
+        { name: 'write_file', definition: WRITE_FILE_DEFINITION },
+        { name: 'grep_search', definition: GREP_DEFINITION },
+        { name: 'grep_search_ripgrep', definition: RIP_GREP_DEFINITION },
+        { name: 'glob', definition: GLOB_DEFINITION },
+        { name: 'list_directory', definition: LS_DEFINITION },
+        {
+            name: 'run_shell_command',
+            definition: getShellDefinition(true, true),
+        },
+        { name: 'replace', definition: EDIT_DEFINITION },
+        { name: 'google_web_search', definition: WEB_SEARCH_DEFINITION },
+        { name: 'web_fetch', definition: WEB_FETCH_DEFINITION },
+        { name: 'read_many_files', definition: READ_MANY_FILES_DEFINITION },
+        { name: 'save_memory', definition: MEMORY_DEFINITION },
+        { name: 'write_todos', definition: WRITE_TODOS_DEFINITION },
+        { name: 'get_internal_docs', definition: GET_INTERNAL_DOCS_DEFINITION },
+        { name: 'ask_user', definition: ASK_USER_DEFINITION },
+        { name: 'enter_plan_mode', definition: ENTER_PLAN_MODE_DEFINITION },
+        {
+            name: 'exit_plan_mode',
+            definition: getExitPlanModeDefinition('/mock/plans'),
+        },
+        {
+            name: 'activate_skill',
+            definition: getActivateSkillDefinition(['skill1', 'skill2']),
+        },
+        {
+            name: 'activate_skill_empty',
+            definition: getActivateSkillDefinition([]),
+        },
+        {
+            name: 'activate_skill_single',
+            definition: getActivateSkillDefinition(['skill1']),
+        },
+    ];
+    for (const modelId of modelIds) {
+        describe(`Model: ${modelId}`, () => {
+            for (const tool of tools) {
+                it(`snapshot for tool: ${tool.name}`, () => {
+                    const resolved = resolveToolDeclaration(tool.definition, modelId);
+                    expect(resolved).toMatchSnapshot();
+                });
+            }
+        });
+    }
+});
+//# sourceMappingURL=coreToolsModelSnapshots.test.js.map

package/dist/src/tools/definitions/coreToolsModelSnapshots.test.js.map

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

package/dist/src/tools/definitions/dynamic-declaration-helpers.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Reusable logic for generating tool declarations that depend on runtime state
+ * (OS, platforms, or dynamic schema values like available skills).
+ */
+import { type FunctionDeclaration } from '@google/genai';
+/**
+ * Generates the platform-specific description for the shell tool.
+ */
+export declare function getShellToolDescription(enableInteractiveShell: boolean, enableEfficiency: boolean): string;
+/**
+ * Returns the platform-specific description for the 'command' parameter.
+ */
+export declare function getCommandDescription(): string;
+/**
+ * Returns the FunctionDeclaration for the shell tool.
+ */
+export declare function getShellDeclaration(enableInteractiveShell: boolean, enableEfficiency: boolean): FunctionDeclaration;
+/**
+ * Returns the FunctionDeclaration for exiting plan mode.
+ */
+export declare function getExitPlanModeDeclaration(plansDir: string): FunctionDeclaration;
+/**
+ * Returns the FunctionDeclaration for activating a skill.
+ */
+export declare function getActivateSkillDeclaration(skillNames: string[]): FunctionDeclaration;

package/dist/src/tools/definitions/dynamic-declaration-helpers.js

@@ -0,0 +1,135 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Reusable logic for generating tool declarations that depend on runtime state
+ * (OS, platforms, or dynamic schema values like available skills).
+ */
+import {} from '@google/genai';
+import * as os from 'node:os';
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { SHELL_TOOL_NAME, EXIT_PLAN_MODE_TOOL_NAME, ACTIVATE_SKILL_TOOL_NAME, } from './base-declarations.js';
+/**
+ * Generates the platform-specific description for the shell tool.
+ */
+export function getShellToolDescription(enableInteractiveShell, enableEfficiency) {
+    const efficiencyGuidelines = enableEfficiency
+        ? `
+
+      Efficiency Guidelines:
+      - Quiet Flags: Always prefer silent or quiet flags (e.g., \`npm install --silent\`, \`git --no-pager\`) to reduce output volume while still capturing necessary information.
+      - Pagination: Always disable terminal pagination to ensure commands terminate (e.g., use \`git --no-pager\`, \`systemctl --no-pager\`, or set \`PAGER=cat\`).`
+        : '';
+    const returnedInfo = `
+
+      The following information is returned:
+
+      Output: Combined stdout/stderr. Can be \`(empty)\` or partial on error and for any unwaited background processes.
+      Exit Code: Only included if non-zero (command failed).
+      Error: Only included if a process-level error occurred (e.g., spawn failure).
+      Signal: Only included if process was terminated by a signal.
+      Background PIDs: Only included if background processes were started.
+      Process Group PGID: Only included if available.`;
+    if (os.platform() === 'win32') {
+        const backgroundInstructions = enableInteractiveShell
+            ? 'To run a command in the background, set the `is_background` parameter to true. Do NOT use PowerShell background constructs.'
+            : 'Command can start background processes using PowerShell constructs such as `Start-Process -NoNewWindow` or `Start-Job`.';
+        return `This tool executes a given shell command as \`powershell.exe -NoProfile -Command <command>\`. ${backgroundInstructions}${efficiencyGuidelines}${returnedInfo}`;
+    }
+    else {
+        const backgroundInstructions = enableInteractiveShell
+            ? 'To run a command in the background, set the `is_background` parameter to true. Do NOT use `&` to background commands.'
+            : 'Command can start background processes using `&`.';
+        return `This tool executes a given shell command as \`bash -c <command>\`. ${backgroundInstructions} Command is executed as a subprocess that leads its own process group. Command process group can be terminated as \`kill -- -PGID\` or signaled as \`kill -s SIGNAL -- -PGID\`.${efficiencyGuidelines}${returnedInfo}`;
+    }
+}
+/**
+ * Returns the platform-specific description for the 'command' parameter.
+ */
+export function getCommandDescription() {
+    if (os.platform() === 'win32') {
+        return 'Exact command to execute as `powershell.exe -NoProfile -Command <command>`';
+    }
+    return 'Exact bash command to execute as `bash -c <command>`';
+}
+/**
+ * Returns the FunctionDeclaration for the shell tool.
+ */
+export function getShellDeclaration(enableInteractiveShell, enableEfficiency) {
+    return {
+        name: SHELL_TOOL_NAME,
+        description: getShellToolDescription(enableInteractiveShell, enableEfficiency),
+        parametersJsonSchema: {
+            type: 'object',
+            properties: {
+                command: {
+                    type: 'string',
+                    description: getCommandDescription(),
+                },
+                description: {
+                    type: 'string',
+                    description: 'Brief description of the command for the user. Be specific and concise. Ideally a single sentence. Can be up to 3 sentences for clarity. No line breaks.',
+                },
+                dir_path: {
+                    type: 'string',
+                    description: '(OPTIONAL) The path of the directory to run the command in. If not provided, the project root directory is used. Must be a directory within the workspace and must already exist.',
+                },
+                is_background: {
+                    type: 'boolean',
+                    description: 'Set to true if this command should be run in the background (e.g. for long-running servers or watchers). The command will be started, allowed to run for a brief moment to check for immediate errors, and then moved to the background.',
+                },
+            },
+            required: ['command'],
+        },
+    };
+}
+/**
+ * Returns the FunctionDeclaration for exiting plan mode.
+ */
+export function getExitPlanModeDeclaration(plansDir) {
+    return {
+        name: EXIT_PLAN_MODE_TOOL_NAME,
+        description: 'Signals that the planning phase is complete and requests user approval to start implementation.',
+        parametersJsonSchema: {
+            type: 'object',
+            required: ['plan_path'],
+            properties: {
+                plan_path: {
+                    type: 'string',
+                    description: `The file path to the finalized plan (e.g., "${plansDir}/feature-x.md"). This path MUST be within the designated plans directory: ${plansDir}/`,
+                },
+            },
+        },
+    };
+}
+/**
+ * Returns the FunctionDeclaration for activating a skill.
+ */
+export function getActivateSkillDeclaration(skillNames) {
+    const availableSkillsHint = skillNames.length > 0
+        ? ` (Available: ${skillNames.map((n) => `'${n}'`).join(', ')})`
+        : '';
+    let schema;
+    if (skillNames.length === 0) {
+        schema = z.object({
+            name: z.string().describe('No skills are currently available.'),
+        });
+    }
+    else {
+        schema = z.object({
+            name: z
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+                .enum(skillNames)
+                .describe('The name of the skill to activate.'),
+        });
+    }
+    return {
+        name: ACTIVATE_SKILL_TOOL_NAME,
+        description: `Activates a specialized agent skill by name${availableSkillsHint}. Returns the skill's instructions wrapped in \`<activated_skill>\` tags. These provide specialized guidance for the current task. Use this when you identify a task that matches a skill's description. ONLY use names exactly as they appear in the \`<available_skills>\` section.`,
+        parametersJsonSchema: zodToJsonSchema(schema),
+    };
+}
+//# sourceMappingURL=dynamic-declaration-helpers.js.map

package/dist/src/tools/definitions/dynamic-declaration-helpers.js.map

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

package/dist/src/tools/definitions/model-family-sets/default-legacy.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Full tool manifest for legacy models.
+ * Includes complete descriptions and schemas for auditing in one place.
+ */
+import type { CoreToolSet } from '../types.js';
+export declare const DEFAULT_LEGACY_SET: CoreToolSet;