deepline 0.3.26 → 0.3.28

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

@@ -1958,6 +1958,10 @@ export class DeeplineClient {
       currentPublishedVersion:
         play.currentPublishedVersion ?? play.liveRevision?.version ?? null,
       latestRunId: play.latestRunId ?? detail.latestRuns[0]?.workflowId ?? null,
+      ...(play.runtimeLimit ? { runtimeLimit: play.runtimeLimit } : {}),
+      ...(play.activeScheduledPlays
+        ? { activeScheduledPlays: play.activeScheduledPlays }
+        : {}),
     };
   }
 
@@ -4145,12 +4149,17 @@ export class DeeplineClient {
    */
   async getPlay(
     name: string,
-    options?: { source?: 'working' | 'live' | `version:${number}` },
+    options?: {
+      source?: 'working' | 'live' | `version:${number}`;
+      guidance?: boolean;
+    },
   ): Promise<PlayDetail> {
     const encodedName = encodeURIComponent(name);
     const query = options?.source
       ? `?include=source&revision=${encodeURIComponent(options.source)}`
-      : '';
+      : options?.guidance
+        ? '?include=guidance'
+        : '';
     return this.http.get<PlayDetail>(`/api/v2/plays/${encodedName}${query}`);
   }
 
@@ -4164,7 +4173,7 @@ export class DeeplineClient {
     name: string,
     options?: { compact?: boolean },
   ): Promise<PlayDescription> {
-    const detail = await this.getPlay(name);
+    const detail = await this.getPlay(name, { guidance: true });
     return this.summarizePlayDetail(detail, options);
   }
 

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

@@ -192,7 +192,7 @@ export const SDK_RELEASE = {
   // 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.26',
+  version: '0.3.28',
   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: {

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

@@ -970,6 +970,24 @@ export interface PlayRevisionSummary {
   isWorking?: boolean;
 }
 
+/** Effective runtime limits stored with the selected immutable Play revision. */
+export interface PlayRuntimeLimit {
+  timeoutSeconds: number;
+  memoryGiB: number;
+  cpu: number;
+  diskGiB: number;
+  /** `live` is what named runs execute; `working` is shown only before first publish. */
+  source: 'live' | 'working';
+}
+
+/** Read-only scheduled-Play capacity guidance for a Play with a cron trigger. */
+export interface PlayScheduledCapacity {
+  used: number;
+  limit: number;
+  remaining: number;
+  approachingLimit: boolean;
+}
+
 /**
  * Aggregate row-processing stats for a play's sheet.
  */
@@ -1069,6 +1087,10 @@ export interface PlayDefinitionDetail {
   liveRevision?: PlayRevisionSummary | null;
   /** `true` if the working revision differs from the live revision. */
   isDraftDirty?: boolean;
+  /** Effective sandbox limit from the live revision, or the working draft before first publish. */
+  runtimeLimit?: PlayRuntimeLimit | null;
+  /** Present for a Play with a cron trigger. Advisory only; publish remains authoritative. */
+  activeScheduledPlays?: PlayScheduledCapacity | null;
   /** Compatibility field for older readers. */
   currentPublishedVersion?: number | null;
 }
@@ -1185,6 +1207,10 @@ export interface PlayDescription {
   };
   isDraftDirty?: boolean;
   latestRunId?: string | null;
+  /** Effective sandbox limit from the revision named runs use. */
+  runtimeLimit?: PlayRuntimeLimit | null;
+  /** Present for a Play with a cron trigger. Advisory only; publish remains authoritative. */
+  activeScheduledPlays?: PlayScheduledCapacity | null;
 }
 
 /**

package/dist/bundling-sources/shared_libs/play-runtime/db-session-plan.ts

@@ -1,5 +1,5 @@
 import {
-  getCompiledPipelineSubsteps,
+  getTopLevelPipelineSubsteps,
   type PlaySheetContract,
   type PlayStaticPipeline,
   type PlayStaticSubstep,
@@ -70,7 +70,7 @@ function datasetSessionContracts(
   }
   const rootContract = pipeline.sheetContract ?? null;
   return currentExecutionScopeSubsteps(
-    getCompiledPipelineSubsteps(pipeline),
+    getTopLevelPipelineSubsteps(pipeline),
   ).flatMap<DatasetSessionContract>((substep): DatasetSessionContract[] => {
     if (substep.type !== 'dataset') return [];
     const rawNamespace = (substep.tableNamespace ?? substep.field ?? '').trim();

package/dist/cli/index.js

@@ -1042,7 +1042,7 @@ var SDK_RELEASE = {
   // 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.26",
+  version: "0.3.28",
   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: {
@@ -4828,7 +4828,9 @@ var DeeplineClient = class {
     return {
       ...this.summarizePlayListItem(play, options),
       currentPublishedVersion: play.currentPublishedVersion ?? play.liveRevision?.version ?? null,
-      latestRunId: play.latestRunId ?? detail.latestRuns[0]?.workflowId ?? null
+      latestRunId: play.latestRunId ?? detail.latestRuns[0]?.workflowId ?? null,
+      ...play.runtimeLimit ? { runtimeLimit: play.runtimeLimit } : {},
+      ...play.activeScheduledPlays ? { activeScheduledPlays: play.activeScheduledPlays } : {}
     };
   }
   // ——————————————————————————————————————————————————————————
@@ -6465,7 +6467,7 @@ var DeeplineClient = class {
    */
   async getPlay(name, options) {
     const encodedName = encodeURIComponent(name);
-    const query = options?.source ? `?include=source&revision=${encodeURIComponent(options.source)}` : "";
+    const query = options?.source ? `?include=source&revision=${encodeURIComponent(options.source)}` : options?.guidance ? "?include=guidance" : "";
     return this.http.get(`/api/v2/plays/${encodedName}${query}`);
   }
   /**
@@ -6475,7 +6477,7 @@ var DeeplineClient = class {
    * guidance, revision state, and latest run metadata when available.
    */
   async describePlay(name, options) {
-    const detail = await this.getPlay(name);
+    const detail = await this.getPlay(name, { guidance: true });
     return this.summarizePlayDetail(detail, options);
   }
   /**
@@ -23400,14 +23402,25 @@ function printPlayCheckLimits(limits) {
     );
   }
 }
+function printScheduledPlayCapacity(capacity) {
+  if (!capacity) return;
+  console.log(
+    `  scheduled plays: ${capacity.used} / ${capacity.limit} active (${capacity.remaining} available)`
+  );
+  if (capacity.approachingLimit) {
+    console.log(
+      capacity.remaining === 0 ? "  warning: publishing a new schedule will be refused; updating this one does not consume another slot" : "  warning: this check does not reserve the final slot; publish remains the confirmation"
+    );
+  }
+}
 function formatPlayRuntimeLimit(runtimeLimit) {
   if (!runtimeLimit || !Number.isFinite(runtimeLimit.timeoutSeconds)) {
     return null;
   }
   const seconds = runtimeLimit.timeoutSeconds;
-  if (seconds % 3600 === 0) return `${seconds / 3600}h`;
-  if (seconds % 60 === 0) return `${seconds / 60}m`;
-  return `${seconds}s`;
+  if (seconds % 3600 === 0) return `${seconds / 3600} hours`;
+  if (seconds % 60 === 0) return `${seconds / 60} min`;
+  return `${seconds} sec`;
 }
 function isRecord10(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
@@ -23670,6 +23683,8 @@ async function handlePlayCheck(args) {
         inputSchema: play.inputSchema ?? null,
         outputSchema: play.outputSchema ?? null,
         staticPipeline: play.staticPipeline ?? null,
+        runtimeLimit: play.runtimeLimit ?? null,
+        activeScheduledPlays: play.activeScheduledPlays ?? null,
         note: "Named/prebuilt play contract is available. No run was started."
       };
       if (options.jsonOutput) {
@@ -23678,6 +23693,13 @@ async function handlePlayCheck(args) {
       } else {
         console.log(`\u2713 ${result.reference} passed named play contract check`);
         console.log("  no run started; no Deepline credits spent");
+        const runtimeLimit = formatPlayRuntimeLimit(result.runtimeLimit);
+        if (runtimeLimit) {
+          console.log(
+            `  Runtime limit: ${runtimeLimit} (${result.runtimeLimit?.source ?? "live"})`
+          );
+        }
+        printScheduledPlayCapacity(result.activeScheduledPlays);
         if (play.runCommand) console.log(`  run: ${play.runCommand}`);
       }
       return 0;
@@ -25194,6 +25216,13 @@ function printPlayDescription(play) {
   if (play.triggerStatus?.blockedReason) {
     console.log(`  Trigger issue: ${play.triggerStatus.blockedReason}`);
   }
+  const runtimeLimit = formatPlayRuntimeLimit(play.runtimeLimit);
+  if (runtimeLimit) {
+    console.log(
+      `  Runtime limit: ${runtimeLimit} (${play.runtimeLimit?.source ?? "live"})`
+    );
+  }
+  printScheduledPlayCapacity(play.activeScheduledPlays);
   console.log(`  Describe: deepline plays describe ${reference} --json`);
   console.log(`  Run: ${play.runCommand}`);
   const cloneEditStarter = play.cloneEditStarter ?? buildCloneEditStarter(play);

package/dist/cli/index.mjs

@@ -1028,7 +1028,7 @@ var SDK_RELEASE = {
   // 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.26",
+  version: "0.3.28",
   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: {
@@ -4814,7 +4814,9 @@ var DeeplineClient = class {
     return {
       ...this.summarizePlayListItem(play, options),
       currentPublishedVersion: play.currentPublishedVersion ?? play.liveRevision?.version ?? null,
-      latestRunId: play.latestRunId ?? detail.latestRuns[0]?.workflowId ?? null
+      latestRunId: play.latestRunId ?? detail.latestRuns[0]?.workflowId ?? null,
+      ...play.runtimeLimit ? { runtimeLimit: play.runtimeLimit } : {},
+      ...play.activeScheduledPlays ? { activeScheduledPlays: play.activeScheduledPlays } : {}
     };
   }
   // ——————————————————————————————————————————————————————————
@@ -6451,7 +6453,7 @@ var DeeplineClient = class {
    */
   async getPlay(name, options) {
     const encodedName = encodeURIComponent(name);
-    const query = options?.source ? `?include=source&revision=${encodeURIComponent(options.source)}` : "";
+    const query = options?.source ? `?include=source&revision=${encodeURIComponent(options.source)}` : options?.guidance ? "?include=guidance" : "";
     return this.http.get(`/api/v2/plays/${encodedName}${query}`);
   }
   /**
@@ -6461,7 +6463,7 @@ var DeeplineClient = class {
    * guidance, revision state, and latest run metadata when available.
    */
   async describePlay(name, options) {
-    const detail = await this.getPlay(name);
+    const detail = await this.getPlay(name, { guidance: true });
     return this.summarizePlayDetail(detail, options);
   }
   /**
@@ -23463,14 +23465,25 @@ function printPlayCheckLimits(limits) {
     );
   }
 }
+function printScheduledPlayCapacity(capacity) {
+  if (!capacity) return;
+  console.log(
+    `  scheduled plays: ${capacity.used} / ${capacity.limit} active (${capacity.remaining} available)`
+  );
+  if (capacity.approachingLimit) {
+    console.log(
+      capacity.remaining === 0 ? "  warning: publishing a new schedule will be refused; updating this one does not consume another slot" : "  warning: this check does not reserve the final slot; publish remains the confirmation"
+    );
+  }
+}
 function formatPlayRuntimeLimit(runtimeLimit) {
   if (!runtimeLimit || !Number.isFinite(runtimeLimit.timeoutSeconds)) {
     return null;
   }
   const seconds = runtimeLimit.timeoutSeconds;
-  if (seconds % 3600 === 0) return `${seconds / 3600}h`;
-  if (seconds % 60 === 0) return `${seconds / 60}m`;
-  return `${seconds}s`;
+  if (seconds % 3600 === 0) return `${seconds / 3600} hours`;
+  if (seconds % 60 === 0) return `${seconds / 60} min`;
+  return `${seconds} sec`;
 }
 function isRecord10(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
@@ -23733,6 +23746,8 @@ async function handlePlayCheck(args) {
         inputSchema: play.inputSchema ?? null,
         outputSchema: play.outputSchema ?? null,
         staticPipeline: play.staticPipeline ?? null,
+        runtimeLimit: play.runtimeLimit ?? null,
+        activeScheduledPlays: play.activeScheduledPlays ?? null,
         note: "Named/prebuilt play contract is available. No run was started."
       };
       if (options.jsonOutput) {
@@ -23741,6 +23756,13 @@ async function handlePlayCheck(args) {
       } else {
         console.log(`\u2713 ${result.reference} passed named play contract check`);
         console.log("  no run started; no Deepline credits spent");
+        const runtimeLimit = formatPlayRuntimeLimit(result.runtimeLimit);
+        if (runtimeLimit) {
+          console.log(
+            `  Runtime limit: ${runtimeLimit} (${result.runtimeLimit?.source ?? "live"})`
+          );
+        }
+        printScheduledPlayCapacity(result.activeScheduledPlays);
         if (play.runCommand) console.log(`  run: ${play.runCommand}`);
       }
       return 0;
@@ -25257,6 +25279,13 @@ function printPlayDescription(play) {
   if (play.triggerStatus?.blockedReason) {
     console.log(`  Trigger issue: ${play.triggerStatus.blockedReason}`);
   }
+  const runtimeLimit = formatPlayRuntimeLimit(play.runtimeLimit);
+  if (runtimeLimit) {
+    console.log(
+      `  Runtime limit: ${runtimeLimit} (${play.runtimeLimit?.source ?? "live"})`
+    );
+  }
+  printScheduledPlayCapacity(play.activeScheduledPlays);
   console.log(`  Describe: deepline plays describe ${reference} --json`);
   console.log(`  Run: ${play.runCommand}`);
   const cloneEditStarter = play.cloneEditStarter ?? buildCloneEditStarter(play);

package/dist/index.d.mts

@@ -1072,6 +1072,22 @@ interface PlayRevisionSummary {
     /** True when this is the newest saved working revision. */
     isWorking?: boolean;
 }
+/** Effective runtime limits stored with the selected immutable Play revision. */
+interface PlayRuntimeLimit {
+    timeoutSeconds: number;
+    memoryGiB: number;
+    cpu: number;
+    diskGiB: number;
+    /** `live` is what named runs execute; `working` is shown only before first publish. */
+    source: 'live' | 'working';
+}
+/** Read-only scheduled-Play capacity guidance for a Play with a cron trigger. */
+interface PlayScheduledCapacity {
+    used: number;
+    limit: number;
+    remaining: number;
+    approachingLimit: boolean;
+}
 /**
  * Aggregate row-processing stats for a play's sheet.
  */
@@ -1168,6 +1184,10 @@ interface PlayDefinitionDetail {
     liveRevision?: PlayRevisionSummary | null;
     /** `true` if the working revision differs from the live revision. */
     isDraftDirty?: boolean;
+    /** Effective sandbox limit from the live revision, or the working draft before first publish. */
+    runtimeLimit?: PlayRuntimeLimit | null;
+    /** Present for a Play with a cron trigger. Advisory only; publish remains authoritative. */
+    activeScheduledPlays?: PlayScheduledCapacity | null;
     /** Compatibility field for older readers. */
     currentPublishedVersion?: number | null;
 }
@@ -1292,6 +1312,10 @@ interface PlayDescription {
     };
     isDraftDirty?: boolean;
     latestRunId?: string | null;
+    /** Effective sandbox limit from the revision named runs use. */
+    runtimeLimit?: PlayRuntimeLimit | null;
+    /** Present for a Play with a cron trigger. Advisory only; publish remains authoritative. */
+    activeScheduledPlays?: PlayScheduledCapacity | null;
 }
 /**
  * Complete play detail including definition, recent runs, and sheet state.
@@ -3518,6 +3542,7 @@ declare class DeeplineClient {
      */
     getPlay(name: string, options?: {
         source?: 'working' | 'live' | `version:${number}`;
+        guidance?: boolean;
     }): Promise<PlayDetail>;
     /**
      * Get a normalized play description suitable for agents and CLIs.

package/dist/index.d.ts

@@ -1072,6 +1072,22 @@ interface PlayRevisionSummary {
     /** True when this is the newest saved working revision. */
     isWorking?: boolean;
 }
