deepline 0.2.74 → 0.3.1

package/dist/cli/index.js

@@ -185,7 +185,7 @@ function configureProxyFromEnv() {
 configureProxyFromEnv();
 
 // src/cli/index.ts
-var import_promises9 = require("fs/promises");
+var import_promises10 = require("fs/promises");
 var import_node_path26 = require("path");
 var import_node_os19 = require("os");
 var import_commander4 = require("commander");
@@ -1044,7 +1044,11 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.74",
+  // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
+  // available at toolResponse.rawV2 while toolResponse.raw and all declared
+  // getters keep their established compatibility behavior.
+  version: "0.3.1",
+  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.",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3759,12 +3763,33 @@ function normalizePlayRuntimeEnvironment(value) {
   return typeof value === "string" && PLAY_RUNTIME_ENVIRONMENTS.includes(value) ? value : null;
 }
 
+// ../shared_libs/play-runtime/tool-response-contract.ts
+var RAW_V2_TOOL_RESPONSE_CONTRACT = "raw-v2";
+function legacyRawFromToolResponseRawV2(rawV2, view, responseMeta) {
+  const legacyRaw = view === "data" && rawV2 && typeof rawV2 === "object" && !Array.isArray(rawV2) ? rawV2.data : rawV2;
+  const deeplineBilling = responseMeta?.deepline_billing;
+  if (view === "rawV2" && deeplineBilling !== void 0 && legacyRaw && typeof legacyRaw === "object" && !Array.isArray(legacyRaw)) {
+    return {
+      ...legacyRaw,
+      deepline_billing: deeplineBilling
+    };
+  }
+  return legacyRaw;
+}
+function providerMetaFromToolResponseRawV2(rawV2, view) {
+  if (view !== "data" || !rawV2 || typeof rawV2 !== "object" || Array.isArray(rawV2)) {
+    return void 0;
+  }
+  const meta = rawV2.meta;
+  return meta && typeof meta === "object" && !Array.isArray(meta) ? meta : void 0;
+}
+
 // src/client.ts
 var TERMINAL_PLAY_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
 var INCLUDE_TOOL_METADATA_HEADER = "x-deepline-include-tool-metadata";
 var EXECUTE_RESPONSE_CONTRACT_HEADER = "x-deepline-execute-response-contract";
 var EXECUTE_RESPONSE_INTENT_HEADER = "x-deepline-execute-response-intent";
-var V2_EXECUTE_RESPONSE_CONTRACT = "v2-tool-response";
+var RAW_V2_EXECUTE_RESPONSE_CONTRACT = RAW_V2_TOOL_RESPONSE_CONTRACT;
 var COMPILE_MANIFEST_RETRY_DELAYS_MS = [250, 1e3];
 var REGISTER_PLAY_ARTIFACTS_COMPILE_CONCURRENCY = 3;
 var REGISTER_PLAY_ARTIFACTS_MAX_BATCH_COUNT = 3;
