@oni.bot/core 1.0.2 → 1.1.0

package/dist/harness/loop/tools.js

@@ -0,0 +1,184 @@
+// ============================================================
+// @oni.bot/core/harness/loop — Tools
+// Tool schema → adapter conversion + sequential execution.
+// ============================================================
+import { validateToolArgs } from "../validate-args.js";
+import { makeMessage } from "./types.js";
+import { checkSafety } from "./safety.js";
+// ─── buildLLMTools ──────────────────────────────────────────────────────────
+/** Convert ToolDefinition[] to LLMToolDef[] for the model adapter. */
+export function buildLLMTools(tools) {
+    return tools.map((t) => ({
+        name: t.name,
+        description: t.description,
+        parameters: t.schema,
+    }));
+}
+/** Build a name → ToolDefinition lookup map. */
+export function buildToolMap(tools) {
+    const toolMap = new Map();
+    for (const t of tools) {
+        toolMap.set(t.name, t);
+    }
+    return toolMap;
+}
+/**
+ * Execute all tool calls for a turn.
+ * Returns tool results and any yield-able events (tool_start, tool_metadata).
+ */
+export async function executeTools(toolCalls, ctx) {
+    const { sessionId, threadId, turn, config, toolMap, hasMemoryLoader } = ctx;
+    const toolResults = [];
+    const events = [];
+    for (const toolCall of toolCalls) {
+        // Fire PreToolUse hook
+        if (config.hooksEngine) {
+            const preResult = await config.hooksEngine.fire("PreToolUse", {
+                sessionId,
+                toolName: toolCall.name,
+                input: toolCall.args,
+            });
+            if (preResult?.decision === "deny") {
+                toolResults.push({
+                    toolCallId: toolCall.id,
+                    toolName: toolCall.name,
+                    content: `Tool use denied: ${preResult.reason ?? "blocked by hook"}`,
+                    isError: true,
+                });
+                continue;
+            }
+            // Apply modifiedInput if hook returned one
+            if (preResult?.modifiedInput) {
+                Object.assign(toolCall.args, preResult.modifiedInput);
+            }
+        }
+        // Safety gate check
+        const safetyResult = await checkSafety(config.safetyGate, toolCall.id, toolCall.name, toolCall.args);
+        if (safetyResult !== null && !safetyResult.approved) {
+            toolResults.push({
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: `Tool blocked by safety gate: ${safetyResult.reason ?? "unsafe operation"}`,
+                isError: true,
+            });
+            continue;
+        }
+        // Find tool
+        const toolDef = toolMap.get(toolCall.name);
+        if (!toolDef) {
+            toolResults.push({
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: `Unknown tool: ${toolCall.name}`,
+                isError: true,
+            });
+            continue;
+        }
+        // Validate tool arguments before execution
+        if (toolDef.schema) {
+            const validationError = validateToolArgs(toolCall.args, toolDef.schema, toolCall.name);
+            if (validationError) {
+                toolResults.push({
+                    toolCallId: toolCall.id,
+                    toolName: toolCall.name,
+                    content: `${validationError}. Please retry with correct arguments.`,
+                    isError: true,
+                });
+                continue;
+            }
+        }
+        // Yield tool_start so the conductor can emit tool.call events
+        events.push(makeMessage("tool_start", sessionId, turn, {
+            metadata: {
+                toolName: toolCall.name,
+                toolArgs: toolCall.args,
+                toolCallId: toolCall.id,
+            },
+        }));
+        const metadataUpdates = [];
+        const toolCtx = {
+            config: {},
+            store: null,
+            state: {},
+            emit: () => { },
+            sessionId,
+            threadId,
+            agentName: config.agentName,
+            turn,
+            signal: config.signal,
+            metadata: (update) => {
+                metadataUpdates.push(update);
+            },
+        };
+        try {
+            const startTime = Date.now();
+            const rawResult = await toolDef.execute(toolCall.args, toolCtx);
+            const durationMs = Date.now() - startTime;
+            const content = typeof rawResult === "string" ? rawResult : JSON.stringify(rawResult);
+            // Push the successful result first — before the hook — so a hook
+            // throw cannot retroactively mark this tool call as failed.
+            toolResults.push({
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content,
+                durationMs,
+            });
+            // Yield collected metadata updates from ctx.metadata() calls
+            for (const mu of metadataUpdates) {
+                events.push(makeMessage("tool_metadata", sessionId, turn, {
+                    metadata: {
+                        toolCallId: toolCall.id,
+                        toolName: toolCall.name,
+                        title: mu.title,
+                        data: mu.metadata,
+                    },
+                }));
+            }
+            // Fire PostToolUse — in its own try/catch so a hook error does not
+            // corrupt the conversation history by triggering PostToolUseFailure
+            // for a tool that actually succeeded.
+            if (config.hooksEngine) {
+                try {
+                    await config.hooksEngine.fire("PostToolUse", {
+                        sessionId,
+                        toolName: toolCall.name,
+                        input: toolCall.args,
+                        output: rawResult,
+                        durationMs,
+                    });
+                }
+                catch {
+                    // Hook errors are non-fatal — the tool result is already recorded.
+                }
+            }
+        }
+        catch (err) {
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            // Fire PostToolUseFailure — in its own try/catch so a hook error does not
+            // drop the error result from toolResults or corrupt conversation history.
+            if (config.hooksEngine) {
+                try {
+                    await config.hooksEngine.fire("PostToolUseFailure", {
+                        sessionId,
+                        toolName: toolCall.name,
+                        input: toolCall.args,
+                        error: err instanceof Error ? err : errorMsg,
+                    });
+                }
+                catch {
+                    // Hook errors are non-fatal — the tool error result is still recorded.
+                }
+            }
+            toolResults.push({
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: hasMemoryLoader
+                    ? `Tool error: ${errorMsg}\n\nMemory query may help — call memory_query with a specific topic if this failure suggests a knowledge gap.`
+                    : `Tool error: ${errorMsg}`,
+                isError: true,
+            });
+        }
+    }
+    return { toolResults, events };
+}
+//# sourceMappingURL=tools.js.map

