@earendil-works/pi-coding-agent 0.80.2 → 0.80.5

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

@@ -21,7 +21,7 @@ import type { CustomMessage } from "./messages.ts";
 import type { ModelRegistry } from "./model-registry.ts";
 import { type PromptTemplate } from "./prompt-templates.ts";
 import type { ResourceLoader } from "./resource-loader.ts";
-import type { BranchSummaryEntry, SessionManager } from "./session-manager.ts";
+import type { BranchSummaryEntry, SessionEntry, SessionManager } from "./session-manager.ts";
 import type { SettingsManager } from "./settings-manager.ts";
 import { type BashOperations } from "./tools/bash.ts";
 /** Parsed skill block from a user message */
@@ -43,6 +43,8 @@ export type AgentSessionEvent = Exclude<AgentEvent, {
     type: "agent_end";
     messages: AgentMessage[];
     willRetry: boolean;
+} | {
+    type: "agent_settled";
 } | {
     type: "queue_update";
     steering: readonly string[];
@@ -50,6 +52,9 @@ export type AgentSessionEvent = Exclude<AgentEvent, {
 } | {
     type: "compaction_start";
     reason: "manual" | "threshold" | "overflow";
+} | {
+    type: "entry_appended";
+    entry: SessionEntry;
 } | {
     type: "session_info_changed";
     name: string | undefined;
@@ -87,7 +92,7 @@ export interface AgentSessionConfig {
         model: Model<any>;
         thinkingLevel?: ThinkingLevel;
     }>;
-    /** Resource loader for skills, prompts, themes, context files, system prompt */
+    /** Resource loader for extensions, skills, prompts, themes, context files, and system prompt */
     resourceLoader: ResourceLoader;
     /** SDK custom tools registered outside extensions */
     customTools?: ToolDefinition[];
@@ -167,6 +172,9 @@ export declare class AgentSession {
     private _scopedModels;
     private _unsubscribeAgent?;
     private _eventListeners;
+    private _isAgentRunActive;
+    private _idleWaitPromise;
+    private _resolveIdleWait;
     /** Tracks pending steering messages for UI display. Removed when delivered. */
     private _steeringMessages;
     /** Tracks pending follow-up messages for UI display. Removed when delivered. */
@@ -207,6 +215,7 @@ export declare class AgentSession {
     private _toolPromptGuidelines;
     private _baseSystemPrompt;
     private _baseSystemPromptOptions;
+    private _systemPromptOverride?;
     constructor(config: AgentSessionConfig);
     /** Model registry for API key resolution and model discovery */
     get modelRegistry(): ModelRegistry;
@@ -221,9 +230,13 @@ export declare class AgentSession {
      * happens here instead of in wrappers.
      */
     private _installAgentToolHooks;
+    private _installAgentNextTurnRefresh;
     /** Emit an event to all listeners */
     private _emit;
     private _emitQueueUpdate;
+    private _getIdleWaitPromise;
+    private _resolveIdleWaitIfIdle;
+    private _emitAgentSettled;
     private _lastAssistantMessage;
     /** Internal handler for agent events - shared by subscribe and reconnect */
     private _handleAgentEvent;
@@ -262,8 +275,10 @@ export declare class AgentSession {
     get model(): Model<any> | undefined;
     /** Current thinking level */
     get thinkingLevel(): ThinkingLevel;
-    /** Whether agent is currently streaming a response */
+    /** Whether the session is currently processing an agent run or post-run continuation. */
     get isStreaming(): boolean;
+    /** Whether the session has no active agent run, retry, auto-compaction, or queued continuation. */
+    get isIdle(): boolean;
     /** Current effective system prompt (includes any per-turn extension modifications) */
     get systemPrompt(): string;
     /** Current retry attempt (0 if not retrying) */
@@ -402,6 +417,7 @@ export declare class AgentSession {
      * Abort current operation and wait for agent to become idle.
      */
     abort(): Promise<void>;
+    waitForIdle(): Promise<void>;
     private _emitModelSelect;
     /**
      * Set model directly.
@@ -485,7 +501,6 @@ export declare class AgentSession {
     reload(options?: {
         beforeSessionStart?: () => void | Promise<void>;
     }): Promise<void>;
-    private _isNonRetryableProviderLimitError;
     /**
      * Check if an error is retryable (overloaded, rate limit, server errors).
      * Context overflow errors are NOT retryable (handled by compaction instead).
@@ -571,7 +586,9 @@ export declare class AgentSession {
     }>;
     private _extractUserMessageText;
     /**
-     * Get session statistics.
+     * Get session statistics. Aggregates over ALL session entries (including
+     * history that was compacted away), so token/cost totals reflect what was
+     * actually billed across the session.
      */
     getSessionStats(): SessionStats;
     getContextUsage(): ContextUsage | undefined;