@oni.bot/core 0.6.3 → 1.0.0

package/dist/harness/context-compactor.js

@@ -0,0 +1,201 @@
+// ============================================================
+// @oni.bot/core/harness — ContextCompactor
+// Monitors token usage and compacts conversation history
+// before context quality degrades (triggers at 68% by default).
+// ============================================================
+// ─── ContextCompactor ────────────────────────────────────────────────────────
+export class ContextCompactor {
+    summaryModel;
+    threshold;
+    maxTokens;
+    charsPerToken;
+    compactInstructions;
+    constructor(config) {
+        this.summaryModel = config.summaryModel;
+        this.threshold = config.threshold ?? 0.68;
+        this.maxTokens = config.maxTokens ?? 200_000;
+        this.charsPerToken = config.charsPerToken ?? 4;
+        this.compactInstructions = config.compactInstructions;
+    }
+    // ── Public API ──────────────────────────────────────────────────────────
+    /**
+     * Estimate token count from total character length of all messages.
+     * Uses ceiling to avoid underestimation.
+     */
+    estimateTokens(messages) {
+        let totalChars = 0;
+        for (const msg of messages) {
+            totalChars += this.contentLength(msg);
+        }
+        return Math.ceil(totalChars / this.charsPerToken);
+    }
+    /**
+     * Returns true when estimated usage exceeds the compaction threshold.
+     */
+    shouldCompact(messages) {
+        return this.usageFraction(messages) >= this.threshold;
+    }
+    /**
+     * Check if compaction is needed and return details.
+     */
+    checkCompaction(messages) {
+        const budget = this.getBudgetSnapshot(messages);
+        return {
+            ...budget,
+            needed: budget.percentUsed >= budget.threshold,
+        };
+    }
+    /**
+     * Current usage as a fraction of maxTokens (0–1+).
+     */
+    usageFraction(messages) {
+        if (messages.length === 0)
+            return 0;
+        return this.estimateTokens(messages) / this.maxTokens;
+    }
+    getThreshold() {
+        return this.threshold;
+    }
+    getMaxTokens() {
+        return this.maxTokens;
+    }
+    getBudgetSnapshot(messages) {
+        const estimatedTokens = this.estimateTokens(messages);
+        return {
+            estimatedTokens,
+            percentUsed: this.maxTokens > 0 ? estimatedTokens / this.maxTokens : 0,
+            threshold: this.threshold,
+            maxTokens: this.maxTokens,
+        };
+    }
+    /**
+     * Two-stage compaction:
+     * 1. Clear old tool results (less lossy)
+     * 2. Full summarization if still over threshold
+     *
+     * Returns the compacted message array.
+     */
+    async compact(messages, opts) {
+        if (!opts?.skipInitialCheck && !this.shouldCompact(messages)) {
+            return messages;
+        }
+        // Stage 1: clear old tool results
+        const cleaned = this.clearOldToolResults(messages);
+        if (!this.shouldCompact(cleaned)) {
+            return cleaned;
+        }
+        // Stage 2: full summarization
+        try {
+            return await this.summarize(cleaned);
+        }
+        catch {
+            // Fallback: keep recent messages to preserve context
+            return this.fallbackTruncation(cleaned);
+        }
+    }
+    // ── Private ─────────────────────────────────────────────────────────────
+    /**
+     * Remove tool-role messages from the older portion of the conversation,
+     * keeping the most recent `keepRecent` messages intact.
+     */
+    clearOldToolResults(messages, keepRecent = 10) {
+        if (messages.length <= keepRecent) {
+            return messages;
+        }
+        const cutoff = messages.length - keepRecent;
+        const olderPortion = messages.slice(0, cutoff);
+        const recentPortion = messages.slice(cutoff);
+        const filteredOlder = olderPortion.filter((m) => m.role !== "tool");
+        return [...filteredOlder, ...recentPortion];
+    }
+    /**
+     * Build a history text from all messages and ask the summary model
+     * to produce a compact summary wrapped in <summary> tags.
+     */
+    async summarize(messages) {
+        const historyText = messages
+            .map((m) => {
+            const text = typeof m.content === "string"
+                ? m.content
+                : m.content
+                    .map((p) => p.text ?? "[image]")
+                    .join(" ");
+            return `[${m.role}]: ${text}`;
+        })
+            .join("\n");
+        const instructions = this.compactInstructions
+            ? `\n\nAdditional instructions: ${this.compactInstructions}`
+            : "";
+        const systemMessage = {
+            role: "user",
+            content: `Summarize the following conversation history into a concise summary. ` +
+                `Preserve key decisions, code context, file paths, and task progress. ` +
+                `Current state and Files modified should be preserved verbatim when possible. ` +
+                `Wrap your summary in <summary></summary> tags.${instructions}\n\n` +
+                `--- CONVERSATION HISTORY ---\n${historyText}`,
+        };
+        const response = await this.summaryModel.chat({
+            messages: [systemMessage],
+            maxTokens: 2048,
+        });
+        const summaryMatch = /<summary>([\s\S]*?)<\/summary>/.exec(response.content);
+        const summaryText = summaryMatch
+            ? summaryMatch[1].trim()
+            : response.content.trim();
+        return [
+            {
+                role: "user",
+                content: `[Previous conversation was compacted. Summary of prior context]\n\n${summaryText}`,
+            },
+            {
+                role: "assistant",
+                content: "Context loaded.",
+            },
+        ];
+    }
+    /**
+     * Fallback when the summary model fails — keep the most recent messages
+     * that fit within the token budget and prepend a truncation notice.
+     */
+    fallbackTruncation(messages) {
+        const budget = Math.floor(this.maxTokens * this.threshold * this.charsPerToken);
+        const kept = [];
+        let totalChars = 0;
+        // Walk backwards to keep the most recent messages that fit in the budget
+        for (let i = messages.length - 1; i >= 0; i--) {
+            const len = this.contentLength(messages[i]);
+            if (totalChars + len > budget)
+                break;
+            totalChars += len;
+            kept.unshift(messages[i]);
+        }
+        return [
+            {
+                role: "user",
+                content: "[The previous conversation was truncated due to context limits. " +
+                    "Please continue from where we left off.]",
+            },
+            {
+                role: "assistant",
+                content: "Context loaded.",
+            },
+            ...kept,
+        ];
+    }
+    /**
+     * Get the character length of a message's content.
+     */
+    contentLength(msg) {
+        if (typeof msg.content === "string") {
+            return msg.content.length;
+        }
+        let len = 0;
+        for (const part of msg.content) {
+            if (part.text) {
+                len += part.text.length;
+            }
+        }
+        return len;
+    }
+}
+//# sourceMappingURL=context-compactor.js.map

