hoomanjs 1.29.2 → 1.30.0

package/dist/core/memory/file-store.js

@@ -0,0 +1,151 @@
+import { appendFile, mkdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { currentMemoryScope } from "./runtime.js";
+const DEFAULT_MAX_SEARCH_RESULTS = 3;
+const UNSAFE_PATH_CHARS = /[^a-z0-9_-]+/g;
+export class FileMemoryStore {
+    name;
+    description;
+    maxSearchResults;
+    writable;
+    extraction;
+    baseDir;
+    constructor(config) {
+        this.baseDir = config.baseDir;
+        this.name = config.name;
+        this.description = config.description;
+        this.maxSearchResults = config.maxSearchResults;
+        this.writable = config.writable ?? false;
+        this.extraction = config.extraction;
+    }
+    async search(query, options) {
+        const entries = await this.readEntries();
+        const limit = options?.maxSearchResults ??
+            this.maxSearchResults ??
+            DEFAULT_MAX_SEARCH_RESULTS;
+        const normalizedQuery = normalize(query);
+        const ranked = entries
+            .map((entry) => ({
+            entry,
+            score: scoreEntry(normalizedQuery, entry),
+        }))
+            .filter(({ score }) => score > 0 || normalizedQuery.length === 0)
+            .sort((left, right) => right.score - left.score)
+            .slice(0, limit);
+        return ranked.map(({ entry }) => ({
+            content: entry.content,
+            metadata: entry.metadata,
+        }));
+    }
+    async add(content, metadata) {
+        const trimmed = content.trim();
+        if (!trimmed) {
+            return;
+        }
+        const now = new Date().toISOString();
+        await this.appendEntry({
+            storeName: this.name,
+            content: trimmed,
+            ...(metadata ? { metadata } : {}),
+            createdAt: now,
+            updatedAt: now,
+        });
+    }
+    async readEntries() {
+        const path = this.scopeFilePath();
+        try {
+            const raw = await readFile(path, "utf8");
+            const byFingerprint = new Map();
+            for (const line of raw.split("\n")) {
+                const trimmed = line.trim();
+                if (!trimmed) {
+                    continue;
+                }
+                let parsed;
+                try {
+                    parsed = JSON.parse(trimmed);
+                }
+                catch {
+                    continue;
+                }
+                if (!isStoredEntry(parsed) || parsed.storeName !== this.name) {
+                    continue;
+                }
+                byFingerprint.set(createFingerprint(parsed.content, parsed.metadata), parsed);
+            }
+            return [...byFingerprint.values()];
+        }
+        catch (error) {
+            if (error instanceof Error &&
+                "code" in error &&
+                error.code === "ENOENT") {
+                return [];
+            }
+            throw error;
+        }
+    }
+    async appendEntry(entry) {
+        const path = this.scopeFilePath();
+        await mkdir(this.baseDir, { recursive: true });
+        await appendFile(path, `${JSON.stringify(entry)}\n`, "utf8");
+    }
+    scopeFilePath() {
+        return join(this.baseDir, `${sanitizePath(currentMemoryScope())}.jsonl`);
+    }
+}
+function isStoredEntry(value) {
+    if (!value || typeof value !== "object") {
+        return false;
+    }
+    const entry = value;
+    return (typeof entry.storeName === "string" &&
+        typeof entry.content === "string" &&
+        typeof entry.createdAt === "string" &&
+        typeof entry.updatedAt === "string");
+}
+function scoreEntry(normalizedQuery, entry) {
+    if (normalizedQuery.length === 0) {
+        return Date.parse(entry.updatedAt) || Date.parse(entry.createdAt) || 0;
+    }
+    const normalizedContent = normalize(entry.content);
+    if (normalizedContent.length === 0) {
+        return 0;
+    }
+    let score = 0;
+    if (normalizedContent.includes(normalizedQuery)) {
+        score += 100;
+    }
+    const contentTokens = new Set(tokenize(normalizedContent));
+    for (const token of tokenize(normalizedQuery)) {
+        if (contentTokens.has(token)) {
+            score += 10;
+        }
+        else if (normalizedContent.includes(token)) {
+            score += 4;
+        }
+    }
+    // Prefer fresher entries when lexical relevance is tied.
+    score += (Date.parse(entry.updatedAt) || 0) / 1_000_000_000_000;
+    return score;
+}
+function createFingerprint(content, metadata) {
+    return JSON.stringify({
+        content: normalize(content),
+        metadata: metadata ?? null,
+    });
+}
+function normalize(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function tokenize(value) {
+    return value.split(" ").filter(Boolean);
+}
+function sanitizePath(value) {
+    const normalized = value.trim().toLowerCase().replace(UNSAFE_PATH_CHARS, "_");
+    return normalized.length > 0 ? normalized : "default";
+}
+//# sourceMappingURL=file-store.js.map

package/dist/core/memory/file-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.js","sourceRoot":"","sources":["../../../src/core/memory/file-store.ts"],"names":[],"mappings":"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"}

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

@@ -1,5 +1,2 @@
-export { Brain } from "./brain.js";
-export type { Memory, MemoryType } from "./types.js";
-export type { Sqlite } from "./database.js";
-export { open, prepare } from "./database.js";
-export { create as createMemoryTools } from "./tools.js";
+export { FileMemoryStore } from "./file-store.js";
+export { currentMemoryScope, flushAgentMemory, runWithAgentMemoryScope, } from "./runtime.js";

package/dist/core/memory/index.js

@@ -1,4 +1,3 @@
-export { Brain } from "./brain.js";
-export { open, prepare } from "./database.js";
-export { create as createMemoryTools } from "./tools.js";
+export { FileMemoryStore } from "./file-store.js";
+export { currentMemoryScope, flushAgentMemory, runWithAgentMemoryScope, } from "./runtime.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,MAAM,IAAI,iBAAiB,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,cAAc,CAAC"}

package/dist/core/memory/runtime.d.ts

@@ -0,0 +1,4 @@
+import type { Agent } from "@strands-agents/sdk";
+export declare function currentMemoryScope(): string;
+export declare function runWithAgentMemoryScope<T>(agent: Agent, callback: () => Promise<T>): Promise<T>;
+export declare function flushAgentMemory(agent: Agent): Promise<void>;

package/dist/core/memory/runtime.js

@@ -0,0 +1,37 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+const DEFAULT_MEMORY_SCOPE = "default";
+const UNSAFE_SCOPE_CHARS = /[^a-z0-9_-]+/g;
+const memoryScopeStorage = new AsyncLocalStorage();
+export function currentMemoryScope() {
+    return memoryScopeStorage.getStore()?.scope ?? DEFAULT_MEMORY_SCOPE;
+}
+export async function runWithAgentMemoryScope(agent, callback) {
+    const scope = deriveAgentMemoryScope(agent);
+    return await memoryScopeStorage.run({ scope }, callback);
+}
+export async function flushAgentMemory(agent) {
+    await agent.memoryManager?.flush();
+}
+function deriveAgentMemoryScope(agent) {
+    const candidate = readString(agent, "userId") ?? readString(agent, "sessionId");
+    return sanitizeScope(candidate);
+}
+function readString(agent, key) {
+    const value = agent.appState.get(key);
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function sanitizeScope(value) {
+    if (!value) {
+        return DEFAULT_MEMORY_SCOPE;
+    }
+    const normalized = value
+        .trim()
+        .toLowerCase()
+        .replace(UNSAFE_SCOPE_CHARS, "_");
+    return normalized.length > 0 ? normalized : DEFAULT_MEMORY_SCOPE;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/core/memory/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../../src/core/memory/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD,MAAM,oBAAoB,GAAG,SAAS,CAAC;AACvC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAM3C,MAAM,kBAAkB,GAAG,IAAI,iBAAiB,EAAoB,CAAC;AAErE,MAAM,UAAU,kBAAkB;IAChC,OAAO,kBAAkB,CAAC,QAAQ,EAAE,EAAE,KAAK,IAAI,oBAAoB,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAY,EACZ,QAA0B;IAE1B,MAAM,KAAK,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IAC5C,OAAO,MAAM,kBAAkB,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAY;IACjD,MAAM,KAAK,CAAC,aAAa,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAY;IAC1C,MAAM,SAAS,GACb,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,UAAU,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAChE,OAAO,aAAa,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,UAAU,CAAC,KAAY,EAAE,GAAW;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,MAAM,UAAU,GAAG,KAAK;SACrB,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;IACpC,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB,CAAC;AACnE,CAAC"}

package/dist/core/models/anthropic.js

@@ -7,10 +7,31 @@ const RESERVED = new Set([
     "client",
     "clientConfig",
 ]);
+const TOP_LEVEL_MODEL_KEYS = new Set([
+    "temperature",
+    "topP",
+    "maxTokens",
+    "stopSequences",
+    "params",
+    "betas",
+    "useNativeTokenCount",
+]);
 function pickModelOptions(params) {
     const out = {};
     for (const [k, v] of Object.entries(params)) {
-        if (!RESERVED.has(k)) {
+        if (!RESERVED.has(k) && TOP_LEVEL_MODEL_KEYS.has(k)) {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+function pickRequestParams(params) {
+    const explicit = params.params;
+    const out = explicit && typeof explicit === "object" && !Array.isArray(explicit)
+        ? { ...explicit }
+        : {};
+    for (const [k, v] of Object.entries(params)) {
+        if (!RESERVED.has(k) && !TOP_LEVEL_MODEL_KEYS.has(k)) {
             out[k] = v;
         }
     }
@@ -67,6 +88,7 @@ export function create(model, params = {}) {
     const apiKey = resolveApiKey(params);
     const clientConfig = mergeClientConfig(params);
     const modelOpts = pickModelOptions(params);
+    const requestParams = pickRequestParams(params);
     return new AnthropicModel({
         modelId: model,
         ...(apiKey ? { apiKey } : {}),
@@ -74,6 +96,7 @@ export function create(model, params = {}) {
             ? { clientConfig }
             : {}),
         ...modelOpts,
+        ...(Object.keys(requestParams).length > 0 ? { params: requestParams } : {}),
     });
 }
 //# sourceMappingURL=anthropic.js.map

package/dist/core/models/anthropic.js.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../src/core/models/anthropic.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../src/core/models/anthropic.ts"],"names":[],"mappings":"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"}

package/dist/core/models/moonshot.js

@@ -1,5 +1,6 @@
 import { createMoonshotAI, moonshotai } from "@ai-sdk/moonshotai";
 import { VercelModel } from "@strands-agents/sdk/models/vercel";
+import { Message } from "@strands-agents/sdk";
 import lodash from "lodash";
 const { omit, pick } = lodash;
 const PROVIDER_SETTINGS_KEYS = [
@@ -8,6 +9,37 @@ const PROVIDER_SETTINGS_KEYS = [
     "headers",
     "fetch",
 ];
+class MoonshotModel extends VercelModel {
+    stream(messages, options) {
+        return super.stream(normalizeMessages(messages), options);
+    }
+}
+function normalizeMessages(messages) {
+    const normalized = [];
+    for (const message of messages) {
+        if (message.role !== "user") {
+            normalized.push(message);
+            continue;
+        }
+        const toolResults = [];
+        const otherContent = [];
+        for (const block of message.content) {
+            if (block.type === "toolResultBlock") {
+                toolResults.push(block);
+            }
+            else {
+                otherContent.push(block);
+            }
+        }
+        if (toolResults.length > 0 && otherContent.length > 0) {
+            normalized.push(new Message({ role: "user", content: toolResults }));
+            normalized.push(new Message({ role: "user", content: otherContent }));
+            continue;
+        }
+        normalized.push(message);
+    }
+    return normalized;
+}
 function pickProviderSettings(params) {
     const picked = pick(params, [...PROVIDER_SETTINGS_KEYS]);
     const unset = Object.keys(picked).filter((k) => picked[k] === undefined);
@@ -31,7 +63,7 @@ export function create(model, params = {}) {
     const settings = pickProviderSettings(params);
     const provider = Object.keys(settings).length > 0 ? createMoonshotAI(settings) : moonshotai;
     const config = pickVercelModelConfig(params);
-    return new VercelModel({
+    return new MoonshotModel({
         provider: provider(model),
         ...config,
     });

package/dist/core/models/moonshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"moonshot.js","sourceRoot":"","sources":["../../../src/core/models/moonshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAGhE,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;AAE9B,MAAM,sBAAsB,GAAG;IAC7B,QAAQ;IACR,SAAS;IACT,SAAS;IACT,OAAO;CACC,CAAC;AAEX,SAAS,oBAAoB,CAC3B,MAA+B;IAE/B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,sBAAsB,CAAC,CAGtD,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC,MAAM,EAAE,KAAK,CAA+B,CAAC;AAC3D,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAA+B;IAE/B,OAAO,IAAI,CAAC,MAAM,EAAE;QAClB,GAAG,sBAAsB;KAC1B,CAA+B,CAAC;AACnC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CACpB,KAAa,EACb,SAAkC,EAAE;IAEpC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,QAAQ,GACZ,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAC7E,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,OAAO,IAAI,WAAW,CAAC;QACrB,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC;QACzB,GAAG,MAAM;KACV,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"moonshot.js","sourceRoot":"","sources":["../../../src/core/models/moonshot.ts"],"names":[],"mappings":"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"}

package/dist/core/modes/definitions.d.ts

@@ -0,0 +1,19 @@
+import type { KnownSessionMode, SessionMode } from "./schema.js";
+export type ModeDefinition = {
+    id: KnownSessionMode;
+    name: string;
+    instructions: string;
+    description: string;
+    tools: "*" | readonly string[];
+};
+export declare const MODE_DEFINITIONS: readonly ModeDefinition[];
+export declare function getModeDefinition(mode: SessionMode): ModeDefinition | null;
+export declare function getModeTools(mode: SessionMode): "*" | readonly string[] | null;
+export declare function isModeDefinition(mode: SessionMode): boolean;
+export declare function getModeIds(): KnownSessionMode[];
+export declare function getModeOptions(): Array<{
+    value: KnownSessionMode;
+    name: string;
+    description: string;
+}>;
+export declare function formatModeNames(): string;

package/dist/core/modes/definitions.js

@@ -0,0 +1,99 @@
+export const MODE_DEFINITIONS = [
+    {
+        id: "agent",
+        name: "Agent",
+        instructions: "modes/agent.md",
+        description: "fully-feature agent surface",
+        tools: "*",
+    },
+    {
+        id: "plan",
+        name: "Plan",
+        instructions: "modes/plan.md",
+        description: "plan a larger piece of work to execute later",
+        tools: [
+            "fetch",
+            "web_search",
+            "skills",
+            "retrieve_offloaded_content",
+            "search_memory",
+            "strands_structured_output",
+            "update_todos",
+            "think",
+            "run_subagents",
+            "sleep",
+            "bye",
+            "convert_time",
+            "get_current_time",
+            "directory_tree",
+            "get_file_info",
+            "list_directory",
+            "search_files",
+            "read_file",
+            "read_multiple_files",
+            "write_file",
+            "edit_file",
+            "enter_plan_mode",
+            "exit_plan_mode",
+        ],
+    },
+    {
+        id: "ask",
+        name: "Ask",
+        instructions: "modes/ask.md",
+        description: "read-only tool surface for questions and answers",
+        tools: [
+            "fetch",
+            "web_search",
+            "skills",
+            "retrieve_offloaded_content",
+            "search_memory",
+            "strands_structured_output",
+            "update_todos",
+            "think",
+            "run_subagents",
+            "sleep",
+            "bye",
+            "convert_time",
+            "get_current_time",
+            "directory_tree",
+            "get_file_info",
+            "list_directory",
+            "search_files",
+            "read_file",
+            "read_multiple_files",
+            "write_file",
+            "edit_file",
+        ],
+    },
+];
+export function getModeDefinition(mode) {
+    if (!isModeDefinition(mode)) {
+        return null;
+    }
+    return MODE_DEFINITIONS.find((entry) => entry.id === mode) ?? null;
+}
+export function getModeTools(mode) {
+    return getModeDefinition(mode)?.tools ?? null;
+}
+export function isModeDefinition(mode) {
+    return MODE_DEFINITIONS.some((entry) => entry.id === mode);
+}
+export function getModeIds() {
+    return MODE_DEFINITIONS.map((entry) => entry.id);
+}
+export function getModeOptions() {
+    return MODE_DEFINITIONS.map((entry) => ({
+        value: entry.id,
+        name: entry.name,
+        description: entry.description,
+    }));
+}
+export function formatModeNames() {
+    const ids = getModeIds();
+    if (ids.length <= 1) {
+        return ids[0] ?? "";
+    }
+    return `${ids.slice(0, -1).join(", ")}, or ${ids.at(-1)}`;
+}
+//# sourceMappingURL=definitions.js.map

package/dist/core/modes/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../../src/core/modes/definitions.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IACzD;QACE,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,OAAO;QACb,YAAY,EAAE,gBAAgB;QAC9B,WAAW,EAAE,6BAA6B;QAC1C,KAAK,EAAE,GAAG;KACX;IACD;QACE,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,MAAM;QACZ,YAAY,EAAE,eAAe;QAC7B,WAAW,EAAE,8CAA8C;QAC3D,KAAK,EAAE;YACL,OAAO;YACP,YAAY;YACZ,QAAQ;YACR,4BAA4B;YAC5B,eAAe;YACf,2BAA2B;YAC3B,cAAc;YACd,OAAO;YACP,eAAe;YACf,OAAO;YACP,KAAK;YACL,cAAc;YACd,kBAAkB;YAClB,gBAAgB;YAChB,eAAe;YACf,gBAAgB;YAChB,cAAc;YACd,WAAW;YACX,qBAAqB;YACrB,YAAY;YACZ,WAAW;YACX,iBAAiB;YACjB,gBAAgB;SACjB;KACF;IACD;QACE,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,KAAK;QACX,YAAY,EAAE,cAAc;QAC5B,WAAW,EAAE,kDAAkD;QAC/D,KAAK,EAAE;YACL,OAAO;YACP,YAAY;YACZ,QAAQ;YACR,4BAA4B;YAC5B,eAAe;YACf,2BAA2B;YAC3B,cAAc;YACd,OAAO;YACP,eAAe;YACf,OAAO;YACP,KAAK;YACL,cAAc;YACd,kBAAkB;YAClB,gBAAgB;YAChB,eAAe;YACf,gBAAgB;YAChB,cAAc;YACd,WAAW;YACX,qBAAqB;YACrB,YAAY;YACZ,WAAW;SACZ;KACF;CACF,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,IAAiB;IACjD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,IAAiB;IAEjB,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAiB;IAChD,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,cAAc;IAK5B,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACtC,KAAK,EAAE,KAAK,CAAC,EAAE;QACf,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;IACD,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5D,CAAC"}

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

@@ -0,0 +1,3 @@
+export { MODE_DEFINITIONS, type ModeDefinition, formatModeNames, getModeDefinition, getModeIds, getModeOptions, getModeTools, isModeDefinition, } from "./definitions.js";
+export { DEFAULT_SESSION_MODE, MODE_IDS, isKnownSessionMode, type KnownSessionMode, type SessionMode, } from "./schema.js";
+export { loadModeDefinitions } from "./registry.js";

package/dist/core/modes/index.js

@@ -0,0 +1,4 @@
+export { MODE_DEFINITIONS, formatModeNames, getModeDefinition, getModeIds, getModeOptions, getModeTools, isModeDefinition, } from "./definitions.js";
+export { DEFAULT_SESSION_MODE, MODE_IDS, isKnownSessionMode, } from "./schema.js";
+export { loadModeDefinitions } from "./registry.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/modes/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAEhB,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,YAAY,EACZ,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,oBAAoB,EACpB,QAAQ,EACR,kBAAkB,GAGnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/core/modes/registry.d.ts

@@ -0,0 +1,9 @@
+import type { Config } from "../config.js";
+import { type ModeDefinition } from "./definitions.js";
+export type LoadedModeDefinition = Omit<ModeDefinition, "instructions"> & {
+    instructions: string;
+};
+export declare function loadModeDefinitions(config: Config, options?: {
+    knownTools?: readonly string[];
+    baseSystemPrompt?: string;
+}): LoadedModeDefinition[];

package/dist/core/modes/registry.js

@@ -0,0 +1,57 @@
+import handlebars from "handlebars";
+import { hasBundledPrompt, readBundledPrompt } from "../prompts/bundled.js";
+import { getEnvironmentPromptContext } from "../prompts/environment.js";
+import { MODE_DEFINITIONS } from "./definitions.js";
+const { compile } = handlebars;
+const SECTION_BREAK = "\n\n---\n\n";
+function filterKnownTools(definitions, knownTools) {
+    const known = new Set(knownTools);
+    return definitions.map((definition) => {
+        const tools = definition.tools !== "*"
+            ? definition.tools.filter((toolName) => known.has(toolName))
+            : knownTools;
+        return {
+            ...definition,
+            tools,
+        };
+    });
+}
+function context(config) {
+    return {
+        name: config.name,
+        llm: config.llm,
+        environment: getEnvironmentPromptContext(),
+        compaction: config.compaction,
+    };
+}
+export function loadModeDefinitions(config, options) {
+    const definitions = MODE_DEFINITIONS.map((entry) => {
+        if (!hasBundledPrompt(...entry.instructions.split("/"))) {
+            throw new Error(`Mode '${entry.id}' instructions file not found: ${entry.instructions}`);
+        }
+        const raw = readBundledPrompt(...entry.instructions.split("/"));
+        if (!raw) {
+            throw new Error(`Mode '${entry.id}' instructions file is empty: ${entry.instructions}`);
+        }
+        const renderedInstructions = compile(raw)(context(config)).trim();
+        const instructions = [
+            options?.baseSystemPrompt?.trim(),
+            renderedInstructions,
+        ]
+            .filter(Boolean)
+            .join(SECTION_BREAK)
+            .trim();
+        if (!instructions) {
+            throw new Error(`Mode '${entry.id}' instructions rendered to empty content.`);
+        }
+        return {
+            ...entry,
+            instructions,
+        };
+    });
+    if (options?.knownTools) {
+        return filterKnownTools(definitions, options.knownTools);
+    }
+    return definitions;
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/modes/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/core/modes/registry.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAuB,MAAM,kBAAkB,CAAC;AAEzE,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC;AAC/B,MAAM,aAAa,GAAG,aAAa,CAAC;AAMpC,SAAS,gBAAgB,CACvB,WAA4C,EAC5C,UAA6B;IAE7B,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAClC,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;QACpC,MAAM,KAAK,GACT,UAAU,CAAC,KAAK,KAAK,GAAG;YACtB,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC5D,CAAC,CAAC,UAAU,CAAC;QACjB,OAAO;YACL,GAAG,UAAU;YACb,KAAK;SACN,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,MAAc;IAC7B,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,WAAW,EAAE,2BAA2B,EAAE;QAC1C,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,OAAuE;IAEvE,MAAM,WAAW,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACjD,IAAI,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CACb,SAAS,KAAK,CAAC,EAAE,kCAAkC,KAAK,CAAC,YAAY,EAAE,CACxE,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,GAAG,iBAAiB,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,SAAS,KAAK,CAAC,EAAE,iCAAiC,KAAK,CAAC,YAAY,EAAE,CACvE,CAAC;QACJ,CAAC;QACD,MAAM,oBAAoB,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClE,MAAM,YAAY,GAAG;YACnB,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE;YACjC,oBAAoB;SACrB;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,aAAa,CAAC;aACnB,IAAI,EAAE,CAAC;QACV,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CACb,SAAS,KAAK,CAAC,EAAE,2CAA2C,CAC7D,CAAC;QACJ,CAAC;QACD,OAAO;YACL,GAAG,KAAK;YACR,YAAY;SACb,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;QACxB,OAAO,gBAAgB,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/core/modes/schema.d.ts

@@ -0,0 +1,5 @@
+export declare const MODE_IDS: readonly ["agent", "ask", "plan"];
+export type KnownSessionMode = (typeof MODE_IDS)[number];
+export type SessionMode = KnownSessionMode | (string & {});
+export declare const DEFAULT_SESSION_MODE: KnownSessionMode;
+export declare function isKnownSessionMode(mode: string): mode is KnownSessionMode;

package/dist/core/modes/schema.js

@@ -0,0 +1,6 @@
+export const MODE_IDS = ["agent", "ask", "plan"];
+export const DEFAULT_SESSION_MODE = "agent";
+export function isKnownSessionMode(mode) {
+    return MODE_IDS.includes(mode);
+}
+//# sourceMappingURL=schema.js.map

package/dist/core/modes/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/core/modes/schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAU,CAAC;AAK1D,MAAM,CAAC,MAAM,oBAAoB,GAAqB,OAAO,CAAC;AAE9D,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,QAAQ,CAAC,QAAQ,CAAC,IAAwB,CAAC,CAAC;AACrD,CAAC"}

package/dist/core/prompts/agents/research.md

@@ -1,16 +1,16 @@
-## Research Agent
+## Research mode
 
-You are the specialized research sub-agent for {{ name }}. You are the **only** delegated read-only helper the parent agent uses to explore and investigate before it takes action.
+You are in **research** mode: a delegated, read-only helper for exploring the workspace, gathering evidence, and returning high-signal findings to the parent agent.
 
-Your job is to explore the relevant working directory and codebase, pull in external sources when useful, and return **high-signal findings** so the parent agent knows what exists, how things fit together, and what is still uncertain.
-
-This is a strict read-only role:
+### Scope
 
 - Do not create, edit, move, or delete files.
 - Do not run commands that change system state.
 - Do not present guesses as facts; label inference clearly.
 
-How to work:
+Your job is to explore the relevant working directory and codebase, pull in external sources when useful, and return findings that help the parent agent understand what exists, how things fit together, and what is still uncertain.
+
+### How to work
 
 1. Parse the parent’s question and decide what evidence is needed (files, layout, docs, APIs, prior patterns, web or fetched sources).
 2. Explore efficiently: orient with layout and search, then drill into the smallest set of paths that answer the question.
@@ -19,14 +19,14 @@ How to work:
 5. When helpful, note sensible alternatives or trade-offs **as analysis**, not as instructions—the parent decides what to execute.
 6. Stop once the parent can act or answer without redundant digging.
 
-Quality bar:
+### Quality bar
 
 - Be precise, not verbose.
 - Separate **confirmed**, **likely**, and **unknown**.
 - Say what additional check would resolve each unknown.
 - Suggest how the parent could **verify** conclusions (what to read, run, or compare)—without performing mutating steps yourself.
 
-Return format:
+### Return format
 
 1. **Findings** — short bullets with evidence (paths, identifiers, sources).
 2. **Open Questions / Uncertainties** — only if relevant.

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

@@ -0,0 +1,3 @@
+export declare function bundledPromptPath(...parts: string[]): string;
+export declare function hasBundledPrompt(...parts: string[]): boolean;
+export declare function readBundledPrompt(...parts: string[]): string;