@datalayer/agent-runtimes 1.0.1 → 1.0.2

package/lib/components/McpServerManager.d.ts

@@ -17,7 +17,7 @@ export interface McpServerManagerProps {
     disabled?: boolean;
 }
 /**
- * McpServerManager - Manage MCP servers for agent spaces
+ * McpServerManager - Manage MCP servers for agent runtimes
  *
  * Features:
  * - View MCP Catalog servers (predefined, can be enabled on-demand)

package/lib/components/McpServerManager.js

@@ -9,7 +9,7 @@ import { ToolsIcon, PlusIcon, TrashIcon, SyncIcon, ServerIcon, CheckIcon, Search
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
 import { Box } from '@datalayer/primer-addons';
 /**
- * McpServerManager - Manage MCP servers for agent spaces
+ * McpServerManager - Manage MCP servers for agent runtimes
  *
  * Features:
  * - View MCP Catalog servers (predefined, can be enabled on-demand)

package/lib/components/chat/components/Chat.d.ts

@@ -99,7 +99,7 @@ export interface ChatProps {
     /**
      * Runtime ID for conversation persistence.
      * When provided, messages are fetched from the server API on page reload
-     * and prevents message mixing between different agent spaces.
+     * and prevents message mixing between different agent runtimes.
      */
     runtimeId?: string;
     /**

package/lib/components/chat/components/base/ChatBase.d.ts

@@ -427,7 +427,7 @@ export interface ChatBaseProps {
     /**
      * Runtime ID for conversation persistence.
      * When provided, messages are fetched from the server API on page reload
-     * and prevents message mixing between different agent spaces.
+     * and prevents message mixing between different agent runtimes.
      */
     runtimeId?: string;
     /**

package/lib/components/chat/components/base/ChatBase.js

@@ -714,7 +714,7 @@ pendingPrompt, }) {
     // Track previous runtimeId to detect changes
     const prevRuntimeIdRef = useRef(undefined);
     // Clear displayItems and load messages when runtimeId changes
-    // This ensures each agent space has isolated conversation history
+    // This ensures each agent runtime has isolated conversation history
     useEffect(() => {
         // If runtimeId changed, clear displayItems first
         if (runtimeId !== prevRuntimeIdRef.current) {
@@ -1795,7 +1795,9 @@ pendingPrompt, }) {
             }, children: [emptyState?.icon || brandIcon || _jsx(AiAgentIcon, { colored: true, size: 48 }), _jsx(Text, { sx: { fontSize: 2 }, children: emptyState?.title || 'Start a conversation' }), (emptyState?.subtitle || description) && (_jsx(Text, { sx: { fontSize: 1 }, children: emptyState?.subtitle || description })), suggestions && suggestions.length > 0 && (_jsx(LabelGroup, { sx: { mt: 2, justifyContent: 'center' }, children: suggestions.map((suggestion, index) => (_jsx(Label, { variant: "accent", sx: {
                             cursor: 'pointer',
                             '&:hover': {
-                                bg: 'accent.muted',
+                                bg: 'accent.emphasis',
+                                color: 'var(--button-primary-fgColor-rest)',
+                                borderColor: 'accent.emphasis',
                             },
                         }, onClick: () => handleSuggestionClick(suggestion), children: suggestion.title }, index))) }))] }));
     };

package/lib/components/chat/store/conversationStore.d.ts

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

package/lib/components/chat/store/conversationStore.js

@@ -3,11 +3,11 @@
  * Distributed under the terms of the Modified BSD License.
  */
 /**
- * Zustand store for conversation history per runtime/agent space.
+ * Zustand store for conversation history per agent runtime.
  * Stores messages per runtime ID in memory during the session.
  *
  * Key features:
- * - Messages are stored per runtime ID (agent space) in memory
+ * - Messages are stored per runtime ID in memory
  * - On page reload, messages are fetched from the server API
  * - No browser storage persistence - server is the source of truth
  *

package/lib/hooks/index.d.ts

@@ -65,4 +65,12 @@ export { useVercelChat } from './useVercelChat';
  * Datalayer AI Agents REST API hook.
  */
 export * from './useAgents';
