@nestm/storage 0.1.0-alpha.5 → 0.1.0-alpha.7

package/dist/ai-sdk/ai-sdk-workspace-tools.js

@@ -0,0 +1,383 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { isStorageWorkspaceError, } from '../workspace/index.js';
+import { StorageErrorCode, isStorageError, } from '../storage.error.js';
+export const AI_SDK_WORKSPACE_TOOL_NAMES = [
+    'workspace_list',
+    'workspace_stat',
+    'workspace_read_file',
+    'workspace_search',
+    'workspace_write_file',
+    'workspace_copy_file',
+    'workspace_move_file',
+    'workspace_delete_file',
+];
+const SAFE_ERROR_MESSAGES = {
+    [StorageErrorCode.NOT_FOUND]: 'The requested workspace path was not found.',
+    [StorageErrorCode.UNAUTHORIZED]: 'This operation is not permitted in the workspace.',
+    [StorageErrorCode.CONFLICT]: 'The operation conflicts with current workspace state. Refresh metadata and retry with the current ETag or a new destination.',
+    [StorageErrorCode.READ_ONLY]: 'This operation is not permitted in the workspace.',
+    [StorageErrorCode.INVALID_ARGUMENT]: 'The workspace tool input was rejected.',
+    [StorageErrorCode.NOT_SUPPORTED]: 'This workspace operation is not supported by the configured storage.',
+    [StorageErrorCode.ABORTED]: 'The workspace operation was aborted.',
+    [StorageErrorCode.TIMEOUT]: 'The workspace operation timed out.',
+    [StorageErrorCode.LIMIT_EXCEEDED]: 'The workspace operation exceeded a configured limit.',
+    [StorageErrorCode.PROVIDER]: 'The workspace operation failed.',
+};
+/**
+ * Safe error exposed at the AI tool boundary. It deliberately carries no
+ * provider error, storage key, mount prefix, store name, or cause.
+ */
+export class AiSdkWorkspaceToolError extends Error {
+    code;
+    constructor(code) {
+        super(SAFE_ERROR_MESSAGES[code]);
+        this.name = 'AiSdkWorkspaceToolError';
+        this.code = code;
+    }
+}
+const mutationToolNames = new Set([
+    'workspace_write_file',
+    'workspace_copy_file',
+    'workspace_move_file',
+    'workspace_delete_file',
+]);
+const utf8Encoder = new TextEncoder();
+const forbiddenUnicodeCharacter = /\p{C}/u;
+const workspaceCursor = /^[A-Za-z0-9_-]{32}$/u;
+const windowsDeviceName = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/iu;
+function isLogicalPath(value) {
+    if (value.length === 0 ||
+        value.startsWith('/') ||
+        value.endsWith('/') ||
+        value !== value.normalize('NFC') ||
+        value.includes('\\') ||
+        forbiddenUnicodeCharacter.test(value)) {
+        return false;
+    }
+    return value
+        .split('/')
+        .every((segment) => segment.length > 0 &&
+        segment !== '.' &&
+        segment !== '..' &&
+        !segment.includes(':') &&
+        !segment.endsWith('.') &&
+        !segment.endsWith(' ') &&
+        !windowsDeviceName.test(segment));
+}
+function logicalPath(label, maxBytes) {
+    return z
+        .string()
+        .min(1)
+        .refine(isLogicalPath, {
+        message: `${label} must be a portable, NFC-normalized, relative POSIX workspace path.`,
+    })
+        .refine((value) => utf8Encoder.encode(value).byteLength <= maxBytes, {
+        message: `${label} exceeds the ${maxBytes}-byte workspace path limit.`,
+    })
+        .describe(`${label}. Use an NFC-normalized relative POSIX path inside the mounted workspace. Empty, dot, parent, colon, trailing dot or space, and Windows reserved device segments are forbidden.`);
+}
+function searchQuery(maxBytes) {
+    return z
+        .string()
+        .min(1)
+        .refine((value) => !value.includes('\\') && !forbiddenUnicodeCharacter.test(value), { message: 'Search query contains forbidden characters.' })
+        .refine((value) => utf8Encoder.encode(value).byteLength <= maxBytes, {
+        message: `Search query exceeds the ${maxBytes}-byte workspace limit.`,
+    })
+        .describe('Path pattern or text to find inside the mounted workspace.');
+}
+function boundedEtag(maxBytes) {
+    return z
+        .string()
+        .min(1)
+        .refine((value) => !forbiddenUnicodeCharacter.test(value), {
+        message: 'ETag contains forbidden characters.',
+    })
+        .refine((value) => utf8Encoder.encode(value).byteLength <= maxBytes, {
+        message: `ETag exceeds the ${maxBytes}-byte workspace limit.`,
+    })
+        .describe('Exact ETag returned by the latest workspace stat or read.');
+}
+function continuationCursor(description) {
+    return z
+        .string()
+        .regex(workspaceCursor, 'Cursor must be the opaque base64url token returned by the workspace.')
+        .optional()
+        .describe(description);
+}
+function positiveIntegerAtMost(maximum, description) {
+    return z
+        .number()
+        .int()
+        .positive()
+        .max(maximum)
+        .optional()
+        .describe(description);
+}
+function operationOptions(signal) {
+    return signal === undefined ? {} : { signal };
+}
+function resolveApproval(toolName, config) {
+    return typeof config === 'boolean' ? config : (config[toolName] ?? true);
+}
+function resolveReadLimit(workspace, requested) {
+    const workspaceLimit = workspace.limits.maxReadBytes;
+    if (!Number.isSafeInteger(workspaceLimit) || workspaceLimit <= 0) {
+        throw new RangeError('workspace.limits.maxReadBytes must be a positive safe integer.');
+    }
+    if (requested !== undefined &&
+        (!Number.isSafeInteger(requested) || requested <= 0)) {
+        throw new RangeError('maxReadBytes must be a positive safe integer.');
+    }
+    return Math.min(requested ?? workspaceLimit, workspaceLimit);
+}
+function sanitizeToolError(error, signal) {
+    if (error instanceof AiSdkWorkspaceToolError) {
+        return error;
+    }
+    if (signal?.aborted === true) {
+        return new AiSdkWorkspaceToolError(StorageErrorCode.ABORTED);
+    }
+    if (isStorageWorkspaceError(error)) {
+        return new AiSdkWorkspaceToolError(error.code);
+    }
+    if (isStorageError(error)) {
+        return new AiSdkWorkspaceToolError(error.code);
+    }
+    return new AiSdkWorkspaceToolError(StorageErrorCode.PROVIDER);
+}
+async function executeSafely(signal, operation) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        throw sanitizeToolError(error, signal);
+    }
+}
+function serializeFile(file) {
+    return {
+        kind: 'file',
+        path: file.path,
+        name: file.name,
+        size: file.size,
+        contentType: file.contentType,
+        ...(file.etag === undefined ? {} : { etag: file.etag }),
+        ...(file.lastModified === undefined
+            ? {}
+            : { lastModified: file.lastModified.toISOString() }),
+    };
+}
+function serializeEntry(entry) {
+    return entry.kind === 'file'
+        ? serializeFile(entry)
+        : { kind: 'directory', path: entry.path, name: entry.name };
+}
+function serializeTextFile(file) {
+    return { ...serializeFile(file), text: file.text };
+}
+function serializePage(page) {
+    return {
+        entries: page.entries.map(serializeEntry),
+        ...(page.cursor === undefined ? {} : { cursor: page.cursor }),
+    };
+}
+/**
+ * Creates Vercel AI SDK tools backed only by a mounted StorageWorkspace.
+ *
+ * A tool is omitted unless the workspace grants its required permission.
+ * The workspace remains the enforcing boundary if a retained tool reference
+ * is invoked after further narrowing.
+ */
+export function createAiSdkWorkspaceTools({ workspace, maxReadBytes: requestedMaxReadBytes, requireApproval = true, }) {
+    const maxReadBytes = resolveReadLimit(workspace, requestedMaxReadBytes);
+    const tools = {};
+    const pathSchema = logicalPath('File path', workspace.limits.maxPathBytes);
+    const directorySchema = logicalPath('Directory path', workspace.limits.maxPathBytes);
+    const etagSchema = boundedEtag(workspace.limits.maxPathBytes);
+    if (workspace.allows('list')) {
+        tools.workspace_list = tool({
+            description: 'List files and directories inside the mounted workspace. Omit directory to list the workspace root.',
+            strict: true,
+            inputSchema: z
+                .object({
+                directory: directorySchema.optional(),
+                recursive: z
+                    .boolean()
+                    .optional()
+                    .describe('Whether to include descendants recursively.'),
+                limit: positiveIntegerAtMost(workspace.limits.maxPageSize, `Maximum entries to return, up to ${workspace.limits.maxPageSize}.`),
+                cursor: continuationCursor('Opaque one-use cursor returned by the preceding list call. Repeat the same directory, recursive, and limit options when continuing.'),
+            })
+                .strict(),
+            execute: (input, { abortSignal }) => executeSafely(abortSignal, async () => serializePage(await workspace.list({
+                ...(input.directory === undefined
+                    ? {}
+                    : { directory: input.directory }),
+                ...(input.recursive === undefined
+                    ? {}
+                    : { recursive: input.recursive }),
+                ...(input.limit === undefined ? {} : { limit: input.limit }),
+                ...(input.cursor === undefined ? {} : { cursor: input.cursor }),
+                ...operationOptions(abortSignal),
+            }))),
+        });
+    }
+    if (workspace.allows('read')) {
+        tools.workspace_stat = tool({
+            description: 'Inspect a file inside the mounted workspace without reading its contents. Returns the ETag required for safe replace, move, and delete operations.',
+            strict: true,
+            inputSchema: z.object({ path: pathSchema }).strict(),
+            execute: ({ path }, { abortSignal }) => executeSafely(abortSignal, async () => serializeFile(await workspace.stat(path, operationOptions(abortSignal)))),
+        });
+        tools.workspace_read_file = tool({
+            description: `Read a UTF-8 text file inside the mounted workspace. The result is bounded to ${maxReadBytes} bytes.`,
+            strict: true,
+            inputSchema: z.object({ path: pathSchema }).strict(),
+            execute: ({ path }, { abortSignal }) => executeSafely(abortSignal, async () => serializeTextFile(await workspace.readText(path, {
+                maxBytes: maxReadBytes,
+                ...operationOptions(abortSignal),
+            }))),
+        });
+    }
+    if (workspace.allows('search')) {
+        tools.workspace_search = tool({
+            description: 'Search logical paths inside the mounted workspace using a bounded glob, substring, or exact match. Omit directory to search from the workspace root.',
+            strict: true,
+            inputSchema: z
+                .object({
+                query: searchQuery(workspace.limits.maxPathBytes),
+                directory: directorySchema.optional(),
+                match: z
+                    .enum(['glob', 'substring', 'exact'])
+                    .optional()
+                    .describe('Matching strategy; defaults to glob.'),
+                caseInsensitive: z.boolean().optional(),
+                limit: positiveIntegerAtMost(workspace.limits.maxSearchResults, `Maximum matches to return, up to ${workspace.limits.maxSearchResults}.`),
+                cursor: continuationCursor('Opaque one-use cursor returned by the preceding search call. Repeat the same query, directory, match, caseInsensitive, and limit options when continuing.'),
+            })
+                .strict(),
+            execute: ({ query, directory, match, caseInsensitive, limit, cursor }, { abortSignal }) => executeSafely(abortSignal, async () => serializePage(await workspace.search(query, {
+                ...(directory === undefined ? {} : { directory }),
+                ...(match === undefined ? {} : { match }),
+                ...(caseInsensitive === undefined ? {} : { caseInsensitive }),
+                ...(limit === undefined ? {} : { limit }),
+                ...(cursor === undefined ? {} : { cursor }),
+                ...operationOptions(abortSignal),
+            }))),
+        });
+    }
+    const canCreate = workspace.allows('create');
+    const canReplace = workspace.allows('replace');
+    if (canCreate || canReplace) {
+        const commonWriteShape = {
+            path: pathSchema,
+            content: z
+                .string()
+                .refine((value) => utf8Encoder.encode(value).byteLength <=
+                workspace.limits.maxWriteBytes, {
+                message: `Content exceeds the ${workspace.limits.maxWriteBytes}-byte workspace write limit.`,
+            })
+                .describe(`UTF-8 text to write. The workspace enforces its ${workspace.limits.maxWriteBytes}-byte write limit.`),
+        };
+        const createSchema = z
+            .object({ ...commonWriteShape, mode: z.literal('create') })
+            .strict();
+        const replaceSchema = z
+            .object({
+            ...commonWriteShape,
+            mode: z.literal('replace'),
+            etag: etagSchema,
+        })
+            .strict();
+        const inputSchema = canCreate && canReplace
+            ? z.discriminatedUnion('mode', [createSchema, replaceSchema])
+            : canCreate
+                ? createSchema
+                : replaceSchema;
+        tools.workspace_write_file = tool({
+            description: canCreate && canReplace
+                ? 'Create a new UTF-8 text file or replace an existing file inside the mounted workspace. Create fails if the destination exists; replace requires its current ETag.'
+                : canCreate
+                    ? 'Create a new UTF-8 text file inside the mounted workspace. The operation fails if the destination already exists.'
+                    : 'Replace an existing UTF-8 text file inside the mounted workspace using its current ETag.',
+            strict: true,
+            inputSchema,
+            needsApproval: resolveApproval('workspace_write_file', requireApproval),
+            execute: (input, { abortSignal }) => executeSafely(abortSignal, async () => serializeFile(input.mode === 'create'
+                ? await workspace.writeFile(input.path, input.content, {
+                    mode: 'create',
+                    ...operationOptions(abortSignal),
+                })
+                : await workspace.writeFile(input.path, input.content, {
+                    mode: 'replace',
+                    etag: input.etag,
+                    ...operationOptions(abortSignal),
+                }))),
+        });
+    }
+    const canCopy = workspace.allows('copy') &&
+        workspace.allows('read') &&
+        workspace.allows('create');
+    if (canCopy) {
+        tools.workspace_copy_file = tool({
+            description: 'Copy a file inside the mounted workspace. The source remains intact, and the operation fails if the destination already exists.',
+            strict: true,
+            inputSchema: z
+                .object({
+                source: logicalPath('Source file path', workspace.limits.maxPathBytes),
+                destination: logicalPath('Destination file path', workspace.limits.maxPathBytes),
+            })
+                .strict(),
+            needsApproval: resolveApproval('workspace_copy_file', requireApproval),
+            execute: ({ source, destination }, { abortSignal }) => executeSafely(abortSignal, async () => serializeFile(await workspace.copyFile(source, destination, operationOptions(abortSignal)))),
+        });
+    }
+    const canMove = workspace.allows('move') &&
+        workspace.allows('read') &&
+        workspace.allows('create') &&
+        workspace.allows('delete');
+    if (canMove) {
+        tools.workspace_move_file = tool({
+            description: "Move a file inside the mounted workspace using the source's current ETag. The operation fails if the destination already exists. If source deletion cannot be confirmed, the destination is retained and the tool reports a conflict; inspect both paths before retrying.",
+            strict: true,
+            inputSchema: z
+                .object({
+                source: logicalPath('Source file path', workspace.limits.maxPathBytes),
+                destination: logicalPath('Destination file path', workspace.limits.maxPathBytes),
+                etag: etagSchema.describe('Exact ETag of the source returned by the latest workspace stat or read.'),
+            })
+                .strict(),
+            needsApproval: resolveApproval('workspace_move_file', requireApproval),
+            execute: ({ source, destination, etag }, { abortSignal }) => executeSafely(abortSignal, async () => serializeFile(await workspace.moveFile(source, destination, {
+                etag,
+                ...operationOptions(abortSignal),
+            }))),
+        });
+    }
+    if (workspace.allows('delete')) {
+        tools.workspace_delete_file = tool({
+            description: 'Delete a file inside the mounted workspace using its current ETag.',
+            strict: true,
+            inputSchema: z
+                .object({
+                path: pathSchema,
+                etag: etagSchema,
+            })
+                .strict(),
+            needsApproval: resolveApproval('workspace_delete_file', requireApproval),
+            execute: ({ path, etag }, { abortSignal }) => executeSafely(abortSignal, async () => {
+                await workspace.deleteFile(path, {
+                    etag,
+                    ...operationOptions(abortSignal),
+                });
+                return { deleted: true, path };
+            }),
+        });
+    }
+    return tools;
+}
+export function isAiSdkWorkspaceMutationToolName(value) {
+    return mutationToolNames.has(value);
+}
+//# sourceMappingURL=ai-sdk-workspace-tools.js.map

