deepline 0.1.104 → 0.1.106

package/dist/index.d.mts

@@ -1371,6 +1371,148 @@ type RunsNamespace = {
         reason?: string;
     }) => Promise<StopPlayRunResult>;
 };
+/** One credit grant pool reported by the billing subscription status endpoint. */
+type BillingCreditPool = {
+    pool: string;
+    credits_remaining: number;
+    credits_granted: number;
+    source: string;
+    cycle_key: string | null;
+    effective_at: string;
+};
+/**
+ * Subscription state for the active workspace, from
+ * `GET /api/v2/billing/subscription/status`. All amounts are Deepline credits
+ * and Deepline-facing USD — never provider spend.
+ */
+type BillingSubscriptionStatus = {
+    org_id: string;
+    plan_version_id: string;
+    plan_name: string;
+    plan_family_id: string;
+    /** Whether a Stripe subscription backs the active plan. */
+    subscribed: boolean;
+    price_usd: number | null;
+    price_interval: string | null;
+    monthly_grant_credits: number;
+    assigned_by: string;
+    assigned_at: string | null;
+    credit_pools: BillingCreditPool[];
+    pooled_credits_remaining: number;
+    /** End of the current paid period (ISO timestamp), when Stripe is reachable. */
+    current_period_end: string | null;
+    /** True when a cancellation is already scheduled for period end. */
+    cancel_at_period_end: boolean | null;
+    stripe_status: string | null;
+};
+/**
+ * Result of `POST /api/v2/billing/subscription/cancel`. Cancellation is always
+ * at period end: the customer keeps the cycle they paid for and every
+ * remaining credit. `undo_cancel` reverses a pending cancellation.
+ */
+type BillingSubscriptionCancelResult = {
+    org_id: string;
+    subscription_id: string;
+    cancel_at_period_end: boolean;
+    current_period_end: string | null;
+    status: string;
+    message: string;
+};
+/**
+ * One customer-facing billing history entry from
+ * `GET /api/v2/billing/invoices`: a subscription invoice or a one-time credit
+ * purchase receipt. Amounts are what the customer paid — never provider spend.
+ */
+type BillingInvoiceEntry = {
+    kind: 'invoice' | 'receipt';
+    id: string;
+    created_at: string;
+    description: string;
+    amount_cents: number;
+    currency: string;
+    status: string;
+    /** Stripe-hosted page (invoice or card receipt). */
+    url: string | null;
+    /** Direct PDF when Stripe provides one (invoices only). */
+    pdf_url: string | null;
+};
+type BillingInvoicesResult = {
+    org_id: string;
+    entries: BillingInvoiceEntry[];
+};
+/** One published plan from `GET /api/v2/billing/catalog/current`. */
+type BillingPlanEntry = {
+    plan_family_id: string;
+    plan_version_id: string;
+    public_name: string;
+    price_usd: number | null;
+    price_interval: string | null;
+    monthly_grant_credits: number;
+    rollover: {
+        mode: string;
+        max_credits?: number;
+    };
+    /** Whether the plan can be purchased via subscription checkout. */
+    acquirable: boolean;
+};
+/** One usage metric published in the billing catalog. */
+type BillingMetricEntry = {
+    id: string;
+    name: string;
+};
+/** The caller's active plan as reported by the plans endpoint. */
+type BillingActivePlan = {
+    plan_family_id: string;
+    plan_version_id: string;
+    public_name: string;
+    rate_card_id: string;
+    assigned_by: string;
+    assigned_at: string | null;
+    has_subscription: boolean;
+};
+/**
+ * Published plans plus the caller's active plan, from
+ * `GET /api/v2/billing/catalog/current`. Answers "what plans exist and what
+ * am I on". All amounts are Deepline credits and Deepline-facing USD — never
+ * provider spend.
+ */
+type BillingPlansResult = {
+    catalog_id: string;
+    catalog_version: string;
+    active_plan: BillingActivePlan;
+    plans: BillingPlanEntry[];
+    metrics: BillingMetricEntry[];
+};
+/**
+ * Public billing namespace exposed as `client.billing`.
+ *
+ * Carries the durable Deepline billing product model — plans, subscription
+ * state, period-end cancellation, and invoice/receipt history — so CLI
+ * commands and programmatic callers share the same surface.
+ *
+ * @sdkReference client 030 client.billing
+ */
+type BillingNamespace = {
+    /** Published plans plus the plan you are on ("what plans exist and what am I on"). */
+    plans: () => Promise<BillingPlansResult>;
+    subscription: {
+        /** Active plan, Stripe subscription state, and remaining credit pools. */
+        status: () => Promise<BillingSubscriptionStatus>;
+        /**
+         * Schedule cancellation at period end (credits are kept), or reverse a
+         * pending cancellation with `{ undo: true }`.
+         */
+        cancel: (options?: {
+            undo?: boolean;
+        }) => Promise<BillingSubscriptionCancelResult>;
+    };
+    invoices: {
+        /** Subscription invoices plus credit purchase receipts, newest first. */
+        list: (options?: {
+            limit?: number;
+        }) => Promise<BillingInvoicesResult>;
+    };
+};
 /**
  * Low-level client for the Deepline REST API.
  *
@@ -1398,6 +1540,8 @@ declare class DeeplineClient {
     private readonly config;
     /** Canonical run lifecycle namespace backed by `/api/v2/runs`. */
     readonly runs: RunsNamespace;
