@datalayer/agent-runtimes 0.0.9 → 0.0.11

package/lib/config/envvars.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Environment Variable Catalog
+ *
+ * Predefined environment variable specifications.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+export interface EnvvarSpec {
+    id: string;
+    name: string;
+    description: string;
+    registrationUrl?: string;
+    tags: string[];
+    icon?: string;
+    emoji?: string;
+}
+export declare const ALPHAVANTAGE_API_KEY_SPEC: EnvvarSpec;
+export declare const GITHUB_TOKEN_SPEC: EnvvarSpec;
+export declare const GOOGLE_OAUTH_CLIENT_ID_SPEC: EnvvarSpec;
+export declare const GOOGLE_OAUTH_CLIENT_SECRET_SPEC: EnvvarSpec;
+export declare const KAGGLE_TOKEN_SPEC: EnvvarSpec;
+export declare const SLACK_BOT_TOKEN_SPEC: EnvvarSpec;
+export declare const SLACK_CHANNEL_IDS_SPEC: EnvvarSpec;
+export declare const SLACK_TEAM_ID_SPEC: EnvvarSpec;
+export declare const TAVILY_API_KEY_SPEC: EnvvarSpec;
+export declare const ENVVAR_CATALOG: Record<string, EnvvarSpec>;
+export declare function getEnvvarSpec(envvarId: string): EnvvarSpec;

package/lib/config/envvars.js

@@ -0,0 +1,115 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+// ============================================================================
+// Environment Variable Definitions
+// ============================================================================
+export const ALPHAVANTAGE_API_KEY_SPEC = {
+    id: 'ALPHAVANTAGE_API_KEY',
+    name: 'Alpha Vantage API Key',
+    description: 'API key for accessing Alpha Vantage financial market data and stock information. Provides real-time and historical stock prices, forex data, and cryptocurrency information.',
+    registrationUrl: 'https://www.alphavantage.co/support/#api-key',
+    tags: ['authentication', 'api-key', 'finance', 'stocks', 'market-data'],
+    icon: 'key',
+    emoji: '🔑',
+};
+export const GITHUB_TOKEN_SPEC = {
+    id: 'GITHUB_TOKEN',
+    name: 'GitHub Token',
+    description: 'GitHub API token for repository management and code operations. Required for GitHub MCP server and GitHub skill to interact with GitHub repositories programmatically.',
+    registrationUrl: 'https://github.com/settings/tokens',
+    tags: ['authentication', 'token', 'github', 'git', 'mcp-server', 'skill'],
+    icon: 'key',
+    emoji: '🔑',
+};
+export const GOOGLE_OAUTH_CLIENT_ID_SPEC = {
+    id: 'GOOGLE_OAUTH_CLIENT_ID',
+    name: 'Google OAuth Client ID',
+    description: 'OAuth 2.0 client ID for Google Workspace authentication. Required for Google Drive, Gmail, Calendar, and Docs integration through the Google Workspace MCP server.',
+    registrationUrl: 'https://console.cloud.google.com/apis/credentials',
+    tags: ['authentication', 'oauth', 'google', 'workspace', 'client-id'],
+    icon: 'key',
+    emoji: '🔑',
+};
+export const GOOGLE_OAUTH_CLIENT_SECRET_SPEC = {
+    id: 'GOOGLE_OAUTH_CLIENT_SECRET',
+    name: 'Google OAuth Client Secret',
+    description: 'OAuth 2.0 client secret for Google Workspace authentication. Used in conjunction with client ID for secure API access to Google services.',
+    registrationUrl: 'https://console.cloud.google.com/apis/credentials',
+    tags: [
+        'authentication',
+        'oauth',
+        'google',
+        'workspace',
+        'client-secret',
+        'security',
+    ],
+    icon: 'lock',
+    emoji: '🔒',
+};
+export const KAGGLE_TOKEN_SPEC = {
+    id: 'KAGGLE_TOKEN',
+    name: 'Kaggle API Token',
+    description: 'API token for accessing Kaggle datasets, competitions, notebooks, and models. Required for Kaggle MCP server authentication.',
+    registrationUrl: 'https://www.kaggle.com/settings/account',
+    tags: ['authentication', 'api-key', 'kaggle', 'data'],
+    icon: 'key',
+    emoji: '🔑',
+};
+export const SLACK_BOT_TOKEN_SPEC = {
+    id: 'SLACK_BOT_TOKEN',
+    name: 'Slack Bot Token',
+    description: 'OAuth token for Slack bot authentication. Required for Slack MCP server to send messages, manage channels, and interact with workspace members.',
+    registrationUrl: 'https://api.slack.com/apps',
+    tags: ['authentication', 'oauth', 'token', 'slack', 'messaging', 'bot'],
+    icon: 'key',
+    emoji: '🔑',
+};
+export const SLACK_CHANNEL_IDS_SPEC = {
+    id: 'SLACK_CHANNEL_IDS',
+    name: 'Slack Channel IDs',
+    description: 'Comma-separated list of Slack channel IDs that the bot is allowed to access. Restricts bot operations to specific channels for security and organization.',
+    tags: ['configuration', 'slack', 'channels', 'identifier'],
+    icon: 'hash',
+    emoji: undefined,
+};
+export const SLACK_TEAM_ID_SPEC = {
+    id: 'SLACK_TEAM_ID',
+    name: 'Slack Team ID',
+    description: 'Unique identifier for the Slack workspace (team). Required to specify which workspace the bot should connect to.',
+    registrationUrl: 'https://api.slack.com/apps',
+    tags: ['configuration', 'slack', 'workspace', 'identifier'],
+    icon: 'organization',
+    emoji: '🏢',
+};
+export const TAVILY_API_KEY_SPEC = {
+    id: 'TAVILY_API_KEY',
+    name: 'Tavily API Key',
+    description: 'API key for Tavily web search and research capabilities. Required for web crawling, content extraction, and search operations.',
+    registrationUrl: 'https://tavily.com/api-keys',
+    tags: ['authentication', 'api-key', 'search', 'web', 'research'],
+    icon: 'key',
+    emoji: '🔑',
+};
+// ============================================================================
+// Environment Variable Catalog
+// ============================================================================
+export const ENVVAR_CATALOG = {
+    ALPHAVANTAGE_API_KEY: ALPHAVANTAGE_API_KEY_SPEC,
+    GITHUB_TOKEN: GITHUB_TOKEN_SPEC,
+    GOOGLE_OAUTH_CLIENT_ID: GOOGLE_OAUTH_CLIENT_ID_SPEC,
+    GOOGLE_OAUTH_CLIENT_SECRET: GOOGLE_OAUTH_CLIENT_SECRET_SPEC,
+    KAGGLE_TOKEN: KAGGLE_TOKEN_SPEC,
+    SLACK_BOT_TOKEN: SLACK_BOT_TOKEN_SPEC,
+    SLACK_CHANNEL_IDS: SLACK_CHANNEL_IDS_SPEC,
+    SLACK_TEAM_ID: SLACK_TEAM_ID_SPEC,
+    TAVILY_API_KEY: TAVILY_API_KEY_SPEC,
+};
+export function getEnvvarSpec(envvarId) {
+    const spec = ENVVAR_CATALOG[envvarId];
+    if (!spec) {
+        throw new Error(`Unknown environment variable: ${envvarId}`);
+    }
+    return spec;
+}

