deepline 0.2.74 → 0.3.1

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

@@ -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()`.
  *

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-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-DFuz9-0_.mjs';
-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-DFuz9-0_.mjs';
+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';
+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';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -338,12 +338,19 @@ interface ToolDefinition {
                 expression?: string;
                 meaning?: string;
             };
+            canonicalToolResponse?: {
+                expression?: string;
+                meaning?: string;
+            };
             invalidGetterHint?: string;
         };
         toolExecutionResult?: {
             type?: 'ToolExecutionResult';
             toolResponse?: {
                 raw?: string;
+                rawV2?: string;
+                view?: string;
+                responseMeta?: string;
                 meta?: string;
             };
             meta?: string;
@@ -1948,7 +1955,8 @@ type ExecuteToolRawOptions = {
 /**
  * Standard provider/tool execution envelope returned by low-level SDK calls.
  *
- * `toolResponse.raw` contains the provider result. `extractedValues` and
+ * `toolResponse.rawV2` contains the complete scrubbed provider response;
+ * `toolResponse.raw` is derived locally as the legacy provider-result projection. `extractedValues` and
  * `extractedLists` contain Deepline-normalized getters when the tool exposes
  * them. Billing fields are Deepline-facing and must not expose provider spend.
  */
@@ -1958,7 +1966,10 @@ type ToolExecution<TData = unknown, TMeta = Record<string, unknown>> = {
     meta?: Record<string, unknown>;
     toolResponse: {
         raw: TData;
+        rawV2?: unknown;
+        view?: 'data' | 'rawV2';
         meta?: TMeta;
+        responseMeta?: TMeta;
     };
     extractedLists?: Record<string, unknown>;
     extractedValues?: Record<string, unknown>;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-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-DFuz9-0_.js';
-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-DFuz9-0_.js';
+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';
+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';
 import '@sinclair/typebox';
 
 declare const FIXTURE_BEHAVIOR_VERSION: 1;
@@ -338,12 +338,19 @@ interface ToolDefinition {
                 expression?: string;
                 meaning?: string;
             };
+            canonicalToolResponse?: {
+                expression?: string;
+                meaning?: string;
+            };
             invalidGetterHint?: string;
         };
         toolExecutionResult?: {
             type?: 'ToolExecutionResult';
             toolResponse?: {
                 raw?: string;
+                rawV2?: string;
+                view?: string;
+                responseMeta?: string;
                 meta?: string;
             };
             meta?: string;
@@ -1948,7 +1955,8 @@ type ExecuteToolRawOptions = {
 /**
  * Standard provider/tool execution envelope returned by low-level SDK calls.
  *
- * `toolResponse.raw` contains the provider result. `extractedValues` and
+ * `toolResponse.rawV2` contains the complete scrubbed provider response;
+ * `toolResponse.raw` is derived locally as the legacy provider-result projection. `extractedValues` and
  * `extractedLists` contain Deepline-normalized getters when the tool exposes
  * them. Billing fields are Deepline-facing and must not expose provider spend.
  */
@@ -1958,7 +1966,10 @@ type ToolExecution<TData = unknown, TMeta = Record<string, unknown>> = {
     meta?: Record<string, unknown>;
     toolResponse: {
         raw: TData;
+        rawV2?: unknown;
+        view?: 'data' | 'rawV2';
         meta?: TMeta;
+        responseMeta?: TMeta;
     };
     extractedLists?: Record<string, unknown>;
     extractedValues?: Record<string, unknown>;

package/dist/index.js

@@ -780,7 +780,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",
@@ -3495,12 +3499,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;
@@ -3715,6 +3740,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";
 }
@@ -4264,14 +4333,14 @@ var DeeplineClient = class {
    */
   async executeTool(toolId, input, 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: input,
@@ -4285,6 +4354,7 @@ var DeeplineClient = class {
         toolId
       }
     );
+    return materializeToolExecutionResponse(response);
   }
   /**
    * Back-compatible alias for {@link executeTool}.
@@ -7731,6 +7801,8 @@ function createToolExecuteResult(input) {
   const resultRoot = {
     toolResponse: {
       raw: result.data,
+      ...input.response && "rawV2" in input.response ? { rawV2: input.response.rawV2 } : {},
+      ...input.response?.view ? { view: input.response.view } : {},
       ...result.meta ? { meta: result.meta } : {}
     }
   };
@@ -7754,6 +7826,8 @@ function createToolExecuteResult(input) {
   };
   const toolResponse = {
     raw: result.data,
+    ...input.response && "rawV2" in input.response ? { rawV2: input.response.rawV2 } : {},
+    ...input.response?.view ? { view: input.response.view } : {},
     ...result.meta ? { meta: result.meta } : {}
   };
   const extractedValues = buildExtractedAccessors(targets);
@@ -8384,6 +8458,8 @@ function attachSdkQueryResultDatasetResult(toolId, result, options) {
 }
 function toolExecutionEnvelopeToResult(fallbackToolId, response, options) {
   const raw = response.toolResponse?.raw ?? null;
+  const rawV2 = response.toolResponse?.rawV2;
+  const view = response.toolResponse?.view;
   const meta = response.toolResponse?.meta;
   const metadata = isRecord9(response._metadata) ? response._metadata.tool : null;
   const toolMetadata = isRecord9(metadata) ? metadata : {};
@@ -8396,6 +8472,11 @@ function toolExecutionEnvelopeToResult(fallbackToolId, response, options) {
         data: raw,
         ...isRecord9(meta) ? { meta } : {}
       },
+      response: {
+        ...rawV2 !== void 0 ? { rawV2 } : {},
+        ...view === "data" || view === "rawV2" ? { view } : {},
+        ...isRecord9(meta) ? { meta } : {}
+      },
       metadata: {
         toolId: typeof toolMetadata.toolId === "string" ? toolMetadata.toolId : fallbackToolId,
         extractors: extractorDescriptorRecord(toolMetadata.extractors),

package/dist/index.mjs

@@ -703,7 +703,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",
@@ -3418,12 +3422,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;
@@ -3638,6 +3663,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";
 }
@@ -4187,14 +4256,14 @@ var DeeplineClient = class {
    */
   async executeTool(toolId, input, 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: input,
@@ -4208,6 +4277,7 @@ var DeeplineClient = class {
         toolId
       }
     );
+    return materializeToolExecutionResponse(response);
   }
   /**
    * Back-compatible alias for {@link executeTool}.
@@ -7654,6 +7724,8 @@ function createToolExecuteResult(input) {
   const resultRoot = {
     toolResponse: {
       raw: result.data,
+      ...input.response && "rawV2" in input.response ? { rawV2: input.response.rawV2 } : {},
+      ...input.response?.view ? { view: input.response.view } : {},
       ...result.meta ? { meta: result.meta } : {}
     }
   };
@@ -7677,6 +7749,8 @@ function createToolExecuteResult(input) {
   };
   const toolResponse = {
     raw: result.data,
+    ...input.response && "rawV2" in input.response ? { rawV2: input.response.rawV2 } : {},
+    ...input.response?.view ? { view: input.response.view } : {},
     ...result.meta ? { meta: result.meta } : {}
   };
   const extractedValues = buildExtractedAccessors(targets);
@@ -8307,6 +8381,8 @@ function attachSdkQueryResultDatasetResult(toolId, result, options) {
 }
 function toolExecutionEnvelopeToResult(fallbackToolId, response, options) {
   const raw = response.toolResponse?.raw ?? null;
+  const rawV2 = response.toolResponse?.rawV2;
+  const view = response.toolResponse?.view;
   const meta = response.toolResponse?.meta;
   const metadata = isRecord9(response._metadata) ? response._metadata.tool : null;
   const toolMetadata = isRecord9(metadata) ? metadata : {};
@@ -8319,6 +8395,11 @@ function toolExecutionEnvelopeToResult(fallbackToolId, response, options) {
         data: raw,
         ...isRecord9(meta) ? { meta } : {}
       },
+      response: {
+        ...rawV2 !== void 0 ? { rawV2 } : {},
+        ...view === "data" || view === "rawV2" ? { view } : {},
+        ...isRecord9(meta) ? { meta } : {}
+      },
       metadata: {
         toolId: typeof toolMetadata.toolId === "string" ? toolMetadata.toolId : fallbackToolId,
         extractors: extractorDescriptorRecord(toolMetadata.extractors),

package/dist/install-integrity.json

@@ -173,6 +173,7 @@
     "dist/bundling-sources/shared_libs/play-runtime/tool-execute-retry-policy.ts",
     "dist/bundling-sources/shared_libs/play-runtime/tool-execution-outcome.ts",
     "dist/bundling-sources/shared_libs/play-runtime/tool-http-errors.ts",
+    "dist/bundling-sources/shared_libs/play-runtime/tool-response-contract.ts",
     "dist/bundling-sources/shared_libs/play-runtime/tool-result-paths.ts",
     "dist/bundling-sources/shared_libs/play-runtime/tool-result-types.ts",
     "dist/bundling-sources/shared_libs/play-runtime/tool-result.ts",
@@ -225,8 +226,8 @@
     "dist/cli/index.d.ts",
     "dist/cli/index.js",
     "dist/cli/index.mjs",
-    "dist/compiler-manifest-DFuz9-0_.d.mts",
-    "dist/compiler-manifest-DFuz9-0_.d.ts",
+    "dist/compiler-manifest-BX85pKXW.d.mts",
+    "dist/compiler-manifest-BX85pKXW.d.ts",
     "dist/helpers.d.mts",
     "dist/helpers.d.ts",
     "dist/helpers.js",

package/dist/plays/bundle-play-file.d.mts

@@ -1,7 +1,15 @@
-import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-DFuz9-0_.mjs';
-export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-DFuz9-0_.mjs';
+import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-BX85pKXW.mjs';
+export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-BX85pKXW.mjs';
 import '@sinclair/typebox';
 
+/**
+ * Public tool-response contracts shared by the API, SDK, Play bundler, and
+ * runtime. A response contract is transport behavior, never Play authoring.
+ */
+declare const V2_TOOL_RESPONSE_CONTRACT: "v2-tool-response";
+declare const RAW_V2_TOOL_RESPONSE_CONTRACT: "raw-v2";
+type ToolResponseContract = typeof V2_TOOL_RESPONSE_CONTRACT | typeof RAW_V2_TOOL_RESPONSE_CONTRACT;
+
 type PlayPackageImport = {
     name: string;
     version: string | null;
@@ -22,6 +30,8 @@ type PlayArtifactCompatibility = {
     toolErrorSchemaVersion?: ToolExecutionErrorSchemaVersion;
     /** Missing preserves edition 1 for artifacts created before authoring contracts were pinned. */
     authoringContractEdition?: PlayAuthoringContractEdition;
+    /** Missing preserves the raw-only V2 execute response contract. */
+    toolResponseContract?: ToolResponseContract;
 };
 /** The only executable Play artifact contract. */
 type PlayArtifactKind = 'cjs_node20';

package/dist/plays/bundle-play-file.d.ts

@@ -1,7 +1,15 @@
-import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-DFuz9-0_.js';
-export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-DFuz9-0_.js';
+import { T as ToolExecutionErrorSchemaVersion, P as PlayAuthoringContractEdition, a as PlayArtifactKind$1, b as PlaySandboxRuntimeDeclaration, c as PlayCompilerManifest } from '../compiler-manifest-BX85pKXW.js';
+export { d as PLAY_ARTIFACT_KINDS } from '../compiler-manifest-BX85pKXW.js';
 import '@sinclair/typebox';
 
+/**
+ * Public tool-response contracts shared by the API, SDK, Play bundler, and
+ * runtime. A response contract is transport behavior, never Play authoring.
+ */
+declare const V2_TOOL_RESPONSE_CONTRACT: "v2-tool-response";
+declare const RAW_V2_TOOL_RESPONSE_CONTRACT: "raw-v2";
+type ToolResponseContract = typeof V2_TOOL_RESPONSE_CONTRACT | typeof RAW_V2_TOOL_RESPONSE_CONTRACT;
+
 type PlayPackageImport = {
     name: string;
     version: string | null;
@@ -22,6 +30,8 @@ type PlayArtifactCompatibility = {
     toolErrorSchemaVersion?: ToolExecutionErrorSchemaVersion;
     /** Missing preserves edition 1 for artifacts created before authoring contracts were pinned. */
     authoringContractEdition?: PlayAuthoringContractEdition;
+    /** Missing preserves the raw-only V2 execute response contract. */
+    toolResponseContract?: ToolResponseContract;
 };
 /** The only executable Play artifact contract. */
 type PlayArtifactKind = 'cjs_node20';

package/dist/plays/bundle-play-file.mjs

@@ -9,6 +9,7 @@ import { tmpdir as tmpdir2 } from "os";
 import { dirname as dirname3, join as join3, resolve as resolve3 } from "path";
 import { fileURLToPath } from "url";
 import { existsSync as existsSync2 } from "fs";
+import { realpath as realpath2 } from "fs/promises";
 
 // ../shared_libs/plays/bundling/index.ts
 import { createHash } from "crypto";
@@ -4001,6 +4002,9 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
   "export type DefinedPlay<TInput, TOutput extends PlayReturnObject> = ((ctx: DeeplinePlayRuntimeContext, input: TInput) => Promise<TOutput>) & { readonly name: string; readonly __inputType?: TInput; readonly __outputType?: TOutput; readonly runtime?: PlayBindings['runtime']; readonly compatibility?: PlayBindings['compatibility'] };"
 ];
 
+// ../shared_libs/play-runtime/tool-response-contract.ts
+var RAW_V2_TOOL_RESPONSE_CONTRACT = "raw-v2";
+
 // ../shared_libs/plays/contracts.ts
 var PLAY_PUBLIC_API_VERSION = 1;
 var PLAY_ARTIFACT_VERSION = CURRENT_PLAY_ARTIFACT_CONTRACT_VERSION;
@@ -4019,7 +4023,8 @@ function buildPlayContractCompatibility(input) {
     runtimeFeatures: [...PLAY_RUNTIME_FEATURES],
     runtimeBackend: input?.runtimeBackend ?? null,
     toolErrorSchemaVersion: input?.toolErrorSchemaVersion ?? TOOL_EXECUTION_ERROR_SCHEMA_VERSION,
-    authoringContractEdition: input?.authoringContractEdition ?? PLAY_AUTHORING_CONTRACT_EDITION
+    authoringContractEdition: input?.authoringContractEdition ?? PLAY_AUTHORING_CONTRACT_EDITION,
+    toolResponseContract: input?.toolResponseContract ?? RAW_V2_TOOL_RESPONSE_CONTRACT
   };
 }
 
@@ -5282,8 +5287,12 @@ function sha256(value) {
 function sourceIdentityPath(filePath, sourceIdentityRoot) {
   if (!sourceIdentityRoot) return filePath;
   const identityRoot = resolve(sourceIdentityRoot);
-  const logicalPath = relative(identityRoot, resolve(filePath));
-  if (!logicalPath || logicalPath === ".." || logicalPath.startsWith(`..${sep}`) || isAbsolute(logicalPath)) {
+  const resolvedFilePath = resolve(filePath);
+  const logicalPath = relative(identityRoot, resolvedFilePath);
+  if (!logicalPath) {
+    return basename(resolvedFilePath);
+  }
+  if (logicalPath === ".." || logicalPath.startsWith(`..${sep}`) || isAbsolute(logicalPath)) {
     return filePath;
   }
   return logicalPath.split(/[\\/]+/).join("/");
@@ -7197,10 +7206,17 @@ function createSdkPlayBundlingAdapter() {
   };
 }
 async function bundlePlayFile2(filePath, options = {}) {
+  const localWorkspaceRoot = dirname3(resolve3(filePath));
+  const sourceIdentityRoot = await realpath2(localWorkspaceRoot).catch(
+    () => localWorkspaceRoot
+  );
   const result = await bundlePlayFile(filePath, {
     target: options.target ?? defaultPlayBundleTarget(),
     exportName: options.exportName,
-    adapter: createSdkPlayBundlingAdapter()
+    adapter: {
+      ...createSdkPlayBundlingAdapter(),
+      sourceIdentityRoot
+    }
   });
   if (result.success)
     validatePlaySourceFilesHaveNoInlineSecrets(result.sourceFiles);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.2.74",
+  "version": "0.3.1",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",