@edwardlee5423/magi 0.1.0-alpha.0

package/dist/tools/todo.d.ts

@@ -0,0 +1,69 @@
+export type TodoStatus = "pending" | "in_progress" | "completed";
+export interface TodoItem {
+    id: string;
+    content: string;
+    status: TodoStatus;
+    priority?: "low" | "medium" | "high";
+}
+export interface TodoSessionState {
+    sessionId: string;
+    todos: TodoItem[];
+    updatedAt: string;
+}
+export interface TodoStoreData {
+    version: 1;
+    sessions: Record<string, TodoSessionState>;
+}
+export interface TodoWriteResult {
+    previousTodos: TodoItem[];
+    todos: TodoItem[];
+    stateFile: string;
+    updatedAt: string;
+}
+export declare const TodoStatusValues: TodoStatus[];
+export declare const TodoWriteInputSchema: {
+    type: string;
+    properties: {
+        todos: {
+            type: string;
+            items: {
+                type: string;
+                properties: {
+                    id: {
+                        type: string;
+                    };
+                    content: {
+                        type: string;
+                    };
+                    status: {
+                        type: string;
+                        enum: TodoStatus[];
+                    };
+                    priority: {
+                        type: string;
+                        enum: string[];
+                    };
+                };
+                required: string[];
+                additionalProperties: boolean;
+            };
+        };
+    };
+    required: string[];
+    additionalProperties: boolean;
+};
+export declare function todoStorePathFromRoot(stateRoot: string): string;
+export declare function replaceTodoList(input: {
+    stateRoot: string;
+    sessionId: string;
+    todos: TodoItem[];
+    now?: Date;
+    hooks?: import("../config.js").HookDefinition[];
+    cwd?: string;
+}): Promise<TodoWriteResult>;
+export declare function parseTodoWriteInput(input: Record<string, unknown>): TodoItem[];
+export declare function loadTodoStore(filePath: string): TodoStoreData;
+export declare function saveTodoStore(filePath: string, store: TodoStoreData): void;
+export declare function readTodoList(value: unknown): TodoItem[];
+export declare function formatTodoWriteResult(result: TodoWriteResult): string;
+export declare function formatTodoList(todos: TodoItem[]): string;

package/dist/tools/todo.js

