@datalayer/agent-runtimes 1.0.1 → 1.0.3

package/lib/specs/tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Tool Catalog
+ *
+ * Predefined runtime tools that can be attached to agents.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { ToolSpec } from '../types';
+export declare const RUNTIME_ECHO_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const RUNTIME_SEND_MAIL_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const RUNTIME_SENSITIVE_ECHO_TOOL_SPEC_0_0_1: ToolSpec;
+export declare const TOOL_CATALOG: Record<string, ToolSpec>;
+export declare function getToolSpecs(): ToolSpec[];
+export declare function getToolSpec(toolId: string): ToolSpec | undefined;

package/lib/specs/tools.js

@@ -0,0 +1,83 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+// ============================================================================
+// Tool Definitions
+// ============================================================================
+export const RUNTIME_ECHO_TOOL_SPEC_0_0_1 = {
+    id: 'runtime-echo',
+    version: '0.0.1',
+    name: 'Runtime Echo',
+    description: 'Echo text back to the caller for quick runtime verification.',
+    tags: ['runtime', 'utility'],
+    enabled: true,
+    approval: 'auto',
+    requiresApproval: false,
+    runtime: {
+        language: 'python',
+        package: 'agent_runtimes.examples.tools',
+        method: 'runtime_echo',
+    },
+    icon: 'comment',
+    emoji: '💬',
+};
+export const RUNTIME_SEND_MAIL_TOOL_SPEC_0_0_1 = {
+    id: 'runtime-send-mail',
+    version: '0.0.1',
+    name: 'Runtime Send Mail (Fake)',
+    description: 'Fake mail sender for tool approval demos; returns a simulated send receipt.',
+    tags: ['runtime', 'approval', 'mail'],
+    enabled: true,
+    approval: 'manual',
+    requiresApproval: true,
+    runtime: {
+        language: 'python',
+        package: 'agent_runtimes.examples.tools',
+        method: 'runtime_send_mail',
+    },
+    icon: 'mail',
+    emoji: '📧',
+};
+export const RUNTIME_SENSITIVE_ECHO_TOOL_SPEC_0_0_1 = {
+    id: 'runtime-sensitive-echo',
+    version: '0.0.1',
+    name: 'Runtime Sensitive Echo',
+    description: 'Echo text with a manual approval checkpoint before execution.',
+    tags: ['runtime', 'approval'],
+    enabled: true,
+    approval: 'manual',
+    requiresApproval: true,
+    runtime: {
+        language: 'python',
+        package: 'agent_runtimes.examples.tools',
+        method: 'runtime_sensitive_echo',
+    },
+    icon: 'shield',
+    emoji: '🛡️',
+};
+// ============================================================================
+// Tool Catalog
+// ============================================================================
+export const TOOL_CATALOG = {
+    'runtime-echo': RUNTIME_ECHO_TOOL_SPEC_0_0_1,
+    'runtime-send-mail': RUNTIME_SEND_MAIL_TOOL_SPEC_0_0_1,
+    'runtime-sensitive-echo': RUNTIME_SENSITIVE_ECHO_TOOL_SPEC_0_0_1,
+};
+export function getToolSpecs() {
+    return Object.values(TOOL_CATALOG);
+}
+function resolveToolId(toolId) {
+    if (toolId in TOOL_CATALOG)
+        return toolId;
+    const idx = toolId.lastIndexOf(':');
+    if (idx > 0) {
+        const base = toolId.slice(0, idx);
+        if (base in TOOL_CATALOG)
+            return base;
+    }
+    return toolId;
+}
+export function getToolSpec(toolId) {
+    return TOOL_CATALOG[resolveToolId(toolId)];
+}

package/lib/specs/triggers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Trigger Catalog
+ *
+ * Predefined trigger type configurations.
+ *
+ * This file is AUTO-GENERATED from YAML specifications.
+ * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
+ */
+import type { TriggerSpec } from '../types';
+export declare const EVENT_TRIGGER_SPEC_0_0_1: TriggerSpec;
+export declare const ONCE_TRIGGER_SPEC_0_0_1: TriggerSpec;
+export declare const SCHEDULE_TRIGGER_SPEC_0_0_1: TriggerSpec;
+export declare const TRIGGER_CATALOG: Record<string, TriggerSpec>;
+export declare function getTriggerSpecs(): TriggerSpec[];
+export declare function getTriggerSpec(triggerId: string): TriggerSpec | undefined;

