gemini-reverse 1.0.1 → 1.0.3

package/README.md

@@ -1,11 +1,7 @@
-![Banner](https://nc-cdn.oss-accelerate.aliyuncs.com/nx/a772a980daeb.png)
-
 # Gemini-Reverse
 
 An unofficial Node.js client for [gemini.google.com](https://gemini.google.com), inspired by [Gemini-API](https://github.com/HanaokaYuzu/Gemini-API) — a Python reverse engineering project by [@HanaokaYuzu](https://github.com/HanaokaYuzu).
 
-This package ports the core concepts and functionality of the original Python library to Node.js, with full CommonJS and TypeScript support.
-
 ---
 
 ## Features
@@ -14,7 +10,11 @@ This package ports the core concepts and functionality of the original Python li
 - Streaming support with text deltas
 - Multi-turn chat sessions with conversation history
 - File and image upload support
+- Video and media (audio) support
 - Gem (system prompt) management — create, update, delete, fetch
+- Deep research support — create plan, start, poll, and get results
+- Dynamic model discovery from account RPC
+- Account status detection
 - Auto cookie refresh to keep sessions alive
 - TypeScript type declarations included
 - Proxy support
@@ -31,32 +31,28 @@ npm install gemini-reverse
 
 ## Authentication
 
-This package uses browser cookies to authenticate with Gemini. You need to obtain your `__Secure-1PSID` cookie from your browser after logging in to [gemini.google.com](https://gemini.google.com).
-
-**Steps:**
-1. Open [gemini.google.com](https://gemini.google.com) in your browser and log in
-2. Open DevTools → Application → Cookies → `https://gemini.google.com`
-3. Copy the value of `__Secure-1PSID` (and optionally `__Secure-1PSIDTS`)
-
-> `__Secure-1PSIDTS` is optional — the client will attempt to refresh and cache it automatically after the first successful init.
+```
+1. Open gemini.google.com and log in
+2. DevTools → Application → Cookies → https://gemini.google.com
+3. Copy __Secure-1PSID (and optionally __Secure-1PSIDTS)
+```
 
 ---
 
 ## Quick Start
 
 ```js
-const { GeminiClient } = require('gemini-core');
+const { GeminiClient } = require('gemini-reverse');
 
-const client = new GeminiClient({
-    secure_1psid: 'YOUR_SECURE_1PSID',
-});
+const client = new GeminiClient({ secure_1psid: 'YOUR_SECURE_1PSID' });
 
 await client.init();
 
 const chat = client.startChat();
 const response = await chat.sendMessage({ prompt: 'Hello, Gemini!' });
-
 console.log(response.text);
+
+await client.close();
 ```
 
 ---
@@ -66,22 +62,18 @@ console.log(response.text);
 ### Initialize Client
 
 ```js
-const client = new GeminiClient({
-    secure_1psid: 'YOUR_SECURE_1PSID',
-    secure_1psidts: 'YOUR_SECURE_1PSIDTS', // optional
-    proxy: 'http://host:port',              // optional
-});
-
 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 background
-    refreshInterval: 540000 // cookie refresh interval in ms
+    timeout: 300000,
+    autoClose: false,
+    closeDelay: 300000,
+    autoRefresh: true,
+    refreshInterval: 540000,
+    verbose: false,
+    watchdogTimeout: 30000,
 });
 ```
 
-### Generate Content (single turn)
+### Generate Content
 
 ```js
 const response = await client.generateContent({ prompt: 'What is the capital of France?' });
@@ -99,106 +91,118 @@ for await (const chunk of client.generateContentStream({ prompt: 'Tell me a long
 ### Chat Session
 
 ```js
-const chat = client.startChat({ model: 'gemini-3.1-pro' });
+const chat = client.startChat({ model: 'gemini-3-flash' });
 
 const res1 = await chat.sendMessage({ prompt: 'My name is Alice.' });
-console.log(res1.text);
-
 const res2 = await chat.sendMessage({ prompt: 'What is my name?' });
-console.log(res2.text); // remembers context
+console.log(res2.text);
 ```
 
 ### Streaming in Chat
 
 ```js
-const chat = client.startChat({ model: 'gemini-3.0-flash' });
-
+const chat = client.startChat();
 for await (const chunk of chat.sendMessageStream({ prompt: 'Explain quantum computing.' })) {
     process.stdout.write(chunk.text_delta);
 }
 ```
 
-### Temporary Chat (no history saved)
+### Temporary Chat
 
 ```js
-const chat = client.startChat();
 const response = await chat.sendMessage({ prompt: 'This will not appear in history.', temporary: true });
 ```
 
 ### Send with Files
 
 ```js
-const chat = client.startChat();
 const response = await chat.sendMessage({
     prompt: 'Describe this image.',
     files: ['./photo.jpg'],
 });
-console.log(response.text);
 ```
 
 ### Multiple Candidates
 
 ```js
-const chat = client.startChat();
 const response = await chat.sendMessage({ prompt: 'Give me a poem.' });
-
-// list all candidates
 response.candidates.forEach((c, i) => console.log(`[${i}] ${c.text}`));
-
-// choose a specific candidate to continue the conversation
 chat.chooseCandidate(1);
 ```
 
 ### Models
 
 ```js
-// use model name string
-const chat = client.startChat({ model: 'gemini-3.1-pro' });
-
-// or use the Model constant
-const { Model } = require('gemini-api');
-const chat = client.startChat({ model: Model.G_3_0_FLASH });
-
-// or use a custom model dict
-const chat = client.startChat({
-    model: {
-        model_name: 'my-model',
-        model_header: { 'x-goog-ext-525001261-jspb': '...' },
-    },
+const models = client.listModels();
+if (models) {
+    for (const m of models) {
+        console.log(m.model_id, m.model_name, m.display_name);
+    }
+}
+
+const chat = client.startChat({ model: 'gemini-3-flash' });
+
+const { Model } = require('gemini-reverse');
+const chat2 = client.startChat({ model: Model.BASIC_FLASH });
+
+const chat3 = client.startChat({
+    model: { model_name: 'my-model', model_header: { 'x-goog-ext-525001261-jspb': '...' } },
 });
 ```
 
-**Available models:**
+**Built-in model constants:**
 
-| String | Constant |
+| Constant | model_name |
 |---|---|
-| `gemini-3.1-pro` | `Model.G_3_1_PRO` |
-| `gemini-3.0-flash` | `Model.G_3_0_FLASH` |
-| `gemini-3.0-flash-thinking` | `Model.G_3_0_FLASH_THINKING` |
-| `unspecified` (default) | `Model.UNSPECIFIED` |
+| `Model.UNSPECIFIED` | `unspecified` (default) |
+| `Model.BASIC_PRO` | `gemini-3-pro` |
+| `Model.BASIC_FLASH` | `gemini-3-flash` |
+| `Model.BASIC_THINKING` | `gemini-3-flash-thinking` |
+| `Model.PLUS_PRO` | `gemini-3-pro-plus` |
+| `Model.PLUS_FLASH` | `gemini-3-flash-plus` |
+| `Model.PLUS_THINKING` | `gemini-3-flash-thinking-plus` |
+| `Model.ADVANCED_PRO` | `gemini-3-pro-advanced` |
+| `Model.ADVANCED_FLASH` | `gemini-3-flash-advanced` |
+| `Model.ADVANCED_THINKING` | `gemini-3-flash-thinking-advanced` |
 
 ### Images
 
-Responses may include web images or AI-generated images.
-
 ```js
-const response = await chat.sendMessage({ prompt: 'Send me an image of a cat.' });
-
 for (const img of response.images) {
     console.log(img.url, img.title, img.alt);
     await img.save({ path: './downloads', verbose: true });
 }
 ```
 
-### Read Chat History
+### Videos & Media
 
 ```js
-const turns = await client.readChat('c_YOUR_CHAT_ID');
+for (const video of response.videos) {
+    await video.save({ savePath: './downloads', verbose: true });
+}
+for (const media of response.media) {
+    await media.save({ savePath: './downloads', downloadType: 'both', verbose: true });
+}
+```
 
-for (const turn of turns) {
-    console.log('User:', turn.user_prompt);
-    console.log('Gemini:', turn.assistant_response);
+### Chat History
+
+```js
+const history = await client.readChat('c_YOUR_CHAT_ID');
+if (history) {
+    for (const turn of history.turns) {
+        console.log(turn.role, turn.text);
+    }
 }
+
+const chats = client.listChats();
+if (chats) {
+    for (const info of chats) {
+        console.log(info.cid, info.title, info.is_pinned);
+    }
+}
+
+const sessionHistory = await chat.readHistory(10);
 ```
 
 ### Delete Chat
@@ -207,61 +211,69 @@ for (const turn of turns) {
 await client.deleteChat('c_YOUR_CHAT_ID');
 ```
 
+### Deep Research
+
+```js
+const plan = await client.createDeepResearchPlan('History of artificial intelligence');
+console.log(plan.title, plan.steps);
+
+const startOutput = await client.startDeepResearch(plan);
+
+const result = await client.waitForDeepResearch(plan, 10000, 600000, (status) => {
+    console.log(status.state, status.notes);
+});
+console.log(result.text);
+
+const result2 = await client.deepResearch('Explain quantum computing', 10000, 600000);
+console.log(result2.text);
+```
+
+### Account Status
+
+```js
+const { AccountStatus } = require('gemini-reverse');
+
+if (client.accountStatus === AccountStatus.UNAUTHENTICATED) {
+    console.error('Cookies expired.');
+} else if (client.accountStatus === AccountStatus.LOCATION_REJECTED) {
+    console.error('Gemini not available in your region.');
+}
+```
+
 ### Gems
 
 ```js
-// fetch all gems
 const gems = await client.fetchGems();
-
-// get by name
 const gem = gems.get({ name: 'Coding partner' });
-
-// filter user-created gems
 const myGems = gems.filter({ predefined: false });
+const chat = client.startChat({ gem });
 
-// use a gem in chat
-const chat = client.startChat({ gem: gem });
-
-// create a gem
 const newGem = await client.createGem({
     name: 'My Assistant',
     prompt: 'You are a helpful assistant that speaks formally.',
-    description: 'Formal assistant gem',
-});
-
-// update a gem
-await client.updateGem({
-    gem: newGem,
-    name: 'My Assistant v2',
-    prompt: 'You are a helpful assistant that speaks casually.',
 });
 
-// delete a gem
+await client.updateGem({ gem: newGem, name: 'My Assistant v2', prompt: 'Speak casually.' });
 await client.deleteGem(newGem);
 ```
 
-### Close Client
-
-```js
-await client.close();
-```
-
 ---
 
-## TypeScript
-
-This package includes full TypeScript declarations out of the box.
-
-```ts
-import { GeminiClient, ChatSession, ModelOutput, ConversationTurn, Gem, Model } from 'gemini-api';
-
-const client = new GeminiClient({ secure_1psid: '...' });
-await client.init();
+## Error Handling
 
-const chat: ChatSession = client.startChat({ model: 'gemini-3.1-pro' });
-const response: ModelOutput = await chat.sendMessage({ prompt: 'Hello!' });
+```js
+const { AuthError, APIError, GeminiError, TimeoutError, UsageLimitExceeded, ModelInvalid, TemporarilyBlocked } = require('gemini-reverse');
 
-console.log(response.text);
+try {
+    const response = await chat.sendMessage({ prompt: 'Hello!' });
+} catch (e) {
+    if (e instanceof AuthError) console.error('Cookie expired or invalid.');
+    else if (e instanceof UsageLimitExceeded) console.error('Usage limit reached.');
+    else if (e instanceof TemporarilyBlocked) console.error('IP temporarily blocked.');
+    else if (e instanceof TimeoutError) console.error('Request timed out.');
+    else if (e instanceof ModelInvalid) console.error('Invalid model.');
+    else if (e instanceof APIError) console.error('API error:', e.message);
+}
 ```
 
 ---
@@ -269,77 +281,50 @@ console.log(response.text);
 ## Project Structure
 
 ```
-gemini-api/
-├── index.js          # entry point
-├── index.d.ts        # TypeScript declarations
-├── client.js         # GeminiClient + ChatSession
-├── constants.js      # Endpoint, GRPC, Headers, Model, ErrorCode
-├── exceptions.js     # custom error classes
+gemini-reverse/
+├── index.js
+├── index.d.ts
+├── client.js
+├── constants.js
+├── exceptions.js
 ├── types/
+│   ├── availablemodel.js
 │   ├── candidate.js
-│   ├── conversation.js
+│   ├── chathistory.js
+│   ├── chatinfo.js
 │   ├── gem.js
 │   ├── grpc.js
 │   ├── image.js
-│   └── modeloutput.js
+│   ├── modeloutput.js
+│   ├── research.js
+│   ├── researchresult.js
+│   └── video.js
 ├── utils/
 │   ├── accessToken.js
 │   ├── parsing.js
+│   ├── research.js
 │   ├── rotate.js
 │   └── upload.js
 └── components/
     ├── chatMixin.js
-    └── gemMixin.js
-```
-
----
-
-## Error Handling
-
-```js
-const {
-    AuthError,
-    APIError,
-    GeminiError,
-    TimeoutError,
-    UsageLimitExceeded,
-    ModelInvalid,
-    TemporarilyBlocked,
-} = require('gemini-api');
-
-try {
-    const response = await chat.sendMessage({ prompt: 'Hello!' });
-} catch (e) {
-    if (e instanceof AuthError) {
-        console.error('Cookie expired or invalid.');
-    } else if (e instanceof UsageLimitExceeded) {
-        console.error('Usage limit reached. Try again later or switch models.');
-    } else if (e instanceof TemporarilyBlocked) {
-        console.error('IP temporarily blocked. Try using a proxy.');
-    } else if (e instanceof TimeoutError) {
-        console.error('Request timed out.');
-    } else if (e instanceof ModelInvalid) {
-        console.error('Invalid or unavailable model.');
-    } else if (e instanceof APIError) {
-        console.error('API error:', e.message);
-    }
-}
+    ├── gemMixin.js
+    └── researchMixin.js
 ```
 
 ---
 
 ## Credits
 
-Inspired by [Gemini-API](https://github.com/HanaokaYuzu/Gemini-API) by [@HanaokaYuzu](https://github.com/HanaokaYuzu) — an unofficial Python client for Gemini through reverse engineering.
+Inspired by [Gemini-API](https://github.com/HanaokaYuzu/Gemini-API) by [@HanaokaYuzu](https://github.com/HanaokaYuzu).
 
 ---
 
 ## Disclaimer
 
-This is an unofficial package and is not affiliated with or endorsed by Google. Use at your own risk. Cookie-based authentication may break if Google changes its internal API.
+Unofficial package, not affiliated with Google. Use at your own risk.
 
 ---
 
 ## License
 
-MIT
+MIT