deepline 0.1.197 → 0.1.199

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

@@ -106,10 +106,10 @@ export const SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: '0.1.197',
+  version: '0.1.199',
   apiContract: '2026-06-dataset-handle-results-hard-cutover',
   supportPolicy: {
-    latest: '0.1.197',
+    latest: '0.1.199',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

package/dist/cli/index.js

@@ -623,10 +623,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.197",
+  version: "0.1.199",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.197",
+    latest: "0.1.199",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -6135,16 +6135,7 @@ async function handleHistory(options) {
     `/api/v2/billing/ledger?since_at=${sinceAt}&limit=5000`
   );
   const entries = Array.isArray(payload.entries) ? payload.entries : [];
-  const rows = entries.map((entry) => {
-    const metadata = entry.metadata ?? {};
-    return {
-      created_at: entry.created_at ?? "",
-      delta_credits: entry.delta ?? "",
-      reason: entry.reason ?? "",
-      provider: metadata.provider ?? "",
-      operation: metadata.operation ?? ""
-    };
-  });
+  const rows = entries.map(ledgerApiEntryToRow);
   const outputPath = await writeCsvRowsFile(
     `billing-history-${options.time}`,
     rows
@@ -10725,14 +10716,219 @@ function parseReferencedPlayTarget2(target) {
 function isPrebuiltReferenceTarget(target) {
   return target.trim().toLowerCase().startsWith("prebuilt/");
 }
+function buildBarePrebuiltReferenceMessage(input2) {
+  return `Prebuilt play "${input2.requested}" must be referenced as "${input2.reference}". Use the prebuilt/ namespace anywhere you run, describe, get, or link to Deepline-managed plays.`;
+}
 function buildBarePrebuiltReferenceError(input2) {
-  return new Error(
-    `Prebuilt play "${input2.requested}" must be referenced as "${input2.reference}". Use the prebuilt/ namespace anywhere you run, describe, get, or link to Deepline-managed plays.`
+  return new Error(buildBarePrebuiltReferenceMessage(input2));
+}
+function isPlayNotFoundError(error) {
+  return error instanceof DeeplineError && (error.statusCode === 404 || error.code === "PLAY_NOT_FOUND" || error.code === "NOT_FOUND");
+}
+function isExplicitMissingPlayReferenceError(error) {
+  if (!(error instanceof DeeplineError)) {
+    return false;
+  }
+  if (error.statusCode !== 404 && error.code !== "PLAY_NOT_FOUND") {
+    return false;
+  }
+  return /^play not found\b/i.test(error.message.trim());
+}
+function normalizePlayReferenceForMatch(value) {
+  return value.trim().toLowerCase().replace(/^prebuilt\//, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function playReferenceMatchTokens(value) {
+  return normalizePlayReferenceForMatch(value).split("-").filter((token) => token.length > 1 && token !== "to" && token !== "and");
+}
+function playSuggestionReference(play) {
+  if (play.reference?.trim()) {
+    return play.reference.trim();
+  }
+  const ownerSlug = play.ownerSlug?.trim();
+  return ownerSlug ? `${ownerSlug}/${play.name}` : play.name;
+}
+function scorePlayReferenceSuggestion(requested, play) {
+  const parsed = parseReferencedPlayTarget2(requested);
+  const requestedTrimmed = requested.trim();
+  const requestedRef = requestedTrimmed.toLowerCase();
+  const requestedName = parsed.unqualifiedPlayName;
+  const requestedNorm = normalizePlayReferenceForMatch(requestedTrimmed);
+  const requestedNameNorm = normalizePlayReferenceForMatch(requestedName);
+  if (!requestedNorm && !requestedNameNorm) {
+    return null;
+  }
+  const reference = playSuggestionReference(play);
+  const referenceNorm = normalizePlayReferenceForMatch(reference);
+  const nameNorm = normalizePlayReferenceForMatch(play.name);
+  const candidateNamespace = reference.includes("/") ? reference.split("/")[0]?.toLowerCase() : null;
+  const requestedNamespace = parsed.ownerSlug?.toLowerCase() ?? null;
+  const aliases = (play.aliases ?? []).map(normalizePlayReferenceForMatch);
+  const searchable = [referenceNorm, nameNorm, ...aliases].filter(Boolean);
+  const requestedTokens = playReferenceMatchTokens(requestedName);
+  const candidateTokens = [
+    ...new Set(
+      [reference, play.name, ...play.aliases ?? []].flatMap(
+        playReferenceMatchTokens
+      )
+    )
+  ];
+  const hasTokenContainment = requestedTokens.length > 0 && requestedTokens.every((token) => candidateTokens.includes(token));
+  let score = 0;
+  if (reference.toLowerCase() === requestedRef) {
+    score = 120;
+  } else if (requestedNamespace && candidateNamespace === requestedNamespace && nameNorm === requestedNameNorm) {
+    score = 110;
+  } else if (nameNorm === requestedNameNorm || aliases.includes(requestedNameNorm)) {
+    score = play.origin === "prebuilt" ? 100 : 95;
+  } else if (requestedNamespace && candidateNamespace === requestedNamespace && searchable.some(
+    (value) => value.includes(requestedNameNorm) || requestedNameNorm.includes(value)
+  )) {
+    score = 85;
+  } else if (searchable.some(
+    (value) => value.includes(requestedNorm) || requestedNorm.includes(value)
+  )) {
+    score = 70;
+  } else if (requestedNameNorm && searchable.some(
+    (value) => value.includes(requestedNameNorm) || requestedNameNorm.includes(value)
+  )) {
+    score = 60;
+  } else if (hasTokenContainment) {
+    score = requestedNamespace && candidateNamespace === requestedNamespace ? 58 : 50;
+  }
+  if (score <= 0) {
+    return null;
+  }
+  if (play.origin === "prebuilt") {
+    score += 3;
+  }
+  return {
+    reference,
+    name: play.name,
+    origin: play.origin ?? null,
+    score
+  };
+}
+function rankPlayReferenceSuggestions(input2) {
+  const byReference = /* @__PURE__ */ new Map();
+  for (const play of input2.plays) {
+    const suggestion = scorePlayReferenceSuggestion(input2.requested, play);
+    if (!suggestion) continue;
+    const existing = byReference.get(suggestion.reference);
+    if (!existing || suggestion.score > existing.score) {
+      byReference.set(suggestion.reference, suggestion);
+    }
+  }
+  return [...byReference.values()].sort((left, right) => {
+    if (right.score !== left.score) return right.score - left.score;
+    if (left.origin === "prebuilt" && right.origin !== "prebuilt") return -1;
+    if (right.origin === "prebuilt" && left.origin !== "prebuilt") return 1;
+    return left.reference.localeCompare(right.reference);
+  }).slice(0, input2.limit ?? 5);
+}
+function searchQueryForMissingPlayReference(target) {
+  return parseReferencedPlayTarget2(target).unqualifiedPlayName.replace(/[-_./]+/g, " ").replace(/\s+/g, " ").trim();
+}
+function shellQuote2(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function buildPlayReferenceNotFoundMessage(input2) {
+  const lines = [`Play not found: ${input2.requested}`];
+  if (input2.suggestions.length > 0) {
+    lines.push("", "Did you mean one of these?");
+    for (const suggestion of input2.suggestions) {
+      lines.push("", `  ${suggestion.reference}`);
+      if (input2.command === "run") {
+        lines.push(
+          `    deepline plays run ${suggestion.reference} --input '{...}' --watch`
+        );
+      } else if (input2.command === "get") {
+        lines.push(`    deepline plays get ${suggestion.reference} --json`);
+      } else if (input2.command === "check") {
+        lines.push(`    deepline plays check ${suggestion.reference} --json`);
+      } else if (input2.command === "versions") {
+        lines.push(
+          `    deepline plays versions --name ${suggestion.reference} --json`
+        );
+      } else {
+        lines.push(
+          `    deepline plays describe ${suggestion.reference} --json`
+        );
+      }
+    }
+  }
+  const searchQuery = searchQueryForMissingPlayReference(input2.requested);
+  if (searchQuery) {
+    lines.push(
+      "",
+      "Search visible plays:",
+      `  deepline plays search ${shellQuote2(searchQuery)} --all --json`
+    );
+  }
+  return lines.join("\n");
+}
+async function buildPlayReferenceNotFoundError(input2) {
+  let suggestions = [];
+  try {
+    const searchQuery = searchQueryForMissingPlayReference(input2.target);
+    const searchMatches = searchQuery ? await input2.client.searchPlays({
+      query: searchQuery,
+      scope: "all",
+      compact: true
+    }) : [];
+    const plays = searchMatches.length > 0 ? searchMatches : await input2.client.listPlays();
+    suggestions = rankPlayReferenceSuggestions({
+      requested: input2.target,
+      plays,
+      limit: 5
+    });
+  } catch {
+    suggestions = [];
+  }
+  const sourceError = input2.sourceError instanceof DeeplineError ? input2.sourceError : null;
+  const code = sourceError?.code && sourceError.code !== "API_ERROR" ? sourceError.code : "PLAY_NOT_FOUND";
+  return new DeeplineError(
+    buildPlayReferenceNotFoundMessage({
+      requested: input2.target,
+      command: input2.command,
+      suggestions
+    }),
+    sourceError?.statusCode ?? 404,
+    code,
+    sourceError?.details
   );
 }
-async function assertCanonicalNamedPlayReference(client2, target) {
+async function isMissingRunPlayReferenceError(input2) {
+  if (isExplicitMissingPlayReferenceError(input2.error)) {
+    return true;
+  }
+  if (!(input2.error instanceof DeeplineError) || input2.error.statusCode !== 404 || !/^no artifact-backed revision found for play:/i.test(
+    input2.error.message.trim()
+  )) {
+    return false;
+  }
+  try {
+    await input2.client.getPlay(parseReferencedPlayTarget2(input2.playName).playName);
+    return false;
+  } catch (lookupError) {
+    return isPlayNotFoundError(lookupError);
+  }
+}
+async function assertCanonicalNamedPlayReference(client2, target, options = {}) {
   const parsed = parseReferencedPlayTarget2(target);
-  const detail = await client2.getPlay(parsed.playName);
+  let detail;
+  try {
+    detail = await client2.getPlay(parsed.playName);
+  } catch (error) {
+    if (isPlayNotFoundError(error)) {
+      throw await buildPlayReferenceNotFoundError({
+        client: client2,
+        target,
+        command: options.command ?? "describe",
+        sourceError: error
+      });
+    }
+    throw error;
+  }
   if (detail.play.ownerType === "deepline" && !isPrebuiltReferenceTarget(target)) {
     throw buildBarePrebuiltReferenceError({
       requested: target,
@@ -13468,10 +13664,7 @@ async function exportPlayStatusRows(client2, status, outPath, options = {}) {
         availableRows,
         datasetPath: options.datasetPath
       });
-      return {
-        path: writeCanonicalRowsCsv(guarded2, outPath),
-        rowsInfo: guarded2
-      };
+      return { path: writeCanonicalRowsCsv(guarded2, outPath), rowsInfo: guarded2 };
     }
     if (rowsInfo.complete) {
       const guarded2 = assertDatasetHasExportableRows({
@@ -13480,7 +13673,10 @@ async function exportPlayStatusRows(client2, status, outPath, options = {}) {
         availableRows,
         datasetPath: options.datasetPath
       });
-      return { path: writeCanonicalRowsCsv(guarded2, outPath), rowsInfo: guarded2 };
+      return {
+        path: writeCanonicalRowsCsv(guarded2, outPath),
+        rowsInfo: guarded2
+      };
     }
     if (attempt < attempts && retryDelayMs > 0) {
       await sleep5(retryDelayMs);
@@ -13614,17 +13810,25 @@ function normalizePlayValidationError(error) {
     error instanceof DeeplineError ? error.details : void 0
   );
 }
-function normalizePlayStartError(error, playName) {
+async function normalizePlayStartError(client2, error, playName, options = {}) {
   const activeRuns = extractActiveRunsFromError(error);
-  if (activeRuns.length === 0) {
-    return normalizePlayValidationError(error);
+  if (activeRuns.length > 0) {
+    return new DeeplineError(
+      formatActiveRunConflictError({ playName, activeRuns }),
+      error instanceof DeeplineError ? error.statusCode : 409,
+      "ACTIVE_RUN_EXISTS",
+      error instanceof DeeplineError ? error.details : void 0
+    );
   }
-  return new DeeplineError(
-    formatActiveRunConflictError({ playName, activeRuns }),
-    error instanceof DeeplineError ? error.statusCode : 409,
-    "ACTIVE_RUN_EXISTS",
-    error instanceof DeeplineError ? error.details : void 0
-  );
+  if (options.suggestMissingPlay && await isMissingRunPlayReferenceError({ client: client2, error, playName })) {
+    return buildPlayReferenceNotFoundError({
+      client: client2,
+      target: playName,
+      command: "run",
+      sourceError: error
+    });
+  }
+  return normalizePlayValidationError(error);
 }
 function renderServerResultView(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -14137,7 +14341,9 @@ async function handlePlayCheck(args) {
   if (!isFileTarget(options.target)) {
     const client3 = new DeeplineClient();
     try {
-      await assertCanonicalNamedPlayReference(client3, options.target);
+      await assertCanonicalNamedPlayReference(client3, options.target, {
+        command: "check"
+      });
       const play = await client3.describePlay(
         parseReferencedPlayTarget2(options.target).playName,
         { compact: true }
@@ -14407,8 +14613,8 @@ async function handleFileBackedRun(options) {
         waitTimeoutMs: options.waitTimeoutMs,
         noOpen: options.noOpen,
         progress
-      }).catch((error) => {
-        throw normalizePlayStartError(error, playName);
+      }).catch(async (error) => {
+        throw await normalizePlayStartError(client2, error, playName);
       })
     );
     if (finalStatus.status === "completed") {
@@ -14438,8 +14644,8 @@ async function handleFileBackedRun(options) {
   const started = await traceCliSpan(
     "cli.play_start_unwatched",
     { targetKind: "file", playName },
-    () => client2.startPlayRun(startRequest).catch((error) => {
-      throw normalizePlayStartError(error, playName);
+    () => client2.startPlayRun(startRequest).catch(async (error) => {
+      throw await normalizePlayStartError(client2, error, playName);
     })
   );
   const resolvedDashboardUrl = buildPlayDashboardUrl(client2.baseUrl, playName);
@@ -14497,7 +14703,9 @@ async function handleNamedRun(options) {
     return traceCliSpan(
       "cli.play_load_definition",
       { targetKind: "name", playName, skipped: false },
-      () => assertCanonicalNamedPlayReference(client2, playName)
+      () => assertCanonicalNamedPlayReference(client2, playName, {
+        command: "run"
+      })
     );
   })() : (recordCliTrace({
     phase: "cli.play_load_definition",
@@ -14566,8 +14774,10 @@ async function handleNamedRun(options) {
         waitTimeoutMs: options.waitTimeoutMs,
         noOpen: options.noOpen,
         progress
-      }).catch((error) => {
-        throw normalizePlayStartError(error, playName);
+      }).catch(async (error) => {
+        throw await normalizePlayStartError(client2, error, playName, {
+          suggestMissingPlay: true
+        });
       })
     );
     if (finalStatus.status === "completed") {
@@ -14597,8 +14807,10 @@ async function handleNamedRun(options) {
   const started = await traceCliSpan(
     "cli.play_start_unwatched",
     { targetKind: "name", playName },
-    () => client2.startPlayRun(startRequest).catch((error) => {
-      throw normalizePlayStartError(error, playName);
+    () => client2.startPlayRun(startRequest).catch(async (error) => {
+      throw await normalizePlayStartError(client2, error, playName, {
+        suggestMissingPlay: true
+      });
     })
   );
   const resolvedDashboardUrl = buildPlayDashboardUrl(client2.baseUrl, playName);
@@ -15037,7 +15249,9 @@ async function handlePlayGet(args) {
     }
   }
   const playName = isFileTarget(target) ? extractPlayName((0, import_node_fs10.readFileSync)((0, import_node_path11.resolve)(target), "utf-8"), (0, import_node_path11.resolve)(target)) : parseReferencedPlayTarget2(target).playName;
-  const detail = isFileTarget(target) ? await client2.getPlay(playName) : await assertCanonicalNamedPlayReference(client2, target);
+  const detail = isFileTarget(target) ? await client2.getPlay(playName) : await assertCanonicalNamedPlayReference(client2, target, {
+    command: "get"
+  });
   const resolvedSource = detail.play.workingRevision?.sourceCode ?? detail.play.liveRevision?.sourceCode ?? detail.play.currentRevision?.sourceCode ?? detail.play.sourceCode ?? "";
   const materializedFile = outPath ? materializeRemotePlaySource({
     target,
@@ -15119,7 +15333,9 @@ async function handlePlayVersions(args) {
   }
   const client2 = new DeeplineClient();
   const jsonOutput = argsWantJson(args);
-  await assertCanonicalNamedPlayReference(client2, playName);
+  await assertCanonicalNamedPlayReference(client2, playName, {
+    command: "versions"
+  });
   const versions = await client2.listPlayVersions(
     parseReferencedPlayTarget2(playName).playName
   );
@@ -15515,7 +15731,9 @@ async function handlePlayDescribe(args) {
     return 2;
   }
   const client2 = new DeeplineClient();
-  await assertCanonicalNamedPlayReference(client2, playName);
+  await assertCanonicalNamedPlayReference(client2, playName, {
+    command: "describe"
+  });
   const play = await client2.describePlay(
     parseReferencedPlayTarget2(playName).playName,
     {
@@ -24023,7 +24241,7 @@ var EXIT_AUTH2 = 1;
 var EXIT_SERVER3 = 2;
 var MAX_PROMPT_LENGTH = 8e3;
 var MAX_BODY_BYTES = 64 * 1024;
-function shellQuote2(arg) {
+function shellQuote3(arg) {
   return `'${arg.replace(/'/g, `'\\''`)}'`;
 }
 function hasClaudeBinary() {
@@ -24196,7 +24414,7 @@ async function handleQuickstart(options) {
   }
   progress.complete();
   const { prompt, workflowId } = outcome;
-  const claudeCommand = `claude ${shellQuote2(prompt)}`;
+  const claudeCommand = `claude ${shellQuote3(prompt)}`;
   const claudeAvailable = hasClaudeBinary();
   const willLaunch = options.launch !== false && !jsonOutput && interactive && claudeAvailable;
   printCommandEnvelope(
@@ -26118,7 +26336,7 @@ function parseExecuteOptions(args) {
 function safeFileStem(value) {
   return value.trim().replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "tool";
 }
-function shellQuote3(value) {
+function shellQuote4(value) {
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
 function powerShellQuote(value) {
@@ -26188,7 +26406,7 @@ export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
     path: scriptPath,
     sourceCode: script,
     projectDir,
-    macCopyCommand: `mkdir -p ${shellQuote3(projectDir)} && cp ${shellQuote3(scriptPath)} ${shellQuote3(`${projectDir}/${fileName}`)}`,
+    macCopyCommand: `mkdir -p ${shellQuote4(projectDir)} && cp ${shellQuote4(scriptPath)} ${shellQuote4(`${projectDir}/${fileName}`)}`,
     windowsCopyCommand: `New-Item -ItemType Directory -Force -Path ${powerShellQuote(projectDir.replace(/\//g, "\\"))} | Out-Null; Copy-Item -LiteralPath ${powerShellQuote(scriptPath)} -Destination ${powerShellQuote(`${projectDir.replace(/\//g, "\\")}\\${fileName}`)}`
   };
 }
@@ -26211,7 +26429,7 @@ function buildToolExecuteBaseEnvelope(input2) {
     envelope,
     "output"
   );
-  const inspectCommand = `deepline tools execute ${input2.toolId} --input ${shellQuote3(JSON.stringify(input2.params))} --json`;
+  const inspectCommand = `deepline tools execute ${input2.toolId} --input ${shellQuote4(JSON.stringify(input2.params))} --json`;
   const actions = input2.listConversion ? [
     {
       label: "next",
@@ -27280,7 +27498,7 @@ function hasCommand(command) {
   });
   return result.status === 0;
 }
-function shellQuote4(arg) {
+function shellQuote5(arg) {
   return `'${arg.replace(/'/g, `'\\''`)}'`;
 }
 function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NAMES) {
@@ -27288,7 +27506,7 @@ function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NA
   const npxInstall = {
     command: "npx",
     args: npxArgs,
-    manualCommand: `npx ${npxArgs.map(shellQuote4).join(" ")}`
+    manualCommand: `npx ${npxArgs.map(shellQuote5).join(" ")}`
   };
   if (hasCommand("bunx")) {
     const bunxArgs = buildBunxSkillsInstallArgs(baseUrl, skillNames);
@@ -27296,7 +27514,7 @@ function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NA
       {
         command: "bunx",
         args: bunxArgs,
-        manualCommand: `bunx ${bunxArgs.map(shellQuote4).join(" ")}`
+        manualCommand: `bunx ${bunxArgs.map(shellQuote5).join(" ")}`
       },
       npxInstall
     ];
@@ -27463,14 +27681,14 @@ function posixShellQuote(value) {
 function windowsCmdQuote(value) {
   return `"${value.replace(/"/g, '""')}"`;
 }
-function shellQuote5(value) {
+function shellQuote6(value) {
   if (process.platform === "win32") {
     return /^[A-Za-z0-9_./:@%+=,-]+$/.test(value) ? value : windowsCmdQuote(value);
   }
   return posixShellQuote(value);
 }
 function buildSourceUpdateCommand(sourceRoot) {
-  const quotedRoot = shellQuote5(sourceRoot);
+  const quotedRoot = shellQuote6(sourceRoot);
   const cdCommand = process.platform === "win32" ? `cd /d ${quotedRoot}` : `cd ${quotedRoot}`;
   return `${cdCommand} && git fetch origin main --tags && git merge --ff-only origin/main`;
 }
@@ -27482,7 +27700,7 @@ function buildSidecarProjectConfigCommand(versionDir, nodeBin) {
     "fs.mkdirSync(dir,{recursive:true});",
     `fs.writeFileSync(path.join(dir,'package.json'),${JSON.stringify(NPM_SDK_SIDECAR_PACKAGE_JSON)});`
   ].join("");
-  return `${shellQuote5(nodeBin)} -e ${shellQuote5(script)} ${shellQuote5(versionDir)}`;
+  return `${shellQuote6(nodeBin)} -e ${shellQuote6(script)} ${shellQuote6(versionDir)}`;
 }
 function sidecarStateDir(input2) {
   const scope = input2.env.DEEPLINE_CONFIG_SCOPE?.trim();
@@ -27521,7 +27739,7 @@ function resolvePythonSidecarUpdatePlan(options) {
   const packageSpec = options.packageSpec || "deepline@latest";
   const npmCommand = "npm";
   const versionDir = (0, import_node_path19.join)(stateDir, "versions", "<version>");
-  const manualCommand = `${buildSidecarProjectConfigCommand(versionDir, nodeBin)} && ${npmCommand} install --prefix ${shellQuote5(versionDir)} ${NPM_SDK_INSTALL_COMMON_FLAGS.map(shellQuote5).join(" ")} ${shellQuote5(packageSpec)}`;
+  const manualCommand = `${buildSidecarProjectConfigCommand(versionDir, nodeBin)} && ${npmCommand} install --prefix ${shellQuote6(versionDir)} ${NPM_SDK_INSTALL_COMMON_FLAGS.map(shellQuote6).join(" ")} ${shellQuote6(packageSpec)}`;
   return {
     kind: "python-sidecar",
     stateDir,
@@ -27601,7 +27819,7 @@ function resolveUpdatePlan(options = {}) {
     command,
     args,
     ...installPrefix ? { installPrefix } : {},
-    manualCommand: `${command} ${args.map(shellQuote5).join(" ")}`
+    manualCommand: `${command} ${args.map(shellQuote6).join(" ")}`
   };
 }
 var AUTO_UPDATE_FAILURE_FILE = ".auto-update-failure.json";
@@ -27762,9 +27980,9 @@ function writeSidecarLauncher(input2) {
     input2.path,
     [
       "#!/usr/bin/env sh",
-      `export DEEPLINE_HOST_URL=${shellQuote5(input2.hostUrl)}`,
-      `export DEEPLINE_CONFIG_SCOPE=${shellQuote5(input2.scope)}`,
-      `exec ${shellQuote5(input2.nodeBin)} ${shellQuote5(input2.entryPath)} "$@"`,
+      `export DEEPLINE_HOST_URL=${shellQuote6(input2.hostUrl)}`,
+      `export DEEPLINE_CONFIG_SCOPE=${shellQuote6(input2.scope)}`,
+      `exec ${shellQuote6(input2.nodeBin)} ${shellQuote6(input2.entryPath)} "$@"`,
       ""
     ].join("\n"),
     { encoding: "utf8", mode: 493 }

package/dist/cli/index.mjs

@@ -608,10 +608,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.197",
+  version: "0.1.199",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.197",
+    latest: "0.1.199",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -6132,16 +6132,7 @@ async function handleHistory(options) {
     `/api/v2/billing/ledger?since_at=${sinceAt}&limit=5000`
   );
   const entries = Array.isArray(payload.entries) ? payload.entries : [];
-  const rows = entries.map((entry) => {
-    const metadata = entry.metadata ?? {};
-    return {
-      created_at: entry.created_at ?? "",
-      delta_credits: entry.delta ?? "",
-      reason: entry.reason ?? "",
-      provider: metadata.provider ?? "",
-      operation: metadata.operation ?? ""
-    };
-  });
+  const rows = entries.map(ledgerApiEntryToRow);
   const outputPath = await writeCsvRowsFile(
     `billing-history-${options.time}`,
     rows
@@ -10754,14 +10745,219 @@ function parseReferencedPlayTarget2(target) {
 function isPrebuiltReferenceTarget(target) {
   return target.trim().toLowerCase().startsWith("prebuilt/");
 }
+function buildBarePrebuiltReferenceMessage(input2) {
+  return `Prebuilt play "${input2.requested}" must be referenced as "${input2.reference}". Use the prebuilt/ namespace anywhere you run, describe, get, or link to Deepline-managed plays.`;
+}
 function buildBarePrebuiltReferenceError(input2) {
-  return new Error(
-    `Prebuilt play "${input2.requested}" must be referenced as "${input2.reference}". Use the prebuilt/ namespace anywhere you run, describe, get, or link to Deepline-managed plays.`
+  return new Error(buildBarePrebuiltReferenceMessage(input2));
+}
+function isPlayNotFoundError(error) {
+  return error instanceof DeeplineError && (error.statusCode === 404 || error.code === "PLAY_NOT_FOUND" || error.code === "NOT_FOUND");
+}
+function isExplicitMissingPlayReferenceError(error) {
+  if (!(error instanceof DeeplineError)) {
+    return false;
+  }
+  if (error.statusCode !== 404 && error.code !== "PLAY_NOT_FOUND") {
+    return false;
+  }
+  return /^play not found\b/i.test(error.message.trim());
+}
+function normalizePlayReferenceForMatch(value) {
+  return value.trim().toLowerCase().replace(/^prebuilt\//, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function playReferenceMatchTokens(value) {
+  return normalizePlayReferenceForMatch(value).split("-").filter((token) => token.length > 1 && token !== "to" && token !== "and");
+}
+function playSuggestionReference(play) {
+  if (play.reference?.trim()) {
+    return play.reference.trim();
+  }
+  const ownerSlug = play.ownerSlug?.trim();
+  return ownerSlug ? `${ownerSlug}/${play.name}` : play.name;
+}
+function scorePlayReferenceSuggestion(requested, play) {
+  const parsed = parseReferencedPlayTarget2(requested);
+  const requestedTrimmed = requested.trim();
+  const requestedRef = requestedTrimmed.toLowerCase();
+  const requestedName = parsed.unqualifiedPlayName;
+  const requestedNorm = normalizePlayReferenceForMatch(requestedTrimmed);
+  const requestedNameNorm = normalizePlayReferenceForMatch(requestedName);
+  if (!requestedNorm && !requestedNameNorm) {
+    return null;
+  }
+  const reference = playSuggestionReference(play);
+  const referenceNorm = normalizePlayReferenceForMatch(reference);
+  const nameNorm = normalizePlayReferenceForMatch(play.name);
+  const candidateNamespace = reference.includes("/") ? reference.split("/")[0]?.toLowerCase() : null;
+  const requestedNamespace = parsed.ownerSlug?.toLowerCase() ?? null;
+  const aliases = (play.aliases ?? []).map(normalizePlayReferenceForMatch);
+  const searchable = [referenceNorm, nameNorm, ...aliases].filter(Boolean);
+  const requestedTokens = playReferenceMatchTokens(requestedName);
+  const candidateTokens = [
+    ...new Set(
+      [reference, play.name, ...play.aliases ?? []].flatMap(
+        playReferenceMatchTokens
+      )
+    )
+  ];
+  const hasTokenContainment = requestedTokens.length > 0 && requestedTokens.every((token) => candidateTokens.includes(token));
+  let score = 0;
+  if (reference.toLowerCase() === requestedRef) {
+    score = 120;
+  } else if (requestedNamespace && candidateNamespace === requestedNamespace && nameNorm === requestedNameNorm) {
+    score = 110;
+  } else if (nameNorm === requestedNameNorm || aliases.includes(requestedNameNorm)) {
+    score = play.origin === "prebuilt" ? 100 : 95;
+  } else if (requestedNamespace && candidateNamespace === requestedNamespace && searchable.some(
+    (value) => value.includes(requestedNameNorm) || requestedNameNorm.includes(value)
+  )) {
+    score = 85;
+  } else if (searchable.some(
+    (value) => value.includes(requestedNorm) || requestedNorm.includes(value)
+  )) {
+    score = 70;
+  } else if (requestedNameNorm && searchable.some(
+    (value) => value.includes(requestedNameNorm) || requestedNameNorm.includes(value)
+  )) {
+    score = 60;
+  } else if (hasTokenContainment) {
+    score = requestedNamespace && candidateNamespace === requestedNamespace ? 58 : 50;
+  }
+  if (score <= 0) {
+    return null;
+  }
+  if (play.origin === "prebuilt") {
+    score += 3;
+  }
+  return {
+    reference,
+    name: play.name,
+    origin: play.origin ?? null,
+    score
+  };
+}
+function rankPlayReferenceSuggestions(input2) {
+  const byReference = /* @__PURE__ */ new Map();
+  for (const play of input2.plays) {
+    const suggestion = scorePlayReferenceSuggestion(input2.requested, play);
+    if (!suggestion) continue;
+    const existing = byReference.get(suggestion.reference);
+    if (!existing || suggestion.score > existing.score) {
+      byReference.set(suggestion.reference, suggestion);
+    }
+  }
+  return [...byReference.values()].sort((left, right) => {
+    if (right.score !== left.score) return right.score - left.score;
+    if (left.origin === "prebuilt" && right.origin !== "prebuilt") return -1;
+    if (right.origin === "prebuilt" && left.origin !== "prebuilt") return 1;
+    return left.reference.localeCompare(right.reference);
+  }).slice(0, input2.limit ?? 5);
+}
+function searchQueryForMissingPlayReference(target) {
+  return parseReferencedPlayTarget2(target).unqualifiedPlayName.replace(/[-_./]+/g, " ").replace(/\s+/g, " ").trim();
+}
+function shellQuote2(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function buildPlayReferenceNotFoundMessage(input2) {
+  const lines = [`Play not found: ${input2.requested}`];
+  if (input2.suggestions.length > 0) {
+    lines.push("", "Did you mean one of these?");
+    for (const suggestion of input2.suggestions) {
+      lines.push("", `  ${suggestion.reference}`);
+      if (input2.command === "run") {
+        lines.push(
+          `    deepline plays run ${suggestion.reference} --input '{...}' --watch`
+        );
+      } else if (input2.command === "get") {
+        lines.push(`    deepline plays get ${suggestion.reference} --json`);
+      } else if (input2.command === "check") {
+        lines.push(`    deepline plays check ${suggestion.reference} --json`);
+      } else if (input2.command === "versions") {
+        lines.push(
+          `    deepline plays versions --name ${suggestion.reference} --json`
+        );
+      } else {
+        lines.push(
+          `    deepline plays describe ${suggestion.reference} --json`
+        );
+      }
+    }
+  }
+  const searchQuery = searchQueryForMissingPlayReference(input2.requested);
+  if (searchQuery) {
+    lines.push(
+      "",
+      "Search visible plays:",
+      `  deepline plays search ${shellQuote2(searchQuery)} --all --json`
+    );
+  }
+  return lines.join("\n");
+}
+async function buildPlayReferenceNotFoundError(input2) {
+  let suggestions = [];
+  try {
+    const searchQuery = searchQueryForMissingPlayReference(input2.target);
+    const searchMatches = searchQuery ? await input2.client.searchPlays({
+      query: searchQuery,
+      scope: "all",
+      compact: true
+    }) : [];
+    const plays = searchMatches.length > 0 ? searchMatches : await input2.client.listPlays();
+    suggestions = rankPlayReferenceSuggestions({
+      requested: input2.target,
+      plays,
+      limit: 5
+    });
+  } catch {
+    suggestions = [];
+  }
+  const sourceError = input2.sourceError instanceof DeeplineError ? input2.sourceError : null;
+  const code = sourceError?.code && sourceError.code !== "API_ERROR" ? sourceError.code : "PLAY_NOT_FOUND";
+  return new DeeplineError(
+    buildPlayReferenceNotFoundMessage({
+      requested: input2.target,
+      command: input2.command,
+      suggestions
+    }),
+    sourceError?.statusCode ?? 404,
+    code,
+    sourceError?.details
   );
 }
-async function assertCanonicalNamedPlayReference(client2, target) {
+async function isMissingRunPlayReferenceError(input2) {
+  if (isExplicitMissingPlayReferenceError(input2.error)) {
+    return true;
+  }
+  if (!(input2.error instanceof DeeplineError) || input2.error.statusCode !== 404 || !/^no artifact-backed revision found for play:/i.test(
+    input2.error.message.trim()
+  )) {
+    return false;
+  }
+  try {
+    await input2.client.getPlay(parseReferencedPlayTarget2(input2.playName).playName);
+    return false;
+  } catch (lookupError) {
+    return isPlayNotFoundError(lookupError);
+  }
+}
+async function assertCanonicalNamedPlayReference(client2, target, options = {}) {
   const parsed = parseReferencedPlayTarget2(target);
-  const detail = await client2.getPlay(parsed.playName);
+  let detail;
+  try {
+    detail = await client2.getPlay(parsed.playName);
+  } catch (error) {
+    if (isPlayNotFoundError(error)) {
+      throw await buildPlayReferenceNotFoundError({
+        client: client2,
+        target,
+        command: options.command ?? "describe",
+        sourceError: error
+      });
+    }
+    throw error;
+  }
   if (detail.play.ownerType === "deepline" && !isPrebuiltReferenceTarget(target)) {
     throw buildBarePrebuiltReferenceError({
       requested: target,
@@ -13497,10 +13693,7 @@ async function exportPlayStatusRows(client2, status, outPath, options = {}) {
         availableRows,
         datasetPath: options.datasetPath
       });
-      return {
-        path: writeCanonicalRowsCsv(guarded2, outPath),
-        rowsInfo: guarded2
-      };
+      return { path: writeCanonicalRowsCsv(guarded2, outPath), rowsInfo: guarded2 };
     }
     if (rowsInfo.complete) {
       const guarded2 = assertDatasetHasExportableRows({
@@ -13509,7 +13702,10 @@ async function exportPlayStatusRows(client2, status, outPath, options = {}) {
         availableRows,
         datasetPath: options.datasetPath
       });
-      return { path: writeCanonicalRowsCsv(guarded2, outPath), rowsInfo: guarded2 };
+      return {
+        path: writeCanonicalRowsCsv(guarded2, outPath),
+        rowsInfo: guarded2
+      };
     }
     if (attempt < attempts && retryDelayMs > 0) {
       await sleep5(retryDelayMs);
@@ -13643,17 +13839,25 @@ function normalizePlayValidationError(error) {
     error instanceof DeeplineError ? error.details : void 0
   );
 }
-function normalizePlayStartError(error, playName) {
+async function normalizePlayStartError(client2, error, playName, options = {}) {
   const activeRuns = extractActiveRunsFromError(error);
-  if (activeRuns.length === 0) {
-    return normalizePlayValidationError(error);
+  if (activeRuns.length > 0) {
+    return new DeeplineError(
+      formatActiveRunConflictError({ playName, activeRuns }),
+      error instanceof DeeplineError ? error.statusCode : 409,
+      "ACTIVE_RUN_EXISTS",
+      error instanceof DeeplineError ? error.details : void 0
+    );
   }
-  return new DeeplineError(
-    formatActiveRunConflictError({ playName, activeRuns }),
-    error instanceof DeeplineError ? error.statusCode : 409,
-    "ACTIVE_RUN_EXISTS",
-    error instanceof DeeplineError ? error.details : void 0
-  );
+  if (options.suggestMissingPlay && await isMissingRunPlayReferenceError({ client: client2, error, playName })) {
+    return buildPlayReferenceNotFoundError({
+      client: client2,
+      target: playName,
+      command: "run",
+      sourceError: error
+    });
+  }
+  return normalizePlayValidationError(error);
 }
 function renderServerResultView(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
@@ -14166,7 +14370,9 @@ async function handlePlayCheck(args) {
   if (!isFileTarget(options.target)) {
     const client3 = new DeeplineClient();
     try {
-      await assertCanonicalNamedPlayReference(client3, options.target);
+      await assertCanonicalNamedPlayReference(client3, options.target, {
+        command: "check"
+      });
       const play = await client3.describePlay(
         parseReferencedPlayTarget2(options.target).playName,
         { compact: true }
@@ -14436,8 +14642,8 @@ async function handleFileBackedRun(options) {
         waitTimeoutMs: options.waitTimeoutMs,
         noOpen: options.noOpen,
         progress
-      }).catch((error) => {
-        throw normalizePlayStartError(error, playName);
+      }).catch(async (error) => {
+        throw await normalizePlayStartError(client2, error, playName);
       })
     );
     if (finalStatus.status === "completed") {
@@ -14467,8 +14673,8 @@ async function handleFileBackedRun(options) {
   const started = await traceCliSpan(
     "cli.play_start_unwatched",
     { targetKind: "file", playName },
-    () => client2.startPlayRun(startRequest).catch((error) => {
-      throw normalizePlayStartError(error, playName);
+    () => client2.startPlayRun(startRequest).catch(async (error) => {
+      throw await normalizePlayStartError(client2, error, playName);
     })
   );
   const resolvedDashboardUrl = buildPlayDashboardUrl(client2.baseUrl, playName);
@@ -14526,7 +14732,9 @@ async function handleNamedRun(options) {
     return traceCliSpan(
       "cli.play_load_definition",
       { targetKind: "name", playName, skipped: false },
-      () => assertCanonicalNamedPlayReference(client2, playName)
+      () => assertCanonicalNamedPlayReference(client2, playName, {
+        command: "run"
+      })
     );
   })() : (recordCliTrace({
     phase: "cli.play_load_definition",
@@ -14595,8 +14803,10 @@ async function handleNamedRun(options) {
         waitTimeoutMs: options.waitTimeoutMs,
         noOpen: options.noOpen,
         progress
-      }).catch((error) => {
-        throw normalizePlayStartError(error, playName);
+      }).catch(async (error) => {
+        throw await normalizePlayStartError(client2, error, playName, {
+          suggestMissingPlay: true
+        });
       })
     );
     if (finalStatus.status === "completed") {
@@ -14626,8 +14836,10 @@ async function handleNamedRun(options) {
   const started = await traceCliSpan(
     "cli.play_start_unwatched",
     { targetKind: "name", playName },
-    () => client2.startPlayRun(startRequest).catch((error) => {
-      throw normalizePlayStartError(error, playName);
+    () => client2.startPlayRun(startRequest).catch(async (error) => {
+      throw await normalizePlayStartError(client2, error, playName, {
+        suggestMissingPlay: true
+      });
     })
   );
   const resolvedDashboardUrl = buildPlayDashboardUrl(client2.baseUrl, playName);
@@ -15066,7 +15278,9 @@ async function handlePlayGet(args) {
     }
   }
   const playName = isFileTarget(target) ? extractPlayName(readFileSync7(resolve8(target), "utf-8"), resolve8(target)) : parseReferencedPlayTarget2(target).playName;
-  const detail = isFileTarget(target) ? await client2.getPlay(playName) : await assertCanonicalNamedPlayReference(client2, target);
+  const detail = isFileTarget(target) ? await client2.getPlay(playName) : await assertCanonicalNamedPlayReference(client2, target, {
+    command: "get"
+  });
   const resolvedSource = detail.play.workingRevision?.sourceCode ?? detail.play.liveRevision?.sourceCode ?? detail.play.currentRevision?.sourceCode ?? detail.play.sourceCode ?? "";
   const materializedFile = outPath ? materializeRemotePlaySource({
     target,
@@ -15148,7 +15362,9 @@ async function handlePlayVersions(args) {
   }
   const client2 = new DeeplineClient();
   const jsonOutput = argsWantJson(args);
-  await assertCanonicalNamedPlayReference(client2, playName);
+  await assertCanonicalNamedPlayReference(client2, playName, {
+    command: "versions"
+  });
   const versions = await client2.listPlayVersions(
     parseReferencedPlayTarget2(playName).playName
   );
@@ -15544,7 +15760,9 @@ async function handlePlayDescribe(args) {
     return 2;
   }
   const client2 = new DeeplineClient();
-  await assertCanonicalNamedPlayReference(client2, playName);
+  await assertCanonicalNamedPlayReference(client2, playName, {
+    command: "describe"
+  });
   const play = await client2.describePlay(
     parseReferencedPlayTarget2(playName).playName,
     {
@@ -24059,7 +24277,7 @@ var EXIT_AUTH2 = 1;
 var EXIT_SERVER3 = 2;
 var MAX_PROMPT_LENGTH = 8e3;
 var MAX_BODY_BYTES = 64 * 1024;
-function shellQuote2(arg) {
+function shellQuote3(arg) {
   return `'${arg.replace(/'/g, `'\\''`)}'`;
 }
 function hasClaudeBinary() {
@@ -24232,7 +24450,7 @@ async function handleQuickstart(options) {
   }
   progress.complete();
   const { prompt, workflowId } = outcome;
-  const claudeCommand = `claude ${shellQuote2(prompt)}`;
+  const claudeCommand = `claude ${shellQuote3(prompt)}`;
   const claudeAvailable = hasClaudeBinary();
   const willLaunch = options.launch !== false && !jsonOutput && interactive && claudeAvailable;
   printCommandEnvelope(
@@ -26166,7 +26384,7 @@ function parseExecuteOptions(args) {
 function safeFileStem(value) {
   return value.trim().replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "tool";
 }
-function shellQuote3(value) {
+function shellQuote4(value) {
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
 function powerShellQuote(value) {
@@ -26236,7 +26454,7 @@ export default definePlay(${JSON.stringify(playName)}, async (ctx) => {
     path: scriptPath,
     sourceCode: script,
     projectDir,
-    macCopyCommand: `mkdir -p ${shellQuote3(projectDir)} && cp ${shellQuote3(scriptPath)} ${shellQuote3(`${projectDir}/${fileName}`)}`,
+    macCopyCommand: `mkdir -p ${shellQuote4(projectDir)} && cp ${shellQuote4(scriptPath)} ${shellQuote4(`${projectDir}/${fileName}`)}`,
     windowsCopyCommand: `New-Item -ItemType Directory -Force -Path ${powerShellQuote(projectDir.replace(/\//g, "\\"))} | Out-Null; Copy-Item -LiteralPath ${powerShellQuote(scriptPath)} -Destination ${powerShellQuote(`${projectDir.replace(/\//g, "\\")}\\${fileName}`)}`
   };
 }
@@ -26259,7 +26477,7 @@ function buildToolExecuteBaseEnvelope(input2) {
     envelope,
     "output"
   );
-  const inspectCommand = `deepline tools execute ${input2.toolId} --input ${shellQuote3(JSON.stringify(input2.params))} --json`;
+  const inspectCommand = `deepline tools execute ${input2.toolId} --input ${shellQuote4(JSON.stringify(input2.params))} --json`;
   const actions = input2.listConversion ? [
     {
       label: "next",
@@ -27337,7 +27555,7 @@ function hasCommand(command) {
   });
   return result.status === 0;
 }
-function shellQuote4(arg) {
+function shellQuote5(arg) {
   return `'${arg.replace(/'/g, `'\\''`)}'`;
 }
 function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NAMES) {
@@ -27345,7 +27563,7 @@ function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NA
   const npxInstall = {
     command: "npx",
     args: npxArgs,
-    manualCommand: `npx ${npxArgs.map(shellQuote4).join(" ")}`
+    manualCommand: `npx ${npxArgs.map(shellQuote5).join(" ")}`
   };
   if (hasCommand("bunx")) {
     const bunxArgs = buildBunxSkillsInstallArgs(baseUrl, skillNames);
@@ -27353,7 +27571,7 @@ function resolveSkillsInstallCommands(baseUrl, skillNames = DEFAULT_SDK_SKILL_NA
       {
         command: "bunx",
         args: bunxArgs,
-        manualCommand: `bunx ${bunxArgs.map(shellQuote4).join(" ")}`
+        manualCommand: `bunx ${bunxArgs.map(shellQuote5).join(" ")}`
       },
       npxInstall
     ];
@@ -27520,14 +27738,14 @@ function posixShellQuote(value) {
 function windowsCmdQuote(value) {
   return `"${value.replace(/"/g, '""')}"`;
 }
-function shellQuote5(value) {
+function shellQuote6(value) {
   if (process.platform === "win32") {
     return /^[A-Za-z0-9_./:@%+=,-]+$/.test(value) ? value : windowsCmdQuote(value);
   }
   return posixShellQuote(value);
 }
 function buildSourceUpdateCommand(sourceRoot) {
-  const quotedRoot = shellQuote5(sourceRoot);
+  const quotedRoot = shellQuote6(sourceRoot);
   const cdCommand = process.platform === "win32" ? `cd /d ${quotedRoot}` : `cd ${quotedRoot}`;
   return `${cdCommand} && git fetch origin main --tags && git merge --ff-only origin/main`;
 }
@@ -27539,7 +27757,7 @@ function buildSidecarProjectConfigCommand(versionDir, nodeBin) {
     "fs.mkdirSync(dir,{recursive:true});",
     `fs.writeFileSync(path.join(dir,'package.json'),${JSON.stringify(NPM_SDK_SIDECAR_PACKAGE_JSON)});`
   ].join("");
-  return `${shellQuote5(nodeBin)} -e ${shellQuote5(script)} ${shellQuote5(versionDir)}`;
+  return `${shellQuote6(nodeBin)} -e ${shellQuote6(script)} ${shellQuote6(versionDir)}`;
 }
 function sidecarStateDir(input2) {
   const scope = input2.env.DEEPLINE_CONFIG_SCOPE?.trim();
@@ -27578,7 +27796,7 @@ function resolvePythonSidecarUpdatePlan(options) {
   const packageSpec = options.packageSpec || "deepline@latest";
   const npmCommand = "npm";
   const versionDir = join14(stateDir, "versions", "<version>");
-  const manualCommand = `${buildSidecarProjectConfigCommand(versionDir, nodeBin)} && ${npmCommand} install --prefix ${shellQuote5(versionDir)} ${NPM_SDK_INSTALL_COMMON_FLAGS.map(shellQuote5).join(" ")} ${shellQuote5(packageSpec)}`;
+  const manualCommand = `${buildSidecarProjectConfigCommand(versionDir, nodeBin)} && ${npmCommand} install --prefix ${shellQuote6(versionDir)} ${NPM_SDK_INSTALL_COMMON_FLAGS.map(shellQuote6).join(" ")} ${shellQuote6(packageSpec)}`;
   return {
     kind: "python-sidecar",
     stateDir,
@@ -27658,7 +27876,7 @@ function resolveUpdatePlan(options = {}) {
     command,
     args,
     ...installPrefix ? { installPrefix } : {},
-    manualCommand: `${command} ${args.map(shellQuote5).join(" ")}`
+    manualCommand: `${command} ${args.map(shellQuote6).join(" ")}`
   };
 }
 var AUTO_UPDATE_FAILURE_FILE = ".auto-update-failure.json";
@@ -27819,9 +28037,9 @@ function writeSidecarLauncher(input2) {
     input2.path,
     [
       "#!/usr/bin/env sh",
-      `export DEEPLINE_HOST_URL=${shellQuote5(input2.hostUrl)}`,
-      `export DEEPLINE_CONFIG_SCOPE=${shellQuote5(input2.scope)}`,
-      `exec ${shellQuote5(input2.nodeBin)} ${shellQuote5(input2.entryPath)} "$@"`,
+      `export DEEPLINE_HOST_URL=${shellQuote6(input2.hostUrl)}`,
+      `export DEEPLINE_CONFIG_SCOPE=${shellQuote6(input2.scope)}`,
+      `exec ${shellQuote6(input2.nodeBin)} ${shellQuote6(input2.entryPath)} "$@"`,
       ""
     ].join("\n"),
     { encoding: "utf8", mode: 493 }

package/dist/index.js

@@ -422,10 +422,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.197",
+  version: "0.1.199",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.197",
+    latest: "0.1.199",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/dist/index.mjs

@@ -352,10 +352,10 @@ var SDK_RELEASE = {
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
-  version: "0.1.197",
+  version: "0.1.199",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.197",
+    latest: "0.1.199",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/package.json

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