@oaslananka/kicad-protocol-schemas 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Osman Aslan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+# KiCad Protocol Schemas
+
+`@oaslananka/kicad-protocol-schemas` owns the product-neutral JSON Schema
+contracts shared by the KiCad Studio extension and `kicad-mcp-pro`.
+
+The package has no VS Code API dependency and no Python server runtime
+dependency. TypeScript consumers can import the schema registry and Ajv-backed
+validators. Python contract tests read the same `schemas/*.schema.json` files
+directly with `jsonschema`.
+
+## Included Contracts
+
+- MCP tool discovery payloads returned by `tools/list`.
+- Tool capability metadata advertised by `kicad-mcp-pro`.
+- Extension-to-MCP active context payloads.
+- Normalized DRC/ERC diagnostic records.
+- BOM and netlist summary payloads.
+- MCP server health/version payloads.
+- Compatibility manifests for cross-product schema support.
+- The existing KiCad MCP server-info contract.
+
+## Schema versioning policy
+
+Every schema file carries an `x-kicad-studio-kit.schemaVersion` value using
+`MAJOR.MINOR.PATCH`. Breaking schema changes require a major version bump.
+Backward-compatible field additions use a minor version bump, and documentation
+or constraint-only fixes use a patch version bump.
+
+The package version follows the highest schema major in the package. A consumer
+that supports schema major `1` may accept any `1.x.y` payload after validation.
+Consumers must reject unknown major versions unless the caller explicitly opts
+into compatibility fallback behavior.
+
+## Migration policy
+
+Schema migrations are additive first. When a field must be renamed or removed,
+the old field remains accepted for one minor line and the new field is documented
+in this README and in the affected schema description. The next major version
+may remove the deprecated field after extension and MCP contract tests both pass
+against the replacement payload.
+
+Run the schema package checks from the repository root:
+
+```bash
+corepack pnpm run check:protocol-schemas
+```

package/dist/index.d.ts

