deepline 0.1.155 → 0.1.156

package/dist/bundling-sources/sdk/src/play.ts

@@ -281,12 +281,14 @@ export type { PreviousCell } from '../../shared_libs/play-runtime/cell-staleness
  * Keyword-style request object for `ctx.tools.execute(...)`.
  *
  * The `tool` value comes from live tool discovery. The `id` is the stable
- * logical call name inside this play and participates in replay/idempotency.
+ * logical call name used for logs, metadata, and receipt attachment. Provider
+ * call reuse is keyed by play, tool, semantic input, auth scope, provider action
+ * version, and cache policy.
  *
  * @sdkReference runtime 160
  */
 export type ToolExecutionRequest = {
-  /** Stable logical id for this tool call within the play. */
+  /** Stable logical id for logs, metadata, and receipt attachment. */
   id: string;
   /** Current tool id from `deepline tools search` / `deepline tools describe`. */
   tool: string;

package/dist/bundling-sources/sdk/src/release.ts

@@ -104,10 +104,10 @@ export const SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: '0.1.155',
+  version: '0.1.156',
   apiContract: '2026-06-dataset-handle-results-hard-cutover',
   supportPolicy: {
-    latest: '0.1.155',
+    latest: '0.1.156',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

package/dist/cli/index.js

@@ -657,10 +657,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.155",
+  version: "0.1.156",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.155",
+    latest: "0.1.156",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -9365,7 +9365,7 @@ async function traceCliSpan(phase, fields, run) {
 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.";
 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.";
 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.";
-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.";
+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.";
 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.";
 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.";
 function sourceLineForError(sourceCode, error) {
@@ -12840,7 +12840,7 @@ function writeStartedPlayRun(input2) {
   );
 }
 function parsePlayRunOptions(args) {
-  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.";
+  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.";
   let filePath = null;
   let playName = null;
   let input2 = null;
@@ -14696,10 +14696,15 @@ Notes:
   This command starts cloud work and may spend Deepline credits through tool calls.
 
 Idempotent execution:
-  Stable tool call ids are the reuse key:
+  Durable tool-call reuse is based on the actual external call identity:
+  same play, tool, semantic input, auth scope, provider action version, and
+  cache policy.
 
     await ctx.tools.execute({ id: 'company_lookup', tool, input });
 
+  The authored id is still required for readable logs, metadata, and receipt
+  attachment, but renaming it alone does not rebuy the same provider request.
+
   For rows, use ctx.dataset plus a stable row key:
 
     const rows = await ctx
@@ -14711,8 +14716,7 @@ Idempotent execution:
       }))
       .run({ key: 'domain' });
 
-  Reuse needs the same play, call id, semantic input, auth scope, and cache
-  policy. Dataset cells are storage; put freshness on the actual call:
+  Dataset cells are storage; put freshness on the actual call:
 
     await ctx.tools.execute({
       id: 'find_cto',

package/dist/cli/index.mjs

@@ -642,10 +642,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.155",
+  version: "0.1.156",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.155",
+    latest: "0.1.156",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -9388,7 +9388,7 @@ async function traceCliSpan(phase, fields, run) {
 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.";
 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.";
 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.";
-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.";
+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.";
 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.";
 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.";
 function sourceLineForError(sourceCode, error) {
@@ -12863,7 +12863,7 @@ function writeStartedPlayRun(input2) {
   );
 }
 function parsePlayRunOptions(args) {
-  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.";
+  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.";
   let filePath = null;
   let playName = null;
   let input2 = null;
@@ -14719,10 +14719,15 @@ Notes:
   This command starts cloud work and may spend Deepline credits through tool calls.
 
 Idempotent execution:
-  Stable tool call ids are the reuse key:
+  Durable tool-call reuse is based on the actual external call identity:
+  same play, tool, semantic input, auth scope, provider action version, and
+  cache policy.
 
     await ctx.tools.execute({ id: 'company_lookup', tool, input });
 
+  The authored id is still required for readable logs, metadata, and receipt
+  attachment, but renaming it alone does not rebuy the same provider request.
+
   For rows, use ctx.dataset plus a stable row key:
 
     const rows = await ctx
@@ -14734,8 +14739,7 @@ Idempotent execution:
       }))
       .run({ key: 'domain' });
 
-  Reuse needs the same play, call id, semantic input, auth scope, and cache
-  policy. Dataset cells are storage; put freshness on the actual call:
+  Dataset cells are storage; put freshness on the actual call:
 
     await ctx.tools.execute({
       id: 'find_cto',

package/dist/index.d.mts

@@ -2914,12 +2914,14 @@ type LoosePlayObject = {
  * Keyword-style request object for `ctx.tools.execute(...)`.
  *
  * The `tool` value comes from live tool discovery. The `id` is the stable
- * logical call name inside this play and participates in replay/idempotency.
+ * logical call name used for logs, metadata, and receipt attachment. Provider
+ * call reuse is keyed by play, tool, semantic input, auth scope, provider action
+ * version, and cache policy.
  *
  * @sdkReference runtime 160
  */
 type ToolExecutionRequest = {
-    /** Stable logical id for this tool call within the play. */
+    /** Stable logical id for logs, metadata, and receipt attachment. */
     id: string;
     /** Current tool id from `deepline tools search` / `deepline tools describe`. */
     tool: string;

package/dist/index.d.ts

@@ -2914,12 +2914,14 @@ type LoosePlayObject = {
  * Keyword-style request object for `ctx.tools.execute(...)`.
  *
  * The `tool` value comes from live tool discovery. The `id` is the stable
- * logical call name inside this play and participates in replay/idempotency.
+ * logical call name used for logs, metadata, and receipt attachment. Provider
+ * call reuse is keyed by play, tool, semantic input, auth scope, provider action
+ * version, and cache policy.
  *
  * @sdkReference runtime 160
  */
 type ToolExecutionRequest = {
-    /** Stable logical id for this tool call within the play. */
+    /** Stable logical id for logs, metadata, and receipt attachment. */
     id: string;
     /** Current tool id from `deepline tools search` / `deepline tools describe`. */
     tool: string;

package/dist/index.js

@@ -421,10 +421,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.155",
+  version: "0.1.156",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.155",
+    latest: "0.1.156",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/dist/index.mjs

@@ -351,10 +351,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.155",
+  version: "0.1.156",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.155",
+    latest: "0.1.156",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.155",
+  "version": "0.1.156",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {