@blazingagents/sdk 0.31.0 → 0.33.0

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,8 +11,8 @@ 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 { CreateMcpConnectionBody, McpAttachmentResponse, McpAttachmentsResponse, McpConnectionAuthType, McpConnectionOauthConnectResponse, McpConnectionReconnectResult, McpConnectionResponse, McpConnectionStatus, McpConnectionTestResponse, ReconnectMcpConnectionBody, UpdateMcpAttachmentBody, UpdateMcpConnectionBody, } from "./contracts/entities/mcp-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, 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";
 export type { CreateProviderBody, ProviderListItem, ProviderModel, ProviderModelsResponse, ProviderResponse, ProvidersResponse, ProviderType, ThinkingLevelsResponse, UpdateProviderBody, } from "./contracts/entities/providers.ts";

package/dist/resources/agents.js

@@ -1,7 +1,7 @@
 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";
+import { apiPath, requestJson } from "../http.js";
 /**
  * Builds the Agents operations, including the spending limits that need tenant authority.
  * @param config - Shared authentication and transport configuration.
@@ -12,11 +12,11 @@ export function createAgentsResource(config) {
         ...createUserAgentsResource(config),
         /** Retrieves the model spending limit using tenant authority. */
         async getSpendingLimit({ agentId, abortSignal }) {
-            return await requestJson(config, `/v1/agents/${agentId}/spending-limit`, { signal: abortSignal }, spendingLimitResponseSchema);
+            return await requestJson(config, apiPath `/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);
+            return await requestJson(config, apiPath `/v1/agents/${agentId}/spending-limit`, { method: "PUT", json: body, signal: abortSignal }, spendingLimitResponseSchema);
         },
     };
 }
@@ -29,7 +29,7 @@ export function createUserAgentsResource(config) {
     /**
      * Updates agents.
      */
-    const update = async ({ agentId, abortSignal, ...body }) => requestJson(config, `/v1/agents/${agentId}`, {
+    const update = async ({ agentId, abortSignal, ...body }) => requestJson(config, apiPath `/v1/agents/${agentId}`, {
         json: body,
         signal: abortSignal,
         method: "PUT",
@@ -63,38 +63,38 @@ export function createUserAgentsResource(config) {
          * Retrieves agents.
          */
         async get({ agentId, abortSignal }) {
-            return await requestJson(config, `/v1/agents/${agentId}`, { signal: abortSignal }, agentResponseSchema);
+            return await requestJson(config, apiPath `/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);
+            return await requestJson(config, apiPath `/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);
+            return await requestJson(config, apiPath `/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);
+            return await requestJson(config, apiPath `/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);
+            return await requestJson(config, apiPath `/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}`, {
+            await requestJson(config, apiPath `/v1/agents/${agentId}`, {
                 method: "DELETE",
                 query: { includeArtifacts },
                 signal: abortSignal,
@@ -106,7 +106,7 @@ export function createUserAgentsResource(config) {
         async uploadAvatar({ agentId, file, abortSignal }) {
             const form = new FormData();
             form.append("file", file);
-            return await requestJson(config, `/v1/agents/${agentId}/avatar`, {
+            return await requestJson(config, apiPath `/v1/agents/${agentId}/avatar`, {
                 body: form,
                 signal: abortSignal,
                 method: "POST",
@@ -116,7 +116,7 @@ export function createUserAgentsResource(config) {
          * Removes the Agent avatar.
          */
         async removeAvatar({ agentId, abortSignal }) {
-            return await requestJson(config, `/v1/agents/${agentId}/avatar`, { method: "DELETE", signal: abortSignal }, agentResponseSchema);
+            return await requestJson(config, apiPath `/v1/agents/${agentId}/avatar`, { method: "DELETE", signal: abortSignal }, agentResponseSchema);
         },
     };
 }

package/dist/resources/artifacts.js

@@ -1,5 +1,5 @@
 import { artifactDownloadUrlResponseSchema, artifactListItemSchema, artifactsListResponseSchema, } from "../contracts/entities/artifacts.js";
-import { requestJson } from "../http.js";
+import { apiPath, requestJson } from "../http.js";
 /**
  * `client.artifacts` — Tenant-level metadata and direct download URLs.
  * @param config - Shared authentication and transport configuration.
@@ -11,13 +11,13 @@ export function createArtifactsResource(config) {
          * Creates a temporary Artifact download URL.
          */
         async createDownloadUrl({ artifactId, abortSignal }) {
-            return await requestJson(config, `/v1/artifacts/${artifactId}/download-url`, { method: "POST", signal: abortSignal }, artifactDownloadUrlResponseSchema);
+            return await requestJson(config, apiPath `/v1/artifacts/${artifactId}/download-url`, { method: "POST", signal: abortSignal }, artifactDownloadUrlResponseSchema);
         },
         /**
          * Retrieves artifacts.
          */
         async get({ artifactId, abortSignal }) {
-            return await requestJson(config, `/v1/artifacts/${artifactId}`, { signal: abortSignal }, artifactListItemSchema);
+            return await requestJson(config, apiPath `/v1/artifacts/${artifactId}`, { signal: abortSignal }, artifactListItemSchema);
         },
         /**
          * Lists one page of artifacts.
@@ -36,7 +36,7 @@ export function createArtifactsResource(config) {
          * Deletes artifacts.
          */
         async delete({ artifactId, abortSignal }) {
-            await requestJson(config, `/v1/artifacts/${artifactId}`, {
+            await requestJson(config, apiPath `/v1/artifacts/${artifactId}`, {
                 method: "DELETE",
                 signal: abortSignal,
             });

package/dist/resources/chat-connections.js

@@ -1,5 +1,5 @@
-import { chatConnectionSchema, chatConnectionsResponseSchema, } from "../contracts/entities/chat-connections.js";
-import { requestJson } from "../http.js";
+import { chatConnectionSchema, chatConnectionsResponseSchema, chatDeliveryListSchema, chatDeliveryResultSchema, } from "../contracts/entities/chat-connections.js";
+import { apiPath, requestJson } from "../http.js";
 /**
  * Builds the Chat Connections operations using the shared HTTP configuration.
  * @param config - Shared authentication and transport configuration.
@@ -23,43 +23,55 @@ export function createChatConnectionsResource(config) {
          * Retrieves chat connections.
          */
         async get({ chatConnectionId, abortSignal }) {
-            return await requestJson(config, `/v1/chat-connections/${encodeURIComponent(chatConnectionId)}`, { signal: abortSignal, method: "GET" }, chatConnectionSchema);
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}`, { signal: abortSignal, method: "GET" }, chatConnectionSchema);
         },
         /**
          * Updates chat connections.
          */
         async update({ chatConnectionId, abortSignal, ...body }) {
-            return await requestJson(config, `/v1/chat-connections/${encodeURIComponent(chatConnectionId)}`, { signal: abortSignal, method: "PATCH", json: body }, chatConnectionSchema);
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}`, { signal: abortSignal, method: "PATCH", json: body }, chatConnectionSchema);
         },
         /**
          * Replaces the Chat Connection credentials.
          */
         async rotateCredentials({ chatConnectionId, abortSignal, ...body }) {
-            return await requestJson(config, `/v1/chat-connections/${encodeURIComponent(chatConnectionId)}/credentials`, { signal: abortSignal, method: "POST", json: body }, chatConnectionSchema);
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/credentials`, { signal: abortSignal, method: "POST", json: body }, chatConnectionSchema);
         },
         /**
          * Checks the Chat Connection health.
          */
         async checkHealth({ chatConnectionId, abortSignal }) {
-            return await requestJson(config, `/v1/chat-connections/${encodeURIComponent(chatConnectionId)}/health`, { signal: abortSignal, method: "POST" }, chatConnectionSchema);
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/health`, { signal: abortSignal, method: "POST" }, chatConnectionSchema);
+        },
+        /**
+         * Lists one page of the Chat Connection's deliveries.
+         */
+        async listDeliveries({ chatConnectionId, abortSignal, ...query }) {
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/deliveries`, { signal: abortSignal, query }, chatDeliveryListSchema);
+        },
+        /**
+         * Sends a stuck Chat delivery again.
+         */
+        async repairDelivery({ chatConnectionId, deliveryId, abortSignal, ...body }) {
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/deliveries/${deliveryId}/repair`, { signal: abortSignal, method: "POST", json: body }, chatDeliveryResultSchema);
         },
         /**
          * Enables chat connections.
          */
         async enable({ chatConnectionId, abortSignal }) {
-            return await requestJson(config, `/v1/chat-connections/${encodeURIComponent(chatConnectionId)}/enable`, { signal: abortSignal, method: "POST" }, chatConnectionSchema);
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/enable`, { signal: abortSignal, method: "POST" }, chatConnectionSchema);
         },
         /**
          * Disables chat connections.
          */
         async disable({ chatConnectionId, abortSignal }) {
-            return await requestJson(config, `/v1/chat-connections/${encodeURIComponent(chatConnectionId)}/disable`, { signal: abortSignal, method: "POST" }, chatConnectionSchema);
+            return await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}/disable`, { signal: abortSignal, method: "POST" }, chatConnectionSchema);
         },
         /**
          * Deletes chat connections.
          */
         async delete({ chatConnectionId, abortSignal }) {
-            await requestJson(config, `/v1/chat-connections/${encodeURIComponent(chatConnectionId)}`, { signal: abortSignal, method: "DELETE" });
+            await requestJson(config, apiPath `/v1/chat-connections/${chatConnectionId}`, { signal: abortSignal, method: "DELETE" });
         },
     };
 }

package/dist/resources/mcp-connections.js

@@ -1,5 +1,5 @@
-import { mcpConnectionOauthConnectResponseSchema, mcpConnectionReconnectResultSchema, mcpConnectionResponseSchema, mcpConnectionsResponseSchema, mcpConnectionTestResponseSchema, reconnectMcpConnectionBodySchema, updateMcpConnectionBodySchema, } from "../contracts/entities/mcp-connections.js";
-import { requestJson } from "../http.js";
+import { mcpConnectionReconnectResultSchema, mcpConnectionResponseSchema, mcpConnectionsResponseSchema, mcpConnectionTestResponseSchema, reconnectMcpConnectionBodySchema, updateMcpConnectionBodySchema, } from "../contracts/entities/mcp-connections.js";
+import { apiPath, requestJson } from "../http.js";
 /**
  * Builds the Mcp Connections operations using the shared HTTP configuration.
  * @param config - Shared authentication and transport configuration.
@@ -12,12 +12,6 @@ export function createMcpConnectionsResource(config) {
         method: "POST",
     }, mcpConnectionResponseSchema));
     return {
-        /**
-         * Starts OAuth authorization for mcp connections.
-         */
-        async connect({ mcpConnectionId, abortSignal }) {
-            return await requestJson(config, `/v1/mcp-connections/${mcpConnectionId}/connect`, { method: "POST", signal: abortSignal }, mcpConnectionOauthConnectResponseSchema);
-        },
         create,
         /**
          * Lists one page of mcp connections.
@@ -29,13 +23,13 @@ export function createMcpConnectionsResource(config) {
          * Retrieves mcp connections.
          */
         async get({ mcpConnectionId, abortSignal }) {
-            return await requestJson(config, `/v1/mcp-connections/${mcpConnectionId}`, { signal: abortSignal }, mcpConnectionResponseSchema);
+            return await requestJson(config, apiPath `/v1/mcp-connections/${mcpConnectionId}`, { signal: abortSignal }, mcpConnectionResponseSchema);
         },
         /**
          * Updates mcp connections.
          */
         async update({ mcpConnectionId, abortSignal, ...body }) {
-            return await requestJson(config, `/v1/mcp-connections/${mcpConnectionId}`, {
+            return await requestJson(config, apiPath `/v1/mcp-connections/${mcpConnectionId}`, {
                 json: updateMcpConnectionBodySchema.parse(body),
                 signal: abortSignal,
                 method: "PATCH",
@@ -45,7 +39,7 @@ export function createMcpConnectionsResource(config) {
          * Deletes mcp connections.
          */
         async delete({ mcpConnectionId, abortSignal }) {
-            await requestJson(config, `/v1/mcp-connections/${mcpConnectionId}`, {
+            await requestJson(config, apiPath `/v1/mcp-connections/${mcpConnectionId}`, {
                 method: "DELETE",
                 signal: abortSignal,
             });
@@ -54,13 +48,13 @@ export function createMcpConnectionsResource(config) {
          * Tests mcp connections.
          */
         async test({ mcpConnectionId, abortSignal }) {
-            return await requestJson(config, `/v1/mcp-connections/${mcpConnectionId}/test`, { method: "POST", signal: abortSignal }, mcpConnectionTestResponseSchema);
+            return await requestJson(config, apiPath `/v1/mcp-connections/${mcpConnectionId}/test`, { method: "POST", signal: abortSignal }, mcpConnectionTestResponseSchema);
         },
         /**
          * Reconnects mcp connections.
          */
         async reconnect({ mcpConnectionId, abortSignal, ...body }) {
-            return await requestJson(config, `/v1/mcp-connections/${mcpConnectionId}/reconnect`, {
+            return await requestJson(config, apiPath `/v1/mcp-connections/${mcpConnectionId}/reconnect`, {
                 json: reconnectMcpConnectionBodySchema.parse(body),
                 signal: abortSignal,
                 method: "POST",

package/dist/resources/memories.js

@@ -1,5 +1,5 @@
 import { memoriesListResponseSchema, memoryResponseSchema, } from "../contracts/entities/memories.js";
-import { requestJson } from "../http.js";
+import { apiPath, requestJson } from "../http.js";
 /**
  * `client.memories` — CRUD and query over `/v1/agents/:agentId/memories`.
  * Memories are Agent-nested; `userId` is stamped at creation and immutable,
@@ -13,7 +13,7 @@ export function createMemoriesResource(config) {
          * Lists one page of memories.
          */
         async list({ agentId, abortSignal, ...options }) {
-            return await requestJson(config, `/v1/agents/${agentId}/memories`, {
+            return await requestJson(config, apiPath `/v1/agents/${agentId}/memories`, {
                 signal: abortSignal,
                 query: {
                     ...(options.userId === undefined ? {} : { userId: options.userId }),
@@ -27,25 +27,25 @@ export function createMemoriesResource(config) {
          * Creates memories.
          */
         async create({ agentId, abortSignal, ...body }) {
-            return await requestJson(config, `/v1/agents/${agentId}/memories`, { json: body, signal: abortSignal, method: "POST" }, memoryResponseSchema);
+            return await requestJson(config, apiPath `/v1/agents/${agentId}/memories`, { json: body, signal: abortSignal, method: "POST" }, memoryResponseSchema);
         },
         /**
          * Retrieves memories.
          */
         async get({ agentId, memoryId, abortSignal }) {
-            return await requestJson(config, `/v1/agents/${agentId}/memories/${memoryId}`, { signal: abortSignal }, memoryResponseSchema);
+            return await requestJson(config, apiPath `/v1/agents/${agentId}/memories/${memoryId}`, { signal: abortSignal }, memoryResponseSchema);
         },
         /**
          * Updates memories.
          */
         async update({ agentId, memoryId, abortSignal, ...body }) {
-            return await requestJson(config, `/v1/agents/${agentId}/memories/${memoryId}`, { json: body, signal: abortSignal, method: "PATCH" }, memoryResponseSchema);
+            return await requestJson(config, apiPath `/v1/agents/${agentId}/memories/${memoryId}`, { json: body, signal: abortSignal, method: "PATCH" }, memoryResponseSchema);
         },
         /**
          * Deletes memories.
          */
         async delete({ agentId, memoryId, abortSignal }) {
-            await requestJson(config, `/v1/agents/${agentId}/memories/${memoryId}`, { method: "DELETE", signal: abortSignal });
+            await requestJson(config, apiPath `/v1/agents/${agentId}/memories/${memoryId}`, { method: "DELETE", signal: abortSignal });
         },
     };
 }

package/dist/resources/merchant-bindings.js

@@ -1,5 +1,5 @@
 import { merchantBindingResponseSchema, merchantBindingsResponseSchema, } from "../contracts/entities/merchant.js";
-import { requestJson } from "../http.js";
+import { apiPath, requestJson } from "../http.js";
 /**
  * `client.merchantBindings` — list/put/delete over
  * `/v1/merchant-connection/bindings`. `put` upserts the end user's provider
@@ -20,13 +20,13 @@ export function createMerchantBindingsResource(config) {
          * Validates and saves merchant bindings.
          */
         async put({ userId, abortSignal, ...body }) {
-            return await requestJson(config, `/v1/merchant-connection/bindings/${encodeURIComponent(userId)}`, { json: body, method: "PUT", signal: abortSignal }, merchantBindingResponseSchema);
+            return await requestJson(config, apiPath `/v1/merchant-connection/bindings/${userId}`, { json: body, method: "PUT", signal: abortSignal }, merchantBindingResponseSchema);
         },
         /**
          * Deletes merchant bindings.
          */
         async delete({ userId, abortSignal }) {
-            await requestJson(config, `/v1/merchant-connection/bindings/${encodeURIComponent(userId)}`, { method: "DELETE", signal: abortSignal });
+            await requestJson(config, apiPath `/v1/merchant-connection/bindings/${userId}`, { method: "DELETE", signal: abortSignal });
         },
     };
 }