@datalayer/agent-runtimes 1.3.55 → 1.3.56

package/lib/specs/tools.js

@@ -20,7 +20,7 @@ export const CREATE_PLAN_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools.ag_ui',
         method: 'create_plan',
     },
-    icon: 'list-unordered',
+    icon: '@primer/octicons-react:list-unordered',
     emoji: '📋',
 };
 export const CURRENT_TIME_TOOL_SPEC_0_0_1 = {
@@ -38,7 +38,7 @@ export const CURRENT_TIME_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools.ag_ui',
         method: 'current_time',
     },
-    icon: 'clock',
+    icon: '@primer/octicons-react:clock',
     emoji: '🕒',
 };
 export const DECIDE_TOOL_SPEC_0_0_1 = {
@@ -56,7 +56,7 @@ export const DECIDE_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.tools.decisions',
         method: 'decide',
     },
-    icon: 'law',
+    icon: '@primer/octicons-react:law',
     emoji: '⚖️',
 };
 export const DISPLAY_RECIPE_TOOL_SPEC_0_0_1 = {
@@ -74,7 +74,7 @@ export const DISPLAY_RECIPE_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools.ag_ui',
         method: 'display_recipe',
     },
-    icon: 'book',
+    icon: '@primer/octicons-react:book',
     emoji: '🍳',
 };
 export const EXAMPLE_CREATE_PLAN_TOOL_SPEC_0_0_1 = {
@@ -92,7 +92,7 @@ export const EXAMPLE_CREATE_PLAN_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools.ag_ui',
         method: 'create_plan',
     },
-    icon: 'list-unordered',
+    icon: '@primer/octicons-react:list-unordered',
     emoji: '📋',
 };
 export const EXAMPLE_CURRENT_TIME_TOOL_SPEC_0_0_1 = {
@@ -110,7 +110,7 @@ export const EXAMPLE_CURRENT_TIME_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools.ag_ui',
         method: 'current_time',
     },
-    icon: 'clock',
+    icon: '@primer/octicons-react:clock',
     emoji: '🕒',
 };
 export const EXAMPLE_DISPLAY_RECIPE_TOOL_SPEC_0_0_1 = {
@@ -128,7 +128,7 @@ export const EXAMPLE_DISPLAY_RECIPE_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools.ag_ui',
         method: 'display_recipe',
     },
-    icon: 'book',
+    icon: '@primer/octicons-react:book',
     emoji: '🍳',
 };
 export const EXAMPLE_GENERATE_HAIKU_TOOL_SPEC_0_0_1 = {
@@ -146,7 +146,7 @@ export const EXAMPLE_GENERATE_HAIKU_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools.ag_ui',
         method: 'generate_haiku',
     },
-    icon: 'pencil',
+    icon: '@primer/octicons-react:pencil',
     emoji: '🖋️',
 };
 export const EXAMPLE_GENERATE_TASK_STEPS_TOOL_SPEC_0_0_1 = {
@@ -164,8 +164,8 @@ export const EXAMPLE_GENERATE_TASK_STEPS_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools.ag_ui',
         method: 'generate_task_steps',
     },
-    icon: 'tasklist',
-    emoji: '🧑‍⚖️',
+    icon: '@primer/octicons-react:tasklist',
+    emoji: '🙋',
 };
 export const EXAMPLE_GET_WEATHER_TOOL_SPEC_0_0_1 = {
     id: 'example-get-weather',
@@ -182,7 +182,7 @@ export const EXAMPLE_GET_WEATHER_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools.ag_ui',
         method: 'get_weather',
     },
-    icon: 'sun',
+    icon: '@primer/octicons-react:sun',
     emoji: '🌤️',
 };
 export const EXAMPLE_RENDER_A2UI_SURFACE_TOOL_SPEC_0_0_1 = {
@@ -200,7 +200,7 @@ export const EXAMPLE_RENDER_A2UI_SURFACE_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools.a2ui',
         method: 'render_a2ui_surface',
     },
-    icon: 'browser',
+    icon: '@primer/octicons-react:browser',
     emoji: '🎛️',
 };
 export const EXAMPLE_UPDATE_PLAN_STEP_TOOL_SPEC_0_0_1 = {
@@ -218,7 +218,7 @@ export const EXAMPLE_UPDATE_PLAN_STEP_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools.ag_ui',
         method: 'update_plan_step',
     },
-    icon: 'checklist',
+    icon: '@primer/octicons-react:checklist',
     emoji: '✅',
 };
 export const GENERATE_HAIKU_TOOL_SPEC_0_0_1 = {
@@ -236,7 +236,7 @@ export const GENERATE_HAIKU_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools.ag_ui',
         method: 'generate_haiku',
     },
