@blazingagents/sdk 0.30.0 → 0.32.0

package/README.md

@@ -86,6 +86,9 @@ npm run check
 npm run test:consumer
 ```
 
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the changelog convention and how
+to release.
+
 ## License
 
 [MIT](LICENSE)

package/dist/chat-transport.js

@@ -61,9 +61,7 @@ export class BlazingAgentsChatTransport {
                         ...body,
                         message,
                         messageId,
-                        ...(this.#sessionId === undefined
-                            ? { sessionId: undefined }
-                            : { sessionId: this.#sessionId }),
+                        sessionId: this.#sessionId,
                         trigger,
                     },
                 };

package/dist/client.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { chat, completion, continueChat, objectGeneration, } from "./generation.js";
-import { createAgentsResource } from "./resources/agents.js";
+import { createAgentsResource, createUserAgentsResource, } from "./resources/agents.js";
 import { createArtifactsResource } from "./resources/artifacts.js";
 import { createChatConnectionsResource } from "./resources/chat-connections.js";
 import { createChatDeliveriesResource } from "./resources/chat-deliveries.js";
@@ -29,7 +29,7 @@ const scopedUserIdSchema = z
 function createUserClient(config) {
     const usage = createUsageResource(config);
     return {
-        agents: createAgentsResource(config),
+        agents: createUserAgentsResource(config),
         sessions: createSessionsResource(config),
         prompts: createPromptsResource(config),
         tasks: createTasksResource(config),

package/dist/contracts/entities/chat-connections.d.ts

@@ -286,3 +286,54 @@ export declare const chatDeliveriesResponseSchema: z.ZodObject<{
     nextCursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type ChatDeliveriesResponse = z.infer<typeof chatDeliveriesResponseSchema>;
+export declare const chatDeliveryListSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            card: "card";
+            reply: "reply";
+        }>;
+        status: z.ZodEnum<{
+            ambiguous: "ambiguous";
+            confirmed: "confirmed";
+            failed: "failed";
+            pending: "pending";
+        }>;
+        attempt: z.ZodNumber;
+        credentialVersion: z.ZodNumber;
+        representation: z.ZodString;
+        diagnostic: z.ZodNullable<z.ZodString>;
+        receipts: z.ZodOptional<z.ZodUnknown>;
+        sessionId: z.ZodString;
+        messageId: z.ZodNullable<z.ZodString>;
+        approvalId: z.ZodNullable<z.ZodString>;
+        threadId: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ChatDeliveryList = z.infer<typeof chatDeliveryListSchema>;
+export declare const repairChatDeliveryBodySchema: z.ZodObject<{
+    expectedAttempt: z.ZodNumber;
+    previousSenderStopped: z.ZodLiteral<true>;
+    acceptDuplicateRisk: z.ZodLiteral<true>;
+}, z.core.$strict>;
+export type RepairChatDeliveryBody = z.input<typeof repairChatDeliveryBodySchema>;
+export declare const chatDeliveryResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    threadId: z.ZodString;
+    connectionId: z.ZodString;
+    kind: z.ZodEnum<{
+        card: "card";
+        reply: "reply";
+    }>;
+    status: z.ZodEnum<{
+        ambiguous: "ambiguous";
+        confirmed: "confirmed";
+        failed: "failed";
+    }>;
+    attempt: z.ZodNumber;
+}, z.core.$strip>;
+export type ChatDeliveryResult = z.infer<typeof chatDeliveryResultSchema>;

package/dist/contracts/entities/chat-connections.js

@@ -173,3 +173,27 @@ export const chatDeliveriesResponseSchema = z
     nextCursor: z.string().nullable(),
 })
     .strip();
+export const chatDeliveryListSchema = z
+    .object({
+    data: z.array(chatDeliverySchema),
+    nextCursor: z.string().nullable(),
+})
+    .strip();
+export const repairChatDeliveryBodySchema = z
+    .object({
+    expectedAttempt: z.number().int().min(0).max(99),
+    previousSenderStopped: z.literal(true),
+    acceptDuplicateRisk: z.literal(true),
+})
+    .strict();
+export const chatDeliveryResultSchema = z
+    .object({
+    id: chatDeliveryIdSchema,
+    sessionId: z.string(),
+    threadId: z.string(),
+    connectionId: chatConnectionIdSchema,
+    kind: z.enum(["reply", "card"]),
+    status: z.enum(["confirmed", "failed", "ambiguous"]),
+    attempt: z.number().int().nonnegative(),
+})
+    .strip();

package/dist/contracts/entities/chat.d.ts

@@ -317,6 +317,8 @@ export type ChatFunctionDefinition = z.infer<typeof chatFunctionDefinitionSchema
 export type ChatFunctionDefinitions = z.infer<typeof chatFunctionDefinitionsSchema>;
 export type ChatFunctionCallEvent = z.infer<typeof chatFunctionCallEventSchema>;
 export type ChatFunctionOutcome = z.infer<typeof chatFunctionOutcomeSchema>;
+export type ChatRequestBody = z.input<typeof chatRequestBodySchema>;
+export type GenerationRequestBody = z.input<typeof generationRequestBodySchema>;
 export type ClaimChatFunctionBody = z.infer<typeof claimChatFunctionBodySchema>;
 export type ResolveChatFunctionBody = z.infer<typeof resolveChatFunctionBodySchema>;
 export {};

package/dist/contracts/index.d.ts

@@ -9,7 +9,7 @@ export { artifactDownloadUrlResponseSchema, artifactListItemSchema, artifactsLis
 export { attributionCreateInputSchema, metadataSchema, } from "./entities/attribution.ts";
 export type { ChatFunctionCallEvent, ChatFunctionDefinition, ChatFunctionDefinitions, ChatFunctionOutcome, ClaimChatFunctionBody, PromptVariables, ResolveChatFunctionBody, UsageSummary, } from "./entities/chat.ts";
 export { blazingAgentsChatMessageMetadataSchema, chatFunctionCallEventSchema, chatFunctionDefinitionSchema, chatFunctionDefinitionsSchema, chatFunctionOutcomeSchema, chatModeSchema, chatRequestBodySchema, chatTriggerSchema, claimChatFunctionBodySchema, claimChatFunctionResponseSchema, generationRequestBodySchema, jsonSchemaShapeSchema, MAX_CHAT_FUNCTION_DEFINITIONS_BYTES, MAX_CHAT_FUNCTION_PAYLOAD_BYTES, MAX_CHAT_FUNCTIONS, promptVariablesSchema, resolveChatFunctionBodySchema, resolveChatFunctionResponseSchema, usageSummarySchema, } from "./entities/chat.ts";
-export { chatConfigurationSchema, chatConnectionSchema, chatConnectionsResponseSchema, chatCredentialsSchema, chatDeliveriesResponseSchema, chatDeliveryListStatusSchema, chatDeliverySchema, chatDeliveryStatusSchema, chatHealthCheckSchema, chatHealthSchema, chatIdentitySchema, createChatConnectionBodySchema, rotateChatConnectionBodySchema, tenantChatDeliverySchema, updateChatConnectionBodySchema, } from "./entities/chat-connections.ts";
+export { chatConfigurationSchema, chatConnectionSchema, chatConnectionsResponseSchema, chatCredentialsSchema, chatDeliveriesResponseSchema, chatDeliveryListSchema, chatDeliveryListStatusSchema, chatDeliveryResultSchema, chatDeliverySchema, chatDeliveryStatusSchema, chatHealthCheckSchema, chatHealthSchema, chatIdentitySchema, createChatConnectionBodySchema, repairChatDeliveryBodySchema, rotateChatConnectionBodySchema, tenantChatDeliverySchema, updateChatConnectionBodySchema, } from "./entities/chat-connections.ts";
 export { approveMcpOauthAuthorizationBodySchema, createMcpConnectionBodySchema, mcpAttachmentResponseSchema, mcpAttachmentsResponseSchema, mcpConnectionAuthTypeSchema, mcpConnectionOauthConnectResponseSchema, mcpConnectionReconnectResultSchema, mcpConnectionResponseSchema, mcpConnectionStatusSchema, mcpConnectionsResponseSchema, mcpConnectionTestErrorCodeSchema, mcpConnectionTestResponseSchema, mcpOauthAuthorizationLaunchResponseSchema, reconnectMcpConnectionBodySchema, updateMcpAttachmentBodySchema, updateMcpConnectionBodySchema, } from "./entities/mcp-connections.ts";
 export { createMemoryBodySchema, memoriesListResponseSchema, memoryResponseSchema, memorySchema, updateMemoryBodySchema, } from "./entities/memories.ts";
 export { createMerchantConnectionBodySchema, merchantBindingResponseSchema, merchantBindingsResponseSchema, merchantConnectionResponseSchema, merchantConnectionSchema, merchantConnectionStatusSchema, merchantCustomerBindingSchema, merchantEnvironmentSchema, merchantGuardSchema, merchantProviderSchema, merchantUsageEventNextAction, merchantUsageEventNextActionSchema, merchantUsageEventSchema, merchantUsageEventStatusSchema, merchantUsageEventsResponseSchema, merchantUsageSummaryQuerySchema, merchantUsageSummaryResponseSchema, merchantUsageSummarySchema, merchantWorkflowIssueSchema, updateMerchantConnectionBodySchema, upsertMerchantBindingBodySchema, } from "./entities/merchant.ts";

package/dist/contracts/index.js

@@ -7,7 +7,7 @@ export { agentConfigSchema, agentResponseSchema, agentStatusSchema, agentsListQu
 export { artifactDownloadUrlResponseSchema, artifactListItemSchema, artifactsListResponseSchema, } from "./entities/artifacts.js";
 export { attributionCreateInputSchema, metadataSchema, } from "./entities/attribution.js";
 export { blazingAgentsChatMessageMetadataSchema, chatFunctionCallEventSchema, chatFunctionDefinitionSchema, chatFunctionDefinitionsSchema, chatFunctionOutcomeSchema, chatModeSchema, chatRequestBodySchema, chatTriggerSchema, claimChatFunctionBodySchema, claimChatFunctionResponseSchema, generationRequestBodySchema, jsonSchemaShapeSchema, MAX_CHAT_FUNCTION_DEFINITIONS_BYTES, MAX_CHAT_FUNCTION_PAYLOAD_BYTES, MAX_CHAT_FUNCTIONS, promptVariablesSchema, resolveChatFunctionBodySchema, resolveChatFunctionResponseSchema, usageSummarySchema, } from "./entities/chat.js";
-export { chatConfigurationSchema, chatConnectionSchema, chatConnectionsResponseSchema, chatCredentialsSchema, chatDeliveriesResponseSchema, chatDeliveryListStatusSchema, chatDeliverySchema, chatDeliveryStatusSchema, chatHealthCheckSchema, chatHealthSchema, chatIdentitySchema, createChatConnectionBodySchema, rotateChatConnectionBodySchema, tenantChatDeliverySchema, updateChatConnectionBodySchema, } from "./entities/chat-connections.js";
+export { chatConfigurationSchema, chatConnectionSchema, chatConnectionsResponseSchema, chatCredentialsSchema, chatDeliveriesResponseSchema, chatDeliveryListSchema, chatDeliveryListStatusSchema, chatDeliveryResultSchema, chatDeliverySchema, chatDeliveryStatusSchema, chatHealthCheckSchema, chatHealthSchema, chatIdentitySchema, createChatConnectionBodySchema, repairChatDeliveryBodySchema, rotateChatConnectionBodySchema, tenantChatDeliverySchema, updateChatConnectionBodySchema, } from "./entities/chat-connections.js";
 export { approveMcpOauthAuthorizationBodySchema, createMcpConnectionBodySchema, mcpAttachmentResponseSchema, mcpAttachmentsResponseSchema, mcpConnectionAuthTypeSchema, mcpConnectionOauthConnectResponseSchema, mcpConnectionReconnectResultSchema, mcpConnectionResponseSchema, mcpConnectionStatusSchema, mcpConnectionsResponseSchema, mcpConnectionTestErrorCodeSchema, mcpConnectionTestResponseSchema, mcpOauthAuthorizationLaunchResponseSchema, reconnectMcpConnectionBodySchema, updateMcpAttachmentBodySchema, updateMcpConnectionBodySchema, } from "./entities/mcp-connections.js";
 export { createMemoryBodySchema, memoriesListResponseSchema, memoryResponseSchema, memorySchema, updateMemoryBodySchema, } from "./entities/memories.js";
 export { createMerchantConnectionBodySchema, merchantBindingResponseSchema, merchantBindingsResponseSchema, merchantConnectionResponseSchema, merchantConnectionSchema, merchantConnectionStatusSchema, merchantCustomerBindingSchema, merchantEnvironmentSchema, merchantGuardSchema, merchantProviderSchema, merchantUsageEventNextAction, merchantUsageEventNextActionSchema, merchantUsageEventSchema, merchantUsageEventStatusSchema, merchantUsageEventsResponseSchema, merchantUsageSummaryQuerySchema, merchantUsageSummaryResponseSchema, merchantUsageSummarySchema, merchantWorkflowIssueSchema, updateMerchantConnectionBodySchema, upsertMerchantBindingBodySchema, } from "./entities/merchant.js";

package/dist/direct-chat-transport.js

@@ -59,38 +59,31 @@ export class BlazingAgentsDirectChatTransport extends ChatStreamTransport {
             abortSignal: input.abortSignal,
         };
         let result;
-        if (this.#sessionId === undefined) {
-            const create = {
+        if (this.#sessionId !== undefined) {
+            result = await client.chat({
+                ...common,
+                message: lastUserMessage(input.messages),
+                sessionId: this.#sessionId,
+                trigger: input.trigger,
+            });
+        }
+        else if (this.#options.promptId === undefined) {
+            result = await client.chat({
                 ...common,
                 trigger: "submit-message",
                 userId: this.#options.userId,
                 metadata: this.#options.metadata,
-            };
-            if (this.#options.promptId === undefined) {
-                const message = input.messages.findLast((item) => item.role === "user");
-                if (!message) {
-                    throw new Error("Chat submission requires a user message.");
-                }
-                result = await client.chat({ ...create, message });
-            }
-            else {
-                result = await client.chat({
-                    ...create,
-                    promptId: this.#options.promptId,
-                    variables: this.#options.variables,
-                });
-            }
+                message: lastUserMessage(input.messages),
+            });
         }
         else {
-            const message = input.messages.findLast((item) => item.role === "user");
-            if (!message) {
-                throw new Error("Chat submission requires a user message.");
-            }
             result = await client.chat({
                 ...common,
-                message,
-                sessionId: this.#sessionId,
-                trigger: input.trigger,
+                trigger: "submit-message",
+                userId: this.#options.userId,
+                metadata: this.#options.metadata,
+                promptId: this.#options.promptId,
+                variables: this.#options.variables,
             });
         }
         return this.#processChatResult(result);
@@ -107,7 +100,10 @@ export class BlazingAgentsDirectChatTransport extends ChatStreamTransport {
                 this.#sessionId = sessionId;
                 await this.#options.onSessionId?.(sessionId);
             }
-            await this.#reportTurnId(result);
+            const turnId = await result.turnId.catch(() => undefined);
+            if (turnId !== undefined) {
+                await this.#options.onTurnId?.(turnId);
+            }
         }
         catch (error) {
             await stream.cancel(error).catch(() => undefined);
@@ -143,21 +139,13 @@ export class BlazingAgentsDirectChatTransport extends ChatStreamTransport {
             decisions,
             functions: this.#options.functions ?? {},
         });
-        const stream = continuation.toStream();
-        try {
-            await this.#reportTurnId(continuation);
-        }
-        catch (error) {
-            await stream.cancel(error).catch(() => undefined);
-            throw error;
-        }
-        return this.processResponseStream(stream);
+        return this.#processChatResult(continuation);
     }
-    /** Reports the Turn ID when the response names one. */
-    async #reportTurnId(result) {
-        const turnId = await result.turnId.catch(() => undefined);
-        if (turnId !== undefined) {
-            await this.#options.onTurnId?.(turnId);
-        }
+}
+function lastUserMessage(messages) {
+    const message = messages.findLast((item) => item.role === "user");
+    if (!message) {
+        throw new Error("Chat submission requires a user message.");
     }
+    return message;
 }

package/dist/errors.js

@@ -18,7 +18,6 @@ export class BlazingAgentsError extends Error {
     responseBody;
     responseBodyTruncated;
     status;
-    // Stryker disable BooleanLiteral: cross-realm identity depends on marker presence, not its value.
     /**
      * Marker property used by `isInstance` for cross-realm `instanceof`
      * checks — the symbol is checked via `in`, not direct property access,
@@ -26,7 +25,6 @@ export class BlazingAgentsError extends Error {
      * biome-ignore lint/correctness/noUnusedPrivateClassMembers: marker pattern
      */
     [BLAZING_AGENTS_ERROR_SYMBOL] = true;
-    // Stryker restore BooleanLiteral
     /**
      * Creates an SDK error with its code, diagnostics, and optional cause.
      * @param options - Configuration for this operation.

package/dist/functions.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { chatFunctionCallEventSchema, chatFunctionDefinitionsSchema, chatFunctionOutcomeSchema, claimChatFunctionResponseSchema, resolveChatFunctionResponseSchema, } from "./contracts/entities/chat.js";
 import { BlazingAgentsError } from "./errors.js";
-import { requestJson } from "./http.js";
+import { apiPath, requestJson } from "./http.js";
 /**
  * Declares a caller-local function whose handler input is inferred from its Zod schema.
  * @param definition - Description, input schema, and local handler.
@@ -313,7 +313,7 @@ export function dispatchChatFunctions(config, target, body) {
      * Claims a function call, runs its handler, and posts the result within its retry budget.
      */
     const runCall = async (call) => {
-        const path = `/v1/agents/${target.agentId}/sessions/${target.sessionId}/function-calls/${call.id}`;
+        const path = apiPath `/v1/agents/${target.agentId}/sessions/${target.sessionId}/function-calls/${call.id}`;
         const claimRequestId = crypto.randomUUID();
         const deadline = Date.parse(call.deadlineAt);
         const claim = await postWithRetry(config, `${path}/claim`, { claimRequestId }, claimChatFunctionResponseSchema, deadline, handlers.signal);

package/dist/generation.d.ts

@@ -24,9 +24,8 @@ export declare function withFilteredBody(response: Response, filter: (body: Read
  * 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 declare function buildTerminalStreamResult(response: Response, resourceName: string, filter?: (body: ReadableStream<Uint8Array>) => ReadableStream<Uint8Array>): TerminalStreamResult;
+export declare function buildTerminalStreamResult(response: Response, resourceName: string): TerminalStreamResult;
 /**
  * Starts stateless text generation with independent final, incremental, and response outputs.
  * @param config - Authentication, base URL, and transport configuration.

package/dist/generation.js

@@ -2,7 +2,7 @@ import { createTextStreamResponse, parsePartialJson } from "ai";
 import { sessionIdSchema, turnIdSchema } from "./contracts/ids.js";
 import { BlazingAgentsError } from "./errors.js";
 import { dispatchChatFunctions, toChatFunctionDefinitions, } from "./functions.js";
-import { requestStream } from "./http.js";
+import { apiPath, 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.
@@ -21,8 +21,8 @@ export async function chat(config, input) {
      * (`POST /v1/agents/:agentId/sessions/:sessionId`).
      */
     const path = input.sessionId === undefined
-        ? `/v1/agents/${input.agentId}/sessions`
-        : `/v1/agents/${input.agentId}/sessions/${input.sessionId}`;
+        ? apiPath `/v1/agents/${input.agentId}/sessions`
+        : apiPath `/v1/agents/${input.agentId}/sessions/${input.sessionId}`;
     const response = await requestStream(config, path, {
         json: body,
         method: "POST",
@@ -42,7 +42,7 @@ export async function chat(config, input) {
  * @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`, {
+    const response = await requestStream(config, apiPath `/v1/agents/${input.agentId}/sessions/${input.sessionId}/tool-approvals/continue`, {
         json: {
             decisions: input.decisions,
             ...(input.functions === undefined
@@ -79,37 +79,23 @@ export function withFilteredBody(response, filter) {
  * 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.
-    if (input.trigger !== undefined) {
-        base.trigger = input.trigger;
-    }
-    // Stryker disable next-line ConditionalExpression: JSON serialization omits an undefined message id.
-    if (input.messageId !== undefined) {
-        base.messageId = input.messageId;
-    }
+    const body = {
+        trigger: input.trigger,
+        messageId: input.messageId,
+    };
     if ("message" in input) {
-        base.messages = [input.message];
+        body.messages = [input.message];
     }
     else if ("messages" in input) {
-        base.messages = input.messages;
+        body.messages = input.messages;
     }
     else {
-        base.promptId = input.promptId;
-        // Stryker disable next-line ConditionalExpression: JSON serialization omits undefined variables.
-        if (input.variables !== undefined) {
-            base.variables = input.variables;
-        }
-    }
-    // Stryker disable next-line ConditionalExpression: JSON serialization omits an undefined user id.
-    if (input.userId !== undefined) {
-        base.userId = input.userId;
-    }
-    // Stryker disable next-line ConditionalExpression: JSON serialization omits undefined metadata.
-    if (input.metadata !== undefined) {
-        base.metadata = input.metadata;
+        body.promptId = input.promptId;
+        body.variables = input.variables;
     }
-    return base;
+    body.userId = input.userId;
+    body.metadata = input.metadata;
+    return body;
 }
 /**
  * Extracts the server-minted `ss_` id from the `Location` header on the
@@ -190,9 +176,8 @@ function buildChatResult(config, response, resumeSessionId, dispatch) {
  * 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) {
+export function buildTerminalStreamResult(response, resourceName) {
     const requestId = response.headers.get("x-request-id") ?? undefined;
     const location = response.headers.get("location");
     const turnId = response.headers.get("x-ba-turn-id");
@@ -203,17 +188,11 @@ export function buildTerminalStreamResult(response, resourceName, filter) {
      */
     const claimBody = () => {
         if (bodyClaimed) {
-            const message = `The ${resourceName} response body has already been claimed.`;
-            const cause = new Error(message);
-            throw new BlazingAgentsError({
-                code: "stream_error",
-                message,
-                requestId,
-            }, { cause });
+            throw alreadyClaimedError(resourceName, requestId);
         }
         bodyClaimed = true;
         const body = responseBodyStream(response, requestId, resourceName);
-        return normalizeStreamErrors(filter ? filter(body) : body, requestId, `The ${resourceName} response stream failed.`);
+        return normalizeStreamErrors(body, requestId, `The ${resourceName} response stream failed.`);
     };
     return {
         requestId,
@@ -239,6 +218,25 @@ export function buildTerminalStreamResult(response, resourceName, filter) {
         },
     };
 }
+function alreadyClaimedError(resourceName, requestId) {
+    const message = `The ${resourceName} response body has already been claimed.`;
+    return new BlazingAgentsError({ code: "stream_error", message, requestId }, { cause: new Error(message) });
+}
+/**
+ * Parses the complete generated text, reporting malformed JSON as a stream error.
+ */
+function parseFinalJson(text, requestId) {
+    try {
+        return JSON.parse(text);
+    }
+    catch (cause) {
+        throw new BlazingAgentsError({
+            code: "stream_error",
+            message: "The agent produced invalid JSON.",
+            requestId,
+        }, { cause });
+    }
+}
 /**
  * Preserves a matching stream error or wraps a failure with request correlation.
  */
@@ -354,19 +352,10 @@ function buildStatelessGenerationBody(input, output) {
     }
     else {
         body.promptId = input.promptId;
-        // Stryker disable next-line ConditionalExpression: JSON serialization omits undefined variables.
-        if (input.variables !== undefined) {
-            body.variables = input.variables;
-        }
-    }
-    // Stryker disable next-line ConditionalExpression: JSON serialization omits an undefined user id.
-    if (input.userId !== undefined) {
-        body.userId = input.userId;
-    }
-    // Stryker disable next-line ConditionalExpression: JSON serialization omits undefined metadata.
-    if (input.metadata !== undefined) {
-        body.metadata = input.metadata;
+        body.variables = input.variables;
     }
+    body.userId = input.userId;
+    body.metadata = input.metadata;
     return body;
 }
 /**
@@ -377,7 +366,7 @@ function buildStatelessGenerationBody(input, output) {
  */
 export async function completion(config, input) {
     const body = buildStatelessGenerationBody(input, { type: "text" });
-    const path = `/v1/agents/${input.agentId}/generation`;
+    const path = apiPath `/v1/agents/${input.agentId}/generation`;
     const response = await requestStream(config, path, {
         json: body,
         method: "POST",
@@ -419,7 +408,7 @@ export async function objectGeneration(config, input) {
         type: "object",
         schema: input.schema,
     });
-    const path = `/v1/agents/${input.agentId}/generation`;
+    const path = apiPath `/v1/agents/${input.agentId}/generation`;
     const response = await requestStream(config, path, {
         json: body,
         method: "POST",
@@ -449,16 +438,7 @@ function buildObjectResult(response) {
          * Rejects malformed final JSON when the text stream ends.
          */
         flush() {
-            try {
-                JSON.parse(accumulatedText);
-            }
-            catch (cause) {
-                throw new BlazingAgentsError({
-                    code: "stream_error",
-                    message: "The agent produced invalid JSON.",
-                    requestId,
-                }, { cause });
-            }
+            parseFinalJson(accumulatedText, requestId);
         },
     }));
     const objectPromise = (async () => {
@@ -466,16 +446,7 @@ function buildObjectResult(response) {
         for await (const delta of finalStream) {
             text += delta;
         }
-        try {
-            return JSON.parse(text);
-        }
-        catch (cause) {
-            throw new BlazingAgentsError({
-                code: "stream_error",
-                message: "The agent produced invalid JSON.",
-                requestId,
-            }, { cause });
-        }
+        return parseFinalJson(text, requestId);
     })();
     objectPromise.catch(() => {
         /* no-op — prevents unhandled rejection if the caller never awaits */
@@ -509,12 +480,7 @@ function buildStatelessGenerationStreams(response, resourceName) {
         /** Claims the response relay once. */
         toResponse: () => {
             if (responseBodyClaimed) {
-                const message = `The ${resourceName} response body has already been claimed.`;
-                throw new BlazingAgentsError({
-                    code: "stream_error",
-                    message,
-                    requestId,
-                }, { cause: new Error(message) });
+                throw alreadyClaimedError(resourceName, requestId);
             }
             responseBodyClaimed = true;
             const headers = replacementResponseHeaders(requestId, location, null);

package/dist/http.d.ts

@@ -1,5 +1,10 @@
 import { BlazingAgentsError } from "./errors.ts";
 import type { HttpConfig, RequestOptions } from "./types.ts";
+/**
+ * Builds an endpoint path, encoding each interpolated value so it stays inside
+ * one path segment or query value.
+ */
+export declare function apiPath(template: TemplateStringsArray, ...values: string[]): string;
 /**
  * Performs a request and returns the parsed JSON body for success (status
  * 2xx). API errors preserve the tolerant wire envelope; malformed responses
@@ -37,13 +42,3 @@ export declare function isRequestAborted(cause: unknown, signal?: AbortSignal):
  * @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,13 @@ 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.";
+/**
+ * Builds an endpoint path, encoding each interpolated value so it stays inside
+ * one path segment or query value.
+ */
+export function apiPath(template, ...values) {
+    return String.raw({ raw: template }, ...values.map(encodeURIComponent));
+}
 /**
  * Appends query values while omitting null and undefined entries.
  */
@@ -305,7 +312,7 @@ function decodeChunks(chunks, byteLength, truncated) {
  * @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) {
+function parseErrorEnvelope(bodyText, status, headers) {
     let parsed;
     if (bodyText.length === 0) {
         parsed = null;

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export { AGENT_TOOL_FILE_ACCESS_TAGS, AGENT_TOOL_GROUPS, AGENT_TOOL_TAGS, AGENT_
 export type { Agent, AgentConfig, AgentResponse, AgentsListQuery, AgentsResponse, CreateAgentBody, UpdateAgentBody, } from "./contracts/entities/agents.ts";
 export { agentConfigSchema } from "./contracts/entities/agents.ts";
 export type { ArtifactDownloadUrlResponse, ArtifactListItem, ArtifactsListResponse, } from "./contracts/entities/artifacts.ts";
-export type { ChatConfiguration, ChatConnection, ChatConnectionsResponse, ChatCredentials, ChatDeliveriesResponse, ChatDelivery, ChatDeliveryListStatus, ChatDeliveryStatus, ChatHealth, ChatIdentity, CreateChatConnectionBody, RotateChatConnectionBody, TenantChatDelivery, UpdateChatConnectionBody, } from "./contracts/entities/chat-connections.ts";
+export type { ChatConfiguration, ChatConnection, ChatConnectionsResponse, ChatCredentials, ChatDeliveriesResponse, ChatDelivery, ChatDeliveryList, ChatDeliveryListStatus, ChatDeliveryResult, ChatDeliveryStatus, ChatHealth, ChatIdentity, CreateChatConnectionBody, RepairChatDeliveryBody, RotateChatConnectionBody, TenantChatDelivery, UpdateChatConnectionBody, } from "./contracts/entities/chat-connections.ts";
 export type { CreateMcpConnectionBody, McpAttachmentResponse, McpAttachmentsResponse, McpConnectionAuthType, McpConnectionOauthConnectResponse, McpConnectionReconnectResult, McpConnectionResponse, McpConnectionStatus, McpConnectionTestResponse, ReconnectMcpConnectionBody, UpdateMcpAttachmentBody, UpdateMcpConnectionBody, } from "./contracts/entities/mcp-connections.ts";
 export type { CreateMerchantConnectionBody, MerchantBindingResponse, MerchantBindingsResponse, MerchantConnection, MerchantConnectionResponse, MerchantCustomerBinding, MerchantGuard, MerchantProviderKind, MerchantUsageEvent, MerchantUsageEventResponse, MerchantUsageEventStatus, MerchantUsageEventsResponse, MerchantUsageSummary, MerchantUsageSummaryResponse, UpdateMerchantConnectionBody, UpsertMerchantBindingBody, } from "./contracts/entities/merchant.ts";
 export type { CreatePromptBody, PromptResponse, PromptsListQuery, PromptsResponse, UpdatePromptBody, } from "./contracts/entities/prompts.ts";

package/dist/resources/agents.d.ts

@@ -1,7 +1,13 @@
-import type { AgentsResource, HttpConfig } from "../types.ts";
+import type { AgentsResource, HttpConfig, UserAgentsResource } from "../types.ts";
 /**
- * Builds the Agents operations using the shared HTTP configuration.
+ * Builds the Agents operations, including the spending limits that need tenant authority.
  * @param config - Shared authentication and transport configuration.
  * @returns The configured resource client.
  */
 export declare function createAgentsResource(config: HttpConfig): AgentsResource;
+/**
+ * Builds the Agents operations a user-scoped client may call.
+ * @param config - Shared authentication and transport configuration.
+ * @returns The configured resource client.
+ */
+export declare function createUserAgentsResource(config: HttpConfig): UserAgentsResource;