@edwardlee5423/magi 0.1.0-alpha.0

package/dist/tools/notebook.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Notebook tools: NotebookEdit and NotebookRead.
+ * Jupyter notebook (.ipynb) cell manipulation and inspection.
+ */
+export declare const NotebookReadInputSchema: {
+    type: string;
+    properties: {
+        notebook_path: {
+            type: string;
+            description: string;
+        };
+        max_cells: {
+            type: string;
+            description: string;
+        };
+    };
+    required: string[];
+    additionalProperties: boolean;
+};
+export declare const NotebookEditInputSchema: {
+    type: string;
+    properties: {
+        notebook_path: {
+            type: string;
+            description: string;
+        };
+        cell_number: {
+            type: string;
+            description: string;
+        };
+        new_source: {
+            type: string;
+            description: string;
+        };
+        cell_type: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        edit_mode: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+    };
+    required: string[];
+    additionalProperties: boolean;
+};
+export interface NotebookEditInput {
+    notebookPath: string;
+    cellNumber?: number;
+    newSource: string;
+    cellType?: "code" | "markdown";
+    editMode: "replace" | "insert" | "delete";
+}
+export declare function parseNotebookEditInput(input: Record<string, unknown>): NotebookEditInput;
+export declare function executeNotebookEdit(cwd: string, input: NotebookEditInput): string;
+export interface NotebookReadInput {
+    notebookPath: string;
+    maxCells?: number;
+}
+export declare function parseNotebookReadInput(input: Record<string, unknown>): NotebookReadInput;
+export declare function executeNotebookRead(cwd: string, input: NotebookReadInput): string;

package/dist/tools/notebook.js

