@edwardlee5423/magi 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Magi Next contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,184 @@
+# Magi Next
+
+A TypeScript-first AI coding agent for the terminal. Run a smart agent locally,
+control it from your phone over the LAN, dispatch sub-agents to peer machines.
+
+```
+$ magi
+  △   Magi · 60 tools
+ /✦\  cwd: ~/code/my-project
+▔▔▔   model: sonnet
+
+  /help for commands · Ctrl+C to interrupt · /exit to quit
+
+> refactor src/auth.ts to use the new session API
+```
+
+## Quick start
+
+```sh
+# Install (once)
+npm install -g @magi/cli
+
+# Set your provider key
+export ANTHROPIC_AUTH_TOKEN="<your-key>"
+
+# Configure (interactive)
+magi init
+
+# Use it
+magi                            # Interactive TUI
+magi -p "explain this repo"     # One-shot prompt
+```
+
+If you don't set a key first, `magi init` will tell you which env var to set
+and bail out cleanly.
+
+## What it does well
+
+- **Real agent loop with parallel tool calls** — file ops, shell, git, web,
+  MCP servers, sub-agents.
+- **Smart routing** — `/model auto` picks haiku for simple questions,
+  sonnet for code, opus for planning. Routes by 10 task kinds.
+- **Plan mode** — `EnterPlanMode` for non-trivial work, ask for approval
+  before implementing.
+- **Cross-machine agents** — discover other Magi daemons via mDNS, dispatch
+  sub-agents with `target: 'peer-name'`.
+- **Mobile control** — start a daemon, scan a QR-able URL, run prompts from
+  your phone.
+- **Persistent memory** — durable facts written to `~/.magi-next/memdir/`
+  auto-load into future sessions.
+- **Skills** — bundled `verify` / `debug` / `stuck` / `commit-msg` /
+  `review-pr`. Add your own by dropping a `SKILL.md` file.
+
+## Five-minute tutorial
+
+```sh
+magi tutorial
+```
+
+Walks through 8 sections (basics, models, files, sessions, skills, memory,
+multi-machine, sub-agents). Press `q` to quit early.
+
+## Common commands
+
+| Command                    | What it does                              |
+|---------------------------|-------------------------------------------|
+| `magi`                    | Start interactive TUI                     |
+| `magi -p "<prompt>"`       | One-shot prompt, stream output            |
+| `magi init`               | Interactive provider setup                |
+| `magi doctor`             | Show config + paths                       |
+| `magi sessions`           | List recent sessions                      |
+| `magi resume <id>`        | Resume a session                          |
+| `magi ps`                 | List recent jobs                          |
+| `magi logs <job-id>`      | Show events for a job                     |
+| `magi daemon start`       | Run control API in background             |
+| `magi pair <name>`        | Generate a token for phone access         |
+| `magi peers`              | Discover Magi daemons on the LAN          |
+| `magi tutorial`           | Walkthrough                               |
+
+Inside the TUI, type `/help` to list slash commands. Type `/help <name>` for
+details on one.
+
+## Configuration
+
+`~/.magi-next/config.yaml`:
+
+```yaml
+providers:
+  anthropic:
+    type: messages-compatible
+    format: anthropic-messages
+    apiKeyEnv: ANTHROPIC_AUTH_TOKEN
+    baseUrl: https://api.anthropic.com
+    defaultModel: claude-sonnet-4-6
+models:
+  aliases:
+    fast:   anthropic:claude-haiku-4-5
+    main:   anthropic:claude-sonnet-4-6
+    review: anthropic:claude-sonnet-4-6
+    deep:   anthropic:claude-opus-4-7
+  router:               # used when alias = "auto"
+    fast:   { family: claude, role: haiku,  contextWindow: 200000, supportsVision: true }
+    main:   { family: claude, role: sonnet, contextWindow: 200000, supportsVision: true }
+    deep:   { family: claude, role: opus,   contextWindow: 200000, supportsVision: true }
+```
+
+Run `magi init` to generate a working config and skip the manual yaml.
+
+## Cross-machine setup
+
+```sh
+# On each machine you want to use:
+MAGI_CONTROL_BIND=0.0.0.0 magi daemon start
+
+# On your "main" machine, see who's around:
+magi peers
+
+# Pair another machine (run on the peer to get a token):
+magi pair from-peer
+# → outputs a Device ID + Token
+
+# On main, save the credentials:
+magi peers add peer-2 http://192.168.1.50:8765 <device-id> <token>
+
+# Now in the TUI, the agent can dispatch to peer-2:
+> compare the auth modules in this repo and the one on peer-2
+```
+
+The agent uses the `Agent` tool with `target: "peer-2"` to dispatch
+sub-agents. Multiple targets in the same response run in parallel.
+
+## Phone access
+
+```sh
+magi pair my-phone
+# → prints a URL like http://192.168.1.10:8765/panel?device=...&token=...
+```
+
+Open that URL on your phone. The web panel is mobile-optimized (touch UI,
+swipeable session list, dark mode).
+
+## Documentation
+
+- [TROUBLESHOOTING.md](TROUBLESHOOTING.md) — common errors and fixes
+- [ARCHITECTURE.md](ARCHITECTURE.md) — concepts and component map
+- `magi tutorial` — interactive walkthrough
+
+## State and isolation
+
+Everything lives at `~/.magi-next/` by default:
+
+```
+~/.magi-next/
+  config.yaml          # provider + model setup
+  state/sessions.sqlite  # persisted sessions, jobs, audit, memory
+  memdir/              # typed long-term memory (user/feedback/project/reference)
+  skills/<name>/SKILL.md
+  logs/                # daemon logs
+  cache/
+  plugins/
+  devices/
+```
+
+Override the root with `MAGI_CONFIG_DIR=/path` for testing or sandboxing.
+
+## Building from source
+
+```sh
+git clone <this-repo>
+cd magi-next
+npm install
+npm run build
+npm test
+```
+
+Requires Node ≥ 20.
+
+## Status
+
+Active development. The core (agent loop, routing, MCP, daemon, multi-machine,
+mobile panel) is solid and tested. Beta-quality. We use it daily to build
+itself.
+
+Filing bugs: open a GitHub issue with output of `magi doctor` and `magi --version`.

