open-multi-agent-kit 0.78.8 → 0.79.1

package/dist/util/todo-sync.js

@@ -1,473 +0,0 @@
-import { writeFile, readFile } from "fs/promises";
-import { join } from "path";
-import { getRunPath, pathExists, ensureDir, validateRunId } from "./fs.js";
-const LIFECYCLE_NODE_IDS = new Set(["bootstrap", "root-coordinator", "review-merge"]);
-function normalizeTodoStatus(status) {
-    const s = status.toLowerCase();
-    switch (s) {
-        case "running":
-        case "in_progress":
-            return "in_progress";
-        case "done":
-        case "completed":
-            return "done";
-        case "failed":
-            return "failed";
-        case "blocked":
-            return "blocked";
-        case "skipped":
-            return "skipped";
-        default:
-            return "pending";
-    }
-}
-export async function writeTodos(runId, todos) {
-    const sanitized = validateRunId(runId);
-    const dir = getRunPath(sanitized);
-    await ensureDir(dir);
-    const todosPath = join(dir, "todos.json");
-    await writeFile(todosPath, JSON.stringify(todos, null, 2), "utf-8");
-}
-export async function readTodos(runId) {
-    const sanitized = validateRunId(runId);
-    const todosPath = join(getRunPath(sanitized), "todos.json");
-    if (!(await pathExists(todosPath)))
-        return null;
-    try {
-        const content = await readFile(todosPath, "utf-8");
-        const parsed = JSON.parse(content);
-        return parseTodoArray(parsed);
-    }
-    catch {
-        return null;
-    }
-}
-export function normalizeTodoItems(value) {
-    const todos = parseTodoArray(value);
-    if (!todos) {
-        throw new Error("Invalid todos: expected an array of todo items");
-    }
-    return todos;
-}
-export function normalizeTodoWriteInput(input) {
-    if (!input || typeof input !== "object") {
-        throw new Error("Invalid TodoWrite input: expected object with todos array");
-    }
-    const todos = input.todos;
-    return normalizeTodoItems(todos);
-}
-export function applyTodoWriteOperations(existingTodos, operations, now = () => new Date().toISOString()) {
-    if (!Array.isArray(operations)) {
-        throw new Error("Invalid todo_write input: ops must be an array");
-    }
-    let todos = existingTodos.map((todo, index) => normalizeExistingTodo(todo, index));
-    let applied = 0;
-    for (const operation of operations) {
-        applyTodoWriteOperation(operation, todos, now);
-        applied += 1;
-    }
-    promoteNextTodo(todos, now);
-    todos = sortTodos(todos);
-    return { todos, applied };
-}
-function normalizeExistingTodo(todo, index) {
-    return {
-        ...todo,
-        status: normalizeTodoStatus(todo.status),
-        phase: todo.phase ?? "General",
-        order: typeof todo.order === "number" ? todo.order : index,
-        notes: Array.isArray(todo.notes) ? todo.notes.map(String) : undefined,
-    };
-}
-function applyTodoWriteOperation(operation, todos, now) {
-    switch (operation.op) {
-        case "init":
-            replaceTodosFromPhaseList(todos, requirePhaseList(operation), now);
-            return;
-        case "append":
-            appendTodos(todos, requirePhase(operation), requireItems(operation));
-            return;
-        case "start":
-            markTask(todos, requireTask(operation), "in_progress", now);
-            return;
-        case "done":
-            markDone(todos, operation, now);
-            return;
-        case "drop":
-            markDropped(todos, operation, now);
-            return;
-        case "rm":
-            removeTodos(todos, operation);
-            return;
-        case "note":
-            appendTodoNote(todos, requireTask(operation), requireText(operation));
-            return;
-        default:
-            throw new Error(`Unsupported todo_write op: ${operation.op}`);
-    }
-}
-function replaceTodosFromPhaseList(todos, list, now) {
-    todos.splice(0, todos.length);
-    let order = 0;
-    for (const group of list) {
-        const phase = cleanNonEmpty(group.phase, "phase");
-        const items = normalizeItems(group.items);
-        for (const item of items) {
-            todos.push({
-                title: item,
-                status: "pending",
-                phase,
-                order: order++,
-            });
-        }
-    }
-    promoteNextTodo(todos, now);
-}
-function appendTodos(todos, phase, items) {
-    const cleanItems = normalizeItems(items);
-    const nextOrder = todos.reduce((max, todo) => Math.max(max, todo.order ?? 0), -1) + 1;
-    cleanItems.forEach((title, index) => {
-        todos.push({
-            title,
-            status: "pending",
-            phase,
-            order: nextOrder + index,
-        });
-    });
-}
-function markTask(todos, title, status, now) {
-    const target = findTodoByTitle(todos, title);
-    if (status === "in_progress") {
-        for (const todo of todos) {
-            if (todo.status === "in_progress" && todo.title !== target.title) {
-                todo.status = "pending";
-            }
-        }
-        target.startedAt ??= now();
-        target.completedAt = undefined;
-        target.elapsedMs = undefined;
-    }
-    if (status === "done" || status === "failed" || status === "skipped") {
-        completeTodo(target, status, now);
-        return;
-    }
-    target.status = status;
-}
-function markDone(todos, operation, now) {
-    if (operation.phase) {
-        const phase = cleanNonEmpty(operation.phase, "phase");
-        const phaseTodos = todos.filter((todo) => todo.phase === phase);
-        if (phaseTodos.length === 0)
-            throw new Error(`Todo phase not found: ${phase}`);
-        for (const todo of phaseTodos) {
-            if (!isTerminalTodo(todo))
-                completeTodo(todo, "done", now);
-        }
-        promoteNextTodo(todos, now);
-        return;
-    }
-    markTask(todos, requireTask(operation), "done", now);
-    promoteNextTodo(todos, now);
-}
-function markDropped(todos, operation, now) {
-    if (operation.phase) {
-        const phase = cleanNonEmpty(operation.phase, "phase");
-        const phaseTodos = todos.filter((todo) => todo.phase === phase);
-        if (phaseTodos.length === 0)
-            throw new Error(`Todo phase not found: ${phase}`);
-        for (const todo of phaseTodos) {
-            if (!isTerminalTodo(todo))
-                completeTodo(todo, "skipped", now);
-        }
-        promoteNextTodo(todos, now);
-        return;
-    }
-    markTask(todos, requireTask(operation), "skipped", now);
-    promoteNextTodo(todos, now);
-}
-function removeTodos(todos, operation) {
-    if (!operation.task && !operation.phase) {
-        todos.splice(0, todos.length);
-        return;
-    }
-    if (operation.phase) {
-        const phase = cleanNonEmpty(operation.phase, "phase");
-        const before = todos.length;
-        for (let index = todos.length - 1; index >= 0; index -= 1) {
-            if (todos[index]?.phase === phase)
-                todos.splice(index, 1);
-        }
-        if (todos.length === before)
-            throw new Error(`Todo phase not found: ${phase}`);
-        return;
-    }
-    const title = requireTask(operation);
-    const index = todos.findIndex((todo) => todo.title === title);
-    if (index === -1)
-        throw new Error(`Todo not found: ${title}`);
-    todos.splice(index, 1);
-}
-function appendTodoNote(todos, title, text) {
-    const target = findTodoByTitle(todos, title);
-    target.notes = [...(target.notes ?? []), text];
-    target.description = target.description ? `${target.description}\n${text}` : text;
-}
-function promoteNextTodo(todos, now) {
-    if (todos.some((todo) => todo.status === "in_progress"))
-        return;
-    const next = sortTodos(todos).find((todo) => todo.status === "pending");
-    if (!next)
-        return;
-    next.status = "in_progress";
-    next.startedAt ??= now();
-}
-function completeTodo(todo, status, now) {
-    todo.status = status;
-    todo.completedAt = now();
-    if (todo.startedAt) {
-        const start = Date.parse(todo.startedAt);
-        const end = Date.parse(todo.completedAt);
-        if (!Number.isNaN(start) && !Number.isNaN(end)) {
-            todo.elapsedMs = Math.max(0, end - start);
-        }
-    }
-}
-function isTerminalTodo(todo) {
-    return todo.status === "done" || todo.status === "failed" || todo.status === "skipped";
-}
-function sortTodos(todos) {
-    return [...todos].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
-}
-function findTodoByTitle(todos, title) {
-    const target = todos.find((todo) => todo.title === title);
-    if (!target)
-        throw new Error(`Todo not found: ${title}`);
-    return target;
-}
-function requirePhaseList(operation) {
-    if (!Array.isArray(operation.list)) {
-        throw new Error("todo_write init requires list");
-    }
-    return operation.list;
-}
-function requirePhase(operation) {
-    return cleanNonEmpty(operation.phase, "phase");
-}
-function requireTask(operation) {
-    return cleanNonEmpty(operation.task, "task");
-}
-function requireText(operation) {
-    return cleanNonEmpty(operation.text, "text");
-}
-function requireItems(operation) {
-    return normalizeItems(operation.items);
-}
-function normalizeItems(items) {
-    if (!Array.isArray(items)) {
-        throw new Error("todo_write items must be an array");
-    }
-    const normalized = items.map((item) => cleanNonEmpty(String(item), "item"));
-    const unique = new Set(normalized);
-    if (unique.size !== normalized.length) {
-        throw new Error("todo_write items must be unique");
-    }
-    return normalized;
-}
-function cleanNonEmpty(value, label) {
-    const text = String(value ?? "").trim();
-    if (!text)
-        throw new Error(`todo_write ${label} is required`);
-    return text;
-}
-export async function updateTodoStatus(runId, title, status) {
-    const todos = await readTodos(runId);
-    if (!todos) {
-        throw new Error(`No todos found for runId: ${runId}`);
-    }
-    const target = todos.find((t) => t.title === title);
-    if (!target) {
-        throw new Error(`Todo not found: ${title}`);
-    }
-    target.status = status;
-    if (status === "done" || status === "failed" || status === "skipped") {
-        target.completedAt = new Date().toISOString();
-        if (target.startedAt) {
-            const start = Date.parse(target.startedAt);
-            if (!Number.isNaN(start)) {
-                target.elapsedMs = Date.now() - start;
-            }
-        }
-    }
-    else if (status === "in_progress" && !target.startedAt) {
-        target.startedAt = new Date().toISOString();
-    }
-    await writeTodos(runId, todos);
-}
-export async function deriveTodosFromState(runId) {
-    const sanitized = validateRunId(runId);
-    const statePath = join(getRunPath(sanitized), "state.json");
-    try {
-        const content = await readFile(statePath, "utf-8");
-        const state = JSON.parse(content);
-        if (!state || typeof state !== "object" || !Array.isArray(state.nodes)) {
-            return null;
-        }
-        const nodes = state.nodes;
-        return deriveTodoItemsFromNodes(nodes);
-    }
-    catch {
-        return null;
-    }
-}
-function deriveTodoItemsFromNodes(nodes) {
-    return nodes
-        .filter((n) => n !== null && typeof n === "object")
-        .filter((n) => !LIFECYCLE_NODE_IDS.has(String(n.id)))
-        .map((n) => {
-        const status = normalizeTodoStatus(String(n.status ?? "pending"));
-        const startedAt = n.startedAt ? String(n.startedAt) : undefined;
-        const completedAt = n.completedAt ? String(n.completedAt) : undefined;
-        let elapsedMs;
-        if (typeof n.durationMs === "number") {
-            elapsedMs = n.durationMs;
-        }
-        else if (startedAt) {
-            const end = completedAt ? Date.parse(completedAt) : Date.now();
-            const start = Date.parse(startedAt);
-            if (!Number.isNaN(end) && !Number.isNaN(start)) {
-                elapsedMs = end - start;
-            }
-        }
-        const lastEvidence = Array.isArray(n.evidence) && n.evidence.length > 0
-            ? n.evidence[n.evidence.length - 1]
-            : undefined;
-        return {
-            title: String(n.name ?? n.id ?? "Untitled"),
-            status,
-            agent: n.id ? String(n.id) : undefined,
-            role: n.role ? String(n.role) : undefined,
-            startedAt,
-            completedAt,
-            elapsedMs,
-            evidence: lastEvidence?.message ? String(lastEvidence.message) : undefined,
-            description: n.blockedReason ? String(n.blockedReason) : undefined,
-        };
-    })
-        .filter((item) => item.title.length > 0 && item.title !== "Untitled");
-}
-export function parseSetTodoListFromOutput(output) {
-    if (!output || typeof output !== "string")
-        return null;
-    // Strategy 1: look for TodoWrite/SetTodoList tool calls with arguments JSON.
-    const toolCallPattern = /name\s*=\s*['"](?:TodoWrite|todo_write|SetTodoList)['"]\s*,\s*arguments\s*=\s*['"](\{[\s\S]*?\})['"]/g;
-    const toolCallPatternAlt = /name\s*=\s*['"](?:TodoWrite|todo_write|SetTodoList)['"]\s*[;,]?\s*arguments\s*[:=]\s*['"](\{[\s\S]*?\})['"]/g;
-    for (const pattern of [toolCallPattern, toolCallPatternAlt]) {
-        pattern.lastIndex = 0;
-        let match;
-        while ((match = pattern.exec(output)) !== null) {
-            const jsonStr = match[1]
-                .replace(/\\"/g, '"')
-                .replace(/\\'/g, "'")
-                .replace(/\\n/g, "\n")
-                .replace(/\\/g, "\\");
-            const result = tryParseTodosJson(jsonStr);
-            if (result && result.length > 0)
-                return result;
-        }
-    }
-    // Strategy 2: look for XML-ish tool markers with JSON arguments nearby.
-    const xmlPattern = /<tool>\s*(?:TodoWrite|todo_write|set_todo_list)\s*<\/tool>[\s\S]*?(\{[\s\S]*?\})/g;
-    let xmlMatch;
-    while ((xmlMatch = xmlPattern.exec(output)) !== null) {
-        const result = tryParseTodosJson(xmlMatch[1]);
-        if (result && result.length > 0)
-            return result;
-    }
-    // Strategy 3: look for any JSON object with a "todos" array near a TodoWrite/SetTodoList mention.
-    const toolMention = output.match(/TodoWrite|todo_write|SetTodoList|set_todo_list/);
-    if (toolMention?.index !== undefined) {
-        const nearby = output.slice(Math.max(0, toolMention.index - 200), toolMention.index + 2000);
-        const jsonPattern = /\{[\s\S]*?"todos"\s*:\s*\[[\s\S]*?\][\s\S]*?\}/g;
-        let jsonMatch;
-        while ((jsonMatch = jsonPattern.exec(nearby)) !== null) {
-            const result = tryParseTodosJson(jsonMatch[0]);
-            if (result && result.length > 0)
-                return result;
-        }
-    }
-    // Strategy 4: broad search for JSON with "todos" array anywhere in output
-    const broadPattern = /\{[\s\S]*?"todos"\s*:\s*\[[\s\S]*?\][\s\S]*?\}/g;
-    let broadMatch;
-    while ((broadMatch = broadPattern.exec(output)) !== null) {
-        const result = tryParseTodosJson(broadMatch[0]);
-        if (result && result.length > 0)
-            return result;
-    }
-    return null;
-}
-function tryParseTodosJson(jsonStr) {
-    try {
-        const parsed = JSON.parse(jsonStr);
-        if (parsed && typeof parsed === "object" && Array.isArray(parsed.todos)) {
-            return parseTodoArray(parsed.todos);
-        }
-        if (Array.isArray(parsed)) {
-            return parseTodoArray(parsed);
-        }
-    }
-    catch {
-        // ignore parse errors
-    }
-    return null;
-}
-function parseTodoArray(value) {
-    if (!Array.isArray(value))
-        return null;
-    return value
-        .filter((item) => item !== null && typeof item === "object")
-        .map((item) => {
-        const startedAt = item.startedAt ? String(item.startedAt) : undefined;
-        const completedAt = item.completedAt ? String(item.completedAt) : undefined;
-        let elapsedMs;
-        if (typeof item.elapsedMs === "number") {
-            elapsedMs = item.elapsedMs;
-        }
-        else if (startedAt) {
-            const end = completedAt ? Date.parse(completedAt) : Date.now();
-            const start = Date.parse(startedAt);
-            if (!Number.isNaN(end) && !Number.isNaN(start)) {
-                elapsedMs = end - start;
-            }
-        }
-        const activeForm = item.activeForm ? String(item.activeForm) : undefined;
-        const status = normalizeTodoStatus(String(item.status ?? item.state ?? "pending"));
-        return {
-            title: String(item.title ?? item.content ?? item.label ?? item.name ?? item.id ?? "Untitled"),
-            status,
-            agent: item.agent ? String(item.agent) : undefined,
-            role: item.role ? String(item.role) : undefined,
-            startedAt,
-            completedAt,
-            elapsedMs,
-            evidence: item.evidence ? String(item.evidence) : undefined,
-            description: item.description ? String(item.description) : undefined,
-            activeForm,
-            phase: item.phase ? String(item.phase) : undefined,
-            order: typeof item.order === "number" ? item.order : undefined,
-            notes: Array.isArray(item.notes) ? item.notes.map(String) : undefined,
-        };
-    })
-        .filter((item) => item.title.length > 0 && item.title !== "Untitled");
-}
-/**
- * Load todos for a run, trying todos.json first then falling back to state.json nodes.
- * This is the canonical read path used by cockpit and HUD renderers.
- */
-export async function loadTodos(runId) {
-    if (!runId)
-        return null;
-    const fromFile = await readTodos(runId);
-    if (fromFile !== null)
-        return fromFile;
-    return deriveTodosFromState(runId);
-}

package/dist/util/update-check.d.ts

@@ -1,94 +0,0 @@
-import { type ShellResult } from "./shell.js";
-export interface UpdateStatus {
-    omk: PackageUpdateStatus;
-    kimi: KimiUpdateStatus;
-    checkedAt: string;
-    cacheHit: boolean;
-}
-export interface PackageUpdateStatus {
-    current: string;
-    latest: string | null;
-    outdated: boolean;
-    error: string | null;
-    installCmd: string;
-}
-export interface KimiUpdateStatus {
-    installed: string | null;
-    latest: string | null;
-    outdated: boolean;
-    error: string | null;
-    installCmd: string;
-    fallbackInstallCmd: string;
-    installScript: string;
-}
-export declare const OMK_NPM_PACKAGE_NAME = "open-multi-agent-kit";
-type UpdatePromptEnv = Record<string, string | undefined>;
-export type OmkUpdatePromptChoice = "update-now" | "skip-version" | "remind-later";
-/**
- * Returns true when `env.OMK_AUTO_UPDATE` is one of 1/true/yes/on/always
- * (case-insensitive), indicating the user wants non-interactive auto-updates.
- */
-export declare function resolveAutoUpdateMode(env: UpdatePromptEnv): boolean;
-export type OmkUpdatePromptDecisionReason = "disabled" | "ci" | "non-tty" | "not-outdated" | "missing-latest" | "skipped-version" | "remind-active" | "prompt";
-export type OmkUpdatePromptAction = Exclude<OmkUpdatePromptDecisionReason, "prompt"> | "suppressed" | "prompted-skip" | "prompted-remind" | "updated" | "update-failed" | "cancelled" | "timeout";
-export interface OmkUpdatePromptState {
-    skippedVersion?: string;
-    remindAfter?: string;
-    updatedAt?: string;
-}
-export interface OmkUpdatePromptDecision {
-    shouldPrompt: boolean;
-    reason: OmkUpdatePromptDecisionReason;
-    latestVersion?: string;
-    remindAfter?: string;
-}
-export interface OmkUpdatePromptResult {
-    action: OmkUpdatePromptAction;
-    shouldExit: boolean;
-    exitCode?: number;
-    version?: string;
-    message?: string;
-}
-interface OmkUpdatePromptChoiceItem {
-    name: string;
-    value: OmkUpdatePromptChoice;
-    description?: string;
-}
-interface OmkUpdatePromptSelectConfig {
-    message: string;
-    choices: OmkUpdatePromptChoiceItem[];
-}
-export interface OmkUpdatePromptOptions {
-    status?: UpdateStatus | null;
-    checkUpdatesFn?: () => Promise<UpdateStatus>;
-    env?: UpdatePromptEnv;
-    isTTY?: boolean;
-    isCI?: boolean;
-    now?: Date;
-    statePath?: string;
-    source?: "chat" | "root" | "test";
-    promptTimeoutMs?: number;
-    selectPrompt?: (config: OmkUpdatePromptSelectConfig, options?: {
-        signal?: AbortSignal;
-    }) => Promise<OmkUpdatePromptChoice>;
-    runUpdate?: () => Promise<ShellResult>;
-    onLog?: (message: string) => void;
-}
-export declare function getOmkUpdatePromptStatePath(): string;
-export declare function readOmkUpdatePromptState(statePath?: string): Promise<OmkUpdatePromptState | null>;
-export declare function writeOmkUpdatePromptState(state: OmkUpdatePromptState, statePath?: string): Promise<void>;
-export declare function resolveOmkUpdatePromptState(options: {
-    status: UpdateStatus | null;
-    state?: OmkUpdatePromptState | null;
-    env?: UpdatePromptEnv;
-    isTTY?: boolean;
-    isCI?: boolean;
-    now?: Date;
-}): OmkUpdatePromptDecision;
-export declare function formatStartupUpdateBanner(updateStatus: UpdateStatus): string;
-export declare function maybePromptForOmkUpdate(options?: OmkUpdatePromptOptions): Promise<OmkUpdatePromptResult>;
-export declare function parseSemverParts(v: string): [number, number, number] | null;
-export declare function compareVersions(a: string, b: string): number;
-export declare function isOutdated(current: string, latest: string): boolean;
-export declare function checkUpdates(forceRefresh?: boolean): Promise<UpdateStatus>;
-export {};