@blazingagents/sdk 0.9.2 → 0.10.0

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

@@ -27,6 +27,17 @@ export declare const tenantResponseSchema: z.ZodObject<{
         inactive: "inactive";
     }>;
 }, z.core.$strip>;
+/**
+ * Tenant deletion lifecycle — `requestedAt` marks the tenant deleting and
+ * `deletesAt` is the scheduled permanent-deletion time (24 hours after
+ * confirmation, cancellable until then). Deletion is dashboard-only; the
+ * shape rides `GET /v1/tenant` settings so the dashboard can render it.
+ */
+export declare const tenantDeletionSchema: z.ZodObject<{
+    deletesAt: z.ZodISODateTime;
+    requestedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type TenantDeletion = z.infer<typeof tenantDeletionSchema>;
 /**
  * Quota — `GET/PATCH /v1/tenant` carries the tenant's self-set quota.
  * `null` means unlimited (no quota row).
@@ -51,8 +62,14 @@ export declare const tenantSettingsResponseSchema: z.ZodObject<{
         monthlyRequestLimit: z.ZodNullable<z.ZodNumber>;
         resetDay: z.ZodNumber;
     }, z.core.$strip>>;
+    deletion: z.ZodNullable<z.ZodObject<{
+        deletesAt: z.ZodISODateTime;
+        requestedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    monetizationEnabled: z.ZodBoolean;
 }, z.core.$strip>;
 export declare const updateTenantSettingsBodySchema: z.ZodObject<{
+    monetizationEnabled: z.ZodOptional<z.ZodBoolean>;
     name: z.ZodOptional<z.ZodString>;
     quota: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         monthlyTokenLimit: z.ZodNullable<z.ZodNumber>;

package/dist/contracts/entities/tenants.js

@@ -20,6 +20,18 @@ export const subscriptionStatusSchema = z.enum(["active", "inactive"]);
 export const tenantResponseSchema = tenantSchema
     .extend({ subscriptionStatus: subscriptionStatusSchema })
     .strip();
+/**
+ * Tenant deletion lifecycle — `requestedAt` marks the tenant deleting and
+ * `deletesAt` is the scheduled permanent-deletion time (24 hours after
+ * confirmation, cancellable until then). Deletion is dashboard-only; the
+ * shape rides `GET /v1/tenant` settings so the dashboard can render it.
+ */
+export const tenantDeletionSchema = z
+    .object({
+    deletesAt: z.iso.datetime({ offset: true }),
+    requestedAt: z.iso.datetime({ offset: true }),
+})
+    .strict();
 /**
  * Quota — `GET/PATCH /v1/tenant` carries the tenant's self-set quota.
  * `null` means unlimited (no quota row).
@@ -42,9 +54,15 @@ export const tenantSettingsSchema = z
     quota: quotaSchema.strip().nullable(),
 })
     .strip();
-export const tenantSettingsResponseSchema = tenantSettingsSchema;
+export const tenantSettingsResponseSchema = tenantSettingsSchema
+    .extend({
+    deletion: tenantDeletionSchema.nullable(),
+    monetizationEnabled: z.boolean(),
+})
+    .strip();
 export const updateTenantSettingsBodySchema = z
     .object({
+    monetizationEnabled: z.boolean().optional(),
     name: z.string().trim().min(1).max(MAX_TENANT_NAME_LENGTH).optional(),
     quota: quotaSchema.nullable().optional(),
 })

package/dist/contracts/ids.d.ts

@@ -35,6 +35,8 @@ export declare const sessionIdSchema: z.ZodString;
 export declare const apiKeyIdSchema: z.ZodString;
 export declare const providerIdSchema: z.ZodString;
 export declare const mcpConnectionIdSchema: z.ZodString;
+export declare const merchantConnectionIdSchema: z.ZodString;
+export declare const merchantUsageEventIdSchema: z.ZodString;
 export declare const workspaceIdSchema: z.ZodString;
 export declare const artifactIdSchema: z.ZodString;
 export declare const taskIdSchema: z.ZodString;

package/dist/contracts/ids.js

@@ -57,6 +57,12 @@ export const sessionIdSchema = z.string().regex(/^ss_[0-9A-Za-z]{16}$/);
 export const apiKeyIdSchema = z.string().regex(/^ak_[0-9A-Za-z]{16}$/);
 export const providerIdSchema = z.string().regex(/^prv_[0-9A-Za-z]{16}$/);
 export const mcpConnectionIdSchema = z.string().regex(/^mcp_[0-9A-Za-z]{16}$/);
+export const merchantConnectionIdSchema = z
+    .string()
+    .regex(/^mch_[0-9A-Za-z]{16}$/);
+export const merchantUsageEventIdSchema = z
+    .string()
+    .regex(/^mev_[0-9A-Za-z]{16}$/);
 export const workspaceIdSchema = z.string().regex(/^ws_[0-9A-Za-z]{16}$/);
 export const artifactIdSchema = z.string().regex(/^at_[0-9A-Za-z]{16}$/);
 export const taskIdSchema = z.string().regex(/^tk_[0-9A-Za-z]{16}$/);

package/dist/contracts/index.d.ts

@@ -10,13 +10,14 @@ export { blazingAgentsChatMessageMetadataSchema, chatModeSchema, chatRequestBody
 export { chatConfigurationSchema, chatConnectionSchema, chatConnectionsResponseSchema, chatCredentialsSchema, chatHealthCheckSchema, chatHealthSchema, chatIdentitySchema, createChatConnectionBodySchema, rotateChatConnectionBodySchema, 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";
 export { createPromptBodySchema, promptResponseSchema, promptSchema, promptsResponseSchema, updatePromptBodySchema, } from "./entities/prompts.ts";
 export { createProviderBodySchema, providerListItemSchema, providerModelsResponseSchema, providerResponseSchema, providersResponseSchema, providerTypeSchema, thinkingLevelsResponseSchema, updateProviderBodySchema, } from "./entities/providers.ts";
 export type { ToolApprovalDecisionResponse, ToolApprovalsResponse, } from "./entities/sessions.ts";
 export { decideToolApprovalBodySchema, latestSessionListItemSchema, latestSessionsListResponseSchema, sessionListItemSchema, sessionMessageSchema, sessionMessagesResponseSchema, sessionsListResponseSchema, toolApprovalContinuationStateSchema, toolApprovalDecisionResponseSchema, toolApprovalStateSchema, toolApprovalsResponseSchema, } from "./entities/sessions.ts";
 export { copySkillBodySchema, createSkillBodySchema, skillCopyResultsSchema, skillDetailSchema, skillsListResponseSchema, } from "./entities/skills.ts";
 export { createTaskBodySchema, createTaskResponseSchema, createTaskRunBodySchema, createTaskRunResponseSchema, taskListItemSchema, taskResponseSchema, taskRunMessagesResponseSchema, taskRunResponseSchema, taskRunSchema, taskRunStatusSchema, taskRunsListResponseSchema, taskScheduleKindSchema, taskSchema, tasksListResponseSchema, updateTaskBodySchema, } from "./entities/tasks.ts";
-export { quotaSchema, subscriptionStatusSchema, tenantResponseSchema, tenantSchema, tenantSettingsResponseSchema, updateTenantSettingsBodySchema, } from "./entities/tenants.ts";
+export { quotaSchema, subscriptionStatusSchema, tenantDeletionSchema, tenantResponseSchema, tenantSchema, tenantSettingsResponseSchema, updateTenantSettingsBodySchema, } from "./entities/tenants.ts";
 export type { UsageBucket, UsageOverviewQuery, UsageOverviewResponse, UsageResponse, UsageTotals, } from "./entities/usage.ts";
 export { usageOverviewQuerySchema, usageOverviewResponseSchema, usageResponseSchema, } from "./entities/usage.ts";
 export { createWorkspaceBodySchema, updateWorkspaceBodySchema, workspaceSchema, workspacesListResponseSchema, } from "./entities/workspaces.ts";

package/dist/contracts/index.js

@@ -9,12 +9,13 @@ export { blazingAgentsChatMessageMetadataSchema, chatModeSchema, chatRequestBody
 export { chatConfigurationSchema, chatConnectionSchema, chatConnectionsResponseSchema, chatCredentialsSchema, chatHealthCheckSchema, chatHealthSchema, chatIdentitySchema, createChatConnectionBodySchema, rotateChatConnectionBodySchema, 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";
 export { createPromptBodySchema, promptResponseSchema, promptSchema, promptsResponseSchema, updatePromptBodySchema, } from "./entities/prompts.js";
 export { createProviderBodySchema, providerListItemSchema, providerModelsResponseSchema, providerResponseSchema, providersResponseSchema, providerTypeSchema, thinkingLevelsResponseSchema, updateProviderBodySchema, } from "./entities/providers.js";
 export { decideToolApprovalBodySchema, latestSessionListItemSchema, latestSessionsListResponseSchema, sessionListItemSchema, sessionMessageSchema, sessionMessagesResponseSchema, sessionsListResponseSchema, toolApprovalContinuationStateSchema, toolApprovalDecisionResponseSchema, toolApprovalStateSchema, toolApprovalsResponseSchema, } from "./entities/sessions.js";
 export { copySkillBodySchema, createSkillBodySchema, skillCopyResultsSchema, skillDetailSchema, skillsListResponseSchema, } from "./entities/skills.js";
 export { createTaskBodySchema, createTaskResponseSchema, createTaskRunBodySchema, createTaskRunResponseSchema, taskListItemSchema, taskResponseSchema, taskRunMessagesResponseSchema, taskRunResponseSchema, taskRunSchema, taskRunStatusSchema, taskRunsListResponseSchema, taskScheduleKindSchema, taskSchema, tasksListResponseSchema, updateTaskBodySchema, } from "./entities/tasks.js";
-export { quotaSchema, subscriptionStatusSchema, tenantResponseSchema, tenantSchema, tenantSettingsResponseSchema, updateTenantSettingsBodySchema, } from "./entities/tenants.js";
+export { quotaSchema, subscriptionStatusSchema, tenantDeletionSchema, tenantResponseSchema, tenantSchema, tenantSettingsResponseSchema, updateTenantSettingsBodySchema, } from "./entities/tenants.js";
 export { usageOverviewQuerySchema, usageOverviewResponseSchema, usageResponseSchema, } from "./entities/usage.js";
 export { createWorkspaceBodySchema, updateWorkspaceBodySchema, workspaceSchema, workspacesListResponseSchema, } from "./entities/workspaces.js";
 export { agentIdSchema, apiKeyTokenSchema, isAdminAgentId, promptIdSchema, sessionIdSchema, } from "./ids.js";

package/dist/contracts/limitations.d.ts

@@ -138,3 +138,12 @@ export declare const TENANT_CREATION_BURST_LIMIT = 60;
 export declare const TENANT_CREATION_BURST_WINDOW_MS = 60000;
 export declare const TENANT_CREATION_SUSTAINED_LIMIT = 1000;
 export declare const TENANT_CREATION_SUSTAINED_WINDOW_MS = 86400000;
+/**
+ * Merchant monetization (ADR-0048) — bindings/usage-event list paging, guard
+ * rule bounds, and the delivery-health summary window.
+ */
+export declare const DEFAULT_MERCHANT_LIST_LIMIT = 50;
+export declare const MAX_MERCHANT_LIST_LIMIT = 200;
+export declare const MAX_MERCHANT_PRODUCT_IDS = 100;
+export declare const DEFAULT_MERCHANT_USAGE_SUMMARY_DAYS = 14;
+export declare const MAX_MERCHANT_USAGE_SUMMARY_DAYS = 90;

package/dist/contracts/limitations.js

@@ -140,3 +140,12 @@ export const TENANT_CREATION_BURST_LIMIT = 60;
 export const TENANT_CREATION_BURST_WINDOW_MS = 60_000;
 export const TENANT_CREATION_SUSTAINED_LIMIT = 1000;
 export const TENANT_CREATION_SUSTAINED_WINDOW_MS = 86_400_000;
+/**
+ * Merchant monetization (ADR-0048) — bindings/usage-event list paging, guard
+ * rule bounds, and the delivery-health summary window.
+ */
+export const DEFAULT_MERCHANT_LIST_LIMIT = 50;
+export const MAX_MERCHANT_LIST_LIMIT = 200;
+export const MAX_MERCHANT_PRODUCT_IDS = 100;
+export const DEFAULT_MERCHANT_USAGE_SUMMARY_DAYS = 14;
+export const MAX_MERCHANT_USAGE_SUMMARY_DAYS = 90;

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export type { Agent, AgentResponse, AgentsResponse, AgentVersion, AgentVersionsL
 export type { ArtifactDownloadUrlResponse, ArtifactListItem, ArtifactsListResponse, } from "./contracts/entities/artifacts.ts";
 export type { ChatConfiguration, ChatConnection, ChatConnectionsResponse, ChatCredentials, ChatHealth, ChatIdentity, CreateChatConnectionBody, RotateChatConnectionBody, 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 { CreateProviderBody, ProviderListItem, ProviderModel, ProviderModelsResponse, ProviderResponse, ProvidersResponse, ProviderType, ThinkingLevelsResponse, UpdateProviderBody, } from "./contracts/entities/providers.ts";
 export type { ToolApprovalDecisionResponse, ToolApprovalState, ToolApprovalsResponse, } from "./contracts/entities/sessions.ts";
 export type { CreateSkillBody, Skill, SkillArchiveType, SkillCopyResult, SkillCopyResults, SkillDetail, SkillFile, SkillsListResponse, } from "./contracts/entities/skills.ts";
@@ -22,4 +23,4 @@ export type { CreateWorkspaceBody, UpdateWorkspaceBody, Workspace, WorkspaceNetw
 export { BlazingAgentsDirectChatTransport, type BlazingAgentsDirectChatTransportOptions, } from "./direct-chat-transport.ts";
 export { BlazingAgentsError } from "./errors.ts";
 export { createChatRelay, createCompletionRelay, type RelayContext, type SessionOwnershipStore, } from "./relay.ts";
-export type { AgentClient, AgentSkillsResource, AgentsListOptions, AgentsResource, AgentVersionsListOptions, ArtifactsResource, AttributionInput, BlazingAgentsErrorCode, BlazingAgentsOptions, BlazingAgentsRequestOptions, BlazingAgentsUIMessage, BlazingAgentsUIMessageChunk, ChatConnectionsResource, ChatInput, ChatMessageInput, ChatPromptInput, ChatResult, ChatTrigger, CompletionInput, CompletionPromptIdInput, CompletionPromptInput, CompletionResult, KnownBlazingAgentsErrorCode, LatestSessionsListOptions, McpConnectionsResource, MemoriesListOptions, MemoriesResource, ObjectInput, ObjectPromptIdInput, ObjectPromptInput, ObjectResult, PromptsResource, ProvidersResource, ResourceRequestOptions, ResponseObservation, SessionsResource, SkillsListOptions, TasksResource, TenantResource, TerminalStreamResult, UsageResource, WorkspacesListOptions, WorkspacesResource, } from "./types.ts";
+export type { AgentClient, AgentSkillsResource, AgentsListOptions, AgentsResource, AgentVersionsListOptions, ArtifactsResource, AttributionInput, BlazingAgentsErrorCode, BlazingAgentsOptions, BlazingAgentsRequestOptions, BlazingAgentsUIMessage, BlazingAgentsUIMessageChunk, ChatConnectionsResource, ChatInput, ChatMessageInput, ChatPromptInput, ChatResult, ChatTrigger, CompletionInput, CompletionPromptIdInput, CompletionPromptInput, CompletionResult, KnownBlazingAgentsErrorCode, LatestSessionsListOptions, McpConnectionsResource, MemoriesListOptions, MemoriesResource, MerchantBindingsListOptions, MerchantBindingsResource, MerchantConnectionResource, MerchantUsageEventsListOptions, MerchantUsageEventsResource, ObjectInput, ObjectPromptIdInput, ObjectPromptInput, ObjectResult, PromptsResource, ProvidersResource, ResourceRequestOptions, ResponseObservation, SessionsResource, SkillsListOptions, TasksResource, TenantResource, TerminalStreamResult, UsageResource, WorkspacesListOptions, WorkspacesResource, } from "./types.ts";

package/dist/resources/merchant-bindings.d.ts

@@ -0,0 +1,8 @@
+import type { HttpConfig, MerchantBindingsResource } from "../types.ts";
+/**
+ * `client.merchantBindings` — list/put/delete over
+ * `/v1/merchant-connection/bindings`. `put` upserts the end user's provider
+ * customer; the server validates the customer with the provider before
+ * storing.
+ */
+export declare function createMerchantBindingsResource(config: HttpConfig): MerchantBindingsResource;

package/dist/resources/merchant-bindings.js

@@ -0,0 +1,21 @@
+import { merchantBindingResponseSchema, merchantBindingsResponseSchema, } from "../contracts/entities/merchant.js";
+import { requestJson } from "../http.js";
+/**
+ * `client.merchantBindings` — list/put/delete over
+ * `/v1/merchant-connection/bindings`. `put` upserts the end user's provider
+ * customer; the server validates the customer with the provider before
+ * storing.
+ */
+export function createMerchantBindingsResource(config) {
+    return {
+        async list({ abortSignal, ...query } = {}) {
+            return await requestJson(config, "/v1/merchant-connection/bindings", { query, signal: abortSignal }, merchantBindingsResponseSchema);
+        },
+        async put({ userId, abortSignal, ...body }) {
+            return await requestJson(config, `/v1/merchant-connection/bindings/${encodeURIComponent(userId)}`, { json: body, method: "PUT", signal: abortSignal }, merchantBindingResponseSchema);
+        },
+        async delete({ userId, abortSignal }) {
+            await requestJson(config, `/v1/merchant-connection/bindings/${encodeURIComponent(userId)}`, { method: "DELETE", signal: abortSignal });
+        },
+    };
+}

package/dist/resources/merchant-connection.d.ts

@@ -0,0 +1,7 @@
+import type { HttpConfig, MerchantConnectionResource } from "../types.ts";
+/**
+ * `client.merchantConnection` — get/create/update/retire over
+ * `/v1/merchant-connection`. One connection per tenant; `credential` is
+ * write-only and never returned.
+ */
+export declare function createMerchantConnectionResource(config: HttpConfig): MerchantConnectionResource;

package/dist/resources/merchant-connection.js

@@ -0,0 +1,26 @@
+import { merchantConnectionResponseSchema } from "../contracts/entities/merchant.js";
+import { requestJson } from "../http.js";
+/**
+ * `client.merchantConnection` — get/create/update/retire over
+ * `/v1/merchant-connection`. One connection per tenant; `credential` is
+ * write-only and never returned.
+ */
+export function createMerchantConnectionResource(config) {
+    return {
+        async get({ abortSignal } = {}) {
+            return await requestJson(config, "/v1/merchant-connection", { signal: abortSignal }, merchantConnectionResponseSchema);
+        },
+        async create({ abortSignal, ...body }) {
+            return await requestJson(config, "/v1/merchant-connection", { json: body, method: "POST", signal: abortSignal }, merchantConnectionResponseSchema);
+        },
+        async update({ abortSignal, ...body }) {
+            return await requestJson(config, "/v1/merchant-connection", { json: body, method: "PATCH", signal: abortSignal }, merchantConnectionResponseSchema);
+        },
+        async retire({ abortSignal } = {}) {
+            await requestJson(config, "/v1/merchant-connection", {
+                method: "DELETE",
+                signal: abortSignal,
+            });
+        },
+    };
+}

package/dist/resources/merchant-usage-events.d.ts

@@ -0,0 +1,7 @@
+import type { HttpConfig, MerchantUsageEventsResource } from "../types.ts";
+/**
+ * `client.merchantUsageEvents` — the immutable usage-event ledger over
+ * `/v1/merchant-usage-events`, plus the delivery-health `summary` aggregate
+ * and the per-event operator actions `retry`/`release`/`discard`.
+ */
+export declare function createMerchantUsageEventsResource(config: HttpConfig): MerchantUsageEventsResource;

package/dist/resources/merchant-usage-events.js

@@ -0,0 +1,29 @@
+import { merchantUsageEventResponseSchema, merchantUsageEventsResponseSchema, merchantUsageSummaryResponseSchema, } from "../contracts/entities/merchant.js";
+import { requestJson } from "../http.js";
+/**
+ * `client.merchantUsageEvents` — the immutable usage-event ledger over
+ * `/v1/merchant-usage-events`, plus the delivery-health `summary` aggregate
+ * and the per-event operator actions `retry`/`release`/`discard`.
+ */
+export function createMerchantUsageEventsResource(config) {
+    return {
+        async list({ abortSignal, ...query } = {}) {
+            return await requestJson(config, "/v1/merchant-usage-events", { query, signal: abortSignal }, merchantUsageEventsResponseSchema);
+        },
+        async get({ eventId, abortSignal }) {
+            return await requestJson(config, `/v1/merchant-usage-events/${encodeURIComponent(eventId)}`, { signal: abortSignal }, merchantUsageEventResponseSchema);
+        },
+        async summary({ abortSignal, ...query } = {}) {
+            return await requestJson(config, "/v1/merchant-usage-events/summary", { query, signal: abortSignal }, merchantUsageSummaryResponseSchema);
+        },
+        async retry({ eventId, abortSignal }) {
+            return await requestJson(config, `/v1/merchant-usage-events/${encodeURIComponent(eventId)}/retry`, { method: "POST", signal: abortSignal }, merchantUsageEventResponseSchema);
+        },
+        async release({ eventId, abortSignal }) {
+            return await requestJson(config, `/v1/merchant-usage-events/${encodeURIComponent(eventId)}/release`, { method: "POST", signal: abortSignal }, merchantUsageEventResponseSchema);
+        },
+        async discard({ eventId, abortSignal }) {
+            return await requestJson(config, `/v1/merchant-usage-events/${encodeURIComponent(eventId)}/discard`, { method: "POST", signal: abortSignal }, merchantUsageEventResponseSchema);
+        },
+    };
+}

package/dist/resources/skills.js

@@ -1,8 +1,7 @@
 import { skillCopyResultsSchema, skillDetailSchema, skillsListResponseSchema, } from "../contracts/entities/skills.js";
 import { isRequestAborted, requestAbortedError, requestJson, requestStream, } from "../http.js";
 function fileUrl(agentId, input) {
-    const path = input.path.split("/").map(encodeURIComponent).join("/");
-    return `/v1/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(input.skillId)}/files/${path}`;
+    return `/v1/agents/${encodeURIComponent(agentId)}/skills/${encodeURIComponent(input.skillId)}/files?path=${encodeURIComponent(input.path)}`;
 }
 export function createAgentSkillsResource(config, agentId) {
     return {

package/dist/types.d.ts

@@ -6,6 +6,7 @@ import type { BlazingAgentsChatMessageMetadata } from "./contracts/entities/chat
 import type { ChatConnection, ChatConnectionsResponse, CreateChatConnectionBody, RotateChatConnectionBody, UpdateChatConnectionBody } from "./contracts/entities/chat-connections.ts";
 import type { CreateMcpConnectionBody, McpAttachmentResponse, McpAttachmentsResponse, McpConnectionOauthConnectResponse, McpConnectionReconnectResult, McpConnectionResponse, McpConnectionsResponse, McpConnectionTestResponse, ReconnectMcpConnectionBody, UpdateMcpAttachmentBody, UpdateMcpConnectionBody } from "./contracts/entities/mcp-connections.ts";
 import type { CreateMemoryBody, MemoriesListResponse, MemoryResponse, UpdateMemoryBody } from "./contracts/entities/memories.ts";
+import type { CreateMerchantConnectionBody, MerchantBindingResponse, MerchantBindingsResponse, MerchantConnectionResponse, MerchantUsageEventResponse, MerchantUsageEventStatus, MerchantUsageEventsResponse, MerchantUsageSummaryResponse, UpdateMerchantConnectionBody, UpsertMerchantBindingBody } from "./contracts/entities/merchant.ts";
 import type { CreatePromptBody, PromptResponse, PromptsResponse, UpdatePromptBody } from "./contracts/entities/prompts.ts";
 import type { CreateProviderBody, DeleteProviderOptions, ProviderModelsResponse, ProviderResponse, ProvidersResponse, ThinkingLevelsResponse, UpdateProviderBody } from "./contracts/entities/providers.ts";
 import type { DecideToolApprovalBody, LatestSessionsListResponse, SessionMessagesResponse, SessionsListResponse, ToolApprovalDecisionResponse, ToolApprovalsResponse } from "./contracts/entities/sessions.ts";
@@ -515,6 +516,65 @@ export interface UsageResource {
     /** Returns totals, daily usage, and bounded Agent, user, and model rankings. */
     overview(input?: Partial<UsageOverviewQuery> & ResourceRequestOptions): Promise<UsageOverviewResponse>;
 }
+/**
+ * `client.merchantConnection` — the tenant's own Polar/Dodo merchant
+ * connection (ADR-0048). `credential` is write-only: responses expose only
+ * `keyFragment`.
+ */
+export interface MerchantConnectionResource {
+    create(input: CreateMerchantConnectionBody & ResourceRequestOptions): Promise<MerchantConnectionResponse>;
+    get(input?: ResourceRequestOptions): Promise<MerchantConnectionResponse>;
+    /** Retires the connection; deliveries stop (`DELETE` → 204). */
+    retire(input?: ResourceRequestOptions): Promise<void>;
+    update(input: UpdateMerchantConnectionBody & ResourceRequestOptions): Promise<MerchantConnectionResponse>;
+}
+export interface MerchantBindingsListOptions extends ResourceRequestOptions {
+    cursor?: string;
+    limit?: number;
+    userId?: string;
+}
+/**
+ * `client.merchantBindings` — end-user → provider customer bindings behind
+ * `/v1/merchant-connection/bindings`. `put` validates the customer against
+ * the provider.
+ */
+export interface MerchantBindingsResource {
+    delete(input: {
+        userId: string;
+    } & ResourceRequestOptions): Promise<void>;
+    list(input?: MerchantBindingsListOptions): Promise<MerchantBindingsResponse>;
+    put(input: UpsertMerchantBindingBody & {
+        userId: string;
+    } & ResourceRequestOptions): Promise<MerchantBindingResponse>;
+}
+export interface MerchantUsageEventsListOptions extends ResourceRequestOptions {
+    cursor?: string;
+    limit?: number;
+    status?: MerchantUsageEventStatus;
+}
+/**
+ * `client.merchantUsageEvents` — the immutable delivery ledger behind
+ * `/v1/merchant-usage-events`. `retry`, `release`, and `discard` are the
+ * operator actions on unresolved events.
+ */
+export interface MerchantUsageEventsResource {
+    discard(input: {
+        eventId: string;
+    } & ResourceRequestOptions): Promise<MerchantUsageEventResponse>;
+    get(input: {
+        eventId: string;
+    } & ResourceRequestOptions): Promise<MerchantUsageEventResponse>;
+    list(input?: MerchantUsageEventsListOptions): Promise<MerchantUsageEventsResponse>;
+    release(input: {
+        eventId: string;
+    } & ResourceRequestOptions): Promise<MerchantUsageEventResponse>;
+    retry(input: {
+        eventId: string;
+    } & ResourceRequestOptions): Promise<MerchantUsageEventResponse>;
+    summary(input?: {
+        days?: number;
+    } & ResourceRequestOptions): Promise<MerchantUsageSummaryResponse>;
+}
 export interface ChatConnectionsResource {
     checkHealth(input: {
         chatConnectionId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blazingagents/sdk",
-  "version": "0.9.2",
+  "version": "0.10.0",
   "description": "TypeScript SDK for the Blazing Agents API",
   "homepage": "https://docs.blazingagents.com",
   "bugs": {