@datalayer/agent-runtimes 1.0.4 → 1.0.6

package/lib/examples/{ag-ui → components}/weather/index.d.ts

@@ -4,6 +4,6 @@
  * This folder contains weather-specific components that demonstrate
  * inline tool rendering similar to CopilotKit's useCopilotAction pattern.
  *
- * @module examples/ag-ui/weather
+ * @module examples/components/weather
  */
 export { InlineWeatherCard, type InlineWeatherCardProps, type WeatherResult, } from './InlineWeatherCard';

package/lib/examples/{ag-ui → components}/weather/index.js

@@ -8,6 +8,6 @@
  * This folder contains weather-specific components that demonstrate
  * inline tool rendering similar to CopilotKit's useCopilotAction pattern.
  *
- * @module examples/ag-ui/weather
+ * @module examples/components/weather
  */
 export { InlineWeatherCard, } from './InlineWeatherCard';

package/lib/examples/example-selector.d.ts

@@ -1,14 +1,27 @@
+export type ExampleLoader = () => Promise<{
+    default: React.ComponentType;
+}>;
+export interface ExampleEntry {
+    id: string;
+    title: string;
+    description: string;
+    tags: string[];
+    loader: ExampleLoader;
+}
+/**
+ * Central examples registry. Keep all example definitions in this list so
+ * the header dropdown and the home cards always stay in sync.
+ */
+export declare const EXAMPLE_ENTRIES: ExampleEntry[];
 /**
  * Registry of available examples with dynamic imports.
- * Add new examples here to make them available in the example runner.
  */
-export declare const EXAMPLES: Record<string, () => Promise<{
-    default: React.ComponentType;
-}>>;
+export declare const EXAMPLES: Record<string, ExampleLoader>;
 /**
  * Get the list of available example names
  */
 export declare function getExampleNames(): string[];
