@datalayer/agent-runtimes 0.0.10 → 0.0.11

package/lib/config/agents/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Agent Library - Subfolder Organization.
+ *
+ * THIS FILE IS AUTO-GENERATED. DO NOT EDIT MANUALLY.
+ */
+import type { AgentSpec } from '../../types';
+export declare const AGENT_SPECS: Record<string, AgentSpec>;
+/**
+ * Get an agent specification by ID.
+ */
+export declare function getAgentSpecs(agentId: string): AgentSpec | undefined;
+/**
+ * List all available agent specifications.
+ */
+export declare function listAgentSpecs(): AgentSpec[];
+/**
+ * Collect all required environment variables for an agent spec.
+ */
+export declare function getAgentSpecRequiredEnvVars(spec: AgentSpec): string[];

package/lib/config/agents/index.js

@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { AGENT_SPECS as DATALAYER_AI_AGENTS } from './datalayer-ai';
+// Use only the datalayer-ai agent specs
+export const AGENT_SPECS = {
+    ...DATALAYER_AI_AGENTS,
+};
+/**
+ * Get an agent specification by ID.
+ */
+export function getAgentSpecs(agentId) {
+    return AGENT_SPECS[agentId];
+}
+/**
+ * List all available agent specifications.
+ */
+export function listAgentSpecs() {
+    return Object.values(AGENT_SPECS);
+}
+/**
+ * Collect all required environment variables for an agent spec.
+ */
+export function getAgentSpecRequiredEnvVars(spec) {
+    const vars = new Set();
+    for (const server of spec.mcpServers) {
+        for (const v of server.requiredEnvVars ?? []) {
+            vars.add(v);
+        }
+    }
+    for (const skill of spec.skills) {
+        for (const v of skill.requiredEnvVars ?? []) {
+            vars.add(v);
+        }
+    }
+    return Array.from(vars);
+}

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

@@ -1,3 +1,4 @@
+export * from './envvars';
 export * from './mcpServers';
 export * from './agents';
 export * from './skills';

package/lib/config/index.js

@@ -2,6 +2,7 @@
  * 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';

