@blazingagents/sdk 0.9.2 → 0.10.0

package/README.md

@@ -16,7 +16,7 @@ requires Node.js 24 or newer.
 ## Features
 
 - Typed clients for Agents, Workspaces, Skills, Providers, Prompts, Tasks,
-  Sessions, Artifacts, Slack and Telegram Chat Connections, usage, and Tenant settings.
+  Sessions, Artifacts, Slack and Telegram Chat Connections, usage, Tenant settings, and merchant monetization.
 - Stateful chat and stateless text or structured-object generation.
 - Public Zod contracts for validating API requests and responses.
 - Cursor pagination and binary transfers.
@@ -238,3 +238,33 @@ and `ToolApprovalState`; runtime policy schemas are exported from
 Use the [connection example](https://github.com/blazingagents/typescript-sdk/blob/main/examples/chat-integrations.md) to connect an existing
 Agent through REST. BA hosts the Chat SDK runtime, conversation history, and
 approval cards; no additional SDK resource is required.
+
+## Merchant monetization
+
+Bill your own customers for model-token usage through your Polar or Dodo
+merchant account. Blazing Agents records usage per Turn and delivers it to
+your provider; your provider owns billing.
+
+```ts
+const client = new BlazingAgents({ apiKey: "ba_..." });
+
+// One-time: connect your merchant account (dashboard or API).
+await client.merchantConnection.create({
+  provider: "polar",
+  environment: "sandbox",
+  credential: "polar_oat_...", // organization access token
+});
+
+// On user onboarding in your backend: bind your user id to the
+// provider-side customer so usage is attributed correctly.
+await client.merchantBindings.put({
+  userId: "user_123",
+  customerId: "cust_polar_...",
+});
+```
+
+`client.merchantUsageEvents` exposes the delivery ledger (`list`, `get`,
+`summary`) and the operator actions `retry`, `release`, and `discard`. The
+optional eligibility guard (`guard` on the connection) refuses new
+executions when the bound customer lacks the required subscription or
+balance; it is a provider-reported check, not a spending lock.

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { AgentClient, AgentsResource, ArtifactsResource, BlazingAgentsOptions, BlazingAgentsRequestOptions, ChatConnectionsResource, ChatInput, ChatResult, CompletionInput, CompletionResult, McpConnectionsResource, MemoriesResource, ObjectInput, ObjectResult, PromptsResource, ProvidersResource, SessionsResource, TasksResource, TenantResource, UsageResource, WorkspacesResource } from "./types.ts";
+import type { AgentClient, AgentsResource, ArtifactsResource, BlazingAgentsOptions, BlazingAgentsRequestOptions, ChatConnectionsResource, ChatInput, ChatResult, CompletionInput, CompletionResult, McpConnectionsResource, MemoriesResource, MerchantBindingsResource, MerchantConnectionResource, MerchantUsageEventsResource, ObjectInput, ObjectResult, PromptsResource, ProvidersResource, SessionsResource, TasksResource, TenantResource, UsageResource, WorkspacesResource } from "./types.ts";
 export declare class BlazingAgents {
     private readonly config;
     readonly chatConnections: ChatConnectionsResource;
@@ -13,6 +13,9 @@ export declare class BlazingAgents {
     readonly tasks: TasksResource;
     readonly tenant: TenantResource;
     readonly workspaces: WorkspacesResource;
+    readonly merchantConnection: MerchantConnectionResource;
+    readonly merchantBindings: MerchantBindingsResource;
+    readonly merchantUsageEvents: MerchantUsageEventsResource;
     constructor(options: BlazingAgentsOptions);
     agent({ agentId }: {
         agentId: string;

package/dist/client.js

@@ -4,6 +4,9 @@ import { createArtifactsResource } from "./resources/artifacts.js";
 import { createChatConnectionsResource } from "./resources/chat-connections.js";
 import { createMcpConnectionsResource } from "./resources/mcp-connections.js";
 import { createMemoriesResource } from "./resources/memories.js";
+import { createMerchantBindingsResource } from "./resources/merchant-bindings.js";
+import { createMerchantConnectionResource } from "./resources/merchant-connection.js";
+import { createMerchantUsageEventsResource } from "./resources/merchant-usage-events.js";
 import { createPromptsResource } from "./resources/prompts.js";
 import { createProvidersResource } from "./resources/providers.js";
 import { createSessionsResource } from "./resources/sessions.js";
@@ -28,6 +31,9 @@ export class BlazingAgents {
     tasks;
     tenant;
     workspaces;
+    merchantConnection;
+    merchantBindings;
+    merchantUsageEvents;
     constructor(options) {
         this.config = {
             apiKey: options.apiKey,
@@ -50,6 +56,9 @@ export class BlazingAgents {
         this.tasks = createTasksResource(this.config);
         this.tenant = createTenantResource(this.config);
         this.workspaces = createWorkspacesResource(this.config);
+        this.merchantConnection = createMerchantConnectionResource(this.config);
+        this.merchantBindings = createMerchantBindingsResource(this.config);
+        this.merchantUsageEvents = createMerchantUsageEventsResource(this.config);
     }
     agent({ agentId }) {
         return { skills: createAgentSkillsResource(this.config, agentId) };

package/dist/contracts/api.d.ts

@@ -27,6 +27,8 @@ export declare const apiErrorCodeSchema: z.ZodEnum<{
     agent_version_not_found: "agent_version_not_found";
     api_key_limit_reached: "api_key_limit_reached";
     artifact_session_cap_reached: "artifact_session_cap_reached";
+    chat_webhook_conflict: "chat_webhook_conflict";
+    chat_webhook_registration_failed: "chat_webhook_registration_failed";
     checkout_evidence_mismatch: "checkout_evidence_mismatch";
     internal: "internal";
     invalid_cursor: "invalid_cursor";
@@ -39,6 +41,19 @@ export declare const apiErrorCodeSchema: z.ZodEnum<{
     mcp_connection_name_conflict: "mcp_connection_name_conflict";
     mcp_connection_stale_credential_version: "mcp_connection_stale_credential_version";
     mcp_connection_unreachable: "mcp_connection_unreachable";
+    merchant_account_mismatch: "merchant_account_mismatch";
+    merchant_balance_required: "merchant_balance_required";
+    merchant_binding_not_found: "merchant_binding_not_found";
+    merchant_binding_required: "merchant_binding_required";
+    merchant_connection_not_found: "merchant_connection_not_found";
+    merchant_credential_invalid: "merchant_credential_invalid";
+    merchant_customer_not_found: "merchant_customer_not_found";
+    merchant_customer_unmapped: "merchant_customer_unmapped";
+    merchant_eligibility_unavailable: "merchant_eligibility_unavailable";
+    merchant_event_not_found: "merchant_event_not_found";
+    merchant_event_state_conflict: "merchant_event_state_conflict";
+    merchant_provider_unavailable: "merchant_provider_unavailable";
+    merchant_subscription_required: "merchant_subscription_required";
     message_not_found: "message_not_found";
     model_discovery_unsupported: "model_discovery_unsupported";
     model_not_found: "model_not_found";
@@ -68,6 +83,10 @@ export declare const apiErrorCodeSchema: z.ZodEnum<{
     skill_uncompressed_too_large: "skill_uncompressed_too_large";
     subscription_required: "subscription_required";
     task_active_run_exists: "task_active_run_exists";
+    tenant_deleting: "tenant_deleting";
+    tenant_deletion_in_progress: "tenant_deletion_in_progress";
+    tenant_deletion_not_ready: "tenant_deletion_not_ready";
+    tenant_not_deleting: "tenant_not_deleting";
     tool_approval_continuation_not_found: "tool_approval_continuation_not_found";
     tool_approval_decision_conflict: "tool_approval_decision_conflict";
     unauthorized: "unauthorized";
@@ -87,6 +106,8 @@ export declare const apiErrorSchema: z.ZodObject<{
         agent_version_not_found: "agent_version_not_found";
         api_key_limit_reached: "api_key_limit_reached";
         artifact_session_cap_reached: "artifact_session_cap_reached";
+        chat_webhook_conflict: "chat_webhook_conflict";
+        chat_webhook_registration_failed: "chat_webhook_registration_failed";
         checkout_evidence_mismatch: "checkout_evidence_mismatch";
         internal: "internal";
         invalid_cursor: "invalid_cursor";
@@ -99,6 +120,19 @@ export declare const apiErrorSchema: z.ZodObject<{
         mcp_connection_name_conflict: "mcp_connection_name_conflict";
         mcp_connection_stale_credential_version: "mcp_connection_stale_credential_version";
         mcp_connection_unreachable: "mcp_connection_unreachable";
+        merchant_account_mismatch: "merchant_account_mismatch";
+        merchant_balance_required: "merchant_balance_required";
+        merchant_binding_not_found: "merchant_binding_not_found";
+        merchant_binding_required: "merchant_binding_required";
+        merchant_connection_not_found: "merchant_connection_not_found";
+        merchant_credential_invalid: "merchant_credential_invalid";
+        merchant_customer_not_found: "merchant_customer_not_found";
+        merchant_customer_unmapped: "merchant_customer_unmapped";
+        merchant_eligibility_unavailable: "merchant_eligibility_unavailable";
+        merchant_event_not_found: "merchant_event_not_found";
+        merchant_event_state_conflict: "merchant_event_state_conflict";
+        merchant_provider_unavailable: "merchant_provider_unavailable";
+        merchant_subscription_required: "merchant_subscription_required";
         message_not_found: "message_not_found";
         model_discovery_unsupported: "model_discovery_unsupported";
         model_not_found: "model_not_found";
@@ -128,6 +162,10 @@ export declare const apiErrorSchema: z.ZodObject<{
         skill_uncompressed_too_large: "skill_uncompressed_too_large";
         subscription_required: "subscription_required";
         task_active_run_exists: "task_active_run_exists";
+        tenant_deleting: "tenant_deleting";
+        tenant_deletion_in_progress: "tenant_deletion_in_progress";
+        tenant_deletion_not_ready: "tenant_deletion_not_ready";
+        tenant_not_deleting: "tenant_not_deleting";
         tool_approval_continuation_not_found: "tool_approval_continuation_not_found";
         tool_approval_decision_conflict: "tool_approval_decision_conflict";
         unauthorized: "unauthorized";
@@ -152,6 +190,8 @@ export declare const apiErrorResponseSchema: z.ZodObject<{
             agent_version_not_found: "agent_version_not_found";
             api_key_limit_reached: "api_key_limit_reached";
             artifact_session_cap_reached: "artifact_session_cap_reached";
+            chat_webhook_conflict: "chat_webhook_conflict";
+            chat_webhook_registration_failed: "chat_webhook_registration_failed";
             checkout_evidence_mismatch: "checkout_evidence_mismatch";
             internal: "internal";
             invalid_cursor: "invalid_cursor";
@@ -164,6 +204,19 @@ export declare const apiErrorResponseSchema: z.ZodObject<{
             mcp_connection_name_conflict: "mcp_connection_name_conflict";
             mcp_connection_stale_credential_version: "mcp_connection_stale_credential_version";
             mcp_connection_unreachable: "mcp_connection_unreachable";
+            merchant_account_mismatch: "merchant_account_mismatch";
+            merchant_balance_required: "merchant_balance_required";
+            merchant_binding_not_found: "merchant_binding_not_found";
+            merchant_binding_required: "merchant_binding_required";
+            merchant_connection_not_found: "merchant_connection_not_found";
+            merchant_credential_invalid: "merchant_credential_invalid";
+            merchant_customer_not_found: "merchant_customer_not_found";
+            merchant_customer_unmapped: "merchant_customer_unmapped";
+            merchant_eligibility_unavailable: "merchant_eligibility_unavailable";
+            merchant_event_not_found: "merchant_event_not_found";
+            merchant_event_state_conflict: "merchant_event_state_conflict";
+            merchant_provider_unavailable: "merchant_provider_unavailable";
+            merchant_subscription_required: "merchant_subscription_required";
             message_not_found: "message_not_found";
             model_discovery_unsupported: "model_discovery_unsupported";
             model_not_found: "model_not_found";
@@ -193,6 +246,10 @@ export declare const apiErrorResponseSchema: z.ZodObject<{
             skill_uncompressed_too_large: "skill_uncompressed_too_large";
             subscription_required: "subscription_required";
             task_active_run_exists: "task_active_run_exists";
+            tenant_deleting: "tenant_deleting";
+            tenant_deletion_in_progress: "tenant_deletion_in_progress";
+            tenant_deletion_not_ready: "tenant_deletion_not_ready";
+            tenant_not_deleting: "tenant_not_deleting";
             tool_approval_continuation_not_found: "tool_approval_continuation_not_found";
             tool_approval_decision_conflict: "tool_approval_decision_conflict";
             unauthorized: "unauthorized";

package/dist/contracts/api.js

@@ -74,6 +74,25 @@ export const apiErrorCodeSchema = z.enum([
     "skill_too_many_files",
     "skill_uncompressed_too_large",
     "task_active_run_exists",
+    "chat_webhook_conflict",
+    "chat_webhook_registration_failed",
+    "merchant_connection_not_found",
+    "merchant_credential_invalid",
+    "merchant_provider_unavailable",
+    "merchant_customer_not_found",
+    "merchant_binding_not_found",
+    "merchant_binding_required",
+    "merchant_account_mismatch",
+    "merchant_event_not_found",
+    "merchant_event_state_conflict",
+    "merchant_customer_unmapped",
+    "merchant_subscription_required",
+    "merchant_balance_required",
+    "merchant_eligibility_unavailable",
+    "tenant_deleting",
+    "tenant_deletion_in_progress",
+    "tenant_deletion_not_ready",
+    "tenant_not_deleting",
 ]);
 export const apiErrorSchema = z
     .object({

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

@@ -6,17 +6,12 @@ export declare const chatCredentialsSchema: z.ZodDiscriminatedUnion<[z.ZodObject
 }, z.core.$strict>, z.ZodObject<{
     platform: z.ZodLiteral<"telegram">;
     botToken: z.ZodString;
-    webhookSecret: z.ZodString;
 }, z.core.$strict>], "platform">;
 export declare const chatConfigurationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    teamId: z.ZodString;
-    appId: z.ZodString;
-    webhookUrl: z.ZodURL;
     channelIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
     platform: z.ZodLiteral<"slack">;
 }, z.core.$strict>, z.ZodObject<{
-    botId: z.ZodString;
-    webhookUrl: z.ZodURL;
+    businessMode: z.ZodDefault<z.ZodBoolean>;
     chatIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
     platform: z.ZodLiteral<"telegram">;
 }, z.core.$strict>], "platform">;
@@ -25,12 +20,9 @@ export declare const createChatConnectionBodySchema: z.ZodDiscriminatedUnion<[z.
     name: z.ZodString;
     enabled: z.ZodDefault<z.ZodBoolean>;
     platform: z.ZodLiteral<"slack">;
-    configuration: z.ZodObject<{
-        teamId: z.ZodString;
-        appId: z.ZodString;
-        webhookUrl: z.ZodURL;
+    configuration: z.ZodPrefault<z.ZodObject<{
         channelIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strict>;
+    }, z.core.$strict>>;
     credentials: z.ZodObject<{
         botToken: z.ZodString;
         signingSecret: z.ZodString;
@@ -40,14 +32,12 @@ export declare const createChatConnectionBodySchema: z.ZodDiscriminatedUnion<[z.
     name: z.ZodString;
     enabled: z.ZodDefault<z.ZodBoolean>;
     platform: z.ZodLiteral<"telegram">;
-    configuration: z.ZodObject<{
-        botId: z.ZodString;
-        webhookUrl: z.ZodURL;
+    configuration: z.ZodPrefault<z.ZodObject<{
+        businessMode: z.ZodDefault<z.ZodBoolean>;
         chatIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strict>;
+    }, z.core.$strict>>;
     credentials: z.ZodObject<{
         botToken: z.ZodString;
-        webhookSecret: z.ZodString;
     }, z.core.$strict>;
 }, z.core.$strict>], "platform">;
 export declare const rotateChatConnectionBodySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -57,11 +47,14 @@ export declare const rotateChatConnectionBodySchema: z.ZodDiscriminatedUnion<[z.
 }, z.core.$strict>, z.ZodObject<{
     platform: z.ZodLiteral<"telegram">;
     botToken: z.ZodString;
-    webhookSecret: z.ZodString;
 }, z.core.$strict>], "platform">;
 export declare const updateChatConnectionBodySchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
-    webhookUrl: z.ZodOptional<z.ZodURL>;
+    configuration: z.ZodOptional<z.ZodObject<{
+        businessMode: z.ZodOptional<z.ZodBoolean>;
+        chatIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        channelIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export declare const chatConnectionParamsSchema: z.ZodObject<{
     id: z.ZodString;
@@ -106,17 +99,14 @@ export declare const chatConnectionSchema: z.ZodObject<{
     }>;
     enabled: z.ZodBoolean;
     configuration: z.ZodDiscriminatedUnion<[z.ZodObject<{
-        teamId: z.ZodString;
-        appId: z.ZodString;
-        webhookUrl: z.ZodURL;
         channelIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
         platform: z.ZodLiteral<"slack">;
     }, z.core.$strip>, z.ZodObject<{
-        botId: z.ZodString;
-        webhookUrl: z.ZodURL;
+        businessMode: z.ZodDefault<z.ZodBoolean>;
         chatIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
         platform: z.ZodLiteral<"telegram">;
     }, z.core.$strip>], "platform">;
+    webhookUrl: z.ZodURL;
     identity: z.ZodObject<{
         botId: z.ZodString;
         botUserId: z.ZodString;
@@ -161,17 +151,14 @@ export declare const chatConnectionsResponseSchema: z.ZodObject<{
         }>;
         enabled: z.ZodBoolean;
         configuration: z.ZodDiscriminatedUnion<[z.ZodObject<{
-            teamId: z.ZodString;
-            appId: z.ZodString;
-            webhookUrl: z.ZodURL;
             channelIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
             platform: z.ZodLiteral<"slack">;
         }, z.core.$strip>, z.ZodObject<{
-            botId: z.ZodString;
-            webhookUrl: z.ZodURL;
+            businessMode: z.ZodDefault<z.ZodBoolean>;
             chatIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
             platform: z.ZodLiteral<"telegram">;
         }, z.core.$strip>], "platform">;
+        webhookUrl: z.ZodURL;
         identity: z.ZodObject<{
             botId: z.ZodString;
             botUserId: z.ZodString;

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

@@ -1,16 +1,5 @@
 import { z } from "zod";
 import { agentIdSchema, chatConnectionIdSchema, tenantIdSchema, } from "../ids.js";
-const webhookUrl = z
-    .url()
-    .max(2048)
-    .refine((value) => {
-    const url = new URL(value);
-    return (url.protocol === "https:" &&
-        !url.username &&
-        !url.password &&
-        !url.search &&
-        !url.hash);
-}, "Use an HTTPS callback URL without credentials, query or fragment");
 const secret = z
     .string()
     .min(8)
@@ -28,19 +17,11 @@ export const chatCredentialsSchema = z.discriminatedUnion("platform", [
         .object({
         platform: z.literal("telegram"),
         botToken: z.string().regex(/^\d+:[A-Za-z0-9_-]+$/),
-        webhookSecret: z
-            .string()
-            .min(1)
-            .max(256)
-            .regex(/^[A-Za-z0-9_-]+$/),
     })
         .strict(),
 ]);
 const slackConfiguration = z
     .object({
-    teamId: z.string().regex(/^T[A-Z0-9]+$/),
-    appId: z.string().regex(/^A[A-Z0-9]+$/),
-    webhookUrl,
     channelIds: z
         .array(z.string().regex(/^[CG][A-Z0-9]+$/))
         .max(20)
@@ -49,8 +30,7 @@ const slackConfiguration = z
     .strict();
 const telegramConfiguration = z
     .object({
-    botId: z.string().regex(/^\d+$/),
-    webhookUrl,
+    businessMode: z.boolean().default(false),
     chatIds: z
         .array(z.string().regex(/^-?\d+$/))
         .max(20)
@@ -71,7 +51,7 @@ export const createChatConnectionBodySchema = z.discriminatedUnion("platform", [
         .object({
         ...common,
         platform: z.literal("slack"),
-        configuration: slackConfiguration,
+        configuration: slackConfiguration.prefault({}),
         credentials: chatCredentialsSchema.options[0].omit({ platform: true }),
     })
         .strict(),
@@ -79,18 +59,37 @@ export const createChatConnectionBodySchema = z.discriminatedUnion("platform", [
         .object({
         ...common,
         platform: z.literal("telegram"),
-        configuration: telegramConfiguration,
+        configuration: telegramConfiguration.prefault({}),
         credentials: chatCredentialsSchema.options[1].omit({ platform: true }),
     })
         .strict(),
 ]);
-export const rotateChatConnectionBodySchema = chatCredentialsSchema;
+export const rotateChatConnectionBodySchema = z.discriminatedUnion("platform", [
+    chatCredentialsSchema.options[0],
+    chatCredentialsSchema.options[1],
+]);
 export const updateChatConnectionBodySchema = z
-    .object({ name: common.name.optional(), webhookUrl: webhookUrl.optional() })
+    .object({
+    name: common.name.optional(),
+    configuration: z
+        .object({
+        businessMode: z.boolean().optional(),
+        chatIds: z
+            .array(z.string().regex(/^-?\d+$/))
+            .max(20)
+            .optional(),
+        channelIds: z
+            .array(z.string().regex(/^[CG][A-Z0-9]+$/))
+            .max(20)
+            .optional(),
+    })
+        .strict()
+        .optional(),
+})
     .strict()
-    .refine((body) => body.name !== undefined || body.webhookUrl !== undefined, {
-    message: "Provide a name or webhook URL",
-});
+    .refine((body) => body.name !== undefined ||
+    (body.configuration !== undefined &&
+        Object.keys(body.configuration).length > 0), { message: "Provide a name or a configuration change" });
 export const chatConnectionParamsSchema = z.object({
     id: chatConnectionIdSchema,
 });
@@ -129,6 +128,7 @@ export const chatConnectionSchema = z
         chatConfigurationSchema.options[0].strip(),
         chatConfigurationSchema.options[1].strip(),
     ]),
+    webhookUrl: z.url(),
     identity: chatIdentitySchema,
     health: chatHealthSchema,
     credentialFragment: z.string().max(4),

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

@@ -25,6 +25,7 @@ export declare const usageSummarySchema: z.ZodObject<{
     durationMs: z.ZodNumber;
     errorMessage: z.ZodNullable<z.ZodString>;
     inputTokens: z.ZodNumber;
+    measurementComplete: z.ZodBoolean;
     modelDurationMs: z.ZodNumber;
     metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     modelId: z.ZodString;
@@ -55,6 +56,7 @@ export declare const blazingAgentsChatMessageMetadataSchema: z.ZodObject<{
             durationMs: z.ZodNumber;
             errorMessage: z.ZodNullable<z.ZodString>;
             inputTokens: z.ZodNumber;
+            measurementComplete: z.ZodBoolean;
             modelDurationMs: z.ZodNumber;
             metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
             modelId: z.ZodString;

package/dist/contracts/entities/chat.js

@@ -21,6 +21,12 @@ export const usageSummarySchema = z
     durationMs: z.number().int().min(0),
     errorMessage: z.string().nullable(),
     inputTokens: z.number().int().min(0),
+    /**
+     * True only when every measured inference for this Turn reported
+     * input/output totals. Provider omissions stay unknown — a zero is never
+     * substituted for a missing measurement (ADR-0048).
+     */
+    measurementComplete: z.boolean(),
     modelDurationMs: z.number().int().min(0),
     metadata: z.record(z.string(), z.unknown()),
     modelId: agentModelIdSchema,