+/**
+ * Agent runtimes service hooks for managing agent runtime instances.
+ */
+export * from './useAgentRuntimes';
+/**
+ * Centralized agent catalog store for available agent specs and running agents.
+ */
+export * from './useAgentStore';
 export * from './useNotebookAIAgent';

package/lib/hooks/index.js

@@ -78,4 +78,12 @@ export { useVercelChat } from './useVercelChat';
  * Datalayer AI Agents REST API hook.
  */
 export * from './useAgents';
+/**
+ * Agent runtimes service hooks for managing agent runtime instances.
+ */
+export * from './useAgentRuntimes';
+/**
+ * Centralized agent catalog store for available agent specs and running agents.
+ */
+export * from './useAgentStore';
 export * from './useNotebookAIAgent';

package/lib/hooks/useAgentRuntimes.d.ts

@@ -0,0 +1,350 @@
+import type { AgentSpec } from '../types';
+/**
+ * Agent Runtime data type (mapped from runtimes service).
+ *
+ * Backend RuntimePod fields: pod_name, environment_name, environment_title, uid,
+ * type, given_name, token, ingress, reservation_id, started_at, expired_at, burning_rate.
+ *
+ * We map 'ingress' to 'url' for consistency with the UI.
+ */
+export type AgentRuntimeData = {
+    pod_name: string;
+    id: string;
+    name: string;
+    environment_name: string;
+    environment_title?: string;
+    given_name: string;
+    phase?: string;
+    type: string;
+    started_at?: string;
+    expired_at?: string;
+    burning_rate?: number;
+    status: 'starting' | 'running' | 'paused' | 'terminated' | 'archived';
+    messageCount: number;
+    ingress?: string;
+    url?: string;
+    token?: string;
+    agentSpec?: AgentSpec;
+    agent_spec_id?: string;
+};
+/**
+ * Hook to access all agent runtime operations from the centralized cache.
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   useAgentRuntime,
+ *   useAgentRuntimes,
+ *   useCreateAgentRuntime,
+ *   useDeleteAgentRuntime,
+ *   useRefreshAgentRuntimes,
+ * } = useAgentRuntimesCache();
+ * ```
+ */
+export declare function useAgentRuntimesCache(): {
+    useAgentRuntime: (podName: string | undefined) => import("@tanstack/react-query").UseQueryResult<{
+        status: "running" | "paused" | "starting" | "terminated" | "archived";
+        name: string;
+        id: string;
+        url: string | undefined;
+        messageCount: number;
+        agent_spec_id: string | undefined;
+        pod_name: string;
+        environment_name: string;
+        environment_title?: string;
+        given_name: string;
+        phase?: string;
+        type: string;
+        started_at?: string;
+        expired_at?: string;
+        burning_rate?: number;
+        ingress?: string;
+        token?: string;
+        agentSpec?: any;
+    }, Error>;
+    useAgentRuntimes: () => import("@tanstack/react-query").UseQueryResult<{
+        status: "running" | "paused" | "starting" | "terminated" | "archived";
+        name: string;
+        id: string;
+        url: string | undefined;
+        messageCount: number;
+        agent_spec_id: string | undefined;
+        pod_name: string;
+        environment_name: string;
+        environment_title?: string;
+        given_name: string;
+        phase?: string;
+        type: string;
+        started_at?: string;
+        expired_at?: string;
+        burning_rate?: number;
+        ingress?: string;
+        token?: string;
+        agentSpec?: any;
+    }[], Error>;
+    useCreateAgentRuntime: () => import("@tanstack/react-query").UseMutationResult<any, Error, {
+        environmentName?: string;
+        givenName?: string;
+        creditsLimit?: number;
+        type?: string;
+        editorVariant?: string;
+        enableCodemode?: boolean;
+        agentSpecId?: string;
+    }, unknown>;
+    useDeleteAgentRuntime: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+    useRefreshAgentRuntimes: () => () => void;
+    queryKeys: {
+        readonly auth: {
+            readonly me: () => readonly ["auth", "me"];
+            readonly whoami: () => readonly ["auth", "whoami"];
+        };
+        readonly users: {
+            readonly all: () => readonly ["users"];
+            readonly lists: () => readonly ["users", "list"];
+            readonly list: (filters?: string) => readonly ["users", "list", {
+                readonly filters: string | undefined;
+            }];
+            readonly details: () => readonly ["users", "detail"];
+            readonly detail: (id: string) => readonly ["users", "detail", string];
+            readonly byHandle: (handle: string) => readonly ["users", "handle", string];
+            readonly search: (pattern: string) => readonly ["users", "search", string];
+            readonly settings: (userId: string) => readonly ["users", "detail", string, "settings"];
+            readonly onboarding: (userId: string) => readonly ["users", "detail", string, "onboarding"];
+            readonly surveys: (userId: string) => readonly ["users", "detail", string, "surveys"];
+            readonly credits: (userId: string) => readonly ["users", "detail", string, "credits"];
+        };
+        readonly organizations: {
+            readonly all: () => readonly ["organizations"];
+            readonly lists: () => readonly ["organizations", "list"];
+            readonly details: () => readonly ["organizations", "detail"];
+            readonly detail: (id: string) => readonly ["organizations", "detail", string];
+            readonly byHandle: (handle: string) => readonly ["organizations", "handle", string];
+            readonly userOrgs: () => readonly ["organizations", "user"];
+            readonly members: (orgId: string) => readonly ["organizations", "detail", string, "members"];
+        };
+        readonly teams: {
+            readonly all: () => readonly ["teams"];
+            readonly details: () => readonly ["teams", "detail"];
+            readonly detail: (id: string) => readonly ["teams", "detail", string];
+            readonly byHandle: (handle: string) => readonly ["teams", "handle", string];
+            readonly byOrganization: (orgId: string) => readonly ["teams", "organization", string];
+            readonly members: (teamId: string) => readonly ["teams", "detail", string, "members"];
+        };
+        readonly spaces: {
+            readonly all: () => readonly ["spaces"];
+            readonly details: () => readonly ["spaces", "detail"];
+            readonly detail: (id: string) => readonly ["spaces", "detail", string];
+            readonly byHandle: (handle: string) => readonly ["spaces", "handle", string];
+            readonly byOrganization: (orgId: string) => readonly ["spaces", "organization", string];
+            readonly orgSpaceByHandle: (orgId: string, handle: string) => readonly ["spaces", "organization", string, "handle", string];
+            readonly byOrganizationAndHandle: (orgHandle: string, spaceHandle: string) => readonly ["spaces", "organization", string, "space", string];
+            readonly userSpaces: () => readonly ["spaces", "user"];
+            readonly items: (spaceId: string) => readonly ["spaces", "detail", string, "items"];
+            readonly members: (spaceId: string) => readonly ["spaces", "detail", string, "members"];
+        };
+        readonly notebooks: {
+            readonly all: () => readonly ["notebooks"];
+            readonly details: () => readonly ["notebooks", "detail"];
+            readonly detail: (id: string) => readonly ["notebooks", "detail", string];
+            readonly bySpace: (spaceId: string) => readonly ["notebooks", "space", string];
+            readonly model: (notebookId: string) => readonly ["notebooks", "detail", string, "model"];
+        };
+        readonly documents: {
+            readonly all: () => readonly ["documents"];
+            readonly details: () => readonly ["documents", "detail"];
+            readonly detail: (id: string) => readonly ["documents", "detail", string];
+            readonly bySpace: (spaceId: string) => readonly ["documents", "space", string];
+            readonly model: (documentId: string) => readonly ["documents", "detail", string, "model"];
+        };
+        readonly cells: {
+            readonly all: () => readonly ["cells"];
+            readonly details: () => readonly ["cells", "detail"];
+            readonly detail: (id: string) => readonly ["cells", "detail", string];
+            readonly bySpace: (spaceId: string) => readonly ["cells", "space", string];
+        };
+        readonly datasets: {
+            readonly all: () => readonly ["datasets"];
+            readonly details: () => readonly ["datasets", "detail"];
+            readonly detail: (id: string) => readonly ["datasets", "detail", string];
+            readonly bySpace: (spaceId: string) => readonly ["datasets", "space", string];
+        };
+        readonly lessons: {
+            readonly all: () => readonly ["lessons"];
+            readonly details: () => readonly ["lessons", "detail"];
+            readonly detail: (id: string) => readonly ["lessons", "detail", string];
+            readonly bySpace: (spaceId: string) => readonly ["lessons", "space", string];
+        };
+        readonly exercises: {
+            readonly all: () => readonly ["exercises"];
+            readonly details: () => readonly ["exercises", "detail"];
+            readonly detail: (id: string) => readonly ["exercises", "detail", string];
+            readonly bySpace: (spaceId: string) => readonly ["exercises", "space", string];
+        };
+        readonly assignments: {
+            readonly all: () => readonly ["assignments"];
+            readonly details: () => readonly ["assignments", "detail"];
+            readonly detail: (id: string) => readonly ["assignments", "detail", string];
+            readonly bySpace: (spaceId: string) => readonly ["assignments", "space", string];
+            readonly forStudent: (assignmentId: string, courseId: string, studentId: string) => readonly ["assignments", "detail", string, "course", string, "student", string];
+            readonly studentVersion: (assignmentId: string) => readonly ["assignments", "detail", string, "studentVersion"];
+        };
+        readonly environments: {
+            readonly all: () => readonly ["environments"];
+            readonly details: () => readonly ["environments", "detail"];
+            readonly detail: (id: string) => readonly ["environments", "detail", string];
+            readonly bySpace: (spaceId: string) => readonly ["environments", "space", string];
+        };
+        readonly pages: {
+            readonly all: () => readonly ["pages"];
+            readonly details: () => readonly ["pages", "detail"];
+            readonly detail: (id: string) => readonly ["pages", "detail", string];
+        };
+        readonly datasources: {
+            readonly all: () => readonly ["datasources"];
+            readonly details: () => readonly ["datasources", "detail"];
+            readonly detail: (id: string) => readonly ["datasources", "detail", string];
+        };
+        readonly secrets: {
+            readonly all: () => readonly ["secrets"];
+            readonly details: () => readonly ["secrets", "detail"];
+            readonly detail: (id: string) => readonly ["secrets", "detail", string];
+        };
+        readonly tokens: {
+            readonly all: () => readonly ["tokens"];
+            readonly details: () => readonly ["tokens", "detail"];
+            readonly detail: (id: string) => readonly ["tokens", "detail", string];
+        };
+        readonly contacts: {
+            readonly all: () => readonly ["contacts"];
+            readonly lists: () => readonly ["contacts", "list"];
+            readonly details: () => readonly ["contacts", "detail"];
+            readonly detail: (id: string) => readonly ["contacts", "detail", string];
+            readonly byHandle: (handle: string) => readonly ["contacts", "handle", string];
+            readonly search: (query: string) => readonly ["contacts", "search", string];
+        };
+        readonly invites: {
+            readonly all: () => readonly ["invites"];
+            readonly byToken: (token: string) => readonly ["invites", "token", string];
+            readonly byAccount: (accountId: string) => readonly ["invites", "account", string];
+        };
+        readonly courses: {
+            readonly all: () => readonly ["courses"];
+            readonly details: () => readonly ["courses", "detail"];
+            readonly detail: (id: string) => readonly ["courses", "detail", string];
+            readonly public: () => readonly ["courses", "public"];
+            readonly instructor: (instructorId: string) => readonly ["courses", "instructor", string];
+            readonly enrollments: () => readonly ["courses", "enrollments", "me"];
+            readonly students: (courseId: string) => readonly ["courses", "detail", string, "students"];
+            readonly student: (courseId: string, studentId: string) => readonly ["courses", "detail", string, "student", string];
+        };
+        readonly schools: {
+            readonly all: () => readonly ["schools"];
+        };
+        readonly inbounds: {
+            readonly all: () => readonly ["inbounds"];
+            readonly detail: (id: string) => readonly ["inbounds", string];
+            readonly byHandle: (handle: string) => readonly ["inbounds", "handle", string];
+        };
+        readonly outbounds: {
+            readonly all: () => readonly ["outbounds"];
+            readonly detail: (id: string) => readonly ["outbounds", string];
+        };
+        readonly items: {
+            readonly all: () => readonly ["items"];
+            readonly public: () => readonly ["items", "public"];
+            readonly bySpace: (spaceId: string) => readonly ["items", "space", string];
+            readonly search: (opts: import("@datalayer/core").ISearchOpts) => readonly ["items", "search", import("@datalayer/core").ISearchOpts];
+        };
+        readonly agentRuntimes: {
+            readonly all: () => readonly ["agentRuntimes"];
+            readonly lists: () => readonly ["agentRuntimes", "list"];
+            readonly details: () => readonly ["agentRuntimes", "detail"];
+            readonly detail: (podName: string) => readonly ["agentRuntimes", "detail", string];
+        };
+        readonly layout: {
+            readonly byAccount: (accountHandle: string, spaceHandle?: string) => readonly ["layout", string, string] | readonly ["layout", string];
+        };
+        readonly usages: {
+            readonly user: () => readonly ["usages", "user"];
+            readonly userById: (userId: string) => readonly ["usages", "user", string];
+            readonly platform: () => readonly ["usages", "platform"];
+        };
+        readonly prices: {
+            readonly stripe: () => readonly ["prices", "stripe"];
+        };
+        readonly growth: {
+            readonly kpi: () => readonly ["growth", "kpi"];
+        };
+        readonly oauth2: {
+            readonly authorizationUrl: (queryArgs: Record<string, string>) => readonly ["oauth2", "authz", "url", Record<string, string>];
+            readonly authorizationLinkUrl: (queryArgs: Record<string, string>) => readonly ["oauth2", "authz", "url", "link", Record<string, string>];
+        };
+    };
+};
+/**
+ * Hook to fetch user's agent runtimes (running agent instances).
+ * Used by the sidebar to show running/paused/terminated agents.
+ */
+export declare function useAgentRuntimes(): import("@tanstack/react-query").UseQueryResult<{
+    status: "running" | "paused" | "starting" | "terminated" | "archived";
+    name: string;
+    id: string;
+    url: string | undefined;
+    messageCount: number;
+    agent_spec_id: string | undefined;
+    pod_name: string;
+    environment_name: string;
+    environment_title?: string;
+    given_name: string;
+    phase?: string;
+    type: string;
+    started_at?: string;
+    expired_at?: string;
+    burning_rate?: number;
+    ingress?: string;
+    token?: string;
+    agentSpec?: any;
+}[], Error>;
+/**
+ * Hook to fetch a single agent runtime by pod name.
+ */
+export declare function useAgentRuntimeByPodName(podName: string | undefined): import("@tanstack/react-query").UseQueryResult<{
+    status: "running" | "paused" | "starting" | "terminated" | "archived";
+    name: string;
+    id: string;
+    url: string | undefined;
+    messageCount: number;
+    agent_spec_id: string | undefined;
+    pod_name: string;
+    environment_name: string;
+    environment_title?: string;
+    given_name: string;
+    phase?: string;
+    type: string;
+    started_at?: string;
+    expired_at?: string;
+    burning_rate?: number;
+    ingress?: string;
+    token?: string;
+    agentSpec?: any;
+}, Error>;
+/**
+ * Hook to create a new agent runtime.
+ */
+export declare function useCreateAgentRuntime(): import("@tanstack/react-query").UseMutationResult<any, Error, {
+    environmentName?: string;
+    givenName?: string;
+    creditsLimit?: number;
+    type?: string;
+    editorVariant?: string;
+    enableCodemode?: boolean;
+    agentSpecId?: string;
+}, unknown>;
+/**
+ * Hook to delete an agent runtime.
+ */
+export declare function useDeleteAgentRuntime(): import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+/**
+ * Hook to refresh agent runtimes list.
+ */
+export declare function useRefreshAgentRuntimes(): () => void;

