llm-cli-gateway 2.4.0 → 2.6.0

package/dist/upstream-contracts.js

@@ -386,7 +386,42 @@ export const UPSTREAM_CLI_CONTRACTS = {
                 "--skip-git-repo-check",
                 "--strict-config",
                 "--version",
-            ]),
+            ], {
+                children: {
+                    resume: subcommand(["exec", "resume"], "Resume Codex sessions from the interactive CLI.", "executes_agent", [
+                        "--add-dir",
+                        "--all",
+                        "--cd",
+                        "--config",
+                        "--dangerously-bypass-approvals-and-sandbox",
+                        "--dangerously-bypass-hook-trust",
+                        "--disable",
+                        "--enable",
+                        "--image",
+                        "--include-non-interactive",
+                        "--last",
+                        "--local-provider",
+                        "--model",
+                        "--no-alt-screen",
+                        "--oss",
+                        "--profile",
+                        "--remote",
+                        "--remote-auth-token-env",
+                        "--sandbox",
+                        "--strict-config",
+                    ]),
+                    review: subcommand(["exec", "review"], "Run Codex code review workflows.", "executes_agent", [
+                        "--base",
+                        "--commit",
+                        "--config",
+                        "--disable",
+                        "--enable",
+                        "--strict-config",
+                        "--title",
+                        "--uncommitted",
+                    ]),
+                },
+            }),
             review: subcommand(["review"], "Run Codex code review workflows.", "executes_agent", [
                 "--base",
                 "--commit",
@@ -457,31 +492,6 @@ export const UPSTREAM_CLI_CONTRACTS = {
             ], { exposure: "not_exposed" }),
             debug: subcommand(["debug"], "Run Codex debugging utilities.", "read_only", ["--config", "--disable", "--enable"], { tier: "diagnostic" }),
             apply: subcommand(["apply"], "Apply a Codex patch to the workspace.", "destructive", ["--config", "--disable", "--enable"], { exposure: "not_exposed" }),
-            resume: subcommand(["resume"], "Resume Codex sessions from the interactive CLI.", "executes_agent", [
-                "--add-dir",
-                "--all",
-                "--ask-for-approval",
-                "--cd",
-                "--config",
-                "--dangerously-bypass-approvals-and-sandbox",
-                "--dangerously-bypass-hook-trust",
-                "--disable",
-                "--enable",
-                "--image",
-                "--include-non-interactive",
-                "--last",
-                "--local-provider",
-                "--model",
-                "--no-alt-screen",
-                "--oss",
-                "--profile",
-                "--remote",
-                "--remote-auth-token-env",
-                "--sandbox",
-                "--search",
-                "--strict-config",
-                "--version",
-            ]),
             archive: subcommand(["archive"], "Archive Codex session state.", "writes_local_config", [
                 "--add-dir",
                 "--cd",
@@ -769,53 +779,37 @@ export const UPSTREAM_CLI_CONTRACTS = {
     },
     gemini: {
         cli: "gemini",
-        executable: "gemini",
-        upstream: "Google Gemini CLI",
+        executable: "agy",
+        upstream: "Google Antigravity CLI",
         upstreamMetadata: {
             sourceUrls: [
-                "https://geminicli.com/docs/changelogs/",
-                "https://github.com/google-gemini/gemini-cli/releases",
+                "https://antigravity.google/docs/cli-overview",
+                "https://github.com/google-antigravity/antigravity-cli/releases",
             ],
-            packageName: "@google/gemini-cli",
-            repo: "https://github.com/google-gemini/gemini-cli",
-            installDocsUrl: "https://geminicli.com/docs/",
-            releaseChannel: "npm",
-            watchCategories: ["flags", "approval-modes", "output-formats", "session-resume"],
+            repo: "https://github.com/google-antigravity/antigravity-cli",
+            installDocsUrl: "https://antigravity.google/docs/cli-getting-started",
+            releaseChannel: "vendor",
+            watchCategories: ["flags", "permissions", "session-resume", "subcommands"],
         },
         helpArgs: [["--help"]],
         subcommands: {
-            mcp: subcommand(["mcp"], "Manage Gemini MCP server configuration.", "writes_local_config", ["--debug"], {
-                flagArities: { "--debug": "none" },
-            }),
-            extensions: subcommand(["extensions"], "Manage Gemini extensions.", "writes_local_config", ["--debug"], {
-                aliases: ["extension"],
-                flagArities: { "--debug": "none" },
-            }),
-            extension: subcommand(["extension"], "Alias for Gemini extension management.", "writes_local_config", ["--debug"], {
-                aliases: ["extensions"],
-                flagArities: { "--debug": "none" },
-            }),
-            skills: subcommand(["skills"], "Manage Gemini skills.", "writes_local_config", ["--debug"], {
-                aliases: ["skill"],
-                flagArities: { "--debug": "none" },
+            changelog: subcommand(["changelog"], "Show Antigravity CLI changelog and release notes.", "read_only", [], { tokenCost: "small" }),
+            install: subcommand(["install"], "Configure Antigravity CLI environment paths and shell settings.", "writes_local_config", ["--dir", "--skip-aliases", "--skip-path"], {
+                flagArities: { "--dir": "one", "--skip-aliases": "none", "--skip-path": "none" },
             }),
-            skill: subcommand(["skill"], "Alias for Gemini skill management.", "writes_local_config", ["--debug"], {
-                aliases: ["skills"],
-                flagArities: { "--debug": "none" },
+            models: subcommand(["models"], "List available Antigravity models.", "read_only", [], {
+                exposure: "mcp_readonly",
+                tokenCost: "small",
             }),
-            hooks: subcommand(["hooks"], "Manage Gemini hooks.", "writes_local_config", ["--debug"], {
-                aliases: ["hook"],
-                flagArities: { "--debug": "none" },
-            }),
-            hook: subcommand(["hook"], "Alias for Gemini hook management.", "writes_local_config", ["--debug"], {
-                aliases: ["hooks"],
-                flagArities: { "--debug": "none" },
+            plugin: subcommand(["plugin"], "Manage Antigravity plugins.", "writes_local_config", [], {
+                aliases: ["plugins"],
             }),
-            gemma: subcommand(["gemma"], "Run Gemini Gemma local-model helper surfaces.", "executes_agent", ["--debug"], {
-                flagArities: { "--debug": "none" },
+            plugins: subcommand(["plugins"], "Alias for Antigravity plugin management.", "writes_local_config", [], {
+                aliases: ["plugin"],
             }),
+            update: subcommand(["update"], "Update Antigravity CLI to the current release.", "writes_local_config", [], { tokenCost: "small" }),
         },
-        maxPositionals: 0,
+        maxPositionals: 1,
         mcpTools: ["gemini_request", "gemini_request_async"],
         mcpParameters: [
             "prompt",
@@ -837,90 +831,63 @@ export const UPSTREAM_CLI_CONTRACTS = {
             "yolo",
         ],
         flags: {
-            "-p": { arity: "one", description: "Prompt text" },
+            "--print": { arity: "none", description: "Run a single prompt non-interactively" },
+            "-p": { arity: "none", description: "Short alias for --print" },
+            "--prompt": { arity: "none", description: "Alias for --print" },
             "--model": { arity: "one", description: "Model selector" },
-            "--approval-mode": {
-                arity: "one",
-                values: ["default", "auto_edit", "yolo", "plan"],
-                description: "Approval mode",
-            },
-            "--allowed-tools": { arity: "one", description: "Allowed tool" },
-            "--allowed-mcp-server-names": { arity: "one", description: "Allowed MCP server" },
-            "--include-directories": { arity: "one", description: "Included directory" },
-            "-s": { arity: "none", description: "Sandbox mode" },
-            "--policy": { arity: "one", description: "Policy file path" },
-            "--admin-policy": { arity: "one", description: "Admin policy file path" },
-            "-o": {
-                arity: "one",
-                values: ["json", "stream-json"],
-                description: "Output format (Phase 4 slice ε adds stream-json)",
-            },
-            "--resume": { arity: "one", description: "Resume session" },
-            "--skip-trust": {
+            "--add-dir": { arity: "one", description: "Additional workspace directory" },
+            "--sandbox": { arity: "none", description: "Run with terminal sandbox restrictions" },
+            "--dangerously-skip-permissions": {
                 arity: "none",
-                description: "Trust workspace for this session (Phase 4 slice γ)",
-            },
-            "--yolo": {
-                arity: "none",
-                description: "Auto-approve all actions (gemini -y/--yolo). Functionally equivalent to --approval-mode yolo; the gateway emits at most one of the two.",
+                description: "Auto-approve all tool permission requests without prompting",
             },
+            "--conversation": { arity: "one", description: "Resume a previous conversation by ID" },
+            "--continue": { arity: "none", description: "Continue the most recent conversation" },
+            "-c": { arity: "none", description: "Short alias for --continue" },
         },
         acknowledgedUpstreamFlags: [
-            "--accept-raw-output-risk",
-            "--acp",
-            "--debug",
-            "--delete-session",
-            "--experimental-acp",
-            "--extensions",
-            "--list-extensions",
-            "--list-sessions",
-            "--output-format",
-            "--prompt",
             "--prompt-interactive",
-            "--raw-output",
-            "--sandbox",
-            "--screen-reader",
-            "--session-file",
-            "--session-id",
+            "-i",
+            "--print-timeout",
+            "--log-file",
             "--version",
-            "--worktree",
         ],
         env: {},
         conformanceFixtures: [
             {
                 id: "gemini-minimal",
-                description: "Minimal prompt request",
-                args: ["-p", "hello"],
+                description: "Minimal Antigravity print-mode prompt request",
+                args: ["--print", "hello"],
                 expect: "pass",
             },
             {
                 id: "gemini-unsupported-flag",
                 description: "Unsupported flag is rejected before spawn",
-                args: ["-p", "hello", "--not-a-gemini-flag"],
+                args: ["--print", "hello", "--not-a-gemini-flag"],
                 expect: "fail",
             },
             {
-                id: "gemini-skip-trust",
-                description: "Phase 4 slice γ: --skip-trust is accepted",
-                args: ["-p", "hello", "--skip-trust"],
+                id: "gemini-antigravity-workspace-flags",
+                description: "Antigravity workspace and sandbox flags are accepted",
+                args: ["--print", "hello", "--add-dir", "/tmp", "--sandbox"],
                 expect: "pass",
             },
             {
                 id: "gemini-yolo",
-                description: "--yolo (auto-approve all) is accepted",
-                args: ["-p", "hello", "--yolo"],
+                description: "Antigravity permission bypass is accepted",
+                args: ["--print", "hello", "--dangerously-skip-permissions"],
                 expect: "pass",
             },
             {
-                id: "gemini-stream-json",
-                description: "Phase 4 slice ε: -o stream-json is accepted",
-                args: ["-p", "hello", "-o", "stream-json"],
+                id: "gemini-conversation",
+                description: "Antigravity conversation resume is accepted",
+                args: ["--print", "hello", "--conversation", "user-session"],
                 expect: "pass",
             },
             {
-                id: "gemini-output-format-invalid",
-                description: "Phase 4 slice ε: -o ndjson is rejected (not in contract enum)",
-                args: ["-p", "hello", "-o", "ndjson"],
+                id: "gemini-legacy-output-format-rejected",
+                description: "Legacy Gemini JSON output flag is rejected",
+                args: ["--print", "hello", "-o", "json"],
                 expect: "fail",
             },
         ],
@@ -1253,12 +1220,18 @@ export const UPSTREAM_CLI_CONTRACTS = {
                     "--prompt-json",
                     "[]",
                     "--restore-code",
+                    "--leader-socket",
+                    "/tmp/leader.sock",
                     "--single",
                     "single prompt",
                     "--todo-gate",
                     "--verbatim",
                     "--version",
                     "--worktree",
+                    "--compaction-mode",
+                    "summary",
+                    "--compaction-detail",
+                    "balanced",
                 ],
                 expect: "pass",
             },
@@ -1309,6 +1282,12 @@ export const UPSTREAM_CLI_CONTRACTS = {
                 args: ["-p", "hello", "--leader-socket"],
                 expect: "fail",
             },
+            {
+                id: "grok-0.2.38-agent-surface",
+                description: "Grok 0.2.38: top-level --agent + --leader-socket co-occurrence accepted (dated example using flags current at 0.2.38; the agent subcommand expansion flags e.g. --agent-profile/--reauth/--grok-ws-* are listed in the subcommand contract declaration for --probe-installed drift tracking and are not part of this primary-path fixture's argv)",
+                args: ["-p", "hello", "--agent", "reviewer", "--leader-socket", "/tmp/leader.sock"],
+                expect: "pass",
+            },
         ],
     },
     mistral: {

package/dist/workspace-registry.d.ts

@@ -0,0 +1,63 @@
+import { type CliType } from "./session-manager.js";
+import type { Logger } from "./logger.js";
+export interface WorkspaceRepo {
+    alias: string;
+    path: string;
+    providers: CliType[];
+    allowWorktree: boolean;
+    allowAddDir: boolean;
+    kind: "git" | "folder";
+    operatorEntry: boolean;
+}
+export interface WorkspaceAllowedRoot {
+    alias: string;
+    path: string;
+    allowRegisterExistingGitRepos: boolean;
+    allowCreateDirectories: boolean;
+    allowInitGitRepos: boolean;
+    maxCreateDepth: number;
+}
+export interface WorkspaceRegistry {
+    enabled: boolean;
+    defaultAlias: string | null;
+    allowUnregisteredWorkingDir: boolean;
+    repos: WorkspaceRepo[];
+    allowedRoots: WorkspaceAllowedRoot[];
+    sources: {
+        configFile: string | null;
+    };
+}
+export interface EffectiveWorkspace {
+    alias: string;
+    root: string;
+    cwd: string;
+    worktreePath?: string;
+    repo: WorkspaceRepo;
+}
+export interface CreateWorkspaceInput {
+    alias: string;
+    rootAlias: string;
+    slug: string;
+    kind: "folder" | "git";
+    setDefault?: boolean;
+    configPath?: string;
+    logger?: Logger;
+}
+export declare class WorkspaceRegistryError extends Error {
+    constructor(message: string);
+}
+export declare function validateWorkspaceAlias(alias: string): string;
+export declare function loadWorkspaceRegistry(logger?: Logger, configPath?: string): WorkspaceRegistry;
+export declare function getWorkspace(registry: WorkspaceRegistry, alias: string): WorkspaceRepo;
+export declare function resolveWorkspaceForProvider(registry: WorkspaceRegistry, provider: CliType, requestedAlias?: string, sessionMetadata?: Record<string, unknown>): EffectiveWorkspace;
+export declare function validatePathInsideWorkspace(workspace: EffectiveWorkspace, candidate: string, policy: "workingDir" | "addDir"): string;
+export declare function createWorkspace(input: CreateWorkspaceInput): WorkspaceRepo;
+export declare function registerExistingWorkspace(input: {
+    alias: string;
+    repoPath: string;
+    setDefault?: boolean;
+    configPath?: string;
+    logger?: Logger;
+}): WorkspaceRepo;
+export declare function createTempWorkspaceConfig(contents: string): string;
+export declare function describeWorkspace(repo: WorkspaceRepo): Record<string, unknown>;