@@ -0,0 +1,158 @@
+/**
+ * Notebook tools: NotebookEdit and NotebookRead.
+ * Jupyter notebook (.ipynb) cell manipulation and inspection.
+ */
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { resolveWorkspacePath } from "./workspace.js";
+export const NotebookReadInputSchema = {
+    type: "object",
+    properties: {
+        notebook_path: { type: "string", description: "Absolute path to the .ipynb file" },
+        max_cells: { type: "number", description: "Max cells to display (default all)" }
+    },
+    required: ["notebook_path"],
+    additionalProperties: false
+};
+export const NotebookEditInputSchema = {
+    type: "object",
+    properties: {
+        notebook_path: { type: "string", description: "Absolute path to the .ipynb file" },
+        cell_number: { type: "number", description: "0-indexed cell number to edit" },
+        new_source: { type: "string", description: "New source content for the cell" },
+        cell_type: { type: "string", enum: ["code", "markdown"], description: "Cell type (required for insert)" },
+        edit_mode: { type: "string", enum: ["replace", "insert", "delete"], description: "Edit mode (default: replace)" }
+    },
+    required: ["notebook_path", "new_source"],
+    additionalProperties: false
+};
+export function parseNotebookEditInput(input) {
+    const notebookPath = input.notebook_path;
+    if (typeof notebookPath !== "string" || !notebookPath.trim()) {
+        throw new Error("notebook_path is required");
+    }
+    const newSource = input.new_source;
+    if (typeof newSource !== "string") {
+        throw new Error("new_source is required");
+    }
+    let editMode = "replace";
+    if (input.edit_mode !== undefined) {
+        if (input.edit_mode !== "replace" && input.edit_mode !== "insert" && input.edit_mode !== "delete") {
+            throw new Error("edit_mode must be replace, insert, or delete");
+        }
+        editMode = input.edit_mode;
+    }
+    let cellType;
+    if (input.cell_type !== undefined) {
+        if (input.cell_type !== "code" && input.cell_type !== "markdown") {
+            throw new Error("cell_type must be code or markdown");
+        }
+        cellType = input.cell_type;
+    }
+    return {
+        notebookPath: notebookPath.trim(),
+        cellNumber: typeof input.cell_number === "number" ? input.cell_number : undefined,
+        newSource,
+        cellType,
+        editMode
+    };
+}
+export function executeNotebookEdit(cwd, input) {
+    const resolved = resolveWorkspacePath(cwd, input.notebookPath);
+    if (!existsSync(resolved.absolutePath)) {
+        throw new Error(`Notebook not found: ${resolved.relativePath}`);
+    }
+    if (!resolved.absolutePath.endsWith(".ipynb")) {
+        throw new Error("File must be a .ipynb notebook");
+    }
+    const raw = readFileSync(resolved.absolutePath, "utf8");
+    const notebook = JSON.parse(raw);
+    if (!notebook.cells || !Array.isArray(notebook.cells)) {
+        throw new Error("Invalid notebook format: missing cells array");
+    }
+    const cellIndex = input.cellNumber ?? 0;
+    if (input.editMode === "delete") {
+        if (cellIndex < 0 || cellIndex >= notebook.cells.length) {
+            throw new Error(`Cell index ${cellIndex} out of range (0-${notebook.cells.length - 1})`);
+        }
+        notebook.cells.splice(cellIndex, 1);
+        writeFileSync(resolved.absolutePath, JSON.stringify(notebook, null, 1) + "\n", "utf8");
+        return `Deleted cell ${cellIndex} from ${resolved.relativePath} (${notebook.cells.length} cells remaining)`;
+    }
+    if (input.editMode === "insert") {
+        if (!input.cellType) {
+            throw new Error("cell_type is required for insert mode");
+        }
+        const newCell = createCell(input.cellType, input.newSource);
+        const insertAt = Math.min(cellIndex, notebook.cells.length);
+        notebook.cells.splice(insertAt, 0, newCell);
+        writeFileSync(resolved.absolutePath, JSON.stringify(notebook, null, 1) + "\n", "utf8");
+        return `Inserted ${input.cellType} cell at index ${insertAt} in ${resolved.relativePath} (${notebook.cells.length} cells)`;
+    }
+    // replace
+    if (cellIndex < 0 || cellIndex >= notebook.cells.length) {
+        throw new Error(`Cell index ${cellIndex} out of range (0-${notebook.cells.length - 1})`);
+    }
+    const cell = notebook.cells[cellIndex];
+    cell.source = input.newSource.split("\n").map((line, i, arr) => i < arr.length - 1 ? line + "\n" : line);
+    if (input.cellType) {
+        cell.cell_type = input.cellType;
+    }
+    writeFileSync(resolved.absolutePath, JSON.stringify(notebook, null, 1) + "\n", "utf8");
+    return `Replaced cell ${cellIndex} in ${resolved.relativePath} (${input.cellType ?? cell.cell_type})`;
+}
+function createCell(cellType, source) {
+    const sourceLines = source.split("\n").map((line, i, arr) => i < arr.length - 1 ? line + "\n" : line);
+    if (cellType === "code") {
+        return {
+            cell_type: "code",
+            execution_count: null,
+            metadata: {},
+            outputs: [],
+            source: sourceLines
+        };
+    }
+    return {
+        cell_type: "markdown",
+        metadata: {},
+        source: sourceLines
+    };
+}
+export function parseNotebookReadInput(input) {
+    const notebookPath = input.notebook_path;
+    if (typeof notebookPath !== "string" || !notebookPath.trim()) {
+        throw new Error("notebook_path is required");
+    }
+    return {
+        notebookPath: notebookPath.trim(),
+        maxCells: typeof input.max_cells === "number" && input.max_cells > 0 ? input.max_cells : undefined
+    };
+}
+export function executeNotebookRead(cwd, input) {
+    const resolved = resolveWorkspacePath(cwd, input.notebookPath);
+    if (!existsSync(resolved.absolutePath)) {
+        throw new Error(`Notebook not found: ${resolved.relativePath}`);
+    }
+    if (!resolved.absolutePath.endsWith(".ipynb")) {
+        throw new Error("File must be a .ipynb notebook");
+    }
+    const raw = readFileSync(resolved.absolutePath, "utf8");
+    const notebook = JSON.parse(raw);
+    if (!notebook.cells || !Array.isArray(notebook.cells)) {
+        throw new Error("Invalid notebook format: missing cells array");
+    }
+    const cells = input.maxCells ? notebook.cells.slice(0, input.maxCells) : notebook.cells;
+    const output = [`Notebook: ${resolved.relativePath}`];
+    output.push(`Cells: ${notebook.cells.length} total${input.maxCells ? ` (showing first ${input.maxCells})` : ""}`);
+    output.push("");
+    for (let i = 0; i < cells.length; i++) {
+        const cell = cells[i];
+        const cellType = cell.cell_type ?? "unknown";
+        const source = Array.isArray(cell.source) ? cell.source.join("") : (typeof cell.source === "string" ? cell.source : "");
+        const execCount = cell.execution_count != null ? ` [exec: ${cell.execution_count}]` : "";
+        output.push(`--- Cell ${i} (${cellType})${execCount} ---`);
+        output.push(source || "(empty)");
+        output.push("");
+    }
+    return output.join("\n");
+}
+//# sourceMappingURL=notebook.js.map