package/lib/config/index.d.ts

@@ -0,0 +1,5 @@
+export * from './envvars';
+export * from './mcpServers';
+export * from './agents';
+export * from './skills';
+export * from './utils';

package/lib/config/index.js

@@ -0,0 +1,9 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export * from './envvars';
+export * from './mcpServers';
+export * from './agents';
+export * from './skills';
+export * from './utils';

package/lib/config/mcpServers.d.ts

@@ -0,0 +1,18 @@
+/**
+ * MCP Server Catalog
+ *
+ * Predefined MCP server configurations.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { MCPServer } from '../types';
+export declare const ALPHAVANTAGE_MCP_SERVER: MCPServer;
+export declare const CHART_MCP_SERVER: MCPServer;
+export declare const FILESYSTEM_MCP_SERVER: MCPServer;
+export declare const GITHUB_MCP_SERVER: MCPServer;
+export declare const GOOGLE_WORKSPACE_MCP_SERVER: MCPServer;
+export declare const KAGGLE_MCP_SERVER: MCPServer;
+export declare const SLACK_MCP_SERVER: MCPServer;
+export declare const TAVILY_MCP_SERVER: MCPServer;
+export declare const MCP_SERVER_LIBRARY: Record<string, MCPServer>;

package/lib/config/mcpServers.js

@@ -0,0 +1,153 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+// ============================================================================
+// MCP Server Definitions
+// ============================================================================
+export const ALPHAVANTAGE_MCP_SERVER = {
+    id: 'alphavantage',
+    name: 'Alpha Vantage',
+    description: 'Financial market data and stock information',
+    icon: 'graph',
+    emoji: '💹',
+    url: '',
+    command: 'uvx',
+    args: ['av-mcp==0.2.1', '${ALPHAVANTAGE_API_KEY}'],
+    transport: 'stdio',
+    enabled: true,
+    isAvailable: false,
+    tools: [],
+    requiredEnvVars: ['ALPHAVANTAGE_API_KEY'],
+};
+export const CHART_MCP_SERVER = {
+    id: 'chart',
+    name: 'Chart Generator',
+    description: 'Generate charts and visualizations',
+    icon: 'graph',
+    emoji: '📊',
+    url: '',
+    command: 'npx',
+    args: ['-y', '@antv/mcp-server-chart'],
+    transport: 'stdio',
+    enabled: true,
+    isAvailable: false,
+    tools: [],
+    requiredEnvVars: [],
+};
+export const FILESYSTEM_MCP_SERVER = {
+    id: 'filesystem',
+    name: 'Filesystem',
+    description: 'Local filesystem read/write operations',
+    icon: 'file-directory',
+    emoji: '📁',
+    url: '',
+    command: 'npx',
+    args: ['-y', '@modelcontextprotocol/server-filesystem', '$TMPDIR'],
+    transport: 'stdio',
+    enabled: true,
+    isAvailable: false,
+    tools: [],
+    requiredEnvVars: [],
+};
+export const GITHUB_MCP_SERVER = {
+    id: 'github',
+    name: 'GitHub',
+    description: 'GitHub repository operations (issues, PRs, code search)',
+    icon: 'mark-github',
+    emoji: '🐙 - git - collaboration',
+    url: '',
+    command: 'docker',
+    args: [
+        'run',
+        '-i',
+        '--rm',
+        '-e',
+        'GITHUB_TOKEN',
+        'ghcr.io/github/github-mcp-server',
+    ],
+    transport: 'stdio',
+    enabled: true,
+    isAvailable: false,
+    tools: [],
+    requiredEnvVars: ['GITHUB_TOKEN'],
+};
+export const GOOGLE_WORKSPACE_MCP_SERVER = {
+    id: 'google-workspace',
+    name: 'Google Workspace',
+    description: 'Google Drive, Gmail, Calendar, and Docs integration',
+    icon: 'mail',
+    emoji: '📧',
+    url: '',
+    command: 'uvx',
+    args: ['workspace-mcp'],
+    transport: 'stdio',
+    enabled: true,
+    isAvailable: false,
+    tools: [],
+    requiredEnvVars: ['GOOGLE_OAUTH_CLIENT_ID', 'GOOGLE_OAUTH_CLIENT_SECRET'],
+};
+export const KAGGLE_MCP_SERVER = {
+    id: 'kaggle',
+    name: 'Kaggle',
+    description: 'Kaggle datasets, models, competitions, and notebooks access',
+    icon: 'database',
+    emoji: '📊',
+    url: '',
+    command: 'npx',
+    args: [
+        '-y',
+        'mcp-remote',
+        'https://www.kaggle.com/mcp',
+        '--header',
+        'Authorization: Bearer ${KAGGLE_TOKEN}',
+    ],
+    transport: 'stdio',
+    enabled: true,
+    isAvailable: false,
+    tools: [],
+    requiredEnvVars: ['KAGGLE_TOKEN'],
+};
+export const SLACK_MCP_SERVER = {
+    id: 'slack',
+    name: 'Slack',
+    description: 'Slack messaging and channel operations',
+    icon: 'comment-discussion',
+    emoji: '💬',
+    url: '',
+    command: 'npx',
+    args: ['-y', '@datalayer/slack-mcp-server'],
+    transport: 'stdio',
+    enabled: true,
+    isAvailable: false,
+    tools: [],
+    requiredEnvVars: ['SLACK_BOT_TOKEN', 'SLACK_TEAM_ID', 'SLACK_CHANNEL_IDS'],
+};
+export const TAVILY_MCP_SERVER = {
+    id: 'tavily',
+    name: 'Tavily Search',
+    description: 'Web search and research capabilities via Tavily API',
+    icon: 'search',
+    emoji: '🔍',
+    url: '',
+    command: 'npx',
+    args: ['-y', 'tavily-mcp'],
+    transport: 'stdio',
+    enabled: true,
+    isAvailable: false,
+    tools: [],
+    requiredEnvVars: ['TAVILY_API_KEY'],
+};
+// ============================================================================
+// MCP Server Library
+// ============================================================================
+export const MCP_SERVER_LIBRARY = {
+    alphavantage: ALPHAVANTAGE_MCP_SERVER,
+    chart: CHART_MCP_SERVER,
+    filesystem: FILESYSTEM_MCP_SERVER,
+    github: GITHUB_MCP_SERVER,
+    'google-workspace': GOOGLE_WORKSPACE_MCP_SERVER,
+    kaggle: KAGGLE_MCP_SERVER,
+    slack: SLACK_MCP_SERVER,
+    tavily: TAVILY_MCP_SERVER,
+};

package/lib/config/skills.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Skill Catalog
+ *
+ * Predefined skill configurations.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+export interface SkillSpec {
+    id: string;
+    name: string;
+    description: string;
+    module: string;
+    requiredEnvVars: string[];
+    optionalEnvVars: string[];
+    dependencies: string[];
+    tags: string[];
+    icon?: string;
+    emoji?: string;
+    enabled: boolean;
+}
+export declare const CRAWL_SKILL_SPEC: SkillSpec;
+export declare const GITHUB_SKILL_SPEC: SkillSpec;
+export declare const PDF_SKILL_SPEC: SkillSpec;
+export declare const SKILL_CATALOG: Record<string, SkillSpec>;
+export declare function getSkillSpecs(): SkillSpec[];
+export declare function getSkillSpec(skillId: string): SkillSpec | undefined;

package/lib/config/skills.js

@@ -0,0 +1,60 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+// ============================================================================
+// Skill Definitions
+// ============================================================================
+export const CRAWL_SKILL_SPEC = {
+    id: 'crawl',
+    name: 'Web Crawl Skill',
+    description: 'Web crawling and content extraction capabilities',
+    module: 'agent_skills.crawl',
+    requiredEnvVars: ['TAVILY_API_KEY'],
+    optionalEnvVars: [],
+    dependencies: ['requests>=2.31.0', 'beautifulsoup4>=4.12.0'],
+    tags: ['web', 'crawl', 'scraping'],
+    icon: 'globe',
+    emoji: '🌐',
+    enabled: true,
+};
+export const GITHUB_SKILL_SPEC = {
+    id: 'github',
+    name: 'GitHub Skill',
+    description: 'GitHub repository management and code operations',
+    module: 'agent_skills.github',
+    requiredEnvVars: ['GITHUB_TOKEN'],
+    optionalEnvVars: [],
+    dependencies: ['PyGithub>=2.1.0'],
+    tags: ['github', 'git', 'code'],
+    icon: 'mark-github',
+    emoji: '🐙',
+    enabled: true,
+};
+export const PDF_SKILL_SPEC = {
+    id: 'pdf',
+    name: 'PDF Processing Skill',
+    description: 'PDF document reading, parsing, and extraction',
+    module: 'agent_skills.pdf',
+    requiredEnvVars: [],
+    optionalEnvVars: [],
+    dependencies: ['PyPDF2>=3.0.0', 'pdfplumber>=0.10.0'],
+    tags: ['pdf', 'documents', 'extraction'],
+    icon: 'file',
+    emoji: '📄',
+    enabled: true,
+};
+// ============================================================================
+// Skill Catalog
+// ============================================================================
+export const SKILL_CATALOG = {
+    crawl: CRAWL_SKILL_SPEC,
+    github: GITHUB_SKILL_SPEC,
+    pdf: PDF_SKILL_SPEC,
+};
+export function getSkillSpecs() {
+    return Object.values(SKILL_CATALOG);
+}
+export function getSkillSpec(skillId) {
+    return SKILL_CATALOG[skillId];
+}

package/lib/{lib → config}/utils.d.ts

@@ -1,2 +1,2 @@
-import { type ClassValue } from "clsx";
+import { type ClassValue } from 'clsx';
 export declare function cn(...inputs: ClassValue[]): string;

package/lib/{lib → config}/utils.js

@@ -2,8 +2,8 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-import clsx from "clsx";
-import { twMerge } from "tailwind-merge";
+import clsx from 'clsx';
+import { twMerge } from 'tailwind-merge';
 export function cn(...inputs) {
     return twMerge(clsx(inputs));
 }

package/lib/examples/AgentRuntimeLexical2Example.d.ts

@@ -27,6 +27,7 @@ import 'prismjs/components/prism-rust';
 import 'prismjs/components/prism-swift';
 import type { ServiceManager } from '@jupyterlab/services';
 import '@datalayer/jupyter-lexical/style/index.css';
+import '@datalayer/jupyter-lexical/style/modal-overrides.css';
 import './lexical/lexical-theme.css';
 /**
  * Chat Lexical Example with Simple integration

package/lib/examples/AgentRuntimeLexical2Example.js

@@ -48,12 +48,13 @@ import { LinkPlugin } from '@lexical/react/LexicalLinkPlugin';
 import { Box } from '@datalayer/primer-addons';
 import { Text } from '@primer/react';
 import { JupyterReactTheme, useJupyter } from '@datalayer/jupyter-react';
-import { ComponentPickerMenuPlugin, JupyterCellPlugin, JupyterInputOutputPlugin, DraggableBlockPlugin, ImagesPlugin, HorizontalRulePlugin, EquationsPlugin, YouTubePlugin, AutoLinkPlugin, AutoEmbedPlugin, FloatingTextFormatToolbarPlugin, CodeActionMenuPlugin, ListMaxIndentLevelPlugin, } from '@datalayer/jupyter-lexical';
+import { ComponentPickerMenuPlugin, JupyterCellPlugin, JupyterInputOutputPlugin, DraggableBlockPlugin, ImagesPlugin, HorizontalRulePlugin, EquationsPlugin, YouTubePlugin, ExcalidrawPlugin, CollapsiblePlugin, AutoLinkPlugin, AutoEmbedPlugin, FloatingTextFormatToolbarPlugin, CodeActionMenuPlugin, ListMaxIndentLevelPlugin, TableCellResizerPlugin, TablePlugin, } from '@datalayer/jupyter-lexical';
 // Import Chat components
 import { ChatFloating, useChatStore, useFrontendTool, DatalayerInferenceProvider, } from '../components/chat';
 import { useLexicalToolActions, ActionRegistrar, } from '../tools/adapters/copilotkit/lexicalHooks';
 import { editorConfig } from './lexical/editorConfig';
 import '@datalayer/jupyter-lexical/style/index.css';
+import '@datalayer/jupyter-lexical/style/modal-overrides.css';
 import './lexical/lexical-theme.css';
 // Fixed lexical document ID
 const LEXICAL_ID = 'chat-popup-lexical-example';
@@ -154,7 +155,7 @@ function LexicalEditor({ serviceManager: _serviceManager, }) {
                             left: '24px',
                             color: 'var(--fgColor-muted)',
                             pointerEvents: 'none',
-                        }, children: "Start typing or click the chat button to open the AI assistant..." }), ErrorBoundary: LexicalErrorBoundary }), _jsx(HistoryPlugin, {}), _jsx(AutoFocusPlugin, {}), _jsx(OnChangePlugin, { onChange: onChange }), _jsx(MarkdownShortcutPlugin, { transformers: TRANSFORMERS }), _jsx(CodeHighlightingPlugin, {}), _jsx(ListPlugin, {}), _jsx(CheckListPlugin, {}), _jsx(LinkPlugin, {}), _jsx(JupyterCellPlugin, {}), _jsx(JupyterInputOutputPlugin, {}), _jsx(ImagesPlugin, {}), _jsx(HorizontalRulePlugin, {}), _jsx(EquationsPlugin, {}), _jsx(YouTubePlugin, {}), _jsx(AutoLinkPlugin, {}), _jsx(AutoEmbedPlugin, {}), _jsx(ListMaxIndentLevelPlugin, { maxDepth: 7 }), floatingAnchorElem && (_jsxs(_Fragment, { children: [_jsx(ComponentPickerMenuPlugin, {}), _jsx(DraggableBlockPlugin, { anchorElem: floatingAnchorElem }), _jsx(FloatingTextFormatToolbarPlugin, { anchorElem: floatingAnchorElem, setIsLinkEditMode: setIsLinkEditMode }), _jsx(CodeActionMenuPlugin, { anchorElem: floatingAnchorElem })] }))] }) }));
+                        }, children: "Start typing or click the chat button to open the AI assistant..." }), ErrorBoundary: LexicalErrorBoundary }), _jsx(HistoryPlugin, {}), _jsx(AutoFocusPlugin, {}), _jsx(OnChangePlugin, { onChange: onChange }), _jsx(MarkdownShortcutPlugin, { transformers: TRANSFORMERS }), _jsx(CodeHighlightingPlugin, {}), _jsx(ListPlugin, {}), _jsx(CheckListPlugin, {}), _jsx(LinkPlugin, {}), _jsx(JupyterCellPlugin, {}), _jsx(JupyterInputOutputPlugin, {}), _jsx(ImagesPlugin, {}), _jsx(HorizontalRulePlugin, {}), _jsx(EquationsPlugin, {}), _jsx(YouTubePlugin, {}), _jsx(ExcalidrawPlugin, {}), _jsx(CollapsiblePlugin, {}), _jsx(AutoLinkPlugin, {}), _jsx(AutoEmbedPlugin, {}), _jsx(TablePlugin, {}), _jsx(TableCellResizerPlugin, {}), _jsx(ListMaxIndentLevelPlugin, { maxDepth: 7 }), floatingAnchorElem && (_jsxs(_Fragment, { children: [_jsx(ComponentPickerMenuPlugin, {}), _jsx(DraggableBlockPlugin, { anchorElem: floatingAnchorElem }), _jsx(FloatingTextFormatToolbarPlugin, { anchorElem: floatingAnchorElem, setIsLinkEditMode: setIsLinkEditMode }), _jsx(CodeActionMenuPlugin, { anchorElem: floatingAnchorElem })] }))] }) }));
 }
 export function ChatLexicalExampleInner({ serviceManager, }) {
     // Chat configuration - set up the inference provider in the store

package/lib/examples/AgentRuntimeLexicalExample.d.ts

@@ -25,6 +25,7 @@ import 'prismjs/components/prism-swift';
 import type { ServiceManager } from '@jupyterlab/services';
 import '@datalayer/jupyter-lexical/style/index.css';
 import './lexical/lexical-theme.css';
+import '@datalayer/jupyter-lexical/style/modal-overrides.css';
 /**
  * Main Agent Runtime lexical example component
  */