@@ -0,0 +1,272 @@
+export declare const KICAD_PROTOCOL_SCHEMA_VERSION = "1.0.0";
+export declare const PROTOCOL_SCHEMA_NAMES: readonly ["bom-netlist-summary", "compatibility-manifest", "extension-active-context", "kicad-mcp-server-info", "mcp-server-health", "mcp-tool-capability", "mcp-tool-discovery", "normalized-diagnostic"];
+export type ProtocolSchemaName = (typeof PROTOCOL_SCHEMA_NAMES)[number];
+export interface ProtocolJsonSchema {
+    $schema: string;
+    $id: string;
+    title: string;
+    description?: string;
+    type: string;
+    [key: string]: unknown;
+}
+export interface ProtocolValidationError {
+    path: string;
+    message: string;
+    keyword: string;
+}
+export interface ProtocolValidationResult<T = unknown> {
+    schemaName: ProtocolSchemaName;
+    schemaVersion: string;
+    valid: boolean;
+    errors: ProtocolValidationError[];
+    data?: T;
+}
+export interface McpServerInfoCompatibilityRange {
+    kicadStudio: {
+        required: string;
+        recommended: string;
+        testedAgainst: string;
+    };
+    kicadMcpPro: {
+        required: string;
+        testedAgainst: string;
+    };
+}
+export type McpOperatingMode = "readonly" | "write" | "manufacturing" | "experimental";
+export interface McpToolOperatingModeAvailability {
+    available: boolean;
+    requiredMode: McpOperatingMode;
+    reason: string | null;
+}
+export interface McpServerInfoContract {
+    schemaVersion: string;
+    server: "kicad-mcp-pro";
+    description?: string;
+    localizedDescriptions?: Record<string, string>;
+    version: string;
+    mcpProtocolVersion: string;
+    toolSchemaVersion: string;
+    compatibilityRange: McpServerInfoCompatibilityRange;
+    transport: {
+        type: "stdio" | "streamable-http" | "sse";
+        streamableHttp: boolean;
+        statelessHttp: boolean;
+        legacySse: boolean;
+        authRequired: boolean;
+        endpoint: string | null;
+    };
+    kicad: {
+        cliFound: boolean;
+        cliPath: string;
+        cliVersion: string | null;
+        ipcAvailable: boolean;
+        ipcVersion: string | null;
+        ipcApiVersion: string | null;
+        ipcMajorVersion: number | null;
+        ipcEndpointSource: "config" | "environment" | "default";
+        livePcbContext: boolean;
+        liveSchematicContext: boolean;
+        ipcDocumentLoaded: boolean;
+    };
+    operatingMode: {
+        active: McpOperatingMode;
+        default: McpOperatingMode;
+        available: McpOperatingMode[];
+        experimentalEnabled: boolean;
+        toolAvailability: Record<string, McpToolOperatingModeAvailability>;
+    };
+    capabilities: {
+        fileBackedDrc: boolean;
+        fileBackedErc: boolean;
+        fileBackedExports: boolean;
+        livePcbRead: boolean;
+        livePcbWrite: boolean;
+        liveSchematicRead: boolean;
+        liveSchematicWrite: boolean;
+        liveEditingTools: Record<string, {
+            available: boolean;
+            backend: "kicad-ipc" | "hybrid-file-ipc";
+            reason: string | null;
+            minimumKiCadMajor: number;
+        }>;
+        chatgptConnectorCompatible: boolean;
+        cliExports: {
+            ipc2581: boolean;
+            odb: boolean;
+            svg: boolean;
+            dxf: boolean;
+            step: boolean;
+            stepz?: boolean;
+            xao?: boolean;
+            render: boolean;
+            spiceNetlist: boolean;
+        };
+    };
+    diagnostics: string[];
+}
+export interface McpToolCapabilityMetadata {
+    schemaVersion: string;
+    name: string;
+    profiles: string[];
+    tier: "read" | "write" | "export" | "publish" | "human_only";
+    runtime: "none" | "kicad_cli" | "kicad_ipc" | "ngspice" | "freerouting" | "docker";
+    supports_dry_run: boolean;
+    human_gate_required: boolean;
+    description: string;
+    verification_level: "verified" | "experimental" | "planned";
+    inputSchema?: Record<string, unknown>;
+    annotations?: Record<string, unknown>;
+}
+export interface McpToolDiscoveryResponse {
+    schemaVersion?: string;
+    _meta?: Record<string, unknown>;
+    nextCursor?: string;
+    tools: Array<{
+        name: string;
+        description?: string;
+        inputSchema?: Record<string, unknown>;
+        annotations?: Record<string, unknown>;
+    }>;
+    resources?: Array<{
+        uri?: string;
+        name?: string;
+        description?: string;
+    }>;
+    prompts?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    [key: string]: unknown;
+}
+export interface ExtensionActiveContextPayload {
+    schemaVersion?: string;
+    activeFile?: string | null;
+    fileType: "schematic" | "pcb" | "other";
+    drcErrors: string[];
+    projectId?: string;
+    projectName?: string;
+    projectRoot?: string;
+    projectFile?: string;
+    selectedNet?: string;
+    selectedReference?: string;
+    activeVariant?: string;
+    activeSheetPath?: string;
+    visibleLayers?: string[];
+    kicadVersion?: string;
+    designBlocks?: string[];
+    cursorPosition?: {
+        line: number;
+        character: number;
+    };
+    selectedArea?: {
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+    };
+}
+export interface NormalizedDiagnostic {
+    schemaVersion: string;
+    source: "drc" | "erc" | "syntax";
+    severity: "error" | "warning" | "info";
+    message: string;
+    path: string;
+    code?: string;
+    line?: number;
+    column?: number;
+    reference?: string;
+    net?: string;
+    capturedAt: string;
+}
+export interface BomNetlistSummary {
+    schemaVersion: string;
+    project: {
+        name: string;
+        rootPath?: string;
+        projectFile?: string;
+    };
+    bom: {
+        totalComponents: number;
+        uniqueValues: number;
+        entries: Array<{
+            references: string[];
+            value: string;
+            footprint: string;
+            quantity: number;
+            mpn?: string;
+            manufacturer?: string;
+            lcsc?: string;
+            description?: string;
+            dnp?: boolean;
+        }>;
+    };
+    netlist: {
+        netCount: number;
+        nodes: Array<{
+            netName: string;
+            pins: Array<{
+                reference: string;
+                pin: string;
+            }>;
+        }>;
+    };
+}
+export interface McpServerHealth {
+    schemaVersion: string;
+    server: "kicad-mcp-pro";
+    version: string;
+    status: "ok" | "degraded" | "error";
+    mcpProtocolVersion: string;
+    toolSchemaVersion: string;
+    transport: {
+        type: "stdio" | "streamable-http" | "sse";
+        endpoint: string | null;
+    };
+    kicad: {
+        cliFound: boolean;
+        cliVersion: string | null;
+        ipcAvailable: boolean;
+    };
+    diagnostics: string[];
+}
+export interface CompatibilityManifest {
+    schemaVersion: string;
+    products: Record<string, {
+        version: string;
+        supportedSchemaMajors: number[];
+    }>;
+    schemas: Record<string, {
+        current: string;
+        compatibility: string;
+    }>;
+    policy: {
+        breakingChanges: "major";
+        additiveChanges: "minor";
+        documentationChanges: "patch";
+    };
+}
+export declare const PROTOCOL_SCHEMA_DEFINITIONS: Readonly<Record<ProtocolSchemaName, ProtocolJsonSchema>>;
+export declare class ProtocolSchemaValidator {
+    private readonly schemas;
+    private readonly ajv;
+    private readonly validators;
+    constructor(schemas?: Readonly<Record<ProtocolSchemaName, ProtocolJsonSchema>>);
+    validate<T = unknown>(schemaName: ProtocolSchemaName, payload: unknown): ProtocolValidationResult<T>;
+    private validatorFor;
+}
+export declare function getProtocolSchemaValidator(): ProtocolSchemaValidator;
+export declare function validateProtocolPayload<T = unknown>(schemaName: ProtocolSchemaName, payload: unknown): ProtocolValidationResult<T>;
+export declare function validateMcpServerInfoContract(payload: unknown): ProtocolValidationResult<McpServerInfoContract>;
+export declare function isMcpServerInfoContract(payload: unknown): payload is McpServerInfoContract;
+export declare function validateMcpToolDiscovery(payload: unknown): ProtocolValidationResult<McpToolDiscoveryResponse>;
+export declare function validateToolCapabilityMetadata(payload: unknown): ProtocolValidationResult<McpToolCapabilityMetadata>;
+export declare function validateExtensionActiveContextPayload(payload: unknown): ProtocolValidationResult<ExtensionActiveContextPayload>;
+export declare function validateNormalizedDiagnostic(payload: unknown): ProtocolValidationResult<NormalizedDiagnostic>;
+export declare function validateBomNetlistSummary(payload: unknown): ProtocolValidationResult<BomNetlistSummary>;
+export declare function validateMcpServerHealth(payload: unknown): ProtocolValidationResult<McpServerHealth>;
+export declare function validateCompatibilityManifest(payload: unknown): ProtocolValidationResult<CompatibilityManifest>;
+export declare function protocolSchemasRoot(startDir?: string): string;
+export declare function protocolSchemaPath(schemaName: ProtocolSchemaName, startDir?: string): string;
+export declare function findProtocolSchemasPackageRoot(startDir?: string): string;
+export declare function protocolSchemaVersion(schemaName: ProtocolSchemaName): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,185 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProtocolSchemaValidator = exports.PROTOCOL_SCHEMA_DEFINITIONS = exports.PROTOCOL_SCHEMA_NAMES = exports.KICAD_PROTOCOL_SCHEMA_VERSION = void 0;
+exports.getProtocolSchemaValidator = getProtocolSchemaValidator;
+exports.validateProtocolPayload = validateProtocolPayload;
+exports.validateMcpServerInfoContract = validateMcpServerInfoContract;
+exports.isMcpServerInfoContract = isMcpServerInfoContract;
+exports.validateMcpToolDiscovery = validateMcpToolDiscovery;
+exports.validateToolCapabilityMetadata = validateToolCapabilityMetadata;
+exports.validateExtensionActiveContextPayload = validateExtensionActiveContextPayload;
+exports.validateNormalizedDiagnostic = validateNormalizedDiagnostic;
+exports.validateBomNetlistSummary = validateBomNetlistSummary;
+exports.validateMcpServerHealth = validateMcpServerHealth;
+exports.validateCompatibilityManifest = validateCompatibilityManifest;
+exports.protocolSchemasRoot = protocolSchemasRoot;
+exports.protocolSchemaPath = protocolSchemaPath;
+exports.findProtocolSchemasPackageRoot = findProtocolSchemasPackageRoot;
+exports.protocolSchemaVersion = protocolSchemaVersion;
+const _2020_1 = __importDefault(require("ajv/dist/2020"));
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+exports.KICAD_PROTOCOL_SCHEMA_VERSION = "1.0.0";
+exports.PROTOCOL_SCHEMA_NAMES = [
+    "bom-netlist-summary",
+    "compatibility-manifest",
+    "extension-active-context",
+    "kicad-mcp-server-info",
+    "mcp-server-health",
+    "mcp-tool-capability",
+    "mcp-tool-discovery",
+    "normalized-diagnostic",
+];
+exports.PROTOCOL_SCHEMA_DEFINITIONS = Object.freeze({
+    "bom-netlist-summary": require("../schemas/bom-netlist-summary.schema.json"),
+    "compatibility-manifest": require("../schemas/compatibility-manifest.schema.json"),
+    "extension-active-context": require("../schemas/extension-active-context.schema.json"),
+    "kicad-mcp-server-info": require("../schemas/kicad-mcp-server-info.schema.json"),
+    "mcp-server-health": require("../schemas/mcp-server-health.schema.json"),
+    "mcp-tool-capability": require("../schemas/mcp-tool-capability.schema.json"),
+    "mcp-tool-discovery": require("../schemas/mcp-tool-discovery.schema.json"),
+    "normalized-diagnostic": require("../schemas/normalized-diagnostic.schema.json"),
+});
+class ProtocolSchemaValidator {
+    schemas;
+    ajv;
+    validators = new Map();
+    constructor(schemas = exports.PROTOCOL_SCHEMA_DEFINITIONS) {
+        this.schemas = schemas;
+        this.ajv = new _2020_1.default({ allErrors: true, strict: false });
+        for (const schemaName of exports.PROTOCOL_SCHEMA_NAMES) {
+            const schema = this.schemas[schemaName];
+            this.ajv.addSchema(schema, schema.$id);
+            this.validators.set(schemaName, this.ajv.compile(schema));
+        }
+    }
+    validate(schemaName, payload) {
+        const validate = this.validatorFor(schemaName);
+        const schemaVersion = protocolSchemaVersion(schemaName);
+        const schemaValid = Boolean(validate(payload));
+        const versionError = schemaValid
+            ? validatePayloadSchemaMajor(schemaName, schemaVersion, payload)
+            : undefined;
+        const valid = schemaValid && versionError === undefined;
+        const result = {
+            schemaName,
+            schemaVersion,
+            valid,
+            errors: valid
+                ? []
+                : (versionError ?? normalizeAjvErrors(validate.errors)),
+        };
+        if (valid) {
+            result.data = payload;
+        }
+        return result;
+    }
+    validatorFor(schemaName) {
+        const validate = this.validators.get(schemaName);
+        if (!validate) {
+            throw new Error(`Unknown protocol schema: ${schemaName}`);
+        }
+        return validate;
+    }
+}
+exports.ProtocolSchemaValidator = ProtocolSchemaValidator;
+let defaultValidator;
+function getProtocolSchemaValidator() {
+    defaultValidator ??= new ProtocolSchemaValidator();
+    return defaultValidator;
+}
+function validateProtocolPayload(schemaName, payload) {
+    return getProtocolSchemaValidator().validate(schemaName, payload);
+}
+function validateMcpServerInfoContract(payload) {
+    return validateProtocolPayload("kicad-mcp-server-info", payload);
+}
+function isMcpServerInfoContract(payload) {
+    return validateMcpServerInfoContract(payload).valid;
+}
+function validateMcpToolDiscovery(payload) {
+    return validateProtocolPayload("mcp-tool-discovery", payload);
+}
+function validateToolCapabilityMetadata(payload) {
+    return validateProtocolPayload("mcp-tool-capability", payload);
+}
+function validateExtensionActiveContextPayload(payload) {
+    return validateProtocolPayload("extension-active-context", payload);
+}
+function validateNormalizedDiagnostic(payload) {
+    return validateProtocolPayload("normalized-diagnostic", payload);
+}
+function validateBomNetlistSummary(payload) {
+    return validateProtocolPayload("bom-netlist-summary", payload);
+}
+function validateMcpServerHealth(payload) {
+    return validateProtocolPayload("mcp-server-health", payload);
+}
+function validateCompatibilityManifest(payload) {
+    return validateProtocolPayload("compatibility-manifest", payload);
+}
+function protocolSchemasRoot(startDir = __dirname) {
+    return (0, node_path_1.join)(findProtocolSchemasPackageRoot(startDir), "schemas");
+}
+function protocolSchemaPath(schemaName, startDir = __dirname) {
+    return (0, node_path_1.join)(protocolSchemasRoot(startDir), `${schemaName}.schema.json`);
+}
+function findProtocolSchemasPackageRoot(startDir = __dirname) {
+    let current = (0, node_path_1.resolve)(startDir);
+    for (;;) {
+        const packageJsonPath = (0, node_path_1.join)(current, "package.json");
+        if ((0, node_fs_1.existsSync)(packageJsonPath) && (0, node_fs_1.existsSync)((0, node_path_1.join)(current, "schemas"))) {
+            return current;
+        }
+        const parent = (0, node_path_1.dirname)(current);
+        if (parent === current) {
+            throw new Error(`Could not find @oaslananka/kicad-protocol-schemas package root from ${startDir}`);
+        }
+        current = parent;
+    }
+}
+function protocolSchemaVersion(schemaName) {
+    const metadata = exports.PROTOCOL_SCHEMA_DEFINITIONS[schemaName]["x-kicad-studio-kit"];
+    if (isRecord(metadata) && typeof metadata["schemaVersion"] === "string") {
+        return metadata["schemaVersion"];
+    }
+    return exports.KICAD_PROTOCOL_SCHEMA_VERSION;
+}
+function normalizeAjvErrors(errors) {
+    return (errors ?? []).map((error) => ({
+        path: error.instancePath || "/",
+        message: error.message ?? "schema validation failed",
+        keyword: error.keyword,
+    }));
+}
+function validatePayloadSchemaMajor(schemaName, supportedVersion, payload) {
+    if (!isRecord(payload) || typeof payload["schemaVersion"] !== "string") {
+        return undefined;
+    }
+    const payloadMajor = majorVersion(payload["schemaVersion"]);
+    const supportedMajor = majorVersion(supportedVersion);
+    if (payloadMajor === undefined || supportedMajor === undefined) {
+        return undefined;
+    }
+    if (payloadMajor === supportedMajor) {
+        return undefined;
+    }
+    return [
+        {
+            path: "/schemaVersion",
+            message: `${schemaName} payload declares unsupported schema major ${payloadMajor}; expected ${supportedMajor}.x`,
+            keyword: "schemaMajor",
+        },
+    ];
+}
+function majorVersion(version) {
+    const match = /^([0-9]+)\.[0-9]+\.[0-9]+$/.exec(version);
+    return match ? Number(match[1]) : undefined;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@oaslananka/kicad-protocol-schemas",
+  "version": "1.1.0",
+  "description": "Shared versioned protocol schemas and validators for KiCad Studio Kit extension/MCP compatibility contracts.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oaslananka/kicad-mcp"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "schemas/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=24.11.0 <25",
+    "pnpm": ">=11.0.0 <12"
+  },
+  "dependencies": {
+    "ajv": "8.20.0"
+  },
+  "devDependencies": {
+    "@types/node": "24.12.3",
+    "prettier": "3.8.3",
+    "typescript": "6.0.3"
+  },
+  "scripts": {
+    "format": "prettier --ignore-unknown --no-error-on-unmatched-pattern --write package.json README.md tsconfig*.json scripts/*.cjs src/**/*.ts test/**/*.ts schemas/**/*.json",
+    "format:check": "prettier --ignore-unknown --no-error-on-unmatched-pattern --check package.json README.md tsconfig*.json scripts/*.cjs src/**/*.ts test/**/*.ts schemas/**/*.json",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "typecheck": "tsc -p tsconfig.json --noEmit && pnpm run build && tsc -p tsconfig.test.json --noEmit",
+    "build": "tsc -p tsconfig.json",
+    "build:test": "tsc -p tsconfig.test.json",
+    "test": "pnpm run build && pnpm run build:test && node scripts/run-tests.cjs",
+    "check": "pnpm run format:check && pnpm run lint && pnpm run typecheck && pnpm run test && pnpm run build"
+  }
+}