deepline 0.1.124 → 0.1.126

package/dist/bundling-sources/sdk/src/release.ts

@@ -101,10 +101,10 @@ export const SDK_RELEASE = {
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
   // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
-  version: '0.1.124',
+  version: '0.1.126',
   apiContract: '2026-06-dataset-column-cell-stale-hard-cutover',
   supportPolicy: {
-    latest: '0.1.124',
+    latest: '0.1.126',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

package/dist/cli/index.js

@@ -404,10 +404,10 @@ var SDK_RELEASE = {
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
   // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
-  version: "0.1.124",
+  version: "0.1.126",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.124",
+    latest: "0.1.126",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -21329,6 +21329,27 @@ function findRepoBackedSdkRoot(startPath) {
     current = parent;
   }
 }
+function inferNpmGlobalPrefixFromEntrypoint(entrypoint) {
+  const normalized = (() => {
+    try {
+      return (0, import_node_fs14.realpathSync)(entrypoint);
+    } catch {
+      return (0, import_node_path17.resolve)(entrypoint);
+    }
+  })();
+  const parts = normalized.split(/[\\/]+/);
+  const nodeModulesIndex = parts.lastIndexOf("node_modules");
+  if (nodeModulesIndex <= 0 || parts[nodeModulesIndex + 1] !== "deepline") {
+    return null;
+  }
+  const prefixParts = parts.slice(0, nodeModulesIndex);
+  if (prefixParts.at(-1) !== "lib") {
+    return null;
+  }
+  prefixParts.pop();
+  const prefix = normalized.startsWith("/") && prefixParts[0] !== "" ? `/${prefixParts.join("/")}` : prefixParts.join("/");
+  return prefix || null;
+}
 function resolveUpdatePlan(options = {}) {
   const env = options.env ?? process.env;
   const homeDir2 = options.homeDir ?? (0, import_node_os12.homedir)();
@@ -21350,14 +21371,102 @@ function resolveUpdatePlan(options = {}) {
   if (sidecarPlan) return sidecarPlan;
   const command = "npm";
   const packageSpec = options.packageSpec || "deepline@latest";
-  const args = ["install", "-g", packageSpec];
+  const installPrefix = entrypoint ? inferNpmGlobalPrefixFromEntrypoint(entrypoint) : null;
+  const args = installPrefix ? ["install", "-g", "--prefix", installPrefix, packageSpec] : ["install", "-g", packageSpec];
   return {
     kind: "npm-global",
     command,
     args,
+    ...installPrefix ? { installPrefix } : {},
     manualCommand: `${command} ${args.map(shellQuote3).join(" ")}`
   };
 }
+var AUTO_UPDATE_FAILURE_FILE = ".auto-update-failure.json";
+function autoUpdateFailurePath(plan) {
+  if (plan.kind === "source") return null;
+  if (plan.kind === "python-sidecar") {
+    return (0, import_node_path17.join)(plan.stateDir, AUTO_UPDATE_FAILURE_FILE);
+  }
+  return (0, import_node_path17.join)(
+    (0, import_node_os12.homedir)(),
+    ".local",
+    "deepline",
+    "sdk-cli",
+    AUTO_UPDATE_FAILURE_FILE
+  );
+}
+function autoUpdatePackageSpec(plan) {
+  if (plan.kind === "source") return "";
+  if (plan.kind === "python-sidecar") return plan.packageSpec;
+  return plan.args[plan.args.length - 1] ?? plan.manualCommand;
+}
+function readAutoUpdateFailure(plan) {
+  const path = autoUpdateFailurePath(plan);
+  if (!path) return null;
+  try {
+    const parsed = JSON.parse(
+      (0, import_node_fs14.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;
+    }
+  } catch {
+    return null;
+  }
+  return null;
+}
+function writeAutoUpdateFailure(plan, exitCode) {
+  const path = autoUpdateFailurePath(plan);
+  if (!path || plan.kind === "source") return;
+  const marker = {
+    kind: plan.kind,
+    packageSpec: autoUpdatePackageSpec(plan),
+    failedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    exitCode,
+    manualCommand: plan.manualCommand
+  };
+  try {
+    (0, import_node_fs14.mkdirSync)((0, import_node_path17.dirname)(path), { recursive: true });
+    (0, import_node_fs14.writeFileSync)(path, `${JSON.stringify(marker, null, 2)}
+`, "utf8");
+  } catch {
+  }
+}
+function clearAutoUpdateFailure(plan) {
+  const path = autoUpdateFailurePath(plan);
+  if (!path) return;
+  try {
+    (0, import_node_fs14.unlinkSync)(path);
+  } catch {
+  }
+}
+function matchingAutoUpdateFailure(plan) {
+  const marker = readAutoUpdateFailure(plan);
+  if (!marker || plan.kind === "source") return null;
+  if (marker.kind !== plan.kind) return null;
+  if (marker.packageSpec !== autoUpdatePackageSpec(plan)) return null;
+  return marker;
+}
+async function runAutomaticUpdatePlan(plan) {
+  const previousFailure = matchingAutoUpdateFailure(plan);
+  if (previousFailure) {
+    process.stderr.write(
+      [
+        "Skipping Deepline SDK/CLI auto-update because this same update already failed on this machine.",
+        `Fix Node/npm native package installation issues, then run: ${previousFailure.manualCommand}`,
+        "Common causes include broken esbuild installs, node-gyp build toolchain errors, npm cache corruption, or registry/network failures.",
+        ""
+      ].join("\n")
+    );
+    return {
+      status: "skipped_previous_failure",
+      exitCode: previousFailure.exitCode || 1,
+      previousFailure
+    };
+  }
+  const exitCode = await runUpdatePlan(plan);
+  return exitCode === 0 ? { status: "updated", exitCode: 0 } : { status: "failed", exitCode };
+}
 function safeVersionSegment(value) {
   const normalized = value.trim();
   return /^[0-9A-Za-z._-]+$/.test(normalized) ? normalized : "";
@@ -21527,13 +21636,18 @@ async function runPythonSidecarUpdatePlan(plan) {
   return 0;
 }
 async function runUpdatePlan(plan) {
+  let exitCode = 1;
   if (plan.kind === "npm-global") {
-    return runCommand(plan.command, plan.args);
+    exitCode = await runCommand(plan.command, plan.args);
+  } else if (plan.kind === "python-sidecar") {
+    exitCode = await runPythonSidecarUpdatePlan(plan);
   }
-  if (plan.kind === "python-sidecar") {
-    return runPythonSidecarUpdatePlan(plan);
+  if (exitCode === 0) {
+    clearAutoUpdateFailure(plan);
+  } else {
+    writeAutoUpdateFailure(plan, exitCode);
   }
-  return 1;
+  return exitCode;
 }
 async function handleUpdate(options) {
   const plan = resolveUpdatePlan();
@@ -21842,15 +21956,18 @@ async function maybeAutoUpdateAndRelaunch(response) {
     `Deepline SDK/CLI ${label}; running ${plan.manualCommand}
 `
   );
-  const updateExitCode = await runUpdatePlan(plan);
-  if (updateExitCode !== 0) {
+  const updateResult = await runAutomaticUpdatePlan(plan);
+  if (updateResult.status === "skipped_previous_failure") {
+    return false;
+  }
+  if (updateResult.exitCode !== 0) {
     if (autoUpdate.required) {
       throw new Error(
-        `Automatic Deepline SDK/CLI update failed with exit code ${updateExitCode}. ${response.message}`
+        `Automatic Deepline SDK/CLI update failed with exit code ${updateResult.exitCode}. ${response.message}`
       );
     }
     process.stderr.write(
-      `Deepline SDK/CLI auto-update failed with exit code ${updateExitCode}; continuing with ${response.current ?? "current version"}.
+      `Deepline SDK/CLI auto-update failed with exit code ${updateResult.exitCode}; continuing with ${response.current ?? "current version"}.
 `
     );
     return false;

package/dist/cli/index.mjs

@@ -381,10 +381,10 @@ var SDK_RELEASE = {
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
   // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
-  version: "0.1.124",
+  version: "0.1.126",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.124",
+    latest: "0.1.126",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -21274,9 +21274,11 @@ import { spawn as spawn2 } from "child_process";
 import {
   existsSync as existsSync10,
   mkdirSync as mkdirSync8,
+  realpathSync as realpathSync2,
   readFileSync as readFileSync10,
   renameSync,
   rmSync as rmSync3,
+  unlinkSync,
   writeFileSync as writeFileSync13
 } from "fs";
 import { homedir as homedir10 } from "os";
@@ -21358,6 +21360,27 @@ function findRepoBackedSdkRoot(startPath) {
     current = parent;
   }
 }
+function inferNpmGlobalPrefixFromEntrypoint(entrypoint) {
+  const normalized = (() => {
+    try {
+      return realpathSync2(entrypoint);
+    } catch {
+      return resolve12(entrypoint);
+    }
+  })();
+  const parts = normalized.split(/[\\/]+/);
+  const nodeModulesIndex = parts.lastIndexOf("node_modules");
+  if (nodeModulesIndex <= 0 || parts[nodeModulesIndex + 1] !== "deepline") {
+    return null;
+  }
+  const prefixParts = parts.slice(0, nodeModulesIndex);
+  if (prefixParts.at(-1) !== "lib") {
+    return null;
+  }
+  prefixParts.pop();
+  const prefix = normalized.startsWith("/") && prefixParts[0] !== "" ? `/${prefixParts.join("/")}` : prefixParts.join("/");
+  return prefix || null;
+}
 function resolveUpdatePlan(options = {}) {
   const env = options.env ?? process.env;
   const homeDir2 = options.homeDir ?? homedir10();
@@ -21379,14 +21402,102 @@ function resolveUpdatePlan(options = {}) {
   if (sidecarPlan) return sidecarPlan;
   const command = "npm";
   const packageSpec = options.packageSpec || "deepline@latest";
-  const args = ["install", "-g", packageSpec];
+  const installPrefix = entrypoint ? inferNpmGlobalPrefixFromEntrypoint(entrypoint) : null;
+  const args = installPrefix ? ["install", "-g", "--prefix", installPrefix, packageSpec] : ["install", "-g", packageSpec];
   return {
     kind: "npm-global",
     command,
     args,
+    ...installPrefix ? { installPrefix } : {},
     manualCommand: `${command} ${args.map(shellQuote3).join(" ")}`
   };
 }
+var AUTO_UPDATE_FAILURE_FILE = ".auto-update-failure.json";
+function autoUpdateFailurePath(plan) {
+  if (plan.kind === "source") return null;
+  if (plan.kind === "python-sidecar") {
+    return join12(plan.stateDir, AUTO_UPDATE_FAILURE_FILE);
+  }
+  return join12(
+    homedir10(),
+    ".local",
+    "deepline",
+    "sdk-cli",
+    AUTO_UPDATE_FAILURE_FILE
+  );
+}
+function autoUpdatePackageSpec(plan) {
+  if (plan.kind === "source") return "";
+  if (plan.kind === "python-sidecar") return plan.packageSpec;
+  return plan.args[plan.args.length - 1] ?? plan.manualCommand;
+}
+function readAutoUpdateFailure(plan) {
+  const path = autoUpdateFailurePath(plan);
+  if (!path) return null;
+  try {
+    const parsed = JSON.parse(
+      readFileSync10(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;
+    }
+  } catch {
+    return null;
+  }
+  return null;
+}
+function writeAutoUpdateFailure(plan, exitCode) {
+  const path = autoUpdateFailurePath(plan);
+  if (!path || plan.kind === "source") return;
+  const marker = {
+    kind: plan.kind,
+    packageSpec: autoUpdatePackageSpec(plan),
+    failedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    exitCode,
+    manualCommand: plan.manualCommand
+  };
+  try {
+    mkdirSync8(dirname10(path), { recursive: true });
+    writeFileSync13(path, `${JSON.stringify(marker, null, 2)}
+`, "utf8");
+  } catch {
+  }
+}
+function clearAutoUpdateFailure(plan) {
+  const path = autoUpdateFailurePath(plan);
+  if (!path) return;
+  try {
+    unlinkSync(path);
+  } catch {
+  }
+}
+function matchingAutoUpdateFailure(plan) {
+  const marker = readAutoUpdateFailure(plan);
+  if (!marker || plan.kind === "source") return null;
+  if (marker.kind !== plan.kind) return null;
+  if (marker.packageSpec !== autoUpdatePackageSpec(plan)) return null;
+  return marker;
+}
+async function runAutomaticUpdatePlan(plan) {
+  const previousFailure = matchingAutoUpdateFailure(plan);
+  if (previousFailure) {
+    process.stderr.write(
+      [
+        "Skipping Deepline SDK/CLI auto-update because this same update already failed on this machine.",
+        `Fix Node/npm native package installation issues, then run: ${previousFailure.manualCommand}`,
+        "Common causes include broken esbuild installs, node-gyp build toolchain errors, npm cache corruption, or registry/network failures.",
+        ""
+      ].join("\n")
+    );
+    return {
+      status: "skipped_previous_failure",
+      exitCode: previousFailure.exitCode || 1,
+      previousFailure
+    };
+  }
+  const exitCode = await runUpdatePlan(plan);
+  return exitCode === 0 ? { status: "updated", exitCode: 0 } : { status: "failed", exitCode };
+}
 function safeVersionSegment(value) {
   const normalized = value.trim();
   return /^[0-9A-Za-z._-]+$/.test(normalized) ? normalized : "";
@@ -21556,13 +21667,18 @@ async function runPythonSidecarUpdatePlan(plan) {
   return 0;
 }
 async function runUpdatePlan(plan) {
+  let exitCode = 1;
   if (plan.kind === "npm-global") {
-    return runCommand(plan.command, plan.args);
+    exitCode = await runCommand(plan.command, plan.args);
+  } else if (plan.kind === "python-sidecar") {
+    exitCode = await runPythonSidecarUpdatePlan(plan);
   }
-  if (plan.kind === "python-sidecar") {
-    return runPythonSidecarUpdatePlan(plan);
+  if (exitCode === 0) {
+    clearAutoUpdateFailure(plan);
+  } else {
+    writeAutoUpdateFailure(plan, exitCode);
   }
-  return 1;
+  return exitCode;
 }
 async function handleUpdate(options) {
   const plan = resolveUpdatePlan();
@@ -21871,15 +21987,18 @@ async function maybeAutoUpdateAndRelaunch(response) {
     `Deepline SDK/CLI ${label}; running ${plan.manualCommand}
 `
   );
-  const updateExitCode = await runUpdatePlan(plan);
-  if (updateExitCode !== 0) {
+  const updateResult = await runAutomaticUpdatePlan(plan);
+  if (updateResult.status === "skipped_previous_failure") {
+    return false;
+  }
+  if (updateResult.exitCode !== 0) {
     if (autoUpdate.required) {
       throw new Error(
-        `Automatic Deepline SDK/CLI update failed with exit code ${updateExitCode}. ${response.message}`
+        `Automatic Deepline SDK/CLI update failed with exit code ${updateResult.exitCode}. ${response.message}`
       );
     }
     process.stderr.write(
-      `Deepline SDK/CLI auto-update failed with exit code ${updateExitCode}; continuing with ${response.current ?? "current version"}.
+      `Deepline SDK/CLI auto-update failed with exit code ${updateResult.exitCode}; continuing with ${response.current ?? "current version"}.
 `
     );
     return false;

package/dist/index.js

@@ -275,10 +275,10 @@ var SDK_RELEASE = {
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
   // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
-  version: "0.1.124",
+  version: "0.1.126",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.124",
+    latest: "0.1.126",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/dist/index.mjs

@@ -197,10 +197,10 @@ var SDK_RELEASE = {
   // 0.1.108 ships explicit dataset column/tool recompute policy and removes
   // the SDK enrich generator's one-second stale policy.
   // 0.1.110 ships authored V2 prebuilts and required top-level play descriptions.
-  version: "0.1.124",
+  version: "0.1.126",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.124",
+    latest: "0.1.126",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.124",
+  "version": "0.1.126",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {
@@ -49,9 +49,11 @@
     "commander": "^14.0.3",
     "csv-parse": "^5.6.0",
     "csv-stringify": "^6.5.0",
-    "esbuild": "^0.27.0",
     "undici": "^6.22.0"
   },
+  "optionalDependencies": {
+    "esbuild": "^0.27.0"
+  },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "tsup": "^8.0.0",