min-agent 0.5.0 → 0.6.0

package/dist/cli/commands/memory.js

@@ -1,87 +0,0 @@
-import { loadMemories, addMemory, deleteMemory, searchMemories, defaultMemoryScope, formatMemoryLine, parseMemoryMode, resolveMemoryMode, memoryModeLabel, memorySourceLabel, isMemoryEnabled, } from "../../memory.js";
-import { runMemoryCli } from "../../memory-cli.js";
-import { CliError } from "../errors.js";
-function printList(which) {
-    const memories = loadMemories(which);
-    const label = which === "project" ? "Project memories" : "Global memories";
-    if (memories.length === 0) {
-        console.log(`${label}: none`);
-        return;
-    }
-    console.log(`${label} (${memories.length}):`);
-    for (const line of memories.map((m, i) => formatMemoryLine(m, i, { date: true }))) {
-        console.log(line);
-    }
-}
-export async function runMemoryMode(state, scope, flagMode) {
-    if (!state && flagMode === undefined)
-        return false;
-    if (state && state !== "list" && !parseMemoryMode(state))
-        return false;
-    if (state === "list")
-        return false;
-    const result = runMemoryCli({
-        positionals: state ? [state] : [],
-        flagMode,
-        scope,
-    });
-    console.log(result.lines.join("\n"));
-    if (!result.ok)
-        process.exitCode = 1;
-    return true;
-}
-export async function runMemoryList(scope) {
-    const { memory, source } = resolveMemoryMode();
-    console.log(`Current memory: ${memoryModeLabel(memory)} (${memorySourceLabel(source)})`);
-    if (!scope && loadMemories("project").length === 0 && loadMemories("global").length === 0) {
-        console.log("No memories stored.");
-        if (!isMemoryEnabled())
-            console.log("Turn on with: min-agent memory on");
-        console.log('Or add manually: min-agent memory add "prefer TypeScript over JavaScript"');
-        return;
-    }
-    const scopes = scope ? [scope] : ["project", "global"];
-    for (const s of scopes)
-        printList(s);
-    if (!isMemoryEnabled())
-        console.log("Memories are stored but not used in chat until you run: min-agent memory on");
-}
-export async function runMemoryAdd(textTokens, scope) {
-    const text = textTokens.join(" ");
-    if (!text)
-        throw new CliError("Usage: min-agent memory add <text> [--project|--global]");
-    const resolved = scope ?? defaultMemoryScope();
-    addMemory(text, [], resolved);
-    const hint = isMemoryEnabled() ? "" : " (memory is off — turn on with: min-agent memory on)";
-    console.log(`✓ ${resolved === "project" ? "Project" : "Global"} memory saved: "${text}"${hint}`);
-}
-export async function runMemorySearch(queryTokens, scope) {
-    const query = queryTokens.join(" ");
-    if (!query)
-        throw new CliError("Usage: min-agent memory search <query> [--project|--global]");
-    const scopes = scope ? [scope] : ["project", "global"];
-    const lines = scopes.flatMap((s) => searchMemories(query, s).map((m) => {
-        const tags = m.tags.length > 0 ? ` [${m.tags.join(", ")}]` : "";
-        return `  [${s}] #${m.index + 1}: ${m.content}${tags}`;
-    }));
-    if (lines.length === 0) {
-        console.log(`No memories matching "${query}"`);
-    }
-    else {
-        console.log(`Found ${lines.length} memory(s):`);
-        for (const line of lines)
-            console.log(line);
-    }
-}
-export async function runMemoryDelete(indexArg, scope) {
-    const idx = Number.parseInt(indexArg, 10);
-    if (Number.isNaN(idx))
-        throw new CliError("Usage: min-agent memory delete <number> [--project|--global]");
-    const resolved = scope ?? defaultMemoryScope();
-    if (deleteMemory(idx - 1, resolved)) {
-        console.log(`✓ ${resolved === "project" ? "Project" : "Global"} memory #${idx} deleted`);
-    }
-    else {
-        throw new CliError(`${resolved === "project" ? "Project" : "Global"} memory #${idx} not found`);
-    }
-}

