deepline 0.3.394 → 0.3.395

package/dist/cli/{chunk-CS6RAIVY.js → chunk-56IFFVIB.js}

@@ -14,7 +14,7 @@ var _chunkXNYIZMNQjs = require('./chunk-XNYIZMNQ.js');
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
 
 
-var _chunk6YAUMG27js = require('./chunk-6YAUMG27.js');
+var _chunkTO2MWPGRjs = require('./chunk-TO2MWPGR.js');
 
 // src/errors.ts
 var CustomerDbQueryOutcomeUnknownError = (_class = class extends _chunk7P5AA3SNjs.DeeplineError {
@@ -744,9 +744,9 @@ function resolveCliCommandContext(inputConfig, requestedScope) {
 }
 
 // src/version.ts
-var SDK_VERSION = _chunk6YAUMG27js.SDK_RELEASE.version;
-var SDK_API_MAJOR = _chunk6YAUMG27js.SDK_RELEASE.contracts.api.currentMajor;
-var SDK_API_CONTRACT = _nullishCoalesce(_chunk6YAUMG27js.SDK_RELEASE.contracts.api.legacyWireIds[0], () => ( `api-v${SDK_API_MAJOR}`));
+var SDK_VERSION = _chunkTO2MWPGRjs.SDK_RELEASE.version;
+var SDK_API_MAJOR = _chunkTO2MWPGRjs.SDK_RELEASE.contracts.api.currentMajor;
+var SDK_API_CONTRACT = _nullishCoalesce(_chunkTO2MWPGRjs.SDK_RELEASE.contracts.api.legacyWireIds[0], () => ( `api-v${SDK_API_MAJOR}`));
 
 // src/agent-runtime.ts
 

package/dist/cli/chunk-5VCZ3WRH.mjs

@@ -0,0 +1,129 @@
+// src/csv-header-matching.ts
+var CSV_HEADER_MATCHING_NOTE = 'A header matches a column when it equals the column name or its default header, ignoring case, spaces and punctuation: LINKEDIN_URL, linkedin-url and "Linkedin Url" all match linkedin_url. A capital inside a word starts a new word, so "LinkedIn URL" reads as linked_in_url and does not match. Map any other header in the input: {"csv":"<path>","columns":{"<column>":"<your header>"}}.';
+
+// src/plays/input-example.ts
+function playInputExampleArgs(schema) {
+  if (!schema) return " --input '@<input.json>'";
+  if (schema.$ref || schema.allOf) return " --input '@<input.json>'";
+  const csv = schema.csvInput;
+  const csvField = typeof csv?.inputField === "string" ? csv.inputField : null;
+  const required = Array.isArray(schema.required) ? schema.required : [];
+  const csvOnlyRequired = required.every((key) => key === csvField);
+  const alternatives = schema.oneOf ?? schema.anyOf;
+  const hasCsvAlternative = Array.isArray(alternatives) && alternatives.some((branch) => {
+    if (!branch || typeof branch !== "object") return false;
+    const keys = branch.required;
+    return Array.isArray(keys) && keys.includes(csvField) && keys.every((key) => key === csvField);
+  });
+  if (csvField && csvOnlyRequired && (!alternatives || hasCsvAlternative)) {
+    if (csvField === "csv") return " --csv '<contacts.csv>'";
+    const value = JSON.stringify({ [csvField]: "<contacts.csv>" });
+    return ` --input '${value.replace(/'/g, "'\\''")}'`;
+  }
+  if (Array.isArray(schema.required) && !required.length && !csv && !alternatives) {
+    return "";
+  }
+  return " --input '@<input.json>'";
+}
+
+// src/plays/play-description.ts
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function compactSchema(schema) {
+  if (!schema) return null;
+  const fields = Array.isArray(schema.fields) ? schema.fields.map(
+    (field) => isRecord(field) ? {
+      name: String(field.name ?? ""),
+      type: field.type ?? void 0,
+      required: field.required ?? void 0
+    } : null
+  ).filter((field) => Boolean(field?.name)) : [];
+  return fields.length > 0 ? { fields } : schema;
+}
+function schemaMetadata(schema, key) {
+  const value = isRecord(schema) ? schema[key] : null;
+  return isRecord(value) ? value : null;
+}
+function starterPlayPath(play) {
+  const target = play.reference || play.name;
+  const unqualifiedName = target.split("/").pop() || play.name;
+  const safeName = unqualifiedName.trim().toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  return `./${safeName || "play"}.play.ts`;
+}
+function cloneEditStarter(play) {
+  const readonlyPrebuilt = (play.origin === "prebuilt" || play.ownerType === "deepline") && !play.canEdit;
+  if (!play.canClone && !readonlyPrebuilt) return void 0;
+  const target = play.reference || play.name;
+  const path = starterPlayPath(play);
+  return {
+    path,
+    command: `deepline plays get ${target} --source --out ${path}`,
+    checkCommand: `deepline plays check ${path}`
+  };
+}
+function staticPipeline(play) {
+  return isRecord(play.staticPipeline) ? play.staticPipeline : isRecord(play.currentRevision?.staticPipeline) ? play.currentRevision.staticPipeline : isRecord(play.liveRevision?.staticPipeline) ? play.liveRevision.staticPipeline : null;
+}
+function describePlayListItem(play, options = {}) {
+  const aliases = play.aliases?.length ? play.aliases : [play.name];
+  const csvInput = schemaMetadata(play.inputSchema, "csvInput");
+  const rowOutputSchema = schemaMetadata(play.outputSchema, "rowOutputSchema");
+  const description = play.description?.trim() || play.currentRevision?.description?.trim() || play.liveRevision?.description?.trim() || null;
+  const runCommand = `deepline plays run ${play.reference || play.name}${playInputExampleArgs(play.inputSchema)}`;
+  const starter = cloneEditStarter(play);
+  return {
+    name: play.name,
+    // playKey and triggerStatus were projected away here, so `describe`
+    // was strictly less informative than `plays list` for the same play — no
+    // stable key, and no way to see that a cron was armed.
+    ...play.playKey ? { playKey: play.playKey } : {},
+    ...play.reference ? { reference: play.reference } : {},
+    ...play.displayName ? { displayName: play.displayName } : {},
+    ...description ? { description } : {},
+    ...play.guidance ? { guidance: play.guidance } : {},
+    pinned: Boolean(play.pinned),
+    toolCategories: play.toolCategories ?? [],
+    origin: play.origin,
+    ownerType: play.ownerType,
+    canEdit: play.canEdit,
+    canClone: play.canClone,
+    aliases,
+    inputSchema: options.compact ? compactSchema(play.inputSchema) : play.inputSchema ?? null,
+    outputSchema: options.compact ? compactSchema(play.outputSchema) : play.outputSchema ?? null,
+    ...options.pipeline ? { staticPipeline: staticPipeline(play) } : {},
+    ...csvInput ? {
+      csvInput: { ...csvInput, headerMatching: CSV_HEADER_MATCHING_NOTE }
+    } : {},
+    ...rowOutputSchema ? { rowOutputSchema } : {},
+    runCommand,
+    examples: [runCommand],
+    ...starter ? { cloneEditStarter: starter } : {},
+    currentPublishedVersion: play.currentPublishedVersion ?? null,
+    // Read the live version off the live revision. It was previously only
+    // ever written by the publish/live routes, so every list and describe
+    // payload reported liveVersion: null even for an actively serving play.
+    liveVersion: play.liveRevision?.version ?? null,
+    ...play.triggerStatus ? { triggerStatus: play.triggerStatus } : {},
+    isDraftDirty: play.isDraftDirty
+  };
+}
+function describePlayDetail(detail, options = {}) {
+  const play = detail.play;
+  return {
+    ...describePlayListItem(play, options),
+    currentPublishedVersion: play.currentPublishedVersion ?? play.liveRevision?.version ?? null,
+    latestRunId: play.latestRunId ?? detail.latestRuns[0]?.workflowId ?? null,
+    ...play.triggerMetadata ? { triggerMetadata: play.triggerMetadata } : {},
+    ...play.runtimeLimit ? { runtimeLimit: play.runtimeLimit } : {},
+    ...play.activeScheduledPlays ? { activeScheduledPlays: play.activeScheduledPlays } : {},
+    ...play.observedCost ? { observedCost: play.observedCost } : {}
+  };
+}
+
+export {
+  CSV_HEADER_MATCHING_NOTE,
+  playInputExampleArgs,
+  describePlayListItem,
+  describePlayDetail
+};

package/dist/cli/{chunk-FJGW5GXU.mjs → chunk-6D7A2FSL.mjs}

@@ -14,7 +14,7 @@ import {
 } from "./chunk-NXGCO4JB.mjs";
 import {
   SDK_RELEASE
-} from "./chunk-TJI2EN6K.mjs";
+} from "./chunk-BON3DRC6.mjs";
 
 // src/errors.ts
 var CustomerDbQueryOutcomeUnknownError = class extends DeeplineError {

package/dist/cli/{chunk-X63FDZJZ.mjs → chunk-7MVWUXOD.mjs}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-GAMFK2ZP.mjs";
 import {
   printCommandEnvelope
-} from "./chunk-NR3DFKNF.mjs";
+} from "./chunk-47M6HPGP.mjs";
 import {
   DEFAULT_SKILL_AGENTS,
   KNOWN_SKILL_AGENTS,
@@ -22,13 +22,13 @@ import {
   sdkCliStateDirPath,
   skillsAgentPathSegment,
   writeSdkSkillsLocalVersion
-} from "./chunk-FJGW5GXU.mjs";
+} from "./chunk-6D7A2FSL.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
 import {
   SDK_RELEASE
-} from "./chunk-TJI2EN6K.mjs";
+} from "./chunk-BON3DRC6.mjs";
 
 // src/cli/commands/skills.ts
 import { spawn as spawn2 } from "child_process";