package/lib/examples/AgentRuntimeLexicalExample.js

@@ -45,7 +45,7 @@ import { CheckListPlugin } from '@lexical/react/LexicalCheckListPlugin';
 import { LinkPlugin } from '@lexical/react/LexicalLinkPlugin';
 import { Box } from '@datalayer/primer-addons';
 import { JupyterReactTheme, useJupyter } from '@datalayer/jupyter-react';
-import { ComponentPickerMenuPlugin, JupyterCellPlugin, JupyterInputOutputPlugin, DraggableBlockPlugin, ImagesPlugin, HorizontalRulePlugin, EquationsPlugin, YouTubePlugin, AutoLinkPlugin, AutoEmbedPlugin, LexicalConfigProvider, LexicalStatePlugin, CodeActionMenuPlugin, ListMaxIndentLevelPlugin, } from '@datalayer/jupyter-lexical';
+import { ComponentPickerMenuPlugin, JupyterCellPlugin, JupyterInputOutputPlugin, DraggableBlockPlugin, ImagesPlugin, HorizontalRulePlugin, EquationsPlugin, YouTubePlugin, ExcalidrawPlugin, CollapsiblePlugin, AutoLinkPlugin, AutoEmbedPlugin, LexicalConfigProvider, LexicalStatePlugin, FloatingTextFormatToolbarPlugin, CodeActionMenuPlugin, ListMaxIndentLevelPlugin, TableCellResizerPlugin, TablePlugin, } from '@datalayer/jupyter-lexical';
 // Agent-runtimes imports
 import { ChatFloating } from '../components/chat';
 import { ChatInlinePlugin } from '../lexical/ChatInlinePlugin';
