@edwardlee5423/magi 0.1.0-alpha.0

package/dist/runner/client.js

@@ -0,0 +1,175 @@
+import { spawn } from "node:child_process";
+import readline from "node:readline";
+import { MagiUsageError } from "../errors.js";
+export class RunnerClient {
+    input;
+    child;
+    lines;
+    nextId = 1;
+    pending = new Map();
+    constructor(input) {
+        this.input = input;
+        this.child = spawn(input.command.command, input.command.args, {
+            env: { ...process.env, ...input.env },
+            stdio: ["pipe", "pipe", "pipe"]
+        });
+        this.lines = readline.createInterface({ input: this.child.stdout });
+        this.lines.on("line", (line) => this.handleLine(line));
+        this.child.on("error", (error) => this.rejectAll(error));
+        this.child.on("exit", (code) => {
+            this.rejectAll(new Error(`magi-runner exited with code ${code}`));
+        });
+    }
+    async initialize() {
+        const result = await this.request("initialize", {});
+        if (!isRecord(result) || typeof result.runner !== "string" || typeof result.version !== "string") {
+            throw new MagiUsageError("magi-runner initialize returned an invalid response");
+        }
+        return {
+            runner: result.runner,
+            version: result.version,
+            capabilities: Array.isArray(result.capabilities)
+                ? result.capabilities.filter((capability) => typeof capability === "string")
+                : []
+        };
+    }
+    async ping() {
+        const result = await this.request("ping", {});
+        if (!isRecord(result) || result.ok !== true) {
+            throw new MagiUsageError("magi-runner ping returned an invalid response");
+        }
+        return { ok: true };
+    }
+    async echo(text) {
+        const result = await this.request("echo", { text });
+        if (!isRecord(result) || typeof result.text !== "string") {
+            throw new MagiUsageError("magi-runner echo returned an invalid response");
+        }
+        return result.text;
+    }
+    async runProcess(input) {
+        const result = await this.request("process.run", {
+            command: input.command,
+            cwd: input.cwd,
+            timeoutMs: input.timeoutMs ?? 30_000
+        });
+        if (!isRunnerProcessResult(result)) {
+            throw new MagiUsageError("magi-runner process.run returned an invalid response");
+        }
+        return result;
+    }
+    async ptySmoke() {
+        const result = await this.request("pty.smoke", {});
+        if (!isRecord(result) || typeof result.ok !== "boolean" || typeof result.stdout !== "string" || typeof result.stderr !== "string") {
+            throw new MagiUsageError("magi-runner pty.smoke returned an invalid response");
+        }
+        return {
+            ok: result.ok,
+            stdout: result.stdout,
+            stderr: result.stderr
+        };
+    }
+    async applyPatch(input) {
+        const result = await this.request("file.applyPatch", {
+            cwd: input.cwd,
+            filePath: input.filePath,
+            content: input.content,
+            approved: input.approved
+        });
+        if (!isRunnerApplyPatchResult(result)) {
+            throw new MagiUsageError("magi-runner file.applyPatch returned an invalid response");
+        }
+        return result;
+    }
+    close() {
+        this.lines.close();
+        this.child.kill("SIGTERM");
+    }
+    request(method, params) {
+        const id = this.nextId++;
+        const payload = JSON.stringify({ jsonrpc: "2.0", id, method, params });
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+            this.child.stdin.write(`${payload}\n`, "utf8");
+        });
+    }
+    handleLine(line) {
+        let message;
+        try {
+            message = JSON.parse(line);
+        }
+        catch {
+            return;
+        }
+        if (!isRecord(message) || typeof message.id !== "number") {
+            return;
+        }
+        const pending = this.pending.get(message.id);
+        if (!pending) {
+            return;
+        }
+        this.pending.delete(message.id);
+        if (message.error) {
+            pending.reject(new MagiUsageError(readJsonRpcError(message.error)));
+            return;
+        }
+        pending.resolve(message.result);
+    }
+    rejectAll(error) {
+        for (const pending of this.pending.values()) {
+            pending.reject(error);
+        }
+        this.pending.clear();
+    }
+}
+export function resolveRunnerCommand(env = process.env) {
+    return {
+        command: env.MAGI_RUNNER_BIN ?? "magi-runner",
+        args: parseRunnerArgs(env.MAGI_RUNNER_ARGS)
+    };
+}
+function parseRunnerArgs(value) {
+    if (!value) {
+        return [];
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        throw new MagiUsageError("MAGI_RUNNER_ARGS must be a JSON string array");
+    }
+    if (!Array.isArray(parsed) || !parsed.every((item) => typeof item === "string")) {
+        throw new MagiUsageError("MAGI_RUNNER_ARGS must be a JSON string array");
+    }
+    return parsed;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readJsonRpcError(value) {
+    if (isRecord(value) && typeof value.message === "string") {
+        return value.message;
+    }
+    return JSON.stringify(value);
+}
+function isRunnerProcessResult(value) {
+    return isRecord(value)
+        && typeof value.command === "string"
+        && typeof value.cwd === "string"
+        && (typeof value.exitCode === "number" || value.exitCode === null)
+        && typeof value.stdout === "string"
+        && typeof value.stderr === "string"
+        && typeof value.timedOut === "boolean";
+}
+function isRunnerApplyPatchResult(value) {
+    return isRecord(value)
+        && typeof value.path === "string"
+        && typeof value.diff === "string"
+        && value.approved === true
+        && isRecord(value.auditEvent)
+        && typeof value.auditEvent.action === "string"
+        && (typeof value.auditEvent.target === "string" || value.auditEvent.target === undefined)
+        && (isRecord(value.auditEvent.metadata) || value.auditEvent.metadata === undefined);
+}
+//# sourceMappingURL=client.js.map

package/dist/runner/client.js.map

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

package/dist/session-store.d.ts

@@ -0,0 +1,250 @@
+import { MagiPaths } from "./paths.js";
+export interface SessionRecord {
+    id: string;
+    title: string | null;
+    cwd: string;
+    createdAt: string;
+    updatedAt: string;
+    metadata: Record<string, unknown>;
+    messages: MessageRecord[];
+}
+export interface MessageRecord {
+    id: number;
+    sessionId: string;
+    role: string;
+    content: string;
+    createdAt: string;
+    metadata: Record<string, unknown>;
+}
+export interface JobRecord {
+    id: string;
+    sessionId: string;
+    kind: string;
+    status: string;
+    metadata?: Record<string, unknown>;
+}
+export interface StoredJobRecord extends JobRecord {
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AuditRecord {
+    sessionId: string;
+    jobId?: string;
+    action: string;
+    target?: string;
+    metadata?: Record<string, unknown>;
+}
+export type StoredAuditRecord = AuditRecord & {
+    id: number;
+    createdAt: string;
+};
+export type AuditEventSubscriber = (event: StoredAuditRecord) => void;
+export interface UsageRecord {
+    sessionId: string;
+    provider: string;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    costUsd: number;
+    metadata?: Record<string, unknown>;
+}
+export interface DeviceRecord {
+    id: string;
+    name: string;
+    tokenHash: string;
+    createdAt: string;
+    expiresAt: string;
+    metadata: Record<string, unknown>;
+}
+export type AgentRole = "explorer" | "worker";
+export interface AgentTaskRecord {
+    id: string;
+    role: AgentRole;
+    prompt: string;
+    status: "queued" | "running" | "completed" | "cancelled" | "failed";
+    cwd: string;
+    sessionId: string | null;
+    result: string | null;
+    createdAt: string;
+    updatedAt: string;
+    metadata: Record<string, unknown>;
+}
+export interface WriteClaimRecord {
+    id: number;
+    taskId: string;
+    filePath: string;
+    ownerRole: string;
+    createdAt: string;
+}
+export interface ContextSummaryRecord {
+    id: string;
+    sessionId: string;
+    summary: string;
+    sourceMessageCount: number;
+    createdAt: string;
+    metadata: Record<string, unknown>;
+}
+export interface McpOAuthTokenRecord {
+    serverName: string;
+    accessToken: string;
+    refreshToken?: string;
+    tokenType: string;
+    expiresAt?: string;
+    scope?: string;
+    authServerUrl?: string;
+    clientId?: string;
+    createdAt: string;
+    updatedAt: string;
+    metadata: Record<string, unknown>;
+}
+export interface SessionSummary {
+    id: string;
+    title: string | null;
+    cwd: string;
+    createdAt: string;
+    updatedAt: string;
+    messageCount: number;
+}
+export declare class SessionStore {
+    private readonly db;
+    private readonly auditSubscribers;
+    constructor(dbFile: string);
+    static open(paths: MagiPaths): SessionStore;
+    close(): void;
+    createSession(input: {
+        id?: string;
+        title?: string;
+        cwd: string;
+        metadata?: Record<string, unknown>;
+    }): string;
+    appendMessage(input: {
+        sessionId: string;
+        role: string;
+        content: string;
+        metadata?: Record<string, unknown>;
+    }): number;
+    getSession(sessionId: string): SessionRecord | undefined;
+    /** Update a session's title. Returns true if the session existed. */
+    renameSession(sessionId: string, title: string): boolean;
+    /**
+     * Merge keys into a session's metadata JSON. Set a key to undefined to remove it.
+     * Returns true if the session existed.
+     */
+    updateSessionMetadata(sessionId: string, partial: Record<string, unknown>): boolean;
+    /** Delete a session and all its messages. Returns true if the session existed. */
+    deleteSession(sessionId: string): boolean;
+    /**
+     * Drop all messages in a session whose ID is greater than the given message ID.
+     * Used by /rewind to remove the last assistant turn (and any subsequent messages).
+     * Returns the count of removed messages.
+     */
+    truncateMessagesAfter(sessionId: string, messageId: number): number;
+    /**
+     * Fork a session: copies all messages up to (and including) maxMessageId into
+     * a new session. If maxMessageId is omitted, copies all messages.
+     * Returns the new session id.
+     */
+    forkSession(input: {
+        sessionId: string;
+        title?: string;
+        maxMessageId?: number;
+    }): string | undefined;
+    getMostRecentSession(cwd?: string): SessionRecord | undefined;
+    listSessions(limit?: number): SessionSummary[];
+    recordJob(input: JobRecord): void;
+    updateJobStatus(input: {
+        id: string;
+        status: string;
+        metadata?: Record<string, unknown>;
+    }): void;
+    getJob(jobId: string): StoredJobRecord | undefined;
+    listJobs(limit?: number): StoredJobRecord[];
+    recordAudit(input: AuditRecord): StoredAuditRecord;
+    listAuditEvents(limit?: number): StoredAuditRecord[];
+    listSessionAuditEvents(sessionId: string, limit?: number): StoredAuditRecord[];
+    listJobAuditEvents(jobId: string, limit?: number): StoredAuditRecord[];
+    listRecentAuditEvents(input?: {
+        sessionId?: string;
+        jobId?: string;
+        afterId?: number;
+        limit?: number;
+        order?: "asc" | "desc";
+    }): StoredAuditRecord[];
+    subscribeAuditEvents(subscriber: AuditEventSubscriber): () => void;
+    recordUsage(input: UsageRecord): void;
+    listSessionUsage(sessionId: string): Array<{
+        provider: string;
+        model: string;
+        inputTokens: number;
+        outputTokens: number;
+        costUsd: number;
+        createdAt: string;
+    }>;
+    listAllUsage(limit?: number): Array<{
+        sessionId: string;
+        provider: string;
+        model: string;
+        inputTokens: number;
+        outputTokens: number;
+        costUsd: number;
+        createdAt: string;
+    }>;
+    countRows(table: "jobs" | "audit_events" | "usage_events"): number;
+    upsertDevice(input: {
+        id: string;
+        name: string;
+        tokenHash: string;
+        expiresAt: string;
+        metadata?: Record<string, unknown>;
+    }): void;
+    getDevice(deviceId: string): DeviceRecord | undefined;
+    listDevices(): DeviceRecord[];
+    createAgentTask(input: {
+        id?: string;
+        role: AgentRole;
+        prompt: string;
+        cwd: string;
+        sessionId?: string;
+        metadata?: Record<string, unknown>;
+    }): string;
+    updateAgentTask(input: {
+        id: string;
+        status: AgentTaskRecord["status"];
+        result?: string | null;
+        metadata?: Record<string, unknown>;
+    }): void;
+    getAgentTask(taskId: string): AgentTaskRecord | undefined;
+    listAgentTasks(limit?: number): AgentTaskRecord[];
+    claimWriteFile(input: {
+        taskId: string;
+        filePath: string;
+        ownerRole: string;
+    }): WriteClaimRecord;
+    listWriteClaims(): WriteClaimRecord[];
+    recordContextSummary(input: {
+        id?: string;
+        sessionId: string;
+        summary: string;
+        sourceMessageCount: number;
+        metadata?: Record<string, unknown>;
+    }): ContextSummaryRecord;
+    getLatestContextSummary(sessionId: string): ContextSummaryRecord | undefined;
+    listContextSummaries(sessionId: string): ContextSummaryRecord[];
+    private touchSession;
+    private publishAuditEvent;
+    upsertMcpOAuthToken(input: {
+        serverName: string;
+        accessToken: string;
+        refreshToken?: string;
+        tokenType?: string;
+        expiresAt?: string;
+        scope?: string;
+        authServerUrl?: string;
+        clientId?: string;
+        metadata?: Record<string, unknown>;
+    }): void;
+    getMcpOAuthToken(serverName: string): McpOAuthTokenRecord | undefined;
+    deleteMcpOAuthToken(serverName: string): void;
+    listMcpOAuthTokens(): McpOAuthTokenRecord[];
+    private migrate;
+}