deepline 0.3.246 → 0.3.248

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 (67) hide show
  1. package/dist/bundling-sources/sdk/src/client.ts +177 -13
  2. package/dist/bundling-sources/sdk/src/index.ts +8 -0
  3. package/dist/bundling-sources/sdk/src/plays/input-example.ts +40 -0
  4. package/dist/bundling-sources/sdk/src/release.ts +1 -1
  5. package/dist/bundling-sources/sdk/src/runs/overview.ts +457 -0
  6. package/dist/bundling-sources/sdk/src/runs/receipts.ts +23 -0
  7. package/dist/bundling-sources/sdk/src/tool-calls.ts +21 -1
  8. package/dist/bundling-sources/sdk/src/types.ts +16 -1
  9. package/dist/bundling-sources/shared_libs/observability/scheduled-jobs.json +37 -1
  10. package/dist/bundling-sources/shared_libs/observability/scheduled-work-manual.ts +1 -0
  11. package/dist/bundling-sources/shared_libs/play-data-plane/column-names.ts +17 -3
  12. package/dist/bundling-sources/shared_libs/play-data-plane/sheet-contract.ts +40 -8
  13. package/dist/bundling-sources/shared_libs/play-runtime/app-runtime-api.ts +26 -1
  14. package/dist/bundling-sources/shared_libs/play-runtime/context.ts +150 -19
  15. package/dist/bundling-sources/shared_libs/play-runtime/ctx-types.ts +2 -1
  16. package/dist/bundling-sources/shared_libs/play-runtime/daytona-runtime-config.ts +6 -3
  17. package/dist/bundling-sources/shared_libs/play-runtime/daytona-sandbox-janitor.ts +26 -21
  18. package/dist/bundling-sources/shared_libs/play-runtime/daytona-sandbox-reaper.ts +23 -21
  19. package/dist/bundling-sources/shared_libs/play-runtime/deployment/fly-machines.ts +17 -0
  20. package/dist/bundling-sources/shared_libs/play-runtime/log-context.ts +105 -0
  21. package/dist/bundling-sources/shared_libs/play-runtime/output-size-limits.ts +8 -1
  22. package/dist/bundling-sources/shared_libs/play-runtime/protocol.ts +9 -0
  23. package/dist/bundling-sources/shared_libs/play-runtime/run-ledger-event-transport.ts +40 -4
  24. package/dist/bundling-sources/shared_libs/play-runtime/run-ledger.ts +50 -5
  25. package/dist/bundling-sources/shared_libs/play-runtime/run-lifecycle-policy.ts +3 -1
  26. package/dist/bundling-sources/shared_libs/play-runtime/run-log-buffer.ts +28 -1
  27. package/dist/bundling-sources/shared_libs/play-runtime/runner-app/index.ts +14 -1
  28. package/dist/bundling-sources/shared_libs/play-runtime/runner-app/runtime-terminal-push.ts +56 -16
  29. package/dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona-control-transport.ts +184 -0
  30. package/dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona-launch-transport.ts +327 -0
  31. package/dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona-lifecycle.ts +87 -30
  32. package/dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona-session-execution.ts +24 -13
  33. package/dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona-start-admission.ts +23 -6
  34. package/dist/bundling-sources/shared_libs/play-runtime/runner-backends/backends/daytona.ts +76 -33
  35. package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/absurd-runtime-worker.ts +90 -35
  36. package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/postgres-pool.ts +16 -0
  37. package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/postgres-progress.ts +62 -21
  38. package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/postgres.ts +368 -66
  39. package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/receipt-gateway.ts +22 -4
  40. package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/run-ledger-outbox-recovery.ts +106 -81
  41. package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/runtime-event-search.ts +1347 -0
  42. package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/runtime-queue-health.ts +16 -19
  43. package/dist/bundling-sources/shared_libs/play-runtime/scheduler-backends/runtime-receipt-value-storage.ts +14 -6
  44. package/dist/bundling-sources/shared_libs/play-runtime/tool-execute-retry-policy.ts +16 -0
  45. package/dist/bundling-sources/shared_libs/play-runtime/tool-http-errors.ts +40 -0
  46. package/dist/bundling-sources/shared_libs/play-runtime/transient-service-error.ts +3 -2
  47. package/dist/bundling-sources/shared_libs/plays/authoring-contract.ts +5 -2
  48. package/dist/bundling-sources/shared_libs/plays/dataset-summary.ts +11 -7
  49. package/dist/bundling-sources/shared_libs/plays/static-pipeline-storage-codec.ts +5 -2
  50. package/dist/bundling-sources/shared_libs/plays/static-pipeline.ts +11 -2
  51. package/dist/cli/index.js +3504 -2368
  52. package/dist/cli/index.mjs +3188 -2052
  53. package/dist/{compiler-manifest-n8ZtPv2h.d.mts → compiler-manifest-DavmLa8y.d.mts} +1 -0
  54. package/dist/{compiler-manifest-n8ZtPv2h.d.ts → compiler-manifest-DavmLa8y.d.ts} +1 -0
  55. package/dist/index.d.mts +97 -5
  56. package/dist/index.d.ts +97 -5
  57. package/dist/index.js +135 -15
  58. package/dist/index.mjs +135 -15
  59. package/dist/install-integrity.json +9 -2
  60. package/dist/plays/bundle-play-file.d.mts +2 -2
  61. package/dist/plays/bundle-play-file.d.ts +2 -2
  62. package/dist/plays/bundle-play-file.mjs +1 -1
  63. package/dist/release.d.mts +1 -1
  64. package/dist/release.d.ts +1 -1
  65. package/dist/release.js +1 -1
  66. package/dist/release.mjs +1 -1
  67. package/package.json +1 -1
