hoomanjs 1.29.2 → 1.30.0

package/dist/core/prompts/bundled.js

@@ -0,0 +1,14 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const PROMPTS_ROOT = dirname(fileURLToPath(import.meta.url));
+export function bundledPromptPath(...parts) {
+    return join(PROMPTS_ROOT, ...parts);
+}
+export function hasBundledPrompt(...parts) {
+    return existsSync(bundledPromptPath(...parts));
+}
+export function readBundledPrompt(...parts) {
+    return readFileSync(bundledPromptPath(...parts), "utf8").trim();
+}
+//# sourceMappingURL=bundled.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bundled.js","sourceRoot":"","sources":["../../../src/core/prompts/bundled.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE7D,MAAM,UAAU,iBAAiB,CAAC,GAAG,KAAe;IAClD,OAAO,IAAI,CAAC,YAAY,EAAE,GAAG,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAG,KAAe;IACjD,OAAO,UAAU,CAAC,iBAAiB,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAG,KAAe;IAClD,OAAO,YAAY,CAAC,iBAAiB,CAAC,GAAG,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC"}

package/dist/core/prompts/environment.d.ts

@@ -4,7 +4,6 @@ type EnvironmentPromptContext = {
     osVersion: string;
     shell: string;
     isGitRepo: boolean;
-    currentDateTime: string;
     timeZone: string;
 };
 export declare function getEnvironmentPromptContext(): EnvironmentPromptContext;

package/dist/core/prompts/environment.js

@@ -37,14 +37,12 @@ function detectTimeZone() {
 }
 export function getEnvironmentPromptContext() {
     const cwd = process.cwd();
-    const now = new Date();
     return {
         cwd,
         platform: detectPlatform(),
         osVersion: detectOsVersion(),
         shell: detectShell(),
         isGitRepo: detectGitRepo(cwd),
-        currentDateTime: now.toString(),
         timeZone: detectTimeZone(),
     };
 }

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

