jupyter-chat-components 0.2.0 → 0.4.0

package/lib/factory.js

@@ -1,7 +1,7 @@
 import { nullTranslator } from '@jupyterlab/translation';
 import { ReactWidget } from '@jupyterlab/ui-components';
 import * as React from 'react';
-import { InlineDiff, ToolCall } from './components';
+import { GroupedToolCalls, InlineDiff, MessageQueue, ToolCall } from './components';
 import { ComponentRegistry } from './registry';
 /**
  * The default mime type for the extension.
@@ -26,6 +26,9 @@ export class ComponentsRenderer extends ReactWidget {
         this._trans = ((_a = options.translator) !== null && _a !== void 0 ? _a : nullTranslator).load('jupyterlab');
         this._mimeType = options.mimeType;
         this._toolCallApproval = options.toolCallApproval;
+        this._removeQueuedMessage = options.removeQueuedMessage;
+        this._toolCallPermissionDecision = options.toolCallPermissionDecision;
+        this._openToolCallPath = options.openToolCallPath;
         this._registry = options.registry;
         this.addClass(CLASS_NAME);
     }
@@ -53,6 +56,14 @@ export class ComponentsRenderer extends ReactWidget {
         if (this._data === 'tool-call') {
             componentsProps.toolCallApproval = this._toolCallApproval;
         }
+        if (this._data === 'message-queue') {
+            componentsProps.removeQueuedMessage = this._removeQueuedMessage;
+        }
+        if (this._data === 'grouped-tool-calls') {
+            componentsProps.toolCallPermissionDecision =
+                this._toolCallPermissionDecision;
+            componentsProps.openToolCallPath = this._openToolCallPath;
+        }
         return React.createElement(Component, { ...componentsProps, trans: this._trans });
     }
 }
@@ -65,15 +76,23 @@ export class RendererFactory {
         this.mimeTypes = [MIME_TYPE];
         this.defaultRank = 100;
         this.toolCallApproval = null;
+        this.removeQueuedMessage = null;
+        this.toolCallPermissionDecision = null;
+        this.openToolCallPath = null;
         this.createRenderer = (options) => {
             return new ComponentsRenderer({
                 ...options,
                 toolCallApproval: this.toolCallApproval,
+                removeQueuedMessage: this.removeQueuedMessage,
+                toolCallPermissionDecision: this.toolCallPermissionDecision,
+                openToolCallPath: this.openToolCallPath,
                 registry: this.registry
             });
         };
         this.registry = new ComponentRegistry();
         this.registry.add('tool-call', ToolCall);
+        this.registry.add('grouped-tool-calls', GroupedToolCalls);
         this.registry.add('inline-diff', InlineDiff);
+        this.registry.add('message-queue', MessageQueue);
     }
 }

package/lib/token.d.ts

@@ -10,6 +10,18 @@ export declare const IComponentsRendererFactory: Token<IComponentsRendererFactor
  * The callback to approve or reject a tool.
  */
 export type ToolCallApproval = ((targetId: string, approvalId: string, approve: boolean) => void) | null;
+/**
+ * The callback to submit a tool-call permission decision.
+ */
+export type ToolCallPermissionDecision = ((sessionId: string, toolCallId: string, optionId: string) => Promise<void> | void) | null;
+/**
+ * The callback to remove a queued message.
+ */
+export type RemoveQueuedMessage = ((targetId: string, messageId: string) => void) | null;
+/**
+ * The callback to open a file or resource path referenced by a tool call.
+ */
+export type OpenToolCallPath = ((path: string) => void) | null;
 /**
  * The interface for components renderer factory.
  */
@@ -22,6 +34,18 @@ export interface IComponentsRendererFactory extends IRenderMime.IRendererFactory
      * The callback to approve or reject a tool.
      */
     toolCallApproval: ToolCallApproval;
+    /**
+     * The callback to remove a queued message.
+     */
+    removeQueuedMessage: RemoveQueuedMessage;
+    /**
+     * The callback to submit a permission decision for grouped tool calls.
+     */
+    toolCallPermissionDecision: ToolCallPermissionDecision;
+    /**
+     * The callback to open a path referenced by grouped tool calls.
+     */
+    openToolCallPath: OpenToolCallPath;
 }
 /**
  * The interface for the component registry.
@@ -65,16 +89,180 @@ export interface IComponentProps {
     trans: TranslationBundle;
 }
 /**
- * A single file diff entry.
+ * A file diff entry for grouped tool calls.
  */
