aps-agent/pnpm-workspace.yaml

# 工作区定义（任务 A1.1）。包边界与依赖方向见 docs/adr/0001 与架构设计第 2 节。
packages:
  - contracts
  - server
  - server/provider-sdk
  - client/app
  - client/desktop
  - providers/aps

# pnpm 11：允许执行安装脚本的依赖。esbuild 是 vite 的构建依赖，需要 postinstall。
allowBuilds:
  # Pi 依赖链带 postinstall；装它们是 Pi 官方推荐的接入方式（ADR-0006）
  '@google/genai': true
  esbuild: true
  protobufjs: true
-												feat(workspace): pnpm monorepo 骨架与包边界（A1.1）

六个包：@aps/contracts、@aps/provider-sdk、@aps/server、@aps/client-app、@aps/desktop、@aps/provider-aps。依赖方向 contracts <- provider-sdk <- server <- client，providers/* 只依赖 provider-sdk。TypeScript 项目引用串起构建，pnpm typecheck 全绿。server 内部按 entry/app/agent/core/workflows 建目录并写明各自不该出现什么。

											
										
										
											2026-09-23 19:29:57 +08:00
+								# 工作区定义（任务 A1.1）。包边界与依赖方向见 docs/adr/0001 与架构设计第 2 节。
 								packages:
 								  - contracts
 								  - server
 								  - server/provider-sdk
 								  - client/app
 								  - client/desktop
-												feat(client): 最小界面与单端口托管（A1.4 / A1.5）

客户端 Vite + React 三栏骨架：左会话列表、中对话流（SSE 流式）、右工作区占位与事件流观察窗；连接状态徽章；类型全部来自 @aps/contracts。服务端托管 client/app/dist，一个端口跑完整平台；pnpm dev 一键起服务端与前端，pnpm start 构建后单端口托管。实测：浏览器打开后新建会话、发消息、看到流式回复与事件流 seq 1..7；31 条测试全绿。

											
										
										
											2026-09-24 15:41:01 +08:00
+								  - providers/aps
 								# pnpm 11：允许执行安装脚本的依赖。esbuild 是 vite 的构建依赖，需要 postinstall。
 								allowBuilds:
-												feat(agent): Pi 子进程接入（A3.3）

新增 server/agent/pi/runtime.ts：用官方 RpcClient 拉起 pi --mode rpc，一个会话一个进程（ADR-0006）。启动参数带 --no-builtin-tools / --no-extensions / --no-skills / --no-context-files，Pi 自带的 read/bash/edit/write 全部关掉，工具只能来自能力目录（扩展桥在 A3.11 接）。密钥经环境变量注入子进程（不进命令行，避免进程列表泄露）；Pi 自己的 session 文件放 ~/.aps/pi-sessions 只作同引擎恢复，会话历史仍归平台。事件映射：message_update(text_delta)→text、tool_execution_start/end→tool_call/tool_result、message_end(assistant, stopReason=error)→error 并按六分类归一、agent_settled→turn_end。配置层加引擎选择：有密钥自动用 Pi、否则假引擎，可用 APS_ENGINE 覆盖；要求 Pi 但没有密钥时明确回退并告警。未配置密钥时 createSession 快速失败并给出配置指引，不再静默挂住。测试 56 → 60（59 通过 + 1 条需 APS_PI_INTEGRATION=1 的真实调用默认跳过）；用假密钥实测：401 在 340ms 内被归到 forbidden，随后正常收尾。过程中修掉自身缺陷：错误回合的 finishReason 被 turn_end 覆盖回 stop，改为取最严重结果。

											
										
										
											2026-09-28 20:21:24 +08:00
+								  # Pi 依赖链带 postinstall；装它们是 Pi 官方推荐的接入方式（ADR-0006）
 								  '@google/genai': true
 								  esbuild: true
 								  protobufjs: true