gemini-reverse 1.0.5 → 1.0.7

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