@mindpal/protocol 0.0.2-alpha

package/dist/index.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * @mindpal/protocol — MindPal Agent OS 协议层标准定义
+ *
+ * 统一 re-export 所有协议模块，提供单一入口点。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILTIN_ERROR_CATEGORY_ALIASES = exports.withPolicySnapshotRef = exports.generateHumanSummary = exports.isHighRiskAuditAction = exports.normalizeAuditErrorCategory = exports.AuditContractError = exports.HIGH_RISK_AUDIT_ACTIONS = exports.AUDIT_ERROR_CATEGORIES = exports.securityProfileRegistry = exports.BUILTIN_SECURITY_PROFILES = exports.authLevelRegistry = exports.BUILTIN_AUTH_LEVELS = exports.DEFAULT_SECURITY_POLICY = exports.isToolAllowedForPolicy = exports.toolNameFromRef = exports.skillLayerRegistry = exports.BUILTIN_SKILL_LAYERS = exports.validateManifest = exports.getRpcParseFailures = exports.isRpcError = exports.isRpcResponse = exports.isRpcNotification = exports.isRpcRequest = exports.parseRpcMessage = exports.serializeRpcMessage = exports.createRpcNotification = exports.createRpcError = exports.createRpcSuccess = exports.createRpcRequest = exports.negotiateVersion = exports.isVersionCompatible = exports.sensitivityProfileRegistry = exports.BUILTIN_SENSITIVITY_PROFILES = exports.runtimeRegistry = exports.BUILTIN_SKILL_RUNTIMES = exports.modalityRegistry = exports.BUILTIN_DEVICE_MODALITIES = exports.SKILL_RPC_METHODS = exports.SKILL_RPC_ERRORS = exports.skillErrorCodeRegistry = exports.BUILTIN_CUSTOM_ERRORS = exports.JSONRPC_STANDARD_ERRORS = exports.PROTOCOL_VERSIONS = exports.MIN_SUPPORTED_PROTOCOL_VERSION = exports.DEVICE_PROTOCOL_VERSION = exports.SKILL_RPC_JSONRPC = exports.SKILL_RPC_VERSION = exports.registryIds = exports.builtInEntry = exports.createRegistry = void 0;
+exports.getServiceCodeForError = exports.getHttpStatusForError = exports.ERROR_LAYER_MAP = exports.JSONRPC_ERROR_RANGE = exports.PROTOCOL_ERRORS = exports.mapAgentToOrchestration = exports.mapOrchestrationToAgent = exports.checkStateInvariant = exports.normalizeCollabPhase = exports.normalizeRunStatus = exports.normalizeStepStatus = exports.isAgentTerminal = exports.tryTransitionAgent = exports.tryTransitionCollab = exports.tryTransitionRun = exports.tryTransitionStep = exports.transitionAgent = exports.transitionCollab = exports.transitionRun = exports.transitionStep = exports.AGENT_TERMINAL = exports.AGENT_TRANSITIONS = exports.AGENT_PHASES = exports.COLLAB_TRANSITIONS = exports.COLLAB_TERMINAL = exports.COLLAB_PHASES = exports.RUN_TRANSITIONS = exports.RUN_TERMINAL = exports.RUN_STATUSES = exports.STEP_TRANSITIONS = exports.STEP_STREAMING = exports.STEP_BLOCKING = exports.STEP_TERMINAL = exports.STEP_STATUSES = exports.highRiskActionRegistry = exports.BUILTIN_HIGH_RISK_ACTIONS = exports.errorCategoryAliasRegistry = void 0;
+// ── Registry Infrastructure ──
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "createRegistry", { enumerable: true, get: function () { return registry_1.createRegistry; } });
+Object.defineProperty(exports, "builtInEntry", { enumerable: true, get: function () { return registry_1.builtInEntry; } });
+Object.defineProperty(exports, "registryIds", { enumerable: true, get: function () { return registry_1.registryIds; } });
+// ── Skill RPC Protocol ──
+var skill_rpc_1 = require("./skill-rpc");
+Object.defineProperty(exports, "SKILL_RPC_VERSION", { enumerable: true, get: function () { return skill_rpc_1.SKILL_RPC_VERSION; } });
+Object.defineProperty(exports, "SKILL_RPC_JSONRPC", { enumerable: true, get: function () { return skill_rpc_1.SKILL_RPC_JSONRPC; } });
+Object.defineProperty(exports, "DEVICE_PROTOCOL_VERSION", { enumerable: true, get: function () { return skill_rpc_1.DEVICE_PROTOCOL_VERSION; } });
+Object.defineProperty(exports, "MIN_SUPPORTED_PROTOCOL_VERSION", { enumerable: true, get: function () { return skill_rpc_1.MIN_SUPPORTED_PROTOCOL_VERSION; } });
+Object.defineProperty(exports, "PROTOCOL_VERSIONS", { enumerable: true, get: function () { return skill_rpc_1.PROTOCOL_VERSIONS; } });
+Object.defineProperty(exports, "JSONRPC_STANDARD_ERRORS", { enumerable: true, get: function () { return skill_rpc_1.JSONRPC_STANDARD_ERRORS; } });
+Object.defineProperty(exports, "BUILTIN_CUSTOM_ERRORS", { enumerable: true, get: function () { return skill_rpc_1.BUILTIN_CUSTOM_ERRORS; } });
+Object.defineProperty(exports, "skillErrorCodeRegistry", { enumerable: true, get: function () { return skill_rpc_1.skillErrorCodeRegistry; } });
+Object.defineProperty(exports, "SKILL_RPC_ERRORS", { enumerable: true, get: function () { return skill_rpc_1.SKILL_RPC_ERRORS; } });
+Object.defineProperty(exports, "SKILL_RPC_METHODS", { enumerable: true, get: function () { return skill_rpc_1.SKILL_RPC_METHODS; } });
+Object.defineProperty(exports, "BUILTIN_DEVICE_MODALITIES", { enumerable: true, get: function () { return skill_rpc_1.BUILTIN_DEVICE_MODALITIES; } });
+Object.defineProperty(exports, "modalityRegistry", { enumerable: true, get: function () { return skill_rpc_1.modalityRegistry; } });
+Object.defineProperty(exports, "BUILTIN_SKILL_RUNTIMES", { enumerable: true, get: function () { return skill_rpc_1.BUILTIN_SKILL_RUNTIMES; } });
+Object.defineProperty(exports, "runtimeRegistry", { enumerable: true, get: function () { return skill_rpc_1.runtimeRegistry; } });
+Object.defineProperty(exports, "BUILTIN_SENSITIVITY_PROFILES", { enumerable: true, get: function () { return skill_rpc_1.BUILTIN_SENSITIVITY_PROFILES; } });
+Object.defineProperty(exports, "sensitivityProfileRegistry", { enumerable: true, get: function () { return skill_rpc_1.sensitivityProfileRegistry; } });
+Object.defineProperty(exports, "isVersionCompatible", { enumerable: true, get: function () { return skill_rpc_1.isVersionCompatible; } });
+Object.defineProperty(exports, "negotiateVersion", { enumerable: true, get: function () { return skill_rpc_1.negotiateVersion; } });
+Object.defineProperty(exports, "createRpcRequest", { enumerable: true, get: function () { return skill_rpc_1.createRpcRequest; } });
+Object.defineProperty(exports, "createRpcSuccess", { enumerable: true, get: function () { return skill_rpc_1.createRpcSuccess; } });
+Object.defineProperty(exports, "createRpcError", { enumerable: true, get: function () { return skill_rpc_1.createRpcError; } });
+Object.defineProperty(exports, "createRpcNotification", { enumerable: true, get: function () { return skill_rpc_1.createRpcNotification; } });
+Object.defineProperty(exports, "serializeRpcMessage", { enumerable: true, get: function () { return skill_rpc_1.serializeRpcMessage; } });
+Object.defineProperty(exports, "parseRpcMessage", { enumerable: true, get: function () { return skill_rpc_1.parseRpcMessage; } });
+Object.defineProperty(exports, "isRpcRequest", { enumerable: true, get: function () { return skill_rpc_1.isRpcRequest; } });
+Object.defineProperty(exports, "isRpcNotification", { enumerable: true, get: function () { return skill_rpc_1.isRpcNotification; } });
+Object.defineProperty(exports, "isRpcResponse", { enumerable: true, get: function () { return skill_rpc_1.isRpcResponse; } });
+Object.defineProperty(exports, "isRpcError", { enumerable: true, get: function () { return skill_rpc_1.isRpcError; } });
+Object.defineProperty(exports, "getRpcParseFailures", { enumerable: true, get: function () { return skill_rpc_1.getRpcParseFailures; } });
+// ── Skill Manifest ──
+var skill_manifest_1 = require("./skill-manifest");
+Object.defineProperty(exports, "validateManifest", { enumerable: true, get: function () { return skill_manifest_1.validateManifest; } });
+Object.defineProperty(exports, "BUILTIN_SKILL_LAYERS", { enumerable: true, get: function () { return skill_manifest_1.BUILTIN_SKILL_LAYERS; } });
+Object.defineProperty(exports, "skillLayerRegistry", { enumerable: true, get: function () { return skill_manifest_1.skillLayerRegistry; } });
+// ── Tool Policy Utilities ──
+var toolPolicy_1 = require("./toolPolicy");
+Object.defineProperty(exports, "toolNameFromRef", { enumerable: true, get: function () { return toolPolicy_1.toolNameFromRef; } });
+Object.defineProperty(exports, "isToolAllowedForPolicy", { enumerable: true, get: function () { return toolPolicy_1.isToolAllowedForPolicy; } });
+// ── Device Handshake Security ──
+var device_handshake_1 = require("./device-handshake");
+Object.defineProperty(exports, "DEFAULT_SECURITY_POLICY", { enumerable: true, get: function () { return device_handshake_1.DEFAULT_SECURITY_POLICY; } });
+Object.defineProperty(exports, "BUILTIN_AUTH_LEVELS", { enumerable: true, get: function () { return device_handshake_1.BUILTIN_AUTH_LEVELS; } });
+Object.defineProperty(exports, "authLevelRegistry", { enumerable: true, get: function () { return device_handshake_1.authLevelRegistry; } });
+Object.defineProperty(exports, "BUILTIN_SECURITY_PROFILES", { enumerable: true, get: function () { return device_handshake_1.BUILTIN_SECURITY_PROFILES; } });
+Object.defineProperty(exports, "securityProfileRegistry", { enumerable: true, get: function () { return device_handshake_1.securityProfileRegistry; } });
+// ── Audit Event ──
+var audit_event_1 = require("./audit-event");
+Object.defineProperty(exports, "AUDIT_ERROR_CATEGORIES", { enumerable: true, get: function () { return audit_event_1.AUDIT_ERROR_CATEGORIES; } });
+Object.defineProperty(exports, "HIGH_RISK_AUDIT_ACTIONS", { enumerable: true, get: function () { return audit_event_1.HIGH_RISK_AUDIT_ACTIONS; } });
+Object.defineProperty(exports, "AuditContractError", { enumerable: true, get: function () { return audit_event_1.AuditContractError; } });
+Object.defineProperty(exports, "normalizeAuditErrorCategory", { enumerable: true, get: function () { return audit_event_1.normalizeAuditErrorCategory; } });
+Object.defineProperty(exports, "isHighRiskAuditAction", { enumerable: true, get: function () { return audit_event_1.isHighRiskAuditAction; } });
+Object.defineProperty(exports, "generateHumanSummary", { enumerable: true, get: function () { return audit_event_1.generateHumanSummary; } });
+Object.defineProperty(exports, "withPolicySnapshotRef", { enumerable: true, get: function () { return audit_event_1.withPolicySnapshotRef; } });
+Object.defineProperty(exports, "BUILTIN_ERROR_CATEGORY_ALIASES", { enumerable: true, get: function () { return audit_event_1.BUILTIN_ERROR_CATEGORY_ALIASES; } });
+Object.defineProperty(exports, "errorCategoryAliasRegistry", { enumerable: true, get: function () { return audit_event_1.errorCategoryAliasRegistry; } });
+Object.defineProperty(exports, "BUILTIN_HIGH_RISK_ACTIONS", { enumerable: true, get: function () { return audit_event_1.BUILTIN_HIGH_RISK_ACTIONS; } });
+Object.defineProperty(exports, "highRiskActionRegistry", { enumerable: true, get: function () { return audit_event_1.highRiskActionRegistry; } });
+// ── State Machine ──
+var state_machine_1 = require("./state-machine");
+Object.defineProperty(exports, "STEP_STATUSES", { enumerable: true, get: function () { return state_machine_1.STEP_STATUSES; } });
+Object.defineProperty(exports, "STEP_TERMINAL", { enumerable: true, get: function () { return state_machine_1.STEP_TERMINAL; } });
+Object.defineProperty(exports, "STEP_BLOCKING", { enumerable: true, get: function () { return state_machine_1.STEP_BLOCKING; } });
+Object.defineProperty(exports, "STEP_STREAMING", { enumerable: true, get: function () { return state_machine_1.STEP_STREAMING; } });
+Object.defineProperty(exports, "STEP_TRANSITIONS", { enumerable: true, get: function () { return state_machine_1.STEP_TRANSITIONS; } });
+Object.defineProperty(exports, "RUN_STATUSES", { enumerable: true, get: function () { return state_machine_1.RUN_STATUSES; } });
+Object.defineProperty(exports, "RUN_TERMINAL", { enumerable: true, get: function () { return state_machine_1.RUN_TERMINAL; } });
+Object.defineProperty(exports, "RUN_TRANSITIONS", { enumerable: true, get: function () { return state_machine_1.RUN_TRANSITIONS; } });
+Object.defineProperty(exports, "COLLAB_PHASES", { enumerable: true, get: function () { return state_machine_1.COLLAB_PHASES; } });
+Object.defineProperty(exports, "COLLAB_TERMINAL", { enumerable: true, get: function () { return state_machine_1.COLLAB_TERMINAL; } });
+Object.defineProperty(exports, "COLLAB_TRANSITIONS", { enumerable: true, get: function () { return state_machine_1.COLLAB_TRANSITIONS; } });
+Object.defineProperty(exports, "AGENT_PHASES", { enumerable: true, get: function () { return state_machine_1.AGENT_PHASES; } });
+Object.defineProperty(exports, "AGENT_TRANSITIONS", { enumerable: true, get: function () { return state_machine_1.AGENT_TRANSITIONS; } });
+Object.defineProperty(exports, "AGENT_TERMINAL", { enumerable: true, get: function () { return state_machine_1.AGENT_TERMINAL; } });
+Object.defineProperty(exports, "transitionStep", { enumerable: true, get: function () { return state_machine_1.transitionStep; } });
+Object.defineProperty(exports, "transitionRun", { enumerable: true, get: function () { return state_machine_1.transitionRun; } });
+Object.defineProperty(exports, "transitionCollab", { enumerable: true, get: function () { return state_machine_1.transitionCollab; } });
+Object.defineProperty(exports, "transitionAgent", { enumerable: true, get: function () { return state_machine_1.transitionAgent; } });
+Object.defineProperty(exports, "tryTransitionStep", { enumerable: true, get: function () { return state_machine_1.tryTransitionStep; } });
+Object.defineProperty(exports, "tryTransitionRun", { enumerable: true, get: function () { return state_machine_1.tryTransitionRun; } });
+Object.defineProperty(exports, "tryTransitionCollab", { enumerable: true, get: function () { return state_machine_1.tryTransitionCollab; } });
+Object.defineProperty(exports, "tryTransitionAgent", { enumerable: true, get: function () { return state_machine_1.tryTransitionAgent; } });
+Object.defineProperty(exports, "isAgentTerminal", { enumerable: true, get: function () { return state_machine_1.isAgentTerminal; } });
+Object.defineProperty(exports, "normalizeStepStatus", { enumerable: true, get: function () { return state_machine_1.normalizeStepStatus; } });
+Object.defineProperty(exports, "normalizeRunStatus", { enumerable: true, get: function () { return state_machine_1.normalizeRunStatus; } });
+Object.defineProperty(exports, "normalizeCollabPhase", { enumerable: true, get: function () { return state_machine_1.normalizeCollabPhase; } });
+Object.defineProperty(exports, "checkStateInvariant", { enumerable: true, get: function () { return state_machine_1.checkStateInvariant; } });
+Object.defineProperty(exports, "mapOrchestrationToAgent", { enumerable: true, get: function () { return state_machine_1.mapOrchestrationToAgent; } });
+Object.defineProperty(exports, "mapAgentToOrchestration", { enumerable: true, get: function () { return state_machine_1.mapAgentToOrchestration; } });
+// ── Errors ──
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "PROTOCOL_ERRORS", { enumerable: true, get: function () { return errors_1.PROTOCOL_ERRORS; } });
+Object.defineProperty(exports, "JSONRPC_ERROR_RANGE", { enumerable: true, get: function () { return errors_1.JSONRPC_ERROR_RANGE; } });
+Object.defineProperty(exports, "ERROR_LAYER_MAP", { enumerable: true, get: function () { return errors_1.ERROR_LAYER_MAP; } });
+Object.defineProperty(exports, "getHttpStatusForError", { enumerable: true, get: function () { return errors_1.getHttpStatusForError; } });
+Object.defineProperty(exports, "getServiceCodeForError", { enumerable: true, get: function () { return errors_1.getServiceCodeForError; } });
+//# 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/dist/registry.d.ts

