codai-sdk 0.7.0 → 0.8.0

package/README.md

@@ -65,7 +65,7 @@ surface.
 | `receipt`          | `get`                                                                                                                                                                                                | `GET /v1/receipt`                                        |
 | `feedback`         | `submit`                                                                                                                                                                                             | `POST /v1/feedback`                                      |
 | `phoneModels`      | `list`                                                                                                                                                                                               | `GET /v1/phone/models`                                   |
-| `resolve`          | `submit`, `get`, `accept`, `attestation`, `health`, `waitFor`                                                                                                                                        | `https://resolve.codai.ro/v1/resolve/*` (own host)       |
+| `resolve`          | `submit`, `get`, `accept`, `balance`, `attestation`, `keys`, `verifyAttestation`, `health`, `waitFor`                                                                                                | `https://resolve.codai.ro/v1/resolve/*` (own host)       |
 
 Every method takes an optional last argument `{ ext, signal }` where `ext` is a
 typed bag of `X-Codai-*` extension headers (see below).
@@ -180,7 +180,8 @@ if (q.status === 'quoted') {
   try {
     await codai.resolve.accept(q.id); // free-tier jobs are auto-accepted
   } catch (err) {
-    if (err instanceof ResolveInsufficientFundsError) console.log('top up:', err.topupUrl);
+    if (err instanceof ResolveInsufficientFundsError)
+      console.log('top up:', err.topupUrl, err.bundleUrl ?? ''); // bundleUrl: t7 only
     throw err;
   }
 }
@@ -198,6 +199,15 @@ with `balance`, `required`, `currency: 'micro_eur'` and `topupUrl`. `submit` and
 `accept` are never retried. `waitFor` stops at `resolved | failed | declined | error`
 (or `until`), and throws `ResolveError` with `status: 0` on timeout.
 