@@ -3979,6 +4004,50 @@ function requireTargetBillingIdempotencyKey(value) {
 function isRecord7(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
+function materializeToolExecutionResponse(response) {
+  const toolResponse = response.toolResponse;
+  if (!toolResponse && isRecord7(response.result)) {
+    const legacyResult = response.result;
+    if (Object.prototype.hasOwnProperty.call(legacyResult, "data")) {
+      const legacyMeta = isRecord7(legacyResult.meta) ? legacyResult.meta : void 0;
+      return {
+        ...response,
+        toolResponse: {
+          raw: legacyResult.data,
+          ...legacyMeta ? { meta: legacyMeta } : {}
+        }
+      };
+    }
+  }
+  if (!toolResponse || Object.prototype.hasOwnProperty.call(toolResponse, "raw")) {
+    return response;
+  }
+  const rawV2 = toolResponse.rawV2;
+  const view = toolResponse.view;
+  const providerMeta = providerMetaFromToolResponseRawV2(
+    rawV2,
+    view ?? "rawV2"
+  );
+  const responseMeta = isRecord7(toolResponse.responseMeta) ? toolResponse.responseMeta : void 0;
+  return {
+    ...response,
+    toolResponse: {
+      ...toolResponse,
+      raw: legacyRawFromToolResponseRawV2(
+        rawV2,
+        view ?? "rawV2",
+        responseMeta
+      ),
+      ...toolResponse.meta || providerMeta || responseMeta ? {
+        meta: {
+          ...toolResponse.meta ?? {},
+          ...providerMeta ?? {},
+          ...responseMeta ?? {}
+        }
+      } : {}
+    }
+  };
+}
 function isPrebuiltPlayDescription(play) {
   return play.origin === "prebuilt" || play.ownerType === "deepline";
 }
@@ -4528,14 +4597,14 @@ var DeeplineClient = class {
    */
   async executeTool(toolId, input2, options) {
     const headers = {
-      [EXECUTE_RESPONSE_CONTRACT_HEADER]: V2_EXECUTE_RESPONSE_CONTRACT,
+      [EXECUTE_RESPONSE_CONTRACT_HEADER]: RAW_V2_EXECUTE_RESPONSE_CONTRACT,
       [TOOL_EXECUTION_ERROR_SCHEMA_HEADER]: String(
         TOOL_EXECUTION_ERROR_SCHEMA_VERSION
       ),
       ...options?.includeToolMetadata ? { [INCLUDE_TOOL_METADATA_HEADER]: "true" } : {},
       [EXECUTE_RESPONSE_INTENT_HEADER]: options?.responseIntent ?? "raw"
     };
-    return this.http.post(
+    const response = await this.http.post(
       `/api/v2/integrations/${encodeURIComponent(toolId)}/execute`,
       {
         payload: input2,
@@ -4549,6 +4618,7 @@ var DeeplineClient = class {
         toolId
       }
     );
+    return materializeToolExecutionResponse(response);
   }
   /**
    * Back-compatible alias for {@link executeTool}.
@@ -10998,7 +11068,7 @@ Examples:
 }
 
 // src/cli/commands/enrich.ts
-var import_promises6 = require("fs/promises");
+var import_promises7 = require("fs/promises");
 var import_node_os10 = require("os");
 var import_node_path15 = require("path");
 var import_commander2 = require("commander");
@@ -11006,7 +11076,7 @@ var import_commander2 = require("commander");
 // src/cli/commands/play.ts
 var import_node_crypto6 = require("crypto");
 var import_node_fs12 = require("fs");
-var import_promises5 = require("fs/promises");
+var import_promises6 = require("fs/promises");
 var import_node_path14 = require("path");
 var import_sync5 = require("csv-parse/sync");
 
@@ -12714,6 +12784,7 @@ var import_node_os9 = require("os");
 var import_node_path13 = require("path");
 var import_node_url = require("url");
 var import_node_fs11 = require("fs");
+var import_promises5 = require("fs/promises");
 
 // ../shared_libs/plays/bundling/index.ts
 var import_node_crypto4 = require("crypto");
@@ -18244,7 +18315,7 @@ var PLAY_RUN_RESERVED_BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
 ]);
 async function pathExistsIncludingSymlink(path) {
   try {
-    await (0, import_promises5.lstat)(path);
+    await (0, import_promises6.lstat)(path);
     return true;
   } catch (error) {
     if (error.code === "ENOENT") {
@@ -18261,7 +18332,7 @@ function runIdFileTempPath(destination) {
 }
 async function removeRunIdTempFile(path) {
   try {
-    await (0, import_promises5.unlink)(path);
+    await (0, import_promises6.unlink)(path);
   } catch (error) {
     if (error.code !== "ENOENT") {
       throw error;
@@ -18278,7 +18349,7 @@ async function preflightRunIdFile(path) {
   const tempPath = runIdFileTempPath(destination);
   let handle = null;
   try {
-    handle = await (0, import_promises5.open)(tempPath, "wx", 384);
+    handle = await (0, import_promises6.open)(tempPath, "wx", 384);
     await handle.sync();
   } catch (error) {
     throw new Error(
@@ -18296,7 +18367,7 @@ async function readRunIdFile(destination) {
   }
   let parsed;
   try {
-    parsed = JSON.parse(await (0, import_promises5.readFile)(destination, "utf8"));
+    parsed = JSON.parse(await (0, import_promises6.readFile)(destination, "utf8"));
   } catch (error) {
     throw new Error(
       `--run-id-file destination contains invalid JSON: ${destination}. Refusing to overwrite it (${error instanceof Error ? error.message : String(error)}).`
@@ -18320,7 +18391,7 @@ async function writePlayRunIdFile(destination, runId) {
   const tempPath = runIdFileTempPath(destination);
   let handle = null;
   try {
-    handle = await (0, import_promises5.open)(tempPath, "wx", 384);
+    handle = await (0, import_promises6.open)(tempPath, "wx", 384);
     await handle.writeFile(
       `${JSON.stringify({ version: 1, runId })}
 `,
@@ -18330,8 +18401,8 @@ async function writePlayRunIdFile(destination, runId) {
     await handle.close();
     handle = null;
     try {
-      await (0, import_promises5.link)(tempPath, destination);
-      const directory = await (0, import_promises5.open)((0, import_node_path14.dirname)(destination), "r");
+      await (0, import_promises6.link)(tempPath, destination);
+      const directory = await (0, import_promises6.open)((0, import_node_path14.dirname)(destination), "r");
       try {
         await directory.sync();
       } finally {
@@ -27623,6 +27694,7 @@ var ENRICH_DEBUG_T0 = Date.now();
 var GENERATED_ENRICH_ROWS_TABLE_NAMESPACE = "deepline_enrich_rows";
 var SDK_ENRICH_TELEMETRY_TIMEOUT_MS = 1e4;
 var SDK_ENRICH_TELEMETRY_COMMAND_MAX_LENGTH = 2e4;
+var ENRICH_DEPRECATION_NOTICE = "DEPRECATION: `deepline enrich` is deprecated and no longer actively maintained. Use `deepline plays` for the supported workflow.\n";
 var ENRICH_AI_RUNTIME_COMPACT_TOOLS = /* @__PURE__ */ new Set([
   "ai_inference",
   "aiinference",
@@ -27796,7 +27868,7 @@ async function readAtFileReference(value, argumentName, strip = true) {
     throw new Error(`Invalid ${argumentName} value: empty @file path.`);
   }
   try {
-    const text = await (0, import_promises6.readFile)(filePath, "utf8");
+    const text = await (0, import_promises7.readFile)(filePath, "utf8");
     const normalized = text.replace(/^\uFEFF/, "");
     return strip ? normalized.trim() : normalized;
   } catch (error) {
@@ -28094,7 +28166,7 @@ async function buildPlanArgs(args) {
 async function assertInputCsvExists(inputCsv) {
   const path = (0, import_node_path15.resolve)(inputCsv);
   try {
-    const info = await (0, import_promises6.stat)(path);
+    const info = await (0, import_promises7.stat)(path);
     if (info.isFile()) {
       return;
     }
@@ -28115,8 +28187,8 @@ async function assertSafeOutputPath(inputCsv, outputPath) {
   }
   try {
     const [inputInfo, outputInfo] = await Promise.all([
-      (0, import_promises6.stat)(input2),
-      (0, import_promises6.stat)(output2)
+      (0, import_promises7.stat)(input2),
+      (0, import_promises7.stat)(output2)
     ]);
     if (inputInfo.dev === outputInfo.dev && inputInfo.ino === outputInfo.ino) {
       throw new Error(
@@ -28136,7 +28208,7 @@ async function assertSafeOutputPath(inputCsv, outputPath) {
 }
 async function regularFileExists(path) {
   try {
-    const info = await (0, import_promises6.stat)((0, import_node_path15.resolve)(path));
+    const info = await (0, import_promises7.stat)((0, import_node_path15.resolve)(path));
     return info.isFile();
   } catch (error) {
     const code = error && typeof error === "object" ? error.code : void 0;
@@ -28147,7 +28219,7 @@ async function regularFileExists(path) {
   }
 }
 async function readConfig(path) {
-  const source = await (0, import_promises6.readFile)((0, import_node_path15.resolve)(path), "utf8");
+  const source = await (0, import_promises7.readFile)((0, import_node_path15.resolve)(path), "utf8");
   let parsed;
   try {
     parsed = JSON.parse(source);
@@ -28568,7 +28640,7 @@ async function writeOutputCsv(outputPath, status, options) {
     ]),
     options?.config
   );
-  await (0, import_promises6.writeFile)(
+  await (0, import_promises7.writeFile)(
     (0, import_node_path15.resolve)(outputPath),
     csvStringFromRows(merged.rows, columns),
     "utf8"
@@ -30248,7 +30320,7 @@ async function persistEnrichFailureReport(input2) {
   }
   const stateDir = (0, import_node_path15.join)((0, import_node_os10.homedir)(), ".local", "deepline", "runtime", "state");
   const reportPrefix = input2.jobs.length > 0 ? "run-block-failures" : "enrich-issues";
-  await (0, import_promises6.mkdir)(stateDir, { recursive: true });
+  await (0, import_promises7.mkdir)(stateDir, { recursive: true });
   const reportPath = (0, import_node_path15.join)(
     stateDir,
     `${reportPrefix}-${Math.floor(Date.now() / 1e3)}-${process.pid}.json`
@@ -30274,7 +30346,7 @@ async function persistEnrichFailureReport(input2) {
   if (input2.rows.rowStart !== null && input2.rows.rowEnd !== null) {
     report.rows = { start: input2.rows.rowStart, end: input2.rows.rowEnd };
   }
-  await (0, import_promises6.writeFile)(reportPath, `${JSON.stringify(report, null, 2)}
+  await (0, import_promises7.writeFile)(reportPath, `${JSON.stringify(report, null, 2)}
 `, "utf8");
   return reportPath;
 }
@@ -31092,6 +31164,7 @@ function registerEnrichCommand(program) {
     "--max-credits-per-run <credits>",
     "Set a hard Deepline-credit ceiling enforced by the runtime for this run."
   ).action(async (options, _command) => {
+    process.stderr.write(ENRICH_DEPRECATION_NOTICE);
     if (currentEnrichArgs().some(
       (arg) => arg === "--no-open" || arg.startsWith("--no-open=")
     )) {
@@ -31177,13 +31250,13 @@ function registerEnrichCommand(program) {
       sdkEnrichTelemetryCompleted = true;
       await completeSdkEnrichTelemetry(sdkEnrichTelemetry, input2);
     };
-    const tempDir = await (0, import_promises6.mkdtemp)((0, import_node_path15.join)((0, import_node_os10.tmpdir)(), "deepline-enrich-play-"));
+    const tempDir = await (0, import_promises7.mkdtemp)((0, import_node_path15.join)((0, import_node_os10.tmpdir)(), "deepline-enrich-play-"));
     await emitSdkEnrichTelemetry(sdkEnrichTelemetry, "enrich_started");
     const tempPlay = (0, import_node_path15.join)(tempDir, "deepline-enrich.play.ts");
     let inPlaceTempDir = null;
     let inPlaceTempOutputPath = null;
     const inPlaceFinalOutputPath = options.inPlace ? (0, import_node_path15.resolve)(inputCsv) : null;
-    const inPlaceCommitOutputPath = options.inPlace ? (await (0, import_promises6.lstat)(inputCsv)).isSymbolicLink() ? await (0, import_promises6.realpath)(inputCsv) : inPlaceFinalOutputPath : null;
+    const inPlaceCommitOutputPath = options.inPlace ? (await (0, import_promises7.lstat)(inputCsv)).isSymbolicLink() ? await (0, import_promises7.realpath)(inputCsv) : inPlaceFinalOutputPath : null;
     const failureReportOutputPath = options.inPlace ? inPlaceFinalOutputPath : null;
     const enrichIssueFollowUpOutputPath = options.inPlace && inPlaceFinalOutputPath ? sidecarEnrichRowsExportPath(inPlaceFinalOutputPath) : null;
     let activeRunId2 = null;
@@ -31204,16 +31277,16 @@ function registerEnrichCommand(program) {
         return;
       }
       if (inPlaceTempDir) {
-        await (0, import_promises6.rm)(inPlaceTempDir, { recursive: true, force: true });
+        await (0, import_promises7.rm)(inPlaceTempDir, { recursive: true, force: true });
       }
-      inPlaceTempDir = await (0, import_promises6.mkdtemp)(
+      inPlaceTempDir = await (0, import_promises7.mkdtemp)(
         (0, import_node_path15.join)(
           (0, import_node_path15.dirname)(inPlaceCommitOutputPath ?? (0, import_node_path15.resolve)(inputCsv)),
           ".deepline-enrich-in-place-"
         )
       );
       inPlaceTempOutputPath = (0, import_node_path15.join)(inPlaceTempDir, "output.csv");
-      await (0, import_promises6.copyFile)((0, import_node_path15.resolve)(inputCsv), inPlaceTempOutputPath);
+      await (0, import_promises7.copyFile)((0, import_node_path15.resolve)(inputCsv), inPlaceTempOutputPath);
       outputPath = inPlaceTempOutputPath;
     };
     const commitInPlaceOutput = async (exportResult) => {
@@ -31221,12 +31294,12 @@ function registerEnrichCommand(program) {
         return exportResult;
       }
       const committedTempDir = inPlaceTempDir;
-      await (0, import_promises6.rename)(inPlaceTempOutputPath, inPlaceCommitOutputPath);
+      await (0, import_promises7.rename)(inPlaceTempOutputPath, inPlaceCommitOutputPath);
       inPlaceTempDir = null;
       inPlaceTempOutputPath = null;
       outputPath = inPlaceFinalOutputPath;
       if (committedTempDir) {
-        await (0, import_promises6.rm)(committedTempDir, { recursive: true, force: true });
+        await (0, import_promises7.rm)(committedTempDir, { recursive: true, force: true });
       }
       if (!exportResult) {
         return null;
@@ -31239,7 +31312,7 @@ function registerEnrichCommand(program) {
     try {
       process.once("SIGINT", onSigint);
       process.once("SIGTERM", onSigterm);
-      await (0, import_promises6.writeFile)(tempPlay, playSource, "utf8");
+      await (0, import_promises7.writeFile)(tempPlay, playSource, "utf8");
       if (options.inPlace) {
         await prepareInPlaceOutput();
       }
@@ -31433,11 +31506,11 @@ function registerEnrichCommand(program) {
       process.removeListener("SIGINT", onSigint);
       process.removeListener("SIGTERM", onSigterm);
       if (inPlaceTempDir) {
-        await (0, import_promises6.rm)(inPlaceTempDir, { recursive: true, force: true });
+        await (0, import_promises7.rm)(inPlaceTempDir, { recursive: true, force: true });
       } else if (inPlaceTempOutputPath) {
-        await (0, import_promises6.rm)(inPlaceTempOutputPath, { force: true });
+        await (0, import_promises7.rm)(inPlaceTempOutputPath, { force: true });
       }
-      await (0, import_promises6.rm)(tempDir, { recursive: true, force: true });
+      await (0, import_promises7.rm)(tempDir, { recursive: true, force: true });
     }
   });
 }
@@ -32329,7 +32402,7 @@ Examples:
 
 // src/cli/commands/monitors.ts
 var import_node_fs14 = require("fs");
-var import_promises7 = require("readline/promises");
+var import_promises8 = require("readline/promises");
 var JSON_OPTION_DESCRIPTION = "Emit JSON output. Also automatic when stdout is piped";
 function withJsonOption(command) {
   return command.option("--json", JSON_OPTION_DESCRIPTION);
@@ -33098,7 +33171,7 @@ async function handleMonitorsValidate(key, options) {
   if (result.valid === false) process.exitCode = 7;
 }
 async function confirmMonitorDelete(key, options) {
-  const rl = (0, import_promises7.createInterface)({
+  const rl = (0, import_promises8.createInterface)({
     input: process.stdin,
     output: process.stderr
   });
@@ -40115,7 +40188,7 @@ Examples:
 }
 
 // src/cli/commands/workflow.ts
-var import_promises8 = require("fs/promises");
+var import_promises9 = require("fs/promises");
 var import_node_path24 = require("path");
 
 // src/cli/workflow-to-play.ts
@@ -40333,7 +40406,7 @@ function readStatus(payload) {
 }
 async function readJsonOption(payload, file) {
   if (file) {
-    const raw = await (0, import_promises8.readFile)((0, import_node_path24.resolve)(file), "utf8");
+    const raw = await (0, import_promises9.readFile)((0, import_node_path24.resolve)(file), "utf8");
     return JSON.parse(raw);
   }
   if (payload) {
@@ -40368,8 +40441,8 @@ async function transformOne(api, workflowId, outDir, publish) {
       { workflowName: workflow.name, version: revision.version }
     );
     const file = (0, import_node_path24.join)((0, import_node_path24.resolve)(outDir), `${compiled.playName}.play.ts`);
-    await (0, import_promises8.mkdir)((0, import_node_path24.dirname)(file), { recursive: true });
-    await (0, import_promises8.writeFile)(file, compiled.sourceCode, "utf8");
+    await (0, import_promises9.mkdir)((0, import_node_path24.dirname)(file), { recursive: true });
+    await (0, import_promises9.writeFile)(file, compiled.sourceCode, "utf8");
     let published = false;
     if (publish) {
       const code = await handlePlayPublish([file]);
@@ -40754,9 +40827,7 @@ function shouldSkipSelfUpdate() {
 function parseSemver(version) {
   const trimmed = version?.trim();
   if (!trimmed) return null;
-  const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(
-    trimmed
-  );
+  const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(trimmed);
   if (!match) return null;
   return {
     major: Number(match[1]),
@@ -40847,7 +40918,12 @@ async function maybeAutoUpdateAndRelaunch(response) {
     );
     return false;
   }
-  process.stderr.write("Deepline SDK/CLI updated; rerunning command.\n");
+  const updateSummary = response.update_summary ? `
+What changed in ${response.update_summary.version}: ${response.update_summary.summary}` : "";
+  process.stderr.write(
+    `Deepline SDK/CLI updated; rerunning command.${updateSummary}
+`
+  );
   const exitCode = await relaunchCurrentCommand(plan);
   process.exit(exitCode);
   return true;
@@ -41500,10 +41576,10 @@ function topLevelCommandKnown(program, commandName) {
   );
 }
 async function runPlayRunnerHealthCheck() {
-  const dir = await (0, import_promises9.mkdtemp)((0, import_node_path26.join)((0, import_node_os19.tmpdir)(), "deepline-health-play-"));
+  const dir = await (0, import_promises10.mkdtemp)((0, import_node_path26.join)((0, import_node_os19.tmpdir)(), "deepline-health-play-"));
   const file = (0, import_node_path26.join)(dir, "health-check.play.ts");
   try {
-    await (0, import_promises9.writeFile)(
+    await (0, import_promises10.writeFile)(
       file,
       [
         "import { definePlay } from 'deepline';",
@@ -41552,7 +41628,7 @@ async function runPlayRunnerHealthCheck() {
       }
     };
   } finally {
-    await (0, import_promises9.rm)(dir, { recursive: true, force: true });
+    await (0, import_promises10.rm)(dir, { recursive: true, force: true });
   }
 }
 function pickString(value, ...keys) {

package/dist/cli/index.mjs

@@ -1030,7 +1030,11 @@ var SDK_RELEASE = {
   // 0.2.0 makes Dataset Handles uniformly async-only after 0.1.320 briefly
   // exposed storage-dependent synchronous access. This deliberate minor
   // release keeps lazy paging semantics independent of row residency.
-  version: "0.2.74",
+  // 0.3.0 introduces raw-v2: complete scrubbed provider responses are
+  // available at toolResponse.rawV2 while toolResponse.raw and all declared
+  // getters keep their established compatibility behavior.
+  version: "0.3.1",
+  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.",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -3745,12 +3749,33 @@ function normalizePlayRuntimeEnvironment(value) {
   return typeof value === "string" && PLAY_RUNTIME_ENVIRONMENTS.includes(value) ? value : null;
 }
 
+// ../shared_libs/play-runtime/tool-response-contract.ts
+var RAW_V2_TOOL_RESPONSE_CONTRACT = "raw-v2";
+function legacyRawFromToolResponseRawV2(rawV2, view, responseMeta) {
+  const legacyRaw = view === "data" && rawV2 && typeof rawV2 === "object" && !Array.isArray(rawV2) ? rawV2.data : rawV2;
+  const deeplineBilling = responseMeta?.deepline_billing;
+  if (view === "rawV2" && deeplineBilling !== void 0 && legacyRaw && typeof legacyRaw === "object" && !Array.isArray(legacyRaw)) {
+    return {
+      ...legacyRaw,
+      deepline_billing: deeplineBilling
+    };
+  }
+  return legacyRaw;
+}
+function providerMetaFromToolResponseRawV2(rawV2, view) {
+  if (view !== "data" || !rawV2 || typeof rawV2 !== "object" || Array.isArray(rawV2)) {
+    return void 0;
+  }
+  const meta = rawV2.meta;
+  return meta && typeof meta === "object" && !Array.isArray(meta) ? meta : void 0;
+}
+
 // src/client.ts
 var TERMINAL_PLAY_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "cancelled"]);
 var INCLUDE_TOOL_METADATA_HEADER = "x-deepline-include-tool-metadata";
 var EXECUTE_RESPONSE_CONTRACT_HEADER = "x-deepline-execute-response-contract";
 var EXECUTE_RESPONSE_INTENT_HEADER = "x-deepline-execute-response-intent";
-var V2_EXECUTE_RESPONSE_CONTRACT = "v2-tool-response";
+var RAW_V2_EXECUTE_RESPONSE_CONTRACT = RAW_V2_TOOL_RESPONSE_CONTRACT;
 var COMPILE_MANIFEST_RETRY_DELAYS_MS = [250, 1e3];
 var REGISTER_PLAY_ARTIFACTS_COMPILE_CONCURRENCY = 3;
 var REGISTER_PLAY_ARTIFACTS_MAX_BATCH_COUNT = 3;
@@ -3965,6 +3990,50 @@ function requireTargetBillingIdempotencyKey(value) {
 function isRecord7(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
+function materializeToolExecutionResponse(response) {
+  const toolResponse = response.toolResponse;
+  if (!toolResponse && isRecord7(response.result)) {
+    const legacyResult = response.result;
+    if (Object.prototype.hasOwnProperty.call(legacyResult, "data")) {
+      const legacyMeta = isRecord7(legacyResult.meta) ? legacyResult.meta : void 0;
+      return {
+        ...response,
+        toolResponse: {
+          raw: legacyResult.data,
+          ...legacyMeta ? { meta: legacyMeta } : {}
+        }
+      };
+    }
+  }
+  if (!toolResponse || Object.prototype.hasOwnProperty.call(toolResponse, "raw")) {
+    return response;
+  }
+  const rawV2 = toolResponse.rawV2;
+  const view = toolResponse.view;
+  const providerMeta = providerMetaFromToolResponseRawV2(
+    rawV2,
+    view ?? "rawV2"
+  );
+  const responseMeta = isRecord7(toolResponse.responseMeta) ? toolResponse.responseMeta : void 0;
+  return {
+    ...response,
+    toolResponse: {
+      ...toolResponse,
+      raw: legacyRawFromToolResponseRawV2(
+        rawV2,
+        view ?? "rawV2",
+        responseMeta
+      ),
+      ...toolResponse.meta || providerMeta || responseMeta ? {
+        meta: {
+          ...toolResponse.meta ?? {},
+          ...providerMeta ?? {},
+          ...responseMeta ?? {}
+        }
+      } : {}
+    }
+  };
+}
 function isPrebuiltPlayDescription(play) {
   return play.origin === "prebuilt" || play.ownerType === "deepline";
 }
@@ -4514,14 +4583,14 @@ var DeeplineClient = class {
    */
   async executeTool(toolId, input2, options) {
     const headers = {
-      [EXECUTE_RESPONSE_CONTRACT_HEADER]: V2_EXECUTE_RESPONSE_CONTRACT,
+      [EXECUTE_RESPONSE_CONTRACT_HEADER]: RAW_V2_EXECUTE_RESPONSE_CONTRACT,
       [TOOL_EXECUTION_ERROR_SCHEMA_HEADER]: String(
         TOOL_EXECUTION_ERROR_SCHEMA_VERSION
       ),
       ...options?.includeToolMetadata ? { [INCLUDE_TOOL_METADATA_HEADER]: "true" } : {},
       [EXECUTE_RESPONSE_INTENT_HEADER]: options?.responseIntent ?? "raw"
     };
-    return this.http.post(
+    const response = await this.http.post(
       `/api/v2/integrations/${encodeURIComponent(toolId)}/execute`,
       {
         payload: input2,
@@ -4535,6 +4604,7 @@ var DeeplineClient = class {
         toolId
       }
     );
+    return materializeToolExecutionResponse(response);
   }
   /**
    * Back-compatible alias for {@link executeTool}.
@@ -11010,7 +11080,7 @@ import {
   mkdir as mkdir4,
   mkdtemp,
   readFile as readFile3,
-  realpath as realpath2,
+  realpath as realpath3,
   rename,
   rm,
   stat as stat3,
@@ -12758,6 +12828,7 @@ import { tmpdir as tmpdir3 } from "os";
 import { dirname as dirname8, join as join9, resolve as resolve10 } from "path";
 import { fileURLToPath } from "url";
 import { existsSync as existsSync8 } from "fs";
+import { realpath as realpath2 } from "fs/promises";
 
 // ../shared_libs/plays/bundling/index.ts
 import { createHash as createHash2 } from "crypto";
@@ -27683,6 +27754,7 @@ var ENRICH_DEBUG_T0 = Date.now();
 var GENERATED_ENRICH_ROWS_TABLE_NAMESPACE = "deepline_enrich_rows";
 var SDK_ENRICH_TELEMETRY_TIMEOUT_MS = 1e4;
 var SDK_ENRICH_TELEMETRY_COMMAND_MAX_LENGTH = 2e4;
+var ENRICH_DEPRECATION_NOTICE = "DEPRECATION: `deepline enrich` is deprecated and no longer actively maintained. Use `deepline plays` for the supported workflow.\n";
 var ENRICH_AI_RUNTIME_COMPACT_TOOLS = /* @__PURE__ */ new Set([
   "ai_inference",
   "aiinference",
@@ -31152,6 +31224,7 @@ function registerEnrichCommand(program) {
     "--max-credits-per-run <credits>",
     "Set a hard Deepline-credit ceiling enforced by the runtime for this run."
   ).action(async (options, _command) => {
+    process.stderr.write(ENRICH_DEPRECATION_NOTICE);
     if (currentEnrichArgs().some(
       (arg) => arg === "--no-open" || arg.startsWith("--no-open=")
     )) {
@@ -31243,7 +31316,7 @@ function registerEnrichCommand(program) {
     let inPlaceTempDir = null;
     let inPlaceTempOutputPath = null;
     const inPlaceFinalOutputPath = options.inPlace ? resolve12(inputCsv) : null;
-    const inPlaceCommitOutputPath = options.inPlace ? (await lstat2(inputCsv)).isSymbolicLink() ? await realpath2(inputCsv) : inPlaceFinalOutputPath : null;
+    const inPlaceCommitOutputPath = options.inPlace ? (await lstat2(inputCsv)).isSymbolicLink() ? await realpath3(inputCsv) : inPlaceFinalOutputPath : null;
     const failureReportOutputPath = options.inPlace ? inPlaceFinalOutputPath : null;
     const enrichIssueFollowUpOutputPath = options.inPlace && inPlaceFinalOutputPath ? sidecarEnrichRowsExportPath(inPlaceFinalOutputPath) : null;
     let activeRunId2 = null;
@@ -40850,9 +40923,7 @@ function shouldSkipSelfUpdate() {
 function parseSemver(version) {
   const trimmed = version?.trim();
   if (!trimmed) return null;
-  const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(
-    trimmed
-  );
+  const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(trimmed);
   if (!match) return null;
   return {
     major: Number(match[1]),
@@ -40943,7 +41014,12 @@ async function maybeAutoUpdateAndRelaunch(response) {
     );
     return false;
   }
-  process.stderr.write("Deepline SDK/CLI updated; rerunning command.\n");
+  const updateSummary = response.update_summary ? `
+What changed in ${response.update_summary.version}: ${response.update_summary.summary}` : "";
+  process.stderr.write(
+    `Deepline SDK/CLI updated; rerunning command.${updateSummary}
+`
+  );
   const exitCode = await relaunchCurrentCommand(plan);
   process.exit(exitCode);
   return true;

package/dist/{compiler-manifest-DFuz9-0_.d.mts → compiler-manifest-BX85pKXW.d.mts}

@@ -724,6 +724,10 @@ type ToolResultListAccessor<T = Record<string, unknown>, TKey extends string = s
 };
 type ToolResponseEnvelope<TData = unknown, TMeta = Record<string, unknown>> = {
     raw: TData;
+    /** Complete parsed and scrubbed provider response, materialized from raw-v2. */
+    rawV2?: unknown;
+    /** Durable descriptor for deriving the legacy raw view from `rawV2`. */
+    view?: 'data' | 'rawV2';
     meta?: TMeta;
 };
 type ToolExecuteResultBase<TResult = unknown, TMeta = Record<string, unknown>> = {
@@ -765,8 +769,9 @@ type ToolExecuteResultAccessors<TExtracted extends Record<string, unknown> = Par
  * Canonical result returned by Deepline tool execution.
  *
  * The top-level object is Deepline-owned execution metadata and semantic
- * extraction state. Raw tool/provider data lives under `toolResponse.raw`;
- * response metadata lives under `toolResponse.meta`. Semantic single-value
+ * extraction state. The canonical provider response lives under
+ * `toolResponse.rawV2`; `toolResponse.raw` remains the legacy compatibility
+ * projection. Response metadata lives under `toolResponse.meta`. Semantic single-value
  * getters live under `extractedValues.<name>.get()`, and list getters live
  * under `extractedLists.<name>.get()`.
  *