@datalayer/agent-runtimes 1.0.9 → 1.0.10

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: [],
                     }),

package/lib/examples/AgentOtelExample.js

@@ -43,7 +43,7 @@ const AGENT_BASE_URL_ENV = import.meta.env.VITE_BASE_URL || '';
 const DEFAULT_AGENT_PROTOCOL = 'vercel-ai';
 const DEFAULT_AGENT_LIBRARY = 'pydantic-ai';
 /** Spec id this example always launches. */
-const AGENT_SPEC_ID = 'example-otel';
+const AGENTSPEC_ID = 'example-otel';
 /**
  * Small form for picking an agent spec and launching it.
  * Renders as the `children` of the ChatSidebar so it appears above the chat.
@@ -61,11 +61,11 @@ const AgentLaunchPanel = ({ baseUrl, onConnected, onDisconnected, isConnected, c
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
                 body: JSON.stringify({
-                    name: AGENT_SPEC_ID,
+                    name: AGENTSPEC_ID,
                     description: `Launched from AgentOtelExample`,
                     agent_library: DEFAULT_AGENT_LIBRARY,
                     transport,
-                    agent_spec_id: AGENT_SPEC_ID,
+                    agent_spec_id: AGENTSPEC_ID,
                 }),
             });
             if (!res.ok) {
@@ -74,7 +74,7 @@ const AgentLaunchPanel = ({ baseUrl, onConnected, onDisconnected, isConnected, c
                 // Reuse existing agent when backend reports duplicate creation.
                 if (res.status === 409 || /already exists/i.test(detail)) {
                     const idMatch = detail.match(/Agent with ID '([^']+)' already exists/i);
-                    const existingId = idMatch?.[1] || AGENT_SPEC_ID;
+                    const existingId = idMatch?.[1] || AGENTSPEC_ID;
                     onConnected(existingId, transport);
                     return;
                 }
@@ -121,7 +121,7 @@ const AgentLaunchPanel = ({ baseUrl, onConnected, onDisconnected, isConnected, c
             gap: 2,
             flexShrink: 0,
             bg: 'canvas.subtle',
-        }, children: [_jsx(Text, { sx: { fontSize: 0, fontWeight: 'bold', color: 'fg.muted' }, children: "AGENT" }), loading ? (_jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 2 }, children: [_jsx(Spinner, { size: "small" }), _jsxs(Text, { sx: { fontSize: 1, color: 'fg.muted' }, children: ["Launching ", AGENT_SPEC_ID, "\u2026"] })] })) : error ? (_jsxs(_Fragment, { children: [_jsx(Text, { sx: { fontSize: 1, color: 'danger.fg' }, children: error }), _jsx(Button, { variant: "primary", size: "small", onClick: handleLaunch, leadingVisual: PlugIcon, sx: { width: '100%' }, children: "Retry" })] })) : (_jsxs(Text, { sx: { fontSize: 1, color: 'fg.muted' }, children: ["Launching ", AGENT_SPEC_ID, "\u2026"] }))] }));
+        }, children: [_jsx(Text, { sx: { fontSize: 0, fontWeight: 'bold', color: 'fg.muted' }, children: "AGENT" }), loading ? (_jsxs(Box, { sx: { display: 'flex', alignItems: 'center', gap: 2 }, children: [_jsx(Spinner, { size: "small" }), _jsxs(Text, { sx: { fontSize: 1, color: 'fg.muted' }, children: ["Launching ", AGENTSPEC_ID, "\u2026"] })] })) : error ? (_jsxs(_Fragment, { children: [_jsx(Text, { sx: { fontSize: 1, color: 'danger.fg' }, children: error }), _jsx(Button, { variant: "primary", size: "small", onClick: handleLaunch, leadingVisual: PlugIcon, sx: { width: '100%' }, children: "Retry" })] })) : (_jsxs(Text, { sx: { fontSize: 1, color: 'fg.muted' }, children: ["Launching ", AGENTSPEC_ID, "\u2026"] }))] }));
 };
 const TAB_SX = (active) => ({
     px: 3,

package/lib/examples/AgentOutputsExample.js

@@ -34,7 +34,7 @@ import { useChatStore } from '../stores/chatStore';
 const queryClient = new QueryClient();
 // ─── Constants ─────────────────────────────────────────────────────────────
 const AGENT_NAME = 'outputs-example-agent';
-const AGENT_SPEC_ID = 'demo-outputs';
+const AGENTSPEC_ID = 'demo-outputs';
 const DEFAULT_LOCAL_BASE_URL = import.meta.env.VITE_BASE_URL || 'http://localhost:8765';
 // ─── Output detection ──────────────────────────────────────────────────────
 const FENCE_RE = /```([a-zA-Z0-9_+-]*)\n([\s\S]*?)```/g;
@@ -306,7 +306,7 @@ const AgentOutputsInner = ({ onLogout, }) => {
                         description: 'Agent with rich output rendering (table/JSON/chart/file)',
                         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/AgentParametersExample.js

@@ -15,7 +15,7 @@ import { useExampleAgentRuntimesUrl } from './utils/useExampleAgentRuntimesUrl';
 import { ErrorView } from './components';
 import { Chat } from '../chat';
 setupPrimerPortals();
-const AGENT_SPEC_ID = 'example-parameters';
+const AGENTSPEC_ID = 'example-parameters';
 const AGENT_NAME = 'parameters-demo';
 function isRecord(value) {
     return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
@@ -123,7 +123,7 @@ const AgentParametersExample = () => {
         setIsSchemaLoading(true);
         setError(null);
         try {
-            const response = await fetch(`${baseUrl}/api/v1/agents/library/${AGENT_SPEC_ID}`);
+            const response = await fetch(`${baseUrl}/api/v1/agents/library/${AGENTSPEC_ID}`);
             if (!response.ok) {
                 throw new Error(`Failed to load schema: ${response.status}`);
             }
@@ -154,7 +154,7 @@ const AgentParametersExample = () => {
                 headers: { 'Content-Type': 'application/json' },
                 body: JSON.stringify({
                     name,
-                    agent_spec_id: AGENT_SPEC_ID,
+                    agent_spec_id: AGENTSPEC_ID,
                     transport: 'vercel-ai',
                     agent_parameters: formData,
                 }),
@@ -206,7 +206,7 @@ const AgentParametersExample = () => {
                             alignItems: 'center',
                             gap: 2,
                             flexWrap: 'wrap',
-                        }, children: [_jsxs(Label, { variant: "accent", children: ["Spec: ", AGENT_SPEC_ID] }), _jsx(Label, { variant: "secondary", children: "Transport: vercel-ai" })] }), _jsxs(Box, { sx: { display: 'flex', gap: 2, flexWrap: 'wrap' }, children: [_jsx(Button, { variant: "primary", size: "small", type: "button", onClick: loadSchemaForm, disabled: isSchemaLoading, children: isSchemaLoading ? (_jsxs(_Fragment, { children: [_jsx(Spinner, { size: "small" }), " Loading Schema..."] })) : ('Show Parameter Form') }), schema && (_jsx(Button, { variant: "invisible", size: "small", type: "button", onClick: () => {
+                        }, children: [_jsxs(Label, { variant: "accent", children: ["Spec: ", AGENTSPEC_ID] }), _jsx(Label, { variant: "secondary", children: "Transport: vercel-ai" })] }), _jsxs(Box, { sx: { display: 'flex', gap: 2, flexWrap: 'wrap' }, children: [_jsx(Button, { variant: "primary", size: "small", type: "button", onClick: loadSchemaForm, disabled: isSchemaLoading, children: isSchemaLoading ? (_jsxs(_Fragment, { children: [_jsx(Spinner, { size: "small" }), " Loading Schema..."] })) : ('Show Parameter Form') }), schema && (_jsx(Button, { variant: "invisible", size: "small", type: "button", onClick: () => {
                                     setShowSchemaForm(v => !v);
                                 }, children: showSchemaForm ? 'Hide Form' : 'Show Form' }))] }), schema && (_jsxs(Box, { sx: {
                             display: 'flex',