camo-gemini 0.1.0

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/core/browser-js.d.ts

@@ -0,0 +1,27 @@
+interface GenerateExpressionParams {
+    url: string;
+    headers: Record<string, string>;
+    body: string;
+    bardActivityUrl: string;
+    bardActivityHeaders: Record<string, string>;
+    bardActivityBody: string;
+}
+interface BatchExpressionParams {
+    url: string;
+    headers: Record<string, string>;
+    body: string;
+}
+interface UploadFinalizeExpressionParams {
+    uploadId: string;
+    filename: string;
+    mimeType: string;
+    uploadUrl: string;
+    snlm0e: string;
+    accountIndex: number;
+}
+export declare function buildGenerateExpression(params: GenerateExpressionParams): string;
+export declare function buildBatchExpression(params: BatchExpressionParams): string;
+export declare function buildUploadChunkPushExpression(uploadId: string, chunk: string, chunkIndex: number): string;
+export declare function buildUploadFinalizeExpression(params: UploadFinalizeExpressionParams): string;
+export {};
+//# sourceMappingURL=browser-js.d.ts.map

package/dist/core/browser-js.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-js.d.ts","sourceRoot":"","sources":["../../src/core/browser-js.ts"],"names":[],"mappings":"AAEA,UAAU,wBAAwB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,qBAAqB;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,8BAA8B;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAaD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,CA0ChF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CA4B1E;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAM1G;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,8BAA8B,GAAG,MAAM,CAsF5F"}

package/dist/core/browser-js.js