+export declare function getExampleEntries(): ExampleEntry[];
 /**
  * Get the selected example based on environment variable
  * Falls back to 'NotebookExample' if not specified or invalid

package/lib/examples/example-selector.js

@@ -3,54 +3,121 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /// <reference types="vite/client" />
+const DISPLAY_NAME_EXCEPTIONS = [
+    [/\bAg Ui\b/g, 'AG-UI'],
+    [/\bA2 Ui\b/g, 'A2UI'],
+    [/\bCopilot Kit\b/g, 'CopilotKit'],
+    [/\bGen Ui\b/g, 'Gen UI'],
+    [/\bM C P\b/g, 'MCP'],
+    [/\bOtel\b/g, 'OTEL'],
+    [/\bAgent Specs\b/g, 'Agent Specifications'],
+];
+function humanizeExampleName(name) {
+    let result = name
+        .replace(/Example$/, '')
+        .replace(/([A-Z])/g, ' $1')
+        .replace(/^\s+/, '')
+        .trim();
+    for (const [pattern, replacement] of DISPLAY_NAME_EXCEPTIONS) {
+        result = result.replace(pattern, replacement);
+    }
+    return result;
+}
+function inferTags(id) {
+    const tags = new Set(['example']);
+    if (id.startsWith('Agent'))
+        tags.add('agent');
+    if (id.startsWith('AgUi'))
+        tags.add('ag-ui');
+    if (id.startsWith('A2Ui'))
+        tags.add('a2ui');
+    if (id.includes('Notebook'))
+        tags.add('notebook');
+    if (id.includes('Lexical'))
+        tags.add('lexical');
+    if (id.includes('Chat'))
+        tags.add('chat');
+    if (id.includes('Sandbox'))
+        tags.add('sandbox');
+    if (id.includes('Monitoring') || id.includes('Otel'))
+        tags.add('observability');
+    if (id.includes('Skills'))
+        tags.add('skills');
+    if (id.includes('Subagent'))
+        tags.add('subagents');
+    if (id.includes('MCP'))
+        tags.add('mcp');
+    return Array.from(tags);
+}
+function makeEntry(id, loader, description, tags) {
+    return {
+        id,
+        title: humanizeExampleName(id),
+        description,
+        tags: tags ?? inferTags(id),
+        loader,
+    };
+}
+/**
+ * Central examples registry. Keep all example definitions in this list so
+ * the header dropdown and the home cards always stay in sync.
+ */
+export const EXAMPLE_ENTRIES = [
+    makeEntry('HomeExample', () => import('./HomeExample'), 'Browse all available examples with search and quick navigation.', ['home', 'navigation']),
+    makeEntry('A2UiComponentGalleryExample', () => import('./A2UiComponentGalleryExample'), 'Gallery showcasing A2UI component patterns.'),
+    makeEntry('A2UiContactCardExample', () => import('./A2UiContactCardExample'), 'A2UI example rendering contact card interactions.'),
+    makeEntry('A2UiRestaurantExample', () => import('./A2UiRestaurantExample'), 'A2UI restaurant flow example.'),
+    makeEntry('A2UiViewerExample', () => import('./A2UiViewerExample'), 'A2UI viewer integration example.'),
+    makeEntry('AgUiAgenticExample', () => import('./AgUiAgenticExample'), 'AG-UI agentic workflow example.'),
+    makeEntry('AgUiBackendToolRenderingExample', () => import('./AgUiBackendToolRenderingExample'), 'AG-UI backend tool rendering example.'),
+    makeEntry('AgUiHaikuGenUiExample', () => import('./AgUiHaikuGenUiExample'), 'AG-UI generative UI Haiku example.'),
+    makeEntry('AgUiHumanInTheLoopExample', () => import('./AgUiHumanInTheLoopExample'), 'AG-UI human-in-the-loop approvals example.'),
+    makeEntry('AgUiSharedStateExample', () => import('./AgUiSharedStateExample'), 'AG-UI shared state synchronization example.'),
+    makeEntry('AgUiToolsBasedGenUiExample', () => import('./AgUiToolsBasedGenUiExample'), 'AG-UI tool-based generative UI example.'),
+    makeEntry('AgentspecsExample', () => import('./AgentspecsExample'), 'Configure and run agents from specs and transports.'),
+    makeEntry('CellSimpleExample', () => import('./CellSimpleExample'), 'Simple Jupyter cell integration example.'),
+    makeEntry('ChatCustomExample', () => import('./ChatCustomExample'), 'Custom chat experience composition example.'),
+    makeEntry('ChatExample', () => import('./ChatExample'), 'Baseline chat integration example.'),
+    makeEntry('ChatStandaloneExample', () => import('./ChatStandaloneExample'), 'Standalone chat component usage example.'),
+    makeEntry('CopilotKitLexicalExample', () => import('./CopilotKitLexicalExample'), 'CopilotKit integration with Lexical editor.'),
+    makeEntry('CopilotKitNotebookExample', () => import('./CopilotKitNotebookExample'), 'CopilotKit integration with notebook workflows.'),
+    makeEntry('AgentCheckpointsExample', () => import('./AgentCheckpointsExample'), 'Checkpoint and resume lifecycle for agents.'),
+    makeEntry('AgentCodemodeExample', () => import('./AgentCodemodeExample'), 'Code mode execution and tool orchestration example.'),
+    makeEntry('AgentEvalsExample', () => import('./AgentEvalsExample'), 'Evaluation workflows for agent outputs.'),
+    makeEntry('AgentGuardrailsExample', () => import('./AgentGuardrailsExample'), 'Guardrails and safety checks for agent runs.'),
+    makeEntry('AgentHooksExample', () => import('./AgentHooksExample'), 'Pre-hooks and post-hooks lifecycle execution example.'),
+    makeEntry('AgentInferenceProviderExample', () => import('./AgentInferenceProviderExample'), 'Switch local and datalayer inference providers with live low-level provider events.', ['example', 'agent', 'inference', 'provider', 'runtime']),
+    makeEntry('AgentToolApprovalsExample', () => import('./AgentToolApprovalsExample'), 'Tool approval workflows and manual decisions.'),
+    makeEntry('AgentMemoryExample', () => import('./AgentMemoryExample'), 'Memory-aware conversation and retrieval example.'),
+    makeEntry('AgentSkillsExample', () => import('./AgentSkillsExample'), 'Skills discovery, execution, and monitoring example.'),
+    makeEntry('AgentMCPExample', () => import('./AgentMCPExample'), 'MCP servers and toolset integration example.'),
+    makeEntry('AgentOtelExample', () => import('./AgentOtelExample'), 'OpenTelemetry instrumentation and traces example.'),
+    makeEntry('AgentSandboxExample', () => import('./AgentSandboxExample'), 'Sandbox execution variants and context controls.'),
+    makeEntry('AgentMonitoringExample', () => import('./AgentMonitoringExample'), 'Runtime monitoring and live metrics example.'),
+    makeEntry('AgentSubagentsExample', () => import('./AgentSubagentsExample'), 'Multi-agent delegation with subagents-pydantic-ai.'),
+    makeEntry('AgentNotificationsExample', () => import('./AgentNotificationsExample'), 'Notifications and event routing example.'),
+    makeEntry('AgentOutputsExample', () => import('./AgentOutputsExample'), 'Structured outputs and rendering patterns.'),
+    makeEntry('AgentParametersExample', () => import('./AgentParametersExample'), 'Launch-time parameterized agent creation with JSON schema.'),
+    makeEntry('AgentTriggersExample', () => import('./AgentTriggersExample'), 'Scheduled and one-shot trigger flows.'),
+    makeEntry('LexicalAgentExample', () => import('./LexicalAgentExample'), 'Lexical document integration example.'),
+    makeEntry('LexicalAgentSidebarExample', () => import('./LexicalAgentSidebarExample'), 'Lexical with sidebar orchestration example.'),
+    makeEntry('NotebookAgentExample', () => import('./NotebookAgentExample'), 'Notebook orchestration and runtime example.'),
+    makeEntry('NotebookAgentSidebarExample', () => import('./NotebookAgentSidebarExample'), 'Notebook plus sidebar controls example.'),
+    makeEntry('NotebookExample', () => import('./NotebookExample'), 'Minimal notebook integration example.'),
+    makeEntry('NotebookCollaborationExample', () => import('./NotebookCollaborationExample'), 'Notebook collaboration runtime integration example.'),
+];
 /**
  * Registry of available examples with dynamic imports.
- * Add new examples here to make them available in the example runner.
  */
