@edwardlee5423/magi 0.1.0-alpha.0

package/dist/spinner.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Animated spinner for model thinking state.
+ * Shows braille dots animation with elapsed time.
+ * Clears itself when stopped.
+ */
+export interface SpinnerStatus {
+    /** Optional model name to show */
+    model?: string;
+    /** Token counts to show as `↑1.2k ↓300` */
+    inputTokens?: number;
+    outputTokens?: number;
+    /** Optional short status text (e.g. "Bash: npm test"). Replaces "Thinking…". */
+    text?: string;
+}
+export interface Spinner {
+    stop(): void;
+    /** Pause the animation (clears the line). Resume continues from where it
+     * left off. Use this when prompting the user for input — readline's
+     * question() output gets clobbered if the spinner keeps overwriting. */
+    pause(): void;
+    resume(): void;
+    /** Update visible status. Safe to call frequently; renders on next tick. */
+    update(status: SpinnerStatus): void;
+}
+export declare function startSpinner(output: {
+    write(s: string): void;
+}, initial?: SpinnerStatus): Spinner;

package/dist/spinner.js

@@ -0,0 +1,68 @@
+/**
+ * Animated spinner for model thinking state.
+ * Shows braille dots animation with elapsed time.
+ * Clears itself when stopped.
+ */
+const FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+const STALL_MS = 15_000;
+function formatTokens(n) {
+    if (n < 1000)
+        return String(n);
+    if (n < 1_000_000)
+        return `${(n / 1000).toFixed(1)}k`;
+    return `${(n / 1_000_000).toFixed(2)}M`;
+}
+export function startSpinner(output, initial) {
+    let frame = 0;
+    const start = Date.now();
+    let stopped = false;
+    let paused = false;
+    let status = initial ?? {};
+    const interval = setInterval(() => {
+        if (stopped || paused)
+            return;
+        const elapsedMs = Date.now() - start;
+        const elapsed = (elapsedMs / 1000).toFixed(1);
+        const char = FRAMES[frame % FRAMES.length];
+        const stalled = elapsedMs > STALL_MS;
+        const color = stalled ? "\x1b[33m" : "\x1b[36m";
+        const reset = "\x1b[39m";
+        const dim = "\x1b[90m";
+        const message = status.text ?? "Thinking";
+        const parts = [`${color}${char}${reset} ${message}`];
+        if (status.model)
+            parts.push(`${dim}${status.model}${reset}`);
+        if (status.inputTokens !== undefined && status.outputTokens !== undefined) {
+            parts.push(`${dim}↑${formatTokens(status.inputTokens)} ↓${formatTokens(status.outputTokens)}${reset}`);
+        }
+        parts.push(`${dim}${elapsed}s${reset}`);
+        output.write(`\r\x1b[K${parts.join("  ")}`);
+        frame++;
+    }, 80);
+    return {
+        stop() {
+            if (stopped)
+                return;
+            stopped = true;
+            clearInterval(interval);
+            // Clear the spinner line
+            output.write("\r\x1b[K");
+        },
+        pause() {
+            if (paused || stopped)
+                return;
+            paused = true;
+            // Clear the spinner line so the next output isn't on top of it.
+            output.write("\r\x1b[K");
+        },
+        resume() {
+            if (stopped)
+                return;
+            paused = false;
+        },
+        update(next) {
+            status = { ...status, ...next };
+        }
+    };
+}
+//# sourceMappingURL=spinner.js.map

package/dist/spinner.js.map

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

package/dist/ssh/exec.d.ts

@@ -0,0 +1,20 @@
+export interface SshHostConfig {
+    host: string;
+    user?: string;
+    port?: number;
+}
+export interface SshExecResult {
+    host: string;
+    command: string;
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+}
+export declare function sshExec(input: {
+    host: string;
+    command: string;
+    user?: string;
+    port?: number;
+    timeoutMs?: number;
+}): Promise<SshExecResult>;
+export declare function buildSshArgs(host: string, user?: string, port?: number): string[];

