deepline 0.1.164 → 0.1.165

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

@@ -104,10 +104,10 @@ export const SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: '0.1.164',
+  version: '0.1.165',
   apiContract: '2026-06-dataset-handle-results-hard-cutover',
   supportPolicy: {
-    latest: '0.1.164',
+    latest: '0.1.165',
     minimumSupported: '0.1.53',
     deprecatedBelow: '0.1.53',
     commandMinimumSupported: [

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

@@ -319,6 +319,15 @@ export interface ToolSearchResult {
   search_mode?: 'v1' | 'v2';
   /** Whether search fell back to category matching. */
   search_fallback_to_category?: boolean;
+  /** Explanation and next commands when filters/search succeed but match zero tools. */
+  emptyResult?: {
+    reason: string;
+    message: string;
+    suggestions: Array<{
+      label: string;
+      command: string;
+    }>;
+  };
   /** Hint explaining omitted play results when searching tools only. */
   omitted_plays_hint?: string;
   /** Copyable CLI command templates for follow-up discovery/execution. */

package/dist/cli/index.js

@@ -622,10 +622,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.164",
+  version: "0.1.165",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.164",
+    latest: "0.1.165",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -22039,6 +22039,63 @@ function matchesGrepQuery(value, query, mode) {
   if (mode === "any") return terms.some((term) => haystack.includes(term));
   return terms.every((term) => haystack.includes(term));
 }
+function shellCommandArg(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function zeroMatchToolGuidance(options) {
+  const categories = options.categories ?? [];
+  const query = options.query?.trim() ?? "";
+  const filterText = [
+    categories.length ? `categories=${categories.join(",")}` : null,
+    query ? `grep=${query}` : null,
+    query ? `grep_mode=${options.mode ?? "all"}` : null
+  ].filter(Boolean).join(" ");
+  const suggestions = [
+    ...query ? [
+      {
+        label: "Use ranked semantic search for intent-style queries",
+        command: `deepline tools search -- ${shellCommandArg(query)}`
+      },
+      ...options.mode === "all" ? [
+        {
+          label: "Relax literal grep from AND to OR matching",
+          command: `deepline tools grep --mode any -- ${shellCommandArg(query)}`
+        }
+      ] : []
+    ] : [],
+    {
+      label: "List the current atomic tool catalog",
+      command: "deepline tools list --json"
+    },
+    ...query ? [
+      {
+        label: "Search composed Deepline plays separately",
+        command: `deepline plays search -- ${shellCommandArg(query)}`
+      }
+    ] : []
+  ];
+  return {
+    reason: "filters_matched_no_atomic_tools",
+    message: `The tools catalog responded successfully, but no atomic provider tools matched ${filterText || "the current filters"}. This is a zero-match filter result, not a registry outage.`,
+    suggestions
+  };
+}
+function zeroMatchRender(emptyResult) {
+  return {
+    sections: [
+      {
+        title: "0 tools available:",
+        lines: [emptyResult.message]
+      },
+      {
+        title: "suggestions",
+        lines: emptyResult.suggestions.map(
+          (suggestion) => `${suggestion.label}: ${suggestion.command}`
+        )
+      }
+    ]
+  };
+}
 async function listTools(args) {
   const client2 = new DeeplineClient();
   const categoryArgIndex = args.findIndex((arg) => arg === "--categories");
@@ -22053,8 +22110,9 @@ async function listTools(args) {
       (category) => item.categories.includes(category)
     )
   );
+  const emptyResult = items.length === 0 && requestedCategories.length > 0 ? zeroMatchToolGuidance({ categories: requestedCategories }) : null;
   const render = {
-    sections: [
+    sections: emptyResult ? zeroMatchRender(emptyResult).sections : [
       {
         title: `${items.length} tools available:`,
         lines: items.map((item) => {
@@ -22076,6 +22134,7 @@ async function listTools(args) {
     {
       tools: outputItems,
       count: outputItems.length,
+      ...emptyResult ? { emptyResult } : {},
       filters: {
         categories: requestedCategories
       },
@@ -22147,6 +22206,11 @@ async function grepTools(queryInput, options = {}) {
   );
   const shouldCompact = options.compact || !options.json;
   const outputTools = shouldCompact ? tools.slice(0, 8).map(compactTool) : tools;
+  const emptyResult = tools.length === 0 ? zeroMatchToolGuidance({
+    categories: requestedCategories,
+    query,
+    mode
+  }) : null;
   printCommandEnvelope(
     {
       tools: outputTools,
@@ -22159,6 +22223,10 @@ async function grepTools(queryInput, options = {}) {
       filters: {
         categories: requestedCategories
       },
+      ...emptyResult ? {
+        emptyResult,
+        render: zeroMatchRender(emptyResult)
+      } : {},
       commandTemplates: TOOL_COMMAND_TEMPLATES
     },
     { json: options.json || shouldEmitJson() }

package/dist/cli/index.mjs

@@ -607,10 +607,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.164",
+  version: "0.1.165",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.164",
+    latest: "0.1.165",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [
@@ -22085,6 +22085,63 @@ function matchesGrepQuery(value, query, mode) {
   if (mode === "any") return terms.some((term) => haystack.includes(term));
   return terms.every((term) => haystack.includes(term));
 }
+function shellCommandArg(value) {
+  return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function zeroMatchToolGuidance(options) {
+  const categories = options.categories ?? [];
+  const query = options.query?.trim() ?? "";
+  const filterText = [
+    categories.length ? `categories=${categories.join(",")}` : null,
+    query ? `grep=${query}` : null,
+    query ? `grep_mode=${options.mode ?? "all"}` : null
+  ].filter(Boolean).join(" ");
+  const suggestions = [
+    ...query ? [
+      {
+        label: "Use ranked semantic search for intent-style queries",
+        command: `deepline tools search -- ${shellCommandArg(query)}`
+      },
+      ...options.mode === "all" ? [
+        {
+          label: "Relax literal grep from AND to OR matching",
+          command: `deepline tools grep --mode any -- ${shellCommandArg(query)}`
+        }
+      ] : []
+    ] : [],
+    {
+      label: "List the current atomic tool catalog",
+      command: "deepline tools list --json"
+    },
+    ...query ? [
+      {
+        label: "Search composed Deepline plays separately",
+        command: `deepline plays search -- ${shellCommandArg(query)}`
+      }
+    ] : []
+  ];
+  return {
+    reason: "filters_matched_no_atomic_tools",
+    message: `The tools catalog responded successfully, but no atomic provider tools matched ${filterText || "the current filters"}. This is a zero-match filter result, not a registry outage.`,
+    suggestions
+  };
+}
+function zeroMatchRender(emptyResult) {
+  return {
+    sections: [
+      {
+        title: "0 tools available:",
+        lines: [emptyResult.message]
+      },
+      {
+        title: "suggestions",
+        lines: emptyResult.suggestions.map(
+          (suggestion) => `${suggestion.label}: ${suggestion.command}`
+        )
+      }
+    ]
+  };
+}
 async function listTools(args) {
   const client2 = new DeeplineClient();
   const categoryArgIndex = args.findIndex((arg) => arg === "--categories");
@@ -22099,8 +22156,9 @@ async function listTools(args) {
       (category) => item.categories.includes(category)
     )
   );
+  const emptyResult = items.length === 0 && requestedCategories.length > 0 ? zeroMatchToolGuidance({ categories: requestedCategories }) : null;
   const render = {
-    sections: [
+    sections: emptyResult ? zeroMatchRender(emptyResult).sections : [
       {
         title: `${items.length} tools available:`,
         lines: items.map((item) => {
@@ -22122,6 +22180,7 @@ async function listTools(args) {
     {
       tools: outputItems,
       count: outputItems.length,
+      ...emptyResult ? { emptyResult } : {},
       filters: {
         categories: requestedCategories
       },
@@ -22193,6 +22252,11 @@ async function grepTools(queryInput, options = {}) {
   );
   const shouldCompact = options.compact || !options.json;
   const outputTools = shouldCompact ? tools.slice(0, 8).map(compactTool) : tools;
+  const emptyResult = tools.length === 0 ? zeroMatchToolGuidance({
+    categories: requestedCategories,
+    query,
+    mode
+  }) : null;
   printCommandEnvelope(
     {
       tools: outputTools,
@@ -22205,6 +22269,10 @@ async function grepTools(queryInput, options = {}) {
       filters: {
         categories: requestedCategories
       },
+      ...emptyResult ? {
+        emptyResult,
+        render: zeroMatchRender(emptyResult)
+      } : {},
       commandTemplates: TOOL_COMMAND_TEMPLATES
     },
     { json: options.json || shouldEmitJson() }

package/dist/index.d.mts

@@ -295,6 +295,15 @@ interface ToolSearchResult {
     search_mode?: 'v1' | 'v2';
     /** Whether search fell back to category matching. */
     search_fallback_to_category?: boolean;
+    /** Explanation and next commands when filters/search succeed but match zero tools. */
+    emptyResult?: {
+        reason: string;
+        message: string;
+        suggestions: Array<{
+            label: string;
+            command: string;
+        }>;
+    };
     /** Hint explaining omitted play results when searching tools only. */
     omitted_plays_hint?: string;
     /** Copyable CLI command templates for follow-up discovery/execution. */

package/dist/index.d.ts

@@ -295,6 +295,15 @@ interface ToolSearchResult {
     search_mode?: 'v1' | 'v2';
     /** Whether search fell back to category matching. */
     search_fallback_to_category?: boolean;
+    /** Explanation and next commands when filters/search succeed but match zero tools. */
+    emptyResult?: {
+        reason: string;
+        message: string;
+        suggestions: Array<{
+            label: string;
+            command: string;
+        }>;
+    };
     /** Hint explaining omitted play results when searching tools only. */
     omitted_plays_hint?: string;
     /** Copyable CLI command templates for follow-up discovery/execution. */

package/dist/index.js

@@ -421,10 +421,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.164",
+  version: "0.1.165",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.164",
+    latest: "0.1.165",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/dist/index.mjs

@@ -351,10 +351,10 @@ var SDK_RELEASE = {
   // 0.1.111 ships dataset-native tool list getters and result row datasets.
   // 0.1.154 removes the short-lived generated enrich StepOptions recompute
   // fields shipped in 0.1.153.
-  version: "0.1.164",
+  version: "0.1.165",
   apiContract: "2026-06-dataset-handle-results-hard-cutover",
   supportPolicy: {
-    latest: "0.1.164",
+    latest: "0.1.165",
     minimumSupported: "0.1.53",
     deprecatedBelow: "0.1.53",
     commandMinimumSupported: [

package/package.json

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