@downcity/agent 1.1.22 → 1.1.25

package/bin/runtime/server/http/control/StreamBySession.d.ts

@@ -1,22 +0,0 @@
-/**
- * Control session 流式执行 helper。
- *
- * 关键点（中文）
- * - 仅用于单 agent control API 的本地 session 流式返回。
- * - chatKey 命中的平台 chat 队列仍保持原有入队语义，不在这里伪造“流式完成”。
- * - 输出协议复用 SDK `AgentSessionStreamEvent` 的 NDJSON 事件行，便于 CLI 直接消费。
- */
-import type { AgentContext } from "../../../../core/AgentContextTypes.js";
-import type { AgentRuntime } from "../../../../core/AgentCoreTypes.js";
-import type { ControlSessionExecuteAttachmentInput } from "../../../../runtime/server/http/control/types/ControlSessionExecute.js";
-/**
- * 为指定 session 创建流式执行响应。
- */
-export declare function createControlSessionStreamResponse(params: {
-    agentState: AgentRuntime;
-    executionContext: AgentContext;
-    sessionId: string;
-    instructions: string;
-    attachments?: ControlSessionExecuteAttachmentInput[];
-}): Promise<Response>;
-//# sourceMappingURL=StreamBySession.d.ts.map

package/bin/runtime/server/http/control/StreamBySession.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"StreamBySession.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/server/http/control/StreamBySession.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EACV,oCAAoC,EACrC,MAAM,8DAA8D,CAAC;AAkEtE;;GAEG;AACH,wBAAsB,kCAAkC,CAAC,MAAM,EAAE;IAC/D,UAAU,EAAE,YAAY,CAAC;IACzB,gBAAgB,EAAE,YAAY,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,oCAAoC,EAAE,CAAC;CACtD,GAAG,OAAO,CAAC,QAAQ,CAAC,CA6GpB"}

package/bin/runtime/server/http/control/StreamBySession.js

@@ -1,135 +0,0 @@
-/**
- * Control session 流式执行 helper。
- *
- * 关键点（中文）
- * - 仅用于单 agent control API 的本地 session 流式返回。
- * - chatKey 命中的平台 chat 队列仍保持原有入队语义，不在这里伪造“流式完成”。
- * - 输出协议复用 SDK `AgentSessionStreamEvent` 的 NDJSON 事件行，便于 CLI 直接消费。
- */
-import { buildExecuteInputText } from "../../../../runtime/server/http/control/Helpers.js";
-import { drainDeferredPersistedUserMessages } from "../../../../session/SessionRunScope.js";
-import { mapUiMessageChunkToSdkEvent } from "../../../../sdk/StreamEvents.js";
-import { resolveDispatchTargetByChatKey } from "../../../../service/builtins/chat/runtime/ChatkeySend.js";
-import { pickLastSuccessfulChatSendText, resolveAssistantMessageForPersistence, } from "../../../../service/builtins/chat/runtime/UserVisibleText.js";
-const NDJSON_CONTENT_TYPE = "application/x-ndjson; charset=utf-8";
-function encodeNdjsonLine(encoder, value) {
-    return encoder.encode(`${JSON.stringify(value)}\n`);
-}
-function resolveStreamEventFromUiChunk(params) {
-    const { chunk, toolNameByCallId } = params;
-    if (chunk.type === "tool-input-start") {
-        toolNameByCallId.set(chunk.toolCallId, chunk.toolName);
-        return null;
-    }
-    const event = mapUiMessageChunkToSdkEvent(chunk);
-    if (!event)
-        return null;
-    if (event.type === "tool-call" || event.type === "tool-error") {
-        toolNameByCallId.set(event.toolCallId, event.toolName);
-    }
-    if ((event.type === "tool-result" || event.type === "tool-error") &&
-        event.toolName === "unknown") {
-        const toolName = toolNameByCallId.get(event.toolCallId);
-        return toolName ? { ...event, toolName } : event;
-    }
-    return event;
-}
-/**
- * 为指定 session 创建流式执行响应。
- */
-export async function createControlSessionStreamResponse(params) {
-    const sessionId = String(params.sessionId || "").trim();
-    const instructions = String(params.instructions || "").trim();
-    if (!sessionId) {
-        return Response.json({ success: false, error: "Missing sessionId" }, { status: 400 });
-    }
-    if (!instructions) {
-        return Response.json({ success: false, error: "Missing instructions" }, { status: 400 });
-    }
-    const executeInput = await buildExecuteInputText({
-        projectRoot: params.agentState.rootPath,
-        sessionId,
-        instructions,
-        attachments: params.attachments,
-    });
-    const dispatchTarget = await resolveDispatchTargetByChatKey({
-        context: params.executionContext,
-        chatKey: sessionId,
-    });
-    if (dispatchTarget) {
-        return Response.json({
-            success: false,
-            error: "Streaming execute does not support queued chat sessions. Use the non-stream execute API for chatKey routes.",
-        }, { status: 409 });
-    }
-    const session = params.agentState.getSession(sessionId);
-    const encoder = new TextEncoder();
-    const stream = new ReadableStream({
-        start(controller) {
-            void (async () => {
-                const toolNameByCallId = new Map();
-                const pushEvent = (event) => {
-                    controller.enqueue(encodeNdjsonLine(encoder, event));
-                };
-                try {
-                    await session.appendUserMessage({
-                        text: executeInput,
-                    });
-                    const result = await session.run({
-                        query: executeInput,
-                        onUiMessageChunkCallback: async (chunk) => {
-                            const event = resolveStreamEventFromUiChunk({
-                                chunk,
-                                toolNameByCallId,
-                            });
-                            if (!event)
-                                return;
-                            pushEvent(event);
-                        },
-                    });
-                    const userVisible = pickLastSuccessfulChatSendText(result.assistantMessage).trim();
-                    try {
-                        const messageForPersistence = resolveAssistantMessageForPersistence(result.assistantMessage);
-                        if (messageForPersistence) {
-                            await session.appendAssistantMessage({
-                                message: messageForPersistence,
-                                fallbackText: userVisible,
-                                extra: {
-                                    via: "tui_session_stream",
-                                    note: "assistant_message_missing",
-                                },
-                            });
-                        }
-                        const deferredInjectedMessages = drainDeferredPersistedUserMessages(sessionId);
-                        for (const message of deferredInjectedMessages) {
-                            await session.appendUserMessage({
-                                message,
-                            });
-                        }
-                    }
-                    catch {
-                        // ignore persistence follow-up errors after stream completion
-                    }
-                }
-                catch (error) {
-                    pushEvent({
-                        type: "error",
-                        error: error instanceof Error ? error.message : String(error),
-                    });
-                }
-                finally {
-                    controller.close();
-                }
-            })();
-        },
-    });
-    return new Response(stream, {
-        status: 200,
-        headers: {
-            "Content-Type": NDJSON_CONTENT_TYPE,
-            "Cache-Control": "no-cache, no-transform",
-            "X-Accel-Buffering": "no",
-        },
-    });
-}
-//# sourceMappingURL=StreamBySession.js.map

