@gaia-ai/addon-grok 0.14.2 → 0.15.1

package/dist/src/index.d.ts

@@ -1,16 +1,21 @@
-import type { AgentFootprint, AgentPlugin, AgentRunIdentity, GaiaAgent } from '@gaia-ai/conductor/contract';
+import { type AgentFootprint, type AgentPlugin, type AgentRunIdentity, type GaiaAgent } from '@gaia-ai/conductor/contract';
 export { parseGrokTranscript } from './footprint.js';
 export type GrokReasoningEffort = 'high' | 'medium' | 'low';
 export interface GrokAgentOptions {
-    model: string;
-    reasoningEffort?: GrokReasoningEffort;
+    model?: string;
+    reasoningEffort?: GrokReasoningEffort | string;
+    effort?: string;
+    args?: string[];
 }
 export declare const DEFAULT_GROK_MODEL = "grok-4.6";
 export declare function encodeGrokSessionCwd(cwd: string): string;
 export declare class GrokAgent implements GaiaAgent {
-    private readonly options;
     private readonly home;
     readonly id = "grok";
+    private readonly args;
+    private readonly model;
+    private readonly effort;
+    private readonly overrides;
     constructor(options?: GrokAgentOptions, home?: string);
     launchCommand(prompt: string, run?: AgentRunIdentity): string;
     /**

package/dist/src/index.js

@@ -1,11 +1,17 @@
 import { readdir, readFile, stat } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
+import { resolveAgentCliOptions, validateOptionalString, } from '@gaia-ai/conductor/contract';
 import { shellQuote } from '@gaia-ai/core';
 import { parseGrokTranscript } from './footprint.js';
 export { parseGrokTranscript } from './footprint.js';
 export const DEFAULT_GROK_MODEL = 'grok-4.6';
 const DEFAULT_OPTIONS = { model: DEFAULT_GROK_MODEL };
+const GROK_RESERVED = ['--permission-mode', '--session-id'];
+const GROK_KNOWN = [
+    { kind: 'model', flags: ['--model', '-m'] },
+    { kind: 'effort', flags: ['--reasoning-effort', '--effort'] },
+];
 export function encodeGrokSessionCwd(cwd) {
     return encodeURIComponent(cwd);
 }
@@ -29,12 +35,21 @@ async function readJson(path) {
     }
 }
 export class GrokAgent {
-    options;
     home;
     id = 'grok';
+    args;
+    model;
+    effort;
+    overrides;
     constructor(options = DEFAULT_OPTIONS, home = homedir()) {
-        this.options = options;
         this.home = home;
+        const cli = resolveAgentCliOptions(options, GROK_RESERVED, GROK_KNOWN);
+        this.args = cli.args;
+        this.model = cli.model ?? DEFAULT_GROK_MODEL;
+        this.effort =
+            cli.effort ??
+                validateOptionalString(options.reasoningEffort, 'reasoningEffort');
+        this.overrides = cli.overrides;
     }
     launchCommand(prompt, run) {
         const parts = ['grok'];
@@ -45,9 +60,12 @@ export class GrokAgent {
             // dispatched into instead of holding a session there.
             parts.push(shellQuote(prompt));
         }
-        parts.push('--permission-mode', 'bypassPermissions', '-m', this.options.model);
-        if (this.options.reasoningEffort) {
-            parts.push('--reasoning-effort', this.options.reasoningEffort);
+        parts.push('--permission-mode', 'bypassPermissions');
+        if (!this.overrides.model) {
+            parts.push('-m', shellQuote(this.model));
+        }
+        if (this.effort !== undefined && !this.overrides.effort) {
+            parts.push('--reasoning-effort', shellQuote(this.effort));
         }
         // Pin the session dir name to the run's UUID (GAIA-473), so `getRunLog`
         // can select it directly instead of scanning every session dir under the
@@ -56,6 +74,9 @@ export class GrokAgent {
         if (run?.sessionId) {
             parts.push('--session-id', run.sessionId);
         }
+        if (prompt !== '') {
+            parts.push(...this.args.map(shellQuote));
+        }
         return parts.join(' ');
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaia-ai/addon-grok",
-  "version": "0.14.2",
+  "version": "0.15.1",
   "description": "GAIA agent plugin for xAI Grok Build, with a real session footprint.",
   "type": "module",
   "license": "MIT",
@@ -20,7 +20,7 @@
     "directory": "gaia-cli/addons/grok"
   },
   "peerDependencies": {
-    "@gaia-ai/conductor": "^0.14.2",
-    "@gaia-ai/core": "^0.14.2"
+    "@gaia-ai/conductor": "^0.15.1",
+    "@gaia-ai/core": "^0.15.1"
   }
 }