@snack-kit/porygon 0.5.0 → 0.7.0

package/README.md

@@ -630,6 +630,32 @@ npm run playground  # 启动 Playground
 
 ## Changelog
 
+### v0.7.0
+
+#### 新特性
+
+- **`InteractiveSession` 多轮对话封装** — 新增 `InteractiveSession` 类，封装 per-turn spawn + `--resume` 模式，提供透明的多轮对话体验。通过 `porygon.session()` 创建，调用 `session.send(prompt)` 自动管理 sessionId 续接
+- **`EphemeralProcess` 超时错误明确化** — 进程超时终止后抛出明确的 `Process timed out after ${timeoutMs}ms` 错误，替代之前模糊的退出码错误信息
+
+#### 改进
+
+- `EphemeralProcess` 内部新增 `timedOut` 状态标记，区分正常退出与超时终止场景
+
+---
+
+### v0.6.0
+
+#### 改进
+
+- **Windows 跨平台兼容** — 使用 `cross-spawn` 替换原生 `child_process.spawn`，解决 Windows 上因 PATH 解析、PATHEXT 扩展名（`.exe`、`.cmd` 等）导致的 `ENOENT` 错误。所有进程启动（`EphemeralProcess`、`PersistentProcess`）均已适配
+- **`isAvailable()` Windows 适配** — Claude adapter 的 CLI 存在性检测在 Windows 上使用 `where` 命令替代 `which`
+
+#### 新增依赖
+
+- `cross-spawn` — Node.js 生态标准的跨平台进程启动库，正确处理 Windows 上的命令解析、参数转义和 PATHEXT 查找
+
+---
+
 ### v0.5.0
 
 #### 新特性

package/dist/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -278,13 +288,14 @@ var InterceptorManager = class {
 };
 
 // src/process/process-handle.ts
-var import_node_child_process = require("child_process");
+var import_cross_spawn = __toESM(require("cross-spawn"), 1);
 var import_node_events = require("events");
 var import_node_readline = require("readline");
 var GRACE_PERIOD_MS = 5e3;
 var EphemeralProcess = class {
   childProcess = null;
   aborted = false;
+  timedOut = false;
   /**
    * 执行命令并收集输出。支持 AbortController 进行取消操作。
    * @param options 进程启动选项
@@ -298,7 +309,7 @@ var EphemeralProcess = class {
         return;
       }
       this.aborted = false;
-      const child = (0, import_node_child_process.spawn)(options.command, options.args, {
+      const child = (0, import_cross_spawn.default)(options.command, options.args, {
         cwd: options.cwd,
         env: options.env ? { ...process.env, ...options.env } : void 0,
         stdio: ["pipe", "pipe", "pipe"]
@@ -353,8 +364,9 @@ var EphemeralProcess = class {
       throw new Error("Process aborted before start");
     }
     this.aborted = false;
+    this.timedOut = false;
     const useStdin = options.stdinData !== void 0;
-    const child = (0, import_node_child_process.spawn)(options.command, options.args, {
+    const child = (0, import_cross_spawn.default)(options.command, options.args, {
       cwd: options.cwd,
       env: options.env ?? void 0,
       stdio: [useStdin ? "pipe" : "ignore", "pipe", "pipe"]
@@ -368,6 +380,7 @@ var EphemeralProcess = class {
     let timeoutTimer;
     if (options.timeoutMs !== void 0 && options.timeoutMs > 0) {
       timeoutTimer = setTimeout(() => {
+        this.timedOut = true;
         this.terminate();
       }, options.timeoutMs);
     }
@@ -400,6 +413,9 @@ var EphemeralProcess = class {
           stderr || `Process exited with code ${exitCode}`
         );
       }
+      if (this.timedOut) {
+        throw new Error(`Process timed out after ${options.timeoutMs}ms`);
+      }
     } finally {
       if (timeoutTimer) clearTimeout(timeoutTimer);
       abortSignal?.removeEventListener("abort", onAbort);
@@ -437,7 +453,7 @@ var PersistentProcess = class extends import_node_events.EventEmitter {
   /** 启动持久进程 */
   async start() {
     this.stopped = false;
-    const child = (0, import_node_child_process.spawn)(this.options.command, this.options.args, {
+    const child = (0, import_cross_spawn.default)(this.options.command, this.options.args, {
       cwd: this.options.cwd,
       env: this.options.env ? { ...process.env, ...this.options.env } : void 0,
       stdio: ["pipe", "pipe", "pipe"]
@@ -939,8 +955,9 @@ var ClaudeAdapter = class extends AbstractAgentAdapter {
   async isAvailable() {
     try {
       const proc = new EphemeralProcess();
+      const findCmd = process.platform === "win32" ? "where" : "which";
       const result = await proc.execute({
-        command: "which",
+        command: findCmd,
         args: [this.cliCommand]
       });
       return result.exitCode === 0;