@oni.bot/core 1.0.2 → 1.1.0

package/dist/harness/loop/index.js

@@ -0,0 +1,257 @@
+// ============================================================
+// @oni.bot/core/harness/loop — Index
+// agentLoop() + wrapWithAgentLoop() assembling all sub-modules.
+// ============================================================
+import { generateId } from "../types.js";
+import { makeMessage } from "./types.js";
+// Sub-module imports
+import { runInference } from "./inference.js";
+import { buildLLMTools, buildToolMap, executeTools } from "./tools.js";
+import { initMemory, finalizeMemory } from "./memory.js";
+import { fireSessionStart, fireSessionEnd, fireStop, firePreCompact, firePostCompact, } from "./hooks.js";
+// ─── agentLoop ─────────────────────────────────────────────────────────────
+export async function* agentLoop(prompt, config) {
+    const sessionId = generateId("ses");
+    const threadId = config.threadId ?? generateId("thr");
+    const maxTurns = config.maxTurns ?? 10;
+    const messages = config.initialMessages ? [...config.initialMessages] : [];
+    let turn = 0;
+    // ── 0. Memory init ───────────────────────────────────────────────────────
+    const { memoryLoader, memoryContext } = initMemory(prompt, config);
+    const effectiveSystemPrompt = memoryContext
+        ? [memoryContext, config.systemPrompt].filter(Boolean).join("\n\n")
+        : config.systemPrompt;
+    let sessionOutcome = "completed";
+    // ── 1. Session Init ──────────────────────────────────────────────────
+    if (config.hooksEngine) {
+        const hookResult = await fireSessionStart(config.hooksEngine, sessionId, config.agentName, config.tools.map((t) => t.name));
+        if (hookResult?.additionalContext) {
+            messages.push({ role: "user", content: hookResult.additionalContext });
+            messages.push({ role: "assistant", content: "Context loaded." });
+        }
+    }
+    // ── 1b. Build allTools ───────────────────────────────────────────────
+    const allTools = memoryLoader
+        ? [...config.tools, memoryLoader.getQueryTool()]
+        : config.tools;
+    messages.push({ role: "user", content: prompt });
+    yield makeMessage("system", sessionId, turn, {
+        subtype: "init",
+        content: `Session ${sessionId} started for agent "${config.agentName}"`,
+    });
+    // ── 2. Build LLMToolDef[] ────────────────────────────────────────────
+    const llmTools = buildLLMTools(allTools);
+    const toolMap = buildToolMap(allTools);
+    // ── 3. Main Loop ─────────────────────────────────────────────────────
+    try {
+        while (turn < maxTurns) {
+            // ── 3a. Check AbortSignal ──────────────────────────────────────
+            if (config.signal?.aborted) {
+                sessionOutcome = "interrupted";
+                yield makeMessage("error", sessionId, turn, { content: "Agent loop aborted by signal" });
+                return;
+            }
+            // ── 3b. Context Compaction ─────────────────────────────────────
+            if (config.compactor) {
+                const compactionCheck = config.compactor.checkCompaction(messages);
+                if (compactionCheck.needed) {
+                    const beforeCount = messages.length;
+                    yield makeMessage("system", sessionId, turn, {
+                        subtype: "compact_start",
+                        content: "Context compaction starting",
+                        metadata: {
+                            beforeCount,
+                            estimatedTokens: compactionCheck.estimatedTokens,
+                            threshold: compactionCheck.threshold,
+                            maxTokens: compactionCheck.maxTokens,
+                            percentUsed: compactionCheck.percentUsed,
+                        },
+                    });
+                    try {
+                        if (config.hooksEngine) {
+                            await firePreCompact(config.hooksEngine, sessionId, beforeCount, compactionCheck.estimatedTokens);
+                        }
+                        const compacted = await config.compactor.compact(messages, { skipInitialCheck: true });
+                        const estimatedTokensAfter = config.compactor.estimateTokens(compacted);
+                        const percentUsedAfter = compactionCheck.maxTokens > 0
+                            ? estimatedTokensAfter / compactionCheck.maxTokens : 0;
+                        const afterCount = compacted.length;
+                        const summarized = afterCount <= 2 && beforeCount > 2;
+                        messages.length = 0;
+                        messages.push(...compacted);
+                        yield makeMessage("system", sessionId, turn, {
+                            subtype: "compact_boundary",
+                            content: "Context compacted",
+                            metadata: {
+                                beforeCount, afterCount, summarized,
+                                estimatedTokensBefore: compactionCheck.estimatedTokens, estimatedTokensAfter,
+                                threshold: compactionCheck.threshold, maxTokens: compactionCheck.maxTokens,
+                                percentUsedBefore: compactionCheck.percentUsed, percentUsedAfter,
+                            },
+                        });
+                        if (config.hooksEngine) {
+                            await firePostCompact(config.hooksEngine, sessionId, beforeCount, afterCount, estimatedTokensAfter, summarized);
+                        }
+                    }
+                    catch (err) {
+                        const errorMsg = err instanceof Error ? err.message : String(err);
+                        yield makeMessage("system", sessionId, turn, {
+                            subtype: "compact_error",
+                            content: `Context compaction failed: ${errorMsg}`,
+                            metadata: {
+                                beforeCount, afterCount: beforeCount,
+                                estimatedTokensBefore: compactionCheck.estimatedTokens,
+                                threshold: compactionCheck.threshold, maxTokens: compactionCheck.maxTokens,
+                                percentUsedBefore: compactionCheck.percentUsed, error: errorMsg,
+                            },
+                        });
+                    }
+                }
+            }
+            // ── 3c. Build system prompt ────────────────────────────────────
+            let systemPrompt = effectiveSystemPrompt;
+            const remaining = maxTurns - turn;
+            systemPrompt += `\n\nYou have ${remaining} turns remaining. Each turn lets you call multiple tools. Do NOT stop early — use your tools and complete the task autonomously.`;
+            if (config.env) {
+                const envLines = [];
+                if (config.env.cwd)
+                    envLines.push(`Working directory: ${config.env.cwd}`);
+                if (config.env.platform)
+                    envLines.push(`Platform: ${config.env.platform}`);
+                if (config.env.date)
+                    envLines.push(`Date: ${config.env.date}`);
+                if (config.env.gitBranch)
+                    envLines.push(`Git branch: ${config.env.gitBranch}`);
+                if (config.env.gitStatus)
+                    envLines.push(`Git status: ${config.env.gitStatus}`);
+                if (envLines.length > 0)
+                    systemPrompt += `\n\n<env>\n${envLines.join("\n")}\n</env>`;
+            }
+            // ── 3d. Skill injection ────────────────────────────────────────
+            if (config.skillLoader) {
+                const pending = config.skillLoader.getPendingInjection();
+                if (pending) {
+                    messages.push({ role: "user", content: pending });
+                    messages.push({ role: "assistant", content: "Skill instructions loaded." });
+                    config.skillLoader.clearPendingInjection();
+                }
+            }
+            // ── 3e. Yield step_start ───────────────────────────────────────
+            const stepStartTime = Date.now();
+            yield makeMessage("step_start", sessionId, turn, { metadata: { step: turn } });
+            // ── 3f. Inference ──────────────────────────────────────────────
+            const inferenceResult = await runInference(messages, llmTools, systemPrompt, config, sessionId, turn);
+            for (const evt of inferenceResult.events)
+                yield evt;
+            if (!inferenceResult.succeeded) {
+                sessionOutcome = "error";
+                yield makeMessage("error", sessionId, turn, {
+                    content: `Inference error: ${inferenceResult.lastError instanceof Error ? inferenceResult.lastError.message : String(inferenceResult.lastError)}`,
+                    metadata: { finalMessages: messages },
+                });
+                return;
+            }
+            const response = inferenceResult.response;
+            // ── 3g. Yield assistant message ────────────────────────────────
+            yield makeMessage("assistant", sessionId, turn, {
+                content: response.content,
+                toolCalls: response.toolCalls,
+                metadata: { usage: response.usage, stopReason: response.stopReason },
+            });
+            // ── 3g2. Yield step_finish ─────────────────────────────────────
+            yield makeMessage("step_finish", sessionId, turn, {
+                metadata: {
+                    stepDurationMs: Date.now() - stepStartTime,
+                    usage: response.usage,
+                    stopReason: response.stopReason,
+                    toolCount: response.toolCalls?.length ?? 0,
+                },
+            });
+            // ── 3h. Stop condition ─────────────────────────────────────────
+            if (!response.toolCalls || response.toolCalls.length === 0) {
+                if (config.hooksEngine) {
+                    const stopResult = await fireStop(config.hooksEngine, sessionId, response.content);
+                    if (stopResult?.decision === "block") {
+                        const feedback = stopResult.reason ?? "Please provide a more complete response.";
+                        messages.push({ role: "assistant", content: response.content });
+                        messages.push({ role: "user", content: feedback });
+                        turn++;
+                        continue;
+                    }
+                }
+                if (config.hooksEngine) {
+                    await fireSessionEnd(config.hooksEngine, sessionId, "completed", turn + 1);
+                }
+                messages.push({ role: "assistant", content: response.content });
+                yield makeMessage("result", sessionId, turn, {
+                    content: response.content,
+                    metadata: { totalTurns: turn + 1, finalMessages: messages },
+                });
+                return;
+            }
+            // ── 3i. Tool execution ─────────────────────────────────────────
+            const { toolResults, events: toolEvents } = await executeTools(response.toolCalls, {
+                sessionId,
+                threadId,
+                turn,
+                config,
+                toolMap,
+                hasMemoryLoader: memoryLoader !== null,
+            });
+            // Yield events emitted during tool execution (tool_start, tool_metadata)
+            for (const evt of toolEvents)
+                yield evt;
+            // ── 3j. Update messages ────────────────────────────────────────
+            messages.push({ role: "assistant", content: response.content, toolCalls: response.toolCalls });
+            for (const tr of toolResults) {
+                messages.push({ role: "tool", content: tr.content, toolCallId: tr.toolCallId, name: tr.toolName });
+            }
+            // ── 3j. TODO reminder ──────────────────────────────────────────
+            if (config.todoModule) {
+                const todoState = config.todoModule.getState();
+                if (todoState.todos.length > 0) {
+                    const reminder = config.todoModule.toContextString();
+                    messages.push({ role: "user", content: `<system-reminder>\n${reminder}\n</system-reminder>` });
+                    messages.push({ role: "assistant", content: "Noted." });
+                    yield makeMessage("system", sessionId, turn, { subtype: "todo_reminder", content: reminder });
+                }
+            }
+            // ── 3k. Yield tool_result, increment turn ──────────────────────
+            yield makeMessage("tool_result", sessionId, turn, { toolResults });
+            turn++;
+        }
+        // Post-loop: maxTurns exhausted
+        sessionOutcome = "budget-exceeded";
+        yield makeMessage("error", sessionId, turn, {
+            content: `Agent loop exceeded maxTurns (${maxTurns})`,
+            metadata: { finalMessages: messages },
+        });
+    }
+    catch (err) {
+        sessionOutcome = "error";
+        yield makeMessage("error", sessionId, turn, {
+            content: `Agent loop error: ${err instanceof Error ? err.message : String(err)}`,
+            metadata: { finalMessages: messages },
+        });
+    }
+    finally {
+        finalizeMemory(memoryLoader, sessionId, prompt, turn, sessionOutcome, config);
+    }
+}
+// ─── wrapWithAgentLoop ─────────────────────────────────────────────────────
+export function wrapWithAgentLoop(config) {
+    return async (state) => {
+        const prompt = state.task ??
+            state.context ??
+            "";
+        let finalResult = "";
+        for await (const msg of agentLoop(prompt, config)) {
+            if (msg.type === "result")
+                finalResult = msg.content ?? "";
+        }
+        return {
+            agentResults: { ...(state.agentResults ?? {}), [config.agentName]: finalResult },
+        };
+    };
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,19 @@
+import type { ChatResponse, LLMToolDef, ONIModelMessage } from "../../models/types.js";
+import type { AgentLoopConfig, LoopMessage } from "../types.js";
+/** Check if an error is retryable (rate limits, transient server errors). */
+export declare function isRetryableError(err: unknown): boolean;
+/** Get retry delay with exponential backoff. */
+export declare function getRetryDelay(err: unknown, attempt: number): number;
+export interface InferenceResult {
+    response: ChatResponse | null;
+    /** Yielded messages during retries */
+    events: LoopMessage[];
+    succeeded: boolean;
+    lastError: unknown;
+}
+/**
+ * Run LLM inference with retry/timeout/header-aware backoff.
+ * Returns the response and any yield-able events (retry messages).
+ */
+export declare function runInference(messages: ONIModelMessage[], llmTools: LLMToolDef[], systemPrompt: string, config: AgentLoopConfig, sessionId: string, turn: number): Promise<InferenceResult>;
+//# sourceMappingURL=inference.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inference.d.ts","sourceRoot":"","sources":["../../../src/harness/loop/inference.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAKhE,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAiBtD;AAID,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAkBnE;AAID,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,sCAAsC;IACtC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,eAAe,EAAE,EAC3B,QAAQ,EAAE,UAAU,EAAE,EACtB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,CAAC,CAsE1B"}

package/dist/harness/loop/inference.js

@@ -0,0 +1,121 @@
+// ============================================================
+// @oni.bot/core/harness/loop — Inference
+// LLM invocation with retry/timeout/header-aware backoff.
+// ============================================================
+import { makeMessage } from "./types.js";
+// ─── isRetryableError ───────────────────────────────────────────────────────
+/** Check if an error is retryable (rate limits, transient server errors). */
+export function isRetryableError(err) {
+    if (err && typeof err === "object" && "isRetryable" in err) {
+        return !!err.isRetryable;
+    }
+    if (err && typeof err === "object") {
+        const status = err.status;
+        if (status === 429 || status === 503 || status === 502 || status === 500) {
+            return true;
+        }
+    }
+    if (err instanceof Error) {
+        const msg = err.message.toLowerCase();
+        if (msg.includes("rate limit") || msg.includes("429") || msg.includes("503") || msg.includes("overloaded")) {
+            return true;
+        }
+    }
+    return false;
+}
+// ─── getRetryDelay ──────────────────────────────────────────────────────────
+/** Get retry delay with exponential backoff. */
+export function getRetryDelay(err, attempt) {
+    if (err && typeof err === "object") {
+        // Respect retryAfterMs if provided by the model adapter
+        if ("retryAfterMs" in err) {
+            const after = err.retryAfterMs;
+            if (typeof after === "number" && after > 0)
+                return after;
+        }
+        // Check headers for retry-after-ms (common in HTTP error responses)
+        const headers = err.headers;
+        if (headers) {
+            const headerMs = headers["retry-after-ms"];
+            if (headerMs) {
+                const parsed = parseInt(headerMs, 10);
+                if (!isNaN(parsed) && parsed > 0)
+                    return parsed;
+            }
+        }
+    }
+    return Math.min(1000 * Math.pow(2, attempt), 10_000);
+}
+/**
+ * Run LLM inference with retry/timeout/header-aware backoff.
+ * Returns the response and any yield-able events (retry messages).
+ */
+export async function runInference(messages, llmTools, systemPrompt, config, sessionId, turn) {
+    const maxRetries = 3;
+    const inferenceTimeoutMs = config.inferenceTimeoutMs ?? 120_000;
+    const events = [];
+    let response = null;
+    let lastInferenceError = null;
+    let succeeded = false;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error(`Inference timeout after ${inferenceTimeoutMs}ms`)), inferenceTimeoutMs));
+            response = await Promise.race([
+                config.model.chat({
+                    messages,
+                    tools: llmTools.length > 0 ? llmTools : undefined,
+                    systemPrompt,
+                    maxTokens: config.maxTokens ?? 8192,
+                }),
+                timeoutPromise,
+            ]);
+            succeeded = true;
+            break;
+        }
+        catch (err) {
+            lastInferenceError = err;
+            const isRetryable = isRetryableError(err);
+            if (!isRetryable || attempt >= maxRetries) {
+                break;
+            }
+            // Check abort signal before retrying
+            if (config.signal?.aborted) {
+                break;
+            }
+            // Yield inference_retry so the conductor can emit events and update the UI
+            const delayMs = getRetryDelay(err, attempt);
+            events.push(makeMessage("system", sessionId, turn, {
+                subtype: "inference_retry",
+                content: `Retrying inference (attempt ${attempt + 1}/${maxRetries}): ${err instanceof Error ? err.message : String(err)}`,
+                metadata: {
+                    attempt: attempt + 1,
+                    maxRetries,
+                    delayMs,
+                    error: err instanceof Error ? err.message : String(err),
+                },
+            }));
+            if (delayMs > 0) {
+                // Abort-aware delay: resolve early if signal fires
+                await new Promise((resolve) => {
+                    if (config.signal) {
+                        const onAbort = () => { clearTimeout(timer); resolve(); };
+                        if (config.signal.aborted) {
+                            resolve();
+                            return;
+                        }
+                        config.signal.addEventListener("abort", onAbort, { once: true });
+                        const timer = setTimeout(() => {
+                            config.signal.removeEventListener("abort", onAbort);
+                            resolve();
+                        }, delayMs);
+                    }
+                    else {
+                        setTimeout(resolve, delayMs);
+                    }
+                });
+            }
+        }
+    }
+    return { response, events, succeeded, lastError: lastInferenceError };
+}
+//# sourceMappingURL=inference.js.map

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

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

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

