@puku-ai/sdk 3.0.1 → 3.0.2

package/sdk.d.ts

@@ -97,7 +97,7 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
 /**
  * Base class for Anthropic API clients.
  */
- declare class BaseAnthropic {
+ declare class BasePuku {
     #private;
     apiKey: string | null;
     baseURL: string;
@@ -179,12 +179,13 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
     private buildHeaders;
     private _makeAbort;
     private buildBody;
-    static Anthropic: typeof BaseAnthropic;
-    static PukuAI: typeof BaseAnthropic;
+    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;
     static APIConnectionTimeoutError: typeof Errors.APIConnectionTimeoutError;
@@ -208,7 +209,7 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
  * `import PukuAI from "@puku-ai/sdk"`.  `Anthropic` is kept as a static
  * property pointing to the same class for source-compat.
  */
- declare class PukuAI extends BaseAnthropic {
+ declare class PukuAI extends BasePuku {
     completions: API.Completions;
     messages: API.Messages;
     models: API.Models;
@@ -224,7 +225,7 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
     private responsePromise;
     private parseResponse;
     private parsedPromise;
-    constructor(client: BaseAnthropic, responsePromise: Promise<APIResponseProps>, parseResponse?: (client: BaseAnthropic, props: APIResponseProps) => PromiseOrValue<WithRequestID<T>>);
+    constructor(client: BasePuku, responsePromise: Promise<APIResponseProps>, parseResponse?: (client: BasePuku, props: APIResponseProps) => PromiseOrValue<WithRequestID<T>>);
     _thenUnwrap<U>(transform: (data: T, props: APIResponseProps) => U): APIPromise<U>;
     /**
      * Gets the raw `Response` instance instead of parsing the response
@@ -261,10 +262,32 @@ 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 {
 }
 
- declare class APIError<TStatus extends number | undefined = number | undefined, THeaders extends Headers | undefined = Headers | undefined, TError extends Object | undefined = Object | undefined> extends AnthropicError {
+/**
+ * Branded base error class for the Puku SDK. Every error the SDK throws
+ * is an instance of `PukuError`, so `err.toString()` and stack traces
+ * surface as `PukuError: …`.
+ *
+ * We set `PukuError.prototype.name = 'PukuError'` so that
+ * `Error.prototype.toString()` (which reads `.name`) produces
+ * `PukuError: …` instead of the default `Error: …`.
+ */
+ declare class PukuError extends AnthropicError {
+    constructor(message?: string);
+}
+
+ declare class APIError<TStatus extends number | undefined = number | undefined, THeaders extends Headers | undefined = Headers | undefined, TError extends Object | undefined = Object | undefined> extends PukuError {
     /** HTTP status for the response that caused the error */
     readonly status: TStatus;
     /** HTTP headers for the response that caused the error */
@@ -329,7 +352,7 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
     protected options: FinalRequestOptions;
     protected response: Response;
     protected body: unknown;
-    constructor(client: BaseAnthropic, response: Response, body: unknown, options: FinalRequestOptions);
+    constructor(client: BasePuku, response: Response, body: unknown, options: FinalRequestOptions);
     abstract nextPageRequestOptions(): PageRequestOptions | null;
     abstract getPaginatedItems(): Item[];
     hasNextPage(): boolean;
@@ -348,7 +371,7 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
  *    }
  */
  declare class PagePromise<PageClass extends AbstractPage<Item>, Item = ReturnType<PageClass['getPaginatedItems']>[number]> extends APIPromise<PageClass> implements AsyncIterable<Item> {
-    constructor(client: BaseAnthropic, request: Promise<APIResponseProps>, Page: new (...args: ConstructorParameters<typeof AbstractPage>) => PageClass);
+    constructor(client: BasePuku, request: Promise<APIResponseProps>, Page: new (...args: ConstructorParameters<typeof AbstractPage>) => PageClass);
     /**
      * Allow auto-paginating iteration on an unawaited list call, eg:
      *
@@ -380,7 +403,7 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
     has_more: boolean;
     first_id: string | null;
     last_id: string | null;
-    constructor(client: BaseAnthropic, response: Response, body: PageResponse<Item>, options: FinalRequestOptions);
+    constructor(client: BasePuku, response: Response, body: PageResponse<Item>, options: FinalRequestOptions);
     getPaginatedItems(): Item[];
     hasNextPage(): boolean;
     nextPageRequestOptions(): PageRequestOptions | null;
@@ -404,7 +427,7 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
     data: Array<Item>;
     has_more: boolean;
     next_page: string | null;
-    constructor(client: BaseAnthropic, response: Response, body: TokenPageResponse<Item>, options: FinalRequestOptions);
+    constructor(client: BasePuku, response: Response, body: TokenPageResponse<Item>, options: FinalRequestOptions);
     getPaginatedItems(): Item[];
     hasNextPage(): boolean;
     nextPageRequestOptions(): PageRequestOptions | null;
@@ -428,15 +451,15 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
     data: Array<Item>;
     has_more: boolean;
     next_page: string | null;
-    constructor(client: BaseAnthropic, response: Response, body: PageCursorResponse<Item>, options: FinalRequestOptions);
+    constructor(client: BasePuku, response: Response, body: PageCursorResponse<Item>, options: FinalRequestOptions);
     getPaginatedItems(): Item[];
     hasNextPage(): boolean;
     nextPageRequestOptions(): PageRequestOptions | null;
 }
 
  declare abstract class APIResource {
-    protected _client: BaseAnthropic;
-    constructor(client: BaseAnthropic);
+    protected _client: BasePuku;
+    constructor(client: BasePuku);
 }
 
  type ServerSentEvent = {
@@ -449,13 +472,13 @@ import { FromSchema, JSONSchema } from 'json-schema-to-ts';
     #private;
     private iterator;
     controller: AbortController;
-    constructor(iterator: () => AsyncIterator<Item>, controller: AbortController, client?: BaseAnthropic);
-    static fromSSEResponse<Item>(response: Response, controller: AbortController, client?: BaseAnthropic): Stream<Item>;
+    constructor(iterator: () => AsyncIterator<Item>, controller: AbortController, client?: BasePuku);
+    static fromSSEResponse<Item>(response: Response, controller: AbortController, client?: BasePuku): Stream<Item>;
     /**
      * Generates a Stream from a newline-separated ReadableStream
      * where each item is a JSON value.
      */
-    static fromReadableStream<Item>(readableStream: ReadableStream, controller: AbortController, client?: BaseAnthropic): Stream<Item>;
+    static fromReadableStream<Item>(readableStream: ReadableStream, controller: AbortController, client?: BasePuku): Stream<Item>;
     [Symbol.asyncIterator](): AsyncIterator<Item>;
     /**
      * Splits the stream into two streams which can be
@@ -983,7 +1006,7 @@ declare const brand_privateNullableHeaders: symbol & {
     startTime: number;
 };
 
- declare function defaultParseResponse<T>(client: BaseAnthropic, props: APIResponseProps): Promise<WithRequestID<T>>;
+ declare function defaultParseResponse<T>(client: BasePuku, props: APIResponseProps): Promise<WithRequestID<T>>;
 
  type WithRequestID<T> = T extends Array<any> | Response | AbstractPage<any> ? T : T extends Record<string, any> ? T & {
     _request_id?: string | null;
@@ -1253,15 +1276,15 @@ interface BunFile extends Blob {
  * Returns a multipart/form-data request if any part of the given request body contains a File / Blob value.
  * Otherwise returns the request as is.
  */
- declare const maybeMultipartFormRequestOptions: (opts: RequestOptions, fetch: BaseAnthropic | Fetch) => Promise<RequestOptions>;
+ declare const maybeMultipartFormRequestOptions: (opts: RequestOptions, fetch: BasePuku | Fetch) => Promise<RequestOptions>;
 
 type MultipartFormRequestOptions = Omit<RequestOptions, 'body'> & {
     body: unknown;
 };
 
- declare const multipartFormRequestOptions: (opts: MultipartFormRequestOptions, fetch: BaseAnthropic | Fetch, stripFilenames?: boolean) => Promise<RequestOptions>;
+ declare const multipartFormRequestOptions: (opts: MultipartFormRequestOptions, fetch: BasePuku | Fetch, stripFilenames?: boolean) => Promise<RequestOptions>;
 
- declare const createForm: <T = Record<string, unknown>>(body: T | undefined, fetch: BaseAnthropic | Fetch, stripFilenames?: boolean) => Promise<FormData>;
+ declare const createForm: <T = Record<string, unknown>>(body: T | undefined, fetch: BasePuku | Fetch, stripFilenames?: boolean) => Promise<FormData>;
 
 type LogFn = (message: string, ...rest: unknown[]) => void;
 
@@ -1274,9 +1297,9 @@ type LogFn = (message: string, ...rest: unknown[]) => void;
 
  type LogLevel = 'off' | 'error' | 'warn' | 'info' | 'debug';
 
- declare const parseLogLevel: (maybeLevel: string | undefined, sourceName: string, client: BaseAnthropic) => LogLevel | undefined;
+ declare const parseLogLevel: (maybeLevel: string | undefined, sourceName: string, client: BasePuku) => LogLevel | undefined;
 
- declare function loggerFor(client: BaseAnthropic): Logger;
+ declare function loggerFor(client: BasePuku): Logger;
 
  declare const formatRequestDetails: (details: {
     options?: RequestOptions | undefined;
@@ -8787,16 +8810,16 @@ type StainlessHelperObject = {
  declare function readHead(file: string, n: number): Promise<Buffer>;
  declare const VERSION = "0.81.0";
 
-export { default, VERSION, betaTool, betaJSONSchemaOutputFormat, betaZodTool, betaZodOutputFormat, InputSchema, betaMemoryTool };
+export { default, VERSION, PukuError, betaTool, betaJSONSchemaOutputFormat, betaZodTool, betaZodOutputFormat, InputSchema };
 
-export { MemoryToolHandlers, mcpTool, mcpTools, mcpMessage, mcpMessages, mcpContent, mcpResourceToContent, mcpResourceToFile };
+export { betaMemoryTool, MemoryToolHandlers, mcpTool, mcpTools, mcpMessage, mcpMessages, mcpContent, mcpResourceToContent };
 
-export { UnsupportedMCPValueError, MCPToolLike, MCPCallToolResultLike, MCPToolResultContentLike, MCPTextContentLike, MCPImageContentLike, MCPAudioContentLike, MCPEmbeddedResourceLike };
+export { mcpResourceToFile, UnsupportedMCPValueError, MCPToolLike, MCPCallToolResultLike, MCPToolResultContentLike, MCPTextContentLike, MCPImageContentLike, MCPAudioContentLike };
 
-export { MCPResourceLinkLike, MCPTextResourceContentsLike, MCPBlobResourceContentsLike, MCPResourceContentsLike, MCPClientLike, MCPPromptMessageLike, MCPPromptContentLike, MCPReadResourceResultLike };
+export { MCPEmbeddedResourceLike, MCPResourceLinkLike, MCPTextResourceContentsLike, MCPBlobResourceContentsLike, MCPResourceContentsLike, MCPClientLike, MCPPromptMessageLike, MCPPromptContentLike };
 
-export { ToolError, Promisable, BetaToolRunContext, BetaClientRunnableToolType, betaAgentToolset20260401, betaBashTool, betaReadTool, betaWriteTool };
+export { MCPReadResourceResultLike, ToolError, Promisable, BetaToolRunContext, BetaClientRunnableToolType, betaAgentToolset20260401, betaBashTool, betaReadTool };
 
-export { betaEditTool, betaGlobTool, betaGrepTool, resolvePath, BashSession, BashTimeoutError, setupSkills, resolveSkillVersion };
+export { betaWriteTool, betaEditTool, betaGlobTool, betaGrepTool, resolvePath, BashSession, BashTimeoutError, setupSkills };
 
-export { extractSkillArchive, AgentToolContext };
+export { resolveSkillVersion, extractSkillArchive, AgentToolContext };