@edwardlee5423/magi 0.1.0-alpha.0

package/dist/memory.js

@@ -0,0 +1,259 @@
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { atomicWrite } from "./fs-utils.js";
+export function memoryFile(paths, scope, cwd) {
+    if (scope === "user") {
+        return path.join(paths.root, "memory.md");
+    }
+    if (scope === "session") {
+        throw new Error("Session memory requires a session id");
+    }
+    const projectId = Buffer.from(path.resolve(cwd)).toString("base64url");
+    return path.join(paths.stateRoot, "project-memory", `${projectId}.md`);
+}
+export function sessionMemoryFile(paths, sessionId) {
+    return path.join(paths.stateRoot, "session-memory", `${safeSessionId(sessionId)}.md`);
+}
+export function resolveMemoryFile(input) {
+    return input.scope === "session"
+        ? sessionMemoryFile(input.paths, requireSessionId(input.sessionId))
+        : memoryFile(input.paths, input.scope, input.cwd);
+}
+export function readMemory(input) {
+    const file = resolveMemoryFile(input);
+    if (!existsSync(file)) {
+        return "";
+    }
+    return readFileSync(file, "utf8");
+}
+export function appendMemory(input) {
+    const file = resolveMemoryFile(input);
+    mkdirSync(path.dirname(file), { recursive: true });
+    const existing = existsSync(file) ? readFileSync(file, "utf8") : "";
+    const existingEntries = parseMemoryEntries({ text: existing, scope: input.scope, file });
+    const incoming = parseMemoryEntryLine({
+        line: normalizeMemoryLine(input.text),
+        scope: input.scope,
+        file,
+        lineNumber: existingEntries.length + 1
+    });
+    const duplicate = existingEntries.some((entry) => normalizeText(entry.text) === normalizeText(incoming.text));
+    const conflicts = findMemoryConflicts(existingEntries, incoming);
+    const appended = !duplicate && conflicts.length === 0;
+    if (appended) {
+        const next = `${existing}${existing.endsWith("\n") || existing.length === 0 ? "" : "\n"}${incoming.text.trimEnd()}\n`;
+        atomicWrite(file, next);
+    }
+    if (input.store && input.sessionId) {
+        input.store.recordAudit({
+            sessionId: input.sessionId,
+            action: appended ? "memory.append" : conflicts.length > 0 ? "memory.conflict" : "memory.duplicate",
+            target: file,
+            metadata: {
+                scope: input.scope,
+                appended,
+                duplicate,
+                conflictCount: conflicts.length,
+                key: incoming.key
+            }
+        });
+    }
+    const result = {
+        file,
+        entry: incoming,
+        appended,
+        duplicate,
+        conflicts
+    };
+    return input.detailed ? result : file;
+}
+export function formatMemory(input) {
+    if (input.scope) {
+        const text = readMemory({ paths: input.paths, cwd: input.cwd, scope: input.scope, sessionId: input.sessionId });
+        return text || `No ${input.scope} memory\n`;
+    }
+    const user = readMemory({ paths: input.paths, cwd: input.cwd, scope: "user" });
+    const project = readMemory({ paths: input.paths, cwd: input.cwd, scope: "project" });
+    const session = input.sessionId
+        ? readMemory({ paths: input.paths, cwd: input.cwd, scope: "session", sessionId: input.sessionId })
+        : "";
+    return [
+        "# user",
+        user.trimEnd() || "(empty)",
+        "",
+        "# project",
+        project.trimEnd() || "(empty)",
+        "",
+        "# session",
+        session.trimEnd() || "(empty)",
+        ""
+    ].join("\n");
+}
+export function listMemoryEntries(input) {
+    const scopes = input.scopes ?? ["user", "project", ...(input.sessionId ? ["session"] : [])];
+    return scopes.flatMap((scope) => {
+        if (scope === "session" && !input.sessionId) {
+            return [];
+        }
+        const file = resolveMemoryFile({ paths: input.paths, cwd: input.cwd, sessionId: input.sessionId, scope });
+        const text = existsSync(file) ? readFileSync(file, "utf8") : "";
+        return parseMemoryEntries({ text, scope, file });
+    });
+}
+export function searchMemory(input) {
+    const terms = tokenize(input.query);
+    if (terms.length === 0) {
+        return [];
+    }
+    const scopeWeight = {
+        session: 3,
+        project: 2,
+        user: 1
+    };
+    return listMemoryEntries(input)
+        .map((entry) => ({
+        ...entry,
+        score: scoreMemoryEntry(entry, terms) + scopeWeight[entry.scope]
+    }))
+        .filter((entry) => entry.score > scopeWeight[entry.scope])
+        .sort((left, right) => right.score - left.score || scopeWeight[right.scope] - scopeWeight[left.scope] || left.line - right.line)
+        .slice(0, input.maxResults ?? 8);
+}
+export function formatMemorySearchResults(results) {
+    if (results.length === 0) {
+        return "";
+    }
+    return [
+        "[Relevant memory]",
+        ...results.map((entry) => `- ${entry.scope}: ${entry.text}`)
+    ].join("\n");
+}
+export function extractExplicitMemoryWrite(prompt) {
+    const trimmed = prompt.trim();
+    const patterns = [
+        { pattern: /^(?:remember|please remember)\s+(?:for\s+)?(user|project|session)\s*:\s*(.+)$/i },
+        { pattern: /^记住(?:到|为)?(用户|项目|会话)?记忆?[:：]\s*(.+)$/ },
+        { pattern: /^把(.+?)记到(用户|项目|会话)记忆$/ }
+    ];
+    for (const item of patterns) {
+        const match = item.pattern.exec(trimmed);
+        if (!match) {
+            continue;
+        }
+        if (item.pattern.source.startsWith("^把")) {
+            return { scope: readChineseScope(match[2]), text: match[1].trim() };
+        }
+        const scope = match[1] ? readScope(match[1]) : item.scope ?? "session";
+        const text = match[2]?.trim();
+        if (text) {
+            return { scope, text };
+        }
+    }
+    return undefined;
+}
+function parseMemoryEntries(input) {
+    return input.text
+        .split(/\r?\n/)
+        .map((line, index) => ({ line: line.trim(), lineNumber: index + 1 }))
+        .filter((line) => Boolean(line.line))
+        .map((line) => parseMemoryEntryLine({
+        line: line.line,
+        scope: input.scope,
+        file: input.file,
+        lineNumber: line.lineNumber
+    }));
+}
+function parseMemoryEntryLine(input) {
+    const text = normalizeMemoryLine(input.line);
+    const keyValue = parseKeyValue(text);
+    return {
+        scope: input.scope,
+        text,
+        key: keyValue?.key,
+        value: keyValue?.value,
+        file: input.file,
+        line: input.lineNumber
+    };
+}
+function normalizeMemoryLine(text) {
+    const normalized = text.trim().replace(/^\s*[-*]\s+/, "");
+    if (!normalized) {
+        throw new Error("Memory text must not be empty");
+    }
+    return normalized;
+}
+function parseKeyValue(text) {
+    const match = /^([^:=：]{2,80})\s*(?:=|:|：)\s*(.+)$/.exec(text);
+    if (!match) {
+        return undefined;
+    }
+    return {
+        key: normalizeKey(match[1]),
+        value: normalizeText(match[2])
+    };
+}
+function findMemoryConflicts(entries, incoming) {
+    if (!incoming.key || incoming.value === undefined) {
+        return [];
+    }
+    return entries
+        .filter((entry) => entry.key === incoming.key && entry.value !== undefined && entry.value !== incoming.value)
+        .map((existing) => ({
+        scope: incoming.scope,
+        key: incoming.key,
+        existing,
+        incoming
+    }));
+}
+function scoreMemoryEntry(entry, terms) {
+    const haystack = tokenize(`${entry.key ?? ""} ${entry.value ?? ""} ${entry.text}`);
+    let score = 0;
+    for (const term of terms) {
+        if (haystack.includes(term)) {
+            score += entry.key === term ? 5 : 2;
+        }
+        else if (haystack.some((word) => word.includes(term) || term.includes(word))) {
+            score += 1;
+        }
+    }
+    return score;
+}
+function tokenize(text) {
+    return Array.from(new Set(text
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}_-]+/gu, " ")
+        .split(/\s+/)
+        .map((term) => term.trim())
+        .filter((term) => term.length >= 2)));
+}
+function normalizeKey(text) {
+    return normalizeText(text).replace(/\s+/g, " ");
+}
+function normalizeText(text) {
+    return text.trim().toLowerCase().replace(/\s+/g, " ");
+}
+function readScope(value) {
+    if (value === "user" || value === "project" || value === "session") {
+        return value;
+    }
+    return readChineseScope(value);
+}
+function readChineseScope(value) {
+    if (value === "用户")
+        return "user";
+    if (value === "项目")
+        return "project";
+    if (value === "会话" || !value)
+        return "session";
+    throw new Error(`Unsupported memory scope: ${value}`);
+}
+function requireSessionId(sessionId) {
+    if (!sessionId) {
+        throw new Error("Session memory requires a session id");
+    }
+    return sessionId;
+}
+function safeSessionId(sessionId) {
+    return encodeURIComponent(sessionId).replace(/%/g, "_");
+}
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,25 @@
+export declare const MAGI_ENV_PREFIX = "MAGI_";
+export declare const DEVELOPMENT_ROOT_NAME = ".magi-next";
+export declare const FUTURE_STABLE_ROOT_NAME = ".magi";
+export declare const DEFAULT_CONTROL_BIND = "127.0.0.1";
+export declare const DEFAULT_CONTROL_PORT = 8765;
+export interface MagiPaths {
+    root: string;
+    configFile: string;
+    stateRoot: string;
+    sessionsRoot: string;
+    logsRoot: string;
+    cacheRoot: string;
+    pluginsRoot: string;
+    skillsRoot: string;
+    devicesRoot: string;
+    sessionDbFile: string;
+}
+export interface RuntimeSettings {
+    controlBind: string;
+    controlPort: number;
+}
+export declare function getMagiPaths(env?: NodeJS.ProcessEnv, homeDir?: string): MagiPaths;
+export declare function getRuntimeSettings(env?: NodeJS.ProcessEnv): RuntimeSettings;
+export declare function ensureMagiHome(paths: MagiPaths): void;
+export declare function defaultConfigYaml(): string;

