gemini-reverse 1.0.2 → 1.0.3

package/constants.js

@@ -1,7 +1,22 @@
 'use strict';
 
+const STREAMING_FLAG_INDEX = 7;
+const GEM_FLAG_INDEX = 19;
 const TEMPORARY_CHAT_FLAG_INDEX = 45;
 
+const CARD_CONTENT_RE = /^http:\/\/googleusercontent\.com\/card_content\/\d+/;
+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) {
+    return {
+        [MODEL_HEADER_KEY]: `[1,null,null,null,"${modelId}",null,null,0,[4],null,null,${capacityTail}]`,
+        'x-goog-ext-73010989-jspb': '[0]',
+        'x-goog-ext-73010990-jspb': '[0]',
+    };
+}
+
 const Endpoint = {
     GOOGLE: 'https://www.google.com',
     INIT: 'https://gemini.google.com/app',
@@ -14,73 +29,164 @@ const Endpoint = {
 const GRPC = {
     LIST_CHATS: 'MaZiqc',
     READ_CHAT: 'hNvQHb',
-    DELETE_CHAT: 'GzXR5e',
+    DELETE_CHAT_1: 'GzXR5e',
+    DELETE_CHAT_2: 'qWymEb',
     LIST_GEMS: 'CNgdBe',
     CREATE_GEM: 'oMH3Zd',
     UPDATE_GEM: 'kHv0Vd',
     DELETE_GEM: 'UXcSJb',
-    BARD_ACTIVITY: 'ESY5D',
+    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',
+    GET_USER_STATUS: 'otAQ7b',
+    LIST_MODELS: 'otAQ7b',
+    GET_FULL_SIZE_IMAGE: 'c8o8Fe',
+    BARD_SETTINGS: 'ESY5D',
 };
 
 const Headers = {
+    REFERER: {
+        'Origin': 'https://gemini.google.com',
+        'Referer': 'https://gemini.google.com/',
+    },
+    SAME_DOMAIN: {
+        'X-Same-Domain': '1',
+    },
     GEMINI: {
         'Content-Type': 'application/x-www-form-urlencoded;charset=utf-8',
-        'Host': 'gemini.google.com',
         'Origin': 'https://gemini.google.com',
         'Referer': 'https://gemini.google.com/',
-        'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/144.0.0.0 Safari/537.36',
-        'X-Same-Domain': '1',
     },
     ROTATE_COOKIES: {
         'Content-Type': 'application/json',
+        'Origin': 'https://accounts.google.com',
     },
-    UPLOAD: {
-        'Push-ID': 'feeds/mcudyrk2a4khkz',
+    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-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',
+];
+
 const Model = {
     UNSPECIFIED: { model_name: 'unspecified', model_header: {}, advanced_only: false },
-    G_3_1_PRO: {
-        model_name: 'gemini-3.1-pro',
-        model_header: {
-            'x-goog-ext-525001261-jspb': '[1,null,null,null,"e6fa609c3fa255c0",null,null,0,[4],null,null,2]',
-            'x-goog-ext-73010989-jspb': '[0]',
-            'x-goog-ext-73010990-jspb': '[0]',
-        },
+    BASIC_PRO: {
+        model_name: 'gemini-3-pro',
+        model_header: buildModelHeader('9d8ca3786ebdfbea', 1),
         advanced_only: false,
     },
-    G_3_0_FLASH: {
-        model_name: 'gemini-3.0-flash',
-        model_header: {
-            'x-goog-ext-525001261-jspb': '[1,null,null,null,"fbb127bbb056c959",null,null,0,[4],null,null,1]',
-            'x-goog-ext-73010989-jspb': '[0]',
-            'x-goog-ext-73010990-jspb': '[0]',
-        },
+    BASIC_FLASH: {
+        model_name: 'gemini-3-flash',
+        model_header: buildModelHeader('fbb127bbb056c959', 1),
         advanced_only: false,
     },
-    G_3_0_FLASH_THINKING: {
-        model_name: 'gemini-3.0-flash-thinking',
-        model_header: {
-            'x-goog-ext-525001261-jspb': '[1,null,null,null,"5bf011840784117a",null,null,0,[4],null,null,1]',
-            'x-goog-ext-73010989-jspb': '[0]',
-            'x-goog-ext-73010990-jspb': '[0]',
-        },
+    BASIC_THINKING: {
+        model_name: 'gemini-3-flash-thinking',
+        model_header: buildModelHeader('5bf011840784117a', 1),
         advanced_only: false,
     },
+    PLUS_PRO: {
+        model_name: 'gemini-3-pro-plus',
+        model_header: buildModelHeader('e6fa609c3fa255c0', 4),
+        advanced_only: true,
+    },
+    PLUS_FLASH: {
+        model_name: 'gemini-3-flash-plus',
+        model_header: buildModelHeader('56fdd199312815e2', 4),
+        advanced_only: true,
+    },
+    PLUS_THINKING: {
+        model_name: 'gemini-3-flash-thinking-plus',
+        model_header: buildModelHeader('e051ce1aa80aa576', 4),
+        advanced_only: true,
+    },
+    ADVANCED_PRO: {
+        model_name: 'gemini-3-pro-advanced',
+        model_header: buildModelHeader('e6fa609c3fa255c0', 2),
+        advanced_only: true,
+    },
+    ADVANCED_FLASH: {
+        model_name: 'gemini-3-flash-advanced',
+        model_header: buildModelHeader('56fdd199312815e2', 2),
+        advanced_only: true,
+    },
+    ADVANCED_THINKING: {
+        model_name: 'gemini-3-flash-thinking-advanced',
+        model_header: buildModelHeader('e051ce1aa80aa576', 2),
+        advanced_only: true,
+    },
     fromName(name) {
-        const legacy = { 'gemini-3.0-pro': 'gemini-3.1-pro' };
-        const resolved = legacy[name] || name;
-        for (const k of ['UNSPECIFIED', 'G_3_1_PRO', 'G_3_0_FLASH', 'G_3_0_FLASH_THINKING']) {
-            if (Model[k].model_name === resolved) return Model[k];
+        for (const k of _MODEL_KEYS) {
+            if (Model[k].model_name === name) return Model[k];
         }
-        throw new Error(`Unknown model name: ${name}. Available: ${['UNSPECIFIED', 'G_3_1_PRO', 'G_3_0_FLASH', 'G_3_0_FLASH_THINKING'].map(k => Model[k].model_name).join(', ')}`);
+        const names = _MODEL_KEYS.map(k => Model[k].model_name).join(', ');
+        throw new Error(`Unknown model name: ${name}. Available: ${names}`);
     },
     fromDict(d) {
-        if (!d.model_name || !d.model_header || typeof d.model_header !== 'object')
-            throw new Error('model_name and model_header (object) required');
+        if (!d.model_name || !d.model_header || typeof d.model_header !== 'object') {
+            throw new Error("model_name and model_header (object) required");
+        }
         return { model_name: d.model_name, model_header: d.model_header, advanced_only: false };
     },
+    modelId(model) {
+        const headerValue = model && model.model_header && model.model_header[MODEL_HEADER_KEY];
+        if (!headerValue) return '';
+        try {
+            const parsed = JSON.parse(headerValue);
+            return (parsed && parsed[4]) || '';
+        } catch {
+            return '';
+        }
+    },
+};
+
+class AccountStatus {
+    constructor(name, value, description) {
+        this.name = name;
+        this.value = value;
+        this.description = description;
+    }
+
+    static fromStatusCode(code) {
+        if (code == null || code === 1000) return AccountStatus.AVAILABLE;
+        for (const status of Object.values(AccountStatus._all)) {
+            if (status.value === code) return status;
+        }
+        return AccountStatus.ACCOUNT_REJECTED;
+    }
+}
+
+AccountStatus.AVAILABLE = new AccountStatus('AVAILABLE', 1000, 'Account is authorized and has normal access.');
+AccountStatus.ACCESS_TEMPORARILY_UNAVAILABLE = new AccountStatus('ACCESS_TEMPORARILY_UNAVAILABLE', 1014, 'Access is restricted, possibly due to regional or temporary session issues.');
+AccountStatus.UNAUTHENTICATED = new AccountStatus('UNAUTHENTICATED', 1016, 'Session is not authenticated or cookies have expired. Please check your cookies.');
+AccountStatus.ACCOUNT_REJECTED = new AccountStatus('ACCOUNT_REJECTED', 1021, 'Account access is rejected. Please check your Google Account settings.');
+AccountStatus.ACCOUNT_UNTRUSTED = new AccountStatus('ACCOUNT_UNTRUSTED', 1033, 'Account did not pass safety or trust checks for some features.');
+AccountStatus.TOS_PENDING = new AccountStatus('TOS_PENDING', 1040, 'You need to accept the latest Terms of Service to continue.');
+AccountStatus.TOS_OUT_OF_DATE = new AccountStatus('TOS_OUT_OF_DATE', 1042, 'Terms of Service are out of date; please accept the new ones.');
+AccountStatus.ACCOUNT_REJECTED_BY_GUARDIAN = new AccountStatus('ACCOUNT_REJECTED_BY_GUARDIAN', 1054, 'Access is blocked by a parent or guardian.');
+AccountStatus.GUARDIAN_APPROVAL_REQUIRED = new AccountStatus('GUARDIAN_APPROVAL_REQUIRED', 1057, 'Access requires parent or guardian approval.');
+AccountStatus.LOCATION_REJECTED = new AccountStatus('LOCATION_REJECTED', 1060, 'Gemini is not currently supported in your country/region.');
+
+AccountStatus._all = {
+    AVAILABLE: AccountStatus.AVAILABLE,
+    ACCESS_TEMPORARILY_UNAVAILABLE: AccountStatus.ACCESS_TEMPORARILY_UNAVAILABLE,
+    UNAUTHENTICATED: AccountStatus.UNAUTHENTICATED,
+    ACCOUNT_REJECTED: AccountStatus.ACCOUNT_REJECTED,
+    ACCOUNT_UNTRUSTED: AccountStatus.ACCOUNT_UNTRUSTED,
+    TOS_PENDING: AccountStatus.TOS_PENDING,
+    TOS_OUT_OF_DATE: AccountStatus.TOS_OUT_OF_DATE,
+    ACCOUNT_REJECTED_BY_GUARDIAN: AccountStatus.ACCOUNT_REJECTED_BY_GUARDIAN,
+    GUARDIAN_APPROVAL_REQUIRED: AccountStatus.GUARDIAN_APPROVAL_REQUIRED,
+    LOCATION_REJECTED: AccountStatus.LOCATION_REJECTED,
 };
 
 const ErrorCode = {
@@ -91,4 +197,19 @@ const ErrorCode = {
     IP_TEMPORARILY_BLOCKED: 1060,
 };
 
-module.exports = { TEMPORARY_CHAT_FLAG_INDEX, Endpoint, GRPC, Headers, Model, ErrorCode };
+module.exports = {
+    STREAMING_FLAG_INDEX,
+    GEM_FLAG_INDEX,
+    TEMPORARY_CHAT_FLAG_INDEX,
+    CARD_CONTENT_RE,
+    ARTIFACTS_RE,
+    DEFAULT_METADATA,
+    MODEL_HEADER_KEY,
+    buildModelHeader,
+    Endpoint,
+    GRPC,
+    Headers,
+    Model,
+    AccountStatus,
+    ErrorCode,
+};

package/index.d.ts

@@ -16,26 +16,71 @@ export interface ModelDict {
     model_header: ModelHeader;
 }
 
-export type ModelInput = string | ModelDef | ModelDict | null;
+export type ModelInput = string | ModelDef | ModelDict | AvailableModel | null;
+
+export declare function buildModelHeader(modelId: string, capacityTail: string | number): ModelHeader;
+
+export declare const MODEL_HEADER_KEY: string;
+export declare const STREAMING_FLAG_INDEX: number;
+export declare const GEM_FLAG_INDEX: number;
+export declare const TEMPORARY_CHAT_FLAG_INDEX: number;
+export declare const CARD_CONTENT_RE: RegExp;
+export declare const ARTIFACTS_RE: RegExp;
+export declare const DEFAULT_METADATA: (string | null)[];
 
 export declare const Model: {
     readonly UNSPECIFIED: ModelDef;
-    readonly G_3_1_PRO: ModelDef;
-    readonly G_3_0_FLASH: ModelDef;
-    readonly G_3_0_FLASH_THINKING: ModelDef;
+    readonly BASIC_PRO: ModelDef;
+    readonly BASIC_FLASH: ModelDef;
+    readonly BASIC_THINKING: ModelDef;
+    readonly PLUS_PRO: ModelDef;
+    readonly PLUS_FLASH: ModelDef;
+    readonly PLUS_THINKING: ModelDef;
+    readonly ADVANCED_PRO: ModelDef;
+    readonly ADVANCED_FLASH: ModelDef;
+    readonly ADVANCED_THINKING: ModelDef;
     fromName(name: string): ModelDef;
     fromDict(d: ModelDict): ModelDef;
+    modelId(model: ModelDef): string;
 };
 
+export declare class AccountStatus {
+    readonly name: string;
+    readonly value: number;
+    readonly description: string;
+    constructor(name: string, value: number, description: string);
+    static fromStatusCode(code: number | null | undefined): AccountStatus;
+    static readonly AVAILABLE: AccountStatus;
+    static readonly ACCESS_TEMPORARILY_UNAVAILABLE: AccountStatus;
+    static readonly UNAUTHENTICATED: AccountStatus;
+    static readonly ACCOUNT_REJECTED: AccountStatus;
+    static readonly ACCOUNT_UNTRUSTED: AccountStatus;
+    static readonly TOS_PENDING: AccountStatus;
+    static readonly TOS_OUT_OF_DATE: AccountStatus;
+    static readonly ACCOUNT_REJECTED_BY_GUARDIAN: AccountStatus;
+    static readonly GUARDIAN_APPROVAL_REQUIRED: AccountStatus;
+    static readonly LOCATION_REJECTED: AccountStatus;
+}
+
 export declare const GRPC: {
     readonly LIST_CHATS: string;
     readonly READ_CHAT: string;
-    readonly DELETE_CHAT: string;
+    readonly DELETE_CHAT_1: string;
+    readonly DELETE_CHAT_2: string;
     readonly LIST_GEMS: string;
     readonly CREATE_GEM: string;
     readonly UPDATE_GEM: string;
     readonly DELETE_GEM: string;
-    readonly BARD_ACTIVITY: string;
+    readonly DEEP_RESEARCH_STATUS: string;
+    readonly DEEP_RESEARCH_PREFS: string;
+    readonly DEEP_RESEARCH_BOOTSTRAP: string;
+    readonly DEEP_RESEARCH_MODEL_STATE: string;
+    readonly DEEP_RESEARCH_CAPS: string;
+    readonly DEEP_RESEARCH_ACK: string;
+    readonly GET_USER_STATUS: string;
+    readonly LIST_MODELS: string;
+    readonly GET_FULL_SIZE_IMAGE: string;
+    readonly BARD_SETTINGS: string;
 };
 
 export declare const Endpoint: {
@@ -48,9 +93,12 @@ export declare const Endpoint: {
 };
 
 export declare const Headers: {
+    readonly REFERER: Record<string, string>;
+    readonly SAME_DOMAIN: Record<string, string>;
     readonly GEMINI: Record<string, string>;
     readonly ROTATE_COOKIES: Record<string, string>;
     readonly UPLOAD: Record<string, string>;
+    readonly BATCH_EXEC: Record<string, string>;
 };
 
 export declare const ErrorCode: {
@@ -61,8 +109,6 @@ export declare const ErrorCode: {
     readonly IP_TEMPORARILY_BLOCKED: 1060;
 };
 
-export declare const TEMPORARY_CHAT_FLAG_INDEX: number;
-
 export declare class AuthError extends Error { name: 'AuthError'; }
 export declare class APIError extends Error { name: 'APIError'; }
 export declare class ImageGenerationError extends APIError { name: 'ImageGenerationError'; }
@@ -72,12 +118,35 @@ export declare class UsageLimitExceeded extends GeminiError { name: 'UsageLimitE
 export declare class ModelInvalid extends GeminiError { name: 'ModelInvalid'; }
 export declare class TemporarilyBlocked extends GeminiError { name: 'TemporarilyBlocked'; }
 
+export declare class AvailableModel {
+    model_id: string;
+    model_name: string;
+    display_name: string;
+    description: string;
+    capacity: number;
+    capacity_field: number;
+    is_available: boolean;
+    constructor(opts: {
+        model_id: string;
+        model_name: string;
+        display_name: string;
+        description: string;
+        capacity: number;
+        capacity_field?: number;
+        is_available?: boolean;
+    });
+    get model_header(): ModelHeader;
+    get advanced_only(): boolean;
+    toString(): string;
+    repr(): string;
+    static computeCapacity(tierFlags: number[], capabilityFlags: number[]): [number, number];
+    static buildModelIdNameMapping(): Record<string, string>;
+}
+
 export interface ImageSaveOptions {
     path?: string;
     filename?: string;
-    cookies?: Record<string, string> | null;
     verbose?: boolean;
-    skipInvalidFilename?: boolean;
 }
 
 export declare class Image {
@@ -92,14 +161,120 @@ export declare class Image {
 
 export declare class WebImage extends Image {}
 
-export interface GeneratedImageSaveOptions extends ImageSaveOptions {
-    fullSize?: boolean;
+export declare class GeneratedImage extends Image {
+    client_ref: GeminiClient | null;
+    cid: string;
+    rid: string;
+    rcid: string;
+    image_id: string;
+    constructor(opts: {
+        url: string;
+        title?: string;
+        alt?: string;
+        proxy?: string | null;
+        client_ref?: GeminiClient | null;
+        cid?: string;
+        rid?: string;
+        rcid?: string;
+        image_id?: string;
+    });
 }
 
-export declare class GeneratedImage extends Image {
-    cookies: Record<string, string>;
-    constructor(opts: { url: string; title?: string; alt?: string; proxy?: string | null; cookies: Record<string, string> });
-    save(opts?: GeneratedImageSaveOptions): Promise<string | null>;
+export interface VideoSaveOptions {
+    savePath?: string;
+    filename?: string;
+    verbose?: boolean;
+}
+
+export declare class Video {
+    url: string;
+    title: string;
+    proxy: string | null;
+    constructor(opts: { url: string; title?: string; proxy?: string | null });
+    save(opts?: VideoSaveOptions): Promise<{ video: string | null; video_thumbnail: string | null }>;
+    repr(): string;
+}
+
+export declare class GeneratedVideo extends Video {
+    thumbnail: string;
+    cid: string;
+    rid: string;
+    rcid: string;
+    client_ref: GeminiClient | null;
+    constructor(opts: {
+        url: string;
+        title?: string;
+        proxy?: string | null;
+        thumbnail?: string;
+        cid?: string;
+        rid?: string;
+        rcid?: string;
+        client_ref?: GeminiClient | null;
+    });
+}
+
+export declare class GeneratedMedia extends GeneratedVideo {
+    mp3_url: string;
+    mp3_thumbnail: string;
+    get mp4_url(): string;
+    set mp4_url(v: string);
+    get mp4_thumbnail(): string;
+    set mp4_thumbnail(v: string);
+    constructor(opts: {
+        url?: string;
+        title?: string;
+        proxy?: string | null;
+        thumbnail?: string;
+        mp3_url?: string;
+        mp3_thumbnail?: string;
+        cid?: string;
+        rid?: string;
+        rcid?: string;
+        client_ref?: GeminiClient | null;
+    });
+    save(opts?: VideoSaveOptions & { downloadType?: 'audio' | 'video' | 'both' }): Promise<Record<string, string | null>>;
+}
+
+export declare class DeepResearchPlan {
+    research_id: string | null;
+    title: string | null;
+    query: string | null;
+    steps: string[];
+    eta_text: string | null;
+    confirm_prompt: string | null;
+    modify_prompt: string | null;
+    confirmation_url: string | null;
+    metadata: (string | null)[];
+    cid: string | null;
+    response_text: string | null;
+    raw_state: number | null;
+    constructor(opts?: Partial<DeepResearchPlan>);
+    repr(): string;
+}
+
+export declare class DeepResearchStatus {
+    research_id: string;
+    state: string;
+    title: string | null;
+    query: string | null;
+    cid: string | null;
+    notes: string[];
+    done: boolean;
+    raw_state: number | null;
+    raw: unknown;
+    constructor(opts: { research_id: string; state?: string; title?: string | null; query?: string | null; cid?: string | null; notes?: string[]; done?: boolean; raw_state?: number | null; raw?: unknown });
+    repr(): string;
+}
+
+export declare class DeepResearchResult {
+    plan: DeepResearchPlan;
+    start_output: ModelOutput | null;
+    final_output: ModelOutput | null;
+    statuses: DeepResearchStatus[];
+    done: boolean;
+    constructor(opts: { plan: DeepResearchPlan; start_output?: ModelOutput | null; final_output?: ModelOutput | null; statuses?: DeepResearchStatus[]; done?: boolean });
+    get text(): string;
+    repr(): string;
 }
 
 export declare class Candidate {
@@ -110,6 +285,9 @@ export declare class Candidate {
     thoughts_delta: string | null;
     web_images: WebImage[];
     generated_images: GeneratedImage[];
+    generated_videos: GeneratedVideo[];
+    generated_media: GeneratedMedia[];
+    deep_research_plan: DeepResearchPlan | null;
     constructor(opts: {
         rcid: string;
         text: string;
@@ -118,6 +296,9 @@ export declare class Candidate {
         thoughts_delta?: string | null;
         web_images?: WebImage[];
         generated_images?: GeneratedImage[];
+        generated_videos?: GeneratedVideo[];
+        generated_media?: GeneratedMedia[];
+        deep_research_plan?: DeepResearchPlan | null;
     });
     get images(): (WebImage | GeneratedImage)[];
     toString(): string;
@@ -125,35 +306,46 @@ export declare class Candidate {
 }
 
 export declare class ModelOutput {
-    metadata: string[];
+    metadata: (string | null)[];
     candidates: Candidate[];
     chosen: number;
-    constructor(metadata: string[], candidates: Candidate[], chosen?: number);
+    constructor(metadata: (string | null)[], candidates: Candidate[], chosen?: number);
     get text(): string;
     get text_delta(): string;
     get thoughts(): string | null;
     get thoughts_delta(): string;
     get images(): (WebImage | GeneratedImage)[];
+    get videos(): GeneratedVideo[];
+    get media(): GeneratedMedia[];
+    get deep_research_plan(): DeepResearchPlan | null;
     get rcid(): string;
     toString(): string;
     repr(): string;
 }
 
-export declare class ConversationTurn {
-    rid: string;
-    user_prompt: string;
-    assistant_response: string;
-    rcid: string;
-    thoughts: string | null;
-    timestamp: Date | null;
-    constructor(opts: {
-        rid: string;
-        user_prompt: string;
-        assistant_response: string;
-        rcid: string;
-        thoughts?: string | null;
-        timestamp?: Date | string | null;
-    });
+export declare class ChatTurn {
+    role: 'user' | 'model';
+    text: string;
+    model_output: ModelOutput | null;
+    constructor(opts: { role: 'user' | 'model'; text: string; model_output?: ModelOutput | null });
+    toString(): string;
+    repr(): string;
+}
+
+export declare class ChatHistory {
+    cid: string;
+    turns: ChatTurn[];
+    constructor(opts: { cid: string; turns?: ChatTurn[] });
+    toString(): string;
+    repr(): string;
+}
+
+export declare class ChatInfo {
+    cid: string;
+    title: string;
+    is_pinned: boolean;
+    timestamp: number;
+    constructor(opts: { cid: string; title: string; is_pinned?: boolean; timestamp: number });
     toString(): string;
     repr(): string;
 }
@@ -224,13 +416,14 @@ export interface GenerateOptions {
     gem?: Gem | string | null;
     chat?: ChatSession | null;
     temporary?: boolean;
+    deep_research?: boolean;
 }
 
 export interface StartChatOptions {
-    metadata?: string[] | null;
-    cid?: string | null;
-    rid?: string | null;
-    rcid?: string | null;
+    metadata?: (string | null)[] | null;
+    cid?: string;
+    rid?: string;
+    rcid?: string;
     model?: ModelInput;
     gem?: Gem | string | null;
 }
@@ -259,6 +452,9 @@ export declare class GeminiClient {
     accessToken: string | null;
     buildLabel: string | null;
     sessionId: string | null;
+    language: string;
+    pushId: string;
+    accountStatus: AccountStatus;
     timeout: number;
     autoClose: boolean;
     closeDelay: number;
@@ -272,13 +468,16 @@ export declare class GeminiClient {
     init(opts?: InitOptions): Promise<void>;
     close(delay?: number): Promise<void>;
 
+    listModels(): AvailableModel[] | null;
+
     generateContent(opts: GenerateOptions): Promise<ModelOutput>;
     generateContentStream(opts: GenerateOptions): AsyncGenerator<ModelOutput>;
 
     startChat(opts?: StartChatOptions): ChatSession;
 
+    listChats(): ChatInfo[] | null;
+    readChat(cid: string, limit?: number): Promise<ChatHistory | null>;
     fetchLatestChatResponse(cid: string): Promise<ModelOutput | null>;
-    readChat(cid: string, maxTurns?: number): Promise<ConversationTurn[]>;
     deleteChat(cid: string): Promise<void>;
 
     get gems(): GemJar;
@@ -286,14 +485,21 @@ export declare class GeminiClient {
     createGem(opts: CreateGemOptions): Promise<Gem>;
     updateGem(opts: UpdateGemOptions): Promise<Gem>;
     deleteGem(gem: Gem | string): Promise<void>;
+
+    inspectAccountStatus(): Promise<Record<string, unknown>>;
+    createDeepResearchPlan(prompt: string, chat?: ChatSession | null, model?: ModelInput): Promise<DeepResearchPlan>;
+    startDeepResearch(plan: DeepResearchPlan, chat?: ChatSession | null, confirmPrompt?: string | null): Promise<ModelOutput>;
+    getDeepResearchStatus(researchId: string): Promise<DeepResearchStatus | null>;
+    waitForDeepResearch(plan: DeepResearchPlan, pollInterval?: number, timeout?: number, onStatus?: ((status: DeepResearchStatus) => void) | null): Promise<DeepResearchResult>;
+    deepResearch(prompt: string, pollInterval?: number, timeout?: number, onStatus?: ((status: DeepResearchStatus) => void) | null): Promise<DeepResearchResult>;
 }
 
 export interface ChatSessionOptions {
     geminiclient: GeminiClient;
-    metadata?: string[] | null;
-    cid?: string | null;
-    rid?: string | null;
-    rcid?: string | null;
+    metadata?: (string | null)[] | null;
+    cid?: string;
+    rid?: string;
+    rcid?: string;
     model?: ModelInput;
     gem?: Gem | string | null;
 }
@@ -302,18 +508,19 @@ export interface SendMessageOptions {
     prompt: string;
     files?: (string | Buffer)[] | null;
     temporary?: boolean;
+    deep_research?: boolean;
 }
 
 export declare class ChatSession {
     geminiclient: GeminiClient;
     lastOutput: ModelOutput | null;
-    model: ModelDef;
+    model: ModelDef | AvailableModel;
     gem: Gem | string | null;
 
     constructor(opts: ChatSessionOptions);
 
-    get metadata(): string[];
-    set metadata(v: string[]);
+    get metadata(): (string | null)[];
+    set metadata(v: (string | null)[]);
     get cid(): string;
     set cid(v: string);
     get rid(): string;
@@ -324,6 +531,7 @@ export declare class ChatSession {
     sendMessage(opts: SendMessageOptions): Promise<ModelOutput>;
     sendMessageStream(opts: SendMessageOptions): AsyncGenerator<ModelOutput>;
     chooseCandidate(index: number): ModelOutput;
+    readHistory(limit?: number): Promise<ChatHistory | null>;
 
     toString(): string;
-}
+}