Provider Adapter

目的

Provider adapters 隔离 Codex、Claude、Cursor 和 OMP 的 hook 差异，避免这些差异进入 core retrieval engine。

目标接口

interface ProviderAdapter {
  provider: string;
  normalizeHookInput(input: unknown): NormalizedHookEvent;
  renderHookOutput(result: RetrievalResult): unknown;
  installHook?(options: HookInstallOptions): HookInstallResult;
  hookStatus?(options: HookStatusOptions): HookStatusResult;
}

Adapter 职责

• 在 provider 支持时安装并检查 hook config；
• 暴露 provider-specific hook config paths 和 trust/status notes；
• 把 provider-specific install options 映射到共享 hook runtime command；
• 永远不要实现 retrieval scoring。

Core 职责

• 规范化进入 ome hook run 的 hook payloads；
• 匹配 cards；
• 解释 scores；
• 控制 context budget；
• 写 logs；
• 计算 stats。

当前形态

Codex、Claude、Cursor 和 OMP 都使用共享 hook runtime，并通过 provider-specific hook output 注入 additional context。Adapter code 位于 packages/adapters/agents/<provider>/， 负责 install/status/uninstall。

OMP 扩展

OMP adapter 在解析后的 Agent 目录安装 extensions/ome-recall.ts。 before_agent_start 把任务交给已有 ome hook run，再将返回的 additionalContext 加入 OMP 当前回合。不修改 prompt 或 systemPrompt， 也不复制召回评分逻辑。安装、状态检查、卸载和 doctor 共用同一套目标目录解析； 参数及 profile 规则见 OMP 配置。