@@ -0,0 +1,197 @@
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { atomicWrite } from "../fs-utils.js";
+export const TodoStatusValues = ["pending", "in_progress", "completed"];
+export const TodoWriteInputSchema = {
+    type: "object",
+    properties: {
+        todos: {
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    id: { type: "string" },
+                    content: { type: "string" },
+                    status: { type: "string", enum: TodoStatusValues },
+                    priority: { type: "string", enum: ["low", "medium", "high"] }
+                },
+                required: ["id", "content", "status"],
+                additionalProperties: false
+            }
+        }
+    },
+    required: ["todos"],
+    additionalProperties: false
+};
+export function todoStorePathFromRoot(stateRoot) {
+    return path.join(stateRoot, "todos.json");
+}
+export async function replaceTodoList(input) {
+    const stateFile = todoStorePathFromRoot(input.stateRoot);
+    const store = loadTodoStore(stateFile);
+    const previousTodos = store.sessions[input.sessionId]?.todos ?? [];
+    const updatedAt = (input.now ?? new Date()).toISOString();
+    store.sessions[input.sessionId] = {
+        sessionId: input.sessionId,
+        todos: input.todos,
+        updatedAt
+    };
+    saveTodoStore(stateFile, store);
+    if (input.hooks) {
+        const { triggerHook } = await import("../hooks/trigger.js");
+        const previousIds = new Set(previousTodos.map(t => t.id));
+        const currentIds = new Set(input.todos.map(t => t.id));
+        for (const todo of input.todos) {
+            if (!previousIds.has(todo.id)) {
+                void triggerHook({
+                    event: "task_created",
+                    hooks: input.hooks,
+                    context: {
+                        cwd: input.cwd ?? process.cwd(),
+                        taskId: todo.id,
+                        taskSubject: todo.content,
+                        taskDescription: `Priority: ${todo.priority ?? "normal"}`
+                    }
+                });
+            }
+            const prevTodo = previousTodos.find(t => t.id === todo.id);
+            if (prevTodo && prevTodo.status !== "completed" && todo.status === "completed") {
+                void triggerHook({
+                    event: "task_completed",
+                    hooks: input.hooks,
+                    context: {
+                        cwd: input.cwd ?? process.cwd(),
+                        taskId: todo.id,
+                        taskSubject: todo.content
+                    }
+                });
+            }
+        }
+    }
+    return {
+        previousTodos,
+        todos: input.todos,
+        stateFile,
+        updatedAt
+    };
+}
+export function parseTodoWriteInput(input) {
+    assertAllowedKeys(input, ["todos"], "TodoWrite input");
+    return readTodoList(input.todos);
+}
+export function loadTodoStore(filePath) {
+    if (!existsSync(filePath)) {
+        return { version: 1, sessions: {} };
+    }
+    const parsed = JSON.parse(readFileSync(filePath, "utf8"));
+    if (!isRecord(parsed) || parsed.version !== 1 || !isRecord(parsed.sessions)) {
+        throw new Error(`Invalid todo store: ${filePath}`);
+    }
+    const sessions = {};
+    for (const [sessionId, value] of Object.entries(parsed.sessions)) {
+        sessions[sessionId] = readTodoSessionState(sessionId, value);
+    }
+    return { version: 1, sessions };
+}
+export function saveTodoStore(filePath, store) {
+    mkdirSync(path.dirname(filePath), { recursive: true });
+    atomicWrite(filePath, `${JSON.stringify(store, null, 2)}\n`);
+}
+export function readTodoList(value) {
+    if (!Array.isArray(value)) {
+        throw new Error("Tool input todos must be an array");
+    }
+    const seen = new Set();
+    return value.map((item, index) => {
+        const todo = readTodoItem(item, `todos[${index}]`);
+        if (seen.has(todo.id)) {
+            throw new Error(`Todo id must be unique: ${todo.id}`);
+        }
+        seen.add(todo.id);
+        return todo;
+    });
+}
+export function formatTodoWriteResult(result) {
+    const added = result.todos.filter((todo) => !result.previousTodos.some((previous) => previous.id === todo.id)).length;
+    const removed = result.previousTodos.filter((previous) => !result.todos.some((todo) => todo.id === previous.id)).length;
+    const changed = result.todos.filter((todo) => {
+        const previous = result.previousTodos.find((item) => item.id === todo.id);
+        return previous && JSON.stringify(previous) !== JSON.stringify(todo);
+    }).length;
+    const counts = TodoStatusValues.map((status) => `${status}: ${result.todos.filter((todo) => todo.status === status).length}`);
+    return [
+        `Todo list replaced (${result.todos.length} items)`,
+        `changes: +${added} ~${changed} -${removed}`,
+        `status: ${counts.join(", ")}`,
+        `updatedAt: ${result.updatedAt}`,
+        `stateFile: ${result.stateFile}`,
+        "",
+        formatTodoList(result.todos)
+    ].join("\n").trimEnd();
+}
+export function formatTodoList(todos) {
+    if (todos.length === 0) {
+        return "No todos";
+    }
+    return todos.map((todo, index) => {
+        const priority = todo.priority ? ` priority=${todo.priority}` : "";
+        return `${index + 1}. [${todo.status}] ${todo.id}${priority} - ${todo.content}`;
+    }).join("\n");
+}
+function readTodoSessionState(sessionId, value) {
+    if (!isRecord(value)) {
+        throw new Error(`Invalid todo session state for ${sessionId}`);
+    }
+    const storedSessionId = typeof value.sessionId === "string" ? value.sessionId : sessionId;
+    if (storedSessionId !== sessionId) {
+        throw new Error(`Todo session key mismatch: ${sessionId}`);
+    }
+    if (typeof value.updatedAt !== "string" || !value.updatedAt.trim()) {
+        throw new Error(`Todo session ${sessionId} updatedAt must be a non-empty string`);
+    }
+    return {
+        sessionId,
+        todos: readTodoList(value.todos),
+        updatedAt: value.updatedAt
+    };
+}
+function readTodoItem(value, label) {
+    if (!isRecord(value)) {
+        throw new Error(`${label} must be an object`);
+    }
+    assertAllowedKeys(value, ["id", "content", "status", "priority"], label);
+    const id = readNonEmptyString(value.id, `${label}.id`);
+    const content = readNonEmptyString(value.content, `${label}.content`);
+    if (!TodoStatusValues.includes(value.status)) {
+        throw new Error(`${label}.status must be pending, in_progress, or completed`);
+    }
+    const todo = {
+        id,
+        content,
+        status: value.status
+    };
+    if (value.priority !== undefined) {
+        if (value.priority !== "low" && value.priority !== "medium" && value.priority !== "high") {
+            throw new Error(`${label}.priority must be low, medium, or high`);
+        }
+        todo.priority = value.priority;
+    }
+    return todo;
+}
+function assertAllowedKeys(value, allowed, label) {
+    const allowedSet = new Set(allowed);
+    const unknown = Object.keys(value).filter((key) => !allowedSet.has(key));
+    if (unknown.length > 0) {
+        throw new Error(`${label} has unknown field: ${unknown[0]}`);
+    }
+}
+function readNonEmptyString(value, label) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new Error(`${label} must be a non-empty string`);
+    }
+    return value.trim();
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=todo.js.map