@@ -53,12 +53,13 @@ import { useLexicalTools } from '../tools/adapters/agent-runtimes/lexicalHooks';
 import { editorConfig } from './lexical/editorConfig';
 import '@datalayer/jupyter-lexical/style/index.css';
 import './lexical/lexical-theme.css';
+import '@datalayer/jupyter-lexical/style/modal-overrides.css';
 // Fixed lexical document ID
 const LEXICAL_ID = 'agui-lexical-example';
 // Base URL for agent-runtimes server
 const BASE_URL = 'http://localhost:8765';
 const AGENT_ID = 'lexical-agent-runtime-example';
-// AG-UI endpoint for lexical operations
+// AG-UI endpoint for lexical operations (trailing slash required for mounted Starlette apps)
 const AG_UI_ENDPOINT = `${BASE_URL}/api/v1/ag-ui/${AGENT_ID}/`;
 /**
  * Hook to ensure the demo-agent exists on the server.
@@ -185,6 +186,7 @@ function LexicalToolsPlugin({ onToolsReady, }) {
 }
 const LexicalUI = React.memo(function LexicalUI({ content = INITIAL_CONTENT, serviceManager, onToolsReady, }) {
     const [floatingAnchorElem, setFloatingAnchorElem] = useState(null);
+    const [_isLinkEditMode, setIsLinkEditMode] = useState(false);
     const onRef = (_floatingAnchorElem) => {
         if (_floatingAnchorElem !== null) {
             setFloatingAnchorElem(_floatingAnchorElem);
@@ -211,7 +213,7 @@ const LexicalUI = React.memo(function LexicalUI({ content = INITIAL_CONTENT, ser
                     padding: 3,
                     backgroundColor: 'canvas.default',
                     minHeight: '600px',
-                }, children: _jsxs(LexicalConfigProvider, { lexicalId: LEXICAL_ID, serviceManager: serviceManager, children: [_jsx(LexicalToolsPlugin, { onToolsReady: onToolsReady }), _jsx(LexicalComposer, { initialConfig: editorConfig, children: _jsxs("div", { className: "lexical-editor-inner", ref: onRef, children: [_jsx(LexicalStatePlugin, {}), _jsx(RichTextPlugin, { contentEditable: _jsx(ContentEditable, { className: "lexical-editor-content", "aria-label": "Lexical Editor" }), ErrorBoundary: LexicalErrorBoundary }), _jsx(OnChangePlugin, { onChange: handleChange }), _jsx(HistoryPlugin, {}), _jsx(AutoFocusPlugin, {}), _jsx(ListPlugin, {}), _jsx(CheckListPlugin, {}), _jsx(LinkPlugin, {}), _jsx(AutoLinkPlugin, {}), _jsx(ListMaxIndentLevelPlugin, { maxDepth: 7 }), _jsx(MarkdownShortcutPlugin, { transformers: TRANSFORMERS }), _jsx(LoadContentPlugin, { content: content }), _jsx(CodeHighlightPlugin, {}), _jsx(ImagesPlugin, { captionsEnabled: false }), _jsx(HorizontalRulePlugin, {}), _jsx(EquationsPlugin, {}), _jsx(YouTubePlugin, {}), _jsx(AutoEmbedPlugin, {}), _jsx(JupyterCellPlugin, {}), _jsx(JupyterReactTheme, { children: _jsx(SimpleKernelPluginsInner, {}) }), floatingAnchorElem && (_jsxs(_Fragment, { children: [_jsx(DraggableBlockPlugin, { anchorElem: floatingAnchorElem }), _jsx(CodeActionMenuPlugin, { anchorElem: floatingAnchorElem })] })), _jsx(ChatInlinePlugin, { protocol: {
+                }, children: _jsxs(LexicalConfigProvider, { lexicalId: LEXICAL_ID, serviceManager: serviceManager, children: [_jsx(LexicalToolsPlugin, { onToolsReady: onToolsReady }), _jsx(LexicalComposer, { initialConfig: editorConfig, children: _jsxs("div", { className: "lexical-editor-inner", ref: onRef, children: [_jsx(LexicalStatePlugin, {}), _jsx(RichTextPlugin, { contentEditable: _jsx(ContentEditable, { className: "lexical-editor-content", "aria-label": "Lexical Editor" }), ErrorBoundary: LexicalErrorBoundary }), _jsx(OnChangePlugin, { onChange: handleChange }), _jsx(HistoryPlugin, {}), _jsx(AutoFocusPlugin, {}), _jsx(ListPlugin, {}), _jsx(CheckListPlugin, {}), _jsx(LinkPlugin, {}), _jsx(AutoLinkPlugin, {}), _jsx(ListMaxIndentLevelPlugin, { maxDepth: 7 }), _jsx(MarkdownShortcutPlugin, { transformers: TRANSFORMERS }), _jsx(LoadContentPlugin, { content: content }), _jsx(CodeHighlightPlugin, {}), _jsx(ImagesPlugin, { captionsEnabled: false }), _jsx(HorizontalRulePlugin, {}), _jsx(EquationsPlugin, {}), _jsx(YouTubePlugin, {}), _jsx(ExcalidrawPlugin, {}), _jsx(CollapsiblePlugin, {}), _jsx(AutoEmbedPlugin, {}), _jsx(TablePlugin, {}), _jsx(TableCellResizerPlugin, {}), _jsx(JupyterCellPlugin, {}), _jsx(JupyterReactTheme, { children: _jsx(SimpleKernelPluginsInner, {}) }), floatingAnchorElem && (_jsxs(_Fragment, { children: [_jsx(DraggableBlockPlugin, { anchorElem: floatingAnchorElem }), _jsx(FloatingTextFormatToolbarPlugin, { anchorElem: floatingAnchorElem, setIsLinkEditMode: setIsLinkEditMode }), _jsx(CodeActionMenuPlugin, { anchorElem: floatingAnchorElem })] })), _jsx(ChatInlinePlugin, { protocol: {
                                             type: 'ag-ui',
                                             endpoint: AG_UI_ENDPOINT,
                                         } })] }) })] }) })] }));

package/lib/examples/AgentRuntimeLexicalSidebarExample.d.ts

@@ -26,6 +26,7 @@ import 'prismjs/components/prism-rust';
 import 'prismjs/components/prism-swift';
 import type { ServiceManager } from '@jupyterlab/services';
 import '@datalayer/jupyter-lexical/style/index.css';
+import '@datalayer/jupyter-lexical/style/modal-overrides.css';
 import './lexical/lexical-theme.css';
 /**
  * Agent Runtime Lexical Sidebar Example with Simple integration

package/lib/examples/AgentRuntimeLexicalSidebarExample.js

@@ -44,15 +44,15 @@ import { registerCodeHighlighting } from '@lexical/code';
 import { ListPlugin } from '@lexical/react/LexicalListPlugin';
 import { CheckListPlugin } from '@lexical/react/LexicalCheckListPlugin';
 import { LinkPlugin } from '@lexical/react/LexicalLinkPlugin';
-import { TablePlugin } from '@lexical/react/LexicalTablePlugin';
 import { Box } from '@datalayer/primer-addons';
 import { JupyterReactTheme, useJupyter } from '@datalayer/jupyter-react';
-import { ComponentPickerMenuPlugin, JupyterCellPlugin, JupyterInputOutputPlugin, DraggableBlockPlugin, ImagesPlugin, HorizontalRulePlugin, EquationsPlugin, YouTubePlugin, ExcalidrawPlugin, CollapsiblePlugin, AutoLinkPlugin, AutoEmbedPlugin, FloatingTextFormatToolbarPlugin, CodeActionMenuPlugin, ListMaxIndentLevelPlugin, LexicalConfigProvider, LexicalStatePlugin, } from '@datalayer/jupyter-lexical';
+import { ComponentPickerMenuPlugin, JupyterCellPlugin, JupyterInputOutputPlugin, DraggableBlockPlugin, ImagesPlugin, HorizontalRulePlugin, EquationsPlugin, YouTubePlugin, ExcalidrawPlugin, CollapsiblePlugin, AutoLinkPlugin, AutoEmbedPlugin, FloatingTextFormatToolbarPlugin, CodeActionMenuPlugin, ListMaxIndentLevelPlugin, LexicalConfigProvider, LexicalStatePlugin, TableCellResizerPlugin, TablePlugin, } from '@datalayer/jupyter-lexical';
 // Import Chat components
 import { ChatSidebar, } from '../components/chat';
 import { useLexicalTools } from '../tools/adapters/agent-runtimes/lexicalHooks';
 import { editorConfig } from './lexical/editorConfig';
 import '@datalayer/jupyter-lexical/style/index.css';
+import '@datalayer/jupyter-lexical/style/modal-overrides.css';
 import './lexical/lexical-theme.css';
 // Fixed lexical document ID
 const LEXICAL_ID = 'chat-lexical-example';
@@ -98,7 +98,7 @@ function LexicalEditor({ serviceManager }) {
                                     left: '24px',
                                     color: 'var(--fgColor-muted)',
                                     pointerEvents: 'none',
-                                }, children: "Start typing or use the chat to create content..." }), ErrorBoundary: LexicalErrorBoundary }), _jsx(HistoryPlugin, {}), _jsx(AutoFocusPlugin, {}), _jsx(OnChangePlugin, { onChange: onChange }), _jsx(MarkdownShortcutPlugin, { transformers: TRANSFORMERS }), _jsx(CodeHighlightingPlugin, {}), _jsx(ListPlugin, {}), _jsx(CheckListPlugin, {}), _jsx(LinkPlugin, {}), _jsx(TablePlugin, {}), _jsx(JupyterCellPlugin, {}), _jsx(JupyterInputOutputPlugin, {}), _jsx(ImagesPlugin, {}), _jsx(HorizontalRulePlugin, {}), _jsx(EquationsPlugin, {}), _jsx(YouTubePlugin, {}), _jsx(ExcalidrawPlugin, {}), _jsx(CollapsiblePlugin, {}), _jsx(AutoLinkPlugin, {}), _jsx(AutoEmbedPlugin, {}), _jsx(ListMaxIndentLevelPlugin, { maxDepth: 7 }), floatingAnchorElem && (_jsxs(_Fragment, { children: [_jsx(ComponentPickerMenuPlugin, {}), _jsx(DraggableBlockPlugin, { anchorElem: floatingAnchorElem }), _jsx(FloatingTextFormatToolbarPlugin, { anchorElem: floatingAnchorElem, setIsLinkEditMode: setIsLinkEditMode }), _jsx(CodeActionMenuPlugin, { anchorElem: floatingAnchorElem })] }))] })] }) }));
+                                }, children: "Start typing or use the chat to create content..." }), ErrorBoundary: LexicalErrorBoundary }), _jsx(HistoryPlugin, {}), _jsx(AutoFocusPlugin, {}), _jsx(OnChangePlugin, { onChange: onChange }), _jsx(MarkdownShortcutPlugin, { transformers: TRANSFORMERS }), _jsx(CodeHighlightingPlugin, {}), _jsx(ListPlugin, {}), _jsx(CheckListPlugin, {}), _jsx(LinkPlugin, {}), _jsx(TablePlugin, {}), _jsx(TableCellResizerPlugin, {}), _jsx(JupyterCellPlugin, {}), _jsx(JupyterInputOutputPlugin, {}), _jsx(ImagesPlugin, {}), _jsx(HorizontalRulePlugin, {}), _jsx(EquationsPlugin, {}), _jsx(YouTubePlugin, {}), _jsx(ExcalidrawPlugin, {}), _jsx(CollapsiblePlugin, {}), _jsx(AutoLinkPlugin, {}), _jsx(AutoEmbedPlugin, {}), _jsx(ListMaxIndentLevelPlugin, { maxDepth: 7 }), floatingAnchorElem && (_jsxs(_Fragment, { children: [_jsx(ComponentPickerMenuPlugin, {}), _jsx(DraggableBlockPlugin, { anchorElem: floatingAnchorElem }), _jsx(FloatingTextFormatToolbarPlugin, { anchorElem: floatingAnchorElem, setIsLinkEditMode: setIsLinkEditMode }), _jsx(CodeActionMenuPlugin, { anchorElem: floatingAnchorElem })] }))] })] }) }));
 }
 export function ChatLexicalExampleInner({ serviceManager, }) {
     // Get lexical tools for ChatSidebar

package/lib/examples/AgentRuntimeNotebookExample.js

@@ -30,7 +30,7 @@ const NOTEBOOK_CONTENT = MatplotlibNotebook;
 // Base URL for agent-runtimes server
 const BASE_URL = 'http://localhost:8765';
 const AGENT_ID = 'notebook-agent-runtime-example';
-// AG-UI endpoint for notebook operations
+// AG-UI endpoint for notebook operations (trailing slash required for mounted Starlette apps)
 const AG_UI_ENDPOINT = `${BASE_URL}/api/v1/ag-ui/${AGENT_ID}/`;
 /**
  * Hook to ensure the demo-agent exists on the server.

package/lib/examples/AgentSpaceFormExample.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import type { Transport } from '../components/chat';
-import { type AgentLibrary } from './components';
+import { type AgentLibrary, type McpServerSelection } from '../components';
 /**
  * Agent Runtime Example Component
  *
@@ -64,7 +64,7 @@ type AgentSpaceFormExampleProps = {
     initialEnableCodemode?: boolean;
     initialAllowDirectToolCalls?: boolean;
     initialEnableToolReranker?: boolean;
-    initialSelectedMcpServers?: string[];
+    initialSelectedMcpServers?: McpServerSelection[];
     autoSelectMcpServers?: boolean;
     /**
      * Identity providers configuration.