@@ -0,0 +1,172 @@
+const MAX_EXPRESSION_BYTES = 64 * 1024;
+function assertExpressionSize(expression) {
+    const size = Buffer.byteLength(expression, "utf8");
+    if (size > MAX_EXPRESSION_BYTES) {
+        throw new Error(`Browser expression exceeds 64KB (${size} bytes)`);
+    }
+}
+function quote(value) {
+    return JSON.stringify(value);
+}
+export function buildGenerateExpression(params) {
+    const expression = `(async () => {
+  const bardActivityUrl = ${quote(params.bardActivityUrl)};
+  const bardActivityHeaders = ${quote(params.bardActivityHeaders)};
+  const bardActivityBody = ${quote(params.bardActivityBody)};
+  const url = ${quote(params.url)};
+  const headers = ${quote(params.headers)};
+  const body = ${quote(params.body)};
+
+  try {
+    const bardRes = await fetch(bardActivityUrl, {
+      method: 'POST',
+      headers: bardActivityHeaders,
+      body: bardActivityBody,
+      credentials: 'include'
+    });
+
+    if (!bardRes.ok) {
+      return { ok: false, error: 'BARD_ACTIVITY failed: ' + bardRes.status };
+    }
+
+    const res = await fetch(url, {
+      method: 'POST',
+      headers,
+      body,
+      credentials: 'include'
+    });
+
+    if (!res.ok) {
+      return { ok: false, error: 'StreamGenerate failed: ' + res.status };
+    }
+
+    const text = await res.text();
+    return { ok: true, data: text };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return { ok: false, error: message };
+  }
+})()`;
+    assertExpressionSize(expression);
+    return expression;
+}
+export function buildBatchExpression(params) {
+    const expression = `(async () => {
+  const url = ${quote(params.url)};
+  const headers = ${quote(params.headers)};
+  const body = ${quote(params.body)};
+
+  try {
+    const res = await fetch(url, {
+      method: 'POST',
+      headers,
+      body,
+      credentials: 'include'
+    });
+
+    if (!res.ok) {
+      return { ok: false, error: 'BatchExecute failed: ' + res.status };
+    }
+
+    const text = await res.text();
+    return { ok: true, data: text };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return { ok: false, error: message };
+  }
+})()`;
+    assertExpressionSize(expression);
+    return expression;
+}
+export function buildUploadChunkPushExpression(uploadId, chunk, chunkIndex) {
+    const globalKey = `__cg_upload_${uploadId}`;
+    const expression = `(window[${quote(globalKey)}] = window[${quote(globalKey)}] || []).push(${quote(chunk)}); void ${quote(chunkIndex)}; true`;
+    assertExpressionSize(expression);
+    return expression;
+}
+export function buildUploadFinalizeExpression(params) {
+    const globalKey = `__cg_upload_${params.uploadId}`;
+    const expression = `(async () => {
+  const globalKey = ${quote(globalKey)};
+  const uploadUrl = ${quote(params.uploadUrl)};
+  const filename = ${quote(params.filename)};
+  const mimeType = ${quote(params.mimeType)};
+  const snlm0e = ${quote(params.snlm0e)};
+  const accountIndex = ${quote(params.accountIndex)};
+
+  try {
+    const chunks = window[globalKey];
+    if (!Array.isArray(chunks)) {
+      return { ok: false, error: 'Missing upload chunks' };
+    }
+
+    const base64 = chunks.join('');
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+      bytes[i] = binary.charCodeAt(i);
+    }
+
+    const separator = uploadUrl.includes('?') ? '&' : '?';
+    const startUrl = uploadUrl + separator + 'authuser=' + encodeURIComponent(String(accountIndex)) + '&at=' + encodeURIComponent(snlm0e);
+
+    const startHeaders = {
+      Origin: 'https://gemini.google.com',
+      Referer: 'https://gemini.google.com/',
+      'Push-ID': 'feeds/mcudyrk2a4khkz',
+      'X-Goog-Upload-Command': 'start',
+      'X-Goog-Upload-Protocol': 'resumable',
+      'X-Goog-Upload-Header-Content-Length': String(bytes.byteLength),
+      'X-Goog-Upload-Header-Content-Type': mimeType,
+      'X-Tenant-ID': 'bard-storage'
+    };
+
+    const startRes = await fetch(startUrl, {
+      method: 'POST',
+      headers: startHeaders,
+      body: 'File name: ' + filename,
+      credentials: 'include'
+    });
+
+    if (!startRes.ok) {
+      return { ok: false, error: 'Upload start failed: ' + startRes.status };
+    }
+
+    const resumableUrl = startRes.headers.get('x-goog-upload-url');
+    if (!resumableUrl) {
+      return { ok: false, error: 'Missing x-goog-upload-url header' };
+    }
+
+    const finalizeHeaders = {
+      Origin: 'https://gemini.google.com',
+      Referer: 'https://gemini.google.com/',
+      'Push-ID': 'feeds/mcudyrk2a4khkz',
+      'X-Goog-Upload-Command': 'upload, finalize',
+      'X-Goog-Upload-Offset': '0',
+      'X-Tenant-ID': 'bard-storage'
+    };
+
+    const finalizeRes = await fetch(resumableUrl, {
+      method: 'POST',
+      headers: finalizeHeaders,
+      body: bytes,
+      credentials: 'include'
+    });
+
+    if (!finalizeRes.ok) {
+      return { ok: false, error: 'Upload finalize failed: ' + finalizeRes.status };
+    }
+
+    const responseText = await finalizeRes.text();
+    return { ok: true, data: responseText };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return { ok: false, error: message };
+  } finally {
+    delete window[globalKey];
+  }
+})()`;
+    assertExpressionSize(expression);
+    return expression;
+}
+//# sourceMappingURL=browser-js.js.map

