@vybestack/llxprt-code-tools 0.10.0-nightly.260613.1adad3b34

package/dist/src/interfaces/ITodoService.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P03
+ * @requirement:REQ-INTERFACE-OWNERSHIP
+ */
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Tools-owned interface for todo management.
+ *
+ * Provides todo store, reminder service, context tracker, and
+ * default agent ID access needed by todo-read, todo-write,
+ * todo-pause, and todo-store tools.
+ *
+ * Consumed by: todo-read, todo-write, todo-pause, todo-store.
+ * Implemented by: CoreTodoServiceAdapter in packages/core.
+ */
+import type { ToolContext } from '../types/tool-context.js';
+import type { Todo } from '../types/todo-schemas.js';
+import type { TodoStateChange } from '../utils/todoReminderService.js';
+/** Opaque handle to the todo store. */
+export interface TodoStore {
+    /** Get all todos. */
+    getTodos?: () => Todo[];
+    /** Set/replace all todos. */
+    setTodos?: (todos: Todo[]) => void;
+    /** Read persisted todos asynchronously. */
+    readTodos?: () => Promise<Todo[]>;
+    /** Write persisted todos asynchronously. */
+    writeTodos?: (todos: Todo[]) => Promise<void>;
+    /** Read paused state. */
+    readPausedState?: () => Promise<boolean>;
+    /** Write paused state. */
+    writePausedState?: (paused: boolean) => Promise<void>;
+}
+/** Opaque handle to the todo reminder service. */
+export interface TodoReminderService {
+    /** Calculate the difference between two todo lists. */
+    calculateStateChange?: (oldTodos: Todo[], newTodos: Todo[]) => TodoStateChange;
+    /** Check whether a reminder should be generated. */
+    shouldGenerateReminder?: (stateChange: TodoStateChange) => boolean;
+    /** Get reminder text for a state change. */
+    getReminderForStateChange?: (stateChange: TodoStateChange) => string | undefined;
+    /** Get reminder text when the todo list is empty. */
+    getReminderForEmptyTodos?: (isComplexTask: boolean) => string;
+}
+/** Opaque handle to the todo context tracker. */
+export interface TodoContextTracker {
+    /** Set the active todo. */
+    setActiveTodo?: (todoId: string | null) => void;
+    /** Clear the active todo. */
+    clearActiveTodo?: () => void;
+    /** Read the active todo. */
+    getActiveTodo?: () => string | null;
+}
+export interface ITodoService {
+    /**
+     * Get the todo store instance.
+     * @returns The todo store.
+     */
+    getTodoStore(context?: ToolContext): TodoStore;
+    /**
+     * Get the todo reminder service instance.
+     * @returns The reminder service.
+     */
+    getReminderService(): TodoReminderService;
+    /**
+     * Get the todo context tracker instance.
+     * @returns The context tracker.
+     */
+    getContextTracker(context?: ToolContext): TodoContextTracker;
+    /**
+     * Get the default agent ID for todo scoping.
+     * @returns The default agent ID.
+     */
+    getDefaultAgentId(): string;
+}

package/dist/src/interfaces/ITodoService.js

@@ -0,0 +1,6 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P03
+ * @requirement:REQ-INTERFACE-OWNERSHIP
+ */
+export {};
+//# sourceMappingURL=ITodoService.js.map