package/bin/runtime/server/http/control/StreamBySession.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"StreamBySession.js","sourceRoot":"","sources":["../../../../../src/runtime/server/http/control/StreamBySession.ts"],"names":[],"mappings":"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"}

package/bin/sdk/AsyncQueue.d.ts

@@ -1,26 +0,0 @@
-/**
- * SDK AsyncQueue。
- *
- * 关键点（中文）
- * - 用于把 callback 风格的 stream 事件桥接成 `AsyncIterable`。
- * - 保持实现轻量，不引入额外第三方依赖。
- */
-/**
- * 极简异步队列。
- */
-export declare class AsyncQueue<T> implements AsyncIterable<T> {
-    private readonly state;
-    /**
-     * 推入一个值。
-     */
-    push(value: T): void;
-    /**
-     * 关闭队列。
-     */
-    close(): void;
-    /**
-     * 返回异步迭代器。
-     */
-    [Symbol.asyncIterator](): AsyncIterator<T>;
-}
-//# sourceMappingURL=AsyncQueue.d.ts.map

package/bin/sdk/AsyncQueue.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AsyncQueue.d.ts","sourceRoot":"","sources":["../../src/sdk/AsyncQueue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH;;GAEG;AACH,qBAAa,UAAU,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAIpB;IAEF;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAapB;;OAEG;IACH,KAAK,IAAI,IAAI;IAab;;OAEG;IACH,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC;CAqB3C"}

package/bin/sdk/AsyncQueue.js

