@blazingagents/sdk 0.20.0 → 0.22.0

package/dist/generation.js

@@ -3,6 +3,12 @@ import { sessionIdSchema } from "./contracts/ids.js";
 import { BlazingAgentsError } from "./errors.js";
 import { dispatchChatFunctions, toChatFunctionDefinitions, } from "./functions.js";
 import { requestStream } from "./http.js";
+/**
+ * Creates or resumes a Session and returns its SSE stream and Session ID.
+ * @param config - Authentication, base URL, and transport configuration.
+ * @param input - Agent, message or stored Prompt, and optional existing Session.
+ * @returns The Session ID promise and single-owner SSE accessors.
+ */
 export async function chat(config, input) {
     const body = buildChatBody(input);
     if (input.functions && Object.keys(input.functions).length > 0) {
@@ -29,6 +35,12 @@ export async function chat(config, input) {
         abortSignal: input.abortSignal,
     });
 }
+/**
+ * Submits a complete Tool approval round and streams its continuation.
+ * @param config - Authentication, base URL, and transport configuration.
+ * @param input - Agent, Session, and decisions for the complete approval round.
+ * @returns The Session ID promise and continuation SSE accessors.
+ */
 export async function continueChat(config, input) {
     const response = await requestStream(config, `/v1/agents/${input.agentId}/sessions/${input.sessionId}/tool-approvals/continue`, {
         json: {
@@ -50,6 +62,8 @@ export async function continueChat(config, input) {
 /**
  * Keeps status and headers while filtering the SSE body. Missing or locked
  * bodies pass through so the stream result reports them as `stream_error`.
+ * @param response - Upstream HTTP response.
+ * @param filter - Transforms upstream SSE bytes before exposing them to the caller.
  */
 export function withFilteredBody(response, filter) {
     if (!response.body || response.body.locked) {
@@ -61,6 +75,9 @@ export function withFilteredBody(response, filter) {
         statusText: response.statusText,
     });
 }
+/**
+ * Builds a chat request body from messages or a stored Prompt.
+ */
 function buildChatBody(input) {
     const base = {};
     // Stryker disable next-line ConditionalExpression: JSON serialization omits an undefined trigger.
@@ -122,6 +139,9 @@ function sessionIdFromLocation(response, requestId) {
     }
     return parsed.data;
 }
+/**
+ * Combines the Session ID promise with a single-owner SSE result.
+ */
 function buildChatResult(config, response, resumeSessionId, dispatch) {
     /**
      * `sessionId` resolves from the `Location` header on create, or to the
@@ -154,10 +174,20 @@ function buildChatResult(config, response, resumeSessionId, dispatch) {
         ...buildTerminalStreamResult(streamResponse, "chat"),
     };
 }
+/**
+ * Creates single-owner SSE response and byte-stream accessors.
+ * @param response - Upstream HTTP response.
+ * @param resourceName - Resource label used in stream errors.
+ * @param filter - Transforms upstream SSE bytes before exposing them to the caller.
+ */
 export function buildTerminalStreamResult(response, resourceName, filter) {
     const requestId = response.headers.get("x-request-id") ?? undefined;
     const location = response.headers.get("location");
     let bodyClaimed = false;
+    /**
+     * Claims the response body once and normalizes stream failures.
+     * @throws BlazingAgentsError - If the response body has already been claimed.
+     */
     const claimBody = () => {
         if (bodyClaimed) {
             const message = `The ${resourceName} response body has already been claimed.`;
@@ -175,6 +205,7 @@ export function buildTerminalStreamResult(response, resourceName, filter) {
     return {
         requestId,
         toStream: claimBody,
+        /** Claims the response relay once. */
         toResponse: () => {
             const headers = replacementResponseHeaders(requestId, location);
             headers.set("content-type", "text/event-stream");
@@ -195,6 +226,9 @@ export function buildTerminalStreamResult(response, resourceName, filter) {
         },
     };
 }
+/**
+ * Preserves a matching stream error or wraps a failure with request correlation.
+ */
 function toStreamError(cause, requestId, fallbackMessage) {
     if (BlazingAgentsError.isInstance(cause) &&
         cause.code === "stream_error" &&
@@ -217,6 +251,9 @@ function toStreamError(cause, requestId, fallbackMessage) {
         requestId,
     }, { cause });
 }
+/**
+ * Wraps reads and cancellation failures as correlated SDK stream errors.
+ */
 function normalizeStreamErrors(stream, requestId, fallbackMessage) {
     let reader;
     try {
@@ -226,6 +263,9 @@ function normalizeStreamErrors(stream, requestId, fallbackMessage) {
         throw toStreamError(cause, requestId, fallbackMessage);
     }
     return new ReadableStream({
+        /**
+         * Reads one upstream chunk and normalizes stream failures.
+         */
         async pull(controller) {
             try {
                 const { done, value } = await reader.read();
@@ -239,6 +279,9 @@ function normalizeStreamErrors(stream, requestId, fallbackMessage) {
                 controller.error(toStreamError(cause, requestId, fallbackMessage));
             }
         },
+        /**
+         * Cancels the upstream reader with the consumer reason.
+         */
         async cancel(reason) {
             try {
                 await reader.cancel(reason);
@@ -249,6 +292,9 @@ function normalizeStreamErrors(stream, requestId, fallbackMessage) {
         },
     });
 }
+/**
+ * Returns the response body or a stream that fails when the body is missing.
+ */
 function responseBodyStream(response, requestId, resourceName) {
     if (response.body) {
         return response.body;
@@ -261,11 +307,17 @@ function responseBodyStream(response, requestId, resourceName) {
         requestId,
     }, { cause });
     return new ReadableStream({
+        /**
+         * Initializes the stream controller.
+         */
         start(controller) {
             controller.error(error);
         },
     });
 }
+/**
+ * Copies request correlation and Session location into relay response headers.
+ */
 function replacementResponseHeaders(requestId, location) {
     const headers = new Headers();
     if (requestId !== undefined) {
@@ -276,6 +328,9 @@ function replacementResponseHeaders(requestId, location) {
     }
     return headers;
 }
+/**
+ * Builds a stateless prompt request with the selected output format.
+ */
 function buildStatelessGenerationBody(input, output) {
     const body = { output };
     if ("prompt" in input) {
@@ -298,6 +353,12 @@ function buildStatelessGenerationBody(input, output) {
     }
     return body;
 }
+/**
+ * Starts stateless text generation with independent final, incremental, and response outputs.
+ * @param config - Authentication, base URL, and transport configuration.
+ * @param input - Agent and literal prompt or stored Prompt reference.
+ * @returns Independent text stream, final text promise, and response relay.
+ */
 export async function completion(config, input) {
     const body = buildStatelessGenerationBody(input, { type: "text" });
     const path = `/v1/agents/${input.agentId}/generation`;
@@ -309,6 +370,9 @@ export async function completion(config, input) {
     });
     return buildCompletionResult(response);
 }
+/**
+ * Splits text output into a final promise, incremental stream, and response relay.
+ */
 function buildCompletionResult(response) {
     const { finalStream, outputStream, requestId, toResponse } = buildStatelessGenerationStreams(response, "completion");
     const textPromise = (async () => {
@@ -328,6 +392,12 @@ function buildCompletionResult(response) {
         toResponse,
     };
 }
+/**
+ * Starts stateless JSON generation with partial objects and a final parsed value.
+ * @param config - Authentication, base URL, and transport configuration.
+ * @param input - Agent, prompt source, and JSON output schema.
+ * @returns Partial JSON objects, a final JSON promise, and a text response relay.
+ */
 export async function objectGeneration(config, input) {
     const body = buildStatelessGenerationBody(input, {
         type: "object",
@@ -342,10 +412,16 @@ export async function objectGeneration(config, input) {
     });
     return buildObjectResult(response);
 }
+/**
+ * Parses partial and final JSON from independent text-stream branches.
+ */
 function buildObjectResult(response) {
     const { finalStream, outputStream, requestId, toResponse } = buildStatelessGenerationStreams(response, "object");
     let accumulatedText = "";
     const partialObjectStream = outputStream.pipeThrough(new TransformStream({
+        /**
+         * Accumulates generated text and emits each available partial JSON value.
+         */
         async transform(chunk, controller) {
             accumulatedText += chunk;
             const { value } = await parsePartialJson(accumulatedText);
@@ -353,6 +429,9 @@ function buildObjectResult(response) {
                 controller.enqueue(value);
             }
         },
+        /**
+         * Rejects malformed final JSON when the text stream ends.
+         */
         flush() {
             try {
                 JSON.parse(accumulatedText);
@@ -392,6 +471,9 @@ function buildObjectResult(response) {
         toResponse,
     };
 }
+/**
+ * Splits decoded text into final, public, and response-relay branches.
+ */
 function buildStatelessGenerationStreams(response, resourceName) {
     const requestId = response.headers.get("x-request-id") ?? undefined;
     const location = response.headers.get("location");
@@ -408,6 +490,7 @@ function buildStatelessGenerationStreams(response, resourceName) {
         finalStream,
         outputStream,
         requestId,
+        /** Claims the response relay once. */
         toResponse: () => {
             if (responseBodyClaimed) {
                 const message = `The ${resourceName} response body has already been claimed.`;

package/dist/http.d.ts

@@ -4,20 +4,46 @@ import type { HttpConfig, RequestOptions } from "./types.ts";
  * Performs a request and returns the parsed JSON body for success (status
  * 2xx). API errors preserve the tolerant wire envelope; malformed responses
  * become `invalid_response`.
+ * @param config - Authentication, base URL, and transport configuration.
+ * @param path - Endpoint path relative to the base URL.
+ * @param options - Configuration for this operation.
+ * @param schema - Schema used to validate the value.
  */
 export declare function requestJson<T>(config: HttpConfig, path: string, options?: RequestOptions, schema?: {
+    /**
+     * Validates the decoded response value.
+     * @param value - Value to inspect.
+     */
     parse(value: unknown): T;
 }): Promise<T>;
 /**
  * Performs a request and returns the raw `Response` for streaming paths.
  * Non-2xx bodies are decoded before a caller can observe a streaming body.
+ * @param config - Authentication, base URL, and transport configuration.
+ * @param path - Endpoint path relative to the base URL.
+ * @param options - Configuration for this operation.
  */
 export declare function requestStream(config: HttpConfig, path: string, options?: RequestOptions): Promise<Response>;
+/**
+ * Checks whether the signal aborted or the cause names an AbortError.
+ * @param cause - Original failure to retain.
+ * @param signal - Signal that cancels the operation.
+ * @returns Whether the request signal or cause indicates cancellation.
+ */
 export declare function isRequestAborted(cause: unknown, signal?: AbortSignal): boolean;
+/**
+ * Wraps an abort cause as a request_aborted SDK error.
+ * @param cause - Original failure to retain.
+ * @returns A request_aborted error retaining the cause.
+ */
 export declare function requestAbortedError(cause: unknown): BlazingAgentsError;
 /**
  * Decodes a response body with the tolerant consumer schema. Unknown future
  * codes and fields remain valid; malformed responses never infer a domain
  * code from HTTP status.
+ * @param bodyText - Response body as text.
+ * @param status - HTTP response status.
+ * @param headers - Response headers to preserve or inspect.
+ * @returns The server error, or invalid_response when the envelope is malformed.
  */
 export declare function parseErrorEnvelope(bodyText: string, status: number, headers?: Headers): BlazingAgentsError;

package/dist/http.js

@@ -4,6 +4,9 @@ const DIAGNOSTIC_BODY_LIMIT_BYTES = 64 * 1024;
 const INVALID_RESPONSE_MESSAGE = "The server returned an invalid response.";
 const NETWORK_ERROR_MESSAGE = "Network request failed (fetch threw before any HTTP exchange).";
 const REQUEST_ABORTED_MESSAGE = "The request was aborted before any HTTP response.";
+/**
+ * Appends query values while omitting null and undefined entries.
+ */
 function buildUrl(baseUrl, path, query) {
     const url = `${baseUrl}${path}`;
     if (!query) {
@@ -23,6 +26,10 @@ function buildUrl(baseUrl, path, query) {
  * Performs a request and returns the parsed JSON body for success (status
  * 2xx). API errors preserve the tolerant wire envelope; malformed responses
  * become `invalid_response`.
+ * @param config - Authentication, base URL, and transport configuration.
+ * @param path - Endpoint path relative to the base URL.
+ * @param options - Configuration for this operation.
+ * @param schema - Schema used to validate the value.
  */
 export async function requestJson(config, path, options = {}, schema) {
     const response = await rawRequest(config, path, options);
@@ -56,6 +63,9 @@ export async function requestJson(config, path, options = {}, schema) {
 /**
  * Performs a request and returns the raw `Response` for streaming paths.
  * Non-2xx bodies are decoded before a caller can observe a streaming body.
+ * @param config - Authentication, base URL, and transport configuration.
+ * @param path - Endpoint path relative to the base URL.
+ * @param options - Configuration for this operation.
  */
 export async function requestStream(config, path, options = {}) {
     const response = await rawRequest(config, path, options);
@@ -64,6 +74,9 @@ export async function requestStream(config, path, options = {}) {
     }
     throw await errorFromResponse(response, options.signal);
 }
+/**
+ * Sends an authenticated request and reports response metadata to the observer.
+ */
 async function rawRequest(config, path, options) {
     const fetchImpl = config.fetch ?? globalThis.fetch;
     const url = buildUrl(config.baseUrl, path, options.query);
@@ -122,6 +135,9 @@ async function rawRequest(config, path, options) {
         }, { cause });
     }
 }
+/**
+ * Reads bounded diagnostics and decodes a failed HTTP response.
+ */
 async function errorFromResponse(response, signal) {
     const read = await readResponseBody(response, true);
     if (read.readFailed && isRequestAborted(read.cause, signal)) {
@@ -133,6 +149,12 @@ async function errorFromResponse(response, signal) {
     }
     return parseErrorEnvelope(read.diagnosticBody, response.status, headers);
 }
+/**
+ * Checks whether the signal aborted or the cause names an AbortError.
+ * @param cause - Original failure to retain.
+ * @param signal - Signal that cancels the operation.
+ * @returns Whether the request signal or cause indicates cancellation.
+ */
 export function isRequestAborted(cause, signal) {
     return (signal?.aborted === true ||
         (cause !== null &&
@@ -140,6 +162,11 @@ export function isRequestAborted(cause, signal) {
             "name" in cause &&
             cause.name === "AbortError"));
 }
+/**
+ * Wraps an abort cause as a request_aborted SDK error.
+ * @param cause - Original failure to retain.
+ * @returns A request_aborted error retaining the cause.
+ */
 export function requestAbortedError(cause) {
     return new BlazingAgentsError({
         code: "request_aborted",
@@ -215,6 +242,9 @@ async function readResponseBody(response, stopAtDiagnosticLimit) {
         byteLength += chunk.byteLength;
     }
 }
+/**
+ * Cancels an oversized error body and retains its bounded diagnostic prefix.
+ */
 async function cancelTruncatedBody(reader, chunks, byteLength) {
     const diagnosticBody = decodeDiagnosticChunks(chunks, byteLength, true).body;
     try {
@@ -236,6 +266,9 @@ async function cancelTruncatedBody(reader, chunks, byteLength) {
         };
     }
 }
+/**
+ * Decodes diagnostics without exceeding the UTF-8 byte limit.
+ */
 function decodeDiagnosticChunks(chunks, byteLength, sourceTruncated) {
     const body = decodeChunks(chunks, byteLength, sourceTruncated);
     const encoded = new TextEncoder().encode(body);
@@ -247,6 +280,9 @@ function decodeDiagnosticChunks(chunks, byteLength, sourceTruncated) {
         truncated: true,
     };
 }
+/**
+ * Joins retained bytes and omits an incomplete trailing character when truncated.
+ */
 function decodeChunks(chunks, byteLength, truncated) {
     const bytes = new Uint8Array(byteLength);
     let offset = 0;
@@ -264,6 +300,10 @@ function decodeChunks(chunks, byteLength, truncated) {
  * Decodes a response body with the tolerant consumer schema. Unknown future
  * codes and fields remain valid; malformed responses never infer a domain
  * code from HTTP status.
+ * @param bodyText - Response body as text.
+ * @param status - HTTP response status.
+ * @param headers - Response headers to preserve or inspect.
+ * @returns The server error, or invalid_response when the envelope is malformed.
  */
 export function parseErrorEnvelope(bodyText, status, headers = new Headers()) {
     let parsed;
@@ -292,6 +332,9 @@ export function parseErrorEnvelope(bodyText, status, headers = new Headers()) {
     }
     return invalidResponseError(headers, status, bodyText, false);
 }
+/**
+ * Builds an invalid_response error with bounded diagnostics and request correlation.
+ */
 function invalidResponseError(headers, status, responseBody, responseBodyTruncated, cause) {
     return new BlazingAgentsError({
         code: "invalid_response",

package/dist/index.d.ts

@@ -16,13 +16,15 @@ export type { CreateMerchantConnectionBody, MerchantBindingResponse, MerchantBin
 export type { CreatePromptBody, PromptResponse, PromptsListQuery, PromptsResponse, UpdatePromptBody, } from "./contracts/entities/prompts.ts";
 export type { CreateProviderBody, ProviderListItem, ProviderModel, ProviderModelsResponse, ProviderResponse, ProvidersResponse, ProviderType, ThinkingLevelsResponse, UpdateProviderBody, } from "./contracts/entities/providers.ts";
 export type { ChatSteerConsumedEvent, SessionActivity, SessionInput, SessionInputResponse, SessionInputState, SessionInputsQuery, SessionInputsResponse, StopSessionBody, StopSessionResponse, SubmitSessionInputBody, } from "./contracts/entities/session-inputs.ts";
-export type { ContinueToolApprovalsBody, SessionResponse, ToolApprovalDecision, ToolApprovalState, ToolApprovalsResponse, } from "./contracts/entities/sessions.ts";
+export type { ContinueToolApprovalsBody, SessionForkedFrom, SessionResponse, ToolApprovalDecision, ToolApprovalState, ToolApprovalsResponse, } from "./contracts/entities/sessions.ts";
 export { sessionResponseSchema } from "./contracts/entities/sessions.ts";
 export type { CreateSkillBody, Skill, SkillArchiveType, SkillCopyResult, SkillCopyResults, SkillDetail, SkillFile, SkillsListResponse, } from "./contracts/entities/skills.ts";
+export type { SpendingLimit, SpendingLimitResponse, SpendingLimitStopDetails, SpendingLimitStopEvent, UpdateSpendingLimitBody, } from "./contracts/entities/spending-limits.ts";
+export { nextSpendingLimitReset } from "./contracts/entities/spending-limits.ts";
 export type { SessionUsageQuery, SessionUsageResponse, UsageBucket, UsageOverviewQuery, UsageOverviewResponse, UsageTotals, } from "./contracts/entities/usage.ts";
-export type { CreateWorkspaceBody, UpdateWorkspaceBody, Workspace, WorkspaceNetworkPolicy, WorkspacesListResponse, } from "./contracts/entities/workspaces.ts";
+export type { CreateWorkspaceBody, UpdateWorkspaceBody, Workspace, WorkspaceNetworkPolicy, WorkspacesListResponse, WorkspaceTier, } from "./contracts/entities/workspaces.ts";
 export { BlazingAgentsDirectChatTransport, type BlazingAgentsDirectChatTransportOptions, } from "./direct-chat-transport.ts";
 export { BlazingAgentsError } from "./errors.ts";
 export { type ChatFunction, type ChatFunctionContext, type ChatFunctions, defineFunction, } from "./functions.ts";
 export { createChatRelay, createCompletionRelay, type RelayContext, type SessionOwnershipStore, } from "./relay.ts";
-export type { AgentClient, AgentSkillsResource, AgentsListOptions, AgentsResource, ArtifactsResource, AttributionInput, BlazingAgentsErrorCode, BlazingAgentsOptions, BlazingAgentsRequestOptions, BlazingAgentsUIMessage, BlazingAgentsUIMessageChunk, ChatConnectionsResource, ChatDeliveriesListOptions, ChatDeliveriesResource, ChatInput, ChatMessageInput, ChatMessagesInput, ChatPromptInput, ChatResult, ChatTrigger, CompletionInput, CompletionPromptIdInput, CompletionPromptInput, CompletionResult, ContinueChatInput, KnownBlazingAgentsErrorCode, LatestSessionsListOptions, McpConnectionsResource, MemoriesListOptions, MemoriesResource, MerchantBindingsListOptions, MerchantBindingsResource, MerchantConnectionResource, MerchantUsageEventsListOptions, MerchantUsageEventsResource, ObjectInput, ObjectPromptIdInput, ObjectPromptInput, ObjectResult, PromptsResource, ProvidersResource, ResourceRequestOptions, ResponseObservation, SessionsResource, SkillsListOptions, TasksResource, TenantResource, TerminalStreamResult, UsageResource, UserClient, WorkspacesListOptions, WorkspacesResource, } from "./types.ts";
+export type { AgentClient, AgentSkillsResource, AgentsListOptions, AgentsResource, ArtifactsResource, AttributionInput, BlazingAgentsErrorCode, BlazingAgentsOptions, BlazingAgentsRequestOptions, BlazingAgentsUIMessage, BlazingAgentsUIMessageChunk, BlazingAgentsUIMessageData, ChatConnectionsResource, ChatDeliveriesListOptions, ChatDeliveriesResource, ChatInput, ChatMessageInput, ChatMessagesInput, ChatPromptInput, ChatResult, ChatTrigger, CompletionInput, CompletionPromptIdInput, CompletionPromptInput, CompletionResult, ContinueChatInput, KnownBlazingAgentsErrorCode, LatestSessionsListOptions, McpConnectionsResource, MemoriesListOptions, MemoriesResource, MerchantBindingsListOptions, MerchantBindingsResource, MerchantConnectionResource, MerchantUsageEventsListOptions, MerchantUsageEventsResource, ObjectInput, ObjectPromptIdInput, ObjectPromptInput, ObjectResult, PromptsResource, ProvidersResource, ResourceRequestOptions, ResponseObservation, SessionsResource, SkillsListOptions, TasksResource, TenantResource, TerminalStreamResult, UsageResource, UserClient, WorkspacesListOptions, WorkspacesResource, } from "./types.ts";

package/dist/index.js

@@ -8,6 +8,7 @@ export { BlazingAgentsChatTransport, } from "./chat-transport.js";
 export { BlazingAgents } from "./client.js";
 export { agentConfigSchema } from "./contracts/entities/agents.js";
 export { sessionResponseSchema } from "./contracts/entities/sessions.js";
+export { nextSpendingLimitReset } from "./contracts/entities/spending-limits.js";
 export { BlazingAgentsDirectChatTransport, } from "./direct-chat-transport.js";
 export { BlazingAgentsError } from "./errors.js";
 export { defineFunction, } from "./functions.js";

package/dist/relay.d.ts

@@ -8,19 +8,42 @@ export interface RelayContext {
     userId: string;
 }
 export interface SessionOwnershipStore {
+    /**
+     * Looks up the end user who owns the Session.
+     * @param sessionId - Session to look up or record.
+     * @returns The owner ID, or undefined when no owner is recorded.
+     */
     ownerOf(sessionId: string): Promise<string | undefined>;
+    /**
+     * Records ownership of a newly created Session.
+     * @param sessionId - Session to look up or record.
+     * @param userId - End-user ID for request scope.
+     * @returns Resolves after ownership is stored.
+     */
     recordOwner(sessionId: string, userId: string): Promise<void>;
 }
 interface RelayOptions<Method extends keyof BlazingAgents> {
     client: Pick<BlazingAgents, Method>;
+    /**
+     * Resolves authenticated Agent and end-user context, or null for an unauthenticated request.
+     * @param request - Incoming HTTP request.
+     * @returns Authenticated context, or null when authentication fails.
+     */
     resolveContext(request: Request): Promise<RelayContext | null>;
 }
 /**
  * Relays useChat submissions. An assistant message carrying approval
  * responses submits the complete round and streams the continuation.
+ * @param options - Configuration for this operation.
+ * @returns An HTTP handler that checks Session ownership before resuming.
  */
 export declare function createChatRelay(options: RelayOptions<"chat" | "continueChat"> & {
     sessions: SessionOwnershipStore;
 }): (request: Request) => Promise<Response>;
+/**
+ * Creates an authenticated HTTP handler that validates prompts and relays text generation.
+ * @param options - Configuration for this operation.
+ * @returns An HTTP handler that validates prompts and relays text generation.
+ */
 export declare function createCompletionRelay(options: RelayOptions<"completion">): (request: Request) => Promise<Response>;
 export {};

package/dist/relay.js

@@ -15,6 +15,8 @@ const completionBodySchema = z.object({ prompt: z.string().trim().min(1) });
 /**
  * Relays useChat submissions. An assistant message carrying approval
  * responses submits the complete round and streams the continuation.
+ * @param options - Configuration for this operation.
+ * @returns An HTTP handler that checks Session ownership before resuming.
  */
 export function createChatRelay(options) {
     return async (request) => {
@@ -86,6 +88,9 @@ export function createChatRelay(options) {
         }
     };
 }
+/**
+ * Validates the Session and forwards the last assistant approval round.
+ */
 async function relayApprovalResponses(client, { functions, message, request, ...input }) {
     if (input.sessionId === undefined) {
         return errorResponse(400, "invalid_request", "Tool approval requires an existing Session.");
@@ -106,6 +111,11 @@ async function relayApprovalResponses(client, { functions, message, request, ...
     });
     return continuation.toResponse();
 }
+/**
+ * Creates an authenticated HTTP handler that validates prompts and relays text generation.
+ * @param options - Configuration for this operation.
+ * @returns An HTTP handler that validates prompts and relays text generation.
+ */
 export function createCompletionRelay(options) {
     return async (request) => {
         try {
@@ -128,6 +138,9 @@ export function createCompletionRelay(options) {
         }
     };
 }
+/**
+ * Maps validation and SDK failures to safe public error responses.
+ */
 function safeErrorResponse(error) {
     if (error instanceof z.ZodError || error instanceof SyntaxError) {
         return errorResponse(400, "invalid_request", "Invalid request body.");
@@ -143,6 +156,9 @@ function safeErrorResponse(error) {
     }
     return errorResponse(500, "internal_error", "Request failed.");
 }
+/**
+ * Builds a JSON error envelope with the selected HTTP status.
+ */
 function errorResponse(status, code, message, headers) {
     const responseHeaders = new Headers(headers);
     responseHeaders.set("content-type", "application/json");

package/dist/resources/agents.d.ts

@@ -1,2 +1,7 @@
 import type { AgentsResource, HttpConfig } from "../types.ts";
+/**
+ * Builds the Agents operations using the shared HTTP configuration.
+ * @param config - Shared authentication and transport configuration.
+ * @returns The configured resource client.
+ */
 export declare function createAgentsResource(config: HttpConfig): AgentsResource;

package/dist/resources/agents.js

@@ -1,13 +1,33 @@
 import { agentResponseSchema, agentsResponseSchema, } from "../contracts/entities/agents.js";
 import { mcpAttachmentResponseSchema, mcpAttachmentsResponseSchema, } from "../contracts/entities/mcp-connections.js";
+import { spendingLimitResponseSchema } from "../contracts/entities/spending-limits.js";
 import { requestJson } from "../http.js";
+/**
+ * Builds the Agents operations using the shared HTTP configuration.
+ * @param config - Shared authentication and transport configuration.
+ * @returns The configured resource client.
+ */
 export function createAgentsResource(config) {
+    /**
+     * Updates agents.
+     */
     const update = async ({ agentId, abortSignal, ...body }) => requestJson(config, `/v1/agents/${agentId}`, {
         json: body,
         signal: abortSignal,
         method: "PUT",
     }, agentResponseSchema);
     return {
+        /** Retrieves the model spending limit using tenant authority. */
+        async getSpendingLimit({ agentId, abortSignal }) {
+            return await requestJson(config, `/v1/agents/${agentId}/spending-limit`, { signal: abortSignal }, spendingLimitResponseSchema);
+        },
+        /** Sets the model spending limit. Null disables it. Requires tenant authority. */
+        async updateSpendingLimit({ agentId, abortSignal, ...body }) {
+            return await requestJson(config, `/v1/agents/${agentId}/spending-limit`, { method: "PUT", json: body, signal: abortSignal }, spendingLimitResponseSchema);
+        },
+        /**
+         * Creates agents.
+         */
         async create({ abortSignal, ...body }) {
             return await requestJson(config, "/v1/agents", {
                 json: body,
@@ -15,6 +35,9 @@ export function createAgentsResource(config) {
                 method: "POST",
             }, agentResponseSchema);
         },
+        /**
+         * Lists one page of agents.
+         */
         async list(options = {}) {
             return await requestJson(config, "/v1/agents", {
                 signal: options.abortSignal,
@@ -26,22 +49,40 @@ export function createAgentsResource(config) {
                 },
             }, agentsResponseSchema);
         },
+        /**
+         * Retrieves agents.
+         */
         async get({ agentId, abortSignal }) {
             return await requestJson(config, `/v1/agents/${agentId}`, { signal: abortSignal }, agentResponseSchema);
         },
+        /**
+         * Disables agents.
+         */
         async disable({ agentId, abortSignal }) {
             return await requestJson(config, `/v1/agents/${agentId}/disable`, { method: "POST", signal: abortSignal }, agentResponseSchema);
         },
+        /**
+         * Enables agents.
+         */
         async enable({ agentId, abortSignal }) {
             return await requestJson(config, `/v1/agents/${agentId}/enable`, { method: "POST", signal: abortSignal }, agentResponseSchema);
         },
+        /**
+         * Lists the Agent MCP attachments.
+         */
         async listMcpAttachments({ agentId, abortSignal }) {
             return await requestJson(config, `/v1/agents/${agentId}/mcp-attachments`, { signal: abortSignal }, mcpAttachmentsResponseSchema);
         },
         update,
+        /**
+         * Updates one Agent MCP attachment.
+         */
         async updateMcpAttachment({ agentId, mcpConnectionId, abortSignal, ...body }) {
             return await requestJson(config, `/v1/agents/${agentId}/mcp-attachments/${mcpConnectionId}`, { json: body, method: "PATCH", signal: abortSignal }, mcpAttachmentResponseSchema);
         },
+        /**
+         * Deletes agents.
+         */
         async delete({ agentId, includeArtifacts, abortSignal }) {
             await requestJson(config, `/v1/agents/${agentId}`, {
                 method: "DELETE",
@@ -49,6 +90,9 @@ export function createAgentsResource(config) {
                 signal: abortSignal,
             });
         },
+        /**
+         * Uploads an Agent avatar as multipart form data.
+         */
         async uploadAvatar({ agentId, file, abortSignal }) {
             const form = new FormData();
             form.append("file", file);
@@ -58,6 +102,9 @@ export function createAgentsResource(config) {
                 method: "POST",
             }, agentResponseSchema);
         },
+        /**
+         * Removes the Agent avatar.
+         */
         async removeAvatar({ agentId, abortSignal }) {
             return await requestJson(config, `/v1/agents/${agentId}/avatar`, { method: "DELETE", signal: abortSignal }, agentResponseSchema);
         },

package/dist/resources/artifacts.d.ts

@@ -1,5 +1,7 @@
 import type { ArtifactsResource, HttpConfig } from "../types.ts";
 /**
  * `client.artifacts` — Tenant-level metadata and direct download URLs.
+ * @param config - Shared authentication and transport configuration.
+ * @returns The configured resource client.
  */
 export declare function createArtifactsResource(config: HttpConfig): ArtifactsResource;