@puku-ai/sdk 3.0.3 → 3.0.5

package/sdk.d.ts

@@ -16,8 +16,8 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
      * - Defaults to process.env['PUKU_API_KEY'].
      * - When a function is provided, it is invoked before each request so you can rotate
      *   or refresh credentials at runtime.
-     * - The function must return a non-empty string; otherwise an AnthropicError is thrown.
-     * - If the function throws, the error is wrapped in an AnthropicError with the original
+     * - The function must return a non-empty string; otherwise a PukuError is thrown.
+     * - If the function throws, the error is wrapped in a PukuError with the original
      *   error available as `cause`.
      */
     apiKey?: string | ApiKeySetter | null | undefined;
@@ -95,7 +95,7 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
  declare const AI_PROMPT = "\\n\\nAssistant:";
 
 /**
- * Base class for Anthropic API clients.
+ * Base class for Puku API clients.
  */
  declare class BasePuku {
     #private;
@@ -179,12 +179,10 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
     private buildHeaders;
     private _makeAbort;
     private buildBody;
-    static Anthropic: typeof BasePuku;
     static PukuAI: typeof BasePuku;
     static HUMAN_PROMPT: string;
     static AI_PROMPT: string;
     static DEFAULT_TIMEOUT: number;
-    static AnthropicError: typeof Errors.AnthropicError;
     static PukuError: typeof Errors.PukuError;
     static APIError: typeof Errors.APIError;
     static APIConnectionError: typeof Errors.APIConnectionError;
@@ -202,12 +200,10 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
 }
 
 /**
- * API Client for interfacing with the Anthropic API.
+ * API Client for interfacing with the Puku API.
  *
- * Public-facing name: `PukuAI`.  The vendored SDK originally declared this
- * as `Anthropic`; renamed to `PukuAI` so consumers of @puku-ai/sdk can do
- * `import PukuAI from "@puku-ai/sdk"`.  `Anthropic` is kept as a static
- * property pointing to the same class for source-compat.
+ * Public-facing class: `PukuAI`.  Consumers of @puku-ai/sdk do
+ * `import PukuAI from "@puku-ai/sdk"`.
  */
  declare class PukuAI extends BasePuku {
     completions: API.Completions;
@@ -241,8 +237,8 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
     asResponse(): Promise<Response>;
     /**
      * Gets the parsed response data, the raw `Response` instance and the ID of the request,
-     * returned via the `request-id` header which is useful for debugging requests and resporting
-     * issues to Anthropic.
+     * returned via the `request-id` header which is useful for debugging requests and reporting
+     * issues.
      *
      * If you just want to get the raw `Response` instance without parsing it,
      * you can use {@link asResponse()}.
@@ -262,18 +258,6 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
     finally(onfinally?: (() => void) | undefined | null): Promise<WithRequestID<T>>;
 }
 
-/**
- * Legacy base error class, kept for backward compatibility with code
- * imported from the Anthropic SDK. `PukuError` (the new branded base)
- * extends this so `instanceof AnthropicError` continues to work for
- * every error the SDK throws.
- *
- * @deprecated Import `PukuError` instead. Will be removed in the next
- * major version.
- */
- declare class AnthropicError extends Error {
-}
-
 /**
  * Branded base error class for the Puku SDK. Every error the SDK throws
  * is an instance of `PukuError`, so `err.toString()` and stack traces
@@ -283,7 +267,7 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
  * `Error.prototype.toString()` (which reads `.name`) produces
  * `PukuError: …` instead of the default `Error: …`.
  */
- declare class PukuError extends AnthropicError {
+ declare class PukuError extends Error {
     constructor(message?: string);
 }
 
@@ -502,7 +486,7 @@ type NoInfer<T> = T extends infer R ? R : never;
  * to the `.toolRunner()` method. The schema is used to automatically validate
  * the input arguments for the tool.
  *
- * Mirrors upstream `@anthropic-ai/sdk`'s `betaTool`: `run` may take an
+ * Mirrors `@puku-ai/sdk`'s `betaTool`: `run` may take an
  * optional `BetaToolRunContext` and `close` is honored on the resulting
  * `BetaRunnableTool` so callers that hold resources (e.g. a persistent
  * shell) can clean them up when iteration ends.
@@ -644,20 +628,20 @@ type NoInfer<T> = T extends infer R ? R : never;
 }
 
 /**
- * Error thrown when an MCP value cannot be converted to a format supported by the Claude API.
+ * Error thrown when an MCP value cannot be converted to a format supported by the API.
  */
  declare class UnsupportedMCPValueError extends Error {
     constructor(message: string);
 }
 
 /**
- * Converts an MCP tool to a BetaRunnableTool for use with the Anthropic SDK's
+ * Converts an MCP tool to a BetaRunnableTool for use with this SDK's
  * `toolRunner()` method.
  *
  * @param tool The MCP tool definition from `mcpClient.listTools()`
  * @param mcpClient The MCP client instance used to call the tool
- * @param extraProps Additional Claude API properties to include in the tool definition
- * @returns A runnable tool for use with `anthropic.beta.messages.toolRunner()`
+ * @param extraProps Additional API properties to include in the tool definition
+ * @returns A runnable tool for use with `client.beta.messages.toolRunner()`
  * @throws {UnsupportedMCPValueError} When the tool returns unsupported content types
  * @throws {UnsupportedMCPValueError} When the tool returns unsupported resource links
  * @throws {UnsupportedMCPValueError} When the tool returns resources with unsupported MIME types
@@ -665,15 +649,15 @@ type NoInfer<T> = T extends infer R ? R : never;
  * @example
  * ```ts
  * import { Client } from "@modelcontextprotocol/sdk/client/index.js";
- * import Anthropic from "@anthropic-ai/sdk";
- * import { mcpTool } from "@anthropic-ai/sdk/helpers/beta/mcp";
+ * import PukuAI from "@puku-ai/sdk";
+ * import { mcpTool } from "@puku-ai/sdk/helpers/beta/mcp";
  *
  * const mcpClient = new Client({ name: "example", version: "1.0.0" });
- * const anthropic = new Anthropic();
+ * const client = new PukuAI();
  *
  * const tools = await mcpClient.listTools();
- * const runner = await anthropic.beta.messages.toolRunner({
- *   model: "claude-sonnet-4-20250514",
+ * const runner = await client.beta.messages.toolRunner({
+ *   model: "gpt-5",
  *   max_tokens: 1024,
  *   tools: tools.tools.map(tool => mcpTool(tool, mcpClient)),
  *   messages: [{ role: "user", content: "Use the available tools" }],
@@ -687,14 +671,14 @@ type NoInfer<T> = T extends infer R ? R : never;
  *
  * @param tools Array of MCP tool definitions from `mcpClient.listTools()`
  * @param mcpClient The MCP client instance used to call the tools
- * @param extraProps Additional Claude API properties to include in each tool definition
- * @returns An array of runnable tools for use with `anthropic.beta.messages.toolRunner()`
+ * @param extraProps Additional API properties to include in each tool definition
+ * @returns An array of runnable tools for use with `client.beta.messages.toolRunner()`
  *
  * @example
  * ```ts
  * const { tools } = await mcpClient.listTools();
- * const runner = await anthropic.beta.messages.toolRunner({
- *   model: "claude-sonnet-4-20250514",
+ * const runner = await client.beta.messages.toolRunner({
+ *   model: "gpt-5",
  *   max_tokens: 1024,
  *   tools: mcpTools(tools, mcpClient),
  *   messages: [{ role: "user", content: "Use the available tools" }],
@@ -704,11 +688,11 @@ type NoInfer<T> = T extends infer R ? R : never;
  declare function mcpTools(tools: MCPToolLike[], mcpClient: MCPClientLike, extraProps?: Partial<Omit<BetaTool, 'name' | 'description' | 'input_schema'>>): BetaRunnableTool<Record<string, unknown>>[];
 
 /**
- * Converts an MCP prompt message to an Anthropic BetaMessageParam.
+ * Converts an MCP prompt message to a BetaMessageParam.
  *
  * @param mcpMessage The MCP prompt message from `mcpClient.getPrompt()`
- * @param extraProps Additional Claude API properties to include in content blocks (e.g., `cache_control`)
- * @returns A message parameter for use with `anthropic.beta.messages.create()`
+ * @param extraProps Additional API properties to include in content blocks (e.g., `cache_control`)
+ * @returns A message parameter for use with `client.beta.messages.create()`
  * @throws {UnsupportedMCPValueError} When the message contains unsupported content types
  * @throws {UnsupportedMCPValueError} When the message contains unsupported resource links
  * @throws {UnsupportedMCPValueError} When the message contains resources with unsupported MIME types
@@ -716,19 +700,19 @@ type NoInfer<T> = T extends infer R ? R : never;
  * @example
  * ```ts
  * import { Client } from "@modelcontextprotocol/sdk/client/index.js";
- * import Anthropic from "@anthropic-ai/sdk";
- * import { mcpMessage } from "@anthropic-ai/sdk/helpers/beta/mcp";
+ * import PukuAI from "@puku-ai/sdk";
+ * import { mcpMessage } from "@puku-ai/sdk/helpers/beta/mcp";
  *
  * const mcpClient = new Client({ name: "example", version: "1.0.0" });
- * const anthropic = new Anthropic();
+ * const client = new PukuAI();
  *
  * const prompt = await mcpClient.getPrompt({
  *   name: "example-prompt",
  *   arguments: { arg1: "value" },
  * });
  *
- * await anthropic.beta.messages.create({
- *   model: "claude-sonnet-4-20250514",
+ * await client.beta.messages.create({
+ *   model: "gpt-5",
  *   max_tokens: 1024,
  *   messages: prompt.messages.map(msg => mcpMessage(msg)),
  * });
@@ -737,11 +721,11 @@ type NoInfer<T> = T extends infer R ? R : never;
  declare function mcpMessage(mcpMessage: MCPPromptMessageLike, extraProps?: Partial<Omit<BetaTextBlockParam, 'type' | 'text' | 'source'> & Omit<BetaImageBlockParam, 'type' | 'source'> & Omit<BetaRequestDocumentBlock, 'type' | 'source'>>): BetaMessageParam;
 
 /**
- * Converts an array of MCP prompt messages to Anthropic BetaMessageParams.
+ * Converts an array of MCP prompt messages to BetaMessageParams.
  *
  * @param messages Array of MCP prompt messages from `mcpClient.getPrompt()`
- * @param extraProps Additional Claude API properties to include in content blocks (e.g., `cache_control`)
- * @returns An array of message parameters for use with `anthropic.beta.messages.create()`
+ * @param extraProps Additional API properties to include in content blocks (e.g., `cache_control`)
+ * @returns An array of message parameters for use with `client.beta.messages.create()`
  * @throws {UnsupportedMCPValueError} When any message contains unsupported content types
  * @throws {UnsupportedMCPValueError} When any message contains unsupported resource links
  * @throws {UnsupportedMCPValueError} When any message contains resources with unsupported MIME types
@@ -749,8 +733,8 @@ type NoInfer<T> = T extends infer R ? R : never;
  * @example
  * ```ts
  * const { messages } = await mcpClient.getPrompt({ name: "example-prompt" });
- * await anthropic.beta.messages.create({
- *   model: "claude-sonnet-4-20250514",
+ * await client.beta.messages.create({
+ *   model: "gpt-5",
  *   max_tokens: 1024,
  *   messages: mcpMessages(messages),
  * });
@@ -759,11 +743,11 @@ type NoInfer<T> = T extends infer R ? R : never;
  declare function mcpMessages(messages: MCPPromptMessageLike[], extraProps?: Partial<Omit<BetaTextBlockParam, 'type' | 'text' | 'source'> & Omit<BetaImageBlockParam, 'type' | 'source'> & Omit<BetaRequestDocumentBlock, 'type' | 'source'>>): BetaMessageParam[];
 
 /**
- * Converts a single MCP prompt content item to an Anthropic content block.
+ * Converts a single MCP prompt content item to a content block.
  *
  * @param content The MCP content item (text, image, or embedded resource)
- * @param extraProps Additional Claude API properties to include in the content block (e.g., `cache_control`)
- * @returns A Claude content block for use in a message's content array
+ * @param extraProps Additional API properties to include in the content block (e.g., `cache_control`)
+ * @returns A content block for use in a message's content array
  * @throws {UnsupportedMCPValueError} When the content type is not supported (e.g., 'audio')
  * @throws {UnsupportedMCPValueError} When resource links use non-http/https protocols
  * @throws {UnsupportedMCPValueError} When resources have unsupported MIME types
@@ -772,8 +756,8 @@ type NoInfer<T> = T extends infer R ? R : never;
  * ```ts
  * const { messages } = await mcpClient.getPrompt({ name: "my-prompt" });
  * // If you need to mix MCP content with other content:
- * await anthropic.beta.messages.create({
- *   model: "claude-sonnet-4-20250514",
+ * await client.beta.messages.create({
+ *   model: "gpt-5",
  *   max_tokens: 1024,
  *   messages: [{
  *     role: "user",
@@ -788,29 +772,29 @@ type NoInfer<T> = T extends infer R ? R : never;
  declare function mcpContent(content: MCPPromptContentLike, extraProps?: Partial<Omit<BetaTextBlockParam, 'type' | 'text' | 'source'> & Omit<BetaImageBlockParam, 'type' | 'source'> & Omit<BetaRequestDocumentBlock, 'type' | 'source'>>): BetaTextBlockParam | BetaImageBlockParam | BetaRequestDocumentBlock;
 
 /**
- * Converts MCP resource contents to an Anthropic content block.
+ * Converts MCP resource contents to a content block.
  *
  * This helper is useful when you have resource contents from `mcpClient.readResource()`
  * and want to include them in a message or as a document source. It automatically
  * finds the first resource with a supported MIME type.
  *
  * @param result The result from `mcpClient.readResource()`
- * @param extraProps Additional Claude API properties to include in the content block (e.g., `cache_control`)
- * @returns A Claude content block
+ * @param extraProps Additional API properties to include in the content block (e.g., `cache_control`)
+ * @returns A content block
  * @throws {UnsupportedMCPValueError} When contents array is empty or none have a supported MIME type
  *
  * @example
  * ```ts
  * import { Client } from "@modelcontextprotocol/sdk/client/index.js";
- * import Anthropic from "@anthropic-ai/sdk";
- * import { mcpResourceToContent } from "@anthropic-ai/sdk/helpers/beta/mcp";
+ * import PukuAI from "@puku-ai/sdk";
+ * import { mcpResourceToContent } from "@puku-ai/sdk/helpers/beta/mcp";
  *
  * const mcpClient = new Client({ name: "example", version: "1.0.0" });
- * const anthropic = new Anthropic();
+ * const client = new PukuAI();
  *
  * const resource = await mcpClient.readResource({ uri: "file:///example.txt" });
- * await anthropic.beta.messages.create({
- *   model: "claude-sonnet-4-20250514",
+ * await client.beta.messages.create({
+ *   model: "gpt-5",
  *   max_tokens: 1024,
  *   messages: [{
  *     role: "user",
@@ -822,24 +806,24 @@ type NoInfer<T> = T extends infer R ? R : never;
  declare function mcpResourceToContent(result: MCPReadResourceResultLike, extraProps?: Partial<Omit<BetaRequestDocumentBlock, 'type' | 'source'>>): BetaTextBlockParam | BetaImageBlockParam | BetaRequestDocumentBlock;
 
 /**
- * Converts an MCP resource to a File object suitable for uploading via `anthropic.beta.files.upload()`.
+ * Converts an MCP resource to a File object suitable for uploading via `client.beta.files.upload()`.
  *
  * @param result The result from `mcpClient.readResource()`
- * @returns A File object for use with `anthropic.beta.files.upload()`
+ * @returns A File object for use with `client.beta.files.upload()`
  * @throws {UnsupportedMCPValueError} When contents array is empty
  *
  * @example
  * ```ts
  * import { Client } from "@modelcontextprotocol/sdk/client/index.js";
- * import Anthropic from "@anthropic-ai/sdk";
- * import { mcpResourceToFile } from "@anthropic-ai/sdk/helpers/beta/mcp";
+ * import PukuAI from "@puku-ai/sdk";
+ * import { mcpResourceToFile } from "@puku-ai/sdk/helpers/beta/mcp";
  *
  * const mcpClient = new Client({ name: "example", version: "1.0.0" });
- * const anthropic = new Anthropic();
+ * const client = new PukuAI();
  *
  * const resource = await mcpClient.readResource({ uri: "file:///document.pdf" });
  *
- * const uploaded = await anthropic.beta.files.upload({
+ * const uploaded = await client.beta.files.upload({
  *   file: mcpResourceToFile(resource),
  * });
  * ```
@@ -1337,7 +1321,7 @@ type LogFn = (message: string, ...rest: unknown[]) => void;
     message: (message: BetaMessage) => void;
     contentBlock: (content: BetaContentBlock) => void;
     finalMessage: (message: BetaMessage) => void;
-    error: (error: AnthropicError) => void;
+    error: (error: PukuError) => void;
     abort: (error: APIUserAbortError) => void;
     end: () => void;
 }
@@ -1356,8 +1340,8 @@ type LogFn = (message: string, ...rest: unknown[]) => void;
     get request_id(): string | null | undefined;
     /**
      * Returns the `MessageStream` data, the raw `Response` instance and the ID of the request,
-     * returned vie the `request-id` header which is useful for debugging requests and resporting
-     * issues to Anthropic.
+     * returned vie the `request-id` header which is useful for debugging requests and reporting
+     * issues.
      *
      * This is the same as the `APIPromise.withResponse()` method.
      *
@@ -1456,8 +1440,8 @@ type LogFn = (message: string, ...rest: unknown[]) => void;
     get request_id(): string | null | undefined;
     /**
      * Returns the `MessageStream` data, the raw `Response` instance and the ID of the request,
-     * returned vie the `request-id` header which is useful for debugging requests and resporting
-     * issues to Anthropic.
+     * returned vie the `request-id` header which is useful for debugging requests and reporting
+     * issues.
      *
      * This is the same as the `APIPromise.withResponse()` method.
      *
@@ -1666,7 +1650,7 @@ type StainlessHelperObject = {
  * tool-use block that triggered the run, an optional abort signal, and a
  * deprecated alias for `toolUse`.
  *
- * The shape is intentionally minimal: the upstream Anthropic SDK also wires
+ * The shape is intentionally minimal: the upstream SDK also wires
  * managed-agents events through this type, but @puku-ai/sdk does not yet
  * vendor that resource surface, so the type falls back to a
  * `BetaToolUseBlock`.
@@ -1733,7 +1717,6 @@ type StainlessHelperObject = {
      * @example
      * // Direct parameter update
      * runner.setMessagesParams({
-     *   model: 'claude-haiku-4-5',
      *   max_tokens: 500,
      * });
      *
@@ -1783,7 +1766,7 @@ type StainlessHelperObject = {
      * * If the iterator has been consumed, waits for it to complete and returns the final message.
      *
      * @returns A promise that resolves to the final BetaMessage from the conversation
-     * @throws {AnthropicError} If no messages were processed during the conversation
+     * @throws {PukuError} If no messages were processed during the conversation
      *
      * @example
      * const finalMessage = await runner.runUntilDone();
@@ -1907,7 +1890,7 @@ type StainlessHelperObject = {
     skills: SkillsAPI.Skills;
 }
 
- type AnthropicBeta = (string & {}) | 'message-batches-2024-09-24' | 'prompt-caching-2024-07-31' | 'computer-use-2024-10-22' | 'computer-use-2025-01-24' | 'pdfs-2024-09-25' | 'token-counting-2024-11-01' | 'token-efficient-tools-2025-02-19' | 'output-128k-2025-02-19' | 'files-api-2025-04-14' | 'mcp-client-2025-04-04' | 'mcp-client-2025-11-20' | 'dev-full-thinking-2025-05-14' | 'interleaved-thinking-2025-05-14' | 'code-execution-2025-05-22' | 'extended-cache-ttl-2025-04-11' | 'context-1m-2025-08-07' | 'context-management-2025-06-27' | 'model-context-window-exceeded-2025-08-26' | 'skills-2025-10-02' | 'fast-mode-2026-02-01' | 'output-300k-2026-03-24';
+ type PukuBeta = (string & {}) | 'message-batches-2024-09-24' | 'prompt-caching-2024-07-31' | 'computer-use-2024-10-22' | 'computer-use-2025-01-24' | 'pdfs-2024-09-25' | 'token-counting-2024-11-01' | 'token-efficient-tools-2025-02-19' | 'output-128k-2025-02-19' | 'files-api-2025-04-14' | 'mcp-client-2025-04-04' | 'mcp-client-2025-11-20' | 'dev-full-thinking-2025-05-14' | 'interleaved-thinking-2025-05-14' | 'code-execution-2025-05-22' | 'extended-cache-ttl-2025-04-11' | 'context-1m-2025-08-07' | 'context-management-2025-06-27' | 'model-context-window-exceeded-2025-08-26' | 'skills-2025-10-02' | 'fast-mode-2026-02-01' | 'output-300k-2026-03-24';
 
  interface BetaAPIError {
     message: string;
@@ -2077,28 +2060,28 @@ type StainlessHelperObject = {
     /**
      * Header param: Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface FileDeleteParams {
     /**
      * Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface FileDownloadParams {
     /**
      * Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface FileRetrieveMetadataParams {
     /**
      * Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface FileUploadParams {
@@ -2109,7 +2092,7 @@ type StainlessHelperObject = {
     /**
      * Header param: Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  declare class Batches extends APIResource {
@@ -2120,8 +2103,7 @@ type StainlessHelperObject = {
      * once. Once a Message Batch is created, it begins processing immediately. Batches
      * can take up to 24 hours to complete.
      *
-     * Learn more about the Message Batches API in our
-     * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
+     * Learn more about the Message Batches API in the SDK README.
      *
      * @example
      * ```ts
@@ -2135,7 +2117,7 @@ type StainlessHelperObject = {
      *           messages: [
      *             { content: 'Hello, world', role: 'user' },
      *           ],
-     *           model: 'claude-opus-4-6',
+     *           model: 'gpt-5',
      *         },
      *       },
      *     ],
@@ -2148,8 +2130,7 @@ type StainlessHelperObject = {
      * completion. To access the results of a Message Batch, make a request to the
      * `results_url` field in the response.
      *
-     * Learn more about the Message Batches API in our
-     * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
+     * Learn more about the Message Batches API in the SDK README.
      *
      * @example
      * ```ts
@@ -2164,8 +2145,7 @@ type StainlessHelperObject = {
      * List all Message Batches within a Workspace. Most recently created batches are
      * returned first.
      *
-     * Learn more about the Message Batches API in our
-     * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
+     * Learn more about the Message Batches API in the SDK README.
      *
      * @example
      * ```ts
@@ -2182,8 +2162,7 @@ type StainlessHelperObject = {
      * Message Batches can only be deleted once they've finished processing. If you'd
      * like to delete an in-progress batch, you must first cancel it.
      *
-     * Learn more about the Message Batches API in our
-     * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
+     * Learn more about the Message Batches API in the SDK README.
      *
      * @example
      * ```ts
@@ -2205,8 +2184,7 @@ type StainlessHelperObject = {
      * Note that cancellation may not result in any canceled requests if they were
      * non-interruptible.
      *
-     * Learn more about the Message Batches API in our
-     * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
+     * Learn more about the Message Batches API in the SDK README.
      *
      * @example
      * ```ts
@@ -2224,8 +2202,7 @@ type StainlessHelperObject = {
      * in the Message Batch. Results are not guaranteed to be in the same order as
      * requests. Use the `custom_id` field to match results to requests.
      *
-     * Learn more about the Message Batches API in our
-     * [user guide](https://docs.claude.com/en/docs/build-with-claude/batch-processing)
+     * Learn more about the Message Batches API in the SDK README.
      *
      * @example
      * ```ts
@@ -2405,42 +2382,42 @@ type StainlessHelperObject = {
     /**
      * Header param: Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface BatchRetrieveParams {
     /**
      * Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface BatchListParams extends PageParams {
     /**
      * Header param: Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface BatchDeleteParams {
     /**
      * Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface BatchCancelParams {
     /**
      * Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface BatchResultsParams {
     /**
      * Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  declare class Messages extends APIResource {
@@ -2453,7 +2430,7 @@ type StainlessHelperObject = {
      * conversations.
      *
      * Learn more about the Messages API in our
-     * [user guide](https://docs.claude.com/en/docs/initial-setup)
+     * See the SDK README for details.
      *
      * @example
      * ```ts
@@ -2495,7 +2472,7 @@ type StainlessHelperObject = {
      * including tools, images, and documents, without creating it.
      *
      * Learn more about token counting in our
-     * [user guide](https://docs.claude.com/en/docs/build-with-claude/token-counting)
+     * See the SDK README for details.
      *
      * @example
      * ```ts
@@ -3433,7 +3410,7 @@ type StainlessHelperObject = {
      * Example:
      *
      * ```json
-     * [{ "type": "text", "text": "Hi, I'm Claude." }]
+     * [{ "type": "text", "text": "Hi, I'm the assistant." }]
      * ```
      *
      * If the request input `messages` ended with an `assistant` turn, then the
@@ -3467,7 +3444,7 @@ type StainlessHelperObject = {
     context_management: BetaContextManagementResponse | null;
     /**
      * The model that will complete your prompt.\n\nSee
-     * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+     * See the SDK README for additional
      * details and options.
      */
     model: MessagesAPI.Model;
@@ -3511,7 +3488,7 @@ type StainlessHelperObject = {
     /**
      * Billing and rate-limit usage.
      *
-     * Anthropic's API bills and rate-limits by token counts, as tokens represent the
+     * The API bills and rate-limits by token counts, as tokens represent the
      * underlying cost to our systems.
      *
      * Under the hood, the API transforms requests into a format suitable for the
@@ -3520,7 +3497,7 @@ type StainlessHelperObject = {
      * with the exact visible content of an API request or response.
      *
      * For example, `output_tokens` will be non-zero, even for an empty string response
-     * from Claude.
+     * from the model.
      *
      * Total input tokens in a request is the summation of `input_tokens`,
      * `cache_creation_input_tokens`, and `cache_read_input_tokens`.
@@ -3613,7 +3590,7 @@ type StainlessHelperObject = {
     /**
      * An external identifier for the user who is associated with the request.
      *
-     * This should be a uuid, hash value, or other opaque identifier. Anthropic may use
+     * This should be a uuid, hash value, or other opaque identifier. The service may use
      * this id to help detect abuse. Do not include any identifying information such as
      * name, email address, or phone number.
      */
@@ -3626,8 +3603,8 @@ type StainlessHelperObject = {
      */
     effort?: 'low' | 'medium' | 'high' | 'max' | null;
     /**
-     * A schema to specify Claude's output format in responses. See
-     * [structured outputs](https://platform.claude.com/docs/en/build-with-claude/structured-outputs)
+     * A schema to specify the model's output format in responses. See
+     * the SDK README for more details on structured outputs.
      */
     format?: BetaJSONOutputFormat | null;
 }
@@ -3670,7 +3647,7 @@ type StainlessHelperObject = {
     /**
      * Billing and rate-limit usage.
      *
-     * Anthropic's API bills and rate-limits by token counts, as tokens represent the
+     * The API bills and rate-limits by token counts, as tokens represent the
      * underlying cost to our systems.
      *
      * Under the hood, the API transforms requests into a format suitable for the
@@ -3679,7 +3656,7 @@ type StainlessHelperObject = {
      * with the exact visible content of an API request or response.
      *
      * For example, `output_tokens` will be non-zero, even for an empty string response
-     * from Claude.
+     * from the model.
      *
      * Total input tokens in a request is the summation of `input_tokens`,
      * `cache_creation_input_tokens`, and `cache_read_input_tokens`.
@@ -3986,14 +3963,14 @@ type StainlessHelperObject = {
 
  interface BetaThinkingConfigEnabled {
     /**
-     * Determines how many tokens Claude can use for its internal reasoning process.
+     * Determines how many tokens the model can use for its internal reasoning process.
      * Larger budgets can enable more thorough analysis for complex problems, improving
      * response quality.
      *
      * Must be ≥1024 and less than `max_tokens`.
      *
      * See
-     * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
+     * See the SDK README for details.
      * for details.
      */
     budget_tokens: number;
@@ -4008,15 +3985,13 @@ type StainlessHelperObject = {
 }
 
 /**
- * Configuration for enabling Claude's extended thinking.
+ * Configuration for enabling extended thinking.
  *
- * When enabled, responses include `thinking` content blocks showing Claude's
+ * When enabled, responses include `thinking` content blocks showing the model's
  * thinking process before the final answer. Requires a minimum budget of 1,024
  * tokens and counts towards your `max_tokens` limit.
  *
- * See
- * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
- * for details.
+ * See the SDK README for details.
  */
  type BetaThinkingConfigParam = BetaThinkingConfigEnabled | BetaThinkingConfigDisabled | BetaThinkingConfigAdaptive;
 
@@ -5033,7 +5008,7 @@ type StainlessHelperObject = {
      * only specifies the absolute maximum number of tokens to generate.
      *
      * Different models have different maximum values for this parameter. See
-     * [models](https://docs.claude.com/en/docs/models-overview) for details.
+     * See the SDK README for details.
      */
     max_tokens: number;
     /**
@@ -5056,7 +5031,7 @@ type StainlessHelperObject = {
      * Example with a single `user` message:
      *
      * ```json
-     * [{ "role": "user", "content": "Hello, Claude" }]
+     * [{ "role": "user", "content": "Hello, assistant" }]
      * ```
      *
      * Example with multiple conversational turns:
@@ -5064,12 +5039,12 @@ type StainlessHelperObject = {
      * ```json
      * [
      *   { "role": "user", "content": "Hello there." },
-     *   { "role": "assistant", "content": "Hi, I'm Claude. How can I help you?" },
+     *   { "role": "assistant", "content": "Hi, I'm the assistant. How can I help you?" },
      *   { "role": "user", "content": "Can you explain LLMs in plain English?" }
      * ]
      * ```
      *
-     * Example with a partially-filled response from Claude:
+     * Example with a partially-filled response from the model:
      *
      * ```json
      * [
@@ -5087,17 +5062,17 @@ type StainlessHelperObject = {
      * following input messages are equivalent:
      *
      * ```json
-     * { "role": "user", "content": "Hello, Claude" }
+     * { "role": "user", "content": "Hello, assistant" }
      * ```
      *
      * ```json
-     * { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
+     * { "role": "user", "content": [{ "type": "text", "text": "Hello, assistant" }] }
      * ```
      *
-     * See [input examples](https://docs.claude.com/en/api/messages-examples).
+     * See the SDK README for input examples.
      *
      * Note that if you want to include a
-     * [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
+     * system prompt, you can use the
      * top-level `system` parameter — there is no `"system"` role for input messages in
      * the Messages API.
      *
@@ -5106,7 +5081,7 @@ type StainlessHelperObject = {
     messages: Array<BetaMessageParam>;
     /**
      * Body param: The model that will complete your prompt.\n\nSee
-     * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+     * See the SDK README for additional
      * details and options.
      */
     model: MessagesAPI.Model;
@@ -5122,7 +5097,7 @@ type StainlessHelperObject = {
     /**
      * Body param: Context management configuration.
      *
-     * This allows you to control how Claude manages context across multiple requests,
+     * This allows you to control how the model manages context across multiple requests,
      * such as whether to clear function results or not.
      */
     context_management?: BetaContextManagementConfig | null;
@@ -5148,7 +5123,7 @@ type StainlessHelperObject = {
      * Body param: Deprecated: Use `output_config.format` instead. See
      * [structured outputs](https://platform.claude.com/docs/en/build-with-claude/structured-outputs)
      *
-     * A schema to specify Claude's output format in responses. This parameter will be
+     * A schema to specify the model's output format in responses. This parameter will be
      * removed in a future release.
      */
     output_format?: BetaJSONOutputFormat | null;
@@ -5156,8 +5131,8 @@ type StainlessHelperObject = {
      * Body param: Determines whether to use priority capacity (if available) or
      * standard capacity for this request.
      *
-     * Anthropic offers different levels of service for your API requests. See
-     * [service-tiers](https://docs.claude.com/en/api/service-tiers) for details.
+     * The service offers different levels of priority for your API requests. See
+     * the SDK README for details.
      */
     service_tier?: 'auto' | 'standard_only';
     /**
@@ -5181,15 +5156,15 @@ type StainlessHelperObject = {
      * Body param: Whether to incrementally stream the response using server-sent
      * events.
      *
-     * See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
+     * See the SDK README for streaming details.
      */
     stream?: boolean;
     /**
      * Body param: System prompt.
      *
-     * A system prompt is a way of providing context and instructions to Claude, such
-     * as specifying a particular goal or role. See our
-     * [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
+     * A system prompt is a way of providing context and instructions to the model, such
+     * as specifying a particular goal or role. See the SDK README for more details.
+     * guide to system prompts.
      */
     system?: string | Array<BetaTextBlockParam>;
     /**
@@ -5204,14 +5179,14 @@ type StainlessHelperObject = {
      */
     temperature?: number;
     /**
-     * Body param: Configuration for enabling Claude's extended thinking.
+     * Body param: Configuration for enabling extended thinking.
      *
-     * When enabled, responses include `thinking` content blocks showing Claude's
+     * When enabled, responses include `thinking` content blocks showing the model's
      * thinking process before the final answer. Requires a minimum budget of 1,024
      * tokens and counts towards your `max_tokens` limit.
      *
      * See
-     * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
+     * See the SDK README for details.
      * for details.
      */
     thinking?: BetaThinkingConfigParam;
@@ -5230,9 +5205,9 @@ type StainlessHelperObject = {
      *
      * There are two types of tools: **client tools** and **server tools**. The
      * behavior described below applies to client tools. For
-     * [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+     * server tools,
      * see their individual documentation as each has its own behavior (e.g., the
-     * [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+     * web search tool).
      *
      * Each tool definition includes:
      *
@@ -5295,7 +5270,7 @@ type StainlessHelperObject = {
      * functions, or more generally whenever you want the model to produce a particular
      * JSON structure of output.
      *
-     * See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
+     * See the SDK README for more details.
      */
     tools?: Array<BetaToolUnion>;
     /**
@@ -5323,7 +5298,7 @@ type StainlessHelperObject = {
     /**
      * Header param: Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface MessageCreateParamsNonStreaming extends MessageCreateParamsBase {
@@ -5331,7 +5306,7 @@ type StainlessHelperObject = {
      * Body param: Whether to incrementally stream the response using server-sent
      * events.
      *
-     * See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
+     * See the SDK README for streaming details.
      */
     stream?: false;
 }
@@ -5341,7 +5316,7 @@ type StainlessHelperObject = {
      * Body param: Whether to incrementally stream the response using server-sent
      * events.
      *
-     * See [streaming](https://docs.claude.com/en/api/messages-streaming) for details.
+     * See the SDK README for streaming details.
      */
     stream: true;
 }
@@ -5367,7 +5342,7 @@ type StainlessHelperObject = {
      * Example with a single `user` message:
      *
      * ```json
-     * [{ "role": "user", "content": "Hello, Claude" }]
+     * [{ "role": "user", "content": "Hello, assistant" }]
      * ```
      *
      * Example with multiple conversational turns:
@@ -5375,12 +5350,12 @@ type StainlessHelperObject = {
      * ```json
      * [
      *   { "role": "user", "content": "Hello there." },
-     *   { "role": "assistant", "content": "Hi, I'm Claude. How can I help you?" },
+     *   { "role": "assistant", "content": "Hi, I'm the assistant. How can I help you?" },
      *   { "role": "user", "content": "Can you explain LLMs in plain English?" }
      * ]
      * ```
      *
-     * Example with a partially-filled response from Claude:
+     * Example with a partially-filled response from the model:
      *
      * ```json
      * [
@@ -5398,17 +5373,17 @@ type StainlessHelperObject = {
      * following input messages are equivalent:
      *
      * ```json
-     * { "role": "user", "content": "Hello, Claude" }
+     * { "role": "user", "content": "Hello, assistant" }
      * ```
      *
      * ```json
-     * { "role": "user", "content": [{ "type": "text", "text": "Hello, Claude" }] }
+     * { "role": "user", "content": [{ "type": "text", "text": "Hello, assistant" }] }
      * ```
      *
-     * See [input examples](https://docs.claude.com/en/api/messages-examples).
+     * See the SDK README for input examples.
      *
      * Note that if you want to include a
-     * [system prompt](https://docs.claude.com/en/docs/system-prompts), you can use the
+     * system prompt, you can use the
      * top-level `system` parameter — there is no `"system"` role for input messages in
      * the Messages API.
      *
@@ -5417,7 +5392,7 @@ type StainlessHelperObject = {
     messages: Array<BetaMessageParam>;
     /**
      * Body param: The model that will complete your prompt.\n\nSee
-     * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+     * See the SDK README for additional
      * details and options.
      */
     model: MessagesAPI.Model;
@@ -5429,7 +5404,7 @@ type StainlessHelperObject = {
     /**
      * Body param: Context management configuration.
      *
-     * This allows you to control how Claude manages context across multiple requests,
+     * This allows you to control how the model manages context across multiple requests,
      * such as whether to clear function results or not.
      */
     context_management?: BetaContextManagementConfig | null;
@@ -5446,7 +5421,7 @@ type StainlessHelperObject = {
      * Body param: Deprecated: Use `output_config.format` instead. See
      * [structured outputs](https://platform.claude.com/docs/en/build-with-claude/structured-outputs)
      *
-     * A schema to specify Claude's output format in responses. This parameter will be
+     * A schema to specify the model's output format in responses. This parameter will be
      * removed in a future release.
      */
     output_format?: BetaJSONOutputFormat | null;
@@ -5458,20 +5433,20 @@ type StainlessHelperObject = {
     /**
      * Body param: System prompt.
      *
-     * A system prompt is a way of providing context and instructions to Claude, such
-     * as specifying a particular goal or role. See our
-     * [guide to system prompts](https://docs.claude.com/en/docs/system-prompts).
+     * A system prompt is a way of providing context and instructions to the model, such
+     * as specifying a particular goal or role. See the SDK README for more details.
+     * guide to system prompts.
      */
     system?: string | Array<BetaTextBlockParam>;
     /**
-     * Body param: Configuration for enabling Claude's extended thinking.
+     * Body param: Configuration for enabling extended thinking.
      *
-     * When enabled, responses include `thinking` content blocks showing Claude's
+     * When enabled, responses include `thinking` content blocks showing the model's
      * thinking process before the final answer. Requires a minimum budget of 1,024
      * tokens and counts towards your `max_tokens` limit.
      *
      * See
-     * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
+     * See the SDK README for details.
      * for details.
      */
     thinking?: BetaThinkingConfigParam;
@@ -5490,9 +5465,9 @@ type StainlessHelperObject = {
      *
      * There are two types of tools: **client tools** and **server tools**. The
      * behavior described below applies to client tools. For
-     * [server tools](https://docs.claude.com/en/docs/agents-and-tools/tool-use/overview#server-tools),
+     * server tools,
      * see their individual documentation as each has its own behavior (e.g., the
-     * [web search tool](https://docs.claude.com/en/docs/agents-and-tools/tool-use/web-search-tool)).
+     * web search tool).
      *
      * Each tool definition includes:
      *
@@ -5555,13 +5530,13 @@ type StainlessHelperObject = {
      * functions, or more generally whenever you want the model to produce a particular
      * JSON structure of output.
      *
-     * See our [guide](https://docs.claude.com/en/docs/tool-use) for more details.
+     * See the SDK README for more details.
      */
     tools?: Array<BetaTool | BetaToolBash20241022 | BetaToolBash20250124 | BetaCodeExecutionTool20250522 | BetaCodeExecutionTool20250825 | BetaCodeExecutionTool20260120 | BetaToolComputerUse20241022 | BetaMemoryTool20250818 | BetaToolComputerUse20250124 | BetaToolTextEditor20241022 | BetaToolComputerUse20251124 | BetaToolTextEditor20250124 | BetaToolTextEditor20250429 | BetaToolTextEditor20250728 | BetaWebSearchTool20250305 | BetaWebFetchTool20250910 | BetaWebSearchTool20260209 | BetaWebFetchTool20260209 | BetaWebFetchTool20260309 | BetaToolSearchToolBm25_20251119 | BetaToolSearchToolRegex20251119 | BetaMCPToolset>;
     /**
      * Header param: Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  declare class Models extends APIResource {
@@ -5764,14 +5739,14 @@ type StainlessHelperObject = {
     /**
      * Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface ModelListParams extends PageParams {
     /**
      * Header param: Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  declare class Skills extends APIResource {
@@ -5849,7 +5824,7 @@ type StainlessHelperObject = {
      * This may be one of the following values:
      *
      * - `"custom"`: the skill was created by a user
-     * - `"anthropic"`: the skill was created by Anthropic
+     * - `"puku"`: the skill was created by Puku
      */
     source: string;
     /**
@@ -5894,7 +5869,7 @@ type StainlessHelperObject = {
      * This may be one of the following values:
      *
      * - `"custom"`: the skill was created by a user
-     * - `"anthropic"`: the skill was created by Anthropic
+     * - `"puku"`: the skill was created by Puku
      */
     source: string;
     /**
@@ -5939,7 +5914,7 @@ type StainlessHelperObject = {
      * This may be one of the following values:
      *
      * - `"custom"`: the skill was created by a user
-     * - `"anthropic"`: the skill was created by Anthropic
+     * - `"puku"`: the skill was created by Puku
      */
     source: string;
     /**
@@ -5987,14 +5962,14 @@ type StainlessHelperObject = {
     /**
      * Header param: Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface SkillRetrieveParams {
     /**
      * Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface SkillListParams extends PageCursorParams {
@@ -6004,20 +5979,20 @@ type StainlessHelperObject = {
      * If provided, only skills from the specified source will be returned:
      *
      * - `"custom"`: only return user-created skills
-     * - `"anthropic"`: only return Anthropic-created skills
+     * - `"puku"`: only return Puku-created skills
      */
     source?: string | null;
     /**
      * Header param: Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface SkillDeleteParams {
     /**
      * Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  declare class Versions extends APIResource {
@@ -6241,7 +6216,7 @@ type StainlessHelperObject = {
     /**
      * Header param: Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface VersionRetrieveParams {
@@ -6254,14 +6229,14 @@ type StainlessHelperObject = {
     /**
      * Header param: Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface VersionListParams extends PageCursorParams {
     /**
      * Header param: Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface VersionDeleteParams {
@@ -6274,7 +6249,7 @@ type StainlessHelperObject = {
     /**
      * Header param: Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  declare class Completions extends APIResource {
@@ -6282,17 +6257,16 @@ type StainlessHelperObject = {
      * [Legacy] Create a Text Completion.
      *
      * The Text Completions API is a legacy API. We recommend using the
-     * [Messages API](https://docs.claude.com/en/api/messages) going forward.
+     * Messages API going forward.
      *
-     * Future models and features will not be compatible with Text Completions. See our
-     * [migration guide](https://docs.claude.com/en/api/migrating-from-text-completions-to-messages)
-     * for guidance in migrating from Text Completions to Messages.
+     * Future models and features will not be compatible with Text Completions. See the
+     * SDK README for guidance in migrating from Text Completions to Messages.
      *
      * @example
      * ```ts
      * const completion = await client.completions.create({
      *   max_tokens_to_sample: 256,
-     *   model: 'claude-opus-4-6',
+     *   model: 'gpt-5',
      *   prompt: '\n\nHuman: Hello, world!\n\nAssistant:',
      * });
      * ```
@@ -6314,8 +6288,7 @@ type StainlessHelperObject = {
      */
     completion: string;
     /**
-     * The model that will complete your prompt.\n\nSee
-     * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+     * The model that will complete your prompt.\n\nSee the SDK README for additional
      * details and options.
      */
     model: MessagesAPI.Model;
@@ -6348,13 +6321,12 @@ type StainlessHelperObject = {
      */
     max_tokens_to_sample: number;
     /**
-     * Body param: The model that will complete your prompt.\n\nSee
-     * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
-     * details and options.
+     * Body param: The model that will complete your prompt.\n\nSee the SDK README
+     * for additional details and options.
      */
     model: MessagesAPI.Model;
     /**
-     * Body param: The prompt that you want Claude to complete.
+     * Body param: The prompt that you want the model to complete.
      *
      * For proper response generation you will need to format your prompt using
      * alternating `\n\nHuman:` and `\n\nAssistant:` conversational turns. For example:
@@ -6363,9 +6335,7 @@ type StainlessHelperObject = {
      * "\n\nHuman: {userQuestion}\n\nAssistant:"
      * ```
      *
-     * See [prompt validation](https://docs.claude.com/en/api/prompt-validation) and
-     * our guide to [prompt design](https://docs.claude.com/en/docs/intro-to-prompting)
-     * for more details.
+     * See the SDK README for prompt validation and prompt design guidance.
      */
     prompt: string;
     /**
@@ -6384,7 +6354,7 @@ type StainlessHelperObject = {
      * Body param: Whether to incrementally stream the response using server-sent
      * events.
      *
-     * See [streaming](https://docs.claude.com/en/api/streaming) for details.
+     * See the SDK README for streaming details.
      */
     stream?: boolean;
     /**
@@ -6423,7 +6393,7 @@ type StainlessHelperObject = {
     /**
      * Header param: Optional header to specify the beta version(s) you want to use.
      */
-    betas?: Array<BetaAPI.AnthropicBeta>;
+    betas?: Array<BetaAPI.PukuBeta>;
 }
 
  interface CompletionCreateParamsNonStreaming extends CompletionCreateParamsBase {
@@ -6431,7 +6401,7 @@ type StainlessHelperObject = {
      * Body param: Whether to incrementally stream the response using server-sent
      * events.
      *
-     * See [streaming](https://docs.claude.com/en/api/streaming) for details.
+     * See the SDK README for streaming details.
      */
     stream?: false;
 }
@@ -6441,7 +6411,7 @@ type StainlessHelperObject = {
      * Body param: Whether to incrementally stream the response using server-sent
      * events.
      *
-     * See [streaming](https://docs.claude.com/en/api/streaming) for details.
+     * See the SDK README for streaming details.
      */
     stream: true;
 }
@@ -7127,7 +7097,7 @@ type StainlessHelperObject = {
      * Example:
      *
      * ```json
-     * [{ "type": "text", "text": "Hi, I'm Claude." }]
+     * [{ "type": "text", "text": "Hi, I'm the assistant." }]
      * ```
      *
      * If the request input `messages` ended with an `assistant` turn, then the
@@ -7155,7 +7125,7 @@ type StainlessHelperObject = {
     content: Array<ContentBlock>;
     /**
      * The model that will complete your prompt.\n\nSee
-     * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+     * See the SDK README for additional
      * details and options.
      */
     model: Model;
@@ -7199,7 +7169,7 @@ type StainlessHelperObject = {
     /**
      * Billing and rate-limit usage.
      *
-     * Anthropic's API bills and rate-limits by token counts, as tokens represent the
+     * The API bills and rate-limits by token counts, as tokens represent the
      * underlying cost to our systems.
      *
      * Under the hood, the API transforms requests into a format suitable for the
@@ -7208,7 +7178,7 @@ type StainlessHelperObject = {
      * with the exact visible content of an API request or response.
      *
      * For example, `output_tokens` will be non-zero, even for an empty string response
-     * from Claude.
+     * from the model.
      *
      * Total input tokens in a request is the summation of `input_tokens`,
      * `cache_creation_input_tokens`, and `cache_read_input_tokens`.
@@ -7262,7 +7232,7 @@ type StainlessHelperObject = {
     /**
      * An external identifier for the user who is associated with the request.
      *
-     * This should be a uuid, hash value, or other opaque identifier. Anthropic may use
+     * This should be a uuid, hash value, or other opaque identifier. The service may use
      * this id to help detect abuse. Do not include any identifying information such as
      * name, email address, or phone number.
      */
@@ -7271,7 +7241,7 @@ type StainlessHelperObject = {
 
 /**
  * The model that will complete your prompt.\n\nSee
- * [models](https://docs.anthropic.com/en/docs/models-overview) for additional
+ * See the SDK README for additional
  * details and options.
  */
  type Model = 'claude-opus-4-6' | 'claude-sonnet-4-6' | 'claude-haiku-4-5' | 'claude-haiku-4-5-20251001' | 'claude-opus-4-5' | 'claude-opus-4-5-20251101' | 'claude-sonnet-4-5' | 'claude-sonnet-4-5-20250929' | 'claude-opus-4-1' | 'claude-opus-4-1-20250805' | 'claude-opus-4-0' | 'claude-opus-4-20250514' | 'claude-sonnet-4-0' | 'claude-sonnet-4-20250514' | 'claude-3-haiku-20240307' | (string & {});
@@ -7282,8 +7252,8 @@ type StainlessHelperObject = {
      */
     effort?: 'low' | 'medium' | 'high' | 'max' | null;
     /**
-     * A schema to specify Claude's output format in responses. See
-     * [structured outputs](https://platform.claude.com/docs/en/build-with-claude/structured-outputs)
+     * A schema to specify the model's output format in responses. See
+     * the SDK README for details on structured outputs.
      */
     format?: JSONOutputFormat | null;
 }
@@ -7322,7 +7292,7 @@ type StainlessHelperObject = {
     /**
      * Billing and rate-limit usage.
      *
-     * Anthropic's API bills and rate-limits by token counts, as tokens represent the
+     * The API bills and rate-limits by token counts, as tokens represent the
      * underlying cost to our systems.
      *
      * Under the hood, the API transforms requests into a format suitable for the
@@ -7331,7 +7301,7 @@ type StainlessHelperObject = {
      * with the exact visible content of an API request or response.
      *
      * For example, `output_tokens` will be non-zero, even for an empty string response
-     * from Claude.
+     * from the model.
      *
      * Total input tokens in a request is the summation of `input_tokens`,
      * `cache_creation_input_tokens`, and `cache_read_input_tokens`.
@@ -7566,14 +7536,14 @@ type StainlessHelperObject = {
 
  interface ThinkingConfigEnabled {
     /**
-     * Determines how many tokens Claude can use for its internal reasoning process.
+     * Determines how many tokens the model can use for its internal reasoning process.
      * Larger budgets can enable more thorough analysis for complex problems, improving
      * response quality.
      *
      * Must be ≥1024 and less than `max_tokens`.
      *
      * See
-     * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
+     * See the SDK README for details.
      * for details.
      */
     budget_tokens: number;
@@ -7588,14 +7558,14 @@ type StainlessHelperObject = {
 }
 
 /**
- * Configuration for enabling Claude's extended thinking.
+ * Configuration for enabling extended thinking.
  *
- * When enabled, responses include `thinking` content blocks showing Claude's
+ * When enabled, responses include `thinking` content blocks showing the model's
  * thinking process before the final answer. Requires a minimum budget of 1,024
  * tokens and counts towards your `max_tokens` limit.
  *
  * See
- * [extended thinking](https://docs.claude.com/en/docs/build-with-claude/extended-thinking)
+ * See the SDK README for details.
  * for details.
  */
  type ThinkingConfigParam = ThinkingConfigEnabled | ThinkingConfigDisabled | ThinkingConfigAdaptive;
@@ -8616,7 +8586,7 @@ type StainlessHelperObject = {
  * A bash command exceeded its `timeoutMs`. Carries the timeout so a caller can
  * tell it apart from an abort without matching on the message text.
  */
- declare class BashTimeoutError extends AnthropicError {
+ declare class BashTimeoutError extends PukuError {
     readonly timeoutMs: number;
     constructor(timeoutMs: number);
 }
@@ -8647,17 +8617,17 @@ type StainlessHelperObject = {
      */
     unrestrictedPaths?: boolean;
     /**
-     * Anthropic client. Optional — the bare toolset needs no client; it is only
+     * PukuAI client. Optional — the bare toolset needs no client; it is only
      * used by `setupSkills`, which (together with {@link AgentToolContext.sessionId})
      * fetches the session's resolved agent and downloads each of its skills into
      * `{workdir}/skills/<name>/`.
      */
-    client?: Anthropic;
+    client?: PukuAI;
     /** Session whose agent's skills `setupSkills` should download. */
     sessionId?: string;
     /**
      * Optional environment for the bash subprocess. When unset, the bash tool
-     * inherits the process environment with the runner's `ANTHROPIC_*`
+     * inherits the process environment with the runner's `PUKU_*`
      * credentials scrubbed. When provided, it FULLY REPLACES that default
      * environment — the mapping is used verbatim and is NOT merged with or added
      * to the scrubbed process environment. To keep the defaults plus extra vars,
@@ -8710,7 +8680,7 @@ type StainlessHelperObject = {
  * Residual TOCTOU: a component could still be swapped for a symlink between this
  * call and the eventual `fs` operation. Closing that fully needs per-component
  * `O_NOFOLLOW`/`openat`, which Node does not expose ergonomically; the same
- * residual exposure exists in `tools/memory/node` and is why a sandbox is still
+ * residual exposure exists in the upstream `tools/memory/node` and is why a sandbox is still
  * recommended for the toolset as a whole.
  */
  declare function resolvePath(ctx: AgentToolContext, p: string): Promise<string>;
@@ -8762,7 +8732,7 @@ type StainlessHelperObject = {
  * @puku-ai/sdk stub — throws because `client.beta.skills.versions.list`
  * isn't vendored yet. Pass a numeric version directly to skip resolution.
  */
- declare function resolveSkillVersion(_client: Anthropic, skillId: string, version: string): Promise<string>;
+ declare function resolveSkillVersion(_client: PukuAI, skillId: string, version: string): Promise<string>;
 
 /**
  * Extract a skill archive (`Response` body) into `dest`.
@@ -8810,16 +8780,16 @@ type StainlessHelperObject = {
  declare function readHead(file: string, n: number): Promise<Buffer>;
  declare const VERSION = "0.81.0";
 
-export { default, VERSION, PukuError, betaTool, betaJSONSchemaOutputFormat, betaZodTool, betaZodOutputFormat, InputSchema };
+export { default, VERSION, betaTool, betaJSONSchemaOutputFormat, betaZodTool, betaZodOutputFormat, InputSchema, betaMemoryTool };
 
-export { betaMemoryTool, MemoryToolHandlers, mcpTool, mcpTools, mcpMessage, mcpMessages, mcpContent, mcpResourceToContent };
+export { MemoryToolHandlers, mcpTool, mcpTools, mcpMessage, mcpMessages, mcpContent, mcpResourceToContent, mcpResourceToFile };
 
-export { mcpResourceToFile, UnsupportedMCPValueError, MCPToolLike, MCPCallToolResultLike, MCPToolResultContentLike, MCPTextContentLike, MCPImageContentLike, MCPAudioContentLike };
+export { UnsupportedMCPValueError, MCPToolLike, MCPCallToolResultLike, MCPToolResultContentLike, MCPTextContentLike, MCPImageContentLike, MCPAudioContentLike, MCPEmbeddedResourceLike };
 
-export { MCPEmbeddedResourceLike, MCPResourceLinkLike, MCPTextResourceContentsLike, MCPBlobResourceContentsLike, MCPResourceContentsLike, MCPClientLike, MCPPromptMessageLike, MCPPromptContentLike };
+export { MCPResourceLinkLike, MCPTextResourceContentsLike, MCPBlobResourceContentsLike, MCPResourceContentsLike, MCPClientLike, MCPPromptMessageLike, MCPPromptContentLike, MCPReadResourceResultLike };
 
-export { MCPReadResourceResultLike, ToolError, Promisable, BetaToolRunContext, BetaClientRunnableToolType, betaAgentToolset20260401, betaBashTool, betaReadTool };
+export { ToolError, Promisable, BetaToolRunContext, BetaClientRunnableToolType, betaAgentToolset20260401, betaBashTool, betaReadTool, betaWriteTool };
 
-export { betaWriteTool, betaEditTool, betaGlobTool, betaGrepTool, resolvePath, BashSession, BashTimeoutError, setupSkills };
+export { betaEditTool, betaGlobTool, betaGrepTool, resolvePath, BashSession, BashTimeoutError, setupSkills, resolveSkillVersion };
 
-export { resolveSkillVersion, extractSkillArchive, AgentToolContext };
+export { extractSkillArchive, AgentToolContext };