deepline 0.3.327 → 0.3.329

package/dist/cli/{chunk-D6GD5AVN.mjs → chunk-3RZJ3GEG.mjs}

@@ -1,13 +1,14 @@
 import {
   DeeplineClient
-} from "./chunk-QZAP5VOS.mjs";
+} from "./chunk-OZGU7P2S.mjs";
 import {
-  printCommandEnvelope
-} from "./chunk-F45425TB.mjs";
+  printCommandEnvelope,
+  renderCommandEnvelopeText
+} from "./chunk-EROOAI5G.mjs";
 import {
   resolveConfig,
   sdkCliStateDirPath
-} from "./chunk-CCRQ2VGJ.mjs";
+} from "./chunk-FK7PW6BP.mjs";
 
 // src/cli/search-ref.ts
 import { mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -36,6 +37,132 @@ function recentSearchRef() {
   }
 }
 
+// src/cli/text-table.ts
+import { getBorderCharacters, table } from "table";
+function formatTextTable(rows, columns) {
+  if (columns.length === 0) return "";
+  const data = [
+    columns.map((column) => column.header),
+    ...rows.map((row) => columns.map((column) => column.value(row)))
+  ];
+  return table(data, {
+    border: getBorderCharacters("void"),
+    drawHorizontalLine: () => false,
+    columnDefault: { paddingLeft: 0, paddingRight: 2 },
+    columns: columns.map((column, index) => ({
+      alignment: column.alignment ?? "left",
+      // table@6's word wrapper counts UTF-16 characters instead of display
+      // cells. Use its display-width-safe character wrapper for Unicode;
+      // unbounded identifiers never need wrapping in the first place.
+      wrapWord: column.width !== void 0 && data.every((row) => new RegExp("^\\p{ASCII}*$", "u").test(row[index])),
+      ...column.width === void 0 ? {} : { width: column.width }
+    }))
+  }).split("\n").map((line) => line.trimEnd()).join("\n").trimEnd();
+}
+
+// src/cli/search-output.ts
+function clipSummary(value) {
+  const characters = Array.from(value.replace(/\s+/gu, " ").trim());
+  return characters.length <= 78 ? characters.join("") : `${characters.slice(0, 77).join("")}\u2026`;
+}
+function pricingDisplay(item) {
+  const pricing = item.pricing;
+  if (!pricing)
+    return { cost: item.kind === "tool" ? "unknown" : "\u2014", notes: [] };
+  const range = pricing.estimatedRange;
+  if (range && item.billingSource !== "own_provider_credentials") {
+    return {
+      cost: `${range.minCreditsPerUnit}\u2013${range.maxCreditsPerUnit}/${pricing.unit} (estimate)`,
+      notes: [range.scope]
+    };
+  }
+  const observed = pricing.observedReference;
+  if (observed) {
+    return {
+      cost: `${observed.creditsPerCall}/call (observed)`,
+      notes: [
+        `Observed reference: ${observed.sampleSize} call(s), ${observed.observedAt}; ${observed.inputMode} Not a quote.`
+      ]
+    };
+  }
+  if (item.billingSource === "own_provider_credentials") {
+    return {
+      cost: "0 (own credentials)",
+      notes: ["Your provider quota still applies."]
+    };
+  }
+  const display = pricing.displayText ?? "";
+  const rate = display.match(
+    /^([\d.,]+) Deepline credits(?: \/ \$[\d.,]+)? per (call|result|page)( \(estimate\))?$/
+  );
+  if (rate)
+    return {
+      cost: `${rate[1]}/${rate[2]}${rate[3] ?? ""}${pricing.summary || pricing.details?.length ? "*" : ""}`,
+      notes: []
+    };
+  if (pricing.creditsPerUnit === 0 && /^Free\b/.test(display)) {
+    return { cost: "0 (free)", notes: [] };
+  }
+  if (!display || display === "Pricing unavailable.")
+    return { cost: "unknown", notes: [] };
+  return {
+    cost: pricing.unit === "usage" ? "usage-based" : "variable",
+    notes: display ? [clipSummary(display)] : []
+  };
+}
+function searchRow(item) {
+  const { cost, notes } = pricingDisplay(item);
+  if (item.credentialStatus === "requires_connection") {
+    notes.push("Requires your credentials \u2014 not connected (connect to use).");
+  } else if (item.connected === false && item.credentialStatus === "managed") {
+    notes.push("Temporarily unavailable.");
+  }
+  return {
+    id: item.id,
+    kind: item.kind,
+    cost,
+    summary: clipSummary(item.description ?? ""),
+    notes
+  };
+}
+function renderSearchResults(result) {
+  if (result.results.length === 0)
+    return renderCommandEnvelopeText(result);
+  const rows = result.results.map(searchRow);
+  const kinds = new Set(rows.map((row) => row.kind));
+  const onlyTools = kinds.size === 1 && kinds.has("tool");
+  const columns = [
+    { header: onlyTools ? "TOOL" : "ID", value: (row) => row.id },
+    ...!onlyTools ? [{ header: "KIND", value: (row) => row.kind }] : [],
+    { header: "CREDITS", value: (row) => row.cost, alignment: "right" },
+    { header: "SUMMARY", value: (row) => row.summary }
+  ];
+  const render = result.render;
+  const title = render?.sections?.[0]?.title ?? `${result.total ?? rows.length} matches \u2014 showing ${rows.length}`;
+  const remaining = {
+    sections: render?.sections?.slice(1),
+    actions: render?.actions
+  };
+  const followUps = remaining.sections?.length || remaining.actions?.length ? `
+${renderCommandEnvelopeText({ render: remaining })}` : "";
+  const notes = rows.flatMap(
+    (row) => row.notes.map((note) => `  ${row.id}: ${note}`)
+  );
+  const details = [
+    ...notes.length ? ["Notes", ...notes, ""] : [],
+    ...rows.some((row) => row.cost.endsWith("*")) ? [
+      "* Additional pricing conditions apply; see full pricing before execution."
+    ] : [],
+    "Full descriptions and pricing: deepline tools describe <toolId> or search --json."
+  ].join("\n");
+  return `${title}
+
+${formatTextTable(rows, columns)}
+
+${details}
+${followUps}`;
+}
+
 // src/cli/commands/search.ts
 var SEARCH_TYPES = [
   "tools",
@@ -112,7 +239,8 @@ async function runSearch(queryInput, options, types, exclude = []) {
   if (searchRef) rememberSearchRef(searchRef);
   pointAtDescribe(result);
   printCommandEnvelope(result, {
-    json: options.json === true
+    json: options.json === true,
+    text: renderSearchResults(result)
   });
   return 0;
 }
@@ -166,6 +294,8 @@ Notes:
   materially improves ranking, especially for short queries.
   Search prints a readable result list by default, piped or not, and that is
   the recommended form. Pass --json only when a program parses the result.
+  Readable prices are Deepline credits with a per-row unit. Estimates and
+  observed historical charges are labelled; usage-based prices are not quotes.
 
 Examples:
   deepline search "find work email"

package/dist/cli/{chunk-MOP6D7Z5.js → chunk-4FLEXYUC.js}

@@ -1,20 +1,21 @@
 "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 _chunk4ZARCCPTjs = require('./chunk-4ZARCCPT.js');
+var _chunkGY2EEO2Yjs = require('./chunk-GY2EEO2Y.js');
 
 
-var _chunkUROXKPNDjs = require('./chunk-UROXKPND.js');
 
+var _chunkU2N4CYT7js = require('./chunk-U2N4CYT7.js');
 
 
-var _chunkDM3SHV6Ujs = require('./chunk-DM3SHV6U.js');
+
+var _chunkVDIHLKGGjs = require('./chunk-VDIHLKGG.js');
 
 // src/cli/search-ref.ts
 var _fs = require('fs');
 var _path = require('path');
 var SEARCH_REF_TTL_MS = 15 * 6e4;
 function lastSearchPath() {
-  return _path.join.call(void 0, _chunkDM3SHV6Ujs.sdkCliStateDirPath.call(void 0, _chunkDM3SHV6Ujs.resolveConfig.call(void 0, ).baseUrl), "last-search.json");
+  return _path.join.call(void 0, _chunkVDIHLKGGjs.sdkCliStateDirPath.call(void 0, _chunkVDIHLKGGjs.resolveConfig.call(void 0, ).baseUrl), "last-search.json");
 }
 function rememberSearchRef(searchRef) {
   try {
@@ -36,6 +37,132 @@ function recentSearchRef() {
   }
 }
 
+// src/cli/text-table.ts
+var _table = require('table');
+function formatTextTable(rows, columns) {
+  if (columns.length === 0) return "";
+  const data = [
+    columns.map((column) => column.header),
+    ...rows.map((row) => columns.map((column) => column.value(row)))
+  ];
+  return _table.table.call(void 0, data, {
+    border: _table.getBorderCharacters.call(void 0, "void"),
+    drawHorizontalLine: () => false,
+    columnDefault: { paddingLeft: 0, paddingRight: 2 },
+    columns: columns.map((column, index) => ({
+      alignment: _nullishCoalesce(column.alignment, () => ( "left")),
+      // table@6's word wrapper counts UTF-16 characters instead of display
+      // cells. Use its display-width-safe character wrapper for Unicode;
+      // unbounded identifiers never need wrapping in the first place.
+      wrapWord: column.width !== void 0 && data.every((row) => new RegExp("^\\p{ASCII}*$", "u").test(row[index])),
+      ...column.width === void 0 ? {} : { width: column.width }
+    }))
+  }).split("\n").map((line) => line.trimEnd()).join("\n").trimEnd();
+}
+
+// src/cli/search-output.ts
+function clipSummary(value) {
+  const characters = Array.from(value.replace(/\s+/gu, " ").trim());
+  return characters.length <= 78 ? characters.join("") : `${characters.slice(0, 77).join("")}\u2026`;
+}
+function pricingDisplay(item) {
+  const pricing = item.pricing;
+  if (!pricing)
+    return { cost: item.kind === "tool" ? "unknown" : "\u2014", notes: [] };
+  const range = pricing.estimatedRange;
+  if (range && item.billingSource !== "own_provider_credentials") {
+    return {
+      cost: `${range.minCreditsPerUnit}\u2013${range.maxCreditsPerUnit}/${pricing.unit} (estimate)`,
+      notes: [range.scope]
+    };
+  }
+  const observed = pricing.observedReference;
+  if (observed) {
+    return {
+      cost: `${observed.creditsPerCall}/call (observed)`,
+      notes: [
+        `Observed reference: ${observed.sampleSize} call(s), ${observed.observedAt}; ${observed.inputMode} Not a quote.`
+      ]
+    };
+  }
+  if (item.billingSource === "own_provider_credentials") {
+    return {
+      cost: "0 (own credentials)",
+      notes: ["Your provider quota still applies."]
+    };
+  }
+  const display = _nullishCoalesce(pricing.displayText, () => ( ""));
+  const rate = display.match(
+    /^([\d.,]+) Deepline credits(?: \/ \$[\d.,]+)? per (call|result|page)( \(estimate\))?$/
+  );
+  if (rate)
+    return {
+      cost: `${rate[1]}/${rate[2]}${_nullishCoalesce(rate[3], () => ( ""))}${pricing.summary || _optionalChain([pricing, 'access', _ => _.details, 'optionalAccess', _2 => _2.length]) ? "*" : ""}`,
+      notes: []
+    };
+  if (pricing.creditsPerUnit === 0 && /^Free\b/.test(display)) {
+    return { cost: "0 (free)", notes: [] };
+  }
+  if (!display || display === "Pricing unavailable.")
+    return { cost: "unknown", notes: [] };
+  return {
+    cost: pricing.unit === "usage" ? "usage-based" : "variable",
+    notes: display ? [clipSummary(display)] : []
+  };
+}
+function searchRow(item) {
+  const { cost, notes } = pricingDisplay(item);
+  if (item.credentialStatus === "requires_connection") {
+    notes.push("Requires your credentials \u2014 not connected (connect to use).");
+  } else if (item.connected === false && item.credentialStatus === "managed") {
+    notes.push("Temporarily unavailable.");
+  }
+  return {
+    id: item.id,
+    kind: item.kind,
+    cost,
+    summary: clipSummary(_nullishCoalesce(item.description, () => ( ""))),
+    notes
+  };
+}
+function renderSearchResults(result) {
+  if (result.results.length === 0)
+    return _chunkU2N4CYT7js.renderCommandEnvelopeText.call(void 0, result);
+  const rows = result.results.map(searchRow);
+  const kinds = new Set(rows.map((row) => row.kind));
+  const onlyTools = kinds.size === 1 && kinds.has("tool");
+  const columns = [
+    { header: onlyTools ? "TOOL" : "ID", value: (row) => row.id },
+    ...!onlyTools ? [{ header: "KIND", value: (row) => row.kind }] : [],
+    { header: "CREDITS", value: (row) => row.cost, alignment: "right" },
+    { header: "SUMMARY", value: (row) => row.summary }
+  ];
+  const render = result.render;
+  const title = _nullishCoalesce(_optionalChain([render, 'optionalAccess', _3 => _3.sections, 'optionalAccess', _4 => _4[0], 'optionalAccess', _5 => _5.title]), () => ( `${_nullishCoalesce(result.total, () => ( rows.length))} matches \u2014 showing ${rows.length}`));
+  const remaining = {
+    sections: _optionalChain([render, 'optionalAccess', _6 => _6.sections, 'optionalAccess', _7 => _7.slice, 'call', _8 => _8(1)]),
+    actions: _optionalChain([render, 'optionalAccess', _9 => _9.actions])
+  };
+  const followUps = _optionalChain([remaining, 'access', _10 => _10.sections, 'optionalAccess', _11 => _11.length]) || _optionalChain([remaining, 'access', _12 => _12.actions, 'optionalAccess', _13 => _13.length]) ? `
+${_chunkU2N4CYT7js.renderCommandEnvelopeText.call(void 0, { render: remaining })}` : "";
+  const notes = rows.flatMap(
+    (row) => row.notes.map((note) => `  ${row.id}: ${note}`)
+  );
+  const details = [
+    ...notes.length ? ["Notes", ...notes, ""] : [],
+    ...rows.some((row) => row.cost.endsWith("*")) ? [
+      "* Additional pricing conditions apply; see full pricing before execution."
+    ] : [],
+    "Full descriptions and pricing: deepline tools describe <toolId> or search --json."
+  ].join("\n");
+  return `${title}
+
+${formatTextTable(rows, columns)}
+
+${details}
+${followUps}`;
+}
+
 // src/cli/commands/search.ts
 var SEARCH_TYPES = [
   "tools",
@@ -78,8 +205,8 @@ function addSearchOptions(command) {
 function pointAtDescribe(result) {
   const old = /`deepline (tools|plays) describe [^`]*`/;
   const render = result.render;
-  for (const section of _nullishCoalesce(_optionalChain([render, 'optionalAccess', _ => _.sections]), () => ( []))) {
-    if (!_optionalChain([section, 'access', _2 => _2.lines, 'optionalAccess', _3 => _3.some, 'call', _4 => _4((line) => old.test(line))])) continue;
+  for (const section of _nullishCoalesce(_optionalChain([render, 'optionalAccess', _14 => _14.sections]), () => ( []))) {
+    if (!_optionalChain([section, 'access', _15 => _15.lines, 'optionalAccess', _16 => _16.some, 'call', _17 => _17((line) => old.test(line))])) continue;
     section.lines = [
       "Run `deepline describe <id>` before executing a tool or running a play.",
       ...section.lines.filter((line) => !old.test(line))
@@ -91,13 +218,13 @@ function pointAtDescribe(result) {
   }
 }
 async function runSearch(queryInput, options, types, exclude = []) {
-  const query = _nullishCoalesce(_optionalChain([queryInput, 'optionalAccess', _5 => _5.trim, 'call', _6 => _6()]), () => ( ""));
+  const query = _nullishCoalesce(_optionalChain([queryInput, 'optionalAccess', _18 => _18.trim, 'call', _19 => _19()]), () => ( ""));
   const searchTerms = _nullishCoalesce(options.searchTerms, () => ( options.search_terms));
-  if (!query && !_optionalChain([options, 'access', _7 => _7.categories, 'optionalAccess', _8 => _8.trim, 'call', _9 => _9()]) && !_optionalChain([searchTerms, 'optionalAccess', _10 => _10.trim, 'call', _11 => _11()])) {
+  if (!query && !_optionalChain([options, 'access', _20 => _20.categories, 'optionalAccess', _21 => _21.trim, 'call', _22 => _22()]) && !_optionalChain([searchTerms, 'optionalAccess', _23 => _23.trim, 'call', _24 => _24()])) {
     console.error(USAGE);
     return 1;
   }
-  const { search_ref: searchRef, ...result } = await new (0, _chunk4ZARCCPTjs.DeeplineClient)().search({
+  const { search_ref: searchRef, ...result } = await new (0, _chunkGY2EEO2Yjs.DeeplineClient)().search({
     query,
     types,
     exclude,
@@ -111,8 +238,9 @@ async function runSearch(queryInput, options, types, exclude = []) {
   });
   if (searchRef) rememberSearchRef(searchRef);
   pointAtDescribe(result);
-  _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, result, {
-    json: options.json === true
+  _chunkU2N4CYT7js.printCommandEnvelope.call(void 0, result, {
+    json: options.json === true,
+    text: renderSearchResults(result)
   });
   return 0;
 }
@@ -166,6 +294,8 @@ Notes:
   materially improves ranking, especially for short queries.
   Search prints a readable result list by default, piped or not, and that is
   the recommended form. Pass --json only when a program parses the result.
+  Readable prices are Deepline credits with a per-row unit. Estimates and
+  observed historical charges are labelled; usage-based prices are not quotes.
 
 Examples:
   deepline search "find work email"

package/dist/cli/{chunk-DSDX6EUW.js → chunk-75ZOTF3K.js}

@@ -1,17 +1,17 @@
 "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 _chunk7RCJDAJXjs = require('./chunk-7RCJDAJX.js');
+var _chunkKHZQFFOQjs = require('./chunk-KHZQFFOQ.js');
 
 
 
-var _chunkCISKBOXDjs = require('./chunk-CISKBOXD.js');
+var _chunkJ2E5R2VHjs = require('./chunk-J2E5R2VH.js');
 
 
-var _chunkUROXKPNDjs = require('./chunk-UROXKPND.js');
+var _chunkU2N4CYT7js = require('./chunk-U2N4CYT7.js');
 
 
-var _chunkDM3SHV6Ujs = require('./chunk-DM3SHV6U.js');
+var _chunkVDIHLKGGjs = require('./chunk-VDIHLKGG.js');
 
 // src/cli/commands/update.ts
 var _child_process = require('child_process');
@@ -489,7 +489,7 @@ function normalizedNpmPrefix(value) {
 }
 function resolveNpmGlobalPrefix(env) {
   try {
-    const plan = _chunkCISKBOXDjs.resolveShellSpawn.call(void 0, "npm", ["prefix", "-g"], process.platform, env);
+    const plan = _chunkJ2E5R2VHjs.resolveShellSpawn.call(void 0, "npm", ["prefix", "-g"], process.platform, env);
     const result = _child_process.spawnSync.call(void 0, plan.command, plan.args, {
       encoding: "utf8",
       env,
@@ -545,8 +545,8 @@ function resolveUpdatePlan(options = {}) {
   const npmGlobalPrefix = options.npmGlobalPrefix !== void 0 ? options.npmGlobalPrefix : resolveNpmGlobalPrefix(env);
   const hasVerifiedNpmOwnership = inferredInstallPrefix !== null && normalizedNpmPrefix(inferredInstallPrefix) === normalizedNpmPrefix(npmGlobalPrefix);
   const installPrefix = options.requireVerifiedNpmOwnership ? hasVerifiedNpmOwnership ? inferredInstallPrefix : null : inferredInstallPrefix;
-  const npmVersion = options.npmVersion === void 0 ? _chunk7RCJDAJXjs.readNpmVersion.call(void 0, env) : options.npmVersion;
-  const npmGlobalInstallFlags = _chunk7RCJDAJXjs.npmSupportsAllowScripts.call(void 0, npmVersion) ? [...NPM_SDK_INSTALL_COMMON_FLAGS, "--allow-scripts=esbuild"] : NPM_SDK_INSTALL_COMMON_FLAGS;
+  const npmVersion = options.npmVersion === void 0 ? _chunkKHZQFFOQjs.readNpmVersion.call(void 0, env) : options.npmVersion;
+  const npmGlobalInstallFlags = _chunkKHZQFFOQjs.npmSupportsAllowScripts.call(void 0, npmVersion) ? [...NPM_SDK_INSTALL_COMMON_FLAGS, "--allow-scripts=esbuild"] : NPM_SDK_INSTALL_COMMON_FLAGS;
   const args = installPrefix ? [
     "install",
     "-g",
@@ -556,7 +556,7 @@ function resolveUpdatePlan(options = {}) {
     packageSpec
   ] : ["install", "-g", ...npmGlobalInstallFlags, packageSpec];
   const fallbackRegistryUrl = options.npmFallbackRegistryUrl !== void 0 ? options.npmFallbackRegistryUrl : publicNpmFallbackRegistryUrl(
-    _optionalChain([env, 'access', _18 => _18.DEEPLINE_HOST_URL, 'optionalAccess', _19 => _19.trim, 'call', _20 => _20()]) || _chunkDM3SHV6Ujs.autoDetectBaseUrl.call(void 0, )
+    _optionalChain([env, 'access', _18 => _18.DEEPLINE_HOST_URL, 'optionalAccess', _19 => _19.trim, 'call', _20 => _20()]) || _chunkVDIHLKGGjs.autoDetectBaseUrl.call(void 0, )
   );
   return {
     kind: "npm-global",
@@ -703,7 +703,7 @@ function sidecarInstallFailure(versionDir) {
 function runCommand(command, args, env = process.env) {
   return new Promise((resolveResult) => {
     let output = "";
-    const plan = _chunkCISKBOXDjs.resolveShellSpawn.call(void 0, command, args, process.platform, env);
+    const plan = _chunkJ2E5R2VHjs.resolveShellSpawn.call(void 0, command, args, process.platform, env);
     const child = _child_process.spawn.call(void 0, plan.command, plan.args, {
       stdio: ["inherit", "pipe", "pipe"],
       shell: plan.shell,
@@ -1079,14 +1079,14 @@ async function publishedVersionSupportsPin(version, fallbackRegistryUrl) {
   throw _nullishCoalesce(lastError, () => ( new Error("No npm registry was available")));
 }
 async function runUpdateCommand(options, dependencies = {}) {
-  const detectBaseUrl = _nullishCoalesce(dependencies.detectBaseUrl, () => ( _chunkDM3SHV6Ujs.autoDetectBaseUrl));
+  const detectBaseUrl = _nullishCoalesce(dependencies.detectBaseUrl, () => ( _chunkVDIHLKGGjs.autoDetectBaseUrl));
   const resolvePlan = _nullishCoalesce(dependencies.resolvePlan, () => ( resolveUpdatePlan));
   const runPlan = _nullishCoalesce(dependencies.runPlan, () => ( runUpdatePlan));
   const syncSkills = _nullishCoalesce(dependencies.syncSkillsIfNeeded, () => ( (async () => {
     const originalWrite = process.stdout.write.bind(process.stdout);
     process.stdout.write = (() => true);
     try {
-      const exitCode = await _chunkCISKBOXDjs.runSkillsCommand.call(void 0, { json: true });
+      const exitCode = await _chunkJ2E5R2VHjs.runSkillsCommand.call(void 0, { json: true });
       if (exitCode !== 0) {
         throw new Error(
           `Deepline skills update failed with exit ${exitCode}.`
@@ -1157,11 +1157,11 @@ async function runUpdateCommand(options, dependencies = {}) {
     ]
   };
   if (options.json && !options.executeWithJson) {
-    _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, { ...plan, render }, { json: true });
+    _chunkU2N4CYT7js.printCommandEnvelope.call(void 0, { ...plan, render }, { json: true });
     return 0;
   }
   if (options.printCommand) {
-    _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
+    _chunkU2N4CYT7js.printCommandEnvelope.call(void 0, 
       {
         ...plan,
         render: {
@@ -1174,7 +1174,7 @@ async function runUpdateCommand(options, dependencies = {}) {
     return 0;
   }
   if (plan.kind === "source" || plan.kind === "homebrew") {
-    _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, { ...plan, render }, { json: false });
+    _chunkU2N4CYT7js.printCommandEnvelope.call(void 0, { ...plan, render }, { json: false });
     return 0;
   }
   stderr.write(`Updating Deepline SDK/CLI with: ${plan.manualCommand}
@@ -1204,7 +1204,7 @@ To retry with full installer output, run: deepline skills --json
     );
   }
   if (options.executeWithJson && options.json) {
-    _chunkUROXKPNDjs.printCommandEnvelope.call(void 0, 
+    _chunkU2N4CYT7js.printCommandEnvelope.call(void 0, 
       {
         ok: true,
         pinnedVersion

package/dist/cli/{chunk-ZOFARJWH.mjs → chunk-7T6DX5RK.mjs}

@@ -10,11 +10,11 @@ import {
 } from "./chunk-EDWJY6T4.mjs";
 import {
   registerDeprecatedSearchCommand
-} from "./chunk-D6GD5AVN.mjs";
+} from "./chunk-3RZJ3GEG.mjs";
 import {
   handleDeploymentGet,
   handleDeploymentsList
-} from "./chunk-REP2MYBI.mjs";
+} from "./chunk-ERU2OR6F.mjs";
 import {
   PLAY_BOOTSTRAP_COMPANY_PROVIDER_CATEGORY,
   PLAY_BOOTSTRAP_OUTPUT_FIELD_BY_FINDER,
@@ -39,7 +39,7 @@ import {
   normalizeRunEventOperationRequest,
   parseLogLevel,
   playInputExampleArgs
-} from "./chunk-QZAP5VOS.mjs";
+} from "./chunk-OZGU7P2S.mjs";
 import {
   CSV_DATA_INPUT_KEY,
   buildNamedPlayRunRequest,
@@ -71,10 +71,10 @@ import {
   printJson,
   printJsonError,
   renderCommandEnvelopeText
-} from "./chunk-F45425TB.mjs";
+} from "./chunk-EROOAI5G.mjs";
 import {
   fetchWithDeploymentProtection
-} from "./chunk-CCRQ2VGJ.mjs";
+} from "./chunk-FK7PW6BP.mjs";
 import {
   PLAY_DEFAULT_EXPORT,
   extractDefinedPlayName,
@@ -82,7 +82,7 @@ import {
   listPlayFileExports,
   parsePlaySourceForAnalysis,
   resolveEnabledExecutionProfile
-} from "./chunk-YIY74KUF.mjs";
+} from "./chunk-EV4QJE4J.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";
@@ -5180,10 +5180,13 @@ function generateProviderSourceBlock(input) {
     input: ${inputName},
     description: ${jsString(`Seed ${input.entity} rows from ${input.provider}.`)},
   });
-  // extractedLists.${getter}.get() returns a dataset handle of provider-shaped rows. Do not assume canonical fields;
+  // extractedLists.${getter}.get() returns provider-shaped rows. Do not assume canonical fields;
   // inspect source_${input.index}.extractedLists.${getter}.keys or the provider output schema, then map explicitly below.
-  const sourceRowsDataset_${input.index} = ${accessorExpression(`source_${input.index}.extractedLists`, getter)}.get();
-  const sourceRows_${input.index} = (await sourceRowsDataset_${input.index}.peek(limit)) as ${input.collectionType}[];`;
+  const sourceList_${input.index} = ${accessorExpression(`source_${input.index}.extractedLists`, getter)}.get();
+  // Legacy admitted Plays use a dataset getter; the new contract returns an ordinary array.
+  const sourceRows_${input.index} = (Array.isArray(sourceList_${input.index})
+    ? sourceList_${input.index}.slice(0, limit)
+    : await sourceList_${input.index}.peek(limit)) as ${input.collectionType}[];`;
 }
 function generateProviderSourceRowsBlock(input) {
   const blocks = input.source.values.map(
@@ -15675,13 +15678,14 @@ Active runs: ${next.running}`
     ...offset !== void 0 ? { offset } : {}
   });
   const runs = page.runs.map((run) => ({
+    id: run.workflowId,
     runId: run.workflowId,
     // `workflowId` is the legacy SDK name for the same public Deepline run
     // identity. Keep it during the compatibility window, but never label the
     // duplicate as a Temporal/runtime id.
     workflowId: run.workflowId,
     // Retain the runtime identifier for existing JSON consumers. It is not a
-    // stable Deepline run id; `runId` above is the canonical public id.
+    // stable Deepline run id; `id` above is the canonical public id.
     temporalRunId: run.runId ?? null,
     parentRunId: run.parentRunId ?? null,
     rootRunId: run.rootRunId ?? null,
@@ -15702,12 +15706,12 @@ Active runs: ${next.running}`
     playName ? `No runs found for ${playName}.` : `No runs found for status ${statusFilter}.`
   ] : runs.map((run) => {
     const lines2 = [
-      `${run.runId} ${run.status}`,
+      `${run.id} ${run.status}`,
       `  created: ${formatTimestamp(run.createdAt)}`,
       `  started: ${formatTimestamp(run.startedAt)}`,
       `  finished: ${formatTimestamp(run.finishedAt)}`,
       `  credits: ${typeof run.billingTotalCredits === "number" && Number.isFinite(run.billingTotalCredits) ? formatCreditAmount2(run.billingTotalCredits) : "\u2014"}`,
-      `  inspect: deepline runs get ${run.runId} --json`
+      `  inspect: deepline runs get ${run.id} --json`
     ];
     if (run.parentRunId) lines2.push(`  parent: ${run.parentRunId}`);
     if (run.rootRunId) lines2.push(`  root: ${run.rootRunId}`);
@@ -15744,7 +15748,7 @@ Active runs: ${next.running}`
       ...page.hasMore !== void 0 ? { has_more: page.hasMore, is_truncated: page.hasMore } : {},
       next: {
         page: nextPage,
-        get: runs[0]?.runId ? `deepline runs get ${runs[0].runId} --json` : null
+        get: runs[0]?.id ? `deepline runs get ${runs[0].id} --json` : null
       },
       render: { sections: [{ title: "runs", lines }] }
     },
@@ -18146,7 +18150,7 @@ Examples:
         process.exitCode = await ownView();
         return;
       }
-      const { describeAnything } = await import("./describe-KJWOHMKC.mjs");
+      const { describeAnything } = await import("./describe-XWOWAR32.mjs");
       process.exitCode = await describeAnything(
         name,
         {
@@ -18494,6 +18498,9 @@ Notes:
   Use the exact qualified Play reference, such as workspace/my-play or prebuilt/my-play.
   --offset requires --play; narrow status-only lists with a Play reference to paginate.
   Common statuses include running, completed, failed, and stopped.
+  JSON runs[].id is the public ID accepted by runs get, watch, export, and stop.
+  runId and workflowId are compatibility aliases; temporalRunId is not the public ID.
+  Use the ID returned by plays run for your execution, not the latest inventory entry.
 
 Examples:
   deepline runs list --play my-play

package/dist/cli/{chunk-3MXRNPBN.js → chunk-AD23W4S5.js}

@@ -49,7 +49,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.327",
+  version: "0.3.329",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/cli/{chunk-F45425TB.mjs → chunk-EROOAI5G.mjs}

@@ -3,7 +3,7 @@ import {
   detectAgentRuntime,
   resolveCliCommandContext,
   resolveConfig
-} from "./chunk-CCRQ2VGJ.mjs";
+} from "./chunk-FK7PW6BP.mjs";
 import {
   DeeplineError
 } from "./chunk-NXGCO4JB.mjs";

package/dist/cli/{chunk-REP2MYBI.mjs → chunk-ERU2OR6F.mjs}

@@ -2,10 +2,10 @@ import {
   getAuthedHttpClient,
   openInBrowser,
   printCommandEnvelope
-} from "./chunk-F45425TB.mjs";
+} from "./chunk-EROOAI5G.mjs";
 import {
   resolveBaseUrlOnly
-} from "./chunk-CCRQ2VGJ.mjs";
+} from "./chunk-FK7PW6BP.mjs";
 
 // src/cli/commands/git.ts
 function shellQuote(value) {

package/dist/cli/{chunk-YIY74KUF.mjs → chunk-EV4QJE4J.mjs}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-H7HIDGZ7.mjs";
 import {
   PLAY_AUTHORING_CONTRACT_EDITION
-} from "./chunk-KP7W5NO6.mjs";
+} from "./chunk-NTVTZAVZ.mjs";
 import {
   PLAY_ARTIFACT_KINDS,
   PLAY_RUNTIME_BACKENDS,

package/dist/cli/{chunk-CCRQ2VGJ.mjs → chunk-FK7PW6BP.mjs}

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