package/dist/ssh/exec.js

@@ -0,0 +1,39 @@
+import { spawnSync } from "node:child_process";
+import { ToolError } from "../tools/errors.js";
+export async function sshExec(input) {
+    const args = buildSshArgs(input.host, input.user, input.port);
+    // Pass the command as the final argument to ssh
+    args.push(input.command);
+    const result = spawnSync("ssh", args, {
+        encoding: "utf8",
+        timeout: input.timeoutMs ?? 30_000,
+        maxBuffer: 10 * 1024 * 1024 // 10MB
+    });
+    if (result.error) {
+        if (result.error.code === "ETIMEDOUT") {
+            throw new ToolError(`SSH connection to ${input.host} timed out after ${input.timeoutMs ?? 30_000}ms`, "timeout");
+        }
+        throw new ToolError(`SSH failed: ${result.error.message}`, "command-failed");
+    }
+    return {
+        host: input.host,
+        command: input.command,
+        exitCode: result.status,
+        stdout: result.stdout?.trim() ?? "",
+        stderr: result.stderr?.trim() ?? ""
+    };
+}
+export function buildSshArgs(host, user, port) {
+    const args = [
+        "-o", "StrictHostKeyChecking=accept-new",
+        "-o", "ConnectTimeout=10",
+        "-o", "BatchMode=yes"
+    ];
+    if (port) {
+        args.push("-p", String(port));
+    }
+    const target = user ? `${user}@${host}` : host;
+    args.push(target);
+    return args;
+}
+//# sourceMappingURL=exec.js.map

package/dist/ssh/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/ssh/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAgB/C,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAM7B;IACC,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAE9D,gDAAgD;IAChD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAEzB,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE;QACpC,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,KAAK,CAAC,SAAS,IAAI,MAAM;QAClC,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,OAAO;KACpC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,IAAK,MAAM,CAAC,KAA+B,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACjE,MAAM,IAAI,SAAS,CAAC,qBAAqB,KAAK,CAAC,IAAI,oBAAoB,KAAK,CAAC,SAAS,IAAI,MAAM,IAAI,EAAE,SAAS,CAAC,CAAC;QACnH,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,eAAe,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAC/E,CAAC;IAED,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,MAAM,CAAC,MAAM;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE;QACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAa,EAAE,IAAa;IACrE,MAAM,IAAI,GAAG;QACX,IAAI,EAAE,kCAAkC;QACxC,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,eAAe;KACtB,CAAC;IAEF,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAElB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/ssh/file.d.ts

@@ -0,0 +1,32 @@
+export interface SshFileReadResult {
+    host: string;
+    path: string;
+    content: string;
+    sizeBytes: number;
+}
+export interface SshFileWriteResult {
+    host: string;
+    path: string;
+    sizeBytes: number;
+}
+/**
+ * Read a file from a remote host via SSH.
+ * Uses base64 encoding to safely handle binary content.
+ */
+export declare function sshFileRead(input: {
+    host: string;
+    path: string;
+    user?: string;
+    port?: number;
+}): Promise<SshFileReadResult>;
+/**
+ * Write a file to a remote host via SSH.
+ * Encodes content as base64 and pipes through SSH.
+ */
+export declare function sshFileWrite(input: {
+    host: string;
+    path: string;
+    content: string;
+    user?: string;
+    port?: number;
+}): Promise<SshFileWriteResult>;

package/dist/ssh/file.js

