deepline 0.3.372 → 0.3.373

package/dist/cli/{chunk-KC2YOJTU.mjs → chunk-PZ26EKNC.mjs}

@@ -1,10 +1,11 @@
 import {
   addDescribeOptions,
+  byokLines,
   rateLimitSummary,
   recordApiResponse,
   schemaField,
   schemaFields
-} from "./chunk-3GK3SH3G.mjs";
+} from "./chunk-E6BZWURC.mjs";
 import {
   shellQuote
 } from "./chunk-OVDNJAJN.mjs";
@@ -13,22 +14,26 @@ import {
   observedMaxText,
   recentSearchRef,
   registerDeprecatedSearchCommand
-} from "./chunk-5HYD3GMS.mjs";
+} from "./chunk-YHHY2YHK.mjs";
 import {
+  DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS,
+  EMAIL_STATUS_JSON_SCHEMA,
+  JOB_CHANGE_JSON_SCHEMA,
   extractSummaryFields,
+  isDeeplineExtractorTarget,
   projectRowOutput,
   stableStringify,
   tryConvertToList,
   writeCsvOutputFile,
   writeJsonOutputFile
-} from "./chunk-JB6ERQUV.mjs";
+} from "./chunk-Y6VOGHF2.mjs";
 import {
   playToolListGetterMode
 } from "./chunk-7E66A24V.mjs";
 import {
   DeeplineClient,
   validateExecutionIdempotencyKey
-} from "./chunk-2RC5JQ3C.mjs";
+} from "./chunk-Y32GUTEN.mjs";
 import {
   beginToolExecuteCommand,
   getToolExecuteInvocationId,
@@ -42,11 +47,11 @@ import {
   printJsonError,
   renderCommandEnvelopeText,
   shouldEmitJson
-} from "./chunk-MIMV5LTU.mjs";
+} from "./chunk-HNLXC5BP.mjs";
 import {
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-FGHRRJ3D.mjs";
+} from "./chunk-IUYKSTWB.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
@@ -185,6 +190,179 @@ function describeToolCategory(category) {
   return TOOL_CATEGORY_DESCRIPTIONS[category] ?? null;
 }
 
