deepline 0.3.225 → 0.3.226

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

@@ -3401,6 +3401,9 @@ export class DeeplineClient {
     if (options.searchTerms?.trim()) {
       params.set('search_terms', options.searchTerms.trim());
     }
+    if (options.task?.trim()) {
+      params.set('task', options.task.trim());
+    }
     return this.http.get<ToolSearchResult>(
       `/api/v2/tools/search?${params.toString()}`,
     );

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

@@ -200,7 +200,7 @@ export const SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: '0.3.225',
+  version: '0.3.226',
   updateSummary:
     'Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.',
   packageCapabilities: {

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

@@ -476,6 +476,8 @@ export interface ToolSearchOptions {
   categories?: string;
   /** Optional explicit search terms used by agent/CLI callers. */
   searchTerms?: string;
+  /** One sentence: the input you have and the result you need (not the query restated). */
+  task?: string;
   /** Search algorithm/version. Defaults to the current ranked mode. */
   searchMode?: 'v1' | 'v2';
   /** Include backend debug metadata in the search response. */

package/dist/cli/index.js

@@ -3051,7 +3051,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.225",
+  version: "0.3.226",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -7603,6 +7603,9 @@ var DeeplineClient = class _DeeplineClient {
     if (options.searchTerms?.trim()) {
       params.set("search_terms", options.searchTerms.trim());
     }
+    if (options.task?.trim()) {
+      params.set("task", options.task.trim());
+    }
     return this.http.get(
       `/api/v2/tools/search?${params.toString()}`
     );
@@ -50068,6 +50071,7 @@ async function searchTools(queryInput, options = {}) {
     query,
     categories: options.categories,
     searchTerms: options.searchTerms,
+    task: options.task,
     limit: options.limit,
     offset: options.offset,
     searchMode: options.searchMode,
@@ -50303,6 +50307,9 @@ Notes:
   supplied. Providing neither is a usage error. Both filters accept
   comma-separated values. Use --limit and --offset to page through ranked
   results (limit 1-50, offset is zero-based); JSON includes next_offset.
+  Pass --task with one sentence on what you are trying to accomplish right
+  now: the input you have and the result you need, not a restatement of the
+  query. It materially improves ranking, especially for short queries.
   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.
@@ -50310,6 +50317,7 @@ Notes:
 Examples:
   deepline tools search email --limit 10 --json
   deepline tools search email --limit 10 --offset 10 --json
+  deepline tools search linkedin --task "I have 200 LinkedIn profile URLs and need each person's current title and company" --json
   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
@@ -50320,7 +50328,10 @@ Examples:
   ).option(
     "--search_terms <terms>",
     "Comma-separated structured search terms; may be used without a query"
-  ).option("--search-terms <terms>", "Alias for --search_terms").option("--limit <count>", "Maximum ranked results to return (1-50)").option("--offset <count>", "Zero-based ranked result offset").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) => {
+  ).option("--search-terms <terms>", "Alias for --search_terms").option(
+    "--task <sentence>",
+    "What you are trying to accomplish: input you have -> result you need"
+  ).option("--limit <count>", "Maximum ranked results to return (1-50)").option("--offset <count>", "Zero-based ranked result offset").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,
@@ -50328,6 +50339,7 @@ Examples:
       offset: options.offset !== void 0 ? Number.parseInt(options.offset, 10) : void 0,
       categories: options.categories,
       searchTerms: options.searchTerms ?? options.search_terms,
+      task: options.task,
       searchMode: options.searchMode === "v1" || options.searchMode === "v2" ? options.searchMode : void 0,
       includeSearchDebug: Boolean(options.includeSearchDebug)
     });

package/dist/cli/index.mjs

@@ -3046,7 +3046,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.225",
+  version: "0.3.226",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -7598,6 +7598,9 @@ var DeeplineClient = class _DeeplineClient {
     if (options.searchTerms?.trim()) {
       params.set("search_terms", options.searchTerms.trim());
     }
+    if (options.task?.trim()) {
+      params.set("task", options.task.trim());
+    }
     return this.http.get(
       `/api/v2/tools/search?${params.toString()}`
     );
@@ -50216,6 +50219,7 @@ async function searchTools(queryInput, options = {}) {
     query,
     categories: options.categories,
     searchTerms: options.searchTerms,
+    task: options.task,
     limit: options.limit,
     offset: options.offset,
     searchMode: options.searchMode,
@@ -50451,6 +50455,9 @@ Notes:
   supplied. Providing neither is a usage error. Both filters accept
   comma-separated values. Use --limit and --offset to page through ranked
   results (limit 1-50, offset is zero-based); JSON includes next_offset.
+  Pass --task with one sentence on what you are trying to accomplish right
+  now: the input you have and the result you need, not a restatement of the
+  query. It materially improves ranking, especially for short queries.
   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.
@@ -50458,6 +50465,7 @@ Notes:
 Examples:
   deepline tools search email --limit 10 --json
   deepline tools search email --limit 10 --offset 10 --json
+  deepline tools search linkedin --task "I have 200 LinkedIn profile URLs and need each person's current title and company" --json
   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
@@ -50468,7 +50476,10 @@ Examples:
   ).option(
     "--search_terms <terms>",
     "Comma-separated structured search terms; may be used without a query"
-  ).option("--search-terms <terms>", "Alias for --search_terms").option("--limit <count>", "Maximum ranked results to return (1-50)").option("--offset <count>", "Zero-based ranked result offset").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) => {
+  ).option("--search-terms <terms>", "Alias for --search_terms").option(
+    "--task <sentence>",
+    "What you are trying to accomplish: input you have -> result you need"
+  ).option("--limit <count>", "Maximum ranked results to return (1-50)").option("--offset <count>", "Zero-based ranked result offset").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,
@@ -50476,6 +50487,7 @@ Examples:
       offset: options.offset !== void 0 ? Number.parseInt(options.offset, 10) : void 0,
       categories: options.categories,
       searchTerms: options.searchTerms ?? options.search_terms,
+      task: options.task,
       searchMode: options.searchMode === "v1" || options.searchMode === "v2" ? options.searchMode : void 0,
       includeSearchDebug: Boolean(options.includeSearchDebug)
     });