@@ -1327,6 +1327,7 @@ interface PlayAuthoringRuntimeContext {
1327
1327
  */
1328
1328
  log(message: string, options?: {
1329
1329
  level?: 'debug' | 'info' | 'warn' | 'error';
1330
+ context?: Readonly<Record<string, string | number | boolean>>;
1330
1331
  }): void;
1331
1332
  sleep(ms: number): Promise<void>;
1332
1333
  }
@@ -1327,6 +1327,7 @@ interface PlayAuthoringRuntimeContext {
1327
1327
  */
1328
1328
  log(message: string, options?: {
1329
1329
  level?: 'debug' | 'info' | 'warn' | 'error';
1330
+ context?: Readonly<Record<string, string | number | boolean>>;
1330
1331
  }): void;
1331
1332
  sleep(ms: number): Promise<void>;
1332
1333
  }
package/dist/index.d.mts CHANGED
@@ -1,7 +1,7 @@
1
1
  /// <reference path="./text-imports.d.ts" />
2
2
  import { z } from 'zod';
3
- import { c as PlayCompilerManifest, T as ToolResultBilling, 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, r as ToolExecuteResult, s as PlayAuthoringReferenceLike, t as PlayReturnObject$1, u as PlayAuthoringDefineConfig, v as PlayAuthoringDefinedPlay, w as PlayAuthoringFetchOptions, x as PlayAuthoringFileInput, y as PlayAuthoringAsyncCallOptions, z as PlayAuthoringBindings, B as PlayAuthoringCallExecution, C as PlayAuthoringCallOptions, D as PlayAuthoringFetchResponse, E as PlayAuthoringInputContract, F as PlayRunId$1, G as PlayAuthoringStepProgramStep, H as PlayAuthoringRuntimeStepOptions, I as PlaySqlListenerDeclaration, J as PlaySqlListenerEvent, K as PlaySqlListenerOperation, L as PlaySqlQuery, M as PlayAuthoringStepOptions, N as PlayAuthoringStepProgram, O as PlayAuthoringStepProgramResolver, Q as PlayAuthoringStepResolver, R as PlayToolExecutionRequest, S as PlayAuthoringStepProgramOptions, U as DeeplineError, V as ToolExecutionError, W as ToolExecutionErrorOptions } from './compiler-manifest-n8ZtPv2h.mjs';
4
- export { X as CtxFetchHttpError, Y as DEEPLINE_EXTRACTOR_TARGETS, Z as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, _ as DeeplineEmailStatusGetterValue, $ as DeeplineExtractorTarget, a0 as DeeplineGetterValue, a1 as DeeplineGetterValueMap, a2 as JOB_CHANGE_STATUS_VALUES, a3 as JobChangeStatus, a4 as PHONE_STATUS_VALUES, a5 as PhoneStatus, a6 as PlayDataset, a7 as PlayDatasetInput, a8 as PreviousCell, a9 as ProviderTransientError, aa as ProviderTransientErrorCategory, ab as ProviderUnavailableError, ac as ProviderUnavailableReason, ad as ToolExecutionErrorCategory, ae as ToolExecutionErrorOrigin, af as ToolExecutionFailureV1, ag as ToolExecutionNetworkKind, ah as ToolExecutionNetworkScope, ai as ToolExecutionPublicDetails, aj as getProviderUnavailableReason, ak as isDeeplineExtractorTarget, al as isProviderUnavailable, am as isProviderWaterfallUnavailableError } from './compiler-manifest-n8ZtPv2h.mjs';
3
+ import { c as PlayCompilerManifest, T as ToolResultBilling, 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, r as ToolExecuteResult, s as PlayAuthoringReferenceLike, t as PlayReturnObject$1, u as PlayAuthoringDefineConfig, v as PlayAuthoringDefinedPlay, w as PlayAuthoringFetchOptions, x as PlayAuthoringFileInput, y as PlayAuthoringAsyncCallOptions, z as PlayAuthoringBindings, B as PlayAuthoringCallExecution, C as PlayAuthoringCallOptions, D as PlayAuthoringFetchResponse, E as PlayAuthoringInputContract, F as PlayRunId$1, G as PlayAuthoringStepProgramStep, H as PlayAuthoringRuntimeStepOptions, I as PlaySqlListenerDeclaration, J as PlaySqlListenerEvent, K as PlaySqlListenerOperation, L as PlaySqlQuery, M as PlayAuthoringStepOptions, N as PlayAuthoringStepProgram, O as PlayAuthoringStepProgramResolver, Q as PlayAuthoringStepResolver, R as PlayToolExecutionRequest, S as PlayAuthoringStepProgramOptions, U as DeeplineError, V as ToolExecutionError, W as ToolExecutionErrorOptions } from './compiler-manifest-DavmLa8y.mjs';
4
+ export { X as CtxFetchHttpError, Y as DEEPLINE_EXTRACTOR_TARGETS, Z as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, _ as DeeplineEmailStatusGetterValue, $ as DeeplineExtractorTarget, a0 as DeeplineGetterValue, a1 as DeeplineGetterValueMap, a2 as JOB_CHANGE_STATUS_VALUES, a3 as JobChangeStatus, a4 as PHONE_STATUS_VALUES, a5 as PhoneStatus, a6 as PlayDataset, a7 as PlayDatasetInput, a8 as PreviousCell, a9 as ProviderTransientError, aa as ProviderTransientErrorCategory, ab as ProviderUnavailableError, ac as ProviderUnavailableReason, ad as ToolExecutionErrorCategory, ae as ToolExecutionErrorOrigin, af as ToolExecutionFailureV1, ag as ToolExecutionNetworkKind, ah as ToolExecutionNetworkScope, ai as ToolExecutionPublicDetails, aj as getProviderUnavailableReason, ak as isDeeplineExtractorTarget, al as isProviderUnavailable, am as isProviderWaterfallUnavailableError } from './compiler-manifest-DavmLa8y.mjs';
5
5
  import { MonitorFleetDefinition } from './monitor-fleet-contract.mjs';