+// ../plays/field-catalog.ts
+var value = (description) => ({ type: "string", description });
+var SOURCE = {
+  type: "string",
+  description: "The provider or step that found it."
+};
+var FIELD_CATALOG = {
+  person: {
+    name: {
+      description: "The person's name.",
+      leaves: {
+        value: value("Full name."),
+        first: value("First (given) name."),
+        last: value("Last (family) name.")
+      }
+    },
+    email: {
+      description: "An email address for the person.",
+      leaves: {
+        value: value("The address."),
+        validated: {
+          type: "boolean",
+          description: "Whether the address passed validation."
+        },
+        status: {
+          type: "EmailStatus",
+          description: "The validation verdict and its signals."
+        },
+        source: SOURCE
+      },
+      kinds: {
+        work: "At their employer.",
+        personal: "Their own, not tied to an employer."
+      }
+    },
+    phone: {
+      description: "A phone number for the person.",
+      leaves: {
+        value: value("The number."),
+        validated: {
+          type: "boolean",
+          description: "Whether the number passed validation."
+        },
+        status: {
+          type: '"valid" | "invalid" | "unknown"',
+          description: "The validation verdict."
+        },
+        line_type: value("Mobile, landline, VoIP and so on."),
+        carrier: value("The carrier serving the number."),
+        source: SOURCE
+      },
+      kinds: {
+        mobile: "Their mobile.",
+        work: "A direct line at their employer."
+      }
+    },
+    linkedin: {
+      description: "The person's LinkedIn profile.",
+      leaves: { url: value("The profile URL.") }
+    },
+    job: {
+      description: "The person's current role.",
+      leaves: {
+        title: value("Job title."),
+        change: {
+          type: "JobChange",
+          description: "Whether they changed jobs, and to what."
+        },
+        change_status: {
+          type: "JobChangeStatus",
+          description: "The job-change verdict alone."
+        }
+      }
+    },
+    record: {
+      description: "A provider's own record of the person.",
+      leaves: { id: value("The provider's id for the person.") }
+    }
+  },
+  company: {
+    name: {
+      description: "The company's name.",
+      leaves: { value: value("The name.") },
+      kinds: { legal: "As registered with a government." }
+    },
+    domain: {
+      description: "The company's web domain.",
+      leaves: { value: value("The bare domain, such as example.com.") }
+    },
+    website: {
+      description: "The company's website.",
+      leaves: { url: value("The site URL.") }
+    },
+    linkedin: {
+      description: "The company's LinkedIn page.",
+      leaves: { url: value("The page URL.") }
+    },
+    phone: {
+      description: "A phone number for the company.",
+      leaves: { value: value("The number.") }
+    },
+    industry: {
+      description: "The industry the company is in.",
+      leaves: { value: value("The industry.") }
+    },
+    record: {
+      description: "A provider's own record of the company.",
+      leaves: { id: value("The provider's id for the company.") }
+    }
+  }
+};
+function catalogFields() {
+  return Object.entries(FIELD_CATALOG).flatMap(
+    ([entity, groups]) => Object.entries(groups).flatMap(
+      ([group, definition]) => [void 0, ...Object.keys(definition.kinds ?? {})].flatMap(
+        (kind) => Object.entries(definition.leaves).map(([leaf, described]) => ({
+          ...described,
+          id: [entity, group, kind, leaf].filter(Boolean).join("."),
+          entity,
+          group,
+          ...kind ? { kind } : {},
+          leaf
+        }))
+      )
+    )
+  );
+}
+var FIELDS_BY_ID = new Map(catalogFields().map((field) => [field.id, field]));
+function generalField(id) {
+  const field = FIELDS_BY_ID.get(id);
+  return field?.kind ? [field.entity, field.group, field.leaf].join(".") : null;
+}
+function fieldSatisfies(offered, wanted) {
+  return offered === wanted || generalField(offered) === wanted;
+}
+var EXTRACTOR_TARGET_FIELDS = {
+  email: ["person.email.value"],
+  personal_email: ["person.email.personal.value"],
+  email_status: ["person.email.status"],
+  phone: ["person.phone.value", "company.phone.value"],
+  phone_status: ["person.phone.status"],
+  first_name: ["person.name.first"],
+  last_name: ["person.name.last"],
+  full_name: ["person.name.value"],
+  // Also used for a list name, a channel title and a search suggestion.
+  name: ["person.name.value", "company.name.value"],
+  linkedin: ["person.linkedin.url", "company.linkedin.url"],
+  linkedin_url: ["person.linkedin.url"],
+  title: ["person.job.title"],
+  job_change: ["person.job.change"],
+  job_change_status: ["person.job.change_status"],
+  company: ["company.name.value"],
+  company_name: ["company.name.value"],
+  organization_name: ["company.name.value"],
+  company_domain: ["company.domain.value"],
+  domain: ["company.domain.value"],
+  company_website: ["company.website.url"],
+  // Also used for a podcast URL.
+  website: ["company.website.url"],
+  company_linkedin_url: ["company.linkedin.url"],
+  industry: ["company.industry.value"],
+  id: ["person.record.id", "company.record.id"],
+  // Used for unrelated provider statuses; none is a catalog field.
+  status: []
+};
+function fieldOfName(name, declared) {
+  const meanings = EXTRACTOR_TARGET_FIELDS[name] ?? [];
+  if (declared === void 0) {
+    return meanings.length === 1 ? meanings[0] : void 0;
+  }
+  return meanings.some((meaning) => fieldSatisfies(declared, meaning)) ? declared : void 0;
+}
+
 // src/cli/commands/model-description.ts
 function formatModelDescription(description) {
   const lines = [];
@@ -198,7 +376,7 @@ function formatModelDescription(description) {
   );
   if (contextWindow !== null) lines.push(`Context: ${contextWindow}`);
   const tags = arrayField(description.modelMetadata, "tags").filter(
-    (value) => typeof value === "string"
+    (value2) => typeof value2 === "string"
   );
   if (tags.length) lines.push(`Tags: ${tags.join(", ")}`);
   lines.push("");
@@ -223,25 +401,25 @@ function formatModelDescription(description) {
 function appendNamespace(lines, namespace) {
   lines.push(`- ${namespace.provider} (${namespace.sourceSymbol})`);
   for (const field of namespace.fields) {
-    const values = field.enumValues?.length ? ` (${field.enumValues.map((value) => JSON.stringify(value)).join(" | ")})` : "";
+    const values = field.enumValues?.length ? ` (${field.enumValues.map((value2) => JSON.stringify(value2)).join(" | ")})` : "";
     lines.push(
       `  - ${field.name}: ${field.type}${values} - ${field.description}`
     );
   }
 }
-function stringField(value, key) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
-  const candidate = value[key];
+function stringField(value2, key) {
+  if (!value2 || typeof value2 !== "object" || Array.isArray(value2)) return null;
+  const candidate = value2[key];
   return typeof candidate === "string" && candidate.trim() ? candidate.trim() : null;
 }
-function numberField(value, key) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return null;
-  const candidate = value[key];
+function numberField(value2, key) {
+  if (!value2 || typeof value2 !== "object" || Array.isArray(value2)) return null;
+  const candidate = value2[key];
   return typeof candidate === "number" ? candidate : null;
 }
-function arrayField(value, key) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) return [];
-  const candidate = value[key];
+function arrayField(value2, key) {
+  if (!value2 || typeof value2 !== "object" || Array.isArray(value2)) return [];
+  const candidate = value2[key];
   return Array.isArray(candidate) ? candidate : [];
 }
 
@@ -279,15 +457,15 @@ function toListedTool(tool) {
     executeCommand: `deepline tools execute ${tool.toolId}`
   };
 }
