@wenathlan/devthink 2.0.13 → 2.0.15

package/dist/config.d.ts

@@ -0,0 +1,1853 @@
+export type DevThinkConfig = {
+    activeProvider?: string | undefined;
+    activeModel?: string | undefined;
+    provider?: string;
+    model?: string;
+    mode?: string;
+    baseUrl?: string;
+    apiKey?: string;
+    anthropicApiKey?: string;
+    googleApiKey?: string;
+    zaiApiKey?: string;
+    temperature?: number;
+    maxTokens?: number;
+    projectMemory?: boolean;
+    externalMemory?: boolean;
+    fallbackProviders?: string[];
+    providers?: Record<string, {
+        baseUrl?: string;
+        apiKey?: string;
+        model?: string;
+        transport?: "official" | "openai-compatible" | "local-gateway";
+        auth?: {
+            kind: "api-key" | "bearer" | "oauth";
+            value?: string;
+            expiresAt?: number;
+        };
+    }>;
+    gateway?: {
+        mode?: "embedded";
+        stream?: boolean;
+        host?: string;
+    };
+    web?: {
+        enabled?: boolean;
+        pagesUrl?: string;
+        gatewayUrl?: string;
+        allowedOrigins?: string[];
+        remoteSync?: {
+            enabled?: boolean;
+            endpoint?: string;
+        };
+    };
+};
+export type AuthKind = "api-key" | "bearer" | "oauth";
+export type AuthCredential = {
+    kind: AuthKind;
+    value?: string;
+    accessToken?: string;
+    refreshToken?: string;
+    expiresAt?: number | undefined;
+    resourceUrl?: string;
+    updatedAt: string;
+};
+export type DevThinkAuth = {
+    version: 1;
+    providers: Record<string, AuthCredential>;
+};
+export type DevThinkPaths = {
+    home: string;
+    config: string;
+    auth: string;
+    identity: string;
+    pairings: string;
+    legacyConfig: string;
+    sessions: string;
+    workspaces: string;
+    database: string;
+    legacyDatabase: string;
+    memory: string;
+    logs: string;
+};
+export declare function resolvePaths(root?: string): DevThinkPaths;
+export declare function ensurePaths(paths?: DevThinkPaths): DevThinkPaths;
+export declare function readConfig(paths?: DevThinkPaths): DevThinkConfig;
+export declare function saveConfig(config: DevThinkConfig, paths?: DevThinkPaths): void;
+export declare function readAuth(paths?: DevThinkPaths): DevThinkAuth;
+export declare function saveAuth(auth: DevThinkAuth, paths?: DevThinkPaths): void;
+export declare function setAuthCredential(provider: string, credential: Omit<AuthCredential, "updatedAt">, paths?: DevThinkPaths): DevThinkAuth;
+export declare function clearAuthCredential(provider: string, paths?: DevThinkPaths): DevThinkAuth;
+export declare function migrateLegacyCredentials(config: DevThinkConfig, paths?: DevThinkPaths): {
+    config: DevThinkConfig;
+    migrated: string[];
+};
+export declare function getConfigValue(config: DevThinkConfig, key: string): unknown;
+export declare function setConfigValue(config: DevThinkConfig, key: string, value: unknown): DevThinkConfig;
+export declare function resolveCredential(provider: string, config: DevThinkConfig, paths?: DevThinkPaths): string | undefined;
+export declare function redactValue(value: unknown): unknown;
+export declare function redactAuth(auth: DevThinkAuth): Record<string, unknown>;
+export declare function redactConfig(config: DevThinkConfig): Record<string, unknown>;
+export declare function parseConfigValue(raw: string): unknown;
+/**
+ * OAuth2 Client ID of the Gemini CLI (Google Cloud Code).
+ * @readonly
+ */
+/**
+ * OAuth2 Client Secret of the Gemini CLI.
+ * @readonly
+ * @security This secret is public inside the Gemini CLI binary; it is not a private secret.
+ */
+/**
+ * OAuth scopes required for Cloud Code + identity.
+ * @readonly
+ */
+/**
+ * OAuth scopes as a space-separated string, ready for token requests.
+ */
+export declare const OAUTH_SCOPE_STRING: string;
+/**
+ * Canonical Gemini CLI User-Agent.
+ * Format: GeminiCLI/<version>/<default-model> (<platform>; <arch>; GitHub) google-api-nodejs-client/<gaxios-ver>
+ * Note: platform varies to avoid static fingerprinting.
+ * @readonly
+ */
+/** Fingerprinted google-api-nodejs-client version. */
+export declare const GOOGLE_API_CLIENT_VERSION: "9.15.1";
+/** Fingerprinted GeminiCLI version. */
+export declare const GEMINI_CLI_VERSION: "0.57.0";
+/** Default model announced in the User-Agent. */
+export declare const GEMINI_CLI_DEFAULT_MODEL: "gemini-3-pro-preview";
+/**
+ * X-Goog-Api-Client header value (Node.js runtime fingerprint).
+ * @readonly
+ */
+/**
+ * Client metadata used for bypass (IDE_UNSPECIFIED = pure CLI).
+ * @readonly
+ */
+/**
+ * Client-Metadata serialized as an `X-Goog-Client-Metadata` header string / payload.
+ */
+/**
+ * Project fallback when the cloud project cannot be resolved via loadCodeAssist.
+ * @readonly
+ */
+/** Cloud Code Assist PA (Playground API) base endpoints. */
+import { MODELS_2026_LEGACY as MODELS_2026 } from "./models.js";
+import type { RotationStrategy } from "./accounts.js";
+export type { RotationStrategy };
+import type { Model2026 } from "./models.js";
+export { MODELS_2026 };
+export type { Model2026 };
+/**
+ * Normalized platform tuple used for UA fingerprinting.
+ * Converts Node os.platform()/arch() into the strings Google expects.
+ */
+export type PlatformTuple = {
+    platform: string;
+    arch: string;
+};
+/**
+ * Returns the platform/arch tuple in the format used by the official UA.
+ * Example: linux -> linux, darwin -> darwin, win32 -> win32
+ * @returns {PlatformTuple}
+ */
+export declare function getPlatformTuple(): PlatformTuple;
+/**
+ * Builds the GeminiCLI User-Agent dynamically, varying the platform.
+ * Avoids static fingerprinting at the WAF level.
+ *
+ * Template: GeminiCLI/<cliVersion>/<model> (<platform>; <arch>; GitHub) google-api-nodejs-client/<gclientVersion>
+ *
+ * @param overrides - optional override of platform / cliVersion / model
+ * @returns User-Agent string ready for the `User-Agent` header
+ */
+/**
+ * Builds a dynamic X-Goog-Api-Client header based on the current Node version,
+ * falling back to the static constant when process.versions is unavailable.
+ */
+export declare function buildXGoogApiClient(): string;
+/** Complete identification headers for bypass. */
+export declare function getBypassHeaders(): Record<string, string>;
+export declare const ROTATION_STRATEGIES: readonly ["round-robin", "sticky"];
+/** Notification/toast display scope for opencode. */
+export type ToastScope = "all" | "project" | "minimal" | "none";
+/**
+ * Quota fallback mode.
+ * - true: enables automatic fallback to a reserve model
+ * - false: disables fallback, hard failure on 429
+ * - "auto": system picks the best model with remaining quota
+ * - string: specific model name to fall back to
+ */
+export type QuotaFallback = boolean | "auto" | string;
+export type DebugLevel = "debug" | "info" | "warn" | "error" | "silent";
+export interface DebugObjectConfig {
+    /** enable debug logging */
+    enabled?: boolean;
+    /** log level */
+    level?: DebugLevel;
+    /** custom log file path */
+    log_file?: string | null;
+    /** retention days */
+    retain_days?: number;
+    /** max bytes before rotation, e.g. 10MB */
+    max_bytes?: number;
+    /** TUI circular buffer lines */
+    tui_buffer_lines?: number;
+    /** redact secrets in logs */
+    redact_secrets?: boolean;
+}
+export type DebugConfig = boolean | DebugObjectConfig;
+export interface GoogleSearchConfig {
+    /** enable google_search tool injection */
+    enabled?: boolean;
+    /** model used for search grounding, defaults to gemini-3-flash */
+    model?: string;
+    /** enable url_context companion tool */
+    url_context?: boolean;
+    /** include groundingMetadata in response */
+    include_grounding_metadata?: boolean;
+}
+export interface EndpointOverrides {
+    /** prod: https://cloudcode-pa.googleapis.com */
+    prod?: string;
+    /** daily: https://daily-cloudcode-pa.googleapis.com */
+    daily?: string;
+    /** sandbox: https://daily-cloudcode-pa.sandbox.googleapis.com */
+    sandbox?: string;
+    /** autopush: https://autopush-cloudcode-pa.sandbox.googleapis.com */
+    autopush?: string;
+    /** quota endpoint override */
+    quota?: string;
+    /** models endpoint override */
+    models?: string;
+    /** gemini cli companion endpoint */
+    gemini_cli?: string;
+    /** cloudaicompanion.googleapis.com */
+    cloud_companion?: string;
+    /** generateContent base */
+    generate?: string;
+    /** streamGenerateContent base */
+    stream_generate?: string;
+}
+/**
+ * Quota settings block of antigravity.json (v2.1.15 Phase D: renamed from
+ * QuotaSettings — quota.js owns that name with the runtime quota shape; this
+ * is the user-facing config-file schema).
+ */
+export interface QuotaSettings {
+    refresh_interval_minutes?: number;
+    cache_ttl_minutes?: number;
+    soft_threshold?: number;
+    hard_threshold?: number;
+    dual_pool?: boolean;
+    [k: string]: unknown;
+}
+export interface BypassMetadata {
+    /** fallback version when dynamic fetch fails */
+    version_fallback?: string;
+    /** min supported version */
+    min_supported?: string;
+    /** custom user agent override — observer warns to keep antigravity/{semver} {os}/{arch} pattern */
+    user_agent?: string;
+    /** strip x-goog-user-project header to avoid 403 */
+    strip_user_project_header?: boolean;
+    /** enable fingerprint jitter 0-80ms */
+    fingerprint_jitter?: boolean;
+    /** pid offset trick for Gemini CLI bypass */
+    pid_offset?: boolean;
+}
+export interface AntigravityConfig {
+    /** json schema pointer, optional */
+    $schema?: string;
+    /** config version, integer */
+    version?: number;
+    /** try Gemini CLI pool first (v2 default false / v1 default true) */
+    cli_first?: boolean;
+    /** apply PID offset to avoid automation detection */
+    pid_offset_enabled?: boolean;
+    /** quota refresh interval in minutes */
+    quota_refresh_interval_minutes?: number;
+    /** enable Google grounded search (google_search tool) */
+    google_search_enabled?: boolean;
+    /** debug flag or object (boolean in v1, boolean|object in v2) */
+    debug?: DebugConfig;
+    /** account rotation strategy */
+    rotation_strategy?: RotationStrategy;
+    /** alias kept for backward compat with older schema */
+    account_rotation?: RotationStrategy;
+    /** boolean debug shortcut */
+    debug_enabled?: boolean;
+    /** full google search object */
+    google_search?: GoogleSearchConfig;
+    /** endpoint overrides */
+    endpoints?: EndpointOverrides;
+    /** quota sub-config */
+    quota?: QuotaSettings;
+    /** bypass metadata */
+    bypass?: BypassMetadata;
+    /** fallback project id blinded */
+    fallback_project_id?: string;
+    /** default chat model 2026 */
+    default_model?: string;
+    /** search/grounding model */
+    search_model?: string;
+    /** client id override — public client, do not commit secret */
+    client_id?: string | null;
+    /** client secret override — optional, blinded in logs */
+    client_secret?: string | null;
+    /** accounts file path override */
+    accounts_file?: string | null;
+    /** model allowlist custom */
+    models_allowlist?: string[];
+    /** enable fetch interceptor stripping */
+    strip_user_project?: boolean;
+    /** toast/notification display scope (v1, default "all") */
+    toast_scope?: ToastScope;
+    /** quota percentage where soft warning/fallback starts (v1, default 90, range 0-100) */
+    soft_quota_threshold_percent?: number;
+    /** fallback strategy when quota hits threshold (v1, default "auto") */
+    quota_fallback?: QuotaFallback;
+    /** soft quota cache TTL in minutes (v1, default 5, range 1-1440) */
+    soft_quota_cache_ttl_minutes?: number;
+    /** version/update check cache TTL in minutes (v1, default 60, range 1-10080) */
+    version_cache_ttl?: number;
+    /** extra */
+    [k: string]: unknown;
+}
+export declare const DEFAULT_ENDPOINTS: Readonly<Required<Pick<EndpointOverrides, "prod" | "daily" | "sandbox" | "autopush">>>;
+export declare const DEFAULT_QUOTA: Required<QuotaSettings>;
+export declare const DEFAULT_BYPASS: Required<BypassMetadata>;
+export declare const DEFAULT_DEBUG_OBJECT: Required<DebugObjectConfig>;
+export declare const DEFAULT_GOOGLE_SEARCH: Required<GoogleSearchConfig>;
+export declare function getDefaultConfig(): AntigravityConfig;
+export declare const CONFIG_DEFAULTS: AntigravityConfig;
+/**
+ * Immutable v1 default configuration.
+ */
+export declare const DEFAULT_CONFIG: Readonly<AntigravityConfig>;
+/**
+ * Schema for ~/.config/opencode/antigravity.json
+ * The observer documents this file with third-person view and bilingual help.
+ */
+export declare const ANTIGRAVITY_CONFIG_JSON_SCHEMA: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly $id: "https://opencode.ai/schemas/antigravity.json";
+    readonly title: "devthink provider config — antigravity.json";
+    readonly description: "Configuration for the devthink provider plugin. Bypass metadata: mimics antigravity/{ver} {os}/{arch} User-Agent, strips x-goog-user-project, endpoint cascade 403/404/5xx, supports Gemini CLI dual quota pool, round-robin/sticky rotation, google_search grounding.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly $schema: {
+            readonly type: "string";
+            readonly format: "uri";
+            readonly description: "JSON schema pointer";
+            readonly default: "https://json-schema.org/draft-07/schema#";
+            readonly examples: readonly ["https://json-schema.org/draft-07/schema#", "./antigravity.schema.json"];
+        };
+        readonly version: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 10;
+            readonly default: 2;
+            readonly description: "config version";
+            readonly examples: readonly [2];
+        };
+        readonly cli_first: {
+            readonly type: "boolean";
+            readonly default: false;
+            readonly description: "When true, tries Gemini CLI quota pool first before Antigravity pool. Useful when Antigravity quota is exhausted but CLI pool still has tokens.";
+            readonly examples: readonly [false, true];
+        };
+        readonly pid_offset_enabled: {
+            readonly type: "boolean";
+            readonly default: false;
+            readonly description: "Enables PID offset trick to bypass per-PID rate limiting observed in Gemini CLI gateway. When enabled, adds pid % 1000 to jitter.";
+            readonly examples: readonly [false, true];
+        };
+        readonly quota_refresh_interval_minutes: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 120;
+            readonly default: 15;
+            readonly description: "Interval in minutes for background quota refresh. Adaptive TTL 2-10min when near soft threshold 90%.";
+            readonly examples: readonly [5, 15, 30];
+        };
+        readonly rotation_strategy: {
+            readonly type: "string";
+            readonly enum: string[];
+            readonly default: "round-robin";
+            readonly description: "Multi-account rotation strategy — round-robin distributes evenly, sticky keeps same account until quota exhausted.";
+            readonly examples: readonly ["round-robin", "sticky"];
+        };
+        readonly account_rotation: {
+            readonly type: "string";
+            readonly enum: string[];
+            readonly default: "round-robin";
+            readonly description: "Alias for rotation_strategy (backward compat)";
+            readonly examples: readonly ["round-robin", "sticky"];
+        };
+        readonly debug: {
+            readonly oneOf: readonly [{
+                readonly type: "boolean";
+            }, {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly enabled: {
+                        readonly type: "boolean";
+                        readonly default: false;
+                        readonly description: "enable debug";
+                        readonly examples: readonly [false, true];
+                    };
+                    readonly level: {
+                        readonly type: "string";
+                        readonly enum: readonly ["debug", "info", "warn", "error", "silent"];
+                        readonly default: "warn";
+                        readonly description: "log level";
+                        readonly examples: readonly ["debug", "warn"];
+                    };
+                    readonly log_file: {
+                        readonly type: readonly ["string", "null"];
+                        readonly default: null;
+                        readonly description: "custom log file path";
+                        readonly examples: readonly [null, "~/.config/opencode/antigravity-debug.log"];
+                    };
+                    readonly retain_days: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 90;
+                        readonly default: 7;
+                        readonly description: "log retention days";
+                        readonly examples: readonly [7];
+                    };
+                    readonly max_bytes: {
+                        readonly type: "integer";
+                        readonly minimum: 1024;
+                        readonly maximum: number;
+                        readonly default: 10485760;
+                        readonly description: "max bytes before rotation, 10MB default";
+                        readonly examples: readonly [10485760];
+                    };
+                    readonly tui_buffer_lines: {
+                        readonly type: "integer";
+                        readonly minimum: 10;
+                        readonly maximum: 10000;
+                        readonly default: 1000;
+                        readonly description: "circular TUI buffer lines";
+                        readonly examples: readonly [1000];
+                    };
+                    readonly redact_secrets: {
+                        readonly type: "boolean";
+                        readonly default: true;
+                        readonly description: "redact secrets in logs";
+                        readonly examples: readonly [true];
+                    };
+                };
+            }];
+            readonly default: false;
+            readonly description: "Debug mode — boolean or object with rotation, retention, redaction.";
+            readonly examples: readonly [false, true, {
+                readonly enabled: true;
+                readonly level: "debug";
+            }];
+        };
+        readonly debug_enabled: {
+            readonly type: "boolean";
+            readonly default: false;
+            readonly description: "shortcut for debug.enabled";
+            readonly examples: readonly [false, true];
+        };
+        readonly google_search_enabled: {
+            readonly type: "boolean";
+            readonly default: true;
+            readonly description: "Enable native google_search grounding tool (Gemini) injection.";
+            readonly examples: readonly [true, false];
+        };
+        readonly google_search: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly default: {
+                readonly enabled: boolean;
+                readonly model: string;
+                readonly url_context: boolean;
+                readonly include_grounding_metadata: boolean;
+            };
+            readonly description: "Google search grounding full config";
+            readonly properties: {
+                readonly enabled: {
+                    readonly type: "boolean";
+                    readonly default: true;
+                    readonly description: "enable google_search tool";
+                    readonly examples: readonly [true, false];
+                };
+                readonly model: {
+                    readonly type: "string";
+                    readonly default: "gemini-3-flash";
+                    readonly description: "model used for search grounding";
+                    readonly examples: readonly ["gemini-3-flash", "gemini-3-flash-preview"];
+                };
+                readonly url_context: {
+                    readonly type: "boolean";
+                    readonly default: true;
+                    readonly description: "enable url_context companion tool";
+                    readonly examples: readonly [true, false];
+                };
+                readonly include_grounding_metadata: {
+                    readonly type: "boolean";
+                    readonly default: true;
+                    readonly description: "include groundingMetadata in response";
+                    readonly examples: readonly [true];
+                };
+            };
+        };
+        readonly endpoints: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly description: "Override Antigravity endpoints. Observer warns: must use https and googleapis.com for bypass.";
+            readonly properties: {
+                readonly prod: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly default: "https://cloudcode-pa.googleapis.com";
+                    readonly description: "PROD endpoint";
+                    readonly examples: readonly ["https://cloudcode-pa.googleapis.com"];
+                };
+                readonly daily: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly default: "https://daily-cloudcode-pa.googleapis.com";
+                    readonly description: "DAILY endpoint";
+                    readonly examples: readonly ["https://daily-cloudcode-pa.googleapis.com"];
+                };
+                readonly sandbox: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly default: "https://daily-cloudcode-pa.sandbox.googleapis.com";
+                    readonly description: "SANDBOX endpoint";
+                    readonly examples: readonly ["https://daily-cloudcode-pa.sandbox.googleapis.com"];
+                };
+                readonly autopush: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly default: "https://autopush-cloudcode-pa.sandbox.googleapis.com";
+                    readonly description: "AUTOPUSH optional";
+                    readonly examples: readonly ["https://autopush-cloudcode-pa.sandbox.googleapis.com"];
+                };
+                readonly quota: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly description: "quota endpoint override";
+                    readonly examples: readonly ["https://cloudcode-pa.googleapis.com"];
+                };
+                readonly models: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly description: "models endpoint override";
+                    readonly examples: readonly ["https://cloudcode-pa.googleapis.com"];
+                };
+                readonly gemini_cli: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly description: "Gemini CLI companion endpoint";
+                    readonly examples: readonly ["https://cloudaicompanion.googleapis.com"];
+                };
+                readonly cloud_companion: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly description: "cloudaicompanion.googleapis.com";
+                    readonly examples: readonly ["https://cloudaicompanion.googleapis.com"];
+                };
+                readonly generate: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly description: "generateContent base";
+                    readonly examples: readonly ["https://cloudcode-pa.googleapis.com"];
+                };
+                readonly stream_generate: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly description: "streamGenerateContent base";
+                    readonly examples: readonly ["https://cloudcode-pa.googleapis.com"];
+                };
+            };
+        };
+        readonly quota: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly description: "Quota config";
+            readonly properties: {
+                readonly refresh_interval_minutes: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 120;
+                    readonly default: 15;
+                    readonly examples: readonly [15];
+                };
+                readonly cache_ttl_minutes: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 60;
+                    readonly default: 15;
+                    readonly examples: readonly [15];
+                };
+                readonly soft_threshold: {
+                    readonly type: "number";
+                    readonly minimum: 0.1;
+                    readonly maximum: 1;
+                    readonly default: 0.9;
+                    readonly examples: readonly [0.9];
+                };
+                readonly hard_threshold: {
+                    readonly type: "number";
+                    readonly minimum: 0.5;
+                    readonly maximum: 1;
+                    readonly default: 1;
+                    readonly examples: readonly [1];
+                };
+                readonly dual_pool: {
+                    readonly type: "boolean";
+                    readonly default: true;
+                    readonly description: "enable dual pool Antigravity + Gemini CLI";
+                    readonly examples: readonly [true];
+                };
+            };
+        };
+        readonly bypass: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly description: "Bypass metadata — documents how library imitates Antigravity traffic. UA must match antigravity/{semver} {os}/{arch}.";
+            readonly properties: {
+                readonly version_fallback: {
+                    readonly type: "string";
+                    readonly pattern: "^\\d+\\.\\d+\\.\\d+";
+                    readonly default: "1.19.2";
+                    readonly examples: readonly ["1.19.2"];
+                };
+                readonly min_supported: {
+                    readonly type: "string";
+                    readonly pattern: "^\\d+\\.\\d+\\.\\d+";
+                    readonly default: "1.15.8";
+                    readonly examples: readonly ["1.15.8"];
+                };
+                readonly user_agent: {
+                    readonly type: "string";
+                    readonly default: "antigravity/1.19.2";
+                    readonly description: "full UA, should contain antigravity/ prefix";
+                    readonly examples: readonly ["antigravity/1.19.2 darwin/arm64", "antigravity/1.19.2 linux/x64"];
+                };
+                readonly strip_user_project_header: {
+                    readonly type: "boolean";
+                    readonly default: true;
+                    readonly description: "strip x-goog-user-project to avoid 403";
+                    readonly examples: readonly [true];
+                };
+                readonly fingerprint_jitter: {
+                    readonly type: "boolean";
+                    readonly default: true;
+                    readonly examples: readonly [true];
+                };
+                readonly pid_offset: {
+                    readonly type: "boolean";
+                    readonly default: false;
+                    readonly examples: readonly [false, true];
+                };
+            };
+        };
+        readonly fallback_project_id: {
+            readonly type: "string";
+            readonly minLength: 3;
+            readonly default: "rising-fact-p41fc";
+            readonly description: "fallback project id blinded";
+            readonly examples: readonly ["rising-fact-p41fc"];
+        };
+        readonly default_model: {
+            readonly type: "string";
+            readonly default: "antigravity-gemini-3-flash";
+            readonly description: "default chat model 2026";
+            readonly examples: readonly ["antigravity-gemini-3-flash", "gemini-3-pro-preview"];
+        };
+        readonly search_model: {
+            readonly type: "string";
+            readonly default: "gemini-3-flash";
+            readonly description: "search grounding model";
+            readonly examples: readonly ["gemini-3-flash", "gemini-3-flash-preview"];
+        };
+        readonly client_id: {
+            readonly type: readonly ["string", "null"];
+            readonly default: null;
+            readonly description: "OAuth client_id override (public)";
+            readonly examples: readonly [null, "1071006060591-...apps.googleusercontent.com"];
+        };
+        readonly client_secret: {
+            readonly type: readonly ["string", "null"];
+            readonly default: null;
+            readonly description: "OAuth client_secret override — do not commit";
+            readonly examples: readonly [null];
+        };
+        readonly accounts_file: {
+            readonly type: readonly ["string", "null"];
+            readonly default: null;
+            readonly format: "uri-reference";
+            readonly description: "custom accounts file path";
+            readonly examples: readonly [null, "~/.config/opencode/antigravity-accounts.json"];
+        };
+        readonly models_allowlist: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly default: readonly [];
+            readonly description: "optional model allowlist";
+            readonly examples: readonly [readonly [], readonly ["antigravity-gemini-3-flash", "claude-opus-4-6-thinking"]];
+        };
+        readonly strip_user_project: {
+            readonly type: "boolean";
+            readonly default: true;
+            readonly description: "legacy alias for bypass.strip_user_project_header";
+            readonly examples: readonly [true];
+        };
+        readonly toast_scope: {
+            readonly type: "string";
+            readonly enum: readonly ["all", "project", "minimal", "none"];
+            readonly default: "all";
+            readonly description: "toast/notification display scope (v1 field)";
+            readonly examples: readonly ["all", "project", "minimal", "none"];
+        };
+        readonly soft_quota_threshold_percent: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 100;
+            readonly default: 90;
+            readonly description: "quota percentage where soft warning/fallback starts (v1 field)";
+            readonly examples: readonly [90];
+        };
+        readonly quota_fallback: {
+            readonly oneOf: readonly [{
+                readonly type: "boolean";
+            }, {
+                readonly type: "string";
+            }];
+            readonly default: "auto";
+            readonly description: 'fallback strategy on quota exhaustion: boolean | "auto" | modelName (v1 field)';
+            readonly examples: readonly ["auto", true, false];
+        };
+        readonly soft_quota_cache_ttl_minutes: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 1440;
+            readonly default: 5;
+            readonly description: "soft quota cache TTL in minutes (v1 field)";
+            readonly examples: readonly [5];
+        };
+        readonly version_cache_ttl: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 10080;
+            readonly default: 60;
+            readonly description: "version/update check cache TTL in minutes (v1 field)";
+            readonly examples: readonly [60];
+        };
+    };
+    readonly required: readonly [];
+};
+/**
+ * The observer resolves config directory honoring OPENCODE_CONFIG_DIR.
+ */
+export declare function resolveConfigDir(): string;
+/**
+ * Resolves full antigravity.json path.
+ * @param customPath - optional explicit path from caller
+ */
+export declare function resolveConfigPath(customPath?: string): string;
+/**
+ * Returns the absolute config file path for the current OS:
+ * ~/.config/opencode/antigravity.json.
+ * Honors XDG_CONFIG_HOME on Linux when defined.
+ *
+ * @returns absolute path
+ */
+export declare function getConfigPath(): string;
+export interface ValidationError {
+    path: string;
+    message: string;
+    value?: unknown;
+}
+/**
+ * Unified config validation error.
+ * - v2 signature: new ConfigValidationError(message, structuredErrors[])
+ * - v1 signature: new ConfigValidationError(stringErrorList)
+ */
+export declare class ConfigValidationError extends Error {
+    readonly errors: ReadonlyArray<ValidationError | string>;
+    constructor(messageOrErrors: string | ReadonlyArray<string>, errors?: ReadonlyArray<ValidationError>);
+}
+/**
+ * Validates config strictly for production.
+ * The observer collects all errors before throwing, to give full feedback.
+ *
+ * @param input - raw parsed json
+ * @returns sanitized AntigravityConfig
+ * @throws ConfigValidationError when invalid
+ */
+export declare function validate(input: unknown): AntigravityConfig;
+export declare function validateConfig(input: unknown): {
+    valid: boolean;
+    errors: ValidationError[];
+    config?: AntigravityConfig | undefined;
+};
+/**
+ * Validates and normalizes a partial config object, merging with defaults.
+ * No zod — manual validation for zero deps.
+ *
+ * @param raw - raw object read from JSON
+ * @param opts.strict - when true, throws ConfigValidationError on errors; otherwise uses defaults and accumulates warnings
+ * @returns sanitized config
+ */
+export declare function parseAndValidateConfig(raw: unknown, opts?: {
+    strict?: boolean;
+}): AntigravityConfig;
+/**
+ * Lightweight validation returning the error list without throwing;
+ * useful for diagnostics.
+ */
+export declare function validateConfigRaw(raw: unknown): {
+    valid: boolean;
+    errors: string[];
+    config: AntigravityConfig;
+};
+/**
+ * The observer returns fresh defaults without leaking references.
+ */
+export declare function defaults(): AntigravityConfig;
+/**
+ * Clears the in-memory cache (useful for tests or when the file changed externally).
+ */
+export declare function clearConfigCache(): void;
+/**
+ * Loads configuration from disk with an mtime-based in-memory cache.
+ * - If the file does not exist, returns defaults.
+ * - If JSON is invalid, returns defaults (+ logs a warning when debug).
+ * - Refreshes the in-memory cache.
+ *
+ * This is the preserved v1 synchronous cached API; other modules import it
+ * by this exact name.
+ *
+ * @param opts - force: when true ignores the in-memory cache
+ * @returns sanitized AntigravityConfig
+ */
+export declare function loadConfig(opts?: {
+    force?: boolean;
+}): AntigravityConfig;
+/**
+ * Saves the full configuration atomically with chmod 0o600.
+ * Refreshes the in-memory cache.
+ *
+ * Preserved v1 synchronous cached API.
+ *
+ * @param config - full (validated) config object
+ * @returns saved config (clone)
+ */
+export declare function agsaveConfig(config: AntigravityConfig): AntigravityConfig;
+/**
+ * Partially updates the config: shallow merge + atomic save.
+ * Safe enough for single-process use; multi-process safety relies on atomic rename.
+ *
+ * @param partial - fields to update
+ * @returns full updated config
+ *
+ * @example
+ * updateConfig({ debug: true, toast_scope: "minimal" })
+ */
+export declare function updateConfig(partial: Partial<AntigravityConfig>): AntigravityConfig;
+/**
+ * Async loader (v2 implementation).
+ *
+ * - Passing a string `customPath` performs the v2 flow: read the given path,
+ *   merge defaults, strictly validate, throw ConfigValidationError on
+ *   corruption, return defaults silently when the file is missing.
+ * - Passing `{ force }` or nothing delegates to the v1 synchronous cached
+ *   loader wrapped in a Promise (preserves the original v1 wrapper contract).
+ *
+ * @param customPathOrOpts - explicit config path (v2) or cache options (v1)
+ */
+export declare function loadConfigAsync(customPathOrOpts?: string | {
+    force?: boolean;
+}): Promise<AntigravityConfig>;
+/**
+ * Async saver (v2 implementation): merges with defaults, validates, then
+ * writes atomically (tmp + chmod 600 + rename).
+ *
+ * Note: returns the written file path (v2 semantics). Callers that need the
+ * saved config clone can use the synchronous agsaveConfig.
+ *
+ * @param cfg - partial or full config, merged with defaults then validated
+ * @param customPath - optional explicit path override
+ * @returns written file path
+ */
+export declare function saveConfigAsync(cfg: Partial<AntigravityConfig> | AntigravityConfig, customPath?: string): Promise<string>;
+/**
+ * Async version of updateConfig (v1 wrapper over the sync implementation).
+ */
+export declare function updateConfigAsync(partial: Partial<AntigravityConfig>): Promise<AntigravityConfig>;
+/**
+ * Sync load — for CLI bootstrap where async is not convenient.
+ * Same semantics as the v2 async loader but synchronous and uncached.
+ */
+export declare function loadConfigSync(customPath?: string): AntigravityConfig;
+/**
+ * Sync save atomic — writes tmp, chmod, rename.
+ */
+export declare function saveConfigSync(cfg: Partial<AntigravityConfig> | AntigravityConfig, customPath?: string): string;
+/**
+ * Safe debug info (no secret). Intended for logging with debug enabled.
+ */
+export declare function getSafeDebugInfo(): {
+    readonly configPath: string;
+    readonly clientId: string;
+    readonly projectFallback: "rising-fact-p41fc";
+    readonly endpoints: {
+        readonly base: "https://cloudcode-pa.googleapis.com";
+        readonly loadCodeAssist: "https://cloudcode-pa.googleapis.com/v1internal:loadCodeAssist";
+        readonly onboardUser: "https://cloudcode-pa.googleapis.com/v1internal:onboardUser";
+        readonly fetchAvailableModels: "https://cloudcode-pa.googleapis.com/v1internal:fetchAvailableModels";
+        readonly generateContent: "https://cloudcode-pa.googleapis.com/v1internal:generateContent";
+        readonly streamGenerateContent: "https://cloudcode-pa.googleapis.com/v1internal:streamGenerateContent";
+        readonly retrieveUserQuotaSummary: "https://cloudcode-pa.googleapis.com/v1internal:retrieveUserQuotaSummary";
+    };
+    readonly modelsCount: 11;
+    readonly platform: string;
+    readonly arch: string;
+    readonly userAgent: string;
+    readonly xGoog: string;
+    readonly clientMetadata: "ideType=IDE_UNSPECIFIED,platform=PLATFORM_UNSPECIFIED,pluginType=GEMINI";
+};
+export declare const Config: {
+    resolveConfigDir: typeof resolveConfigDir;
+    resolveConfigPath: typeof resolveConfigPath;
+    getConfigPath: typeof getConfigPath;
+    getDefaultConfig: typeof getDefaultConfig;
+    defaults: typeof defaults;
+    DEFAULT_CONFIG: Readonly<AntigravityConfig>;
+    validate: typeof validate;
+    validateConfig: typeof validateConfig;
+    validateConfigRaw: typeof validateConfigRaw;
+    parseAndValidateConfig: typeof parseAndValidateConfig;
+    loadConfig: typeof loadConfig;
+    agsaveConfig: typeof agsaveConfig;
+    updateConfig: typeof updateConfig;
+    clearConfigCache: typeof clearConfigCache;
+    loadConfigAsync: typeof loadConfigAsync;
+    saveConfigAsync: typeof saveConfigAsync;
+    updateConfigAsync: typeof updateConfigAsync;
+    loadConfigSync: typeof loadConfigSync;
+    saveConfigSync: typeof saveConfigSync;
+    getSafeDebugInfo: typeof getSafeDebugInfo;
+    schema: {
+        readonly $schema: "http://json-schema.org/draft-07/schema#";
+        readonly $id: "https://opencode.ai/schemas/antigravity.json";
+        readonly title: "devthink provider config — antigravity.json";
+        readonly description: "Configuration for the devthink provider plugin. Bypass metadata: mimics antigravity/{ver} {os}/{arch} User-Agent, strips x-goog-user-project, endpoint cascade 403/404/5xx, supports Gemini CLI dual quota pool, round-robin/sticky rotation, google_search grounding.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly $schema: {
+                readonly type: "string";
+                readonly format: "uri";
+                readonly description: "JSON schema pointer";
+                readonly default: "https://json-schema.org/draft-07/schema#";
+                readonly examples: readonly ["https://json-schema.org/draft-07/schema#", "./antigravity.schema.json"];
+            };
+            readonly version: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 10;
+                readonly default: 2;
+                readonly description: "config version";
+                readonly examples: readonly [2];
+            };
+            readonly cli_first: {
+                readonly type: "boolean";
+                readonly default: false;
+                readonly description: "When true, tries Gemini CLI quota pool first before Antigravity pool. Useful when Antigravity quota is exhausted but CLI pool still has tokens.";
+                readonly examples: readonly [false, true];
+            };
+            readonly pid_offset_enabled: {
+                readonly type: "boolean";
+                readonly default: false;
+                readonly description: "Enables PID offset trick to bypass per-PID rate limiting observed in Gemini CLI gateway. When enabled, adds pid % 1000 to jitter.";
+                readonly examples: readonly [false, true];
+            };
+            readonly quota_refresh_interval_minutes: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 120;
+                readonly default: 15;
+                readonly description: "Interval in minutes for background quota refresh. Adaptive TTL 2-10min when near soft threshold 90%.";
+                readonly examples: readonly [5, 15, 30];
+            };
+            readonly rotation_strategy: {
+                readonly type: "string";
+                readonly enum: string[];
+                readonly default: "round-robin";
+                readonly description: "Multi-account rotation strategy — round-robin distributes evenly, sticky keeps same account until quota exhausted.";
+                readonly examples: readonly ["round-robin", "sticky"];
+            };
+            readonly account_rotation: {
+                readonly type: "string";
+                readonly enum: string[];
+                readonly default: "round-robin";
+                readonly description: "Alias for rotation_strategy (backward compat)";
+                readonly examples: readonly ["round-robin", "sticky"];
+            };
+            readonly debug: {
+                readonly oneOf: readonly [{
+                    readonly type: "boolean";
+                }, {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly enabled: {
+                            readonly type: "boolean";
+                            readonly default: false;
+                            readonly description: "enable debug";
+                            readonly examples: readonly [false, true];
+                        };
+                        readonly level: {
+                            readonly type: "string";
+                            readonly enum: readonly ["debug", "info", "warn", "error", "silent"];
+                            readonly default: "warn";
+                            readonly description: "log level";
+                            readonly examples: readonly ["debug", "warn"];
+                        };
+                        readonly log_file: {
+                            readonly type: readonly ["string", "null"];
+                            readonly default: null;
+                            readonly description: "custom log file path";
+                            readonly examples: readonly [null, "~/.config/opencode/antigravity-debug.log"];
+                        };
+                        readonly retain_days: {
+                            readonly type: "integer";
+                            readonly minimum: 1;
+                            readonly maximum: 90;
+                            readonly default: 7;
+                            readonly description: "log retention days";
+                            readonly examples: readonly [7];
+                        };
+                        readonly max_bytes: {
+                            readonly type: "integer";
+                            readonly minimum: 1024;
+                            readonly maximum: number;
+                            readonly default: 10485760;
+                            readonly description: "max bytes before rotation, 10MB default";
+                            readonly examples: readonly [10485760];
+                        };
+                        readonly tui_buffer_lines: {
+                            readonly type: "integer";
+                            readonly minimum: 10;
+                            readonly maximum: 10000;
+                            readonly default: 1000;
+                            readonly description: "circular TUI buffer lines";
+                            readonly examples: readonly [1000];
+                        };
+                        readonly redact_secrets: {
+                            readonly type: "boolean";
+                            readonly default: true;
+                            readonly description: "redact secrets in logs";
+                            readonly examples: readonly [true];
+                        };
+                    };
+                }];
+                readonly default: false;
+                readonly description: "Debug mode — boolean or object with rotation, retention, redaction.";
+                readonly examples: readonly [false, true, {
+                    readonly enabled: true;
+                    readonly level: "debug";
+                }];
+            };
+            readonly debug_enabled: {
+                readonly type: "boolean";
+                readonly default: false;
+                readonly description: "shortcut for debug.enabled";
+                readonly examples: readonly [false, true];
+            };
+            readonly google_search_enabled: {
+                readonly type: "boolean";
+                readonly default: true;
+                readonly description: "Enable native google_search grounding tool (Gemini) injection.";
+                readonly examples: readonly [true, false];
+            };
+            readonly google_search: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly default: {
+                    readonly enabled: boolean;
+                    readonly model: string;
+                    readonly url_context: boolean;
+                    readonly include_grounding_metadata: boolean;
+                };
+                readonly description: "Google search grounding full config";
+                readonly properties: {
+                    readonly enabled: {
+                        readonly type: "boolean";
+                        readonly default: true;
+                        readonly description: "enable google_search tool";
+                        readonly examples: readonly [true, false];
+                    };
+                    readonly model: {
+                        readonly type: "string";
+                        readonly default: "gemini-3-flash";
+                        readonly description: "model used for search grounding";
+                        readonly examples: readonly ["gemini-3-flash", "gemini-3-flash-preview"];
+                    };
+                    readonly url_context: {
+                        readonly type: "boolean";
+                        readonly default: true;
+                        readonly description: "enable url_context companion tool";
+                        readonly examples: readonly [true, false];
+                    };
+                    readonly include_grounding_metadata: {
+                        readonly type: "boolean";
+                        readonly default: true;
+                        readonly description: "include groundingMetadata in response";
+                        readonly examples: readonly [true];
+                    };
+                };
+            };
+            readonly endpoints: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly description: "Override Antigravity endpoints. Observer warns: must use https and googleapis.com for bypass.";
+                readonly properties: {
+                    readonly prod: {
+                        readonly type: "string";
+                        readonly format: "uri";
+                        readonly default: "https://cloudcode-pa.googleapis.com";
+                        readonly description: "PROD endpoint";
+                        readonly examples: readonly ["https://cloudcode-pa.googleapis.com"];
+                    };
+                    readonly daily: {
+                        readonly type: "string";
+                        readonly format: "uri";
+                        readonly default: "https://daily-cloudcode-pa.googleapis.com";
+                        readonly description: "DAILY endpoint";
+                        readonly examples: readonly ["https://daily-cloudcode-pa.googleapis.com"];
+                    };
+                    readonly sandbox: {
+                        readonly type: "string";
+                        readonly format: "uri";
+                        readonly default: "https://daily-cloudcode-pa.sandbox.googleapis.com";
+                        readonly description: "SANDBOX endpoint";
+                        readonly examples: readonly ["https://daily-cloudcode-pa.sandbox.googleapis.com"];
+                    };
+                    readonly autopush: {
+                        readonly type: "string";
+                        readonly format: "uri";
+                        readonly default: "https://autopush-cloudcode-pa.sandbox.googleapis.com";
+                        readonly description: "AUTOPUSH optional";
+                        readonly examples: readonly ["https://autopush-cloudcode-pa.sandbox.googleapis.com"];
+                    };
+                    readonly quota: {
+                        readonly type: "string";
+                        readonly format: "uri";
+                        readonly description: "quota endpoint override";
+                        readonly examples: readonly ["https://cloudcode-pa.googleapis.com"];
+                    };
+                    readonly models: {
+                        readonly type: "string";
+                        readonly format: "uri";
+                        readonly description: "models endpoint override";
+                        readonly examples: readonly ["https://cloudcode-pa.googleapis.com"];
+                    };
+                    readonly gemini_cli: {
+                        readonly type: "string";
+                        readonly format: "uri";
+                        readonly description: "Gemini CLI companion endpoint";
+                        readonly examples: readonly ["https://cloudaicompanion.googleapis.com"];
+                    };
+                    readonly cloud_companion: {
+                        readonly type: "string";
+                        readonly format: "uri";
+                        readonly description: "cloudaicompanion.googleapis.com";
+                        readonly examples: readonly ["https://cloudaicompanion.googleapis.com"];
+                    };
+                    readonly generate: {
+                        readonly type: "string";
+                        readonly format: "uri";
+                        readonly description: "generateContent base";
+                        readonly examples: readonly ["https://cloudcode-pa.googleapis.com"];
+                    };
+                    readonly stream_generate: {
+                        readonly type: "string";
+                        readonly format: "uri";
+                        readonly description: "streamGenerateContent base";
+                        readonly examples: readonly ["https://cloudcode-pa.googleapis.com"];
+                    };
+                };
+            };
+            readonly quota: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly description: "Quota config";
+                readonly properties: {
+                    readonly refresh_interval_minutes: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 120;
+                        readonly default: 15;
+                        readonly examples: readonly [15];
+                    };
+                    readonly cache_ttl_minutes: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 60;
+                        readonly default: 15;
+                        readonly examples: readonly [15];
+                    };
+                    readonly soft_threshold: {
+                        readonly type: "number";
+                        readonly minimum: 0.1;
+                        readonly maximum: 1;
+                        readonly default: 0.9;
+                        readonly examples: readonly [0.9];
+                    };
+                    readonly hard_threshold: {
+                        readonly type: "number";
+                        readonly minimum: 0.5;
+                        readonly maximum: 1;
+                        readonly default: 1;
+                        readonly examples: readonly [1];
+                    };
+                    readonly dual_pool: {
+                        readonly type: "boolean";
+                        readonly default: true;
+                        readonly description: "enable dual pool Antigravity + Gemini CLI";
+                        readonly examples: readonly [true];
+                    };
+                };
+            };
+            readonly bypass: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly description: "Bypass metadata — documents how library imitates Antigravity traffic. UA must match antigravity/{semver} {os}/{arch}.";
+                readonly properties: {
+                    readonly version_fallback: {
+                        readonly type: "string";
+                        readonly pattern: "^\\d+\\.\\d+\\.\\d+";
+                        readonly default: "1.19.2";
+                        readonly examples: readonly ["1.19.2"];
+                    };
+                    readonly min_supported: {
+                        readonly type: "string";
+                        readonly pattern: "^\\d+\\.\\d+\\.\\d+";
+                        readonly default: "1.15.8";
+                        readonly examples: readonly ["1.15.8"];
+                    };
+                    readonly user_agent: {
+                        readonly type: "string";
+                        readonly default: "antigravity/1.19.2";
+                        readonly description: "full UA, should contain antigravity/ prefix";
+                        readonly examples: readonly ["antigravity/1.19.2 darwin/arm64", "antigravity/1.19.2 linux/x64"];
+                    };
+                    readonly strip_user_project_header: {
+                        readonly type: "boolean";
+                        readonly default: true;
+                        readonly description: "strip x-goog-user-project to avoid 403";
+                        readonly examples: readonly [true];
+                    };
+                    readonly fingerprint_jitter: {
+                        readonly type: "boolean";
+                        readonly default: true;
+                        readonly examples: readonly [true];
+                    };
+                    readonly pid_offset: {
+                        readonly type: "boolean";
+                        readonly default: false;
+                        readonly examples: readonly [false, true];
+                    };
+                };
+            };
+            readonly fallback_project_id: {
+                readonly type: "string";
+                readonly minLength: 3;
+                readonly default: "rising-fact-p41fc";
+                readonly description: "fallback project id blinded";
+                readonly examples: readonly ["rising-fact-p41fc"];
+            };
+            readonly default_model: {
+                readonly type: "string";
+                readonly default: "antigravity-gemini-3-flash";
+                readonly description: "default chat model 2026";
+                readonly examples: readonly ["antigravity-gemini-3-flash", "gemini-3-pro-preview"];
+            };
+            readonly search_model: {
+                readonly type: "string";
+                readonly default: "gemini-3-flash";
+                readonly description: "search grounding model";
+                readonly examples: readonly ["gemini-3-flash", "gemini-3-flash-preview"];
+            };
+            readonly client_id: {
+                readonly type: readonly ["string", "null"];
+                readonly default: null;
+                readonly description: "OAuth client_id override (public)";
+                readonly examples: readonly [null, "1071006060591-...apps.googleusercontent.com"];
+            };
+            readonly client_secret: {
+                readonly type: readonly ["string", "null"];
+                readonly default: null;
+                readonly description: "OAuth client_secret override — do not commit";
+                readonly examples: readonly [null];
+            };
+            readonly accounts_file: {
+                readonly type: readonly ["string", "null"];
+                readonly default: null;
+                readonly format: "uri-reference";
+                readonly description: "custom accounts file path";
+                readonly examples: readonly [null, "~/.config/opencode/antigravity-accounts.json"];
+            };
+            readonly models_allowlist: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly default: readonly [];
+                readonly description: "optional model allowlist";
+                readonly examples: readonly [readonly [], readonly ["antigravity-gemini-3-flash", "claude-opus-4-6-thinking"]];
+            };
+            readonly strip_user_project: {
+                readonly type: "boolean";
+                readonly default: true;
+                readonly description: "legacy alias for bypass.strip_user_project_header";
+                readonly examples: readonly [true];
+            };
+            readonly toast_scope: {
+                readonly type: "string";
+                readonly enum: readonly ["all", "project", "minimal", "none"];
+                readonly default: "all";
+                readonly description: "toast/notification display scope (v1 field)";
+                readonly examples: readonly ["all", "project", "minimal", "none"];
+            };
+            readonly soft_quota_threshold_percent: {
+                readonly type: "number";
+                readonly minimum: 0;
+                readonly maximum: 100;
+                readonly default: 90;
+                readonly description: "quota percentage where soft warning/fallback starts (v1 field)";
+                readonly examples: readonly [90];
+            };
+            readonly quota_fallback: {
+                readonly oneOf: readonly [{
+                    readonly type: "boolean";
+                }, {
+                    readonly type: "string";
+                }];
+                readonly default: "auto";
+                readonly description: 'fallback strategy on quota exhaustion: boolean | "auto" | modelName (v1 field)';
+                readonly examples: readonly ["auto", true, false];
+            };
+            readonly soft_quota_cache_ttl_minutes: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 1440;
+                readonly default: 5;
+                readonly description: "soft quota cache TTL in minutes (v1 field)";
+                readonly examples: readonly [5];
+            };
+            readonly version_cache_ttl: {
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 10080;
+                readonly default: 60;
+                readonly description: "version/update check cache TTL in minutes (v1 field)";
+                readonly examples: readonly [60];
+            };
+        };
+        readonly required: readonly [];
+    };
+    defaultsRaw: AntigravityConfig;
+};
+export default Config;
+export declare const SCHEMA: {
+    readonly $schema: "http://json-schema.org/draft-07/schema#";
+    readonly $id: "https://opencode.ai/schemas/antigravity.json";
+    readonly title: "devthink provider config — antigravity.json";
+    readonly description: "Configuration for the devthink provider plugin. Bypass metadata: mimics antigravity/{ver} {os}/{arch} User-Agent, strips x-goog-user-project, endpoint cascade 403/404/5xx, supports Gemini CLI dual quota pool, round-robin/sticky rotation, google_search grounding.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly $schema: {
+            readonly type: "string";
+            readonly format: "uri";
+            readonly description: "JSON schema pointer";
+            readonly default: "https://json-schema.org/draft-07/schema#";
+            readonly examples: readonly ["https://json-schema.org/draft-07/schema#", "./antigravity.schema.json"];
+        };
+        readonly version: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 10;
+            readonly default: 2;
+            readonly description: "config version";
+            readonly examples: readonly [2];
+        };
+        readonly cli_first: {
+            readonly type: "boolean";
+            readonly default: false;
+            readonly description: "When true, tries Gemini CLI quota pool first before Antigravity pool. Useful when Antigravity quota is exhausted but CLI pool still has tokens.";
+            readonly examples: readonly [false, true];
+        };
+        readonly pid_offset_enabled: {
+            readonly type: "boolean";
+            readonly default: false;
+            readonly description: "Enables PID offset trick to bypass per-PID rate limiting observed in Gemini CLI gateway. When enabled, adds pid % 1000 to jitter.";
+            readonly examples: readonly [false, true];
+        };
+        readonly quota_refresh_interval_minutes: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 120;
+            readonly default: 15;
+            readonly description: "Interval in minutes for background quota refresh. Adaptive TTL 2-10min when near soft threshold 90%.";
+            readonly examples: readonly [5, 15, 30];
+        };
+        readonly rotation_strategy: {
+            readonly type: "string";
+            readonly enum: string[];
+            readonly default: "round-robin";
+            readonly description: "Multi-account rotation strategy — round-robin distributes evenly, sticky keeps same account until quota exhausted.";
+            readonly examples: readonly ["round-robin", "sticky"];
+        };
+        readonly account_rotation: {
+            readonly type: "string";
+            readonly enum: string[];
+            readonly default: "round-robin";
+            readonly description: "Alias for rotation_strategy (backward compat)";
+            readonly examples: readonly ["round-robin", "sticky"];
+        };
+        readonly debug: {
+            readonly oneOf: readonly [{
+                readonly type: "boolean";
+            }, {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly enabled: {
+                        readonly type: "boolean";
+                        readonly default: false;
+                        readonly description: "enable debug";
+                        readonly examples: readonly [false, true];
+                    };
+                    readonly level: {
+                        readonly type: "string";
+                        readonly enum: readonly ["debug", "info", "warn", "error", "silent"];
+                        readonly default: "warn";
+                        readonly description: "log level";
+                        readonly examples: readonly ["debug", "warn"];
+                    };
+                    readonly log_file: {
+                        readonly type: readonly ["string", "null"];
+                        readonly default: null;
+                        readonly description: "custom log file path";
+                        readonly examples: readonly [null, "~/.config/opencode/antigravity-debug.log"];
+                    };
+                    readonly retain_days: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 90;
+                        readonly default: 7;
+                        readonly description: "log retention days";
+                        readonly examples: readonly [7];
+                    };
+                    readonly max_bytes: {
+                        readonly type: "integer";
+                        readonly minimum: 1024;
+                        readonly maximum: number;
+                        readonly default: 10485760;
+                        readonly description: "max bytes before rotation, 10MB default";
+                        readonly examples: readonly [10485760];
+                    };
+                    readonly tui_buffer_lines: {
+                        readonly type: "integer";
+                        readonly minimum: 10;
+                        readonly maximum: 10000;
+                        readonly default: 1000;
+                        readonly description: "circular TUI buffer lines";
+                        readonly examples: readonly [1000];
+                    };
+                    readonly redact_secrets: {
+                        readonly type: "boolean";
+                        readonly default: true;
+                        readonly description: "redact secrets in logs";
+                        readonly examples: readonly [true];
+                    };
+                };
+            }];
+            readonly default: false;
+            readonly description: "Debug mode — boolean or object with rotation, retention, redaction.";
+            readonly examples: readonly [false, true, {
+                readonly enabled: true;
+                readonly level: "debug";
+            }];
+        };
+        readonly debug_enabled: {
+            readonly type: "boolean";
+            readonly default: false;
+            readonly description: "shortcut for debug.enabled";
+            readonly examples: readonly [false, true];
+        };
+        readonly google_search_enabled: {
+            readonly type: "boolean";
+            readonly default: true;
+            readonly description: "Enable native google_search grounding tool (Gemini) injection.";
+            readonly examples: readonly [true, false];
+        };
+        readonly google_search: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly default: {
+                readonly enabled: boolean;
+                readonly model: string;
+                readonly url_context: boolean;
+                readonly include_grounding_metadata: boolean;
+            };
+            readonly description: "Google search grounding full config";
+            readonly properties: {
+                readonly enabled: {
+                    readonly type: "boolean";
+                    readonly default: true;
+                    readonly description: "enable google_search tool";
+                    readonly examples: readonly [true, false];
+                };
+                readonly model: {
+                    readonly type: "string";
+                    readonly default: "gemini-3-flash";
+                    readonly description: "model used for search grounding";
+                    readonly examples: readonly ["gemini-3-flash", "gemini-3-flash-preview"];
+                };
+                readonly url_context: {
+                    readonly type: "boolean";
+                    readonly default: true;
+                    readonly description: "enable url_context companion tool";
+                    readonly examples: readonly [true, false];
+                };
+                readonly include_grounding_metadata: {
+                    readonly type: "boolean";
+                    readonly default: true;
+                    readonly description: "include groundingMetadata in response";
+                    readonly examples: readonly [true];
+                };
+            };
+        };
+        readonly endpoints: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly description: "Override Antigravity endpoints. Observer warns: must use https and googleapis.com for bypass.";
+            readonly properties: {
+                readonly prod: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly default: "https://cloudcode-pa.googleapis.com";
+                    readonly description: "PROD endpoint";
+                    readonly examples: readonly ["https://cloudcode-pa.googleapis.com"];
+                };
+                readonly daily: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly default: "https://daily-cloudcode-pa.googleapis.com";
+                    readonly description: "DAILY endpoint";
+                    readonly examples: readonly ["https://daily-cloudcode-pa.googleapis.com"];
+                };
+                readonly sandbox: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly default: "https://daily-cloudcode-pa.sandbox.googleapis.com";
+                    readonly description: "SANDBOX endpoint";
+                    readonly examples: readonly ["https://daily-cloudcode-pa.sandbox.googleapis.com"];
+                };
+                readonly autopush: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly default: "https://autopush-cloudcode-pa.sandbox.googleapis.com";
+                    readonly description: "AUTOPUSH optional";
+                    readonly examples: readonly ["https://autopush-cloudcode-pa.sandbox.googleapis.com"];
+                };
+                readonly quota: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly description: "quota endpoint override";
+                    readonly examples: readonly ["https://cloudcode-pa.googleapis.com"];
+                };
+                readonly models: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly description: "models endpoint override";
+                    readonly examples: readonly ["https://cloudcode-pa.googleapis.com"];
+                };
+                readonly gemini_cli: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly description: "Gemini CLI companion endpoint";
+                    readonly examples: readonly ["https://cloudaicompanion.googleapis.com"];
+                };
+                readonly cloud_companion: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly description: "cloudaicompanion.googleapis.com";
+                    readonly examples: readonly ["https://cloudaicompanion.googleapis.com"];
+                };
+                readonly generate: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly description: "generateContent base";
+                    readonly examples: readonly ["https://cloudcode-pa.googleapis.com"];
+                };
+                readonly stream_generate: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly description: "streamGenerateContent base";
+                    readonly examples: readonly ["https://cloudcode-pa.googleapis.com"];
+                };
+            };
+        };
+        readonly quota: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly description: "Quota config";
+            readonly properties: {
+                readonly refresh_interval_minutes: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 120;
+                    readonly default: 15;
+                    readonly examples: readonly [15];
+                };
+                readonly cache_ttl_minutes: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 60;
+                    readonly default: 15;
+                    readonly examples: readonly [15];
+                };
+                readonly soft_threshold: {
+                    readonly type: "number";
+                    readonly minimum: 0.1;
+                    readonly maximum: 1;
+                    readonly default: 0.9;
+                    readonly examples: readonly [0.9];
+                };
+                readonly hard_threshold: {
+                    readonly type: "number";
+                    readonly minimum: 0.5;
+                    readonly maximum: 1;
+                    readonly default: 1;
+                    readonly examples: readonly [1];
+                };
+                readonly dual_pool: {
+                    readonly type: "boolean";
+                    readonly default: true;
+                    readonly description: "enable dual pool Antigravity + Gemini CLI";
+                    readonly examples: readonly [true];
+                };
+            };
+        };
+        readonly bypass: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly description: "Bypass metadata — documents how library imitates Antigravity traffic. UA must match antigravity/{semver} {os}/{arch}.";
+            readonly properties: {
+                readonly version_fallback: {
+                    readonly type: "string";
+                    readonly pattern: "^\\d+\\.\\d+\\.\\d+";
+                    readonly default: "1.19.2";
+                    readonly examples: readonly ["1.19.2"];
+                };
+                readonly min_supported: {
+                    readonly type: "string";
+                    readonly pattern: "^\\d+\\.\\d+\\.\\d+";
+                    readonly default: "1.15.8";
+                    readonly examples: readonly ["1.15.8"];
+                };
+                readonly user_agent: {
+                    readonly type: "string";
+                    readonly default: "antigravity/1.19.2";
+                    readonly description: "full UA, should contain antigravity/ prefix";
+                    readonly examples: readonly ["antigravity/1.19.2 darwin/arm64", "antigravity/1.19.2 linux/x64"];
+                };
+                readonly strip_user_project_header: {
+                    readonly type: "boolean";
+                    readonly default: true;
+                    readonly description: "strip x-goog-user-project to avoid 403";
+                    readonly examples: readonly [true];
+                };
+                readonly fingerprint_jitter: {
+                    readonly type: "boolean";
+                    readonly default: true;
+                    readonly examples: readonly [true];
+                };
+                readonly pid_offset: {
+                    readonly type: "boolean";
+                    readonly default: false;
+                    readonly examples: readonly [false, true];
+                };
+            };
+        };
+        readonly fallback_project_id: {
+            readonly type: "string";
+            readonly minLength: 3;
+            readonly default: "rising-fact-p41fc";
+            readonly description: "fallback project id blinded";
+            readonly examples: readonly ["rising-fact-p41fc"];
+        };
+        readonly default_model: {
+            readonly type: "string";
+            readonly default: "antigravity-gemini-3-flash";
+            readonly description: "default chat model 2026";
+            readonly examples: readonly ["antigravity-gemini-3-flash", "gemini-3-pro-preview"];
+        };
+        readonly search_model: {
+            readonly type: "string";
+            readonly default: "gemini-3-flash";
+            readonly description: "search grounding model";
+            readonly examples: readonly ["gemini-3-flash", "gemini-3-flash-preview"];
+        };
+        readonly client_id: {
+            readonly type: readonly ["string", "null"];
+            readonly default: null;
+            readonly description: "OAuth client_id override (public)";
+            readonly examples: readonly [null, "1071006060591-...apps.googleusercontent.com"];
+        };
+        readonly client_secret: {
+            readonly type: readonly ["string", "null"];
+            readonly default: null;
+            readonly description: "OAuth client_secret override — do not commit";
+            readonly examples: readonly [null];
+        };
+        readonly accounts_file: {
+            readonly type: readonly ["string", "null"];
+            readonly default: null;
+            readonly format: "uri-reference";
+            readonly description: "custom accounts file path";
+            readonly examples: readonly [null, "~/.config/opencode/antigravity-accounts.json"];
+        };
+        readonly models_allowlist: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly default: readonly [];
+            readonly description: "optional model allowlist";
+            readonly examples: readonly [readonly [], readonly ["antigravity-gemini-3-flash", "claude-opus-4-6-thinking"]];
+        };
+        readonly strip_user_project: {
+            readonly type: "boolean";
+            readonly default: true;
+            readonly description: "legacy alias for bypass.strip_user_project_header";
+            readonly examples: readonly [true];
+        };
+        readonly toast_scope: {
+            readonly type: "string";
+            readonly enum: readonly ["all", "project", "minimal", "none"];
+            readonly default: "all";
+            readonly description: "toast/notification display scope (v1 field)";
+            readonly examples: readonly ["all", "project", "minimal", "none"];
+        };
+        readonly soft_quota_threshold_percent: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 100;
+            readonly default: 90;
+            readonly description: "quota percentage where soft warning/fallback starts (v1 field)";
+            readonly examples: readonly [90];
+        };
+        readonly quota_fallback: {
+            readonly oneOf: readonly [{
+                readonly type: "boolean";
+            }, {
+                readonly type: "string";
+            }];
+            readonly default: "auto";
+            readonly description: 'fallback strategy on quota exhaustion: boolean | "auto" | modelName (v1 field)';
+            readonly examples: readonly ["auto", true, false];
+        };
+        readonly soft_quota_cache_ttl_minutes: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 1440;
+            readonly default: 5;
+            readonly description: "soft quota cache TTL in minutes (v1 field)";
+            readonly examples: readonly [5];
+        };
+        readonly version_cache_ttl: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly maximum: 10080;
+            readonly default: 60;
+            readonly description: "version/update check cache TTL in minutes (v1 field)";
+            readonly examples: readonly [60];
+        };
+    };
+    readonly required: readonly [];
+};
+/**
+ * Validates an email address.
+ * @param email - candidate email (nullish / non-string inputs coerce to "")
+ * @returns true when the address has exactly one "@" and a dotted domain
+ */
+export declare function isValidEmail(email: string): boolean;
+/**
+ * Validates a semantic-version string (optional prerelease / build suffix).
+ * @param v - candidate version
+ */
+export declare function isValidSemver(v: string): boolean;
+/**
+ * Validates a Google-style project id (lowercase, 6..30 chars) or the
+ * documented fallback project id.
+ * @param id - candidate project id
+ */
+export declare function isValidProjectId(id: string): boolean;
+/**
+ * Validates a persisted account shape (email + refresh token).
+ * @param a - candidate account object
+ * @returns valid flag plus a human-readable error list
+ */
+export declare function validateAccount(a: any): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Validates a model id semantically: the lowercased id must contain one of
+ * the substrings gemini / claude / antigravity.
+ * @param model - candidate model id
+ */
+export declare function validateModelId(model: string): boolean;
+/** Config directory (honors OPENCODE_CONFIG_DIR, defaults to ~/.config/opencode). */
+export declare const cfgDir: () => string;
+/** Governed fallback version when every version-chain source fails. */
+export declare const VERSION_FALLBACK: "1.19.2";
+/** Fetches the latest Antigravity version across the known update sources. */
+export declare const fetchVersionChain: () => Promise<string>;
+export declare const validateEmail: typeof isValidEmail;
+export declare const validateSemver: typeof isValidSemver;
+export declare const validateProjectId: typeof isValidProjectId;
+/** Charset regex variant of model-id validation (former system.ts validateModelId). */
+export declare const validateModelIdCharset: (id: string) => boolean;
+/** Minimal raw JSON read of antigravity.json (no schema validation, never throws). */
+export declare const loadConfigRaw: () => any;
+/** Minimal raw JSON write of antigravity.json (atomic tmp+rename, chmod 600, never throws). */
+export declare const saveConfigRaw: (c: any) => void;
+/** Atomic file write (tmp + chmod 600 + rename) used for plain-file persistence. */
+export declare const atomicWrite: (p: string, c: string) => void;
+import type { gatewayconfig, gatewaydefinition } from "./types";
+/** loadconfig — resolve the gateway definition from the standard locations
+ * caches the result for the process lifetime — call reloadconfig to refresh */
+export declare function loadconfig(): Promise<gatewaydefinition>;
+/** reloadconfig — clear the cache and reload from disk */
+export declare function reloadconfig(): Promise<gatewaydefinition>;
+/** getversion — get one version config by id */
+export declare function getversion(id: string): Promise<gatewayconfig | null>;
+/** listversions — get all version ids */
+export declare function listversions(): Promise<string[]>;
+/** validateconfig — check a gateway definition for common errors
+ * returns a list of human readable problems — empty when valid */
+export declare function validateconfig(def: gatewaydefinition): string[];
+//# sourceMappingURL=config.d.ts.map