deepline 0.3.97 → 0.3.98

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/dist/bundling-sources/sdk/src/client.ts +144 -4
  2. package/dist/bundling-sources/sdk/src/index.ts +17 -4
  3. package/dist/bundling-sources/sdk/src/monitor-fleets.ts +1 -0
  4. package/dist/bundling-sources/sdk/src/monitor-input-contract.ts +1 -0
  5. package/dist/bundling-sources/sdk/src/monitors.ts +8 -25
  6. package/dist/bundling-sources/sdk/src/release.ts +1 -1
  7. package/dist/bundling-sources/shared_libs/integration-contracts/index.ts +1 -0
  8. package/dist/bundling-sources/shared_libs/integration-contracts/monitor-fleet-contract.ts +218 -16
  9. package/dist/bundling-sources/shared_libs/integration-contracts/monitor-input-contract.ts +455 -0
  10. package/dist/bundling-sources/shared_libs/monitors/fleets/plan.ts +6 -1
  11. package/dist/bundling-sources/shared_libs/monitors/provider-monitor-batch-operation.ts +2 -1
  12. package/dist/bundling-sources/shared_libs/observability/scheduled-jobs.json +12 -0
  13. package/dist/bundling-sources/shared_libs/observability/scheduled-work-manual.ts +1 -0
  14. package/dist/bundling-sources/shared_libs/play-runtime/internal-bootstrap-token.ts +19 -3
  15. package/dist/bundling-sources/shared_libs/plays/bundling/index.ts +5 -1
  16. package/dist/cli/index.js +1004 -289
  17. package/dist/cli/index.mjs +1004 -289
  18. package/dist/index.d.mts +43 -24
  19. package/dist/index.d.ts +43 -24
  20. package/dist/index.js +604 -41
  21. package/dist/index.mjs +600 -41
  22. package/dist/install-integrity.json +6 -0
  23. package/dist/monitor-fleet-contract.d.mts +44 -8
  24. package/dist/monitor-fleet-contract.d.ts +44 -8
  25. package/dist/monitor-fleet-contract.js +354 -27
  26. package/dist/monitor-fleet-contract.mjs +343 -27
  27. package/dist/monitor-input-contract.d.mts +33 -0
  28. package/dist/monitor-input-contract.d.ts +33 -0
  29. package/dist/monitor-input-contract.js +392 -0
  30. package/dist/monitor-input-contract.mjs +353 -0
  31. package/dist/plays/bundle-play-file.mjs +1 -1
  32. package/dist/release.d.mts +1 -1
  33. package/dist/release.d.ts +1 -1
  34. package/dist/release.js +1 -1
  35. package/dist/release.mjs +1 -1
  36. package/package.json +7 -1
package/dist/index.d.mts CHANGED
@@ -2,7 +2,8 @@
2
2
  import { c as PlayCompilerManifest, A as AsyncPlayRunRef$1, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, T as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringAsyncCallOptions, y as PlayAuthoringBindings, z as PlayAuthoringCallExecution, B as PlayAuthoringCallOptions, C as PlayAuthoringFetchResponse, D as PlayAuthoringInputContract, E as PlayRunId$1, F as PlayAuthoringStepProgramStep, G as PlayAuthoringRuntimeStepOptions, H as PlaySqlListenerDeclaration, I as PlaySqlListenerEvent, J as PlaySqlListenerOperation, K as PlaySqlQuery, L as PlayAuthoringStepOptions, M as PlayAuthoringStepProgram, N as PlayAuthoringStepProgramResolver, O as PlayAuthoringStepResolver, Q as PlayToolExecutionRequest, R as PlayAuthoringStepProgramOptions, S as DeeplineError, U as ToolExecutionError, V as ToolExecutionErrorOptions } from './compiler-manifest-x14KL83E.mjs';