package/dist/paths.js

@@ -0,0 +1,99 @@
+import { mkdirSync, writeFileSync, existsSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { MagiConfigError } from "./errors.js";
+export const MAGI_ENV_PREFIX = "MAGI_";
+export const DEVELOPMENT_ROOT_NAME = ".magi-next";
+export const FUTURE_STABLE_ROOT_NAME = ".magi";
+export const DEFAULT_CONTROL_BIND = "127.0.0.1";
+export const DEFAULT_CONTROL_PORT = 8765;
+export function getMagiPaths(env = process.env, homeDir = os.homedir()) {
+    const root = env.MAGI_CONFIG_DIR
+        ? path.resolve(env.MAGI_CONFIG_DIR)
+        : path.join(homeDir, DEVELOPMENT_ROOT_NAME);
+    const stateRoot = path.join(root, "state");
+    return {
+        root,
+        configFile: path.join(root, "config.yaml"),
+        stateRoot,
+        sessionsRoot: path.join(root, "sessions"),
+        logsRoot: path.join(root, "logs"),
+        cacheRoot: path.join(root, "cache"),
+        pluginsRoot: path.join(root, "plugins"),
+        skillsRoot: path.join(root, "skills"),
+        devicesRoot: path.join(root, "devices"),
+        sessionDbFile: path.join(stateRoot, "sessions.sqlite")
+    };
+}
+export function getRuntimeSettings(env = process.env) {
+    return {
+        controlBind: env.MAGI_CONTROL_BIND?.trim() || DEFAULT_CONTROL_BIND,
+        controlPort: parseControlPort(env.MAGI_CONTROL_PORT)
+    };
+}
+export function ensureMagiHome(paths) {
+    for (const dir of [
+        paths.root,
+        paths.stateRoot,
+        paths.sessionsRoot,
+        paths.logsRoot,
+        paths.cacheRoot,
+        paths.pluginsRoot,
+        paths.skillsRoot,
+        paths.devicesRoot
+    ]) {
+        mkdirSync(dir, { recursive: true });
+    }
+    if (!existsSync(paths.configFile)) {
+        writeFileSync(paths.configFile, defaultConfigYaml(), { encoding: "utf8", flag: "wx" });
+    }
+}
+export function defaultConfigYaml() {
+    return [
+        "version: 0.1",
+        "control:",
+        `  bind: ${DEFAULT_CONTROL_BIND}`,
+        `  port: ${DEFAULT_CONTROL_PORT}`,
+        "providers: {}",
+        "models:",
+        "  aliases: {}",
+        "  fallbacks: {}",
+        "mcp:",
+        "  servers: {}",
+        "context:",
+        "  recentMessages: 6",
+        "memory:",
+        "  enabled: true",
+        "  autoWrite: explicit",
+        "  maxResults: 8",
+        "  scopes:",
+        "    - user",
+        "    - project",
+        "    - session",
+        "webSearch:",
+        "  locale: zh-CN",
+        "  market: CN",
+        "  mainlandBoost: true",
+        "  queryParam: q",
+        "  resultsPath: results",
+        "  titlePath: title",
+        "  urlPath: url",
+        "  snippetPath: snippet",
+        "  maxResults: 10",
+        ""
+    ].join("\n");
+}
+function parseControlPort(raw) {
+    if (!raw) {
+        return DEFAULT_CONTROL_PORT;
+    }
+    if (!/^[0-9]+$/.test(raw)) {
+        throw new MagiConfigError(`MAGI_CONTROL_PORT must be an integer from 1 to 65535, got ${JSON.stringify(raw)}`);
+    }
+    const port = Number(raw);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        throw new MagiConfigError(`MAGI_CONTROL_PORT must be an integer from 1 to 65535, got ${JSON.stringify(raw)}`);
+    }
+    return port;
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

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

package/dist/permissions.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Persistent permission rules.
+ * Stores "always allow" rules to ~/.magi-next/permissions.json (or MAGI_CONFIG_DIR/permissions.json)
+ */
+export interface PermissionRule {
+    /** Tool name pattern (exact match or "*") */
+    tool: string;
+    /** When the rule was created */
+    createdAt: string;
+    /** Optional description */
+    description?: string;
+}
+export declare function addPermissionRule(tool: string, description?: string): void;
+export declare function isToolAlwaysAllowed(toolName: string): boolean;
+export declare function listPermissionRules(): PermissionRule[];
+export declare function clearPermissionRules(): void;
+export declare function removePermissionRule(tool: string): boolean;

package/dist/permissions.js

@@ -0,0 +1,72 @@
+/**
+ * Persistent permission rules.
+ * Stores "always allow" rules to ~/.magi-next/permissions.json (or MAGI_CONFIG_DIR/permissions.json)
+ */
+import { existsSync, readFileSync, mkdirSync } from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import { atomicWrite } from "./fs-utils.js";
+function getPermissionsDir() {
+    const configDir = process.env.MAGI_CONFIG_DIR
+        ? path.resolve(process.env.MAGI_CONFIG_DIR)
+        : path.join(os.homedir(), ".magi-next");
+    return configDir;
+}
+const PERMISSIONS_FILE = path.join(getPermissionsDir(), "permissions.json");
+let cachedRules;
+function loadRules() {
+    if (cachedRules)
+        return cachedRules;
+    if (!existsSync(PERMISSIONS_FILE)) {
+        cachedRules = [];
+        return cachedRules;
+    }
+    try {
+        const raw = readFileSync(PERMISSIONS_FILE, "utf-8");
+        cachedRules = JSON.parse(raw);
+        return cachedRules;
+    }
+    catch {
+        cachedRules = [];
+        return cachedRules;
+    }
+}
+function saveRules(rules) {
+    const permissionsDir = getPermissionsDir();
+    if (!existsSync(permissionsDir)) {
+        mkdirSync(permissionsDir, { recursive: true });
+    }
+    atomicWrite(PERMISSIONS_FILE, JSON.stringify(rules, null, 2));
+    cachedRules = rules;
+}
+export function addPermissionRule(tool, description) {
+    const rules = loadRules();
+    // Don't duplicate
+    if (rules.some((r) => r.tool === tool))
+        return;
+    rules.push({
+        tool,
+        createdAt: new Date().toISOString(),
+        description
+    });
+    saveRules(rules);
+}
+export function isToolAlwaysAllowed(toolName) {
+    const rules = loadRules();
+    return rules.some((r) => r.tool === toolName || r.tool === "*");
+}
+export function listPermissionRules() {
+    return loadRules();
+}
+export function clearPermissionRules() {
+    saveRules([]);
+}
+export function removePermissionRule(tool) {
+    const rules = loadRules();
+    const filtered = rules.filter((r) => r.tool !== tool);
+    if (filtered.length === rules.length)
+        return false;
+    saveRules(filtered);
+    return true;
+}
+//# sourceMappingURL=permissions.js.map

package/dist/permissions.js.map

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

package/dist/plugins/manifest.d.ts

@@ -0,0 +1,17 @@
+import { MagiPaths } from "../paths.js";
+export interface PluginManifest {
+    schemaVersion: "0.1";
+    name: string;
+    version: string;
+    description?: string;
+    entry?: string;
+    permissions: string[];
+}
+export interface PluginRecord {
+    manifest: PluginManifest;
+    root: string;
+}
+export declare function loadPluginManifest(file: string): PluginManifest;
+export declare function validatePluginManifest(value: unknown, source?: string): PluginManifest;
+export declare function listLocalPlugins(paths: MagiPaths): PluginRecord[];
+export declare function formatPluginList(plugins: PluginRecord[]): string;

package/dist/plugins/manifest.js

@@ -0,0 +1,98 @@
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import path from "node:path";
+import { MagiConfigError } from "../errors.js";
+export function loadPluginManifest(file) {
+    const parsed = JSON.parse(readFileSync(file, "utf8"));
+    return validatePluginManifest(parsed, file);
+}
+export function validatePluginManifest(value, source = "plugin.json") {
+    if (!isRecord(value)) {
+        throw new MagiConfigError(`Invalid plugin manifest at ${source}: root must be an object`);
+    }
+    if (value.schemaVersion !== "0.1") {
+        throw new MagiConfigError(`Invalid plugin manifest at ${source}: schemaVersion must be 0.1`);
+    }
+    const name = readName(value.name, "name", source);
+    const version = readString(value.version, "version", source);
+    const description = value.description === undefined ? undefined : readString(value.description, "description", source);
+    const entry = value.entry === undefined ? undefined : readRelativePath(value.entry, "entry", source);
+    const permissions = readStringList(value.permissions, "permissions", source);
+    return { schemaVersion: "0.1", name, version, description, entry, permissions };
+}
+export function listLocalPlugins(paths) {
+    return listManifestDirectories(paths.pluginsRoot, "plugin.json").map((file) => ({
+        root: path.dirname(file),
+        manifest: loadPluginManifest(file)
+    }));
+}
+export function formatPluginList(plugins) {
+    if (plugins.length === 0) {
+        return "No plugins installed\n";
+    }
+    return `${plugins.map((plugin) => [
+        plugin.manifest.name,
+        plugin.manifest.version,
+        plugin.manifest.permissions.join(",") || "no-permissions",
+        plugin.root
+    ].join("\t")).join("\n")}\n`;
+}
+function listManifestDirectories(root, manifestName) {
+    let entries;
+    try {
+        entries = readdirSync(root);
+    }
+    catch {
+        return [];
+    }
+    const manifests = [];
+    for (const name of entries) {
+        const item = path.join(root, name);
+        const stat = statSync(item);
+        if (!stat.isDirectory()) {
+            continue;
+        }
+        const manifest = path.join(item, manifestName);
+        try {
+            if (statSync(manifest).isFile()) {
+                manifests.push(manifest);
+            }
+        }
+        catch {
+            // Directories without manifests are ignored.
+        }
+    }
+    return manifests.sort();
+}
+function readName(value, field, source) {
+    const name = readString(value, field, source);
+    if (!/^[a-z0-9][a-z0-9._-]{1,63}$/.test(name)) {
+        throw new MagiConfigError(`Invalid plugin manifest at ${source}: ${field} must be a lowercase plugin id`);
+    }
+    return name;
+}
+function readRelativePath(value, field, source) {
+    const filePath = readString(value, field, source);
+    if (path.isAbsolute(filePath) || filePath.includes("..")) {
+        throw new MagiConfigError(`Invalid plugin manifest at ${source}: ${field} must be a relative in-plugin path`);
+    }
+    return filePath;
+}
+function readString(value, field, source) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new MagiConfigError(`Invalid plugin manifest at ${source}: ${field} must be a non-empty string`);
+    }
+    return value;
+}
+function readStringList(value, field, source) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!Array.isArray(value) || !value.every((item) => typeof item === "string" && item.trim())) {
+        throw new MagiConfigError(`Invalid plugin manifest at ${source}: ${field} must be a string list`);
+    }
+    return value;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/plugins/manifest.js.map

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

package/dist/plugins/marketplace.d.ts

@@ -0,0 +1,22 @@
+import { MagiPaths } from "../paths.js";
+export type MarketplaceSourceKind = "local" | "git" | "url";
+export interface MarketplaceSource {
+    name: string;
+    kind: MarketplaceSourceKind;
+    location: string;
+}
+export interface MarketplaceEntry {
+    name: string;
+    version: string;
+    source: string;
+    description?: string;
+}
+export interface MarketplaceRecord {
+    source: MarketplaceSource;
+    entries: MarketplaceEntry[];
+}
+export declare function loadMarketplaceSource(value: unknown, source?: string): MarketplaceSource;
+export declare function listMarketplaceSources(paths: MagiPaths): MarketplaceSource[];
+export declare function loadMarketplace(source: MarketplaceSource): MarketplaceRecord;
+export declare function discoverLocalMarketplaceSources(paths: MagiPaths): MarketplaceSource[];
+export declare function formatMarketplaces(records: MarketplaceRecord[]): string;