@snack-kit/porygon 0.6.0 → 0.8.0

package/README.md

@@ -630,6 +630,33 @@ npm run playground  # 启动 Playground
 
 ## Changelog
 
+### v0.8.0
+
+#### 改进
+
+- **`timeoutMs` 语义变更为空闲超时** — `timeoutMs` 不再表示进程的绝对超时时间，而是"空闲超时"：进程无任何输出（stdout/stderr）超过此时间才触发终止。每次收到输出会重置计时器，更适合 LLM 调用耗时不可预测的场景
+- **默认空闲超时调整** — 默认值从 `300_000`（5 分钟）调整为 `120_000`（2 分钟）
+
+#### 破坏性变更
+
+- **`timeoutMs` 语义变更** — 从绝对超时改为空闲超时（idle timeout）。如果依赖旧的绝对超时行为，需要调整使用方式。对于模型思考时间可能较长的场景，建议适当调大此值
+- **默认超时时间缩短** — 从 5 分钟缩短至 2 分钟。如需更长超时，请在 `defaults.timeoutMs` 或请求参数中显式设置
+
+---
+
+### 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
 
 #### 改进

package/dist/index.cjs

@@ -58,8 +58,8 @@ var DEFAULT_CONFIG = {
   defaultBackend: "claude",
   backends: {},
   defaults: {
-    timeoutMs: 3e5,
-    // 5 minutes
+    timeoutMs: 12e4,
+    // 空闲超时：进程无任何输出超过此时间则终止
     maxTurns: 50
   },
   proxy: void 0
@@ -295,6 +295,7 @@ var GRACE_PERIOD_MS = 5e3;
 var EphemeralProcess = class {
   childProcess = null;
   aborted = false;
+  timedOut = false;
   /**
    * 执行命令并收集输出。支持 AbortController 进行取消操作。
    * @param options 进程启动选项
@@ -316,19 +317,25 @@ var EphemeralProcess = class {
       this.childProcess = child;
       const stdoutChunks = [];
       const stderrChunks = [];
+      let timeoutTimer;
+      const resetTimeout = () => {
+        if (options.timeoutMs !== void 0 && options.timeoutMs > 0) {
+          if (timeoutTimer) clearTimeout(timeoutTimer);
+          timeoutTimer = setTimeout(() => {
+            this.terminate();
+            reject(new Error(`Process idle timed out after ${options.timeoutMs}ms`));
+          }, options.timeoutMs);
+        }
+      };
+      resetTimeout();
       child.stdout?.on("data", (chunk) => {
         stdoutChunks.push(chunk);
+        resetTimeout();
       });
       child.stderr?.on("data", (chunk) => {
         stderrChunks.push(chunk);
+        resetTimeout();
       });
-      let timeoutTimer;
-      if (options.timeoutMs !== void 0 && options.timeoutMs > 0) {
-        timeoutTimer = setTimeout(() => {
-          this.terminate();
-          reject(new Error(`Process timed out after ${options.timeoutMs}ms`));
-        }, options.timeoutMs);
-      }
       const onAbort = () => {
         this.terminate();
         reject(new Error("Process aborted"));
@@ -363,6 +370,7 @@ 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_cross_spawn.default)(options.command, options.args, {
       cwd: options.cwd,
@@ -376,11 +384,16 @@ var EphemeralProcess = class {
       });
     }
     let timeoutTimer;
-    if (options.timeoutMs !== void 0 && options.timeoutMs > 0) {
-      timeoutTimer = setTimeout(() => {
-        this.terminate();
-      }, options.timeoutMs);
-    }
+    const resetTimeout = () => {
+      if (options.timeoutMs !== void 0 && options.timeoutMs > 0) {
+        if (timeoutTimer) clearTimeout(timeoutTimer);
+        timeoutTimer = setTimeout(() => {
+          this.timedOut = true;
+          this.terminate();
+        }, options.timeoutMs);
+      }
+    };
+    resetTimeout();
     const onAbort = () => {
       this.terminate();
     };
@@ -388,6 +401,7 @@ var EphemeralProcess = class {
     const stderrChunks = [];
     child.stderr?.on("data", (chunk) => {
       stderrChunks.push(chunk);
+      resetTimeout();
     });
     let exitCode = null;
     const exitPromise = new Promise((resolve) => {
@@ -396,6 +410,9 @@ var EphemeralProcess = class {
         resolve();
       });
     });
+    child.stdout?.on("data", () => {
+      resetTimeout();
+    });
     const rl = (0, import_node_readline.createInterface)({ input: child.stdout });
     let yieldedLines = 0;
     try {
@@ -410,6 +427,9 @@ var EphemeralProcess = class {
           stderr || `Process exited with code ${exitCode}`
         );
       }
+      if (this.timedOut) {
+        throw new Error(`Process idle timed out after ${options.timeoutMs}ms`);
+      }
     } finally {
       if (timeoutTimer) clearTimeout(timeoutTimer);
       abortSignal?.removeEventListener("abort", onAbort);