@@ -1,75 +0,0 @@
-/**
- * SDK AsyncQueue。
- *
- * 关键点（中文）
- * - 用于把 callback 风格的 stream 事件桥接成 `AsyncIterable`。
- * - 保持实现轻量，不引入额外第三方依赖。
- */
-/**
- * 极简异步队列。
- */
-export class AsyncQueue {
-    state = {
-        values: [],
-        waiters: [],
-        closed: false,
-    };
-    /**
-     * 推入一个值。
-     */
-    push(value) {
-        if (this.state.closed)
-            return;
-        const waiter = this.state.waiters.shift();
-        if (waiter) {
-            waiter({
-                done: false,
-                value,
-            });
-            return;
-        }
-        this.state.values.push(value);
-    }
-    /**
-     * 关闭队列。
-     */
-    close() {
-        if (this.state.closed)
-            return;
-        this.state.closed = true;
-        while (this.state.waiters.length > 0) {
-            const waiter = this.state.waiters.shift();
-            if (!waiter)
-                continue;
-            waiter({
-                done: true,
-                value: undefined,
-            });
-        }
-    }
-    /**
-     * 返回异步迭代器。
-     */
-    [Symbol.asyncIterator]() {
-        return {
-            next: () => {
-                if (this.state.values.length > 0) {
-                    return Promise.resolve({
-                        done: false,
-                        value: this.state.values.shift(),
-                    });
-                }
-                if (this.state.closed) {
-                    return Promise.resolve({
-                        done: true,
-                        value: undefined,
-                    });
-                }
-                return new Promise((resolve) => {
-                    this.state.waiters.push(resolve);
-                });
-            },
-        };
-    }
-}
-//# sourceMappingURL=AsyncQueue.js.map

package/bin/sdk/AsyncQueue.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"AsyncQueue.js","sourceRoot":"","sources":["../../src/sdk/AsyncQueue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH;;GAEG;AACH,MAAM,OAAO,UAAU;IACJ,KAAK,GAAkB;QACtC,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,KAAK;KACd,CAAC;IAEF;;OAEG;IACH,IAAI,CAAC,KAAQ;QACX,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC1C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC;gBACL,IAAI,EAAE,KAAK;gBACX,KAAK;aACN,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO;QAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,MAAM,CAAC;gBACL,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,SAAc;aACtB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,CAAC,MAAM,CAAC,aAAa,CAAC;QACpB,OAAO;YACL,IAAI,EAAE,GAAG,EAAE;gBACT,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACjC,OAAO,OAAO,CAAC,OAAO,CAAC;wBACrB,IAAI,EAAE,KAAK;wBACX,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAO;qBACtC,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;oBACtB,OAAO,OAAO,CAAC,OAAO,CAAC;wBACrB,IAAI,EAAE,IAAI;wBACV,KAAK,EAAE,SAAc;qBACtB,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,IAAI,OAAO,CAAoB,CAAC,OAAO,EAAE,EAAE;oBAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACnC,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;CACF"}

package/bin/sdk/StreamEvents.d.ts

@@ -1,36 +0,0 @@
-/**
- * SDK Stream 事件映射辅助。
- *
- * 关键点（中文）
- * - 把底层 AI SDK `UIMessageChunk` 归一到 `AgentSessionStreamEvent`。
- * - 仅保留 SDK 当前需要的稳定事件，不把所有底层细节直接暴露出去。
- */
-import type { UIMessageChunk } from "ai";
-import type { AgentSessionStreamEvent } from "../sdk/AgentSdkTypes.js";
-import type { AsyncQueue } from "../sdk/AsyncQueue.js";
-/**
- * 把单个 UI chunk 映射为 SDK stream 事件。
- */
-export declare function mapUiMessageChunkToSdkEvent(chunk: UIMessageChunk): AgentSessionStreamEvent | null;
-/**
- * 把 UI chunk 推入 SDK stream 队列。
- *
- * 关键点（中文）
- * - `tool-output-*` chunk 本身不总是携带 toolName。
- * - 这里用调用 id 维护一次流式执行内的工具名称映射，避免上层重复关心底层 chunk 细节。
- */
-export declare function pushUiMessageChunkAsSdkEvent(params: {
-    /**
-     * SDK stream 事件队列。
-     */
-    queue: AsyncQueue<AgentSessionStreamEvent>;
-    /**
-     * 底层 AI SDK UI chunk。
-     */
-    chunk: UIMessageChunk;
-    /**
-     * 当前 stream 生命周期内的 toolCallId 到 toolName 映射。
-     */
-    toolNameByCallId: Map<string, string>;
-}): void;
-//# sourceMappingURL=StreamEvents.d.ts.map

package/bin/sdk/StreamEvents.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"StreamEvents.d.ts","sourceRoot":"","sources":["../../src/sdk/StreamEvents.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAEzC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAmBtD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,cAAc,GACpB,uBAAuB,GAAG,IAAI,CA4DhC;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD;;OAEG;IACH,KAAK,EAAE,UAAU,CAAC,uBAAuB,CAAC,CAAC;IAC3C;;OAEG;IACH,KAAK,EAAE,cAAc,CAAC;IACtB;;OAEG;IACH,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC,GAAG,IAAI,CAoBP"}

