@oni.bot/core 0.6.3 → 1.0.0

package/dist/oni-code/session-fork.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Session Forking — branch-based conversation history management.
+ *
+ * Enables forking a conversation at any point to explore alternatives.
+ * Each branch is an independent copy of the message history that can
+ * diverge from the fork point.
+ *
+ * Swarm-aware: Forked branches can be dispatched as parallel swarm agents
+ * exploring different approaches (race/debate topologies). The SessionTree
+ * is concurrency-safe for reads — writes go through the active branch only.
+ *
+ * Usage:
+ *   const tree = new SessionTree();
+ *   tree.initRoot(existingMessages);
+ *   const branchId = tree.fork(3);      // Fork at message index 3
+ *   tree.switchBranch(branchId);         // Switch to new branch
+ *   tree.updateMessages(newMessages);    // Independent history
+ *   tree.switchBranch(tree.rootBranchId); // Switch back
+ */
+import type { ONIModelMessage } from "../models/types.js";
+export interface BranchMessage extends ONIModelMessage {
+    /** Unique message ID within the session tree */
+    messageId: string;
+}
+export interface SessionBranch {
+    /** Unique branch identifier */
+    id: string;
+    /** Parent branch (undefined for root) */
+    parentBranchId?: string;
+    /** Message ID where this branch forked from parent */
+    forkMessageId?: string;
+    /** Index in parent's message array where the fork occurred */
+    forkIndex?: number;
+    /** Branch display label */
+    label?: string;
+    /** Conversation messages in this branch */
+    messages: BranchMessage[];
+    /** When the branch was created */
+    createdAt: number;
+    /** Active agent name at branch creation */
+    activeAgent?: string;
+}
+export interface BranchInfo {
+    id: string;
+    parentBranchId?: string;
+    forkIndex?: number;
+    label?: string;
+    messageCount: number;
+    createdAt: number;
+    activeAgent?: string;
+    isActive: boolean;
+}
+/**
+ * Assign unique IDs to messages that lack them.
+ * Messages that already have a `messageId` keep it (idempotent).
+ */
+export declare function assignMessageIds(messages: ONIModelMessage[]): BranchMessage[];
+export declare class SessionTree {
+    private branches;
+    private activeBranchId;
+    /** Root branch ID — always set after construction */
+    readonly rootBranchId: string;
+    constructor();
+    /**
+     * Initialize the root branch with existing conversation messages.
+     * Call this once after construction to seed the tree.
+     */
+    initRoot(messages: ONIModelMessage[]): void;
+    /**
+     * Fork the active branch at a specific message index.
+     *
+     * Creates a new branch with messages [0..atIndex-1] from the active branch.
+     * If `atIndex` is omitted, forks at the current end (all messages copied).
+     *
+     * Returns the new branch ID.
+     */
+    fork(atIndex?: number, label?: string): string;
+    /**
+     * Switch the active branch. Returns the messages in the new active branch.
+     * Throws if branchId doesn't exist.
+     */
+    switchBranch(branchId: string): BranchMessage[];
+    /**
+     * Update the active branch's messages (e.g., after a chat turn).
+     * Messages without IDs get new ones assigned.
+     */
+    updateMessages(messages: ONIModelMessage[]): void;
+    /**
+     * Get the messages from the active branch.
+     */
+    getMessages(): BranchMessage[];
+    /**
+     * Get raw messages (without messageId) for passing to the agent loop.
+     * The agent loop expects ONIModelMessage[], not BranchMessage[].
+     */
+    getMessagesForLoop(): ONIModelMessage[];
+    /**
+     * Get the active branch.
+     */
+    getActiveBranch(): SessionBranch;
+    /**
+     * Get a branch by ID.
+     */
+    getBranch(branchId: string): SessionBranch | undefined;
+    /**
+     * Get the active branch ID.
+     */
+    getActiveBranchId(): string;
+    /**
+     * List all branches with summary info.
+     */
+    listBranches(): BranchInfo[];
+    /**
+     * Get the number of branches.
+     */
+    get branchCount(): number;
+    /**
+     * Get children of a branch (branches that forked from it).
+     */
+    getChildren(branchId: string): SessionBranch[];
+    /**
+     * Delete a branch. Cannot delete the root branch.
+     * If `cascade` is true, also deletes all children recursively.
+     *
+     * If the deleted branch was active, switches to root.
+     * Returns true if the branch was deleted.
+     */
+    deleteBranch(branchId: string, cascade?: boolean): boolean;
+    /**
+     * Export the full tree state for persistence.
+     */
+    toJSON(): {
+        rootBranchId: string;
+        activeBranchId: string;
+        branches: SessionBranch[];
+    };
+    /**
+     * Restore a tree from serialized state.
+     */
+    static fromJSON(data: {
+        rootBranchId: string;
+        activeBranchId: string;
+        branches: SessionBranch[];
+    }): SessionTree;
+}
+//# sourceMappingURL=session-fork.d.ts.map