3
3
  export { W as CtxFetchHttpError, X as DEEPLINE_EXTRACTOR_TARGETS, Y as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, Z as DeeplineEmailStatusGetterValue, _ as DeeplineExtractorTarget, $ as DeeplineGetterValue, a0 as DeeplineGetterValueMap, a1 as JOB_CHANGE_STATUS_VALUES, a2 as JobChangeStatus, a3 as PHONE_STATUS_VALUES, a4 as PhoneStatus, a5 as PlayDataset, a6 as PlayDatasetInput, a7 as PreviousCell, a8 as ProviderTransientError, a9 as ProviderTransientErrorCategory, aa as ProviderUnavailableError, ab as ProviderUnavailableReason, ac as ToolExecutionErrorCategory, ad as ToolExecutionErrorOrigin, ae as ToolExecutionFailureV1, af as ToolExecutionNetworkKind, ag as ToolExecutionNetworkScope, ah as ToolExecutionPublicDetails, ai as getProviderUnavailableReason, aj as isDeeplineExtractorTarget, ak as isProviderUnavailable, al as isProviderWaterfallUnavailableError } from './compiler-manifest-x14KL83E.mjs';
4
4
  import { MonitorFleetDefinition } from './monitor-fleet-contract.mjs';
5
- 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.mjs';
5
+ 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, lintMonitorFleetInput, validateMonitorFleetDefinition } from './monitor-fleet-contract.mjs';
6
+ export { BatchMonitorInput, MonitorInputIssue, MonitorSpec as MonitorInputSpec, lintMonitorBatchInput, lintMonitorSpecTemplate, renderMonitorSpecTemplate } from './monitor-input-contract.mjs';
6
7
  import '@sinclair/typebox';
7
8
 
8
9
  type ProductNotificationFactValue = string | number | boolean;
@@ -2584,27 +2585,9 @@ type MonitorDefinition<TPayload extends MonitorPayload = MonitorPayload> = {
2584
2585
  name?: string;
2585
2586
  /** Provider-specific monitor payload (e.g. domain + radar_type). */
2586
2587
  payload: TPayload;
2587
- /** Optional Deepline lifecycle metadata (deploy/reuse controls). */
2588
- controls?: MonitorControls;
2589
2588
  };
2590
2589
  /** Provider-specific monitor payload. Keys and value types depend on the tool. */
2591
2590
  type MonitorPayload = Record<string, unknown>;
2592
- /**
2593
- * Deepline lifecycle metadata attached to a monitor definition. These are
2594
- * Deepline-side deploy/reuse controls, not provider payload fields. The set is
2595
- * intentionally open (server-owned) so newer controls do not require an SDK
2596
- * bump; known controls are typed for discoverability.
2597
- */
2598
- type MonitorControls = {
2599
- /**
2600
- * Request Deepline Native priority execution for a bounded urgent preview or
2601
- * calibration radar. Deepline sends the upstream custom-field marker and
2602
- * enforces a maximum of ten active or in-flight priority radars per org.
2603
- * Omit this for regular and bulk-scale monitoring.
2604
- */
2605
- execution_type?: 'priority';
2606
- [key: string]: unknown;
2607
- };
2608
2591
  /**
2609
2592
  * Define a typed monitor definition.
2610
2593
  *
@@ -3203,6 +3186,26 @@ type MonitorValidateResult = Record<string, unknown>;
3203
3186
  * moment the server changes what "converged" means.
3204
3187
  */
3205
3188
  type MonitorFleetResult = Record<string, unknown>;
3189
+ /** Shared response envelope for immutable batch and desired-set Monitor Jobs. */
3190
+ type MonitorJobResult = Record<string, unknown>;
3191
+ type MonitorJobDeployOptions = {
3192
+ /** Stable retry key; the server binds it to the submitted immutable set. */
3193
+ idempotencyKey?: string;
3194
+ };
3195
+ type MonitorJobLogsOptions = {
3196
+ limit?: number;
3197
+ };
3198
+ type MonitorJobWaitOptions = {
3199
+ timeoutMs?: number;
3200
+ pollIntervalMs?: number;
3201
+ onProgress?: (payload: MonitorJobResult) => void;
3202
+ };
3203
+ type MonitorJobsNamespace = {
3204
+ get: (jobId: string) => Promise<MonitorJobResult>;
3205
+ logs: (jobId: string, options?: MonitorJobLogsOptions) => Promise<MonitorJobResult>;
3206
+ cancel: (jobId: string) => Promise<MonitorJobResult>;
3207
+ wait: (jobId: string, options?: MonitorJobWaitOptions) => Promise<MonitorJobResult>;
3208
+ };
3206
3209
  /** Server-computed fleet verdict. Never derived client-side. */
