@alan512/experienceengine 0.1.3 → 0.2.0

package/README.zh-CN.md

@@ -1,59 +1,128 @@
 # ExperienceEngine
 
-[English README](./README.md)
+[English README](./README.md) | 简体中文
 
-ExperienceEngine 是一个面向编程 Agent 的本地经验介入层。
+ExperienceEngine 是一个面向编程 Agent 的治理层。它复用真实执行经验，但不会把 memory 变成噪声堆积。它只会在相关时注入简短、任务相关的 guidance，并持续记录这次介入到底是帮到了还是干扰了结果。
 
-它会从真实编码任务中学习简短、任务相关的经验，在后续相似任务中决定是否注入这些经验，并记录这次介入到底是帮到了还是干扰了结果。
+**Memory 做加法，ExperienceEngine 做治理。**
+
+当前支持的宿主：`OpenClaw`、`Claude Code`、`Codex`
+
+## 10 秒理解
+
+没有 ExperienceEngine：
+- agent 会在相似仓库里重复犯同样的 SQLite migration 错误
+
+有 ExperienceEngine：
+- 它会注入一条提示，例如：`先执行 migration，再打开数据库连接`
+- 后续你可以把这次介入标记为 `helpful` 或 `harmful`
+- 这条经验会据此进入 active、降温或退役
+
+```text
+任务信号 -> 提炼经验 -> 检索 -> 短提示注入 -> 反馈 -> 治理
+```
+
+<details>
+<summary>宿主里的示例对话</summary>
+
+```text
+用户：修一下这个仓库里的 SQLite 启动失败问题。
+
+ExperienceEngine：
+  Hint: 先执行 migration，再打开数据库连接。
+
+宿主 agent：
+  我会先补 migration，然后再重试启动。
+
+用户：
+  为什么这条 ExperienceEngine 提示会命中？
+
+宿主 agent：
+  它匹配到了这个仓库里过去一次相同的 SQLite 启动失败，以及当时成功的 migration-first 修复路径。
+
+用户：
+  把刚才那次 ExperienceEngine 介入标记为 helpful。
+
+宿主 agent：
+  已记录。之后遇到类似任务时，这条经验会更容易再次命中。
+```
+
+</details>
+
+![`ee inspect --last --verbose` 示例输出](./docs/assets/readme/inspect-last-example.svg)
+
+## 快速开始
+
+最快的宿主安装路径：
 
-当前支持的宿主：
 - `OpenClaw`
-- `Claude Code`
+  - `openclaw plugins install @alan512/experienceengine`
+  - `openclaw gateway restart`
+  - `ee init`
 - `Codex`
+  - `ee install codex`
+  - `ee init`
+- `Claude Code`
+  - `/plugin marketplace add https://github.com/Alan-512/ExperienceEngine.git`
+  - `/plugin install experienceengine@experienceengine`
+  - `ee init`
 
