deepline 0.1.163 → 0.1.165

package/dist/cli/index.js

@@ -622,10 +622,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.163",
+  version: "0.1.165",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.163",
+    latest: "0.1.165",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -5421,6 +5421,7 @@ async function handleUsage(options) {
   const params = new URLSearchParams();
   if (options.limit) params.set("recent_limit", options.limit);
   if (options.offset) params.set("recent_offset", options.offset);
+  if (options.runId) params.set("run_id", options.runId);
   const suffix = Array.from(params).length > 0 ? `?${params.toString()}` : "";
   const payload = await http.get(
     `/api/v2/billing/usage${suffix}`
@@ -5973,8 +5974,9 @@ Notes:
 Examples:
   deepline billing usage
   deepline billing usage --limit 50 --offset 50 --json
+  deepline billing usage --run-id play/example/run/20260630t120000-000-abcdef --json
 `
-  ).option("--limit <n>", "Recent-call page size").option("--offset <n>", "Recent-call offset").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleUsage);
+  ).option("--limit <n>", "Recent-call page size").option("--offset <n>", "Recent-call offset").option("--run-id <run_id>", "Show recent usage for one play run").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(handleUsage);
   billing.command("limit").description("Show configured monthly limit state.").addHelpText(
     "after",
     `
@@ -16830,6 +16832,8 @@ var ENRICH_EXPORT_BACKING_ROWS_WAIT_MS = 6e4;
 var ENRICH_EXPORT_BACKING_ROWS_POLL_MS = 1e3;
 var ENRICH_SOURCE_ROW_INDEX_COLUMN = "__deeplineSourceRowIndex";
 var ENRICH_ORIGINAL_SOURCE_ROW_INDEX_COLUMN = "__deeplineOriginalSourceRowIndex";
+var ENRICH_CELL_META_FIELD = "__deeplineCellMeta";
+var ENRICH_CELL_META_PATCH_FIELD = "__deeplineCellMetaPatch";
 var EXIT_SERVER2 = 5;
 var ENRICH_DEBUG_T0 = Date.now();
 var GENERATED_ENRICH_ROWS_TABLE_NAMESPACE = "deepline_enrich_rows";
@@ -17902,6 +17906,18 @@ function exportableSheetRow2(row, sourceRowStart = 0) {
   const data = record.data;
   if (data && typeof data === "object" && !Array.isArray(data)) {
     const exported = { ...data };
+    applyFailureCellMeta(exported, exported[ENRICH_CELL_META_FIELD], {
+      rowError: record.error
+    });
+    applyFailureCellMeta(exported, record.cellMeta, { rowError: record.error });
+    applyFailureCellMeta(exported, record.cellMetaPatch, {
+      rowError: record.error
+    });
+    applyFailureCellMeta(exported, record[ENRICH_CELL_META_PATCH_FIELD], {
+      rowError: record.error
+    });
+    delete exported[ENRICH_CELL_META_FIELD];
+    delete exported[ENRICH_CELL_META_PATCH_FIELD];
     const inputIndex = typeof record.inputIndex === "number" ? record.inputIndex : typeof record.inputIndex === "string" && record.inputIndex.trim() ? Number(record.inputIndex) : Number.NaN;
     if (Number.isInteger(inputIndex) && inputIndex >= 0) {
       if (ENRICH_SOURCE_ROW_INDEX_COLUMN in exported) {
@@ -17912,6 +17928,18 @@ function exportableSheetRow2(row, sourceRowStart = 0) {
     return exported;
   }
   const fallback = { ...record };
+  applyFailureCellMeta(fallback, fallback[ENRICH_CELL_META_FIELD], {
+    rowError: record.error
+  });
+  applyFailureCellMeta(fallback, record.cellMeta, {
+    rowError: record.error
+  });
+  applyFailureCellMeta(fallback, record.cellMetaPatch, {
+    rowError: record.error
+  });
+  applyFailureCellMeta(fallback, fallback[ENRICH_CELL_META_PATCH_FIELD], {
+    rowError: record.error
+  });
   for (const key of [
     "key",
     "status",
@@ -17919,6 +17947,8 @@ function exportableSheetRow2(row, sourceRowStart = 0) {
     "inputIndex",
     "runId",
     "error",
+    ENRICH_CELL_META_FIELD,
+    ENRICH_CELL_META_PATCH_FIELD,
     "stage",
     "provider",
     "seq",
@@ -17929,6 +17959,45 @@ function exportableSheetRow2(row, sourceRowStart = 0) {
   }
   return fallback;
 }
+function failureCellFromMeta(meta, fallback) {
+  if (!isRecord7(meta)) {
+    return null;
+  }
+  const status = typeof meta.status === "string" ? meta.status.trim().toLowerCase() : "";
+  const hasFailureStatus = status === "failed" || status === "error";
+  const explicitError = typeof meta.error === "string" && meta.error.trim() ? meta.error.trim() : typeof meta.last_error === "string" && meta.last_error.trim() ? meta.last_error.trim() : typeof meta.message === "string" && meta.message.trim() ? meta.message.trim() : "";
+  if (!hasFailureStatus && !explicitError) {
+    return null;
+  }
+  const fallbackError = hasFailureStatus && typeof fallback.rowError === "string" && fallback.rowError.trim() ? fallback.rowError.trim() : "";
+  const error = explicitError || fallbackError;
+  const message = error || `Column status: ${status || "failed"}`;
+  return {
+    status: status || "failed",
+    error: message,
+    ...typeof meta.operation === "string" && meta.operation.trim() ? { operation: meta.operation.trim() } : {},
+    ...typeof meta.provider === "string" && meta.provider.trim() ? { provider: meta.provider.trim() } : {}
+  };
+}
+function applyFailureCellMeta(row, cellMeta, fallback) {
+  if (!isRecord7(cellMeta)) {
+    return;
+  }
+  for (const [field, meta] of Object.entries(cellMeta)) {
+    if (!field || field.startsWith("__")) {
+      continue;
+    }
+    const failure = failureCellFromMeta(meta, fallback);
+    if (!failure) {
+      continue;
+    }
+    const existing = row[field];
+    if (isNonEmptyCsvCell(existing) && !cellFailureError(existing)) {
+      continue;
+    }
+    row[field] = failure;
+  }
+}
 function mergeExportedSheetRow(target, next) {
   const baseMetadata = target._metadata;
   const nextMetadata = next._metadata;
@@ -17990,7 +18059,7 @@ function stripEnrichSourceRowIndex(row) {
   }
   return stripped;
 }
-function collectHardFailureAliases(config) {
+function collectHardFailureAliasSpecs(config) {
   const aliases = [];
   const seen = /* @__PURE__ */ new Set();
   for (const command of config.commands) {
@@ -18005,10 +18074,25 @@ function collectHardFailureAliases(config) {
       continue;
     }
     seen.add(alias);
-    aliases.push(alias);
+    aliases.push({
+      alias,
+      operation: command.operation?.trim() || command.tool.trim() || void 0
+    });
   }
   return aliases;
 }
+function hardFailureOperationByAlias(config) {
+  const operations = /* @__PURE__ */ new Map();
+  if (!config) {
+    return operations;
+  }
+  for (const spec of collectHardFailureAliasSpecs(config)) {
+    if (spec.operation) {
+      operations.set(normalizeAlias2(spec.alias), spec.operation);
+    }
+  }
+  return operations;
+}
 function cellFailureError(value) {
   const parsed = parseMaybeJsonObject(value);
   if (!isRecord7(parsed)) {
@@ -18118,14 +18202,15 @@ function aliasFlattenedCells(row, alias) {
   return cells;
 }
 function collectEnrichFailureJobs(input2) {
-  const aliases = collectHardFailureAliases(input2.config);
+  const aliases = collectHardFailureAliasSpecs(input2.config);
   if (aliases.length === 0 || input2.rows.length === 0) {
     return [];
   }
   const rowOffset = input2.rowStart ?? 0;
   const jobs = [];
   input2.rows.forEach((row, rowIndex) => {
-    aliases.forEach((alias, aliasIndex) => {
+    aliases.forEach((spec, aliasIndex) => {
+      const { alias } = spec;
       const failure = aliasFailureCellCandidates(row, alias).map(cellFailureError).find(
         (candidate) => Boolean(candidate)
       );
@@ -18133,15 +18218,20 @@ function collectEnrichFailureJobs(input2) {
         return;
       }
       const rowId = sourceRowIndexFromEnrichRow(row, 0, Number.MAX_SAFE_INTEGER) ?? rowOffset + rowIndex;
+      const operation = failure.operation ?? spec.operation;
+      const message = enrichFailureMessageWithOperation(
+        failure.message,
+        operation
+      );
       jobs.push({
         job_id: `row-${rowId}-${alias}`,
         row_id: rowId,
         col_index: aliasIndex,
         column: alias,
         status: "failed",
-        last_error: failure.message,
-        error: failure.message,
-        ...failure.operation ? { operation: failure.operation } : {},
+        last_error: message,
+        error: message,
+        ...operation ? { operation } : {},
         ...failure.provider ? { provider: failure.provider } : {}
       });
     });
@@ -18149,7 +18239,7 @@ function collectEnrichFailureJobs(input2) {
   return jobs;
 }
 function collectStatusFailureJobs(input2) {
-  const aliases = collectHardFailureAliases(input2.config);
+  const aliases = collectHardFailureAliasSpecs(input2.config);
   if (aliases.length === 0) {
     return [];
   }
@@ -18157,7 +18247,8 @@ function collectStatusFailureJobs(input2) {
   const rowStart = input2.rowRange.rowStart ?? 0;
   const selectedRows = input2.rowRange.rowEnd !== null && input2.rowRange.rowEnd >= rowStart ? input2.rowRange.rowEnd - rowStart + 1 : Number.MAX_SAFE_INTEGER;
   const jobs = [];
-  aliases.forEach((alias, aliasIndex) => {
+  aliases.forEach((spec, aliasIndex) => {
+    const { alias } = spec;
     const stat2 = summaries.map((summary) => summary[alias]).find(isRecord7);
     if (!stat2) {
       return;
@@ -18174,7 +18265,12 @@ function collectStatusFailureJobs(input2) {
     if (!Number.isFinite(failedCount) || failedCount <= 0) {
       return;
     }
-    const message = firstCollectedStringField(stat2, "error") ?? firstCollectedStringField(stat2, "message") ?? `Column ${alias} failed for ${failedCount} row(s).`;
+    const message = statusFailureMessage({
+      stat: stat2,
+      alias,
+      failedCount,
+      operation: spec.operation
+    });
     for (let offset = 0; offset < failedCount; offset += 1) {
       const rowId = rowStart + offset;
       jobs.push({
@@ -18190,6 +18286,26 @@ function collectStatusFailureJobs(input2) {
   });
   return jobs;
 }
+function statusFailureMessage(input2) {
+  const raw = firstCollectedStringField(input2.stat, "error") ?? firstCollectedStringField(input2.stat, "message");
+  if (!raw) {
+    return `Column ${input2.alias} failed for ${input2.failedCount} row(s).`;
+  }
+  return enrichFailureMessageWithOperation(raw, input2.operation);
+}
+function enrichFailureMessageWithOperation(message, operation) {
+  const raw = message.trim();
+  const marker = operation?.trim();
+  if (!marker || raw.includes(marker)) {
+    return raw;
+  }
+  if (/^(?:[A-Za-z0-9_:-]+:\s*)?(?:Error|TypeError|ReferenceError|SyntaxError|RangeError):\s+/.test(
+    raw
+  )) {
+    return `${marker}: ${raw}`;
+  }
+  return `${marker}: Error: ${raw}`;
+}
 function collectCompleteStatusFailureMessages(input2) {
   const requiredCount = Math.max(1, Math.trunc(input2.rowCount));
   const jobs = collectStatusFailureJobs({
@@ -18756,6 +18872,7 @@ function materializeAliasSuccessCell(row, alias) {
 }
 function normalizeEnrichRowsForCsvExport(rows, config, options) {
   const aliases = config ? collectConfigScalarAliasOrder(config) : [];
+  const failureOperationByAlias = hardFailureOperationByAlias(config);
   return rows.map((row) => {
     const metadata = legacyMetadataFromRow(row);
     const normalized = metadata ? { ...row, _metadata: metadata } : { ...row };
@@ -18790,7 +18907,10 @@ function normalizeEnrichRowsForCsvExport(rows, config, options) {
         (candidate) => Boolean(candidate)
       );
       if (failure) {
-        normalized[alias] = failure.message;
+        normalized[alias] = enrichFailureMessageWithOperation(
+          failure.message,
+          failure.operation ?? failureOperationByAlias.get(normalizeAlias2(alias))
+        );
       }
     }
     for (const alias of aliases) {
@@ -18799,21 +18919,24 @@ function normalizeEnrichRowsForCsvExport(rows, config, options) {
         normalized[alias] = value;
         continue;
       }
-      if (isNonEmptyCsvCell(normalized[alias])) {
-        continue;
-      }
       const failure = aliasFailureCellCandidates(normalized, alias).map(cellFailureError).find(
         (candidate) => Boolean(candidate)
       );
       if (failure) {
-        normalized[alias] = failure.message;
+        normalized[alias] = enrichFailureMessageWithOperation(
+          failure.message,
+          failure.operation ?? failureOperationByAlias.get(normalizeAlias2(alias))
+        );
+        continue;
+      }
+      if (isNonEmptyCsvCell(normalized[alias])) {
         continue;
       }
-      const statusFailureMessage = options?.statusFailureMessages?.get(
+      const statusFailureMessage2 = options?.statusFailureMessages?.get(
         normalizeAlias2(alias)
       );
-      if (statusFailureMessage) {
-        normalized[alias] = statusFailureMessage;
+      if (statusFailureMessage2) {
+        normalized[alias] = statusFailureMessage2;
       }
     }
     return normalized;
@@ -21916,6 +22039,63 @@ function matchesGrepQuery(value, query, mode) {
   if (mode === "any") return terms.some((term) => haystack.includes(term));
   return terms.every((term) => haystack.includes(term));
 }
+function shellCommandArg(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function zeroMatchToolGuidance(options) {
+  const categories = options.categories ?? [];
+  const query = options.query?.trim() ?? "";
+  const filterText = [
+    categories.length ? `categories=${categories.join(",")}` : null,
+    query ? `grep=${query}` : null,
+    query ? `grep_mode=${options.mode ?? "all"}` : null
+  ].filter(Boolean).join(" ");
+  const suggestions = [
+    ...query ? [
+      {
+        label: "Use ranked semantic search for intent-style queries",
+        command: `deepline tools search -- ${shellCommandArg(query)}`
+      },
+      ...options.mode === "all" ? [
+        {
+          label: "Relax literal grep from AND to OR matching",
+          command: `deepline tools grep --mode any -- ${shellCommandArg(query)}`
+        }
+      ] : []
+    ] : [],
+    {
+      label: "List the current atomic tool catalog",
+      command: "deepline tools list --json"
+    },
+    ...query ? [
+      {
+        label: "Search composed Deepline plays separately",
+        command: `deepline plays search -- ${shellCommandArg(query)}`
+      }
+    ] : []
+  ];
+  return {
+    reason: "filters_matched_no_atomic_tools",
+    message: `The tools catalog responded successfully, but no atomic provider tools matched ${filterText || "the current filters"}. This is a zero-match filter result, not a registry outage.`,
+    suggestions
+  };
+}
+function zeroMatchRender(emptyResult) {
+  return {
+    sections: [
+      {
+        title: "0 tools available:",
+        lines: [emptyResult.message]
+      },
+      {
+        title: "suggestions",
+        lines: emptyResult.suggestions.map(
+          (suggestion) => `${suggestion.label}: ${suggestion.command}`
+        )
+      }
+    ]
+  };
+}
 async function listTools(args) {
   const client2 = new DeeplineClient();
   const categoryArgIndex = args.findIndex((arg) => arg === "--categories");
@@ -21930,8 +22110,9 @@ async function listTools(args) {
       (category) => item.categories.includes(category)
     )
   );
+  const emptyResult = items.length === 0 && requestedCategories.length > 0 ? zeroMatchToolGuidance({ categories: requestedCategories }) : null;
   const render = {
-    sections: [
+    sections: emptyResult ? zeroMatchRender(emptyResult).sections : [
       {
         title: `${items.length} tools available:`,
         lines: items.map((item) => {
@@ -21953,6 +22134,7 @@ async function listTools(args) {
     {
       tools: outputItems,
       count: outputItems.length,
+      ...emptyResult ? { emptyResult } : {},
       filters: {
         categories: requestedCategories
       },
@@ -22024,6 +22206,11 @@ async function grepTools(queryInput, options = {}) {
   );
   const shouldCompact = options.compact || !options.json;
   const outputTools = shouldCompact ? tools.slice(0, 8).map(compactTool) : tools;
+  const emptyResult = tools.length === 0 ? zeroMatchToolGuidance({
+    categories: requestedCategories,
+    query,
+    mode
+  }) : null;
   printCommandEnvelope(
     {
       tools: outputTools,
@@ -22036,6 +22223,10 @@ async function grepTools(queryInput, options = {}) {
       filters: {
         categories: requestedCategories
       },
+      ...emptyResult ? {
+        emptyResult,
+        render: zeroMatchRender(emptyResult)
+      } : {},
       commandTemplates: TOOL_COMMAND_TEMPLATES
     },
     { json: options.json || shouldEmitJson() }