package/dist/tools/notebook.js.map

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

package/dist/tools/plan-mode.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Planning mode tools: EnterPlanMode and ExitPlanMode.
+ *
+ * EnterPlanMode switches the agent into a read-only exploration mode where
+ * mutations are blocked. The agent explores the codebase and designs a plan.
+ *
+ * ExitPlanMode signals that the plan is ready for user approval.
+ * The plan content is returned to the user for review.
+ */
+export interface PlanModeState {
+    active: boolean;
+    planContent?: string;
+    enteredAt?: string;
+}
+export declare const EnterPlanModeInputSchema: {
+    type: string;
+    properties: {
+        reason: {
+            type: string;
+            description: string;
+        };
+    };
+    required: never[];
+    additionalProperties: boolean;
+};
+export declare const ExitPlanModeInputSchema: {
+    type: string;
+    properties: {
+        plan: {
+            type: string;
+            description: string;
+        };
+    };
+    required: string[];
+    additionalProperties: boolean;
+};
+export declare function parseEnterPlanModeInput(input: Record<string, unknown>): {
+    reason?: string;
+};
+export declare function parseExitPlanModeInput(input: Record<string, unknown>): {
+    plan: string;
+};
+export declare function formatEnterPlanModeResult(input: {
+    reason?: string;
+}): string;
+export declare function formatExitPlanModeResult(input: {
+    plan: string;
+}): string;

package/dist/tools/plan-mode.js

@@ -0,0 +1,57 @@
+/**
+ * Planning mode tools: EnterPlanMode and ExitPlanMode.
+ *
+ * EnterPlanMode switches the agent into a read-only exploration mode where
+ * mutations are blocked. The agent explores the codebase and designs a plan.
+ *
+ * ExitPlanMode signals that the plan is ready for user approval.
+ * The plan content is returned to the user for review.
+ */
+export const EnterPlanModeInputSchema = {
+    type: "object",
+    properties: {
+        reason: { type: "string", description: "Why planning is needed before implementation" }
+    },
+    required: [],
+    additionalProperties: false
+};
+export const ExitPlanModeInputSchema = {
+    type: "object",
+    properties: {
+        plan: { type: "string", description: "The implementation plan for user approval" }
+    },
+    required: ["plan"],
+    additionalProperties: false
+};
+export function parseEnterPlanModeInput(input) {
+    return {
+        reason: typeof input.reason === "string" ? input.reason.trim() || undefined : undefined
+    };
+}
+export function parseExitPlanModeInput(input) {
+    const plan = input.plan;
+    if (typeof plan !== "string" || !plan.trim()) {
+        throw new Error("ExitPlanMode requires a non-empty plan");
+    }
+    return { plan: plan.trim() };
+}
+export function formatEnterPlanModeResult(input) {
+    return [
+        "Entered plan mode. Mutations are blocked until the plan is approved.",
+        "Use read-only tools (FileRead, Grep, Glob, GitLog, etc.) to explore the codebase.",
+        "When ready, call ExitPlanMode with your implementation plan.",
+        input.reason ? `\nReason: ${input.reason}` : ""
+    ].filter(Boolean).join("\n");
+}
+export function formatExitPlanModeResult(input) {
+    return [
+        "Plan submitted for user approval.",
+        "",
+        "---",
+        input.plan,
+        "---",
+        "",
+        "Waiting for user to approve or provide feedback."
+    ].join("\n");
+}
+//# sourceMappingURL=plan-mode.js.map

package/dist/tools/plan-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-mode.js","sourceRoot":"","sources":["../../src/tools/plan-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8CAA8C,EAAE;KACxF;IACD,QAAQ,EAAE,EAAE;IACZ,oBAAoB,EAAE,KAAK;CACM,CAAC;AAEpC,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;KACnF;IACD,QAAQ,EAAE,CAAC,MAAM,CAAC;IAClB,oBAAoB,EAAE,KAAK;CACM,CAAC;AAEpC,MAAM,UAAU,uBAAuB,CAAC,KAA8B;IACpE,OAAO;QACL,MAAM,EAAE,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS;KACxF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAA8B;IACnE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAA0B;IAClE,OAAO;QACL,sEAAsE;QACtE,mFAAmF;QACnF,8DAA8D;QAC9D,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE;KAChD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAuB;IAC9D,OAAO;QACL,mCAAmC;QACnC,EAAE;QACF,KAAK;QACL,KAAK,CAAC,IAAI;QACV,KAAK;QACL,EAAE;QACF,kDAAkD;KACnD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/tools/process-list.d.ts

