deepline 0.1.236 → 0.1.237

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

@@ -108,10 +108,10 @@ export const SDK_RELEASE = {
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
   // 0.1.220 deprecates SDK CLI versions below 0.1.219 and updates them
   // automatically without blocking their current command.
-  version: '0.1.236',
+  version: '0.1.237',
   apiContract: '2026-06-dataset-handle-results-hard-cutover',
   supportPolicy: {
-    latest: '0.1.236',
+    latest: '0.1.237',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.219',
     commandMinimumSupported: [

package/dist/cli/index.js

@@ -625,10 +625,10 @@ var SDK_RELEASE = {
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
   // 0.1.220 deprecates SDK CLI versions below 0.1.219 and updates them
   // automatically without blocking their current command.
-  version: "0.1.236",
+  version: "0.1.237",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.236",
+    latest: "0.1.237",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.219",
     commandMinimumSupported: [
@@ -26363,7 +26363,9 @@ function printPlayLikeToolExecuteError(toolId, tool) {
   console.error(playLikeToolExecuteErrorMessage(toolId, tool));
 }
 function registerToolsCommands(program) {
-  const tools = program.command("tools").description("Search, describe, and execute atomic provider tools.").addHelpText(
+  const tools = program.command("tools").description(
+    "Search by intent or structured filters, describe, and execute atomic provider tools."
+  ).addHelpText(
     "after",
     `
 Concepts:
@@ -26402,30 +26404,34 @@ Examples:
       ...options.json ? ["--json"] : []
     ]);
   });
-  const addToolSearchCommand = (command) => command.description("Search available tools.").addHelpText(
+  const addToolSearchCommand = (command) => command.description(
+    "Search available tools by intent query or structured filters."
+  ).addHelpText(
     "after",
     `
 Notes:
   Ranked discovery for atomic provider/API operations. Results include tool ids
   that can be passed to deepline tools describe or deepline tools execute.
+  Provide a query, or omit it only when --categories and/or --search_terms is
+  supplied. Providing neither is a usage error. Both filters accept
+  comma-separated values. Use a provider name in the query; --prefix is not a
+  supported option.
   The grep alias is the same ranked retrieval surface with a more literal name
   for agents that are filtering a registry rather than choosing a workflow.
 
 Examples:
   deepline tools search email
+  deepline tools search --categories company_search --search_terms "investors,funding"
   deepline tools grep "company enrichment" --categories enrichment --json
   deepline tools search verifier --search-mode v2 --json
 `
   ).option(
     "--categories <categories>",
-    "Comma-separated categories to filter ranked search"
+    "Comma-separated categories; may be used without a query"
   ).option(
     "--search_terms <terms>",
-    "Structured search terms for ranked search"
-  ).option(
-    "--search-terms <terms>",
-    "Structured search terms for ranked search"
-  ).option("--search-mode <mode>", "Ranked search mode: v1 or v2").option("--include-search-debug", "Include ranked search debug metadata").option("--compact", "Drop verbose fields from JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (query, options) => {
+    "Comma-separated structured search terms; may be used without a query"
+  ).option("--search-terms <terms>", "Alias for --search_terms").option("--search-mode <mode>", "Ranked search mode: v1 or v2").option("--include-search-debug", "Include ranked search debug metadata").option("--compact", "Drop verbose fields from JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (query, options) => {
     process.exitCode = await searchTools(query, {
       json: options.json,
       compact: options.compact,
@@ -28372,6 +28378,9 @@ function sdkSkillsVersionPath(baseUrl) {
 function legacySdkSkillsVersionPath(baseUrl) {
   return (0, import_node_path18.join)((0, import_node_path18.dirname)(sdkCliStateDirPath(baseUrl)), "sdk-skills", ".version");
 }
+function unavailableSkillsNoticePath(baseUrl) {
+  return (0, import_node_path18.join)(sdkCliStateDirPath(baseUrl), "skills-sync-unavailable-version");
+}
 function readSdkSkillsLocalVersion(baseUrl) {
   const pluginVersion = readPluginSkillsVersion();
   if (pluginVersion) return pluginVersion;
@@ -28389,6 +28398,29 @@ function writeLocalSkillsVersion(baseUrl, version) {
   (0, import_node_fs16.writeFileSync)(path, `${version}
 `, "utf-8");
 }
+function writeUnavailableSkillsNotice(baseUrl, remoteVersion, skillNames) {
+  const path = unavailableSkillsNoticePath(baseUrl);
+  try {
+    if ((0, import_node_fs16.existsSync)(path) && (0, import_node_fs16.readFileSync)(path, "utf-8").trim() === remoteVersion) {
+      return;
+    }
+    (0, import_node_fs16.mkdirSync)((0, import_node_path18.dirname)(path), { recursive: true });
+    (0, import_node_fs16.writeFileSync)(path, `${remoteVersion}
+`, "utf-8");
+  } catch {
+  }
+  const manualCommand = `npx ${buildSkillsInstallArgs(baseUrl, skillNames).join(" ")}`;
+  writeSdkSkillsStatusLine(
+    `Deepline agent skills are out of date, but neither \`bunx\` nor \`npx\` is available. Install Node.js/npm or Bun, then run:
+${manualCommand}`
+  );
+}
+function clearUnavailableSkillsNotice(baseUrl) {
+  try {
+    (0, import_node_fs16.unlinkSync)(unavailableSkillsNoticePath(baseUrl));
+  } catch {
+  }
+}
 function sortedUniqueSkillNames(names) {
   return [...new Set(names.map((name) => name.trim()).filter(Boolean))].sort(
     (a, b) => a.localeCompare(b)
@@ -28464,24 +28496,24 @@ function shellQuote5(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(shellQuote5).join(" ")}`
-  };
+  const commands = [];
   if (hasCommand("bunx")) {
     const bunxArgs = buildBunxSkillsInstallArgs(baseUrl, skillNames);
-    return [
-      {
-        command: "bunx",
-        args: bunxArgs,
-        manualCommand: `bunx ${bunxArgs.map(shellQuote5).join(" ")}`
-      },
-      npxInstall
-    ];
+    commands.push({
+      command: "bunx",
+      args: bunxArgs,
+      manualCommand: `bunx ${bunxArgs.map(shellQuote5).join(" ")}`
+    });
+  }
+  if (hasCommand("npx")) {
+    const npxArgs = buildSkillsInstallArgs(baseUrl, skillNames);
+    commands.push({
+      command: "npx",
+      args: npxArgs,
+      manualCommand: `npx ${npxArgs.map(shellQuote5).join(" ")}`
+    });
   }
-  return [npxInstall];
+  return commands;
 }
 function runOneSkillsInstall(install) {
   return new Promise((resolve14) => {
@@ -28514,9 +28546,9 @@ function runOneSkillsInstall(install) {
     });
   });
 }
-async function runSkillsInstall(baseUrl, skillNames) {
+async function runSkillsInstall(installs) {
   const failures = [];
-  for (const install of resolveSkillsInstallCommands(baseUrl, skillNames)) {
+  for (const install of installs) {
     const result = await runOneSkillsInstall(install);
     if (result.ok) return true;
     failures.push(result);
@@ -28606,11 +28638,17 @@ async function syncSdkSkillsIfNeeded(baseUrl, options = {}) {
     remoteSkillNames.length > 0 ? remoteSkillNames : DEFAULT_SDK_SKILL_NAMES
   );
   if (skillNames.length === 0) return;
+  const installs = resolveSkillsInstallCommands(baseUrl, skillNames);
+  if (installs.length === 0) {
+    writeUnavailableSkillsNotice(baseUrl, update.remoteVersion, skillNames);
+    return;
+  }
   writeSdkSkillsStatusLine("Deepline skills changed; syncing agent skills...");
-  const installed = await runSkillsInstall(baseUrl, skillNames);
+  const installed = await runSkillsInstall(installs);
   if (!installed) return;
   runLegacySkillsCleanup();
   writeLocalSkillsVersion(baseUrl, update.remoteVersion);
+  clearUnavailableSkillsNotice(baseUrl);
   writeSdkSkillsStatusLine("Deepline agent skills are up to date.");
 }
 

package/dist/cli/index.mjs

@@ -610,10 +610,10 @@ var SDK_RELEASE = {
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
   // 0.1.220 deprecates SDK CLI versions below 0.1.219 and updates them
   // automatically without blocking their current command.
-  version: "0.1.236",
+  version: "0.1.237",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.236",
+    latest: "0.1.237",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.219",
     commandMinimumSupported: [
@@ -26411,7 +26411,9 @@ function printPlayLikeToolExecuteError(toolId, tool) {
   console.error(playLikeToolExecuteErrorMessage(toolId, tool));
 }
 function registerToolsCommands(program) {
-  const tools = program.command("tools").description("Search, describe, and execute atomic provider tools.").addHelpText(
+  const tools = program.command("tools").description(
+    "Search by intent or structured filters, describe, and execute atomic provider tools."
+  ).addHelpText(
     "after",
     `
 Concepts:
@@ -26450,30 +26452,34 @@ Examples:
       ...options.json ? ["--json"] : []
     ]);
   });
-  const addToolSearchCommand = (command) => command.description("Search available tools.").addHelpText(
+  const addToolSearchCommand = (command) => command.description(
+    "Search available tools by intent query or structured filters."
+  ).addHelpText(
     "after",
     `
 Notes:
   Ranked discovery for atomic provider/API operations. Results include tool ids
   that can be passed to deepline tools describe or deepline tools execute.
+  Provide a query, or omit it only when --categories and/or --search_terms is
+  supplied. Providing neither is a usage error. Both filters accept
+  comma-separated values. Use a provider name in the query; --prefix is not a
+  supported option.
   The grep alias is the same ranked retrieval surface with a more literal name
   for agents that are filtering a registry rather than choosing a workflow.
 
 Examples:
   deepline tools search email
+  deepline tools search --categories company_search --search_terms "investors,funding"
   deepline tools grep "company enrichment" --categories enrichment --json
   deepline tools search verifier --search-mode v2 --json
 `
   ).option(
     "--categories <categories>",
-    "Comma-separated categories to filter ranked search"
+    "Comma-separated categories; may be used without a query"
   ).option(
     "--search_terms <terms>",
-    "Structured search terms for ranked search"
-  ).option(
-    "--search-terms <terms>",
-    "Structured search terms for ranked search"
-  ).option("--search-mode <mode>", "Ranked search mode: v1 or v2").option("--include-search-debug", "Include ranked search debug metadata").option("--compact", "Drop verbose fields from JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (query, options) => {
+    "Comma-separated structured search terms; may be used without a query"
+  ).option("--search-terms <terms>", "Alias for --search_terms").option("--search-mode <mode>", "Ranked search mode: v1 or v2").option("--include-search-debug", "Include ranked search debug metadata").option("--compact", "Drop verbose fields from JSON output").option("--json", "Emit JSON output. Also automatic when stdout is piped").action(async (query, options) => {
     process.exitCode = await searchTools(query, {
       json: options.json,
       compact: options.compact,
@@ -28281,7 +28287,7 @@ import {
   readFileSync as readFileSync13,
   renameSync,
   rmSync as rmSync4,
-  unlinkSync,
+  unlinkSync as unlinkSync2,
   writeFileSync as writeFileSync15
 } from "fs";
 import { homedir as homedir11 } from "os";
@@ -28289,7 +28295,13 @@ import { dirname as dirname13, isAbsolute as isAbsolute2, join as join14, relati
 
 // src/cli/skills-sync.ts
 import { spawn as spawn3, spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync11, mkdirSync as mkdirSync9, readFileSync as readFileSync12, writeFileSync as writeFileSync14 } from "fs";
+import {
+  existsSync as existsSync11,
+  mkdirSync as mkdirSync9,
+  readFileSync as readFileSync12,
+  unlinkSync,
+  writeFileSync as writeFileSync14
+} from "fs";
 import { dirname as dirname12, join as join13 } from "path";
 
 // ../shared_libs/cli/install-commands.json
@@ -28429,6 +28441,9 @@ function sdkSkillsVersionPath(baseUrl) {
 function legacySdkSkillsVersionPath(baseUrl) {
   return join13(dirname12(sdkCliStateDirPath(baseUrl)), "sdk-skills", ".version");
 }
+function unavailableSkillsNoticePath(baseUrl) {
+  return join13(sdkCliStateDirPath(baseUrl), "skills-sync-unavailable-version");
+}
 function readSdkSkillsLocalVersion(baseUrl) {
   const pluginVersion = readPluginSkillsVersion();
   if (pluginVersion) return pluginVersion;
@@ -28446,6 +28461,29 @@ function writeLocalSkillsVersion(baseUrl, version) {
   writeFileSync14(path, `${version}
 `, "utf-8");
 }
+function writeUnavailableSkillsNotice(baseUrl, remoteVersion, skillNames) {
+  const path = unavailableSkillsNoticePath(baseUrl);
+  try {
+    if (existsSync11(path) && readFileSync12(path, "utf-8").trim() === remoteVersion) {
+      return;
+    }
+    mkdirSync9(dirname12(path), { recursive: true });
+    writeFileSync14(path, `${remoteVersion}
+`, "utf-8");
+  } catch {
+  }
+  const manualCommand = `npx ${buildSkillsInstallArgs(baseUrl, skillNames).join(" ")}`;
+  writeSdkSkillsStatusLine(
+    `Deepline agent skills are out of date, but neither \`bunx\` nor \`npx\` is available. Install Node.js/npm or Bun, then run:
+${manualCommand}`
+  );
+}
+function clearUnavailableSkillsNotice(baseUrl) {
+  try {
+    unlinkSync(unavailableSkillsNoticePath(baseUrl));
+  } catch {
+  }
+}
 function sortedUniqueSkillNames(names) {
   return [...new Set(names.map((name) => name.trim()).filter(Boolean))].sort(
     (a, b) => a.localeCompare(b)
@@ -28521,24 +28559,24 @@ function shellQuote5(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(shellQuote5).join(" ")}`
-  };
+  const commands = [];
   if (hasCommand("bunx")) {
     const bunxArgs = buildBunxSkillsInstallArgs(baseUrl, skillNames);
-    return [
-      {
-        command: "bunx",
-        args: bunxArgs,
-        manualCommand: `bunx ${bunxArgs.map(shellQuote5).join(" ")}`
-      },
-      npxInstall
-    ];
+    commands.push({
+      command: "bunx",
+      args: bunxArgs,
+      manualCommand: `bunx ${bunxArgs.map(shellQuote5).join(" ")}`
+    });
+  }
+  if (hasCommand("npx")) {
+    const npxArgs = buildSkillsInstallArgs(baseUrl, skillNames);
+    commands.push({
+      command: "npx",
+      args: npxArgs,
+      manualCommand: `npx ${npxArgs.map(shellQuote5).join(" ")}`
+    });
   }
-  return [npxInstall];
+  return commands;
 }
 function runOneSkillsInstall(install) {
   return new Promise((resolve14) => {
@@ -28571,9 +28609,9 @@ function runOneSkillsInstall(install) {
     });
   });
 }
-async function runSkillsInstall(baseUrl, skillNames) {
+async function runSkillsInstall(installs) {
   const failures = [];
-  for (const install of resolveSkillsInstallCommands(baseUrl, skillNames)) {
+  for (const install of installs) {
     const result = await runOneSkillsInstall(install);
     if (result.ok) return true;
     failures.push(result);
@@ -28663,11 +28701,17 @@ async function syncSdkSkillsIfNeeded(baseUrl, options = {}) {
     remoteSkillNames.length > 0 ? remoteSkillNames : DEFAULT_SDK_SKILL_NAMES
   );
   if (skillNames.length === 0) return;
+  const installs = resolveSkillsInstallCommands(baseUrl, skillNames);
+  if (installs.length === 0) {
+    writeUnavailableSkillsNotice(baseUrl, update.remoteVersion, skillNames);
+    return;
+  }
   writeSdkSkillsStatusLine("Deepline skills changed; syncing agent skills...");
-  const installed = await runSkillsInstall(baseUrl, skillNames);
+  const installed = await runSkillsInstall(installs);
   if (!installed) return;
   runLegacySkillsCleanup();
   writeLocalSkillsVersion(baseUrl, update.remoteVersion);
+  clearUnavailableSkillsNotice(baseUrl);
   writeSdkSkillsStatusLine("Deepline agent skills are up to date.");
 }
 
@@ -28896,7 +28940,7 @@ function clearAutoUpdateFailure(plan) {
   const path = autoUpdateFailurePath(plan);
   if (!path) return;
   try {
-    unlinkSync(path);
+    unlinkSync2(path);
   } catch {
   }
 }

package/dist/index.js

@@ -424,10 +424,10 @@ var SDK_RELEASE = {
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
   // 0.1.220 deprecates SDK CLI versions below 0.1.219 and updates them
   // automatically without blocking their current command.
-  version: "0.1.236",
+  version: "0.1.237",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.236",
+    latest: "0.1.237",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.219",
     commandMinimumSupported: [

package/dist/index.mjs

@@ -354,10 +354,10 @@ var SDK_RELEASE = {
   // 0.1.175 ships loud `deepline enrich` empty-waterfall reporting.
   // 0.1.220 deprecates SDK CLI versions below 0.1.219 and updates them
   // automatically without blocking their current command.
-  version: "0.1.236",
+  version: "0.1.237",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.236",
+    latest: "0.1.237",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.219",
     commandMinimumSupported: [

package/package.json

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