package/dist/ai-sdk/ai-sdk-workspace-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk-workspace-tools.js","sourceRoot":"","sources":["../../src/ai-sdk/ai-sdk-workspace-tools.ts"],"names":[],"mappings":"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","sourcesContent":["import { tool, type ToolSet } from 'ai';\nimport { z } from 'zod';\n\nimport {\n  isStorageWorkspaceError,\n  type StorageWorkspace,\n  type StorageWorkspaceEntry,\n  type StorageWorkspaceFile,\n  type StorageWorkspaceTextFile,\n} from '../workspace/index.js';\nimport {\n  StorageErrorCode,\n  isStorageError,\n  type StorageErrorCode as StorageErrorCodeValue,\n} from '../storage.error.js';\n\nexport const AI_SDK_WORKSPACE_TOOL_NAMES = [\n  'workspace_list',\n  'workspace_stat',\n  'workspace_read_file',\n  'workspace_search',\n  'workspace_write_file',\n  'workspace_copy_file',\n  'workspace_move_file',\n  'workspace_delete_file',\n] as const;\n\nexport type AiSdkWorkspaceToolName =\n  (typeof AI_SDK_WORKSPACE_TOOL_NAMES)[number];\n\nexport type AiSdkWorkspaceMutationToolName = Extract<\n  AiSdkWorkspaceToolName,\n  | 'workspace_write_file'\n  | 'workspace_copy_file'\n  | 'workspace_move_file'\n  | 'workspace_delete_file'\n>;\n\n/**\n * Approval policy for mutation tools. An omitted entry defaults to requiring\n * approval, matching an omitted policy.\n */\nexport type AiSdkWorkspaceApprovalConfig =\n  boolean | Partial<Record<AiSdkWorkspaceMutationToolName, boolean>>;\n\nexport interface CreateAiSdkWorkspaceToolsOptions {\n  /** The already-mounted, policy-enforcing workspace exposed to the tools. */\n  workspace: StorageWorkspace;\n  /**\n   * Optional tighter read ceiling. Values above the workspace ceiling are\n   * clamped; the model cannot choose or raise this value.\n   */\n  maxReadBytes?: number;\n  /** Mutation tools require approval by default. */\n  requireApproval?: AiSdkWorkspaceApprovalConfig;\n}\n\nexport type AiSdkWorkspaceToolErrorCode = StorageErrorCodeValue;\n\nconst SAFE_ERROR_MESSAGES: Readonly<\n  Record<AiSdkWorkspaceToolErrorCode, string>\n> = {\n  [StorageErrorCode.NOT_FOUND]: 'The requested workspace path was not found.',\n  [StorageErrorCode.UNAUTHORIZED]:\n    'This operation is not permitted in the workspace.',\n  [StorageErrorCode.CONFLICT]:\n    'The operation conflicts with current workspace state. Refresh metadata and retry with the current ETag or a new destination.',\n  [StorageErrorCode.READ_ONLY]:\n    'This operation is not permitted in the workspace.',\n  [StorageErrorCode.INVALID_ARGUMENT]: 'The workspace tool input was rejected.',\n  [StorageErrorCode.NOT_SUPPORTED]:\n    'This workspace operation is not supported by the configured storage.',\n  [StorageErrorCode.ABORTED]: 'The workspace operation was aborted.',\n  [StorageErrorCode.TIMEOUT]: 'The workspace operation timed out.',\n  [StorageErrorCode.LIMIT_EXCEEDED]:\n    'The workspace operation exceeded a configured limit.',\n  [StorageErrorCode.PROVIDER]: 'The workspace operation failed.',\n};\n\n/**\n * Safe error exposed at the AI tool boundary. It deliberately carries no\n * provider error, storage key, mount prefix, store name, or cause.\n */\nexport class AiSdkWorkspaceToolError extends Error {\n  readonly code: AiSdkWorkspaceToolErrorCode;\n\n  constructor(code: AiSdkWorkspaceToolErrorCode) {\n    super(SAFE_ERROR_MESSAGES[code]);\n    this.name = 'AiSdkWorkspaceToolError';\n    this.code = code;\n  }\n}\n\nexport interface AiSdkWorkspaceFileResult {\n  kind: 'file';\n  path: string;\n  name: string;\n  size: number;\n  contentType: string;\n  etag?: string;\n  lastModified?: string;\n}\n\nexport interface AiSdkWorkspaceDirectoryResult {\n  kind: 'directory';\n  path: string;\n  name: string;\n}\n\nexport type AiSdkWorkspaceEntryResult =\n  AiSdkWorkspaceFileResult | AiSdkWorkspaceDirectoryResult;\n\nexport interface AiSdkWorkspaceTextFileResult extends AiSdkWorkspaceFileResult {\n  text: string;\n}\n\nexport interface AiSdkWorkspacePageResult {\n  entries: AiSdkWorkspaceEntryResult[];\n  cursor?: string;\n}\n\nconst mutationToolNames = new Set<AiSdkWorkspaceMutationToolName>([\n  'workspace_write_file',\n  'workspace_copy_file',\n  'workspace_move_file',\n  'workspace_delete_file',\n]);\nconst utf8Encoder = new TextEncoder();\nconst forbiddenUnicodeCharacter = /\\p{C}/u;\nconst workspaceCursor = /^[A-Za-z0-9_-]{32}$/u;\nconst windowsDeviceName = /^(?:con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\\..*)?$/iu;\n\nfunction isLogicalPath(value: string): boolean {\n  if (\n    value.length === 0 ||\n    value.startsWith('/') ||\n    value.endsWith('/') ||\n    value !== value.normalize('NFC') ||\n    value.includes('\\\\') ||\n    forbiddenUnicodeCharacter.test(value)\n  ) {\n    return false;\n  }\n\n  return value\n    .split('/')\n    .every(\n      (segment) =>\n        segment.length > 0 &&\n        segment !== '.' &&\n        segment !== '..' &&\n        !segment.includes(':') &&\n        !segment.endsWith('.') &&\n        !segment.endsWith(' ') &&\n        !windowsDeviceName.test(segment),\n    );\n}\n\nfunction logicalPath(label: string, maxBytes: number) {\n  return z\n    .string()\n    .min(1)\n    .refine(isLogicalPath, {\n      message: `${label} must be a portable, NFC-normalized, relative POSIX workspace path.`,\n    })\n    .refine((value) => utf8Encoder.encode(value).byteLength <= maxBytes, {\n      message: `${label} exceeds the ${maxBytes}-byte workspace path limit.`,\n    })\n    .describe(\n      `${label}. Use an NFC-normalized relative POSIX path inside the mounted workspace. Empty, dot, parent, colon, trailing dot or space, and Windows reserved device segments are forbidden.`,\n    );\n}\n\nfunction searchQuery(maxBytes: number) {\n  return z\n    .string()\n    .min(1)\n    .refine(\n      (value) =>\n        !value.includes('\\\\') && !forbiddenUnicodeCharacter.test(value),\n      { message: 'Search query contains forbidden characters.' },\n    )\n    .refine((value) => utf8Encoder.encode(value).byteLength <= maxBytes, {\n      message: `Search query exceeds the ${maxBytes}-byte workspace limit.`,\n    })\n    .describe('Path pattern or text to find inside the mounted workspace.');\n}\n\nfunction boundedEtag(maxBytes: number) {\n  return z\n    .string()\n    .min(1)\n    .refine((value) => !forbiddenUnicodeCharacter.test(value), {\n      message: 'ETag contains forbidden characters.',\n    })\n    .refine((value) => utf8Encoder.encode(value).byteLength <= maxBytes, {\n      message: `ETag exceeds the ${maxBytes}-byte workspace limit.`,\n    })\n    .describe('Exact ETag returned by the latest workspace stat or read.');\n}\n\nfunction continuationCursor(description: string) {\n  return z\n    .string()\n    .regex(\n      workspaceCursor,\n      'Cursor must be the opaque base64url token returned by the workspace.',\n    )\n    .optional()\n    .describe(description);\n}\n\nfunction positiveIntegerAtMost(maximum: number, description: string) {\n  return z\n    .number()\n    .int()\n    .positive()\n    .max(maximum)\n    .optional()\n    .describe(description);\n}\n\nfunction operationOptions(signal: AbortSignal | undefined): {\n  signal?: AbortSignal;\n} {\n  return signal === undefined ? {} : { signal };\n}\n\nfunction resolveApproval(\n  toolName: AiSdkWorkspaceMutationToolName,\n  config: AiSdkWorkspaceApprovalConfig,\n): boolean {\n  return typeof config === 'boolean' ? config : (config[toolName] ?? true);\n}\n\nfunction resolveReadLimit(\n  workspace: StorageWorkspace,\n  requested: number | undefined,\n): number {\n  const workspaceLimit = workspace.limits.maxReadBytes;\n  if (!Number.isSafeInteger(workspaceLimit) || workspaceLimit <= 0) {\n    throw new RangeError(\n      'workspace.limits.maxReadBytes must be a positive safe integer.',\n    );\n  }\n  if (\n    requested !== undefined &&\n    (!Number.isSafeInteger(requested) || requested <= 0)\n  ) {\n    throw new RangeError('maxReadBytes must be a positive safe integer.');\n  }\n  return Math.min(requested ?? workspaceLimit, workspaceLimit);\n}\n\nfunction sanitizeToolError(\n  error: unknown,\n  signal: AbortSignal | undefined,\n): AiSdkWorkspaceToolError {\n  if (error instanceof AiSdkWorkspaceToolError) {\n    return error;\n  }\n  if (signal?.aborted === true) {\n    return new AiSdkWorkspaceToolError(StorageErrorCode.ABORTED);\n  }\n  if (isStorageWorkspaceError(error)) {\n    return new AiSdkWorkspaceToolError(error.code);\n  }\n  if (isStorageError(error)) {\n    return new AiSdkWorkspaceToolError(error.code);\n  }\n  return new AiSdkWorkspaceToolError(StorageErrorCode.PROVIDER);\n}\n\nasync function executeSafely<Result>(\n  signal: AbortSignal | undefined,\n  operation: () => Promise<Result>,\n): Promise<Result> {\n  try {\n    return await operation();\n  } catch (error) {\n    throw sanitizeToolError(error, signal);\n  }\n}\n\nfunction serializeFile(file: StorageWorkspaceFile): AiSdkWorkspaceFileResult {\n  return {\n    kind: 'file',\n    path: file.path,\n    name: file.name,\n    size: file.size,\n    contentType: file.contentType,\n    ...(file.etag === undefined ? {} : { etag: file.etag }),\n    ...(file.lastModified === undefined\n      ? {}\n      : { lastModified: file.lastModified.toISOString() }),\n  };\n}\n\nfunction serializeEntry(\n  entry: StorageWorkspaceEntry,\n): AiSdkWorkspaceEntryResult {\n  return entry.kind === 'file'\n    ? serializeFile(entry)\n    : { kind: 'directory', path: entry.path, name: entry.name };\n}\n\nfunction serializeTextFile(\n  file: StorageWorkspaceTextFile,\n): AiSdkWorkspaceTextFileResult {\n  return { ...serializeFile(file), text: file.text };\n}\n\nfunction serializePage(page: {\n  entries: StorageWorkspaceEntry[];\n  cursor?: string;\n}): AiSdkWorkspacePageResult {\n  return {\n    entries: page.entries.map(serializeEntry),\n    ...(page.cursor === undefined ? {} : { cursor: page.cursor }),\n  };\n}\n\n/**\n * Creates Vercel AI SDK tools backed only by a mounted StorageWorkspace.\n *\n * A tool is omitted unless the workspace grants its required permission.\n * The workspace remains the enforcing boundary if a retained tool reference\n * is invoked after further narrowing.\n */\nexport function createAiSdkWorkspaceTools({\n  workspace,\n  maxReadBytes: requestedMaxReadBytes,\n  requireApproval = true,\n}: CreateAiSdkWorkspaceToolsOptions): ToolSet {\n  const maxReadBytes = resolveReadLimit(workspace, requestedMaxReadBytes);\n  const tools: ToolSet = {};\n  const pathSchema = logicalPath('File path', workspace.limits.maxPathBytes);\n  const directorySchema = logicalPath(\n    'Directory path',\n    workspace.limits.maxPathBytes,\n  );\n  const etagSchema = boundedEtag(workspace.limits.maxPathBytes);\n\n  if (workspace.allows('list')) {\n    tools.workspace_list = tool({\n      description:\n        'List files and directories inside the mounted workspace. Omit directory to list the workspace root.',\n      strict: true,\n      inputSchema: z\n        .object({\n          directory: directorySchema.optional(),\n          recursive: z\n            .boolean()\n            .optional()\n            .describe('Whether to include descendants recursively.'),\n          limit: positiveIntegerAtMost(\n            workspace.limits.maxPageSize,\n            `Maximum entries to return, up to ${workspace.limits.maxPageSize}.`,\n          ),\n          cursor: continuationCursor(\n            'Opaque one-use cursor returned by the preceding list call. Repeat the same directory, recursive, and limit options when continuing.',\n          ),\n        })\n        .strict(),\n      execute: (input, { abortSignal }) =>\n        executeSafely(abortSignal, async () =>\n          serializePage(\n            await workspace.list({\n              ...(input.directory === undefined\n                ? {}\n                : { directory: input.directory }),\n              ...(input.recursive === undefined\n                ? {}\n                : { recursive: input.recursive }),\n              ...(input.limit === undefined ? {} : { limit: input.limit }),\n              ...(input.cursor === undefined ? {} : { cursor: input.cursor }),\n              ...operationOptions(abortSignal),\n            }),\n          ),\n        ),\n    });\n  }\n\n  if (workspace.allows('read')) {\n    tools.workspace_stat = tool({\n      description:\n        'Inspect a file inside the mounted workspace without reading its contents. Returns the ETag required for safe replace, move, and delete operations.',\n      strict: true,\n      inputSchema: z.object({ path: pathSchema }).strict(),\n      execute: ({ path }, { abortSignal }) =>\n        executeSafely(abortSignal, async () =>\n          serializeFile(\n            await workspace.stat(path, operationOptions(abortSignal)),\n          ),\n        ),\n    });\n\n    tools.workspace_read_file = tool({\n      description: `Read a UTF-8 text file inside the mounted workspace. The result is bounded to ${maxReadBytes} bytes.`,\n      strict: true,\n      inputSchema: z.object({ path: pathSchema }).strict(),\n      execute: ({ path }, { abortSignal }) =>\n        executeSafely(abortSignal, async () =>\n          serializeTextFile(\n            await workspace.readText(path, {\n              maxBytes: maxReadBytes,\n              ...operationOptions(abortSignal),\n            }),\n          ),\n        ),\n    });\n  }\n\n  if (workspace.allows('search')) {\n    tools.workspace_search = tool({\n      description:\n        'Search logical paths inside the mounted workspace using a bounded glob, substring, or exact match. Omit directory to search from the workspace root.',\n      strict: true,\n      inputSchema: z\n        .object({\n          query: searchQuery(workspace.limits.maxPathBytes),\n          directory: directorySchema.optional(),\n          match: z\n            .enum(['glob', 'substring', 'exact'])\n            .optional()\n            .describe('Matching strategy; defaults to glob.'),\n          caseInsensitive: z.boolean().optional(),\n          limit: positiveIntegerAtMost(\n            workspace.limits.maxSearchResults,\n            `Maximum matches to return, up to ${workspace.limits.maxSearchResults}.`,\n          ),\n          cursor: continuationCursor(\n            'Opaque one-use cursor returned by the preceding search call. Repeat the same query, directory, match, caseInsensitive, and limit options when continuing.',\n          ),\n        })\n        .strict(),\n      execute: (\n        { query, directory, match, caseInsensitive, limit, cursor },\n        { abortSignal },\n      ) =>\n        executeSafely(abortSignal, async () =>\n          serializePage(\n            await workspace.search(query, {\n              ...(directory === undefined ? {} : { directory }),\n              ...(match === undefined ? {} : { match }),\n              ...(caseInsensitive === undefined ? {} : { caseInsensitive }),\n              ...(limit === undefined ? {} : { limit }),\n              ...(cursor === undefined ? {} : { cursor }),\n              ...operationOptions(abortSignal),\n            }),\n          ),\n        ),\n    });\n  }\n\n  const canCreate = workspace.allows('create');\n  const canReplace = workspace.allows('replace');\n  if (canCreate || canReplace) {\n    const commonWriteShape = {\n      path: pathSchema,\n      content: z\n        .string()\n        .refine(\n          (value) =>\n            utf8Encoder.encode(value).byteLength <=\n            workspace.limits.maxWriteBytes,\n          {\n            message: `Content exceeds the ${workspace.limits.maxWriteBytes}-byte workspace write limit.`,\n          },\n        )\n        .describe(\n          `UTF-8 text to write. The workspace enforces its ${workspace.limits.maxWriteBytes}-byte write limit.`,\n        ),\n    };\n    const createSchema = z\n      .object({ ...commonWriteShape, mode: z.literal('create') })\n      .strict();\n    const replaceSchema = z\n      .object({\n        ...commonWriteShape,\n        mode: z.literal('replace'),\n        etag: etagSchema,\n      })\n      .strict();\n    const inputSchema =\n      canCreate && canReplace\n        ? z.discriminatedUnion('mode', [createSchema, replaceSchema])\n        : canCreate\n          ? createSchema\n          : replaceSchema;\n\n    tools.workspace_write_file = tool({\n      description:\n        canCreate && canReplace\n          ? 'Create a new UTF-8 text file or replace an existing file inside the mounted workspace. Create fails if the destination exists; replace requires its current ETag.'\n          : canCreate\n            ? 'Create a new UTF-8 text file inside the mounted workspace. The operation fails if the destination already exists.'\n            : 'Replace an existing UTF-8 text file inside the mounted workspace using its current ETag.',\n      strict: true,\n      inputSchema,\n      needsApproval: resolveApproval('workspace_write_file', requireApproval),\n      execute: (input, { abortSignal }) =>\n        executeSafely(abortSignal, async () =>\n          serializeFile(\n            input.mode === 'create'\n              ? await workspace.writeFile(input.path, input.content, {\n                  mode: 'create',\n                  ...operationOptions(abortSignal),\n                })\n              : await workspace.writeFile(input.path, input.content, {\n                  mode: 'replace',\n                  etag: input.etag,\n                  ...operationOptions(abortSignal),\n                }),\n          ),\n        ),\n    });\n  }\n\n  const canCopy =\n    workspace.allows('copy') &&\n    workspace.allows('read') &&\n    workspace.allows('create');\n  if (canCopy) {\n    tools.workspace_copy_file = tool({\n      description:\n        'Copy a file inside the mounted workspace. The source remains intact, and the operation fails if the destination already exists.',\n      strict: true,\n      inputSchema: z\n        .object({\n          source: logicalPath(\n            'Source file path',\n            workspace.limits.maxPathBytes,\n          ),\n          destination: logicalPath(\n            'Destination file path',\n            workspace.limits.maxPathBytes,\n          ),\n        })\n        .strict(),\n      needsApproval: resolveApproval('workspace_copy_file', requireApproval),\n      execute: ({ source, destination }, { abortSignal }) =>\n        executeSafely(abortSignal, async () =>\n          serializeFile(\n            await workspace.copyFile(\n              source,\n              destination,\n              operationOptions(abortSignal),\n            ),\n          ),\n        ),\n    });\n  }\n\n  const canMove =\n    workspace.allows('move') &&\n    workspace.allows('read') &&\n    workspace.allows('create') &&\n    workspace.allows('delete');\n  if (canMove) {\n    tools.workspace_move_file = tool({\n      description:\n        \"Move a file inside the mounted workspace using the source's current ETag. The operation fails if the destination already exists. If source deletion cannot be confirmed, the destination is retained and the tool reports a conflict; inspect both paths before retrying.\",\n      strict: true,\n      inputSchema: z\n        .object({\n          source: logicalPath(\n            'Source file path',\n            workspace.limits.maxPathBytes,\n          ),\n          destination: logicalPath(\n            'Destination file path',\n            workspace.limits.maxPathBytes,\n          ),\n          etag: etagSchema.describe(\n            'Exact ETag of the source returned by the latest workspace stat or read.',\n          ),\n        })\n        .strict(),\n      needsApproval: resolveApproval('workspace_move_file', requireApproval),\n      execute: ({ source, destination, etag }, { abortSignal }) =>\n        executeSafely(abortSignal, async () =>\n          serializeFile(\n            await workspace.moveFile(source, destination, {\n              etag,\n              ...operationOptions(abortSignal),\n            }),\n          ),\n        ),\n    });\n  }\n\n  if (workspace.allows('delete')) {\n    tools.workspace_delete_file = tool({\n      description:\n        'Delete a file inside the mounted workspace using its current ETag.',\n      strict: true,\n      inputSchema: z\n        .object({\n          path: pathSchema,\n          etag: etagSchema,\n        })\n        .strict(),\n      needsApproval: resolveApproval('workspace_delete_file', requireApproval),\n      execute: ({ path, etag }, { abortSignal }) =>\n        executeSafely(abortSignal, async () => {\n          await workspace.deleteFile(path, {\n            etag,\n            ...operationOptions(abortSignal),\n          });\n          return { deleted: true as const, path };\n        }),\n    });\n  }\n\n  return tools;\n}\n\nexport function isAiSdkWorkspaceMutationToolName(\n  value: string,\n): value is AiSdkWorkspaceMutationToolName {\n  return mutationToolNames.has(value as AiSdkWorkspaceMutationToolName);\n}\n"]}

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

@@ -0,0 +1,2 @@
+export { AI_SDK_WORKSPACE_TOOL_NAMES, AiSdkWorkspaceToolError, createAiSdkWorkspaceTools, isAiSdkWorkspaceMutationToolName, type AiSdkWorkspaceApprovalConfig, type AiSdkWorkspaceDirectoryResult, type AiSdkWorkspaceEntryResult, type AiSdkWorkspaceFileResult, type AiSdkWorkspaceMutationToolName, type AiSdkWorkspacePageResult, type AiSdkWorkspaceTextFileResult, type AiSdkWorkspaceToolErrorCode, type AiSdkWorkspaceToolName, type CreateAiSdkWorkspaceToolsOptions, } from './ai-sdk-workspace-tools.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai-sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,yBAAyB,EACzB,gCAAgC,EAChC,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,8BAA8B,EACnC,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,sBAAsB,EAC3B,KAAK,gCAAgC,GACtC,MAAM,6BAA6B,CAAC"}

package/dist/ai-sdk/index.js

@@ -0,0 +1,2 @@
+export { AI_SDK_WORKSPACE_TOOL_NAMES, AiSdkWorkspaceToolError, createAiSdkWorkspaceTools, isAiSdkWorkspaceMutationToolName, } from './ai-sdk-workspace-tools.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai-sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,uBAAuB,EACvB,yBAAyB,EACzB,gCAAgC,GAWjC,MAAM,6BAA6B,CAAC","sourcesContent":["export {\n  AI_SDK_WORKSPACE_TOOL_NAMES,\n  AiSdkWorkspaceToolError,\n  createAiSdkWorkspaceTools,\n  isAiSdkWorkspaceMutationToolName,\n  type AiSdkWorkspaceApprovalConfig,\n  type AiSdkWorkspaceDirectoryResult,\n  type AiSdkWorkspaceEntryResult,\n  type AiSdkWorkspaceFileResult,\n  type AiSdkWorkspaceMutationToolName,\n  type AiSdkWorkspacePageResult,\n  type AiSdkWorkspaceTextFileResult,\n  type AiSdkWorkspaceToolErrorCode,\n  type AiSdkWorkspaceToolName,\n  type CreateAiSdkWorkspaceToolsOptions,\n} from './ai-sdk-workspace-tools.js';\n"]}

package/dist/files-sdk/files-sdk.driver.d.ts

@@ -1,7 +1,7 @@
-import { type Adapter, type FilesOptions } from 'files-sdk';
+import { type Adapter, type Body, type FilesOptions } from 'files-sdk';
 import { StorageError } from '../storage.error.js';
 import type { StorageDriver } from '../storage.driver.js';
-import type { StorageBody, StorageDownloadOptions, StorageListOptions, StorageListResult, StorageObject, StorageObjectMetadata, StorageOperationOptions, StorageConditionalCopyCapability, StoragePromotionOptions, StorageSearchOptions, StorageSignedUploadPolicyCapability, StorageSignedDownloadPolicyCapability, StorageSignedDownloadOptions, StorageSignedUpload, StorageSignedUploadOptions, StorageUploadOptions, StorageUploadResult } from '../storage.types.js';
+import type { StorageBody, StorageConditionalDeleteOptions, StorageConditionalMutationCapability, StorageConditionalUploadOptions, StorageDownloadOptions, StorageListOptions, StorageListResult, StorageObject, StorageObjectMetadata, StorageOperationOptions, StorageConditionalCopyCapability, StoragePromotionOptions, StorageSearchOptions, StorageSignedUploadPolicyCapability, StorageSignedDownloadPolicyCapability, StorageSignedDownloadOptions, StorageSignedUpload, StorageSignedUploadOptions, StorageUploadOptions, StorageUploadResult } from '../storage.types.js';
 export type FilesSdkDriverOptions<AdapterType extends Adapter> = FilesOptions<AdapterType>;
 /**
  * Optional adapter extension for providers that can conditionally copy an
@@ -11,6 +11,12 @@ export interface FilesSdkConditionalCopyAdapter {
     readonly conditionalCopy: StorageConditionalCopyCapability;
     promote(sourceKey: string, destinationKey: string, options: StoragePromotionOptions): Promise<void>;
 }
+/** Optional adapter extension for native compare-and-set mutations. */
+export interface FilesSdkConditionalMutationAdapter {
+    readonly conditionalMutation: StorageConditionalMutationCapability;
+    uploadConditional(key: string, body: Body, options: StorageConditionalUploadOptions): Promise<StorageUploadResult>;
+    deleteConditional(key: string, options: StorageConditionalDeleteOptions): Promise<void>;
+}
 export interface FilesSdkSignedUploadPolicyAdapter {
     readonly signedUploadPolicy: StorageSignedUploadPolicyCapability;
 }
@@ -34,6 +40,12 @@ export declare class FilesSdkStorageDriver<AdapterType extends Adapter = Adapter
             etag: boolean;
             version: boolean;
         };
+        conditionalMutation?: {
+            create: boolean;
+            replace: boolean;
+            delete: boolean;
+            etag: boolean;
+        };
         signedDownload: {
             supported: boolean;
             maxExpiresIn?: number;
@@ -49,10 +61,12 @@ export declare class FilesSdkStorageDriver<AdapterType extends Adapter = Adapter
         nativeUploadProgress: boolean;
     };
     upload(key: string, body: StorageBody, options?: StorageUploadOptions): Promise<StorageUploadResult>;
+    uploadConditional(key: string, body: StorageBody, options: StorageConditionalUploadOptions): Promise<StorageUploadResult>;
     download(key: string, options?: StorageDownloadOptions): Promise<StorageObject>;
     head(key: string, options?: StorageOperationOptions): Promise<StorageObjectMetadata>;
     exists(key: string, options?: StorageOperationOptions): Promise<boolean>;
     delete(key: string, options?: StorageOperationOptions): Promise<void>;
+    deleteConditional(key: string, options: StorageConditionalDeleteOptions): Promise<void>;
     copy(sourceKey: string, destinationKey: string, options?: StorageOperationOptions): Promise<void>;
     move(sourceKey: string, destinationKey: string, options?: StorageOperationOptions): Promise<void>;
     promote(sourceKey: string, destinationKey: string, options: StoragePromotionOptions): Promise<void>;

package/dist/files-sdk/files-sdk.driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"files-sdk.driver.d.ts","sourceRoot":"","sources":["../../src/files-sdk/files-sdk.driver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"files-sdk.driver.d.ts","sourceRoot":"","sources":["../../src/files-sdk/files-sdk.driver.ts"],"names":[],"mappings":"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"}