@gugacoder/agentic-sdk 0.2.0

package/dist/tools/write.d.ts

@@ -0,0 +1,550 @@
+export declare function createWriteTool(opts?: {
+    autoApprove?: boolean;
+}): ({
+    description?: string;
+    title?: string;
+    providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+    inputSchema: import("ai").FlexibleSchema<{
+        file_path: string;
+        content: string;
+    }>;
+    inputExamples?: {
+        input: NoInfer<{
+            file_path: string;
+            content: string;
+        }>;
+    }[] | undefined;
+    needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+        file_path: string;
+        content: string;
+    }> | undefined;
+    strict?: boolean;
+    onInputStart?: (options: import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputDelta?: (options: {
+        inputTextDelta: string;
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputAvailable?: ((options: {
+        input: {
+            file_path: string;
+            content: string;
+        };
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>) | undefined;
+} & {
+    outputSchema: import("ai").FlexibleSchema<string>;
+    execute?: never;
+} & {
+    toModelOutput?: ((options: {
+        toolCallId: string;
+        input: {
+            file_path: string;
+            content: string;
+        };
+        output: string;
+    }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+} & {
+    type?: undefined | "function";
+}) | ({
+    description?: string;
+    title?: string;
+    providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+    inputSchema: import("ai").FlexibleSchema<{
+        file_path: string;
+        content: string;
+    }>;
+    inputExamples?: {
+        input: NoInfer<{
+            file_path: string;
+            content: string;
+        }>;
+    }[] | undefined;
+    needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+        file_path: string;
+        content: string;
+    }> | undefined;
+    strict?: boolean;
+    onInputStart?: (options: import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputDelta?: (options: {
+        inputTextDelta: string;
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputAvailable?: ((options: {
+        input: {
+            file_path: string;
+            content: string;
+        };
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>) | undefined;
+} & {
+    outputSchema: import("ai").FlexibleSchema<string>;
+    execute?: never;
+} & {
+    toModelOutput?: ((options: {
+        toolCallId: string;
+        input: {
+            file_path: string;
+            content: string;
+        };
+        output: string;
+    }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+} & {
+    type: "dynamic";
+}) | ({
+    description?: string;
+    title?: string;
+    providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+    inputSchema: import("ai").FlexibleSchema<{
+        file_path: string;
+        content: string;
+    }>;
+    inputExamples?: {
+        input: NoInfer<{
+            file_path: string;
+            content: string;
+        }>;
+    }[] | undefined;
+    needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+        file_path: string;
+        content: string;
+    }> | undefined;
+    strict?: boolean;
+    onInputStart?: (options: import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputDelta?: (options: {
+        inputTextDelta: string;
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputAvailable?: ((options: {
+        input: {
+            file_path: string;
+            content: string;
+        };
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>) | undefined;
+} & {
+    outputSchema: import("ai").FlexibleSchema<string>;
+    execute?: never;
+} & {
+    toModelOutput?: ((options: {
+        toolCallId: string;
+        input: {
+            file_path: string;
+            content: string;
+        };
+        output: string;
+    }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+} & {
+    type: "provider";
+    id: `${string}.${string}`;
+    args: Record<string, unknown>;
+    supportsDeferredResults?: boolean;
+}) | ({
+    description?: string;
+    title?: string;
+    providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+    inputSchema: import("ai").FlexibleSchema<{
+        file_path: string;
+        content: string;
+    }>;
+    inputExamples?: {
+        input: NoInfer<{
+            file_path: string;
+            content: string;
+        }>;
+    }[] | undefined;
+    needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+        file_path: string;
+        content: string;
+    }> | undefined;
+    strict?: boolean;
+    onInputStart?: (options: import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputDelta?: (options: {
+        inputTextDelta: string;
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputAvailable?: ((options: {
+        input: {
+            file_path: string;
+            content: string;
+        };
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>) | undefined;
+} & {
+    execute: import("ai").ToolExecuteFunction<{
+        file_path: string;
+        content: string;
+    }, string>;
+    outputSchema?: import("ai").FlexibleSchema<string> | undefined;
+} & {
+    toModelOutput?: ((options: {
+        toolCallId: string;
+        input: {
+            file_path: string;
+            content: string;
+        };
+        output: string;
+    }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+} & {
+    type?: undefined | "function";
+}) | ({
+    description?: string;
+    title?: string;
+    providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+    inputSchema: import("ai").FlexibleSchema<{
+        file_path: string;
+        content: string;
+    }>;
+    inputExamples?: {
+        input: NoInfer<{
+            file_path: string;
+            content: string;
+        }>;
+    }[] | undefined;
+    needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+        file_path: string;
+        content: string;
+    }> | undefined;
+    strict?: boolean;
+    onInputStart?: (options: import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputDelta?: (options: {
+        inputTextDelta: string;
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputAvailable?: ((options: {
+        input: {
+            file_path: string;
+            content: string;
+        };
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>) | undefined;
+} & {
+    execute: import("ai").ToolExecuteFunction<{
+        file_path: string;
+        content: string;
+    }, string>;
+    outputSchema?: import("ai").FlexibleSchema<string> | undefined;
+} & {
+    toModelOutput?: ((options: {
+        toolCallId: string;
+        input: {
+            file_path: string;
+            content: string;
+        };
+        output: string;
+    }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+} & {
+    type: "dynamic";
+}) | ({
+    description?: string;
+    title?: string;
+    providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+    inputSchema: import("ai").FlexibleSchema<{
+        file_path: string;
+        content: string;
+    }>;
+    inputExamples?: {
+        input: NoInfer<{
+            file_path: string;
+            content: string;
+        }>;
+    }[] | undefined;
+    needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+        file_path: string;
+        content: string;
+    }> | undefined;
+    strict?: boolean;
+    onInputStart?: (options: import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputDelta?: (options: {
+        inputTextDelta: string;
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputAvailable?: ((options: {
+        input: {
+            file_path: string;
+            content: string;
+        };
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>) | undefined;
+} & {
+    execute: import("ai").ToolExecuteFunction<{
+        file_path: string;
+        content: string;
+    }, string>;
+    outputSchema?: import("ai").FlexibleSchema<string> | undefined;
+} & {
+    toModelOutput?: ((options: {
+        toolCallId: string;
+        input: {
+            file_path: string;
+            content: string;
+        };
+        output: string;
+    }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+} & {
+    type: "provider";
+    id: `${string}.${string}`;
+    args: Record<string, unknown>;
+    supportsDeferredResults?: boolean;
+});
+export declare const writeTool: ({
+    description?: string;
+    title?: string;
+    providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+    inputSchema: import("ai").FlexibleSchema<{
+        file_path: string;
+        content: string;
+    }>;
+    inputExamples?: {
+        input: NoInfer<{
+            file_path: string;
+            content: string;
+        }>;
+    }[] | undefined;
+    needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+        file_path: string;
+        content: string;
+    }> | undefined;
+    strict?: boolean;
+    onInputStart?: (options: import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputDelta?: (options: {
+        inputTextDelta: string;
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputAvailable?: ((options: {
+        input: {
+            file_path: string;
+            content: string;
+        };
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>) | undefined;
+} & {
+    outputSchema: import("ai").FlexibleSchema<string>;
+    execute?: never;
+} & {
+    toModelOutput?: ((options: {
+        toolCallId: string;
+        input: {
+            file_path: string;
+            content: string;
+        };
+        output: string;
+    }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+} & {
+    type?: undefined | "function";
+}) | ({
+    description?: string;
+    title?: string;
+    providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+    inputSchema: import("ai").FlexibleSchema<{
+        file_path: string;
+        content: string;
+    }>;
+    inputExamples?: {
+        input: NoInfer<{
+            file_path: string;
+            content: string;
+        }>;
+    }[] | undefined;
+    needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+        file_path: string;
+        content: string;
+    }> | undefined;
+    strict?: boolean;
+    onInputStart?: (options: import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputDelta?: (options: {
+        inputTextDelta: string;
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputAvailable?: ((options: {
+        input: {
+            file_path: string;
+            content: string;
+        };
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>) | undefined;
+} & {
+    outputSchema: import("ai").FlexibleSchema<string>;
+    execute?: never;
+} & {
+    toModelOutput?: ((options: {
+        toolCallId: string;
+        input: {
+            file_path: string;
+            content: string;
+        };
+        output: string;
+    }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+} & {
+    type: "dynamic";
+}) | ({
+    description?: string;
+    title?: string;
+    providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+    inputSchema: import("ai").FlexibleSchema<{
+        file_path: string;
+        content: string;
+    }>;
+    inputExamples?: {
+        input: NoInfer<{
+            file_path: string;
+            content: string;
+        }>;
+    }[] | undefined;
+    needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+        file_path: string;
+        content: string;
+    }> | undefined;
+    strict?: boolean;
+    onInputStart?: (options: import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputDelta?: (options: {
+        inputTextDelta: string;
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputAvailable?: ((options: {
+        input: {
+            file_path: string;
+            content: string;
+        };
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>) | undefined;
+} & {
+    outputSchema: import("ai").FlexibleSchema<string>;
+    execute?: never;
+} & {
+    toModelOutput?: ((options: {
+        toolCallId: string;
+        input: {
+            file_path: string;
+            content: string;
+        };
+        output: string;
+    }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+} & {
+    type: "provider";
+    id: `${string}.${string}`;
+    args: Record<string, unknown>;
+    supportsDeferredResults?: boolean;
+}) | ({
+    description?: string;
+    title?: string;
+    providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+    inputSchema: import("ai").FlexibleSchema<{
+        file_path: string;
+        content: string;
+    }>;
+    inputExamples?: {
+        input: NoInfer<{
+            file_path: string;
+            content: string;
+        }>;
+    }[] | undefined;
+    needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+        file_path: string;
+        content: string;
+    }> | undefined;
+    strict?: boolean;
+    onInputStart?: (options: import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputDelta?: (options: {
+        inputTextDelta: string;
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputAvailable?: ((options: {
+        input: {
+            file_path: string;
+            content: string;
+        };
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>) | undefined;
+} & {
+    execute: import("ai").ToolExecuteFunction<{
+        file_path: string;
+        content: string;
+    }, string>;
+    outputSchema?: import("ai").FlexibleSchema<string> | undefined;
+} & {
+    toModelOutput?: ((options: {
+        toolCallId: string;
+        input: {
+            file_path: string;
+            content: string;
+        };
+        output: string;
+    }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+} & {
+    type?: undefined | "function";
+}) | ({
+    description?: string;
+    title?: string;
+    providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+    inputSchema: import("ai").FlexibleSchema<{
+        file_path: string;
+        content: string;
+    }>;
+    inputExamples?: {
+        input: NoInfer<{
+            file_path: string;
+            content: string;
+        }>;
+    }[] | undefined;
+    needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+        file_path: string;
+        content: string;
+    }> | undefined;
+    strict?: boolean;
+    onInputStart?: (options: import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputDelta?: (options: {
+        inputTextDelta: string;
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputAvailable?: ((options: {
+        input: {
+            file_path: string;
+            content: string;
+        };
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>) | undefined;
+} & {
+    execute: import("ai").ToolExecuteFunction<{
+        file_path: string;
+        content: string;
+    }, string>;
+    outputSchema?: import("ai").FlexibleSchema<string> | undefined;
+} & {
+    toModelOutput?: ((options: {
+        toolCallId: string;
+        input: {
+            file_path: string;
+            content: string;
+        };
+        output: string;
+    }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+} & {
+    type: "dynamic";
+}) | ({
+    description?: string;
+    title?: string;
+    providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+    inputSchema: import("ai").FlexibleSchema<{
+        file_path: string;
+        content: string;
+    }>;
+    inputExamples?: {
+        input: NoInfer<{
+            file_path: string;
+            content: string;
+        }>;
+    }[] | undefined;
+    needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+        file_path: string;
+        content: string;
+    }> | undefined;
+    strict?: boolean;
+    onInputStart?: (options: import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputDelta?: (options: {
+        inputTextDelta: string;
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>;
+    onInputAvailable?: ((options: {
+        input: {
+            file_path: string;
+            content: string;
+        };
+    } & import("ai").ToolExecutionOptions) => void | PromiseLike<void>) | undefined;
+} & {
+    execute: import("ai").ToolExecuteFunction<{
+        file_path: string;
+        content: string;
+    }, string>;
+    outputSchema?: import("ai").FlexibleSchema<string> | undefined;
+} & {
+    toModelOutput?: ((options: {
+        toolCallId: string;
+        input: {
+            file_path: string;
+            content: string;
+        };
+        output: string;
+    }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+} & {
+    type: "provider";
+    id: `${string}.${string}`;
+    args: Record<string, unknown>;
+    supportsDeferredResults?: boolean;
+});

package/dist/tools/write.js

@@ -0,0 +1,30 @@
+import { tool } from "ai";
+import { z } from "zod";
+import { writeFile, mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+export function createWriteTool(opts) {
+    const baseTool = tool({
+        description: "Writes content to a file. Creates parent directories if needed. Overwrites existing files.",
+        inputSchema: z.object({
+            file_path: z.string().describe("Absolute path to the file to write"),
+            content: z.string().describe("The content to write to the file"),
+        }),
+        execute: async ({ file_path, content }) => {
+            try {
+                await mkdir(dirname(file_path), { recursive: true });
+                await writeFile(file_path, content, "utf-8");
+                return `File written successfully: ${file_path}`;
+            }
+            catch (err) {
+                return `Error writing file: ${err.message}`;
+            }
+        },
+    });
+    if (opts?.autoApprove === false) {
+        return Object.assign(baseTool, {
+            needsApproval: async () => true,
+        });
+    }
+    return baseTool;
+}
+export const writeTool = createWriteTool();