deepline 0.1.126 → 0.1.128

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.126",
+  version: "0.1.128",
   apiContract: "2026-06-dataset-column-cell-stale-hard-cutover",
   supportPolicy: {
-    latest: "0.1.126",
+    latest: "0.1.128",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -21270,33 +21270,418 @@ Notes:
 }
 
 // src/cli/commands/update.ts
-import { spawn as spawn2 } from "child_process";
+import { spawn as spawn3 } from "child_process";
 import {
-  existsSync as existsSync10,
-  mkdirSync as mkdirSync8,
+  existsSync as existsSync11,
+  mkdirSync as mkdirSync9,
   realpathSync as realpathSync2,
-  readFileSync as readFileSync10,
+  readFileSync as readFileSync11,
   renameSync,
   rmSync as rmSync3,
   unlinkSync,
-  writeFileSync as writeFileSync13
+  writeFileSync as writeFileSync14
 } from "fs";
+import { homedir as homedir11 } from "os";
+import { dirname as dirname11, isAbsolute as isAbsolute2, join as join13, relative as relative2, resolve as resolve12 } from "path";
+
+// src/cli/skills-sync.ts
+import { spawn as spawn2, spawnSync as spawnSync2 } from "child_process";
+import { existsSync as existsSync10, mkdirSync as mkdirSync8, readFileSync as readFileSync10, writeFileSync as writeFileSync13 } from "fs";
 import { homedir as homedir10 } from "os";