@@ -0,0 +1,65 @@
+/**
+ * MindPal Protocol Registry Infrastructure
+ *
+ * 提供元协议架构的核心注册表机制。
+ * 所有可扩展的协议元素（消息类型、错误码、模态、运行时等）
+ * 通过注册表动态声明，而非硬编码枚举。
+ *
+ * 设计原则：
+ * 1. 同步内存结构，零外部依赖
+ * 2. builtIn 条目不可删除（保证核心功能永远可用）
+ * 3. 支持按 category 分组查询
+ * 4. 类型安全的泛型设计
+ */
+/** 注册表条目 */
+export interface RegistryEntry<T = unknown> {
+    /** 唯一标识（如 "task.assign", "image", "node"） */
+    id: string;
+    /** 分类标签（如 "collab.task", "modality", "runtime"） */
+    category: string;
+    /** 人类可读描述 */
+    description?: string;
+    /** payload 的 JSON Schema（可选，用于验证） */
+    schema?: Record<string, unknown>;
+    /** 扩展元数据 */
+    metadata?: Record<string, unknown>;
+    /** 是否为内置条目（不可删除） */
+    builtIn?: boolean;
+    /** 关联值（泛型，如错误码的数字值） */
+    value?: T;
+}
+/** 条目校验结果 */
+export interface ValidationResult {
+    valid: boolean;
+    errors?: string[];
+}
+/** 类型化注册表接口 */
+export interface TypeRegistry<T = unknown> {
+    /** 注册新条目。内部调用 validate 做前置校验，校验失败抛出错误。 */
+    register(entry: RegistryEntry<T>): void;
+    /** 批量注册 */
+    registerAll(entries: RegistryEntry<T>[]): void;
+    /** 注销条目。builtIn 条目不可注销，返回 false。 */
+    unregister(id: string): boolean;
+    /** 获取条目 */
+    get(id: string): RegistryEntry<T> | undefined;
+    /** 检查 id 是否已注册 */
+    has(id: string): boolean;
+    /** 列出所有条目，可按 category 过滤 */
+    list(category?: string): RegistryEntry<T>[];
+    /** 校验条目是否满足注册要求（id 非空、不重复、category 非空） */
+    validate(entry: RegistryEntry<T>): ValidationResult;
+    /** 获取所有已注册的 id 列表 */
+    ids(): string[];
+    /** 获取注册表大小 */
+    size(): number;
+    /** 重置为初始状态（仅保留 builtIn 条目） */
+    reset(): void;
+}
+/** 创建注册表实例 */
+export declare function createRegistry<T = unknown>(defaults?: RegistryEntry<T>[]): TypeRegistry<T>;
+/** 快捷创建内置条目 */
+export declare function builtInEntry<T>(id: string, category: string, value?: T, metadata?: Record<string, unknown>): RegistryEntry<T>;
+/** 从注册表提取所有 id 作为常量数组（给 TS 消费者用于类型推断） */
+export declare function registryIds<T>(registry: TypeRegistry<T>): string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,YAAY;AACZ,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,YAAY;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uBAAuB;IACvB,KAAK,CAAC,EAAE,CAAC,CAAC;CACX;AAED,aAAa;AACb,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,eAAe;AACf,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACxC,WAAW;IACX,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;IAC/C,oCAAoC;IACpC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,WAAW;IACX,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAC9C,kBAAkB;IAClB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,4BAA4B;IAC5B,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC;IACpD,qBAAqB;IACrB,GAAG,IAAI,MAAM,EAAE,CAAC;IAChB,cAAc;IACd,IAAI,IAAI,MAAM,CAAC;IACf,8BAA8B;IAC9B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,cAAc;AACd,wBAAgB,cAAc,CAAC,CAAC,GAAG,OAAO,EACxC,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,GAC5B,YAAY,CAAC,CAAC,CAAC,CAiFjB;AAED,eAAe;AACf,wBAAgB,YAAY,CAAC,CAAC,EAC5B,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,CAAC,EACT,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,aAAa,CAAC,CAAC,CAAC,CAElB;AAED,yCAAyC;AACzC,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAElE"}