package/dist/agent/headless-agent.d.ts

@@ -0,0 +1,15 @@
+import { LocalAction } from "./local-plan.js";
+import { SessionStore } from "../session-store.js";
+export interface LocalAgentResult {
+    handled: boolean;
+    output?: string;
+    actions?: LocalAction[];
+}
+export declare function runLocalHeadlessAgent(input: {
+    prompt: string;
+    cwd: string;
+    sessionId: string;
+    jobId: string;
+    store: SessionStore;
+    env?: NodeJS.ProcessEnv;
+}): Promise<LocalAgentResult>;

package/dist/agent/headless-agent.js

@@ -0,0 +1,105 @@
+import { parseLocalPlan } from "./local-plan.js";
+import { readWorkspaceFile, writeWorkspaceFile } from "../tools/files.js";
+import { getGitSummary } from "../tools/git.js";
+import { searchWorkspace } from "../tools/search.js";
+import { runShellCommand } from "../tools/shell.js";
+export async function runLocalHeadlessAgent(input) {
+    const plan = parseLocalPlan(input.prompt);
+    if (!plan) {
+        return { handled: false };
+    }
+    const observations = [];
+    input.store.recordAudit({
+        sessionId: input.sessionId,
+        jobId: input.jobId,
+        action: "agent.plan.created",
+        target: "local-headless",
+        metadata: { actions: plan.actions }
+    });
+    for (const action of plan.actions) {
+        observations.push(await runAction({ ...input, action }));
+    }
+    return {
+        handled: true,
+        output: observations.join("\n"),
+        actions: plan.actions
+    };
+}
+async function runAction(input) {
+    if (input.action.type === "read-file") {
+        const result = readWorkspaceFile({ cwd: input.cwd, filePath: input.action.filePath });
+        input.store.recordAudit({
+            sessionId: input.sessionId,
+            jobId: input.jobId,
+            action: "tool.file.read",
+            target: result.path,
+            metadata: { sizeBytes: result.sizeBytes }
+        });
+        return `Read ${result.path} (${result.sizeBytes} bytes)\n${result.content}`;
+    }
+    if (input.action.type === "write-file") {
+        const result = writeWorkspaceFile({
+            cwd: input.cwd,
+            filePath: input.action.filePath,
+            content: input.action.content,
+            approved: true
+        });
+        input.store.recordAudit({
+            sessionId: input.sessionId,
+            jobId: input.jobId,
+            action: "tool.file.write.approved",
+            target: result.path,
+            metadata: { diff: result.diff, approved: result.approved }
+        });
+        return `Wrote ${result.path}\n${result.diff}`;
+    }
+    if (input.action.type === "search") {
+        const matches = searchWorkspace({ cwd: input.cwd, query: input.action.query });
+        input.store.recordAudit({
+            sessionId: input.sessionId,
+            jobId: input.jobId,
+            action: "tool.search",
+            target: input.action.query,
+            metadata: { matches: matches.length }
+        });
+        return matches.length === 0
+            ? `No matches for ${JSON.stringify(input.action.query)}`
+            : matches.map((match) => `${match.path}:${match.line}:${match.text}`).join("\n");
+    }
+    if (input.action.type === "shell") {
+        const result = await runShellCommand({
+            cwd: input.cwd,
+            command: input.action.command,
+            approveDangerous: input.env?.MAGI_APPROVE_DANGEROUS_COMMANDS === "1"
+        });
+        input.store.recordAudit({
+            sessionId: input.sessionId,
+            jobId: input.jobId,
+            action: "tool.shell.run",
+            target: input.action.command,
+            metadata: { exitCode: result.exitCode, timedOut: result.timedOut }
+        });
+        return [
+            `Command exited ${result.exitCode}`,
+            result.stdout ? `stdout:\n${result.stdout.trimEnd()}` : undefined,
+            result.stderr ? `stderr:\n${result.stderr.trimEnd()}` : undefined
+        ].filter((line) => Boolean(line)).join("\n");
+    }
+    const git = getGitSummary(input.cwd);
+    input.store.recordAudit({
+        sessionId: input.sessionId,
+        jobId: input.jobId,
+        action: "tool.git.summary",
+        target: input.cwd,
+        metadata: { ...git }
+    });
+    if (!git.gitAvailable || !git.isRepository) {
+        return git.reason ?? "Git summary is unavailable";
+    }
+    return [
+        `branch: ${git.branch}`,
+        git.status ? `status:\n${git.status}` : "status: clean",
+        git.diffStat ? `diffStat:\n${git.diffStat}` : "diffStat: none"
+    ].join("\n");
+}
+//# sourceMappingURL=headless-agent.js.map