package/dist/tools/todo.js.map

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

package/dist/tools/tool-search.d.ts

@@ -0,0 +1,29 @@
+export interface ToolSearchableRecord {
+    name: string;
+    description?: string;
+    inputSchema: Record<string, unknown>;
+    category?: string;
+    tags?: string[];
+    isReadOnly(input: Record<string, unknown>): boolean;
+    isDestructive(input: Record<string, unknown>): boolean;
+    isConcurrencySafe(input: Record<string, unknown>): boolean;
+}
+export interface ToolSearchInput {
+    query: string;
+    maxResults: number;
+}
+export declare const ToolSearchInputSchema: {
+    type: string;
+    properties: {
+        query: {
+            type: string;
+        };
+        max_results: {
+            type: string;
+        };
+    };
+    required: string[];
+    additionalProperties: boolean;
+};
+export declare function parseToolSearchInput(input: Record<string, unknown>): ToolSearchInput;
+export declare function executeToolSearch(input: ToolSearchInput, tools: ToolSearchableRecord[]): string;

package/dist/tools/tool-search.js

@@ -0,0 +1,114 @@
+export const ToolSearchInputSchema = {
+    type: "object",
+    properties: {
+        query: { type: "string" },
+        max_results: { type: "number" }
+    },
+    required: ["query"],
+    additionalProperties: false
+};
+export function parseToolSearchInput(input) {
+    assertAllowedKeys(input, ["query", "max_results"], "ToolSearch input");
+    const query = readNonEmptyString(input.query, "query");
+    const maxResults = input.max_results === undefined ? 5 : readMaxResults(input.max_results);
+    return { query, maxResults };
+}
+export function executeToolSearch(input, tools) {
+    const select = /^select:(.+)$/i.exec(input.query.trim());
+    if (select) {
+        const requested = select[1].trim();
+        const tool = tools.find((item) => item.name.toLowerCase() === requested.toLowerCase());
+        if (!tool) {
+            throw new Error(`Tool not found: ${requested}`);
+        }
+        return formatSelectedTool(tool);
+    }
+    const matches = searchTools(input.query, tools).slice(0, input.maxResults);
+    if (matches.length === 0) {
+        return `No tools match ${JSON.stringify(input.query)}`;
+    }
+    return [
+        `ToolSearch results for ${JSON.stringify(input.query)} (${matches.length})`,
+        ...matches.map(({ tool, score }, index) => [
+            `${index + 1}. ${tool.name} [${tool.category ?? "uncategorized"}] score=${score}`,
+            `   ${tool.description ?? "No description"}`,
+            `   tags: ${(tool.tags ?? []).join(", ") || "none"}`,
+            `   schema: ${schemaSummary(tool.inputSchema)}`
+        ].join("\n")),
+        "",
+        "Use query select:<tool_name> for the full schema."
+    ].join("\n");
+}
+function searchTools(query, tools) {
+    const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+    return tools
+        .map((tool) => ({ tool, score: scoreTool(tool, terms) }))
+        .filter((item) => item.score > 0)
+        .sort((left, right) => right.score - left.score || left.tool.name.localeCompare(right.tool.name));
+}
+function scoreTool(tool, terms) {
+    const name = tool.name.toLowerCase();
+    const description = (tool.description ?? "").toLowerCase();
+    const category = (tool.category ?? "").toLowerCase();
+    const tags = (tool.tags ?? []).join(" ").toLowerCase();
+    const schema = JSON.stringify(tool.inputSchema).toLowerCase();
+    let score = 0;
+    for (const term of terms) {
+        if (name === term)
+            score += 100;
+        if (name.startsWith(term))
+            score += 70;
+        if (name.includes(term))
+            score += 50;
+        if (category.includes(term))
+            score += 35;
+        if (tags.includes(term))
+            score += 30;
+        if (description.includes(term))
+            score += 20;
+        if (schema.includes(term))
+            score += 5;
+    }
+    return score;
+}
+function formatSelectedTool(tool) {
+    return [
+        `Tool: ${tool.name}`,
+        `Category: ${tool.category ?? "uncategorized"}`,
+        `Description: ${tool.description ?? "No description"}`,
+        `Read-only: ${tool.isReadOnly({}) ? "yes" : "depends on input or mode"}`,
+        `Destructive: ${tool.isDestructive({}) ? "yes" : "no"}`,
+        `Concurrency-safe: ${tool.isConcurrencySafe({}) ? "yes" : "no"}`,
+        `Tags: ${(tool.tags ?? []).join(", ") || "none"}`,
+        "Input schema:",
+        JSON.stringify(tool.inputSchema, null, 2)
+    ].join("\n");
+}
+function schemaSummary(schema) {
+    const properties = isRecord(schema.properties) ? Object.keys(schema.properties) : [];
+    const required = Array.isArray(schema.required) ? schema.required.filter((item) => typeof item === "string") : [];
+    return `required=[${required.join(", ")}] properties=[${properties.join(", ")}]`;
+}
+function readMaxResults(value) {
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 1 || value > 20) {
+        throw new Error("Tool input max_results must be an integer from 1 to 20");
+    }
+    return value;
+}
+function readNonEmptyString(value, label) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new Error(`Tool input ${label} must be a non-empty string`);
+    }
+    return value.trim();
+}
+function assertAllowedKeys(value, allowed, label) {
+    const allowedSet = new Set(allowed);
+    const unknown = Object.keys(value).filter((key) => !allowedSet.has(key));
+    if (unknown.length > 0) {
+        throw new Error(`${label} has unknown field: ${unknown[0]}`);
+    }
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=tool-search.js.map

package/dist/tools/tool-search.js.map

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

package/dist/tools/tree-view.d.ts

@@ -0,0 +1,34 @@
+export interface TreeViewResult {
+    path: string;
+    depth: number;
+    tree: string;
+    entries: number;
+}
+export declare const TreeViewInputSchema: {
+    type: string;
+    properties: {
+        path: {
+            type: string;
+        };
+        depth: {
+            type: string;
+        };
+        show_files: {
+            type: string;
+        };
+    };
+    required: never[];
+    additionalProperties: boolean;
+};
+export declare function parseTreeViewInput(input: Record<string, unknown>): {
+    path: string;
+    depth: number;
+    showFiles: boolean;
+};
+export declare function executeTreeView(input: {
+    path: string;
+    depth: number;
+    showFiles: boolean;
+    cwd: string;
+}): TreeViewResult;
+export declare function formatTreeViewResult(result: TreeViewResult): string;

package/dist/tools/tree-view.js

@@ -0,0 +1,39 @@
+import { spawnSync } from "node:child_process";
+export const TreeViewInputSchema = { type: "object", properties: { path: { type: "string" }, depth: { type: "number" }, show_files: { type: "boolean" } }, required: [], additionalProperties: false };
+export function parseTreeViewInput(input) {
+    return {
+        path: typeof input.path === "string" ? input.path : ".",
+        depth: typeof input.depth === "number" ? Math.min(Math.max(input.depth, 1), 5) : 3,
+        showFiles: input.show_files !== false
+    };
+}
+export function executeTreeView(input) {
+    const depth = input.depth;
+    const whichResult = spawnSync("which", ["tree"], { encoding: "utf8", timeout: 3000 });
+    const useTree = whichResult.status === 0 && whichResult.stdout?.trim().length > 0;
+    let tree;
+    let entries = 0;
+    if (useTree) {
+        const args = ["-L", String(depth)];
+        if (!input.showFiles)
+            args.push("-d");
+        args.push("--charset=utf-8", input.path);
+        const result = spawnSync("tree", args, { cwd: input.cwd, encoding: "utf8", timeout: 10_000, maxBuffer: 10 * 1024 * 1024 });
+        tree = result.stdout?.trim() ?? "";
+        entries = tree.split("\n").length - 1; // last line is summary
+    }
+    else {
+        // fallback: find + format
+        const args = [input.path, "-maxdepth", String(depth)];
+        if (!input.showFiles)
+            args.push("-type", "d");
+        const result = spawnSync("find", args, { cwd: input.cwd, encoding: "utf8", timeout: 10_000, maxBuffer: 10 * 1024 * 1024 });
+        tree = result.stdout?.trim() ?? "";
+        entries = tree.split("\n").length;
+    }
+    return { path: input.path, depth, tree, entries };
+}
+export function formatTreeViewResult(result) {
+    return `${result.tree}\n(${result.entries} entries, depth ${result.depth})`;
+}
+//# sourceMappingURL=tree-view.js.map

package/dist/tools/tree-view.js.map

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

package/dist/tools/user-message.d.ts

@@ -0,0 +1,39 @@
+import { MagiToolUsePart } from "../providers/ir.js";
+export type UserMessageStatus = "normal" | "proactive";
+export interface SendUserMessageRequest {
+    message: string;
+    attachments: string[];
+    status: UserMessageStatus;
+}
+export interface SendUserMessageResult {
+    delivered: boolean;
+    channel: string;
+    deliveredAt: string;
+}
+export type UserMessageSink = (request: {
+    toolUse: MagiToolUsePart;
+    message: SendUserMessageRequest;
+}) => Promise<SendUserMessageResult> | SendUserMessageResult;
+export declare const SEND_USER_MESSAGE_SCHEMA: {
+    type: string;
+    properties: {
+        message: {
+            type: string;
+        };
+        attachments: {
+            type: string;
+            items: {
+                type: string;
+            };
+        };
+        status: {
+            type: string;
+            enum: string[];
+        };
+    };
+    required: string[];
+    additionalProperties: boolean;
+};
+export declare function parseSendUserMessageInput(input: Record<string, unknown>): SendUserMessageRequest;
+export declare function formatSendUserMessageResult(request: SendUserMessageRequest, result: SendUserMessageResult): string;
+export declare function defaultUserMessageSink(): SendUserMessageResult;

package/dist/tools/user-message.js

@@ -0,0 +1,70 @@
+export const SEND_USER_MESSAGE_SCHEMA = {
+    type: "object",
+    properties: {
+        message: { type: "string" },
+        attachments: {
+            type: "array",
+            items: { type: "string" }
+        },
+        status: {
+            type: "string",
+            enum: ["normal", "proactive"]
+        }
+    },
+    required: ["message"],
+    additionalProperties: false
+};
+export function parseSendUserMessageInput(input) {
+    const message = readNonEmptyString(input.message, "message");
+    const attachments = input.attachments === undefined
+        ? []
+        : readStringArray(input.attachments, "attachments");
+    const status = readStatus(input.status);
+    return { message, attachments, status };
+}
+export function formatSendUserMessageResult(request, result) {
+    return [
+        "User message delivered",
+        `status: ${request.status}`,
+        `channel: ${result.channel}`,
+        `delivered: ${result.delivered ? "true" : "false"}`,
+        `deliveredAt: ${result.deliveredAt}`,
+        request.attachments.length > 0 ? `attachments:\n${request.attachments.map((item) => `- ${item}`).join("\n")}` : undefined,
+        "",
+        request.message
+    ].filter((line) => line !== undefined).join("\n");
+}
+export function defaultUserMessageSink() {
+    return {
+        delivered: true,
+        channel: "agent-event",
+        deliveredAt: new Date().toISOString()
+    };
+}
+function readNonEmptyString(value, name) {
+    if (typeof value !== "string" || !value.trim()) {
+        throw new Error(`SendUserMessage ${name} must be a non-empty string`);
+    }
+    return value;
+}
+function readStringArray(value, name) {
+    if (!Array.isArray(value)) {
+        throw new Error(`SendUserMessage ${name} must be an array`);
+    }
+    return value.map((item, index) => {
+        if (typeof item !== "string" || !item.trim()) {
+            throw new Error(`SendUserMessage ${name}[${index}] must be a non-empty string`);
+        }
+        return item;
+    });
+}
+function readStatus(value) {
+    if (value === undefined) {
+        return "normal";
+    }
+    if (value === "normal" || value === "proactive") {
+        return value;
+    }
+    throw new Error("SendUserMessage status must be normal or proactive");
+}
+//# sourceMappingURL=user-message.js.map

package/dist/tools/user-message.js.map

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