@edwardlee5423/magi 0.1.0-alpha.0

package/dist/interactions.js

@@ -0,0 +1,250 @@
+export class ActiveInteractionTimeoutError extends Error {
+    status = "timeout";
+    constructor(message) {
+        super(message);
+        this.name = "ActiveInteractionTimeoutError";
+    }
+}
+export class ActiveInteractionCancelledError extends Error {
+    status = "cancelled";
+    constructor(message) {
+        super(message);
+        this.name = "ActiveInteractionCancelledError";
+    }
+}
+export class ActiveInteractionNotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ActiveInteractionNotFoundError";
+    }
+}
+export class ActiveInteractionStateError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ActiveInteractionStateError";
+    }
+}
+export class ActiveInteractionRegistry {
+    defaultTimeoutMs;
+    activeJobs = new Map();
+    interactions = new Map();
+    constructor(input = {}) {
+        this.defaultTimeoutMs = input.timeoutMs ?? 300_000;
+    }
+    registerJob(input) {
+        this.activeJobs.set(input.jobId, {
+            sessionId: input.sessionId,
+            jobId: input.jobId,
+            createdAt: new Date().toISOString()
+        });
+    }
+    unregisterJob(jobId, reason = "job finished") {
+        for (const interaction of this.listInteractions({ jobId, status: "pending" })) {
+            this.cancelInteraction({
+                jobId,
+                toolUseId: interaction.toolUseId,
+                reason
+            });
+        }
+        this.activeJobs.delete(jobId);
+        for (const [key, interaction] of this.interactions) {
+            if (interaction.jobId === jobId) {
+                this.clearTimer(interaction);
+                this.interactions.delete(key);
+            }
+        }
+    }
+    isJobActive(jobId) {
+        return this.activeJobs.has(jobId);
+    }
+    listInteractions(input = {}) {
+        return [...this.interactions.values()]
+            .filter((interaction) => input.jobId ? interaction.jobId === input.jobId : true)
+            .filter((interaction) => input.status ? interaction.status === input.status : true)
+            .filter((interaction) => input.kind ? interaction.kind === input.kind : true)
+            .map(toView);
+    }
+    getInteraction(input) {
+        const interaction = this.interactions.get(this.key(input.jobId, input.toolUseId));
+        return interaction ? toView(interaction) : undefined;
+    }
+    getPendingQuestion(input) {
+        const interaction = this.getPending(input.jobId, input.toolUseId, "question");
+        return toView(interaction);
+    }
+    waitForApproval(input) {
+        this.ensureJob(input.sessionId, input.jobId);
+        const key = this.key(input.jobId, input.toolUse.id);
+        if (this.interactions.get(key)?.status === "pending") {
+            throw new ActiveInteractionStateError(`Interaction already pending for ${input.jobId}/${input.toolUse.id}`);
+        }
+        return new Promise((resolve, reject) => {
+            const now = new Date();
+            const timeoutMs = input.timeoutMs ?? this.defaultTimeoutMs;
+            const interaction = {
+                kind: "approval",
+                status: "pending",
+                sessionId: input.sessionId,
+                jobId: input.jobId,
+                toolUseId: input.toolUse.id,
+                toolName: input.toolUse.name,
+                createdAt: now.toISOString(),
+                updatedAt: now.toISOString(),
+                timeoutAt: new Date(now.getTime() + timeoutMs).toISOString(),
+                reason: input.reason,
+                toolUse: input.toolUse,
+                resolve,
+                reject
+            };
+            interaction.timer = this.createTimeoutTimer(interaction, timeoutMs);
+            this.interactions.set(key, interaction);
+        });
+    }
+    waitForQuestion(input) {
+        this.ensureJob(input.sessionId, input.jobId);
+        const key = this.key(input.jobId, input.toolUse.id);
+        if (this.interactions.get(key)?.status === "pending") {
+            throw new ActiveInteractionStateError(`Interaction already pending for ${input.jobId}/${input.toolUse.id}`);
+        }
+        return new Promise((resolve, reject) => {
+            const now = new Date();
+            const timeoutMs = input.timeoutMs ?? this.defaultTimeoutMs;
+            const interaction = {
+                kind: "question",
+                status: "pending",
+                sessionId: input.sessionId,
+                jobId: input.jobId,
+                toolUseId: input.toolUse.id,
+                toolName: input.toolUse.name,
+                createdAt: now.toISOString(),
+                updatedAt: now.toISOString(),
+                timeoutAt: new Date(now.getTime() + timeoutMs).toISOString(),
+                toolUse: input.toolUse,
+                question: input.question,
+                resolve,
+                reject
+            };
+            interaction.timer = this.createTimeoutTimer(interaction, timeoutMs);
+            this.interactions.set(key, interaction);
+        });
+    }
+    resolveApproval(input) {
+        const interaction = this.getPending(input.jobId, input.toolUseId, "approval");
+        if (interaction.kind !== "approval") {
+            throw new ActiveInteractionNotFoundError(`No active approval interaction for ${input.jobId}/${input.toolUseId}`);
+        }
+        interaction.status = "resolved";
+        interaction.updatedAt = new Date().toISOString();
+        interaction.approved = input.approved;
+        this.clearTimer(interaction);
+        interaction.resolve(input.approved);
+        return toView(interaction);
+    }
+    resolveQuestion(input) {
+        const interaction = this.getPending(input.jobId, input.toolUseId, "question");
+        if (interaction.kind !== "question") {
+            throw new ActiveInteractionNotFoundError(`No active question interaction for ${input.jobId}/${input.toolUseId}`);
+        }
+        interaction.status = "resolved";
+        interaction.updatedAt = new Date().toISOString();
+        interaction.answer = input.answer;
+        this.clearTimer(interaction);
+        interaction.resolve(input.answer);
+        return toView(interaction);
+    }
+    cancelInteraction(input) {
+        const interaction = this.getPending(input.jobId, input.toolUseId);
+        this.cancelPendingInteraction(interaction, input.reason);
+        return toView(interaction);
+    }
+    close(reason = "registry closed") {
+        for (const interaction of this.interactions.values()) {
+            if (interaction.status === "pending") {
+                this.cancelPendingInteraction(interaction, reason);
+            }
+            else {
+                this.clearTimer(interaction);
+            }
+        }
+        this.activeJobs.clear();
+        this.interactions.clear();
+    }
+    ensureJob(sessionId, jobId) {
+        if (!this.activeJobs.has(jobId)) {
+            this.registerJob({ sessionId, jobId });
+        }
+    }
+    createTimeoutTimer(interaction, timeoutMs) {
+        if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+            return undefined;
+        }
+        const timer = setTimeout(() => {
+            if (interaction.status !== "pending") {
+                return;
+            }
+            interaction.status = "timeout";
+            interaction.updatedAt = new Date().toISOString();
+            interaction.reject(new ActiveInteractionTimeoutError(`Interaction ${interaction.jobId}/${interaction.toolUseId} timed out`));
+        }, timeoutMs);
+        timer.unref?.();
+        return timer;
+    }
+    getPending(jobId, toolUseId, kind) {
+        const interaction = this.interactions.get(this.key(jobId, toolUseId));
+        if (!interaction) {
+            throw new ActiveInteractionNotFoundError(`No active interaction for ${jobId}/${toolUseId}`);
+        }
+        if (kind && interaction.kind !== kind) {
+            throw new ActiveInteractionNotFoundError(`No active ${kind} interaction for ${jobId}/${toolUseId}`);
+        }
+        if (interaction.status !== "pending") {
+            throw new ActiveInteractionStateError(`Interaction ${jobId}/${toolUseId} is ${interaction.status}`);
+        }
+        return interaction;
+    }
+    clearTimer(interaction) {
+        if (interaction.timer) {
+            clearTimeout(interaction.timer);
+            interaction.timer = undefined;
+        }
+    }
+    cancelPendingInteraction(interaction, reason) {
+        interaction.status = "cancelled";
+        interaction.updatedAt = new Date().toISOString();
+        interaction.cancelReason = reason;
+        this.clearTimer(interaction);
+        interaction.reject(new ActiveInteractionCancelledError(`Interaction ${interaction.jobId}/${interaction.toolUseId} was cancelled${reason ? `: ${reason}` : ""}`));
+    }
+    key(jobId, toolUseId) {
+        return `${jobId}\0${toolUseId}`;
+    }
+}
+export function interactionErrorStatus(error) {
+    if (error instanceof ActiveInteractionTimeoutError) {
+        return "timeout";
+    }
+    if (error instanceof ActiveInteractionCancelledError) {
+        return "cancelled";
+    }
+    return undefined;
+}
+function toView(interaction) {
+    return {
+        kind: interaction.kind,
+        status: interaction.status,
+        sessionId: interaction.sessionId,
+        jobId: interaction.jobId,
+        toolUseId: interaction.toolUseId,
+        toolName: interaction.toolName,
+        createdAt: interaction.createdAt,
+        updatedAt: interaction.updatedAt,
+        timeoutAt: interaction.timeoutAt,
+        reason: interaction.reason,
+        toolUse: interaction.toolUse,
+        question: interaction.kind === "question" ? interaction.question : undefined,
+        approved: interaction.approved,
+        answer: interaction.answer,
+        cancelReason: interaction.cancelReason
+    };
+}
+//# sourceMappingURL=interactions.js.map