package/dist/src/interfaces/ITodoService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITodoService.js","sourceRoot":"","sources":["../../../src/interfaces/ITodoService.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/interfaces/IToolHost.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P03
+ * @requirement:REQ-INTERFACE-OWNERSHIP
+ */
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Tools-owned interface for host environment access.
+ *
+ * Provides target directory, workspace roots, approval mode,
+ * interactive state, and feature flag queries needed by
+ * file-manipulation and search tools.
+ *
+ * Consumed by: write-file, insert_at_line, delete_line_range,
+ * apply-patch, read_line_range, glob, grep, edit, ast-edit.
+ * Implemented by: CoreToolHostAdapter in packages/core.
+ */
+export type ApprovalMode = 'auto' | 'yolo' | 'default';
+export interface IToolHostFileService {
+    shouldGitIgnoreFile(filePath: string): boolean;
+    shouldLlxprtIgnoreFile(filePath: string): boolean;
+    filterFiles(paths: string[], opts: {
+        respectGitIgnore: boolean;
+        respectLlxprtIgnore: boolean;
+    }): string[];
+}
+export interface IToolHostFileFilteringOptions {
+    respectGitIgnore: boolean;
+    respectLlxprtIgnore: boolean;
+}
+export interface IToolHostFileSystemService {
+    readTextFile(filePath: string): Promise<string>;
+    writeTextFile(filePath: string, content: string): Promise<void>;
+}
+export interface IToolHostGitStatsService {
+    trackFileEdit(filePath: string, currentContent: string, newContent: string): Promise<unknown>;
+}
+export interface IToolHost {
+    /** Returns the target directory for file operations. */
+    getTargetDir(): string;
+    /** Returns the list of workspace root paths. */
+    getWorkspaceRoots(): string[];
+    /** Returns the current approval mode string. */
+    getApprovalMode(): ApprovalMode;
+    /** Updates the current approval mode. */
+    setApprovalMode(mode: ApprovalMode): void;
+    /** Whether the tool is running in interactive mode. */
+    isInteractive(): boolean;
+    /** Whether a specific feature flag is enabled. */
+    hasFeatureFlag(flag: string): boolean;
+    /** Returns file discovery/filtering services needed by filesystem tools. */
+    getFileService(): IToolHostFileService;
+    /** Returns default file filtering options. */
+    getFileFilteringOptions(): IToolHostFileFilteringOptions;
+    /** Returns glob exclusion patterns. */
+    getFileExclusions(): string[];
+    /** Returns read-many-files exclusion patterns. */
+    getReadManyFilesExclusions(): string[];
+    /** Whether .llxprtignore filtering is enabled. */
+    getFileFilteringRespectLlxprtIgnore(): boolean;
+    /** Returns the absolute path to the .llxprtignore file if it should be used. */
+    getLlxprtIgnoreFilePath(): string | null;
+    /** Records a file read operation for host telemetry. */
+    recordFileRead(filePath: string, lines?: number, mimeType?: string): void;
+    /** Returns the filesystem service used for file reads/writes when available. */
+    getFileSystemService?(): IToolHostFileSystemService | undefined;
+    /** Returns the file-service .llxprtignore patterns when available. */
+    getLlxprtIgnorePatterns(): string[];
+    /** Returns ephemeral settings used for output limits and feature toggles. */
+    getEphemeralSettings(): Record<string, unknown>;
+    /** Whether debug logging is enabled. */
+    getDebugMode(): boolean;
+    /** Whether conversation logging is enabled for metadata collection. */
+    getConversationLoggingEnabled?(): boolean;
+    /** Returns the git stats service used for edit metadata when enabled. */
+    getGitStatsService?(): IToolHostGitStatsService | undefined;
+    /** Returns provider server-tools support for tools that delegate to provider-native tools. */
+    getServerToolsProvider?(): {
+        getServerTools: () => string[];
+        invokeServerTool: (name: string, params: {
+            prompt: string;
+        }, options: {
+            signal: AbortSignal;
+        }) => Promise<unknown>;
+    } | null;
+    /** Whether the host has a provider manager configured. */
+    hasProviderManager?(): boolean;
+}

package/dist/src/interfaces/IToolHost.js

@@ -0,0 +1,6 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P03
+ * @requirement:REQ-INTERFACE-OWNERSHIP
+ */
+export {};
+//# sourceMappingURL=IToolHost.js.map

