deepline 0.3.328 → 0.3.330

package/dist/cli/{chunk-2FPVWL4W.js → chunk-LNDGT7NV.js}

@@ -10,7 +10,7 @@ var _chunkAID3OYVJjs = require('./chunk-AID3OYVJ.js');
 
 
 
-var _chunkUDIPEHNJjs = require('./chunk-UDIPEHNJ.js');
+var _chunk46IVSO6Ojs = require('./chunk-46IVSO6O.js');
 
 
 
@@ -22,7 +22,7 @@ var _chunkNXDRDJ4Kjs = require('./chunk-NXDRDJ4K.js');
 
 
 
-var _chunkITFUZEHEjs = require('./chunk-ITFUZEHE.js');
+var _chunkYGFQ7YSMjs = require('./chunk-YGFQ7YSM.js');
 
 
 
@@ -36,11 +36,14 @@ var _chunkQJBJZVG6js = require('./chunk-QJBJZVG6.js');
 
 
 
-var _chunkDNMV2L7Qjs = require('./chunk-DNMV2L7Q.js');
+var _chunkWHKTRZ3Jjs = require('./chunk-WHKTRZ3J.js');
 
 
 
-var _chunkO5GPNPOCjs = require('./chunk-O5GPNPOC.js');
+var _chunkGHHLLEZKjs = require('./chunk-GHHLLEZK.js');
+
+
+var _chunkFKKNYKDYjs = require('./chunk-FKKNYKDY.js');
 
 
 var _chunk7P5AA3SNjs = require('./chunk-7P5AA3SN.js');
@@ -85,10 +88,10 @@ var ToolCallRecovery = class _ToolCallRecovery {
   }
 };
 function pendingToolExecutionPath(input) {
-  const config = _chunkO5GPNPOCjs.resolveConfig.call(void 0, );
+  const config = _chunkGHHLLEZKjs.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(_chunkNXDRDJ4Kjs.stableStringify.call(void 0, input.params)).update("\0").update(input.responseIntent).digest("hex");
   return _path.join.call(void 0, 
-    _chunkO5GPNPOCjs.sdkCliStateDirPath.call(void 0, config.baseUrl),
+    _chunkGHHLLEZKjs.sdkCliStateDirPath.call(void 0, config.baseUrl),
     `pending-tool-execution-${fingerprint}.json`
   );
 }
@@ -302,7 +305,19 @@ var CapabilityDescription = class _CapabilityDescription {
       billingSource,
       billingSourceLabel,
       deeplineCreditsPerPricingUnit: isFree ? 0 : canonicalCredits,
-      deeplineUsdPerPricingUnit: isFree ? 0 : canonicalUsd
+      deeplineUsdPerPricingUnit: isFree ? 0 : canonicalUsd,
+      ...pricing.estimatedRange && !isFree && billingSource !== "own_provider_credentials" ? {
+        estimatedRange: pricing.estimatedRange,
+        details: Array.isArray(pricing.details) ? pricing.details.filter(
+          (value) => typeof value === "string"
+        ) : []
+      } : {},
+      ...pricing.observedReference && !isFree && billingSource !== "own_provider_credentials" ? {
+        observedReference: pricing.observedReference,
+        details: Array.isArray(pricing.details) ? pricing.details.filter(
+          (value) => typeof value === "string"
+        ) : []
+      } : {}
     };
   }
 };
