@datalayer/agent-runtimes 1.0.1 → 1.0.3

package/lib/state/substates/AIAgentState.d.ts

@@ -1,80 +0,0 @@
-import type { Transport } from '../../components/chat/components/Chat';
-export type AgentStatus = 'running' | 'paused' | 'initializing' | 'error';
-/**
- * Unified Agent model combining runtime tracking and UI state
- */
-export interface Agent {
-    /** Unique agent identifier */
-    id: string;
-    /** Display name */
-    name: string;
-    /** Agent description */
-    description: string;
-    /** Base URL for the agent (for Jupyter: baseUrl, for FastAPI: baseUrl) */
-    baseUrl: string;
-    /** Transport protocol used */
-    transport: Transport;
-    /** Current status */
-    status: AgentStatus;
-    /** Last error message if status is 'error' */
-    error?: string | null;
-    /** Timestamp of last update */
-    lastUpdated: number;
-    /** Document ID (for document-based agents) */
-    documentId?: string;
-    /** Runtime ID (for Jupyter kernel-based agents) */
-    runtimeId?: string;
-    /** Author name (optional, for display) */
-    author?: string;
-    /** Avatar URL (optional, for display) */
-    avatarUrl?: string;
-}
-export type AgentState = {
-    /** All registered agents */
-    agents: readonly Agent[];
-    /** Add or update an agent */
-    upsertAgent: (agent: Partial<Agent> & {
-        id: string;
-        baseUrl: string;
-        transport: Transport;
-    }) => void;
-    /** Get agent by ID */
-    getAgentById: (id: string) => Agent | undefined;
-    /** Get agent by baseUrl and transport */
-    getAgentByUrl: (baseUrl: string, transport: Transport) => Agent | undefined;
-    /** Update agent status */
-    updateAgentStatus: (id: string, status: AgentStatus, error?: string | null) => void;
-    /** Toggle agent status between running/paused */
-    toggleAgentStatus: (id: string) => void;
-    /** Delete an agent */
-    deleteAgent: (id: string) => void;
-    /** Clear all agents */
-    clearAgents: () => void;
-};
-export declare const agentStore: Omit<import("zustand").StoreApi<AgentState>, "persist"> & {
-    persist: {
-        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<AgentState, unknown>>) => void;
-        clearStorage: () => void;
-        rehydrate: () => Promise<void> | void;
-        hasHydrated: () => boolean;
-        onHydrate: (fn: (state: AgentState) => void) => () => void;
-        onFinishHydration: (fn: (state: AgentState) => void) => () => void;
-        getOptions: () => Partial<import("zustand/middleware").PersistOptions<AgentState, unknown>>;
-    };
-};
-export declare function useAgentStore(): AgentState;
-export declare function useAgentStore<T>(selector: (state: AgentState) => T): T;
-export type AIAgentState = AgentState;
-export declare const aiAgentStore: Omit<import("zustand").StoreApi<AgentState>, "persist"> & {
-    persist: {
-        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<AgentState, unknown>>) => void;
-        clearStorage: () => void;
-        rehydrate: () => Promise<void> | void;
-        hasHydrated: () => boolean;
-        onHydrate: (fn: (state: AgentState) => void) => () => void;
-        onFinishHydration: (fn: (state: AgentState) => void) => () => void;
-        getOptions: () => Partial<import("zustand/middleware").PersistOptions<AgentState, unknown>>;
-    };
-};
-export declare const useAIAgentStore: typeof useAgentStore;
-export default useAgentStore;

package/lib/state/substates/AIAgentState.js