package/dist/agent/headless-agent.js.map

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

package/dist/agent/local-plan.d.ts

@@ -0,0 +1,20 @@
+export type LocalAction = {
+    type: "read-file";
+    filePath: string;
+} | {
+    type: "write-file";
+    filePath: string;
+    content: string;
+} | {
+    type: "search";
+    query: string;
+} | {
+    type: "shell";
+    command: string;
+} | {
+    type: "git-status";
+};
+export interface LocalPlan {
+    actions: LocalAction[];
+}
+export declare function parseLocalPlan(prompt: string): LocalPlan | undefined;

package/dist/agent/local-plan.js

@@ -0,0 +1,30 @@
+export function parseLocalPlan(prompt) {
+    const text = prompt.trim();
+    const write = /^(?:create|write) file (?:"([^"]+)"|(\S+)) with content (?:"([\s\S]*)"|([\s\S]*))$/i.exec(text);
+    if (write) {
+        return {
+            actions: [{
+                    type: "write-file",
+                    filePath: write[1] ?? write[2],
+                    content: write[3] ?? write[4] ?? ""
+                }]
+        };
+    }
+    const read = /^read file (?:"([^"]+)"|(\S+))$/i.exec(text);
+    if (read) {
+        return { actions: [{ type: "read-file", filePath: read[1] ?? read[2] }] };
+    }
+    const search = /^search (?:"([^"]+)"|(.+))$/i.exec(text);
+    if (search) {
+        return { actions: [{ type: "search", query: search[1] ?? search[2] }] };
+    }
+    const shell = /^(?:run command|run shell) (?:"([^"]+)"|([\s\S]+))$/i.exec(text);
+    if (shell) {
+        return { actions: [{ type: "shell", command: shell[1] ?? shell[2] }] };
+    }
+    if (/^git status$/i.test(text)) {
+        return { actions: [{ type: "git-status" }] };
+    }
+    return undefined;
+}
+//# sourceMappingURL=local-plan.js.map