package/lib/hooks/useAgentRuntimes.js

@@ -0,0 +1,78 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * Hooks for managing Agent Runtimes (running agent instances).
+ *
+ * Agent Runtimes are backed by the datalayer-runtimes service (K8s pods).
+ * A project (space with variant="project") can have an agent runtime attached
+ * via its `attachedAgentPodName` field.
+ *
+ * @module hooks/useAgentRuntimes
+ */
+import { useCache } from '@datalayer/core/lib/hooks';
+/**
+ * Hook to access all agent runtime operations from the centralized cache.
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   useAgentRuntime,
+ *   useAgentRuntimes,
+ *   useCreateAgentRuntime,
+ *   useDeleteAgentRuntime,
+ *   useRefreshAgentRuntimes,
+ * } = useAgentRuntimesCache();
+ * ```
+ */
+export function useAgentRuntimesCache() {
+    const cache = useCache();
+    return {
+        useAgentRuntime: cache.useAgentRuntime,
+        useAgentRuntimes: cache.useAgentRuntimes,
+        useCreateAgentRuntime: cache.useCreateAgentRuntime,
+        useDeleteAgentRuntime: cache.useDeleteAgentRuntime,
+        useRefreshAgentRuntimes: cache.useRefreshAgentRuntimes,
+        queryKeys: cache.queryKeys,
+    };
+}
+// ============================================================================
+// Agent Runtimes Hooks (from datalayer-runtimes service)
+// ============================================================================
+/**
+ * Hook to fetch user's agent runtimes (running agent instances).
+ * Used by the sidebar to show running/paused/terminated agents.
+ */
+export function useAgentRuntimes() {
+    const { useAgentRuntimes: hook } = useCache();
+    return hook();
+}
+/**
+ * Hook to fetch a single agent runtime by pod name.
+ */
+export function useAgentRuntimeByPodName(podName) {
+    const { useAgentRuntime: hook } = useCache();
+    return hook(podName);
+}
+/**
+ * Hook to create a new agent runtime.
+ */
+export function useCreateAgentRuntime() {
+    const { useCreateAgentRuntime: hook } = useCache();
+    return hook();
+}
+/**
+ * Hook to delete an agent runtime.
+ */
+export function useDeleteAgentRuntime() {
+    const { useDeleteAgentRuntime: hook } = useCache();
+    return hook();
+}
+/**
+ * Hook to refresh agent runtimes list.
+ */
+export function useRefreshAgentRuntimes() {
+    const { useRefreshAgentRuntimes: hook } = useCache();
+    return hook();
+}

