hoomanjs 1.29.2 → 1.31.0

package/dist/core/prompts/static/memory.md

@@ -1,125 +1,11 @@
-## Memory
+Extract durable facts worth remembering across future conversations from a transcript.
 
-You have long-term memory tools:
+Use the `remember` tool once for each discrete fact worth saving.
+Each tool call must match the full ExtractionResult shape: `content` plus optional `metadata`.
 
-- `memory_add(scope, content, type, metadata?)`
-- `memory_search(scope, query, types?, k?)`
-- `memory_archive(scope, id, reason?)`
-
-Use memory to preserve durable context across sessions. Do not treat memory as source of truth over current user instructions.
-
-### Scopes
-
-- `user`: useful across many repositories/sessions for the same user.
-- `project`: specific to the current repository or working directory.
-- Rule of thumb:
-  - If it helps only this codebase/task flow -> `project`
-  - If it reflects stable personal preference/style/rule across projects -> `user`
-
-### Types
-
-- `fact`: stable concrete info
-- `observation`: pattern noticed from recent work
-- `preference`: how user wants things done
-- `task`: ongoing objective or follow-up commitment
-
-### Required Habit After Successful Work
-
-After each successful, non-trivial turn, add one very concise `project` memory capturing:
-
-- what was done
-- how it was done
-- why that approach was used
-
-Keep this to 1-2 short sentences total.
-
-If, during the same turn, you identify something broadly reusable across projects (preference, style, recurring rule, communication preference), also add a separate `user` memory.
-
-### What To Store
-
-Store only information that is likely to matter later:
-
-- decisions, constraints, conventions, trade-offs
-- user preferences that affect future behavior
-- durable troubleshooting findings and known pitfalls
-- active tasks/goals that may continue in later sessions
-
-Do not store:
-
-- transient one-off chatter
-- data obvious from current files unless the decision/rationale matters
-- duplicate entries with no new value
-
-### How To Write `content`
-
-Write retrieval-friendly content:
-
-- concise and specific
-- include key nouns (feature/module/file/tool)
-- include outcome + rationale
-- avoid fluff
-
-Good pattern:
-
-- `<Outcome>. <Method>. <Reason/constraint>.`
-
-### `metadata` Usage
-
-Use `metadata` as optional structured context (dictionary), for example:
-
-- `files`: touched paths
-- `decision`: short decision tag
-- `reason`: main rationale
-- `scope_hint`: optional discriminator
-- `title`: short label (helps embeddings)
-
-Prefer small, meaningful keys and values.
-
-### When To Search
-
-Use `memory_search` when prior context may matter:
-
-- user says "continue", "as before", "same style", "like last time"
-- implementation likely depends on earlier decisions
-- personalization may affect response style or technical choices
-
-Avoid broad fishing queries. Use targeted query strings and optional `types` filters.
-
-### Examples
-
-Project memory after successful turn:
-
-- `memory_add`
-  - `scope`: `project`
-  - `type`: `fact`
-  - `content`: `Created a consistent scope strategy so project-specific context stays separated from broader user context. Updated the workflow guide to match the new memory commands and argument order. Chosen to improve retrieval precision and reduce accidental cross-context mixing.`
-  - `metadata`: `{ "title": "scope strategy update", "decision": "context-isolation" }`
-
-User preference memory:
-
-- `memory_add`
-  - `scope`: `user`
-  - `type`: `preference`
-  - `content`: `User prefers concise updates and practical, low-overhead solutions unless extra detail is requested.`
-  - `metadata`: `{ "title": "communication preference", "style": "concise" }`
-
-Targeted search:
-
-- `memory_search`
-  - `scope`: `project`
-  - `query`: `scope strategy archive behavior usage guidance`
-  - `types`: `[ "fact", "observation" ]`
-  - `k`: `5`
-
-Archive obsolete memory:
-
-- `memory_archive`
-  - `scope`: `project`
-  - `id`: `<memory-id>`
-  - `reason`: `Superseded by newer guidance and no longer reflects current behavior`
-
-### Conflict Handling
-
-- Current user message and current session context override memory.
-- If memory conflicts with fresh instructions, follow fresh instructions.
-- Archive stale/incorrect memory once confirmed.
+Only save facts that are likely to be useful in a later conversation without rereading this transcript.
+High-value memories include things like user preferences, standing requirements, recurring workflows, long-lived goals, stable project context, durable decisions, and constraints that should influence future behavior.
+Low-value memories include things like transient chatter, one-off requests, intermediate reasoning, raw tool output, temporary diagnostics, and facts that were only useful for the current turn.
+Prefer memories that will still matter later over details that were merely true during this exchange.
+If nothing is worth saving, do not call the tool.
+When you are done, respond briefly with `done`.

