deepline 0.3.74 → 0.3.75

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /// <reference path="./text-imports.d.ts" />
-import { c as PlayCompilerManifest, 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 PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, D as PlayAuthoringRuntimeStepOptions, E as PlaySqlListenerDeclaration, F as PlaySqlListenerEvent, G as PlaySqlListenerOperation, H as PlaySqlQuery, I as PlayAuthoringStepOptions, J as PlayAuthoringStepProgram, K as PlayAuthoringStepProgramResolver, L as PlayAuthoringStepResolver, M as PlayToolExecutionRequest, N as PlayAuthoringStepProgramOptions, O as DeeplineError, Q as ToolExecutionError, R as ToolExecutionErrorOptions } from './compiler-manifest-CMNgA_JQ.js';
-export { S as CtxFetchHttpError, U as DEEPLINE_EXTRACTOR_TARGETS, V as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, W as DeeplineEmailStatusGetterValue, X as DeeplineExtractorTarget, Y as DeeplineGetterValue, Z as DeeplineGetterValueMap, _ as JOB_CHANGE_STATUS_VALUES, $ as JobChangeStatus, a0 as PHONE_STATUS_VALUES, a1 as PhoneStatus, a2 as PlayDataset, a3 as PlayDatasetInput, a4 as PreviousCell, a5 as ProviderTransientError, a6 as ProviderTransientErrorCategory, a7 as ProviderUnavailableError, a8 as ProviderUnavailableReason, a9 as ToolExecutionErrorCategory, aa as ToolExecutionErrorOrigin, ab as ToolExecutionFailureV1, ac as ToolExecutionNetworkKind, ad as ToolExecutionNetworkScope, ae as ToolExecutionPublicDetails, af as getProviderUnavailableReason, ag as isDeeplineExtractorTarget, ah as isProviderUnavailable, ai as isProviderWaterfallUnavailableError } from './compiler-manifest-CMNgA_JQ.js';
+import { c as PlayCompilerManifest, 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 PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, D as PlayAuthoringRuntimeStepOptions, E as PlaySqlListenerDeclaration, F as PlaySqlListenerEvent, G as PlaySqlListenerOperation, H as PlaySqlQuery, I as PlayAuthoringStepOptions, J as PlayAuthoringStepProgram, K as PlayAuthoringStepProgramResolver, L as PlayAuthoringStepResolver, M as PlayToolExecutionRequest, N as PlayAuthoringStepProgramOptions, O as DeeplineError, Q as ToolExecutionError, R as ToolExecutionErrorOptions } from './compiler-manifest-Dbov16F7.js';
+export { S as CtxFetchHttpError, U as DEEPLINE_EXTRACTOR_TARGETS, V as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, W as DeeplineEmailStatusGetterValue, X as DeeplineExtractorTarget, Y as DeeplineGetterValue, Z as DeeplineGetterValueMap, _ as JOB_CHANGE_STATUS_VALUES, $ as JobChangeStatus, a0 as PHONE_STATUS_VALUES, a1 as PhoneStatus, a2 as PlayDataset, a3 as PlayDatasetInput, a4 as PreviousCell, a5 as ProviderTransientError, a6 as ProviderTransientErrorCategory, a7 as ProviderUnavailableError, a8 as ProviderUnavailableReason, a9 as ToolExecutionErrorCategory, aa as ToolExecutionErrorOrigin, ab as ToolExecutionFailureV1, ac as ToolExecutionNetworkKind, ad as ToolExecutionNetworkScope, ae as ToolExecutionPublicDetails, af as getProviderUnavailableReason, ag as isDeeplineExtractorTarget, ah as isProviderUnavailable, ai as isProviderWaterfallUnavailableError } from './compiler-manifest-Dbov16F7.js';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -406,8 +406,9 @@ interface ToolDefinition {
         term?: string;
     }>;
     /**
-     * Whether this tool is callable in the current workspace. `false` for a
-     * bring-your-own-credential provider that has not been connected.
+     * Whether this tool is callable in the current workspace. `false` when a
+     * required customer credential is missing or a managed provider is
+     * temporarily unavailable.
      */
     connected?: boolean;
     /** Whether the tool can be executed. Exact lookup may return non-callable deprecated aliases. */
