Effect-TS/effect @effect/ai-anthropic@4.1.0

on GitHub

Minor Changes

• #8829 38f96d8 Thanks @effect-bot! - Regenerate the unstable Generated module from the pinned anthropic-sdk-typescript 0.135.0 spec, so newer request settings such as adaptive thinking display can be configured. Every released Generated export name still exists. The released Skills schemas, such as Skill and CreateSkillResponse, keep their released definitions. Other released types follow the current API: they gain fields and union members, and fields added since the release stay optional, so older responses still decode. The Files and Skills changes below are the exception: they follow Anthropic's migration of those APIs to their GA shapes and do not decode the previous beta shapes.

  Breaking changes

  • The Skills client methods decode the current API shapes, exported under new *Resource names. No method decodes with the released Skills schemas.

    • createSkillV1SkillsPost, getSkillV1SkillsSkillIdGet and their beta* variants return SkillResource / BetaSkillResource. Read display_name instead of display_title, and latest_version_id instead of latest_version.
    • createSkillVersionV1SkillsSkillIdVersionsPost, getSkillVersionV1SkillsSkillIdVersionsVersionGet and their beta* variants return SkillVersionResource / BetaSkillVersionResource, which no longer include directory or version.
    • The Skills list methods return List*ResourcesResponse. Page with next_page instead of has_more.
    • The delete methods and Skill version results type type as the literal the API always sends, such as "skill_deleted" and "skill_version", instead of string.

  • The Files list methods listFilesV1FilesGet and betaListFilesV1FilesGet page with page and next_page. Their params no longer include before_id or after_id, and FileListResponse / BetaFileListResponse no longer include has_more, first_id or last_id. Pass the previous response's next_page as page to fetch the next page.

  • When migrating to the current Files and Skills shapes, remove the dated files-api-2025-04-14 and skills-2025-10-02 tokens from any anthropic-beta header you send, and keep any other beta tokens. The API still returns the previous beta shapes to requests that send these tokens, and the Files and Skills methods cannot decode them. See the upstream migration guides for Files and Skills.

  • Uploads take files instead of strings. UploadFileV1FilesPostRequestFormData.file and each Skills files entry are a File or Blob. Skills files is now required and non-null. As before, every file must be in one top-level directory that has a SKILL.md. The Skills create input renames display_title to display_name:

    const created = client.betaCreateSkillV1SkillsPost({
      payload: {
        display_name: "My skill",
        files: [new File([skillMd], "my-skill/SKILL.md", { type: "text/markdown" })]
      },
      config: undefined
    })

  • BetaMessageIterationUsage.model can be null as well as missing. Read it with a fallback, such as usage.model ?? "unknown".

  • Text blocks in BetaResponseMCPToolResultBlock content have optional citations. Read them with a fallback, such as part.citations ?? [].

  • Response unions gain members. Exhaustive switches without a default need new cases:

    • web fetch error_code adds "content_too_large";
    • stop reasons add "model_context_window_exceeded";
    • beta content blocks, server tool names and iteration usage add advisor variants.

• #8829 3c42058 Thanks @effect-bot! - Remove AiError.HttpRequestDetails and Response.HttpRequestDetails, so AI errors and response metadata no longer carry request headers or query parameters. AiError.NetworkError records the request as method and url fields instead of request, and the request field is gone from AiError.HttpContext and Response.ResponseMetadataPart.

Patch Changes

• #8829 7ea1ea2 Thanks @wmaurer! - Add an optional cause to the AI NetworkError. It holds the HttpClientError the request failed with, stored unchanged and not redacted, so the reason a request failed is no longer lost. The new NetworkError.fromHttpClientError sets it, and all AI providers now use it. NetworkError.fromRequestError is unchanged.
• Updated dependencies [631d4f4, 7ea1ea2, a2ccc14, ed20129, 20795b9, a8e5e6c, c4d298d, fb5dbee, 8309b94, ac10e55, af23904, df8dce5, 0c24a8f, 468c6ee, 2d1fcd4, 8f23668, 3f8f359, fe6b748, 2a03584, 40e145e, 7217410, cf249fe, 4f0fad1, e75708c, 7890077, c4a00fc, f74db37, 069cf72, 9a07ebc, f40dc4e, fa516c6, ffd9237, 93895b9, 8938b19, e5a1479, 89e1e1e, eda0960, 65db606, 7c42335, cb21d14, 89e1e1e, c32eb78, be9895b, 26b4bfe, e19c611, f97711f, 4f16778, d2b6bc7, 8e668fe, ce9e999, 3d88452, 3c42058, 2ae4045, e853fa1, 6dc3f7c, 1513bbd, c065ed7, 1194a4c, 2cb498e, 89e5443, 2a9a425, e710bbb, b0d6e75, 32b3570, 9f93f4f, 27370c7]:
  • effect@4.1.0