deepline 0.1.154 → 0.1.156

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.
@@ -281,12 +281,14 @@ export type { PreviousCell } from '../../shared_libs/play-runtime/cell-staleness
281
281
  * Keyword-style request object for `ctx.tools.execute(...)`.
282
282
  *
283
283
  * The `tool` value comes from live tool discovery. The `id` is the stable
284
- * logical call name inside this play and participates in replay/idempotency.
284
+ * logical call name used for logs, metadata, and receipt attachment. Provider
285
+ * call reuse is keyed by play, tool, semantic input, auth scope, provider action
286
+ * version, and cache policy.
285
287
  *
286
288
  * @sdkReference runtime 160
287
289
  */
288
290
  export type ToolExecutionRequest = {
289
- /** Stable logical id for this tool call within the play. */
291
+ /** Stable logical id for logs, metadata, and receipt attachment. */
290
292
  id: string;
291
293
  /** Current tool id from `deepline tools search` / `deepline tools describe`. */
292
294
  tool: string;
@@ -102,18 +102,20 @@ export const SDK_RELEASE = {
102
102
  // the SDK enrich generator's one-second stale policy.
103
103
  // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
104
104
  // 0.1.111 ships dataset-native tool list getters and result row datasets.
105
- version: '0.1.154',
105
+ // 0.1.154 removes the short-lived generated enrich StepOptions recompute
106
+ // fields shipped in 0.1.153.
107
+ version: '0.1.156',
106
108
  apiContract: '2026-06-dataset-handle-results-hard-cutover',
107
109
  supportPolicy: {
108
- latest: '0.1.154',
110
+ latest: '0.1.156',
109
111
  minimumSupported: '0.1.53',
110
112
  deprecatedBelow: '0.1.53',
111
113
  commandMinimumSupported: [
112
114
  {
113
115
  command: 'enrich',
114
- minimumSupported: '0.1.108',
116
+ minimumSupported: '0.1.154',
115
117
  reason:
116
- 'Older SDK CLI enrich generated stale play source for the current dataset API.',
118
+ 'Older SDK CLI enrich generated stale play source; SDK CLI enrich 0.1.153 generated removed StepOptions fields in play source.',
117
119
  },
118
120
  {
119
121
  command: 'plays',
package/dist/cli/index.js CHANGED
@@ -655,17 +655,19 @@ var SDK_RELEASE = {
655
655
  // the SDK enrich generator's one-second stale policy.
656
656
  // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
657
657
  // 0.1.111 ships dataset-native tool list getters and result row datasets.
658
- version: "0.1.154",
658
+ // 0.1.154 removes the short-lived generated enrich StepOptions recompute
659
+ // fields shipped in 0.1.153.
660
+ version: "0.1.156",
659
661
  apiContract: "2026-06-dataset-handle-results-hard-cutover",
660
662
  supportPolicy: {
661
- latest: "0.1.154",
663
+ latest: "0.1.156",
662
664
  minimumSupported: "0.1.53",
663
665
  deprecatedBelow: "0.1.53",
664
666
  commandMinimumSupported: [
665
667
  {
666
668
  command: "enrich",
667
- minimumSupported: "0.1.108",
668
- reason: "Older SDK CLI enrich generated stale play source for the current dataset API."
669
+ minimumSupported: "0.1.154",
670
+ reason: "Older SDK CLI enrich generated stale play source; SDK CLI enrich 0.1.153 generated removed StepOptions fields in play source."
669
671
  },
670
672
  {
671
673
  command: "plays",
@@ -9363,7 +9365,7 @@ async function traceCliSpan(phase, fields, run) {
9363
9365
  var EXTRACTED_GETTER_ERROR_HINT = "Deepline hint: extractedValues/extractedLists .get() only works for declared Deepline getters listed by `deepline tools describe <tool> --json`. Use `toolExecutionResult.toolResponse.raw` for provider/tool-specific fields.";
9364
9366
  var DATASET_API_HINT = "Deepline hint: PlayDataset is lazy and durable. Use `.peek(n)` for a small preview or `.materialize()` when you intentionally need rows in memory; do not use `.rows`, `.toArray()`, or array methods directly on the dataset handle.";
9365
9367
  var ROW_PROPERTY_HINT = "Deepline hint: this row type only contains fields produced by the CSV/schema and previous map steps. Check source column casing and the exact output field names from earlier steps before scaling.";
9366
- var TOOLS_EXECUTE_SIGNATURE_HINT = "Deepline hint: ctx.tools.execute requires a request object: `ctx.tools.execute({ id, tool, input, description })`. The stable `id` is required for replay-safe receipts.";
9368
+ var TOOLS_EXECUTE_SIGNATURE_HINT = "Deepline hint: ctx.tools.execute requires a request object: `ctx.tools.execute({ id, tool, input, description })`. The stable `id` is required for logs, metadata, and receipt attachment; provider-call reuse is based on play, tool, semantic input, auth scope, provider action version, and cache policy.";
9367
9369
  var RUN_PLAY_SIGNATURE_HINT = "Deepline hint: ctx.runPlay uses a stable key plus a composable child play reference. Direct-run-only or map-backed batch plays must be run directly, exported, then consumed by a separate play.";
9368
9370
  var MAP_BACKED_CHILD_HINT = "Deepline hint: map-backed child plays own durable table state and cannot be called from another play. Run that play directly, export its dataset, then pass the CSV to the next play.";
9369
9371
  function sourceLineForError(sourceCode, error) {
@@ -12838,7 +12840,7 @@ function writeStartedPlayRun(input2) {
12838
12840
  );
12839
12841
  }
12840
12842
  function parsePlayRunOptions(args) {
12841
- const usage = "Usage: deepline plays run <play-name> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n deepline plays run <play-file.ts> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n deepline plays run --file <play-file.ts> [--input '{...}'] [--profile <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n deepline plays run --name <name> [--input '{...}'] [--profile <id>] [--live|--latest|--revision-id <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--no-open] [--json] [--full] [--<input> value]\n --profile defaults to workers_edge; pass hatchet explicitly for Hatchet runtime comparison.\n Unknown --<input> value flags, such as --limit 5, are passed into play input.\nRun `deepline plays run --help` for idempotency, tool call id, and ctx.dataset guidance.";
12843
+ const usage = "Usage: deepline plays run <play-name> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n deepline plays run <play-file.ts> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n deepline plays run --file <play-file.ts> [--input '{...}'] [--profile <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n deepline plays run --name <name> [--input '{...}'] [--profile <id>] [--live|--latest|--revision-id <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--no-open] [--json] [--full] [--<input> value]\n --profile defaults to workers_edge; pass hatchet explicitly for Hatchet runtime comparison.\n Unknown --<input> value flags, such as --limit 5, are passed into play input.\nRun `deepline plays run --help` for idempotent call caching and ctx.dataset guidance.";
12842
12844
  let filePath = null;
12843
12845
  let playName = null;
12844
12846
  let input2 = null;
@@ -14694,10 +14696,15 @@ Notes:
14694
14696
  This command starts cloud work and may spend Deepline credits through tool calls.
14695
14697
 
14696
14698
  Idempotent execution:
14697
- Stable tool call ids are the reuse key:
14699
+ Durable tool-call reuse is based on the actual external call identity:
14700
+ same play, tool, semantic input, auth scope, provider action version, and
14701
+ cache policy.
14698
14702
 
14699
14703
  await ctx.tools.execute({ id: 'company_lookup', tool, input });
14700
14704
 
14705
+ The authored id is still required for readable logs, metadata, and receipt
14706
+ attachment, but renaming it alone does not rebuy the same provider request.
14707
+
14701
14708
  For rows, use ctx.dataset plus a stable row key:
14702
14709
 
14703
14710
  const rows = await ctx
@@ -14709,8 +14716,7 @@ Idempotent execution:
14709
14716
  }))
14710
14717
  .run({ key: 'domain' });
14711
14718
 
14712
- Reuse needs the same play, call id, semantic input, auth scope, and cache
14713
- policy. Dataset cells are storage; put freshness on the actual call:
14719
+ Dataset cells are storage; put freshness on the actual call:
14714
14720
 
14715
14721
  await ctx.tools.execute({
14716
14722
  id: 'find_cto',
@@ -640,17 +640,19 @@ var SDK_RELEASE = {
640
640
  // the SDK enrich generator's one-second stale policy.
641
641
  // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
642
642
  // 0.1.111 ships dataset-native tool list getters and result row datasets.
643
- version: "0.1.154",
643
+ // 0.1.154 removes the short-lived generated enrich StepOptions recompute
644
+ // fields shipped in 0.1.153.
645
+ version: "0.1.156",
644
646
  apiContract: "2026-06-dataset-handle-results-hard-cutover",
645
647
  supportPolicy: {
646
- latest: "0.1.154",
648
+ latest: "0.1.156",
647
649
  minimumSupported: "0.1.53",
648
650
  deprecatedBelow: "0.1.53",
649
651
  commandMinimumSupported: [
650
652
  {
651
653
  command: "enrich",
652
- minimumSupported: "0.1.108",
653
- reason: "Older SDK CLI enrich generated stale play source for the current dataset API."
654
+ minimumSupported: "0.1.154",
655
+ reason: "Older SDK CLI enrich generated stale play source; SDK CLI enrich 0.1.153 generated removed StepOptions fields in play source."
654
656
  },
655
657
  {
656
658
  command: "plays",
@@ -9386,7 +9388,7 @@ async function traceCliSpan(phase, fields, run) {
9386
9388
  var EXTRACTED_GETTER_ERROR_HINT = "Deepline hint: extractedValues/extractedLists .get() only works for declared Deepline getters listed by `deepline tools describe <tool> --json`. Use `toolExecutionResult.toolResponse.raw` for provider/tool-specific fields.";
9387
9389
  var DATASET_API_HINT = "Deepline hint: PlayDataset is lazy and durable. Use `.peek(n)` for a small preview or `.materialize()` when you intentionally need rows in memory; do not use `.rows`, `.toArray()`, or array methods directly on the dataset handle.";
9388
9390
  var ROW_PROPERTY_HINT = "Deepline hint: this row type only contains fields produced by the CSV/schema and previous map steps. Check source column casing and the exact output field names from earlier steps before scaling.";
9389
- var TOOLS_EXECUTE_SIGNATURE_HINT = "Deepline hint: ctx.tools.execute requires a request object: `ctx.tools.execute({ id, tool, input, description })`. The stable `id` is required for replay-safe receipts.";
9391
+ var TOOLS_EXECUTE_SIGNATURE_HINT = "Deepline hint: ctx.tools.execute requires a request object: `ctx.tools.execute({ id, tool, input, description })`. The stable `id` is required for logs, metadata, and receipt attachment; provider-call reuse is based on play, tool, semantic input, auth scope, provider action version, and cache policy.";
9390
9392
  var RUN_PLAY_SIGNATURE_HINT = "Deepline hint: ctx.runPlay uses a stable key plus a composable child play reference. Direct-run-only or map-backed batch plays must be run directly, exported, then consumed by a separate play.";
9391
9393
  var MAP_BACKED_CHILD_HINT = "Deepline hint: map-backed child plays own durable table state and cannot be called from another play. Run that play directly, export its dataset, then pass the CSV to the next play.";
9392
9394
  function sourceLineForError(sourceCode, error) {
@@ -12861,7 +12863,7 @@ function writeStartedPlayRun(input2) {
12861
12863
  );
12862
12864
  }
12863
12865
  function parsePlayRunOptions(args) {
12864
- const usage = "Usage: deepline plays run <play-name> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n deepline plays run <play-file.ts> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n deepline plays run --file <play-file.ts> [--input '{...}'] [--profile <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n deepline plays run --name <name> [--input '{...}'] [--profile <id>] [--live|--latest|--revision-id <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--no-open] [--json] [--full] [--<input> value]\n --profile defaults to workers_edge; pass hatchet explicitly for Hatchet runtime comparison.\n Unknown --<input> value flags, such as --limit 5, are passed into play input.\nRun `deepline plays run --help` for idempotency, tool call id, and ctx.dataset guidance.";
12866
+ const usage = "Usage: deepline plays run <play-name> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n deepline plays run <play-file.ts> [--input '{...}'] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n deepline plays run --file <play-file.ts> [--input '{...}'] [--profile <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--full] [--<input> value]\n deepline plays run --name <name> [--input '{...}'] [--profile <id>] [--live|--latest|--revision-id <id>] [--no-wait] [--tail-timeout-ms 30000] [--force] [--no-open] [--json] [--full] [--<input> value]\n --profile defaults to workers_edge; pass hatchet explicitly for Hatchet runtime comparison.\n Unknown --<input> value flags, such as --limit 5, are passed into play input.\nRun `deepline plays run --help` for idempotent call caching and ctx.dataset guidance.";
12865
12867
  let filePath = null;
12866
12868
  let playName = null;
12867
12869
  let input2 = null;
@@ -14717,10 +14719,15 @@ Notes:
14717
14719
  This command starts cloud work and may spend Deepline credits through tool calls.
14718
14720
 
14719
14721
  Idempotent execution:
14720
- Stable tool call ids are the reuse key:
14722
+ Durable tool-call reuse is based on the actual external call identity:
14723
+ same play, tool, semantic input, auth scope, provider action version, and
14724
+ cache policy.
14721
14725
 
14722
14726
  await ctx.tools.execute({ id: 'company_lookup', tool, input });
14723
14727
 
14728
+ The authored id is still required for readable logs, metadata, and receipt
14729
+ attachment, but renaming it alone does not rebuy the same provider request.
14730
+
14724
14731
  For rows, use ctx.dataset plus a stable row key:
14725
14732
 
14726
14733
  const rows = await ctx
@@ -14732,8 +14739,7 @@ Idempotent execution:
14732
14739
  }))
14733
14740
  .run({ key: 'domain' });
14734
14741
 
14735
- Reuse needs the same play, call id, semantic input, auth scope, and cache
14736
- policy. Dataset cells are storage; put freshness on the actual call:
14742
+ Dataset cells are storage; put freshness on the actual call:
14737
14743
 
14738
14744
  await ctx.tools.execute({
14739
14745
  id: 'find_cto',
package/dist/index.d.mts CHANGED
@@ -2914,12 +2914,14 @@ type LoosePlayObject = {
2914
2914
  * Keyword-style request object for `ctx.tools.execute(...)`.
2915
2915
  *
2916
2916
  * The `tool` value comes from live tool discovery. The `id` is the stable
2917
- * logical call name inside this play and participates in replay/idempotency.
2917
+ * logical call name used for logs, metadata, and receipt attachment. Provider
2918
+ * call reuse is keyed by play, tool, semantic input, auth scope, provider action
2919
+ * version, and cache policy.
2918
2920
  *
2919
2921
  * @sdkReference runtime 160
2920
2922
  */
2921
2923
  type ToolExecutionRequest = {
2922
- /** Stable logical id for this tool call within the play. */
2924
+ /** Stable logical id for logs, metadata, and receipt attachment. */
2923
2925
  id: string;
2924
2926
  /** Current tool id from `deepline tools search` / `deepline tools describe`. */
2925
2927
  tool: string;
package/dist/index.d.ts CHANGED
@@ -2914,12 +2914,14 @@ type LoosePlayObject = {
2914
2914
  * Keyword-style request object for `ctx.tools.execute(...)`.
2915
2915
  *
2916
2916
  * The `tool` value comes from live tool discovery. The `id` is the stable
2917
- * logical call name inside this play and participates in replay/idempotency.
2917
+ * logical call name used for logs, metadata, and receipt attachment. Provider
2918
+ * call reuse is keyed by play, tool, semantic input, auth scope, provider action
2919
+ * version, and cache policy.
2918
2920
  *
2919
2921
  * @sdkReference runtime 160
2920
2922
  */
2921
2923
  type ToolExecutionRequest = {
2922
- /** Stable logical id for this tool call within the play. */
2924
+ /** Stable logical id for logs, metadata, and receipt attachment. */
2923
2925
  id: string;
2924
2926
  /** Current tool id from `deepline tools search` / `deepline tools describe`. */
2925
2927
  tool: string;
package/dist/index.js CHANGED
@@ -419,17 +419,19 @@ var SDK_RELEASE = {
419
419
  // the SDK enrich generator's one-second stale policy.
420
420
  // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
421
421
  // 0.1.111 ships dataset-native tool list getters and result row datasets.
422
- version: "0.1.154",
422
+ // 0.1.154 removes the short-lived generated enrich StepOptions recompute
423
+ // fields shipped in 0.1.153.
424
+ version: "0.1.156",
423
425
  apiContract: "2026-06-dataset-handle-results-hard-cutover",
424
426
  supportPolicy: {
425
- latest: "0.1.154",
427
+ latest: "0.1.156",
426
428
  minimumSupported: "0.1.53",
427
429
  deprecatedBelow: "0.1.53",
428
430
  commandMinimumSupported: [
429
431
  {
430
432
  command: "enrich",
431
- minimumSupported: "0.1.108",
432
- reason: "Older SDK CLI enrich generated stale play source for the current dataset API."
433
+ minimumSupported: "0.1.154",
434
+ reason: "Older SDK CLI enrich generated stale play source; SDK CLI enrich 0.1.153 generated removed StepOptions fields in play source."
433
435
  },
434
436
  {
435
437
  command: "plays",
package/dist/index.mjs CHANGED
@@ -349,17 +349,19 @@ var SDK_RELEASE = {
349
349
  // the SDK enrich generator's one-second stale policy.
350
350
  // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
351
351
  // 0.1.111 ships dataset-native tool list getters and result row datasets.
352
- version: "0.1.154",
352
+ // 0.1.154 removes the short-lived generated enrich StepOptions recompute
353
+ // fields shipped in 0.1.153.
354
+ version: "0.1.156",
353
355
  apiContract: "2026-06-dataset-handle-results-hard-cutover",
354
356
  supportPolicy: {
355
- latest: "0.1.154",
357
+ latest: "0.1.156",
356
358
  minimumSupported: "0.1.53",
357
359
  deprecatedBelow: "0.1.53",
358
360
  commandMinimumSupported: [
359
361
  {
360
362
  command: "enrich",
361
- minimumSupported: "0.1.108",
362
- reason: "Older SDK CLI enrich generated stale play source for the current dataset API."
363
+ minimumSupported: "0.1.154",
364
+ reason: "Older SDK CLI enrich generated stale play source; SDK CLI enrich 0.1.153 generated removed StepOptions fields in play source."
363
365
  },
364
366
  {
365
367
  command: "plays",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "deepline",
3
- "version": "0.1.154",
3
+ "version": "0.1.156",
4
4
  "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
5
5
  "license": "MIT",
6
6
  "repository": {