package/bin/sdk/StreamEvents.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"StreamEvents.js","sourceRoot":"","sources":["../../src/sdk/StreamEvents.ts"],"names":[],"mappings":"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"}

package/src/runtime/server/http/control/StreamBySession.ts

@@ -1,198 +0,0 @@
-/**
- * Control session 流式执行 helper。
- *
- * 关键点（中文）
- * - 仅用于单 agent control API 的本地 session 流式返回。
- * - chatKey 命中的平台 chat 队列仍保持原有入队语义，不在这里伪造“流式完成”。
- * - 输出协议复用 SDK `AgentSessionStreamEvent` 的 NDJSON 事件行，便于 CLI 直接消费。
- */
-
-import type { AgentContext, SessionPort } from "@/core/AgentContextTypes.js";
-import type { AgentRuntime } from "@/core/AgentCoreTypes.js";
-import type {
-  ControlSessionExecuteAttachmentInput,
-} from "@/runtime/server/http/control/types/ControlSessionExecute.js";
-import { buildExecuteInputText } from "@/runtime/server/http/control/Helpers.js";
-import { drainDeferredPersistedUserMessages } from "@session/SessionRunScope.js";
-import { mapUiMessageChunkToSdkEvent } from "@/sdk/StreamEvents.js";
-import type { AgentSessionStreamEvent } from "@/sdk/AgentSdkTypes.js";
-import type {
-  SessionRunResult,
-  SessionUiMessageChunkCallback,
-} from "@/session/types/SessionRun.js";
-import { resolveDispatchTargetByChatKey } from "@/service/builtins/chat/runtime/ChatkeySend.js";
-import {
-  pickLastSuccessfulChatSendText,
-  resolveAssistantMessageForPersistence,
-} from "@/service/builtins/chat/runtime/UserVisibleText.js";
-
-type StreamableSessionPort = SessionPort & {
-  /**
-   * 流式执行当前 session。
-   *
-   * 说明（中文）
-   * - `SessionPort` 对外接口当前未显式暴露 `onUiMessageChunkCallback`，
-   *   但本地 executor 已支持该回调，这里按本地 control runtime 语义做窄化使用。
-   */
-  run(params: {
-    query: string;
-    onUiMessageChunkCallback?: SessionUiMessageChunkCallback;
-  }): Promise<SessionRunResult>;
-};
-
-const NDJSON_CONTENT_TYPE = "application/x-ndjson; charset=utf-8";
-
-function encodeNdjsonLine(
-  encoder: TextEncoder,
-  value: AgentSessionStreamEvent,
-): Uint8Array {
-  return encoder.encode(`${JSON.stringify(value)}\n`);
-}
-
-function resolveStreamEventFromUiChunk(params: {
-  chunk: Parameters<NonNullable<SessionUiMessageChunkCallback>>[0];
-  toolNameByCallId: Map<string, string>;
-}): AgentSessionStreamEvent | null {
-  const { chunk, toolNameByCallId } = params;
-  if (chunk.type === "tool-input-start") {
-    toolNameByCallId.set(chunk.toolCallId, chunk.toolName);
-    return null;
-  }
-
-  const event = mapUiMessageChunkToSdkEvent(chunk);
-  if (!event) return null;
-
-  if (event.type === "tool-call" || event.type === "tool-error") {
-    toolNameByCallId.set(event.toolCallId, event.toolName);
-  }
-
-  if (
-    (event.type === "tool-result" || event.type === "tool-error") &&
-    event.toolName === "unknown"
-  ) {
-    const toolName = toolNameByCallId.get(event.toolCallId);
-    return toolName ? { ...event, toolName } : event;
-  }
-
-  return event;
-}
-
-/**
- * 为指定 session 创建流式执行响应。
- */
-export async function createControlSessionStreamResponse(params: {
-  agentState: AgentRuntime;
-  executionContext: AgentContext;
-  sessionId: string;
-  instructions: string;
-  attachments?: ControlSessionExecuteAttachmentInput[];
-}): Promise<Response> {
-  const sessionId = String(params.sessionId || "").trim();
-  const instructions = String(params.instructions || "").trim();
-  if (!sessionId) {
-    return Response.json({ success: false, error: "Missing sessionId" }, { status: 400 });
-  }
-  if (!instructions) {
-    return Response.json({ success: false, error: "Missing instructions" }, { status: 400 });
-  }
-
-  const executeInput = await buildExecuteInputText({
-    projectRoot: params.agentState.rootPath,
-    sessionId,
-    instructions,
-    attachments: params.attachments,
-  });
-
-  const dispatchTarget = await resolveDispatchTargetByChatKey({
-    context: params.executionContext,
-    chatKey: sessionId,
-  });
-  if (dispatchTarget) {
-    return Response.json(
-      {
-        success: false,
-        error:
-          "Streaming execute does not support queued chat sessions. Use the non-stream execute API for chatKey routes.",
-      },
-      { status: 409 },
-    );
-  }
-
-  const session = params.agentState.getSession(sessionId) as StreamableSessionPort;
-  const encoder = new TextEncoder();
-
-  const stream = new ReadableStream<Uint8Array>({
-    start(controller) {
-      void (async () => {
-        const toolNameByCallId = new Map<string, string>();
-
-        const pushEvent = (event: AgentSessionStreamEvent): void => {
-          controller.enqueue(encodeNdjsonLine(encoder, event));
-        };
-
-        try {
-          await session.appendUserMessage({
-            text: executeInput,
-          });
-
-          const result = await session.run({
-            query: executeInput,
-            onUiMessageChunkCallback: async (chunk) => {
-              const event = resolveStreamEventFromUiChunk({
-                chunk,
-                toolNameByCallId,
-              });
-              if (!event) return;
-              pushEvent(event);
-            },
-          });
-
-          const userVisible = pickLastSuccessfulChatSendText(
-            result.assistantMessage,
-          ).trim();
-          try {
-            const messageForPersistence = resolveAssistantMessageForPersistence(
-              result.assistantMessage,
-            );
-            if (messageForPersistence) {
-              await session.appendAssistantMessage({
-                message: messageForPersistence,
-                fallbackText: userVisible,
-                extra: {
-                  via: "tui_session_stream",
-                  note: "assistant_message_missing",
-                },
-              });
-            }
-            const deferredInjectedMessages = drainDeferredPersistedUserMessages(
-              sessionId,
-            );
-            for (const message of deferredInjectedMessages) {
-              await session.appendUserMessage({
-                message,
-              });
-            }
-          } catch {
-            // ignore persistence follow-up errors after stream completion
-          }
-        } catch (error) {
-          pushEvent({
-            type: "error",
-            error: error instanceof Error ? error.message : String(error),
-          });
-        } finally {
-          controller.close();
-        }
-      })();
-    },
-  });
-
-  return new Response(stream, {
-    status: 200,
-    headers: {
-      "Content-Type": NDJSON_CONTENT_TYPE,
-      "Cache-Control": "no-cache, no-transform",
-      "X-Accel-Buffering": "no",
-    },
-  });
-}

