deepline 0.1.126 → 0.1.127

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.126",
+  version: "0.1.127",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.126",
+    latest: "0.1.127",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -21248,24 +21248,362 @@ Notes:
 }
 
 // src/cli/commands/update.ts
+var import_node_child_process3 = require("child_process");
+var import_node_fs15 = require("fs");
+var import_node_os13 = require("os");
+var import_node_path18 = require("path");
+
+// src/cli/skills-sync.ts
 var import_node_child_process2 = require("child_process");
 var import_node_fs14 = require("fs");
 var import_node_os12 = require("os");
 var import_node_path17 = require("path");
+
+// ../shared_libs/cli/install-commands.json
+var install_commands_default = {
+  skills: {
+    index_path: "/.well-known/skills/index.json",
+    default_agents: [
+      "codex",
+      "claude-code",
+      "cursor",
+      "gemini-cli",
+      "antigravity"
+    ],
+    npx_binary: "npx",
+    npx_add_args_template: [
+      "--yes",
+      "skills",
+      "add",
+      "{skills_index_url}",
+      "--agent",
+      "{agents}",
+      "--global",
+      "--yes",
+      "--skill",
+      "{skill_name}",
+      "--full-depth"
+    ]
+  },
+  cli: {
+    legacy_python_shell_template: "curl -s {base_url}/api/v2/cli/install | bash",
+    sdk_npm_global: "npm install -g deepline@latest"
+  }
+};
+
+// src/cli/install-commands.ts
+var INSTALL_COMMANDS = install_commands_default;
+var DEFAULT_V1_SKILL_NAMES = [
+  "build-tam",
+  "clay-to-deepline",
+  "deepline-analytics",
+  "deepline-feedback",
+  "deepline-gtm",
+  "deepline-quickstart",
+  "find-qualified-titles",
+  "linkedin-url-lookup",
+  "niche-signal-discovery",
+  "portfolio-prospecting",
+  "workflow-hello-world"
+];
+var DEFAULT_SDK_SKILL_NAMES = [
+  ...DEFAULT_V1_SKILL_NAMES,
+  "deepline-plays"
+];
+function normalizeBaseUrl2(baseUrl) {
+  return baseUrl.replace(/\/$/, "");
+}
+function renderTemplate(template, values) {
+  return template.replace(/\{([a-z_]+)\}/g, (match, key) => {
+    return values[key] ?? match;
+  });
+}
+function shellJoin(args) {
+  return args.join(" ");
+}
+function skillsIndexUrl(baseUrl) {
+  return `${normalizeBaseUrl2(baseUrl)}${INSTALL_COMMANDS.skills.index_path}`;
+}
+function buildSkillsAddArgs(baseUrl, skillName, options = {}) {
+  const skillNames = Array.isArray(skillName) ? skillName : [skillName];
+  const [firstSkillName, ...extraSkillNames] = skillNames;
+  const values = {
+    skills_index_url: skillsIndexUrl(baseUrl),
+    agents: INSTALL_COMMANDS.skills.default_agents.join(" "),
+    skill_name: firstSkillName ?? ""
+  };
+  const rendered = INSTALL_COMMANDS.skills.npx_add_args_template.flatMap(
+    (arg, index) => {
+      const next = index === 0 && options.firstArg ? options.firstArg : arg;
+      const value = renderTemplate(next, values);
+      if (arg === "{agents}") {
+        return INSTALL_COMMANDS.skills.default_agents;
+      }
+      if (arg === "{skill_name}") {
+        return [value, ...extraSkillNames.flatMap((name) => ["--skill", name])];
+      }
+      return value;
+    }
+  );
+  return rendered;
+}
+function skillsInstallCommand(baseUrl, skillName) {
+  return `${INSTALL_COMMANDS.skills.npx_binary} ${shellJoin(
+    buildSkillsAddArgs(baseUrl, skillName)
+  )}`;
+}
+function legacyPythonInstallCommand(baseUrl) {
+  return renderTemplate(INSTALL_COMMANDS.cli.legacy_python_shell_template, {
+    base_url: normalizeBaseUrl2(baseUrl)
+  });
+}
+function sdkNpmGlobalInstallCommand() {
+  return INSTALL_COMMANDS.cli.sdk_npm_global;
+}
+
+// src/cli/skills-sync.ts
+var CHECK_TIMEOUT_MS2 = 3e3;
+var SDK_PLAY_SKILL_NAME = "deepline-plays";
+var attemptedSync = false;
+function shouldSkipSkillsSync() {
+  const value = process.env.DEEPLINE_SKIP_SKILLS_SYNC?.trim().toLowerCase();
+  return value === "1" || value === "true" || value === "yes" || value === "on";
+}
+function activePluginSkillsDir() {
+  const pluginMode = process.env.DEEPLINE_PLUGIN_MODE?.trim().toLowerCase();
+  if (pluginMode !== "true" && pluginMode !== "1" && pluginMode !== "yes" && pluginMode !== "on") {
+    return "";
+  }
+  const dir = process.env.DEEPLINE_PLUGIN_SKILLS_DIR?.trim() ?? "";
+  return dir && (0, import_node_fs14.existsSync)(dir) ? dir : "";
+}
+function readPluginSkillsVersion() {
+  const dir = activePluginSkillsDir();
+  if (!dir) return "";
+  try {
+    return (0, import_node_fs14.readFileSync)((0, import_node_path17.join)(dir, ".version"), "utf-8").trim();
+  } catch {
+    return "";
+  }
+}
+function sdkSkillsVersionPath(baseUrl) {
+  const home = process.env.HOME?.trim() || (0, import_node_os12.homedir)();
+  return (0, import_node_path17.join)(
+    home,
+    ".local",
+    "deepline",
+    baseUrlSlug(baseUrl),
+    "sdk-skills",
+    ".version"
+  );
+}
+function readLocalSkillsVersion(baseUrl) {
+  const pluginVersion = readPluginSkillsVersion();
+  if (pluginVersion) return pluginVersion;
+  const path = sdkSkillsVersionPath(baseUrl);
+  if (!(0, import_node_fs14.existsSync)(path)) return "";
+  try {
+    return (0, import_node_fs14.readFileSync)(path, "utf-8").trim();
+  } catch {
+    return "";
+  }
+}
+function writeLocalSkillsVersion(baseUrl, version) {
+  const path = sdkSkillsVersionPath(baseUrl);
+  (0, import_node_fs14.mkdirSync)((0, import_node_path17.dirname)(path), { recursive: true });
+  (0, import_node_fs14.writeFileSync)(path, `${version}
+`, "utf-8");
+}
+function sortedUniqueSkillNames(names) {
+  return [...new Set(names.map((name) => name.trim()).filter(Boolean))].sort(
+    (a, b) => a.localeCompare(b)
+  );
+}
+async function fetchV1SkillNames(baseUrl) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), CHECK_TIMEOUT_MS2);
+  try {
+    const response = await fetch(
+      new URL("/.well-known/skills/index.json", baseUrl),
+      { signal: controller.signal }
+    );
+    if (!response.ok) return [];
+    const data = await response.json().catch(() => null);
+    const names = (data?.skills ?? []).filter((skill) => skill.install_surface === "v1").map((skill) => skill.name).filter(
+      (name) => typeof name === "string" && name.length > 0
+    );
+    return sortedUniqueSkillNames(names);
+  } catch {
+    return [];
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+function buildSdkSkillNames(v1SkillNames) {
+  return sortedUniqueSkillNames([...v1SkillNames, SDK_PLAY_SKILL_NAME]);
+}
+async function fetchSkillsUpdate(baseUrl, localVersion) {
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), CHECK_TIMEOUT_MS2);
+  try {
+    const response = await fetch(new URL("/api/v2/cli/update-check", baseUrl), {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        skills: {
+          version: localVersion
+        }
+      }),
+      signal: controller.signal
+    });
+    if (!response.ok) return null;
+    const data = await response.json().catch(() => null);
+    const skills = data?.skills;
+    if (!skills) return null;
+    return {
+      needsUpdate: skills.needs_update === true,
+      remoteVersion: typeof skills.remote?.version === "string" ? skills.remote.version.trim() : ""
+    };
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+function buildSkillsInstallArgs(baseUrl, skillNames = DEFAULT_SDK_SKILL_NAMES) {
+  return buildSkillsAddArgs(baseUrl, sortedUniqueSkillNames(skillNames));
+}
+function buildBunxSkillsInstallArgs(baseUrl, skillNames) {
+  return buildSkillsAddArgs(baseUrl, sortedUniqueSkillNames(skillNames), {
+    firstArg: "--bun"
+  });
+}
+function hasCommand(command) {
+  const result = (0, import_node_child_process2.spawnSync)(command, ["--version"], {
+    stdio: "ignore",
+    shell: process.platform === "win32"
+  });
+  return result.status === 0;
+}
+function shellQuote3(arg) {
+  return `'${arg.replace(/'/g, `'\\''`)}'`;
+}
+function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NAMES) {
+  const npxArgs = buildSkillsInstallArgs(baseUrl, skillNames);
+  const npxInstall = {
+    command: "npx",
+    args: npxArgs,
+    manualCommand: `npx ${npxArgs.map(shellQuote3).join(" ")}`
+  };
+  if (hasCommand("bunx")) {
+    const bunxArgs = buildBunxSkillsInstallArgs(baseUrl, skillNames);
+    return [
+      {
+        command: "bunx",
+        args: bunxArgs,
+        manualCommand: `bunx ${bunxArgs.map(shellQuote3).join(" ")}`
+      },
+      npxInstall
+    ];
+  }
+  return [npxInstall];
+}
+function runOneSkillsInstall(install) {
+  return new Promise((resolve13) => {
+    const child = (0, import_node_child_process2.spawn)(install.command, install.args, {
+      stdio: ["ignore", "ignore", "pipe"],
+      env: process.env
+    });
+    let stderr = "";
+    child.stderr.on("data", (chunk) => {
+      stderr += chunk.toString("utf-8");
+    });
+    child.on("error", (error) => {
+      resolve13({
+        ok: false,
+        detail: `failed to start ${install.command}: ${error.message}`,
+        manualCommand: install.manualCommand
+      });
+    });
+    child.on("close", (code) => {
+      if (code === 0) {
+        resolve13({ ok: true, detail: "", manualCommand: install.manualCommand });
+        return;
+      }
+      const detail = stderr.trim();
+      resolve13({
+        ok: false,
+        detail: detail ? `${install.command}: ${detail}` : `${install.command} exited ${code}`,
+        manualCommand: install.manualCommand
+      });
+    });
+  });
+}
+async function runSkillsInstall(baseUrl, skillNames) {
+  const failures = [];
+  for (const install of resolveSkillsInstallCommands(baseUrl, skillNames)) {
+    const result = await runOneSkillsInstall(install);
+    if (result.ok) return true;
+    failures.push(result);
+  }
+  const details = failures.map((failure) => failure.detail).filter(Boolean).join("\n");
+  const manualCommand = failures.at(-1)?.manualCommand;
+  process.stderr.write(
+    `SDK skills sync failed${details ? `:
+${details}` : ""}
+` + (manualCommand ? `Run manually: ${manualCommand}
+` : "")
+  );
+  return false;
+}
+function writeSdkSkillsStatusLine(line) {
+  const progress = getActiveCliProgress();
+  if (progress) {
+    progress.writeLine(line);
+    return;
+  }
+  process.stderr.write(`${line}
+`);
+}
+async function syncSdkSkillsIfNeeded(baseUrl) {
+  if (attemptedSync || shouldSkipSkillsSync()) return;
+  attemptedSync = true;
+  const usingPluginSkills = Boolean(activePluginSkillsDir());
+  const localVersion = readLocalSkillsVersion(baseUrl);
+  const update = await fetchSkillsUpdate(baseUrl, localVersion);
+  if (usingPluginSkills) {
+    return;
+  }
+  if (!update?.needsUpdate || !update.remoteVersion) {
+    return;
+  }
+  const remoteSkillNames = await fetchV1SkillNames(baseUrl);
+  const skillNames = buildSdkSkillNames(
+    remoteSkillNames.length > 0 ? remoteSkillNames : DEFAULT_SDK_SKILL_NAMES
+  );
+  if (skillNames.length === 0) return;
+  writeSdkSkillsStatusLine("Deepline skills changed; syncing agent skills...");
+  const installed = await runSkillsInstall(baseUrl, skillNames);
+  if (!installed) return;
+  writeLocalSkillsVersion(baseUrl, update.remoteVersion);
+  writeSdkSkillsStatusLine("Deepline agent skills are up to date.");
+}
+
+// src/cli/commands/update.ts
 function posixShellQuote(value) {
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
 function windowsCmdQuote(value) {
   return `"${value.replace(/"/g, '""')}"`;
 }
