@datalayer/agent-runtimes 0.0.11 → 0.0.12

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/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 };

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

@@ -10,7 +10,7 @@
  */
 import { useMemo } from 'react';
 import { notebookStore, DefaultExecutor, notebookToolDefinitions, notebookToolOperations, } from '@datalayer/jupyter-react';
-import { createAllAgentRuntimesTools, } from './AgentRuntimesToolAdapter';
+import { createAllAgentRuntimesTools } from './AgentRuntimesToolAdapter';
 // Hook wrapper to get notebook store state
 const useNotebookStore = () => notebookStore.getState();
 /**
@@ -19,17 +19,17 @@ const useNotebookStore = () => notebookStore.getState();
  *
  * @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}
  * />
  * ```
  */

package/lib/{types.d.ts → types/Types.d.ts}

@@ -1,3 +1,29 @@
+/**
+ * Status of an agent.
+ */
+export type AgentStatus = 'starting' | 'running' | 'paused' | 'terminated' | 'archived';
+export type Transport = 'acp' | 'ag-ui' | 'vercel-ai' | 'a2a';
+export interface Agent {
+    id: string;
+    name: string;
+    description: string;
+    author: string;
+    lastEdited: string;
+    screenshot: string;
+    status?: AgentStatus;
+    transport: Transport;
+    avatarUrl: string;
+    notebookFile: string;
+    lexicalFile: string;
+    stars: number;
+    notifications: number;
+}
+export type AgentsState = {
+    agents: readonly Agent[];
+    getAgentById: (id: string) => Agent | undefined;
+    updateAgentStatus: (id: string, status: AgentStatus) => void;
+    toggleAgentStatus: (id: string) => void;
+};
 export interface ConversationEntry {
     id: string;
     firstMessage?: string;
@@ -69,10 +95,6 @@ export interface AgentSkillSpec {
     /** 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.
  *
@@ -94,6 +116,8 @@ export interface AgentSpec {
     tags: string[];
     /** Whether the agent is enabled */
     enabled: boolean;
+    /** AI model identifier to use for this agent */
+    model?: string;
     /** MCP servers used by this agent */
     mcpServers: MCPServer[];
     /** Skills available to this agent */
@@ -114,11 +138,13 @@ export interface AgentSpec {
     welcomeNotebook?: string;
     /** Path to Lexical document to show on agent creation */
     welcomeDocument?: string;
+    /** Sandbox variant to use for this agent ('local-eval', 'jupyter', 'local-jupyter') */
+    sandboxVariant?: string;
 }
 /**
  * Configuration for an AI model.
  */
-export interface AIModel {
+export interface AIModelRuntime {
     /** Model identifier (e.g., 'anthropic:claude-sonnet-4-5') */
     id: string;
     /** Display name for the model */
@@ -144,7 +170,7 @@ export interface BuiltinTool {
  */
 export interface FrontendConfig {
     /** Available AI models */
-    models: AIModel[];
+    models: AIModelRuntime[];
     /** Available builtin tools */
     builtinTools: BuiltinTool[];
     /** Configured MCP servers */

package/lib/types/index.d.ts

@@ -1 +1,2 @@
 export * from './AIAgent';
+export * from './Types';

package/lib/types/index.js

@@ -3,3 +3,4 @@
  * Distributed under the terms of the Modified BSD License.
  */
 export * from './AIAgent';
+export * from './Types';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalayer/agent-runtimes",
-  "version": "0.0.11",
+  "version": "0.0.12",
   "type": "module",
   "workspaces": [
     ".",
@@ -67,7 +67,7 @@
     "clean:dist": "rimraf dist",
     "clean:lib": "rimraf lib tsconfig.tsbuildinfo",
     "create:patches": "bash scripts/create-patches.sh",
-    "examples": "run-p server:start examples:vite",
+    "examples": "run-p server:start jupyter:start examples:vite",
     "examples:fresh": "npm run clean:cache && npm run examples",
     "examples:jupyter": "run-p jupyter:start server:start examples:vite",
     "examples:nextjs": "npm run dev --workspace=nextjs-notebook-example",
@@ -94,6 +94,12 @@
     "start:acp": "run-p server:start start:acp:vite",
     "start:acp:prod": "run-p server start:acp:vite",
     "start:acp:vite": "VITE_ACP_WS_URL=ws://localhost:8765/api/v1/acp/ws vite",
+    "start:agent": "run-p server:start start:agent:vite",
+    "start:agent:vite": "vite --open /html/agent.html",
+    "start:agent-notebook": "run-p server:start jupyter:start start:agent-notebook:vite",
+    "start:agent-notebook:vite": "vite --open /html/agent-notebook.html",
+    "start:agent-lexical": "run-p server:start jupyter:start start:agent-lexical:vite",
+    "start:agent-lexical:vite": "vite --open /html/agent-lexical.html",
     "storybook": "storybook dev -p 6006",
     "sync:jupyter": "bash scripts/sync-jupyter.sh",
     "sync:jupyter:watch": "bash scripts/sync-jupyter.sh --watch",
@@ -122,11 +128,11 @@
     "@agentclientprotocol/sdk": "^0.8.0",
     "@ai-sdk/react": "3.0.30",
     "@anthropic-ai/sdk": "^0.52.0",
-    "@datalayer/core": "^0.0.27",
+    "@datalayer/core": "^1.0.1",
     "@datalayer/icons-react": "^1.0.6",
-    "@datalayer/jupyter-lexical": "^1.0.9",
+    "@datalayer/jupyter-lexical": "^1.0.11",
     "@datalayer/jupyter-react": "^2.0.3",
-    "@datalayer/primer-addons": "^1.0.4",
+    "@datalayer/primer-addons": "^1.0.7",
     "@datalayer/primer-rjsf": "^1.0.1",
     "@jupyter-widgets/base-manager": "^1.0.12",
     "@jupyter-widgets/schema": "^0.5.6",