package/lib/specs/triggers.js

@@ -0,0 +1,117 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+// ============================================================================
+// Trigger Definitions
+// ============================================================================
+export const EVENT_TRIGGER_SPEC_0_0_1 = {
+    id: 'event',
+    version: '0.0.1',
+    name: 'Event-Based',
+    description: 'Trigger on specific events such as a webhook call, API request, database change, file upload, or email arrival.',
+    type: 'event',
+    fields: [
+        {
+            name: 'event_source',
+            label: 'Event Source URL',
+            type: 'string',
+            required: false,
+            placeholder: 'https://helpdesk.example.com/webhooks',
+            help: 'Allowed event source URL (leave empty to allow any source)',
+        },
+        {
+            name: 'event',
+            label: 'Event Name',
+            type: 'string',
+            required: false,
+            placeholder: 'email_received',
+        },
+        {
+            name: 'description',
+            label: 'Description',
+            type: 'string',
+            required: false,
+            placeholder: "Description (e.g. 'Triggered on incoming email')",
+        },
+        {
+            name: 'prompt',
+            label: 'Trigger Prompt',
+            type: 'string',
+            required: false,
+            placeholder: 'Handle the incoming event and execute the agent end-to-end.',
+        },
+    ],
+};
+export const ONCE_TRIGGER_SPEC_0_0_1 = {
+    id: 'once',
+    version: '0.0.1',
+    name: 'Run Once',
+    description: 'Execute agent immediately after deployment.',
+    type: 'once',
+    fields: [
+        {
+            name: 'prompt',
+            label: 'Trigger Prompt',
+            type: 'string',
+            required: false,
+            placeholder: 'Start when requested by a user and complete the agent once.',
+        },
+    ],
+};
+export const SCHEDULE_TRIGGER_SPEC_0_0_1 = {
+    id: 'schedule',
+    version: '0.0.1',
+    name: 'Schedule',
+    description: 'Run on a recurring schedule using a cron expression (e.g. daily at 9 AM, every Monday, monthly on the 1st).',
+    type: 'schedule',
+    fields: [
+        {
+            name: 'cron',
+            label: 'Cron Expression',
+            type: 'string',
+            required: true,
+            placeholder: '0 9 * * * (every day at 9 AM)',
+            font: 'mono',
+        },
+        {
+            name: 'description',
+            label: 'Description',
+            type: 'string',
+            required: false,
+            placeholder: "Description (e.g. 'Monthly sales report')",
+        },
+        {
+            name: 'prompt',
+            label: 'Trigger Prompt',
+            type: 'string',
+            required: false,
+            placeholder: 'Run the scheduled agent and produce the configured deliverable.',
+        },
+    ],
+};
+// ============================================================================
+// Trigger Catalog
+// ============================================================================
+export const TRIGGER_CATALOG = {
+    event: EVENT_TRIGGER_SPEC_0_0_1,
+    once: ONCE_TRIGGER_SPEC_0_0_1,
+    schedule: SCHEDULE_TRIGGER_SPEC_0_0_1,
+};
+export function getTriggerSpecs() {
+    return Object.values(TRIGGER_CATALOG);
+}
+function resolveTriggerIdTs(triggerId) {
+    if (triggerId in TRIGGER_CATALOG)
+        return triggerId;
+    const idx = triggerId.lastIndexOf(':');
+    if (idx > 0) {
+        const base = triggerId.slice(0, idx);
+        if (base in TRIGGER_CATALOG)
+            return base;
+    }
+    return triggerId;
+}
+export function getTriggerSpec(triggerId) {
+    return TRIGGER_CATALOG[resolveTriggerIdTs(triggerId)];
+}

package/lib/stores/agentsStore.d.ts

