deepline 0.3.225 → 0.3.227

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.227',
   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/bundling-sources/shared_libs/play-runtime/runtime-map-row-feed.ts

@@ -39,6 +39,11 @@ type Waiter<T> = {
   timer: ReturnType<typeof setTimeout>;
 };
 
+type DrainWaiter = Waiter<void> & {
+  idleStartedAt: number;
+  onTimeout: () => void;
+};
+
 export class RuntimeMapRowFeed {
   #appended = 0;
   #dispatched = 0;
@@ -47,7 +52,7 @@ export class RuntimeMapRowFeed {
   #failure: unknown = null;
   #failed = false;
   readonly #rowWaiters = new Map<Waiter<boolean>, number>();
-  #drainWaiter: Waiter<void> | null = null;
+  #drainWaiter: DrainWaiter | null = null;
   #onAppended: ((fromIndex: number, toIndex: number) => void) | null = null;
   readonly #maxWaitMs: number;
 
@@ -70,7 +75,9 @@ export class RuntimeMapRowFeed {
       throw new Error('Runtime map row feed is closed; cannot append rows.');
     }
     if (!Number.isInteger(rowCount) || rowCount < 0) {
-      throw new Error(`Runtime map row feed append count must be a non-negative integer, got ${String(rowCount)}.`);
+      throw new Error(
+        `Runtime map row feed append count must be a non-negative integer, got ${String(rowCount)}.`,
+      );
     }
     const fromIndex = this.#appended;
     this.#appended += rowCount;
@@ -111,13 +118,29 @@ export class RuntimeMapRowFeed {
   }
 
   markDispatched(count = 1): void {
-    this.#dispatched += count;
-    if (this.#dispatched > this.#appended) {
+    if (!Number.isInteger(count) || count < 0) {
       throw new Error(
-        `Runtime map row feed dispatched ${this.#dispatched} rows but only ${this.#appended} were appended.`,
+        `Runtime map row feed dispatch count must be a non-negative integer, got ${String(count)}.`,
       );
     }
+    const dispatched = this.#dispatched + count;
+    if (dispatched > this.#appended) {
+      throw new Error(
+        `Runtime map row feed dispatched ${dispatched} rows but only ${this.#appended} were appended.`,
+      );
+    }
+    this.#dispatched = dispatched;
     this.#settleDrainWaiter();
+    const waiter = this.#drainWaiter;
+    if (count > 0 && waiter) {
+      // A slow page can take longer than the idle bound to dispatch. Only
+      // advancing its pending work resets the diagnostic, never page age,
+      // provider logs, or unrelated activity.
+      clearTimeout(waiter.timer);
+      waiter.idleStartedAt = Date.now();
+      waiter.timer = setTimeout(waiter.onTimeout, this.#maxWaitMs);
+      waiter.timer.unref?.();
+    }
   }
 
   /**
@@ -149,7 +172,7 @@ export class RuntimeMapRowFeed {
     });
   }
 
-  /** Resolves once every appended row has been dispatched to a worker. */
+  /** Resolves on full dispatch; rejects after the bound with no dispatch progress. */
   waitUntilDrained(): Promise<void> {
     if (this.#failed) return Promise.reject(this.#failure);
     if (this.#dispatched >= this.#appended) return Promise.resolve();
@@ -159,22 +182,25 @@ export class RuntimeMapRowFeed {
       );
     }
     return new Promise<void>((resolve, reject) => {
-      const startedAt = Date.now();
-      this.#drainWaiter = {
+      const waiter: DrainWaiter = {
         resolve,
         reject,
-        timer: setTimeout(() => {
+        idleStartedAt: Date.now(),
+        onTimeout: () => {
+          if (this.#drainWaiter !== waiter) return;
           this.#drainWaiter = null;
           reject(
             new RuntimeMapRowFeedStalledError({
               waiter: 'pump',
-              waitMs: Date.now() - startedAt,
+              waitMs: Date.now() - waiter.idleStartedAt,
               snapshot: this.snapshot(),
             }),
           );
-        }, this.#maxWaitMs),
+        },
+        timer: setTimeout(() => waiter.onTimeout(), this.#maxWaitMs),
       };
-      this.#drainWaiter.timer.unref?.();
+      this.#drainWaiter = waiter;
+      waiter.timer.unref?.();
     });
   }
 

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.227",
   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.227",
   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.227",
   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.227",
   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.227";
     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.227";
     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.227",
   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.227",
   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.227",
   "description": "GTM data CLI and TypeScript SDK for coding agents",
   "license": "MIT",
   "homepage": "https://code.deepline.com",