@visulima/storage 1.0.0-alpha.3 → 1.0.0-alpha.30

package/dist/adapter/nuxt/module.d.ts

@@ -1,39 +1,46 @@
-import type { UploadOptions } from "../../handler/types.d.ts";
-import type { BaseStorage } from "../../storage/storage.d.ts";
-import type { UploadFile } from "../../storage/utils/index.d.ts";
+import { U as UploadOptions } from "../../packem_shared/types.d-cI_cMxcZ.js";
+import { U as UploadFile, B as BaseStorage } from "../../packem_shared/storage.d-RteRC-cG.js";
+import 'node:stream';
+import 'node:events';
+import 'node:http';
+import '@visulima/pagination';
+import "../../packem_shared/media-transformer.d-C3QvECD7.js";
+import "../../packem_shared/types.d-DxonY4XS.js";
+import 'node:crypto';
+import 'lru-cache';
 /**
- * CORS configuration for upload endpoints
- */
-export interface CorsOptions {
-    /** Allowed CORS headers */
-    headers?: string[];
-    /** Allowed HTTP methods */
-    methods?: string[];
-    /** Allowed origins (use "*" for all origins) */
-    origin?: string | string[];
+* CORS configuration for upload endpoints
+*/
+interface CorsOptions {
+  /** Allowed CORS headers */
+  headers?: string[];
+  /** Allowed HTTP methods */
+  methods?: string[];
+  /** Allowed origins (use "*" for all origins) */
+  origin?: string | string[];
 }
 /**
- * Configuration options for the Nuxt storage module
- */
-export interface ModuleOptions {
-    /** Base path for upload routes (default: '/api/upload') */
-    basePath?: string;
-    /** CORS configuration */
-    cors?: CorsOptions;
-    /** Enable multipart upload endpoint (default: true) */
-    multipart?: boolean;
-    /** Additional options for multipart handler */
-    multipartOptions?: Omit<UploadOptions<UploadFile>, "storage">;
-    /** Enable REST API endpoint for direct binary uploads (default: true) */
-    rest?: boolean;
-    /** Additional options for REST handler */
-    restOptions?: Omit<UploadOptions<UploadFile>, "storage">;
-    /** Storage instance to use for file uploads */
-    storage: BaseStorage;
-    /** Enable TUS resumable upload endpoint (default: true) */
-    tus?: boolean;
-    /** Additional options for TUS handler */
-    tusOptions?: Omit<UploadOptions<UploadFile>, "storage">;
+* Configuration options for the Nuxt storage module
+*/
+interface ModuleOptions {
+  /** Base path for upload routes (default: '/api/upload') */
+  basePath?: string;
+  /** CORS configuration */
+  cors?: CorsOptions;
+  /** Enable multipart upload endpoint (default: true) */
+  multipart?: boolean;
+  /** Additional options for multipart handler */
+  multipartOptions?: Omit<UploadOptions<UploadFile>, "storage">;
+  /** Enable REST API endpoint for direct binary uploads (default: true) */
+  rest?: boolean;
+  /** Additional options for REST handler */
+  restOptions?: Omit<UploadOptions<UploadFile>, "storage">;
+  /** Storage instance to use for file uploads */
+  storage: BaseStorage;
+  /** Enable TUS resumable upload endpoint (default: true) */
+  tus?: boolean;
+  /** Additional options for TUS handler */
+  tusOptions?: Omit<UploadOptions<UploadFile>, "storage">;
 }
 declare const nuxtModule: any;
-export default nuxtModule;
+export { CorsOptions, ModuleOptions, nuxtModule as default };

package/dist/adapter/nuxt/module.js

@@ -1,93 +1 @@
-import { defineNuxtModule } from '@nuxt/kit';
-
-const handlerStorage = /* @__PURE__ */ new Map();
-const nuxtModule = defineNuxtModule({
-  defaults: {
-    basePath: "/api/upload",
-    cors: {
-      headers: ["Content-Type", "Upload-Offset", "Upload-Length", "Tus-Resumable"],
-      methods: ["GET", "POST", "PATCH", "PUT", "HEAD", "DELETE", "OPTIONS"],
-      origin: "*"
-    },
-    multipart: true,
-    rest: true,
-    tus: true
-  },
-  meta: {
-    compatibility: {
-      nuxt: ">=4.0.0"
-    },
-    configKey: "storage",
-    name: "@visulima/storage"
-  },
-  async setup(options, nuxt) {
-    const {
-      basePath = "/api/upload",
-      cors = {
-        headers: ["Content-Type", "Upload-Offset", "Upload-Length", "Tus-Resumable"],
-        methods: ["GET", "POST", "PATCH", "PUT", "HEAD", "DELETE", "OPTIONS"],
-        origin: "*"
-      },
-      multipart = true,
-      multipartOptions = {},
-      rest = true,
-      restOptions = {},
-      storage,
-      tus = true,
-      tusOptions = {}
-    } = options;
-    if (!storage) {
-      throw new Error("[@visulima/storage/nuxt] Storage instance is required");
-    }
-    const { Multipart, Rest, Tus } = await import('../../handler/http/node/index.js');
-    const multipartHandler = multipart ? new Multipart({ storage, ...multipartOptions }) : void 0;
-    const restHandler = rest ? new Rest({ storage, ...restOptions }) : void 0;
-    const tusHandler = tus ? new Tus({ storage, ...tusOptions }) : void 0;
-    const setCorsHeaders = (event) => {
-      const origin = Array.isArray(cors.origin) ? cors.origin.join(", ") : cors.origin || "*";
-      event.node.res.setHeader("Access-Control-Allow-Origin", origin);
-      if (cors.methods) {
-        event.node.res.setHeader("Access-Control-Allow-Methods", cors.methods.join(", "));
-      }
-      if (cors.headers) {
-        event.node.res.setHeader("Access-Control-Allow-Headers", cors.headers.join(", "));
-      }
-    };
-    if (multipartHandler) {
-      handlerStorage.set(`${basePath}/multipart`, { handler: multipartHandler, setCorsHeaders });
-    }
-    if (restHandler) {
-      handlerStorage.set(`${basePath}/rest`, { handler: restHandler, setCorsHeaders });
-    }
-    if (tusHandler) {
-      handlerStorage.set(`${basePath}/tus`, { handler: tusHandler, setCorsHeaders });
-    }
-    nuxt.hook("nitro:config", (nitroConfig) => {
-      const routeRules = nitroConfig.routeRules || {};
-      if (multipartHandler) {
-        routeRules[`${basePath}/multipart/**`] = { cors: true };
-      }
-      if (restHandler) {
-        routeRules[`${basePath}/rest/**`] = { cors: true };
-      }
-      if (tusHandler) {
-        routeRules[`${basePath}/tus/**`] = { cors: true };
-      }
-      nitroConfig.routeRules = routeRules;
-    });
-    nuxt.hook("nitro:init", (nitro) => {
-      nitro.hooks.hook("request", async (event) => {
-        const url = event.node.req.url || "";
-        for (const [route, { handler, setCorsHeaders: setHeaders }] of handlerStorage.entries()) {
-          if (url.startsWith(route)) {
-            setHeaders(event);
-            await handler.handle(event.node.req, event.node.res);
-            return;
-          }
-        }
-      });
-    });
-  }
-});
-
-export { nuxtModule as default };
+var v=Object.defineProperty;var p=(a,r)=>v(a,"name",{value:r,configurable:!0});import{defineNuxtModule as b}from"@nuxt/kit";var U=Object.defineProperty,S=p((a,r)=>U(a,"name",{value:r,configurable:!0}),"g");const i=new Map,j=b({defaults:{basePath:"/api/upload",cors:{headers:["Content-Type","Upload-Offset","Upload-Length","Tus-Resumable"],methods:["GET","POST","PATCH","PUT","HEAD","DELETE","OPTIONS"],origin:"*"},multipart:!0,rest:!0,tus:!0},meta:{compatibility:{nuxt:">=4.0.0"},configKey:"storage",name:"@visulima/storage"},async setup(a,r){const{basePath:o="/api/upload",cors:s={headers:["Content-Type","Upload-Offset","Upload-Length","Tus-Resumable"],methods:["GET","POST","PATCH","PUT","HEAD","DELETE","OPTIONS"],origin:"*"},multipart:h=!0,multipartOptions:m={},rest:g=!0,restOptions:T={},storage:n,tus:f=!0,tusOptions:H={}}=a;if(!n)throw new Error("[@visulima/storage/nuxt] Storage instance is required");const{Multipart:O,Rest:A,Tus:C}=await import("../../handler/http/node/index.js"),u=h?new O({storage:n,...m}):void 0,d=g?new A({storage:n,...T}):void 0,l=f?new C({storage:n,...H}):void 0,c=S(t=>{const e=Array.isArray(s.origin)?s.origin.join(", "):s.origin||"*";t.node.res.setHeader("Access-Control-Allow-Origin",e),s.methods&&t.node.res.setHeader("Access-Control-Allow-Methods",s.methods.join(", ")),s.headers&&t.node.res.setHeader("Access-Control-Allow-Headers",s.headers.join(", "))},"setCorsHeaders");u&&i.set(`${o}/multipart`,{handler:u,setCorsHeaders:c}),d&&i.set(`${o}/rest`,{handler:d,setCorsHeaders:c}),l&&i.set(`${o}/tus`,{handler:l,setCorsHeaders:c}),r.hook("nitro:config",t=>{const e=t.routeRules||{};u&&(e[`${o}/multipart/**`]={cors:!0}),d&&(e[`${o}/rest/**`]={cors:!0}),l&&(e[`${o}/tus/**`]={cors:!0}),t.routeRules=e}),r.hook("nitro:init",t=>{t.hooks.hook("request",async e=>{const w=e.node.req.url||"";for(const[E,{handler:P,setCorsHeaders:y}]of i.entries())if(w.startsWith(E)){y(e),await P.handle(e.node.req,e.node.res);return}})})}});export{j as default};

package/dist/adapter/nuxt/node_modules/.bin/nuxi

@@ -0,0 +1,22 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/visulima/visulima/node_modules/.pnpm/nuxt@4.4.4_@azure+storage-blob@12.31.0_@babel+core@7.29.0_@babel+plugin-proposal-decora_523dc65e70025e48d1ecd471e5f50478/node_modules/nuxt/node_modules:/home/runner/work/visulima/visulima/node_modules/.pnpm/nuxt@4.4.4_@azure+storage-blob@12.31.0_@babel+core@7.29.0_@babel+plugin-proposal-decora_523dc65e70025e48d1ecd471e5f50478/node_modules:/home/runner/work/visulima/visulima/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/visulima/visulima/node_modules/.pnpm/nuxt@4.4.4_@azure+storage-blob@12.31.0_@babel+core@7.29.0_@babel+plugin-proposal-decora_523dc65e70025e48d1ecd471e5f50478/node_modules/nuxt/node_modules:/home/runner/work/visulima/visulima/node_modules/.pnpm/nuxt@4.4.4_@azure+storage-blob@12.31.0_@babel+core@7.29.0_@babel+plugin-proposal-decora_523dc65e70025e48d1ecd471e5f50478/node_modules:/home/runner/work/visulima/visulima/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../nuxt/bin/nuxt.mjs" "$@"
+else
+  exec node  "$basedir/../nuxt/bin/nuxt.mjs" "$@"
+fi
+# cmd-shim-target=/home/runner/work/visulima/visulima/packages/storage/storage/dist/adapter/nuxt/node_modules/nuxt/bin/nuxt.mjs

package/dist/adapter/nuxt/node_modules/.bin/nuxt

@@ -0,0 +1,22 @@
+#!/bin/sh
+basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
+
+case `uname` in
+    *CYGWIN*|*MINGW*|*MSYS*)
+        if command -v cygpath > /dev/null 2>&1; then
+            basedir=`cygpath -w "$basedir"`
+        fi
+    ;;
+esac
+
+if [ -z "$NODE_PATH" ]; then
+  export NODE_PATH="/home/runner/work/visulima/visulima/node_modules/.pnpm/nuxt@4.4.4_@azure+storage-blob@12.31.0_@babel+core@7.29.0_@babel+plugin-proposal-decora_523dc65e70025e48d1ecd471e5f50478/node_modules/nuxt/node_modules:/home/runner/work/visulima/visulima/node_modules/.pnpm/nuxt@4.4.4_@azure+storage-blob@12.31.0_@babel+core@7.29.0_@babel+plugin-proposal-decora_523dc65e70025e48d1ecd471e5f50478/node_modules:/home/runner/work/visulima/visulima/node_modules/.pnpm/node_modules"
+else
+  export NODE_PATH="/home/runner/work/visulima/visulima/node_modules/.pnpm/nuxt@4.4.4_@azure+storage-blob@12.31.0_@babel+core@7.29.0_@babel+plugin-proposal-decora_523dc65e70025e48d1ecd471e5f50478/node_modules/nuxt/node_modules:/home/runner/work/visulima/visulima/node_modules/.pnpm/nuxt@4.4.4_@azure+storage-blob@12.31.0_@babel+core@7.29.0_@babel+plugin-proposal-decora_523dc65e70025e48d1ecd471e5f50478/node_modules:/home/runner/work/visulima/visulima/node_modules/.pnpm/node_modules:$NODE_PATH"
+fi
+if [ -x "$basedir/node" ]; then
+  exec "$basedir/node"  "$basedir/../nuxt/bin/nuxt.mjs" "$@"
+else
+  exec node  "$basedir/../nuxt/bin/nuxt.mjs" "$@"
+fi
+# cmd-shim-target=/home/runner/work/visulima/visulima/packages/storage/storage/dist/adapter/nuxt/node_modules/nuxt/bin/nuxt.mjs

package/dist/adapter/nuxt/package.json

@@ -2,12 +2,6 @@
     "name": "@visulima/storage-nuxt",
     "version": "0.0.0",
     "type": "module",
-    "exports": {
-        ".": {
-            "types": "./module.d.ts",
-            "import": "./module.js"
-        }
-    },
     "main": "./module.js",
     "types": "./module.d.ts",
     "files": [

package/dist/ai/ai-sdk/index.d.ts

@@ -0,0 +1,113 @@
+import { F as Files } from "../../packem_shared/index.d-C4Fivh4I.js";
+import { C as CopyFileInput, D as DeleteFileInput, a as DownloadFileInput, G as GetFileMetadataInput, b as GetFileUrlInput, L as ListFilesInput, S as SignUploadUrlInput, U as UploadFileInput, F as FileToolName, A as ApprovalConfig, c as FileReadToolName } from "../../packem_shared/approval.d-CMAYH9GF.js";
+export { type d as FileWriteToolName } from "../../packem_shared/approval.d-CMAYH9GF.js";
+import { Tool } from 'ai';
+import { e as executors } from "../../packem_shared/executors.d-X4hz3zfu.js";
+import "../../packem_shared/storage.d-RteRC-cG.js";
+import 'node:stream';
+import 'node:crypto';
+import 'node:http';
+import 'lru-cache';
+import 'zod';
+/**
+* Common options accepted by every write-tool factory.
+*/
+interface ToolOptions {
+  needsApproval?: boolean;
+}
+/**
+* Per-tool overrides for customizing AI SDK `tool()` properties without
+* changing the underlying implementation. Core properties (`execute`,
+* `inputSchema`, `outputSchema`) are intentionally excluded — those drive
+* the tool's behavior and contract and shouldn't be patched at this layer.
+*/
+type ToolOverrides = Partial<Pick<Tool, "description" | "needsApproval" | "onInputAvailable" | "onInputDelta" | "onInputStart" | "providerOptions" | "toModelOutput">>;
+type ListFilesOutput = Awaited<ReturnType<typeof executors.listFiles>>;
+type GetFileMetadataOutput = Awaited<ReturnType<typeof executors.getFileMetadata>>;
+type DownloadFileOutput = Awaited<ReturnType<typeof executors.downloadFile>>;
+type GetFileUrlOutput = Awaited<ReturnType<typeof executors.getFileUrl>>;
+type UploadFileOutput = Awaited<ReturnType<typeof executors.uploadFile>>;
+type DeleteFileOutput = Awaited<ReturnType<typeof executors.deleteFile>>;
+type CopyFileOutput = Awaited<ReturnType<typeof executors.copyFile>>;
+type SignUploadUrlOutput = Awaited<ReturnType<typeof executors.signUploadUrl>>;
+declare const listFiles: (files: Files) => Tool<ListFilesInput, ListFilesOutput>;
+declare const getFileMetadata: (files: Files) => Tool<GetFileMetadataInput, GetFileMetadataOutput>;
+declare const downloadFile: (files: Files) => Tool<DownloadFileInput, DownloadFileOutput>;
+declare const getFileUrl: (files: Files) => Tool<GetFileUrlInput, GetFileUrlOutput>;
+declare const uploadFile: (files: Files, {
+  needsApproval
+}?: ToolOptions) => Tool<UploadFileInput, UploadFileOutput>;
+declare const deleteFile: (files: Files, {
+  needsApproval
+}?: ToolOptions) => Tool<DeleteFileInput, DeleteFileOutput>;
+declare const copyFile: (files: Files, {
+  needsApproval
+}?: ToolOptions) => Tool<CopyFileInput, CopyFileOutput>;
+declare const signUploadUrl: (files: Files, {
+  needsApproval
+}?: ToolOptions) => Tool<SignUploadUrlInput, SignUploadUrlOutput>;
+interface FileToolsOptions {
+  /**
+  * The configured `Files` instance the tools will operate against.
+  * Each tool delegates to the methods on this instance.
+  */
+  files: Files;
+  /**
+  * Per-tool overrides for customizing tool behavior (description, title,
+  * needsApproval, etc.) without changing the underlying implementation.
+  * `execute` and `inputSchema` cannot be overridden.
+  */
+  overrides?: Partial<Record<FileToolName, ToolOverrides>>;
+  /**
+  * When `true`, write tools (`uploadFile`, `deleteFile`, `copyFile`,
+  * `signUploadUrl`) are omitted entirely. The model cannot mutate the
+  * bucket regardless of approval configuration.
+  */
+  readOnly?: boolean;
+  /**
+  * Approval gating for write tools. Defaults to `true` (all writes
+  * require approval). See {@link ApprovalConfig}.
+  */
+  requireApproval?: ApprovalConfig;
+}
+interface FileTools {
+  copyFile: ReturnType<typeof copyFile>;
+  deleteFile: ReturnType<typeof deleteFile>;
+  downloadFile: ReturnType<typeof downloadFile>;
+  getFileMetadata: ReturnType<typeof getFileMetadata>;
+  getFileUrl: ReturnType<typeof getFileUrl>;
+  listFiles: ReturnType<typeof listFiles>;
+  signUploadUrl: ReturnType<typeof signUploadUrl>;
+  uploadFile: ReturnType<typeof uploadFile>;
+}
+type ReadOnlyFileTools = Pick<FileTools, FileReadToolName>;
+/**
+* Create a set of visulima/storage tools for the Vercel AI SDK.
+*
+* Write operations require user approval by default. Control globally or
+* per-tool via `requireApproval`, or strip writes entirely with
+* `readOnly: true`.
+* @example
+* ```ts
+* import { Files } from "@visulima/storage";
+* import { S3Storage } from "@visulima/storage/provider/aws";
+* import { createFileTools } from "@visulima/storage/ai/sdk";
+* import { generateText } from "ai";
+*
+* const files = new Files({ adapter: new S3Storage({ bucket: "uploads" }) });
+*
+* const result = await generateText({
+*   model,
+*   tools: createFileTools({ files }),
+*   prompt: "Find every CSV under reports/ and summarize the latest one.",
+* });
+* ```
+*/
+declare function createFileTools(options: FileToolsOptions & {
+  readOnly: true;
+}): ReadOnlyFileTools;
+declare function createFileTools(options: FileToolsOptions & {
+  readOnly?: false | undefined;
+}): FileTools;
+declare function createFileTools(options: FileToolsOptions): FileTools | ReadOnlyFileTools;
+export { type ApprovalConfig, type FileReadToolName, type FileToolName, FileTools, FileToolsOptions, ReadOnlyFileTools, type ToolOptions, type ToolOverrides, copyFile, createFileTools, deleteFile, downloadFile, getFileMetadata, getFileUrl, listFiles, signUploadUrl, uploadFile };

package/dist/ai/ai-sdk/index.js

@@ -0,0 +1 @@
+var d=Object.defineProperty;var t=(e,l)=>d(e,"name",{value:l,configurable:!0});import{r as c}from"../../packem_shared/approval-BBeX3o4E.js";import{W as f}from"../../packem_shared/executors-DG6hGtvm.js";import{uploadFile as u,signUploadUrl as g,listFiles as v,getFileUrl as m,getFileMetadata as O,downloadFile as U,deleteFile as b,copyFile as j}from"../../packem_shared/listFiles-BtP6VnUp.js";var y=Object.defineProperty,p=t((e,l)=>y(e,"name",{value:l,configurable:!0}),"r");function T({files:e,overrides:l,readOnly:n=!1,requireApproval:F=!0}){const o=p(r=>({needsApproval:c(r,F)}),"approval"),i={copyFile:j(e,o("copyFile")),deleteFile:b(e,o("deleteFile")),downloadFile:U(e),getFileMetadata:O(e),getFileUrl:m(e),listFiles:v(e),signUploadUrl:g(e,o("signUploadUrl")),uploadFile:u(e,o("uploadFile"))};if(l){for(const[r,a]of Object.entries(l))if(r in i&&a){const s=r;Object.assign(i,{[s]:{...i[s],...a}})}}return n?Object.fromEntries(Object.entries(i).filter(([r])=>!f.has(r))):i}t(T,"createFileTools");p(T,"createFileTools");export{j as copyFile,T as createFileTools,b as deleteFile,U as downloadFile,O as getFileMetadata,m as getFileUrl,v as listFiles,g as signUploadUrl,u as uploadFile};

package/dist/ai/claude/index.d.ts

@@ -0,0 +1,177 @@
+import { SdkMcpToolDefinition, CanUseTool, McpSdkServerConfigWithInstance } from '@anthropic-ai/claude-agent-sdk';
+import { F as Files } from "../../packem_shared/index.d-C4Fivh4I.js";
+import { T as TOOL_SCHEMAS, F as FileToolName, A as ApprovalConfig } from "../../packem_shared/approval.d-CMAYH9GF.js";
+export { type c as FileReadToolName, type d as FileWriteToolName } from "../../packem_shared/approval.d-CMAYH9GF.js";
+import "../../packem_shared/storage.d-RteRC-cG.js";
+import 'node:stream';
+import 'node:crypto';
+import 'node:http';
+import 'lru-cache';
+import 'zod';
+/**
+* MCP tool annotations as accepted by `tool()` and exposed on
+* `SdkMcpToolDefinition`. Re-derived from the SDK rather than imported from
+* `@modelcontextprotocol/sdk` directly to avoid taking on a second peer
+* dependency.
+*/
+type ToolAnnotations = NonNullable<SdkMcpToolDefinition["annotations"]>;
+/**
+* Per-tool overrides for `createClaudeFileTools`. `name`, `inputSchema`, and
+* `handler` are intentionally not overridable — the contract that drives tool
+* behavior should not be patched at this layer.
+*/
+interface ClaudeToolOverrides {
+  annotations?: ToolAnnotations;
+  description?: string;
+}
+interface ClaudeWriteToolOptions {
+  annotations?: ToolAnnotations;
+}
+type ListFilesShape = (typeof TOOL_SCHEMAS.listFiles.input)["shape"];
+type GetFileMetadataShape = (typeof TOOL_SCHEMAS.getFileMetadata.input)["shape"];
+type DownloadFileShape = (typeof TOOL_SCHEMAS.downloadFile.input)["shape"];
+type GetFileUrlShape = (typeof TOOL_SCHEMAS.getFileUrl.input)["shape"];
+type UploadFileShape = (typeof TOOL_SCHEMAS.uploadFile.input)["shape"];
+type DeleteFileShape = (typeof TOOL_SCHEMAS.deleteFile.input)["shape"];
+type CopyFileShape = (typeof TOOL_SCHEMAS.copyFile.input)["shape"];
+type SignUploadUrlShape = (typeof TOOL_SCHEMAS.signUploadUrl.input)["shape"];
+declare const claudeListFiles: (files: Files) => SdkMcpToolDefinition<ListFilesShape>;
+declare const claudeGetFileMetadata: (files: Files) => SdkMcpToolDefinition<GetFileMetadataShape>;
+declare const claudeDownloadFile: (files: Files) => SdkMcpToolDefinition<DownloadFileShape>;
+declare const claudeGetFileUrl: (files: Files) => SdkMcpToolDefinition<GetFileUrlShape>;
+declare const claudeUploadFile: (files: Files, {
+  annotations
+}?: ClaudeWriteToolOptions) => SdkMcpToolDefinition<UploadFileShape>;
+declare const claudeDeleteFile: (files: Files, {
+  annotations
+}?: ClaudeWriteToolOptions) => SdkMcpToolDefinition<DeleteFileShape>;
+declare const claudeCopyFile: (files: Files, {
+  annotations
+}?: ClaudeWriteToolOptions) => SdkMcpToolDefinition<CopyFileShape>;
+declare const claudeSignUploadUrl: (files: Files, {
+  annotations
+}?: ClaudeWriteToolOptions) => SdkMcpToolDefinition<SignUploadUrlShape>;
+interface ClaudeFileToolsOptions {
+  /**
+  * The configured `Files` instance the tools will operate against.
+  */
+  files: Files;
+  /**
+  * Per-tool overrides for `description` / `annotations` without touching
+  * the underlying handler or input schema.
+  */
+  overrides?: Partial<Record<FileToolName, ClaudeToolOverrides>>;
+  /**
+  * When `true`, write tools (`uploadFile`, `deleteFile`, `copyFile`,
+  * `signUploadUrl`) are omitted from the MCP server. The model cannot
+  * mutate the bucket regardless of approval configuration.
+  */
+  readOnly?: boolean;
+  /**
+  * Approval gating reflected by {@link ClaudeFileTools.needsApproval} and
+  * the bundled {@link ClaudeFileTools.canUseTool}. Defaults to `true`
+  * (every write requires approval). Pass `false` to disable, or an object
+  * keyed by write-tool name for fine-grained control.
+  */
+  requireApproval?: ApprovalConfig;
+  /**
+  * Name of the in-process MCP server that wraps these tools. Affects the
+  * `mcp__&lt;server-name>__&lt;tool-name>` strings the agent uses to address
+  * each tool. Defaults to `"files"`.
+  */
+  serverName?: string;
+  /**
+  * MCP server `version` metadata. Defaults to `"1.0.0"`.
+  */
+  serverVersion?: string;
+}
+interface ClaudeFileTools {
+  /**
+  * Pass into `query({ options: { allowedTools: tools.allowedTools } })`.
+  * Each entry is of the form `mcp__&lt;serverName>__&lt;toolName>`.
+  */
+  allowedTools: string[];
+  /**
+  * Ready-made `canUseTool` callback. Allows reads unconditionally, allows
+  * writes whose `needsApproval` resolves to `false`, denies the rest with
+  * a `"requires approval"` message. Pass directly into `query()`, or
+  * compose your own using {@link ClaudeFileTools.needsApproval}.
+  */
+  canUseTool: CanUseTool;
+  /**
+  * Pass into `query({ options: { mcpServers: tools.mcpServers } })`.
+  */
+  mcpServers: Record<string, McpSdkServerConfigWithInstance>;
+  /**
+  * Whether the named tool is approval-gated under the configured
+  * `requireApproval`. Accepts both bare names (`"uploadFile"`) and the
+  * MCP-prefixed form (`"mcp__files__uploadFile"`). Read tools and unknown
+  * names return `false`.
+  */
+  needsApproval: (toolName: string) => boolean;
+  /**
+  * The raw SDK MCP server instance — same value as
+  * `mcpServers[serverName]`. Exposed for callers that want to compose it
+  * into a larger `mcpServers` map.
+  */
+  server: McpSdkServerConfigWithInstance;
+  /**
+  * The MCP server name used in the `mcp__&lt;server>__*` prefix.
+  */
+  serverName: string;
+}
+/**
+* Create storage tools shaped for the Claude Agent SDK
+* (`@anthropic-ai/claude-agent-sdk`).
+*
+* The Claude Agent SDK consumes tools by way of an in-process MCP server +
+* an `allowedTools` allow-list + a `canUseTool` approval callback. The
+* returned bundle gives you all three, plus the raw server instance and a
+* `needsApproval()` helper if you want to wire your own `canUseTool`.
+* @example
+* ```ts
+* import { query } from "@anthropic-ai/claude-agent-sdk";
+* import { Files } from "@visulima/storage";
+* import { S3Storage } from "@visulima/storage/provider/aws";
+* import { createClaudeFileTools } from "@visulima/storage/ai/claude";
+*
+* const files = new Files({ adapter: new S3Storage({ bucket: "uploads" }) });
+* const tools = createClaudeFileTools({ files });
+*
+* for await (const message of query({
+*   prompt: "List my files.",
+*   options: {
+*     mcpServers: tools.mcpServers,
+*     allowedTools: tools.allowedTools,
+*     canUseTool: tools.canUseTool,
+*   },
+* })) {
+*   // handle messages
+* }
+* ```
+* @example Read-only agent
+* ```ts
+* createClaudeFileTools({ files, readOnly: true })
+* ```
+* @example Granular approval
+* ```ts
+* createClaudeFileTools({
+*   files,
+*   requireApproval: {
+*     copyFile: false,
+*     deleteFile: true,
+*     signUploadUrl: true,
+*     uploadFile: false,
+*   },
+* })
+* ```
+*/
+declare const createClaudeFileTools: ({
+  files,
+  overrides,
+  readOnly,
+  requireApproval,
+  serverName,
+  serverVersion
+}: ClaudeFileToolsOptions) => ClaudeFileTools;
+export { type ApprovalConfig, ClaudeFileTools, ClaudeFileToolsOptions, type ClaudeToolOverrides, type ClaudeWriteToolOptions, type FileToolName, type ToolAnnotations, claudeCopyFile, claudeDeleteFile, claudeDownloadFile, claudeGetFileMetadata, claudeGetFileUrl, claudeListFiles, claudeSignUploadUrl, claudeUploadFile, createClaudeFileTools };

package/dist/ai/claude/index.js

@@ -0,0 +1 @@
+var _=Object.defineProperty;var u=(l,a)=>_(l,"name",{value:a,configurable:!0});import{createSdkMcpServer as b}from"@anthropic-ai/claude-agent-sdk";import{r as h}from"../../packem_shared/approval-BBeX3o4E.js";import{W as y}from"../../packem_shared/executors-DG6hGtvm.js";import{claudeUploadFile as O,claudeSignUploadUrl as S,claudeListFiles as w,claudeGetFileUrl as A,claudeGetFileMetadata as E,claudeDownloadFile as M,claudeDeleteFile as W,claudeCopyFile as $}from"../../packem_shared/claudeListFiles-DAezbKEi.js";var j=Object.defineProperty,o=u((l,a)=>j(l,"name",{value:a,configurable:!0}),"r");const C="files",D="1.0.0",v=o(l=>y.has(l),"isWriteTool"),I=o(({files:l,overrides:a,readOnly:m=!1,requireApproval:f=!0,serverName:s=C,serverVersion:F=D})=>{const t={copyFile:$(l),deleteFile:W(l),downloadFile:M(l),getFileMetadata:E(l),getFileUrl:A(l),listFiles:w(l),signUploadUrl:S(l),uploadFile:O(l)};if(a){for(const[e,r]of Object.entries(a))if(e in t&&r){const c=e;t[c]={...t[c],...r}}}const i=Object.entries(t).filter(([e])=>!(m&&v(e))),n=`mcp__${s}__`,T=o(e=>e.startsWith(n)?e.slice(n.length):e,"stripPrefix"),U=new Set(i.map(([e])=>e)),p=o(e=>{const r=T(e);return!U.has(r)||!v(r)?!1:h(r,f)},"needsApproval"),g=o((e,r)=>Promise.resolve(p(e)?{behavior:"deny",message:`Tool "${e}" requires approval.`}:{behavior:"allow",updatedInput:r}),"canUseTool"),d=b({name:s,tools:i.map(([,e])=>e),version:F});return{allowedTools:i.map(([e])=>`${n}${e}`),canUseTool:g,mcpServers:{[s]:d},needsApproval:p,server:d,serverName:s}},"createClaudeFileTools");export{$ as claudeCopyFile,W as claudeDeleteFile,M as claudeDownloadFile,E as claudeGetFileMetadata,A as claudeGetFileUrl,w as claudeListFiles,S as claudeSignUploadUrl,O as claudeUploadFile,I as createClaudeFileTools};