-function normalizeGrepText(value) {
-  if (value === null || value === void 0) return "";
-  if (typeof value === "string") return value.toLowerCase();
-  if (typeof value === "number" || typeof value === "boolean") {
-    return String(value).toLowerCase();
+function normalizeGrepText(value2) {
+  if (value2 === null || value2 === void 0) return "";
+  if (typeof value2 === "string") return value2.toLowerCase();
+  if (typeof value2 === "number" || typeof value2 === "boolean") {
+    return String(value2).toLowerCase();
   }
-  if (Array.isArray(value)) return value.map(normalizeGrepText).join(" ");
-  if (typeof value === "object") {
-    return Object.values(value).map(normalizeGrepText).join(" ");
+  if (Array.isArray(value2)) return value2.map(normalizeGrepText).join(" ");
+  if (typeof value2 === "object") {
+    return Object.values(value2).map(normalizeGrepText).join(" ");
   }
   return "";
 }
@@ -298,15 +476,15 @@ function parseGrepTerms(query, mode) {
   const matches = trimmed.match(/"([^"]+)"|'([^']+)'|\S+/g) ?? [];
   return matches.map((term) => term.replace(/^["']|["']$/g, "").trim()).filter(Boolean);
 }
-function matchesGrepQuery(value, query, mode) {
+function matchesGrepQuery(value2, query, mode) {
   const terms = parseGrepTerms(query, mode);
   if (terms.length === 0) return true;
-  const haystack = normalizeGrepText(value);
+  const haystack = normalizeGrepText(value2);
   if (mode === "any") return terms.some((term) => haystack.includes(term));
   return terms.every((term) => haystack.includes(term));
 }
-function shellCommandArg(value) {
-  return `'${value.replace(/'/g, `'\\''`)}'`;
+function shellCommandArg(value2) {
+  return `'${value2.replace(/'/g, `'\\''`)}'`;
 }
 function zeroMatchToolGuidance(options) {
   const categories = options.categories ?? [];
@@ -683,8 +861,8 @@ async function grepTools(queryInput, options = {}) {
   return 0;
 }
 function numericToolField(tool, field) {
-  const value = tool[field];
-  return typeof value === "number" ? value : void 0;
+  const value2 = tool[field];
+  return typeof value2 === "number" ? value2 : void 0;
 }
 function compactTool(tool) {
   const listed = toListedTool(tool);
@@ -704,7 +882,7 @@ function compactTool(tool) {
   };
 }
 function playIdentifiers(play) {
-  return [play.name, play.reference, ...play.aliases ?? []].filter((value) => Boolean(value?.trim())).map((value) => value.trim());
+  return [play.name, play.reference, ...play.aliases ?? []].filter((value2) => Boolean(value2?.trim())).map((value2) => value2.trim());
 }
 async function findPlayForToolId(client, toolId, cliInvocationId) {
   const requested = toolId.trim();
@@ -940,10 +1118,15 @@ Examples:
         process.exitCode = await narrowView();
         return;
       }
-      const { describeAnything } = await import("./describe-GI5GHAKO.mjs");
+      const { describeAnything } = await import("./describe-GXGRMP2M.mjs");
       process.exitCode = await describeAnything(
         toolId,
-        { ...options, kinds: ["tools", "monitors"], fetchedTool: metadata },
+        {
+          ...options,
+          kinds: ["tools", "monitors"],
+          fetchedTool: metadata,
+          fullRecord: true
+        },
         // An unknown id keeps this command's own error and play hint.
         narrowView
       );
@@ -952,7 +1135,7 @@ Examples:
   addToolMetadataCommand(
     addDescribeOptions(
       tools.command("describe <toolId>", { hidden: true }).alias("get"),
-      { json: false }
+      { json: false, byok: false }
     )
   );
   tools.command("execute <toolId>").alias("call").description("Execute a tool by id.").addHelpText(
@@ -980,8 +1163,8 @@ Examples:
   ).option(
     "-p, --param <key=value>",
     "Pass one parameter. Repeat for multiple values.",
-    (value, acc) => {
-      acc.push(value);
+    (value2, acc) => {
+      acc.push(value2);
       return acc;
     },
     []
@@ -1079,7 +1262,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
       { toolId: resolvedToolId, byok },
       {
         json: Boolean(options.json || options.contractJson),
-        text: `${toolByokLines(resolvedToolId, byok).join("\n")}
+        text: `${[resolvedToolId, ...byokLines(byok)].join("\n")}
 `
       }
     );
@@ -1324,7 +1507,7 @@ function printMonitorTypeFilterExamples(tool) {
     const example = stringField2(grammar, "example");
     const values = [
       ...arrayField2(grammar, "examples").filter(
-        (value) => typeof value === "string" && Boolean(value)
+        (value2) => typeof value2 === "string" && Boolean(value2)
       ),
       ...example ? [example] : []
     ];
@@ -1417,6 +1600,23 @@ function schemaNodeAt(schema, path) {
   }
   return node;
 }
+var NAMED_VALUE_SHAPES = {
+  email_status: { shape: "EmailStatus", schema: EMAIL_STATUS_JSON_SCHEMA },
+  job_change: { shape: "JobChange", schema: JOB_CHANGE_JSON_SCHEMA }
+};
+function extractorValueType(name) {
+  if (!isDeeplineExtractorTarget(name)) return void 0;
+  const definition = DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS[name];
+  if (definition.enum) {
+    return {
+      type: definition.enum.map((value2) => JSON.stringify(value2)).join(" | ")
+    };
+  }
+  const named = NAMED_VALUE_SHAPES[definition.valueKind];
+  if (!named) return { type: "string" };
+  const { type, fields } = schemaField(name, named.schema, true);
+  return { type, ...fields ? { fields } : {}, shape: named.shape };
+}
 function jsonSchemaOf(wrapper) {
   return isRecord(wrapper.jsonSchema) ? wrapper.jsonSchema : wrapper;
 }
@@ -1442,7 +1642,7 @@ function publicToolSchemas(tool) {
 function describedTool(tool, requestedToolId) {
   const id = stringField2(tool, "toolId") || requestedToolId;
   const displayName = stringField2(tool, "displayName") || void 0;
-  const description = stringField2(tool, "description") || void 0;
+  const description = stringField2(tool, "bestFor", "best_for") || stringField2(tool, "description") || void 0;
   if (isMonitorTypeTool(tool)) {
     return {
       kind: "monitor_type",
@@ -1474,24 +1674,37 @@ function describedTool(tool, requestedToolId) {
       recordField(item, "details")
     ])
   );
+  const declared = recordField(tool, "extractors");
   const getterOutputs = (kind, roots) => {
     const details = getterDetails(kind);
     return arrayField2(getters, kind).filter(isRecord).map((entry) => {
       const name = stringField2(entry, "name");
-      const paths = arrayField2(
+      const rawPaths = arrayField2(
         details.get(name) ?? {},
         "rawToolOutputPaths"
-      ).map((path) => String(path).replace(/^toolResponse\.raw\./, ""));
+      ).map(String);
+      const paths = rawPaths.map(
+        (path) => path.replace(/^toolResponse\.raw\./, "")
+      );
       const node = roots.flatMap((root) => paths.map((path) => schemaNodeAt(root, path))).find(isRecord);
       const { fields, ...typed } = schemaField(name, node, true);
       const valueType = stringField2(details.get(name) ?? {}, "valueType");
+      const deepline = kind === "extractedValues" ? extractorValueType(name) : void 0;
+      const known = typed.type !== "unknown" ? void 0 : kind === "extractedLists" ? { type: "object[]" } : deepline;
+      const means = kind === "extractedValues" ? fieldOfName(
+        name,
+        stringField2(declared[name] ?? {}, "means") || void 0
+      ) : void 0;
       const field = {
         ...typed,
-        // A normalized value has a named type instead of the response's shape.
-        ...valueType ? { type: valueType } : fields ? { fields } : {},
+        ...means ? { means } : {},
+        // A normalized value has a named type instead of the response's
+        // shape; a normalized object is spelled out once under Types.
+        ...deepline?.shape ? deepline : valueType ? { type: valueType } : known ? known : fields ? { fields } : {},
         // A list's row columns that matter are value getters of their own.
         ...kind === "extractedLists" && fields ? { summarized: true } : {},
-        read: playResultExpression(entry)
+        read: playResultExpression(entry),
+        ...rawPaths.length ? { paths: rawPaths } : {}
       };
       return { field, node };
     });
@@ -1500,7 +1713,19 @@ function describedTool(tool, requestedToolId) {
   const values = getterOutputs("extractedValues", [
     outputSchema,
     ...lists.map(({ node }) => node?.items)
-  ]);
+  ]).map((value2) => {
+    if (!lists.length || !value2.field.paths) return value2;
+    const within = value2.field.paths.map(
+      (path) => path.replace(/^toolResponse\.raw\./, "")
+    );
+    const list = lists.find(
+      ({ node }) => within.some((path) => isRecord(schemaNodeAt(node?.items, path)))
+    ) ?? lists[0];
+    return {
+      ...value2,
+      field: { ...value2.field, in: list.field.name, paths: within }
+    };
+  });
   const playReference = isPlayLikeTool(tool) ? playReferenceForTool(tool) : null;
   return {
     kind: "tool",
@@ -1643,25 +1868,6 @@ function printCompactToolContract(tool, requestedToolId) {
   );
   console.log(`More: deepline describe ${contract.toolId}`);
 }
-function toolByokLines(toolId, byok) {
-  if (typeof byok.supported !== "boolean") {
-    return [`${toolId}`, "BYOK: unknown (this server does not report it)"];
-  }
-  if (!byok.supported) {
-    return [
-      `${toolId}`,
-      "BYOK: not supported. Deepline runs this tool with its own credentials."
-    ];
-  }
-  const setup = stringField2(byok, "setup");
-  const setupUrl = stringField2(byok, "setupUrl");
-  return [
-    `${toolId}`,
-    byok.required === true ? "BYOK: required. This tool runs only on your own provider credentials." : "BYOK: supported (optional).",
-    ...setup ? [`Setup: ${setup}`] : [],
-    ...setupUrl ? [`Connect: ${setupUrl}`] : []
-  ];
-}
 function toolPricingOnlyLines(tool, requestedToolId, options = {}) {
   if (isMonitorTypeTool(tool)) {
     return monitorTypePricingLines(tool);
@@ -1839,9 +2045,7 @@ function printToolGettersOnly(tool, requestedToolId) {
   const valueGetters = Array.isArray(getters.extractedValues) ? getters.extractedValues : [];
   console.log(`Getters: ${contract.toolId}`);
   if (!listGetters.length && !valueGetters.length) {
-    console.log(
-      "No generated getters declared."
-    );
+    console.log("No generated getters declared.");
     return;
   }
   if (listGetters.length) {
@@ -2031,9 +2235,9 @@ function usageGuidanceWithAccessDefaults(usageGuidance) {
     }
   };
 }
-function singleLineText(value, maxLength = 260) {
-  if (typeof value !== "string") return "";
-  const text = value.replace(/\s+/g, " ").trim();
+function singleLineText(value2, maxLength = 260) {
+  if (typeof value2 !== "string") return "";
+  const text = value2.replace(/\s+/g, " ").trim();
   if (text.length <= maxLength) return text;
   return `${text.slice(0, maxLength - 3).trimEnd()}...`;
 }
@@ -2077,8 +2281,8 @@ function toolInputFieldsForDisplay(inputSchema) {
   const jsonSchema = isRecord(inputSchema.jsonSchema) ? inputSchema.jsonSchema : inputSchema;
   const properties = isRecord(jsonSchema.properties) ? jsonSchema.properties : {};
   const required = Array.isArray(jsonSchema.required) ? new Set(jsonSchema.required.map(String)) : /* @__PURE__ */ new Set();
-  return Object.entries(properties).map(([name, value]) => {
-    const property = isRecord(value) ? value : {};
+  return Object.entries(properties).map(([name, value2]) => {
+    const property = isRecord(value2) ? value2 : {};
     return {
       name,
       type: typeof property.type === "string" ? property.type : "unknown",
@@ -2142,11 +2346,11 @@ function publicToolInputSchemaForDescribe(inputSchema) {
       withoutDeeplineCredits
     ) || /\b(?:additional|extra)\s+charges?\b/i.test(withoutDeeplineCredits) || /\bcharg(?:e|ed)\s+(?:double|per)\b/i.test(withoutDeeplineCredits) || /\bpricing page\b/i.test(withoutDeeplineCredits);
   };
-  const stripDescriptions = (value) => {
-    if (Array.isArray(value)) return value.map(stripDescriptions);
-    if (!isRecord(value)) return value;
+  const stripDescriptions = (value2) => {
+    if (Array.isArray(value2)) return value2.map(stripDescriptions);
+    if (!isRecord(value2)) return value2;
     return Object.fromEntries(
-      Object.entries(value).flatMap(([key, nested]) => {
+      Object.entries(value2).flatMap(([key, nested]) => {
         if (key === "description" && typeof nested === "string" && exposesProviderSpend(nested)) {
           return [];
         }
@@ -2160,16 +2364,16 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
   const root = canonicalToolJsonSchema(inputSchema);
   const fields = /* @__PURE__ */ new Map();
   const schemasById = /* @__PURE__ */ new Map();
-  const collectSchemaIds = (value) => {
-    if (Array.isArray(value)) {
-      for (const item of value) collectSchemaIds(item);
+  const collectSchemaIds = (value2) => {
+    if (Array.isArray(value2)) {
+      for (const item of value2) collectSchemaIds(item);
       return;
     }
-    if (!isRecord(value)) return;
-    if (typeof value.$id === "string" && value.$id.trim()) {
-      schemasById.set(value.$id.trim(), value);
+    if (!isRecord(value2)) return;
+    if (typeof value2.$id === "string" && value2.$id.trim()) {
+      schemasById.set(value2.$id.trim(), value2);
     }
-    for (const nested of Object.values(value)) collectSchemaIds(nested);
+    for (const nested of Object.values(value2)) collectSchemaIds(nested);
   };
   collectSchemaIds(root);
   const resolveRef = (schema) => {
@@ -2214,10 +2418,10 @@ function recursiveToolInputFieldsForDisplay(inputSchema) {
     const requiredNames = new Set(
       Array.isArray(schema.required) ? schema.required.map(String) : []
     );
-    for (const [name, value] of Object.entries(properties)) {
-      if (!isRecord(value)) continue;
+    for (const [name, value2] of Object.entries(properties)) {
+      if (!isRecord(value2)) continue;
       visit(
-        value,
+        value2,
         path ? `${path}.${name}` : name,
         requiredNames.has(name),
         nextActiveRefs
@@ -2265,15 +2469,15 @@ function arrayItemBoundsSuffix(field) {
   if (maxItems !== null) return `${itemTypeSuffix} maxItems=${maxItems}`;
   return itemTypeSuffix;
 }
-function printToolExecutionHints(value) {
+function printToolExecutionHints(value2) {
   const batchCapabilityRecord = recordField(
-    isRecord(value) ? value : {},
+    isRecord(value2) ? value2 : {},
     "batchCapability",
     "batch_capability"
   );
   const batchCapability = Object.keys(batchCapabilityRecord).length > 0 ? batchCapabilityRecord : null;
   const executionMetadata = recordField(
-    isRecord(value) ? value : {},
+    isRecord(value2) ? value2 : {},
     "executionMetadata",
     "execution_metadata"
   );
@@ -2429,41 +2633,41 @@ function listExtractorPathsFromUsageGuidance(tool) {
     ).filter(Boolean);
   });
 }
-function formatDecimal(value) {
-  const text = value.toFixed(12).replace(/0+$/, "").replace(/\.$/, "");
+function formatDecimal(value2) {
+  const text = value2.toFixed(12).replace(/0+$/, "").replace(/\.$/, "");
   return text || "0";
 }
-function formatUsd(value) {
-  return `$${formatDecimal(value)}`;
+function formatUsd(value2) {
+  return `$${formatDecimal(value2)}`;
 }
-function isRecord(value) {
-  return Boolean(value && typeof value === "object" && !Array.isArray(value));
+function isRecord(value2) {
+  return Boolean(value2 && typeof value2 === "object" && !Array.isArray(value2));
 }
 function stringField2(source, ...keys) {
   for (const key of keys) {
-    const value = source[key];
-    if (typeof value === "string" && value.trim()) return value.trim();
+    const value2 = source[key];
+    if (typeof value2 === "string" && value2.trim()) return value2.trim();
   }
   return "";
 }
 function numberField2(source, ...keys) {
   for (const key of keys) {
-    const value = source[key];
-    if (typeof value === "number" && Number.isFinite(value)) return value;
+    const value2 = source[key];
+    if (typeof value2 === "number" && Number.isFinite(value2)) return value2;
   }
   return null;
 }
 function arrayField2(source, ...keys) {
   for (const key of keys) {
-    const value = source[key];
-    if (Array.isArray(value)) return value;
+    const value2 = source[key];
+    if (Array.isArray(value2)) return value2;
   }
   return [];
 }
 function recordField(source, ...keys) {
   for (const key of keys) {
-    const value = source[key];
-    if (isRecord(value)) return value;
+    const value2 = source[key];
+    if (isRecord(value2)) return value2;
   }
   return {};
 }
@@ -2534,10 +2738,10 @@ function parseJsonObjectArgument(raw, flagName) {
   }
   return parsed;
 }
-function toolExecuteJsonOption(value) {
-  const legacyInput = typeof value === "string" ? value : void 0;
+function toolExecuteJsonOption(value2) {
+  const legacyInput = typeof value2 === "string" ? value2 : void 0;
   return {
-    requested: value === true || legacyInput !== void 0,
+    requested: value2 === true || legacyInput !== void 0,
     legacyInput
   };
 }
@@ -2601,10 +2805,10 @@ function parseToolExecuteTimeout(raw) {
       "--timeout must be a duration like 500ms, 90s, 10m, or 1h (a bare number is seconds)."
     );
   }
-  const value = Number(match[1]);
+  const value2 = Number(match[1]);
   const unit = (match[2] ?? "s").toLowerCase();
   const factor = unit === "ms" ? 1 : unit === "s" ? 1e3 : unit === "m" ? 6e4 : 36e5;
-  const timeoutMs = value * factor;
+  const timeoutMs = value2 * factor;
   if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 2147483647) {
     throw new Error(
       "--timeout must be between 1ms and 2147483647ms (24d 20h 31m 23s)."
@@ -2612,11 +2816,11 @@ function parseToolExecuteTimeout(raw) {
   }
   return timeoutMs;
 }
-function safeFileStem(value) {
-  return value.trim().replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "tool";
+function safeFileStem(value2) {
+  return value2.trim().replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "tool";
 }
-function powerShellQuote(value) {
-  return `'${value.replace(/'/g, "''")}'`;
+function powerShellQuote(value2) {
+  return `'${value2.replace(/'/g, "''")}'`;
 }
 function starterScriptJson(script) {
   return {
@@ -2774,7 +2978,7 @@ function buildToolExecuteBaseEnvelope(input) {
           lines: apifyRecovery ? [
             "Apify is still running. Run the follow-up command(s) below."
           ] : summaryEntries.length > 0 ? summaryEntries.map(
-            ([key, value]) => `${key}=${String(value)}`
+            ([key, value2]) => `${key}=${String(value2)}`
           ) : [JSON.stringify(input.rawResponse, null, 2)]
         },
         ...guidanceLines.length > 0 ? [{ title: "guidance", lines: guidanceLines }] : []
@@ -2856,7 +3060,7 @@ function buildToolExecuteRowArtifactEnvelope(input) {
           lines: [
             ...input.csv.columns.length > 0 ? [`columns: ${JSON.stringify(input.csv.columns)}`] : [],
             ...Object.keys(input.summary).length > 0 ? [
-              `summary: ${Object.entries(input.summary).map(([key, value]) => `${key}=${String(value)}`).join(", ")}`
+              `summary: ${Object.entries(input.summary).map(([key, value2]) => `${key}=${String(value2)}`).join(", ")}`
             ] : [],
             `preview: ${JSON.stringify(input.rowOutput.previewRows)}`,
             `starter script: ${input.seededScript.path}`