@kenkaiiii/ggcoder 5.74.2 → 5.75.0

package/dist/core/agent-session/mcp-tools.js

@@ -0,0 +1,195 @@
+import { z } from "zod";
+import { log } from "../logger.js";
+import { MCPClientManager } from "../mcp/index.js";
+import { clampMcpToolDescription, DeferredToolCatalog } from "../mcp/deferred-catalog.js";
+import { McpCatalogCache } from "../mcp/catalog-cache.js";
+import { createToolSearchTool } from "../../tools/tool-search.js";
+/**
+ * MCP tool wiring for one session: the client manager, the deferred
+ * `tool_search` catalog (shared with deferred built-ins), cached-catalog stubs
+ * and the live/cached reconcile maps.
+ *
+ * Never owns the tool array — it reads the session's CURRENT array through
+ * `getTools` (the session may filter-replace it) and only appends to it or
+ * swaps same-named entries in place, so the cached tool prefix stays stable.
+ */
+export class McpToolRegistry {
+    getTools;
+    getContextLimits;
+    manager;
+    /** Deferred MCP tools awaiting discovery via tool_search. */
+    catalog;
+    /** Live (connected) MCP tools by name — the reconcile target for cached stubs. */
+    liveTools = new Map();
+    /** Server name for each cached-only tool, so a stub knows what to wait on. */
+    cachedToolServers = new Map();
+    catalogCache = new McpCatalogCache();
+    constructor(getTools, getContextLimits) {
+        this.getTools = getTools;
+        this.getContextLimits = getContextLimits;
+    }
+    createManager(options) {
+        this.manager = new MCPClientManager({
+            catalogCache: this.catalogCache,
+            modernProtocol: options.modernProtocol,
+            onElicit: options.onElicit,
+        });
+    }
+    ensureCatalog() {
+        this.catalog ??= new DeferredToolCatalog(this.getContextLimits());
+        return this.catalog;
+    }
+    /** Hold tools in the tool_search catalog and make sure tool_search exists. */
+    addDeferred(tools) {
+        this.ensureCatalog().add(tools);
+        this.ensureToolSearchTool();
+    }
+    /** Pull named entries out of the catalog (empty when no catalog exists). */
+    promote(names) {
+        return this.catalog?.promote(names) ?? [];
+    }
+    /** Forget every MCP tool before a provider-switch reconnect re-adds them. */
+    clearMcpTools() {
+        this.catalog?.removeWhere((name) => name.startsWith("mcp__"));
+        this.liveTools.clear();
+        this.cachedToolServers.clear();
+    }
+    /**
+     * Route freshly connected MCP tools: deferred into the tool_search catalog
+     * (default — keeps ~8k tokens of schema out of every cache-miss turn) or
+     * pushed eagerly when `defer` is false.
+     * Promotion pushes onto the live tools array the running agent loop
+     * re-reads every turn, so promoted tools are callable on the next step.
+     */
+    addMcpTools(mcpTools, defer) {
+        if (mcpTools.length === 0)
+            return;
+        for (const tool of mcpTools) {
+            this.liveTools.set(tool.name, tool);
+            this.cachedToolServers.delete(tool.name);
+        }
+        if (!defer) {
+            // Eager path bypasses the catalog, so budget descriptions here too.
+            this.replaceOrPushTools(mcpTools.map((tool) => clampMcpToolDescription(tool, this.getContextLimits())));
+            return;
+        }
+        // `add` is name-keyed, so live definitions replace cached stubs in place.
+        this.ensureCatalog().add(mcpTools);
+        // A stub the model already promoted lives in the tools array; swap it for
+        // the live tool so later calls dispatch directly instead of through the stub.
+        this.replaceLivePromotedTools(mcpTools);
+        this.ensureToolSearchTool();
+    }
+    /**
+     * Register `tool_search` once. Promotion of a cached-only entry waits for its
+     * server so the model is told immediately when that capability turns out to
+     * be unreachable, instead of promoting a tool that fails on first call.
+     *
+     * The catalog is created on demand rather than required up front: deferred
+     * built-in tools populate it with zero MCP servers connected, so gating
+     * registration on an existing catalog would leave those tools unreachable.
+     */
+    ensureToolSearchTool() {
+        const catalog = this.ensureCatalog();
+        if (this.getTools().some((t) => t.name === "tool_search"))
+            return;
+        this.getTools().push(createToolSearchTool(catalog, (promoted) => {
+            this.getTools().push(...promoted);
+        }, async (toolName) => {
+            if (this.liveTools.has(toolName))
+                return undefined;
+            const serverName = this.cachedToolServers.get(toolName);
+            if (!serverName)
+                return undefined;
+            const outcome = (await this.manager?.whenConnected(serverName)) ?? {
+                ok: false,
+                error: "MCP is disabled for this session",
+            };
+            return outcome.ok
+                ? { serverName, ok: true }
+                : { serverName, ok: false, error: outcome.error };
+        }, this.getContextLimits()));
+    }
+    /** Append tools, replacing any same-named entry (cached stub → live tool). */
+    replaceOrPushTools(tools) {
+        const live = this.getTools();
+        for (const tool of tools) {
+            const index = live.findIndex((t) => t.name === tool.name);
+            if (index >= 0)
+                live[index] = tool;
+            else
+                live.push(tool);
+        }
+    }
+    /** Swap already-promoted cached stubs for their live equivalents, in place. */
+    replaceLivePromotedTools(tools) {
+        const live = this.getTools();
+        for (const tool of tools) {
+            const index = live.findIndex((t) => t.name === tool.name);
+            if (index >= 0)
+                live[index] = tool;
+        }
+    }
+    /**
+     * Publish cached tool definitions into the deferred catalog so `tool_search`
+     * answers correctly on turn 1. A cached stub carries the real name, one-line
+     * description and input schema; calling it waits for the live connection and
+     * then dispatches against the real client, or returns a clear error when that
+     * server ultimately failed. Live tools replace stubs on connect.
+     */
+    async seedFromCache(servers) {
+        let entries;
+        try {
+            entries = await this.catalogCache.entriesFor(servers);
+        }
+        catch {
+            return;
+        }
+        const stubs = [];
+        for (const [serverName, entry] of entries) {
+            for (const cached of entry.tools) {
+                if (this.liveTools.has(cached.name))
+                    continue;
+                this.cachedToolServers.set(cached.name, serverName);
+                stubs.push(this.buildCachedMcpTool(serverName, cached));
+            }
+        }
+        if (stubs.length === 0)
+            return;
+        log("INFO", "mcp", "Seeded deferred tool catalog from cache", {
+            tools: String(stubs.length),
+            servers: String(entries.size),
+        });
+        // Catalog-only registration for cached stubs — never marks them live.
+        this.addDeferred(stubs);
+    }
+    buildCachedMcpTool(serverName, cached) {
+        return {
+            name: cached.name,
+            description: cached.description,
+            parameters: z.record(z.string(), z.unknown()),
+            rawInputSchema: cached.rawInputSchema,
+            execute: async (args, context) => {
+                const live = this.liveTools.get(cached.name);
+                if (live)
+                    return live.execute(args, context);
+                const outcome = (await this.manager?.whenConnected(serverName)) ?? {
+                    ok: false,
+                    error: "MCP is disabled for this session",
+                };
+                if (!outcome.ok) {
+                    return (`MCP tool ${cached.name} is unavailable: server "${serverName}" did not connect ` +
+                        `(${outcome.error}). This tool was offered from a cached catalog. ` +
+                        `Use a different approach or ask the user to check their MCP configuration.`);
+                }
+                const connected = this.liveTools.get(cached.name);
+                if (!connected) {
+                    return (`MCP tool ${cached.name} no longer exists: server "${serverName}" connected but ` +
+                        `does not expose it. The cached catalog entry was stale.`);
+                }
+                return connected.execute(args, context);
+            },
+        };
+    }
+}
+//# sourceMappingURL=mcp-tools.js.map

