easyeda-mcp-pro 0.2.0

package/dist/bridge/manager.js

@@ -0,0 +1,225 @@
+import { EventEmitter } from 'node:events';
+import { getLogger } from '../utils/logger.js';
+import { BridgeHelloSchema } from './protocol.js';
+export class BridgeManager extends EventEmitter {
+    state = 'disconnected';
+    hello = null;
+    ws = null;
+    heartbeatTimer = null;
+    reconnectTimer = null;
+    requestMap = new Map();
+    requestIdCounter = 0;
+    config;
+    _lastHeartbeatMs = 0;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    get lastHeartbeatMs() {
+        return this._lastHeartbeatMs;
+    }
+    get connected() {
+        return this.state === 'connected';
+    }
+    async connect() {
+        if (this.state === 'connected' || this.state === 'connecting')
+            return;
+        const prev = this.state;
+        this.state = 'connecting';
+        this.emit('stateChanged', this.state, prev);
+        const ports = this.parsePortScan();
+        const logger = getLogger();
+        for (const port of ports) {
+            try {
+                await this.tryConnect(port);
+                if (this.state === 'connected')
+                    return;
+            }
+            catch {
+                logger.debug({ port }, 'bridge connection attempt failed');
+            }
+        }
+        const prevState = this.state;
+        this.state = 'disconnected';
+        this.emit('stateChanged', this.state, prevState);
+        logger.warn('no bridge found on any scanned port');
+    }
+    async call(method, params, opts) {
+        const ws = this.ws;
+        if (this.state !== 'connected' || !ws) {
+            throw new Error(`Bridge not connected. Cannot call method "${method}".`);
+        }
+        const id = `req_${++this.requestIdCounter}`;
+        const timeoutMs = opts?.timeoutMs ?? this.config.BRIDGE_TIMEOUT_MS;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.requestMap.delete(id);
+                reject(new Error(`Bridge method "${method}" timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.requestMap.set(id, {
+                resolve: resolve,
+                reject,
+                timer,
+                method,
+            });
+            const message = JSON.stringify({
+                id,
+                type: 'request',
+                method,
+                params,
+                timeoutMs,
+                traceparent: opts?.traceparent,
+            });
+            ws.send(message);
+        });
+    }
+    disconnect(reason) {
+        const prev = this.state;
+        this.state = 'disconnected';
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        for (const [, entry] of this.requestMap) {
+            clearTimeout(entry.timer);
+            entry.reject(new Error(`Bridge disconnected: ${reason ?? 'unknown'}`));
+        }
+        this.requestMap.clear();
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this.hello = null;
+        this.emit('stateChanged', this.state, prev);
+        this.emit('disconnected', reason ?? 'unknown');
+    }
+    async tryConnect(port) {
+        const logger = getLogger();
+        const url = `ws://${this.config.BRIDGE_HOST}:${port}`;
+        logger.debug({ url }, 'trying bridge connection');
+        return new Promise((resolve, reject) => {
+            const ws = new WebSocket(url);
+            const timeout = setTimeout(() => {
+                ws.close();
+                reject(new Error(`Connection timeout for ${url}`));
+            }, 5000);
+            ws.onopen = () => {
+                clearTimeout(timeout);
+                this.ws = ws;
+                this.sendHandshake();
+            };
+            ws.onmessage = (event) => {
+                try {
+                    const data = JSON.parse(event.data);
+                    if (data.type === 'hello') {
+                        const parsed = BridgeHelloSchema.parse(data);
+                        this.handleHello(parsed, port);
+                        resolve();
+                    }
+                    else if (data.type === 'response') {
+                        this.handleResponse(data);
+                    }
+                    else if (data.type === 'heartbeat') {
+                        this._lastHeartbeatMs = Date.now();
+                    }
+                    else if (data.type === 'error') {
+                        logger.error({ data }, 'bridge error message');
+                    }
+                }
+                catch (err) {
+                    logger.error({ err, raw: event.data }, 'bridge message parse error');
+                }
+            };
+            ws.onerror = (err) => {
+                clearTimeout(timeout);
+                reject(err instanceof Error ? err : new Error('WebSocket error'));
+            };
+            ws.onclose = () => {
+                clearTimeout(timeout);
+                if (this.state === 'connected') {
+                    this.disconnect('connection closed');
+                }
+            };
+        });
+    }
+    sendHandshake() {
+        const handshake = {
+            type: 'handshake',
+            protocol: 'easyeda-mcp-pro.bridge',
+            protocolVersion: '1.0.0',
+            clientName: 'easyeda-mcp-pro',
+            sessionToken: this.config.BRIDGE_TOKEN || undefined,
+        };
+        this.ws?.send(JSON.stringify(handshake));
+    }
+    handleHello(hello, port) {
+        const logger = getLogger();
+        const prev = this.state;
+        this.state = 'connected';
+        this.hello = hello;
+        logger.info({
+            bridgeVersion: hello.bridgeVersion,
+            easyedaVersion: hello.easyedaVersion,
+            capabilities: hello.capabilities,
+            port,
+        }, 'bridge connected');
+        this.emit('stateChanged', this.state, prev);
+        this.emit('connected', hello);
+        this.startHeartbeat();
+    }
+    handleResponse(data) {
+        const entry = this.requestMap.get(data.id);
+        if (!entry) {
+            getLogger().warn({ requestId: data.id }, 'received response for unknown request');
+            return;
+        }
+        clearTimeout(entry.timer);
+        this.requestMap.delete(data.id);
+        if (data.ok) {
+            entry.resolve(data.result);
+        }
+        else {
+            const error = new Error(data.error?.message ?? `Bridge method "${entry.method}" failed`);
+            entry.reject(error);
+        }
+    }
+    startHeartbeat() {
+        if (this.heartbeatTimer)
+            clearInterval(this.heartbeatTimer);
+        this.heartbeatTimer = setInterval(() => {
+            if (this.ws && this.state === 'connected') {
+                try {
+                    this.ws.send(JSON.stringify({ type: 'heartbeat', timestamp: Date.now() }));
+                }
+                catch {
+                    this.disconnect('heartbeat failed');
+                }
+            }
+        }, this.config.BRIDGE_HEARTBEAT_MS);
+    }
+    parsePortScan() {
+        const ports = [];
+        const parts = this.config.BRIDGE_PORT_SCAN.split(',');
+        for (const part of parts) {
+            const trimmed = part.trim();
+            if (trimmed.includes('-')) {
+                const [start, end] = trimmed.split('-').map((s) => parseInt(s.trim(), 10));
+                if (start && end && !isNaN(start) && !isNaN(end)) {
+                    for (let p = start; p <= end; p++)
+                        ports.push(p);
+                }
+            }
+            else {
+                const p = parseInt(trimmed, 10);
+                if (!isNaN(p))
+                    ports.push(p);
+            }
+        }
+        return [...new Set(ports)].sort((a, b) => a - b);
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/bridge/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/bridge/manager.ts"],"names":[],"mappings":"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"}

package/dist/bridge/protocol.d.ts

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+export declare const BridgeHandshakeSchema: z.ZodObject<{
+    type: z.ZodLiteral<"handshake">;
+    protocol: z.ZodLiteral<"easyeda-mcp-pro.bridge">;
+    protocolVersion: z.ZodLiteral<"1.0.0">;
+    clientName: z.ZodLiteral<"easyeda-mcp-pro">;
+    sessionToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const BridgeHelloSchema: z.ZodObject<{
+    type: z.ZodLiteral<"hello">;
+    bridgeVersion: z.ZodString;
+    easyedaVersion: z.ZodOptional<z.ZodString>;
+    apiVersion: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodArray<z.ZodString>;
+    methodRegistryHash: z.ZodString;
+    devMode: z.ZodBoolean;
+}, z.core.$strip>;
+export declare const BridgeRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"request">;
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodUnknown>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    traceparent: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const BridgeResponseSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"response">;
+    ok: z.ZodBoolean;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodEnum<{
+            BRIDGE_NOT_READY: "BRIDGE_NOT_READY";
+            METHOD_NOT_ALLOWED: "METHOD_NOT_ALLOWED";
+            METHOD_NOT_FOUND: "METHOD_NOT_FOUND";
+            EASYEDA_API_ERROR: "EASYEDA_API_ERROR";
+            TIMEOUT: "TIMEOUT";
+            INVALID_PARAMS: "INVALID_PARAMS";
+            UNAUTHORIZED: "UNAUTHORIZED";
+            DEV_MODE_REQUIRED: "DEV_MODE_REQUIRED";
+            UNKNOWN: "UNKNOWN";
+        }>;
+        message: z.ZodString;
+        suggestion: z.ZodString;
+        data: z.ZodOptional<z.ZodUnknown>;
+        easyedaVersion: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    durationMs: z.ZodNumber;
+}, z.core.$strip>;
+export declare const BridgeHeartbeatSchema: z.ZodObject<{
+    type: z.ZodLiteral<"heartbeat">;
+    timestamp: z.ZodNumber;
+}, z.core.$strip>;
+export type BridgeHandshake = z.infer<typeof BridgeHandshakeSchema>;
+export type BridgeHello = z.infer<typeof BridgeHelloSchema>;
+export type BridgeRequest<TParams = unknown> = Omit<z.infer<typeof BridgeRequestSchema>, 'params'> & {
+    params?: TParams;
+};
+export type BridgeResponse<TResult = unknown> = Omit<z.infer<typeof BridgeResponseSchema>, 'result' | 'error'> & {
+    result?: TResult;
+    error?: {
+        code: string;
+        message: string;
+        suggestion: string;
+        data?: unknown;
+        easyedaVersion?: string;
+    };
+};

package/dist/bridge/protocol.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+export const BridgeHandshakeSchema = z.object({
+    type: z.literal('handshake'),
+    protocol: z.literal('easyeda-mcp-pro.bridge'),
+    protocolVersion: z.literal('1.0.0'),
+    clientName: z.literal('easyeda-mcp-pro'),
+    sessionToken: z.string().optional(),
+});
+export const BridgeHelloSchema = z.object({
+    type: z.literal('hello'),
+    bridgeVersion: z.string(),
+    easyedaVersion: z.string().optional(),
+    apiVersion: z.string().optional(),
+    capabilities: z.array(z.string()),
+    methodRegistryHash: z.string(),
+    devMode: z.boolean(),
+});
+export const BridgeRequestSchema = z.object({
+    id: z.string(),
+    type: z.literal('request'),
+    method: z.string(),
+    params: z.unknown().optional(),
+    timeoutMs: z.number().int().optional(),
+    traceparent: z.string().optional(),
+});
+export const BridgeResponseSchema = z.object({
+    id: z.string(),
+    type: z.literal('response'),
+    ok: z.boolean(),
+    result: z.unknown().optional(),
+    error: z
+        .object({
+        code: z.enum([
+            'BRIDGE_NOT_READY',
+            'METHOD_NOT_ALLOWED',
+            'METHOD_NOT_FOUND',
+            'EASYEDA_API_ERROR',
+            'TIMEOUT',
+            'INVALID_PARAMS',
+            'UNAUTHORIZED',
+            'DEV_MODE_REQUIRED',
+            'UNKNOWN',
+        ]),
+        message: z.string(),
+        suggestion: z.string(),
+        data: z.unknown().optional(),
+        easyedaVersion: z.string().optional(),
+    })
+        .optional(),
+    durationMs: z.number(),
+});
+export const BridgeHeartbeatSchema = z.object({
+    type: z.literal('heartbeat'),
+    timestamp: z.number(),
+});
+//# sourceMappingURL=protocol.js.map

package/dist/bridge/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/bridge/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC;IAC7C,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACnC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;IACxC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACxB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACf,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC;SACL,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;YACX,kBAAkB;YAClB,oBAAoB;YACpB,kBAAkB;YAClB,mBAAmB;YACnB,SAAS;YACT,gBAAgB;YAChB,cAAc;YACd,mBAAmB;YACnB,SAAS;SACV,CAAC;QACF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;QACtB,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QAC5B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACtC,CAAC;SACD,QAAQ,EAAE;IACb,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC"}

package/dist/bridge/types.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+export declare const EasyedaApiMethodSchema: z.ZodEnum<{
+    "schematic.listNets": "schematic.listNets";
+    "schematic.listComponents": "schematic.listComponents";
+    "bom.generate": "bom.generate";
+    "bom.validate": "bom.validate";
+    "inventory.search": "inventory.search";
+    "design.drc": "design.drc";
+    "design.erc": "design.erc";
+    "board.listLayers": "board.listLayers";
+    "board.getStackup": "board.getStackup";
+    "board.exportGerbers": "board.exportGerbers";
+    "project.export": "project.export";
+    "project.open": "project.open";
+    "project.save": "project.save";
+    "inventory.getPrice": "inventory.getPrice";
+    "design.ruleCheck": "design.ruleCheck";
+}>;
+export type EasyedaApiMethod = z.infer<typeof EasyedaApiMethodSchema>;
+export interface BridgeCallOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export interface BridgeCallResult<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface EasyedaProjectInfo {
+    id: string;
+    name: string;
+    path: string;
+    modifiedAt: string;
+}
+export interface EasyedaSchematicNet {
+    netName: string;
+    nodes: Array<{
+        component: string;
+        pin: string;
+    }>;
+}
+export interface EasyedaComponent {
+    reference: string;
+    value: string;
+    footprint: string;
+    lcsc?: string;
+    manufacturer?: string;
+    datasheet?: string;
+}

package/dist/bridge/types.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export const EasyedaApiMethodSchema = z.enum([
+    'project.open',
+    'project.save',
+    'project.export',
+    'schematic.listNets',
+    'schematic.listComponents',
+    'board.listLayers',
+    'board.getStackup',
+    'board.exportGerbers',
+    'bom.generate',
+    'bom.validate',
+    'inventory.search',
+    'inventory.getPrice',
+    'design.ruleCheck',
+    'design.erc',
+    'design.drc',
+]);
+//# sourceMappingURL=types.js.map

package/dist/bridge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bridge/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,oBAAoB;IACpB,0BAA0B;IAC1B,kBAAkB;IAClB,kBAAkB;IAClB,qBAAqB;IACrB,cAAc;IACd,cAAc;IACd,kBAAkB;IAClB,oBAAoB;IACpB,kBAAkB;IAClB,YAAY;IACZ,YAAY;CACb,CAAC,CAAC"}

package/dist/config/env.d.ts

@@ -0,0 +1,98 @@
+import { z } from 'zod';
+export declare const EnvSchema: z.ZodObject<{
+    NODE_ENV: z.ZodDefault<z.ZodEnum<{
+        development: "development";
+        test: "test";
+        production: "production";
+    }>>;
+    LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+        trace: "trace";
+        debug: "debug";
+        info: "info";
+        warn: "warn";
+        error: "error";
+        fatal: "fatal";
+        silent: "silent";
+    }>>;
+    TOOL_PROFILE: z.ZodDefault<z.ZodEnum<{
+        core: "core";
+        pro: "pro";
+        full: "full";
+        dev: "dev";
+        experimental: "experimental";
+    }>>;
+    MCP_PROTOCOL_VERSION: z.ZodDefault<z.ZodString>;
+    TRANSPORT: z.ZodDefault<z.ZodEnum<{
+        stdio: "stdio";
+        http: "http";
+    }>>;
+    HTTP_HOST: z.ZodDefault<z.ZodString>;
+    HTTP_PORT: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    HTTP_AUTH_DISABLED: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    CORS_ORIGIN: z.ZodDefault<z.ZodString>;
+    MCP_TASKS_ENABLED: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    MCP_APPS_ENABLED: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    MCP_V2_EXPERIMENTAL: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    BRIDGE_HOST: z.ZodDefault<z.ZodString>;
+    BRIDGE_PORT: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    BRIDGE_PORT_SCAN: z.ZodDefault<z.ZodString>;
+    BRIDGE_TIMEOUT_MS: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    BRIDGE_HEARTBEAT_MS: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    BRIDGE_RECONNECT_INTERVAL_MS: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    BRIDGE_TOKEN: z.ZodDefault<z.ZodString>;
+    EASYEDA_DEV_BRIDGE: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    BRIDGE_RAW_EXEC_ENABLED: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    DATA_DIR: z.ZodDefault<z.ZodString>;
+    SQLITE_PATH: z.ZodDefault<z.ZodString>;
+    ARTIFACT_DIR: z.ZodDefault<z.ZodString>;
+    CACHE_DIR: z.ZodDefault<z.ZodString>;
+    AI_PROVIDER: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        anthropic: "anthropic";
+        openai: "openai";
+        openrouter: "openrouter";
+        local: "local";
+    }>>;
+    AI_MODEL: z.ZodDefault<z.ZodString>;
+    AI_API_KEY: z.ZodDefault<z.ZodString>;
+    AI_MAX_TOKENS: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    AI_TIMEOUT_MS: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    AI_ALLOW_DESIGN_MUTATIONS: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    JLCPCB_MODE: z.ZodDefault<z.ZodEnum<{
+        disabled: "disabled";
+        mock: "mock";
+        approved_api: "approved_api";
+    }>>;
+    JLCPCB_CLIENT_ID: z.ZodDefault<z.ZodString>;
+    JLCPCB_CLIENT_SECRET: z.ZodDefault<z.ZodString>;
+    JLCPCB_API_BASE_URL: z.ZodDefault<z.ZodString>;
+    JLCPCB_ENABLE_ORDERING: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    JLCPCB_DEFAULT_CURRENCY: z.ZodDefault<z.ZodEnum<{
+        USD: "USD";
+        CNY: "CNY";
+    }>>;
+    JLCSEARCH_ENABLED: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    JLCSEARCH_BASE_URL: z.ZodDefault<z.ZodString>;
+    LCSC_API_KEY: z.ZodDefault<z.ZodString>;
+    LCSC_API_SECRET: z.ZodDefault<z.ZodString>;
+    MOUSER_ENABLED: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    MOUSER_API_KEY: z.ZodDefault<z.ZodString>;
+    MOUSER_API_BASE_URL: z.ZodDefault<z.ZodString>;
+    DIGIKEY_ENABLED: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    DIGIKEY_CLIENT_ID: z.ZodDefault<z.ZodString>;
+    DIGIKEY_CLIENT_SECRET: z.ZodDefault<z.ZodString>;
+    DIGIKEY_SANDBOX: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    DIGIKEY_LOCALE: z.ZodDefault<z.ZodString>;
+    DIGIKEY_CURRENCY: z.ZodDefault<z.ZodString>;
+    OAUTH_ENABLED: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    OAUTH_ISSUER: z.ZodDefault<z.ZodString>;
+    OAUTH_AUDIENCE: z.ZodDefault<z.ZodString>;
+    OAUTH_JWKS_URI: z.ZodDefault<z.ZodString>;
+    OAUTH_REQUIRED_SCOPES: z.ZodDefault<z.ZodString>;
+    OTEL_ENABLED: z.ZodDefault<z.ZodPreprocess<z.ZodBoolean>>;
+    OTEL_SERVICE_NAME: z.ZodDefault<z.ZodString>;
+    OTEL_EXPORTER_OTLP_ENDPOINT: z.ZodDefault<z.ZodString>;
+    TRACE_SAMPLE_RATE: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type EnvConfig = z.infer<typeof EnvSchema>;
+export declare function loadEnvConfig(): EnvConfig;

package/dist/config/env.js

@@ -0,0 +1,103 @@
+import { z } from 'zod';
+function envBoolean() {
+    return z.preprocess((val) => {
+        if (typeof val === 'string') {
+            const lower = val.toLowerCase().trim();
+            if (lower === 'false' || lower === '0' || lower === '')
+                return false;
+            return true;
+        }
+        return val;
+    }, z.boolean());
+}
+export const EnvSchema = z.object({
+    NODE_ENV: z.enum(['development', 'test', 'production']).default('development'),
+    LOG_LEVEL: z.enum(['trace', 'debug', 'info', 'warn', 'error', 'fatal', 'silent']).default('info'),
+    TOOL_PROFILE: z.enum(['core', 'pro', 'full', 'dev', 'experimental']).default('core'),
+    MCP_PROTOCOL_VERSION: z.string().default('2025-11-25'),
+    TRANSPORT: z.enum(['stdio', 'http']).default('stdio'),
+    HTTP_HOST: z.string().default('127.0.0.1'),
+    HTTP_PORT: z.coerce.number().int().min(1).max(65535).default(3000),
+    HTTP_AUTH_DISABLED: envBoolean().default(false),
+    CORS_ORIGIN: z.string().default(''),
+    MCP_TASKS_ENABLED: envBoolean().default(false),
+    MCP_APPS_ENABLED: envBoolean().default(false),
+    MCP_V2_EXPERIMENTAL: envBoolean().default(false),
+    BRIDGE_HOST: z.string().default('127.0.0.1'),
+    BRIDGE_PORT: z.coerce.number().int().min(1).max(65535).default(18601),
+    BRIDGE_PORT_SCAN: z.string().default('18601,49620-49629'),
+    BRIDGE_TIMEOUT_MS: z.coerce.number().int().min(1000).max(120000).default(15000),
+    BRIDGE_HEARTBEAT_MS: z.coerce.number().int().min(1000).max(60000).default(10000),
+    BRIDGE_RECONNECT_INTERVAL_MS: z.coerce.number().int().min(1000).max(30000).default(3000),
+    BRIDGE_TOKEN: z.string().default(''),
+    EASYEDA_DEV_BRIDGE: envBoolean().default(false),
+    BRIDGE_RAW_EXEC_ENABLED: envBoolean().default(false),
+    DATA_DIR: z.string().default('.easyeda-mcp-pro'),
+    SQLITE_PATH: z.string().default('.easyeda-mcp-pro/easyeda-mcp-pro.sqlite'),
+    ARTIFACT_DIR: z.string().default('.easyeda-mcp-pro/artifacts'),
+    CACHE_DIR: z.string().default('.easyeda-mcp-pro/cache'),
+    AI_PROVIDER: z.enum(['none', 'anthropic', 'openai', 'openrouter', 'local']).default('none'),
+    AI_MODEL: z.string().default(''),
+    AI_API_KEY: z.string().default(''),
+    AI_MAX_TOKENS: z.coerce.number().int().min(1).max(128000).default(8000),
+    AI_TIMEOUT_MS: z.coerce.number().int().min(1000).max(300000).default(60000),
+    AI_ALLOW_DESIGN_MUTATIONS: envBoolean().default(false),
+    JLCPCB_MODE: z.enum(['disabled', 'mock', 'approved_api']).default('disabled'),
+    JLCPCB_CLIENT_ID: z.string().default(''),
+    JLCPCB_CLIENT_SECRET: z.string().default(''),
+    JLCPCB_API_BASE_URL: z.string().default('https://api.jlcpcb.com'),
+    JLCPCB_ENABLE_ORDERING: envBoolean().default(false),
+    JLCPCB_DEFAULT_CURRENCY: z.enum(['USD', 'CNY']).default('USD'),
+    JLCSEARCH_ENABLED: envBoolean().default(true),
+    JLCSEARCH_BASE_URL: z.string().default('https://jlcsearch.tscircuit.com'),
+    LCSC_API_KEY: z.string().default(''),
+    LCSC_API_SECRET: z.string().default(''),
+    MOUSER_ENABLED: envBoolean().default(false),
+    MOUSER_API_KEY: z.string().default(''),
+    MOUSER_API_BASE_URL: z.string().default('https://api.mouser.com'),
+    DIGIKEY_ENABLED: envBoolean().default(false),
+    DIGIKEY_CLIENT_ID: z.string().default(''),
+    DIGIKEY_CLIENT_SECRET: z.string().default(''),
+    DIGIKEY_SANDBOX: envBoolean().default(true),
+    DIGIKEY_LOCALE: z.string().default('en-US'),
+    DIGIKEY_CURRENCY: z.string().default('USD'),
+    OAUTH_ENABLED: envBoolean().default(false),
+    OAUTH_ISSUER: z.string().default(''),
+    OAUTH_AUDIENCE: z.string().default('easyeda-mcp-pro'),
+    OAUTH_JWKS_URI: z.string().default(''),
+    OAUTH_REQUIRED_SCOPES: z.string().default('easyeda:read'),
+    OTEL_ENABLED: envBoolean().default(false),
+    OTEL_SERVICE_NAME: z.string().default('easyeda-mcp-pro'),
+    OTEL_EXPORTER_OTLP_ENDPOINT: z.string().default(''),
+    TRACE_SAMPLE_RATE: z.coerce.number().min(0).max(1).default(1.0),
+});
+export function loadEnvConfig() {
+    const result = EnvSchema.safeParse(process.env);
+    if (!result.success) {
+        console.error('Config validation failed:');
+        for (const issue of result.error.issues) {
+            console.error(`  - ${issue.path.join('.')}: ${issue.message}`);
+        }
+        process.exit(1);
+    }
+    validateSafeConfig(result.data);
+    return result.data;
+}
+function validateSafeConfig(config) {
+    if (config.NODE_ENV === 'production') {
+        if (config.HTTP_HOST !== '127.0.0.1' && !config.OAUTH_ENABLED) {
+            console.error('SAFETY: HTTP_HOST is not localhost but OAUTH_ENABLED is false. ' +
+                'Set OAUTH_ENABLED=true or use HTTP_HOST=127.0.0.1.');
+            process.exit(1);
+        }
+        if (config.BRIDGE_RAW_EXEC_ENABLED) {
+            console.error('SAFETY: BRIDGE_RAW_EXEC_ENABLED=true is not allowed in production mode.');
+            process.exit(1);
+        }
+        if (config.JLCPCB_ENABLE_ORDERING && config.JLCPCB_MODE !== 'approved_api') {
+            console.error('SAFETY: JLCPCB_ENABLE_ORDERING=true requires JLCPCB_MODE=approved_api.');
+            process.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=env.js.map

package/dist/config/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/config/env.ts"],"names":[],"mappings":"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"}