@pkgseer/cli 0.2.5 → 0.3.1

package/README.md

@@ -96,8 +96,20 @@ pkgseer search "json parsing" -P hex:jason,hex:poison
 # Search modes
 pkgseer search "auth" -P lodash --mode code   # Code only
 pkgseer search "auth" -P lodash --mode docs   # Docs only
+
+# Wait options (for packages that need indexing)
+pkgseer search "api" -P new-package --wait 60000  # Wait up to 60s
+pkgseer search "api" -P new-package --no-wait     # Return immediately
+
+# Resume long-running searches
+pkgseer search "api" -P large-package --no-poll   # Disable polling, get searchRef
+pkgseer search --resume <searchRef>               # Check status / get results
 ```
 
+If packages haven't been indexed yet, the search will wait up to 30 seconds by default. Use `--wait <ms>` to customize or `--no-wait` to return immediately with progress info.
+
+For long-running searches, use `--no-poll` to get a searchRef and later resume with `--resume <ref>`.
+
 ### Package Commands
 
 ```bash

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   version
-} from "./shared/chunk-drz16bhv.js";
+} from "./shared/chunk-55x4vqp2.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -211,8 +211,70 @@ var CliDocsListDocument = gql`
 }
     `;
 var CombinedSearchDocument = gql`