package/dist/cli/{chunk-ZYBGA4AR.mjs → chunk-7XAM7KDW.mjs}

@@ -1,14 +1,14 @@
 import {
   DeeplineClient
-} from "./chunk-JHIJIHFB.mjs";
+} from "./chunk-G4IWGRMK.mjs";
 import {
   printCommandEnvelope,
   renderCommandEnvelopeText
-} from "./chunk-NR3DFKNF.mjs";
+} from "./chunk-47M6HPGP.mjs";
 import {
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-FJGW5GXU.mjs";
+} from "./chunk-6D7A2FSL.mjs";
 
 // src/cli/commands/search.ts
 import { Option } from "commander";

package/dist/cli/{chunk-BP33SIZF.mjs → chunk-BLYL3KOC.mjs}

@@ -1,6 +1,6 @@
 import {
   resolveShellSpawn
-} from "./chunk-X63FDZJZ.mjs";
+} from "./chunk-7MVWUXOD.mjs";
 
 // src/cli/npm-script-policy.ts
 import { spawnSync } from "child_process";

package/dist/cli/{chunk-TJI2EN6K.mjs → chunk-BON3DRC6.mjs}

@@ -49,7 +49,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.394",
+  version: "0.3.395",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1,

package/dist/cli/chunk-DRM3CMHL.js

