simple-ai-sdk 1.0.15 → 1.0.17

package/dist/client/manager.d.ts

@@ -3,6 +3,10 @@ import type { Message, JSONValue } from "../shared/index.js";
 export interface IStreamManager {
     subscribe(listener: StreamManagerListener): () => void;
     getSnapshot(): StreamManagerState;
+    /**
+     * セッション情報を読み取り専用で取得する。
+     * - 状態参照のためのユーティリティ（副作用は発生しない）。
+     */
     getSession(sessionId: string): ChatSession | undefined;
     initSession(sessionId: string, initialMessages?: Message[]): void;
     /**
@@ -11,10 +15,6 @@ export interface IStreamManager {
      * - コンポーネントがアンマウントされても保持され、完了時に呼ばれる。
      */
     setOnFinishHandler(sessionId: string, handler: ((messages: Message[]) => void) | undefined): void;
-    /**
-     * セッション単位で最新の onMetadata ハンドラを登録する。
-     */
-    setOnMetadataHandler(sessionId: string, handler: ((metadata: Record<string, JSONValue>) => void) | undefined): void;
     /**
      * セッション単位で最新の onError ハンドラを登録する。
      */
@@ -32,7 +32,6 @@ export interface IStreamManager {
      * レンダリング中に呼ばれる可能性があるため、通知は行わない。
      */
     touchSession(sessionId: string): void;
-    updateSession(sessionId: string, updates: Partial<ChatSession>): void;
     streamChat(sessionId: string, messages: Message[], options: {
         api: string;
         body?: Record<string, JSONValue>;
@@ -61,20 +60,17 @@ declare class StreamManager implements IStreamManager {
     private rafFallbackTimer;
     private getRAF;
     private getCAF;
-    private pendingCloneSessions;
     private maxSessions;
     private debug;
     private ttlMs?;
     private sweepTimer;
     private activeSubscribers;
     private latestOnFinish;
-    private latestOnMetadata;
     private latestOnError;
     private streamIds;
     constructor(options?: StreamManagerOptions);
     subscribe(listener: StreamManagerListener): () => void;
     setOnFinishHandler(sessionId: string, handler: ((messages: Message[]) => void) | undefined): void;
-    setOnMetadataHandler(sessionId: string, handler: ((metadata: Record<string, JSONValue>) => void) | undefined): void;
     setOnErrorHandler(sessionId: string, handler: ((error: Error) => void) | undefined): void;
     getSnapshot(): StreamManagerState;
     private notify;
@@ -83,9 +79,22 @@ declare class StreamManager implements IStreamManager {
     initSession(sessionId: string, initialMessages?: Message[]): void;
     retainSession(sessionId: string): void;
     releaseSession(sessionId: string): void;
+    /**
+     * LRU に従いセッションを1件削除する。
+     * - 第一候補: 非ストリーミング（ready/error/aborted）かつ購読者なし
+     * - 第二候補: 非ストリーミング（購読者有無は問わない）
+     * - 進行中（submitted/streaming）は破棄しない（ユーザー操作中断の回避）
+     * @returns 削除が行われた場合は true、候補が無い場合は false
+     */
     private removeOldestSession;
     private logSessionInfo;
-    updateSession(sessionId: string, updates: Partial<ChatSession>, immediate?: boolean): void;
+    /**
+     * セッションの部分更新（内部専用）
+     * - 参照の安定性を保ちながら、Map の再生成により変更を通知する
+     * - important: messages を更新した場合、messagesVersion をインクリメント
+     * - immediate=true の場合、rAF をバイパスして即時通知（ステータス変更等のUX向上）
+     */
+    private updateSession;
     streamChat(sessionId: string, messages: Message[], options: {
         api: string;
         body?: Record<string, JSONValue>;

package/dist/client/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/client/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAI7D,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAAC;IACvD,WAAW,IAAI,kBAAkB,CAAC;IAClC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IACvD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAClE;;;;OAIG;IACH,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,GAAG,SAAS,GACnD,IAAI,CAAC;IACR;;OAEG;IACH,oBAAoB,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,GACnE,IAAI,CAAC;IACR;;OAEG;IACH,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,SAAS,GAC5C,IAAI,CAAC;IACR;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IACtE,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;KAClC,GACA,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,cAAM,aAAc,YAAW,cAAc;IAC3C,OAAO,CAAC,KAAK,CAEX;IAEF,OAAO,CAAC,SAAS,CAAoC;IAGrD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,gBAAgB,CAA8C;IAEtE,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,oBAAoB,CAAqB;IACjD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,UAAU,CAA+C;IAEjE,OAAO,CAAC,iBAAiB,CAA6B;IAEtD,OAAO,CAAC,cAAc,CAAoD;IAE1E,OAAO,CAAC,gBAAgB,CAGpB;IAEJ,OAAO,CAAC,aAAa,CAA6C;IAElE,OAAO,CAAC,SAAS,CAA6B;gBAElC,OAAO,GAAE,oBAAyB;IAoB9C,SAAS,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;IAOtD,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,GAAG,SAAS;IAStD,oBAAoB,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS;IAStE,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,SAAS;IAW/C,WAAW,IAAI,kBAAkB;IAMjC,OAAO,CAAC,MAAM;IAuDd,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAUtD,YAAY,CAAC,SAAS,EAAE,MAAM;IAO9B,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,GAAE,OAAO,EAAO;IA4C9D,aAAa,CAAC,SAAS,EAAE,MAAM;IAqB/B,cAAc,CAAC,SAAS,EAAE,MAAM;IAahC,OAAO,CAAC,mBAAmB;IAmD3B,OAAO,CAAC,cAAc;IAmBtB,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,EAC7B,SAAS,UAAQ;IAiCb,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;KAClC;IA4UH,UAAU,CAAC,SAAS,EAAE,MAAM;IAgB5B;;OAEG;IACH,OAAO,CAAC,YAAY;IAqCpB;;;OAGG;IACH,OAAO,IAAI,IAAI;CAiChB;AAGD,OAAO,EAAE,aAAa,EAAE,CAAC;AAIzB,eAAO,MAAM,aAAa,EAAE,cAAoC,CAAC"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/client/manager.ts"],"names":[],"mappings":"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"}

package/dist/client/manager.js

@@ -12,6 +12,20 @@ class StreamManager {
     rafFallbackTimer = null;
     // Typed accessors for rAF/cAF without relying on DOM types
     getRAF() {
+        // If the page is hidden, avoid rAF because it can be throttled heavily
+        try {
+            if (typeof window !== "undefined" &&
+                typeof document !== "undefined" &&
+                // visibilityState can be missing in some environments
+                typeof document.visibilityState ===
+                    "string" &&
+                document.visibilityState === "hidden") {
+                return undefined;
+            }
+        }
+        catch {
+            // ignore detection errors and fall through
+        }
         const g = globalThis;
         return typeof g.requestAnimationFrame === "function"
             ? g.requestAnimationFrame
@@ -23,9 +37,6 @@ class StreamManager {
             ? g.cancelAnimationFrame
             : undefined;
     }
-    // 1フレーム内での messages 配列クローンをセッション単位で一度に抑制するためのフラグ
-    // 意図: チャンクが高頻度で到着するケースで、配列コピーをフレームあたり1回に抑える
-    pendingCloneSessions = new Set();
     maxSessions;
     debug;
     ttlMs;
@@ -34,8 +45,6 @@ class StreamManager {
     activeSubscribers = new Map();
     // セッション単位で「最新の onFinish」を保持（常に最新を呼びたい要件に対応）
     latestOnFinish = new Map();
-    // セッション単位で「最新の onMetadata」を保持
-    latestOnMetadata = new Map();
     // セッション単位で「最新の onError」を保持
     latestOnError = new Map();
     // 意図: 各セッションの最新ストリームIDを保持し、古いストリームの遅延イベントを無視する
@@ -72,14 +81,6 @@ class StreamManager {
             this.latestOnFinish.delete(sessionId);
         }
     }
-    setOnMetadataHandler(sessionId, handler) {
-        if (handler) {
-            this.latestOnMetadata.set(sessionId, handler);
-        }
-        else {
-            this.latestOnMetadata.delete(sessionId);
-        }
-    }
     setOnErrorHandler(sessionId, handler) {
         if (handler) {
             this.latestOnError.set(sessionId, handler);
@@ -121,9 +122,16 @@ class StreamManager {
                 this.rafFallbackTimer = null;
             }
             this.rafScheduled = false;
-            this.listeners.forEach((listener) => listener());
-            // 即時通知時はクローン抑制フラグをクリア（次フレームに持ち越さない）
-            this.pendingCloneSessions.clear();
+            this.listeners.forEach((listener) => {
+                try {
+                    listener();
+                }
+                catch (err) {
+                    // 重要: 1つの購読者の例外で全体の通知が止まらないように防御
+                    if (this.debug)
+                        console.warn("[SM] listener error (immediate)", err);
+                }
+            });
         }
         else {
             // ストリーミング中の頻繁な更新は rAF で 1 フレームにまとめる
@@ -135,9 +143,15 @@ class StreamManager {
                 this.rafId = raf(() => {
                     this.rafId = null;
                     this.rafScheduled = false;
-                    this.listeners.forEach((listener) => listener());
-                    // フレームの終わりでクローン抑制フラグをクリア
-                    this.pendingCloneSessions.clear();
+                    this.listeners.forEach((listener) => {
+                        try {
+                            listener();
+                        }
+                        catch (err) {
+                            if (this.debug)
+                                console.warn("[SM] listener error (rAF)", err);
+                        }
+                    });
                 });
             }
             else {
@@ -145,20 +159,23 @@ class StreamManager {
                 this.rafFallbackTimer = setTimeout(() => {
                     this.rafFallbackTimer = null;
                     this.rafScheduled = false;
-                    this.listeners.forEach((listener) => listener());
-                    // Fallbackでもフレーム相当のタイミングでクリア
-                    this.pendingCloneSessions.clear();
+                    this.listeners.forEach((listener) => {
+                        try {
+                            listener();
+                        }
+                        catch (err) {
+                            if (this.debug)
+                                console.warn("[SM] listener error (timer)", err);
+                        }
+                    });
                 }, 16);
             }
         }
     }
     getSession(sessionId) {
-        const session = this.state.sessions.get(sessionId);
-        if (session) {
-            // Update last accessed time when getting a session
-            session.lastAccessed = Date.now();
-        }
-        return session;
+        // 読み取り専用: lastAccessed を更新しない
+        // （アクセス時間の更新は touchSession() 側で明示的に実施するポリシー）
+        return this.state.sessions.get(sessionId);
     }
     // LRU 用に最終アクセス時刻のみを更新する（通知はしない）
     touchSession(sessionId) {
@@ -171,7 +188,8 @@ class StreamManager {
         const existingSession = this.state.sessions.get(sessionId);
         // streaming中のセッションが存在する場合は、initialMessagesで上書きしない
         if (existingSession) {
-            if (existingSession.status === "streaming" || existingSession.status === "submitted") {
+            if (existingSession.status === "streaming" ||
+                existingSession.status === "submitted") {
                 if (this.debug) {
                     console.log(`[SM] Skip initialMessages for streaming session: ${sessionId}`);
                 }
@@ -182,11 +200,20 @@ class StreamManager {
         }
         // Check if we need to remove old sessions
         if (this.state.sessions.size >= this.maxSessions) {
-            this.removeOldestSession();
+            // 進行中（submitted/streaming）のセッションは破棄しないポリシー
+            // それ以外の候補が見つからない場合は新規セッションの生成を見送る
+            const removed = this.removeOldestSession();
+            if (!removed) {
+                if (this.debug) {
+                    console.warn(`[SM] Reached maxSessions; no eligible session to evict. Skipping init for: ${sessionId}`);
+                }
+                return;
+            }
         }
         this.state.sessions.set(sessionId, {
             id: sessionId,
             messages: initialMessages,
+            metadata: [],
             messagesVersion: 0,
             status: "ready",
             error: null,
@@ -196,7 +223,7 @@ class StreamManager {
         if (this.debug) {
             this.logSessionInfo(`Session added: ${sessionId}`);
         }
-        this.notify(true); // Immediate for initialization
+        this.notify(true); // 即時に通知（初期化はUX上重要）
         if (this.debug)
             console.log("[SM] init sessions", this.state.sessions, this.activeSubscribers);
     }
@@ -207,18 +234,6 @@ class StreamManager {
         if (this.debug) {
             console.info(`[SM] retainSession: ${sessionId} -> ${next}`);
         }
-        // 修正意図（日本語）:
-        // - 0→1 に購読者数が増えた直後は、これまで抑制されていたストリーミング更新を
-        //   即座に UI に反映させたいケースがある。
-        // - そこで、対象セッションが streaming/submitted の場合に限り、即時通知を一度だけ行う。
-        //   （注意: 現在の useChatSession 実装では retain が subscribe より先に呼ばれるため、
-        //    この通知は新規購読者より前に発生することがある。将来の呼び出し順や他の購読者に対しては有効。）
-        if (next === 1) {
-            const s = this.state.sessions.get(sessionId);
-            if (s && (s.status === "streaming" || s.status === "submitted")) {
-                this.notify(true);
-            }
-        }
     }
     releaseSession(sessionId) {
         const prev = this.activeSubscribers.get(sessionId) ?? 0;
@@ -233,6 +248,13 @@ class StreamManager {
             console.info(`[SM] releaseSession: ${sessionId} -> ${next}`);
         }
     }
+    /**
+     * LRU に従いセッションを1件削除する。
+     * - 第一候補: 非ストリーミング（ready/error/aborted）かつ購読者なし
+     * - 第二候補: 非ストリーミング（購読者有無は問わない）
+     * - 進行中（submitted/streaming）は破棄しない（ユーザー操作中断の回避）
+     * @returns 削除が行われた場合は true、候補が無い場合は false
+     */
     removeOldestSession() {
         let oldestSessionId = null;
         let oldestTime = Date.now();
@@ -248,10 +270,12 @@ class StreamManager {
                 }
             }
         }
-        // 上で見つからない場合は、状態・購読を問わず最古を探す（上限を強制的に守るため）
+        // 上で見つからない場合は、「非ストリーミング限定」で最古を探す
         if (!oldestSessionId) {
             for (const [id, session] of this.state.sessions) {
-                if (session.lastAccessed < oldestTime) {
+                if (session.status !== "streaming" &&
+                    session.status !== "submitted" &&
+                    session.lastAccessed < oldestTime) {
                     oldestTime = session.lastAccessed;
                     oldestSessionId = id;
                 }
@@ -266,14 +290,15 @@ class StreamManager {
             this.state.sessions.delete(oldestSessionId);
             // セッション破棄時はハンドラも破棄
             this.latestOnFinish.delete(oldestSessionId);
-            this.latestOnMetadata.delete(oldestSessionId);
             this.latestOnError.delete(oldestSessionId);
             // 意図: streamId も破棄してメモリリーク・誤判定を防止
             this.streamIds.delete(oldestSessionId);
             if (this.debug) {
                 this.logSessionInfo(`Session removed: ${oldestSessionId} (LRU eviction)`);
             }
+            return true;
         }
+        return false;
     }
     logSessionInfo(action) {
         const sessionInfo = Array.from(this.state.sessions.entries()).map(([id, session]) => ({
@@ -290,6 +315,12 @@ class StreamManager {
             sessions: sessionInfo,
         });
     }
+    /**
+     * セッションの部分更新（内部専用）
+     * - 参照の安定性を保ちながら、Map の再生成により変更を通知する
+     * - important: messages を更新した場合、messagesVersion をインクリメント
+     * - immediate=true の場合、rAF をバイパスして即時通知（ステータス変更等のUX向上）
+     */
     updateSession(sessionId, updates, immediate = false) {
         const session = this.state.sessions.get(sessionId);
         if (session) {
@@ -305,25 +336,25 @@ class StreamManager {
                 // messages が指定されたタイミングでのみバージョンを進める
                 session.messagesVersion = (session.messagesVersion ?? 0) + 1;
             }
-            // 再レンダリング抑制: 購読者が0のセッションに対する
-            // ストリーミング由来の message 更新では通知しない。
-            // （onFinish/onError等のイベントは immediate=true で通知される）
             if (immediate) {
                 this.notify(true);
             }
             else {
-                const subCount = this.activeSubscribers.get(sessionId) ?? 0;
-                if (subCount > 0) {
-                    this.notify(false);
-                }
-                else if (this.debug) {
-                    // デバッグ時は抑制されたことをログ
-                    console.info(`[SM] notify suppressed (no subscribers): ${sessionId}`);
-                }
+                // 常に rAF バッチで通知（購読者数による抑制は行わない）
+                this.notify(false);
             }
         }
     }
     async streamChat(sessionId, messages, options) {
+        const isObject = (v) => typeof v === "object" && v !== null;
+        const isChunkPayload = (v) => isObject(v) &&
+            (typeof v.text === "undefined" ||
+                typeof v.text === "string") &&
+            (typeof v.meta === "undefined" ||
+                Array.isArray(v.meta));
+        const isErrorPayload = (v) => isObject(v) &&
+            (typeof v.message === "undefined" ||
+                typeof v.message === "string");
         const session = this.state.sessions.get(sessionId);
         if (!session) {
             if (this.debug)
@@ -350,6 +381,8 @@ class StreamManager {
             status: "submitted",
             error: null,
             abortController,
+            // 新規ストリーム開始時にメタデータはリセット（current stream のみ保持）
+            metadata: [],
         }, true); // Immediate for status change
         try {
             const requestBody = {
@@ -366,13 +399,13 @@ class StreamManager {
             });
             // HTTP レベルのエラーハンドリング：SSE 解析に入る前に早期失敗
             if (!response.ok) {
-                let message = `HTTP ${response.status}`;
+                let message;
                 try {
-                    const text = await response.text();
-                    message += text ? `: ${text}` : "";
+                    message = await response.text();
                 }
                 catch (err) {
                     console.warn("[SM] response.text() error", err);
+                    message = `Unknown error: ${response.status}`;
                 }
                 const err = new Error(message);
                 this.updateSession(sessionId, {
@@ -422,7 +455,7 @@ class StreamManager {
                 if (dataLines.length === 0 && !eventName)
                     return;
                 const dataStr = dataLines.join("\n");
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                // JSON を安全にパース（失敗時は null）
                 let parsed;
                 try {
                     parsed = dataStr ? JSON.parse(dataStr) : null;
@@ -433,57 +466,43 @@ class StreamManager {
                 }
                 switch (eventName) {
                     case "chunk": {
-                        if (parsed && typeof parsed.text === "string") {
+                        if (parsed && isChunkPayload(parsed)) {
                             const latestId = this.streamIds.get(sessionId);
                             if (latestId !== streamId)
                                 return; // 中断済みのストリームからの遅延イベントを破棄
-                            // NOTE: 連結は O(n^2) 化を避ける最適化余地がある（必要ならバッファ化）
-                            assistantMessage.content += parsed.text;
-                            const subCount = this.activeSubscribers.get(sessionId) ?? 0;
-                            if (subCount > 0) {
-                                // フレームあたり1回だけ配列参照を更新
-                                if (!this.pendingCloneSessions.has(sessionId)) {
-                                    this.pendingCloneSessions.add(sessionId);
-                                    this.updateSession(sessionId, {
-                                        messages: [...updatedMessages],
-                                    }); // rAFバッチで通知
+                            // Handle text delta if provided
+                            if (typeof parsed.text === "string" && parsed.text.length > 0) {
+                                // NOTE: 連結は O(n^2) 化を避ける最適化余地がある（必要ならバッファ化）
+                                const wasEmpty = assistantMessage.content.length === 0;
+                                assistantMessage.content += parsed.text;
+                                // 最初のテキストチャンクは即時反映して初動レイテンシを下げる
+                                if (wasEmpty) {
+                                    this.updateSession(sessionId, { messages: [...updatedMessages] }, true);
                                 }
                                 else {
-                                    // 2回目以降は配列複製せず、rAFでの通知に任せる
-                                    // ここでは何もしない（不要なノーティファイを避ける）
+                                    // 以降は rAF バッチで配列参照を更新
+                                    this.updateSession(sessionId, {
+                                        messages: [...updatedMessages],
+                                    });
                                 }
                             }
-                            else if (this.debug) {
-                                console.info(`[SM] chunk suppressed (no subscribers): ${sessionId}`);
-                            }
-                        }
-                        break;
-                    }
-                    case "fullContent": {
-                        if (parsed && parsed.type === "replace" && typeof parsed.content === "string") {
-                            const latestId = this.streamIds.get(sessionId);
-                            if (latestId !== streamId)
-                                return; // 中断済みのストリームからの遅延イベントを破棄
-                            assistantMessage.content = parsed.content;
-                            this.updateSession(sessionId, {
-                                messages: [...updatedMessages],
-                            }, true); // 即時更新
-                        }
-                        break;
-                    }
-                    case "metadata": {
-                        if (parsed) {
-                            try {
-                                this.latestOnMetadata.get(sessionId)?.(parsed);
-                            }
-                            catch {
-                                console.error("[SM] Failed to call onMetadata handler");
+                            // Handle bundled metadata if present
+                            if (Array.isArray(parsed.meta) && parsed.meta.length > 0) {
+                                const s = this.state.sessions.get(sessionId);
+                                if (s) {
+                                    // Append new metadata items
+                                    const nextMeta = s.metadata.concat(parsed.meta);
+                                    this.updateSession(sessionId, { metadata: nextMeta });
+                                }
                             }
                         }
                         break;
                     }
                     case "error": {
-                        const err = new Error(parsed?.message || "Stream error");
+                        const message = isErrorPayload(parsed) && parsed.message
+                            ? parsed.message
+                            : "Stream error";
+                        const err = new Error(message);
                         try {
                             abortController.abort();
                         }
@@ -517,7 +536,8 @@ class StreamManager {
                             abortController: null,
                         }, true);
                         try {
-                            this.latestOnFinish.get(sessionId)?.((this.state.sessions.get(sessionId)?.messages || []));
+                            this.latestOnFinish.get(sessionId)?.((this.state.sessions.get(sessionId)?.messages ||
+                                []));
                         }
                         catch {
                             console.error("[SM] Failed to call onFinish handler");
@@ -541,7 +561,7 @@ class StreamManager {
                 const lines = buffer.split("\n");
                 buffer = lines.pop() || ""; // 末尾の未完成行をバッファに残す
                 for (const line of lines) {
-                    if (line === "") {
+                    if (line.trim() === "") {
                         // 空行で一つのイベントをフラッシュ
                         flushEvent();
                         eventName = null;
@@ -566,6 +586,19 @@ class StreamManager {
                 if (shouldTerminate)
                     break;
             }
+            // 読み取り終了時の明示クリーンアップ（環境により不要だが安全）
+            try {
+                await reader.cancel();
+            }
+            catch {
+                /* noop */
+            }
+            try {
+                await response.body?.cancel();
+            }
+            catch {
+                /* noop */
+            }
             // 意図: 正常完了（サーバが done を送らないケース）だけをここで処理。
             // failed=true（error）の場合は既に状態更新済みなので何もしない。
             if (!failed && !shouldTerminate) {
@@ -584,10 +617,14 @@ class StreamManager {
         catch (error) {
             // 意図: エラーイベントは catch に到達しない（failed フラグで分岐）ため、ここは接続エラーや中断のみ
             if (isAbortError(error)) {
-                this.updateSession(sessionId, {
-                    status: "aborted",
-                    abortController: null,
-                }, true); // Immediate for status change
+                // 既に stopStream() 等で aborted 済みであれば二重更新を避ける
+                const s = this.state.sessions.get(sessionId);
+                if (s?.status !== "aborted") {
+                    this.updateSession(sessionId, {
+                        status: "aborted",
+                        abortController: null,
+                    }, true); // Immediate for status change
+                }
             }
             else {
                 const err = error instanceof Error ? error : new Error("Unknown error");
@@ -630,6 +667,9 @@ class StreamManager {
     performSweep() {
         if (this.debug)
             console.info("[SM] Running TTL sweep", this.state.sessions);
+        const ttlMs = this.ttlMs;
+        if (!ttlMs || ttlMs <= 0)
+            return; // TTL 未設定なら何もしない
         if (this.state.sessions.size === 0)
             return;
         const now = Date.now();
@@ -642,7 +682,7 @@ class StreamManager {
             const subCount = this.activeSubscribers.get(id) ?? 0;
             if (subCount > 0)
                 continue;
-            if (now - session.lastAccessed > this.ttlMs) {
+            if (now - session.lastAccessed > ttlMs) {
                 // 安全のため abortController が残っていれば中断
                 try {
                     session.abortController?.abort();
@@ -655,7 +695,6 @@ class StreamManager {
                 this.state.sessions.delete(id);
                 // 意図: ハンドラと streamId も破棄してリークを防止
                 this.latestOnFinish.delete(id);
-                this.latestOnMetadata.delete(id);
                 this.latestOnError.delete(id);
                 this.streamIds.delete(id);
                 removed = true;
@@ -701,10 +740,8 @@ class StreamManager {
         this.listeners.clear();
         this.activeSubscribers.clear();
         this.latestOnFinish.clear();
-        this.latestOnMetadata.clear();
         this.latestOnError.clear();
         this.streamIds.clear();
-        this.pendingCloneSessions.clear();
     }
 }
 // Export the StreamManager class for custom initialization

package/dist/client/types.d.ts

@@ -3,6 +3,11 @@ export type ChatStatus = "ready" | "submitted" | "streaming" | "error" | "aborte
 export type ChatSession = {
     id: string;
     messages: Message[];
+    /**
+     * Accumulated metadata payloads received during the current stream.
+     * Newer items append to the end.
+     */
+    metadata: Array<Record<string, JSONValue>>;
     /**
      * messages の内容が更新されるたびにインクリメントされるバージョン番号。
      * - ストリーミング中は配列参照を再生成しない最適化を行っているため、
@@ -15,19 +20,11 @@ export type ChatSession = {
     abortController: AbortController | null;
     lastAccessed: number;
 };
-export type OnChatMetadataCallback<T extends Record<string, JSONValue> = Record<string, JSONValue>> = (metadata: T) => void;
 export type OnChatErrorCallback = (error: Error) => void;
 export type OnChatFinishCallback = (messages: Message[]) => void;
 export type UseChatSessionOptions = {
-    api?: string;
+    api: string;
     initialMessages?: Message[];
-    /**
-     * メタデータ受信時のコールバック
-     * memo化された関数を渡すこと
-     * @param metadata 受信したメタデータ
-     * @returns
-     */
-    onMetadata?: OnChatMetadataCallback;
     /**
      * エラー発生時のコールバック
      * memo化された関数を渡すこと
@@ -49,6 +46,10 @@ export type ReloadMessage = (params?: {
 }) => Promise<void>;
 export type UseChatSessionReturn = {
     messages: Message[];
+    /**
+     * Latest list of metadata payloads received during streaming.
+     */
+    metadata: Array<Record<string, JSONValue>>;
     /**
      * messages の内容更新を検知するためのバージョン番号。
      * useMemo の依存などに利用できる。

package/dist/client/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,WAAW,GACX,WAAW,GACX,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB;;;;;OAKG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,sBAAsB,CAChC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAC7D,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,CAAC;AAE1B,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAEzD,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAEjE,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,CAAC,EAAE;IACpC,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpB,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,CACX,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,kBAAkB,CAAA;KAAE,KACnC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,MAAM,IAAI,CAAC;AAE/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACpC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,WAAW,GACX,WAAW,GACX,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB;;;OAGG;IACH,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC3C;;;;;OAKG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,eAAe,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAEzD,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AAEjE,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAE3D,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,CAAC,EAAE;IACpC,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpB,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC3C;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,CACX,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,kBAAkB,CAAA;KAAE,KACnC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,MAAM,IAAI,CAAC;AAE/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACpC,CAAC"}

package/dist/client/useChatSession.d.ts

@@ -1,3 +1,3 @@
 import type { UseChatSessionOptions, UseChatSessionReturn } from "./types.js";
-export declare function useChatSession(sessionId: string, options?: UseChatSessionOptions): UseChatSessionReturn;
+export declare function useChatSession(sessionId: string, options: UseChatSessionOptions): UseChatSessionReturn;
 //# sourceMappingURL=useChatSession.d.ts.map

package/dist/client/useChatSession.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useChatSession.d.ts","sourceRoot":"","sources":["../../src/client/useChatSession.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAsB,MAAM,YAAY,CAAC;AAKlG,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CA+ItB"}
+{"version":3,"file":"useChatSession.d.ts","sourceRoot":"","sources":["../../src/client/useChatSession.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAKpB,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,qBAAqB,GAC7B,oBAAoB,CAsItB"}

package/dist/client/useChatSession.js

@@ -1,8 +1,8 @@
 import { useEffect, useSyncExternalStore, useCallback, useRef } from "react";
 import { useAIStreamManager } from "./context.js";
 import { generateId } from "../shared/generate-id.js";
-export function useChatSession(sessionId, options = {}) {
-    const { api = "/api/chat", initialMessages = [], onMetadata, onError, onFinish, } = options;
+export function useChatSession(sessionId, options) {
+    const { api, initialMessages = [], onError, onFinish } = options;
     const manager = useAIStreamManager();
     // セッションIDの変更検知用。初期化時に正しい initialMessages を渡すため、
     // レンダリング中に参照を更新する（副作用ではないので安全）。
@@ -43,10 +43,6 @@ export function useChatSession(sessionId, options = {}) {
         // onFinish が undefined の場合は登録解除される
         manager.setOnFinishHandler(sessionId, onFinish);
     }, [manager, sessionId, onFinish]);
-    useEffect(() => {
-        // onMetadata が undefined の場合は登録解除される
-        manager.setOnMetadataHandler(sessionId, onMetadata);
-    }, [manager, sessionId, onMetadata]);
     useEffect(() => {
         // onError が undefined の場合は登録解除される
         manager.setOnErrorHandler(sessionId, onError);
@@ -54,6 +50,7 @@ export function useChatSession(sessionId, options = {}) {
     const session = state.sessions.get(sessionId) || {
         id: sessionId,
         messages: initialMessages,
+        metadata: [],
         messagesVersion: 0,
         status: "ready",
         error: null,
@@ -97,6 +94,7 @@ export function useChatSession(sessionId, options = {}) {
     }, [sessionId, manager]);
     return {
         messages: session.messages,
+        metadata: session.metadata ?? [],
         messagesVersion: session.messagesVersion ?? 0,
         status: session.status,
         error: session.error,

package/dist/server/createChatHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createChatHandler.d.ts","sourceRoot":"","sources":["../../src/server/createChatHandler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EAGb,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAKpB,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,CA2T3E"}
+{"version":3,"file":"createChatHandler.d.ts","sourceRoot":"","sources":["../../src/server/createChatHandler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EAGb,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAKpB,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,CAyb3E"}

package/dist/server/createChatHandler.js

@@ -1,11 +1,33 @@
 import { isAbortError } from "../shared/error-utils.js";
 // Implemented for usage inside Hono's `streamText()` callback.
 export function createChatHandler(options) {
-    const { providers, transforms = [], throttle, converter, onFinish, onError, messages, timeoutMs = 60000, temperature, maxOutputTokens, } = options;
+    const { providers, transforms = [], throttle, onFinish, onError, messages, timeoutMs = 60000, temperature, maxOutputTokens, debug = false, } = options;
     // Convert single provider config to array for consistent handling
     const providerConfigs = Array.isArray(providers) ? providers : [providers];
-    // Store per-request metadata sender
-    let currentSendMetadata = null;
+    // Shared metadata queue for this handler instance.
+    // - External sendMetadata() calls enqueue here even before handler starts
+    // - During handler execution, queued metadata are bundled into next chunk
+    //   or flushed immediately as a metadata-only chunk
+    const metaQueue = [];
+    // Flusher the handler sets when stream is ready; external callers invoke it to flush immediately
+    let currentFlushMeta = null;
+    // Track previous throttle value for debug logging
+    let previousThrottle = null;
+    const enqueueMetadata = (meta) => {
+        metaQueue.push(meta);
+        if (debug) {
+            console.log("[cch] Enqueued metadata:", meta, `(queue size: ${metaQueue.length})`);
+        }
+        // If stream is active, flush immediately as metadata-only chunk
+        if (currentFlushMeta) {
+            try {
+                currentFlushMeta();
+            }
+            catch {
+                // ignore flush error; stream may be closing
+            }
+        }
+    };
     const handler = async (req, stream) => {
         // OpenAI SDK のストリーム・タイムアウト・中断制御に関する一時状態
         let chatStream;
@@ -14,10 +36,12 @@ export function createChatHandler(options) {
         let abortNotified = false; // onError('aborted') の多重呼び出し防止
         let currentModel = "";
         let currentProvider = "openai";
-        // Content send control for throttling (applied to both chunk and fullContent)
+        // Content send control for throttling
         let lastContentSendTime = 0;
         // Tracks the accText length at last send. Used to compute delta size when sending chunks.
         let lastContentSendLength = 0;
+        // Track total characters streamed across all provider attempts
+        let totalStreamedChars = 0;
         const sendEvent = async (event, data) => {
             // 接続が既に中断されている場合は送信しない
             if (isAborted)
@@ -58,7 +82,10 @@ export function createChatHandler(options) {
                 abortNotified = true;
                 try {
                     // ユーザー中断/接続断をサーバ利用側に通知
-                    onError(new Error("Aborted"), "aborted");
+                    onError(new Error("Aborted"), {
+                        reason: "aborted",
+                        streamedChars: totalStreamedChars,
+                    });
                 }
                 catch {
                     // ignore handler error
@@ -70,7 +97,9 @@ export function createChatHandler(options) {
         try {
             // Also listen to the Request's abort signal defensively
             if (req?.signal) {
-                req.signal.addEventListener("abort", handleAbort, { once: true });
+                req.signal.addEventListener("abort", handleAbort, {
+                    once: true,
+                });
             }
         }
         catch {
@@ -78,13 +107,33 @@ export function createChatHandler(options) {
         }
         try {
             const startTime = Date.now();
-            let accText = "";
-            let usage;
-            const sendMetadata = (meta) => {
-                void sendEvent("metadata", meta);
+            // Helper to drain queued metadata
+            const drainMeta = () => {
+                if (metaQueue.length === 0)
+                    return [];
+                const out = metaQueue.splice(0, metaQueue.length);
+                return out;
+            };
+            // Flush metadata-only chunk immediately (text: "")
+            const flushMetaOnly = async () => {
+                if (isAborted)
+                    return;
+                const metas = drainMeta();
+                if (metas.length === 0)
+                    return;
+                if (debug) {
+                    console.log(`[cch] Flushing ${metas.length} metadata items as meta-only chunk:`, metas);
+                }
+                await sendEvent("chunk", {
+                    text: "",
+                    meta: metas,
+                });
+            };
+            // Expose flusher so external sendMetadata() can flush immediately when possible
+            currentFlushMeta = () => {
+                // Fire and forget; do not await to avoid blocking caller
+                void flushMetaOnly();
             };
-            // Set the current sendMetadata for this request
-            currentSendMetadata = sendMetadata;
             if (timeoutMs) {
                 // サーバ側で全体の処理時間を制限する。クライアント中断済みであれば何もしない
                 timeoutId = setTimeout(async () => {
@@ -103,19 +152,32 @@ export function createChatHandler(options) {
                         code: "TIMEOUT",
                     });
                     if (onError)
-                        onError(new Error("Request timeout"), "timeout");
+                        onError(new Error("Request timeout"), {
+                            reason: "timeout",
+                            streamedChars: totalStreamedChars,
+                        });
                 }, timeoutMs);
             }
-            // Try each provider config until one succeeds
+            // Try each provider end-to-end. If a provider fails before sending
+            // any content, fallback to the next. Once content is sent, do not fallback.
+            let lastError = null;
             for (let i = 0; i < providerConfigs.length; i++) {
                 const config = providerConfigs[i];
+                if (debug) {
+                    console.log(`[cch] Trying provider ${i + 1}/${providerConfigs.length}: ${config.provider}/${config.model}`);
+                }
+                // Local attempt state
+                let localAccText = "";
+                let localUsage;
+                lastContentSendTime = 0;
+                lastContentSendLength = 0;
                 // geminiでは"none"を指定することでreasoning_effortを無効化できる
                 let reasoningEffort = config.reasoningEffort ?? "none";
                 if (config.provider === "openai" && reasoningEffort === "none") {
                     reasoningEffort = undefined;
                 }
                 try {
-                    // OpenAI provider
+                    // Establish stream for this provider
                     chatStream = config.openai.chat.completions.stream({
                         model: config.model,
                         messages,
@@ -127,129 +189,157 @@ export function createChatHandler(options) {
                     });
                     currentModel = config.model;
                     currentProvider = config.provider;
-                    break; // Success, exit retry loop
-                }
-                catch (error) {
-                    // Continue to next provider if available
-                    if (i === providerConfigs.length - 1) {
-                        // This was the last provider, rethrow the error
-                        throw error;
+                    if (debug) {
+                        console.log(`[cch] Successfully connected to ${config.provider}/${config.model}`);
                     }
-                }
-            }
-            // Ensure chatStream was successfully created
-            if (!chatStream) {
-                throw new Error("Failed to create chat stream with any provider");
-            }
-            // Stream abort is handled by onAbort above
-            for await (const chunk of chatStream) {
-                if (isAborted)
-                    break;
-                const delta = chunk.choices[0]?.delta;
-                const finishReason = chunk.choices[0]?.finish_reason;
-                if (chunk.usage) {
-                    usage = {
-                        prompt_tokens: chunk.usage.prompt_tokens,
-                        completion_tokens: chunk.usage.completion_tokens,
-                        total_tokens: chunk.usage.total_tokens,
-                        reasoning_tokens: chunk.usage.completion_tokens_details?.reasoning_tokens,
-                    };
-                }
-                if (delta?.content) {
-                    let text = delta.content;
-                    const ctx = {
-                        accText,
-                        sendMetadata,
-                    };
-                    for (const transform of transforms) {
-                        text = await transform(text, ctx);
+                    // If there is pending metadata, flush once before first content
+                    if (debug && metaQueue.length > 0) {
+                        console.log(`[cch] Found ${metaQueue.length} pre-queued metadata items, flushing...`);
                     }
-                    if (text) {
-                        accText += text;
-                        // Throttle sending for both modes (converter vs chunk)
-                        const now = Date.now();
-                        const timeDiff = now - lastContentSendTime;
-                        const accTextLength = accText.length;
-                        const charDiff = accTextLength - lastContentSendLength;
-                        const throttleSettings = throttle
-                            ? typeof throttle === "function"
-                                ? throttle(accTextLength)
-                                : throttle
-                            : { timeMs: 0, chars: 0 };
-                        const shouldSendContent = lastContentSendTime === 0 || // First content is sent immediately
-                            timeDiff >= throttleSettings.timeMs ||
-                            charDiff >= throttleSettings.chars;
-                        if (shouldSendContent) {
-                            if (converter) {
-                                const fullContent = await converter(accText, ctx);
-                                await sendEvent("fullContent", {
-                                    type: "replace",
-                                    content: fullContent,
-                                });
+                    await flushMetaOnly();
+                    // Consume the stream
+                    for await (const chunk of chatStream) {
+                        if (isAborted)
+                            break;
+                        const delta = chunk.choices[0]?.delta;
+                        const finishReason = chunk.choices[0]?.finish_reason;
+                        if (chunk.usage) {
+                            localUsage = {
+                                prompt_tokens: chunk.usage.prompt_tokens,
+                                completion_tokens: chunk.usage.completion_tokens,
+                                total_tokens: chunk.usage.total_tokens,
+                                reasoning_tokens: chunk.usage.completion_tokens_details?.reasoning_tokens,
+                            };
+                        }
+                        if (delta?.content) {
+                            let text = delta.content;
+                            const ctx = {
+                                accText: localAccText,
+                                // Queue metadata; let sender bundle into next chunk
+                                sendMetadata: (meta) => enqueueMetadata(meta),
+                            };
+                            for (const transform of transforms) {
+                                text = await transform(text, ctx);
                             }
-                            else {
-                                // Send only the newly added delta since last send
-                                const deltaToSend = accText.slice(lastContentSendLength);
-                                if (deltaToSend) {
-                                    await sendEvent("chunk", { text: deltaToSend });
+                            if (text) {
+                                localAccText += text;
+                                // Throttle sending for both modes (converter vs chunk)
+                                const now = Date.now();
+                                const timeDiff = now - lastContentSendTime;
+                                const accTextLength = localAccText.length;
+                                const charDiff = accTextLength - lastContentSendLength;
+                                const throttleSettings = throttle
+                                    ? typeof throttle === "function"
+                                        ? throttle(accTextLength)
+                                        : throttle
+                                    : { timeMs: 0, chars: 0 };
+                                const shouldSendContent = lastContentSendTime === 0 || // First content is sent immediately
+                                    timeDiff >= throttleSettings.timeMs ||
+                                    charDiff >= throttleSettings.chars;
+                                if (shouldSendContent) {
+                                    // Send only the newly added delta since last send
+                                    const deltaToSend = localAccText.slice(lastContentSendLength);
+                                    if (deltaToSend) {
+                                        const metas = drainMeta();
+                                        if (debug &&
+                                            (!previousThrottle ||
+                                                JSON.stringify(throttleSettings) !==
+                                                    JSON.stringify(previousThrottle))) {
+                                            console.log(`[cch] throttle: ${JSON.stringify(throttleSettings)}`);
+                                            previousThrottle = throttleSettings;
+                                        }
+                                        const payload = metas.length
+                                            ? { text: deltaToSend, meta: metas }
+                                            : { text: deltaToSend };
+                                        await sendEvent("chunk", payload);
+                                    }
+                                    lastContentSendTime = now;
+                                    lastContentSendLength = localAccText.length;
+                                    totalStreamedChars = Math.max(totalStreamedChars, lastContentSendLength);
                                 }
                             }
-                            lastContentSendTime = now;
-                            lastContentSendLength = accText.length;
+                        }
+                        // Check for explicit stream end conditions
+                        if (finishReason === "stop" || finishReason === "length") {
+                            // Wait a bit for the final usage chunk if needed
+                            if (!localUsage && chunk.usage === undefined) {
+                                // Give it one more iteration to get usage
+                                continue;
+                            }
+                            // If we have usage or this is the second iteration after finish, break
+                            if (
+                            // finishReasonの後にusageが来るのでusageを持って終了とする
+                            localUsage &&
+                                finishReason) {
+                                break;
+                            }
                         }
                     }
-                }
-                // Check for explicit stream end conditions
-                if (finishReason === "stop" || finishReason === "length") {
-                    // Wait a bit for the final usage chunk if needed
-                    if (!usage && chunk.usage === undefined) {
-                        // Give it one more iteration to get usage
-                        continue;
+                    if (!isAborted) {
+                        // Send final content if there are unsent updates
+                        if (localAccText.length > lastContentSendLength) {
+                            const deltaToSend = localAccText.slice(lastContentSendLength);
+                            if (deltaToSend) {
+                                const metas = drainMeta();
+                                const payload = metas.length
+                                    ? { text: deltaToSend, meta: metas }
+                                    : { text: deltaToSend };
+                                await sendEvent("chunk", payload);
+                                totalStreamedChars = Math.max(totalStreamedChars, localAccText.length);
+                            }
+                        }
+                        // If any metadata remain, flush them as a final meta-only chunk
+                        await flushMetaOnly();
+                        await sendEvent("done", null);
                     }
-                    // If we have usage or this is the second iteration after finish, break
-                    if (
-                    // finishReasonの後にusageが来るのでusageを持って終了とする
-                    usage &&
-                        finishReason) {
-                        break;
+                    // 正常終了時もタイマーはクリア（次のattemptへは到達しない）
+                    clearTimeoutSafe();
+                    if (onFinish && !isAborted) {
+                        const finishInfo = {
+                            model: currentModel,
+                            provider: currentProvider,
+                            text: localAccText,
+                            usage: localUsage,
+                            durationMs: Date.now() - startTime,
+                        };
+                        if (debug) {
+                            console.log(`[cch] Stream finished:`, {
+                                model: currentModel,
+                                provider: currentProvider,
+                                textLength: localAccText.length,
+                                usage: localUsage,
+                                durationMs: finishInfo.durationMs,
+                            });
+                        }
+                        onFinish(finishInfo);
                     }
+                    // Completed successfully; stop retrying
+                    return;
                 }
-            }
-            if (!isAborted) {
-                // Send final content if there are unsent updates
-                if (accText.length > lastContentSendLength) {
-                    const ctx = {
-                        accText,
-                        sendMetadata,
-                    };
-                    if (converter) {
-                        const finalContent = await converter(accText, ctx);
-                        await sendEvent("fullContent", {
-                            type: "replace",
-                            content: finalContent,
-                        });
+                catch (error) {
+                    lastError = error;
+                    if (debug) {
+                        console.log(`[cch] Provider ${config.provider}/${config.model} failed during streaming:`, error);
                     }
-                    else {
-                        const deltaToSend = accText.slice(lastContentSendLength);
-                        if (deltaToSend) {
-                            await sendEvent("chunk", { text: deltaToSend });
+                    // If aborted, do not proceed further
+                    if (isAbortError(error) || isAborted)
+                        return;
+                    // If any content has already been sent from this attempt, do not fallback
+                    const contentAlreadySent = lastContentSendLength > 0;
+                    const isLast = i === providerConfigs.length - 1;
+                    if (!contentAlreadySent && !isLast) {
+                        if (debug) {
+                            console.log("[cch] Falling back to next provider...");
                         }
+                        // try next provider
+                        continue;
                     }
+                    // Otherwise rethrow to outer catch
+                    throw error;
                 }
-                await sendEvent("done", null);
-            }
-            // 正常終了時もタイマーはクリア
-            clearTimeoutSafe();
-            if (onFinish && !isAborted) {
-                const finishInfo = {
-                    model: currentModel,
-                    provider: currentProvider,
-                    text: accText,
-                    usage,
-                    durationMs: Date.now() - startTime,
-                };
-                onFinish(finishInfo);
             }
+            // If we get here, all providers failed before sending any content
+            throw (lastError ?? new Error("Failed to create chat stream with any provider"));
         }
         catch (error) {
             // 例外経路でもタイマーをクリア
@@ -257,26 +347,26 @@ export function createChatHandler(options) {
             if (isAbortError(error) || isAborted)
                 return;
             if (onError)
-                onError(error, "unknown");
+                onError(error, {
+                    reason: "unknown",
+                    streamedChars: totalStreamedChars,
+                });
             const errorMessage = error instanceof Error ? error.message : "Unknown error";
             await sendEvent("error", { message: errorMessage });
         }
         finally {
-            // Clear the current sendMetadata after request completes
-            currentSendMetadata = null;
+            // Disable external flusher after request completes
+            currentFlushMeta = null;
+            // Clear any remaining metadata for safety
+            metaQueue.splice(0, metaQueue.length);
         }
     };
     // Create the sendMetadata function
     const sendMetadata = (meta) => {
-        if (currentSendMetadata) {
-            currentSendMetadata(meta);
-        }
+        enqueueMetadata(meta);
     };
-    // Create the result object with both handler and sendMetadata
-    // Also make it callable for backward compatibility
-    const result = Object.assign(handler, {
+    return {
         handler,
         sendMetadata,
-    });
-    return result;
+    };
 }

package/dist/server/types.d.ts

@@ -30,27 +30,31 @@ export type ServerEmitTools = {
     sendMetadata: (meta: Record<string, JSONValue>) => void;
 };
 export type ChatHandler = (req: Request, stream: StreamingApi) => Promise<void>;
-export type ChatHandlerResult = ChatHandler & {
+export type ChatHandlerResult = {
     handler: ChatHandler;
     sendMetadata: (meta: Record<string, JSONValue>) => void;
 };
 export type StreamTransform = (chunk: string, ctx: StreamTransformContext) => string | Promise<string>;
-export type ContentConverter = (accumulatedText: string, ctx: StreamTransformContext) => string | Promise<string>;
 export type ThrottleSettings = {
     timeMs: number;
     chars: number;
 };
 export type ErrorReason = "unknown" | "timeout" | "aborted";
+export type StreamHandlerOnError = (err: unknown, details: {
+    reason: ErrorReason;
+    streamedChars: number;
+}) => void;
+export type StreamHandlerOnFinish = (info: FinishInfo) => void;
 export type ServerOptions = {
     providers: AIProviderConfig | AIProviderConfig[];
     transforms?: StreamTransform[];
     throttle?: ThrottleSettings | ((accTextLength: number) => ThrottleSettings);
-    converter?: ContentConverter;
-    onFinish?: (info: FinishInfo) => void;
-    onError?: (err: unknown, reason: ErrorReason) => void;
+    onFinish?: StreamHandlerOnFinish;
+    onError?: StreamHandlerOnError;
     maxOutputTokens?: number;
     timeoutMs?: number;
     temperature?: number;
     messages: Message[];
+    debug?: boolean;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/server/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,MAAM,cAAc,GAAG,YAAY,CAAC;AAE1C,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,UAAU,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE;QACN,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;KACjC,CAAC;IACF,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,IAAI,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,IAAI,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhF,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAC5C,OAAO,EAAE,WAAW,CAAC;IACrB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,IAAI,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,CAC5B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,sBAAsB,KACxB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE9B,MAAM,MAAM,gBAAgB,GAAG,CAC7B,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,sBAAsB,KACxB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE9B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAAC;IACjD,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,gBAAgB,GAAG,CAAC,CAAC,aAAa,EAAE,MAAM,KAAK,gBAAgB,CAAC,CAAC;IAC5E,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"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"}

package/dist/shared/wire.d.ts

@@ -1,14 +1,15 @@
 import type { JSONValue } from "./types.js";
-export type SSEEventType = "chunk" | "fullContent" | "metadata" | "error" | "done";
+export type SSEEventType = "chunk" | "error" | "done";
 export type SSEChunkData = {
     text: string;
-};
-export type SSEFullContentData = {
-    type: "replace";
-    content: string;
-};
-export type SSEMetadataData = {
-    [k: string]: JSONValue;
+    /**
+     * Optional metadata bundled with this chunk. When present, represents
+     * one or more metadata payloads that occurred since the previous
+     * emitted chunk.
+     */
+    meta?: Array<{
+        [k: string]: JSONValue;
+    }>;
 };
 export type SSEErrorData = {
     message: string;
@@ -18,12 +19,6 @@ export type SSEDoneData = null;
 export type SSEEvent = {
     event: "chunk";
     data: SSEChunkData;
-} | {
-    event: "fullContent";
-    data: SSEFullContentData;
-} | {
-    event: "metadata";
-    data: SSEMetadataData;
 } | {
     event: "error";
     data: SSEErrorData;

package/dist/shared/wire.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/shared/wire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,aAAa,GACb,UAAU,GACV,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC;AAE/B,MAAM,MAAM,QAAQ,GAChB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GACtC;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,GAClD;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAC5C;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GACtC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC"}
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/shared/wire.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC;AAE/B,MAAM,MAAM,QAAQ,GAChB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GACtC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GACtC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simple-ai-sdk",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "private": false,
   "description": "Simple AI SDK for Hono / React19+ / OpenAI",
   "type": "module",