ai-code-agents 0.1.0-beta.1

package/dist/index.d.ts

@@ -0,0 +1,1260 @@
+import { FlexibleSchema, Tool } from '@ai-sdk/provider-utils';
+import { ToolCallOptions, Experimental_AgentSettings, Experimental_Agent } from 'ai';
+import * as z from 'zod';
+import { z as z$1 } from 'zod';
+
+declare const ReadFileResult: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>;
+type ReadFileResult = z.infer<typeof ReadFileResult>;
+declare const WriteFileResult: z.ZodObject<{
+    path: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;
+type WriteFileResult = z.infer<typeof WriteFileResult>;
+declare const DeleteFileResult: z.ZodObject<{
+    path: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;
+type DeleteFileResult = z.infer<typeof DeleteFileResult>;
+declare const MoveFileResult: z.ZodObject<{
+    sourcePath: z.ZodString;
+    destinationPath: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;
+type MoveFileResult = z.infer<typeof MoveFileResult>;
+declare const CopyFileResult: z.ZodObject<{
+    sourcePath: z.ZodString;
+    destinationPath: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strip>;
+type CopyFileResult = z.infer<typeof CopyFileResult>;
+declare const RunCommandResult: z.ZodObject<{
+    command: z.ZodString;
+    exitCode: z.ZodNumber;
+    stdout: z.ZodString;
+    stderr: z.ZodString;
+}, z.core.$strip>;
+type RunCommandResult = z.infer<typeof RunCommandResult>;
+interface FilesystemEnvironmentInterface {
+    get name(): string;
+    readFile(path: string): Promise<ReadFileResult>;
+    writeFile(path: string, content: string): Promise<WriteFileResult>;
+    deleteFile(path: string): Promise<DeleteFileResult>;
+    moveFile(sourcePath: string, destinationPath: string): Promise<MoveFileResult>;
+    copyFile(sourcePath: string, destinationPath: string): Promise<CopyFileResult>;
+}
+interface CommandLineEnvironmentInterface extends FilesystemEnvironmentInterface {
+    runCommand(command: string): Promise<RunCommandResult>;
+}
+type Environment = FilesystemEnvironmentInterface | CommandLineEnvironmentInterface;
+type ModelTextResult = {
+    type: 'text';
+    value: string;
+};
+type ModelTextPart = {
+    type: 'text';
+    text: string;
+};
+type ModelMediaPart = {
+    type: 'media';
+    data: string;
+    mediaType: string;
+};
+type ModelFormattedToolResult = ModelTextResult | {
+    type: 'content';
+    value: Array<ModelTextPart | ModelMediaPart>;
+};
+type ToolExample<ToolInputType, ToolOutputType> = {
+    input: ToolInputType;
+    output: ToolOutputType | string;
+};
+interface ToolInterface<ToolInputType, ToolOutputType> {
+    get name(): string;
+    get description(): string;
+    get inputSchema(): FlexibleSchema<ToolInputType>;
+    get outputSchema(): FlexibleSchema<ToolOutputType>;
+    execute(input: ToolInputType, options: ToolCallOptions): Promise<ToolOutputType>;
+    toModelOutput(output: ToolOutputType): ModelFormattedToolResult;
+    get examples(): Array<ToolExample<ToolInputType, ToolOutputType>>;
+    get needsApproval(): boolean;
+}
+interface EnvironmentToolInterface<ToolInputType, ToolOutputType, EnvironmentType> extends ToolInterface<ToolInputType, ToolOutputType> {
+    get environment(): EnvironmentType;
+}
+type ToolConfig = {
+    name?: string;
+    description?: string;
+    needsApproval?: boolean;
+};
+
+/**
+ * Base class for a filesystem-based execution environment.
+ */
+declare abstract class FilesystemEnvironmentBase<EnvironmentConfig> implements FilesystemEnvironmentInterface {
+    protected _envConfig: EnvironmentConfig;
+    /**
+     * Constructs a new environment instance.
+     *
+     * @param config - Environment configuration.
+     */
+    constructor(config: EnvironmentConfig);
+    /**
+     * Gets the environment name.
+     *
+     * @returns The environment name.
+     */
+    abstract get name(): string;
+    /**
+     * Reads the content of a file at the specified path.
+     *
+     * @param path - The path to the file to read, relative to the project directory.
+     * @returns A promise that resolves to a ReadFileResult.
+     */
+    readFile(path: string): Promise<ReadFileResult>;
+    /**
+     * Writes content to a file at the specified path.
+     *
+     * If a file is already present at the path, it will be overwritten.
+     *
+     * @param path - The path to the file to write, relative to the project directory.
+     * @param content - The content to write to the file.
+     * @returns A promise that resolves to a WriteFileResult.
+     */
+    writeFile(path: string, content: string): Promise<WriteFileResult>;
+    /**
+     * Deletes a file at the specified path.
+     *
+     * @param path - The path to the file to delete, relative to the project directory.
+     * @returns A promise that resolves to a DeleteFileResult.
+     */
+    deleteFile(path: string): Promise<DeleteFileResult>;
+    /**
+     * Moves a file from a source path to a destination path.
+     *
+     * If a file is already present at the destination path, it will be overwritten.
+     *
+     * @param sourcePath - The path to the file to move.
+     * @param destinationPath - The path to move the file to.
+     * @returns A promise that resolves to a MoveFileResult.
+     */
+    moveFile(sourcePath: string, destinationPath: string): Promise<MoveFileResult>;
+    /**
+     * Copies a file from a source path to a destination path.
+     *
+     * If a file is already present at the destination path, it will be overwritten.
+     *
+     * @param sourcePath - The path to the file to copy.
+     * @param destinationPath - The path to copy the file to.
+     * @returns A promise that resolves to a CopyFileResult.
+     */
+    copyFile(sourcePath: string, destinationPath: string): Promise<CopyFileResult>;
+    /**
+     * Checks whether a file exists at the specified path relative to the project directory.
+     *
+     * @param relativePath - The path to the file to check, relative to the project directory.
+     * @returns True if the file exists, false otherwise.
+     */
+    protected abstract fileExists(relativePath: string): Promise<boolean>;
+    /**
+     * Gets the content of a file at the specified path, relative to the project directory.
+     *
+     * When this method is called, it is guaranteed that the file exists.
+     *
+     * @param relativePath - The path to the file to read, relative to the project directory.
+     * @returns The content of the file.
+     */
+    protected abstract readFileContent(relativePath: string): Promise<string>;
+    /**
+     * Writes content to a file at the specified path, relative to the project directory.
+     *
+     * This method unconditionally writes the content, even if a file already exists at the path, or if the file is new.
+     *
+     * @param relativePath - The path to the file to write, relative to the project directory.
+     * @param content - The content to write to the file.
+     */
+    protected abstract writeFileContent(relativePath: string, content: string): Promise<void>;
+    /**
+     * Deletes a file at the specified path, relative to the project directory.
+     *
+     * When this method is called, it is guaranteed that the file exists.
+     *
+     * @param relativePath - The path to the file to delete, relative to the project directory.
+     */
+    protected abstract deleteFileContent(relativePath: string): Promise<void>;
+    /**
+     * Moves the content of a file from a source path to a destination path, relative to the project directory.
+     *
+     * When this method is called, it is guaranteed that the source file exists.
+     * This method unconditionally moves the content, even if a file already exists at the destination path.
+     *
+     * @param relativeSourcePath - The path to the file to move, relative to the project directory.
+     * @param relativeDestinationPath - The path to move the file to, relative to the project directory.
+     */
+    protected moveFileContent(relativeSourcePath: string, relativeDestinationPath: string): Promise<void>;
+    /**
+     * Copies the content of a file from a source path to a destination path, relative to the project directory.
+     *
+     * When this method is called, it is guaranteed that the source file exists.
+     * This method unconditionally copies the content, even if a file already exists at the destination path.
+     *
+     * @param relativeSourcePath - The path to the file to copy, relative to the project directory.
+     * @param relativeDestinationPath - The path to copy the file to, relative to the project directory.
+     */
+    protected copyFileContent(relativeSourcePath: string, relativeDestinationPath: string): Promise<void>;
+}
+
+/**
+ * Base class for a command-line based execution environment.
+ */
+declare abstract class CommandLineEnvironmentBase<EnvironmentConfig> extends FilesystemEnvironmentBase<EnvironmentConfig> implements CommandLineEnvironmentInterface {
+    /**
+     * Runs a CLI command in environment.
+     *
+     * @param command - The command to run.
+     * @returns A promise that resolves to a RunCommandResult.
+     */
+    runCommand(command: string): Promise<RunCommandResult>;
+    /**
+     * Executes a command in the environment and returns the exit code, stdout, and stderr.
+     *
+     * @param command - The command to execute.
+     * @returns A promise that resolves to a tuple containing the exit code, stdout, and stderr.
+     */
+    protected abstract executeCommand(command: string): Promise<[number, string, string]>;
+}
+
+/**
+ * Base class for a Unix-like command line execution environment.
+ */
+declare abstract class UnixEnvironmentBase<EnvironmentConfig> extends CommandLineEnvironmentBase<EnvironmentConfig> {
+    /**
+     * Checks whether a file exists at the specified path relative to the project directory.
+     *
+     * @param relativePath - The path to the file to check, relative to the project directory.
+     * @returns True if the file exists, false otherwise.
+     */
+    protected fileExists(relativePath: string): Promise<boolean>;
+    /**
+     * Gets the content of a file at the specified path, relative to the project directory.
+     *
+     * When this method is called, it is guaranteed that the file exists.
+     *
+     * @param relativePath - The path to the file to read, relative to the project directory.
+     * @returns The content of the file.
+     */
+    protected readFileContent(relativePath: string): Promise<string>;
+    /**
+     * Writes content to a file at the specified path, relative to the project directory.
+     *
+     * This method unconditionally writes the content, even if a file already exists at the path, or if the file is new.
+     *
+     * @param relativePath - The path to the file to write, relative to the project directory.
+     * @param content - The content to write to the file.
+     */
+    protected writeFileContent(relativePath: string, content: string): Promise<void>;
+    /**
+     * Deletes a file at the specified path, relative to the project directory.
+     *
+     * When this method is called, it is guaranteed that the file exists.
+     *
+     * @param relativePath - The path to the file to delete, relative to the project directory.
+     */
+    protected deleteFileContent(relativePath: string): Promise<void>;
+    /**
+     * Moves the content of a file from a source path to a destination path, relative to the project directory.
+     *
+     * When this method is called, it is guaranteed that the source file exists.
+     * This method unconditionally moves the content, even if a file already exists at the destination path.
+     *
+     * @param relativeSourcePath - The path to the file to move, relative to the project directory.
+     * @param relativeDestinationPath - The path to move the file to, relative to the project directory.
+     */
+    protected moveFileContent(relativeSourcePath: string, relativeDestinationPath: string): Promise<void>;
+    /**
+     * Copies the content of a file from a source path to a destination path, relative to the project directory.
+     *
+     * When this method is called, it is guaranteed that the source file exists.
+     * This method unconditionally copies the content, even if a file already exists at the destination path.
+     *
+     * @param relativeSourcePath - The path to the file to copy, relative to the project directory.
+     * @param relativeDestinationPath - The path to copy the file to, relative to the project directory.
+     */
+    protected copyFileContent(relativeSourcePath: string, relativeDestinationPath: string): Promise<void>;
+}
+
+type DockerEnvironmentConfig = {
+    containerId: string;
+    directoryPath?: string;
+};
+declare const DockerEnvironmentName = "docker";
+/**
+ * A Docker-based execution environment that interacts with a specified Docker container.
+ */
+declare class DockerEnvironment extends UnixEnvironmentBase<DockerEnvironmentConfig> {
+    protected readonly _commandPrefix: string;
+    /**
+     * Constructs a new environment instance.
+     *
+     * @param config - Environment configuration.
+     */
+    constructor(config: DockerEnvironmentConfig);
+    /**
+     * Gets the environment name.
+     *
+     * @returns The environment name.
+     */
+    get name(): string;
+    /**
+     * Executes a command in the environment and returns the exit code, stdout, and stderr.
+     *
+     * @param command - The command to execute.
+     * @returns A promise that resolves to a tuple containing the exit code, stdout, and stderr.
+     */
+    protected executeCommand(command: string): Promise<[number, string, string]>;
+}
+
+type MockFilesystemEnvironmentConfig = {
+    initialFiles?: Map<string, string>;
+    directoryPath?: string;
+};
+declare const MockFilesystemEnvironmentName = "mock-filesystem";
+/**
+ * An in-memory execution environment that simulates a filesystem.
+ *
+ * This environment is useful for testing purposes where you want to control the
+ * filesystem state without interacting with the actual disk.
+ */
+declare class MockFilesystemEnvironment extends FilesystemEnvironmentBase<MockFilesystemEnvironmentConfig> {
+    protected readonly files: Map<string, string>;
+    protected readonly _preparePath: (filePath: string) => string;
+    /**
+     * Constructs a new environment instance.
+     *
+     * @param config - Environment configuration.
+     */
+    constructor(config?: MockFilesystemEnvironmentConfig);
+    /**
+     * Gets the environment name.
+     *
+     * @returns The environment name.
+     */
+    get name(): string;
+    /**
+     * Checks whether a file exists at the specified path relative to the project directory.
+     *
+     * @param relativePath - The path to the file to check, relative to the project directory.
+     * @returns True if the file exists, false otherwise.
+     */
+    protected fileExists(relativePath: string): Promise<boolean>;
+    /**
+     * Gets the content of a file at the specified path, relative to the project directory.
+     *
+     * When this method is called, it is guaranteed that the file exists.
+     *
+     * @param relativePath - The path to the file to read, relative to the project directory.
+     * @returns The content of the file.
+     */
+    protected readFileContent(relativePath: string): Promise<string>;
+    /**
+     * Writes content to a file at the specified path, relative to the project directory.
+     *
+     * This method unconditionally writes the content, even if a file already exists at the path, or if the file is new.
+     *
+     * @param relativePath - The path to the file to write, relative to the project directory.
+     * @param content - The content to write to the file.
+     */
+    protected writeFileContent(relativePath: string, content: string): Promise<void>;
+    /**
+     * Deletes a file at the specified path, relative to the project directory.
+     *
+     * @param relativePath - The path to the file to delete, relative to the project directory.
+     */
+    protected deleteFileContent(relativePath: string): Promise<void>;
+}
+
+type NodeFilesystemEnvironmentConfig = {
+    directoryPath: string;
+};
+declare const NodeFilesystemEnvironmentName = "node-filesystem";
+/**
+ * A Node.js filesystem-based execution environment.
+ *
+ * This environment uses Node.js fs/promises APIs to provide filesystem operations
+ * within a specified directory path. All relative file paths are resolved relative
+ * to the configured directoryPath.
+ */
+declare class NodeFilesystemEnvironment extends FilesystemEnvironmentBase<NodeFilesystemEnvironmentConfig> {
+    /**
+     * Constructs a new NodeFilesystemEnvironment instance.
+     *
+     * @param config - Environment configuration including the mandatory directoryPath.
+     */
+    constructor(config: NodeFilesystemEnvironmentConfig);
+    /**
+     * Gets the environment name.
+     *
+     * @returns The environment name.
+     */
+    get name(): string;
+    /**
+     * Checks whether a file exists at the specified path relative to the project directory.
+     *
+     * @param relativePath - The path to the file to check, relative to the project directory.
+     * @returns True if the file exists, false otherwise.
+     */
+    protected fileExists(relativePath: string): Promise<boolean>;
+    /**
+     * Gets the content of a file at the specified path, relative to the project directory.
+     *
+     * When this method is called, it is guaranteed that the file exists.
+     *
+     * @param relativePath - The path to the file to read, relative to the project directory.
+     * @returns The content of the file.
+     */
+    protected readFileContent(relativePath: string): Promise<string>;
+    /**
+     * Writes content to a file at the specified path, relative to the project directory.
+     *
+     * This method unconditionally writes the content, even if a file already exists at the path, or if the file is new.
+     *
+     * @param relativePath - The path to the file to write, relative to the project directory.
+     * @param content - The content to write to the file.
+     */
+    protected writeFileContent(relativePath: string, content: string): Promise<void>;
+    /**
+     * Deletes a file at the specified path, relative to the project directory.
+     *
+     * When this method is called, it is guaranteed that the file exists.
+     *
+     * @param relativePath - The path to the file to delete, relative to the project directory.
+     */
+    protected deleteFileContent(relativePath: string): Promise<void>;
+    /**
+     * Moves the content of a file from a source path to a destination path, relative to the project directory.
+     *
+     * When this method is called, it is guaranteed that the source file exists.
+     * This method unconditionally moves the content, even if a file already exists at the destination path.
+     *
+     * @param relativeSourcePath - The path to the file to move, relative to the project directory.
+     * @param relativeDestinationPath - The path to move the file to, relative to the project directory.
+     */
+    protected moveFileContent(relativeSourcePath: string, relativeDestinationPath: string): Promise<void>;
+}
+
+type UnsafeLocalEnvironmentConfig = {
+    directoryPath: string;
+};
+declare const UnsafeLocalEnvironmentName = "unsafe-local";
+/**
+ * A local command line execution environment in a specific directory, without any safety mechanisms.
+ *
+ * WARNING: This environment is unsafe because it allows unrestricted access to
+ * the local file system and command line. It should only be used in controlled
+ * environments where security is not a concern.
+ */
+declare class UnsafeLocalEnvironment extends UnixEnvironmentBase<UnsafeLocalEnvironmentConfig> {
+    protected readonly _commandPrefix: string;
+    /**
+     * Constructs a new environment instance.
+     *
+     * @param config - Environment configuration.
+     */
+    constructor(config: UnsafeLocalEnvironmentConfig);
+    /**
+     * Gets the environment name.
+     *
+     * @returns The environment name.
+     */
+    get name(): string;
+    /**
+     * Executes a command in the environment and returns the exit code, stdout, and stderr.
+     *
+     * @param command - The command to execute.
+     * @returns A promise that resolves to a tuple containing the exit code, stdout, and stderr.
+     */
+    protected executeCommand(command: string): Promise<[number, string, string]>;
+}
+
+type FlexibleInputSchema<T> = ToolInterface<T, unknown>['inputSchema'];
+type FlexibleOutputSchema<T> = ToolInterface<unknown, T>['outputSchema'];
+type ToolMetadata<ToolInputType, ToolOutputType> = {
+    name: string;
+    description: string;
+    inputSchema: FlexibleInputSchema<ToolInputType>;
+    outputSchema: FlexibleOutputSchema<ToolOutputType>;
+    needsApproval: boolean;
+};
+/**
+ * Base class for a tool.
+ */
+declare abstract class ToolBase<ToolConfig extends ToolConfig, ToolInputType, ToolOutputType> implements ToolInterface<ToolInputType, ToolOutputType> {
+    readonly _toolConfig: ToolConfig;
+    protected readonly _name: string;
+    protected readonly _description: string;
+    protected readonly _inputSchema: FlexibleInputSchema<ToolInputType>;
+    protected readonly _outputSchema: FlexibleOutputSchema<ToolOutputType>;
+    protected readonly _needsApproval: boolean;
+    /**
+     * Constructs a new tool instance.
+     *
+     * @param toolConfig - Optional tool config, can be used to override some defaults.
+     */
+    constructor(toolConfig?: ToolConfig);
+    /**
+     * Gets the tool name.
+     *
+     * @returns The tool name.
+     */
+    get name(): string;
+    /**
+     * Gets the tool description.
+     *
+     * @returns The tool description.
+     */
+    get description(): string;
+    /**
+     * Gets the input schema for the tool.
+     *
+     * @returns The input schema.
+     */
+    get inputSchema(): FlexibleInputSchema<ToolInputType>;
+    /**
+     * Gets the input schema for the tool.
+     *
+     * @returns The input schema.
+     */
+    get outputSchema(): FlexibleInputSchema<ToolOutputType>;
+    /**
+     * Gets whether the tool needs approval before use.
+     *
+     * @returns True if the tool needs approval, false otherwise.
+     */
+    get needsApproval(): boolean;
+    /**
+     * Gets the examples for the tool.
+     *
+     * @returns The tool examples.
+     */
+    abstract get examples(): Array<ToolExample<ToolInputType, ToolOutputType>>;
+    /**
+     * Executes the tool with the given input.
+     *
+     * @param input - The input for the tool.
+     * @param options - Options from the tool call.
+     * @returns A promise that resolves to the tool execution result.
+     */
+    abstract execute(input: ToolInputType, options: ToolCallOptions): Promise<ToolOutputType>;
+    /**
+     * Converts the tool output to a format suitable for model consumption.
+     *
+     * @param output - The output from the tool execution.
+     * @returns The formatted tool result.
+     */
+    abstract toModelOutput(output: ToolOutputType): ModelFormattedToolResult;
+    /**
+     * Returns the metadata for the tool.
+     *
+     * The name, description, and needsApproval properties are defaults which can be overridden in the constructor.
+     *
+     * @returns The tool metadata.
+     */
+    protected abstract getMetadata(): ToolMetadata<ToolInputType, ToolOutputType>;
+}
+
+type EnvironmentToolMetadata<ToolInputType, ToolOutputType> = ToolMetadata<ToolInputType, ToolOutputType>;
+/**
+ * Base class for an execution environment tool.
+ */
+declare abstract class EnvironmentToolBase<ToolConfig extends ToolConfig, ToolInputType, ToolOutputType, EnvironmentType> extends ToolBase<ToolConfig, ToolInputType, ToolOutputType> implements EnvironmentToolInterface<ToolInputType, ToolOutputType, EnvironmentType> {
+    protected readonly _environment: EnvironmentType;
+    /**
+     * Constructs a new `EnvironmentToolBase` instance.
+     *
+     * @param environment - The execution environment to apply the tool in.
+     * @param toolConfig - Optional tool config, can be used to override some defaults.
+     */
+    constructor(environment: EnvironmentType, toolConfig?: ToolConfig);
+    /**
+     * Gets the current execution environment for the tool.
+     *
+     * @returns The current execution environment.
+     */
+    get environment(): EnvironmentType;
+    /**
+     * Executes the tool with the given input.
+     *
+     * @param input - The input for the tool.
+     * @param _options - Options from the tool call.
+     * @returns A promise that resolves to the tool execution result.
+     */
+    execute(input: ToolInputType, _options: ToolCallOptions): Promise<ToolOutputType>;
+    /**
+     * Returns the metadata for the tool.
+     *
+     * The name, description, and needsApproval properties are defaults which can be overridden in the constructor.
+     *
+     * @returns The tool metadata.
+     */
+    protected abstract getMetadata(): EnvironmentToolMetadata<ToolInputType, ToolOutputType>;
+    /**
+     * Executes the tool in the given execution environment with the given input.
+     *
+     * @param env - The execution environment to use.
+     * @param input - The input for the tool.
+     * @returns A promise that resolves to the tool execution result.
+     */
+    protected abstract executeForEnvironment(env: EnvironmentType, input: ToolInputType): Promise<ToolOutputType>;
+}
+
+declare const CopyFileToolName = "copy_file";
+type CopyFileToolConfig = ToolConfig;
+declare const CopyFileToolInput: z$1.ZodObject<{
+    sourcePath: z$1.ZodString;
+    destinationPath: z$1.ZodString;
+}, z$1.core.$strip>;
+type CopyFileToolInput = z$1.infer<typeof CopyFileToolInput>;
+declare const CopyFileToolOutput: z$1.ZodObject<{
+    sourcePath: z$1.ZodString;
+    destinationPath: z$1.ZodString;
+    message: z$1.ZodString;
+}, z$1.core.$strip>;
+type CopyFileToolOutput = z$1.infer<typeof CopyFileToolOutput>;
+/**
+ * Class for the CopyFile tool.
+ */
+declare class CopyFileTool extends EnvironmentToolBase<CopyFileToolConfig, CopyFileToolInput, CopyFileToolOutput, FilesystemEnvironmentInterface> {
+    /**
+     * Returns the metadata for the tool.
+     *
+     * The name, description, and needsApproval properties are defaults which can be overridden in the constructor.
+     *
+     * @returns The tool metadata.
+     */
+    protected getMetadata(): EnvironmentToolMetadata<CopyFileToolInput, CopyFileToolOutput>;
+    /**
+     * Executes the tool in the given execution environment with the given input.
+     *
+     * @param env - The execution environment to use.
+     * @param input - The input for the tool.
+     * @returns A promise that resolves to the tool execution result.
+     */
+    protected executeForEnvironment(env: FilesystemEnvironmentInterface, input: CopyFileToolInput): Promise<CopyFileToolOutput>;
+    /**
+     * Converts the tool output to a format suitable for model consumption.
+     *
+     * @param output - The output from the tool execution.
+     * @returns The formatted tool result.
+     */
+    toModelOutput(output: CopyFileToolOutput): ModelFormattedToolResult;
+    /**
+     * Gets the examples for the tool.
+     *
+     * @returns The tool examples.
+     */
+    get examples(): Array<ToolExample<CopyFileToolInput, CopyFileToolOutput>>;
+}
+
+declare const DeleteFileToolName = "delete_file";
+type DeleteFileToolConfig = ToolConfig;
+declare const DeleteFileToolInput: z$1.ZodObject<{
+    path: z$1.ZodString;
+}, z$1.core.$strip>;
+type DeleteFileToolInput = z$1.infer<typeof DeleteFileToolInput>;
+declare const DeleteFileToolOutput: z$1.ZodObject<{
+    path: z$1.ZodString;
+    message: z$1.ZodString;
+}, z$1.core.$strip>;
+type DeleteFileToolOutput = z$1.infer<typeof DeleteFileToolOutput>;
+/**
+ * Class for the DeleteFile tool.
+ */
+declare class DeleteFileTool extends EnvironmentToolBase<DeleteFileToolConfig, DeleteFileToolInput, DeleteFileToolOutput, FilesystemEnvironmentInterface> {
+    /**
+     * Returns the metadata for the tool.
+     *
+     * The name, description, and needsApproval properties are defaults which can be overridden in the constructor.
+     *
+     * @returns The tool metadata.
+     */
+    protected getMetadata(): EnvironmentToolMetadata<DeleteFileToolInput, DeleteFileToolOutput>;
+    /**
+     * Executes the tool in the given execution environment with the given input.
+     *
+     * @param env - The execution environment to use.
+     * @param input - The input for the tool.
+     * @returns A promise that resolves to the tool execution result.
+     */
+    protected executeForEnvironment(env: FilesystemEnvironmentInterface, input: DeleteFileToolInput): Promise<DeleteFileToolOutput>;
+    /**
+     * Converts the tool output to a format suitable for model consumption.
+     *
+     * @param output - The output from the tool execution.
+     * @returns The formatted tool result.
+     */
+    toModelOutput(output: DeleteFileToolOutput): ModelFormattedToolResult;
+    /**
+     * Gets the examples for the tool.
+     *
+     * @returns The tool examples.
+     */
+    get examples(): Array<ToolExample<DeleteFileToolInput, DeleteFileToolOutput>>;
+}
+
+declare const EditFileToolName = "edit_file";
+type EditFileToolConfig = ToolConfig;
+declare const EditFileToolInput: z$1.ZodObject<{
+    path: z$1.ZodString;
+    oldString: z$1.ZodString;
+    newString: z$1.ZodString;
+    replaceAll: z$1.ZodOptional<z$1.ZodBoolean>;
+}, z$1.core.$strip>;
+type EditFileToolInput = z$1.infer<typeof EditFileToolInput>;
+declare const EditFileToolOutput: z$1.ZodObject<{
+    path: z$1.ZodString;
+    oldString: z$1.ZodString;
+    newString: z$1.ZodString;
+    replacements: z$1.ZodNumber;
+    message: z$1.ZodString;
+}, z$1.core.$strip>;
+type EditFileToolOutput = z$1.infer<typeof EditFileToolOutput>;
+/**
+ * Class for the EditFile tool.
+ */
+declare class EditFileTool extends EnvironmentToolBase<EditFileToolConfig, EditFileToolInput, EditFileToolOutput, FilesystemEnvironmentInterface> {
+    /**
+     * Returns the metadata for the tool.
+     *
+     * The name, description, and needsApproval properties are defaults which can be overridden in the constructor.
+     *
+     * @returns The tool metadata.
+     */
+    protected getMetadata(): EnvironmentToolMetadata<EditFileToolInput, EditFileToolOutput>;
+    /**
+     * Executes the tool in the given execution environment with the given input.
+     *
+     * @param env - The execution environment to use.
+     * @param input - The input for the tool.
+     * @returns A promise that resolves to the tool execution result.
+     */
+    protected executeForEnvironment(env: FilesystemEnvironmentInterface, input: EditFileToolInput): Promise<EditFileToolOutput>;
+    /**
+     * Converts the tool output to a format suitable for model consumption.
+     *
+     * @param output - The output from the tool execution.
+     * @returns The formatted tool result.
+     */
+    toModelOutput(output: EditFileToolOutput): ModelFormattedToolResult;
+    /**
+     * Gets the examples for the tool.
+     *
+     * @returns The tool examples.
+     */
+    get examples(): Array<ToolExample<EditFileToolInput, EditFileToolOutput>>;
+}
+
+declare const GetProjectFileStructureToolName = "get_project_file_structure";
+type GetProjectFileStructureToolConfig = ToolConfig;
+declare const GetProjectFileStructureToolInput: z$1.ZodObject<{
+    path: z$1.ZodOptional<z$1.ZodString>;
+    excludeGitIgnored: z$1.ZodOptional<z$1.ZodBoolean>;
+}, z$1.core.$strip>;
+type GetProjectFileStructureToolInput = z$1.infer<typeof GetProjectFileStructureToolInput>;
+declare const GetProjectFileStructureToolOutput: z$1.ZodObject<{
+    files: z$1.ZodArray<z$1.ZodString>;
+    excludeGitIgnored: z$1.ZodBoolean;
+}, z$1.core.$strip>;
+type GetProjectFileStructureToolOutput = z$1.infer<typeof GetProjectFileStructureToolOutput>;
+/**
+ * Class for the GetProjectFileStructure tool.
+ */
+declare class GetProjectFileStructureTool extends EnvironmentToolBase<GetProjectFileStructureToolConfig, GetProjectFileStructureToolInput, GetProjectFileStructureToolOutput, CommandLineEnvironmentInterface> {
+    /**
+     * Returns the metadata for the tool.
+     *
+     * The name, description, and needsApproval properties are defaults which can be overridden in the constructor.
+     *
+     * @returns The tool metadata.
+     */
+    protected getMetadata(): EnvironmentToolMetadata<GetProjectFileStructureToolInput, GetProjectFileStructureToolOutput>;
+    /**
+     * Executes the tool in the given execution environment with the given input.
+     *
+     * @param env - The execution environment to use.
+     * @param input - The input for the tool.
+     * @returns A promise that resolves to the tool execution result.
+     */
+    protected executeForEnvironment(env: CommandLineEnvironmentInterface, input: GetProjectFileStructureToolInput): Promise<GetProjectFileStructureToolOutput>;
+    /**
+     * Converts the tool output to a format suitable for model consumption.
+     *
+     * @param output - The output from the tool execution.
+     * @returns The formatted tool result.
+     */
+    toModelOutput(output: GetProjectFileStructureToolOutput): ModelFormattedToolResult;
+    /**
+     * Gets the examples for the tool.
+     *
+     * @returns The tool examples.
+     */
+    get examples(): Array<ToolExample<GetProjectFileStructureToolInput, GetProjectFileStructureToolOutput>>;
+}
+
+declare const GlobToolName = "glob";
+type GlobToolConfig = ToolConfig;
+declare const GlobToolInput: z$1.ZodObject<{
+    searchPattern: z$1.ZodString;
+    searchPath: z$1.ZodOptional<z$1.ZodString>;
+    excludeGitIgnored: z$1.ZodOptional<z$1.ZodBoolean>;
+}, z$1.core.$strip>;
+type GlobToolInput = z$1.infer<typeof GlobToolInput>;
+declare const GlobToolOutput: z$1.ZodObject<{
+    searchPattern: z$1.ZodString;
+    searchPath: z$1.ZodString;
+    excludeGitIgnored: z$1.ZodBoolean;
+    matchingPaths: z$1.ZodArray<z$1.ZodString>;
+}, z$1.core.$strip>;
+type GlobToolOutput = z$1.infer<typeof GlobToolOutput>;
+/**
+ * Class for the Glob tool.
+ */
+declare class GlobTool extends EnvironmentToolBase<GlobToolConfig, GlobToolInput, GlobToolOutput, CommandLineEnvironmentInterface> {
+    /**
+     * Returns the metadata for the tool.
+     *
+     * The name, description, and needsApproval properties are defaults which can be overridden in the constructor.
+     *
+     * @returns The tool metadata.
+     */
+    protected getMetadata(): EnvironmentToolMetadata<GlobToolInput, GlobToolOutput>;
+    /**
+     * Executes the tool in the given execution environment with the given input.
+     *
+     * @param env - The execution environment to use.
+     * @param input - The input for the tool.
+     * @returns A promise that resolves to the tool execution result.
+     */
+    protected executeForEnvironment(env: CommandLineEnvironmentInterface, input: GlobToolInput): Promise<GlobToolOutput>;
+    /**
+     * Converts the tool output to a format suitable for model consumption.
+     *
+     * @param output - The output from the tool execution.
+     * @returns The formatted tool result.
+     */
+    toModelOutput(output: GlobToolOutput): ModelFormattedToolResult;
+    /**
+     * Gets the examples for the tool.
+     *
+     * @returns The tool examples.
+     */
+    get examples(): Array<ToolExample<GlobToolInput, GlobToolOutput>>;
+}
+
+declare const ListDirectoryToolName = "list_directory";
+type ListDirectoryToolConfig = ToolConfig;
+declare const ListDirectoryToolInput: z$1.ZodObject<{
+    path: z$1.ZodString;
+}, z$1.core.$strip>;
+type ListDirectoryToolInput = z$1.infer<typeof ListDirectoryToolInput>;
+declare const ListDirectoryToolOutput: z$1.ZodObject<{
+    path: z$1.ZodString;
+    files: z$1.ZodArray<z$1.ZodString>;
+    directories: z$1.ZodArray<z$1.ZodString>;
+}, z$1.core.$strip>;
+type ListDirectoryToolOutput = z$1.infer<typeof ListDirectoryToolOutput>;
+/**
+ * Class for the ListDirectory tool.
+ */
+declare class ListDirectoryTool extends EnvironmentToolBase<ListDirectoryToolConfig, ListDirectoryToolInput, ListDirectoryToolOutput, CommandLineEnvironmentInterface> {
+    /**
+     * Returns the metadata for the tool.
+     *
+     * The name, description, and needsApproval properties are defaults which can be overridden in the constructor.
+     *
+     * @returns The tool metadata.
+     */
+    protected getMetadata(): EnvironmentToolMetadata<ListDirectoryToolInput, ListDirectoryToolOutput>;
+    /**
+     * Executes the tool in the given execution environment with the given input.
+     *
+     * @param env - The execution environment to use.
+     * @param input - The input for the tool.
+     * @returns A promise that resolves to the tool execution result.
+     */
+    protected executeForEnvironment(env: CommandLineEnvironmentInterface, input: ListDirectoryToolInput): Promise<ListDirectoryToolOutput>;
+    /**
+     * Converts the tool output to a format suitable for model consumption.
+     *
+     * @param output - The output from the tool execution.
+     * @returns The formatted tool result.
+     */
+    toModelOutput(output: ListDirectoryToolOutput): ModelFormattedToolResult;
+    /**
+     * Gets the examples for the tool.
+     *
+     * @returns The tool examples.
+     */
+    get examples(): Array<ToolExample<ListDirectoryToolInput, ListDirectoryToolOutput>>;
+}
+
+declare const MoveFileToolName = "move_file";
+type MoveFileToolConfig = ToolConfig;
+declare const MoveFileToolInput: z$1.ZodObject<{
+    sourcePath: z$1.ZodString;
+    destinationPath: z$1.ZodString;
+}, z$1.core.$strip>;
+type MoveFileToolInput = z$1.infer<typeof MoveFileToolInput>;
+declare const MoveFileToolOutput: z$1.ZodObject<{
+    sourcePath: z$1.ZodString;
+    destinationPath: z$1.ZodString;
+    message: z$1.ZodString;
+}, z$1.core.$strip>;
+type MoveFileToolOutput = z$1.infer<typeof MoveFileToolOutput>;
+/**
+ * Class for the MoveFile tool.
+ */
+declare class MoveFileTool extends EnvironmentToolBase<MoveFileToolConfig, MoveFileToolInput, MoveFileToolOutput, FilesystemEnvironmentInterface> {
+    /**
+     * Returns the metadata for the tool.
+     *
+     * The name, description, and needsApproval properties are defaults which can be overridden in the constructor.
+     *
+     * @returns The tool metadata.
+     */
+    protected getMetadata(): EnvironmentToolMetadata<MoveFileToolInput, MoveFileToolOutput>;
+    /**
+     * Executes the tool in the given execution environment with the given input.
+     *
+     * @param env - The execution environment to use.
+     * @param input - The input for the tool.
+     * @returns A promise that resolves to the tool execution result.
+     */
+    protected executeForEnvironment(env: FilesystemEnvironmentInterface, input: MoveFileToolInput): Promise<MoveFileToolOutput>;
+    /**
+     * Converts the tool output to a format suitable for model consumption.
+     *
+     * @param output - The output from the tool execution.
+     * @returns The formatted tool result.
+     */
+    toModelOutput(output: MoveFileToolOutput): ModelFormattedToolResult;
+    /**
+     * Gets the examples for the tool.
+     *
+     * @returns The tool examples.
+     */
+    get examples(): Array<ToolExample<MoveFileToolInput, MoveFileToolOutput>>;
+}
+
+declare const ReadFileToolName = "read_file";
+type ReadFileToolConfig = ToolConfig;
+declare const ReadFileToolInput: z$1.ZodObject<{
+    path: z$1.ZodString;
+}, z$1.core.$strip>;
+type ReadFileToolInput = z$1.infer<typeof ReadFileToolInput>;
+declare const ReadFileToolOutput: z$1.ZodObject<{
+    path: z$1.ZodString;
+    content: z$1.ZodString;
+}, z$1.core.$strip>;
+type ReadFileToolOutput = z$1.infer<typeof ReadFileToolOutput>;
+/**
+ * Class for the ReadFile tool.
+ */
+declare class ReadFileTool extends EnvironmentToolBase<ReadFileToolConfig, ReadFileToolInput, ReadFileToolOutput, FilesystemEnvironmentInterface> {
+    /**
+     * Returns the metadata for the tool.
+     *
+     * The name, description, and needsApproval properties are defaults which can be overridden in the constructor.
+     *
+     * @returns The tool metadata.
+     */
+    protected getMetadata(): EnvironmentToolMetadata<ReadFileToolInput, ReadFileToolOutput>;
+    /**
+     * Executes the tool in the given execution environment with the given input.
+     *
+     * @param env - The execution environment to use.
+     * @param input - The input for the tool.
+     * @returns A promise that resolves to the tool execution result.
+     */
+    protected executeForEnvironment(env: FilesystemEnvironmentInterface, input: ReadFileToolInput): Promise<ReadFileToolOutput>;
+    /**
+     * Converts the tool output to a format suitable for model consumption.
+     *
+     * @param output - The output from the tool execution.
+     * @returns The formatted tool result.
+     */
+    toModelOutput(output: ReadFileToolOutput): ModelFormattedToolResult;
+    /**
+     * Gets the examples for the tool.
+     *
+     * @returns The tool examples.
+     */
+    get examples(): Array<ToolExample<ReadFileToolInput, ReadFileToolOutput>>;
+}
+
+declare const ReadManyFilesToolName = "read_many_files";
+type ReadManyFilesToolConfig = ToolConfig;
+declare const ReadManyFilesToolInput: z$1.ZodObject<{
+    paths: z$1.ZodArray<z$1.ZodString>;
+}, z$1.core.$strip>;
+type ReadManyFilesToolInput = z$1.infer<typeof ReadManyFilesToolInput>;
+declare const ReadManyFilesToolOutput: z$1.ZodRecord<z$1.ZodString, z$1.ZodObject<{
+    path: z$1.ZodString;
+    content: z$1.ZodString;
+}, z$1.core.$strip>>;
+type ReadManyFilesToolOutput = z$1.infer<typeof ReadManyFilesToolOutput>;
+/**
+ * Class for the ReadManyFiles tool.
+ */
+declare class ReadManyFilesTool extends EnvironmentToolBase<ReadManyFilesToolConfig, ReadManyFilesToolInput, ReadManyFilesToolOutput, FilesystemEnvironmentInterface> {
+    /**
+     * Returns the metadata for the tool.
+     *
+     * The name, description, and needsApproval properties are defaults which can be overridden in the constructor.
+     *
+     * @returns The tool metadata.
+     */
+    protected getMetadata(): EnvironmentToolMetadata<ReadManyFilesToolInput, ReadManyFilesToolOutput>;
+    /**
+     * Executes the tool in the given execution environment with the given input.
+     *
+     * @param env - The execution environment to use.
+     * @param input - The input for the tool.
+     * @returns A promise that resolves to the tool execution result.
+     */
+    protected executeForEnvironment(env: FilesystemEnvironmentInterface, input: ReadManyFilesToolInput): Promise<ReadManyFilesToolOutput>;
+    /**
+     * Converts the tool output to a format suitable for model consumption.
+     *
+     * @param output - The output from the tool execution.
+     * @returns The formatted tool result.
+     */
+    toModelOutput(output: ReadManyFilesToolOutput): ModelFormattedToolResult;
+    /**
+     * Gets the examples for the tool.
+     *
+     * @returns The tool examples.
+     */
+    get examples(): Array<ToolExample<ReadManyFilesToolInput, ReadManyFilesToolOutput>>;
+}
+
+declare const RunCommandToolName = "run_command";
+type RunCommandToolConfig = ToolConfig;
+declare const RunCommandToolInput: z$1.ZodObject<{
+    command: z$1.ZodString;
+}, z$1.core.$strip>;
+type RunCommandToolInput = z$1.infer<typeof RunCommandToolInput>;
+declare const RunCommandToolOutput: z$1.ZodObject<{
+    command: z$1.ZodString;
+    exitCode: z$1.ZodNumber;
+    stdout: z$1.ZodString;
+    stderr: z$1.ZodString;
+}, z$1.core.$strip>;
+type RunCommandToolOutput = z$1.infer<typeof RunCommandToolOutput>;
+/**
+ * Class for the RunCommand tool.
+ *
+ * WARNING: This tool can be dangerous if misused. It allows executing arbitrary commands in the environment.
+ * Only allow using this tool in sandboxed environments where the potential risks are understood and mitigated.
+ */
+declare class RunCommandTool extends EnvironmentToolBase<RunCommandToolConfig, RunCommandToolInput, RunCommandToolOutput, CommandLineEnvironmentInterface> {
+    /**
+     * Returns the metadata for the tool.
+     *
+     * The name, description, and needsApproval properties are defaults which can be overridden in the constructor.
+     *
+     * @returns The tool metadata.
+     */
+    protected getMetadata(): EnvironmentToolMetadata<RunCommandToolInput, RunCommandToolOutput>;
+    /**
+     * Executes the tool in the given execution environment with the given input.
+     *
+     * @param env - The execution environment to use.
+     * @param input - The input for the tool.
+     * @returns A promise that resolves to the tool execution result.
+     */
+    protected executeForEnvironment(env: CommandLineEnvironmentInterface, input: RunCommandToolInput): Promise<RunCommandToolOutput>;
+    /**
+     * Converts the tool output to a format suitable for model consumption.
+     *
+     * @param output - The output from the tool execution.
+     * @returns The formatted tool result.
+     */
+    toModelOutput(output: RunCommandToolOutput): ModelFormattedToolResult;
+    /**
+     * Gets the examples for the tool.
+     *
+     * @returns The tool examples.
+     */
+    get examples(): Array<ToolExample<RunCommandToolInput, RunCommandToolOutput>>;
+}
+
+declare const WriteFileToolName = "write_file";
+type WriteFileToolConfig = ToolConfig;
+declare const WriteFileToolInput: z$1.ZodObject<{
+    path: z$1.ZodString;
+    content: z$1.ZodString;
+}, z$1.core.$strip>;
+type WriteFileToolInput = z$1.infer<typeof WriteFileToolInput>;
+declare const WriteFileToolOutput: z$1.ZodObject<{
+    path: z$1.ZodString;
+    message: z$1.ZodString;
+}, z$1.core.$strip>;
+type WriteFileToolOutput = z$1.infer<typeof WriteFileToolOutput>;
+/**
+ * Class for the WriteFile tool.
+ */
+declare class WriteFileTool extends EnvironmentToolBase<WriteFileToolConfig, WriteFileToolInput, WriteFileToolOutput, FilesystemEnvironmentInterface> {
+    /**
+     * Returns the metadata for the tool.
+     *
+     * The name, description, and needsApproval properties are defaults which can be overridden in the constructor.
+     *
+     * @returns The tool metadata.
+     */
+    protected getMetadata(): EnvironmentToolMetadata<WriteFileToolInput, WriteFileToolOutput>;
+    /**
+     * Executes the tool in the given execution environment with the given input.
+     *
+     * @param env - The execution environment to use.
+     * @param input - The input for the tool.
+     * @returns A promise that resolves to the tool execution result.
+     */
+    protected executeForEnvironment(env: FilesystemEnvironmentInterface, input: WriteFileToolInput): Promise<WriteFileToolOutput>;
+    /**
+     * Converts the tool output to a format suitable for model consumption.
+     *
+     * @param output - The output from the tool execution.
+     * @returns The formatted tool result.
+     */
+    toModelOutput(output: WriteFileToolOutput): ModelFormattedToolResult;
+    /**
+     * Gets the examples for the tool.
+     *
+     * @returns The tool examples.
+     */
+    get examples(): Array<ToolExample<WriteFileToolInput, WriteFileToolOutput>>;
+}
+
+declare const availableEnvironmentTools: {
+    read_file: typeof ReadFileTool;
+    write_file: typeof WriteFileTool;
+    delete_file: typeof DeleteFileTool;
+    edit_file: typeof EditFileTool;
+    move_file: typeof MoveFileTool;
+    copy_file: typeof CopyFileTool;
+    read_many_files: typeof ReadManyFilesTool;
+    get_project_file_structure: typeof GetProjectFileStructureTool;
+    glob: typeof GlobTool;
+    list_directory: typeof ListDirectoryTool;
+    run_command: typeof RunCommandTool;
+};
+type EnvironmentToolClasses = {
+    [ReadFileToolName]: ReadFileTool;
+    [WriteFileToolName]: WriteFileTool;
+    [DeleteFileToolName]: DeleteFileTool;
+    [EditFileToolName]: EditFileTool;
+    [MoveFileToolName]: MoveFileTool;
+    [CopyFileToolName]: CopyFileTool;
+    [ReadManyFilesToolName]: ReadManyFilesTool;
+    [GetProjectFileStructureToolName]: GetProjectFileStructureTool;
+    [GlobToolName]: GlobTool;
+    [ListDirectoryToolName]: ListDirectoryTool;
+    [RunCommandToolName]: RunCommandTool;
+};
+type EnvironmentToolSafetyLevel = 'readonly' | 'basic' | 'all';
+declare const EnvironmentToolSafetyLevels: EnvironmentToolSafetyLevel[];
+type EnvironmentToolGenerics<T> = T extends EnvironmentToolBase<infer ToolConfig, infer ToolInput, infer ToolOutput, infer ToolEnvironment> ? {
+    ToolConfigType: ToolConfig;
+    ToolInputType: ToolInput;
+    ToolOutputType: ToolOutput;
+    ToolEnvironmentType: ToolEnvironment;
+} : never;
+type EnvironmentToolConfigOf<T> = T extends {
+    _toolConfig: infer C;
+} ? C : never;
+type EnvironmentToolInputTypeOf<T> = EnvironmentToolGenerics<T>['ToolInputType'];
+type EnvironmentToolOutputTypeOf<T> = EnvironmentToolGenerics<T>['ToolOutputType'];
+type EnvironmentToolEnvironmentTypeOf<T> = EnvironmentToolGenerics<T>['ToolEnvironmentType'];
+type EnvironmentToolName = keyof typeof availableEnvironmentTools;
+declare const EnvironmentToolNames: EnvironmentToolName[];
+/**
+ * Creates an environment tool instance based on the provided name, execution environment, and configuration.
+ *
+ * @param toolName - The name identifying the type of environment tool to create.
+ * @param environment - The execution environment to create the tool for.
+ * @param config - The configuration object for the environment tool.
+ * @returns An instance of the specified environment tool.
+ */
+declare function createEnvironmentTool<T extends EnvironmentToolName>(toolName: T, environment: EnvironmentToolEnvironmentTypeOf<EnvironmentToolClasses[T]>, config?: EnvironmentToolConfigOf<EnvironmentToolClasses[T]>): EnvironmentToolClasses[T];
+type ToolCreatorConfig = EnvironmentToolName extends infer T ? T extends EnvironmentToolName ? {
+    toolName: T;
+    toolConfig?: EnvironmentToolConfigOf<EnvironmentToolClasses[T]>;
+} : never : never;
+type ToolsDefinition = Array<EnvironmentToolName | ToolCreatorConfig> | EnvironmentToolSafetyLevel;
+type ToolWithIO = EnvironmentToolName extends infer T ? T extends EnvironmentToolName ? Tool<EnvironmentToolInputTypeOf<EnvironmentToolClasses[T]>, EnvironmentToolOutputTypeOf<EnvironmentToolClasses[T]>> : never : never;
+/**
+ * Creates a map of tools for the given environment.
+ *
+ * @param environment - The execution environment to create the tools for.
+ * @param toolsDefinition - The names of the tools to create, or 'readonly', 'basic', or 'all' as a shortcut for groups of available tools.
+ * @returns A record mapping tool names to their corresponding Tool instances.
+ */
+declare function createToolsForEnvironment(environment: Environment, toolsDefinition?: ToolsDefinition): Record<string, ToolWithIO>;
+/**
+ * Creates a map of tools for the given environment, modifying tool names with the environment name to avoid conflicts.
+ *
+ * For example, if the environment name is "env1" and the tool is "read_file", the modified tool name will be "read_file_in_env1".
+ *
+ * @param environmentName - The name of the environment. Will be used in tool names to avoid conflicts.
+ * @param environment - The execution environment to create the tools for.
+ * @param toolsDefinition - The names of the tools to create, or 'readonly', 'basic', or 'all' as a shortcut for groups of available tools.
+ * @returns A record mapping tool names to their corresponding Tool instances.
+ */
+declare function createToolsForNamedEnvironment(environmentName: string, environment: Environment, toolsDefinition?: ToolsDefinition): Record<string, ToolWithIO>;
+
+type CodeAgentCreatorConfig = Experimental_AgentSettings<Record<string, Tool>> & {
+    maxSteps: number;
+    allowSubmit?: boolean;
+    logStep?: (stepLog: string, stepIndex: number) => void;
+    omitAdditionalInstructions?: boolean;
+} & ({
+    environment: Environment;
+    environmentToolsDefinition: ToolsDefinition;
+} | {
+    environments: Record<string, Environment>;
+    environmentToolsDefinition: Record<string, ToolsDefinition>;
+} | Record<string, never>);
+/**
+ * Creates an AI code agent configured to operate on one or more specified execution environments with tools.
+ *
+ * @param agentConfig - Configuration options for the code agent, including environments, tools definition, and agent settings.
+ * @returns An instance of Agent configured with the specified environment tools and settings.
+ */
+declare function createCodeAgent(agentConfig: CodeAgentCreatorConfig): Experimental_Agent<Record<string, Tool>>;
+
+declare const availableEnvironments: {
+    "unsafe-local": typeof UnsafeLocalEnvironment;
+    docker: typeof DockerEnvironment;
+    "mock-filesystem": typeof MockFilesystemEnvironment;
+    "node-filesystem": typeof NodeFilesystemEnvironment;
+};
+type EnvironmentClasses = {
+    [UnsafeLocalEnvironmentName]: UnsafeLocalEnvironment;
+    [DockerEnvironmentName]: DockerEnvironment;
+    [MockFilesystemEnvironmentName]: MockFilesystemEnvironment;
+    [NodeFilesystemEnvironmentName]: NodeFilesystemEnvironment;
+};
+type EnvironmentConfigOf<T> = T extends FilesystemEnvironmentBase<infer X> ? X : never;
+type EnvironmentName = keyof typeof availableEnvironments;
+declare const EnvironmentNames: EnvironmentName[];
+/**
+ * Creates an environment instance based on the provided name and configuration.
+ *
+ * @param environmentName - The name identifying the type of environment to create.
+ * @param config - The configuration object for the environment.
+ * @returns An instance of the specified environment.
+ */
+declare function createEnvironment<T extends EnvironmentName>(environmentName: T, config: EnvironmentConfigOf<EnvironmentClasses[T]>): EnvironmentClasses[T];
+
+export { type CodeAgentCreatorConfig, type CommandLineEnvironmentInterface, CopyFileResult, CopyFileTool, type CopyFileToolConfig, CopyFileToolInput, CopyFileToolName, CopyFileToolOutput, DeleteFileResult, DeleteFileTool, type DeleteFileToolConfig, DeleteFileToolInput, DeleteFileToolName, DeleteFileToolOutput, DockerEnvironment, type DockerEnvironmentConfig, DockerEnvironmentName, EditFileTool, type EditFileToolConfig, EditFileToolInput, EditFileToolName, EditFileToolOutput, type Environment, type EnvironmentName, EnvironmentNames, type EnvironmentToolInterface, type EnvironmentToolName, EnvironmentToolNames, type EnvironmentToolSafetyLevel, EnvironmentToolSafetyLevels, type FilesystemEnvironmentInterface, GetProjectFileStructureTool, type GetProjectFileStructureToolConfig, GetProjectFileStructureToolInput, GetProjectFileStructureToolName, GetProjectFileStructureToolOutput, GlobTool, type GlobToolConfig, GlobToolInput, GlobToolName, GlobToolOutput, ListDirectoryTool, type ListDirectoryToolConfig, ListDirectoryToolInput, ListDirectoryToolName, ListDirectoryToolOutput, MockFilesystemEnvironment, type MockFilesystemEnvironmentConfig, MockFilesystemEnvironmentName, type ModelFormattedToolResult, MoveFileResult, MoveFileTool, type MoveFileToolConfig, MoveFileToolInput, MoveFileToolName, MoveFileToolOutput, NodeFilesystemEnvironment, type NodeFilesystemEnvironmentConfig, NodeFilesystemEnvironmentName, ReadFileResult, ReadFileTool, type ReadFileToolConfig, ReadFileToolInput, ReadFileToolName, ReadFileToolOutput, ReadManyFilesTool, type ReadManyFilesToolConfig, ReadManyFilesToolInput, ReadManyFilesToolName, ReadManyFilesToolOutput, RunCommandResult, RunCommandTool, type RunCommandToolConfig, RunCommandToolInput, RunCommandToolName, RunCommandToolOutput, type ToolConfig, type ToolExample, type ToolInterface, type ToolsDefinition, UnsafeLocalEnvironment, type UnsafeLocalEnvironmentConfig, UnsafeLocalEnvironmentName, WriteFileResult, WriteFileTool, type WriteFileToolConfig, WriteFileToolInput, WriteFileToolName, WriteFileToolOutput, createCodeAgent, createEnvironment, createEnvironmentTool, createToolsForEnvironment, createToolsForNamedEnvironment };