@datalayer/agent-runtimes 1.0.8 → 1.0.10

package/lib/chat/Chat.js

@@ -18,7 +18,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  *
  * @module chat/Chat
  */
-import { useEffect, useMemo, useState, useRef } from 'react';
+import { useEffect, useMemo, useState, useRef, useCallback } from 'react';
 import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import { Text, Button, Spinner } from '@primer/react';
 import { AlertIcon, SyncIcon } from '@primer/octicons-react';
@@ -145,9 +145,7 @@ export function Chat({ protocol: transport, extensions: _extensions, baseUrl = '
     const [showDetails, setShowDetails] = useState(false);
     const [messageCount, setMessageCount] = useState(0);
     const [focusTrigger, setFocusTrigger] = useState(0);
-    const renderCountRef = useRef(0);
-    renderCountRef.current += 1;
-    console.log(`[AgentRuntimes][Chat] render count: ${renderCountRef.current}`);
+    const lastMessageCountRef = useRef(null);
     // Get connected identities to pass to backend for skill execution
     const connectedIdentities = useConnectedIdentities();
     // Map identities to the format expected by ChatBase
@@ -272,6 +270,26 @@ export function Chat({ protocol: transport, extensions: _extensions, baseUrl = '
     const handleNewChat = () => {
         onDisconnect?.();
     };
+    const handleInformationClick = useCallback(() => {
+        setShowDetails(true);
+    }, []);
+    const handleBackFromDetails = useCallback(() => {
+        setShowDetails(false);
+    }, []);
+    const handleMessagesChange = useCallback((messages) => {
+        const nextCount = messages.length;
+        if (lastMessageCountRef.current === nextCount) {
+            return;
+        }
+        lastMessageCountRef.current = nextCount;
+        setMessageCount(nextCount);
+    }, []);
+    const headerButtons = useMemo(() => ({
+        showNewChat: showNewChatButton,
+        showClear: showClearButton,
+        onNewChat: handleNewChat,
+    }), [showNewChatButton, showClearButton]);
+    const avatarConfig = useMemo(() => ({ showAvatars: true }), []);
     // Render error state
     if (error) {
         return (_jsx(QueryClientProvider, { client: queryClient, children: _jsxs(Box, { className: className, sx: {
@@ -306,7 +324,7 @@ export function Chat({ protocol: transport, extensions: _extensions, baseUrl = '
                         display: showDetails ? 'flex' : 'none',
                         flexDirection: 'column',
                         height: '100%',
-                    }, children: _jsx(AgentDetails, { name: title || 'AI Agent', icon: brandIcon, protocol: transport, url: protocolConfig?.endpoint || baseUrl, messageCount: messageCount, agentId: agentId, apiBase: baseUrl, identityProviders: identityProviders, onIdentityConnect: onIdentityConnect, onIdentityDisconnect: onIdentityDisconnect, onBack: () => setShowDetails(false), mcpStatusData: mcpStatusData, codemodeStatusData: codemodeStatusData }) }), _jsxs(Box, { sx: {
+                    }, children: _jsx(AgentDetails, { name: title || 'AI Agent', icon: brandIcon, protocol: transport, url: protocolConfig?.endpoint || baseUrl, messageCount: messageCount, agentId: agentId, apiBase: baseUrl, identityProviders: identityProviders, onIdentityConnect: onIdentityConnect, onIdentityDisconnect: onIdentityDisconnect, onBack: handleBackFromDetails, mcpStatusData: mcpStatusData, codemodeStatusData: codemodeStatusData }) }), _jsxs(Box, { sx: {
                         display: showDetails ? 'none' : 'flex',
                         flexDirection: 'column',
                         height: '100%',
@@ -331,12 +349,6 @@ export function Chat({ protocol: transport, extensions: _extensions, baseUrl = '
                                             ? 'attention.fg'
                                             : 'danger.fg',
                                         flex: 1,
-                                    }, children: errorBanner.message })] })), _jsx(ChatBase, { title: title, subtitle: subtitle, brandIcon: brandIcon, showHeader: showHeader, protocol: protocolConfig, placeholder: placeholder, description: description, suggestions: suggestions, submitOnSuggestionClick: submitOnSuggestionClick, autoFocus: autoFocus, runtimeId: runtimeId, historyEndpoint: historyEndpoint, pendingPrompt: pendingPrompt, showInformation: showInformation, onInformationClick: () => setShowDetails(true), headerContent: headerContent, headerActions: headerActions, showModelSelector: showModelSelector, showToolsMenu: showToolsMenu, showInput: showInput, disableInputPrompt: disableInputPrompt, showSkillsMenu: showSkillsMenu, showTokenUsage: showTokenUsage, codemodeEnabled: codemodeEnabled, onToggleCodemode: onToggleCodemode, initialModel: initialModel, availableModels: availableModels, mcpServers: mcpServers, initialSkills: initialSkills, connectedIdentities: identitiesForChat, onNewChat: handleNewChat, onMessagesChange: messages => setMessageCount(messages.length), headerButtons: {
-                                showNewChat: showNewChatButton,
-                                showClear: showClearButton,
-                                onNewChat: handleNewChat,
-                            }, avatarConfig: {
-                                showAvatars: true,
-                            }, backgroundColor: "canvas.default", focusTrigger: focusTrigger, chatViewMode: chatViewMode, onChatViewModeChange: onChatViewModeChange, frontendTools: frontendTools, onToolCallStart: onToolCallStart, onToolCallComplete: onToolCallComplete, renderToolResult: renderToolResult, hideMessagesAfterToolUI: hideMessagesAfterToolUI, contextSnapshot: contextSnapshot, mcpStatusData: mcpStatusData, sandboxStatusData: sandboxStatusData, showToolApprovalBanner: showToolApprovalBanner, pendingApprovals: pendingApprovals, onApproveApproval: onApproveApproval, onRejectApproval: onRejectApproval })] })] }) }));
+                                    }, children: errorBanner.message })] })), _jsx(ChatBase, { title: title, subtitle: subtitle, brandIcon: brandIcon, showHeader: showHeader, protocol: protocolConfig, placeholder: placeholder, description: description, suggestions: suggestions, submitOnSuggestionClick: submitOnSuggestionClick, autoFocus: autoFocus, runtimeId: runtimeId, historyEndpoint: historyEndpoint, pendingPrompt: pendingPrompt, showInformation: showInformation, onInformationClick: handleInformationClick, headerContent: headerContent, headerActions: headerActions, showModelSelector: showModelSelector, showToolsMenu: showToolsMenu, showInput: showInput, disableInputPrompt: disableInputPrompt, showSkillsMenu: showSkillsMenu, showTokenUsage: showTokenUsage, codemodeEnabled: codemodeEnabled, onToggleCodemode: onToggleCodemode, initialModel: initialModel, availableModels: availableModels, mcpServers: mcpServers, initialSkills: initialSkills, connectedIdentities: identitiesForChat, onNewChat: handleNewChat, onMessagesChange: handleMessagesChange, headerButtons: headerButtons, avatarConfig: avatarConfig, backgroundColor: "canvas.default", focusTrigger: focusTrigger, chatViewMode: chatViewMode, onChatViewModeChange: onChatViewModeChange, frontendTools: frontendTools, onToolCallStart: onToolCallStart, onToolCallComplete: onToolCallComplete, renderToolResult: renderToolResult, hideMessagesAfterToolUI: hideMessagesAfterToolUI, contextSnapshot: contextSnapshot, mcpStatusData: mcpStatusData, sandboxStatusData: sandboxStatusData, showToolApprovalBanner: showToolApprovalBanner, pendingApprovals: pendingApprovals, onApproveApproval: onApproveApproval, onRejectApproval: onRejectApproval })] })] }) }));
 }
 export default Chat;