package/dist/harness/context-compactor.js.map

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

package/dist/harness/harness.d.ts

@@ -0,0 +1,41 @@
+import { TodoModule } from "./todo-module.js";
+import { HooksEngine } from "./hooks-engine.js";
+import type { HooksConfig } from "./hooks-engine.js";
+import { SkillLoader } from "./skill-loader.js";
+import type { SkillDefinition } from "./skill-loader.js";
+import type { HarnessConfig, AgentNodeConfig, LoopMessage } from "./types.js";
+import type { ToolDefinition } from "../tools/types.js";
+export interface SwarmAgentCompat {
+    name: string;
+    description: string;
+    capabilities: string[];
+    handler: (state: Record<string, unknown>) => Promise<Record<string, unknown>>;
+}
+export declare class ONIHarness {
+    private readonly config;
+    private readonly todoModule;
+    private readonly hooksEngine;
+    private readonly compactor;
+    private readonly safetyGate;
+    private readonly skillLoader;
+    private constructor();
+    static create(config: HarnessConfig): ONIHarness;
+    private buildLoopConfig;
+    run(prompt: string, agentConfig: AgentNodeConfig | string): AsyncGenerator<LoopMessage>;
+    runToResult(prompt: string, agentConfig: AgentNodeConfig | string): Promise<string>;
+    asNode<S extends Record<string, unknown> & {
+        task?: string;
+        context?: string;
+        agentResults?: Record<string, string>;
+    }>(agentConfig: AgentNodeConfig): (state: S) => Promise<Partial<S>>;
+    asSwarmAgent(name: string, soul: string, tools?: ToolDefinition[], opts?: {
+        description?: string;
+        capabilities?: string[];
+    }): SwarmAgentCompat;
+    getTodoModule(): TodoModule;
+    getHooksEngine(): HooksEngine;
+    getSkillLoader(): SkillLoader;
+    registerSkill(skill: SkillDefinition): void;
+    addHooks(config: HooksConfig): void;
+}
+//# sourceMappingURL=harness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness.d.ts","sourceRoot":"","sources":["../../src/harness/harness.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EAEf,WAAW,EACZ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC/E;AAID,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C,OAAO;IA6CP,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU;IAMhD,OAAO,CAAC,eAAe;IAkChB,GAAG,CACR,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,eAAe,GAAG,MAAM,GACpC,cAAc,CAAC,WAAW,CAAC;IAYxB,WAAW,CACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,eAAe,GAAG,MAAM,GACpC,OAAO,CAAC,MAAM,CAAC;IAclB,MAAM,CACJ,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACvC,EACD,WAAW,EAAE,eAAe,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAOlE,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,cAAc,EAAE,EACxB,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GACvD,gBAAgB;IAcnB,aAAa,IAAI,UAAU;IAI3B,cAAc,IAAI,WAAW;IAI7B,cAAc,IAAI,WAAW;IAM7B,aAAa,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI3C,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;CAGpC"}