-    icon: 'pencil',
+    icon: '@primer/octicons-react:pencil',
     emoji: '🖋️',
 };
 export const GENERATE_TASK_STEPS_TOOL_SPEC_0_0_1 = {
@@ -254,8 +254,8 @@ export const GENERATE_TASK_STEPS_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools.ag_ui',
         method: 'generate_task_steps',
     },
-    icon: 'tasklist',
-    emoji: '🧑‍⚖️',
+    icon: '@primer/octicons-react:tasklist',
+    emoji: '🙋',
 };
 export const GET_WEATHER_TOOL_SPEC_0_0_1 = {
     id: 'get-weather',
@@ -272,7 +272,7 @@ export const GET_WEATHER_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools.ag_ui',
         method: 'get_weather',
     },
-    icon: 'sun',
+    icon: '@primer/octicons-react:sun',
     emoji: '🌤️',
 };
 export const RUNTIME_ECHO_TOOL_SPEC_0_0_1 = {
@@ -290,7 +290,7 @@ export const RUNTIME_ECHO_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools',
         method: 'runtime_echo',
     },
-    icon: 'comment',
+    icon: '@primer/octicons-react:comment',
     emoji: '💬',
 };
 export const RUNTIME_SEND_MAIL_TOOL_SPEC_0_0_1 = {
@@ -308,7 +308,7 @@ export const RUNTIME_SEND_MAIL_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools',
         method: 'runtime_send_mail',
     },
-    icon: 'mail',
+    icon: '@primer/octicons-react:mail',
     emoji: '📧',
 };
 export const RUNTIME_SENSITIVE_ECHO_TOOL_SPEC_0_0_1 = {
@@ -326,7 +326,7 @@ export const RUNTIME_SENSITIVE_ECHO_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools',
         method: 'runtime_sensitive_echo',
     },
-    icon: 'shield',
+    icon: '@primer/octicons-react:shield',
     emoji: '🛡️',
 };
 export const UPDATE_PLAN_STEP_TOOL_SPEC_0_0_1 = {
@@ -344,7 +344,7 @@ export const UPDATE_PLAN_STEP_TOOL_SPEC_0_0_1 = {
         package: 'agent_runtimes.examples.tools.ag_ui',
         method: 'update_plan_step',
     },
-    icon: 'checklist',
+    icon: '@primer/octicons-react:checklist',
     emoji: '✅',
 };
 // ============================================================================

package/lib/types/chat.d.ts

@@ -276,6 +276,10 @@ export interface MCPServerConfig {
     transport?: string;
     isConfig?: boolean;
     isRunning?: boolean;
+    /** The icon, `<package>:<name>` (agentspecs.marks), as the runtime's catalogue says it. */
+    icon?: string;
+    /** Drawn where there is no icon. */
+    emoji?: string;
 }
 /**
  * Common props shared by all Chat wrapper components

package/lib/types/mcp.d.ts

@@ -39,9 +39,9 @@ export interface MCPServer {
     transport: 'stdio' | 'http';
     /** Environment variables required by this server (e.g., API keys) */
     requiredEnvVars?: string[];
-    /** Icon identifier for the server */
+    /** The icon, `<package>:<name>` — `@datalayer/icons-react:odoo` (agentspecs.marks; see `SpecMark`) */
     icon?: string;
-    /** Emoji identifier for the server */
+    /** Drawn where there is no icon */
     emoji?: string;
 }
 /**

package/lib/types/skills.d.ts

@@ -107,9 +107,9 @@ export interface SkillSpec {
     dependencies?: string[];
     /** Tags for categorization */
     tags: string[];
-    /** Icon identifier */
+    /** The icon, `<package>:<name>` — `@datalayer/icons-react:odoo` (agentspecs.marks; see `SpecMark`) */
     icon?: string;
-    /** Emoji identifier */
+    /** Drawn where there is no icon */
     emoji?: string;
     /** Whether the skill is enabled */
     enabled: boolean;

package/lib/types/tools.d.ts

@@ -33,9 +33,9 @@ export interface ToolSpec {
     requiresApproval?: boolean;
     /** Runtime binding metadata */
     runtime: ToolRuntimeSpec;
-    /** Icon identifier */
+    /** The icon, `<package>:<name>` — `@datalayer/icons-react:odoo` (agentspecs.marks; see `SpecMark`) */
     icon?: string;
-    /** Emoji identifier */
+    /** Drawn where there is no icon */
     emoji?: string;
 }
 /**
@@ -78,9 +78,9 @@ export interface FrontendToolSpec {
      * read and edit a notebook but must never delete from it.
      */
     toolset: string | string[];
-    /** Icon identifier */
+    /** The icon, `<package>:<name>` — `@datalayer/icons-react:odoo` (agentspecs.marks; see `SpecMark`) */
     icon?: string;