package/dist/src/interfaces/IToolHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IToolHost.js","sourceRoot":"","sources":["../../../src/interfaces/IToolHost.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/interfaces/IToolKeyStorage.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P03
+ * @requirement:REQ-INTERFACE-OWNERSHIP
+ */
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Tools-owned interface for tool key storage.
+ *
+ * Provides API key management operations needed by
+ * tool-key-storage, codesearch, exa-web-search, and
+ * google-web-search tools.
+ *
+ * Consumed by: tool-key-storage, codesearch, exa-web-search,
+ * google-web-search.
+ * Implemented by: CoreToolKeyStorageAdapter in packages/core.
+ */
+export interface IToolKeyStorage {
+    /**
+     * Save an API key for a tool.
+     * @param toolName - The tool name.
+     * @param key - The API key to save.
+     */
+    saveKey(toolName: string, key: string): Promise<void>;
+    /**
+     * Get an API key for a tool.
+     * @param toolName - The tool name.
+     * @returns The API key, or null if not found.
+     */
+    getKey(toolName: string): Promise<string | null>;
+    /**
+     * Delete an API key for a tool.
+     * @param toolName - The tool name.
+     */
+    deleteKey(toolName: string): Promise<void>;
+    /**
+     * Check if an API key exists for a tool.
+     * @param toolName - The tool name.
+     * @returns Whether the key exists.
+     */
+    hasKey(toolName: string): Promise<boolean>;
+    /**
+     * Resolve an API key for a tool, checking multiple sources.
+     * @param toolName - The tool name.
+     * @returns The resolved API key, or null if not found.
+     */
+    resolveKey(toolName: string): Promise<string | null>;
+    /**
+     * Mask an API key for display purposes.
+     * @param key - The API key to mask.
+     * @returns The masked key string.
+     */
+    maskKeyForDisplay(key: string): string;
+    /**
+     * Get the list of tool names that support key storage.
+     * @returns Array of supported tool names.
+     */
+    getSupportedToolNames(): string[];
+}

package/dist/src/interfaces/IToolKeyStorage.js

@@ -0,0 +1,6 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P03
+ * @requirement:REQ-INTERFACE-OWNERSHIP
+ */
+export {};
+//# sourceMappingURL=IToolKeyStorage.js.map

package/dist/src/interfaces/IToolKeyStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IToolKeyStorage.js","sourceRoot":"","sources":["../../../src/interfaces/IToolKeyStorage.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/interfaces/IToolMessageBus.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P03
+ * @requirement:REQ-INTERFACE-OWNERSHIP
+ */
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Tools-owned interface for the tool message bus.
+ *
+ * Provides confirmation request, policy update, and optional
+ * subscription capabilities needed by tools that require user
+ * confirmation before execution.
+ *
+ * Consumed by: tools.ts / BaseToolInvocation, modifiable-tool,
+ * shell, mcp-tool.
+ * Implemented by: CoreMessageBusAdapter in packages/core.
+ */
+export type { ToolConfirmationOutcome } from '../types/tool-confirmation-types.js';
+import type { ToolConfirmationOutcome } from '../types/tool-confirmation-types.js';
+/** Options for policy update after confirmation. */
+export interface PolicyUpdateOptions {
+    /** Tool name whose policy should be updated. */
+    toolName?: string;
+    /** Whether to persist the update. */
+    persist?: boolean;
+    /** Optional shell command prefix used by shell-like tools. */
+    commandPrefix?: string | string[];
+    /** Optional MCP server name used by MCP tools. */
+    mcpName?: string;
+}
+/** Handler for tool message events. */
+export type ToolMessageHandler = (event: ToolMessageEvent) => void | Promise<void>;
+/** Event emitted through the message bus. */
+export interface ToolMessageEvent {
+    type: string;
+    payload?: unknown;
+}
+/** Unsubscribe function returned by subscribe. */
+export type Unsubscribe = () => void;
+export interface IToolMessageBus {
+    /**
+     * Request user confirmation for a tool call.
+     * @param details - Serializable confirmation details object.
+     * @param abortSignal - Optional abort signal for cancellation.
+     * @returns The outcome of the confirmation request.
+     */
+    requestConfirmation(...args: any[]): Promise<any>;
+    /**
+     * Publish a policy update after confirmation.
+     * @param outcome - The confirmation outcome to apply.
+     * @param options - Optional policy update options.
+     */
+    publishPolicyUpdate?(outcome: ToolConfirmationOutcome, options?: PolicyUpdateOptions): Promise<void>;
+    /**
+     * Optional: subscribe to message bus events.
+     * @param handler - Handler function for events.
+     * @returns Unsubscribe function.
+     */
+    subscribe?: any;
+}

