@bubblebrain-ai/bubble 0.0.58 → 0.0.60

package/dist/agent.d.ts

@@ -1,7 +1,4 @@
-/**
- * Agent - The core decision loop.
- * It maintains message state, calls the LLM, executes tools, and auto-continues.
- */
+import { type ContextCheckpoint } from "./context/checkpoint.js";
 import { type ContextUsageSnapshot } from "./context/usage.js";
 import type { AgentEvent, AgentInputController, ContentPart, PermissionMode, Message, Provider, ThinkingLevel, ToolResult, ToolRegistryEntry, ToolUpdate } from "./types.js";
 import { type TurnHooks } from "./orchestrator/hooks.js";
@@ -65,6 +62,9 @@ export interface AgentOptions {
      * session-level summary entry would make resume skip earlier history.
      */
     onCompactionApplied?: (summary: string) => void;
+    /** Required durable commit hook for hosts; exceptions abort the context switch. */
+    onContextCheckpoint?: (checkpoint: ContextCheckpoint) => void;
+    getContextRevision?: () => string;
     hooks?: TurnHooks[];
     externalHooks?: ExternalHookController;
     agentRole?: "parent" | "subagent";
@@ -75,6 +75,8 @@ export interface AgentOptions {
         subAgentId?: string;
     };
     skills?: SkillSummary[];
+    /** Skill catalog budget in characters for rebuilt system prompts (0 = off). */
+    skillCatalogChars?: number;
     memoryPrompt?: string;
     fileStateTracker?: FileStateTracker;
     agentCategories?: AgentCategoriesConfig;
@@ -103,6 +105,8 @@ export interface AgentOptions {
 export interface AgentRunOptions {
     abortSignal?: AbortSignal;
     inputController?: AgentInputController;
+    /** Child follow-ups continue at a safe boundary, including a tool-free answer. */
+    continueOnPendingInput?: boolean;
     /** Local-only presentation metadata persisted with the submitted user turn. */
     userMessageUi?: Extract<Message, {
         role: "user";
@@ -159,6 +163,9 @@ export declare class Agent {
     private _modeVersion;
     private onModeUpdate?;
     private onCompactionApplied?;
+    private onContextCheckpoint?;
+    private getContextRevision?;
+    private lastCompactionId?;
     private onMessageAppend?;
     private onProviderError?;
     private onToolResult?;
@@ -171,6 +178,7 @@ export declare class Agent {
     private budgetLedger?;
     private budgetSource;
     private skillSummaries;
+    private skillCatalogChars?;
     private memoryPrompt?;
     private fileStateTracker?;
     private agentCategories;
@@ -193,6 +201,7 @@ export declare class Agent {
     private lastInputTokens;
     private lastAnchorMessageCount;
     private compactionStats;
+    private contextEvents;
     constructor(options: AgentOptions);
     /**
      * Re-inject the deferred-tools advertisement. Hosts that reassign
@@ -232,8 +241,10 @@ export declare class Agent {
     unlockDeferredTools(names: string[]): void;
     /** All deferred tools in this session (for tool_search to inspect). */
     listDeferredTools(): ToolRegistryEntry[];
-    getSystemPromptToolOptions(): Pick<import("./system-prompt.js").SystemPromptOptions, "tools" | "toolSnippets" | "guidelines" | "modelRoutingPrompt" | "memoryPrompt">;
-    /** Refresh the live Skill catalog after /skills reloads or changes enablement. */
+    getSystemPromptToolOptions(): Pick<import("./system-prompt.js").SystemPromptOptions, "tools" | "toolSnippets" | "guidelines" | "modelRoutingPrompt" | "memoryPrompt" | "skills" | "skillCatalogChars">;
+    getSkillSummaries(): SkillSummary[];
+    getSkillCatalogChars(): number | undefined;
+    /** Refresh the live Skill catalog after /skills reloads or changes enablement; hosts then rebuild the system prompt. */
     setSkillSummaries(skills: SkillSummary[]): void;
     /** Current routing menu (design §4); undefined when no accessor is wired. */
     buildModelRoutingPromptSection(): string | undefined;
@@ -308,6 +319,7 @@ export declare class Agent {
         resident: number;
         subturn: number;
         llm: number;
+        heuristic: number;
         overflow: number;
         fired: number;
         droppedMessages: number;
@@ -438,11 +450,8 @@ export declare class Agent {
     private createChildAgent;
     private forkMessagesForSubagent;
     private maybeCompactResidentHistory;
-    /**
-     * Hand a multi-turn compaction summary to the host for session persistence.
-     * Failure is swallowed: losing persistence must never break the run itself.
-     */
-    private persistCompactionSummary;
+    /** Persist conversational context first; keep live reminders outside the durable projection. */
+    private applyContextCheckpoint;
     private appendMessage;
     private persistProviderError;
     private recordProviderError;