-    /** Emoji identifier */
+    /** Drawn where there is no icon */
     emoji?: string;
 }
 import type { ReactNode } from 'react';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.3.55",
+    "version": "1.3.56",
     "type": "module",
     "workspaces": [
         ".",

package/scripts/codegen/agentspecs_clone.py

@@ -29,10 +29,12 @@ def package_root(specs_dir: Path) -> Path:
 def import_from_clone(specs_dir: Path, module: str) -> ModuleType:
     """Import `agentspecs.<module>` from the clone `specs_dir` belongs to."""
     root = package_root(specs_dir)
-    if not (root / "agentspecs" / module).exists():
+    package = root / "agentspecs"
+    if not (package / module).exists() and not (package / f"{module}.py").exists():
         raise SystemExit(
-            f"Error: {root / 'agentspecs' / module} not found — Frames and Cogs "
-            "need agentspecs >= 0.0.12"
+            f"Error: agentspecs.{module} not found in {package} — the clone is "
+            "older than the generators (Frames and Cogs need agentspecs >= 0.0.12, "
+            "the marks of the catalogues >= 0.0.31)"
         )
     for name in [
         name

package/scripts/codegen/generate_frontend_tools.py

@@ -13,6 +13,7 @@ from pathlib import Path
 from typing import Any
 
 import yaml
+from marks import check_marks
 from versioning import ensure_spec_version, version_suffix
 
 
@@ -274,6 +275,7 @@ def main() -> None:
 
     print(f"Loading frontend tool specs from {args.specs_dir}...")
     specs = load_frontend_tool_specs(args.specs_dir)
+    check_marks(specs, args.specs_dir)
     print(f"Loaded {len(specs)} frontend tool specifications")
 
     # Generate Python code

package/scripts/codegen/generate_mcp_servers.py

@@ -18,6 +18,7 @@ from pathlib import Path
 from typing import Any
 
 import yaml
+from marks import check_marks
 from versioning import ensure_spec_version, version_suffix
 
 
@@ -434,6 +435,7 @@ def main():
     # Load specifications
     print(f"Loading MCP server specs from {args.specs_dir}...")
     specs = load_mcp_specs(args.specs_dir)
+    check_marks(specs, args.specs_dir)
     print(f"Loaded {len(specs)} MCP server specifications")
 
     # Generate Python code

package/scripts/codegen/generate_skills.py

@@ -18,6 +18,7 @@ from pathlib import Path
 from typing import Any
 
 import yaml
+from marks import check_marks
 from versioning import ensure_spec_version, version_suffix
 
 
@@ -368,6 +369,7 @@ def main():
     # Load specifications
     print(f"Loading skill specs from {args.specs_dir}...")
     specs = load_skill_specs(args.specs_dir)
+    check_marks(specs, args.specs_dir)
     print(f"Loaded {len(specs)} skill specifications")
 
     # Generate Python code

package/scripts/codegen/generate_tools.py

@@ -14,6 +14,7 @@ from pathlib import Path
 from typing import Any
 
 import yaml
+from marks import check_marks
 from versioning import ensure_spec_version, version_suffix
 
 
@@ -327,6 +328,7 @@ def main() -> None:
 
     print(f"Loading tool specs from {args.specs_dir}...")
     specs = load_tool_specs(args.specs_dir)
+    check_marks(specs, args.specs_dir)
     print(f"Loaded {len(specs)} tool specifications")
 
     print("Generating Python code...")

package/scripts/codegen/marks.py

@@ -0,0 +1,33 @@
+# Copyright (c) 2025-2026 Datalayer, Inc.
+# Distributed under the terms of the Modified BSD License.
+
+"""The marks of a catalogue entry, checked before anything is generated from it.
+
+An MCP server, a skill, a tool and a frontend tool set each have an icon and an
+emoji. The icon says its package (`@datalayer/icons-react:odoo`,
+`@primer/octicons-react:mark-github`), so the chat loads it from the right one.
+The rule is `agentspecs.marks`, imported from the clone the specs are read
+from; an entry that breaks it stops the generator, naming the entry.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+from agentspecs_clone import import_from_clone
+
+
+def check_marks(specs: list[dict[str, Any]], specs_dir: Path) -> None:
+    """Refuse a catalogue with an entry whose marks are missing or malformed."""
+    marks = import_from_clone(specs_dir, "marks")
+    problems = [
+        f"  {spec.get('id', '?')}: {problem}"
+        for spec in specs
+        for problem in marks.marks_problems(spec)
+    ]
+    if problems:
+        raise SystemExit(
+            f"Error: the marks of {specs_dir.name} are not what agentspecs.marks says:\n"
+            + "\n".join(problems)
+        )