@@ -1,108 +0,0 @@
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-import { createStore } from 'zustand/vanilla';
-import { useStore } from 'zustand';
-import { persist, createJSONStorage } from 'zustand/middleware';
-export const agentStore = createStore()(persist((set, get) => ({
-    agents: [],
-    upsertAgent: agentData => {
-        set(state => {
-            const existingIndex = state.agents.findIndex(a => a.id === agentData.id);
-            const now = Date.now();
-            if (existingIndex >= 0) {
-                // Update existing agent
-                const updatedAgents = [...state.agents];
-                updatedAgents[existingIndex] = {
-                    ...updatedAgents[existingIndex],
-                    ...agentData,
-                    lastUpdated: now,
-                };
-                return { agents: updatedAgents };
-            }
-            else {
-                // Add new agent
-                const newAgent = {
-                    name: agentData.name || agentData.id,
-                    description: agentData.description || '',
-                    status: agentData.status || 'initializing',
-                    lastUpdated: now,
-                    ...agentData,
-                };
-                return { agents: [...state.agents, newAgent] };
-            }
-        });
-    },
-    getAgentById: (id) => {
-        const { agents } = get();
-        return agents.find(agent => agent.id === id);
-    },
-    getAgentByUrl: (baseUrl, transport) => {
-        const { agents } = get();
-        return agents.find(agent => agent.baseUrl === baseUrl && agent.transport === transport);
-    },
-    updateAgentStatus: (id, status, error = null) => {
-        set(state => {
-            const index = state.agents.findIndex(a => a.id === id);
-            if (index >= 0) {
-                const updatedAgents = [...state.agents];
-                updatedAgents[index] = {
-                    ...updatedAgents[index],
-                    status,
-                    error,
-                    lastUpdated: Date.now(),
-                };
-                return { agents: updatedAgents };
-            }
-            return {};
-        });
-    },
-    toggleAgentStatus: (id) => {
-        set(state => {
-            const index = state.agents.findIndex(a => a.id === id);
-            if (index >= 0) {
-                const updatedAgents = [...state.agents];
-                const currentStatus = updatedAgents[index].status;
-                updatedAgents[index] = {
-                    ...updatedAgents[index],
-                    status: currentStatus === 'running' ? 'paused' : 'running',
-                    lastUpdated: Date.now(),
-                };
-                return { agents: updatedAgents };
-            }
-            return {};
-        });
-    },
-    deleteAgent: (id) => {
-        set(state => ({
-            agents: state.agents.filter(a => a.id !== id),
-        }));
-    },
-    clearAgents: () => {
-        set({ agents: [] });
-    },
-}), {
-    name: 'agent-runtimes-storage',
-    storage: createJSONStorage(() => localStorage),
-    // Only persist essential fields
-    partialize: state => ({
-        agents: state.agents.map(agent => ({
-            id: agent.id,
-            name: agent.name,
-            description: agent.description,
-            baseUrl: agent.baseUrl,
-            transport: agent.transport,
-            status: agent.status,
-            lastUpdated: agent.lastUpdated,
-            documentId: agent.documentId,
-            runtimeId: agent.runtimeId,
-        })),
-    }),
-}));
-export function useAgentStore(selector) {
-    return useStore(agentStore, selector);
-}
-export const aiAgentStore = agentStore;
-export const useAIAgentStore = useAgentStore;
-export default useAgentStore;

package/lib/state/substates/index.d.ts

@@ -1 +0,0 @@
-export * from './AIAgentState';

package/lib/state/substates/index.js

@@ -1,5 +0,0 @@
-/*
- * Copyright (c) 2025-2026 Datalayer, Inc.
- * Distributed under the terms of the Modified BSD License.
- */
-export * from './AIAgentState';

package/lib/types/AIAgent.d.ts

@@ -1,17 +0,0 @@
-/**
- * AI Agent model
- */
-export type IAIAgent = {
-    /**
-     * ID of the document monitored by the agent.
-     */
-    documentId: string;
-    /**
-     * ID of the runtime connected to the agent.
-     *
-     * This is not the name of the remote pod but
-     * the Simple Kernel ID of the process within it.
-     */
-    runtimeId?: string;
-};
-export default IAIAgent;

package/lib/types/Types.d.ts

