@oni.bot/core 0.6.3 → 1.0.0

package/dist/harness/skill-loader.js

@@ -0,0 +1,244 @@
+// ============================================================
+// @oni.bot/core/harness — SkillLoader
+// SKILL.md discovery and on-demand injection into agent loop
+// ============================================================
+// ─── Frontmatter Parser ──────────────────────────────────────────────────────
+function parseFrontmatter(raw) {
+    const trimmed = raw.trimStart();
+    if (!trimmed.startsWith("---")) {
+        return { meta: {}, body: raw };
+    }
+    const end = trimmed.indexOf("---", 3);
+    if (end === -1) {
+        return { meta: {}, body: raw };
+    }
+    const frontBlock = trimmed.slice(3, end).trim();
+    const body = trimmed.slice(end + 3).trim();
+    const meta = {};
+    for (const line of frontBlock.split("\n")) {
+        const colonIdx = line.indexOf(":");
+        if (colonIdx === -1)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        const value = line.slice(colonIdx + 1).trim();
+        if (!key)
+            continue;
+        // Handle comma-separated values for array fields
+        if (key === "tools" || key === "allowed-tools") {
+            meta[key] = value.split(",").map((s) => s.trim()).filter(Boolean);
+        }
+        else {
+            meta[key] = value;
+        }
+    }
+    return { meta, body };
+}
+// ─── SkillLoader ─────────────────────────────────────────────────────────────
+export class SkillLoader {
+    skills = new Map();
+    pendingInjection = null;
+    /** Monotonically increasing version — bumps on any skill registration or load. */
+    version = 0;
+    // ── Static Constructors (Node.js only) ───────────────────────────────
+    /**
+     * Scan a single directory (recursively) for SKILL.md files.
+     * Uses dynamic require("fs") — safe to call in non-Node envs (returns empty loader).
+     */
+    static fromDirectory(dir) {
+        const loader = new SkillLoader();
+        loader.loadDirectory(dir);
+        return loader;
+    }
+    /**
+     * Scan multiple directories for SKILL.md files.
+     */
+    static fromDirectories(dirs) {
+        const loader = new SkillLoader();
+        for (const dir of dirs) {
+            loader.loadDirectory(dir);
+        }
+        return loader;
+    }
+    // ── Private: Filesystem Loading ──────────────────────────────────────
+    loadDirectory(dir) {
+        try {
+            // Dynamic require to avoid bundler issues in non-Node envs
+            const fs = require("fs");
+            const path = require("path");
+            this.scanDirectory(dir, fs, path);
+        }
+        catch {
+            // Not in Node.js or fs unavailable — silently skip
+        }
+    }
+    scanDirectory(dir, fs, path) {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = path.join(dir, entry);
+            try {
+                const stat = fs.statSync(full);
+                if (stat.isDirectory()) {
+                    this.scanDirectory(full, fs, path);
+                }
+                else if (entry === "SKILL.md") {
+                    this.loadSkillFile(full, fs);
+                }
+            }
+            catch {
+                // Skip inaccessible entries
+            }
+        }
+    }
+    loadSkillFile(filePath, fs) {
+        try {
+            const raw = fs.readFileSync(filePath, "utf-8");
+            const { meta, body } = parseFrontmatter(raw);
+            const name = meta.name || "";
+            if (!name)
+                return;
+            const skill = {
+                name,
+                description: meta.description || "",
+                content: body,
+                sourcePath: filePath,
+            };
+            if (meta.tools) {
+                skill.tools = Array.isArray(meta.tools) ? meta.tools : [meta.tools];
+            }
+            if (meta.model) {
+                skill.model = meta.model;
+            }
+            if (meta["allowed-tools"]) {
+                const val = meta["allowed-tools"];
+                skill.allowedTools = Array.isArray(val) ? val : [val];
+            }
+            if (meta["argument-hint"]) {
+                skill.argumentHint = meta["argument-hint"];
+            }
+            if (meta["disable-model-invocation"] === "true") {
+                skill.disableModelInvocation = true;
+            }
+            this.skills.set(name, skill);
+            this.version++;
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    // ── Programmatic Registration ────────────────────────────────────────
+    /**
+     * Register a skill definition programmatically (works in all runtimes).
+     */
+    register(skill) {
+        this.skills.set(skill.name, skill);
+        this.version++;
+    }
+    /**
+     * Load a single skill from a file path.
+     * Works in Node.js runtimes. Returns true on success.
+     */
+    loadSkillFromFile(filePath) {
+        try {
+            const fs = require("fs");
+            this.loadSkillFile(filePath, fs);
+            this.version++;
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // ── Retrieval ────────────────────────────────────────────────────────
+    /**
+     * Get all registered skills.
+     */
+    getAll() {
+        return Array.from(this.skills.values());
+    }
+    /**
+     * Get a single skill by name.
+     */
+    get(name) {
+        return this.skills.get(name);
+    }
+    // ── Context Generation ───────────────────────────────────────────────
+    /**
+     * Returns `<available-skills>` XML string with lean descriptions.
+     * Returns "" if no skills are registered.
+     */
+    getDescriptionsForContext() {
+        if (this.skills.size === 0)
+            return "";
+        const lines = ["<available-skills>"];
+        for (const skill of this.skills.values()) {
+            lines.push(`  <skill name="${skill.name}">${skill.description}</skill>`);
+        }
+        lines.push("</available-skills>");
+        return lines.join("\n");
+    }
+    // ── Invocation & Injection ───────────────────────────────────────────
+    /**
+     * Queue a skill's content for injection into the next turn.
+     * Returns true if skill found, false otherwise.
+     */
+    invoke(name, args) {
+        const skill = this.skills.get(name);
+        if (!skill)
+            return false;
+        const argsBlock = args ? `\n\n## Input\n\n${args}` : "";
+        this.pendingInjection = `<skill-instructions name="${name}">\n${skill.content}${argsBlock}\n</skill-instructions>`;
+        return true;
+    }
+    /**
+     * Get the pending injection content (if any).
+     */
+    getPendingInjection() {
+        return this.pendingInjection;
+    }
+    /**
+     * Clear the pending injection queue.
+     */
+    clearPendingInjection() {
+        this.pendingInjection = null;
+    }
+    // ── Skill Tool ───────────────────────────────────────────────────────
+    /**
+     * Returns an ONI-Core ToolDefinition for the "Skill" tool.
+     * This tool allows the agent to invoke skills by name.
+     */
+    getSkillTool() {
+        const self = this;
+        return {
+            name: "Skill",
+            description: "Invoke a skill by name. Skills provide specialized capabilities and domain knowledge. " +
+                "Use this tool when a user's request matches an available skill.",
+            schema: {
+                type: "object",
+                properties: {
+                    name: {
+                        type: "string",
+                        description: "The skill name to invoke",
+                    },
+                },
+                required: ["name"],
+                additionalProperties: false,
+            },
+            execute(input) {
+                const found = self.invoke(input.name);
+                if (found) {
+                    return JSON.stringify({ success: true, skill: input.name });
+                }
+                return JSON.stringify({
+                    error: `Skill "${input.name}" not found. Check available skills and try again.`,
+                });
+            },
+        };
+    }
+}
+//# sourceMappingURL=skill-loader.js.map

package/dist/harness/skill-loader.js.map

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

package/dist/harness/todo-module.d.ts

@@ -0,0 +1,39 @@
+import type { ToolDefinition } from "../tools/types.js";
+export type TodoStatus = "pending" | "in_progress" | "completed" | "blocked";
+export type TodoPriority = "critical" | "high" | "medium" | "low";
+export interface Todo {
+    id: string;
+    content: string;
+    activeForm?: string;
+    status: TodoStatus;
+    priority: TodoPriority;
+    subtasks?: Todo[];
+    updatedAt: number;
+    agentName?: string;
+}
+export interface TodoState {
+    todos: Todo[];
+    lastUpdated: number;
+    sessionId?: string;
+}
+export declare class TodoModule {
+    private state;
+    private listeners;
+    constructor(sessionId?: string);
+    write(todos: Todo[]): void;
+    read(): TodoState;
+    getState(): TodoState;
+    updateStatus(id: string, status: TodoStatus): boolean;
+    getActive(): Todo[];
+    getCurrentFocus(): Todo | undefined;
+    isComplete(): boolean;
+    onChange(callback: (state: TodoState) => void): () => void;
+    private notify;
+    getTools(): ToolDefinition[];
+    private createWriteTool;
+    private createReadTool;
+    toJSON(): TodoState;
+    static fromJSON(json: TodoState): TodoModule;
+    toContextString(): string;
+}
+//# sourceMappingURL=todo-module.d.ts.map

package/dist/harness/todo-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-module.d.ts","sourceRoot":"","sources":["../../src/harness/todo-module.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,mBAAmB,CAAC;AAIrE,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAC7E,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAElE,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAaD,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,SAAS,CAAkC;gBAEvC,SAAS,CAAC,EAAE,MAAM;IAW9B,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI;IAY1B,IAAI,IAAI,SAAS;IAIjB,QAAQ,IAAI,SAAS;IAMrB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO;IAarD,SAAS,IAAI,IAAI,EAAE;IAInB,eAAe,IAAI,IAAI,GAAG,SAAS;IAInC,UAAU,IAAI,OAAO;IASrB,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI;IAO1D,OAAO,CAAC,MAAM;IAQd,QAAQ,IAAI,cAAc,EAAE;IAI5B,OAAO,CAAC,eAAe;IAoEvB,OAAO,CAAC,cAAc;IAgBtB,MAAM,IAAI,SAAS;IAInB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU;IAY5C,eAAe,IAAI,MAAM;CAgB1B"}

package/dist/harness/todo-module.js

@@ -0,0 +1,179 @@
+// ============================================================
+// @oni.bot/core/harness — TodoModule (working memory)
+// ============================================================
+// Claude Code-inspired: inject TODO state as system-reminder
+// after EVERY tool use to keep agents coherent across 50+ turns.
+// ============================================================
+// ─── Status Icons ───────────────────────────────────────────────────────────
+const STATUS_ICONS = {
+    completed: "✓",
+    in_progress: "○",
+    pending: "○",
+    blocked: "✗",
+};
+// ─── TodoModule ─────────────────────────────────────────────────────────────
+export class TodoModule {
+    state;
+    listeners;
+    constructor(sessionId) {
+        this.state = {
+            todos: [],
+            lastUpdated: 0,
+            sessionId,
+        };
+        this.listeners = new Set();
+    }
+    // ── Write (replace full list) ───────────────────────────────────────────
+    write(todos) {
+        const now = Date.now();
+        this.state = {
+            ...this.state,
+            todos: todos.map((t) => ({ ...t, updatedAt: now })),
+            lastUpdated: now,
+        };
+        this.notify();
+    }
+    // ── Read ────────────────────────────────────────────────────────────────
+    read() {
+        return this.state;
+    }
+    getState() {
+        return this.state;
+    }
+    // ── Update single todo status ───────────────────────────────────────────
+    updateStatus(id, status) {
+        const todo = this.state.todos.find((t) => t.id === id);
+        if (!todo)
+            return false;
+        todo.status = status;
+        todo.updatedAt = Date.now();
+        this.state.lastUpdated = todo.updatedAt;
+        this.notify();
+        return true;
+    }
+    // ── Queries ─────────────────────────────────────────────────────────────
+    getActive() {
+        return this.state.todos.filter((t) => t.status !== "completed");
+    }
+    getCurrentFocus() {
+        return this.state.todos.find((t) => t.status === "in_progress");
+    }
+    isComplete() {
+        return (this.state.todos.length > 0 &&
+            this.state.todos.every((t) => t.status === "completed"));
+    }
+    // ── Subscriptions ─────────────────────────────────────────────────────
+    onChange(callback) {
+        this.listeners.add(callback);
+        return () => {
+            this.listeners.delete(callback);
+        };
+    }
+    notify() {
+        for (const cb of this.listeners) {
+            cb(this.state);
+        }
+    }
+    // ── Tools ──────────────────────────────────────────────────────────────
+    getTools() {
+        return [this.createWriteTool(), this.createReadTool()];
+    }
+    createWriteTool() {
+        return {
+            name: "TodoWrite",
+            description: "Replace the full TODO list. Each todo needs id, content, status, and priority.",
+            schema: {
+                type: "object",
+                properties: {
+                    todos: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                id: { type: "string" },
+                                content: { type: "string" },
+                                activeForm: { type: "string" },
+                                status: {
+                                    type: "string",
+                                    enum: ["pending", "in_progress", "completed", "blocked"],
+                                },
+                                priority: {
+                                    type: "string",
+                                    enum: ["critical", "high", "medium", "low"],
+                                },
+                                subtasks: { type: "array" },
+                                agentName: { type: "string" },
+                            },
+                            required: ["id", "content", "status", "priority"],
+                        },
+                    },
+                },
+                required: ["todos"],
+            },
+            execute: (input, _ctx) => {
+                const todos = input.todos.map((t) => ({
+                    id: t.id,
+                    content: t.content,
+                    activeForm: t.activeForm,
+                    status: t.status || "pending",
+                    priority: t.priority || "medium",
+                    subtasks: t.subtasks,
+                    updatedAt: 0,
+                    agentName: t.agentName,
+                }));
+                this.write(todos);
+                const completed = todos.filter((t) => t.status === "completed").length;
+                const inProgress = todos.filter((t) => t.status === "in_progress").length;
+                const pending = todos.filter((t) => t.status === "pending").length;
+                return JSON.stringify({
+                    success: true,
+                    total: todos.length,
+                    completed,
+                    inProgress,
+                    pending,
+                });
+            },
+        };
+    }
+    createReadTool() {
+        return {
+            name: "TodoRead",
+            description: "Read the current TODO list state.",
+            schema: {
+                type: "object",
+                properties: {},
+            },
+            execute: (_input, _ctx) => {
+                return JSON.stringify(this.state);
+            },
+        };
+    }
+    // ── Serialization ─────────────────────────────────────────────────────
+    toJSON() {
+        return { ...this.state, todos: this.state.todos.map((t) => ({ ...t })) };
+    }
+    static fromJSON(json) {
+        const mod = new TodoModule(json.sessionId);
+        mod.state = {
+            todos: json.todos.map((t) => ({ ...t })),
+            lastUpdated: json.lastUpdated,
+            sessionId: json.sessionId,
+        };
+        return mod;
+    }
+    // ── Context String ────────────────────────────────────────────────────
+    toContextString() {
+        if (this.state.todos.length === 0) {
+            return "<todos>\nNo todos.\n</todos>";
+        }
+        const lines = this.state.todos.map((t) => {
+            const icon = STATUS_ICONS[t.status];
+            const priorityTag = t.priority === "critical" || t.priority === "high"
+                ? ` [${t.priority}]`
+                : "";
+            return `  ${icon} ${t.content}${priorityTag} (${t.status})`;
+        });
+        return `<todos>\n${lines.join("\n")}\n</todos>`;
+    }
+}
+//# sourceMappingURL=todo-module.js.map