package/dist/oni-code/session-fork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-fork.d.ts","sourceRoot":"","sources":["../../src/oni-code/session-fork.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAgBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,eAAe,EAAE,GAC1B,aAAa,EAAE,CAOjB;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,cAAc,CAAS;IAE/B,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;;IAe9B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,IAAI;IAO3C;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAiC9C;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;IAa/C;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,IAAI;IAKjD;;OAEG;IACH,WAAW,IAAI,aAAa,EAAE;IAI9B;;;OAGG;IACH,kBAAkB,IAAI,eAAe,EAAE;IAMvC;;OAEG;IACH,eAAe,IAAI,aAAa;IAIhC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAItD;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;OAEG;IACH,YAAY,IAAI,UAAU,EAAE;IAa5B;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE;IAQ9C;;;;;;OAMG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,UAAQ,GAAG,OAAO;IA2BxD;;OAEG;IACH,MAAM,IAAI;QACR,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,aAAa,EAAE,CAAC;KAC3B;IAQD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,aAAa,EAAE,CAAC;KAC3B,GAAG,WAAW;CAahB"}

package/dist/oni-code/session-fork.js

@@ -0,0 +1,238 @@
+/**
+ * Session Forking — branch-based conversation history management.
+ *
+ * Enables forking a conversation at any point to explore alternatives.
+ * Each branch is an independent copy of the message history that can
+ * diverge from the fork point.
+ *
+ * Swarm-aware: Forked branches can be dispatched as parallel swarm agents
+ * exploring different approaches (race/debate topologies). The SessionTree
+ * is concurrency-safe for reads — writes go through the active branch only.
+ *
+ * Usage:
+ *   const tree = new SessionTree();
+ *   tree.initRoot(existingMessages);
+ *   const branchId = tree.fork(3);      // Fork at message index 3
+ *   tree.switchBranch(branchId);         // Switch to new branch
+ *   tree.updateMessages(newMessages);    // Independent history
+ *   tree.switchBranch(tree.rootBranchId); // Switch back
+ */
+// ── ID Generation ─────────────────────────────────────────────
+let counter = 0;
+function generateBranchId() {
+    return `br_${Date.now().toString(36)}_${(counter++).toString(36)}`;
+}
+function generateMessageId() {
+    return `msg_${Date.now().toString(36)}_${(counter++).toString(36)}`;
+}
+// ── assignMessageIds ──────────────────────────────────────────
+/**
+ * Assign unique IDs to messages that lack them.
+ * Messages that already have a `messageId` keep it (idempotent).
+ */
+export function assignMessageIds(messages) {
+    return messages.map((msg) => {
+        if ("messageId" in msg && typeof msg.messageId === "string") {
+            return msg;
+        }
+        return { ...msg, messageId: generateMessageId() };
+    });
+}
+// ── SessionTree ───────────────────────────────────────────────
+export class SessionTree {
+    branches = new Map();
+    activeBranchId;
+    /** Root branch ID — always set after construction */
+    rootBranchId;
+    constructor() {
+        const rootId = generateBranchId();
+        this.rootBranchId = rootId;
+        this.activeBranchId = rootId;
+        this.branches.set(rootId, {
+            id: rootId,
+            messages: [],
+            createdAt: Date.now(),
+        });
+    }
+    // ── Root initialization ─────────────────────────────────────
+    /**
+     * Initialize the root branch with existing conversation messages.
+     * Call this once after construction to seed the tree.
+     */
+    initRoot(messages) {
+        const root = this.branches.get(this.rootBranchId);
+        root.messages = assignMessageIds(messages);
+    }
+    // ── Fork ────────────────────────────────────────────────────
+    /**
+     * Fork the active branch at a specific message index.
+     *
+     * Creates a new branch with messages [0..atIndex-1] from the active branch.
+     * If `atIndex` is omitted, forks at the current end (all messages copied).
+     *
+     * Returns the new branch ID.
+     */
+    fork(atIndex, label) {
+        const active = this.getActiveBranch();
+        const maxIndex = active.messages.length;
+        const forkAt = atIndex !== undefined ? Math.min(Math.max(0, atIndex), maxIndex) : maxIndex;
+        const forkMessageId = forkAt > 0
+            ? active.messages[forkAt - 1].messageId
+            : undefined;
+        // Clone messages up to the fork point with new IDs
+        const clonedMessages = active.messages.slice(0, forkAt).map((msg) => ({
+            ...msg,
+            messageId: generateMessageId(),
+        }));
+        const branchId = generateBranchId();
+        const branch = {
+            id: branchId,
+            parentBranchId: active.id,
+            forkMessageId,
+            forkIndex: forkAt,
+            label,
+            messages: clonedMessages,
+            createdAt: Date.now(),
+            activeAgent: active.activeAgent,
+        };
+        this.branches.set(branchId, branch);
+        return branchId;
+    }
+    // ── Branch switching ────────────────────────────────────────
+    /**
+     * Switch the active branch. Returns the messages in the new active branch.
+     * Throws if branchId doesn't exist.
+     */
+    switchBranch(branchId) {
+        const branch = this.branches.get(branchId);
+        if (!branch) {
+            throw new Error(`Branch "${branchId}" not found. Available: ${[...this.branches.keys()].join(", ")}`);
+        }
+        this.activeBranchId = branchId;
+        return [...branch.messages];
+    }
+    // ── Message management ──────────────────────────────────────
+    /**
+     * Update the active branch's messages (e.g., after a chat turn).
+     * Messages without IDs get new ones assigned.
+     */
+    updateMessages(messages) {
+        const active = this.getActiveBranch();
+        active.messages = assignMessageIds(messages);
+    }
+    /**
+     * Get the messages from the active branch.
+     */
+    getMessages() {
+        return [...this.getActiveBranch().messages];
+    }
+    /**
+     * Get raw messages (without messageId) for passing to the agent loop.
+     * The agent loop expects ONIModelMessage[], not BranchMessage[].
+     */
+    getMessagesForLoop() {
+        return this.getActiveBranch().messages.map(({ messageId: _, ...msg }) => msg);
+    }
+    // ── Branch queries ──────────────────────────────────────────
+    /**
+     * Get the active branch.
+     */
+    getActiveBranch() {
+        return this.branches.get(this.activeBranchId);
+    }
+    /**
+     * Get a branch by ID.
+     */
+    getBranch(branchId) {
+        return this.branches.get(branchId);
+    }
+    /**
+     * Get the active branch ID.
+     */
+    getActiveBranchId() {
+        return this.activeBranchId;
+    }
+    /**
+     * List all branches with summary info.
+     */
+    listBranches() {
+        return [...this.branches.values()].map((b) => ({
+            id: b.id,
+            parentBranchId: b.parentBranchId,
+            forkIndex: b.forkIndex,
+            label: b.label,
+            messageCount: b.messages.length,
+            createdAt: b.createdAt,
+            activeAgent: b.activeAgent,
+            isActive: b.id === this.activeBranchId,
+        }));
+    }
+    /**
+     * Get the number of branches.
+     */
+    get branchCount() {
+        return this.branches.size;
+    }
+    /**
+     * Get children of a branch (branches that forked from it).
+     */
+    getChildren(branchId) {
+        return [...this.branches.values()].filter((b) => b.parentBranchId === branchId);
+    }
+    // ── Branch deletion ─────────────────────────────────────────
+    /**
+     * Delete a branch. Cannot delete the root branch.
+     * If `cascade` is true, also deletes all children recursively.
+     *
+     * If the deleted branch was active, switches to root.
+     * Returns true if the branch was deleted.
+     */
+    deleteBranch(branchId, cascade = false) {
+        if (branchId === this.rootBranchId) {
+            return false; // Cannot delete root
+        }
+        if (!this.branches.has(branchId)) {
+            return false;
+        }
+        if (cascade) {
+            const children = this.getChildren(branchId);
+            for (const child of children) {
+                this.deleteBranch(child.id, true);
+            }
+        }
+        this.branches.delete(branchId);
+        // If we deleted the active branch, switch to root
+        if (this.activeBranchId === branchId) {
+            this.activeBranchId = this.rootBranchId;
+        }
+        return true;
+    }
+    // ── Serialization ───────────────────────────────────────────
+    /**
+     * Export the full tree state for persistence.
+     */
+    toJSON() {
+        return {
+            rootBranchId: this.rootBranchId,
+            activeBranchId: this.activeBranchId,
+            branches: [...this.branches.values()],
+        };
+    }
+    /**
+     * Restore a tree from serialized state.
+     */
+    static fromJSON(data) {
+        const tree = new SessionTree();
+        // Clear auto-generated root
+        tree.branches.clear();
+        // Restore branches
+        for (const branch of data.branches) {
+            tree.branches.set(branch.id, { ...branch });
+        }
+        // Restore IDs via private field writes
+        tree.rootBranchId = data.rootBranchId;
+        tree.activeBranchId = data.activeBranchId;
+        return tree;
+    }
+}
+//# sourceMappingURL=session-fork.js.map

