@apify/mcpc 0.2.0-beta.1 → 0.2.0

package/CHANGELOG.md

@@ -7,10 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-### Fixed
+## [0.2.0] - 2026-03-24
+
+### Added
 
-- Fixed auth loss when reconnecting an unauthorized session via `mcpc connect` — the `unauthorized` status was not cleared, causing all subsequent operations to fail with "Authentication required by server" even after successful reconnection
-- HTTP proxy support (`HTTP_PROXY`/`HTTPS_PROXY` env vars) now works for MCP server connections, OAuth token refresh, and x402 payment signing — previously the MCP SDK transport and OAuth calls bypassed the global proxy dispatcher
+- New `mcpc grep <pattern>` command to search tools, resources, prompts, and instructions across all active sessions, with regex, type filters, and single-session search support
+- New `tasks-list`, `tasks-get`, `tasks-cancel` commands for managing async tasks on the server
+- `--task` flag for `tools-call` to opt-in to task execution with progress spinner; `--detach` to start a task and return the task ID immediately; press ESC during `--task` to detach on the fly
+- `--insecure` global option to skip TLS certificate verification
+- `--client-id` and `--client-secret` options for `mcpc login`, for servers that don't support dynamic client registration
+- `--no-profile` option for `connect` to skip OAuth profile auto-detection
+- `mcpc login` now falls back to accepting a pasted callback URL when the browser cannot be opened (e.g. headless servers, containers)
+- `tools-list` now shows inline parameter signatures (e.g. `read_file(path: string, +4 optional)`) for quick scanning without `--full`
+- `mcpc @session` now shows available tools list from bridge cache (no extra server call)
 
 ### Changed
 
@@ -27,47 +36,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
   Direct one-shot URL access (e.g. `mcpc mcp.apify.com tools-list`) is removed; create a session first with `mcpc connect`.
 
-- Renamed `--async` flag to `--task` in `tools-call` for consistency with MCP specification; `--detach` now implies `--task`
-- Revised session states: auth failures (401/403) now show as `unauthorized` (separate from `expired` which is for session ID expiry), with actionable login guidance; new `disconnected` state surfaces when bridge is alive but server has been unreachable for >2 minutes
+- Revised session states: `unauthorized` (401/403), `disconnected` (bridge alive but server unreachable >2min), and `expired` (session ID rejected), each with actionable guidance
 - When `--profile` is not specified, only the `default` profile is used; non-default profiles require an explicit `--profile` flag
-- `@napi-rs/keyring` native addon is now loaded lazily: `mcpc` starts and works normally even when `libsecret` (Linux) or the addon itself is missing; a one-time warning is emitted and credentials fall back to `~/.mcpc/credentials.json` (mode 0600)
-- `x402 sign` now takes the PAYMENT-REQUIRED header as a positional argument instead of `-r` flag (e.g. `mcpc x402 sign <base64>`)
-- `tools-list` and `tools-get` now show `[task:optional]`, `[task:required]`, or `[task:forbidden]` instead of `[async]`
-- Tools cache now fetches all pages on startup and on `tools/list_changed` notifications; `tools-get` uses cached list first and only re-fetches if the tool is not found
-- `--header` / `-H` option is now specific to the `connect` command instead of being shown as a global option
-
-### Added
-
-- New `tasks-list`, `tasks-get`, `tasks-cancel` commands for managing async tasks on the server
-- `--task` flag for `tools-call` to opt-in to task execution with a progress spinner showing elapsed time, server status messages, and progress notifications in human mode
-- `--detach` flag for `tools-call` to start a task and return the task ID immediately without waiting for completion (implies `--task`)
-- Press ESC during `--task` execution to detach on the fly — the task continues in the background and the task ID is printed
-- `--insecure` global option to skip TLS certificate verification, for MCP servers with self-signed certificates
-- `--client-id` and `--client-secret` options for `mcpc login` command, for servers that don't support dynamic client registration
-- `--no-profile` option for `connect` command to skip OAuth profile auto-detection and connect anonymously
-- `mcpc close @session`, `mcpc restart @session`, and `mcpc shell @session` command-first syntax as alternatives to `mcpc @session close/restart/shell`
-- `mcpc login` now falls back to accepting a pasted callback URL when the browser cannot be opened (e.g. headless servers, containers)
-- `tools-list` now shows inline parameter signatures (e.g. `read_file(path: string, +4 optional)`) for quick scanning without `--full`
-- `mcpc @session` now shows available tools list from bridge cache (no extra server call)
-- Task capability and `execution.taskSupport` displayed in `tools-get` and server info
-- x402 payments are now also sent via the MCP `_meta["x402/payment"]` field on `tools/call` requests, in addition to the existing HTTP header
+- `@napi-rs/keyring` native addon is now loaded lazily; falls back to `~/.mcpc/credentials.json` when unavailable
+- `--header` / `-H` option is now specific to the `connect` command instead of being a global option
+- Tools cache now fetches all pages on startup and on `tools/list_changed` notifications
 
 ### Fixed
 
