deepline 0.3.372 → 0.3.373

package/dist/cli/{chunk-3CTB7V5F.mjs → chunk-XMME4SCK.mjs}

@@ -2,7 +2,7 @@ import {
   argsWantJson,
   openInBrowser,
   printCommandEnvelope
-} from "./chunk-MIMV5LTU.mjs";
+} from "./chunk-HNLXC5BP.mjs";
 import {
   ACTIVE_ORG_ID_ENV,
   ACTIVE_ORG_NAME_ENV,
@@ -25,7 +25,7 @@ import {
   saveHostEnvValues,
   saveProjectDeeplineEnvValues,
   storedHostApiKey
-} from "./chunk-FGHRRJ3D.mjs";
+} from "./chunk-IUYKSTWB.mjs";
 
 // src/cli/commands/auth.ts
 import {

package/dist/cli/{chunk-2RC5JQ3C.mjs → chunk-Y32GUTEN.mjs}

@@ -21,7 +21,7 @@ import {
   RETAINED_PIPELINE_RECEIVERS_HEADER,
   RUNTIME_ENVIRONMENT_TOKEN_HEADER,
   resolveConfig
-} from "./chunk-FGHRRJ3D.mjs";
+} from "./chunk-IUYKSTWB.mjs";
 import {
   DeeplineError,
   TOOL_EXECUTION_ERROR_SCHEMA_HEADER,

package/dist/cli/{chunk-JB6ERQUV.mjs → chunk-Y6VOGHF2.mjs}

@@ -1,3 +1,279 @@
+// ../plays/email-status.ts
+var nullable = (type) => ({ type: [type, "null"] });
+var oneOf = (values) => ({ type: "string", enum: values });
+var EMAIL_STATUS_JSON_SCHEMA = {
+  type: "object",
+  required: [
+    "verdict",
+    "status",
+    "verified",
+    "confidence",
+    "reasons",
+    "signals",
+    "provider"
+  ],
+  properties: {
+    verdict: oneOf([
+      "send",
+      "send_with_caution",
+      "verify_next",
+      "hold",
+      "drop"
+    ]),
+    status: oneOf([
+      "valid",
+      "invalid",
+      "catch_all",
+      "valid_catch_all",
+      "unknown",
+      "do_not_mail",
+      "spamtrap",
+      "abuse",
+      "disposable"
+    ]),
+    verified: { type: "boolean" },
+    confidence: nullable("number"),
+    reasons: { type: "array", items: { type: "string" } },
+    signals: {
+      type: "object",
+      required: [
+        "catch_all",
+        "deliverability",
+        "mx_class",
+        "mx_provider",
+        "mx_record",
+        "fraud_score",
+        "disposable",
+        "role_based",
+        "free_email",
+        "abuse",
+        "spamtrap",
+        "suspect",
+        "valid"
+      ],
+      properties: {
+        catch_all: nullable("boolean"),
+        deliverability: oneOf([
+          "high",
+          "medium",
+          "low",
+          "unknown"
+        ]),
+        mx_class: oneOf([
+          "consumer_mailbox",
+          "workspace_mailbox",
+          "security_gateway",
+          "on_prem",
+          "unknown"
+        ]),
+        mx_provider: nullable("string"),
+        mx_record: nullable("string"),
+        fraud_score: nullable("number"),
+        disposable: nullable("boolean"),
+        role_based: nullable("boolean"),
+        free_email: nullable("boolean"),
+        abuse: nullable("boolean"),
+        spamtrap: nullable("boolean"),
+        suspect: nullable("boolean"),
+        valid: nullable("boolean")
+      }
+    },
+    provider: {
+      type: "object",
+      required: ["name", "raw_status", "raw_score"],
+      properties: {
+        name: { type: "string" },
+        raw_status: { type: ["string", "boolean", "number", "null"] },
+        raw_score: nullable("number")
+      }
+    }
+  }
+};
+function normalizeKey(value) {
+  if (value == null) return null;
+  if (typeof value === "boolean") return String(value);
+  const normalized = String(value).trim().toLowerCase().replace(/\s+/g, "_");
+  return normalized || null;
+}
+function boolish(value) {
+  if (typeof value === "boolean") return value;
+  if (typeof value === "number")
+    return value === 1 ? true : value === 0 ? false : null;
+  if (typeof value !== "string") return null;
+  const normalized = value.trim().toLowerCase();
+  if (["true", "yes", "y", "1"].includes(normalized)) return true;
+  if (["false", "no", "n", "0"].includes(normalized)) return false;
+  return null;
+}
+function numberish(value) {
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value !== "string" || value.trim() === "") return null;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+function stringish(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function deliverability(value) {
+  const normalized = normalizeKey(value);
+  return normalized === "high" || normalized === "medium" || normalized === "low" ? normalized : "unknown";
+}
+function mxClass(mxProvider, mxRecord) {
+  const haystack = `${stringish(mxProvider) ?? ""} ${stringish(mxRecord) ?? ""}`.toLowerCase();
+  if (!haystack.trim()) return "unknown";
+  if (/proofpoint|pphosted|mimecast|barracuda|ess\.barracudanetworks|ironport|cisco|iphmx|messagelabs|symantec/.test(
+    haystack
+  )) {
+    return "security_gateway";
+  }
+  if (/aspmx\.l\.google|google|g-suite|google workspace/.test(haystack)) {
+    return "workspace_mailbox";
+  }
+  if (/protection\.outlook|office365|microsoft|outlook|exchange online/.test(
+    haystack
+  )) {
+    return "workspace_mailbox";
+  }
+  if (/gmail|yahoo|icloud|aol|hotmail/.test(haystack))
+    return "consumer_mailbox";
+  if (/postfix|exim|sendmail|zimbra|plesk|cpanel|mail\./.test(haystack))
+    return "on_prem";
+  return "unknown";
+}
+function entryForStatus(key, map) {
+  if (!key) return null;
+  return map?.[key] ?? null;
+}
+function read(values, name) {
+  return values[name];
+}
+function matchesRule(rule, values) {
+  return Object.entries(rule.when).every(([key, expected]) => {
+    const actual = read(values, key);
+    if (key.endsWith("Lt")) {
+      const source = numberish(read(values, key.slice(0, -2)));
+      return typeof expected === "number" && source != null && source < expected;
+    }
+    if (typeof expected === "boolean") return boolish(actual) === expected;
+    if (typeof expected === "number") return numberish(actual) === expected;
+    return normalizeKey(actual) === normalizeKey(expected);
+  });
+}
+function buildEmailStatus({
+  config,
+  values
+}) {
+  const rawStatus = read(values, "rawStatus");
+  const rawScore = numberish(read(values, "rawScore"));
+  const valid = boolish(read(values, "valid"));
+  const catchAll = boolish(read(values, "catchAll"));
+  const disposable = boolish(read(values, "disposable"));
+  const abuse = boolish(read(values, "abuse"));
+  const spamtrap = boolish(read(values, "spamtrap"));
+  const suspect = boolish(read(values, "suspect"));
+  const rawKey = normalizeKey(rawStatus);
+  const mapped = config.rules?.find((rule) => matchesRule(rule, values)) ?? entryForStatus(rawKey, config.statusMap) ?? entryForStatus(valid == null ? null : String(valid), config.statusMap);
+  const status = mapped?.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 = mapped?.verdict ?? defaultVerdict;
+  const verified = mapped?.verified ?? (status === "valid" || status === "valid_catch_all" || verdict === "send");
+  const reasons = [
+    mapped?.reason,
+    catchAll ? "catch_all_domain" : null,
+    mxClass(read(values, "mxProvider"), read(values, "mxRecord")) === "security_gateway" ? "security_gateway_mx" : null,
+    suspect ? "provider_marked_suspect" : null
+  ].filter((reason) => typeof reason === "string");
+  return {
+    verdict,
+    status,
+    verified,
+    confidence: rawScore,
+    reasons,
+    signals: {
+      catch_all: catchAll,
+      deliverability: deliverability(read(values, "deliverability")),
+      mx_class: mxClass(read(values, "mxProvider"), read(values, "mxRecord")),
+      mx_provider: stringish(read(values, "mxProvider")),
+      mx_record: stringish(read(values, "mxRecord")),
+      fraud_score: numberish(read(values, "fraudScore")),
+      disposable,
+      role_based: boolish(read(values, "roleBased")),
+      free_email: boolish(read(values, "freeEmail")),
+      abuse,
+      spamtrap,
+      suspect,
+      valid
+    },
+    provider: {
+      name: config.provider,
+      raw_status: typeof rawStatus === "string" || typeof rawStatus === "boolean" || typeof rawStatus === "number" ? rawStatus : null,
+      raw_score: rawScore
+    }
+  };
+}
+
+// ../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
 import {
   closeSync,
@@ -380,6 +656,14 @@ function normalizeTableNamespace(value) {
 }
 
 export {
+  EMAIL_STATUS_JSON_SCHEMA,
+  buildEmailStatus,
+  JOB_CHANGE_STATUS_VALUES,
+  JOB_CHANGE_JSON_SCHEMA,
+  PHONE_STATUS_VALUES,
+  DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS,
+  DEEPLINE_EXTRACTOR_TARGETS,
+  isDeeplineExtractorTarget,
   stableStringify,
   sha256Hex,
   normalizeTableNamespace,

package/dist/cli/{chunk-5HYD3GMS.mjs → chunk-YHHY2YHK.mjs}

@@ -1,14 +1,14 @@
 import {
   DeeplineClient
-} from "./chunk-2RC5JQ3C.mjs";
+} from "./chunk-Y32GUTEN.mjs";
 import {
   printCommandEnvelope,
   renderCommandEnvelopeText
-} from "./chunk-MIMV5LTU.mjs";
+} from "./chunk-HNLXC5BP.mjs";
 import {
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-FGHRRJ3D.mjs";
+} from "./chunk-IUYKSTWB.mjs";
 
 // src/cli/commands/search.ts
 import { Option } from "commander";

package/dist/cli/{chunk-2JRRXXTA.js → chunk-YPVTQRUM.js}

@@ -4,6 +4,21 @@ var _chunkAID3OYVJjs = require('./chunk-AID3OYVJ.js');
 
 // src/cli/described.ts
 var SHAPE = "{}";
+function byokLines(byok) {
+  if (typeof byok.supported !== "boolean") {
+    return ["BYOK: unknown (this server does not report it)"];
+  }
+  if (!byok.supported) {
+    return [
+      "BYOK: not supported. Deepline runs this tool with its own credentials."
+    ];
+  }
+  return [
+    byok.required === true ? "BYOK: required. This tool runs only on your own provider credentials." : "BYOK: supported (optional).",
+    ...byok.setup ? [`Setup: ${byok.setup}`] : [],
+    ...byok.setupUrl ? [`Connect: ${byok.setupUrl}`] : []
+  ];
+}
 var SCHEMA_LINE_LIMIT = 100;
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -69,7 +84,9 @@ function schemaField(name, node, required) {
     required,
     ...example !== void 0 ? { example } : {},
     ...typeof schema.description === "string" && schema.description ? { description: schema.description } : {},
-    ...fields ? { fields } : {}
+    ...fields ? { fields } : {},
+    ...schema.secondary === true ? { secondary: true } : {},
+    ...typeof schema.means === "string" ? { means: schema.means } : {}
   };
 }
 function withoutRefs(node, root, depth = 0) {
@@ -167,6 +184,7 @@ function namedShapes(roots) {
       under: field.name
     }));
     entry.count += 1;
