@draht/coding-agent 2026.3.25 → 2026.4.5

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

@@ -16,14 +16,14 @@ import type { Agent, AgentEvent, AgentMessage, AgentState, AgentTool, ThinkingLe
 import type { ImageContent, Model, TextContent } from "@draht/ai";
 import { type BashResult } from "./bash-executor.js";
 import { type CompactionResult } from "./compaction/index.js";
-import { type ContextUsage, type ExtensionCommandContextActions, type ExtensionErrorListener, ExtensionRunner, type ExtensionUIContext, type InputSource, type ShutdownHandler, type ToolDefinition, type ToolInfo } from "./extensions/index.js";
+import { type ContextUsage, type ExtensionCommandContextActions, type ExtensionErrorListener, ExtensionRunner, type ExtensionUIContext, type InputSource, type SessionStartEvent, type ShutdownHandler, type ToolDefinition, type ToolInfo } from "./extensions/index.js";
 import type { CustomMessage } from "./messages.js";
 import type { ModelRegistry } from "./model-registry.js";
 import { type PromptTemplate } from "./prompt-templates.js";
 import type { ResourceLoader } from "./resource-loader.js";
 import type { BranchSummaryEntry, SessionManager } from "./session-manager.js";
 import type { SettingsManager } from "./settings-manager.js";
-import type { BashOperations } from "./tools/bash.js";
+import { type BashOperations } from "./tools/bash.js";
 /** Parsed skill block from a user message */
 export interface ParsedSkillBlock {
     name: string;
@@ -46,6 +46,16 @@ export type AgentSessionEvent = AgentEvent | {
     aborted: boolean;
     willRetry: boolean;
     errorMessage?: string;
+} | {
+    type: "compaction_start";
+    reason: "manual" | "threshold" | "overflow";
+} | {
+    type: "compaction_end";
+    reason: "manual" | "threshold" | "overflow";
+    result: CompactionResult | undefined;
+    aborted: boolean;
+    willRetry: boolean;
+    errorMessage?: string;
 } | {
     type: "auto_retry_start";
     attempt: number;
@@ -57,6 +67,10 @@ export type AgentSessionEvent = AgentEvent | {
     success: boolean;
     attempt: number;
     finalError?: string;
+} | {
+    type: "queue_update";
+    steering: readonly string[];
+    followUp: readonly string[];
 };
 /** Listener function for agent session events */
 export type AgentSessionEventListener = (event: AgentSessionEvent) => void;
@@ -89,6 +103,8 @@ export interface AgentSessionConfig {
     extensionRunnerRef?: {
         current?: ExtensionRunner;
     };
+    /** Session start event metadata emitted when extensions bind to this runtime. */
+    sessionStartEvent?: SessionStartEvent;
 }
 export interface ExtensionBindings {
     uiContext?: ExtensionUIContext;
@@ -166,6 +182,7 @@ export declare class AgentSession {
     private _extensionRunnerRef?;
     private _initialActiveToolNames?;
     private _baseToolsOverride?;
+    private _sessionStartEvent;
     private _extensionUIContext?;
     private _extensionCommandContextActions?;
     private _extensionShutdownHandler?;
@@ -180,6 +197,7 @@ export declare class AgentSession {
     constructor(config: AgentSessionConfig);
     /** Model registry for API key resolution and model discovery */
     get modelRegistry(): ModelRegistry;
+    private _getRequiredRequestAuth;
     /**
      * Install tool hooks once on the Agent instance.
      *
@@ -370,23 +388,11 @@ export declare class AgentSession {
      * Abort current operation and wait for agent to become idle.
      */
     abort(): Promise<void>;
-    /**
-     * Start a new session, optionally with initial messages and parent tracking.
-     * Clears all messages and starts a new session.
-     * Listeners are preserved and will continue receiving events.
-     * @param options.parentSession - Optional parent session path for tracking
-     * @param options.setup - Optional callback to initialize session (e.g., append messages)
-     * @returns true if completed, false if cancelled by extension
-     */
-    newSession(options?: {
-        parentSession?: string;
-        setup?: (sessionManager: SessionManager) => Promise<void>;
-    }): Promise<boolean>;
     private _emitModelSelect;
     /**
      * Set model directly.
-     * Validates API key, saves to session and settings.
-     * @throws Error if no API key available for the model
+     * Validates that auth is configured, saves to session and settings.
+     * @throws Error if no auth is configured for the model
      */
     setModel(model: Model<any>): Promise<void>;
     /**
@@ -396,7 +402,6 @@ export declare class AgentSession {
      * @returns The new model info, or undefined if only one model available
      */
     cycleModel(direction?: "forward" | "backward"): Promise<ModelCycleResult | undefined>;
-    private _getScopedModelsWithApiKey;
     private _cycleScopedModel;
     private _cycleAvailableModel;
     /**
@@ -518,30 +523,10 @@ export declare class AgentSession {
      * Called after agent turn completes to maintain proper message ordering.
      */
     private _flushPendingBashMessages;
-    /**
-     * Switch to a different session file.
-     * Aborts current operation, loads messages, restores model/thinking.
-     * Listeners are preserved and will continue receiving events.
-     * @returns true if switch completed, false if cancelled by extension
-     */
-    switchSession(sessionPath: string): Promise<boolean>;
     /**
      * Set a display name for the current session.
      */
     setSessionName(name: string): void;
-    /**
-     * Create a fork from a specific entry.
-     * Emits before_fork/fork session events to extensions.
-     *
-     * @param entryId ID of the entry to fork from
-     * @returns Object with:
-     *   - selectedText: The text of the selected user message (for editor pre-fill)
-     *   - cancelled: True if an extension cancelled the fork
-     */
-    fork(entryId: string): Promise<{
-        selectedText: string;
-        cancelled: boolean;
-    }>;
     /**
      * Navigate to a different node in the session tree.
      * Unlike fork() which creates a new session file, this stays in the same file.
@@ -590,13 +575,6 @@ export declare class AgentSession {
      * @returns The resolved output file path.
      */
     exportToJsonl(outputPath?: string): string;
-    /**
-     * Import a JSONL session file.
-     * Copies the file into the session directory and switches to it (like /resume).
-     * @param inputPath Path to the JSONL file to import.
-     * @returns true if the session was switched successfully.
-     */
-    importFromJsonl(inputPath: string): Promise<boolean>;
     /**
      * Get text content of last assistant message.
      * Useful for /copy command.