deepline 0.3.89 → 0.3.90

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 { P as PlayCompilerManifest, A as AsyncPlayRunRef$1, a as PlayAuthoringColumnMap, b as PlayAuthoringColumnResolver, c as PlayAuthoringRuntimeContext, d as PlayAuthoringConditionalStepResolver, e as PlayAuthoringCsvInput, f as PlayAuthoringCsvOptions, g as PlayAuthoringDatasetBuilder, h as PlayAuthoringDatasetColumnDefinition, i as PlayAuthoringDatasetColumnRunInput, T as ToolExecuteResult, j as PlayAuthoringReferenceLike, k as PlayReturnObject$1, l as PlayAuthoringDefineConfig, m as PlayAuthoringDefinedPlay, n as PlayAuthoringFetchOptions, o as PlayAuthoringFileInput, p as PlayAuthoringAsyncCallOptions, q as PlayAuthoringBindings, r as PlayAuthoringCallExecution, s as PlayAuthoringCallOptions, t as PlayAuthoringFetchResponse, u as PlayAuthoringInputContract, v as PlayRunId$1, w as PlayAuthoringStepProgramStep, x as PlayAuthoringRuntimeStepOptions, y as PlaySqlListenerDeclaration, z as PlaySqlListenerEvent, B as PlaySqlListenerOperation, C as PlaySqlQuery, D as PlayAuthoringStepOptions, E as PlayAuthoringStepProgram, F as PlayAuthoringStepProgramResolver, G as PlayAuthoringStepResolver, H as PlayToolExecutionRequest, I as PlayAuthoringStepProgramOptions, J as DeeplineError, K as ToolExecutionError, L as ToolExecutionErrorOptions } from './compiler-manifest-BaJfE-5H.js';
+export { M as CtxFetchHttpError, N as DEEPLINE_EXTRACTOR_TARGETS, O as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, Q as DeeplineEmailStatusGetterValue, R as DeeplineExtractorTarget, S as DeeplineGetterValue, U as DeeplineGetterValueMap, V as JOB_CHANGE_STATUS_VALUES, W as JobChangeStatus, X as PHONE_STATUS_VALUES, Y as PhoneStatus, Z as PlayDataset, _ as PlayDatasetInput, $ as PreviousCell, a0 as ProviderTransientError, a1 as ProviderTransientErrorCategory, a2 as ProviderUnavailableError, a3 as ProviderUnavailableReason, a4 as ToolExecutionErrorCategory, a5 as ToolExecutionErrorOrigin, a6 as ToolExecutionFailureV1, a7 as ToolExecutionNetworkKind, a8 as ToolExecutionNetworkScope, a9 as ToolExecutionPublicDetails, aa as getProviderUnavailableReason, ab as isDeeplineExtractorTarget, ac as isProviderUnavailable, ad as isProviderWaterfallUnavailableError } from './compiler-manifest-BaJfE-5H.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';
@@ -1891,6 +1893,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 +1937,7 @@ interface PlayListItem {
     liveRevision?: PlayRevisionSummary | null;
     aliases?: string[];
     triggerStatus?: PlayTriggerStatus;
+    costEstimate?: PlayCostEstimate;
 }
 /** Additive live trigger state shared by list, get, and describe. */
 interface PlayTriggerStatus {
@@ -2602,134 +2620,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 +2821,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. */
@@ -3047,11 +2963,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 +2992,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. */
@@ -3432,6 +3347,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;
@@ -3457,6 +3377,15 @@ type MonitorsHealth = {
         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 +3521,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,10 +3601,10 @@ 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;
 };
@@ -4499,6 +4430,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 +4536,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;
@@ -6061,4 +5994,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 };

package/dist/index.js

@@ -94,6 +94,26 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/pagination.ts
+async function* iterateCursorPages(fetchPage) {
+  let cursor = null;
+  const seen = /* @__PURE__ */ new Set();
+  for (; ; ) {
+    const page = await fetchPage(cursor);
+    if (page.hasMore) {
+      if (!page.cursor || seen.has(page.cursor)) {
+        throw new Error(
+          "Pagination reported more results without an advancing cursor"
+        );
+      }
+      seen.add(page.cursor);
+    }
+    yield page.items;
+    if (!page.hasMore) return;
+    cursor = page.cursor;
+  }
+}
+
 // src/config.ts
 var import_node_fs = require("fs");
 var import_node_os = require("os");