package/lib/chat/base/ChatBase.js

@@ -604,6 +604,42 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
         requestAiAgentsApprovalHistory,
         sendAiAgentsApprovalDecision,
     ]);
+    const reconcileResolvedApprovalInStore = useCallback((approval) => {
+        const state = agentRuntimeStore.getState();
+        const removalIds = new Set([approval.id]);
+        const hasResolvedToolName = Boolean(approval.tool_name);
+        const resolvedSignature = hasResolvedToolName
+            ? approvalSignature(approval.tool_name, approval.tool_args ?? {})
+            : null;
+        for (const existing of state.approvals) {
+            if (existing.status !== 'pending') {
+                continue;
+            }
+            if (!isApprovalForAgent(existing, activeAgentId)) {
+                continue;
+            }
+            if (existing.id === approval.id) {
+                removalIds.add(existing.id);
+                continue;
+            }
+            if (approval.tool_call_id &&
+                existing.tool_call_id &&
+                existing.tool_call_id === approval.tool_call_id) {
+                removalIds.add(existing.id);
+                continue;
+            }
+            if (!resolvedSignature || !existing.tool_name) {
+                continue;
+            }
+            const existingSignature = approvalSignature(existing.tool_name, existing.tool_args ?? {});
+            if (existingSignature === resolvedSignature) {
+                removalIds.add(existing.id);
+            }
+        }
+        for (const id of removalIds) {
+            state.removeApproval(id);
+        }
+    }, [activeAgentId]);
     // Optional ai-agents bridge for server-mode visibility.
     // This keeps approval synchronization in ChatBase so examples do not need
     // their own approval websocket plumbing.
@@ -702,7 +738,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
                         state.upsertApproval(scopedApproval);
                     }
                     else {
-                        state.removeApproval(scopedApproval.id);
+                        reconcileResolvedApprovalInStore(scopedApproval);
                     }
                 }
             }
@@ -730,6 +766,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
         aiAgentsAuthToken,
         activeAgentId,
         isSuppressedPending,
+        reconcileResolvedApprovalInStore,
     ]);
     // The outer ChatBase wrapper always resolves a string Protocol to a full
     // ProtocolConfig (or undefined).  Narrow the type for internal use.
@@ -964,6 +1001,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
                 }
                 return;
             }
+            reconcileResolvedApprovalInStore(payload);
             applyServerApprovalDecision(payload, msg.type === 'tool_approval_approved', payload.note ?? undefined);
         },
     });

package/lib/client/AgentsMixin.d.ts

@@ -11,7 +11,7 @@
  * @module client/AgentsMixin
  */
 import type { Constructor } from '@datalayer/core/lib/client/utils/mixins';