package/src/sdk/AsyncQueue.ts

@@ -1,92 +0,0 @@
-/**
- * SDK AsyncQueue。
- *
- * 关键点（中文）
- * - 用于把 callback 风格的 stream 事件桥接成 `AsyncIterable`。
- * - 保持实现轻量，不引入额外第三方依赖。
- */
-
-type QueueState<T> = {
-  /**
-   * 已入队但尚未消费的值。
-   */
-  values: T[];
-
-  /**
-   * 等待中的消费者回调。
-   */
-  waiters: Array<(result: IteratorResult<T>) => void>;
-
-  /**
-   * 队列是否已关闭。
-   */
-  closed: boolean;
-};
-
-/**
- * 极简异步队列。
- */
-export class AsyncQueue<T> implements AsyncIterable<T> {
-  private readonly state: QueueState<T> = {
-    values: [],
-    waiters: [],
-    closed: false,
-  };
-
-  /**
-   * 推入一个值。
-   */
-  push(value: T): void {
-    if (this.state.closed) return;
-    const waiter = this.state.waiters.shift();
-    if (waiter) {
-      waiter({
-        done: false,
-        value,
-      });
-      return;
-    }
-    this.state.values.push(value);
-  }
-
-  /**
-   * 关闭队列。
-   */
-  close(): void {
-    if (this.state.closed) return;
-    this.state.closed = true;
-    while (this.state.waiters.length > 0) {
-      const waiter = this.state.waiters.shift();
-      if (!waiter) continue;
-      waiter({
-        done: true,
-        value: undefined as T,
-      });
-    }
-  }
-
-  /**
-   * 返回异步迭代器。
-   */
-  [Symbol.asyncIterator](): AsyncIterator<T> {
-    return {
-      next: () => {
-        if (this.state.values.length > 0) {
-          return Promise.resolve({
-            done: false,
-            value: this.state.values.shift() as T,
-          });
-        }
-        if (this.state.closed) {
-          return Promise.resolve({
-            done: true,
-            value: undefined as T,
-          });
-        }
-        return new Promise<IteratorResult<T>>((resolve) => {
-          this.state.waiters.push(resolve);
-        });
-      },
-    };
-  }
-}