+/** Effective runtime limits stored with the selected immutable Play revision. */
+interface PlayRuntimeLimit {
+    timeoutSeconds: number;
+    memoryGiB: number;
+    cpu: number;
+    diskGiB: number;
+    /** `live` is what named runs execute; `working` is shown only before first publish. */
+    source: 'live' | 'working';
+}
+/** Read-only scheduled-Play capacity guidance for a Play with a cron trigger. */
+interface PlayScheduledCapacity {
+    used: number;
+    limit: number;
+    remaining: number;
+    approachingLimit: boolean;
+}
 /**
  * Aggregate row-processing stats for a play's sheet.
  */
@@ -1168,6 +1184,10 @@ interface PlayDefinitionDetail {
     liveRevision?: PlayRevisionSummary | null;
     /** `true` if the working revision differs from the live revision. */
     isDraftDirty?: boolean;
+    /** Effective sandbox limit from the live revision, or the working draft before first publish. */
+    runtimeLimit?: PlayRuntimeLimit | null;
+    /** Present for a Play with a cron trigger. Advisory only; publish remains authoritative. */
+    activeScheduledPlays?: PlayScheduledCapacity | null;
     /** Compatibility field for older readers. */
     currentPublishedVersion?: number | null;
 }
@@ -1292,6 +1312,10 @@ interface PlayDescription {
     };
     isDraftDirty?: boolean;
     latestRunId?: string | null;
+    /** Effective sandbox limit from the revision named runs use. */
+    runtimeLimit?: PlayRuntimeLimit | null;
+    /** Present for a Play with a cron trigger. Advisory only; publish remains authoritative. */
+    activeScheduledPlays?: PlayScheduledCapacity | null;
 }
 /**
  * Complete play detail including definition, recent runs, and sheet state.
@@ -3518,6 +3542,7 @@ declare class DeeplineClient {
      */
     getPlay(name: string, options?: {
         source?: 'working' | 'live' | `version:${number}`;
+        guidance?: boolean;
     }): Promise<PlayDetail>;
     /**
      * Get a normalized play description suitable for agents and CLIs.

package/dist/index.js

@@ -778,7 +778,7 @@ var SDK_RELEASE = {
   // 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.26",
+  version: "0.3.28",
   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: {
@@ -4530,7 +4530,9 @@ var DeeplineClient = class {
     return {
       ...this.summarizePlayListItem(play, options),
       currentPublishedVersion: play.currentPublishedVersion ?? play.liveRevision?.version ?? null,
-      latestRunId: play.latestRunId ?? detail.latestRuns[0]?.workflowId ?? null
+      latestRunId: play.latestRunId ?? detail.latestRuns[0]?.workflowId ?? null,
+      ...play.runtimeLimit ? { runtimeLimit: play.runtimeLimit } : {},
+      ...play.activeScheduledPlays ? { activeScheduledPlays: play.activeScheduledPlays } : {}
     };
   }
   // ——————————————————————————————————————————————————————————
@@ -6167,7 +6169,7 @@ var DeeplineClient = class {
    */
   async getPlay(name, options) {
     const encodedName = encodeURIComponent(name);
-    const query = options?.source ? `?include=source&revision=${encodeURIComponent(options.source)}` : "";
+    const query = options?.source ? `?include=source&revision=${encodeURIComponent(options.source)}` : options?.guidance ? "?include=guidance" : "";
     return this.http.get(`/api/v2/plays/${encodedName}${query}`);
   }
   /**
@@ -6177,7 +6179,7 @@ var DeeplineClient = class {
    * guidance, revision state, and latest run metadata when available.
    */
   async describePlay(name, options) {
-    const detail = await this.getPlay(name);
+    const detail = await this.getPlay(name, { guidance: true });
     return this.summarizePlayDetail(detail, options);
   }
   /**

package/dist/index.mjs

@@ -701,7 +701,7 @@ var SDK_RELEASE = {
   // 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.26",
+  version: "0.3.28",
   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: {
@@ -4453,7 +4453,9 @@ var DeeplineClient = class {
     return {
       ...this.summarizePlayListItem(play, options),
       currentPublishedVersion: play.currentPublishedVersion ?? play.liveRevision?.version ?? null,
-      latestRunId: play.latestRunId ?? detail.latestRuns[0]?.workflowId ?? null
+      latestRunId: play.latestRunId ?? detail.latestRuns[0]?.workflowId ?? null,
+      ...play.runtimeLimit ? { runtimeLimit: play.runtimeLimit } : {},
+      ...play.activeScheduledPlays ? { activeScheduledPlays: play.activeScheduledPlays } : {}
     };
   }
   // ——————————————————————————————————————————————————————————
@@ -6090,7 +6092,7 @@ var DeeplineClient = class {
    */
   async getPlay(name, options) {
     const encodedName = encodeURIComponent(name);
-    const query = options?.source ? `?include=source&revision=${encodeURIComponent(options.source)}` : "";
+    const query = options?.source ? `?include=source&revision=${encodeURIComponent(options.source)}` : options?.guidance ? "?include=guidance" : "";
     return this.http.get(`/api/v2/plays/${encodedName}${query}`);
   }
   /**
@@ -6100,7 +6102,7 @@ var DeeplineClient = class {
    * guidance, revision state, and latest run metadata when available.
    */
   async describePlay(name, options) {
-    const detail = await this.getPlay(name);
+    const detail = await this.getPlay(name, { guidance: true });
     return this.summarizePlayDetail(detail, options);
   }
   /**

package/package.json

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