-import { dirname as dirname10, isAbsolute as isAbsolute2, join as join12, relative as relative2, resolve as resolve12 } from "path";
+import { dirname as dirname10, join as join12 } from "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-plays",
+  "deepline-quickstart",
+  "find-qualified-titles",
+  "linkedin-url-lookup",
+  "niche-signal-discovery",
+  "portfolio-prospecting"
+];
+var DEFAULT_SDK_SKILL_NAMES = [...DEFAULT_V1_SKILL_NAMES];
+var LEGACY_SKILL_NAMES_TO_REMOVE = [
+  "deepline-plays-feedback",
+  "deepline-plays-quickstart",
+  "workflow-hello-world"
+];
+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 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 && existsSync10(dir) ? dir : "";
+}
+function readPluginSkillsVersion() {
+  const dir = activePluginSkillsDir();
+  if (!dir) return "";
+  try {
+    return readFileSync10(join12(dir, ".version"), "utf-8").trim();
+  } catch {
+    return "";
+  }
+}
+function sdkSkillsVersionPath(baseUrl) {
+  const home = process.env.HOME?.trim() || homedir10();
+  return join12(
+    home,
+    ".local",
+    "deepline",
+    baseUrlSlug(baseUrl),
+    "sdk-skills",
+    ".version"
+  );
+}
+function readLocalSkillsVersion(baseUrl) {
+  const pluginVersion = readPluginSkillsVersion();
+  if (pluginVersion) return pluginVersion;
+  const path = sdkSkillsVersionPath(baseUrl);
+  if (!existsSync10(path)) return "";
+  try {
+    return readFileSync10(path, "utf-8").trim();
+  } catch {
+    return "";
+  }
+}
+function writeLocalSkillsVersion(baseUrl, version) {
+  const path = sdkSkillsVersionPath(baseUrl);
+  mkdirSync8(dirname10(path), { recursive: true });
+  writeFileSync13(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);
+}
+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 = spawnSync2(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 = spawn2(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 runLegacySkillsCleanup() {
+  const candidates = hasCommand("bunx") ? [
+    {
+      command: "bunx",
+      args: [
+        "--bun",
+        "skills",
+        "remove",
+        "--global",
+        "-y",
+        ...LEGACY_SKILL_NAMES_TO_REMOVE
+      ]
+    },
+    {
+      command: "npx",
+      args: [
+        "--yes",
+        "skills",
+        "remove",
+        "--global",
+        "-y",
+        ...LEGACY_SKILL_NAMES_TO_REMOVE
+      ]
+    }
+  ] : [
+    {
+      command: "npx",
+      args: [
+        "--yes",
+        "skills",
+        "remove",
+        "--global",
+        "-y",
+        ...LEGACY_SKILL_NAMES_TO_REMOVE
+      ]
+    }
+  ];
+  for (const candidate of candidates) {
+    const result = spawnSync2(candidate.command, candidate.args, {
+      stdio: "ignore",
+      shell: process.platform === "win32"
+    });
+    if (result.status === 0) return;
+  }
+}
+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;
+  runLegacySkillsCleanup();
+  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`;
 }
@@ -21305,11 +21690,11 @@ function sidecarStateDir(input2) {
   if (!scope || scope.includes("/") || scope.includes("\\")) {
     return null;
   }
-  return join12(input2.homeDir, ".local", "deepline", scope, "sdk-cli");
+  return join13(input2.homeDir, ".local", "deepline", scope, "sdk-cli");
 }
 function readOptionalText(path) {
   try {
-    return readFileSync10(path, "utf8").trim();
+    return readFileSync11(path, "utf8").trim();
   } catch {
     return "";
   }
@@ -21324,19 +21709,19 @@ function resolvePythonSidecarUpdatePlan(options) {
   if (!relativeEntrypoint || relativeEntrypoint.startsWith("..") || isAbsolute2(relativeEntrypoint)) {
     return null;
   }
-  const installMethod = readOptionalText(join12(stateDir, ".install-method"));
+  const installMethod = readOptionalText(join13(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(join12(stateDir, ".node-bin")) || process.execPath;
-  const sidecarPath = readOptionalText(join12(stateDir, ".command-path")) || join12(
+  const nodeBin = readOptionalText(join13(stateDir, ".node-bin")) || process.execPath;
+  const sidecarPath = readOptionalText(join13(stateDir, ".command-path")) || join13(
     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(join12(stateDir, "versions", "<version>"))} --no-audit --no-fund ${shellQuote3(packageSpec)}`;
+  const manualCommand = `${npmCommand} install --prefix ${shellQuote4(join13(stateDir, "versions", "<version>"))} --no-audit --no-fund ${shellQuote4(packageSpec)}`;
   return {
     kind: "python-sidecar",
     stateDir,
@@ -21352,10 +21737,10 @@ function resolvePythonSidecarUpdatePlan(options) {
 function findRepoBackedSdkRoot(startPath) {
   let current = resolve12(startPath);
   while (true) {
-    if (existsSync10(join12(current, "sdk", "package.json")) && existsSync10(join12(current, "sdk", "bin", "deepline-dev.ts"))) {
+    if (existsSync11(join13(current, "sdk", "package.json")) && existsSync11(join13(current, "sdk", "bin", "deepline-dev.ts"))) {
       return current;
     }
-    const parent = dirname10(current);
+    const parent = dirname11(current);
     if (parent === current) return null;
     current = parent;
   }
@@ -21383,9 +21768,9 @@ function inferNpmGlobalPrefixFromEntrypoint(entrypoint) {
 }
 function resolveUpdatePlan(options = {}) {
   const env = options.env ?? process.env;
-  const homeDir2 = options.homeDir ?? homedir10();
+  const homeDir2 = options.homeDir ?? homedir11();
   const entrypoint = options.entrypoint ?? (process.argv[1] ? resolve12(process.argv[1]) : "");
-  const sourceRoot = entrypoint ? findRepoBackedSdkRoot(dirname10(entrypoint)) : null;
+  const sourceRoot = entrypoint ? findRepoBackedSdkRoot(dirname11(entrypoint)) : null;
   if (sourceRoot) {
     return {
       kind: "source",
@@ -21409,17 +21794,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 join12(plan.stateDir, AUTO_UPDATE_FAILURE_FILE);
+    return join13(plan.stateDir, AUTO_UPDATE_FAILURE_FILE);
   }
-  return join12(
-    homedir10(),
+  return join13(
+    homedir11(),
     ".local",
     "deepline",
     "sdk-cli",
@@ -21436,7 +21821,7 @@ function readAutoUpdateFailure(plan) {
   if (!path) return null;
   try {
     const parsed = JSON.parse(
-      readFileSync10(path, "utf8")
+      readFileSync11(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;
@@ -21457,8 +21842,8 @@ function writeAutoUpdateFailure(plan, exitCode) {
     manualCommand: plan.manualCommand
   };
   try {
-    mkdirSync8(dirname10(path), { recursive: true });
-    writeFileSync13(path, `${JSON.stringify(marker, null, 2)}
+    mkdirSync9(dirname11(path), { recursive: true });
+    writeFileSync14(path, `${JSON.stringify(marker, null, 2)}
 `, "utf8");
   } catch {
   }
@@ -21503,7 +21888,7 @@ function safeVersionSegment(value) {
   return /^[0-9A-Za-z._-]+$/.test(normalized) ? normalized : "";
 }
 function entryPathInVersionDir(versionDir) {
-  return join12(
+  return join13(
     versionDir,
     "node_modules",
     "deepline",
@@ -21513,14 +21898,14 @@ function entryPathInVersionDir(versionDir) {
   );
 }
 function installedPackageVersion(versionDir) {
-  const packageJsonPath = join12(
+  const packageJsonPath = join13(
     versionDir,
     "node_modules",
     "deepline",
     "package.json"
   );
   try {
-    const parsed = JSON.parse(readFileSync10(packageJsonPath, "utf8"));
+    const parsed = JSON.parse(readFileSync11(packageJsonPath, "utf8"));
     return typeof parsed.version === "string" ? safeVersionSegment(parsed.version) : "";
   } catch {
     return "";
@@ -21528,7 +21913,7 @@ function installedPackageVersion(versionDir) {
 }
 function runCommand(command, args, env = process.env) {
   return new Promise((resolveExitCode) => {
-    const child = spawn2(command, args, {
+    const child = spawn3(command, args, {
       stdio: "inherit",
       shell: process.platform === "win32",
       env
@@ -21544,9 +21929,9 @@ function runCommand(command, args, env = process.env) {
   });
 }
 function writeSidecarLauncher(input2) {
-  mkdirSync8(dirname10(input2.path), { recursive: true });
+  mkdirSync9(dirname11(input2.path), { recursive: true });
   if (process.platform === "win32") {
-    writeFileSync13(
+    writeFileSync14(
       input2.path,
       [
         `@set DEEPLINE_HOST_URL=${input2.hostUrl.replace(/\r?\n/g, "")}`,
@@ -21558,30 +21943,30 @@ function writeSidecarLauncher(input2) {
     );
     return;
   }
-  writeFileSync13(
+  writeFileSync14(
     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 = join12(plan.stateDir, "versions");
-  const tempDir = join12(
+  const versionsDir = join13(plan.stateDir, "versions");
+  const tempDir = join13(
     versionsDir,
     `.tmp-sdk-update-${process.pid}-${Date.now()}`
   );
   rmSync3(tempDir, { recursive: true, force: true });
-  mkdirSync8(tempDir, { recursive: true });
-  writeFileSync13(join12(tempDir, "package.json"), '{"private":true}\n', "utf8");
+  mkdirSync9(tempDir, { recursive: true });
+  writeFileSync14(join13(tempDir, "package.json"), '{"private":true}\n', "utf8");
   const env = {
     ...process.env,
-    PATH: `${dirname10(plan.nodeBin)}${process.platform === "win32" ? ";" : ":"}${process.env.PATH ?? ""}`
+    PATH: `${dirname11(plan.nodeBin)}${process.platform === "win32" ? ";" : ":"}${process.env.PATH ?? ""}`
   };
   const installExitCode = await runCommand(
     plan.npmCommand,
@@ -21607,9 +21992,9 @@ async function runPythonSidecarUpdatePlan(plan) {
     rmSync3(tempDir, { recursive: true, force: true });
     return 1;
   }
-  const finalDir = join12(versionsDir, installedVersion);
+  const finalDir = join13(versionsDir, installedVersion);
   const finalEntryPath = entryPathInVersionDir(finalDir);
-  if (existsSync10(finalEntryPath)) {
+  if (existsSync11(finalEntryPath)) {
     rmSync3(tempDir, { recursive: true, force: true });
   } else {
     rmSync3(finalDir, { recursive: true, force: true });
@@ -21624,7 +22009,7 @@ async function runPythonSidecarUpdatePlan(plan) {
       return 1;
     }
   }
-  if (!existsSync10(finalEntryPath)) {
+  if (!existsSync11(finalEntryPath)) {
     process.stderr.write(
       `Updated Deepline SDK CLI entrypoint missing: ${finalEntryPath}
 `
@@ -21638,28 +22023,28 @@ async function runPythonSidecarUpdatePlan(plan) {
     nodeBin: plan.nodeBin,
     entryPath: finalEntryPath
   });
-  writeFileSync13(
-    join12(plan.stateDir, ".version"),
+  writeFileSync14(
+    join13(plan.stateDir, ".version"),
     `${installedVersion}
 `,
     "utf8"
   );
-  writeFileSync13(
-    join12(plan.stateDir, ".install-method"),
+  writeFileSync14(
+    join13(plan.stateDir, ".install-method"),
     "python-sidecar\n",
     "utf8"
   );
-  writeFileSync13(
-    join12(plan.stateDir, ".command-path"),
+  writeFileSync14(
+    join13(plan.stateDir, ".command-path"),
     `${plan.sidecarPath}
 `,
     "utf8"
   );
-  writeFileSync13(join12(plan.stateDir, ".runner"), "node\n", "utf8");
-  writeFileSync13(join12(plan.stateDir, ".node-bin"), `${plan.nodeBin}
+  writeFileSync14(join13(plan.stateDir, ".runner"), "node\n", "utf8");
+  writeFileSync14(join13(plan.stateDir, ".node-bin"), `${plan.nodeBin}
 `, "utf8");
-  writeFileSync13(
-    join12(plan.stateDir, ".entry-path"),
+  writeFileSync14(
+    join13(plan.stateDir, ".entry-path"),
     `${finalEntryPath}
 `,
     "utf8"
@@ -21680,8 +22065,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: [
       {
@@ -21717,11 +22110,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(
@@ -21740,151 +22136,49 @@ 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);
   });
 }
 
 // ../shared_libs/cli/command-compatibility.json
-var command_compatibility_default = {
-  enrich: {
-    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;
-}
+var command_compatibility_default = {
+  enrich: {
+    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"
+  }
+};
 
 // src/cli/command-compatibility.ts
 var COMMAND_COMPATIBILITY = command_compatibility_default;
@@ -21939,7 +22233,7 @@ function unknownCommandNameFromMessage(message) {
 }
 
 // src/cli/self-update.ts
-import { spawn as spawn3 } from "child_process";
+import { spawn as spawn4 } from "child_process";
 function envTruthy(name) {
   const value = process.env[name]?.trim().toLowerCase();
   return value === "1" || value === "true" || value === "yes";
@@ -21954,7 +22248,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 = spawn3(command, args, {
+    const child = spawn4(command, args, {
       stdio: "inherit",
       shell: process.platform === "win32",
       env: {
@@ -22009,238 +22303,6 @@ async function maybeAutoUpdateAndRelaunch(response) {
   return true;
 }
 
-// src/cli/skills-sync.ts
-import { spawn as spawn4, spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync11, mkdirSync as mkdirSync9, readFileSync as readFileSync11, writeFileSync as writeFileSync14 } from "fs";
-import { homedir as homedir11 } from "os";
-import { dirname as dirname11, join as join13 } from "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 && existsSync11(dir) ? dir : "";
-}
-function readPluginSkillsVersion() {
-  const dir = activePluginSkillsDir();
-  if (!dir) return "";
-  try {
-    return readFileSync11(join13(dir, ".version"), "utf-8").trim();
-  } catch {
-    return "";
-  }
-}
-function sdkSkillsVersionPath(baseUrl) {
-  const home = process.env.HOME?.trim() || homedir11();
-  return join13(
-    home,
-    ".local",
-    "deepline",
-    baseUrlSlug(baseUrl),
-    "sdk-skills",
-    ".version"
-  );
-}
-function readLocalSkillsVersion(baseUrl) {
-  const pluginVersion = readPluginSkillsVersion();
-  if (pluginVersion) return pluginVersion;
-  const path = sdkSkillsVersionPath(baseUrl);
-  if (!existsSync11(path)) return "";
-  try {
-    return readFileSync11(path, "utf-8").trim();
-  } catch {
-    return "";
-  }
-}
-function writeLocalSkillsVersion(baseUrl, version) {
-  const path = sdkSkillsVersionPath(baseUrl);
-  mkdirSync9(dirname11(path), { recursive: true });
-  writeFileSync14(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 = spawnSync2(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 = spawn4(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
 import { hostname as hostname2, platform as platform2, release } from "os";
 var FAILURE_REPORT_DISABLE_ENV = "DEEPLINE_DISABLE_FAILURE_REPORTING";