package/dist/cli/commands/models.js

@@ -1,21 +0,0 @@
-import { loadConfig, fetchModels, getActiveProvider } from "../../config.js";
-import { CliError } from "../errors.js";
-export async function runModelsCommand(opts) {
-    const config = loadConfig();
-    const provider = opts.provider ? config.providers?.find((p) => p.name === opts.provider) : getActiveProvider(config);
-    if (!provider?.baseURL || !provider?.apiKey) {
-        throw new CliError("Not configured.", { hint: "Run: min-agent setup" });
-    }
-    console.log(`Fetching models (${provider.name ?? "default"})...`);
-    const models = await fetchModels(provider.baseURL, provider.apiKey);
-    if (models.length === 0) {
-        console.log("No models found or unable to fetch model list.");
-    }
-    else {
-        console.log(`\nAvailable models (${models.length}):`);
-        for (const m of models) {
-            const marker = m === provider.defaultModel ? " ← default" : "";
-            console.log(`  ${m}${marker}`);
-        }
-    }
-}

package/dist/cli/commands/permission.js

@@ -1,12 +0,0 @@
-import { runPermissionCli } from "../../permission-cli.js";
-export async function runPermissionCommand(args, opts, parentOpts) {
-    const scope = opts.project ? "project" : opts.global ? "global" : undefined;
-    const result = runPermissionCli({
-        positionals: args,
-        flagMode: parentOpts.permission,
-        scope,
-    });
-    console.log(result.lines.join("\n"));
-    if (!result.ok)
-        process.exitCode = 1;
-}

package/dist/cli/commands/rules.js

@@ -1,33 +0,0 @@
-import { existsSync, writeFileSync, mkdirSync } from "fs";
-import { getConfigDir, getRulesFile } from "../../config.js";
-export async function runRulesShow() {
-    const { loadInstructions } = await import("../../instructions.js");
-    const instructions = await loadInstructions();
-    if (instructions.length === 0) {
-        console.log("No instruction rules loaded.");
-        console.log("");
-        console.log("Add rules by creating:");
-        console.log(`  Global:  ${getRulesFile()}`);
-        console.log("  Project: ./AGENTS.md or ./RULES.md");
-        console.log("");
-        console.log("Or add paths/URLs in ~/.min-agent/config.json:");
-        console.log('  { "instructions": ["./docs/rules.md", "https://..."] }');
-    }
-    else {
-        console.log(`Loaded ${instructions.length} instruction source(s):\n`);
-        for (const inst of instructions) {
-            const firstLine = inst.split("\n")[0];
-            console.log(`  ${firstLine}`);
-        }
-    }
-}
-export async function runRulesEdit() {
-    const rulesFile = getRulesFile();
-    if (!existsSync(rulesFile)) {
-        mkdirSync(getConfigDir(), { recursive: true });
-        writeFileSync(rulesFile, `# Global Agent Rules\n\n<!-- Add your custom instructions here. They will be included in every conversation. -->\n`, "utf-8");
-    }
-    const editor = process.env.EDITOR || "vi";
-    const { execSync } = await import("child_process");
-    execSync(`${editor} "${rulesFile}"`, { stdio: "inherit" });
-}

package/dist/cli/commands/sandbox.js

@@ -1,13 +0,0 @@
-import { runSandboxCli } from "../../sandbox-cli.js";
-export async function runSandboxCommand(args, opts, parentOpts) {
-    const scope = opts.project ? "project" : opts.global ? "global" : undefined;
-    const result = runSandboxCli({
-        positionals: args,
-        flagMode: parentOpts.sandbox,
-        flagNetwork: parentOpts.network ?? opts.network,
-        scope,
-    });
-    console.log(result.lines.join("\n"));
-    if (!result.ok)
-        process.exitCode = 1;
-}

