@huiliyi37/dsh-typert-registry

English | 中文

生成的 Typert 产物所用的运行时注册表。每个注册项包含某个包在一个 face 上的业务反射信息，以及可选的运行时 Zod schema；ctx.typert 会以原子方式同时注册两者，并在发起调用的 Cordis fiber 释放时一并移除它们。TypeScript 分析和代码生成由 dsh-typert-generator 负责。

包反射信息以 <package>#<face> 为键。schema 以 <package>#<name> 为键，并保留生成方的 Zod 实例。系统按需在消费方边界计算 JSON Schema。

公开 API

• TypertRegistry 是默认插件，并提供 ctx.typert。
• ctx.typert.lookups.register() 注册由业务包拥有的协议声明和默认解析器；configure() 注册由宿主组合拥有且可异步执行的解析器。两者的生命周期相互独立：配置可以先于提供方注册，卸载配置会恢复默认策略。
• ctx.typert.contexts.registerHost() 和 configureHost() 对具作用域的上下文身份采用同样的所有权划分；registerClient() 提供对应的客户端上下文绑定器。
• register(contribution) 会在提交任何内容之前拒绝格式错误的标识，以及重复的包与 face 组合键或 schema 键，随后返回 Cordis effect 提供的同一资源释放函数。
• get(key)、resolve(key) 和 list(filter?) 查询当前有效的 schema。resolve() 能区分格式错误的键、未注册的包，以及已注册但未以该名称提供 schema 的包。
• getPackage(packageName, face?) 和 listPackages(filter?) 查询生成的服务、事件和对象反射信息；默认 face 为 host。
• toJSONSchema(key, params?) 使用 z.toJSONSchema() 投影当前有效的 schema，且不缓存结果。
• typertKey() 和 typertPackageKey() 构造两种稳定的标识形式。

@huiliyi37/dsh-typert-registry/types 子路径包含注册项和记录的纯类型约定。dsh-typert-loader 会在 Loader 组合中发现并注册生成的宿主侧产物；其他组合所有者可以直接调用 ctx.typert.register()。

模型体验

无。注册表不会提供提示词、工具或会话事件；所有模型可见投影均由 cordis_inspect 等消费方负责。

KV Cache 影响

无直接影响。将反射信息放入请求的消费方负责由此产生的前缀变化。

已知限制与暂缓事项

• 注册表存储生成的反射信息，但不会合并宿主侧与客户端侧的图，也不会解析 TypeScript 引用；这些由分析器和产物输出器负责。
• schema 键不包含 face，因为宿主侧和客户端侧在不同的上下文中运行。若在同一上下文中注册来自两个 face 的同名 schema，系统会将其作为重复项拒绝。