@@ -0,0 +1,22 @@
+import { MemoryLoader } from "../memory-loader.js";
+import type { AgentLoopConfig } from "../types.js";
+import type { SessionOutcome } from "../types.js";
+export interface MemoryInitResult {
+    memoryLoader: MemoryLoader | null;
+    memoryContext: string;
+}
+/**
+ * Initialize MemoryLoader and run wake/orient/match if configured.
+ * Returns the loader instance and the built system prompt prefix.
+ */
+export declare function initMemory(prompt: string, config: AgentLoopConfig): MemoryInitResult;
+/**
+ * buildEpisodicLog — Assemble session log for persistEpisodic().
+ *
+ * When compactor.getLastSummary() is unavailable (not yet implemented),
+ * ## What Happened falls back to the raw task description.
+ */
+export declare function buildEpisodicLog(sessionId: string, taskDescription: string, turnCount: number, outcome: SessionOutcome, compactor?: import("../context-compactor.js").ContextCompactor): string;
+/** Persist episodic memory and reset session state. */
+export declare function finalizeMemory(memoryLoader: MemoryLoader | null, sessionId: string, prompt: string, turn: number, sessionOutcome: SessionOutcome, config: AgentLoopConfig): void;
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/harness/loop/memory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAoBpF;AAUD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,SAAS,CAAC,EAAE,OAAO,yBAAyB,EAAE,gBAAgB,GAC7D,MAAM,CAgCR;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAC5B,YAAY,EAAE,YAAY,GAAG,IAAI,EACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,cAAc,EAC9B,MAAM,EAAE,eAAe,GACtB,IAAI,CAMN"}