package/dist/core/agent-session/mcp-tools.js.map

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

package/dist/core/agent-session/run-loop-monitor.d.ts

@@ -0,0 +1,63 @@
+import { CycleDetector, ToolCallProgressTracker, type CycleDetection, type LoopBreakDecision } from "../loop-breaker.js";
+import { type SemanticCallDigest, type SemanticLoopVerdict } from "../semantic-loop-check.js";
+/** LLM-judged loop detection state for one run. */
+export interface SemanticLoopRunState {
+    checksUsed: number;
+    lastCheckTurn: number;
+    pending: boolean;
+    verdict: SemanticLoopVerdict | null;
+    injected: boolean;
+}
+/**
+ * Per-run stuck-detection state (mirrors the TUI's useAgentLoop refs): tool
+ * stats, streamed text, progress/cycle trackers, the two-stage loop-breaker and
+ * the semantic loop judge's budget. Reset at the start of every run; observed
+ * from the event stream. Owns state and decisions only — logging, events and
+ * the judge call stay with the session.
+ */
+export declare class RunLoopMonitor {
+    stats: {
+        toolCalls: number;
+        toolFailures: number;
+        turns: number;
+    };
+    text: string;
+    consecutiveFailures: number;
+    repeatedNoProgressCalls: number;
+    readonly progressTracker: ToolCallProgressTracker;
+    readonly cycleDetector: CycleDetector;
+    cyclicPattern: CycleDetection | null;
+    /** 0 = none; 1 = first nudge sent; 2 = final stop-and-report injected. */
+    loopBreakInjected: 0 | 1 | 2;
+    /** Recent tool-call digests for the semantic loop judge — bounded ring. */
+    recentCalls: SemanticCallDigest[];
+    /** LLM-judged loop detection state. `verdict` holds a LOOP verdict awaiting
+     *  injection at the next steering poll; judge failures fail open (no
+     *  injection) and still consume budget + cooldown. Replaced (never mutated)
+     *  on reset so a late judge from an earlier run cannot write into it. */
+    semanticLoop: SemanticLoopRunState;
+    /** Clean slate for a new run. */
+    reset(): void;
+    recordText(text: string): void;
+    recordToolEnd(name: string, args: Record<string, unknown> | undefined, result: string, isError: boolean): void;
+    recordTurn(turn: number): void;
+    /** Deterministic stuck verdict from the current signals. */
+    evaluateLoopBreak(): LoopBreakDecision;
+    /**
+     * Two-stage loop-breaker: stage 1 nudges; a FRESH detection after that
+     * escalates to stage 2. Returns the stage to inject (signals reset so stage 2
+     * only fires on new evidence), or null when nothing should be injected.
+     */
+    takeLoopBreakStage(decision: LoopBreakDecision): 1 | 2 | null;
+    /** Consume a pending semantic LOOP verdict, exactly once per run. */
+    takeSemanticVerdict(): SemanticLoopVerdict | null;
+    shouldRunSemanticCheck(deterministicBreak: boolean): boolean;
+    /** Mark a judge call in flight; the returned run state is its stale-guard token. */
+    beginSemanticCheck(): SemanticLoopRunState;
+    /** Publish a judge verdict only if its run is still the current one. */
+    publishSemanticVerdict(runState: SemanticLoopRunState, verdict: SemanticLoopVerdict): void;
+    /** Settle a judge call: consume budget + cooldown, unless its run is stale. */
+    settleSemanticCheck(runState: SemanticLoopRunState): void;
+    /** Reasons to refuse a turn-budget extension; empty means grant. */
+    turnExtensionRefusals(): string[];
+}