@@ -835,20 +855,27 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.89",
-  updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
+  // 0.3.90 is the first deliberately versioned SDK release for API v3. Play
+  // grep hard-cuts to the single Convex full-text index; it does not retain a
+  // registry/scanner reader for any SDK/API major.
+  version: "0.3.90",
+  updateSummary: "Play grep now uses one source-only Convex full-text index. It no longer scans the registry, pages through the complete indexed match set, and rejects retired grep modes. 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
   },
   contracts: {
     api: {
       name: "sdk-http-api",
-      // API v2 is append-only. A breaking public request/response change needs
-      // v3 and an explicit v2 support-window decision, never a patch release.
-      currentMajor: 2,
-      supportedMajors: [2],
-      // Accepted only to bridge SDKs released before X-Deepline-API-Major.
+      // API v3 hard-cuts Play grep to the canonical Convex index. API v2 stays
+      // admitted for the explicit SDK support window, but it selects neither a
+      // registry scanner nor another grep reader: every accepted grep request
+      // uses the same indexed query and retired flags fail at the API boundary.
+      currentMajor: 3,
+      supportedMajors: [3, 2],
+      // The first wire id is emitted by the current SDK. Remaining ids are
+      // accepted only while the API v2 support window is open.
       legacyWireIds: [
+        "2026-09-play-grep-convex-index-hard-cutover",
         "2026-07-admin-cli-local-cutover",
         "2026-07-native-monitor-launch-hard-cutover"
       ]
@@ -2063,6 +2090,10 @@ function normalizeProductNotificationEmail(value) {
   const email = typeof value === "string" ? value.trim().toLowerCase() : "";
   return email && email.length <= 320 && PRODUCT_NOTIFICATION_EMAIL_PATTERN.test(email) ? email : null;
 }
+var DEFAULT_PRODUCT_NOTIFICATION_DELIVERY_TIMING = {
+  mode: "rolling_limit",
+  windowMs: 36e5
+};
 
 // src/stream-reconnect.ts
 var STREAM_RECONNECT_BASE_DELAY_MS = 500;
@@ -4556,6 +4587,7 @@ var DeeplineClient = class {
     this.runs = {
       get: (runId, options2) => this.getRunStatus(runId, options2),
       list: (options2) => this.listRuns(options2),
+      listPage: (options2) => this.listRunsPage(options2),
       tail: (runId, options2) => this.tailRun(runId, options2),
       logs: (runId, options2) => this.getRunLogs(runId, options2),
       input: (runId) => this.getRunInput(runId),
@@ -5769,6 +5801,10 @@ var DeeplineClient = class {
    * ```
    */
   async listRuns(options) {
+    return (await this.listRunsPage(options)).runs;
+  }
+  /** Read one run page without discarding server pagination metadata. */
+  async listRunsPage(options) {
     const playName = options.play?.trim();
     const params = new URLSearchParams();
     if (playName) {
@@ -5799,7 +5835,7 @@ var DeeplineClient = class {
     const response = await this.http.get(
       `/api/v2/runs?${params.toString()}`
     );
-    return response.runs ?? [];
+    return { ...response, runs: response.runs ?? [] };
   }
   /**
    * Observe one run's live events. Uses the Convex Run Snapshot subscription
@@ -6194,13 +6230,33 @@ var DeeplineClient = class {
     );
   }
   /**
-   * 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.
    */
   async listPlays(options) {
+    if (!options?.grep?.trim()) {
+      return (await this.requestPlaysPage(options, false)).plays;
+    }
+    const plays = [];
+    for await (const items of iterateCursorPages(async (cursor) => {
+      const page = await this.listPlaysPage({ ...options, cursor });
+      return { items: page.plays, cursor: page.cursor, hasMore: page.hasMore };
+    })) {
+      plays.push(...items);
+    }
+    return plays;
+  }
+  /** Read one bounded inventory page; cursor continues the same filters. */
+  async listPlaysPage(options) {
+    return this.requestPlaysPage(options);
+  }
+  async requestPlaysPage(options, paginateInventory = true) {
     const params = new URLSearchParams();
+    if (paginateInventory && !options?.grep?.trim())
+      params.set("inventory_paginated", "1");
     if (options?.origin) params.set("origin", options.origin);
     if (options?.categories) {
       params.set(
@@ -6212,26 +6268,27 @@ var DeeplineClient = class {
       params.set("include_tool_categories", "1");
     }
     if (options?.includeArchived) params.set("include_archived", "1");
+    if (options?.includeCostEstimates) {
+      params.set("include_cost_estimates", "1");
+    }
     if (options?.grep?.trim()) {
       params.set("grep", options.grep.trim());
-      params.set("grep_mode", options.grepMode ?? "all");
-      params.set("grep_paginated", "1");
       params.set("limit", "60");
     }
-    const plays = [];
-    let cursor = null;
-    let hasMore = true;
-    do {
-      if (cursor) params.set("cursor", cursor);
-      const suffix = params.toString() ? `?${params.toString()}` : "";
-      const response = await this.http.get(
-        `/api/v2/plays${suffix}`
-      );
-      plays.push(...response.plays ?? []);
-      cursor = response.pagination?.cursor ?? response.cursor ?? null;
-      hasMore = Boolean(response.pagination?.hasMore ?? response.hasMore);
-    } while (Boolean(options?.grep?.trim()) && hasMore && cursor);
-    return plays;
+    if (options?.limit !== void 0) {
+      if (!Number.isSafeInteger(options.limit) || options.limit < 1) {
+        throw new Error("Play page limit must be a positive integer");
+      }
+      params.set("limit", String(options.limit));
+    }
+    if (options?.cursor) params.set("cursor", options.cursor);
+    const suffix = params.size ? `?${params.toString()}` : "";
+    const response = await this.http.get(`/api/v2/plays${suffix}`);
+    return {
+      plays: response.plays ?? [],
+      cursor: response.pagination?.cursor ?? response.cursor ?? null,
+      hasMore: Boolean(response.pagination?.hasMore ?? response.hasMore)
+    };
   }
   /** Set whether an org-owned Play sorts before unpinned Plays. */
   async setPlayPinned(playName, pinned) {
@@ -6365,7 +6422,7 @@ var DeeplineClient = class {
       groupKey,
       name,
       enabled: true,
-      deliveryTiming: { mode: "immediate" },
+      deliveryTiming: DEFAULT_PRODUCT_NOTIFICATION_DELIVERY_TIMING,
       source: "workspace",
       configMode: "custom",
       version: 0