package/dist/core/prompts/static/planning.md

@@ -10,7 +10,7 @@ Call **`enter_plan_mode`** when the task is multi-step, ambiguous, or could caus
 
 - You receive a **`plan_file`** path under the app plans directory. Expand it with **`read_file`**, **`write_file`**, and **`edit_file`** as needed (paths must stay within allowed locations).
 - Prefer **`think`** or **`update_todos`** to organize reasoning; avoid shell and other tools not exposed in this phase.
-- **`run_agents`** is available: use it for **read-only** parallel exploration when splitting investigations helps (same discipline as subagents—narrow prompts, synthesize results yourself). Child agents are constrained like other tooling in this phase; you remain responsible for the plan document.
+- **`run_subagents`** is available: use it for **read-only** parallel exploration when splitting investigations helps (same discipline as subagents—narrow prompts, synthesize results yourself). Child agents are constrained like other tooling in this phase; you remain responsible for the plan document.
 
 ### Leaving plan mode
 

package/dist/core/prompts/static/skills.md

@@ -1,18 +1,19 @@
 ## Skills
 
-You may have a dynamic **Available skills** or **Built-in skills** section elsewhere in the system prompt listing installed skills with absolute paths to each `SKILL.md`.
+You may have an `<available_skills>` section elsewhere in the system prompt listing skill names, descriptions, and optional `SKILL.md` locations. Use the `skills` tool to activate a skill and load its full instructions when needed.
 
 ### When to use a skill during this turn
 
 - When the user's goal, stack, or workflow clearly matches a listed skill (same product, API, or task family), treat that skill as the preferred playbook before improvising.
-- **Programming and implementation** (creating or changing source, tests, tooling config, dependencies, package manifests, installs, builds, or new scaffold directories): **before** your first implementation tool call in that task, **read** the built-in **hooman-coding** `SKILL.md` from the path under **Built-in skills** using your filesystem tool. Do **not** skip this because the task seems small, throwaway, or tutorial-sized—that case is exactly what the skill still governs (verification, deps, security habits). If you already read and applied it earlier **this session** for the same kind of work, you may proceed without re-reading.
-- When you are unsure but a skill's title plausibly fits the task, open its `SKILL.md` using the **absolute path** from the Available skills list and skim it; if it helps, follow it for the rest of the turn.
-- Prefer **reading** `SKILL.md` over guessing conventions (naming, CLI flags, safety steps) that the skill is meant to encode.
+- **Programming and implementation** (creating or changing source, tests, tooling config, dependencies, package manifests, installs, builds, or new scaffold directories): **before** your first implementation tool call in that task, activate the built-in `hooman-coding` skill with the `skills` tool so you have its full instructions in context. Do **not** skip this because the task seems small, throwaway, or tutorial-sized.
+- When you are unsure but a listed skill plausibly fits the task, activate it with the `skills` tool and skim the returned instructions; if it helps, follow it for the rest of the turn.
+- Prefer using the `skills` tool over guessing conventions (naming, CLI flags, safety steps) that the skill is meant to encode.
 - Do **not** load skills unrelated to the request. Other skills stay selective; **hooman-coding** is the exception for any implementation work as above.
 
 ### Coordination with tools
 
