@ethisyscore/ protocol (英语)

EthysCore插件生态系统的 Canonical TypeScript 协议类型.

此软件包是 .NET 的 TypeScript 同伴 EthisysCore.Protocol NuGet软件包. 它暴露出相同的有线级合同,使得主机App Bridge和任何未来的TypeScript客户端都消耗了相同的类型.

范围(1.0)

此发布会登陆能力第一插件运行时间的基础层 :

• 插件显示 —— 说 PluginManifest, (中文(简体) ), RenderMode选择 PluginUi 子形状( n)src/manifest.ts) (中文(简体) ).
• SDUI 原始词汇 v1 —— 说 KNOWN_PRIMITIVES递归 SduiNode 计划( s)src/sdui/primitives.ts) (中文(简体) ).
• JsonLogic 运算符子集 + 反应规则类型 —— 说 KNOWN_OPERATORS, (中文(简体) ), KNOWN_RULE_KINDS, (中文(简体) ), ReactiveRule (单位:千美元)src/sdui/operators.ts) (中文(简体) ).
• 门户贡献+主机位分类 —— 说 PortalContribution, (中文(简体) ), KNOWN_SLOTS, (中文(简体) ), HostSlot (单位:千美元)src/sdui/portal.ts) (中文(简体) ).
• 主题符号 ——主机渲染器所消耗的设计接罐外形 (src/theme/tokens.ts) (中文(简体) ).
• 能力索赔 - 许可和能力交换机类型(src/capability/permissions.ts, (中文(简体) ), src/capability/token.ts) (中文(简体) ).
• 桥口版本常数 —— 说 BRIDGE_VERSION (单位:千美元)src/bridge/version.ts) (中文(简体) ).

未来的合同(参考数据、数据储存、MCP、事件、伐木、通知、运输、包装、主机召回)尚未纳入这一包——随着消费客户登陆,将添加添加这些合同.

安装

npm install @ethisyscore/protocol

脚本

npm run build       # bundle ESM + CJS + d.ts via tsup
npm test            # run vitest in CI mode
npm run test:watch  # vitest in watch mode
npm run lint        # tsc --noEmit type check

版式

• src/index.ts - 公共枪管
• src/manifest.ts — 插件显示 + 渲染模式
• src/sdui/ ——SDUI原始人,运营商,门户贡献
• src/route-template.ts —— 说 {param} contract A表面(RFC 0019)的路由模板语法: scanSurfaceRoute, (中文(简体) ), matchRoute, (中文(简体) ), substituteRouteParameters, (中文(简体) ), getRouteShape, (中文(简体) ), requiredContractVersionForSurfaces
• src/sdui/contract-a.ts - 较丰富的合同A道具(RFC 0020):每套Zod schemas,封闭列表, DATA_TABLE_QUERY_ARGUMENTS (主机发送的参数 DataTable工具,返回 a PagedResponse, (中文(简体) ), requiredContractVersionForDocument (最小插件- UI 合同版本文件需要,与 isContractVersionSupported, (中文(简体) ), isToolInNamespace (前缀+宣布的工具成员), isPluginRelativeRoute, (中文(简体) ), isContractAIcon (主像符号), CONTRACT_A_LIMITS, (中文(简体) ), validateContractADocument
• src/sdui/bindings.ts - 封闭装订集 $route.<param>, (中文(简体) ), $row.<field> (RFC 0020),只在顶级工具中识别 args 价值和 Field.defaultValue
• src/theme/ 设计符号
• src/capability/ 权限和能力要求
• src/bridge/ ——桥版常数
• src/__tests__/ - 检测
• dist/ ——建设产出(已忽略)

兼容性

将此软件包作为公共兼容边界 。 偏好添加剂改变; 不重用enum值; 不在未协调放出的情况下进行断裂JSON形状改变.

词汇表(SDUI原始语,JsonLogic运算符,活性规则类型,主机位分类学) 由记录在 docs/rfcs/README.md. CI 自动回放 PR 扩展词汇而无需接受 RFC.