@@ -0,0 +1,123 @@
+import type { ServiceManager } from '@jupyterlab/services';
+import type { IRuntimeOptions } from '@datalayer/core/lib/stateful/runtimes/apis';
+import type { AgentStatus, AgentConnection, AgentConfig, Protocol } from '../types';
+/**
+ * A URL-addressable agent that has been previously connected.
+ * May originate from an agent runtime pod OR from the stable agents service.
+ */
+export interface AgentRegistryEntry {
+    /** Unique agent identifier */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Agent description */
+    description: string;
+    /** Base URL for the agent */
+    baseUrl: string;
+    /** Transport protocol used */
+    protocol: Protocol;
+    /** Current status */
+    status: AgentStatus;
+    /** Last error message if status is 'error' */
+    error?: string | null;
+    /** Timestamp of last update */
+    lastUpdated: number;
+    /** Document ID (for document-based agents) */
+    documentId?: string;
+    /** Runtime ID (for agent runtime pods) */
+    runtimeId?: string;
+    /** Author name (optional, for display) */
+    author?: string;
+    /** Avatar URL (optional, for display) */
+    avatarUrl?: string;
+}
+/** State for the currently-connected agent runtime pod. */
+export interface agentsStoreState {
+    /** Current runtime connection (null if not connected) */
+    runtime: AgentConnection | null;
+    /** Current status */
+    status: AgentStatus;
+    /** Error message if any */
+    error: string | null;
+    /** Whether a launch is in progress */
+    isLaunching: boolean;
+}
+/** Actions for the agent runtime pod lifecycle. */
+export interface agentsStoreActions {
+    /** Launch a new runtime pod */
+    launchAgent: (options: IRuntimeOptions) => Promise<AgentConnection>;
+    /** Connect to an existing runtime pod */
+    connectAgent: (connection: {
+        podName: string;
+        environmentName: string;
+        serviceManager?: ServiceManager.IManager;
+        jupyterBaseUrl?: string;
+        kernelId?: string;
+    }) => void;
+    /** Create an agent process on the connected runtime */
+    createAgent: (config?: AgentConfig) => Promise<Pick<AgentConnection, 'agentId' | 'endpoint' | 'isReady'>>;
+    /** Disconnect from the current runtime */
+    disconnect: () => void;
+    /** Clear any errors */
+    clearError: () => void;
+    /** Set error */
+    setError: (error: string) => void;
+    /** Reset store to initial state */
+    reset: () => void;
+}
+export type agentsStore = agentsStoreState & agentsStoreActions;
+/** Persisted registry of URL-addressable agents. */
+export type AgentRegistryState = {
+    /** Registered agents */
+    agents: readonly AgentRegistryEntry[];
+    /** Add or update an agent entry */
+    upsertAgent: (agent: Partial<AgentRegistryEntry> & {
+        id: string;
+        baseUrl: string;
+        protocol: Protocol;
+    }) => void;
+    /** Get agent by ID */
+    getAgentById: (id: string) => AgentRegistryEntry | undefined;
+    /** Get agent by baseUrl and transport */
+    getAgentByUrl: (baseUrl: string, protocol: Protocol) => AgentRegistryEntry | undefined;
+    /** Update agent status */
+    updateAgentStatus: (id: string, status: AgentStatus, error?: string | null) => void;
+    /** Toggle agent status between running/paused */
+    toggleAgentStatus: (id: string) => void;
+    /** Remove an agent entry */
+    deleteAgent: (id: string) => void;
+    /** Clear all agent entries */
+    clearAgents: () => void;
+};
+export type AgentState = AgentRegistryState & agentsStoreState & agentsStoreActions;
+export declare const agentStore: Omit<import("zustand").StoreApi<AgentState>, "persist"> & {
+    persist: {
+        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<AgentState, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: AgentState) => void) => () => void;
+        onFinishHydration: (fn: (state: AgentState) => void) => () => void;
+        getOptions: () => Partial<import("zustand/middleware").PersistOptions<AgentState, unknown>>;
+    };
+};
+export declare function useAgentStore(): AgentState;
+export declare function useAgentStore<T>(selector: (state: AgentState) => T): T;
+/** Currently-connected agent runtime pod connection. */
+export declare const useAgentRuntime: () => AgentConnection | null;
+/**
+ * @deprecated Use useAgentRuntime() — agent fields are merged onto the runtime connection.
+ */
+export declare const useAgentFromStore: () => {
+    agentId: string | undefined;
+    endpoint: string | undefined;
+    isReady: boolean | undefined;
+} | null;
+export declare const useAgentStatus: () => AgentStatus;
+export declare const useAgentError: () => string | null;
+export declare const useIsLaunching: () => boolean;
+/** Get agent runtime store state outside React. */
+export declare const getAgentState: () => AgentState;
+/** Subscribe to agent runtime store outside React. */
+export declare const subscribeToAgent: (listener: (state: AgentState, prevState: AgentState) => void) => () => void;
+export default useAgentStore;