package/dist/src/interfaces/IToolMessageBus.js

@@ -0,0 +1,6 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P03
+ * @requirement:REQ-INTERFACE-OWNERSHIP
+ */
+export {};
+//# sourceMappingURL=IToolMessageBus.js.map

package/dist/src/interfaces/IToolMessageBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IToolMessageBus.js","sourceRoot":"","sources":["../../../src/interfaces/IToolMessageBus.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/interfaces/IToolRegistryHost.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P03
+ * @requirement:REQ-INTERFACE-OWNERSHIP
+ */
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Tools-owned interface for tool registry host queries.
+ *
+ * Provides core tools list, excluded tools, discovery command,
+ * and tool enablement checks needed by the tool-registry tool.
+ *
+ * Consumed by: tool-registry.
+ * Implemented by: CoreToolRegistryHostAdapter in packages/core.
+ */
+export interface IToolRegistryHost {
+    /** Returns ephemeral settings used for tool governance. */
+    getEphemeralSettings?(): Record<string, unknown> | null | undefined;
+    /** Returns the list of core tool names. */
+    getCoreTools?(): string[] | undefined;
+    /** Returns the list of excluded tool names. */
+    getExcludeTools?(): string[] | undefined;
+    /** Returns the tool discovery command, if configured. */
+    getToolDiscoveryCommand?(): string | undefined;
+    /** Returns the tool call command, if configured. */
+    getToolCallCommand?(): string | undefined;
+    /** Returns the prompt registry boundary used by discovery refreshes. */
+    getPromptRegistry?(): {
+        clear(): void;
+    } | undefined;
+    /** Returns settings used for schema transforms. */
+    getSettingsService?(): {
+        getAllGlobalSettings?(): Record<string, unknown> | undefined;
+        get?(key: string): unknown;
+    } | undefined;
+    /** Whether a specific tool is enabled. */
+    isToolEnabled?(name: string): boolean;
+    /** Whether the host workspace is trusted for trusted MCP tools. */
+    isTrustedFolder?(): boolean;
+}

package/dist/src/interfaces/IToolRegistryHost.js

@@ -0,0 +1,6 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P03
+ * @requirement:REQ-INTERFACE-OWNERSHIP
+ */
+export {};
+//# sourceMappingURL=IToolRegistryHost.js.map

package/dist/src/interfaces/IToolRegistryHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IToolRegistryHost.js","sourceRoot":"","sources":["../../../src/interfaces/IToolRegistryHost.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/interfaces/IWebSearchService.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface WebSearchServerToolsProvider {
+    getServerTools(): string[];
+    invokeServerTool(name: string, params: {
+        query: string;
+    }, options: {
+        signal: AbortSignal;
+    }): Promise<unknown>;
+}
+export interface IWebSearchService {
+    getServerToolsProvider(): WebSearchServerToolsProvider | undefined;
+}

package/dist/src/interfaces/IWebSearchService.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=IWebSearchService.js.map

