deepline 0.3.193 → 0.3.194

package/dist/bundling-sources/sdk/src/client.ts

@@ -2029,6 +2029,28 @@ export type BillingTopUpResult = {
   payment_method?: BillingPaymentMethodSummary | null;
 };
 
+/** Operation receipt for a top-up that may still be awaiting payment. */
+export type BillingTopUpReceipt =
+  | (BillingTopUpResult & { status?: undefined })
+  | {
+      status: 'pending';
+      operation_id: string;
+      operation_state: 'payment_pending';
+      requested_credits: number;
+      amount_cents: number;
+      currency: string;
+    }
+  | {
+      status: 'applied';
+      operation_id: string;
+      operation_state: 'applied';
+      applied_credits: number;
+      amount_cents: number;
+      currency: string;
+      balance?: number;
+      stripe_payment_intent_id?: string;
+    };
+
 /** One published plan from `GET /api/v2/billing/catalog/current`. */
 export type BillingPlanEntry = {
   plan_family_id: string;
@@ -2203,6 +2225,11 @@ export type BillingNamespace = {
     credits: number;
     idempotencyKey?: string;
   }) => Promise<BillingTopUpResult>;
+  /** Request a durable pending or applied receipt for a saved-card top-up. */
+  topUpWithReceipt: (options: {
+    credits: number;
+    idempotencyKey?: string;
+  }) => Promise<BillingTopUpReceipt>;
   /** Published plans plus the plan you are on ("what plans exist and what am I on"). */
   plans: () => Promise<BillingPlansResult>;
   subscription: {
@@ -2827,6 +2854,8 @@ export class DeeplineClient {
     };
     this.billing = {
       topUp: (options) => this.topUpBillingBalance(options),
+      topUpWithReceipt: (options) =>
+        this.topUpBillingBalanceWithReceipt(options),
       plans: () => this.getBillingPlans(),
       subscription: {
         status: () => this.getBillingSubscriptionStatus(),
@@ -6354,6 +6383,28 @@ export class DeeplineClient {
     );
   }
 
+  /**
+   * Request a durable top-up operation receipt. A pending receipt does not
+   * imply that payment or credit activation has completed. Prefer
+   * `client.billing.topUpWithReceipt(...)`.
+   */
+  async topUpBillingBalanceWithReceipt(options: {
+    credits: number;
+    idempotencyKey?: string;
+  }): Promise<BillingTopUpReceipt> {
+    return this.http.post<BillingTopUpReceipt>(
+      '/api/v2/billing/top-up',
+      {
+        credits: options.credits,
+        ...(options.idempotencyKey
+          ? { idempotency_key: options.idempotencyKey }
+          : {}),
+      },
+      { 'x-deepline-top-up-receipt': 'operation-v1' },
+      { maxRetries: 0, exactUrlOnly: true },
+    );
+  }
+
   /**
    * Subscription state for the active workspace: active plan, whether a
    * Stripe subscription backs it, renewal/cancellation facts, and remaining

package/dist/bundling-sources/sdk/src/index.ts

@@ -74,6 +74,7 @@ export type {
   BillingSubscriptionCancelResult,
   BillingSubscriptionStatus,
   BillingTopUpResult,
+  BillingTopUpReceipt,
   BillingUsageEvent,
   BillingUsageOptions,
   BillingUsageResult,

package/dist/bundling-sources/sdk/src/release.ts

@@ -200,7 +200,7 @@ export const SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: '0.3.193',
+  version: '0.3.194',
   updateSummary:
     'Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.',
   packageCapabilities: {

package/dist/cli/index.js

@@ -3051,7 +3051,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.193",
+  version: "0.3.194",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -7207,6 +7207,7 @@ var DeeplineClient = class _DeeplineClient {
     };
     this.billing = {
       topUp: (options2) => this.topUpBillingBalance(options2),
+      topUpWithReceipt: (options2) => this.topUpBillingBalanceWithReceipt(options2),
       plans: () => this.getBillingPlans(),
       subscription: {
         status: () => this.getBillingSubscriptionStatus(),
@@ -9837,6 +9838,22 @@ var DeeplineClient = class _DeeplineClient {
       { maxRetries: 0, exactUrlOnly: true }
     );
   }
+  /**
+   * Request a durable top-up operation receipt. A pending receipt does not
+   * imply that payment or credit activation has completed. Prefer
+   * `client.billing.topUpWithReceipt(...)`.
+   */
+  async topUpBillingBalanceWithReceipt(options) {
+    return this.http.post(
+      "/api/v2/billing/top-up",
+      {
+        credits: options.credits,
+        ...options.idempotencyKey ? { idempotency_key: options.idempotencyKey } : {}
+      },
+      { "x-deepline-top-up-receipt": "operation-v1" },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
   /**
    * Subscription state for the active workspace: active plan, whether a
    * Stripe subscription backs it, renewal/cancellation facts, and remaining
@@ -13294,7 +13311,10 @@ async function handleTopUp(creditsRaw, options) {
   const client2 = new DeeplineClient();
   let payload;
   try {
-    payload = await client2.billing.topUp({ credits, idempotencyKey });
+    payload = await client2.billing.topUpWithReceipt({
+      credits,
+      idempotencyKey
+    });
   } catch (error) {
     const failure = billingTopUpFailureFromError(error, {
       credits,
@@ -13304,31 +13324,65 @@ async function handleTopUp(creditsRaw, options) {
     reportBillingFailure(failure, options);
     return;
   }
+  if (payload.status === "pending") {
+    printCommandEnvelope(
+      {
+        ok: true,
+        ...payload,
+        idempotency_key: idempotencyKey,
+        next: topUpRetryCommand(credits, idempotencyKey),
+        render: {
+          sections: [
+            {
+              title: "billing top-up pending",
+              lines: [
+                `Requested: ${payload.requested_credits} Deepline Credits`,
+                "Payment is still being confirmed. Credits have not been reported as added.",
+                `Operation: ${payload.operation_id}`,
+                `Retry with the same key: ${topUpRetryCommand(credits, idempotencyKey)}`
+              ]
+            }
+          ]
+        }
+      },
+      { json: options.json }
+    );
+    return;
+  }
   const amountText = invoiceAmountText(payload.amount_cents, payload.currency);
-  const paymentLabel = payload.payment_method?.label ?? [
-    payload.payment_method?.brand ? humanize(payload.payment_method.brand) : null,
-    payload.payment_method?.last4 ? `ending in ${payload.payment_method.last4}` : null
+  const appliedCredits = "applied_credits" in payload ? payload.applied_credits : payload.credits;
+  const paymentMethod = "payment_method" in payload ? payload.payment_method : void 0;
+  const paymentLabel = paymentMethod?.label ?? [
+    paymentMethod?.brand ? humanize(paymentMethod.brand) : null,
+    paymentMethod?.last4 ? `ending in ${paymentMethod.last4}` : null
   ].filter(Boolean).join(" ");
   const compactEnvelope = {
     ok: true,
-    credits: payload.credits,
+    credits: appliedCredits,
     amount_cents: payload.amount_cents,
     currency: payload.currency,
-    balance_credits: payload.balance,
+    ...typeof payload.balance === "number" ? { balance_credits: payload.balance } : {},
+    ..."operation_id" in payload ? {
+      status: payload.status,
+      operation_id: payload.operation_id,
+      operation_state: payload.operation_state
+    } : {},
     idempotency_key: idempotencyKey
   };
   const fullEnvelope = {
     ...payload,
-    balance_credits: payload.balance,
+    ok: true,
+    credits: appliedCredits,
+    ...typeof payload.balance === "number" ? { balance_credits: payload.balance } : {},
     idempotency_key: idempotencyKey,
     render: {
       sections: [
         {
           title: "billing top-up",
           lines: [
-            `Added: ${payload.credits} Deepline Credits`,
+            `Added: ${appliedCredits} Deepline Credits`,
             `Charged: ${amountText}`,
-            `Balance: ${payload.balance} Deepline Credits`,
+            ...typeof payload.balance === "number" ? [`Balance: ${payload.balance} Deepline Credits`] : ["Balance: unavailable; check deepline billing balance."],
             ...paymentLabel ? [`Payment method: ${paymentLabel}`] : []
           ]
         }

package/dist/cli/index.mjs

@@ -3046,7 +3046,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.193",
+  version: "0.3.194",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -7202,6 +7202,7 @@ var DeeplineClient = class _DeeplineClient {
     };
     this.billing = {
       topUp: (options2) => this.topUpBillingBalance(options2),
+      topUpWithReceipt: (options2) => this.topUpBillingBalanceWithReceipt(options2),
       plans: () => this.getBillingPlans(),
       subscription: {
         status: () => this.getBillingSubscriptionStatus(),
@@ -9832,6 +9833,22 @@ var DeeplineClient = class _DeeplineClient {
       { maxRetries: 0, exactUrlOnly: true }
     );
   }
+  /**
+   * Request a durable top-up operation receipt. A pending receipt does not
+   * imply that payment or credit activation has completed. Prefer
+   * `client.billing.topUpWithReceipt(...)`.
+   */
+  async topUpBillingBalanceWithReceipt(options) {
+    return this.http.post(
+      "/api/v2/billing/top-up",
+      {
+        credits: options.credits,
+        ...options.idempotencyKey ? { idempotency_key: options.idempotencyKey } : {}
+      },
+      { "x-deepline-top-up-receipt": "operation-v1" },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
   /**
    * Subscription state for the active workspace: active plan, whether a
    * Stripe subscription backs it, renewal/cancellation facts, and remaining
@@ -13301,7 +13318,10 @@ async function handleTopUp(creditsRaw, options) {
   const client2 = new DeeplineClient();
   let payload;
   try {
-    payload = await client2.billing.topUp({ credits, idempotencyKey });
+    payload = await client2.billing.topUpWithReceipt({
+      credits,
+      idempotencyKey
+    });
   } catch (error) {
     const failure = billingTopUpFailureFromError(error, {
       credits,
@@ -13311,31 +13331,65 @@ async function handleTopUp(creditsRaw, options) {
     reportBillingFailure(failure, options);
     return;
   }
+  if (payload.status === "pending") {
+    printCommandEnvelope(
+      {
+        ok: true,
+        ...payload,
+        idempotency_key: idempotencyKey,
+        next: topUpRetryCommand(credits, idempotencyKey),
+        render: {
+          sections: [
+            {
+              title: "billing top-up pending",
+              lines: [
+                `Requested: ${payload.requested_credits} Deepline Credits`,
+                "Payment is still being confirmed. Credits have not been reported as added.",
+                `Operation: ${payload.operation_id}`,
+                `Retry with the same key: ${topUpRetryCommand(credits, idempotencyKey)}`
+              ]
+            }
+          ]
+        }
+      },
+      { json: options.json }
+    );
+    return;
+  }
   const amountText = invoiceAmountText(payload.amount_cents, payload.currency);
-  const paymentLabel = payload.payment_method?.label ?? [
-    payload.payment_method?.brand ? humanize(payload.payment_method.brand) : null,
-    payload.payment_method?.last4 ? `ending in ${payload.payment_method.last4}` : null
+  const appliedCredits = "applied_credits" in payload ? payload.applied_credits : payload.credits;
+  const paymentMethod = "payment_method" in payload ? payload.payment_method : void 0;
+  const paymentLabel = paymentMethod?.label ?? [
+    paymentMethod?.brand ? humanize(paymentMethod.brand) : null,
+    paymentMethod?.last4 ? `ending in ${paymentMethod.last4}` : null
   ].filter(Boolean).join(" ");
   const compactEnvelope = {
     ok: true,
-    credits: payload.credits,
+    credits: appliedCredits,
     amount_cents: payload.amount_cents,
     currency: payload.currency,
-    balance_credits: payload.balance,
+    ...typeof payload.balance === "number" ? { balance_credits: payload.balance } : {},
+    ..."operation_id" in payload ? {
+      status: payload.status,
+      operation_id: payload.operation_id,
+      operation_state: payload.operation_state
+    } : {},
     idempotency_key: idempotencyKey
   };
   const fullEnvelope = {
     ...payload,
-    balance_credits: payload.balance,
+    ok: true,
+    credits: appliedCredits,
+    ...typeof payload.balance === "number" ? { balance_credits: payload.balance } : {},
     idempotency_key: idempotencyKey,
     render: {
       sections: [
         {
           title: "billing top-up",
           lines: [
-            `Added: ${payload.credits} Deepline Credits`,
+            `Added: ${appliedCredits} Deepline Credits`,
             `Charged: ${amountText}`,
-            `Balance: ${payload.balance} Deepline Credits`,
+            ...typeof payload.balance === "number" ? [`Balance: ${payload.balance} Deepline Credits`] : ["Balance: unavailable; check deepline billing balance."],
             ...paymentLabel ? [`Payment method: ${paymentLabel}`] : []
           ]
         }

package/dist/index.d.mts

@@ -4247,6 +4247,26 @@ type BillingTopUpResult = {
     stripe_payment_intent_id: string;
     payment_method?: BillingPaymentMethodSummary | null;
 };
+/** Operation receipt for a top-up that may still be awaiting payment. */
+type BillingTopUpReceipt = (BillingTopUpResult & {
+    status?: undefined;
+}) | {
+    status: 'pending';
+    operation_id: string;
+    operation_state: 'payment_pending';
+    requested_credits: number;
+    amount_cents: number;
+    currency: string;
+} | {
+    status: 'applied';
+    operation_id: string;
+    operation_state: 'applied';
+    applied_credits: number;
+    amount_cents: number;
+    currency: string;
+    balance?: number;
+    stripe_payment_intent_id?: string;
+};
 /** One published plan from `GET /api/v2/billing/catalog/current`. */
 type BillingPlanEntry = {
     plan_family_id: string;
@@ -4409,6 +4429,11 @@ type BillingNamespace = {
         credits: number;
         idempotencyKey?: string;
     }) => Promise<BillingTopUpResult>;
+    /** Request a durable pending or applied receipt for a saved-card top-up. */
+    topUpWithReceipt: (options: {
+        credits: number;
+        idempotencyKey?: string;
+    }) => Promise<BillingTopUpReceipt>;
     /** Published plans plus the plan you are on ("what plans exist and what am I on"). */
     plans: () => Promise<BillingPlansResult>;
     subscription: {
@@ -5528,6 +5553,15 @@ declare class DeeplineClient {
         credits: number;
         idempotencyKey?: string;
     }): Promise<BillingTopUpResult>;
+    /**
+     * Request a durable top-up operation receipt. A pending receipt does not
+     * imply that payment or credit activation has completed. Prefer
+     * `client.billing.topUpWithReceipt(...)`.
+     */
+    topUpBillingBalanceWithReceipt(options: {
+        credits: number;
+        idempotencyKey?: string;
+    }): Promise<BillingTopUpReceipt>;
     /**
      * Subscription state for the active workspace: active plan, whether a
      * Stripe subscription backs it, renewal/cancellation facts, and remaining
@@ -6741,4 +6775,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CreateNotificationGroupInput, type CreateNotificationGroupResult, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LegacyMonitorStatusFilter, type LiveEventEnvelope, MONITOR_JOB_PHASES, MONITOR_JOB_RECONCILIATION_STATES, MONITOR_JOB_STATES, type MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobPhase, type MonitorJobReconciliationState, type MonitorJobResult, type MonitorJobState, type MonitorJobWaitOptions, type MonitorJobsNamespace, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorState, type MonitorStateFilter, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayAsyncCallOptions, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayCostEstimate, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, ToolResultBilling, type ToolSearchOptions, type ToolSearchResult, type WorkspaceCreateResult, type WorkspacesNamespace, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpReceipt, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CreateNotificationGroupInput, type CreateNotificationGroupResult, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LegacyMonitorStatusFilter, type LiveEventEnvelope, MONITOR_JOB_PHASES, MONITOR_JOB_RECONCILIATION_STATES, MONITOR_JOB_STATES, type MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobPhase, type MonitorJobReconciliationState, type MonitorJobResult, type MonitorJobState, type MonitorJobWaitOptions, type MonitorJobsNamespace, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorState, type MonitorStateFilter, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayAsyncCallOptions, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayCostEstimate, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, ToolResultBilling, type ToolSearchOptions, type ToolSearchResult, type WorkspaceCreateResult, type WorkspacesNamespace, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };

package/dist/index.d.ts

@@ -4247,6 +4247,26 @@ type BillingTopUpResult = {
     stripe_payment_intent_id: string;
     payment_method?: BillingPaymentMethodSummary | null;
 };
+/** Operation receipt for a top-up that may still be awaiting payment. */
+type BillingTopUpReceipt = (BillingTopUpResult & {
+    status?: undefined;
+}) | {
+    status: 'pending';
+    operation_id: string;
+    operation_state: 'payment_pending';
+    requested_credits: number;
+    amount_cents: number;
+    currency: string;
+} | {
+    status: 'applied';
+    operation_id: string;
+    operation_state: 'applied';
+    applied_credits: number;
+    amount_cents: number;
+    currency: string;
+    balance?: number;
+    stripe_payment_intent_id?: string;
+};
 /** One published plan from `GET /api/v2/billing/catalog/current`. */
 type BillingPlanEntry = {
     plan_family_id: string;
@@ -4409,6 +4429,11 @@ type BillingNamespace = {
         credits: number;
         idempotencyKey?: string;
     }) => Promise<BillingTopUpResult>;
+    /** Request a durable pending or applied receipt for a saved-card top-up. */
+    topUpWithReceipt: (options: {
+        credits: number;
+        idempotencyKey?: string;
+    }) => Promise<BillingTopUpReceipt>;
     /** Published plans plus the plan you are on ("what plans exist and what am I on"). */
     plans: () => Promise<BillingPlansResult>;
     subscription: {
@@ -5528,6 +5553,15 @@ declare class DeeplineClient {
         credits: number;
         idempotencyKey?: string;
     }): Promise<BillingTopUpResult>;
+    /**
+     * Request a durable top-up operation receipt. A pending receipt does not
+     * imply that payment or credit activation has completed. Prefer
+     * `client.billing.topUpWithReceipt(...)`.
+     */
+    topUpBillingBalanceWithReceipt(options: {
+        credits: number;
+        idempotencyKey?: string;
+    }): Promise<BillingTopUpReceipt>;
     /**
      * Subscription state for the active workspace: active plan, whether a
      * Stripe subscription backs it, renewal/cancellation facts, and remaining
@@ -6741,4 +6775,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CreateNotificationGroupInput, type CreateNotificationGroupResult, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LegacyMonitorStatusFilter, type LiveEventEnvelope, MONITOR_JOB_PHASES, MONITOR_JOB_RECONCILIATION_STATES, MONITOR_JOB_STATES, type MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobPhase, type MonitorJobReconciliationState, type MonitorJobResult, type MonitorJobState, type MonitorJobWaitOptions, type MonitorJobsNamespace, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorState, type MonitorStateFilter, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayAsyncCallOptions, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayCostEstimate, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, ToolResultBilling, type ToolSearchOptions, type ToolSearchResult, type WorkspaceCreateResult, type WorkspacesNamespace, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpReceipt, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CreateNotificationGroupInput, type CreateNotificationGroupResult, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LegacyMonitorStatusFilter, type LiveEventEnvelope, MONITOR_JOB_PHASES, MONITOR_JOB_RECONCILIATION_STATES, MONITOR_JOB_STATES, type MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobPhase, type MonitorJobReconciliationState, type MonitorJobResult, type MonitorJobState, type MonitorJobWaitOptions, type MonitorJobsNamespace, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorState, type MonitorStateFilter, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayAsyncCallOptions, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayCostEstimate, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, ToolResultBilling, type ToolSearchOptions, type ToolSearchResult, type WorkspaceCreateResult, type WorkspacesNamespace, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };

package/dist/index.js

@@ -864,7 +864,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.193",
+  version: "0.3.194",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -4889,6 +4889,7 @@ var DeeplineClient = class _DeeplineClient {
     };
     this.billing = {
       topUp: (options2) => this.topUpBillingBalance(options2),
+      topUpWithReceipt: (options2) => this.topUpBillingBalanceWithReceipt(options2),
       plans: () => this.getBillingPlans(),
       subscription: {
         status: () => this.getBillingSubscriptionStatus(),
@@ -7519,6 +7520,22 @@ var DeeplineClient = class _DeeplineClient {
       { maxRetries: 0, exactUrlOnly: true }
     );
   }
+  /**
+   * Request a durable top-up operation receipt. A pending receipt does not
+   * imply that payment or credit activation has completed. Prefer
+   * `client.billing.topUpWithReceipt(...)`.
+   */
+  async topUpBillingBalanceWithReceipt(options) {
+    return this.http.post(
+      "/api/v2/billing/top-up",
+      {
+        credits: options.credits,
+        ...options.idempotencyKey ? { idempotency_key: options.idempotencyKey } : {}
+      },
+      { "x-deepline-top-up-receipt": "operation-v1" },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
   /**
    * Subscription state for the active workspace: active plan, whether a
    * Stripe subscription backs it, renewal/cancellation facts, and remaining

package/dist/index.mjs

@@ -768,7 +768,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.193",
+  version: "0.3.194",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -4793,6 +4793,7 @@ var DeeplineClient = class _DeeplineClient {
     };
     this.billing = {
       topUp: (options2) => this.topUpBillingBalance(options2),
+      topUpWithReceipt: (options2) => this.topUpBillingBalanceWithReceipt(options2),
       plans: () => this.getBillingPlans(),
       subscription: {
         status: () => this.getBillingSubscriptionStatus(),
@@ -7423,6 +7424,22 @@ var DeeplineClient = class _DeeplineClient {
       { maxRetries: 0, exactUrlOnly: true }
     );
   }
+  /**
+   * Request a durable top-up operation receipt. A pending receipt does not
+   * imply that payment or credit activation has completed. Prefer
+   * `client.billing.topUpWithReceipt(...)`.
+   */
+  async topUpBillingBalanceWithReceipt(options) {
+    return this.http.post(
+      "/api/v2/billing/top-up",
+      {
+        credits: options.credits,
+        ...options.idempotencyKey ? { idempotency_key: options.idempotencyKey } : {}
+      },
+      { "x-deepline-top-up-receipt": "operation-v1" },
+      { maxRetries: 0, exactUrlOnly: true }
+    );
+  }
   /**
    * Subscription state for the active workspace: active plan, whether a
    * Stripe subscription backs it, renewal/cancellation facts, and remaining

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.193";
+    readonly version: "0.3.194";
     readonly updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.d.ts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.193";
+    readonly version: "0.3.194";
     readonly updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.js

@@ -74,7 +74,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.193",
+  version: "0.3.194",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/release.mjs

@@ -48,7 +48,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.193",
+  version: "0.3.194",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.193",
+  "version": "0.3.194",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",