package/dist/core/agent-session/run-loop-monitor.js

@@ -0,0 +1,164 @@
+import { evaluateLoopBreak, CycleDetector, ToolCallProgressTracker, detectTextRepetition, } from "../loop-breaker.js";
+import { MAX_SEMANTIC_LOOP_CALLS, shouldRunSemanticLoopCheck, } from "../semantic-loop-check.js";
+import { TURN_EXTENSION_MAX_FAILURE_RATIO } from "./helpers.js";
+function freshSemanticLoopState() {
+    return { checksUsed: 0, lastCheckTurn: 0, pending: false, verdict: null, injected: false };
+}
+/**
+ * Per-run stuck-detection state (mirrors the TUI's useAgentLoop refs): tool
+ * stats, streamed text, progress/cycle trackers, the two-stage loop-breaker and
+ * the semantic loop judge's budget. Reset at the start of every run; observed
+ * from the event stream. Owns state and decisions only — logging, events and
+ * the judge call stay with the session.
+ */
+export class RunLoopMonitor {
+    stats = { toolCalls: 0, toolFailures: 0, turns: 0 };
+    text = "";
+    consecutiveFailures = 0;
+    repeatedNoProgressCalls = 0;
+    progressTracker = new ToolCallProgressTracker();
+    cycleDetector = new CycleDetector();
+    cyclicPattern = null;
+    /** 0 = none; 1 = first nudge sent; 2 = final stop-and-report injected. */
+    loopBreakInjected = 0;
+    /** Recent tool-call digests for the semantic loop judge — bounded ring. */
+    recentCalls = [];
+    /** LLM-judged loop detection state. `verdict` holds a LOOP verdict awaiting
+     *  injection at the next steering poll; judge failures fail open (no
+     *  injection) and still consume budget + cooldown. Replaced (never mutated)
+     *  on reset so a late judge from an earlier run cannot write into it. */
+    semanticLoop = freshSemanticLoopState();
+    /** Clean slate for a new run. */
+    reset() {
+        this.stats = { toolCalls: 0, toolFailures: 0, turns: 0 };
+        this.text = "";
+        this.consecutiveFailures = 0;
+        this.repeatedNoProgressCalls = 0;
+        this.progressTracker.reset();
+        this.cycleDetector.reset();
+        this.cyclicPattern = null;
+        this.loopBreakInjected = 0;
+        this.recentCalls = [];
+        this.semanticLoop = freshSemanticLoopState();
+    }
+    recordText(text) {
+        this.text += text;
+    }
+    recordToolEnd(name, args, result, isError) {
+        this.stats.toolCalls += 1;
+        if (isError)
+            this.stats.toolFailures += 1;
+        this.consecutiveFailures = isError ? this.consecutiveFailures + 1 : 0;
+        this.repeatedNoProgressCalls = this.progressTracker.record(name, args, result, isError);
+        this.cyclicPattern = this.cycleDetector.record(name, args, result, isError);
+        // Semantic-loop judge input: a bounded digest of WHAT was attempted and
+        // HOW it came out. Args/results are sliced AT RECORD TIME — a write with
+        // a 50 KiB payload or a bash dump must never inflate the ring, and the
+        // judge needs shapes, not payloads.
+        this.recentCalls.push({
+            tool: name,
+            args: args === undefined ? "" : JSON.stringify(args).slice(0, 300),
+            ok: !isError,
+            result: result.slice(0, 400),
+        });
+        if (this.recentCalls.length > MAX_SEMANTIC_LOOP_CALLS) {
+            this.recentCalls.splice(0, this.recentCalls.length - MAX_SEMANTIC_LOOP_CALLS);
+        }
+    }
+    recordTurn(turn) {
+        this.stats.turns = turn;
+    }
+    /** Deterministic stuck verdict from the current signals. */
+    evaluateLoopBreak() {
+        return evaluateLoopBreak({
+            consecutiveFailures: this.consecutiveFailures,
+            repeatedNoProgressCalls: this.repeatedNoProgressCalls,
+            textRepetitionDetected: detectTextRepetition(this.text),
+            ...(this.cyclicPattern ? { cyclicPattern: this.cyclicPattern } : {}),
+        });
+    }
+    /**
+     * Two-stage loop-breaker: stage 1 nudges; a FRESH detection after that
+     * escalates to stage 2. Returns the stage to inject (signals reset so stage 2
+     * only fires on new evidence), or null when nothing should be injected.
+     */
+    takeLoopBreakStage(decision) {
+        if (this.loopBreakInjected >= 2)
+            return null;
+        if (!decision.shouldBreak)
+            return null;
+        const stage = this.loopBreakInjected === 0 ? 1 : 2;
+        this.loopBreakInjected = stage;
+        this.progressTracker.reset();
+        this.cycleDetector.reset();
+        this.cyclicPattern = null;
+        this.consecutiveFailures = 0;
+        this.repeatedNoProgressCalls = 0;
+        // The deterministic breaker owns this burst — a semantic verdict from
+        // the same burst must not double-correct on the next poll.
+        this.semanticLoop.verdict = null;
+        // Clear the text buffer too — otherwise a stage-1 text-repetition
+        // trigger still sees the same repeated tail on the next check and
+        // escalates to stage 2 on stale evidence.
+        this.text = "";
+        return stage;
+    }
+    /** Consume a pending semantic LOOP verdict, exactly once per run. */
+    takeSemanticVerdict() {
+        if (!this.semanticLoop.verdict || this.semanticLoop.injected)
+            return null;
+        const verdict = this.semanticLoop.verdict;
+        this.semanticLoop.injected = true;
+        this.semanticLoop.verdict = null;
+        // The judged burst has been addressed; a fresh burst must re-accumulate.
+        this.consecutiveFailures = 0;
+        return verdict;
+    }
+    shouldRunSemanticCheck(deterministicBreak) {
+        return shouldRunSemanticLoopCheck({
+            consecutiveFailures: this.consecutiveFailures,
+            totalFailures: this.stats.toolFailures,
+            turns: this.stats.turns,
+            lastCheckTurn: this.semanticLoop.lastCheckTurn,
+            checksUsed: this.semanticLoop.checksUsed,
+            checkPending: this.semanticLoop.pending,
+            deterministicBreak,
+        });
+    }
+    /** Mark a judge call in flight; the returned run state is its stale-guard token. */
+    beginSemanticCheck() {
+        const runState = this.semanticLoop;
+        runState.pending = true;
+        return runState;
+    }
+    /** Publish a judge verdict only if its run is still the current one. */
+    publishSemanticVerdict(runState, verdict) {
+        if (this.semanticLoop === runState)
+            runState.verdict = verdict;
+    }
+    /** Settle a judge call: consume budget + cooldown, unless its run is stale. */
+    settleSemanticCheck(runState) {
+        if (this.semanticLoop === runState) {
+            runState.pending = false;
+            runState.checksUsed += 1;
+            runState.lastCheckTurn = this.stats.turns;
+        }
+    }
+    /** Reasons to refuse a turn-budget extension; empty means grant. */
+    turnExtensionRefusals() {
+        const refusals = [];
+        const stuck = this.evaluateLoopBreak();
+        if (stuck.shouldBreak)
+            refusals.push(...stuck.reasons);
+        // Stage 2 means the loop-breaker already detected spinning twice and told
+        // the agent to stop and report. Do not overrule that with more turns.
+        if (this.loopBreakInjected >= 2)
+            refusals.push("loop-breaker already escalated");
+        const { toolCalls, toolFailures } = this.stats;
+        if (toolCalls > 0 && toolFailures / toolCalls > TURN_EXTENSION_MAX_FAILURE_RATIO) {
+            refusals.push(`${toolFailures}/${toolCalls} tool calls failed`);
+        }
+        return refusals;
+    }
+}
+//# sourceMappingURL=run-loop-monitor.js.map