-- Use **filesystem** tools to read `SKILL.md` at the given path when you need full instructions.
+- Use the `skills` tool to load full instructions.
+- Use **filesystem** tools to inspect a skill's `SKILL.md`, scripts, references, or assets only when the task specifically needs the underlying files.
 - When the user wants to manage Hooman skills, use the built-in `hooman-skills` skill and edit `~/.hooman/skills` directly.
 
 ### Goal

package/dist/core/prompts/static/subagents.md

@@ -1,6 +1,6 @@
 ## Sub Agents
 
-You can delegate specific work using the `run_agents` tool.
+You can delegate specific work using the `run_subagents` tool.
 
 Use this tool when delegation makes the response better:
 
@@ -15,7 +15,7 @@ Use delegation thoughtfully:
 - Prefer concise descriptions that state the expected output.
 - Run only as many jobs as needed for quality and speed.
 
-Do not use `run_agents` when:
+Do not use `run_subagents` when:
 
 - The task is simple and can be handled directly.
 - The work is tightly coupled and cannot be split cleanly.

package/dist/core/prompts/static/web-search.md

@@ -26,7 +26,8 @@ Do not invent provider-specific parameters.
 - Keep `query` focused on the topic, entity, source, and search operators.
 - Do not add specific dates, months, or years to `query` for recency unless the user explicitly asked for that date/month/year or it is essential to disambiguate the topic.
 - For "latest", "recent", "today", "this week", "this month", or other relative-time requests, use `freshness` or `start_date` + `end_date` instead of adding date words to `query`.
-- Use the current date/time from the Environment section when interpreting relative dates. If the task needs precise real time during a later turn, call `get_current_time` before choosing `freshness` or date ranges.
+- Use the injected `<now>...</now>` ISO timestamp when interpreting relative dates.
+- Use `get_current_time` only if you need current time in a specific timezone before choosing `freshness` or date ranges.
 
 ### Examples
 

package/dist/core/prompts/system.js