package/lib/stores/agentsStore.js

@@ -0,0 +1,270 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * Zustand store for agent runtime connection state.
+ *
+ * Manages two distinct concepts:
+ *
+ * 1. **Agent Runtime** — a single currently-connected pod (launch, connect,
+ *    create agent, disconnect).  Runtime pods are ephemeral; they have a
+ *    `podName` and a lifecycle (idle → launching → ready → disconnected).
+ *
+ * 2. **Agents Registry** — a persisted registry of URL-addressable agents
+ *    that were previously connected.  Each entry has a `baseUrl` + transport
+ *    pair and can be from any source (agent runtimes OR the stable agents
+ *    service at `/api/v1/ai-agents/`).
+ *
+ * @module store/agentsStore
+ */
+import { createStore } from 'zustand/vanilla';
+import { useStore } from 'zustand';
+import { persist, createJSONStorage } from 'zustand/middleware';
+// ─── Helper: build the transport-specific endpoint URL ────────────────────
+function getTransportEndpoint(baseUrl, transport, agentId) {
+    switch (transport) {
+        case 'vercel-ai':
+            return `${baseUrl}/api/v1/vercel-ai/${agentId}`;
+        case 'a2a':
+            return `${baseUrl}/api/v1/a2a/agents/${agentId}/`;
+        case 'acp':
+            return `${baseUrl}/api/v1/acp/ws/${agentId}`;
+        case 'ag-ui':
+        default:
+            return `${baseUrl}/api/v1/ag-ui/${agentId}/`;
+    }
+}
+// ─── Helper: register agent on the runtime ────────────────────────────────
+async function createAgentOnRuntime(agentBaseUrl, agentId, config = {}) {
+    const transport = config.protocol || 'ag-ui';
+    const response = await fetch(`${agentBaseUrl}/api/v1/agents`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            name: config.name || agentId,
+            description: config.description || 'AI assistant',
+            agent_library: config.agentLibrary || 'pydantic-ai',
+            transport,
+            model: config.model || 'bedrock:us.anthropic.claude-sonnet-4-5-20250929-v1:0',
+            system_prompt: config.systemPrompt || 'You are a helpful AI assistant.',
+        }),
+    });
+    if (response.ok || response.status === 400) {
+        // 400 means agent already exists, which is fine
+        const endpoint = getTransportEndpoint(agentBaseUrl, transport, agentId);
+        return { agentId, endpoint, isReady: true };
+    }
+    const errorData = await response.json().catch(() => ({}));
+    throw new Error(errorData.detail || `Failed to create agent: ${response.status}`);
+}
+// ─── Initial runtime state ────────────────────────────────────────────────
+const initialRuntimeState = {
+    runtime: null,
+    status: 'idle',
+    error: null,
+    isLaunching: false,
+};
+// ─── Combined Zustand store ───────────────────────────────────────────────
+export const agentStore = createStore()(persist((set, get) => ({
+    // ── Agent registry ────────────────────────────────────────────────
+    agents: [],
+    upsertAgent: agentData => {
+        set(state => {
+            const existingIndex = state.agents.findIndex(a => a.id === agentData.id);
+            const now = Date.now();
+            if (existingIndex >= 0) {
+                const updatedAgents = [...state.agents];
+                updatedAgents[existingIndex] = {
+                    ...updatedAgents[existingIndex],
+                    ...agentData,
+                    lastUpdated: now,
+                };
+                return { agents: updatedAgents };
+            }
+            const newAgent = {
+                name: agentData.name || agentData.id,
+                description: agentData.description || '',
+                status: agentData.status || 'initializing',
+                lastUpdated: now,
+                ...agentData,
+            };
+            return { agents: [...state.agents, newAgent] };
+        });
+    },
+    getAgentById: (id) => {
+        return get().agents.find(agent => agent.id === id);
+    },
+    getAgentByUrl: (baseUrl, protocol) => {
+        return get().agents.find(agent => agent.baseUrl === baseUrl && agent.protocol === protocol);
+    },
+    updateAgentStatus: (id, status, error = null) => {
+        set(state => {
+            const index = state.agents.findIndex(a => a.id === id);
+            if (index >= 0) {
+                const updatedAgents = [...state.agents];
+                updatedAgents[index] = {
+                    ...updatedAgents[index],
+                    status,
+                    error,
+                    lastUpdated: Date.now(),
+                };
+                return { agents: updatedAgents };
+            }
+            return {};
+        });
+    },
+    toggleAgentStatus: (id) => {
+        set(state => {
+            const index = state.agents.findIndex(a => a.id === id);
+            if (index >= 0) {
+                const updatedAgents = [...state.agents];
+                const currentStatus = updatedAgents[index].status;
+                updatedAgents[index] = {
+                    ...updatedAgents[index],
+                    status: currentStatus === 'running' ? 'paused' : 'running',
+                    lastUpdated: Date.now(),
+                };
+                return { agents: updatedAgents };
+            }
+            return {};
+        });
+    },
+    deleteAgent: (id) => {
+        set(state => ({
+            agents: state.agents.filter(a => a.id !== id),
+        }));
+    },
+    clearAgents: () => {
+        set({ agents: [] });
+    },
+    // ── Agent runtime pod ───────────────────────────────────────────
+    ...initialRuntimeState,
+    connectAgent: connection => {
+        const baseUrl = connection.jupyterBaseUrl ||
+            connection.serviceManager?.serverSettings.baseUrl;
+        if (!baseUrl) {
+            throw new Error('connectAgent requires either jupyterBaseUrl or serviceManager');
+        }
+        const agentBaseUrl = baseUrl.replace('/jupyter/server/', '/agent-runtimes/');
+        set({
+            runtime: {
+                podName: connection.podName,
+                environmentName: connection.environmentName,
+                jupyterBaseUrl: baseUrl,
+                agentBaseUrl,
+                serviceManager: connection.serviceManager,
+                status: 'ready',
+                kernelId: connection.kernelId,
+            },
+            status: 'ready',
+            error: null,
+        });
+    },
+    launchAgent: async (config) => {
+        set({ status: 'launching', error: null, isLaunching: true });
+        try {
+            const { createRuntime } = await import('@datalayer/core/lib/api');
+            const runtimePod = await createRuntime({
+                environmentName: config.environmentName,
+                creditsLimit: config.creditsLimit,
+                type: config.type || 'notebook',
+                givenName: config.givenName,
+                capabilities: config.capabilities,
+                snapshot: config.snapshot,
+            });
+            set({ status: 'connecting' });
+            const jupyterBaseUrl = runtimePod.ingress;
+            const agentBaseUrl = jupyterBaseUrl.replace('/jupyter/server/', '/agent-runtimes/');
+            const connection = {
+                podName: runtimePod.pod_name,
+                environmentName: runtimePod.environment_name,
+                jupyterBaseUrl,
+                agentBaseUrl,
+                status: 'ready',
+            };
+            set({ runtime: connection, status: 'ready', isLaunching: false });
+            return connection;
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : 'Failed to launch runtime';
+            set({ status: 'error', error: errorMessage, isLaunching: false });
+            throw err;
+        }
+    },
+    createAgent: async (config = {}) => {
+        const { runtime } = get();
+        if (!runtime) {
+            throw new Error('No runtime connected. Launch or connect to a runtime first.');
+        }
+        try {
+            const agentId = config.name || runtime.podName;
+            const agentConnection = await createAgentOnRuntime(runtime.agentBaseUrl, agentId, config);
+            set({
+                runtime: {
+                    ...runtime,
+                    agentId: agentConnection.agentId,
+                    endpoint: agentConnection.endpoint,
+                    isReady: agentConnection.isReady,
+                },
+            });
+            return agentConnection;
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : 'Failed to create agent';
+            set({ error: errorMessage });
+            throw err;
+        }
+    },
+    disconnect: () => {
+        set({ runtime: null, status: 'disconnected', error: null });
+    },
+    clearError: () => set({ error: null }),
+    setError: error => set({ error, status: 'error' }),
+    reset: () => set(initialRuntimeState),
+}), {
+    name: 'agent-runtimes-storage',
+    storage: createJSONStorage(() => localStorage),
+    // Only persist the agent registry; runtime connection state is ephemeral.
+    partialize: state => ({
+        agents: state.agents.map(agent => ({
+            id: agent.id,
+            name: agent.name,
+            description: agent.description,
+            baseUrl: agent.baseUrl,
+            transport: agent.protocol,
+            status: agent.status,
+            lastUpdated: agent.lastUpdated,
+            documentId: agent.documentId,
+            runtimeId: agent.runtimeId,
+        })),
+    }),
+}));
+export function useAgentStore(selector) {
+    return useStore(agentStore, selector);
+}
+// Attach getState / subscribe for non-React consumers
+useAgentStore.getState = agentStore.getState;
+useAgentStore.subscribe = agentStore.subscribe;
+// ─── Focused selector hooks ────────────────────────────────────────────────
+/** Currently-connected agent runtime pod connection. */
+export const useAgentRuntime = () => useAgentStore(state => state.runtime);
+/**
+ * @deprecated Use useAgentRuntime() — agent fields are merged onto the runtime connection.
+ */
+export const useAgentFromStore = () => useAgentStore(state => state.runtime
+    ? {
+        agentId: state.runtime.agentId,
+        endpoint: state.runtime.endpoint,
+        isReady: state.runtime.isReady,
+    }
+    : null);
+export const useAgentStatus = () => useAgentStore(state => state.status);
+export const useAgentError = () => useAgentStore(state => state.error);
+export const useIsLaunching = () => useAgentStore(state => state.isLaunching);
+// ─── Non-React access ──────────────────────────────────────────────────────
+/** Get agent runtime store state outside React. */
+export const getAgentState = () => agentStore.getState();
+/** Subscribe to agent runtime store outside React. */
+export const subscribeToAgent = agentStore.subscribe;
+export default useAgentStore;