package/dist/interactions.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Structured JSON-line logger with size-based rotation.
+ *
+ * Each log entry is one JSON object per line:
+ *   {"ts":"2026-05-19T10:00:00Z","level":"info","msg":"...","ctx":{...}}
+ *
+ * When the active file exceeds `maxBytes`, it's renamed to `<file>.1` and a
+ * fresh file is opened. We keep up to `maxFiles` total (rotated files
+ * `.1` ... `.N`, oldest dropped).
+ *
+ * Errors during logging are deliberately swallowed — logging must never crash
+ * the agent.
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface LoggerOptions {
+    /** Path to the active log file. */
+    filePath: string;
+    /** Roll the file when it exceeds this many bytes. Default 5 MB. */
+    maxBytes?: number;
+    /** Keep this many rotated files (.1 ... .N). Default 5. */
+    maxFiles?: number;
+    /** Minimum level to write. Default "info". */
+    level?: LogLevel;
+}
+export interface Logger {
+    debug(msg: string, ctx?: Record<string, unknown>): void;
+    info(msg: string, ctx?: Record<string, unknown>): void;
+    warn(msg: string, ctx?: Record<string, unknown>): void;
+    error(msg: string, ctx?: Record<string, unknown>): void;
+    close(): void;
+}
+export declare function createJsonLogger(options: LoggerOptions): Logger;

package/dist/logger.js

@@ -0,0 +1,115 @@
+/**
+ * Structured JSON-line logger with size-based rotation.
+ *
+ * Each log entry is one JSON object per line:
+ *   {"ts":"2026-05-19T10:00:00Z","level":"info","msg":"...","ctx":{...}}
+ *
+ * When the active file exceeds `maxBytes`, it's renamed to `<file>.1` and a
+ * fresh file is opened. We keep up to `maxFiles` total (rotated files
+ * `.1` ... `.N`, oldest dropped).
+ *
+ * Errors during logging are deliberately swallowed — logging must never crash
+ * the agent.
+ */
+import { closeSync, existsSync, mkdirSync, openSync, renameSync, statSync, unlinkSync, writeSync } from "node:fs";
+import path from "node:path";
+const LEVEL_ORDER = { debug: 0, info: 1, warn: 2, error: 3 };
+export function createJsonLogger(options) {
+    const filePath = options.filePath;
+    const maxBytes = options.maxBytes ?? 5 * 1024 * 1024;
+    const maxFiles = options.maxFiles ?? 5;
+    const minLevel = options.level ?? "info";
+    const minThreshold = LEVEL_ORDER[minLevel];
+    // Ensure parent dir exists
+    try {
+        mkdirSync(path.dirname(filePath), { recursive: true });
+    }
+    catch { }
+    let fd;
+    let bytesWritten = currentSize(filePath);
+    function open() {
+        if (fd !== undefined)
+            return fd;
+        fd = openSync(filePath, "a", 0o644);
+        return fd;
+    }
+    function rotateIfNeeded() {
+        if (bytesWritten < maxBytes)
+            return;
+        if (fd !== undefined) {
+            try {
+                closeSync(fd);
+            }
+            catch { }
+            fd = undefined;
+        }
+        // Shift .N → .N+1, drop oldest
+        for (let i = maxFiles - 1; i >= 1; i--) {
+            const src = `${filePath}.${i}`;
+            const dst = `${filePath}.${i + 1}`;
+            if (existsSync(src)) {
+                if (i + 1 > maxFiles) {
+                    try {
+                        unlinkSync(src);
+                    }
+                    catch { }
+                }
+                else {
+                    try {
+                        renameSync(src, dst);
+                    }
+                    catch { }
+                }
+            }
+        }
+        if (existsSync(filePath)) {
+            try {
+                renameSync(filePath, `${filePath}.1`);
+            }
+            catch { }
+        }
+        bytesWritten = 0;
+    }
+    function write(level, msg, ctx) {
+        if (LEVEL_ORDER[level] < minThreshold)
+            return;
+        try {
+            const entry = ctx
+                ? { ts: new Date().toISOString(), level, msg, ctx }
+                : { ts: new Date().toISOString(), level, msg };
+            const line = JSON.stringify(entry) + "\n";
+            const buf = Buffer.from(line, "utf8");
+            rotateIfNeeded();
+            const handle = open();
+            writeSync(handle, buf, 0, buf.length);
+            bytesWritten += buf.length;
+        }
+        catch {
+            // Logging must never throw
+        }
+    }
+    return {
+        debug: (msg, ctx) => write("debug", msg, ctx),
+        info: (msg, ctx) => write("info", msg, ctx),
+        warn: (msg, ctx) => write("warn", msg, ctx),
+        error: (msg, ctx) => write("error", msg, ctx),
+        close: () => {
+            if (fd !== undefined) {
+                try {
+                    closeSync(fd);
+                }
+                catch { }
+                fd = undefined;
+            }
+        }
+    };
+}
+function currentSize(p) {
+    try {
+        return statSync(p).size;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/markdown.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Streaming markdown renderer for terminal output.
+ * Buffers code blocks, renders inline markdown immediately.
+ */
+export interface StreamingMarkdownRenderer {
+    /** Push a text delta. Returns ANSI string to write to terminal. */
+    push(delta: string): string;
+    /** Flush any remaining buffered content. Returns ANSI string. */
+    flush(): string;
+}
+export interface MarkdownOptions {
+    /** Total terminal columns. Defaults to stdout.columns or 80. */
+    columns?: number;
+    /** Disable syntax highlighting (e.g. for non-color terminals). */
+    noHighlight?: boolean;
+}
+export declare function createStreamingMarkdown(options?: MarkdownOptions): StreamingMarkdownRenderer;
+export declare function renderCodeBlock(lines: string[], lang: string, options?: MarkdownOptions): string;