deepline 0.1.297 → 0.1.299

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

@@ -93,6 +93,7 @@ import {
   normalizePlayRuntimeSelection,
   type PlayRuntimeSelection,
 } from '../../shared_libs/play-runtime/runtime-environment.js';
+import { decodePlayRunPublicStatus } from '../../shared_libs/play-runtime/run-lifecycle-policy.js';
 
 const TERMINAL_PLAY_STATUSES = new Set(['completed', 'failed', 'cancelled']);
 const INCLUDE_TOOL_METADATA_HEADER = 'x-deepline-include-tool-metadata';
@@ -991,12 +992,18 @@ function normalizePlayStatus(raw: Record<string, unknown>): PlayStatus {
       ? raw.package
       : null;
   const packageRun = runPackage?.run;
-  const status =
+  const rawStatus =
     typeof raw.status === 'string'
       ? raw.status
       : typeof packageRun?.status === 'string'
         ? packageRun.status
-        : 'running';
+        : null;
+  const status = decodePlayRunPublicStatus(rawStatus);
+  if (!status) {
+    throw new Error(
+      `Invalid play run lifecycle status in API response: ${JSON.stringify(rawStatus)}.`,
+    );
+  }
   const runId =
     typeof raw.runId === 'string'
       ? raw.runId
@@ -1007,7 +1014,7 @@ function normalizePlayStatus(raw: Record<string, unknown>): PlayStatus {
     ...(raw as unknown as Omit<PlayStatus, 'runId' | 'status'>),
     runId,
     ...(runPackage ? { package: runPackage, outputs: runPackage.outputs } : {}),
-    status: status as PlayStatus['status'],
+    status,
   };
 }
 

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

@@ -155,7 +155,7 @@ export const SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: '0.1.297',
+  version: '0.1.299',
   contracts: {
     api: {
       name: 'sdk-http-api',

package/dist/bundling-sources/shared_libs/play-runtime/run-ledger.ts

@@ -3,7 +3,6 @@ import {
   PLATFORM_DEPLOY_INTERRUPTED_MESSAGE,
 } from './run-failure';
 import {
-  isAuthoritativePlayRunTerminalSource,
   nextPlayRunLedgerTerminalSource,
   normalizePlayRunLedgerTerminalSource,
 } from './run-terminal-source';
@@ -643,16 +642,6 @@ function nextTerminalSource(
   });
 }
 
