@iflow-ai/iflow-cli-sdk 0.2.1-beta.8 → 0.2.2

package/CHANGELOG.md

@@ -7,29 +7,25 @@
 
 ---
 
-## [Unreleased]
+## [0.2.2] - 2026-03-11
 
 ### 新增能力
-- **stdio 传输模式**：
-  - 新增 `TransportMode.STDIO` 传输模式，支持通过标准输入输出与 iFlow CLI 通信
-  - 新增 `StdioTransport` 类，实现基于 stdio 的消息传输
-  - 新增 `ITransport` 接口，统一 WebSocket 和 stdio 两种传输方式
-  - 配置选项新增 `transportMode` 参数，可选择 `websocket` 或 `stdio` 模式
-  - stdio 模式提供更低延迟和更简单的架构，特别适合本地开发和测试
-- **示例代码**：
-  - 新增 `examples/stdio-mode.ts` - stdio 模式基本用法示例
-  - 新增 `examples/compare-transports.ts` - 对比两种传输模式的示例
+- **stdio 传输模式**：新增 `stdio` 传输模式，通过配置 `transportMode: 'stdio'` 即可使用。相比 WebSocket 模式，stdio 模式延迟更低、架构更简单，适合本地开发和测试场景
+- **自定义可执行文件路径**：新增 `iflowPath` 配置项，支持指定自定义的 iFlow CLI 路径，不再强制依赖系统 PATH
+- **会话手动管理**：支持在连接时跳过自动创建会话（`skipSession`），并通过 `newSession()` 方法手动创建会话，提供更灵活的会话生命周期控制
+- **获取会话 ID**：新增 `getSessionId()` 方法，可随时获取当前会话 ID
+- **退出计划模式支持附加理由**：`respondToExitPlanMode()` 方法新增可选的 `reason` 参数，可在审批时提供理由说明
+- **超时时间可配置**：所有协议层操作（初始化、认证、创建会话等）的超时时间现在统一使用 `timeout` 配置项（默认 30 秒），不再硬编码
 
 ### 优化
-- **连接性能优化**：
-  - 优化 WebSocket 连接检测逻辑，检测到已有进程时直接复用测试连接，避免重复建立连接
-  - 减少约 50% 的连接建立时间（已有进程场景）
-  - 添加连接超时和关闭超时的文档说明和常量定义
-  - 改进测试连接失败时的资源清理逻辑，添加超时保护防止阻塞
-  - 调整日志级别，测试连接失败使用 debug 级别而非 info 级别
-
-### 文档
-- 新增 `STDIO_TRANSPORT.md` - stdio 传输模式完整文档
+- **连接速度提升**：优化已有进程场景下的连接流程，复用测试连接避免重复建立，连接耗时减少约 50%
+- **启动检测加速**：优化进程启动检测机制，优先通过日志监听判断就绪状态，响应更快
+- **连接稳定性增强**：改进连接检测的错误处理和资源管理，避免误导性的超时错误
+
+### Bug 修复
+- 修复连接外部 URL 时 WebSocket 地址为空导致的连接失败
+- 修复加载已有会话时配置参数未正确传递的问题
+- 修复工具标签未正确更新的显示问题
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iflow-ai/iflow-cli-sdk",
-  "version": "0.2.1-beta.8",
+  "version": "0.2.2",
   "description": "TypeScript SDK for iFlow CLI",
   "type": "module",
   "main": "dist/index.cjs",