@datalayer/agent-runtimes 0.0.10 → 0.0.12

package/lib/tools/adapters/agent-runtimes/notebookHooks.js

@@ -10,7 +10,7 @@
  */
 import { useMemo } from 'react';
 import { notebookStore, DefaultExecutor, notebookToolDefinitions, notebookToolOperations, } from '@datalayer/jupyter-react';
-import { createAllAgentRuntimesTools, } from './AgentRuntimesToolAdapter';
+import { createAllAgentRuntimesTools } from './AgentRuntimesToolAdapter';
 // Hook wrapper to get notebook store state
 const useNotebookStore = () => notebookStore.getState();
 /**
@@ -19,17 +19,17 @@ const useNotebookStore = () => notebookStore.getState();
  *
  * @param documentId - Document ID (notebook identifier)
  * @param contextOverrides - Optional context overrides (format, extras, etc.)
- * @returns Agent-runtimes tools array for ChatFloating
+ * @returns Frontend tools array for ChatFloating / Chat
  *
  * @example
  * ```typescript
  * // Default context (toon format for AI)
- * const tools = useNotebookTools("my-notebook-id");
+ * const frontendTools = useNotebookTools("my-notebook-id");
  *
  * // Use with ChatFloating
  * <ChatFloating
  *   endpoint="http://localhost:8765/api/v1/ag-ui/agent/"
- *   tools={tools}
+ *   frontendTools={frontendTools}
  * />
  * ```
  */

package/lib/{types.d.ts → types/Types.d.ts}

@@ -1,3 +1,29 @@
+/**
+ * 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;
@@ -24,6 +50,8 @@ export interface MCPServer {
     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 */
@@ -40,6 +68,10 @@ export interface MCPServer {
     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.
@@ -63,10 +95,6 @@ export interface AgentSkillSpec {
     /** Environment variables required by this skill (e.g., API keys) */
     requiredEnvVars?: string[];
 }
-/**
- * Status of an agent space.
- */
-export type AgentStatus = 'starting' | 'running' | 'paused' | 'terminated' | 'archived';
 /**
  * Specification for an AI agent.
  *
@@ -82,12 +110,14 @@ export interface AgentSpec {
     description: string;
     /** System prompt for the agent */
     systemPrompt?: string;
-    /** System prompt when codemode is enabled */
-    systemPromptCodemode?: 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 */
@@ -96,6 +126,8 @@ export interface AgentSpec {
     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 */
@@ -106,11 +138,13 @@ export interface AgentSpec {
     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 AIModel {
+export interface AIModelRuntime {
     /** Model identifier (e.g., 'anthropic:claude-sonnet-4-5') */
     id: string;
     /** Display name for the model */
@@ -136,7 +170,7 @@ export interface BuiltinTool {
  */
 export interface FrontendConfig {
     /** Available AI models */
-    models: AIModel[];
+    models: AIModelRuntime[];
     /** Available builtin tools */
     builtinTools: BuiltinTool[];
     /** Configured MCP servers */

package/lib/types/index.d.ts

@@ -1 +1,2 @@
 export * from './AIAgent';
+export * from './Types';

package/lib/types/index.js

@@ -3,3 +3,4 @@
  * Distributed under the terms of the Modified BSD License.
  */
 export * from './AIAgent';
+export * from './Types';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalayer/agent-runtimes",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "type": "module",
   "workspaces": [
     ".",
@@ -67,7 +67,7 @@
     "clean:dist": "rimraf dist",
     "clean:lib": "rimraf lib tsconfig.tsbuildinfo",
     "create:patches": "bash scripts/create-patches.sh",
-    "examples": "run-p server:start examples:vite",
+    "examples": "run-p server:start jupyter:start examples:vite",
     "examples:fresh": "npm run clean:cache && npm run examples",
     "examples:jupyter": "run-p jupyter:start server:start examples:vite",
     "examples:nextjs": "npm run dev --workspace=nextjs-notebook-example",
@@ -94,6 +94,12 @@
     "start:acp": "run-p server:start start:acp:vite",
     "start:acp:prod": "run-p server start:acp:vite",
     "start:acp:vite": "VITE_ACP_WS_URL=ws://localhost:8765/api/v1/acp/ws vite",
+    "start:agent": "run-p server:start start:agent:vite",
+    "start:agent:vite": "vite --open /html/agent.html",
+    "start:agent-notebook": "run-p server:start jupyter:start start:agent-notebook:vite",
+    "start:agent-notebook:vite": "vite --open /html/agent-notebook.html",
+    "start:agent-lexical": "run-p server:start jupyter:start start:agent-lexical:vite",
+    "start:agent-lexical:vite": "vite --open /html/agent-lexical.html",
     "storybook": "storybook dev -p 6006",
     "sync:jupyter": "bash scripts/sync-jupyter.sh",
     "sync:jupyter:watch": "bash scripts/sync-jupyter.sh --watch",
@@ -122,11 +128,11 @@
     "@agentclientprotocol/sdk": "^0.8.0",
     "@ai-sdk/react": "3.0.30",
     "@anthropic-ai/sdk": "^0.52.0",
-    "@datalayer/core": "^0.0.25",
+    "@datalayer/core": "^1.0.1",
     "@datalayer/icons-react": "^1.0.6",
-    "@datalayer/jupyter-lexical": "^1.0.9",
+    "@datalayer/jupyter-lexical": "^1.0.11",
     "@datalayer/jupyter-react": "^2.0.3",
-    "@datalayer/primer-addons": "^1.0.4",
+    "@datalayer/primer-addons": "^1.0.7",
     "@datalayer/primer-rjsf": "^1.0.1",
     "@jupyter-widgets/base-manager": "^1.0.12",
     "@jupyter-widgets/schema": "^0.5.6",