-import type { AgentEvent, CreateAgentEventRequest, GetAgentEventResponse, ListAgentEventsParams, ListAgentEventsResponse, UpdateAgentEventRequest, RunningAgent, AgentUsageSummary, ConversationCheckpoint, AgentNotification, NotificationFilters, OutputArtifact, EvalReport, RunEvalsRequest, ContextUsage, CostUsage, AgentSpec } from '../types';
+import type { AgentEvent, CreateAgentEventRequest, GetAgentEventResponse, ListAgentEventsParams, ListAgentEventsResponse, UpdateAgentEventRequest, RunningAgent, AgentUsageSummary, ConversationCheckpoint, AgentNotification, NotificationFilters, OutputArtifact, EvalReport, RunEvalsRequest, ContextUsage, CostUsage, Agentspec } from '../types';
 import type { CreateAgentRuntimeRequest, CreateRuntimeApiResponse } from '../types/agents-lifecycle';
 /** Agents mixin providing durable agent management. */
 export declare function AgentsMixin<TBase extends Constructor>(Base: TBase): {
@@ -153,19 +153,19 @@ export declare function AgentsMixin<TBase extends Constructor>(Base: TBase): {
          * @param agentSpecId - Agent spec identifier.
          * @returns The agent spec, or undefined if not found.
          */
-        getAgentSpec(agentSpecId: string): AgentSpec | undefined;
+        getAgentspec(agentSpecId: string): Agentspec | undefined;
         /**
          * List all available agent specifications.
          * @param prefix - If provided, only return specs whose ID starts with this prefix.
          * @returns Array of agent specifications.
          */
-        listAgentSpecs(prefix?: string): AgentSpec[];
+        listAgentspecs(prefix?: string): Agentspec[];
         /**
          * Get required environment variables for an agent spec.
          * @param spec - The agent specification.
          * @returns Deduplicated array of required environment variable names.
          */
-        getAgentSpecRequiredEnvVars(spec: AgentSpec): string[];
+        getAgentspecRequiredEnvVars(spec: Agentspec): string[];
         /**
          * Assign an agent runtime to a project.
          * @param projectUid - Project UID.

package/lib/client/AgentsMixin.js

@@ -8,7 +8,7 @@ import * as events from '../api/events';
 import * as output from '../api/output';
 import * as evals from '../api/evals';
 import * as context from '../api/context';
-import * as agentSpecs from '../specs/agents';
+import * as agentspecs from '../specs/agents';
 import { requestDatalayerAPI } from '@datalayer/core/lib/api/DatalayerApi';
 /** Agents mixin providing durable agent management. */
 export function AgentsMixin(Base) {
@@ -261,24 +261,24 @@ export function AgentsMixin(Base) {
          * @param agentSpecId - Agent spec identifier.
          * @returns The agent spec, or undefined if not found.
          */
-        getAgentSpec(agentSpecId) {
-            return agentSpecs.getAgentSpecs(agentSpecId);
+        getAgentspec(agentSpecId) {
+            return agentspecs.getAgentspecs(agentSpecId);
         }
         /**
          * List all available agent specifications.
          * @param prefix - If provided, only return specs whose ID starts with this prefix.
          * @returns Array of agent specifications.
          */
-        listAgentSpecs(prefix) {
-            return agentSpecs.listAgentSpecs(prefix);
+        listAgentspecs(prefix) {
+            return agentspecs.listAgentspecs(prefix);
         }
         /**
          * Get required environment variables for an agent spec.
          * @param spec - The agent specification.
          * @returns Deduplicated array of required environment variable names.
          */
-        getAgentSpecRequiredEnvVars(spec) {
-            return agentSpecs.getAgentSpecRequiredEnvVars(spec);
+        getAgentspecRequiredEnvVars(spec) {
+            return agentspecs.getAgentspecRequiredEnvVars(spec);
         }
         // ========================================================================
         // Project Agent Assignment

package/lib/components/ToolApprovalCard.js

@@ -30,6 +30,18 @@ export function ToolApprovalCard({ approval, onApprove, onReject, onToggleRead,
     const detailLabelSx = { color: 'fg.muted' };
     const detailValueSx = { color: 'fg.default' };
     const isRead = approval.isRead ?? false;
+    const statusDescriptor = approval.status === 'approved_with_changes'
+        ? 'approved with changes'
+        : approval.status;
+    // Review text must follow status, not only reviewedAt.
+    // Some websocket flows can have an already-decided status before reviewer
+    // metadata is hydrated; rendering "review pending" in that window is
+    // misleading, so non-pending statuses get a status-based summary.
+    const reviewSummary = approval.reviewedAt
+        ? `, reviewed by ${approval.reviewedBy || 'reviewer'} ${formatRelativeTime(approval.reviewedAt)}`
+        : approval.status === 'pending'
+            ? ', review pending'
+            : `, ${statusDescriptor}`;
     return (_jsx(Box, { sx: {
             p: 3,
             borderRadius: 2,
@@ -47,9 +59,7 @@ export function ToolApprovalCard({ approval, onApprove, onReject, onToggleRead,
                                 gap: 2,
                                 mb: 1,
                                 flexWrap: 'wrap',
-                            }, children: [_jsx(Text, { sx: { fontWeight: 'bold', fontSize: 2 }, children: approval.toolName }), _jsx(Label, { variant: statusConfig.variant, children: statusConfig.label }), _jsx(Label, { variant: riskConfig.variant, children: riskConfig.label }), !isRead && _jsx(Label, { variant: "accent", children: "Unread" })] }), _jsxs(Text, { sx: { color: 'fg.muted', fontSize: 0, display: 'block' }, children: ["Requested by ", approval.requestedBy, ' ', formatRelativeTime(approval.requestedAt), approval.reviewedAt
-                                    ? `, reviewed by ${approval.reviewedBy || 'reviewer'} ${formatRelativeTime(approval.reviewedAt)}`
-                                    : ', review pending'] }), _jsx(Box, { sx: {
+                            }, children: [_jsx(Text, { sx: { fontWeight: 'bold', fontSize: 2 }, children: approval.toolName }), _jsx(Label, { variant: statusConfig.variant, children: statusConfig.label }), _jsx(Label, { variant: riskConfig.variant, children: riskConfig.label }), !isRead && _jsx(Label, { variant: "accent", children: "Unread" })] }), _jsxs(Text, { sx: { color: 'fg.muted', fontSize: 0, display: 'block' }, children: ["Requested by ", approval.requestedBy, ' ', formatRelativeTime(approval.requestedAt), reviewSummary] }), _jsx(Box, { sx: {
                                 mt: 2,
                                 width: '100%',
                                 p: 2,

package/lib/config/AgentConfiguration.d.ts

@@ -5,7 +5,7 @@ import type { AgentLibrary, Extension, McpServerSelection, Protocol } from '../t
 /**
  * Agent spec entry from the library endpoint.
  */
-export interface LibraryAgentSpec {
+export interface LibraryAgentspec {
     [key: string]: unknown;
     id: string;
     version?: string;
@@ -121,7 +121,7 @@ export interface AgentConfigurationProps {
     /** Selected MCP servers */
     selectedMcpServers?: McpServerSelection[];
     /** Cloud-discovered specs fetched from a remote runtime catalog. */
-    cloudLibrarySpecs?: LibraryAgentSpec[];
+    cloudLibrarySpecs?: LibraryAgentspec[];
     /** Loading state for cloud library specs. */
     cloudLibraryLoading?: boolean;
     /** Optional cloud library fetch error message. */

package/lib/config/index.d.ts

@@ -1,3 +1,3 @@
 export * from './utils';
 export { AgentConfiguration, AGENT_LIBRARIES, TRANSPORTS, EXTENSIONS, isSpecSelection, getSpecId, } from './AgentConfiguration';
-export type { AgentConfigurationProps, SkillOption, LibraryAgentSpec, } from './AgentConfiguration';
+export type { AgentConfigurationProps, SkillOption, LibraryAgentspec, } from './AgentConfiguration';

package/lib/examples/AgentCheckpointsExample.js

@@ -35,8 +35,8 @@ import { useDeletePausedAgentRuntime } from '../hooks/useCheckpoints';
 import { AGENT_STATUS_COLORS } from '../types/agents';
 const queryClient = new QueryClient();
 // ─── Defaults ──────────────────────────────────────────────────────────────
-const AGENT_SPEC_ID = 'monitor-sales-kpis';
-const DEMO_AGENT_NAME = AGENT_SPEC_ID;
+const AGENTSPEC_ID = 'monitor-sales-kpis';
+const DEMO_AGENT_NAME = AGENTSPEC_ID;
 const LIGHT_CHECKPOINT_MESSAGES = [
     '[Checkpoint] Captured message history snapshot',
     '[Checkpoint] Saved conversational context for lightweight resume',
@@ -45,7 +45,7 @@ const LIGHT_CHECKPOINT_MESSAGES = [
  * Agent spec attributes displayed in the sidebar.
  * In production this would be fetched from the agentspecs service.
  */
-const AGENT_SPEC = {
+const AGENTSPEC = {
     id: 'monitor-sales-kpis',
     name: 'Monitor Sales KPIs',
     description: 'Monitor and analyze sales KPIs from the CRM system. Generate daily reports, identify trends, and flag anomalies.',
@@ -86,9 +86,9 @@ const SpecRow = ({ icon: Icon, label, value }) => (_jsxs(Box, { sx: {
 // ─── Inner component (rendered after auth) ─────────────────────────────────
 const AgentCheckpointsInner = ({ onLogout, }) => {
     const { runtime, status: runtimeStatus, endpoint: _agentEndpoint, isReady, error: hookError, launchRuntime, connectToRuntime, disconnect, } = useAgentRuntimes({
-        agentSpecId: AGENT_SPEC_ID,
+        agentSpecId: AGENTSPEC_ID,
         autoStart: false,
-        agentSpec: AGENT_SPEC,
+        agentSpec: AGENTSPEC,
         agentConfig: {
             name: DEMO_AGENT_NAME,
             model: 'bedrock:us.anthropic.claude-sonnet-4-5-20250929-v1:0',
@@ -97,8 +97,8 @@ const AgentCheckpointsInner = ({ onLogout, }) => {
         },
     });
     const { pause, resume, terminate, refreshCheckpoints, checkpoints } = useAgentLifecycle({
-        agentSpecId: AGENT_SPEC_ID,
-        agentSpec: AGENT_SPEC,
+        agentSpecId: AGENTSPEC_ID,
+        agentSpec: AGENTSPEC,
         runtime,
         connectToRuntime,
         disconnect,
@@ -120,7 +120,7 @@ const AgentCheckpointsInner = ({ onLogout, }) => {
     const autoConnectAttemptRef = useRef(null);
     const displayError = hookError || actionError;
     const podName = runtime?.podName || '(launching…)';
-    const agentId = runtime?.agentId || AGENT_SPEC_ID;
+    const agentId = runtime?.agentId || AGENTSPEC_ID;
     const agentBaseUrl = runtime?.agentBaseUrl || '';
     const handleLaunch = useCallback(async () => {
         setIsStarting(true);
@@ -319,7 +319,7 @@ const AgentCheckpointsInner = ({ onLogout, }) => {
                                     p: 3,
                                     borderBottom: '1px solid',
                                     borderColor: 'border.default',
-                                }, children: [_jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 2, mb: 2 }, children: [_jsx(Text, { sx: { fontSize: '20px' }, children: AGENT_SPEC.emoji }), _jsx(Heading, { as: "h4", sx: { fontSize: 2, m: 0 }, children: AGENT_SPEC.name })] }), _jsx(Text, { sx: { fontSize: 0, color: 'fg.muted', display: 'block', mb: 3 }, children: AGENT_SPEC.description }), _jsx(SpecRow, { icon: AiModelIcon, label: "Model", value: AGENT_SPEC.model }), _jsx(SpecRow, { icon: GlobeIcon, label: "Protocol", value: AGENT_SPEC.protocol }), _jsx(SpecRow, { icon: ZapIcon, label: "Memory", value: AGENT_SPEC.memory }), _jsx(SpecRow, { icon: GraphIcon, label: "Environment", value: AGENT_SPEC.environment_name }), _jsx(SpecRow, { icon: ClockIcon, label: "Trigger", value: AGENT_SPEC.trigger.description }), _jsx(SpecRow, { icon: TagIcon, label: "Tags", value: AGENT_SPEC.tags.join(', ') }), _jsxs(Box, { sx: {
+                                }, children: [_jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 2, mb: 2 }, children: [_jsx(Text, { sx: { fontSize: '20px' }, children: AGENTSPEC.emoji }), _jsx(Heading, { as: "h4", sx: { fontSize: 2, m: 0 }, children: AGENTSPEC.name })] }), _jsx(Text, { sx: { fontSize: 0, color: 'fg.muted', display: 'block', mb: 3 }, children: AGENTSPEC.description }), _jsx(SpecRow, { icon: AiModelIcon, label: "Model", value: AGENTSPEC.model }), _jsx(SpecRow, { icon: GlobeIcon, label: "Protocol", value: AGENTSPEC.protocol }), _jsx(SpecRow, { icon: ZapIcon, label: "Memory", value: AGENTSPEC.memory }), _jsx(SpecRow, { icon: GraphIcon, label: "Environment", value: AGENTSPEC.environment_name }), _jsx(SpecRow, { icon: ClockIcon, label: "Trigger", value: AGENTSPEC.trigger.description }), _jsx(SpecRow, { icon: TagIcon, label: "Tags", value: AGENTSPEC.tags.join(', ') }), _jsxs(Box, { sx: {
                                             mt: 2,
                                             pt: 2,
                                             borderTop: '1px solid',
@@ -329,7 +329,7 @@ const AgentCheckpointsInner = ({ onLogout, }) => {
                                                     fontSize: 0,
                                                     display: 'block',
                                                     mb: 1,
-                                                }, children: "Advanced" }), _jsx(SpecRow, { label: "Cost limit", value: AGENT_SPEC.advanced.cost_limit }), _jsx(SpecRow, { label: "Time limit", value: AGENT_SPEC.advanced.time_limit }), _jsx(SpecRow, { label: "Max iterations", value: String(AGENT_SPEC.advanced.max_iterations) }), _jsx(SpecRow, { label: "Checkpoint interval", value: `${AGENT_SPEC.advanced.checkpoint_interval}s` }), _jsx(SpecRow, { label: "Temperature", value: String(AGENT_SPEC.model_config.temperature) }), _jsx(SpecRow, { label: "Max tokens", value: String(AGENT_SPEC.model_config.max_tokens) })] })] }), _jsxs(Box, { sx: {
+                                                }, children: "Advanced" }), _jsx(SpecRow, { label: "Cost limit", value: AGENTSPEC.advanced.cost_limit }), _jsx(SpecRow, { label: "Time limit", value: AGENTSPEC.advanced.time_limit }), _jsx(SpecRow, { label: "Max iterations", value: String(AGENTSPEC.advanced.max_iterations) }), _jsx(SpecRow, { label: "Checkpoint interval", value: `${AGENTSPEC.advanced.checkpoint_interval}s` }), _jsx(SpecRow, { label: "Temperature", value: String(AGENTSPEC.model_config.temperature) }), _jsx(SpecRow, { label: "Max tokens", value: String(AGENTSPEC.model_config.max_tokens) })] })] }), _jsxs(Box, { sx: {
                                     order: 2,
                                     p: 3,
                                     borderBottom: '1px solid',
@@ -426,7 +426,7 @@ const AgentCheckpointsInner = ({ onLogout, }) => {
                                 height: '100%',
                                 gap: 3,
                             }, children: [_jsx(Spinner, { size: "large" }), _jsx(Text, { sx: { color: 'fg.muted' }, children: runtimeStatus === 'launching'
-                                        ? `Launching runtime for ${AGENT_SPEC_ID}…`
+                                        ? `Launching runtime for ${AGENTSPEC_ID}…`
                                         : 'Creating agent on runtime…' })] })) : showNoAgentRunningView ? (_jsxs(Box, { sx: {
                                 display: 'flex',
                                 flexDirection: 'column',
@@ -435,7 +435,7 @@ const AgentCheckpointsInner = ({ onLogout, }) => {
                                 height: '100%',
                                 gap: 3,
                                 px: 3,
-                            }, children: [_jsx(AgentIcon, { size: 48 }), _jsx(Heading, { as: "h2", sx: { fontSize: 3 }, children: "Checkpoint Agent" }), _jsxs(Text, { sx: { color: 'fg.muted', textAlign: 'center', maxWidth: 560 }, children: ["Launch a cloud agent runtime with pause/resume checkpointing. The agent will be deployed from the", ' ', _jsx("strong", { children: AGENT_SPEC_ID }), " spec."] }), displayError && (_jsx(Flash, { variant: "danger", sx: { maxWidth: 560, width: '100%' }, children: displayError })), _jsx(Button, { variant: "primary", size: "large", leadingVisual: PlayIcon, onClick: handleLaunch, children: "Launch Agent" })] })) : (isReady || runtimeStatus === 'resumed') &&
+                            }, children: [_jsx(AgentIcon, { size: 48 }), _jsx(Heading, { as: "h2", sx: { fontSize: 3 }, children: "Checkpoint Agent" }), _jsxs(Text, { sx: { color: 'fg.muted', textAlign: 'center', maxWidth: 560 }, children: ["Launch a cloud agent runtime with pause/resume checkpointing. The agent will be deployed from the", ' ', _jsx("strong", { children: AGENTSPEC_ID }), " spec."] }), displayError && (_jsx(Flash, { variant: "danger", sx: { maxWidth: 560, width: '100%' }, children: displayError })), _jsx(Button, { variant: "primary", size: "large", leadingVisual: PlayIcon, onClick: handleLaunch, children: "Launch Agent" })] })) : (isReady || runtimeStatus === 'resumed') &&
                             runtimeStatus !== 'paused' ? (_jsx(Chat, { protocol: "vercel-ai", baseUrl: agentBaseUrl, agentId: agentId, title: "Monitor Sales KPI Agent", brandIcon: _jsx(AgentIcon, { size: 16 }), placeholder: "Ask about sales KPIs\u2026", description: "Monitor Sales KPI agent with pause/resume checkpointing", showHeader: false, showTokenUsage: true, autoFocus: true, height: "100%", runtimeId: podName, historyEndpoint: `${agentBaseUrl}/api/v1/history`, suggestions: [
                                 {
                                     title: 'KPIs',

package/lib/examples/AgentEvalsExample.js

@@ -31,7 +31,7 @@ import { useAgentRuntimes } from '../hooks/useAgentRuntimes';
 const queryClient = new QueryClient();
 // ─── Constants ─────────────────────────────────────────────────────────────
 const AGENT_NAME = 'eval-example-agent';
-const AGENT_SPEC_ID = 'example-evals';
+const AGENTSPEC_ID = 'example-evals';
 const DEFAULT_EXECUTION_TARGET = (import.meta.env.VITE_AGENT_EVALS_TARGET || 'cloud').toLowerCase() === 'local'
     ? 'local'
     : 'cloud';
@@ -93,7 +93,7 @@ const AgentEvalsInner = ({ onLogout, executionTarget, onExecutionTargetChange })
         return 'https://r1.datalayer.run';
     }, [configuration?.runtimesRunUrl]);
     const { runtime, status: runtimeStatus, isReady, error: hookError, runtimeCreationBaseUrl, } = useAgentRuntimes({
-        agentSpecId: AGENT_SPEC_ID,
+        agentSpecId: AGENTSPEC_ID,
         autoStart: executionTarget === 'cloud',
         runtimeCreationTarget: executionTarget === 'local' ? 'local-agent-runtimes' : 'backend-services',
         runtimeCreationBaseUrl: executionTarget === 'local' ? localRuntimeBaseUrl : cloudRuntimeBaseUrl,
@@ -182,7 +182,7 @@ const AgentEvalsInner = ({ onLogout, executionTarget, onExecutionTargetChange })
                         description: 'Agent with evaluation and quality scoring',
                         agent_library: 'pydantic-ai',
                         transport: 'vercel-ai',
-                        agent_spec_id: AGENT_SPEC_ID,
+                        agent_spec_id: AGENTSPEC_ID,
                         enable_skills: true,
                         tools: [],
                     }),

package/lib/examples/AgentGuardrailsExample.js

@@ -26,7 +26,7 @@ import { AuthRequiredView, ErrorView } from './components';
 import { ThemedProvider } from './utils/themedProvider';
 import { uniqueAgentId } from './utils/agentId';
 import { parseAgentStreamMessage } from '../types/stream';
-import { getAgentSpecs } from '../specs/agents';
+import { getAgentspecs } from '../specs/agents';
 import { subscribeOtelWs } from '../context/otelWsPool';
 import { toMetricValue } from '../hooks/useMonitoring';
 import { useAIAgentsWebSocket } from '../hooks';
@@ -35,7 +35,7 @@ import { useSimpleAuthStore } from '@datalayer/core/lib/views/otel';
 import { Chat } from '../chat';
 // ─── Constants ─────────────────────────────────────────────────────────────
 const AGENT_NAME = 'guardrails-example-agent';
-const AGENT_SPEC_ID = 'example-guardrails';
+const AGENTSPEC_ID = 'example-guardrails';
 const DEFAULT_LOCAL_BASE_URL = import.meta.env.VITE_BASE_URL || 'http://localhost:8765';
 const OTEL_BASE_URL_ENV = import.meta.env.VITE_OTEL_BASE_URL;
 const DATALAYER_RUN_URL_ENV = import.meta.env.DATALAYER_RUN_URL;
@@ -55,7 +55,7 @@ const toNumberOrNull = (value) => {
     return null;
 };
 const resolvePerRunBudgetFromSpec = (agentSpecId) => {
-    const spec = getAgentSpecs(agentSpecId);
+    const spec = getAgentspecs(agentSpecId);
     if (!spec?.guardrails?.length) {
         return null;
     }
@@ -74,7 +74,7 @@ const resolvePerRunBudgetFromSpec = (agentSpecId) => {
     }
     return null;
 };
-const DEFAULT_RUN_BUDGET_USD = resolvePerRunBudgetFromSpec(AGENT_SPEC_ID);
+const DEFAULT_RUN_BUDGET_USD = resolvePerRunBudgetFromSpec(AGENTSPEC_ID);
 const toApprovalRequest = (payload) => ({
     id: payload.id,
     tool_name: payload.tool_name,
@@ -249,7 +249,7 @@ const AgentGuardrailsInner = ({ onLogout, }) => {
                         description: 'Agent with cost budget and tool approval guardrails',
                         agent_library: 'pydantic-ai',
                         transport: 'vercel-ai',
-                        agent_spec_id: AGENT_SPEC_ID,
+                        agent_spec_id: AGENTSPEC_ID,
                         enable_skills: true,
                         tools: [],
                     }),

package/lib/examples/AgentHooksExample.js

@@ -13,7 +13,7 @@ import { useExampleAgentRuntimesUrl } from './utils/useExampleAgentRuntimesUrl';
 import { ErrorView } from './components';
 import { Chat } from '../chat';
 setupPrimerPortals();
-const AGENT_SPEC_ID = 'example-hooks';
+const AGENTSPEC_ID = 'example-hooks';
 const AGENT_NAME = 'hooks-example-agent';
 const AgentHooksExample = () => {
     const baseUrl = useExampleAgentRuntimesUrl();
@@ -30,7 +30,7 @@ const AgentHooksExample = () => {
                     headers: { 'Content-Type': 'application/json' },
                     body: JSON.stringify({
                         name,
-                        agent_spec_id: AGENT_SPEC_ID,
+                        agent_spec_id: AGENTSPEC_ID,
                         transport: 'vercel-ai',
                     }),
                 });
@@ -79,7 +79,7 @@ const AgentHooksExample = () => {
                     height: '100vh',
                     gap: 3,
                     bg: 'canvas.default',
-                }, children: [_jsx(Spinner, { size: "large" }), _jsxs(Text, { sx: { color: 'fg.muted' }, children: ["Creating agent from ", AGENT_SPEC_ID, "..."] })] }) }));
+                }, children: [_jsx(Spinner, { size: "large" }), _jsxs(Text, { sx: { color: 'fg.muted' }, children: ["Creating agent from ", AGENTSPEC_ID, "..."] })] }) }));
     }
     if (error || !agentId) {
         return (_jsx(ThemedProvider, { children: _jsx(ErrorView, { error: "Failed to start hooks agent", detail: error || 'No agent ID returned' }) }));

package/lib/examples/AgentInferenceProviderExample.js

@@ -12,7 +12,7 @@ import { uniqueAgentId } from './utils/agentId';
 import { useSimpleAuthStore } from '@datalayer/core/lib/views/otel';
 import { Chat } from '../chat';
 import { useAIAgentsWebSocket } from '../hooks';
-const AGENT_SPEC_ID = 'example-inference';
+const AGENTSPEC_ID = 'example-inference';
 const AGENT_NAME = 'inference-provider-example-agent';
 const DEFAULT_LOCAL_BASE_URL = import.meta.env.VITE_BASE_URL || 'http://localhost:8765';
 const queryClient = new QueryClient();
@@ -114,7 +114,7 @@ const AgentInferenceProviderExampleInner = () => {
                 body: JSON.stringify({
                     name,
                     transport: 'vercel-ai',
-                    agent_spec_id: AGENT_SPEC_ID,
+                    agent_spec_id: AGENTSPEC_ID,
                     inferenceProvider: nextProvider,
                 }),
             });
@@ -131,7 +131,7 @@ const AgentInferenceProviderExampleInner = () => {
             setAgentId(nextAgentId);
             appendProviderEvent('agent.created', 'Launched local agent runtime', {
                 agentId: nextAgentId,
-                agentSpecId: AGENT_SPEC_ID,
+                agentSpecId: AGENTSPEC_ID,
                 inferenceProvider: nextProvider,
                 baseUrl,
             });
@@ -225,7 +225,7 @@ const AgentInferenceProviderExampleInner = () => {
                                 alignItems: 'center',
                                 flexWrap: 'wrap',
                                 gap: 2,
-                            }, children: [_jsxs(Box, { children: [_jsx(Heading, { as: "h2", sx: { fontSize: 4, mb: 1 }, children: "Agent Inference Provider Example" }), _jsxs(Text, { sx: { color: 'fg.muted', fontSize: 1 }, children: ["Launches a local agent runtime from ", AGENT_SPEC_ID, " and lets you switch between local and datalayer inference."] })] }), _jsx(ProviderBadge, { provider: provider })] }), _jsxs(SegmentedControl, { "aria-label": "Inference provider", fullWidth: true, children: [_jsx(SegmentedControl.Button, { selected: provider === 'local', onClick: () => onProviderChange('local'), children: "local" }), _jsx(SegmentedControl.Button, { selected: provider === 'datalayer', onClick: () => onProviderChange('datalayer'), children: "datalayer" })] }), _jsxs(Box, { sx: {
+                            }, children: [_jsxs(Box, { children: [_jsx(Heading, { as: "h2", sx: { fontSize: 4, mb: 1 }, children: "Agent Inference Provider Example" }), _jsxs(Text, { sx: { color: 'fg.muted', fontSize: 1 }, children: ["Launches a local agent runtime from ", AGENTSPEC_ID, " and lets you switch between local and datalayer inference."] })] }), _jsx(ProviderBadge, { provider: provider })] }), _jsxs(SegmentedControl, { "aria-label": "Inference provider", fullWidth: true, children: [_jsx(SegmentedControl.Button, { selected: provider === 'local', onClick: () => onProviderChange('local'), children: "local" }), _jsx(SegmentedControl.Button, { selected: provider === 'datalayer', onClick: () => onProviderChange('datalayer'), children: "datalayer" })] }), _jsxs(Box, { sx: {
                                 display: 'flex',
                                 gap: 2,
                                 alignItems: 'center',
@@ -248,7 +248,7 @@ const AgentInferenceProviderExampleInner = () => {
                                 borderRadius: 2,
                                 overflow: 'hidden',
                                 bg: 'canvas.default',
-                            }, children: agentId && !isLaunching ? (_jsx(Chat, { protocol: "vercel-ai", baseUrl: baseUrl, agentId: agentId, authToken: token ?? undefined, title: "Agent Inference Provider Example", subtitle: `Spec: ${AGENT_SPEC_ID}`, placeholder: "Ask the inference provider something...", showHeader: true, showNewChatButton: true, showClearButton: false, showModelSelector: true, showToolsMenu: true, showSkillsMenu: true, showTokenUsage: true, autoFocus: true, height: "100%", runtimeId: agentId, historyEndpoint: `${baseUrl}/api/v1/history`, onMessageSent: content => {
+                            }, children: agentId && !isLaunching ? (_jsx(Chat, { protocol: "vercel-ai", baseUrl: baseUrl, agentId: agentId, authToken: token ?? undefined, title: "Agent Inference Provider Example", subtitle: `Spec: ${AGENTSPEC_ID}`, placeholder: "Ask the inference provider something...", showHeader: true, showNewChatButton: true, showClearButton: false, showModelSelector: true, showToolsMenu: true, showSkillsMenu: true, showTokenUsage: true, autoFocus: true, height: "100%", runtimeId: agentId, historyEndpoint: `${baseUrl}/api/v1/history`, onMessageSent: content => {
                                     appendProviderEvent('provider.request', `Sent message via ${provider}`, {
                                         provider,
                                         agentId,

package/lib/examples/AgentMCPExample.js

@@ -21,7 +21,7 @@ import { MCP_SERVER_LIBRARY } from '../specs/mcpServers';
 const queryClient = new QueryClient();
 const AGENT_NAME = 'mcp-example-agent';
 // Must match agentspecs/agentspecs/agents/example-mcp.yaml `id`.
-const AGENT_SPEC_ID = 'example-mcp';
+const AGENTSPEC_ID = 'example-mcp';
 const DEFAULT_LOCAL_BASE_URL = import.meta.env.VITE_BASE_URL || 'http://localhost:8765';
 /* ── Aggregate MCP status helpers ─────────────────────── */
 function deriveAggregate(servers) {
@@ -153,7 +153,7 @@ const AgentMCPInner = ({ onLogout }) => {
                         description: 'MCP example agent – web crawling and research via Tavily',
                         agent_library: 'pydantic-ai',
                         transport: 'vercel-ai',
-                        agent_spec_id: AGENT_SPEC_ID,
+                        agent_spec_id: AGENTSPEC_ID,
                         enable_codemode: false,
                         enable_skills: true,
                         tools: [],

package/lib/examples/AgentMemoryExample.js

@@ -28,7 +28,7 @@ import { Chat } from '../chat';
 import { useExampleAgentRuntimesUrl } from './utils/useExampleAgentRuntimesUrl';
 // ─── Constants ─────────────────────────────────────────────────────────────
 const AGENT_NAME = 'memory-example-agent';
-const AGENT_SPEC_ID = 'example-memory';
+const AGENTSPEC_ID = 'example-memory';
 // ─── Inner component (rendered after auth) ─────────────────────────────────
 const AgentMemoryInner = ({ onLogout }) => {
     const { token } = useSimpleAuthStore();
@@ -66,7 +66,7 @@ const AgentMemoryInner = ({ onLogout }) => {
                         description: 'Agent with Mem0 persistent memory',
                         agent_library: 'pydantic-ai',
                         transport: 'vercel-ai',
-                        agent_spec_id: AGENT_SPEC_ID,
+                        agent_spec_id: AGENTSPEC_ID,
                         enable_skills: true,
                         tools: [],
                     }),

package/lib/examples/AgentMonitoringExample.js

@@ -35,7 +35,7 @@ const queryClient = new QueryClient();
 import { useSimpleAuthStore } from '@datalayer/core/lib/views/otel';
 import { Chat } from '../chat';
 const AGENT_NAME = 'monitoring-example-agent';
-const AGENT_SPEC_ID = 'example-monitoring';
+const AGENTSPEC_ID = 'example-monitoring';
 const DEFAULT_LOCAL_BASE_URL = import.meta.env.VITE_BASE_URL || 'http://localhost:8765';
 const OTEL_BASE_URL_ENV = import.meta.env.VITE_OTEL_BASE_URL;
 const DATALAYER_RUN_URL_ENV = import.meta.env.DATALAYER_RUN_URL;
@@ -90,7 +90,7 @@ const AgentMonitoringInner = ({ onLogout, }) => {
                         description: 'MCP monitoring example – web crawling via Tavily with live cost/token metrics',
                         agent_library: 'pydantic-ai',
                         transport: 'vercel-ai',
-                        agent_spec_id: AGENT_SPEC_ID,
+                        agent_spec_id: AGENTSPEC_ID,
                         enable_skills: true,
                         tools: [],
                     }),

package/lib/examples/AgentNotificationsExample.js

@@ -28,7 +28,7 @@ import { Chat } from '../chat';
 const queryClient = new QueryClient();
 // ─── Constants ─────────────────────────────────────────────────────────────
 const AGENT_NAME = 'notification-example-agent';
-const AGENT_SPEC_ID = 'example-notifications';
+const AGENTSPEC_ID = 'example-notifications';
 const alertVariant = (severity) => {
     if (severity === 'critical')
         return 'danger';
@@ -78,7 +78,7 @@ const AgentNotificationsInner = ({ onLogout, }) => {
                         description: 'Agent with multi-channel notification support',
                         agent_library: 'pydantic-ai',
                         transport: 'vercel-ai',
-                        agent_spec_id: AGENT_SPEC_ID,
+                        agent_spec_id: AGENTSPEC_ID,
                         enable_skills: true,
                         tools: [],
                     }),