package/dist/index.d.mts

@@ -1492,6 +1492,8 @@ interface ToolSearchOptions {
     categories?: string;
     /** Optional explicit search terms used by agent/CLI callers. */
     searchTerms?: string;
+    /** One sentence: the input you have and the result you need (not the query restated). */
+    task?: string;
     /** Search algorithm/version. Defaults to the current ranked mode. */
     searchMode?: 'v1' | 'v2';
     /** Include backend debug metadata in the search response. */

package/dist/index.d.ts

@@ -1492,6 +1492,8 @@ interface ToolSearchOptions {
     categories?: string;
     /** Optional explicit search terms used by agent/CLI callers. */
     searchTerms?: string;
+    /** One sentence: the input you have and the result you need (not the query restated). */
+    task?: string;
     /** Search algorithm/version. Defaults to the current ranked mode. */
     searchMode?: 'v1' | 'v2';
     /** Include backend debug metadata in the search response. */

package/dist/index.js

@@ -864,7 +864,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.225",
+  version: "0.3.226",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -5275,6 +5275,9 @@ var DeeplineClient = class _DeeplineClient {
     if (options.searchTerms?.trim()) {
       params.set("search_terms", options.searchTerms.trim());
     }
+    if (options.task?.trim()) {
+      params.set("task", options.task.trim());
+    }
     return this.http.get(
       `/api/v2/tools/search?${params.toString()}`
     );

package/dist/index.mjs

@@ -768,7 +768,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.225",
+  version: "0.3.226",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1
@@ -5179,6 +5179,9 @@ var DeeplineClient = class _DeeplineClient {
     if (options.searchTerms?.trim()) {
       params.set("search_terms", options.searchTerms.trim());
     }
+    if (options.task?.trim()) {
+      params.set("task", options.task.trim());
+    }
     return this.http.get(
       `/api/v2/tools/search?${params.toString()}`
     );

package/dist/release.d.mts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.225";
+    readonly version: "0.3.226";
     readonly updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.d.ts

@@ -149,7 +149,7 @@ type SdkRelease = {
     supportPolicy: SdkSupportPolicy;
 };
 declare const SDK_RELEASE: {
-    readonly version: "0.3.225";
+    readonly version: "0.3.226";
     readonly updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.";
     readonly packageCapabilities: {
         readonly updatePreferences: 1;

package/dist/release.js

@@ -74,7 +74,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.225",
+  version: "0.3.226",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/dist/release.mjs

@@ -48,7 +48,7 @@ var SDK_RELEASE = {
   // getters keep their established compatibility behavior.
   // 0.3.1 deprecated the legacy `deepline enrich` command in favor of Plays.
   // 0.3.90 is the first deliberately versioned SDK release for API v3.
-  version: "0.3.225",
+  version: "0.3.226",
   updateSummary: "Play grep now returns concise results with the matched fields and terms. Automatic CLI updates are enabled by default; use `deepline settings autoupdate off` to opt out, `deepline settings autoupdate on` to re-enable updates, or `deepline settings autoupdate pin <version>` to hold an exact release.",
   packageCapabilities: {
     updatePreferences: 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepline",
-  "version": "0.3.225",
+  "version": "0.3.226",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",