-- Explicit `--header "Authorization: Bearer ..."` is no longer silently ignored when a default OAuth profile exists for the same server; explicit CLI headers now take precedence over auto-detected profiles
-- Combining `--profile` with `--header "Authorization: ..."` now returns a clear error instead of silently stripping the header
-- Session restart now auto-detects the `default` OAuth profile created after the session was established, fixing the `login` then `restart` flow for unauthorized sessions
-- Sessions requiring authentication now correctly show as `expired` instead of `live` when the server rejects unauthenticated connections
-- Auth errors wrapped in `NetworkError` by bridge IPC are now detected on first health check, avoiding unnecessary bridge restart
+- HTTP proxy support (`HTTP_PROXY`/`HTTPS_PROXY`) now works for MCP server connections, OAuth token refresh, and x402 payment signing
+- Explicit `--header "Authorization: ..."` now takes precedence over auto-detected OAuth profiles
+- Fixed auth loss when reconnecting an unauthorized session via `mcpc connect`
+- Session restart now auto-detects the `default` OAuth profile created after the session was established
 - `--timeout` flag now correctly propagates to MCP requests via session bridge
 - `--task` and `--detach` tool calls now correctly send task creation parameters to the server
-- Bridge now forwards `logging/message` notifications from the MCP server to connected clients, so `logging-set-level` actually takes effect in interactive shell sessions
+- Bridge now forwards `logging/message` notifications to connected clients
 - IPC buffer between CLI and bridge process is now capped at 10 MB, preventing unbounded memory growth
-- `parseServerArg()` now handles Windows drive-letter config paths and other ambiguous cases
-- Misplaced subcommand-specific flags (e.g. `--full`, `--proxy`) now produce clear "Unknown option" errors instead of confusing rejections
-- `logging-set-level` JSON output no longer includes a redundant `success` field
-- `logTarget` no longer prints a misleading prefix when a session doesn't exist
-- File lock retries now use randomized exponential backoff to reduce contention
+- Fixed `mcpc help <command>` showing truncated usage line
 
 ## [0.1.10] - 2026-03-01
 
@@ -184,7 +169,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Interactive shell mode
 - JSON output mode for scripting
 
-[Unreleased]: https://github.com/apify/mcpc/compare/v0.1.10...HEAD
+[Unreleased]: https://github.com/apify/mcpc/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/apify/mcpc/compare/v0.1.10...v0.2.0
 [0.1.10]: https://github.com/apify/mcpc/compare/v0.1.9...v0.1.10
 [0.1.9]: https://github.com/apify/mcpc/compare/v0.1.8...v0.1.9
 [0.1.8]: https://github.com/apify/mcpc/compare/v0.1.7...v0.1.8

package/README.md

@@ -13,7 +13,7 @@ After all, UNIX-compatible shell script is THE most universal coding language.
 
 - 🌎 **Compatible** - Works with any MCP server over Streamable HTTP or stdio.
 - 🔄 **Persistent sessions** - Keep multiple server connections alive simultaneously.
-- 🔧 **Strong MCP support** - Instructions, tools, resources, prompts, dynamic discovery.
+- 🔧 **Strong MCP support** - Instructions, tools, resources, prompts, async tasks, dynamic discovery.
 - 🔌 **Code mode** - JSON output enables integration with CLI tools like `jq` and scripting.
 - 🤖 **AI sandboxing** - MCP proxy server to securely access authenticated sessions from AI-generated code.
 - 🔒 **Secure** - Full OAuth 2.1 support, OS keychain for credentials storage.
@@ -129,13 +129,15 @@ Commands:
   login <server>               Interactively login to a server using OAuth and save profile
   logout <server>              Delete an authentication profile for a server
   clean [resources...]         Clean up mcpc data (sessions, profiles, logs, all)
+  grep <pattern>               Search tools and instructions across all active sessions
   x402 [subcommand] [args...]  Configure an x402 payment wallet (EXPERIMENTAL)
   help [command] [subcommand]  Show help for a specific command
 
 MCP session commands (after connecting):