package/lib/hooks/useAgentStore.d.ts

@@ -0,0 +1,30 @@
+import type { AgentSpec } from '../types';
+import type { AgentRuntimeData } from './useAgentRuntimes';
+/**
+ * Centralised Zustand store for agents.
+ *
+ * Two collections are maintained:
+ *
+ * 1. **agentSpecs** – the static catalogue of available agent blueprints
+ *    (from `@datalayer/agent-runtimes/lib/specs`).
+ *    Populated once at import time; call `refreshSpecs()` to re-read.
+ *
+ * 2. **runningAgents** – live agent runtimes fetched from the runtimes
+ *    service.  Updated via `setRunningAgents()` whenever the TanStack
+ *    query refreshes.
+ *
+ * The store is consumed by `AgentAssignMenu` to show two action groups:
+ * • **Running Agents** – already-running runtimes that can be re-attached
+ * • **New Agents** – agent specs that can be instantiated
+ */
+export type AgentStoreState = {
+    /** Static catalogue of agent blueprints. */
+    agentSpecs: AgentSpec[];
+    /** Live agent runtimes (running / starting). */
+    runningAgents: AgentRuntimeData[];
+    /** Re-read agent specs from the config. */
+    refreshSpecs: () => void;
+    /** Replace the running agents list (call from TanStack query effect). */
+    setRunningAgents: (agents: AgentRuntimeData[]) => void;
+};
+export declare const useAgentCatalogStore: import("zustand").UseBoundStore<import("zustand").StoreApi<AgentStoreState>>;

