llm-cli-gateway 1.1.0 → 1.4.0

package/dist/request-helpers.d.ts

@@ -30,3 +30,44 @@ export declare function resolveSessionResumeArgs(opts: {
     resumeLatest?: boolean;
     createNewSession?: boolean;
 }): SessionResumeResult;
+/**
+ * Codex-specific resume planning.
+ *
+ * Codex CLI ≥ 0.30 exposes session resume as a subcommand (`codex exec resume`),
+ * not a flag pair like Claude/Gemini/Grok. So we can't return a simple list of
+ * args — we describe the *mode* and let the caller branch when building argv:
+ *
+ *   - "new"            → `codex exec [...flags] PROMPT`
+ *   - "resume-by-id"   → `codex exec resume [...resume-safe flags] <SESSION_ID> PROMPT`
+ *   - "resume-latest"  → `codex exec resume --last [...resume-safe flags] PROMPT`
+ *
+ * `codex exec resume` rejects `--full-auto`; the original session's approval
+ * policy is inherited. Callers MUST filter `--full-auto` out of the flag set
+ * when mode is one of the resume forms (see `prepareCodexRequest`).
+ *
+ * `sessionId` MUST be a real Codex session UUID (as recorded under
+ * `~/.codex/sessions/`). Gateway-generated `gw-*` IDs are rejected, since
+ * they are bookkeeping handles and would 404 against `codex resume`.
+ */
+export type CodexSessionMode = "new" | "resume-by-id" | "resume-latest";
+export interface CodexSessionPlan {
+    mode: CodexSessionMode;
+    /** Real Codex session UUID. Present only when mode === "resume-by-id". */
+    sessionId?: string;
+}
+export declare function resolveCodexSessionArgs(opts: {
+    sessionId?: string;
+    resumeLatest?: boolean;
+    createNewSession?: boolean;
+}): CodexSessionPlan;
+/**
+ * Grok-specific resume args. Grok accepts `--resume <id>` to resume a named session,
+ * and `--continue` to resume the most recent session for the current working directory.
+ * Unlike `resolveSessionResumeArgs`, "resume latest" maps to `--continue` (not `--resume latest`)
+ * because Grok would interpret a literal "latest" as a session ID.
+ */
+export declare function resolveGrokSessionArgs(opts: {
+    sessionId?: string;
+    resumeLatest?: boolean;
+    createNewSession?: boolean;
+}): SessionResumeResult;

package/dist/request-helpers.js

@@ -52,3 +52,43 @@ export function resolveSessionResumeArgs(opts) {
     }
     return { resumeArgs: [], effectiveSessionId: undefined, userProvidedSession: false };
 }
+export function resolveCodexSessionArgs(opts) {
+    if (opts.createNewSession) {
+        return { mode: "new" };
+    }
+    if (opts.sessionId) {
+        validateSessionId(opts.sessionId);
+        return { mode: "resume-by-id", sessionId: opts.sessionId };
+    }
+    if (opts.resumeLatest) {
+        return { mode: "resume-latest" };
+    }
+    return { mode: "new" };
+}
+/**
+ * Grok-specific resume args. Grok accepts `--resume <id>` to resume a named session,
+ * and `--continue` to resume the most recent session for the current working directory.
+ * Unlike `resolveSessionResumeArgs`, "resume latest" maps to `--continue` (not `--resume latest`)
+ * because Grok would interpret a literal "latest" as a session ID.
+ */
+export function resolveGrokSessionArgs(opts) {
+    if (opts.createNewSession) {
+        return { resumeArgs: [], effectiveSessionId: undefined, userProvidedSession: false };
+    }
+    if (opts.resumeLatest && !opts.sessionId) {
+        return {
+            resumeArgs: ["--continue"],
+            effectiveSessionId: undefined,
+            userProvidedSession: false,
+        };
+    }
+    if (opts.sessionId) {
+        validateSessionId(opts.sessionId);
+        return {
+            resumeArgs: ["--resume", opts.sessionId],
+            effectiveSessionId: opts.sessionId,
+            userProvidedSession: true,
+        };
+    }
+    return { resumeArgs: [], effectiveSessionId: undefined, userProvidedSession: false };
+}

package/dist/resources.js

@@ -54,6 +54,17 @@ export class ResourceProvider {
                     priority: 0.6,
                 },
             },
+            {
+                uri: "sessions://grok",
+                name: "Grok Sessions",
+                title: "⚡ Grok Sessions",
+                description: "List of Grok conversation sessions",
+                mimeType: "application/json",
+                annotations: {
+                    audience: ["user", "assistant"],
+                    priority: 0.6,
+                },
+            },
             {
                 uri: "models://claude",
                 name: "Claude Models",
@@ -87,6 +98,17 @@ export class ResourceProvider {
                     priority: 0.8,
                 },
             },