package/dist/core/agent-session/run-loop-monitor.js.map

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

package/dist/core/agent-session/transcript-markers.d.ts

@@ -0,0 +1,57 @@
+import { type KenTurnPayload, type AutopilotMarkerPayload, type AppMarkerPayload, type SessionEntry, type SessionManager, type TurnMetricPayload } from "../session-manager.js";
+import type { CompactionAnchorRemap } from "../compaction/compactor.js";
+/**
+ * Display-only transcript history recorded against a session file: Ken Kai
+ * turns, autopilot verdicts, app markers and per-turn metrics. NEVER part of
+ * the LLM message history — persisted as `custom` entries (parentId null, so
+ * never on the message DAG) and reloaded on resume so the transcript renders
+ * the same rows the live run showed. Persistence is a no-op while the session
+ * has no file (transient sessions keep markers in memory only).
+ */
+export declare class TranscriptMarkers {
+    private readonly getSessionManager;
+    private readonly getSessionPath;
+    private kenTurns;
+    private autopilotMarkers;
+    private appMarkers;
+    private turnMetrics;
+    constructor(getSessionManager: () => SessionManager, getSessionPath: () => string);
+    getKenTurns(): KenTurnPayload[];
+    getAutopilotMarkers(): AutopilotMarkerPayload[];
+    getAppMarkers(): AppMarkerPayload[];
+    getTurnMetrics(): TurnMetricPayload[];
+    /** Summed cost when every recorded turn has a known price, else undefined. */
+    knownCostUsd(): number | undefined;
+    /** Drop everything — display-only history belongs to the OLD session. */
+    clear(): void;
+    /**
+     * Restore from a loaded session file. The leaf is passed so each marker also
+     * carries its FILE-order position, the fallback used when a legacy anchor is
+     * out of range (see RecordedPosition).
+     */
+    restore(entries: SessionEntry[], leafId: string | null | undefined): void;
+    /**
+     * Rebase every transcript anchor (Ken turns, autopilot verdicts, app markers)
+     * onto a freshly compacted message list.
+     */
+    remapAnchors(remap: CompactionAnchorRemap | undefined): void;
+    recordKenTurn(question: string, reply: string, afterMessageCount: number): Promise<void>;
+    recordAutopilotMarker(phase: AutopilotMarkerPayload["phase"], extra: {
+        reason?: string;
+        body?: string;
+    } | undefined, afterMessageCount: number): Promise<void>;
+    recordAppMarker(kind: AppMarkerPayload["kind"], data: Record<string, unknown>, afterMessageCount: number): Promise<void>;
+    /** Keep a turn metric in memory; {@link persistTurnMetric} writes it. */
+    addTurnMetric(payload: TurnMetricPayload): void;
+    persistTurnMetric(payload: TurnMetricPayload): Promise<void>;
+    /**
+     * Re-append everything to the current session file. Called after a
+     * continuation/compaction file is created so display-only history isn't lost
+     * when the session is rewritten (those rewrites only re-persist messages).
+     * Each marker keeps its original `afterMessageCount` anchor.
+     */
+    rePersistAll(): Promise<void>;
+    private rePersistTurnMetrics;
+    private rePersist;
+    private append;
+}

