deepline 0.3.35 → 0.3.36

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

@@ -199,7 +199,7 @@ export const SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: '0.3.35',
+  version: '0.3.36',
   updateSummary:
     'Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.',
   packageCapabilities: {

package/dist/bundling-sources/shared_libs/plays/resolve-static-pipeline.ts

@@ -16,6 +16,12 @@ export type ResolveStaticPipelineInput = {
     playId: string,
   ) => Promise<ResolvablePlayStaticShape | null>;
   maxDepth?: number;
+  /**
+   * Keep an embedded local-import contract when one is present, while still
+   * resolving compact calls nested inside it. Named live calls omit the
+   * embedded pipeline and continue through the registry resolver.
+   */
+  preferEmbeddedPlayCalls?: boolean;
 };
 
 function clonePipeline(pipeline: PlayStaticPipeline): PlayStaticPipeline {
@@ -69,8 +75,17 @@ async function resolvePipelineSubsteps(input: {
   ) => Promise<ResolvablePlayStaticShape | null>;
   stack: string[];
   maxDepth: number;
+  preferEmbeddedPlayCalls: boolean;
+  resolvedPipelineCache: Map<string, Promise<PlayStaticPipeline | null>>;
 }): Promise<PlayStaticSubstep[]> {
-  const { steps, resolveReferencedPlay, stack, maxDepth } = input;
+  const {
+    steps,
+    resolveReferencedPlay,
+    stack,
+    maxDepth,
+    preferEmbeddedPlayCalls,
+    resolvedPipelineCache,
+  } = input;
   const callDepth = Math.max(0, stack.length - 1);
 
   return await Promise.all(
@@ -81,20 +96,44 @@ async function resolvePipelineSubsteps(input: {
       });
 
       if (
-        (annotated.type === 'dataset' ||
-          annotated.type === 'step_suite' ||
-          annotated.type === 'control_flow') &&
-        annotated.steps?.length
+        annotated.type === 'dataset' ||
+        annotated.type === 'step_suite' ||
+        annotated.type === 'control_flow'
       ) {
-        return {
+        const nested = {
           ...annotated,
-          steps: await resolvePipelineSubsteps({
-            steps: annotated.steps,
-            resolveReferencedPlay,
-            stack,
-            maxDepth,
-          }),
-        } satisfies PlayStaticSubstep;
+          ...(annotated.steps?.length
+            ? {
+                steps: await resolvePipelineSubsteps({
+                  steps: annotated.steps,
+                  resolveReferencedPlay,
+                  stack,
+                  maxDepth,
+                  preferEmbeddedPlayCalls,
+                  resolvedPipelineCache,
+                }),
+              }
+            : {}),
+        };
+        if (nested.type === 'control_flow' && nested.branches?.length) {
+          return {
+            ...nested,
+            branches: await Promise.all(
+              nested.branches.map(async (branch) => ({
+                ...branch,
+                steps: await resolvePipelineSubsteps({
+                  steps: branch.steps,
+                  resolveReferencedPlay,
+                  stack,
+                  maxDepth,
+                  preferEmbeddedPlayCalls,
+                  resolvedPipelineCache,
+                }),
+              })),
+            ),
+          } satisfies PlayStaticSubstep;
+        }
+        return nested satisfies PlayStaticSubstep;
       }
 
       if (annotated.type !== 'play_call') {
@@ -118,9 +157,51 @@ async function resolvePipelineSubsteps(input: {
         } satisfies PlayStaticSubstep;
       }
 
-      const childShape = await resolveReferencedPlay(annotated.playId);
-      const childPipeline = materializePipeline(childShape);
-      if (!childPipeline) {
+      const cacheKey = JSON.stringify([...stack, annotated.playId]);
+      let resolvedChildPipelinePromise = resolvedPipelineCache.get(cacheKey);
+      if (!resolvedChildPipelinePromise) {
+        resolvedChildPipelinePromise = (async () => {
+          const childShape =
+            preferEmbeddedPlayCalls && annotated.pipeline
+              ? { staticPipeline: annotated.pipeline }
+              : await resolveReferencedPlay(annotated.playId);
+          const childPipeline = materializePipeline(childShape);
+          if (!childPipeline) {
+            return null;
+          }
+
+          const resolvedChildPipeline = {
+            ...childPipeline,
+            stages: await resolvePipelineSubsteps({
+              steps: childPipeline.stages ?? [],
+              resolveReferencedPlay,
+              stack: [...stack, annotated.playId],
+              maxDepth,
+              preferEmbeddedPlayCalls,
+              resolvedPipelineCache,
+            }),
+            substeps: await resolvePipelineSubsteps({
+              steps: childPipeline.substeps,
+              resolveReferencedPlay,
+              stack: [...stack, annotated.playId],
+              maxDepth,
+              preferEmbeddedPlayCalls,
+              resolvedPipelineCache,
+            }),
+          };
+          const childContract = compileSheetContract(resolvedChildPipeline);
+
+          return {
+            ...resolvedChildPipeline,
+            sheetContract: childContract.contract,
+            sheetContractErrors: childContract.errors,
+          };
+        })();
+        resolvedPipelineCache.set(cacheKey, resolvedChildPipelinePromise);
+      }
+
+      const resolvedChildPipeline = await resolvedChildPipelinePromise;
+      if (!resolvedChildPipeline) {
         return {
           ...annotated,
           resolutionError: `Unable to statically resolve play "${annotated.playId}"`,
@@ -128,30 +209,9 @@ async function resolvePipelineSubsteps(input: {
         } satisfies PlayStaticSubstep;
       }
 
-      const resolvedChildPipeline = {
-        ...childPipeline,
-        stages: await resolvePipelineSubsteps({
-          steps: childPipeline.stages ?? [],
-          resolveReferencedPlay,
-          stack: [...stack, annotated.playId],
-          maxDepth,
-        }),
-        substeps: await resolvePipelineSubsteps({
-          steps: childPipeline.substeps,
-          resolveReferencedPlay,
-          stack: [...stack, annotated.playId],
-          maxDepth,
-        }),
-      };
-      const childContract = compileSheetContract(resolvedChildPipeline);
-
       return {
         ...annotated,
-        pipeline: {
-          ...resolvedChildPipeline,
-          sheetContract: childContract.contract,
-          sheetContractErrors: childContract.errors,
-        },
+        pipeline: resolvedChildPipeline,
       } satisfies PlayStaticSubstep;
     }),
   );
@@ -161,10 +221,15 @@ export async function resolveStaticPipelineTree(
   input: ResolveStaticPipelineInput,
 ): Promise<PlayStaticPipeline | null> {
   const maxDepth = input.maxDepth ?? 6;
+  const preferEmbeddedPlayCalls = input.preferEmbeddedPlayCalls ?? false;
   const rootPipeline = materializePipeline(input.root);
   if (!rootPipeline) {
     return null;
   }
+  const resolvedPipelineCache = new Map<
+    string,
+    Promise<PlayStaticPipeline | null>
+  >();
 
   const resolvedPipeline = {
     ...rootPipeline,
@@ -173,12 +238,16 @@ export async function resolveStaticPipelineTree(
       resolveReferencedPlay: input.resolveReferencedPlay,
       stack: [input.rootPlayId],
       maxDepth,
+      preferEmbeddedPlayCalls,
+      resolvedPipelineCache,
     }),
     substeps: await resolvePipelineSubsteps({
       steps: rootPipeline.substeps,
       resolveReferencedPlay: input.resolveReferencedPlay,
       stack: [input.rootPlayId],
       maxDepth,
+      preferEmbeddedPlayCalls,
+      resolvedPipelineCache,
     }),
   };
   const contract = compileSheetContract(resolvedPipeline);

package/dist/bundling-sources/shared_libs/plays/static-pipeline.ts

@@ -609,6 +609,13 @@ export function truncateStaticPipelineForRuntimeContract(
  */
 export function createStaticPipelineReferenceProjection(
   pipeline: PlayStaticPipeline | null | undefined,
+  options?: {
+    /**
+     * Local imported Plays do not have an independently published registry
+     * contract. Keep those embedded while compacting live named Play calls.
+     */
+    preserveEmbeddedPlayIds?: ReadonlySet<string>;
+  },
 ): PlayStaticPipeline | null | undefined {
   const stored = truncateStaticPipelineForStorage(pipeline, {
     maxEmbeddedPlayCallPipelineDepth: Number.POSITIVE_INFINITY,
@@ -629,6 +636,13 @@ export function createStaticPipelineReferenceProjection(
         }>;
       };
       if (projected.type === 'play_call') {
+        if (
+          projected.pipeline &&
+          options?.preserveEmbeddedPlayIds?.has(projected.playId)
+        ) {
+          projected.pipeline = projectPipeline(projected.pipeline);
+          return projected;
+        }
         delete projected.pipeline;
         if (
           projected.resolutionError?.startsWith(
@@ -656,11 +670,15 @@ export function createStaticPipelineReferenceProjection(
       return projected;
     });
 
-  return {
-    ...stored,
-    stages: projectSteps(stored.stages),
-    substeps: projectSteps(stored.substeps),
-  };
+  const projectPipeline = (
+    candidate: PlayStaticPipeline,
+  ): PlayStaticPipeline => ({
+    ...candidate,
+    stages: projectSteps(candidate.stages),
+    substeps: projectSteps(candidate.substeps),
+  });
+
+  return projectPipeline(stored);
 }
 
 function asStaticRecord(value: unknown): Record<string, unknown> | null {

package/dist/cli/index.js

@@ -1043,7 +1043,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.35",
+  version: "0.3.36",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/cli/index.mjs

@@ -1029,7 +1029,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.35",
+  version: "0.3.36",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/index.js

@@ -779,7 +779,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.35",
+  version: "0.3.36",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/index.mjs

@@ -702,7 +702,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.35",
+  version: "0.3.36",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1

package/package.json

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