@cortexkit/opencode-antigravity-auth 1.1.0 → 2.0.1

package/dist/src/plugin/commands.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Slash-command wiring for the antigravity plugin.
+ *
+ * Three places must agree on the set of modal commands — keeping
+ * them in lockstep is a hard invariant:
+ *
+ *   1. `MODAL_COMMANDS` — the canonical list of `CommandModalName`s.
+ *   2. `registerAntigravityCommands` (in `./catalog.ts`) — what we
+ *      register in the host `config.command.*` map so OpenCode
+ *      recognises them.
+ *   3. `buildDialogPayload` (here) — the per-command dialog payload
+ *      builder the TUI renders when a notification arrives.
+ *
+ * If any one drifts, a future slash command will be discoverable in
+ * the host palette but invisible to the dialog flow (or vice versa).
+ * The bidirectional three-wiring test pins this invariant.
+ *
+ * `/gemini-dump` remains a backward-compatibility alias: the host
+ * already registers the command under that name in `OpenCode` and
+ * long-running sessions may still call it. The modal name
+ * `antigravity-dump` is the canonical name; both stay registered.
+ */
+import type { CommandModalName } from '../rpc/protocol';
+import type { AccountCommandOAuthService } from './account-command-oauth';
+import type { CommandAccountRow, CommandDataService } from './command-data';
+import { type OperatorSettingsController } from './operator-settings';
+import type { PluginClient, PluginResult } from './types';
+export declare const ANTIGRAVITY_QUOTA_COMMAND_NAME = "antigravity-quota";
+export declare const ANTIGRAVITY_ACCOUNT_COMMAND_NAME = "antigravity-account";
+export declare const ANTIGRAVITY_ROUTING_COMMAND_NAME = "antigravity-routing";
+export declare const ANTIGRAVITY_KILLSWITCH_COMMAND_NAME = "antigravity-killswitch";
+export declare const ANTIGRAVITY_DUMP_COMMAND_NAME = "antigravity-dump";
+export declare const ANTIGRAVITY_LOGGING_COMMAND_NAME = "antigravity-logging";
+export declare const MODAL_COMMANDS: readonly CommandModalName[];
+interface CommandContext {
+    sessionID: string;
+    client: PluginClient;
+    settings: OperatorSettingsController;
+    /**
+     * Optional callback invoked AFTER `applyCommand` mutates persistent
+     * state. The plugin entry injects a callback that pushes the current
+     * account pool into the sidebar so the TUI sees a fresh snapshot.
+     * Commands that need to chain side effects (e.g. account add which
+     * triggers an OAuth flow) hook their own refresh.
+     */
+    onApplied?: (accounts?: CommandAccountRow[]) => Promise<void> | void;
+    /**
+     * Privacy-safe data service that backs the data-first dialogs. The
+     * production wiring injects one that reads from the live AccountManager
+     * + storage and refreshes through the shared quota manager; tests
+     * (and any context that does not care about quota UI) leave this
+     * undefined and the dialog falls back to the legacy placeholder.
+     */
+    commandData?: CommandDataService;
+    accountOAuth?: AccountCommandOAuthService;
+}
+/**
+ * Build the dialog payload the TUI renders for `command`.
+ *
+ * Each branch produces a self-contained payload the OpenTUI dialog tree
+ * can mount without further RPC chatter. The knobs object is the
+ * payload-specific metadata (current toggle state, available actions,
+ * default values) — knobs are intentionally stringly-typed to keep the
+ * dialog code free of per-command schema definitions.
+ */
+export declare function buildDialogPayload(command: CommandModalName, argumentsText: string, context: CommandContext): Promise<{
+    command: CommandModalName;
+    text: string;
+    knobs: Record<string, unknown>;
+}>;
+export interface ApplyRequest {
+    command: CommandModalName;
+    arguments: string;
+    sessionId?: string;
+}
+export interface ApplyResult {
+    text: string;
+    knobs: Record<string, unknown>;
+}
+/**
+ * Apply the result of a TUI dialog back to the plugin runtime.
+ *
+ * Most commands mutate persistent operator settings (routing toggles,
+ * killswitch thresholds, log level). Account add/refresh kicks off the
+ * OAuth flow which can take up to two minutes on a fresh login — that
+ * path opts into a 120s RPC timeout. Status / toggle paths keep the
+ * default 2s timeout.
+ *
+ * The TUI's imperative dispatcher (`tui/command-dialogs.openCommandDialog`)
+ * forwards the apply `options.timeoutMs` knob into the RPC apply call
+ * so a long-running path (account add / refresh) can opt in without the
+ * dialog layer having to special-case it.
+ */
+export declare function applyCommand(request: ApplyRequest, context: CommandContext): Promise<ApplyResult>;
+/**
+ * Build a sidebar refresher bound to the supplied account-snapshot provider.
+ * The plugin entry passes `lifecycle.getAccountManager()`'s snapshot getter so
+ * every `/antigravity-*` apply that mutates persistent state also bumps the
+ * sidebar's `checkedAt`. The refresher is best-effort: a lock-contention
+ * error or missing manager is swallowed by the caller.
+ */
+export declare function createSidebarRefresher(getAccounts: () => Array<{
+    index: number;
+    label?: string;
+    enabled?: boolean;
+    coolingDownUntil?: number;
+    cachedQuota?: {
+        gemini?: {
+            remainingFraction?: number;
+            resetTime?: string;
+        };
+        'non-gemini'?: {
+            remainingFraction?: number;
+            resetTime?: string;
+        };
+    };
+    /** Captured plan tier. Absent when unknown. */
+    tier?: {
+        id: string;
+        capturedAt: number;
+    };
+}> | null): (accounts?: CommandAccountRow[]) => Promise<void>;
+/**
+ * Optional handle for the host connection state. Tests inject a stub
+ * to force the connected/disconnected branch; production callers let
+ * the default fall through to the singleton `isTuiConnected` from
+ * `rpc/notifications`, which reports "disconnected" until a TUI drain
+ * has landed in the last `CONNECTION_TTL_MS` window.
+ */
+export interface CommandConnectionState {
+    isTuiConnected(sessionId?: string): boolean;
+}
+/**
+ * Hook the host's `command.execute.before` to the modal commands.
+ *
+ * When a slash command is invoked, we push a notification onto the
+ * RPC queue and abort the normal prompt with the same handled
+ * sentinel the legacy `/gemini-dump` flow already uses.
+ *
+ * The `sendIgnoredMessage` fallback only fires when no TUI is
+ * listening — the only path that actually consumes the queued
+ * message. With a live TUI, push alone is enough; double-sending
+ * would otherwise render the command text as a visible chat message
+ * alongside the dialog the TUI renders.
+ */
+export declare function createCommandExecuteBefore(client: PluginClient, settings: OperatorSettingsController, pushNotification: (payload: Awaited<ReturnType<typeof buildDialogPayload>>, sessionId?: string) => void, commandData?: CommandDataService, connectionState?: CommandConnectionState): PluginResult['command.execute.before'];
+/**
+ * Backward-compat wrapper that constructs a no-settings `command.execute.before`
+ * for tests that don't care about the operator settings controller. Production
+ * code wires the real controller via `createAntigravityPlugin`.
+ */
+export declare function createCommandExecuteBeforeForClient(client: PluginClient, commandData?: CommandDataService): PluginResult['command.execute.before'];
+export {};
+//# sourceMappingURL=commands.d.ts.map

package/dist/src/plugin/commands.d.ts.map

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