+    entry.shape ??= field.shape;
     entry.descriptions.add(_nullishCoalesce(field.description, () => ( "")));
     seen.set(key, entry);
     field.fields.forEach(visit);
@@ -175,12 +193,12 @@ function namedShapes(roots) {
   const taken = /* @__PURE__ */ new Set();
   const named = /* @__PURE__ */ new Map();
   for (const [key, entry] of seen) {
-    if (entry.count < 2) continue;
+    if (entry.count < 2 && !entry.shape) continue;
     const [description] = entry.descriptions.size === 1 ? [...entry.descriptions] : [""];
     const title = (_nullishCoalesce(description, () => ( ""))).split(/[.:]/)[0].trim();
-    const base = pascalCase(
+    const base = _nullishCoalesce(entry.shape, () => ( (pascalCase(
       title && title.split(/\s+/).length <= 3 ? title : entry.fields.length <= 3 ? entry.fields.map((field) => field.name).join(" ") : entry.under
-    ) || "Shape";
+    ) || "Shape")));
     let name = base;
     for (let n = 2; taken.has(name); n += 1) name = `${base}${n}`;
     taken.add(name);
@@ -213,23 +231,27 @@ function schemaBlocks(described, maxDepth, everyField = false) {
     const example = field.example === void 0 ? void 0 : JSON.stringify(field.example);
     const start = `${indent}${JSON.stringify(field.name)}${field.required ? "" : "?"}: `;
     if (!field.fields) {
-      return [`${start}${field.type},${comment([example, field.description])}`];
+      return [
+        `${start}${field.type},${comment([field.means, example, field.description])}`
+      ];
     }
     const [before, after] = field.type.split(SHAPE);
     const shape = shapes.get(shapeKey(field.fields));
     if (shape) {
       if (!used.includes(shape)) used.push(shape);
       const own = field.description === shape.description ? void 0 : field.description;
-      return [`${start}${before}${shape.name}${after},${comment([own])}`];
+      return [
+        `${start}${before}${shape.name}${after},${comment([field.means, own])}`
+      ];
     }
     if (depth >= maxDepth || field.summarized && !everyField) {
       const names = field.fields.map((child) => child.name).join(", ");
       return [
-        `${start}${before}{ ${names} }${after},${comment([field.description])}`
+        `${start}${before}{ ${names} }${after},${comment([field.means, field.description])}`
       ];
     }
     return [
-      `${start}${before}{${comment([field.description])}`,
+      `${start}${before}{${comment([field.means, field.description])}`,
       ...field.fields.flatMap(
         (child) => fieldLines(child, `${indent}  `, depth + 1)
       ),
@@ -255,8 +277,70 @@ function schemaBlocks(described, maxDepth, everyField = false) {
   }
   return [...lines, ...types.length ? ["", "Types:", ...types] : []];
 }
-function schemaLines(described, options) {
-  if (options.full) return schemaBlocks(described, Infinity, true);
+function selectFields(described, wanted) {
+  const hidden = [];
+  const keep = (fields, isInput, path = []) => fields.flatMap((field) => {
+    const name = [...path, field.name];
+    if (!(isInput && field.required) && !wanted(field, path.length)) {
+      hidden.push(name.join("."));
+      return [];
+    }
+    return [
+      field.fields ? { ...field, fields: keep(field.fields, isInput, name) } : field
+    ];
+  });
+  const inputs = keep(described.inputs, true);
+  const rowInputs = described.rowInputs && keep(described.rowInputs, true);
+  const outputs = keep(described.outputs, false);
+  const rowOutputs = described.rowOutputs && keep(described.rowOutputs, false);
+  return {
+    selected: {
+      ...described,
+      inputs,
+      outputs,
+      ...rowInputs ? { rowInputs } : {},
+      ...rowOutputs ? { rowOutputs } : {}
+    },
+    hidden
+  };
+}
+function schemaLines(described, view) {
+  const count = (names) => `${names.length} ${names.length === 1 ? "field" : "fields"}`;
+  if (view.fields) {
+    const names = view.fields;
+    const { selected, hidden } = selectFields(
+      described,
+      (field, depth) => depth > 0 || names.includes(field.name)
+    );
+    const known = new Set(
+      [
+        described.inputs,
+        described.outputs,
+        _nullishCoalesce(described.rowInputs, () => ( [])),
+        _nullishCoalesce(described.rowOutputs, () => ( []))
+      ].flatMap((fields) => fields.map((field) => field.name))
+    );
+    const unknown = names.filter((name) => !known.has(name));
+    return [
+      ...schemaLines(selected, { full: true, secondary: true }),
+      ...unknown.length ? ["", `No field named: ${unknown.join(", ")}.`] : [],
+      ...hidden.length ? ["", `${count(hidden)} not shown: ${hidden.join(", ")}.`] : []
+    ];
+  }
+  if (!view.full && !view.secondary) {
+    const { selected, hidden } = selectFields(
+      described,
+      (field) => !field.secondary
+    );
+    return [
+      ...schemaLines(selected, { ...view, secondary: true }),
+      ...hidden.length ? [
+        "",
+        `${count(hidden).replace(" ", " secondary ")} hidden: ${hidden.join(", ")}. --verbose shows ${hidden.length === 1 ? "it" : "them"}.`
+      ] : []
+    ];
+  }
+  if (view.full) return schemaBlocks(described, Infinity, true);
   const raw = _optionalChain([described, 'access', _ => _.rawResponse, 'optionalAccess', _2 => _2.length]) ? [
     "",
     `Other response fields (${described.rawResponse.map((field) => field.name).join(", ")}) are in result.toolResponse.rawV2. --full-schema lists them.`
@@ -284,7 +368,7 @@ function examples(described, options) {
   const input = JSON.stringify(
     Object.fromEntries(shown.map((field) => [field.name, exampleValue(field)]))
   );
-  const read = options.verbose ? described.outputs : described.outputs.slice(0, 1);
+  const read = options.verbose ? described.outputs : described.outputs.filter((field) => !field.secondary).slice(0, 1);
   const reads = (expression) => read.flatMap((field) => {
     const source = expression(field);
     return source ? [`const ${safeIdentifier(field.name)} = ${source};`] : [];
@@ -338,7 +422,17 @@ function describedLines(described, view) {
     ...described.cost ? [`Cost: ${described.cost}`] : [],
     ...described.guidance.map((line) => `Guidance: ${line}`),
     ...described.rateLimit ? [`Rate limit: ${described.rateLimit}`] : [],
-    ...schemaLines(described, { full: view.fullSchema }),
+    ...described.byok ? byokLines(described.byok) : [],
+    ...schemaLines(described, {
+      full: view.fullSchema,
+      secondary: view.verbose,
+      ...view.fields ? { fields: view.fields } : {}
+    }),
+    ...section(
+      described.exclusive ? [
+        `Give "${described.exclusive.field}" or ${described.exclusive.with.map((name) => `"${name}"`).join(", ")}, not both: per-row values go in the CSV.`
+      ] : []
+    ),
     ...section(
       view.cli ? [
         "Run from the CLI:",
@@ -361,6 +455,88 @@ function describedLines(described, view) {
 function topLevelField({ fields: _fields, ...field }) {
   return { ...field, type: field.type.replace(SHAPE, "object") };
 }
+function jsonFields(fields, options) {
+  return Object.fromEntries(
+    fields.filter(
+      (field) => options.secondary || !field.secondary || options.input && field.required
+    ).map((field) => {
+      const shape = field.fields && options.shapes.get(shapeKey(field.fields));
+      if (shape) options.used.add(shape);
+      return [
+        field.name,
+        {
+          type: field.type.replace(SHAPE, _nullishCoalesce(_optionalChain([shape, 'optionalAccess', _3 => _3.name]), () => ( "object"))),
+          ...options.input ? { required: field.required } : {},
+          ...field.means ? { means: field.means } : {},
+          ...field.example !== void 0 ? { example: field.example } : {},
+          ...field.description && field.description !== _optionalChain([shape, 'optionalAccess', _4 => _4.description]) ? { description: field.description } : {},
+          ...field.secondary ? { secondary: true } : {},
+          ...field.read ? { read: field.read } : {},
+          ...field.in ? { in: field.in } : {},
+          ..._optionalChain([field, 'access', _5 => _5.paths, 'optionalAccess', _6 => _6.length]) ? { paths: field.paths } : {},
+          ...field.fields && !shape ? { fields: jsonFields(field.fields, options) } : {}
+        }
+      ];
+    })
+  );
+}
+function describedJson(described, view) {
+  const sections = [
+    ["inputs", described.inputs, true],
+    ["rowInputs", described.rowInputs, true],
+    ["outputs", described.outputs, false],
+    ["rowOutputs", described.rowOutputs, false]
+  ];
+  const hidden = view.secondary ? [] : sections.flatMap(
+    ([, fields, input]) => (_nullishCoalesce(fields, () => ( []))).filter((field) => field.secondary && !(input && field.required)).map((field) => field.name)
+  );
+  const shapes = namedShapes(sections.flatMap(([, fields]) => _nullishCoalesce(fields, () => ( []))));
+  const used = /* @__PURE__ */ new Set();
+  const blocks = Object.fromEntries(
+    sections.flatMap(
+      ([key, fields, input]) => _optionalChain([fields, 'optionalAccess', _7 => _7.length]) ? [
+        [
+          key,
+          jsonFields(fields, {
+            input,
+            secondary: view.secondary,
+            shapes,
+            used
+          })
+        ]
+      ] : []
+    )
+  );
+  const types = {};
+  for (const shape of used) {
+    types[shape.name] = {
+      ...shape.description ? { description: shape.description } : {},
+      fields: jsonFields(shape.fields, {
+        input: false,
+        secondary: true,
+        shapes,
+        used
+      })
+    };
+  }
+  const { cli, play } = examples(described, { verbose: view.verbose });
+  return {
+    kind: described.kind,
+    id: described.id,
+    ...described.displayName ? { displayName: described.displayName } : {},
+    ...described.description ? { description: described.description } : {},
+    ...described.cost ? { cost: described.cost } : {},
+    ...described.rateLimit ? { rateLimit: described.rateLimit } : {},
+    ...described.byok ? { byok: described.byok } : {},
+    ...described.guidance.length ? { guidance: described.guidance } : {},
+    ...blocks,
+    ...used.size ? { types } : {},
+    ...described.exclusive ? { exclusive: described.exclusive } : {},
+    run: { cli, ...play ? { play } : {} },
+    ...described.source ? { source: described.source } : {},
+    ...hidden.length ? { hidden } : {}
+  };
+}
 
 // src/cli/execution-observation.ts
 var _fs = require('fs');
@@ -406,7 +582,7 @@ function addDescribeOptions(command, options = {}) {
     "Show the Deepline tool or play, not a play your workspace created under the same name"
   ).option("--tool", "Same as --prebuilt").option(
     "--verbose",
-    "Examples fill in every input and read every output, not only required ones"
+    "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"
@@ -416,6 +592,9 @@ function addDescribeOptions(command, options = {}) {
   ).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(
     "-o, --out <path>",
     "Save the output to this file instead of printing it"
@@ -426,6 +605,12 @@ function addDescribeOptions(command, options = {}) {
       "Print only the schema, with every field, and nothing else"
     );
   }
+  if (options.byok !== false) {
+    command.option(
+      "--byok",
+      "For a tool, also show whether it can run on your own provider credentials, and how to connect them (always shown when it must)"
+    );
+  }
   if (options.json !== false) {
     command.option(
       "--json",
@@ -447,4 +632,6 @@ function addDescribeOptions(command, options = {}) {
 
 
 
-exports.SCHEMA_LINE_LIMIT = SCHEMA_LINE_LIMIT; exports.schemaField = schemaField; exports.schemaFields = schemaFields; exports.rateLimitSummary = rateLimitSummary; exports.schemaLines = schemaLines; exports.examples = examples; exports.describedLines = describedLines; exports.topLevelField = topLevelField; exports.recordApiResponse = recordApiResponse; exports.recordPlayTermination = recordPlayTermination; exports.addDescribeOptions = addDescribeOptions;
+
+
+exports.byokLines = byokLines; exports.SCHEMA_LINE_LIMIT = SCHEMA_LINE_LIMIT; exports.schemaField = schemaField; exports.schemaFields = schemaFields; exports.rateLimitSummary = rateLimitSummary; exports.schemaLines = schemaLines; exports.examples = examples; exports.describedLines = describedLines; exports.topLevelField = topLevelField; exports.describedJson = describedJson; exports.recordApiResponse = recordApiResponse; exports.recordPlayTermination = recordPlayTermination; exports.addDescribeOptions = addDescribeOptions;

package/dist/cli/{client-KF2J754U.mjs → client-FO6LMHT4.mjs}

@@ -3,13 +3,13 @@ import {
   MONITOR_JOB_PHASES,
   MONITOR_JOB_RECONCILIATION_STATES,
   MONITOR_JOB_STATES
-} from "./chunk-2RC5JQ3C.mjs";
+} from "./chunk-Y32GUTEN.mjs";
 import "./chunk-6IKARAYD.mjs";
 import "./chunk-CBVIJSHF.mjs";
-import "./chunk-FGHRRJ3D.mjs";
+import "./chunk-IUYKSTWB.mjs";
 import "./chunk-DLIRSHV6.mjs";
 import "./chunk-NXGCO4JB.mjs";
-import "./chunk-JAERLCMH.mjs";
+import "./chunk-P5JPGZNI.mjs";
 import "./chunk-WZYKRD7T.mjs";
 import "./chunk-KRD6H754.mjs";
 export {