@@ -0,0 +1,60 @@
+import { spawnSync } from "node:child_process";
+import { ToolError } from "../tools/errors.js";
+import { buildSshArgs } from "./exec.js";
+/**
+ * Read a file from a remote host via SSH.
+ * Uses base64 encoding to safely handle binary content.
+ */
+export async function sshFileRead(input) {
+    const args = buildSshArgs(input.host, input.user, input.port);
+    // Use printf with %s to safely pass the path without shell interpretation
+    args.push(`printf '%s' "$(cat -- "$1")" | base64`, "--", input.path);
+    const result = spawnSync("ssh", args, {
+        encoding: "utf8",
+        timeout: 15_000,
+        maxBuffer: 10 * 1024 * 1024
+    });
+    if (result.error) {
+        throw new ToolError(`SSH file read failed: ${result.error.message}`, "command-failed");
+    }
+    if (result.status !== 0) {
+        throw new ToolError(`Failed to read ${input.path} on ${input.host}: ${result.stderr?.trim() || "unknown error"}`, "command-failed");
+    }
+    const base64Content = result.stdout?.trim() ?? "";
+    const content = Buffer.from(base64Content, "base64").toString("utf8");
+    // The base64 output has a trailing newline; decode then measure original bytes
+    const rawBytes = Buffer.from(base64Content, "base64");
+    return {
+        host: input.host,
+        path: input.path,
+        content,
+        sizeBytes: rawBytes.length
+    };
+}
+/**
+ * Write a file to a remote host via SSH.
+ * Encodes content as base64 and pipes through SSH.
+ */
+export async function sshFileWrite(input) {
+    const b64 = Buffer.from(input.content, "utf8").toString("base64");
+    const args = buildSshArgs(input.host, input.user, input.port);
+    // Use printf and -- to safely pass the path without shell interpretation
+    args.push(`printf '%s' "$1" | base64 -d > -- "$2"`, "--", b64, input.path);
+    const result = spawnSync("ssh", args, {
+        encoding: "utf8",
+        timeout: 30_000,
+        maxBuffer: 10 * 1024 * 1024
+    });
+    if (result.error) {
+        throw new ToolError(`SSH file write failed: ${result.error.message}`, "command-failed");
+    }
+    if (result.status !== 0) {
+        throw new ToolError(`Failed to write ${input.path} on ${input.host}: ${result.stderr?.trim() || "unknown error"}`, "command-failed");
+    }
+    return {
+        host: input.host,
+        path: input.path,
+        sizeBytes: input.content.length
+    };
+}
+//# sourceMappingURL=file.js.map

package/dist/ssh/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/ssh/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAezC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAKjC;IACC,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9D,0EAA0E;IAC1E,IAAI,CAAC,IAAI,CAAC,uCAAuC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAErE,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE;QACpC,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,MAAM;QACf,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC5B,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,SAAS,CAAC,yBAAyB,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CACjB,kBAAkB,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,eAAe,EAAE,EAC5F,gBAAgB,CACjB,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtE,+EAA+E;IAC/E,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAEtD,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO;QACP,SAAS,EAAE,QAAQ,CAAC,MAAM;KAC3B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAMlC;IACC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAElE,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9D,yEAAyE;IACzE,IAAI,CAAC,IAAI,CAAC,wCAAwC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAE3E,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE;QACpC,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,MAAM;QACf,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC5B,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,SAAS,CAAC,0BAA0B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CACjB,mBAAmB,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,eAAe,EAAE,EAC7F,gBAAgB,CACjB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;KAChC,CAAC;AACJ,CAAC"}

package/dist/syntax-highlight.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Minimal syntax highlighting for terminal code blocks.
+ *
+ * Deliberately small: highlights keywords, strings, comments, numbers, and
+ * function-like calls for the languages we see most. Anything more (proper
+ * tokenizer per language) is out of scope.
+ *
+ * Each highlighter takes a single line and returns ANSI-colored output.
+ */
+/** Multi-line block comment state shared across lines. */
+export interface HighlightState {
+    inBlockComment: boolean;
+}
+export declare function createHighlightState(): HighlightState;
+/**
+ * Highlight one line of source code. Mutates `state` to track multi-line
+ * block comment state.
+ */
+export declare function highlightLine(line: string, lang: string | undefined, state: HighlightState): string;

package/dist/syntax-highlight.js

