@ai-sdk/anthropic 4.0.0-beta.4 → 4.0.0-beta.40

package/src/sanitize-json-schema.ts

@@ -0,0 +1,203 @@
+import type { JSONSchema7, JSONSchema7Definition } from '@ai-sdk/provider';
+
+const SUPPORTED_STRING_FORMATS = new Set([
+  'date-time',
+  'time',
+  'date',
+  'duration',
+  'email',
+  'hostname',
+  'uri',
+  'ipv4',
+  'ipv6',
+  'uuid',
+]);
+
+const DESCRIPTION_CONSTRAINT_KEYS = [
+  'minimum',
+  'maximum',
+  'exclusiveMinimum',
+  'exclusiveMaximum',
+  'multipleOf',
+  'minLength',
+  'maxLength',
+  'pattern',
+  'minItems',
+  'maxItems',
+  'uniqueItems',
+  'minProperties',
+  'maxProperties',
+  'not',
+] satisfies Array<keyof JSONSchema7>;
+
+/**
+ * Removes JSON Schema keywords that Anthropic rejects in
+ * `output_config.format.schema`.
+ *
+ * The full original schema is still used by AI SDK result validation. This
+ * only relaxes the schema sent to Anthropic's constrained decoder.
+ */
+export function sanitizeJsonSchema(schema: JSONSchema7): JSONSchema7 {
+  return sanitizeSchema(schema) as JSONSchema7;
+}
+
+function sanitizeDefinition(
+  definition: JSONSchema7Definition,
+): JSONSchema7Definition {
+  if (typeof definition === 'boolean' || !isPlainObject(definition)) {
+    return definition;
+  }
+
+  return sanitizeSchema(definition as JSONSchema7);
+}
+
+function sanitizeSchema(schema: JSONSchema7): JSONSchema7 {
+  const result: JSONSchema7 = {};
+  const schemaWithDefs = schema as JSONSchema7 & {
+    $defs?: Record<string, JSONSchema7Definition>;
+  };
+
+  if (schema.$ref != null) {
+    return { $ref: schema.$ref };
+  }
+
+  if (schema.$schema != null) {
+    result.$schema = schema.$schema;
+  }
+
+  if (schema.$id != null) {
+    result.$id = schema.$id;
+  }
+
+  if (schema.title != null) {
+    result.title = schema.title;
+  }
+
+  if (schema.description != null) {
+    result.description = schema.description;
+  }
+
+  if (schema.default !== undefined) {
+    result.default = schema.default;
+  }
+
+  if (schema.const !== undefined) {
+    result.const = schema.const;
+  }
+
+  if (schema.enum != null) {
+    result.enum = schema.enum;
+  }
+
+  if (schema.type != null) {
+    result.type = schema.type;
+  }
+
+  if (schema.anyOf != null) {
+    result.anyOf = schema.anyOf.map(sanitizeDefinition);
+  } else if (schema.oneOf != null) {
+    result.anyOf = schema.oneOf.map(sanitizeDefinition);
+  }
+
+  if (schema.allOf != null) {
+    result.allOf = schema.allOf.map(sanitizeDefinition);
+  }
+
+  if (schema.definitions != null) {
+    result.definitions = Object.fromEntries(
+      Object.entries(schema.definitions).map(([name, definition]) => [
+        name,
+        sanitizeDefinition(definition),
+      ]),
+    );
+  }
+
+  if (schemaWithDefs.$defs != null) {
+    const resultWithDefs = result as JSONSchema7 & {
+      $defs?: Record<string, JSONSchema7Definition>;
+    };
+    resultWithDefs.$defs = Object.fromEntries(
+      Object.entries(schemaWithDefs.$defs).map(([name, definition]) => [
+        name,
+        sanitizeDefinition(definition),
+      ]),
+    );
+  }
+
+  if (schema.type === 'object' || schema.properties != null) {
+    if (schema.properties != null) {
+      result.properties = Object.fromEntries(
+        Object.entries(schema.properties).map(([name, definition]) => [
+          name,
+          sanitizeDefinition(definition),
+        ]),
+      );
+    }
+
+    result.additionalProperties = false;
+
+    if (schema.required != null) {
+      result.required = schema.required;
+    }
+  }
+
+  if (schema.items != null) {
+    result.items = Array.isArray(schema.items)
+      ? schema.items.map(sanitizeDefinition)
+      : sanitizeDefinition(schema.items);
+  }
+
+  if (
+    typeof schema.format === 'string' &&
+    SUPPORTED_STRING_FORMATS.has(schema.format)
+  ) {
+    result.format = schema.format;
+  }
+
+  const constraintDescription = getConstraintDescription(schema);
+  if (constraintDescription != null) {
+    result.description =
+      result.description == null
+        ? constraintDescription
+        : `${result.description}\n${constraintDescription}`;
+  }
+
+  return result;
+}
+
+function getConstraintDescription(schema: JSONSchema7): string | undefined {
+  const descriptions = DESCRIPTION_CONSTRAINT_KEYS.flatMap(key => {
+    const value = schema[key];
+
+    if (value == null || value === false) {
+      return [];
+    }
+
+    return `${formatConstraintName(key)}: ${formatConstraintValue(value)}`;
+  });
+
+  if (
+    typeof schema.format === 'string' &&
+    !SUPPORTED_STRING_FORMATS.has(schema.format)
+  ) {
+    descriptions.push(`format: ${schema.format}`);
+  }
+
+  return descriptions.length === 0 ? undefined : `${descriptions.join('; ')}.`;
+}
+
+function formatConstraintName(key: string): string {
+  return key.replace(/[A-Z]/g, match => ` ${match.toLowerCase()}`);
+}
+
+function formatConstraintValue(value: unknown): string {
+  if (typeof value === 'string') {
+    return value;
+  }
+
+  return JSON.stringify(value);
+}
+
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