package/dist/harness/loop/memory.js

@@ -0,0 +1,73 @@
+// ============================================================
+// @oni.bot/core/harness/loop — Memory
+// MemoryLoader wake/orient/match integration.
+// ============================================================
+import { MemoryLoader } from "../memory-loader.js";
+/**
+ * Initialize MemoryLoader and run wake/orient/match if configured.
+ * Returns the loader instance and the built system prompt prefix.
+ */
+export function initMemory(prompt, config) {
+    const memoryLoader = config.memoryRoot
+        ? MemoryLoader.fromRoot(config.memoryRoot, {
+            budgets: config.memoryBudgets,
+            debug: config.memoryDebug,
+        })
+        : null;
+    let memoryContext = "";
+    if (memoryLoader && !config.signal?.aborted) {
+        memoryLoader.wake();
+        memoryLoader.orient();
+        const t2 = memoryLoader.match(prompt);
+        if (config.memoryDebug && t2.dropped.length > 0) {
+            console.log(`[MemoryLoader] match() dropped ${t2.dropped.length} units over T2 budget`);
+        }
+        memoryContext = memoryLoader.buildSystemPrompt([0, 1, 2]);
+    }
+    return { memoryLoader, memoryContext };
+}
+/**
+ * buildEpisodicLog — Assemble session log for persistEpisodic().
+ *
+ * When compactor.getLastSummary() is unavailable (not yet implemented),
+ * ## What Happened falls back to the raw task description.
+ */
+export function buildEpisodicLog(sessionId, taskDescription, turnCount, outcome, compactor) {
+    const c = compactor;
+    const summary = c?.getLastSummary?.() ?? null;
+    const openThreads = c?.getOpenThreads?.() ?? "none";
+    const outcomeNote = outcome === "budget-exceeded"
+        ? "Session ended at turn limit. Task may be incomplete — check Open Threads before assuming prior work is done."
+        : "";
+    return [
+        `---`,
+        `type: episodic`,
+        `session: ${sessionId}`,
+        `outcome: ${outcome}`,
+        `turns: ${turnCount}`,
+        `created: ${new Date().toISOString()}`,
+        `---`,
+        ``,
+        `## What Happened`,
+        summary ?? taskDescription,
+        ``,
+        `## Turns`,
+        String(turnCount),
+        ``,
+        `## Outcome`,
+        outcome,
+        ...(outcomeNote ? [``, outcomeNote] : []),
+        ``,
+        `## Open Threads`,
+        openThreads,
+    ].join("\n");
+}
+/** Persist episodic memory and reset session state. */
+export function finalizeMemory(memoryLoader, sessionId, prompt, turn, sessionOutcome, config) {
+    if (memoryLoader) {
+        const log = buildEpisodicLog(sessionId, prompt, turn, sessionOutcome, config.compactor);
+        memoryLoader.persistEpisodic(sessionId, log);
+        memoryLoader.resetSession();
+    }
+}
+//# sourceMappingURL=memory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../src/harness/loop/memory.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,sCAAsC;AACtC,8CAA8C;AAC9C,+DAA+D;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAWnD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,MAAuB;IAChE,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU;QACpC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE;YACvC,OAAO,EAAE,MAAM,CAAC,aAAa;YAC7B,KAAK,EAAE,MAAM,CAAC,WAAW;SAC1B,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC;IAET,IAAI,aAAa,GAAG,EAAE,CAAC;IACvB,IAAI,YAAY,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAC5C,YAAY,CAAC,IAAI,EAAE,CAAC;QACpB,YAAY,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,CAAC,OAAO,CAAC,MAAM,uBAAuB,CAAC,CAAC;QAC1F,CAAC;QACD,aAAa,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC;AACzC,CAAC;AAUD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAiB,EACjB,eAAuB,EACvB,SAAiB,EACjB,OAAuB,EACvB,SAA8D;IAE9D,MAAM,CAAC,GAAG,SAAwD,CAAC;IACnE,MAAM,OAAO,GAAG,CAAC,EAAE,cAAc,EAAE,EAAE,IAAI,IAAI,CAAC;IAC9C,MAAM,WAAW,GAAG,CAAC,EAAE,cAAc,EAAE,EAAE,IAAI,MAAM,CAAC;IAEpD,MAAM,WAAW,GACf,OAAO,KAAK,iBAAiB;QAC3B,CAAC,CAAC,8GAA8G;QAChH,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;QACL,KAAK;QACL,gBAAgB;QAChB,YAAY,SAAS,EAAE;QACvB,YAAY,OAAO,EAAE;QACrB,UAAU,SAAS,EAAE;QACrB,YAAY,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;QACtC,KAAK;QACL,EAAE;QACF,kBAAkB;QAClB,OAAO,IAAI,eAAe;QAC1B,EAAE;QACF,UAAU;QACV,MAAM,CAAC,SAAS,CAAC;QACjB,EAAE;QACF,YAAY;QACZ,OAAO;QACP,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,EAAE;QACF,iBAAiB;QACjB,WAAW;KACZ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,cAAc,CAC5B,YAAiC,EACjC,SAAiB,EACjB,MAAc,EACd,IAAY,EACZ,cAA8B,EAC9B,MAAuB;IAEvB,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACxF,YAAY,CAAC,eAAe,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAC7C,YAAY,CAAC,YAAY,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { SafetyGate, SafetyCheckResult } from "../safety-gate.js";
+/**
+ * Run a safety gate check for a tool call.
+ * Returns the check result, or null if no gate is configured or the tool
+ * does not require a check.
+ */
+export declare function checkSafety(safetyGate: SafetyGate | undefined, toolCallId: string, toolName: string, toolArgs: Record<string, unknown>): Promise<SafetyCheckResult | null>;
+//# sourceMappingURL=safety.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safety.d.ts","sourceRoot":"","sources":["../../../src/harness/loop/safety.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAIvE;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAUnC"}