package/dist/harness/harness.js

@@ -0,0 +1,140 @@
+// ============================================================
+// @oni.bot/core/harness — ONIHarness Integration Class
+// Wires all harness modules together and bridges to ONI-Core
+// ============================================================
+import { agentLoop, wrapWithAgentLoop } from "./agent-loop.js";
+import { TodoModule } from "./todo-module.js";
+import { HooksEngine } from "./hooks-engine.js";
+import { ContextCompactor } from "./context-compactor.js";
+import { SafetyGate } from "./safety-gate.js";
+import { SkillLoader } from "./skill-loader.js";
+// ─── ONIHarness ───────────────────────────────────────────────────────────
+export class ONIHarness {
+    config;
+    todoModule;
+    hooksEngine;
+    compactor;
+    safetyGate;
+    skillLoader;
+    constructor(config) {
+        this.config = config;
+        // Create TodoModule
+        this.todoModule = new TodoModule();
+        // Create HooksEngine — compose user hooks with security guardrails
+        const userEngine = new HooksEngine();
+        if (config.hooks) {
+            userEngine.configure(config.hooks);
+        }
+        this.hooksEngine = HooksEngine.compose(HooksEngine.withSecurityGuardrails(), userEngine);
+        // Create ContextCompactor with fastModel (or model if no fastModel)
+        const summaryModel = config.fastModel ?? config.model;
+        this.compactor = new ContextCompactor({
+            summaryModel,
+            threshold: config.compaction?.threshold,
+            maxTokens: config.compaction?.maxTokens,
+            charsPerToken: config.compaction?.charsPerToken,
+            compactInstructions: config.compaction?.compactInstructions,
+        });
+        // Create SafetyGate with fastModel (or model)
+        const safetyModel = config.fastModel ?? config.model;
+        this.safetyGate = new SafetyGate({
+            safetyModel,
+            protectedTools: config.safety?.protectedTools,
+            safetySystemPrompt: config.safety?.safetySystemPrompt,
+            timeout: config.safety?.timeout,
+        });
+        // Create SkillLoader — from directories or empty
+        if (config.skillPaths && config.skillPaths.length > 0) {
+            this.skillLoader = SkillLoader.fromDirectories(config.skillPaths);
+        }
+        else {
+            this.skillLoader = new SkillLoader();
+        }
+    }
+    // ── Static Factory ──────────────────────────────────────────────────
+    static create(config) {
+        return new ONIHarness(config);
+    }
+    // ── Private: Build Loop Config ──────────────────────────────────────
+    buildLoopConfig(agentConfig) {
+        // Build systemPrompt from soul fragments + skill descriptions
+        const systemPrompt = [
+            this.config.soul,
+            agentConfig.soul,
+            this.skillLoader.getDescriptionsForContext(),
+        ]
+            .filter(Boolean)
+            .join("\n\n");
+        // Build tools array
+        const tools = [
+            ...this.todoModule.getTools(),
+            this.skillLoader.getSkillTool(),
+            ...(this.config.sharedTools ?? []),
+            ...(agentConfig.tools ?? []),
+        ];
+        return {
+            model: this.config.model,
+            tools,
+            agentName: agentConfig.name,
+            systemPrompt,
+            maxTurns: agentConfig.maxTurns ?? this.config.maxTurns,
+            todoModule: this.todoModule,
+            hooksEngine: this.hooksEngine,
+            compactor: this.compactor,
+            safetyGate: this.safetyGate,
+            skillLoader: this.skillLoader,
+        };
+    }
+    // ── Public: run ─────────────────────────────────────────────────────
+    async *run(prompt, agentConfig) {
+        const config = typeof agentConfig === "string"
+            ? { name: agentConfig }
+            : agentConfig;
+        const loopConfig = this.buildLoopConfig(config);
+        yield* agentLoop(prompt, loopConfig);
+    }
+    // ── Public: runToResult ─────────────────────────────────────────────
+    async runToResult(prompt, agentConfig) {
+        let finalResult = "";
+        for await (const msg of this.run(prompt, agentConfig)) {
+            if (msg.type === "result") {
+                finalResult = msg.content ?? "";
+            }
+        }
+        return finalResult;
+    }
+    // ── Public: asNode ──────────────────────────────────────────────────
+    asNode(agentConfig) {
+        const loopConfig = this.buildLoopConfig(agentConfig);
+        return wrapWithAgentLoop(loopConfig);
+    }
+    // ── Public: asSwarmAgent ────────────────────────────────────────────
+    asSwarmAgent(name, soul, tools, opts) {
+        const agentConfig = { name, soul, tools };
+        const loopConfig = this.buildLoopConfig(agentConfig);
+        return {
+            name,
+            description: opts?.description ?? soul,
+            capabilities: opts?.capabilities ?? [],
+            handler: wrapWithAgentLoop(loopConfig),
+        };
+    }
+    // ── Public: Module Access ───────────────────────────────────────────
+    getTodoModule() {
+        return this.todoModule;
+    }
+    getHooksEngine() {
+        return this.hooksEngine;
+    }
+    getSkillLoader() {
+        return this.skillLoader;
+    }
+    // ── Public: Runtime Registration ────────────────────────────────────
+    registerSkill(skill) {
+        this.skillLoader.register(skill);
+    }
+    addHooks(config) {
+        this.hooksEngine.configure(config);
+    }
+}
+//# sourceMappingURL=harness.js.map