+    /** Billing namespace: subscription status/cancel and invoice history. */
+    readonly billing: BillingNamespace;
     /**
      * Create a low-level SDK client.
      *
@@ -2131,6 +2275,45 @@ declare class DeeplineClient {
         /** Compatibility flag; active sibling runs are allowed. */
         force?: boolean;
     }): Promise<PlayRunResult>;
+    /**
+     * Published plans plus the caller's active plan: prices, monthly grant
+     * credits, rollover policy, and which plans are open for subscription.
+     * Prefer `client.billing.plans()`.
+     *
+     * @returns Snake_case catalog from `GET /api/v2/billing/catalog/current`
+     */
+    getBillingPlans(): Promise<BillingPlansResult>;
+    /**
+     * Subscription state for the active workspace: active plan, whether a
+     * Stripe subscription backs it, renewal/cancellation facts, and remaining
+     * Deepline credit pools. Prefer `client.billing.subscription.status()`.
+     *
+     * @returns Snake_case subscription status from `GET /api/v2/billing/subscription/status`
+     */
+    getBillingSubscriptionStatus(): Promise<BillingSubscriptionStatus>;
+    /**
+     * Schedule subscription cancellation at period end, or reverse a pending
+     * cancellation with `{ undo: true }`. The customer keeps the cycle they
+     * paid for and every remaining credit — cancellation never claws back
+     * credits. Prefer `client.billing.subscription.cancel(...)`.
+     *
+     * @throws {@link DeeplineError} with `statusCode: 409` when the workspace
+     *   has no active subscription, and `statusCode: 502` when Stripe rejects
+     *   the update (the server message is preserved).
+     */
+    cancelBillingSubscription(options?: {
+        undo?: boolean;
+    }): Promise<BillingSubscriptionCancelResult>;
+    /**
+     * Customer-facing billing history: subscription invoices plus one-time
+     * credit purchase receipts, newest first, with Stripe-hosted links.
+     * Prefer `client.billing.invoices.list(...)`.
+     *
+     * @param options.limit - Maximum entries to return (server clamps to 1–100, default 24).
+     */
+    listBillingInvoices(options?: {
+        limit?: number;
+    }): Promise<BillingInvoicesResult>;
     /**
      * Check API connectivity and server health.
      *
@@ -3916,4 +4099,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { AuthError, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_EXTRACTOR_TARGETS, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, type DeeplineEmailStatusGetterValue, DeeplineError, type DeeplineExtractorTarget, type DeeplineGetterValue, type DeeplineGetterValueMap, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FileInput, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, PHONE_STATUS_VALUES, 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 PhoneStatus, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PreviousCell, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, SDK_API_CONTRACT, SDK_VERSION, type StaleAfterSeconds, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, type ToolExecuteResult, type ToolExecution, type ToolExecutionRequest, type ToolMetadata, type ToolSearchOptions, type ToolSearchResult, defineInput, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isDeeplineExtractorTarget, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_EXTRACTOR_TARGETS, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, type DeeplineEmailStatusGetterValue, DeeplineError, type DeeplineExtractorTarget, type DeeplineGetterValue, type DeeplineGetterValueMap, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FileInput, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, PHONE_STATUS_VALUES, 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 PhoneStatus, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PreviousCell, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, SDK_API_CONTRACT, SDK_VERSION, type StaleAfterSeconds, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, type ToolExecuteResult, type ToolExecution, type ToolExecutionRequest, type ToolMetadata, type ToolSearchOptions, type ToolSearchResult, defineInput, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isDeeplineExtractorTarget, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };

package/dist/index.d.ts

@@ -1371,6 +1371,148 @@ type RunsNamespace = {
         reason?: string;
     }) => Promise<StopPlayRunResult>;
 };
+/** One credit grant pool reported by the billing subscription status endpoint. */
+type BillingCreditPool = {
+    pool: string;
+    credits_remaining: number;
+    credits_granted: number;
+    source: string;
+    cycle_key: string | null;
+    effective_at: string;
+};
+/**
+ * Subscription state for the active workspace, from
+ * `GET /api/v2/billing/subscription/status`. All amounts are Deepline credits
+ * and Deepline-facing USD — never provider spend.
+ */
+type BillingSubscriptionStatus = {
+    org_id: string;
+    plan_version_id: string;
+    plan_name: string;
+    plan_family_id: string;
+    /** Whether a Stripe subscription backs the active plan. */
+    subscribed: boolean;
+    price_usd: number | null;
+    price_interval: string | null;
+    monthly_grant_credits: number;
+    assigned_by: string;
+    assigned_at: string | null;
+    credit_pools: BillingCreditPool[];
+    pooled_credits_remaining: number;
+    /** End of the current paid period (ISO timestamp), when Stripe is reachable. */
+    current_period_end: string | null;
+    /** True when a cancellation is already scheduled for period end. */
+    cancel_at_period_end: boolean | null;
+    stripe_status: string | null;
+};
+/**
+ * Result of `POST /api/v2/billing/subscription/cancel`. Cancellation is always
+ * at period end: the customer keeps the cycle they paid for and every
+ * remaining credit. `undo_cancel` reverses a pending cancellation.
+ */
+type BillingSubscriptionCancelResult = {
+    org_id: string;
+    subscription_id: string;
+    cancel_at_period_end: boolean;
+    current_period_end: string | null;
+    status: string;
+    message: string;
+};
+/**
+ * One customer-facing billing history entry from
+ * `GET /api/v2/billing/invoices`: a subscription invoice or a one-time credit
+ * purchase receipt. Amounts are what the customer paid — never provider spend.
+ */
+type BillingInvoiceEntry = {
+    kind: 'invoice' | 'receipt';
+    id: string;
+    created_at: string;
+    description: string;
+    amount_cents: number;
+    currency: string;
+    status: string;
+    /** Stripe-hosted page (invoice or card receipt). */
+    url: string | null;
+    /** Direct PDF when Stripe provides one (invoices only). */
+    pdf_url: string | null;
+};
+type BillingInvoicesResult = {
+    org_id: string;
+    entries: BillingInvoiceEntry[];
+};
+/** One published plan from `GET /api/v2/billing/catalog/current`. */
+type BillingPlanEntry = {
+    plan_family_id: string;
+    plan_version_id: string;
+    public_name: string;
+    price_usd: number | null;
+    price_interval: string | null;
+    monthly_grant_credits: number;
+    rollover: {
+        mode: string;
+        max_credits?: number;
+    };
+    /** Whether the plan can be purchased via subscription checkout. */
+    acquirable: boolean;
+};
+/** One usage metric published in the billing catalog. */
+type BillingMetricEntry = {
+    id: string;
+    name: string;
+};
+/** The caller's active plan as reported by the plans endpoint. */
+type BillingActivePlan = {
+    plan_family_id: string;
+    plan_version_id: string;
+    public_name: string;
+    rate_card_id: string;
+    assigned_by: string;
+    assigned_at: string | null;
+    has_subscription: boolean;
+};
+/**
+ * Published plans plus the caller's active plan, from
+ * `GET /api/v2/billing/catalog/current`. Answers "what plans exist and what
+ * am I on". All amounts are Deepline credits and Deepline-facing USD — never
+ * provider spend.
+ */
+type BillingPlansResult = {
+    catalog_id: string;
+    catalog_version: string;
+    active_plan: BillingActivePlan;
+    plans: BillingPlanEntry[];
+    metrics: BillingMetricEntry[];
+};
+/**
+ * Public billing namespace exposed as `client.billing`.
+ *
+ * Carries the durable Deepline billing product model — plans, subscription
+ * state, period-end cancellation, and invoice/receipt history — so CLI
+ * commands and programmatic callers share the same surface.
+ *
+ * @sdkReference client 030 client.billing
+ */
+type BillingNamespace = {
+    /** Published plans plus the plan you are on ("what plans exist and what am I on"). */
+    plans: () => Promise<BillingPlansResult>;
+    subscription: {
+        /** Active plan, Stripe subscription state, and remaining credit pools. */
+        status: () => Promise<BillingSubscriptionStatus>;
+        /**
+         * Schedule cancellation at period end (credits are kept), or reverse a
+         * pending cancellation with `{ undo: true }`.
+         */
+        cancel: (options?: {
+            undo?: boolean;
+        }) => Promise<BillingSubscriptionCancelResult>;
+    };
+    invoices: {
+        /** Subscription invoices plus credit purchase receipts, newest first. */
+        list: (options?: {
+            limit?: number;
+        }) => Promise<BillingInvoicesResult>;
+    };
+};
 /**
  * Low-level client for the Deepline REST API.
  *
@@ -1398,6 +1540,8 @@ declare class DeeplineClient {
     private readonly config;
     /** Canonical run lifecycle namespace backed by `/api/v2/runs`. */
     readonly runs: RunsNamespace;