package/dist/cli/commands/serve.js

@@ -1,9 +0,0 @@
-import { isConfigured } from "../../config.js";
-import { CliError } from "../errors.js";
-export async function runServeCommand(opts) {
-    if (!isConfigured()) {
-        throw new CliError("Not configured.", { hint: "Run: min-agent setup" });
-    }
-    const { runServe } = await import("../../serve.js");
-    await runServe({ port: opts.port, host: opts.host });
-}

package/dist/cli/commands/setup.js

@@ -1,4 +0,0 @@
-import { runSetup } from "../../config.js";
-export async function runSetupCommand() {
-    await runSetup();
-}

package/dist/cli/commands/shared.js

@@ -1,16 +0,0 @@
-import { isConfigured } from "../../config.js";
-import { CliError } from "../errors.js";
-export async function startTuiSession(input) {
-    if (!isConfigured()) {
-        throw new CliError("Not configured.", { hint: "Run: min-agent setup" });
-    }
-    const { runTui } = await import("../../tui-chat.js");
-    const prompt = input.positionals.join(" ").trim();
-    await runTui({
-        modelId: input.model,
-        providerName: input.provider,
-        resumeSessionId: input.resume,
-        images: input.images,
-        initialPrompt: prompt || undefined,
-    });
-}

package/dist/cli/commands/skills.js

