Release v1.67.0

Author: wutongci

.gitignore

@@ -66,6 +66,9 @@ internal/exec-plans/*
 !internal/exec-plans/tauri-wrapper-command-inventory.md
 internal/roadmap/**
 !internal/roadmap/
+!internal/roadmap/coding/
+internal/roadmap/coding/**
+!internal/roadmap/coding/*.md
 !internal/roadmap/appserver/
 internal/roadmap/appserver/**
 !internal/roadmap/appserver/*.md
@@ -208,4 +211,4 @@ benchmarks/*
 !benchmarks/lime-agent-runtime/
 !benchmarks/lime-agent-runtime/**
 .tmp-smoke/
-packages/lime-cli-npm/bin/
+packages/lime-cli-npm/bin/

RELEASE_NOTES.en.md

@@ -1,50 +1,39 @@
-## Lime v1.66.0
+## Lime v1.67.0
 
 <sub>The Simplified Chinese release notes are the primary version. This English page is a companion for international readers.</sub>
 
 ### New Features
-
-- Agent App runtime now connects to the current App Server client and capability APIs, allowing standalone Agent Apps to reuse the JSON-RPC client, capability host, and runtime projection path.
-- Agent Runtime standard packages now include App Server facts, fixture replay, subagents, refs, and validation support for shared runtime, projection, and UI consumption.
-- App Server workspace / project git / session admin protocols now expose workspace update, workspace delete, project git worktree delete, and batch session archive capabilities through the current JSON-RPC path, with matching Rust protocol catalog, schema export, npm `app-server-client`, and frontend API updates.
-- App Server workspace protocol now exposes project-summary reads, and the Agent input bar can read and surface project context so workspace project summaries can participate in the main chat orchestration path.
-- Agent Chat Home and empty-state workbench now include task entry points, grouped navigation, a lightweight task panel, and localized copy resources for a more complete workspace start surface.
+- Agent Workbench v2 executable protocol core landed in the main repo: sequence verifier, runtime event pipeline, middleware / adapters, `state.delta` schemas, and projection apply now form a mechanically verifiable event chain.
+- App Server / RuntimeCore now gate events before persistence with AgentUI runtime event schema, `state.delta` schema, and sequence validation; invalid streams fail closed instead of mutating session state, turn status, or outbound notifications.
+- Runtime / Provider capability manifest and resume contract are now wired through contracts, App Server protocol, RuntimeCore, and the frontend current gateway; `capability/list` can expose runtime capabilities, and thread resume can carry a validated resume contract.
+- Agent Runtime client now supports `0..N` event fan-out, flush substrate, schema compatibility middleware, and the browser-safe sessionGateway pipeline; Claw and Agent App current event gateways consume the same pipeline output.
+- Task Center now includes a Project Shell panel and Electron / App Server project shell current command chain for start, write, resize, kill, drain events, and multi-tab terminal workflows.
 
 ### Fixes
-
-- Fixed Agent UI projection summary and subagents read-model naming so old Team Workbench terminology no longer leaks into the current model.
-- Fixed Agent App runtime page and projection bridge wiring for the current capability host / client APIs, reducing drift between standalone apps and the desktop host.
-- Fixed several state-sync issues around the input bar, tool display, workspace send runtime, and thread grouping.
-- Fixed DevBridge command policy and legacy surface catalog classification for retired command surfaces.
-- Fixed protocol drift across local data sources, processor dispatch, and client shapes for session archive, workspace deletion, and project git worktree deletion.
-
-### Improvements And Refactors
-
-- Converged the Agent Chat workbench path from old Team Workspace components, selectors, canvas runtime, and suggestion helpers onto the current subagents / workbench presentation, deleting a large amount of retired team-workspace UI surface.
-- Split `AppSidebar` into account, appearance, invite, search, session, navigation-target, and style modules, reducing single-file complexity.
-- Removed Companion API, settings card, provider overview, desktop mock, and sidebar-entry remnants from the current settings and provider surfaces.
-- Continued moving input-bar project context, team preference, project storage, and workspace selection logic into hooks and focused helpers.
-- Expanded the Agent Runtime / Agent UI npm packages with standard contracts, fixtures, projection helpers, runtime facts, and UI exports to reduce duplicated GUI and SDK implementation.
-- Continued splitting App Server processor logic into agent app, automation, gallery, gateway, MCP, media, model, project, skill, unified, voice, and workspace domain modules to reduce central dispatcher growth.
-- `packages/lime-cli-npm/bin/lime` is no longer committed as a platform-specific binary; CLI release assets continue to be built by the release pipeline.
-
-### Tests And Quality
-
-- Expanded App Server protocol catalog, workspace / project git / session admin APIs, npm `app-server-client`, Agent Runtime client, projection, UI contracts, and fixture replay regressions.
-- Updated AppSidebar, Agent Chat input bar, Home / EmptyState / task tabs, workspace scene, workspace send, settings v2, Agent App runtime page, and i18n resource tests.
-- Updated Electron SDK fixture smoke, tool-surface smoke, command-contract checks, quality-task planning, and i18n readiness reporting.
-- Updated the root app, Rust workspace, CLI npm package, Agent App runtime package, App Server client package, Agent Runtime client dependency, and lockfiles to `1.66.0`.
-- Updated app-server-client contract checks, script root governance baseline, `tsconfig.electron.json`, and `.gitignore` so generated protocol files, Electron typechecking, and script entry governance stay aligned.
+- Fixed the runtime event layer relying only on per-event schema checks without cross-event state-machine enforcement; tool/action/model/turn pairing and post-terminal execution pollution are now guarded.
+- Fixed `state.delta` patch failures so they mark hydration as stale with diagnostics instead of corrupting projection / read model state.
+- Fixed fragmented Agent Runtime pipeline wiring across App Server notifications, local publish, bridge listeners, and Agent App runtime clients, reducing inconsistent behavior for invalid streams.
+- Fixed several synchronization and regression gaps in App Sidebar recent sessions, Agent thread resume, Chat navbar, Workspace conversation scene, and Task Center tab state.
+
+### Improvements and Refactors
+- Agent Workbench roadmap advanced from v0.4 to v2.10, with v2.11 focused on projection reconciliation, tool args buffering, reasoning continuity, and external transport compatibility.
+- `@limecloud/agent-ui-contracts` now includes capability / resume contracts, sequence verifier, schema constants, and validation APIs so protocol constraints are executable contracts rather than prose-only rules.
+- `@limecloud/agent-runtime-projection` now strengthens fixture replay, read model, runtime status, subagents, and `state.delta` apply; batch and incremental projectors share the same merge semantics.
+- `@limecloud/agent-runtime-client` now centralizes event pipeline, event verifier, runtime client, and session gateway behavior, reducing duplicate GUI, SDK, and Agent App wiring.
+- App Server protocol schemas, the TypeScript app-server-client, and governance catalog now include project shell, runtime capability manifest, resume contract, and thread resume shapes.
+
+### Tests and Quality
+- Expanded targeted regression coverage for Agent UI contracts, runtime projection, runtime client, app-server-client, and Agent App current runtime, including bad-stream fail-closed behavior, fan-out / flush, capability manifest, and resume contract.
+- Expanded Rust App Server runtime / protocol / schema gate tests for event schema gate, sequence gate, `state.delta` validation, and the project shell processor path.
+- Expanded Task Center shell terminal, utility toolbar, Workspace main area, App Sidebar conversations, Chat navbar, MessageList, and streaming renderer regressions.
+- Updated the root app, Rust workspace, CLI npm package, App Server client package, Agent Runtime client dependency, and lockfiles to `1.67.0`.
+- Release version consistency passes `npm run verify:app-version`.
 
 ### Documentation
-
-- Added Agent Workbench and Subagents roadmap entries, including acceptance, iteration plan, parallel workstreams, and task board artifacts.
-- Updated Agent Runtime, Agent UI standard gap, completion audit, implementation plan, test cases, and adjacent protocol documentation.
-- Updated quality workflow, command-boundary, Playwright E2E, protocol standards map, and tech-debt tracking docs for the current workbench / subagents / App Server boundaries.
-- Updated script governance documentation for the current release, generated schema, and app-server-client contract maintenance entries.
+- Added `internal/roadmap/agentworkbench/v2.md` to capture the Workbench v2 executable protocol core, AG-UI mechanism choices, v2.0-v2.11 staged scope, and completion criteria.
+- Updated the Agent Workbench README with v2.0-v2.10 completion status, current event gateway, Rust/App Server schema + sequence enforcement, capability / resume contract, and next work.
 
 ### Other
+- This release continues to consolidate runtime facts around App Server JSON-RPC, RuntimeCore, Electron Desktop Host, current npm clients, checked-in schemas, and machine-readable guards instead of leaving protocol rules only in docs or downstream GUI projection.
 
-- This release keeps release facts centered on App Server JSON-RPC, Electron Desktop Host, current npm clients, `lime-rs/crates/**`, generated schemas, and machine-readable guards while preventing old Team Workspace, Companion, and legacy command surfaces from flowing back into the product path.
-
-**Full changes**: `v1.65.0` -> `v1.66.0`
+**Full changes**: `v1.66.0` -> `v1.67.0`

RELEASE_NOTES.md

@@ -1,42 +1,37 @@
-## Lime v1.66.0
+## Lime v1.67.0
 
 ### 新功能
-- Agent App runtime 增加 App Server current client / capability API 接入，独立 Agent App 可以复用当前 JSON-RPC 客户端、能力宿主与运行态投影。
-- Agent Runtime 标准包补齐 App Server facts、fixture replay、subagents、refs 与 validation 支持，方便外部运行态、投影层和 UI 组件消费同一组事实。
-- App Server workspace / project git / session admin 协议新增工作区更新、工作区删除、project git worktree 删除、会话批量归档等 current JSON-RPC 能力，并同步到 Rust protocol catalog、schema export、npm `app-server-client` 与前端 API。
-- App Server workspace 协议新增项目摘要读取能力，Agent 输入框增加项目上下文读取与展示能力，支持把当前工作区项目摘要带入主对话编排。
-- Agent Chat Home / 空态工作台补齐任务入口、分组导航、轻量作业面板与可本地化文案资源，为工作台主屏提供更完整的起始体验。
+- Agent Workbench v2 可执行协议内核落地到主仓：sequence verifier、runtime event pipeline、middleware / adapter、`state.delta` schema 与 projection apply 形成一条可机械校验的事件处理链。
+- App Server / RuntimeCore 在事件入库前增加 AgentUI runtime event、`state.delta` 与 sequence gate，坏流会 fail closed，不再污染 session state、turn status 或 outbound notification。
+- Runtime / Provider capability manifest 与 resume contract 进入 contracts、App Server protocol、RuntimeCore 与前端 current gateway，`capability/list` 可返回运行时能力声明，thread resume 可携带并校验 resume contract。
+- Agent Runtime client 支持 `0..N` 事件 fan-out、flush substrate、schema compatibility middleware 与 sessionGateway browser-safe pipeline，Claw / Agent App current event gateway 统一消费 pipeline 输出。
+- Task Center 增加 Project Shell 面板与 Electron / App Server project shell current 命令链，支持启动、写入、resize、kill、drain events 和多标签终端工作流。
 
 ### 修复
-- 修复 Agent UI projection summary 与 subagents read model 的命名和汇总口径，减少 Team Workbench 旧语义残留。
-- 修复 Agent App runtime 页面和投影桥接对 current capability host / client API 的接线，降低独立 App 与桌面宿主之间的协议漂移。
-- 修复输入框、工具展示、workspace send runtime 与 thread grouping 的若干状态同步问题。
-- 修复 DevBridge command policy 与 legacy surface catalog 对旧命令面的分类，避免已退场路径继续被误判为 current。
-- 修复 App Server session archive / workspace deletion / project git worktree deletion 在本地数据源、processor dispatch 与 client 形状之间的协议漂移。
+- 修复 runtime event 只做逐事件 schema 校验、缺少跨事件状态机约束的问题，覆盖 tool/action/model/turn 终态配对与终态后执行流污染。
+- 修复 `state.delta` patch 失败可能污染 projection / read model 的风险，失败时进入 stale hydration diagnostics，并保留原目标 state。
+- 修复 Agent Runtime pipeline 在 App Server notification、本地 publish、bridge listener 与 Agent App runtime client 之间的分散接线，减少坏流在不同入口表现不一致的问题。
+- 修复 App Sidebar 最近会话、Agent thread resume、Chat navbar、Workspace conversation scene 与 Task Center tab 状态的一批同步和回归覆盖缺口。
 
 ### 优化与重构
-- Agent Chat 工作台主线从旧 Team Workspace 组件、selector、canvas runtime 与 suggestion 工具收敛到 subagents / workbench current 表达，删除大批旧 team workspace UI 面。
-- `AppSidebar` 拆分为 account、appearance、invite、search、session、navigation target 与样式等子模块，显著降低单文件复杂度。
-- 下线 Companion 相关 API、设置卡片、provider overview、desktop mock 与侧边入口残留，减少旧 companion 能力对当前设置页和 provider 面的干扰。
-- 输入框项目上下文、team preference、project storage 与 workspace selection 逻辑继续向 hook / helper 分层收敛。
-- Agent Runtime / Agent UI npm 包继续补齐标准 contracts、fixtures、projection、runtime facts 与 UI exports，减少 GUI 与 SDK 的重复实现。
-- App Server processor 继续按 agent app、automation、gallery、gateway、mcp、media、model、project、skill、unified、voice、workspace 等领域模块拆分，降低中心 dispatcher 的膨胀风险。
-- `packages/lime-cli-npm/bin/lime` 不再提交平台相关二进制产物，CLI 发布产物继续由 release pipeline 构建生成。
+- Agent Workbench 路线图从 v0.4 推进到 v2.10，明确 v2.11 后续聚焦 projection reconciliation、tool args buffer、reasoning continuity 与外部 transport compatibility。
+- `@limecloud/agent-ui-contracts` 扩展 capability / resume contract、sequence verifier、schema constants 与 validation API，协议约束从文档规则收敛为可执行合同。
+- `@limecloud/agent-runtime-projection` 增强 fixture replay、read model、runtime status、subagents 与 `state.delta` apply，batch 与 incremental projector 共用同一归并语义。
+- `@limecloud/agent-runtime-client` 增强 event pipeline、event verifier、runtime client 与 session gateway，减少 GUI、SDK 与 Agent App 之间的重复接线。
+- App Server protocol schema、TypeScript app-server-client 与治理目录同步新增 project shell、runtime capability manifest、resume contract 与 thread resume 形状。
 
 ### 测试与质量
-- 扩展 App Server protocol catalog、workspace / project git / session admin API、npm `app-server-client`、Agent Runtime client、projection、UI contracts 与 fixture replay 回归。
-- 更新 AppSidebar、Agent Chat inputbar、Home / EmptyState / task tabs、workspace scene、workspace send、settings v2、Agent App runtime page 与 i18n 资源相关测试。
-- 更新 Electron SDK fixture smoke、tool surface smoke、command contract 检查、质量任务规划与 i18n readiness 报告。
-- 根应用、Rust workspace、CLI npm package、Agent App runtime package、App Server client package、Agent Runtime client 依赖与锁文件版本统一更新到 `1.66.0`。
-- 更新 app-server-client contract 检查、script root governance baseline、`tsconfig.electron.json` 与 `.gitignore`，保证生成协议、Electron 类型检查和脚本入口治理保持一致。
+- 扩展 Agent UI contracts、runtime projection、runtime client、app-server-client 与 Agent App current runtime 的定向回归，覆盖 bad stream fail-closed、fan-out / flush、capability manifest 与 resume contract。
+- 扩展 Rust App Server runtime / protocol / schema gate 测试，覆盖 event schema gate、sequence gate、`state.delta` 校验和 project shell processor 路径。
+- 扩展 Task Center shell terminal、utility toolbar、Workspace main area、App Sidebar conversations、Chat navbar、MessageList 与 streaming renderer 回归。
+- 根应用、Rust workspace、CLI npm package、App Server client package、Agent Runtime client 依赖与锁文件版本统一更新到 `1.67.0`。
+- 发布版本一致性通过 `npm run verify:app-version` 校验。
 
 ### 文档
-- 新增 Agent Workbench 与 Subagents 路线图入口，补充 acceptance、iteration plan、parallel workstreams 与 task board。
-- 更新 Agent Runtime、Agent UI 标准落差、completion audit、implementation plan、test cases 与 adjacent protocols 文档。
-- 更新工程质量、命令边界、Playwright E2E、协议标准地图与技术债追踪文档，记录当前 workbench / subagents / App Server 主线边界。
-- 更新脚本治理说明，记录当前 release / generated schema / app-server-client contract 的维护入口。
+- 新增 `internal/roadmap/agentworkbench/v2.md`，记录 Workbench v2 可执行协议内核、AG-UI 机制取舍、v2.0-v2.11 分阶段范围与完成判定。
+- 更新 Agent Workbench README，登记 v2.0-v2.10 完成状态、current event gateway、Rust/App Server schema + sequence enforcement、capability / resume contract 与后续下一刀。
 
 ### 其他
-- 本版继续把发布事实源收敛到 App Server JSON-RPC、Electron Desktop Host、current npm clients、`lime-rs/crates/**`、生成 schema 与机器可读守卫，避免旧 Team Workspace、Companion 和 legacy command 面回流。
+- 本版继续把运行时事实源收敛到 App Server JSON-RPC、RuntimeCore、Electron Desktop Host、current npm clients、checked-in schema 与机器可读守卫，避免协议规则只停留在文档或 GUI 下游投影层。
 
-**完整变更**: `v1.65.0` -> `v1.66.0`
+**完整变更**: `v1.66.0` -> `v1.67.0`

electron/appServerHost.ts

@@ -29,7 +29,10 @@ const DEFAULT_APP_SERVER_REQUEST_TIMEOUT_MS = 30_000;
 const APP_SERVER_BACKEND_TIMEOUT_GRACE_MS = 30_000;
 const APP_SERVER_TURN_START_METHOD = "agentSession/turn/start";
 const APP_SERVER_AGENT_APP_UI_RUNTIME_START_METHOD = "agentAppUiRuntime/start";
+const APP_SERVER_PROJECT_SHELL_DRAIN_EVENTS_METHOD =
+  "projectShell/session/drainEvents";
 const APP_SERVER_AGENT_APP_UI_RUNTIME_START_TIMEOUT_MS = 60_000;
+const APP_SERVER_PROJECT_SHELL_DRAIN_EVENTS_TIMEOUT_MS = 3_000;
 const APP_SERVER_STREAMING_TURN_ACK_GRACE_MS = 250;
 const APP_SERVER_PROXY_REQUEST_ID_PREFIX = "electron-host";
 
@@ -461,6 +464,9 @@ function resolveAppServerRequestTimeoutMs(method: string): number {
   if (method === APP_SERVER_AGENT_APP_UI_RUNTIME_START_METHOD) {
     return APP_SERVER_AGENT_APP_UI_RUNTIME_START_TIMEOUT_MS;
   }
+  if (method === APP_SERVER_PROJECT_SHELL_DRAIN_EVENTS_METHOD) {
+    return APP_SERVER_PROJECT_SHELL_DRAIN_EVENTS_TIMEOUT_MS;
+  }
   if (method !== APP_SERVER_TURN_START_METHOD) {
     return DEFAULT_APP_SERVER_REQUEST_TIMEOUT_MS;
   }