feat: extend AgentOptions with fork / cleanup (Phase 2a) #145

New Issue

2026-06-07T04:57:26Z

xiaoju commented

2026-06-07 04:57:26 +00:00

动机

为 step ask 做基础设施：agent 需要支持 session fork（复制 session 到新的独立副本）。

从 #142 拆出

这是 #142 Phase 2 的基础设施部分。依赖 Phase 1 (#142-P1) 先完成。

接口扩展

// util-agent/src/types.ts
type AgentForkFn = (sessionId: string, store: AgentContext["store"]) => Promise<string>;
type AgentCleanupFn = () => Promise<void>;

type AgentOptions = {
  name: string;
  run: AgentRunFn;
  continue: AgentContinueFn;
  fork: AgentForkFn | null;      // 新增
  cleanup: AgentCleanupFn | null; // 新增
};

Session cache 扩展

支持 stepHash:ask 格式的 cache key（与现有 threadId:role 共存）。

Adapter 实现

每个 adapter 补 fork: null, cleanup: null（占位，后续按需实现）：

agent-hermes
agent-claude-code
agent-builtin
agent-mock

测试要点

AgentOptions 类型兼容（有/无 fork 都能编译）
Session cache stepHash:ask key 读写
exec cache 和 ask cache 互不干扰
各 adapter fork: null 不影响现有功能

小橘 🍊（NEKO Team）

## 动机为 `step ask` 做基础设施：agent 需要支持 session fork（复制 session 到新的独立副本）。 ## 从 #142 拆出这是 #142 Phase 2 的基础设施部分。依赖 Phase 1 (#142-P1) 先完成。 ## 接口扩展 ```typescript // util-agent/src/types.ts type AgentForkFn = (sessionId: string, store: AgentContext["store"]) => Promise<string>; type AgentCleanupFn = () => Promise<void>; type AgentOptions = { name: string; run: AgentRunFn; continue: AgentContinueFn; fork: AgentForkFn | null; // 新增 cleanup: AgentCleanupFn | null; // 新增 }; ``` ## Session cache 扩展支持 `stepHash:ask` 格式的 cache key（与现有 `threadId:role` 共存）。 ## Adapter 实现每个 adapter 补 `fork: null, cleanup: null`（占位，后续按需实现）： - `agent-hermes` - `agent-claude-code` - `agent-builtin` - `agent-mock` ## 测试要点 1. `AgentOptions` 类型兼容（有/无 fork 都能编译） 2. Session cache `stepHash:ask` key 读写 3. exec cache 和 ask cache 互不干扰 4. 各 adapter `fork: null` 不影响现有功能小橘 🍊（NEKO Team）

xiaoju referenced this issue

2026-06-07 04:57:41 +00:00

feat: thread poke / step ask — post-step interaction with agent sessions #142

xiaoju referenced this issue from a commit

2026-06-07 08:26:12 +00:00

feat(util-agent): extend AgentOptions with fork / cleanup (Phase 2a)

xiaoju referenced this issue from a commit

2026-06-07 08:43:19 +00:00

feat(util-agent): extend AgentOptions with fork / cleanup (Phase 2a)

xiaoju referenced a pull request that will close this issue

2026-06-07 09:02:41 +00:00

feat(util-agent): extend AgentOptions with fork / cleanup (Phase 2a) #155