deepline 0.3.4 → 0.3.6

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.
@@ -775,7 +775,22 @@ export type MonitorsListOptions = {
775
775
  */
776
776
  export type MonitorCheckResult = Record<string, unknown>;
777
777
  export type MonitorDeployResult = Record<string, unknown>;
778
- export type MonitorDetail = Record<string, unknown>;
778
+ /** Field-level monitor capability spec returned by `client.monitors.get(...)`. */
779
+ export type MonitorSpec = {
780
+ /** Whether Deepline has a current capability spec for this deployed monitor. */
781
+ available?: boolean;
782
+ tool?: string;
783
+ description?: string;
784
+ fields?: Array<Record<string, unknown>>;
785
+ conditional_requirements?: Array<Record<string, unknown>>;
786
+ /** Present when a legacy monitor has no current capability spec. */
787
+ message?: string;
788
+ };
789
+
790
+ /** One deployed-monitor read. The server may add monitor-specific fields. */
791
+ export type MonitorDetail = Record<string, unknown> & {
792
+ monitor_spec?: MonitorSpec;
793
+ };
779
794
  export type MonitorDependents = Record<string, unknown>;
780
795
  export type MonitorUpdateChangeSummary = {
781
796
  definition: {
@@ -77,6 +77,7 @@ export type {
77
77
  MonitorCheckResult,
78
78
  MonitorDeployResult,
79
79
  MonitorDetail,
80
+ MonitorSpec,
80
81
  MonitorDependents,
81
82
  MonitorUpdateChangeSummary,
82
83
  MonitorUpdateResult,
@@ -62,6 +62,13 @@ export type MonitorPayload = Record<string, unknown>;
62
62
  * bump; known controls are typed for discoverability.
63
63
  */
64
64
  export type MonitorControls = {
65
+ /**
66
+ * Request Deepline Native priority execution for a bounded urgent preview or
67
+ * calibration radar. Deepline sends the upstream custom-field marker and
68
+ * enforces a maximum of ten active or in-flight priority radars per org.
69
+ * Omit this for regular and bulk-scale monitoring.
70
+ */
71
+ execution_type?: 'priority';
65
72
  [key: string]: unknown;
66
73
  };
67
74
 
@@ -115,10 +122,7 @@ export function defineMonitor<TPayload extends MonitorPayload = MonitorPayload>(
115
122
  'defineMonitor(definition) requires "payload" to be a JSON object.',
116
123
  );
117
124
  }
118
- if (
119
- definition.name !== undefined &&
120
- typeof definition.name !== 'string'
121
- ) {
125
+ if (definition.name !== undefined && typeof definition.name !== 'string') {
122
126
  throw new Error('defineMonitor(definition) "name" must be a string.');
123
127
  }
124
128
  if (
@@ -174,7 +174,7 @@ export type FetchOptions = PlayAuthoringFetchOptions;
174
174
  export type PlayFetchResponse = PlayAuthoringFetchResponse;
175
175
 
176
176
  /**
177
- * Optional trigger bindings for a play.
177
+ * Optional Play configuration, including triggers and runtime limits.
178
178
  *
179
179
  * A play can be triggered three ways, declared as the third argument to
180
180
  * {@link definePlay}:
@@ -188,6 +188,10 @@ export type PlayFetchResponse = PlayAuthoringFetchResponse;
188
188
  * `deepline monitors available <id>` for a tool's streams and row columns).
189
189
  * The changed row is delivered to the handler as the listener event's `after`.
190
190
  *
191
+ * The default Play runtime is 30 minutes. For bounded long-running batches, add
192
+ * `runtime: { timeout: '90m', size: 'standard' }`; duration values are whole minutes or hours, up to `4h`.
193
+ * It differs from `ctx.tools.execute({ timeoutMs })`, which limits one provider call.
194
+ *
191
195
  * @example Webhook with HMAC verification
192
196
  * ```typescript
193
197
  * definePlay('webhook-handler', handler, {
@@ -1538,7 +1542,7 @@ export function defineInput<TInput>(
1538
1542
  * @param config - Object-form play config.
1539
1543
  * @param name - Play name.
1540
1544
  * @param fn - Play function.
1541
- * @param bindings - Trigger bindings.
1545
+ * @param bindings - Play configuration, including runtime limits and triggers.
1542
1546
  * @returns A {@link DefinedPlay} that is both callable and has lifecycle methods
1543
1547
  *
1544
1548
  * @example Basic play
@@ -1613,7 +1617,7 @@ export function definePlay<TInput, TOutput extends PlayReturnObject>(
1613
1617
  *
1614
1618
  * @param name - Play name.
1615
1619
  * @param fn - Play function.
1616
- * @param bindings - Trigger bindings.
1620
+ * @param bindings - Play configuration, including runtime limits and triggers.
1617
1621
  * @returns Play handle.
1618
1622
  */
1619
1623
  export function definePlay<TInput, TOutput extends PlayReturnObject>(
@@ -192,7 +192,7 @@ export const SDK_RELEASE = {
192
192
  // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
193
193
  // available at toolResponse.rawV2 while toolResponse.raw and all declared
194
194
  // getters keep their established compatibility behavior.
195
- version: '0.3.4',
195
+ version: '0.3.6',
196
196
  updateSummary:
197
197
  'New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.',
198
198
  contracts: {
@@ -9,6 +9,7 @@ const CLOUDFLARE_WORKFLOW_ENDPOINT_UNAVAILABLE_RE =
9
9
  const VERCEL_RUNTIME_API_DEPLOYMENT_MISSING_RE =
10
10
  /runtime API 404:[\s\S]*(?:DeploymentNotFound|DEPLOYMENT_NOT_FOUND|requested deployment .*exist|deployment could not be found on Vercel)/i;
11
11
  const RUNTIME_LIMIT_EXCEEDED_RE = /\bRUNTIME_LIMIT_EXCEEDED\b/i;
12
+ const SANDBOX_CAPACITY_EXCEEDED_RE = /\bSANDBOX_CAPACITY_EXCEEDED\b/i;
12
13
  const RUNTIME_RUNNER_LOST_RE = /\bRUNTIME_RUNNER_LOST\b/i;
13
14
  const RUNTIME_SANDBOX_INSPECTION_UNAVAILABLE_RE =
14
15
  /\bRUNTIME_SANDBOX_INSPECTION_UNAVAILABLE\b/i;
@@ -36,6 +37,8 @@ export const RUNTIME_SANDBOX_KILLED_MESSAGE =
36
37
  'The execution sandbox was killed before it could return a result, and the kill reason is unavailable. Completed work is durably recorded. Retry the same command safely; Deepline reuses completed steps and does not repeat their provider calls.';
37
38
  export const RUNTIME_LIMIT_EXCEEDED_MESSAGE =
38
39
  'The play reached its 30 minute runtime limit and was stopped. Completed row state was preserved; run a smaller batch or continue from the persisted rows.';
40
+ export const SANDBOX_CAPACITY_EXCEEDED_MESSAGE =
41
+ 'Your organization has reached its concurrency limit, so this play did not start. Try again after another play finishes, or contact Deepline to request a higher limit.';
39
42
  export const RUNTIME_RUNNER_LOST_MESSAGE =
40
43
  'The execution runner stopped reporting liveness before returning a terminal result. Completed work is preserved, but Deepline did not automatically replay the run because provider side effects may already exist. Re-run only when it is safe to do so.';
41
44
  export const RUNTIME_SANDBOX_INSPECTION_UNAVAILABLE_MESSAGE =
@@ -324,6 +327,15 @@ export function normalizePlayRunFailure(error: unknown): PlayRunFailureDetails {
324
327
  ? runtimeLimitExceededFailure(configuredSeconds, cause)
325
328
  : runtimeLimitExceededFailure(30 * 60, cause);
326
329
  }
330
+ if (SANDBOX_CAPACITY_EXCEEDED_RE.test(rawCause)) {
331
+ return {
332
+ code: 'SANDBOX_CAPACITY_EXCEEDED',
333
+ phase: 'admission',
334
+ message: SANDBOX_CAPACITY_EXCEEDED_MESSAGE,
335
+ retryable: true,
336
+ cause,
337
+ };
338
+ }
327
339
  if (RUNTIME_RUNNER_LOST_RE.test(rawCause)) {
328
340
  const stack = error instanceof Error ? boundedFailureStack(error) : null;
329
341
  const causes = error instanceof Error ? failureCauseTexts(error) : [];
@@ -120,6 +120,11 @@ export type PlaySchedulerSubmitInput = {
120
120
  triggerSource?: 'api' | 'webhook' | 'cron' | 'sql_listener';
121
121
  /** Null lets a durable trigger wait for capacity; a number bounds queue delay. */
122
122
  queueMaxDelaySeconds?: number | null;
123
+ /**
124
+ * Durable relative queue ordering. Higher values win within an organization
125
+ * after cross-org fairness has selected that organization.
126
+ */
127
+ queuePriority?: number | null;
123
128
  executionProfile?: string | null;
124
129
  /** runner backend to use for executing attempts */
125
130
  runtimeBackend: string;
@@ -340,6 +340,12 @@ export type PlayAuthoringBindings = {
340
340
  billing?: {
341
341
  maxCreditsPerRun?: number;
342
342
  };
343
+ /**
344
+ * Play-level sandbox settings. The default deadline is 30 minutes; set a
345
+ * static `timeout` such as `"90m"` or `"2h"` for a bounded batch, up to 4h.
346
+ * This is distinct from `ctx.tools.execute({ timeoutMs })`, which limits one
347
+ * provider-call transport rather than the whole Play.
348
+ */
343
349
  runtime?: {
344
350
  timeout?: string;
345
351
  size?: 'standard';
@@ -2046,7 +2052,8 @@ export const PLAY_AUTHORING_FIELD_REGISTRY = {
2046
2052
  required: false,
2047
2053
  resolution: 'static-required',
2048
2054
  issueCode: 'play_authoring_binding_invalid',
2049
- description: 'Sandbox deadline such as 90m or 2h.',
2055
+ description:
2056
+ 'Play-level sandbox deadline. The default is 30m; use a static duration such as 90m or 2h, up to 4h.',
2050
2057
  errorMessage:
2051
2058
  'runtime.timeout must be a static duration such as "90m" or "2h".',
2052
2059
  },
package/dist/cli/index.js CHANGED
@@ -1047,7 +1047,7 @@ var SDK_RELEASE = {
1047
1047
  // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
1048
1048
  // available at toolResponse.rawV2 while toolResponse.raw and all declared
1049
1049
  // getters keep their established compatibility behavior.
1050
- version: "0.3.4",
1050
+ version: "0.3.6",
1051
1051
  updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
1052
1052
  contracts: {
1053
1053
  api: {
@@ -16434,7 +16434,7 @@ var PLAY_AUTHORING_FIELD_REGISTRY = {
16434
16434
  required: false,
16435
16435
  resolution: "static-required",
16436
16436
  issueCode: "play_authoring_binding_invalid",
16437
- description: "Sandbox deadline such as 90m or 2h.",
16437
+ description: "Play-level sandbox deadline. The default is 30m; use a static duration such as 90m or 2h, up to 4h.",
16438
16438
  errorMessage: 'runtime.timeout must be a static duration such as "90m" or "2h".'
16439
16439
  },
16440
16440
  "runtime.size": {
@@ -33117,6 +33117,27 @@ function renderMonitorGet(payload) {
33117
33117
  ` deepline monitors test ${key} '${JSON.stringify(samplePayload2)}' --json`
33118
33118
  );
33119
33119
  }
33120
+ const monitorSpec = asRecord2(payload.monitor_spec);
33121
+ if (monitorSpec?.available === false) {
33122
+ lines.push(
33123
+ "",
33124
+ `Monitor spec: unavailable \u2014 ${asString(monitorSpec.message) ?? "use the stored definition and check before an update."}`
33125
+ );
33126
+ }
33127
+ const specFields = Array.isArray(monitorSpec?.fields) ? monitorSpec.fields.flatMap((value) => {
33128
+ const field = asRecord2(value);
33129
+ const path = asString(field?.path);
33130
+ const description = asString(field?.description);
33131
+ return path ? [{ path, description }] : [];
33132
+ }) : [];
33133
+ if (specFields.length > 0) {
33134
+ lines.push("", "Monitor spec:");
33135
+ for (const field of specFields) {
33136
+ lines.push(
33137
+ ` ${field.path}${field.description ? ` \u2014 ${field.description}` : ""}`
33138
+ );
33139
+ }
33140
+ }
33120
33141
  lines.push("", `Current SQL listener consumers (${boundPlays.length}):`);
33121
33142
  if (boundPlays.length === 0) {
33122
33143
  lines.push(" none");
@@ -33399,7 +33420,9 @@ Examples:
33399
33420
  `
33400
33421
  Notes:
33401
33422
  Read-only. Returns the exact editable definition, selected Deepline pricing,
33402
- billing state, output streams, and dependent published plays. Inspect this
33423
+ billing state, output streams, dependent published plays, and monitor_spec.
33424
+ When monitor_spec.available is true, its fields describe the deployed type's
33425
+ editable fields and constraints; otherwise use the stored definition and check
33403
33426
  before proposing an update so scope and downstream effects are visible.
33404
33427
 
33405
33428
  Examples:
@@ -33447,6 +33470,10 @@ Notes:
33447
33470
  Provider-specific grammar, precedence, enum applicability, examples, and
33448
33471
  update semantics are returned by the live monitor contract. Inspect it with
33449
33472
  \`deepline monitors available deepline_native.company_radar --json\`.
33473
+ For a bounded urgent Deepline Native preview, use
33474
+ controls.execution_type="priority". Deepline injects the upstream marker;
33475
+ do not author custom_fields yourself. Priority is capped at ten active or
33476
+ in-flight radars per org and is not for regular or bulk-scale monitoring.
33450
33477
 
33451
33478
  Examples:
33452
33479
  deepline monitors check '{"key":"job-openings","tool":"deepline_native.company_radar","payload":{"domain":"stripe.com","radar_type":"company_job_openings"}}'
@@ -33472,6 +33499,10 @@ Notes:
33472
33499
  Deploy is a full desired definition for its key: omitting a previously stored
33473
33500
  field removes it and can replace the upstream resource. Use \`monitors update\`
33474
33501
  for a patch-style change.
33502
+ For a bounded urgent Deepline Native preview, set
33503
+ controls.execution_type="priority". Deepline injects the provider custom
33504
+ field and enforces a ten-radar per-org cap; do not use it for regular or bulk
33505
+ monitoring, and do not delete another radar automatically to make room.
33475
33506
 
33476
33507
  Examples:
33477
33508
  deepline monitors deploy '{"key":"job-openings","tool":"deepline_native.company_radar","payload":{"domain":"stripe.com","radar_type":"company_job_openings"}}'
@@ -33497,6 +33528,10 @@ positionally, via --file <path>, or from stdin with --file -.
33497
33528
  When <patch> includes payload, its top-level fields are merged with the stored
33498
33529
  payload before validation. This lets you change one filter without resending
33499
33530
  domain or radar_type; nested values and arrays replace atomically.
33531
+ Use {"controls":{"execution_type":"priority"}} only for a bounded urgent
33532
+ Deepline Native preview. The ten-radar priority cap applies on update too.
33533
+ Use {"controls":{"execution_type":null}} to release priority without
33534
+ deleting the monitor.
33500
33535
 
33501
33536
  Examples:
33502
33537
  deepline monitors update my-monitor '{"name":"Interested replies"}' --json
@@ -37958,6 +37993,27 @@ function printMonitorTypeFilters(tool) {
37958
37993
  console.log(`- ${name}${star}: ${type}${desc ? ` - ${desc}` : ""}`);
37959
37994
  }
37960
37995
  }
37996
+ function printMonitorTypeFilterExamples(tool) {
37997
+ const documentation = recordField2(tool, "documentation");
37998
+ const fields = recordField2(documentation, "fields");
37999
+ const examples = Object.entries(fields).flatMap(([name, rawField]) => {
38000
+ const grammar = recordField2(isRecord12(rawField) ? rawField : {}, "grammar");
38001
+ const example = stringField2(grammar, "example");
38002
+ const values = [
38003
+ ...arrayField2(grammar, "examples").filter(
38004
+ (value) => typeof value === "string" && Boolean(value)
38005
+ ),
38006
+ ...example ? [example] : []
38007
+ ];
38008
+ return [...new Set(values)].map((example2) => ({ name, example: example2 }));
38009
+ });
38010
+ if (examples.length === 0) return;
38011
+ console.log("");
38012
+ console.log("Filter examples:");
38013
+ for (const { name, example } of examples) {
38014
+ console.log(`- ${name}: ${example}`);
38015
+ }
38016
+ }
37961
38017
  function printMonitorTypeStreams(tool) {
37962
38018
  const streams = arrayField2(tool, "streams", "output_streams").filter(
37963
38019
  isRecord12
@@ -38016,6 +38072,7 @@ function printMonitorTypeContract(tool, requestedToolId) {
38016
38072
  );
38017
38073
  console.log("");
38018
38074
  printMonitorTypeFilters(tool);
38075
+ printMonitorTypeFilterExamples(tool);
38019
38076
  printMonitorTypeStreams(tool);
38020
38077
  console.log("");
38021
38078
  printMonitorTypePricing(tool);
@@ -1033,7 +1033,7 @@ var SDK_RELEASE = {
1033
1033
  // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
1034
1034
  // available at toolResponse.rawV2 while toolResponse.raw and all declared
1035
1035
  // getters keep their established compatibility behavior.
1036
- version: "0.3.4",
1036
+ version: "0.3.6",
1037
1037
  updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
1038
1038
  contracts: {
1039
1039
  api: {
@@ -16487,7 +16487,7 @@ var PLAY_AUTHORING_FIELD_REGISTRY = {
16487
16487
  required: false,
16488
16488
  resolution: "static-required",
16489
16489
  issueCode: "play_authoring_binding_invalid",
16490
- description: "Sandbox deadline such as 90m or 2h.",
16490
+ description: "Play-level sandbox deadline. The default is 30m; use a static duration such as 90m or 2h, up to 4h.",
16491
16491
  errorMessage: 'runtime.timeout must be a static duration such as "90m" or "2h".'
16492
16492
  },
16493
16493
  "runtime.size": {
@@ -33184,6 +33184,27 @@ function renderMonitorGet(payload) {
33184
33184
  ` deepline monitors test ${key} '${JSON.stringify(samplePayload2)}' --json`
33185
33185
  );
33186
33186
  }
33187
+ const monitorSpec = asRecord2(payload.monitor_spec);
33188
+ if (monitorSpec?.available === false) {
33189
+ lines.push(
33190
+ "",
33191
+ `Monitor spec: unavailable \u2014 ${asString(monitorSpec.message) ?? "use the stored definition and check before an update."}`
33192
+ );
33193
+ }
33194
+ const specFields = Array.isArray(monitorSpec?.fields) ? monitorSpec.fields.flatMap((value) => {
33195
+ const field = asRecord2(value);
33196
+ const path = asString(field?.path);
33197
+ const description = asString(field?.description);
33198
+ return path ? [{ path, description }] : [];
33199
+ }) : [];
33200
+ if (specFields.length > 0) {
33201
+ lines.push("", "Monitor spec:");
33202
+ for (const field of specFields) {
33203
+ lines.push(
33204
+ ` ${field.path}${field.description ? ` \u2014 ${field.description}` : ""}`
33205
+ );
33206
+ }
33207
+ }
33187
33208
  lines.push("", `Current SQL listener consumers (${boundPlays.length}):`);
33188
33209
  if (boundPlays.length === 0) {
33189
33210
  lines.push(" none");
@@ -33466,7 +33487,9 @@ Examples:
33466
33487
  `
33467
33488
  Notes:
33468
33489
  Read-only. Returns the exact editable definition, selected Deepline pricing,
33469
- billing state, output streams, and dependent published plays. Inspect this
33490
+ billing state, output streams, dependent published plays, and monitor_spec.
33491
+ When monitor_spec.available is true, its fields describe the deployed type's
33492
+ editable fields and constraints; otherwise use the stored definition and check
33470
33493
  before proposing an update so scope and downstream effects are visible.
33471
33494
 
33472
33495
  Examples:
@@ -33514,6 +33537,10 @@ Notes:
33514
33537
  Provider-specific grammar, precedence, enum applicability, examples, and
33515
33538
  update semantics are returned by the live monitor contract. Inspect it with
33516
33539
  \`deepline monitors available deepline_native.company_radar --json\`.
33540
+ For a bounded urgent Deepline Native preview, use
33541
+ controls.execution_type="priority". Deepline injects the upstream marker;
33542
+ do not author custom_fields yourself. Priority is capped at ten active or
33543
+ in-flight radars per org and is not for regular or bulk-scale monitoring.
33517
33544
 
33518
33545
  Examples:
33519
33546
  deepline monitors check '{"key":"job-openings","tool":"deepline_native.company_radar","payload":{"domain":"stripe.com","radar_type":"company_job_openings"}}'
@@ -33539,6 +33566,10 @@ Notes:
33539
33566
  Deploy is a full desired definition for its key: omitting a previously stored
33540
33567
  field removes it and can replace the upstream resource. Use \`monitors update\`
33541
33568
  for a patch-style change.
33569
+ For a bounded urgent Deepline Native preview, set
33570
+ controls.execution_type="priority". Deepline injects the provider custom
33571
+ field and enforces a ten-radar per-org cap; do not use it for regular or bulk
33572
+ monitoring, and do not delete another radar automatically to make room.
33542
33573
 
33543
33574
  Examples:
33544
33575
  deepline monitors deploy '{"key":"job-openings","tool":"deepline_native.company_radar","payload":{"domain":"stripe.com","radar_type":"company_job_openings"}}'
@@ -33564,6 +33595,10 @@ positionally, via --file <path>, or from stdin with --file -.
33564
33595
  When <patch> includes payload, its top-level fields are merged with the stored
33565
33596
  payload before validation. This lets you change one filter without resending
33566
33597
  domain or radar_type; nested values and arrays replace atomically.
33598
+ Use {"controls":{"execution_type":"priority"}} only for a bounded urgent
33599
+ Deepline Native preview. The ten-radar priority cap applies on update too.
33600
+ Use {"controls":{"execution_type":null}} to release priority without
33601
+ deleting the monitor.
33567
33602
 
33568
33603
  Examples:
33569
33604
  deepline monitors update my-monitor '{"name":"Interested replies"}' --json
@@ -38045,6 +38080,27 @@ function printMonitorTypeFilters(tool) {
38045
38080
  console.log(`- ${name}${star}: ${type}${desc ? ` - ${desc}` : ""}`);
38046
38081
  }
38047
38082
  }
38083
+ function printMonitorTypeFilterExamples(tool) {
38084
+ const documentation = recordField2(tool, "documentation");
38085
+ const fields = recordField2(documentation, "fields");
38086
+ const examples = Object.entries(fields).flatMap(([name, rawField]) => {
38087
+ const grammar = recordField2(isRecord12(rawField) ? rawField : {}, "grammar");
38088
+ const example = stringField2(grammar, "example");
38089
+ const values = [
38090
+ ...arrayField2(grammar, "examples").filter(
38091
+ (value) => typeof value === "string" && Boolean(value)
38092
+ ),
38093
+ ...example ? [example] : []
38094
+ ];
38095
+ return [...new Set(values)].map((example2) => ({ name, example: example2 }));
38096
+ });
38097
+ if (examples.length === 0) return;
38098
+ console.log("");
38099
+ console.log("Filter examples:");
38100
+ for (const { name, example } of examples) {
38101
+ console.log(`- ${name}: ${example}`);
38102
+ }
38103
+ }
38048
38104
  function printMonitorTypeStreams(tool) {
38049
38105
  const streams = arrayField2(tool, "streams", "output_streams").filter(
38050
38106
  isRecord12
@@ -38103,6 +38159,7 @@ function printMonitorTypeContract(tool, requestedToolId) {
38103
38159
  );
38104
38160
  console.log("");
38105
38161
  printMonitorTypeFilters(tool);
38162
+ printMonitorTypeFilterExamples(tool);
38106
38163
  printMonitorTypeStreams(tool);
38107
38164
  console.log("");
38108
38165
  printMonitorTypePricing(tool);
@@ -1103,6 +1103,12 @@ type PlayAuthoringBindings = {
1103
1103
  billing?: {
1104
1104
  maxCreditsPerRun?: number;
1105
1105
  };
1106
+ /**
1107
+ * Play-level sandbox settings. The default deadline is 30 minutes; set a
1108
+ * static `timeout` such as `"90m"` or `"2h"` for a bounded batch, up to 4h.
1109
+ * This is distinct from `ctx.tools.execute({ timeoutMs })`, which limits one
1110
+ * provider-call transport rather than the whole Play.
1111
+ */
1106
1112
  runtime?: {
1107
1113
  timeout?: string;
1108
1114
  size?: 'standard';
@@ -2554,7 +2560,7 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
2554
2560
  readonly required: false;
2555
2561
  readonly resolution: "static-required";
2556
2562
  readonly issueCode: "play_authoring_binding_invalid";
2557
- readonly description: "Sandbox deadline such as 90m or 2h.";
2563
+ readonly description: "Play-level sandbox deadline. The default is 30m; use a static duration such as 90m or 2h, up to 4h.";
2558
2564
  readonly errorMessage: "runtime.timeout must be a static duration such as \"90m\" or \"2h\".";
2559
2565
  };
2560
2566
  readonly 'runtime.size': {
@@ -1103,6 +1103,12 @@ type PlayAuthoringBindings = {
1103
1103
  billing?: {
1104
1104
  maxCreditsPerRun?: number;
1105
1105
  };
1106
+ /**
1107
+ * Play-level sandbox settings. The default deadline is 30 minutes; set a
1108
+ * static `timeout` such as `"90m"` or `"2h"` for a bounded batch, up to 4h.
1109
+ * This is distinct from `ctx.tools.execute({ timeoutMs })`, which limits one
1110
+ * provider-call transport rather than the whole Play.
1111
+ */
1106
1112
  runtime?: {
1107
1113
  timeout?: string;
1108
1114
  size?: 'standard';
@@ -2554,7 +2560,7 @@ declare const PLAY_AUTHORING_FIELD_REGISTRY: {
2554
2560
  readonly required: false;
2555
2561
  readonly resolution: "static-required";
2556
2562
  readonly issueCode: "play_authoring_binding_invalid";
2557
- readonly description: "Sandbox deadline such as 90m or 2h.";
2563
+ readonly description: "Play-level sandbox deadline. The default is 30m; use a static duration such as 90m or 2h, up to 4h.";
2558
2564
  readonly errorMessage: "runtime.timeout must be a static duration such as \"90m\" or \"2h\".";
2559
2565
  };
2560
2566
  readonly 'runtime.size': {
package/dist/index.d.mts CHANGED
@@ -1,5 +1,5 @@
1
- import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest, O as PlayAuthoringStepProgramOptions } from './compiler-manifest-BX85pKXW.mjs';
2
- export { Q as DEEPLINE_EXTRACTOR_TARGETS, R as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, S as DeeplineEmailStatusGetterValue, U as DeeplineExtractorTarget, V as DeeplineGetterValue, W as DeeplineGetterValueMap, X as JOB_CHANGE_STATUS_VALUES, Y as JobChangeStatus, Z as PHONE_STATUS_VALUES, _ as PhoneStatus, $ as PlayDataset, a0 as PlayDatasetInput, a1 as PreviousCell, a2 as ProviderTransientError, a3 as ProviderTransientErrorCategory, a4 as ProviderUnavailableError, a5 as ProviderUnavailableReason, a6 as ToolExecutionErrorCategory, a7 as ToolExecutionErrorOrigin, a8 as ToolExecutionFailureV1, a9 as ToolExecutionNetworkKind, aa as ToolExecutionNetworkScope, ab as getProviderUnavailableReason, ac as isDeeplineExtractorTarget, ad as isProviderUnavailable, ae as isProviderWaterfallUnavailableError } from './compiler-manifest-BX85pKXW.mjs';
1
+ import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest, O as PlayAuthoringStepProgramOptions } from './compiler-manifest-CdgJeOr2.mjs';
2
+ export { Q as DEEPLINE_EXTRACTOR_TARGETS, R as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, S as DeeplineEmailStatusGetterValue, U as DeeplineExtractorTarget, V as DeeplineGetterValue, W as DeeplineGetterValueMap, X as JOB_CHANGE_STATUS_VALUES, Y as JobChangeStatus, Z as PHONE_STATUS_VALUES, _ as PhoneStatus, $ as PlayDataset, a0 as PlayDatasetInput, a1 as PreviousCell, a2 as ProviderTransientError, a3 as ProviderTransientErrorCategory, a4 as ProviderUnavailableError, a5 as ProviderUnavailableReason, a6 as ToolExecutionErrorCategory, a7 as ToolExecutionErrorOrigin, a8 as ToolExecutionFailureV1, a9 as ToolExecutionNetworkKind, aa as ToolExecutionNetworkScope, ab as getProviderUnavailableReason, ac as isDeeplineExtractorTarget, ad as isProviderUnavailable, ae as isProviderWaterfallUnavailableError } from './compiler-manifest-CdgJeOr2.mjs';
3
3
  import '@sinclair/typebox';
4
4
 
5
5
  declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -1796,6 +1796,13 @@ type MonitorPayload = Record<string, unknown>;
1796
1796
  * bump; known controls are typed for discoverability.
1797
1797
  */
1798
1798
  type MonitorControls = {
1799
+ /**
1800
+ * Request Deepline Native priority execution for a bounded urgent preview or
1801
+ * calibration radar. Deepline sends the upstream custom-field marker and
1802
+ * enforces a maximum of ten active or in-flight priority radars per org.
1803
+ * Omit this for regular and bulk-scale monitoring.
1804
+ */
1805
+ execution_type?: 'priority';
1799
1806
  [key: string]: unknown;
1800
1807
  };
1801
1808
  /**
@@ -2247,7 +2254,21 @@ type MonitorsListOptions = {
2247
2254
  */
2248
2255
  type MonitorCheckResult = Record<string, unknown>;
2249
2256
  type MonitorDeployResult = Record<string, unknown>;
2250
- type MonitorDetail = Record<string, unknown>;
2257
+ /** Field-level monitor capability spec returned by `client.monitors.get(...)`. */
2258
+ type MonitorSpec = {
2259
+ /** Whether Deepline has a current capability spec for this deployed monitor. */
2260
+ available?: boolean;
2261
+ tool?: string;
2262
+ description?: string;
2263
+ fields?: Array<Record<string, unknown>>;
2264
+ conditional_requirements?: Array<Record<string, unknown>>;
2265
+ /** Present when a legacy monitor has no current capability spec. */
2266
+ message?: string;
2267
+ };
2268
+ /** One deployed-monitor read. The server may add monitor-specific fields. */
2269
+ type MonitorDetail = Record<string, unknown> & {
2270
+ monitor_spec?: MonitorSpec;
2271
+ };
2251
2272
  type MonitorDependents = Record<string, unknown>;
2252
2273
  type MonitorUpdateChangeSummary = {
2253
2274
  definition: {
@@ -3873,7 +3894,7 @@ type RuntimeStepOptions = PlayAuthoringRuntimeStepOptions;
3873
3894
  type FetchOptions = PlayAuthoringFetchOptions;
3874
3895
  type PlayFetchResponse = PlayAuthoringFetchResponse;
3875
3896
  /**
3876
- * Optional trigger bindings for a play.
3897
+ * Optional Play configuration, including triggers and runtime limits.
3877
3898
  *
3878
3899
  * A play can be triggered three ways, declared as the third argument to
3879
3900
  * {@link definePlay}:
@@ -3887,6 +3908,10 @@ type PlayFetchResponse = PlayAuthoringFetchResponse;
3887
3908
  * `deepline monitors available <id>` for a tool's streams and row columns).
3888
3909
  * The changed row is delivered to the handler as the listener event's `after`.
3889
3910
  *
3911
+ * The default Play runtime is 30 minutes. For bounded long-running batches, add
3912
+ * `runtime: { timeout: '90m', size: 'standard' }`; duration values are whole minutes or hours, up to `4h`.
3913
+ * It differs from `ctx.tools.execute({ timeoutMs })`, which limits one provider call.
3914
+ *
3890
3915
  * @example Webhook with HMAC verification
3891
3916
  * ```typescript
3892
3917
  * definePlay('webhook-handler', handler, {
@@ -4447,7 +4472,7 @@ declare function defineInput<TInput>(schema: Record<string, unknown>): PlayInput
4447
4472
  * @param config - Object-form play config.
4448
4473
  * @param name - Play name.
4449
4474
  * @param fn - Play function.
4450
- * @param bindings - Trigger bindings.
4475
+ * @param bindings - Play configuration, including runtime limits and triggers.
4451
4476
  * @returns A {@link DefinedPlay} that is both callable and has lifecycle methods
4452
4477
  *
4453
4478
  * @example Basic play
@@ -4520,7 +4545,7 @@ declare function definePlay<TInput, TOutput extends PlayReturnObject>(config: De
4520
4545
  *
4521
4546
  * @param name - Play name.
4522
4547
  * @param fn - Play function.
4523
- * @param bindings - Trigger bindings.
4548
+ * @param bindings - Play configuration, including runtime limits and triggers.
4524
4549
  * @returns Play handle.
4525
4550
  */
4526
4551
  declare function definePlay<TInput, TOutput extends PlayReturnObject>(name: string, fn: (ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>, bindings?: PlayBindings): DefinedPlay<TInput, TOutput>;
@@ -4698,4 +4723,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
4698
4723
  */
4699
4724
  declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
4700
4725
 
4701
- export { AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LiveEventEnvelope, type MonitorCheckResult, type MonitorControls, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, type ToolSearchOptions, type ToolSearchResult, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
4726
+ export { AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LiveEventEnvelope, type MonitorCheckResult, type MonitorControls, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, type ToolSearchOptions, type ToolSearchResult, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
package/dist/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest, O as PlayAuthoringStepProgramOptions } from './compiler-manifest-BX85pKXW.js';
2
- export { Q as DEEPLINE_EXTRACTOR_TARGETS, R as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, S as DeeplineEmailStatusGetterValue, U as DeeplineExtractorTarget, V as DeeplineGetterValue, W as DeeplineGetterValueMap, X as JOB_CHANGE_STATUS_VALUES, Y as JobChangeStatus, Z as PHONE_STATUS_VALUES, _ as PhoneStatus, $ as PlayDataset, a0 as PlayDatasetInput, a1 as PreviousCell, a2 as ProviderTransientError, a3 as ProviderTransientErrorCategory, a4 as ProviderUnavailableError, a5 as ProviderUnavailableReason, a6 as ToolExecutionErrorCategory, a7 as ToolExecutionErrorOrigin, a8 as ToolExecutionFailureV1, a9 as ToolExecutionNetworkKind, aa as ToolExecutionNetworkScope, ab as getProviderUnavailableReason, ac as isDeeplineExtractorTarget, ad as isProviderUnavailable, ae as isProviderWaterfallUnavailableError } from './compiler-manifest-BX85pKXW.js';
1
+ import { e as PlayRuntimeBackendId, c as PlayCompilerManifest, D as DeeplineError, f as ToolExecutionError, g as ToolExecutionErrorOptions, h as PlayAuthoringColumnMap, i as PlayAuthoringColumnResolver, j as PlayAuthoringRuntimeContext, k as PlayAuthoringConditionalStepResolver, l as PlayAuthoringCsvInput, m as PlayAuthoringCsvOptions, n as PlayAuthoringDatasetBuilder, o as PlayAuthoringDatasetColumnDefinition, p as PlayAuthoringDatasetColumnRunInput, q as ToolExecuteResult, r as PlayAuthoringReferenceLike, s as PlayReturnObject$1, t as PlayAuthoringDefineConfig, u as PlayAuthoringDefinedPlay, v as PlayAuthoringFetchOptions, w as PlayAuthoringFileInput, x as PlayAuthoringBindings, y as PlayAuthoringCallExecution, z as PlayAuthoringCallOptions, A as PlayAuthoringFetchResponse, B as PlayAuthoringInputContract, C as PlayAuthoringStepProgramStep, E as PlayAuthoringRuntimeStepOptions, F as PlaySqlListenerDeclaration, G as PlaySqlListenerEvent, H as PlaySqlListenerOperation, I as PlaySqlQuery, J as PlayAuthoringStepOptions, K as PlayAuthoringStepProgram, L as PlayAuthoringStepProgramResolver, M as PlayAuthoringStepResolver, N as PlayToolExecutionRequest, O as PlayAuthoringStepProgramOptions } from './compiler-manifest-CdgJeOr2.js';
2
+ export { Q as DEEPLINE_EXTRACTOR_TARGETS, R as DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS, S as DeeplineEmailStatusGetterValue, U as DeeplineExtractorTarget, V as DeeplineGetterValue, W as DeeplineGetterValueMap, X as JOB_CHANGE_STATUS_VALUES, Y as JobChangeStatus, Z as PHONE_STATUS_VALUES, _ as PhoneStatus, $ as PlayDataset, a0 as PlayDatasetInput, a1 as PreviousCell, a2 as ProviderTransientError, a3 as ProviderTransientErrorCategory, a4 as ProviderUnavailableError, a5 as ProviderUnavailableReason, a6 as ToolExecutionErrorCategory, a7 as ToolExecutionErrorOrigin, a8 as ToolExecutionFailureV1, a9 as ToolExecutionNetworkKind, aa as ToolExecutionNetworkScope, ab as getProviderUnavailableReason, ac as isDeeplineExtractorTarget, ad as isProviderUnavailable, ae as isProviderWaterfallUnavailableError } from './compiler-manifest-CdgJeOr2.js';
3
3
  import '@sinclair/typebox';
4
4
 
5
5
  declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -1796,6 +1796,13 @@ type MonitorPayload = Record<string, unknown>;
1796
1796
  * bump; known controls are typed for discoverability.
1797
1797
  */
1798
1798
  type MonitorControls = {
1799
+ /**
1800
+ * Request Deepline Native priority execution for a bounded urgent preview or
1801
+ * calibration radar. Deepline sends the upstream custom-field marker and
1802
+ * enforces a maximum of ten active or in-flight priority radars per org.
1803
+ * Omit this for regular and bulk-scale monitoring.
1804
+ */
1805
+ execution_type?: 'priority';
1799
1806
  [key: string]: unknown;
1800
1807
  };
1801
1808
  /**
@@ -2247,7 +2254,21 @@ type MonitorsListOptions = {
2247
2254
  */
2248
2255
  type MonitorCheckResult = Record<string, unknown>;
2249
2256
  type MonitorDeployResult = Record<string, unknown>;
2250
- type MonitorDetail = Record<string, unknown>;
2257
+ /** Field-level monitor capability spec returned by `client.monitors.get(...)`. */
2258
+ type MonitorSpec = {
2259
+ /** Whether Deepline has a current capability spec for this deployed monitor. */
2260
+ available?: boolean;
2261
+ tool?: string;
2262
+ description?: string;
2263
+ fields?: Array<Record<string, unknown>>;
2264
+ conditional_requirements?: Array<Record<string, unknown>>;
2265
+ /** Present when a legacy monitor has no current capability spec. */
2266
+ message?: string;
2267
+ };
2268
+ /** One deployed-monitor read. The server may add monitor-specific fields. */
2269
+ type MonitorDetail = Record<string, unknown> & {
2270
+ monitor_spec?: MonitorSpec;
2271
+ };
2251
2272
  type MonitorDependents = Record<string, unknown>;
2252
2273
  type MonitorUpdateChangeSummary = {
2253
2274
  definition: {
@@ -3873,7 +3894,7 @@ type RuntimeStepOptions = PlayAuthoringRuntimeStepOptions;
3873
3894
  type FetchOptions = PlayAuthoringFetchOptions;
3874
3895
  type PlayFetchResponse = PlayAuthoringFetchResponse;
3875
3896
  /**
3876
- * Optional trigger bindings for a play.
3897
+ * Optional Play configuration, including triggers and runtime limits.
3877
3898
  *
3878
3899
  * A play can be triggered three ways, declared as the third argument to
3879
3900
  * {@link definePlay}:
@@ -3887,6 +3908,10 @@ type PlayFetchResponse = PlayAuthoringFetchResponse;
3887
3908
  * `deepline monitors available <id>` for a tool's streams and row columns).
3888
3909
  * The changed row is delivered to the handler as the listener event's `after`.
3889
3910
  *
3911
+ * The default Play runtime is 30 minutes. For bounded long-running batches, add
3912
+ * `runtime: { timeout: '90m', size: 'standard' }`; duration values are whole minutes or hours, up to `4h`.
3913
+ * It differs from `ctx.tools.execute({ timeoutMs })`, which limits one provider call.
3914
+ *
3890
3915
  * @example Webhook with HMAC verification
3891
3916
  * ```typescript
3892
3917
  * definePlay('webhook-handler', handler, {
@@ -4447,7 +4472,7 @@ declare function defineInput<TInput>(schema: Record<string, unknown>): PlayInput
4447
4472
  * @param config - Object-form play config.
4448
4473
  * @param name - Play name.
4449
4474
  * @param fn - Play function.
4450
- * @param bindings - Trigger bindings.
4475
+ * @param bindings - Play configuration, including runtime limits and triggers.
4451
4476
  * @returns A {@link DefinedPlay} that is both callable and has lifecycle methods
4452
4477
  *
4453
4478
  * @example Basic play
@@ -4520,7 +4545,7 @@ declare function definePlay<TInput, TOutput extends PlayReturnObject>(config: De
4520
4545
  *
4521
4546
  * @param name - Play name.
4522
4547
  * @param fn - Play function.
4523
- * @param bindings - Trigger bindings.
4548
+ * @param bindings - Play configuration, including runtime limits and triggers.
4524
4549
  * @returns Play handle.
4525
4550
  */
4526
4551
  declare function definePlay<TInput, TOutput extends PlayReturnObject>(name: string, fn: (ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>, bindings?: PlayBindings): DefinedPlay<TInput, TOutput>;
@@ -4698,4 +4723,4 @@ declare function writeCsvOutputFile(rows: Array<Record<string, unknown>>, stem:
4698
4723
  */
4699
4724
  declare function extractSummaryFields(payload: unknown): Record<string, Scalar>;
4700
4725
 
4701
- export { AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LiveEventEnvelope, type MonitorCheckResult, type MonitorControls, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, type ToolSearchOptions, type ToolSearchResult, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
4726
+ export { AuthError, type BillingCreditPool, type BillingInvoiceEntry, type BillingInvoicesResult, type BillingNamespace, type BillingPaymentMethodSummary, type BillingSubscriptionCancelResult, type BillingSubscriptionStatus, type BillingTopUpResult, type ClearPlayHistoryRequest, type ClearPlayHistoryResult, type ColumnMap, type ColumnResolver, type ConditionalStepResolver, ConfigError, type CsvInput, type CsvOptions, type CustomerDbQueryResult, DEEPLINE_TOOL_CATEGORIES, type DatasetBuilder, type DatasetColumnDefinition, type DatasetColumnRunInput, type DbNamespace, Deepline, DeeplineClient, type DeeplineClientOptions, DeeplineContext, DeeplineError, type DeeplineNamedPlay, type DeeplinePlayRuntimeContext, type DeeplinePlaysNamespace, type DeeplineToolCategory, type DeeplineToolsNamespace, type DefinePlayConfig, type DefinedPlay, type FetchOptions, type FileInput, type IngestionStorageRepairResult, type LiveEventEnvelope, type MonitorCheckResult, type MonitorControls, type MonitorDefinition, type MonitorDeleteResult, type MonitorDependents, type MonitorDeployResult, type MonitorDetail, type MonitorListEntry, type MonitorPayload, type MonitorReactivateResult, type MonitorSpec, type MonitorUpdateChangeSummary, type MonitorUpdateResult, type MonitorsAccessStatus, type MonitorsAvailableOptions, type MonitorsAvailableResult, type MonitorsListOptions, type MonitorsListResult, type MonitorsNamespace, PLAY_BOOTSTRAP_COMPANY_FIELDS, PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_CONTACT_FIELDS, PLAY_BOOTSTRAP_FINDER_KINDS, PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER, PLAY_BOOTSTRAP_PEOPLE_PROVIDER_CATEGORY, PLAY_BOOTSTRAP_PROVIDER_CATEGORY_BY_FINDER, PLAY_BOOTSTRAP_SOURCE_KINDS, PLAY_BOOTSTRAP_STAGE_KINDS, PLAY_BOOTSTRAP_TEMPLATES, PROD_URL, type PlayActivityObservation, type PlayActivityState, type PlayActivityTarget, type PlayBindings, type PlayBootstrapEntityKind, type PlayBootstrapFinderKind, type PlayCallExecution, type PlayCallOptions, type PlayFetchResponse, type PlayInputContract, type PlayJob, type PlayListItem, type PlayLiveEvent, type PlayRevisionSummary, type PlayRunActionPackage, type PlayRunActivityProjection, type PlayRunDatasetActions, type PlayRunPackage, type PlayRunResult, type PlayRunStart, type PlaySheetRow, type PlaySheetRowsResult, type PlayStatus, type PlayStepProgramStep, type PrebuiltPlayRef, type PublishPlayVersionRequest, type PublishPlayVersionResult, RateLimitError, type ResolvedConfig, RunObserveTransportUnavailableError, type RunsListOptions, type RunsLogsOptions, type RunsLogsResult, type RunsNamespace, type RunsTailOptions, type RuntimeStepOptions, SDK_API_CONTRACT, SDK_VERSION, type SqlListenerDeclaration, type SqlListenerEvent, type SqlListenerOperation, type SqlQuery, type StartPlayRunRequest, type StepOptions, type StepProgram, type StepProgramResolver, type StepResolver, type StopPlayRunResult, type ToolDefinition, ToolExecuteResult, type ToolExecution, ToolExecutionError, ToolExecutionErrorOptions, type ToolExecutionRequest, type ToolMetadata, ToolRateLimitError, type ToolSearchOptions, type ToolSearchResult, defineInput, defineMonitor, definePlay, defineWorkflow, extractSummaryFields, formatPlayBootstrapFinderKinds, formatPlayBootstrapFinderKindsForSentence, formatPlayBootstrapTemplates, getDefinedPlayMetadata, isPlayBootstrapFinderKind, isPlayBootstrapTemplate, resolveConfig, runIf, steps, tryConvertToList, writeCsvOutputFile, writeJsonOutputFile };
package/dist/index.js CHANGED
@@ -783,7 +783,7 @@ var SDK_RELEASE = {
783
783
  // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
784
784
  // available at toolResponse.rawV2 while toolResponse.raw and all declared
785
785
  // getters keep their established compatibility behavior.
786
- version: "0.3.4",
786
+ version: "0.3.6",
787
787
  updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
788
788
  contracts: {
789
789
  api: {
package/dist/index.mjs CHANGED
@@ -706,7 +706,7 @@ var SDK_RELEASE = {
706
706
  // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
707
707
  // available at toolResponse.rawV2 while toolResponse.raw and all declared
708
708
  // getters keep their established compatibility behavior.
709
- version: "0.3.4",
709
+ version: "0.3.6",
710
710
  updateSummary: "New raw-v2 tool responses preserve complete scrubbed provider envelopes at toolResponse.rawV2, including JSON:API included resources, links, cursors, and totals. Existing toolResponse.raw and declared getters keep working unchanged.",
711
711
  contracts: {
712
712
  api: {
@@ -226,8 +226,8 @@
226
226
  "dist/cli/index.d.ts",
227
227
  "dist/cli/index.js",
228
228
  "dist/cli/index.mjs",
229
- "dist/compiler-manifest-BX85pKXW.d.mts",
230
- "dist/compiler-manifest-BX85pKXW.d.ts",
229
+ "dist/compiler-manifest-CdgJeOr2.d.mts",
230
+ "dist/compiler-manifest-CdgJeOr2.d.ts",
231
231
  "dist/helpers.d.mts",
232
232
  "dist/helpers.d.ts",
233
233
  "dist/helpers.js",
@@ -1,5 +1,5 @@
1
- import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-BX85pKXW.mjs';
2
- export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-BX85pKXW.mjs';
1
+ import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-CdgJeOr2.mjs';
2
+ export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-CdgJeOr2.mjs';
3
3
  import '@sinclair/typebox';
4
4
 
5
5
  /**
@@ -1,5 +1,5 @@
1
- import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-BX85pKXW.js';
2
- export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-BX85pKXW.js';
1
+ import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-CdgJeOr2.js';
2
+ export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-CdgJeOr2.js';
3
3
  import '@sinclair/typebox';
4
4
 
5
5
  /**
@@ -3683,7 +3683,7 @@ var PLAY_AUTHORING_FIELD_REGISTRY = {
3683
3683
  required: false,
3684
3684
  resolution: "static-required",
3685
3685
  issueCode: "play_authoring_binding_invalid",
3686
- description: "Sandbox deadline such as 90m or 2h.",
3686
+ description: "Play-level sandbox deadline. The default is 30m; use a static duration such as 90m or 2h, up to 4h.",
3687
3687
  errorMessage: 'runtime.timeout must be a static duration such as "90m" or "2h".'
3688
3688
  },
3689
3689
  "runtime.size": {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "deepline",
3
- "version": "0.3.4",
3
+ "version": "0.3.6",
4
4
  "description": "GTM data CLI and TypeScript SDK for coding agents",
5
5
  "license": "MIT",
6
6
  "homepage": "https://code.deepline.com",