package/dist/harness/loop/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/harness/loop/tools.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,qCAAqC;AACrC,2DAA2D;AAC3D,+DAA+D;AAU/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,+EAA+E;AAE/E,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,KAAuB;IACnD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,UAAU,EAAE,CAAC,CAAC,MAAM;KACrB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,YAAY,CAAC,KAAuB;IAClD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAaD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAA6B,EAC7B,GAAyB;IAEzB,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,GAAG,CAAC;IAC5E,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,MAAM,MAAM,GAAkB,EAAE,CAAC;IAEjC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,uBAAuB;QACvB,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE;gBAC5D,SAAS;gBACT,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,KAAK,EAAE,QAAQ,CAAC,IAAI;aACrB,CAAC,CAAC;YAEH,IAAI,SAAS,EAAE,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACnC,WAAW,CAAC,IAAI,CAAC;oBACf,UAAU,EAAE,QAAQ,CAAC,EAAE;oBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;oBACvB,OAAO,EAAE,oBAAoB,SAAS,CAAC,MAAM,IAAI,iBAAiB,EAAE;oBACpE,OAAO,EAAE,IAAI;iBACd,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,2CAA2C;YAC3C,IAAI,SAAS,EAAE,aAAa,EAAE,CAAC;gBAC7B,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrG,IAAI,YAAY,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YACpD,WAAW,CAAC,IAAI,CAAC;gBACf,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE,gCAAgC,YAAY,CAAC,MAAM,IAAI,kBAAkB,EAAE;gBACpF,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,YAAY;QACZ,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,WAAW,CAAC,IAAI,CAAC;gBACf,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE,iBAAiB,QAAQ,CAAC,IAAI,EAAE;gBACzC,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,2CAA2C;QAC3C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,eAAe,GAAG,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YACvF,IAAI,eAAe,EAAE,CAAC;gBACpB,WAAW,CAAC,IAAI,CAAC;oBACf,UAAU,EAAE,QAAQ,CAAC,EAAE;oBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;oBACvB,OAAO,EAAE,GAAG,eAAe,wCAAwC;oBACnE,OAAO,EAAE,IAAI;iBACd,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;QACH,CAAC;QAED,8DAA8D;QAC9D,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE;YACrD,QAAQ,EAAE;gBACR,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,UAAU,EAAE,QAAQ,CAAC,EAAE;aACxB;SACF,CAAC,CAAC,CAAC;QAEJ,MAAM,eAAe,GAAkE,EAAE,CAAC;QAC1F,MAAM,OAAO,GAAuB;YAClC,MAAM,EAAE,EAAE;YACV,KAAK,EAAE,IAAI;YACX,KAAK,EAAE,EAAE;YACT,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;YACd,SAAS;YACT,QAAQ;YACR,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI;YACJ,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,CAAC,MAA8D,EAAE,EAAE;gBAC3E,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC/B,CAAC;SACF,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAChE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAC1C,MAAM,OAAO,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAEtF,iEAAiE;YACjE,4DAA4D;YAC5D,WAAW,CAAC,IAAI,CAAC;gBACf,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO;gBACP,UAAU;aACX,CAAC,CAAC;YAEH,6DAA6D;YAC7D,KAAK,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,SAAS,EAAE,IAAI,EAAE;oBACxD,QAAQ,EAAE;wBACR,UAAU,EAAE,QAAQ,CAAC,EAAE;wBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;wBACvB,KAAK,EAAE,EAAE,CAAC,KAAK;wBACf,IAAI,EAAE,EAAE,CAAC,QAAQ;qBAClB;iBACF,CAAC,CAAC,CAAC;YACN,CAAC;YAED,mEAAmE;YACnE,oEAAoE;YACpE,sCAAsC;YACtC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE;wBAC3C,SAAS;wBACT,QAAQ,EAAE,QAAQ,CAAC,IAAI;wBACvB,KAAK,EAAE,QAAQ,CAAC,IAAI;wBACpB,MAAM,EAAE,SAAS;wBACjB,UAAU;qBACX,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,mEAAmE;gBACrE,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAElE,0EAA0E;YAC1E,0EAA0E;YAC1E,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACvB,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,oBAAoB,EAAE;wBAClD,SAAS;wBACT,QAAQ,EAAE,QAAQ,CAAC,IAAI;wBACvB,KAAK,EAAE,QAAQ,CAAC,IAAI;wBACpB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ;qBAC7C,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,uEAAuE;gBACzE,CAAC;YACH,CAAC;YAED,WAAW,CAAC,IAAI,CAAC;gBACf,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE,eAAe;oBACtB,CAAC,CAAC,eAAe,QAAQ,+GAA+G;oBACxI,CAAC,CAAC,eAAe,QAAQ,EAAE;gBAC7B,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;AACjC,CAAC"}

