@snack-kit/porygon 0.2.0 → 0.4.0

package/README.md

@@ -551,6 +551,23 @@ npm run playground  # 启动 Playground
 
 ## Changelog
 
+### v0.4.0
+
+#### Bug Fixes
+
+- **Claude adapter**: 修复 `result` 事件中 `inputTokens` 和 `outputTokens` 始终为 0 的问题。Claude CLI 的 token 统计位于 `event.usage.input_tokens` / `event.usage.output_tokens`，而非顶层的 `event.input_tokens` / `event.output_tokens`
+- **Claude adapter**: 修复 `costUsd` 始终为 `undefined` 的问题。Claude CLI 使用 `total_cost_usd` 字段名，而非 `cost_usd`
+
+### v0.3.0
+
+#### Bug Fixes
+
+- **Claude adapter**: 将 prompt 从 CLI 参数 (`-p <prompt>`) 改为通过 stdin 传递 (`--print` + stdin pipe)，修复超长 prompt 导致的偶发 403 "Request not allowed" 错误
+
+#### 改进
+
+- `SpawnOptions` 新增 `stdinData` 字段，`EphemeralProcess.executeStreaming` 支持向子进程 stdin 写入数据
+
 ### v0.2.0
 
 #### 新特性

package/dist/index.cjs

@@ -28,6 +28,7 @@ __export(index_exports, {
   AgentTimeoutError: () => AgentTimeoutError,
   ClaudeAdapter: () => ClaudeAdapter,
   ConfigValidationError: () => ConfigValidationError,
+  InteractiveSession: () => InteractiveSession,
   InterceptorRejectedError: () => InterceptorRejectedError,
   OpenCodeAdapter: () => OpenCodeAdapter,
   Porygon: () => Porygon,
@@ -350,12 +351,18 @@ var EphemeralProcess = class {
       throw new Error("Process aborted before start");
     }
     this.aborted = false;
+    const useStdin = options.stdinData !== void 0;
     const child = (0, import_node_child_process.spawn)(options.command, options.args, {
       cwd: options.cwd,
       env: options.env ?? void 0,
-      stdio: ["ignore", "pipe", "pipe"]
+      stdio: [useStdin ? "pipe" : "ignore", "pipe", "pipe"]
     });
     this.childProcess = child;
+    if (useStdin && child.stdin) {
+      child.stdin.write(options.stdinData, () => {
+        child.stdin.end();
+      });
+    }
     let timeoutTimer;
     if (options.timeoutMs !== void 0 && options.timeoutMs > 0) {
       timeoutTimer = setTimeout(() => {
@@ -852,14 +859,15 @@ function mapClaudeEvent(event, sessionId) {
     return [];
   }
   if (isResultEvent(event)) {
+    const usage = event.usage;
     return [{
       ...baseFields,
       type: "result",
       text: event.result,
-      costUsd: event.cost_usd,
+      costUsd: event.total_cost_usd ?? event.cost_usd,
       durationMs: event.duration_ms,
-      inputTokens: event.input_tokens,
-      outputTokens: event.output_tokens
+      inputTokens: usage?.input_tokens ?? event.input_tokens,
+      outputTokens: usage?.output_tokens ?? event.output_tokens
     }];
   }
   return [];
@@ -967,7 +975,8 @@ var ClaudeAdapter = class extends AbstractAgentAdapter {
         "tool-restriction",
         "mcp",
         "subagents",
-        "worktree"
+        "worktree",
+        "interactive-session"
       ]),
       streamingMode: "chunked",
       outputFormats: ["text", "json", "stream-json"],
@@ -1000,12 +1009,14 @@ var ClaudeAdapter = class extends AbstractAgentAdapter {
           if (v) cleanEnv[k] = v;
         }
       }
+      const stdinData = this.buildStdinData(request);
       const streamOptions = {
         command: this.cliCommand,
         args,
         ...cwd ? { cwd } : {},
         env: cleanEnv,
-        timeoutMs: request.timeoutMs
+        timeoutMs: request.timeoutMs,
+        stdinData
       };
       const cmdStr = [this.cliCommand, ...args.map((a) => /[\s"']/.test(a) ? JSON.stringify(a) : a)].join(" ");
       const debugCmd = cwd ? `cd ${JSON.stringify(cwd)} && ${cmdStr}` : cmdStr;
@@ -1138,10 +1149,16 @@ var ClaudeAdapter = class extends AbstractAgentAdapter {
       env["NO_PROXY"] = noProxy;
     }
   }
+  /**
+   * 构建通过 stdin 传递给 Claude CLI 的数据。
+   * 使用 stdin 而非 CLI 参数传递 prompt，避免超长参数导致的 403 错误。
+   */
+  buildStdinData(request) {
+    return request.prompt;
+  }
   buildArgs(request) {
     const args = [
-      "-p",
-      request.prompt,
+      "--print",
       "--output-format",
       "stream-json",
       "--verbose"
@@ -1753,6 +1770,54 @@ var OpenCodeAdapter = class extends AbstractAgentAdapter {
   }
 };
 
+// src/session/interactive-session.ts
+var InteractiveSession = class {
+  initialSessionId;
+  resolvedSessionId;
+  adapter;
+  baseRequest;
+  firstSent = false;
+  closed = false;
+  constructor(initialSessionId, adapter, baseRequest) {
+    this.initialSessionId = initialSessionId;
+    this.adapter = adapter;
+    this.baseRequest = baseRequest;
+  }
+  /** 当前生效的 sessionId（首次 send 后反映 CLI 返回的真实 ID） */
+  get sessionId() {
+    return this.resolvedSessionId ?? this.initialSessionId;
+  }
+  /** 会话是否仍然活跃 */
+  get isActive() {
+    return !this.closed;
+  }
+  /**
+   * 发送一条消息，返回流式响应。
+   * 首次调用使用 initialSessionId，后续自动附加 resume。
+   */
+  async *send(prompt) {
+    if (this.closed) {
+      throw new SessionNotFoundError(this.sessionId);
+    }
+    const request = {
+      ...this.baseRequest,
+      prompt,
+      ...this.firstSent ? { resume: this.sessionId } : {}
+    };
+    for await (const msg of this.adapter.query(request)) {
+      if (!this.firstSent && msg.sessionId) {
+        this.resolvedSessionId = msg.sessionId;
+      }
+      yield msg;
+    }
+    this.firstSent = true;
+  }
+  /** 关闭会话（仅清理内部状态，无进程需要释放） */
+  close() {
+    this.closed = true;
+  }
+};
+
 // src/porygon.ts
 var Porygon = class extends import_node_events2.EventEmitter {
   config;
@@ -1852,6 +1917,21 @@ var Porygon = class extends import_node_events2.EventEmitter {
     }
     return resultText;
   }
+  /**
+   * 创建交互式多轮对话会话。
+   * 自动管理 sessionId 和 resume，对调用方透明。
+   */
+  session(options) {
+    const backend = options?.backend ?? this.config.defaultBackend ?? "claude";
+    const adapter = this.getAdapter(backend);
+    const merged = this.mergeRequest({ ...options, prompt: "" }, backend);
+    const { prompt: _, ...baseRequest } = merged;
+    return new InteractiveSession(
+      crypto.randomUUID(),
+      adapter,
+      baseRequest
+    );
+  }
   /**
    * 注册拦截器
    * @param direction 拦截方向
@@ -2100,6 +2180,7 @@ function createOutputGuard(options) {
   AgentTimeoutError,
   ClaudeAdapter,
   ConfigValidationError,
+  InteractiveSession,
   InterceptorRejectedError,
   OpenCodeAdapter,
   Porygon,