@agentscope-ai/agentscope 0.0.2

package/dist/tool/index.d.mts

@@ -0,0 +1,311 @@
+import { a as ToolResponse } from '../index-BTJDlKvQ.mjs';
+export { T as Tool } from '../index-BTJDlKvQ.mjs';
+export { T as Toolkit } from '../toolkit-CGEZSZPa.mjs';
+import { z } from 'zod';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '@modelcontextprotocol/sdk/client/sse.js';
+import '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import '@modelcontextprotocol/sdk/shared/protocol.js';
+import '../index-CAxQAkiP.mjs';
+import '../block-VsnHrllL.mjs';
+import '@modelcontextprotocol/sdk/client/stdio.js';
+
+/**
+ * Tool for executing bash commands in a shell environment.
+ * Intended for terminal operations such as git, npm, and docker.
+ * File operations should use the dedicated Read, Write, Edit, Glob, and Grep tools instead.
+ *
+ * @returns A Tool object for executing bash commands, with a call method that performs the execution and returns the output or error message.
+ */
+declare function Bash(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        command: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    /**
+     * Executes a bash command and returns its output.
+     *
+     * @param root0 - The parameters object
+     * @param root0.command - The bash command to execute
+     * @param root0.description - Optional description of what the command does
+     * @param root0.timeout - Optional timeout in milliseconds (default: 120000, max: 600000)
+     * @returns The stdout of the command, or an error message if the command fails
+     */
+    call({ command, description: _description, timeout, }: {
+        command: string;
+        description?: string;
+        timeout?: number;
+    }): Promise<ToolResponse>;
+};
+
+/**
+ * Tool for reading files from the local filesystem.
+ * Returns file contents with line numbers in cat -n format.
+ *
+ * @returns A Tool object for reading files, with a call method that performs the read operation and returns the formatted contents or a warning if the file is empty.
+ */
+declare function Read(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        file_path: z.ZodString;
+        offset: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    /**
+     * Reads a file and returns its contents with line numbers.
+     *
+     * @param root0 - The parameters object
+     * @param root0.file_path - Absolute path to the file to read
+     * @param root0.offset - Line number to start reading from (1-based)
+     * @param root0.limit - Maximum number of lines to read (capped at 2000)
+     * @returns The file contents formatted with line numbers, or a warning if the file is empty
+     * @throws If the path is not absolute, the file does not exist, or the path is a directory
+     */
+    call({ file_path, offset, limit, }: {
+        file_path: string;
+        offset?: number;
+        limit?: number;
+    }): ToolResponse;
+};
+
+/**
+ * Tool for writing files to the local filesystem.
+ * Creates parent directories as needed and overwrites existing files.
+ *
+ * @returns A Tool object for writing files, with a call method that performs the write operation.
+ */
+declare function Write(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        file_path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    /**
+     * Writes content to a file, creating parent directories if necessary.
+     *
+     * @param root0 - The parameters object
+     * @param root0.file_path - Absolute path to the file to write
+     * @param root0.content - The content to write to the file
+     * @returns A success message including the number of lines written
+     * @throws If the path is not absolute
+     */
+    call({ file_path, content }: {
+        file_path: string;
+        content: string;
+    }): string;
+};
+
+/**
+ * Tool for performing exact string replacements in files.
+ * Requires the file to have been read at least once before editing.
+ *
+ * @returns A Tool object with a call method that performs the edit operation based on the provided parameters, ensuring uniqueness of the old_string unless replace_all is true.
+ */
+declare function Edit(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        file_path: z.ZodString;
+        old_string: z.ZodString;
+        new_string: z.ZodString;
+        replace_all: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    /**
+     * Performs an exact string replacement in the specified file.
+     *
+     * @param root0 - The parameters object
+     * @param root0.file_path - Absolute path to the file to modify
+     * @param root0.old_string - The exact text to find and replace
+     * @param root0.new_string - The text to replace old_string with
+     * @param root0.replace_all - If true, replaces all occurrences; otherwise only the first
+     * @returns A success message indicating the file was updated
+     * @throws If the path is not absolute, file does not exist, strings are identical,
+     *         old_string is not found, or old_string is not unique and replace_all is false
+     */
+    call({ file_path, old_string, new_string, replace_all, }: {
+        file_path: string;
+        old_string: string;
+        new_string: string;
+        replace_all?: boolean;
+    }): string;
+};
+
+/**
+ * Tool for fast file pattern matching across a codebase.
+ * Supports glob patterns and returns results sorted by modification time.
+ *
+ * @returns A Tool object with a call method that performs glob matching based on the provided pattern and path.
+ */
+declare function Glob(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        pattern: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    /**
+     * Finds files matching a glob pattern under the given directory.
+     *
+     * @param root0 - The parameters object
+     * @param root0.pattern - The glob pattern to match files against
+     * @param root0.path - The base directory to search in; defaults to cwd
+     * @returns A newline-separated list of matching file paths sorted by modification time,
+     *          or a no-matches message if nothing is found
+     * @throws If the base directory does not exist
+     */
+    call({ pattern, path: searchPath }: {
+        pattern: string;
+        path?: string;
+    }): string;
+};
+
+type OutputMode = 'content' | 'files_with_matches' | 'count';
+/**
+ * Tool for searching file contents using regular expressions.
+ * Supports multiple output modes, file type filtering, and multiline matching.
+ *
+ * @returns A Tool object for performing regex searches across files, with a call method that executes the search and returns results based on the specified output mode.
+ */
+declare function Grep(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        pattern: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        glob: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        output_mode: z.ZodOptional<z.ZodEnum<{
+            content: "content";
+            files_with_matches: "files_with_matches";
+            count: "count";
+        }>>;
+        multiline: z.ZodOptional<z.ZodBoolean>;
+        case_insensitive: z.ZodOptional<z.ZodBoolean>;
+        context: z.ZodOptional<z.ZodNumber>;
+        head_limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    /**
+     * Searches files for a regex pattern and returns results in the specified output mode.
+     *
+     * @param root0 - The parameters object
+     * @param root0.pattern - The regular expression pattern to search for
+     * @param root0.path - File or directory to search in; defaults to cwd
+     * @param root0.glob - Glob pattern to filter which files are searched
+     * @param root0.type - File type shorthand (e.g. "ts", "py") to filter files
+     * @param root0.output_mode - How to format results: "content", "files_with_matches", or "count"
+     * @param root0.multiline - Whether the pattern can span multiple lines
+     * @param root0.case_insensitive - Whether the search is case-insensitive
+     * @param root0.context - Number of surrounding lines to include with each match
+     * @param root0.head_limit - Maximum number of result entries to return
+     * @returns A newline-separated string of results, or a no-matches message
+     */
+    call({ pattern, path: searchPath, glob, type, output_mode, multiline, case_insensitive, context, head_limit, }: {
+        pattern: string;
+        path?: string;
+        glob?: string;
+        type?: string;
+        output_mode?: OutputMode;
+        multiline?: boolean;
+        case_insensitive?: boolean;
+        context?: number;
+        head_limit?: number;
+    }): string;
+};
+
+type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'deleted';
+/**
+ * Tool for creating tasks
+ * @returns A Tool object for creating tasks
+ */
+declare function TaskCreate(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        subject: z.ZodString;
+        description: z.ZodString;
+        activeForm: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    call({ subject, description, activeForm, metadata, }: {
+        subject: string;
+        description: string;
+        activeForm?: string;
+        metadata?: Record<string, unknown>;
+    }): ToolResponse;
+};
+/**
+ * Tool for updating tasks
+ * @returns A Tool object for updating tasks
+ */
+declare function TaskUpdate(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        taskId: z.ZodString;
+        status: z.ZodOptional<z.ZodEnum<{
+            completed: "completed";
+            pending: "pending";
+            in_progress: "in_progress";
+            deleted: "deleted";
+        }>>;
+        subject: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        activeForm: z.ZodOptional<z.ZodString>;
+        owner: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        addBlocks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        addBlockedBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    call({ taskId, status, subject, description, activeForm, owner, metadata, addBlocks, addBlockedBy, }: {
+        taskId: string;
+        status?: TaskStatus;
+        subject?: string;
+        description?: string;
+        activeForm?: string;
+        owner?: string;
+        metadata?: Record<string, unknown>;
+        addBlocks?: string[];
+        addBlockedBy?: string[];
+    }): ToolResponse;
+};
+/**
+ * Tool for retrieving a single task
+ * @returns A Tool object for retrieving a task by ID
+ */
+declare function TaskGet(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        taskId: z.ZodString;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    call({ taskId }: {
+        taskId: string;
+    }): ToolResponse;
+};
+/**
+ * Tool for listing all active tasks
+ * @returns A Tool object for listing all active tasks
+ */
+declare function TaskList(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{}, z.core.$strip>;
+    requireUserConfirm: boolean;
+    call(): ToolResponse;
+};
+
+export { Bash, Edit, Glob, Grep, Read, TaskCreate, TaskGet, TaskList, TaskUpdate, ToolResponse, Write };

