deepline 0.3.395 → 0.3.396

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

@@ -4,7 +4,7 @@ import {
   recordApiResponse,
   schemaField,
   schemaFields
-} from "./chunk-VB6KECLU.mjs";
+} from "./chunk-5WNJF2T3.mjs";
 import {
   shellQuote
 } from "./chunk-OVDNJAJN.mjs";
@@ -13,7 +13,7 @@ import {
   observedMaxText,
   recentSearchRef,
   registerDeprecatedSearchCommand
-} from "./chunk-7XAM7KDW.mjs";
+} from "./chunk-QHGPA362.mjs";
 import {
   DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS,
   EMAIL_STATUS_JSON_SCHEMA,
@@ -24,14 +24,14 @@ import {
   tryConvertToList,
   writeCsvOutputFile,
   writeJsonOutputFile
-} from "./chunk-KZZC33PY.mjs";
+} from "./chunk-H5KLUGY7.mjs";
 import {
   playToolListGetterMode
 } from "./chunk-3HU47EGZ.mjs";
 import {
   DeeplineClient,
   validateExecutionIdempotencyKey
-} from "./chunk-G4IWGRMK.mjs";
+} from "./chunk-MR6XCBQJ.mjs";
 import {
   stableStringify
 } from "./chunk-UBKA33KY.mjs";
@@ -48,11 +48,11 @@ import {
   printJsonError,
   renderCommandEnvelopeText,
   shouldEmitJson
-} from "./chunk-47M6HPGP.mjs";
+} from "./chunk-XKZXO7D3.mjs";
 import {
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-6D7A2FSL.mjs";
+} from "./chunk-VE3U3SQC.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
@@ -195,36 +195,6 @@ async function completePendingToolExecution(path, idempotencyKey) {
   }
 }
 
