@nestm/storage 0.1.0-alpha.0 → 0.1.0-alpha.10

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

@@ -0,0 +1,491 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+import { STORAGE_WORKSPACE_MAX_CURSOR_BYTES, isStorageWorkspaceError, } from '../workspace/index.js';
+import { StorageErrorCode, isStorageError, } from '../storage.error.js';
+import { isCanonicalStorageEtag } from '../storage-etag.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. Inspect the affected paths before retrying.',
+    [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. Applied
+ * reconciliation metadata is retained so callers do not blindly retry a
+ * mutation that may already have committed.
+ */
+export class AiSdkWorkspaceToolError extends Error {
+    code;
+    constructor(code, options = {}) {
+        super(SAFE_ERROR_MESSAGES[code]);
+        this.name = 'AiSdkWorkspaceToolError';
+        this.code = code;
+        if (options.applied === true) {
+            this.applied = true;
+            if (options.appliedEtag !== undefined &&
+                isCanonicalStorageEtag(options.appliedEtag)) {
+                this.appliedEtag = options.appliedEtag;
+            }
+        }
+    }
+}
+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._-]+$/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() {
+    return z
+        .string()
+        .refine(isCanonicalStorageEtag, {
+        message: 'ETag must be a canonical bare value of at most 1,024 bytes.',
+    })
+        .describe('Exact canonical bare ETag returned by the latest workspace stat or read.');
+}
+function continuationCursor(description, maxBytes) {
+    return z
+        .string()
+        .min(1)
+        .max(Math.min(STORAGE_WORKSPACE_MAX_CURSOR_BYTES, maxBytes))
+        .regex(workspaceCursor, 'Cursor must be the bounded opaque 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;
+    }
+    const reconciliation = isStorageWorkspaceError(error) || isStorageError(error)
+        ? {
+            applied: error.applied,
+            ...(error.appliedEtag !== undefined && {
+                appliedEtag: error.appliedEtag,
+            }),
+        }
+        : {};
+    if (signal?.aborted === true) {
+        return new AiSdkWorkspaceToolError(StorageErrorCode.ABORTED, reconciliation);
+    }
+    if (isStorageWorkspaceError(error)) {
+        return new AiSdkWorkspaceToolError(error.code, reconciliation);
+    }
+    if (isStorageError(error)) {
+        return new AiSdkWorkspaceToolError(error.code, reconciliation);
+    }
+    return new AiSdkWorkspaceToolError(StorageErrorCode.PROVIDER);
+}
+async function executeSafely(signal, operation) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        throw sanitizeToolError(error, signal);
+    }
+}
+async function executeCreateAware(signal, input, operation, mapCreateConflict) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        const safeError = sanitizeToolError(error, signal);
+        if (input.mode === 'create' &&
+            safeError.code === StorageErrorCode.CONFLICT &&
+            safeError.applied !== true &&
+            mapCreateConflict !== undefined) {
+            try {
+                return await mapCreateConflict({ path: input.path });
+            }
+            catch {
+                throw new AiSdkWorkspaceToolError(StorageErrorCode.PROVIDER);
+            }
+        }
+        throw safeError;
+    }
+}
+function serializeFile(file) {
+    if (file.etag !== undefined && !isCanonicalStorageEtag(file.etag)) {
+        throw new Error('Workspace returned a malformed ETag.');
+    }
+    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, mutationMode = 'conditional', requireApproval = true, mapCreateConflict, }) {
+    if (mutationMode !== 'conditional' && mutationMode !== 'last-write-wins') {
+        throw new RangeError('mutationMode must be "conditional" or "last-write-wins".');
+    }
+    if (mutationMode === 'last-write-wins' && mapCreateConflict !== undefined) {
+        throw new RangeError('mapCreateConflict is available only in conditional mutation mode.');
+    }
+    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();
+    if (workspace.allows('list')) {
+        tools.workspace_list = tool({
+            description: 'List files and directories inside the mounted workspace. Omit directory to list the workspace root.',
+            // Optional pagination and directory inputs are not compatible with
+            // OpenAI strict function schemas, which require every property.
+            strict: false,
+            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 cursor returned by a preceding list call. It may be replayed before expiry while its provider continuation remains valid; repeat the same directory, recursive, and limit options when continuing.', workspace.limits.maxCursorBytes),
+            })
+                .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: mutationMode === 'conditional'
+                ? 'Inspect a file inside the mounted workspace without reading its contents. Returns the ETag required for safe replace, move, and delete operations.'
+                : 'Inspect a file inside the mounted workspace without reading its contents. Any returned ETag is informational in last-write-wins mode.',
+            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.',
+            // Search intentionally has optional filters and cursor inputs.
+            strict: false,
+            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 cursor returned by a preceding search call. It may be replayed before expiry while its provider continuation remains valid; repeat the same query, directory, match, caseInsensitive, and limit options when continuing.', workspace.limits.maxCursorBytes),
+            })
+                .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 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.`),
+    };
+    if (mutationMode === 'last-write-wins' && workspace.allows('write')) {
+        const inputSchema = z.object(commonWriteShape).strict();
+        tools.workspace_write_file = tool({
+            description: 'Write a UTF-8 text file inside the mounted workspace. An existing destination is overwritten; the last successful writer wins.',
+            strict: true,
+            inputSchema,
+            needsApproval: resolveApproval('workspace_write_file', requireApproval),
+            execute: ({ path, content }, { abortSignal }) => executeSafely(abortSignal, async () => serializeFile(await workspace.writeFile(path, content, {
+                mode: 'overwrite',
+                ...operationOptions(abortSignal),
+            }))),
+        });
+    }
+    else if (mutationMode === 'conditional') {
+        const canCreate = workspace.allows('create');
+        const canReplace = workspace.allows('replace');
+        if (canCreate || canReplace) {
+            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.',
+                // The combined create/replace schema is a discriminated union. OpenAI
+                // strict function tools reject its root-level oneOf, while the runtime
+                // Zod schema continues to validate every tool call in non-strict mode.
+                strict: !(canCreate && canReplace),
+                inputSchema,
+                needsApproval: resolveApproval('workspace_write_file', requireApproval),
+                execute: (input, { abortSignal }) => executeCreateAware(abortSignal, input, 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),
+                    })), mapCreateConflict),
+            });
+        }
+    }
+    const canCopy = workspace.allows('copy') && workspace.allows('read');
+    if (mutationMode === 'last-write-wins' &&
+        canCopy &&
+        workspace.allows('write')) {
+        tools.workspace_copy_file = tool({
+            description: 'Copy the latest readable contents of a file inside the mounted workspace. The source remains intact, and an existing destination is overwritten.',
+            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, {
+                mode: 'overwrite',
+                ...operationOptions(abortSignal),
+            }))),
+        });
+    }
+    else if (mutationMode === 'conditional' &&
+        canCopy &&
+        workspace.allows('create')) {
+        tools.workspace_copy_file = tool({
+            description: 'Copy an exact observed version of a file inside the mounted workspace. The source remains intact, and the operation fails if the source changed or 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),
+                etag: etagSchema.describe('Exact ETag of the source returned by the latest workspace stat or read.'),
+            })
+                .strict(),
+            needsApproval: resolveApproval('workspace_copy_file', requireApproval),
+            execute: ({ source, destination, etag }, { abortSignal }) => executeSafely(abortSignal, async () => serializeFile(await workspace.copyFile(source, destination, {
+                etag,
+                ...operationOptions(abortSignal),
+            }))),
+        });
+    }
+    if (mutationMode === 'conditional' &&
+        workspace.allows('move') &&
+        workspace.allows('read') &&
+        workspace.allows('delete') &&
+        workspace.allows('create')) {
+        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 (mutationMode === 'last-write-wins' &&
+        workspace.allows('delete') &&
+        workspace.allows('write')) {
+        tools.workspace_delete_file = tool({
+            description: 'Unconditionally delete the current file at a path inside the mounted workspace.',
+            strict: true,
+            inputSchema: z.object({ path: pathSchema }).strict(),
+            needsApproval: resolveApproval('workspace_delete_file', requireApproval),
+            execute: ({ path }, { abortSignal }) => executeSafely(abortSignal, async () => {
+                await workspace.deleteFile(path, {
+                    mode: 'unconditional',
+                    ...operationOptions(abortSignal),
+                });
+                return { deleted: true, path };
+            }),
+        });
+    }
+    else if (mutationMode === 'conditional' && 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 JSONValue, type ToolSet } from 'ai';\nimport { z } from 'zod';\n\nimport {\n  STORAGE_WORKSPACE_MAX_CURSOR_BYTES,\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';\nimport { isCanonicalStorageEtag } from '../storage-etag.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 type AiSdkWorkspaceMutationMode = 'conditional' | 'last-write-wins';\n\nexport interface AiSdkWorkspaceCreateConflict {\n  /** The logical destination inside the mounted workspace. */\n  readonly path: string;\n}\n\nexport type AiSdkWorkspaceCreateConflictMapper<Result extends JSONValue> = (\n  conflict: AiSdkWorkspaceCreateConflict,\n) => PromiseLike<Result> | Result;\n\nexport interface CreateAiSdkWorkspaceToolsOptions<\n  CreateConflictResult extends JSONValue = never,\n> {\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   * Selects the mutation contract exposed to the model. Conditional mode is\n   * the default; last-write-wins uses the workspace's ordinary Files path.\n   */\n  mutationMode?: AiSdkWorkspaceMutationMode;\n  /**\n   * Maps an atomic create collision to an application result. When omitted,\n   * the collision remains an AiSdkWorkspaceToolError like every other storage\n   * failure. Replace conflicts are never mapped by this hook. This option is\n   * valid only when mutationMode is conditional.\n   */\n  mapCreateConflict?: AiSdkWorkspaceCreateConflictMapper<CreateConflictResult>;\n}\n\nexport type AiSdkWorkspaceToolErrorCode = StorageErrorCodeValue;\n\nexport interface AiSdkWorkspaceToolErrorOptions {\n  /** True when the failed operation may already have committed. */\n  readonly applied?: boolean;\n  /** Canonical ETag of the committed object, when the provider returned one. */\n  readonly appliedEtag?: string;\n}\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. Inspect the affected paths before retrying.',\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. Applied\n * reconciliation metadata is retained so callers do not blindly retry a\n * mutation that may already have committed.\n */\nexport class AiSdkWorkspaceToolError extends Error {\n  readonly code: AiSdkWorkspaceToolErrorCode;\n  declare readonly applied?: true;\n  declare readonly appliedEtag?: string;\n\n  constructor(\n    code: AiSdkWorkspaceToolErrorCode,\n    options: AiSdkWorkspaceToolErrorOptions = {},\n  ) {\n    super(SAFE_ERROR_MESSAGES[code]);\n    this.name = 'AiSdkWorkspaceToolError';\n    this.code = code;\n    if (options.applied === true) {\n      this.applied = true;\n      if (\n        options.appliedEtag !== undefined &&\n        isCanonicalStorageEtag(options.appliedEtag)\n      ) {\n        this.appliedEtag = options.appliedEtag;\n      }\n    }\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._-]+$/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() {\n  return z\n    .string()\n    .refine(isCanonicalStorageEtag, {\n      message: 'ETag must be a canonical bare value of at most 1,024 bytes.',\n    })\n    .describe(\n      'Exact canonical bare ETag returned by the latest workspace stat or read.',\n    );\n}\n\nfunction continuationCursor(description: string, maxBytes: number) {\n  return z\n    .string()\n    .min(1)\n    .max(Math.min(STORAGE_WORKSPACE_MAX_CURSOR_BYTES, maxBytes))\n    .regex(\n      workspaceCursor,\n      'Cursor must be the bounded opaque 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  const reconciliation =\n    isStorageWorkspaceError(error) || isStorageError(error)\n      ? {\n          applied: error.applied,\n          ...(error.appliedEtag !== undefined && {\n            appliedEtag: error.appliedEtag,\n          }),\n        }\n      : {};\n  if (signal?.aborted === true) {\n    return new AiSdkWorkspaceToolError(\n      StorageErrorCode.ABORTED,\n      reconciliation,\n    );\n  }\n  if (isStorageWorkspaceError(error)) {\n    return new AiSdkWorkspaceToolError(error.code, reconciliation);\n  }\n  if (isStorageError(error)) {\n    return new AiSdkWorkspaceToolError(error.code, reconciliation);\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\nasync function executeCreateAware<\n  Result,\n  CreateConflictResult extends JSONValue,\n>(\n  signal: AbortSignal | undefined,\n  input: { mode: 'create' | 'replace'; path: string },\n  operation: () => Promise<Result>,\n  mapCreateConflict:\n    AiSdkWorkspaceCreateConflictMapper<CreateConflictResult> | undefined,\n): Promise<CreateConflictResult | Result> {\n  try {\n    return await operation();\n  } catch (error) {\n    const safeError = sanitizeToolError(error, signal);\n    if (\n      input.mode === 'create' &&\n      safeError.code === StorageErrorCode.CONFLICT &&\n      safeError.applied !== true &&\n      mapCreateConflict !== undefined\n    ) {\n      try {\n        return await mapCreateConflict({ path: input.path });\n      } catch {\n        throw new AiSdkWorkspaceToolError(StorageErrorCode.PROVIDER);\n      }\n    }\n    throw safeError;\n  }\n}\n\nfunction serializeFile(file: StorageWorkspaceFile): AiSdkWorkspaceFileResult {\n  if (file.etag !== undefined && !isCanonicalStorageEtag(file.etag)) {\n    throw new Error('Workspace returned a malformed ETag.');\n  }\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  CreateConflictResult extends JSONValue = never,\n>({\n  workspace,\n  maxReadBytes: requestedMaxReadBytes,\n  mutationMode = 'conditional',\n  requireApproval = true,\n  mapCreateConflict,\n}: CreateAiSdkWorkspaceToolsOptions<CreateConflictResult>): ToolSet {\n  if (mutationMode !== 'conditional' && mutationMode !== 'last-write-wins') {\n    throw new RangeError(\n      'mutationMode must be \"conditional\" or \"last-write-wins\".',\n    );\n  }\n  if (mutationMode === 'last-write-wins' && mapCreateConflict !== undefined) {\n    throw new RangeError(\n      'mapCreateConflict is available only in conditional mutation mode.',\n    );\n  }\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();\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      // Optional pagination and directory inputs are not compatible with\n      // OpenAI strict function schemas, which require every property.\n      strict: false,\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 cursor returned by a preceding list call. It may be replayed before expiry while its provider continuation remains valid; repeat the same directory, recursive, and limit options when continuing.',\n            workspace.limits.maxCursorBytes,\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        mutationMode === 'conditional'\n          ? 'Inspect a file inside the mounted workspace without reading its contents. Returns the ETag required for safe replace, move, and delete operations.'\n          : 'Inspect a file inside the mounted workspace without reading its contents. Any returned ETag is informational in last-write-wins mode.',\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      // Search intentionally has optional filters and cursor inputs.\n      strict: false,\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 cursor returned by a preceding search call. It may be replayed before expiry while its provider continuation remains valid; repeat the same query, directory, match, caseInsensitive, and limit options when continuing.',\n            workspace.limits.maxCursorBytes,\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 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  if (mutationMode === 'last-write-wins' && workspace.allows('write')) {\n    const inputSchema = z.object(commonWriteShape).strict();\n    tools.workspace_write_file = tool({\n      description:\n        'Write a UTF-8 text file inside the mounted workspace. An existing destination is overwritten; the last successful writer wins.',\n      strict: true,\n      inputSchema,\n      needsApproval: resolveApproval('workspace_write_file', requireApproval),\n      execute: ({ path, content }, { abortSignal }) =>\n        executeSafely(abortSignal, async () =>\n          serializeFile(\n            await workspace.writeFile(path, content, {\n              mode: 'overwrite',\n              ...operationOptions(abortSignal),\n            }),\n          ),\n        ),\n    });\n  } else if (mutationMode === 'conditional') {\n    const canCreate = workspace.allows('create');\n    const canReplace = workspace.allows('replace');\n    if (canCreate || canReplace) {\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        z.infer<typeof inputSchema>,\n        unknown,\n        Record<string, unknown>\n      >({\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        // The combined create/replace schema is a discriminated union. OpenAI\n        // strict function tools reject its root-level oneOf, while the runtime\n        // Zod schema continues to validate every tool call in non-strict mode.\n        strict: !(canCreate && canReplace),\n        inputSchema,\n        needsApproval: resolveApproval('workspace_write_file', requireApproval),\n        execute: (input, { abortSignal }) =>\n          executeCreateAware(\n            abortSignal,\n            input,\n            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            mapCreateConflict,\n          ),\n      });\n    }\n  }\n\n  const canCopy = workspace.allows('copy') && workspace.allows('read');\n  if (\n    mutationMode === 'last-write-wins' &&\n    canCopy &&\n    workspace.allows('write')\n  ) {\n    tools.workspace_copy_file = tool({\n      description:\n        'Copy the latest readable contents of a file inside the mounted workspace. The source remains intact, and an existing destination is overwritten.',\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(source, destination, {\n              mode: 'overwrite',\n              ...operationOptions(abortSignal),\n            }),\n          ),\n        ),\n    });\n  } else if (\n    mutationMode === 'conditional' &&\n    canCopy &&\n    workspace.allows('create')\n  ) {\n    tools.workspace_copy_file = tool({\n      description:\n        'Copy an exact observed version of a file inside the mounted workspace. The source remains intact, and the operation fails if the source changed or 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          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_copy_file', requireApproval),\n      execute: ({ source, destination, etag }, { abortSignal }) =>\n        executeSafely(abortSignal, async () =>\n          serializeFile(\n            await workspace.copyFile(source, destination, {\n              etag,\n              ...operationOptions(abortSignal),\n            }),\n          ),\n        ),\n    });\n  }\n\n  if (\n    mutationMode === 'conditional' &&\n    workspace.allows('move') &&\n    workspace.allows('read') &&\n    workspace.allows('delete') &&\n    workspace.allows('create')\n  ) {\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 (\n    mutationMode === 'last-write-wins' &&\n    workspace.allows('delete') &&\n    workspace.allows('write')\n  ) {\n    tools.workspace_delete_file = tool({\n      description:\n        'Unconditionally delete the current file at a path inside the mounted workspace.',\n      strict: true,\n      inputSchema: z.object({ path: pathSchema }).strict(),\n      needsApproval: resolveApproval('workspace_delete_file', requireApproval),\n      execute: ({ path }, { abortSignal }) =>\n        executeSafely(abortSignal, async () => {\n          await workspace.deleteFile(path, {\n            mode: 'unconditional',\n            ...operationOptions(abortSignal),\n          });\n          return { deleted: true as const, path };\n        }),\n    });\n  } else if (mutationMode === 'conditional' && 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 AiSdkWorkspaceCreateConflict, type AiSdkWorkspaceCreateConflictMapper, type AiSdkWorkspaceDirectoryResult, type AiSdkWorkspaceEntryResult, type AiSdkWorkspaceFileResult, type AiSdkWorkspaceMutationMode, type AiSdkWorkspaceMutationToolName, type AiSdkWorkspacePageResult, type AiSdkWorkspaceTextFileResult, type AiSdkWorkspaceToolErrorCode, type AiSdkWorkspaceToolErrorOptions, 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,4BAA4B,EACjC,KAAK,kCAAkC,EACvC,KAAK,6BAA6B,EAClC,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,8BAA8B,EACnC,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,GAejC,MAAM,6BAA6B,CAAC","sourcesContent":["export {\n  AI_SDK_WORKSPACE_TOOL_NAMES,\n  AiSdkWorkspaceToolError,\n  createAiSdkWorkspaceTools,\n  isAiSdkWorkspaceMutationToolName,\n  type AiSdkWorkspaceApprovalConfig,\n  type AiSdkWorkspaceCreateConflict,\n  type AiSdkWorkspaceCreateConflictMapper,\n  type AiSdkWorkspaceDirectoryResult,\n  type AiSdkWorkspaceEntryResult,\n  type AiSdkWorkspaceFileResult,\n  type AiSdkWorkspaceMutationMode,\n  type AiSdkWorkspaceMutationToolName,\n  type AiSdkWorkspacePageResult,\n  type AiSdkWorkspaceTextFileResult,\n  type AiSdkWorkspaceToolErrorCode,\n  type AiSdkWorkspaceToolErrorOptions,\n  type AiSdkWorkspaceToolName,\n  type CreateAiSdkWorkspaceToolsOptions,\n} from './ai-sdk-workspace-tools.js';\n"]}

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+export { DEFAULT_BUFFER_LIMIT, StorageClient, type StorageFileHandle, } from '../storage.client.js';
+export type { StorageDriver } from '../storage.driver.js';
+export { StorageError, StorageErrorCode, isStorageError, normalizeStorageError, type StorageErrorOptions, } from '../storage.error.js';
+export { StorageUploadControl, type StorageResumableToken, type StorageUploadStatus, } from '../storage-upload-control.js';
+export type * from '../storage.types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,8BAA8B,CAAC;AACtC,mBAAmB,qBAAqB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,4 @@
+export { DEFAULT_BUFFER_LIMIT, StorageClient, } from '../storage.client.js';
+export { StorageError, StorageErrorCode, isStorageError, normalizeStorageError, } from '../storage.error.js';
+export { StorageUploadControl, } from '../storage-upload-control.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,aAAa,GAEd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,qBAAqB,GAEtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,GAGrB,MAAM,8BAA8B,CAAC","sourcesContent":["export {\n  DEFAULT_BUFFER_LIMIT,\n  StorageClient,\n  type StorageFileHandle,\n} from '../storage.client.js';\nexport type { StorageDriver } from '../storage.driver.js';\nexport {\n  StorageError,\n  StorageErrorCode,\n  isStorageError,\n  normalizeStorageError,\n  type StorageErrorOptions,\n} from '../storage.error.js';\nexport {\n  StorageUploadControl,\n  type StorageResumableToken,\n  type StorageUploadStatus,\n} from '../storage-upload-control.js';\nexport type * from '../storage.types.js';\n"]}