package/dist/src/interfaces/IWebSearchService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IWebSearchService.js","sourceRoot":"","sources":["../../../src/interfaces/IWebSearchService.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/interfaces/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P03
+ * @requirement:REQ-INTERFACE-OWNERSHIP
+ */
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Barrel export for tools-owned interface contracts.
+ *
+ * All interfaces are defined in packages/tools and must not
+ * import from packages/core, packages/cli, or packages/providers.
+ */
+export type { ApprovalMode, IToolHost, IToolHostFileFilteringOptions, IToolHostFileService, IToolHostFileSystemService, IToolHostGitStatsService, } from './IToolHost.js';
+export type { IToolRegistryHost } from './IToolRegistryHost.js';
+export type { IToolMessageBus, ToolConfirmationOutcome, PolicyUpdateOptions, ToolMessageHandler, ToolMessageEvent, Unsubscribe, } from './IToolMessageBus.js';
+export type { IShellExecutionService, ShellOptions, ShellResult, } from './IShellExecutionService.js';
+export type { ISubagentService, SubagentExecutionOptions, SubagentRequest, SubagentResult, SubagentInfo, SubagentConfig, } from './ISubagentService.js';
+export type { IAsyncTaskService, AsyncTaskStatus, AsyncTaskInfo, AsyncTaskLookupResult, } from './IAsyncTaskService.js';
+export type { ISkillService, SkillActivationResult, SkillManager, SkillInfo, } from './ISkillService.js';
+export type { IMcpToolService, McpFunctionCall, McpResponsePart, McpToolParams, } from './IMcpToolService.js';
+export type { IIdeService, DiffParams, DiffUpdateResult, IDEConnectionStatus, OpenDiffParams, } from './IIdeService.js';
+export type { ILspService, Diagnostic, LspConfig } from './ILspService.js';
+export type { IStorageService } from './IStorageService.js';
+export type { IToolKeyStorage } from './IToolKeyStorage.js';
+export type { ITodoService, TodoStore, TodoReminderService, TodoContextTracker, } from './ITodoService.js';
+export type { ISettingsService, SettingsService } from './ISettingsService.js';
+export type { IShellToolHost, ShellExecutionResult, ShellOutputEvent, CommandPolicyResult, OutputLimits, ShellExecutionConfig, ShellTimeoutConfig, CommandRootsResult, } from './IShellToolHost.js';
+export type { ITaskToolHost, LaunchedSubagent, ISubagentScope, ISubagentOutput, TaskLaunchRequest, TaskTimeoutConfig, AsyncSettingsCheck, AsyncSlotResult, AsyncTaskRegistration, CanLaunchResult, IToolGovernance, } from './ITaskToolHost.js';
+export type { IPromptRegistryService, PromptRegistry, Prompt, } from './IPromptRegistryService.js';
+export type { IWebSearchService, WebSearchServerToolsProvider, } from './IWebSearchService.js';

package/dist/src/interfaces/index.js

@@ -0,0 +1,6 @@
+/**
+ * @plan:PLAN-20260608-ISSUE1585.P03
+ * @requirement:REQ-INTERFACE-OWNERSHIP
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/src/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/src/tools/activate-skill.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ToolResult, ToolInvocation } from './tools.js';
+import { BaseDeclarativeTool } from './tools.js';
+import type { IToolMessageBus, ISkillService } from '../interfaces/index.js';
+/**
+ * Parameters for the ActivateSkill tool
+ */
+export interface ActivateSkillToolParams {
+    /**
+     * The name of the skill to activate
+     */
+    name: string;
+}
+/**
+ * Implementation of the ActivateSkill tool logic
+ */
+export declare class ActivateSkillTool extends BaseDeclarativeTool<ActivateSkillToolParams, ToolResult> {
+    private readonly skillService;
+    static readonly Name = "activate_skill";
+    constructor(skillService: ISkillService, messageBus: IToolMessageBus);
+    protected createInvocation(params: ActivateSkillToolParams, messageBus: IToolMessageBus, _toolName?: string, _toolDisplayName?: string): ToolInvocation<ActivateSkillToolParams, ToolResult>;
+}

package/dist/src/tools/activate-skill.js

