@datalayer/agent-runtimes 1.0.0 → 1.0.2

package/lib/specs/agents/mocks/index.d.ts

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

package/lib/specs/agents/mocks/index.js

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

package/lib/specs/mcpServers.d.ts

@@ -14,6 +14,7 @@ export declare const GITHUB_MCP_SERVER: MCPServer;
 export declare const GOOGLE_WORKSPACE_MCP_SERVER: MCPServer;
 export declare const HUGGINGFACE_MCP_SERVER: MCPServer;
 export declare const KAGGLE_MCP_SERVER: MCPServer;
+export declare const SALESFORCE_MCP_SERVER: MCPServer;
 export declare const SLACK_MCP_SERVER: MCPServer;
 export declare const TAVILY_MCP_SERVER: MCPServer;
 export declare const MCP_SERVER_LIBRARY: Record<string, MCPServer>;

package/lib/specs/mcpServers.js

@@ -129,6 +129,21 @@ export const KAGGLE_MCP_SERVER = {
     tools: [],
     requiredEnvVars: ['KAGGLE_TOKEN'],
 };
+export const SALESFORCE_MCP_SERVER = {
+    id: 'salesforce',
+    name: 'Salesforce',
+    description: 'Salesforce CRM operations (queries, reports, objects, SOQL)',
+    icon: 'briefcase',
+    emoji: '☁️',
+    url: '',
+    command: 'npx',
+    args: ['-y', '@anthropic/salesforce-mcp-server'],
+    transport: 'stdio',
+    enabled: true,
+    isAvailable: false,
+    tools: [],
+    requiredEnvVars: ['SALESFORCE_ACCESS_TOKEN', 'SALESFORCE_INSTANCE_URL'],
+};
 export const SLACK_MCP_SERVER = {
     id: 'slack',
     name: 'Slack',
@@ -170,6 +185,7 @@ export const MCP_SERVER_LIBRARY = {
     'google-workspace': GOOGLE_WORKSPACE_MCP_SERVER,
     huggingface: HUGGINGFACE_MCP_SERVER,
     kaggle: KAGGLE_MCP_SERVER,
+    salesforce: SALESFORCE_MCP_SERVER,
     slack: SLACK_MCP_SERVER,
     tavily: TAVILY_MCP_SERVER,
 };

package/lib/specs/models.d.ts

@@ -31,7 +31,7 @@ export declare const AIModels: {
     readonly AZURE_OPENAI_GPT_4O_MINI: "azure-openai:gpt-4o-mini";
     readonly AZURE_OPENAI_GPT_4O: "azure-openai:gpt-4o";
     readonly BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0: "bedrock:us.anthropic.claude-3-5-haiku-20241022-v1:0";
-    readonly BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1_0: "bedrock:us.anthropic.claude-opus-4-6-v1:0";
+    readonly BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1: "bedrock:us.anthropic.claude-opus-4-6-v1";
     readonly BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0: "bedrock:us.anthropic.claude-opus-4-20250514-v1:0";
     readonly BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0: "bedrock:us.anthropic.claude-sonnet-4-5-20250929-v1:0";
     readonly BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0: "bedrock:us.anthropic.claude-sonnet-4-20250514-v1:0";
@@ -53,7 +53,7 @@ export declare const AZURE_OPENAI_GPT_4_1: AIModel;
 export declare const AZURE_OPENAI_GPT_4O_MINI: AIModel;
 export declare const AZURE_OPENAI_GPT_4O: AIModel;
 export declare const BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0: AIModel;
-export declare const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1_0: AIModel;
+export declare const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1: AIModel;
 export declare const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0: AIModel;
 export declare const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0: AIModel;
 export declare const BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0: AIModel;

package/lib/specs/models.js

@@ -16,7 +16,7 @@ export const AIModels = {
     AZURE_OPENAI_GPT_4O_MINI: 'azure-openai:gpt-4o-mini',
     AZURE_OPENAI_GPT_4O: 'azure-openai:gpt-4o',
     BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0: 'bedrock:us.anthropic.claude-3-5-haiku-20241022-v1:0',
-    BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1_0: 'bedrock:us.anthropic.claude-opus-4-6-v1:0',
+    BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1: 'bedrock:us.anthropic.claude-opus-4-6-v1',
     BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0: 'bedrock:us.anthropic.claude-opus-4-20250514-v1:0',
     BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0: 'bedrock:us.anthropic.claude-sonnet-4-5-20250929-v1:0',
     BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0: 'bedrock:us.anthropic.claude-sonnet-4-20250514-v1:0',
@@ -114,10 +114,10 @@ export const BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0 = {
         'AWS_DEFAULT_REGION',
     ],
 };
-export const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1_0 = {
-    id: 'bedrock:us.anthropic.claude-opus-4-6-v1:0',
+export const BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1 = {
+    id: 'bedrock:us.anthropic.claude-opus-4-6-v1',
     name: 'Bedrock Claude Opus 4.6',
-    description: 'Claude Opus 4.6 via AWS Bedrock - latest flagship model',
+    description: 'Claude Opus 4.6 via AWS Bedrock',
     provider: 'bedrock',
     default: false,
     requiredEnvVars: [
@@ -224,7 +224,7 @@ export const AI_MODEL_CATALOGUE = {
     'azure-openai:gpt-4o-mini': AZURE_OPENAI_GPT_4O_MINI,
     'azure-openai:gpt-4o': AZURE_OPENAI_GPT_4O,
     'bedrock:us.anthropic.claude-3-5-haiku-20241022-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_3_5_HAIKU_20241022_V1_0,
-    'bedrock:us.anthropic.claude-opus-4-6-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1_0,
+    'bedrock:us.anthropic.claude-opus-4-6-v1': BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_6_V1,
     'bedrock:us.anthropic.claude-opus-4-20250514-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_OPUS_4_20250514_V1_0,
     'bedrock:us.anthropic.claude-sonnet-4-5-20250929-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_5_20250929_V1_0,
     'bedrock:us.anthropic.claude-sonnet-4-20250514-v1:0': BEDROCK_US_ANTHROPIC_CLAUDE_SONNET_4_20250514_V1_0,

package/lib/types/Types.d.ts

@@ -99,7 +99,7 @@ export interface AgentSkillSpec {
  * Specification for an AI agent.
  *
  * Defines the configuration for a reusable agent template that can be
- * instantiated as an AgentSpace.
+ * instantiated as an Agent Runtime.
  */
 export interface AgentSpec {
     /** Unique agent identifier */
@@ -140,6 +140,34 @@ export interface AgentSpec {
     welcomeDocument?: string;
     /** Sandbox variant to use for this agent ('local-eval', 'jupyter', 'local-jupyter') */
     sandboxVariant?: string;
+    /** User-facing objective for the agent */
+    goal?: string;
+    /** Communication protocol (e.g., 'ag-ui', 'acp', 'a2a', 'vercel-ai') */
+    protocol?: string;
+    /** UI extension type (e.g., 'a2ui', 'mcp-apps') */
+    uiExtension?: string;
+    /** Trigger configuration (type, cron, description) */
+    trigger?: Record<string, any>;
+    /** Model configuration (temperature, max_tokens) */
+    modelConfig?: Record<string, any>;
+    /** MCP server tool configurations with approval settings */
+    mcpServerTools?: Record<string, any>[];
+    /** Guardrail configurations */
+    guardrails?: Record<string, any>[];
+    /** Evaluation configurations */
+    evals?: Record<string, any>[];
+    /** Codemode configuration (enabled, token_reduction, speedup) */
+    codemode?: Record<string, any>;
+    /** Output configuration (type/formats, template) */
+    output?: Record<string, any>;
+    /** Advanced settings (cost_limit, time_limit, max_iterations, validation) */
+    advanced?: Record<string, any>;
+    /** Authorization policy */
+    authorizationPolicy?: string;
+    /** Notification configuration (email, slack) */
+    notifications?: Record<string, any>;
+    /** Team configuration for multi-agent flows */
+    team?: Record<string, any>;
 }
 /**
  * Configuration for an AI model.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@datalayer/agent-runtimes",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "workspaces": [
     ".",
@@ -130,10 +130,11 @@
     "@anthropic-ai/sdk": "^0.52.0",
     "@datalayer/core": "^1.0.1",
     "@datalayer/icons-react": "^1.0.6",
-    "@datalayer/jupyter-lexical": "^1.0.11",
+    "@datalayer/jupyter-lexical": "^1.0.13",
     "@datalayer/jupyter-react": "^2.0.3",
-    "@datalayer/primer-addons": "^1.0.7",
+    "@datalayer/primer-addons": "^1.0.10",
     "@datalayer/primer-rjsf": "^1.0.1",
+    "@excalidraw/excalidraw": "^0.18.0",
     "@jupyter-widgets/base-manager": "^1.0.12",
     "@jupyter-widgets/schema": "^0.5.6",
     "@jupyterlab/apputils": "^4.6.0",

package/scripts/codegen/generate_agents.py

@@ -9,6 +9,7 @@ Generates Python and TypeScript code from YAML agent specifications.
 """
 
 import argparse
+import json
 import sys
 from pathlib import Path
 from typing import Any, Dict, List
@@ -23,6 +24,20 @@ def _fmt_list(items: list[str]) -> str:
     return "[" + ", ".join(f'"{item}"' for item in items) + "]"
 
 
+def _fmt_py_literal(value: Any) -> str:
+    """Format a value as a Python literal for code generation."""
+    if value is None:
+        return "None"
+    return repr(value)
+
+
+def _fmt_ts_literal(value: Any) -> str:
+    """Format a value as a TypeScript/JSON literal for code generation."""
+    if value is None:
+        return "undefined"
+    return json.dumps(value, ensure_ascii=False)
+
+
 def load_yaml_specs(specs_dir: Path) -> List[tuple[str, Dict[str, Any]]]:
     """
     Load all YAML agent specifications from directory and subdirectories.
@@ -60,7 +75,7 @@ def generate_python_code(specs: List[tuple[str, Dict[str, Any]]]) -> str:
 """
 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/
 """
@@ -172,6 +187,30 @@ from agent_runtimes.types import AgentSpec
             sandbox_variant = spec.get("sandbox_variant")
             sandbox_variant_str = f'"{sandbox_variant}"' if sandbox_variant else "None"
 
+            # New flow-level fields
+            goal_raw = spec.get("goal")
+            goal_str = (
+                f'"{goal_raw.replace(chr(10), " ").replace("  ", " ").strip()}"'
+                if goal_raw
+                else "None"
+            )
+            protocol_val = spec.get("protocol")
+            protocol_str = f'"{protocol_val}"' if protocol_val else "None"
+            ui_ext = spec.get("ui_extension")
+            ui_ext_str = f'"{ui_ext}"' if ui_ext else "None"
+            trigger_val = spec.get("trigger")
+            model_cfg = spec.get("model_config")
+            mcp_srv_tools = spec.get("mcp_server_tools")
+            guardrails_val = spec.get("guardrails")
+            evals_val = spec.get("evals")
+            codemode_val = spec.get("codemode")
+            output_val = spec.get("output")
+            advanced_val = spec.get("advanced")
+            auth_policy = spec.get("authorization_policy")
+            auth_policy_str = f'"{auth_policy}"' if auth_policy is not None else "None"
+            notifs = spec.get("notifications")
+            team_val = spec.get("team")
+
             code += f'''{const_name} = AgentSpec(
     id="{full_agent_id}",
     name="{spec["name"]}",
@@ -192,6 +231,20 @@ from agent_runtimes.types import AgentSpec
     sandbox_variant={sandbox_variant_str},
     system_prompt={system_prompt_str},
     system_prompt_codemode_addons={system_prompt_codemode_addons_str},
+    goal={goal_str},
+    protocol={protocol_str},
+    ui_extension={ui_ext_str},
+    trigger={_fmt_py_literal(trigger_val)},
+    model_configuration={_fmt_py_literal(model_cfg)},
+    mcp_server_tools={_fmt_py_literal(mcp_srv_tools)},
+    guardrails={_fmt_py_literal(guardrails_val)},
+    evals={_fmt_py_literal(evals_val)},
+    codemode={_fmt_py_literal(codemode_val)},
+    output={_fmt_py_literal(output_val)},
+    advanced={_fmt_py_literal(advanced_val)},
+    authorization_policy={auth_policy_str},
+    notifications={_fmt_py_literal(notifs)},
+    team={_fmt_py_literal(team_val)},
 )
 
 '''
@@ -309,7 +362,7 @@ def generate_typescript_code(
 /**
  * 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/
  */
@@ -474,6 +527,32 @@ function toAgentSkillSpec(skill: SkillSpec) {
                 f"'{sandbox_variant}'" if sandbox_variant else "undefined"
             )
 
+            # New flow-level fields
+            goal_raw = spec.get("goal")
+            goal_ts = (
+                f"`{goal_raw.replace(chr(10), ' ').replace('  ', ' ').strip().replace('`', chr(92) + '`')}`"
+                if goal_raw
+                else "undefined"
+            )
+            protocol_val = spec.get("protocol")
+            protocol_ts = f"'{protocol_val}'" if protocol_val else "undefined"
+            ui_ext = spec.get("ui_extension")
+            ui_ext_ts = f"'{ui_ext}'" if ui_ext else "undefined"
+            trigger_val = spec.get("trigger")
+            model_cfg = spec.get("model_config")
+            mcp_srv_tools = spec.get("mcp_server_tools")
+            guardrails_val = spec.get("guardrails")
+            evals_val = spec.get("evals")
+            codemode_val = spec.get("codemode")
+            output_val = spec.get("output")
+            advanced_val = spec.get("advanced")
+            auth_policy = spec.get("authorization_policy")
+            auth_policy_ts = (
+                f"'{auth_policy}'" if auth_policy is not None else "undefined"
+            )
+            notifs = spec.get("notifications")
+            team_val = spec.get("team")
+
             code += f"""export const {const_name}: AgentSpec = {{
   id: '{full_agent_id}',
   name: '{spec["name"]}',
@@ -491,6 +570,20 @@ function toAgentSkillSpec(skill: SkillSpec) {
   sandboxVariant: {sandbox_variant_ts},
   systemPrompt: {f"`{system_prompt}`" if system_prompt else "undefined"},
   systemPromptCodemodeAddons: {f"`{system_prompt_codemode_addons}`" if system_prompt_codemode_addons else "undefined"},
+  goal: {goal_ts},
+  protocol: {protocol_ts},
+  uiExtension: {ui_ext_ts},
+  trigger: {_fmt_ts_literal(trigger_val)},
+  modelConfig: {_fmt_ts_literal(model_cfg)},
+  mcpServerTools: {_fmt_ts_literal(mcp_srv_tools)},
+  guardrails: {_fmt_ts_literal(guardrails_val)},
+  evals: {_fmt_ts_literal(evals_val)},
+  codemode: {_fmt_ts_literal(codemode_val)},
+  output: {_fmt_ts_literal(output_val)},
+  advanced: {_fmt_ts_literal(advanced_val)},
+  authorizationPolicy: {auth_policy_ts},
+  notifications: {_fmt_ts_literal(notifs)},
+  team: {_fmt_ts_literal(team_val)},
 }};
 
 """