-function shouldUpgradeFromCoordinatorTerminal(
-  base: PlayRunLedgerSnapshot,
-  eventSource: PlayRunLedgerEventSource,
-): boolean {
-  return (
-    base.terminalSource === 'coordinator' &&
-    isAuthoritativePlayRunTerminalSource(eventSource)
-  );
-}
-
 function shouldIgnoreNonTerminalAfterStickyTerminal(
   base: PlayRunLedgerSnapshot,
 ): boolean {
@@ -908,13 +897,10 @@ function appendLogLines(
 }
 
 /**
- * Terminal-status precedence. Conflicting terminal events use
- * newest-terminal-wins by event time: older events are ignored and logged,
- * newer events reconcile the snapshot. Same-status terminal events continue to
- * the reducer so recovery/transport paths can fill in canonical payloads after
- * an earlier partial terminal snapshot. Retryable platform-deploy failures are
- * the narrow exception: they are never allowed to replace a real terminal
- * result from the runtime.
+ * Terminal-status precedence. The first accepted run terminal is immutable:
+ * later events may enrich the same terminal payload, but may never change its
+ * outcome. Attempt retries are not authority to rewrite a terminal run, and
+ * producer timestamps are telemetry rather than an ordering mechanism.
  */
 function conflictingTerminalSnapshot(
   base: PlayRunLedgerSnapshot,
@@ -923,26 +909,12 @@ function conflictingTerminalSnapshot(
   eventError?: string | null,
   options?: {
     allowStaleSameStatusPayloadMerge?: boolean;
-    allowCoordinatorTerminalUpgrade?: boolean;
   },
 ): PlayRunLedgerSnapshot | null {
   if (!isTerminalPlayRunLedgerStatus(base.status)) {
     return null;
   }
   const terminalAt = base.finishedAt ?? base.updatedAt ?? 0;
-  if (base.status === 'cancelled' && eventType !== 'run.cancelled') {
-    if (occurredAt <= terminalAt) {
-      return withTiming(
-        appendLogLines(base, [
-          `[ledger] stale conflicting terminal event ${eventType} ignored; status already ${base.status}`,
-        ]),
-      );
-    }
-    return withTiming(base);
-  }
-  if (options?.allowCoordinatorTerminalUpgrade === true) {
-    return null;
-  }
   if (
     base.status === 'completed' &&
     eventType === 'run.failed' &&
@@ -970,12 +942,6 @@ function conflictingTerminalSnapshot(
     }
     return null;
   }
-  if (occurredAt > terminalAt) {
-    // Newer terminal evidence reconciles the run. This covers replay/receipt
-    // races where an earlier attempt failed but a later attempt recovered and
-    // completed with the durable result.
-    return null;
-  }
   return withTiming(
     appendLogLines(base, [
       `[ledger] stale conflicting terminal event ${eventType} ignored; status already ${base.status}`,
@@ -1205,12 +1171,7 @@ export function reducePlayRunLedgerEvent(
     case 'run.completed':
       return (
         conflictingTerminalSnapshot(base, event.type, occurredAt, null, {
-          allowCoordinatorTerminalUpgrade: shouldUpgradeFromCoordinatorTerminal(
-            base,
-            event.source,
-          ),
           allowStaleSameStatusPayloadMerge:
-            shouldUpgradeFromCoordinatorTerminal(base, event.source) ||
             (base.result === undefined && event.result !== undefined) ||
             (base.resultSummary === undefined &&
               event.resultSummary !== undefined),
@@ -1234,7 +1195,6 @@ export function reducePlayRunLedgerEvent(
         retryablePlatformDeployFailureSnapshot(base, event.error) ??
         conflictingTerminalSnapshot(base, event.type, occurredAt, event.error, {
           allowStaleSameStatusPayloadMerge:
-            shouldUpgradeFromCoordinatorTerminal(base, event.source) ||
             (base.error == null && event.error != null) ||
             (base.result === undefined && event.result !== undefined),
         }) ??
@@ -1258,7 +1218,6 @@ export function reducePlayRunLedgerEvent(
       return (
         conflictingTerminalSnapshot(base, event.type, occurredAt, event.error, {
           allowStaleSameStatusPayloadMerge:
-            shouldUpgradeFromCoordinatorTerminal(base, event.source) ||
             (base.error == null && event.error != null) ||
             (base.result === undefined && event.result !== undefined),
         }) ??

package/dist/bundling-sources/shared_libs/play-runtime/run-lifecycle-policy.ts

@@ -9,6 +9,15 @@ export type PlayRunLifecycleStatus =
   | 'timed_out'
   | 'unknown';
 
+/** The only lifecycle states exposed by the API, SDK, CLI, and UI. */
+export type PlayRunPublicStatus =
+  | 'queued'
+  | 'running'
+  | 'waiting'
+  | 'completed'
+  | 'failed'
+  | 'cancelled';
+
 const TERMINAL_PLAY_RUN_STATUSES = new Set<PlayRunLifecycleStatus>([
   'completed',
   'failed',
@@ -33,7 +42,7 @@ export function normalizePlayRunLifecycleStatus(
   switch (normalized) {
     case 'queued':
     case 'pending':
-      return 'running';
+      return 'queued';
     case 'running':
     case 'started':
       return 'running';
@@ -60,12 +69,43 @@ export function normalizePlayRunLifecycleStatus(
 }
 
 export function isTerminalPlayRunLifecycleStatus(status: unknown): boolean {
-  return TERMINAL_PLAY_RUN_STATUSES.has(normalizePlayRunLifecycleStatus(status));
+  return TERMINAL_PLAY_RUN_STATUSES.has(
+    normalizePlayRunLifecycleStatus(status),
+  );
 }
 
 export function isActivePlayRunLifecycleStatus(status: unknown): boolean {
   const normalized = normalizePlayRunLifecycleStatus(status);
-  return normalized === 'running' || normalized === 'waiting';
+  return (
+    normalized === 'queued' ||
+    normalized === 'running' ||
+    normalized === 'waiting'
+  );
+}
+
+/**
+ * Decode a public lifecycle value without inventing progress. Internal
+ * termination reasons intentionally collapse to the one public cancellation
+ * outcome at this Adapter boundary. Unknown/missing values are invalid.
+ */
+export function decodePlayRunPublicStatus(
+  value: unknown,
+): PlayRunPublicStatus | null {
+  const status = normalizePlayRunLifecycleStatus(value);
+  switch (status) {
+    case 'queued':
+    case 'running':
+    case 'waiting':
+    case 'completed':
+    case 'failed':
+    case 'cancelled':
+      return status;
+    case 'terminated':
+    case 'timed_out':
+      return 'cancelled';
+    case 'unknown':
+      return null;
+  }
 }
 
 export function isRecoverableDatasetRowStatus(status: unknown): boolean {

package/dist/cli/index.js

@@ -718,7 +718,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.297",
+  version: "0.1.299",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -2113,7 +2113,7 @@ function normalizePlayRunLifecycleStatus(value) {
   switch (normalized) {
     case "queued":
     case "pending":
-      return "running";
+      return "queued";
     case "running":
     case "started":
       return "running";
@@ -2139,7 +2139,26 @@ function normalizePlayRunLifecycleStatus(value) {
   }
 }
 function isTerminalPlayRunLifecycleStatus(status) {
-  return TERMINAL_PLAY_RUN_STATUSES.has(normalizePlayRunLifecycleStatus(status));
+  return TERMINAL_PLAY_RUN_STATUSES.has(
+    normalizePlayRunLifecycleStatus(status)
+  );
+}
+function decodePlayRunPublicStatus(value) {
+  const status = normalizePlayRunLifecycleStatus(value);
+  switch (status) {
+    case "queued":
+    case "running":
+    case "waiting":
+    case "completed":
+    case "failed":
+    case "cancelled":
+      return status;
+    case "terminated":
+    case "timed_out":
+      return "cancelled";
+    case "unknown":
+      return null;
+  }
 }
 
 // ../shared_libs/play-runtime/run-snapshot-stream.ts
@@ -3080,7 +3099,13 @@ function isPlayRunPackage(value) {
 function normalizePlayStatus(raw) {
   const runPackage = isPlayRunPackage(raw) ? raw : isPlayRunPackage(raw.package) ? raw.package : null;
   const packageRun = runPackage?.run;
-  const status = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : "running";
+  const rawStatus = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : null;
+  const status = decodePlayRunPublicStatus(rawStatus);
+  if (!status) {
+    throw new Error(
+      `Invalid play run lifecycle status in API response: ${JSON.stringify(rawStatus)}.`
+    );
+  }
   const runId = typeof raw.runId === "string" ? raw.runId : typeof raw.workflowId === "string" ? raw.workflowId : packageRun?.id ?? "";
   return {
     ...raw,
@@ -29914,6 +29939,7 @@ var install_commands_default = {
 
 // src/cli/install-commands.ts
 var INSTALL_COMMANDS = install_commands_default;
+var DEFAULT_SKILL_AGENTS = INSTALL_COMMANDS.skills.default_agents;
 var DEFAULT_V1_SKILL_NAMES = [
   "build-tam",
   "clay-to-deepline",
@@ -29950,9 +29976,10 @@ function skillsIndexUrl(baseUrl) {
 function buildSkillsAddArgs(baseUrl, skillName, options = {}) {
   const skillNames = Array.isArray(skillName) ? skillName : [skillName];
   const [firstSkillName, ...extraSkillNames] = skillNames;
+  const agents = options.agents ?? INSTALL_COMMANDS.skills.default_agents;
   const values = {
     skills_index_url: skillsIndexUrl(baseUrl),
-    agents: INSTALL_COMMANDS.skills.default_agents.join(" "),
+    agents: agents.join(" "),
     skill_name: firstSkillName ?? ""
   };
   const rendered = INSTALL_COMMANDS.skills.npx_add_args_template.flatMap(
@@ -29960,10 +29987,13 @@ function buildSkillsAddArgs(baseUrl, skillName, options = {}) {
       const next = index === 0 && options.firstArg ? options.firstArg : arg;
       const value = renderTemplate(next, values);
       if (arg === "{agents}") {
-        return INSTALL_COMMANDS.skills.default_agents;
+        return agents;
       }
       if (arg === "{skill_name}") {
-        return [value, ...extraSkillNames.flatMap((name) => ["--skill", name])];
+        return [
+          value,
+          ...extraSkillNames.flatMap((name) => ["--skill", name])
+        ];
       }
       return value;
     }
@@ -29984,6 +30014,29 @@ function sdkNpmGlobalInstallCommand() {
   return INSTALL_COMMANDS.cli.sdk_npm_global;
 }
 
+// src/cli/windows-arg-escape.ts
+var CMD_META_CHARS = /([()\][%!^"`<>&|;, *?])/g;
+function escapeCmdArgument(arg, forBatchFile = true) {
+  let escaped = arg.replace(/(\\*)"/g, '$1$1\\"');
+  escaped = escaped.replace(/(\\*)$/, "$1$1");
+  escaped = `"${escaped}"`;
+  escaped = escaped.replace(CMD_META_CHARS, "^$1");
+  return forBatchFile ? escaped.replace(CMD_META_CHARS, "^$1") : escaped;
+}
+function escapeCmdCommand(command) {
+  return command.replace(CMD_META_CHARS, "^$1");
+}
+function resolveShellSpawn(command, args, platform3 = process.platform) {
+  if (platform3 !== "win32") {
+    return { command, args: [...args], shell: false };
+  }
+  return {
+    command: escapeCmdCommand(command),
+    args: args.map((arg) => escapeCmdArgument(arg)),
+    shell: true
+  };
+}
+
 // src/cli/commands/skills.ts
 var RUNTIME_TO_SKILLS_AGENT = {
   antigravity: "antigravity",
@@ -30149,11 +30202,12 @@ function readSkillsInstallState(path) {
 }
 function runProcess(command, args, cwd) {
   return new Promise((resolve15, reject) => {
-    const child = (0, import_node_child_process2.spawn)(command, args, {
+    const plan = resolveShellSpawn(command, args);
+    const child = (0, import_node_child_process2.spawn)(plan.command, plan.args, {
       cwd,
       env: process.env,
       stdio: ["ignore", "ignore", "pipe"],
-      shell: process.platform === "win32"
+      shell: plan.shell
     });
     let stderr = "";
     child.stderr.on("data", (chunk) => {
@@ -30695,9 +30749,10 @@ function installedPackageVersion(versionDir) {
 function runCommand(command, args, env = process.env) {
   return new Promise((resolveResult) => {
     let output2 = "";
-    const child = (0, import_node_child_process3.spawn)(command, args, {
+    const plan = resolveShellSpawn(command, args);
+    const child = (0, import_node_child_process3.spawn)(plan.command, plan.args, {
       stdio: ["inherit", "pipe", "pipe"],
-      shell: process.platform === "win32",
+      shell: plan.shell,
       env
     });
     child.stdout?.on("data", (chunk) => {
@@ -31240,19 +31295,27 @@ function isHomebrewFormulaCommand(path) {
   const cellarIndex = parts.lastIndexOf("Cellar");
   return cellarIndex >= 0 && parts[cellarIndex + 1] === "deepline" && parts.slice(cellarIndex + 3).includes("libexec");
 }
-function resolvePersistentGlobalCommand(pathClis) {
+function resolvePersistentGlobalCommand(dependencies = {}) {
+  const platform3 = dependencies.platform ?? process.platform;
+  const run = dependencies.spawn ?? import_node_child_process4.spawnSync;
+  const pathExists = dependencies.exists ?? import_node_fs18.existsSync;
+  const pathClis = dependencies.pathClis ?? resolvePathCommands("deepline");
   const homebrewCommand = pathClis.find(isHomebrewFormulaCommand);
   if (homebrewCommand) return homebrewCommand;
-  const prefix = (0, import_node_child_process4.spawnSync)("npm", ["prefix", "-g"], { encoding: "utf8" });
+  const plan = resolveShellSpawn("npm", ["prefix", "-g"], platform3);
+  const prefix = run(plan.command, plan.args, {
+    encoding: "utf8",
+    shell: plan.shell
+  });
   if (prefix.status !== 0) return null;
   const root = String(prefix.stdout ?? "").trim();
   if (!root) return null;
-  const candidates = process.platform === "win32" ? [(0, import_node_path20.join)(root, "deepline.cmd"), (0, import_node_path20.join)(root, "deepline")] : [(0, import_node_path20.join)(root, "bin", "deepline")];
-  return candidates.find((candidate) => (0, import_node_fs18.existsSync)(candidate)) ?? null;
+  const candidates = platform3 === "win32" ? [(0, import_node_path20.join)(root, "deepline.cmd"), (0, import_node_path20.join)(root, "deepline")] : [(0, import_node_path20.join)(root, "bin", "deepline")];
+  return candidates.find((candidate) => pathExists(candidate)) ?? null;
 }
 function inspectGlobalCliAvailability(input2) {
   const pathClis = input2?.pathClis ?? resolvePathCommands("deepline");
-  const persistentPath = input2 && "persistentGlobalCli" in input2 ? input2.persistentGlobalCli ?? null : resolvePersistentGlobalCommand(pathClis);
+  const persistentPath = input2 && "persistentGlobalCli" in input2 ? input2.persistentGlobalCli ?? null : resolvePersistentGlobalCommand({ pathClis });
   const path = persistentPath ? pathClis.find(
     (candidate) => pathsResolveToSameFile(candidate, persistentPath)
   ) ?? null : null;
@@ -32272,28 +32335,51 @@ async function fetchSkillsUpdate(baseUrl, localVersion) {
     clearTimeout(timeout);
   }
 }
-function buildSkillsInstallArgs(baseUrl, skillNames = DEFAULT_SDK_SKILL_NAMES) {
-  return buildSkillsAddArgs(baseUrl, sortedUniqueSkillNames(skillNames));
+function buildSkillsInstallArgs(baseUrl, skillNames = DEFAULT_SDK_SKILL_NAMES, agents) {
+  return buildSkillsAddArgs(baseUrl, sortedUniqueSkillNames(skillNames), {
+    agents
+  });
 }
-function buildBunxSkillsInstallArgs(baseUrl, skillNames) {
+function buildBunxSkillsInstallArgs(baseUrl, skillNames, agents) {
   return buildSkillsAddArgs(baseUrl, sortedUniqueSkillNames(skillNames), {
-    firstArg: "--bun"
+    firstArg: "--bun",
+    agents
   });
 }
+function resolveAutoSyncSkillAgents() {
+  switch (detectAgentRuntime()) {
+    case "codex":
+      return ["codex"];
+    case "claude_code":
+      return ["claude-code"];
+    case "cursor":
+      return ["cursor"];
+    case "gemini":
+      return ["gemini-cli"];
+    case "antigravity":
+      return ["antigravity"];
+    default:
+      return [];
+  }
+}
 function hasCommand(command) {
-  const result = (0, import_node_child_process6.spawnSync)(command, ["--version"], {
+  const plan = resolveShellSpawn(command, ["--version"]);
+  const result = (0, import_node_child_process6.spawnSync)(plan.command, plan.args, {
     stdio: "ignore",
-    shell: process.platform === "win32"
+    shell: plan.shell
   });
   return result.status === 0;
 }
 function shellQuote5(arg) {
   return `'${arg.replace(/'/g, `'\\''`)}'`;
 }
-function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NAMES) {
+function resolveSkillsInstallSpawn(install, platform3 = process.platform) {
+  return resolveShellSpawn(install.command, install.args, platform3);
+}
+function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NAMES, agents = DEFAULT_SKILL_AGENTS) {
   const commands = [];
   if (hasCommand("bunx")) {
-    const bunxArgs = buildBunxSkillsInstallArgs(baseUrl, skillNames);
+    const bunxArgs = buildBunxSkillsInstallArgs(baseUrl, skillNames, agents);
     commands.push({
       command: "bunx",
       args: bunxArgs,
@@ -32301,7 +32387,7 @@ function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NA
     });
   }
   if (hasCommand("npx")) {
-    const npxArgs = buildSkillsInstallArgs(baseUrl, skillNames);
+    const npxArgs = buildSkillsInstallArgs(baseUrl, skillNames, agents);
     commands.push({
       command: "npx",
       args: npxArgs,
@@ -32312,9 +32398,11 @@ function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NA
 }
 function runOneSkillsInstall(install) {
   return new Promise((resolve15) => {
-    const child = (0, import_node_child_process6.spawn)(install.command, install.args, {
+    const plan = resolveSkillsInstallSpawn(install);
+    const child = (0, import_node_child_process6.spawn)(plan.command, plan.args, {
       stdio: ["ignore", "ignore", "pipe"],
-      env: process.env
+      env: process.env,
+      shell: plan.shell
     });
     let stderr = "";
     child.stderr.on("data", (chunk) => {
@@ -32358,7 +32446,7 @@ ${details}` : ""}
   );
   return false;
 }
-function runLegacySkillsCleanup() {
+function runLegacySkillsCleanup(agents) {
   const candidates = hasCommand("bunx") ? [
     {
       command: "bunx",
@@ -32367,6 +32455,8 @@ function runLegacySkillsCleanup() {
         "skills",
         "remove",
         "--global",
+        "--agent",
+        ...agents,
         "-y",
         ...LEGACY_SKILL_NAMES_TO_REMOVE
       ]
@@ -32378,6 +32468,8 @@ function runLegacySkillsCleanup() {
         "skills",
         "remove",
         "--global",
+        "--agent",
+        ...agents,
         "-y",
         ...LEGACY_SKILL_NAMES_TO_REMOVE
       ]
@@ -32390,16 +32482,19 @@ function runLegacySkillsCleanup() {
         "skills",
         "remove",
         "--global",
+        "--agent",
+        ...agents,
         "-y",
         ...LEGACY_SKILL_NAMES_TO_REMOVE
       ]
     }
   ];
   for (const candidate of candidates) {
-    const result = (0, import_node_child_process6.spawnSync)(candidate.command, candidate.args, {
+    const plan = resolveShellSpawn(candidate.command, candidate.args);
+    const result = (0, import_node_child_process6.spawnSync)(plan.command, plan.args, {
       stdio: "ignore",
       env: process.env,
-      shell: process.platform === "win32"
+      shell: plan.shell
     });
     if (result.status === 0) return;
   }
@@ -32433,7 +32528,12 @@ async function syncSdkSkillsIfNeeded(baseUrl, options = {}) {
     remoteSkillNames.length > 0 ? remoteSkillNames : DEFAULT_SDK_SKILL_NAMES
   );
   if (skillNames.length === 0) return;
-  const installs = resolveSkillsInstallCommands(baseUrl, skillNames);
+  const agents = resolveAutoSyncSkillAgents();
+  if (agents.length === 0) {
+    writeUnavailableSkillsNotice(baseUrl, update.remoteVersion, skillNames);
+    return;
+  }
+  const installs = resolveSkillsInstallCommands(baseUrl, skillNames, agents);
   if (installs.length === 0) {
     writeUnavailableSkillsNotice(baseUrl, update.remoteVersion, skillNames);
     return;
@@ -32441,7 +32541,7 @@ async function syncSdkSkillsIfNeeded(baseUrl, options = {}) {
   writeSdkSkillsStatusLine("Deepline skills changed; syncing agent skills...");
   const installed = await runSkillsInstall(installs);
   if (!installed) return;
-  runLegacySkillsCleanup();
+  runLegacySkillsCleanup(agents);
   writeLocalSkillsVersion(baseUrl, update.remoteVersion);
   clearUnavailableSkillsNotice(baseUrl);
   writeSdkSkillsStatusLine("Deepline agent skills are up to date.");

package/dist/cli/index.mjs

@@ -703,7 +703,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.297",
+  version: "0.1.299",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -2098,7 +2098,7 @@ function normalizePlayRunLifecycleStatus(value) {
   switch (normalized) {
     case "queued":
     case "pending":
-      return "running";
+      return "queued";
     case "running":
     case "started":
       return "running";
@@ -2124,7 +2124,26 @@ function normalizePlayRunLifecycleStatus(value) {
   }
 }
 function isTerminalPlayRunLifecycleStatus(status) {
-  return TERMINAL_PLAY_RUN_STATUSES.has(normalizePlayRunLifecycleStatus(status));
+  return TERMINAL_PLAY_RUN_STATUSES.has(
+    normalizePlayRunLifecycleStatus(status)
+  );
+}
+function decodePlayRunPublicStatus(value) {
+  const status = normalizePlayRunLifecycleStatus(value);
+  switch (status) {
+    case "queued":
+    case "running":
+    case "waiting":
+    case "completed":
+    case "failed":
+    case "cancelled":
+      return status;
+    case "terminated":
+    case "timed_out":
+      return "cancelled";
+    case "unknown":
+      return null;
+  }
 }
 
 // ../shared_libs/play-runtime/run-snapshot-stream.ts
@@ -3065,7 +3084,13 @@ function isPlayRunPackage(value) {
 function normalizePlayStatus(raw) {
   const runPackage = isPlayRunPackage(raw) ? raw : isPlayRunPackage(raw.package) ? raw.package : null;
   const packageRun = runPackage?.run;
-  const status = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : "running";
+  const rawStatus = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : null;
+  const status = decodePlayRunPublicStatus(rawStatus);
+  if (!status) {
+    throw new Error(
+      `Invalid play run lifecycle status in API response: ${JSON.stringify(rawStatus)}.`
+    );
+  }
   const runId = typeof raw.runId === "string" ? raw.runId : typeof raw.workflowId === "string" ? raw.workflowId : packageRun?.id ?? "";
   return {
     ...raw,
@@ -29971,6 +29996,7 @@ var install_commands_default = {
 
 // src/cli/install-commands.ts
 var INSTALL_COMMANDS = install_commands_default;
+var DEFAULT_SKILL_AGENTS = INSTALL_COMMANDS.skills.default_agents;
 var DEFAULT_V1_SKILL_NAMES = [
   "build-tam",
   "clay-to-deepline",
@@ -30007,9 +30033,10 @@ function skillsIndexUrl(baseUrl) {
 function buildSkillsAddArgs(baseUrl, skillName, options = {}) {
   const skillNames = Array.isArray(skillName) ? skillName : [skillName];
   const [firstSkillName, ...extraSkillNames] = skillNames;
+  const agents = options.agents ?? INSTALL_COMMANDS.skills.default_agents;
   const values = {
     skills_index_url: skillsIndexUrl(baseUrl),
-    agents: INSTALL_COMMANDS.skills.default_agents.join(" "),
+    agents: agents.join(" "),
     skill_name: firstSkillName ?? ""
   };
   const rendered = INSTALL_COMMANDS.skills.npx_add_args_template.flatMap(
@@ -30017,10 +30044,13 @@ function buildSkillsAddArgs(baseUrl, skillName, options = {}) {
       const next = index === 0 && options.firstArg ? options.firstArg : arg;
       const value = renderTemplate(next, values);
       if (arg === "{agents}") {
-        return INSTALL_COMMANDS.skills.default_agents;
+        return agents;
       }
       if (arg === "{skill_name}") {
-        return [value, ...extraSkillNames.flatMap((name) => ["--skill", name])];
+        return [
+          value,
+          ...extraSkillNames.flatMap((name) => ["--skill", name])
+        ];
       }
       return value;
     }
@@ -30041,6 +30071,29 @@ function sdkNpmGlobalInstallCommand() {
   return INSTALL_COMMANDS.cli.sdk_npm_global;
 }
 
+// src/cli/windows-arg-escape.ts
+var CMD_META_CHARS = /([()\][%!^"`<>&|;, *?])/g;
+function escapeCmdArgument(arg, forBatchFile = true) {
+  let escaped = arg.replace(/(\\*)"/g, '$1$1\\"');
+  escaped = escaped.replace(/(\\*)$/, "$1$1");
+  escaped = `"${escaped}"`;
+  escaped = escaped.replace(CMD_META_CHARS, "^$1");
+  return forBatchFile ? escaped.replace(CMD_META_CHARS, "^$1") : escaped;
+}
+function escapeCmdCommand(command) {
+  return command.replace(CMD_META_CHARS, "^$1");
+}
+function resolveShellSpawn(command, args, platform3 = process.platform) {
+  if (platform3 !== "win32") {
+    return { command, args: [...args], shell: false };
+  }
+  return {
+    command: escapeCmdCommand(command),
+    args: args.map((arg) => escapeCmdArgument(arg)),
+    shell: true
+  };
+}
+
 // src/cli/commands/skills.ts
 var RUNTIME_TO_SKILLS_AGENT = {
   antigravity: "antigravity",
@@ -30206,11 +30259,12 @@ function readSkillsInstallState(path) {
 }
 function runProcess(command, args, cwd) {
   return new Promise((resolve15, reject) => {
-    const child = spawn2(command, args, {
+    const plan = resolveShellSpawn(command, args);
+    const child = spawn2(plan.command, plan.args, {
       cwd,
       env: process.env,
       stdio: ["ignore", "ignore", "pipe"],
-      shell: process.platform === "win32"
+      shell: plan.shell
     });
     let stderr = "";
     child.stderr.on("data", (chunk) => {
@@ -30752,9 +30806,10 @@ function installedPackageVersion(versionDir) {
 function runCommand(command, args, env = process.env) {
   return new Promise((resolveResult) => {
     let output2 = "";
-    const child = spawn3(command, args, {
+    const plan = resolveShellSpawn(command, args);
+    const child = spawn3(plan.command, plan.args, {
       stdio: ["inherit", "pipe", "pipe"],
-      shell: process.platform === "win32",
+      shell: plan.shell,
       env
     });
     child.stdout?.on("data", (chunk) => {
@@ -31305,19 +31360,27 @@ function isHomebrewFormulaCommand(path) {
   const cellarIndex = parts.lastIndexOf("Cellar");
   return cellarIndex >= 0 && parts[cellarIndex + 1] === "deepline" && parts.slice(cellarIndex + 3).includes("libexec");
 }
-function resolvePersistentGlobalCommand(pathClis) {
+function resolvePersistentGlobalCommand(dependencies = {}) {
+  const platform3 = dependencies.platform ?? process.platform;
+  const run = dependencies.spawn ?? spawnSync;
+  const pathExists = dependencies.exists ?? existsSync13;
+  const pathClis = dependencies.pathClis ?? resolvePathCommands("deepline");
   const homebrewCommand = pathClis.find(isHomebrewFormulaCommand);
   if (homebrewCommand) return homebrewCommand;
-  const prefix = spawnSync("npm", ["prefix", "-g"], { encoding: "utf8" });
+  const plan = resolveShellSpawn("npm", ["prefix", "-g"], platform3);
+  const prefix = run(plan.command, plan.args, {
+    encoding: "utf8",
+    shell: plan.shell
+  });
   if (prefix.status !== 0) return null;
   const root = String(prefix.stdout ?? "").trim();
   if (!root) return null;
-  const candidates = process.platform === "win32" ? [join16(root, "deepline.cmd"), join16(root, "deepline")] : [join16(root, "bin", "deepline")];
-  return candidates.find((candidate) => existsSync13(candidate)) ?? null;
+  const candidates = platform3 === "win32" ? [join16(root, "deepline.cmd"), join16(root, "deepline")] : [join16(root, "bin", "deepline")];
+  return candidates.find((candidate) => pathExists(candidate)) ?? null;
 }
 function inspectGlobalCliAvailability(input2) {
   const pathClis = input2?.pathClis ?? resolvePathCommands("deepline");
-  const persistentPath = input2 && "persistentGlobalCli" in input2 ? input2.persistentGlobalCli ?? null : resolvePersistentGlobalCommand(pathClis);
+  const persistentPath = input2 && "persistentGlobalCli" in input2 ? input2.persistentGlobalCli ?? null : resolvePersistentGlobalCommand({ pathClis });
   const path = persistentPath ? pathClis.find(
     (candidate) => pathsResolveToSameFile(candidate, persistentPath)
   ) ?? null : null;
@@ -32343,28 +32406,51 @@ async function fetchSkillsUpdate(baseUrl, localVersion) {
     clearTimeout(timeout);
   }
 }
-function buildSkillsInstallArgs(baseUrl, skillNames = DEFAULT_SDK_SKILL_NAMES) {
-  return buildSkillsAddArgs(baseUrl, sortedUniqueSkillNames(skillNames));
+function buildSkillsInstallArgs(baseUrl, skillNames = DEFAULT_SDK_SKILL_NAMES, agents) {
+  return buildSkillsAddArgs(baseUrl, sortedUniqueSkillNames(skillNames), {
+    agents
+  });
 }
-function buildBunxSkillsInstallArgs(baseUrl, skillNames) {
+function buildBunxSkillsInstallArgs(baseUrl, skillNames, agents) {
   return buildSkillsAddArgs(baseUrl, sortedUniqueSkillNames(skillNames), {
-    firstArg: "--bun"
+    firstArg: "--bun",
+    agents
   });
 }
+function resolveAutoSyncSkillAgents() {
+  switch (detectAgentRuntime()) {
+    case "codex":
+      return ["codex"];
+    case "claude_code":
+      return ["claude-code"];
+    case "cursor":
+      return ["cursor"];
+    case "gemini":
+      return ["gemini-cli"];
+    case "antigravity":
+      return ["antigravity"];
+    default:
+      return [];
+  }
+}
 function hasCommand(command) {
-  const result = spawnSync2(command, ["--version"], {
+  const plan = resolveShellSpawn(command, ["--version"]);
+  const result = spawnSync2(plan.command, plan.args, {
     stdio: "ignore",
-    shell: process.platform === "win32"
+    shell: plan.shell
   });
   return result.status === 0;
 }
 function shellQuote5(arg) {
   return `'${arg.replace(/'/g, `'\\''`)}'`;
 }
-function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NAMES) {
+function resolveSkillsInstallSpawn(install, platform3 = process.platform) {
+  return resolveShellSpawn(install.command, install.args, platform3);
+}
+function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NAMES, agents = DEFAULT_SKILL_AGENTS) {
   const commands = [];
   if (hasCommand("bunx")) {
-    const bunxArgs = buildBunxSkillsInstallArgs(baseUrl, skillNames);
+    const bunxArgs = buildBunxSkillsInstallArgs(baseUrl, skillNames, agents);
     commands.push({
       command: "bunx",
       args: bunxArgs,
@@ -32372,7 +32458,7 @@ function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NA
     });
   }
   if (hasCommand("npx")) {
-    const npxArgs = buildSkillsInstallArgs(baseUrl, skillNames);
+    const npxArgs = buildSkillsInstallArgs(baseUrl, skillNames, agents);
     commands.push({
       command: "npx",
       args: npxArgs,
@@ -32383,9 +32469,11 @@ function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NA
 }
 function runOneSkillsInstall(install) {
   return new Promise((resolve15) => {
-    const child = spawn5(install.command, install.args, {
+    const plan = resolveSkillsInstallSpawn(install);
+    const child = spawn5(plan.command, plan.args, {
       stdio: ["ignore", "ignore", "pipe"],
-      env: process.env
+      env: process.env,
+      shell: plan.shell
     });
     let stderr = "";
     child.stderr.on("data", (chunk) => {
@@ -32429,7 +32517,7 @@ ${details}` : ""}
   );
   return false;
 }
-function runLegacySkillsCleanup() {
+function runLegacySkillsCleanup(agents) {
   const candidates = hasCommand("bunx") ? [
     {
       command: "bunx",
@@ -32438,6 +32526,8 @@ function runLegacySkillsCleanup() {
         "skills",
         "remove",
         "--global",
+        "--agent",
+        ...agents,
         "-y",
         ...LEGACY_SKILL_NAMES_TO_REMOVE
       ]
@@ -32449,6 +32539,8 @@ function runLegacySkillsCleanup() {
         "skills",
         "remove",
         "--global",
+        "--agent",
+        ...agents,
         "-y",
         ...LEGACY_SKILL_NAMES_TO_REMOVE
       ]
@@ -32461,16 +32553,19 @@ function runLegacySkillsCleanup() {
         "skills",
         "remove",
         "--global",
+        "--agent",
+        ...agents,
         "-y",
         ...LEGACY_SKILL_NAMES_TO_REMOVE
       ]
     }
   ];
   for (const candidate of candidates) {
-    const result = spawnSync2(candidate.command, candidate.args, {
+    const plan = resolveShellSpawn(candidate.command, candidate.args);
+    const result = spawnSync2(plan.command, plan.args, {
       stdio: "ignore",
       env: process.env,
-      shell: process.platform === "win32"
+      shell: plan.shell
     });
     if (result.status === 0) return;
   }
@@ -32504,7 +32599,12 @@ async function syncSdkSkillsIfNeeded(baseUrl, options = {}) {
     remoteSkillNames.length > 0 ? remoteSkillNames : DEFAULT_SDK_SKILL_NAMES
   );
   if (skillNames.length === 0) return;
-  const installs = resolveSkillsInstallCommands(baseUrl, skillNames);
+  const agents = resolveAutoSyncSkillAgents();
+  if (agents.length === 0) {
+    writeUnavailableSkillsNotice(baseUrl, update.remoteVersion, skillNames);
+    return;
+  }
+  const installs = resolveSkillsInstallCommands(baseUrl, skillNames, agents);
   if (installs.length === 0) {
     writeUnavailableSkillsNotice(baseUrl, update.remoteVersion, skillNames);
     return;
@@ -32512,7 +32612,7 @@ async function syncSdkSkillsIfNeeded(baseUrl, options = {}) {
   writeSdkSkillsStatusLine("Deepline skills changed; syncing agent skills...");
   const installed = await runSkillsInstall(installs);
   if (!installed) return;
-  runLegacySkillsCleanup();
+  runLegacySkillsCleanup(agents);
   writeLocalSkillsVersion(baseUrl, update.remoteVersion);
   clearUnavailableSkillsNotice(baseUrl);
   writeSdkSkillsStatusLine("Deepline agent skills are up to date.");

package/dist/index.js

@@ -438,7 +438,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.297",
+  version: "0.1.299",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -1833,7 +1833,7 @@ function normalizePlayRunLifecycleStatus(value) {
   switch (normalized) {
     case "queued":
     case "pending":
-      return "running";
+      return "queued";
     case "running":
     case "started":
       return "running";
@@ -1859,7 +1859,26 @@ function normalizePlayRunLifecycleStatus(value) {
   }
 }
 function isTerminalPlayRunLifecycleStatus(status) {
-  return TERMINAL_PLAY_RUN_STATUSES.has(normalizePlayRunLifecycleStatus(status));
+  return TERMINAL_PLAY_RUN_STATUSES.has(
+    normalizePlayRunLifecycleStatus(status)
+  );
+}
+function decodePlayRunPublicStatus(value) {
+  const status = normalizePlayRunLifecycleStatus(value);
+  switch (status) {
+    case "queued":
+    case "running":
+    case "waiting":
+    case "completed":
+    case "failed":
+    case "cancelled":
+      return status;
+    case "terminated":
+    case "timed_out":
+      return "cancelled";
+    case "unknown":
+      return null;
+  }
 }
 
 // ../shared_libs/play-runtime/run-snapshot-stream.ts
@@ -2800,7 +2819,13 @@ function isPlayRunPackage(value) {
 function normalizePlayStatus(raw) {
   const runPackage = isPlayRunPackage(raw) ? raw : isPlayRunPackage(raw.package) ? raw.package : null;
   const packageRun = runPackage?.run;
-  const status = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : "running";
+  const rawStatus = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : null;
+  const status = decodePlayRunPublicStatus(rawStatus);
+  if (!status) {
+    throw new Error(
+      `Invalid play run lifecycle status in API response: ${JSON.stringify(rawStatus)}.`
+    );
+  }
   const runId = typeof raw.runId === "string" ? raw.runId : typeof raw.workflowId === "string" ? raw.workflowId : packageRun?.id ?? "";
   return {
     ...raw,

package/dist/index.mjs

@@ -367,7 +367,7 @@ var SDK_RELEASE = {
   // 0.1.253 makes play-page browser opening opt-in and retires --no-open.
   // 0.1.254 removes the internal operations tree from the published SDK CLI.
   // Operators use the checkout-local deepline-admin binary instead.
-  version: "0.1.297",
+  version: "0.1.299",
   contracts: {
     api: {
       name: "sdk-http-api",
@@ -1762,7 +1762,7 @@ function normalizePlayRunLifecycleStatus(value) {
   switch (normalized) {
     case "queued":
     case "pending":
-      return "running";
+      return "queued";
     case "running":
     case "started":
       return "running";
@@ -1788,7 +1788,26 @@ function normalizePlayRunLifecycleStatus(value) {
   }
 }
 function isTerminalPlayRunLifecycleStatus(status) {
-  return TERMINAL_PLAY_RUN_STATUSES.has(normalizePlayRunLifecycleStatus(status));
+  return TERMINAL_PLAY_RUN_STATUSES.has(
+    normalizePlayRunLifecycleStatus(status)
+  );
+}
+function decodePlayRunPublicStatus(value) {
+  const status = normalizePlayRunLifecycleStatus(value);
+  switch (status) {
+    case "queued":
+    case "running":
+    case "waiting":
+    case "completed":
+    case "failed":
+    case "cancelled":
+      return status;
+    case "terminated":
+    case "timed_out":
+      return "cancelled";
+    case "unknown":
+      return null;
+  }
 }
 
 // ../shared_libs/play-runtime/run-snapshot-stream.ts
@@ -2729,7 +2748,13 @@ function isPlayRunPackage(value) {
 function normalizePlayStatus(raw) {
   const runPackage = isPlayRunPackage(raw) ? raw : isPlayRunPackage(raw.package) ? raw.package : null;
   const packageRun = runPackage?.run;
-  const status = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : "running";
+  const rawStatus = typeof raw.status === "string" ? raw.status : typeof packageRun?.status === "string" ? packageRun.status : null;
+  const status = decodePlayRunPublicStatus(rawStatus);
+  if (!status) {
+    throw new Error(
+      `Invalid play run lifecycle status in API response: ${JSON.stringify(rawStatus)}.`
+    );
+  }
   const runId = typeof raw.runId === "string" ? raw.runId : typeof raw.workflowId === "string" ? raw.workflowId : packageRun?.id ?? "";
   return {
     ...raw,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.1.297",
+  "version": "0.1.299",
   "description": "Deepline SDK + CLI — B2B data enrichment powered by durable cloud execution",
   "license": "MIT",
   "repository": {