@@ -0,0 +1,35 @@
+export interface ProcessInfo {
+    pid: number;
+    name: string;
+    cpuPercent: string;
+    memPercent: string;
+    state: string;
+}
+export declare const ProcessListInputSchema: {
+    type: string;
+    properties: {
+        filter: {
+            type: string;
+        };
+        sort_by: {
+            type: string;
+            enum: string[];
+        };
+        limit: {
+            type: string;
+        };
+    };
+    required: never[];
+    additionalProperties: boolean;
+};
+export declare function parseProcessListInput(input: Record<string, unknown>): {
+    filter?: string;
+    sortBy: string;
+    limit: number;
+};
+export declare function executeProcessList(input: {
+    filter?: string;
+    sortBy: string;
+    limit: number;
+}): ProcessInfo[];
+export declare function formatProcessListResult(processes: ProcessInfo[]): string;

package/dist/tools/process-list.js

@@ -0,0 +1,42 @@
+import { execSync } from "node:child_process";
+import os from "node:os";
+export const ProcessListInputSchema = { type: "object", properties: { filter: { type: "string" }, sort_by: { type: "string", enum: ["cpu", "mem", "pid", "name"] }, limit: { type: "number" } }, required: [], additionalProperties: false };
+export function parseProcessListInput(input) {
+    return {
+        filter: typeof input.filter === "string" ? input.filter : undefined,
+        sortBy: input.sort_by === "cpu" ? "cpu" : input.sort_by === "mem" ? "mem" : input.sort_by === "pid" ? "pid" : "cpu",
+        limit: typeof input.limit === "number" ? Math.min(input.limit, 100) : 20
+    };
+}
+export function executeProcessList(input) {
+    // macOS uses -r for reverse CPU sort, Linux uses --sort=-%cpu
+    const isMac = os.platform() === "darwin";
+    const sortFlag = isMac
+        ? (input.sortBy === "mem" ? "-m" : input.sortBy === "pid" ? "" : "-r")
+        : `--sort=-${input.sortBy === "mem" ? "%mem" : input.sortBy === "pid" ? "pid" : "%cpu"}`;
+    const sortPart = sortFlag ? ` ${sortFlag}` : "";
+    const filter = input.filter ? ` | awk 'tolower($0) ~ /${input.filter.toLowerCase().replace(/[^a-z0-9]/g, "")}/'` : "";
+    const raw = execSync(`ps aux${sortPart}${filter}`, { encoding: "utf8", timeout: 5000 });
+    const lines = raw.trim().split("\n");
+    // Skip header, take limit
+    const dataLines = lines.slice(1, input.limit + 1);
+    return dataLines.map(line => {
+        const parts = line.split(/\s+/);
+        const pid = parseInt(parts[1] ?? "0", 10);
+        const cpu = parts[2] ?? "0";
+        const mem = parts[3] ?? "0";
+        const state = parts[7] ?? "?";
+        const name = parts.slice(10).join(" ") || "unknown";
+        return { pid, name, cpuPercent: cpu, memPercent: mem, state };
+    });
+}
+export function formatProcessListResult(processes) {
+    if (processes.length === 0)
+        return "No matching processes";
+    const lines = ["PID      CPU%  MEM%  NAME"];
+    for (const p of processes) {
+        lines.push(`${String(p.pid).padEnd(8)} ${p.cpuPercent.padEnd(5)} ${p.memPercent.padEnd(5)} ${p.name.slice(0, 60)}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=process-list.js.map

package/dist/tools/process-list.js.map

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

package/dist/tools/registry.d.ts

@@ -0,0 +1,132 @@
+import { MagiMessage, MagiToolDefinition, MagiToolUsePart } from "../providers/ir.js";
+import { UserMessageSink } from "./user-message.js";
+import { UserQuestionResolver } from "./user-question.js";
+import { WebSearchConfig } from "../config.js";
+export type ToolPermissionMode = "default" | "acceptEdits" | "bypassPermissions" | "plan";
+export type ToolPermissionDecision = "allow" | "ask" | "deny";
+export interface ToolPermissionRules {
+    allow: string[];
+    ask: string[];
+    deny: string[];
+}
+export interface ToolPermissionResult {
+    decision: ToolPermissionDecision;
+    reason: string;
+    diff?: string;
+}
+export interface RegisteredTool {
+    name: string;
+    description?: string;
+    category?: string;
+    tags?: string[];
+    inputSchema: Record<string, unknown>;
+    call(input: Record<string, unknown>, context: ToolExecutionContext): Promise<string> | string;
+    isReadOnly(input: Record<string, unknown>): boolean;
+    isDestructive(input: Record<string, unknown>): boolean;
+    isConcurrencySafe(input: Record<string, unknown>): boolean;
+    checkPermissions?(input: Record<string, unknown>, context: ToolExecutionContext): ToolPermissionResult | undefined;
+}
+export interface SubAgentRequest {
+    prompt: string;
+    description: string;
+    subagentType: string;
+    runInBackground: boolean;
+    /** Optional peer name or URL to dispatch the sub-agent to. */
+    target?: string;
+}
+export interface SubAgentResult {
+    agentId: string;
+    status: "completed" | "running" | "failed";
+    result?: string;
+    error?: string;
+}
+export interface ToolExecutionContext {
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    permissionMode: ToolPermissionMode;
+    rules?: ToolPermissionRules;
+    outputRoot?: string;
+    stateRoot?: string;
+    sessionId?: string;
+    webSearchConfig?: WebSearchConfig;
+    promptModel?: (request: {
+        messages: MagiMessage[];
+    }) => Promise<{
+        text: string;
+    }>;
+    userQuestionResolver?: UserQuestionResolver;
+    userMessageSink?: UserMessageSink;
+    toolUse?: MagiToolUsePart;
+    spawnSubAgent?: (request: SubAgentRequest) => Promise<SubAgentResult>;
+    signal?: AbortSignal;
+}
+export interface RegisteredToolResult {
+    toolCallId: string;
+    toolName: string;
+    content: string;
+    isError?: boolean;
+    permission?: ToolPermissionResult;
+}
+export declare function getBuiltinToolRegistry(): Map<string, RegisteredTool>;
+export declare function getBuiltinToolDefinitions(): MagiToolDefinition[];
+export declare function executeRegisteredTool(input: {
+    cwd: string;
+    toolUse: MagiToolUsePart;
+    env?: NodeJS.ProcessEnv;
+    permissionMode?: ToolPermissionMode;
+    rules?: ToolPermissionRules;
+    outputRoot?: string;
+    stateRoot?: string;
+    sessionId?: string;
+    webSearchConfig?: WebSearchConfig;
+    promptModel?: (request: {
+        messages: MagiMessage[];
+    }) => Promise<{
+        text: string;
+    }>;
+    userQuestionResolver?: UserQuestionResolver;
+    userMessageSink?: UserMessageSink;
+    spawnSubAgent?: (request: SubAgentRequest) => Promise<SubAgentResult>;
+    approvalResolver?: (request: {
+        toolUse: MagiToolUsePart;
+        permission: ToolPermissionResult;
+    }) => Promise<boolean> | boolean;
+    signal?: AbortSignal;
+}): Promise<RegisteredToolResult>;
+export declare function executeRegisteredTools(input: {
+    cwd: string;
+    toolUses: MagiToolUsePart[];
+    env?: NodeJS.ProcessEnv;
+    permissionMode?: ToolPermissionMode;
+    rules?: ToolPermissionRules;
+    outputRoot?: string;
+    stateRoot?: string;
+    sessionId?: string;
+    webSearchConfig?: WebSearchConfig;
+    promptModel?: (request: {
+        messages: MagiMessage[];
+    }) => Promise<{
+        text: string;
+    }>;
+    userQuestionResolver?: UserQuestionResolver;
+    userMessageSink?: UserMessageSink;
+    spawnSubAgent?: (request: SubAgentRequest) => Promise<SubAgentResult>;
+    approvalResolver?: (request: {
+        toolUse: MagiToolUsePart;
+        permission: ToolPermissionResult;
+    }) => Promise<boolean> | boolean;
+    signal?: AbortSignal;
+}): Promise<RegisteredToolResult[]>;
+export declare function checkToolPermission(input: {
+    toolUse: MagiToolUsePart;
+    mode: ToolPermissionMode;
+    rules?: ToolPermissionRules;
+    env?: NodeJS.ProcessEnv;
+    tool?: RegisteredTool;
+}): ToolPermissionResult;
+export declare function formatToolResult(input: {
+    content: string;
+    outputRoot?: string;
+    maxChars?: number;
+    previewChars?: number;
+}): string;