@datalayer/agent-runtimes 1.3.29 → 1.3.32

package/lib/types/agentspecs.d.ts

@@ -372,6 +372,12 @@ export interface ServerActionsSpec {
 }
 /** What kind of application it is: what its user meets. */
 export type AppKind = 'chat' | 'widget' | 'decision' | 'worker';
+/**
+ * How an application was built: in Python (its `app.py`), on the Canvas (its
+ * page composed there) or written out as its spec. Carried beside the
+ * catalogue (`APP_BUILT`), since an Appspec does not hold it.
+ */
+export type AppBuilt = 'python' | 'canvas' | 'written';
 /** What an application does when it meets an action. */
 export type AppBehaviour = 'do_it' | 'if_asked' | 'ask_first' | 'leave_to_me';
 export type AppLayout = 'chat' | 'page' | 'split';
@@ -470,6 +476,11 @@ export interface AppRecordSpec {
     keepFor: string;
     retentionDays: number;
     include: string[];
+    /**
+     * Whether its conversations may be used to suggest tests (LOOP V-16): off
+     * unless said, and only those kept while it is on are sampled.
+     */
+    suggestTests: boolean;
 }
 /** Optional checks from the catalogue. */
 export interface AppChecksSpec {
@@ -516,7 +527,7 @@ export interface AppDecisionSpec {
     criteria: AppCriterionSpec[];
     minConfidence: number;
     scenarios: AppScenarioSpec[];
-    judgmentModel: string;
+    decisionModel: string;
 }
 /**
  * An application (`agentspecs/apps`): the Appspec. An agent with an interface,
@@ -595,6 +606,11 @@ export interface Agentspec {
     enabled: boolean;
     /** AI model identifier to use for this agent */
     model?: string;
+    /**
+     * Other models of the catalogue this agent may be switched to, beside its
+     * `model`. The runtime offers those of them its inference serves.
+     */
+    modelAdditionals?: string[];
     /** Inference provider routing strategy */
     inferenceProvider?: 'local' | 'datalayer';
     /** MCP servers used by this agent */

package/lib/types/chat.d.ts

@@ -653,6 +653,11 @@ export interface ChatBaseProps {
         stop: () => void;
         /** Start the conversation over — what the header's + does. */
         newChat: () => void;
+        /**
+         * The conversation the next message goes to, as the runtime knows it
+         * (AG-UI's thread): what an application's record keeps it under.
+         */
+        thread: () => string;
     } | null) => void;
     /**
      * Reports whether the chat is streaming a reply, so a host that owns the

package/lib/types/config.d.ts

@@ -45,7 +45,27 @@ export interface AgentConfig {
  * Remote configuration from server
  */
 export interface RemoteConfig {
+    /**
+     * The models on offer — for an agent, its `model` and `model_additionals` —
+     * each saying whether it can be used.
+     */
     models: ModelConfig[];
+    /**
+     * Who decided which models can be used: ai-inference's own list, or the
+     * runtime's configuration when it did not route through ai-inference or
+     * ai-inference did not answer.
+     */
+    modelsSource?: 'ai-inference' | 'local';
+    /** That decision in a sentence. */
+    modelsNote?: string;
+    /**
+     * The typed-decision models ai-inference serves (Jev), apart from `models`:
+     * a decision asks them, no agent runs on them, so they are never offered
+     * as the agent's model.
+     */
+    decisionModels: ModelConfig[];
+    /** What a typed-decision model is for, in a sentence. */
+    decisionsNote: string;
     defaultModel?: string;
     builtinTools: BuiltinTool[];
     mcpServers?: MCPServerConfig[];

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.3.29",
+    "version": "1.3.32",
     "type": "module",
     "workspaces": [
         ".",
@@ -56,6 +56,7 @@
         "build": "npm run clean && gulp resources-to-lib && tsc -b && cross-env NODE_OPTIONS=--max-old-space-size=8192 vite build",
         "build-storybook": "storybook build",
         "build:all": "npm run build && npm run build:examples",
+        "build:embed": "cross-env NODE_OPTIONS=--max-old-space-size=8192 vite build --config vite.embed.config.ts",
         "build:examples": "npm run build:nextjs",
         "build:lib": "npm run clean:lib && gulp resources-to-lib && tsc -b",
         "build:nextjs": "npm run build --workspace=nextjs-notebook-example",
@@ -117,6 +118,8 @@
         "test:all": "vitest run",
         "test:coverage": "vitest run --coverage --project=unit --project=general",
         "test:integration": "vitest run --project=integration",
+        "test:pictures": "playwright test -c pictures/playwright.config.ts",
+        "test:pictures:accept": "playwright test -c pictures/playwright.config.ts --update-snapshots=changed",
         "test:ui": "vitest --ui --project=unit --project=general",
         "test:unit": "vitest run --project=unit",
         "test:watch": "vitest --project=unit --project=general",
@@ -130,9 +133,9 @@
     },
     "dependencies": {
         "@a2a-js/sdk": "^0.3.6",
-        "@a2ui/markdown-it": "0.1.1",
-        "@a2ui/react": "0.11.0",
-        "@a2ui/web_core": "0.10.7",
+        "@a2ui/markdown-it": "0.2.0",
+        "@a2ui/react": "0.12.0",
+        "@a2ui/web_core": "0.12.0",
         "@ag-ui/client": "^0.0.42",
         "@ag-ui/core": "^0.0.57",
         "@ag-ui/encoder": "^0.0.57",
@@ -275,6 +278,7 @@
         "@copilotkit/runtime": "1.10.6",
         "@datalayer/reactor-graph": "^1.0.4",
         "@eslint/js": "^10.0.1",
+        "@playwright/test": "^1.63.0",
         "@storybook/addon-a11y": "^9.1.1",
         "@storybook/addon-docs": "^9.1.1",
         "@storybook/addon-onboarding": "^9.1.1",
@@ -328,7 +332,7 @@
         "vitest": "^3.2.4"
     },
     "resolutions": {
-        "@a2ui/web_core": "0.10.7",
+        "@a2ui/web_core": "0.12.0",
         "@langchain/core": "^0.3.80",
         "@ai-sdk/react": "4.0.93",
         "@microsoft/fast-colors": "5.3.1",
@@ -347,7 +351,7 @@
         "typescript": "5.9.3"
     },
     "overrides": {
-        "@a2ui/web_core": "0.10.7",
+        "@a2ui/web_core": "0.12.0",
         "@langchain/core": "^0.3.80",
         "@ai-sdk/react": "4.0.93",
         "@microsoft/fast-colors": "5.3.1",

package/scripts/check-cloudflare-models.py

@@ -69,14 +69,14 @@ def served(account: str, token: str) -> dict[str, dict]:
 def specs() -> list[dict]:
     """The Workers AI specs (``cloudflare-wrk-*.yaml``) that name a model Cloudflare
     hosts under ``@cf/``. The gateway flavour (``cloudflare-gtw-*``) and the typed
-    judgment models (``typesafe/jev``, with no ``@cf/`` namespace) are not in the
+    decision models (``typesafe/jev``, with no ``@cf/`` namespace) are not in the
     account's model listing and are left out.
     """
     found = []
     for path in sorted(SPECS.glob("cloudflare-wrk-*.yaml")):
         with open(path) as handle:
             data = yaml.safe_load(handle) or {}
-        if "judgments" in (data.get("capabilities") or []):
+        if "decisions" in (data.get("capabilities") or []):
             continue
         found.append({"file": path.name, **data})
     return found

package/scripts/codegen/generate_agents.py

@@ -276,9 +276,44 @@ def load_yaml_specs(specs_dir: Path) -> List[tuple[str, Dict[str, Any]]]:
             spec = resolve_spec(spec, by_id, fragments_by_id)
         resolved.append((subfolder, spec))
 
+    check_model_additionals(resolved, load_model_ids(specs_dir))
     return resolved
 
 
+def load_model_ids(specs_dir: Path) -> set[str]:
+    """Every id the models catalogue answers to: its ids and their aliases."""
+    ids: set[str] = set()
+    for yaml_file in sorted((specs_dir.parent / "models").glob("*.yaml")):
+        with open(yaml_file, "r") as f:
+            model = yaml.safe_load(f) or {}
+        if model.get("id"):
+            ids.add(str(model["id"]))
+        ids.update(str(alias) for alias in model.get("aliases") or [])
+    return ids
+
+
+def check_model_additionals(
+    specs: List[tuple[str, Dict[str, Any]]], model_ids: set[str]
+) -> None:
+    """Refuse an agent whose `model_additionals` names a model the catalogue does not know."""
+    problems = []
+    for _, spec in specs:
+        additionals = spec.get("model_additionals")
+        if additionals is None:
+            continue
+        if not isinstance(additionals, list):
+            problems.append(f"{spec.get('id')}: model_additionals is not a list")
+            continue
+        unknown = [str(m) for m in additionals if str(m) not in model_ids]
+        if unknown:
+            problems.append(
+                f"{spec.get('id')}: model_additionals names models the catalogue "
+                f"does not know: {', '.join(unknown)}"
+            )
+    if problems:
+        raise SystemExit("\n".join(problems))
+
+
 def generate_python_code(specs: List[tuple[str, Dict[str, Any]]]) -> str:
     """Generate Python code from agent specifications."""
     # Header
@@ -423,6 +458,12 @@ from agent_runtimes.types import (
             # Model field
             model_id = spec.get("model")
             model_str = f'"{model_id}"' if model_id else "None"
+            model_additionals = spec.get("model_additionals") or []
+            model_additionals_py_line = (
+                f"    model_additionals={_fmt_list(model_additionals)},\n"
+                if model_additionals
+                else ""
+            )
             inference_provider = spec.get("inference_provider")
             inference_provider_str = (
                 f'"{inference_provider}"' if inference_provider else "None"
@@ -547,7 +588,7 @@ from agent_runtimes.types import (
     domain={f'"{domain_value}"' if domain_value else "None"},
     enabled={spec.get("enabled", True)},
     model={model_str},
-    inference_provider={inference_provider_str},
+{model_additionals_py_line}    inference_provider={inference_provider_str},
     mcp_servers=[{mcp_servers_str}],
     skills={_fmt_list(skill_refs)},
     tools={_fmt_list(tool_refs)},
@@ -1045,6 +1086,12 @@ const FRONTEND_TOOL_MAP: Record<string, any> = {
             # Model field
             model_id = spec.get("model")
             model_ts = f"'{model_id}'" if model_id else "undefined"
+            model_additionals = spec.get("model_additionals") or []
+            model_additionals_ts_line = (
+                f"    modelAdditionals: {_fmt_ts_literal(model_additionals)},\n"
+                if model_additionals
+                else ""
+            )
             inference_provider = spec.get("inference_provider")
             inference_provider_ts = (
                 f"'{inference_provider}'" if inference_provider else "undefined"
@@ -1116,7 +1163,7 @@ const FRONTEND_TOOL_MAP: Record<string, any> = {
     domain: {domain_ts},
     enabled: {str(spec.get("enabled", True)).lower()},
     model: {model_ts},
-{inference_provider_line}    mcpServers: [{mcp_servers_str}],
+{model_additionals_ts_line}{inference_provider_line}    mcpServers: [{mcp_servers_str}],
     skills: [{skills_str}].filter(Boolean) as SkillSpec[],
     tools: [{tools_str}],
 {disable_tool_approvals_line}    frontendTools: [{frontend_tools_str}],
@@ -1588,6 +1635,7 @@ export * from './tracks';
 export * from './ops';
 export * from './apps';
 export * from './actions';
+export * from './appspecSchema';
 """
     )
 

package/scripts/codegen/generate_apps.py

@@ -17,6 +17,11 @@ read, write, send, buy, delete, publish — read from ``agentspecs.actions``.
 Each application is validated here, by ``agentspecs`` itself, and arrives
 with its layout said and with what it names that is not enabled (`setup`).
 
+How each was built travels beside it (``APP_BUILT``), since an Appspec does
+not hold it: ``python`` when ``apps/<id>/app.py`` sits beside its spec
+(agentspecs >= 0.0.15), ``canvas`` when its page says it was composed on the
+Canvas (``composed_by: canvas``, agentspecs >= 0.0.23), else ``written``.
+
 Usage:
     python generate_apps.py \\
       --specs-dir agentspecs/agentspecs/apps \\
@@ -42,10 +47,11 @@ CAMEL = {
     "ready_at": "readyAt",
     "keep_for": "keepFor",
     "retention_days": "retentionDays",
+    "suggest_tests": "suggestTests",
     "composed_by": "composedBy",
     "composed_at": "composedAt",
     "min_confidence": "minConfidence",
-    "judgment_model": "judgmentModel",
+    "decision_model": "decisionModel",
 }
 
 #: The keys whose value is carried as it is written: a component tree, weights by name.
@@ -57,6 +63,16 @@ def _flat(text: Any) -> str:
     return " ".join(str(text or "").split())
 
 
+def built_of(specs_dir: Path, identity: str, app: Any) -> str:
+    """How an application was built: `python`, `canvas` or `written`."""
+    if (specs_dir / identity / "app.py").is_file():
+        return "python"
+    surface = app.interface.surface
+    if surface is not None and surface.composed_by == "canvas":
+        return "canvas"
+    return "written"
+
+
 def load_specs(specs_dir: Path) -> tuple[list[dict[str, Any]], dict[str, Any]]:
     """Every application, validated, as plain data — and the action classes."""
     apps_module = import_from_clone(specs_dir, "apps")
@@ -66,6 +82,7 @@ def load_specs(specs_dir: Path) -> tuple[list[dict[str, Any]], dict[str, Any]]:
     behaviours: dict[str, dict[str, str]] = {}
     escalations: dict[str, dict[str, Any]] = {}
     sources: dict[str, Any] = {}
+    built: dict[str, str] = {}
     for identity in sorted(apps):
         app = apps[identity]
         spec = app.model_dump(mode="json", by_alias=True)
@@ -78,6 +95,7 @@ def load_specs(specs_dir: Path) -> tuple[list[dict[str, Any]], dict[str, Any]]:
         }
         escalations[identity] = dict(sorted(apps_module.tool_escalations(app).items()))
         sources[identity] = apps_module.dump_app(app)
+        built[identity] = built_of(specs_dir, identity, app)
         for rule in spec["rules"]:
             rule["applies_to"] = (
                 [rule["applies_to"]]
@@ -129,6 +147,7 @@ def load_specs(specs_dir: Path) -> tuple[list[dict[str, Any]], dict[str, Any]]:
         "behaviours": behaviours,
         "escalations": escalations,
         "sources": sources,
+        "built": built,
     }
     return specs, actions
 
@@ -174,7 +193,7 @@ ABOUT_ACTIONS = [
 ]
 
 
-def generate_python_code(specs: list[dict[str, Any]]) -> str:
+def generate_python_code(specs: list[dict[str, Any]], built: dict[str, str]) -> str:
     """Generate the Python application catalogue."""
     lines = [
         "# Copyright (c) 2025-2026 Datalayer, Inc.",
@@ -185,7 +204,7 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
         *HEADER,
         '"""',
         "",
-        "from typing import Dict",
+        "from typing import Dict, Literal",
         "",
         "from agent_runtimes.types import AppSpec",
         "",
@@ -215,6 +234,10 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
         [
             "}",
             "",
+            "#: How each application was built: `python` (its `app.py`), `canvas` (its",
+            "#: page composed on the Canvas) or `written` (its spec written out).",
+            f"APP_BUILT: Dict[str, Literal['python', 'canvas', 'written']] = {built!r}",
+            "",
             "",
             "def get_app(app_id: str) -> AppSpec | None:",
             '    """An application, by `id` or `id:version`, or None."""',
@@ -235,7 +258,7 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
 
 
 def generate_typescript_code(
-    specs: list[dict[str, Any]], sources: dict[str, Any]
+    specs: list[dict[str, Any]], sources: dict[str, Any], built: dict[str, str]
 ) -> str:
     """Generate the TypeScript application catalogue."""
     lines = [
@@ -250,7 +273,7 @@ def generate_typescript_code(
         *[f" * {line}" for line in HEADER],
         " */",
         "",
-        "import type { AppKind, AppSpec } from '../types/agentspecs';",
+        "import type { AppBuilt, AppKind, AppSpec } from '../types/agentspecs';",
         "",
     ]
     for spec in specs:
@@ -288,6 +311,14 @@ def generate_typescript_code(
             + json.dumps(sources, indent=2, ensure_ascii=False)
             + ";",
             "",
+            "/**",
+            " * How each application was built: `python` (its `app.py`), `canvas` (its",
+            " * page composed on the Canvas) or `written` (its spec written out).",
+            " */",
+            "export const APP_BUILT: Record<string, AppBuilt> = "
+            + json.dumps(built, indent=2)
+            + ";",
+            "",
             "/** Every application of the catalogue, or those of a kind. */",
             "export function listApps(kind?: AppKind): AppSpec[] {",
             "  return Object.values(APP_CATALOGUE).filter(",
@@ -475,10 +506,10 @@ def main() -> None:
         sys.exit(1)
     specs, actions = load_specs(args.specs_dir)
     outputs = [
-        (args.python_output, generate_python_code(specs)),
+        (args.python_output, generate_python_code(specs, actions["built"])),
         (
             args.typescript_output,
-            generate_typescript_code(specs, actions["sources"]),
+            generate_typescript_code(specs, actions["sources"], actions["built"]),
         ),
         (args.actions_python_output, generate_actions_python_code(actions)),
         (args.actions_typescript_output, generate_actions_typescript_code(actions)),

package/scripts/codegen/generate_models.py

@@ -327,11 +327,11 @@ def generate_python_code(specs: list[dict[str, Any]]) -> str:
             "",
             "",
             "def is_chat_model(model: AIModel) -> bool:",
-            '    """A model a chat can run on: not a typed-judgment model (Jev), which',
+            '    """A model a chat can run on: not a typed-decision model (Jev), which',
             "    answers typed questions about a state and nothing else. A spec that",
             "    states no capability is read as a chat model.",
             '    """',
-            '    return "judgments" not in model.capabilities',
+            '    return "decisions" not in model.capabilities',
             "",
             "",
             "def list_chat_models() -> list[AIModel]:",
@@ -504,12 +504,12 @@ def generate_typescript_code(specs: list[dict[str, Any]]) -> str:
             "}",
             "",
             "/**",
-            " * A model a chat can run on: not a typed-judgment model (Jev), which",
+            " * A model a chat can run on: not a typed-decision model (Jev), which",
             " * answers typed questions about a state and nothing else. A spec that",
             " * states no capability is read as a chat model.",
             " */",
             "export function isChatModel(model: AIModel): boolean {",
-            "  return !(model.capabilities ?? []).includes('judgments');",
+            "  return !(model.capabilities ?? []).includes('decisions');",
             "}",
             "",
             "/** The models a person choosing a chat model is offered from. */",