@@ -0,0 +1,181 @@
+/**
+ * Minimal syntax highlighting for terminal code blocks.
+ *
+ * Deliberately small: highlights keywords, strings, comments, numbers, and
+ * function-like calls for the languages we see most. Anything more (proper
+ * tokenizer per language) is out of scope.
+ *
+ * Each highlighter takes a single line and returns ANSI-colored output.
+ */
+const ESC = "\x1b[";
+const RESET = `${ESC}0m`;
+const COLOR = {
+    keyword: `${ESC}38;5;141m`, // light purple
+    string: `${ESC}38;5;108m`, // green-cyan
+    comment: `${ESC}38;5;243m`, // gray
+    number: `${ESC}38;5;180m`, // tan
+    func: `${ESC}38;5;111m`, // light blue
+    type: `${ESC}38;5;180m`, // amber
+    punct: `${ESC}38;5;245m`, // gray
+    operator: `${ESC}38;5;174m` // pink
+};
+const TS_JS_KEYWORDS = new Set([
+    "abstract", "any", "as", "async", "await", "boolean", "break", "case",
+    "catch", "class", "const", "constructor", "continue", "debugger", "declare",
+    "default", "delete", "do", "else", "enum", "export", "extends", "false",
+    "finally", "for", "from", "function", "get", "if", "implements", "import",
+    "in", "instanceof", "interface", "is", "let", "namespace", "never", "new",
+    "null", "number", "of", "package", "private", "protected", "public",
+    "readonly", "return", "set", "static", "string", "super", "switch", "this",
+    "throw", "true", "try", "type", "typeof", "undefined", "unknown", "var",
+    "void", "while", "with", "yield"
+]);
+const PYTHON_KEYWORDS = new Set([
+    "False", "None", "True", "and", "as", "assert", "async", "await", "break",
+    "class", "continue", "def", "del", "elif", "else", "except", "finally",
+    "for", "from", "global", "if", "import", "in", "is", "lambda", "nonlocal",
+    "not", "or", "pass", "raise", "return", "try", "while", "with", "yield"
+]);
+const SHELL_KEYWORDS = new Set([
+    "if", "then", "else", "elif", "fi", "for", "while", "do", "done", "case",
+    "esac", "in", "function", "return", "echo", "exit", "true", "false",
+    "export", "set", "unset", "local", "readonly", "declare", "alias", "source",
+    "cd", "ls", "pwd", "mkdir", "rm", "cp", "mv", "git", "npm", "node", "python"
+]);
+const RUST_KEYWORDS = new Set([
+    "as", "break", "const", "continue", "crate", "else", "enum", "extern", "false",
+    "fn", "for", "if", "impl", "in", "let", "loop", "match", "mod", "move", "mut",
+    "pub", "ref", "return", "self", "Self", "static", "struct", "super", "trait",
+    "true", "type", "unsafe", "use", "where", "while", "async", "await", "dyn"
+]);
+const GO_KEYWORDS = new Set([
+    "break", "case", "chan", "const", "continue", "default", "defer", "else",
+    "fallthrough", "for", "func", "go", "goto", "if", "import", "interface",
+    "map", "package", "range", "return", "select", "struct", "switch", "type",
+    "var", "true", "false", "nil"
+]);
+const LANGS = {
+    ts: { keywords: TS_JS_KEYWORDS, lineComment: /\/\/.*/, blockCommentOpen: "/*", blockCommentClose: "*/", stringQuotes: ["\"", "'", "`"] },
+    js: { keywords: TS_JS_KEYWORDS, lineComment: /\/\/.*/, blockCommentOpen: "/*", blockCommentClose: "*/", stringQuotes: ["\"", "'", "`"] },
+    tsx: { keywords: TS_JS_KEYWORDS, lineComment: /\/\/.*/, blockCommentOpen: "/*", blockCommentClose: "*/", stringQuotes: ["\"", "'", "`"] },
+    jsx: { keywords: TS_JS_KEYWORDS, lineComment: /\/\/.*/, blockCommentOpen: "/*", blockCommentClose: "*/", stringQuotes: ["\"", "'", "`"] },
+    py: { keywords: PYTHON_KEYWORDS, lineComment: /#.*/, stringQuotes: ["\"", "'"] },
+    python: { keywords: PYTHON_KEYWORDS, lineComment: /#.*/, stringQuotes: ["\"", "'"] },
+    sh: { keywords: SHELL_KEYWORDS, lineComment: /#.*/, stringQuotes: ["\"", "'"] },
+    bash: { keywords: SHELL_KEYWORDS, lineComment: /#.*/, stringQuotes: ["\"", "'"] },
+    zsh: { keywords: SHELL_KEYWORDS, lineComment: /#.*/, stringQuotes: ["\"", "'"] },
+    shell: { keywords: SHELL_KEYWORDS, lineComment: /#.*/, stringQuotes: ["\"", "'"] },
+    rs: { keywords: RUST_KEYWORDS, lineComment: /\/\/.*/, blockCommentOpen: "/*", blockCommentClose: "*/", stringQuotes: ["\""] },
+    rust: { keywords: RUST_KEYWORDS, lineComment: /\/\/.*/, blockCommentOpen: "/*", blockCommentClose: "*/", stringQuotes: ["\""] },
+    go: { keywords: GO_KEYWORDS, lineComment: /\/\/.*/, blockCommentOpen: "/*", blockCommentClose: "*/", stringQuotes: ["\"", "`"] },
+    json: { keywords: new Set(["true", "false", "null"]), stringQuotes: ["\""] }
+};
+export function createHighlightState() {
+    return { inBlockComment: false };
+}
+/**
+ * Highlight one line of source code. Mutates `state` to track multi-line
+ * block comment state.
+ */
+export function highlightLine(line, lang, state) {
+    if (!lang)
+        return line;
+    const spec = LANGS[lang.toLowerCase()];
+    if (!spec)
+        return line;
+    // Tokenize: walk character by character, recognizing strings, comments,
+    // numbers, identifiers (which we then check against keywords).
+    let result = "";
+    let i = 0;
+    const len = line.length;
+    // Continuation of a block comment from a prior line
+    if (state.inBlockComment && spec.blockCommentClose) {
+        const closeIdx = line.indexOf(spec.blockCommentClose);
+        if (closeIdx === -1) {
+            return COLOR.comment + line + RESET;
+        }
+        result += COLOR.comment + line.slice(0, closeIdx + spec.blockCommentClose.length) + RESET;
+        state.inBlockComment = false;
+        i = closeIdx + spec.blockCommentClose.length;
+    }
+    while (i < len) {
+        const ch = line[i];
+        const rest = line.slice(i);
+        // Block comment start
+        if (spec.blockCommentOpen && rest.startsWith(spec.blockCommentOpen)) {
+            const close = spec.blockCommentClose;
+            const closeIdx = rest.indexOf(close, spec.blockCommentOpen.length);
+            if (closeIdx === -1) {
+                // Comment continues to next line
+                result += COLOR.comment + rest + RESET;
+                state.inBlockComment = true;
+                return result;
+            }
+            const end = i + closeIdx + close.length;
+            result += COLOR.comment + line.slice(i, end) + RESET;
+            i = end;
+            continue;
+        }
+        // Line comment
+        if (spec.lineComment) {
+            const commentMatch = spec.lineComment.exec(rest);
+            if (commentMatch && commentMatch.index === 0) {
+                result += COLOR.comment + commentMatch[0] + RESET;
+                i += commentMatch[0].length;
+                continue;
+            }
+        }
+        // String
+        if (spec.stringQuotes && spec.stringQuotes.includes(ch)) {
+            const quote = ch;
+            let j = i + 1;
+            while (j < len) {
+                if (line[j] === "\\" && j + 1 < len) {
+                    j += 2;
+                    continue;
+                }
+                if (line[j] === quote) {
+                    j += 1;
+                    break;
+                }
+                j += 1;
+            }
+            result += COLOR.string + line.slice(i, j) + RESET;
+            i = j;
+            continue;
+        }
+        // Number
+        if (/[0-9]/.test(ch) && (i === 0 || !/[A-Za-z_]/.test(line[i - 1]))) {
+            const numMatch = /^[0-9_]+(\.[0-9_]+)?([eE][+-]?[0-9]+)?[a-zA-Z]*/.exec(rest);
+            if (numMatch) {
+                result += COLOR.number + numMatch[0] + RESET;
+                i += numMatch[0].length;
+                continue;
+            }
+        }
+        // Identifier / keyword
+        if (/[A-Za-z_$]/.test(ch)) {
+            const idMatch = /^[A-Za-z_$][A-Za-z0-9_$]*/.exec(rest);
+            if (idMatch) {
+                const word = idMatch[0];
+                const next = line[i + word.length];
+                if (spec.keywords.has(word)) {
+                    result += COLOR.keyword + word + RESET;
+                }
+                else if (next === "(") {
+                    result += COLOR.func + word + RESET;
+                }
+                else {
+                    result += word;
+                }
+                i += word.length;
+                continue;
+            }
+        }
+        // Default: pass through char
+        result += ch;
+        i += 1;
+    }
+    return result;
+}
+//# sourceMappingURL=syntax-highlight.js.map

package/dist/syntax-highlight.js.map

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

package/dist/tools/agent-tool.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Sub-agent tool: Agent.
+ *
+ * Spawns a sub-agent to handle complex, multi-step tasks autonomously.
+ * Sub-agents run in the background and return results when complete.
+ * This preserves the main context window for implementation work.
+ */
+export type SubagentType = "general" | "explore" | "plan" | "verification";
+export interface AgentToolInput {
+    description: string;
+    prompt: string;
+    subagentType?: SubagentType;
+    runInBackground?: boolean;
+    /** Optional peer name (mDNS instance/hostname) or URL to dispatch the sub-agent to. */
+    target?: string;
+}
+export interface SubagentResult {
+    agentId: string;
+    type: SubagentType;
+    status: "completed" | "running" | "failed";
+    result?: string;
+    error?: string;
+}
+export declare const AgentToolInputSchema: {
+    type: string;
+    properties: {
+        description: {
+            type: string;
+            description: string;
+        };
+        prompt: {
+            type: string;
+            description: string;
+        };
+        subagent_type: {
+            type: string;
+            enum: string[];
+            description: string;
+        };
+        run_in_background: {
+            type: string;
+            description: string;
+        };
+        target: {
+            type: string;
+            description: string;
+        };
+    };
+    required: string[];
+    additionalProperties: boolean;
+};
+export declare function parseAgentToolInput(input: Record<string, unknown>): AgentToolInput;
+export declare function formatAgentToolResult(result: SubagentResult): string;

package/dist/tools/agent-tool.js

@@ -0,0 +1,62 @@
+/**
+ * Sub-agent tool: Agent.
+ *
+ * Spawns a sub-agent to handle complex, multi-step tasks autonomously.
+ * Sub-agents run in the background and return results when complete.
+ * This preserves the main context window for implementation work.
+ */
+export const AgentToolInputSchema = {
+    type: "object",
+    properties: {
+        description: { type: "string", description: "Short (3-5 word) description of what the agent will do" },
+        prompt: { type: "string", description: "The task for the agent to perform" },
+        subagent_type: {
+            type: "string",
+            enum: ["general", "explore", "plan", "verification"],
+            description: "Type of specialized agent to use"
+        },
+        run_in_background: { type: "boolean", description: "Run agent in background (default false)" },
+        target: {
+            type: "string",
+            description: "Optional peer name (mDNS) or URL of a remote Magi daemon to dispatch this sub-agent to. Use 'magi peers' to see available targets. If omitted, runs locally."
+        }
+    },
+    required: ["description", "prompt"],
+    additionalProperties: false
+};
+export function parseAgentToolInput(input) {
+    const description = input.description;
+    if (typeof description !== "string" || !description.trim()) {
+        throw new Error("Agent tool requires a non-empty description");
+    }
+    const prompt = input.prompt;
+    if (typeof prompt !== "string" || !prompt.trim()) {
+        throw new Error("Agent tool requires a non-empty prompt");
+    }
+    const subagentType = input.subagent_type;
+    let parsedType = "general";
+    if (subagentType !== undefined) {
+        if (subagentType !== "general" && subagentType !== "explore" && subagentType !== "plan" && subagentType !== "verification") {
+            throw new Error("subagent_type must be general, explore, plan, or verification");
+        }
+        parsedType = subagentType;
+    }
+    const target = typeof input.target === "string" && input.target.trim() ? input.target.trim() : undefined;
+    return {
+        description: description.trim(),
+        prompt: prompt.trim(),
+        subagentType: parsedType,
+        runInBackground: typeof input.run_in_background === "boolean" ? input.run_in_background : false,
+        target
+    };
+}
+export function formatAgentToolResult(result) {
+    if (result.status === "running") {
+        return `Agent ${result.agentId} (${result.type}) is running in the background.\nUse TaskList to check progress.`;
+    }
+    if (result.status === "failed") {
+        return `Agent ${result.agentId} (${result.type}) failed: ${result.error ?? "unknown error"}`;
+    }
+    return result.result ?? "(no output)";
+}
+//# sourceMappingURL=agent-tool.js.map

package/dist/tools/agent-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tool.js","sourceRoot":"","sources":["../../src/tools/agent-tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuBH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wDAAwD,EAAE;QACtG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;QAC5E,aAAa,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC;YACpD,WAAW,EAAE,kCAAkC;SAChD;QACD,iBAAiB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,yCAAyC,EAAE;QAC9F,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8JAA8J;SAC5K;KACF;IACD,QAAQ,EAAE,CAAC,aAAa,EAAE,QAAQ,CAAC;IACnC,oBAAoB,EAAE,KAAK;CACM,CAAC;AAEpC,MAAM,UAAU,mBAAmB,CAAC,KAA8B;IAChE,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IACtC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,CAAC;IACzC,IAAI,UAAU,GAAiB,SAAS,CAAC;IACzC,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,MAAM,IAAI,YAAY,KAAK,cAAc,EAAE,CAAC;YAC3H,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QACnF,CAAC;QACD,UAAU,GAAG,YAAY,CAAC;IAC5B,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACzG,OAAO;QACL,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE;QAC/B,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;QACrB,YAAY,EAAE,UAAU;QACxB,eAAe,EAAE,OAAO,KAAK,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK;QAC/F,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAsB;IAC1D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,SAAS,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,IAAI,kEAAkE,CAAC;IACnH,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,SAAS,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,IAAI,aAAa,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC;IAC/F,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,IAAI,aAAa,CAAC;AACxC,CAAC"}

package/dist/tools/archive-create.d.ts

@@ -0,0 +1,35 @@
+export interface ArchiveCreateResult {
+    path: string;
+    format: string;
+    sizeBytes: number;
+    fileCount: number;
+}
+export declare const ArchiveCreateInputSchema: {
+    type: string;
+    properties: {
+        source: {
+            type: string;
+        };
+        output: {
+            type: string;
+        };
+        format: {
+            type: string;
+            enum: string[];
+        };
+    };
+    required: string[];
+    additionalProperties: boolean;
+};
+export declare function parseArchiveCreateInput(input: Record<string, unknown>): {
+    source: string;
+    output: string;
+    format: string;
+};
+export declare function executeArchiveCreate(input: {
+    source: string;
+    output: string;
+    format: string;
+    cwd: string;
+}): ArchiveCreateResult;
+export declare function formatArchiveCreateResult(result: ArchiveCreateResult): string;