@datalayer/agent-runtimes 1.3.55 → 1.3.57

package/lib/specs/mcpServers.js

@@ -10,7 +10,7 @@ export const ALPHAVANTAGE_MCP_SERVER_0_0_1 = {
     version: '0.0.1',
     name: 'Alpha Vantage',
     description: 'Financial market data and stock information',
-    icon: 'graph',
+    icon: '@primer/octicons-react:graph',
     emoji: '💹',
     url: '',
     command: 'uvx',
@@ -26,7 +26,7 @@ export const CHART_MCP_SERVER_0_0_1 = {
     version: '0.0.1',
     name: 'Chart Generator',
     description: 'Generate charts and visualizations',
-    icon: 'graph',
+    icon: '@datalayer/icons-react:chart-bar',
     emoji: '📊',
     url: '',
     command: 'npx',
@@ -42,7 +42,7 @@ export const DATALAYER_MCP_SERVER_0_0_1 = {
     version: '0.0.1',
     name: 'Datalayer',
     description: 'Read, edit and run Jupyter notebooks on Datalayer, with sandboxes and data',
-    icon: 'notebook',
+    icon: '@datalayer/icons-react:datalayer',
     emoji: '🚀',
     url: '',
     command: 'npx',
@@ -64,7 +64,7 @@ export const EARTHDATA_MCP_SERVER_0_0_1 = {
     version: '0.0.1',
     name: 'Earthdata MCP',
     description: 'Access NASA Earthdata search and metadata capabilities',
-    icon: 'globe',
+    icon: '@datalayer/icons-react:globe-americas',
     emoji: '🌍',
     url: '',
     command: 'npx',
@@ -80,7 +80,7 @@ export const EURUS_MCP_SERVER_0_0_1 = {
     version: '0.0.1',
     name: 'Eurus Climate MCP',
     description: 'Climate and reanalysis analysis tools for spatial workflows',
-    icon: 'graph',
+    icon: '@primer/octicons-react:cloud',
     emoji: '🌦️',
     url: '',
     command: 'eurus-mcp',
@@ -96,7 +96,7 @@ export const FILESYSTEM_MCP_SERVER_0_0_1 = {
     version: '0.0.1',
     name: 'Filesystem',
     description: 'Local filesystem read/write operations',
-    icon: 'file-directory',
+    icon: '@primer/octicons-react:file-directory',
     emoji: '📁',
     url: '',
     command: 'npx',
@@ -112,7 +112,7 @@ export const GITHUB_MCP_SERVER_0_0_1 = {
     version: '0.0.1',
     name: 'GitHub',
     description: 'GitHub repository operations (issues, PRs, code search)',
-    icon: 'mark-github',
+    icon: '@datalayer/icons-react:github-mark',
     emoji: '🐙',
     url: '',
     command: 'docker',
@@ -135,7 +135,7 @@ export const GOOGLE_WORKSPACE_MCP_SERVER_0_0_1 = {
     version: '0.0.1',
     name: 'Google Workspace',
     description: 'Google Drive, Gmail, Calendar, and Docs integration',
-    icon: 'mail',
+    icon: '@datalayer/icons-react:google',
     emoji: '📧',
     url: '',
     command: 'uvx',
@@ -154,7 +154,7 @@ export const HUGGINGFACE_MCP_SERVER_0_0_1 = {
     version: '0.0.1',
     name: 'Hugging Face',
     description: 'Hugging Face models, datasets, spaces, and papers access',
-    icon: 'brain',
+    icon: '@primer/octicons-react:hubot',
     emoji: '🤗',
     url: '',
     command: 'npx',
@@ -176,8 +176,8 @@ export const KAGGLE_MCP_SERVER_0_0_1 = {
     version: '0.0.1',
     name: 'Kaggle',
     description: 'Kaggle datasets, models, competitions, and notebooks access',
-    icon: 'database',
-    emoji: '📊',
+    icon: '@datalayer/icons-react:kaggle',
+    emoji: '🏆',
     url: '',
     command: 'npx',
     args: [
@@ -193,13 +193,35 @@ export const KAGGLE_MCP_SERVER_0_0_1 = {
     tools: [],
     requiredEnvVars: ['KAGGLE_API_TOKEN:0.0.1'],
 };
+export const ODOO_ACCOUNTING_MCP_SERVER_0_0_1 = {
+    id: 'odoo-accounting',
+    version: '0.0.1',
+    name: 'Odoo Accounting',
+    description: "An accountant's day in Odoo — invoices, bills, journal entries, reconciliations, bank lines and tax returns — through the Datalayer MCP server",
+    icon: '@datalayer/icons-react:odoo',
+    emoji: '🧮',
+    url: '',
+    command: 'npx',
+    args: [
+        '-y',
+        'mcp-remote',
+        'https://mcp.datalayer.run/mcp?only=odoo-accounting',
+        '--header',
+        'Authorization: Bearer ${DATALAYER_API_KEY}',
+    ],
+    transport: 'stdio',
+    enabled: false,
+    isAvailable: false,
+    tools: [],
+    requiredEnvVars: ['DATALAYER_API_KEY:0.0.1'],
+};
 export const ODOO_MCP_SERVER_0_0_1 = {
     id: 'odoo',
     version: '0.0.1',
     name: 'Odoo',
     description: 'Odoo ERP operations (search, invoices, journals, reconciliations)',
-    icon: 'server',
-    emoji: '📚',
+    icon: '@datalayer/icons-react:odoo',
+    emoji: '🧾',
     url: '',
     command: 'uvx',
     args: ['mcp-server-odoo'],
@@ -214,7 +236,7 @@ export const SALESFORCE_MCP_SERVER_0_0_1 = {
     version: '0.0.1',
     name: 'Salesforce',
     description: 'Salesforce CRM operations (queries, reports, objects, SOQL)',
-    icon: 'briefcase',
+    icon: '@primer/octicons-react:briefcase',
     emoji: '☁️',
     url: '',
     command: 'npx',
@@ -233,7 +255,7 @@ export const SLACK_MCP_SERVER_0_0_1 = {
     version: '0.0.1',
     name: 'Slack',
     description: 'Slack messaging and channel operations',
-    icon: 'comment-discussion',
+    icon: '@datalayer/icons-react:slack',
     emoji: '💬',
     url: '',
     command: 'npx',
@@ -253,7 +275,7 @@ export const TAVILY_MCP_SERVER_0_0_1 = {
     version: '0.0.1',
     name: 'Tavily Search',
     description: 'Web search and research capabilities via Tavily API',
-    icon: 'search',
+    icon: '@primer/octicons-react:search',
     emoji: '🔍',
     url: '',
     command: 'npx',
@@ -278,6 +300,7 @@ export const MCP_SERVER_LIBRARY = {
     'google-workspace': GOOGLE_WORKSPACE_MCP_SERVER_0_0_1,
     huggingface: HUGGINGFACE_MCP_SERVER_0_0_1,
     kaggle: KAGGLE_MCP_SERVER_0_0_1,
+    'odoo-accounting': ODOO_ACCOUNTING_MCP_SERVER_0_0_1,
     odoo: ODOO_MCP_SERVER_0_0_1,
     salesforce: SALESFORCE_MCP_SERVER_0_0_1,
     slack: SLACK_MCP_SERVER_0_0_1,

package/lib/specs/skills.js

@@ -18,7 +18,7 @@ export const ACCOUNTING_SKILL_SPEC_0_0_1 = {
     optionalEnvVars: [],
     dependencies: ['pandas>=2.0.0'],
     tags: ['accounting', 'finance', 'reconciliation', 'close'],
-    icon: 'book',
+    icon: '@primer/octicons-react:book',
     emoji: '🧮',
     enabled: false,
 };
@@ -35,7 +35,7 @@ export const CRAWL_SKILL_SPEC_0_0_1 = {
     optionalEnvVars: [],
     dependencies: ['requests>=2.31.0', 'beautifulsoup4>=4.12.0'],
     tags: ['web', 'crawl', 'scraping'],
-    icon: 'globe',
+    icon: '@primer/octicons-react:globe',
     emoji: '🌐',
     enabled: true,
 };
@@ -52,7 +52,7 @@ export const EVENTS_SKILL_SPEC_0_0_1 = {
     optionalEnvVars: [],
     dependencies: ['httpx>=0.27.0'],
     tags: ['events', 'orchestration', 'automation'],
-    icon: 'bell',
+    icon: '@primer/octicons-react:calendar',
     emoji: '📅',
     enabled: false,
 };
@@ -69,7 +69,7 @@ export const GITHUB_SKILL_SPEC_0_0_1 = {
     optionalEnvVars: [],
     dependencies: ['PyGithub>=2.1.0'],
     tags: ['github', 'git', 'code'],
-    icon: 'mark-github',
+    icon: '@datalayer/icons-react:github-mark',
     emoji: '🐙',
     enabled: false,
 };
@@ -86,7 +86,7 @@ export const JOKES_SKILL_SPEC_0_0_1 = {
     optionalEnvVars: [],
     dependencies: [],
     tags: ['fun', 'humor', 'demo'],
-    icon: 'smiley',
+    icon: '@primer/octicons-react:smiley',
     emoji: '😄',
     enabled: false,
 };
@@ -103,7 +103,7 @@ export const PDF_SKILL_SPEC_0_0_1 = {
     optionalEnvVars: [],
     dependencies: ['PyPDF2>=3.0.0', 'pdfplumber>=0.10.0'],
     tags: ['pdf', 'documents', 'extraction'],
-    icon: 'file',
+    icon: '@primer/octicons-react:file',
     emoji: '📄',
     enabled: false,
 };
@@ -120,7 +120,7 @@ export const TEXT_SUMMARIZER_SKILL_SPEC_0_0_1 = {
     optionalEnvVars: [],
     dependencies: ['agent-skills>=0.0.1'],
     tags: ['nlp', 'summarization', 'text-processing'],
-    icon: 'note',
+    icon: '@primer/octicons-react:note',
     emoji: '📝',
     enabled: false,
 };

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/agentspecs.d.ts

@@ -469,12 +469,23 @@ export interface AppTestCaseSpec {
     ask: string;
     expect: string;
 }
+/**
+ * What was verified, and how, each in a sentence a person reads (LOOP E-14):
+ * what was tried live, what runs on recorded data, what is not verified yet.
+ */
+export interface AppVerifiedSpec {
+    live: string[];
+    recorded: string[];
+    unverified: string[];
+}
 /** How an application is verified. */
 export interface AppTestsSpec {
     /** The share of tests that has to pass for it to be ready. */
     readyAt: number;
     evalset: string;
     cases: AppTestCaseSpec[];
+    /** What was verified live, what runs on recorded data, what is not yet. */
+    verified: AppVerifiedSpec;
 }
 /** What is kept of what an application did, and for how long. */
 export interface AppRecordSpec {

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.57",
     "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)
+        )