package/dist/agent/local-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-plan.js","sourceRoot":"","sources":["../../src/agent/local-plan.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,qFAAqF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/G,IAAI,KAAK,EAAE,CAAC;QACV,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,YAAY;oBAClB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;oBAC9B,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;iBACpC,CAAC;SACH,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC5E,CAAC;IAED,MAAM,MAAM,GAAG,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1E,CAAC;IAED,MAAM,KAAK,GAAG,sDAAsD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACzE,CAAC;IAED,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/agent/query-engine.d.ts

@@ -0,0 +1,71 @@
+import { SessionStore } from "../session-store.js";
+import { AgentRoute, AgentQueryEvent, AgentQueryResult } from "./query.js";
+import { ToolPermissionMode } from "./tools.js";
+import { HookDefinition, McpServerConfig, WebSearchConfig } from "../config.js";
+import { UserQuestionResolver } from "../tools/user-question.js";
+import { UserMessageSink } from "../tools/user-message.js";
+import { ActiveInteractionRegistry } from "../interactions.js";
+import { MemoryScope } from "../memory.js";
+import { SubAgentRequest, SubAgentResult } from "../tools/registry.js";
+export interface QueryEngineInput {
+    store: SessionStore;
+    sessionId: string;
+    jobId?: string;
+    cwd: string;
+    routes: AgentRoute[];
+    env?: NodeJS.ProcessEnv;
+    stateRoot?: string;
+    webSearchConfig?: WebSearchConfig;
+    permissionMode?: ToolPermissionMode;
+    approvalResolver?: (request: {
+        toolUse: import("../providers/ir.js").MagiToolUsePart;
+        reason: string;
+        diff?: string;
+    }) => Promise<boolean> | boolean;
+    userQuestionResolver?: UserQuestionResolver;
+    userMessageSink?: UserMessageSink;
+    spawnSubAgent?: (request: SubAgentRequest) => Promise<SubAgentResult>;
+    activeInteractions?: ActiveInteractionRegistry;
+    interactionTimeoutMs?: number;
+    hooks?: HookDefinition[];
+    mcp?: {
+        servers: Record<string, McpServerConfig>;
+    };
+    collectEvents?: boolean;
+    signal?: AbortSignal;
+    onStreamEvent?: (event: AgentQueryEvent) => void;
+    contextOptions?: {
+        recentMessages?: number;
+        autoCompactTokenThreshold?: number;
+        autoCompactMessageThreshold?: number;
+        compactionModel?: string;
+        compactionRoute?: AgentRoute;
+    };
+    memoryOptions?: {
+        paths?: import("../paths.js").MagiPaths;
+        enabled?: boolean;
+        autoWrite?: "off" | "explicit";
+        maxResults?: number;
+        scopes?: MemoryScope[];
+        selectionRoute?: import("../memory-selection.js").MemorySelectionRoute;
+    };
+}
+export interface QueryEngineResult extends AgentQueryResult {
+    jobId: string;
+    events: AgentQueryEvent[];
+}
+export declare class QueryEngine {
+    private readonly input;
+    private readonly toolUses;
+    constructor(input: QueryEngineInput);
+    submitMessage(prompt: string): Promise<QueryEngineResult>;
+    private resolveApproval;
+    private resolveUserQuestion;
+    private cancelInteractionOnAbort;
+    private executeSessionHooks;
+    private prepareContext;
+    private handleExplicitMemoryWrite;
+    private buildMemoryContext;
+    private persistEvent;
+    private persistHookResult;
+}