easyeda-mcp-pro 0.3.2 → 0.5.2

package/README.md

@@ -11,29 +11,35 @@
 
 ## Quick Start
 
-```bash
-npx easyeda-mcp-pro
-```
+The fastest way to install and configure `easyeda-mcp-pro` for your favorite AI assistant or IDE:
 
-Point your MCP client (Claude, Cursor, etc.) to the stdio transport. Create a `.env` file to configure suppliers and AI providers (see [Configuration](#configuration)).
+1. **Auto-configure your MCP client:**
 
-For the recommended no-terminal workflow, let your MCP client auto-start the server:
+   ```bash
+   npx easyeda-mcp-pro setup all
+   ```
 
-```bash
-npx easyeda-mcp-pro --setup-local
-```
+   _This detects and configures Claude Desktop, Cursor, VS Code, Windsurf, Cline, Gemini, Zed, etc. to run the MCP server automatically._
+   _(Or run for a specific client, e.g., `npx easyeda-mcp-pro setup claude`)_
+
+2. **Locate and install the EasyEDA Pro bridge extension:**
 
-The setup command prints:
+   ```bash
+   npx easyeda-mcp-pro extension --open
+   ```
 
-- the EasyEDA Pro extension package path (`easyeda-bridge-extension.eext`)
-- a local MCP client config that starts `dist/index.js` automatically
-- an npm/npx MCP client config for published package usage
+   _This opens the folder containing the extension package `easyeda-bridge-extension.eext`. Import it via **EasyEDA Pro → Settings → Extensions → Extension Manager**._
+
+3. **Connect the bridge:**
+   In EasyEDA Pro, click **MCP Bridge → Connect** in the menu bar.
+
+For advanced configurations, manual instructions, and specific clients, see [Installation & Client Configuration](#installation--client-configuration).
 
 ---
 
 ## Overview
 
-easyeda-mcp-pro is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that bridges AI assistants with hardware design workflows in EasyEDA Pro. It exposes 34 profile-gated MCP tools for schematic inspection and editing, controlled EasyEDA Pro API calls, BOM management, design rule checks, PCB board analysis, fabrication exports, and supplier integration.
+easyeda-mcp-pro is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that bridges AI assistants with hardware design workflows in EasyEDA Pro. It exposes 41 profile-gated MCP tools for schematic inspection and editing, controlled EasyEDA Pro API calls, BOM management, design rule checks, PCB board analysis, fabrication exports, and supplier integration.
 
 The server connects to EasyEDA Pro via a WebSocket bridge extension, enabling real-time access to open project data. It integrates with JLCPCB, LCSC, Mouser, and DigiKey for BOM sourcing and pricing.
 
@@ -59,40 +65,297 @@ The server connects to EasyEDA Pro via a WebSocket bridge extension, enabling re
 
 ---
 
-## Installation
+## Installation & Client Configuration
+
+You can configure `easyeda-mcp-pro` automatically or manually.
+
+### 1. Automatic Configuration (CLI)
 
-### Via npm (recommended)
+The CLI setup automates editing the configuration files for your client:
 
 ```bash
-npm install -g easyeda-mcp-pro
-easyeda-mcp-pro
+# Configure all detected clients automatically
+npx easyeda-mcp-pro setup all
+
+# Or configure a specific client
+npx easyeda-mcp-pro setup <client>
 ```
 
-### Via npx
+#### Supported Client Keys:
+
+- `claude` (Claude Desktop)
+- `cursor` (Cursor IDE)
+- `vscode` (VS Code Copilot)
+- `windsurf` (Windsurf)
+- `cline` (Cline)
+- `gemini` (Gemini CLI / Antigravity)
+- `zed` (Zed Editor)
+- `amazonq` (Amazon Q Developer)
+- `continue` (Continue.dev)
+
+#### Options:
+
+- `--profile <name>`: Specify the tool profile. Options: `core` (default), `pro`, `full`, `dev`.
+  Example: `npx easyeda-mcp-pro setup cursor --profile full`
+
+### 2. Extension Installation
+
+To bridge the MCP server with EasyEDA Pro:
 
 ```bash
-npx easyeda-mcp-pro
+# Open the directory containing the .eext extension package in your file manager
+npx easyeda-mcp-pro extension --open
+
+# Or copy it to a specific directory
+npx easyeda-mcp-pro extension --copy /path/to/destination
 ```
 
-### From source
+**Installation steps in EasyEDA Pro:**
+
+1. Open **EasyEDA Pro**.
+2. Go to **Settings** → **Extensions** → **Extension Manager**.
+3. Click **Import Extension** and select the `easyeda-bridge-extension.eext` file.
+4. Ensure **Allow External Interaction** is enabled for the extension.
+5. Click **MCP Bridge** → **Connect** in the menu bar.
+
+---
+
+### 3. Manual Client Configurations
+
+If you prefer to configure your clients manually, add the following configuration to the respective settings files:
+
+<details>
+<summary>🟣 Claude Desktop</summary>
+
+**Config Path:**
+
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Linux: `~/.config/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "easyeda-mcp-pro": {
+      "command": "npx",
+      "args": ["-y", "easyeda-mcp-pro@latest"],
+      "env": {
+        "TOOL_PROFILE": "core"
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary>🔵 Cursor IDE</summary>
+
+**Config Path:** Project-specific `.cursor/mcp.json` or global `~/.cursor/mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "easyeda-mcp-pro": {
+      "command": "npx",
+      "args": ["-y", "easyeda-mcp-pro@latest"],
+      "env": {
+        "TOOL_PROFILE": "pro"
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary>🟢 VS Code (GitHub Copilot)</summary>
+
+**Config Path:** `%APPDATA%\Code\User\mcp.json` (Windows), `~/Library/Application Support/Code/User/mcp.json` (macOS), or `~/.config/Code/User/mcp.json` (Linux)
+
+```json
+{
+  "servers": {
+    "easyeda-mcp-pro": {
+      "command": "npx",
+      "args": ["-y", "easyeda-mcp-pro@latest"],
+      "env": {
+        "TOOL_PROFILE": "pro"
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary>🏄 Windsurf (Codeium)</summary>
+
+**Config Path:** `~/.codeium/windsurf/mcp_config.json`
+
+```json
+{
+  "mcpServers": {
+    "easyeda-mcp-pro": {
+      "command": "npx",
+      "args": ["-y", "easyeda-mcp-pro@latest"],
+      "env": {
+        "TOOL_PROFILE": "pro"
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary>🤖 Cline</summary>
+
+**Config Path:** Cline VS Code extension global storage (`cline_mcp_settings.json`)
+
+```json
+{
+  "mcpServers": {
+    "easyeda-mcp-pro": {
+      "command": "npx",
+      "args": ["-y", "easyeda-mcp-pro@latest"],
+      "env": {
+        "TOOL_PROFILE": "pro"
+      },
+      "disabled": false,
+      "autoApprove": []
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary>✨ Gemini CLI / Antigravity</summary>
+
+**Config Path:** `~/.gemini/settings.json` or `~/.gemini/config/mcp_config.json`
+
+```json
+{
+  "mcpServers": {
+    "easyeda-mcp-pro": {
+      "command": "npx",
+      "args": ["-y", "easyeda-mcp-pro@latest"],
+      "env": {
+        "TOOL_PROFILE": "pro"
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary>⚡ Zed Editor</summary>
+
+**Config Path:** `~/.config/zed/settings.json`
+
+```json
+{
+  "context_servers": {
+    "easyeda-mcp-pro": {
+      "command": {
+        "path": "npx",
+        "args": ["-y", "easyeda-mcp-pro@latest"]
+      },
+      "settings": {}
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary>🔄 Continue.dev</summary>
+
+**Config Path:** `~/.continue/config.json`
+
+```json
+{
+  "mcpServers": {
+    "easyeda-mcp-pro": {
+      "command": "npx",
+      "args": ["-y", "easyeda-mcp-pro@latest"],
+      "env": {
+        "TOOL_PROFILE": "pro"
+      }
+    }
+  }
+}
+```
+
+</details>
+
+<details>
+<summary>👑 Amazon Q Developer</summary>
+
+**Config Path:** `~/.aws/amazonq/mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "easyeda-mcp-pro": {
+      "command": "npx",
+      "args": ["-y", "easyeda-mcp-pro@latest"],
+      "env": {
+        "TOOL_PROFILE": "pro"
+      }
+    }
+  }
+}
+```
+
+</details>
+
+---
+
+### 4. Running from Source (Development)
+
+If you are developing or running a modified local build:
 
 ```bash
 git clone https://github.com/oaslananka/easyeda-mcp-pro.git
 cd easyeda-mcp-pro
 cp .env.example .env
 pnpm install
-pnpm setup:local
+
+# Build the server and the bridge extension package
+pnpm build
+pnpm build:extension
+```
+
+To configure your clients to use the local development build:
+
+```bash
+# Print instructions and local config block pointing to dist/index.js
+node dist/index.js --setup-local
 ```
 
-Install or reload the generated `easyeda-bridge-extension.eext` package in EasyEDA Pro. Then add the printed MCP config to your MCP client. After that, your MCP client starts the server automatically; do not keep a separate `node dist/index.js` terminal running.
+### Local Diagnostics & Health Check
 
-### Local health check
+You can diagnose your environment and bridge connectivity at any time:
 
 ```bash
 pnpm doctor
 ```
 
-The doctor command checks the Node.js runtime, built server entry, generated EasyEDA extension package, and local bridge port reachability. If the bridge server is offline, that is normal until your MCP client starts `easyeda-mcp-pro`.
+This checks:
+
+1. Node.js version compatibility.
+2. Existence of build files and the `.eext` extension package.
+3. Bridge port availability. _Note: The bridge status will show as offline until an MCP client starts the server and connects to the EasyEDA Pro extension._
 
 ---
 
@@ -102,29 +365,36 @@ Copy `.env.example` to `.env` and edit. All variables have safe defaults — onl
 
 ### Essential
 
-| Variable       | Default       | Description                                                                  |
-| -------------- | ------------- | ---------------------------------------------------------------------------- |
-| `NODE_ENV`     | `development` | Set to `production` in production                                            |
-| `LOG_LEVEL`    | `info`        | Pino log level: `trace`, `debug`, `info`, `warn`, `error`, `fatal`, `silent` |
-| `TOOL_PROFILE` | `core`        | Tool set: `core`, `pro`, `full`, `dev`, `experimental`                       |
-| `TRANSPORT`    | `stdio`       | Server transport: `stdio` (default) or `http`                                |
+| Variable               | Default       | Description                                                                  |
+| ---------------------- | ------------- | ---------------------------------------------------------------------------- |
+| `NODE_ENV`             | `development` | Set to `production` in production                                            |
+| `LOG_LEVEL`            | `info`        | Pino log level: `trace`, `debug`, `info`, `warn`, `error`, `fatal`, `silent` |
+| `TOOL_PROFILE`         | `core`        | Tool set: `core`, `pro`, `full`, `dev`, `experimental`                       |
+| `MCP_PROTOCOL_VERSION` | `2025-11-25`  | MCP protocol version string                                                  |
+| `TRANSPORT`            | `stdio`       | Server transport: `stdio` (default) or `http`                                |
 
 ### Bridge (EasyEDA Pro connection)
 
-| Variable              | Default             | Description                      |
-| --------------------- | ------------------- | -------------------------------- |
-| `BRIDGE_HOST`         | `127.0.0.1`         | Bridge WebSocket host            |
-| `BRIDGE_PORT`         | `18601`             | Primary bridge port              |
-| `BRIDGE_PORT_SCAN`    | `18601,49620-49629` | Port scan spec (comma/range)     |
-| `BRIDGE_TIMEOUT_MS`   | `15000`             | Bridge call timeout (ms)         |
-| `BRIDGE_HEARTBEAT_MS` | `10000`             | Heartbeat interval (ms)          |
-| `BRIDGE_TOKEN`        | `''`                | Session token for extension auth |
+| Variable                        | Default       | Description                               |
+| ------------------------------- | ------------- | ----------------------------------------- |
+| `BRIDGE_HOST`                   | `127.0.0.1`   | Bridge WebSocket host                     |
+| `BRIDGE_PORT`                   | `49620`       | Primary bridge port                       |
+| `BRIDGE_PORT_SCAN`              | `49620-49629` | Port scan spec (comma/range)              |
+| `BRIDGE_TIMEOUT_MS`             | `15000`       | Bridge call timeout (ms)                  |
+| `BRIDGE_HEARTBEAT_MS`           | `10000`       | Heartbeat interval (ms)                   |
+| `BRIDGE_RECONNECT_MAX_ATTEMPTS` | `0`           | Max reconnect attempts (`0` = infinite)   |
+| `BRIDGE_WAIT_FOR_EDA_MS`        | `30000`       | Wait for EasyEDA Pro on startup (ms)      |
+| `BRIDGE_MAX_PAYLOAD_SIZE`       | `1048576`     | Max bridge payload (bytes, default 1 MiB) |
+| `BRIDGE_TOKEN`                  | `''`          | Session token for extension auth          |
 
 ### Storage
 
-| Variable   | Default            | Description                                 |
-| ---------- | ------------------ | ------------------------------------------- |
-| `DATA_DIR` | `.easyeda-mcp-pro` | Data directory (cache, database, artifacts) |
+| Variable       | Default                                   | Description                                 |
+| -------------- | ----------------------------------------- | ------------------------------------------- |
+| `DATA_DIR`     | `.easyeda-mcp-pro`                        | Data directory (cache, database, artifacts) |
+| `SQLITE_PATH`  | `.easyeda-mcp-pro/easyeda-mcp-pro.sqlite` | SQLite database path                        |
+| `ARTIFACT_DIR` | `.easyeda-mcp-pro/artifacts`              | Artifact export directory                   |
+| `CACHE_DIR`    | `.easyeda-mcp-pro/cache`                  | Cache directory                             |
 
 ### Supplier integration
 
@@ -139,10 +409,14 @@ Enable suppliers by setting their credentials. All suppliers are disabled by def
 
 Configure an AI provider for LLM-assisted design review:
 
-| Variable      | Default | Description                                     |
-| ------------- | ------- | ----------------------------------------------- |
-| `AI_PROVIDER` | `none`  | `anthropic`, `openai`, `openrouter`, or `local` |
-| `AI_MODEL`    | `''`    | Model name                                      |
+| Variable                    | Default | Description                                     |
+| --------------------------- | ------- | ----------------------------------------------- |
+| `AI_PROVIDER`               | `none`  | `anthropic`, `openai`, `openrouter`, or `local` |
+| `AI_MODEL`                  | `''`    | Model name (e.g., `claude-sonnet-4-20250514`)   |
+| `AI_API_KEY`                | `''`    | AI provider API key                             |
+| `AI_MAX_TOKENS`             | `8000`  | Max tokens per AI response                      |
+| `AI_TIMEOUT_MS`             | `60000` | AI request timeout in ms                        |
+| `AI_ALLOW_DESIGN_MUTATIONS` | `false` | Allow AI to modify schematic/board designs      |
 
 ### HTTP transport
 
@@ -152,6 +426,7 @@ When using `TRANSPORT=http`:
 | --------------------- | ----------- | ----------------------------------------- |
 | `HTTP_HOST`           | `127.0.0.1` | Bind address (use `0.0.0.0` with caution) |
 | `HTTP_PORT`           | `3000`      | Port                                      |
+| `HTTP_AUTH_DISABLED`  | `false`     | Disable HTTP transport authentication     |
 | `HTTP_RATE_LIMIT_MAX` | `100`       | Max requests per minute per IP            |
 | `CORS_ORIGIN`         | `''`        | Allowed CORS origin                       |
 
@@ -183,7 +458,7 @@ See `.env.example` for the complete list of configuration variables.
 
 ## MCP Tools
 
-The server currently registers 34 tools. Tools are filtered by the active `TOOL_PROFILE`: `core` exposes the normal workflow tools, `pro` adds manufacturing exports, `full` adds controlled documented EasyEDA API calls, and `dev` adds runtime probes for debugging.
+The server currently registers 41 tools. Tools are filtered by the active `TOOL_PROFILE`: `core` exposes the normal workflow tools, `pro` adds manufacturing exports, `full` adds controlled documented EasyEDA API calls, and `dev` adds runtime probes for debugging.
 
 ### L0 — Diagnostics (core)
 
@@ -279,7 +554,7 @@ The schematic write APIs use EasyEDA Pro extension APIs that EasyEDA currently m
 │  (via Plugin)    │     Protocol      │  └───────────────┘  │
 └─────────────────┘                    │  ┌───────────────┐  │
                                        │  │  ToolRegistry  │  │
-                                       │  │  (34 tools)   │  │
+                                       │  │  (41 tools)   │  │
                                        │  └───────────────┘  │
                                        │  ┌───────────────┐  │
                                        │  │    Storage     │──┼──► SQLite
@@ -314,20 +589,34 @@ Installation: Open EasyEDA Pro → **Settings** → **Extensions** → **Extensi
 
 ## Development
 
+### Prerequisites
+
+- **Node.js** >=24 <27
+- **pnpm** >=11
+- **Go Task** (optional, for Taskfile commands)
+
+### Quick Start
+
 ```bash
 # Setup
 pnpm install
 cp .env.example .env
 
-# Code quality
+# All quality gates (lint + format + typecheck + test + build)
+task verify
+
+# Or use pnpm directly:
 pnpm format:check          # Prettier
 pnpm typecheck             # TypeScript
 pnpm lint                  # ESLint
 
 # Test
-pnpm test                  # Vitest (97 tests across 13 files)
+pnpm test                  # Vitest (120+ tests across 18+ files)
 pnpm test:coverage         # With coverage report
 
+# Golden E2E fixture smoke tests are included in `pnpm test`
+# See docs/golden-fixtures.md for fixture architecture
+
 # Build & run
 pnpm build                 # tsc -> dist/
 pnpm build:extension       # Bundle EasyEDA Pro extension
@@ -339,6 +628,22 @@ pnpm start                 # Run compiled build
 pnpm inspector
 ```
 
+### Available Taskfile Commands
+
+This project includes a `Taskfile.yml` with the following commands:
+
+| Command          | Description                     |
+| ---------------- | ------------------------------- |
+| `task install`   | Install dependencies            |
+| `task lint`      | Run ESLint                      |
+| `task format`    | Check formatting with Prettier  |
+| `task typecheck` | Run TypeScript type checking    |
+| `task test`      | Run tests                       |
+| `task build`     | Build the project               |
+| `task verify`    | Run all quality gates (CI gate) |
+
+Install [Go Task](https://taskfile.dev/installation/) to use these commands.
+
 ### Project structure
 
 ```
@@ -354,7 +659,7 @@ src/
 │   └── transports/
 │       └── http.ts          # HTTP/Streamable HTTP transport
 ├── storage/                 # Node.js sqlite storage (cache, artifacts)
-├── tools/                   # 34 MCP tool definitions (6 groups)
+├── tools/                   # 41 MCP tool definitions (6 groups)
 │   ├── register.ts, registry.ts, types.ts
 │   ├── L0_diagnostics.ts, L1_schematic.ts, L1_bom.ts
 │   ├── L1_drc_erc.ts, L1_board.ts, L1_export.ts
@@ -368,12 +673,14 @@ easyeda-bridge-extension/    # EasyEDA Pro bridge extension workspace package
 
 ## Security
 
+See [Security Architecture & Threat Model](docs/security-architecture.md) for the complete security reference, including deployment modes, authentication, tool safety controls, secrets management, safe defaults, supplier API security, threat scenarios, and deployment checklists.
+
 - **Production safety**: Validates config at startup — rejects non-loopback HTTP without OAuth, blocks dangerous features in production
-- **OAuth/JWKS**: Optional Bearer token validation via JWKS endpoint for HTTP transport
+- **OAuth/JWKS**: Bearer token validation via JWKS endpoint for HTTP transport (see [OAuth section](docs/security-architecture.md#21-oauth-20--openid-connect-http-transport))
 - **Rate limiting**: Per-IP sliding window rate limiter on HTTP transport (default 100 req/min)
 - **Path traversal protection**: All file export paths validated against `ARTIFACT_DIR`
 - **Secret redaction**: API keys, tokens, passwords are redacted from logs and diagnostic output
-- **Branch protection**: `main` branch requires review and up-to-date status checks
+- **Branch protection**: Governance policy requires code reviews and status checks on the `main` branch (see [Repository Governance](docs/REPOSITORY_GOVERNANCE.md))
 - **Code scanning**: CodeQL analysis runs on every push and PR (security-extended + security-and-quality queries)
 - **Dependency management**: Renovate automatically updates dependencies with security patches
 - **Supply-chain hygiene**: pnpm workspace build, pinned GitHub Actions, and no native SQLite addon dependency
@@ -381,6 +688,16 @@ easyeda-bridge-extension/    # EasyEDA Pro bridge extension workspace package
 
 ---
 
+## Release & Dependency Automation
+
+This repository uses automated workflows to manage dependencies and releases:
+
+- **Renovate**: Automatically scans and updates dependencies based on rules configured in [.github/renovate.json](.github/renovate.json). For details on PR policies and automerging, see [Repository Governance](docs/REPOSITORY_GOVERNANCE.md).
+- **Release Please**: Automatically bumps package versions, updates files (like `package.json`, `server.json`, `extension.json`), and generates `CHANGELOG.md` upon merging Release PRs. For the full release procedure and Conventional Commit conventions, see [Release Process](docs/RELEASE_PROCESS.md).
+- **Secure Publishing**: The release workflow builds all assets (including `easyeda-bridge-extension.eext`), publishes to the NPM registry with cryptographic provenance, and uploads assets directly to the GitHub release.
+
+---
+
 ## License
 
 [MIT](LICENSE)

package/dist/bom-quality/adapter.d.ts

@@ -0,0 +1,90 @@
+/**
+ * BOM quality — supplier adapter layer.
+ *
+ * Provides a common {@link SupplierAdapter} interface over each vendor
+ * client so quality checks can query any configured supplier uniformly.
+ *
+ * Each adapter:
+ *  - normalises part data into {@link SupplierQueryResult}
+ *  - records a query timestamp for provenance
+ *  - wraps transient errors with an exponential-backoff retry
+ *
+ * @module
+ */
+import { type LcscClient } from '../vendors/lcsc/client.js';
+import { type MouserClient } from '../vendors/mouser/client.js';
+import { type DigiKeyClient } from '../vendors/digikey/client.js';
+import type { SupplierKind, SupplierQueryResult } from './types.js';
+export interface SupplierAdapter {
+    /** Short supplier key (e.g. 'lcsc', 'mouser'). */
+    readonly kind: SupplierKind;
+    /** Human-readable supplier name. */
+    readonly displayName: string;
+    /** Whether this supplier is configured and available. */
+    isAvailable(): boolean;
+    /**
+     * Query a part by LCSC code or manufacturer part number.
+     * Returns `null` when the part is not found (not an error).
+     */
+    queryPart(identifier: {
+        lcsc?: string;
+        mpn?: string;
+    }): Promise<SupplierQueryResult | null>;
+}
+export declare class LcscAdapter implements SupplierAdapter {
+    readonly kind: SupplierKind;
+    readonly displayName = "LCSC";
+    private client;
+    private logger;
+    constructor(client: LcscClient | null);
+    isAvailable(): boolean;
+    private buildFoundResult;
+    queryPart(identifier: {
+        lcsc?: string;
+        mpn?: string;
+    }): Promise<SupplierQueryResult | null>;
+}
+export declare class MouserAdapter implements SupplierAdapter {
+    readonly kind: SupplierKind;
+    readonly displayName = "Mouser";
+    private client;
+    private logger;
+    constructor(client: MouserClient | null);
+    isAvailable(): boolean;
+    private buildFoundResult;
+    queryPart(identifier: {
+        lcsc?: string;
+        mpn?: string;
+    }): Promise<SupplierQueryResult | null>;
+}
+export declare class DigiKeyAdapter implements SupplierAdapter {
+    readonly kind: SupplierKind;
+    readonly displayName = "DigiKey";
+    private client;
+    private logger;
+    constructor(client: DigiKeyClient | null);
+    isAvailable(): boolean;
+    private buildFoundResult;
+    queryPart(identifier: {
+        lcsc?: string;
+        mpn?: string;
+    }): Promise<SupplierQueryResult | null>;
+}
+export interface AdapterMap {
+    lcsc: LcscAdapter;
+    mouser: MouserAdapter;
+    digikey: DigiKeyAdapter;
+}
+/**
+ * Build the adapter map from a ToolContext vendors object.
+ * Each adapter wraps the corresponding vendor client (or null if disabled).
+ */
+export declare function createAdapters(vendors: {
+    lcsc: LcscClient | null;
+    mouser: MouserClient | null;
+    digikey: DigiKeyClient | null;
+}): AdapterMap;
+/**
+ * Return the subset of adapters that are currently configured / available.
+ */
+export declare function availableAdapters(adapters: AdapterMap): SupplierAdapter[];