@@ -0,0 +1,129 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/csv-header-matching.ts
+var CSV_HEADER_MATCHING_NOTE = 'A header matches a column when it equals the column name or its default header, ignoring case, spaces and punctuation: LINKEDIN_URL, linkedin-url and "Linkedin Url" all match linkedin_url. A capital inside a word starts a new word, so "LinkedIn URL" reads as linked_in_url and does not match. Map any other header in the input: {"csv":"<path>","columns":{"<column>":"<your header>"}}.';
+
+// src/plays/input-example.ts
+function playInputExampleArgs(schema) {
+  if (!schema) return " --input '@<input.json>'";
+  if (schema.$ref || schema.allOf) return " --input '@<input.json>'";
+  const csv = schema.csvInput;
+  const csvField = typeof _optionalChain([csv, 'optionalAccess', _ => _.inputField]) === "string" ? csv.inputField : null;
+  const required = Array.isArray(schema.required) ? schema.required : [];
+  const csvOnlyRequired = required.every((key) => key === csvField);
+  const alternatives = _nullishCoalesce(schema.oneOf, () => ( schema.anyOf));
+  const hasCsvAlternative = Array.isArray(alternatives) && alternatives.some((branch) => {
+    if (!branch || typeof branch !== "object") return false;
+    const keys = branch.required;
+    return Array.isArray(keys) && keys.includes(csvField) && keys.every((key) => key === csvField);
+  });
+  if (csvField && csvOnlyRequired && (!alternatives || hasCsvAlternative)) {
+    if (csvField === "csv") return " --csv '<contacts.csv>'";
+    const value = JSON.stringify({ [csvField]: "<contacts.csv>" });
+    return ` --input '${value.replace(/'/g, "'\\''")}'`;
+  }
+  if (Array.isArray(schema.required) && !required.length && !csv && !alternatives) {
+    return "";
+  }
+  return " --input '@<input.json>'";
+}
+
+// src/plays/play-description.ts
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function compactSchema(schema) {
+  if (!schema) return null;
+  const fields = Array.isArray(schema.fields) ? schema.fields.map(
+    (field) => isRecord(field) ? {
+      name: String(_nullishCoalesce(field.name, () => ( ""))),
+      type: _nullishCoalesce(field.type, () => ( void 0)),
+      required: _nullishCoalesce(field.required, () => ( void 0))
+    } : null
+  ).filter((field) => Boolean(_optionalChain([field, 'optionalAccess', _2 => _2.name]))) : [];
+  return fields.length > 0 ? { fields } : schema;
+}
+function schemaMetadata(schema, key) {
+  const value = isRecord(schema) ? schema[key] : null;
+  return isRecord(value) ? value : null;
+}
+function starterPlayPath(play) {
+  const target = play.reference || play.name;
+  const unqualifiedName = target.split("/").pop() || play.name;
+  const safeName = unqualifiedName.trim().toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  return `./${safeName || "play"}.play.ts`;
+}
+function cloneEditStarter(play) {
+  const readonlyPrebuilt = (play.origin === "prebuilt" || play.ownerType === "deepline") && !play.canEdit;
+  if (!play.canClone && !readonlyPrebuilt) return void 0;
+  const target = play.reference || play.name;
+  const path = starterPlayPath(play);
+  return {
+    path,
+    command: `deepline plays get ${target} --source --out ${path}`,
+    checkCommand: `deepline plays check ${path}`
+  };
+}
+function staticPipeline(play) {
+  return isRecord(play.staticPipeline) ? play.staticPipeline : isRecord(_optionalChain([play, 'access', _3 => _3.currentRevision, 'optionalAccess', _4 => _4.staticPipeline])) ? play.currentRevision.staticPipeline : isRecord(_optionalChain([play, 'access', _5 => _5.liveRevision, 'optionalAccess', _6 => _6.staticPipeline])) ? play.liveRevision.staticPipeline : null;
+}
+function describePlayListItem(play, options = {}) {
+  const aliases = _optionalChain([play, 'access', _7 => _7.aliases, 'optionalAccess', _8 => _8.length]) ? play.aliases : [play.name];
+  const csvInput = schemaMetadata(play.inputSchema, "csvInput");
+  const rowOutputSchema = schemaMetadata(play.outputSchema, "rowOutputSchema");
+  const description = _optionalChain([play, 'access', _9 => _9.description, 'optionalAccess', _10 => _10.trim, 'call', _11 => _11()]) || _optionalChain([play, 'access', _12 => _12.currentRevision, 'optionalAccess', _13 => _13.description, 'optionalAccess', _14 => _14.trim, 'call', _15 => _15()]) || _optionalChain([play, 'access', _16 => _16.liveRevision, 'optionalAccess', _17 => _17.description, 'optionalAccess', _18 => _18.trim, 'call', _19 => _19()]) || null;
+  const runCommand = `deepline plays run ${play.reference || play.name}${playInputExampleArgs(play.inputSchema)}`;
+  const starter = cloneEditStarter(play);
+  return {
+    name: play.name,
+    // playKey and triggerStatus were projected away here, so `describe`
+    // was strictly less informative than `plays list` for the same play — no
+    // stable key, and no way to see that a cron was armed.
+    ...play.playKey ? { playKey: play.playKey } : {},
+    ...play.reference ? { reference: play.reference } : {},
+    ...play.displayName ? { displayName: play.displayName } : {},
+    ...description ? { description } : {},
+    ...play.guidance ? { guidance: play.guidance } : {},
+    pinned: Boolean(play.pinned),
+    toolCategories: _nullishCoalesce(play.toolCategories, () => ( [])),
+    origin: play.origin,
+    ownerType: play.ownerType,
+    canEdit: play.canEdit,
+    canClone: play.canClone,
+    aliases,
+    inputSchema: options.compact ? compactSchema(play.inputSchema) : _nullishCoalesce(play.inputSchema, () => ( null)),
+    outputSchema: options.compact ? compactSchema(play.outputSchema) : _nullishCoalesce(play.outputSchema, () => ( null)),
+    ...options.pipeline ? { staticPipeline: staticPipeline(play) } : {},
+    ...csvInput ? {
+      csvInput: { ...csvInput, headerMatching: CSV_HEADER_MATCHING_NOTE }
+    } : {},
+    ...rowOutputSchema ? { rowOutputSchema } : {},
+    runCommand,
+    examples: [runCommand],
+    ...starter ? { cloneEditStarter: starter } : {},
+    currentPublishedVersion: _nullishCoalesce(play.currentPublishedVersion, () => ( null)),
+    // Read the live version off the live revision. It was previously only
+    // ever written by the publish/live routes, so every list and describe
+    // payload reported liveVersion: null even for an actively serving play.
+    liveVersion: _nullishCoalesce(_optionalChain([play, 'access', _20 => _20.liveRevision, 'optionalAccess', _21 => _21.version]), () => ( null)),
+    ...play.triggerStatus ? { triggerStatus: play.triggerStatus } : {},
+    isDraftDirty: play.isDraftDirty
+  };
+}
+function describePlayDetail(detail, options = {}) {
+  const play = detail.play;
+  return {
+    ...describePlayListItem(play, options),
+    currentPublishedVersion: _nullishCoalesce(_nullishCoalesce(play.currentPublishedVersion, () => ( _optionalChain([play, 'access', _22 => _22.liveRevision, 'optionalAccess', _23 => _23.version]))), () => ( null)),
+    latestRunId: _nullishCoalesce(_nullishCoalesce(play.latestRunId, () => ( _optionalChain([detail, 'access', _24 => _24.latestRuns, 'access', _25 => _25[0], 'optionalAccess', _26 => _26.workflowId]))), () => ( null)),
+    ...play.triggerMetadata ? { triggerMetadata: play.triggerMetadata } : {},
+    ...play.runtimeLimit ? { runtimeLimit: play.runtimeLimit } : {},
+    ...play.activeScheduledPlays ? { activeScheduledPlays: play.activeScheduledPlays } : {},
+    ...play.observedCost ? { observedCost: play.observedCost } : {}
+  };
+}
+
+
+
+
+
+
+exports.CSV_HEADER_MATCHING_NOTE = CSV_HEADER_MATCHING_NOTE; exports.playInputExampleArgs = playInputExampleArgs; exports.describePlayListItem = describePlayListItem; exports.describePlayDetail = describePlayDetail;