package/src/skills/anthropic-skills-api.ts

@@ -0,0 +1,44 @@
+import { lazySchema, zodSchema } from '@ai-sdk/provider-utils';
+import { z } from 'zod/v4';
+
+export const anthropicSkillResponseSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      id: z.string(),
+      display_title: z.string().nullish(),
+      name: z.string().nullish(),
+      description: z.string().nullish(),
+      latest_version: z.string().nullish(),
+      source: z.string(),
+      created_at: z.string(),
+      updated_at: z.string(),
+    }),
+  ),
+);
+
+export type AnthropicSkillResponse = ReturnType<
+  typeof anthropicSkillResponseSchema
+>['_type'];
+
+export const anthropicSkillVersionListResponseSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      data: z.array(
+        z.object({
+          version: z.string(),
+        }),
+      ),
+    }),
+  ),
+);
+
+export const anthropicSkillVersionResponseSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      type: z.string(),
+      skill_id: z.string(),
+      name: z.string().nullish(),
+      description: z.string().nullish(),
+    }),
+  ),
+);

package/src/skills/anthropic-skills.ts

@@ -0,0 +1,136 @@
+import { SkillsV4, SharedV4Warning } from '@ai-sdk/provider';
+import {
+  combineHeaders,
+  convertBase64ToUint8Array,
+  createJsonResponseHandler,
+  FetchFunction,
+  getFromApi,
+  postFormDataToApi,
+  Resolvable,
+  resolve,
+} from '@ai-sdk/provider-utils';
+import { anthropicFailedResponseHandler } from '../anthropic-error';
+import {
+  anthropicSkillResponseSchema,
+  anthropicSkillVersionResponseSchema,
+} from './anthropic-skills-api';
+
+interface AnthropicSkillsConfig {
+  provider: string;
+  baseURL: string;
+  headers: Resolvable<Record<string, string | undefined>>;
+  fetch?: FetchFunction;
+}
+
+export class AnthropicSkills implements SkillsV4 {
+  readonly specificationVersion = 'v4';
+
+  get provider(): string {
+    return this.config.provider;
+  }
+
+  constructor(private readonly config: AnthropicSkillsConfig) {}
+
+  private async getHeaders(): Promise<Record<string, string | undefined>> {
+    return combineHeaders(await resolve(this.config.headers), {
+      'anthropic-beta': 'skills-2025-10-02',
+    });
+  }
+
+  private async fetchVersionMetadata({
+    skillId,
+    version,
+    headers,
+  }: {
+    skillId: string;
+    version: string;
+    headers: Record<string, string | undefined>;
+  }): Promise<{ name?: string; description?: string }> {
+    const { value: versionResponse } = await getFromApi({
+      url: `${this.config.baseURL}/skills/${skillId}/versions/${version}`,
+      headers,
+      failedResponseHandler: anthropicFailedResponseHandler,
+      successfulResponseHandler: createJsonResponseHandler(
+        anthropicSkillVersionResponseSchema,
+      ),
+      fetch: this.config.fetch,
+    });
+
+    return {
+      ...(versionResponse.name != null ? { name: versionResponse.name } : {}),
+      ...(versionResponse.description != null
+        ? { description: versionResponse.description }
+        : {}),
+    };
+  }
+
+  async uploadSkill(
+    params: Parameters<SkillsV4['uploadSkill']>[0],
+  ): Promise<Awaited<ReturnType<SkillsV4['uploadSkill']>>> {
+    const warnings: SharedV4Warning[] = [];
+
+    const formData = new FormData();
+
+    if (params.displayTitle != null) {
+      formData.append('display_title', params.displayTitle);
+    }
+
+    for (const file of params.files) {
+      const content =
+        typeof file.content === 'string'
+          ? convertBase64ToUint8Array(file.content)
+          : file.content;
+
+      formData.append('files[]', new Blob([content]), file.path);
+    }
+
+    const headers = await this.getHeaders();
+
+    const { value: response } = await postFormDataToApi({
+      url: `${this.config.baseURL}/skills`,
+      headers,
+      formData,
+      failedResponseHandler: anthropicFailedResponseHandler,
+      successfulResponseHandler: createJsonResponseHandler(
+        anthropicSkillResponseSchema,
+      ),
+      fetch: this.config.fetch,
+    });
+
+    const versionMetadata =
+      response.latest_version != null
+        ? await this.fetchVersionMetadata({
+            skillId: response.id,
+            version: response.latest_version,
+            headers,
+          })
+        : {};
+
+    const name = versionMetadata.name ?? response.name;
+    const description = versionMetadata.description ?? response.description;
+
+    return {
+      providerReference: { anthropic: response.id },
+      ...(response.display_title != null
+        ? { displayTitle: response.display_title }
+        : {}),
+      ...(name != null ? { name } : {}),
+      ...(description != null ? { description } : {}),
+      ...(response.latest_version != null
+        ? { latestVersion: response.latest_version }
+        : {}),
+      providerMetadata: {
+        anthropic: {
+          ...(response.source != null ? { source: response.source } : {}),
+          ...(response.created_at != null
+            ? { createdAt: response.created_at }
+            : {}),
+          ...(response.updated_at != null
+            ? { updatedAt: response.updated_at }
+            : {}),
+        },
+      },
+      warnings,
+    };
+  }
+}