@@ -1,14 +1,13 @@
 import { existsSync, readFileSync, statSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
 import handlebars from "handlebars";
+import { bundledPromptPath, hasBundledPrompt, readBundledPrompt, } from "./bundled.js";
 import { getEnvironmentPromptContext } from "./environment.js";
+import { candidateAgentInstructionPaths, readAgentInstructions, } from "./runtime.js";
 const { compile } = handlebars;
 /** Bundled markdown next to this module (`prompts/static/`). */
 const STATIC_PROMPT_FILES = [
     "identity.md",
     "environment.md",
-    "memory.md",
     "todo.md",
     "thinking.md",
     "filesystem.md",
@@ -18,7 +17,6 @@ const STATIC_PROMPT_FILES = [
     "sleep.md",
     "bye.md",
     "daemon.md",
-    "wiki.md",
     "skills.md",
     "subagents.md",
     "planning.md",
@@ -30,7 +28,6 @@ const HARNESS_PROMPT_FILES = [
     { key: "guardrails", file: "guardrails.md" },
 ];
 const SECTION_BREAK = "\n\n---\n\n";
-const EXTRA_CWD_INSTRUCTIONS = "AGENTS.md";
 /**
  * Loads `prompts/static/*.md` from the package, then `instructions.md` from disk,
  * concatenates them, and renders with Handlebars using `context`.
@@ -50,8 +47,6 @@ export class System {
     staticPromptFiles() {
         return STATIC_PROMPT_FILES.filter((file) => {
             switch (file) {
-                case "memory.md":
-                    return this.config.tools.memory.enabled;
                 case "fetch.md":
                     return this.config.tools.fetch.enabled;
                 case "web-search.md":
@@ -64,8 +59,6 @@ export class System {
                     return this.config.tools.shell.enabled;
                 case "sleep.md":
                     return this.config.tools.sleep.enabled;
-                case "wiki.md":
-                    return this.config.tools.wiki.enabled;
                 case "subagents.md":
                     return this.config.tools.agents.enabled;
                 case "daemon.md":
@@ -76,14 +69,12 @@ export class System {
         });
     }
     readBundledStaticPrompts() {
-        const dir = join(dirname(fileURLToPath(import.meta.url)), "static");
         const parts = [];
         for (const file of this.staticPromptFiles()) {
-            const full = join(dir, file);
-            if (!existsSync(full)) {
+            if (!hasBundledPrompt("static", file)) {
                 continue;
             }
-            const text = readFileSync(full, "utf8").trim();
+            const text = readBundledPrompt("static", file);
             if (text.length > 0) {
                 parts.push(text);
             }
@@ -91,17 +82,15 @@ export class System {
         return parts.join("\n\n");
     }
     readBundledHarnessPrompts() {
-        const dir = join(dirname(fileURLToPath(import.meta.url)), "harness");
         const parts = [];
         for (const { key, file } of HARNESS_PROMPT_FILES) {
             if (!this.config.prompts[key]) {
                 continue;
             }
-            const full = join(dir, file);
-            if (!existsSync(full)) {
+            if (!hasBundledPrompt("harness", file)) {
                 continue;
             }
-            const text = readFileSync(full, "utf8").trim();
+            const text = readBundledPrompt("harness", file);
             if (text.length > 0) {
                 parts.push(text);
             }
@@ -109,11 +98,7 @@ export class System {
         return parts.join("\n\n");
     }
     readCwdAgentsInstructions() {
-        const path = join(process.cwd(), EXTRA_CWD_INSTRUCTIONS);
-        if (!existsSync(path)) {
-            return "";
-        }
-        return readFileSync(path, "utf8").trim();
+        return readAgentInstructions();
     }
     /** Stats prompt sources so we only re-read disk + recompile Handlebars when files change. */
     computeSourceFingerprint() {
@@ -127,18 +112,18 @@ export class System {
             parts.push(`${label}:${st.mtimeMs}:${st.size}`);
         };
         pushPath("instructions", this.path);
-        const staticDir = join(dirname(fileURLToPath(import.meta.url)), "static");
         for (const file of this.staticPromptFiles()) {
-            pushPath(`static:${file}`, join(staticDir, file));
+            pushPath(`static:${file}`, bundledPromptPath("static", file));
         }
-        const harnessDir = join(dirname(fileURLToPath(import.meta.url)), "harness");
         for (const { key, file } of HARNESS_PROMPT_FILES) {
             if (!this.config.prompts[key]) {
                 continue;
             }
-            pushPath(`harness:${file}`, join(harnessDir, file));
+            pushPath(`harness:${file}`, bundledPromptPath("harness", file));
+        }
+        for (const path of candidateAgentInstructionPaths()) {
+            pushPath(`agents-md:${path}`, path);
         }
-        pushPath("agents-md", join(process.cwd(), EXTRA_CWD_INSTRUCTIONS));
         return parts.join("|");
     }
     readRawText() {
@@ -175,8 +160,6 @@ export class System {
             name: this.config.name,
             llm: this.config.llm,
             environment: getEnvironmentPromptContext(),
-            memory: this.config.tools.memory,
-            wiki: this.config.tools.wiki,
             compaction: this.config.compaction,
             mode: this.mode,
         };

package/dist/core/prompts/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","sourceRoot":"","sources":["../../../src/core/prompts/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC;AAE/B,gEAAgE;AAChE,MAAM,mBAAmB,GAAG;IAC1B,aAAa;IACb,gBAAgB;IAChB,WAAW;IACX,SAAS;IACT,aAAa;IACb,eAAe;IACf,UAAU;IACV,eAAe;IACf,UAAU;IACV,UAAU;IACV,QAAQ;IACR,WAAW;IACX,SAAS;IACT,WAAW;IACX,cAAc;IACd,aAAa;CACL,CAAC;AAEX,MAAM,oBAAoB,GAAG;IAC3B,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE;IAC1C,EAAE,GAAG,EAAE,eAAe,EAAE,IAAI,EAAE,kBAAkB,EAAE;IAClD,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,EAAE;IAC1C,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE;CACpC,CAAC;AAIX,MAAM,aAAa,GAAG,aAAa,CAAC;AACpC,MAAM,sBAAsB,GAAG,WAAW,CAAC;AAE3C;;;GAGG;AACH,MAAM,OAAO,MAAM;IACA,IAAI,CAAS;IACb,MAAM,CAAS;IACf,IAAI,CAAa;IAC1B,IAAI,GAAG,EAAE,CAAC;IACV,iBAAiB,GAAG,EAAE,CAAC;IACvB,gBAAgB,GAAsC,IAAI,CAAC;IAEnE,YACE,IAAY,EACZ,MAAc,EACd,OAAmB,SAAS;QAE5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAEO,iBAAiB;QACvB,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACzC,QAAQ,IAAI,EAAE,CAAC;gBACb,KAAK,WAAW;oBACd,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;gBAC1C,KAAK,UAAU;oBACb,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;gBACzC,KAAK,eAAe;oBAClB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;gBACpC,KAAK,SAAS;oBACZ,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;gBACxC,KAAK,eAAe;oBAClB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;gBAC9C,KAAK,UAAU;oBACb,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;gBACzC,KAAK,UAAU;oBACb,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC;gBACzC,KAAK,SAAS;oBACZ,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;gBACxC,KAAK,cAAc;oBACjB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;gBAC1C,KAAK,WAAW;oBACd,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;gBAChC;oBACE,OAAO,IAAI,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,wBAAwB;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QACpE,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,SAAS;YACX,CAAC;YACD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAEO,yBAAyB;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACrE,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,oBAAoB,EAAE,CAAC;YACjD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,SAAS;YACX,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,SAAS;YACX,CAAC;YACD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAEO,yBAAyB;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,sBAAsB,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IAED,6FAA6F;IACrF,wBAAwB;QAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,QAAgB,EAAE,EAAE;YACnD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC;gBAC/B,OAAO;YACT,CAAC;YACD,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC;QAEF,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC1E,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;YAC5C,QAAQ,CAAC,UAAU,IAAI,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC5E,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,oBAAoB,EAAE,CAAC;YACjD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC9B,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,WAAW,IAAI,EAAE,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,sBAAsB,CAAC,CAAC,CAAC;QACnE,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAEO,WAAW;QACjB,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;YACxC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE;YACxC,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,OAAO,GAAG,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,yBAAyB,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAE/C,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,oEAAoE;IAC5D,OAAO;QACb,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACtB,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG;YACpB,WAAW,EAAE,2BAA2B,EAAE;YAC1C,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM;YAChC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI;YAC5B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;YAClC,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,MAAM;QACjB,MAAM,EAAE,GAAG,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAC3C,IAAI,EAAE,KAAK,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;YACpE,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC/B,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3D,CAAC;CACF"}
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../../src/core/prompts/system.ts"],"names":[],"mappings":"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"}

package/dist/core/skills/built-in/hooman-config/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: hooman-config
-description: Read and update Hooman's own config.json and instructions.md safely. Use when the user asks about Hooman config, custom instructions, model providers, LLM params, tool toggles, prompts, search, memory, wiki (knowledge search), agents, compaction, or ~/.hooman config settings.
+description: Read and update Hooman's own config.json and instructions.md safely. Use when the user asks about Hooman config, custom instructions, model providers, LLM params, tool toggles, prompts, search, agents, compaction, or ~/.hooman config settings.
 ---
 
 # Hooman Config
@@ -18,9 +18,9 @@ Use this skill when the user asks you to inspect, explain, or change Hooman's ow
 
 1. Read the existing JSON first. Preserve user values, comments are not supported, and secrets such as API keys may be present.
 2. Make the smallest JSON edit that satisfies the request. Do not rewrite unrelated sections or normalize formatting beyond valid pretty JSON.
-3. `name` and `llms` are required. `llms` must be a **non-empty array** of entries (see below). `search`, `prompts`, `tools`, and `compaction` are optional in input, but Hooman expands them with defaults when loading.
+3. `name`, `providers`, and `llms` are required. `providers` stores shared credentials/config, and `llms` must be a **non-empty array** of entries that reference provider names (see below). `search`, `prompts`, `tools`, and `compaction` are optional in input, but Hooman expands them with defaults when loading.
 4. Unknown keys are unsupported and may be dropped when Hooman parses and persists the config.
-5. `tools.memory` has only `enabled` (embedding model is fixed in code; vectors live in the app data directory). `tools.wiki` has only `enabled` (when on, the agent gets `wiki_search` over the indexed knowledge base; ingestion is not configured here).
+5. `tools` only manages built-in runtime toggles exposed in `config.json`.
 6. Any change to `config.json` or `instructions.md` requires restarting the running Hooman agent/session before it takes effect.
 
 ## Full Config Shape
@@ -30,11 +30,20 @@ This is the default shape Hooman writes when `~/.hooman/config.json` is missing:
 ```json
 {
   "name": "Hooman",
+  "providers": [
+    {
+      "name": "ollama-local",
+      "options": {
+        "provider": "ollama",
+        "params": {}
+      }
+    }
+  ],
   "llms": [
     {
       "name": "Default",
       "options": {
-        "provider": "ollama",
+        "provider": "ollama-local",
         "model": "gemma4:e4b",
         "params": {}
       },
@@ -82,12 +91,6 @@ This is the default shape Hooman writes when `~/.hooman/config.json` is missing:
     "sleep": {
       "enabled": true
     },
-    "memory": {
-      "enabled": false
-    },
-    "wiki": {
-      "enabled": false
-    },
     "agents": {
       "enabled": true,
       "concurrency": 2
@@ -103,6 +106,7 @@ This is the default shape Hooman writes when `~/.hooman/config.json` is missing:
 ## Top-Level Options
 
 - `name`: non-empty display name for the agent.
+- `providers`: required reusable provider definitions. Configure shared credentials or transport params once, then reference the provider from one or more LLM entries.
 - `llms`: required non-empty list of named LLM configs (see **LLMs array**).
 - `search`: optional web search config; defaults to disabled Brave.
 - `prompts`: optional built-in static prompt toggles; omitted fields default to `true`. Custom user instructions live in `~/.hooman/instructions.md`.
@@ -114,14 +118,24 @@ This is the default shape Hooman writes when `~/.hooman/config.json` is missing:
 Each element of `llms` has:
 
 - `name`: non-empty label for this entry (for display and editing).
-- `options`: the provider configuration (`provider`, `model`, `params`) — same semantics as the former single `llm` object.
+- `options.provider`: provider reference name. It must match one of the entries in top-level `providers`.
+- `options.model`: model id passed to the resolved runtime provider.
+- `options.params`: model-specific params. When `options.provider` references a named provider, these params override the provider's shared params on key conflict.
 - `default`: boolean; mark **one** entry `"default": true` for the active model. If several have `true`, the **first** in the array wins; if none have `true`, Hooman uses the **first** entry—so keep a single default when possible.
 
 Runtime APIs may still expose a single active profile as `llm` (derived from the default entry); on disk the source of truth is always `llms`.
 
+## Providers array
+
+Each element of `providers` has:
+
+- `name`: non-empty reference name used by `llms[].options.provider`.
+- `options.provider`: runtime provider id such as `"openai"`, `"bedrock"`, or `"ollama"`.
+- `options.params`: shared provider params such as API keys, host/base URL, region, headers, or client config.
+
 ### LLM Providers
 
-`options.provider` must be one of the values Hooman registers at runtime (the config schema may list additional legacy enum values; stick to this set):
+`providers[].options.provider` must be one of the values Hooman registers at runtime (the config schema may list additional legacy enum values; stick to this set):
 
 ```json
 [
@@ -140,6 +154,17 @@ Common shape (single default model):
 
 ```json
 {
+  "providers": [
+    {
+      "name": "anthropic",
+      "options": {
+        "provider": "anthropic",
+        "params": {
+          "apiKey": "..."
+        }
+      }
+    }
+  ],
   "llms": [
     {
       "name": "Default",
@@ -147,7 +172,6 @@ Common shape (single default model):
         "provider": "anthropic",
         "model": "claude-sonnet-4-20250514",
         "params": {
-          "apiKey": "...",
           "temperature": 0.2,
           "maxTokens": 4096
         }
@@ -158,9 +182,9 @@ Common shape (single default model):
 }
 ```
 
-Provider notes (these refer to fields inside `options.params` unless noted):
+Provider notes (these refer to fields inside `providers[].options.params` unless noted; `llms[].options.params` can override them per model):
 
-- `anthropic`: Strands **AnthropicModel** (Anthropic Messages API via `@anthropic-ai/sdk`). `params.apiKey` or `params.authToken`, optional `baseURL` and `headers` (merged into `clientConfig`), optional `clientConfig`, plus model fields such as `temperature`, `maxTokens`, `topP`, `stopSequences`, and `params`. A custom `client` instance is not supported from config. If no key is set, `ANTHROPIC_API_KEY` is used.
+- `anthropic`: Strands **AnthropicModel** (Anthropic Messages API via `@anthropic-ai/sdk`). `params.apiKey` or `params.authToken`, optional `baseURL` and `headers` (merged into `clientConfig`), optional `clientConfig`, `betas`, and `useNativeTokenCount`, plus model fields such as `temperature`, `maxTokens`, `topP`, and `stopSequences`. Any unknown keys are forwarded into the underlying Anthropic Messages request body, so Anthropic-compatible providers can use fields like `thinking` or `service_tier` directly. A custom `client` instance is not supported from config. If no key is set, `ANTHROPIC_API_KEY` is used.
 - `google`: `params.apiKey`, `client`, `clientConfig`, and `builtInTools` are top-level Google model options. Other keys become Gemini generation params, such as `temperature`, `maxOutputTokens`, `topP`, and `topK`.
 - `groq`: `params.apiKey`, `baseURL`, and `headers` configure the provider. Other keys are forwarded as Vercel model config.
 - `moonshot`: `params.apiKey`, `baseURL`, `headers`, and `fetch` configure the provider. Other keys are forwarded as Vercel model config.
@@ -173,15 +197,25 @@ Examples:
 
 ```json
 {
+  "providers": [
+    {
+      "name": "ollama-local",
+      "options": {
+        "provider": "ollama",
+        "params": {
+          "host": "http://127.0.0.1:11434",
+          "think": "medium"
+        }
+      }
+    }
+  ],
   "llms": [
     {
       "name": "Local",
       "options": {
-        "provider": "ollama",
+        "provider": "ollama-local",
         "model": "qwen3:8b",
         "params": {
-          "host": "http://127.0.0.1:11434",
-          "think": "medium",
           "options": {
             "num_ctx": 32768,
             "temperature": 0.2
@@ -196,6 +230,17 @@ Examples:
 
 ```json
 {
+  "providers": [
+    {
+      "name": "google",
+      "options": {
+        "provider": "google",
+        "params": {
+          "apiKey": "..."
+        }
+      }
+    }
+  ],
   "llms": [
     {
       "name": "Gemini",
@@ -203,7 +248,6 @@ Examples:
         "provider": "google",
         "model": "gemini-2.5-flash",
         "params": {
-          "apiKey": "...",
           "temperature": 0.2,
           "maxOutputTokens": 8192
         }
@@ -216,12 +260,11 @@ Examples:
 
 ```json
 {
-  "llms": [
+  "providers": [
     {
-      "name": "Bedrock",
+      "name": "bedrock-dev",
       "options": {
         "provider": "bedrock",
-        "model": "anthropic.claude-3-5-sonnet-20241022-v2:0",
         "params": {
           "region": "us-west-2",
           "clientConfig": {
@@ -232,7 +275,18 @@ Examples:
               "secretAccessKey": "...",
               "sessionToken": "..."
             }
-          },
+          }
+        }
+      }
+    }
+  ],
+  "llms": [
+    {
+      "name": "Bedrock",
+      "options": {
+        "provider": "bedrock-dev",
+        "model": "anthropic.claude-3-5-sonnet-20241022-v2:0",
+        "params": {
           "temperature": 0.2,
           "maxTokens": 4096
         }
@@ -251,13 +305,33 @@ You may list several entries and flip which one is default:
 
 ```json
 {
+  "providers": [
+    {
+      "name": "openai",
+      "options": {
+        "provider": "openai",
+        "params": {
+          "apiKey": "..."
+        }
+      }
+    },
+    {
+      "name": "anthropic",
+      "options": {
+        "provider": "anthropic",
+        "params": {
+          "apiKey": "..."
+        }
+      }
+    }
+  ],
   "llms": [
     {
       "name": "Fast",
       "options": {
         "provider": "openai",
         "model": "gpt-4.1-mini",
-        "params": { "apiKey": "..." }
+        "params": {}
       },
       "default": true
     },
@@ -266,7 +340,7 @@ You may list several entries and flip which one is default:
       "options": {
         "provider": "anthropic",
         "model": "claude-opus-4-20250514",
-        "params": { "apiKey": "..." }
+        "params": {}
       },
       "default": false
     }
@@ -274,7 +348,7 @@ You may list several entries and flip which one is default:
 }
 ```
 
-When editing `llms`, preserve unrelated entries and API keys unless the user asks to remove or replace them.
+When editing `providers` or `llms`, preserve unrelated entries and API keys unless the user asks to remove or replace them.
 
 ## Search
 
@@ -339,15 +413,12 @@ Simple toggles:
     "filesystem": { "enabled": true },
     "shell": { "enabled": true },
     "sleep": { "enabled": true },
-    "memory": { "enabled": true },
-    "wiki": { "enabled": true }
+    "agents": { "enabled": true, "concurrency": 3 }
   }
 }
 ```
 
-With `wiki` enabled, the model only receives **`wiki_search`**: semantic retrieval over the knowledge index. There are no wiki write or list tools in config.
-
-Agents:
+Subagents:
 
 ```json
 {
@@ -360,10 +431,12 @@ Agents:
 }
 ```
 
-Defaults: `todo`, `fetch`, `filesystem`, `shell`, `sleep`, and `agents` enabled; `memory` and `wiki` disabled. Memory uses a local SQLite index and the built-in embedding model URI in code (`DEFAULT_EMBED_MODEL` in `core/config.ts`). MCP servers and installed skills are not controlled by these toggles; do not inspect or edit them for this skill.
+Defaults: `todo`, `fetch`, `filesystem`, `shell`, `sleep`, and `agents` enabled. MCP servers and installed skills are not controlled by these toggles; do not inspect or edit them for this skill.
 
 `agents`: the default file Hooman writes when `config.json` was missing includes `tools.agents.concurrency: 2`. On load, if `concurrency` is absent (for example `tools` or `tools.agents` is omitted), the merged config uses `3` until you set it explicitly.
 
+Compatibility note: the config key remains `tools.agents`, but it controls the built-in `run_subagents` tool.
+
 ## Instructions
 
 `~/.hooman/instructions.md` contains the user's custom instructions. Read or edit it only when the user asks about Hooman instructions, custom instructions, persistent guidance, or agent behavior that belongs outside `config.json`.