3207
3210
  type MonitorFleetStatus = 'converging' | 'converged' | 'degraded' | 'deactivating' | 'deactivated' | 'billing_suspending' | 'billing_suspended' | 'billing_reactivating';
3208
3211
  type MonitorFleetSyncOptions = {
@@ -3277,7 +3280,7 @@ type MonitorBatchOperationResult = {
3277
3280
  operation: {
3278
3281
  runId: string;
3279
3282
  kind: 'audit' | 'converge' | 'deactivate' | 'reactivate' | 'deploy' | 'repair';
3280
- state: 'running' | 'retry_scheduled' | 'completed' | 'failed';
3283
+ state: 'running' | 'retry_scheduled' | 'completed' | 'failed' | 'cancelled';
3281
3284
  dryRun: boolean;
3282
3285
  scope: unknown;
3283
3286
  submittedAt: number;
@@ -3296,7 +3299,12 @@ type MonitorBatchOperationResult = {
3296
3299
  };
3297
3300
  type MonitorFleetsNamespace = {
3298
3301
  /**
3299
- * Create, update, or re-plan a fleet. Pass a definition to admit new source
3302
+ * Primary table-backed Fleet command. It has the same idempotent PUT
3303
+ * contract as `sync`; `sync` remains for installed-client compatibility.
3304
+ */
3305
+ deploy: (definitionOrId: string | MonitorFleetDefinition, options?: MonitorFleetSyncOptions) => Promise<MonitorFleetResult>;
3306
+ /**
3307
+ * Compatibility alias for `deploy`. Pass a definition to admit new source
3300
3308
  * of truth; pass a fleet id to re-plan from the stored definition.
3301
3309
  */
3302
3310
  sync: (definitionOrId: string | MonitorFleetDefinition, options?: MonitorFleetSyncOptions) => Promise<MonitorFleetResult>;
@@ -3312,6 +3320,8 @@ type MonitorFleetsNamespace = {
3312
3320
  waitForConvergence: (fleetId: string, options?: MonitorFleetWaitOptions) => Promise<MonitorFleetResult>;
3313
3321
  };
3314
3322
  type MonitorBatchNamespace = {
3323
+ /** Deploy an immutable one-off list through the common Monitor Job engine. */
3324
+ deploy: (definitions: MonitorDefinition[], options?: MonitorJobDeployOptions) => Promise<MonitorJobResult>;
3315
3325
  submit: (options: MonitorBatchSubmitOptions) => Promise<MonitorBatchOperationResult>;
3316
3326
  get: (operationId: string, options?: {
3317
3327
  cursor?: string | null;
@@ -3525,10 +3535,12 @@ type MonitorsNamespace = {
3525
3535
  health: (options?: {
3526
3536
  fleetId?: string;
3527
3537
  }) => Promise<MonitorsHealth>;
3528
- /** Durable bulk audit/deactivation/reactivation/repair with retained progress. */
3529
- batch: MonitorBatchNamespace;
3530
3538
  /** Define, reconcile, and control table-backed monitor fleets. */
3531
3539
  fleets: MonitorFleetsNamespace;
3540
+ /** Deploy an immutable one-off list through the common Monitor Job engine. */
3541
+ batch: MonitorBatchNamespace;
3542
+ /** Read, wait for, inspect, or cancel Monitor Jobs. */
3543
+ jobs: MonitorJobsNamespace;
3532
3544
  };
3533
3545
  /** One credit grant pool reported by the billing subscription status endpoint. */
3534
3546
  type BillingCreditPool = {
@@ -4996,6 +5008,13 @@ declare class DeeplineClient {
4996
5008
  reactivateMonitor(key: string, options?: {
4997
5009
  dryRun?: boolean;
4998
5010
  }): Promise<MonitorReactivateResult>;
5011
+ private monitorJobIdempotencyKey;
5012
+ private monitorJobHeaders;
5013
+ deployMonitorBatch(definitions: MonitorDefinition[], options?: MonitorJobDeployOptions): Promise<MonitorJobResult>;
5014
+ getMonitorJob(jobId: string): Promise<MonitorJobResult>;
5015
+ getMonitorJobLogs(jobId: string, options?: MonitorJobLogsOptions): Promise<MonitorJobResult>;
5016
+ cancelMonitorJob(jobId: string): Promise<MonitorJobResult>;
5017
+ waitForMonitorJob(jobId: string, options?: MonitorJobWaitOptions): Promise<MonitorJobResult>;
4999
5018
  private monitorFleetIdempotencyKey;
5000
5019
  private monitorFleetHeaders;
5001
5020
  private monitorFleetPath;
@@ -6031,4 +6050,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
6031
6050
  */
6032
6051
  declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
6033
6052
 
6034
- 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 };
6053
+ 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, 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 CHANGED
@@ -2,7 +2,8 @@
2
2
  import { c as PlayCompilerManifest, A as AsyncPlayRunRef$1, i as PlayAuthoringColumnMap, j as PlayAuthoringColumnResolver, k as PlayAuthoringRuntimeContext, l as PlayAuthoringConditionalStepResolver, m as PlayAuthoringCsvInput, n as PlayAuthoringCsvOptions, o as PlayAuthoringDatasetBuilder, p as PlayAuthoringDatasetColumnDefinition, q as PlayAuthoringDatasetColumnRunInput, T as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringAsyncCallOptions, y as PlayAuthoringBindings, z as PlayAuthoringCallExecution, B as PlayAuthoringCallOptions, C as PlayAuthoringFetchResponse, D as PlayAuthoringInputContract, E as PlayRunId$1, F as PlayAuthoringStepProgramStep, G as PlayAuthoringRuntimeStepOptions, H as PlaySqlListenerDeclaration, I as PlaySqlListenerEvent, J as PlaySqlListenerOperation, K as PlaySqlQuery, L as PlayAuthoringStepOptions, M as PlayAuthoringStepProgram, N as PlayAuthoringStepProgramResolver, O as PlayAuthoringStepResolver, Q as PlayToolExecutionRequest, R as PlayAuthoringStepProgramOptions, S as DeeplineError, U as ToolExecutionError, V as ToolExecutionErrorOptions } from './compiler-manifest-x14KL83E.js';
3
3
  export { W as CtxFetchHttpError, X as DEEPLINE_EXTRACTOR_TARGETS, Y as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, Z as DeeplineEmailStatusGetterValue, _ as DeeplineExtractorTarget, $ as DeeplineGetterValue, a0 as DeeplineGetterValueMap, a1 as JOB_CHANGE_STATUS_VALUES, a2 as JobChangeStatus, a3 as PHONE_STATUS_VALUES, a4 as PhoneStatus, a5 as PlayDataset, a6 as PlayDatasetInput, a7 as PreviousCell, a8 as ProviderTransientError, a9 as ProviderTransientErrorCategory, aa as ProviderUnavailableError, ab as ProviderUnavailableReason, ac as ToolExecutionErrorCategory, ad as ToolExecutionErrorOrigin, ae as ToolExecutionFailureV1, af as ToolExecutionNetworkKind, ag as ToolExecutionNetworkScope, ah as ToolExecutionPublicDetails, ai as getProviderUnavailableReason, aj as isDeeplineExtractorTarget, ak as isProviderUnavailable, al as isProviderWaterfallUnavailableError } from './compiler-manifest-x14KL83E.js';
4
4
  import { MonitorFleetDefinition } from './monitor-fleet-contract.js';
5
- 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';
5
+ 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, lintMonitorFleetInput, validateMonitorFleetDefinition } from './monitor-fleet-contract.js';
6
+ export { BatchMonitorInput, MonitorInputIssue, MonitorSpec as MonitorInputSpec, lintMonitorBatchInput, lintMonitorSpecTemplate, renderMonitorSpecTemplate } from './monitor-input-contract.js';
6
7
  import '@sinclair/typebox';
7
8
 
8
9
  type ProductNotificationFactValue = string | number | boolean;
@@ -2584,27 +2585,9 @@ type MonitorDefinition<TPayload extends MonitorPayload = MonitorPayload> = {
2584
2585
  name?: string;
2585
2586
  /** Provider-specific monitor payload (e.g. domain + radar_type). */
2586
2587
  payload: TPayload;
2587
- /** Optional Deepline lifecycle metadata (deploy/reuse controls). */
2588
- controls?: MonitorControls;
2589
2588
  };
2590
2589
  /** Provider-specific monitor payload. Keys and value types depend on the tool. */
2591
2590
  type MonitorPayload = Record<string, unknown>;
2592
- /**
2593
- * Deepline lifecycle metadata attached to a monitor definition. These are
2594
- * Deepline-side deploy/reuse controls, not provider payload fields. The set is
2595
- * intentionally open (server-owned) so newer controls do not require an SDK
2596
- * bump; known controls are typed for discoverability.
2597
- */
2598
- type MonitorControls = {
2599
- /**
2600
- * Request Deepline Native priority execution for a bounded urgent preview or
2601
- * calibration radar. Deepline sends the upstream custom-field marker and
2602
- * enforces a maximum of ten active or in-flight priority radars per org.
2603
- * Omit this for regular and bulk-scale monitoring.
2604
- */
2605
- execution_type?: 'priority';
2606
- [key: string]: unknown;
2607
- };
2608
2591
  /**
2609
2592
  * Define a typed monitor definition.
2610
2593
  *
@@ -3203,6 +3186,26 @@ type MonitorValidateResult = Record<string, unknown>;
3203
3186
  * moment the server changes what "converged" means.
3204
3187
  */
3205
3188
  type MonitorFleetResult = Record<string, unknown>;
3189
+ /** Shared response envelope for immutable batch and desired-set Monitor Jobs. */
3190
+ type MonitorJobResult = Record<string, unknown>;
3191
+ type MonitorJobDeployOptions = {
3192
+ /** Stable retry key; the server binds it to the submitted immutable set. */
3193
+ idempotencyKey?: string;
3194
+ };
3195
+ type MonitorJobLogsOptions = {
3196
+ limit?: number;
3197
+ };
3198
+ type MonitorJobWaitOptions = {
3199
+ timeoutMs?: number;
3200
+ pollIntervalMs?: number;
3201
+ onProgress?: (payload: MonitorJobResult) => void;
3202
+ };
3203
+ type MonitorJobsNamespace = {
3204
+ get: (jobId: string) => Promise<MonitorJobResult>;
3205
+ logs: (jobId: string, options?: MonitorJobLogsOptions) => Promise<MonitorJobResult>;
3206
+ cancel: (jobId: string) => Promise<MonitorJobResult>;
3207
+ wait: (jobId: string, options?: MonitorJobWaitOptions) => Promise<MonitorJobResult>;
3208
+ };
3206
3209
  /** Server-computed fleet verdict. Never derived client-side. */
3207
3210
  type MonitorFleetStatus = 'converging' | 'converged' | 'degraded' | 'deactivating' | 'deactivated' | 'billing_suspending' | 'billing_suspended' | 'billing_reactivating';
3208
3211
  type MonitorFleetSyncOptions = {
@@ -3277,7 +3280,7 @@ type MonitorBatchOperationResult = {
3277
3280
  operation: {
3278
3281
  runId: string;
3279
3282
  kind: 'audit' | 'converge' | 'deactivate' | 'reactivate' | 'deploy' | 'repair';
3280
- state: 'running' | 'retry_scheduled' | 'completed' | 'failed';
3283
+ state: 'running' | 'retry_scheduled' | 'completed' | 'failed' | 'cancelled';
3281
3284
  dryRun: boolean;
3282
3285
  scope: unknown;
3283
3286
  submittedAt: number;
@@ -3296,7 +3299,12 @@ type MonitorBatchOperationResult = {
3296
3299
  };
3297
3300
  type MonitorFleetsNamespace = {
3298
3301
  /**
3299
- * Create, update, or re-plan a fleet. Pass a definition to admit new source
3302
+ * Primary table-backed Fleet command. It has the same idempotent PUT
3303
+ * contract as `sync`; `sync` remains for installed-client compatibility.
3304
+ */
3305
+ deploy: (definitionOrId: string | MonitorFleetDefinition, options?: MonitorFleetSyncOptions) => Promise<MonitorFleetResult>;
3306
+ /**
3307
+ * Compatibility alias for `deploy`. Pass a definition to admit new source
3300
3308
  * of truth; pass a fleet id to re-plan from the stored definition.
3301
3309
  */
3302
3310
  sync: (definitionOrId: string | MonitorFleetDefinition, options?: MonitorFleetSyncOptions) => Promise<MonitorFleetResult>;
@@ -3312,6 +3320,8 @@ type MonitorFleetsNamespace = {
3312
3320
  waitForConvergence: (fleetId: string, options?: MonitorFleetWaitOptions) => Promise<MonitorFleetResult>;
3313
3321
  };
3314
3322
  type MonitorBatchNamespace = {
3323
+ /** Deploy an immutable one-off list through the common Monitor Job engine. */
3324
+ deploy: (definitions: MonitorDefinition[], options?: MonitorJobDeployOptions) => Promise<MonitorJobResult>;
3315
3325
  submit: (options: MonitorBatchSubmitOptions) => Promise<MonitorBatchOperationResult>;
3316
3326
  get: (operationId: string, options?: {
3317
3327
  cursor?: string | null;
@@ -3525,10 +3535,12 @@ type MonitorsNamespace = {
3525
3535
  health: (options?: {
3526
3536
  fleetId?: string;
3527
3537
  }) => Promise<MonitorsHealth>;
3528
- /** Durable bulk audit/deactivation/reactivation/repair with retained progress. */
3529
- batch: MonitorBatchNamespace;
3530
3538
  /** Define, reconcile, and control table-backed monitor fleets. */
3531
3539
  fleets: MonitorFleetsNamespace;
3540
+ /** Deploy an immutable one-off list through the common Monitor Job engine. */
3541
+ batch: MonitorBatchNamespace;
3542
+ /** Read, wait for, inspect, or cancel Monitor Jobs. */
3543
+ jobs: MonitorJobsNamespace;
3532
3544
  };
3533
3545
  /** One credit grant pool reported by the billing subscription status endpoint. */
3534
3546
  type BillingCreditPool = {
@@ -4996,6 +5008,13 @@ declare class DeeplineClient {
4996
5008
  reactivateMonitor(key: string, options?: {
4997
5009
  dryRun?: boolean;
4998
5010
  }): Promise<MonitorReactivateResult>;
5011
+ private monitorJobIdempotencyKey;
5012
+ private monitorJobHeaders;
5013
+ deployMonitorBatch(definitions: MonitorDefinition[], options?: MonitorJobDeployOptions): Promise<MonitorJobResult>;
5014
+ getMonitorJob(jobId: string): Promise<MonitorJobResult>;
5015
+ getMonitorJobLogs(jobId: string, options?: MonitorJobLogsOptions): Promise<MonitorJobResult>;
5016
+ cancelMonitorJob(jobId: string): Promise<MonitorJobResult>;
5017
+ waitForMonitorJob(jobId: string, options?: MonitorJobWaitOptions): Promise<MonitorJobResult>;
4999
5018
  private monitorFleetIdempotencyKey;
5000
5019
  private monitorFleetHeaders;
5001
5020
  private monitorFleetPath;
@@ -6031,4 +6050,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
6031
6050
  */
6032
6051
  declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
6033
6052
 
6034
- 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 };
6053
+ 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, 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 };