@@ -1,119 +0,0 @@
-import { discoverSkills } from "../../skills.js";
-import { existsSync, writeFileSync, mkdirSync } from "fs";
-import path from "path";
-import os from "os";
-import { CliError } from "../errors.js";
-/** One-line, length-capped text for list output. */
-function truncate(text, max) {
-    const flat = text.replace(/\s+/g, " ").trim();
-    return flat.length <= max ? flat : `${flat.slice(0, max - 1)}…`;
-}
-export async function runSkillsList(json) {
-    discoverSkills({ silent: true });
-    const { getAllSkills, getStaleDisabledSkills } = await import("../../skills.js");
-    const all = getAllSkills().sort((a, b) => a.name.localeCompare(b.name));
-    const stale = getStaleDisabledSkills();
-    if (json) {
-        console.log(JSON.stringify({
-            count: all.length,
-            enabled_count: all.filter((s) => s.enabled).length,
-            stale_disabled: stale,
-            skills: all.map((s) => ({
-                name: s.name,
-                description: s.description,
-                location: s.location,
-                enabled: s.enabled,
-                ...(s.disabledScope ? { disabled_scope: s.disabledScope } : {}),
-                ...(s.version ? { version: s.version } : {}),
-                ...(s.allowedTools.length ? { allowed_tools: s.allowedTools } : {}),
-                ...(s.requiredBins.length ? { requires_bins: s.requiredBins } : {}),
-                ...(s.builtin ? { builtin: true } : {}),
-                ...(s.alwaysLoad ? { always_load: true } : {}),
-            })),
-        }, null, 2));
-        return;
-    }
-    if (all.length === 0 && stale.length === 0) {
-        console.log("No skills found. Add SKILL.md files in .min-agent/skills/<name>/");
-        return;
-    }
-    console.log(`Skills (${all.filter((s) => s.enabled).length} enabled, ${all.filter((s) => !s.enabled).length} disabled):`);
-    for (const skill of all) {
-        const status = skill.enabled
-            ? "\x1b[32menabled \x1b[0m"
-            : `\x1b[90mdisabled(${skill.disabledScope === "project" ? "proj" : "glob"})\x1b[0m`;
-        const origin = skill.builtin ? "  \x1b[90mbuiltin\x1b[0m" : "";
-        console.log(`  ${skill.name}  ${status}${origin}  \x1b[90m${truncate(skill.description, 60)}\x1b[0m`);
-        console.log(`    \x1b[90m${skill.location}\x1b[0m`);
-    }
-    if (stale.length > 0) {
-        console.log(`\n\x1b[33m⚠ disabledSkills/enabledSkills entries matching no skill: ${stale.join(", ")}\x1b[0m`);
-        console.log(`\x1b[33m  Remove them with: min-agent skills enable ${stale.join(" ")} (add --project if the entry is project-scoped)\x1b[0m`);
-    }
-    console.log("\nUse: min-agent skills info <name>  for details");
-}
-export async function runSkillsInfo(name, json) {
-    discoverSkills({ silent: true });
-    const { getSkill, getAllSkills } = await import("../../skills.js");
-    const skill = getSkill(name);
-    if (!skill) {
-        const names = getAllSkills().map((s) => s.name);
-        throw new CliError(`Skill "${name}" not found.${names.length ? ` Available: ${names.join(", ")}` : " No skills discovered."}`);
-    }
-    if (json) {
-        console.log(JSON.stringify(skill, null, 2));
-        return;
-    }
-    console.log(`Name:        ${skill.name}`);
-    console.log(`Status:      ${skill.enabled ? "enabled" : `disabled (${skill.disabledScope} scope)`}`);
-    if (skill.builtin)
-        console.log("Source:      builtin");
-    if (skill.version)
-        console.log(`Version:     ${skill.version}`);
-    console.log(`Description: ${skill.description}`);
-    console.log(`Location:    ${skill.location}`);
-    if (skill.allowedTools.length > 0)
-        console.log(`Tools:       ${skill.allowedTools.join(", ")}`);
-    if (skill.requiredBins.length > 0)
-        console.log(`Requires:    ${skill.requiredBins.join(", ")}`);
-    if (skill.content.trim()) {
-        console.log("\n--- Content ---\n");
-        console.log(skill.content.trim());
-    }
-}
-export async function runSkillsToggle(names, enabled, scope) {
-    const verb = enabled ? "enable" : "disable";
-    if (names.length === 0)
-        throw new CliError(`Usage: min-agent skills ${verb} <name...> [--project]`);
-    discoverSkills({ silent: true });
-    const { getAllSkills, setSkillEnabled, getStaleDisabledSkills } = await import("../../skills.js");
-    const known = new Set(getAllSkills().map((s) => s.name));
-    const stale = new Set(getStaleDisabledSkills());
-    // `enable` must accept stale names so they can be cleaned up from config;
-    // `disable` on an unknown name is always an error.
-    const unknown = names.filter((n) => !known.has(n) && !(enabled && stale.has(n)));
-    if (unknown.length > 0) {
-        throw new CliError(`Skill${unknown.length > 1 ? "s" : ""} not found: ${unknown.join(", ")}`, {
-            hint: known.size ? `Available: ${[...known].join(", ")}` : "No skills discovered.",
-        });
-    }
-    for (const result of setSkillEnabled(names, enabled, scope)) {
-        console.log(`✓ Skill "${result.name}" ${verb}d (${scope} scope)`);
-        if (result.blockedBy) {
-            console.log(`\x1b[33m  ⚠ still ${result.enabled ? "enabled" : "disabled"} — overridden by ${result.blockedBy} scope\x1b[0m`);
-        }
-    }
-}
-export async function runSkillsNew(name, global) {
-    if (!/^[\w-]+$/.test(name)) {
-        throw new CliError("Invalid skill name", { hint: "use letters, digits, _ or -" });
-    }
-    const root = global ? path.join(os.homedir(), ".agents", "skills") : path.join(process.cwd(), ".min-agent", "skills");
-    const dir = path.join(root, name);
-    if (existsSync(path.join(dir, "SKILL.md"))) {
-        throw new CliError(`Skill "${name}" already exists at ${dir}`);
-    }
-    mkdirSync(dir, { recursive: true });
-    writeFileSync(path.join(dir, "SKILL.md"), `---\nname: ${name}\ndescription: What this skill does\n# version: 1.0.0\n# allowed-tools: [read, grep]\n# metadata:\n#   requires:\n#     bins: ["some-cli"]\n---\n\n# ${name}\n\nWrite the skill instructions here.\n`, "utf-8");
-    console.log(`✓ Created skill "${name}" at ${path.join(dir, "SKILL.md")}`);
-}