package/src/tool/bash_20241022.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactory,
+  createProviderDefinedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -14,7 +14,7 @@ const bash_20241022InputSchema = lazySchema(() =>
   ),
 );
 
-export const bash_20241022 = createProviderToolFactory<
+export const bash_20241022 = createProviderDefinedToolFactory<
   {
     /**
      * The bash command to run. Required unless the tool is being restarted.

package/src/tool/bash_20250124.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactory,
+  createProviderDefinedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -14,7 +14,7 @@ const bash_20250124InputSchema = lazySchema(() =>
   ),
 );
 
-export const bash_20250124 = createProviderToolFactory<
+export const bash_20250124 = createProviderDefinedToolFactory<
   {
     /**
      * The bash command to run. Required unless the tool is being restarted.

package/src/tool/code-execution_20250522.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactoryWithOutputSchema,
+  createProviderExecutedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -33,7 +33,7 @@ const codeExecution_20250522InputSchema = lazySchema(() =>
   ),
 );
 
-const factory = createProviderToolFactoryWithOutputSchema<
+const factory = createProviderExecutedToolFactory<
   {
     /**
      * The Python code to execute.

package/src/tool/code-execution_20250825.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactoryWithOutputSchema,
+  createProviderExecutedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -103,7 +103,7 @@ export const codeExecution_20250825InputSchema = lazySchema(() =>
   ),
 );
 
-const factory = createProviderToolFactoryWithOutputSchema<
+const factory = createProviderExecutedToolFactory<
   | {
       type: 'programmatic-tool-call';
       /**

package/src/tool/code-execution_20260120.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactoryWithOutputSchema,
+  createProviderExecutedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -117,7 +117,7 @@ export const codeExecution_20260120InputSchema = lazySchema(() =>
   ),
 );
 
-const factory = createProviderToolFactoryWithOutputSchema<
+const factory = createProviderExecutedToolFactory<
   | {
       type: 'programmatic-tool-call';
       /**

package/src/tool/computer_20241022.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactory,
+  createProviderDefinedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -26,7 +26,7 @@ const computer_20241022InputSchema = lazySchema(() =>
   ),
 );
 
-export const computer_20241022 = createProviderToolFactory<
+export const computer_20241022 = createProviderDefinedToolFactory<
   {
     /**
      * The action to perform. The available actions are:

package/src/tool/computer_20250124.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactory,
+  createProviderDefinedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -38,7 +38,7 @@ const computer_20250124InputSchema = lazySchema(() =>
   ),
 );
 
-export const computer_20250124 = createProviderToolFactory<
+export const computer_20250124 = createProviderDefinedToolFactory<
   {
     /**
      * - `key`: Press a key or key-combination on the keyboard.

package/src/tool/computer_20251124.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactory,
+  createProviderDefinedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -47,7 +47,7 @@ const computer_20251124InputSchema = lazySchema(() =>
   ),
 );
 
-export const computer_20251124 = createProviderToolFactory<
+export const computer_20251124 = createProviderDefinedToolFactory<
   {
     /**
      * - `key`: Press a key or key-combination on the keyboard.

package/src/tool/memory_20250818.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactory,
+  createProviderDefinedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -43,7 +43,7 @@ const memory_20250818InputSchema = lazySchema(() =>
   ),
 );
 
-export const memory_20250818 = createProviderToolFactory<
+export const memory_20250818 = createProviderDefinedToolFactory<
   | { command: 'view'; path: string; view_range?: [number, number] }
   | { command: 'create'; path: string; file_text: string }
   | { command: 'str_replace'; path: string; old_str: string; new_str: string }

package/src/tool/text-editor_20241022.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactory,
+  createProviderDefinedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -20,7 +20,7 @@ const textEditor_20241022InputSchema = lazySchema(() =>
   ),
 );
 
-export const textEditor_20241022 = createProviderToolFactory<
+export const textEditor_20241022 = createProviderDefinedToolFactory<
   {
     /**
      * The commands to run. Allowed options are: `view`, `create`, `str_replace`, `insert`, `undo_edit`.

package/src/tool/text-editor_20250124.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactory,
+  createProviderDefinedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -20,7 +20,7 @@ const textEditor_20250124InputSchema = lazySchema(() =>
   ),
 );
 
-export const textEditor_20250124 = createProviderToolFactory<
+export const textEditor_20250124 = createProviderDefinedToolFactory<
   {
     /**
      * The commands to run. Allowed options are: `view`, `create`, `str_replace`, `insert`, `undo_edit`.

package/src/tool/text-editor_20250429.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactory,
+  createProviderDefinedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -20,7 +20,7 @@ const textEditor_20250429InputSchema = lazySchema(() =>
   ),
 );
 
-export const textEditor_20250429 = createProviderToolFactory<
+export const textEditor_20250429 = createProviderDefinedToolFactory<
   {
     /**
      * The commands to run. Allowed options are: `view`, `create`, `str_replace`, `insert`.

package/src/tool/text-editor_20250728.ts

@@ -1,4 +1,4 @@
-import { createProviderToolFactory } from '@ai-sdk/provider-utils';
+import { createProviderDefinedToolFactory } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 import { lazySchema, zodSchema } from '@ai-sdk/provider-utils';
 
@@ -25,7 +25,7 @@ const textEditor_20250728InputSchema = lazySchema(() =>
   ),
 );
 
-const factory = createProviderToolFactory<
+const factory = createProviderDefinedToolFactory<
   {
     /**
      * The commands to run. Allowed options are: `view`, `create`, `str_replace`, `insert`.

package/src/tool/tool-search-bm25_20251119.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactoryWithOutputSchema,
+  createProviderExecutedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -40,7 +40,7 @@ const toolSearchBm25_20251119InputSchema = lazySchema(() =>
   ),
 );
 
-const factory = createProviderToolFactoryWithOutputSchema<
+const factory = createProviderExecutedToolFactory<
   {
     /**
      * A natural language query to search for tools.

package/src/tool/tool-search-regex_20251119.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactoryWithOutputSchema,
+  createProviderExecutedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -46,7 +46,7 @@ const toolSearchRegex_20251119InputSchema = lazySchema(() =>
   ),
 );
 
-const factory = createProviderToolFactoryWithOutputSchema<
+const factory = createProviderExecutedToolFactory<
   {
     /**
      * A regex pattern to search for tools.

package/src/tool/web-fetch-20250910.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactoryWithOutputSchema,
+  createProviderExecutedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -52,7 +52,7 @@ const webFetch_20250910InputSchema = lazySchema(() =>
   ),
 );
 
-const factory = createProviderToolFactoryWithOutputSchema<
+const factory = createProviderExecutedToolFactory<
   {
     /**
      * The URL to fetch.

package/src/tool/web-fetch-20260209.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactoryWithOutputSchema,
+  createProviderExecutedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -52,7 +52,7 @@ const webFetch_20260209InputSchema = lazySchema(() =>
   ),
 );
 
-const factory = createProviderToolFactoryWithOutputSchema<
+const factory = createProviderExecutedToolFactory<
   {
     /**
      * The URL to fetch.

package/src/tool/web-search_20250305.ts

@@ -1,5 +1,5 @@
 import {
-  createProviderToolFactoryWithOutputSchema,
+  createProviderExecutedToolFactory,
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
@@ -46,7 +46,7 @@ const webSearch_20250305InputSchema = lazySchema(() =>
   ),
 );
 
-const factory = createProviderToolFactoryWithOutputSchema<
+const factory = createProviderExecutedToolFactory<
   {
     /**
      * The search query to execute.