package/dist/cli/{chunk-XXUDVEXK.mjs → chunk-EFLQHJZ6.mjs}

@@ -13,7 +13,7 @@ import {
   observedMaxText,
   recentSearchRef,
   registerDeprecatedSearchCommand
-} from "./chunk-ZYBGA4AR.mjs";
+} from "./chunk-7XAM7KDW.mjs";
 import {
   DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS,
   EMAIL_STATUS_JSON_SCHEMA,
@@ -31,7 +31,7 @@ import {
 import {
   DeeplineClient,
   validateExecutionIdempotencyKey
-} from "./chunk-JHIJIHFB.mjs";
+} from "./chunk-G4IWGRMK.mjs";
 import {
   stableStringify
 } from "./chunk-UBKA33KY.mjs";
@@ -48,11 +48,11 @@ import {
   printJsonError,
   renderCommandEnvelopeText,
   shouldEmitJson
-} from "./chunk-NR3DFKNF.mjs";
+} from "./chunk-47M6HPGP.mjs";
 import {
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-FJGW5GXU.mjs";
+} from "./chunk-6D7A2FSL.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
@@ -1188,7 +1188,7 @@ Examples:
         process.exitCode = await narrowView();
         return;
       }
-      const { describeAnything } = await import("./describe-K4ES5LIL.mjs");
+      const { describeAnything } = await import("./describe-DBRY5BNK.mjs");
       process.exitCode = await describeAnything(
         toolId,
         {

package/dist/cli/{chunk-JHIJIHFB.mjs → chunk-G4IWGRMK.mjs}

@@ -14,6 +14,10 @@ import {
   stagePlayFiles,
   startPlayRun
 } from "./chunk-JI2B4RZP.mjs";
+import {
+  describePlayDetail,
+  describePlayListItem
+} from "./chunk-5VCZ3WRH.mjs";
 import {
   COORDINATOR_INTERNAL_TOKEN_HEADER,
   CustomerDbQueryOutcomeUnknownError,
@@ -21,7 +25,7 @@ import {
   RETAINED_PIPELINE_RECEIVERS_HEADER,
   RUNTIME_ENVIRONMENT_TOKEN_HEADER,
   resolveConfig
-} from "./chunk-FJGW5GXU.mjs";
+} from "./chunk-6D7A2FSL.mjs";
 import {
   DeeplineError,
   TOOL_EXECUTION_ERROR_SCHEMA_HEADER,
@@ -29,9 +33,6 @@ import {
   ToolExecutionError
 } from "./chunk-NXGCO4JB.mjs";
 
-// src/csv-header-matching.ts
-var CSV_HEADER_MATCHING_NOTE = 'A header matches a column when it equals the column name or its default header, ignoring case, spaces and punctuation: LINKEDIN_URL, linkedin-url and "Linkedin Url" all match linkedin_url. A capital inside a word starts a new word, so "LinkedIn URL" reads as linked_in_url and does not match. Map any other header in the input: {"csv":"<path>","columns":{"<column>":"<your header>"}}.';
-
 // src/pagination.ts
 async function* iterateCursorPages(fetchPage) {
   let cursor = null;
@@ -1835,31 +1836,6 @@ function playTriggerConfigPath(playName) {
   return `/api/v2/plays/${encodeURIComponent(playName)}/triggers`;
 }
 
-// src/plays/input-example.ts
-function playInputExampleArgs(schema) {
-  if (!schema) return " --input '@<input.json>'";
-  if (schema.$ref || schema.allOf) return " --input '@<input.json>'";
-  const csv = schema.csvInput;
-  const csvField = typeof csv?.inputField === "string" ? csv.inputField : null;
-  const required = Array.isArray(schema.required) ? schema.required : [];
-  const csvOnlyRequired = required.every((key) => key === csvField);
-  const alternatives = schema.oneOf ?? schema.anyOf;
-  const hasCsvAlternative = Array.isArray(alternatives) && alternatives.some((branch) => {
-    if (!branch || typeof branch !== "object") return false;
-    const keys = branch.required;
-    return Array.isArray(keys) && keys.includes(csvField) && keys.every((key) => key === csvField);
-  });
-  if (csvField && csvOnlyRequired && (!alternatives || hasCsvAlternative)) {
-    if (csvField === "csv") return " --csv '<contacts.csv>'";
-    const value = JSON.stringify({ [csvField]: "<contacts.csv>" });
-    return ` --input '${value.replace(/'/g, "'\\''")}'`;
-  }
-  if (Array.isArray(schema.required) && !required.length && !csv && !alternatives) {
-    return "";
-  }
-  return " --input '@<input.json>'";
-}
-
 // ../product-notifications/configuration.ts
 var PRODUCT_NOTIFICATION_EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 function normalizeProductNotificationEmail(value) {
@@ -3365,101 +3341,6 @@ var DeeplineClient = class _DeeplineClient {
   get baseUrl() {
     return this.config.baseUrl;
   }
-  compactSchema(schema) {
-    if (!schema) return null;
-    const fields = Array.isArray(schema.fields) ? schema.fields.map(
-      (field) => field && typeof field === "object" ? {
-        name: String(field.name ?? ""),
-        type: field.type ?? void 0,
-        required: field.required ?? void 0
-      } : null
-    ).filter((field) => Boolean(field?.name)) : [];
-    return fields.length > 0 ? { fields } : schema;
-  }
-  schemaMetadata(schema, key) {
-    if (!isRecord2(schema)) return null;
-    const value = schema[key];
-    return isRecord2(value) ? value : null;
-  }
-  playRunCommand(play) {
-    const target = play.reference || play.name;
-    return `deepline plays run ${target}${playInputExampleArgs(play.inputSchema)}`;
-  }
-  starterPlayPath(play) {
-    const target = play.reference || play.name;
-    const unqualifiedName = target.split("/").pop() || play.name;
-    const safeName = unqualifiedName.trim().toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
-    return `./${safeName || "play"}.play.ts`;
-  }
-  playCloneEditStarter(play) {
-    const readonlyPrebuilt = (play.origin === "prebuilt" || play.ownerType === "deepline") && !play.canEdit;
-    if (!play.canClone && !readonlyPrebuilt) return void 0;
-    const target = play.reference || play.name;
-    const path = this.starterPlayPath(play);
-    return {
-      path,
-      command: `deepline plays get ${target} --source --out ${path}`,
-      checkCommand: `deepline plays check ${path}`
-    };
-  }
-  summarizePlayListItem(play, options) {
-    const aliases = play.aliases?.length ? play.aliases : [play.name];
-    const csvInput = this.schemaMetadata(play.inputSchema, "csvInput");
-    const rowOutputSchema = this.schemaMetadata(
-      play.outputSchema,
-      "rowOutputSchema"
-    );
-    const description = play.description?.trim() || play.currentRevision?.description?.trim() || play.liveRevision?.description?.trim() || null;
-    const runCommand = this.playRunCommand(play);
-    const cloneEditStarter = this.playCloneEditStarter(play);
-    return {
-      name: play.name,
-      // playKey and triggerStatus were projected away here, so `describe`
-      // was strictly less informative than `plays list` for the same play — no
-      // stable key, and no way to see that a cron was armed.
-      ...play.playKey ? { playKey: play.playKey } : {},
-      ...play.reference ? { reference: play.reference } : {},
-      ...play.displayName ? { displayName: play.displayName } : {},
-      ...description ? { description } : {},
-      ...play.guidance ? { guidance: play.guidance } : {},
-      pinned: Boolean(play.pinned),
-      toolCategories: play.toolCategories ?? [],
-      origin: play.origin,
-      ownerType: play.ownerType,
-      canEdit: play.canEdit,
-      canClone: play.canClone,
-      aliases,
-      inputSchema: options?.compact ? this.compactSchema(play.inputSchema) : play.inputSchema ?? null,
-      outputSchema: options?.compact ? this.compactSchema(play.outputSchema) : play.outputSchema ?? null,
-      staticPipeline: isRecord2(play.staticPipeline) ? play.staticPipeline : isRecord2(play.currentRevision?.staticPipeline) ? play.currentRevision.staticPipeline : isRecord2(play.liveRevision?.staticPipeline) ? play.liveRevision.staticPipeline : null,
-      ...csvInput ? {
-        csvInput: { ...csvInput, headerMatching: CSV_HEADER_MATCHING_NOTE }
-      } : {},
-      ...rowOutputSchema ? { rowOutputSchema } : {},
-      runCommand,
-      examples: [runCommand],
-      ...cloneEditStarter ? { cloneEditStarter } : {},
-      currentPublishedVersion: play.currentPublishedVersion ?? null,
-      // Read the live version off the live revision. It was previously only
-      // ever written by the publish/live routes, so every list and describe
-      // payload reported liveVersion: null even for an actively serving play.
-      liveVersion: play.liveRevision?.version ?? null,
-      ...play.triggerStatus ? { triggerStatus: play.triggerStatus } : {},
-      isDraftDirty: play.isDraftDirty
-    };
-  }
-  summarizePlayDetail(detail, options) {
-    const play = detail.play;
-    return {
-      ...this.summarizePlayListItem(play, options),
-      currentPublishedVersion: play.currentPublishedVersion ?? play.liveRevision?.version ?? null,
-      latestRunId: play.latestRunId ?? detail.latestRuns[0]?.workflowId ?? null,
-      ...play.triggerMetadata ? { triggerMetadata: play.triggerMetadata } : {},
-      ...play.runtimeLimit ? { runtimeLimit: play.runtimeLimit } : {},
-      ...play.activeScheduledPlays ? { activeScheduledPlays: play.activeScheduledPlays } : {},
-      ...play.observedCost ? { observedCost: play.observedCost } : {}
-    };
-  }
   // ——————————————————————————————————————————————————————————
   // Secrets
   // ——————————————————————————————————————————————————————————
@@ -5369,7 +5250,7 @@ var DeeplineClient = class _DeeplineClient {
       }
     );
     const plays = (response.plays ?? []).map(
-      (play) => this.summarizePlayListItem(play, options)
+      (play) => describePlayListItem(play, { ...options, pipeline: true })
     );
     if (scope === "prebuilt") {
       return plays.filter(isPrebuiltPlayDescription);
@@ -5421,11 +5302,24 @@ var DeeplineClient = class _DeeplineClient {
    * Get a normalized play description suitable for agents and CLIs.
    *
    * The description includes runnable examples, input/output summaries, clone
-   * guidance, revision state, and latest run metadata when available.
+   * guidance, revision state, and latest run metadata when available. Pass
+   * `{ pipeline: true }` to include the compiled pipeline, which can be
+   * hundreds of kilobytes and is otherwise left out.
    */
-  async describePlay(name, options) {
-    const detail = await this.getPlay(name, { guidance: true });
-    return this.summarizePlayDetail(detail, options);
+  async describePlay(name, options = {}) {
+    if (options.pipeline) {
+      return describePlayDetail(
+        await this.getPlay(name, { guidance: true }),
+        options
+      );
+    }
+    const params = new URLSearchParams({
+      include: "guidance",
+      view: "description",
+      ...options.compact ? { compact: "1" } : {}
+    });
+    const body = await this.http.get(`/api/v2/plays/${encodeURIComponent(name)}?${params.toString()}`);
+    return "description" in body ? body.description : describePlayDetail(body, options);
   }
   /**
    * Clear run history and durable sheet/result data for a play without deleting
@@ -6596,9 +6490,7 @@ var DeeplineClient = class _DeeplineClient {
 };
 
 export {
-  CSV_HEADER_MATCHING_NOTE,
   iterateCursorPages,
-  playInputExampleArgs,
   requireBillingIdempotencyKey,
   planCustomerDbQuery,
   validateExecutionIdempotencyKey,

package/dist/cli/{chunk-KGNTKMRG.js → chunk-HRWUQJ4K.js}

@@ -3,7 +3,7 @@
 
 
 
-var _chunkCS6RAIVYjs = require('./chunk-CS6RAIVY.js');
+var _chunk56IFFVIBjs = require('./chunk-56IFFVIB.js');
 
 
 
@@ -226,8 +226,8 @@ var BROWSER_OPEN_COOLDOWN_MS = 3e4;
 var SAME_URL_BROWSER_OPEN_COOLDOWN_MS = 5 * 6e4;
 var defaultBrowserCommandRunner = childProcess;
 function getAuthedHttpClient() {
-  const config = _chunkCS6RAIVYjs.resolveConfig.call(void 0, );
-  return { config, http: new (0, _chunkCS6RAIVYjs.HttpClient)(config) };
+  const config = _chunk56IFFVIBjs.resolveConfig.call(void 0, );
+  return { config, http: new (0, _chunk56IFFVIBjs.HttpClient)(config) };
 }
 function stableOsUserId() {
   try {
@@ -567,7 +567,7 @@ function collectLocalEnvInfo() {
     os: `${process.platform} ${process.arch}`,
     node_version: process.version,
     home_dir: homeDir,
-    agent_runtime: _chunkCS6RAIVYjs.detectAgentRuntime.call(void 0, )
+    agent_runtime: _chunk56IFFVIBjs.detectAgentRuntime.call(void 0, )
   };
   const env = process.env;
   const optional = {
@@ -814,9 +814,9 @@ function markdownTableFromRows(rows, preferredColumns = []) {
 }
 function withAgentCommandContext(value) {
   const valueRecord = value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
-  return _chunkCS6RAIVYjs.detectAgentRuntime.call(void 0, ) !== "unknown" && valueRecord && !Object.prototype.hasOwnProperty.call(valueRecord, "command_context") ? {
+  return _chunk56IFFVIBjs.detectAgentRuntime.call(void 0, ) !== "unknown" && valueRecord && !Object.prototype.hasOwnProperty.call(valueRecord, "command_context") ? {
     ...valueRecord,
-    command_context: _chunkCS6RAIVYjs.resolveCliCommandContext.call(void 0, )
+    command_context: _chunk56IFFVIBjs.resolveCliCommandContext.call(void 0, )
   } : value;
 }
 function printJson(value, fields) {