package/dist/cli/commands/think.js

@@ -1,12 +0,0 @@
-import { runThinkCli } from "../../think-cli.js";
-export async function runThinkCommand(args, opts, parentOpts) {
-    const scope = opts.project ? "project" : opts.global ? "global" : undefined;
-    const result = runThinkCli({
-        positionals: args,
-        flagEffort: parentOpts.think,
-        scope,
-    });
-    console.log(result.lines.join("\n"));
-    if (!result.ok)
-        process.exitCode = 1;
-}

package/dist/cli/commands/update.js

@@ -1,7 +0,0 @@
-import { runUpdate } from "../../updater.js";
-export async function runUpdateCommand() {
-    const result = await runUpdate();
-    if (result.status === "check-failed" || result.status === "install-failed") {
-        process.exitCode = 1;
-    }
-}

package/dist/cli/commands/write-config.js

@@ -1,52 +0,0 @@
-import { runSandboxCli } from "../../sandbox-cli.js";
-import { runPermissionCli } from "../../permission-cli.js";
-import { runThinkCli } from "../../think-cli.js";
-import { runMemoryCli } from "../../memory-cli.js";
-export async function runWriteConfig(input) {
-    const lines = [];
-    let ok = true;
-    if (input.sandbox !== undefined || input.network !== undefined) {
-        const result = runSandboxCli({
-            positionals: [],
-            flagMode: input.sandbox,
-            flagNetwork: input.network,
-            scope: input.scope,
-        });
-        lines.push(...result.lines);
-        if (!result.ok)
-            ok = false;
-    }
-    if (input.permission !== undefined) {
-        const result = runPermissionCli({
-            positionals: [],
-            flagMode: input.permission,
-            scope: input.scope,
-        });
-        lines.push(...result.lines);
-        if (!result.ok)
-            ok = false;
-    }
-    if (input.think !== undefined) {
-        const result = runThinkCli({
-            positionals: [],
-            flagEffort: input.think,
-            scope: input.scope,
-        });
-        lines.push(...result.lines);
-        if (!result.ok)
-            ok = false;
-    }
-    if (input.memory !== undefined) {
-        const result = runMemoryCli({
-            positionals: [],
-            flagMode: input.memory,
-            scope: input.scope,
-        });
-        lines.push(...result.lines);
-        if (!result.ok)
-            ok = false;
-    }
-    console.log(lines.join("\n"));
-    if (!ok)
-        process.exitCode = 1;
-}

package/dist/cli/errors.js

@@ -1,36 +0,0 @@
-/**
- * Unified CLI error contract.
- *
- * Exit code convention:
- *   1 - user error (bad arguments, missing input, not found, validation failure)
- *   2 - runtime error (network failure, subprocess failure, unexpected exception)
- */
-export class CliError extends Error {
-    exitCode;
-    hint;
-    constructor(message, options) {
-        super(message);
-        this.name = "CliError";
-        this.exitCode = options?.exitCode ?? 1;
-        this.hint = options?.hint;
-    }
-}
-export function userError(message, hint) {
-    return new CliError(message, { exitCode: 1, hint });
-}
-export function runtimeError(message, hint) {
-    return new CliError(message, { exitCode: 2, hint });
-}
-/** Render a CliError (or any error) as the standard `✖ message` block on stderr. */
-export function formatCliError(err) {
-    if (err instanceof CliError) {
-        return err.hint ? `✖ ${err.message}\n  → ${err.hint}` : `✖ ${err.message}`;
-    }
-    const message = err instanceof Error ? err.message : String(err);
-    return `✖ ${message}`;
-}
-export function exitCodeFor(err) {
-    if (err instanceof CliError)
-        return err.exitCode;
-    return 2;
-}

package/dist/cli/exec-prompt.js