package/lib/{components/chat/store → stores}/chatStore.d.ts

@@ -1,4 +1,5 @@
-import type { ChatMessage, ChatThread, ToolRegistryEntry, ToolDefinition, ChatExtension, ExtensionRegistryEntry, ChatMiddleware, ToolCallStatus } from '../types';
+import type { ChatMessage, ChatThread, ToolRegistryEntry, ToolDefinition, ChatExtension, ExtensionRegistryEntry, ChatMiddleware } from '../types';
+import type { ToolCallStatus } from '../types/messages';
 import type { InferenceProvider } from '../types/inference';
 import type { ProtocolAdapter } from '../types/protocol';
 import type { ToolExecutor } from '../tools/ToolExecutor';
@@ -11,7 +12,7 @@ export interface ChatConfig {
     /** Default inference provider type */
     defaultProvider?: 'datalayer' | 'openai' | 'anthropic' | 'self-hosted';
     /** Default protocol type */
-    defaultProtocol?: 'ag-ui' | 'a2a' | 'acp' | 'mcp-ui';
+    defaultProtocol?: 'ag-ui' | 'vercel-ai' | 'a2a' | 'acp' | 'mcp-ui';
     /** API base URL for inference */
     apiBaseUrl?: string;
     /** API key for inference */

package/lib/{components/chat/store → stores}/chatStore.js

@@ -7,7 +7,7 @@
  * Provides centralized state for messages, tools, config, and instances.
  * This is the primary state management - NO React Context/Provider needed.
  *
- * @module components/chat/store/chatStore
+ * @module store/chatStore
  */
 import { create } from 'zustand';
 import { devtools, subscribeWithSelector } from 'zustand/middleware';
@@ -16,7 +16,7 @@ import { devtools, subscribeWithSelector } from 'zustand/middleware';
  */
 export const defaultChatConfig = {
     defaultProvider: 'datalayer',
-    defaultProtocol: 'ag-ui',
+    defaultProtocol: 'vercel-ai',
     enableStreaming: true,
     requireToolApproval: false,
     debug: false,

package/lib/{components/chat/store → stores}/conversationStore.d.ts

@@ -1,9 +1,9 @@
-import type { ChatMessage } from '../types/message';
+import type { ChatMessage } from '../types/messages';
 /**
  * Conversation data for a single runtime
  */
 export interface ConversationData {
-    /** Runtime/agent space ID */
+    /** Agent runtime ID */
     runtimeId: string;
     /** Messages in this conversation */
     messages: ChatMessage[];