grok-dev 1.0.0-rc1

package/dist/tools/bash.d.ts

@@ -0,0 +1,27 @@
+import { type ChildProcess } from "child_process";
+import type { ToolResult } from "../types/index";
+export interface BackgroundProcess {
+    id: number;
+    command: string;
+    pid: number;
+    cwd: string;
+    startedAt: Date;
+    child: ChildProcess;
+    logPath: string;
+    alive: boolean;
+    exitCode: number | null;
+}
+export declare class BashTool {
+    private cwd;
+    private bgProcesses;
+    private tmpDir;
+    constructor(initialCwd?: string);
+    private ensureTmpDir;
+    execute(command: string, timeout?: number): Promise<ToolResult>;
+    startBackground(command: string): Promise<ToolResult>;
+    getProcessLogs(id: number, tail?: number): Promise<ToolResult>;
+    stopProcess(id: number): Promise<ToolResult>;
+    listProcesses(): ToolResult;
+    cleanup(): Promise<void>;
+    getCwd(): string;
+}

package/dist/tools/bash.js

@@ -0,0 +1,261 @@
+import { exec, spawn } from "child_process";
+import { createReadStream, createWriteStream } from "fs";
+import { mkdtemp, rm, stat, unlink } from "fs/promises";
+import os from "os";
+import path from "path";
+import { promisify } from "util";
+const execAsync = promisify(exec);
+const MAX_TAIL_BYTES = 8_192;
+const MAX_BACKGROUND_PROCESSES = 8;
+let nextBgId = 1;
+export class BashTool {
+    cwd;
+    bgProcesses = new Map();
+    tmpDir = null;
+    constructor(initialCwd = process.cwd()) {
+        this.cwd = initialCwd;
+    }
+    async ensureTmpDir() {
+        if (!this.tmpDir) {
+            this.tmpDir = await mkdtemp(path.join(os.tmpdir(), "grok-bg-"));
+        }
+        return this.tmpDir;
+    }
+    async execute(command, timeout = 30_000) {
+        try {
+            if (command.startsWith("cd ")) {
+                const dir = command
+                    .substring(3)
+                    .trim()
+                    .replace(/^["']|["']$/g, "");
+                try {
+                    const nextCwd = path.resolve(this.cwd, dir);
+                    const info = await stat(nextCwd);
+                    if (!info.isDirectory()) {
+                        return { success: false, error: `Cannot change directory: ${nextCwd} is not a directory` };
+                    }
+                    this.cwd = nextCwd;
+                    return { success: true, output: `Changed directory to: ${this.cwd}` };
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    return { success: false, error: `Cannot change directory: ${msg}` };
+                }
+            }
+            const { stdout, stderr } = await execAsync(command, {
+                cwd: this.cwd,
+                timeout,
+                maxBuffer: 10 * 1024 * 1024,
+                env: { ...process.env, FORCE_COLOR: "0" },
+            });
+            const output = stdout + (stderr ? `\nSTDERR: ${stderr}` : "");
+            return {
+                success: true,
+                output: output.trim() || "Command executed successfully (no output)",
+            };
+        }
+        catch (err) {
+            if (err && typeof err === "object" && "stdout" in err) {
+                const execErr = err;
+                const output = (execErr.stdout || "") + (execErr.stderr ? `\nSTDERR: ${execErr.stderr}` : "");
+                if (output.trim()) {
+                    return { success: false, error: output.trim() };
+                }
+            }
+            const msg = err instanceof Error ? err.message : String(err);
+            return { success: false, error: `Command failed: ${msg}` };
+        }
+    }
+    async startBackground(command) {
+        const alive = [...this.bgProcesses.values()].filter((p) => p.alive);
+        if (alive.length >= MAX_BACKGROUND_PROCESSES) {
+            return {
+                success: false,
+                output: `Too many background processes (${alive.length}/${MAX_BACKGROUND_PROCESSES}). Stop one first with process_stop.`,
+            };
+        }
+        try {
+            const tmpDir = await this.ensureTmpDir();
+            const id = nextBgId++;
+            const logPath = path.join(tmpDir, `bg-${id}.log`);
+            const logStream = createWriteStream(logPath, { flags: "a" });
+            const child = spawn("sh", ["-c", command], {
+                cwd: this.cwd,
+                detached: false,
+                stdio: ["ignore", "pipe", "pipe"],
+                env: { ...process.env, FORCE_COLOR: "0" },
+            });
+            child.stdout?.pipe(logStream);
+            child.stderr?.pipe(logStream);
+            const entry = {
+                id,
+                command,
+                pid: child.pid ?? 0,
+                cwd: this.cwd,
+                startedAt: new Date(),
+                child,
+                logPath,
+                alive: true,
+                exitCode: null,
+            };
+            child.on("exit", (code) => {
+                entry.alive = false;
+                entry.exitCode = code;
+                logStream.end();
+            });
+            child.on("error", () => {
+                entry.alive = false;
+                logStream.end();
+            });
+            this.bgProcesses.set(id, entry);
+            return {
+                success: true,
+                output: [
+                    `Background process started (id: ${id}, pid: ${entry.pid})`,
+                    `Command: ${truncCmd(command, 80)}`,
+                    `Use process_logs(${id}) to view output, process_stop(${id}) to terminate.`,
+                ].join("\n"),
+                backgroundProcess: { id, pid: entry.pid, command },
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { success: false, output: `Failed to start background process: ${msg}` };
+        }
+    }
+    async getProcessLogs(id, tail = 50) {
+        const entry = this.bgProcesses.get(id);
+        if (!entry) {
+            return { success: false, output: `No background process with id ${id}.` };
+        }
+        try {
+            const stats = await stat(entry.logPath);
+            const start = Math.max(0, stats.size - MAX_TAIL_BYTES);
+            const content = await new Promise((resolve, reject) => {
+                const chunks = [];
+                const stream = createReadStream(entry.logPath, { start });
+                stream.on("data", (chunk) => {
+                    chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+                });
+                stream.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
+                stream.on("error", reject);
+            });
+            const lines = content.split("\n");
+            const tailed = lines.slice(-tail).join("\n").trimEnd();
+            const status = entry.alive ? "running" : `exited (code ${entry.exitCode ?? "unknown"})`;
+            return {
+                success: true,
+                output: [
+                    `[Process ${id} — ${status} — pid ${entry.pid}]`,
+                    `[${truncCmd(entry.command, 70)}]`,
+                    "",
+                    tailed || "(no output yet)",
+                ].join("\n"),
+            };
+        }
+        catch {
+            return {
+                success: true,
+                output: `[Process ${id} — ${entry.alive ? "running" : "exited"}] (no output yet)`,
+            };
+        }
+    }
+    async stopProcess(id) {
+        const entry = this.bgProcesses.get(id);
+        if (!entry) {
+            return { success: false, output: `No background process with id ${id}.` };
+        }
+        if (!entry.alive) {
+            return {
+                success: true,
+                output: `Process ${id} already exited (code ${entry.exitCode ?? "unknown"}).`,
+            };
+        }
+        try {
+            entry.child.kill("SIGTERM");
+            await new Promise((resolve) => {
+                const timeout = setTimeout(() => {
+                    try {
+                        entry.child.kill("SIGKILL");
+                    }
+                    catch {
+                        /* already dead */
+                    }
+                    resolve();
+                }, 3_000);
+                entry.child.on("exit", () => {
+                    clearTimeout(timeout);
+                    resolve();
+                });
+            });
+            return {
+                success: true,
+                output: `Process ${id} (pid ${entry.pid}) stopped.`,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { success: false, output: `Failed to stop process ${id}: ${msg}` };
+        }
+    }
+    listProcesses() {
+        const entries = [...this.bgProcesses.values()];
+        if (entries.length === 0) {
+            return { success: true, output: "No background processes." };
+        }
+        const lines = entries.map((entry) => {
+            const status = entry.alive ? "running" : `exited(${entry.exitCode ?? "?"})`;
+            const age = formatAge(entry.startedAt);
+            return `${entry.id}  ${status}  pid:${entry.pid}  ${age}  ${truncCmd(entry.command, 50)}`;
+        });
+        return {
+            success: true,
+            output: ["ID  STATUS       PID    AGE     COMMAND", ...lines].join("\n"),
+        };
+    }
+    async cleanup() {
+        for (const entry of this.bgProcesses.values()) {
+            if (entry.alive) {
+                try {
+                    entry.child.kill("SIGTERM");
+                }
+                catch {
+                    /* */
+                }
+            }
+            try {
+                await unlink(entry.logPath);
+            }
+            catch {
+                /* */
+            }
+        }
+        this.bgProcesses.clear();
+        if (this.tmpDir) {
+            try {
+                await rm(this.tmpDir, { recursive: true, force: true });
+            }
+            catch {
+                /* */
+            }
+        }
+    }
+    getCwd() {
+        return this.cwd;
+    }
+}
+function truncCmd(cmd, max) {
+    const oneLine = cmd.replace(/\n/g, " ").trim();
+    return oneLine.length <= max ? oneLine : `${oneLine.slice(0, max - 1)}…`;
+}
+function formatAge(start) {
+    const sec = Math.round((Date.now() - start.getTime()) / 1000);
+    if (sec < 60)
+        return `${sec}s`;
+    const min = Math.floor(sec / 60);
+    if (min < 60)
+        return `${min}m${sec % 60}s`;
+    const hr = Math.floor(min / 60);
+    return `${hr}h${min % 60}m`;
+}
+//# sourceMappingURL=bash.js.map

package/dist/tools/bash.js.map

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

package/dist/tools/file.d.ts

@@ -0,0 +1,15 @@
+export interface FileDiff {
+    filePath: string;
+    additions: number;
+    removals: number;
+    patch: string;
+    isNew: boolean;
+}
+export interface FileResult {
+    success: boolean;
+    output: string;
+    diff?: FileDiff;
+}
+export declare function readFile(filePath: string, cwd: string, startLine?: number, endLine?: number): FileResult;
+export declare function writeFile(filePath: string, content: string, cwd: string): FileResult;
+export declare function editFile(filePath: string, oldString: string, newString: string, cwd: string): FileResult;

package/dist/tools/file.js

@@ -0,0 +1,94 @@
+import { createTwoFilesPatch } from "diff";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { dirname, isAbsolute, resolve } from "path";
+function resolvePath(filePath, cwd) {
+    return isAbsolute(filePath) ? filePath : resolve(cwd, filePath);
+}
+function computeDiff(filePath, before, after) {
+    const patch = createTwoFilesPatch(filePath, filePath, before, after, "", "", {
+        context: 3,
+    });
+    let additions = 0;
+    let removals = 0;
+    for (const line of patch.split("\n")) {
+        if (line.startsWith("+") && !line.startsWith("+++"))
+            additions++;
+        if (line.startsWith("-") && !line.startsWith("---"))
+            removals++;
+    }
+    return { filePath, additions, removals, patch, isNew: before === "" };
+}
+export function readFile(filePath, cwd, startLine, endLine) {
+    try {
+        const full = resolvePath(filePath, cwd);
+        if (!existsSync(full)) {
+            return { success: false, output: `File not found: ${filePath}` };
+        }
+        const content = readFileSync(full, "utf-8");
+        const lines = content.split("\n");
+        const totalLines = lines.length;
+        const start = Math.max(0, (startLine ?? 1) - 1);
+        const end = Math.min(totalLines, endLine ?? totalLines);
+        const slice = lines.slice(start, end);
+        const numbered = slice.map((line, i) => `${start + i + 1} | ${line}`).join("\n");
+        const header = `[${filePath}: lines ${start + 1}-${end} of ${totalLines}]`;
+        return { success: true, output: `${header}\n${numbered}` };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { success: false, output: `Failed to read file: ${msg}` };
+    }
+}
+export function writeFile(filePath, content, cwd) {
+    try {
+        const full = resolvePath(filePath, cwd);
+        const before = existsSync(full) ? readFileSync(full, "utf-8") : "";
+        const dir = dirname(full);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(full, content, "utf-8");
+        const diff = computeDiff(filePath, before, content);
+        const verb = before === "" ? "Created" : "Updated";
+        return {
+            success: true,
+            output: `${verb} ${filePath} (+${diff.additions} -${diff.removals})`,
+            diff,
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { success: false, output: `Failed to write file: ${msg}` };
+    }
+}
+export function editFile(filePath, oldString, newString, cwd) {
+    try {
+        const full = resolvePath(filePath, cwd);
+        if (!existsSync(full)) {
+            return { success: false, output: `File not found: ${filePath}` };
+        }
+        const before = readFileSync(full, "utf-8");
+        const count = before.split(oldString).length - 1;
+        if (count === 0) {
+            return { success: false, output: `old_string not found in ${filePath}` };
+        }
+        if (count > 1) {
+            return {
+                success: false,
+                output: `old_string is not unique in ${filePath} (${count} occurrences). Include more surrounding context to make it unique.`,
+            };
+        }
+        const after = before.replace(oldString, newString);
+        writeFileSync(full, after, "utf-8");
+        const diff = computeDiff(filePath, before, after);
+        return {
+            success: true,
+            output: `Edited ${filePath} (+${diff.additions} -${diff.removals})`,
+            diff,
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { success: false, output: `Failed to edit file: ${msg}` };
+    }
+}
+//# sourceMappingURL=file.js.map

package/dist/tools/file.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,151 @@
+import type { ModelMessage } from "ai";
+export interface FileDiff {
+    filePath: string;
+    additions: number;
+    removals: number;
+    patch: string;
+    isNew: boolean;
+}
+export interface PlanStep {
+    title: string;
+    description: string;
+    filePaths?: string[];
+}
+export interface PlanQuestion {
+    id: string;
+    question: string;
+    header?: string;
+    type: "select" | "multiselect" | "text";
+    options?: {
+        id: string;
+        label: string;
+    }[];
+}
+export interface Plan {
+    title: string;
+    summary: string;
+    steps: PlanStep[];
+    questions?: PlanQuestion[];
+}
+export interface TaskRequest {
+    agent: "general" | "explore";
+    description: string;
+    prompt: string;
+}
+export interface TaskRun {
+    agent: "general" | "explore";
+    description: string;
+    summary: string;
+    activity?: string;
+}
+export type DelegationStatus = "running" | "complete" | "error";
+export interface DelegationRun {
+    id: string;
+    agent: "explore";
+    description: string;
+    summary: string;
+    status: DelegationStatus;
+}
+export interface SubagentStatus {
+    agent: "general" | "explore";
+    description: string;
+    detail: string;
+}
+export interface BackgroundProcessInfo {
+    id: number;
+    pid: number;
+    command: string;
+}
+export interface ToolResult {
+    success: boolean;
+    output?: string;
+    error?: string;
+    diff?: FileDiff;
+    plan?: Plan;
+    task?: TaskRun;
+    delegation?: DelegationRun;
+    backgroundProcess?: BackgroundProcessInfo;
+}
+export interface ToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface ChatEntry {
+    type: "user" | "assistant" | "tool_call" | "tool_result";
+    content: string;
+    timestamp: Date;
+    modeColor?: string;
+    remoteKey?: string;
+    sourceLabel?: string;
+    queued?: boolean;
+    toolCalls?: ToolCall[];
+    toolCall?: ToolCall;
+    toolResult?: ToolResult;
+}
+export interface StreamChunk {
+    type: "content" | "tool_calls" | "tool_result" | "done" | "error" | "reasoning";
+    content?: string;
+    toolCalls?: ToolCall[];
+    toolCall?: ToolCall;
+    toolResult?: ToolResult;
+}
+export interface ModelInfo {
+    id: string;
+    name: string;
+    contextWindow: number;
+    inputPrice: number;
+    outputPrice: number;
+    reasoning: boolean;
+    description: string;
+}
+export type AgentMode = "agent" | "plan" | "ask";
+export type SessionStatus = "active" | "archived";
+export type UsageSource = "message" | "title" | "task" | "delegation" | "other";
+export interface WorkspaceInfo {
+    id: string;
+    scopeKey: string;
+    canonicalPath: string;
+    gitRoot: string | null;
+    displayName: string;
+    lastSeenAt: Date;
+}
+export interface SessionInfo {
+    id: string;
+    workspaceId: string;
+    title: string | null;
+    model: string;
+    mode: AgentMode;
+    cwdAtStart: string;
+    cwdLast: string;
+    status: SessionStatus;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface UsageEvent {
+    id: number;
+    sessionId: string;
+    messageSeq: number | null;
+    source: UsageSource;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    costMicros: number;
+    createdAt: Date;
+}
+export interface SessionSnapshot {
+    workspace: WorkspaceInfo;
+    session: SessionInfo;
+    messages: ModelMessage[];
+    entries: ChatEntry[];
+    totalTokens: number;
+}
+export declare const MODES: {
+    id: AgentMode;
+    label: string;
+    color: string;
+}[];

package/dist/types/index.js

@@ -0,0 +1,6 @@
+export const MODES = [
+    { id: "agent", label: "Agent", color: "#5c9cf5" },
+    { id: "plan", label: "Plan", color: "#e5c07b" },
+    { id: "ask", label: "Ask", color: "#22c55e" },
+];
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAoKA,MAAM,CAAC,MAAM,KAAK,GAAsD;IACtE,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE;IACjD,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE;IAC/C,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE;CAC9C,CAAC"}

package/dist/ui/app.d.ts

@@ -0,0 +1,15 @@
+import { Agent } from "../agent/agent";
+export interface AppStartupConfig {
+    apiKey: string | undefined;
+    baseURL: string;
+    model: string;
+    maxToolRounds: number;
+}
+interface AppProps {
+    agent: Agent;
+    startupConfig: AppStartupConfig;
+    initialMessage?: string;
+    onExit?: () => void;
+}
+export declare function App({ agent, startupConfig, initialMessage, onExit }: AppProps): import("react").ReactNode;
+export {};