@hibanacloud/core 0.3.15

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

@@ -0,0 +1,327 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { FunctionDeclaration, Part, PartListUnion } from '@google/genai';
+import { ToolErrorType } from './tool-error.js';
+import type { DiffUpdateResult } from '../ide/ide-client.js';
+import type { ShellExecutionConfig } from '../services/shellExecutionService.js';
+import { type SubagentStatsSummary } from '../subagents/subagent-statistics.js';
+import type { AnsiOutput } from '../utils/terminalSerializer.js';
+/**
+ * Represents a validated and ready-to-execute tool call.
+ * An instance of this is created by a `ToolBuilder`.
+ */
+export interface ToolInvocation<TParams extends object, TResult extends ToolResult> {
+    /**
+     * The validated parameters for this specific invocation.
+     */
+    params: TParams;
+    /**
+     * Gets a pre-execution description of the tool operation.
+     *
+     * @returns A markdown string describing what the tool will do.
+     */
+    getDescription(): string;
+    /**
+     * Determines what file system paths the tool will affect.
+     * @returns A list of such paths.
+     */
+    toolLocations(): ToolLocation[];
+    /**
+     * Determines if the tool should prompt for confirmation before execution.
+     * @returns Confirmation details or false if no confirmation is needed.
+     */
+    shouldConfirmExecute(abortSignal: AbortSignal): Promise<ToolCallConfirmationDetails | false>;
+    /**
+     * Executes the tool with the validated parameters.
+     * @param signal AbortSignal for tool cancellation.
+     * @param updateOutput Optional callback to stream output.
+     * @returns Result of the tool execution.
+     */
+    execute(signal: AbortSignal, updateOutput?: (output: ToolResultDisplay) => void, shellExecutionConfig?: ShellExecutionConfig): Promise<TResult>;
+}
+/**
+ * A convenience base class for ToolInvocation.
+ */
+export declare abstract class BaseToolInvocation<TParams extends object, TResult extends ToolResult> implements ToolInvocation<TParams, TResult> {
+    readonly params: TParams;
+    constructor(params: TParams);
+    abstract getDescription(): string;
+    toolLocations(): ToolLocation[];
+    shouldConfirmExecute(_abortSignal: AbortSignal): Promise<ToolCallConfirmationDetails | false>;
+    abstract execute(signal: AbortSignal, updateOutput?: (output: ToolResultDisplay) => void, shellExecutionConfig?: ShellExecutionConfig): Promise<TResult>;
+}
+/**
+ * A type alias for a tool invocation where the specific parameter and result types are not known.
+ */
+export type AnyToolInvocation = ToolInvocation<object, ToolResult>;
+/**
+ * Interface for a tool builder that validates parameters and creates invocations.
+ */
+export interface ToolBuilder<TParams extends object, TResult extends ToolResult> {
+    /**
+     * The internal name of the tool (used for API calls).
+     */
+    name: string;
+    /**
+     * The user-friendly display name of the tool.
+     */
+    displayName: string;
+    /**
+     * Description of what the tool does.
+     */
+    description: string;
+    /**
+     * The kind of tool for categorization and permissions
+     */
+    kind: Kind;
+    /**
+     * Function declaration schema from @google/genai.
+     */
+    schema: FunctionDeclaration;
+    /**
+     * Whether the tool's output should be rendered as markdown.
+     */
+    isOutputMarkdown: boolean;
+    /**
+     * Whether the tool supports live (streaming) output.
+     */
+    canUpdateOutput: boolean;
+    /**
+     * Validates raw parameters and builds a ready-to-execute invocation.
+     * @param params The raw, untrusted parameters from the model.
+     * @returns A valid `ToolInvocation` if successful. Throws an error if validation fails.
+     */
+    build(params: TParams): ToolInvocation<TParams, TResult>;
+}
+/**
+ * New base class for tools that separates validation from execution.
+ * New tools should extend this class.
+ */
+export declare abstract class DeclarativeTool<TParams extends object, TResult extends ToolResult> implements ToolBuilder<TParams, TResult> {
+    readonly name: string;
+    readonly displayName: string;
+    readonly description: string;
+    readonly kind: Kind;
+    readonly parameterSchema: unknown;
+    readonly isOutputMarkdown: boolean;
+    readonly canUpdateOutput: boolean;
+    constructor(name: string, displayName: string, description: string, kind: Kind, parameterSchema: unknown, isOutputMarkdown?: boolean, canUpdateOutput?: boolean);
+    get schema(): FunctionDeclaration;
+    /**
+     * 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: TParams): string | null;
+    /**
+     * The core of the new pattern. It validates parameters and, if successful,
+     * returns a `ToolInvocation` object that encapsulates the logic for the
+     * specific, validated call.
+     * @param params The raw, untrusted parameters from the model.
+     * @returns A `ToolInvocation` instance.
+     */
+    abstract build(params: TParams): ToolInvocation<TParams, TResult>;
+    /**
+     * 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.
+     */
+    buildAndExecute(params: TParams, signal: AbortSignal, updateOutput?: (output: ToolResultDisplay) => void, shellExecutionConfig?: ShellExecutionConfig): Promise<TResult>;
+    /**
+     * Similar to `build` but never throws.
+     * @param params The raw, untrusted parameters from the model.
+     * @returns A `ToolInvocation` instance.
+     */
+    private silentBuild;
+    /**
+     * A convenience method that builds and executes the tool in one step.
+     * Never throws.
+     * @param params The raw, untrusted parameters from the model.
+     * @params abortSignal a signal to abort.
+     * @returns The result of the tool execution.
+     */
+    validateBuildAndExecute(params: TParams, abortSignal: AbortSignal): Promise<ToolResult>;
+}
+/**
+ * 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 declare abstract class BaseDeclarativeTool<TParams extends object, TResult extends ToolResult> extends DeclarativeTool<TParams, TResult> {
+    build(params: TParams): ToolInvocation<TParams, TResult>;
+    validateToolParams(params: TParams): string | null;
+    protected validateToolParamValues(_params: TParams): string | null;
+    protected abstract createInvocation(params: TParams): ToolInvocation<TParams, TResult>;
+}
+/**
+ * A type alias for a declarative tool where the specific parameter and result types are not known.
+ */
+export type AnyDeclarativeTool = DeclarativeTool<object, ToolResult>;
+/**
+ * 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 declare function isTool(obj: unknown): obj is AnyDeclarativeTool;
+export interface ToolResult {
+    /**
+     * Content meant to be included in LLM history.
+     * This should represent the factual outcome of the tool execution.
+     */
+    llmContent: PartListUnion;
+    /**
+     * Markdown string for user display.
+     * This provides a user-friendly summary or visualization of the result.
+     * NOTE: This might also be considered UI-specific and could potentially be
+     * removed or modified in a further refactor if the server becomes purely API-driven.
+     * For now, we keep it as the core logic in ReadFileTool currently produces it.
+     */
+    returnDisplay: ToolResultDisplay;
+    /**
+     * If this property is present, the tool call is considered a failure.
+     */
+    error?: {
+        message: string;
+        type?: ToolErrorType;
+    };
+}
+/**
+ * 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 declare function hasCycleInSchema(schema: object): boolean;
+export interface TaskResultDisplay {
+    type: 'task_execution';
+    subagentName: string;
+    subagentColor?: string;
+    taskDescription: string;
+    taskPrompt: string;
+    status: 'running' | 'completed' | 'failed' | 'cancelled';
+    terminateReason?: string;
+    result?: string;
+    executionSummary?: SubagentStatsSummary;
+    pendingConfirmation?: ToolCallConfirmationDetails;
+    toolCalls?: Array<{
+        callId: string;
+        name: string;
+        status: 'executing' | 'awaiting_approval' | 'success' | 'failed';
+        error?: string;
+        args?: Record<string, unknown>;
+        result?: string;
+        resultDisplay?: string;
+        responseParts?: Part[];
+        description?: string;
+    }>;
+}
+export interface AnsiOutputDisplay {
+    ansiOutput: AnsiOutput;
+}
+export type ToolResultDisplay = string | FileDiff | TodoResultDisplay | PlanResultDisplay | TaskResultDisplay | AnsiOutputDisplay;
+export interface FileDiff {
+    fileDiff: string;
+    fileName: string;
+    originalContent: string | null;
+    newContent: string;
+    diffStat?: DiffStat;
+}
+export interface DiffStat {
+    model_added_lines: number;
+    model_removed_lines: number;
+    model_added_chars: number;
+    model_removed_chars: number;
+    user_added_lines: number;
+    user_removed_lines: number;
+    user_added_chars: number;
+    user_removed_chars: number;
+}
+export interface TodoResultDisplay {
+    type: 'todo_list';
+    todos: Array<{
+        id: string;
+        content: string;
+        status: 'pending' | 'in_progress' | 'completed';
+    }>;
+}
+export interface PlanResultDisplay {
+    type: 'plan_summary';
+    message: string;
+    plan: string;
+}
+export interface ToolEditConfirmationDetails {
+    type: 'edit';
+    title: string;
+    onConfirm: (outcome: ToolConfirmationOutcome, payload?: ToolConfirmationPayload) => Promise<void>;
+    fileName: string;
+    filePath: string;
+    fileDiff: string;
+    originalContent: string | null;
+    newContent: string;
+    isModifying?: boolean;
+    ideConfirmation?: Promise<DiffUpdateResult>;
+}
+export interface ToolConfirmationPayload {
+    newContent: string;
+}
+export interface ToolExecuteConfirmationDetails {
+    type: 'exec';
+    title: string;
+    onConfirm: (outcome: ToolConfirmationOutcome) => Promise<void>;
+    command: string;
+    rootCommand: string;
+}
+export interface ToolMcpConfirmationDetails {
+    type: 'mcp';
+    title: string;
+    serverName: string;
+    toolName: string;
+    toolDisplayName: string;
+    onConfirm: (outcome: ToolConfirmationOutcome) => Promise<void>;
+}
+export interface ToolInfoConfirmationDetails {
+    type: 'info';
+    title: string;
+    onConfirm: (outcome: ToolConfirmationOutcome) => Promise<void>;
+    prompt: string;
+    urls?: string[];
+}
+export type ToolCallConfirmationDetails = ToolEditConfirmationDetails | ToolExecuteConfirmationDetails | ToolMcpConfirmationDetails | ToolInfoConfirmationDetails | ToolPlanConfirmationDetails;
+export interface ToolPlanConfirmationDetails {
+    type: 'plan';
+    title: string;
+    plan: string;
+    onConfirm: (outcome: ToolConfirmationOutcome) => Promise<void>;
+}
+export declare enum ToolConfirmationOutcome {
+    ProceedOnce = "proceed_once",
+    ProceedAlways = "proceed_always",
+    ProceedAlwaysServer = "proceed_always_server",
+    ProceedAlwaysTool = "proceed_always_tool",
+    ModifyWithEditor = "modify_with_editor",
+    Cancel = "cancel"
+}
+export declare enum Kind {
+    Read = "read",
+    Edit = "edit",
+    Delete = "delete",
+    Move = "move",
+    Search = "search",
+    Execute = "execute",
+    Think = "think",
+    Fetch = "fetch",
+    Other = "other"
+}
+export declare const MUTATOR_KINDS: Kind[];
+export interface ToolLocation {
+    path: string;
+    line?: number;
+}

package/dist/src/tools/tools.js

@@ -0,0 +1,258 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ToolErrorType } from './tool-error.js';
+import { SchemaValidator } from '../utils/schemaValidator.js';
+import {} from '../subagents/subagent-statistics.js';
+/**
+ * A convenience base class for ToolInvocation.
+ */
+export class BaseToolInvocation {
+    params;
+    constructor(params) {
+        this.params = params;
+    }
+    toolLocations() {
+        return [];
+    }
+    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;
+    constructor(name, displayName, description, kind, parameterSchema, isOutputMarkdown = true, canUpdateOutput = false) {
+        this.name = name;
+        this.displayName = displayName;
+        this.description = description;
+        this.kind = kind;
+        this.parameterSchema = parameterSchema;
+        this.isOutputMarkdown = isOutputMarkdown;
+        this.canUpdateOutput = canUpdateOutput;
+    }
+    get schema() {
+        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, shellExecutionConfig) {
+        const invocation = this.build(params);
+        return invocation.execute(signal, updateOutput, shellExecutionConfig);
+    }
+    /**
+     * 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.
+     * @params 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);
+    }
+    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 (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)) {
+                if (traverse(node[key], visitedRefs, pathRefs)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    return traverse(schema, new Set(), new Set());
+}
+export var ToolConfirmationOutcome;
+(function (ToolConfirmationOutcome) {
+    ToolConfirmationOutcome["ProceedOnce"] = "proceed_once";
+    ToolConfirmationOutcome["ProceedAlways"] = "proceed_always";
+    ToolConfirmationOutcome["ProceedAlwaysServer"] = "proceed_always_server";
+    ToolConfirmationOutcome["ProceedAlwaysTool"] = "proceed_always_tool";
+    ToolConfirmationOutcome["ModifyWithEditor"] = "modify_with_editor";
+    ToolConfirmationOutcome["Cancel"] = "cancel";
+})(ToolConfirmationOutcome || (ToolConfirmationOutcome = {}));
+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 = {}));
+// Function kinds that have side effects
+export const MUTATOR_KINDS = [
+    Kind.Edit,
+    Kind.Delete,
+    Kind.Move,
+    Kind.Execute,
+];
+//# 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/tools.test.d.ts

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