deepline 0.3.89 → 0.3.91

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 /// <reference path="./text-imports.d.ts" />
-import { c as PlayCompilerManifest, A as AsyncPlayRunRef$1, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, T as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringAsyncCallOptions, y as PlayAuthoringBindings, z as PlayAuthoringCallExecution, B as PlayAuthoringCallOptions, C as PlayAuthoringFetchResponse, D as PlayAuthoringInputContract, E as PlayRunId$1, F as PlayAuthoringStepProgramStep, G as PlayAuthoringRuntimeStepOptions, H as PlaySqlListenerDeclaration, I as PlaySqlListenerEvent, J as PlaySqlListenerOperation, K as PlaySqlQuery, L as PlayAuthoringStepOptions, M as PlayAuthoringStepProgram, N as PlayAuthoringStepProgramResolver, O as PlayAuthoringStepResolver, Q as PlayToolExecutionRequest, R as PlayAuthoringStepProgramOptions, S as DeeplineError, U as ToolExecutionError, V as ToolExecutionErrorOptions } from './compiler-manifest-DsLbQaew.js';
-export { W as CtxFetchHttpError, X as DEEPLINE_EXTRACTOR_TARGETS, Y as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, Z as DeeplineEmailStatusGetterValue, _ as DeeplineExtractorTarget, $ as DeeplineGetterValue, a0 as DeeplineGetterValueMap, a1 as JOB_CHANGE_STATUS_VALUES, a2 as JobChangeStatus, a3 as PHONE_STATUS_VALUES, a4 as PhoneStatus, a5 as PlayDataset, a6 as PlayDatasetInput, a7 as PreviousCell, a8 as ProviderTransientError, a9 as ProviderTransientErrorCategory, aa as ProviderUnavailableError, ab as ProviderUnavailableReason, ac as ToolExecutionErrorCategory, ad as ToolExecutionErrorOrigin, ae as ToolExecutionFailureV1, af as ToolExecutionNetworkKind, ag as ToolExecutionNetworkScope, ah as ToolExecutionPublicDetails, ai as getProviderUnavailableReason, aj as isDeeplineExtractorTarget, ak as isProviderUnavailable, al as isProviderWaterfallUnavailableError } from './compiler-manifest-DsLbQaew.js';
+import { c as PlayCompilerManifest, A as AsyncPlayRunRef$1, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, T as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringAsyncCallOptions, y as PlayAuthoringBindings, z as PlayAuthoringCallExecution, B as PlayAuthoringCallOptions, C as PlayAuthoringFetchResponse, D as PlayAuthoringInputContract, E as PlayRunId$1, F as PlayAuthoringStepProgramStep, G as PlayAuthoringRuntimeStepOptions, H as PlaySqlListenerDeclaration, I as PlaySqlListenerEvent, J as PlaySqlListenerOperation, K as PlaySqlQuery, L as PlayAuthoringStepOptions, M as PlayAuthoringStepProgram, N as PlayAuthoringStepProgramResolver, O as PlayAuthoringStepResolver, Q as PlayToolExecutionRequest, R as PlayAuthoringStepProgramOptions, S as DeeplineError, U as ToolExecutionError, V as ToolExecutionErrorOptions } from './compiler-manifest-x14KL83E.js';
+export { W as CtxFetchHttpError, X as DEEPLINE_EXTRACTOR_TARGETS, Y as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, Z as DeeplineEmailStatusGetterValue, _ as DeeplineExtractorTarget, $ as DeeplineGetterValue, a0 as DeeplineGetterValueMap, a1 as JOB_CHANGE_STATUS_VALUES, a2 as JobChangeStatus, a3 as PHONE_STATUS_VALUES, a4 as PhoneStatus, a5 as PlayDataset, a6 as PlayDatasetInput, a7 as PreviousCell, a8 as ProviderTransientError, a9 as ProviderTransientErrorCategory, aa as ProviderUnavailableError, ab as ProviderUnavailableReason, ac as ToolExecutionErrorCategory, ad as ToolExecutionErrorOrigin, ae as ToolExecutionFailureV1, af as ToolExecutionNetworkKind, ag as ToolExecutionNetworkScope, ah as ToolExecutionPublicDetails, ai as getProviderUnavailableReason, aj as isDeeplineExtractorTarget, ak as isProviderUnavailable, al as isProviderWaterfallUnavailableError } from './compiler-manifest-x14KL83E.js';
+import { MonitorFleetDefinition } from './monitor-fleet-contract.js';
+export { AdmittedMonitorFleetAuthoringContract, MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG, MONITOR_FLEET_AUTHORING_CONTRACT_EDITION, MONITOR_FLEET_DOCUMENTATION, MONITOR_FLEET_FRONTIER_MAX_ROWS, MONITOR_FLEET_MAX_MEMBERS, MonitorFleetAuthoringContractEdition, MonitorFleetAuthoringContractResult, MonitorFleetColumn, MonitorFleetContractIssue, MonitorFleetExpression, MonitorFleetTemplate, admitMonitorFleetAuthoringContract, defineMonitorFleet, fleetColumn, fleetKey, validateMonitorFleetDefinition } from './monitor-fleet-contract.js';
 import '@sinclair/typebox';
 
 type ProductNotificationFactValue = string | number | boolean;