-  <@session>                   Show MCP server info and capabilities
-  <@session> tools-list        List MCP tools
-  <@session> tools-get <name>
+  <@session>                   Show MCP server info, capabilities, and tools
+  <@session> grep <pattern>    Search tools, resources, or prompts
+  <@session> tools-list        List all server tools
+  <@session> tools-get <name>  Get tool details and schema
   <@session> tools-call <name> [arg:=val ... | <json> | <stdin]
   <@session> prompts-list
   <@session> prompts-get <name> [arg:=val ... | <json> | <stdin]
@@ -265,6 +267,45 @@ mcpc @apify shell
 Shell commands: `help`, `exit`/`quit`/Ctrl+D, Ctrl+C to cancel.
 Arrow keys navigate history (saved to `~/.mcpc/history`).
 
+### Grep (search across sessions)
+
+`mcpc grep` searches tools, resources, and prompts across all active sessions or within a single session:
+
+```bash
+# Search tools and server instructions in all active sessions
+mcpc grep "search"
+
+# Search within a single session
+mcpc @apify grep "actor"
+
+# Search resources and prompts instead of the default tools and instructions
+mcpc grep "config" --resources --prompts
+
+# Regex search
+mcpc grep "search|find" -E
+
+# Case-sensitive search (default is case-insensitive)
+mcpc grep "Search" --case-sensitive
+
+# Limit results
+mcpc grep "e" -m 5
+
+# JSON output for scripting
+mcpc grep "actor" --json
+```
+
+By default, `grep` searches only tools. Use `--resources` or `--prompts` to search those types
+(combine with `--tools` to include tools too). Sessions that are crashed or unavailable are shown
+with their status rather than silently skipped.
+
+The `grep` command is useful for **dynamic tool discovery**, 
+also called [Tool search tool](https://www.anthropic.com/engineering/advanced-tool-use) by Anthropic
+or [Dynamic context discovery](https://cursor.com/blog/dynamic-context-discovery) by Cursor.
+Rather than loading all tools into AI agent's context, the agent can use `grep` to discover the right tool
+for the job, and only load the relevant tools into the context when needed to reduce token usage and improve accuracy.
+
+<!-- TODO: explain this more, show diagram -->
+
 ### JSON mode
 
 By default, `mcpc` prints output in Markdown-ish text format with colors, making it easy to read by both humans and AIs.
@@ -805,7 +846,7 @@ The bridge process manages the full MCP session lifecycle:
 | 🔔 [**Notifications**](#list-change-notifications) | ✅ Supported                      |
 | 📄 [**Pagination**](#pagination)                   | ✅ Supported                      |
 | 🏓 [**Ping**](#ping)                               | ✅ Supported                      |
-| ⏳ **Async tasks**                                 | 🚧 Planned                        |
+| ⏳ [**Async tasks**](#async-tasks)                  | ✅ Supported                      |
 | 📁 **Roots**                                       | 🚧 Planned                        |
 | ❓ **Elicitation**                                 | 🚧 Planned                        |
 | 🔤 **Completion**                                  | 🚧 Planned                        |
@@ -957,6 +998,35 @@ mcpc @apify ping
 mcpc @apify ping --json
 ```
 
+#### Async tasks
+
+MCP servers can execute tools as [async tasks](https://modelcontextprotocol.io/specification/latest/server/utilities/tasks)
+that run in the background and report progress. `mcpc` supports the full task lifecycle:
+
+```bash
+# Call a tool as a task (waits for completion, shows progress spinner)
+mcpc @apify tools-call long-running-job input:="data" --task
+
+# Start a task and return immediately with the task ID
+mcpc @apify tools-call long-running-job input:="data" --detach
+
+# List active tasks
+mcpc @apify tasks-list
+
+# Check task status
+mcpc @apify tasks-get <taskId>
+
+# Cancel a running task
+mcpc @apify tasks-cancel <taskId>
+```
+
+With `--task`, the CLI shows a progress spinner with elapsed time, server status messages,
+and progress notifications. Press **ESC** during execution to detach and get the task ID
+for later retrieval. With `--detach`, the task starts and returns the task ID immediately.
+
+`tools-list` and `tools-get` show task support annotations per tool:
+`[task:optional]`, `[task:required]`, or `[task:forbidden]`.
+
 ## Configuration
 
 You can configure `mcpc` using a config file, environment variables, or command-line flags.
@@ -1181,22 +1251,22 @@ See [CONTRIBUTING](./CONTRIBUTING.md) for development setup, architecture overvi
 
 <!-- Stars and activity as of March 2026. -->
 
-| Tool                                                                    | Lang   | Stars | Active | Tools | Resources | Prompts | Code mode | Sessions | OAuth | Stdio | HTTP | Tool search | LLM |
-| ----------------------------------------------------------------------- | ------ | ----: | ------ | ----- | --------- | ------- | --------- | -------- | ----- | ----- | ---- | ----------- | --- |
-| **[apify/mcpc](https://github.com/apify/mcpc)**                         | TS     |  ~350 | ✅     | ✅    | ✅        | ✅      | ✅        | ✅       | ✅    | ✅    | ✅   | —           | —   |
-| [steipete/mcporter](https://github.com/steipete/mcporter)               | TS     | ~2.6k | ✅     | ✅    | —         | —       | ✅        | ✅       | ✅    | ✅    | ✅   | —           | —   |
-| [IBM/mcp-cli](https://github.com/IBM/mcp-cli)                           | Python | ~1.9k | ✅     | ✅    | ✅        | ✅      | ✅        | ✅       | ✅    | ✅    | ✅   | —           | ✅  |
-| [f/mcptools](https://github.com/f/mcptools)                             | Go     | ~1.5k | ⚠️     | ✅    | ✅        | ✅      | ✅        | —        | —     | ✅    | ✅   | —           | —   |
-| [philschmid/mcp-cli](https://github.com/philschmid/mcp-cli)             | TS     |  ~950 | ✅     | ✅    | —         | —       | ✅        | ✅       | —     | ✅    | ✅   | ✅          | —   |
-| [adhikasp/mcp-client-cli](https://github.com/adhikasp/mcp-client-cli)   | Python |  ~670 | ⚠️     | ✅    | ✅        | ✅      | —         | —        | —     | ✅    | —    | —           | ✅  |
-| [thellimist/clihub](https://github.com/thellimist/clihub)               | Go     |  ~590 | ✅     | ✅    | —         | —       | —         | —        | ✅    | ✅    | ✅   | ✅          | —   |
-| [wong2/mcp-cli](https://github.com/wong2/mcp-cli)                       | JS     |  ~420 | ⚠️     | ✅    | ✅        | ✅      | —         | —        | ✅    | —     | ✅   | —           | —   |
-| [knowsuchagency/mcp2cli](https://github.com/knowsuchagency/mcp2cli)     | Python |  ~170 | ✅     | ✅    | ✅        | ✅      | ✅        | ✅       | ✅    | ✅    | ✅   | ✅          | —   |
-| [mcpshim/mcpshim](https://github.com/mcpshim/mcpshim)                   | Go     |   ~46 | ✅     | ✅    | —         | —       | ✅        | ✅       | ✅    | —     | ✅   | ✅          | —   |
-| [evantahler/mcpx](https://github.com/evantahler/mcpx)                   | TS     |   ~26 | ✅     | ✅    | ✅        | ✅      | ✅        | —        | ✅    | ✅    | ✅   | ✅          | —   |
-| [EstebanForge/mcp-cli-ent](https://github.com/EstebanForge/mcp-cli-ent) | Go     |   ~13 | ✅     | ✅    | —         | —       | ✅        | ✅       | —     | ✅    | ✅   | ✅          | —   |
-
-**Legend:** ✅ = supported, ⚠️ = stale (no commits in 3+ months), **LLM** = requires/uses an LLM.
+| Tool                                                                    | Lang   | Stars | Active | Tools | Resources | Prompts | Tasks | Code mode | Sessions | OAuth | Stdio | HTTP | Tool search | LLM |
+| ----------------------------------------------------------------------- | ------ | ----: | ------ | ----- | --------- | ------- | ----- | --------- | -------- | ----- | ----- | ---- | ----------- | --- |
+| **[apify/mcpc](https://github.com/apify/mcpc)**                         | TS     |  ~400 | ✅     | ✅    | ✅        | ✅      | ✅    | ✅        | ✅       | ✅    | ✅    | ✅   | —           | —   |
+| [steipete/mcporter](https://github.com/steipete/mcporter)               | TS     | ~3.2k | ✅     | ✅    | —         | —       | —     | ✅        | ✅       | ✅    | ✅    | ✅   | —           | —   |
+| [IBM/mcp-cli](https://github.com/IBM/mcp-cli)                           | Python | ~1.9k | ✅     | ✅    | ✅        | ✅      | —     | ✅        | ✅       | ✅    | ✅    | ✅   | —           | ✅  |
+| [knowsuchagency/mcp2cli](https://github.com/knowsuchagency/mcp2cli)     | Python | ~1.7k | ✅     | ✅    | ✅        | ✅      | —     | ✅        | ✅       | ✅    | ✅    | ✅   | ✅          | —   |
+| [f/mcptools](https://github.com/f/mcptools)                             | Go     | ~1.5k | ⚠️     | ✅    | ✅        | ✅      | —     | ✅        | —        | —     | ✅    | ✅   | —           | —   |
+| [philschmid/mcp-cli](https://github.com/philschmid/mcp-cli)             | TS     | ~1.0k | ✅     | ✅    | —         | —       | —     | ✅        | ✅       | —     | ✅    | ✅   | ✅          | —   |
+| [adhikasp/mcp-client-cli](https://github.com/adhikasp/mcp-client-cli)   | Python |  ~670 | ⚠️     | ✅    | ✅        | ✅      | —     | —         | —        | —     | ✅    | —    | —           | ✅  |
+| [thellimist/clihub](https://github.com/thellimist/clihub)               | Go     |  ~640 | ✅     | ✅    | —         | —       | —     | —         | —        | ✅    | ✅    | ✅   | ✅          | —   |
+| [wong2/mcp-cli](https://github.com/wong2/mcp-cli)                       | JS     |  ~430 | ⚠️     | ✅    | ✅        | ✅      | —     | —         | —        | ✅    | —     | ✅   | —           | —   |
+| [mcpshim/mcpshim](https://github.com/mcpshim/mcpshim)                   | Go     |   ~53 | ✅     | ✅    | —         | —       | —     | ✅        | ✅       | ✅    | —     | ✅   | ✅          | —   |
+| [evantahler/mcpx](https://github.com/evantahler/mcpx)                   | TS     |   ~26 | ✅     | ✅    | ✅        | ✅      | ✅    | ✅        | —        | ✅    | ✅    | ✅   | ✅          | —   |
+| [EstebanForge/mcp-cli-ent](https://github.com/EstebanForge/mcp-cli-ent) | Go     |   ~15 | ✅     | ✅    | —         | —       | —     | ✅        | ✅       | —     | ✅    | ✅   | ✅          | —   |
+
+**Legend:** ✅ = supported, ⚠️ = stale (no commits in 3+ months), **Tasks** = [async tasks](https://modelcontextprotocol.io/specification/latest/server/utilities/tasks), **LLM** = requires/uses an LLM.
 
 **Notes:**
 

package/dist/cli/commands/grep.d.ts

@@ -0,0 +1,13 @@
+import type { CommandOptions } from '../../lib/types.js';
+export interface GrepOptions extends CommandOptions {
+    tools?: boolean | undefined;
+    resources?: boolean | undefined;
+    prompts?: boolean | undefined;
+    instructions?: boolean | undefined;
+    regex?: boolean | undefined;
+    caseSensitive?: boolean | undefined;
+    maxResults?: number | undefined;
+}
+export declare function grepSession(session: string, pattern: string, options: GrepOptions): Promise<number>;
+export declare function grepAllSessions(pattern: string, options: GrepOptions): Promise<number>;
+//# sourceMappingURL=grep.d.ts.map

package/dist/cli/commands/grep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grep.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/grep.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAA0B,cAAc,EAAe,MAAM,oBAAoB,CAAC;AAgB9F,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAoVD,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CA+CjB;AAyBD,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAmL5F"}

package/dist/cli/commands/grep.js

@@ -0,0 +1,373 @@
+import chalk from 'chalk';
+import { ClientError } from '../../lib/errors.js';
+import { isProcessAlive } from '../../lib/utils.js';
+import { consolidateSessions } from '../../lib/sessions.js';
+import { withSessionClient } from '../../lib/session-client.js';
+import { withMcpClient } from '../helpers.js';
+import { formatJson, formatToolParamsInline, formatToolAnnotations, grayBacktick, inBackticks, } from '../output.js';
+import { getBridgeStatus, formatBridgeStatus } from './sessions.js';
+function buildMatcher(pattern, options) {
+    if (options.regex) {
+        let re;
+        try {
+            re = new RegExp(pattern, options.caseSensitive ? '' : 'i');
+        }
+        catch (err) {
+            throw new ClientError(`Invalid regex pattern: ${pattern}\n${err instanceof Error ? err.message : String(err)}`);
+        }
+        return (text) => re.test(text);
+    }
+    if (options.caseSensitive) {
+        return (text) => text.includes(pattern);
+    }
+    const lowerPattern = pattern.toLowerCase();
+    return (text) => text.toLowerCase().includes(lowerPattern);
+}
+function getSearchTypes(options) {
+    const anyFilter = options.tools || options.resources || options.prompts || options.instructions;
+    return {
+        searchTools: anyFilter ? !!options.tools : true,
+        searchResources: !!options.resources,
+        searchPrompts: !!options.prompts,
+        searchInstructions: anyFilter ? !!options.instructions : true,
+    };
+}
+function buildToolSearchText(tool, sessionName) {
+    return `${sessionName}/${tool.name} ${JSON.stringify(tool, null, 2)}`;
+}
+function buildResourceSearchText(resource, sessionName) {
+    return `${sessionName}/${resource.uri} ${JSON.stringify(resource, null, 2)}`;
+}
+function buildPromptSearchText(prompt, sessionName) {
+    return `${sessionName}/${prompt.name} ${JSON.stringify(prompt, null, 2)}`;
+}
+function buildInstructionsSearchText(instructions, sessionName) {
+    return `${sessionName} ${instructions}`;
+}
+async function searchClient(client, matcher, options, sessionName = '') {
+    const { searchTools, searchResources, searchPrompts, searchInstructions } = getSearchTypes(options);
+    const serverDetails = await client.getServerDetails();
+    const capabilities = serverDetails.capabilities;
+    const canListTools = searchTools && !!capabilities?.tools;
+    const canListResources = searchResources && !!capabilities?.resources;
+    const canListPrompts = searchPrompts && !!capabilities?.prompts;
+    const [toolsResult, resourcesResult, promptsResult] = await Promise.all([
+        canListTools ? client.listAllTools() : null,
+        canListResources ? fetchAllResources(client) : null,
+        canListPrompts ? fetchAllPrompts(client) : null,
+    ]);
+    const matchedTools = (toolsResult?.tools ?? []).filter((t) => matcher(buildToolSearchText(t, sessionName)));
+    const matchedResources = (resourcesResult ?? []).filter((r) => matcher(buildResourceSearchText(r, sessionName)));
+    const matchedPrompts = (promptsResult ?? []).filter((p) => matcher(buildPromptSearchText(p, sessionName)));
+    const instructionsText = searchInstructions ? serverDetails.instructions : undefined;
+    const matchedInstructions = !!instructionsText && matcher(buildInstructionsSearchText(instructionsText, sessionName));
+    return {
+        tools: matchedTools,
+        resources: matchedResources,
+        prompts: matchedPrompts,
+        instructions: matchedInstructions,
+    };
+}
+async function fetchAllResources(client) {
+    const all = [];
+    let cursor;
+    do {
+        const result = await client.listResources(cursor);
+        all.push(...result.resources);
+        cursor = result.nextCursor;
+    } while (cursor);
+    return all;
+}
+async function fetchAllPrompts(client) {
+    const all = [];
+    let cursor;
+    do {
+        const result = await client.listPrompts(cursor);
+        all.push(...result.prompts);
+        cursor = result.nextCursor;
+    } while (cursor);
+    return all;
+}
+function countMatches(result) {
+    return (result.tools.length +
+        result.resources.length +
+        result.prompts.length +
+        (result.instructions ? 1 : 0));
+}
+function countMatchesByType(result) {
+    return {
+        tools: result.tools.length,
+        resources: result.resources.length,
+        prompts: result.prompts.length,
+    };
+}
+function sumMatchesByType(results) {
+    return results.reduce((acc, r) => ({
+        tools: acc.tools + r.tools.length,
+        resources: acc.resources + r.resources.length,
+        prompts: acc.prompts + r.prompts.length,
+    }), { tools: 0, resources: 0, prompts: 0 });
+}
+function truncateResult(result, limit) {
+    const total = countMatches(result);
+    if (total <= limit)
+        return { result, truncated: 0 };
+    let remaining = limit;
+    const instructions = result.instructions && remaining > 0 ? true : false;
+    if (instructions)
+        remaining--;
+    const tools = result.tools.slice(0, remaining);
+    remaining -= tools.length;
+    const resources = result.resources.slice(0, remaining);
+    remaining -= resources.length;
+    const prompts = result.prompts.slice(0, remaining);
+    return {
+        result: { tools, resources, prompts, instructions },
+        truncated: total - limit,
+    };
+}
+function formatToolLine(tool) {
+    const bullet = chalk.dim('*');
+    const params = formatToolParamsInline(tool.inputSchema);
+    const parts = [];
+    const annotationsStr = formatToolAnnotations(tool.annotations);
+    if (annotationsStr)
+        parts.push(annotationsStr);
+    const toolAny = tool;
+    const execution = toolAny.execution;
+    const taskSupport = execution?.taskSupport;
+    if (taskSupport)
+        parts.push(`task:${taskSupport}`);
+    const suffix = parts.length > 0 ? ` ${chalk.gray(`[${parts.join(', ')}]`)}` : '';
+    return `${bullet} ${grayBacktick()}${chalk.cyan(tool.name)}${params}${grayBacktick()}${suffix}`;
+}
+function formatResourceLine(resource) {
+    const bullet = chalk.dim('*');
+    return `${bullet} ${inBackticks(resource.uri)}`;
+}
+function formatPromptLine(prompt) {
+    const bullet = chalk.dim('*');
+    return `${bullet} ${inBackticks(prompt.name)}`;
+}
+function formatResultSection(label, items, formatLine, indent) {
+    if (items.length === 0)
+        return [];
+    const lines = [];
+    lines.push(`${indent}${chalk.bold(`${label} (${items.length}):`)}`);
+    for (const item of items) {
+        lines.push(`${indent}  ${formatLine(item)}`);
+    }
+    return lines;
+}
+function formatGrepResultHuman(result, indent = '') {
+    const lines = [];
+    if (result.instructions) {
+        lines.push(`${indent}${chalk.bold('Instructions')}`);
+    }
+    lines.push(...formatResultSection('Tools', result.tools, formatToolLine, indent));
+    lines.push(...formatResultSection('Resources', result.resources, formatResourceLine, indent));
+    lines.push(...formatResultSection('Prompts', result.prompts, formatPromptLine, indent));
+    return lines;
+}
+export async function grepSession(session, pattern, options) {
+    const matcher = buildMatcher(pattern, options);
+    const sessionRef = session.startsWith('@') ? session : `@${session}`;
+    return await withMcpClient(session, options, async (client) => {
+        const fullResult = await searchClient(client, matcher, options, sessionRef);
+        const total = countMatches(fullResult);
+        const { result, truncated } = options.maxResults != null
+            ? truncateResult(fullResult, options.maxResults)
+            : { result: fullResult, truncated: 0 };
+        if (options.outputMode === 'json') {
+            const matchCounts = countMatchesByType(fullResult);
+            const jsonOutput = {
+                sessions: [
+                    {
+                        name: sessionRef,
+                        status: 'live',
+                        instructions: result.instructions,
+                        tools: result.tools,
+                        resources: result.resources,
+                        prompts: result.prompts,
+                    },
+                ],
+                totalMatches: {
+                    ...matchCounts,
+                    ...(truncated > 0 ? { truncated } : {}),
+                },
+            };
+            console.log(formatJson(jsonOutput));
+        }
+        else {
+            if (total === 0) {
+                console.log('No matches found.');
+            }
+            else {
+                const lines = formatGrepResultHuman(result);
+                lines.push('');
+                const suffix = truncated > 0 ? ` (showing ${countMatches(result)})` : '';
+                lines.push(chalk.dim(`${total} ${total === 1 ? 'match' : 'matches'}${suffix}.`));
+                console.log(lines.join('\n'));
+            }
+        }
+        return total > 0 ? 0 : 1;
+    });
+}
+function formatSkippedSession(skipped) {
+    const { dot, text } = formatBridgeStatus(skipped.status);
+    return `${chalk.cyan(skipped.name)} ${dot} ${text}`;
+}
+function isSessionQueryable(session) {
+    return !!session.pid && isProcessAlive(session.pid);
+}
+export async function grepAllSessions(pattern, options) {
+    const matcher = buildMatcher(pattern, options);
+    const { sessions } = await consolidateSessions(false);
+    const allSessionEntries = Object.values(sessions);
+    if (allSessionEntries.length === 0) {
+        if (options.outputMode === 'json') {
+            console.log(formatJson({ sessions: [], totalMatches: { tools: 0, resources: 0, prompts: 0 } }));
+        }
+        else {
+            console.log(chalk.bold('No active sessions.'));
+            console.log(chalk.dim('  \u21B3 run: mcpc connect mcp.example.com @test'));
+        }
+        return 1;
+    }
+    const toSessionRef = (name) => (name.startsWith('@') ? name : `@${name}`);
+    const queryableSessions = [];
+    const skippedSessions = [];
+    for (const session of allSessionEntries) {
+        if (isSessionQueryable(session)) {
+            queryableSessions.push(session);
+        }
+        else {
+            const status = getBridgeStatus(session);
+            skippedSessions.push({
+                name: toSessionRef(session.name),
+                status,
+            });
+        }
+    }
+    const settled = await Promise.allSettled(queryableSessions.map(async (session) => {
+        const sessionName = toSessionRef(session.name);
+        const result = await withSessionClient(sessionName, async (client) => {
+            return searchClient(client, matcher, options, sessionName);
+        });
+        return {
+            name: sessionName,
+            ...result,
+        };
+    }));
+    const results = [];
+    const resultsWithMatches = [];
+    const errors = [];
+    for (const [i, outcome] of settled.entries()) {
+        if (outcome.status === 'fulfilled') {
+            results.push(outcome.value);
+            if (countMatches(outcome.value) > 0) {
+                resultsWithMatches.push(outcome.value);
+            }
+        }
+        else {
+            const reason = outcome.reason;
+            errors.push({
+                name: toSessionRef(queryableSessions[i].name),
+                error: reason instanceof Error ? reason.message : String(reason),
+            });
+        }
+    }
+    const totalMatches = sumMatchesByType(results);
+    const totalMatchCount = results.reduce((sum, r) => sum + countMatches(r), 0);
+    let displayResultsWithMatches = resultsWithMatches;
+    let totalTruncated = 0;
+    if (options.maxResults != null) {
+        let remaining = options.maxResults;
+        displayResultsWithMatches = [];
+        for (const r of resultsWithMatches) {
+            if (remaining <= 0) {
+                totalTruncated += countMatches(r);
+                continue;
+            }
+            const { result: truncR, truncated } = truncateResult(r, remaining);
+            remaining -= countMatches(truncR);
+            totalTruncated += truncated;
+            displayResultsWithMatches.push({ ...r, ...truncR });
+        }
+    }
+    if (options.outputMode === 'json') {
+        const truncatedResultsByName = new Map(displayResultsWithMatches.map((r) => [r.name, r]));
+        const sessionEntries = [
+            ...results.map((r) => {
+                if (options.maxResults == null) {
+                    return {
+                        name: r.name,
+                        status: 'live',
+                        instructions: r.instructions,
+                        tools: r.tools,
+                        resources: r.resources,
+                        prompts: r.prompts,
+                    };
+                }
+                const display = truncatedResultsByName.get(r.name);
+                return {
+                    name: r.name,
+                    status: 'live',
+                    instructions: display?.instructions ?? false,
+                    tools: display?.tools ?? [],
+                    resources: display?.resources ?? [],
+                    prompts: display?.prompts ?? [],
+                };
+            }),
+            ...errors.map((e) => ({
+                name: e.name,
+                status: 'error',
+                error: e.error,
+            })),
+            ...skippedSessions.map((s) => ({
+                name: s.name,
+                status: s.status,
+            })),
+        ];
+        const jsonOutput = {
+            sessions: sessionEntries,
+            totalMatches: {
+                ...totalMatches,
+                ...(totalTruncated > 0 ? { truncated: totalTruncated } : {}),
+            },
+        };
+        console.log(formatJson(jsonOutput));
+    }
+    else {
+        const lines = [];
+        for (const skipped of skippedSessions) {
+            lines.push(formatSkippedSession(skipped));
+        }
+        for (const r of displayResultsWithMatches) {
+            lines.push(chalk.cyan(r.name));
+            lines.push(...formatGrepResultHuman(r, '  '));
+            lines.push('');
+        }
+        for (const err of errors) {
+            lines.push(chalk.yellow(`Warning: ${err.name} \u2014 ${err.error}`));
+        }
+        if (totalMatchCount === 0 && skippedSessions.length === 0) {
+            console.log('No matches found.');
+        }
+        else {
+            if (totalMatchCount > 0) {
+                const sessionCount = resultsWithMatches.length;
+                const showing = totalMatchCount - totalTruncated;
+                const suffix = totalTruncated > 0 ? ` (showing ${showing})` : '';
+                lines.push(chalk.dim(`${totalMatchCount} ${totalMatchCount === 1 ? 'match' : 'matches'} across ${sessionCount} ${sessionCount === 1 ? 'session' : 'sessions'}${suffix}.`));
+            }
+            else if (lines.length > 0) {
+                lines.push('');
+                lines.push('No matches found.');
+            }
+            console.log(lines.join('\n'));
+        }
+    }
+    return totalMatchCount > 0 ? 0 : 1;
+}
+//# sourceMappingURL=grep.js.map