feat(contracts,db): agent.plan / agent.propose_options, interaction events, proposeFirst replaces run mode

- agent_run_event gains plan_updated, options_proposed/resolved, approval_requested/resolved (migration 0040)
- AgentRunStartInput.proposeFirst; mode deprecated (plan_only maps to proposeFirst); mode dropped from AgentRun API
- POST /agent/runs/{id}/choice; agent.optionsTimeoutSec/optionsTimeoutAction/approvalTimeoutSec settings

Co-Authored-By: Claude Opus 5.5 <[email protected]>

packages/contracts/src/capability.ts

@@ -76,6 +76,8 @@ export const CAPABILITY_IDS = [
   "browser.navigate",
   "browser.interact",
   "browser.download",
+  "agent.plan",
+  "agent.propose_options",
 ] as const;
 export const KnownCapabilityId = z.enum(CAPABILITY_IDS);
 export type KnownCapabilityId = z.infer<typeof KnownCapabilityId>;
@@ -398,6 +400,31 @@ export const CAPABILITY_CATALOG: Record<KnownCapabilityId, CapabilityDescriptor>
     false,
     false,
   ),
+  // AG-2 自动化优先的会话交互:步骤清单与方案选择。只在 Agent 会话里可用(HTTP / MCP 调用直接报错)
+  "agent.plan": d(
+    "agent.plan",
+    "更新步骤清单",
+    "开始时列出 3–7 个步骤,之后每开始、完成、跳过或失败一步就更新(只传变化的步骤,按 id 合并;replace=true 整体替换)。步骤清单实时显示在会话页顶部",
+    "read",
+    "AgentPlan",
+    "read",
+    "low",
+    true,
+    false,
+  ),
+  // 类别 propose:只登记一个待用户选择的待处理事项,不产生外部副作用;等待期间会话挂起(不占 worker、不调用模型)。
+  // 与 agent.spawn 一样在注册时声明 replay=safe(恢复后重放本调用取用户的选择)
+  "agent.propose_options": d(
+    "agent.propose_options",
+    "给出方案",
+    "有明显取舍时给用户 2–3 个方案(各写摘要、风险、估算代价,标出推荐项),等用户选定后返回所选方案;用户也可以都不要并说明原因。超时按设置自动选推荐项或停止",
+    "propose",
+    "AgentProposeOptions",
+    "organize.execute",
+    "low",
+    true,
+    false,
+  ),
 };
 
 function d(