package/dist/oni-code/session-fork.js.map

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

package/dist/oni-code/session-stats.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Session Statistics — tracks tool calls, timing, errors, and denials.
+ *
+ * Wired into the Conductor via PostToolUse / PostToolUseFailure hooks
+ * for zero-overhead observability. The UI can query stats for display.
+ */
+interface ToolStats {
+    count: number;
+    totalMs: number;
+}
+interface ErrorEntry {
+    tool: string;
+    error: string;
+}
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+}
+export interface SessionSummary {
+    totalToolCalls: number;
+    totalErrors: number;
+    totalDenied: number;
+    totalDurationMs: number;
+    toolBreakdown: Record<string, ToolStats>;
+    errors: ErrorEntry[];
+    /** Total token usage across all inference calls this session */
+    tokens: TokenUsage;
+    /** Number of inference calls made */
+    inferenceCount: number;
+    /** Number of compactions performed */
+    compactionCount: number;
+}
+export declare class SessionStats {
+    private toolCounts;
+    private errorLog;
+    private errorCount;
+    private deniedCount;
+    private totalCalls;
+    private totalMs;
+    private tokens;
+    private inferences;
+    private compactions;
+    /** Record a successful tool call with its duration */
+    recordToolCall(toolName: string, durationMs: number): void;
+    /** Record a tool error */
+    recordToolError(toolName: string, error: string): void;
+    /** Record a denied tool call (permission or loop detection) */
+    recordDenied(toolName: string, _reason: string): void;
+    /** Record token usage from an inference call */
+    recordInference(usage: {
+        inputTokens?: number;
+        outputTokens?: number;
+        cacheReadTokens?: number;
+        cacheWriteTokens?: number;
+    }): void;
+    /** Record that a compaction occurred */
+    recordCompaction(): void;
+    /** Get current total token usage */
+    getTokenUsage(): TokenUsage;
+    /** Get structured summary */
+    getSummary(): SessionSummary;
+    /** Format a human-readable summary */
+    formatSummary(): string;
+    /** Concise context string for PostCompact reinsertion — budget awareness */
+    toContextString(): string;
+    /** Reset all state */
+    reset(): void;
+}
+export {};
+//# sourceMappingURL=session-stats.d.ts.map