@@ -1,26 +0,0 @@
-/**
- * Resolve the final prompt text for `min-agent exec`, combining positional
- * arguments with piped stdin according to these rules:
- *  - `exec -`            reads the entire prompt from stdin.
- *  - `exec` (no args)    requires piped stdin (non-TTY); errors otherwise.
- *  - `exec <msg>` + pipe appends piped stdin after the message.
- *  - `exec <msg>`        uses the message as-is.
- */
-export function resolveExecPrompt(positionals, stdinText, stdinIsTty) {
-    const joined = positionals.join(" ");
-    const piped = stdinText.length > 0;
-    if (joined === "-") {
-        const prompt = stdinText;
-        if (!prompt.trim())
-            return { ok: false, error: "Usage: min-agent exec <message>" };
-        return { ok: true, prompt };
-    }
-    if (!joined) {
-        if (stdinIsTty || !piped)
-            return { ok: false, error: "Usage: min-agent exec <message>" };
-        return { ok: true, prompt: stdinText };
-    }
-    if (piped && !stdinIsTty)
-        return { ok: true, prompt: `${joined}\n\n${stdinText}` };
-    return { ok: true, prompt: joined };
-}

package/dist/cli/option-helpers.js

@@ -1,65 +0,0 @@
-import { Option } from "commander";
-import { parseNetworkPolicy, parseSandboxMode } from "../sandbox.js";
-import { parsePermissionMode, parseThinkingEffort, parseMemoryMode, } from "../config.js";
-import { userError } from "./errors.js";
-/** Reusable --project / --global mutually exclusive scope selector. */
-export function scopeOptions() {
-    return [
-        new Option("--project", "Apply to this project only (.min-agent/config.json)").conflicts("global"),
-        new Option("--global", "Apply to every project (~/.min-agent/config.json)").conflicts("project"),
-    ];
-}
-/** Resolve --project/--global into a Scope, given an optional fallback. */
-export function resolveScope(opts, fallback = "global") {
-    if (opts.project)
-        return "project";
-    if (opts.global)
-        return "global";
-    return fallback;
-}
-export function parseSandboxModeArg(value) {
-    const parsed = parseSandboxMode(value);
-    if (!parsed)
-        throw userError(`Invalid --sandbox value: "${value}"`, "use one of: off, workspace, strict");
-    return parsed;
-}
-export function parseNetworkPolicyArg(value) {
-    const parsed = parseNetworkPolicy(value);
-    if (!parsed)
-        throw userError(`Invalid --network value: "${value}"`, "use one of: allow, deny");
-    return parsed;
-}
-export function parsePermissionModeArg(value) {
-    const parsed = parsePermissionMode(value);
-    if (!parsed)
-        throw userError(`Invalid --permission value: "${value}"`, "use one of: ask, accept-edits, allow-all");
-    return parsed;
-}
-export function parseThinkingEffortArg(value) {
-    const parsed = parseThinkingEffort(value);
-    if (!parsed)
-        throw userError(`Invalid --think value: "${value}"`, "use one of: off, low, medium, high, max");
-    return parsed;
-}
-export function parseMemoryModeArg(value) {
-    const parsed = parseMemoryMode(value);
-    if (!parsed)
-        throw userError(`Invalid --memory value: "${value}"`, "use one of: on, off");
-    return parsed;
-}
-export function parsePortArg(value) {
-    const n = Number.parseInt(value, 10);
-    if (!Number.isFinite(n) || n <= 0 || n > 65535) {
-        throw userError(`Invalid --port value: "${value}"`, "use an integer between 1 and 65535");
-    }
-    return n;
-}
-export function parsePositiveIntArg(flagName) {
-    return (value) => {
-        const n = Number.parseInt(value, 10);
-        if (!Number.isFinite(n) || n <= 0) {
-            throw userError(`Invalid ${flagName} value: "${value}"`, "use a positive integer");
-        }
-        return n;
-    };
-}