deepline 0.3.395 → 0.3.397

package/dist/cli/{chunk-DRM3CMHL.js → chunk-KXMNM4AQ.js}

@@ -126,4 +126,5 @@ function describePlayDetail(detail, options = {}) {
 
 
 
-exports.CSV_HEADER_MATCHING_NOTE = CSV_HEADER_MATCHING_NOTE; exports.playInputExampleArgs = playInputExampleArgs; exports.describePlayListItem = describePlayListItem; exports.describePlayDetail = describePlayDetail;
+
+exports.CSV_HEADER_MATCHING_NOTE = CSV_HEADER_MATCHING_NOTE; exports.playInputExampleArgs = playInputExampleArgs; exports.cloneEditStarter = cloneEditStarter; exports.describePlayListItem = describePlayListItem; exports.describePlayDetail = describePlayDetail;

package/dist/cli/chunk-LJ5747UC.mjs

@@ -0,0 +1,107 @@
+// src/cli/tool-description.ts
+function observedMaxText(pricing) {
+  const max = recordValue(recordValue(pricing).observedMax);
+  return typeof max.creditsPerCall === "number" && max.creditsPerCall > 0 ? `max observed ${max.creditsPerCall} credits/call (last ${String(max.windowDays)} days)` : "";
+}
+var Capability = class _Capability {
+  #catalogEntry;
+  constructor(catalogEntry) {
+    this.#catalogEntry = catalogEntry;
+  }
+  static fromCatalogEntry(catalogEntry) {
+    return new _Capability(catalogEntry);
+  }
+  describe() {
+    return CapabilityDescription.fromCatalogEntry(this.#catalogEntry);
+  }
+};
+var CapabilityDescription = class _CapabilityDescription {
+  #catalogEntry;
+  constructor(catalogEntry) {
+    this.#catalogEntry = catalogEntry;
+  }
+  static fromCatalogEntry(catalogEntry) {
+    return new _CapabilityDescription(catalogEntry);
+  }
+  /**
+   * The customer price already resolved by the catalog. This intentionally
+   * omits provider-price fields, even when a catalog Adapter carried them.
+   */
+  customerCost() {
+    const legacyCost = recordValue(this.#catalogEntry.cost);
+    const pricing = recordValue(this.#catalogEntry.pricing);
+    const unit = stringValue(pricing.unit);
+    const legacyPricingModel = stringValue(
+      legacyCost.pricingModel ?? legacyCost.pricing_model
+    );
+    const pricingModel = unit === "call" ? "fixed" : unit === "result" || unit === "page" ? `per_${unit}` : unit === "usage" ? "provider_usage" : legacyPricingModel;
+    const canonicalCredits = pricingNumber(
+      pricing,
+      "creditsPerUnit",
+      "credits_per_unit",
+      this.#catalogEntry.deeplineCreditsPerPricingUnit ?? this.#catalogEntry.deepline_credits_per_pricing_unit
+    );
+    const canonicalUsd = pricingNumber(
+      pricing,
+      "usdPerUnit",
+      "usd_per_unit",
+      this.#catalogEntry.deeplineUsdPerPricingUnit ?? this.#catalogEntry.deepline_usd_per_pricing_unit
+    );
+    const billingSource = stringValue(
+      this.#catalogEntry.billingSource ?? this.#catalogEntry.billing_source
+    );
+    const billingSourceLabel = stringValue(
+      this.#catalogEntry.billingSourceLabel ?? this.#catalogEntry.billing_source_label
+    );
+    const isFree = billingSource === "free";
+    return {
+      pricingModel: pricingModel || null,
+      unit: unit || null,
+      displayText: isFree ? "Free" : stringValue(pricing.displayText ?? pricing.display_text),
+      summary: isFree ? null : stringValue(pricing.summary),
+      billingMode: stringValue(
+        legacyCost.billingMode ?? legacyCost.billing_mode
+      ),
+      billingSource,
+      billingSourceLabel,
+      deeplineCreditsPerPricingUnit: isFree ? 0 : canonicalCredits,
+      deeplineUsdPerPricingUnit: isFree ? 0 : canonicalUsd,
+      ...pricing.estimatedRange && !isFree && billingSource !== "own_provider_credentials" ? {
+        estimatedRange: pricing.estimatedRange,
+        details: Array.isArray(pricing.details) ? pricing.details.filter(
+          (value) => typeof value === "string"
+        ) : []
+      } : {},
+      ...pricing.observedReference && !isFree && billingSource !== "own_provider_credentials" ? {
+        observedReference: pricing.observedReference,
+        details: Array.isArray(pricing.details) ? pricing.details.filter(
+          (value) => typeof value === "string"
+        ) : []
+      } : {},
+      ...pricing.observedMax && !isFree && billingSource !== "own_provider_credentials" ? {
+        observedMax: pricing.observedMax
+      } : {}
+    };
+  }
+};
+function recordValue(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function stringValue(value) {
+  return typeof value === "string" && value.trim() ? value : null;
+}
+function numberValue(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function pricingNumber(pricing, canonicalKey, aliasKey, legacyValue) {
+  for (const key of [canonicalKey, aliasKey]) {
+    if (Object.prototype.hasOwnProperty.call(pricing, key))
+      return numberValue(pricing[key]);
+  }
+  return numberValue(legacyValue);
+}
+
+export {
+  observedMaxText,
+  Capability
+};

package/dist/cli/{chunk-BON3DRC6.mjs → chunk-MRXMMERY.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.395",
+  version: "0.3.397",
   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-7MVWUXOD.mjs → chunk-MV7QRALK.mjs}

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

package/dist/cli/{chunk-WCCKMLHL.mjs → chunk-MYPH2LUU.mjs}

@@ -1,10 +1,10 @@
 import {
   getAuthedHttpClient,
   printCommandEnvelope
-} from "./chunk-47M6HPGP.mjs";
+} from "./chunk-RNSWDKBM.mjs";
 import {
   agentSessionIdFromEnvironment
-} from "./chunk-6D7A2FSL.mjs";
+} from "./chunk-2LDADJNO.mjs";
 
 // src/cli/commands/sessions.ts
 import {

package/dist/cli/{chunk-RDXFGPJU.js → chunk-NA4T3B62.js}

@@ -1,4 +1,66 @@
-"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; }// ../plays/email-status.ts
+"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; }// ../plays/extractor-targets.ts
+var JOB_CHANGE_STATUS_VALUES = [
+  "moved",
+  "no_change",
+  "left_company",
+  "unknown",
+  "profile_unavailable",
+  "no_new_company"
+];
+var JOB_CHANGE_JSON_SCHEMA = {
+  type: "object",
+  required: ["status", "date", "new_company", "new_title"],
+  properties: {
+    status: { type: "string", enum: JOB_CHANGE_STATUS_VALUES },
+    date: { type: ["string", "null"] },
+    new_company: { type: ["string", "null"] },
+    new_title: { type: ["string", "null"] }
+  }
+};
+var PHONE_STATUS_VALUES = ["valid", "invalid", "unknown"];
+var DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS = {
+  id: { identity: true, valueKind: "string" },
+  name: { identity: true, valueKind: "string" },
+  email: { identity: true, valueKind: "string" },
+  personal_email: { identity: true, valueKind: "string" },
+  phone: { identity: true, valueKind: "string" },
+  linkedin: { identity: true, valueKind: "string" },
+  linkedin_url: { identity: true, valueKind: "string" },
+  domain: { identity: true, valueKind: "string" },
+  website: { identity: true, valueKind: "string" },
+  first_name: { identity: true, valueKind: "string" },
+  last_name: { identity: true, valueKind: "string" },
+  full_name: { identity: true, valueKind: "string" },
+  company: { identity: true, valueKind: "string" },
+  company_name: { identity: true, valueKind: "string" },
+  organization_name: { identity: true, valueKind: "string" },
+  company_domain: { identity: true, valueKind: "string" },
+  company_website: { identity: true, valueKind: "string" },
+  company_linkedin_url: { identity: true, valueKind: "string" },
+  title: { identity: false, valueKind: "string" },
+  industry: { identity: false, valueKind: "string" },
+  status: { identity: false, valueKind: "string" },
+  job_change: { identity: false, valueKind: "job_change" },
+  job_change_status: {
+    identity: false,
+    valueKind: "job_change_status",
+    enum: JOB_CHANGE_STATUS_VALUES
+  },
+  email_status: { identity: false, valueKind: "email_status" },
+  phone_status: {
+    identity: false,
+    valueKind: "phone_status",
+    enum: PHONE_STATUS_VALUES
+  }
+};
+var DEEPLINE_EXTRACTOR_TARGETS = Object.keys(
+  DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS
+);
+function isDeeplineExtractorTarget(value) {
+  return value in DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS;
+}
+
+// ../plays/email-status.ts
 var nullable = (type) => ({ type: [type, "null"] });
 var oneOf = (values) => ({ type: "string", enum: values });
 var EMAIL_STATUS_JSON_SCHEMA = {
@@ -212,276 +274,6 @@ function buildEmailStatus({
   };
 }
 
-// ../plays/extractor-targets.ts
-var JOB_CHANGE_STATUS_VALUES = [
-  "moved",
-  "no_change",
-  "left_company",
-  "unknown",
-  "profile_unavailable",
-  "no_new_company"
-];
-var JOB_CHANGE_JSON_SCHEMA = {
-  type: "object",
-  required: ["status", "date", "new_company", "new_title"],
-  properties: {
-    status: { type: "string", enum: JOB_CHANGE_STATUS_VALUES },
-    date: { type: ["string", "null"] },
-    new_company: { type: ["string", "null"] },
-    new_title: { type: ["string", "null"] }
-  }
-};
-var PHONE_STATUS_VALUES = ["valid", "invalid", "unknown"];
-var DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS = {
-  id: { identity: true, valueKind: "string" },
-  name: { identity: true, valueKind: "string" },
-  email: { identity: true, valueKind: "string" },
-  personal_email: { identity: true, valueKind: "string" },
-  phone: { identity: true, valueKind: "string" },
-  linkedin: { identity: true, valueKind: "string" },
-  linkedin_url: { identity: true, valueKind: "string" },
-  domain: { identity: true, valueKind: "string" },
-  website: { identity: true, valueKind: "string" },
-  first_name: { identity: true, valueKind: "string" },
-  last_name: { identity: true, valueKind: "string" },
-  full_name: { identity: true, valueKind: "string" },
-  company: { identity: true, valueKind: "string" },
-  company_name: { identity: true, valueKind: "string" },
-  organization_name: { identity: true, valueKind: "string" },
-  company_domain: { identity: true, valueKind: "string" },
-  company_website: { identity: true, valueKind: "string" },
-  company_linkedin_url: { identity: true, valueKind: "string" },
-  title: { identity: false, valueKind: "string" },
-  industry: { identity: false, valueKind: "string" },
-  status: { identity: false, valueKind: "string" },
-  job_change: { identity: false, valueKind: "job_change" },
-  job_change_status: {
-    identity: false,
-    valueKind: "job_change_status",
-    enum: JOB_CHANGE_STATUS_VALUES
-  },
-  email_status: { identity: false, valueKind: "email_status" },
-  phone_status: {
-    identity: false,
-    valueKind: "phone_status",
-    enum: PHONE_STATUS_VALUES
-  }
-};
-var DEEPLINE_EXTRACTOR_TARGETS = Object.keys(
-  DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS
-);
-function isDeeplineExtractorTarget(value) {
-  return value in DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS;
-}
-
-// src/tool-output.ts
-
-
-
-
-
-
-var _fs = require('fs');
-var _os = require('os');
-var _path = require('path');
-function isPlainObject(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-function getByDottedPath(root, dottedPath) {
-  let current = root;
-  for (const segment of String(dottedPath || "").split(".").filter(Boolean)) {
-    if (!isPlainObject(current) || !(segment in current)) {
-      return null;
-    }
-    current = current[segment];
-  }
-  return current;
-}
-function normalizeRows(value) {
-  if (!Array.isArray(value)) return null;
-  return value.map((entry) => {
-    if (isPlainObject(entry)) return entry;
-    return { value: entry };
-  });
-}
-function columnsForRows(rows) {
-  const seen = /* @__PURE__ */ new Set();
-  const columns = [];
-  for (const row of rows) {
-    for (const key of Object.keys(row)) {
-      if (!seen.has(key)) {
-        seen.add(key);
-        columns.push(key);
-      }
-    }
-  }
-  return columns;
-}
-function candidateRoots(payload) {
-  const roots = [
-    { path: null, value: payload }
-  ];
-  if (isPlainObject(payload) && isPlainObject(payload.toolResponse)) {
-    roots.push({ path: "toolResponse", value: payload.toolResponse });
-    if (Object.prototype.hasOwnProperty.call(payload.toolResponse, "raw")) {
-      roots.push({
-        path: "toolResponse.raw",
-        value: payload.toolResponse.raw
-      });
-    }
-  }
-  if (isPlainObject(payload) && isPlainObject(payload.output)) {
-    roots.push({ path: "output", value: payload.output });
-    if (Object.prototype.hasOwnProperty.call(payload.output, "body")) {
-      roots.push({ path: "output.body", value: payload.output.body });
-    }
-  }
-  if (isPlainObject(payload) && isPlainObject(payload.result)) {
-    roots.push({ path: "result", value: payload.result });
-    if (isPlainObject(payload.result.data)) {
-      roots.push({ path: "result.data", value: payload.result.data });
-    }
-  }
-  return roots;
-}
-function findBestArrayCandidate(value, pathPrefix = "", depth = 0) {
-  if (depth > 5) return null;
-  const directRows = normalizeRows(value);
-  const hasObjectRow = _nullishCoalesce(_optionalChain([directRows, 'optionalAccess', _9 => _9.some, 'call', _10 => _10(
-    (row) => Object.keys(row).some((key) => key !== "value")
-  )]), () => ( false));
-  let best = directRows && directRows.length > 0 && hasObjectRow ? { path: pathPrefix, rows: directRows } : null;
-  if (!isPlainObject(value)) {
-    return best;
-  }
-  for (const [key, child] of Object.entries(value)) {
-    const childPath = pathPrefix ? `${pathPrefix}.${key}` : key;
-    const candidate = findBestArrayCandidate(child, childPath, depth + 1);
-    if (!candidate) continue;
-    if (!best || candidate.rows.length > best.rows.length) {
-      best = candidate;
-    }
-  }
-  return best;
-}
-function tryConvertToList(payload, options) {
-  const listExtractorPaths = Array.isArray(_optionalChain([options, 'optionalAccess', _11 => _11.listExtractorPaths])) ? _optionalChain([options, 'optionalAccess', _12 => _12.listExtractorPaths, 'access', _13 => _13.filter, 'call', _14 => _14(
-    (entry) => typeof entry === "string" && entry.trim().length > 0
-  )]) : [];
-  if (listExtractorPaths.length > 0) {
-    let emptyMatch = null;
-    for (const root of candidateRoots(payload)) {
-      for (const extractorPath of listExtractorPaths) {
-        const resolved = getByDottedPath(root.value, extractorPath);
-        const rows = normalizeRows(resolved);
-        if (!rows) {
-          continue;
-        }
-        const sourcePath = root.path ? `${root.path}.${extractorPath}` : extractorPath;
-        if (rows.length > 0) {
-          return { rows, strategy: "configured_paths", sourcePath };
-        }
-        emptyMatch ??= { rows, strategy: "configured_paths", sourcePath };
-      }
-    }
-    if (emptyMatch) {
-      return emptyMatch;
-    }
-  }
-  const roots = candidateRoots(payload);
-  const v2Raw = roots.find((root) => root.path === "toolResponse.raw");
-  for (const root of v2Raw ? [v2Raw] : roots) {
-    const candidate = findBestArrayCandidate(root.value, _nullishCoalesce(root.path, () => ( "")));
-    if (!candidate || candidate.rows.length === 0) continue;
-    return {
-      rows: candidate.rows,
-      strategy: "auto_detected",
-      sourcePath: candidate.path || root.path
-    };
-  }
-  return null;
-}
-function projectRowOutput(conversion) {
-  return {
-    rows: conversion.rows,
-    rowCount: conversion.rows.length,
-    columns: columnsForRows(conversion.rows),
-    previewRows: conversion.rows.slice(0, 5),
-    strategy: conversion.strategy,
-    sourcePath: conversion.sourcePath
-  };
-}
-function ensureOutputDir() {
-  const outputDir = _path.join.call(void 0, _os.homedir.call(void 0, ), ".local", "share", "deepline", "data");
-  _fs.mkdirSync.call(void 0, outputDir, { recursive: true });
-  return outputDir;
-}
-function writeJsonOutputFile(payload, stem) {
-  const outputDir = ensureOutputDir();
-  const outputPath = _path.join.call(void 0, outputDir, `${stem}_${Date.now()}.json`);
-  _fs.writeFileSync.call(void 0, outputPath, JSON.stringify(payload, null, 2), "utf-8");
-  return outputPath;
-}
-function writeCsvOutputFile(rows, stem, options) {
-  const outputPath = _optionalChain([options, 'optionalAccess', _15 => _15.outPath]) ? options.outPath : _path.join.call(void 0, ensureOutputDir(), `${stem}_${Date.now()}.csv`);
-  _fs.mkdirSync.call(void 0, _path.dirname.call(void 0, outputPath), { recursive: true });
-  const columns = columnsForRows(rows);
-  const escapeCell = (value) => {
-    const normalized = value == null ? "" : typeof value === "string" || typeof value === "number" || typeof value === "boolean" ? String(value) : JSON.stringify(value);
-    if (/[",\n]/.test(normalized)) {
-      return `"${normalized.replace(/"/g, '""')}"`;
-    }
-    return normalized;
-  };
-  const fd = _fs.openSync.call(void 0, outputPath, "w");
-  try {
-    _fs.writeSync.call(void 0, fd, `${columns.map(escapeCell).join(",")}
-`);
-    for (const row of rows) {
-      _fs.writeSync.call(void 0, 
-        fd,
-        `${columns.map((column) => escapeCell(row[column])).join(",")}
-`
-      );
-    }
-  } finally {
-    _fs.closeSync.call(void 0, fd);
-  }
-  const previewRows = rows.slice(0, 5);
-  const previewColumns = columns.slice(0, 5);
-  const preview = [
-    previewColumns.join(","),
-    ...previewRows.map(
-      (row) => previewColumns.map((column) => escapeCell(row[column])).join(",")
-    )
-  ].join("\n");
-  return {
-    path: outputPath,
-    rowCount: rows.length,
-    columns,
-    preview
-  };
-}
-function extractSummaryFields(payload) {
-  const candidates = candidateRoots(payload);
-  for (const candidate of candidates) {
-    if (!isPlainObject(candidate.value)) continue;
-    const summaryEntries = Object.entries(candidate.value).filter(
-      ([, value]) => {
-        return value == null || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
-      }
-    );
-    if (summaryEntries.length === 0) continue;
-    return Object.fromEntries(summaryEntries);
-  }
-  return {};
-}
-
-
-
-
-
-
 
 
 
@@ -491,4 +283,4 @@ function extractSummaryFields(payload) {
 
 
 
-exports.EMAIL_STATUS_JSON_SCHEMA = EMAIL_STATUS_JSON_SCHEMA; exports.buildEmailStatus = buildEmailStatus; exports.JOB_CHANGE_STATUS_VALUES = JOB_CHANGE_STATUS_VALUES; exports.JOB_CHANGE_JSON_SCHEMA = JOB_CHANGE_JSON_SCHEMA; exports.PHONE_STATUS_VALUES = PHONE_STATUS_VALUES; exports.DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS = DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS; exports.DEEPLINE_EXTRACTOR_TARGETS = DEEPLINE_EXTRACTOR_TARGETS; exports.isDeeplineExtractorTarget = isDeeplineExtractorTarget; exports.tryConvertToList = tryConvertToList; exports.projectRowOutput = projectRowOutput; exports.writeJsonOutputFile = writeJsonOutputFile; exports.writeCsvOutputFile = writeCsvOutputFile; exports.extractSummaryFields = extractSummaryFields;
+exports.EMAIL_STATUS_JSON_SCHEMA = EMAIL_STATUS_JSON_SCHEMA; exports.buildEmailStatus = buildEmailStatus; exports.JOB_CHANGE_STATUS_VALUES = JOB_CHANGE_STATUS_VALUES; exports.JOB_CHANGE_JSON_SCHEMA = JOB_CHANGE_JSON_SCHEMA; exports.PHONE_STATUS_VALUES = PHONE_STATUS_VALUES; exports.DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS = DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS; exports.DEEPLINE_EXTRACTOR_TARGETS = DEEPLINE_EXTRACTOR_TARGETS; exports.isDeeplineExtractorTarget = isDeeplineExtractorTarget;

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

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

package/dist/cli/chunk-OSDXE27V.mjs

@@ -0,0 +1,88 @@
+import {
+  SCHEMA_LINE_LIMIT
+} from "./chunk-IHG7UAHD.mjs";
+
+// src/cli/describe-options.ts
+function addDescribeOptions(command, options = {}) {
+  command.option(
+    "--prebuilt",
+    "Show the Deepline tool or play, not a play your workspace created under the same name"
+  ).option("--tool", "Same as --prebuilt").option(
+    "--verbose",
+    "Show secondary fields, and fill in every input and read every output in the examples"
+  ).option(
+    "--cli-example",
+    "Show only the CLI example, and explain how it takes inputs and returns outputs"
+  ).option(
+    "--play-example",
+    "Show only the in-play example, and explain how it takes inputs and returns outputs"
+  ).option("--no-example", "Hide the run examples").option(
+    "--full-schema",
+    `Print every field: a long schema unfolded (over ${SCHEMA_LINE_LIMIT} lines), list rows, and a tool's raw response`
+  ).option(
+    "--fields <names>",
+    "Show only these fields, comma-separated, plus every required input"
+  ).option(
+    "--feature <name[=value]>",
+    "Describe one feature of a tool, such as a model: --feature model=openai/gpt-5.6-luna. A tool lists its features."
+  ).option(
+    "-o, --out <path>",
+    "Save the output to this file instead of printing it"
+  );
+  if (options.schemaOnly !== false) {
+    command.option(
+      "--schema-only",
+      "Print only the schema, with every field, and nothing else"
+    );
+  }
+  if (options.json !== false) {
+    command.option(
+      "--json",
+      "Print JSON instead of text; with --schema-only, only the input and output JSON Schemas"
+    );
+  }
+  return command;
+}
+
+// src/cli/execution-observation.ts
+import { writeFileSync, renameSync } from "fs";
+function writeObservation(observation) {
+  const path = process.env.DEEPLINE_EXECUTION_OBSERVATION_PATH;
+  const invocationId = process.env.DEEPLINE_EXECUTION_OBSERVATION_ID;
+  if (!path || !invocationId) return;
+  const pending = `${path}.pending`;
+  writeFileSync(
+    pending,
+    JSON.stringify({
+      schema_version: 1,
+      invocation_id: invocationId,
+      ...observation
+    }),
+    { mode: 384 }
+  );
+  renameSync(pending, path);
+}
+function recordApiResponse(observation) {
+  writeObservation({
+    kind: "api_response",
+    received_at_ms: observation.receivedAtMs,
+    state: observation.state,
+    http_status: observation.httpStatus
+  });
+}
+function recordPlayTermination(run) {
+  if (typeof run.id !== "string" || !["completed", "failed", "cancelled", "canceled"].includes(
+    String(run.status)
+  ) || typeof run.finishedAt !== "number" || !Number.isSafeInteger(run.finishedAt) || run.finishedAt <= 0)
+    return;
+  writeObservation({
+    kind: "play_terminal",
+    run: { id: run.id, status: run.status, finishedAt: run.finishedAt }
+  });
+}
+
+export {
+  addDescribeOptions,
+  recordApiResponse,
+  recordPlayTermination
+};