+**Pricing.** Your first paid accept holds **€1** instead of the list price (the quote then
+carries `intro_price_micro_eur` / `list_price_micro_eur`); it is used up only by a verified
+fix — a failed intro job is refunded and the intro is offered again. A **fix bundle** (€49 = 10
+credits, <https://pay.codai.ro/checkout?bundle=resolve10>) pays for `t7` jobs only: a credit is
+taken at accept instead of a wallet hold and returned on failure. Precedence:
+free > intro > credit (t7) > wallet; `accept()` reports it in `paid_with`, and a t7 `402`
+carries `bundleUrl`. `codai.resolve.balance()` returns `fix_credits`, `intro_available` and
+`wallet_micro_eur`.
+
 ### Webhooks instead of polling
 
 Pass `callback_url` (https, public host) on `submit`; the response carries

package/dist/index.d.ts

@@ -10940,6 +10940,28 @@ type paths = {
         readonly patch?: never;
         readonly trace?: never;
     };
+    readonly '/v1/resolve/balance': {
+        readonly parameters: {
+            readonly query?: never;
+            readonly header?: never;
+            readonly path?: never;
+            readonly cookie?: never;
+        };
+        /**
+         * Fix credits, intro availability and wallet balance
+         * @description Returns what you can pay with right now: the fix-credit balance (usable only on `t7`
+         *     jobs), whether the €1 intro price is still available (no verified paid job yet and no
+         *     other intro job in flight) and the wallet balance in EUR micros.
+         */
+        readonly get: operations['getResolveBalance'];
+        readonly put?: never;
+        readonly post?: never;
+        readonly delete?: never;
+        readonly options?: never;
+        readonly head?: never;
+        readonly patch?: never;
+        readonly trace?: never;
+    };
     readonly '/v1/resolve/jobs': {
         readonly parameters: {
             readonly query?: never;
@@ -11016,6 +11038,11 @@ type paths = {
          *     price). The hold is kept on a verified fix and refunded in full otherwise. If the
          *     balance is short, the answer is `402 insufficient_funds` with the shortfall and a
          *     top-up link, and the job stays `quoted` — top up, then call `/accept` again.
+         *
+         *     Payment precedence: `intro` (first paid job, €1 hold) > `credit` (t7 only, one fix credit,
+         *     no wallet hold) > `wallet` (hold of the list price). `paid_with` in the response says which
+         *     was used; `held_micro_eur` is the wallet amount held (`0` for a credit). For a `t7` job the
+         *     `402` also carries `bundle_url` (10 fixes for €49).
          */
         readonly post: operations['acceptResolveJob'];
         readonly delete?: never;
@@ -11053,8 +11080,14 @@ type components = {
     schemas: {
         /** Accepted */
         readonly ResolveAccepted: {
+            /**
+             * @description Amount held on the wallet in EUR micros — `1000000` for the intro, the quote for `wallet`, `0` for `credit`.
+             * @example 1000000
+             */
+            readonly held_micro_eur: number;
             /** Format: uuid */
             readonly id: string;
+            readonly paid_with: components['schemas']['ResolvePaidWith'];
             /** @constant */
             readonly status: 'accepted';
         };
@@ -11123,6 +11156,24 @@ type components = {
                 readonly sig: string;
             }[];
         };
+        /**
+         * Balance
+         * @description Body of `GET /v1/resolve/balance`.
+         */
+        readonly ResolveBalance: {
+            /**
+             * @description Fix credits left (usable only on `t7` jobs). Buy 10 for €49 at https://pay.codai.ro/checkout?bundle=resolve10.
+             * @example 10
+             */
+            readonly fix_credits: number;
+            /** @description `true` while your next paid accept would hold the €1 intro price. */
+            readonly intro_available: boolean;
+            /**
+             * @description Wallet balance in EUR micros (`5000000` = €5.00).
+             * @example 5000000
+             */
+            readonly wallet_micro_eur: number;
+        };
         /**
          * Declined
          * @description `200` body — triage declined the issue. The job is persisted with `status: declined` and is never billed.
@@ -11167,6 +11218,12 @@ type components = {
              * @example 5000000
              */
             readonly balance: number;
+            /**
+             * Format: uri
+             * @description Present only for a `t7` job — checkout for the fix bundle (10 t7 fix credits for €49).
+             * @example https://pay.codai.ro/checkout?bundle=resolve10
+             */
+            readonly bundle_url?: string;
             /**
              * @description Unit of `balance` and `required`.
              * @constant
@@ -11247,6 +11304,8 @@ type components = {
             readonly fail_reason: string | null;
             /** Format: uuid */
             readonly id: string;
+            /** @description Present once the job was accepted (and recorded how it was paid). */
+            readonly paid_with?: components['schemas']['ResolvePaidWith'];
             /** @description Quoted price in USD micros; `null` until quoted, `0` on the free tier. */
             readonly quote_micro_usd: number | null;
             /**
@@ -11286,6 +11345,14 @@ type components = {
         readonly ResolveKeys: {
             readonly keys: readonly components['schemas']['ResolveKey'][];
         };
+        /**
+         * Payment method
+         * @description How an accepted job is paid: `free` (free tier), `intro` (first paid job, €1 hold),
+         *     `credit` (one t7 fix credit, no wallet hold) or `wallet` (hold of the list price).
+         *     Precedence: `free` > `intro` > `credit` > `wallet`.
+         * @enum {string}
+         */
+        readonly ResolvePaidWith: 'intro' | 'credit' | 'wallet' | 'free';
         /**
          * Quote
          * @description `201` body — the job was quoted (`quoted`) or auto-accepted on the free tier (`accepted`).
@@ -11301,6 +11368,17 @@ type components = {
             readonly free_tier_remaining: number;
             /** Format: uuid */
             readonly id: string;
+            /**
+             * @description Present only on a `quoted` job while the intro price applies to you: accepting holds
+             *     this amount (EUR micros, `1000000` = €1) instead of the list price.
+             * @example 1000000
+             */
+            readonly intro_price_micro_eur?: number;
+            /**
+             * @description Present together with `intro_price_micro_eur`; the regular hold in EUR micros (the quote 1:1).
+             * @example 7000000
+             */
+            readonly list_price_micro_eur?: number;
             /**
              * @description Quoted price in USD micros (`7000000` = $7). `0` on the free tier.
              * @example 7000000
@@ -11421,7 +11499,8 @@ type components = {
         /**
          * @description The wallet balance does not cover the quote. Nothing was debited and the job is still
          *     `quoted`. Open `topup_url` (pay.codai.ro checkout, shortfall rounded up to whole euros,
-         *     minimum €10, maximum €1000), then retry `/accept`.
+         *     minimum €10, maximum €1000) — or, for a `t7` job, `bundle_url` (10 fix credits for €49) —
+         *     then retry `/accept`.
          */
         readonly ResolveInsufficientFunds: {
             headers: {
@@ -11525,6 +11604,27 @@ interface operations {
             readonly 404: components['responses']['ResolveNotFound'];
         };
     };
+    readonly getResolveBalance: {
+        readonly parameters: {
+            readonly query?: never;
+            readonly header?: never;
+            readonly path?: never;
+            readonly cookie?: never;
+        };
+        readonly requestBody?: never;
+        readonly responses: {
+            /** @description Current balance. */
+            readonly 200: {
+                headers: {
+                    readonly [name: string]: unknown;
+                };
+                content: {
+                    readonly 'application/json': components['schemas']['ResolveBalance'];
+                };
+            };
+            readonly 401: components['responses']['ResolveUnauthorized'];
+        };
+    };
     readonly createResolveJob: {
         readonly parameters: {
             readonly query?: never;
@@ -11690,6 +11790,10 @@ type ResolveDeclined = ResolveSchemas['ResolveDeclined'];
 /** `submit()` result: `201` quote / free-tier auto-accept, or `200` decline. */
 type ResolveSubmitResult = ResolveQuote | ResolveDeclined;
 type ResolveAccepted = ResolveSchemas['ResolveAccepted'];
+/** How an accepted job is paid: `free` > `intro` (€1) > `credit` (t7 fix credit) > `wallet`. */
+type ResolvePaidWith = ResolveSchemas['ResolvePaidWith'];
+/** `GET /v1/resolve/balance` — fix credits, intro availability, wallet (EUR micros). */
+type ResolveBalance = ResolveSchemas['ResolveBalance'];
 type ResolveJob = ResolveSchemas['ResolveJob'];
 type ResolveJobStatus = ResolveSchemas['ResolveJobStatus'];
 type ResolveTier = ResolveSchemas['ResolveTier'];
@@ -11762,6 +11866,8 @@ declare class ResolveInsufficientFundsError extends ResolveError {
     readonly currency: 'micro_eur';
     /** pay.codai.ro checkout link for the shortfall — open it, then retry `accept()`. */
     readonly topupUrl: string;
+    /** Present only for a `t7` job: fix-bundle checkout (10 t7 fix credits for €49). */
+    readonly bundleUrl?: string;
     constructor(message: string, body: ResolveInsufficientFunds, meta?: {
         requestId?: string | null;
     });
@@ -11794,8 +11900,10 @@ declare class Resolve {
     get(id: string, opts?: CallOpts$4): Promise<ResolveJob>;
     /**
      * `POST /v1/resolve/jobs/{id}/accept` — accept a paid quote and start the job.
-     * Throws `ResolveInsufficientFundsError` (402, carries `topupUrl`) when the
-     * wallet is short, `ResolveError` 409 when the job is not `quoted`.
+     * The result's `paid_with` says how it was paid (`intro` €1 hold, `credit`
+     * t7 fix credit, or `wallet`). Throws `ResolveInsufficientFundsError` (402,
+     * carries `topupUrl`, plus `bundleUrl` for t7) when the wallet is short,
+     * `ResolveError` 409 when the job is not `quoted`.
      */
     accept(id: string, opts?: CallOpts$4): Promise<ResolveAccepted>;
     /**
@@ -11805,6 +11913,8 @@ declare class Resolve {
     attestation(idOrUrl: string, opts?: CallOpts$4): Promise<ResolveAttestation>;
     /** `GET /health` — liveness of the Resolve service. */
     health(opts?: CallOpts$4): Promise<ResolveHealth>;
+    /** `GET /v1/resolve/balance` — fix credits (t7 only), intro availability and wallet balance. */
+    balance(opts?: CallOpts$4): Promise<ResolveBalance>;
     /** `GET /v1/resolve/keys` — public keys that sign attestations (no auth needed server-side). */
     keys(opts?: CallOpts$4): Promise<ResolveKeys>;
     /**
@@ -12323,4 +12433,4 @@ declare class Codai {
     private legacyExt;
 }
 
-export { Account, type AccountPatchRequest, type AccountPatchResponse, type AccountView, type AgentRun, type AgentRunAccepted, type AgentRunCreateRequest, type AgentRunRequest, type AgentRunResult, type AgentRunStats, type AgentRunStatus, type AgentRunStep, type AgentRunStreamEvent, AgentRuns, type AgentSyncResult, Agents, Audio, Chat, type ChatCallOptions, type ChatCompletionChunk, type ChatCompletionInput, type ChatCompletionRequest, type ChatCompletionResponse, ChatCompletions, type ChatMessage, type ChatOptions, type ChatResult, type ChatStream, type ChatStreamResult, type ChatTool, type ChatToolCall, type ChatUsage, Codai, type CodaiClientOptions, CodaiError, type CodaiRequestExtensions, type Device, type DevicePatch, type DevicePatched, Devices, type DispatchInbox, Embeddings, type EmbeddingsOptions, type EmbeddingsRequest, type EmbeddingsResponse, type EmbeddingsResult, type Environment, type EnvironmentAddMemberBody, type EnvironmentCreateBody, type EnvironmentDetail, type EnvironmentEnrollBody, type EnvironmentEnrollToken, type EnvironmentEnrolled, type EnvironmentMember, type EnvironmentMemberCreated, EnvironmentMembers, type EnvironmentPatchBody, type EnvironmentPort, type EnvironmentPortBody, EnvironmentPorts, type EnvironmentProvider, type EnvironmentRole, type EnvironmentSecret, type EnvironmentSecretSet, EnvironmentSecrets, type EnvironmentSshCa, type EnvironmentSshCert, type EnvironmentSshCertBody, type EnvironmentState, type EnvironmentTaskCreateBody, type EnvironmentTaskCreated, type EnvironmentTaskDetail, type EnvironmentTaskList, EnvironmentTasks, type EnvironmentTransition, Environments, type EphemeralScope, type EphemeralToken, type EphemeralTokenResponse, type ErrorCode, Feedback, type FeedbackRequest, type FeedbackResponse, Health, type HealthReadyResponse, type HealthResponse, type HostExecBody, type HostExecRequest, type HostExecResponse, type HostExecResultBody, type HostOp, type HostPresence, type HostStreamEvent, Hosts, HttpClient, type ListEnvironmentsQuery, type MessageCallOptions, type MessageInput, type MessageRequest, type MessageResponse, type MessageResult, type MessageStream, type MessageStreamEvent, type MessageStreamResult, Messages, type Model, type ModelList, Models, type NotificationList, Notifications, type NotificationsDeleted, type NotificationsRead, OPERATION_METHODS, type Org, type OrgAddMemberBody, type OrgMember, OrgMembers, type OrgRole, Orgs, type PhoneModel, PhoneModels, type Project, type ProjectCreateBody, type ProjectDetail, type ProjectIsolation, type ProjectPatchBody, Projects, RESOLVE_ATTESTATION_PAYLOAD_TYPE, RESOLVE_OPERATION_METHODS, RESOLVE_TERMINAL_STATUSES, type Receipt, Receipts, type RequestOptions, Resolve, type ResolveAccepted, type ResolveAttestation, type ResolveAttestationEnvelope, type ResolveAttestationVerifyResult, type components as ResolveComponents, type ResolveDeclined, ResolveError, type ResolveHealth, type ResolveInsufficientFunds, ResolveInsufficientFundsError, type ResolveIntake, type ResolveJob, type ResolveJobStatus, type ResolveKey, type ResolveKeys, type operations as ResolveOperations, type paths as ResolvePaths, type ResolveQuote, type ResolveReproTest, type ResolveSubmitResult, type ResolveTier, type ResolveValidationDetails, type ResolveWaitOptions, type ResolveWebhookEvent, type ResolveWebhookEventName, type ResolveWebhookJob, Responses, type ResponsesCallOptions, type ResponsesInput, type ResponsesRequest, type ResponsesResponse, type ResponsesResult, type ResponsesStream, type ResponsesStreamEvent, type ResponsesStreamResult, STREAMING_OPERATIONS, type Session, type SessionControl, type SessionControlAccepted, type SessionControlRequest, SessionControls, type SessionCreateRequest, type SessionDetail, type SessionDispatchRequest, type SessionDispatchResponse, type SessionEvent, SessionEvents, type SessionEventsAppendRequest, type SessionEventsAppendResponse, type SessionEventsPage, type SessionIncomingEvent, SessionLease, type SessionLeaseClaimRequest, type SessionLeaseResponse, type SessionListItem, type SessionPatchRequest, type SessionShare, type SessionShareCreateRequest, type SessionShareCreated, SessionShares, type SessionStreamEvent, Sessions, type SharedSession, type SpeechRequest, type SpeechResult, type SseFrame, type StatusResponse, type Task, type TaskConfirmRequest, type TaskConfirmResponse, type TaskListPage, type TaskListQuery, type TaskOutcome, type TaskStats, Tasks, type TokenUsage, Tokens, type ToolFetchRequest, type ToolFetchResponse, type ToolSearchRequest, type ToolSearchResponse, Tools, type TranscriptionOptions, type TranscriptionResponse, type TranscriptionResult, type TriggerCreateRequest, type TriggerCreated, type TriggerEvents, type TriggerList, type TriggerPatch, type TriggerTestRequest, type TriggerTestResult, type TriggerUpdated, Triggers, type VerifyResolveWebhookOptions, type components$1 as components, Codai as default, extensionHeaders, frameJson, mergeToolCall, type operations$1 as operations, type paths$1 as paths, readSse, resolveAttestationStatement, verifyAttestationWithKeys, verifyResolveWebhook };
+export { Account, type AccountPatchRequest, type AccountPatchResponse, type AccountView, type AgentRun, type AgentRunAccepted, type AgentRunCreateRequest, type AgentRunRequest, type AgentRunResult, type AgentRunStats, type AgentRunStatus, type AgentRunStep, type AgentRunStreamEvent, AgentRuns, type AgentSyncResult, Agents, Audio, Chat, type ChatCallOptions, type ChatCompletionChunk, type ChatCompletionInput, type ChatCompletionRequest, type ChatCompletionResponse, ChatCompletions, type ChatMessage, type ChatOptions, type ChatResult, type ChatStream, type ChatStreamResult, type ChatTool, type ChatToolCall, type ChatUsage, Codai, type CodaiClientOptions, CodaiError, type CodaiRequestExtensions, type Device, type DevicePatch, type DevicePatched, Devices, type DispatchInbox, Embeddings, type EmbeddingsOptions, type EmbeddingsRequest, type EmbeddingsResponse, type EmbeddingsResult, type Environment, type EnvironmentAddMemberBody, type EnvironmentCreateBody, type EnvironmentDetail, type EnvironmentEnrollBody, type EnvironmentEnrollToken, type EnvironmentEnrolled, type EnvironmentMember, type EnvironmentMemberCreated, EnvironmentMembers, type EnvironmentPatchBody, type EnvironmentPort, type EnvironmentPortBody, EnvironmentPorts, type EnvironmentProvider, type EnvironmentRole, type EnvironmentSecret, type EnvironmentSecretSet, EnvironmentSecrets, type EnvironmentSshCa, type EnvironmentSshCert, type EnvironmentSshCertBody, type EnvironmentState, type EnvironmentTaskCreateBody, type EnvironmentTaskCreated, type EnvironmentTaskDetail, type EnvironmentTaskList, EnvironmentTasks, type EnvironmentTransition, Environments, type EphemeralScope, type EphemeralToken, type EphemeralTokenResponse, type ErrorCode, Feedback, type FeedbackRequest, type FeedbackResponse, Health, type HealthReadyResponse, type HealthResponse, type HostExecBody, type HostExecRequest, type HostExecResponse, type HostExecResultBody, type HostOp, type HostPresence, type HostStreamEvent, Hosts, HttpClient, type ListEnvironmentsQuery, type MessageCallOptions, type MessageInput, type MessageRequest, type MessageResponse, type MessageResult, type MessageStream, type MessageStreamEvent, type MessageStreamResult, Messages, type Model, type ModelList, Models, type NotificationList, Notifications, type NotificationsDeleted, type NotificationsRead, OPERATION_METHODS, type Org, type OrgAddMemberBody, type OrgMember, OrgMembers, type OrgRole, Orgs, type PhoneModel, PhoneModels, type Project, type ProjectCreateBody, type ProjectDetail, type ProjectIsolation, type ProjectPatchBody, Projects, RESOLVE_ATTESTATION_PAYLOAD_TYPE, RESOLVE_OPERATION_METHODS, RESOLVE_TERMINAL_STATUSES, type Receipt, Receipts, type RequestOptions, Resolve, type ResolveAccepted, type ResolveAttestation, type ResolveAttestationEnvelope, type ResolveAttestationVerifyResult, type ResolveBalance, type components as ResolveComponents, type ResolveDeclined, ResolveError, type ResolveHealth, type ResolveInsufficientFunds, ResolveInsufficientFundsError, type ResolveIntake, type ResolveJob, type ResolveJobStatus, type ResolveKey, type ResolveKeys, type operations as ResolveOperations, type ResolvePaidWith, type paths as ResolvePaths, type ResolveQuote, type ResolveReproTest, type ResolveSubmitResult, type ResolveTier, type ResolveValidationDetails, type ResolveWaitOptions, type ResolveWebhookEvent, type ResolveWebhookEventName, type ResolveWebhookJob, Responses, type ResponsesCallOptions, type ResponsesInput, type ResponsesRequest, type ResponsesResponse, type ResponsesResult, type ResponsesStream, type ResponsesStreamEvent, type ResponsesStreamResult, STREAMING_OPERATIONS, type Session, type SessionControl, type SessionControlAccepted, type SessionControlRequest, SessionControls, type SessionCreateRequest, type SessionDetail, type SessionDispatchRequest, type SessionDispatchResponse, type SessionEvent, SessionEvents, type SessionEventsAppendRequest, type SessionEventsAppendResponse, type SessionEventsPage, type SessionIncomingEvent, SessionLease, type SessionLeaseClaimRequest, type SessionLeaseResponse, type SessionListItem, type SessionPatchRequest, type SessionShare, type SessionShareCreateRequest, type SessionShareCreated, SessionShares, type SessionStreamEvent, Sessions, type SharedSession, type SpeechRequest, type SpeechResult, type SseFrame, type StatusResponse, type Task, type TaskConfirmRequest, type TaskConfirmResponse, type TaskListPage, type TaskListQuery, type TaskOutcome, type TaskStats, Tasks, type TokenUsage, Tokens, type ToolFetchRequest, type ToolFetchResponse, type ToolSearchRequest, type ToolSearchResponse, Tools, type TranscriptionOptions, type TranscriptionResponse, type TranscriptionResult, type TriggerCreateRequest, type TriggerCreated, type TriggerEvents, type TriggerList, type TriggerPatch, type TriggerTestRequest, type TriggerTestResult, type TriggerUpdated, Triggers, type VerifyResolveWebhookOptions, type components$1 as components, Codai as default, extensionHeaders, frameJson, mergeToolCall, type operations$1 as operations, type paths$1 as paths, readSse, resolveAttestationStatement, verifyAttestationWithKeys, verifyResolveWebhook };

package/dist/index.js

@@ -1382,6 +1382,8 @@ var ResolveInsufficientFundsError = class extends ResolveError {
   currency;
   /** pay.codai.ro checkout link for the shortfall — open it, then retry `accept()`. */
   topupUrl;
+  /** Present only for a `t7` job: fix-bundle checkout (10 t7 fix credits for €49). */
+  bundleUrl;
   constructor(message, body, meta = {}) {
     super(message, 402, body, meta);
     this.name = "ResolveInsufficientFundsError";
@@ -1389,6 +1391,7 @@ var ResolveInsufficientFundsError = class extends ResolveError {
     this.required = body.required;
     this.currency = body.currency;
     this.topupUrl = body.topup_url;
+    if (typeof body.bundle_url === "string") this.bundleUrl = body.bundle_url;
   }
 };
 var Resolve = class {
@@ -1420,8 +1423,10 @@ var Resolve = class {
   }
   /**
    * `POST /v1/resolve/jobs/{id}/accept` — accept a paid quote and start the job.
-   * Throws `ResolveInsufficientFundsError` (402, carries `topupUrl`) when the
-   * wallet is short, `ResolveError` 409 when the job is not `quoted`.
+   * The result's `paid_with` says how it was paid (`intro` €1 hold, `credit`
+   * t7 fix credit, or `wallet`). Throws `ResolveInsufficientFundsError` (402,
+   * carries `topupUrl`, plus `bundleUrl` for t7) when the wallet is short,
+   * `ResolveError` 409 when the job is not `quoted`.
    */
   accept(id, opts = {}) {
     return this.call(`/v1/resolve/jobs/${encodeURIComponent(id)}/accept`, {
@@ -1446,6 +1451,10 @@ var Resolve = class {
   health(opts = {}) {
     return this.call("/health", { signal: opts.signal });
   }
+  /** `GET /v1/resolve/balance` — fix credits (t7 only), intro availability and wallet balance. */
+  balance(opts = {}) {
+    return this.call("/v1/resolve/balance", { signal: opts.signal });
+  }
   /** `GET /v1/resolve/keys` — public keys that sign attestations (no auth needed server-side). */
   keys(opts = {}) {
     return this.call("/v1/resolve/keys", { signal: opts.signal });
@@ -1511,7 +1520,7 @@ function toResolveError(path, err) {
   if (err.status === 402 && isInsufficientFunds(err.body)) {
     const b = err.body;
     return new ResolveInsufficientFundsError(
-      `codai-resolve ${path} \u2192 402: insufficient funds (balance ${b.balance}, required ${b.required} ${b.currency}); top up at ${b.topup_url}`,
+      `codai-resolve ${path} \u2192 402: insufficient funds (balance ${b.balance}, required ${b.required} ${b.currency}); top up at ${b.topup_url}${b.bundle_url ? ` or buy 10 t7 fixes for \u20AC49 at ${b.bundle_url}` : ""}`,
       b,
       meta
     );
@@ -2174,7 +2183,8 @@ var RESOLVE_OPERATION_METHODS = {
   getResolveJob: "resolve.get",
   acceptResolveJob: "resolve.accept",
   getResolveAttestation: "resolve.attestation",
-  getResolveKeys: "resolve.keys"
+  getResolveKeys: "resolve.keys",
+  getResolveBalance: "resolve.balance"
 };
 
 // src/index.ts