@cortexkit/antigravity-auth-core 2.2.1 → 3.0.1

package/dist/antigravity-command-menu.d.ts

@@ -0,0 +1,171 @@
+/**
+ * The `/antigravity` command menu, shared by every host adapter.
+ *
+ * The menu itself (payloads, confirmation, redaction, per-invocation
+ * isolation and action dispatch) is common-auth's public `./commands` entry;
+ * this module only supplies Antigravity's section bodies. The Accounts,
+ * Quota, Routing and Limits slots replace the library's store-backed
+ * built-ins, because the built-ins would put each account's row id and
+ * recorded identity (its email) into the payload a renderer receives.
+ *
+ * Accounts are shown by position ("Account 2") and carry an opaque item id:
+ * a random string bound for the life of the menu to one exact credential
+ * (row id, credential epoch and recorded identity). An action runs against
+ * the credential captured in the read that built it, and the repository
+ * refuses it if that credential has since changed. Item ids are never reused
+ * for another credential and positions are never accepted as targets.
+ *
+ * Nothing here imports a host SDK; the commands module, the account source
+ * and the settings arrive from the caller.
+ */
+import type { AccountRepository, RowRef } from './account-repository-types.ts';
+import type { CommonAuthCommandsModule } from './common-auth-runtime.ts';
+type Commands = CommonAuthCommandsModule;
+type CommandMenu = ReturnType<Commands['createCommandMenu']>;
+type CommandMenuOptions = Parameters<Commands['createCommandMenu']>[0];
+type PluginSection = NonNullable<CommandMenuOptions['cache']>;
+type PluginExtraSection = NonNullable<CommandMenuOptions['extras']>[number];
+type SectionContent = Awaited<ReturnType<PluginSection['build']>>;
+type ItemDefinition = NonNullable<SectionContent['items']>[number];
+type ActionDefinition = NonNullable<ItemDefinition['actions']>[number];
+type ActionOutcome = Exclude<Awaited<ReturnType<ActionDefinition['run']>>, string>;
+type CommandInvocation = Parameters<PluginSection['build']>[0];
+/** The slash command's name, without the slash. */
+export declare const ANTIGRAVITY_MENU_COMMAND = "antigravity";
+export declare const ANTIGRAVITY_MENU_TITLE = "Antigravity";
+/** `disabledReason` recorded when the user disables an account from the menu. */
+export declare const ANTIGRAVITY_MENU_DISABLED_REASON = "disabled from the command menu";
+/** The account operations the menu reads and writes. */
+export type AntigravityMenuAccounts = Pick<AccountRepository, 'read' | 'setEnabled' | 'remove' | 'selectAccount'>;
+/** Routing and killswitch values the Routing and Limits sections show. */
+export interface AntigravityMenuSettings {
+    readonly routing: {
+        readonly cliFirst: boolean;
+        readonly quotaStyleFallback: boolean;
+    };
+    readonly killswitch: {
+        readonly enabled: boolean;
+        readonly minimumRemainingPercent: number;
+    };
+}
+/**
+ * The location's operator settings. `read` is called for every section
+ * build, so the menu always shows the current values; only the two update
+ * methods write.
+ */
+export interface AntigravityMenuSettingsSource {
+    read(): AntigravityMenuSettings | Promise<AntigravityMenuSettings>;
+    updateRouting(next: AntigravityMenuSettings['routing']): Promise<void>;
+    updateKillswitch(next: AntigravityMenuSettings['killswitch']): Promise<void>;
+}
+/**
+ * The outcome of one quota check over the menu's accounts. `checked` counts
+ * readings taken and recorded for exactly the credential they were asked
+ * for; `notChecked` counts the rest (refused because the credential changed
+ * or is unusable, or failed).
+ */
+export interface AntigravityQuotaCheckReport {
+    readonly checked: number;
+    readonly notChecked: number;
+}
+/** Options both menu modes share; the host's sections and the menu plumbing. */
+interface AntigravityMenuSharedOptions {
+    /** common-auth's public `./commands` entry, as `loadCommonAuthCommands` returns it. */
+    readonly commands: Commands;
+    readonly cache?: PluginSection;
+    readonly diagnostics?: PluginSection;
+    readonly extras?: readonly PluginExtraSection[];
+    readonly logger?: CommandMenuOptions['logger'];
+    readonly redaction?: CommandMenuOptions['redaction'];
+    readonly now?: () => number;
+}
+/**
+ * A menu over an account repository (OpenCode): this module builds the
+ * Accounts, Quota, Routing and Limits sections from the repository and the
+ * location's operator settings.
+ */
+export interface AntigravityRepositoryMenuOptions extends AntigravityMenuSharedOptions {
+    readonly source: 'repository';
+    readonly accounts: AntigravityMenuAccounts;
+    readonly settings: AntigravityMenuSettingsSource;
+    /**
+     * Checks quota now for exactly the given account credentials and reports
+     * how many readings were taken. Without it the Quota section offers no
+     * check action.
+     */
+    readonly refreshQuota?: (refs: readonly RowRef[], invocation: CommandInvocation) => Promise<AntigravityQuotaCheckReport>;
+    /**
+     * The host's login. It returns the text to show; the host owns the OAuth
+     * flow (browser, callback, manual paste) and adds the account itself.
+     */
+    readonly login?: {
+        readonly label?: string;
+        run(invocation: CommandInvocation): Promise<string | ActionOutcome>;
+    };
+    /**
+     * Per-account quota floors the host keeps. Without it the account items
+     * offer no floor action.
+     */
+    readonly accountLimits?: AntigravityAccountLimitSource;
+    /**
+     * The host's re-authentication of one account: a fresh sign-in that
+     * replaces exactly the credential named by the captured reference. It may
+     * finish later (a browser sign-in); it reports through the invocation.
+     * Without it the account items offer no Reauthorize action.
+     */
+    readonly reauthorize?: {
+        readonly label?: string;
+        run(ref: RowRef, invocation: CommandInvocation): Promise<string | ActionOutcome>;
+    };
+    /** Item id source; defaults to 128 random bits. */
+    readonly createItemId?: () => string;
+}
+/**
+ * A per-account minimum remaining quota, kept by the host. The menu hands it
+ * the exact credential reference captured for the item, never a position,
+ * an id shown to the user or a value derived from a token; how the floor is
+ * stored stays private to the host. `write` answers `stale` (or throws the
+ * repository's attribution failure) when that credential is no longer the
+ * row's current one, and then writes nothing.
+ */
+export interface AntigravityAccountLimitSource {
+    /** The account's own floor, or null when it follows the global floor. */
+    read(ref: RowRef): number | null | Promise<number | null>;
+    /** Sets the floor; null returns the account to the global floor. */
+    write(ref: RowRef, minimumRemainingPercent: number | null): Promise<'applied' | 'stale'>;
+}
+/** The four account slots, each supplied by the host. */
+export interface AntigravityMenuSections {
+    readonly accounts: PluginSection;
+    readonly quota: PluginSection;
+    readonly routing: PluginSection;
+    readonly limits: PluginSection;
+}
+/**
+ * A menu whose account slots the host builds itself (a single login or a
+ * vault-held account, with no account rows to expose). No repository is
+ * read or written; the host's items and actions run through the same
+ * library dispatcher.
+ */
+export interface AntigravitySectionsMenuOptions extends AntigravityMenuSharedOptions {
+    readonly source: 'sections';
+    readonly sections: AntigravityMenuSections;
+}
+export type AntigravityCommandMenuOptions = AntigravityRepositoryMenuOptions | AntigravitySectionsMenuOptions;
+/** What a quota check shows: never success when no reading was taken. */
+export declare function quotaCheckOutcome(report: AntigravityQuotaCheckReport): string | ActionOutcome;
+/**
+ * The Routing and Limits sections over a settings source, for a host that
+ * supplies its own account slots (sections mode) but keeps the same
+ * operator settings as the repository-mode menu.
+ */
+export declare function antigravitySettingsSections(settings: AntigravityMenuSettingsSource): Pick<AntigravityMenuSections, 'routing' | 'limits'>;
+/**
+ * Builds the `/antigravity` menu on common-auth's `createCommandMenu`. The
+ * four account slots replace the library's store-backed built-ins in both
+ * modes, so no pool store is passed; Cache, Diagnostics and extras are the
+ * host's.
+ */
+export declare function createAntigravityCommandMenu(options: AntigravityCommandMenuOptions): CommandMenu;
+export {};
+//# sourceMappingURL=antigravity-command-menu.d.ts.map

package/dist/antigravity-command-menu.d.ts.map

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