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

package/dist/src/tools/tools.js

@@ -0,0 +1,519 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { randomUUID } from 'node:crypto';
+import { SchemaValidator } from '../utils/schemaValidator.js';
+import { ToolConfirmationOutcome, } from '../types/tool-confirmation-types.js';
+import { ToolErrorType } from '../types/tool-error.js';
+export { ToolConfirmationOutcome } from '../types/tool-confirmation-types.js';
+/**
+ * A convenience base class for ToolInvocation.
+ */
+export class BaseToolInvocation {
+    params;
+    messageBus;
+    _toolName;
+    _toolDisplayName;
+    _serverName;
+    constructor(params, messageBus, _toolName, _toolDisplayName, _serverName) {
+        this.params = params;
+        this.messageBus = messageBus;
+        this._toolName = _toolName;
+        this._toolDisplayName = _toolDisplayName;
+        this._serverName = _serverName;
+    }
+    requireMessageBus() {
+        if (!this.messageBus) {
+            throw new Error('MessageBus is required for this invocation.');
+        }
+        return this.messageBus;
+    }
+    toolLocations() {
+        return [];
+    }
+    /**
+     * Returns confirmation details for this tool invocation.
+     * Tools that require confirmation should override this method.
+     * @returns Confirmation details or null if no confirmation needed.
+     */
+    /**
+     * Returns tool-specific options for policy updates.
+     * Subclasses can override this to provide additional options like
+     * commandPrefix (for shell) or mcpName (for MCP tools).
+     */
+    getPolicyUpdateOptions(_outcome) {
+        return undefined;
+    }
+    /**
+     * Helper method to publish a policy update when user selects
+     * ProceedAlways or ProceedAlwaysAndSave.
+     */
+    async publishPolicyUpdate(outcome) {
+        if ((outcome === ToolConfirmationOutcome.ProceedAlways ||
+            outcome === ToolConfirmationOutcome.ProceedAlwaysAndSave) &&
+            this.messageBus &&
+            this._toolName) {
+            const options = this.getPolicyUpdateOptions(outcome);
+            const policyUpdate = {
+                toolName: this._toolName,
+                persist: outcome === ToolConfirmationOutcome.ProceedAlwaysAndSave,
+                ...options,
+            };
+            if (typeof this.messageBus.publishPolicyUpdate === 'function') {
+                await this.messageBus.publishPolicyUpdate(outcome, policyUpdate);
+                return;
+            }
+            const bus = this.messageBus;
+            await bus.publish?.({
+                type: 'update-policy',
+                ...policyUpdate,
+            });
+        }
+    }
+    getConfirmationDetails() {
+        return null;
+    }
+    /**
+     * Attempts to obtain a policy decision via message bus.
+     *
+     * Semantics:
+     * - `'ALLOW'`: auto-proceed
+     * - `'DENY'`: tool must not execute
+     * - `'ASK_USER'`: fall back to legacy tool confirmation UI
+     */
+    getMessageBusDecision(abortSignal) {
+        if (!this.messageBus) {
+            // No bus wired: allow and let per-tool legacy confirmation logic decide.
+            return Promise.resolve('ALLOW');
+        }
+        if (abortSignal.aborted) {
+            return Promise.resolve('DENY');
+        }
+        const bus = this.messageBus;
+        if (typeof bus.publish !== 'function' ||
+            typeof bus.subscribe !== 'function') {
+            return this.getInterfaceMessageBusDecision(abortSignal);
+        }
+        const correlationId = randomUUID();
+        const toolCall = {
+            name: this.getToolName(),
+            args: this.params,
+        };
+        return new Promise((resolve) => {
+            let timeoutId;
+            const cleanup = () => {
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                    timeoutId = undefined;
+                }
+                abortSignal.removeEventListener('abort', abortHandler);
+                if (typeof bus.unsubscribe === 'function') {
+                    bus.unsubscribe('tool-confirmation-response', responseHandler);
+                }
+            };
+            const abortHandler = () => {
+                cleanup();
+                resolve('DENY');
+            };
+            const responseHandler = (response) => {
+                if (response.correlationId !== correlationId) {
+                    return;
+                }
+                cleanup();
+                if (response.requiresUserConfirmation === true) {
+                    resolve('ASK_USER');
+                    return;
+                }
+                const confirmed = response.confirmed ??
+                    (response.outcome !== undefined
+                        ? response.outcome !== ToolConfirmationOutcome.Cancel &&
+                            response.outcome !== ToolConfirmationOutcome.ModifyWithEditor &&
+                            response.outcome !== ToolConfirmationOutcome.SuggestEdit
+                        : false);
+                resolve(confirmed ? 'ALLOW' : 'DENY');
+            };
+            abortSignal.addEventListener('abort', abortHandler);
+            // Default to ASK_USER if the bus doesn't answer promptly.
+            timeoutId = setTimeout(() => {
+                cleanup();
+                resolve('ASK_USER');
+            }, 30000);
+            bus.subscribe('tool-confirmation-response', responseHandler);
+            try {
+                bus.publish({
+                    type: 'tool-confirmation-request',
+                    toolCall,
+                    correlationId,
+                    serverName: this.getServerName(),
+                });
+            }
+            catch {
+                cleanup();
+                resolve('ALLOW');
+            }
+        });
+    }
+    async getInterfaceMessageBusDecision(abortSignal) {
+        if (!this.messageBus) {
+            return 'ALLOW';
+        }
+        try {
+            const outcome = await this.messageBus.requestConfirmation({
+                toolName: this.getToolName(),
+                args: this.params,
+                serverName: this.getServerName(),
+            }, abortSignal);
+            if (outcome === ToolConfirmationOutcome.Cancel) {
+                return 'DENY';
+            }
+            if (outcome === ToolConfirmationOutcome.ModifyWithEditor ||
+                outcome === ToolConfirmationOutcome.SuggestEdit) {
+                return 'ASK_USER';
+            }
+            return 'ALLOW';
+        }
+        catch {
+            return 'ALLOW';
+        }
+    }
+    /**
+     * Returns the tool name for this invocation.
+     * Subclasses can override to provide a specific tool name.
+     */
+    getToolName() {
+        return this._toolName ?? 'unknown';
+    }
+    /**
+     * Returns the server name for MCP tools.
+     * Regular tools should return undefined.
+     */
+    getServerName() {
+        return this._serverName;
+    }
+    /**
+     * Returns metadata used by the policy engine/message bus.
+     */
+    getPolicyContext() {
+        return {
+            toolName: this.getToolName(),
+            args: this.params,
+            serverName: this.getServerName(),
+        };
+    }
+    shouldConfirmExecute(_abortSignal) {
+        return Promise.resolve(false);
+    }
+}
+/**
+ * New base class for tools that separates validation from execution.
+ * New tools should extend this class.
+ */
+export class DeclarativeTool {
+    name;
+    displayName;
+    description;
+    kind;
+    parameterSchema;
+    isOutputMarkdown;
+    canUpdateOutput;
+    messageBus;
+    constructor(name, displayName, description, kind, parameterSchema, isOutputMarkdown = true, canUpdateOutput = false, messageBus) {
+        this.name = name;
+        this.displayName = displayName;
+        this.description = description;
+        this.kind = kind;
+        this.parameterSchema = parameterSchema;
+        this.isOutputMarkdown = isOutputMarkdown;
+        this.canUpdateOutput = canUpdateOutput;
+        this.messageBus = messageBus;
+    }
+    /**
+     * @plan PLAN-20260309-MESSAGEBUS-DI-REMEDIATION.P11
+     * @requirement REQ-D01-002
+     * @requirement REQ-D01-003
+     * @pseudocode lines 122-133
+     */
+    requireMessageBus() {
+        if (!this.messageBus) {
+            throw new Error(`MessageBus is required to build tool invocations for ${this.name}.`);
+        }
+        return this.messageBus;
+    }
+    get schema() {
+        // Strip requireOne from the schema before sending to the model
+        // The requireOne property is used internally for validation but not sent to the model
+        if (this.parameterSchema !== null &&
+            this.parameterSchema !== undefined &&
+            typeof this.parameterSchema === 'object') {
+            const schemaClone = {
+                ...this.parameterSchema,
+            };
+            delete schemaClone.requireOne;
+            return {
+                name: this.name,
+                description: this.description,
+                parametersJsonSchema: schemaClone,
+            };
+        }
+        return {
+            name: this.name,
+            description: this.description,
+            parametersJsonSchema: this.parameterSchema,
+        };
+    }
+    /**
+     * Validates the raw tool parameters.
+     * Subclasses should override this to add custom validation logic
+     * beyond the JSON schema check.
+     * @param params The raw parameters from the model.
+     * @returns An error message string if invalid, null otherwise.
+     */
+    validateToolParams(_params) {
+        // Base implementation can be extended by subclasses.
+        return null;
+    }
+    /**
+     * A convenience method that builds and executes the tool in one step.
+     * Throws an error if validation fails.
+     * @param params The raw, untrusted parameters from the model.
+     * @param signal AbortSignal for tool cancellation.
+     * @param updateOutput Optional callback to stream output.
+     * @returns The result of the tool execution.
+     */
+    async buildAndExecute(params, signal, updateOutput) {
+        const invocation = this.build(params);
+        return invocation.execute(signal, updateOutput);
+    }
+    /**
+     * Similar to `build` but never throws.
+     * @param params The raw, untrusted parameters from the model.
+     * @returns A `ToolInvocation` instance.
+     */
+    silentBuild(params) {
+        try {
+            return this.build(params);
+        }
+        catch (e) {
+            if (e instanceof Error) {
+                return e;
+            }
+            return new Error(String(e));
+        }
+    }
+    /**
+     * A convenience method that builds and executes the tool in one step.
+     * Never throws.
+     * @param params The raw, untrusted parameters from the model.
+     * @param abortSignal a signal to abort.
+     * @returns The result of the tool execution.
+     */
+    async validateBuildAndExecute(params, abortSignal) {
+        const invocationOrError = this.silentBuild(params);
+        if (invocationOrError instanceof Error) {
+            const errorMessage = invocationOrError.message;
+            return {
+                llmContent: `Error: Invalid parameters provided. Reason: ${errorMessage}`,
+                returnDisplay: errorMessage,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.INVALID_TOOL_PARAMS,
+                },
+            };
+        }
+        try {
+            return await invocationOrError.execute(abortSignal);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                llmContent: `Error: Tool call execution failed. Reason: ${errorMessage}`,
+                returnDisplay: errorMessage,
+                error: {
+                    message: errorMessage,
+                    type: ToolErrorType.EXECUTION_FAILED,
+                },
+            };
+        }
+    }
+}
+/**
+ * New base class for declarative tools that separates validation from execution.
+ * New tools should extend this class, which provides a `build` method that
+ * validates parameters before deferring to a `createInvocation` method for
+ * the final `ToolInvocation` object instantiation.
+ */
+export class BaseDeclarativeTool extends DeclarativeTool {
+    build(params) {
+        const validationError = this.validateToolParams(params);
+        if (validationError) {
+            throw new Error(validationError);
+        }
+        return this.createInvocation(params, this.messageBus);
+    }
+    validateToolParams(params) {
+        const errors = SchemaValidator.validate(this.schema.parametersJsonSchema, params);
+        if (errors) {
+            return errors;
+        }
+        return this.validateToolParamValues(params);
+    }
+    validateToolParamValues(_params) {
+        // Base implementation can be extended by subclasses.
+        return null;
+    }
+}
+/**
+ * Type guard to check if an object is a Tool.
+ * @param obj The object to check.
+ * @returns True if the object is a Tool, false otherwise.
+ */
+export function isTool(obj) {
+    return (
+    // eslint-disable-next-line sonarjs/expression-complexity -- Existing structure is intentionally preserved; refactoring this boundary is outside the lint slice.
+    typeof obj === 'object' &&
+        obj !== null &&
+        'name' in obj &&
+        'build' in obj &&
+        typeof obj.build === 'function');
+}
+/**
+ * Detects cycles in a JSON schemas due to `$ref`s.
+ * @param schema The root of the JSON schema.
+ * @returns `true` if a cycle is detected, `false` otherwise.
+ */
+export function hasCycleInSchema(schema) {
+    function resolveRef(ref) {
+        if (!ref.startsWith('#/')) {
+            return null;
+        }
+        const path = ref.substring(2).split('/');
+        let current = schema;
+        for (const segment of path) {
+            if (typeof current !== 'object' ||
+                current === null ||
+                !Object.prototype.hasOwnProperty.call(current, segment)) {
+                return null;
+            }
+            current = current[segment];
+        }
+        return current;
+    }
+    function traverse(node, visitedRefs, pathRefs) {
+        if (typeof node !== 'object' || node === null) {
+            return false;
+        }
+        if (Array.isArray(node)) {
+            for (const item of node) {
+                if (traverse(item, visitedRefs, pathRefs)) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        if ('$ref' in node && typeof node.$ref === 'string') {
+            const ref = node.$ref;
+            if (ref === '#/' || pathRefs.has(ref)) {
+                // A ref to just '#/' is always a cycle.
+                return true; // Cycle detected!
+            }
+            if (visitedRefs.has(ref)) {
+                return false; // Bail early, we have checked this ref before.
+            }
+            const resolvedNode = resolveRef(ref);
+            if (resolvedNode) {
+                // Add it to both visited and the current path
+                visitedRefs.add(ref);
+                pathRefs.add(ref);
+                const hasCycle = traverse(resolvedNode, visitedRefs, pathRefs);
+                pathRefs.delete(ref); // Backtrack, leaving it in visited
+                return hasCycle;
+            }
+        }
+        // Crawl all the properties of node
+        for (const key in node) {
+            if (Object.prototype.hasOwnProperty.call(node, key) &&
+                traverse(node[key], visitedRefs, pathRefs)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    return traverse(schema, new Set(), new Set());
+}
+export var Kind;
+(function (Kind) {
+    Kind["Read"] = "read";
+    Kind["Edit"] = "edit";
+    Kind["Delete"] = "delete";
+    Kind["Move"] = "move";
+    Kind["Search"] = "search";
+    Kind["Execute"] = "execute";
+    Kind["Think"] = "think";
+    Kind["Fetch"] = "fetch";
+    Kind["Other"] = "other";
+})(Kind || (Kind = {}));
+/**
+ * Legacy BaseTool class for backward compatibility with existing LLxprt tools.
+ * New tools should use BaseDeclarativeTool instead.
+ * @deprecated Use BaseDeclarativeTool for new tools
+ */
+export class BaseTool extends DeclarativeTool {
+    context;
+    constructor(name, displayName, description, kind, parameterSchema, isOutputMarkdown = true, canUpdateOutput = false, messageBus) {
+        super(name, displayName, description, kind, parameterSchema, isOutputMarkdown, canUpdateOutput, messageBus);
+    }
+    /**
+     * Get the schema for this tool. Maintains backward compatibility.
+     */
+    get schema() {
+        return super.schema;
+    }
+    /**
+     * Legacy method signature for getDescription.
+     * Subclasses can override this method.
+     */
+    getDescription(_params) {
+        return `Execute ${this.displayName}`;
+    }
+    /**
+     * Legacy method signature for validateToolParams.
+     * Subclasses can override this method.
+     * Note: The base class expects TParams, but legacy tools pass unknown.
+     */
+    validateToolParams(params) {
+        return super.validateToolParams(params);
+    }
+    /**
+     * Implementation of the new declarative pattern.
+     * Creates a tool invocation that bridges to the legacy execute method.
+     */
+    build(params) {
+        const validationError = this.validateToolParams(params);
+        if (validationError) {
+            throw new Error(validationError);
+        }
+        return new BaseToolLegacyInvocation(this, params, this.messageBus);
+    }
+}
+/**
+ * Tool invocation wrapper for BaseTool legacy API.
+ */
+class BaseToolLegacyInvocation extends BaseToolInvocation {
+    tool;
+    constructor(tool, params, messageBus) {
+        super(params, messageBus);
+        this.tool = tool;
+    }
+    getDescription() {
+        return this.tool.getDescription(this.params);
+    }
+    getToolName() {
+        return this.tool.name;
+    }
+    async execute(signal, updateOutput, _terminalColumns, _terminalRows, _setPidCallback) {
+        return this.tool.execute(this.params, signal, updateOutput);
+    }
+}
+//# sourceMappingURL=tools.js.map

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

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

package/dist/src/tools/write-file.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BaseDeclarativeTool, type ToolResult, type ToolInvocation } from './tools.js';
+import type { IToolHost, IToolMessageBus } from '../interfaces/index.js';
+import { type ModifiableDeclarativeTool, type ModifyContext } from './modifiable-tool.js';
+/**
+ * Parameters for the WriteFile tool
+ */
+export interface WriteFileToolParams {
+    /**
+     * The absolute path to the file to write to
+     */
+    absolute_path?: string;
+    /**
+     * Alternative parameter name for absolute_path (for compatibility)
+     * Not shown in schema - internal use only
+     */
+    file_path?: string;
+    /**
+     * The content to write to the file
+     */
+    content: string;
+    /**
+     * Whether the proposed content was modified by the user.
+     */
+    modified_by_user?: boolean;
+    /**
+     * Initially proposed content.
+     */
+    ai_proposed_content?: string;
+}
+/**
+ * Implementation of the WriteFile tool logic
+ */
+export declare class WriteFileTool extends BaseDeclarativeTool<WriteFileToolParams, ToolResult> implements ModifiableDeclarativeTool<WriteFileToolParams> {
+    private host;
+    static readonly Name: string;
+    constructor(host: IToolHost, messageBus?: IToolMessageBus);
+    protected validateToolParamValues(params: WriteFileToolParams): string | null;
+    protected createInvocation(params: WriteFileToolParams, messageBus?: IToolMessageBus, toolName?: string, displayName?: string): ToolInvocation<WriteFileToolParams, ToolResult>;
+    getModifyContext(_abortSignal: AbortSignal): ModifyContext<WriteFileToolParams>;
+}