deepline 0.3.48 → 0.3.50

package/dist/cli/index.js

@@ -186,7 +186,7 @@ configureProxyFromEnv();
 
 // src/cli/index.ts
 var import_promises10 = require("fs/promises");
-var import_node_path26 = require("path");
+var import_node_path27 = require("path");
 var import_node_os18 = require("os");
 var import_commander4 = require("commander");
 
@@ -1079,7 +1079,7 @@ var SDK_RELEASE = {
   // available at toolResponse.rawV2 while toolResponse.raw and all declared
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
-  version: "0.3.48",
+  version: "0.3.50",
   updateSummary: "Automatic CLI updates are now enabled by default. To opt out, run `deepline settings autoupdate off`; use `deepline settings autoupdate on` to re-enable updates or `deepline settings autoupdate pin <version>` to hold an exact release. This release also adds raw-v2 tool responses at toolResponse.rawV2 while preserving existing toolResponse.raw and declared getters.",
   packageCapabilities: {
     updatePreferences: 1
@@ -1968,7 +1968,7 @@ var HttpClient = class {
           body: options?.body !== void 0 ? JSON.stringify(options.body) : void 0,
           signal: options?.signal
         });
-        if (!response.ok || response.status === 202) {
+        if (!response.ok) {
           const body = await response.text();
           const parsed = parseResponseBody(body);
           if (response.status === 401 && !isProviderOriginatedHttpError(parsed)) {
@@ -2216,7 +2216,7 @@ function decodeSseFrame(frame) {
   return parsed;
 }
 function sleep(ms) {
-  return new Promise((resolve19) => setTimeout(resolve19, ms));
+  return new Promise((resolve20) => setTimeout(resolve20, ms));
 }
 function withCoworkNetworkHint(message) {
   if (!isCoworkLikeSandbox2() || message.includes(COWORK_NETWORK_HINT)) {
@@ -3981,14 +3981,14 @@ async function* observeRunEvents(options) {
   try {
     for (; ; ) {
       if (queue.length === 0) {
-        const waitForItem = new Promise((resolve19) => {
-          wake = resolve19;
+        const waitForItem = new Promise((resolve20) => {
+          wake = resolve20;
         });
         if (!sawFirstSnapshot) {
           const timedOut = await Promise.race([
             waitForItem.then(() => false),
             new Promise(
-              (resolve19) => setTimeout(() => resolve19(true), OBSERVE_BOOTSTRAP_TIMEOUT_MS)
+              (resolve20) => setTimeout(() => resolve20(true), OBSERVE_BOOTSTRAP_TIMEOUT_MS)
             )
           ]);
           if (timedOut && queue.length === 0) {
@@ -4347,7 +4347,7 @@ function parseEnvTestPolicyOverrides() {
   return normalizeTestPolicyOverrides(parsed, "DEEPLINE_TEST_POLICY_OVERRIDES");
 }
 function sleep2(ms) {
-  return new Promise((resolve19) => setTimeout(resolve19, ms));
+  return new Promise((resolve20) => setTimeout(resolve20, ms));
 }
 function isTransientCompileManifestError(error) {
   if (error instanceof DeeplineError && typeof error.statusCode === "number") {
@@ -5697,26 +5697,12 @@ var DeeplineClient = class {
     const headers = options?.lastEventId && options.lastEventId.trim() ? { "Last-Event-ID": options.lastEventId.trim() } : void 0;
     const params = new URLSearchParams();
     params.set("mode", options?.mode ?? "cli");
-    const projectionDeadline = Date.now() + 3e4;
-    let projectionAttempt = 0;
-    for (; ; ) {
-      let sawEvent = false;
-      try {
-        for await (const event of this.http.streamSse(
-          `/api/v2/runs/${encodeURIComponent(workflowId)}/tail?${params.toString()}`,
-          { signal: options?.signal, headers }
-        )) {
-          sawEvent = true;
-          if (event.scope === "play") {
-            yield event;
-          }
-        }
-        return;
-      } catch (error) {
-        const projectionPending = options?.waitForProjection === true && !sawEvent && error instanceof DeeplineError && (error.statusCode === 404 || error.statusCode === 202 && error.code === "RUN_PROJECTION_PENDING") && Date.now() < projectionDeadline;
-        if (!projectionPending) throw error;
-        await sleep2(streamReconnectDelayMs(projectionAttempt));
-        projectionAttempt += 1;
+    for await (const event of this.http.streamSse(
+      `/api/v2/runs/${encodeURIComponent(workflowId)}/tail?${params.toString()}`,
+      { signal: options?.signal, headers }
+    )) {
+      if (event.scope === "play") {
+        yield event;
       }
     }
   }
@@ -6745,8 +6731,7 @@ var DeeplineClient = class {
     }
     for await (const event of this.streamPlayRunEvents(workflowId, {
       mode: "cli",
-      signal: options?.signal,
-      waitForProjection: true
+      signal: options?.signal
     })) {
       if (options?.signal?.aborted) {
         await this.cancelPlay(workflowId);
@@ -7769,6 +7754,10 @@ function flattenObjectColumns(row, options = {}) {
     }
     if (value && typeof value === "object" && !Array.isArray(value)) {
       const record = value;
+      if (options.objectColumns === "json") {
+        flattened[key] = csvSafeJsonString(record);
+        continue;
+      }
       const hasMatchedEnvelope = Object.prototype.hasOwnProperty.call(record, "matched_result") || Object.prototype.hasOwnProperty.call(record, "matchedResult");
       if (hasMatchedEnvelope) {
         flattened[key] = csvSafeJsonString(record);
@@ -8093,6 +8082,8 @@ async function httpJson(method, url, apiKey, body) {
     "X-Deepline-API-Contract": SDK_API_CONTRACT
   };
   if (apiKey) headers["Authorization"] = `Bearer ${apiKey}`;
+  const bypassToken = process.env.VERCEL_PROTECTION_BYPASS_TOKEN?.trim();
+  if (bypassToken) headers["x-vercel-protection-bypass"] = bypassToken;
   let response = null;
   let lastError = null;
   for (const candidateUrl of buildCandidateUrls2(url)) {
@@ -8159,7 +8150,7 @@ function buildCandidateUrls2(url) {
   }
 }
 function sleep4(ms) {
-  return new Promise((resolve19) => setTimeout(resolve19, ms));
+  return new Promise((resolve20) => setTimeout(resolve20, ms));
 }
 function printDeeplineLogo() {
   if (process.stdout.isTTY && (process.stdout.columns ?? 80) >= 70) {
@@ -10122,10 +10113,6 @@ var import_node_fs7 = require("fs");
 var import_node_os6 = require("os");
 var import_node_path8 = require("path");
 
-// src/cli/dataset-stats.ts
-var import_node_fs6 = require("fs");
-var import_node_path7 = require("path");
-
 // ../plays/dataset-summary.ts
 function formatDatasetRowCountsLine(counts) {
   const { persisted, succeeded, failed } = counts;
@@ -10179,6 +10166,103 @@ function formatDatasetExecutionStats(raw, _persistedRowTotal) {
   return stats;
 }
 
+// src/cli/run-dataset-csv.ts
+var import_node_fs6 = require("fs");
+var import_node_path7 = require("path");
+var RunDatasetCsv = class _RunDatasetCsv {
+  #projection;
+  constructor(input2) {
+    const rows = input2.rows.map(projectRunDatasetRow);
+    this.#projection = {
+      rows,
+      columns: runDatasetCsvColumns(rows, input2.columns)
+    };
+  }
+  static from(input2) {
+    return new _RunDatasetCsv(input2);
+  }
+  projection() {
+    return this.#projection;
+  }
+  write(outPath) {
+    const absolutePath = (0, import_node_path7.resolve)(outPath);
+    (0, import_node_fs6.writeFileSync)(
+      absolutePath,
+      csvStringFromRows(this.#projection.rows, this.#projection.columns),
+      "utf-8"
+    );
+    return absolutePath;
+  }
+};
+function writeRunDatasetCsv(input2) {
+  return RunDatasetCsv.from(input2).write(input2.outPath);
+}
+function projectRunDatasetRow(row) {
+  return Object.fromEntries(
+    Object.entries(row).map(([column, value]) => [
+      column,
+      projectRunDatasetCell(value)
+    ])
+  );
+}
+function projectRunDatasetCell(value) {
+  const logicalValue = parseSerializedDatasetValue(value);
+  if (logicalValue === null || logicalValue === void 0) return logicalValue;
+  if (typeof logicalValue === "object") {
+    return csvSafeJsonString(canonicalDatasetJson(logicalValue));
+  }
+  return logicalValue;
+}
+function canonicalDatasetJson(value) {
+  return canonicalDatasetJsonValue(value, /* @__PURE__ */ new WeakSet());
+}
+function canonicalDatasetJsonValue(value, ancestors) {
+  if (Array.isArray(value)) {
+    if (ancestors.has(value)) return value;
+    ancestors.add(value);
+    const normalized2 = value.map(
+      (item) => canonicalDatasetJsonValue(item, ancestors)
+    );
+    ancestors.delete(value);
+    return normalized2;
+  }
+  if (!value || typeof value !== "object" || value instanceof Date) {
+    return value;
+  }
+  if (ancestors.has(value)) return value;
+  ancestors.add(value);
+  const record = value;
+  const normalized = Object.fromEntries(
+    Object.keys(record).sort((left, right) => left.localeCompare(right)).map((key) => [key, canonicalDatasetJsonValue(record[key], ancestors)])
+  );
+  ancestors.delete(value);
+  return normalized;
+}
+function parseSerializedDatasetValue(value) {
+  if (typeof value !== "string") return value;
+  const text = value.trim();
+  if (!text || !["{", "["].includes(text[0] ?? "")) return value;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return value;
+  }
+}
+function runDatasetCsvColumns(rows, declaredColumns) {
+  const columns = [];
+  const seen = /* @__PURE__ */ new Set();
+  const add = (column) => {
+    if (!column || seen.has(column)) return;
+    seen.add(column);
+    columns.push(column);
+  };
+  for (const column of declaredColumns) add(column);
+  for (const row of rows) {
+    for (const column of Object.keys(row)) add(column);
+  }
+  return columns;
+}
+
 // src/cli/dataset-stats.ts
 function mergeCanonicalRowsInfo(left, right) {
   const preferred = right.rows.length > left.rows.length || right.complete && !left.complete && right.rows.length === left.rows.length ? right : left;
@@ -10596,6 +10680,11 @@ function collectSerializedDatasetRowsInfos(statusOrResult) {
   }
   return infos;
 }
+var LegacyRunDatasetCatalogAdapter = class {
+  static datasets(statusOrResult) {
+    return collectSerializedDatasetRowsInfos(statusOrResult);
+  }
+};
 function extractCanonicalRowsInfo(statusOrResult) {
   return collectCanonicalRowsInfos(statusOrResult)[0] ?? null;
 }
@@ -10765,22 +10854,6 @@ function buildDatasetStats(rows, totalRows = rows.length, columns = inferColumns
     columnStats
   };
 }
-function writeCanonicalRowsCsv(rowsInfo, outPath) {
-  if (!rowsInfo.complete) {
-    throw new Error(
-      `Run output only includes ${rowsInfo.rows.length} preview row(s) of ${rowsInfo.totalRows}; cannot export a complete CSV from this status payload yet.`
-    );
-  }
-  const sanitized = sanitizeCsvProjectionInfo({
-    rows: rowsInfo.rows,
-    columns: rowsInfo.columns
-  });
-  const rows = dataExportRows(sanitized.rows);
-  const columns = dataExportColumns(rows, sanitized.columns);
-  const resolved = (0, import_node_path7.resolve)(outPath);
-  (0, import_node_fs6.writeFileSync)(resolved, csvStringFromRows(rows, columns), "utf-8");
-  return resolved;
-}
 
 // src/cli/commands/csv.ts
 function parseRowRange(raw) {
@@ -18261,6 +18334,207 @@ var SDK_PACKAGE_JSON = (0, import_node_path13.resolve)(SDK_PACKAGE_ROOT, "packag
 var SDK_ENTRY_FILE = (0, import_node_path13.resolve)(SDK_SOURCE_ROOT, "index.ts");
 var SDK_TYPES_ENTRY_FILE = HAS_SOURCE_BUNDLING_SOURCES ? SDK_ENTRY_FILE : (0, import_node_path13.resolve)(SDK_PACKAGE_ROOT, "dist", "index.d.ts");
 
+// src/cli/run-dataset-selection.ts
+var Run = class _Run {
+  #datasets;
+  constructor(input2) {
+    this.#datasets = RunDatasetCatalog.from({
+      runPackage: input2.runPackage,
+      datasets: input2.datasets
+    });
+  }
+  static open(input2) {
+    return new _Run(input2);
+  }
+  datasets() {
+    return this.#datasets;
+  }
+  /** Select the Dataset a caller wants to export; enumerate with datasets(). */
+  dataset(path) {
+    return this.#datasets.choose(path);
+  }
+};
+var RunDatasetCatalog = class _RunDatasetCatalog {
+  #available;
+  #returned;
+  #recovered;
+  constructor(input2) {
+    this.#available = input2.available.map((info) => RunDataset.from(info));
+    this.#returned = input2.returned.map((info) => RunDataset.from(info));
+    this.#recovered = input2.available.filter((info) => info.recovered).map((info) => RunDataset.from(info));
+  }
+  static from(input2) {
+    const available = withReturnedDatasetAliases(
+      input2.runPackage,
+      distinctRunDatasets(input2.datasets)
+    );
+    return new _RunDatasetCatalog({
+      available,
+      returned: returnedRunDatasets(input2.runPackage, available)
+    });
+  }
+  available() {
+    return this.#available;
+  }
+  returned() {
+    return this.#returned;
+  }
+  recovered() {
+    return this.#recovered;
+  }
+  /**
+   * Select an exact public Dataset path/id/namespace. With no requested path,
+   * a Run returns its sole returned Dataset, or its sole recovered Dataset.
+   */
+  choose(path) {
+    const requested = path?.trim();
+    if (requested) {
+      return this.#available.find((dataset) => dataset.matches(requested)) ?? null;
+    }
+    if (this.#returned.length === 1) return this.#returned[0];
+    return this.#returned.length === 0 && this.#recovered.length === 1 ? this.#recovered[0] : null;
+  }
+};
+var RunDataset = class _RunDataset {
+  #info;
+  constructor(info) {
+    this.#info = info;
+  }
+  static from(info) {
+    return new _RunDataset(info);
+  }
+  get source() {
+    return this.#info.source;
+  }
+  get datasetId() {
+    return this.#info.datasetId;
+  }
+  get tableNamespace() {
+    return this.#info.tableNamespace;
+  }
+  get rows() {
+    return this.#info.rows;
+  }
+  get totalRows() {
+    return this.#info.totalRows;
+  }
+  get complete() {
+    return this.#info.complete;
+  }
+  get recovered() {
+    return this.#info.recovered;
+  }
+  get exportUnavailableReason() {
+    return this.#info.exportUnavailableReason;
+  }
+  get exportUnavailableMessage() {
+    return this.#info.exportUnavailableMessage;
+  }
+  matches(path) {
+    return this.source === path || this.datasetId === path || this.tableNamespace === path;
+  }
+  /** Return a new Handle when its preview has been replaced by fetched rows. */
+  withRows(info) {
+    return _RunDataset.from(info);
+  }
+  /** Write this Dataset's stable, non-flattening CSV Projection. */
+  exportCsv(outPath) {
+    if (!this.complete) {
+      throw new Error(
+        `Run Dataset '${this.source ?? this.tableNamespace ?? "dataset"}' only includes ${this.rows.length} preview row(s) of ${this.totalRows}; cannot export a complete CSV yet.`
+      );
+    }
+    return writeRunDatasetCsv({
+      rows: this.rows,
+      columns: this.#info.columns,
+      outPath
+    });
+  }
+  /** Compatibility seam for callers which still return CanonicalRowsInfo. */
+  info() {
+    return this.#info;
+  }
+};
+function distinctRunDatasets(infos) {
+  const byIdentity = /* @__PURE__ */ new Map();
+  for (const info of infos) {
+    const identity = info.datasetId?.trim() ? `id:${info.datasetId.trim()}` : `path:${info.source ?? info.tableNamespace ?? "dataset"}`;
+    const existing = byIdentity.get(identity);
+    byIdentity.set(
+      identity,
+      existing ? mergeCanonicalRowsInfo(existing, info) : info
+    );
+  }
+  return [...byIdentity.values()];
+}
+function packageForDatasetSelection(runPackage) {
+  const root = recordValue(runPackage);
+  const nested = recordValue(root.package);
+  if (nested?.kind === "play_run") return nested;
+  return root.kind === "play_run" ? root : null;
+}
+function withReturnedDatasetAliases(runPackage, available) {
+  const outputs = recordValue(packageForDatasetSelection(runPackage)?.outputs);
+  if (Object.keys(outputs).length === 0) return available;
+  const expanded = [...available];
+  for (const outputValue of Object.values(outputs)) {
+    const output2 = recordValue(outputValue);
+    if (output2.kind !== "dataset") continue;
+    const alias = stringValue2(output2.path);
+    if (!alias) continue;
+    const datasetId = stringValue2(output2.datasetId);
+    const canonicalPath2 = stringValue2(output2.dataset);
+    const canonical = available.find(
+      (info) => datasetId && info.datasetId === datasetId || canonicalPath2 && info.source === canonicalPath2
+    );
+    if (!canonical) continue;
+    const aliasIndex = expanded.findIndex((info) => info.source === alias);
+    if (aliasIndex >= 0) {
+      expanded[aliasIndex] = {
+        ...mergeCanonicalRowsInfo(expanded[aliasIndex], canonical),
+        source: alias
+      };
+    } else {
+      expanded.push({ ...canonical, source: alias });
+    }
+  }
+  return expanded;
+}
+function returnedRunDatasets(runPackage, available) {
+  const outputs = recordValue(packageForDatasetSelection(runPackage)?.outputs);
+  if (Object.keys(outputs).length > 0) {
+    const selected = /* @__PURE__ */ new Map();
+    for (const outputValue of Object.values(outputs)) {
+      const output2 = recordValue(outputValue);
+      if (output2.kind !== "dataset") continue;
+      const datasetId = stringValue2(output2.datasetId);
+      const alias = stringValue2(output2.path);
+      const canonicalPath2 = stringValue2(output2.dataset);
+      const info = (alias ? available.find((candidate) => candidate.source === alias) : null) ?? (datasetId ? available.find((candidate) => candidate.datasetId === datasetId) : null) ?? (canonicalPath2 ? available.find((candidate) => candidate.source === canonicalPath2) : null);
+      if (!info) continue;
+      const identity = datasetId ? `id:${datasetId}` : `path:${canonicalPath2 ?? alias ?? info.source ?? "dataset"}`;
+      const aliased = { ...info, source: alias ?? info.source };
+      const existing = selected.get(identity);
+      selected.set(
+        identity,
+        existing ? mergeCanonicalRowsInfo(existing, aliased) : aliased
+      );
+    }
+    if (selected.size > 0) return [...selected.values()];
+  }
+  return distinctRunDatasets(
+    available.filter(
+      (info) => Boolean(info.source?.startsWith("result.")) && !info.recovered
+    )
+  );
+}
+function recordValue(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function stringValue2(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+
 // src/cli/progress.ts
 var import_node_worker_threads = require("worker_threads");
 var CliProgress = class {
@@ -18530,7 +18804,7 @@ ${hint}`;
 
 // ../play-runtime/governor/policy.ts
 var DEFAULT_MAX_CONCURRENT_EXTERNAL_CALLS = 64;
-var MAX_CONFIGURABLE_CONCURRENT_EXTERNAL_CALLS = 256;
+var MAX_CONFIGURABLE_CONCURRENT_EXTERNAL_CALLS = 1e3;
 var MAX_CONFIGURABLE_CONCURRENT_ROWS = 1e3;
 function resolveMaxConcurrentExternalCalls(requested) {
   if (requested === void 0 || requested === null) {
@@ -19072,8 +19346,7 @@ var PLAY_RUN_RESERVED_BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
   "--force",
   "--force-tool-refresh",
   "--open",
-  "--debug-map-latency",
-  "--debug-fixture-provider-pacing"
+  "--debug-map-latency"
 ]);
 async function pathExistsIncludingSymlink(path) {
   try {
@@ -19208,7 +19481,7 @@ function traceCliSync(phase, fields, run) {
   }
 }
 function sleep5(ms) {
-  return new Promise((resolve19) => setTimeout(resolve19, ms));
+  return new Promise((resolve20) => setTimeout(resolve20, ms));
 }
 function parseReferencedPlayTarget2(target) {
   const trimmed = target.trim();
@@ -20779,7 +21052,7 @@ async function waitForPlayCompletionByStream(input2) {
     try {
       for await (const event of input2.client.streamPlayRunEvents(
         input2.workflowId,
-        { signal: controller.signal, waitForProjection: true }
+        { signal: controller.signal }
       )) {
         sawEvent = true;
         const terminal = await handleLiveEvent(event);
@@ -22521,103 +22794,6 @@ async function fetchBackingDatasetRows(input2) {
     source: `${input2.rowsInfo.source ?? "result.rows"} -> /api/v2/plays/${playName}/sheet?tableNamespace=${tableNamespace}`
   };
 }
-function resolveDatasetByName(available, datasetPath) {
-  const target = datasetPath.trim();
-  const exact = available.find((info) => info.source === target);
-  if (exact) {
-    return exact;
-  }
-  const byDatasetId = available.find((info) => info.datasetId === target);
-  if (byDatasetId) {
-    return byDatasetId;
-  }
-  const byNamespace = available.find(
-    (info) => info.tableNamespace && info.tableNamespace === target
-  );
-  if (byNamespace) {
-    return byNamespace;
-  }
-  return null;
-}
-function canonicalRowsIdentity(info) {
-  return info.datasetId?.trim() ? `id:${info.datasetId.trim()}` : `path:${info.source ?? info.tableNamespace ?? "dataset"}`;
-}
-function distinctCanonicalRowsInfos(infos) {
-  const byIdentity = /* @__PURE__ */ new Map();
-  for (const info of infos) {
-    const identity = canonicalRowsIdentity(info);
-    const existing = byIdentity.get(identity);
-    byIdentity.set(
-      identity,
-      existing ? mergeCanonicalRowsInfo(existing, info) : info
-    );
-  }
-  return [...byIdentity.values()];
-}
-function packageForExportSelection(status) {
-  const root = status;
-  const nested = readRecord(root.package);
-  if (nested?.kind === "play_run") return nested;
-  return root.kind === "play_run" ? root : null;
-}
-function withReturnedDatasetAliases(status, available) {
-  const packaged = packageForExportSelection(status);
-  const outputs = readRecord(packaged?.outputs);
-  if (!outputs) return available;
-  const expanded = [...available];
-  for (const outputValue of Object.values(outputs)) {
-    const output2 = readRecord(outputValue);
-    if (output2?.kind !== "dataset") continue;
-    const alias = typeof output2.path === "string" && output2.path.trim() ? output2.path.trim() : null;
-    if (!alias) continue;
-    const datasetId = typeof output2.datasetId === "string" && output2.datasetId.trim() ? output2.datasetId.trim() : null;
-    const canonicalPath2 = typeof output2.dataset === "string" && output2.dataset.trim() ? output2.dataset.trim() : null;
-    const canonical = available.find(
-      (info) => datasetId && info.datasetId === datasetId || canonicalPath2 && info.source === canonicalPath2
-    );
-    if (canonical) {
-      const aliasIndex = expanded.findIndex((info) => info.source === alias);
-      if (aliasIndex >= 0) {
-        expanded[aliasIndex] = {
-          ...mergeCanonicalRowsInfo(expanded[aliasIndex], canonical),
-          source: alias
-        };
-      } else {
-        expanded.push({ ...canonical, source: alias });
-      }
-    }
-  }
-  return expanded;
-}
-function returnedRowsInfos(status, available) {
-  const packaged = packageForExportSelection(status);
-  const outputs = readRecord(packaged?.outputs);
-  if (outputs) {
-    const selected = /* @__PURE__ */ new Map();
-    for (const outputValue of Object.values(outputs)) {
-      const output2 = readRecord(outputValue);
-      if (output2?.kind !== "dataset") continue;
-      const datasetId = typeof output2.datasetId === "string" && output2.datasetId.trim() ? output2.datasetId.trim() : null;
-      const alias = typeof output2.path === "string" && output2.path.trim() ? output2.path.trim() : null;
-      const canonicalPath2 = typeof output2.dataset === "string" && output2.dataset.trim() ? output2.dataset.trim() : null;
-      const info = (alias ? available.find((candidate) => candidate.source === alias) : null) ?? (datasetId ? available.find((candidate) => candidate.datasetId === datasetId) : null) ?? (canonicalPath2 ? available.find((candidate) => candidate.source === canonicalPath2) : null);
-      if (!info) continue;
-      const identity = datasetId ? `id:${datasetId}` : `path:${canonicalPath2 ?? alias ?? info.source ?? "dataset"}`;
-      const aliased = { ...info, source: alias ?? info.source };
-      const existing = selected.get(identity);
-      selected.set(
-        identity,
-        existing ? mergeCanonicalRowsInfo(existing, aliased) : aliased
-      );
-    }
-    if (selected.size > 0) return [...selected.values()];
-  }
-  return distinctCanonicalRowsInfos(
-    available.filter(
-      (info) => Boolean(info.source?.startsWith("result.")) && !info.recovered
-    )
-  );
-}
 function exportDatasetCommand(input2) {
   return `deepline runs export ${input2.runId} --dataset ${shellSingleQuote(
     input2.datasetPath
@@ -22676,16 +22852,17 @@ async function exportPlayStatusRows(client2, status, outPath, options = {}) {
   if (!outPath) {
     return null;
   }
-  const availableRows = withReturnedDatasetAliases(
-    status,
-    distinctCanonicalRowsInfos(collectSerializedDatasetRowsInfos(status))
-  );
-  const returnedRows = returnedRowsInfos(status, availableRows);
-  const recoveredRows = distinctCanonicalRowsInfos(
-    availableRows.filter((info) => info.recovered)
-  );
-  const rowsInfo = options.datasetPath ? resolveDatasetByName(availableRows, options.datasetPath) ?? null : returnedRows.length === 1 ? returnedRows[0] : returnedRows.length === 0 && recoveredRows.length === 1 ? recoveredRows[0] : null;
-  if (!rowsInfo && options.datasetPath) {
+  const run = Run.open({
+    runPackage: status,
+    datasets: LegacyRunDatasetCatalogAdapter.datasets(status)
+  });
+  const datasets = run.datasets();
+  const availableRows = datasets.available().map((dataset) => dataset.info());
+  const returnedRows = datasets.returned().map((dataset) => dataset.info());
+  const recoveredRows = datasets.recovered().map((dataset) => dataset.info());
+  const selectedDataset = run.dataset(options.datasetPath);
+  const rowsInfo = selectedDataset?.info() ?? null;
+  if (!selectedDataset && options.datasetPath) {
     const available = availableRows.map((info) => info.source).filter((source) => typeof source === "string");
     const commands = datasetChoiceLines({
       runId: status.runId,
@@ -22776,7 +22953,7 @@ ${commands.join("\n")}`,
         datasetPath: options.datasetPath
       });
       return {
-        path: writeCanonicalRowsCsv(guarded2, outPath),
+        path: RunDataset.from(guarded2).exportCsv(outPath),
         rowsInfo: guarded2
       };
     }
@@ -22788,7 +22965,7 @@ ${commands.join("\n")}`,
         datasetPath: options.datasetPath
       });
       return {
-        path: writeCanonicalRowsCsv(guarded2, outPath),
+        path: RunDataset.from(guarded2).exportCsv(outPath),
         rowsInfo: guarded2
       };
     }
@@ -22822,7 +22999,10 @@ ${commands.join("\n")}`,
     availableRows,
     datasetPath: options.datasetPath
   });
-  return { path: writeCanonicalRowsCsv(guarded, outPath), rowsInfo: guarded };
+  return {
+    path: RunDataset.from(guarded).exportCsv(outPath),
+    rowsInfo: guarded
+  };
 }
 function extractActiveRunsFromError(error) {
   if (!(error instanceof DeeplineError)) {
@@ -23116,9 +23296,6 @@ function parsePlayRunOptions(args) {
   const forceToolRefresh = args.includes("--force-tool-refresh");
   const open2 = args.includes("--open");
   const debugMapLatency = args.includes("--debug-map-latency");
-  const debugFixtureProviderPacing = args.includes(
-    "--debug-fixture-provider-pacing"
-  );
   const verboseLogs = args.includes("--logs") || debugMapLatency;
   let waitTimeoutMs = null;
   let maxConcurrentExternalCalls = null;
@@ -23322,7 +23499,6 @@ function parsePlayRunOptions(args) {
     open: open2,
     profile,
     debugMapLatency,
-    debugFixtureProviderPacing,
     fixtureBehavior,
     runIdFile
   };
@@ -23488,7 +23664,7 @@ function formatPlayRuntimeLimit(runtimeLimit) {
 function isRecord10(value) {
   return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
-function stringValue2(value) {
+function stringValue3(value) {
   return typeof value === "string" ? value.trim() : "";
 }
 function asArray(value) {
@@ -23508,11 +23684,11 @@ function firstRawPath(entry) {
     ...asArray(details.raw_tool_output_paths),
     ...asArray(details.candidatePaths),
     ...asArray(details.candidate_paths)
-  ].map(stringValue2).filter(Boolean);
+  ].map(stringValue3).filter(Boolean);
   return paths[0];
 }
 function checkHintExpression(value) {
-  return stringValue2(value).replace(/^toolExecutionResult\./, "result.");
+  return stringValue3(value).replace(/^toolExecutionResult\./, "result.");
 }
 function checkHintRawPath(value) {
   return value?.replace(/^toolResponse\./, "result.toolResponse.");
@@ -23527,7 +23703,7 @@ function collectStaticPipelineToolIds(staticPipeline) {
     ]) {
       if (!isRecord10(step)) continue;
       if (step.type === "tool") {
-        const toolId = stringValue2(step.toolId) || stringValue2(step.tool);
+        const toolId = stringValue3(step.toolId) || stringValue3(step.tool);
         if (toolId) seen.add(toolId);
       }
       if (step.type === "play_call") {
@@ -23545,14 +23721,14 @@ function toolGetterHintFromMetadata(toolId, tool) {
   const lists = extractionEntries2(
     resultGuidance.extractedLists ?? resultGuidance.extracted_lists
   ).map((entry) => ({
-    name: stringValue2(entry.name),
+    name: stringValue3(entry.name),
     expression: checkHintExpression(entry.expression),
     raw: checkHintRawPath(firstRawPath(entry))
   })).filter((entry) => entry.name && entry.expression);
   const values = extractionEntries2(
     resultGuidance.extractedValues ?? resultGuidance.extracted_values
   ).map((entry) => ({
-    name: stringValue2(entry.name),
+    name: stringValue3(entry.name),
     expression: checkHintExpression(entry.expression),
     raw: checkHintRawPath(firstRawPath(entry))
   })).filter((entry) => entry.name && entry.expression);
@@ -24113,14 +24289,8 @@ async function handleFileBackedRun(options, hooks) {
       "--fixture-behavior requires DEEPLINE_EVAL_INTEGRATION_MODE=fixture."
     );
   }
-  if (options.debugFixtureProviderPacing && integrationMode !== "fixture") {
-    throw new Error(
-      "--debug-fixture-provider-pacing requires DEEPLINE_EVAL_INTEGRATION_MODE=fixture."
-    );
-  }
   const testPolicyOverrides = {
-    ...options.debugMapLatency ? { mapLatencyProfile: true } : {},
-    ...options.debugFixtureProviderPacing ? { enforceFixtureProviderPacing: true } : {}
+    ...options.debugMapLatency ? { mapLatencyProfile: true } : {}
   };
   const startRequest = {
     name: playName,
@@ -24302,14 +24472,8 @@ async function handleNamedRun(options, hooks) {
       "--fixture-behavior requires DEEPLINE_EVAL_INTEGRATION_MODE=fixture."
     );
   }
-  if (options.debugFixtureProviderPacing && integrationMode !== "fixture") {
-    throw new Error(
-      "--debug-fixture-provider-pacing requires DEEPLINE_EVAL_INTEGRATION_MODE=fixture."
-    );
-  }
   const testPolicyOverrides = {
-    ...options.debugMapLatency ? { mapLatencyProfile: true } : {},
-    ...options.debugFixtureProviderPacing ? { enforceFixtureProviderPacing: true } : {}
+    ...options.debugMapLatency ? { mapLatencyProfile: true } : {}
   };
   const startRequest = {
     name: playName,
@@ -26194,9 +26358,6 @@ Examples:
   ).option("--open", "Open the play page in a browser after the run starts").option(
     "--debug-map-latency",
     "Internal diagnostics: emit one aggregate latency profile per dataset map"
-  ).option(
-    "--debug-fixture-provider-pacing",
-    "Internal diagnostics: retain provider pacing while fixture mode is active"
   ).option("--json", "Emit JSON output").option("--full", "Debug only: with --json, emit the raw status payload").addHelpText(
     "afterAll",
     `
@@ -26243,7 +26404,6 @@ Pass-through input flags:
       ...options.maxConcurrentRows ? ["--max-concurrent-rows", options.maxConcurrentRows] : [],
       ...options.open ? ["--open"] : [],
       ...options.debugMapLatency ? ["--debug-map-latency"] : [],
-      ...options.debugFixtureProviderPacing ? ["--debug-fixture-provider-pacing"] : [],
       ...options.json ? ["--json"] : [],
       ...options.full ? ["--full"] : [],
       ...passthroughArgs
@@ -28665,7 +28825,7 @@ function emitEnrichDebug(message) {
   );
 }
 function sleep6(ms) {
-  return new Promise((resolve19) => setTimeout(resolve19, ms));
+  return new Promise((resolve20) => setTimeout(resolve20, ms));
 }
 function enrichExportBackingRowsWaitMs() {
   const raw = process.env.DEEPLINE_ENRICH_EXPORT_BACKING_ROWS_WAIT_MS?.trim();
@@ -35098,7 +35258,7 @@ async function readHiddenLine(prompt, streams = {}) {
   }
   let value = "";
   inputStream.resume();
-  return await new Promise((resolve19, reject) => {
+  return await new Promise((resolve20, reject) => {
     let settled = false;
     const cleanup = () => {
       inputStream.off("data", onData);
@@ -35116,7 +35276,7 @@ async function readHiddenLine(prompt, streams = {}) {
       settled = true;
       outputStream.write("\n");
       cleanup();
-      resolve19(line);
+      resolve20(line);
     };
     const fail = (error) => {
       if (settled) return;
@@ -35288,15 +35448,137 @@ Examples:
 
 // src/cli/commands/setup.ts
 var import_node_child_process4 = require("child_process");
-var import_node_fs17 = require("fs");
+var import_node_fs18 = require("fs");
 var import_node_os12 = require("os");
-var import_node_path19 = require("path");
+var import_node_path20 = require("path");
+
+// src/cli/installation-lifecycle.ts
+var import_node_fs15 = require("fs");
+var import_node_path17 = require("path");
+var nodeFileSystem = {
+  exists: import_node_fs15.existsSync,
+  isSymbolicLink(path) {
+    try {
+      return (0, import_node_fs15.lstatSync)(path).isSymbolicLink();
+    } catch {
+      return false;
+    }
+  },
+  read(path) {
+    try {
+      return (0, import_node_fs15.readFileSync)(path, "utf8");
+    } catch {
+      return "";
+    }
+  },
+  realpath(path) {
+    try {
+      return (0, import_node_fs15.realpathSync)(path);
+    } catch {
+      return null;
+    }
+  },
+  remove(path) {
+    (0, import_node_fs15.rmSync)(path, { force: true });
+  }
+};
+function inspectLauncher(path, fileSystem = nodeFileSystem) {
+  if (!fileSystem.exists(path)) {
+    return { ownership: "missing", resolvedPath: null };
+  }
+  const resolvedPath = fileSystem.realpath(path);
+  if (CliInstallation.isNpmPackagePath(resolvedPath)) {
+    return { ownership: "npm", resolvedPath };
+  }
+  if (fileSystem.isSymbolicLink(path)) {
+    return { ownership: "symlink", resolvedPath };
+  }
+  const content = fileSystem.read(path);
+  if (content.includes("DEEPLINE_REAL_BINARY") && content.includes("DEEPLINE_ACTIVE_FILE")) {
+    return { ownership: "installer_legacy", resolvedPath };
+  }
+  return { ownership: "user", resolvedPath };
+}
+var CliInstallation = class _CliInstallation {
+  constructor(input2) {
+    this.input = input2;
+  }
+  static forUser(input2) {
+    return new _CliInstallation({
+      ...input2,
+      fileSystem: input2.fileSystem ?? nodeFileSystem
+    });
+  }
+  static isNpmPackagePath(path) {
+    return path?.includes(`${(0, import_node_path17.join)("node_modules", "deepline")}`) ?? false;
+  }
+  launcher(path) {
+    return inspectLauncher(path, this.input.fileSystem);
+  }
+  retiredArtifacts() {
+    const hostDir = (0, import_node_path17.join)(
+      this.input.home,
+      ".local",
+      "deepline",
+      this.input.baseUrlSlug
+    );
+    const legacyLauncherPath = (0, import_node_path17.join)(
+      this.input.home,
+      ".local",
+      "bin",
+      "deepline"
+    );
+    const installerCommandPath = this.input.fileSystem.read((0, import_node_path17.join)(hostDir, "sdk", ".command-path")).trim();
+    const ownedInstallerCommand = isOwnedInstallerCommandPath({
+      hostDir,
+      commandPath: installerCommandPath
+    });
+    const legacyLauncher = this.launcher(legacyLauncherPath);
+    const candidates = [
+      ...legacyLauncher.ownership === "installer_legacy" ? [legacyLauncherPath] : [],
+      (0, import_node_path17.join)(this.input.home, ".local", "bin", "deepline-real"),
+      (0, import_node_path17.join)(hostDir, "bin", "deepline"),
+      (0, import_node_path17.join)(hostDir, "bin", "deepline-real"),
+      (0, import_node_path17.join)(hostDir, "cli", ".install-method"),
+      (0, import_node_path17.join)(hostDir, "cli", ".version"),
+      (0, import_node_path17.join)(hostDir, "sdk", ".install-method"),
+      (0, import_node_path17.join)(hostDir, "sdk", ".command-path"),
+      ...ownedInstallerCommand ? [
+        installerCommandPath,
+        (0, import_node_path17.join)((0, import_node_path17.dirname)(installerCommandPath), "deepline-sdk")
+      ] : []
+    ];
+    return {
+      paths: candidates.filter((path) => {
+        if (!this.input.fileSystem.exists(path)) return false;
+        return this.launcher(path).ownership !== "npm";
+      })
+    };
+  }
+  removeRetiredArtifacts() {
+    return removeArtifacts(this.retiredArtifacts(), this.input.fileSystem);
+  }
+};
+function removeArtifacts(plan, fileSystem) {
+  for (const path of plan.paths) {
+    fileSystem.remove(path);
+  }
+  return plan.paths;
+}
+function isOwnedInstallerCommandPath(input2) {
+  if (!input2.commandPath || (0, import_node_path17.basename)(input2.commandPath) !== "deepline") {
+    return false;
+  }
+  const commandPath = (0, import_node_path17.resolve)(input2.commandPath);
+  const fromHost = (0, import_node_path17.relative)((0, import_node_path17.resolve)(input2.hostDir), commandPath);
+  return fromHost !== "" && fromHost !== ".." && !fromHost.startsWith(`..${process.platform === "win32" ? "\\" : "/"}`);
+}
 
 // src/cli/commands/skills.ts
 var import_node_child_process3 = require("child_process");
-var import_node_fs16 = require("fs");
+var import_node_fs17 = require("fs");
 var import_node_os11 = require("os");
-var import_node_path18 = require("path");
+var import_node_path19 = require("path");
 
 // ../../shared_libs/cli/install-commands.json
 var install_commands_default = {
@@ -35400,8 +35682,8 @@ function buildSkillsAddArgs(baseUrl, skillName, options = {}) {
 
 // src/cli/skills-sync.ts
 var import_node_child_process2 = require("child_process");
-var import_node_fs15 = require("fs");
-var import_node_path17 = require("path");
+var import_node_fs16 = require("fs");
+var import_node_path18 = require("path");
 
 // src/cli/windows-arg-escape.ts
 var CMD_META_CHARS = /([()\][%!^"`<>&|;, *?])/g;
@@ -35436,10 +35718,10 @@ function shouldSkipSkillsSync() {
   return value === "1" || value === "true" || value === "yes" || value === "on";
 }
 function unavailableSkillsNoticePath(baseUrl) {
-  return (0, import_node_path17.join)(sdkCliStateDirPath(baseUrl), "skills-sync-unavailable-version");
+  return (0, import_node_path18.join)(sdkCliStateDirPath(baseUrl), "skills-sync-unavailable-version");
 }
 function failedSkillsSyncPath(baseUrl, agents) {
-  return (0, import_node_path17.join)(
+  return (0, import_node_path18.join)(
     sdkCliStateDirPath(baseUrl),
     `skills-sync-failed-${agents.join("-")}-version`
   );
@@ -35449,15 +35731,15 @@ function hasMarkedSkillsSyncVersion(path, version) {
 }
 function readMarkedSkillsSyncVersion(path) {
   try {
-    return (0, import_node_fs15.existsSync)(path) ? (0, import_node_fs15.readFileSync)(path, "utf-8").trim() : "";
+    return (0, import_node_fs16.existsSync)(path) ? (0, import_node_fs16.readFileSync)(path, "utf-8").trim() : "";
   } catch {
     return "";
   }
 }
 function writeMarkedSkillsSyncVersion(path, version) {
   try {
-    (0, import_node_fs15.mkdirSync)((0, import_node_path17.dirname)(path), { recursive: true });
-    (0, import_node_fs15.writeFileSync)(path, `${version}
+    (0, import_node_fs16.mkdirSync)((0, import_node_path18.dirname)(path), { recursive: true });
+    (0, import_node_fs16.writeFileSync)(path, `${version}
 `, "utf-8");
   } catch {
   }
@@ -35474,7 +35756,7 @@ ${manualCommand}`
 }
 function clearUnavailableSkillsNotice(baseUrl) {
   try {
-    (0, import_node_fs15.unlinkSync)(unavailableSkillsNoticePath(baseUrl));
+    (0, import_node_fs16.unlinkSync)(unavailableSkillsNoticePath(baseUrl));
   } catch {
   }
 }
@@ -35485,7 +35767,7 @@ function hasFailedSkillsSync(baseUrl, remoteVersion, agents) {
   );
 }
 function hasFailedAutomaticSkillsSync(baseUrl, agents) {
-  return (0, import_node_fs15.existsSync)(failedSkillsSyncPath(baseUrl, agents));
+  return (0, import_node_fs16.existsSync)(failedSkillsSyncPath(baseUrl, agents));
 }
 function markFailedSkillsSync(baseUrl, remoteVersion, agents) {
   writeMarkedSkillsSyncVersion(
@@ -35495,7 +35777,7 @@ function markFailedSkillsSync(baseUrl, remoteVersion, agents) {
 }
 function clearFailedSkillsSync(baseUrl, agents) {
   try {
-    (0, import_node_fs15.unlinkSync)(failedSkillsSyncPath(baseUrl, agents));
+    (0, import_node_fs16.unlinkSync)(failedSkillsSyncPath(baseUrl, agents));
   } catch {
   }
 }
@@ -35610,7 +35892,7 @@ function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NA
   return commands;
 }
 function runOneSkillsInstall(install) {
-  return new Promise((resolve19) => {
+  return new Promise((resolve20) => {
     const plan = resolveSkillsInstallSpawn(install);
     const child = (0, import_node_child_process2.spawn)(plan.command, plan.args, {
       stdio: ["ignore", "ignore", "pipe"],
@@ -35622,7 +35904,7 @@ function runOneSkillsInstall(install) {
       stderr += chunk.toString("utf-8");
     });
     child.on("error", (error) => {
-      resolve19({
+      resolve20({
         ok: false,
         detail: `failed to start ${install.command}: ${error.message}`,
         manualCommand: install.manualCommand
@@ -35630,11 +35912,11 @@ function runOneSkillsInstall(install) {
     });
     child.on("close", (code) => {
       if (code === 0) {
-        resolve19({ ok: true, detail: "", manualCommand: install.manualCommand });
+        resolve20({ ok: true, detail: "", manualCommand: install.manualCommand });
         return;
       }
       const detail = stderr.trim();
-      resolve19({
+      resolve20({
         ok: false,
         detail: detail ? `${install.command}: ${detail}` : `${install.command} exited ${code}`,
         manualCommand: install.manualCommand
@@ -35836,13 +36118,13 @@ function detectSkillsAgents(input2) {
   ];
   const detected = AGENT_MARKERS.filter(
     (marker) => roots.some(
-      (root) => marker.paths.some((path) => (0, import_node_fs16.existsSync)((0, import_node_path18.join)(root, path)))
+      (root) => marker.paths.some((path) => (0, import_node_fs17.existsSync)((0, import_node_path19.join)(root, path)))
     )
   ).map((marker) => marker.agent);
   return detected.length > 0 ? detected : ["*"];
 }
 function skillsStatePathForScope(baseUrl, scope, root) {
-  return scope === "local" && root ? (0, import_node_path18.join)(root, ".deepline", "setup", "skills.json") : (0, import_node_path18.join)(sdkCliStateDirPath(baseUrl), "skills-install.json");
+  return scope === "local" && root ? (0, import_node_path19.join)(root, ".deepline", "setup", "skills.json") : (0, import_node_path19.join)(sdkCliStateDirPath(baseUrl), "skills-install.json");
 }
 function buildSkillsPlan(input2) {
   const scopeArgs = input2.scope === "global" ? ["--global"] : [];
@@ -35909,14 +36191,14 @@ function isSkillsPlanCurrent(plan, state) {
 }
 function readSkillsInstallState(path) {
   try {
-    const parsed = JSON.parse((0, import_node_fs16.readFileSync)(path, "utf8"));
+    const parsed = JSON.parse((0, import_node_fs17.readFileSync)(path, "utf8"));
     return parsed !== null && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
   } catch {
     return null;
   }
 }
 function runProcess(command, args, cwd) {
-  return new Promise((resolve19, reject) => {
+  return new Promise((resolve20, reject) => {
     const plan = resolveShellSpawn(command, args);
     const child = (0, import_node_child_process3.spawn)(plan.command, plan.args, {
       cwd,
@@ -35935,7 +36217,7 @@ function runProcess(command, args, cwd) {
         process.stderr.write(`${SKILLS_NPX_PACKAGE} exited ${code}.
 `);
       }
-      resolve19(code ?? 1);
+      resolve20(code ?? 1);
     });
   });
 }
@@ -36053,8 +36335,8 @@ async function runSkillsCommand(options, dependencies = {}) {
     );
     return 5;
   }
-  (0, import_node_fs16.mkdirSync)((0, import_node_path18.dirname)(plan.statePath), { recursive: true });
-  (0, import_node_fs16.writeFileSync)(
+  (0, import_node_fs17.mkdirSync)((0, import_node_path19.dirname)(plan.statePath), { recursive: true });
+  (0, import_node_fs17.writeFileSync)(
     plan.statePath,
     `${JSON.stringify(
       {
@@ -36191,7 +36473,7 @@ function phasesFromLegacyStatus(status) {
 function readSetupState(input2) {
   try {
     const parsed = JSON.parse(
-      (0, import_node_fs17.readFileSync)(
+      (0, import_node_fs18.readFileSync)(
         setupStatePath(input2.baseUrl, input2.scope, input2.root),
         "utf8"
       )
@@ -36267,7 +36549,7 @@ function buildPendingAuthorizationOutput(input2) {
   };
 }
 function setupStatePath(baseUrl, scope, root) {
-  return scope === "local" && root ? (0, import_node_path19.join)(root, ".deepline", "setup", "state.json") : (0, import_node_path19.join)(sdkCliStateDirPath(baseUrl), "setup.json");
+  return scope === "local" && root ? (0, import_node_path20.join)(root, ".deepline", "setup", "state.json") : (0, import_node_path20.join)(sdkCliStateDirPath(baseUrl), "setup.json");
 }
 async function captureStdout2(run) {
   let stdout = "";
@@ -36296,57 +36578,16 @@ function asRecord3(value) {
 }
 function safeRead(path) {
   try {
-    return (0, import_node_fs17.readFileSync)(path, "utf8");
+    return (0, import_node_fs18.readFileSync)(path, "utf8");
   } catch {
     return "";
   }
 }
-function isNpmManagedDeeplinePath(path) {
-  try {
-    return (0, import_node_fs17.realpathSync)(path).includes(`${(0, import_node_path19.join)("node_modules", "deepline")}`);
-  } catch {
-    return false;
-  }
-}
-function isInstallerManagedLegacyLauncher(path) {
-  const content = safeRead(path);
-  return content.includes("DEEPLINE_REAL_BINARY") && content.includes("DEEPLINE_ACTIVE_FILE");
-}
 function removeKnownLegacyPaths(baseUrl) {
-  const home = (0, import_node_os12.homedir)();
-  const hostDir = (0, import_node_path19.join)(home, ".local", "deepline", baseUrlSlug(baseUrl));
-  const legacyLauncherPath = (0, import_node_path19.join)(home, ".local", "bin", "deepline");
-  const installerCommandPath = safeRead(
-    (0, import_node_path19.join)(hostDir, "sdk", ".command-path")
-  ).trim();
-  const relativeInstallerCommandPath = installerCommandPath ? (0, import_node_path19.relative)((0, import_node_path19.resolve)(hostDir), (0, import_node_path19.resolve)(installerCommandPath)) : "";
-  const isOwnedInstallerCommand = Boolean(installerCommandPath) && relativeInstallerCommandPath !== "" && !relativeInstallerCommandPath.startsWith(
-    `..${process.platform === "win32" ? "\\" : "/"}`
-  ) && relativeInstallerCommandPath !== ".." && (0, import_node_path19.basename)(installerCommandPath) === "deepline";
-  const candidates = [
-    ...isInstallerManagedLegacyLauncher(legacyLauncherPath) ? [legacyLauncherPath] : [],
-    (0, import_node_path19.join)(home, ".local", "bin", "deepline-real"),
-    (0, import_node_path19.join)(hostDir, "bin", "deepline"),
-    (0, import_node_path19.join)(hostDir, "bin", "deepline-real"),
-    (0, import_node_path19.join)(hostDir, "cli", ".install-method"),
-    (0, import_node_path19.join)(hostDir, "cli", ".version"),
-    (0, import_node_path19.join)(hostDir, "sdk", ".install-method"),
-    (0, import_node_path19.join)(hostDir, "sdk", ".command-path"),
-    ...isOwnedInstallerCommand ? [
-      installerCommandPath,
-      (0, import_node_path19.join)((0, import_node_path19.dirname)(installerCommandPath), "deepline-sdk")
-    ] : []
-  ];
-  const removed = [];
-  for (const path of candidates) {
-    if (!(0, import_node_fs17.existsSync)(path)) continue;
-    if (path === installerCommandPath && isNpmManagedDeeplinePath(path)) {
-      continue;
-    }
-    (0, import_node_fs17.rmSync)(path, { force: true });
-    removed.push(path);
-  }
-  return removed;
+  return CliInstallation.forUser({
+    baseUrlSlug: baseUrlSlug(baseUrl),
+    home: (0, import_node_os12.homedir)()
+  }).removeRetiredArtifacts();
 }
 function resolvePathCommands(command) {
   const lookup = (0, import_node_child_process4.spawnSync)(
@@ -36356,7 +36597,7 @@ function resolvePathCommands(command) {
   );
   return [
     ...new Set(
-      String(lookup.stdout ?? "").split(/\r?\n/).map((line) => line.trim()).filter(Boolean).map((path) => (0, import_node_path19.resolve)(path))
+      String(lookup.stdout ?? "").split(/\r?\n/).map((line) => line.trim()).filter(Boolean).map((path) => (0, import_node_path20.resolve)(path))
     )
   ];
 }
@@ -36366,7 +36607,7 @@ function resolvePathCommand(command) {
 function isHomebrewFormulaCommand(path) {
   let resolvedPath = path;
   try {
-    resolvedPath = (0, import_node_fs17.realpathSync)(path);
+    resolvedPath = (0, import_node_fs18.realpathSync)(path);
   } catch {
     return false;
   }
@@ -36377,7 +36618,7 @@ function isHomebrewFormulaCommand(path) {
 function resolvePersistentGlobalCommand(dependencies = {}) {
   const platform3 = dependencies.platform ?? process.platform;
   const run = dependencies.spawn ?? import_node_child_process4.spawnSync;
-  const pathExists = dependencies.exists ?? import_node_fs17.existsSync;
+  const pathExists = dependencies.exists ?? import_node_fs18.existsSync;
   const pathClis = dependencies.pathClis ?? resolvePathCommands("deepline");
   const homebrewCommand = pathClis.find(isHomebrewFormulaCommand);
   if (homebrewCommand) return homebrewCommand;
@@ -36389,7 +36630,7 @@ function resolvePersistentGlobalCommand(dependencies = {}) {
   if (prefix.status !== 0) return null;
   const root = String(prefix.stdout ?? "").trim();
   if (!root) return null;
-  const candidates = platform3 === "win32" ? [(0, import_node_path19.join)(root, "deepline.cmd"), (0, import_node_path19.join)(root, "deepline")] : [(0, import_node_path19.join)(root, "bin", "deepline")];
+  const candidates = platform3 === "win32" ? [(0, import_node_path20.join)(root, "deepline.cmd"), (0, import_node_path20.join)(root, "deepline")] : [(0, import_node_path20.join)(root, "bin", "deepline")];
   return candidates.find((candidate) => pathExists(candidate)) ?? null;
 }
 function inspectGlobalCliAvailability(input2) {
@@ -36402,20 +36643,20 @@ function inspectGlobalCliAvailability(input2) {
 }
 function pathsResolveToSameFile(left, right) {
   try {
-    return (0, import_node_fs17.realpathSync)(left) === (0, import_node_fs17.realpathSync)(right);
+    return (0, import_node_fs18.realpathSync)(left) === (0, import_node_fs18.realpathSync)(right);
   } catch {
-    return (0, import_node_path19.resolve)(left) === (0, import_node_path19.resolve)(right);
+    return (0, import_node_path20.resolve)(left) === (0, import_node_path20.resolve)(right);
   }
 }
 function isKnownDeeplineCommand(path) {
-  const entrypoint = process.argv[1] ? (0, import_node_path19.resolve)(process.argv[1]) : "";
+  const entrypoint = process.argv[1] ? (0, import_node_path20.resolve)(process.argv[1]) : "";
   let resolvedPath = path;
   try {
-    resolvedPath = (0, import_node_fs17.realpathSync)(path);
+    resolvedPath = (0, import_node_fs18.realpathSync)(path);
   } catch {
   }
   if (entrypoint && resolvedPath === entrypoint) return true;
-  if (resolvedPath.includes(`${(0, import_node_path19.join)("node_modules", "deepline")}`)) return true;
+  if (resolvedPath.includes(`${(0, import_node_path20.join)("node_modules", "deepline")}`)) return true;
   const content = safeRead(path);
   return content.includes("node_modules/deepline") || content.includes("node_modules\\deepline") || content.includes("DEEPLINE_CONFIG_SCOPE") || content.includes("deepline-real");
 }
@@ -36423,9 +36664,9 @@ function inspectPathConflict() {
   const commandPath = resolvePathCommand("deepline");
   if (!commandPath || isKnownDeeplineCommand(commandPath)) return null;
   try {
-    if ((0, import_node_fs17.lstatSync)(commandPath).isSymbolicLink()) {
-      const target = (0, import_node_fs17.realpathSync)(commandPath);
-      if (target.includes(`${(0, import_node_path19.join)("node_modules", "deepline")}`)) return null;
+    if ((0, import_node_fs18.lstatSync)(commandPath).isSymbolicLink()) {
+      const target = (0, import_node_fs18.realpathSync)(commandPath);
+      if (target.includes(`${(0, import_node_path20.join)("node_modules", "deepline")}`)) return null;
     }
   } catch {
   }
@@ -36433,8 +36674,8 @@ function inspectPathConflict() {
 }
 function writeSetupState(input2) {
   const path = setupStatePath(input2.baseUrl, input2.scope, input2.root);
-  (0, import_node_fs17.mkdirSync)((0, import_node_path19.dirname)(path), { recursive: true });
-  (0, import_node_fs17.writeFileSync)(
+  (0, import_node_fs18.mkdirSync)((0, import_node_path20.dirname)(path), { recursive: true });
+  (0, import_node_fs18.writeFileSync)(
     path,
     `${JSON.stringify(
       {
@@ -36474,7 +36715,7 @@ function failSetupPhase(phases, phase, code) {
   phases[phase] = { status: "failed", code };
 }
 function rollbackCommand(scope, root) {
-  const prefix = scope === "local" && root ? ` --prefix ${JSON.stringify((0, import_node_path19.join)(root, ".deepline", "runtime"))}` : "";
+  const prefix = scope === "local" && root ? ` --prefix ${JSON.stringify((0, import_node_path20.join)(root, ".deepline", "runtime"))}` : "";
   return `npm install -g${prefix} --no-audit --no-fund --include=optional --allow-scripts=esbuild deepline@${SDK_VERSION}`;
 }
 function setupResumeCommand(baseUrl, scope) {
@@ -36561,12 +36802,12 @@ function buildDoctorAssessment(input2) {
   const connected = input2.authStatus.payload?.connected === true;
   const authScopeOk = input2.scope === "local" ? Boolean(projectAuth) : Boolean(apiKey && !projectAuth);
   const skillsOk = skillsState?.scope === input2.scope && typeof skillsState.skillsVersion === "string" && Array.isArray(skillsState.agents) && skillsState.agents.length > 0;
-  const runningCliPath = process.argv[1] ? (0, import_node_path19.resolve)(process.argv[1]) : null;
+  const runningCliPath = process.argv[1] ? (0, import_node_path20.resolve)(process.argv[1]) : null;
   const globalCli = input2.scope === "global" ? inspectGlobalCliAvailability() : null;
   const pathGlobalCli = globalCli?.path ?? null;
   const cliPath = input2.scope === "global" ? pathGlobalCli : runningCliPath;
   const cliScopeOk = input2.scope === "global" ? Boolean(pathGlobalCli) : Boolean(
-    input2.root && runningCliPath?.includes((0, import_node_path19.join)(input2.root, ".deepline", "runtime"))
+    input2.root && runningCliPath?.includes((0, import_node_path20.join)(input2.root, ".deepline", "runtime"))
   );
   const checks = {
     cli: {
@@ -37093,9 +37334,9 @@ Examples:
 }
 
 // src/cli/update-preferences.ts
-var import_node_fs18 = require("fs");
+var import_node_fs19 = require("fs");
 var import_node_os13 = require("os");
-var import_node_path20 = require("path");
+var import_node_path21 = require("path");
 var UPDATE_PREFERENCES_SCHEMA_VERSION = 1;
 var CLI_UPDATE_MESSAGES = [
   {
@@ -37124,7 +37365,7 @@ function unreadablePreferences(path, error) {
   };
 }
 function cliUpdatePreferencesPath(homeDir2 = (0, import_node_os13.homedir)()) {
-  return (0, import_node_path20.join)(
+  return (0, import_node_path21.join)(
     homeDir2,
     ".local",
     "deepline",
@@ -37134,9 +37375,9 @@ function cliUpdatePreferencesPath(homeDir2 = (0, import_node_os13.homedir)()) {
 }
 function readCliUpdatePreferences(homeDir2 = (0, import_node_os13.homedir)()) {
   const path = cliUpdatePreferencesPath(homeDir2);
-  if (!(0, import_node_fs18.existsSync)(path)) return defaultPreferences();
+  if (!(0, import_node_fs19.existsSync)(path)) return defaultPreferences();
   try {
-    const parsed = JSON.parse((0, import_node_fs18.readFileSync)(path, "utf8"));
+    const parsed = JSON.parse((0, import_node_fs19.readFileSync)(path, "utf8"));
     return {
       schemaVersion: UPDATE_PREFERENCES_SCHEMA_VERSION,
       autoUpdateEnabled: typeof parsed.autoUpdateEnabled === "boolean" ? parsed.autoUpdateEnabled : true,
@@ -37152,16 +37393,16 @@ function readCliUpdatePreferences(homeDir2 = (0, import_node_os13.homedir)()) {
 function writeCliUpdatePreferences(preferences, homeDir2 = (0, import_node_os13.homedir)()) {
   const path = cliUpdatePreferencesPath(homeDir2);
   const tempPath = `${path}.${process.pid}.tmp`;
-  (0, import_node_fs18.mkdirSync)((0, import_node_path20.dirname)(path), { recursive: true });
+  (0, import_node_fs19.mkdirSync)((0, import_node_path21.dirname)(path), { recursive: true });
   try {
-    (0, import_node_fs18.writeFileSync)(tempPath, `${JSON.stringify(preferences, null, 2)}
+    (0, import_node_fs19.writeFileSync)(tempPath, `${JSON.stringify(preferences, null, 2)}
 `, {
       encoding: "utf8",
       mode: 384
     });
-    (0, import_node_fs18.renameSync)(tempPath, path);
+    (0, import_node_fs19.renameSync)(tempPath, path);
   } finally {
-    (0, import_node_fs18.rmSync)(tempPath, { force: true });
+    (0, import_node_fs19.rmSync)(tempPath, { force: true });
   }
 }
 function setCliAutoUpdateEnabled(enabled, homeDir2 = (0, import_node_os13.homedir)()) {
@@ -37211,14 +37452,14 @@ function consumePendingCliUpdateMessages(homeDir2 = (0, import_node_os13.homedir
 
 // src/cli/commands/update.ts
 var import_node_child_process5 = require("child_process");
-var import_node_fs20 = require("fs");
+var import_node_fs21 = require("fs");
 var import_node_os14 = require("os");
-var import_node_path22 = require("path");
+var import_node_path23 = require("path");
 
 // src/cli/install-integrity.ts
 var import_node_module2 = require("module");
-var import_node_fs19 = require("fs");
-var import_node_path21 = require("path");
+var import_node_fs20 = require("fs");
+var import_node_path22 = require("path");
 var SDK_SIDECAR_CRITICAL_PACKAGE_FILES = [
   "dist/cli/index.mjs",
   "dist/index.mjs",
@@ -37235,7 +37476,7 @@ var SDK_SIDECAR_CRITICAL_DEPENDENCY_FILES = [
   "esbuild/lib/main.js"
 ];
 function safeRelativePath(value) {
-  if (typeof value !== "string" || !value || (0, import_node_path21.isAbsolute)(value)) return false;
+  if (typeof value !== "string" || !value || (0, import_node_path22.isAbsolute)(value)) return false;
   const segments = value.split(/[\\/]+/);
   return segments.every(
     (segment) => Boolean(segment) && segment !== "." && segment !== ".."
@@ -37243,25 +37484,25 @@ function safeRelativePath(value) {
 }
 function resolveContainedPath(root, value) {
   if (!safeRelativePath(value)) return null;
-  const target = (0, import_node_path21.resolve)(root, value);
-  const relativeTarget = (0, import_node_path21.relative)((0, import_node_path21.resolve)(root), target);
-  if (!relativeTarget || relativeTarget.startsWith("..") || (0, import_node_path21.isAbsolute)(relativeTarget)) {
+  const target = (0, import_node_path22.resolve)(root, value);
+  const relativeTarget = (0, import_node_path22.relative)((0, import_node_path22.resolve)(root), target);
+  if (!relativeTarget || relativeTarget.startsWith("..") || (0, import_node_path22.isAbsolute)(relativeTarget)) {
     return null;
   }
   return target;
 }
 function parseJson(path) {
-  return JSON.parse((0, import_node_fs19.readFileSync)(path, "utf8"));
+  return JSON.parse((0, import_node_fs20.readFileSync)(path, "utf8"));
 }
 function isFile(path) {
   try {
-    return (0, import_node_fs19.statSync)(path).isFile();
+    return (0, import_node_fs20.statSync)(path).isFile();
   } catch {
     return false;
   }
 }
 function readManifest(packageRoot) {
-  const packageJsonPath = (0, import_node_path21.join)(packageRoot, "package.json");
+  const packageJsonPath = (0, import_node_path22.join)(packageRoot, "package.json");
   let packageJson;
   try {
     packageJson = parseJson(packageJsonPath);
@@ -37269,7 +37510,7 @@ function readManifest(packageRoot) {
     return {
       mode: "manifest",
       invalidReason: `invalid Deepline package metadata: ${error.message}`,
-      missing: (0, import_node_fs19.existsSync)(packageJsonPath) ? [] : ["deepline/package.json"]
+      missing: (0, import_node_fs20.existsSync)(packageJsonPath) ? [] : ["deepline/package.json"]
     };
   }
   if (!packageJson || typeof packageJson !== "object" || Array.isArray(packageJson)) {
@@ -37335,8 +37576,8 @@ function readManifest(packageRoot) {
   return { mode: "manifest", manifest };
 }
 function inspectSdkSidecarInstall(versionDir) {
-  const nodeModulesRoot = (0, import_node_path21.join)(versionDir, "node_modules");
-  const packageRoot = (0, import_node_path21.join)(nodeModulesRoot, "deepline");
+  const nodeModulesRoot = (0, import_node_path22.join)(versionDir, "node_modules");
+  const packageRoot = (0, import_node_path22.join)(nodeModulesRoot, "deepline");
   const manifestResult = readManifest(packageRoot);
   if ("invalidReason" in manifestResult) {
     return {
@@ -37347,8 +37588,8 @@ function inspectSdkSidecarInstall(versionDir) {
     };
   }
   const missing = [
-    ...manifestResult.manifest.packageFiles.filter((path) => !isFile((0, import_node_path21.join)(packageRoot, path))).map((path) => `deepline/${path}`),
-    ...manifestResult.manifest.dependencyFiles.filter((path) => !isFile((0, import_node_path21.join)(nodeModulesRoot, path))).map((path) => `node_modules/${path}`)
+    ...manifestResult.manifest.packageFiles.filter((path) => !isFile((0, import_node_path22.join)(packageRoot, path))).map((path) => `deepline/${path}`),
+    ...manifestResult.manifest.dependencyFiles.filter((path) => !isFile((0, import_node_path22.join)(nodeModulesRoot, path))).map((path) => `node_modules/${path}`)
   ];
   return {
     ok: missing.length === 0,
@@ -37359,7 +37600,7 @@ function inspectSdkSidecarInstall(versionDir) {
 }
 function probeSdkSidecarEsbuild(versionDir) {
   try {
-    const requireFromInstall = (0, import_node_module2.createRequire)((0, import_node_path21.join)(versionDir, "package.json"));
+    const requireFromInstall = (0, import_node_module2.createRequire)((0, import_node_path22.join)(versionDir, "package.json"));
     const esbuild = requireFromInstall("esbuild");
     if (typeof esbuild.transformSync !== "function") {
       return "esbuild does not export transformSync";
@@ -37434,7 +37675,7 @@ function sidecarStateDir(input2) {
   if (!scope || scope.includes("/") || scope.includes("\\")) {
     return null;
   }
-  return (0, import_node_path22.join)(input2.homeDir, ".local", "deepline", scope, "sdk-cli");
+  return (0, import_node_path23.join)(input2.homeDir, ".local", "deepline", scope, "sdk-cli");
 }
 function sidecarRegistryUrl(hostUrl) {
   let url;
@@ -37461,7 +37702,7 @@ function publicNpmFallbackRegistryUrl(hostUrl) {
 }
 function readOptionalText(path) {
   try {
-    return (0, import_node_fs20.readFileSync)(path, "utf8").trim();
+    return (0, import_node_fs21.readFileSync)(path, "utf8").trim();
   } catch {
     return "";
   }
@@ -37469,19 +37710,19 @@ function readOptionalText(path) {
 function resolvePythonSidecarUpdatePlan(options) {
   const stateDir = sidecarStateDir(options);
   if (!stateDir) return null;
-  const relativeEntrypoint = (0, import_node_path22.relative)(
-    (0, import_node_path22.resolve)(stateDir),
-    (0, import_node_path22.resolve)(options.entrypoint)
+  const relativeEntrypoint = (0, import_node_path23.relative)(
+    (0, import_node_path23.resolve)(stateDir),
+    (0, import_node_path23.resolve)(options.entrypoint)
   );
-  if (!relativeEntrypoint || relativeEntrypoint.startsWith("..") || (0, import_node_path22.isAbsolute)(relativeEntrypoint)) {
+  if (!relativeEntrypoint || relativeEntrypoint.startsWith("..") || (0, import_node_path23.isAbsolute)(relativeEntrypoint)) {
     return null;
   }
-  const installMethod = readOptionalText((0, import_node_path22.join)(stateDir, ".install-method"));
+  const installMethod = readOptionalText((0, import_node_path23.join)(stateDir, ".install-method"));
   if (installMethod !== "python-sidecar") return null;
   const scope = options.env.DEEPLINE_CONFIG_SCOPE?.trim() || "";
   const hostUrl = options.env.DEEPLINE_HOST_URL?.trim() || "";
-  const nodeBin = readOptionalText((0, import_node_path22.join)(stateDir, ".node-bin")) || process.execPath;
-  const sidecarPath = readOptionalText((0, import_node_path22.join)(stateDir, ".command-path")) || (0, import_node_path22.join)(
+  const nodeBin = readOptionalText((0, import_node_path23.join)(stateDir, ".node-bin")) || process.execPath;
+  const sidecarPath = readOptionalText((0, import_node_path23.join)(stateDir, ".command-path")) || (0, import_node_path23.join)(
     stateDir,
     "bin",
     process.platform === "win32" ? "deepline-sdk.cmd" : "deepline-sdk"
@@ -37489,7 +37730,7 @@ function resolvePythonSidecarUpdatePlan(options) {
   const packageSpec = options.packageSpec || "deepline@latest";
   const npmCommand = "npm";
   const registryUrl = sidecarRegistryUrl(hostUrl);
-  const versionDir = (0, import_node_path22.join)(stateDir, "versions", "<version>");
+  const versionDir = (0, import_node_path23.join)(stateDir, "versions", "<version>");
   const manualCommand = `${buildSidecarProjectConfigCommand(versionDir, nodeBin)} && ${npmCommand} install --prefix ${shellQuote4(versionDir)} --registry ${shellQuote4(registryUrl)} ${NPM_SDK_INSTALL_COMMON_FLAGS.map(shellQuote4).join(" ")} ${shellQuote4(packageSpec)}`;
   return {
     kind: "python-sidecar",
@@ -37505,16 +37746,16 @@ function resolvePythonSidecarUpdatePlan(options) {
   };
 }
 function findRepoBackedSdkRoot(startPath) {
-  let current = (0, import_node_path22.resolve)(startPath);
+  let current = (0, import_node_path23.resolve)(startPath);
   while (true) {
-    if ((0, import_node_fs20.existsSync)((0, import_node_path22.join)(current, "package.json")) && (0, import_node_fs20.existsSync)((0, import_node_path22.join)(current, "bin", "deepline-dev.ts"))) {
-      const parent2 = (0, import_node_path22.dirname)(current);
-      return (0, import_node_path22.basename)(parent2) === "packages" && (0, import_node_path22.basename)(current) === "sdk" ? (0, import_node_path22.dirname)(parent2) : parent2;
+    if ((0, import_node_fs21.existsSync)((0, import_node_path23.join)(current, "package.json")) && (0, import_node_fs21.existsSync)((0, import_node_path23.join)(current, "bin", "deepline-dev.ts"))) {
+      const parent2 = (0, import_node_path23.dirname)(current);
+      return (0, import_node_path23.basename)(parent2) === "packages" && (0, import_node_path23.basename)(current) === "sdk" ? (0, import_node_path23.dirname)(parent2) : parent2;
     }
-    if ((0, import_node_fs20.existsSync)((0, import_node_path22.join)(current, "sdk", "package.json")) && (0, import_node_fs20.existsSync)((0, import_node_path22.join)(current, "sdk", "bin", "deepline-dev.ts"))) {
+    if ((0, import_node_fs21.existsSync)((0, import_node_path23.join)(current, "sdk", "package.json")) && (0, import_node_fs21.existsSync)((0, import_node_path23.join)(current, "sdk", "bin", "deepline-dev.ts"))) {
       return current;
     }
-    const parent = (0, import_node_path22.dirname)(current);
+    const parent = (0, import_node_path23.dirname)(current);
     if (parent === current) return null;
     current = parent;
   }
@@ -37522,9 +37763,9 @@ function findRepoBackedSdkRoot(startPath) {
 function inferNpmGlobalPrefixFromEntrypoint(entrypoint, env) {
   const normalized = (() => {
     try {
-      return (0, import_node_fs20.realpathSync)(entrypoint);
+      return (0, import_node_fs21.realpathSync)(entrypoint);
     } catch {
-      return (0, import_node_path22.resolve)(entrypoint);
+      return (0, import_node_path23.resolve)(entrypoint);
     }
   })();
   const parts = normalized.split(/[\\/]+/);
@@ -37539,10 +37780,10 @@ function inferNpmGlobalPrefixFromEntrypoint(entrypoint, env) {
     const directPrefix = prefixParts.join("/").toLowerCase();
     const knownWindowsPrefixes = [
       env.npm_config_prefix,
-      env.APPDATA ? (0, import_node_path22.join)(env.APPDATA, "npm") : void 0
-    ].filter((value) => Boolean(value)).map((value) => (0, import_node_path22.resolve)(value).replace(/\\/g, "/").toLowerCase());
+      env.APPDATA ? (0, import_node_path23.join)(env.APPDATA, "npm") : void 0
+    ].filter((value) => Boolean(value)).map((value) => (0, import_node_path23.resolve)(value).replace(/\\/g, "/").toLowerCase());
     if (!knownWindowsPrefixes.includes(
-      (0, import_node_path22.resolve)(directPrefix).replace(/\\/g, "/").toLowerCase()
+      (0, import_node_path23.resolve)(directPrefix).replace(/\\/g, "/").toLowerCase()
     )) {
       return null;
     }
@@ -37555,9 +37796,9 @@ function normalizedNpmPrefix(value) {
   if (!trimmed) return null;
   const normalized = (() => {
     try {
-      return (0, import_node_fs20.realpathSync)((0, import_node_path22.resolve)(trimmed));
+      return (0, import_node_fs21.realpathSync)((0, import_node_path23.resolve)(trimmed));
     } catch {
-      return (0, import_node_path22.resolve)(trimmed);
+      return (0, import_node_path23.resolve)(trimmed);
     }
   })().replace(/\\/g, "/");
   return process.platform === "win32" ? normalized.toLowerCase() : normalized;
@@ -37580,9 +37821,9 @@ function resolveNpmGlobalPrefix(env) {
 function isHomebrewFormulaEntrypoint(entrypoint) {
   const normalized = (() => {
     try {
-      return (0, import_node_fs20.realpathSync)(entrypoint);
+      return (0, import_node_fs21.realpathSync)(entrypoint);
     } catch {
-      return (0, import_node_path22.resolve)(entrypoint);
+      return (0, import_node_path23.resolve)(entrypoint);
     }
   })();
   const parts = normalized.split(/[\\/]+/);
@@ -37592,8 +37833,8 @@ function isHomebrewFormulaEntrypoint(entrypoint) {
 function resolveUpdatePlan(options = {}) {
   const env = options.env ?? process.env;
   const homeDir2 = options.homeDir ?? (0, import_node_os14.homedir)();
-  const entrypoint = options.entrypoint ?? (process.argv[1] ? (0, import_node_path22.resolve)(process.argv[1]) : "");
-  const sourceRoot = entrypoint ? findRepoBackedSdkRoot((0, import_node_path22.dirname)(entrypoint)) : null;
+  const entrypoint = options.entrypoint ?? (process.argv[1] ? (0, import_node_path23.resolve)(process.argv[1]) : "");
+  const sourceRoot = entrypoint ? findRepoBackedSdkRoot((0, import_node_path23.dirname)(entrypoint)) : null;
   if (sourceRoot) {
     return {
       kind: "source",
@@ -37644,9 +37885,9 @@ var AUTO_UPDATE_FAILURE_FILE = ".auto-update-failure.json";
 function autoUpdateFailurePath(plan) {
   if (plan.kind === "source" || plan.kind === "homebrew") return null;
   if (plan.kind === "python-sidecar") {
-    return (0, import_node_path22.join)(plan.stateDir, AUTO_UPDATE_FAILURE_FILE);
+    return (0, import_node_path23.join)(plan.stateDir, AUTO_UPDATE_FAILURE_FILE);
   }
-  return (0, import_node_path22.join)(
+  return (0, import_node_path23.join)(
     (0, import_node_os14.homedir)(),
     ".local",
     "deepline",
@@ -37664,7 +37905,7 @@ function readAutoUpdateFailure(plan) {
   if (!path) return null;
   try {
     const parsed = JSON.parse(
-      (0, import_node_fs20.readFileSync)(path, "utf8")
+      (0, import_node_fs21.readFileSync)(path, "utf8")
     );
     if ((parsed.kind === "npm-global" || parsed.kind === "python-sidecar") && typeof parsed.packageSpec === "string" && typeof parsed.failedAt === "string" && typeof parsed.exitCode === "number" && typeof parsed.manualCommand === "string") {
       return parsed;
@@ -37685,8 +37926,8 @@ function writeAutoUpdateFailure(plan, exitCode) {
     manualCommand: plan.manualCommand
   };
   try {
-    (0, import_node_fs20.mkdirSync)((0, import_node_path22.dirname)(path), { recursive: true });
-    (0, import_node_fs20.writeFileSync)(path, `${JSON.stringify(marker, null, 2)}
+    (0, import_node_fs21.mkdirSync)((0, import_node_path23.dirname)(path), { recursive: true });
+    (0, import_node_fs21.writeFileSync)(path, `${JSON.stringify(marker, null, 2)}
 `, "utf8");
   } catch {
   }
@@ -37695,7 +37936,7 @@ function clearAutoUpdateFailure(plan) {
   const path = autoUpdateFailurePath(plan);
   if (!path) return;
   try {
-    (0, import_node_fs20.unlinkSync)(path);
+    (0, import_node_fs21.unlinkSync)(path);
   } catch {
   }
 }
@@ -37733,7 +37974,7 @@ function safeVersionSegment(value) {
   return /^[0-9A-Za-z._-]+$/.test(normalized) ? normalized : "";
 }
 function entryPathInVersionDir(versionDir) {
-  return (0, import_node_path22.join)(
+  return (0, import_node_path23.join)(
     versionDir,
     "node_modules",
     "deepline",
@@ -37743,14 +37984,14 @@ function entryPathInVersionDir(versionDir) {
   );
 }
 function installedPackageVersion(versionDir) {
-  const packageJsonPath = (0, import_node_path22.join)(
+  const packageJsonPath = (0, import_node_path23.join)(
     versionDir,
     "node_modules",
     "deepline",
     "package.json"
   );
   try {
-    const parsed = JSON.parse((0, import_node_fs20.readFileSync)(packageJsonPath, "utf8"));
+    const parsed = JSON.parse((0, import_node_fs21.readFileSync)(packageJsonPath, "utf8"));
     return typeof parsed.version === "string" ? safeVersionSegment(parsed.version) : "";
   } catch {
     return "";
@@ -37865,20 +38106,20 @@ async function runNpmInstallWithRegistryFallback(input2) {
   return first.exitCode;
 }
 function writeSidecarLauncher(input2) {
-  (0, import_node_fs20.mkdirSync)((0, import_node_path22.dirname)(input2.path), { recursive: true });
-  const packageRoot = (0, import_node_path22.dirname)((0, import_node_path22.dirname)((0, import_node_path22.dirname)(input2.entryPath)));
-  const versionDir = (0, import_node_path22.dirname)((0, import_node_path22.dirname)(packageRoot));
+  (0, import_node_fs21.mkdirSync)((0, import_node_path23.dirname)(input2.path), { recursive: true });
+  const packageRoot = (0, import_node_path23.dirname)((0, import_node_path23.dirname)((0, import_node_path23.dirname)(input2.entryPath)));
+  const versionDir = (0, import_node_path23.dirname)((0, import_node_path23.dirname)(packageRoot));
   const esbuildProbe = "const {createRequire}=require('node:module');const path=require('node:path');const req=createRequire(path.join(process.argv[1],'package.json'));const result=req('esbuild').transformSync('const value: number = 1;',{loader:'ts'});if(!result||typeof result.code!=='string')process.exit(3);";
   const criticalPaths = [
     ...SDK_SIDECAR_CRITICAL_PACKAGE_FILES.map(
-      (path) => (0, import_node_path22.join)(packageRoot, path)
+      (path) => (0, import_node_path23.join)(packageRoot, path)
     ),
     ...SDK_SIDECAR_CRITICAL_DEPENDENCY_FILES.map(
-      (path) => (0, import_node_path22.join)(versionDir, "node_modules", path)
+      (path) => (0, import_node_path23.join)(versionDir, "node_modules", path)
     )
   ];
   if (process.platform === "win32") {
-    (0, import_node_fs20.writeFileSync)(
+    (0, import_node_fs21.writeFileSync)(
       input2.path,
       [
         `@set DEEPLINE_HOST_URL=${input2.hostUrl.replace(/\r?\n/g, "")}`,
@@ -37901,7 +38142,7 @@ function writeSidecarLauncher(input2) {
     );
     return;
   }
-  (0, import_node_fs20.writeFileSync)(
+  (0, import_node_fs21.writeFileSync)(
     input2.path,
     [
       "#!/usr/bin/env sh",
@@ -37928,17 +38169,17 @@ function writeSidecarLauncher(input2) {
   );
 }
 async function runPythonSidecarUpdatePlan(plan) {
-  const versionsDir = (0, import_node_path22.join)(plan.stateDir, "versions");
-  const tempDir = (0, import_node_path22.join)(
+  const versionsDir = (0, import_node_path23.join)(plan.stateDir, "versions");
+  const tempDir = (0, import_node_path23.join)(
     versionsDir,
     `.tmp-sdk-update-${process.pid}-${Date.now()}`
   );
-  (0, import_node_fs20.rmSync)(tempDir, { recursive: true, force: true });
-  (0, import_node_fs20.mkdirSync)(tempDir, { recursive: true });
-  (0, import_node_fs20.writeFileSync)((0, import_node_path22.join)(tempDir, "package.json"), NPM_SDK_SIDECAR_PACKAGE_JSON);
+  (0, import_node_fs21.rmSync)(tempDir, { recursive: true, force: true });
+  (0, import_node_fs21.mkdirSync)(tempDir, { recursive: true });
+  (0, import_node_fs21.writeFileSync)((0, import_node_path23.join)(tempDir, "package.json"), NPM_SDK_SIDECAR_PACKAGE_JSON);
   const env = {
     ...process.env,
-    PATH: `${(0, import_node_path22.dirname)(plan.nodeBin)}${process.platform === "win32" ? ";" : ":"}${process.env.PATH ?? ""}`
+    PATH: `${(0, import_node_path23.dirname)(plan.nodeBin)}${process.platform === "win32" ? ";" : ":"}${process.env.PATH ?? ""}`
   };
   const installResult = await runCommand(
     plan.npmCommand,
@@ -37955,7 +38196,7 @@ async function runPythonSidecarUpdatePlan(plan) {
   );
   const installExitCode = installResult.exitCode;
   if (installExitCode !== 0) {
-    (0, import_node_fs20.rmSync)(tempDir, { recursive: true, force: true });
+    (0, import_node_fs21.rmSync)(tempDir, { recursive: true, force: true });
     return installExitCode;
   }
   const installedVersion = installedPackageVersion(tempDir);
@@ -37963,7 +38204,7 @@ async function runPythonSidecarUpdatePlan(plan) {
     process.stderr.write(
       "Updated Deepline SDK package did not report a version.\n"
     );
-    (0, import_node_fs20.rmSync)(tempDir, { recursive: true, force: true });
+    (0, import_node_fs21.rmSync)(tempDir, { recursive: true, force: true });
     return 1;
   }
   const stagedFailure = sidecarInstallFailure(tempDir);
@@ -37972,32 +38213,32 @@ async function runPythonSidecarUpdatePlan(plan) {
       `Updated Deepline SDK package is incomplete: ${stagedFailure}.
 `
     );
-    (0, import_node_fs20.rmSync)(tempDir, { recursive: true, force: true });
+    (0, import_node_fs21.rmSync)(tempDir, { recursive: true, force: true });
     return 1;
   }
-  const finalDir = (0, import_node_path22.join)(versionsDir, installedVersion);
+  const finalDir = (0, import_node_path23.join)(versionsDir, installedVersion);
   const finalEntryPath = entryPathInVersionDir(finalDir);
   const finalFailure = sidecarInstallFailure(finalDir);
   let backupDir = null;
   if (!finalFailure) {
-    (0, import_node_fs20.rmSync)(tempDir, { recursive: true, force: true });
+    (0, import_node_fs21.rmSync)(tempDir, { recursive: true, force: true });
   } else {
     let shouldPublishTemp = true;
-    if ((0, import_node_fs20.existsSync)(finalDir)) {
-      backupDir = (0, import_node_path22.join)(
+    if ((0, import_node_fs21.existsSync)(finalDir)) {
+      backupDir = (0, import_node_path23.join)(
         versionsDir,
         `.backup-${installedVersion}-${process.pid}-${Date.now()}`
       );
       try {
-        (0, import_node_fs20.renameSync)(finalDir, backupDir);
+        (0, import_node_fs21.renameSync)(finalDir, backupDir);
       } catch (error) {
         const concurrentlyPublishedFailure = sidecarInstallFailure(finalDir);
         if (!concurrentlyPublishedFailure) {
-          (0, import_node_fs20.rmSync)(tempDir, { recursive: true, force: true });
+          (0, import_node_fs21.rmSync)(tempDir, { recursive: true, force: true });
           backupDir = null;
           shouldPublishTemp = false;
         } else {
-          (0, import_node_fs20.rmSync)(tempDir, { recursive: true, force: true });
+          (0, import_node_fs21.rmSync)(tempDir, { recursive: true, force: true });
           process.stderr.write(
             `Failed to preserve the incomplete Deepline SDK sidecar before repair: ${error.message}.
 `
@@ -38008,18 +38249,18 @@ async function runPythonSidecarUpdatePlan(plan) {
     }
     if (shouldPublishTemp) {
       try {
-        (0, import_node_fs20.renameSync)(tempDir, finalDir);
+        (0, import_node_fs21.renameSync)(tempDir, finalDir);
       } catch (error) {
-        (0, import_node_fs20.rmSync)(tempDir, { recursive: true, force: true });
+        (0, import_node_fs21.rmSync)(tempDir, { recursive: true, force: true });
         const concurrentlyPublishedFailure = sidecarInstallFailure(finalDir);
         if (!concurrentlyPublishedFailure) {
-          if (backupDir) (0, import_node_fs20.rmSync)(backupDir, { recursive: true, force: true });
+          if (backupDir) (0, import_node_fs21.rmSync)(backupDir, { recursive: true, force: true });
           backupDir = null;
         } else {
           let restoreFailure = "";
-          if (backupDir && (0, import_node_fs20.existsSync)(backupDir) && !(0, import_node_fs20.existsSync)(finalDir)) {
+          if (backupDir && (0, import_node_fs21.existsSync)(backupDir) && !(0, import_node_fs21.existsSync)(finalDir)) {
             try {
-              (0, import_node_fs20.renameSync)(backupDir, finalDir);
+              (0, import_node_fs21.renameSync)(backupDir, finalDir);
               backupDir = null;
             } catch (restoreError) {
               restoreFailure = `; failed to restore previous install: ${restoreError.message}`;
@@ -38036,10 +38277,10 @@ async function runPythonSidecarUpdatePlan(plan) {
   }
   const publishedFailure = sidecarStructureFailure(finalDir);
   if (publishedFailure) {
-    if (backupDir && (0, import_node_fs20.existsSync)(backupDir)) {
-      (0, import_node_fs20.rmSync)(finalDir, { recursive: true, force: true });
+    if (backupDir && (0, import_node_fs21.existsSync)(backupDir)) {
+      (0, import_node_fs21.rmSync)(finalDir, { recursive: true, force: true });
       try {
-        (0, import_node_fs20.renameSync)(backupDir, finalDir);
+        (0, import_node_fs21.renameSync)(backupDir, finalDir);
         backupDir = null;
       } catch {
       }
@@ -38050,7 +38291,7 @@ async function runPythonSidecarUpdatePlan(plan) {
     );
     return 1;
   }
-  if (backupDir) (0, import_node_fs20.rmSync)(backupDir, { recursive: true, force: true });
+  if (backupDir) (0, import_node_fs21.rmSync)(backupDir, { recursive: true, force: true });
   writeSidecarLauncher({
     path: plan.sidecarPath,
     hostUrl: plan.hostUrl,
@@ -38058,28 +38299,28 @@ async function runPythonSidecarUpdatePlan(plan) {
     nodeBin: plan.nodeBin,
     entryPath: finalEntryPath
   });
-  (0, import_node_fs20.writeFileSync)(
-    (0, import_node_path22.join)(plan.stateDir, ".version"),
+  (0, import_node_fs21.writeFileSync)(
+    (0, import_node_path23.join)(plan.stateDir, ".version"),
     `${installedVersion}
 `,
     "utf8"
   );
-  (0, import_node_fs20.writeFileSync)(
-    (0, import_node_path22.join)(plan.stateDir, ".install-method"),
+  (0, import_node_fs21.writeFileSync)(
+    (0, import_node_path23.join)(plan.stateDir, ".install-method"),
     "python-sidecar\n",
     "utf8"
   );
-  (0, import_node_fs20.writeFileSync)(
-    (0, import_node_path22.join)(plan.stateDir, ".command-path"),
+  (0, import_node_fs21.writeFileSync)(
+    (0, import_node_path23.join)(plan.stateDir, ".command-path"),
     `${plan.sidecarPath}
 `,
     "utf8"
   );
-  (0, import_node_fs20.writeFileSync)((0, import_node_path22.join)(plan.stateDir, ".runner"), "node\n", "utf8");
-  (0, import_node_fs20.writeFileSync)((0, import_node_path22.join)(plan.stateDir, ".node-bin"), `${plan.nodeBin}
+  (0, import_node_fs21.writeFileSync)((0, import_node_path23.join)(plan.stateDir, ".runner"), "node\n", "utf8");
+  (0, import_node_fs21.writeFileSync)((0, import_node_path23.join)(plan.stateDir, ".node-bin"), `${plan.nodeBin}
 `, "utf8");
-  (0, import_node_fs20.writeFileSync)(
-    (0, import_node_path22.join)(plan.stateDir, ".entry-path"),
+  (0, import_node_fs21.writeFileSync)(
+    (0, import_node_path23.join)(plan.stateDir, ".entry-path"),
     `${finalEntryPath}
 `,
     "utf8"
@@ -39006,14 +39247,14 @@ chooses the connected Slack channel or member and the events it receives.
 
 // src/cli/commands/tools.ts
 var import_commander3 = require("commander");
-var import_node_fs22 = require("fs");
+var import_node_fs23 = require("fs");
 var import_node_os16 = require("os");
-var import_node_path24 = require("path");
+var import_node_path25 = require("path");
 
 // src/tool-output.ts
-var import_node_fs21 = require("fs");
+var import_node_fs22 = require("fs");
 var import_node_os15 = require("os");
-var import_node_path23 = require("path");
+var import_node_path24 = require("path");
 function isPlainObject(value) {
   return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
@@ -39140,19 +39381,19 @@ function projectRowOutput(conversion) {
   };
 }
 function ensureOutputDir() {
-  const outputDir = (0, import_node_path23.join)((0, import_node_os15.homedir)(), ".local", "share", "deepline", "data");
-  (0, import_node_fs21.mkdirSync)(outputDir, { recursive: true });
+  const outputDir = (0, import_node_path24.join)((0, import_node_os15.homedir)(), ".local", "share", "deepline", "data");
+  (0, import_node_fs22.mkdirSync)(outputDir, { recursive: true });
   return outputDir;
 }
 function writeJsonOutputFile(payload, stem) {
   const outputDir = ensureOutputDir();
-  const outputPath = (0, import_node_path23.join)(outputDir, `${stem}_${Date.now()}.json`);
-  (0, import_node_fs21.writeFileSync)(outputPath, JSON.stringify(payload, null, 2), "utf-8");
+  const outputPath = (0, import_node_path24.join)(outputDir, `${stem}_${Date.now()}.json`);
+  (0, import_node_fs22.writeFileSync)(outputPath, JSON.stringify(payload, null, 2), "utf-8");
   return outputPath;
 }
 function writeCsvOutputFile(rows, stem, options) {
-  const outputPath = options?.outPath ? options.outPath : (0, import_node_path23.join)(ensureOutputDir(), `${stem}_${Date.now()}.csv`);
-  (0, import_node_fs21.mkdirSync)((0, import_node_path23.dirname)(outputPath), { recursive: true });
+  const outputPath = options?.outPath ? options.outPath : (0, import_node_path24.join)(ensureOutputDir(), `${stem}_${Date.now()}.csv`);
+  (0, import_node_fs22.mkdirSync)((0, import_node_path24.dirname)(outputPath), { recursive: true });
   const columns = columnsForRows(rows);
   const escapeCell = (value) => {
     const normalized = value == null ? "" : typeof value === "string" || typeof value === "number" || typeof value === "boolean" ? String(value) : JSON.stringify(value);
@@ -39161,19 +39402,19 @@ function writeCsvOutputFile(rows, stem, options) {
     }
     return normalized;
   };
-  const fd = (0, import_node_fs21.openSync)(outputPath, "w");
+  const fd = (0, import_node_fs22.openSync)(outputPath, "w");
   try {
-    (0, import_node_fs21.writeSync)(fd, `${columns.map(escapeCell).join(",")}
+    (0, import_node_fs22.writeSync)(fd, `${columns.map(escapeCell).join(",")}
 `);
     for (const row of rows) {
-      (0, import_node_fs21.writeSync)(
+      (0, import_node_fs22.writeSync)(
         fd,
         `${columns.map((column) => escapeCell(row[column])).join(",")}
 `
       );
     }
   } finally {
-    (0, import_node_fs21.closeSync)(fd);
+    (0, import_node_fs22.closeSync)(fd);
   }
   const previewRows = rows.slice(0, 5);
   const previewColumns = columns.slice(0, 5);
@@ -39295,6 +39536,78 @@ function arrayField(value, key) {
   return Array.isArray(candidate) ? candidate : [];
 }
 
+// src/cli/tool-description.ts
+var Capability = class _Capability {
+  #catalogEntry;
+  constructor(catalogEntry) {
+    this.#catalogEntry = catalogEntry;
+  }
+  static fromCatalogEntry(catalogEntry) {
+    return new _Capability(catalogEntry);
+  }
+  describe() {
+    return CapabilityDescription.fromCatalogEntry(this.#catalogEntry);
+  }
+};
+var CapabilityDescription = class _CapabilityDescription {
+  #catalogEntry;
+  constructor(catalogEntry) {
+    this.#catalogEntry = catalogEntry;
+  }
+  static fromCatalogEntry(catalogEntry) {
+    return new _CapabilityDescription(catalogEntry);
+  }
+  /**
+   * The customer price already resolved by the catalog. This intentionally
+   * omits provider-price fields, even when a catalog Adapter carried them.
+   */
+  customerCost() {
+    const legacyCost = recordValue2(this.#catalogEntry.cost);
+    const pricing = recordValue2(this.#catalogEntry.pricing);
+    const unit = stringValue4(pricing.unit);
+    const legacyPricingModel = stringValue4(
+      legacyCost.pricingModel ?? legacyCost.pricing_model
+    );
+    const pricingModel = unit === "call" ? "fixed" : unit === "result" || unit === "page" ? `per_${unit}` : unit === "usage" ? "provider_usage" : legacyPricingModel;
+    const canonicalCredits = numberValue(
+      pricing.creditsPerUnit ?? pricing.credits_per_unit
+    );
+    const canonicalUsd = numberValue(
+      pricing.usdPerUnit ?? pricing.usd_per_unit
+    );
+    return {
+      pricingModel: pricingModel || null,
+      unit: unit || null,
+      displayText: stringValue4(pricing.displayText ?? pricing.display_text),
+      summary: stringValue4(pricing.summary),
+      billingMode: stringValue4(
+        legacyCost.billingMode ?? legacyCost.billing_mode
+      ),
+      billingSource: stringValue4(
+        this.#catalogEntry.billingSource ?? this.#catalogEntry.billing_source
+      ),
+      billingSourceLabel: stringValue4(
+        this.#catalogEntry.billingSourceLabel ?? this.#catalogEntry.billing_source_label
+      ),
+      deeplineCreditsPerPricingUnit: canonicalCredits ?? numberValue(
+        this.#catalogEntry.deeplineCreditsPerPricingUnit ?? this.#catalogEntry.deepline_credits_per_pricing_unit
+      ),
+      deeplineUsdPerPricingUnit: canonicalUsd ?? numberValue(
+        this.#catalogEntry.deeplineUsdPerPricingUnit ?? this.#catalogEntry.deepline_usd_per_pricing_unit
+      )
+    };
+  }
+};
+function recordValue2(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function stringValue4(value) {
+  return typeof value === "string" && value.trim() ? value : null;
+}
+function numberValue(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+
 // src/cli/commands/tools.ts
 var TOOL_COMMAND_TEMPLATES = {
   describe: "deepline tools describe <toolId>",
@@ -40215,7 +40528,7 @@ function toolContractJsonForDescribe(tool, requestedToolId) {
   const extractedValues = extractionContractEntries(
     arrayField2(toolExecutionResult, "extractedValues", "extracted_values")
   );
-  const pricing = toolPricingContractForDescribe(tool);
+  const pricing = Capability.fromCatalogEntry(tool).describe().customerCost();
   const deprecation = recordField2(tool, "deprecation");
   const replacementToolId = stringField2(
     deprecation,
@@ -40266,38 +40579,6 @@ function toolContractJsonForDescribe(tool, requestedToolId) {
     ...starterScript ? { starterScript } : {}
   };
 }
-function toolPricingContractForDescribe(tool) {
-  const legacyCost = recordField2(tool, "cost");
-  const pricingValue = tool.pricing;
-  const hasCanonicalPricing = isRecord12(pricingValue);
-  const canonicalPricing = hasCanonicalPricing ? pricingValue : {};
-  const unit = stringField2(canonicalPricing, "unit");
-  const legacyPricingModel = stringField2(
-    legacyCost,
-    "pricingModel",
-    "pricing_model"
-  );
-  const pricingModel = unit === "call" ? "fixed" : unit === "result" || unit === "page" ? `per_${unit}` : unit === "usage" ? "provider_usage" : legacyPricingModel;
-  return {
-    pricingModel: pricingModel || null,
-    unit: unit || null,
-    displayText: stringField2(canonicalPricing, "displayText", "display_text") || null,
-    summary: stringField2(canonicalPricing, "summary") || null,
-    billingMode: stringField2(legacyCost, "billingMode", "billing_mode") || null,
-    billingSource: stringField2(tool, "billingSource", "billing_source") || null,
-    billingSourceLabel: stringField2(tool, "billingSourceLabel", "billing_source_label") || null,
-    deeplineCreditsPerPricingUnit: hasCanonicalPricing ? numberField2(canonicalPricing, "creditsPerUnit", "credits_per_unit") : numberField2(
-      tool,
-      "deeplineCreditsPerPricingUnit",
-      "deepline_credits_per_pricing_unit"
-    ),
-    deeplineUsdPerPricingUnit: hasCanonicalPricing ? numberField2(canonicalPricing, "usdPerUnit", "usd_per_unit") : numberField2(
-      tool,
-      "deeplineUsdPerPricingUnit",
-      "deepline_usd_per_pricing_unit"
-    )
-  };
-}
 function extractionContractEntries(entries) {
   return entries.flatMap((entry) => {
     if (!isRecord12(entry)) return [];
@@ -40750,6 +41031,7 @@ function toolMetadataJsonForDescribe(tool, requestedToolId) {
     toolId,
     provider: tool.provider,
     displayName: tool.displayName,
+    cost: Capability.fromCatalogEntry(tool).describe().customerCost(),
     usageGuidance,
     runtimeOutputHelp: {
       contract: "tools describe shows declared schema and Deepline getters; it is not an observed provider response.",
@@ -41080,11 +41362,11 @@ function normalizeOutputFormat(raw) {
 }
 function resolveAtFilePath(rawPath) {
   const trimmed = rawPath.trim();
-  const resolved = (0, import_node_path24.resolve)(trimmed);
-  if ((0, import_node_fs22.existsSync)(resolved)) return resolved;
+  const resolved = (0, import_node_path25.resolve)(trimmed);
+  if ((0, import_node_fs23.existsSync)(resolved)) return resolved;
   if (process.platform !== "win32" && trimmed.includes("\\")) {
-    const normalized = (0, import_node_path24.resolve)(trimmed.replace(/\\/g, "/"));
-    if ((0, import_node_fs22.existsSync)(normalized)) return normalized;
+    const normalized = (0, import_node_path25.resolve)(trimmed.replace(/\\/g, "/"));
+    if ((0, import_node_fs23.existsSync)(normalized)) return normalized;
   }
   return resolved;
 }
@@ -41095,7 +41377,7 @@ function readJsonArgument(raw, flagName) {
     throw new Error(`Invalid ${flagName} value: empty @file path.`);
   }
   try {
-    return (0, import_node_fs22.readFileSync)(resolveAtFilePath(filePath), "utf8").replace(
+    return (0, import_node_fs23.readFileSync)(resolveAtFilePath(filePath), "utf8").replace(
       /^\uFEFF/,
       ""
     );
@@ -41172,7 +41454,7 @@ function parseExecuteOptions(args) {
       continue;
     }
     if ((arg === "--out" || arg === "-o") && args[index + 1]) {
-      outPath = (0, import_node_path24.resolve)(args[++index]);
+      outPath = (0, import_node_path25.resolve)(args[++index]);
       continue;
     }
     throw new Error(`Unknown option: ${arg}`);
@@ -41202,9 +41484,9 @@ function starterScriptJson(script) {
 function seedToolListScript(input2) {
   const stem = safeFileStem(input2.toolId);
   const fileName = `${stem}-workflow-seed-${Date.now()}.play.ts`;
-  const scriptDir = (0, import_node_fs22.mkdtempSync)((0, import_node_path24.join)((0, import_node_os16.tmpdir)(), "deepline-workflow-seed-"));
-  (0, import_node_fs22.chmodSync)(scriptDir, 448);
-  const scriptPath = (0, import_node_path24.join)(scriptDir, fileName);
+  const scriptDir = (0, import_node_fs23.mkdtempSync)((0, import_node_path25.join)((0, import_node_os16.tmpdir)(), "deepline-workflow-seed-"));
+  (0, import_node_fs23.chmodSync)(scriptDir, 448);
+  const scriptPath = (0, import_node_path25.join)(scriptDir, fileName);
   const projectDir = `deepline/projects/${stem}-workflow`;
   const playName = `${stem}-workflow`;
   const sampleRows = input2.rows.length > 0 ? `${JSON.stringify(input2.rows.slice(0, 2)).replace(/\]$/, "")}, ...]` : "[]";
@@ -41247,7 +41529,7 @@ export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
   description: ${JSON.stringify(`Seed ${input2.toolId} rows into a Deepline workflow-ready dataset.`)},
 });
 `;
-  (0, import_node_fs22.writeFileSync)(scriptPath, script, { encoding: "utf-8", mode: 384 });
+  (0, import_node_fs23.writeFileSync)(scriptPath, script, { encoding: "utf-8", mode: 384 });
   return {
     path: scriptPath,
     sourceCode: script,
@@ -41673,7 +41955,7 @@ Examples:
 
 // src/cli/commands/workflow.ts
 var import_promises9 = require("fs/promises");
-var import_node_path25 = require("path");
+var import_node_path26 = require("path");
 
 // src/cli/workflow-to-play.ts
 var import_node_crypto8 = require("crypto");
@@ -41890,7 +42172,7 @@ function readStatus(payload) {
 }
 async function readJsonOption(payload, file) {
   if (file) {
-    const raw = await (0, import_promises9.readFile)((0, import_node_path25.resolve)(file), "utf8");
+    const raw = await (0, import_promises9.readFile)((0, import_node_path26.resolve)(file), "utf8");
     return JSON.parse(raw);
   }
   if (payload) {
@@ -41924,8 +42206,8 @@ async function transformOne(api, workflowId, outDir, publish) {
       revision.config,
       { workflowName: workflow.name, version: revision.version }
     );
-    const file = (0, import_node_path25.join)((0, import_node_path25.resolve)(outDir), `${compiled.playName}.play.ts`);
-    await (0, import_promises9.mkdir)((0, import_node_path25.dirname)(file), { recursive: true });
+    const file = (0, import_node_path26.join)((0, import_node_path26.resolve)(outDir), `${compiled.playName}.play.ts`);
+    await (0, import_promises9.mkdir)((0, import_node_path26.dirname)(file), { recursive: true });
     await (0, import_promises9.writeFile)(file, compiled.sourceCode, "utf8");
     let published = false;
     if (publish) {
@@ -42300,7 +42582,7 @@ function isDowngradeAutoUpdateResponse(response) {
   return compareSemver(target, current) < 0;
 }
 function relaunchCurrentCommand(plan) {
-  return new Promise((resolve19) => {
+  return new Promise((resolve20) => {
     const command = plan.kind === "python-sidecar" ? plan.sidecarPath : process.execPath;
     const args = plan.kind === "python-sidecar" ? process.argv.slice(2) : process.argv.slice(1);
     const child = (0, import_node_child_process6.spawn)(command, args, {
@@ -42316,9 +42598,9 @@ function relaunchCurrentCommand(plan) {
         `Deepline SDK/CLI updated, but relaunch failed: ${error.message}
 `
       );
-      resolve19(1);
+      resolve20(1);
     });
-    child.on("close", (code) => resolve19(code ?? 1));
+    child.on("close", (code) => resolve20(code ?? 1));
   });
 }
 async function maybeAutoUpdateAndRelaunch(response, baseUrl) {
@@ -42709,8 +42991,8 @@ function topLevelCommandKnown(program, commandName) {
   );
 }
 async function runPlayRunnerHealthCheck() {
-  const dir = await (0, import_promises10.mkdtemp)((0, import_node_path26.join)((0, import_node_os18.tmpdir)(), "deepline-health-play-"));
-  const file = (0, import_node_path26.join)(dir, "health-check.play.ts");
+  const dir = await (0, import_promises10.mkdtemp)((0, import_node_path27.join)((0, import_node_os18.tmpdir)(), "deepline-health-play-"));
+  const file = (0, import_node_path27.join)(dir, "health-check.play.ts");
   try {
     await (0, import_promises10.writeFile)(
       file,