@wenathlan/devthink 2.0.15 → 2.0.19

package/dist/antigravity.d.ts

@@ -1,380 +0,0 @@
-/**
- * @file antigravity.ts — the antigravity provider plugin of the merged repository.
- * @description
- *  Third-person observer: the observer analyses how Gemini CLI, OmniRoute, 9router and
- *  pi-antigravity-auth bypass the Project ID and reproduces exactly the same behaviour
- *  in a library-first, root-first shape.
- *
- *  Responsabilidades (the merged plugin contract):
- *  - Total Project ID bypass acting exactly like the Gemini CLI: when
- *    account.projectId is absent the observer calls resolveProjectId which runs
- *    loadCodeAssist without a project (metadata only), onboardUser when needed
- *    (FREE tier), LRO polling, never demanding a project from the user. The
- *    in-memory cache carries a truncated SHA256 hash so a heap snapshot never
- *    leaks the token.
- *  - Endpoint wrapping {model, project, request} the Gemini CLI way
- *    (CodeAssistServer.createCodeAssistContentGenerator), straight to
- *    cloudcode-pa.googleapis.com, no localhost v1 proxy, no generativelanguage.
- *  - The complete model list through 25/08/2026: gemini-3.6, 3.5, 3.1, 3,
- *    2.5, claude 4.5/4.6 thinking, gpt-oss-120b, preview variants plus the
- *    antigravity-* aliases.
- *  - Dual quota (Antigravity + Gemini CLI), cli_first, pid_offset_enabled
- *    0-1000, google_search grounding.
- *  - Hooks: the fetch interceptor cascade 403/404/5xx with 0-80ms jitter,
- *    strip x-goog-user-project (fix #1830), skip sandbox for
- *    gemini-3.6/3.5/preview (fix #233), the third-person observer, node:*
- *    builtins + global fetch only.
- */
-export type PluginOptions = {
-    cli_first?: boolean;
-    pid_offset_enabled?: boolean;
-    /** true/false forces grounding on/off; "auto" enables it for Gemini (non-Claude) models only. */
-    google_search_enabled?: boolean | "auto";
-    quota_refresh_interval_minutes?: number;
-    rotation_strategy?: "round-robin" | "sticky";
-    debug?: boolean;
-    /** Prefix tool descriptions with hardening hints for Claude models. */
-    claude_tool_hardening?: boolean;
-    /** Keep thinking blocks/signatures in transformed output instead of dropping them. */
-    keep_thinking?: boolean;
-    /** Skip accounts whose used-percentage is at or above this threshold (0-100). */
-    soft_quota_threshold_percent?: number;
-    /** How long a soft-quota mark lasts, in minutes; "auto" resolves to 15. */
-    soft_quota_cache_ttl_minutes?: number | "auto";
-    /** Suppress toast() notifications. */
-    quiet_mode?: boolean;
-};
-import type { Account } from "./accounts.js";
-export type { Account };
-export { ANTIGRAVITY_VERSION_FALLBACK, CONTENT_TIMEOUT_MS, FALLBACK_PROJECT_ID, FORBIDDEN_HEADERS, FETCH_TIMEOUT_MS, GEMINI_CLI_SCOPES, PLUGIN_VERSION, } from "./constants.js";
-export { fnv1a32, fnv1a32Hex, getJitter } from "./core.js";
-export { buildAntagravityHeaders, getDynamicUserAgent } from "./fingerprint.js";
-export { ALL_MODELS_2026, ANTIGRAVITY_VERSION_MIN, CODE_ASSIST_ENDPOINTS, ENDPOINT_ORDER, ENDPOINT_ORDER_GEMINI_CLI, GEMINI_CLI_ONLY_MODELS, MODELS_2026_BASE, MODELS_2026_ANTIGRAVITY_ALIAS, THINKING_BUDGET_MAP, THINKING_LEVELS, buildImageGenConfig, getEndpointsForModel, isGeminiCLIOnlyModel, isImageGenModel, mapModelToGroup, } from "./models.js";
-export { MODELS_2026_PROVIDER as MODELS_2026 } from "./models.js";
-export type { ModelId2026, ThinkingLevel } from "./models.js";
-export { resolveProjectId } from "./project.js";
-export type { ResolveProjectIdOptions, ResolveResult } from "./project.js";
-type RequestInfo = Parameters<typeof fetch>[0];
-export declare const PLUGIN_ID: "devthink";
-/** Public alias kept for consumers that expect `VERSION` instead of `PLUGIN_VERSION`. */
-export declare const VERSION: string;
-/**
- * User-facing notification glue (v2.1.15 Phase D: renamed from the former
- * toast() — recovery.js owns the toast name with its sink-based notifier).
- * No-op when quiet_mode is enabled.
- */
-export declare function notifyUser(message: string): void;
-export declare class AntigravityPlugin {
-    private accountManager;
-    private quotaManager;
-    private options;
-    private version;
-    private initialized;
-    constructor(options?: PluginOptions);
-    init(): Promise<void>;
-    private getUserAgent;
-    private shouldHandleModel;
-    private getAccountForModel;
-    private refreshIfNeeded;
-    /**
-     * handleFetch — intercepta fetch do opencode provider google.
-     * Observer third-person: faz exatamente como Gemini CLI:
-     * - se account.projectId ausente, chama resolveProjectId que faz loadCodeAssist SEM project, onboardUser se necessário, nunca exige project do usuário.
-     * - wrapping {model, project, request} direto cloudcode-pa, sem localhost v1 proxy.
-     * - cascade 403/404/5xx, strip x-goog-user-project, skip sandbox para gemini-3.6/3.5/preview.
-     * - dual quota + cli_first + pid_offset.
-     */
-    handleFetch(originalFetch: typeof fetch, input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
-    getPluginDefinition(): {
-        id: "devthink";
-        version: "2.0.0";
-        name: string;
-        description: string;
-        onInit(): Promise<void>;
-        hooks: {
-            "tool.execute.before": (ctx: any) => Promise<any>;
-            "tool.execute.after": (ctx: any) => Promise<any>;
-            fetch: (input: RequestInfo | URL, init?: RequestInit, next?: typeof fetch) => Promise<Response>;
-        };
-        auth: {
-            provider: string;
-            /**
-             * opencode credential loader (merged from legacy plugin.ts): supplies the
-             * active account OAuth credentials to opencode without re-running login.
-             */
-            loader(): Promise<{
-                type: string;
-                accessToken: any;
-                refreshToken: any;
-                projectId: any;
-                email: any;
-            } | null>;
-            login(): Promise<{
-                email: any;
-            }>;
-            list(): Promise<any>;
-            logout(email?: string): Promise<void>;
-            /**
-             * Enable/disable toggle (merged from plugin(5)): disabled accounts are
-             * skipped by rotation until re-enabled.
-             */
-            enable(email: string, en?: boolean): Promise<void>;
-        };
-        config: {
-            schema: {
-                oauth_identity: {
-                    type: string;
-                    enum: string[];
-                    default: string;
-                    description: string;
-                };
-                cli_first: {
-                    type: string;
-                    default: boolean;
-                    description: string;
-                };
-                pid_offset_enabled: {
-                    type: string;
-                    default: boolean;
-                    description: string;
-                };
-                google_search_enabled: {
-                    type: string[];
-                    default: boolean;
-                    description: string;
-                };
-                quota_refresh_interval_minutes: {
-                    type: string;
-                    default: number;
-                };
-                rotation_strategy: {
-                    type: string;
-                    enum: string[];
-                    default: string;
-                };
-                claude_tool_hardening: {
-                    type: string;
-                    default: boolean;
-                    description: string;
-                };
-                keep_thinking: {
-                    type: string;
-                    default: boolean;
-                    description: string;
-                };
-                soft_quota_threshold_percent: {
-                    type: string;
-                    default: number;
-                    description: string;
-                };
-                soft_quota_cache_ttl_minutes: {
-                    type: string[];
-                    default: string;
-                    description: string;
-                };
-                quiet_mode: {
-                    type: string;
-                    default: boolean;
-                    description: string;
-                };
-            };
-            defaults: {
-                cli_first: boolean;
-                pid_offset_enabled: boolean;
-                google_search_enabled: boolean;
-                quota_refresh_interval_minutes: number;
-                rotation_strategy: string;
-                claude_tool_hardening: boolean;
-                keep_thinking: boolean;
-                soft_quota_threshold_percent: number;
-                soft_quota_cache_ttl_minutes: string;
-                quiet_mode: boolean;
-            };
-        };
-        models: {
-            id: "antigravity-claude-opus-4-5-thinking" | "antigravity-claude-opus-4-6" | "antigravity-claude-opus-4-6-thinking" | "antigravity-claude-sonnet-4-5" | "antigravity-claude-sonnet-4-6" | "antigravity-claude-sonnet-4-6-thinking" | "antigravity-gemini-2.5-flash" | "antigravity-gemini-2.5-flash-lite" | "antigravity-gemini-2.5-pro" | "antigravity-gemini-3-deep-think" | "antigravity-gemini-3-flash" | "antigravity-gemini-3-flash-preview" | "antigravity-gemini-3-pro" | "antigravity-gemini-3-pro-preview" | "antigravity-gemini-3.1-flash-image" | "antigravity-gemini-3.1-flash-lite" | "antigravity-gemini-3.1-pro" | "antigravity-gemini-3.1-pro-high" | "antigravity-gemini-3.1-pro-low" | "antigravity-gemini-3.1-pro-preview" | "antigravity-gemini-3.1-pro-preview-customtools" | "antigravity-gemini-3.5-flash" | "antigravity-gemini-3.5-flash-high" | "antigravity-gemini-3.5-flash-lite" | "antigravity-gemini-3.5-flash-lite-preview" | "antigravity-gemini-3.5-flash-medium" | "antigravity-gemini-3.6-flash" | "antigravity-gemini-3.6-flash-high" | "antigravity-gemini-3.6-flash-low" | "antigravity-gemini-3.6-flash-medium" | "antigravity-gemini-3.6-flash-tiered" | "claude-opus-4-5-thinking" | "claude-opus-4-6-thinking" | "claude-sonnet-4-5" | "claude-sonnet-4-6-thinking" | "gemini-2.5-flash" | "gemini-2.5-flash-lite" | "gemini-2.5-pro" | "gemini-3-deep-think" | "gemini-3-flash" | "gemini-3-flash-preview" | "gemini-3-pro" | "gemini-3-pro-preview" | "gemini-3.1-flash-image" | "gemini-3.1-flash-lite" | "gemini-3.1-pro" | "gemini-3.1-pro-high" | "gemini-3.1-pro-low" | "gemini-3.1-pro-preview" | "gemini-3.1-pro-preview-customtools" | "gemini-3.5-flash" | "gemini-3.5-flash-high" | "gemini-3.5-flash-lite" | "gemini-3.5-flash-lite-preview" | "gemini-3.5-flash-medium" | "gemini-3.6-flash" | "gemini-3.6-flash-high" | "gemini-3.6-flash-low" | "gemini-3.6-flash-medium" | "gemini-3.6-flash-tiered" | "gpt-oss-120b-high" | "gpt-oss-120b-medium";
-            name: "antigravity-claude-opus-4-5-thinking" | "antigravity-claude-opus-4-6" | "antigravity-claude-opus-4-6-thinking" | "antigravity-claude-sonnet-4-5" | "antigravity-claude-sonnet-4-6" | "antigravity-claude-sonnet-4-6-thinking" | "antigravity-gemini-2.5-flash" | "antigravity-gemini-2.5-flash-lite" | "antigravity-gemini-2.5-pro" | "antigravity-gemini-3-deep-think" | "antigravity-gemini-3-flash" | "antigravity-gemini-3-flash-preview" | "antigravity-gemini-3-pro" | "antigravity-gemini-3-pro-preview" | "antigravity-gemini-3.1-flash-image" | "antigravity-gemini-3.1-flash-lite" | "antigravity-gemini-3.1-pro" | "antigravity-gemini-3.1-pro-high" | "antigravity-gemini-3.1-pro-low" | "antigravity-gemini-3.1-pro-preview" | "antigravity-gemini-3.1-pro-preview-customtools" | "antigravity-gemini-3.5-flash" | "antigravity-gemini-3.5-flash-high" | "antigravity-gemini-3.5-flash-lite" | "antigravity-gemini-3.5-flash-lite-preview" | "antigravity-gemini-3.5-flash-medium" | "antigravity-gemini-3.6-flash" | "antigravity-gemini-3.6-flash-high" | "antigravity-gemini-3.6-flash-low" | "antigravity-gemini-3.6-flash-medium" | "antigravity-gemini-3.6-flash-tiered" | "claude-opus-4-5-thinking" | "claude-opus-4-6-thinking" | "claude-sonnet-4-5" | "claude-sonnet-4-6-thinking" | "gemini-2.5-flash" | "gemini-2.5-flash-lite" | "gemini-2.5-pro" | "gemini-3-deep-think" | "gemini-3-flash" | "gemini-3-flash-preview" | "gemini-3-pro" | "gemini-3-pro-preview" | "gemini-3.1-flash-image" | "gemini-3.1-flash-lite" | "gemini-3.1-pro" | "gemini-3.1-pro-high" | "gemini-3.1-pro-low" | "gemini-3.1-pro-preview" | "gemini-3.1-pro-preview-customtools" | "gemini-3.5-flash" | "gemini-3.5-flash-high" | "gemini-3.5-flash-lite" | "gemini-3.5-flash-lite-preview" | "gemini-3.5-flash-medium" | "gemini-3.6-flash" | "gemini-3.6-flash-high" | "gemini-3.6-flash-low" | "gemini-3.6-flash-medium" | "gemini-3.6-flash-tiered" | "gpt-oss-120b-high" | "gpt-oss-120b-medium";
-            provider: string;
-            context: 200000 | 1048576;
-            output: 64000 | 65535;
-            api: "antigravity" | "gemini-cli";
-            modalities: {
-                input: string[];
-                output: string[];
-            };
-        }[];
-    };
-}
-export declare function getPlugin(options?: PluginOptions): AntigravityPlugin;
-/** Legacy definition export (pre-1.18 shape) kept for library consumers. */
-export declare const plugin: {
-    id: "devthink";
-    version: "2.0.0";
-    name: string;
-    description: string;
-    onInit(): Promise<void>;
-    hooks: {
-        "tool.execute.before": (ctx: any) => Promise<any>;
-        "tool.execute.after": (ctx: any) => Promise<any>;
-        fetch: (input: RequestInfo | URL, init?: RequestInit, next?: typeof fetch) => Promise<Response>;
-    };
-    auth: {
-        provider: string;
-        /**
-         * opencode credential loader (merged from legacy plugin.ts): supplies the
-         * active account OAuth credentials to opencode without re-running login.
-         */
-        loader(): Promise<{
-            type: string;
-            accessToken: any;
-            refreshToken: any;
-            projectId: any;
-            email: any;
-        } | null>;
-        login(): Promise<{
-            email: any;
-        }>;
-        list(): Promise<any>;
-        logout(email?: string): Promise<void>;
-        /**
-         * Enable/disable toggle (merged from plugin(5)): disabled accounts are
-         * skipped by rotation until re-enabled.
-         */
-        enable(email: string, en?: boolean): Promise<void>;
-    };
-    config: {
-        schema: {
-            oauth_identity: {
-                type: string;
-                enum: string[];
-                default: string;
-                description: string;
-            };
-            cli_first: {
-                type: string;
-                default: boolean;
-                description: string;
-            };
-            pid_offset_enabled: {
-                type: string;
-                default: boolean;
-                description: string;
-            };
-            google_search_enabled: {
-                type: string[];
-                default: boolean;
-                description: string;
-            };
-            quota_refresh_interval_minutes: {
-                type: string;
-                default: number;
-            };
-            rotation_strategy: {
-                type: string;
-                enum: string[];
-                default: string;
-            };
-            claude_tool_hardening: {
-                type: string;
-                default: boolean;
-                description: string;
-            };
-            keep_thinking: {
-                type: string;
-                default: boolean;
-                description: string;
-            };
-            soft_quota_threshold_percent: {
-                type: string;
-                default: number;
-                description: string;
-            };
-            soft_quota_cache_ttl_minutes: {
-                type: string[];
-                default: string;
-                description: string;
-            };
-            quiet_mode: {
-                type: string;
-                default: boolean;
-                description: string;
-            };
-        };
-        defaults: {
-            cli_first: boolean;
-            pid_offset_enabled: boolean;
-            google_search_enabled: boolean;
-            quota_refresh_interval_minutes: number;
-            rotation_strategy: string;
-            claude_tool_hardening: boolean;
-            keep_thinking: boolean;
-            soft_quota_threshold_percent: number;
-            soft_quota_cache_ttl_minutes: string;
-            quiet_mode: boolean;
-        };
-    };
-    models: {
-        id: "antigravity-claude-opus-4-5-thinking" | "antigravity-claude-opus-4-6" | "antigravity-claude-opus-4-6-thinking" | "antigravity-claude-sonnet-4-5" | "antigravity-claude-sonnet-4-6" | "antigravity-claude-sonnet-4-6-thinking" | "antigravity-gemini-2.5-flash" | "antigravity-gemini-2.5-flash-lite" | "antigravity-gemini-2.5-pro" | "antigravity-gemini-3-deep-think" | "antigravity-gemini-3-flash" | "antigravity-gemini-3-flash-preview" | "antigravity-gemini-3-pro" | "antigravity-gemini-3-pro-preview" | "antigravity-gemini-3.1-flash-image" | "antigravity-gemini-3.1-flash-lite" | "antigravity-gemini-3.1-pro" | "antigravity-gemini-3.1-pro-high" | "antigravity-gemini-3.1-pro-low" | "antigravity-gemini-3.1-pro-preview" | "antigravity-gemini-3.1-pro-preview-customtools" | "antigravity-gemini-3.5-flash" | "antigravity-gemini-3.5-flash-high" | "antigravity-gemini-3.5-flash-lite" | "antigravity-gemini-3.5-flash-lite-preview" | "antigravity-gemini-3.5-flash-medium" | "antigravity-gemini-3.6-flash" | "antigravity-gemini-3.6-flash-high" | "antigravity-gemini-3.6-flash-low" | "antigravity-gemini-3.6-flash-medium" | "antigravity-gemini-3.6-flash-tiered" | "claude-opus-4-5-thinking" | "claude-opus-4-6-thinking" | "claude-sonnet-4-5" | "claude-sonnet-4-6-thinking" | "gemini-2.5-flash" | "gemini-2.5-flash-lite" | "gemini-2.5-pro" | "gemini-3-deep-think" | "gemini-3-flash" | "gemini-3-flash-preview" | "gemini-3-pro" | "gemini-3-pro-preview" | "gemini-3.1-flash-image" | "gemini-3.1-flash-lite" | "gemini-3.1-pro" | "gemini-3.1-pro-high" | "gemini-3.1-pro-low" | "gemini-3.1-pro-preview" | "gemini-3.1-pro-preview-customtools" | "gemini-3.5-flash" | "gemini-3.5-flash-high" | "gemini-3.5-flash-lite" | "gemini-3.5-flash-lite-preview" | "gemini-3.5-flash-medium" | "gemini-3.6-flash" | "gemini-3.6-flash-high" | "gemini-3.6-flash-low" | "gemini-3.6-flash-medium" | "gemini-3.6-flash-tiered" | "gpt-oss-120b-high" | "gpt-oss-120b-medium";
-        name: "antigravity-claude-opus-4-5-thinking" | "antigravity-claude-opus-4-6" | "antigravity-claude-opus-4-6-thinking" | "antigravity-claude-sonnet-4-5" | "antigravity-claude-sonnet-4-6" | "antigravity-claude-sonnet-4-6-thinking" | "antigravity-gemini-2.5-flash" | "antigravity-gemini-2.5-flash-lite" | "antigravity-gemini-2.5-pro" | "antigravity-gemini-3-deep-think" | "antigravity-gemini-3-flash" | "antigravity-gemini-3-flash-preview" | "antigravity-gemini-3-pro" | "antigravity-gemini-3-pro-preview" | "antigravity-gemini-3.1-flash-image" | "antigravity-gemini-3.1-flash-lite" | "antigravity-gemini-3.1-pro" | "antigravity-gemini-3.1-pro-high" | "antigravity-gemini-3.1-pro-low" | "antigravity-gemini-3.1-pro-preview" | "antigravity-gemini-3.1-pro-preview-customtools" | "antigravity-gemini-3.5-flash" | "antigravity-gemini-3.5-flash-high" | "antigravity-gemini-3.5-flash-lite" | "antigravity-gemini-3.5-flash-lite-preview" | "antigravity-gemini-3.5-flash-medium" | "antigravity-gemini-3.6-flash" | "antigravity-gemini-3.6-flash-high" | "antigravity-gemini-3.6-flash-low" | "antigravity-gemini-3.6-flash-medium" | "antigravity-gemini-3.6-flash-tiered" | "claude-opus-4-5-thinking" | "claude-opus-4-6-thinking" | "claude-sonnet-4-5" | "claude-sonnet-4-6-thinking" | "gemini-2.5-flash" | "gemini-2.5-flash-lite" | "gemini-2.5-pro" | "gemini-3-deep-think" | "gemini-3-flash" | "gemini-3-flash-preview" | "gemini-3-pro" | "gemini-3-pro-preview" | "gemini-3.1-flash-image" | "gemini-3.1-flash-lite" | "gemini-3.1-pro" | "gemini-3.1-pro-high" | "gemini-3.1-pro-low" | "gemini-3.1-pro-preview" | "gemini-3.1-pro-preview-customtools" | "gemini-3.5-flash" | "gemini-3.5-flash-high" | "gemini-3.5-flash-lite" | "gemini-3.5-flash-lite-preview" | "gemini-3.5-flash-medium" | "gemini-3.6-flash" | "gemini-3.6-flash-high" | "gemini-3.6-flash-low" | "gemini-3.6-flash-medium" | "gemini-3.6-flash-tiered" | "gpt-oss-120b-high" | "gpt-oss-120b-medium";
-        provider: string;
-        context: 200000 | 1048576;
-        output: 64000 | 65535;
-        api: "antigravity" | "gemini-cli";
-        modalities: {
-            input: string[];
-            output: string[];
-        };
-    }[];
-};
-/**
- * Detects which opencode.json provider block belongs to the provider plugin by looking at
- * MODEL IDS ONLY (never the provider name): any provider whose models include
- * `antigravity-*` prefixed ids or Google `gemini-*` ids is a provider consumer,
- * whatever the user named it ("google", "antigravity", "casas-bahia", ...).
- * Deterministic priority: antigravity-* models > gemini-* models; exact ids
- * "google" / "antigravity" win ties; file order breaks remaining ties.
- * Returns null when no config/provider qualifies (caller falls back "google").
- */
-export declare function detectOpencodeProviderId(configDir?: string): string | null;
-/**
- * Builds a complete opencode AuthHook for one provider id (shared loader +
- * the OAuth methods). Used by the ./server entry for the standard "google"
- * and "antigravity" entries and for the custom provider detected by model
- * ids — all three surface in `opencode auth login` with an OAuth option.
- */
-export declare function buildOpencodeAuthHook(providerId: string): Record<string, any>;
-/**
- * Standard-entry safety net: ensures a provider "antigravity" ALWAYS exists
- * in the config (npm @ai-sdk/google + the provider model catalog) unless the
- * user defined their own "antigravity" block or disabled the provider.
- * This is one of the TWO standard entries ("google" is the other — it always
- * exists in opencode's models.dev database): the "Antigravity" entry of
- * `opencode auth login` is immediately usable, and credentials stored under
- * "antigravity" (e.g. from a zero-config login on another project) always
- * find their provider — opencode crashes on auth-loader credentials whose
- * provider exists neither in models.dev nor in the config. ADD-ONLY and
- * in-memory: the user's file is never touched and an explicit
- * "antigravity" block always wins.
- */
-export declare function injectAntigravityProvider(cfg: any, enabled?: boolean): void;
-/**
- * The opencode server entry: initializes the plugin singleton and returns
- * the hooks object implementing the 1.18.x contract — header injection,
- * the zero-config antigravity provider injection and the auth entry for
- * the CUSTOM provider detected by model ids. The standard "google" and
- * "antigravity" auth entries are registered by server.ts (the ./server
- * package entry) and are never duplicated here.
- */
-export declare function opencodeServer(_input?: unknown, options?: PluginOptions): Promise<Record<string, any>>;
-/**
- * The opencode PluginModule (V1 shape): what loaders that read package.json
- * `main` directly get (library consumers, older opencode builds). It always
- * carries exactly one auth entry — the detected provider with the "google"
- * fallback — so single-hook loaders keep working.
- */
-declare const opencodePluginModule: {
-    readonly id: "devthink";
-    readonly server: (input?: unknown, options?: PluginOptions) => Promise<Record<string, any>>;
-};
-export default opencodePluginModule;
-//# sourceMappingURL=antigravity.d.ts.map

package/dist/apifreeze.d.ts

@@ -1,113 +0,0 @@
-/**
- * The api freeze family of the 1.1.91 release: the versioned contracts, the capability manifests and the deprecation policy that pinned the external surface of the library until the 2.0.0 sunset closed the window.
- * The correlation is the freeze itself: the protocolv2 negotiation that answers major two to new clients, refused every version one declaration below the supported floor once the 2.0.0 sunset raised it and refuses every major above two until a future bump; the frozen surface catalogs of the background, pagebridge, sidepanel, popup, cli, library and mcp surfaces with their message types, action kinds and permissions; the capability manifest builder and the manifest comparison that flags capability drift between releases; the deprecation registry the 2.0.0 sunset emptied with the window record it keeps as history; and the freeze scope record that names the release, the date and the surfaces the pin covers.
- * No new capability enters the library through this family: the module carries frozen data and pure guarantees only — the message schemas stay in protocol.ts and types.ts, the gates stay in policy.ts, and every surface list here mirrors the code it freezes so the apifreeze gate can verify the mirror never drifts.
- */
-/** The supported protocol major range of protocolv2: the minimum follows the protocol floor of version.ts — the 2.0.0 sunset closed the deprecation window and raised it to major two, so the line speaks major two only while every major above two refuses until a future major bump. */
-export declare const protocolsupported: Readonly<{
-    minimum: number;
-    maximum: number;
-}>;
-/** The release that pinned the frozen contracts: a fixed contract fact of the freeze history, never a runtime stamp. */
-export declare const apifreezerelease = "1.1.91";
-/** The date the api freeze pinned the contracts: a fixed contract fact recorded in the freeze artifact, never a runtime timestamp. */
-export declare const apifreezedate = "2026-08-31";
-/** The scope of the api freeze: the seven surfaces whose message types, kinds and permissions the release pinned. */
-export declare const apifreezescope: readonly string[];
-/** Parses the protocol major of one version declaration: a full package version string carries its major in the first component while a bare non negative integer is the major itself — a declared major of zero parses as zero so the negotiation refuses it below the supported floor instead of mistaking it for an undeclared client — and anything unparseable answers undefined. */
-export declare function protocolmajorof(declaration: string | number | undefined): number | undefined;
-/** Negotiates the protocol major with one client: a client that declares no version answers the frozen default of two, a client that declares major one refuses below the supported floor the 2.0.0 sunset raised — the refusal names the supported range and points version one assets at the migrateplan command and the migration guide — and a major outside the supported range refuses with the range inside the refusal so the mismatch always names what the server supports. */
-export declare function negotiateprotocol(input: {
-    client?: string | number;
-}): {
-    agreed: boolean;
-    major?: number;
-    deprecation?: string;
-    reason?: string;
-};
-/** Negotiates the highest shared protocol major with one client: the shared line is the highest major both sides speak inside the supported range — a list that carries both one and two filters down to the supported side and answers major two, the negotiate up path the 2.0.0 roadmap promises — and an empty intersection names the supported range in its refusal. */
-export declare function sharedprotocolversion(clientversions: number[]): {
-    shared: boolean;
-    major?: number;
-    reason?: string;
-};
-/** One deprecated field of the deprecation window: the surface that carries it, the field name, the plain language notice and the sunset release that removes it. */
-export interface deprecatedfield {
-    surface: string;
-    field: string;
-    notice: string;
-    sunsetrelease: string;
-}
-/** The deprecation registry of the api freeze: the 2.0.0 sunset removed every entry the window carried — the umd Devthink shim and the mcp protocolversion string both left the registry and the code at their sunset — so the registry stays empty and hashes into the freeze artifact as the empty contract until a future release opens a new window through a changelog entry that names its deprecations, their notices and their sunset releases. */
-export declare const deprecatedfields: readonly deprecatedfield[];
-/** The deprecation window of the api freeze kept as history: the window opened at the freeze release 1.1.91, carried version one acceptance with one warning per session per deprecated field and closed at 2.0.0 when the sunset removed every field it carried. */
-export declare const deprecationwindow: Readonly<{
-    opens: string;
-    closes: string;
-}>;
-/** Reads the deprecation notice of one declared field: the registry answers the notice of the exact surface and field pair, and an unregistered pair answers undefined. */
-export declare function deprecationnoticeof(surface: string, field: string): string | undefined;
-/** Warns one deprecated field once per session: the first sighting joins the warned set and answers its notice while every later sighting of the same field stays silent, exactly the one warning per session the deprecation window promises — the umd shim of the Devthink global is the precedent this rule generalizes. */
-export declare function warnonce(input: {
-    warned: ReadonlySet<string>;
-    surface: string;
-    field: string;
-}): {
-    warned: ReadonlySet<string>;
-    notice?: string;
-};
-/** Maps every extension manifest permission to its consuming capability: the surface that holds the permission, the message types that need it and the action kinds that exercise it — the map answers what each granted permission serves, so the permission list of the manifest and the capability manifests never disagree. */
-export declare const permissioncoverage: Readonly<Record<string, {
-    surface: string;
-    messages: string[];
-    kinds: string[];
-}>>;
-/** The frozen message types of the background surface: every kind the request router of the service worker dispatches, extracted from the request switch and pinned here so the gate can verify the router and the manifest never drift apart. */
-export declare const backgroundsurfacemessages: readonly string[];
-/** The frozen member names of the pagebridge surface: every member of the injected devthinkbridge object, pinned here so the gate can verify the injected bridge and the manifest never drift apart. */
-export declare const pagebridgesurfacemessages: readonly string[];
-/** The frozen message types of the sidepanel surface: every kind the sidepanel request helper sends to the background, pinned here so the gate can verify the panel and the manifest never drift apart. */
-export declare const sidepanelsurfacemessages: readonly string[];
-/** The frozen message types of the popup surface: every kind the popup request helper sends to the background, pinned here so the gate can verify the popup and the manifest never drift apart. */
-export declare const popupsurfacemessages: readonly string[];
-/** The frozen commands of the cli surface: every command the terminal dispatches, pinned here so the gate can verify the dispatch, the command registry and the manifest never drift apart. */
-export declare const clisurfacecommands: readonly string[];
-/** The frozen tools of the mcp surface with their per tool versions frozen from this release on, so the catalog, the tool listing and the manifest never drift apart. */
-export declare const mcpsurfacetools: ReadonlyArray<{
-    name: string;
-    version: number;
-}>;
-/** The frozen kinds the mcp tool catalog wraps: the reviewed action kinds of the four tool domains, so the mcp manifest and the domain grammar never drift apart. */
-export declare const mcpsurfacekinds: readonly string[];
-/** The frozen export surface of the library: every symbol index.ts exports across its family star exports and explicit re-exports — the library message types of the freeze — pinned here so the gate can verify the library exposes no undeclared symbol. */
-export declare const librarysurfaceexports: readonly string[];
-/** One surface name of the freeze. */
-export type capmanifestsurface = "background" | "pagebridge" | "sidepanel" | "popup" | "cli" | "library" | "mcp";
-/** One capability manifest of a frozen surface: the surface name, the release the manifest pins, the protocol major of the freeze, the message types the surface speaks, the action kinds it names, the permissions it consumes and the permission coverage slice that maps each permission to its consuming capability. */
-export interface capmanifest {
-    surface: capmanifestsurface;
-    release: string;
-    protocolmajor: number;
-    messages: string[];
-    kinds: string[];
-    permissions: string[];
-    permissioncoverage: Record<string, {
-        surface: string;
-        messages: string[];
-        kinds: string[];
-    }>;
-    /** The per tool versions of the mcp surface; every other surface carries none. */
-    toolversions?: Record<string, number>;
-}
-/** Builds the capability manifest of one frozen surface: the manifest lists the message types, the kinds and the permissions of its surface with the release version the manifest pins — the background manifest carries the full permission coverage of the extension while every other surface carries the slice it consumes. */
-export declare function capmanifestof(surface: capmanifestsurface): capmanifest;
-/** Compares two capability manifests and flags the capability drift between releases: every added or removed message type, kind, permission and tool version answers as one named drift entry, so a release review reads exactly what moved on the surface. */
-export declare function capmanifestdiff(previous: capmanifest, current: capmanifest): string[];
-/** Reads the surface size of one manifest family: the message count the freeze reports per family, so the freeze artifact records the size of every surface it pins. */
-export declare function capsurfacesize(surface: capmanifestsurface): {
-    surface: capmanifestsurface;
-    messages: number;
-    kinds: number;
-    permissions: number;
-};
-//# sourceMappingURL=apifreeze.d.ts.map