@@ -1 +1 @@
-{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/core/prompts/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,OAAO,IAAI,SAAS,EACpB,IAAI,IAAI,MAAM,EACd,OAAO,IAAI,SAAS,GACrB,MAAM,SAAS,CAAC;AAYjB,SAAS,cAAc;IACrB,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC5D,CAAC,CAAC,OAAO,CAAC,QAAQ;QAClB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;AACvB,CAAC;AAED,SAAS,eAAe;IACtB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,GAAG,SAAS,EAAE,IAAI,SAAS,EAAE,EAAE,CAAC;IACzC,CAAC;IACD,OAAO,GAAG,MAAM,EAAE,IAAI,SAAS,EAAE,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,KAAK,GACT,OAAO,CAAC,GAAG,CAAC,KAAK;QACjB,OAAO,CAAC,GAAG,CAAC,OAAO;QACnB,OAAO,CAAC,GAAG,CAAC,OAAO;QACnB,SAAS,CAAC;IACZ,OAAO,KAAK,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;AACnC,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,IAAI,OAAO,GAAG,QAAQ,CAAC;IACvB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,cAAc;IACrB,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ,IAAI,SAAS,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO;QACL,GAAG;QACH,QAAQ,EAAE,cAAc,EAAE;QAC1B,SAAS,EAAE,eAAe,EAAE;QAC5B,KAAK,EAAE,WAAW,EAAE;QACpB,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC;QAC7B,eAAe,EAAE,GAAG,CAAC,QAAQ,EAAE;QAC/B,QAAQ,EAAE,cAAc,EAAE;KAC3B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/core/prompts/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,OAAO,IAAI,SAAS,EACpB,IAAI,IAAI,MAAM,EACd,OAAO,IAAI,SAAS,GACrB,MAAM,SAAS,CAAC;AAWjB,SAAS,cAAc;IACrB,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC5D,CAAC,CAAC,OAAO,CAAC,QAAQ;QAClB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;AACvB,CAAC;AAED,SAAS,eAAe;IACtB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,OAAO,GAAG,SAAS,EAAE,IAAI,SAAS,EAAE,EAAE,CAAC;IACzC,CAAC;IACD,OAAO,GAAG,MAAM,EAAE,IAAI,SAAS,EAAE,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,KAAK,GACT,OAAO,CAAC,GAAG,CAAC,KAAK;QACjB,OAAO,CAAC,GAAG,CAAC,OAAO;QACnB,OAAO,CAAC,GAAG,CAAC,OAAO;QACnB,SAAS,CAAC;IACZ,OAAO,KAAK,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;AACnC,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,IAAI,OAAO,GAAG,QAAQ,CAAC;IACvB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,cAAc;IACrB,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ,IAAI,SAAS,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,2BAA2B;IACzC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1B,OAAO;QACL,GAAG;QACH,QAAQ,EAAE,cAAc,EAAE;QAC1B,SAAS,EAAE,eAAe,EAAE;QAC5B,KAAK,EAAE,WAAW,EAAE;QACpB,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC;QAC7B,QAAQ,EAAE,cAAc,EAAE;KAC3B,CAAC;AACJ,CAAC"}

package/dist/core/prompts/index.d.ts

@@ -1,7 +1,4 @@
 import type { Config } from "../config.js";
-import type { Registry } from "../skills/registry.js";
-import { Skills } from "./skills.js";
 import { System, type SystemMode } from "./system.js";
-export { Skills, System };
+export { System };
 export declare function system(path: string, config: Config, mode?: SystemMode): Promise<System>;
-export declare function skills(registry: Registry): Promise<Skills>;

package/dist/core/prompts/index.js

@@ -1,14 +1,8 @@
-import { Skills } from "./skills.js";
 import { System } from "./system.js";
-export { Skills, System };
+export { System };
 export async function system(path, config, mode = "default") {
     const prompt = new System(path, config, mode);
     await prompt.reload();
     return prompt;
 }
-export async function skills(registry) {
-    const prompt = new Skills(registry);
-    await prompt.reload();
-    return prompt;
-}
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/prompts/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAmB,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,IAAY,EACZ,MAAc,EACd,OAAmB,SAAS;IAE5B,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IACtB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAkB;IAC7C,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IACtB,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAmB,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,IAAY,EACZ,MAAc,EACd,OAAmB,SAAS;IAE5B,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IACtB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/prompts/modes/agent.md

@@ -0,0 +1,3 @@
+## Agent mode
+
+You are in **agent** mode and can make use of any available tool to fulfil your current task.

package/dist/core/prompts/modes/ask.md

@@ -1,3 +1,5 @@
+## Ask mode
+
 You are in **ask** mode: a narrowed tool surface for exploration, research, and answering questions.
 
 ## Ask mode
@@ -9,9 +11,9 @@ You are in **ask** mode: a narrowed tool surface for exploration, research, and
 ### Discipline
 
 - Do **not** imply you can use tools that are not exposed in this phase.
-- If the user needs a **written plan on disk** and the staged planning workflow, they should switch to **plan** mode (or **default** when those tools are available).
-- If they want **full implementation** or unrestricted editing commands, they should switch to **default** mode (or approve work explicitly once they have switched).
-- When **`run_agents`** is available, use it only for **read-only** parallel exploration; you remain responsible for synthesizing answers.
+- If the user needs a **written plan on disk** and the staged planning workflow, they should switch to **plan** mode (or **agent** when those tools are available).
+- If they want **full implementation** or unrestricted editing commands, they should switch to **agent** mode (or approve work explicitly once they have switched).
+- When **`run_subagents`** is available, use it only for **read-only** parallel exploration; you remain responsible for synthesizing answers.
 
 ### Output
 

package/dist/core/prompts/modes/plan.md

@@ -6,7 +6,7 @@ You are in planning mode. **Implementation still requires an explicit go-ahead f
 
 ### Mandatory order
 
-1. **Plan stub before exploration.** If the line above shows **—**, your **only** tool call until the path appears must be **`enter_plan_mode`**. Do **not** run **`list_directory`**, **`read_file`**, **`fetch`**, **`web_search`**, **`run_agents`**, wiki tools, or any other tool first—there is nothing substantive to inspect until the plan document exists. You may send a **short** chat line saying you are allocating the plan; then call **`enter_plan_mode`** in that same turn.
+1. **Plan stub before exploration.** If the line above shows **—**, your **only** tool call until the path appears must be **`enter_plan_mode`**. Do **not** run **`list_directory`**, **`read_file`**, **`fetch`**, **`web_search`**, **`run_subagents`**, or any other tool first—there is nothing substantive to inspect until the plan document exists. You may send a **short** chat line saying you are allocating the plan; then call **`enter_plan_mode`** in that same turn.
 2. **Treat that file as the single source of truth.** Do not rely on chat alone to hold the plan—everything negotiated belongs in the plan file.
 3. **Every assistant turn** after the plan path exists: incorporate user messages (and new facts), then **update the plan file** with **`write_file`** / **`edit_file`** so it reflects objectives, constraints, open questions, and steps. If the user corrects or adds information, **edit the plan file in the same turn**.
 
@@ -20,7 +20,7 @@ Exception: if the user **explicitly** asks you to read a specific path they gave
 
 ### Boundaries (your direct actions)
 
-- Do not create, edit, move, or delete files **other than the plan file** shown above (delegated **`run_agents`** tasks stay **read-only** exploration).
+- Do not create, edit, move, or delete files **other than the plan file** shown above (delegated **`run_subagents`** tasks stay **read-only** exploration).
 - Do not run commands that change system state outside tools exposed in this mode.
 - Do not ship the final deliverable here—only the reviewed plan document.
 

package/dist/core/prompts/session-mode-appendix.d.ts

@@ -1,16 +1,10 @@
-import type { LocalAgent } from "@strands-agents/sdk";
+import { ContextInjector } from "@strands-agents/sdk/vended-plugins/context-injector";
 import { type SessionMode } from "../state/session-mode.js";
-export declare function registerAgentSystemPromptBaseBuilder(agent: LocalAgent, buildBase: () => Promise<string>): void;
-/** Rebuild base instructions from disk/config and re-apply the session-mode appendix. */
-export declare function refreshAgentFullSystemPrompt(agent: LocalAgent): Promise<void>;
 /** Plain snapshot of selected `appState` entries for mode prompts (Handlebars `state`). */
 export declare function snapshotAppStateForSessionModePrompt(agent: {
     appState: {
         get(key: string): unknown;
     };
 }): Record<string, unknown>;
-export declare function composeSystemPromptWithSessionMode(base: string, mode: SessionMode, 
-/** Values read as `state` in plan mode Handlebars (e.g. `lookup state 'hooman.planFile'`). */
-sessionModeState?: Record<string, unknown>): string;
-/** Applies the session-mode appendix to `base` and updates `agent.systemPrompt` when it changes. */
-export declare function refreshAgentSystemPromptForSessionMode(agent: LocalAgent, base: string): void;
+export declare function renderSessionModePrompt(mode: SessionMode, sessionModeState?: Record<string, unknown>): string;
+export declare function createSessionModePromptPlugin(): ContextInjector;

package/dist/core/prompts/session-mode-appendix.js

@@ -1,11 +1,10 @@
-import { existsSync, readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
 import handlebars from "handlebars";
+import { ContextInjector } from "@strands-agents/sdk/vended-plugins/context-injector";
+import { hasBundledPrompt, readBundledPrompt } from "./bundled.js";
+import { getModeDefinition, } from "../modes/definitions.js";
 import { PLAN_ENTERED_AT_STATE_KEY, PLAN_ENTER_REASON_STATE_KEY, PLAN_FILE_STATE_KEY, } from "../state/plan.js";
 import { getModeState, MODE_STATE_KEY, } from "../state/session-mode.js";
 const { compile } = handlebars;
-const SECTION_BREAK = "\n\n---\n\n";
 /** Keys exposed as `state` in session-mode Handlebars templates (e.g. plan.md). */
 const SESSION_MODE_TEMPLATE_STATE_KEYS = [
     MODE_STATE_KEY,
@@ -13,29 +12,13 @@ const SESSION_MODE_TEMPLATE_STATE_KEYS = [
     PLAN_ENTER_REASON_STATE_KEY,
     PLAN_ENTERED_AT_STATE_KEY,
 ];
-let cachedPlanTemplateSource = null;
-let cachedPlanTemplateCompiled = null;
-let cachedAskAppendix = null;
-const systemPromptBaseBuilders = new WeakMap();
-export function registerAgentSystemPromptBaseBuilder(agent, buildBase) {
-    systemPromptBaseBuilders.set(agent, buildBase);
-}
-/** Rebuild base instructions from disk/config and re-apply the session-mode appendix. */
-export async function refreshAgentFullSystemPrompt(agent) {
-    const build = systemPromptBaseBuilders.get(agent);
-    if (!build) {
-        return;
-    }
-    const base = await build();
-    refreshAgentSystemPromptForSessionMode(agent, base);
-}
+const cachedModeTemplates = new Map();
 function readBundledModeFile(file) {
-    const dir = join(dirname(fileURLToPath(import.meta.url)), "modes");
-    const full = join(dir, file);
-    if (!existsSync(full)) {
+    const parts = file.split("/");
+    if (!hasBundledPrompt(...parts)) {
         return "";
     }
-    return readFileSync(full, "utf8").trim();
+    return readBundledPrompt(...parts);
 }
 /** Plain snapshot of selected `appState` entries for mode prompts (Handlebars `state`). */
 export function snapshotAppStateForSessionModePrompt(agent) {
@@ -45,54 +28,34 @@ export function snapshotAppStateForSessionModePrompt(agent) {
     }
     return state;
 }
-function renderPlanAppendix(state) {
-    if (cachedPlanTemplateSource === null) {
-        cachedPlanTemplateSource = readBundledModeFile("plan.md");
-    }
-    if (!cachedPlanTemplateSource) {
-        return "";
-    }
-    if (cachedPlanTemplateCompiled === null) {
-        cachedPlanTemplateCompiled = compile(cachedPlanTemplateSource, {
-            strict: false,
-        });
-    }
-    return cachedPlanTemplateCompiled({ state }).trim();
-}
-function appendixForMode(mode, state) {
-    switch (mode) {
-        case "plan":
-            return renderPlanAppendix(state);
-        case "ask": {
-            if (cachedAskAppendix === null) {
-                cachedAskAppendix = readBundledModeFile("ask.md");
-            }
-            return cachedAskAppendix;
-        }
-        default:
+function renderModePrompt(config, state) {
+    let compiled = cachedModeTemplates.get(config.id);
+    if (!compiled) {
+        const source = readBundledModeFile(config.instructions);
+        if (!source) {
             return "";
+        }
+        compiled = compile(source, { strict: false });
+        cachedModeTemplates.set(config.id, compiled);
     }
+    return compiled({ state }).trim();
 }
-export function composeSystemPromptWithSessionMode(base, mode, 
-/** Values read as `state` in plan mode Handlebars (e.g. `lookup state 'hooman.planFile'`). */
-sessionModeState = {}) {
-    const extra = appendixForMode(mode, sessionModeState);
-    if (!extra) {
-        return base;
-    }
-    if (!base) {
-        return extra;
-    }
-    return `${base}${SECTION_BREAK}${extra}`;
-}
-/** Applies the session-mode appendix to `base` and updates `agent.systemPrompt` when it changes. */
-export function refreshAgentSystemPromptForSessionMode(agent, base) {
-    const mode = getModeState(agent).mode;
-    const sessionModeState = snapshotAppStateForSessionModePrompt(agent);
-    const next = composeSystemPromptWithSessionMode(base, mode, sessionModeState);
-    const cur = typeof agent.systemPrompt === "string" ? agent.systemPrompt : "";
-    if (cur !== next && typeof agent.systemPrompt === "string") {
-        agent.systemPrompt = next;
+export function renderSessionModePrompt(mode, sessionModeState = {}) {
+    const config = getModeDefinition(mode);
+    if (!config) {
+        return "";
     }
+    return renderModePrompt(config, sessionModeState);
+}
+export function createSessionModePromptPlugin() {
+    return new ContextInjector({
+        name: "hooman:session-mode-prompt",
+        trigger: "everyTurn",
+        renderContent: async ({ agent }) => {
+            const mode = getModeState(agent).mode;
+            const sessionModeState = snapshotAppStateForSessionModePrompt(agent);
+            return renderSessionModePrompt(mode, sessionModeState);
+        },
+    });
 }
 //# sourceMappingURL=session-mode-appendix.js.map

package/dist/core/prompts/session-mode-appendix.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-mode-appendix.js","sourceRoot":"","sources":["../../../src/core/prompts/session-mode-appendix.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-mode-appendix.js","sourceRoot":"","sources":["../../../src/core/prompts/session-mode-appendix.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EACL,iBAAiB,GAElB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,cAAc,GAEf,MAAM,0BAA0B,CAAC;AAElC,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC;AAE/B,mFAAmF;AACnF,MAAM,gCAAgC,GAAG;IACvC,cAAc;IACd,mBAAmB;IACnB,2BAA2B;IAC3B,yBAAyB;CACjB,CAAC;AAEX,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAsC,CAAC;AAE1E,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,iBAAiB,CAAC,GAAG,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,oCAAoC,CAAC,KAEpD;IACC,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,gCAAgC,EAAE,CAAC;QACnD,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CACvB,MAAsB,EACtB,KAA8B;IAE9B,IAAI,QAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,mBAAmB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9C,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,IAAiB,EACjB,mBAA4C,EAAE;IAE9C,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO,IAAI,eAAe,CAAC;QACzB,IAAI,EAAE,4BAA4B;QAClC,OAAO,EAAE,WAAW;QACpB,aAAa,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;YACjC,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;YACtC,MAAM,gBAAgB,GAAG,oCAAoC,CAAC,KAAK,CAAC,CAAC;YACrE,OAAO,uBAAuB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;QACzD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

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

@@ -7,11 +7,11 @@ You are running in the following runtime environment:
 - Shell: `{{ environment.shell }}`
 - OS version: `{{ environment.osVersion }}`
 - Is git repository: `{{ environment.isGitRepo }}`
-- Current date/time: `{{ environment.currentDateTime }}`
 - Time zone: `{{ environment.timeZone }}`
 
 ### How To Use This
 
 - Use this information to choose correct path handling, shell syntax, and platform-specific behavior
 - Treat this section as runtime context captured when the prompt was built
-- If the task needs precise current time during a later turn, call `get_current_time`
+- For precise current date/time on each model call, use the injected `<now>...</now>` ISO timestamp
+- Use `get_current_time` only when you need the current time in a specific timezone beyond the injected timestamp

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

@@ -0,0 +1,25 @@
+Please explore the current project directory and create or update `AGENTS.md` in the project root so it accurately explains this repository to AI coding agents.
+
+Requirements:
+
+1. Analyze the project structure and identify key configuration files such as `package.json`, `tsconfig.json`, `pyproject.toml`, `Cargo.toml`, and similar files when they exist.
+2. Understand the technology stack, build process, runtime architecture, and major entrypoints.
+3. Identify how the code is organized, including the main modules, packages, or feature areas.
+4. Discover project-specific development conventions, testing strategies, verification commands, and deployment or release workflows when they are present.
+5. Review any existing `AGENTS.md` content before changing it, preserve accurate guidance, remove stale claims, and improve the file in place instead of replacing useful information blindly.
+
+Output requirements for `AGENTS.md`:
+
+- Write only what you can verify from the repository.
+- Use the main natural language already used by the project docs and comments.
+- Keep it concise, practical, and easy for an agent to follow.
+- Prefer concrete commands, paths, and conventions over generic advice.
+
+Useful sections usually include:
+
+- Project overview
+- Repository layout
+- Build and run commands
+- Testing and verification
+- Code style or implementation conventions
+- Security or operational notes

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