@vaclav-synacek/pi-coding-agent-termux 0.49.3-0 → 0.50.1-0

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

@@ -16,14 +16,26 @@ import type { Agent, AgentEvent, AgentMessage, AgentState, AgentTool, ThinkingLe
 import type { ImageContent, Model, TextContent } from "@mariozechner/pi-ai";
 import { type BashResult } from "./bash-executor.js";
 import { type CompactionResult } from "./compaction/index.js";
-import type { ContextUsage, ExtensionRunner, InputSource } from "./extensions/index.js";
+import { type ContextUsage, type ExtensionCommandContextActions, type ExtensionErrorListener, ExtensionRunner, type ExtensionUIContext, type InputSource, type ShutdownHandler, type ToolDefinition } 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 { BranchSummaryEntry, NewSessionOptions, SessionManager } from "./session-manager.js";
-import type { SettingsManager, SkillsSettings } from "./settings-manager.js";
-import type { Skill, SkillWarning } from "./skills.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";
+/** Parsed skill block from a user message */
+export interface ParsedSkillBlock {
+    name: string;
+    location: string;
+    content: string;
+    userMessage: string | undefined;
+}
+/**
+ * Parse a skill block from message text.
+ * Returns null if the text doesn't contain a skill block.
+ */
+export declare function parseSkillBlock(text: string): ParsedSkillBlock | null;
 /** Session-specific events that extend the core AgentEvent */
 export type AgentSessionEvent = AgentEvent | {
     type: "auto_compaction_start";
@@ -52,26 +64,32 @@ export interface AgentSessionConfig {
     agent: Agent;
     sessionManager: SessionManager;
     settingsManager: SettingsManager;
+    cwd: string;
     /** Models to cycle through with Ctrl+P (from --models flag) */
     scopedModels?: Array<{
         model: Model<any>;
         thinkingLevel: ThinkingLevel;
     }>;
-    /** File-based prompt templates for expansion */
-    promptTemplates?: PromptTemplate[];
-    /** Extension runner (created in sdk.ts with wrapped tools) */
-    extensionRunner?: ExtensionRunner;
-    /** Loaded skills (already discovered by SDK) */
-    skills?: Skill[];
-    /** Skill loading warnings (already captured by SDK) */
-    skillWarnings?: SkillWarning[];
-    skillsSettings?: Required<SkillsSettings>;
+    /** Resource loader for skills, prompts, themes, context files, system prompt */
+    resourceLoader: ResourceLoader;
+    /** SDK custom tools registered outside extensions */
+    customTools?: ToolDefinition[];
     /** Model registry for API key resolution and model discovery */
     modelRegistry: ModelRegistry;
-    /** Tool registry for extension getTools/setTools - maps name to tool */
-    toolRegistry?: Map<string, AgentTool>;
-    /** Function to rebuild system prompt when tools change */
-    rebuildSystemPrompt?: (toolNames: string[]) => string;
+    /** Initial active built-in tool names. Default: [read, bash, edit, write] */
+    initialActiveToolNames?: string[];
+    /** Override base tools (useful for custom runtimes). */
+    baseToolsOverride?: Record<string, AgentTool>;
+    /** Mutable ref used by Agent to access the current ExtensionRunner */
+    extensionRunnerRef?: {
+        current?: ExtensionRunner;
+    };
+}
+export interface ExtensionBindings {
+    uiContext?: ExtensionUIContext;
+    commandContextActions?: ExtensionCommandContextActions;
+    shutdownHandler?: ShutdownHandler;
+    onError?: ExtensionErrorListener;
 }
 /** Options for AgentSession.prompt() */
 export interface PromptOptions {
@@ -114,7 +132,6 @@ export declare class AgentSession {
     readonly sessionManager: SessionManager;
     readonly settingsManager: SettingsManager;
     private _scopedModels;
-    private _promptTemplates;
     private _unsubscribeAgent?;
     private _eventListeners;
     /** Tracks pending steering messages for UI display. Removed when delivered. */
@@ -134,12 +151,20 @@ export declare class AgentSession {
     private _pendingBashMessages;
     private _extensionRunner;
     private _turnIndex;
-    private _skills;
-    private _skillWarnings;
-    private _skillsSettings;
+    private _resourceLoader;
+    private _customTools;
+    private _baseToolRegistry;
+    private _cwd;
+    private _extensionRunnerRef?;
+    private _initialActiveToolNames?;
+    private _baseToolsOverride?;
+    private _extensionUIContext?;
+    private _extensionCommandContextActions?;
+    private _extensionShutdownHandler?;
+    private _extensionErrorListener?;
+    private _extensionErrorUnsubscriber?;
     private _modelRegistry;
     private _toolRegistry;
-    private _rebuildSystemPrompt?;
     private _baseSystemPrompt;
     constructor(config: AgentSessionConfig);
     /** Model registry for API key resolution and model discovery */
@@ -231,6 +256,7 @@ export declare class AgentSession {
     }>): void;
     /** File-based prompt templates */
     get promptTemplates(): ReadonlyArray<PromptTemplate>;
+    private _rebuildSystemPrompt;
     /**
      * Send a prompt to the agent.
      * - Handles extension commands (registered via pi.registerCommand) immediately, even during streaming
@@ -309,11 +335,7 @@ export declare class AgentSession {
     getSteeringMessages(): readonly string[];
     /** Get pending follow-up messages (read-only) */
     getFollowUpMessages(): readonly string[];
-    get skillsSettings(): Required<SkillsSettings> | undefined;
-    /** Skills loaded by SDK (empty if --no-skills or skills: [] was passed) */
-    get skills(): readonly Skill[];
-    /** Skill loading warnings captured by SDK */
-    get skillWarnings(): readonly SkillWarning[];
+    get resourceLoader(): ResourceLoader;
     /**
      * Abort current operation and wait for agent to become idle.
      */
@@ -322,10 +344,14 @@ export declare class AgentSession {
      * 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 - Optional initial messages and parent session path
+     * @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?: NewSessionOptions): Promise<boolean>;
+    newSession(options?: {
+        parentSession?: string;
+        setup?: (sessionManager: SessionManager) => Promise<void>;
+    }): Promise<boolean>;
     private _emitModelSelect;
     /**
      * Set model directly.
@@ -342,10 +368,6 @@ export declare class AgentSession {
     cycleModel(direction?: "forward" | "backward"): Promise<ModelCycleResult | undefined>;
     private _cycleScopedModel;
     private _cycleAvailableModel;
-    /**
-     * Get all available models with valid API keys.
-     */
-    getAvailableModels(): Promise<Model<any>[]>;
     /**
      * Set thinking level.
      * Clamps to model capabilities based on available thinking levels.
@@ -403,16 +425,17 @@ export declare class AgentSession {
     setAutoCompactionEnabled(enabled: boolean): void;
     /** Whether auto-compaction is enabled */
     get autoCompactionEnabled(): boolean;
+    bindExtensions(bindings: ExtensionBindings): Promise<void>;
+    private _applyExtensionBindings;
+    private _bindExtensionCore;
+    private _buildRuntime;
+    reload(): Promise<void>;
     /**
      * Check if an error is retryable (overloaded, rate limit, server errors).
      * Context overflow errors are NOT retryable (handled by compaction instead).
      */
     private _isRetryableError;
     private _handleRetryableError;
-    /**
-     * Sleep helper that respects abort signal.
-     */
-    private _sleep;
     /**
      * Cancel in-progress retry.
      */