@blazingagents/sdk 0.40.0 → 0.41.0

package/dist/contracts/api.d.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import type { BlazingAgentsErrorCode } from "../types.ts";
 /**
  * `/v1` error envelope — see docs/adr/0003-ai-sdk-native-wire-protocol.md.
  * Closed producer code set; `code` is what SDKs switch on and `message` is
@@ -93,9 +94,15 @@ export declare const apiErrorCodeSchema: z.ZodEnum<{
     workspace_in_use: "workspace_in_use";
     workspace_not_found: "workspace_not_found";
 }>;
+/**
+ * A code as received: any non-empty string, so a server newer than this SDK
+ * can send a code the SDK does not list. The type keeps autocomplete for the
+ * listed codes.
+ */
+export declare const receivedApiErrorCodeSchema: z.ZodType<BlazingAgentsErrorCode>;
 export declare const receivedApiErrorResponseSchema: z.ZodObject<{
     error: z.ZodObject<{
-        code: z.ZodString;
+        code: z.ZodType<BlazingAgentsErrorCode, unknown, z.core.$ZodTypeInternals<BlazingAgentsErrorCode, unknown>>;
         details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         message: z.ZodString;
         param: z.ZodOptional<z.ZodString>;

package/dist/contracts/api.js

@@ -93,7 +93,14 @@ export const apiErrorCodeSchema = z.enum([
     "tenant_deletion_not_ready",
     "tenant_not_deleting",
 ]);
-const receivedApiErrorCodeSchema = z.string().min(1);
+/**
+ * A code as received: any non-empty string, so a server newer than this SDK
+ * can send a code the SDK does not list. The type keeps autocomplete for the
+ * listed codes.
+ */
+export const receivedApiErrorCodeSchema = z
+    .string()
+    .min(1);
 const receivedApiErrorSchema = z
     .object({
     code: receivedApiErrorCodeSchema,

package/dist/contracts/entities/session-inputs.d.ts

@@ -11,12 +11,12 @@ export declare const sessionInputSchema: z.ZodObject<{
     requestId: z.ZodString;
     sequence: z.ZodNumber;
     message: z.ZodObject<{
+        role: z.ZodLiteral<"user">;
         id: z.ZodString;
         parts: z.ZodArray<z.ZodObject<{
             type: z.ZodString;
         }, z.core.$loose>>;
         metadata: z.ZodOptional<z.ZodUnknown>;
-        role: z.ZodLiteral<"user">;
     }, z.core.$loose>;
     state: z.ZodEnum<{
         accepted: "accepted";
@@ -49,12 +49,12 @@ export declare const sessionInputResponseSchema: z.ZodObject<{
         requestId: z.ZodString;
         sequence: z.ZodNumber;
         message: z.ZodObject<{
+            role: z.ZodLiteral<"user">;
             id: z.ZodString;
             parts: z.ZodArray<z.ZodObject<{
                 type: z.ZodString;
             }, z.core.$loose>>;
             metadata: z.ZodOptional<z.ZodUnknown>;
-            role: z.ZodLiteral<"user">;
         }, z.core.$loose>;
         state: z.ZodEnum<{
             accepted: "accepted";
@@ -88,12 +88,12 @@ export declare const sessionInputsResponseSchema: z.ZodObject<{
         requestId: z.ZodString;
         sequence: z.ZodNumber;
         message: z.ZodObject<{
+            role: z.ZodLiteral<"user">;
             id: z.ZodString;
             parts: z.ZodArray<z.ZodObject<{
                 type: z.ZodString;
             }, z.core.$loose>>;
             metadata: z.ZodOptional<z.ZodUnknown>;
-            role: z.ZodLiteral<"user">;
         }, z.core.$loose>;
         state: z.ZodEnum<{
             accepted: "accepted";
@@ -164,12 +164,12 @@ export declare const chatSteerConsumedEventSchema: z.ZodObject<{
         requestId: z.ZodString;
         sequence: z.ZodNumber;
         message: z.ZodObject<{
+            role: z.ZodLiteral<"user">;
             id: z.ZodString;
             parts: z.ZodArray<z.ZodObject<{
                 type: z.ZodString;
             }, z.core.$loose>>;
             metadata: z.ZodOptional<z.ZodUnknown>;
-            role: z.ZodLiteral<"user">;
         }, z.core.$loose>;
         turnId: z.ZodString;
     }, z.core.$strip>;

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

@@ -379,94 +379,7 @@ export declare const taskRunResponseSchema: z.ZodObject<{
         succeeded: "succeeded";
     }>;
     error: z.ZodNullable<z.ZodString>;
-    errorCode: z.ZodNullable<z.ZodEnum<{
-        admin_agent_managed: "admin_agent_managed";
-        agent_disabled: "agent_disabled";
-        agent_mcp_connection_not_found: "agent_mcp_connection_not_found";
-        agent_mcp_connections_invalid: "agent_mcp_connections_invalid";
-        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";
-        forbidden: "forbidden";
-        function_call_conflict: "function_call_conflict";
-        idempotency_conflict: "idempotency_conflict";
-        input_idempotency_conflict: "input_idempotency_conflict";
-        insufficient_scope: "insufficient_scope";
-        internal: "internal";
-        invalid_cursor: "invalid_cursor";
-        invalid_request: "invalid_request";
-        mcp_connection_authentication_failed: "mcp_connection_authentication_failed";
-        mcp_connection_discovery_failed: "mcp_connection_discovery_failed";
-        mcp_connection_in_use: "mcp_connection_in_use";
-        mcp_connection_invalid: "mcp_connection_invalid";
-        mcp_connection_limit_reached: "mcp_connection_limit_reached";
-        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_in_use: "merchant_connection_in_use";
-        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_id_conflict: "message_id_conflict";
-        message_not_found: "message_not_found";
-        model_discovery_unsupported: "model_discovery_unsupported";
-        model_not_found: "model_not_found";
-        model_spending_limit_exceeded: "model_spending_limit_exceeded";
-        model_validation_unavailable: "model_validation_unavailable";
-        not_found: "not_found";
-        prompt_variable_missing: "prompt_variable_missing";
-        prompt_variable_unknown: "prompt_variable_unknown";
-        provider_historical_use: "provider_historical_use";
-        provider_in_use: "provider_in_use";
-        provider_limit_reached: "provider_limit_reached";
-        provider_name_conflict: "provider_name_conflict";
-        provider_not_found: "provider_not_found";
-        provider_required: "provider_required";
-        quota_exceeded: "quota_exceeded";
-        rate_limited: "rate_limited";
-        service_unavailable: "service_unavailable";
-        session_busy: "session_busy";
-        session_fork_deleted: "session_fork_deleted";
-        session_fork_unavailable: "session_fork_unavailable";
-        session_turn_unresponsive: "session_turn_unresponsive";
-        session_version_mismatch: "session_version_mismatch";
-        skill_invalid_archive: "skill_invalid_archive";
-        skill_invalid_markdown: "skill_invalid_markdown";
-        skill_limit_reached: "skill_limit_reached";
-        skill_name_conflict: "skill_name_conflict";
-        skill_not_found: "skill_not_found";
-        skill_too_many_files: "skill_too_many_files";
-        skill_uncompressed_too_large: "skill_uncompressed_too_large";
-        steer_not_available: "steer_not_available";
-        subscription_already_paid: "subscription_already_paid";
-        subscription_not_cancelled: "subscription_not_cancelled";
-        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_settled: "tool_approval_continuation_settled";
-        tool_approval_decision_conflict: "tool_approval_decision_conflict";
-        unauthorized: "unauthorized";
-        usage_credit_required: "usage_credit_required";
-        validation_failed: "validation_failed";
-        workspace_busy: "workspace_busy";
-        workspace_in_use: "workspace_in_use";
-        workspace_not_found: "workspace_not_found";
-    }>>;
+    errorCode: z.ZodNullable<z.ZodType<import("../../types.ts").BlazingAgentsErrorCode, unknown, z.core.$ZodTypeInternals<import("../../types.ts").BlazingAgentsErrorCode, unknown>>>;
     userId: z.ZodString;
     metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     startedAt: z.ZodNullable<z.ZodISODateTime>;
@@ -601,94 +514,7 @@ export declare const taskRunsListResponseSchema: z.ZodObject<{
             succeeded: "succeeded";
         }>;
         error: z.ZodNullable<z.ZodString>;
-        errorCode: z.ZodNullable<z.ZodEnum<{
-            admin_agent_managed: "admin_agent_managed";
-            agent_disabled: "agent_disabled";
-            agent_mcp_connection_not_found: "agent_mcp_connection_not_found";
-            agent_mcp_connections_invalid: "agent_mcp_connections_invalid";
-            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";
-            forbidden: "forbidden";
-            function_call_conflict: "function_call_conflict";
-            idempotency_conflict: "idempotency_conflict";
-            input_idempotency_conflict: "input_idempotency_conflict";
-            insufficient_scope: "insufficient_scope";
-            internal: "internal";
-            invalid_cursor: "invalid_cursor";
-            invalid_request: "invalid_request";
-            mcp_connection_authentication_failed: "mcp_connection_authentication_failed";
-            mcp_connection_discovery_failed: "mcp_connection_discovery_failed";
-            mcp_connection_in_use: "mcp_connection_in_use";
-            mcp_connection_invalid: "mcp_connection_invalid";
-            mcp_connection_limit_reached: "mcp_connection_limit_reached";
-            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_in_use: "merchant_connection_in_use";
-            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_id_conflict: "message_id_conflict";
-            message_not_found: "message_not_found";
-            model_discovery_unsupported: "model_discovery_unsupported";
-            model_not_found: "model_not_found";
-            model_spending_limit_exceeded: "model_spending_limit_exceeded";
-            model_validation_unavailable: "model_validation_unavailable";
-            not_found: "not_found";
-            prompt_variable_missing: "prompt_variable_missing";
-            prompt_variable_unknown: "prompt_variable_unknown";
-            provider_historical_use: "provider_historical_use";
-            provider_in_use: "provider_in_use";
-            provider_limit_reached: "provider_limit_reached";
-            provider_name_conflict: "provider_name_conflict";
-            provider_not_found: "provider_not_found";
-            provider_required: "provider_required";
-            quota_exceeded: "quota_exceeded";
-            rate_limited: "rate_limited";
-            service_unavailable: "service_unavailable";
-            session_busy: "session_busy";
-            session_fork_deleted: "session_fork_deleted";
-            session_fork_unavailable: "session_fork_unavailable";
-            session_turn_unresponsive: "session_turn_unresponsive";
-            session_version_mismatch: "session_version_mismatch";
-            skill_invalid_archive: "skill_invalid_archive";
-            skill_invalid_markdown: "skill_invalid_markdown";
-            skill_limit_reached: "skill_limit_reached";
-            skill_name_conflict: "skill_name_conflict";
-            skill_not_found: "skill_not_found";
-            skill_too_many_files: "skill_too_many_files";
-            skill_uncompressed_too_large: "skill_uncompressed_too_large";
-            steer_not_available: "steer_not_available";
-            subscription_already_paid: "subscription_already_paid";
-            subscription_not_cancelled: "subscription_not_cancelled";
-            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_settled: "tool_approval_continuation_settled";
-            tool_approval_decision_conflict: "tool_approval_decision_conflict";
-            unauthorized: "unauthorized";
-            usage_credit_required: "usage_credit_required";
-            validation_failed: "validation_failed";
-            workspace_busy: "workspace_busy";
-            workspace_in_use: "workspace_in_use";
-            workspace_not_found: "workspace_not_found";
-        }>>;
+        errorCode: z.ZodNullable<z.ZodType<import("../../types.ts").BlazingAgentsErrorCode, unknown, z.core.$ZodTypeInternals<import("../../types.ts").BlazingAgentsErrorCode, unknown>>>;
         userId: z.ZodString;
         metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         startedAt: z.ZodNullable<z.ZodISODateTime>;
@@ -745,6 +571,16 @@ export declare const createTaskRunResponseSchema: z.ZodObject<{
  * `error`, and `finishedAt`, so one poll loop can follow the run.
  */
 export declare const taskRunMessagesResponseSchema: z.ZodObject<{
+    error: z.ZodNullable<z.ZodString>;
+    finishedAt: z.ZodNullable<z.ZodISODateTime>;
+    status: z.ZodEnum<{
+        blocked: "blocked";
+        canceled: "canceled";
+        failed: "failed";
+        queued: "queued";
+        running: "running";
+        succeeded: "succeeded";
+    }>;
     data: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         role: z.ZodEnum<{
@@ -760,16 +596,6 @@ export declare const taskRunMessagesResponseSchema: z.ZodObject<{
     }, z.core.$loose>>;
     nextCursor: z.ZodNullable<z.ZodString>;
     latestCursor: z.ZodNullable<z.ZodString>;
-    error: z.ZodNullable<z.ZodString>;
-    finishedAt: z.ZodNullable<z.ZodISODateTime>;
-    status: z.ZodEnum<{
-        blocked: "blocked";
-        canceled: "canceled";
-        failed: "failed";
-        queued: "queued";
-        running: "running";
-        succeeded: "succeeded";
-    }>;
 }, z.core.$strip>;
 export type TaskListItem = z.infer<typeof taskListItemSchema>;
 export type TaskRunStatus = z.infer<typeof taskRunStatusSchema>;

package/dist/contracts/entities/tasks.js

@@ -1,6 +1,6 @@
 import { Cron } from "croner";
 import { z } from "zod";
-import { apiErrorCodeSchema, paginatedResponseSchema } from "../api.js";
+import { paginatedResponseSchema, receivedApiErrorCodeSchema } from "../api.js";
 import { agentIdSchema, sessionIdSchema, taskIdSchema, taskRunIdSchema, tenantIdSchema, turnIdSchema, } from "../ids.js";
 import { MAX_TASK_NAME_LENGTH, MAX_TASK_PROMPT_LENGTH, MIN_TASK_INTERVAL_MS, } from "../limitations.js";
 import { atLeastOneFieldMessage, hasObjectKeys } from "../utils.js";
@@ -242,7 +242,7 @@ export const taskRunResponseSchema = z
     turnId: turnIdSchema.nullable(),
     status: taskRunStatusSchema,
     error: z.string().nullable(),
-    errorCode: apiErrorCodeSchema
+    errorCode: receivedApiErrorCodeSchema
         .nullable()
         .describe("Machine-readable reason a run ended `blocked` or `failed`: one of the API error codes, such as `usage_credit_required`, `quota_exceeded` or `provider_required`. `null` for every other run, and for a failure without a code; `error` carries the message."),
     userId: userIdSchema,

package/package.json

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