@jupyterlite/ai 0.17.0 → 0.19.0

package/lib/chat-commands/clear.d.ts

@@ -6,3 +6,4 @@ export declare class ClearCommandProvider implements IChatCommandProvider {
     private _command;
     private _regex;
 }
+//# sourceMappingURL=clear.d.ts.map

package/lib/chat-commands/index.d.ts

@@ -1,2 +1,3 @@
 export * from './clear';
 export * from './skills';
+//# sourceMappingURL=index.d.ts.map

package/lib/chat-commands/skills.d.ts

@@ -1,6 +1,6 @@
+import type { ISkillRegistry } from '@jupyternaut/agent';
 import { ChatCommand, IChatCommandProvider, IInputModel } from '@jupyter/chat';
 import { CommandRegistry } from '@lumino/commands';
-import { ISkillRegistry } from '../tokens';
 export declare class SkillsCommandProvider implements IChatCommandProvider {
     constructor(options: SkillsCommandProvider.IOptions);
     id: string;
@@ -17,3 +17,4 @@ export declare namespace SkillsCommandProvider {
         commands: CommandRegistry;
     }
 }
+//# sourceMappingURL=skills.d.ts.map

package/lib/chat-model-handler.d.ts

@@ -1,15 +1,15 @@
+import type { IAgentManagerFactory, IProviderRegistry, IToolRegistry } from '@jupyternaut/agent';
 import { ActiveCellManager } from '@jupyter/chat';
 import { IDocumentManager } from '@jupyterlab/docmanager';
 import { IRenderMimeRegistry } from '@jupyterlab/rendermime';
 import { Contents } from '@jupyterlab/services';
-import { AIChatModel } from './chat-model';
-import type { IAgentManagerFactory, IAISettingsModel, IChatModelHandler, ICreateChatOptions, IProviderRegistry, IToolRegistry } from './tokens';
+import type { IAIChatModel, IAISettingsModel, IChatModelHandler, ICreateChatOptions } from './tokens';
 /**
  * The chat model handler.
  */
 export declare class ChatModelHandler implements IChatModelHandler {
     constructor(options: ChatModelHandler.IOptions);
-    createModel(options: ICreateChatOptions): AIChatModel;
+    createModel(options: ICreateChatOptions): IAIChatModel;
     /**
      * Getter/setter for the active cell manager.
      */
@@ -60,3 +60,4 @@ export declare namespace ChatModelHandler {
         contentsManager?: Contents.IManager;
     }
 }
+//# sourceMappingURL=chat-model-handler.d.ts.map

package/lib/chat-model-handler.js