6
6
  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';
7
7
  export { BatchMonitorInput, MonitorInputIssue, MonitorSpec as MonitorInputSpec, lintMonitorBatchInput, lintMonitorSpecTemplate, renderMonitorSpecTemplate } from './monitor-input-contract.mjs';
@@ -91,6 +91,32 @@ type PlaySettingsPathsPage = {
91
91
  hasMore: boolean;
92
92
  };
93
93
 
94
+ /** A retained result, not a new tool execution or a billing receipt. */
95
+ type RunToolReceiptResult = {
96
+ receiptKey: string;
97
+ status?: string;
98
+ } & ({
99
+ result: {
100
+ status: string;
101
+ job_id?: string;
102
+ toolResponse: Record<string, unknown>;
103
+ targetValues?: Record<string, unknown>;
104
+ listDatasets?: Record<string, unknown>;
105
+ listRows?: Record<string, unknown>;
106
+ };
107
+ error?: never;
108
+ } | {
109
+ result?: never;
110
+ error: {
111
+ code: string;
112
+ message: string;
113
+ };
114
+ });
115
+ type RunToolReceiptsResponse = {
116
+ runId: string;
117
+ receipts: RunToolReceiptResult[];
118
+ };
119
+
94
120
  declare const FIXTURE_BEHAVIOR_VERSION: 1;
95
121
  declare const FIXTURE_BEHAVIOR_RESPONSE_VERSION: 2;
96
122
  declare const FIXTURE_BEHAVIOR_REPLAY_VERSION: 3;