package/dist/harness/loop/safety.js

@@ -0,0 +1,21 @@
+// ============================================================
+// @oni.bot/core/harness/loop — Safety
+// SafetyGate check integration.
+// ============================================================
+// ─── checkSafety ────────────────────────────────────────────────────────────
+/**
+ * Run a safety gate check for a tool call.
+ * Returns the check result, or null if no gate is configured or the tool
+ * does not require a check.
+ */
+export async function checkSafety(safetyGate, toolCallId, toolName, toolArgs) {
+    if (!safetyGate || !safetyGate.requiresCheck(toolName)) {
+        return null;
+    }
+    return safetyGate.check({
+        id: toolCallId,
+        name: toolName,
+        args: toolArgs,
+    });
+}
+//# sourceMappingURL=safety.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safety.js","sourceRoot":"","sources":["../../../src/harness/loop/safety.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,sCAAsC;AACtC,gCAAgC;AAChC,+DAA+D;AAI/D,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAAkC,EAClC,UAAkB,EAClB,QAAgB,EAChB,QAAiC;IAEjC,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC;QACtB,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;KACf,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { LLMToolDef, ONIModelToolCall } from "../../models/types.js";
+import type { ToolDefinition } from "../../tools/types.js";
+import type { LoopToolResult, LoopMessage, AgentLoopConfig } from "../types.js";
+/** Convert ToolDefinition[] to LLMToolDef[] for the model adapter. */
+export declare function buildLLMTools(tools: ToolDefinition[]): LLMToolDef[];
+/** Build a name → ToolDefinition lookup map. */
+export declare function buildToolMap(tools: ToolDefinition[]): Map<string, ToolDefinition>;
+export interface ToolExecutionContext {
+    sessionId: string;
+    threadId: string;
+    turn: number;
+    config: AgentLoopConfig;
+    toolMap: Map<string, ToolDefinition>;
+    hasMemoryLoader: boolean;
+}
+/**
+ * Execute all tool calls for a turn.
+ * Returns tool results and any yield-able events (tool_start, tool_metadata).
+ */
+export declare function executeTools(toolCalls: ONIModelToolCall[], ctx: ToolExecutionContext): Promise<{
+    toolResults: LoopToolResult[];
+    events: LoopMessage[];
+}>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/harness/loop/tools.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EACV,cAAc,EAEd,WAAW,EACX,eAAe,EAChB,MAAM,aAAa,CAAC;AAOrB,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,UAAU,EAAE,CAMnE;AAED,gDAAgD;AAChD,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAMjF;AAID,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,gBAAgB,EAAE,EAC7B,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC;IAAE,WAAW,EAAE,cAAc,EAAE,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC,CAsKnE"}