@ashx-j/lunr 0.2.26 → 0.2.28

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

@@ -1,17 +1,4 @@
-/**
- * AgentSession - Core abstraction for agent lifecycle and session management.
- *
- * This class is shared between all run modes (interactive, print, rpc).
- * It encapsulates:
- * - Agent state access
- * - Event subscription with automatic session persistence
- * - Model and thinking level management
- * - Compaction (manual and auto)
- * - Bash execution
- * - Session switching and branching
- *
- * Modes use this class and add their own I/O layer on top.
- */
+import { type UsageTotals } from "./usage-accounting.ts";
 import type { Agent, AgentEvent, AgentMessage, AgentState, AgentTool, ThinkingLevel } from "@ashx-j/lunr-agent";
 import type { ImageContent, Model, TextContent } from "@ashx-j/lunr-ai/compat";
 import { type BashResult } from "./bash-executor.ts";
@@ -20,6 +7,7 @@ import { type ContextUsage, type ExtensionCommandContextActions, type ExtensionE
 import type { InlineExtension } from "./extensions/types.ts";
 import type { CustomMessage } from "./messages.ts";
 import type { ModelRuntime } from "./model-runtime.ts";
+import { type PermissionMode } from "./permissions.ts";
 import { type PromptTemplate } from "./prompt-templates.ts";
 import type { ResourceLoader } from "./resource-loader.ts";
 import type { BranchSummaryEntry, SessionEntry, SessionManager } from "./session-manager.ts";
@@ -89,6 +77,8 @@ export type AgentSessionEvent = Exclude<AgentEvent, {
 /** Listener function for agent session events */
 export type AgentSessionEventListener = (event: AgentSessionEvent) => void;
 export interface AgentSessionConfig {
+    /** Explicit permission override; otherwise child inheritance, checkpoint, then settings. */
+    permissionMode?: PermissionMode;
     agent: Agent;
     sessionManager: SessionManager;
     settingsManager: SettingsManager;
@@ -175,6 +165,10 @@ export interface SessionStats {
     };
     cost: number;
     contextUsage?: ContextUsage;
+    /** Parent includes auxiliary requests; children and combined are cumulative receipts. */
+    parentUsage?: UsageTotals;
+    childUsage?: UsageTotals;
+    combinedUsage?: UsageTotals;
 }
 export interface ToolCallGateResult {
     block: boolean;
@@ -209,7 +203,12 @@ export declare class AgentSession {
     private _branchSummaryAbortController;
     private _retryAbortController;
     private _retryAttempt;
-    private _bashAbortController;
+    private _bashOperations;
+    private _operations;
+    private _closing;
+    private _disposed;
+    private _drainPromise?;
+    private _shutdownPromise?;
     private _pendingBashMessages;
     private _extensionRunner;
     private _turnIndex;
@@ -298,7 +297,16 @@ export declare class AgentSession {
     private transferring;
     setTransferring(value: boolean): void;
     private assertCanStartWork;
+    /** Stop admission synchronously, retaining listeners and session ownership. */
+    stopAdmission(): void;
+    private _trackOperation;
+    /** Cancel owned work and wait for final persistence before extension shutdown. */
+    drain(): Promise<void>;
+    /** Await cancellation and persistence, then release listeners and ownership. */
+    shutdown(): Promise<void>;
+    /** Compatibility wrapper. Use await shutdown() when release must be complete. */
     dispose(): void;
+    private _disposeSettled;
     /** Full agent state */
     get state(): AgentState;
     /** Current model (may be undefined if not yet selected) */
@@ -324,6 +332,10 @@ export declare class AgentSession {
      * prompt. Applied on top of the base prompt and any per-turn extension override.
      */
     setSystemPromptAppend(text: string | undefined): void;
+    get permissionMode(): PermissionMode;
+    private _permissionAddendum;
+    /** Update the same permission context consulted by headless and interactive tools. */
+    setPermissionMode(mode: PermissionMode): void;
     private _withSystemPromptAppend;
     /** Current retry attempt (0 if not retrying) */
     get retryAttempt(): number;
@@ -379,6 +391,8 @@ export declare class AgentSession {
     private _registerSubagentWaitInterruption;
     private _interruptSubagentWaits;
     private _invalidateWaitPromptHandoffs;
+    private _reservePromptRun;
+    private _releasePromptRun;
     private _runAgentPrompt;
     private _handlePostAgentRun;
     /**
@@ -391,6 +405,16 @@ export declare class AgentSession {
      * @throws Error if no model selected or no API key available (when not streaming)
      */
     prompt(text: string, options?: PromptOptions): Promise<void>;
+    private _prompt;
+    /**
+     * Admit one scheduled request, including steering, retries and compaction.
+     * Completes before later follow-ups; signal cancellation belongs only to this request.
+     */
+    promptWithCompletion(text: string, options?: Omit<PromptOptions, "streamingBehavior" | "preflightResult"> & {
+        signal?: AbortSignal;
+    }): Promise<{
+        messages: AgentMessage[];
+    }>;
     private _preparePromptInput;
     private _createPromptMessages;
     interruptSubagentWaitWithPrompt(text: string, options?: Pick<PromptOptions, "expandPromptTemplates" | "images" | "source">): Promise<WaitPromptHandoff | undefined>;
@@ -610,7 +634,7 @@ export declare class AgentSession {
         excludeFromContext?: boolean;
     }): void;
     /**
-     * Cancel running bash command.
+     * Cancel every running direct bash operation.
      */
     abortBash(): void;
     /** Whether a bash command is currently running */
@@ -643,12 +667,13 @@ export declare class AgentSession {
         replaceInstructions?: boolean;
         label?: string;
     }): Promise<{
-        editorText?: string;
-        editorImages?: ImageContent[];
+        editorText?: string | undefined;
+        editorImages?: ImageContent[] | undefined;
         cancelled: boolean;
-        aborted?: boolean;
-        summaryEntry?: BranchSummaryEntry;
+        aborted?: boolean | undefined;
+        summaryEntry?: BranchSummaryEntry<unknown> | undefined;
     }>;
+    private _navigateTree;
     /**
      * Get all user messages from session for fork selector.
      */
@@ -661,7 +686,7 @@ export declare class AgentSession {
     /**
      * 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.
+     * reported or estimated across requests incurred in this session.
      */
     getSessionStats(): SessionStats;
     getContextUsage(): ContextUsage | undefined;