@edwardlee5423/magi 0.1.0-alpha.0

package/dist/tools/worktree.js

@@ -0,0 +1,150 @@
+/**
+ * Worktree isolation tools: EnterWorktree and ExitWorktree.
+ *
+ * EnterWorktree creates a temporary git worktree so the agent works on
+ * an isolated copy of the repository. ExitWorktree cleans up or keeps
+ * the worktree based on user preference.
+ */
+import { existsSync, mkdirSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+export const EnterWorktreeInputSchema = {
+    type: "object",
+    properties: {
+        name: { type: "string", description: "Optional name for the worktree. Random if omitted." }
+    },
+    required: [],
+    additionalProperties: false
+};
+export const ExitWorktreeInputSchema = {
+    type: "object",
+    properties: {
+        action: { type: "string", enum: ["keep", "remove"], description: "keep leaves worktree on disk; remove deletes it." },
+        discard_changes: { type: "boolean", description: "Required true to remove a worktree with uncommitted changes." }
+    },
+    required: ["action"],
+    additionalProperties: false
+};
+// --- Parsing ---
+export function parseEnterWorktreeInput(input) {
+    return {
+        name: typeof input.name === "string" ? input.name.trim() || undefined : undefined
+    };
+}
+export function parseExitWorktreeInput(input) {
+    const action = input.action;
+    if (action !== "keep" && action !== "remove") {
+        throw new Error("ExitWorktree action must be 'keep' or 'remove'");
+    }
+    return {
+        action,
+        discardChanges: typeof input.discard_changes === "boolean" ? input.discard_changes : undefined
+    };
+}
+// --- Execution ---
+export function executeEnterWorktree(input) {
+    // Verify we're in a git repo
+    const check = spawnSync("git", ["rev-parse", "--git-dir"], {
+        cwd: input.cwd,
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"]
+    });
+    if (check.status !== 0) {
+        throw new Error("Not a git repository. Worktree isolation requires git.");
+    }
+    const worktreeBase = path.join(input.cwd, ".magi", "worktrees");
+    mkdirSync(worktreeBase, { recursive: true });
+    const name = sanitizeWorktreeName(input.name) || `magi-${randomUUID().slice(0, 8)}`;
+    const branchName = `magi/worktree/${name}`;
+    const worktreePath = path.join(worktreeBase, name);
+    if (existsSync(worktreePath)) {
+        throw new Error(`Worktree already exists at ${worktreePath}`);
+    }
+    // Create worktree with new branch based on HEAD
+    const result = spawnSync("git", ["worktree", "add", "-b", branchName, worktreePath], {
+        cwd: input.cwd,
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"]
+    });
+    if (result.status !== 0) {
+        const err = result.stderr?.trim() || "git worktree add failed";
+        throw new Error(err);
+    }
+    return {
+        active: true,
+        originalCwd: input.cwd,
+        worktreePath,
+        branchName,
+        createdAt: new Date().toISOString()
+    };
+}
+export function executeExitWorktree(input) {
+    if (!input.state.active || !input.state.worktreePath) {
+        return { removed: false };
+    }
+    if (input.action === "keep") {
+        return {
+            removed: false,
+            worktreePath: input.state.worktreePath,
+            branchName: input.state.branchName
+        };
+    }
+    // Check for uncommitted changes
+    if (!input.discardChanges) {
+        const status = spawnSync("git", ["status", "--porcelain"], {
+            cwd: input.state.worktreePath,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"]
+        });
+        if (status.stdout?.trim()) {
+            throw new Error(`Worktree has uncommitted changes. Set discard_changes: true to force removal.\n` +
+                `Changes:\n${status.stdout.trim()}`);
+        }
+    }
+    // Remove worktree
+    const remove = spawnSync("git", ["worktree", "remove", "--force", input.state.worktreePath], {
+        cwd: input.state.originalCwd ?? input.cwd,
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"]
+    });
+    // Delete branch if worktree was removed
+    if (remove.status === 0 && input.state.branchName) {
+        spawnSync("git", ["branch", "-D", input.state.branchName], {
+            cwd: input.state.originalCwd ?? input.cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"]
+        });
+    }
+    return { removed: remove.status === 0 };
+}
+// --- Formatting ---
+export function formatEnterWorktreeResult(state) {
+    return [
+        `Worktree created.`,
+        `  path: ${state.worktreePath}`,
+        `  branch: ${state.branchName}`,
+        ``,
+        `Agent execution is now isolated. Changes here do not affect the main working tree.`,
+        `Call ExitWorktree when done.`
+    ].join("\n");
+}
+export function formatExitWorktreeResult(result) {
+    if (result.removed) {
+        return "Worktree removed. Returned to original working directory.";
+    }
+    return [
+        "Worktree kept on disk.",
+        result.worktreePath ? `  path: ${result.worktreePath}` : "",
+        result.branchName ? `  branch: ${result.branchName}` : ""
+    ].filter(Boolean).join("\n");
+}
+// --- Helpers ---
+function sanitizeWorktreeName(name) {
+    if (!name)
+        return undefined;
+    // Only allow letters, digits, dots, underscores, dashes, slashes
+    const sanitized = name.replace(/[^a-zA-Z0-9._\-/]/g, "-").slice(0, 64);
+    return sanitized || undefined;
+}
+//# sourceMappingURL=worktree.js.map

package/dist/tools/worktree.js.map

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

package/dist/tui/interactions.d.ts

@@ -0,0 +1,25 @@
+/**
+ * TUI interaction handlers — approval prompts, question prompts, and
+ * dispatch for pending audit events that need user input.
+ *
+ * The functions here are async I/O glue: they read from a readline-shaped
+ * `rl.question(...)` input and write prompts to a Writable. They convert
+ * pending events from the audit log into resolutions on the
+ * ActiveInteractionRegistry.
+ */
+import { Interface as ReadlinePromisesInterface } from "node:readline/promises";
+import { Writable } from "node:stream";
+import { MagiEventView } from "../events.js";
+import { ActiveInteractionRegistry } from "../interactions.js";
+import { UserQuestionResolver } from "../tools/user-question.js";
+export declare function createTerminalUserQuestionResolver(rl: Pick<ReadlinePromisesInterface, "question">, terminalOutput: Pick<Writable, "write">, signal?: AbortSignal): UserQuestionResolver;
+export declare function handleTuiPendingInteraction(input: {
+    event: MagiEventView;
+    interactions: ActiveInteractionRegistry;
+    rl: Pick<ReadlinePromisesInterface, "question">;
+    output: Pick<Writable, "write">;
+    handled: Set<string>;
+    signal?: AbortSignal;
+}): Promise<void>;
+export declare function colorizeDiffLine(line: string): string;
+export declare function parseTuiInteractionTimeoutMs(raw: string | undefined): number | undefined;

package/dist/tui/interactions.js

@@ -0,0 +1,232 @@
+/**
+ * TUI interaction handlers — approval prompts, question prompts, and
+ * dispatch for pending audit events that need user input.
+ *
+ * The functions here are async I/O glue: they read from a readline-shaped
+ * `rl.question(...)` input and write prompts to a Writable. They convert
+ * pending events from the audit log into resolutions on the
+ * ActiveInteractionRegistry.
+ */
+import { addPermissionRule, isToolAlwaysAllowed } from "../permissions.js";
+import { formatAskUserQuestionForTerminal, normalizeAskUserQuestionAnswer, parseAskUserQuestionSelection } from "../tools/user-question.js";
+export function createTerminalUserQuestionResolver(rl, terminalOutput, signal) {
+    return async ({ question }) => {
+        const answers = [];
+        for (let index = 0; index < question.questions.length; index += 1) {
+            const item = question.questions[index];
+            while (true) {
+                terminalOutput.write(`${formatAskUserQuestionForTerminal(question, index)}\n`);
+                const raw = await askReadlineQuestion(rl, "? ", signal);
+                try {
+                    const selectedOptions = parseAskUserQuestionSelection(raw, item);
+                    answers.push({
+                        question: item.question,
+                        selectedLabels: selectedOptions.map((option) => option.label),
+                        selectedOptions
+                    });
+                    break;
+                }
+                catch (error) {
+                    terminalOutput.write(`${error instanceof Error ? error.message : String(error)}\n`);
+                }
+            }
+        }
+        return { answers };
+    };
+}
+export async function handleTuiPendingInteraction(input) {
+    if (input.event.status !== "pending") {
+        return;
+    }
+    const kind = readString(input.event.metadata.interactionKind);
+    const toolUseId = readString(input.event.metadata.toolUseId);
+    if (!input.event.jobId || !toolUseId || (kind !== "approval" && kind !== "question")) {
+        return;
+    }
+    const key = `${input.event.jobId}\0${kind}\0${toolUseId}`;
+    if (input.handled.has(key)) {
+        return;
+    }
+    input.handled.add(key);
+    try {
+        if (kind === "approval") {
+            const toolName = input.event.target ?? "unknown";
+            // Check persistent permission rules
+            if (isToolAlwaysAllowed(toolName)) {
+                input.interactions.resolveApproval({
+                    jobId: input.event.jobId,
+                    toolUseId,
+                    approved: true
+                });
+                return;
+            }
+            const approved = await askTerminalApproval({
+                event: input.event,
+                rl: input.rl,
+                output: input.output,
+                signal: input.signal
+            });
+            input.interactions.resolveApproval({
+                jobId: input.event.jobId,
+                toolUseId,
+                approved
+            });
+            return;
+        }
+        const question = readQuestionMetadata(input.event.metadata.question);
+        if (!question) {
+            input.output.write("[question] pending event is missing question metadata; waiting for external control response\n");
+            return;
+        }
+        const answer = await askTerminalQuestion({
+            question,
+            rl: input.rl,
+            output: input.output,
+            signal: input.signal
+        });
+        input.interactions.resolveQuestion({
+            jobId: input.event.jobId,
+            toolUseId,
+            answer
+        });
+    }
+    catch (error) {
+        if (isAbortError(error) || input.signal?.aborted) {
+            try {
+                input.interactions.cancelInteraction({
+                    jobId: input.event.jobId,
+                    toolUseId,
+                    reason: "request aborted"
+                });
+            }
+            catch {
+                // The interaction may already have been resolved by another control path.
+            }
+            return;
+        }
+        input.output.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    }
+}
+async function askTerminalApproval(input) {
+    const toolUseId = readString(input.event.metadata.toolUseId) ?? "unknown";
+    const toolName = input.event.target ?? "unknown";
+    const reason = readString(input.event.metadata.reason);
+    const diff = readString(input.event.metadata.diff);
+    const lines = [
+        "Approval required",
+        `tool: ${toolName}`,
+        `toolUseId: ${toolUseId}`,
+        reason ? `reason: ${reason}` : undefined
+    ].filter((line) => Boolean(line));
+    if (diff) {
+        lines.push("", "Diff preview:");
+        lines.push(...diff.split("\n").slice(0, 80).map((line) => colorizeDiffLine(line)));
+        if (diff.split("\n").length > 80) {
+            lines.push(`\x1b[90m... ${diff.split("\n").length - 80} more lines\x1b[39m`);
+        }
+    }
+    lines.push("", "Choose: [y]es / [n]o / [a]lways allow this tool");
+    input.output.write(lines.join("\n") + "\n");
+    while (true) {
+        const raw = (await askReadlineQuestion(input.rl, "approve? [y/n/a] ", input.signal)).trim().toLowerCase();
+        if (raw === "y" || raw === "yes" || raw === "approve" || raw === "approved" || raw === "allow") {
+            return true;
+        }
+        if (raw === "n" || raw === "no" || raw === "deny" || raw === "denied" || raw === "reject") {
+            return false;
+        }
+        if (raw === "a" || raw === "always") {
+            addPermissionRule(toolName, `Always allow ${toolName}`);
+            input.output.write(`\x1b[32m✓ Added persistent rule: always allow "${toolName}"\x1b[39m\n`);
+            return true;
+        }
+        input.output.write("Enter y/yes, n/no, or a/always.\n");
+    }
+}
+export function colorizeDiffLine(line) {
+    if (line.startsWith("---") || line.startsWith("+++")) {
+        return `\x1b[36m${line}\x1b[39m`; // cyan
+    }
+    if (line.startsWith("@@")) {
+        return `\x1b[90m${line}\x1b[39m`; // gray
+    }
+    if (line.startsWith("+")) {
+        return `\x1b[32m${line}\x1b[39m`; // green
+    }
+    if (line.startsWith("-")) {
+        return `\x1b[31m${line}\x1b[39m`; // red
+    }
+    return line;
+}
+async function askTerminalQuestion(input) {
+    const resolver = createTerminalUserQuestionResolver(input.rl, input.output, input.signal);
+    return normalizeAskUserQuestionAnswer(input.question, await resolver({
+        toolUse: {
+            type: "tool-use",
+            id: "AskUserQuestion",
+            name: "AskUserQuestion",
+            input: {}
+        },
+        question: input.question
+    }));
+}
+async function askReadlineQuestion(rl, query, signal) {
+    if (signal) {
+        return rl.question(query, { signal });
+    }
+    return rl.question(query);
+}
+function isAbortError(error) {
+    return error instanceof DOMException && error.name === "AbortError"
+        || error instanceof Error && error.name === "AbortError";
+}
+function readQuestionMetadata(value) {
+    if (!isRecord(value) || !Array.isArray(value.questions)) {
+        return undefined;
+    }
+    const questions = value.questions.map((rawQuestion) => {
+        if (!isRecord(rawQuestion) || typeof rawQuestion.question !== "string" || !Array.isArray(rawQuestion.options)) {
+            return undefined;
+        }
+        const options = rawQuestion.options.map((rawOption) => {
+            if (!isRecord(rawOption) || typeof rawOption.label !== "string" || typeof rawOption.description !== "string") {
+                return undefined;
+            }
+            return {
+                label: rawOption.label,
+                description: rawOption.description,
+                preview: typeof rawOption.preview === "string" ? rawOption.preview : undefined
+            };
+        });
+        if (options.some((option) => option === undefined)) {
+            return undefined;
+        }
+        return {
+            question: rawQuestion.question,
+            header: typeof rawQuestion.header === "string" ? rawQuestion.header : undefined,
+            options: options,
+            multiSelect: typeof rawQuestion.multiSelect === "boolean" ? rawQuestion.multiSelect : undefined
+        };
+    });
+    if (questions.some((question) => question === undefined)) {
+        return undefined;
+    }
+    return { questions: questions };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+export function parseTuiInteractionTimeoutMs(raw) {
+    if (!raw) {
+        return undefined;
+    }
+    if (!/^\d+$/.test(raw)) {
+        return undefined;
+    }
+    const value = Number(raw);
+    return Number.isInteger(value) && value > 0 ? value : undefined;
+}
+//# sourceMappingURL=interactions.js.map

package/dist/tui/interactions.js.map

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

package/dist/tui/multiline-input.d.ts

@@ -0,0 +1,14 @@
+export interface MultilineInputOptions {
+    input: NodeJS.ReadStream;
+    output: NodeJS.WriteStream;
+    prompt: string;
+    history?: string[];
+    maxVisibleRows?: number;
+}
+/**
+ * Small raw-mode editor for the main TUI prompt.
+ *
+ * Enter submits. Alt+Enter, Esc then Enter, or Ctrl+J inserts a newline.
+ * This keeps normal command entry fast while allowing real multi-line prompts.
+ */
+export declare function readMultilineInput(opts: MultilineInputOptions): Promise<string>;