+            {
+                uri: "models://grok",
+                name: "Grok Models",
+                title: "⚡ Grok Models & Capabilities",
+                description: "Available Grok models and their capabilities",
+                mimeType: "application/json",
+                annotations: {
+                    audience: ["user", "assistant"],
+                    priority: 0.8,
+                },
+            },
             {
                 uri: "metrics://performance",
                 name: "Performance Metrics",
@@ -121,6 +143,7 @@ export class ResourceProvider {
                         claude: (await this.sessionManager.getActiveSession("claude"))?.id || null,
                         codex: (await this.sessionManager.getActiveSession("codex"))?.id || null,
                         gemini: (await this.sessionManager.getActiveSession("gemini"))?.id || null,
+                        grok: (await this.sessionManager.getActiveSession("grok"))?.id || null,
                     },
                 }, null, 2),
             };
@@ -164,6 +187,19 @@ export class ResourceProvider {
                 }, null, 2),
             };
         }
+        if (uri === "sessions://grok") {
+            const sessions = await this.sessionManager.listSessions("grok");
+            return {
+                uri,
+                mimeType: "application/json",
+                text: JSON.stringify({
+                    cli: "grok",
+                    total: sessions.length,
+                    sessions,
+                    activeSession: (await this.sessionManager.getActiveSession("grok"))?.id || null,
+                }, null, 2),
+            };
+        }
         // Model capability resources
         if (uri === "models://claude") {
             const cliInfo = getCliInfo();
@@ -189,6 +225,14 @@ export class ResourceProvider {
                 text: JSON.stringify(cliInfo.gemini, null, 2),
             };
         }
+        if (uri === "models://grok") {
+            const cliInfo = getCliInfo();
+            return {
+                uri,
+                mimeType: "application/json",
+                text: JSON.stringify(cliInfo.grok, null, 2),
+            };
+        }
         if (uri === "metrics://performance") {
             return {
                 uri,

package/dist/session-manager-pg.js

@@ -3,6 +3,7 @@ const DEFAULT_SESSION_DESCRIPTIONS = {
     claude: "Claude Session",
     codex: "Codex Session",
     gemini: "Gemini Session",
+    grok: "Grok Session",
 };
 /**
  * PostgreSQL-backed session manager with Redis caching

package/dist/session-manager.d.ts

@@ -1,7 +1,7 @@
 import type { Config } from "./config.js";
 import type { DatabaseConnection } from "./db.js";
 import type { Logger } from "./logger.js";
-export declare const CLI_TYPES: readonly ["claude", "codex", "gemini"];
+export declare const CLI_TYPES: readonly ["claude", "codex", "gemini", "grok"];
 export type CliType = (typeof CLI_TYPES)[number];
 export interface Session {
     id: string;

package/dist/session-manager.js

@@ -4,12 +4,13 @@ import { join, dirname } from "path";
 import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync, openSync, fsyncSync, closeSync, chmodSync, } from "fs";
 import { DEFAULT_SESSION_TTL_SECONDS } from "./config.js";
 import { noopLogger } from "./logger.js";
-export const CLI_TYPES = ["claude", "codex", "gemini"];
+export const CLI_TYPES = ["claude", "codex", "gemini", "grok"];
 const createEmptyActiveSessions = () => Object.fromEntries(CLI_TYPES.map(cli => [cli, null]));
 const DEFAULT_SESSION_DESCRIPTIONS = {
     claude: "Claude Session",
     codex: "Codex Session",
     gemini: "Gemini Session",
+    grok: "Grok Session",
 };
 export class FileSessionManager {
     storagePath;

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "llm-cli-gateway",
-  "version": "1.1.0",
+  "version": "1.4.0",
   "mcpName": "io.github.verivus-oss/llm-cli-gateway",
-  "description": "MCP server providing unified access to Claude Code, Codex, and Gemini CLIs with session management, retry logic, and async job orchestration.",
+  "description": "MCP server providing unified access to Claude Code, Codex, Gemini, and Grok CLIs with session management, retry logic, async job orchestration, and durable job results.",
   "license": "MIT",
   "author": {
     "name": "VerivusAI Labs",
@@ -72,7 +72,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "better-sqlite3": "^11.0.0",
+    "better-sqlite3": "^12.9.0",
     "ioredis": "^5.4.1",
     "pg": "^8.12.0",
     "toml": "^3.0.0",