package/dist/tool/index.d.ts

@@ -0,0 +1,311 @@
+import { a as ToolResponse } from '../index-BcatlwXQ.js';
+export { T as Tool } from '../index-BcatlwXQ.js';
+export { T as Toolkit } from '../toolkit-CEpulFi0.js';
+import { z } from 'zod';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '@modelcontextprotocol/sdk/client/sse.js';
+import '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import '@modelcontextprotocol/sdk/shared/protocol.js';
+import '../index-CAxQAkiP.js';
+import '../block-VsnHrllL.js';
+import '@modelcontextprotocol/sdk/client/stdio.js';
+
+/**
+ * Tool for executing bash commands in a shell environment.
+ * Intended for terminal operations such as git, npm, and docker.
+ * File operations should use the dedicated Read, Write, Edit, Glob, and Grep tools instead.
+ *
+ * @returns A Tool object for executing bash commands, with a call method that performs the execution and returns the output or error message.
+ */
+declare function Bash(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        command: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    /**
+     * Executes a bash command and returns its output.
+     *
+     * @param root0 - The parameters object
+     * @param root0.command - The bash command to execute
+     * @param root0.description - Optional description of what the command does
+     * @param root0.timeout - Optional timeout in milliseconds (default: 120000, max: 600000)
+     * @returns The stdout of the command, or an error message if the command fails
+     */
+    call({ command, description: _description, timeout, }: {
+        command: string;
+        description?: string;
+        timeout?: number;
+    }): Promise<ToolResponse>;
+};
+
+/**
+ * Tool for reading files from the local filesystem.
+ * Returns file contents with line numbers in cat -n format.
+ *
+ * @returns A Tool object for reading files, with a call method that performs the read operation and returns the formatted contents or a warning if the file is empty.
+ */
+declare function Read(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        file_path: z.ZodString;
+        offset: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    /**
+     * Reads a file and returns its contents with line numbers.
+     *
+     * @param root0 - The parameters object
+     * @param root0.file_path - Absolute path to the file to read
+     * @param root0.offset - Line number to start reading from (1-based)
+     * @param root0.limit - Maximum number of lines to read (capped at 2000)
+     * @returns The file contents formatted with line numbers, or a warning if the file is empty
+     * @throws If the path is not absolute, the file does not exist, or the path is a directory
+     */
+    call({ file_path, offset, limit, }: {
+        file_path: string;
+        offset?: number;
+        limit?: number;
+    }): ToolResponse;
+};
+
+/**
+ * Tool for writing files to the local filesystem.
+ * Creates parent directories as needed and overwrites existing files.
+ *
+ * @returns A Tool object for writing files, with a call method that performs the write operation.
+ */
+declare function Write(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        file_path: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    /**
+     * Writes content to a file, creating parent directories if necessary.
+     *
+     * @param root0 - The parameters object
+     * @param root0.file_path - Absolute path to the file to write
+     * @param root0.content - The content to write to the file
+     * @returns A success message including the number of lines written
+     * @throws If the path is not absolute
+     */
+    call({ file_path, content }: {
+        file_path: string;
+        content: string;
+    }): string;
+};
+
+/**
+ * Tool for performing exact string replacements in files.
+ * Requires the file to have been read at least once before editing.
+ *
+ * @returns A Tool object with a call method that performs the edit operation based on the provided parameters, ensuring uniqueness of the old_string unless replace_all is true.
+ */
+declare function Edit(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        file_path: z.ZodString;
+        old_string: z.ZodString;
+        new_string: z.ZodString;
+        replace_all: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    /**
+     * Performs an exact string replacement in the specified file.
+     *
+     * @param root0 - The parameters object
+     * @param root0.file_path - Absolute path to the file to modify
+     * @param root0.old_string - The exact text to find and replace
+     * @param root0.new_string - The text to replace old_string with
+     * @param root0.replace_all - If true, replaces all occurrences; otherwise only the first
+     * @returns A success message indicating the file was updated
+     * @throws If the path is not absolute, file does not exist, strings are identical,
+     *         old_string is not found, or old_string is not unique and replace_all is false
+     */
+    call({ file_path, old_string, new_string, replace_all, }: {
+        file_path: string;
+        old_string: string;
+        new_string: string;
+        replace_all?: boolean;
+    }): string;
+};
+
+/**
+ * Tool for fast file pattern matching across a codebase.
+ * Supports glob patterns and returns results sorted by modification time.
+ *
+ * @returns A Tool object with a call method that performs glob matching based on the provided pattern and path.
+ */
+declare function Glob(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        pattern: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    /**
+     * Finds files matching a glob pattern under the given directory.
+     *
+     * @param root0 - The parameters object
+     * @param root0.pattern - The glob pattern to match files against
+     * @param root0.path - The base directory to search in; defaults to cwd
+     * @returns A newline-separated list of matching file paths sorted by modification time,
+     *          or a no-matches message if nothing is found
+     * @throws If the base directory does not exist
+     */
+    call({ pattern, path: searchPath }: {
+        pattern: string;
+        path?: string;
+    }): string;
+};
+
+type OutputMode = 'content' | 'files_with_matches' | 'count';
+/**
+ * Tool for searching file contents using regular expressions.
+ * Supports multiple output modes, file type filtering, and multiline matching.
+ *
+ * @returns A Tool object for performing regex searches across files, with a call method that executes the search and returns results based on the specified output mode.
+ */
+declare function Grep(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        pattern: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        glob: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        output_mode: z.ZodOptional<z.ZodEnum<{
+            content: "content";
+            files_with_matches: "files_with_matches";
+            count: "count";
+        }>>;
+        multiline: z.ZodOptional<z.ZodBoolean>;
+        case_insensitive: z.ZodOptional<z.ZodBoolean>;
+        context: z.ZodOptional<z.ZodNumber>;
+        head_limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    /**
+     * Searches files for a regex pattern and returns results in the specified output mode.
+     *
+     * @param root0 - The parameters object
+     * @param root0.pattern - The regular expression pattern to search for
+     * @param root0.path - File or directory to search in; defaults to cwd
+     * @param root0.glob - Glob pattern to filter which files are searched
+     * @param root0.type - File type shorthand (e.g. "ts", "py") to filter files
+     * @param root0.output_mode - How to format results: "content", "files_with_matches", or "count"
+     * @param root0.multiline - Whether the pattern can span multiple lines
+     * @param root0.case_insensitive - Whether the search is case-insensitive
+     * @param root0.context - Number of surrounding lines to include with each match
+     * @param root0.head_limit - Maximum number of result entries to return
+     * @returns A newline-separated string of results, or a no-matches message
+     */
+    call({ pattern, path: searchPath, glob, type, output_mode, multiline, case_insensitive, context, head_limit, }: {
+        pattern: string;
+        path?: string;
+        glob?: string;
+        type?: string;
+        output_mode?: OutputMode;
+        multiline?: boolean;
+        case_insensitive?: boolean;
+        context?: number;
+        head_limit?: number;
+    }): string;
+};
+
+type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'deleted';
+/**
+ * Tool for creating tasks
+ * @returns A Tool object for creating tasks
+ */
+declare function TaskCreate(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        subject: z.ZodString;
+        description: z.ZodString;
+        activeForm: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    call({ subject, description, activeForm, metadata, }: {
+        subject: string;
+        description: string;
+        activeForm?: string;
+        metadata?: Record<string, unknown>;
+    }): ToolResponse;
+};
+/**
+ * Tool for updating tasks
+ * @returns A Tool object for updating tasks
+ */
+declare function TaskUpdate(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        taskId: z.ZodString;
+        status: z.ZodOptional<z.ZodEnum<{
+            completed: "completed";
+            pending: "pending";
+            in_progress: "in_progress";
+            deleted: "deleted";
+        }>>;
+        subject: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        activeForm: z.ZodOptional<z.ZodString>;
+        owner: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        addBlocks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        addBlockedBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    call({ taskId, status, subject, description, activeForm, owner, metadata, addBlocks, addBlockedBy, }: {
+        taskId: string;
+        status?: TaskStatus;
+        subject?: string;
+        description?: string;
+        activeForm?: string;
+        owner?: string;
+        metadata?: Record<string, unknown>;
+        addBlocks?: string[];
+        addBlockedBy?: string[];
+    }): ToolResponse;
+};
+/**
+ * Tool for retrieving a single task
+ * @returns A Tool object for retrieving a task by ID
+ */
+declare function TaskGet(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        taskId: z.ZodString;
+    }, z.core.$strip>;
+    requireUserConfirm: boolean;
+    call({ taskId }: {
+        taskId: string;
+    }): ToolResponse;
+};
+/**
+ * Tool for listing all active tasks
+ * @returns A Tool object for listing all active tasks
+ */
+declare function TaskList(): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{}, z.core.$strip>;
+    requireUserConfirm: boolean;
+    call(): ToolResponse;
+};
+
+export { Bash, Edit, Glob, Grep, Read, TaskCreate, TaskGet, TaskList, TaskUpdate, ToolResponse, Write };