package/dist/core/browser-js.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-js.js","sourceRoot":"","sources":["../../src/core/browser-js.ts"],"names":[],"mappings":"AAAA,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,CAAC;AA0BvC,SAAS,oBAAoB,CAAC,UAAkB;IAC9C,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACnD,IAAI,IAAI,GAAG,oBAAoB,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,SAAS,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,KAAc;IAC3B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAgC;IACtE,MAAM,UAAU,GAAG;4BACO,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC;gCACzB,KAAK,CAAC,MAAM,CAAC,mBAAmB,CAAC;6BACpC,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC;gBAC3C,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;oBACb,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;iBACxB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA+B9B,CAAC;IAEJ,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAA6B;IAChE,MAAM,UAAU,GAAG;gBACL,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;oBACb,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;iBACxB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;KAoB9B,CAAC;IAEJ,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,QAAgB,EAAE,KAAa,EAAE,UAAkB;IAChG,MAAM,SAAS,GAAG,eAAe,QAAQ,EAAE,CAAC;IAC5C,MAAM,UAAU,GAAG,WAAW,KAAK,CAAC,SAAS,CAAC,cAAc,KAAK,CAAC,SAAS,CAAC,iBAAiB,KAAK,CAAC,KAAK,CAAC,WAAW,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;IAE9I,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,MAAsC;IAClF,MAAM,SAAS,GAAG,eAAe,MAAM,CAAC,QAAQ,EAAE,CAAC;IAEnD,MAAM,UAAU,GAAG;sBACC,KAAK,CAAC,SAAS,CAAC;sBAChB,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC;qBACxB,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;qBACtB,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;mBACxB,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC;yBACd,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAyE9C,CAAC;IAEJ,oBAAoB,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/core/constants.d.ts

@@ -0,0 +1,78 @@
+import type { ChatMetadata } from "../types.js";
+export declare const GEMINI_BASE = "https://gemini.google.com";
+export declare const ANTI_XSSI_PREFIX = ")]}'";
+export declare const UPLOAD_URL = "https://push.clients6.google.com/upload/";
+export declare const MAX_UPLOAD_SIZE_BYTES: number;
+export declare const LOGIN_INITIAL_DELAY_MS = 3000;
+export declare const LOGIN_RETRY_DELAY_MS = 2000;
+export declare const TOKEN_REFRESH_DELAY_MS = 3000;
+export declare const TOKEN_VALIDITY_MS = 600000;
+export declare const DEFAULT_MAX_RETRIES = 5;
+export declare const DEFAULT_RETRY_DELAY_FACTOR = 5;
+export declare const HEALTH_BACKOFF_BASE_MS = 30000;
+export declare const HEALTH_BACKOFF_CAP_MS = 600000;
+export declare function getAccountPrefix(accountIndex: number): string;
+export declare const Endpoint: {
+    readonly GOOGLE: "https://www.google.com";
+    readonly INIT: (accountIndex?: number) => string;
+    readonly GENERATE: (accountIndex?: number) => string;
+    readonly BATCH_EXEC: (accountIndex?: number) => string;
+    readonly ROTATE_COOKIES: "https://accounts.google.com/RotateCookies";
+    readonly UPLOAD: (accountIndex?: number) => string;
+    readonly SOURCE_PATH: (accountIndex?: number) => string;
+};
+export declare const GrpcId: {
+    readonly LIST_CHATS: "MaZiqc";
+    readonly READ_CHAT: "hNvQHb";
+    readonly DELETE_CHAT: "GzXR5e";
+    readonly LIST_GEMS: "CNgdBe";
+    readonly CREATE_GEM: "oMH3Zd";
+    readonly UPDATE_GEM: "kHv0Vd";
+    readonly DELETE_GEM: "UXcSJb";
+    readonly BARD_ACTIVITY: "ESY5D";
+};
+export declare const GEMINI_HEADERS: {
+    readonly "Content-Type": "application/x-www-form-urlencoded;charset=utf-8";
+    readonly Origin: "https://gemini.google.com";
+    readonly Referer: "https://gemini.google.com/";
+    readonly "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";
+    readonly "X-Same-Domain": "1";
+};
+export declare const ROTATE_COOKIES_HEADERS: {
+    readonly "Content-Type": "application/json";
+};
+export interface GeminiModelDef {
+    readonly name: string;
+    readonly header: Readonly<Record<string, string>>;
+}
+export declare const MODELS: Readonly<Record<string, GeminiModelDef>>;
+export declare const MODEL_ALIASES: Readonly<Record<string, string>>;
+export declare const API_ERROR_CODES: {
+    readonly TEMPORARY_ERROR_1013: 1013;
+    readonly USAGE_LIMIT_EXCEEDED: 1037;
+    readonly MODEL_INCONSISTENT: 1050;
+    readonly MODEL_HEADER_INVALID: 1052;
+    readonly IP_TEMPORARILY_BLOCKED: 1060;
+};
+export declare const RATE_LIMIT_PATTERNS: RegExp[];
+export declare const IMAGE_GEN_BLOCKED_PATTERNS: RegExp[];
+export declare const GOOGLE_USER_CONTENT_PATTERN: RegExp;
+export declare const CARD_CONTENT_PATTERN: RegExp;
+export declare const TOKEN_PATTERNS: {
+    readonly SNlM0e: RegExp;
+    readonly cfb2h: RegExp;
+    readonly FdrFJe: RegExp;
+};
+export declare const COOKIE_ROTATION_INTERVAL_MS = 540000;
+export declare const COOKIE_NAMES: {
+    readonly PSID: "__Secure-1PSID";
+    readonly PSIDTS: "__Secure-1PSIDTS";
+    readonly PSIDCC: "__Secure-1PSIDCC";
+};
+export declare const DEFAULT_PARAMS: {
+    readonly bl: "boq_assistant-bard-web-server_20250601.00_p0";
+    readonly rt: "c";
+};
+export declare const INNER_REQ_LIST_SIZE = 73;
+export declare const NEW_CHAT_METADATA: ChatMetadata;
+//# sourceMappingURL=constants.d.ts.map