package/dist/harness/loop/types.d.ts

@@ -0,0 +1,7 @@
+export type { AgentLoopConfig, LoopMessage, LoopMessageType, LoopToolResult, HarnessToolContext, SessionOutcome, } from "../types.js";
+export type { ONIModelMessage, ChatResponse, LLMToolDef, } from "../../models/types.js";
+export type { ToolDefinition } from "../../tools/types.js";
+export { generateId } from "../types.js";
+import type { LoopMessage, LoopMessageType } from "../types.js";
+export declare function makeMessage(type: LoopMessageType, sessionId: string, turn: number, overrides?: Partial<LoopMessage>): LoopMessage;
+//# sourceMappingURL=types.d.ts.map

package/dist/harness/loop/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/harness/loop/types.ts"],"names":[],"mappings":"AAOA,YAAY,EACV,eAAe,EACf,WAAW,EACX,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,eAAe,EACf,YAAY,EACZ,UAAU,GACX,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEhE,wBAAgB,WAAW,CACzB,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GACnC,WAAW,CAEb"}

package/dist/harness/loop/types.js

@@ -0,0 +1,9 @@
+// ============================================================
+// @oni.bot/core/harness/loop — Internal types
+// Shared types used across the loop sub-modules.
+// ============================================================
+export { generateId } from "../types.js";
+export function makeMessage(type, sessionId, turn, overrides = {}) {
+    return { type, sessionId, turn, timestamp: Date.now(), ...overrides };
+}
+//# sourceMappingURL=types.js.map