+    /** Billing namespace: subscription status/cancel and invoice history. */
+    readonly billing: BillingNamespace;
     /**
      * Create a low-level SDK client.
      *
@@ -2131,6 +2275,45 @@ declare class DeeplineClient {
         /** Compatibility flag; active sibling runs are allowed. */
         force?: boolean;
     }): Promise<PlayRunResult>;
+    /**
+     * Published plans plus the caller's active plan: prices, monthly grant
+     * credits, rollover policy, and which plans are open for subscription.
+     * Prefer `client.billing.plans()`.
+     *
+     * @returns Snake_case catalog from `GET /api/v2/billing/catalog/current`
+     */
+    getBillingPlans(): Promise<BillingPlansResult>;
+    /**
+     * Subscription state for the active workspace: active plan, whether a
+     * Stripe subscription backs it, renewal/cancellation facts, and remaining
+     * Deepline credit pools. Prefer `client.billing.subscription.status()`.
+     *
+     * @returns Snake_case subscription status from `GET /api/v2/billing/subscription/status`
+     */
+    getBillingSubscriptionStatus(): Promise<BillingSubscriptionStatus>;
+    /**
+     * Schedule subscription cancellation at period end, or reverse a pending
+     * cancellation with `{ undo: true }`. The customer keeps the cycle they
+     * paid for and every remaining credit — cancellation never claws back
+     * credits. Prefer `client.billing.subscription.cancel(...)`.
+     *
+     * @throws {@link DeeplineError} with `statusCode: 409` when the workspace
+     *   has no active subscription, and `statusCode: 502` when Stripe rejects
+     *   the update (the server message is preserved).
+     */
+    cancelBillingSubscription(options?: {
+        undo?: boolean;
+    }): Promise<BillingSubscriptionCancelResult>;
+    /**
+     * Customer-facing billing history: subscription invoices plus one-time
+     * credit purchase receipts, newest first, with Stripe-hosted links.
+     * Prefer `client.billing.invoices.list(...)`.
+     *
+     * @param options.limit - Maximum entries to return (server clamps to 1–100, default 24).
+     */
+    listBillingInvoices(options?: {
+        limit?: number;
+    }): Promise<BillingInvoicesResult>;
     /**
      * Check API connectivity and server health.
      *
@@ -3916,4 +4099,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { AuthError, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_EXTRACTOR_TARGETS, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, type DeeplineEmailStatusGetterValue, DeeplineError, type DeeplineExtractorTarget, type DeeplineGetterValue, type DeeplineGetterValueMap, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FileInput, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, PHONE_STATUS_VALUES, 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 PhoneStatus, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PreviousCell, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, SDK_API_CONTRACT, SDK_VERSION, type StaleAfterSeconds, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, type ToolExecuteResult, type ToolExecution, type ToolExecutionRequest, type ToolMetadata, type ToolSearchOptions, type ToolSearchResult, defineInput, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isDeeplineExtractorTarget, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
+export { AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_EXTRACTOR_TARGETS, DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, type DeeplineEmailStatusGetterValue, DeeplineError, type DeeplineExtractorTarget, type DeeplineGetterValue, type DeeplineGetterValueMap, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FileInput, JOB_CHANGE_STATUS_VALUES, type JobChangeStatus, type LiveEventEnvelope, PHONE_STATUS_VALUES, 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 PhoneStatus, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayDataset, type PlayDatasetInput, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PreviousCell, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, SDK_API_CONTRACT, SDK_VERSION, type StaleAfterSeconds, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, type ToolExecuteResult, type ToolExecution, type ToolExecutionRequest, type ToolMetadata, type ToolSearchOptions, type ToolSearchResult, defineInput, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isDeeplineExtractorTarget, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };

package/dist/index.js

@@ -267,10 +267,13 @@ var SDK_RELEASE = {
   // scrubbing, and word-boundary watch truncation.
   // 0.1.103 ships the refined SDK CLI command surface.
   // 0.1.104 ships postgres_fast suspension/billing parity and runtime worker hardening.
-  version: "0.1.104",
+  // 0.1.105 ships the billing catalog surface: billing plans, subscribe,
+  // subscription status/cancel, invoices, and the client.billing namespace.
+  // 0.1.106 ships play cell provenance metadata and v2 preview retry hardening.
+  version: "0.1.106",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.104",
+    latest: "0.1.106",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }
@@ -401,7 +404,7 @@ var HttpClient = class {
             signal: controller.signal
           });
           clearTimeout(timeoutId);
-          if (response.status === 401 || response.status === 403) {
+          if (response.status === 401 || response.status === 403 && !options?.forbiddenAsApiError) {
             throw new AuthError();
           }
           if (response.status === 429) {
@@ -1493,6 +1496,9 @@ var INCLUDE_TOOL_METADATA_HEADER = "x-deepline-include-tool-metadata";
 var EXECUTE_RESPONSE_CONTRACT_HEADER = "x-deepline-execute-response-contract";
 var V2_EXECUTE_RESPONSE_CONTRACT = "v2-tool-response";
 var COMPILE_MANIFEST_RETRY_DELAYS_MS = [250, 1e3];
+var REGISTER_PLAY_ARTIFACTS_COMPILE_CONCURRENCY = 3;
+var REGISTER_PLAY_ARTIFACTS_MAX_BATCH_COUNT = 3;
+var REGISTER_PLAY_ARTIFACTS_MAX_BATCH_BYTES = 25e5;
 function sleep2(ms) {
   return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
@@ -1505,6 +1511,45 @@ function isTransientCompileManifestError(error) {
     message
   );
 }
+async function mapWithConcurrency(items, concurrency, mapper) {
+  const results = new Array(items.length);
+  let nextIndex = 0;
+  const workerCount = Math.min(Math.max(1, concurrency), items.length);
+  await Promise.all(
+    Array.from({ length: workerCount }, async () => {
+      for (; ; ) {
+        const index = nextIndex;
+        nextIndex += 1;
+        if (index >= items.length) {
+          return;
+        }
+        results[index] = await mapper(items[index], index);
+      }
+    })
+  );
+  return results;
+}
+function jsonUtf8Bytes(value) {
+  return new TextEncoder().encode(JSON.stringify(value)).length;
+}
+function chunkRegisterPlayArtifacts(artifacts) {
+  const chunks = [];
+  let current = [];
+  for (const artifact of artifacts) {
+    const candidate = [...current, artifact];
+    const candidateTooLarge = candidate.length > REGISTER_PLAY_ARTIFACTS_MAX_BATCH_COUNT || jsonUtf8Bytes({ artifacts: candidate }) > REGISTER_PLAY_ARTIFACTS_MAX_BATCH_BYTES;
+    if (current.length > 0 && candidateTooLarge) {
+      chunks.push(current);
+      current = [artifact];
+    } else {
+      current = candidate;
+    }
+  }
+  if (current.length > 0) {
+    chunks.push(current);
+  }
+  return chunks;
+}
 var RUN_LOGS_PAGE_LIMIT = 1e3;
 function isRecord2(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
@@ -1672,6 +1717,8 @@ var DeeplineClient = class {
   config;
   /** Canonical run lifecycle namespace backed by `/api/v2/runs`. */
   runs;