-export const EXAMPLES = {
-    //  Lexical2Example: () => import('./Lexical2Example'),
-    A2UiComponentGalleryExample: () => import('./A2UiComponentGalleryExample'),
-    A2UiContactCardExample: () => import('./A2UiContactCardExample'),
-    A2UiRestaurantExample: () => import('./A2UiRestaurantExample'),
-    A2UiViewerExample: () => import('./A2UiViewerExample'),
-    AgUiAgenticExample: () => import('./AgUiAgenticExample'),
-    AgUiBackendToolRenderingExample: () => import('./AgUiBackendToolRenderingExample'),
-    AgUiHaikuGenUiExample: () => import('./AgUiHaikuGenUiExample'),
-    AgUiHumanInTheLoopExample: () => import('./AgUiHumanInTheLoopExample'),
-    AgUiSharedStateExample: () => import('./AgUiSharedStateExample'),
-    AgUiToolsBasedGenUiExample: () => import('./AgUiToolsBasedGenUiExample'),
-    AgentspecExample: () => import('./AgentspecExample'),
-    CellSimpleExample: () => import('./CellSimpleExample'),
-    ChatCustomExample: () => import('./ChatCustomExample'),
-    ChatExample: () => import('./ChatExample'),
-    ChatStandaloneExample: () => import('./ChatStandaloneExample'),
-    CopilotKitLexicalExample: () => import('./CopilotKitLexicalExample'),
-    CopilotKitNotebookExample: () => import('./CopilotKitNotebookExample'),
-    DatalayerNotebookExample: () => import('./DatalayerNotebookExample'),
-    AgentCheckpointsExample: () => import('./AgentCheckpointsExample'),
-    AgentCodemodeExample: () => import('./AgentCodemodeExample'),
-    AgentEvalsExample: () => import('./AgentEvalsExample'),
-    AgentGuardrailsExample: () => import('./AgentGuardrailsExample'),
-    AgentToolApprovalsExample: () => import('./AgentToolApprovalsExample'),
-    AgentMemoryExample: () => import('./AgentMemoryExample'),
-    AgentSkillsExample: () => import('./AgentSkillsExample'),
-    AgentOtelExample: () => import('./AgentOtelExample'),
-    AgentSandboxExample: () => import('./AgentSandboxExample'),
-    AgentMonitoringExample: () => import('./AgentMonitoringExample'),
-    AgentNotificationsExample: () => import('./AgentNotificationsExample'),
-    AgentOutputsExample: () => import('./AgentOutputsExample'),
-    AgentTriggersExample: () => import('./AgentTriggersExample'),
-    LexicalExample: () => import('./LexicalExample'),
-    LexicalSidebarExample: () => import('./LexicalSidebarExample'),
-    NotebookExample: () => import('./NotebookExample'),
-    NotebookSidebarExample: () => import('./NotebookSidebarExample'),
-    NotebookSimpleExample: () => import('./NotebookSimpleExample'),
-};
+export const EXAMPLES = Object.fromEntries(EXAMPLE_ENTRIES.map(entry => [entry.id, entry.loader]));
 /**
  * Get the list of available example names
  */
 export function getExampleNames() {
-    return Object.keys(EXAMPLES);
+    return EXAMPLE_ENTRIES.map(entry => entry.id);
+}
+export function getExampleEntries() {
+    return [...EXAMPLE_ENTRIES];
 }
 /**
  * Get the selected example based on environment variable

package/lib/examples/index.d.ts

@@ -1,4 +1,4 @@
-export { default as AgentspecExample } from './AgentspecExample';
+export { default as AgentspecsExample } from './AgentspecsExample';
 export { default as A2UiComponentGalleryExample } from './A2UiComponentGalleryExample';
 export { default as A2UiContactCardExample } from './A2UiContactCardExample';
 export { default as A2UiRestaurantExample } from './A2UiRestaurantExample';
@@ -14,21 +14,25 @@ export { default as ChatStandaloneExample } from './ChatStandaloneExample';
 export { default as CopilotKitLexicalExample } from './CopilotKitLexicalExample';
 export { default as CopilotKitNotebookExample } from './CopilotKitNotebookExample';
 export { default as CustomExample } from './ChatCustomExample';
-export { default as DatalayerNotebookExample } from './DatalayerNotebookExample';
+export { default as NotebookCollaborationExample } from './NotebookCollaborationExample';
 export { default as AgentCheckpointsExample } from './AgentCheckpointsExample';
 export { default as AgentCodemodeExample } from './AgentCodemodeExample';
 export { default as AgentEvalsExample } from './AgentEvalsExample';
 export { default as AgentGuardrailsExample } from './AgentGuardrailsExample';
+export { default as AgentHooksExample } from './AgentHooksExample';
+export { default as AgentInferenceProviderExample } from './AgentInferenceProviderExample';
 export { default as AgentToolApprovalsExample } from './AgentToolApprovalsExample';
 export { default as AgentMemoryExample } from './AgentMemoryExample';
 export { default as AgentOtelExample } from './AgentOtelExample';
+export { default as AgentMCPExample } from './AgentMCPExample';
 export { default as AgentMonitoringExample } from './AgentMonitoringExample';
 export { default as AgentNotificationsExample } from './AgentNotificationsExample';
 export { default as AgentOutputsExample } from './AgentOutputsExample';
+export { default as AgentParametersExample } from './AgentParametersExample';
 export { default as AgentTriggersExample } from './AgentTriggersExample';
 export { default as Lexical2Example } from './Lexical2Example';
-export { default as LexicalExample } from './LexicalExample';
-export { default as LexicalSidebarExample } from './LexicalSidebarExample';
+export { default as LexicalAgentExample } from './LexicalAgentExample';
+export { default as LexicalAgentSidebarExample } from './LexicalAgentSidebarExample';
+export { default as NotebookAgentExample } from './NotebookAgentExample';
+export { default as NotebookAgentSidebarExample } from './NotebookAgentSidebarExample';
 export { default as NotebookExample } from './NotebookExample';
-export { default as NotebookSidebarExample } from './NotebookSidebarExample';
-export { default as NotebookSimpleExample } from './NotebookSimpleExample';

package/lib/examples/index.js

@@ -2,7 +2,7 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-export { default as AgentspecExample } from './AgentspecExample';
+export { default as AgentspecsExample } from './AgentspecsExample';
 export { default as A2UiComponentGalleryExample } from './A2UiComponentGalleryExample';
 export { default as A2UiContactCardExample } from './A2UiContactCardExample';
 export { default as A2UiRestaurantExample } from './A2UiRestaurantExample';
@@ -18,21 +18,25 @@ export { default as ChatStandaloneExample } from './ChatStandaloneExample';
 export { default as CopilotKitLexicalExample } from './CopilotKitLexicalExample';
 export { default as CopilotKitNotebookExample } from './CopilotKitNotebookExample';
 export { default as CustomExample } from './ChatCustomExample';
-export { default as DatalayerNotebookExample } from './DatalayerNotebookExample';
+export { default as NotebookCollaborationExample } from './NotebookCollaborationExample';
 export { default as AgentCheckpointsExample } from './AgentCheckpointsExample';
 export { default as AgentCodemodeExample } from './AgentCodemodeExample';
 export { default as AgentEvalsExample } from './AgentEvalsExample';
 export { default as AgentGuardrailsExample } from './AgentGuardrailsExample';
+export { default as AgentHooksExample } from './AgentHooksExample';
+export { default as AgentInferenceProviderExample } from './AgentInferenceProviderExample';
 export { default as AgentToolApprovalsExample } from './AgentToolApprovalsExample';
 export { default as AgentMemoryExample } from './AgentMemoryExample';
 export { default as AgentOtelExample } from './AgentOtelExample';
+export { default as AgentMCPExample } from './AgentMCPExample';
 export { default as AgentMonitoringExample } from './AgentMonitoringExample';
 export { default as AgentNotificationsExample } from './AgentNotificationsExample';
 export { default as AgentOutputsExample } from './AgentOutputsExample';
+export { default as AgentParametersExample } from './AgentParametersExample';
 export { default as AgentTriggersExample } from './AgentTriggersExample';
 export { default as Lexical2Example } from './Lexical2Example';
-export { default as LexicalExample } from './LexicalExample';
-export { default as LexicalSidebarExample } from './LexicalSidebarExample';
+export { default as LexicalAgentExample } from './LexicalAgentExample';
+export { default as LexicalAgentSidebarExample } from './LexicalAgentSidebarExample';
+export { default as NotebookAgentExample } from './NotebookAgentExample';
+export { default as NotebookAgentSidebarExample } from './NotebookAgentSidebarExample';
 export { default as NotebookExample } from './NotebookExample';
-export { default as NotebookSidebarExample } from './NotebookSidebarExample';
-export { default as NotebookSimpleExample } from './NotebookSimpleExample';

package/lib/examples/lexical/initial-content.json

@@ -1605,7 +1605,7 @@
                                 "type": "jupyter-input",
                                 "version": 1,
                                 "language": "python",
-                                "jupyterInputNodeUuid": "collapsible-demo-uuid"
+                                "jupyterInputNodeUuid": "collapsible-example-uuid"
                             },
                             {
                                 "format": "",
@@ -1619,8 +1619,8 @@
                                         "output_type": "stream"
                                     }
                                 ],
-                                "jupyterInputNodeUuid": "collapsible-demo-uuid",
-                                "jupyterOutputNodeUuid": "collapsible-demo-output-uuid"
+                                "jupyterInputNodeUuid": "collapsible-example-uuid",
+                                "jupyterOutputNodeUuid": "collapsible-example-output-uuid"
                             }
                         ],
                         "direction": "ltr",
@@ -2074,7 +2074,7 @@
                 "type": "jupyter-input",
                 "version": 1,
                 "language": "python",
-                "jupyterInputNodeUuid": "plot-demo-uuid"
+                "jupyterInputNodeUuid": "plot-example-uuid"
             },
             {
                 "format": "",
@@ -2091,8 +2091,8 @@
                         "output_type": "execute_result"
                     }
                 ],
-                "jupyterInputNodeUuid": "plot-demo-uuid",
-                "jupyterOutputNodeUuid": "plot-demo-output-uuid"
+                "jupyterInputNodeUuid": "plot-example-uuid",
+                "jupyterOutputNodeUuid": "plot-example-output-uuid"
             },
             {
                 "type": "horizontalrule",