package/dist/harness/harness.js.map

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

package/dist/harness/hooks-engine.d.ts

@@ -0,0 +1,77 @@
+export type HookEvent = "SessionStart" | "SessionEnd" | "UserPromptSubmit" | "PreToolUse" | "PermissionRequest" | "PostToolUse" | "PostToolUseFailure" | "SubagentStart" | "SubagentStop" | "Stop" | "Notification" | "PreCompact" | "PostCompact";
+export interface BasePayload {
+    sessionId: string;
+    [key: string]: unknown;
+}
+export interface SessionStartPayload extends BasePayload {
+    agentName: string;
+    tools: string[];
+}
+export interface SessionEndPayload extends BasePayload {
+    reason: string;
+    turns: number;
+}
+export interface UserPromptPayload extends BasePayload {
+    prompt: string;
+}
+export interface PreToolUsePayload extends BasePayload {
+    toolName: string;
+    input: Record<string, unknown>;
+}
+export interface PostToolUsePayload extends BasePayload {
+    toolName: string;
+    input: Record<string, unknown>;
+    output: unknown;
+    durationMs?: number;
+}
+export interface PostToolUseFailurePayload extends BasePayload {
+    toolName: string;
+    input: Record<string, unknown>;
+    error: Error | string;
+}
+export interface StopPayload extends BasePayload {
+    response: string;
+}
+export interface PreCompactPayload extends BasePayload {
+    messageCount: number;
+    estimatedTokens: number;
+}
+export interface PostCompactPayload extends BasePayload {
+    beforeCount: number;
+    afterCount: number;
+    estimatedTokensAfter?: number;
+    summarized?: boolean;
+}
+export interface SubagentPayload extends BasePayload {
+    agentName: string;
+    parentSessionId?: string;
+}
+export interface HookResult {
+    decision: "allow" | "deny" | "block" | "escalate";
+    reason?: string;
+    additionalContext?: string;
+    modifiedInput?: Record<string, unknown>;
+}
+export interface HookDefinition {
+    /** Regex/pattern for tool name filtering. Supports pipe OR, wildcard, arg patterns. */
+    matcher?: string;
+    handler: (payload: BasePayload) => Promise<HookResult> | HookResult;
+    timeout?: number;
+    description?: string;
+}
+export type HooksConfig = Partial<Record<HookEvent, HookDefinition[]>>;
+export declare class HooksEngine {
+    private hooks;
+    private anyListeners;
+    on(event: HookEvent, definition: HookDefinition): void;
+    configure(config: HooksConfig): void;
+    off(event: HookEvent): void;
+    clear(): void;
+    onAny(listener: (event: HookEvent, payload: BasePayload) => void): void;
+    fire(event: HookEvent, payload: BasePayload): Promise<HookResult | null>;
+    private matches;
+    static withSecurityGuardrails(): HooksEngine;
+    static withQualityGate(validate: (response: string) => string | null): HooksEngine;
+    static compose(...engines: HooksEngine[]): HooksEngine;
+}
+//# sourceMappingURL=hooks-engine.d.ts.map

package/dist/harness/hooks-engine.d.ts.map

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