@bastani/atomic 0.8.26-alpha.6 → 0.8.26-alpha.7

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

@@ -15,7 +15,7 @@
 import type { Agent, AgentEvent, AgentMessage, AgentState, AgentTool, ThinkingLevel } from "@earendil-works/pi-agent-core";
 import type { Api, ImageContent, Model, TextContent } from "@earendil-works/pi-ai";
 import { type BashResult } from "./bash-executor.ts";
-import { type CompactionResult } from "./compaction/index.ts";
+import { type CompactionResult, type ContextCompactionResult } from "./compaction/index.ts";
 import { type ContextUsage, type ExtensionCommandContextActions, type ExtensionErrorListener, ExtensionRunner, type ExtensionUIContext, type InputSource, type OrchestrationContext, type ReplacedSessionContext, type SendMessageOptions, type SessionStartEvent, type ShutdownHandler, type ToolDefinition, type ToolInfo } from "./extensions/index.ts";
 import type { CustomMessage } from "./messages.ts";
 import type { ModelRegistry } from "./model-registry.ts";
@@ -44,6 +44,9 @@ export type AgentSessionEvent = AgentEvent | {
 } | {
     type: "compaction_start";
     reason: "manual" | "threshold" | "overflow";
+} | {
+    type: "context_compaction_start";
+    reason: "manual";
 } | {
     type: "session_info_changed";
     name: string | undefined;
@@ -62,6 +65,13 @@ export type AgentSessionEvent = AgentEvent | {
     aborted: boolean;
     willRetry: boolean;
     errorMessage?: string;
+} | {
+    type: "context_compaction_end";
+    reason: "manual";
+    result: ContextCompactionResult | undefined;
+    aborted: boolean;
+    willRetry: false;
+    errorMessage?: string;
 } | {
     type: "auto_retry_start";
     attempt: number;
@@ -479,6 +489,11 @@ export declare class AgentSession {
      * @param customInstructions Optional instructions for the compaction summary
      */
     compact(customInstructions?: string): Promise<CompactionResult>;
+    /**
+     * Manually compact the session context by applying validated logical deletions.
+     * Retained transcript entries/content blocks stay verbatim; no user prompt text is accepted.
+     */
+    contextCompact(): Promise<ContextCompactionResult>;
     /**
      * Cancel in-progress compaction (manual or auto).
      */
@@ -488,6 +503,18 @@ export declare class AgentSession {
      */
     abortBranchSummary(): void;
     private _checkCompaction;
+    /**
+     * Internal: remove the trailing overflow error from retry context if it is still present.
+     */
+    private _dropTrailingOverflowAssistantErrorIfPresent;
+    /**
+     * Internal: schedule a live post-event continuation probe after compaction_end listeners can flush queues.
+     */
+    private _schedulePostAutoCompactionContinuationProbe;
+    /**
+     * Internal: resume generation after successful auto-compaction only when active work remains.
+     */
+    private _resumeAfterAutoCompaction;
     private _runAutoCompaction;
     /**
      * Toggle auto-compaction setting.