@jupyterlite/ai 0.11.1 → 0.13.0

package/lib/agent.d.ts

@@ -1,9 +1,10 @@
 import { ISignal } from '@lumino/signaling';
 import { type Tool } from 'ai';
 import { ISecretsManager } from 'jupyter-secrets-manager';
+import { IRenderMimeRegistry } from '@jupyterlab/rendermime';
 import { AISettingsModel } from './models/settings-model';
 import type { IProviderRegistry } from './tokens';
-import { ITool, IToolRegistry, ITokenUsage } from './tokens';
+import { ISkillRegistry, ITool, IToolRegistry, ITokenUsage } from './tokens';
 type ToolMap = Record<string, Tool>;
 export declare namespace AgentManagerFactory {
     interface IOptions {
@@ -11,6 +12,10 @@ export declare namespace AgentManagerFactory {
          * The settings model.
          */
         settingsModel: AISettingsModel;
+        /**
+         * The skill registry for discovering skills.
+         */
+        skillRegistry?: ISkillRegistry;
         /**
          * The secrets manager.
          */
@@ -18,7 +23,7 @@ export declare namespace AgentManagerFactory {
         /**
          * The token used to request the secrets manager.
          */
-        token: symbol;
+        token: symbol | null;
     }
 }
 export declare class AgentManagerFactory {
@@ -52,12 +57,17 @@ export declare class AgentManagerFactory {
      * Sets up the agent with model configuration, tools, and MCP servers.
      */
     private _initializeAgents;
+    /**
+     * Refresh skill snapshots across all agents.
+     */
+    refreshSkillSnapshots(): void;
     private _agentManagers;
     private _settingsModel;
+    private _skillRegistry?;
     private _secretsManager?;
     private _mcpClients;
     private _mcpConnectionChanged;
-    private _isInitializing;
+    private _initQueue;
 }
 /**
  * Event type mapping for type safety with inlined interface definitions
@@ -83,7 +93,7 @@ export interface IAgentEventTypeMap {
     tool_call_complete: {
         callId: string;
         toolName: string;
-        output: string;
+        outputData: unknown;
         isError: boolean;
     };
     tool_approval_request: {
@@ -123,6 +133,10 @@ export interface IAgentManagerOptions {
      * Optional provider registry for model creation
      */
     providerRegistry?: IProviderRegistry;
+    /**
+     * The skill registry for discovering skills.
+     */
+    skillRegistry?: ISkillRegistry;
     /**
      * The secrets manager.
      */
@@ -135,6 +149,10 @@ export interface IAgentManagerOptions {
      * Initial token usage.
      */
     tokenUsage?: ITokenUsage;
+    /**
+     * JupyterLab render mime registry for discovering supported MIME types.
+     */
+    renderMimeRegistry?: IRenderMimeRegistry;
 }
 /**
  * Manages the AI agent lifecycle and execution loop.
@@ -164,6 +182,10 @@ export declare class AgentManager {
      * Signal emitted when token usage statistics change.
      */
     get tokenUsageChanged(): ISignal<this, ITokenUsage>;
+    /**
+     * Refresh the skills snapshot and rebuild the agent if resources are ready.
+     */
+    refreshSkills(): void;
     /**
      * The active provider for this agent.
      */
@@ -220,6 +242,22 @@ export declare class AgentManager {
      * Sets up the agent with model configuration, tools, and MCP tools.
      */
     initializeAgent: (mcpTools?: ToolMap) => Promise<void>;
+    /**
+     * Refresh the in-memory skills snapshot from the skill registry.
+     */
+    private _refreshSkills;
+    /**
+     * Prepare model, tools, and settings needed to (re)build the agent.
+     */
+    private _prepareAgentConfig;
+    /**
+     * Build the runtime tool map used by the agent.
+     */
+    private _buildRuntimeTools;
+    /**
+     * Rebuild the agent using cached resources and the current skills snapshot.
+     */
+    private _rebuildAgent;
     /**
      * Processes the stream result from agent execution.
      * Handles message streaming, tool calls, and emits appropriate events.
@@ -235,6 +273,14 @@ export declare class AgentManager {
      * Handles tool-result stream parts.
      */
     private _handleToolResult;
+    /**
+     * Handles tool-error stream parts.
+     */
+    private _handleToolError;
+    /**
+     * Handles tool-output-denied stream parts.
+     */
+    private _handleToolOutputDenied;
     /**
      * Handles tool-approval-request stream parts.
      */
@@ -262,26 +308,34 @@ export declare class AgentManager {
      */
     private _createModel;
     /**
-     * Enhances the base system prompt with tool usage guidelines.
+     * Enhances the base system prompt with dynamic context like skills.
      * @param baseSystemPrompt The base system prompt from settings
-     * @returns The enhanced system prompt with tool usage instructions
+     * @returns The enhanced system prompt with dynamic additions
      */
     private _getEnhancedSystemPrompt;
+    /**
+     * Build an instruction line describing MIME types supported by this session.
+     */
+    private _getSupportedMimeTypesInstruction;
     private _settingsModel;
     private _toolRegistry?;
     private _providerRegistry?;
+    private _skillRegistry?;
     private _secretsManager?;
     private _selectedToolNames;
     private _agent;
     private _history;
     private _mcpTools;
-    private _isInitializing;
     private _controller;
     private _agentEvent;
     private _tokenUsage;
     private _tokenUsageChanged;
     private _activeProvider;
     private _activeProviderChanged;
+    private _skills;
+    private _renderMimeRegistry?;
+    private _initQueue;
+    private _agentConfig;
     private _pendingApprovals;
 }
 export {};