agent-sh 0.14.7 → 0.14.9

package/dist/shell/strategies/bash.js

@@ -30,8 +30,12 @@ export const bashStrategy = {
             `PROMPT_COMMAND="\${PROMPT_COMMAND:+\$PROMPT_COMMAND;}__agent_sh_precmd"`,
             "",
             "# Preexec hook via DEBUG trap: emit actual command text so agent-sh",
-            "# can track history-recalled and tab-completed commands accurately",
-            "__agent_sh_preexec_ran=0",
+            "# can track history-recalled and tab-completed commands accurately.",
+            "# Start latched (=1) so the trap stays inert through the rest of",
+            "# rcfile sourcing — readline/history aren't loaded yet, and the case",
+            "# + bind statements below would otherwise fire a phantom preexec with",
+            "# an empty body. __agent_sh_precmd resets it to 0 before user input.",
+            "__agent_sh_preexec_ran=1",
             "__agent_sh_emit_preexec() {",
             '  [[ $__agent_sh_preexec_ran == 1 ]] && return',
             '  [[ -n $COMP_LINE ]] && return',

package/dist/shell/tui-renderer.js

@@ -408,11 +408,14 @@ export default function activate(ctx) {
     bus.on("ui:info", (e) => {
         stopCurrentSpinner();
         showInfo(e.message);
-        // Restart spinner if agent is still processing
+        bus.emit("input:redraw", {});
         if (s.renderer)
             startThinkingSpinner();
     });
-    bus.on("ui:error", (e) => showError(e.message));
+    bus.on("ui:error", (e) => {
+        showError(e.message);
+        bus.emit("input:redraw", {});
+    });
     bus.on("ui:suggestion", (e) => {
         compositor.surface("status").writeLine(`${p.dim}💡 ${e.text}${p.reset}`);
     });

package/dist/utils/diff-renderer.js

@@ -249,13 +249,15 @@ function renderUnifiedHunk(hunk, layout) {
     const out = [];
     const pairs = findChangePairs(hunk);
     const renderedAsPartOfPair = new Set();
+    const bgWidth = Math.max(1, textWidth - noW - 3);
+    const gutter = (n) => `${p.dim}${n} │${p.reset} `;
     for (let i = 0; i < hunk.lines.length; i++) {
         const line = hunk.lines[i];
         const no = String(line.type === "removed" ? (line.oldNo ?? "") : (line.newNo ?? line.oldNo ?? "")).padStart(noW);
         if (line.type === "context") {
             const raw = truncateText(line.text, lineTextW);
             const text = lang ? highlightLine(raw, lang) : raw;
-            out.push(`  ${p.dim}${no} │${p.reset} ${p.dim}${text}${p.reset}`);
+            out.push(`${gutter(no)}  ${p.dim}${text}${p.reset}`);
             continue;
         }
         if (line.type === "removed") {
@@ -275,17 +277,17 @@ function renderUnifiedHunk(hunk, layout) {
                 removedText = lang ? highlightLine(raw, lang) : raw;
             }
             if (useTrueColor) {
-                out.push(padToWidth(`${p.errorBg}${p.error}- ${no} │ ${preserveBg(removedText, p.errorBg)}`, textWidth) + p.reset);
+                out.push(gutter(no) + padToWidth(`${p.errorBg}${p.error}- ${preserveBg(removedText, p.errorBg)}`, bgWidth) + p.reset);
             }
             else {
-                out.push(`${p.error}- ${no} │ ${removedText}${p.reset}`);
+                out.push(`${gutter(no)}${p.error}- ${removedText}${p.reset}`);
             }
             if (addedText !== null && addedNo !== null) {
                 if (useTrueColor) {
-                    out.push(padToWidth(`${p.successBg}${p.success}+ ${addedNo} │ ${preserveBg(addedText, p.successBg)}`, textWidth) + p.reset);
+                    out.push(gutter(addedNo) + padToWidth(`${p.successBg}${p.success}+ ${preserveBg(addedText, p.successBg)}`, bgWidth) + p.reset);
                 }
                 else {
-                    out.push(`${p.success}+ ${addedNo} │ ${addedText}${p.reset}`);
+                    out.push(`${gutter(addedNo)}${p.success}+ ${addedText}${p.reset}`);
                 }
             }
             continue;
@@ -296,10 +298,10 @@ function renderUnifiedHunk(hunk, layout) {
             const raw = truncateText(line.text, lineTextW);
             const text = lang ? highlightLine(raw, lang) : raw;
             if (useTrueColor) {
-                out.push(padToWidth(`${p.successBg}${p.success}+ ${no} │ ${preserveBg(text, p.successBg)}`, textWidth) + p.reset);
+                out.push(gutter(no) + padToWidth(`${p.successBg}${p.success}+ ${preserveBg(text, p.successBg)}`, bgWidth) + p.reset);
             }
             else {
-                out.push(`${p.success}+ ${no} │ ${text}${p.reset}`);
+                out.push(`${gutter(no)}${p.success}+ ${text}${p.reset}`);
             }
         }
     }

package/examples/extensions/ash-acp-bridge/src/index.ts

@@ -11,7 +11,7 @@
  * In agent-shell (Emacs):
  *   (setq agent-shell-agentsh-acp-command '("agent-sh-acp"))
  */
-import { createCore, NoopHistory, type AgentShellCore } from "agent-sh";
+import { createCore, type AgentShellCore } from "agent-sh";
 import { loadExtensions } from "agent-sh/extension-loader";
 import { loadBuiltinExtensions } from "agent-sh/extensions";
 import { activateAgent } from "agent-sh/agent";
@@ -486,7 +486,6 @@ async function handleSessionNew(id: number | string, params: Record<string, unkn
     core = createCore({
       model: cliArgs.model,
       provider: cliArgs.provider,
-      history: new NoopHistory(),
     });
     wireEvents(core);
 

package/examples/extensions/ashi/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guanyilun/ashi",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Ash in an interactive TUI — agent-sh's built-in agent without the shell underneath",
   "type": "module",
   "main": "dist/cli.js",
@@ -56,7 +56,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-tui": "^0.74.0",
-    "agent-sh": "^0.14.0",
+    "agent-sh": "^0.14.8",
     "chalk": "^5.5.0",
     "cli-highlight": "^2.1.11"
   },

package/examples/extensions/ashi/src/capture.ts

@@ -1,6 +1,6 @@
 import type { ExtensionContext } from "agent-sh/types";
 import type { MultiSessionStore } from "./multi-session-store.js";
-import type { AgentMessage } from "./session-store.js";
+import type { AgentShMessage as AgentMessage } from "agent-sh/session-store";
 
 /** Maintains an `(entryId | null)[]` parallel to the live messages array;
  *  null slots are synthetics like compaction summaries that have no entry. */

package/examples/extensions/ashi/src/cli.ts

@@ -2,7 +2,7 @@
 /**
  * ashi — ash (agent-sh's built-in agent) in an interactive TUI.
  */
-import { createCore, NoopHistory } from "agent-sh/core";
+import { createCore } from "agent-sh/core";
 import { loadBuiltinExtensions } from "agent-sh/extensions";
 import { loadExtensions } from "agent-sh/extension-loader";
 import { activateAgent } from "agent-sh/agent";
@@ -134,7 +134,7 @@ async function main(): Promise<void> {
   const store = new MultiSessionStore(sessionsDir, cwd, { resumeSessionId: resumeId });
   const getStore = (): MultiSessionStore => store;
 
-  const core = createCore({ ...config, history: new NoopHistory() });
+  const core = createCore(config);
 
   let stopFrontend: (() => void) | null = null;
 
@@ -153,7 +153,7 @@ async function main(): Promise<void> {
 
   activateAgent(ctx);
   activateShellContext(ctx);
-  await loadBuiltinExtensions(ctx);
+  await loadBuiltinExtensions(ctx, ["rolling-history"]);
 
   const shell = new Shell({
     bus: core.bus,
@@ -183,7 +183,6 @@ async function main(): Promise<void> {
   registerRenderDefaults(ctx);
   registerDefaultSchemaRenderers(ctx);
 
-  ctx.advise("conversation:format-prior-history", () => null);
   ctx.advise("system-prompt:build", (next) => `${next()}\n\n<cwd>${process.cwd()}</cwd>`);
 
   const handle = mountAshi(ctx, getStore, capture);

package/examples/extensions/ashi/src/compaction.ts

@@ -1,7 +1,7 @@
 import type { ExtensionContext } from "agent-sh/types";
 import type { MultiSessionStore } from "./multi-session-store.js";
 import type { Capture } from "./capture.js";
-import type { AgentMessage } from "./session-store.js";
+import type { AgentShMessage as AgentMessage } from "agent-sh/session-store";
 
 const KEEP_RECENT_TOKEN_BUDGET = 20_000;
 const FORCE_KEEP_RECENT_TOKEN_BUDGET = 4_000;
@@ -81,6 +81,10 @@ export function isSafeCutPoint(messages: AgentMessage[], idx: number): boolean {
 export function estimateMessageTokens(m: AgentMessage): number {
   let chars = 0;
   if (typeof m.content === "string") chars += m.content.length;
-  if (m.tool_calls) for (const t of m.tool_calls) chars += (t.function?.arguments?.length ?? 0);
+  if (m.role === "assistant" && m.tool_calls) {
+    for (const t of m.tool_calls) {
+      if (t.type === "function") chars += t.function.arguments.length;
+    }
+  }
   return Math.ceil(chars * APPROX_TOKENS_PER_CHAR) + 20;
 }

package/examples/extensions/ashi/src/frontend.ts

@@ -28,6 +28,7 @@ import type { ToolCallView, ToolResultView } from "./hooks.js";
 import { createToolHookResolver } from "./hooks.js";
 import { loadGroupMaxVisible } from "./display-config.js";
 import { classifySubmit, deriveChangeHandlerResult } from "./shell-mode.js";
+import { UserShellIntents } from "./user-shell-intents.js";
 
 const GROUPABLE_KINDS = new Set(["read", "search"]);
 const TOOL_KIND: Record<string, string> = {
@@ -37,7 +38,7 @@ const TOOL_KIND: Record<string, string> = {
 import { BusAutocompleteProvider } from "./autocomplete.js";
 import { StatusFooter } from "./status-footer.js";
 import type { MultiSessionStore } from "./multi-session-store.js";
-import { stripContextWrappers, type SessionEntry } from "./session-store.js";
+import { stripContextWrappers, type SessionEntry } from "agent-sh/session-store";
 import { formatSessionRow } from "./session-commands.js";
 import { resumeSession } from "./session-commands.js";
 import { applyBranchMessages } from "./commands.js";
@@ -300,8 +301,7 @@ export function mountAshi(
   let processing = false;
   const queuedQueries: string[] = [];
   const queuedShellLines: { line: string; private: boolean }[] = [];
-  /** FIFO matching pty-writes to their shell:command-start events. */
-  const pendingUserBlockPrivacy: boolean[] = [];
+  const pendingUserShell = new UserShellIntents();
 
   const renderQueueSlot = (): void => {
     queueSlot.clear();
@@ -325,7 +325,7 @@ export function mountAshi(
       tui.requestRender();
       return;
     }
-    pendingUserBlockPrivacy.push(!!opts?.private);
+    pendingUserShell.push({ private: !!opts?.private });
     if (opts?.private) bus.emit("shell:user-exec-exclude-next", {});
     bus.emit("shell:pty-write", { data: line + "\n" });
   };
@@ -442,21 +442,22 @@ export function mountAshi(
       }
       if (m.tool_calls) {
         for (const tc of m.tool_calls) {
+          if (tc.type !== "function") continue;
           const id = tc.id ?? "";
-          const name = tc.function?.name ?? "tool";
+          const name = tc.function.name ?? "tool";
           const kind = TOOL_KIND[name];
           if (kind && GROUPABLE_KINDS.has(kind)) {
             const mergeable = findMergeableGroup(kind);
             const group = mergeable
               ?? (() => { const g = new ToolGroup(kind, groupMaxVisible); chat.addChild(g); return g; })();
-            group.addCall(id, name, detailFromArgs(tc.function?.arguments));
+            group.addCall(id, name, detailFromArgs(tc.function.arguments));
             if (id) toolMap.set(id, { kind: "group", group, name });
             continue;
           }
           const pair = renderToolPair({
             toolCallId: id, name, title: name, kind: undefined,
-            displayDetail: detailFromArgs(tc.function?.arguments),
-            rawInput: tc.function?.arguments,
+            displayDetail: detailFromArgs(tc.function.arguments),
+            rawInput: tc.function.arguments,
           });
           chat.addChild(pair.call);
           chat.addChild(pair.result);
@@ -636,9 +637,11 @@ export function mountAshi(
   let activeUserShell: { pair: ToolPair; command: string; isPrivate: boolean } | null = null;
   bus.on("shell:command-start", ({ command }) => {
     if (agentShellActive) return;
+    const intent = pendingUserShell.consume();
+    if (!intent) return;
     finalizeThinking();
     if (activeAssistant) { activeAssistant.finalize(); activeAssistant = null; }
-    const isPrivate = pendingUserBlockPrivacy.shift() ?? false;
+    const isPrivate = intent.private;
     const name = isPrivate ? "user_bash_private" : "user_bash";
     const pair = renderToolPair({
       toolCallId: `user-shell-${Date.now()}`, name, title: name,
@@ -678,7 +681,7 @@ export function mountAshi(
     // Shell queue drains first so its output lands in the next turn's <shell_events>.
     while (queuedShellLines.length > 0) {
       const item = queuedShellLines.shift()!;
-      pendingUserBlockPrivacy.push(item.private);
+      pendingUserShell.push({ private: item.private });
       if (item.private) bus.emit("shell:user-exec-exclude-next", {});
       bus.emit("shell:pty-write", { data: item.line + "\n" });
     }

package/examples/extensions/ashi/src/multi-session-store.ts

@@ -1,7 +1,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import * as crypto from "node:crypto";
-import { SessionStore, type AgentMessage } from "./session-store.js";
+import { SessionStore, type AgentShMessage as AgentMessage } from "agent-sh/session-store";
 
 export interface SessionInfo {
   id: string;
@@ -55,13 +55,10 @@ export class MultiSessionStore {
       for (const name of names) {
         if (!name.endsWith(".jsonl")) continue;
         const id = name.slice(0, -".jsonl".length);
-        try {
-          const raw = fs.readFileSync(path.join(dir, `${id}.jsonl.meta`), "utf-8");
-          const meta = JSON.parse(raw) as { createdAt?: number };
-          if (typeof meta.createdAt === "number" && (!best || meta.createdAt > best.createdAt)) {
-            best = { id, createdAt: meta.createdAt };
-          }
-        } catch { /* skip unreadable meta */ }
+        const createdAt = readHeaderTimestamp(path.join(dir, name));
+        if (createdAt !== null && (!best || createdAt > best.createdAt)) {
+          best = { id, createdAt };
+        }
       }
       if (best) return best.id;
     }
@@ -69,6 +66,21 @@ export class MultiSessionStore {
     return undefined;
   }
 
+  setName(id: string, name: string): void {
+    fs.writeFileSync(this.metaFile(id), JSON.stringify({ name }));
+  }
+
+  private readName(id: string): string | undefined {
+    try {
+      const m = JSON.parse(fs.readFileSync(this.metaFile(id), "utf-8")) as { name?: string };
+      return typeof m.name === "string" ? m.name : undefined;
+    } catch { return undefined; }
+  }
+
+  private metaFile(id: string): string {
+    return path.join(this.dir, `${id}.jsonl.meta`);
+  }
+
   /** One-time import from the previous storage format (sessions stored as
    *  directories with tree.jsonl + snapshots/). Each old session is replayed
    *  from its most recent snapshot into a new flat `.jsonl` file, then the
@@ -140,12 +152,12 @@ export class MultiSessionStore {
       const filePath = path.join(this.dir, name);
       try {
         const store = new SessionStore(filePath);
-        const meta = store.getMeta();
+        const root = store.getEntry(store.getRootId());
         result.push({
           id,
           filePath,
-          createdAt: meta.createdAt,
-          name: meta.name,
+          createdAt: root?.timestamp ?? 0,
+          name: this.readName(id),
           preview: store.getPreview(),
           entryCount: store.getAllEntries().length,
         });
@@ -172,6 +184,17 @@ function newSessionFileId(): string {
   return `${ts}_${suffix}`;
 }
 
+function readHeaderTimestamp(filePath: string): number | null {
+  try {
+    const raw = fs.readFileSync(filePath, "utf-8");
+    const nl = raw.indexOf("\n");
+    const firstLine = nl < 0 ? raw : raw.slice(0, nl);
+    const e = JSON.parse(firstLine) as { type?: string; timestamp?: number };
+    if (e.type === "session" && typeof e.timestamp === "number") return e.timestamp;
+  } catch { /* unreadable */ }
+  return null;
+}
+
 function writeImportedSession(
   newFile: string,
   id: string,
@@ -191,5 +214,5 @@ function writeImportedSession(
   }
   fs.writeFileSync(newFile, lines.join("\n") + "\n");
   fs.writeFileSync(newFile + ".leaf", parent);
-  fs.writeFileSync(newFile + ".meta", JSON.stringify({ createdAt: ts, ...(name ? { name } : {}) }));
+  if (name) fs.writeFileSync(newFile + ".meta", JSON.stringify({ name }));
 }

package/examples/extensions/ashi/src/session-commands.ts

@@ -35,7 +35,7 @@ export function registerSessionCommands(
       bus.emit("ui:error", { message: "name: expected a name" });
       return;
     }
-    getStore().current().setName(name);
+    getStore().setName(getStore().current().id, name);
     bus.emit("ui:info", { message: `session named: ${name}` });
   });
 

package/examples/extensions/ashi/src/user-shell-intents.ts

@@ -0,0 +1,17 @@
+/** Pending intents for ashi-issued shell pty-writes. shell:command-start fires
+ *  for any OSC 9997 — orphans (bash DEBUG-trap noise) are dropped on consume. */
+export interface UserShellIntent {
+  private: boolean;
+}
+
+export class UserShellIntents {
+  private q: UserShellIntent[] = [];
+
+  push(intent: UserShellIntent): void {
+    this.q.push(intent);
+  }
+
+  consume(): UserShellIntent | null {
+    return this.q.shift() ?? null;
+  }
+}

package/examples/extensions/ollama.ts

@@ -3,7 +3,6 @@
  * `agent-sh auth login ollama-cloud` or OLLAMA_API_KEY). Local host
  * overridable via OLLAMA_HOST.
  */
-import { resolveApiKey } from "agent-sh/auth";
 import type { AgentContext } from "agent-sh/types";
 
 const ECHO_REASONING_PATTERNS: RegExp[] = [/deepseek/i];
@@ -14,7 +13,9 @@ function reasoningParams(level: string): Record<string, unknown> {
 }
 
 export default function activate(ctx: AgentContext): void {
-  const cloudKey = resolveApiKey("ollama-cloud").key ?? process.env.OLLAMA_API_KEY;
+  const cloudKey =
+    (ctx.call("provider:resolve-api-key", "ollama-cloud") as { key: string | null }).key ??
+    process.env.OLLAMA_API_KEY;
   const cloudHost = "https://ollama.com";
   const cloudBaseURL = `${cloudHost}/v1`;
   ctx.agent.providers.configure("ollama-cloud", { reasoningParams });

package/examples/extensions/opencode-provider.ts

@@ -31,7 +31,6 @@
  */
 
 import type { AgentContext } from "agent-sh/types";
-import { resolveApiKey } from "agent-sh/auth";
 
 // ── Constants ──────────────────────────────────────────────────────
 
@@ -180,7 +179,7 @@ function buildReasoningParams(level: string): Record<string, unknown> {
 export default function activate(ctx: AgentContext): void {
   const apiKey =
     process.env.OPENCODE_API_KEY ??
-    resolveApiKey("opencode").key ?? undefined;
+    (ctx.call("provider:resolve-api-key", "opencode") as { key: string | null }).key ?? undefined;
 
   // ── Phase 1: register both providers synchronously with fallback models ──
 

package/examples/extensions/zai-coding-plan.ts

@@ -4,7 +4,6 @@
  * Auth:  agent-sh auth login zai-coding-plan
  * Usage: agent-sh -e ./examples/extensions/zai-coding-plan.ts
  */
-import { resolveApiKey } from "agent-sh/auth";
 import type { AgentContext } from "agent-sh/types";
 
 const BASE_URL = "https://api.z.ai/api/coding/paas/v4";
@@ -24,7 +23,7 @@ function buildReasoningParams(level: string, _model?: string): Record<string, un
 }
 
 export default function activate(ctx: AgentContext): void {
-  const { key } = resolveApiKey(ID);
+  const { key } = ctx.call("provider:resolve-api-key", ID) as { key: string | null };
   ctx.agent.providers.configure(ID, { reasoningParams: buildReasoningParams });
   ctx.agent.providers.register({
     id: ID,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-sh",
-  "version": "0.14.7",
+  "version": "0.14.9",
   "description": "A shell-first terminal where AI is one keystroke away",
   "type": "module",
   "workspaces": [
@@ -73,6 +73,18 @@
       "types": "./dist/agent/types.d.ts",
       "default": "./dist/agent/types.js"
     },
+    "./store": {
+      "types": "./dist/agent/store.d.ts",
+      "default": "./dist/agent/store.js"
+    },
+    "./session-store": {
+      "types": "./dist/agent/session-store.d.ts",
+      "default": "./dist/agent/session-store.js"
+    },
+    "./entry-format": {
+      "types": "./dist/agent/entry-format.d.ts",
+      "default": "./dist/agent/entry-format.js"
+    },
     "./agent/subagent": {
       "types": "./dist/agent/subagent.d.ts",
       "default": "./dist/agent/subagent.js"

package/dist/agent/conversation-state.d.ts

@@ -1,142 +0,0 @@
-import type { ChatCompletionMessageParam } from "./llm-client.js";
-import type { ImageContent } from "./types.js";
-import { type NuclearEntry } from "./nuclear-form.js";
-import type { HandlerFunctions } from "../utils/handler-registry.js";
-/** Search hit shape returned by the `history:search` handler. */
-export interface HistoryHit {
-    entry: NuclearEntry;
-    line: string;
-}
-export interface CompactResult {
-    before: number;
-    after: number;
-    evictedCount: number;
-    [extra: string]: unknown;
-}
-/**
- * Conversation state with eager nucleation — shell-history shaped.
- *
- * Every add nucleates into a one-line NuclearEntry and flushes to disk.
- * Compaction evicts turns, replacing them with their nuclear one-liners
- * in context; the originals stay searchable via `conversation_recall`
- * and survive restarts in `~/.agent-sh/history`.
- *
- * Nucleation and history I/O go through advisable handlers — extensions
- * swap strategies without touching this class. When no handlers are
- * provided (subagents, tests), both become no-ops and this becomes a
- * plain message buffer.
- */
-export declare class ConversationState {
-    private messages;
-    private messagesDirty;
-    private cachedMessagesJson;
-    private toolErrors;
-    private nuclearEntries;
-    private nuclearBySeq;
-    private recallArchive;
-    readonly instanceId: string;
-    private readonly handlers;
-    private nextSeq;
-    private lastApiTokenCount;
-    private lastApiMessageCount;
-    private pendingMessages;
-    constructor(handlers?: HandlerFunctions, instanceId?: string);
-    /** Get JSON.stringify of messages, cached until next mutation. */
-    private getMessagesJson;
-    private invalidateMessagesCache;
-    addUserMessage(text: string): void;
-    addAssistantMessage(content: string | null, toolCalls?: {
-        id: string;
-        function: {
-            name: string;
-            arguments: string;
-        };
-    }[], extras?: Record<string, unknown>): void;
-    addToolResult(toolCallId: string, content: string | ImageContent[], isError?: boolean): void;
-    /** Add tool results as a user message (for inline tool protocol). */
-    addToolResultInline(content: string): void;
-    /** Safe from any context: queues if mid-tool-pair, appends otherwise. */
-    addSystemNote(text: string): void;
-    appendUserMessage(text: string): void;
-    private hasOpenToolCalls;
-    private flushPendingMessages;
-    getMessages(): ChatCompletionMessageParam[];
-    /** Drop tool messages with no matching preceding tool_call — strict
-     *  providers (DeepSeek) 400, and compaction can leave such orphans. */
-    private dropOrphanToolMessages;
-    /**
-     * If a stream was interrupted mid-tool-execution, an assistant message
-     * with tool_calls can land in history without matching tool results.
-     * Strict providers (DeepSeek) 400 on this. Stub each missing result
-     * with a [cancelled] marker so the protocol stays valid.
-     */
-    private stubDanglingToolCalls;
-    /**
-     * DeepSeek 400s if any assistant in a thinking-mode conversation is
-     * missing reasoning_content. Cross-alias here (OpenRouter streams as
-     * `reasoning`, DeepSeek input expects `reasoning_content`) and stub
-     * gaps (text-only turns, pre-fix messages) with empty string.
-     */
-    private normalizeReasoningConsistency;
-    /**
-     * Replace the messages array wholesale — the write side for custom
-     * compaction strategies. Invalidates API token baseline since the
-     * new array's token count is unknown.
-     */
-    replaceMessages(messages: ChatCompletionMessageParam[]): void;
-    private pruneToolErrors;
-    private eagerNucleateUser;
-    /** Nucleate an agent text response. Called by agent-loop when the loop finishes without tool calls. */
-    eagerNucleateAgent(text: string): void;
-    /** Nucleate tool call results. One entry per tool call, enriched with result. */
-    eagerNucleateTools(results: Array<{
-        toolName: string;
-        args: Record<string, unknown>;
-        content: string | ImageContent[];
-        isError: boolean;
-    }>): void;
-    /** Track an entry in memory (nuclear list + recall archive). */
-    private recordNuclearEntry;
-    private appendToHistory;
-    /** Bump and return the global sequence counter. For extensions that
-     *  synthesize their own NuclearEntries (e.g. compaction summaries that
-     *  should land in the same sequence space as kernel-produced entries). */
-    allocateSeq(): number;
-    /** Clear nuclear bookkeeping and reset the seq counter. For extensions
-     *  that swap sessions (multi-session history adapters) so the in-memory
-     *  nuclear list, recall archive, and seq counter don't carry over from
-     *  the previous session's tree. */
-    resetForSession(nextSeq: number): void;
-    updateApiTokenCount(promptTokens: number): void;
-    estimatePromptTokens(): number;
-    estimateTokens(): number;
-    /**
-     * Two-tier pin compaction: evict lowest-priority turns (replaced by
-     * their nuclear one-liners), slim the window before the last verbatim
-     * turn, drop read-only tool results entirely. Extensions replace the
-     * whole strategy by advising `conversation:compact` and skipping next.
-     */
-    compact(maxPromptTokens: number, recentTurnsToKeep?: number, force?: boolean): CompactResult | null;
-    /**
-     * Inject prior session history as a context preamble. The preamble
-     * layout goes through the `conversation:format-prior-history` handler,
-     * so extensions can swap the flat list for grouped/richer rendering.
-     */
-    loadPriorHistory(entries: NuclearEntry[]): void;
-    search(query: string): Promise<string>;
-    expand(seq: number): Promise<string>;
-    browse(): Promise<string>;
-    getNuclearEntries(): readonly NuclearEntry[];
-    getNuclearEntryCount(): number;
-    getNuclearSummary(): string | null;
-    getRecallArchiveSize(): number;
-    clear(): void;
-    private buildNuclearBlock;
-    /** Index of the nuclear block in messages[], or -1 if not present. */
-    private nuclearBlockIdx;
-    private updateNuclearBlockInMessages;
-    private slimTurn;
-    private parseTurns;
-    private inferPriority;
-    private turnToText;
-}