@anthropic-ai/sdk 0.123.0 → 0.125.0

package/src/client.ts

@@ -1,8 +1,5 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import type { RequestInit, RequestInfo, BodyInit } from './internal/builtin-types';
 import type { HTTPMethod, PromiseOrValue, MergedRequestInit, FinalizedRequestInit } from './internal/types';
-import { uuid4 } from './internal/utils/uuid';
 import { validatePositiveInteger, isAbsoluteURL, safeJSON } from './internal/utils/values';
 import { sleep } from './internal/utils/sleep';
 export type { Logger, LogLevel } from './internal/utils/log';
@@ -55,9 +52,12 @@ import {
 } from './resources/completions';
 import {
   DeletedFile,
+  FileDeleteParams,
+  FileDownloadParams,
   FileListParams,
   FileMetadata,
   FileMetadataPageCursor,
+  FileRetrieveMetadataParams,
   FileUploadParams,
   Files,
 } from './resources/files';
@@ -337,7 +337,9 @@ import {
   DeletedSkill,
   Skill,
   SkillCreateParams,
+  SkillDeleteParams,
   SkillListParams,
+  SkillRetrieveParams,
   SkillSource,
   Skills,
   SkillsPageCursor,
@@ -583,7 +585,6 @@ export class BaseAnthropic {
 
   private fetch: Fetch;
   #encoder: Opts.RequestEncoder;
-  protected idempotencyHeader?: string;
   protected _options: ClientOptions;
 
   /**
@@ -650,7 +651,7 @@ export class BaseAnthropic {
       parseLogLevel(readEnv('ANTHROPIC_LOG'), "process.env['ANTHROPIC_LOG']", loggerFor(this)) ??
       defaultLogLevel;
     this.fetchOptions = options.fetchOptions;
-    this.maxRetries = options.maxRetries ?? 2;
+    this.maxRetries = validatePositiveInteger('maxRetries', options.maxRetries ?? 2);
     this.fetch = options.fetch ?? Shims.getDefaultFetch();
     this.#encoder = Opts.FallbackEncoder;
 
@@ -781,7 +782,8 @@ export class BaseAnthropic {
   }
 
   /**
-   * Create a new client instance re-using the same options given to the current client with optional overriding.
+   * Create a new client instance re-using the same options given to the
+   * current client with optional overriding.
    */
   withOptions(options: Partial<ClientOptions>): this {
     // Share the auth state object unless the caller passes any auth-related
@@ -955,10 +957,6 @@ export class BaseAnthropic {
     return `Anthropic/JS ${VERSION}`;
   }
 
-  protected defaultIdempotencyKey(): string {
-    return `stainless-node-retry-${uuid4()}`;
-  }
-
   protected makeStatusError(
     status: number,
     error: Object,
@@ -1115,7 +1113,7 @@ export class BaseAnthropic {
     retryOfRequestLogID: string | undefined,
   ): Promise<APIResponseProps> {
     const options = await optionsInput;
-    const maxRetries = options.maxRetries ?? this.maxRetries;
+    const maxRetries = validatePositiveInteger('maxRetries', options.maxRetries ?? this.maxRetries);
     if (retriesRemaining == null) {
       retriesRemaining = maxRetries;
       // Top-level call: reset per-request auth flags so a reused options object
@@ -1479,9 +1477,10 @@ export class BaseAnthropic {
       }
     }
 
-    // If the API asks us to wait a certain amount of time, just do what it
-    // says, but otherwise calculate a default
-    if (timeoutMillis === undefined) {
+    // If the API asks us to wait a certain amount of time, do what it says, as long as it's a positive delay that
+    // one timer can represent (setTimeout fires after 1ms for anything above 2^31 - 1). Otherwise (no header, an
+    // unparseable value, zero/negative, a date in the past) calculate a default.
+    if (timeoutMillis === undefined || !(timeoutMillis > 0 && timeoutMillis <= 2 ** 31 - 1)) {
       const maxRetries = options.maxRetries ?? this.maxRetries;
       timeoutMillis = this.calculateDefaultRetryTimeoutMillis(retriesRemaining, maxRetries);
     }
@@ -1568,14 +1567,7 @@ export class BaseAnthropic {
     bodyHeaders: HeadersLike;
     retryCount: number;
   }): Promise<Headers> {
-    let idempotencyHeaders: HeadersLike = {};
-    if (this.idempotencyHeader && method !== 'get') {
-      if (!options.idempotencyKey) options.idempotencyKey = this.defaultIdempotencyKey();
-      idempotencyHeaders[this.idempotencyHeader] = options.idempotencyKey;
-    }
-
     const headers = buildHeaders([
-      idempotencyHeaders,
       {
         Accept: 'application/json',
         'User-Agent': this.getUserAgent(),
@@ -1982,6 +1974,9 @@ export declare namespace Anthropic {
     type FileMetadata as FileMetadata,
     type FileMetadataPageCursor as FileMetadataPageCursor,
     type FileListParams as FileListParams,
+    type FileDeleteParams as FileDeleteParams,
+    type FileDownloadParams as FileDownloadParams,
+    type FileRetrieveMetadataParams as FileRetrieveMetadataParams,
     type FileUploadParams as FileUploadParams,
   };
 
@@ -1992,7 +1987,9 @@ export declare namespace Anthropic {
     type SkillSource as SkillSource,
     type SkillsPageCursor as SkillsPageCursor,
     type SkillCreateParams as SkillCreateParams,
+    type SkillRetrieveParams as SkillRetrieveParams,
     type SkillListParams as SkillListParams,
+    type SkillDeleteParams as SkillDeleteParams,
   };
 
   export {

package/src/core/api-promise.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { type BaseAnthropic } from '../client';
 
 import { type PromiseOrValue } from '../internal/types';

package/src/core/error.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { castToError } from '../internal/errors';
 import type { ErrorType } from '../resources/shared';
 

package/src/core/pagination.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { AnthropicError } from './error';
 import { FinalRequestOptions } from '../internal/request-options';
 import { defaultParseResponse, WithRequestID } from '../internal/parse';

package/src/core/resource.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { BaseAnthropic } from '../client';
 
 export abstract class APIResource {

package/src/core/streaming.ts

@@ -329,10 +329,12 @@ async function* iterSSEChunks(iterator: AsyncIterableIterator<Bytes>): AsyncGene
     newData.set(binaryChunk, data.length);
     data = newData;
 
+    // Yield views, not copies, so a chunk holding many events is not re-copied
+    // once per event. This relies on newData never being written again.
     let patternIndex;
     while ((patternIndex = findDoubleNewlineIndex(data)) !== -1) {
-      yield data.slice(0, patternIndex);
-      data = data.slice(patternIndex);
+      yield data.subarray(0, patternIndex);
+      data = data.subarray(patternIndex);
     }
   }
 

package/src/index.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export { Anthropic as default } from './client';
 
 export { type Uploadable, toFile } from './core/uploads';

package/src/internal/builtin-types.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export type Fetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
 
 /**

package/src/internal/detect-platform.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { VERSION } from '../version';
 
 export const isRunningInBrowser = () => {

package/src/internal/errors.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export function isAbortError(err: unknown) {
   return (
     typeof err === 'object' &&

package/src/internal/headers.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { isReadonlyArray } from './utils/values';
 
 type HeaderValue = string | undefined | null;

package/src/internal/parse.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import type { FinalRequestOptions } from './request-options';
 import { Stream } from '../core/streaming';
 import { type BaseAnthropic } from '../client';

package/src/internal/request-options.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { NullableHeaders } from './headers';
 
 import type { BodyInit } from './builtin-types';
@@ -120,7 +118,7 @@ export interface RequestOptions {
   fallbackState?: BetaFallbackState;
 
   /**
-   * A unique key for this request to enable idempotency.
+   * @deprecated This option has no effect and will be removed in a future major version.
    */
   idempotencyKey?: string;
 

package/src/internal/shim-types.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 /**
  * Shims for types that we can't always rely on being available globally.
  *

package/src/internal/shims.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 /**
  * This module provides internal shims and utility functions for environments where certain Node.js or global types may not be available.
  *

package/src/internal/types.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export type PromiseOrValue<T> = T | Promise<T>;
 export type HTTPMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';
 

package/src/internal/utils/base64.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { AnthropicError } from '../../core/error';
 import { encodeUTF8 } from './bytes';
 

package/src/internal/utils/env.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 /**
  * Read an environment variable.
  *

package/src/internal/utils/log.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { hasOwn } from './values';
 import { readEnv } from './env';
 import { type BaseAnthropic } from '../../client';

package/src/internal/utils/query.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import * as qs from '../qs/stringify';
 
 export function stringifyQuery(query: object | Record<string, unknown>) {

package/src/internal/utils/uuid.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 /**
  * https://stackoverflow.com/a/2117523
  */

package/src/internal/utils/values.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 import { AnthropicError } from '../../core/error';
 
 // https://url.spec.whatwg.org/#url-scheme-string

package/src/internal/utils.ts

@@ -1,5 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
 export * from './utils/values';
 export * from './utils/base64';
 export * from './utils/env';

package/src/lib/.keep

@@ -1,4 +1,2 @@
-File generated from our OpenAPI spec by Stainless.
-
 This directory can be used to store custom files to expand the SDK.
 It is ignored by Stainless code generation and its content (other than this keep file) won't be touched.

package/src/lib/environments/worker.ts

@@ -50,8 +50,9 @@ export interface EnvironmentWorkerOptions {
    * The environment key — the worker's standing credential: polling always
    * uses it, and per-session calls fall back to it when a claimed item's
    * `secret` doesn't yield a sessions token. Required by
-   * {@link EnvironmentWorker.run}; falls back to `ANTHROPIC_ENVIRONMENT_KEY` in
-   * {@link EnvironmentWorker.handleItem}.
+   * {@link EnvironmentWorker.run}; {@link EnvironmentWorker.handleItem} falls
+   * back to `ANTHROPIC_ENVIRONMENT_KEY` and needs a key only when the work
+   * item's `secret` yields no sessions token.
    */
   environmentKey?: string;
   /**
@@ -130,9 +131,10 @@ export interface HandleItemOptions {
   /** Session id. Falls back to `ANTHROPIC_SESSION_ID`. */
   sessionId?: string;
   /**
-   * The environment key used to authenticate every per-session call. Resolution
-   * order: this option, then the worker's own `environmentKey`, then
-   * `ANTHROPIC_ENVIRONMENT_KEY`.
+   * The environment key. Resolution order: this option, then the worker's own
+   * `environmentKey`, then `ANTHROPIC_ENVIRONMENT_KEY`. Needed only when
+   * `workSecret` is absent or its payload yields no sessions token — with a
+   * token-bearing secret the item runs on that token alone.
    */
   environmentKey?: string;
   /**
@@ -334,9 +336,13 @@ export class EnvironmentWorker {
    * `ANTHROPIC_ENVIRONMENT_ID` / `ANTHROPIC_SESSION_ID` (the env vars that
    * command sets) when not passed; the environment key resolves from this
    * option, then the worker's own `environmentKey`, then
-   * `ANTHROPIC_ENVIRONMENT_KEY`. With no arguments inside that command it just
-   * works. Throws a clear error naming the first of the four required values
-   * still missing after resolution. Throws `SessionMemoryError` when the
+   * `ANTHROPIC_ENVIRONMENT_KEY`, and is needed only when the work item's
+   * `secret` yields no sessions token — a host that receives only the
+   * per-item secret runs without ever holding the key. With no arguments
+   * inside that command it just works. Throws a clear error naming the first
+   * required value still missing after resolution, and — rather than ever
+   * running unauthenticated — when neither a sessions token nor an
+   * environment key resolved. Throws `SessionMemoryError` when the
    * session has memory stores attached but they cannot be mounted — the work
    * item carried no sessions token (unless `memorySyncIntervalMs` turned
    * memory off), or a store failed to download.
@@ -351,10 +357,10 @@ export class EnvironmentWorker {
     const workId = opts?.workId ?? readEnv('ANTHROPIC_WORK_ID');
     const environmentId = opts?.environmentId ?? readEnv('ANTHROPIC_ENVIRONMENT_ID');
     const sessionId = opts?.sessionId ?? readEnv('ANTHROPIC_SESSION_ID');
+    // Trailing `|| undefined` / `||` between fallbacks so an empty value reads
+    // as absent (matching how `readEnv` treats empty values).
     const environmentKey =
-      opts?.environmentKey ?? this.environmentKey ?? readEnv('ANTHROPIC_ENVIRONMENT_KEY');
-    // `||` rather than `??` so an empty option still falls through to the env
-    // var and then to null (matching how `readEnv` treats empty values).
+      (opts?.environmentKey ?? this.environmentKey ?? readEnv('ANTHROPIC_ENVIRONMENT_KEY')) || undefined;
     const workSecret = opts?.workSecret || readEnv('ANTHROPIC_WORK_SECRET') || null;
 
     if (!workId) {
@@ -368,9 +374,9 @@ export class EnvironmentWorker {
     if (!sessionId) {
       throw new AnthropicError('handleItem: sessionId is required — pass it or set ANTHROPIC_SESSION_ID');
     }
-    if (!environmentKey) {
+    if (!environmentKey && !workSecret) {
       throw new AnthropicError(
-        'handleItem: environmentKey is required — pass it, construct the worker with it, or set ANTHROPIC_ENVIRONMENT_KEY',
+        'handleItem: environmentKey is required when there is no work secret — pass it, construct the worker with it, or set ANTHROPIC_ENVIRONMENT_KEY',
       );
     }
 
@@ -397,7 +403,7 @@ export class EnvironmentWorker {
    */
   async #handleItem(
     work: ClaimedWork,
-    environmentKey: string,
+    environmentKey: string | undefined,
     externalSignal: AbortSignal | undefined,
   ): Promise<void> {
     const log = loggerFor(this.client);
@@ -405,6 +411,15 @@ export class EnvironmentWorker {
     // item's secret payload when the server issued one, otherwise the
     // environment key. Never log this value.
     const sessionsToken = sessionsTokenFromSecret(work.secret);
+    const itemCredential = sessionsToken ?? environmentKey;
+    if (itemCredential === undefined) {
+      throw new AnthropicError(
+        'handleItem: the work item carried a secret payload but no sessions token could be extracted, ' +
+          'and there is no environment key to fall back to; the poller must issue a secret whose ' +
+          'payload carries `sessions_token`, or provide the environment key (pass it, construct the ' +
+          'worker with it, or set ANTHROPIC_ENVIRONMENT_KEY)',
+      );
+    }
     if (work.secret && sessionsToken === null) {
       log.warn(
         'work item carried a secret payload but no sessions token could be extracted; ' +
@@ -412,7 +427,6 @@ export class EnvironmentWorker {
         { work_id: work.id },
       );
     }
-    const itemCredential = sessionsToken ?? environmentKey;
     // Every per-session call — the SessionToolRunner event stream/list/send, the
     // lease heartbeat, the skill download, and the work force-stop —
     // authenticates with the per-item credential. Scope a client to it once and