-OpenClaw 兼容要求：
-- 需要本机已经有可正常工作的 OpenClaw，并且支持原生插件安装
-- 下面的 OpenClaw 安装路径默认要求 `openclaw plugins install` 和 `openclaw gateway restart` 可用
-- 发布包要求 Node.js `>=20`
+`ee init` 用于在宿主安装完成后初始化共享的 ExperienceEngine 状态。
+
+如果你需要更详细的宿主安装说明、fallback 路径、ready 状态说明或 operator 工作流，跳转到 [完整安装与运维说明](#完整安装与运维说明)。
+
+## 适合谁用
 
-## 它解决的问题
+以下情况适合使用 ExperienceEngine：
+- 你会在相似仓库或相似工作流里反复使用 coding agent
+- 你想要的是**短小、介入式 guidance**，而不是泛化的 memory recall
+- 你关心历史经验到底是**帮到了还是害了**
+- 你希望过时 guidance 能自动降温或退役，而不是越积越多
 
-Coding agent 会重复踩同类坑，通常不是因为模型不够聪明，而是因为它缺少**可治理的经验积累机制**。
+以下情况不适合：
+- 你只想要一个个人笔记型 memory
+- 你想要通用文档 RAG
+- 你的工作流几乎不重复
+- 你希望系统默认记住所有东西
 
-常见问题是：
-- 上一轮任务的教训，在新会话里直接丢失
-- memory 会一直加，但通常不会主动退役低价值内容
-- 记住的东西越来越多，context 越来越重，agent 的注意力反而被稀释
+## 宿主支持矩阵
 
-ExperienceEngine 处理的正是这一层问题。它不试图记住一切，而是专门治理：
-- 什么时候该让历史经验介入
-- 该注入哪条 `strategy` 或 `warning`
-- 这次介入到底有没有帮到任务
-- 这条经验是否应该继续保留、降温或退役
+| 宿主 | 安装路径 | 日常交互 | 成熟度 |
+|---|---|---|---|
+| `OpenClaw` | 原生插件安装 | 宿主原生 | 当前最完整 |
+| `Claude Code` | marketplace 插件，保留 `ee install claude-code` fallback | MCP + plugin hooks | 已支持 |
+| `Codex` | `ee install codex`，保留原生 MCP fallback | MCP 原生 | 已支持 |
 
-**Memory 做加法，EE 做治理。**
+## 为什么要做这个
 
-## 它和 Memory 的区别
+Coding agent 会重复犯同类错误，通常不是因为模型不够聪明，而是因为之前的执行经验没有被**以可治理的方式**复用。
+
+ExperienceEngine 的目标不是通用 memory 累积，而是**介入治理**。
+
+## 为什么不是 Memory / RAG
 
 | 问题 | Memory 系统 | ExperienceEngine |
 |---|---|---|
-| 跨会话保留事实和偏好 | ✅ | 不是核心目标 |
-| 记录失败 → 修复 → 成功的经验路径 | 部分解决，通常依赖手工记录 | ✅ 来自真实任务信号 |
-| 知道某次注入到底有没有帮助 | ❌ 通常没有 | ✅ 有 helped / harmed 追踪 |
-| 自动退役过时或有害经验 | ❌ 通常没有 | ✅ 有 cooling / retired 生命周期 |
-| 把注入控制在短小、任务相关的 guidance | 不是核心目标 | ✅ 是核心设计 |
+| 跨会话保存事实和偏好 | 可以 | 不是核心目标 |
+| 捕获失败 -> 修复 -> 成功的经验路径 | 部分支持，通常依赖人工 | 可以，来自真实任务信号 |
+| 知道一条回忆到底有没有帮助 | 通常不行 | 可以，逐次记录 |
+| 自动退役过时或有害 guidance | 通常不行 | 可以，内建 cooling / retired 生命周期 |
+| 保持提示短小、任务相关 | 不是核心目标 | 是 |
+| 通用文档检索 | 常见适用场景 | 不是核心目标 |
 
 ## 它在 Agent Loop 里的位置
 
+从高层看，ExperienceEngine 围绕 agent loop 的位置是这样的：
+
 ```text
 用户任务
   -> before_prompt_build：检索并注入匹配经验
-  -> agent 推理 + 工具调用：捕获失败、重试、纠正和结果
+  -> agent 推理 + 工具调用：捕获失败、重试、修正和结果
   -> task finalize：把候选信号提炼成可复用经验
   -> helped / harmed：提升、降温或退役节点
 ```
 
-ExperienceEngine 工作在 context 层，不会去修改宿主模型权重。
+ExperienceEngine 工作在 context 层，不会修改宿主模型权重。
 
 ## 经验生命周期
 
@@ -65,44 +134,77 @@ ExperienceEngine 工作在 context 层，不会去修改宿主模型权重。
   -> retired
 ```
 
-每条经验都依赖真实任务结果来演化，而不是简单按时间清理。帮到任务的经验会被强化，反复有害的经验会被降温或退役。
+每条经验都根据真实任务结果演化，而不是按时间粗暴清理。帮到任务的经验会被强化，反复有害的经验会被降温或退役。
+
+## 现在能做什么
+
+- 在相似编码任务里复用短 guidance
+- 查看某条 hint 为什么命中
+- 把最近一次介入标记为 helpful 或 harmful
+- 查看 active、cooling、retired 等生命周期状态
+- 在 `OpenClaw`、`Claude Code`、`Codex` 三个宿主中使用
 
-## 当前已经能用什么
+### 底层实现
 
-当前仓库已经实现并可用：
-- `OpenClaw`、`Claude Code`、`Codex` 三个宿主接入
-- MCP 原生交互面，以及 CLI / 运维 fallback
-- API-first 语义检索与平滑回退：
-  - OpenAI `text-embedding-3-small`
-  - Gemini `gemini-embedding-001`
-  - Jina `jina-embeddings-v3`
-  - 受管本地 embedding fallback
-  - legacy hash-based fallback
-- 通过宿主 agent 直接查看和反馈经验，并保留 CLI fallback：
-  - `ee inspect --last`
-  - `ee helped`
-  - `ee harmed`
+- MCP 原生交互面，加上 CLI / operator fallback
+- 支持 API 与本地回退的语义检索
+- 宿主 agent 内可直接查看和反馈经验，CLI fallback 包括 `ee inspect --last`、`ee helped`、`ee harmed`
 
-如果你想看更细的 ExperienceNode 结构和治理字段，见：
+如果你想看 ExperienceNode 结构和治理字段，见：
 
 - [Experience Model Overview](./docs/development/experience-model.md)
 
-## 快速开始
+## 当前状态
+
+- Stable：核心经验生命周期、inspect/helped/harmed loop、宿主集成、CLI/operator fallback
+- 当前最顺滑的路径：`OpenClaw` 原生插件安装
+- 仍在演进：retrieval 调优、provider 策略、更高级的宿主 UX
+- 如果你想最快拿到第一份顺滑体验，建议先从 `OpenClaw` 开始
+
+## 什么叫第一次真正成功
+
+安装并初始化后，第一次真正体现价值的信号通常是：
+
+- ExperienceEngine 在真实任务里注入了一条短 hint
+- 宿主能解释为什么这条 hint 会命中
+- 你对最近一次介入的反馈，会影响后续复用
+- `ee inspect --last` 能看到最近的介入和相关节点状态
+
+## 前置条件
+
+安装宿主前，请先确认对应宿主 CLI 已能在当前机器正常工作：
+
+- `openclaw`
+- `claude`
+- `codex`
+
+**ExperienceEngine 不会替你安装这些宿主 CLI。** 它只会接入一个已经可用的宿主环境。
+
+OpenClaw 说明：
+- 需要本机已有可正常工作的 OpenClaw，且支持原生插件安装
+- 下面的 OpenClaw 路径默认要求 `openclaw plugins install` 和 `openclaw gateway restart` 可用
+
+通用包要求：
+- 发布包要求 Node.js `>=20`
 
-ExperienceEngine 现在采用**宿主侧安装优先**。
+## 完整安装与运维说明
 
-也就是说，第一步安装命令属于你要使用的宿主，而不是 `ee` CLI。
+### 按宿主安装
+
+ExperienceEngine 现在不再把 `ee` CLI 当成适用于所有宿主的统一首要安装入口。
+
+请先从宿主自己的安装路径接入：
 
 - `OpenClaw`
   - 宿主原生插件安装：
     - `openclaw plugins install @alan512/experienceengine`
-  - 安装后先重启 OpenClaw gateway，再开始真实任务：
+  - 安装后，在开始真实任务前先重启 gateway：
     - `openclaw gateway restart`
 - `Codex`
   - EE 托管安装：
     - `ee install codex`
   - 原生 / 手工 fallback：
-    - `codex mcp add experienceengine --env EXPERIENCE_ENGINE_HOME=$HOME/.experienceengine -- npx -y @alan512/experienceengine codex-mcp-server`
+    - 如果你需要直接 MCP wiring，可参考后面的高级示例
   - 无论走哪条路径，首次接入后都建议在仓库里开启一个新的 Codex 会话，让 MCP 配置和 `AGENTS.md` 指令块生效
 - `Claude Code`
   - 宿主原生 marketplace 安装：
@@ -110,34 +212,33 @@ ExperienceEngine 现在采用**宿主侧安装优先**。
     - `/plugin marketplace add https://github.com/Alan-512/ExperienceEngine.git`
   - 再安装插件：
     - `/plugin install experienceengine@experienceengine`
-  - 如果你需要显式 hooks + MCP wiring，仍可用：
+  - 如果你需要显式 hooks + MCP wiring，仍可使用：
     - `ee install claude-code`
   - 安装后建议开启一个新的 Claude Code 会话，让插件 hooks 和 bundled MCP 配置生效
 
-宿主安装完成后，普通用户应继续直接和宿主 agent 交互。
+无论哪个宿主，整体流程都是一样的：
 
-例如你可以直接问宿主 agent：
+1. 通过宿主路径安装 ExperienceEngine
+2. 执行一次 `ee init` 初始化共享状态
+3. 重启或新开宿主会话，直到仓库变成 `Ready`
+4. 日常检查和反馈优先留在宿主内部完成
+5. 需要验证、修复或深度排障时，再退回 `ee` CLI
 
-- “ExperienceEngine 刚刚注入了什么？”
-- “显示最近一次 ExperienceEngine 介入。”
-- “把刚才那次 ExperienceEngine 提示标记为 helpful。”
+### 共享初始化
 
-只有在需要显式运维、排障或高级调试时，再使用：
+`ee init` 属于 ExperienceEngine 的共享初始化，不是某个宿主自己的安装步骤。
 
-```bash
-ee init
-ee doctor <openclaw|claude-code|codex>
-ee status
-ee maintenance embedding-smoke
-```
-
-这里的 `ee init` 属于 ExperienceEngine 的**共享初始化**，不是某个宿主自己的安装步骤。
-
-- 第一次把 EE 接到任意一个宿主后，做一次初始化即可。它会统一引导你配置：
+- 第一次接入任意宿主后执行一次，用来配置：
   - distillation provider / model / auth
   - embedding 模式 / provider
   - 共享 provider secret
-- 之后再安装新的宿主，会复用同一个 EE 数据目录、配置和共享 secret。
+- 后续再接入其他宿主，会复用同一个 ExperienceEngine home、配置和共享 secret
+
+安装完成后，ExperienceEngine 应该把用户引导到下一步状态：
+
+- 如果宿主 wiring 已完成，产品至少是 `Installed`
+- 执行完 `ee init` 后，进入 `Initialized`
+- 宿主或仓库完成 reload 并能开始真实任务后，进入 `Ready`
 
 最小共享初始化示例：
 
@@ -150,42 +251,63 @@ ee init show
 
 如果你更想用 Gemini 或 Jina 做 embedding，可以沿用同样的 `ee init embedding` 流程，只替换 provider 和 model。
 
-## 前置条件
+### 日常使用与 Operator 使用
 
-在安装任一宿主前，请先确认对应宿主 CLI 已经能在当前机器正常工作：
+日常使用时，优先直接问宿主 agent，例如：
 
-- `openclaw`
-- `claude`
-- `codex`
+- “ExperienceEngine 刚刚注入了什么？”
+- “为什么那条 ExperienceEngine 提示会命中？”
+- “把刚才那次 ExperienceEngine 介入标记为 helpful 或 harmful。”
 
-ExperienceEngine 不会替你安装这些宿主 CLI。它只负责把自己接入一个已经可用的宿主环境。
+OpenClaw 还支持这些 readiness / silence 问题：
 
-## 安装模型
+- “ExperienceEngine 这里 ready 了吗？”
+- “这个仓库里的 ExperienceEngine 还在 warming up 吗？”
+- “刚才为什么 ExperienceEngine 没有注入？”
 
-ExperienceEngine 现在把“安装”和“运维”明确分开：
+对于 `OpenClaw`、`Codex`、`Claude Code`，常规 review / feedback 路径都应优先留在宿主内部完成。
+只有宿主侧路径不可用，或者你需要显式 operator 控制时，再退回 CLI。
 
-- 安装属于宿主
-- 验证、修复、状态查看属于 `ee`
+当你需要显式运维、验证或排障时，可以用：
 
-这意味着：
+```bash
+ee init
+ee doctor <openclaw|claude-code|codex>
+ee status
+ee maintenance embedding-smoke
+```
 
-- `Codex` 走共享 ExperienceEngine MCP 服务，首次接入优先使用 `ee install codex`
-- `Claude Code` 走 Claude 原生插件资产与 marketplace 分发
-- `OpenClaw` 走 plugin/runtime 集成
+### Ready 与 Value 状态
 
-一旦安装完成，宿主 agent 仍然是主交互面。
+ExperienceEngine 把 onboarding 和 value 拆成两层：
 
-`ee` CLI 主要负责：
+- `Setup state`
+  - `Installed`
+  - `Initialized`
+  - `Ready`
+- `Value state`
+  - `Warming up`
+  - `First value reached`
 
-- 共享 provider/model 初始化
-- 健康检查
-- 修复建议
-- 状态查看
-- 学习与介入反馈
+这不是一条严格线性阶梯。一个仓库可以已经 `Ready`，但还处于 `Warming up`。
 
-## 高级按宿主命令
+`First value reached` 只应该在真实任务里已经出现可见价值时才成立。仅仅显示 onboarding 文案或 warm-up 提示，不算 first value。
 
-如果你是运维者、开发者，或者想显式控制某个宿主，仍然可以使用：
+## 安装模型
+
+ExperienceEngine 明确拆分：
+- 宿主安装
+- 共享初始化
+- operator 工作流
+
+宿主仍然是主交互面。
+`ee` 仍然是显式的 operator 面，用于 setup、验证、修复、状态查看和维护。
+
+## 高级按宿主命令（仅限 Operator / 开发者）
+
+大多数用户可以跳过这一节，直接使用上面的宿主安装路径。
+
+如果你是运维者、开发者，或者确实想显式控制某个宿主，仍可使用：
 
 ```bash
 ee install openclaw
@@ -193,12 +315,23 @@ ee install claude-code
 ee install codex
 ```
 
-这些命令仍然有效，但它们更适合作为：
-- 运维 fallback
-- 显式修复
-- 产品开发期调试
+<details>
+<summary>Codex 原生 / 手工 MCP fallback 示例</summary>
+
+```bash
+codex mcp add experienceengine --env EXPERIENCE_ENGINE_HOME=$HOME/.experienceengine -- npx -y @alan512/experienceengine codex-mcp-server
+```
+
+</details>
+
+说明：
+- `OpenClaw` 走 plugin/runtime integration，而不是 `src/adapters/`
+- `Claude Code` 会安装 hooks 和共享 ExperienceEngine MCP 服务
+- `Codex` 会安装共享 ExperienceEngine MCP 服务
+- `ee install ...` 与 `ee doctor ...` 会在 `npm` / `pnpm` 使用非官方 registry 时给出提示，因为受管模型下载在 `https://registry.npmjs.org` 下最稳定
+- 成功执行 `ee install ...` 后，也会提醒冷启动预期：capture 会立刻开始，但 formal experience 一般需要在同一仓库里出现几次相似任务后才会形成
 
-而不是默认公开安装路径。
+这些命令属于 operator fallback，不是默认公开安装路径。
 
 ## 数据目录
 
@@ -220,10 +353,7 @@ ee install codex
 当前默认行为：
 
 - `embeddingProvider = "api"`
-- provider 优先级：
-  - 设置了 `OPENAI_API_KEY` 时优先 OpenAI
-  - 设置了 `GEMINI_API_KEY` 时使用 Gemini
-  - 设置了 `JINA_API_KEY` 时使用 Jina
+- provider 优先级：OpenAI -> Gemini -> Jina
 - 如果没有任何 API provider 可用，会自动回退到受管本地 embedding
 
 常用环境变量：

package/dist/adapters/claude-code/session-store.d.ts

@@ -12,4 +12,5 @@ export declare const loadClaudeSession: (sessionId: string, options?: SessionSto
 export declare const rememberClaudePromptContext: (context: HostPromptContext, options?: SessionStoreOptions) => void;
 export declare const appendClaudeToolResult: (result: HostToolResult, options?: SessionStoreOptions) => void;
 export declare const clearClaudeSession: (sessionId: string, options?: SessionStoreOptions) => void;
+export declare const findClaudeSessionByCwd: (cwd: string, options?: SessionStoreOptions) => ClaudeStoredSession | null;
 export {};

package/dist/adapters/claude-code/session-store.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { resolveExperienceEnginePaths, resolveProductStateDir } from "../../config/path-resolver.js";
 const sanitizeSessionId = (sessionId) => sessionId.replace(/[^a-zA-Z0-9_.-]+/g, "_");
@@ -11,6 +11,15 @@ const resolveSessionDir = (options = {}) => {
     return join(resolveProductStateDir(paths), "sessions");
 };
 const resolveSessionPath = (sessionId, options = {}) => join(resolveSessionDir(options), `${sanitizeSessionId(sessionId)}.json`);
+const listClaudeSessionPaths = (options = {}) => {
+    const dir = resolveSessionDir(options);
+    if (!existsSync(dir)) {
+        return [];
+    }
+    return readdirSync(dir)
+        .filter((entry) => entry.endsWith(".json"))
+        .map((entry) => join(dir, entry));
+};
 export const loadClaudeSession = (sessionId, options = {}) => {
     const filePath = resolveSessionPath(sessionId, options);
     if (!existsSync(filePath)) {
@@ -53,4 +62,18 @@ export const clearClaudeSession = (sessionId, options = {}) => {
     const filePath = resolveSessionPath(sessionId, options);
     rmSync(filePath, { force: true });
 };
+export const findClaudeSessionByCwd = (cwd, options = {}) => {
+    const matches = listClaudeSessionPaths(options)
+        .map((filePath) => ({
+        filePath,
+        mtimeMs: statSync(filePath).mtimeMs,
+        session: JSON.parse(readFileSync(filePath, "utf8"))
+    }))
+        .filter((entry) => entry.session.promptContext?.cwd === cwd)
+        .sort((left, right) => right.mtimeMs - left.mtimeMs);
+    if (matches.length !== 1) {
+        return null;
+    }
+    return matches[0]?.session ?? null;
+};
 //# sourceMappingURL=session-store.js.map

package/dist/adapters/claude-code/session-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../../src/adapters/claude-code/session-store.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../../src/adapters/claude-code/session-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC5G,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAcrG,MAAM,iBAAiB,GAAG,CAAC,SAAiB,EAAU,EAAE,CACtD,SAAS,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;AAE9C,MAAM,iBAAiB,GAAG,CAAC,UAA+B,EAAE,EAAU,EAAE;IACtE,MAAM,KAAK,GAAG,4BAA4B,CAAC;QACzC,OAAO,EAAE,aAAa;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG;QAC/B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC;AACzD,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,SAAiB,EAAE,UAA+B,EAAE,EAAU,EAAE,CAC1F,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,GAAG,iBAAiB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAE3E,MAAM,sBAAsB,GAAG,CAAC,UAA+B,EAAE,EAAY,EAAE;IAC7E,MAAM,GAAG,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,WAAW,CAAC,GAAG,CAAC;SACpB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;SAC1C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AACtC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,SAAiB,EACjB,UAA+B,EAAE,EACL,EAAE;IAC9B,MAAM,QAAQ,GAAG,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAwB,CAAC;AAC3E,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,CAAC,OAA4B,EAAE,UAA+B,EAAE,EAAQ,EAAE;IACnG,MAAM,GAAG,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACvC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,aAAa,CAAC,kBAAkB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACjH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,OAA0B,EAC1B,UAA+B,EAAE,EAC3B,EAAE;IACR,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACpC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI;QACvD,SAAS;QACT,WAAW,EAAE,EAAE;KAChB,CAAC;IAEF,kBAAkB,CAChB;QACE,GAAG,OAAO;QACV,aAAa,EAAE,OAAO;KACvB,EACD,OAAO,CACR,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,MAAsB,EACtB,UAA+B,EAAE,EAC3B,EAAE;IACR,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACnC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI;QACvD,SAAS;QACT,WAAW,EAAE,EAAE;KAChB,CAAC;IAEF,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,SAAiB,EAAE,UAA+B,EAAE,EAAQ,EAAE;IAC/F,MAAM,QAAQ,GAAG,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxD,MAAM,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,GAAW,EACX,UAA+B,EAAE,EACL,EAAE;IAC9B,MAAM,OAAO,GAAG,sBAAsB,CAAC,OAAO,CAAC;SAC5C,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClB,QAAQ;QACR,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO;QACnC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAwB;KAC3E,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,KAAK,GAAG,CAAC;SAC3D,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAEvD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC;AACrC,CAAC,CAAC"}

package/dist/adapters/codex/action-registry.d.ts

@@ -0,0 +1,84 @@
+import { z } from "zod";
+import type { ExperienceNodeType, ExperienceState } from "../../types/domain.js";
+export type CodexActionCategory = "inspect" | "state" | "admin" | "maintenance";
+export type CodexActionRiskLevel = "low" | "medium" | "high";
+export type CodexActionDefinition = {
+    id: string;
+    title: string;
+    summary: string;
+    category: CodexActionCategory;
+    riskLevel: CodexActionRiskLevel;
+    requiresConfirmation: boolean;
+    inputSchema?: z.ZodTypeAny;
+    examplePayload?: Record<string, unknown>;
+    handler: (args: Record<string, unknown>) => Promise<unknown>;
+};
+type RegistryDeps = {
+    interactionSurface: {
+        inspectRecent: (args?: {
+            mode?: "all" | "injected";
+            limit?: number;
+        }) => Promise<unknown>;
+        inspectNode: (args: {
+            nodeId: string;
+        }) => Promise<unknown>;
+        listNodesByState: (args: {
+            state: ExperienceState;
+        }) => Promise<unknown>;
+        listNodesByType: (args: {
+            nodeType: ExperienceNodeType;
+        }) => Promise<unknown>;
+        inspectLearningSummary: () => Promise<unknown>;
+        coolNode: (args: {
+            nodeId: string;
+        }) => Promise<unknown>;
+        retireNode: (args: {
+            nodeId: string;
+        }) => Promise<unknown>;
+        feedbackNode: (args: {
+            nodeId: string;
+            feedback: "helped" | "harmed";
+        }) => Promise<unknown>;
+        disableScope: (args?: {
+            cwd?: string;
+        }) => Promise<unknown>;
+        enableScope: (args?: {
+            cwd?: string;
+        }) => Promise<unknown>;
+    };
+    operationalSurface: {
+        checkUpdate: (adapter: "openclaw" | "claude-code" | "codex") => Promise<unknown>;
+    };
+    operationalActions: {
+        planOperation: (args: {
+            adapter: "openclaw" | "claude-code" | "codex";
+            operation: "install" | "repair" | "upgrade";
+        }) => unknown;
+        executePlannedOperation: (args: {
+            planId: string;
+            confirmationToken: string;
+        }) => unknown;
+    };
+    stateArtifacts: {
+        listBackups: () => unknown;
+        planOperation: (args: {
+            operation: "backup" | "export";
+        } | {
+            operation: "import";
+            importPath: string;
+        } | {
+            operation: "rollback";
+            backupId: string;
+        }) => unknown;
+        executePlannedOperation: (args: {
+            planId: string;
+            confirmationToken: string;
+        }) => unknown;
+    };
+};
+export type CodexActionRegistry = ReturnType<typeof createCodexActionRegistry>;
+export declare const createCodexActionRegistry: (deps: RegistryDeps) => {
+    list: () => CodexActionDefinition[];
+    get: (id: string) => CodexActionDefinition | undefined;
+};
+export {};