package/dist/harness/loop/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/harness/loop/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8CAA8C;AAC9C,iDAAiD;AACjD,+DAA+D;AAqB/D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzC,MAAM,UAAU,WAAW,CACzB,IAAqB,EACrB,SAAiB,EACjB,IAAY,EACZ,YAAkC,EAAE;IAEpC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,SAAS,EAAE,CAAC;AACxE,CAAC"}

package/dist/harness/memory/fs-compat.d.ts

@@ -0,0 +1,3 @@
+export declare function getFs(): typeof import("fs") | null;
+export declare function getPath(): typeof import("path") | null;
+//# sourceMappingURL=fs-compat.d.ts.map

package/dist/harness/memory/fs-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-compat.d.ts","sourceRoot":"","sources":["../../../src/harness/memory/fs-compat.ts"],"names":[],"mappings":"AAQA,wBAAgB,KAAK,IAAI,cAAc,IAAI,CAAC,GAAG,IAAI,CAOlD;AAED,wBAAgB,OAAO,IAAI,cAAc,MAAM,CAAC,GAAG,IAAI,CAOtD"}

package/dist/harness/memory/fs-compat.js

@@ -0,0 +1,26 @@
+// ============================================================
+// @oni.bot/core/harness/memory — fs-compat
+//
+// Lazy fs/path helpers for browser compatibility.
+// Single source of truth — all modules that need fs must import
+// from here, NOT use top-level import * as fs from 'node:fs'.
+// ============================================================
+export function getFs() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        return require("fs");
+    }
+    catch {
+        return null;
+    }
+}
+export function getPath() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        return require("path");
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=fs-compat.js.map