+  /** Billing namespace: subscription status/cancel and invoice history. */
+  billing;
   /**
    * Create a low-level SDK client.
    *
@@ -1692,6 +1739,16 @@ var DeeplineClient = class {
       exportDatasetRows: (input) => this.getPlaySheetRows(input),
       stop: (runId, options2) => this.stopRun(runId, options2)
     };
+    this.billing = {
+      plans: () => this.getBillingPlans(),
+      subscription: {
+        status: () => this.getBillingSubscriptionStatus(),
+        cancel: (options2) => this.cancelBillingSubscription(options2)
+      },
+      invoices: {
+        list: (options2) => this.listBillingInvoices(options2)
+      }
+    };
   }
   /** The resolved base URL this client is targeting (e.g. `"http://localhost:3000"`). */
   get baseUrl() {
@@ -2060,8 +2117,13 @@ var DeeplineClient = class {
    * first when a compiler manifest is not already supplied.
    */
   async registerPlayArtifacts(artifacts) {
-    const compiledArtifacts = await Promise.all(
-      artifacts.map(async (artifact) => ({
+    if (artifacts.length === 0) {
+      return this.http.post("/api/v2/plays/artifacts", { artifacts });
+    }
+    const compiledArtifacts = await mapWithConcurrency(
+      artifacts,
+      REGISTER_PLAY_ARTIFACTS_COMPILE_CONCURRENCY,
+      async (artifact) => ({
         ...artifact,
         compilerManifest: artifact.compilerManifest ?? await this.compilePlayManifest({
           name: artifact.name,
@@ -2069,11 +2131,20 @@ var DeeplineClient = class {
           sourceFiles: artifact.sourceFiles,
           artifact: artifact.artifact
         })
-      }))
+      })
     );
-    return this.http.post("/api/v2/plays/artifacts", {
-      artifacts: compiledArtifacts
-    });
+    const responses = [];
+    for (const chunk of chunkRegisterPlayArtifacts(compiledArtifacts)) {
+      responses.push(
+        await this.http.post("/api/v2/plays/artifacts", {
+          artifacts: chunk
+        })
+      );
+    }
+    return {
+      success: responses.every((response) => response.success),
+      artifacts: responses.flatMap((response) => response.artifacts)
+    };
   }
   /**
    * Compile a bundled play artifact into the server-side compiler manifest.
@@ -3046,6 +3117,61 @@ var DeeplineClient = class {
   // ——————————————————————————————————————————————————————————
   // Health
   // ——————————————————————————————————————————————————————————
+  /**
+   * Published plans plus the caller's active plan: prices, monthly grant
+   * credits, rollover policy, and which plans are open for subscription.
+   * Prefer `client.billing.plans()`.
+   *
+   * @returns Snake_case catalog from `GET /api/v2/billing/catalog/current`
+   */
+  async getBillingPlans() {
+    return this.http.get("/api/v2/billing/catalog/current");
+  }
+  /**
+   * Subscription state for the active workspace: active plan, whether a
+   * Stripe subscription backs it, renewal/cancellation facts, and remaining
+   * Deepline credit pools. Prefer `client.billing.subscription.status()`.
+   *
+   * @returns Snake_case subscription status from `GET /api/v2/billing/subscription/status`
+   */
+  async getBillingSubscriptionStatus() {
+    return this.http.get(
+      "/api/v2/billing/subscription/status"
+    );
+  }
+  /**
+   * Schedule subscription cancellation at period end, or reverse a pending
+   * cancellation with `{ undo: true }`. The customer keeps the cycle they
+   * paid for and every remaining credit — cancellation never claws back
+   * credits. Prefer `client.billing.subscription.cancel(...)`.
+   *
+   * @throws {@link DeeplineError} with `statusCode: 409` when the workspace
+   *   has no active subscription, and `statusCode: 502` when Stripe rejects
+   *   the update (the server message is preserved).
+   */
+  async cancelBillingSubscription(options) {
+    return this.http.post(
+      "/api/v2/billing/subscription/cancel",
+      { action: options?.undo ? "undo_cancel" : "cancel" }
+    );
+  }
+  /**
+   * Customer-facing billing history: subscription invoices plus one-time
+   * credit purchase receipts, newest first, with Stripe-hosted links.
+   * Prefer `client.billing.invoices.list(...)`.
+   *
+   * @param options.limit - Maximum entries to return (server clamps to 1–100, default 24).
+   */
+  async listBillingInvoices(options) {
+    const params = new URLSearchParams();
+    if (options?.limit !== void 0) {
+      params.set("limit", String(options.limit));
+    }
+    const suffix = Array.from(params).length > 0 ? `?${params.toString()}` : "";
+    return this.http.get(
+      `/api/v2/billing/invoices${suffix}`
+    );
+  }
   /**
    * Check API connectivity and server health.
    *