deepline 0.2.71 → 0.2.73

package/dist/index.d.mts

@@ -1304,6 +1304,19 @@ interface PlayDetail {
     customerDbUrl: string;
     /** Change cursor for incremental sync. */
     deltaCursor: number;
+    /**
+     * Present only when requested through `getPlay(..., { source: ... })`.
+     * `files` is the complete authored source tree, keyed by logical path.
+     */
+    source?: {
+        selector: 'working' | 'live' | `version:${number}`;
+        revision: {
+            id: string;
+            version: number;
+        };
+        entryFile: string;
+        files: Record<string, string>;
+    };
 }
 interface ClearPlayHistoryRequest {
     /** Optional explicit ctx.dataset keys to clear. Omit to clear all discovered sheets for the play. */
@@ -3405,7 +3418,9 @@ declare class DeeplineClient {
      * console.log(`Total runs: ${detail.play.runCount}`);
      * ```
      */
-    getPlay(name: string): Promise<PlayDetail>;
+    getPlay(name: string, options?: {
+        source?: 'working' | 'live' | `version:${number}`;
+    }): Promise<PlayDetail>;
     /**
      * Get a normalized play description suitable for agents and CLIs.
      *

package/dist/index.d.ts

@@ -1304,6 +1304,19 @@ interface PlayDetail {
     customerDbUrl: string;
     /** Change cursor for incremental sync. */
     deltaCursor: number;
+    /**
+     * Present only when requested through `getPlay(..., { source: ... })`.
+     * `files` is the complete authored source tree, keyed by logical path.
+     */
+    source?: {
+        selector: 'working' | 'live' | `version:${number}`;
+        revision: {
+            id: string;
+            version: number;
+        };
+        entryFile: string;
+        files: Record<string, string>;
+    };
 }
 interface ClearPlayHistoryRequest {
     /** Optional explicit ctx.dataset keys to clear. Omit to clear all discovered sheets for the play. */
@@ -3405,7 +3418,9 @@ declare class DeeplineClient {
      * console.log(`Total runs: ${detail.play.runCount}`);
      * ```
      */
-    getPlay(name: string): Promise<PlayDetail>;
+    getPlay(name: string, options?: {
+        source?: 'working' | 'live' | `version:${number}`;
+    }): Promise<PlayDetail>;
     /**
      * Get a normalized play description suitable for agents and CLIs.
      *

package/dist/index.js

@@ -780,7 +780,7 @@ 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.71",
+  version: "0.2.73",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -5728,9 +5728,10 @@ var DeeplineClient = class {
    * console.log(`Total runs: ${detail.play.runCount}`);
    * ```
    */
-  async getPlay(name) {
+  async getPlay(name, options) {
     const encodedName = encodeURIComponent(name);
-    return this.http.get(`/api/v2/plays/${encodedName}`);
+    const query = options?.source ? `?include=source&revision=${encodeURIComponent(options.source)}` : "";
+    return this.http.get(`/api/v2/plays/${encodedName}${query}`);
   }
   /**
    * Get a normalized play description suitable for agents and CLIs.
@@ -7103,16 +7104,41 @@ function listNameFromDeclaredPath(path) {
 }
 
 // ../shared_libs/play-runtime/tool-result.ts
+var DESCRIPTOR_SUFFIX = /_(status|type|score|count|id|verified|valid|confidence|quality|source)$/i;
+var COMPANY_SCOPED = /company/i;
 var TARGET_FALLBACK_KEYS = {
-  email: [/^email$/i, /^address$/i, /email/i],
-  phone: [/^phone$/i, /mobile/i, /phone/i, /telephone/i],
-  linkedin: [/^linkedin_url$/i, /^linkedin$/i, /linkedin/i],
-  company_linkedin_url: [/company.*linkedin/i, /linkedin.*company/i],
-  company_domain: [/^company_domain$/i, /company.*domain/i],
-  company_name: [/^company_name$/i, /company.*name/i],
-  domain: [/^domain$/i, /company_domain/i, /domain/i],
-  status: [/^email_status$/i, /^status$/i],
-  email_status: [/^email_status$/i, /^status$/i]
+  email: {
+    match: [/^email$/i, /^address$/i, /email/i],
+    reject: [DESCRIPTOR_SUFFIX]
+  },
+  phone: {
+    match: [/^phone$/i, /mobile/i, /phone/i, /telephone/i],
+    reject: [DESCRIPTOR_SUFFIX]
+  },
+  linkedin: {
+    match: [/^linkedin_url$/i, /^linkedin$/i, /linkedin/i],
+    reject: [DESCRIPTOR_SUFFIX, COMPANY_SCOPED]
+  },
+  company_linkedin_url: {
+    match: [/company.*linkedin/i, /linkedin.*company/i],
+    reject: [DESCRIPTOR_SUFFIX]
+  },
+  company_domain: {
+    match: [/^company_domain$/i, /company.*domain/i],
+    reject: [DESCRIPTOR_SUFFIX]
+  },
+  company_name: {
+    match: [/^company_name$/i, /company.*name/i],
+    reject: [DESCRIPTOR_SUFFIX]
+  },
+  domain: {
+    match: [/^domain$/i, /company_domain/i, /domain/i],
+    reject: [DESCRIPTOR_SUFFIX]
+  },
+  // Status targets legitimately want the `_status` keys the suffix rule
+  // rejects elsewhere, so they carry no rejections.
+  status: { match: [/^email_status$/i, /^status$/i] },
+  email_status: { match: [/^email_status$/i, /^status$/i] }
 };
 function isRecord8(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
@@ -7334,11 +7360,12 @@ function findFirstTargetByKey(result, target, depth = 0, path = []) {
     return null;
   }
   if (!isRecord8(result)) return null;
-  const patterns = TARGET_FALLBACK_KEYS[target] ?? [
-    new RegExp(`^${target}$`, "i")
-  ];
+  const rule = TARGET_FALLBACK_KEYS[target] ?? {
+    match: [new RegExp(`^${target}$`, "i")]
+  };
   for (const [key, value] of Object.entries(result)) {
-    if (patterns.some((pattern) => pattern.test(key)) && isMeaningfulValue(value)) {
+    if (rule.reject?.some((pattern) => pattern.test(key))) continue;
+    if (rule.match.some((pattern) => pattern.test(key)) && isMeaningfulValue(value)) {
       return { value, path: pathToString([...path, key]) };
     }
   }

package/dist/index.mjs

@@ -703,7 +703,7 @@ 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.71",
+  version: "0.2.73",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -5651,9 +5651,10 @@ var DeeplineClient = class {
    * console.log(`Total runs: ${detail.play.runCount}`);
    * ```
    */
-  async getPlay(name) {
+  async getPlay(name, options) {
     const encodedName = encodeURIComponent(name);
-    return this.http.get(`/api/v2/plays/${encodedName}`);
+    const query = options?.source ? `?include=source&revision=${encodeURIComponent(options.source)}` : "";
+    return this.http.get(`/api/v2/plays/${encodedName}${query}`);
   }
   /**
    * Get a normalized play description suitable for agents and CLIs.
@@ -7026,16 +7027,41 @@ function listNameFromDeclaredPath(path) {
 }
 
 // ../shared_libs/play-runtime/tool-result.ts
+var DESCRIPTOR_SUFFIX = /_(status|type|score|count|id|verified|valid|confidence|quality|source)$/i;
+var COMPANY_SCOPED = /company/i;
 var TARGET_FALLBACK_KEYS = {
-  email: [/^email$/i, /^address$/i, /email/i],
-  phone: [/^phone$/i, /mobile/i, /phone/i, /telephone/i],
-  linkedin: [/^linkedin_url$/i, /^linkedin$/i, /linkedin/i],
-  company_linkedin_url: [/company.*linkedin/i, /linkedin.*company/i],
-  company_domain: [/^company_domain$/i, /company.*domain/i],
-  company_name: [/^company_name$/i, /company.*name/i],
-  domain: [/^domain$/i, /company_domain/i, /domain/i],
-  status: [/^email_status$/i, /^status$/i],
-  email_status: [/^email_status$/i, /^status$/i]
+  email: {
+    match: [/^email$/i, /^address$/i, /email/i],
+    reject: [DESCRIPTOR_SUFFIX]
+  },
+  phone: {
+    match: [/^phone$/i, /mobile/i, /phone/i, /telephone/i],
+    reject: [DESCRIPTOR_SUFFIX]
+  },
+  linkedin: {
+    match: [/^linkedin_url$/i, /^linkedin$/i, /linkedin/i],
+    reject: [DESCRIPTOR_SUFFIX, COMPANY_SCOPED]
+  },
+  company_linkedin_url: {
+    match: [/company.*linkedin/i, /linkedin.*company/i],
+    reject: [DESCRIPTOR_SUFFIX]
+  },
+  company_domain: {
+    match: [/^company_domain$/i, /company.*domain/i],
+    reject: [DESCRIPTOR_SUFFIX]
+  },
+  company_name: {
+    match: [/^company_name$/i, /company.*name/i],
+    reject: [DESCRIPTOR_SUFFIX]
+  },
+  domain: {
+    match: [/^domain$/i, /company_domain/i, /domain/i],
+    reject: [DESCRIPTOR_SUFFIX]
+  },
+  // Status targets legitimately want the `_status` keys the suffix rule
+  // rejects elsewhere, so they carry no rejections.
+  status: { match: [/^email_status$/i, /^status$/i] },
+  email_status: { match: [/^email_status$/i, /^status$/i] }
 };
 function isRecord8(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
@@ -7257,11 +7283,12 @@ function findFirstTargetByKey(result, target, depth = 0, path = []) {
     return null;
   }
   if (!isRecord8(result)) return null;
-  const patterns = TARGET_FALLBACK_KEYS[target] ?? [
-    new RegExp(`^${target}$`, "i")
-  ];
+  const rule = TARGET_FALLBACK_KEYS[target] ?? {
+    match: [new RegExp(`^${target}$`, "i")]
+  };
   for (const [key, value] of Object.entries(result)) {
-    if (patterns.some((pattern) => pattern.test(key)) && isMeaningfulValue(value)) {
+    if (rule.reject?.some((pattern) => pattern.test(key))) continue;
+    if (rule.match.some((pattern) => pattern.test(key)) && isMeaningfulValue(value)) {
       return { value, path: pathToString([...path, key]) };
     }
   }

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

@@ -5262,6 +5262,11 @@ var NODE_BUILTIN_SET = new Set(
     (name) => name.startsWith("node:") ? [name, name.slice(5)] : [name, `node:${name}`]
   )
 );
+var defaultPathRelationshipApi = {
+  relative,
+  isAbsolute,
+  sep
+};
 function assertValidExportName(exportName) {
   if (exportName === "default") return;
   if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(exportName)) {
@@ -5273,9 +5278,9 @@ function assertValidExportName(exportName) {
 function sha256(value) {
   return createHash("sha256").update(value).digest("hex");
 }
-function sourceIdentityPath(filePath, adapter) {
-  if (!adapter.sourceIdentityRoot) return filePath;
-  const identityRoot = resolve(adapter.sourceIdentityRoot);
+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)) {
     return filePath;
@@ -5302,8 +5307,9 @@ function createPlayWorkspace(entryFile) {
     rootDir: dirname(entryFile)
   };
 }
-function isPathInsideDirectory(filePath, directory) {
-  return filePath === directory || filePath.startsWith(`${directory}/`);
+function isPathInsideDirectory(filePath, directory, pathApi = defaultPathRelationshipApi) {
+  const relationship = pathApi.relative(directory, filePath);
+  return relationship === "" || relationship !== ".." && !relationship.startsWith(`..${pathApi.sep}`) && !pathApi.isAbsolute(relationship);
 }
 function assertWithinPlayWorkspace(input) {
   if (isPathInsideDirectory(input.resolvedPath, input.workspace.rootDir)) {
@@ -6286,6 +6292,7 @@ function resolvePackageImport(specifier, fromFile, adapter) {
 async function analyzeSourceGraph(entryFile, adapter, exportName) {
   const absoluteEntryFile = await normalizeLocalPath(entryFile);
   const workspace = createPlayWorkspace(absoluteEntryFile);
+  const sourceIdentityRoot = adapter.sourceIdentityRoot;
   const localFiles = /* @__PURE__ */ new Map();
   const nodeBuiltins = /* @__PURE__ */ new Set();
   const packages = /* @__PURE__ */ new Map();
@@ -6382,15 +6389,15 @@ async function analyzeSourceGraph(entryFile, adapter, exportName) {
   const sourceHash = sha256(sourceCode);
   const graphHash = sha256(
     JSON.stringify({
-      entryFile: sourceIdentityPath(absoluteEntryFile, adapter),
+      entryFile: sourceIdentityPath(absoluteEntryFile, sourceIdentityRoot),
       localFiles: [...localFiles.entries()].map(([filePath, contents]) => ({
-        filePath: sourceIdentityPath(filePath, adapter),
+        filePath: sourceIdentityPath(filePath, sourceIdentityRoot),
         hash: sha256(contents)
       })).sort((left, right) => left.filePath.localeCompare(right.filePath)),
       nodeBuiltins: [...nodeBuiltins].sort(),
       packages: [...packages.entries()].map(([name, version]) => ({ name, version })).sort((left, right) => left.name.localeCompare(right.name)),
       importedPlayDependencies: [...importedPlayDependencies.values()].map((dependency) => ({
-        filePath: sourceIdentityPath(dependency.filePath, adapter),
+        filePath: sourceIdentityPath(dependency.filePath, sourceIdentityRoot),
         playName: dependency.playName
       })).sort((left, right) => left.filePath.localeCompare(right.filePath))
     })
@@ -6543,6 +6550,7 @@ async function bundlePlayFile(filePath, options) {
   const exportName = options.exportName?.trim() || "default";
   assertValidExportName(exportName);
   const absolutePath = await normalizeLocalPath(filePath);
+  const sourceIdentityRoot = adapter.sourceIdentityRoot;
   adapter.warnAboutNonDevelopmentBundling?.(absolutePath);
   try {
     const analysis = await analyzeSourceGraph(
@@ -6555,6 +6563,19 @@ async function bundlePlayFile(filePath, options) {
 entry-export:${exportName}
 authoring-contract-edition:${PLAY_AUTHORING_CONTRACT_EDITION}`
     );
+    const sourceFiles = Object.fromEntries(
+      Object.entries(analysis.sourceFiles).map(([sourcePath, sourceCode]) => [
+        sourceIdentityPath(sourcePath, sourceIdentityRoot),
+        sourceCode
+      ])
+    );
+    const importPolicy = {
+      ...analysis.importPolicy,
+      localFiles: analysis.importPolicy.localFiles.map(
+        (sourcePath) => sourceIdentityPath(sourcePath, sourceIdentityRoot)
+      )
+    };
+    const entryFile = sourceIdentityPath(absolutePath, sourceIdentityRoot);
     try {
       validatePlaySourceFilesHaveNoInlineSecrets(analysis.sourceFiles);
     } catch (error) {
@@ -6606,16 +6627,16 @@ authoring-contract-edition:${PLAY_AUTHORING_CONTRACT_EDITION}`
         success: true,
         artifact: {
           ...cachedArtifact,
-          entryFile: absolutePath,
+          entryFile,
           sourceHash: analysis.sourceHash,
-          importPolicy: analysis.importPolicy,
+          importPolicy,
           compatibility: buildPlayContractCompatibility({
             toolErrorSchemaVersion: analysis.toolErrorSchemaVersion ?? void 0
           }),
           cacheHit: true
         },
         sourceCode: analysis.sourceCode,
-        sourceFiles: analysis.sourceFiles,
+        sourceFiles,
         filePath: absolutePath,
         playName: analysis.playName,
         playDescription: analysis.playDescription,
@@ -6664,7 +6685,7 @@ authoring-contract-edition:${PLAY_AUTHORING_CONTRACT_EDITION}`
     const artifact = {
       codeFormat: "cjs_module",
       artifactKind: target,
-      entryFile: absolutePath,
+      entryFile,
       virtualFilename,
       sourceHash: analysis.sourceHash,
       graphHash: analysis.graphHash,
@@ -6672,7 +6693,7 @@ authoring-contract-edition:${PLAY_AUTHORING_CONTRACT_EDITION}`
       sourceMapHash: sha256(normalizedSourceMap),
       bundledCode: executableCode,
       sourceMap: normalizedSourceMap,
-      importPolicy: analysis.importPolicy,
+      importPolicy,
       compatibility: buildPlayContractCompatibility({
         toolErrorSchemaVersion: analysis.toolErrorSchemaVersion ?? void 0
       }),
@@ -6684,7 +6705,7 @@ authoring-contract-edition:${PLAY_AUTHORING_CONTRACT_EDITION}`
       success: true,
       artifact,
       sourceCode: analysis.sourceCode,
-      sourceFiles: analysis.sourceFiles,
+      sourceFiles,
       filePath: absolutePath,
       playName: analysis.playName,
       playDescription: analysis.playDescription,

package/package.json

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