package/dist/registry.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * MindPal Protocol Registry Infrastructure
+ *
+ * 提供元协议架构的核心注册表机制。
+ * 所有可扩展的协议元素（消息类型、错误码、模态、运行时等）
+ * 通过注册表动态声明，而非硬编码枚举。
+ *
+ * 设计原则：
+ * 1. 同步内存结构，零外部依赖
+ * 2. builtIn 条目不可删除（保证核心功能永远可用）
+ * 3. 支持按 category 分组查询
+ * 4. 类型安全的泛型设计
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRegistry = createRegistry;
+exports.builtInEntry = builtInEntry;
+exports.registryIds = registryIds;
+/** 创建注册表实例 */
+function createRegistry(defaults) {
+    const store = new Map();
+    // 初始化 defaults，未显式设置 builtIn 的条目默认为 true
+    if (defaults) {
+        for (const entry of defaults) {
+            const normalized = {
+                ...entry,
+                builtIn: entry.builtIn !== undefined ? entry.builtIn : true,
+            };
+            store.set(normalized.id, normalized);
+        }
+    }
+    return {
+        validate(entry) {
+            const errors = [];
+            if (!entry.id || typeof entry.id !== 'string' || entry.id.trim() === '') {
+                errors.push('entry.id must be a non-empty string');
+            }
+            if (!entry.category || typeof entry.category !== 'string' || entry.category.trim() === '') {
+                errors.push('entry.category must be a non-empty string');
+            }
+            if (entry.id && store.has(entry.id)) {
+                errors.push(`entry.id "${entry.id}" is already registered`);
+            }
+            return errors.length === 0 ? { valid: true } : { valid: false, errors };
+        },
+        register(entry) {
+            const result = this.validate(entry);
+            if (!result.valid) {
+                throw new Error(`Registry: validation failed — ${result.errors.join('; ')}`);
+            }
+            store.set(entry.id, { ...entry });
+        },
+        registerAll(entries) {
+            for (const entry of entries) {
+                this.register(entry);
+            }
+        },
+        unregister(id) {
+            const entry = store.get(id);
+            if (!entry)
+                return false;
+            if (entry.builtIn === true)
+                return false;
+            store.delete(id);
+            return true;
+        },
+        get(id) {
+            return store.get(id);
+        },
+        has(id) {
+            return store.has(id);
+        },
+        list(category) {
+            const entries = Array.from(store.values());
+            if (category === undefined)
+                return entries;
+            return entries.filter((e) => e.category === category);
+        },
+        ids() {
+            return Array.from(store.keys());
+        },
+        size() {
+            return store.size;
+        },
+        reset() {
+            for (const [id, entry] of store) {
+                if (entry.builtIn !== true) {
+                    store.delete(id);
+                }
+            }
+        },
+    };
+}
+/** 快捷创建内置条目 */
+function builtInEntry(id, category, value, metadata) {
+    return { id, category, builtIn: true, value, metadata };
+}
+/** 从注册表提取所有 id 作为常量数组（给 TS 消费者用于类型推断） */
+function registryIds(registry) {
+    return registry.ids();
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/skill-manifest.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Skill Manifest — shared type definitions and runtime validation.
+ *
+ * Two manifest variants:
+ *   - BuiltinSkillManifest  : built-in skill plugins registered inside the API process.
+ *   - ExternalSkillManifest : standalone skills under skills/ with manifest.json.
+ */
+import { type RegistryEntry } from './registry.js';
+export type SkillLayer = string;
+export declare const BUILTIN_SKILL_LAYERS: RegistryEntry[];
+export declare const skillLayerRegistry: import("./registry.js").TypeRegistry<unknown>;
+export interface ExtractionHint {
+    field: string;
+    patterns?: string[];
+    position?: "remainder" | "quoted" | "after_verb";
+    defaultValue?: unknown;
+    required: boolean;
+}
+export interface SkillToolDeclaration {
+    name: string;
+    displayName?: Record<string, string>;
+    description?: Record<string, string>;
+    scope: "read" | "write";
+    resourceType: string;
+    action: string;
+    idempotencyRequired?: boolean;
+    riskLevel?: "low" | "medium" | "high";
+    approvalRequired?: boolean;
+    category?: string;
+    priority?: number;
+    tags?: string[];
+    inputSchema?: any;
+    outputSchema?: any;
+    requiredSecretScopes?: string[];
+    extraPermissions?: Array<{
+        resourceType: string;
+        action: string;
+    }>;
+    extractionHints?: ExtractionHint[];
+}
+export interface BuiltinSkillManifest {
+    identity: {
+        name: string;
+        version: string;
+    };
+    displayName?: Record<string, string>;
+    description?: Record<string, string>;
+    layer?: SkillLayer;
+    routes?: string[];
+    frontend?: string[];
+    dependencies?: string[];
+    skillDependencies?: string[];
+    tools?: SkillToolDeclaration[];
+}
+/** 推理模式 */
+export type InferenceMode = "fast" | "reasoning" | "disabled";
+/** 模型能力等级 */
+export type ModelCapabilityTier = "basic" | "standard" | "advanced" | "frontier";
+/** Skill 模型需求声明 */
+export interface SkillModelRequirements {
+    /** 最低模型能力等级（basic=轻量任务, standard=通用, advanced=复杂推理, frontier=前沿研究） */
+    minCapabilityTier: ModelCapabilityTier;
+    /** 推理模式：fast=禁用thinking快速响应, reasoning=启用深度推理, disabled=不调用模型 */
+    inferenceMode: InferenceMode;
+    /** 是否需要多模态能力（视觉/音频理解） */
+    multimodal?: boolean;
+    /** 偏好模型标识（非强制绑定，调度器可降级） */
+    preferredModel?: string;
+    /** 最大输出 token 数（约束模型生成长度） */
+    maxOutputTokens?: number;
+}
+/** 吞吐模式 */
+export type ThroughputMode = "realtime" | "streaming" | "batch";
+/** Skill 性能 SLA 声明 */
+export interface SkillPerformanceSLA {
+    /** 最大可接受延迟（ms），超过此值视为超时 */
+    maxLatencyMs: number;
+    /** P99 延迟目标（ms），用于调度优化 */
+    p99LatencyMs?: number;
+    /** 吞吐模式：realtime=毫秒级响应, streaming=流式持续输出, batch=批量离线 */
+    throughputMode: ThroughputMode;
+}
+/** 加速器类型 */
+export type AcceleratorType = "none" | "cuda" | "tensorrt" | "npu" | "mps";
+/** Skill 算力需求声明 */
+export interface SkillComputeRequirements {
+    /** 是否需要 GPU */
+    gpu: boolean;
+    /** 最小内存需求（MB） */
+    minMemoryMb?: number;
+    /** 加速器类型 */
+    accelerator?: AcceleratorType;
+    /** 是否需要本地推理（端侧部署） */
+    localInference?: boolean;
+}
+export interface ExternalSkillManifest {
+    identity: {
+        name: string;
+        version: string;
+    };
+    displayName?: Record<string, string>;
+    description?: Record<string, string>;
+    category?: string;
+    priority?: number;
+    tags?: string[];
+    dependencies?: string[];
+    contract?: {
+        scope?: string;
+        resourceType?: string;
+        action?: string;
+        idempotencyRequired?: boolean;
+        riskLevel?: string;
+        approvalRequired?: boolean;
+    };
+    io?: {
+        input?: any;
+        output?: any;
+        inputSchema?: any;
+        outputSchema?: any;
+    };
+    entry: string;
+    engines?: {
+        node?: string;
+        runtime?: string;
+    };
+    executionTimeoutMs?: number;
+    /** Skill 模型能力需求声明（Skill 声明自己需要什么级别的 AI 模型） */
+    modelRequirements?: SkillModelRequirements;
+    /** Skill 性能 SLA 声明（Skill 声明自己的延迟/吞吐承诺） */
+    performanceSLA?: SkillPerformanceSLA;
+    /** Skill 算力需求声明（Skill 声明自己需要什么硬件资源） */
+    computeRequirements?: SkillComputeRequirements;
+}
+export interface ManifestValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Validate a raw parsed manifest object (typically from manifest.json).
+ * Returns structured error list. An empty errors array means the manifest is valid.
+ */
+export declare function validateManifest(raw: unknown): ManifestValidationResult;
+//# sourceMappingURL=skill-manifest.d.ts.map

package/dist/skill-manifest.d.ts.map

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

package/dist/skill-manifest.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Skill Manifest — shared type definitions and runtime validation.
+ *
+ * Two manifest variants:
+ *   - BuiltinSkillManifest  : built-in skill plugins registered inside the API process.
+ *   - ExternalSkillManifest : standalone skills under skills/ with manifest.json.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skillLayerRegistry = exports.BUILTIN_SKILL_LAYERS = void 0;
+exports.validateManifest = validateManifest;
+const registry_js_1 = require("./registry.js");
+exports.BUILTIN_SKILL_LAYERS = [
+    (0, registry_js_1.builtInEntry)('kernel', 'skill.layer', undefined, { priority: 0, description: '运行时内核层' }),
+    (0, registry_js_1.builtInEntry)('core', 'skill.layer', undefined, { priority: 1, description: '核心能力层' }),
+    (0, registry_js_1.builtInEntry)('optional', 'skill.layer', undefined, { priority: 2, description: '可选能力层' }),
+    (0, registry_js_1.builtInEntry)('extension', 'skill.layer', undefined, { priority: 3, description: '扩展能力层/沙箱Skill层' }),
+];
+exports.skillLayerRegistry = (0, registry_js_1.createRegistry)(exports.BUILTIN_SKILL_LAYERS);
+/* ------------------------------------------------------------------ */
+/*  Runtime validation for ExternalSkillManifest                       */
+/* ------------------------------------------------------------------ */
+/** Regex: at least two dot-separated segments, each starting with a lowercase letter. */
+const NAME_PATTERN = /^[a-z][a-z0-9]*(\.[a-z][a-z0-9]*)+$/;
+/** Loose semver check: major.minor.patch with optional pre-release / build metadata. */
+const SEMVER_PATTERN = /^\d+\.\d+\.\d+(-[0-9A-Za-z.-]+)?(\+[0-9A-Za-z.-]+)?$/;
+/**
+ * Validate a raw parsed manifest object (typically from manifest.json).
+ * Returns structured error list. An empty errors array means the manifest is valid.
+ */
+function validateManifest(raw) {
+    const errors = [];
+    if (raw === null || raw === undefined || typeof raw !== "object" || Array.isArray(raw)) {
+        return { valid: false, errors: ["manifest must be a non-null object"] };
+    }
+    const obj = raw;
+    // ── identity ──────────────────────────────────────────────────────
+    if (!obj.identity || typeof obj.identity !== "object" || Array.isArray(obj.identity)) {
+        errors.push("missing or invalid required field: identity");
+    }
+    else {
+        const id = obj.identity;
+        if (typeof id.name !== "string" || !id.name) {
+            errors.push("missing required field: identity.name");
+        }
+        else if (!NAME_PATTERN.test(id.name)) {
+            errors.push(`identity.name "${id.name}" does not match required pattern (at least two dot-separated lowercase segments)`);
+        }
+        if (typeof id.version !== "string" || !id.version) {
+            errors.push("missing required field: identity.version");
+        }
+        else if (!SEMVER_PATTERN.test(id.version)) {
+            errors.push(`identity.version "${id.version}" does not look like a valid semver string`);
+        }
+    }
+    // ── entry ─────────────────────────────────────────────────────────
+    if (typeof obj.entry !== "string" || !obj.entry) {
+        errors.push("missing required field: entry");
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=skill-manifest.js.map

package/dist/skill-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-manifest.js","sourceRoot":"","sources":["../src/skill-manifest.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAqMH,4CAoCC;AAvOD,+CAAiF;AAQpE,QAAA,oBAAoB,GAAoB;IACnD,IAAA,0BAAY,EAAC,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IACxF,IAAA,0BAAY,EAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IACrF,IAAA,0BAAY,EAAC,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;IACzF,IAAA,0BAAY,EAAC,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACpG,CAAC;AAEW,QAAA,kBAAkB,GAAG,IAAA,4BAAc,EAAC,4BAAoB,CAAC,CAAC;AAiKvE,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,yFAAyF;AACzF,MAAM,YAAY,GAAG,qCAAqC,CAAC;AAE3D,wFAAwF;AACxF,MAAM,cAAc,GAAG,sDAAsD,CAAC;AAO9E;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,GAAY;IAC3C,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,oCAAoC,CAAC,EAAE,CAAC;IAC1E,CAAC;IAED,MAAM,GAAG,GAAG,GAA8B,CAAC;IAE3C,qEAAqE;IACrE,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrF,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,GAAG,GAAG,CAAC,QAAmC,CAAC;QAEnD,IAAI,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QACvD,CAAC;aAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,CAAC,IAAI,CACT,kBAAkB,EAAE,CAAC,IAAI,mFAAmF,CAC7G,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QAC1D,CAAC;aAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,OAAO,4CAA4C,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QAChD,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC"}