deepline 0.3.392 → 0.3.394

package/dist/cli/{chunk-6DBOU7UH.js → chunk-KI635JN4.js}

@@ -13,7 +13,7 @@ var _chunkAID3OYVJjs = require('./chunk-AID3OYVJ.js');
 
 
 
-var _chunkUCKJQG25js = require('./chunk-UCKJQG25.js');
+var _chunkVK6FYZLPjs = require('./chunk-VK6FYZLP.js');
 
 
 
@@ -24,15 +24,17 @@ var _chunkUCKJQG25js = require('./chunk-UCKJQG25.js');
 
 
 
+var _chunkRDXFGPJUjs = require('./chunk-RDXFGPJU.js');
 
-var _chunk3VN4FTE3js = require('./chunk-3VN4FTE3.js');
 
+var _chunkKB4SDX5Sjs = require('./chunk-KB4SDX5S.js');
 
-var _chunk5O4B6AUNjs = require('./chunk-5O4B6AUN.js');
 
 
+var _chunkE23BQ5SCjs = require('./chunk-E23BQ5SC.js');
 
-var _chunkCVLM3WMJjs = require('./chunk-CVLM3WMJ.js');
+
+var _chunkXDVT3GOMjs = require('./chunk-XDVT3GOM.js');
 
 
 
@@ -46,11 +48,11 @@ var _chunkQJBJZVG6js = require('./chunk-QJBJZVG6.js');
 
 
 
-var _chunkRV6ALZIXjs = require('./chunk-RV6ALZIX.js');
+var _chunkKGNTKMRGjs = require('./chunk-KGNTKMRG.js');
 
 
 
-var _chunkWMS5U6YBjs = require('./chunk-WMS5U6YB.js');
+var _chunkCS6RAIVYjs = require('./chunk-CS6RAIVY.js');
 
 
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
@@ -58,6 +60,40 @@ var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
 // src/cli/commands/tools.ts
 var _commander = require('commander');
 
+// ../integration-contracts/request-warnings.ts
+function matchesToolRequestCondition(condition, payload) {
+  if ("all" in condition) {
+    return condition.all.every(
+      (entry) => matchesToolRequestCondition(entry, payload)
+    );
+  }
+  if ("any" in condition) {
+    return condition.any.some(
+      (entry) => matchesToolRequestCondition(entry, payload)
+    );
+  }
+  const value2 = _optionalChain([payload, 'optionalAccess', _ => _[condition.field]]);
+  switch (condition.operator) {
+    case "equals":
+      return value2 === condition.value;
+    case "number_equals":
+      try {
+        return Number(value2) === condition.value;
+      } catch (e) {
+        return false;
+      }
+    case "present_nonblank":
+      return typeof value2 === "string" ? value2.trim().length > 0 : value2 !== void 0 && value2 !== null;
+    default:
+      throw new Error("Unsupported tool request warning condition.");
+  }
+}
+function firstMatchingToolRequestWarning(rules, payload) {
+  return _optionalChain([rules, 'optionalAccess', _2 => _2.find, 'call', _3 => _3((rule) => matchesToolRequestCondition(rule.when, payload))]);
+}
+
+// src/cli/commands/tools.ts
+
 
 
 
@@ -95,10 +131,10 @@ var ToolCallRecovery = class _ToolCallRecovery {
   }
 };
 function pendingToolExecutionPath(input) {
-  const config = _chunkWMS5U6YBjs.resolveConfig.call(void 0, );
-  const fingerprint = _crypto.createHash.call(void 0, "sha256").update(config.baseUrl).update("\0").update(_crypto.createHash.call(void 0, "sha256").update(config.apiKey).digest("hex")).update("\0").update(input.toolId).update("\0").update(_chunk3VN4FTE3js.stableStringify.call(void 0, input.params)).update("\0").update(input.responseIntent).digest("hex");
+  const config = _chunkCS6RAIVYjs.resolveConfig.call(void 0, );
+  const fingerprint = _crypto.createHash.call(void 0, "sha256").update(config.baseUrl).update("\0").update(_crypto.createHash.call(void 0, "sha256").update(config.apiKey).digest("hex")).update("\0").update(input.toolId).update("\0").update(_chunkXDVT3GOMjs.stableStringify.call(void 0, input.params)).update("\0").update(input.responseIntent).digest("hex");
   return _path.join.call(void 0, 
-    _chunkWMS5U6YBjs.sdkCliStateDirPath.call(void 0, config.baseUrl),
+    _chunkCS6RAIVYjs.sdkCliStateDirPath.call(void 0, config.baseUrl),
     `pending-tool-execution-${fingerprint}.json`
   );
 }