package/dist/oni-code/session-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-stats.d.ts","sourceRoot":"","sources":["../../src/oni-code/session-stats.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,gEAAgE;IAChE,MAAM,EAAE,UAAU,CAAC;IACnB,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;CACzB;AAQD,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAgC;IAClD,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,MAAM,CAA4F;IAC1G,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAK;IAExB,sDAAsD;IACtD,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAa1D,0BAA0B;IAC1B,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAOtD,+DAA+D;IAC/D,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIrD,gDAAgD;IAChD,eAAe,CAAC,KAAK,EAAE;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,IAAI;IAQR,wCAAwC;IACxC,gBAAgB,IAAI,IAAI;IAIxB,oCAAoC;IACpC,aAAa,IAAI,UAAU;IAI3B,6BAA6B;IAC7B,UAAU,IAAI,cAAc;IAmB5B,sCAAsC;IACtC,aAAa,IAAI,MAAM;IA8BvB,4EAA4E;IAC5E,eAAe,IAAI,MAAM;IAwBzB,sBAAsB;IACtB,KAAK,IAAI,IAAI;CAWd"}

package/dist/oni-code/session-stats.js

@@ -0,0 +1,141 @@
+/**
+ * Session Statistics — tracks tool calls, timing, errors, and denials.
+ *
+ * Wired into the Conductor via PostToolUse / PostToolUseFailure hooks
+ * for zero-overhead observability. The UI can query stats for display.
+ */
+// ── Constants ────────────────────────────────────────────────
+const MAX_ERROR_LOG = 50;
+// ── SessionStats ─────────────────────────────────────────────
+export class SessionStats {
+    toolCounts = new Map();
+    errorLog = [];
+    errorCount = 0;
+    deniedCount = 0;
+    totalCalls = 0;
+    totalMs = 0;
+    tokens = { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0 };
+    inferences = 0;
+    compactions = 0;
+    /** Record a successful tool call with its duration */
+    recordToolCall(toolName, durationMs) {
+        this.totalCalls++;
+        this.totalMs += durationMs;
+        const existing = this.toolCounts.get(toolName);
+        if (existing) {
+            existing.count++;
+            existing.totalMs += durationMs;
+        }
+        else {
+            this.toolCounts.set(toolName, { count: 1, totalMs: durationMs });
+        }
+    }
+    /** Record a tool error */
+    recordToolError(toolName, error) {
+        this.errorCount++;
+        if (this.errorLog.length < MAX_ERROR_LOG) {
+            this.errorLog.push({ tool: toolName, error });
+        }
+    }
+    /** Record a denied tool call (permission or loop detection) */
+    recordDenied(toolName, _reason) {
+        this.deniedCount++;
+    }
+    /** Record token usage from an inference call */
+    recordInference(usage) {
+        this.inferences++;
+        this.tokens.inputTokens += usage.inputTokens ?? 0;
+        this.tokens.outputTokens += usage.outputTokens ?? 0;
+        this.tokens.cacheReadTokens += usage.cacheReadTokens ?? 0;
+        this.tokens.cacheWriteTokens += usage.cacheWriteTokens ?? 0;
+    }
+    /** Record that a compaction occurred */
+    recordCompaction() {
+        this.compactions++;
+    }
+    /** Get current total token usage */
+    getTokenUsage() {
+        return { ...this.tokens };
+    }
+    /** Get structured summary */
+    getSummary() {
+        const toolBreakdown = {};
+        for (const [name, stats] of this.toolCounts) {
+            toolBreakdown[name] = { ...stats };
+        }
+        return {
+            totalToolCalls: this.totalCalls,
+            totalErrors: this.errorCount,
+            totalDenied: this.deniedCount,
+            totalDurationMs: this.totalMs,
+            toolBreakdown,
+            errors: [...this.errorLog],
+            tokens: { ...this.tokens },
+            inferenceCount: this.inferences,
+            compactionCount: this.compactions,
+        };
+    }
+    /** Format a human-readable summary */
+    formatSummary() {
+        const s = this.getSummary();
+        const lines = [];
+        lines.push(`${s.totalToolCalls} tool calls | ${s.totalErrors} error${s.totalErrors !== 1 ? "s" : ""} | ${Math.round(s.totalDurationMs)}ms total`);
+        if (Object.keys(s.toolBreakdown).length > 0) {
+            const sorted = Object.entries(s.toolBreakdown)
+                .sort((a, b) => b[1].count - a[1].count);
+            for (const [name, stats] of sorted) {
+                lines.push(`  ${name}: ${stats.count}x (${Math.round(stats.totalMs)}ms)`);
+            }
+        }
+        if (s.totalDenied > 0) {
+            lines.push(`${s.totalDenied} denied`);
+        }
+        if (s.inferenceCount > 0) {
+            const totalTok = s.tokens.inputTokens + s.tokens.outputTokens;
+            lines.push(`${s.inferenceCount} inference${s.inferenceCount !== 1 ? "s" : ""} | ${formatTokenCount(totalTok)} tokens (${formatTokenCount(s.tokens.inputTokens)} in, ${formatTokenCount(s.tokens.outputTokens)} out)`);
+        }
+        if (s.compactionCount > 0) {
+            lines.push(`${s.compactionCount} compaction${s.compactionCount !== 1 ? "s" : ""}`);
+        }
+        return lines.join("\n");
+    }
+    /** Concise context string for PostCompact reinsertion — budget awareness */
+    toContextString() {
+        if (this.inferences === 0 && this.totalCalls === 0)
+            return "";
+        const totalTok = this.tokens.inputTokens + this.tokens.outputTokens;
+        const parts = [];
+        if (this.inferences > 0) {
+            parts.push(`${this.inferences} inference${this.inferences !== 1 ? "s" : ""}`, `${formatTokenCount(totalTok)} tokens (${formatTokenCount(this.tokens.inputTokens)} in, ${formatTokenCount(this.tokens.outputTokens)} out)`);
+        }
+        if (this.compactions > 0) {
+            parts.push(`${this.compactions} compaction${this.compactions !== 1 ? "s" : ""}`);
+        }
+        if (this.totalCalls > 0) {
+            parts.push(`${this.totalCalls} tool calls`);
+        }
+        return parts.join(" | ");
+    }
+    /** Reset all state */
+    reset() {
+        this.toolCounts.clear();
+        this.errorLog = [];
+        this.errorCount = 0;
+        this.deniedCount = 0;
+        this.totalCalls = 0;
+        this.totalMs = 0;
+        this.tokens = { inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0 };
+        this.inferences = 0;
+        this.compactions = 0;
+    }
+}
+// ── Helpers ──────────────────────────────────────────────────
+/** Format token count with K/M suffix for readability */
+function formatTokenCount(count) {
+    if (count >= 1_000_000)
+        return `${(count / 1_000_000).toFixed(1)}M`;
+    if (count >= 1_000)
+        return `${(count / 1_000).toFixed(1)}K`;
+    return String(count);
+}
+//# sourceMappingURL=session-stats.js.map