@@ -0,0 +1,121 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { BaseDeclarativeTool, BaseToolInvocation, Kind } from './tools.js';
+import { ACTIVATE_SKILL_TOOL_NAME } from '../types/tool-names.js';
+import { ToolErrorType } from '../types/tool-error.js';
+class ActivateSkillToolInvocation extends BaseToolInvocation {
+    skillService;
+    cachedFolderStructure;
+    constructor(skillService, params, messageBus, _toolName, _toolDisplayName) {
+        super(params, messageBus, _toolName, _toolDisplayName);
+        this.skillService = skillService;
+    }
+    getDescription() {
+        const skillName = this.params.name;
+        const skill = this.skillService.getSkill(skillName);
+        if (skill) {
+            return `"${skillName}": ${skill.description}`;
+        }
+        return `"${skillName}" (?) unknown skill`;
+    }
+    async getOrFetchFolderStructure(skillName) {
+        this.cachedFolderStructure ??=
+            await this.skillService.getFolderStructure(skillName);
+        return this.cachedFolderStructure;
+    }
+    async shouldConfirmExecute(_abortSignal) {
+        if (!this.messageBus) {
+            return false;
+        }
+        const skillName = this.params.name;
+        const skill = this.skillService.getSkill(skillName);
+        if (!skill) {
+            return false;
+        }
+        const folderStructure = await this.getOrFetchFolderStructure(skillName);
+        const confirmationDetails = {
+            type: 'info',
+            title: `Activate Skill: ${skillName}`,
+            prompt: `You are about to enable the specialized agent skill **${skillName}**.
+
+**Description:**
+${skill.description ?? ''}
+
+**Resources to be shared with the model:**
+${folderStructure}`,
+            onConfirm: async (outcome) => {
+                await this.publishPolicyUpdate(outcome);
+            },
+        };
+        return confirmationDetails;
+    }
+    async execute(_signal) {
+        const skillName = this.params.name;
+        const result = await this.skillService.activateSkill(skillName);
+        if (!result.success) {
+            const availableSkills = result.availableSkills?.join(', ') ?? '';
+            const errorMessage = result.error ??
+                `Skill "${skillName}" not found. Available skills are: ${availableSkills}`;
+            return {
+                llmContent: `Error: ${errorMessage}`,
+                returnDisplay: `Error: ${errorMessage}`,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.INVALID_TOOL_PARAMS,
+                },
+            };
+        }
+        const folderStructure = result.folderStructure ??
+            (await this.getOrFetchFolderStructure(skillName));
+        return {
+            llmContent: `<activated_skill name="${skillName}">
+  <instructions>
+    ${result.instructions ?? ''}
+  </instructions>
+
+  <available_resources>
+    ${folderStructure}
+  </available_resources>
+</activated_skill>`,
+            returnDisplay: `Skill **${skillName}** activated. Resources loaded from \`${result.resourceDirectory ?? ''}\`:\n\n${folderStructure}`,
+        };
+    }
+}
+/**
+ * Implementation of the ActivateSkill tool logic
+ */
+export class ActivateSkillTool extends BaseDeclarativeTool {
+    skillService;
+    static Name = ACTIVATE_SKILL_TOOL_NAME;
+    constructor(skillService, messageBus) {
+        const skills = skillService.listSkills();
+        const skillNames = skills.map((s) => s.name);
+        let schema;
+        if (skillNames.length === 0) {
+            schema = z.object({
+                name: z.string().describe('No skills are currently available.'),
+            });
+        }
+        else {
+            schema = z.object({
+                name: z
+                    .enum(skillNames)
+                    .describe('The name of the skill to activate.'),
+            });
+        }
+        const availableSkillsHint = skillNames.length > 0
+            ? ` (Available: ${skillNames.map((n) => `'${n}'`).join(', ')})`
+            : '';
+        super(ActivateSkillTool.Name, 'Activate Skill', `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.`, Kind.Other, zodToJsonSchema(schema), true, false, messageBus);
+        this.skillService = skillService;
+    }
+    createInvocation(params, messageBus, _toolName, _toolDisplayName) {
+        return new ActivateSkillToolInvocation(this.skillService, params, messageBus, _toolName, _toolDisplayName ?? 'Activate Skill');
+    }
+}
+//# sourceMappingURL=activate-skill.js.map

package/dist/src/tools/activate-skill.js.map

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