-    query CombinedSearch($packages: [SearchPackageInput!]!, $query: String!, $mode: SearchMode, $limit: Int) {
-  combinedSearch(packages: $packages, query: $query, mode: $mode, limit: $limit) {
+    query CombinedSearch($packages: [SearchPackageInput!]!, $query: String!, $mode: SearchMode, $limit: Int, $waitTimeoutMs: Int) {
+  combinedSearch(
+    packages: $packages
+    query: $query
+    mode: $mode
+    limit: $limit
+    waitTimeoutMs: $waitTimeoutMs
+  ) {
+    completed
+    searchRef
+    result {
+      query
+      mode
+      totalResults
+      entries {
+        id
+        type
+        title
+        subtitle
+        packageName
+        registry
+        score
+        snippet
+        filePath
+        startLine
+        endLine
+        language
+        chunkType
+        repoUrl
+        gitRef
+        pageId
+        sourceUrl
+      }
+      indexingStatus {
+        registry
+        packageName
+        version
+        codeStatus
+        docsStatus
+      }
+    }
+    progress {
+      status
+      packagesTotal
+      packagesReady
+      elapsedMs
+    }
+  }
+}
+    `;
+var SearchProgressDocument = gql`
+    query SearchProgress($searchRef: String!) {
+  searchProgress(searchRef: $searchRef) {
+    searchRef
+    status
+    packagesTotal
+    packagesReady
+    elapsedMs
+  }
+}
+    `;
+var SearchResultsDocument = gql`
+    query SearchResults($searchRef: String!) {
+  searchResults(searchRef: $searchRef) {
     query
     mode
     totalResults
@@ -613,6 +675,8 @@ var CliDocsSearchDocumentString = print(CliDocsSearchDocument);
 var CliProjectDocsSearchDocumentString = print(CliProjectDocsSearchDocument);
 var CliDocsListDocumentString = print(CliDocsListDocument);
 var CombinedSearchDocumentString = print(CombinedSearchDocument);
+var SearchProgressDocumentString = print(SearchProgressDocument);
+var SearchResultsDocumentString = print(SearchResultsDocument);
 var FetchCodeContextDocumentString = print(FetchCodeContextDocument);
 var CliDocsGetDocumentString = print(CliDocsGetDocument);
 var CreateProjectDocumentString = print(CreateProjectDocument);
@@ -655,6 +719,12 @@ function getSdk(client, withWrapper = defaultWrapper) {
     CombinedSearch(variables, requestHeaders) {
       return withWrapper((wrappedRequestHeaders) => client.rawRequest(CombinedSearchDocumentString, variables, { ...requestHeaders, ...wrappedRequestHeaders }), "CombinedSearch", "query", variables);
     },
+    SearchProgress(variables, requestHeaders) {
+      return withWrapper((wrappedRequestHeaders) => client.rawRequest(SearchProgressDocumentString, variables, { ...requestHeaders, ...wrappedRequestHeaders }), "SearchProgress", "query", variables);
+    },
+    SearchResults(variables, requestHeaders) {
+      return withWrapper((wrappedRequestHeaders) => client.rawRequest(SearchResultsDocumentString, variables, { ...requestHeaders, ...wrappedRequestHeaders }), "SearchResults", "query", variables);
+    },
     FetchCodeContext(variables, requestHeaders) {
       return withWrapper((wrappedRequestHeaders) => client.rawRequest(FetchCodeContextDocumentString, variables, { ...requestHeaders, ...wrappedRequestHeaders }), "FetchCodeContext", "query", variables);
     },
@@ -1021,6 +1091,7 @@ var TOOL_NAMES = [
   "list_package_docs",
   "fetch_package_doc",
   "search",
+  "search_status",
   "fetch_code_context",
   "search_project_docs"
 ];
@@ -1419,10 +1490,19 @@ class PkgseerServiceImpl {
       packages,
       query,
       mode: options?.mode,
-      limit: options?.limit
+      limit: options?.limit,
+      waitTimeoutMs: options?.waitTimeoutMs
     });
     return { data: result.data, errors: result.errors };
   }
+  async getSearchProgress(searchRef) {
+    const result = await this.client.SearchProgress({ searchRef });
+    return { data: result.data, errors: result.errors };
+  }
+  async getSearchResults(searchRef) {
+    const result = await this.client.SearchResults({ searchRef });
+    return { data: result.data, errors: result.errors };
+  }
   async fetchCodeContext(repoUrl, gitRef, filePath, options) {
     const result = await this.client.FetchCodeContext({
       repoUrl,
@@ -2341,7 +2421,59 @@ function registerDocsListCommand(program) {
     });
   });
 }
+// src/lib/polling.ts
+var defaultSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+async function pollUntilDone(config) {
+  const {
+    fetch: fetch2,
+    isDone,
+    onUpdate,
+    intervalMs,
+    maxWaitMs,
+    sleep = defaultSleep,
+    now = Date.now
+  } = config;
+  const startTime = now();
+  let lastData;
+  while (true) {
+    try {
+      const data = await fetch2();
+      lastData = data;
+      if (onUpdate) {
+        onUpdate(data);
+      }
+      if (isDone(data)) {
+        return { success: true, data };
+      }
+      const elapsed = now() - startTime;
+      if (elapsed >= maxWaitMs) {
+        return {
+          success: false,
+          error: `Client polling timeout after ${elapsed}ms`,
+          lastData
+        };
+      }
+      await sleep(intervalMs);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return {
+        success: false,
+        error: `Poll failed: ${message}`,
+        lastData
+      };
+    }
+  }
+}
+
 // src/commands/search.ts
+var DEFAULT_WAIT_TIMEOUT_MS = 30000;
+var DEFAULT_POLL_INTERVAL_MS = 2000;
+var DEFAULT_MAX_POLL_TIME_MS = 120000;
+var TERMINAL_STATUSES = [
+  "COMPLETED",
+  "TIMEOUT",
+  "FAILED"
+];
 var colors = {
   reset: "\x1B[0m",
   bold: "\x1B[1m",
@@ -2562,6 +2694,36 @@ function truncate(text, maxLen) {
     return text;
   return `${text.slice(0, maxLen - 3)}...`;
 }
+function isSubstantiveLine(line) {
+  const trimmed = line.trim();
+  if (trimmed.length === 0)
+    return false;
+  if (/^[(){}[\];,]+$/.test(trimmed))
+    return false;
+  if (trimmed.length <= 3 && /^[^a-zA-Z0-9]*$/.test(trimmed))
+    return false;
+  return true;
+}
+function findBestSnippetLine(snippet) {
+  const lines = snippet.split(`
+`).map((l) => l.trim());
+  if (lines.length === 0)
+    return null;
+  const middleIndex = Math.floor((lines.length - 1) / 2);
+  for (let offset = 0;offset <= lines.length; offset++) {
+    const beforeIdx = middleIndex - offset;
+    if (beforeIdx >= 0 && isSubstantiveLine(lines[beforeIdx])) {
+      return lines[beforeIdx];
+    }
+    if (offset > 0) {
+      const afterIdx = middleIndex + offset;
+      if (afterIdx < lines.length && isSubstantiveLine(lines[afterIdx])) {
+        return lines[afterIdx];
+      }
+    }
+  }
+  return null;
+}
 function formatEntryCompact(entry, useColors) {
   if (!entry)
     return "";
@@ -2579,12 +2741,11 @@ function formatEntryCompact(entry, useColors) {
   }
   let snippet = "";
   if (entry.snippet) {
-    const firstLine = entry.snippet.split(`
-`).map((l) => l.trim()).find((l) => l.length > 0);
-    if (firstLine) {
-      snippet = `  ${truncate(firstLine, 80)}`;
+    const bestLine = findBestSnippetLine(entry.snippet);
+    if (bestLine) {
+      snippet = `  ${truncate(bestLine, 80)}`;
       if (useColors) {
-        snippet = `  ${colors.dim}${truncate(firstLine, 80)}${colors.reset}`;
+        snippet = `  ${colors.dim}${truncate(bestLine, 80)}${colors.reset}`;
       }
     }
   }
@@ -2662,8 +2823,166 @@ function summarizeSearchResults(results) {
   return lines.join(`
 `);
 }
+function formatSearchProgress(progress, searchRef, useColors) {
+  const lines = [];
+  if (useColors) {
+    lines.push(`${colors.yellow}Search in progress...${colors.reset}`);
+  } else {
+    lines.push("Search in progress...");
+  }
+  if (progress) {
+    const statusText = progress.status?.toLowerCase() ?? "unknown";
+    lines.push(`Status: ${statusText}`);
+    if (progress.packagesTotal != null && progress.packagesReady != null) {
+      lines.push(`Packages: ${progress.packagesReady}/${progress.packagesTotal} ready`);
+    }
+    if (progress.elapsedMs != null) {
+      lines.push(`Elapsed: ${(progress.elapsedMs / 1000).toFixed(1)}s`);
+    }
+  }
+  lines.push("");
+  lines.push("Some packages may still be indexing.");
+  lines.push("Run again in a moment for complete results.");
+  if (searchRef) {
+    lines.push("");
+    if (useColors) {
+      lines.push(`${colors.dim}Search ref: ${searchRef}${colors.reset}`);
+    } else {
+      lines.push(`Search ref: ${searchRef}`);
+    }
+  }
+  return lines.join(`
+`);
+}
+function getWaitTimeoutMs(options) {
+  if (options.noWait) {
+    return 0;
+  }
+  if (options.wait) {
+    const parsed = Number.parseInt(options.wait, 10);
+    if (!Number.isNaN(parsed) && parsed >= 0) {
+      return parsed;
+    }
+    console.warn(`Warning: Invalid --wait value "${options.wait}". Using default (${DEFAULT_WAIT_TIMEOUT_MS}ms).`);
+  }
+  return DEFAULT_WAIT_TIMEOUT_MS;
+}
+function shouldPoll(options) {
+  if (options.noPoll) {
+    return false;
+  }
+  return process.stdout.isTTY ?? false;
+}
+async function pollSearchProgress(searchRef, pkgseerService, useColors) {
+  const result = await pollUntilDone({
+    fetch: async () => {
+      const res = await pkgseerService.getSearchProgress(searchRef);
+      return res.data.searchProgress ?? null;
+    },
+    isDone: (progress) => {
+      if (!progress)
+        return true;
+      return TERMINAL_STATUSES.includes(progress.status);
+    },
+    onUpdate: (progress) => {
+      if (progress) {
+        const statusText = progress.status?.toLowerCase() ?? "unknown";
+        const ready = progress.packagesReady ?? 0;
+        const total = progress.packagesTotal ?? 0;
+        const elapsed = ((progress.elapsedMs ?? 0) / 1000).toFixed(1);
+        console.log(`  ${statusText} (${ready}/${total} ready) - ${elapsed}s`);
+      }
+    },
+    intervalMs: DEFAULT_POLL_INTERVAL_MS,
+    maxWaitMs: DEFAULT_MAX_POLL_TIME_MS
+  });
+  if (!result.success) {
+    return { success: false, error: result.error };
+  }
+  if (!result.data) {
+    return { success: false, error: "Search session not found" };
+  }
+  return { success: true, status: result.data.status };
+}
+async function handleResume(searchRef, pkgseerService, options, useColors) {
+  const progressResult = await pkgseerService.getSearchProgress(searchRef);
+  if (progressResult.errors?.length) {
+    handleErrors(progressResult.errors, options.json ?? false);
+    return true;
+  }
+  const progress = progressResult.data.searchProgress;
+  if (!progress) {
+    outputError("Search session not found. It may have expired (sessions last 1 hour).", options.json ?? false);
+    return true;
+  }
+  if (progress.status === "COMPLETED") {
+    const resultsResponse = await pkgseerService.getSearchResults(searchRef);
+    if (resultsResponse.errors?.length) {
+      handleErrors(resultsResponse.errors, options.json ?? false);
+      return true;
+    }
+    const searchResults = resultsResponse.data.searchResults;
+    if (!searchResults) {
+      outputError("Search completed but no results returned.", options.json ?? false);
+      return true;
+    }
+    outputResults(searchResults, options, useColors);
+    return true;
+  }
+  if (progress.status === "FAILED") {
+    outputError(`Search failed. Ref: ${searchRef}`, options.json ?? false);
+    return true;
+  }
+  if (progress.status === "TIMEOUT") {
+    outputError(`Search timed out. Try again or use --wait with a higher value.
+Ref: ${searchRef}`, options.json ?? false);
+    return true;
+  }
+  if (options.json) {
+    output({
+      completed: false,
+      searchRef,
+      progress: {
+        status: progress.status,
+        packagesTotal: progress.packagesTotal,
+        packagesReady: progress.packagesReady,
+        elapsedMs: progress.elapsedMs
+      },
+      message: "Search is still in progress."
+    }, true);
+    return true;
+  }
+  console.log("Checking search status...");
+  console.log(`Status: ${progress.status?.toLowerCase() ?? "unknown"}`);
+  if (shouldPoll(options)) {
+    console.log("Polling for completion...");
+    const pollResult = await pollSearchProgress(searchRef, pkgseerService, useColors);
+    if (!pollResult.success) {
+      outputError(pollResult.error, false);
+      console.log(`Resume with: pkgseer search --resume ${searchRef}`);
+      return true;
+    }
+    if (pollResult.status === "COMPLETED") {
+      const resultsResponse = await pkgseerService.getSearchResults(searchRef);
+      if (resultsResponse.data.searchResults) {
+        outputResults(resultsResponse.data.searchResults, options, useColors);
+      }
+    } else {
+      console.log(`Search ended with status: ${pollResult.status.toLowerCase()}`);
+    }
+  } else {
+    console.log(`
+Resume with: pkgseer search --resume ${searchRef}`);
+  }
+  return true;
+}
 async function searchAction(queryArg, options, deps, defaultMode = "ALL") {
   const { pkgseerService } = deps;
+  const useColors = shouldUseColors(options.noColor);
+  if (options.resume?.trim()) {
+    await handleResume(options.resume.trim(), pkgseerService, options, useColors);
+    return;
+  }
   const query = Array.isArray(queryArg) ? queryArg.join(" ") : queryArg ?? "";
   if (!query.trim()) {
     outputError("Search query required. Provide query as argument.", options.json ?? false);
@@ -2680,17 +2999,61 @@ async function searchAction(queryArg, options, deps, defaultMode = "ALL") {
   const packages = parsePackageList(options.packages);
   const limit = options.limit ? Number.parseInt(options.limit, 10) : 25;
   const mode = options.mode ? toSearchMode(options.mode) : defaultMode;
-  const useColors = shouldUseColors(options.noColor);
+  const waitTimeoutMs = getWaitTimeoutMs(options);
   const result = await pkgseerService.combinedSearch(packages, query, {
     mode,
-    limit
+    limit,
+    waitTimeoutMs
   });
   handleErrors(result.errors, options.json ?? false);
-  if (!result.data.combinedSearch) {
+  const asyncResult = result.data.combinedSearch;
+  if (!asyncResult) {
     outputError("No results returned. Check package names and registries.", options.json ?? false);
     return;
   }
-  outputResults(result.data.combinedSearch, options, useColors);
+  if (!asyncResult.completed) {
+    const searchRef = asyncResult.searchRef;
+    if (options.json) {
+      output({
+        completed: false,
+        searchRef,
+        progress: asyncResult.progress,
+        message: "Search is still indexing. Retry for complete results."
+      }, true);
+      return;
+    }
+    if (shouldPoll(options) && searchRef) {
+      console.log("Search in progress, polling for completion...");
+      const pollResult = await pollSearchProgress(searchRef, pkgseerService, useColors);
+      if (pollResult.success && pollResult.status === "COMPLETED") {
+        const resultsResponse = await pkgseerService.getSearchResults(searchRef);
+        if (resultsResponse.data.searchResults) {
+          console.log("");
+          outputResults(resultsResponse.data.searchResults, options, useColors);
+          return;
+        }
+      }
+      if (!pollResult.success) {
+        console.log(`
+${pollResult.error}`);
+      } else if (pollResult.status !== "COMPLETED") {
+        console.log(`
+Search ended with status: ${pollResult.status.toLowerCase()}`);
+      }
+      if (searchRef) {
+        console.log(`Resume with: pkgseer search --resume ${searchRef}`);
+      }
+      return;
+    }
+    console.log(formatSearchProgress(asyncResult.progress, searchRef, useColors));
+    return;
+  }
+  const searchResults = asyncResult.result;
+  if (!searchResults) {
+    outputError("Search completed but no results returned.", options.json ?? false);
+    return;
+  }
+  outputResults(searchResults, options, useColors);
 }
 function outputResults(results, options, useColors) {
   const format = options.json ? "json" : options.format ?? "human";
@@ -2741,7 +3104,7 @@ Examples:
   # JSON output
   pkgseer search "error" -P express --json`;
 function addSearchOptions(cmd) {
-  return cmd.option("-P, --packages <packages>", "Packages to search (comma-separated). Format: name or registry/name[@version]. Examples: express | express,lodash | pypi/django@4.2").option("-m, --mode <mode>", "Search mode: all (default), code, docs").option("-l, --limit <n>", "Max results (default: 25)").option("-v, --verbose", "Expanded output with more details").option("--refs-only", "Output only references (for piping)").option("--count", "Output result counts by package").option("--format <format>", "Output format: human|summary|json", "human").option("--no-color", "Disable colored output").option("--json", "Output as JSON");
+  return cmd.option("-P, --packages <packages>", "Packages to search (comma-separated). Format: name or registry/name[@version]. Examples: express | express,lodash | pypi/django@4.2").option("-m, --mode <mode>", "Search mode: all (default), code, docs").option("-l, --limit <n>", "Max results (default: 25)").option("-v, --verbose", "Expanded output with more details").option("--refs-only", "Output only references (for piping)").option("--count", "Output result counts by package").option("--format <format>", "Output format: human|summary|json", "human").option("--no-color", "Disable colored output").option("--json", "Output as JSON").option("--wait <ms>", "Max milliseconds to wait for indexing (default: 30000)").option("--no-wait", "Return immediately without waiting for indexing").option("--resume <ref>", "Resume a previous search by reference").option("--no-poll", "Disable auto-polling for incomplete searches");
 }
 function registerSearchCommand(program) {
   const cmd = program.command("search [query...]").summary("Search code and documentation across packages").description(SEARCH_DESCRIPTION);
@@ -2782,7 +3145,7 @@ Examples:
 
 Note: For code search, use 'pkgseer search --mode code' instead.`;
 function addDocsSearchOptions(cmd) {
-  return cmd.option("-P, --packages <packages>", "Packages to search (comma-separated). Format: [registry:]name[@version]. Examples: express | express,lodash | pypi:django@4.2").option("-l, --limit <n>", "Max results (default: 25)").option("-v, --verbose", "Expanded output with more details").option("--refs-only", "Output only references (for piping)").option("--count", "Output result counts by package").option("--format <format>", "Output format: human|summary|json", "human").option("--no-color", "Disable colored output").option("--json", "Output as JSON");
+  return cmd.option("-P, --packages <packages>", "Packages to search (comma-separated). Format: [registry:]name[@version]. Examples: express | express,lodash | pypi:django@4.2").option("-l, --limit <n>", "Max results (default: 25)").option("-v, --verbose", "Expanded output with more details").option("--refs-only", "Output only references (for piping)").option("--count", "Output result counts by package").option("--format <format>", "Output format: human|summary|json", "human").option("--no-color", "Disable colored output").option("--json", "Output as JSON").option("--wait <ms>", "Max milliseconds to wait for indexing (default: 30000)").option("--no-wait", "Return immediately without waiting for indexing");
 }
 function registerDocsSearchCommand(program) {
   const cmd = program.command("search [query...]").summary("Search documentation").description(DOCS_SEARCH_DESCRIPTION);
@@ -4951,11 +5314,13 @@ var packageInputSchema2 = z7.object({
   name: z7.string().min(1).describe("Package name"),
   version: z7.string().optional().describe("Specific version (defaults to latest)")
 });
+var DEFAULT_AGENT_WAIT_TIMEOUT_MS = 1e4;
 var argsSchema9 = {
   packages: z7.array(packageInputSchema2).min(1).max(20).describe("Packages to search (1-20). Each package needs registry and name."),
   query: z7.string().min(1).describe("Search query - natural language or keywords"),
   mode: z7.enum(["all", "code", "docs"]).optional().describe('Search mode: "all" (default), "code" only, or "docs" only'),
-  limit: z7.number().int().min(1).max(100).optional().describe("Maximum results (default: 20)")
+  limit: z7.number().int().min(1).max(100).optional().describe("Maximum results (default: 20)"),
+  waitTimeoutMs: z7.number().int().min(0).max(60000).optional().describe("Max milliseconds to wait for indexing (default: 10000, 0=immediate)")
 };
 function toSearchMode2(mode) {
   if (!mode)
@@ -4993,9 +5358,9 @@ Results may be incomplete. Retry later for more complete results.`;
 function createSearchTool(pkgseerService) {
   return {
     name: "search",
-    description: "Search code and documentation across packages. Returns functions, classes, and documentation pages " + "matching your query. Use mode='code' for code only, mode='docs' for documentation only, or " + "mode='all' (default) for both. Provide 1-20 packages to search. Results include relevance scores " + "and snippets showing matches.",
+    description: "Search code and documentation across packages. Returns functions, classes, and documentation pages " + "matching your query. Use mode='code' for code only, mode='docs' for documentation only, or " + "mode='all' (default) for both. Provide 1-20 packages to search. Results include relevance scores " + "and snippets showing matches. If packages need indexing, the search will wait up to waitTimeoutMs " + "(default 10s). If not complete, returns progress info with searchRef for follow-up.",
     schema: argsSchema9,
-    handler: async ({ packages, query, mode, limit }, _extra) => {
+    handler: async ({ packages, query, mode, limit, waitTimeoutMs }, _extra) => {
       return withErrorHandling("search packages", async () => {
         const normalizedQuery = query.trim();
         if (normalizedQuery.length === 0) {
@@ -5008,15 +5373,29 @@ function createSearchTool(pkgseerService) {
         }));
         const result = await pkgseerService.combinedSearch(graphqlPackages, normalizedQuery, {
           mode: toSearchMode2(mode),
-          limit
+          limit,
+          waitTimeoutMs: waitTimeoutMs ?? DEFAULT_AGENT_WAIT_TIMEOUT_MS
         });
         const graphqlError = handleGraphQLErrors(result.errors);
         if (graphqlError)
           return graphqlError;
-        if (!result.data.combinedSearch) {
+        const asyncResult = result.data.combinedSearch;
+        if (!asyncResult) {
           return errorResult("No search results returned. Check package names and registries.");
         }
-        const searchResult = result.data.combinedSearch;
+        if (!asyncResult.completed) {
+          const progressInfo = {
+            completed: false,
+            searchRef: asyncResult.searchRef,
+            progress: asyncResult.progress,
+            message: "Search is still indexing. Retry with same query for results, " + "or increase waitTimeoutMs to wait longer."
+          };
+          return textResult(JSON.stringify(progressInfo, null, 2));
+        }
+        const searchResult = asyncResult.result;
+        if (!searchResult) {
+          return errorResult("Search completed but no results returned.");
+        }
         const entries = searchResult.entries ?? [];
         if (entries.length === 0) {
           return errorResult(`No results found for "${normalizedQuery}". ` + "Try broader terms or different packages.");
@@ -5091,6 +5470,55 @@ function createSearchProjectDocsTool(deps) {
     }
   };
 }
+// src/tools/search-status.ts
+import { z as z9 } from "zod";
+var argsSchema11 = {
+  searchRef: z9.string().min(1).describe("Search reference from a previous incomplete search")
+};
+function createSearchStatusTool(pkgseerService) {
+  return {
+    name: "search_status",
+    description: "Check the status of an async search and get results if complete. " + "Use this after a search returns incomplete (completed=false) to poll for completion. " + "Returns status (PENDING, INDEXING, SEARCHING, COMPLETED, TIMEOUT, FAILED), " + "progress info (packagesReady/packagesTotal), and results when status is COMPLETED.",
+    schema: argsSchema11,
+    handler: async ({ searchRef }, _extra) => {
+      return withErrorHandling("check search status", async () => {
+        const progressResult = await pkgseerService.getSearchProgress(searchRef);
+        const graphqlError = handleGraphQLErrors(progressResult.errors);
+        if (graphqlError)
+          return graphqlError;
+        const progress = progressResult.data.searchProgress;
+        if (!progress) {
+          return errorResult("Search session not found. It may have expired (sessions last 1 hour).");
+        }
+        if (progress.status === "COMPLETED") {
+          const resultsResponse = await pkgseerService.getSearchResults(searchRef);
+          const resultsError = handleGraphQLErrors(resultsResponse.errors);
+          if (resultsError)
+            return resultsError;
+          const searchResults = resultsResponse.data.searchResults;
+          if (!searchResults) {
+            return errorResult("Search completed but results are no longer available. " + "The session may have expired (sessions last 1 hour).");
+          }
+          return textResult(JSON.stringify({
+            status: progress.status,
+            searchRef: progress.searchRef,
+            result: searchResults
+          }, null, 2));
+        }
+        return textResult(JSON.stringify({
+          status: progress.status,
+          searchRef: progress.searchRef,
+          progress: {
+            packagesTotal: progress.packagesTotal,
+            packagesReady: progress.packagesReady,
+            elapsedMs: progress.elapsedMs
+          },
+          message: progress.status === "FAILED" ? "Search failed." : progress.status === "TIMEOUT" ? "Search timed out before completion." : "Search is still in progress. Poll again to check status."
+        }, null, 2));
+      });
+    }
+  };
+}
 // src/commands/mcp.ts
 var TOOL_FACTORIES = {
   package_summary: ({ pkgseerService }) => createPackageSummaryTool(pkgseerService),
@@ -5101,6 +5529,7 @@ var TOOL_FACTORIES = {
   list_package_docs: ({ pkgseerService }) => createListPackageDocsTool(pkgseerService),
   fetch_package_doc: ({ pkgseerService }) => createFetchPackageDocTool(pkgseerService),
   search: ({ pkgseerService }) => createSearchTool(pkgseerService),
+  search_status: ({ pkgseerService }) => createSearchStatusTool(pkgseerService),
   fetch_code_context: ({ pkgseerService }) => createFetchCodeContextTool(pkgseerService),
   search_project_docs: ({ pkgseerService, configService, defaultProjectDir }) => createSearchProjectDocsTool({
     pkgseerService,
@@ -5117,6 +5546,7 @@ var PUBLIC_READ_TOOLS = [
   "list_package_docs",
   "fetch_package_doc",
   "search",
+  "search_status",
   "fetch_code_context"
 ];
 var PROJECT_READ_TOOLS = ["search_project_docs"];

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   version
-} from "./shared/chunk-drz16bhv.js";
+} from "./shared/chunk-55x4vqp2.js";
 export {
   version
 };

package/dist/shared/{chunk-drz16bhv.js → chunk-55x4vqp2.js}

@@ -1,4 +1,4 @@
 // package.json
-var version = "0.2.5";
+var version = "0.3.1";
 
 export { version };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pkgseer/cli",
   "description": "CLI companion for PkgSeer - package intelligence for developers and AI assistants",
-  "version": "0.2.5",
+  "version": "0.3.1",
   "type": "module",
   "files": [
     "dist",