-// ../plays/tool-category-descriptions.ts
-var TOOL_CATEGORY_DESCRIPTIONS = {
-  company_search: "Find companies matching firmographic, ad, or web criteria.",
-  people_search: "Find people matching role, company, or persona criteria.",
-  people_enrich: "Enrich a known person with contact, social, and profile data.",
-  company_enrich: "Enrich a known company with firmographic and account data.",
-  email_finder: "Find work or personal email addresses for a person.",
-  email_verify: "Validate email deliverability and catch-all status.",
-  phone_finder: "Find mobile or direct phone numbers for a person.",
-  phone_verify: "Validate phone-number reachability and line type.",
-  research: "Research accounts, people, news, and signals for context and scoring.",
-  autocomplete: "Resolve names and entities to canonical catalog records.",
-  automation: "Kick off provider-side jobs, exports, and asynchronous workflows.",
-  outbound_tools: "Run outbound sequencing, deliverability, and campaign operations.",
-  admin: "Provider-side status, metadata, and account operations behind other tools.",
-  smb: "Look up small-business listings, local records, and public filings.",
-  identity_resolution: "Match a partial identity to a single resolved person or company.",
-  reverse_lookup: "Resolve an email, phone, or profile back to a person.",
-  enrichment: "General-purpose record enrichment across people and companies.",
-  batch: "Run an enrichment or search operation over many rows at once.",
-  premium: "Higher-cost tools with premium provider coverage.",
-  free: "Free tools that do not spend Deepline credits."
-};
-var WELL_KNOWN_TOOL_CATEGORIES = Object.freeze(
-  Object.keys(TOOL_CATEGORY_DESCRIPTIONS)
-);
-function describeToolCategory(category) {
-  return TOOL_CATEGORY_DESCRIPTIONS[category] ?? null;
-}
-
 // ../plays/field-catalog.ts
 var value = (description) => ({ type: "string", description });
 var SOURCE = {
@@ -398,116 +368,803 @@ function fieldOfName(name, declared) {
   return meanings.some((meaning) => fieldSatisfies(declared, meaning)) ? declared : void 0;
 }
 
-// src/cli/commands/model-description.ts
-function formatModelDescription(description) {
-  const lines = [];
-  lines.push(description.model);
-  lines.push(`Provider: ${description.provider}`);
-  const name = stringField(description.modelMetadata, "name");
-  if (name) lines.push(`Name: ${name}`);
-  const contextWindow = numberField(
-    description.modelMetadata,
-    "context_window"
-  );
-  if (contextWindow !== null) lines.push(`Context: ${contextWindow}`);
-  const tags = arrayField(description.modelMetadata, "tags").filter(
-    (value2) => typeof value2 === "string"
-  );
-  if (tags.length) lines.push(`Tags: ${tags.join(", ")}`);
-  lines.push("");
-  lines.push("Provider options:");
-  appendNamespace(lines, description.providerOptions.gateway);
-  if (description.providerOptions.selectedProvider) {
-    appendNamespace(lines, description.providerOptions.selectedProvider);
-  }
-  lines.push("");
-  lines.push("Example input:");
-  lines.push(JSON.stringify(description.exampleInput, null, 2));
-  if (description.caveats.length) {
-    lines.push("");
-    lines.push("Caveats:");
-    for (const caveat of description.caveats) {
-      lines.push(`- ${caveat}`);
-    }
-  }
-  return `${lines.join("\n")}
-`;
+// src/cli/described-tool.ts
+function isPlayLikeTool(tool) {
+  const record = tool;
+  if (record.isPlay === true || record.is_play === true) return true;
+  const playExpansion = recordField(record, "playExpansion", "play_expansion");
+  if (Object.keys(playExpansion).length > 0) return true;
+  const toolId = typeof record.toolId === "string" ? record.toolId : "";
+  return toolId.endsWith("_waterfall");
 }
-function appendNamespace(lines, namespace) {
-  lines.push(`- ${namespace.provider} (${namespace.sourceSymbol})`);
-  for (const field of namespace.fields) {
-    const values = field.enumValues?.length ? ` (${field.enumValues.map((value2) => JSON.stringify(value2)).join(" | ")})` : "";
-    lines.push(
-      `  - ${field.name}: ${field.type}${values} - ${field.description}`
-    );
+function isMonitorTypeTool(tool) {
+  return stringField(tool, "kind") === "monitor_type";
+}
+function playReferenceForTool(tool) {
+  const record = tool;
+  const declared = stringField(record, "playReference", "play_reference");
+  if (declared.startsWith("prebuilt/")) {
+    return declared;
   }
+  return null;
 }
-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 playSearchCommandForToolId(toolId) {
+  return `deepline search --type prebuilts ${JSON.stringify(toolId.replace(/_/g, " "))}`;
 }
-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 playRunCommandForTool(tool, toolId, input) {
+  const playReference = playReferenceForTool(tool);
+  if (!playReference) return playSearchCommandForToolId(toolId);
+  const inputArg = input === void 0 ? "'{...}'" : `'${JSON.stringify(input)}'`;
+  return `deepline plays run ${playReference} --input ${inputArg}`;
 }
-function arrayField(value2, key) {
-  if (!value2 || typeof value2 !== "object" || Array.isArray(value2)) return [];
-  const candidate = value2[key];
-  return Array.isArray(candidate) ? candidate : [];
+function toolContractJsonForDescribe(tool, requestedToolId, authoringContractEdition, seedStarterScript) {
+  const toolId = String(tool.toolId || requestedToolId);
+  const inputFields = toolInputFieldsForDisplay(
+    recordField(tool, "inputSchema", "input_schema")
+  );
+  const inputSchema = publicToolInputSchemaForDescribe(
+    recordField(tool, "inputSchema", "input_schema")
+  );
+  const outputSchemaRecord = recordField(tool, "outputSchema", "output_schema");
+  const outputFields = toolOutputFieldsForDisplay(outputSchemaRecord);
+  const usageGuidance = recordField(tool, "usageGuidance", "usage_guidance");
+  const guidance = recordField(tool, "guidance");
+  const toolExecutionResult = recordField(
+    usageGuidance,
+    "toolExecutionResult",
+    "tool_execution_result"
+  );
+  const extractedLists = extractionContractEntries(
+    arrayField(toolExecutionResult, "extractedLists", "extracted_lists")
+  ).map((entry) => ({
+    ...entry,
+    returnType: playToolListGetterMode(authoringContractEdition) === "array" ? "Array" : "PlayDataset",
+    rowsExpression: playToolListGetterMode(authoringContractEdition) === "array" ? entry.expression : `await ${entry.expression}.materialize()`
+  }));
+  const extractedValues = extractionContractEntries(
+    arrayField(toolExecutionResult, "extractedValues", "extracted_values")
+  );
+  const pricing = Capability.fromCatalogEntry(tool).describe().customerCost();
+  const executionMetadataRecord = recordField(
+    tool,
+    "executionMetadata",
+    "execution_metadata"
+  );
+  const executionMetadata = Object.keys(executionMetadataRecord).length > 0 ? executionMetadataRecord : null;
+  const batchCapabilityRecord = recordField(
+    tool,
+    "batchCapability",
+    "batch_capability"
+  );
+  const batchCapability = Object.keys(batchCapabilityRecord).length > 0 ? batchCapabilityRecord : null;
+  const deprecation = recordField(tool, "deprecation");
+  const replacementToolId = stringField(
+    deprecation,
+    "replacementToolId",
+    "replacement_tool_id"
+  );
+  const deprecationMessage = stringField(deprecation, "message");
+  const deprecationExecution = stringField(deprecation, "execution");
+  const deprecated = tool.deprecated === true || stringField(tool, "credentialStatus", "credential_status") === "deprecated";
+  const starterScript = seedStarterScript && !deprecated && !isPlayLikeTool(tool) && extractedLists.length > 0 ? starterScriptJson(
+    seedStarterScript({
+      toolId,
+      payload: samplePayloadForInputFields(inputFields),
+      rows: []
+    })
+  ) : null;
+  const executeCommand = deprecated && replacementToolId ? `deepline tools execute ${replacementToolId} --input '{...}'` : isPlayLikeTool(tool) ? playRunCommandForTool(tool, toolId) : `deepline tools execute ${toolId} --input '{...}'`;
+  return {
+    schemaVersion: 1,
+    toolId,
+    provider: tool.provider,
+    displayName: tool.displayName,
+    cost: pricing,
+    description: tool.description,
+    ...Object.keys(guidance).length > 0 ? { guidance } : {},
+    categories: tool.categories,
+    ...Array.isArray(tool.requestWarnings) ? { requestWarnings: tool.requestWarnings } : {},
+    ...deprecated ? {
+      deprecated: true,
+      callable: tool.callable !== false,
+      deprecation: {
+        replacementToolId,
+        message: deprecationMessage,
+        ...deprecationExecution ? { execution: deprecationExecution } : {}
+      }
+    } : {},
+    inputFields: inputFields.map(inputFieldJsonForDescribe),
+    inputSchema,
+    ...isRecord(tool.responseSchema) ? { responseSchema: tool.responseSchema } : {},
+    ...Array.isArray(tool.examples) ? { examples: tool.examples } : {},
+    responseAccess: "result.toolResponse.rawV2",
+    ...Object.keys(outputSchemaRecord).length > 0 ? {
+      outputSchema: publicToolInputSchemaForDescribe(outputSchemaRecord),
+      outputFields: outputFields.map(inputFieldJsonForDescribe)
+    } : {},
+    ...executionMetadata ? { executionMetadata } : {},
+    ...batchCapability ? { batchCapability } : {},
+    getters: {
+      extractedLists,
+      extractedValues
+    },
+    executeCommand,
+    ...starterScript ? { starterScript } : {}
+  };
 }
-
-// src/cli/tool-connection-status.ts
-function toolConnectionStatusMessage(input) {
-  if (input.credentialStatus === "requires_connection") {
-    return "requires your credentials \u2014 not connected (connect to use)";
-  }
-  if (input.connected === false && input.credentialStatus === "managed") {
-    return "temporarily unavailable";
+function extractionContractEntries(entries) {
+  return entries.flatMap((entry) => {
+    if (!isRecord(entry)) return [];
+    const name = stringField(entry, "name");
+    const expression = stringField(entry, "expression");
+    return name && expression ? [{ name, expression }] : [];
+  });
+}
+function schemaNodeAt(schema, path) {
+  let node = schema;
+  for (const part of path.split(".").filter(Boolean)) {
+    const [key, ...indexes] = part.split("[");
+    node = recordField(isRecord(node) ? node : {}, "properties")[key];
+    for (const _index of indexes)
+      node = isRecord(node) ? node.items : void 0;
   }
-  return null;
+  return node;
 }
-
-// src/cli/commands/tools.ts
-var TOOL_COMMAND_TEMPLATES = {
-  describe: "deepline describe <toolId>",
-  execute: "deepline tools execute <toolId> --input '{...}'"
+var NAMED_VALUE_SHAPES = {
+  email_status: { shape: "EmailStatus", schema: EMAIL_STATUS_JSON_SCHEMA },
+  job_change: { shape: "JobChange", schema: JOB_CHANGE_JSON_SCHEMA }
 };
-function toListedTool(tool) {
-  if (isPlayLikeTool(tool)) {
+function extractorValueType(name) {
+  if (!isDeeplineExtractorTarget(name)) return void 0;
+  const definition = DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS[name];
+  if (definition.enum) {
     return {
-      ...tool,
-      description: listedToolDescription(tool),
-      id: tool.toolId,
-      type: "play",
-      executeCommand: playRunCommandForTool(tool, tool.toolId)
+      type: definition.enum.map((value2) => JSON.stringify(value2)).join(" | ")
     };
   }
-  return {
-    ...tool,
-    description: listedToolDescription(tool),
-    id: tool.toolId,
-    type: "tool",
-    executeCommand: `deepline tools execute ${tool.toolId}`
-  };
+  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 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(value2)) return value2.map(normalizeGrepText).join(" ");
-  if (typeof value2 === "object") {
-    return Object.values(value2).map(normalizeGrepText).join(" ");
-  }
-  return "";
+function jsonSchemaOf(wrapper) {
+  return isRecord(wrapper.jsonSchema) ? wrapper.jsonSchema : wrapper;
 }
-function parseGrepTerms(query, mode) {
-  const trimmed = query.trim().toLowerCase();
-  if (!trimmed) return [];
-  if (mode === "phrase") return [trimmed];
+function publicToolSchemas(tool) {
+  const scrubbed = (...keys) => {
+    const schema = recordField(tool, ...keys);
+    if (Object.keys(schema).length === 0) return null;
+    const cleaned = publicToolInputSchemaForDescribe(schema);
+    return isRecord(cleaned.jsonSchema) ? cleaned.jsonSchema : cleaned;
+  };
+  const responseSchema = scrubbed("responseSchema", "response_schema");
+  return {
+    inputSchema: scrubbed(
+      "inputSchema",
+      "input_schema",
+      "payload_schema",
+      "payloadSchema"
+    ),
+    outputSchema: scrubbed("outputSchema", "output_schema"),
+    ...responseSchema ? { responseSchema } : {}
+  };
+}
+function describedTool(tool, requestedToolId) {
+  const id = stringField(tool, "toolId") || requestedToolId;
+  const displayName = stringField(tool, "displayName") || void 0;
+  const description = stringField(tool, "bestFor", "best_for") || stringField(tool, "description") || void 0;
+  if (isMonitorTypeTool(tool)) {
+    return {
+      kind: "monitor_type",
+      id,
+      displayName,
+      description,
+      cost: stringField(recordField(tool, "pricing"), "displayText") || void 0,
+      guidance: [],
+      inputs: schemaFields(
+        recordField(tool, "payload_schema", "payloadSchema")
+      ),
+      outputs: [],
+      runner: {
+        via: "monitor",
+        deploy: stringField(recordField(tool, "deploy"), "example") || `deepline monitors deploy '{"key":"...","tool":"${id}","payload":{...}}'`
+      }
+    };
+  }
+  const contract = toolContractJsonForDescribe(tool, requestedToolId);
+  const cost = recordField(contract, "cost");
+  const billing = stringField(cost, "billingSourceLabel");
+  const deprecation = recordField(contract, "deprecation");
+  const getters = recordField(contract, "getters");
+  const outputSchema = jsonSchemaOf(recordField(contract, "outputSchema"));
+  const toolResult = recordField(tool, "toolResult", "tool_result");
+  const getterDetails = (kind) => new Map(
+    arrayField(toolResult, kind).filter(isRecord).map((item) => [
+      stringField(item, "name"),
+      recordField(item, "details")
+    ])
+  );
+  const declared = recordField(tool, "extractors");
+  const getterOutputs = (kind, roots) => {
+    const details = getterDetails(kind);
+    return arrayField(getters, kind).filter(isRecord).map((entry) => {
+      const name = stringField(entry, "name");
+      const rawPaths = arrayField(
+        details.get(name) ?? {},
+        "rawToolOutputPaths"
+      ).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 = stringField(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,
+        stringField(declared[name] ?? {}, "means") || void 0
+      ) : void 0;
+      const field = {
+        ...typed,
+        ...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),
+        ...rawPaths.length ? { paths: rawPaths } : {}
+      };
+      return { field, node };
+    });
+  };
+  const declaredLists = getterOutputs("extractedLists", [outputSchema]);
+  const lists = declaredLists.some(({ node }) => node) ? declaredLists.filter(({ node }) => node) : declaredLists;
+  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",
+    id: String(contract.toolId),
+    displayName,
+    description,
+    cost: [
+      stringField(cost, "displayText"),
+      // "Free (free)" says the same thing twice.
+      billing.toLowerCase() === stringField(cost, "displayText").toLowerCase() ? "" : billing && `(${billing})`,
+      observedMaxText(cost) && `\u2014 ${observedMaxText(cost)}`
+    ].filter(Boolean).join(" ") || void 0,
+    guidance: [
+      ...contract.deprecated === true ? [`Deprecated. ${stringField(deprecation, "message")}`.trim()] : [],
+      ...Object.values(recordField(contract, "guidance")).filter(
+        (line) => typeof line === "string" && /[a-z0-9]/i.test(line)
+      )
+    ],
+    rateLimit: rateLimitSummary(
+      recordField(contract, "executionMetadata").configuredRateLimits
+    ),
+    inputs: schemaFields(jsonSchemaOf(recordField(contract, "inputSchema"))),
+    outputs: [...lists, ...values].map(({ field }) => field),
+    rawResponse: schemaFields(outputSchema),
+    runner: playReference ? { via: "play", reference: playReference } : { via: "tool", toolId: String(contract.toolId) }
+  };
+}
+function sampleValueForField(field) {
+  const name = stringField(field, "name").toLowerCase();
+  const type = stringField(field, "type").toLowerCase();
+  if (Object.prototype.hasOwnProperty.call(field, "default"))
+    return field.default;
+  if (name.includes("email")) return "ada@example.com";
+  if (name.includes("domain") || name.includes("website")) return "example.com";
+  if (name.includes("first")) return "Ada";
+  if (name.includes("last")) return "Lovelace";
+  if (name.includes("name")) return "Ada Lovelace";
+  if (type === "integer" || type === "number") return 1;
+  if (type === "boolean") return true;
+  if (type === "array") return [];
+  if (type === "object") return {};
+  return "...";
+}
+function samplePayloadForInputFields(fields) {
+  return Object.fromEntries(
+    fields.slice(0, 4).flatMap((field) => {
+      if (!isRecord(field)) return [];
+      const name = stringField(field, "name");
+      if (!name) return [];
+      return [[name, sampleValueForField(field)]];
+    })
+  );
+}
+function playResultExpression(entry) {
+  return stringField(entry, "expression").replace(
+    /^toolExecutionResult\./,
+    "result."
+  );
+}
+function toolMetadataJsonForDescribe(tool, requestedToolId, seedStarterScript) {
+  const toolId = String(tool.toolId || requestedToolId);
+  const inputFields = toolInputFieldsForDisplay(
+    recordField(tool, "inputSchema", "input_schema")
+  );
+  const usageGuidance = usageGuidanceWithAccessDefaults(
+    recordField(tool, "usageGuidance", "usage_guidance")
+  );
+  const toolExecutionResult = recordField(
+    usageGuidance,
+    "toolExecutionResult",
+    "tool_execution_result"
+  );
+  const extractedLists = extractionContractEntries(
+    arrayField(toolExecutionResult, "extractedLists", "extracted_lists")
+  );
+  const starterScript = seedStarterScript && !isPlayLikeTool(tool) && extractedLists.length > 0 ? starterScriptJson(
+    seedStarterScript({
+      toolId,
+      payload: samplePayloadForInputFields(inputFields),
+      rows: []
+    })
+  ) : null;
+  const observedOutputCommand = isPlayLikeTool(tool) ? playRunCommandForTool(tool, toolId) : `deepline tools execute ${toolId} --input '{...}'`;
+  const {
+    cost: _cost,
+    deeplineCreditsPerPricingUnit: _deeplineCreditsPerPricingUnit,
+    deeplineUsdPerPricingUnit: _deeplineUsdPerPricingUnit,
+    deeplineUsdPerCredit: _deeplineUsdPerCredit,
+    deeplinePricingSummary: _deeplinePricingSummary,
+    deeplinePricingDetails: _deeplinePricingDetails,
+    deepline_credits_per_pricing_unit: _snakeDeeplineCreditsPerPricingUnit,
+    deepline_usd_per_pricing_unit: _snakeDeeplineUsdPerPricingUnit,
+    deepline_usd_per_credit: _snakeDeeplineUsdPerCredit,
+    deepline_pricing_summary: _snakeDeeplinePricingSummary,
+    deepline_pricing_details: _snakeDeeplinePricingDetails,
+    // BYOK is shown only on request, via describe --feature byok.
+    byok: _byok,
+    ...publicTool
+  } = tool;
+  const outputSchemaRecord = recordField(tool, "outputSchema", "output_schema");
+  return {
+    cost: Capability.fromCatalogEntry(tool).describe().customerCost(),
+    ...publicTool,
+    toolId,
+    provider: tool.provider,
+    displayName: tool.displayName,
+    ...Object.keys(outputSchemaRecord).length > 0 ? {
+      outputSchema: publicToolInputSchemaForDescribe(outputSchemaRecord),
+      outputFields: toolOutputFieldsForDisplay(outputSchemaRecord).map(
+        inputFieldJsonForDescribe
+      )
+    } : {},
+    inputFields: inputFields.map(inputFieldJsonForDescribe),
+    usageGuidance,
+    runtimeOutputHelp: {
+      contract: "Schemas declare field shapes. Examples illustrate input payloads and full Deepline execution responses; they are not observed responses from this call.",
+      getterScope: "extractedValues/extractedLists .get() only works for declared Deepline getters listed in usageGuidance.toolExecutionResult.",
+      rawToolResponse: "Use toolExecutionResult.toolResponse.rawV2 for the complete tool response. Preserve its nesting and sibling fields as shown in examples; use declared getters for extracted values and lists.",
+      invalidGetterHint: "If TypeScript says an extractedValues/extractedLists property does not exist, that field is not a declared Deepline getter.",
+      observeActualShape: observedOutputCommand,
+      observedOutput: observedOutputCommand,
+      forPlayGetterBugs: "Run a tiny play, inspect returned handles with `deepline runs get <run-id> --full`, then export row datasets with `deepline runs export`.",
+      executeOutputFields: "tools execute JSON may include output_preview for this direct probe only; play debugging uses run output and returned dataset handles."
+    },
+    ...starterScript ? { starterScript } : {}
+  };
+}
+function usageGuidanceWithAccessDefaults(usageGuidance) {
+  if (Object.keys(usageGuidance).length === 0) return usageGuidance;
+  const existingAccess = recordField(usageGuidance, "access");
+  return {
+    ...usageGuidance,
+    prefer: [
+      "Use only the declared extractedLists and extractedValues getters listed below.",
+      "Use toolExecutionResult.toolResponse.rawV2 for the complete tool response, preserving the nesting shown in the response example.",
+      "Schemas declare field shapes; examples illustrate input values and full Deepline execution responses."
+    ],
+    toolExecutionResult: {
+      ...recordField(
+        usageGuidance,
+        "toolExecutionResult",
+        "tool_execution_result"
+      ),
+      toolResponse: {
+        rawV2: "toolResponse.rawV2",
+        view: "toolResponse.view",
+        responseMeta: "toolResponse.responseMeta"
+      }
+    },
+    access: {
+      ...existingAccess,
+      extractedValues: {
+        expression: "toolExecutionResult.extractedValues.<name>.get()",
+        meaning: "Declared Deepline scalar or normalized object extractors only."
+      },
+      ...existingAccess,
+      extractedLists: {
+        ...recordField(existingAccess, "extractedLists"),
+        expression: "toolExecutionResult.extractedLists.<name>.get()",
+        meaning: playToolListGetterMode() === "array" ? "Returns an ordinary array from this response. Use array methods directly or pass it to ctx.dataset to persist row work. Lazy or incomplete lists throw; use readList for an explicit dataset read. It does not fetch provider pages." : "Returns a PlayDataset, not a JavaScript array. Pass the handle to ctx.dataset, use first(), async iteration, or await handle.materialize() for the complete current list within the memory cap. materialize(n) and peek(n) return a prefix; none fetch additional provider pages. A missing getter is not an empty list."
+      },
+      rawToolResponse: {
+        expression: "toolExecutionResult.toolResponse.rawV2",
+        meaning: "Complete tool response with its original nesting. Read tool-specific fields here; use declared getters for extracted values and lists."
+      },
+      canonicalToolResponse: {
+        expression: "toolExecutionResult.toolResponse.rawV2",
+        meaning: "Complete tool response with its original nesting and sibling fields."
+      },
+      invalidGetterHint: "If TypeScript says an extractedValues/extractedLists property does not exist, that field is not a declared Deepline getter; read it from toolResponse.rawV2 using the nesting shown in the response example."
+    }
+  };
+}
+function toolInputFieldsForDisplay(inputSchema) {
+  if (Array.isArray(inputSchema.fields)) {
+    const fields = inputSchema.fields.filter(isRecord);
+    if (!isRecord(inputSchema.jsonSchema)) return fields;
+    const jsonSchemaFields = new Map(
+      recursiveToolInputFieldsForDisplay({
+        jsonSchema: inputSchema.jsonSchema
+      }).flatMap(
+        (field) => typeof field.name === "string" ? [[field.name, field]] : []
+      )
+    );
+    return fields.map((field) => {
+      const jsonSchemaField = typeof field.name === "string" ? jsonSchemaFields.get(field.name) : void 0;
+      const minItems = typeof field.minItems === "number" ? field.minItems : jsonSchemaField?.minItems;
+      const maxItems = typeof field.maxItems === "number" ? field.maxItems : jsonSchemaField?.maxItems;
+      const items = isRecord(field.items) ? field.items : jsonSchemaField?.items;
+      return {
+        ...field,
+        ...isRecord(items) ? { items } : {},
+        ...typeof minItems === "number" ? { minItems } : {},
+        ...typeof maxItems === "number" ? { maxItems } : {}
+      };
+    });
+  }
+  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, value2]) => {
+    const property = isRecord(value2) ? value2 : {};
+    return {
+      name,
+      type: typeof property.type === "string" ? property.type : "unknown",
+      required: required.has(name),
+      description: property.description,
+      ...isRecord(property.items) ? { items: property.items } : {},
+      ...typeof property.minItems === "number" ? { minItems: property.minItems } : {},
+      ...typeof property.maxItems === "number" ? { maxItems: property.maxItems } : {},
+      ...Object.prototype.hasOwnProperty.call(property, "default") ? { default: property.default } : {}
+    };
+  });
+}
+function toolOutputFieldsForDisplay(outputSchema) {
+  if (Object.keys(outputSchema).length === 0) return [];
+  return recursiveToolInputFieldsForDisplay({
+    jsonSchema: outputSchema
+  }).filter(
+    (field) => typeof field.name === "string" && field.name.includes("[]")
+  );
+}
+function canonicalToolJsonSchema(inputSchema) {
+  return isRecord(inputSchema.jsonSchema) ? inputSchema.jsonSchema : inputSchema;
+}
+function publicToolInputSchemaForDescribe(inputSchema) {
+  const exposesProviderSpend = (description) => {
+    const withoutDeeplineCredits = description.replace(
+      /\bdeepline(?:-facing)?\s+credits?\b/gi,
+      ""
+    );
+    return /\bcredits?\b/i.test(withoutDeeplineCredits) || /\bprovider\s+(?:cost|spend|price|pricing|usage)\b/i.test(
+      withoutDeeplineCredits
+    ) || /\b(?:costs?|charges?|priced at)\s+[$€£]\s*\d/i.test(
+      withoutDeeplineCredits
+    ) || /\b(?:costs?|charges?|priced at)\s+\d+(?:\.\d+)?\s*(?:usd|eur|gbp)\b/i.test(
+      withoutDeeplineCredits
+    ) || /\battribute-priced\b/i.test(withoutDeeplineCredits) || /\b(?:cost|price|pricing)\s+(?:grows?|increases?|scales?|varies?)\b/i.test(
+      withoutDeeplineCredits
+    ) || /\b(?:will be|are|is|be)\s+(?:billed|charged)\b/i.test(
+      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 = (value2) => {
+    if (Array.isArray(value2)) return value2.map(stripDescriptions);
+    if (!isRecord(value2)) return value2;
+    return Object.fromEntries(
+      Object.entries(value2).flatMap(([key, nested]) => {
+        if (key === "description" && typeof nested === "string" && exposesProviderSpend(nested)) {
+          return [];
+        }
+        return [[key, stripDescriptions(nested)]];
+      })
+    );
+  };
+  return stripDescriptions(inputSchema);
+}
+function recursiveToolInputFieldsForDisplay(inputSchema) {
+  const root = canonicalToolJsonSchema(inputSchema);
+  const fields = /* @__PURE__ */ new Map();
+  const schemasById = /* @__PURE__ */ new Map();
+  const collectSchemaIds = (value2) => {
+    if (Array.isArray(value2)) {
+      for (const item of value2) collectSchemaIds(item);
+      return;
+    }
+    if (!isRecord(value2)) return;
+    if (typeof value2.$id === "string" && value2.$id.trim()) {
+      schemasById.set(value2.$id.trim(), value2);
+    }
+    for (const nested of Object.values(value2)) collectSchemaIds(nested);
+  };
+  collectSchemaIds(root);
+  const resolveRef = (schema) => {
+    const ref = typeof schema.$ref === "string" ? schema.$ref : "";
+    if (!ref.startsWith("#/")) return schemasById.get(ref) ?? schema;
+    let current = root;
+    for (const rawSegment of ref.slice(2).split("/")) {
+      const segment = rawSegment.replace(/~1/g, "/").replace(/~0/g, "~");
+      if (!isRecord(current)) return schema;
+      current = current[segment];
+    }
+    return isRecord(current) ? current : schema;
+  };
+  const addField = (field) => {
+    const name = typeof field.name === "string" ? field.name : "";
+    if (!name) return;
+    const existing = fields.get(name);
+    if (!existing || existing.type === "unknown") {
+      fields.set(name, field);
+    }
+  };
+  const visit = (unresolvedSchema, path, required, activeRefs = /* @__PURE__ */ new Set()) => {
+    const ref = typeof unresolvedSchema.$ref === "string" ? unresolvedSchema.$ref : "";
+    if (ref && activeRefs.has(ref)) return;
+    const schema = resolveRef(unresolvedSchema);
+    const nextActiveRefs = ref ? /* @__PURE__ */ new Set([...activeRefs, ref]) : activeRefs;
+    const type = Array.isArray(schema.type) ? schema.type.map(String).join("|") : typeof schema.type === "string" ? schema.type : isRecord(schema.properties) ? "object" : schema.items ? "array" : "unknown";
+    if (path) {
+      addField({
+        name: path,
+        type,
+        required,
+        description: schema.description,
+        ...Array.isArray(schema.enum) ? { enum: schema.enum } : {},
+        ...isRecord(schema.items) ? { items: schema.items } : {},
+        ...typeof schema.minItems === "number" ? { minItems: schema.minItems } : {},
+        ...typeof schema.maxItems === "number" ? { maxItems: schema.maxItems } : {},
+        ...Object.prototype.hasOwnProperty.call(schema, "default") ? { default: schema.default } : {}
+      });
+    }
+    const properties = isRecord(schema.properties) ? schema.properties : {};
+    const requiredNames = new Set(
+      Array.isArray(schema.required) ? schema.required.map(String) : []
+    );
+    for (const [name, value2] of Object.entries(properties)) {
+      if (!isRecord(value2)) continue;
+      visit(
+        value2,
+        path ? `${path}.${name}` : name,
+        requiredNames.has(name),
+        nextActiveRefs
+      );
+    }
+    if (isRecord(schema.items)) {
+      visit(schema.items, `${path}[]`, false, nextActiveRefs);
+    }
+    for (const keyword of ["anyOf", "oneOf", "allOf"]) {
+      const branches = Array.isArray(schema[keyword]) ? schema[keyword] : [];
+      for (const branch of branches) {
+        if (isRecord(branch)) {
+          visit(branch, path, required, nextActiveRefs);
+        }
+      }
+    }
+  };
+  visit(root, "", false);
+  return fields.size ? [...fields.values()] : toolInputFieldsForDisplay(inputSchema);
+}
+function inputFieldJsonForDescribe(field) {
+  const publicItems = isRecord(field.items) ? publicToolInputSchemaForDescribe({ items: field.items }).items : void 0;
+  return {
+    name: field.name,
+    type: field.type ?? "unknown",
+    required: Boolean(field.required),
+    ...field.description ? { description: field.description } : {},
+    ...isRecord(publicItems) ? { items: publicItems } : {},
+    ...typeof field.minItems === "number" ? { minItems: field.minItems } : {},
+    ...typeof field.maxItems === "number" ? { maxItems: field.maxItems } : {},
+    ...Object.prototype.hasOwnProperty.call(field, "default") ? { default: field.default } : {}
+  };
+}
+function isRecord(value2) {
+  return Boolean(value2 && typeof value2 === "object" && !Array.isArray(value2));
+}
+function stringField(source, ...keys) {
+  for (const key of keys) {
+    const value2 = source[key];
+    if (typeof value2 === "string" && value2.trim()) return value2.trim();
+  }
+  return "";
+}
+function arrayField(source, ...keys) {
+  for (const key of keys) {
+    const value2 = source[key];
+    if (Array.isArray(value2)) return value2;
+  }
+  return [];
+}
+function recordField(source, ...keys) {
+  for (const key of keys) {
+    const value2 = source[key];
+    if (isRecord(value2)) return value2;
+  }
+  return {};
+}
+function starterScriptJson(script) {
+  return {
+    path: script.path,
+    sourceCode: script.sourceCode,
+    projectDir: script.projectDir,
+    copyToProject: {
+      macosLinux: script.macCopyCommand,
+      windowsPowerShell: script.windowsCopyCommand
+    }
+  };
+}
+
+// ../plays/tool-category-descriptions.ts
+var TOOL_CATEGORY_DESCRIPTIONS = {
+  company_search: "Find companies matching firmographic, ad, or web criteria.",
+  people_search: "Find people matching role, company, or persona criteria.",
+  people_enrich: "Enrich a known person with contact, social, and profile data.",
+  company_enrich: "Enrich a known company with firmographic and account data.",
+  email_finder: "Find work or personal email addresses for a person.",
+  email_verify: "Validate email deliverability and catch-all status.",
+  phone_finder: "Find mobile or direct phone numbers for a person.",
+  phone_verify: "Validate phone-number reachability and line type.",
+  research: "Research accounts, people, news, and signals for context and scoring.",
+  autocomplete: "Resolve names and entities to canonical catalog records.",
+  automation: "Kick off provider-side jobs, exports, and asynchronous workflows.",
+  outbound_tools: "Run outbound sequencing, deliverability, and campaign operations.",
+  admin: "Provider-side status, metadata, and account operations behind other tools.",
+  smb: "Look up small-business listings, local records, and public filings.",
+  identity_resolution: "Match a partial identity to a single resolved person or company.",
+  reverse_lookup: "Resolve an email, phone, or profile back to a person.",
+  enrichment: "General-purpose record enrichment across people and companies.",
+  batch: "Run an enrichment or search operation over many rows at once.",
+  premium: "Higher-cost tools with premium provider coverage.",
+  free: "Free tools that do not spend Deepline credits."
+};
+var WELL_KNOWN_TOOL_CATEGORIES = Object.freeze(
+  Object.keys(TOOL_CATEGORY_DESCRIPTIONS)
+);
+function describeToolCategory(category) {
+  return TOOL_CATEGORY_DESCRIPTIONS[category] ?? null;
+}
+
+// src/cli/commands/model-description.ts
+function formatModelDescription(description) {
+  const lines = [];
+  lines.push(description.model);
+  lines.push(`Provider: ${description.provider}`);
+  const name = stringField2(description.modelMetadata, "name");
+  if (name) lines.push(`Name: ${name}`);
+  const contextWindow = numberField(
+    description.modelMetadata,
+    "context_window"
+  );
+  if (contextWindow !== null) lines.push(`Context: ${contextWindow}`);
+  const tags = arrayField2(description.modelMetadata, "tags").filter(
+    (value2) => typeof value2 === "string"
+  );
+  if (tags.length) lines.push(`Tags: ${tags.join(", ")}`);
+  lines.push("");
+  lines.push("Provider options:");
+  appendNamespace(lines, description.providerOptions.gateway);
+  if (description.providerOptions.selectedProvider) {
+    appendNamespace(lines, description.providerOptions.selectedProvider);
+  }
+  lines.push("");
+  lines.push("Example input:");
+  lines.push(JSON.stringify(description.exampleInput, null, 2));
+  if (description.caveats.length) {
+    lines.push("");
+    lines.push("Caveats:");
+    for (const caveat of description.caveats) {
+      lines.push(`- ${caveat}`);
+    }
+  }
+  return `${lines.join("\n")}
+`;
+}
+function appendNamespace(lines, namespace) {
+  lines.push(`- ${namespace.provider} (${namespace.sourceSymbol})`);
+  for (const field of namespace.fields) {
+    const values = field.enumValues?.length ? ` (${field.enumValues.map((value2) => JSON.stringify(value2)).join(" | ")})` : "";
+    lines.push(
+      `  - ${field.name}: ${field.type}${values} - ${field.description}`
+    );
+  }
+}
+function stringField2(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(value2, key) {
+  if (!value2 || typeof value2 !== "object" || Array.isArray(value2)) return null;
+  const candidate = value2[key];
+  return typeof candidate === "number" ? candidate : null;
+}
+function arrayField2(value2, key) {
+  if (!value2 || typeof value2 !== "object" || Array.isArray(value2)) return [];
+  const candidate = value2[key];
+  return Array.isArray(candidate) ? candidate : [];
+}
+
+// src/cli/tool-connection-status.ts
+function toolConnectionStatusMessage(input) {
+  if (input.credentialStatus === "requires_connection") {
+    return "requires your credentials \u2014 not connected (connect to use)";
+  }
+  if (input.connected === false && input.credentialStatus === "managed") {
+    return "temporarily unavailable";
+  }
+  return null;
+}
+
+// src/cli/commands/tools.ts
+var TOOL_COMMAND_TEMPLATES = {
+  describe: "deepline describe <toolId>",
+  execute: "deepline tools execute <toolId> --input '{...}'"
+};
+function toListedTool(tool) {
+  if (isPlayLikeTool(tool)) {
+    return {
+      ...tool,
+      description: listedToolDescription(tool),
+      id: tool.toolId,
+      type: "play",
+      executeCommand: playRunCommandForTool(tool, tool.toolId)
+    };
+  }
+  return {
+    ...tool,
+    description: listedToolDescription(tool),
+    id: tool.toolId,
+    type: "tool",
+    executeCommand: `deepline tools execute ${tool.toolId}`
+  };
+}
+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(value2)) return value2.map(normalizeGrepText).join(" ");
+  if (typeof value2 === "object") {
+    return Object.values(value2).map(normalizeGrepText).join(" ");
+  }
+  return "";
+}
+function parseGrepTerms(query, mode) {
+  const trimmed = query.trim().toLowerCase();
+  if (!trimmed) return [];
+  if (mode === "phrase") return [trimmed];
   const matches = trimmed.match(/"([^"]+)"|'([^']+)'|\S+/g) ?? [];
   return matches.map((term) => term.replace(/^["']|["']$/g, "").trim()).filter(Boolean);
 }
@@ -591,7 +1248,7 @@ function requiredInputIds(tool) {
 }
 function notConnectedSuffix(tool) {
   const record = tool;
-  const status = stringField2(record, "credentialStatus", "credential_status");
+  const status = stringField(record, "credentialStatus", "credential_status");
   const connected = record.connected;
   const message = toolConnectionStatusMessage({
     connected: connected === false ? false : void 0,
@@ -605,13 +1262,13 @@ function shortPricingHint(tool) {
     "pricing"
   );
   const credits = numberField2(pricing, "creditsPerUnit", "credits_per_unit");
-  const unit = stringField2(pricing, "unit");
+  const unit = stringField(pricing, "unit");
   if (credits !== null) {
     return `${formatDecimal(credits)} cr/${unit || "unit"}`;
   }
-  const summary = stringField2(pricing, "summary");
+  const summary = stringField(pricing, "summary");
   if (summary) return summary;
-  const displayText = stringField2(pricing, "displayText", "display_text");
+  const displayText = stringField(pricing, "displayText", "display_text");
   return displayText || null;
 }
 function aggregateCategorySummaries(tools) {
@@ -943,34 +1600,6 @@ Inspect its schema with: deepline describe ${playName}`;
 function printPlayAliasToolError(toolId, play) {
   console.error(playAliasToolErrorMessage(toolId, play));
 }
-function isPlayLikeTool(tool) {
-  const record = tool;
-  if (record.isPlay === true || record.is_play === true) return true;
-  const playExpansion = recordField(record, "playExpansion", "play_expansion");
-  if (Object.keys(playExpansion).length > 0) return true;
-  const toolId = typeof record.toolId === "string" ? record.toolId : "";
-  return toolId.endsWith("_waterfall");
-}
-function isMonitorTypeTool(tool) {
-  return stringField2(tool, "kind") === "monitor_type";
-}
-function playReferenceForTool(tool) {
-  const record = tool;
-  const declared = stringField2(record, "playReference", "play_reference");
-  if (declared.startsWith("prebuilt/")) {
-    return declared;
-  }
-  return null;
-}
-function playSearchCommandForToolId(toolId) {
-  return `deepline search --type prebuilts ${JSON.stringify(toolId.replace(/_/g, " "))}`;
-}
-function playRunCommandForTool(tool, toolId, input) {
-  const playReference = playReferenceForTool(tool);
-  if (!playReference) return playSearchCommandForToolId(toolId);
-  const inputArg = input === void 0 ? "'{...}'" : `'${JSON.stringify(input)}'`;
-  return `deepline plays run ${playReference} --input ${inputArg}`;
-}
 function playLikeToolExecuteErrorMessage(toolId, tool) {
   const playReference = tool ? playReferenceForTool(tool) : null;
   const nextStep = playReference ? `Use: deepline plays run ${playReference} --input '{...}'` : `Find the maintained workflow with: ${playSearchCommandForToolId(toolId)}`;
@@ -1188,7 +1817,7 @@ Examples:
         process.exitCode = await narrowView();
         return;
       }
-      const { describeAnything } = await import("./describe-DBRY5BNK.mjs");
+      const { describeAnything } = await import("./describe-6O2ENKTP.mjs");
       process.exitCode = await describeAnything(
         toolId,
         {
@@ -1345,7 +1974,12 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
     return 0;
   }
   if ((options.schemaOnly || options.examplesOnly || options.gettersOnly) && !isMonitorTypeTool(tool) && !isPlayLikeTool(tool) && (options.json || options.contractJson)) {
-    const contract = toolContractJsonForDescribe(tool, toolId);
+    const contract = toolContractJsonForDescribe(
+      tool,
+      toolId,
+      void 0,
+      seedToolListScript
+    );
     printCompactJson({
       toolId: contract.toolId,
       ...options.schemaOnly ? {
@@ -1370,7 +2004,12 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
   }
   if (options.contractJson) {
     printCompactJson({
-      ...toolContractJsonForDescribe(tool, toolId),
+      ...toolContractJsonForDescribe(
+        tool,
+        toolId,
+        void 0,
+        seedToolListScript
+      ),
       ...modelDescription ? { modelOptions: modelDescription } : {},
       ...inferenceQuote ? { inferenceQuote } : {}
     });
@@ -1379,7 +2018,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
   const emitJson = options.json === true;
   if (emitJson) {
     printCompactJson({
-      ...toolMetadataJsonForDescribe(tool, toolId),
+      ...toolMetadataJsonForDescribe(tool, toolId, seedToolListScript),
       ...modelDescription ? { modelOptions: modelDescription } : {},
       ...inferenceQuote ? { inferenceQuote } : {}
     });
@@ -1393,149 +2032,46 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
   if (options.examplesOnly) {
     printToolExamplesOnly(tool, toolId);
     if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
-    return 0;
-  }
-  if (options.gettersOnly) {
-    printToolGettersOnly(tool, toolId);
-    if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
-    return 0;
-  }
-  if (options.compact) {
-    printCompactToolContract(tool, toolId);
-    if (modelDescription) {
-      process.stdout.write(`
-${formatModelDescription(modelDescription)}`);
-    }
-    if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
-    return 0;
-  }
-  printCompactToolContract(tool, toolId);
-  if (modelDescription) {
-    process.stdout.write(`
-${formatModelDescription(modelDescription)}`);
-  }
-  if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
-  return 0;
-}
-function inferenceQuoteSummaryLines(_quote) {
-  return [
-    "",
-    "Inference quote:",
-    "- Temporary hold: priced estimate (minimum 0.02 credits)",
-    "- Final charge: actual usage"
-  ];
-}
-function printInferenceQuoteSummary(quote) {
-  for (const line of inferenceQuoteSummaryLines(quote)) console.log(line);
-}
-function toolContractJsonForDescribe(tool, requestedToolId, authoringContractEdition) {
-  const toolId = String(tool.toolId || requestedToolId);
-  const inputFields = toolInputFieldsForDisplay(
-    recordField(tool, "inputSchema", "input_schema")
-  );
-  const inputSchema = publicToolInputSchemaForDescribe(
-    recordField(tool, "inputSchema", "input_schema")
-  );
-  const outputSchemaRecord = recordField(tool, "outputSchema", "output_schema");
-  const outputFields = toolOutputFieldsForDisplay(outputSchemaRecord);
-  const usageGuidance = recordField(tool, "usageGuidance", "usage_guidance");
-  const guidance = recordField(tool, "guidance");
-  const toolExecutionResult = recordField(
-    usageGuidance,
-    "toolExecutionResult",
-    "tool_execution_result"
-  );
-  const extractedLists = extractionContractEntries(
-    arrayField2(toolExecutionResult, "extractedLists", "extracted_lists")
-  ).map((entry) => ({
-    ...entry,
-    returnType: playToolListGetterMode(authoringContractEdition) === "array" ? "Array" : "PlayDataset",
-    rowsExpression: playToolListGetterMode(authoringContractEdition) === "array" ? entry.expression : `await ${entry.expression}.materialize()`
-  }));
-  const extractedValues = extractionContractEntries(
-    arrayField2(toolExecutionResult, "extractedValues", "extracted_values")
-  );
-  const pricing = Capability.fromCatalogEntry(tool).describe().customerCost();
-  const executionMetadataRecord = recordField(
-    tool,
-    "executionMetadata",
-    "execution_metadata"
-  );
-  const executionMetadata = Object.keys(executionMetadataRecord).length > 0 ? executionMetadataRecord : null;
-  const batchCapabilityRecord = recordField(
-    tool,
-    "batchCapability",
-    "batch_capability"
-  );
-  const batchCapability = Object.keys(batchCapabilityRecord).length > 0 ? batchCapabilityRecord : null;
-  const deprecation = recordField(tool, "deprecation");
-  const replacementToolId = stringField2(
-    deprecation,
-    "replacementToolId",
-    "replacement_tool_id"
-  );
-  const deprecationMessage = stringField2(deprecation, "message");
-  const deprecationExecution = stringField2(deprecation, "execution");
-  const deprecated = tool.deprecated === true || stringField2(tool, "credentialStatus", "credential_status") === "deprecated";
-  const starterScript = !deprecated && !isPlayLikeTool(tool) && extractedLists.length > 0 ? starterScriptJson(
-    seedToolListScript({
-      toolId,
-      payload: samplePayloadForInputFields(inputFields),
-      rows: []
-    })
-  ) : null;
-  const executeCommand = deprecated && replacementToolId ? `deepline tools execute ${replacementToolId} --input '{...}'` : isPlayLikeTool(tool) ? playRunCommandForTool(tool, toolId) : `deepline tools execute ${toolId} --input '{...}'`;
-  return {
-    schemaVersion: 1,
-    toolId,
-    provider: tool.provider,
-    displayName: tool.displayName,
-    cost: pricing,
-    description: tool.description,
-    ...Object.keys(guidance).length > 0 ? { guidance } : {},
-    categories: tool.categories,
-    ...Array.isArray(tool.requestWarnings) ? { requestWarnings: tool.requestWarnings } : {},
-    ...deprecated ? {
-      deprecated: true,
-      callable: tool.callable !== false,
-      deprecation: {
-        replacementToolId,
-        message: deprecationMessage,
-        ...deprecationExecution ? { execution: deprecationExecution } : {}
-      }
-    } : {},
-    inputFields: inputFields.map(inputFieldJsonForDescribe),
-    inputSchema,
-    ...isRecord(tool.responseSchema) ? { responseSchema: tool.responseSchema } : {},
-    ...Array.isArray(tool.examples) ? { examples: tool.examples } : {},
-    responseAccess: "result.toolResponse.rawV2",
-    ...Object.keys(outputSchemaRecord).length > 0 ? {
-      outputSchema: publicToolInputSchemaForDescribe(outputSchemaRecord),
-      outputFields: outputFields.map(inputFieldJsonForDescribe)
-    } : {},
-    ...executionMetadata ? { executionMetadata } : {},
-    ...batchCapability ? { batchCapability } : {},
-    getters: {
-      extractedLists,
-      extractedValues
-    },
-    executeCommand,
-    ...starterScript ? { starterScript } : {}
-  };
+    return 0;
+  }
+  if (options.gettersOnly) {
+    printToolGettersOnly(tool, toolId);
+    if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
+    return 0;
+  }
+  if (options.compact) {
+    printCompactToolContract(tool, toolId);
+    if (modelDescription) {
+      process.stdout.write(`
+${formatModelDescription(modelDescription)}`);
+    }
+    if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
+    return 0;
+  }
+  printCompactToolContract(tool, toolId);
+  if (modelDescription) {
+    process.stdout.write(`
+${formatModelDescription(modelDescription)}`);
+  }
+  if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
+  return 0;
 }
-function extractionContractEntries(entries) {
-  return entries.flatMap((entry) => {
-    if (!isRecord(entry)) return [];
-    const name = stringField2(entry, "name");
-    const expression = stringField2(entry, "expression");
-    return name && expression ? [{ name, expression }] : [];
-  });
+function inferenceQuoteSummaryLines(_quote) {
+  return [
+    "",
+    "Inference quote:",
+    "- Temporary hold: priced estimate (minimum 0.02 credits)",
+    "- Final charge: actual usage"
+  ];
+}
+function printInferenceQuoteSummary(quote) {
+  for (const line of inferenceQuoteSummaryLines(quote)) console.log(line);
 }
 function printMonitorTypeFilters(tool) {
   const schema = recordField(tool, "payload_schema", "payloadSchema");
   const properties = recordField(schema, "properties");
   const required = new Set(
-    arrayField2(schema, "required").filter(
+    arrayField(schema, "required").filter(
       (v) => typeof v === "string"
     )
   );
@@ -1548,11 +2084,11 @@ function printMonitorTypeFilters(tool) {
   for (const name of names) {
     const field = isRecord(properties[name]) ? properties[name] : {};
     const star = required.has(name) ? "*" : "";
-    const enumVals = arrayField2(field, "enum").filter(
+    const enumVals = arrayField(field, "enum").filter(
       (v) => typeof v === "string"
     );
-    const type = enumVals.length ? `one of [${enumVals.join(", ")}]` : stringField2(field, "type") || "string";
-    const desc = stringField2(field, "description");
+    const type = enumVals.length ? `one of [${enumVals.join(", ")}]` : stringField(field, "type") || "string";
+    const desc = stringField(field, "description");
     console.log(`- ${name}${star}: ${type}${desc ? ` - ${desc}` : ""}`);
   }
 }
@@ -1561,260 +2097,96 @@ function printMonitorTypeFilterExamples(tool) {
   const fields = recordField(documentation, "fields");
   const examples = Object.entries(fields).flatMap(([name, rawField]) => {
     const grammar = recordField(isRecord(rawField) ? rawField : {}, "grammar");
-    const example = stringField2(grammar, "example");
+    const example = stringField(grammar, "example");
     const values = [
-      ...arrayField2(grammar, "examples").filter(
+      ...arrayField(grammar, "examples").filter(
         (value2) => typeof value2 === "string" && Boolean(value2)
       ),
-      ...example ? [example] : []
-    ];
-    return [...new Set(values)].map((example2) => ({ name, example: example2 }));
-  });
-  if (examples.length === 0) return;
-  console.log("");
-  console.log("Filter examples:");
-  for (const { name, example } of examples) {
-    console.log(`- ${name}: ${example}`);
-  }
-}
-function printMonitorTypeStreams(tool) {
-  const streams = arrayField2(tool, "streams", "output_streams").filter(
-    isRecord
-  );
-  if (!streams.length) return;
-  console.log("");
-  console.log("Filter columns (a play's sqlListeners.where, per stream):");
-  for (const stream of streams) {
-    const name = stringField2(stream, "stream");
-    const cols = arrayField2(stream, "columns").filter(isRecord).map((col) => stringField2(col, "name")).filter(Boolean);
-    console.log(`- ${name}: ${cols.join(", ")}`);
-  }
-}
-function monitorTypePricingLines(tool) {
-  const pricing = recordField(tool, "pricing");
-  const byType = recordField(
-    pricing,
-    "pricing_by_radar_type",
-    "pricingByRadarType"
-  );
-  const keys = Object.keys(byType);
-  if (!keys.length) {
-    return ["Pricing: Deepline credits per accepted event"];
-  }
-  const lines = ["Pricing (Deepline credits per accepted event):"];
-  for (const key of keys) {
-    const entry = isRecord(byType[key]) ? byType[key] : {};
-    const credits = numberField2(entry, "deepline_credits", "deeplineCredits");
-    const display = stringField2(entry, "display");
-    const shown = display || (credits !== null ? `${formatDecimal(credits)} credits/event` : "not listed");
-    lines.push(`- ${key}: ${shown}`);
-  }
-  return lines;
-}
-function printMonitorTypePricing(tool) {
-  for (const line of monitorTypePricingLines(tool)) console.log(line);
-}
-function printMonitorTypeDeploy(tool) {
-  const deploy = recordField(tool, "deploy");
-  const toolId = stringField2(tool, "toolId");
-  const example = stringField2(deploy, "example") || `deepline monitors deploy '{"key":"...","tool":"${toolId}","payload":{...}}'`;
-  console.log("Deploy (a monitor type is deployed, not executed):");
-  console.log(`  ${example}`);
-}
-function printMonitorTypeContract(tool, requestedToolId) {
-  const toolId = stringField2(tool, "toolId") || requestedToolId;
-  console.log(toolId);
-  const displayName = stringField2(tool, "displayName");
-  if (displayName) console.log(`Best for: ${displayName}`);
-  const description = stringField2(tool, "description");
-  if (description) console.log(`Description: ${description}`);
-  const categories = arrayField2(tool, "categories").filter(
-    (v) => typeof v === "string"
-  );
-  if (categories.length) console.log(`Tags: ${categories.join(", ")}`);
-  console.log("");
-  console.log(
-    "Monitor type \u2014 streams a provider's events into your warehouse. Deploy it, don't execute it."
-  );
-  console.log("");
-  printMonitorTypeFilters(tool);
-  printMonitorTypeFilterExamples(tool);
-  printMonitorTypeStreams(tool);
-  console.log("");
-  printMonitorTypePricing(tool);
-  console.log("");
-  printMonitorTypeDeploy(tool);
-  console.log("");
-  console.log(`More: deepline describe ${toolId}`);
-}
-function schemaNodeAt(schema, path) {
-  let node = schema;
-  for (const part of path.split(".").filter(Boolean)) {
-    const [key, ...indexes] = part.split("[");
-    node = recordField(isRecord(node) ? node : {}, "properties")[key];
-    for (const _index of indexes)
-      node = isRecord(node) ? node.items : void 0;
-  }
-  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;
-}
-function publicToolSchemas(tool) {
-  const scrubbed = (...keys) => {
-    const schema = recordField(tool, ...keys);
-    if (Object.keys(schema).length === 0) return null;
-    const cleaned = publicToolInputSchemaForDescribe(schema);
-    return isRecord(cleaned.jsonSchema) ? cleaned.jsonSchema : cleaned;
-  };
-  const responseSchema = scrubbed("responseSchema", "response_schema");
-  return {
-    inputSchema: scrubbed(
-      "inputSchema",
-      "input_schema",
-      "payload_schema",
-      "payloadSchema"
-    ),
-    outputSchema: scrubbed("outputSchema", "output_schema"),
-    ...responseSchema ? { responseSchema } : {}
-  };
-}
-function describedTool(tool, requestedToolId) {
-  const id = stringField2(tool, "toolId") || requestedToolId;
-  const displayName = stringField2(tool, "displayName") || void 0;
-  const description = stringField2(tool, "bestFor", "best_for") || stringField2(tool, "description") || void 0;
-  if (isMonitorTypeTool(tool)) {
-    return {
-      kind: "monitor_type",
-      id,
-      displayName,
-      description,
-      cost: stringField2(recordField(tool, "pricing"), "displayText") || void 0,
-      guidance: [],
-      inputs: schemaFields(
-        recordField(tool, "payload_schema", "payloadSchema")
-      ),
-      outputs: [],
-      runner: {
-        via: "monitor",
-        deploy: stringField2(recordField(tool, "deploy"), "example") || `deepline monitors deploy '{"key":"...","tool":"${id}","payload":{...}}'`
-      }
-    };
-  }
-  const contract = toolContractJsonForDescribe(tool, requestedToolId);
-  const cost = recordField(contract, "cost");
-  const billing = stringField2(cost, "billingSourceLabel");
-  const deprecation = recordField(contract, "deprecation");
-  const getters = recordField(contract, "getters");
-  const outputSchema = jsonSchemaOf(recordField(contract, "outputSchema"));
-  const toolResult = recordField(tool, "toolResult", "tool_result");
-  const getterDetails = (kind) => new Map(
-    arrayField2(toolResult, kind).filter(isRecord).map((item) => [
-      stringField2(item, "name"),
-      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 rawPaths = arrayField2(
-        details.get(name) ?? {},
-        "rawToolOutputPaths"
-      ).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,
-        ...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),
-        ...rawPaths.length ? { paths: rawPaths } : {}
-      };
-      return { field, node };
-    });
-  };
-  const declaredLists = getterOutputs("extractedLists", [outputSchema]);
-  const lists = declaredLists.some(({ node }) => node) ? declaredLists.filter(({ node }) => node) : declaredLists;
-  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",
-    id: String(contract.toolId),
-    displayName,
-    description,
-    cost: [
-      stringField2(cost, "displayText"),
-      // "Free (free)" says the same thing twice.
-      billing.toLowerCase() === stringField2(cost, "displayText").toLowerCase() ? "" : billing && `(${billing})`,
-      observedMaxText(cost) && `\u2014 ${observedMaxText(cost)}`
-    ].filter(Boolean).join(" ") || void 0,
-    guidance: [
-      ...contract.deprecated === true ? [`Deprecated. ${stringField2(deprecation, "message")}`.trim()] : [],
-      ...Object.values(recordField(contract, "guidance")).filter(
-        (line) => typeof line === "string" && /[a-z0-9]/i.test(line)
-      )
-    ],
-    rateLimit: rateLimitSummary(
-      recordField(contract, "executionMetadata").configuredRateLimits
-    ),
-    inputs: schemaFields(jsonSchemaOf(recordField(contract, "inputSchema"))),
-    outputs: [...lists, ...values].map(({ field }) => field),
-    rawResponse: schemaFields(outputSchema),
-    runner: playReference ? { via: "play", reference: playReference } : { via: "tool", toolId: String(contract.toolId) }
-  };
+      ...example ? [example] : []
+    ];
+    return [...new Set(values)].map((example2) => ({ name, example: example2 }));
+  });
+  if (examples.length === 0) return;
+  console.log("");
+  console.log("Filter examples:");
+  for (const { name, example } of examples) {
+    console.log(`- ${name}: ${example}`);
+  }
+}
+function printMonitorTypeStreams(tool) {
+  const streams = arrayField(tool, "streams", "output_streams").filter(
+    isRecord
+  );
+  if (!streams.length) return;
+  console.log("");
+  console.log("Filter columns (a play's sqlListeners.where, per stream):");
+  for (const stream of streams) {
+    const name = stringField(stream, "stream");
+    const cols = arrayField(stream, "columns").filter(isRecord).map((col) => stringField(col, "name")).filter(Boolean);
+    console.log(`- ${name}: ${cols.join(", ")}`);
+  }
+}
+function monitorTypePricingLines(tool) {
+  const pricing = recordField(tool, "pricing");
+  const byType = recordField(
+    pricing,
+    "pricing_by_radar_type",
+    "pricingByRadarType"
+  );
+  const keys = Object.keys(byType);
+  if (!keys.length) {
+    return ["Pricing: Deepline credits per accepted event"];
+  }
+  const lines = ["Pricing (Deepline credits per accepted event):"];
+  for (const key of keys) {
+    const entry = isRecord(byType[key]) ? byType[key] : {};
+    const credits = numberField2(entry, "deepline_credits", "deeplineCredits");
+    const display = stringField(entry, "display");
+    const shown = display || (credits !== null ? `${formatDecimal(credits)} credits/event` : "not listed");
+    lines.push(`- ${key}: ${shown}`);
+  }
+  return lines;
+}
+function printMonitorTypePricing(tool) {
+  for (const line of monitorTypePricingLines(tool)) console.log(line);
+}
+function printMonitorTypeDeploy(tool) {
+  const deploy = recordField(tool, "deploy");
+  const toolId = stringField(tool, "toolId");
+  const example = stringField(deploy, "example") || `deepline monitors deploy '{"key":"...","tool":"${toolId}","payload":{...}}'`;
+  console.log("Deploy (a monitor type is deployed, not executed):");
+  console.log(`  ${example}`);
+}
+function printMonitorTypeContract(tool, requestedToolId) {
+  const toolId = stringField(tool, "toolId") || requestedToolId;
+  console.log(toolId);
+  const displayName = stringField(tool, "displayName");
+  if (displayName) console.log(`Best for: ${displayName}`);
+  const description = stringField(tool, "description");
+  if (description) console.log(`Description: ${description}`);
+  const categories = arrayField(tool, "categories").filter(
+    (v) => typeof v === "string"
+  );
+  if (categories.length) console.log(`Tags: ${categories.join(", ")}`);
+  console.log("");
+  console.log(
+    "Monitor type \u2014 streams a provider's events into your warehouse. Deploy it, don't execute it."
+  );
+  console.log("");
+  printMonitorTypeFilters(tool);
+  printMonitorTypeFilterExamples(tool);
+  printMonitorTypeStreams(tool);
+  console.log("");
+  printMonitorTypePricing(tool);
+  console.log("");
+  printMonitorTypeDeploy(tool);
+  console.log("");
+  console.log(`More: deepline describe ${toolId}`);
 }
 function toolGuidanceLines(guidance) {
   const record = isRecord(guidance) ? guidance : {};
-  const toolGuidance = stringField2(record, "tool");
-  const providerGuidance = stringField2(record, "provider");
+  const toolGuidance = stringField(record, "tool");
+  const providerGuidance = stringField(record, "provider");
   return [
     ...toolGuidance ? [`- This tool: ${toolGuidance}`] : [],
     ...providerGuidance ? [`- Provider: ${providerGuidance}`] : []
@@ -1825,7 +2197,12 @@ function printCompactToolContract(tool, requestedToolId) {
     printMonitorTypeContract(tool, requestedToolId);
     return;
   }
-  const contract = toolContractJsonForDescribe(tool, requestedToolId);
+  const contract = toolContractJsonForDescribe(
+    tool,
+    requestedToolId,
+    void 0,
+    seedToolListScript
+  );
   const cost = isRecord(contract.cost) ? contract.cost : {};
   const getters = isRecord(contract.getters) ? contract.getters : {};
   const listGetters = Array.isArray(getters.extractedLists) ? getters.extractedLists : [];
@@ -1849,8 +2226,8 @@ function printCompactToolContract(tool, requestedToolId) {
   printToolExecutionHints(contract);
   if (contract.deprecated === true) {
     const deprecation = isRecord(contract.deprecation) ? contract.deprecation : {};
-    const message = stringField2(deprecation, "message");
-    const replacementToolId = stringField2(
+    const message = stringField(deprecation, "message");
+    const replacementToolId = stringField(
       deprecation,
       "replacementToolId",
       "replacement_tool_id"
@@ -1876,11 +2253,11 @@ function printCompactToolContract(tool, requestedToolId) {
     console.log("Inputs:");
     for (const field of inputFields) {
       if (!isRecord(field)) continue;
-      const name = stringField2(field, "name");
+      const name = stringField(field, "name");
       if (!name) continue;
       const required = field.required ? "*" : "";
-      const type = stringField2(field, "type") || "unknown";
-      const description = stringField2(field, "description");
+      const type = stringField(field, "type") || "unknown";
+      const description = stringField(field, "description");
       const enumValues = Array.isArray(field.enum) ? field.enum : [];
       const enumSuffix = enumValues.length ? ` enum=${enumValues.map(String).join("|")}` : "";
       const itemBoundsSuffix = arrayItemBoundsSuffix(field);
@@ -1896,7 +2273,7 @@ function printCompactToolContract(tool, requestedToolId) {
   console.log("");
   printToolExamplesOnly(tool, requestedToolId);
   const starterScript = isRecord(contract.starterScript) ? contract.starterScript : {};
-  const starterPath = stringField2(starterScript, "path");
+  const starterPath = stringField(starterScript, "path");
   if (starterPath) {
     console.log("");
     console.log(`Starter script: ${starterPath}`);
@@ -1909,14 +2286,14 @@ function printCompactToolContract(tool, requestedToolId) {
     for (const entry of listGetters) {
       if (isRecord(entry))
         console.log(
-          `- ${stringField2(entry, "name")}: ${playResultExpression(entry)}`
+          `- ${stringField(entry, "name")}: ${playResultExpression(entry)}`
         );
     }
     if (valueGetters.length) console.log("Values:");
     for (const entry of valueGetters) {
       if (isRecord(entry))
         console.log(
-          `- ${stringField2(entry, "name")}: ${playResultExpression(entry)}`
+          `- ${stringField(entry, "name")}: ${playResultExpression(entry)}`
         );
     }
   }
@@ -1932,14 +2309,14 @@ function toolPricingOnlyLines(tool, requestedToolId, options = {}) {
   }
   const toolId = String(tool.toolId || requestedToolId);
   const cost = Capability.fromCatalogEntry(tool).describe().customerCost();
-  const pricingModel = stringField2(cost, "pricingModel") || "unknown";
-  const billing = stringField2(cost, "billingSourceLabel") || stringField2(cost, "billingSource") || stringField2(cost, "billingMode") || "unknown";
-  const explicitUnit = stringField2(cost, "unit");
+  const pricingModel = stringField(cost, "pricingModel") || "unknown";
+  const billing = stringField(cost, "billingSourceLabel") || stringField(cost, "billingSource") || stringField(cost, "billingMode") || "unknown";
+  const explicitUnit = stringField(cost, "unit");
   const unit = explicitUnit || (pricingModel === "per_page" ? "page" : pricingModel === "per_result" ? "result" : pricingModel === "fixed" ? "call" : pricingModel.replace(/^per_/, "") || "unit");
   const credits = numberField2(cost, "deeplineCreditsPerPricingUnit");
   const usd = numberField2(cost, "deeplineUsdPerPricingUnit");
-  const displayText = stringField2(cost, "displayText");
-  const summary = stringField2(cost, "summary");
+  const displayText = stringField(cost, "displayText");
+  const summary = stringField(cost, "summary");
   const price = displayText || summary || (credits !== null ? `${formatDecimal(credits)} Deepline credits${usd !== null ? ` / ${formatUsd(usd)}` : ""} per ${unit}` : "pricing unavailable");
   return [
     `${options.heading ?? `Pricing: ${toolId}`}: ${price}`,
@@ -1961,7 +2338,12 @@ function printToolSchemaOnly(tool, requestedToolId) {
     printMonitorTypeStreams(tool);
     return;
   }
-  const contract = toolContractJsonForDescribe(tool, requestedToolId);
+  const contract = toolContractJsonForDescribe(
+    tool,
+    requestedToolId,
+    void 0,
+    seedToolListScript
+  );
   const inputFields = recursiveToolInputFieldsForDisplay(
     recordField(contract, "inputSchema")
   );
@@ -2010,10 +2392,15 @@ function printToolExamplesOnly(tool, requestedToolId) {
     printPlayLikeToolUsage(tool, requestedToolId);
     return;
   }
-  const contract = toolContractJsonForDescribe(tool, requestedToolId);
+  const contract = toolContractJsonForDescribe(
+    tool,
+    requestedToolId,
+    void 0,
+    seedToolListScript
+  );
   const toolId = String(contract.toolId);
   const inputFields = Array.isArray(contract.inputFields) ? contract.inputFields : [];
-  const examples = arrayField2(tool, "examples").filter(isRecord);
+  const examples = arrayField(tool, "examples").filter(isRecord);
   const firstExample = examples[0];
   const sampleInput = firstExample && isRecord(firstExample.input) ? firstExample.input : samplePayload(recordField(tool, "samples"), "request") ?? samplePayloadForInputFields(inputFields);
   console.log("Example input payload:");
@@ -2034,8 +2421,8 @@ function printToolExamplesOnly(tool, requestedToolId) {
   const listGetters = Array.isArray(getters.extractedLists) ? getters.extractedLists : [];
   const firstGetter = valueGetters.find(isRecord);
   if (firstGetter) {
-    const name = stringField2(firstGetter, "name") || "value";
-    const expression = stringField2(firstGetter, "expression");
+    const name = stringField(firstGetter, "name") || "value";
+    const expression = stringField(firstGetter, "expression");
     if (expression)
       console.log(
         `const ${safeIdentifier(name)} = ${expression.replace(/^toolExecutionResult\./, "result.")};`
@@ -2047,10 +2434,10 @@ function printToolExamplesOnly(tool, requestedToolId) {
     ).filter((field) => String(field.type).split("|").includes("array")).map((field) => String(field.name).split(".").at(-1))
   );
   const firstList = listGetters.find(
-    (entry) => isRecord(entry) && arrayNames.has(stringField2(entry, "name"))
+    (entry) => isRecord(entry) && arrayNames.has(stringField(entry, "name"))
   ) ?? listGetters.find(isRecord);
   if (isRecord(firstList)) {
-    const name = safeIdentifier(stringField2(firstList, "name") || "list");
+    const name = safeIdentifier(stringField(firstList, "name") || "list");
     if (playToolListGetterMode() === "array") {
       console.log(`const ${name}_rows = ${playResultExpression(firstList)};`);
     } else {
@@ -2064,7 +2451,7 @@ function printToolExamplesOnly(tool, requestedToolId) {
   console.log("```");
   if (firstList) printListGetterConsumption();
   for (const example of examples) {
-    const description = stringField2(example, "description");
+    const description = stringField(example, "description");
     if (description) console.log(description);
     console.log("Example Deepline execution response:");
     console.log(JSON.stringify(example.response, null, 2));
@@ -2097,7 +2484,12 @@ function printPlayLikeToolUsage(tool, requestedToolId) {
   }
 }
 function printToolGettersOnly(tool, requestedToolId) {
-  const contract = toolContractJsonForDescribe(tool, requestedToolId);
+  const contract = toolContractJsonForDescribe(
+    tool,
+    requestedToolId,
+    void 0,
+    seedToolListScript
+  );
   const getters = isRecord(contract.getters) ? contract.getters : {};
   const listGetters = Array.isArray(getters.extractedLists) ? getters.extractedLists : [];
   const valueGetters = Array.isArray(getters.extractedValues) ? getters.extractedValues : [];
@@ -2106,192 +2498,46 @@ function printToolGettersOnly(tool, requestedToolId) {
     console.log("No generated getters declared.");
     return;
   }
-  if (listGetters.length) {
-    console.log(listGetterHeading());
-    for (const entry of listGetters) {
-      if (isRecord(entry))
-        console.log(
-          `- ${stringField2(entry, "name")}: ${playResultExpression(entry)}`
-        );
-    }
-    printListGetterConsumption();
-  }
-  if (valueGetters.length) {
-    console.log("Values:");
-    for (const entry of valueGetters) {
-      if (isRecord(entry))
-        console.log(
-          `- ${stringField2(entry, "name")}: ${playResultExpression(entry)}`
-        );
-    }
-  }
-}
-function printListGetterConsumption() {
-  if (playToolListGetterMode() === "array") {
-    console.log(
-      "Use the ordinary array directly, or pass it to ctx.dataset to persist row work. No provider pagination is fetched. Lazy or incomplete lists throw; use readList for an explicit dataset read. A missing getter is not an empty list."
-    );
-    return;
-  }
-  console.log(
-    "Pass the handle to ctx.dataset, use first() for one row, or for await...of to stream rows. materialize() loads the complete current list within the memory cap; materialize(n) and peek(n) return only a prefix. None fetch additional provider pagination. A missing getter is not an empty list."
-  );
-}
-function listGetterHeading() {
-  return playToolListGetterMode() === "array" ? "Lists (ordinary JavaScript arrays):" : "Lists (PlayDataset, not a JavaScript array):";
-}
-function sampleValueForField(field) {
-  const name = stringField2(field, "name").toLowerCase();
-  const type = stringField2(field, "type").toLowerCase();
-  if (Object.prototype.hasOwnProperty.call(field, "default"))
-    return field.default;
-  if (name.includes("email")) return "ada@example.com";
-  if (name.includes("domain") || name.includes("website")) return "example.com";
-  if (name.includes("first")) return "Ada";
-  if (name.includes("last")) return "Lovelace";
-  if (name.includes("name")) return "Ada Lovelace";
-  if (type === "integer" || type === "number") return 1;
-  if (type === "boolean") return true;
-  if (type === "array") return [];
-  if (type === "object") return {};
-  return "...";
-}
-function samplePayloadForInputFields(fields) {
-  return Object.fromEntries(
-    fields.slice(0, 4).flatMap((field) => {
-      if (!isRecord(field)) return [];
-      const name = stringField2(field, "name");
-      if (!name) return [];
-      return [[name, sampleValueForField(field)]];
-    })
-  );
-}
-function stableStepIdForTool(toolId) {
-  return toolId.replace(/^[a-z0-9]+_/, "").replace(/[^a-z0-9_]+/gi, "_") || "tool_call";
-}
-function safeIdentifier(name) {
-  const cleaned = name.replace(/[^a-zA-Z0-9_$]+/g, "_").replace(/^[^a-zA-Z_$]+/, "");
-  return cleaned || "value";
-}
-function playResultExpression(entry) {
-  return stringField2(entry, "expression").replace(
-    /^toolExecutionResult\./,
-    "result."
-  );
-}
-function toolMetadataJsonForDescribe(tool, requestedToolId) {
-  const toolId = String(tool.toolId || requestedToolId);
-  const inputFields = toolInputFieldsForDisplay(
-    recordField(tool, "inputSchema", "input_schema")
-  );
-  const usageGuidance = usageGuidanceWithAccessDefaults(
-    recordField(tool, "usageGuidance", "usage_guidance")
-  );
-  const toolExecutionResult = recordField(
-    usageGuidance,
-    "toolExecutionResult",
-    "tool_execution_result"
-  );
-  const extractedLists = extractionContractEntries(
-    arrayField2(toolExecutionResult, "extractedLists", "extracted_lists")
-  );
-  const starterScript = !isPlayLikeTool(tool) && extractedLists.length > 0 ? starterScriptJson(
-    seedToolListScript({
-      toolId,
-      payload: samplePayloadForInputFields(inputFields),
-      rows: []
-    })
-  ) : null;
-  const observedOutputCommand = isPlayLikeTool(tool) ? playRunCommandForTool(tool, toolId) : `deepline tools execute ${toolId} --input '{...}'`;
-  const {
-    cost: _cost,
-    deeplineCreditsPerPricingUnit: _deeplineCreditsPerPricingUnit,
-    deeplineUsdPerPricingUnit: _deeplineUsdPerPricingUnit,
-    deeplineUsdPerCredit: _deeplineUsdPerCredit,
-    deeplinePricingSummary: _deeplinePricingSummary,
-    deeplinePricingDetails: _deeplinePricingDetails,
-    deepline_credits_per_pricing_unit: _snakeDeeplineCreditsPerPricingUnit,
-    deepline_usd_per_pricing_unit: _snakeDeeplineUsdPerPricingUnit,
-    deepline_usd_per_credit: _snakeDeeplineUsdPerCredit,
-    deepline_pricing_summary: _snakeDeeplinePricingSummary,
-    deepline_pricing_details: _snakeDeeplinePricingDetails,
-    // BYOK is shown only on request, via describe --feature byok.
-    byok: _byok,
-    ...publicTool
-  } = tool;
-  const outputSchemaRecord = recordField(tool, "outputSchema", "output_schema");
-  return {
-    cost: Capability.fromCatalogEntry(tool).describe().customerCost(),
-    ...publicTool,
-    toolId,
-    provider: tool.provider,
-    displayName: tool.displayName,
-    ...Object.keys(outputSchemaRecord).length > 0 ? {
-      outputSchema: publicToolInputSchemaForDescribe(outputSchemaRecord),
-      outputFields: toolOutputFieldsForDisplay(outputSchemaRecord).map(
-        inputFieldJsonForDescribe
-      )
-    } : {},
-    inputFields: inputFields.map(inputFieldJsonForDescribe),
-    usageGuidance,
-    runtimeOutputHelp: {
-      contract: "Schemas declare field shapes. Examples illustrate input payloads and full Deepline execution responses; they are not observed responses from this call.",
-      getterScope: "extractedValues/extractedLists .get() only works for declared Deepline getters listed in usageGuidance.toolExecutionResult.",
-      rawToolResponse: "Use toolExecutionResult.toolResponse.rawV2 for the complete tool response. Preserve its nesting and sibling fields as shown in examples; use declared getters for extracted values and lists.",
-      invalidGetterHint: "If TypeScript says an extractedValues/extractedLists property does not exist, that field is not a declared Deepline getter.",
-      observeActualShape: observedOutputCommand,
-      observedOutput: observedOutputCommand,
-      forPlayGetterBugs: "Run a tiny play, inspect returned handles with `deepline runs get <run-id> --full`, then export row datasets with `deepline runs export`.",
-      executeOutputFields: "tools execute JSON may include output_preview for this direct probe only; play debugging uses run output and returned dataset handles."
-    },
-    ...starterScript ? { starterScript } : {}
-  };
-}
-function usageGuidanceWithAccessDefaults(usageGuidance) {
-  if (Object.keys(usageGuidance).length === 0) return usageGuidance;
-  const existingAccess = recordField(usageGuidance, "access");
-  return {
-    ...usageGuidance,
-    prefer: [
-      "Use only the declared extractedLists and extractedValues getters listed below.",
-      "Use toolExecutionResult.toolResponse.rawV2 for the complete tool response, preserving the nesting shown in the response example.",
-      "Schemas declare field shapes; examples illustrate input values and full Deepline execution responses."
-    ],
-    toolExecutionResult: {
-      ...recordField(
-        usageGuidance,
-        "toolExecutionResult",
-        "tool_execution_result"
-      ),
-      toolResponse: {
-        rawV2: "toolResponse.rawV2",
-        view: "toolResponse.view",
-        responseMeta: "toolResponse.responseMeta"
-      }
-    },
-    access: {
-      ...existingAccess,
-      extractedValues: {
-        expression: "toolExecutionResult.extractedValues.<name>.get()",
-        meaning: "Declared Deepline scalar or normalized object extractors only."
-      },
-      ...existingAccess,
-      extractedLists: {
-        ...recordField(existingAccess, "extractedLists"),
-        expression: "toolExecutionResult.extractedLists.<name>.get()",
-        meaning: playToolListGetterMode() === "array" ? "Returns an ordinary array from this response. Use array methods directly or pass it to ctx.dataset to persist row work. Lazy or incomplete lists throw; use readList for an explicit dataset read. It does not fetch provider pages." : "Returns a PlayDataset, not a JavaScript array. Pass the handle to ctx.dataset, use first(), async iteration, or await handle.materialize() for the complete current list within the memory cap. materialize(n) and peek(n) return a prefix; none fetch additional provider pages. A missing getter is not an empty list."
-      },
-      rawToolResponse: {
-        expression: "toolExecutionResult.toolResponse.rawV2",
-        meaning: "Complete tool response with its original nesting. Read tool-specific fields here; use declared getters for extracted values and lists."
-      },
-      canonicalToolResponse: {
-        expression: "toolExecutionResult.toolResponse.rawV2",
-        meaning: "Complete tool response with its original nesting and sibling fields."
-      },
-      invalidGetterHint: "If TypeScript says an extractedValues/extractedLists property does not exist, that field is not a declared Deepline getter; read it from toolResponse.rawV2 using the nesting shown in the response example."
+  if (listGetters.length) {
+    console.log(listGetterHeading());
+    for (const entry of listGetters) {
+      if (isRecord(entry))
+        console.log(
+          `- ${stringField(entry, "name")}: ${playResultExpression(entry)}`
+        );
     }
-  };
+    printListGetterConsumption();
+  }
+  if (valueGetters.length) {
+    console.log("Values:");
+    for (const entry of valueGetters) {
+      if (isRecord(entry))
+        console.log(
+          `- ${stringField(entry, "name")}: ${playResultExpression(entry)}`
+        );
+    }
+  }
+}
+function printListGetterConsumption() {
+  if (playToolListGetterMode() === "array") {
+    console.log(
+      "Use the ordinary array directly, or pass it to ctx.dataset to persist row work. No provider pagination is fetched. Lazy or incomplete lists throw; use readList for an explicit dataset read. A missing getter is not an empty list."
+    );
+    return;
+  }
+  console.log(
+    "Pass the handle to ctx.dataset, use first() for one row, or for await...of to stream rows. materialize() loads the complete current list within the memory cap; materialize(n) and peek(n) return only a prefix. None fetch additional provider pagination. A missing getter is not an empty list."
+  );
+}
+function listGetterHeading() {
+  return playToolListGetterMode() === "array" ? "Lists (ordinary JavaScript arrays):" : "Lists (PlayDataset, not a JavaScript array):";
+}
+function stableStepIdForTool(toolId) {
+  return toolId.replace(/^[a-z0-9]+_/, "").replace(/[^a-z0-9_]+/gi, "_") || "tool_call";
+}
+function safeIdentifier(name) {
+  const cleaned = name.replace(/[^a-zA-Z0-9_$]+/g, "_").replace(/^[^a-zA-Z_$]+/, "");
+  return cleaned || "value";
 }
 function singleLineText(value2, maxLength = 260) {
   if (typeof value2 !== "string") return "";
@@ -2305,62 +2551,13 @@ function listedToolDescription(tool) {
 }
 function formatListedToolCost(tool) {
   const record = tool;
-  if (stringField2(record, "billingSource", "billing_source") === "free") {
+  if (stringField(record, "billingSource", "billing_source") === "free") {
     return "Cost: Free";
   }
   const pricing = recordField(record, "pricing");
-  const displayText = stringField2(pricing, "displayText", "display_text");
+  const displayText = stringField(pricing, "displayText", "display_text");
   return displayText ? `Cost: ${displayText}` : "";
 }
-function toolInputFieldsForDisplay(inputSchema) {
-  if (Array.isArray(inputSchema.fields)) {
-    const fields = inputSchema.fields.filter(isRecord);
-    if (!isRecord(inputSchema.jsonSchema)) return fields;
-    const jsonSchemaFields = new Map(
-      recursiveToolInputFieldsForDisplay({
-        jsonSchema: inputSchema.jsonSchema
-      }).flatMap(
-        (field) => typeof field.name === "string" ? [[field.name, field]] : []
-      )
-    );
-    return fields.map((field) => {
-      const jsonSchemaField = typeof field.name === "string" ? jsonSchemaFields.get(field.name) : void 0;
-      const minItems = typeof field.minItems === "number" ? field.minItems : jsonSchemaField?.minItems;
-      const maxItems = typeof field.maxItems === "number" ? field.maxItems : jsonSchemaField?.maxItems;
-      const items = isRecord(field.items) ? field.items : jsonSchemaField?.items;
-      return {
-        ...field,
-        ...isRecord(items) ? { items } : {},
-        ...typeof minItems === "number" ? { minItems } : {},
-        ...typeof maxItems === "number" ? { maxItems } : {}
-      };
-    });
-  }
-  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, value2]) => {
-    const property = isRecord(value2) ? value2 : {};
-    return {
-      name,
-      type: typeof property.type === "string" ? property.type : "unknown",
-      required: required.has(name),
-      description: property.description,
-      ...isRecord(property.items) ? { items: property.items } : {},
-      ...typeof property.minItems === "number" ? { minItems: property.minItems } : {},
-      ...typeof property.maxItems === "number" ? { maxItems: property.maxItems } : {},
-      ...Object.prototype.hasOwnProperty.call(property, "default") ? { default: property.default } : {}
-    };
-  });
-}
-function toolOutputFieldsForDisplay(outputSchema) {
-  if (Object.keys(outputSchema).length === 0) return [];
-  return recursiveToolInputFieldsForDisplay({
-    jsonSchema: outputSchema
-  }).filter(
-    (field) => typeof field.name === "string" && field.name.includes("[]")
-  );
-}
 function printToolOutputArrayShape(tool) {
   const outputFields = toolOutputFieldsForDisplay(
     recordField(isRecord(tool) ? tool : {}, "outputSchema", "output_schema")
@@ -2369,7 +2566,7 @@ function printToolOutputArrayShape(tool) {
   console.log("  Output array shape (declared schema):");
   for (const field of outputFields.slice(0, 60)) {
     const name = String(field.name);
-    const type = stringField2(field, "type") || "unknown";
+    const type = stringField(field, "type") || "unknown";
     const itemBounds = arrayItemBoundsSuffix(field);
     console.log(`    - ${name}: ${type}${itemBounds}`);
   }
@@ -2377,142 +2574,12 @@ function printToolOutputArrayShape(tool) {
     console.log(`    - \u2026 ${outputFields.length - 60} more schema fields`);
   }
 }
-function canonicalToolJsonSchema(inputSchema) {
-  return isRecord(inputSchema.jsonSchema) ? inputSchema.jsonSchema : inputSchema;
-}
 function declaredToolJsonSchema(inputSchema) {
   if (isRecord(inputSchema.jsonSchema)) {
     return inputSchema.jsonSchema;
   }
   return Array.isArray(inputSchema.fields) ? null : inputSchema;
 }
-function publicToolInputSchemaForDescribe(inputSchema) {
-  const exposesProviderSpend = (description) => {
-    const withoutDeeplineCredits = description.replace(
-      /\bdeepline(?:-facing)?\s+credits?\b/gi,
-      ""
-    );
-    return /\bcredits?\b/i.test(withoutDeeplineCredits) || /\bprovider\s+(?:cost|spend|price|pricing|usage)\b/i.test(
-      withoutDeeplineCredits
-    ) || /\b(?:costs?|charges?|priced at)\s+[$€£]\s*\d/i.test(
-      withoutDeeplineCredits
-    ) || /\b(?:costs?|charges?|priced at)\s+\d+(?:\.\d+)?\s*(?:usd|eur|gbp)\b/i.test(
-      withoutDeeplineCredits
-    ) || /\battribute-priced\b/i.test(withoutDeeplineCredits) || /\b(?:cost|price|pricing)\s+(?:grows?|increases?|scales?|varies?)\b/i.test(
-      withoutDeeplineCredits
-    ) || /\b(?:will be|are|is|be)\s+(?:billed|charged)\b/i.test(
-      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 = (value2) => {
-    if (Array.isArray(value2)) return value2.map(stripDescriptions);
-    if (!isRecord(value2)) return value2;
-    return Object.fromEntries(
-      Object.entries(value2).flatMap(([key, nested]) => {
-        if (key === "description" && typeof nested === "string" && exposesProviderSpend(nested)) {
-          return [];
-        }
-        return [[key, stripDescriptions(nested)]];
-      })
-    );
-  };
-  return stripDescriptions(inputSchema);
-}
-function recursiveToolInputFieldsForDisplay(inputSchema) {
-  const root = canonicalToolJsonSchema(inputSchema);
-  const fields = /* @__PURE__ */ new Map();
-  const schemasById = /* @__PURE__ */ new Map();
-  const collectSchemaIds = (value2) => {
-    if (Array.isArray(value2)) {
-      for (const item of value2) collectSchemaIds(item);
-      return;
-    }
-    if (!isRecord(value2)) return;
-    if (typeof value2.$id === "string" && value2.$id.trim()) {
-      schemasById.set(value2.$id.trim(), value2);
-    }
-    for (const nested of Object.values(value2)) collectSchemaIds(nested);
-  };
-  collectSchemaIds(root);
-  const resolveRef = (schema) => {
-    const ref = typeof schema.$ref === "string" ? schema.$ref : "";
-    if (!ref.startsWith("#/")) return schemasById.get(ref) ?? schema;
-    let current = root;
-    for (const rawSegment of ref.slice(2).split("/")) {
-      const segment = rawSegment.replace(/~1/g, "/").replace(/~0/g, "~");
-      if (!isRecord(current)) return schema;
-      current = current[segment];
-    }
-    return isRecord(current) ? current : schema;
-  };
-  const addField = (field) => {
-    const name = typeof field.name === "string" ? field.name : "";
-    if (!name) return;
-    const existing = fields.get(name);
-    if (!existing || existing.type === "unknown") {
-      fields.set(name, field);
-    }
-  };
-  const visit = (unresolvedSchema, path, required, activeRefs = /* @__PURE__ */ new Set()) => {
-    const ref = typeof unresolvedSchema.$ref === "string" ? unresolvedSchema.$ref : "";
-    if (ref && activeRefs.has(ref)) return;
-    const schema = resolveRef(unresolvedSchema);
-    const nextActiveRefs = ref ? /* @__PURE__ */ new Set([...activeRefs, ref]) : activeRefs;
-    const type = Array.isArray(schema.type) ? schema.type.map(String).join("|") : typeof schema.type === "string" ? schema.type : isRecord(schema.properties) ? "object" : schema.items ? "array" : "unknown";
-    if (path) {
-      addField({
-        name: path,
-        type,
-        required,
-        description: schema.description,
-        ...Array.isArray(schema.enum) ? { enum: schema.enum } : {},
-        ...isRecord(schema.items) ? { items: schema.items } : {},
-        ...typeof schema.minItems === "number" ? { minItems: schema.minItems } : {},
-        ...typeof schema.maxItems === "number" ? { maxItems: schema.maxItems } : {},
-        ...Object.prototype.hasOwnProperty.call(schema, "default") ? { default: schema.default } : {}
-      });
-    }
-    const properties = isRecord(schema.properties) ? schema.properties : {};
-    const requiredNames = new Set(
-      Array.isArray(schema.required) ? schema.required.map(String) : []
-    );
-    for (const [name, value2] of Object.entries(properties)) {
-      if (!isRecord(value2)) continue;
-      visit(
-        value2,
-        path ? `${path}.${name}` : name,
-        requiredNames.has(name),
-        nextActiveRefs
-      );
-    }
-    if (isRecord(schema.items)) {
-      visit(schema.items, `${path}[]`, false, nextActiveRefs);
-    }
-    for (const keyword of ["anyOf", "oneOf", "allOf"]) {
-      const branches = Array.isArray(schema[keyword]) ? schema[keyword] : [];
-      for (const branch of branches) {
-        if (isRecord(branch)) {
-          visit(branch, path, required, nextActiveRefs);
-        }
-      }
-    }
-  };
-  visit(root, "", false);
-  return fields.size ? [...fields.values()] : toolInputFieldsForDisplay(inputSchema);
-}
-function inputFieldJsonForDescribe(field) {
-  const publicItems = isRecord(field.items) ? publicToolInputSchemaForDescribe({ items: field.items }).items : void 0;
-  return {
-    name: field.name,
-    type: field.type ?? "unknown",
-    required: Boolean(field.required),
-    ...field.description ? { description: field.description } : {},
-    ...isRecord(publicItems) ? { items: publicItems } : {},
-    ...typeof field.minItems === "number" ? { minItems: field.minItems } : {},
-    ...typeof field.maxItems === "number" ? { maxItems: field.maxItems } : {},
-    ...Object.prototype.hasOwnProperty.call(field, "default") ? { default: field.default } : {}
-  };
-}
 function arrayItemBoundsSuffix(field) {
   const itemSchema = isRecord(field.items) ? field.items : null;
   const itemType = itemSchema ? typeof itemSchema.type === "string" ? itemSchema.type : isRecord(itemSchema.properties) ? "object" : "unknown" : null;
@@ -2540,9 +2607,9 @@ function printToolExecutionHints(value2) {
     "execution_metadata"
   );
   if (batchCapability) {
-    const status = stringField2(batchCapability, "status") || "unknown";
-    const surface = stringField2(batchCapability, "surface");
-    const operation = stringField2(
+    const status = stringField(batchCapability, "status") || "unknown";
+    const surface = stringField(batchCapability, "surface");
+    const operation = stringField(
       batchCapability,
       "batchOperation",
       "batch_operation"
@@ -2552,7 +2619,7 @@ function printToolExecutionHints(value2) {
       "maxBatchSize",
       "max_batch_size"
     );
-    const notes = stringField2(batchCapability, "notes");
+    const notes = stringField(batchCapability, "notes");
     console.log("");
     console.log("Batching:");
     console.log(`- Catalog status: ${status}${surface ? ` (${surface})` : ""}`);
@@ -2571,7 +2638,7 @@ function printToolExecutionHints(value2) {
     }
     if (notes) console.log(`- Details: ${notes}`);
   }
-  const configuredRateLimits = arrayField2(
+  const configuredRateLimits = arrayField(
     executionMetadata,
     "configuredRateLimits",
     "configured_rate_limits"
@@ -2585,7 +2652,7 @@ function printToolExecutionHints(value2) {
       const requests = numberField2(limit, "requestsPerWindow");
       const windowMs = numberField2(limit, "windowMs");
       if (requests === null || windowMs === null) continue;
-      const usage = stringField2(limit, "usage") || "unknown";
+      const usage = stringField(limit, "usage") || "unknown";
       const usageText = usage === "queue_hint" ? "queue hint" : usage === "enforced" ? "Deepline enforced" : usage === "queue_hint_and_enforced" ? "queue hint and Deepline enforced" : usage === "disabled" ? "disabled" : usage;
       const explicitMaxConcurrency = numberField2(
         limit,
@@ -2651,7 +2718,7 @@ function extractToolExecutionWarningMessages(rawResponse) {
       if (typeof warning === "string" && warning.trim()) {
         messages.push(warning.trim());
       } else if (isRecord(warning)) {
-        const message = stringField2(warning, "message");
+        const message = stringField(warning, "message");
         if (message) messages.push(message);
       }
     }
@@ -2665,13 +2732,13 @@ function apifySyncRecoveryNext(rawResponse) {
   if (raw.state !== "awaiting_apify") return null;
   const next = recordField(raw, "next");
   const getActorRun = recordField(next, "getActorRun");
-  const getActorRunTool = stringField2(getActorRun, "tool");
+  const getActorRunTool = stringField(getActorRun, "tool");
   const getActorRunPayload = recordField(getActorRun, "payload");
   if (!getActorRunTool || Object.keys(getActorRunPayload).length === 0) {
     return null;
   }
   const getDatasetItems = recordField(next, "getDatasetItems");
-  const getDatasetItemsTool = stringField2(getDatasetItems, "tool");
+  const getDatasetItemsTool = stringField(getDatasetItems, "tool");
   const getDatasetItemsPayload = recordField(getDatasetItems, "payload");
   return {
     getActorRun: `deepline tools execute ${getActorRunTool} --input ${shellQuote(JSON.stringify(getActorRunPayload))}`,
@@ -2698,16 +2765,6 @@ function formatDecimal(value2) {
 function formatUsd(value2) {
   return `$${formatDecimal(value2)}`;
 }
-function isRecord(value2) {
-  return Boolean(value2 && typeof value2 === "object" && !Array.isArray(value2));
-}
-function stringField2(source, ...keys) {
-  for (const key of keys) {
-    const value2 = source[key];
-    if (typeof value2 === "string" && value2.trim()) return value2.trim();
-  }
-  return "";
-}
 function numberField2(source, ...keys) {
   for (const key of keys) {
     const value2 = source[key];
@@ -2715,20 +2772,6 @@ function numberField2(source, ...keys) {
   }
   return null;
 }
-function arrayField2(source, ...keys) {
-  for (const key of keys) {
-    const value2 = source[key];
-    if (Array.isArray(value2)) return value2;
-  }
-  return [];
-}
-function recordField(source, ...keys) {
-  for (const key of keys) {
-    const value2 = source[key];
-    if (isRecord(value2)) return value2;
-  }
-  return {};
-}
 function normalizeOutputFormat(raw) {
   switch ((raw || "auto").trim().toLowerCase()) {
     case "auto":
@@ -2880,17 +2923,6 @@ function safeFileStem(value2) {
 function powerShellQuote(value2) {
   return `'${value2.replace(/'/g, "''")}'`;
 }
-function starterScriptJson(script) {
-  return {
-    path: script.path,
-    sourceCode: script.sourceCode,
-    projectDir: script.projectDir,
-    copyToProject: {
-      macosLinux: script.macCopyCommand,
-      windowsPowerShell: script.windowsCopyCommand
-    }
-  };
-}
 function seedToolListScript(input) {
   const stem = safeFileStem(input.toolId);
   const fileName = `${stem}-workflow-seed-${Date.now()}.play.ts`;
@@ -3397,15 +3429,14 @@ inspect: ${inspection.inspect}
 }
 
 export {
+  publicToolSchemas,
+  describedTool,
+  toolMetadataJsonForDescribe,
   formatModelDescription,
-  isMonitorTypeTool,
   registerToolsCommands,
-  toolContractJsonForDescribe,
   printMonitorTypeContract,
-  publicToolSchemas,
-  describedTool,
   printCompactToolContract,
-  toolMetadataJsonForDescribe,
   extractToolExecutionWarningMessages,
+  seedToolListScript,
   buildToolExecuteBaseEnvelope
 };