@@ -520,12 +535,12 @@ function categoryEnumerationRender(summaries) {
   };
 }
 async function listToolCategories(emitJson, compact) {
-  const client = new (0, _chunkITFUZEHEjs.DeeplineClient)();
+  const client = new (0, _chunkYGFQ7YSMjs.DeeplineClient)();
   const rawTools = await client.listTools({ compact });
   const items = rawTools.map(toListedTool);
   const summaries = aggregateCategorySummaries(rawTools);
   const outputItems = compact ? items.map(compactTool) : items;
-  _chunkDNMV2L7Qjs.printCommandEnvelope.call(void 0, 
+  _chunkWHKTRZ3Jjs.printCommandEnvelope.call(void 0, 
     {
       tools: outputItems,
       count: outputItems.length,
@@ -544,7 +559,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) {
-    _chunkDNMV2L7Qjs.printJson.call(void 0, {
+    _chunkWHKTRZ3Jjs.printJson.call(void 0, {
       ok: false,
       exitCode: 4,
       code: "TOOL_CATEGORY_NOT_FOUND",
@@ -558,13 +573,13 @@ function unknownCategoryError(category, summaries, emitJson) {
   const render = categoryEnumerationRender(summaries);
   console.error(message);
   console.error("");
-  console.error(_chunkDNMV2L7Qjs.renderCommandEnvelopeText.call(void 0, { render }).trimEnd());
+  console.error(_chunkWHKTRZ3Jjs.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, _chunkITFUZEHEjs.DeeplineClient)();
+  const client = new (0, _chunkYGFQ7YSMjs.DeeplineClient)();
   const rawTools = await client.listTools({
     categories: category,
     compact: false
@@ -601,7 +616,7 @@ async function listToolsInCategory(category, emitJson) {
       }
     ]
   };
-  _chunkDNMV2L7Qjs.printCommandEnvelope.call(void 0, 
+  _chunkWHKTRZ3Jjs.printCommandEnvelope.call(void 0, 
     {
       category,
       total: rows.length,
@@ -614,7 +629,7 @@ async function listToolsInCategory(category, emitJson) {
   return 0;
 }
 async function listToolsForCategoryFilter(requestedCategories, emitJson, compact) {
-  const client = new (0, _chunkITFUZEHEjs.DeeplineClient)();
+  const client = new (0, _chunkYGFQ7YSMjs.DeeplineClient)();
   const items = (await client.listTools({
     categories: requestedCategories.join(","),
     compact
@@ -643,7 +658,7 @@ async function listToolsForCategoryFilter(requestedCategories, emitJson, compact
     ]
   };
   const outputItems = compact ? items.map(compactTool) : items;
-  _chunkDNMV2L7Qjs.printCommandEnvelope.call(void 0, 
+  _chunkWHKTRZ3Jjs.printCommandEnvelope.call(void 0, 
     {
       tools: outputItems,
       count: outputItems.length,
@@ -662,13 +677,13 @@ async function listTools(category, options = {}) {
   const positional = _nullishCoalesce(_optionalChain([category, 'optionalAccess', _9 => _9.trim, 'call', _10 => _10()]), () => ( ""));
   const flagCategories = (_nullishCoalesce(options.categories, () => ( ""))).split(",").map((item) => item.trim()).filter(Boolean);
   const compact = options.compact !== false;
-  const emitJson = options.json === true || _chunkDNMV2L7Qjs.shouldEmitJson.call(void 0, );
+  const emitJson = options.json === true || _chunkWHKTRZ3Jjs.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) {
-        _chunkDNMV2L7Qjs.printJson.call(void 0, {
+        _chunkWHKTRZ3Jjs.printJson.call(void 0, {
           ok: false,
           exitCode: 2,
           code: "TOOL_LIST_CATEGORY_CONFLICT",
@@ -695,7 +710,7 @@ async function grepTools(queryInput, options = {}) {
     console.error("Usage: deepline tools grep <query> [--json]");
     return 1;
   }
-  const client = new (0, _chunkITFUZEHEjs.DeeplineClient)();
+  const client = new (0, _chunkYGFQ7YSMjs.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;
@@ -738,7 +753,7 @@ async function grepTools(queryInput, options = {}) {
     query,
     mode
   }) : null;
-  _chunkDNMV2L7Qjs.printCommandEnvelope.call(void 0, 
+  _chunkWHKTRZ3Jjs.printCommandEnvelope.call(void 0, 
     {
       tools: outputTools,
       count: outputTools.length,
@@ -756,7 +771,7 @@ async function grepTools(queryInput, options = {}) {
       } : {},
       commandTemplates: TOOL_COMMAND_TEMPLATES
     },
-    { json: options.json || _chunkDNMV2L7Qjs.shouldEmitJson.call(void 0, ) }
+    { json: options.json || _chunkWHKTRZ3Jjs.shouldEmitJson.call(void 0, ) }
   );
   return 0;
 }
@@ -912,7 +927,7 @@ Examples:
       json: Boolean(options.json)
     });
   });
-  _chunkUDIPEHNJjs.registerDeprecatedSearchCommand.call(void 0, tools, () => ["tools", "monitors"]);
+  _chunk46IVSO6Ojs.registerDeprecatedSearchCommand.call(void 0, tools, () => ["tools", "monitors"]);
   tools.command("grep <query>").description(
     "Literal grep over tool ids, descriptions, categories, and input fields."
   ).addHelpText(
@@ -959,6 +974,7 @@ Notes:
   preserve the nesting shown in the tool's example. Schemas and examples are
   separate describe fields.
   get is accepted as a compatibility alias for describe.
+  Text by default, including when piped; pass --json for structured output.
 
 Examples:
   deepline tools describe hunter_email_verifier
@@ -971,7 +987,7 @@ Examples:
   deepline tools describe ai_evaluate --estimate-payload @payload.json --json
   deepline tools execute hunter_email_verifier --input '{"email":"a@b.com"}'
 `
-    ).option("--json", "Emit JSON output. Also automatic when stdout is piped").option(
+    ).option("--json", "Emit JSON output").option(
       "--model <model>",
       "For language tools, include AI Gateway metadata; for ai_evaluate, set the quote payload model"
     ).option(
@@ -1013,7 +1029,7 @@ Examples:
         process.exitCode = await narrowView();
         return;
       }
-      const { describeAnything } = await Promise.resolve().then(() => _interopRequireWildcard(require("./describe-CFUZZ326.js")));
+      const { describeAnything } = await Promise.resolve().then(() => _interopRequireWildcard(require("./describe-F4G5H3SC.js")));
       process.exitCode = await describeAnything(
         toolId,
         { ...options, kinds: ["tools", "monitors"], fetchedTool: metadata },
@@ -1095,7 +1111,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
     console.error("Usage: deepline tools describe <toolId> [--json]");
     return 1;
   }
-  const client = new (0, _chunkITFUZEHEjs.DeeplineClient)();
+  const client = new (0, _chunkYGFQ7YSMjs.DeeplineClient)();
   let tool;
   try {
     tool = await _asyncNullishCoalesce(compatibilityMetadata, async () => ( await client.getTool(toolId)));
@@ -1149,7 +1165,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
     const lines = toolPricingOnlyLines(tool, toolId);
     if (inferenceQuote)
       lines.push(...inferenceQuoteSummaryLines(inferenceQuote));
-    _chunkDNMV2L7Qjs.printCommandEnvelope.call(void 0, 
+    _chunkWHKTRZ3Jjs.printCommandEnvelope.call(void 0, 
       {
         toolId: String(tool.toolId || toolId),
         cost: Capability.fromCatalogEntry(tool).describe().customerCost(),
@@ -1167,7 +1183,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);
-    _chunkDNMV2L7Qjs.printCompactJson.call(void 0, {
+    _chunkWHKTRZ3Jjs.printCompactJson.call(void 0, {
       toolId: contract.toolId,
       ...options.schemaOnly ? {
         inputSchema: contract.inputSchema,
@@ -1190,7 +1206,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
     return 0;
   }
   if (options.contractJson) {
-    _chunkDNMV2L7Qjs.printCompactJson.call(void 0, {
+    _chunkWHKTRZ3Jjs.printCompactJson.call(void 0, {
       ...toolContractJsonForDescribe(tool, toolId),
       ...modelDescription ? { modelOptions: modelDescription } : {},
       ...inferenceQuote ? { inferenceQuote } : {}
@@ -1199,7 +1215,7 @@ async function getTool(toolId, options = {}, compatibilityMetadata) {
   }
   const emitJson = options.json === true;
   if (emitJson) {
-    _chunkDNMV2L7Qjs.printCompactJson.call(void 0, {
+    _chunkWHKTRZ3Jjs.printCompactJson.call(void 0, {
       ...toolMetadataJsonForDescribe(tool, toolId),
       ...modelDescription ? { modelOptions: modelDescription } : {},
       ...inferenceQuote ? { inferenceQuote } : {}
@@ -1230,14 +1246,6 @@ ${formatModelDescription(modelDescription)}`);
     if (inferenceQuote) printInferenceQuoteSummary(inferenceQuote);
     return 0;
   }
-  if (_chunkDNMV2L7Qjs.shouldEmitJson.call(void 0, )) {
-    _chunkDNMV2L7Qjs.printCompactJson.call(void 0, {
-      ...toolContractJsonForDescribe(tool, toolId),
-      ...modelDescription ? { modelOptions: modelDescription } : {},
-      ...inferenceQuote ? { inferenceQuote } : {}
-    });
-    return 0;
-  }
   printCompactToolContract(tool, toolId);
   if (modelDescription) {
     process.stdout.write(`
@@ -1257,7 +1265,7 @@ function inferenceQuoteSummaryLines(_quote) {
 function printInferenceQuoteSummary(quote) {
   for (const line of inferenceQuoteSummaryLines(quote)) console.log(line);
 }
-function toolContractJsonForDescribe(tool, requestedToolId) {
+function toolContractJsonForDescribe(tool, requestedToolId, authoringContractEdition) {
   const toolId = String(tool.toolId || requestedToolId);
   const inputFields = toolInputFieldsForDisplay(
     recordField(tool, "inputSchema", "input_schema")
@@ -1276,7 +1284,11 @@ function toolContractJsonForDescribe(tool, requestedToolId) {
   );
   const extractedLists = extractionContractEntries(
     arrayField2(toolExecutionResult, "extractedLists", "extracted_lists")
-  );
+  ).map((entry) => ({
+    ...entry,
+    returnType: _chunkFKKNYKDYjs.playToolListGetterMode.call(void 0, authoringContractEdition) === "array" ? "Array" : "PlayDataset",
+    rowsExpression: _chunkFKKNYKDYjs.playToolListGetterMode.call(void 0, authoringContractEdition) === "array" ? entry.expression : `await ${entry.expression}.materialize()`
+  }));
   const extractedValues = extractionContractEntries(
     arrayField2(toolExecutionResult, "extractedValues", "extracted_values")
   );
@@ -1685,7 +1697,7 @@ function printCompactToolContract(tool, requestedToolId) {
   if (listGetters.length || valueGetters.length) {
     console.log("");
     console.log("Getters:");
-    if (listGetters.length) console.log("Lists:");
+    if (listGetters.length) console.log(listGetterHeading());
     for (const entry of listGetters) {
       if (isRecord(entry))
         console.log(
@@ -1723,6 +1735,10 @@ 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}`,
+    ...cost.observedReference || cost.estimatedRange ? [
+      ...summary ? [`  ${summary}`] : [],
+      ...(_nullishCoalesce(cost.details, () => ( []))).map((detail) => `  ${detail}`)
+    ] : [],
     `Billing: ${billing}`
   ];
 }
@@ -1807,7 +1823,7 @@ function printToolExamplesOnly(tool, requestedToolId) {
   const getters = isRecord(contract.getters) ? contract.getters : {};
   const valueGetters = Array.isArray(getters.extractedValues) ? getters.extractedValues : [];
   const listGetters = Array.isArray(getters.extractedLists) ? getters.extractedLists : [];
-  const firstGetter = [...valueGetters, ...listGetters].find(isRecord);
+  const firstGetter = valueGetters.find(isRecord);
   if (firstGetter) {
     const name = stringField2(firstGetter, "name") || "value";
     const expression = stringField2(firstGetter, "expression");
@@ -1816,7 +1832,28 @@ function printToolExamplesOnly(tool, requestedToolId) {
         `const ${safeIdentifier(name)} = ${expression.replace(/^toolExecutionResult\./, "result.")};`
       );
   }
+  const arrayNames = new Set(
+    recursiveToolInputFieldsForDisplay(
+      recordField(tool, "outputSchema", "output_schema")
+    ).filter((field) => String(field.type).split("|").includes("array")).map((field) => String(field.name).split(".").at(-1))
+  );
+  const firstList = _nullishCoalesce(listGetters.find(
+    (entry) => isRecord(entry) && arrayNames.has(stringField2(entry, "name"))
+  ), () => ( listGetters.find(isRecord)));
+  if (isRecord(firstList)) {
+    const name = safeIdentifier(stringField2(firstList, "name") || "list");
+    if (_chunkFKKNYKDYjs.playToolListGetterMode.call(void 0, ) === "array") {
+      console.log(`const ${name}_rows = ${playResultExpression(firstList)};`);
+    } else {
+      console.log(`const ${name}_ds = ${playResultExpression(firstList)};`);
+      console.log(
+        "// Complete small list from this response; throws above the memory cap."
+      );
+      console.log(`const ${name}_rows = await ${name}_ds.materialize();`);
+    }
+  }
   console.log("```");
+  if (firstList) printListGetterConsumption();
   for (const example of examples) {
     const description = stringField2(example, "description");
     if (description) console.log(description);
@@ -1863,13 +1900,14 @@ function printToolGettersOnly(tool, requestedToolId) {
     return;
   }
   if (listGetters.length) {
-    console.log("Lists:");
+    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:");
@@ -1881,6 +1919,20 @@ function printToolGettersOnly(tool, requestedToolId) {
     }
   }
 }
+function printListGetterConsumption() {
+  if (_chunkFKKNYKDYjs.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."
+    );
+    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 _chunkFKKNYKDYjs.playToolListGetterMode.call(void 0, ) === "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();
@@ -2010,15 +2062,16 @@ function usageGuidanceWithAccessDefaults(usageGuidance) {
     },
     access: {
       ...existingAccess,
-      extractedLists: {
-        expression: "toolExecutionResult.extractedLists.<name>.get()",
-        meaning: "Declared Deepline list extractors only."
-      },
       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: _chunkFKKNYKDYjs.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",
         meaning: "Complete tool response with its original nesting. Read tool-specific fields here; use declared getters for extracted values and lists."
@@ -2573,7 +2626,7 @@ function parseExecuteOptions(toolId, options, output) {
     outputFormat = normalizeOutputFormat(options.outputFormat);
   }
   if (options.idempotencyKey !== void 0) {
-    _chunkITFUZEHEjs.validateExecutionIdempotencyKey.call(void 0, options.idempotencyKey);
+    _chunkYGFQ7YSMjs.validateExecutionIdempotencyKey.call(void 0, options.idempotencyKey);
   }
   if (options.recoveryTimeoutMs !== void 0) {
     const parsed = Number(options.recoveryTimeoutMs);
@@ -2658,8 +2711,8 @@ export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
   const rows = list.get();
   // ${sampleRows}
   // columns: ${columns}
-  // extractedLists.<name>.get() returns a dataset handle for row-shaped list outputs.
-  // Pass it to ctx.dataset; use rows.peek/count/materialize only for deliberate bounded inspection.
+  // ${_chunkFKKNYKDYjs.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."}
+  // ${_chunkFKKNYKDYjs.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.
@@ -2884,20 +2937,20 @@ function buildToolExecuteRowArtifactEnvelope(input) {
 }
 async function executeTool(toolId, options) {
   const output = toolExecuteJsonOption(options.json);
-  const wantsJson = _chunkDNMV2L7Qjs.shouldEmitJson.call(void 0, output.requested);
+  const wantsJson = _chunkWHKTRZ3Jjs.shouldEmitJson.call(void 0, output.requested);
   let parsed;
   try {
     parsed = parseExecuteOptions(toolId, options, output);
   } catch (error) {
     if (wantsJson) {
-      _chunkDNMV2L7Qjs.printJsonError.call(void 0, error);
+      _chunkWHKTRZ3Jjs.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, _chunkITFUZEHEjs.DeeplineClient)();
+  const client = new (0, _chunkYGFQ7YSMjs.DeeplineClient)();
   let metadata;
   try {
     metadata = await _chunkQJBJZVG6js.runToolExecuteStage.call(void 0, 
@@ -2912,7 +2965,7 @@ async function executeTool(toolId, options) {
       );
       if (play) {
         if (wantsJson) {
-          _chunkDNMV2L7Qjs.printJsonError.call(void 0, 
+          _chunkWHKTRZ3Jjs.printJsonError.call(void 0, 
             new Error(playAliasToolErrorMessage(parsed.toolId, play))
           );
         } else {
@@ -2925,7 +2978,7 @@ async function executeTool(toolId, options) {
   }
   if (isPlayLikeTool(metadata)) {
     if (wantsJson) {
-      _chunkDNMV2L7Qjs.printJsonError.call(void 0, 
+      _chunkWHKTRZ3Jjs.printJsonError.call(void 0, 
         new Error(
           playLikeToolExecuteErrorMessage(
             parsed.toolId,
@@ -2961,7 +3014,7 @@ async function executeTool(toolId, options) {
       responseIntent,
       ...idempotencyKey ? { idempotencyKey } : {},
       ...parsed.recoveryTimeoutMs !== void 0 ? { recoveryTimeoutMs: parsed.recoveryTimeoutMs } : {},
-      searchRef: _chunkUDIPEHNJjs.recentSearchRef.call(void 0, ),
+      searchRef: _chunk46IVSO6Ojs.recentSearchRef.call(void 0, ),
       cliInvocationId
     }).catch((error) => {
       const guidanceLines = toolGuidanceLines(metadata.guidance);
@@ -3000,8 +3053,8 @@ 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" && _chunkDNMV2L7Qjs.shouldEmitJson.call(void 0, ))) {
-      _chunkDNMV2L7Qjs.printCommandEnvelope.call(void 0, baseEnvelope, { json: true });
+    if (!parsed.outPath && (parsed.outputFormat === "json" || parsed.outputFormat === "auto" && _chunkWHKTRZ3Jjs.shouldEmitJson.call(void 0, ))) {
+      _chunkWHKTRZ3Jjs.printCommandEnvelope.call(void 0, baseEnvelope, { json: true });
       return true;
     }
     if (parsed.outputFormat === "json_file") {
@@ -3009,7 +3062,7 @@ async function executeTool(toolId, options) {
         rawResponse,
         `payload_${parsed.toolId}`
       );
-      _chunkDNMV2L7Qjs.printCommandEnvelope.call(void 0, 
+      _chunkWHKTRZ3Jjs.printCommandEnvelope.call(void 0, 
         {
           ...baseEnvelope,
           local: {
@@ -3031,7 +3084,7 @@ async function executeTool(toolId, options) {
           `${parsed.toolId} did not expose row-shaped output to write as CSV. ${inspection.inspectDescription} Run: ${inspection.inspect}`
         );
         if (wantsJson) {
-          _chunkDNMV2L7Qjs.printJsonError.call(void 0, error);
+          _chunkWHKTRZ3Jjs.printJsonError.call(void 0, error);
         } else {
           console.error(error.message);
         }
@@ -3042,18 +3095,18 @@ async function executeTool(toolId, options) {
           rawResponse,
           `payload_${parsed.toolId}`
         );
-        _chunkDNMV2L7Qjs.printCommandEnvelope.call(void 0, 
+        _chunkWHKTRZ3Jjs.printCommandEnvelope.call(void 0, 
           {
             ...baseEnvelope,
             local: {
               payload_file: jsonPath
             }
           },
-          { json: parsed.outputFormat === "csv_file" || _chunkDNMV2L7Qjs.shouldEmitJson.call(void 0, ) }
+          { json: parsed.outputFormat === "csv_file" || _chunkWHKTRZ3Jjs.shouldEmitJson.call(void 0, ) }
         );
         return true;
       }
-      _chunkDNMV2L7Qjs.printCommandEnvelope.call(void 0, baseEnvelope, { json: false });
+      _chunkWHKTRZ3Jjs.printCommandEnvelope.call(void 0, baseEnvelope, { json: false });
       return true;
     }
     const rowOutput = _chunkNXDRDJ4Kjs.projectRowOutput.call(void 0, listConversion);
@@ -3077,7 +3130,7 @@ async function executeTool(toolId, options) {
       seededScript
     });
     if (parsed.outputFormat === "csv_file") {
-      _chunkDNMV2L7Qjs.printCommandEnvelope.call(void 0, materializedEnvelope, { json: true });
+      _chunkWHKTRZ3Jjs.printCommandEnvelope.call(void 0, materializedEnvelope, { json: true });
       return true;
     }
     if (parsed.outPath) {
@@ -3085,7 +3138,7 @@ async function executeTool(toolId, options) {
         toolId: parsed.toolId,
         idempotencyKey
       });
-      _chunkDNMV2L7Qjs.printCommandEnvelope.call(void 0, materializedEnvelope, {
+      _chunkWHKTRZ3Jjs.printCommandEnvelope.call(void 0, materializedEnvelope, {
         json: wantsJson,
         text: `Wrote ${csv.rowCount} row(s) to ${csv.path}
 inspect: ${inspection.inspect}
@@ -3094,7 +3147,7 @@ inspect: ${inspection.inspect}
       return true;
     }
     if (parsed.noPreview) {
-      _chunkDNMV2L7Qjs.printCommandEnvelope.call(void 0, 
+      _chunkWHKTRZ3Jjs.printCommandEnvelope.call(void 0, 
         {
           ...materializedEnvelope,
           local: {
@@ -3102,12 +3155,12 @@ inspect: ${inspection.inspect}
             output_path: csv.path
           }
         },
-        { json: _chunkDNMV2L7Qjs.shouldEmitJson.call(void 0, ), text: `${csv.path}
+        { json: _chunkWHKTRZ3Jjs.shouldEmitJson.call(void 0, ), text: `${csv.path}
 ` }
       );
       return true;
     }
-    _chunkDNMV2L7Qjs.printCommandEnvelope.call(void 0, materializedEnvelope, { json: false });
+    _chunkWHKTRZ3Jjs.printCommandEnvelope.call(void 0, materializedEnvelope, { json: false });
     return true;
   });
   if (delivered) {

package/dist/cli/{chunk-SMGNDW7O.mjs → chunk-LQ5DD2UF.mjs}

@@ -2,7 +2,7 @@ import {
   argsWantJson,
   openInBrowser,
   printCommandEnvelope
-} from "./chunk-B2R66UTW.mjs";
+} from "./chunk-7DGZCMXQ.mjs";
 import {
   ACTIVE_ORG_ID_ENV,
   ACTIVE_ORG_NAME_ENV,
@@ -25,7 +25,7 @@ import {
   saveHostEnvValues,
   saveProjectDeeplineEnvValues,
   storedHostApiKey
-} from "./chunk-WWVE4HFN.mjs";
+} from "./chunk-MBI3BVSQ.mjs";
 
 // src/cli/commands/auth.ts
 import {

package/dist/cli/{chunk-WWVE4HFN.mjs → chunk-MBI3BVSQ.mjs}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-DLIRSHV6.mjs";
 import {
   SDK_RELEASE
-} from "./chunk-YFCHBN3C.mjs";
+} from "./chunk-SZCUJ4AL.mjs";
 import {
   DeeplineError,
   TOOL_EXECUTION_ERROR_SCHEMA_VERSION,

package/dist/cli/{chunk-KP7W5NO6.mjs → chunk-NTVTZAVZ.mjs}

@@ -1,7 +1,7 @@
 // ../plays/authoring-contract.ts
 import { Type } from "@sinclair/typebox";
 import { Value } from "@sinclair/typebox/value";
-var PLAY_AUTHORING_CONTRACT_EDITION = 8;
+var PLAY_AUTHORING_CONTRACT_EDITION = 10;
 var SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS = [
   1,
   2,
@@ -11,7 +11,8 @@ var SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS = [
   6,
   7,
   8,
-  9
+  9,
+  10
 ];
 var PLAY_AUTHORING_CONTRACT_CHANGELOG_DETAILS = [
   {
@@ -67,8 +68,17 @@ var PLAY_AUTHORING_CONTRACT_CHANGELOG_DETAILS = [
     compatibilityOwner: "Plays Runtime",
     newWritesEnd: null,
     readerRemoval: null
+  },
+  {
+    changed: "List getters return ordinary arrays from the complete resident tool response. Lazy database datasets require an explicit dataset read; incomplete historical previews fail rather than masquerade as complete arrays. Editions 1\u20139 retain dataset-valued getters; stored tool receipts are unchanged.",
+    compatibilityOwner: "Plays Runtime",
+    newWritesEnd: null,
+    readerRemoval: null
   }
 ];
+function playToolListGetterMode(edition = PLAY_AUTHORING_CONTRACT_EDITION) {
+  return edition >= 10 ? "array" : "dataset";
+}
 var PLAY_AUTHORING_CONTRACT_CHANGELOG = SUPPORTED_PLAY_AUTHORING_CONTRACT_EDITIONS.map((edition, index) => ({
   edition,
   ...PLAY_AUTHORING_CONTRACT_CHANGELOG_DETAILS[index]
@@ -1636,5 +1646,6 @@ var PLAY_AUTHORING_CLOUD_TYPE_DECLARATIONS = [
 
 export {
   PLAY_AUTHORING_CONTRACT_EDITION,
+  playToolListGetterMode,
   CtxFetchHttpError
 };

package/dist/cli/{chunk-XVKQ6D4K.js → chunk-O2L46S3I.js}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkZFKUVDOMjs = require('./chunk-ZFKUVDOM.js');
+var _chunkGKZZ32EVjs = require('./chunk-GKZZ32EV.js');
 
 // src/cli/npm-script-policy.ts
 var _child_process = require('child_process');
@@ -13,7 +13,7 @@ function npmSupportsAllowScripts(version) {
 }
 function readNpmVersion(env) {
   try {
-    const plan = _chunkZFKUVDOMjs.resolveShellSpawn.call(void 0, "npm", ["--version"], process.platform, env);
+    const plan = _chunkGKZZ32EVjs.resolveShellSpawn.call(void 0, "npm", ["--version"], process.platform, env);
     const result = _child_process.spawnSync.call(void 0, plan.command, plan.args, {
       encoding: "utf8",
       env,

package/dist/cli/{chunk-BC7FMQ2G.mjs → chunk-PH2N6GC7.mjs}

@@ -1,7 +1,7 @@
 import {
   getAuthedHttpClient,
   printCommandEnvelope
-} from "./chunk-B2R66UTW.mjs";
+} from "./chunk-7DGZCMXQ.mjs";
 
 // src/cli/commands/sessions.ts
 import {