package/lib/hooks/useAgentStore.js

@@ -0,0 +1,22 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+import { create } from 'zustand';
+import { listAgentSpecs } from '../specs';
+// ── Store ──────────────────────────────────────────────────────────────────
+export const useAgentCatalogStore = create()(set => ({
+    agentSpecs: listAgentSpecs('datalayer-ai/'),
+    runningAgents: [],
+    refreshSpecs: () => set({ agentSpecs: listAgentSpecs('datalayer-ai/') }),
+    setRunningAgents: agents => set(state => ({
+        runningAgents: agents.map(agent => {
+            if (agent.agentSpec)
+                return agent;
+            if (!agent.agent_spec_id)
+                return agent;
+            const spec = state.agentSpecs.find(s => s.id === agent.agent_spec_id);
+            return spec ? { ...agent, agentSpec: spec } : agent;
+        }),
+    })),
+}));

package/lib/specs/agents/codeai/agents.d.ts

@@ -1,7 +1,7 @@
 /**
  * Agent Library.
  *
- * Predefined agent specifications that can be instantiated as AgentSpaces.
+ * Predefined agent specifications that can be instantiated as Agent Runtimes.
  * THIS FILE IS AUTO-GENERATED. DO NOT EDIT MANUALLY.
  * Generated from YAML specifications in specs/agents/
  */

