@blazingagents/sdk 0.54.1 → 0.55.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,2 @@
1
+ /** Every `error.code` the API contract lists. */
2
+ export declare const apiErrorCodes: readonly ["invalid_request", "idempotency_conflict", "input_idempotency_conflict", "steer_not_available", "validation_failed", "unauthorized", "not_found", "model_spending_limit_exceeded", "subscription_required", "usage_credit_required", "rate_limited", "internal", "service_unavailable", "subscription_already_paid", "subscription_not_cancelled", "agent_disabled", "agent_busy", "agent_deleting", "admin_agent_managed", "agent_mcp_connection_not_found", "agent_mcp_connections_invalid", "provider_required", "api_key_limit_reached", "artifact_session_cap_reached", "invalid_cursor", "message_not_found", "prompt_variable_missing", "prompt_variable_unknown", "provider_in_use", "provider_historical_use", "provider_limit_reached", "provider_name_conflict", "provider_not_found", "model_discovery_unsupported", "model_not_found", "model_validation_unavailable", "mcp_connection_limit_reached", "mcp_connection_name_conflict", "mcp_connection_stale_credential_version", "mcp_connection_invalid", "mcp_connection_authentication_failed", "mcp_connection_in_use", "mcp_connection_unreachable", "mcp_connection_discovery_failed", "mcp_connection_needs_auth", "workspace_not_found", "workspace_in_use", "workspace_busy", "session_busy", "session_turn_unresponsive", "session_fork_unavailable", "session_fork_deleted", "message_id_conflict", "session_version_mismatch", "tool_approval_continuation_settled", "tool_approval_decision_conflict", "tool_approval_outdated", "function_call_conflict", "skill_invalid_archive", "skill_invalid_markdown", "skill_limit_reached", "skill_name_conflict", "skill_not_found", "skill_too_many_files", "skill_uncompressed_too_large", "task_active_run_exists", "chat_webhook_conflict", "chat_webhook_registration_failed", "merchant_connection_not_found", "merchant_connection_in_use", "merchant_credential_invalid", "merchant_provider_unavailable", "merchant_customer_not_found", "merchant_binding_not_found", "merchant_account_mismatch", "merchant_event_not_found", "merchant_event_state_conflict", "merchant_customer_unmapped", "forbidden", "insufficient_scope", "merchant_subscription_required", "merchant_balance_required", "merchant_eligibility_unavailable", "tenant_deleting", "tenant_deletion_in_progress", "tenant_deletion_not_ready", "tenant_not_deleting"];
@@ -0,0 +1,91 @@
1
+ // Generated by `npm run generate` from spec/openapi.json. Do not edit by hand.
2
+ /** Every `error.code` the API contract lists. */
3
+ export const apiErrorCodes = [
4
+ "invalid_request",
5
+ "idempotency_conflict",
6
+ "input_idempotency_conflict",
7
+ "steer_not_available",
8
+ "validation_failed",
9
+ "unauthorized",
10
+ "not_found",
11
+ "model_spending_limit_exceeded",
12
+ "subscription_required",
13
+ "usage_credit_required",
14
+ "rate_limited",
15
+ "internal",
16
+ "service_unavailable",
17
+ "subscription_already_paid",
18
+ "subscription_not_cancelled",
19
+ "agent_disabled",
20
+ "agent_busy",
21
+ "agent_deleting",
22
+ "admin_agent_managed",
23
+ "agent_mcp_connection_not_found",
24
+ "agent_mcp_connections_invalid",
25
+ "provider_required",
26
+ "api_key_limit_reached",
27
+ "artifact_session_cap_reached",
28
+ "invalid_cursor",
29
+ "message_not_found",
30
+ "prompt_variable_missing",
31
+ "prompt_variable_unknown",
32
+ "provider_in_use",
33
+ "provider_historical_use",
34
+ "provider_limit_reached",
35
+ "provider_name_conflict",
36
+ "provider_not_found",
37
+ "model_discovery_unsupported",
38
+ "model_not_found",
39
+ "model_validation_unavailable",
40
+ "mcp_connection_limit_reached",
41
+ "mcp_connection_name_conflict",
42
+ "mcp_connection_stale_credential_version",
43
+ "mcp_connection_invalid",
44
+ "mcp_connection_authentication_failed",
45
+ "mcp_connection_in_use",
46
+ "mcp_connection_unreachable",
47
+ "mcp_connection_discovery_failed",
48
+ "mcp_connection_needs_auth",
49
+ "workspace_not_found",
50
+ "workspace_in_use",
51
+ "workspace_busy",
52
+ "session_busy",
53
+ "session_turn_unresponsive",
54
+ "session_fork_unavailable",
55
+ "session_fork_deleted",
56
+ "message_id_conflict",
57
+ "session_version_mismatch",
58
+ "tool_approval_continuation_settled",
59
+ "tool_approval_decision_conflict",
60
+ "tool_approval_outdated",
61
+ "function_call_conflict",
62
+ "skill_invalid_archive",
63
+ "skill_invalid_markdown",
64
+ "skill_limit_reached",
65
+ "skill_name_conflict",
66
+ "skill_not_found",
67
+ "skill_too_many_files",
68
+ "skill_uncompressed_too_large",
69
+ "task_active_run_exists",
70
+ "chat_webhook_conflict",
71
+ "chat_webhook_registration_failed",
72
+ "merchant_connection_not_found",
73
+ "merchant_connection_in_use",
74
+ "merchant_credential_invalid",
75
+ "merchant_provider_unavailable",
76
+ "merchant_customer_not_found",
77
+ "merchant_binding_not_found",
78
+ "merchant_account_mismatch",
79
+ "merchant_event_not_found",
80
+ "merchant_event_state_conflict",
81
+ "merchant_customer_unmapped",
82
+ "forbidden",
83
+ "insufficient_scope",
84
+ "merchant_subscription_required",
85
+ "merchant_balance_required",
86
+ "merchant_eligibility_unavailable",
87
+ "tenant_deleting",
88
+ "tenant_deletion_in_progress",
89
+ "tenant_deletion_not_ready",
90
+ "tenant_not_deleting",
91
+ ];
@@ -87,6 +87,7 @@ export declare const apiErrorCodeSchema: z.ZodEnum<{
87
87
  tenant_not_deleting: "tenant_not_deleting";
88
88
  tool_approval_continuation_settled: "tool_approval_continuation_settled";
89
89
  tool_approval_decision_conflict: "tool_approval_decision_conflict";
90
+ tool_approval_outdated: "tool_approval_outdated";
90
91
  unauthorized: "unauthorized";
91
92
  usage_credit_required: "usage_credit_required";
92
93
  validation_failed: "validation_failed";
@@ -1,98 +1,12 @@
1
1
  import { z } from "zod";
2
+ import { apiErrorCodes } from "./api-error-codes.js";
2
3
  /**
3
4
  * `/v1` error envelope — see docs/adr/0003-ai-sdk-native-wire-protocol.md.
4
5
  * Closed producer code set; `code` is what SDKs switch on and `message` is
5
6
  * human-only. Resource-specific codes preserve stable product outcomes that
6
7
  * callers need to distinguish.
7
8
  */
8
- export const apiErrorCodeSchema = z.enum([
9
- "invalid_request",
10
- "idempotency_conflict",
11
- "session_fork_deleted",
12
- "session_fork_unavailable",
13
- "input_idempotency_conflict",
14
- "steer_not_available",
15
- "validation_failed",
16
- "unauthorized",
17
- "forbidden",
18
- "insufficient_scope",
19
- "not_found",
20
- "model_spending_limit_exceeded",
21
- "subscription_required",
22
- "usage_credit_required",
23
- "rate_limited",
24
- "internal",
25
- "service_unavailable",
26
- "subscription_already_paid",
27
- "subscription_not_cancelled",
28
- "agent_disabled",
29
- "agent_busy",
30
- "agent_deleting",
31
- "admin_agent_managed",
32
- "agent_mcp_connection_not_found",
33
- "agent_mcp_connections_invalid",
34
- "provider_required",
35
- "api_key_limit_reached",
36
- "artifact_session_cap_reached",
37
- "invalid_cursor",
38
- "message_not_found",
39
- "message_id_conflict",
40
- "prompt_variable_missing",
41
- "prompt_variable_unknown",
42
- "provider_in_use",
43
- "provider_historical_use",
44
- "provider_limit_reached",
45
- "provider_name_conflict",
46
- "provider_not_found",
47
- "model_discovery_unsupported",
48
- "model_not_found",
49
- "model_validation_unavailable",
50
- "mcp_connection_limit_reached",
51
- "mcp_connection_name_conflict",
52
- "mcp_connection_stale_credential_version",
53
- "mcp_connection_invalid",
54
- "mcp_connection_authentication_failed",
55
- "mcp_connection_in_use",
56
- "mcp_connection_unreachable",
57
- "mcp_connection_discovery_failed",
58
- "mcp_connection_needs_auth",
59
- "workspace_not_found",
60
- "workspace_in_use",
61
- "workspace_busy",
62
- "session_busy",
63
- "session_turn_unresponsive",
64
- "session_version_mismatch",
65
- "tool_approval_continuation_settled",
66
- "tool_approval_decision_conflict",
67
- "function_call_conflict",
68
- "skill_invalid_archive",
69
- "skill_invalid_markdown",
70
- "skill_limit_reached",
71
- "skill_name_conflict",
72
- "skill_not_found",
73
- "skill_too_many_files",
74
- "skill_uncompressed_too_large",
75
- "task_active_run_exists",
76
- "chat_webhook_conflict",
77
- "chat_webhook_registration_failed",
78
- "merchant_connection_not_found",
79
- "merchant_connection_in_use",
80
- "merchant_credential_invalid",
81
- "merchant_provider_unavailable",
82
- "merchant_customer_not_found",
83
- "merchant_binding_not_found",
84
- "merchant_account_mismatch",
85
- "merchant_event_not_found",
86
- "merchant_event_state_conflict",
87
- "merchant_customer_unmapped",
88
- "merchant_subscription_required",
89
- "merchant_balance_required",
90
- "merchant_eligibility_unavailable",
91
- "tenant_deleting",
92
- "tenant_deletion_in_progress",
93
- "tenant_deletion_not_ready",
94
- "tenant_not_deleting",
95
- ]);
9
+ export const apiErrorCodeSchema = z.enum(apiErrorCodes);
96
10
  /**
97
11
  * A code as received: any non-empty string, so a server newer than this SDK
98
12
  * can send a code the SDK does not list. The type keeps autocomplete for the
@@ -2,7 +2,6 @@ import { z } from "zod";
2
2
  import { mcpConnectionIdSchema } from "../ids.js";
3
3
  import { MAX_MCP_ATTACHMENT_METADATA_KEY_LENGTH, MAX_MCP_ATTACHMENT_METADATA_KEYS, MAX_MCP_BEARER_TOKEN_LENGTH, MAX_MCP_CONNECTION_NAME_LENGTH, MAX_MCP_CONNECTION_TEST_LATENCY_MS, MAX_MCP_CONNECTION_URL_LENGTH, MAX_MCP_OAUTH_CLIENT_ID_LENGTH, MAX_MCP_OAUTH_CLIENT_SECRET_LENGTH, MAX_MCP_OAUTH_SCOPE_LENGTH, MAX_MCP_SERVER_NAME_LENGTH, MAX_MCP_SERVER_VERSION_LENGTH, MAX_MCP_TOOL_NAME_LENGTH, MAX_MCP_TOOLS_PER_CONNECTION, } from "../limitations.js";
4
4
  import { atLeastOneFieldMessage, hasObjectKeys, hasUniqueValues, } from "../utils.js";
5
- const OPAQUE_MCP_OAUTH_TOKEN_PATTERN = /^[A-Za-z0-9_-]{43}$/;
6
5
  export const mcpConnectionAuthTypeSchema = z.enum([
7
6
  "none",
8
7
  "bearer",
@@ -216,12 +215,10 @@ export const mcpOauthAuthorizationLaunchResponseSchema = z
216
215
  .url()
217
216
  .refine((value) => {
218
217
  const url = new URL(value);
219
- return (url.pathname === "/v1/mcp/oauth/authorize" &&
218
+ return ((url.protocol === "https:" || url.protocol === "http:") &&
220
219
  url.username === "" &&
221
220
  url.password === "" &&
222
- url.hash === "" &&
223
- url.searchParams.size === 1 &&
224
- OPAQUE_MCP_OAUTH_TOKEN_PATTERN.test(url.searchParams.get("setup") ?? ""));
221
+ url.hash === "");
225
222
  }),
226
223
  })
227
224
  .strip();
@@ -367,7 +367,8 @@ export declare const merchantUsageSummaryResponseSchema: z.ZodObject<{
367
367
  export type MerchantUsageSummaryResponse = z.infer<typeof merchantUsageSummaryResponseSchema>;
368
368
  /**
369
369
  * The action a Tenant takes on an event. `automaticDeliveryStopped` is true
370
- * when automatic delivery has given up on a `pending` event.
370
+ * when the delivery of a `pending` event stopped. Blazing Agents retries it on
371
+ * its own four times; after that the event waits for the Tenant's retry.
371
372
  */
372
373
  export declare function merchantUsageEventNextAction(event: {
373
374
  automaticDeliveryStopped: boolean;
@@ -190,7 +190,8 @@ export const merchantUsageSummaryResponseSchema = z
190
190
  .strip();
191
191
  /**
192
192
  * The action a Tenant takes on an event. `automaticDeliveryStopped` is true
193
- * when automatic delivery has given up on a `pending` event.
193
+ * when the delivery of a `pending` event stopped. Blazing Agents retries it on
194
+ * its own four times; after that the event waits for the Tenant's retry.
194
195
  */
195
196
  export function merchantUsageEventNextAction(event) {
196
197
  switch (event.status) {
@@ -356,7 +356,7 @@ export declare const turnStreamErrorEventSchema: z.ZodObject<{
356
356
  type: z.ZodLiteral<"data-ba-error">;
357
357
  transient: z.ZodLiteral<true>;
358
358
  data: z.ZodObject<{
359
- code: z.ZodCustom<"admin_agent_managed" | "agent_busy" | "agent_deleting" | "agent_disabled" | "agent_mcp_connection_not_found" | "agent_mcp_connections_invalid" | "api_key_limit_reached" | "artifact_session_cap_reached" | "chat_webhook_conflict" | "chat_webhook_registration_failed" | "forbidden" | "function_call_conflict" | "idempotency_conflict" | "input_idempotency_conflict" | "insufficient_scope" | "internal" | "invalid_cursor" | "invalid_request" | "mcp_connection_authentication_failed" | "mcp_connection_discovery_failed" | "mcp_connection_in_use" | "mcp_connection_invalid" | "mcp_connection_limit_reached" | "mcp_connection_name_conflict" | "mcp_connection_needs_auth" | "mcp_connection_stale_credential_version" | "mcp_connection_unreachable" | "merchant_account_mismatch" | "merchant_balance_required" | "merchant_binding_not_found" | "merchant_connection_in_use" | "merchant_connection_not_found" | "merchant_credential_invalid" | "merchant_customer_not_found" | "merchant_customer_unmapped" | "merchant_eligibility_unavailable" | "merchant_event_not_found" | "merchant_event_state_conflict" | "merchant_provider_unavailable" | "merchant_subscription_required" | "message_id_conflict" | "message_not_found" | "model_discovery_unsupported" | "model_not_found" | "model_spending_limit_exceeded" | "model_validation_unavailable" | "not_found" | "prompt_variable_missing" | "prompt_variable_unknown" | "provider_historical_use" | "provider_in_use" | "provider_limit_reached" | "provider_name_conflict" | "provider_not_found" | "provider_required" | "rate_limited" | "service_unavailable" | "session_busy" | "session_fork_deleted" | "session_fork_unavailable" | "session_turn_unresponsive" | "session_version_mismatch" | "skill_invalid_archive" | "skill_invalid_markdown" | "skill_limit_reached" | "skill_name_conflict" | "skill_not_found" | "skill_too_many_files" | "skill_uncompressed_too_large" | "steer_not_available" | "subscription_already_paid" | "subscription_not_cancelled" | "subscription_required" | "task_active_run_exists" | "tenant_deleting" | "tenant_deletion_in_progress" | "tenant_deletion_not_ready" | "tenant_not_deleting" | "tool_approval_continuation_settled" | "tool_approval_decision_conflict" | "turn_interrupted" | "unauthorized" | "usage_credit_required" | "validation_failed" | "workspace_busy" | "workspace_in_use" | "workspace_not_found" | (string & {}), "admin_agent_managed" | "agent_busy" | "agent_deleting" | "agent_disabled" | "agent_mcp_connection_not_found" | "agent_mcp_connections_invalid" | "api_key_limit_reached" | "artifact_session_cap_reached" | "chat_webhook_conflict" | "chat_webhook_registration_failed" | "forbidden" | "function_call_conflict" | "idempotency_conflict" | "input_idempotency_conflict" | "insufficient_scope" | "internal" | "invalid_cursor" | "invalid_request" | "mcp_connection_authentication_failed" | "mcp_connection_discovery_failed" | "mcp_connection_in_use" | "mcp_connection_invalid" | "mcp_connection_limit_reached" | "mcp_connection_name_conflict" | "mcp_connection_needs_auth" | "mcp_connection_stale_credential_version" | "mcp_connection_unreachable" | "merchant_account_mismatch" | "merchant_balance_required" | "merchant_binding_not_found" | "merchant_connection_in_use" | "merchant_connection_not_found" | "merchant_credential_invalid" | "merchant_customer_not_found" | "merchant_customer_unmapped" | "merchant_eligibility_unavailable" | "merchant_event_not_found" | "merchant_event_state_conflict" | "merchant_provider_unavailable" | "merchant_subscription_required" | "message_id_conflict" | "message_not_found" | "model_discovery_unsupported" | "model_not_found" | "model_spending_limit_exceeded" | "model_validation_unavailable" | "not_found" | "prompt_variable_missing" | "prompt_variable_unknown" | "provider_historical_use" | "provider_in_use" | "provider_limit_reached" | "provider_name_conflict" | "provider_not_found" | "provider_required" | "rate_limited" | "service_unavailable" | "session_busy" | "session_fork_deleted" | "session_fork_unavailable" | "session_turn_unresponsive" | "session_version_mismatch" | "skill_invalid_archive" | "skill_invalid_markdown" | "skill_limit_reached" | "skill_name_conflict" | "skill_not_found" | "skill_too_many_files" | "skill_uncompressed_too_large" | "steer_not_available" | "subscription_already_paid" | "subscription_not_cancelled" | "subscription_required" | "task_active_run_exists" | "tenant_deleting" | "tenant_deletion_in_progress" | "tenant_deletion_not_ready" | "tenant_not_deleting" | "tool_approval_continuation_settled" | "tool_approval_decision_conflict" | "turn_interrupted" | "unauthorized" | "usage_credit_required" | "validation_failed" | "workspace_busy" | "workspace_in_use" | "workspace_not_found" | (string & {})>;
359
+ code: z.ZodCustom<"admin_agent_managed" | "agent_busy" | "agent_deleting" | "agent_disabled" | "agent_mcp_connection_not_found" | "agent_mcp_connections_invalid" | "api_key_limit_reached" | "artifact_session_cap_reached" | "chat_webhook_conflict" | "chat_webhook_registration_failed" | "forbidden" | "function_call_conflict" | "idempotency_conflict" | "input_idempotency_conflict" | "insufficient_scope" | "internal" | "invalid_cursor" | "invalid_request" | "mcp_connection_authentication_failed" | "mcp_connection_discovery_failed" | "mcp_connection_in_use" | "mcp_connection_invalid" | "mcp_connection_limit_reached" | "mcp_connection_name_conflict" | "mcp_connection_needs_auth" | "mcp_connection_stale_credential_version" | "mcp_connection_unreachable" | "merchant_account_mismatch" | "merchant_balance_required" | "merchant_binding_not_found" | "merchant_connection_in_use" | "merchant_connection_not_found" | "merchant_credential_invalid" | "merchant_customer_not_found" | "merchant_customer_unmapped" | "merchant_eligibility_unavailable" | "merchant_event_not_found" | "merchant_event_state_conflict" | "merchant_provider_unavailable" | "merchant_subscription_required" | "message_id_conflict" | "message_not_found" | "model_discovery_unsupported" | "model_not_found" | "model_spending_limit_exceeded" | "model_validation_unavailable" | "not_found" | "prompt_variable_missing" | "prompt_variable_unknown" | "provider_historical_use" | "provider_in_use" | "provider_limit_reached" | "provider_name_conflict" | "provider_not_found" | "provider_required" | "rate_limited" | "service_unavailable" | "session_busy" | "session_fork_deleted" | "session_fork_unavailable" | "session_turn_unresponsive" | "session_version_mismatch" | "skill_invalid_archive" | "skill_invalid_markdown" | "skill_limit_reached" | "skill_name_conflict" | "skill_not_found" | "skill_too_many_files" | "skill_uncompressed_too_large" | "steer_not_available" | "subscription_already_paid" | "subscription_not_cancelled" | "subscription_required" | "task_active_run_exists" | "tenant_deleting" | "tenant_deletion_in_progress" | "tenant_deletion_not_ready" | "tenant_not_deleting" | "tool_approval_continuation_settled" | "tool_approval_decision_conflict" | "tool_approval_outdated" | "turn_interrupted" | "unauthorized" | "usage_credit_required" | "validation_failed" | "workspace_busy" | "workspace_in_use" | "workspace_not_found" | (string & {}), "admin_agent_managed" | "agent_busy" | "agent_deleting" | "agent_disabled" | "agent_mcp_connection_not_found" | "agent_mcp_connections_invalid" | "api_key_limit_reached" | "artifact_session_cap_reached" | "chat_webhook_conflict" | "chat_webhook_registration_failed" | "forbidden" | "function_call_conflict" | "idempotency_conflict" | "input_idempotency_conflict" | "insufficient_scope" | "internal" | "invalid_cursor" | "invalid_request" | "mcp_connection_authentication_failed" | "mcp_connection_discovery_failed" | "mcp_connection_in_use" | "mcp_connection_invalid" | "mcp_connection_limit_reached" | "mcp_connection_name_conflict" | "mcp_connection_needs_auth" | "mcp_connection_stale_credential_version" | "mcp_connection_unreachable" | "merchant_account_mismatch" | "merchant_balance_required" | "merchant_binding_not_found" | "merchant_connection_in_use" | "merchant_connection_not_found" | "merchant_credential_invalid" | "merchant_customer_not_found" | "merchant_customer_unmapped" | "merchant_eligibility_unavailable" | "merchant_event_not_found" | "merchant_event_state_conflict" | "merchant_provider_unavailable" | "merchant_subscription_required" | "message_id_conflict" | "message_not_found" | "model_discovery_unsupported" | "model_not_found" | "model_spending_limit_exceeded" | "model_validation_unavailable" | "not_found" | "prompt_variable_missing" | "prompt_variable_unknown" | "provider_historical_use" | "provider_in_use" | "provider_limit_reached" | "provider_name_conflict" | "provider_not_found" | "provider_required" | "rate_limited" | "service_unavailable" | "session_busy" | "session_fork_deleted" | "session_fork_unavailable" | "session_turn_unresponsive" | "session_version_mismatch" | "skill_invalid_archive" | "skill_invalid_markdown" | "skill_limit_reached" | "skill_name_conflict" | "skill_not_found" | "skill_too_many_files" | "skill_uncompressed_too_large" | "steer_not_available" | "subscription_already_paid" | "subscription_not_cancelled" | "subscription_required" | "task_active_run_exists" | "tenant_deleting" | "tenant_deletion_in_progress" | "tenant_deletion_not_ready" | "tenant_not_deleting" | "tool_approval_continuation_settled" | "tool_approval_decision_conflict" | "tool_approval_outdated" | "turn_interrupted" | "unauthorized" | "usage_credit_required" | "validation_failed" | "workspace_busy" | "workspace_in_use" | "workspace_not_found" | (string & {})>;
360
360
  details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
361
361
  message: z.ZodString;
362
362
  }, z.core.$strict>;
@@ -37,7 +37,7 @@ export interface MerchantUsageEventsResource {
37
37
  */
38
38
  list(input?: MerchantUsageEventsListOptions): Promise<MerchantUsageEventsResponse>;
39
39
  /**
40
- * Sends a `failed` event, or a `pending` event whose automatic delivery gave up, to the provider again. Retrying is safe: the provider drops duplicates by the event ID.
40
+ * Sends a `failed` event, or a `pending` event whose delivery stopped, to the provider again. Blazing Agents retries a stopped delivery on its own after 5, 10, 20 and 40 minutes; after the fourth automatic retry the event stays `pending` until you retry it. Retrying is safe: the provider drops duplicates by the event ID.
41
41
  * @param input - `eventId`; optional abortSignal.
42
42
  * @returns The merchant usage event response.
43
43
  * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
@@ -2,24 +2,27 @@ import { type CreateSkillBody, type SkillArchiveType, type SkillCopyResults, typ
2
2
  import type { HttpConfig, ResourceRequestOptions } from "../types.ts";
3
3
  export interface AgentSkillsResource {
4
4
  /**
5
- * Copies the Skill to the selected Agents.
6
- * @param input - Source `skillId`, destination `to.agentIds`, and optional abortSignal.
5
+ * Copies the Skill to the selected Agents. Retry a lost answer with the same `idempotencyKey` and each destination returns the copy it already has.
6
+ * @param input - Source `skillId`, destination `to.agentIds`, optional `idempotencyKey` (1 to 200 characters, one Agent's key), and optional abortSignal.
7
7
  * @returns The skill copy results.
8
8
  * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
9
9
  */
10
10
  copy(input: {
11
+ idempotencyKey?: string;
11
12
  skillId: string;
12
13
  to: {
13
14
  agentIds: string[];
14
15
  };
15
16
  } & ResourceRequestOptions): Promise<SkillCopyResults>;
16
17
  /**
17
- * Creates the Skill.
18
- * @param input - creation fields; optional abortSignal.
18
+ * Creates the Skill. Retry a lost answer with the same `idempotencyKey` and the request returns the Skill the first one created.
19
+ * @param input - creation fields; optional `idempotencyKey` (1 to 200 characters, one Agent's key) and abortSignal.
19
20
  * @returns The skill detail.
20
21
  * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
21
22
  */
22
- create(input: CreateSkillBody & ResourceRequestOptions): Promise<SkillDetail>;
23
+ create(input: CreateSkillBody & {
24
+ idempotencyKey?: string;
25
+ } & ResourceRequestOptions): Promise<SkillDetail>;
23
26
  /**
24
27
  * Deletes the Skill.
25
28
  * @param input - `skillId`; optional abortSignal.
@@ -77,12 +80,13 @@ export interface AgentSkillsResource {
77
80
  skillId: string;
78
81
  } & ResourceRequestOptions): Promise<SkillDetail>;
79
82
  /**
80
- * Uploads a Skill archive as multipart form data.
81
- * @param input - Archive bytes in `source.file`, archive format in `source.type`, and optional abortSignal.
83
+ * Uploads a Skill archive as multipart form data. Retry a lost answer with the same `idempotencyKey` and the request returns the Skill the first one created.
84
+ * @param input - Archive bytes in `source.file`, archive format in `source.type`, optional `idempotencyKey` (1 to 200 characters, one Agent's key), and optional abortSignal.
82
85
  * @returns The skill detail.
83
86
  * @throws BlazingAgentsError - If the request fails, is aborted, or returns an invalid response.
84
87
  */
85
88
  upload(input: {
89
+ idempotencyKey?: string;
86
90
  source: {
87
91
  file: Blob | Uint8Array;
88
92
  type: SkillArchiveType;
@@ -1,5 +1,13 @@
1
1
  import { skillCopyResultsSchema, skillDetailSchema, skillsListResponseSchema, } from "../contracts/entities/skills.js";
2
2
  import { apiPath, isRequestAborted, requestAbortedError, requestJson, requestStream, } from "../http.js";
3
+ /**
4
+ * Builds the `Idempotency-Key` header, or none when the caller set no key.
5
+ */
6
+ function idempotencyHeaders(idempotencyKey) {
7
+ return idempotencyKey === undefined
8
+ ? undefined
9
+ : { "Idempotency-Key": idempotencyKey };
10
+ }
3
11
  /**
4
12
  * Builds a Skill file URL with encoded Agent, Skill, and file path values.
5
13
  */
@@ -13,11 +21,21 @@ function fileUrl(agentId, input) {
13
21
  */
14
22
  export function createAgentSkillsResource(config, agentId) {
15
23
  return {
16
- async copy({ skillId, to, abortSignal }) {
17
- return await requestJson(config, apiPath `/v1/agents/${agentId}/skills/${skillId}/copies`, { json: to, method: "POST", signal: abortSignal }, skillCopyResultsSchema);
24
+ async copy({ skillId, to, idempotencyKey, abortSignal }) {
25
+ return await requestJson(config, apiPath `/v1/agents/${agentId}/skills/${skillId}/copies`, {
26
+ headers: idempotencyHeaders(idempotencyKey),
27
+ json: to,
28
+ method: "POST",
29
+ signal: abortSignal,
30
+ }, skillCopyResultsSchema);
18
31
  },
19
- async create({ abortSignal, ...body }) {
20
- return await requestJson(config, apiPath `/v1/agents/${agentId}/skills`, { json: body, method: "POST", signal: abortSignal }, skillDetailSchema);
32
+ async create({ idempotencyKey, abortSignal, ...body }) {
33
+ return await requestJson(config, apiPath `/v1/agents/${agentId}/skills`, {
34
+ headers: idempotencyHeaders(idempotencyKey),
35
+ json: body,
36
+ method: "POST",
37
+ signal: abortSignal,
38
+ }, skillDetailSchema);
21
39
  },
22
40
  async delete({ skillId, abortSignal }) {
23
41
  await requestJson(config, apiPath `/v1/agents/${agentId}/skills/${skillId}`, { method: "DELETE", signal: abortSignal });
@@ -56,14 +74,19 @@ export function createAgentSkillsResource(config, agentId) {
56
74
  signal: abortSignal,
57
75
  }, skillDetailSchema);
58
76
  },
59
- async upload({ source, abortSignal }) {
77
+ async upload({ source, idempotencyKey, abortSignal }) {
60
78
  const form = new FormData();
61
79
  form.set("type", source.type);
62
80
  const file = source.file instanceof Blob
63
81
  ? source.file
64
82
  : new Blob([source.file]);
65
83
  form.set("file", file, `skill.${source.type}`);
66
- return await requestJson(config, apiPath `/v1/agents/${agentId}/skills/upload`, { body: form, method: "POST", signal: abortSignal }, skillDetailSchema);
84
+ return await requestJson(config, apiPath `/v1/agents/${agentId}/skills/upload`, {
85
+ body: form,
86
+ headers: idempotencyHeaders(idempotencyKey),
87
+ method: "POST",
88
+ signal: abortSignal,
89
+ }, skillDetailSchema);
67
90
  },
68
91
  };
69
92
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@blazingagents/sdk",
3
- "version": "0.54.1",
3
+ "version": "0.55.1",
4
4
  "description": "TypeScript SDK for the Blazing Agents API",
5
5
  "homepage": "https://docs.blazingagents.com",
6
6
  "bugs": {
@@ -39,8 +39,9 @@
39
39
  "scripts": {
40
40
  "build": "rm -rf dist && tsc -p tsconfig.build.json",
41
41
  "bundle-size": "node scripts/check-bundle-size.ts",
42
- "check": "npm run typecheck && npm run test && npm run bundle-size && npm run lint && npm run unused",
42
+ "check": "npm run generate -- --check && npm run typecheck && npm run test && npm run bundle-size && npm run lint && npm run unused",
43
43
  "fix": "ultracite fix",
44
+ "generate": "node scripts/generate-error-codes.ts",
44
45
  "lint": "ultracite check",
45
46
  "prepack": "npm run build",
46
47
  "test": "node scripts/check-test-imports.ts && vitest run --coverage",