@datalayer/agent-runtimes 0.0.10 → 0.0.12

package/lib/{config → specs}/mcpServers.js

@@ -8,6 +8,9 @@
 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}'],
@@ -20,6 +23,9 @@ export const ALPHAVANTAGE_MCP_SERVER = {
 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'],
@@ -32,6 +38,9 @@ export const CHART_MCP_SERVER = {
 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'],
@@ -44,6 +53,9 @@ export const FILESYSTEM_MCP_SERVER = {
 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: [
@@ -58,11 +70,14 @@ export const GITHUB_MCP_SERVER = {
     enabled: true,
     isAvailable: false,
     tools: [],
-    requiredEnvVars: ['GITHUB_PERSONAL_ACCESS_TOKEN'],
+    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'],
@@ -72,9 +87,33 @@ export const GOOGLE_WORKSPACE_MCP_SERVER = {
     tools: [],
     requiredEnvVars: ['GOOGLE_OAUTH_CLIENT_ID', 'GOOGLE_OAUTH_CLIENT_SECRET'],
 };
+export const HUGGINGFACE_MCP_SERVER = {
+    id: 'huggingface',
+    name: 'Hugging Face',
+    description: 'Hugging Face models, datasets, spaces, and papers access',
+    icon: 'brain',
+    emoji: '🤗',
+    url: '',
+    command: 'npx',
+    args: [
+        '-y',
+        'mcp-remote',
+        'https://huggingface.co/mcp',
+        '--header',
+        'Authorization: Bearer ${HF_TOKEN}',
+    ],
+    transport: 'stdio',
+    enabled: true,
+    isAvailable: false,
+    tools: [],
+    requiredEnvVars: ['HF_TOKEN'],
+};
 export const KAGGLE_MCP_SERVER = {
     id: 'kaggle',
     name: 'Kaggle',
+    description: 'Kaggle datasets, models, competitions, and notebooks access',
+    icon: 'database',
+    emoji: '📊',
     url: '',
     command: 'npx',
     args: [
@@ -93,6 +132,9 @@ export const KAGGLE_MCP_SERVER = {
 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'],
@@ -105,6 +147,9 @@ export const SLACK_MCP_SERVER = {
 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'],
@@ -123,6 +168,7 @@ export const MCP_SERVER_LIBRARY = {
     filesystem: FILESYSTEM_MCP_SERVER,
     github: GITHUB_MCP_SERVER,
     'google-workspace': GOOGLE_WORKSPACE_MCP_SERVER,
+    huggingface: HUGGINGFACE_MCP_SERVER,
     kaggle: KAGGLE_MCP_SERVER,
     slack: SLACK_MCP_SERVER,
     tavily: TAVILY_MCP_SERVER,

package/lib/specs/models.d.ts

@@ -0,0 +1,68 @@
+/**
+ * AI Model Catalog
+ *
+ * Predefined AI model configurations.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+export interface AIModel {
+    /** Unique model identifier (e.g., 'anthropic:claude-sonnet-4-5-20250514') */
+    id: string;
+    /** Display name for the model */
+    name: string;
+    /** Model description */
+    description: string;
+    /** Provider name (anthropic, openai, bedrock, azure-openai) */
+    provider: string;
+    /** Whether this is the default model */
+    default: boolean;
+    /** Required environment variable names */
+    requiredEnvVars: string[];
+}
+export declare const AIModels: {
+    readonly ANTHROPIC_CLAUDE_3_5_HAIKU_20241022: "anthropic:claude-3-5-haiku-20241022";
+    readonly ANTHROPIC_CLAUDE_OPUS_4_20250514: "anthropic:claude-opus-4-20250514";
+    readonly ANTHROPIC_CLAUDE_SONNET_4_5_20250514: "anthropic:claude-sonnet-4-5-20250514";
+    readonly ANTHROPIC_CLAUDE_SONNET_4_20250514: "anthropic:claude-sonnet-4-20250514";
+    readonly AZURE_OPENAI_GPT_4_1_MINI: "azure-openai:gpt-4.1-mini";
+    readonly AZURE_OPENAI_GPT_4_1_NANO: "azure-openai:gpt-4.1-nano";
+    readonly AZURE_OPENAI_GPT_4_1: "azure-openai:gpt-4.1";
+    readonly AZURE_OPENAI_GPT_4O_MINI: "azure-openai:gpt-4o-mini";
+    readonly AZURE_OPENAI_GPT_4O: "azure-openai:gpt-4o";
+    readonly BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0: "bedrock:us.anthropic.claude-3-5-haiku-20241022-v1:0";
+    readonly BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1_0: "bedrock:us.anthropic.claude-opus-4-6-v1:0";
+    readonly BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0: "bedrock:us.anthropic.claude-opus-4-20250514-v1:0";
+    readonly BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0: "bedrock:us.anthropic.claude-sonnet-4-5-20250929-v1:0";
+    readonly BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0: "bedrock:us.anthropic.claude-sonnet-4-20250514-v1:0";
+    readonly OPENAI_GPT_4_1_MINI: "openai:gpt-4.1-mini";
+    readonly OPENAI_GPT_4_1_NANO: "openai:gpt-4.1-nano";
+    readonly OPENAI_GPT_4_1: "openai:gpt-4.1";
+    readonly OPENAI_GPT_4O_MINI: "openai:gpt-4o-mini";
+    readonly OPENAI_GPT_4O: "openai:gpt-4o";
+    readonly OPENAI_O3_MINI: "openai:o3-mini";
+};
+export type AIModelId = (typeof AIModels)[keyof typeof AIModels];
+export declare const ANTHROPIC_CLAUDE_3_5_HAIKU_20241022: AIModel;
+export declare const ANTHROPIC_CLAUDE_OPUS_4_20250514: AIModel;
+export declare const ANTHROPIC_CLAUDE_SONNET_4_5_20250514: AIModel;
+export declare const ANTHROPIC_CLAUDE_SONNET_4_20250514: AIModel;
+export declare const AZURE_OPENAI_GPT_4_1_MINI: AIModel;
+export declare const AZURE_OPENAI_GPT_4_1_NANO: AIModel;
+export declare const AZURE_OPENAI_GPT_4_1: AIModel;
+export declare const AZURE_OPENAI_GPT_4O_MINI: AIModel;
+export declare const AZURE_OPENAI_GPT_4O: AIModel;
+export declare const BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0: AIModel;
+export declare const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1_0: AIModel;
+export declare const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0: AIModel;
+export declare const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0: AIModel;
+export declare const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0: AIModel;
+export declare const OPENAI_GPT_4_1_MINI: AIModel;
+export declare const OPENAI_GPT_4_1_NANO: AIModel;
+export declare const OPENAI_GPT_4_1: AIModel;
+export declare const OPENAI_GPT_4O_MINI: AIModel;
+export declare const OPENAI_GPT_4O: AIModel;
+export declare const OPENAI_O3_MINI: AIModel;
+export declare const AI_MODEL_CATALOGUE: Record<string, AIModel>;
+export declare const DEFAULT_MODEL: AIModelId;
+export declare const DEFAULT_MODEL_SPEC: AIModel;

package/lib/specs/models.js

@@ -0,0 +1,239 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+// ============================================================================
+// AIModels Enum
+// ============================================================================
+export const AIModels = {
+    ANTHROPIC_CLAUDE_3_5_HAIKU_20241022: 'anthropic:claude-3-5-haiku-20241022',
+    ANTHROPIC_CLAUDE_OPUS_4_20250514: 'anthropic:claude-opus-4-20250514',
+    ANTHROPIC_CLAUDE_SONNET_4_5_20250514: 'anthropic:claude-sonnet-4-5-20250514',
+    ANTHROPIC_CLAUDE_SONNET_4_20250514: 'anthropic:claude-sonnet-4-20250514',
+    AZURE_OPENAI_GPT_4_1_MINI: 'azure-openai:gpt-4.1-mini',
+    AZURE_OPENAI_GPT_4_1_NANO: 'azure-openai:gpt-4.1-nano',
+    AZURE_OPENAI_GPT_4_1: 'azure-openai:gpt-4.1',
+    AZURE_OPENAI_GPT_4O_MINI: 'azure-openai:gpt-4o-mini',
+    AZURE_OPENAI_GPT_4O: 'azure-openai:gpt-4o',
+    BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0: 'bedrock:us.anthropic.claude-3-5-haiku-20241022-v1:0',
+    BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1_0: 'bedrock:us.anthropic.claude-opus-4-6-v1:0',
+    BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0: 'bedrock:us.anthropic.claude-opus-4-20250514-v1:0',
+    BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0: 'bedrock:us.anthropic.claude-sonnet-4-5-20250929-v1:0',
+    BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0: 'bedrock:us.anthropic.claude-sonnet-4-20250514-v1:0',
+    OPENAI_GPT_4_1_MINI: 'openai:gpt-4.1-mini',
+    OPENAI_GPT_4_1_NANO: 'openai:gpt-4.1-nano',
+    OPENAI_GPT_4_1: 'openai:gpt-4.1',
+    OPENAI_GPT_4O_MINI: 'openai:gpt-4o-mini',
+    OPENAI_GPT_4O: 'openai:gpt-4o',
+    OPENAI_O3_MINI: 'openai:o3-mini',
+};
+// ============================================================================
+// AI Model Definitions
+// ============================================================================
+export const ANTHROPIC_CLAUDE_3_5_HAIKU_20241022 = {
+    id: 'anthropic:claude-3-5-haiku-20241022',
+    name: 'Anthropic Claude Haiku 3.5',
+    description: 'Claude Haiku 3.5 by Anthropic - fast and efficient',
+    provider: 'anthropic',
+    default: false,
+    requiredEnvVars: ['ANTHROPIC_API_KEY'],
+};
+export const ANTHROPIC_CLAUDE_OPUS_4_20250514 = {
+    id: 'anthropic:claude-opus-4-20250514',
+    name: 'Anthropic Claude Opus 4',
+    description: 'Claude Opus 4 by Anthropic - highest capability model',
+    provider: 'anthropic',
+    default: false,
+    requiredEnvVars: ['ANTHROPIC_API_KEY'],
+};
+export const ANTHROPIC_CLAUDE_SONNET_4_5_20250514 = {
+    id: 'anthropic:claude-sonnet-4-5-20250514',
+    name: 'Anthropic Claude Sonnet 4.5',
+    description: 'Claude Sonnet 4.5 by Anthropic - balanced performance and speed',
+    provider: 'anthropic',
+    default: false,
+    requiredEnvVars: ['ANTHROPIC_API_KEY'],
+};
+export const ANTHROPIC_CLAUDE_SONNET_4_20250514 = {
+    id: 'anthropic:claude-sonnet-4-20250514',
+    name: 'Anthropic Claude Sonnet 4',
+    description: 'Claude Sonnet 4 by Anthropic - strong reasoning and coding',
+    provider: 'anthropic',
+    default: false,
+    requiredEnvVars: ['ANTHROPIC_API_KEY'],
+};
+export const AZURE_OPENAI_GPT_4_1_MINI = {
+    id: 'azure-openai:gpt-4.1-mini',
+    name: 'Azure OpenAI GPT-4.1 Mini',
+    description: 'GPT-4.1 Mini via Azure OpenAI - compact version',
+    provider: 'azure-openai',
+    default: false,
+    requiredEnvVars: ['AZURE_OPENAI_API_KEY', 'AZURE_OPENAI_ENDPOINT'],
+};
+export const AZURE_OPENAI_GPT_4_1_NANO = {
+    id: 'azure-openai:gpt-4.1-nano',
+    name: 'Azure OpenAI GPT-4.1 Nano',
+    description: 'GPT-4.1 Nano via Azure OpenAI - smallest and fastest',
+    provider: 'azure-openai',
+    default: false,
+    requiredEnvVars: ['AZURE_OPENAI_API_KEY', 'AZURE_OPENAI_ENDPOINT'],
+};
+export const AZURE_OPENAI_GPT_4_1 = {
+    id: 'azure-openai:gpt-4.1',
+    name: 'Azure OpenAI GPT-4.1',
+    description: 'GPT-4.1 via Azure OpenAI - strong general purpose',
+    provider: 'azure-openai',
+    default: false,
+    requiredEnvVars: ['AZURE_OPENAI_API_KEY', 'AZURE_OPENAI_ENDPOINT'],
+};
+export const AZURE_OPENAI_GPT_4O_MINI = {
+    id: 'azure-openai:gpt-4o-mini',
+    name: 'Azure OpenAI GPT-4o Mini',
+    description: 'GPT-4o Mini via Azure OpenAI - compact enterprise deployment',
+    provider: 'azure-openai',
+    default: false,
+    requiredEnvVars: ['AZURE_OPENAI_API_KEY', 'AZURE_OPENAI_ENDPOINT'],
+};
+export const AZURE_OPENAI_GPT_4O = {
+    id: 'azure-openai:gpt-4o',
+    name: 'Azure OpenAI GPT-4o',
+    description: 'GPT-4o via Azure OpenAI - enterprise deployment',
+    provider: 'azure-openai',
+    default: false,
+    requiredEnvVars: ['AZURE_OPENAI_API_KEY', 'AZURE_OPENAI_ENDPOINT'],
+};
+export const BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0 = {
+    id: 'bedrock:us.anthropic.claude-3-5-haiku-20241022-v1:0',
+    name: 'Bedrock Claude Haiku 3.5',
+    description: 'Claude Haiku 3.5 via AWS Bedrock - fast and efficient',
+    provider: 'bedrock',
+    default: false,
+    requiredEnvVars: [
+        'AWS_ACCESS_KEY_ID',
+        'AWS_SECRET_ACCESS_KEY',
+        'AWS_DEFAULT_REGION',
+    ],
+};
+export const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1_0 = {
+    id: 'bedrock:us.anthropic.claude-opus-4-6-v1:0',
+    name: 'Bedrock Claude Opus 4.6',
+    description: 'Claude Opus 4.6 via AWS Bedrock - latest flagship model',
+    provider: 'bedrock',
+    default: false,
+    requiredEnvVars: [
+        'AWS_ACCESS_KEY_ID',
+        'AWS_SECRET_ACCESS_KEY',
+        'AWS_DEFAULT_REGION',
+    ],
+};
+export const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0 = {
+    id: 'bedrock:us.anthropic.claude-opus-4-20250514-v1:0',
+    name: 'Bedrock Claude Opus 4',
+    description: 'Claude Opus 4 via AWS Bedrock - highest capability',
+    provider: 'bedrock',
+    default: false,
+    requiredEnvVars: [
+        'AWS_ACCESS_KEY_ID',
+        'AWS_SECRET_ACCESS_KEY',
+        'AWS_DEFAULT_REGION',
+    ],
+};
+export const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0 = {
+    id: 'bedrock:us.anthropic.claude-sonnet-4-5-20250929-v1:0',
+    name: 'Bedrock Claude Sonnet 4.5',
+    description: 'Claude Sonnet 4.5 via AWS Bedrock - balanced performance',
+    provider: 'bedrock',
+    default: true,
+    requiredEnvVars: [
+        'AWS_ACCESS_KEY_ID',
+        'AWS_SECRET_ACCESS_KEY',
+        'AWS_DEFAULT_REGION',
+    ],
+};
+export const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0 = {
+    id: 'bedrock:us.anthropic.claude-sonnet-4-20250514-v1:0',
+    name: 'Bedrock Claude Sonnet 4',
+    description: 'Claude Sonnet 4 via AWS Bedrock - strong reasoning',
+    provider: 'bedrock',
+    default: false,
+    requiredEnvVars: [
+        'AWS_ACCESS_KEY_ID',
+        'AWS_SECRET_ACCESS_KEY',
+        'AWS_DEFAULT_REGION',
+    ],
+};
+export const OPENAI_GPT_4_1_MINI = {
+    id: 'openai:gpt-4.1-mini',
+    name: 'OpenAI GPT-4.1 Mini',
+    description: 'GPT-4.1 Mini by OpenAI - compact version of GPT-4.1',
+    provider: 'openai',
+    default: false,
+    requiredEnvVars: ['OPENAI_API_KEY'],
+};
+export const OPENAI_GPT_4_1_NANO = {
+    id: 'openai:gpt-4.1-nano',
+    name: 'OpenAI GPT-4.1 Nano',
+    description: 'GPT-4.1 Nano by OpenAI - smallest and fastest',
+    provider: 'openai',
+    default: false,
+    requiredEnvVars: ['OPENAI_API_KEY'],
+};
+export const OPENAI_GPT_4_1 = {
+    id: 'openai:gpt-4.1',
+    name: 'OpenAI GPT-4.1',
+    description: 'GPT-4.1 by OpenAI - strong general purpose model',
+    provider: 'openai',
+    default: false,
+    requiredEnvVars: ['OPENAI_API_KEY'],
+};
+export const OPENAI_GPT_4O_MINI = {
+    id: 'openai:gpt-4o-mini',
+    name: 'OpenAI GPT-4o Mini',
+    description: 'GPT-4o Mini by OpenAI - compact and cost-effective',
+    provider: 'openai',
+    default: false,
+    requiredEnvVars: ['OPENAI_API_KEY'],
+};
+export const OPENAI_GPT_4O = {
+    id: 'openai:gpt-4o',
+    name: 'OpenAI GPT-4o',
+    description: 'GPT-4o by OpenAI - fast multimodal model',
+    provider: 'openai',
+    default: false,
+    requiredEnvVars: ['OPENAI_API_KEY'],
+};
+export const OPENAI_O3_MINI = {
+    id: 'openai:o3-mini',
+    name: 'OpenAI o3 Mini',
+    description: 'o3 Mini by OpenAI - reasoning-focused compact model',
+    provider: 'openai',
+    default: false,
+    requiredEnvVars: ['OPENAI_API_KEY'],
+};
+// ============================================================================
+// AI Model Catalog
+// ============================================================================
+export const AI_MODEL_CATALOGUE = {
+    'anthropic:claude-3-5-haiku-20241022': ANTHROPIC_CLAUDE_3_5_HAIKU_20241022,
+    'anthropic:claude-opus-4-20250514': ANTHROPIC_CLAUDE_OPUS_4_20250514,
+    'anthropic:claude-sonnet-4-5-20250514': ANTHROPIC_CLAUDE_SONNET_4_5_20250514,
+    'anthropic:claude-sonnet-4-20250514': ANTHROPIC_CLAUDE_SONNET_4_20250514,
+    'azure-openai:gpt-4.1-mini': AZURE_OPENAI_GPT_4_1_MINI,
+    'azure-openai:gpt-4.1-nano': AZURE_OPENAI_GPT_4_1_NANO,
+    'azure-openai:gpt-4.1': AZURE_OPENAI_GPT_4_1,
+    'azure-openai:gpt-4o-mini': AZURE_OPENAI_GPT_4O_MINI,
+    'azure-openai:gpt-4o': AZURE_OPENAI_GPT_4O,
+    'bedrock:us.anthropic.claude-3-5-haiku-20241022-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0,
+    'bedrock:us.anthropic.claude-opus-4-6-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1_0,
+    'bedrock:us.anthropic.claude-opus-4-20250514-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0,
+    'bedrock:us.anthropic.claude-sonnet-4-5-20250929-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0,
+    'bedrock:us.anthropic.claude-sonnet-4-20250514-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0,
+    'openai:gpt-4.1-mini': OPENAI_GPT_4_1_MINI,
+    'openai:gpt-4.1-nano': OPENAI_GPT_4_1_NANO,
+    'openai:gpt-4.1': OPENAI_GPT_4_1,
+    'openai:gpt-4o-mini': OPENAI_GPT_4O_MINI,
+    'openai:gpt-4o': OPENAI_GPT_4O,
+    'openai:o3-mini': OPENAI_O3_MINI,
+};
+export const DEFAULT_MODEL = AIModels.BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0;
+export const DEFAULT_MODEL_SPEC = BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0;

package/lib/{config → specs}/skills.d.ts

@@ -15,6 +15,8 @@ export interface SkillSpec {
     optionalEnvVars: string[];
     dependencies: string[];
     tags: string[];
+    icon?: string;
+    emoji?: string;
     enabled: boolean;
 }
 export declare const CRAWL_SKILL_SPEC: SkillSpec;

package/lib/{config → specs}/skills.js

@@ -14,6 +14,8 @@ export const CRAWL_SKILL_SPEC = {
     optionalEnvVars: [],
     dependencies: ['requests>=2.31.0', 'beautifulsoup4>=4.12.0'],
     tags: ['web', 'crawl', 'scraping'],
+    icon: 'globe',
+    emoji: '🌐',
     enabled: true,
 };
 export const GITHUB_SKILL_SPEC = {
@@ -25,6 +27,8 @@ export const GITHUB_SKILL_SPEC = {
     optionalEnvVars: [],
     dependencies: ['PyGithub>=2.1.0'],
     tags: ['github', 'git', 'code'],
+    icon: 'mark-github',
+    emoji: '🐙',
     enabled: true,
 };
 export const PDF_SKILL_SPEC = {
@@ -36,6 +40,8 @@ export const PDF_SKILL_SPEC = {
     optionalEnvVars: [],
     dependencies: ['PyPDF2>=3.0.0', 'pdfplumber>=0.10.0'],
     tags: ['pdf', 'documents', 'extraction'],
+    icon: 'file',
+    emoji: '📄',
     enabled: true,
 };
 // ============================================================================

package/lib/state/substates/AIAgentState.d.ts

@@ -1,6 +1,5 @@
 import type { Transport } from '../../components/chat/components/Chat';
 export type AgentStatus = 'running' | 'paused' | 'initializing' | 'error';
-export type { Transport };
 /**
  * Unified Agent model combining runtime tracking and UI state
  */

package/lib/tools/adapters/agent-runtimes/AgentRuntimesToolAdapter.d.ts

@@ -1,40 +1,29 @@
 /**
- * Converts unified tool definitions to agent-runtimes ChatFloating tools format.
+ * Converts unified tool definitions to FrontendToolDefinition format
+ * for use with Chat, ChatFloating, and ChatBase components.
  *
- * This adapter enables integration with the ChatFloating component's built-in
- * tool handling via the AG-UI protocol.
+ * This adapter enables integration with the chat components' frontendTools prop
+ * via the AG-UI protocol.
  *
  * @module tools/adapters/agent-runtimes/AgentRuntimesToolAdapter
  */
 import type { ToolDefinition, ToolOperation, ToolExecutionContext } from '@datalayer/jupyter-react';
+import type { FrontendToolDefinition } from '../../../components/chat/types/tool';
 /**
- * Agent-runtimes tool definition (matches ChatFloating tools prop)
- */
-export interface AgentRuntimesTool {
-    /** Tool name */
-    name: string;
-    /** Description for AI model */
-    description: string;
-    /** Parameters (JSON Schema format) */
-    parameters?: Record<string, unknown>;
-    /** Handler function */
-    handler: (args: unknown) => Promise<unknown>;
-}
-/**
- * Converts unified tool definition to agent-runtimes tool format
+ * Converts unified tool definition to FrontendToolDefinition format
  *
  * @param definition - Tool definition
  * @param operation - Core operation
  * @param context - Execution context (documentId + executor)
- * @returns Agent-runtimes tool
+ * @returns FrontendToolDefinition
  */
-export declare function createAgentRuntimesTool(definition: ToolDefinition, operation: ToolOperation<unknown, unknown>, context: ToolExecutionContext): AgentRuntimesTool;
+export declare function createAgentRuntimesTool(definition: ToolDefinition, operation: ToolOperation<unknown, unknown>, context: ToolExecutionContext): FrontendToolDefinition;
 /**
- * Creates agent-runtimes tools from all tool definitions
+ * Creates FrontendToolDefinition[] from all tool definitions
  *
  * @param definitions - Tool definitions
  * @param operations - Core operations registry
  * @param context - Execution context (documentId + executor)
- * @returns Agent-runtimes tools array
+ * @returns FrontendToolDefinition array
  */
-export declare function createAllAgentRuntimesTools(definitions: ToolDefinition[], operations: Record<string, ToolOperation<unknown, unknown>>, context: ToolExecutionContext): AgentRuntimesTool[];
+export declare function createAllAgentRuntimesTools(definitions: ToolDefinition[], operations: Record<string, ToolOperation<unknown, unknown>>, context: ToolExecutionContext): FrontendToolDefinition[];

package/lib/tools/adapters/agent-runtimes/AgentRuntimesToolAdapter.js

@@ -67,12 +67,12 @@ function processParameters(params) {
     return processed;
 }
 /**
- * Converts unified tool definition to agent-runtimes tool format
+ * Converts unified tool definition to FrontendToolDefinition format
  *
  * @param definition - Tool definition
  * @param operation - Core operation
  * @param context - Execution context (documentId + executor)
- * @returns Agent-runtimes tool
+ * @returns FrontendToolDefinition
  */
 export function createAgentRuntimesTool(definition, operation, context) {
     // Create runner instance for this tool
@@ -118,12 +118,12 @@ export function createAgentRuntimesTool(definition, operation, context) {
     };
 }
 /**
- * Creates agent-runtimes tools from all tool definitions
+ * Creates FrontendToolDefinition[] from all tool definitions
  *
  * @param definitions - Tool definitions
  * @param operations - Core operations registry
  * @param context - Execution context (documentId + executor)
- * @returns Agent-runtimes tools array
+ * @returns FrontendToolDefinition array
  */
 export function createAllAgentRuntimesTools(definitions, operations, context) {
     const tools = [];
@@ -136,6 +136,6 @@ export function createAllAgentRuntimesTools(definitions, operations, context) {
         const tool = createAgentRuntimesTool(definition, operation, context);
         tools.push(tool);
     }
-    console.log(`[agent-runtimes Tools] Created ${tools.length} agent-runtimes tools`);
+    console.log(`[agent-runtimes Tools] Created ${tools.length} frontend tools`);
     return tools;
 }

package/lib/tools/adapters/agent-runtimes/lexicalHooks.d.ts

@@ -5,26 +5,26 @@
  * @module tools/adapters/agent-runtimes/lexicalHooks
  */
 import type { ToolExecutionContext } from '@datalayer/jupyter-react';
-import { type AgentRuntimesTool } from './AgentRuntimesToolAdapter';
+import type { FrontendToolDefinition } from '../../../components/chat/types/tool';
 /**
  * Hook that creates agent-runtimes tools for lexical operations.
  * Returns stable tools array that won't cause re-renders.
  *
  * @param documentId - Document ID (lexical document identifier)
  * @param contextOverrides - Optional context overrides (format, extras, etc.)
- * @returns Agent-runtimes tools array for ChatFloating
+ * @returns Frontend tools array for ChatFloating / Chat
  *
  * @example
  * ```typescript
  * // Default context (toon format for AI)
- * const tools = useLexicalTools("doc-123");
+ * const frontendTools = useLexicalTools("doc-123");
  *
  * // Use with ChatFloating
  * <ChatFloating
  *   endpoint="http://localhost:8765/api/v1/ag-ui/agent/"
- *   tools={tools}
+ *   frontendTools={frontendTools}
  * />
  * ```
  */
-export declare function useLexicalTools(documentId: string, contextOverrides?: Partial<Omit<ToolExecutionContext, 'executor' | 'documentId'>>): AgentRuntimesTool[];
-export type { AgentRuntimesTool };
+export declare function useLexicalTools(documentId: string, contextOverrides?: Partial<Omit<ToolExecutionContext, 'executor' | 'documentId'>>): FrontendToolDefinition[];
+export type { FrontendToolDefinition };

package/lib/tools/adapters/agent-runtimes/lexicalHooks.js

@@ -3,24 +3,24 @@
  * Distributed under the terms of the Modified BSD License.
  */
 import { useLexicalStore, DefaultExecutor as LexicalDefaultExecutor, lexicalToolDefinitions, lexicalToolOperations, } from '@datalayer/jupyter-lexical';
-import { createAllAgentRuntimesTools, } from './AgentRuntimesToolAdapter';
+import { createAllAgentRuntimesTools } from './AgentRuntimesToolAdapter';
 /**
  * Hook that creates agent-runtimes tools for lexical operations.
  * Returns stable tools array that won't cause re-renders.
  *
  * @param documentId - Document ID (lexical document identifier)
  * @param contextOverrides - Optional context overrides (format, extras, etc.)
- * @returns Agent-runtimes tools array for ChatFloating
+ * @returns Frontend tools array for ChatFloating / Chat
  *
  * @example
  * ```typescript
  * // Default context (toon format for AI)
- * const tools = useLexicalTools("doc-123");
+ * const frontendTools = useLexicalTools("doc-123");
  *
  * // Use with ChatFloating
  * <ChatFloating
  *   endpoint="http://localhost:8765/api/v1/ag-ui/agent/"
- *   tools={tools}
+ *   frontendTools={frontendTools}
  * />
  * ```
  */

package/lib/tools/adapters/agent-runtimes/notebookHooks.d.ts

@@ -1,24 +1,24 @@
 import type { ToolExecutionContext } from '@datalayer/jupyter-react';
-import { type AgentRuntimesTool } from './AgentRuntimesToolAdapter';
+import type { FrontendToolDefinition } from '../../../components/chat/types/tool';
 /**
  * Hook that creates agent-runtimes tools for notebook operations.
  * Returns stable tools array that won't cause re-renders.
  *
  * @param documentId - Document ID (notebook identifier)
  * @param contextOverrides - Optional context overrides (format, extras, etc.)
- * @returns Agent-runtimes tools array for ChatFloating
+ * @returns Frontend tools array for ChatFloating / Chat
  *
  * @example
  * ```typescript
  * // Default context (toon format for AI)
- * const tools = useNotebookTools("my-notebook-id");
+ * const frontendTools = useNotebookTools("my-notebook-id");
  *
  * // Use with ChatFloating
  * <ChatFloating
  *   endpoint="http://localhost:8765/api/v1/ag-ui/agent/"
- *   tools={tools}
+ *   frontendTools={frontendTools}
  * />
  * ```
  */
-export declare function useNotebookTools(documentId: string, contextOverrides?: Partial<Omit<ToolExecutionContext, 'executor' | 'documentId'>>): AgentRuntimesTool[];
-export type { AgentRuntimesTool };
+export declare function useNotebookTools(documentId: string, contextOverrides?: Partial<Omit<ToolExecutionContext, 'executor' | 'documentId'>>): FrontendToolDefinition[];
+export type { FrontendToolDefinition };