package/dist/harness/memory/fs-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-compat.js","sourceRoot":"","sources":["../../../src/harness/memory/fs-compat.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,2CAA2C;AAC3C,EAAE;AACF,kDAAkD;AAClD,gEAAgE;AAChE,8DAA8D;AAC9D,+DAA+D;AAE/D,MAAM,UAAU,KAAK;IACnB,IAAI,CAAC;QACH,iEAAiE;QACjE,OAAO,OAAO,CAAC,IAAI,CAAwB,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,IAAI,CAAC;QACH,iEAAiE;QACjE,OAAO,OAAO,CAAC,MAAM,CAA0B,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,105 @@
+import type { ToolDefinition } from "../../tools/types.js";
+export * from "./types.js";
+import type { MemoryTier, MemoryType, MemoryUnit, LoadResult, MemoryLoaderConfig } from "./types.js";
+export declare class MemoryLoader {
+    private readonly config;
+    private units;
+    private loaded;
+    private static readonly DEFAULT_BUDGETS;
+    constructor(config: MemoryLoaderConfig);
+    static fromRoot(root: string, opts?: Partial<MemoryLoaderConfig>): MemoryLoader;
+    private ensureDirectoryStructure;
+    scan(): void;
+    private registerFileSelf;
+    /**
+     * wake() — Load Tier 0 (identity). Always called first.
+     * Additive: already-loaded units are skipped.
+     */
+    wake(): LoadResult;
+    /**
+     * orient() — Load Tier 1 (working, user/PROFILE, INDEX files).
+     * Additive.
+     */
+    orient(): LoadResult;
+    /**
+     * match(task) — Load Tier 2 units relevant to the task string.
+     * Scored by tag-overlap × recency. Additive.
+     * Returns empty LoadResult if taskTokens is empty (no error).
+     */
+    match(task: string): LoadResult;
+    /**
+     * query(topic) — Load Tier 3 units. Called only via the memory_query tool.
+     * Additive.
+     */
+    query(topic: string): LoadResult;
+    /**
+     * load(key) — Directly load a specific memory unit by key. Additive.
+     */
+    load(key: string): MemoryUnit | null;
+    /**
+     * loadType(type) — Load all units of a given memory type.
+     * Budget: 16000t fixed (intentional escape hatch). Additive.
+     */
+    loadType(type: MemoryType): LoadResult;
+    /**
+     * buildSystemPrompt(tiers) — Assemble loaded units into a system prompt string.
+     * Default tiers: [0, 1, 2]
+     */
+    buildSystemPrompt(tiers?: MemoryTier[]): string;
+    /**
+     * getLoadedManifest() — Compact list of loaded keys + costs.
+     * Format: "- <key> (T<tier>, <cost>t)" per line.
+     */
+    getLoadedManifest(): string;
+    /** resetSession() — Clear loaded set and release hydrated content. Does not remove files. */
+    resetSession(): void;
+    /**
+     * persist() — Write a memory unit to disk.
+     * autoIndex: rebuildIndex() called synchronously before return when autoIndex === true.
+     * Returns MemoryUnit with content populated.
+     */
+    persist(type: MemoryType, filename: string, content: string, subfolder?: string): MemoryUnit;
+    private persistInternal;
+    /**
+     * persistEpisodic() — Write session log to episodic/recent/<date>_<sessionId>.md.
+     * Triggers compaction if recent/ has files older than episodicRecentDays.
+     */
+    persistEpisodic(sessionId: string, content: string): MemoryUnit;
+    /**
+     * persistSemantic() — Write knowledge unit to semantic/<domain>/<topic>.md.
+     * Rebuilds both domain INDEX.md and root semantic INDEX.md.
+     */
+    persistSemantic(domain: string, topic: string, content: string): MemoryUnit;
+    /**
+     * rebuildIndex() — Rewrite the INDEX.md for a given folder.
+     * INDEX.md files are write-only — never read back by the loader.
+     */
+    rebuildIndex(folder: string): void;
+    /** rebuildAllIndexes() — Rebuild every INDEX.md in the tree. */
+    rebuildAllIndexes(): void;
+    stats(): {
+        totalUnits: number;
+        currentlyLoaded: number;
+        totalTokensOnDisk: number;
+        byType: Record<string, number>;
+        byTier: Record<string, number>;
+        root: string;
+    };
+    /**
+     * getQueryTool() — Returns the memory_query ToolDefinition.
+     * The `reason` param is prompting-only — not used in execute logic.
+     * `_ctx` is typed as ToolContext (base); MemoryLoader needs no harness-specific context.
+     */
+    getQueryTool(): ToolDefinition<{
+        topic: string;
+        reason: string;
+    }, object>;
+    private loadByTier;
+    private getUnitsByTier;
+    private getBudget;
+    private hydrate;
+    private injectFrontmatter;
+    private compactEpisodicIfNeeded;
+    private log;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/harness/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/harness/memory/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,sBAAsB,CAAC;AAcxE,cAAc,YAAY,CAAC;AAE3B,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAIpB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,MAAM,CAA0B;IAExC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAKrC;gBAEU,MAAM,EAAE,kBAAkB;IAetC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,YAAY;IAM/E,OAAO,CAAC,wBAAwB;IAuBhC,IAAI,IAAI,IAAI;IAOZ,OAAO,CAAC,gBAAgB;IAOxB;;;OAGG;IACH,IAAI,IAAI,UAAU;IAIlB;;;OAGG;IACH,MAAM,IAAI,UAAU;IAIpB;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAW/B;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAWhC;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAQpC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU;IAUtC;;;OAGG;IACH,iBAAiB,CAAC,KAAK,GAAE,UAAU,EAAc,GAAG,MAAM;IAI1D;;;OAGG;IACH,iBAAiB,IAAI,MAAM;IAS3B,6FAA6F;IAC7F,YAAY,IAAI,IAAI;IAUpB;;;;OAIG;IACH,OAAO,CACL,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,UAAU;IAIb,OAAO,CAAC,eAAe;IAmFvB;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU;IAS/D;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU;IAc3E;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAoDlC,gEAAgE;IAChE,iBAAiB,IAAI,IAAI;IAczB,KAAK,IAAI;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,IAAI,EAAE,MAAM,CAAC;KACd;IAuBD;;;;OAIG;IACH,YAAY,IAAI,cAAc,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,CAAC;IA4CzE,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,uBAAuB;IAuD/B,OAAO,CAAC,GAAG;CAGZ"}