deepline 0.3.115 → 0.3.117

package/dist/index.d.mts

@@ -3272,10 +3272,26 @@ type MonitorsAvailableOptions = {
     /** Ask the server for high-signal fields only. */
     compact?: boolean;
 };
+/**
+ * Stable customer-facing Monitor/Fleet state.
+ *
+ * Provider provisioning, cleanup, retries, and failures are Monitor Job
+ * progress and must never be added to this union. The `status` and `active`
+ * fields below are retained only as deprecated compatibility aliases for
+ * older API responses.
+ */
+type MonitorState = 'active' | 'billing_suspended' | 'disabled';
+/** List filters accepted by the canonical state surface. */
+type MonitorStateFilter = MonitorState | 'all';
+/** The pre-state list filter retained for installed-client compatibility. */
+type LegacyMonitorStatusFilter = 'active' | 'inactive' | 'all';
 /** One deployed monitor row returned by `client.monitors.list(...)`. */
 type MonitorListEntry = {
     key?: string;
     monitor_key?: string;
+    /** Canonical customer-facing lifecycle state. */
+    state?: MonitorState;
+    /** @deprecated Use state. `inactive` is projected as `disabled`. */
     status?: string;
     tool?: string;
     /** Generic provider-authored event category for this deployed monitor. */
@@ -3304,7 +3320,18 @@ type MonitorsListResult = {
     /** @deprecated Use has_more. */
     is_truncated?: boolean;
     next_cursor?: string | null;
+    /** Canonical state filter echoed by newer servers. */
+    state_filter_applied?: MonitorStateFilter;
+    /** Canonical state counts. */
+    state_summary?: Array<{
+        state: MonitorState;
+        count: number;
+    }>;
+    /** Whether state_summary counts this page or the full applied state filter. */
+    state_summary_scope?: 'page' | 'filter_total';
+    /** @deprecated Use state_filter_applied. */
     status_filter_applied?: string;
+    /** @deprecated Use state_summary. */
     status_summary?: Array<{
         status: string;
         count: number;
@@ -3314,8 +3341,10 @@ type MonitorsListResult = {
 };
 /** Options for `client.monitors.list(...)`. */
 type MonitorsListOptions = {
-    /** active (default), disabled, or all. */
-    status?: string;
+    /** Canonical customer state filter; active is the default. */
+    state?: MonitorStateFilter;
+    /** @deprecated Use state. `inactive` remains accepted for old servers. */
+    status?: LegacyMonitorStatusFilter | (string & {});
     limit?: number | string;
     /** Page past a truncated result using a prior response's `next_cursor`. */
     cursor?: string;
@@ -3345,6 +3374,12 @@ type MonitorSpec = {
 };
 /** One deployed-monitor read. The server may add monitor-specific fields. */
 type MonitorDetail = Record<string, unknown> & {
+    /** Canonical customer-facing lifecycle state. */
+    state?: MonitorState;
+    /** @deprecated Use state. */
+    status?: string;
+    /** @deprecated Use state. */
+    active?: boolean;
     monitor_spec?: MonitorSpec;
 };
 type MonitorDependents = Record<string, unknown>;
@@ -3397,18 +3432,94 @@ type MonitorValidateResult = Record<string, unknown>;
 /**
  * Server-owned fleet response envelope.
  *
- * The server computes `status` (`converging` | `converged` | `degraded` |
- * `deactivating` | `deactivated`) and the SDK never recomputes it: a client
- * that derives its own verdict from counts drifts from the control plane the
- * moment the server changes what "converged" means.
+ * The server computes the canonical customer `state` and the SDK never
+ * recomputes it. Transitional convergence details remain in the owning Fleet
+ * Job; the deprecated `status` alias is retained only for installed clients.
  */
-type MonitorFleetResult = Record<string, unknown>;
-/** Shared response envelope for immutable batch and desired-set Monitor Jobs. */
-type MonitorJobResult = Record<string, unknown>;
+type MonitorFleetResult = Record<string, unknown> & {
+    /** Canonical customer-facing Fleet state. */
+    state?: MonitorState;
+    /** @deprecated Fleet operation/convergence status; use state + jobs. */
+    status?: string;
+};
+/** Standalone SDK mirror of the server-owned Monitor Job contract. */
+declare const MONITOR_JOB_STATES: readonly ["queued", "running", "cancelling", "succeeded", "failed", "cancelled"];
+type MonitorJobState = (typeof MONITOR_JOB_STATES)[number];
+declare const MONITOR_JOB_PHASES: readonly ["queued", "provider_create", "provider_readback", "reconciliation", "completed"];
+type MonitorJobPhase = (typeof MONITOR_JOB_PHASES)[number];
+declare const MONITOR_JOB_RECONCILIATION_STATES: readonly ["pending", "aligned", "partial", "mismatched"];
+type MonitorJobReconciliationState = (typeof MONITOR_JOB_RECONCILIATION_STATES)[number];
+type MonitorJobProjection = {
+    id: string;
+    kind: 'batch_deploy' | 'fleet_deploy';
+    state: MonitorJobState;
+    phase: MonitorJobPhase;
+    target: {
+        monitor_key?: string;
+        batch_id?: string;
+        generation?: number;
+        fleet_id?: string;
+    };
+    counts: {
+        requested: number;
+        valid: number;
+        queued: number;
+        running: number;
+        created: number;
+        updated: number;
+        removed: number;
+        unchanged: number;
+        settled: number;
+        verified: number;
+        failed: number;
+        cancelled_before_start: number;
+    };
+    reconciliation: {
+        state: MonitorJobReconciliationState;
+        expected_bindings: number;
+        observed_bindings: number;
+        active_mismatches: number;
+        provider_only_matching_markers: number;
+        next?: string;
+    };
+    error?: string;
+};
+type MonitorNamedBatchProjection = {
+    id: string;
+    state: 'active' | 'stopped';
+    generation: number;
+    desired_count: number;
+    retained_count: number;
+    last_job_id: string;
+    updated_at: string;
+};
+/** Shared typed envelope for immutable batch and desired-set Monitor Jobs. */
+type MonitorJobResult = {
+    ok?: boolean;
+    job?: MonitorJobProjection;
+    batch?: MonitorNamedBatchProjection;
+    logs?: Array<{
+        level: string;
+        phase: string;
+        message: string;
+        monitor_key?: string;
+        at: string;
+    }>;
+    replayed?: boolean;
+    already_terminal?: boolean;
+    next?: string;
+    [key: string]: unknown;
+};
 type MonitorJobDeployOptions = {
     /** Stable retry key; the server binds it to the submitted immutable set. */
     idempotencyKey?: string;
 };
+type MonitorLifecycleOptions = {
+    /** Return the plan without changing provider state. */
+    dryRun?: boolean;
+    /** Stable retry key for durable start/stop work. */
+    idempotencyKey?: string;
+};
 type MonitorJobLogsOptions = {
     limit?: number;
 };
@@ -3499,7 +3610,7 @@ type MonitorBatchOperationResult = {
     rejoined?: boolean;
     operation: {
         runId: string;
-        kind: 'audit' | 'converge' | 'deactivate' | 'reactivate' | 'deploy' | 'repair';
+        kind: 'audit' | 'converge' | 'deactivate' | 'reactivate' | 'deploy' | 'repair' | 'named_batch';
         state: 'running' | 'retry_scheduled' | 'completed' | 'failed' | 'cancelled';
         dryRun: boolean;
         scope: unknown;
@@ -3536,6 +3647,10 @@ type MonitorFleetsNamespace = {
     deactivate: (fleetId: string, options?: MonitorFleetDeactivateOptions) => Promise<MonitorFleetResult>;
     /** Explicitly recreate a fleet after a credit-triggered suspension. */
     reactivate: (fleetId: string, options?: MonitorFleetReactivateOptions) => Promise<MonitorFleetResult>;
+    /** Customer-facing alias for `reactivate`. */
+    start: (fleetId: string, options?: MonitorFleetReactivateOptions) => Promise<MonitorFleetResult>;
+    /** Customer-facing alias for `deactivate`. */
+    stop: (fleetId: string, options?: MonitorFleetDeactivateOptions) => Promise<MonitorFleetResult>;
     /** Poll the fleet until the server reports a terminal status (or the timeout elapses). */
     waitForConvergence: (fleetId: string, options?: MonitorFleetWaitOptions) => Promise<MonitorFleetResult>;
 };
@@ -3547,6 +3662,16 @@ type MonitorBatchNamespace = {
         cursor?: string | null;
     }) => Promise<MonitorBatchOperationResult>;
 };
+type MonitorNamedBatchOptions = {
+    idempotencyKey?: string;
+    expectedGeneration?: number;
+};
+type MonitorNamedBatchesNamespace = {
+    sync: (batchId: string, definitions: MonitorDefinition[], options?: MonitorNamedBatchOptions) => Promise<MonitorJobResult>;
+    start: (batchId: string, options?: Pick<MonitorNamedBatchOptions, 'idempotencyKey'>) => Promise<MonitorJobResult>;
+    stop: (batchId: string, options?: Pick<MonitorNamedBatchOptions, 'idempotencyKey'>) => Promise<MonitorJobResult>;
+    get: (batchId: string) => Promise<MonitorJobResult>;
+};
 /**
  * Delivery and convergence health for a scope, from
  * `GET /api/v2/monitors/health`.
@@ -3612,7 +3737,7 @@ type MonitorsHealth = {
     /** Bounded current durable monitor work, if the server supports it. */
     batch_operations?: Array<{
         run_id: string;
-        kind: 'audit' | 'converge' | 'deactivate' | 'reactivate' | 'repair' | 'deploy';
+        kind: 'audit' | 'converge' | 'deactivate' | 'named_batch' | 'reactivate' | 'repair' | 'deploy';
         state: 'running' | 'retry_scheduled';
         updated_at: number;
         next_attempt_at?: number;
@@ -3716,7 +3841,11 @@ type MonitorsNamespace = {
     deploy: (definition: MonitorDefinition, options?: {
         dryRun?: boolean;
     }) => Promise<MonitorDeployResult>;
-    /** List deployed monitors (active by default). `includeConsumers` requires a limit of 20 or fewer. */
+    /** Set the desired definition for one stable monitor key. */
+    sync: (definition: MonitorDefinition, options?: MonitorLifecycleOptions) => Promise<MonitorJobResult | MonitorDeployResult>;
+    /** List deployed monitors (active by default). Use `state` to filter the
+     * three customer states; `status` is retained for older servers.
+     * `includeConsumers` requires a limit of 20 or fewer. */
     list: (options?: MonitorsListOptions) => Promise<MonitorsListResult>;
     /** Fetch one deployed monitor by public key with bounded current listener health. */
     get: (key: string) => Promise<MonitorDetail>;
@@ -3735,6 +3864,10 @@ type MonitorsNamespace = {
     reactivate: (key: string, options?: {
         dryRun?: boolean;
     }) => Promise<MonitorReactivateResult>;
+    /** Explicitly apply the retained definition for a stopped monitor. */
+    start: (key: string, options?: MonitorLifecycleOptions) => Promise<MonitorJobResult | MonitorBatchOperationResult>;
+    /** Converge one monitor to inactive while retaining its definition. */
+    stop: (key: string, options?: MonitorLifecycleOptions) => Promise<MonitorJobResult | MonitorBatchOperationResult>;
     /**
      * Re-read what the provider holds onto the monitors that claim it. Bounded
      * and idempotent: pass `cursor` back while `audit.cursor` is non-null.
@@ -3759,6 +3892,8 @@ type MonitorsNamespace = {
     fleets: MonitorFleetsNamespace;
     /** Deploy an immutable one-off list through the common Monitor Job engine. */
     batch: MonitorBatchNamespace;
+    /** Reconcile and control a stable named static Batch. */
+    batches: MonitorNamedBatchesNamespace;
     /** Read, wait for, inspect, or cancel Monitor Jobs. */
     jobs: MonitorJobsNamespace;
 };
@@ -5266,6 +5401,13 @@ declare class DeeplineClient {
     private monitorJobIdempotencyKey;
     private monitorJobHeaders;
     deployMonitorBatch(definitions: MonitorDefinition[], options?: MonitorJobDeployOptions): Promise<MonitorJobResult>;
+    private namedMonitorBatchPath;
+    syncNamedMonitorBatch(batchId: string, definitions: MonitorDefinition[], options?: MonitorNamedBatchOptions): Promise<MonitorJobResult>;
+    startNamedMonitorBatch(batchId: string, options?: Pick<MonitorNamedBatchOptions, 'idempotencyKey'>): Promise<MonitorJobResult>;
+    stopNamedMonitorBatch(batchId: string, options?: Pick<MonitorNamedBatchOptions, 'idempotencyKey'>): Promise<MonitorJobResult>;
+    getNamedMonitorBatch(batchId: string): Promise<MonitorJobResult>;
+    submitScalarMonitorLifecycle(monitorKey: string, action: 'start' | 'stop', options?: Pick<MonitorLifecycleOptions, 'idempotencyKey'>): Promise<MonitorJobResult>;
+    syncScalarMonitor(definition: MonitorDefinition, options?: Pick<MonitorLifecycleOptions, 'idempotencyKey'>): Promise<MonitorJobResult>;
     getMonitorJob(jobId: string): Promise<MonitorJobResult>;
     getMonitorJobLogs(jobId: string, options?: MonitorJobLogsOptions): Promise<MonitorJobResult>;
     cancelMonitorJob(jobId: string): Promise<MonitorJobResult>;
@@ -6305,4 +6447,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type 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 MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobResult, type MonitorJobWaitOptions, type MonitorJobsNamespace, 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, ToolResultBilling, 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 };
+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 LegacyMonitorStatusFilter, type LiveEventEnvelope, MONITOR_JOB_PHASES, MONITOR_JOB_RECONCILIATION_STATES, MONITOR_JOB_STATES, type MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobPhase, type MonitorJobReconciliationState, type MonitorJobResult, type MonitorJobState, type MonitorJobWaitOptions, type MonitorJobsNamespace, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorState, type MonitorStateFilter, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayAsyncCallOptions, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayCostEstimate, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type 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, ToolResultBilling, 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.d.ts

@@ -3272,10 +3272,26 @@ type MonitorsAvailableOptions = {
     /** Ask the server for high-signal fields only. */
     compact?: boolean;
 };
+/**
+ * Stable customer-facing Monitor/Fleet state.
+ *
+ * Provider provisioning, cleanup, retries, and failures are Monitor Job
+ * progress and must never be added to this union. The `status` and `active`
+ * fields below are retained only as deprecated compatibility aliases for
+ * older API responses.
+ */
+type MonitorState = 'active' | 'billing_suspended' | 'disabled';
+/** List filters accepted by the canonical state surface. */
+type MonitorStateFilter = MonitorState | 'all';
+/** The pre-state list filter retained for installed-client compatibility. */
+type LegacyMonitorStatusFilter = 'active' | 'inactive' | 'all';
 /** One deployed monitor row returned by `client.monitors.list(...)`. */
 type MonitorListEntry = {
     key?: string;
     monitor_key?: string;
+    /** Canonical customer-facing lifecycle state. */
+    state?: MonitorState;
+    /** @deprecated Use state. `inactive` is projected as `disabled`. */
     status?: string;
     tool?: string;
     /** Generic provider-authored event category for this deployed monitor. */
@@ -3304,7 +3320,18 @@ type MonitorsListResult = {
     /** @deprecated Use has_more. */
     is_truncated?: boolean;
     next_cursor?: string | null;
+    /** Canonical state filter echoed by newer servers. */
+    state_filter_applied?: MonitorStateFilter;
+    /** Canonical state counts. */
+    state_summary?: Array<{
+        state: MonitorState;
+        count: number;
+    }>;
+    /** Whether state_summary counts this page or the full applied state filter. */
+    state_summary_scope?: 'page' | 'filter_total';
+    /** @deprecated Use state_filter_applied. */
     status_filter_applied?: string;
+    /** @deprecated Use state_summary. */
     status_summary?: Array<{
         status: string;
         count: number;
@@ -3314,8 +3341,10 @@ type MonitorsListResult = {
 };
 /** Options for `client.monitors.list(...)`. */
 type MonitorsListOptions = {
-    /** active (default), disabled, or all. */
-    status?: string;
+    /** Canonical customer state filter; active is the default. */
+    state?: MonitorStateFilter;
+    /** @deprecated Use state. `inactive` remains accepted for old servers. */
+    status?: LegacyMonitorStatusFilter | (string & {});
     limit?: number | string;
     /** Page past a truncated result using a prior response's `next_cursor`. */
     cursor?: string;
@@ -3345,6 +3374,12 @@ type MonitorSpec = {
 };
 /** One deployed-monitor read. The server may add monitor-specific fields. */
 type MonitorDetail = Record<string, unknown> & {
+    /** Canonical customer-facing lifecycle state. */
+    state?: MonitorState;
+    /** @deprecated Use state. */
+    status?: string;
+    /** @deprecated Use state. */
+    active?: boolean;
     monitor_spec?: MonitorSpec;
 };
 type MonitorDependents = Record<string, unknown>;
@@ -3397,18 +3432,94 @@ type MonitorValidateResult = Record<string, unknown>;
 /**
  * Server-owned fleet response envelope.
  *
- * The server computes `status` (`converging` | `converged` | `degraded` |
- * `deactivating` | `deactivated`) and the SDK never recomputes it: a client
- * that derives its own verdict from counts drifts from the control plane the
- * moment the server changes what "converged" means.
+ * The server computes the canonical customer `state` and the SDK never
+ * recomputes it. Transitional convergence details remain in the owning Fleet
+ * Job; the deprecated `status` alias is retained only for installed clients.
  */
-type MonitorFleetResult = Record<string, unknown>;
-/** Shared response envelope for immutable batch and desired-set Monitor Jobs. */
-type MonitorJobResult = Record<string, unknown>;
+type MonitorFleetResult = Record<string, unknown> & {
+    /** Canonical customer-facing Fleet state. */
+    state?: MonitorState;
+    /** @deprecated Fleet operation/convergence status; use state + jobs. */
+    status?: string;
+};
+/** Standalone SDK mirror of the server-owned Monitor Job contract. */
+declare const MONITOR_JOB_STATES: readonly ["queued", "running", "cancelling", "succeeded", "failed", "cancelled"];
+type MonitorJobState = (typeof MONITOR_JOB_STATES)[number];
+declare const MONITOR_JOB_PHASES: readonly ["queued", "provider_create", "provider_readback", "reconciliation", "completed"];
+type MonitorJobPhase = (typeof MONITOR_JOB_PHASES)[number];
+declare const MONITOR_JOB_RECONCILIATION_STATES: readonly ["pending", "aligned", "partial", "mismatched"];
+type MonitorJobReconciliationState = (typeof MONITOR_JOB_RECONCILIATION_STATES)[number];
+type MonitorJobProjection = {
+    id: string;
+    kind: 'batch_deploy' | 'fleet_deploy';
+    state: MonitorJobState;
+    phase: MonitorJobPhase;
+    target: {
+        monitor_key?: string;
+        batch_id?: string;
+        generation?: number;
+        fleet_id?: string;
+    };
+    counts: {
+        requested: number;
+        valid: number;
+        queued: number;
+        running: number;
+        created: number;
+        updated: number;
+        removed: number;
+        unchanged: number;
+        settled: number;
+        verified: number;
+        failed: number;
+        cancelled_before_start: number;
+    };
+    reconciliation: {
+        state: MonitorJobReconciliationState;
+        expected_bindings: number;
+        observed_bindings: number;
+        active_mismatches: number;
+        provider_only_matching_markers: number;
+        next?: string;
+    };
+    error?: string;
+};
+type MonitorNamedBatchProjection = {
+    id: string;
+    state: 'active' | 'stopped';
+    generation: number;
+    desired_count: number;
+    retained_count: number;
+    last_job_id: string;
+    updated_at: string;
+};
+/** Shared typed envelope for immutable batch and desired-set Monitor Jobs. */
+type MonitorJobResult = {
+    ok?: boolean;
+    job?: MonitorJobProjection;
+    batch?: MonitorNamedBatchProjection;
+    logs?: Array<{
+        level: string;
+        phase: string;
+        message: string;
+        monitor_key?: string;
+        at: string;
+    }>;
+    replayed?: boolean;
+    already_terminal?: boolean;
+    next?: string;
+    [key: string]: unknown;
+};
 type MonitorJobDeployOptions = {
     /** Stable retry key; the server binds it to the submitted immutable set. */
     idempotencyKey?: string;
 };
+type MonitorLifecycleOptions = {
+    /** Return the plan without changing provider state. */
+    dryRun?: boolean;
+    /** Stable retry key for durable start/stop work. */
+    idempotencyKey?: string;
+};
 type MonitorJobLogsOptions = {
     limit?: number;
 };
@@ -3499,7 +3610,7 @@ type MonitorBatchOperationResult = {
     rejoined?: boolean;
     operation: {
         runId: string;
-        kind: 'audit' | 'converge' | 'deactivate' | 'reactivate' | 'deploy' | 'repair';
+        kind: 'audit' | 'converge' | 'deactivate' | 'reactivate' | 'deploy' | 'repair' | 'named_batch';
         state: 'running' | 'retry_scheduled' | 'completed' | 'failed' | 'cancelled';
         dryRun: boolean;
         scope: unknown;
@@ -3536,6 +3647,10 @@ type MonitorFleetsNamespace = {
     deactivate: (fleetId: string, options?: MonitorFleetDeactivateOptions) => Promise<MonitorFleetResult>;
     /** Explicitly recreate a fleet after a credit-triggered suspension. */
     reactivate: (fleetId: string, options?: MonitorFleetReactivateOptions) => Promise<MonitorFleetResult>;
+    /** Customer-facing alias for `reactivate`. */
+    start: (fleetId: string, options?: MonitorFleetReactivateOptions) => Promise<MonitorFleetResult>;
+    /** Customer-facing alias for `deactivate`. */
+    stop: (fleetId: string, options?: MonitorFleetDeactivateOptions) => Promise<MonitorFleetResult>;
     /** Poll the fleet until the server reports a terminal status (or the timeout elapses). */
     waitForConvergence: (fleetId: string, options?: MonitorFleetWaitOptions) => Promise<MonitorFleetResult>;
 };
@@ -3547,6 +3662,16 @@ type MonitorBatchNamespace = {
         cursor?: string | null;
     }) => Promise<MonitorBatchOperationResult>;
 };
+type MonitorNamedBatchOptions = {
+    idempotencyKey?: string;
+    expectedGeneration?: number;
+};
+type MonitorNamedBatchesNamespace = {
+    sync: (batchId: string, definitions: MonitorDefinition[], options?: MonitorNamedBatchOptions) => Promise<MonitorJobResult>;
+    start: (batchId: string, options?: Pick<MonitorNamedBatchOptions, 'idempotencyKey'>) => Promise<MonitorJobResult>;
+    stop: (batchId: string, options?: Pick<MonitorNamedBatchOptions, 'idempotencyKey'>) => Promise<MonitorJobResult>;
+    get: (batchId: string) => Promise<MonitorJobResult>;
+};
 /**
  * Delivery and convergence health for a scope, from
  * `GET /api/v2/monitors/health`.
@@ -3612,7 +3737,7 @@ type MonitorsHealth = {
     /** Bounded current durable monitor work, if the server supports it. */
     batch_operations?: Array<{
         run_id: string;
-        kind: 'audit' | 'converge' | 'deactivate' | 'reactivate' | 'repair' | 'deploy';
+        kind: 'audit' | 'converge' | 'deactivate' | 'named_batch' | 'reactivate' | 'repair' | 'deploy';
         state: 'running' | 'retry_scheduled';
         updated_at: number;
         next_attempt_at?: number;
@@ -3716,7 +3841,11 @@ type MonitorsNamespace = {
     deploy: (definition: MonitorDefinition, options?: {
         dryRun?: boolean;
     }) => Promise<MonitorDeployResult>;
-    /** List deployed monitors (active by default). `includeConsumers` requires a limit of 20 or fewer. */
+    /** Set the desired definition for one stable monitor key. */
+    sync: (definition: MonitorDefinition, options?: MonitorLifecycleOptions) => Promise<MonitorJobResult | MonitorDeployResult>;
+    /** List deployed monitors (active by default). Use `state` to filter the
+     * three customer states; `status` is retained for older servers.
+     * `includeConsumers` requires a limit of 20 or fewer. */
     list: (options?: MonitorsListOptions) => Promise<MonitorsListResult>;
     /** Fetch one deployed monitor by public key with bounded current listener health. */
     get: (key: string) => Promise<MonitorDetail>;
@@ -3735,6 +3864,10 @@ type MonitorsNamespace = {
     reactivate: (key: string, options?: {
         dryRun?: boolean;
     }) => Promise<MonitorReactivateResult>;
+    /** Explicitly apply the retained definition for a stopped monitor. */
+    start: (key: string, options?: MonitorLifecycleOptions) => Promise<MonitorJobResult | MonitorBatchOperationResult>;
+    /** Converge one monitor to inactive while retaining its definition. */
+    stop: (key: string, options?: MonitorLifecycleOptions) => Promise<MonitorJobResult | MonitorBatchOperationResult>;
     /**
      * Re-read what the provider holds onto the monitors that claim it. Bounded
      * and idempotent: pass `cursor` back while `audit.cursor` is non-null.
@@ -3759,6 +3892,8 @@ type MonitorsNamespace = {
     fleets: MonitorFleetsNamespace;
     /** Deploy an immutable one-off list through the common Monitor Job engine. */
     batch: MonitorBatchNamespace;
+    /** Reconcile and control a stable named static Batch. */
+    batches: MonitorNamedBatchesNamespace;
     /** Read, wait for, inspect, or cancel Monitor Jobs. */
     jobs: MonitorJobsNamespace;
 };
@@ -5266,6 +5401,13 @@ declare class DeeplineClient {
     private monitorJobIdempotencyKey;
     private monitorJobHeaders;
     deployMonitorBatch(definitions: MonitorDefinition[], options?: MonitorJobDeployOptions): Promise<MonitorJobResult>;
+    private namedMonitorBatchPath;
+    syncNamedMonitorBatch(batchId: string, definitions: MonitorDefinition[], options?: MonitorNamedBatchOptions): Promise<MonitorJobResult>;
+    startNamedMonitorBatch(batchId: string, options?: Pick<MonitorNamedBatchOptions, 'idempotencyKey'>): Promise<MonitorJobResult>;
+    stopNamedMonitorBatch(batchId: string, options?: Pick<MonitorNamedBatchOptions, 'idempotencyKey'>): Promise<MonitorJobResult>;
+    getNamedMonitorBatch(batchId: string): Promise<MonitorJobResult>;
+    submitScalarMonitorLifecycle(monitorKey: string, action: 'start' | 'stop', options?: Pick<MonitorLifecycleOptions, 'idempotencyKey'>): Promise<MonitorJobResult>;
+    syncScalarMonitor(definition: MonitorDefinition, options?: Pick<MonitorLifecycleOptions, 'idempotencyKey'>): Promise<MonitorJobResult>;
     getMonitorJob(jobId: string): Promise<MonitorJobResult>;
     getMonitorJobLogs(jobId: string, options?: MonitorJobLogsOptions): Promise<MonitorJobResult>;
     cancelMonitorJob(jobId: string): Promise<MonitorJobResult>;
@@ -6305,4 +6447,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
  */
 declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
 
-export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type 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 MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobResult, type MonitorJobWaitOptions, type MonitorJobsNamespace, 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, ToolResultBilling, 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 };
+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 LegacyMonitorStatusFilter, type LiveEventEnvelope, MONITOR_JOB_PHASES, MONITOR_JOB_RECONCILIATION_STATES, MONITOR_JOB_STATES, type MonitorBatchNamespace, type MonitorCheckResult, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorFleetDeactivateOptions, MonitorFleetDefinition, type MonitorFleetGetOptions, type MonitorFleetReactivateOptions, type MonitorFleetResult, type MonitorFleetStatus, type MonitorFleetSyncOptions, type MonitorFleetWaitOptions, type MonitorFleetsNamespace, type MonitorJobDeployOptions, type MonitorJobLogsOptions, type MonitorJobPhase, type MonitorJobReconciliationState, type MonitorJobResult, type MonitorJobState, type MonitorJobWaitOptions, type MonitorJobsNamespace, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorState, type MonitorStateFilter, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayAsyncCallOptions, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayCostEstimate, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type 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, ToolResultBilling, 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 };