min-agent 0.4.1 → 0.5.1

package/skills/self-config/reference.md

@@ -24,6 +24,8 @@ Read this when you need exact keys. Files are strict JSON.
   "instructions": ["./docs/rules.md"],
   "disabledSkills": [],
   "permission": "ask",
+  "thinking": "max",
+  "memory": "on",
   "sandbox": {
     "mode": "off",
     "network": "allow",
@@ -54,7 +56,9 @@ Read this when you need exact keys. Files are strict JSON.
 }
 ```
 
-- `contextWindow`: tokens; omit to query the API, then 512k fallback.
+- `thinking`: `off` | `low` | `medium` | `high` | `max`; omit to use medium. A project `thinking` value overlays global; writing thinking globally removes the project overlay so the chosen level is what later sessions use. `/think --project` writes only the project file.
+- `memory`: `on` | `off`; omit to keep **off**. When off, stored `memory.json` entries are not injected and memory tools are unavailable. A project `memory` value overlays global; writing memory globally removes the project overlay. `/memory --project` writes only the project file.
+- `contextWindow`: tokens; omit to query the API. An `ollama` provider uses `POST /api/show`: Modelfile `num_ctx` if set, otherwise min(architecture context_length, 32768), else 2048. Chat goes to native `POST /api/chat` with that value as `options.num_ctx` (OpenAI-compatible `/v1` ignores it). Interactive `/ctx` (and `min-agent ctx`) sets this field on the active ollama provider to a fixed level (`2k` / `4k` / `8k` / `12k` / `16k` / `32k` / `64k` / `128k` / `256k`) or `auto` to clear it. Other providers then 512k fallback.
 - `agent.autoContinue` omitted → uses `compaction.autoContinue` (default true).
 - `agent.maxSteps` omitted → no tool-step ceiling.
 - `agent.maxEmptyAttempts` / `agent.emptyRetryDelayMs`: retries when the provider returns an empty stream (HTTP 200, no content). First retry is immediate, later ones back off exponentially, capped at 8s.
@@ -66,14 +70,15 @@ Read this when you need exact keys. Files are strict JSON.
 - `MIN_AGENT_TRACE=1` logs a request/response summary for every model call (model, message and tool counts, status, time to first byte).
 - Web search/fetch that has not yet produced the requested output still continues even when `autoContinue` is false; further search/fetch calls return a stop-and-write notice instead of new results.
 - Old single-provider configs migrate on first run; write the `providers` array for new files.
+- Interactive and non-interactive provider setup both go through `min-agent setup`. API keys are written only to the global config.
 
 ## Project `.min-agent/config.json`
 
 Allowed keys (no `providers`, no API keys, no search secrets):
 
-`disabledSkills`, `enabledSkills`, `activeProvider`, `defaultModel`, `sampling`, `budget`, `permission`, `sandbox`, `compaction`, `agent`.
+`disabledSkills`, `enabledSkills`, `activeProvider`, `defaultModel`, `sampling`, `budget`, `permission`, `thinking`, `memory`, `sandbox`, `compaction`, `agent`.
 
-Present keys overlay the global file. Nested objects `sampling` / `budget` / `sandbox` / `compaction` / `agent` merge per field. `defaultModel` overrides the active provider's model without copying keys.
+Present keys overlay the global file. Nested objects `sampling` / `budget` / `sandbox` / `compaction` / `agent` merge per field. `defaultModel` overrides the active provider's model without copying keys. Writing `thinking` or `memory` to global config also removes the matching project overlay.
 
 ## `mcp.json`
 
@@ -127,16 +132,17 @@ Default: confirm before run. `readOnly: true` or `dangerous: false` skips confir
 
 ## Memory `memory.json`
 
-Array of `{ "content": string, "tags": string[], "created": string }`. Prefer memory tools.
+Array of `{ "content": string, "tags": string[], "created": string }`. Prefer memory tools when `memory` is `on`. Injected as background reference each turn only when enabled, not as pending work. Do not store secrets or API keys. The enable switch lives in config (`memory`), not in this file.
 
 ## Environment overrides
 
 | Variable | Role |
 |----------|------|
-| `MIN_AGENT_CONFIG_DIR` | Replaces `~/.min-agent` |
+| `MIN_AGENT_CONFIG_DIR` | Replaces `~/.min-agent` (includes `model-catalog-cache.json`, `thinking-wire-cache.json`, `ollama-model-cache.json`) |
 | `MIN_AGENT_SKILLS_DIRS` | Replaces user skill roots (path-delimiter separated) |
 | `MIN_AGENT_NO_BUILTIN_SKILLS` | `1` / `true` skips packaged skills |
 | `MIN_AGENT_SANDBOX` / `MIN_AGENT_SANDBOX_NETWORK` | Isolation |
+| `MIN_AGENT_MODELS_API_URL` | Model catalog base (default `https://models.lonae.com`) |
 | `MIN_AGENT_SERPER_API_KEY` | Overrides `serperApiKey` |
 | `MIN_AGENT_SEARXNG_URL` | Overrides `webSearchURL` (SearXNG instead of Serper) |
 | `MIN_AGENT_SEARXNG_FALLBACK_ENGINES` | Default `google,bing`; empty string disables retry |
@@ -146,4 +152,4 @@ Array of `{ "content": string, "tags": string[], "created": string }`. Prefer me
 
 ## HTTP (only if the user is running `min-agent serve`)
 
-Skills: `GET /v1/skills`, `GET /v1/skills/:name`, `POST /v1/skills/reload`, `POST /v1/skills/:name/enable|disable` with `{ "scope": "project"|"global" }`. MCP enable/disable similarly. Full list is `docs/API.md` in the min-agent package; do not treat that file as this skill's replacement.
+Skills: `GET /v1/skills`, `GET /v1/skills/:name`, `POST /v1/skills/reload`, `POST /v1/skills/:name/enable|disable` with `{ "scope": "project"|"global" }`. MCP enable/disable similarly. Thinking: `GET/POST /v1/thinking`. Memory switch: `GET/POST /v1/memory/mode`. Ollama context level: `GET/POST /v1/context` with `{ "level": "8k" }` or `"auto"`. Full list is `docs/API.md` in the min-agent package; do not treat that file as this skill's replacement.