easyeda-mcp-pro 0.18.0 → 0.20.0

package/dist/circuit/component-planning.js

@@ -0,0 +1,140 @@
+/**
+ * Component role and refdes planning for CircuitIR device synthesis.
+ *
+ * Replaces generic `U?` device stubs with a deterministic, traceable
+ * component-role plan: a refdes family, a package/footprint hint, and a
+ * planning-state marker that differentiates a confidently-classified
+ * candidate device from a low-confidence placeholder.
+ *
+ * This module intentionally does not select real MPNs, manufacturers, or
+ * footprints — it narrows the search space (role + refdes + package family)
+ * so a human, BOM-sourcing tool, or downstream planning step can make the
+ * final manufacturable selection. See docs/circuit-ir.md for the full
+ * synthesis pipeline this module is part of.
+ *
+ * @module
+ */
+import { BlockType } from './types.js';
+/** Deterministic refdes family per component role, matching common schematic convention. */
+export const ROLE_REFDES_PREFIX = {
+    'power-regulator': 'U',
+    'mcu-module': 'U',
+    sensor: 'U',
+    'communication-ic': 'U',
+    'analog-ic': 'U',
+    connector: 'J',
+    'protection-diode': 'D',
+    fuse: 'F',
+    'passive-support': 'C',
+    'generic-ic': 'U',
+};
+/** Conservative package/footprint family hint per role — not a final footprint selection. */
+export const ROLE_PACKAGE_HINT = {
+    'power-regulator': 'SOT-23-5 or TO-220 (select by current/thermal rating)',
+    'mcu-module': 'QFN/LQFP or module footprint (select by MCU family)',
+    sensor: 'Manufacturer-specific package (verify against the selected sensor datasheet)',
+    'communication-ic': 'SOIC/QFN (select by the selected transceiver/PHY datasheet)',
+    'analog-ic': 'SOIC/SOT package (select by the selected part datasheet)',
+    connector: 'THT or SMD connector footprint (select by mechanical/mating requirements)',
+    'protection-diode': 'SOD-123/SMA (select by clamping voltage and current rating)',
+    fuse: '0603/1206 SMD fuse or THT fuse holder (select by current rating)',
+    'passive-support': '0402/0603 SMD passive (select values during schematic entry)',
+    'generic-ic': 'TBD — insufficient design intent to suggest a package family',
+};
+/** Metadata keys the compiler attaches to each planned Device. */
+export const COMPONENT_PLAN_METADATA_KEYS = {
+    role: 'role',
+    packageHint: 'packageHint',
+    planningState: 'planningState',
+};
+/**
+ * Determine a component role for a Block from its `type` and free-text
+ * `description` (the compiled block's purpose). Keyword matches on the
+ * description take priority over the coarse `type` field because the
+ * DesignIntent functional-block `type` is intentionally low-resolution
+ * (e.g. "power-management" covers both regulators and passive filter
+ * stages).
+ */
+export function determineComponentRole(block) {
+    const text = `${block.type} ${block.description ?? ''}`.toLowerCase();
+    if (text.includes('connector') ||
+        text.includes('header') ||
+        text.includes('usb') ||
+        text.includes('jack')) {
+        return { role: 'connector', confidence: 'high' };
+    }
+    if (text.includes('fuse') || text.includes('polyfuse') || text.includes('ptc')) {
+        return { role: 'fuse', confidence: 'high' };
+    }
+    if (text.includes('filter') || text.includes('decoupl') || text.includes('bypass')) {
+        return { role: 'passive-support', confidence: 'high' };
+    }
+    switch (block.type) {
+        case BlockType.PowerManagement:
+            return { role: 'power-regulator', confidence: 'high' };
+        case BlockType.Microcontroller:
+            return { role: 'mcu-module', confidence: 'high' };
+        case BlockType.Sensor:
+            return { role: 'sensor', confidence: 'high' };
+        case BlockType.Communication:
+            return { role: 'communication-ic', confidence: 'high' };
+        case BlockType.Interface:
+            return { role: 'connector', confidence: 'high' };
+        case BlockType.Protection:
+            return { role: 'protection-diode', confidence: 'high' };
+        case BlockType.Analog:
+            return { role: 'analog-ic', confidence: 'high' };
+        default:
+            return { role: 'generic-ic', confidence: 'low' };
+    }
+}
+/**
+ * Plan one candidate Device per Block: a deterministic refdes, a component
+ * role, and a package-family hint, recorded as Device metadata alongside
+ * a `planningState` of `candidate` (role inferred with high confidence) or
+ * `placeholder` (role could not be determined; manual classification
+ * required).
+ *
+ * Refdes numbering is deterministic and stable across repeated compiles of
+ * the same DesignIntent, because it is derived solely from block order.
+ */
+export function planComponents(blocks) {
+    const refdesCounters = {};
+    const warnings = [];
+    const devices = blocks.map((block) => {
+        const plan = determineComponentRole({ type: block.type, description: block.description });
+        const prefix = ROLE_REFDES_PREFIX[plan.role];
+        refdesCounters[prefix] = (refdesCounters[prefix] ?? 0) + 1;
+        const ref = `${prefix}${refdesCounters[prefix]}`;
+        const planningState = plan.confidence === 'high' ? 'candidate' : 'placeholder';
+        if (planningState === 'placeholder') {
+            warnings.push(`Block "${block.name}" (${block.id}): insufficient design intent to determine a ` +
+                `component role; using a generic placeholder device (${ref}). Provide a more ` +
+                `specific block type or purpose to enable manufacturable candidate planning.`);
+        }
+        const device = {
+            id: `dev-${block.id}`,
+            ref,
+            mpn: undefined,
+            manufacturer: undefined,
+            package: undefined,
+            datasheet: '',
+            lcsc: undefined,
+            blockRef: block.id,
+            designIntentRef: block.designIntentRef,
+            metadata: [
+                { key: COMPONENT_PLAN_METADATA_KEYS.role, value: plan.role },
+                { key: COMPONENT_PLAN_METADATA_KEYS.packageHint, value: ROLE_PACKAGE_HINT[plan.role] },
+                { key: COMPONENT_PLAN_METADATA_KEYS.planningState, value: planningState },
+            ],
+        };
+        return device;
+    });
+    return { devices, warnings };
+}
+/** Read a Device's planned component role back out of its metadata, if present. */
+export function getDeviceRole(device) {
+    const value = device.metadata.find((m) => m.key === COMPONENT_PLAN_METADATA_KEYS.role)?.value;
+    return value;
+}
+//# sourceMappingURL=component-planning.js.map