@@ -2461,6 +2462,8 @@ type MonitorsListResult = {
     monitors?: MonitorListEntry[];
     total?: number;
     returned?: number;
+    has_more?: boolean;
+    /** @deprecated Use has_more. */
     is_truncated?: boolean;
     next_cursor?: string | null;
     status_filter_applied?: string;
@@ -2478,6 +2481,7 @@ type MonitorsListOptions = {
     limit?: number | string;
     /** Page past a truncated result using a prior response's `next_cursor`. */
     cursor?: string;
+    /** @deprecated Accepted as a no-op for compatibility. */
     compact?: boolean;
     /** Include bounded current SQL-listener delivery/run health (requires limit <= 20). */
     includeConsumers?: boolean;
@@ -2543,6 +2547,14 @@ type MonitorUpdateResult = {
 type MonitorDeleteResult = Record<string, unknown>;
 type MonitorReactivateResult = Record<string, unknown>;
 type MonitorTestResult = Record<string, unknown>;
+/**
+ * @deprecated Monitor tests are always validation-only. `dispatch` and
+ * `validationOnly: false` are rejected before a request is made.
+ */
+type MonitorTestOptions = {
+    validationOnly?: boolean;
+    dispatch?: boolean;
+};
 type MonitorValidateResult = Record<string, unknown>;
 /**
  * Server-owned fleet response envelope.
@@ -2554,7 +2566,7 @@ type MonitorValidateResult = Record<string, unknown>;
  */
 type MonitorFleetResult = Record<string, unknown>;
 /** Server-computed fleet verdict. Never derived client-side. */
-type MonitorFleetStatus = 'converging' | 'converged' | 'degraded' | 'deactivating' | 'deactivated';
+type MonitorFleetStatus = 'converging' | 'converged' | 'degraded' | 'deactivating' | 'deactivated' | 'billing_suspending' | 'billing_suspended' | 'billing_reactivating';
 type MonitorFleetSyncOptions = {
     /** Return the plan without changing fleet state (`dry_run: true`). */
     dryRun?: boolean;
@@ -2574,6 +2586,9 @@ type MonitorFleetDeactivateOptions = {
     dryRun?: boolean;
     idempotencyKey?: string;
 };
+type MonitorFleetReactivateOptions = {
+    idempotencyKey?: string;
+};
 type MonitorFleetWaitOptions = {
     /** Give up after this long. Default 10 minutes. */
     timeoutMs?: number;
@@ -2601,9 +2616,119 @@ type MonitorFleetsNamespace = {
     list: () => Promise<MonitorFleetResult>;
     /** Deactivate a fleet and the monitors it owns. */
     deactivate: (fleetId: string, options?: MonitorFleetDeactivateOptions) => Promise<MonitorFleetResult>;
+    /** Explicitly recreate a fleet after a credit-triggered suspension. */
+    reactivate: (fleetId: string, options?: MonitorFleetReactivateOptions) => Promise<MonitorFleetResult>;
     /** Poll the fleet until the server reports a terminal status (or the timeout elapses). */
     waitForConvergence: (fleetId: string, options?: MonitorFleetWaitOptions) => Promise<MonitorFleetResult>;
 };
+/**
+ * Delivery and convergence health for a scope, from
+ * `GET /api/v2/monitors/health`.
+ *
+ * Counts and bounded samples on purpose. It is also what `--watch` polls, so
+ * its shape is fixed independently of the transport: phase 2b publishes the
+ * same object over a reactive subscription without changing this contract.
+ */
+type MonitorsHealth = {
+    ok?: boolean;
+    scope: {
+        org_id: string;
+        fleet_id?: string;
+    };
+    scanned: number;
+    /** True when the scope was larger than one bounded read; counts are partial. */
+    truncated: boolean;
+    desired: {
+        active: number;
+        inactive: number;
+        unset: number;
+    };
+    observed: {
+        active: number;
+        inactive: number;
+        missing: number;
+        unknown: number;
+        unset: number;
+    };
+    converged: number;
+    needs_repair: number;
+    /** Observed active, but nothing delivered inside `silent_window_days`. */
+    silent: number;
+    silent_window_days: number;
+    deactivation_reasons: Array<{
+        reason: string;
+        count: number;
+        summary: string | null;
+        resolution: string | null;
+    }>;
+    worst_offenders: Array<{
+        monitor_key: string;
+        tool: string;
+        last_event_at: number | null;
+        observed_at: number | null;
+        provider_resource_id: string | null;
+    }>;
+};
+/** One bounded audit pass, from `POST /api/v2/monitors/audit`. */
+type MonitorsAuditResult = {
+    ok?: boolean;
+    scope: {
+        org_id: string;
+        fleet_id?: string;
+    };
+    audit: {
+        scanned: number;
+        asked: number;
+        observed: {
+            active: number;
+            inactive: number;
+            missing: number;
+            unknown: number;
+        };
+        /** Observations a concurrent settle overtook. Not an error. */
+        stale: number;
+        absent: number;
+        /** Capabilities that declare no batch read, so nothing could be asked. */
+        unauditable_capabilities: string[];
+        complete: boolean;
+        /** Non-null when the scope was larger than one pass. Pass it back. */
+        cursor: string | null;
+    };
+    health: MonitorsHealth;
+};
+/** One repair pass or plan, from `POST /api/v2/monitors/repair`. */
+type MonitorsRepairResult = {
+    ok?: boolean;
+    dry_run: boolean;
+    scope: {
+        org_id: string;
+        fleet_id?: string;
+    };
+    repair: {
+        scanned: number;
+        queued: number;
+        plan: Array<{
+            monitor_key: string;
+            action: 'create' | 'remove';
+            desired: 'active' | 'inactive';
+            observed: 'active' | 'inactive' | 'missing';
+            deactivation_reason?: string;
+        }>;
+        /** Disagreeing monitors no fleet owns; the convergence driver cannot move them. */
+        unowned: string[];
+        /** Monitors nobody has observed. Run audit first. */
+        unaudited: string[];
+        /**
+         * Monitors with a provider operation still in flight. Deepline's own
+         * convergence loop owns these; repair leaves them alone rather than risk
+         * asking the provider to do the same work twice.
+         */
+        fenced: string[];
+        refused: string[];
+        complete: boolean;
+    };
+    health: MonitorsHealth;
+};
 /**
  * Public monitors namespace exposed as `client.monitors`.
  *
@@ -2636,14 +2761,8 @@ type MonitorsNamespace = {
     list: (options?: MonitorsListOptions) => Promise<MonitorsListResult>;
     /** Fetch one deployed monitor by public key with bounded current listener health. */
     get: (key: string) => Promise<MonitorDetail>;
-    /**
-     * Test a deployed monitor. `validationOnly` safely verifies the callback
-     * envelope; omitted options preserve the historic full-ingestion behavior.
-     */
-    test: (key: string, payload: Record<string, unknown>, options?: {
-        validationOnly?: boolean;
-        dispatch?: boolean;
-    }) => Promise<MonitorTestResult>;
+    /** Test a deployed monitor's callback envelope without side effects. */
+    test: (key: string, payload: Record<string, unknown>, options?: MonitorTestOptions) => Promise<MonitorTestResult>;
     validate: (key: string) => Promise<MonitorValidateResult>;
     /** List the published plays depending on one monitor's output streams. */
     dependents: (key: string) => Promise<MonitorDependents>;
@@ -2657,6 +2776,26 @@ type MonitorsNamespace = {
     reactivate: (key: string, options?: {
         dryRun?: boolean;
     }) => Promise<MonitorReactivateResult>;
+    /**
+     * Re-read what the provider holds onto the monitors that claim it. Bounded
+     * and idempotent: pass `cursor` back while `audit.cursor` is non-null.
+     */
+    audit: (options?: {
+        fleetId?: string;
+        cursor?: string | null;
+    }) => Promise<MonitorsAuditResult>;
+    /**
+     * Converge the monitors whose desired and observed states disagree.
+     * `dryRun` returns the same plan without queueing anything.
+     */
+    repair: (options?: {
+        fleetId?: string;
+        dryRun?: boolean;
+    }) => Promise<MonitorsRepairResult>;
+    /** Delivery and convergence health for the workspace or one fleet. */
+    health: (options?: {
+        fleetId?: string;
+    }) => Promise<MonitorsHealth>;
     /** Define, reconcile, and control table-backed monitor fleets. */
     fleets: MonitorFleetsNamespace;
 };
@@ -4012,6 +4151,25 @@ declare class DeeplineClient {
      * `client.monitors.status()`.
      */
     getMonitorsAccess(): Promise<MonitorsAccessStatus>;
+    /**
+     * One bounded audit pass. Prefer `client.monitors.audit(...)`.
+     *
+     * Never auto-retried: it is idempotent, but a retry that races the caller's
+     * own next pass would spend a provider slot to learn nothing new.
+     */
+    auditMonitors(options?: {
+        fleetId?: string;
+        cursor?: string | null;
+    }): Promise<MonitorsAuditResult>;
+    /** One repair pass or plan. Prefer `client.monitors.repair(...)`. */
+    repairMonitors(options?: {
+        fleetId?: string;
+        dryRun?: boolean;
+    }): Promise<MonitorsRepairResult>;
+    /** Delivery and convergence health. Prefer `client.monitors.health(...)`. */
+    readMonitorsHealth(options?: {
+        fleetId?: string;
+    }): Promise<MonitorsHealth>;
     /**
      * The deployable monitor tools catalog. Pass a tool id (positional or
      * `{ tool }`) to describe one tool's full payload/stream contract, or no tool
@@ -4034,10 +4192,7 @@ declare class DeeplineClient {
     listMonitors(options?: MonitorsListOptions): Promise<MonitorsListResult>;
     /** Fetch one deployed monitor by public key. Prefer `client.monitors.get(...)`. */
     getMonitor(key: string): Promise<MonitorDetail>;
-    testMonitorWebhook(key: string, payload: Record<string, unknown>, options?: {
-        validationOnly?: boolean;
-        dispatch?: boolean;
-    }): Promise<MonitorTestResult>;
+    testMonitorWebhook(key: string, payload: Record<string, unknown>, options?: MonitorTestOptions): Promise<MonitorTestResult>;
     setupMonitor(tool: string, payload: Record<string, unknown>): Promise<Record<string, unknown>>;
     validateMonitor(key: string): Promise<MonitorValidateResult>;
     /** Published plays depending on one monitor. Prefer `client.monitors.dependents(...)`. */
@@ -4072,6 +4227,7 @@ declare class DeeplineClient {
     listMonitorFleets(): Promise<MonitorFleetResult>;
     getMonitorFleet(fleetId: string, options?: MonitorFleetGetOptions): Promise<MonitorFleetResult>;
     deactivateMonitorFleet(fleetId: string, options?: MonitorFleetDeactivateOptions): Promise<MonitorFleetResult>;
+    reactivateMonitorFleet(fleetId: string, options?: MonitorFleetReactivateOptions): Promise<MonitorFleetResult>;
     /**
      * Poll one fleet until the server reports a terminal status.
      *
@@ -4187,8 +4343,8 @@ type SqlQuery = PlaySqlQuery;
  * Keyword-style request object for `ctx.tools.execute(...)`.
  *
  * The `tool` value comes from live tool discovery. The `id` is the stable
- * logical call name used for logs, metadata, and receipt attachment. Provider
- * call reuse is keyed by play, tool, semantic input, auth scope, provider action
+ * logical call name used for logs, metadata, and result-cache identity. Provider
+ * result reuse is keyed by play, tool, semantic input, auth scope, provider action
  * version, and cache policy.
  *
  * @sdkReference runtime 160
@@ -4937,9 +5093,6 @@ declare class ConfigError extends DeeplineError {
 
 /** Production API base URL. */
 declare const PROD_URL = "https://code.deepline.com";
-/**
- * Resolve SDK configuration from the public SDK CLI env contract.
- */
 declare function resolveConfig(options?: DeeplineClientOptions): ResolvedConfig;
 
 /**
@@ -5086,4 +5239,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { type AdmittedMonitorFleetAuthoringContract, 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 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 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 PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, 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 AdmittedMonitorFleetAuthoringContract, 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 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 PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, 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 };

package/dist/index.js

@@ -832,7 +832,7 @@ 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.74",
+  version: "0.3.75",
   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.",
   packageCapabilities: {
     updatePreferences: 1
@@ -1245,7 +1245,7 @@ var RUNTIME_INCIDENT_DRILL_CATALOG = [
       valueMeaning: "occurrence"
     },
     expected: {
-      outcome: "The same logical run completes through receipt replay; recovery remains bounded if the provider outcome must be retried.",
+      outcome: "The same logical run completes through terminal-cache replay; any provider retry is governed by its separate operation policy.",
       safetyFacts: ["same_logical_run", "bounded_provider_execution"]
     },
     verification: {
@@ -3975,6 +3975,10 @@ var TERMINAL_PLAY_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "ca
 var INCLUDE_TOOL_METADATA_HEADER = "x-deepline-include-tool-metadata";
 var EXECUTE_RESPONSE_CONTRACT_HEADER = "x-deepline-execute-response-contract";
 var EXECUTE_RESPONSE_INTENT_HEADER = "x-deepline-execute-response-intent";
+var MONITOR_NON_RETRYABLE_MUTATION_OPTIONS = {
+  maxRetries: 0,
+  exactUrlOnly: true
+};
 var RAW_V2_EXECUTE_RESPONSE_CONTRACT = RAW_V2_TOOL_RESPONSE_CONTRACT;
 var COMPILE_MANIFEST_RETRY_DELAYS_MS = [250, 1e3];
 var REGISTER_PLAY_ARTIFACTS_COMPILE_CONCURRENCY = 3;
@@ -4533,11 +4537,15 @@ var DeeplineClient = class {
       update: (key, patch) => this.updateMonitor(key, patch),
       delete: (key, options2) => this.deleteMonitor(key, options2),
       reactivate: (key, options2) => this.reactivateMonitor(key, options2),
+      audit: (options2) => this.auditMonitors(options2),
+      repair: (options2) => this.repairMonitors(options2),
+      health: (options2) => this.readMonitorsHealth(options2),
       fleets: {
         sync: (definitionOrId, options2) => this.syncMonitorFleet(definitionOrId, options2),
         get: (fleetId, options2) => fleetId === void 0 ? this.listMonitorFleets() : this.getMonitorFleet(fleetId, options2),
         list: () => this.listMonitorFleets(),
         deactivate: (fleetId, options2) => this.deactivateMonitorFleet(fleetId, options2),
+        reactivate: (fleetId, options2) => this.reactivateMonitorFleet(fleetId, options2),
         waitForConvergence: (fleetId, options2) => this.waitForMonitorFleetConvergence(fleetId, options2)
       }
     };
@@ -6123,13 +6131,23 @@ var DeeplineClient = class {
     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 suffix = params.toString() ? `?${params.toString()}` : "";
-    const response = await this.http.get(
-      `/api/v2/plays${suffix}`
-    );
-    return response.plays ?? [];
+    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;
   }
   /** Set whether an org-owned Play sorts before unpinned Plays. */
   async setPlayPinned(playName, pinned) {
@@ -6706,6 +6724,44 @@ var DeeplineClient = class {
       ...typeof payload.reason === "string" && payload.reason.trim() ? { reason: payload.reason.trim() } : {}
     };
   }
+  /**
+   * One bounded audit pass. Prefer `client.monitors.audit(...)`.
+   *
+   * Never auto-retried: it is idempotent, but a retry that races the caller's
+   * own next pass would spend a provider slot to learn nothing new.
+   */
+  async auditMonitors(options) {
+    return this.http.request("/api/v2/monitors/audit", {
+      method: "POST",
+      body: {
+        ...options?.fleetId ? { fleet_id: options.fleetId } : {},
+        ...options?.cursor ? { cursor: options.cursor } : {}
+      },
+      maxRetries: 0
+    });
+  }
+  /** One repair pass or plan. Prefer `client.monitors.repair(...)`. */
+  async repairMonitors(options) {
+    return this.http.request("/api/v2/monitors/repair", {
+      method: "POST",
+      body: {
+        ...options?.fleetId ? { fleet_id: options.fleetId } : {},
+        ...options?.dryRun === void 0 ? {} : { dry_run: options.dryRun }
+      },
+      maxRetries: 0
+    });
+  }
+  /** Delivery and convergence health. Prefer `client.monitors.health(...)`. */
+  async readMonitorsHealth(options) {
+    const params = new URLSearchParams();
+    if (options?.fleetId) params.set("fleet_id", options.fleetId);
+    const query = params.toString();
+    const suffix = query ? `?${query}` : "";
+    return this.http.request(
+      `/api/v2/monitors/health${suffix}`,
+      { method: "GET" }
+    );
+  }
   /**
    * The deployable monitor tools catalog. Pass a tool id (positional or
    * `{ tool }`) to describe one tool's full payload/stream contract, or no tool
@@ -6783,7 +6839,6 @@ var DeeplineClient = class {
     if (options?.limit !== void 0)
       params.set("limit", String(options.limit));
     if (options?.cursor) params.set("cursor", options.cursor);
-    if (options?.compact) params.set("compact", "true");
     if (options?.includeConsumers) params.set("include_consumers", "true");
     const query = params.toString();
     const suffix = query ? `?${query}` : "";
@@ -6800,13 +6855,22 @@ var DeeplineClient = class {
     );
   }
   async testMonitorWebhook(key, payload, options) {
+    if (options?.dispatch === true || options?.validationOnly === false) {
+      throw new DeeplineError(
+        "Monitor tests are validation-only and cannot dispatch events.",
+        void 0,
+        "MONITOR_TEST_DISPATCH_NOT_SUPPORTED"
+      );
+    }
     return this.http.request(
       `/api/v2/monitors/deployed/${encodeURIComponent(key)}/test`,
       {
         method: "POST",
         body: {
           payload,
-          ...options?.validationOnly ? { mode: "validation_only" } : options?.dispatch ? { mode: "dispatch" } : {}
+          // Send the legacy safe mode as well as accepting it server-side: an
+          // upgraded SDK must be safe when it reaches a still-running server.
+          mode: "validation_only"
         }
       }
     );
@@ -6834,7 +6898,14 @@ var DeeplineClient = class {
   async updateMonitor(key, patch) {
     return this.http.request(
       `/api/v2/monitors/deployed/${encodeURIComponent(key)}`,
-      { method: "PATCH", body: patch }
+      {
+        method: "PATCH",
+        body: patch,
+        // A monitor write may have reached the control plane before a network
+        // failure reaches the caller. Do not turn that unknown outcome into a
+        // second mutation with a fresh snapshot.
+        ...MONITOR_NON_RETRYABLE_MUTATION_OPTIONS
+      }
     );
   }
   /** Delete a deployed monitor and its upstream provider resource. `dryRun` returns the delete plan. Prefer `client.monitors.delete(...)`. */
@@ -6851,7 +6922,12 @@ var DeeplineClient = class {
     const query = params.toString();
     return this.http.request(
       `/api/v2/monitors/deployed/${encodeURIComponent(key)}${query ? `?${query}` : ""}`,
-      { method: "DELETE" }
+      options?.dryRun ? { method: "DELETE" } : {
+        method: "DELETE",
+        // Deletion is a provider lifecycle operation. A timeout is an
+        // unknown outcome, not authority to begin another delete attempt.
+        ...MONITOR_NON_RETRYABLE_MUTATION_OPTIONS
+      }
     );
   }
   /**
@@ -6862,7 +6938,13 @@ var DeeplineClient = class {
     const query = options?.dryRun ? "?dry_run=true" : "";
     return this.http.request(
       `/api/v2/monitors/deployed/${encodeURIComponent(key)}/reactivate${query}`,
-      { method: "POST", body: {} }
+      options?.dryRun ? { method: "POST", body: {} } : {
+        method: "POST",
+        body: {},
+        // Reactivation can create an upstream resource, so it must not use
+        // the generic transport's automatic replay policy.
+        ...MONITOR_NON_RETRYABLE_MUTATION_OPTIONS
+      }
     );
   }
   // ——————————————————————————————————————————————————————————
@@ -6939,6 +7021,21 @@ var DeeplineClient = class {
       }
     );
   }
+  async reactivateMonitorFleet(fleetId, options) {
+    return this.http.request(
+      `${this.monitorFleetPath(fleetId)}/reactivate`,
+      {
+        method: "POST",
+        body: {},
+        headers: this.monitorFleetHeaders(
+          "reactivate",
+          options?.idempotencyKey
+        ),
+        maxRetries: 0,
+        exactUrlOnly: true
+      }
+    );
+  }
   /**
    * Poll one fleet until the server reports a terminal status.
    *