@@ -31,7 +31,8 @@ export class ChatModelHandler {
             agentManager,
             activeCellManager: this._activeCellManager,
             documentManager: this._docManager,
-            contentsManager: this._contentsManager
+            contentsManager: this._contentsManager,
+            providerRegistry: this._providerRegistry
         });
         messages?.forEach(message => {
             model.messageAdded({ ...message.content });

package/lib/chat-model.d.ts

@@ -1,13 +1,16 @@
-import { AbstractChatModel, IActiveCellManager, IAttachment, IChatContext, IMessageContent, INewMessage, IUser } from '@jupyter/chat';
+import { AbstractChatModel, IActiveCellManager, IAttachment, IChatContext, IMessageContent, IMimeModelBody, INewMessage, IUser } from '@jupyter/chat';
 import { IDocumentManager } from '@jupyterlab/docmanager';
+import * as nbformat from '@jupyterlab/nbformat';
 import { Contents } from '@jupyterlab/services';
+import type { IAgentManager, IProviderRegistry, ITokenUsage } from '@jupyternaut/agent';
 import { ISignal } from '@lumino/signaling';
-import type { IAgentManager, IAISettingsModel, ITokenUsage } from './tokens';
+import type { UserContent } from 'ai';
+import type { IAIChatModel, IAISettingsModel } from './tokens';
 /**
  * AI Chat Model implementation that provides chat functionality tool integration,
  * and MCP server support.
  */
-export declare class AIChatModel extends AbstractChatModel {
+export declare class AIChatModel extends AbstractChatModel implements IAIChatModel {
     /**
      * Constructs a new AIChatModel instance.
      * @param options Configuration options for the chat model
@@ -21,7 +24,7 @@ export declare class AIChatModel extends AbstractChatModel {
     /**
      * A signal emitting when the chat name has changed.
      */
-    get nameChanged(): ISignal<AIChatModel, string>;
+    get nameChanged(): ISignal<IAIChatModel, string>;
     /**
      * The title of the chat.
      */
@@ -30,7 +33,7 @@ export declare class AIChatModel extends AbstractChatModel {
     /**
      * A signal emitting when the chat title has changed.
      */
-    get titleChanged(): ISignal<AIChatModel, string | null>;
+    get titleChanged(): ISignal<IAIChatModel, string | null>;
     /**
      * Whether to save the chat automatically.
      */
@@ -39,7 +42,7 @@ export declare class AIChatModel extends AbstractChatModel {
     /**
      * A signal emitting when the autosave flag changed.
      */
-    get autosaveChanged(): ISignal<AIChatModel, boolean>;
+    get autosaveChanged(): ISignal<IAIChatModel, boolean>;
     /**
      * Gets the current user information.
      */
@@ -49,7 +52,7 @@ export declare class AIChatModel extends AbstractChatModel {
      */
     get tokenUsageChanged(): ISignal<IAgentManager, ITokenUsage>;
     /**
-     * Get the agent manager associated to the model.
+     * The agent manager used in the model.
      */
     get agentManager(): IAgentManager;
     /**
@@ -72,15 +75,51 @@ export declare class AIChatModel extends AbstractChatModel {
      * Clears all messages from the chat and resets conversation state.
      */
     clearMessages: () => Promise<void>;
+    /**
+     * Overrides messageAdded to ensure queued messages stay at the bottom.
+     */
+    messageAdded(message: IMessageContent): void;
     /**
      * Adds a non-user message to the chat (used by chat commands).
      */
-    addSystemMessage(body: string): void;
+    private _addSystemMessage;
     /**
      * Sends a message to the AI and generates a response.
      * @param message The user message to send
      */
     sendMessage(message: INewMessage): Promise<void>;
+    /**
+     * Internal method to process attachments and send the message to the agent.
+     */
+    private _processMessage;
+    /**
+     * Removes the message-queue chat component.
+     */
+    private _removeQueueUI;
+    /**
+     * Creates or updates the message-queue chat component.
+     */
+    private _updateQueueUI;
+    /**
+     * Processes the next message in the queue, or marks the agent as idle.
+     */
+    private _drainQueue;
+    /**
+     * Removes a queued message by its ID.
+     * @param messageId The ID of the queued message to remove
+     */
+    removeQueuedMessage(messageId: string): void;
+    /**
+     * Reorders queued messages by their IDs.
+     * @param messageIds Array of message IDs in the desired order
+     */
+    reorderQueuedMessages(messageIds: string[]): void;
+    /**
+     * Edits a queued message by its ID.
+     * @param messageId The ID of the queued message to edit
+     * @param newBody The new body of the message
+     */
+    editQueuedMessage(messageId: string, newBody: string): void;
     /**
      * Save the chat as json file.
      */
@@ -108,6 +147,16 @@ export declare class AIChatModel extends AbstractChatModel {
      * Handles settings changes and updates chat configuration accordingly.
      */
     private _onSettingsChanged;
+    /**
+     * Rebuild history when the active model changes.
+     */
+    private _onModelChanged;
+    /**
+     * Rebuilds the agent history from the current messages.
+     * For vision-capable models, re-reads binary attachments from disk.
+     * For text-only models, uses message text only.
+     */
+    private _rebuildHistory;
     /**
      * Handles events emitted by the agent manager.
      * @param event The event data containing type and payload
@@ -168,19 +217,92 @@ export declare class AIChatModel extends AbstractChatModel {
      * Updates a tool call's UI with new status and optional output.
      */
     private _updateToolCallUI;
+    /**
+     * The current message queue
+     */
+    get messageQueue(): Private.IQueuedItem[];
+    set messageQueue(value: Private.IQueuedItem[]);
+    /**
+     * Whether the chat is busy
+     */
+    get isBusy(): boolean;
+    set isBusy(value: boolean);
     private _settingsModel;
     private _user;
     private _toolContexts;
     private _agentManager;
+    private _providerRegistry?;
+    private _currentModelKey;
     private _currentStreamingMessage;
     private _nameChanged;
     private _contentsManager?;
     private _autosave;
     private _autosaveChanged;
     private _autosaveDebouncer;
+    private _messageQueue;
+    private _isBusy;
+    private _queueMessageId;
     private _title;
     private _titleChanged;
 }
+declare namespace Private {
+    export interface IQueuedItem {
+        id: string;
+        body: string;
+        _originalMsg: IMessageContent;
+    }
+    type IDisplayOutput = nbformat.IDisplayData | nbformat.IDisplayUpdate | nbformat.IExecuteResult;
+    export const isPlainObject: (value: unknown) => value is Record<string, unknown>;
+    export const isDisplayOutput: (value: unknown) => value is IDisplayOutput;
+    export const toMimeBundle: (value: IDisplayOutput, trustedMimeTypes: ReadonlySet<string>) => IMimeModelBody | null;
+    /**
+     * Normalize arbitrary tool payloads into canonical display outputs.
+     *
+     * Tool outputs are not guaranteed to be raw Jupyter IOPub messages; they are
+     * often wrapped objects (for example `{ success, result: { outputs: [...] } }`).
+     */
+    export const toDisplayOutputs: (value: unknown) => IDisplayOutput[];
+    /**
+     * Extract rendermime-ready mime bundles from arbitrary tool results.
+     */
+    export function extractMimeBundlesFromUnknown(content: unknown, options?: {
+        trustedMimeTypes?: ReadonlyArray<string>;
+    }): IMimeModelBody[];
+    export function formatToolOutput(outputData: unknown): string;
+    /**
+     * Processes file attachments and returns the message content with the attachments.
+     * @param attachments Array of file attachments to process
+     * @param documentManager Optional document manager for file operations
+     * @param body The message body
+     * @param supportsImages Whether the model supports images
+     * @param supportsPdf Whether the model supports pdfs
+     * @param supportsAudio Whether the model supports audio
+     * @returns Enhanced message content
+     */
+    export function processAttachments(attachments: IAttachment[], documentManager: IDocumentManager | null | undefined, body: string, supportsImages: boolean, supportsPdf: boolean, supportsAudio: boolean): Promise<UserContent>;
+    /**
+     * Reads a binary attachment and returns its base64-encoded content.
+     * @param attachment The attachment to read
+     * @param documentManager Optional document manager for file operations
+     * @returns Base64 string or null if unable to read
+     */
+    export function readBinaryAttachment(attachment: IAttachment, documentManager: IDocumentManager | null | undefined): Promise<string | null>;
+    /**
+     * Reads the content of a notebook cell.
+     * @param attachment The notebook attachment to read
+     * @param documentManager Optional document manager for file operations
+     * @returns Cell content as string or null if unable to read
+     */
+    export function readNotebookCells(attachment: IAttachment, documentManager: IDocumentManager | null | undefined): Promise<string | null>;
+    /**
+     * Reads the content of a file attachment.
+     * @param attachment The file attachment to read
+     * @param documentManager Optional document manager for file operations
+     * @returns File content as string or null if unable to read
+     */
+    export function readFileAttachment(attachment: IAttachment, documentManager: IDocumentManager | null | undefined): Promise<string | null>;
+    export {};
+}
 /**
  * Namespace containing types and interfaces for AIChatModel.
  */
@@ -213,6 +335,10 @@ export declare namespace AIChatModel {
          * The contents manager.
          */
         contentsManager?: Contents.IManager;
+        /**
+         * Optional provider registry for model capability lookups.
+         */
+        providerRegistry?: IProviderRegistry;
         /**
          * Whether to restore or not the message (default to true)
          */
@@ -238,6 +364,18 @@ export declare namespace AIChatModel {
          * The agent manager of the chat.
          */
         agentManager: IAgentManager;
+        /**
+         * Removes a queued message by its ID.
+         */
+        removeQueuedMessage: (id: string) => void;
+        /**
+         * Reorders queued messages by their IDs.
+         */
+        reorderQueuedMessages: (ids: string[]) => void;
+        /**
+         * Edits a queued message by its ID.
+         */
+        editQueuedMessage: (id: string, body: string) => void;
     }
     /**
      * The exported chat format.
@@ -278,3 +416,5 @@ export declare namespace AIChatModel {
         };
     };
 }
+export {};
+//# sourceMappingURL=chat-model.d.ts.map