grok-agent 0.5.0

package/dist/types.d.ts

@@ -0,0 +1,159 @@
+import type OpenAI from "openai";
+export type ChatMessage = OpenAI.Chat.Completions.ChatCompletionMessageParam;
+export type ToolCall = OpenAI.Chat.Completions.ChatCompletionMessageToolCall;
+export type ToolDef = OpenAI.Chat.Completions.ChatCompletionTool;
+export type StreamChunk = OpenAI.Chat.Completions.ChatCompletionChunk;
+export interface GrokConfig {
+    apiKey: string;
+    managementApiKey: string;
+    baseUrl: string;
+    managementBaseUrl: string;
+    model: string;
+    maxTokens: number;
+    timeout: number;
+    reasoningEffort: "low" | "high";
+    showReasoning: boolean;
+    showToolCalls: boolean;
+    showUsage: boolean;
+    showCitations: boolean;
+    showDiffs: boolean;
+    showServerToolUsage: boolean;
+    maxToolRounds: number;
+    serverTools: ServerToolConfig[];
+    useResponsesApi: boolean;
+    sessionDir: string;
+    mcpServers: McpServer[];
+    imageInputs: string[];
+    fileAttachments: string[];
+    jsonSchema: string | null;
+    approvalPolicy: ApprovalPolicy;
+    sandboxMode: SandboxMode;
+    toolApprovals: ToolApprovalSettings;
+    includeToolOutputs: boolean;
+    notify: boolean;
+    hooks: HooksConfig;
+    convId: string | null;
+    jsonOutput: boolean;
+    ephemeral: boolean;
+    outputFile: string | null;
+    color: "auto" | "always" | "never";
+    maxOutputTokens: number;
+}
+export type ApprovalPolicy = "always-approve" | "ask" | "deny-writes";
+export type SandboxMode = "danger-full-access" | "workspace-write" | "read-only";
+export type ToolApprovalMode = "allow" | "ask" | "deny";
+export type ServerToolKind = "web_search" | "x_search" | "code_execution" | "file_search";
+export interface WebSearchToolConfig {
+    type: "web_search";
+    filters?: {
+        allowedDomains?: string[];
+        excludedDomains?: string[];
+    };
+    enableImageUnderstanding?: boolean;
+    includeSources?: boolean;
+}
+export interface XSearchToolConfig {
+    type: "x_search";
+    allowedXHandles?: string[];
+    excludedXHandles?: string[];
+    fromDate?: string;
+    toDate?: string;
+    enableImageUnderstanding?: boolean;
+    enableVideoUnderstanding?: boolean;
+}
+export interface CodeExecutionToolConfig {
+    type: "code_execution";
+    includeOutputs?: boolean;
+}
+export interface FileSearchToolConfig {
+    type: "file_search";
+    collectionIds: string[];
+    retrievalMode?: "keyword" | "semantic" | "hybrid";
+    maxNumResults?: number;
+    includeResults?: boolean;
+}
+export type ServerToolConfig = WebSearchToolConfig | XSearchToolConfig | CodeExecutionToolConfig | FileSearchToolConfig;
+export interface McpServer {
+    url: string;
+    label: string;
+    description?: string;
+    allowedTools?: string[];
+}
+export interface ToolApprovalSettings {
+    defaultMode?: ToolApprovalMode;
+    tools?: Record<string, ToolApprovalMode>;
+}
+export interface HooksConfig {
+    "pre-tool"?: string[];
+    "post-tool"?: string[];
+    "session-start"?: string[];
+    "session-end"?: string[];
+    [key: string]: string[] | undefined;
+}
+export interface ToolResult {
+    output: string;
+    error?: boolean;
+}
+export interface SessionMeta {
+    id: string;
+    name: string;
+    model: string;
+    cwd: string;
+    archived?: boolean;
+    created: string;
+    updated: string;
+    turns: number;
+    lastResponseId: string | null;
+}
+export interface SessionEvent {
+    ts: string;
+    type: "meta" | "msg" | "tool_exec";
+    meta?: SessionMeta;
+    role?: "system" | "user" | "assistant" | "tool";
+    content?: string | null;
+    toolCalls?: SerializedToolCall[];
+    toolCallId?: string;
+    toolName?: string;
+    toolArgs?: string;
+    toolOutput?: string;
+    toolError?: boolean;
+    turn?: number;
+}
+export interface SerializedToolCall {
+    id: string;
+    name: string;
+    arguments: string;
+}
+export interface AgentOptions {
+    verbose: boolean;
+    showReasoning: boolean;
+    maxTurns: number;
+    cwd: string;
+    sessionId?: string;
+    sessionName?: string;
+    planMode?: boolean;
+}
+export interface Citation {
+    url: string;
+    title?: string;
+}
+export interface ConfigFile {
+    model?: string;
+    approval_policy?: ApprovalPolicy;
+    sandbox_mode?: SandboxMode;
+    show_reasoning?: boolean;
+    show_usage?: boolean;
+    show_diffs?: boolean;
+    show_citations?: boolean;
+    show_server_tool_usage?: boolean;
+    notify?: boolean;
+    max_turns?: number;
+    management_api_key?: string;
+    management_base_url?: string;
+    mcp_servers?: Record<string, string> | McpServer[];
+    hooks?: HooksConfig;
+    tool_approvals?: ToolApprovalSettings;
+    include_tool_outputs?: boolean;
+    server_tools?: Array<ServerToolKind | ServerToolConfig>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/usage.d.ts

@@ -0,0 +1,17 @@
+export interface UsageStats {
+    inputTokens: number;
+    outputTokens: number;
+    reasoningTokens: number;
+    cachedTokens: number;
+    totalTokens: number;
+}
+export declare function createUsageStats(): UsageStats;
+/** Extract usage from a chat.completions final chunk */
+export declare function extractUsageFromChatChunk(chunk: any, stats: UsageStats): void;
+/** Extract usage from a Responses API response */
+export declare function extractUsageFromResponse(response: any, stats: UsageStats): void;
+/** Accumulate usage across multiple turns */
+export declare function accumulateUsage(total: UsageStats, turn: UsageStats): void;
+export declare function calculateCost(model: string, stats: UsageStats): number;
+export declare function formatUsage(model: string, stats: UsageStats): string;
+//# sourceMappingURL=usage.d.ts.map

package/dist/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CAQ7C;AAED,wDAAwD;AACxD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAQ7E;AAED,kDAAkD;AAClD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAS/E;AAED,6CAA6C;AAC7C,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAMzE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CActE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CAgBpE"}

package/dist/usage.js

@@ -0,0 +1,80 @@
+import chalk from "chalk";
+// Pricing per 1M tokens (input / cached / output)
+const PRICING = {
+    "grok-4.20-0309-reasoning": { input: 2.00, cached: 0.20, output: 6.00 },
+    "grok-4.20-reasoning": { input: 2.00, cached: 0.20, output: 6.00 },
+    "grok-4.20-0309-non-reasoning": { input: 2.00, cached: 0.20, output: 6.00 },
+    "grok-4.20-non-reasoning": { input: 2.00, cached: 0.20, output: 6.00 },
+    "grok-4.20-multi-agent-0309": { input: 2.00, cached: 0.20, output: 6.00 },
+    "grok-4.20-multi-agent": { input: 2.00, cached: 0.20, output: 6.00 },
+    "grok-4-1-fast-reasoning": { input: 0.20, cached: 0.05, output: 0.50 },
+    "grok-4-1-fast-non-reasoning": { input: 0.20, cached: 0.05, output: 0.50 },
+    "grok-code-fast-1": { input: 0.20, cached: 0.05, output: 0.50 },
+};
+export function createUsageStats() {
+    return {
+        inputTokens: 0,
+        outputTokens: 0,
+        reasoningTokens: 0,
+        cachedTokens: 0,
+        totalTokens: 0,
+    };
+}
+/** Extract usage from a chat.completions final chunk */
+export function extractUsageFromChatChunk(chunk, stats) {
+    const usage = chunk?.usage;
+    if (!usage)
+        return;
+    stats.inputTokens = usage.prompt_tokens || 0;
+    stats.outputTokens = usage.completion_tokens || 0;
+    stats.totalTokens = usage.total_tokens || 0;
+    stats.cachedTokens = usage.prompt_tokens_details?.cached_tokens || 0;
+}
+/** Extract usage from a Responses API response */
+export function extractUsageFromResponse(response, stats) {
+    const usage = response?.usage;
+    if (!usage)
+        return;
+    stats.inputTokens = usage.input_tokens || usage.prompt_tokens || 0;
+    stats.outputTokens = usage.output_tokens || usage.completion_tokens || 0;
+    stats.totalTokens = usage.total_tokens || (stats.inputTokens + stats.outputTokens);
+    stats.reasoningTokens = usage.output_tokens_details?.reasoning_tokens || 0;
+    stats.cachedTokens = usage.input_tokens_details?.cached_tokens || usage.prompt_tokens_details?.cached_tokens || 0;
+}
+/** Accumulate usage across multiple turns */
+export function accumulateUsage(total, turn) {
+    total.inputTokens += turn.inputTokens;
+    total.outputTokens += turn.outputTokens;
+    total.reasoningTokens += turn.reasoningTokens;
+    total.cachedTokens += turn.cachedTokens;
+    total.totalTokens += turn.totalTokens;
+}
+export function calculateCost(model, stats) {
+    // Find pricing - try exact match, then prefix match
+    let pricing = PRICING[model];
+    if (!pricing) {
+        const key = Object.keys(PRICING).find(k => model.startsWith(k));
+        pricing = key ? PRICING[key] : PRICING["grok-4-1-fast-reasoning"]; // fallback
+    }
+    const nonCachedInput = stats.inputTokens - stats.cachedTokens;
+    const costInput = (nonCachedInput / 1_000_000) * pricing.input;
+    const costCached = (stats.cachedTokens / 1_000_000) * pricing.cached;
+    const costOutput = (stats.outputTokens / 1_000_000) * pricing.output;
+    return costInput + costCached + costOutput;
+}
+export function formatUsage(model, stats) {
+    const cost = calculateCost(model, stats);
+    const parts = [];
+    parts.push(chalk.dim("Tokens:"));
+    parts.push(chalk.dim(` in=${stats.inputTokens.toLocaleString()}`));
+    if (stats.cachedTokens > 0) {
+        parts.push(chalk.dim(` cached=${stats.cachedTokens.toLocaleString()}`));
+    }
+    parts.push(chalk.dim(` out=${stats.outputTokens.toLocaleString()}`));
+    if (stats.reasoningTokens > 0) {
+        parts.push(chalk.dim(` reasoning=${stats.reasoningTokens.toLocaleString()}`));
+    }
+    parts.push(chalk.dim(` | Cost: $${cost.toFixed(4)}`));
+    return parts.join("");
+}
+//# sourceMappingURL=usage.js.map

package/dist/usage.js.map

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

package/dist/voice-api.d.ts

@@ -0,0 +1,16 @@
+import type { GrokConfig } from "./types.js";
+export declare function listVoices(config: GrokConfig): Promise<any[]>;
+export declare function createRealtimeClientSecret(config: GrokConfig, seconds: number, session?: Record<string, unknown>): Promise<any>;
+export declare function streamTtsToFile(config: GrokConfig, opts: {
+    text: string;
+    voice: string;
+    language: string;
+    codec: string;
+    sampleRate?: number;
+    bitRate?: number;
+    output: string;
+}): Promise<{
+    bytes: number;
+    output: string;
+}>;
+//# sourceMappingURL=voice-api.d.ts.map

package/dist/voice-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-api.d.ts","sourceRoot":"","sources":["../src/voice-api.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,wBAAsB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAOnE;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,GAAG,CAAC,CAgBd;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE;IACJ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,GACA,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAuD5C"}

package/dist/voice-api.js

@@ -0,0 +1,84 @@
+import fs from "node:fs";
+import path from "node:path";
+import { getResponseErrorMessage } from "./cli-errors.js";
+export async function listVoices(config) {
+    const response = await fetch(`${config.baseUrl}/tts/voices`, {
+        headers: { Authorization: `Bearer ${config.apiKey}` },
+    });
+    if (!response.ok)
+        throw new Error(await getResponseErrorMessage("Failed to list voices", response));
+    const data = await response.json();
+    return data.voices || [];
+}
+export async function createRealtimeClientSecret(config, seconds, session) {
+    const response = await fetch(`${config.baseUrl}/realtime/client_secrets`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${config.apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            expires_after: { seconds },
+            ...(session ? { session } : {}),
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(await getResponseErrorMessage("Failed to create realtime client secret", response));
+    }
+    return response.json();
+}
+export async function streamTtsToFile(config, opts) {
+    const url = new URL(config.baseUrl.replace(/^http/, "ws") + "/tts");
+    url.searchParams.set("language", opts.language);
+    url.searchParams.set("voice", opts.voice);
+    url.searchParams.set("codec", opts.codec);
+    if (opts.sampleRate)
+        url.searchParams.set("sample_rate", String(opts.sampleRate));
+    if (opts.bitRate)
+        url.searchParams.set("bit_rate", String(opts.bitRate));
+    const WS = globalThis.WebSocket;
+    if (!WS) {
+        throw new Error("WebSocket is not available in this Node runtime.");
+    }
+    const chunks = [];
+    const outputPath = path.resolve(opts.output);
+    await new Promise((resolve, reject) => {
+        const ws = new WS(url, {
+            headers: {
+                Authorization: `Bearer ${config.apiKey}`,
+            },
+        });
+        ws.onopen = () => {
+            ws.send(JSON.stringify({ type: "text.delta", delta: opts.text }));
+            ws.send(JSON.stringify({ type: "text.done" }));
+        };
+        ws.onmessage = (event) => {
+            try {
+                const data = JSON.parse(String(event.data));
+                if (data.type === "audio.delta" && data.delta) {
+                    chunks.push(Buffer.from(data.delta, "base64"));
+                }
+                else if (data.type === "audio.done") {
+                    resolve();
+                    ws.close();
+                }
+                else if (data.type === "error") {
+                    reject(new Error(data.message || "Streaming TTS failed"));
+                    ws.close();
+                }
+            }
+            catch (err) {
+                reject(err instanceof Error ? err : new Error(String(err)));
+                ws.close();
+            }
+        };
+        ws.onerror = (event) => {
+            reject(new Error(event?.message || "Streaming TTS connection failed"));
+        };
+    });
+    const buffer = Buffer.concat(chunks);
+    fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+    fs.writeFileSync(outputPath, buffer);
+    return { bytes: buffer.length, output: outputPath };
+}
+//# sourceMappingURL=voice-api.js.map

package/dist/voice-api.js.map

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

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "grok-agent",
+  "version": "0.5.0",
+  "description": "A coding assistant CLI powered by xAI's Grok models",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "grok-agent": "./bin/grok-cli.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "tsc -p tsconfig.test.json && node --test dist-tests/tests/*.test.js",
+    "lint": "tsc --noEmit",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "grok",
+    "xai",
+    "cli",
+    "coding-assistant",
+    "agent",
+    "ai",
+    "llm",
+    "developer-tools",
+    "code-generation",
+    "function-calling"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/baba20o/grok-cli.git"
+  },
+  "homepage": "https://github.com/baba20o/grok-cli#readme",
+  "bugs": {
+    "url": "https://github.com/baba20o/grok-cli/issues"
+  },
+  "author": "baba20o",
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "dotenv": "^16.5.0",
+    "fast-glob": "^3.3.3",
+    "openai": "^4.86.0",
+    "ora": "^8.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.12.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "license": "Apache-2.0"
+}