@@ -1777,6 +1803,10 @@ interface PlayRunPackage {
1777
1803
  schemaVersion: 1;
1778
1804
  /** Package discriminator. */
1779
1805
  kind: 'play_run';
1806
+ /** Retained return structure with dataset references, not flattened output previews. */
1807
+ result?: unknown;
1808
+ /** Full-only values are omitted as a whole, never replaced with partial authored data. */
1809
+ resultState?: 'available' | 'available_in_full' | 'not_returned' | 'unavailable';
1780
1810
  /** Ledger position of the detailed snapshot, when provided by this server. */
1781
1811
  source?: {
1782
1812
  ledgerNextSeq: number | null;
@@ -1788,6 +1818,8 @@ interface PlayRunPackage {
1788
1818
  /** Run identity, status, timing, and dashboard metadata. */
1789
1819
  run: {
1790
1820
  id: string;
1821
+ /** Revision pinned at admission, never the play's current revision. */
1822
+ revisionId?: string;
1791
1823
  playName: string;
1792
1824
  status: string;
1793
1825
  dashboardUrl?: string;
@@ -1817,6 +1849,8 @@ interface PlayRunPackage {
1817
1849
  kind: 'dataset';
1818
1850
  datasetId?: string;
1819
1851
  path: string;
1852
+ /** Other proven catalog/return paths for this same identity. */
1853
+ aliases?: string[];
1820
1854
  tableNamespace?: string;
1821
1855
  rowCount?: number;
1822
1856
  /** The materialized dataset count is exact only after this lifecycle completes. */
@@ -1831,7 +1865,7 @@ interface PlayRunPackage {
1831
1865
  sqlQualifiedTableName?: string;
1832
1866
  recovered?: true;
1833
1867
  exportUnavailable?: {
1834
- reason: 'empty_dataset' | 'shared_table_namespace' | 'returned_dataset_not_persisted';
1868
+ reason: 'empty_dataset' | 'shared_table_namespace' | 'ambiguous_selector' | 'returned_dataset_not_persisted';
1835
1869
  message: string;
1836
1870
  };
1837
1871
  preview?: Record<string, unknown>;
@@ -2817,7 +2851,9 @@ interface PlayCheckRecognizedSummary {
2817
2851
  triggers?: PlayCheckTriggersSummary;
2818
2852
  tools?: string[];
2819
2853
  /**
2820
- * Durable datasets the play produces. `undrawnColumns` echoes the columns the
2854
+ * Durable datasets the play produces. `columns` contains statically known
2855
+ * physical SQL column names, not logical step ids or a complete CSV schema.
2856
+ * `undrawnColumns` echoes the authored field identifiers the
2821
2857
  * author declared out of an authored `@mermaid` diagram with
2822
2858
  * `.run({ undrawnColumns: [...] })`, so an opt-out is visible in check output.
2823
2859
  */
@@ -3521,6 +3557,50 @@ type RunsLogsResult = {
3521
3557
  */
3522
3558
  logsTruncated?: boolean;
3523
3559
  };
3560
+ /** Bounded org-scoped search over durable Play runtime observations. */
3561
+ type RunsEventSearchOptions = {
3562
+ /** Inclusive UTC timestamp; defaults to one hour before the request. */
3563
+ since?: string;
3564
+ /** Exclusive UTC timestamp; defaults to the request time. */
3565
+ until?: string;
3566
+ /** Optional run filter. Omit to search across the active organization. */
3567
+ runId?: string;
3568
+ playName?: string;
3569
+ kind?: string;
3570
+ /** Flat equality predicate in the supported PostgreSQL JSONPath subset. */
3571
+ jsonpath?: string;
3572
+ /** Include receipt-backed outputs, capped to ten events and 16 MiB total. */
3573
+ includePayloads?: boolean;
3574
+ limit?: number;
3575
+ cursor?: string;
3576
+ /** Explicit Preview selection requires the existing runtime credential. */
3577
+ runtime?: PlayRuntimeSelection;
3578
+ };
3579
+ type RunsEventSearchEntry = {
3580
+ eventId: string;
3581
+ occurredAt: string;
3582
+ ingestedAt: string;
3583
+ runId: string;
3584
+ playName: string;
3585
+ kind: string;
3586
+ level: string | null;
3587
+ message: string | null;
3588
+ searchDoc: Record<string, unknown>;
3589
+ /** Optional full result, included only when explicitly requested. */
3590
+ payload?: RunsEventPayload | null;
3591
+ };
3592
+ type RunsEventSearchResult = {
3593
+ events: RunsEventSearchEntry[];
3594
+ nextCursor: string | null;
3595
+ since: string;
3596
+ until: string;
3597
+ };
3598
+ type RunsEventPayload = {
3599
+ status: 'completed' | 'failed' | 'skipped';
3600
+ output: unknown | null;
3601
+ error: string | null;
3602
+ errorPayload: unknown | null;
3603
+ };
3524
3604
  /** One persisted runtime-sheet row returned by `client.runs.exportDatasetRows(...)`. */
3525
3605
  type PlaySheetRow = {
3526
3606
  key?: string;
@@ -3578,6 +3658,10 @@ type PlaySecretCheck = {
3578
3658
  * @sdkReference client 020 client.runs
3579
3659
  */
3580
3660
  type RunsNamespace = {
3661
+ /** Read retained tool results associated with a run, in supplied key order. Never executes tools. */
3662
+ getReceipts: (runId: string, options: {
3663
+ keys: string[];
3664
+ }) => Promise<RunToolReceiptsResponse>;
3581
3665
  /** Get current run status by public run id. */
3582
3666
  get: (runId: string, options?: RunsGetOptions) => Promise<PlayStatus>;
3583
3667
  /**
@@ -3605,6 +3689,8 @@ type RunsNamespace = {
3605
3689
  tail: (runId: string, options?: RunsTailOptions) => Promise<PlayStatus>;
3606
3690
  /** Fetch persisted log lines for a run. */
3607
3691
  logs: (runId: string, options?: RunsLogsOptions) => Promise<RunsLogsResult>;
3692
+ /** Search recent durable runtime events across runs in the active organization. */
3693
+ searchEvents: (options?: RunsEventSearchOptions) => Promise<RunsEventSearchResult>;
3608
3694
  /** Export persisted rows for a runtime-sheet dataset/table namespace. */
3609
3695
  exportDatasetRows: (input: {
3610
3696
  playName: string;
@@ -5551,6 +5637,10 @@ declare class DeeplineClient {
5551
5637
  listRuns(options: RunsListOptions): Promise<PlayRunListItem[]>;
5552
5638
  /** Read one run page without discarding server pagination metadata. */
5553
5639
  listRunsPage(options: RunsListOptions): Promise<RunsListPage>;
5640
+ /** Read batches rather than silently truncating a long key list. */
5641
+ getRunReceipts(runId: string, options: {
5642
+ keys: string[];
5643
+ }): Promise<RunToolReceiptsResponse>;
5554
5644
  /** Get the exact original input retained for a run. This is intentionally separate from status. */
5555
5645
  getRunInput(runId: string): Promise<{
5556
5646
  runId: string;
@@ -5579,6 +5669,8 @@ declare class DeeplineClient {
5579
5669
  * ```
5580
5670
  */
5581
5671
  getRunLogs(runId: string, options?: RunsLogsOptions): Promise<RunsLogsResult>;
5672
+ /** Search bounded, structured runtime history without requiring a run id. */
5673
+ searchRunEvents(options?: RunsEventSearchOptions): Promise<RunsEventSearchResult>;
5582
5674
  /**
5583
5675
  * Export persisted runtime-sheet rows for a play dataset/table namespace.
5584
5676
  *
@@ -7198,4 +7290,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
7198
7290
  */
7199
7291
  declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
7200
7292
 
7201
- export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpReceipt, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, 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 DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, 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 PlayPath, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySettings, type PlaySettingsPatch, type PlaySettingsPathsPage, type PlaySettingsResult, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysActivityResponse, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, type RunLifecycleStatus, RunObserveTransportUnavailableError, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RunsWatchOptions, 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 StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, 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, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
7293
+ export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpReceipt, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, 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 DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, 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 PlayPath, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySettings, type PlaySettingsPatch, type PlaySettingsPathsPage, type PlaySettingsResult, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysActivityResponse, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, type RunLifecycleStatus, RunObserveTransportUnavailableError, type RunToolReceiptResult, type RunToolReceiptsResponse, type RunsEventPayload, type RunsEventSearchEntry, type RunsEventSearchOptions, type RunsEventSearchResult, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RunsWatchOptions, 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 StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, 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, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
package/dist/index.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  /// <reference path="./text-imports.d.ts" />
2
2
  import { z } from 'zod';
3
- import { c as PlayCompilerManifest, T as ToolResultBilling, 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, r as ToolExecuteResult, s as PlayAuthoringReferenceLike, t as PlayReturnObject$1, u as PlayAuthoringDefineConfig, v as PlayAuthoringDefinedPlay, w as PlayAuthoringFetchOptions, x as PlayAuthoringFileInput, y as PlayAuthoringAsyncCallOptions, z as PlayAuthoringBindings, B as PlayAuthoringCallExecution, C as PlayAuthoringCallOptions, D as PlayAuthoringFetchResponse, E as PlayAuthoringInputContract, F as PlayRunId$1, G as PlayAuthoringStepProgramStep, H as PlayAuthoringRuntimeStepOptions, I as PlaySqlListenerDeclaration, J as PlaySqlListenerEvent, K as PlaySqlListenerOperation, L as PlaySqlQuery, M as PlayAuthoringStepOptions, N as PlayAuthoringStepProgram, O as PlayAuthoringStepProgramResolver, Q as PlayAuthoringStepResolver, R as PlayToolExecutionRequest, S as PlayAuthoringStepProgramOptions, U as DeeplineError, V as ToolExecutionError, W as ToolExecutionErrorOptions } from './compiler-manifest-n8ZtPv2h.js';
4
- export { X as CtxFetchHttpError, Y as DEEPLINE_EXTRACTOR_TARGETS, Z as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, _ as DeeplineEmailStatusGetterValue, $ as DeeplineExtractorTarget, a0 as DeeplineGetterValue, a1 as DeeplineGetterValueMap, a2 as JOB_CHANGE_STATUS_VALUES, a3 as JobChangeStatus, a4 as PHONE_STATUS_VALUES, a5 as PhoneStatus, a6 as PlayDataset, a7 as PlayDatasetInput, a8 as PreviousCell, a9 as ProviderTransientError, aa as ProviderTransientErrorCategory, ab as ProviderUnavailableError, ac as ProviderUnavailableReason, ad as ToolExecutionErrorCategory, ae as ToolExecutionErrorOrigin, af as ToolExecutionFailureV1, ag as ToolExecutionNetworkKind, ah as ToolExecutionNetworkScope, ai as ToolExecutionPublicDetails, aj as getProviderUnavailableReason, ak as isDeeplineExtractorTarget, al as isProviderUnavailable, am as isProviderWaterfallUnavailableError } from './compiler-manifest-n8ZtPv2h.js';
3
+ import { c as PlayCompilerManifest, T as ToolResultBilling, 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, r as ToolExecuteResult, s as PlayAuthoringReferenceLike, t as PlayReturnObject$1, u as PlayAuthoringDefineConfig, v as PlayAuthoringDefinedPlay, w as PlayAuthoringFetchOptions, x as PlayAuthoringFileInput, y as PlayAuthoringAsyncCallOptions, z as PlayAuthoringBindings, B as PlayAuthoringCallExecution, C as PlayAuthoringCallOptions, D as PlayAuthoringFetchResponse, E as PlayAuthoringInputContract, F as PlayRunId$1, G as PlayAuthoringStepProgramStep, H as PlayAuthoringRuntimeStepOptions, I as PlaySqlListenerDeclaration, J as PlaySqlListenerEvent, K as PlaySqlListenerOperation, L as PlaySqlQuery, M as PlayAuthoringStepOptions, N as PlayAuthoringStepProgram, O as PlayAuthoringStepProgramResolver, Q as PlayAuthoringStepResolver, R as PlayToolExecutionRequest, S as PlayAuthoringStepProgramOptions, U as DeeplineError, V as ToolExecutionError, W as ToolExecutionErrorOptions } from './compiler-manifest-DavmLa8y.js';
4
+ export { X as CtxFetchHttpError, Y as DEEPLINE_EXTRACTOR_TARGETS, Z as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, _ as DeeplineEmailStatusGetterValue, $ as DeeplineExtractorTarget, a0 as DeeplineGetterValue, a1 as DeeplineGetterValueMap, a2 as JOB_CHANGE_STATUS_VALUES, a3 as JobChangeStatus, a4 as PHONE_STATUS_VALUES, a5 as PhoneStatus, a6 as PlayDataset, a7 as PlayDatasetInput, a8 as PreviousCell, a9 as ProviderTransientError, aa as ProviderTransientErrorCategory, ab as ProviderUnavailableError, ac as ProviderUnavailableReason, ad as ToolExecutionErrorCategory, ae as ToolExecutionErrorOrigin, af as ToolExecutionFailureV1, ag as ToolExecutionNetworkKind, ah as ToolExecutionNetworkScope, ai as ToolExecutionPublicDetails, aj as getProviderUnavailableReason, ak as isDeeplineExtractorTarget, al as isProviderUnavailable, am as isProviderWaterfallUnavailableError } from './compiler-manifest-DavmLa8y.js';
5
5
  import { MonitorFleetDefinition } from './monitor-fleet-contract.js';
6
6
  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';
7
7
  export { BatchMonitorInput, MonitorInputIssue, MonitorSpec as MonitorInputSpec, lintMonitorBatchInput, lintMonitorSpecTemplate, renderMonitorSpecTemplate } from './monitor-input-contract.js';
@@ -91,6 +91,32 @@ type PlaySettingsPathsPage = {
91
91
  hasMore: boolean;
92
92
  };
93
93
 
94
+ /** A retained result, not a new tool execution or a billing receipt. */
95
+ type RunToolReceiptResult = {
96
+ receiptKey: string;
97
+ status?: string;
98
+ } & ({
99
+ result: {
100
+ status: string;
101
+ job_id?: string;
102
+ toolResponse: Record<string, unknown>;
103
+ targetValues?: Record<string, unknown>;
104
+ listDatasets?: Record<string, unknown>;
105
+ listRows?: Record<string, unknown>;
106
+ };
107
+ error?: never;
108
+ } | {
109
+ result?: never;
110
+ error: {
111
+ code: string;
112
+ message: string;
113
+ };
114
+ });
115
+ type RunToolReceiptsResponse = {
116
+ runId: string;
117
+ receipts: RunToolReceiptResult[];
118
+ };
119
+
94
120
  declare const FIXTURE_BEHAVIOR_VERSION: 1;
95
121
  declare const FIXTURE_BEHAVIOR_RESPONSE_VERSION: 2;
96
122
  declare const FIXTURE_BEHAVIOR_REPLAY_VERSION: 3;
@@ -1777,6 +1803,10 @@ interface PlayRunPackage {
1777
1803
  schemaVersion: 1;
1778
1804
  /** Package discriminator. */
1779
1805
  kind: 'play_run';
1806
+ /** Retained return structure with dataset references, not flattened output previews. */
1807
+ result?: unknown;
1808
+ /** Full-only values are omitted as a whole, never replaced with partial authored data. */
1809
+ resultState?: 'available' | 'available_in_full' | 'not_returned' | 'unavailable';
1780
1810
  /** Ledger position of the detailed snapshot, when provided by this server. */
1781
1811
  source?: {
1782
1812
  ledgerNextSeq: number | null;
@@ -1788,6 +1818,8 @@ interface PlayRunPackage {
1788
1818
  /** Run identity, status, timing, and dashboard metadata. */
1789
1819
  run: {
1790
1820
  id: string;
1821
+ /** Revision pinned at admission, never the play's current revision. */
1822
+ revisionId?: string;
1791
1823
  playName: string;
1792
1824
  status: string;
1793
1825
  dashboardUrl?: string;
@@ -1817,6 +1849,8 @@ interface PlayRunPackage {
1817
1849
  kind: 'dataset';
1818
1850
  datasetId?: string;
1819
1851
  path: string;
1852
+ /** Other proven catalog/return paths for this same identity. */
1853
+ aliases?: string[];
1820
1854
  tableNamespace?: string;
1821
1855
  rowCount?: number;
1822
1856
  /** The materialized dataset count is exact only after this lifecycle completes. */
@@ -1831,7 +1865,7 @@ interface PlayRunPackage {
1831
1865
  sqlQualifiedTableName?: string;
1832
1866
  recovered?: true;
1833
1867
  exportUnavailable?: {
1834
- reason: 'empty_dataset' | 'shared_table_namespace' | 'returned_dataset_not_persisted';
1868
+ reason: 'empty_dataset' | 'shared_table_namespace' | 'ambiguous_selector' | 'returned_dataset_not_persisted';
1835
1869
  message: string;
1836
1870
  };
1837
1871
  preview?: Record<string, unknown>;
@@ -2817,7 +2851,9 @@ interface PlayCheckRecognizedSummary {
2817
2851
  triggers?: PlayCheckTriggersSummary;
2818
2852
  tools?: string[];
2819
2853
  /**
2820
- * Durable datasets the play produces. `undrawnColumns` echoes the columns the
2854
+ * Durable datasets the play produces. `columns` contains statically known
2855
+ * physical SQL column names, not logical step ids or a complete CSV schema.
2856
+ * `undrawnColumns` echoes the authored field identifiers the
2821
2857
  * author declared out of an authored `@mermaid` diagram with
2822
2858
  * `.run({ undrawnColumns: [...] })`, so an opt-out is visible in check output.
2823
2859
  */
@@ -3521,6 +3557,50 @@ type RunsLogsResult = {
3521
3557
  */
3522
3558
  logsTruncated?: boolean;
3523
3559
  };
3560
+ /** Bounded org-scoped search over durable Play runtime observations. */
3561
+ type RunsEventSearchOptions = {
3562
+ /** Inclusive UTC timestamp; defaults to one hour before the request. */
3563
+ since?: string;
3564
+ /** Exclusive UTC timestamp; defaults to the request time. */
3565
+ until?: string;
3566
+ /** Optional run filter. Omit to search across the active organization. */
3567
+ runId?: string;
3568
+ playName?: string;
3569
+ kind?: string;
3570
+ /** Flat equality predicate in the supported PostgreSQL JSONPath subset. */
3571
+ jsonpath?: string;
3572
+ /** Include receipt-backed outputs, capped to ten events and 16 MiB total. */
3573
+ includePayloads?: boolean;
3574
+ limit?: number;
3575
+ cursor?: string;
3576
+ /** Explicit Preview selection requires the existing runtime credential. */
3577
+ runtime?: PlayRuntimeSelection;
3578
+ };
3579
+ type RunsEventSearchEntry = {
3580
+ eventId: string;
3581
+ occurredAt: string;
3582
+ ingestedAt: string;
3583
+ runId: string;
3584
+ playName: string;
3585
+ kind: string;
3586
+ level: string | null;
3587
+ message: string | null;
3588
+ searchDoc: Record<string, unknown>;
3589
+ /** Optional full result, included only when explicitly requested. */
3590
+ payload?: RunsEventPayload | null;
3591
+ };
3592
+ type RunsEventSearchResult = {
3593
+ events: RunsEventSearchEntry[];
3594
+ nextCursor: string | null;
3595
+ since: string;
3596
+ until: string;
3597
+ };
3598
+ type RunsEventPayload = {
3599
+ status: 'completed' | 'failed' | 'skipped';
3600
+ output: unknown | null;
3601
+ error: string | null;
3602
+ errorPayload: unknown | null;
3603
+ };
3524
3604
  /** One persisted runtime-sheet row returned by `client.runs.exportDatasetRows(...)`. */
3525
3605
  type PlaySheetRow = {
3526
3606
  key?: string;
@@ -3578,6 +3658,10 @@ type PlaySecretCheck = {
3578
3658
  * @sdkReference client 020 client.runs
3579
3659
  */
3580
3660
  type RunsNamespace = {
3661
+ /** Read retained tool results associated with a run, in supplied key order. Never executes tools. */
3662
+ getReceipts: (runId: string, options: {
3663
+ keys: string[];
3664
+ }) => Promise<RunToolReceiptsResponse>;
3581
3665
  /** Get current run status by public run id. */
3582
3666
  get: (runId: string, options?: RunsGetOptions) => Promise<PlayStatus>;
3583
3667
  /**
@@ -3605,6 +3689,8 @@ type RunsNamespace = {
3605
3689
  tail: (runId: string, options?: RunsTailOptions) => Promise<PlayStatus>;
3606
3690
  /** Fetch persisted log lines for a run. */
3607
3691
  logs: (runId: string, options?: RunsLogsOptions) => Promise<RunsLogsResult>;
3692
+ /** Search recent durable runtime events across runs in the active organization. */
3693
+ searchEvents: (options?: RunsEventSearchOptions) => Promise<RunsEventSearchResult>;
3608
3694
  /** Export persisted rows for a runtime-sheet dataset/table namespace. */
3609
3695
  exportDatasetRows: (input: {
3610
3696
  playName: string;
@@ -5551,6 +5637,10 @@ declare class DeeplineClient {
5551
5637
  listRuns(options: RunsListOptions): Promise<PlayRunListItem[]>;
5552
5638
  /** Read one run page without discarding server pagination metadata. */
5553
5639
  listRunsPage(options: RunsListOptions): Promise<RunsListPage>;
5640
+ /** Read batches rather than silently truncating a long key list. */
5641
+ getRunReceipts(runId: string, options: {
5642
+ keys: string[];
5643
+ }): Promise<RunToolReceiptsResponse>;
5554
5644
  /** Get the exact original input retained for a run. This is intentionally separate from status. */
5555
5645
  getRunInput(runId: string): Promise<{
5556
5646
  runId: string;
@@ -5579,6 +5669,8 @@ declare class DeeplineClient {
5579
5669
  * ```
5580
5670
  */
5581
5671
  getRunLogs(runId: string, options?: RunsLogsOptions): Promise<RunsLogsResult>;
5672
+ /** Search bounded, structured runtime history without requiring a run id. */
5673
+ searchRunEvents(options?: RunsEventSearchOptions): Promise<RunsEventSearchResult>;
5582
5674
  /**
5583
5675
  * Export persisted runtime-sheet rows for a play dataset/table namespace.
5584
5676
  *
@@ -7198,4 +7290,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
7198
7290
  */
7199
7291
  declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
7200
7292
 
7201
- export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpReceipt, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, 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 DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, 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 PlayPath, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySettings, type PlaySettingsPatch, type PlaySettingsPathsPage, type PlaySettingsResult, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysActivityResponse, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, type RunLifecycleStatus, RunObserveTransportUnavailableError, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RunsWatchOptions, 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 StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, 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, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
7293
+ export { type AsyncPlayRunRef, AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingRecentUsageEntry, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpReceipt, type BillingTopUpResult, type BillingUsageEvent, type BillingUsageOptions, type BillingUsageResult, 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 DeeplineExecutionsNamespace, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolExecuteResult, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type ExecutionByKeyResult, type ExecutionRecovery, 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 PlayPath, type PlayReferenceLike, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunId, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySettings, type PlaySettingsPatch, type PlaySettingsPathsPage, type PlaySettingsResult, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PlaysActivityResponse, type PlaysListOptions, type PlaysListPage, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type RerunOptions, type RerunPlayRunResult, type ResolvedConfig, type RunLifecycleStatus, RunObserveTransportUnavailableError, type RunToolReceiptResult, type RunToolReceiptsResponse, type RunsEventPayload, type RunsEventSearchEntry, type RunsEventSearchOptions, type RunsEventSearchResult, type RunsListOptions, type RunsListPage, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RunsWatchOptions, 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 StopAllCandidate, type StopAllPlayRunsDryRunResult, type StopAllPlayRunsResult, type StopAllPlayRunsStopResult, type StopAllRunsOptions, 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, isStopAllPlayRunsDryRunResult, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };