v0.5.6

0.5.6 (2023-07-15)

Bug Fixes

• fix errors with "named" client export in CJS (#67) (08ef69c)

v0.5.5

0.5.5 (2023-07-13)

Features

• client: add support for passing a signal request option (#55) (09604e9)

Bug Fixes

• streaming: do not abort successfully completed streams (#53) (950dd49)

Documentation

• examples: bump model to claude-2 in example scripts (#57) (f85c05d)
• readme: improvements to formatting code snippets (#58) (67bae64)

Chores

• internal: add helper function for b64 (#62) (04e303c)
• internal: let toFile helper accept promises to objects with name/type properties (#63) (93f9af2)
• internal: remove unneeded type var usage (#59) (42fc4a9)

v0.5.4

What's Changed

• fix(client): properly handle multi-byte characters in Content-Length
• feat(client): support passing a custom fetch function
• refactor(streaming): make response body streaming polyfill more spec-compliant
• docs(api): reference claude-2
• docs(readme): update examples to use claude-2

Full Changelog: v0.5.3...v0.5.4

v0.5.3

What's Changed

• fix(streaming): fix response body streaming in non-Chrome environments #38
• feat(client): improve timeout handling to reuse agent #37
• fix: fix errors in package source files when users go to definition in VSCode #36
• fix: support PromiseLike input to toFile #35
• refactor: improve streaming implementation #34

Full Changelog: v0.5.2...v0.5.3

v0.5.2

1. Include README in dist
2. Improve streaming

Full Changelog: v0.5.1...v0.5.2

v0.5.1

What's Changed

• Improved support for ESM & more platforms, including:
  • Cloudflare Workers
  • Vercel Edge Runtime
  • Deno
• Increase default timeout to 10 minutes for completions
• Minor improvements to api.md
• Refactor internal structure to use a src/ directory
• Add support for a defaultQuery client option
• Improvements to documentation for client options
• Deprecate .responseHeaders, stream.response & stream.responseHeaders

Full Changelog: v0.5.0...v0.5.1

v0.5.0 – ⚠️ BREAKING, fully rewritten library

Migration from v0.4.x and below

In v0.5.0, we introduced a fully rewritten SDK. The new version offers better error handling, a more robust and intuitive streaming implementation, and more.

Key interface changes:

1. new Client(apiKey) → new Anthropic({ apiKey })
2. client.complete() → client.completions.create()
3. client.completeStream() → client.completions.create({ stream: true })
   1. onUpdate callback → for await (const x of stream)
   2. full message in stream → delta of message in stream

Example diff

  // Import "Anthropic" instead of "Client":
- import { Client, HUMAN_PROMPT, AI_PROMPT } from '@anthropic-ai/sdk';
+ import Anthropic, { HUMAN_PROMPT, AI_PROMPT } from '@anthropic-ai/sdk';

  // Instantiate with "apiKey" as an object property:
- const client = new Client(apiKey);
+ const client = new Anthropic({ apiKey });
  // or, simply provide an ANTHROPIC_API_KEY environment variable:
+ const client = new Anthropic();

  async function main() {
    // Request & response types are the same as before, but better-typed.
    const params = {
      prompt: `${HUMAN_PROMPT} How many toes do dogs have?${AI_PROMPT}`,
      max_tokens_to_sample: 200,
      model: "claude-1",
    };

    // Instead of "client.complete()", you now call "client.completions.create()":
-   await client.complete(params);
+   await client.completions.create(params);

    // Streaming requests now use async iterators instead of callbacks:
-   client.completeStream(params, {
-     onUpdate: (completion) => {
-       console.log(completion.completion); // full text
-     },
-   });
+   const stream = await client.completions.create({ ...params, stream: true });
+   for await (const completion of stream) {
+     console.log(completion.completion); // incremental text
+   }

    // And, since this library uses `Anthropic-Version: 2023-06-01`,
    // completion streams are now incremental diffs of text
    // rather than sending the whole message every time:
    let text = '';
-   await client.completeStream(params, {
-     onUpdate: (completion) => {
-       const diff = completion.completion.replace(text, "");
-       text = completion.completion;
-       process.stdout.write(diff);
-     },
-   });
+   const stream = await client.completions.create({ ...params, stream: true });
+   for await (const completion of stream) {
+     const diff = completion.completion;
+     text += diff;
+     process.stdout.write(diff);
+   }
    console.log('Done; final text is:')
    console.log(text)
  }
  main();

v0.4.4

What's Changed

• Add pinned server version, fix sdk version header, bump local version. by @jenan-anthropic in #21

New Contributors

• @jenan-anthropic made their first contribution in #21

Full Changelog: v0.4.3...v0.4.4

v0.4.3

What's Changed

• Add cancellation support using AbortController/AbortSignal by @jspahrsummers in #13

Full Changelog: v0.4.2...v0.4.3

v0.4.2

What's Changed

• Expose tags parameter for custom metadata with completion calls by @jspahrsummers in #12

Full Changelog: v0.4.1...v0.4.2