package/dist/core/agent-session/transcript-markers.js

@@ -0,0 +1,166 @@
+import crypto from "node:crypto";
+import { KEN_TURN_CUSTOM_KIND, AUTOPILOT_MARKER_CUSTOM_KIND, APP_MARKER_CUSTOM_KIND, } from "../session-manager.js";
+import { remapAnchorForCompaction, stripRecordedPosition } from "../session-history.js";
+/**
+ * Display-only transcript history recorded against a session file: Ken Kai
+ * turns, autopilot verdicts, app markers and per-turn metrics. NEVER part of
+ * the LLM message history — persisted as `custom` entries (parentId null, so
+ * never on the message DAG) and reloaded on resume so the transcript renders
+ * the same rows the live run showed. Persistence is a no-op while the session
+ * has no file (transient sessions keep markers in memory only).
+ */
+export class TranscriptMarkers {
+    getSessionManager;
+    getSessionPath;
+    // Ken Kai (mentor agent) turns. Each carries the non-system message count at
+    // record time so the webview can interleave them chronologically.
+    kenTurns = [];
+    // Autopilot Ken (auto-reviewer) verdict markers (prompted / done / human /
+    // capped), so a resumed session shows the identical Ken bubble the live run
+    // showed instead of dropping it or replaying a raw verdict.
+    autopilotMarkers = [];
+    // Generic app transcript markers (plan-mode banner, task header, error rows,
+    // user-bubble display hints).
+    appMarkers = [];
+    turnMetrics = [];
+    constructor(getSessionManager, getSessionPath) {
+        this.getSessionManager = getSessionManager;
+        this.getSessionPath = getSessionPath;
+    }
+    getKenTurns() {
+        return this.kenTurns;
+    }
+    getAutopilotMarkers() {
+        return this.autopilotMarkers;
+    }
+    getAppMarkers() {
+        return this.appMarkers;
+    }
+    getTurnMetrics() {
+        return this.turnMetrics.map((metric) => ({
+            ...metric,
+            usage: { ...metric.usage },
+            timing: { ...metric.timing },
+            cost: { ...metric.cost },
+        }));
+    }
+    /** Summed cost when every recorded turn has a known price, else undefined. */
+    knownCostUsd() {
+        return this.turnMetrics.length > 0 && this.turnMetrics.every((m) => m.cost.status === "known")
+            ? this.turnMetrics.reduce((sum, m) => sum + (m.cost.status === "known" ? m.cost.usd : 0), 0)
+            : undefined;
+    }
+    /** Drop everything — display-only history belongs to the OLD session. */
+    clear() {
+        this.kenTurns = [];
+        this.autopilotMarkers = [];
+        this.appMarkers = [];
+        this.turnMetrics = [];
+    }
+    /**
+     * Restore from a loaded session file. The leaf is passed so each marker also
+     * carries its FILE-order position, the fallback used when a legacy anchor is
+     * out of range (see RecordedPosition).
+     */
+    restore(entries, leafId) {
+        const sessionManager = this.getSessionManager();
+        this.kenTurns = sessionManager.getKenTurns(entries, leafId);
+        this.autopilotMarkers = sessionManager.getAutopilotMarkers(entries, leafId);
+        this.appMarkers = sessionManager.getAppMarkers(entries, leafId);
+        this.turnMetrics = sessionManager.getTurnMetrics(entries);
+    }
+    /**
+     * Rebase every transcript anchor (Ken turns, autopilot verdicts, app markers)
+     * onto a freshly compacted message list.
+     */
+    remapAnchors(remap) {
+        if (!remap)
+            return;
+        const move = (payload) => ({
+            ...payload,
+            afterMessageCount: remapAnchorForCompaction(payload.afterMessageCount, remap),
+        });
+        this.kenTurns = this.kenTurns.map(move);
+        this.autopilotMarkers = this.autopilotMarkers.map(move);
+        this.appMarkers = this.appMarkers.map(move);
+    }
+    async recordKenTurn(question, reply, afterMessageCount) {
+        const payload = { version: 1, question, reply, afterMessageCount };
+        this.kenTurns.push(payload);
+        await this.append(KEN_TURN_CUSTOM_KIND, payload);
+    }
+    async recordAutopilotMarker(phase, extra, afterMessageCount) {
+        const payload = {
+            version: 1,
+            phase,
+            afterMessageCount,
+            ...(extra?.reason !== undefined ? { reason: extra.reason } : {}),
+            ...(extra?.body !== undefined ? { body: extra.body } : {}),
+        };
+        this.autopilotMarkers.push(payload);
+        await this.append(AUTOPILOT_MARKER_CUSTOM_KIND, payload);
+    }
+    async recordAppMarker(kind, data, afterMessageCount) {
+        const payload = { version: 1, kind, afterMessageCount, data };
+        this.appMarkers.push(payload);
+        await this.append(APP_MARKER_CUSTOM_KIND, payload);
+    }
+    /** Keep a turn metric in memory; {@link persistTurnMetric} writes it. */
+    addTurnMetric(payload) {
+        this.turnMetrics.push(payload);
+    }
+    async persistTurnMetric(payload) {
+        const sessionPath = this.getSessionPath();
+        if (sessionPath)
+            await this.getSessionManager().appendTurnMetric(sessionPath, payload);
+    }
+    /**
+     * Re-append everything to the current session file. Called after a
+     * continuation/compaction file is created so display-only history isn't lost
+     * when the session is rewritten (those rewrites only re-persist messages).
+     * Each marker keeps its original `afterMessageCount` anchor.
+     */
+    async rePersistAll() {
+        await this.rePersistTurnMetrics();
+        await this.rePersist(KEN_TURN_CUSTOM_KIND, this.kenTurns);
+        await this.rePersist(AUTOPILOT_MARKER_CUSTOM_KIND, this.autopilotMarkers);
+        await this.rePersist(APP_MARKER_CUSTOM_KIND, this.appMarkers);
+    }
+    async rePersistTurnMetrics() {
+        if (!this.getSessionPath())
+            return;
+        for (const metric of this.turnMetrics) {
+            await this.getSessionManager().appendTurnMetric(this.getSessionPath(), metric);
+        }
+    }
+    async rePersist(kind, payloads) {
+        if (!this.getSessionPath())
+            return;
+        for (const payload of payloads) {
+            const entry = {
+                type: "custom",
+                kind,
+                id: crypto.randomUUID(),
+                parentId: null,
+                timestamp: new Date().toISOString(),
+                data: stripRecordedPosition(payload),
+            };
+            await this.getSessionManager().appendEntry(this.getSessionPath(), entry);
+        }
+    }
+    async append(kind, payload) {
+        const sessionPath = this.getSessionPath();
+        if (!sessionPath)
+            return;
+        const entry = {
+            type: "custom",
+            kind,
+            id: crypto.randomUUID(),
+            parentId: null,
+            timestamp: new Date().toISOString(),
+            data: payload,
+        };
+        await this.getSessionManager().appendEntry(sessionPath, entry);
+    }
+}
+//# sourceMappingURL=transcript-markers.js.map