package/dist/core/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,WAAW,8BAA8B,CAAC;AACvD,eAAO,MAAM,gBAAgB,SAAS,CAAC;AACvC,eAAO,MAAM,UAAU,6CAA6C,CAAC;AACrE,eAAO,MAAM,qBAAqB,QAAmB,CAAC;AAGtD,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,iBAAiB,SAAU,CAAC;AAGzC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAG5C,eAAO,MAAM,sBAAsB,QAAQ,CAAC;AAC5C,eAAO,MAAM,qBAAqB,SAAS,CAAC;AAE5C,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,eAAO,MAAM,QAAQ;;;;;;;;CASX,CAAC;AAEX,eAAO,MAAM,MAAM;;;;;;;;;CAST,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX,eAAO,MAAM,sBAAsB;;CAEzB,CAAC;AAEX,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,eAAO,MAAM,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAuBlD,CAAC;AAEX,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIjD,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAEX,eAAO,MAAM,mBAAmB,UAI/B,CAAC;AAEF,eAAO,MAAM,0BAA0B,UAMtC,CAAC;AAEF,eAAO,MAAM,2BAA2B,QAAkD,CAAC;AAC3F,eAAO,MAAM,oBAAoB,QAAwD,CAAC;AAE1F,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX,eAAO,MAAM,2BAA2B,SAAU,CAAC;AAEnD,eAAO,MAAM,YAAY;;;;CAIf,CAAC;AAEX,eAAO,MAAM,cAAc;;;CAGjB,CAAC;AAEX,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,eAAO,MAAM,iBAAiB,EAAE,YAAmE,CAAC"}

package/dist/core/constants.js