-export interface IInlineDiff {
+export interface IToolCallDiff {
+    /**
+     * Path of the file being diffed.
+     */
     path: string;
+    /**
+     * Updated text content.
+     */
     newText: string;
+    /**
+     * Previous text content.
+     */
+    oldText?: string;
+}
+/**
+ * A permission option for grouped tool calls.
+ */
+export interface IToolCallPermissionOption {
+    /**
+     * Stable permission option identifier.
+     */
+    optionId: string;
+    /**
+     * Human-readable button label.
+     */
+    name: string;
+    /**
+     * Optional semantic option kind, such as allow_once or reject_once.
+     */
+    kind?: string;
+}
+/**
+ * A single grouped tool call entry.
+ */
+export interface IToolCallsEntry {
+    /**
+     * Unique tool call identifier.
+     */
+    toolCallId: string;
+    /**
+     * Human-readable title displayed in the UI.
+     */
+    title?: string;
+    /**
+     * Tool operation category.
+     */
+    kind?: string;
+    /**
+     * Current tool call status.
+     */
+    status?: string;
+    /**
+     * Tool input payload.
+     */
+    rawInput?: unknown;
+    /**
+     * Tool output payload.
+     */
+    rawOutput?: unknown;
+    /**
+     * File paths or resource locations referenced by the tool call.
+     */
+    locations?: string[];
+    /**
+     * Permission options presented to the user.
+     */
+    permissionOptions?: IToolCallPermissionOption[];
+    /**
+     * Permission request lifecycle state.
+     */
+    permissionStatus?: 'pending' | 'resolved';
+    /**
+     * Selected permission option identifier.
+     */
+    selectedOptionId?: string;
+    /**
+     * Session identifier used to route permission decisions.
+     */
+    sessionId?: string;
+    /**
+     * Optional inline file diffs associated with the tool call.
+     */
+    diffs?: IToolCallDiff[];
+}
+/**
+ * Metadata for rendering grouped tool calls.
+ */
+export interface IToolCallsMetadata {
+    /**
+     * List of tool call entries.
+     */
+    toolCalls: IToolCallsEntry[];
+}
+/**
+ * A file diff target.
+ */
+export interface IInlineDiffFileTarget {
+    /**
+     * Discriminator for a regular file diff target.
+     */
+    kind: 'file';
+    /**
+     * Path of the file being diffed.
+     */
+    path: string;
+}
+/**
+ * A notebook cell diff target.
+ */
+export interface IInlineDiffNotebookCellTarget {
+    /**
+     * Discriminator for a notebook cell source diff target.
+     */
+    kind: 'cell';
+    /**
+     * Path of the notebook containing the cell.
+     */
+    notebookPath: string;
+    /**
+     * Stable cell identifier, when available from the producer.
+     */
+    cellId?: string;
+    /**
+     * Zero-based notebook cell index used for the default display label.
+     */
+    cellIndex?: number;
+}
+/**
+ * A supported inline diff target.
+ */
+export type IInlineDiffTarget = IInlineDiffFileTarget | IInlineDiffNotebookCellTarget;
+/**
+ * A single inline diff entry.
+ */
+export interface IInlineDiff {
+    /**
+     * Structured target metadata.
+     */
+    target: IInlineDiffTarget;
+    /**
+     * Optional explicit label for the diff header.
+     */
+    label?: string;
+    /**
+     * Updated text content for the diff target.
+     */
+    newText: string;
+    /**
+     * Previous text content for the diff target.
+     */
     oldText?: string;
 }
 /**
  * Metadata for rendering inline diffs.
  */
 export interface IInlineDiffMetadata {
+    /**
+     * List of inline diff entries to render.
+     */
     diffs: IInlineDiff[];
 }
+/**
+ * A single queued message entry.
+ */
+export interface IQueuedMessage {
+    id: string;
+    body: string;
+}
+/**
+ * Metadata for the message queue component.
+ */
+export interface IMessageQueueMetadata {
+    messages: IQueuedMessage[];
+    targetId?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jupyter-chat-components",
-    "version": "0.2.0",
+    "version": "0.4.0",
     "description": "Components to displayed in jupyter chat",
     "keywords": [
         "jupyter",