@@ -319,7 +355,7 @@ function catalogFields() {
 var FIELDS_BY_ID = new Map(catalogFields().map((field) => [field.id, field]));
 function generalField(id) {
   const field = FIELDS_BY_ID.get(id);
-  return _optionalChain([field, 'optionalAccess', _ => _.kind]) ? [field.entity, field.group, field.leaf].join(".") : null;
+  return _optionalChain([field, 'optionalAccess', _4 => _4.kind]) ? [field.entity, field.group, field.leaf].join(".") : null;
 }
 function fieldSatisfies(offered, wanted) {
   return offered === wanted || generalField(offered) === wanted;
@@ -400,7 +436,7 @@ function formatModelDescription(description) {
 function appendNamespace(lines, namespace) {
   lines.push(`- ${namespace.provider} (${namespace.sourceSymbol})`);
   for (const field of namespace.fields) {
-    const values = _optionalChain([field, 'access', _2 => _2.enumValues, 'optionalAccess', _3 => _3.length]) ? ` (${field.enumValues.map((value2) => JSON.stringify(value2)).join(" | ")})` : "";
+    const values = _optionalChain([field, 'access', _5 => _5.enumValues, 'optionalAccess', _6 => _6.length]) ? ` (${field.enumValues.map((value2) => JSON.stringify(value2)).join(" | ")})` : "";
     lines.push(
       `  - ${field.name}: ${field.type}${values} - ${field.description}`
     );
@@ -487,7 +523,7 @@ function shellCommandArg(value2) {
 }
 function zeroMatchToolGuidance(options) {
   const categories = _nullishCoalesce(options.categories, () => ( []));
-  const query = _nullishCoalesce(_optionalChain([options, 'access', _4 => _4.query, 'optionalAccess', _5 => _5.trim, 'call', _6 => _6()]), () => ( ""));
+  const query = _nullishCoalesce(_optionalChain([options, 'access', _7 => _7.query, 'optionalAccess', _8 => _8.trim, 'call', _9 => _9()]), () => ( ""));
   const filterText = [
     categories.length ? `categories=${categories.join(",")}` : null,
     query ? `grep=${query}` : null,
@@ -619,12 +655,12 @@ function categoryEnumerationRender(summaries) {
   };
 }
 async function listToolCategories(emitJson, compact) {
-  const client = new (0, _chunkCVLM3WMJjs.DeeplineClient)();
+  const client = new (0, _chunkE23BQ5SCjs.DeeplineClient)();
   const rawTools = await client.listTools({ compact });
   const items = rawTools.map(toListedTool);
   const summaries = aggregateCategorySummaries(rawTools);
   const outputItems = compact ? items.map(compactTool) : items;
-  _chunkRV6ALZIXjs.printCommandEnvelope.call(void 0, 
+  _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
     {
       tools: outputItems,
       count: outputItems.length,
@@ -643,7 +679,7 @@ function unknownCategoryError(category, summaries, emitJson) {
   const known = summaries.map((item) => item.name);
   const message = `Unknown tool category "${category}". Run \`deepline tools list\` to browse categories.`;
   if (emitJson) {
-    _chunkRV6ALZIXjs.printJson.call(void 0, {
+    _chunkKGNTKMRGjs.printJson.call(void 0, {
       ok: false,
       exitCode: 4,
       code: "TOOL_CATEGORY_NOT_FOUND",
@@ -657,13 +693,13 @@ function unknownCategoryError(category, summaries, emitJson) {
   const render = categoryEnumerationRender(summaries);
   console.error(message);
   console.error("");
-  console.error(_chunkRV6ALZIXjs.renderCommandEnvelopeText.call(void 0, { render }).trimEnd());
+  console.error(_chunkKGNTKMRGjs.renderCommandEnvelopeText.call(void 0, { render }).trimEnd());
   console.error("");
   console.error(`Valid categories: ${known.join(", ")}`);
   return 4;
 }
 async function listToolsInCategory(category, emitJson) {
-  const client = new (0, _chunkCVLM3WMJjs.DeeplineClient)();
+  const client = new (0, _chunkE23BQ5SCjs.DeeplineClient)();
   const rawTools = await client.listTools({
     categories: category,
     compact: false
@@ -673,7 +709,7 @@ async function listToolsInCategory(category, emitJson) {
   if (!summaries.some((item) => item.name === category)) {
     return unknownCategoryError(category, summaries, emitJson);
   }
-  const rows = rawTools.filter((tool) => _optionalChain([tool, 'access', _7 => _7.categories, 'optionalAccess', _8 => _8.includes, 'call', _9 => _9(category)])).map((tool) => ({
+  const rows = rawTools.filter((tool) => _optionalChain([tool, 'access', _10 => _10.categories, 'optionalAccess', _11 => _11.includes, 'call', _12 => _12(category)])).map((tool) => ({
     id: tool.toolId,
     provider: tool.provider,
     required: requiredInputIds(tool),
@@ -700,7 +736,7 @@ async function listToolsInCategory(category, emitJson) {
       }
     ]
   };
-  _chunkRV6ALZIXjs.printCommandEnvelope.call(void 0, 
+  _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
     {
       category,
       total: rows.length,
@@ -713,7 +749,7 @@ async function listToolsInCategory(category, emitJson) {
   return 0;
 }
 async function listToolsForCategoryFilter(requestedCategories, emitJson, compact) {
-  const client = new (0, _chunkCVLM3WMJjs.DeeplineClient)();
+  const client = new (0, _chunkE23BQ5SCjs.DeeplineClient)();
   const items = (await client.listTools({
     categories: requestedCategories.join(","),
     compact
@@ -742,7 +778,7 @@ async function listToolsForCategoryFilter(requestedCategories, emitJson, compact
     ]
   };
   const outputItems = compact ? items.map(compactTool) : items;
-  _chunkRV6ALZIXjs.printCommandEnvelope.call(void 0, 
+  _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
     {
       tools: outputItems,
       count: outputItems.length,
@@ -758,16 +794,16 @@ async function listToolsForCategoryFilter(requestedCategories, emitJson, compact
   return 0;
 }
 async function listTools(category, options = {}) {
-  const positional = _nullishCoalesce(_optionalChain([category, 'optionalAccess', _10 => _10.trim, 'call', _11 => _11()]), () => ( ""));
+  const positional = _nullishCoalesce(_optionalChain([category, 'optionalAccess', _13 => _13.trim, 'call', _14 => _14()]), () => ( ""));
   const flagCategories = (_nullishCoalesce(options.categories, () => ( ""))).split(",").map((item) => item.trim()).filter(Boolean);
   const compact = options.compact !== false;
-  const emitJson = options.json === true || _chunkRV6ALZIXjs.shouldEmitJson.call(void 0, );
+  const emitJson = options.json === true || _chunkKGNTKMRGjs.shouldEmitJson.call(void 0, );
   if (positional && flagCategories.length > 0) {
     const flagIsSameSingle = flagCategories.length === 1 && flagCategories[0] === positional;
     if (!flagIsSameSingle) {
       const message = `Category "${positional}" and --categories ${flagCategories.join(",")} disagree. Pass one: deepline tools list ${positional}`;
       if (emitJson) {
-        _chunkRV6ALZIXjs.printJson.call(void 0, {
+        _chunkKGNTKMRGjs.printJson.call(void 0, {
           ok: false,
           exitCode: 2,
           code: "TOOL_LIST_CATEGORY_CONFLICT",
@@ -794,7 +830,7 @@ async function grepTools(queryInput, options = {}) {
     console.error("Usage: deepline tools grep <query> [--json]");
     return 1;
   }
-  const client = new (0, _chunkCVLM3WMJjs.DeeplineClient)();
+  const client = new (0, _chunkE23BQ5SCjs.DeeplineClient)();
   const requestedCategories = options.categories ? options.categories.split(",").map((item) => item.trim()).filter(Boolean) : [];
   const mode = _nullishCoalesce(options.mode, () => ( "all"));
   const jsonOutput = options.json === true;
@@ -837,7 +873,7 @@ async function grepTools(queryInput, options = {}) {
     query,
     mode
   }) : null;
-  _chunkRV6ALZIXjs.printCommandEnvelope.call(void 0, 
+  _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
     {
       tools: outputTools,
       count: outputTools.length,
@@ -855,7 +891,7 @@ async function grepTools(queryInput, options = {}) {
       } : {},
       commandTemplates: TOOL_COMMAND_TEMPLATES
     },
-    { json: options.json || _chunkRV6ALZIXjs.shouldEmitJson.call(void 0, ) }
+    { json: options.json || _chunkKGNTKMRGjs.shouldEmitJson.call(void 0, ) }
   );
   return 0;
 }
@@ -881,7 +917,7 @@ function compactTool(tool) {
   };
 }
 function playIdentifiers(play) {
-  return [play.name, play.reference, ..._nullishCoalesce(play.aliases, () => ( []))].filter((value2) => Boolean(_optionalChain([value2, 'optionalAccess', _12 => _12.trim, 'call', _13 => _13()]))).map((value2) => value2.trim());
+  return [play.name, play.reference, ..._nullishCoalesce(play.aliases, () => ( []))].filter((value2) => Boolean(_optionalChain([value2, 'optionalAccess', _15 => _15.trim, 'call', _16 => _16()]))).map((value2) => value2.trim());
 }
 async function findPlayForToolId(client, toolId, cliInvocationId) {
   const requested = toolId.trim();
@@ -979,6 +1015,46 @@ Output:
   exact charge. Workspace balance changes also include other callers' activity.
 `
   );
+  tools.command("connect <provider>").description(
+    "Save your provider credentials for the active workspace (owner/admin required)."
+  ).requiredOption(
+    "--credentials-file <path>",
+    "JSON object of credential field names and string values; keep this file private"
+  ).option("--json", "Emit a confirmation without credential values").action(
+    async (provider, options) => {
+      let credentials;
+      try {
+        credentials = JSON.parse(
+          _fs.readFileSync.call(void 0, _path.resolve.call(void 0, options.credentialsFile), "utf8")
+        );
+      } catch (e2) {
+        throw new Error(
+          "Unable to read --credentials-file as a JSON object."
+        );
+      }
+      if (!credentials || typeof credentials !== "object" || Array.isArray(credentials) || Object.keys(credentials).length === 0 || Object.values(credentials).some((value2) => typeof value2 !== "string")) {
+        throw new Error(
+          "--credentials-file must contain a nonempty JSON object of string credential values."
+        );
+      }
+      const result = await new (0, _chunkE23BQ5SCjs.DeeplineClient)().setIntegrationCredentials(
+        provider,
+        credentials
+      );
+      if (!result.ok || result.credential_saved !== true) {
+        throw new Error(
+          "The API did not confirm that provider credentials were saved. Inspect the integration before retrying."
+        );
+      }
+      const confirmation = { provider, credential_saved: true };
+      if (_chunkKGNTKMRGjs.shouldEmitJson.call(void 0, options.json))
+        console.log(JSON.stringify(confirmation));
+      else
+        console.log(
+          `Credentials saved for ${provider} in the active workspace.`
+        );
+    }
+  );
   tools.command("list [category]").description("Browse tool categories, or list every tool in a category.").addHelpText(
     "after",
     `
@@ -1011,7 +1087,7 @@ Examples:
       json: Boolean(options.json)
     });
   });
-  _chunkUCKJQG25js.registerDeprecatedSearchCommand.call(void 0, tools, () => ["tools", "monitors"]);
+  _chunkVK6FYZLPjs.registerDeprecatedSearchCommand.call(void 0, tools, () => ["tools", "monitors"]);
   tools.command("grep <query>").description(
     "Literal grep over tool ids, descriptions, categories, and input fields."
   ).addHelpText(
@@ -1112,7 +1188,7 @@ Examples:
         process.exitCode = await narrowView();
         return;
       }
-      const { describeAnything } = await Promise.resolve().then(() => _interopRequireWildcard(require("./describe-FDV2V74F.js")));
+      const { describeAnything } = await Promise.resolve().then(() => _interopRequireWildcard(require("./describe-FRH32RDV.js")));
       process.exitCode = await describeAnything(
         toolId,
         {
@@ -1198,7 +1274,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
     console.error("Usage: deepline tools describe <toolId> [--json]");
     return 1;
   }
-  const client = new (0, _chunkCVLM3WMJjs.DeeplineClient)();
+  const client = new (0, _chunkE23BQ5SCjs.DeeplineClient)();
   let tool;
   try {
     tool = await _asyncNullishCoalesce(compatibilityMetadata, async () => ( await client.getTool(toolId)));
@@ -1252,10 +1328,10 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
     const lines = toolPricingOnlyLines(tool, toolId);
     if (inferenceQuote)
       lines.push(...inferenceQuoteSummaryLines(inferenceQuote));
-    _chunkRV6ALZIXjs.printCommandEnvelope.call(void 0, 
+    _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
       {
         toolId: String(tool.toolId || toolId),
-        cost: _chunkUCKJQG25js.Capability.fromCatalogEntry(tool).describe().customerCost(),
+        cost: _chunkVK6FYZLPjs.Capability.fromCatalogEntry(tool).describe().customerCost(),
         ...modelDescription ? { modelOptions: modelDescription } : {},
         ...isMonitorTypeTool(tool) ? { pricing: recordField(tool, "pricing") } : {},
         ...inferenceQuote ? { inferenceQuote } : {}
@@ -1270,7 +1346,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
   }
   if ((options.schemaOnly || options.examplesOnly || options.gettersOnly) && !isMonitorTypeTool(tool) && !isPlayLikeTool(tool) && (options.json || options.contractJson)) {
     const contract = toolContractJsonForDescribe(tool, toolId);
-    _chunkRV6ALZIXjs.printCompactJson.call(void 0, {
+    _chunkKGNTKMRGjs.printCompactJson.call(void 0, {
       toolId: contract.toolId,
       ...options.schemaOnly ? {
         inputSchema: contract.inputSchema,
@@ -1293,7 +1369,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
     return 0;
   }
   if (options.contractJson) {
-    _chunkRV6ALZIXjs.printCompactJson.call(void 0, {
+    _chunkKGNTKMRGjs.printCompactJson.call(void 0, {
       ...toolContractJsonForDescribe(tool, toolId),
       ...modelDescription ? { modelOptions: modelDescription } : {},
       ...inferenceQuote ? { inferenceQuote } : {}
@@ -1302,7 +1378,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
   }
   const emitJson = options.json === true;
   if (emitJson) {
-    _chunkRV6ALZIXjs.printCompactJson.call(void 0, {
+    _chunkKGNTKMRGjs.printCompactJson.call(void 0, {
       ...toolMetadataJsonForDescribe(tool, toolId),
       ...modelDescription ? { modelOptions: modelDescription } : {},
       ...inferenceQuote ? { inferenceQuote } : {}
@@ -1373,13 +1449,13 @@ function toolContractJsonForDescribe(tool, requestedToolId, authoringContractEdi
     arrayField2(toolExecutionResult, "extractedLists", "extracted_lists")
   ).map((entry) => ({
     ...entry,
-    returnType: _chunk5O4B6AUNjs.playToolListGetterMode.call(void 0, authoringContractEdition) === "array" ? "Array" : "PlayDataset",
-    rowsExpression: _chunk5O4B6AUNjs.playToolListGetterMode.call(void 0, authoringContractEdition) === "array" ? entry.expression : `await ${entry.expression}.materialize()`
+    returnType: _chunkKB4SDX5Sjs.playToolListGetterMode.call(void 0, authoringContractEdition) === "array" ? "Array" : "PlayDataset",
+    rowsExpression: _chunkKB4SDX5Sjs.playToolListGetterMode.call(void 0, authoringContractEdition) === "array" ? entry.expression : `await ${entry.expression}.materialize()`
   }));
   const extractedValues = extractionContractEntries(
     arrayField2(toolExecutionResult, "extractedValues", "extracted_values")
   );
-  const pricing = _chunkUCKJQG25js.Capability.fromCatalogEntry(tool).describe().customerCost();
+  const pricing = _chunkVK6FYZLPjs.Capability.fromCatalogEntry(tool).describe().customerCost();
   const executionMetadataRecord = recordField(
     tool,
     "executionMetadata",
@@ -1418,6 +1494,7 @@ function toolContractJsonForDescribe(tool, requestedToolId, authoringContractEdi
     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,
@@ -1581,12 +1658,12 @@ function schemaNodeAt(schema, path) {
   return node;
 }
 var NAMED_VALUE_SHAPES = {
-  email_status: { shape: "EmailStatus", schema: _chunk3VN4FTE3js.EMAIL_STATUS_JSON_SCHEMA },
-  job_change: { shape: "JobChange", schema: _chunk3VN4FTE3js.JOB_CHANGE_JSON_SCHEMA }
+  email_status: { shape: "EmailStatus", schema: _chunkRDXFGPJUjs.EMAIL_STATUS_JSON_SCHEMA },
+  job_change: { shape: "JobChange", schema: _chunkRDXFGPJUjs.JOB_CHANGE_JSON_SCHEMA }
 };
 function extractorValueType(name) {
-  if (!_chunk3VN4FTE3js.isDeeplineExtractorTarget.call(void 0, name)) return void 0;
-  const definition = _chunk3VN4FTE3js.DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS[name];
+  if (!_chunkRDXFGPJUjs.isDeeplineExtractorTarget.call(void 0, name)) return void 0;
+  const definition = _chunkRDXFGPJUjs.DEEPLINE_EXTRACTOR_TARGET_DEFINITIONS[name];
   if (definition.enum) {
     return {
       type: definition.enum.map((value2) => JSON.stringify(value2)).join(" | ")
@@ -1680,7 +1757,7 @@ function describedTool(tool, requestedToolId) {
         ...means ? { means } : {},
         // A normalized value has a named type instead of the response's
         // shape; a normalized object is spelled out once under Types.
-        ..._optionalChain([deepline, 'optionalAccess', _14 => _14.shape]) ? deepline : valueType ? { type: valueType } : known ? known : fields ? { fields } : {},
+        ..._optionalChain([deepline, 'optionalAccess', _17 => _17.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),
@@ -1693,14 +1770,14 @@ function describedTool(tool, requestedToolId) {
   const lists = declaredLists.some(({ node }) => node) ? declaredLists.filter(({ node }) => node) : declaredLists;
   const values = getterOutputs("extractedValues", [
     outputSchema,
-    ...lists.map(({ node }) => _optionalChain([node, 'optionalAccess', _15 => _15.items]))
+    ...lists.map(({ node }) => _optionalChain([node, 'optionalAccess', _18 => _18.items]))
   ]).map((value2) => {
     if (!lists.length || !value2.field.paths) return value2;
     const within = value2.field.paths.map(
       (path) => path.replace(/^toolResponse\.raw\./, "")
     );
     const list = _nullishCoalesce(lists.find(
-      ({ node }) => within.some((path) => isRecord(schemaNodeAt(_optionalChain([node, 'optionalAccess', _16 => _16.items]), path)))
+      ({ node }) => within.some((path) => isRecord(schemaNodeAt(_optionalChain([node, 'optionalAccess', _19 => _19.items]), path)))
     ), () => ( lists[0]));
     return {
       ...value2,
@@ -1717,7 +1794,7 @@ function describedTool(tool, requestedToolId) {
       stringField2(cost, "displayText"),
       // "Free (free)" says the same thing twice.
       billing.toLowerCase() === stringField2(cost, "displayText").toLowerCase() ? "" : billing && `(${billing})`,
-      _chunkUCKJQG25js.observedMaxText.call(void 0, cost) && `\u2014 ${_chunkUCKJQG25js.observedMaxText.call(void 0, cost)}`
+      _chunkVK6FYZLPjs.observedMaxText.call(void 0, cost) && `\u2014 ${_chunkVK6FYZLPjs.observedMaxText.call(void 0, cost)}`
     ].filter(Boolean).join(" ") || void 0,
     guidance: [
       ...contract.deprecated === true ? [`Deprecated. ${stringField2(deprecation, "message")}`.trim()] : [],
@@ -1854,7 +1931,7 @@ function toolPricingOnlyLines(tool, requestedToolId, options = {}) {
     return monitorTypePricingLines(tool);
   }
   const toolId = String(tool.toolId || requestedToolId);
-  const cost = _chunkUCKJQG25js.Capability.fromCatalogEntry(tool).describe().customerCost();
+  const cost = _chunkVK6FYZLPjs.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");
@@ -1866,7 +1943,7 @@ function toolPricingOnlyLines(tool, requestedToolId, options = {}) {
   const price = displayText || summary || (credits !== null ? `${formatDecimal(credits)} Deepline credits${usd !== null ? ` / ${formatUsd(usd)}` : ""} per ${unit}` : "pricing unavailable");
   return [
     `${_nullishCoalesce(options.heading, () => ( `Pricing: ${toolId}`))}: ${price}`,
-    ..._chunkUCKJQG25js.observedMaxText.call(void 0, cost) ? [`  ${_chunkUCKJQG25js.observedMaxText.call(void 0, cost)}`] : [],
+    ..._chunkVK6FYZLPjs.observedMaxText.call(void 0, cost) ? [`  ${_chunkVK6FYZLPjs.observedMaxText.call(void 0, cost)}`] : [],
     ...cost.observedReference || cost.estimatedRange ? [
       ...summary ? [`  ${summary}`] : [],
       ...(_nullishCoalesce(cost.details, () => ( []))).map((detail) => `  ${detail}`)
@@ -1974,7 +2051,7 @@ function printToolExamplesOnly(tool, requestedToolId) {
   ), () => ( listGetters.find(isRecord)));
   if (isRecord(firstList)) {
     const name = safeIdentifier(stringField2(firstList, "name") || "list");
-    if (_chunk5O4B6AUNjs.playToolListGetterMode.call(void 0, ) === "array") {
+    if (_chunkKB4SDX5Sjs.playToolListGetterMode.call(void 0, ) === "array") {
       console.log(`const ${name}_rows = ${playResultExpression(firstList)};`);
     } else {
       console.log(`const ${name}_ds = ${playResultExpression(firstList)};`);
@@ -2050,7 +2127,7 @@ function printToolGettersOnly(tool, requestedToolId) {
   }
 }
 function printListGetterConsumption() {
-  if (_chunk5O4B6AUNjs.playToolListGetterMode.call(void 0, ) === "array") {
+  if (_chunkKB4SDX5Sjs.playToolListGetterMode.call(void 0, ) === "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."
     );
@@ -2061,7 +2138,7 @@ function printListGetterConsumption() {
   );
 }
 function listGetterHeading() {
-  return _chunk5O4B6AUNjs.playToolListGetterMode.call(void 0, ) === "array" ? "Lists (ordinary JavaScript arrays):" : "Lists (PlayDataset, not a JavaScript array):";
+  return _chunkKB4SDX5Sjs.playToolListGetterMode.call(void 0, ) === "array" ? "Lists (ordinary JavaScript arrays):" : "Lists (PlayDataset, not a JavaScript array):";
 }
 function sampleValueForField(field) {
   const name = stringField2(field, "name").toLowerCase();
@@ -2144,7 +2221,7 @@ function toolMetadataJsonForDescribe(tool, requestedToolId) {
   } = tool;
   const outputSchemaRecord = recordField(tool, "outputSchema", "output_schema");
   return {
-    cost: _chunkUCKJQG25js.Capability.fromCatalogEntry(tool).describe().customerCost(),
+    cost: _chunkVK6FYZLPjs.Capability.fromCatalogEntry(tool).describe().customerCost(),
     ...publicTool,
     toolId,
     provider: tool.provider,
@@ -2202,7 +2279,7 @@ function usageGuidanceWithAccessDefaults(usageGuidance) {
       extractedLists: {
         ...recordField(existingAccess, "extractedLists"),
         expression: "toolExecutionResult.extractedLists.<name>.get()",
-        meaning: _chunk5O4B6AUNjs.playToolListGetterMode.call(void 0, ) === "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."
+        meaning: _chunkKB4SDX5Sjs.playToolListGetterMode.call(void 0, ) === "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",
@@ -2248,9 +2325,9 @@ function toolInputFieldsForDisplay(inputSchema) {
     );
     return fields.map((field) => {
       const jsonSchemaField = typeof field.name === "string" ? jsonSchemaFields.get(field.name) : void 0;
-      const minItems = typeof field.minItems === "number" ? field.minItems : _optionalChain([jsonSchemaField, 'optionalAccess', _17 => _17.minItems]);
-      const maxItems = typeof field.maxItems === "number" ? field.maxItems : _optionalChain([jsonSchemaField, 'optionalAccess', _18 => _18.maxItems]);
-      const items = isRecord(field.items) ? field.items : _optionalChain([jsonSchemaField, 'optionalAccess', _19 => _19.items]);
+      const minItems = typeof field.minItems === "number" ? field.minItems : _optionalChain([jsonSchemaField, 'optionalAccess', _20 => _20.minItems]);
+      const maxItems = typeof field.maxItems === "number" ? field.maxItems : _optionalChain([jsonSchemaField, 'optionalAccess', _21 => _21.maxItems]);
+      const items = isRecord(field.items) ? field.items : _optionalChain([jsonSchemaField, 'optionalAccess', _22 => _22.items]);
       return {
         ...field,
         ...isRecord(items) ? { items } : {},
@@ -2439,7 +2516,7 @@ function inputFieldJsonForDescribe(field) {
 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;
-  const itemEnum = Array.isArray(_optionalChain([itemSchema, 'optionalAccess', _20 => _20.enum])) ? ` enum=${itemSchema.enum.map(String).join("|")}` : "";
+  const itemEnum = Array.isArray(_optionalChain([itemSchema, 'optionalAccess', _23 => _23.enum])) ? ` enum=${itemSchema.enum.map(String).join("|")}` : "";
   const itemTypeSuffix = itemType && itemType !== "unknown" ? ` items=${itemType}${itemEnum}` : "";
   const minItems = typeof field.minItems === "number" && Number.isFinite(field.minItems) ? field.minItems : null;
   const maxItems = typeof field.maxItems === "number" && Number.isFinite(field.maxItems) ? field.maxItems : null;
@@ -2568,7 +2645,7 @@ function extractToolExecutionWarningMessages(rawResponse) {
   ];
   const messages = [];
   for (const candidate of candidates) {
-    const warnings = _optionalChain([candidate, 'optionalAccess', _21 => _21.warnings]);
+    const warnings = _optionalChain([candidate, 'optionalAccess', _24 => _24.warnings]);
     if (!Array.isArray(warnings)) continue;
     for (const warning of warnings) {
       if (typeof warning === "string" && warning.trim()) {
@@ -2604,10 +2681,10 @@ function apifySyncRecoveryNext(rawResponse) {
   };
 }
 function listExtractorPathsFromUsageGuidance(tool) {
-  const toolExecutionResult = _optionalChain([tool, 'access', _22 => _22.usageGuidance, 'optionalAccess', _23 => _23.toolExecutionResult]);
-  const extractedLists = Array.isArray(_optionalChain([toolExecutionResult, 'optionalAccess', _24 => _24.extractedLists])) ? toolExecutionResult.extractedLists : isRecord(_optionalChain([toolExecutionResult, 'optionalAccess', _25 => _25.extractedLists])) ? Object.values(toolExecutionResult.extractedLists) : [];
+  const toolExecutionResult = _optionalChain([tool, 'access', _25 => _25.usageGuidance, 'optionalAccess', _26 => _26.toolExecutionResult]);
+  const extractedLists = Array.isArray(_optionalChain([toolExecutionResult, 'optionalAccess', _27 => _27.extractedLists])) ? toolExecutionResult.extractedLists : isRecord(_optionalChain([toolExecutionResult, 'optionalAccess', _28 => _28.extractedLists])) ? Object.values(toolExecutionResult.extractedLists) : [];
   return extractedLists.flatMap((entry) => {
-    const paths = _nullishCoalesce(_optionalChain([entry, 'access', _26 => _26.details, 'optionalAccess', _27 => _27.candidatePaths]), () => ( _optionalChain([entry, 'access', _28 => _28.details, 'optionalAccess', _29 => _29.rawToolOutputPaths])));
+    const paths = _nullishCoalesce(_optionalChain([entry, 'access', _29 => _29.details, 'optionalAccess', _30 => _30.candidatePaths]), () => ( _optionalChain([entry, 'access', _31 => _31.details, 'optionalAccess', _32 => _32.rawToolOutputPaths])));
     if (!Array.isArray(paths)) return [];
     return paths.map(
       (path) => path.trim().replace(/^toolExecutionResult\.toolResponse\.raw\.?/, "").replace(/^toolExecutionResult\.toolOutput\.raw\.?/, "").replace(/^\./, "")
@@ -2758,7 +2835,7 @@ function parseExecuteOptions(toolId, options, output) {
     outputFormat = normalizeOutputFormat(options.outputFormat);
   }
   if (options.idempotencyKey !== void 0) {
-    _chunkCVLM3WMJjs.validateExecutionIdempotencyKey.call(void 0, options.idempotencyKey);
+    _chunkE23BQ5SCjs.validateExecutionIdempotencyKey.call(void 0, options.idempotencyKey);
   }
   if (options.recoveryTimeoutMs !== void 0) {
     const parsed = Number(options.recoveryTimeoutMs);
@@ -2843,8 +2920,8 @@ export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
   const rows = list.get();
   // ${sampleRows}
   // columns: ${columns}
-  // ${_chunk5O4B6AUNjs.playToolListGetterMode.call(void 0, ) === "array" ? "extractedLists.<name>.get() returns an ordinary array from this response." : "extractedLists.<name>.get() returns a dataset handle for row-shaped list outputs."}
-  // ${_chunk5O4B6AUNjs.playToolListGetterMode.call(void 0, ) === "array" ? "Use array methods directly; pass rows to ctx.dataset to persist row work." : "Pass it to ctx.dataset; use rows.peek/count/materialize only for deliberate bounded inspection."}
+  // ${_chunkKB4SDX5Sjs.playToolListGetterMode.call(void 0, ) === "array" ? "extractedLists.<name>.get() returns an ordinary array from this response." : "extractedLists.<name>.get() returns a dataset handle for row-shaped list outputs."}
+  // ${_chunkKB4SDX5Sjs.playToolListGetterMode.call(void 0, ) === "array" ? "Use array methods directly; pass rows to ctx.dataset to persist row work." : "Pass it to ctx.dataset; use rows.peek/count/materialize only for deliberate bounded inspection."}
   // .withColumn('email_waterfall', (row, rowCtx) => rowCtx.runPlay('name_domain_email', 'name-and-domain-to-email', { first_name: String(row.first_name ?? ''), last_name: String(row.last_name ?? ''), domain: String(row.domain ?? '') }, { description: 'Resolve email.' }))
   // .withColumn('phone_waterfall', (row, rowCtx) => rowCtx.runPlay('contact_phone', 'contact-to-phone', { first_name: String(row.first_name ?? ''), last_name: String(row.last_name ?? ''), email: String(row.email ?? '') }, { description: 'Resolve phone.' }))
   // ctx.dataset is idempotent for completed rows during same-run recovery. New runs follow each call's freshness.
@@ -3069,20 +3146,20 @@ function buildToolExecuteRowArtifactEnvelope(input) {
 }
 async function executeTool(toolId, options) {
   const output = toolExecuteJsonOption(options.json);
-  const wantsJson = _chunkRV6ALZIXjs.shouldEmitJson.call(void 0, output.requested) || (_nullishCoalesce(options.outputFormat, () => ( "auto"))).trim().toLowerCase() !== "csv";
+  const wantsJson = _chunkKGNTKMRGjs.shouldEmitJson.call(void 0, output.requested) || (_nullishCoalesce(options.outputFormat, () => ( "auto"))).trim().toLowerCase() !== "csv";
   let parsed;
   try {
     parsed = parseExecuteOptions(toolId, options, output);
   } catch (error) {
     if (wantsJson) {
-      _chunkRV6ALZIXjs.printJsonError.call(void 0, error);
+      _chunkKGNTKMRGjs.printJsonError.call(void 0, error);
     } else {
       console.error(error instanceof Error ? error.message : String(error));
     }
     return error instanceof _chunk7P5AA3SNjs.DeeplineError && error.code === "IDEMPOTENCY_KEY_INVALID" ? 2 : 1;
   }
   const cliInvocationId = _nullishCoalesce(_chunkQJBJZVG6js.getToolExecuteInvocationId.call(void 0, ), () => ( _chunkQJBJZVG6js.beginToolExecuteCommand.call(void 0, )));
-  const client = new (0, _chunkCVLM3WMJjs.DeeplineClient)();
+  const client = new (0, _chunkE23BQ5SCjs.DeeplineClient)();
   let metadata;
   try {
     metadata = await _chunkQJBJZVG6js.runToolExecuteStage.call(void 0, 
@@ -3097,7 +3174,7 @@ async function executeTool(toolId, options) {
       );
       if (play) {
         if (wantsJson) {
-          _chunkRV6ALZIXjs.printJsonError.call(void 0, 
+          _chunkKGNTKMRGjs.printJsonError.call(void 0, 
             new Error(playAliasToolErrorMessage(parsed.toolId, play))
           );
         } else {
@@ -3110,7 +3187,7 @@ async function executeTool(toolId, options) {
   }
   if (isPlayLikeTool(metadata)) {
     if (wantsJson) {
-      _chunkRV6ALZIXjs.printJsonError.call(void 0, 
+      _chunkKGNTKMRGjs.printJsonError.call(void 0, 
         new Error(
           playLikeToolExecuteErrorMessage(
             parsed.toolId,
@@ -3126,6 +3203,18 @@ async function executeTool(toolId, options) {
     }
     return 2;
   }
+  if (_optionalChain([metadata, 'access', _33 => _33.deprecation, 'optionalAccess', _34 => _34.message])) {
+    console.error(
+      `Warning: ${parsed.toolId} is deprecated. ${metadata.deprecation.message}`
+    );
+  }
+  const requestWarning = firstMatchingToolRequestWarning(
+    metadata.requestWarnings,
+    parsed.params
+  );
+  if (requestWarning) {
+    console.error(`Warning: ${requestWarning.message}`);
+  }
   const responseIntent = parsed.outPath || parsed.outputFormat === "csv" || parsed.outputFormat === "csv_file" ? "row_artifact" : "raw";
   const recovery = ToolCallRecovery.open({
     toolId: parsed.toolId,
@@ -3142,11 +3231,11 @@ async function executeTool(toolId, options) {
     "execute request",
     () => client.executeTool(parsed.toolId, parsed.params, {
       ...parsed.timeoutMs !== void 0 ? { timeout: parsed.timeoutMs } : {},
-      ..._optionalChain([metadata, 'access', _30 => _30.executionMetadata, 'optionalAccess', _31 => _31.retrySafeTransientHttp]) === true ? { maxRetries: 2, retryApiErrors: true } : {},
+      ..._optionalChain([metadata, 'access', _35 => _35.executionMetadata, 'optionalAccess', _36 => _36.retrySafeTransientHttp]) === true ? { maxRetries: 2, retryApiErrors: true } : {},
       responseIntent,
       ...idempotencyKey ? { idempotencyKey } : {},
       ...parsed.recoveryTimeoutMs !== void 0 ? { recoveryTimeoutMs: parsed.recoveryTimeoutMs } : {},
-      searchRef: _chunkUCKJQG25js.recentSearchRef.call(void 0, ),
+      searchRef: _chunkVK6FYZLPjs.recentSearchRef.call(void 0, ),
       cliInvocationId,
       onResponseReceived: _chunkZMVJSS6Njs.recordApiResponse
     }).catch((error) => {
@@ -3167,10 +3256,10 @@ async function executeTool(toolId, options) {
     "result formatting",
     () => {
       const listExtractorPaths = listExtractorPathsFromUsageGuidance(metadata);
-      const listConversion2 = _chunk3VN4FTE3js.tryConvertToList.call(void 0, rawResponse, {
+      const listConversion2 = _chunkRDXFGPJUjs.tryConvertToList.call(void 0, rawResponse, {
         listExtractorPaths
       });
-      const summary2 = _chunk3VN4FTE3js.extractSummaryFields.call(void 0, rawResponse);
+      const summary2 = _chunkRDXFGPJUjs.extractSummaryFields.call(void 0, rawResponse);
       const baseEnvelope2 = buildToolExecuteBaseEnvelope({
         toolId: parsed.toolId,
         params: parsed.params,
@@ -3187,15 +3276,15 @@ async function executeTool(toolId, options) {
   const executeExitCode = toolExecuteExitCode(baseEnvelope);
   const delivered = await _chunkQJBJZVG6js.runToolExecuteStage.call(void 0, "output delivery", () => {
     if (!parsed.outPath && (parsed.outputFormat === "json" || parsed.outputFormat === "auto" && wantsJson)) {
-      _chunkRV6ALZIXjs.printCommandEnvelope.call(void 0, baseEnvelope, { json: true });
+      _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, baseEnvelope, { json: true });
       return true;
     }
     if (parsed.outputFormat === "json_file") {
-      const jsonPath = _chunk3VN4FTE3js.writeJsonOutputFile.call(void 0, 
+      const jsonPath = _chunkRDXFGPJUjs.writeJsonOutputFile.call(void 0, 
         rawResponse,
         `payload_${parsed.toolId}`
       );
-      _chunkRV6ALZIXjs.printCommandEnvelope.call(void 0, 
+      _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
         {
           ...baseEnvelope,
           local: {
@@ -3217,18 +3306,18 @@ async function executeTool(toolId, options) {
           `${parsed.toolId} did not expose row-shaped output to write as CSV. ${inspection.inspectDescription} Run: ${inspection.inspect}`
         );
         if (wantsJson) {
-          _chunkRV6ALZIXjs.printJsonError.call(void 0, error);
+          _chunkKGNTKMRGjs.printJsonError.call(void 0, error);
         } else {
           console.error(error.message);
         }
         return false;
       }
       if (parsed.outputFormat === "csv" || parsed.outputFormat === "csv_file") {
-        const jsonPath = _chunk3VN4FTE3js.writeJsonOutputFile.call(void 0, 
+        const jsonPath = _chunkRDXFGPJUjs.writeJsonOutputFile.call(void 0, 
           rawResponse,
           `payload_${parsed.toolId}`
         );
-        _chunkRV6ALZIXjs.printCommandEnvelope.call(void 0, 
+        _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
           {
             ...baseEnvelope,
             local: {
@@ -3239,11 +3328,11 @@ async function executeTool(toolId, options) {
         );
         return true;
       }
-      _chunkRV6ALZIXjs.printCommandEnvelope.call(void 0, baseEnvelope, { json: false });
+      _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, baseEnvelope, { json: false });
       return true;
     }
-    const rowOutput = _chunk3VN4FTE3js.projectRowOutput.call(void 0, listConversion);
-    const csv = _chunk3VN4FTE3js.writeCsvOutputFile.call(void 0, 
+    const rowOutput = _chunkRDXFGPJUjs.projectRowOutput.call(void 0, listConversion);
+    const csv = _chunkRDXFGPJUjs.writeCsvOutputFile.call(void 0, 
       listConversion.rows,
       `${parsed.toolId}_output`,
       parsed.outPath ? { outPath: parsed.outPath } : void 0
@@ -3263,7 +3352,7 @@ async function executeTool(toolId, options) {
       seededScript
     });
     if (parsed.outputFormat === "csv_file") {
-      _chunkRV6ALZIXjs.printCommandEnvelope.call(void 0, materializedEnvelope, { json: true });
+      _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, materializedEnvelope, { json: true });
       return true;
     }
     if (parsed.outPath) {
@@ -3271,7 +3360,7 @@ async function executeTool(toolId, options) {
         toolId: parsed.toolId,
         idempotencyKey
       });
-      _chunkRV6ALZIXjs.printCommandEnvelope.call(void 0, materializedEnvelope, {
+      _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, materializedEnvelope, {
         json: wantsJson,
         text: `Wrote ${csv.rowCount} row(s) to ${csv.path}
 inspect: ${inspection.inspect}
@@ -3280,7 +3369,7 @@ inspect: ${inspection.inspect}
       return true;
     }
     if (parsed.noPreview) {
-      _chunkRV6ALZIXjs.printCommandEnvelope.call(void 0, 
+      _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, 
         {
           ...materializedEnvelope,
           local: {
@@ -3293,7 +3382,7 @@ inspect: ${inspection.inspect}
       );
       return true;
     }
-    _chunkRV6ALZIXjs.printCommandEnvelope.call(void 0, materializedEnvelope, {
+    _chunkKGNTKMRGjs.printCommandEnvelope.call(void 0, materializedEnvelope, {
       json: wantsJson && parsed.outputFormat !== "csv"
     });
     return true;