@@ -40,7 +42,7 @@ type ProductNotificationTrigger = {
 type ProductNotificationDeliveryTiming = {
     mode: 'immediate';
 } | {
-    mode: 'immediate_first' | 'digest_only';
+    mode: 'immediate_first' | 'digest_only' | 'rolling_limit';
     windowMs: number;
 };
 type ProductNotificationRepeatMode = 'on_enter' | 'every_match';
@@ -157,6 +159,11 @@ type FixtureBehaviorV3 = {
 };
 type FixtureBehavior = FixtureBehaviorV1 | FixtureBehaviorV2 | FixtureBehaviorV3;
 
+type PlayGrepMatch = {
+    field: 'name' | 'description' | 'provider' | 'source';
+    terms: string[];
+};
+
 declare const PLAY_RUNTIME_BACKENDS: {
     readonly localProcess: "local_process";
     readonly daytona: "daytona";
@@ -1395,6 +1402,9 @@ type PlayRunDatasetActions = {
     };
     exportCsv?: PlayRunExportAction & {
         scope?: {
+            kind: 'database';
+            mutability: 'current';
+        } | {
             kind: 'run';
             runId: string;
         };
@@ -1891,6 +1901,21 @@ interface PlayDefinitionDetail {
     /** Compatibility field for older readers. */
     currentPublishedVersion?: number | null;
 }
+type PlayCostEstimate = {
+    status: 'available';
+    source: 'observed' | 'static';
+    unit: 'row' | 'run';
+    lowCredits: number;
+    highCredits: number;
+    sampleRunCount: number;
+    basedOnRunId: string | null;
+    modelVersion: string;
+} | {
+    status: 'unavailable';
+    reason: 'ambiguous_output_unit' | 'unbounded_loop' | 'unresolved_tool' | 'mixed_run_and_row_costs';
+    message: string;
+    modelVersion: string;
+};
 interface PlayListItem {
     playKey?: string;
     reference?: string;
@@ -1920,6 +1945,9 @@ interface PlayListItem {
     liveRevision?: PlayRevisionSummary | null;
     aliases?: string[];
     triggerStatus?: PlayTriggerStatus;
+    costEstimate?: PlayCostEstimate;
+    /** Indexed fields that matched a grep query. */
+    matches?: PlayGrepMatch[];
 }
 /** Additive live trigger state shared by list, get, and describe. */
 interface PlayTriggerStatus {
@@ -2602,134 +2630,6 @@ type MonitorControls = {
  */
 declare function defineMonitor<TPayload extends MonitorPayload = MonitorPayload>(definition: MonitorDefinition<TPayload>): MonitorDefinition<TPayload>;
 
-/**
- * The fleet member ceiling, mirrored — deliberately a literal.
- *
- * The canonical declaration is packages/monitors/monitor-fleet-limits.ts,
- * which the Convex commit mutation reads to size its transaction. This package
- * cannot import it: the workspace-architecture ratchet forbids NEW shared_libs
- * imports from packages absolutely (only relocations of pre-existing edges
- * pass CI), because shared_libs is being migrated into workspace packages.
- * Until a monitors package exists, the two copies are held equal by
- * tests/lib/monitors/monitor-fleet-limits-mirror.test.ts — change one without
- * the other and that test names both files.
- */
-declare const MONITOR_FLEET_MAX_MEMBERS = 1000;
-declare const MONITOR_FLEET_FRONTIER_MAX_ROWS = 10000;
-/**
- * Fleet definitions are admitted once and executed many times.  Keep the
- * edition beside the definition just as Plays keep their authoring-contract
- * edition: a future syntax change can add a reader without reinterpreting a
- * stored Fleet under new rules.
- */
-declare const MONITOR_FLEET_AUTHORING_CONTRACT_EDITION: 1;
-declare const SUPPORTED_MONITOR_FLEET_AUTHORING_CONTRACT_EDITIONS: readonly [1];
-type MonitorFleetAuthoringContractEdition = (typeof SUPPORTED_MONITOR_FLEET_AUTHORING_CONTRACT_EDITIONS)[number];
-declare const MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG: readonly [{
-    readonly edition: 1;
-    readonly changed: "Initial Fleet JSON contract: bounded sticky table membership, one daily sync, and a seven-day removal grace.";
-    readonly compatibilityOwner: "Monitors Runtime";
-    readonly newWritesEnd: null;
-    readonly readerRemoval: null;
-}];
-/**
- * Public, machine-readable guidance for every Monitor Fleet authoring
- * surface. SDK clients may render this directly; the CLI uses the same fixed
- * policy values in its help rather than maintaining another contract.
- */
-declare const MONITOR_FLEET_DOCUMENTATION: {
-    readonly summary: "A Monitor Fleet keeps one bounded, sticky set of ordinary monitors aligned with Customer DB rows.";
-    readonly authoredFields: {
-        readonly id: "Stable lowercase fleet id used by sync, get, and deactivate.";
-        readonly source: "Customer DB table, unique row key, and optional equality filters that select candidate rows.";
-        readonly member: "Ordinary monitor tool, stable key template, and payload evaluated for each selected source row.";
-        readonly selection: "Deterministic ranking and an active-member limit between 1 and 1,000.";
-    };
-    readonly fixedPolicy: {
-        readonly cadence: "daily";
-        readonly membership: "sticky";
-        readonly removalGrace: "7d";
-        readonly onRemoved: "deactivate";
-        readonly ownership: "A Fleet may adopt a same-tool ordinary monitor with its deterministic member key. The first Fleet claim wins; another Fleet or a different tool receives a conflict.";
-        readonly billing: "No Fleet fee, permit, or renewal. Dry-run reports ordinary monitor lifecycle charges due now.";
-    };
-    readonly stickyMembership: "Ranking fills vacancies but never replaces a current member merely because another row ranks higher.";
-    readonly columnExpression: "Use { \"$fleet\": \"column\", \"name\": \"column_name\" } in a member key or payload to read a value from each source row.";
-};
-type MonitorFleetColumn = {
-    $fleet: 'column';
-    name: string;
-};
-type MonitorFleetTemplate = {
-    $fleet: 'template';
-    parts: Array<string | MonitorFleetColumn>;
-};
-type MonitorFleetExpression = MonitorFleetColumn | MonitorFleetTemplate;
-type MonitorFleetDefinition = {
-    /** Stable lowercase fleet id, used by CLI and API lifecycle commands. */
-    id: string;
-    /** Customer DB rows that may become members. */
-    source: {
-        kind: 'customer_db_table';
-        schema: string;
-        table: string;
-        key: {
-            column: string;
-            type: 'text' | 'uuid' | 'int4' | 'int8';
-        };
-        where?: Record<string, string | number | boolean | null>;
-    };
-    /** One ordinary monitor definition, evaluated once for each selected row. */
-    member: {
-        tool: string;
-        key: MonitorFleetTemplate;
-        payload: Record<string, unknown>;
-    };
-    /**
-     * Bounded deterministic candidate selection. Membership is intentionally
-     * sticky: ranking chooses vacant slots but does not replace existing members
-     * merely because another row's score changed.
-     */
-    selection: {
-        limit: number;
-        orderBy: Array<{
-            column: string;
-            direction: 'asc' | 'desc';
-        }>;
-        membership: 'sticky';
-    };
-};
-type MonitorFleetContractIssue = {
-    path: string;
-    code: string;
-    message: string;
-};
-/** The durable, validated snapshot that a Fleet sync is allowed to execute. */
-type AdmittedMonitorFleetAuthoringContract = {
-    edition: MonitorFleetAuthoringContractEdition;
-    definition: MonitorFleetDefinition;
-};
-type MonitorFleetAuthoringContractResult = {
-    valid: boolean;
-    contract?: AdmittedMonitorFleetAuthoringContract;
-    issues: MonitorFleetContractIssue[];
-};
-declare function fleetColumn(name: string): MonitorFleetColumn;
-declare function fleetKey(...parts: Array<string | MonitorFleetColumn>): MonitorFleetTemplate;
-declare function defineMonitorFleet<const T extends MonitorFleetDefinition>(definition: T): T;
-declare function validateMonitorFleetDefinition(value: unknown): {
-    valid: boolean;
-    definition?: MonitorFleetDefinition;
-    issues: MonitorFleetContractIssue[];
-};
-/**
- * Compile JSON into the exact authoring snapshot persisted by a Fleet.  This
- * does not inspect the Customer DB or provider; use
- * `fleets sync --file <fleet.json> --dry-run` for that environment-aware
- * preflight, which returns the real plan and the credits due.
- */
-declare function admitMonitorFleetAuthoringContract(value: unknown, edition?: number): MonitorFleetAuthoringContractResult;
-
 interface PlayStagedFileRef {
     storageKind: 'r2';
     storageKey: string;
@@ -2931,6 +2831,32 @@ type RunsListOptions = {
     /** Zero-based page offset. Requires `play` because status-only inventory is not paginated. */
     offset?: number;
 };
+/** One server page; legacy runs.list continues to return an array. */
+type RunsListPage = {
+    runs: PlayRunListItem[];
+    total?: number;
+    offset?: number;
+    limit?: number;
+    hasMore?: boolean;
+};
+type PlaysListOptions = {
+    origin?: 'prebuilt' | 'owned';
+    grep?: string;
+    /**
+     * @deprecated Grep is always evaluated by the Convex full-text index.
+     * This retained option is ignored for source compatibility.
+     */
+    grepMode?: 'all' | 'any' | 'phrase';
+    categories?: string | string[];
+    includeToolCategories?: boolean;
+    includeArchived?: boolean;
+    includeCostEstimates?: boolean;
+};
+type PlaysListPage = {
+    plays: PlayListItem[];
+    cursor: string | null;
+    hasMore: boolean;
+};
 /** Options for `client.runs.get(...)`. */
 type RunsGetOptions = {
     /** Return the raw status payload instead of the compact package. */
@@ -3033,6 +2959,7 @@ type PlaySecretMetadata = {
     scope: 'org' | 'play';
     playName?: string;
     name: string;
+    note?: string;
     status: string;
     hasValue: boolean;
     createdAt: number;
@@ -3047,11 +2974,8 @@ type PlaySecretCheck = {
     secret: PlaySecretMetadata | null;
 };
 /**
- * Public runs namespace exposed as `client.runs`.
- *
- * This namespace mirrors the canonical `/api/v2/runs` resource family and is
- * the preferred low-level surface for polling, streaming, stopping, reading
- * logs, and exporting durable dataset rows.
+ * `client.runs` mirrors `/api/v2/runs`: the preferred low-level surface for
+ * polling, streaming, stopping, reading logs, and exporting durable dataset rows.
  *
  * @sdkReference client 020 client.runs
  */
@@ -3079,6 +3003,8 @@ type RunsNamespace = {
     }>;
     /** List runs for one play, optionally filtered by status. */
     list: (options: RunsListOptions) => Promise<PlayRunListItem[]>;
+    /** Read one run page with total, offset, limit and completeness metadata. */
+    listPage: (options: RunsListOptions) => Promise<RunsListPage>;
     /** Stream run events and return the latest/terminal run status. */
     tail: (runId: string, options?: RunsTailOptions) => Promise<PlayStatus>;
     /** Fetch persisted log lines for a run. */
@@ -3350,7 +3276,7 @@ type MonitorBatchOperationResult = {
     rejoined?: boolean;
     operation: {
         runId: string;
-        kind: 'audit' | 'deactivate' | 'reactivate' | 'deploy' | 'repair';
+        kind: 'audit' | 'converge' | 'deactivate' | 'reactivate' | 'deploy' | 'repair';
         state: 'running' | 'retry_scheduled' | 'completed' | 'failed';
         dryRun: boolean;
         scope: unknown;
@@ -3432,6 +3358,11 @@ type MonitorsHealth = {
     };
     converged: number;
     needs_repair: number;
+    /**
+     * Unknown records without an upstream resource id. Use the exact inventory
+     * reconciler to align them; ordinary repair never guesses an identity.
+     */
+    alignment_required: number;
     /** Observed active, but nothing delivered inside `silent_window_days`. */
     silent: number;
     silent_window_days: number;
@@ -3451,12 +3382,21 @@ type MonitorsHealth = {
     /** Bounded current durable monitor work, if the server supports it. */
     batch_operations?: Array<{
         run_id: string;
-        kind: 'audit' | 'deactivate' | 'reactivate' | 'repair' | 'deploy';
+        kind: 'audit' | 'converge' | 'deactivate' | 'reactivate' | 'repair' | 'deploy';
         state: 'running' | 'retry_scheduled';
         updated_at: number;
         next_attempt_at?: number;
         summary?: Record<string, unknown>;
     }>;
+    /** Bounded sample explaining why normal audit did not settle the row. */
+    unaudited_monitors: Array<{
+        monitor_key: string;
+        tool: string;
+        observed: 'unknown' | null;
+        observed_at: number | null;
+        provider_resource_id: string | null;
+        reason: 'not_yet_audited' | 'missing_provider_resource_id' | 'provider_observation_unknown';
+    }>;
 };
 /** One bounded audit pass, from `POST /api/v2/monitors/audit`. */
 type MonitorsAuditResult = {
@@ -3592,6 +3532,8 @@ type MonitorsNamespace = {
 };
 /** One credit grant pool reported by the billing subscription status endpoint. */
 type BillingCreditPool = {
+    /** Stable grant identity; optional when talking to an older server. */
+    grant_id?: string;
     pool: string;
     credits_remaining: number;
     credits_granted: number;
@@ -3670,12 +3612,13 @@ type TargetBillingOperation = {
     next_action?: string | null;
 };
 type TargetBillingPlan = {
-    sku: 'payg-v1' | 'builder-v1' | 'team-v1';
+    sku: 'payg-v1' | 'builder-v1' | 'growth-v1' | 'growth-canary-v1' | 'team-v1';
     name: string;
     recurring_price_usd: number;
-    interval: 'month';
+    interval: 'month' | 'year';
     included_credits: number;
     purchased_credit_price_usd: number;
+    acquisition_enabled: boolean;
 };
 type TargetBillingPlansResult = {
     org_id: string;
@@ -3683,6 +3626,7 @@ type TargetBillingPlansResult = {
     current_plan_sku: string;
     pending_plan_sku: string | null;
     acquisition_enabled: boolean;
+    enabled_offer_keys: TargetBillingPlan['sku'][];
 };
 type TargetBillingStatusResult = {
     org_id: string;
@@ -3710,6 +3654,8 @@ type TargetAutoRechargeResult = {
     threshold_credits: number | null;
     refill_to_credits: number | null;
     rolling_limit_cents: null;
+    purchase_limit_cents?: number | null;
+    rolling_committed_cents?: number;
 };
 type TargetAutoRechargeUpdateOptions = {
     enabled: false;
@@ -3718,6 +3664,8 @@ type TargetAutoRechargeUpdateOptions = {
     enabled: true;
     thresholdCredits: number;
     refillToCredits: number;
+    /** Maximum automatic purchases in a rolling 30-day window, in USD cents. */
+    purchaseLimitCents?: number | null;
     idempotencyKey: string;
 };
 type TargetBillingMutationResult = {
@@ -3829,10 +3777,8 @@ type WorkspacesNamespace = {
     }) => Promise<WorkspaceCreateResult>;
 };
 /**
- * Public billing namespace exposed as `client.billing`.
- *
- * Carries plans, subscription state, cancellation, and invoice/receipt history
- * so CLI commands and programmatic callers share one surface.
+ * Public `client.billing` namespace for CLI commands and programmatic callers.
+ * Covers plans, subscription state, cancellation, and invoice/receipt history.
  *
  * @sdkReference client 030 client.billing
  */
@@ -3868,6 +3814,14 @@ type BillingNamespace = {
     /** Read and manage the Metronome-backed automatic recharge configuration. */
     autoRecharge: {
         get: () => Promise<TargetAutoRechargeResult>;
+        trigger: (options?: {
+            idempotencyKey: string;
+        }) => Promise<{
+            data: {
+                status: string;
+                operation_id?: string;
+            };
+        }>;
         update: (options: TargetAutoRechargeUpdateOptions) => Promise<TargetAutoRechargeResult>;
     };
     /** Buy Deepline credits through a payment-gated Metronome commit. */
@@ -3875,6 +3829,12 @@ type BillingNamespace = {
         credits: number;
         idempotencyKey: string;
     }) => Promise<TargetBillingMutationResult>;
+    /** Inspect or retire the original purchase intent without starting a payment. */
+    recoverCreditPurchase: (options: {
+        credits: number;
+        orgId: string;
+        idempotencyKey: string;
+    }) => Promise<TargetBillingMutationResult>;
     /** Start, change, cancel, or undo a target plan transition. */
     transitionPlan: (options: TargetBillingPlanTransitionOptions) => Promise<TargetBillingMutationResult>;
     /** Create a Stripe-hosted billing Portal session. */
@@ -3965,6 +3925,8 @@ declare class DeeplineClient {
     inspectSecret(name: string, options?: {
         playName?: string;
     }): Promise<PlaySecretCheck>;
+    /** Add, replace, or clear the non-sensitive note attached to one secret. */
+    updateSecretNote(secretId: string, note: string): Promise<PlaySecretMetadata>;
     /**
      * List all available tools.
      *
@@ -4499,6 +4461,8 @@ declare class DeeplineClient {
      * ```
      */
     listRuns(options: RunsListOptions): Promise<PlayRunListItem[]>;
+    /** Read one run page without discarding server pagination metadata. */
+    listRunsPage(options: RunsListOptions): Promise<RunsListPage>;
     /**
      * Observe one run's live events. Uses the Convex Run Snapshot subscription
      * transport first (ADR-0008), then falls back to the canonical SSE stream
@@ -4603,19 +4567,19 @@ declare class DeeplineClient {
         reason?: string;
     }): Promise<StopAllPlayRunsResult>;
     /**
-     * List callable plays visible to the workspace.
+     * List one page of callable plays; grep retains exhaustive matching results.
+     * Use listPlaysPage to retain pagination metadata.
      *
      * Pass `origin: "prebuilt"` for Deepline-managed prebuilts or
      * `origin: "owned"` for org-owned plays.
      */
-    listPlays(options?: {
-        origin?: 'prebuilt' | 'owned';
-        grep?: string;
-        grepMode?: 'all' | 'any' | 'phrase';
-        categories?: string | string[];
-        includeToolCategories?: boolean;
-        includeArchived?: boolean;
-    }): Promise<PlayListItem[]>;
+    listPlays(options?: PlaysListOptions): Promise<PlayListItem[]>;
+    /** Read one bounded inventory page; cursor continues the same filters. */
+    listPlaysPage(options?: PlaysListOptions & {
+        limit?: number;
+        cursor?: string | null;
+    }): Promise<PlaysListPage>;
+    private requestPlaysPage;
     /** Set whether an org-owned Play sorts before unpinned Plays. */
     setPlayPinned(playName: string, pinned: boolean): Promise<{
         name: string;
@@ -4941,6 +4905,12 @@ declare class DeeplineClient {
         credits: number;
         idempotencyKey: string;
     }): Promise<TargetBillingMutationResult>;
+    /** Recover only the original workspace, credit amount, and purchase key; never charge. */
+    recoverTargetBillingCreditPurchase(options: {
+        credits: number;
+        orgId: string;
+        idempotencyKey: string;
+    }): Promise<TargetBillingMutationResult>;
     /**
      * Start, change, cancel, or restore a target plan through one idempotent
      * commercial operation.
@@ -6061,4 +6031,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { type AdmittedMonitorFleetAuthoringContract, type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, 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 DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LiveEventEnvelope, MONITOR_FLEET_AUTHORING_CONTRACT_CHANGELOG, MONITOR_FLEET_AUTHORING_CONTRACT_EDITION, MONITOR_FLEET_DOCUMENTATION, MONITOR_FLEET_FRONTIER_MAX_ROWS, MONITOR_FLEET_MAX_MEMBERS, type MonitorCheckResult, type MonitorControls, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetAuthoringContractEdition, type MonitorFleetAuthoringContractResult, type MonitorFleetColumn, type MonitorFleetContractIssue, type MonitorFleetDeactivateOptions, type MonitorFleetDefinition, type MonitorFleetExpression, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetTemplate, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, 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 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 PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, 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 StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, type ToolSearchOptions, type ToolSearchResult, type WorkspaceCreateResult, type WorkspacesNamespace, admitMonitorFleetAuthoringContract, defineInput, defineMonitor, defineMonitorFleet, definePlay, defineWorkflow, extractSummaryFields, fleetColumn, fleetKey, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, validateMonitorFleetDefinition, writeCsvOutputFile, writeJsonOutputFile };
+export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, 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 DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LiveEventEnvelope, type MonitorCheckResult, type MonitorControls, 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 MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, 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 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 StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, type ToolSearchOptions, type ToolSearchResult, type WorkspaceCreateResult, type WorkspacesNamespace, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };