@edwardlee5423/magi 0.1.0-alpha.0

package/dist/control/peer-client.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Client for talking to a remote Magi daemon's control API.
+ *
+ * Used to dispatch sub-agent tasks across machines: the local agent calls
+ * `dispatchToPeer` which creates a session on the peer, posts the prompt,
+ * streams the result back, and returns the final assistant message.
+ */
+import { DiscoveredPeer } from "./mdns.js";
+export interface PeerEndpoint {
+    /** e.g. "http://192.168.31.57:8765" */
+    baseUrl: string;
+    /** Device id for authenticating to the peer (from `magi pair` on the peer). */
+    deviceId?: string;
+    /** Bearer token for authenticating to the peer. */
+    token?: string;
+}
+export interface PeerDispatchResult {
+    sessionId: string;
+    jobId: string;
+    text: string;
+    events: Array<Record<string, unknown>>;
+    errorText?: string;
+}
+/** Resolve a peer name (mDNS instance name or hostname) to a base URL. */
+export declare function resolvePeerByName(name: string, options?: {
+    timeoutMs?: number;
+    /** Optional store to look up saved peer credentials before falling back to mDNS. */
+    store?: {
+        listMcpOAuthTokens(): Array<{
+            serverName: string;
+            metadata: Record<string, unknown>;
+            authServerUrl?: string;
+        }>;
+    };
+}): Promise<string | undefined>;
+/** List all discoverable peers. */
+export declare function listPeers(timeoutMs?: number): Promise<DiscoveredPeer[]>;
+/**
+ * Dispatch a prompt to a remote peer and wait for the final result.
+ * Streams events via SSE and aggregates assistant text.
+ */
+export declare function dispatchToPeer(input: {
+    peer: PeerEndpoint;
+    prompt: string;
+    cwd?: string;
+    modelAlias?: string;
+    signal?: AbortSignal;
+    onEvent?: (event: Record<string, unknown>) => void;
+}): Promise<PeerDispatchResult>;

package/dist/control/peer-client.js

@@ -0,0 +1,170 @@
+/**
+ * Client for talking to a remote Magi daemon's control API.
+ *
+ * Used to dispatch sub-agent tasks across machines: the local agent calls
+ * `dispatchToPeer` which creates a session on the peer, posts the prompt,
+ * streams the result back, and returns the final assistant message.
+ */
+import { browseMdns } from "./mdns.js";
+/** Resolve a peer name (mDNS instance name or hostname) to a base URL. */
+export async function resolvePeerByName(name, options = {}) {
+    // If it already looks like a URL, use it directly
+    if (/^https?:\/\//.test(name))
+        return name;
+    // If it's host:port, use it directly
+    if (/^[\w.-]+:\d+$/.test(name))
+        return `http://${name}`;
+    // Try saved peer credentials first (faster than mDNS, works without multicast)
+    if (options.store) {
+        const tokens = options.store.listMcpOAuthTokens();
+        const saved = tokens.find(t => t.serverName === `peer:${name}`);
+        if (saved) {
+            const url = saved.metadata?.peerUrl ?? saved.authServerUrl;
+            if (url)
+                return url;
+        }
+    }
+    // Otherwise, browse mDNS
+    const browser = browseMdns({});
+    await new Promise(resolve => setTimeout(resolve, options.timeoutMs ?? 2000));
+    const peers = browser.peers();
+    browser.stop();
+    const match = peers.find(p => p.instanceName === name ||
+        p.instanceName.startsWith(name) ||
+        p.hostname.startsWith(name) ||
+        p.hostname === `${name}.local.`);
+    return match ? `http://${match.address}:${match.port}` : undefined;
+}
+/** List all discoverable peers. */
+export async function listPeers(timeoutMs = 2500) {
+    const browser = browseMdns({});
+    await new Promise(resolve => setTimeout(resolve, timeoutMs));
+    const peers = browser.peers();
+    browser.stop();
+    return peers;
+}
+/** Make an authenticated request to a peer. */
+async function peerFetch(endpoint, path, init = {}) {
+    const headers = {
+        ...(init.headers ?? {})
+    };
+    if (endpoint.deviceId)
+        headers["X-Magi-Device-Id"] = endpoint.deviceId;
+    if (endpoint.token)
+        headers["Authorization"] = `Bearer ${endpoint.token}`;
+    return fetch(`${endpoint.baseUrl}${path}`, { ...init, headers });
+}
+/**
+ * Dispatch a prompt to a remote peer and wait for the final result.
+ * Streams events via SSE and aggregates assistant text.
+ */
+export async function dispatchToPeer(input) {
+    const events = [];
+    // 1. Create a session on the peer
+    const sessionResp = await peerFetch(input.peer, "/sessions", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            cwd: input.cwd ?? "/tmp",
+            title: input.prompt.slice(0, 80),
+            metadata: { source: "remote-dispatch" }
+        }),
+        signal: input.signal
+    });
+    if (!sessionResp.ok) {
+        const text = await sessionResp.text();
+        if (sessionResp.status === 401) {
+            throw new Error([
+                `Peer rejected the request: token is invalid or expired.`,
+                ``,
+                `Re-pair with the peer:`,
+                `  1. On the peer host: 'magi pair <name>'`,
+                `  2. Locally: 'magi peers add <name> <url> <device-id> <token>' with the new credentials`
+            ].join("\n"));
+        }
+        throw new Error(`Peer rejected session create (HTTP ${sessionResp.status}): ${text.slice(0, 200)}`);
+    }
+    const sessionEnvelope = await sessionResp.json();
+    const sessionId = sessionEnvelope.id ?? sessionEnvelope.session?.id;
+    if (!sessionId) {
+        throw new Error(`Peer session response missing id: ${JSON.stringify(sessionEnvelope).slice(0, 200)}`);
+    }
+    // 2. Post the message
+    const msgResp = await peerFetch(input.peer, `/sessions/${sessionId}/messages`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            prompt: input.prompt,
+            // Server reads `model` (not modelAlias). Send both for forward-compat.
+            model: input.modelAlias ?? "main",
+            modelAlias: input.modelAlias ?? "main"
+        }),
+        signal: input.signal
+    });
+    if (!msgResp.ok) {
+        const text = await msgResp.text();
+        throw new Error(`Peer rejected message post (${msgResp.status}): ${text.slice(0, 200)}`);
+    }
+    const msg = await msgResp.json();
+    const jobId = msg.jobId;
+    // If the peer returned a synchronous message (e.g. provider not configured),
+    // surface it directly instead of waiting for SSE.
+    if (!jobId && typeof msg.message === "string") {
+        return { sessionId, jobId: "", text: msg.message, events: [] };
+    }
+    if (!jobId) {
+        throw new Error(`Peer message response missing jobId: ${JSON.stringify(msg).slice(0, 200)}`);
+    }
+    // 3. Poll the events endpoint until the job completes.
+    // The control server returns {events: [...]} synchronously rather than SSE.
+    let assistantText = "";
+    let errorText;
+    const startTime = Date.now();
+    const timeoutMs = 5 * 60 * 1000; // 5 minute hard timeout
+    let lastEventCount = 0;
+    while (true) {
+        if (input.signal?.aborted)
+            throw new Error("Aborted");
+        if (Date.now() - startTime > timeoutMs) {
+            throw new Error(`Peer dispatch timed out after ${timeoutMs}ms`);
+        }
+        // Check job status
+        const jobResp = await peerFetch(input.peer, `/jobs/${jobId}`, { signal: input.signal });
+        if (!jobResp.ok) {
+            // Some servers return 404 until first event; tolerate briefly
+            await new Promise(resolve => setTimeout(resolve, 200));
+            continue;
+        }
+        const jobBody = await jobResp.json();
+        // Server wraps the job as { job: {...} }; tolerate either shape.
+        const job = jobBody.job ?? jobBody;
+        const status = job.status;
+        if (status === "completed" || status === "failed" || status === "cancelled") {
+            // Fetch all events
+            const eventsResp = await peerFetch(input.peer, `/jobs/${jobId}/events`, { signal: input.signal });
+            if (eventsResp.ok) {
+                const eventsBody = await eventsResp.json();
+                const eventList = eventsBody.events ?? [];
+                // Reverse to chronological order (server returns newest first)
+                const chronological = [...eventList].reverse();
+                for (const evt of chronological) {
+                    events.push(evt);
+                    input.onEvent?.(evt);
+                    const action = evt.action ?? evt.eventName;
+                    if (action === "agent.text.delta" && evt.metadata && typeof evt.metadata.preview === "string") {
+                        assistantText += evt.metadata.preview;
+                    }
+                }
+            }
+            if (status === "failed") {
+                const meta = (job.metadata ?? {});
+                errorText = typeof meta.error === "string" ? meta.error : "remote job failed";
+            }
+            break;
+        }
+        // Still running — wait briefly and poll again
+        await new Promise(resolve => setTimeout(resolve, 500));
+    }
+    return { sessionId, jobId, text: assistantText, events, errorText };
+}
+//# sourceMappingURL=peer-client.js.map

package/dist/control/peer-client.js.map

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

package/dist/control/server.d.ts

@@ -0,0 +1,30 @@
+import http from "node:http";
+import { MagiConfig } from "../config.js";
+import { MagiPaths, RuntimeSettings } from "../paths.js";
+import { SessionStore } from "../session-store.js";
+import { ActiveInteractionRegistry } from "../interactions.js";
+export interface ControlServerHandle {
+    server: http.Server;
+    url: string;
+    close: () => Promise<void>;
+    interactions: ActiveInteractionRegistry;
+}
+export declare function startControlServer(input: {
+    paths: MagiPaths;
+    runtime: RuntimeSettings;
+    config: MagiConfig;
+    store: SessionStore;
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<ControlServerHandle>;
+export declare function runDueCronJobs(input: {
+    paths: MagiPaths;
+    config: MagiConfig;
+    store: SessionStore;
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    now?: Date;
+}): Promise<{
+    cronJob: import("../tools/cron.js").CronJobRecord;
+    result: import("../headless.js").HeadlessResult;
+}[]>;