@@ -1,189 +0,0 @@
-/**
- * Status of an agent.
- */
-export type AgentStatus = 'starting' | 'running' | 'paused' | 'terminated' | 'archived';
-export type Transport = 'acp' | 'ag-ui' | 'vercel-ai' | 'a2a';
-export interface Agent {
-    id: string;
-    name: string;
-    description: string;
-    author: string;
-    lastEdited: string;
-    screenshot: string;
-    status?: AgentStatus;
-    transport: Transport;
-    avatarUrl: string;
-    notebookFile: string;
-    lexicalFile: string;
-    stars: number;
-    notifications: number;
-}
-export type AgentsState = {
-    agents: readonly Agent[];
-    getAgentById: (id: string) => Agent | undefined;
-    updateAgentStatus: (id: string, status: AgentStatus) => void;
-    toggleAgentStatus: (id: string) => void;
-};
-export interface ConversationEntry {
-    id: string;
-    firstMessage?: string;
-    timestamp: number;
-}
-/**
- * A tool provided by an MCP server.
- */
-export interface MCPServerTool {
-    /** Tool name/identifier */
-    name: string;
-    /** Tool description */
-    description: string;
-    /** Whether the tool is enabled */
-    enabled: boolean;
-    /** JSON schema for tool input parameters */
-    inputSchema?: Record<string, unknown>;
-}
-/**
- * Configuration for an MCP server.
- */
-export interface MCPServer {
-    /** Unique server identifier */
-    id: string;
-    /** Display name for the server */
-    name: string;
-    /** Server description */
-    description?: string;
-    /** Server URL (for HTTP-based servers) */
-    url: string;
-    /** Whether the server is enabled */
-    enabled: boolean;
-    /** List of available tools */
-    tools: MCPServerTool[];
-    /** Command to run the MCP server (e.g., 'npx', 'uvx') */
-    command?: string;
-    /** Command arguments for the MCP server */
-    args: string[];
-    /** Whether the server is available (based on tool discovery) */
-    isAvailable: boolean;
-    /** Transport type: 'stdio' or 'http' */
-    transport: 'stdio' | 'http';
-    /** Environment variables required by this server (e.g., API keys) */
-    requiredEnvVars?: string[];
-    /** Icon identifier for the server */
-    icon?: string;
-    /** Emoji identifier for the server */
-    emoji?: string;
-}
-/**
- * Specification for an agent skill.
- *
- * Simplified version of the full Skill type from agent-skills,
- * containing only the fields needed for agent specification.
- */
-export interface AgentSkillSpec {
-    /** Unique skill identifier */
-    id: string;
-    /** Display name for the skill */
-    name: string;
-    /** Skill description */
-    description: string;
-    /** Skill version */
-    version: string;
-    /** Tags for categorization */
-    tags: string[];
-    /** Whether the skill is enabled */
-    enabled: boolean;
-    /** Environment variables required by this skill (e.g., API keys) */
-    requiredEnvVars?: string[];
-}
-/**
- * Specification for an AI agent.
- *
- * Defines the configuration for a reusable agent template that can be
- * instantiated as an AgentSpace.
- */
-export interface AgentSpec {
-    /** Unique agent identifier */
-    id: string;
-    /** Display name for the agent */
-    name: string;
-    /** Agent description */
-    description: string;
-    /** System prompt for the agent */
-    systemPrompt?: string;
-    /** System prompt addons when codemode is enabled */
-    systemPromptCodemodeAddons?: string;
-    /** Tags for categorization */
-    tags: string[];
-    /** Whether the agent is enabled */
-    enabled: boolean;
-    /** AI model identifier to use for this agent */
-    model?: string;
-    /** MCP servers used by this agent */
-    mcpServers: MCPServer[];
-    /** Skills available to this agent */
-    skills: AgentSkillSpec[];
-    /** Runtime environment name for this agent */
-    environmentName: string;
-    /** Icon identifier or URL for the agent */
-    icon?: string;
-    /** Emoji identifier for the agent */
-    emoji?: string;
-    /** Theme color for the agent (hex code) */
-    color?: string;
-    /** Chat suggestions to show users what this agent can do */
-    suggestions?: string[];
-    /** Welcome message shown when agent starts */
-    welcomeMessage?: string;
-    /** Path to Jupyter notebook to show on agent creation */
-    welcomeNotebook?: string;
-    /** Path to Lexical document to show on agent creation */
-    welcomeDocument?: string;
-    /** Sandbox variant to use for this agent ('local-eval', 'jupyter', 'local-jupyter') */
-    sandboxVariant?: string;
-}
-/**
- * Configuration for an AI model.
- */
-export interface AIModelRuntime {
-    /** Model identifier (e.g., 'anthropic:claude-sonnet-4-5') */
-    id: string;
-    /** Display name for the model */
-    name: string;
-    /** List of builtin tool IDs */
-    builtinTools: string[];
-    /** Required environment variables for this model */
-    requiredEnvVars: string[];
-    /** Whether the model is available (based on env vars) */
-    isAvailable: boolean;
-}
-/**
- * Configuration for a builtin tool.
- */
-export interface BuiltinTool {
-    /** Tool identifier */
-    id: string;
-    /** Display name for the tool */
-    name: string;
-}
-/**
- * Configuration returned to frontend.
- */
-export interface FrontendConfig {
-    /** Available AI models */
-    models: AIModelRuntime[];
-    /** Available builtin tools */
-    builtinTools: BuiltinTool[];
-    /** Configured MCP servers */
-    mcpServers: MCPServer[];
-}
-/**
- * Configuration for connecting to an agent runtime.
- */
-export interface AgentRuntimeConfig {
-    /** URL of the agent runtime server */
-    url: string;
-    /** Optional agent ID to connect to */
-    agentId?: string;
-    /** Optional authentication token */
-    authToken?: string;
-}