package/dist/harness/todo-module.js.map

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

package/dist/harness/types.d.ts

@@ -0,0 +1,100 @@
+import type { ONIModel, ONIModelToolCall, ONIModelMessage } from "../models/types.js";
+import type { ToolDefinition, ToolContext } from "../tools/types.js";
+export interface HarnessToolContext extends ToolContext {
+    sessionId: string;
+    threadId: string;
+    agentName: string;
+    turn: number;
+    signal?: AbortSignal;
+    /** Ask the user a question and wait for their response. */
+    askUser?: (question: string) => Promise<string>;
+    /** Stream metadata updates during tool execution (e.g. progress indicators). */
+    metadata?: (update: {
+        title?: string;
+        metadata?: Record<string, unknown>;
+    }) => void;
+}
+export type LoopMessageType = "system" | "user" | "assistant" | "tool_result" | "tool_start" | "tool_metadata" | "step_start" | "step_finish" | "result" | "error";
+export interface LoopMessage {
+    type: LoopMessageType;
+    sessionId: string;
+    turn: number;
+    timestamp: number;
+    content?: string;
+    toolCalls?: ONIModelToolCall[];
+    toolResults?: LoopToolResult[];
+    subtype?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface LoopToolResult {
+    toolCallId: string;
+    toolName: string;
+    content: string;
+    isError?: boolean;
+    durationMs?: number;
+}
+/** Metadata update streamed from a tool while it's executing. */
+export interface ToolMetadataUpdate {
+    [key: string]: unknown;
+}
+export interface AgentLoopConfig {
+    model: ONIModel;
+    tools: ToolDefinition[];
+    agentName: string;
+    systemPrompt: string;
+    maxTurns?: number;
+    maxTokens?: number;
+    threadId?: string;
+    /** Prior conversation messages for multi-turn sessions */
+    initialMessages?: ONIModelMessage[];
+    todoModule?: import("./todo-module.js").TodoModule;
+    hooksEngine?: import("./hooks-engine.js").HooksEngine;
+    compactor?: import("./context-compactor.js").ContextCompactor;
+    safetyGate?: import("./safety-gate.js").SafetyGate;
+    skillLoader?: import("./skill-loader.js").SkillLoader;
+    signal?: AbortSignal;
+    /** Timeout for a single inference (LLM) call in milliseconds. */
+    inferenceTimeoutMs?: number;
+    /** Callback when the agent asks the user a question via the question tool. */
+    onQuestion?: (question: string, resolve: (answer: string | null) => void) => void;
+    /** Callback for streaming tool metadata updates. */
+    onToolMetadata?: (toolCallId: string, toolName: string, update: ToolMetadataUpdate) => void;
+    env?: {
+        cwd?: string;
+        platform?: string;
+        date?: string;
+        gitBranch?: string;
+        gitStatus?: string;
+    };
+}
+export interface HarnessConfig {
+    model: ONIModel;
+    fastModel?: ONIModel;
+    sharedTools?: ToolDefinition[];
+    soul?: string;
+    hooks?: import("./hooks-engine.js").HooksConfig;
+    compaction?: {
+        threshold?: number;
+        maxTokens?: number;
+        charsPerToken?: number;
+        compactInstructions?: string;
+    };
+    safety?: {
+        protectedTools?: string[];
+        safetySystemPrompt?: string;
+        timeout?: number;
+    };
+    skillPaths?: string[];
+    maxTurns?: number;
+    maxTokens?: number;
+    debug?: boolean;
+}
+export interface AgentNodeConfig {
+    name: string;
+    soul?: string;
+    tools?: ToolDefinition[];
+    maxTurns?: number;
+    allowedSkills?: string[];
+}
+export declare function generateId(prefix: string): string;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/harness/types.js

@@ -0,0 +1,9 @@
+// ============================================================
+// @oni.bot/core/harness — Types
+// ============================================================
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+let _idCounter = 0;
+export function generateId(prefix) {
+    return `${prefix}_${Date.now().toString(36)}_${(++_idCounter).toString(36)}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/harness/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gCAAgC;AAChC,+DAA+D;AA4H/D,gFAAgF;AAEhF,IAAI,UAAU,GAAG,CAAC,CAAC;AACnB,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/E,CAAC"}

package/dist/harness/validate-args.d.ts

@@ -0,0 +1,16 @@
+import type { JSONSchema } from "../models/types.js";
+/**
+ * Validate tool call arguments against the tool's JSON Schema.
+ * Returns null if valid, or a descriptive error string if invalid.
+ *
+ * Supports the JSON Schema subset used by our tool definitions:
+ * - type: "object", "string", "number", "integer", "boolean", "array"
+ * - required: string[] (required property names)
+ * - properties: Record<string, schema> (property schemas)
+ * - enum: any[] (allowed values)
+ * - items: schema (array item schema)
+ * - minimum, maximum (number bounds)
+ * - minLength, maxLength (string bounds)
+ */
+export declare function validateToolArgs(args: unknown, schema: JSONSchema, toolName: string): string | null;
+//# sourceMappingURL=validate-args.d.ts.map

package/dist/harness/validate-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-args.d.ts","sourceRoot":"","sources":["../../src/harness/validate-args.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAwCf"}