deepline 0.1.78 → 0.1.80

package/dist/cli/index.js

@@ -229,10 +229,10 @@ var import_node_path2 = require("path");
 
 // src/release.ts
 var SDK_RELEASE = {
-  version: "0.1.78",
+  version: "0.1.80",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.78",
+    latest: "0.1.80",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }
@@ -869,6 +869,7 @@ var DeeplineClient = class {
       params.set("grep", options.grep.trim());
       params.set("grep_mode", options.grepMode ?? "all");
     }
+    params.set("compact", options?.compact === true ? "true" : "false");
     const suffix = params.toString() ? `?${params.toString()}` : "";
     const res = await this.http.get(
       `/api/v2/tools${suffix}`
@@ -1424,6 +1425,7 @@ var DeeplineClient = class {
     if (status) {
       params.set("status", status);
     }
+    params.set("compact", "true");
     const response = await this.http.get(
       `/api/v2/runs?${params.toString()}`
     );
@@ -1588,10 +1590,11 @@ var DeeplineClient = class {
    * @param name - Play name
    * @returns Version list (newest first)
    */
-  async listPlayVersions(name) {
+  async listPlayVersions(name, options) {
     const encodedName = encodeURIComponent(name);
+    const suffix = options?.full ? "?full=true" : "";
     const response = await this.http.get(
-      `/api/v2/plays/${encodedName}/versions`
+      `/api/v2/plays/${encodedName}/versions${suffix}`
     );
     return response.versions ?? [];
   }
@@ -2866,9 +2869,9 @@ function recentUsageLines(entries) {
   for (const entry of entries) {
     const op = `${humanize(entry.provider)} ${humanize(entry.operation)}`.trim();
     const charge = entry.billing_mode === "no_bill" ? "free" : `${entry.credits ?? 0} cr`;
-    const status = entry.status || "completed";
+    const state = entry.charge_state === "temporary_hold" ? "temporary hold, awaiting actual usage" : entry.status || "completed";
     lines.push(
-      `${op} | ${charge} | ${status} | ${entry.created_at || "unknown"}`
+      `${op} | ${charge} | ${state} | ${entry.created_at || "unknown"}`
     );
   }
   return lines;
@@ -2952,9 +2955,12 @@ async function handleUsage(options) {
   const usage = payload.usage ?? {};
   const quota = payload.quota ?? {};
   const recent = payload.recent ?? {};
+  const last30Usage = usage.last_30_days_usage_credits ?? usage.month_spent_credits;
+  const temporaryHolds = Number(usage.temporary_hold_credits ?? 0);
   const lines = [
     `Balance: ${payload.balance ?? "(unknown)"}`,
-    `Last 30 days spent: ${usage.month_spent_credits ?? "(unknown)"}`,
+    `Last 30 days usage: ${last30Usage ?? "(unknown)"}`,
+    ...Number.isFinite(temporaryHolds) && temporaryHolds > 0 ? [`Temporary holds: ${temporaryHolds}`] : [],
     `Monthly limit: ${quota.enabled ? quota.monthly_credits_limit ?? "(unknown)" : "off"}`,
     ...recentUsageLines(
       Array.isArray(recent.entries) ? recent.entries : []
@@ -4417,10 +4423,12 @@ function validatePlaySourceFilesHaveNoInlineSecrets(sourceFiles) {
   }
 }
 
-// ../shared_libs/plays/bundling/index.ts
-var PLAY_BUNDLE_CACHE_VERSION = 24;
+// ../shared_libs/plays/bundling/limits.ts
 var MAX_PLAY_BUNDLE_BYTES = 30 * 1024 * 1024;
 var MAX_ESM_WORKERS_BUNDLE_BYTES = 115e4;
+
+// ../shared_libs/plays/bundling/index.ts
+var PLAY_BUNDLE_CACHE_VERSION = 24;
 var PLAY_ARTIFACT_CACHE_DIR = (0, import_node_path8.join)(
   (0, import_node_os5.tmpdir)(),
   `deepline-play-artifacts-v${PLAY_BUNDLE_CACHE_VERSION}`
@@ -7734,7 +7742,6 @@ ${hint}`;
 }
 
 // src/cli/commands/play.ts
-var PLAY_START_STREAM_FAST_COMPLETION_WAIT_MS = 2500;
 var PLAY_RUN_RESERVED_BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
   "--json",
   "--wait",
@@ -8561,13 +8568,20 @@ async function waitForPlayCompletionByStream(input2) {
           progress: input2.progress
         });
       }
+      const finalStatus = getFinalStatusFromLiveEvent(event);
+      if (finalStatus) {
+        return input2.dashboardUrl ? { ...finalStatus, dashboardUrl: input2.dashboardUrl } : finalStatus;
+      }
       const status = getStatusFromLiveEvent(event);
       if (status && TERMINAL_PLAY_STATUSES2.has(status)) {
-        const finalStatus = await input2.client.getPlayStatus(input2.workflowId, {
-          billing: false
-        });
-        if (TERMINAL_PLAY_STATUSES2.has(finalStatus.status)) {
-          return input2.dashboardUrl ? { ...finalStatus, dashboardUrl: input2.dashboardUrl } : finalStatus;
+        const refreshedStatus = await input2.client.getPlayStatus(
+          input2.workflowId,
+          {
+            billing: false
+          }
+        );
+        if (TERMINAL_PLAY_STATUSES2.has(refreshedStatus.status)) {
+          return input2.dashboardUrl ? { ...refreshedStatus, dashboardUrl: input2.dashboardUrl } : refreshedStatus;
         }
       }
     }
@@ -8639,10 +8653,6 @@ async function startAndWaitForPlayCompletionByStreamOnce(input2) {
   let eventCount = 0;
   let firstRunIdMs = null;
   let lastPhase = null;
-  const startRequest = {
-    ...input2.request,
-    waitForCompletionMs: typeof input2.request.waitForCompletionMs === "number" ? input2.request.waitForCompletionMs : PLAY_START_STREAM_FAST_COMPLETION_WAIT_MS
-  };
   const timeout = input2.waitTimeoutMs === null ? null : setTimeout(
     () => {
       timedOut = true;
@@ -8651,7 +8661,7 @@ async function startAndWaitForPlayCompletionByStreamOnce(input2) {
     Math.max(1, input2.waitTimeoutMs)
   );
   try {
-    for await (const event of input2.client.startPlayRunStream(startRequest, {
+    for await (const event of input2.client.startPlayRunStream(input2.request, {
       signal: controller.signal
     })) {
       eventCount += 1;
@@ -9612,7 +9622,7 @@ function writePlayResult(status, jsonOutput, options) {
   );
 }
 async function resolvePlayRunOutputStatus(input2) {
-  if (!getPlayRunPackage(input2.status)) {
+  if (!input2.fullJson || !getPlayRunPackage(input2.status)) {
     return input2.status;
   }
   const runId = input2.status.runId;
@@ -10829,7 +10839,7 @@ async function handleRunsList(args) {
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
     if ((arg === "--play" || arg === "--name") && args[index + 1]) {
-      playName = parseReferencedPlayTarget2(args[++index]).playName;
+      playName = args[++index].trim();
       continue;
     }
     if (arg === "--status" && args[index + 1]) {
@@ -11218,7 +11228,7 @@ async function handlePlayList(args) {
     const reference = formatPlayListReference(play);
     process.stdout.write(`  ${reference}${flags ? ` [${flags}]` : ""}
 `);
-    if (play.inputSchema) {
+    if (play.inputSchema || play.hasInputSchema) {
       process.stdout.write("    inputSchema: yes\n");
     }
     process.stdout.write(`    run: deepline plays run ${reference} --watch
@@ -11571,22 +11581,42 @@ async function handlePlayPublish(args) {
     }
     let graph;
     try {
-      graph = await collectBundledPlayGraph((0, import_node_path12.resolve)(playName));
-      await compileBundledPlayGraphManifests(client, graph);
-      await publishImportedPlayDependencies(client, graph);
+      graph = await traceCliSpan(
+        "cli.play_publish_bundle_graph",
+        { targetKind: "file" },
+        () => collectBundledPlayGraph((0, import_node_path12.resolve)(playName))
+      );
+      await traceCliSpan(
+        "cli.play_publish_compile_manifests",
+        { targetKind: "file", nodeCount: graph.nodes.size },
+        () => compileBundledPlayGraphManifests(client, graph)
+      );
+      await traceCliSpan(
+        "cli.play_publish_imports",
+        { targetKind: "file", nodeCount: graph.nodes.size },
+        () => publishImportedPlayDependencies(client, graph)
+      );
     } catch (error) {
       console.error(error instanceof Error ? error.message : String(error));
       return 1;
     }
     const rootPlayName = graph.root.playName ?? extractPlayName(graph.root.sourceCode, graph.root.filePath);
-    const published = await client.registerPlayArtifact({
-      name: rootPlayName,
-      sourceCode: graph.root.sourceCode,
-      sourceFiles: graph.root.sourceFiles,
-      artifact: graph.root.artifact,
-      compilerManifest: requireCompilerManifest(graph.root),
-      publish: true
-    });
+    const published = await traceCliSpan(
+      "cli.play_publish_register_root",
+      {
+        targetKind: "file",
+        playName: rootPlayName,
+        artifactHash: graph.root.artifact.artifactHash
+      },
+      () => client.registerPlayArtifact({
+        name: rootPlayName,
+        sourceCode: graph.root.sourceCode,
+        sourceFiles: graph.root.sourceFiles,
+        artifact: graph.root.artifact,
+        compilerManifest: requireCompilerManifest(graph.root),
+        publish: true
+      })
+    );
     process.stdout.write(
       `${JSON.stringify({
         success: true,
@@ -14043,10 +14073,11 @@ async function listTools(args) {
   const client = new DeeplineClient();
   const categoryArgIndex = args.findIndex((arg) => arg === "--categories");
   const categoryFilter = categoryArgIndex >= 0 ? args[categoryArgIndex + 1] : "";
-  const compact = args.includes("--compact") || !args.includes("--json");
+  const compact = !args.includes("--full");
   const requestedCategories = categoryFilter ? categoryFilter.split(",").map((item) => item.trim()).filter(Boolean) : [];
   const items = (await client.listTools({
-    ...categoryFilter ? { categories: categoryFilter } : {}
+    ...categoryFilter ? { categories: categoryFilter } : {},
+    compact
   })).map(toListedTool).filter(
     (item) => requestedCategories.length === 0 || requestedCategories.some(
       (category) => item.categories.includes(category)
@@ -14121,7 +14152,8 @@ async function grepTools(queryInput, options = {}) {
   const tools = (await client.listTools({
     grep: query,
     grepMode: mode,
-    ...options.categories ? { categories: options.categories } : {}
+    ...options.categories ? { categories: options.categories } : {},
+    compact: options.compact ?? true
   })).map(toListedTool).filter(
     (item) => requestedCategories.length === 0 || requestedCategories.some(
       (category) => item.categories.includes(category)

package/dist/cli/index.mjs

@@ -206,10 +206,10 @@ import { join as join2 } from "path";
 
 // src/release.ts
 var SDK_RELEASE = {
-  version: "0.1.78",
+  version: "0.1.80",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.78",
+    latest: "0.1.80",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53"
   }
@@ -846,6 +846,7 @@ var DeeplineClient = class {
       params.set("grep", options.grep.trim());
       params.set("grep_mode", options.grepMode ?? "all");
     }
+    params.set("compact", options?.compact === true ? "true" : "false");
     const suffix = params.toString() ? `?${params.toString()}` : "";
     const res = await this.http.get(
       `/api/v2/tools${suffix}`
@@ -1401,6 +1402,7 @@ var DeeplineClient = class {
     if (status) {
       params.set("status", status);
     }
+    params.set("compact", "true");
     const response = await this.http.get(
       `/api/v2/runs?${params.toString()}`
     );
@@ -1565,10 +1567,11 @@ var DeeplineClient = class {
    * @param name - Play name
    * @returns Version list (newest first)
    */
-  async listPlayVersions(name) {
+  async listPlayVersions(name, options) {
     const encodedName = encodeURIComponent(name);
+    const suffix = options?.full ? "?full=true" : "";
     const response = await this.http.get(
-      `/api/v2/plays/${encodedName}/versions`
+      `/api/v2/plays/${encodedName}/versions${suffix}`
     );
     return response.versions ?? [];
   }
@@ -2849,9 +2852,9 @@ function recentUsageLines(entries) {
   for (const entry of entries) {
     const op = `${humanize(entry.provider)} ${humanize(entry.operation)}`.trim();
     const charge = entry.billing_mode === "no_bill" ? "free" : `${entry.credits ?? 0} cr`;
-    const status = entry.status || "completed";
+    const state = entry.charge_state === "temporary_hold" ? "temporary hold, awaiting actual usage" : entry.status || "completed";
     lines.push(
-      `${op} | ${charge} | ${status} | ${entry.created_at || "unknown"}`
+      `${op} | ${charge} | ${state} | ${entry.created_at || "unknown"}`
     );
   }
   return lines;
@@ -2935,9 +2938,12 @@ async function handleUsage(options) {
   const usage = payload.usage ?? {};
   const quota = payload.quota ?? {};
   const recent = payload.recent ?? {};
+  const last30Usage = usage.last_30_days_usage_credits ?? usage.month_spent_credits;
+  const temporaryHolds = Number(usage.temporary_hold_credits ?? 0);
   const lines = [
     `Balance: ${payload.balance ?? "(unknown)"}`,
-    `Last 30 days spent: ${usage.month_spent_credits ?? "(unknown)"}`,
+    `Last 30 days usage: ${last30Usage ?? "(unknown)"}`,
+    ...Number.isFinite(temporaryHolds) && temporaryHolds > 0 ? [`Temporary holds: ${temporaryHolds}`] : [],
     `Monthly limit: ${quota.enabled ? quota.monthly_credits_limit ?? "(unknown)" : "off"}`,
     ...recentUsageLines(
       Array.isArray(recent.entries) ? recent.entries : []
@@ -4413,10 +4419,12 @@ function validatePlaySourceFilesHaveNoInlineSecrets(sourceFiles) {
   }
 }
 
-// ../shared_libs/plays/bundling/index.ts
-var PLAY_BUNDLE_CACHE_VERSION = 24;
+// ../shared_libs/plays/bundling/limits.ts
 var MAX_PLAY_BUNDLE_BYTES = 30 * 1024 * 1024;
 var MAX_ESM_WORKERS_BUNDLE_BYTES = 115e4;
+
+// ../shared_libs/plays/bundling/index.ts
+var PLAY_BUNDLE_CACHE_VERSION = 24;
 var PLAY_ARTIFACT_CACHE_DIR = join4(
   tmpdir(),
   `deepline-play-artifacts-v${PLAY_BUNDLE_CACHE_VERSION}`
@@ -7737,7 +7745,6 @@ ${hint}`;
 }
 
 // src/cli/commands/play.ts
-var PLAY_START_STREAM_FAST_COMPLETION_WAIT_MS = 2500;
 var PLAY_RUN_RESERVED_BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
   "--json",
   "--wait",
@@ -8564,13 +8571,20 @@ async function waitForPlayCompletionByStream(input2) {
           progress: input2.progress
         });
       }
+      const finalStatus = getFinalStatusFromLiveEvent(event);
+      if (finalStatus) {
+        return input2.dashboardUrl ? { ...finalStatus, dashboardUrl: input2.dashboardUrl } : finalStatus;
+      }
       const status = getStatusFromLiveEvent(event);
       if (status && TERMINAL_PLAY_STATUSES2.has(status)) {
-        const finalStatus = await input2.client.getPlayStatus(input2.workflowId, {
-          billing: false
-        });
-        if (TERMINAL_PLAY_STATUSES2.has(finalStatus.status)) {
-          return input2.dashboardUrl ? { ...finalStatus, dashboardUrl: input2.dashboardUrl } : finalStatus;
+        const refreshedStatus = await input2.client.getPlayStatus(
+          input2.workflowId,
+          {
+            billing: false
+          }
+        );
+        if (TERMINAL_PLAY_STATUSES2.has(refreshedStatus.status)) {
+          return input2.dashboardUrl ? { ...refreshedStatus, dashboardUrl: input2.dashboardUrl } : refreshedStatus;
         }
       }
     }
@@ -8642,10 +8656,6 @@ async function startAndWaitForPlayCompletionByStreamOnce(input2) {
   let eventCount = 0;
   let firstRunIdMs = null;
   let lastPhase = null;
-  const startRequest = {
-    ...input2.request,
-    waitForCompletionMs: typeof input2.request.waitForCompletionMs === "number" ? input2.request.waitForCompletionMs : PLAY_START_STREAM_FAST_COMPLETION_WAIT_MS
-  };
   const timeout = input2.waitTimeoutMs === null ? null : setTimeout(
     () => {
       timedOut = true;
@@ -8654,7 +8664,7 @@ async function startAndWaitForPlayCompletionByStreamOnce(input2) {
     Math.max(1, input2.waitTimeoutMs)
   );
   try {
-    for await (const event of input2.client.startPlayRunStream(startRequest, {
+    for await (const event of input2.client.startPlayRunStream(input2.request, {
       signal: controller.signal
     })) {
       eventCount += 1;
@@ -9615,7 +9625,7 @@ function writePlayResult(status, jsonOutput, options) {
   );
 }
 async function resolvePlayRunOutputStatus(input2) {
-  if (!getPlayRunPackage(input2.status)) {
+  if (!input2.fullJson || !getPlayRunPackage(input2.status)) {
     return input2.status;
   }
   const runId = input2.status.runId;
@@ -10832,7 +10842,7 @@ async function handleRunsList(args) {
   for (let index = 0; index < args.length; index += 1) {
     const arg = args[index];
     if ((arg === "--play" || arg === "--name") && args[index + 1]) {
-      playName = parseReferencedPlayTarget2(args[++index]).playName;
+      playName = args[++index].trim();
       continue;
     }
     if (arg === "--status" && args[index + 1]) {
@@ -11221,7 +11231,7 @@ async function handlePlayList(args) {
     const reference = formatPlayListReference(play);
     process.stdout.write(`  ${reference}${flags ? ` [${flags}]` : ""}
 `);
-    if (play.inputSchema) {
+    if (play.inputSchema || play.hasInputSchema) {
       process.stdout.write("    inputSchema: yes\n");
     }
     process.stdout.write(`    run: deepline plays run ${reference} --watch
@@ -11574,22 +11584,42 @@ async function handlePlayPublish(args) {
     }
     let graph;
     try {
-      graph = await collectBundledPlayGraph(resolve10(playName));
-      await compileBundledPlayGraphManifests(client, graph);
-      await publishImportedPlayDependencies(client, graph);
+      graph = await traceCliSpan(
+        "cli.play_publish_bundle_graph",
+        { targetKind: "file" },
+        () => collectBundledPlayGraph(resolve10(playName))
+      );
+      await traceCliSpan(
+        "cli.play_publish_compile_manifests",
+        { targetKind: "file", nodeCount: graph.nodes.size },
+        () => compileBundledPlayGraphManifests(client, graph)
+      );
+      await traceCliSpan(
+        "cli.play_publish_imports",
+        { targetKind: "file", nodeCount: graph.nodes.size },
+        () => publishImportedPlayDependencies(client, graph)
+      );
     } catch (error) {
       console.error(error instanceof Error ? error.message : String(error));
       return 1;
     }
     const rootPlayName = graph.root.playName ?? extractPlayName(graph.root.sourceCode, graph.root.filePath);
-    const published = await client.registerPlayArtifact({
-      name: rootPlayName,
-      sourceCode: graph.root.sourceCode,
-      sourceFiles: graph.root.sourceFiles,
-      artifact: graph.root.artifact,
-      compilerManifest: requireCompilerManifest(graph.root),
-      publish: true
-    });
+    const published = await traceCliSpan(
+      "cli.play_publish_register_root",
+      {
+        targetKind: "file",
+        playName: rootPlayName,
+        artifactHash: graph.root.artifact.artifactHash
+      },
+      () => client.registerPlayArtifact({
+        name: rootPlayName,
+        sourceCode: graph.root.sourceCode,
+        sourceFiles: graph.root.sourceFiles,
+        artifact: graph.root.artifact,
+        compilerManifest: requireCompilerManifest(graph.root),
+        publish: true
+      })
+    );
     process.stdout.write(
       `${JSON.stringify({
         success: true,
@@ -14046,10 +14076,11 @@ async function listTools(args) {
   const client = new DeeplineClient();
   const categoryArgIndex = args.findIndex((arg) => arg === "--categories");
   const categoryFilter = categoryArgIndex >= 0 ? args[categoryArgIndex + 1] : "";
-  const compact = args.includes("--compact") || !args.includes("--json");
+  const compact = !args.includes("--full");
   const requestedCategories = categoryFilter ? categoryFilter.split(",").map((item) => item.trim()).filter(Boolean) : [];
   const items = (await client.listTools({
-    ...categoryFilter ? { categories: categoryFilter } : {}
+    ...categoryFilter ? { categories: categoryFilter } : {},
+    compact
   })).map(toListedTool).filter(
     (item) => requestedCategories.length === 0 || requestedCategories.some(
       (category) => item.categories.includes(category)
@@ -14124,7 +14155,8 @@ async function grepTools(queryInput, options = {}) {
   const tools = (await client.listTools({
     grep: query,
     grepMode: mode,
-    ...options.categories ? { categories: options.categories } : {}
+    ...options.categories ? { categories: options.categories } : {},
+    compact: options.compact ?? true
   })).map(toListedTool).filter(
     (item) => requestedCategories.length === 0 || requestedCategories.some(
       (category) => item.categories.includes(category)

package/dist/index.d.mts

@@ -16,6 +16,7 @@ type PlayArtifactKind = (typeof PLAY_ARTIFACT_KINDS)[keyof typeof PLAY_ARTIFACT_
 interface PlayStaticPipelineSnapshot {
     tableNamespace?: string;
     inputFields?: string[];
+    rowKeyFields?: string[];
     csvArg?: string;
     hasInlineData?: boolean;
     csvDescription?: string;
@@ -39,11 +40,30 @@ interface PlaySheetColumnContractSnapshot {
     outputSqlName?: string;
     stepId?: string;
     toolId?: string;
+    isRowKey?: boolean;
 }
 interface PlaySheetContractSnapshot {
     tableNamespace: string;
     columns: PlaySheetColumnContractSnapshot[];
 }
+type PlayStaticColumnProducerKindSnapshot = 'tool' | 'waterfall' | 'stepProgram' | 'playCall' | 'transform';
+interface PlayStaticColumnProducerSnapshot {
+    id: string;
+    kind: PlayStaticColumnProducerKindSnapshot;
+    field: string;
+    toolId?: string;
+    playId?: string;
+    conditional?: boolean;
+    sourceRange?: PlayStaticSourceRangeSnapshot;
+    steps?: PlayStaticColumnProducerSnapshot[];
+    substep: PlayStaticSubstepSnapshot;
+}
+interface PlayStaticDatasetColumnSnapshot {
+    id: string;
+    source: PlaySheetColumnSourceSnapshot;
+    sqlName?: string;
+    producers: PlayStaticColumnProducerSnapshot[];
+}
 interface PlayStaticSourceRangeSnapshot {
     sourcePath?: string;
     startLine: number;
@@ -68,8 +88,11 @@ type PlayStaticSubstepSnapshot = PlayStaticSubstepMetadataSnapshot & ({
     name?: string;
     tableNamespace?: string;
     inputFields?: string[];
+    rowKeyFields?: string[];
     outputFields?: string[];
+    columns?: PlayStaticDatasetColumnSnapshot[];
     waterfallIds?: string[];
+    steps?: PlayStaticSubstepSnapshot[];
     sheetContract?: PlaySheetContractSnapshot | null;
     description?: string;
     sourceRange?: PlayStaticSourceRangeSnapshot;
@@ -282,6 +305,10 @@ interface ToolDefinition {
     operationId?: string;
     /** Alternative names that resolve to this tool. */
     operationAliases?: string[];
+    /** Whether detailed input schema is available from `tools describe`. */
+    hasInputSchema?: boolean;
+    /** Whether detailed output schema is available from `tools describe`. */
+    hasOutputSchema?: boolean;
     /** JSON Schema describing the tool's input parameters. */
     inputSchema?: Record<string, unknown>;
     /** JSON Schema describing the tool's output shape. */
@@ -773,6 +800,7 @@ interface PlayListItem {
     currentPublishedVersion?: number | null;
     tableNamespace?: string | null;
     isDraftDirty?: boolean;
+    hasInputSchema?: boolean;
     inputSchema?: Record<string, unknown> | null;
     outputSchema?: Record<string, unknown> | null;
     staticPipeline?: unknown;
@@ -1240,6 +1268,7 @@ declare class DeeplineClient {
         categories?: string;
         grep?: string;
         grepMode?: 'all' | 'any' | 'phrase';
+        compact?: boolean;
     }): Promise<ToolDefinition[]>;
     /**
      * Search available tools using Deepline's ranked backend search.
@@ -1653,7 +1682,9 @@ declare class DeeplineClient {
      * @param name - Play name
      * @returns Version list (newest first)
      */
-    listPlayVersions(name: string): Promise<PlayRevisionSummary[]>;
+    listPlayVersions(name: string, options?: {
+        full?: boolean;
+    }): Promise<PlayRevisionSummary[]>;
     /**
      * Make a play revision live.
      *

package/dist/index.d.ts

@@ -16,6 +16,7 @@ type PlayArtifactKind = (typeof PLAY_ARTIFACT_KINDS)[keyof typeof PLAY_ARTIFACT_
 interface PlayStaticPipelineSnapshot {
     tableNamespace?: string;
     inputFields?: string[];
+    rowKeyFields?: string[];
     csvArg?: string;
     hasInlineData?: boolean;
     csvDescription?: string;
@@ -39,11 +40,30 @@ interface PlaySheetColumnContractSnapshot {
     outputSqlName?: string;
     stepId?: string;
     toolId?: string;
+    isRowKey?: boolean;
 }
 interface PlaySheetContractSnapshot {
     tableNamespace: string;
     columns: PlaySheetColumnContractSnapshot[];
 }
+type PlayStaticColumnProducerKindSnapshot = 'tool' | 'waterfall' | 'stepProgram' | 'playCall' | 'transform';
+interface PlayStaticColumnProducerSnapshot {
+    id: string;
+    kind: PlayStaticColumnProducerKindSnapshot;
+    field: string;
+    toolId?: string;
+    playId?: string;
+    conditional?: boolean;
+    sourceRange?: PlayStaticSourceRangeSnapshot;
+    steps?: PlayStaticColumnProducerSnapshot[];
+    substep: PlayStaticSubstepSnapshot;
+}
+interface PlayStaticDatasetColumnSnapshot {
+    id: string;
+    source: PlaySheetColumnSourceSnapshot;
+    sqlName?: string;
+    producers: PlayStaticColumnProducerSnapshot[];
+}
 interface PlayStaticSourceRangeSnapshot {
     sourcePath?: string;
     startLine: number;
@@ -68,8 +88,11 @@ type PlayStaticSubstepSnapshot = PlayStaticSubstepMetadataSnapshot & ({
     name?: string;
     tableNamespace?: string;
     inputFields?: string[];
+    rowKeyFields?: string[];
     outputFields?: string[];
+    columns?: PlayStaticDatasetColumnSnapshot[];
     waterfallIds?: string[];
+    steps?: PlayStaticSubstepSnapshot[];
     sheetContract?: PlaySheetContractSnapshot | null;
     description?: string;
     sourceRange?: PlayStaticSourceRangeSnapshot;
@@ -282,6 +305,10 @@ interface ToolDefinition {
     operationId?: string;
     /** Alternative names that resolve to this tool. */
     operationAliases?: string[];
+    /** Whether detailed input schema is available from `tools describe`. */
+    hasInputSchema?: boolean;
+    /** Whether detailed output schema is available from `tools describe`. */
+    hasOutputSchema?: boolean;
     /** JSON Schema describing the tool's input parameters. */
     inputSchema?: Record<string, unknown>;
     /** JSON Schema describing the tool's output shape. */
@@ -773,6 +800,7 @@ interface PlayListItem {
     currentPublishedVersion?: number | null;
     tableNamespace?: string | null;
     isDraftDirty?: boolean;
+    hasInputSchema?: boolean;
     inputSchema?: Record<string, unknown> | null;
     outputSchema?: Record<string, unknown> | null;
     staticPipeline?: unknown;
@@ -1240,6 +1268,7 @@ declare class DeeplineClient {
         categories?: string;
         grep?: string;
         grepMode?: 'all' | 'any' | 'phrase';
+        compact?: boolean;
     }): Promise<ToolDefinition[]>;
     /**
      * Search available tools using Deepline's ranked backend search.
@@ -1653,7 +1682,9 @@ declare class DeeplineClient {
      * @param name - Play name
      * @returns Version list (newest first)
      */
-    listPlayVersions(name: string): Promise<PlayRevisionSummary[]>;
+    listPlayVersions(name: string, options?: {
+        full?: boolean;
+    }): Promise<PlayRevisionSummary[]>;
     /**
      * Make a play revision live.
      *