package/dist/oni-code/session-stats.js.map

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

package/dist/oni-code/session-title.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Session Title Generator — auto-generates a short title for the session
+ * from the user's first message.
+ *
+ * Uses a fast/cheap model (when available) to generate a ≤50 character title.
+ * Fire-and-forget after the first assistant response completes.
+ * Gracefully degrades: returns null on any error.
+ */
+import type { ONIModel } from "../models/types.js";
+export declare class SessionTitleGenerator {
+    private readonly model;
+    private title;
+    constructor(model: ONIModel);
+    /**
+     * Generate a title from the user's message.
+     * Returns the cached title if already generated.
+     * Returns null on error or empty response.
+     */
+    generate(userMessage: string): Promise<string | null>;
+    /** Get the current title (null if not yet generated). */
+    getTitle(): string | null;
+    /** Check if a title string is a placeholder/default. */
+    static isDefaultTitle(title: string): boolean;
+}
+//# sourceMappingURL=session-title.d.ts.map

package/dist/oni-code/session-title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-title.d.ts","sourceRoot":"","sources":["../../src/oni-code/session-title.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAkBnD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,KAAK,CAAuB;gBAExB,KAAK,EAAE,QAAQ;IAI3B;;;;OAIG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4B3D,yDAAyD;IACzD,QAAQ,IAAI,MAAM,GAAG,IAAI;IAIzB,wDAAwD;IACxD,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAG9C"}