min-agent 0.3.0 → 0.4.0

package/dist/config.js

@@ -1,7 +1,9 @@
-import { readFileSync, writeFileSync, mkdirSync, existsSync, statSync } from "fs";
+import { readFileSync, mkdirSync, existsSync, statSync } from "fs";
 import path from "path";
 import os from "os";
 import readline from "readline";
+import { atomicWriteFileSync } from "./tools/atomic-file.js";
+import { getEffectiveSandboxPolicy, mergeSandboxConfig, parseSandboxConfig, sandboxLaunchSource, sandboxStatusLabel, } from "./sandbox.js";
 const DEFAULT_CONFIG_DIR = path.join(os.homedir(), ".min-agent");
 const CONFIG_FILE_NAME = "config.json";
 const RULES_FILE_NAME = "rules.md";
@@ -47,11 +49,11 @@ export function saveProjectConfig(config) {
     mkdirSync(dir, { recursive: true });
     // Keep unknown keys, drop empty skill arrays so the file stays minimal.
     const { disabledSkills, enabledSkills, ...rest } = config;
-    writeFileSync(getProjectConfigFile(), JSON.stringify({
+    atomicWriteFileSync(getProjectConfigFile(), JSON.stringify({
         ...rest,
         ...(disabledSkills?.length ? { disabledSkills } : {}),
         ...(enabledSkills?.length ? { enabledSkills } : {}),
-    }, null, 2), "utf-8");
+    }, null, 2));
     projectCache.delete(getProjectConfigFile());
 }
 export function loadConfigFile(configFile) {
@@ -62,7 +64,10 @@ export function loadConfigFile(configFile) {
     catch {
         return {};
     }
-    if (cachedConfig && cachedConfig.file === configFile && cachedConfig.mtimeMs === st.mtimeMs && cachedConfig.size === st.size) {
+    if (cachedConfig &&
+        cachedConfig.file === configFile &&
+        cachedConfig.mtimeMs === st.mtimeMs &&
+        cachedConfig.size === st.size) {
         return cachedConfig.config;
     }
     let config;
@@ -97,6 +102,110 @@ export function migrateLegacyConfig(config) {
         migrated: true,
     };
 }
+export function mergeProjectOverGlobal(global, project) {
+    const activeProvider = project.activeProvider ?? global.activeProvider;
+    const sampling = project.sampling ? { ...global.sampling, ...project.sampling } : global.sampling;
+    const budget = project.budget ? { ...global.budget, ...project.budget } : global.budget;
+    const permission = parsePermissionMode(project.permission) ?? parsePermissionMode(global.permission);
+    const sandbox = mergeSandboxConfig(parseSandboxConfig(global.sandbox), parseSandboxConfig(project.sandbox));
+    const compaction = project.compaction ? { ...global.compaction, ...project.compaction } : global.compaction;
+    const agent = project.agent ? { ...global.agent, ...project.agent } : global.agent;
+    let providers = global.providers;
+    if (project.defaultModel && providers && providers.length > 0) {
+        const idx = activeProvider ? providers.findIndex((p) => p.name === activeProvider) : 0;
+        const target = idx >= 0 ? idx : 0;
+        providers = providers.map((p, i) => (i === target ? { ...p, defaultModel: project.defaultModel } : p));
+    }
+    return {
+        ...global,
+        activeProvider,
+        sampling,
+        budget,
+        permission,
+        ...(sandbox ? { sandbox } : {}),
+        compaction,
+        agent,
+        ...(providers ? { providers } : {}),
+    };
+}
+export function getEffectiveConfig() {
+    return mergeProjectOverGlobal(loadConfig(), loadProjectConfig());
+}
+export function getBudgetSnapshot() {
+    const global = loadConfig();
+    const project = loadProjectConfig();
+    const maxCostUSD = mergeProjectOverGlobal(global, project).budget?.maxCostUSD;
+    const source = project.budget?.maxCostUSD != null ? "project" : global.budget?.maxCostUSD != null ? "global" : null;
+    return { maxCostUSD, source };
+}
+export function parsePermissionMode(value) {
+    if (value === "ask" || value === "accept-edits" || value === "allow-all")
+        return value;
+    return undefined;
+}
+export function permissionModeLabel(mode) {
+    if (mode === "allow-all")
+        return "allow all";
+    if (mode === "accept-edits")
+        return "accept edits";
+    return "ask";
+}
+export function getPermissionSnapshot() {
+    const global = loadConfig();
+    const project = loadProjectConfig();
+    const permission = parsePermissionMode(project.permission) ?? parsePermissionMode(global.permission) ?? "ask";
+    const source = parsePermissionMode(project.permission) != null
+        ? "project"
+        : parsePermissionMode(global.permission) != null
+            ? "global"
+            : null;
+    return { permission, source };
+}
+export function setPermissionMode(permission, scope) {
+    if (scope === "project") {
+        const project = loadProjectConfig();
+        saveProjectConfig({ ...project, permission });
+        return;
+    }
+    saveConfig({ ...loadConfig(), permission });
+}
+export function setSandboxConfig(partial, scope) {
+    if (scope === "project") {
+        const project = loadProjectConfig();
+        const current = parseSandboxConfig(project.sandbox) ?? {};
+        saveProjectConfig({ ...project, sandbox: { ...current, ...partial } });
+        return;
+    }
+    const cfg = loadConfig();
+    const current = parseSandboxConfig(cfg.sandbox) ?? {};
+    saveConfig({ ...cfg, sandbox: { ...current, ...partial } });
+}
+export function getSandboxSnapshot() {
+    const policy = getEffectiveSandboxPolicy();
+    const launch = sandboxLaunchSource();
+    const project = parseSandboxConfig(loadProjectConfig().sandbox);
+    const global = parseSandboxConfig(loadConfig().sandbox);
+    const projectSet = Boolean(project?.mode || project?.network || project?.extraWriteRoots?.length || project?.extraReadRoots?.length);
+    const globalSet = Boolean(global?.mode || global?.network || global?.extraWriteRoots?.length || global?.extraReadRoots?.length);
+    const source = launch ?? (projectSet ? "project" : globalSet ? "global" : null);
+    return {
+        mode: policy.mode,
+        network: policy.network,
+        extraWriteRoots: policy.extraWriteRoots,
+        extraReadRoots: policy.extraReadRoots,
+        source,
+        label: sandboxStatusLabel(policy),
+    };
+}
+export function setBudgetMaxCost(maxCostUSD, scope) {
+    if (scope === "project") {
+        const project = loadProjectConfig();
+        saveProjectConfig({ ...project, budget: { ...project.budget, maxCostUSD } });
+        return;
+    }
+    const cfg = loadConfig();
+    saveConfig({ ...cfg, budget: { ...cfg.budget, maxCostUSD } });
+}
 export function getActiveProvider(config) {
     if (!config.providers || config.providers.length === 0)
         return undefined;
@@ -115,7 +224,7 @@ export function normalizeOllamaBaseURL(baseURL) {
 export function saveConfig(config) {
     const dir = getConfigDir();
     mkdirSync(dir, { recursive: true });
-    writeFileSync(path.join(dir, CONFIG_FILE_NAME), JSON.stringify(config, null, 2), "utf-8");
+    atomicWriteFileSync(path.join(dir, CONFIG_FILE_NAME), JSON.stringify(config, null, 2));
     cachedConfig = null;
 }
 export function isConfigured() {
@@ -167,7 +276,7 @@ function loadModelsCache() {
 }
 function saveModelsCache(models) {
     mkdirSync(getConfigDir(), { recursive: true });
-    writeFileSync(modelsCachePath(), JSON.stringify(models), "utf-8");
+    atomicWriteFileSync(modelsCachePath(), JSON.stringify(models));
 }
 export async function fetchModels(baseURL, apiKey) {
     try {
@@ -217,7 +326,9 @@ export async function runSetup() {
         const choice = await ask(rl, "选择 (1/2/3/4)", "4");
         if (choice === "1") {
             const provider = await collectProvider(rl, undefined);
-            provider.name = (await ask(rl, "Provider 名称", `provider-${providers.length + 1}`)).trim() || `provider-${providers.length + 1}`;
+            provider.name =
+                (await ask(rl, "Provider 名称", `provider-${providers.length + 1}`)).trim() ||
+                    `provider-${providers.length + 1}`;
             providers.push(provider);
             config.activeProvider = provider.name;
             config.providers = providers;
@@ -272,9 +383,7 @@ async function collectProvider(rl, existing) {
     console.log("  3. ollama (本地 Ollama)");
     console.log();
     const typeChoice = await ask(rl, "选择 Provider (1/2/3)", existing?.type === "ollama" ? "3" : existing?.type === "openai" ? "2" : "1");
-    const providerType = typeChoice === "3" ? "ollama"
-        : typeChoice === "2" ? "openai"
-            : "openai-compatible";
+    const providerType = typeChoice === "3" ? "ollama" : typeChoice === "2" ? "openai" : "openai-compatible";
     let baseURL;
     let apiKey;
     if (providerType === "ollama") {

package/dist/confirm.js

@@ -1,14 +1,42 @@
-import { loadConfig } from "./config.js";
+import { AsyncLocalStorage } from "async_hooks";
+import { getEffectiveConfig } from "./config.js";
+import { normalizeQuestionOptions, normalizeQuestionPrompt } from "./question-format.js";
 import readline from "readline";
 let autoApprove = false;
 export function setAutoApprove(value) {
     autoApprove = value;
 }
 export function isAutoApprove() {
+    const ctx = confirmAls.getStore();
+    if (ctx)
+        return ctx.autoApprove;
     if (autoApprove)
         return true;
-    const config = loadConfig();
-    return config.permission === "allow-all";
+    return getPermissionMode() === "allow-all";
+}
+let permissionOverride;
+export function setPermissionOverride(mode) {
+    permissionOverride = mode;
+}
+export function getPermissionOverride() {
+    return permissionOverride;
+}
+export function getPermissionMode() {
+    if (permissionOverride)
+        return permissionOverride;
+    const config = getEffectiveConfig();
+    return config.permission === "allow-all" || config.permission === "accept-edits" || config.permission === "ask"
+        ? config.permission
+        : "ask";
+}
+export function isEditAutoApprove() {
+    if (isAutoApprove())
+        return true;
+    return getPermissionMode() === "accept-edits";
+}
+const confirmAls = new AsyncLocalStorage();
+export function runWithConfirmContext(ctx, fn) {
+    return confirmAls.run(ctx, fn);
 }
 /** Optional readline interface to pause/resume during confirmation prompts. */
 let _rl = null;
@@ -27,17 +55,28 @@ export function setTuiQuestion(handler) {
 }
 /** Ask the user a free-form question. Returns the answer, or null if cancelled. */
 export async function askQuestion(prompt, options) {
+    const safePrompt = normalizeQuestionPrompt(prompt);
+    const choices = normalizeQuestionOptions(options);
+    const safeOptions = choices.length > 0 ? choices : undefined;
+    const ctx = confirmAls.getStore();
+    if (ctx) {
+        if (ctx.autoApprove)
+            return null;
+        if (ctx.onQuestion)
+            return ctx.onQuestion(safePrompt, safeOptions);
+        return null;
+    }
     if (_tuiQuestion)
-        return _tuiQuestion(prompt, options);
+        return _tuiQuestion(safePrompt, safeOptions);
     if (!process.stdin.isTTY) {
-        console.log(`\n\x1b[33m❓ ${prompt} (no interactive terminal — skipped)\x1b[0m`);
+        console.log(`\n\x1b[33m❓ ${safePrompt} (no interactive terminal — skipped)\x1b[0m`);
         return null;
     }
     console.log();
-    console.log(`\x1b[33m❓ ${prompt}\x1b[0m`);
-    if (options && options.length > 0) {
-        for (let i = 0; i < options.length; i++) {
-            console.log(`\x1b[90m   ${i + 1}. ${options[i]}\x1b[0m`);
+    console.log(`\x1b[33m❓ ${safePrompt}\x1b[0m`);
+    if (safeOptions) {
+        for (let i = 0; i < safeOptions.length; i++) {
+            console.log(`\x1b[90m   ${i + 1}. ${safeOptions[i]}\x1b[0m`);
         }
     }
     return new Promise((resolve) => {
@@ -56,6 +95,14 @@ export async function askQuestion(prompt, options) {
  * Display order: detail first, then [y/N] prompt at the bottom.
  */
 export async function confirm(message) {
+    const ctx = confirmAls.getStore();
+    if (ctx) {
+        if (ctx.autoApprove)
+            return true;
+        if (ctx.onConfirm)
+            return ctx.onConfirm(message);
+        return false;
+    }
     if (isAutoApprove())
         return true;
     // If TUI mode is active, delegate to the TUI overlay

package/dist/context-window.js

@@ -1,17 +1,19 @@
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { readFileSync, mkdirSync, existsSync } from "fs";
 import path from "path";
-import { getConfigDir, loadConfig, getActiveProvider } from "./config.js";
+import { atomicWriteFileSync } from "./tools/atomic-file.js";
+import { getConfigDir, getEffectiveConfig, getActiveProvider } from "./config.js";
 /**
  * Auto-detect context window size for the current model.
  *
  * Resolution order:
  * 1. User config: provider.contextWindow (explicit override)
- * 2. Provider-specific API (OpenRouter, vLLM, Ollama)
+ * 2. Provider-specific API (OpenRouter, vLLM, Ollama, OpenAI-compatible /models)
  * 3. models.dev API lookup
- * 4. Fallback: 128000
+ * 4. Fallback: 512000 (memory only — never persisted as a detected value)
  */
-const DEFAULT_CONTEXT_WINDOW = 128000;
-const CACHE_TTL = 7 * 24 * 60 * 60 * 1000; // 7 days
+export const DEFAULT_CONTEXT_WINDOW = 512000;
+const CACHE_TTL = 7 * 24 * 60 * 60 * 1000;
+const FALLBACK_MEMORY_TTL = 10 * 60 * 1000;
 function cacheFile() {
     return path.join(getConfigDir(), "context-window-cache.json");
 }
@@ -31,26 +33,72 @@ function loadDiskCache() {
 function saveCache(cache) {
     const file = cacheFile();
     mkdirSync(path.dirname(file), { recursive: true });
-    writeFileSync(file, JSON.stringify(cache), "utf-8");
+    atomicWriteFileSync(file, JSON.stringify(cache));
+}
+function cacheTtl(source) {
+    return source === "fallback" ? FALLBACK_MEMORY_TTL : CACHE_TTL;
 }
 function getCached(modelId) {
     const memory = memoryCache.get(modelId);
-    if (memory && Date.now() - memory.timestamp <= CACHE_TTL)
-        return memory.contextWindow;
-    const disk = loadDiskCache()[modelId];
-    if (disk && Date.now() - disk.timestamp <= CACHE_TTL) {
-        memoryCache.set(modelId, disk);
-        return disk.contextWindow;
+    if (memory && Date.now() - memory.timestamp <= cacheTtl(memory.source)) {
+        return { tokens: memory.contextWindow, source: memory.source };
     }
-    return null;
+    const disk = loadDiskCache()[modelId];
+    if (!disk || disk.source !== "detected")
+        return null;
+    if (Date.now() - disk.timestamp > CACHE_TTL)
+        return null;
+    memoryCache.set(modelId, { ...disk, source: "detected" });
+    return { tokens: disk.contextWindow, source: "detected" };
 }
-function setCache(modelId, contextWindow) {
-    const entry = { contextWindow, timestamp: Date.now() };
+function setCache(modelId, contextWindow, source) {
+    const entry = { contextWindow, timestamp: Date.now(), source };
     memoryCache.set(modelId, entry);
+    if (source !== "detected")
+        return;
     const cache = loadDiskCache();
     cache[modelId] = entry;
     saveCache(cache);
 }
+export function extractModelContextLength(model) {
+    if (!model || typeof model !== "object")
+        return null;
+    const rec = model;
+    const nested = [rec, rec.meta, rec.limits, rec.limit, rec.model_info];
+    const keys = [
+        "context_length",
+        "max_model_len",
+        "max_model_length",
+        "max_context_length",
+        "context_window",
+        "max_input_tokens",
+        "max_total_tokens",
+        "context",
+        "general.context_length",
+    ];
+    for (const obj of nested) {
+        if (!obj || typeof obj !== "object")
+            continue;
+        const bag = obj;
+        for (const key of keys) {
+            const n = bag[key];
+            if (typeof n === "number" && Number.isFinite(n) && n >= 4096)
+                return Math.floor(n);
+        }
+    }
+    return null;
+}
+function matchListedModel(models, modelId) {
+    const exact = models.find((m) => m && typeof m === "object" && m.id === modelId);
+    if (exact)
+        return exact;
+    return models.find((m) => {
+        if (!m || typeof m !== "object")
+            return false;
+        const id = m.id;
+        return typeof id === "string" && (id.endsWith(`/${modelId}`) || modelId.endsWith(`/${id}`));
+    });
+}
 /** Try OpenRouter: GET /api/v1/models returns context_length per model */
 async function tryOpenRouter(baseURL, apiKey, modelId) {
     if (!baseURL.includes("openrouter"))
@@ -63,8 +111,7 @@ async function tryOpenRouter(baseURL, apiKey, modelId) {
         if (!response.ok)
             return null;
         const data = (await response.json());
-        const model = data.data?.find((m) => m.id === modelId);
-        return model?.context_length ?? null;
+        return extractModelContextLength(matchListedModel(data.data ?? [], modelId));
     }
     catch {
         return null;
@@ -83,9 +130,27 @@ async function tryVllm(baseURL, apiKey, modelId) {
         if (!response.ok)
             return null;
         const data = (await response.json());
-        const model = (data.data ?? []).find((m) => m.id === modelId);
-        // vLLM exposes max_model_len on the model object
-        return model?.max_model_len ?? model?.max_model_length ?? null;
+        return extractModelContextLength(matchListedModel(data.data ?? [], modelId));
+    }
+    catch {
+        return null;
+    }
+}
+/** Any OpenAI-compatible /models that advertises context length (1M custom endpoints included). */
+async function tryProviderModels(baseURL, apiKey, modelId) {
+    if (!baseURL)
+        return null;
+    try {
+        const url = `${baseURL.replace(/\/$/, "")}/models`;
+        const response = await fetch(url, {
+            headers: { Authorization: `Bearer ${apiKey}` },
+            signal: AbortSignal.timeout(8000),
+        });
+        if (!response.ok)
+            return null;
+        const data = (await response.json());
+        const models = Array.isArray(data) ? data : (data.data ?? []);
+        return extractModelContextLength(matchListedModel(models, modelId));
     }
     catch {
         return null;
@@ -108,9 +173,7 @@ async function tryOllama(baseURL, modelId) {
             return null;
         const data = (await response.json());
         // Ollama returns model_info with context length
-        const ctxLength = data.model_info?.["general.context_length"] ??
-            data.model_info?.context_length ??
-            data.parameters?.num_ctx;
+        const ctxLength = data.model_info?.["general.context_length"] ?? data.model_info?.context_length ?? data.parameters?.num_ctx;
         return typeof ctxLength === "number" ? ctxLength : null;
     }
     catch {
@@ -155,35 +218,32 @@ async function detectContextWindow(config, id) {
         tryOpenRouter(baseURL, apiKey, id),
         tryOllama(baseURL, id),
         tryVllm(baseURL, apiKey, id),
+        tryProviderModels(baseURL, apiKey, id),
         tryModelsDev(id),
     ]);
     const found = results.find((v) => v !== null);
     if (found) {
-        setCache(id, found);
-        return found;
+        setCache(id, found, "detected");
+        return { tokens: found, source: "detected" };
     }
-    setCache(id, DEFAULT_CONTEXT_WINDOW);
-    return DEFAULT_CONTEXT_WINDOW;
+    setCache(id, DEFAULT_CONTEXT_WINDOW, "fallback");
+    return { tokens: DEFAULT_CONTEXT_WINDOW, source: "fallback" };
 }
 /**
- * Get context window size for the current model.
- * Tries multiple sources, caches the result in memory and on disk.
- * Concurrent calls for the same model share a single probe.
+ * Get context window size and whether it was configured, detected, or guessed.
+ * Fallback 512k is never written to disk as a detected value.
  */
-export async function getContextWindow(modelId) {
-    const config = loadConfig();
+export async function getContextWindowInfo(modelId) {
+    const config = getEffectiveConfig();
     const provider = getActiveProvider(config);
-    // 1. Explicit user config
     if (provider?.contextWindow)
-        return provider.contextWindow;
+        return { tokens: provider.contextWindow, source: "config" };
     const id = modelId ?? provider?.defaultModel;
     if (!id)
-        return DEFAULT_CONTEXT_WINDOW;
-    // 2. Check cache
+        return { tokens: DEFAULT_CONTEXT_WINDOW, source: "fallback" };
     const cached = getCached(id);
-    if (cached !== null)
+    if (cached)
         return cached;
-    // 3. Reuse an in-flight probe for the same model
     const pending = inFlight.get(id);
     if (pending)
         return pending;
@@ -196,3 +256,11 @@ export async function getContextWindow(modelId) {
         inFlight.delete(id);
     }
 }
+/**
+ * Get context window size for the current model.
+ * Tries multiple sources, caches detected results in memory and on disk.
+ * Concurrent calls for the same model share a single probe.
+ */
+export async function getContextWindow(modelId) {
+    return (await getContextWindowInfo(modelId)).tokens;
+}