deepline 0.3.396 → 0.3.397

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-NHB5YUCS.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.396",
+  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-TLQ3FZOC.mjs → chunk-MV7QRALK.mjs}

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

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

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

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

@@ -60,209 +60,6 @@ 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', _ => _.some, 'call', _2 => _2(
-    (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', _3 => _3.listExtractorPaths])) ? _optionalChain([options, 'optionalAccess', _4 => _4.listExtractorPaths, 'access', _5 => _5.filter, 'call', _6 => _6(
-    (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', _7 => _7.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 {};
-}
-
 // ../plays/email-status.ts
 var nullable = (type) => ({ type: [type, "null"] });
 var oneOf = (values) => ({ type: "string", enum: values });
@@ -407,7 +204,7 @@ function mxClass(mxProvider, mxRecord) {
 }
 function entryForStatus(key, map) {
   if (!key) return null;
-  return _nullishCoalesce(_optionalChain([map, 'optionalAccess', _8 => _8[key]]), () => ( null));
+  return _nullishCoalesce(_optionalChain([map, 'optionalAccess', _ => _[key]]), () => ( null));
 }
 function read(values, name) {
   return values[name];
@@ -437,13 +234,13 @@ function buildEmailStatus({
   const spamtrap = boolish(read(values, "spamtrap"));
   const suspect = boolish(read(values, "suspect"));
   const rawKey = normalizeKey(rawStatus);
-  const mapped = _nullishCoalesce(_nullishCoalesce(_optionalChain([config, 'access', _9 => _9.rules, 'optionalAccess', _10 => _10.find, 'call', _11 => _11((rule) => matchesRule(rule, values))]), () => ( entryForStatus(rawKey, config.statusMap))), () => ( entryForStatus(valid == null ? null : String(valid), config.statusMap)));
-  const status = _nullishCoalesce(_optionalChain([mapped, 'optionalAccess', _12 => _12.status]), () => ( (disposable ? "disposable" : abuse ? "abuse" : spamtrap ? "spamtrap" : catchAll ? "catch_all" : valid === true ? "valid" : valid === false ? "invalid" : "unknown")));
+  const mapped = _nullishCoalesce(_nullishCoalesce(_optionalChain([config, 'access', _2 => _2.rules, 'optionalAccess', _3 => _3.find, 'call', _4 => _4((rule) => matchesRule(rule, values))]), () => ( entryForStatus(rawKey, config.statusMap))), () => ( entryForStatus(valid == null ? null : String(valid), config.statusMap)));
+  const status = _nullishCoalesce(_optionalChain([mapped, 'optionalAccess', _5 => _5.status]), () => ( (disposable ? "disposable" : abuse ? "abuse" : spamtrap ? "spamtrap" : catchAll ? "catch_all" : valid === true ? "valid" : valid === false ? "invalid" : "unknown")));
   const defaultVerdict = status === "valid" ? "send" : status === "valid_catch_all" ? "send_with_caution" : status === "catch_all" ? "verify_next" : status === "unknown" ? "hold" : "drop";
-  const verdict = _nullishCoalesce(_optionalChain([mapped, 'optionalAccess', _13 => _13.verdict]), () => ( defaultVerdict));
-  const verified = _nullishCoalesce(_optionalChain([mapped, 'optionalAccess', _14 => _14.verified]), () => ( (status === "valid" || status === "valid_catch_all" || verdict === "send")));
+  const verdict = _nullishCoalesce(_optionalChain([mapped, 'optionalAccess', _6 => _6.verdict]), () => ( defaultVerdict));
+  const verified = _nullishCoalesce(_optionalChain([mapped, 'optionalAccess', _7 => _7.verified]), () => ( (status === "valid" || status === "valid_catch_all" || verdict === "send")));
   const reasons = [
-    _optionalChain([mapped, 'optionalAccess', _15 => _15.reason]),
+    _optionalChain([mapped, 'optionalAccess', _8 => _8.reason]),
     catchAll ? "catch_all_domain" : null,
     mxClass(read(values, "mxProvider"), read(values, "mxRecord")) === "security_gateway" ? "security_gateway_mx" : null,
     suspect ? "provider_marked_suspect" : null
@@ -486,9 +283,4 @@ function buildEmailStatus({
 
 
 
-
-
-
-
-
-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-23GAA3YO.mjs → chunk-NOX2TCBP.mjs}

@@ -1,6 +1,6 @@
 import {
   resolveShellSpawn
-} from "./chunk-TLQ3FZOC.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
+};