-function shellQuote3(value) {
+function shellQuote4(value) {
   if (process.platform === "win32") {
     return /^[A-Za-z0-9_./:@%+=,-]+$/.test(value) ? value : windowsCmdQuote(value);
   }
   return posixShellQuote(value);
 }
 function buildSourceUpdateCommand(sourceRoot) {
-  const quotedRoot = shellQuote3(sourceRoot);
+  const quotedRoot = shellQuote4(sourceRoot);
   const cdCommand = process.platform === "win32" ? `cd /d ${quotedRoot}` : `cd ${quotedRoot}`;
   return `${cdCommand} && git fetch origin main --tags && git merge --ff-only origin/main`;
 }
@@ -21274,11 +21612,11 @@ function sidecarStateDir(input2) {
   if (!scope || scope.includes("/") || scope.includes("\\")) {
     return null;
   }
-  return (0, import_node_path17.join)(input2.homeDir, ".local", "deepline", scope, "sdk-cli");
+  return (0, import_node_path18.join)(input2.homeDir, ".local", "deepline", scope, "sdk-cli");
 }
 function readOptionalText(path) {
   try {
-    return (0, import_node_fs14.readFileSync)(path, "utf8").trim();
+    return (0, import_node_fs15.readFileSync)(path, "utf8").trim();
   } catch {
     return "";
   }
@@ -21286,26 +21624,26 @@ function readOptionalText(path) {
 function resolvePythonSidecarUpdatePlan(options) {
   const stateDir = sidecarStateDir(options);
   if (!stateDir) return null;
-  const relativeEntrypoint = (0, import_node_path17.relative)(
-    (0, import_node_path17.resolve)(stateDir),
-    (0, import_node_path17.resolve)(options.entrypoint)
+  const relativeEntrypoint = (0, import_node_path18.relative)(
+    (0, import_node_path18.resolve)(stateDir),
+    (0, import_node_path18.resolve)(options.entrypoint)
   );
-  if (!relativeEntrypoint || relativeEntrypoint.startsWith("..") || (0, import_node_path17.isAbsolute)(relativeEntrypoint)) {
+  if (!relativeEntrypoint || relativeEntrypoint.startsWith("..") || (0, import_node_path18.isAbsolute)(relativeEntrypoint)) {
     return null;
   }
-  const installMethod = readOptionalText((0, import_node_path17.join)(stateDir, ".install-method"));
+  const installMethod = readOptionalText((0, import_node_path18.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_path17.join)(stateDir, ".node-bin")) || process.execPath;
-  const sidecarPath = readOptionalText((0, import_node_path17.join)(stateDir, ".command-path")) || (0, import_node_path17.join)(
+  const nodeBin = readOptionalText((0, import_node_path18.join)(stateDir, ".node-bin")) || process.execPath;
+  const sidecarPath = readOptionalText((0, import_node_path18.join)(stateDir, ".command-path")) || (0, import_node_path18.join)(
     stateDir,
     "bin",
     process.platform === "win32" ? "deepline-sdk.cmd" : "deepline-sdk"
   );
   const packageSpec = options.packageSpec || "deepline@latest";
   const npmCommand = "npm";
-  const manualCommand = `${npmCommand} install --prefix ${shellQuote3((0, import_node_path17.join)(stateDir, "versions", "<version>"))} --no-audit --no-fund ${shellQuote3(packageSpec)}`;
+  const manualCommand = `${npmCommand} install --prefix ${shellQuote4((0, import_node_path18.join)(stateDir, "versions", "<version>"))} --no-audit --no-fund ${shellQuote4(packageSpec)}`;
   return {
     kind: "python-sidecar",
     stateDir,
@@ -21319,12 +21657,12 @@ function resolvePythonSidecarUpdatePlan(options) {
   };
 }
 function findRepoBackedSdkRoot(startPath) {
-  let current = (0, import_node_path17.resolve)(startPath);
+  let current = (0, import_node_path18.resolve)(startPath);
   while (true) {
-    if ((0, import_node_fs14.existsSync)((0, import_node_path17.join)(current, "sdk", "package.json")) && (0, import_node_fs14.existsSync)((0, import_node_path17.join)(current, "sdk", "bin", "deepline-dev.ts"))) {
+    if ((0, import_node_fs15.existsSync)((0, import_node_path18.join)(current, "sdk", "package.json")) && (0, import_node_fs15.existsSync)((0, import_node_path18.join)(current, "sdk", "bin", "deepline-dev.ts"))) {
       return current;
     }
-    const parent = (0, import_node_path17.dirname)(current);
+    const parent = (0, import_node_path18.dirname)(current);
     if (parent === current) return null;
     current = parent;
   }
@@ -21332,9 +21670,9 @@ function findRepoBackedSdkRoot(startPath) {
 function inferNpmGlobalPrefixFromEntrypoint(entrypoint) {
   const normalized = (() => {
     try {
-      return (0, import_node_fs14.realpathSync)(entrypoint);
+      return (0, import_node_fs15.realpathSync)(entrypoint);
     } catch {
-      return (0, import_node_path17.resolve)(entrypoint);
+      return (0, import_node_path18.resolve)(entrypoint);
     }
   })();
   const parts = normalized.split(/[\\/]+/);
@@ -21352,9 +21690,9 @@ function inferNpmGlobalPrefixFromEntrypoint(entrypoint) {
 }
 function resolveUpdatePlan(options = {}) {
   const env = options.env ?? process.env;
-  const homeDir2 = options.homeDir ?? (0, import_node_os12.homedir)();
-  const entrypoint = options.entrypoint ?? (process.argv[1] ? (0, import_node_path17.resolve)(process.argv[1]) : "");
-  const sourceRoot = entrypoint ? findRepoBackedSdkRoot((0, import_node_path17.dirname)(entrypoint)) : null;
+  const homeDir2 = options.homeDir ?? (0, import_node_os13.homedir)();
+  const entrypoint = options.entrypoint ?? (process.argv[1] ? (0, import_node_path18.resolve)(process.argv[1]) : "");
+  const sourceRoot = entrypoint ? findRepoBackedSdkRoot((0, import_node_path18.dirname)(entrypoint)) : null;
   if (sourceRoot) {
     return {
       kind: "source",
@@ -21378,17 +21716,17 @@ function resolveUpdatePlan(options = {}) {
     command,
     args,
     ...installPrefix ? { installPrefix } : {},
-    manualCommand: `${command} ${args.map(shellQuote3).join(" ")}`
+    manualCommand: `${command} ${args.map(shellQuote4).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_path18.join)(plan.stateDir, AUTO_UPDATE_FAILURE_FILE);
   }
-  return (0, import_node_path17.join)(
-    (0, import_node_os12.homedir)(),
+  return (0, import_node_path18.join)(
+    (0, import_node_os13.homedir)(),
     ".local",
     "deepline",
     "sdk-cli",
@@ -21405,7 +21743,7 @@ function readAutoUpdateFailure(plan) {
   if (!path) return null;
   try {
     const parsed = JSON.parse(
-      (0, import_node_fs14.readFileSync)(path, "utf8")
+      (0, import_node_fs15.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;
@@ -21426,8 +21764,8 @@ function writeAutoUpdateFailure(plan, 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)}
+    (0, import_node_fs15.mkdirSync)((0, import_node_path18.dirname)(path), { recursive: true });
+    (0, import_node_fs15.writeFileSync)(path, `${JSON.stringify(marker, null, 2)}
 `, "utf8");
   } catch {
   }
@@ -21436,7 +21774,7 @@ function clearAutoUpdateFailure(plan) {
   const path = autoUpdateFailurePath(plan);
   if (!path) return;
   try {
-    (0, import_node_fs14.unlinkSync)(path);
+    (0, import_node_fs15.unlinkSync)(path);
   } catch {
   }
 }
@@ -21472,7 +21810,7 @@ function safeVersionSegment(value) {
   return /^[0-9A-Za-z._-]+$/.test(normalized) ? normalized : "";
 }
 function entryPathInVersionDir(versionDir) {
-  return (0, import_node_path17.join)(
+  return (0, import_node_path18.join)(
     versionDir,
     "node_modules",
     "deepline",
@@ -21482,14 +21820,14 @@ function entryPathInVersionDir(versionDir) {
   );
 }
 function installedPackageVersion(versionDir) {
-  const packageJsonPath = (0, import_node_path17.join)(
+  const packageJsonPath = (0, import_node_path18.join)(
     versionDir,
     "node_modules",
     "deepline",
     "package.json"
   );
   try {
-    const parsed = JSON.parse((0, import_node_fs14.readFileSync)(packageJsonPath, "utf8"));
+    const parsed = JSON.parse((0, import_node_fs15.readFileSync)(packageJsonPath, "utf8"));
     return typeof parsed.version === "string" ? safeVersionSegment(parsed.version) : "";
   } catch {
     return "";
@@ -21497,7 +21835,7 @@ function installedPackageVersion(versionDir) {
 }
 function runCommand(command, args, env = process.env) {
   return new Promise((resolveExitCode) => {
-    const child = (0, import_node_child_process2.spawn)(command, args, {
+    const child = (0, import_node_child_process3.spawn)(command, args, {
       stdio: "inherit",
       shell: process.platform === "win32",
       env
@@ -21513,9 +21851,9 @@ function runCommand(command, args, env = process.env) {
   });
 }
 function writeSidecarLauncher(input2) {
-  (0, import_node_fs14.mkdirSync)((0, import_node_path17.dirname)(input2.path), { recursive: true });
+  (0, import_node_fs15.mkdirSync)((0, import_node_path18.dirname)(input2.path), { recursive: true });
   if (process.platform === "win32") {
-    (0, import_node_fs14.writeFileSync)(
+    (0, import_node_fs15.writeFileSync)(
       input2.path,
       [
         `@set DEEPLINE_HOST_URL=${input2.hostUrl.replace(/\r?\n/g, "")}`,
@@ -21527,30 +21865,30 @@ function writeSidecarLauncher(input2) {
     );
     return;
   }
-  (0, import_node_fs14.writeFileSync)(
+  (0, import_node_fs15.writeFileSync)(
     input2.path,
     [
       "#!/usr/bin/env sh",
-      `export DEEPLINE_HOST_URL=${shellQuote3(input2.hostUrl)}`,
-      `export DEEPLINE_CONFIG_SCOPE=${shellQuote3(input2.scope)}`,
-      `exec ${shellQuote3(input2.nodeBin)} ${shellQuote3(input2.entryPath)} "$@"`,
+      `export DEEPLINE_HOST_URL=${shellQuote4(input2.hostUrl)}`,
+      `export DEEPLINE_CONFIG_SCOPE=${shellQuote4(input2.scope)}`,
+      `exec ${shellQuote4(input2.nodeBin)} ${shellQuote4(input2.entryPath)} "$@"`,
       ""
     ].join("\n"),
     { encoding: "utf8", mode: 493 }
   );
 }
 async function runPythonSidecarUpdatePlan(plan) {
-  const versionsDir = (0, import_node_path17.join)(plan.stateDir, "versions");
-  const tempDir = (0, import_node_path17.join)(
+  const versionsDir = (0, import_node_path18.join)(plan.stateDir, "versions");
+  const tempDir = (0, import_node_path18.join)(
     versionsDir,
     `.tmp-sdk-update-${process.pid}-${Date.now()}`
   );
-  (0, import_node_fs14.rmSync)(tempDir, { recursive: true, force: true });
-  (0, import_node_fs14.mkdirSync)(tempDir, { recursive: true });
-  (0, import_node_fs14.writeFileSync)((0, import_node_path17.join)(tempDir, "package.json"), '{"private":true}\n', "utf8");
+  (0, import_node_fs15.rmSync)(tempDir, { recursive: true, force: true });
+  (0, import_node_fs15.mkdirSync)(tempDir, { recursive: true });
+  (0, import_node_fs15.writeFileSync)((0, import_node_path18.join)(tempDir, "package.json"), '{"private":true}\n', "utf8");
   const env = {
     ...process.env,
-    PATH: `${(0, import_node_path17.dirname)(plan.nodeBin)}${process.platform === "win32" ? ";" : ":"}${process.env.PATH ?? ""}`
+    PATH: `${(0, import_node_path18.dirname)(plan.nodeBin)}${process.platform === "win32" ? ";" : ":"}${process.env.PATH ?? ""}`
   };
   const installExitCode = await runCommand(
     plan.npmCommand,
@@ -21565,7 +21903,7 @@ async function runPythonSidecarUpdatePlan(plan) {
     env
   );
   if (installExitCode !== 0) {
-    (0, import_node_fs14.rmSync)(tempDir, { recursive: true, force: true });
+    (0, import_node_fs15.rmSync)(tempDir, { recursive: true, force: true });
     return installExitCode;
   }
   const installedVersion = installedPackageVersion(tempDir);
@@ -21573,19 +21911,19 @@ async function runPythonSidecarUpdatePlan(plan) {
     process.stderr.write(
       "Updated Deepline SDK package did not report a version.\n"
     );
-    (0, import_node_fs14.rmSync)(tempDir, { recursive: true, force: true });
+    (0, import_node_fs15.rmSync)(tempDir, { recursive: true, force: true });
     return 1;
   }
-  const finalDir = (0, import_node_path17.join)(versionsDir, installedVersion);
+  const finalDir = (0, import_node_path18.join)(versionsDir, installedVersion);
   const finalEntryPath = entryPathInVersionDir(finalDir);
-  if ((0, import_node_fs14.existsSync)(finalEntryPath)) {
-    (0, import_node_fs14.rmSync)(tempDir, { recursive: true, force: true });
+  if ((0, import_node_fs15.existsSync)(finalEntryPath)) {
+    (0, import_node_fs15.rmSync)(tempDir, { recursive: true, force: true });
   } else {
-    (0, import_node_fs14.rmSync)(finalDir, { recursive: true, force: true });
+    (0, import_node_fs15.rmSync)(finalDir, { recursive: true, force: true });
     try {
-      (0, import_node_fs14.renameSync)(tempDir, finalDir);
+      (0, import_node_fs15.renameSync)(tempDir, finalDir);
     } catch (error) {
-      (0, import_node_fs14.rmSync)(tempDir, { recursive: true, force: true });
+      (0, import_node_fs15.rmSync)(tempDir, { recursive: true, force: true });
       process.stderr.write(
         `Failed to publish Deepline SDK sidecar update: ${error.message}
 `
@@ -21593,7 +21931,7 @@ async function runPythonSidecarUpdatePlan(plan) {
       return 1;
     }
   }
-  if (!(0, import_node_fs14.existsSync)(finalEntryPath)) {
+  if (!(0, import_node_fs15.existsSync)(finalEntryPath)) {
     process.stderr.write(
       `Updated Deepline SDK CLI entrypoint missing: ${finalEntryPath}
 `
@@ -21607,28 +21945,28 @@ async function runPythonSidecarUpdatePlan(plan) {
     nodeBin: plan.nodeBin,
     entryPath: finalEntryPath
   });
-  (0, import_node_fs14.writeFileSync)(
-    (0, import_node_path17.join)(plan.stateDir, ".version"),
+  (0, import_node_fs15.writeFileSync)(
+    (0, import_node_path18.join)(plan.stateDir, ".version"),
     `${installedVersion}
 `,
     "utf8"
   );
-  (0, import_node_fs14.writeFileSync)(
-    (0, import_node_path17.join)(plan.stateDir, ".install-method"),
+  (0, import_node_fs15.writeFileSync)(
+    (0, import_node_path18.join)(plan.stateDir, ".install-method"),
     "python-sidecar\n",
     "utf8"
   );
-  (0, import_node_fs14.writeFileSync)(
-    (0, import_node_path17.join)(plan.stateDir, ".command-path"),
+  (0, import_node_fs15.writeFileSync)(
+    (0, import_node_path18.join)(plan.stateDir, ".command-path"),
     `${plan.sidecarPath}
 `,
     "utf8"
   );
-  (0, import_node_fs14.writeFileSync)((0, import_node_path17.join)(plan.stateDir, ".runner"), "node\n", "utf8");
-  (0, import_node_fs14.writeFileSync)((0, import_node_path17.join)(plan.stateDir, ".node-bin"), `${plan.nodeBin}
+  (0, import_node_fs15.writeFileSync)((0, import_node_path18.join)(plan.stateDir, ".runner"), "node\n", "utf8");
+  (0, import_node_fs15.writeFileSync)((0, import_node_path18.join)(plan.stateDir, ".node-bin"), `${plan.nodeBin}
 `, "utf8");
-  (0, import_node_fs14.writeFileSync)(
-    (0, import_node_path17.join)(plan.stateDir, ".entry-path"),
+  (0, import_node_fs15.writeFileSync)(
+    (0, import_node_path18.join)(plan.stateDir, ".entry-path"),
     `${finalEntryPath}
 `,
     "utf8"
@@ -21649,8 +21987,16 @@ async function runUpdatePlan(plan) {
   }
   return exitCode;
 }
-async function handleUpdate(options) {
-  const plan = resolveUpdatePlan();
+function normalizeBaseUrl3(value) {
+  return value.replace(/\/$/, "");
+}
+async function runUpdateCommand(options, dependencies = {}) {
+  const detectBaseUrl = dependencies.detectBaseUrl ?? autoDetectBaseUrl;
+  const resolvePlan = dependencies.resolvePlan ?? resolveUpdatePlan;
+  const runPlan = dependencies.runPlan ?? runUpdatePlan;
+  const syncSkills = dependencies.syncSkillsIfNeeded ?? syncSdkSkillsIfNeeded;
+  const stderr = dependencies.stderr ?? process.stderr;
+  const plan = resolvePlan();
   const render = {
     sections: [
       {
@@ -21686,11 +22032,14 @@ async function handleUpdate(options) {
     printCommandEnvelope({ ...plan, render }, { json: false });
     return 0;
   }
-  process.stderr.write(
-    `Updating Deepline SDK/CLI with: ${plan.manualCommand}
-`
-  );
-  return runUpdatePlan(plan);
+  stderr.write(`Updating Deepline SDK/CLI with: ${plan.manualCommand}
+`);
+  const updateExitCode = await runPlan(plan);
+  if (updateExitCode !== 0) {
+    return updateExitCode;
+  }
+  await syncSkills(normalizeBaseUrl3(detectBaseUrl()));
+  return 0;
 }
 function registerUpdateCommand(program) {
   program.command("update").description("Update the Deepline SDK/CLI.").addHelpText(
@@ -21709,7 +22058,7 @@ Examples:
   deepline update --json
 `
   ).option("--print-command", "Print the update command without running it").option("--json", "Emit the resolved update plan as JSON").action(async (options) => {
-    process.exitCode = await handleUpdate(options);
+    process.exitCode = await runUpdateCommand(options);
   });
 }
 
@@ -21719,141 +22068,39 @@ var command_compatibility_default = {
     family: "python",
     label: "a legacy Python CLI enrichment command",
     sdk_alternative: "Use `deepline plays ...` for durable workflows or `deepline tools execute ...` for one tool call."
-  },
-  session: {
-    family: "python",
-    label: "a legacy Python CLI session/playground command",
-    sdk_alternative: "Use `deepline sessions send ...` or `deepline sessions render ...` for transcript workflows."
-  },
-  workflows: {
-    family: "python",
-    label: "a legacy Python CLI workflow command",
-    sdk_alternative: "Use `deepline plays ...` in the SDK CLI."
-  },
-  events: {
-    family: "python",
-    label: "a legacy Python CLI event command"
-  },
-  plays: {
-    family: "sdk",
-    label: "an SDK CLI play command",
-    python_alternative: "Use `deepline workflows ...` only for legacy workflows."
-  },
-  runs: {
-    family: "sdk",
-    label: "an SDK CLI run inspection command"
-  },
-  sessions: {
-    family: "sdk",
-    label: "an SDK CLI session transcript command"
-  },
-  health: {
-    family: "sdk",
-    label: "an SDK CLI health command"
-  }
-};
-
-// ../shared_libs/cli/install-commands.json
-var install_commands_default = {
-  skills: {
-    index_path: "/.well-known/skills/index.json",
-    default_agents: [
-      "codex",
-      "claude-code",
-      "cursor",
-      "gemini-cli",
-      "antigravity"
-    ],
-    npx_binary: "npx",
-    npx_add_args_template: [
-      "--yes",
-      "skills",
-      "add",
-      "{skills_index_url}",
-      "--agent",
-      "{agents}",
-      "--global",
-      "--yes",
-      "--skill",
-      "{skill_name}",
-      "--full-depth"
-    ]
-  },
-  cli: {
-    legacy_python_shell_template: "curl -s {base_url}/api/v2/cli/install | bash",
-    sdk_npm_global: "npm install -g deepline@latest"
-  }
-};
-
-// src/cli/install-commands.ts
-var INSTALL_COMMANDS = install_commands_default;
-var DEFAULT_V1_SKILL_NAMES = [
-  "build-tam",
-  "clay-to-deepline",
-  "deepline-analytics",
-  "deepline-feedback",
-  "deepline-gtm",
-  "deepline-quickstart",
-  "find-qualified-titles",
-  "linkedin-url-lookup",
-  "niche-signal-discovery",
-  "portfolio-prospecting",
-  "workflow-hello-world"
-];
-var DEFAULT_SDK_SKILL_NAMES = [
-  ...DEFAULT_V1_SKILL_NAMES,
-  "deepline-plays"
-];
-function normalizeBaseUrl2(baseUrl) {
-  return baseUrl.replace(/\/$/, "");
-}
-function renderTemplate(template, values) {
-  return template.replace(/\{([a-z_]+)\}/g, (match, key) => {
-    return values[key] ?? match;
-  });
-}
-function shellJoin(args) {
-  return args.join(" ");
-}
-function skillsIndexUrl(baseUrl) {
-  return `${normalizeBaseUrl2(baseUrl)}${INSTALL_COMMANDS.skills.index_path}`;
-}
-function buildSkillsAddArgs(baseUrl, skillName, options = {}) {
-  const skillNames = Array.isArray(skillName) ? skillName : [skillName];
-  const [firstSkillName, ...extraSkillNames] = skillNames;
-  const values = {
-    skills_index_url: skillsIndexUrl(baseUrl),
-    agents: INSTALL_COMMANDS.skills.default_agents.join(" "),
-    skill_name: firstSkillName ?? ""
-  };
-  const rendered = INSTALL_COMMANDS.skills.npx_add_args_template.flatMap(
-    (arg, index) => {
-      const next = index === 0 && options.firstArg ? options.firstArg : arg;
-      const value = renderTemplate(next, values);
-      if (arg === "{agents}") {
-        return INSTALL_COMMANDS.skills.default_agents;
-      }
-      if (arg === "{skill_name}") {
-        return [value, ...extraSkillNames.flatMap((name) => ["--skill", name])];
-      }
-      return value;
-    }
-  );
-  return rendered;
-}
-function skillsInstallCommand(baseUrl, skillName) {
-  return `${INSTALL_COMMANDS.skills.npx_binary} ${shellJoin(
-    buildSkillsAddArgs(baseUrl, skillName)
-  )}`;
-}
-function legacyPythonInstallCommand(baseUrl) {
-  return renderTemplate(INSTALL_COMMANDS.cli.legacy_python_shell_template, {
-    base_url: normalizeBaseUrl2(baseUrl)
-  });
-}
-function sdkNpmGlobalInstallCommand() {
-  return INSTALL_COMMANDS.cli.sdk_npm_global;
-}
+  },
+  session: {
+    family: "python",
+    label: "a legacy Python CLI session/playground command",
+    sdk_alternative: "Use `deepline sessions send ...` or `deepline sessions render ...` for transcript workflows."
+  },
+  workflows: {
+    family: "python",
+    label: "a legacy Python CLI workflow command",
+    sdk_alternative: "Use `deepline plays ...` in the SDK CLI."
+  },
+  events: {
+    family: "python",
+    label: "a legacy Python CLI event command"
+  },
+  plays: {
+    family: "sdk",
+    label: "an SDK CLI play command",
+    python_alternative: "Use `deepline workflows ...` only for legacy workflows."
+  },
+  runs: {
+    family: "sdk",
+    label: "an SDK CLI run inspection command"
+  },
+  sessions: {
+    family: "sdk",
+    label: "an SDK CLI session transcript command"
+  },
+  health: {
+    family: "sdk",
+    label: "an SDK CLI health command"
+  }
+};
 
 // src/cli/command-compatibility.ts
 var COMMAND_COMPATIBILITY = command_compatibility_default;
@@ -21908,7 +22155,7 @@ function unknownCommandNameFromMessage(message) {
 }
 
 // src/cli/self-update.ts
-var import_node_child_process3 = require("child_process");
+var import_node_child_process4 = require("child_process");
 function envTruthy(name) {
   const value = process.env[name]?.trim().toLowerCase();
   return value === "1" || value === "true" || value === "yes";
@@ -21923,7 +22170,7 @@ function relaunchCurrentCommand(plan) {
   return new Promise((resolve13) => {
     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_process3.spawn)(command, args, {
+    const child = (0, import_node_child_process4.spawn)(command, args, {
       stdio: "inherit",
       shell: process.platform === "win32",
       env: {
@@ -21978,238 +22225,6 @@ async function maybeAutoUpdateAndRelaunch(response) {
   return true;
 }
 
-// src/cli/skills-sync.ts
-var import_node_child_process4 = require("child_process");
-var import_node_fs15 = require("fs");
-var import_node_os13 = require("os");
-var import_node_path18 = require("path");
-var CHECK_TIMEOUT_MS2 = 3e3;
-var SDK_PLAY_SKILL_NAME = "deepline-plays";
-var attemptedSync = false;
-function shouldSkipSkillsSync() {
-  const value = process.env.DEEPLINE_SKIP_SKILLS_SYNC?.trim().toLowerCase();
-  return value === "1" || value === "true" || value === "yes" || value === "on";
-}
-function activePluginSkillsDir() {
-  const pluginMode = process.env.DEEPLINE_PLUGIN_MODE?.trim().toLowerCase();
-  if (pluginMode !== "true" && pluginMode !== "1" && pluginMode !== "yes" && pluginMode !== "on") {
-    return "";
-  }
-  const dir = process.env.DEEPLINE_PLUGIN_SKILLS_DIR?.trim() ?? "";
-  return dir && (0, import_node_fs15.existsSync)(dir) ? dir : "";
-}
-function readPluginSkillsVersion() {
-  const dir = activePluginSkillsDir();
-  if (!dir) return "";
-  try {
-    return (0, import_node_fs15.readFileSync)((0, import_node_path18.join)(dir, ".version"), "utf-8").trim();
-  } catch {
-    return "";
-  }
-}
-function sdkSkillsVersionPath(baseUrl) {
-  const home = process.env.HOME?.trim() || (0, import_node_os13.homedir)();
-  return (0, import_node_path18.join)(
-    home,
-    ".local",
-    "deepline",
-    baseUrlSlug(baseUrl),
-    "sdk-skills",
-    ".version"
-  );
-}
-function readLocalSkillsVersion(baseUrl) {
-  const pluginVersion = readPluginSkillsVersion();
-  if (pluginVersion) return pluginVersion;
-  const path = sdkSkillsVersionPath(baseUrl);
-  if (!(0, import_node_fs15.existsSync)(path)) return "";
-  try {
-    return (0, import_node_fs15.readFileSync)(path, "utf-8").trim();
-  } catch {
-    return "";
-  }
-}
-function writeLocalSkillsVersion(baseUrl, version) {
-  const path = sdkSkillsVersionPath(baseUrl);
-  (0, import_node_fs15.mkdirSync)((0, import_node_path18.dirname)(path), { recursive: true });
-  (0, import_node_fs15.writeFileSync)(path, `${version}
-`, "utf-8");
-}
-function sortedUniqueSkillNames(names) {
-  return [...new Set(names.map((name) => name.trim()).filter(Boolean))].sort(
-    (a, b) => a.localeCompare(b)
-  );
-}
-async function fetchV1SkillNames(baseUrl) {
-  const controller = new AbortController();
-  const timeout = setTimeout(() => controller.abort(), CHECK_TIMEOUT_MS2);
-  try {
-    const response = await fetch(
-      new URL("/.well-known/skills/index.json", baseUrl),
-      { signal: controller.signal }
-    );
-    if (!response.ok) return [];
-    const data = await response.json().catch(() => null);
-    const names = (data?.skills ?? []).filter((skill) => skill.install_surface === "v1").map((skill) => skill.name).filter(
-      (name) => typeof name === "string" && name.length > 0
-    );
-    return sortedUniqueSkillNames(names);
-  } catch {
-    return [];
-  } finally {
-    clearTimeout(timeout);
-  }
-}
-function buildSdkSkillNames(v1SkillNames) {
-  return sortedUniqueSkillNames([...v1SkillNames, SDK_PLAY_SKILL_NAME]);
-}
-async function fetchSkillsUpdate(baseUrl, localVersion) {
-  const controller = new AbortController();
-  const timeout = setTimeout(() => controller.abort(), CHECK_TIMEOUT_MS2);
-  try {
-    const response = await fetch(new URL("/api/v2/cli/update-check", baseUrl), {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        skills: {
-          version: localVersion
-        }
-      }),
-      signal: controller.signal
-    });
-    if (!response.ok) return null;
-    const data = await response.json().catch(() => null);
-    const skills = data?.skills;
-    if (!skills) return null;
-    return {
-      needsUpdate: skills.needs_update === true,
-      remoteVersion: typeof skills.remote?.version === "string" ? skills.remote.version.trim() : ""
-    };
-  } catch {
-    return null;
-  } finally {
-    clearTimeout(timeout);
-  }
-}
-function buildSkillsInstallArgs(baseUrl, skillNames = DEFAULT_SDK_SKILL_NAMES) {
-  return buildSkillsAddArgs(baseUrl, sortedUniqueSkillNames(skillNames));
-}
-function buildBunxSkillsInstallArgs(baseUrl, skillNames) {
-  return buildSkillsAddArgs(baseUrl, sortedUniqueSkillNames(skillNames), {
-    firstArg: "--bun"
-  });
-}
-function hasCommand(command) {
-  const result = (0, import_node_child_process4.spawnSync)(command, ["--version"], {
-    stdio: "ignore",
-    shell: process.platform === "win32"
-  });
-  return result.status === 0;
-}
-function shellQuote4(arg) {
-  return `'${arg.replace(/'/g, `'\\''`)}'`;
-}
-function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NAMES) {
-  const npxArgs = buildSkillsInstallArgs(baseUrl, skillNames);
-  const npxInstall = {
-    command: "npx",
-    args: npxArgs,
-    manualCommand: `npx ${npxArgs.map(shellQuote4).join(" ")}`
-  };
-  if (hasCommand("bunx")) {
-    const bunxArgs = buildBunxSkillsInstallArgs(baseUrl, skillNames);
-    return [
-      {
-        command: "bunx",
-        args: bunxArgs,
-        manualCommand: `bunx ${bunxArgs.map(shellQuote4).join(" ")}`
-      },
-      npxInstall
-    ];
-  }
-  return [npxInstall];
-}
-function runOneSkillsInstall(install) {
-  return new Promise((resolve13) => {
-    const child = (0, import_node_child_process4.spawn)(install.command, install.args, {
-      stdio: ["ignore", "ignore", "pipe"],
-      env: process.env
-    });
-    let stderr = "";
-    child.stderr.on("data", (chunk) => {
-      stderr += chunk.toString("utf-8");
-    });
-    child.on("error", (error) => {
-      resolve13({
-        ok: false,
-        detail: `failed to start ${install.command}: ${error.message}`,
-        manualCommand: install.manualCommand
-      });
-    });
-    child.on("close", (code) => {
-      if (code === 0) {
-        resolve13({ ok: true, detail: "", manualCommand: install.manualCommand });
-        return;
-      }
-      const detail = stderr.trim();
-      resolve13({
-        ok: false,
-        detail: detail ? `${install.command}: ${detail}` : `${install.command} exited ${code}`,
-        manualCommand: install.manualCommand
-      });
-    });
-  });
-}
-async function runSkillsInstall(baseUrl, skillNames) {
-  const failures = [];
-  for (const install of resolveSkillsInstallCommands(baseUrl, skillNames)) {
-    const result = await runOneSkillsInstall(install);
-    if (result.ok) return true;
-    failures.push(result);
-  }
-  const details = failures.map((failure) => failure.detail).filter(Boolean).join("\n");
-  const manualCommand = failures.at(-1)?.manualCommand;
-  process.stderr.write(
-    `SDK skills sync failed${details ? `:
-${details}` : ""}
-` + (manualCommand ? `Run manually: ${manualCommand}
-` : "")
-  );
-  return false;
-}
-function writeSdkSkillsStatusLine(line) {
-  const progress = getActiveCliProgress();
-  if (progress) {
-    progress.writeLine(line);
-    return;
-  }
-  process.stderr.write(`${line}
-`);
-}
-async function syncSdkSkillsIfNeeded(baseUrl) {
-  if (attemptedSync || shouldSkipSkillsSync()) return;
-  attemptedSync = true;
-  const usingPluginSkills = Boolean(activePluginSkillsDir());
-  const localVersion = readLocalSkillsVersion(baseUrl);
-  const update = await fetchSkillsUpdate(baseUrl, localVersion);
-  if (usingPluginSkills) {
-    return;
-  }
-  if (!update?.needsUpdate || !update.remoteVersion) {
-    return;
-  }
-  const remoteSkillNames = await fetchV1SkillNames(baseUrl);
-  const skillNames = buildSdkSkillNames(
-    remoteSkillNames.length > 0 ? remoteSkillNames : DEFAULT_SDK_SKILL_NAMES
-  );
-  if (skillNames.length === 0) return;
-  writeSdkSkillsStatusLine("Deepline skills changed; syncing agent skills...");
-  const installed = await runSkillsInstall(baseUrl, skillNames);
-  if (!installed) return;
-  writeLocalSkillsVersion(baseUrl, update.remoteVersion);
-  writeSdkSkillsStatusLine("Deepline agent skills are up to date.");
-}
-
 // src/cli/failure-reporting.ts
 var import_node_os14 = require("os");
 var FAILURE_REPORT_DISABLE_ENV = "DEEPLINE_DISABLE_FAILURE_REPORTING";