@@ -0,0 +1,115 @@
+export const GEMINI_BASE = "https://gemini.google.com";
+export const ANTI_XSSI_PREFIX = ")]}'";
+export const UPLOAD_URL = "https://push.clients6.google.com/upload/";
+export const MAX_UPLOAD_SIZE_BYTES = 25 * 1024 * 1024;
+// === Timing Constants ===
+export const LOGIN_INITIAL_DELAY_MS = 3000;
+export const LOGIN_RETRY_DELAY_MS = 2000;
+export const TOKEN_REFRESH_DELAY_MS = 3000;
+export const TOKEN_VALIDITY_MS = 600_000;
+// === Retry Constants ===
+export const DEFAULT_MAX_RETRIES = 5;
+export const DEFAULT_RETRY_DELAY_FACTOR = 5;
+// === Health Constants ===
+export const HEALTH_BACKOFF_BASE_MS = 30000;
+export const HEALTH_BACKOFF_CAP_MS = 600000;
+export function getAccountPrefix(accountIndex) {
+    return accountIndex > 0 ? `/u/${accountIndex}` : "";
+}
+export const Endpoint = {
+    GOOGLE: "https://www.google.com",
+    INIT: (accountIndex = 0) => `${GEMINI_BASE}${getAccountPrefix(accountIndex)}/app`,
+    GENERATE: (accountIndex = 0) => `${GEMINI_BASE}${getAccountPrefix(accountIndex)}/_/BardChatUi/data/assistant.lamda.BardFrontendService/StreamGenerate`,
+    BATCH_EXEC: (accountIndex = 0) => `${GEMINI_BASE}${getAccountPrefix(accountIndex)}/_/BardChatUi/data/batchexecute`,
+    ROTATE_COOKIES: "https://accounts.google.com/RotateCookies",
+    UPLOAD: (accountIndex = 0) => `${UPLOAD_URL}?authuser=${accountIndex}`,
+    SOURCE_PATH: (accountIndex = 0) => `${getAccountPrefix(accountIndex)}/app`
+};
+export const GrpcId = {
+    LIST_CHATS: "MaZiqc",
+    READ_CHAT: "hNvQHb",
+    DELETE_CHAT: "GzXR5e",
+    LIST_GEMS: "CNgdBe",
+    CREATE_GEM: "oMH3Zd",
+    UPDATE_GEM: "kHv0Vd",
+    DELETE_GEM: "UXcSJb",
+    BARD_ACTIVITY: "ESY5D"
+};
+export const GEMINI_HEADERS = {
+    "Content-Type": "application/x-www-form-urlencoded;charset=utf-8",
+    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"
+};
+export const ROTATE_COOKIES_HEADERS = {
+    "Content-Type": "application/json"
+};
+export const MODELS = {
+    unspecified: {
+        name: "unspecified",
+        header: {}
+    },
+    "gemini-3.0-pro": {
+        name: "gemini-3.0-pro",
+        header: {
+            "x-goog-ext-525001261-jspb": '[1,null,null,null,"9d8ca3786ebdfbea",null,null,0,[4],null,null,1]'
+        }
+    },
+    "gemini-3.0-flash": {
+        name: "gemini-3.0-flash",
+        header: {
+            "x-goog-ext-525001261-jspb": '[1,null,null,null,"fbb127bbb056c959",null,null,0,[4],null,null,1]'
+        }
+    },
+    "gemini-3.0-flash-thinking": {
+        name: "gemini-3.0-flash-thinking",
+        header: {
+            "x-goog-ext-525001261-jspb": '[1,null,null,null,"5bf011840784117a",null,null,0,[4],null,null,1]'
+        }
+    }
+};
+export const MODEL_ALIASES = {
+    pro: "gemini-3.0-pro",
+    flash: "gemini-3.0-flash",
+    thinking: "gemini-3.0-flash-thinking"
+};
+export const API_ERROR_CODES = {
+    TEMPORARY_ERROR_1013: 1013,
+    USAGE_LIMIT_EXCEEDED: 1037,
+    MODEL_INCONSISTENT: 1050,
+    MODEL_HEADER_INVALID: 1052,
+    IP_TEMPORARILY_BLOCKED: 1060
+};
+export const RATE_LIMIT_PATTERNS = [
+    /I couldn't do that because I'm getting a lot of requests right now/i,
+    /I'm getting a lot of requests right now/i,
+    /Please try again later/i
+];
+export const IMAGE_GEN_BLOCKED_PATTERNS = [
+    /Are you signed in\?.*(?:search for images|can't.*create)/i,
+    /can't seem to create any.*for you right now/i,
+    /image creation isn't available in your location/i,
+    /I can search for images, but can't.*create/i,
+    /can't (?:generate|create) (?:more |any )?images/i
+];
+export const GOOGLE_USER_CONTENT_PATTERN = /http:\/\/googleusercontent\.com\/\w+\/\d+\n*/g;
+export const CARD_CONTENT_PATTERN = /^http:\/\/googleusercontent\.com\/card_content\/\d+/;
+export const TOKEN_PATTERNS = {
+    SNlM0e: /"SNlM0e":"(.*?)"/,
+    cfb2h: /"cfb2h":"(.*?)"/,
+    FdrFJe: /"FdrFJe":"(.*?)"/
+};
+export const COOKIE_ROTATION_INTERVAL_MS = 540_000;
+export const COOKIE_NAMES = {
+    PSID: "__Secure-1PSID",
+    PSIDTS: "__Secure-1PSIDTS",
+    PSIDCC: "__Secure-1PSIDCC"
+};
+export const DEFAULT_PARAMS = {
+    bl: "boq_assistant-bard-web-server_20250601.00_p0",
+    rt: "c"
+};
+export const INNER_REQ_LIST_SIZE = 73;
+export const NEW_CHAT_METADATA = ["", "", "", null, null, null, null, null, null, ""];
+//# sourceMappingURL=constants.js.map

package/dist/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/core/constants.ts"],"names":[],"mappings":"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"}

package/dist/core/error-messages.d.ts

@@ -0,0 +1,8 @@
+export interface FriendlyError {
+    code: string;
+    message: string;
+    suggestion: string;
+}
+export declare function getFriendlyError(error: Error): FriendlyError;
+export declare function formatFriendlyError(error: Error): string;
+//# sourceMappingURL=error-messages.d.ts.map

package/dist/core/error-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-messages.d.ts","sourceRoot":"","sources":["../../src/core/error-messages.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAmFD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,CAyC5D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAGxD"}

package/dist/core/error-messages.js

@@ -0,0 +1,121 @@
+const errorCatalog = {
+    CAMOFOX_UNREACHABLE: {
+        code: "CAMOFOX_UNREACHABLE",
+        message: "Cannot connect to CamoFox browser",
+        suggestion: "Start CamoFox browser: cd camofox-browser && npm start"
+    },
+    AUTH_REQUIRED: {
+        code: "AUTH_REQUIRED",
+        message: "No active Gemini session. Please login first.",
+        suggestion: "Use gemini_login tool or add an account via gemini_add_account"
+    },
+    AUTH_FAILED: {
+        code: "AUTH_FAILED",
+        message: "Google login failed or session expired",
+        suggestion: "Try logging in again. Ensure your Google account has Gemini access."
+    },
+    TOKEN_EXTRACTION_FAILED: {
+        code: "TOKEN_EXTRACTION_FAILED",
+        message: "Failed to extract Gemini security tokens",
+        suggestion: "Session may have expired. Try logging out and back in."
+    },
+    RATE_LIMITED: {
+        code: "RATE_LIMITED",
+        message: "Gemini rate limit reached for this account",
+        suggestion: "Wait a moment or switch to a different account with gemini_add_account"
+    },
+    IMAGE_GEN_BLOCKED: {
+        code: "IMAGE_GEN_BLOCKED",
+        message: "Image generation is blocked for this account",
+        suggestion: "Try running gemini_logout then gemini_login to refresh your session. If the issue persists, image generation may require visiting gemini.google.com in a browser first to accept terms."
+    },
+    RETRY_EXHAUSTED: {
+        code: "RETRY_EXHAUSTED",
+        message: "Operation failed after multiple retries",
+        suggestion: "Check CamoFox browser status and network connectivity. If using multiple accounts, failover was attempted."
+    },
+    UPLOAD_TOO_LARGE: {
+        code: "UPLOAD_TOO_LARGE",
+        message: "File exceeds the 25MB upload limit",
+        suggestion: "Reduce file size or compress before uploading"
+    },
+    ACCOUNT_NOT_FOUND: {
+        code: "ACCOUNT_NOT_FOUND",
+        message: "The specified account is not registered",
+        suggestion: "Add the account first with gemini_add_account"
+    },
+    ACCOUNT_COOLDOWN: {
+        code: "ACCOUNT_COOLDOWN",
+        message: "This account is in cooldown due to repeated errors",
+        suggestion: "Wait for cooldown to expire or use a different account"
+    },
+    ALL_ACCOUNTS_UNHEALTHY: {
+        code: "ALL_ACCOUNTS_UNHEALTHY",
+        message: "No healthy accounts available for this operation",
+        suggestion: "Check account health with gemini_health. Login to additional accounts or wait for cooldowns to expire."
+    },
+    NETWORK_ERROR: {
+        code: "NETWORK_ERROR",
+        message: "Network connection error",
+        suggestion: "Check your internet connection and CamoFox browser status"
+    },
+    INVALID_RESPONSE: {
+        code: "INVALID_RESPONSE",
+        message: "Received unexpected response from Gemini",
+        suggestion: "This may be a temporary issue. Try again in a few seconds."
+    },
+    CHAT_SESSION_NOT_FOUND: {
+        code: "CHAT_SESSION_NOT_FOUND",
+        message: "Chat session not found",
+        suggestion: "Start a new chat with gemini_chat. Sessions are per-account."
+    },
+    GEM_NOT_FOUND: {
+        code: "GEM_NOT_FOUND",
+        message: "The specified Gem was not found",
+        suggestion: "List available Gems with gemini_list_gems"
+    }
+};
+export function getFriendlyError(error) {
+    const code = error.code;
+    if (code && errorCatalog[code]) {
+        return errorCatalog[code];
+    }
+    const msg = error.message.toLowerCase();
+    if (msg.includes("econnrefused") || msg.includes("fetch failed") || msg.includes("camofox")) {
+        return errorCatalog.CAMOFOX_UNREACHABLE;
+    }
+    if (msg.includes("not logged in") || msg.includes("no active session") || msg.includes("no session")) {
+        return errorCatalog.AUTH_REQUIRED;
+    }
+    if (msg.includes("rate limit") || msg.includes("429") || msg.includes("too many requests")) {
+        return errorCatalog.RATE_LIMITED;
+    }
+    if (msg.includes("retry") && msg.includes("exhausted")) {
+        return errorCatalog.RETRY_EXHAUSTED;
+    }
+    if (msg.includes("upload") && (msg.includes("large") || msg.includes("25mb") || msg.includes("size"))) {
+        return errorCatalog.UPLOAD_TOO_LARGE;
+    }
+    if (msg.includes("network") || msg.includes("failed to fetch") || msg.includes("networkerror")) {
+        return errorCatalog.NETWORK_ERROR;
+    }
+    if (msg.includes("account") && msg.includes("not registered")) {
+        return errorCatalog.ACCOUNT_NOT_FOUND;
+    }
+    if (msg.includes("cooldown")) {
+        return errorCatalog.ACCOUNT_COOLDOWN;
+    }
+    if (msg.includes("chat") && msg.includes("not found")) {
+        return errorCatalog.CHAT_SESSION_NOT_FOUND;
+    }
+    return {
+        code: "UNKNOWN",
+        message: error.message,
+        suggestion: "Check the error details and try again. Use gemini_health to check system status."
+    };
+}
+export function formatFriendlyError(error) {
+    const friendly = getFriendlyError(error);
+    return `Error: ${friendly.message}\nSuggestion: ${friendly.suggestion}`;
+}
+//# sourceMappingURL=error-messages.js.map

package/dist/core/error-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-messages.js","sourceRoot":"","sources":["../../src/core/error-messages.ts"],"names":[],"mappings":"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"}

package/dist/core/failover.d.ts

@@ -0,0 +1,21 @@
+import type { StateManager } from "../state.js";
+export interface FailoverOptions {
+    /** Account index to try first */
+    accountIndex: number;
+    /** Maximum failover attempts (default: 2) */
+    maxFailovers?: number;
+}
+export interface FailoverResult<T> {
+    result: T;
+    /** Account index that actually succeeded */
+    usedAccountIndex: number;
+    /** Number of failover attempts */
+    failoverCount: number;
+}
+/**
+ * Execute operation with automatic account failover.
+ * On retryable/rate_limited errors, tries next healthy account.
+ * On fatal errors, does NOT failover.
+ */
+export declare function withFailover<T>(state: StateManager, options: FailoverOptions, operation: (accountIndex: number) => Promise<T>): Promise<FailoverResult<T>>;
+//# sourceMappingURL=failover.d.ts.map

package/dist/core/failover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failover.d.ts","sourceRoot":"","sources":["../../src/core/failover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKhD,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC;IACV,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GAC9C,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CA0C5B"}

package/dist/core/failover.js

@@ -0,0 +1,47 @@
+import { RetryExhaustedError } from "../errors.js";
+import { classifyError } from "./retry.js";
+import { logger } from "./logger.js";
+/**
+ * Execute operation with automatic account failover.
+ * On retryable/rate_limited errors, tries next healthy account.
+ * On fatal errors, does NOT failover.
+ */
+export async function withFailover(state, options, operation) {
+    const maxFailovers = options.maxFailovers ?? 2;
+    let currentIndex = options.accountIndex;
+    let failoverCount = 0;
+    let lastError;
+    const tried = new Set();
+    while (failoverCount <= maxFailovers) {
+        tried.add(currentIndex);
+        try {
+            const result = await operation(currentIndex);
+            state.recordSuccess(currentIndex);
+            return { result, usedAccountIndex: currentIndex, failoverCount };
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            lastError = error;
+            state.recordError(currentIndex);
+            if (!(error instanceof RetryExhaustedError)) {
+                const classification = classifyError(error);
+                if (classification === "fatal") {
+                    throw error;
+                }
+            }
+            const next = state.getNextHealthyAccount(currentIndex);
+            if (!next || tried.has(next.accountIndex)) {
+                throw error;
+            }
+            logger.warn("failover", "Switching account", {
+                fromIndex: currentIndex,
+                toIndex: next.accountIndex,
+                reason: error.message
+            });
+            currentIndex = next.accountIndex;
+            failoverCount += 1;
+        }
+    }
+    throw lastError ?? new Error("Failover exhausted");
+}
+//# sourceMappingURL=failover.js.map

package/dist/core/failover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failover.js","sourceRoot":"","sources":["../../src/core/failover.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAiBrC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAmB,EACnB,OAAwB,EACxB,SAA+C;IAE/C,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC;IAC/C,IAAI,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IACxC,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,SAA4B,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,OAAO,aAAa,IAAI,YAAY,EAAE,CAAC;QACrC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,YAAY,CAAC,CAAC;YAC7C,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;YAClC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;QACnE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,SAAS,GAAG,KAAK,CAAC;YAClB,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YAEhC,IAAI,CAAC,CAAC,KAAK,YAAY,mBAAmB,CAAC,EAAE,CAAC;gBAC5C,MAAM,cAAc,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;gBAC5C,IAAI,cAAc,KAAK,OAAO,EAAE,CAAC;oBAC/B,MAAM,KAAK,CAAC;gBACd,CAAC;YACH,CAAC;YAED,MAAM,IAAI,GAAG,KAAK,CAAC,qBAAqB,CAAC,YAAY,CAAC,CAAC;YACvD,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC1C,MAAM,KAAK,CAAC;YACd,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,EAAE;gBAC3C,SAAS,EAAE,YAAY;gBACvB,OAAO,EAAE,IAAI,CAAC,YAAY;gBAC1B,MAAM,EAAE,KAAK,CAAC,OAAO;aACtB,CAAC,CAAC;YAEH,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;YACjC,aAAa,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;AACrD,CAAC"}