package/dist/circuit/component-planning.js.map

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

package/dist/circuit/index.d.ts

@@ -15,3 +15,5 @@ export { CircuitIRSchema, CIRCUIT_IR_SCHEMA_VERSION, BlockSchema, DeviceSchema,
 export type { CircuitIR, Block, Device, Net, NetNode, PowerRail, Interface, InterfacePin, Constraint, BomIntent, PcbIntent, ManufacturingIntent, } from './circuit-ir.js';
 export { compile, setValidationStatus, isReadyForEasyEDA } from './compiler.js';
 export type { CompileOptions, CompileResult } from './compiler.js';
+export { ROLE_REFDES_PREFIX, ROLE_PACKAGE_HINT, COMPONENT_PLAN_METADATA_KEYS, determineComponentRole, planComponents, getDeviceRole, } from './component-planning.js';
+export type { ComponentRole, RoleConfidence, ComponentRolePlan, ComponentPlanResult, } from './component-planning.js';

package/dist/circuit/index.js

@@ -15,4 +15,6 @@ export { DesignIntentSchema, DESIGN_INTENT_SCHEMA_VERSION, validateDesignIntent,
 export { CircuitIRSchema, CIRCUIT_IR_SCHEMA_VERSION, BlockSchema, DeviceSchema, NetSchema, NetNodeSchema, PowerRailSchema, InterfaceSchema, InterfacePinSchema, ConstraintSchema, BomIntentSchema, PcbIntentSchema, ManufacturingIntentSchema, validateCircuitIR, isCircuitIR, } from './circuit-ir.js';
 // Compiler
 export { compile, setValidationStatus, isReadyForEasyEDA } from './compiler.js';
+// Component planning
+export { ROLE_REFDES_PREFIX, ROLE_PACKAGE_HINT, COMPONENT_PLAN_METADATA_KEYS, determineComponentRole, planComponents, getDeviceRole, } from './component-planning.js';
 //# sourceMappingURL=index.js.map

package/dist/circuit/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/circuit/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG5F,QAAQ;AACR,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,eAAe;AACf,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,oBAAoB,EACpB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,YAAY;AACZ,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,aAAa,EACb,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,iBAAiB,EACjB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAgBzB,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/circuit/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG5F,QAAQ;AACR,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,eAAe;AACf,OAAO,EACL,kBAAkB,EAClB,4BAA4B,EAC5B,oBAAoB,EACpB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAG5B,YAAY;AACZ,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,aAAa,EACb,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,iBAAiB,EACjB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAgBzB,WAAW;AACX,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGhF,qBAAqB;AACrB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,4BAA4B,EAC5B,sBAAsB,EACtB,cAAc,EACd,aAAa,GACd,MAAM,yBAAyB,CAAC"}

package/dist/config/profiles.js

@@ -3,35 +3,35 @@ export const PROFILE_DEFINITIONS = {
         name: 'core',
         label: 'Core',
         description: 'High-confidence tools: diagnostics, EasyEDA API inventory, schematic, BOM, DRC/ERC, board layers/stackup, Gerber export',
-        approxToolCount: '42',
+        approxToolCount: '44',
         isDefault: true,
     },
     pro: {
         name: 'pro',
         label: 'Pro',
         description: 'Adds pick-and-place, PDF, netlist export for manufacturing workflows',
-        approxToolCount: '47',
+        approxToolCount: '49',
         isDefault: false,
     },
     full: {
         name: 'full',
         label: 'Full',
         description: 'Adds controlled documented EasyEDA API method calls for full runtime control without raw JavaScript execution',
-        approxToolCount: '56',
+        approxToolCount: '58',
         isDefault: false,
     },
     dev: {
         name: 'dev',
         label: 'Dev',
         description: 'Adds diagnostics probes for bridge methods and live component runtime shape inspection',
-        approxToolCount: '60',
+        approxToolCount: '62',
         isDefault: false,
     },
     experimental: {
         name: 'experimental',
         label: 'Experimental',
         description: 'MCP Apps, Tasks, simulation, autorouter, AI action plans',
-        approxToolCount: '56',
+        approxToolCount: '58',
         isDefault: false,
     },
 };

package/dist/config/version.d.ts

@@ -1 +1 @@
-export declare const SERVER_VERSION = "0.18.0";
+export declare const SERVER_VERSION = "0.20.0";

package/dist/config/version.js

@@ -1,2 +1,2 @@
-export const SERVER_VERSION = '0.18.0'; // x-release-please-version
+export const SERVER_VERSION = '0.20.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/dist/remote/gateway.d.ts

@@ -0,0 +1,74 @@
+import type { Server as HttpServer } from 'node:http';
+import type { Express, Request, Response } from 'express';
+import { type EnvConfig } from '../config/env.js';
+import { ApprovalStore } from './approval-policy.js';
+import { RemoteAuditLog } from './observability.js';
+import { type RemoteDeploymentMode, type RemoteRiskLevel, type ToolRequestMessage, type ToolResponseMessage } from './protocol.js';
+import { type RemoteIdentity } from './scope.js';
+import { type ExtensionSession, RemoteSessionRouter } from './session-router.js';
+export type RemoteGatewayErrorCode = 'BAD_REQUEST' | 'IDENTITY_MISSING' | 'IDENTITY_EXPIRED' | 'SCOPE_MISSING' | 'SESSION_UNPAIRED' | 'SESSION_DISCONNECTED' | 'SESSION_EXPIRED' | 'SESSION_AMBIGUOUS' | 'PROJECT_INACTIVE' | 'APPROVAL_REQUIRED' | 'APPROVAL_NOT_APPROVED' | 'REMOTE_EXTENSION_ERROR' | 'REMOTE_EXTENSION_TIMEOUT';
+export type RemoteGatewayToolResult = {
+    ok: true;
+    sessionId: string;
+    toolName: string;
+    result: unknown;
+    durationMs: number;
+} | {
+    ok: false;
+    status: number;
+    code: RemoteGatewayErrorCode;
+    message: string;
+};
+export type RemoteToolDispatcher = (request: ToolRequestMessage) => Promise<ToolResponseMessage>;
+export interface RemoteGatewayOptions {
+    router?: RemoteSessionRouter;
+    approvals?: ApprovalStore;
+    audit?: RemoteAuditLog;
+    now?: () => Date;
+    makeId?: () => string;
+    hashInput?: (value: unknown) => string;
+}
+export declare function identityFromRequest(req: Request, res: Response, config: EnvConfig): RemoteIdentity | undefined;
+export declare class RemoteGateway {
+    readonly router: RemoteSessionRouter;
+    readonly approvals: ApprovalStore;
+    readonly audit: RemoteAuditLog;
+    private readonly connections;
+    private readonly now;
+    private readonly makeId;
+    private readonly hashInput;
+    private wsAttached;
+    constructor(options?: RemoteGatewayOptions);
+    registerExtension(input: {
+        connectionId: string;
+        mode: Exclude<RemoteDeploymentMode, 'local'>;
+        extensionVersion: string;
+        activeProject?: ExtensionSession['activeProject'];
+        ttlMs?: number;
+        dispatch: RemoteToolDispatcher;
+        pairingCode?: string;
+    }): ExtensionSession;
+    createPairingCode(input: {
+        identity: RemoteIdentity;
+        sessionId?: string;
+        ttlMs?: number;
+    }): string;
+    completePairing(input: {
+        identity: RemoteIdentity;
+        code: string;
+        sessionId: string;
+    }): boolean;
+    disconnect(sessionId: string): void;
+    routeToolRequest(input: {
+        identity?: RemoteIdentity;
+        sessionId?: string;
+        toolName: string;
+        riskLevel: RemoteRiskLevel;
+        input?: unknown;
+        approvalId?: string;
+        deadlineMs?: number;
+    }): Promise<RemoteGatewayToolResult>;
+    registerHttpRoutes(app: Express, config: EnvConfig): void;
+    attachWebSocketServer(server: HttpServer): void;
+    private handleRelaySocket;
+}