package/lib/specs/agents/codeai/agents.js

@@ -79,6 +79,20 @@ export const DATA_ACQUISITION_AGENT_SPEC = {
 ## Recommended Workflow 1. **Discover**: Use list_servers and search_tools to find relevant tools 2. **Understand**: Use get_tool_details to check parameters 3. **Execute**: Use execute_code to perform multi-step tasks, calling tools as needed
 ## Token Efficiency When possible, chain multiple tool calls in a single execute_code block. This reduces output tokens by processing intermediate results in code rather than returning them. If you want to examine results, print subsets, preview (maximum 20 first characters) and/or counts instead of full data, this is really important.
 `,
+    goal: undefined,
+    protocol: undefined,
+    uiExtension: undefined,
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: undefined,
+    output: undefined,
+    advanced: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    team: undefined,
 };
 export const SIMPLE_AGENT_SPEC = {
     id: 'codeai/simple',
@@ -103,6 +117,20 @@ export const SIMPLE_AGENT_SPEC = {
     systemPrompt: `You are a helpful, friendly AI assistant. You do not have access to any external tools, MCP servers, or skills. Answer questions using your training knowledge, be concise, and let the user know if a question is outside your knowledge.
 `,
     systemPromptCodemodeAddons: undefined,
+    goal: undefined,
+    protocol: undefined,
+    uiExtension: undefined,
+    trigger: undefined,
+    modelConfig: undefined,
+    mcpServerTools: undefined,
+    guardrails: undefined,
+    evals: undefined,
+    codemode: undefined,
+    output: undefined,
+    advanced: undefined,
+    authorizationPolicy: undefined,
+    notifications: undefined,
+    team: undefined,
 };
 // ============================================================================
 // Agent Specs Registry

package/lib/specs/agents/codemode-paper/agents.d.ts

@@ -1,7 +1,7 @@
 /**
  * Agent Library.
  *
- * Predefined agent specifications that can be instantiated as AgentSpaces.
+ * Predefined agent specifications that can be instantiated as Agent Runtimes.
  * THIS FILE IS AUTO-GENERATED. DO NOT EDIT MANUALLY.
  * Generated from YAML specifications in specs/agents/
  */