@datalayer/agent-runtimes 0.0.9 → 0.0.10

package/lib/hooks/useAGUI.d.ts

@@ -33,7 +33,7 @@ export interface UseAGUIOptions {
  * Hook to manage chat state with AG-UI protocol.
  *
  * This hook provides an interface to the AG-UI protocol endpoint
- * at /api/v1/ag-ui/{agent_id}/ which is powered by Pydantic AI's
+ * at /api/v1/ag-ui/{agent_id}/ (trailing slash required) which is powered by Pydantic AI's
  * native AGUIApp. The AG-UI protocol accepts POST requests with
  * prompts and streams back agent responses.
  *

package/lib/hooks/useAGUI.js

@@ -7,7 +7,7 @@ import { useCallback, useEffect, useState } from 'react';
  * Hook to manage chat state with AG-UI protocol.
  *
  * This hook provides an interface to the AG-UI protocol endpoint
- * at /api/v1/ag-ui/{agent_id}/ which is powered by Pydantic AI's
+ * at /api/v1/ag-ui/{agent_id}/ (trailing slash required) which is powered by Pydantic AI's
  * native AGUIApp. The AG-UI protocol accepts POST requests with
  * prompts and streams back agent responses.
  *

package/lib/identity/types.d.ts

@@ -226,7 +226,7 @@ export interface TokenProviderConfig {
     displayName: string;
     /** Icon URL */
     iconUrl?: string;
-    /** Profile URL template (use {username} placeholder) */
+    /** Profile URL template (use `{username}` placeholder) */
     profileUrlTemplate?: string;
     /** User info endpoint (called with Bearer token) */
     userInfoUrl?: string;

package/lib/index.d.ts

@@ -2,3 +2,5 @@ export * from './components';
 export * from './state';
 export * from './runtime';
 export * from './identity';
+export * from './config';
+export type { ConversationEntry, MCPServer, AgentSkillSpec, AgentSpec, AIModel, FrontendConfig, BuiltinTool, MCPServerTool, } from './types';

package/lib/index.js

@@ -6,3 +6,4 @@ export * from './components';
 export * from './state';
 export * from './runtime';
 export * from './identity';
+export * from './config';

package/lib/runtime/index.d.ts

@@ -28,8 +28,11 @@
  * ```
  */
 export { useRuntimeStore, useRuntime, useAgent, useRuntimeStatus, useRuntimeError, useIsLaunching, getRuntimeState, subscribeToRuntime, } from './runtimeStore';
+export type { RuntimeStore, RuntimeStoreState, RuntimeStoreActions, } from './runtimeStore';
 export { useAgentConnection } from './useAgentConnection';
+export type { UseAgentConnectionReturn, UseAgentConnectionOptions, } from './useAgentConnection';
 export { useAgentRuntime } from './useAgentRuntime';
+export type { UseAgentRuntimeReturn, UseAgentRuntimeOptions, } from './useAgentRuntime';
 export type { IRuntimeLocation, IRuntimeType, IRuntimeCapabilities, IRuntimePod, IRuntimeOptions, IRuntimeDesc, } from './types';
 export type { RuntimeConnection, AgentRuntimeStatus as RuntimeStatus, AgentConfig, AgentConnection, AgentRuntimeState, } from './types';
 export { DEFAULT_AGENT_CONFIG } from './types';

package/lib/runtime/runtimeStore.d.ts

@@ -3,7 +3,7 @@ import type { IRuntimeOptions, RuntimeConnection, AgentRuntimeStatus, AgentConfi
 /**
  * Runtime store state interface.
  */
-interface RuntimeStoreState {
+export interface RuntimeStoreState {
     /** Current runtime connection */
     runtime: RuntimeConnection | null;
     /** Current agent connection */
@@ -18,7 +18,7 @@ interface RuntimeStoreState {
 /**
  * Runtime store actions interface.
  */
-interface RuntimeStoreActions {
+export interface RuntimeStoreActions {
     /** Launch a new runtime */
     launchRuntime: (options: IRuntimeOptions) => Promise<RuntimeConnection>;
     /** Connect to an existing runtime */
@@ -39,7 +39,7 @@ interface RuntimeStoreActions {
     /** Reset store to initial state */
     reset: () => void;
 }
-type RuntimeStore = RuntimeStoreState & RuntimeStoreActions;
+export type RuntimeStore = RuntimeStoreState & RuntimeStoreActions;
 /**
  * Zustand store for runtime management.
  *
@@ -74,4 +74,3 @@ export declare const getRuntimeState: () => RuntimeStore;
  * Subscribe to runtime store changes (for use outside React).
  */
 export declare const subscribeToRuntime: (listener: (state: RuntimeStore, prevState: RuntimeStore) => void) => () => void;
-export {};

package/lib/runtime/useAgentConnection.d.ts

@@ -1,11 +1,11 @@
 import type { AgentConfig, AgentConnection } from './types';
-interface UseAgentConnectionOptions {
+export interface UseAgentConnectionOptions {
     /** Agent configuration */
     config?: AgentConfig;
     /** Auto-create agent when runtime is ready */
     autoCreate?: boolean;
 }
-interface UseAgentConnectionReturn {
+export interface UseAgentConnectionReturn {
     /** Current agent connection */
     agent: AgentConnection | null;
     /** Whether the agent is ready */
@@ -43,4 +43,3 @@ interface UseAgentConnectionReturn {
  * ```
  */
 export declare function useAgentConnection(options?: UseAgentConnectionOptions): UseAgentConnectionReturn;
-export {};

package/lib/runtime/useAgentRuntime.d.ts

@@ -1,12 +1,12 @@
 import type { ServiceManager } from '@jupyterlab/services';
 import type { IRuntimeOptions, AgentConfig, RuntimeConnection, AgentConnection, AgentRuntimeStatus } from './types';
-interface UseAgentRuntimeOptions {
+export interface UseAgentRuntimeOptions {
     /** Agent configuration */
     agentConfig?: AgentConfig;
     /** Auto-create agent when runtime connects */
     autoCreateAgent?: boolean;
 }
-interface UseAgentRuntimeReturn {
+export interface UseAgentRuntimeReturn {
     /** Current runtime connection */
     runtime: RuntimeConnection | null;
     /** Current agent connection */
@@ -91,4 +91,3 @@ interface UseAgentRuntimeReturn {
  * ```
  */
 export declare function useAgentRuntime(options?: UseAgentRuntimeOptions): UseAgentRuntimeReturn;
-export {};

package/lib/stories/Cell.stories.js

@@ -78,7 +78,7 @@ class ConfettiWidget(ipyreact.ReactWidget):
             CLICK here for some CONFETTIS
           </button>
           <h2>You have {value || 0} wishe{ (value > 1) && 's' } so far...</h2>
-          <quote>Powered by Ξ Datalayer</quote>
+          <quote>Powered by ☰ Datalayer</quote>
         </>
       )
     };"""

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

@@ -37,6 +37,7 @@ export function useNotebookTools(documentId, contextOverrides) {
     const notebookStoreState = useNotebookStore();
     // Create DefaultExecutor (stable reference)
     // Only recreate when documentId changes, not on every state update
+    // TODO Revisit - Cast to satisfy index signature requirement for dynamic method lookup
     const executor = useMemo(() => new DefaultExecutor(documentId, notebookStoreState), [documentId]);
     // Create stable context object with useMemo
     // Defaults: format='toon' for conversational AI responses

package/lib/tools/adapters/copilotkit/notebookHooks.js

@@ -41,6 +41,7 @@ export function useNotebookToolActions(documentId, contextOverrides) {
     // Create DefaultExecutor (stable reference)
     // Only recreate when documentId changes, not on every state update
     // The executor holds a reference to the store which is always current
+    // TODO: Revisit - Cast to satisfy index signature requirement for dynamic method lookup
     const executor = useMemo(() => new DefaultExecutor(documentId, notebookStore), [documentId]);
     // Create stable context object with useMemo
     // Defaults: format='toon' for conversational AI responses

package/lib/types.d.ts

@@ -3,3 +3,153 @@ export interface ConversationEntry {
     firstMessage?: string;
     timestamp: number;
 }
+/**
+ * A tool provided by an MCP server.
+ */
+export interface MCPServerTool {
+    /** Tool name/identifier */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** Whether the tool is enabled */
+    enabled: boolean;
+    /** JSON schema for tool input parameters */
+    inputSchema?: Record<string, unknown>;
+}
+/**
+ * Configuration for an MCP server.
+ */
+export interface MCPServer {
+    /** Unique server identifier */
+    id: string;
+    /** Display name for the server */
+    name: string;
+    /** Server URL (for HTTP-based servers) */
+    url: string;
+    /** Whether the server is enabled */
+    enabled: boolean;
+    /** List of available tools */
+    tools: MCPServerTool[];
+    /** Command to run the MCP server (e.g., 'npx', 'uvx') */
+    command?: string;
+    /** Command arguments for the MCP server */
+    args: string[];
+    /** Whether the server is available (based on tool discovery) */
+    isAvailable: boolean;
+    /** Transport type: 'stdio' or 'http' */
+    transport: 'stdio' | 'http';
+    /** Environment variables required by this server (e.g., API keys) */
+    requiredEnvVars?: string[];
+}
+/**
+ * Specification for an agent skill.
+ *
+ * Simplified version of the full Skill type from agent-skills,
+ * containing only the fields needed for agent specification.
+ */
+export interface AgentSkillSpec {
+    /** Unique skill identifier */
+    id: string;
+    /** Display name for the skill */
+    name: string;
+    /** Skill description */
+    description: string;
+    /** Skill version */
+    version: string;
+    /** Tags for categorization */
+    tags: string[];
+    /** Whether the skill is enabled */
+    enabled: boolean;
+    /** Environment variables required by this skill (e.g., API keys) */
+    requiredEnvVars?: string[];
+}
+/**
+ * Status of an agent space.
+ */
+export type AgentStatus = 'starting' | 'running' | 'paused' | 'terminated' | 'archived';
+/**
+ * Specification for an AI agent.
+ *
+ * Defines the configuration for a reusable agent template that can be
+ * instantiated as an AgentSpace.
+ */
+export interface AgentSpec {
+    /** Unique agent identifier */
+    id: string;
+    /** Display name for the agent */
+    name: string;
+    /** Agent description */
+    description: string;
+    /** System prompt for the agent */
+    systemPrompt?: string;
+    /** System prompt when codemode is enabled */
+    systemPromptCodemode?: string;
+    /** Tags for categorization */
+    tags: string[];
+    /** Whether the agent is enabled */
+    enabled: boolean;
+    /** MCP servers used by this agent */
+    mcpServers: MCPServer[];
+    /** Skills available to this agent */
+    skills: AgentSkillSpec[];
+    /** Runtime environment name for this agent */
+    environmentName: string;
+    /** Icon identifier or URL for the agent */
+    icon?: string;
+    /** Theme color for the agent (hex code) */
+    color?: string;
+    /** Chat suggestions to show users what this agent can do */
+    suggestions?: string[];
+    /** Welcome message shown when agent starts */
+    welcomeMessage?: string;
+    /** Path to Jupyter notebook to show on agent creation */
+    welcomeNotebook?: string;
+    /** Path to Lexical document to show on agent creation */
+    welcomeDocument?: string;
+}
+/**
+ * Configuration for an AI model.
+ */
+export interface AIModel {
+    /** Model identifier (e.g., 'anthropic:claude-sonnet-4-5') */
+    id: string;
+    /** Display name for the model */
+    name: string;
+    /** List of builtin tool IDs */
+    builtinTools: string[];
+    /** Required environment variables for this model */
+    requiredEnvVars: string[];
+    /** Whether the model is available (based on env vars) */
+    isAvailable: boolean;
+}
+/**
+ * Configuration for a builtin tool.
+ */
+export interface BuiltinTool {
+    /** Tool identifier */
+    id: string;
+    /** Display name for the tool */
+    name: string;
+}
+/**
+ * Configuration returned to frontend.
+ */
+export interface FrontendConfig {
+    /** Available AI models */
+    models: AIModel[];
+    /** Available builtin tools */
+    builtinTools: BuiltinTool[];
+    /** Configured MCP servers */
+    mcpServers: MCPServer[];
+}
+/**
+ * Configuration for connecting to an agent runtime.
+ */
+export interface AgentRuntimeConfig {
+    /** URL of the agent runtime server */
+    url: string;
+    /** Optional agent ID to connect to */
+    agentId?: string;
+    /** Optional authentication token */
+    authToken?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalayer/agent-runtimes",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "type": "module",
   "workspaces": [
     ".",
@@ -69,7 +69,7 @@
     "create:patches": "bash scripts/create-patches.sh",
     "examples": "run-p server:start examples:vite",
     "examples:fresh": "npm run clean:cache && npm run examples",
-    "examples:codemode-mcp": "EXAMPLE=AgentCodemodeMcpExample VITE_APP_TARGET=examples VITE_DATALAYER_RUN_URL=http://localhost:8888 vite",
+    "examples:jupyter": "run-p jupyter:start server:start examples:vite",
     "examples:nextjs": "npm run dev --workspace=nextjs-notebook-example",
     "examples:vite": "VITE_APP_TARGET=examples VITE_DATALAYER_RUN_URL=http://localhost:8888 vite",
     "format": "prettier --write \"src/**/*.{js,jsx,ts,tsx,css,json,md}\" \"examples/**/*.{js,jsx,ts,tsx,css,json,md,mjs}\"",
@@ -88,9 +88,8 @@
     "prepare": "husky",
     "preview": "vite preview",
     "rebuild:fresh": "npm run create:patches && npm install && npm run build && npm run clean:cache",
-    "server": "python -m agent_runtimes",
-    "server:start": "PYTHONIOENCODING=utf-8 python -m agent_runtimes --port 8765 --reload --debug",
-    "showcase:vercel-ai-elements": "VITE_APP_TARGET=showcase-vercel-ai-elements vite",
+    "server": "python -m agent_runtimes serve",
+    "server:start": "PYTHONIOENCODING=utf-8 python -m agent_runtimes serve --port 8765 --debug",
     "start": "vite",
     "start:acp": "run-p server:start start:acp:vite",
     "start:acp:prod": "run-p server start:acp:vite",

package/scripts/apply-patches.sh

@@ -40,7 +40,7 @@ for patch_file in patches/*.patch; do
     filename=$(basename "$patch_file")
     # Handle scoped packages: @datalayer+jupyter-lexical+1.0.8.patch -> @datalayer/jupyter-lexical
     pkg_name=$(echo "$filename" | sed 's/+/\//; s/+.*//')
-    
+
     if [ ! -d "node_modules/$pkg_name" ]; then
       echo -e "${YELLOW}⚠️  Package $pkg_name not found in local node_modules (may be hoisted in monorepo)${NC}"
       MISSING_PACKAGES=true