package/lib/config/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: [
@@ -51,18 +63,21 @@ export const GITHUB_MCP_SERVER = {
         '-i',
         '--rm',
         '-e',
-        'GITHUB_PERSONAL_ACCESS_TOKEN',
+        'GITHUB_TOKEN',
         'ghcr.io/github/github-mcp-server',
     ],
     transport: 'stdio',
     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'],
@@ -75,6 +90,9 @@ export const GOOGLE_WORKSPACE_MCP_SERVER = {
 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 +111,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 +126,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'],

package/lib/config/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/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/examples/AgentSpaceFormExample.js

@@ -16,6 +16,7 @@ import { Chat, useChatStore } from '../components/chat';
 import { useAgentsStore } from './stores/examplesStore';
 import { useIdentity } from '../identity';
 import { MockFileBrowser, MainContent, Header, FooterMetrics, AgentConfiguration, } from '../components';
+import { isSpecSelection, getSpecId } from '../components/AgentConfiguration';
 // Create a query client for React Query
 const queryClient = new QueryClient({
     defaultOptions: {
@@ -335,7 +336,24 @@ githubClientId, kaggleToken, }) => {
     }, [autoSelectMcpServers, enableCodemode, selectedMcpServers, baseUrl]);
     // Track previous MCP servers to detect changes
     const prevMcpServersRef = useRef(selectedMcpServers);
-    const handleAgentSelect = (agentId) => {
+    // Cache for library specs (fetched on-demand, outside QueryClientProvider)
+    const librarySpecsRef = useRef(null);
+    const fetchLibrarySpecs = useCallback(async () => {
+        if (librarySpecsRef.current)
+            return librarySpecsRef.current;
+        try {
+            const response = await fetch(`${baseUrl}/api/v1/agents/library`);
+            if (!response.ok)
+                return [];
+            const data = await response.json();
+            librarySpecsRef.current = data;
+            return data;
+        }
+        catch {
+            return [];
+        }
+    }, [baseUrl]);
+    const handleAgentSelect = async (agentId) => {
         setSelectedAgentId(agentId);
         setCreateError(null);
         if (agentId === 'new-agent') {
@@ -343,6 +361,23 @@ githubClientId, kaggleToken, }) => {
             setAgentName(DEFAULT_AGENT_ID);
             setTransport('ag-ui');
         }
+        else if (isSpecSelection(agentId)) {
+            // Populate form fields from the selected library spec
+            const specId = getSpecId(agentId);
+            const specs = await fetchLibrarySpecs();
+            const spec = specs.find(s => s.id === specId);
+            if (spec) {
+                setAgentName(spec.id);
+                // Keep current transport, model, agentLibrary - user can override
+                if (spec.skills.length > 0) {
+                    setSelectedSkills(spec.skills);
+                    setEnableCodemode(true);
+                }
+                if (spec.systemPromptCodemodeAddons) {
+                    setEnableCodemode(true);
+                }
+            }
+        }
         else {
             const agent = agents.find(a => a.id === agentId);
             if (agent) {
@@ -358,6 +393,10 @@ githubClientId, kaggleToken, }) => {
         setIsCreatingAgent(true);
         setCreateError(null);
         try {
+            // Resolve spec ID if creating from a library spec
+            const specId = isSpecSelection(selectedAgentId)
+                ? getSpecId(selectedAgentId)
+                : undefined;
             const response = await fetch(`${baseUrl}/api/v1/agents`, {
                 method: 'POST',
                 headers: {
@@ -377,6 +416,7 @@ githubClientId, kaggleToken, }) => {
                     selected_mcp_servers: selectedMcpServers,
                     skills: selectedSkills,
                     jupyter_sandbox: useJupyterSandbox ? jupyterSandboxUrl : undefined,
+                    ...(specId ? { agent_spec_id: specId } : {}),
                 }),
             });
             if (!response.ok) {
@@ -412,6 +452,7 @@ githubClientId, kaggleToken, }) => {
         selectedSkills,
         useJupyterSandbox,
         jupyterSandboxUrl,
+        selectedAgentId,
     ]);
     /**
      * Delete an agent via the API
@@ -438,9 +479,11 @@ githubClientId, kaggleToken, }) => {
     useEffect(() => {
         prevMcpServersRef.current = selectedMcpServers;
     }, [selectedMcpServers]);
+    // True when creating a new agent (blank or from a library spec)
+    const isNewMode = selectedAgentId === 'new-agent' || isSpecSelection(selectedAgentId);
     const handleConnect = async () => {
-        // For existing agents (not new-agent), ensure transport and agentName are set
-        if (selectedAgentId !== 'new-agent') {
+        // For existing agents (not new-agent or spec), ensure transport and agentName are set
+        if (!isNewMode) {
             const agent = agents.find(a => a.id === selectedAgentId);
             if (agent) {
                 setTransport(agent.transport);
@@ -477,14 +520,13 @@ githubClientId, kaggleToken, }) => {
     };
     const handleReset = async () => {
         // Delete the agent from the server if we created it
-        if (selectedAgentId === 'new-agent' && agentName) {
+        if ((selectedAgentId === 'new-agent' || isSpecSelection(selectedAgentId)) &&
+            agentName) {
             await deleteAgentOnServer(agentName);
         }
         setIsConfigured(false);
     };
-    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsx(DatalayerThemeProvider, { children: _jsxs(PageLayout, { containerWidth: "full", children: [_jsx(Header, { activeSession: activeSession, agentName: selectedAgentId === 'new-agent' ? undefined : currentAgent?.name, agentDescription: selectedAgentId === 'new-agent'
-                            ? undefined
-                            : currentAgent?.description, agentStatus: currentAgent?.status, showContextTree: showContextTree, isNewAgent: selectedAgentId === 'new-agent', isConfigured: isConfigured, onSessionChange: setActiveSession, onToggleContextTree: () => setShowContextTree(!showContextTree), onToggleStatus: currentAgent
+    return (_jsx(QueryClientProvider, { client: queryClient, children: _jsx(DatalayerThemeProvider, { children: _jsxs(PageLayout, { containerWidth: "full", children: [_jsx(Header, { activeSession: activeSession, agentName: isNewMode ? undefined : currentAgent?.name, agentDescription: isNewMode ? undefined : currentAgent?.description, agentStatus: currentAgent?.status, showContextTree: showContextTree, isNewAgent: isNewMode, isConfigured: isConfigured, onSessionChange: setActiveSession, onToggleContextTree: () => setShowContextTree(!showContextTree), onToggleStatus: currentAgent
                             ? () => toggleAgentStatus(currentAgent.id)
                             : undefined }), leftPaneVisible ? (_jsxs(_Fragment, { children: [_jsx(Box, { sx: {
                                     position: 'fixed',
@@ -498,7 +540,7 @@ githubClientId, kaggleToken, }) => {
                                         border: '1px solid',
                                         borderLeft: 'none',
                                         borderColor: 'border.default',
-                                    } }) }), _jsx(PageLayout.Pane, { position: "start", resizable: true, sticky: true, width: { min: '250px', default: '300px', max: '90px' }, children: selectedAgentId === 'new-agent' ? (_jsxs(Blankslate, { border: true, spacious: true, narrow: true, children: [_jsx(Blankslate.Visual, { children: _jsx(AiAgentIcon, { colored: true, size: 48 }) }), _jsx(Blankslate.Heading, { children: "Agent Runtimes" }), _jsx(Box, { sx: { textAlign: 'center' }, children: _jsx(Blankslate.Description, { children: "Expose AI Agents through multiple protocols." }) })] })) : (_jsx(MockFileBrowser, { codemode: codemode })) })] })) : (_jsx(Box, { sx: {
+                                    } }) }), _jsx(PageLayout.Pane, { position: "start", resizable: true, sticky: true, width: { min: '250px', default: '300px', max: '90px' }, children: isNewMode ? (_jsxs(Blankslate, { border: true, spacious: true, narrow: true, children: [_jsx(Blankslate.Visual, { children: _jsx(AiAgentIcon, { colored: true, size: 48 }) }), _jsx(Blankslate.Heading, { children: "Agent Runtimes" }), _jsx(Box, { sx: { textAlign: 'center' }, children: _jsx(Blankslate.Description, { children: "Expose AI Agents through multiple protocols." }) })] })) : (_jsx(MockFileBrowser, { codemode: codemode })) })] })) : (_jsx(Box, { sx: {
                             position: 'fixed',
                             left: 0,
                             top: '50%',
@@ -510,7 +552,7 @@ githubClientId, kaggleToken, }) => {
                                 border: '1px solid',
                                 borderLeft: 'none',
                                 borderColor: 'border.default',
-                            } }) })), _jsx(PageLayout.Content, { children: _jsx(MainContent, { showNotebook: showNotebook, timeTravel: timeTravel, onTimeTravelChange: setTimeTravel, richEditor: false, notebookFile: currentAgent?.notebookFile, lexicalFile: currentAgent?.lexicalFile, isNewAgent: selectedAgentId === 'new-agent', isConfigured: isConfigured, baseUrl: baseUrl, agentId: currentAgent?.id || agentName, enableCodemode: enableCodemode, selectedMcpServers: selectedMcpServers, onSelectedMcpServersChange: handleSelectedServersChange, onMcpServersChange: () => {
+                            } }) })), _jsx(PageLayout.Content, { children: _jsx(MainContent, { showNotebook: showNotebook, timeTravel: timeTravel, onTimeTravelChange: setTimeTravel, richEditor: false, notebookFile: currentAgent?.notebookFile, lexicalFile: currentAgent?.lexicalFile, isNewAgent: isNewMode, isConfigured: isConfigured, baseUrl: baseUrl, agentId: currentAgent?.id || agentName, enableCodemode: enableCodemode, selectedMcpServers: selectedMcpServers, onSelectedMcpServersChange: handleSelectedServersChange, onMcpServersChange: () => {
                                 // Trigger codemode tool regeneration when MCP servers change at runtime
                                 console.log('[AgentSpaceFormExample] MCP servers changed, regenerating codemode tools...');
                                 // The Chat component will pick up the new selectedMcpServers via props

package/lib/types.d.ts

@@ -24,6 +24,8 @@ export interface MCPServer {
     id: string;
     /** Display name for the server */
     name: string;
+    /** Server description */
+    description?: string;
     /** Server URL (for HTTP-based servers) */
     url: string;
     /** Whether the server is enabled */
@@ -40,6 +42,10 @@ export interface MCPServer {
     transport: 'stdio' | 'http';
     /** Environment variables required by this server (e.g., API keys) */
     requiredEnvVars?: string[];
+    /** Icon identifier for the server */
+    icon?: string;
+    /** Emoji identifier for the server */
+    emoji?: string;
 }
 /**
  * Specification for an agent skill.
@@ -82,8 +88,8 @@ export interface AgentSpec {
     description: string;
     /** System prompt for the agent */
     systemPrompt?: string;
-    /** System prompt when codemode is enabled */
-    systemPromptCodemode?: string;
+    /** System prompt addons when codemode is enabled */
+    systemPromptCodemodeAddons?: string;
     /** Tags for categorization */
     tags: string[];
     /** Whether the agent is enabled */
@@ -96,6 +102,8 @@ export interface AgentSpec {
     environmentName: string;
     /** Icon identifier or URL for the agent */
     icon?: string;
+    /** Emoji identifier for the agent */
+    emoji?: string;
     /** Theme color for the agent (hex code) */
     color?: string;
     /** Chat suggestions to show users what this agent can do */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalayer/agent-runtimes",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "type": "module",
   "workspaces": [
     ".",
@@ -122,7 +122,7 @@
     "@agentclientprotocol/sdk": "^0.8.0",
     "@ai-sdk/react": "3.0.30",
     "@anthropic-ai/sdk": "^0.52.0",
-    "@datalayer/core": "^0.0.25",
+    "@datalayer/core": "^0.0.27",
     "@datalayer/icons-react": "^1.0.6",
     "@datalayer/jupyter-lexical": "^1.0.9",
     "@datalayer/jupyter-react": "^2.0.3",