gemini-reverse 1.0.6 → 1.0.8

package/README.md

@@ -6,15 +6,18 @@ An unofficial Node.js client for [Google Gemini](https://gemini.google.com), ins
 
 ## Features
 
-- **Persistent Cookies** — Automatically refreshes cookies in the background. Optimized for always-on services.
+- **Persistent Cookies** — Automatically refreshes cookies in the background with jitter to prevent synchronized requests. Optimized for always-on services.
 - **Image Generation** — Natively supports generating and editing images with natural language.
 - **Video & Audio Generation** — Supports generating videos and audio/music content natively.
 - **Deep Research** — Full deep research workflow with plan creation, status polling, and result retrieval.
+- **Extended Thinking** — Enables deeper reasoning mode on supported models.
 - **System Prompt** — Supports customizing the model's system prompt with [Gemini Gems](https://gemini.google.com/gems/view).
 - **Extension Support** — Supports generating content with Gemini extensions such as YouTube and Gmail.
 - **Classified Outputs** — Categorizes text, thoughts, images, videos, and audio in the response.
-- **Streaming Mode** — Supports stream generation, yielding partial outputs as they are generated.
+- **Streaming Mode** — Supports stream generation with an incremental stateful frame parser, yielding partial outputs as they are generated.
 - **Dynamic Model Discovery** — Automatically discovers available models from your account at initialization.
+- **Quota & Usage Info** — Exposes account quota, compute usage, and abuse status after initialization.
+- **Activity Watchdog** — Background heartbeat task that keeps the session alive automatically.
 - **TypeScript Support** — Full TypeScript type declarations included out of the box.
 
 ## Table of Contents
@@ -34,6 +37,7 @@ An unofficial Node.js client for [Google Gemini](https://gemini.google.com), ins
   - [Delete a Conversation](#delete-a-conversation)
   - [Temporary Mode](#temporary-mode)
   - [Streaming Mode](#streaming-mode)
+  - [Extended Thinking](#extended-thinking)
   - [Select Language Model](#select-language-model)
   - [List Available Models](#list-available-models)
   - [Apply System Prompt with Gemini Gems](#apply-system-prompt-with-gemini-gems)
@@ -49,6 +53,7 @@ An unofficial Node.js client for [Google Gemini](https://gemini.google.com), ins
   - [Check and Switch to Other Reply Candidates](#check-and-switch-to-other-reply-candidates)
   - [Deep Research](#deep-research)
   - [Account Status](#account-status)
+  - [Quota and Usage Info](#quota-and-usage-info)
 - [Error Handling](#error-handling)
 - [Cookie Persistence](#cookie-persistence)
 - [TypeScript](#typescript)
@@ -73,7 +78,7 @@ npm install gemini-reverse
 
 ### Initialization
 
-Import the package and initialize a client with your cookies. After a successful initialization, the client will automatically refresh `__Secure-1PSIDTS` in the background as long as the process is alive.
+Import the package and initialize a client with your cookies. After a successful initialization, the client will automatically refresh `__Secure-1PSIDTS` in the background with random jitter, and start a heartbeat watchdog to keep the session alive.
 
 ```js
 const { GeminiClient } = require('gemini-reverse');
@@ -88,7 +93,7 @@ await client.init({
     timeout: 300000,        // request timeout in ms, default 300000
     autoClose: false,       // auto-close client after inactivity
     closeDelay: 300000,     // inactivity delay before closing in ms
-    autoRefresh: true,      // auto-refresh cookies in the background
+    autoRefresh: true,      // auto-refresh cookies + start activity watchdog
     refreshInterval: 540000 // cookie refresh interval in ms
 });
 ```
@@ -215,7 +220,7 @@ console.log(res2.text);
 
 ### Streaming Mode
 
-For longer responses, use streaming mode to receive partial outputs as they are generated. The `text_delta` attribute contains only the **new characters** received since the last yield, making it easy to display incremental updates.
+For longer responses, use streaming mode to receive partial outputs as they are generated. The response uses a stateful `StreamingFrameParser` internally, so partial frames are buffered efficiently across chunks without rescanning. The `text_delta` attribute contains only the **new characters** received since the last yield.
 
 ```js
 for await (const chunk of client.generateContentStream({
@@ -235,6 +240,36 @@ for await (const chunk of chat.sendMessageStream({ prompt: 'Tell me a long story
 }
 ```
 
+### Extended Thinking
+
+Pass `extended_thinking: true` to enable deeper reasoning mode. This causes the model to spend more time planning before responding. Supported on Pro and Advanced tier models.
+
+```js
+const { Model } = require('gemini-reverse');
+
+const response = await client.generateContent({
+    prompt: 'Solve this step by step: If a train travels at 120 km/h and needs to cover 450 km, how long does it take?',
+    model: Model.ADVANCED_PRO,
+    extended_thinking: true,
+});
+
+if (response.thoughts) {
+    console.log('Thinking process:', response.thoughts);
+}
+console.log('Answer:', response.text);
+```
+
+Also works in streaming and chat:
+
+```js
+const chat = client.startChat({ model: Model.ADVANCED_FLASH });
+const res = await chat.sendMessage({
+    prompt: 'Explain the P vs NP problem.',
+    extended_thinking: true,
+});
+console.log(res.text);
+```
+
 ### Select Language Model
 
 Specify which language model to use by passing a `model` argument. Available models are discovered dynamically at init time based on your account tier.
@@ -248,7 +283,7 @@ const response1 = await client.generateContent({
     model: Model.BASIC_FLASH,
 });
 
-// Using a model name string
+// Using a model name string (case-insensitive)
 const chat = client.startChat({ model: 'gemini-3-pro' });
 
 // Using a custom model header dict
@@ -256,7 +291,9 @@ const chat2 = client.startChat({
     model: {
         model_name: 'custom',
         model_header: {
-            'x-goog-ext-525001261-jspb': '[1,null,null,null,"MODEL_ID",null,null,0,[4],null,null,2]',
+            'x-goog-ext-525001261-jspb': '[1,null,null,null,"MODEL_ID",null,null,0,[4,5,6,8],null,null,1,null,null,1]',
+            'x-goog-ext-73010989-jspb': '[0]',
+            'x-goog-ext-73010990-jspb': '[0,0,0]',
         },
     },
 });
@@ -269,13 +306,13 @@ const chat2 = client.startChat({
 | `Model.UNSPECIFIED` | `unspecified` | Default, lets Gemini choose |
 | `Model.BASIC_PRO` | `gemini-3-pro` | Free tier |
 | `Model.BASIC_FLASH` | `gemini-3-flash` | Free tier, fastest |
-| `Model.BASIC_THINKING` | `gemini-3-flash-thinking` | Free tier, thinking model |
+| `Model.BASIC_LITE` | `gemini-3-lite` | Free tier, lightweight |
 | `Model.PLUS_PRO` | `gemini-3-pro-plus` | Plus tier |
 | `Model.PLUS_FLASH` | `gemini-3-flash-plus` | Plus tier |
-| `Model.PLUS_THINKING` | `gemini-3-flash-thinking-plus` | Plus tier |
+| `Model.PLUS_LITE` | `gemini-3-lite-plus` | Plus tier |
 | `Model.ADVANCED_PRO` | `gemini-3-pro-advanced` | Advanced tier |
 | `Model.ADVANCED_FLASH` | `gemini-3-flash-advanced` | Advanced tier |
-| `Model.ADVANCED_THINKING` | `gemini-3-flash-thinking-advanced` | Advanced tier |
+| `Model.ADVANCED_LITE` | `gemini-3-lite-advanced` | Advanced tier |
 
 ### List Available Models
 
@@ -288,7 +325,7 @@ const models = client.listModels();
 if (models) {
     for (const model of models) {
         console.log(`${model.model_id} → ${model.model_name || model.display_name}`);
-        console.log(`  capacity: ${model.capacity}, advanced_only: ${model.advanced_only}`);
+        console.log(`  capacity: ${model.capacity}, model_number: ${model.model_number}, advanced_only: ${model.advanced_only}`);
     }
 }
 ```
@@ -377,7 +414,7 @@ When using thinking-capable models, the model's internal reasoning is exposed vi
 ```js
 const response = await client.generateContent({
     prompt: 'What is 17 × 23?',
-    model: Model.BASIC_THINKING,
+    model: Model.BASIC_FLASH,
 });
 
 if (response.thoughts) {
@@ -582,6 +619,41 @@ if (client.accountStatus === AccountStatus.AVAILABLE) {
 | `AccountStatus.GUARDIAN_APPROVAL_REQUIRED` | 1057 | Requires parental approval |
 | `AccountStatus.LOCATION_REJECTED` | 1060 | Not available in your country/region |
 
+### Quota and Usage Info
+
+After initialization, the client fetches account quota limits and compute usage metrics automatically. Access them via `client.quotas`, `client.usageInfo`, and `client.abuseStatus`.
+
+```js
+await client.init();
+
+// Quota limits (Flash, Pro, extra features)
+const quotas = client.quotas;
+for (const [id, q] of Object.entries(quotas)) {
+    if (q.label) {
+        const remaining = q.remaining !== null ? `${q.remaining}/${q.total}` : 'unlimited';
+        console.log(`${q.label}: ${remaining} credits (${q.usage_percentage?.toFixed(1) ?? '?'}% used)`);
+    }
+}
+
+// Compute usage (5-hour and weekly windows)
+const usage = client.usageInfo;
+if (usage.tier) {
+    console.log(`Account tier: ${usage.tier.label}`);
+}
+if (usage.current_5h) {
+    console.log(`5h window: ${usage.current_5h.remaining_credits} credits remaining (${usage.current_5h.usage_percentage}% used)`);
+}
+if (usage.weekly) {
+    console.log(`Weekly: ${usage.weekly.remaining_credits} credits remaining`);
+}
+
+// Abuse status
+const abuse = client.abuseStatus;
+if (abuse) {
+    console.log(`Account clean: ${abuse.is_clean}`);
+}
+```
+
 ## Error Handling
 
 ```js
@@ -651,13 +723,17 @@ import {
     AccountStatus,
     DeepResearchPlan,
     DeepResearchResult,
+    StreamingFrameParser,
 } from 'gemini-reverse';
 
 const client = new GeminiClient({ secure_1psid: '...' });
 await client.init();
 
 const chat: ChatSession = client.startChat({ model: 'gemini-3-flash' });
-const response: ModelOutput = await chat.sendMessage({ prompt: 'Hello!' });
+const response: ModelOutput = await chat.sendMessage({
+    prompt: 'Hello!',
+    extended_thinking: false,
+});
 
 console.log(response.text);
 
@@ -667,6 +743,11 @@ if (history) {
 }
 
 const models: AvailableModel[] | null = client.listModels();
+
+// Access quota and usage after init
+console.log(client.quotas);
+console.log(client.usageInfo);
+console.log(client.abuseStatus);
 ```
 
 ## Project Structure
@@ -692,9 +773,9 @@ gemini-reverse/
 │   └── video.js            # Video, GeneratedVideo, GeneratedMedia
 ├── utils/
 │   ├── accessToken.js      # cookie handling & init request
-│   ├── parsing.js          # response parsing utilities
+│   ├── parsing.js          # response parsing + StreamingFrameParser
 │   ├── research.js         # deep research payload extractors
-│   ├── rotate.js           # cookie rotation (kept from original)
+│   ├── rotate.js           # cookie rotation
 │   └── upload.js           # file upload helpers
 └── components/
     ├── chatMixin.js        # chat history methods

package/client.js

@@ -25,7 +25,7 @@ const { Gem } = require('./types/gem');
 const { getAccessToken, cookieStr, parseCookies, parseProxy } = require('./utils/accessToken');
 const { rotate1psidts } = require('./utils/rotate');
 const { uploadFile, parseFileName } = require('./utils/upload');
-const { getDeltaByFpLen, getNestedValue, parseResponseByFrame, extractJsonFromResponse } = require('./utils/parsing');
+const { getDeltaByFpLen, getNestedValue, parseResponseByFrame, extractJsonFromResponse, StreamingFrameParser } = require('./utils/parsing');
 const { extractDeepResearchPlan } = require('./utils/research');
 
 function sleep(ms) { return new Promise(r => setTimeout(r, ms)); }
@@ -66,10 +66,16 @@ class GeminiClient {
         this.watchdogTimeout = 30000;
         this.verbose = false;
         this._running = false;
+        this._sessionid = uuidv4().toUpperCase();
         this._reqid = Math.floor(Math.random() * 90000) + 10000;
         this._modelRegistry = {};
         this._recentChats = null;
         this._gems = null;
+        this._quotas = {};
+        this._usageInfo = {};
+        this._abuseStatus = null;
+        this._lastActivityTime = 0;
+        this._activityTask = null;
 
         if (secure_1psid) {
             this.cookies['__Secure-1PSID'] = secure_1psid;
@@ -102,6 +108,7 @@ class GeminiClient {
             this.pushId = pushId || 'feeds/mcudyrk2a4khkz';
             this.cookies = validCookies;
             this._running = true;
+            this._sessionid = uuidv4().toUpperCase();
             this._reqid = Math.floor(Math.random() * 90000) + 10000;
             this.timeout = timeout;
             this.autoClose = autoClose;
@@ -117,6 +124,9 @@ class GeminiClient {
 
             await this._initRpc();
 
+            if (this._activityTask) { clearInterval(this._activityTask); this._activityTask = null; }
+            if (autoRefresh && this._checkAccountStatus()) this._startActivityWatchdog();
+
             if (this.verbose) console.log('Gemini client initialized successfully.');
         } catch (e) { await this.close(); throw e; }
     }
@@ -126,32 +136,68 @@ class GeminiClient {
         this._running = false;
         if (this.closeTask) { clearTimeout(this.closeTask); this.closeTask = null; }
         if (this.refreshTask) { clearInterval(this.refreshTask); this.refreshTask = null; }
+        if (this._activityTask) { clearInterval(this._activityTask); this._activityTask = null; }
     }
 
+    get quotas() { return this._quotas; }
+    get usageInfo() { return this._usageInfo; }
+    get abuseStatus() { return this._abuseStatus; }
+
     _resetCloseTask() {
         if (this.closeTask) { clearTimeout(this.closeTask); this.closeTask = null; }
         this.closeTask = setTimeout(() => this.close(), this.closeDelay);
     }
 
     _startAutoRefresh() {
-        const interval = Math.max(this.refreshInterval, 60000);
-        this.refreshTask = setInterval(async () => {
+        const baseInterval = Math.max(this.refreshInterval, 60000);
+        const jitter = () => (Math.random() - 0.5) * 30000;
+        const scheduleNext = () => {
             if (!this._running) return;
-            try {
-                const [new1psidts, rotatedCookies] = await rotate1psidts(this.cookies, this.proxy);
-                if (rotatedCookies) Object.assign(this.cookies, rotatedCookies);
-                if (!new1psidts) console.warn('Rotation response did not contain a new __Secure-1PSIDTS.');
-            } catch (e) {
-                console.warn(`Unexpected error while refreshing cookies: ${e.message}`);
-            }
-        }, interval);
+            this.refreshTask = setTimeout(async () => {
+                if (!this._running) return;
+                try {
+                    const [new1psidts, rotatedCookies] = await rotate1psidts(this.cookies, this.proxy);
+                    if (rotatedCookies) Object.assign(this.cookies, rotatedCookies);
+                    if (!new1psidts) console.warn('Rotation response did not contain a new __Secure-1PSIDTS.');
+                } catch (e) {
+                    console.warn(`Unexpected error while refreshing cookies: ${e.message}`);
+                }
+                scheduleNext();
+            }, Math.max(60000, baseInterval + jitter()));
+        };
+        scheduleNext();
+    }
+
+    _startActivityWatchdog() {
+        const scheduleNext = () => {
+            if (!this._running) return;
+            const interval = 60000 + Math.random() * 240000;
+            this._activityTask = setTimeout(async () => {
+                if (!this._running) return;
+                if (!this._checkAccountStatus()) return;
+                try {
+                    await this._syncActivity();
+                } catch {}
+                scheduleNext();
+            }, interval);
+        };
+        scheduleNext();
+    }
+
+    _checkAccountStatus() {
+        return this.accountStatus === AccountStatus.AVAILABLE ||
+            this.accountStatus === AccountStatus.ACCOUNT_UNTRUSTED;
     }
 
     async _initRpc() {
         await this._fetchUserStatus();
-        await this._sendBardSettings();
-        await this._sendBardActivity();
+        await this._fetchPreferences();
+        await this._syncActivity();
         await this._fetchRecentChats();
+        await this._fetchQuota();
+        await this._fetchExtraQuota();
+        await this._fetchAbuseStatus();
+        await this._fetchUsageInfo();
     }
 
     async _fetchUserStatus() {
@@ -195,6 +241,7 @@ class GeminiClient {
                 })();
                 const [capacity, capacityField] = AvailableModel.computeCapacity(tierFlags, capabilityFlags);
                 const idNameMapping = AvailableModel.buildModelIdNameMapping();
+                const idNumberMapping = AvailableModel.buildModelIdNumberMapping();
 
                 for (const modelData of modelsList) {
                     if (!Array.isArray(modelData)) continue;
@@ -216,6 +263,7 @@ class GeminiClient {
                             description,
                             capacity,
                             capacity_field: capacityField,
+                            model_number: idNumberMapping[modelId] || 1,
                             is_available: isModelAvailable,
                         });
                         this._modelRegistry[modelId] = model;
@@ -228,18 +276,178 @@ class GeminiClient {
         }
     }
 
-    async _sendBardSettings() {
+    async _fetchPreferences() {
         await this._batchExecute([
-            new RPCData({ rpcid: GRPC.BARD_SETTINGS, payload: BARD_SETTINGS_PAYLOAD }),
+            new RPCData({ rpcid: GRPC.READ_USER_PREFERENCES, payload: BARD_SETTINGS_PAYLOAD }),
         ]);
     }
 
-    async _sendBardActivity() {
+    async _syncActivity() {
+        this._lastActivityTime = Date.now();
+        if (!this._checkAccountStatus()) return;
         await this._batchExecute([
-            new RPCData({ rpcid: GRPC.BARD_SETTINGS, payload: '[[["bard_activity_enabled"]]]' }),
+            new RPCData({ rpcid: GRPC.READ_USER_PREFERENCES, payload: '[[["bard_activity_enabled"]]]' }),
         ]);
     }
 
+    async _fetchQuota() {
+        if (!this._checkAccountStatus()) return;
+        const payloads = [
+            { key: 'flash', payload: '[[[1,11],[2,11],[6,11]]]' },
+            { key: 'advanced', payload: '[[[1,4],[6,6],[1,15]]]' },
+        ];
+        const actionLabels = { 4: 'Gemini Pro', 11: 'Gemini Flash', 15: 'Gemini Flash Thinking' };
+        for (const { key, payload } of payloads) {
+            try {
+                const res = await this._batchExecute([
+                    new RPCData({ rpcid: GRPC.CHECK_GEMINI_QUOTA, payload }),
+                ]);
+                const parts = extractJsonFromResponse(res.data);
+                for (const part of parts) {
+                    const bodyStr = getNestedValue(part, [2]);
+                    if (!bodyStr) continue;
+                    let body;
+                    try { body = JSON.parse(bodyStr); } catch { continue; }
+                    const items = getNestedValue(body, [0]);
+                    if (!Array.isArray(items)) continue;
+                    for (const item of items) {
+                        const quotaIdList = getNestedValue(item, [0], []);
+                        const actionId = getNestedValue(item, [0, 1]);
+                        const usageLevel = getNestedValue(item, [2]);
+                        const resetTs = getNestedValue(item, [3, 0]);
+                        const total = getNestedValue(item, [4]);
+                        const remaining = getNestedValue(item, [5]);
+                        const quotaId = quotaIdList.filter(x => x != null).join('-') || String(actionId);
+                        const label = actionLabels[actionId] || `Gemini ${key}`;
+                        this._quotas[quotaId] = { usage_percentage: usageLevel, reset_time: resetTs, total, remaining, action_id: actionId, label: `${label} [${quotaId}]` };
+                    }
+                }
+            } catch {}
+        }
+    }
+
+    async _fetchExtraQuota() {
+        try {
+            const res = await this._batchExecute([
+                new RPCData({ rpcid: GRPC.CHECK_QUOTA, payload: '[]' }),
+            ]);
+            const parts = extractJsonFromResponse(res.data);
+            for (const part of parts) {
+                const bodyStr = getNestedValue(part, [2]);
+                if (!bodyStr) continue;
+                let body;
+                try { body = JSON.parse(bodyStr); } catch { continue; }
+                const isBlocked = getNestedValue(body, [0]);
+                const usageLevel = getNestedValue(body, [1]);
+                const resetTs = getNestedValue(body, [2, 0]);
+                if (!this._quotas.extra) this._quotas.extra = {};
+                this._quotas.extra.default = {
+                    is_blocked: isBlocked,
+                    usage_percentage: typeof usageLevel === 'number' ? usageLevel * 100 : null,
+                    reset_time: resetTs,
+                };
+            }
+        } catch {}
+    }
+
+    async _fetchAbuseStatus() {
+        try {
+            const res = await this._batchExecute([
+                new RPCData({ rpcid: GRPC.GET_ABUSE_STATUS, payload: '[]' }),
+            ]);
+            const parts = extractJsonFromResponse(res.data);
+            for (const part of parts) {
+                const bodyStr = getNestedValue(part, [2]);
+                if (!bodyStr) continue;
+                let body;
+                try { body = JSON.parse(bodyStr); } catch { continue; }
+                const abuseInfo = getNestedValue(body, [1]);
+                if (!abuseInfo) {
+                    this._abuseStatus = { is_clean: true, status_code: null, signal: null };
+                } else {
+                    const rawStatus = getNestedValue(abuseInfo, [1]);
+                    const signal = getNestedValue(abuseInfo, [3, 1]);
+                    const statusCode = typeof rawStatus === 'number' ? Math.floor(rawStatus / 1000000) : null;
+                    this._abuseStatus = { is_clean: false, status_code: statusCode, signal };
+                    if (this.verbose) console.warn(`Potential account restriction detected: ${JSON.stringify(this._abuseStatus)}`);
+                }
+            }
+        } catch {}
+    }
+
+    async _fetchUsageInfo() {
+        if (!this._checkAccountStatus()) return;
+        const tierLabels = { 1: 'FREE', 2: 'PRO', 3: 'ULTRA', 4: 'PLUS', 6: 'ULTRA' };
+        const metricWindows = { 1: ['current_5h', '5h'], 2: ['weekly', 'weekly'] };
+        try {
+            const res = await this._batchExecute([
+                new RPCData({ rpcid: GRPC.GET_USAGE_INFO, payload: '[]' }),
+            ], 2, true, '/usage');
+            const parts = extractJsonFromResponse(res.data);
+            for (const part of parts) {
+                const bodyStr = getNestedValue(part, [2]);
+                if (!bodyStr) continue;
+                let body;
+                try { body = JSON.parse(bodyStr); } catch { continue; }
+                const tierId = getNestedValue(body, [0]);
+                const usageItems = getNestedValue(body, [1], []);
+                const useOverage = getNestedValue(body, [2]);
+                const info = {
+                    tier: { id: tierId, label: tierLabels[tierId] || null },
+                    use_overage_ai_credits: useOverage,
+                    current_5h: null,
+                    weekly: null,
+                };
+                if (Array.isArray(usageItems)) {
+                    for (const item of usageItems) {
+                        const remaining = getNestedValue(item, [0]);
+                        const usageLevel = getNestedValue(item, [1]);
+                        const metricType = getNestedValue(item, [2]);
+                        const resetTs = getNestedValue(item, [3, 0, 0]);
+                        if (metricType === 3) { info.ai_credits_remaining = remaining; continue; }
+                        const [metricLabel] = metricWindows[metricType] || [`type_${metricType}`];
+                        info[metricLabel] = {
+                            type: metricType,
+                            remaining_credits: remaining,
+                            usage_level: usageLevel,
+                            usage_percentage: typeof usageLevel === 'number' ? Math.round(usageLevel * 100) : null,
+                            reset_at: resetTs,
+                        };
+                    }
+                }
+                this._usageInfo = info;
+                this._quotas.usage_info = info;
+            }
+        } catch {}
+    }
+
+    _parseRpcResults(responseText, targetId) {
+        const results = [];
+        try {
+            const parts = extractJsonFromResponse(responseText);
+            for (const part of parts) {
+                if (getNestedValue(part, [1]) !== targetId) continue;
+                const rejectCode = getNestedValue(part, [5, 0]);
+                if (rejectCode === 7) {
+                    this.accountStatus = AccountStatus.UNAUTHENTICATED;
+                    break;
+                }
+                const bodyStr = getNestedValue(part, [2]);
+                if (!bodyStr) continue;
+                try { results.push(JSON.parse(bodyStr)); } catch {}
+            }
+        } catch {}
+        return results;
+    }
+
+    async _sendBardSettings() {
+        await this._fetchPreferences();
+    }
+
+    async _sendBardActivity() {
+        await this._syncActivity();
+    }
+
     listModels() {
         const vals = Object.values(this._modelRegistry);
         return vals.length > 0 ? vals : null;
@@ -247,8 +455,9 @@ class GeminiClient {
 
     _resolveModelByName(name) {
         if (name in this._modelRegistry) return this._modelRegistry[name];
+        const lower = name.toLowerCase();
         for (const m of Object.values(this._modelRegistry)) {
-            if (m.model_name === name || m.display_name === name) return m;
+            if (m.model_name.toLowerCase() === lower || m.display_name.toLowerCase() === lower) return m;
         }
         return Model.fromName(name);
     }
@@ -280,7 +489,7 @@ class GeminiClient {
         return model;
     }
 
-    async _batchExecute(payloads, retries = 2, closeOnError = true) {
+    async _batchExecute(payloads, retries = 2, closeOnError = true, sourcePath = '/app') {
         let lastErr;
         for (let attempt = 0; attempt <= retries; attempt++) {
             try {
@@ -292,7 +501,7 @@ class GeminiClient {
                     hl: this.language || 'en',
                     _reqid: String(_reqid),
                     rt: 'c',
-                    'source-path': '/app',
+                    'source-path': sourcePath,
                 });
                 if (this.buildLabel) params.set('bl', this.buildLabel);
                 if (this.sessionId) params.set('f.sid', this.sessionId);
@@ -340,6 +549,7 @@ class GeminiClient {
         chat = null,
         temporary = false,
         deep_research = false,
+        extended_thinking = false,
     } = {}) {
         if (!this._running) {
             await this.init({
@@ -369,7 +579,7 @@ class GeminiClient {
             const ss = { last_texts: {}, last_thoughts: {}, last_progress_time: Date.now(), is_thinking: false, is_queueing: false };
             let output = null;
             for await (const out of this._generate({
-                prompt, fileData, model, gem, chat, temporary, ss, deep_research,
+                prompt, fileData, model, gem, chat, temporary, ss, deep_research, extended_thinking,
             })) output = out;
             if (!output) throw new GeminiError('Failed to generate contents. No output data found in response.');
             if (chat instanceof ChatSession) { output.metadata = chat.metadata; chat.lastOutput = output; }
@@ -386,6 +596,7 @@ class GeminiClient {
         chat = null,
         temporary = false,
         deep_research = false,
+        extended_thinking = false,
     } = {}) {
         if (!this._running) {
             await this.init({
@@ -414,7 +625,7 @@ class GeminiClient {
         const ss = { last_texts: {}, last_thoughts: {} };
         let output = null;
         for await (const out of this._generate({
-            prompt, fileData, model, gem, chat, temporary, ss, deep_research,
+            prompt, fileData, model, gem, chat, temporary, ss, deep_research, extended_thinking,
         })) {
             output = out;
             yield out;
@@ -431,6 +642,7 @@ class GeminiClient {
         temporary = false,
         ss = null,
         deep_research = false,
+        extended_thinking = false,
     }, retries = 5) {
         if (!prompt) throw new Error('Prompt cannot be empty.');
 
@@ -438,7 +650,7 @@ class GeminiClient {
 
         for (let attempt = 0; attempt <= retries; attempt++) {
             try {
-                for await (const out of this._stream({ prompt, fileData, model, gem, chat, temporary, ss, deep_research })) yield out;
+                for await (const out of this._stream({ prompt, fileData, model, gem, chat, temporary, ss, deep_research, extended_thinking })) yield out;
                 return;
             } catch (e) {
                 if (
@@ -451,7 +663,7 @@ class GeminiClient {
         }
     }
 
-    async* _stream({ prompt, fileData = null, model = Model.UNSPECIFIED, gem = null, chat = null, temporary = false, ss = null, deep_research = false }) {
+    async* _stream({ prompt, fileData = null, model = Model.UNSPECIFIED, gem = null, chat = null, temporary = false, ss = null, deep_research = false, extended_thinking = false }) {
         const _reqid = this._reqid;
         this._reqid += 100000;
         const gemId = gem instanceof Gem ? gem.id : gem;
@@ -463,7 +675,7 @@ class GeminiClient {
             rcid: chat.rcid,
         } : null;
 
-        const inner = new Array(69).fill(null);
+        const inner = new Array(81).fill(null);
         inner[0] = [prompt, 0, null, fileData, null, null, 0];
         inner[1] = [this.language || 'en'];
         inner[2] = chat instanceof ChatSession ? chat.metadata : [...DEFAULT_METADATA];
@@ -489,11 +701,24 @@ class GeminiClient {
             inner[55] = [[1]];
         }
         inner[61] = [];
-        inner[68] = 2;
+        inner[68] = 1;
+        inner[80] = extended_thinking ? 2 : 1;
 
         const uid = uuidv4().toUpperCase();
         inner[59] = uid;
 
+        const modelHeaders = { ...model.model_header };
+        if (MODEL_HEADER_KEY in modelHeaders) {
+            try {
+                const parsed = JSON.parse(modelHeaders[MODEL_HEADER_KEY]);
+                const modelNumber = typeof parsed[parsed.length - 1] === 'number' ? parsed[parsed.length - 1] : null;
+                if (typeof modelNumber === 'number') inner[79] = modelNumber;
+                parsed.push(extended_thinking ? 2 : 1);
+                parsed.push(this.sessionId || null);
+                modelHeaders[MODEL_HEADER_KEY] = JSON.stringify(parsed);
+            } catch {}
+        }
+
         const params = new URLSearchParams({
             hl: this.language || 'en',
             _reqid: String(_reqid),
@@ -516,7 +741,7 @@ class GeminiClient {
             {
                 headers: {
                     ...Headers.GEMINI,
-                    ...model.model_header,
+                    ...modelHeaders,
                     'x-goog-ext-525005358-jspb': `["${uid}",1]`,
                     ...Headers.SAME_DOMAIN,
                     'Cookie': cookieStr(this.cookies),
@@ -541,7 +766,7 @@ class GeminiClient {
         let isCompleted = false, isFinalChunk = false;
         let cid = chat instanceof ChatSession ? chat.cid : '';
         let rid = chat instanceof ChatSession ? chat.rid : '';
-        let buf = '';
+        const frameParser = new StreamingFrameParser();
 
         const processParts = (parts) => {
             const outs = [];
@@ -676,10 +901,7 @@ class GeminiClient {
 
             res.data.on('data', chunk => {
                 try {
-                    buf += chunk.toString('utf8');
-                    if (buf.startsWith(")]}'")) buf = buf.slice(4).trimStart();
-                    const [parts, rem] = parseResponseByFrame(buf);
-                    buf = rem;
+                    const parts = frameParser.feed(chunk.toString('utf8'));
                     const outs = processParts(parts);
                     for (const o of outs) yielded.push(o);
                     if (outs.length || isThinking || isQueueing) lastProg = Date.now();
@@ -692,10 +914,8 @@ class GeminiClient {
             res.data.on('end', () => {
                 clearInterval(watchdog);
                 try {
-                    if (buf) {
-                        const [p] = parseResponseByFrame(buf);
-                        for (const o of processParts(p)) yielded.push(o);
-                    }
+                    const remaining = frameParser.flush();
+                    for (const o of processParts(remaining)) yielded.push(o);
                     if (!isCompleted && !isFinalChunk) reject(new APIError('Stream interrupted or truncated.'));
                     else resolve();
                 } catch (e) { reject(e); }
@@ -923,7 +1143,7 @@ class ChatSession {
     get rcid() { return this._metadata[2]; }
     set rcid(v) { this._metadata[2] = v; }
 
-    async sendMessage({ prompt, files = null, temporary = false, deep_research = false } = {}) {
+    async sendMessage({ prompt, files = null, temporary = false, deep_research = false, extended_thinking = false } = {}) {
         return this.geminiclient.generateContent({
             prompt,
             files,
@@ -932,10 +1152,11 @@ class ChatSession {
             chat: this,
             temporary,
             deep_research,
+            extended_thinking,
         });
     }
 
-    async* sendMessageStream({ prompt, files = null, temporary = false, deep_research = false } = {}) {
+    async* sendMessageStream({ prompt, files = null, temporary = false, deep_research = false, extended_thinking = false } = {}) {
         for await (const out of this.geminiclient.generateContentStream({
             prompt,
             files,
@@ -944,6 +1165,7 @@ class ChatSession {
             chat: this,
             temporary,
             deep_research,
+            extended_thinking,
         })) yield out;
     }
 

package/components/chatMixin.js

@@ -14,6 +14,7 @@ class ChatMixin {
     }
 
     async _fetchRecentChats(recent = 13) {
+        if (!this._checkAccountStatus()) return;
         const fetchBatch = async (payload) => {
             return this._batchExecute([
                 new RPCData({ rpcid: GRPC.LIST_CHATS, payload: JSON.stringify([recent, null, payload]) }),

package/constants.js

@@ -9,11 +9,11 @@ const ARTIFACTS_RE = /http:\/\/googleusercontent\.com\/\w+\/\d+\n*/g;
 const DEFAULT_METADATA = ['', '', '', null, null, null, null, null, null, ''];
 const MODEL_HEADER_KEY = 'x-goog-ext-525001261-jspb';
 
-function buildModelHeader(modelId, capacityTail) {
+function buildModelHeader(modelId, capacityTail, modelNumber = 1) {
     return {
-        [MODEL_HEADER_KEY]: `[1,null,null,null,"${modelId}",null,null,0,[4],null,null,${capacityTail}]`,
+        [MODEL_HEADER_KEY]: `[1,null,null,null,"${modelId}",null,null,0,[4,5,6,8],null,null,${capacityTail},null,null,${modelNumber}]`,
         'x-goog-ext-73010989-jspb': '[0]',
-        'x-goog-ext-73010990-jspb': '[0]',
+        'x-goog-ext-73010990-jspb': '[0,0,0]',
     };
 }
 
@@ -29,22 +29,56 @@ const Endpoint = {
 const GRPC = {
     LIST_CHATS: 'MaZiqc',
     READ_CHAT: 'hNvQHb',
+    GET_CONVERSATION_TURN: 'EqPOKe',
     DELETE_CHAT_1: 'GzXR5e',
     DELETE_CHAT_2: 'qWymEb',
+    UPDATE_CONVERSATION: 'MUAZcd',
+    MARK_LAST_CONVERSATION_TURN: 'kOWVAe',
+    GENERATE_HEADLINE: 'ukz1Fe',
+
     LIST_GEMS: 'CNgdBe',
     CREATE_GEM: 'oMH3Zd',
+    GET_GEM: 'HcT8bb',
     UPDATE_GEM: 'kHv0Vd',
     DELETE_GEM: 'UXcSJb',
+    DELETE_GEM_AND_CONVERSATIONS: 'Nwkn9',
+
+    CREATE_TASK: 'Jba3ib',
+    GET_TASK: 'kwDCne',
+    GET_ALL_TASKS: 'XPSWpd',
+    GET_TASKS_IN_CONVERSATION: 'qWymEb',
+    GET_CANDIDATES: 'PCck7e',
+    LIST_DISCOVERY_CARDS: 'ku4Jyf',
+    GET_DISCOVERY_CARD: 'oApPWc',
+    LIST_DISCOVERY_BANNERS: 'Te6DCf',
+
     DEEP_RESEARCH_STATUS: 'kwDCne',
     DEEP_RESEARCH_PREFS: 'L5adhe',
     DEEP_RESEARCH_BOOTSTRAP: 'ku4Jyf',
     DEEP_RESEARCH_MODEL_STATE: 'qpEbW',
     DEEP_RESEARCH_CAPS: 'aPya6c',
     DEEP_RESEARCH_ACK: 'PCck7e',
+
+    LIST_GEMINI_APP_ARTIFACTS: 'jGArJ',
+    DELETE_GEMINI_APP_ARTIFACTS: 'PGX16d',
+
+    LIST_MEMORIES: 'ZKcapf',
+    CREATE_MEMORY: 'xVRQX',
+    UPDATE_MEMORY: 'gSnMcd',
+    DELETE_MEMORY: 'Ok9j9b',
+    DELETE_ALL_MEMORIES: 'YgU2Cc',
+
     GET_USER_STATUS: 'otAQ7b',
     LIST_MODELS: 'otAQ7b',
+    CHECK_GEMINI_QUOTA: 'qpEbW',
+    CHECK_QUOTA: 'aPya6c',
     GET_FULL_SIZE_IMAGE: 'c8o8Fe',
+    GET_ABUSE_STATUS: 'GPRiHf',
+    UPDATE_USER_PREFERENCES: 'L5adhe',
+    READ_USER_PREFERENCES: 'ESY5D',
     BARD_SETTINGS: 'ESY5D',
+    CONTINUE_SHARED_CONVERSATION: 'ra9Swb',
+    GET_USAGE_INFO: 'jSf9Qc',
 };
 
 const Headers = {
@@ -66,67 +100,69 @@ const Headers = {
     },
     UPLOAD: { 'X-Tenant-Id': 'bard-storage' },
     BATCH_EXEC: {
-        'x-goog-ext-525001261-jspb': '[1,null,null,null,null,null,null,null,[4]]',
+        'x-goog-ext-525001261-jspb': '[1,null,null,null,null,null,null,null,[4,5,6,8],null,null,null,null,null,null,null]',
         'x-goog-ext-73010989-jspb': '[0]',
     },
 };
 
 const _MODEL_KEYS = [
-    'UNSPECIFIED', 'BASIC_PRO', 'BASIC_FLASH', 'BASIC_THINKING',
-    'PLUS_PRO', 'PLUS_FLASH', 'PLUS_THINKING',
-    'ADVANCED_PRO', 'ADVANCED_FLASH', 'ADVANCED_THINKING',
+    'UNSPECIFIED',
+    'BASIC_PRO', 'BASIC_FLASH', 'BASIC_LITE',
+    'PLUS_PRO', 'PLUS_FLASH', 'PLUS_LITE',
+    'ADVANCED_PRO', 'ADVANCED_FLASH', 'ADVANCED_LITE',
 ];
 
 const Model = {
     UNSPECIFIED: { model_name: 'unspecified', model_header: {}, advanced_only: false },
     BASIC_PRO: {
         model_name: 'gemini-3-pro',
-        model_header: buildModelHeader('9d8ca3786ebdfbea', 1),
+        model_header: buildModelHeader('9d8ca3786ebdfbea', 1, 3),
         advanced_only: false,
     },
     BASIC_FLASH: {
         model_name: 'gemini-3-flash',
-        model_header: buildModelHeader('fbb127bbb056c959', 1),
+        model_header: buildModelHeader('fbb127bbb056c959', 1, 1),
         advanced_only: false,
     },
-    BASIC_THINKING: {
-        model_name: 'gemini-3-flash-thinking',
-        model_header: buildModelHeader('5bf011840784117a', 1),
+    BASIC_LITE: {
+        model_name: 'gemini-3-lite',
+        model_header: buildModelHeader('cf41b0e0dd7d53e5', 1, 6),
         advanced_only: false,
     },
     PLUS_PRO: {
         model_name: 'gemini-3-pro-plus',
-        model_header: buildModelHeader('e6fa609c3fa255c0', 4),
+        model_header: buildModelHeader('e6fa609c3fa255c0', 4, 3),
         advanced_only: true,
     },
     PLUS_FLASH: {
         model_name: 'gemini-3-flash-plus',
-        model_header: buildModelHeader('56fdd199312815e2', 4),
+        model_header: buildModelHeader('56fdd199312815e2', 4, 1),
         advanced_only: true,
     },
-    PLUS_THINKING: {
-        model_name: 'gemini-3-flash-thinking-plus',
-        model_header: buildModelHeader('e051ce1aa80aa576', 4),
+    PLUS_LITE: {
+        model_name: 'gemini-3-lite-plus',
+        model_header: buildModelHeader('8c46e95b1a07cecc', 4, 6),
         advanced_only: true,
     },
     ADVANCED_PRO: {
         model_name: 'gemini-3-pro-advanced',
-        model_header: buildModelHeader('e6fa609c3fa255c0', 2),
+        model_header: buildModelHeader('e6fa609c3fa255c0', 2, 3),
         advanced_only: true,
     },
     ADVANCED_FLASH: {
         model_name: 'gemini-3-flash-advanced',
-        model_header: buildModelHeader('56fdd199312815e2', 2),
+        model_header: buildModelHeader('56fdd199312815e2', 2, 1),
         advanced_only: true,
     },
-    ADVANCED_THINKING: {
-        model_name: 'gemini-3-flash-thinking-advanced',
-        model_header: buildModelHeader('e051ce1aa80aa576', 2),
+    ADVANCED_LITE: {
+        model_name: 'gemini-3-lite-advanced',
+        model_header: buildModelHeader('8c46e95b1a07cecc', 2, 6),
         advanced_only: true,
     },
     fromName(name) {
+        const lower = name.toLowerCase();
         for (const k of _MODEL_KEYS) {
-            if (Model[k].model_name === name) return Model[k];
+            if (Model[k].model_name === lower) return Model[k];
         }
         const names = _MODEL_KEYS.map(k => Model[k].model_name).join(', ');
         throw new Error(`Unknown model name: ${name}. Available: ${names}`);

package/index.d.ts

@@ -18,7 +18,7 @@ export interface ModelDict {
 
 export type ModelInput = string | ModelDef | ModelDict | AvailableModel | null;
 
-export declare function buildModelHeader(modelId: string, capacityTail: string | number): ModelHeader;
+export declare function buildModelHeader(modelId: string, capacityTail: string | number, modelNumber?: number): ModelHeader;
 
 export declare const MODEL_HEADER_KEY: string;
 export declare const STREAMING_FLAG_INDEX: number;
@@ -125,6 +125,7 @@ export declare class AvailableModel {
     description: string;
     capacity: number;
     capacity_field: number;
+    model_number: number;
     is_available: boolean;
     constructor(opts: {
         model_id: string;
@@ -133,6 +134,7 @@ export declare class AvailableModel {
         description: string;
         capacity: number;
         capacity_field?: number;
+        model_number?: number;
         is_available?: boolean;
     });
     get model_header(): ModelHeader;
@@ -141,6 +143,7 @@ export declare class AvailableModel {
     repr(): string;
     static computeCapacity(tierFlags: number[], capabilityFlags: number[]): [number, number];
     static buildModelIdNameMapping(): Record<string, string>;
+    static buildModelIdNumberMapping(): Record<string, number>;
 }
 
 export interface ImageSaveOptions {
@@ -417,6 +420,7 @@ export interface GenerateOptions {
     chat?: ChatSession | null;
     temporary?: boolean;
     deep_research?: boolean;
+    extended_thinking?: boolean;
 }
 
 export interface StartChatOptions {
@@ -461,6 +465,9 @@ export declare class GeminiClient {
     refreshInterval: number;
     verbose: boolean;
     watchdogTimeout: number;
+    readonly quotas: Record<string, Record<string, unknown>>;
+    readonly usageInfo: Record<string, unknown>;
+    readonly abuseStatus: { is_clean: boolean; status_code: number | null; signal: unknown } | null;
 
     constructor(opts?: GeminiClientOptions);
 
@@ -508,6 +515,7 @@ export interface SendMessageOptions {
     files?: (string | Buffer)[] | null;
     temporary?: boolean;
     deep_research?: boolean;
+    extended_thinking?: boolean;
 }
 
 export declare class ChatSession {

package/index.js

@@ -11,6 +11,7 @@ const {
     AuthError, APIError, ImageGenerationError, GeminiError, TimeoutError,
     UsageLimitExceeded, ModelInvalid, TemporarilyBlocked,
 } = require('./exceptions');
+const { StreamingFrameParser } = require('./utils/parsing');
 const {
     Candidate, ChatHistory, ChatTurn, ChatInfo, Gem, GemJar, RPCData,
     Image, WebImage, GeneratedImage, ModelOutput,
@@ -61,4 +62,5 @@ module.exports = {
     GeneratedVideo,
     GeneratedMedia,
     AvailableModel,
+    StreamingFrameParser,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gemini-reverse",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "Unofficial Node.js client for gemini.google.com — inspired by Gemini-API (Python). Supports streaming, chat sessions, gems, file uploads, and TypeScript.",
   "main": "index.js",
   "types": "index.d.ts",

package/types/availablemodel.js

@@ -3,13 +3,14 @@
 const { buildModelHeader, MODEL_HEADER_KEY, Model } = require('../constants');
 
 class AvailableModel {
-    constructor({ model_id, model_name, display_name, description, capacity, capacity_field = 12, is_available = true } = {}) {
+    constructor({ model_id, model_name, display_name, description, capacity, capacity_field = 12, model_number = 1, is_available = true } = {}) {
         this.model_id = model_id;
         this.model_name = model_name;
         this.display_name = display_name;
         this.description = description;
         this.capacity = capacity;
         this.capacity_field = capacity_field;
+        this.model_number = model_number;
         this.is_available = is_available;
     }
 
@@ -20,7 +21,7 @@ class AvailableModel {
         } else {
             tail = String(this.capacity);
         }
-        return buildModelHeader(this.model_id, tail);
+        return buildModelHeader(this.model_id, tail, this.model_number);
     }
 
     get advanced_only() {
@@ -47,9 +48,9 @@ class AvailableModel {
     static buildModelIdNameMapping() {
         const result = {};
         const keys = [
-            'BASIC_PRO', 'BASIC_FLASH', 'BASIC_THINKING',
-            'PLUS_PRO', 'PLUS_FLASH', 'PLUS_THINKING',
-            'ADVANCED_PRO', 'ADVANCED_FLASH', 'ADVANCED_THINKING',
+            'BASIC_PRO', 'BASIC_FLASH', 'BASIC_LITE',
+            'PLUS_PRO', 'PLUS_FLASH', 'PLUS_LITE',
+            'ADVANCED_PRO', 'ADVANCED_FLASH', 'ADVANCED_LITE',
         ];
         for (const key of keys) {
             const member = Model[key];
@@ -71,6 +72,32 @@ class AvailableModel {
         }
         return result;
     }
+
+    static buildModelIdNumberMapping() {
+        const result = {};
+        const keys = [
+            'BASIC_PRO', 'BASIC_FLASH', 'BASIC_LITE',
+            'PLUS_PRO', 'PLUS_FLASH', 'PLUS_LITE',
+            'ADVANCED_PRO', 'ADVANCED_FLASH', 'ADVANCED_LITE',
+        ];
+        for (const key of keys) {
+            const member = Model[key];
+            if (!member) continue;
+            const headerValue = member.model_header[MODEL_HEADER_KEY];
+            if (!headerValue) continue;
+            try {
+                const parsed = JSON.parse(headerValue);
+                const modelId = parsed && parsed[4];
+                const modelNumber = parsed && parsed[parsed.length - 1];
+                if (modelId && typeof modelNumber === 'number' && !(modelId in result)) {
+                    result[modelId] = modelNumber;
+                }
+            } catch {
+                continue;
+            }
+        }
+        return result;
+    }
 }
 
 module.exports = { AvailableModel };

package/utils/index.js

@@ -1,7 +1,7 @@
 'use strict';
 
 const { getAccessToken, sendInitRequest, cookieStr, parseCookies, parseProxy, cacheDir } = require('./accessToken');
-const { getDeltaByFpLen, getCleanText, getNestedValue, parseResponseByFrame, extractJsonFromResponse } = require('./parsing');
+const { getDeltaByFpLen, getCleanText, getNestedValue, parseResponseByFrame, extractJsonFromResponse, StreamingFrameParser } = require('./parsing');
 const { rotate1psidts } = require('./rotate');
 const { uploadFile, parseFileName, generateRandomName } = require('./upload');
 const {
@@ -28,6 +28,7 @@ module.exports = {
     getNestedValue,
     parseResponseByFrame,
     extractJsonFromResponse,
+    StreamingFrameParser,
     rotate1psidts,
     uploadFile,
     parseFileName,

package/utils/parsing.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const FLICKER_ESC_RE = /\\+[`*_~].*$/;
+const LENGTH_MARKER_RE = /^(\d+)\n/;
 
 function getCleanText(s) {
     if (!s) return '';
@@ -90,45 +91,121 @@ function getNestedValue(data, path, defaultVal = null) {
     return cur != null ? cur : defaultVal;
 }
 
-function parseResponseByFrame(content) {
-    let pos = 0;
-    const frames = [];
-    while (pos < content.length) {
-        while (pos < content.length && /\s/.test(content[pos])) pos++;
-        if (pos >= content.length) break;
-        const m = /^(\d+)\n/.exec(content.slice(pos));
-        if (!m) break;
-        const len = parseInt(m[1]);
-        const start = pos + m[1].length;
-        let chars = 0, units = 0, idx = start;
-        while (units < len && idx < content.length) {
-            const cp = content.codePointAt(idx);
+class StreamingFrameParser {
+    constructor() {
+        this.buffer = '';
+        this.expectedUnits = null;
+        this.payloadStart = 0;
+        this.scannedChars = 0;
+        this.scannedUnits = 0;
+        this.prefixChecked = false;
+    }
+
+    reset() {
+        this.buffer = '';
+        this._resetFrameState();
+        this.prefixChecked = false;
+    }
+
+    feed(content) {
+        if (typeof content !== 'string') throw new TypeError(`Expected string, got ${typeof content}`);
+        if (content) this.buffer += content;
+        this._stripPrefixOnce();
+
+        const parsed = [];
+        while (true) {
+            if (this.expectedUnits === null && !this._readLengthMarker()) break;
+            if (this.expectedUnits === null) break;
+
+            this._scanAvailablePayload();
+            if (this.scannedUnits < this.expectedUnits) break;
+
+            const endPos = this.payloadStart + this.scannedChars;
+            const chunk = this.buffer.slice(this.payloadStart, endPos);
+            this.buffer = this.buffer.slice(endPos);
+            this._resetFrameState();
+
+            if (!chunk.trim()) continue;
+
+            try {
+                const p = JSON.parse(chunk);
+                if (Array.isArray(p)) parsed.push(...p);
+                else parsed.push(p);
+            } catch {}
+        }
+        return parsed;
+    }
+
+    flush() {
+        return this.feed('');
+    }
+
+    _resetFrameState() {
+        this.expectedUnits = null;
+        this.payloadStart = 0;
+        this.scannedChars = 0;
+        this.scannedUnits = 0;
+    }
+
+    _stripPrefixOnce() {
+        if (this.prefixChecked) return;
+        const prefix = ")]}'";
+        if (this.buffer.length < prefix.length && prefix.startsWith(this.buffer)) return;
+        if (this.buffer.startsWith(prefix)) {
+            this.buffer = this.buffer.slice(prefix.length).trimStart();
+        }
+        this.prefixChecked = true;
+    }
+
+    _readLengthMarker() {
+        let pos = 0;
+        while (pos < this.buffer.length && /\s/.test(this.buffer[pos])) pos++;
+        if (pos) {
+            this.buffer = this.buffer.slice(pos);
+        }
+        if (!this.buffer.length) return false;
+
+        const m = LENGTH_MARKER_RE.exec(this.buffer);
+        if (!m) return false;
+
+        const lenStr = m[1];
+        this.expectedUnits = parseInt(lenStr, 10);
+        this.payloadStart = lenStr.length;
+        this.scannedChars = 0;
+        this.scannedUnits = 0;
+        return true;
+    }
+
+    _scanAvailablePayload() {
+        if (this.expectedUnits === null) return;
+        let idx = this.payloadStart + this.scannedChars;
+        const limit = this.buffer.length;
+
+        while (this.scannedUnits < this.expectedUnits && idx < limit) {
+            const cp = this.buffer.codePointAt(idx);
             const u = cp > 0xFFFF ? 2 : 1;
-            if (units + u > len) break;
-            units += u;
-            chars += cp > 0xFFFF ? 2 : 1;
+            if (this.scannedUnits + u > this.expectedUnits) break;
+            this.scannedUnits += u;
+            this.scannedChars += cp > 0xFFFF ? 2 : 1;
             idx += cp > 0xFFFF ? 2 : 1;
         }
-        if (units < len) break;
-        const end = start + chars;
-        const chunk = content.slice(start, end).trim();
-        pos = end;
-        if (!chunk) continue;
-        try {
-            const parsed = JSON.parse(chunk);
-            if (Array.isArray(parsed)) frames.push(...parsed);
-            else frames.push(parsed);
-        } catch {}
     }
-    return [frames, content.slice(pos)];
+}
+
+function parseResponseByFrame(content) {
+    const parser = new StreamingFrameParser();
+    const frames = parser.feed(content);
+    frames.push(...parser.flush());
+    return [frames, parser.buffer];
 }
 
 function extractJsonFromResponse(text) {
     if (typeof text !== 'string') throw new TypeError(`Expected string, got ${typeof text}`);
-    let c = text.startsWith(")]}'") ? text.slice(4) : text;
-    c = c.trimStart();
-    const [r] = parseResponseByFrame(c);
-    if (r.length) return r;
+    const parser = new StreamingFrameParser();
+    const result = parser.feed(text);
+    result.push(...parser.flush());
+    if (result.length) return result;
+    const c = text.startsWith(")]}'") ? text.slice(4).trimStart() : text.trimStart();
     try {
         const p = JSON.parse(c.trim());
         return Array.isArray(p) ? p : [p];
@@ -145,4 +222,4 @@ function extractJsonFromResponse(text) {
     throw new Error('Could not find valid JSON in response.');
 }
 
-module.exports = { getCleanText, getDeltaByFpLen, getNestedValue, parseResponseByFrame, extractJsonFromResponse };
+module.exports = { getCleanText, getDeltaByFpLen, getNestedValue, parseResponseByFrame, extractJsonFromResponse, StreamingFrameParser };