@datalayer/agent-runtimes 1.3.83 → 1.3.85

package/scripts/codegen/generate_apps.py

@@ -54,6 +54,8 @@ CAMEL = {
     "decision_model": "decisionModel",
     "backend_tools": "backendTools",
     "character_alone": "characterAlone",
+    "settings_ui": "settingsUi",
+    "custom_components": "customComponents",
 }
 
 #: The keys whose value is carried as it is written: a component tree, weights by name.
@@ -110,6 +112,24 @@ def load_specs(specs_dir: Path) -> tuple[list[dict[str, Any]], dict[str, Any]]:
                 if isinstance(rule["applies_to"], str)
                 else rule["applies_to"]
             )
+        # A starter offered under a category names it; the others say nothing of it.
+        for starter in [
+            *spec["interface"]["starters"],
+            *(
+                item
+                for profile in spec["interface"]["profiles"]
+                for item in profile["starters"]
+            ),
+        ]:
+            if not starter.get("category"):
+                starter.pop("category", None)
+        # A case decided by code names it; the others say nothing of it.
+        for case in spec["tests"]["cases"]:
+            if not case.get("code"):
+                case.pop("code", None)
+        # Components of its own: said only when it has some.
+        if not spec["interface"].get("custom_components"):
+            spec["interface"].pop("custom_components", None)
         for key in ("description", "instructions", "goal"):
             spec[key] = _flat(spec.get(key))
         spec["interface"]["welcome"] = _flat(spec["interface"].get("welcome"))
@@ -476,8 +496,6 @@ def generate_schema_typescript_code() -> str:
             " * @module specs/appspecSchema",
             " */",
             "",
-            "/* eslint-disable */",
-            "",
             "export type JsonSchema = {",
             "  [key: string]: unknown;",
             "  type?: string;",

package/scripts/codegen/generate_teams.py

@@ -151,6 +151,8 @@ def _generate_team_agent_py(agent: Dict[str, Any]) -> str:
     # emitted only when said, as a team of agents says none of them.
     if agent.get("app"):
         lines.append(f'            app="{agent["app"]}",')
+    if agent.get("server"):
+        lines.append(f'            server="{agent["server"]}",')
     if agent.get("runs_in"):
         lines.append(f'            runs_in="{agent["runs_in"]}",')
     links = agent.get("talks_to") or []
@@ -220,6 +222,7 @@ def _generate_team_agent_ts(agent: Dict[str, Any]) -> str:
     links = agent.get("talks_to") or []
     application = (
         (f"\n      app: '{agent['app']}'," if agent.get("app") else "")
+        + (f"\n      server: '{agent['server']}'," if agent.get("server") else "")
         + (f"\n      runsIn: '{agent['runs_in']}'," if agent.get("runs_in") else "")
         + (
             "\n      talksTo: ["
@@ -484,10 +487,14 @@ from agent_runtimes.types import (
             # `shared` by default: routing only makes sense if the member
             # receiving the work can see what was already said.
             context = spec.get("context") or {}
+            # The Frames of its shared context (LOOP A-04): written only when
+            # it names some, as the parser reads it.
+            frames = context.get("frames") or []
             code += (
                 "    context=TeamContextSpec("
                 f'sharing="{context.get("sharing", "shared")}"'
-                "),\n"
+                + (f", frames={_fmt_list(frames)}" if frames else "")
+                + "),\n"
             )
             code += f"    validation={validation_code},\n"
             code += f"    agents={agents_code},\n"
@@ -778,7 +785,13 @@ import type {{ TeamSpec }} from '{types_import_path}';
                 " },\n"
             )
             context = spec.get("context") or {}
-            code += f"  context: {{ sharing: '{context.get('sharing', 'shared')}' }},\n"
+            frames = context.get("frames") or []
+            frames_ts = (
+                ", frames: [" + ", ".join(f"'{frame}'" for frame in frames) + "]"
+                if frames
+                else ""
+            )
+            code += f"  context: {{ sharing: '{context.get('sharing', 'shared')}'{frames_ts} }},\n"
             code += f"  validation: {validation_ts},\n"
             code += f"  agents: {agents_ts},\n"
             if rr_ts is not None:

package/lib/components/inspector/JsonTree.d.ts

@@ -1,24 +0,0 @@
-/**
- * A JSON value as a tree: objects and arrays fold and unfold, each value
- * coloured by its type (theme colours, light and dark), long strings cut
- * until asked for whole, and the whole value copied as JSON.
- *
- * @module components/inspector/JsonTree
- */
-import type { JSX } from 'react';
-export type JsonTreeProps = {
-    value: unknown;
-    /** The root's name, shown as its key. */
-    name?: string;
-    /** How many levels open at first. */
-    expandDepth?: number;
-    /** Offer *Copy JSON* above the tree. */
-    copyable?: boolean;
-    /** Longer strings are cut until clicked. */
-    stringLimit?: number;
-};
-/** A value's type, as the tree colours it. */
-export declare function jsonType(value: unknown): 'string' | 'number' | 'boolean' | 'null' | 'array' | 'object' | 'undefined';
-/** A JSON value, as a tree. */
-export declare function JsonTree({ value, name, expandDepth, copyable, stringLimit, }: JsonTreeProps): JSX.Element;
-export default JsonTree;

package/lib/components/inspector/JsonTree.js

@@ -1,89 +0,0 @@
-import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
-import { useState } from 'react';
-import { Button, Text } from '@primer/react';
-import { Box } from '@datalayer/primer-addons';
-import { CopyIcon, CheckIcon } from '@primer/octicons-react';
-const MONO = 'ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace';
-/** A value's type, as the tree colours it. */
-export function jsonType(value) {
-    if (value === null) {
-        return 'null';
-    }
-    if (Array.isArray(value)) {
-        return 'array';
-    }
-    const type = typeof value;
-    if (type === 'string' || type === 'number' || type === 'boolean') {
-        return type;
-    }
-    if (type === 'bigint') {
-        return 'number';
-    }
-    return type === 'undefined' ? 'undefined' : 'object';
-}
-const COLOURS = {
-    string: 'success.fg',
-    number: 'accent.fg',
-    boolean: 'done.fg',
-    null: 'fg.muted',
-    undefined: 'fg.muted',
-};
-function Leaf({ value, stringLimit, }) {
-    const type = jsonType(value);
-    const [whole, setWhole] = useState(false);
-    if (type === 'string') {
-        const text = value;
-        const cut = !whole && text.length > stringLimit;
-        return (_jsxs(Text, { "data-json-type": "string", sx: {
-                color: COLOURS.string,
-                whiteSpace: 'pre-wrap',
-                wordBreak: 'break-word',
-            }, children: [JSON.stringify(cut ? text.slice(0, stringLimit) : text), cut && (_jsxs(Box, { as: "button", type: "button", onClick: () => setWhole(true), sx: {
-                        ml: 1,
-                        p: 0,
-                        border: 0,
-                        bg: 'transparent',
-                        color: 'accent.fg',
-                        cursor: 'pointer',
-                        font: 'inherit',
-                    }, children: ["\u2026 ", text.length - stringLimit, " more"] }))] }));
-    }
-    return (_jsx(Text, { "data-json-type": type, sx: { color: COLOURS[type] ?? 'fg.default' }, children: type === 'undefined' ? 'undefined' : String(value) }));
-}
-function Node({ name, value, depth, expandDepth, stringLimit, }) {
-    const type = jsonType(value);
-    const branch = type === 'array' || type === 'object';
-    const [open, setOpen] = useState(depth < expandDepth);
-    const key = name !== undefined ? (_jsxs(Text, { sx: { color: 'fg.default', fontWeight: 600 }, children: [name, ": "] })) : null;
-    if (!branch) {
-        return (_jsxs(Box, { role: "treeitem", "data-json-node": "", sx: { pl: 3 }, children: [key, _jsx(Leaf, { value: value, stringLimit: stringLimit })] }));
-    }
-    const items = type === 'array'
-        ? value.map((item, index) => [String(index), item])
-        : Object.entries(value);
-    const [openMark, closeMark] = type === 'array' ? ['[', ']'] : ['{', '}'];
-    return (_jsxs(Box, { role: "treeitem", "aria-expanded": open, "data-json-node": "", sx: { pl: depth ? 3 : 0 }, children: [_jsxs(Box, { as: "button", type: "button", onClick: () => setOpen(!open), "aria-label": `${open ? 'Fold' : 'Unfold'} ${name ?? 'the value'}`, "data-json-toggle": "", sx: {
-                    p: 0,
-                    border: 0,
-                    bg: 'transparent',
-                    color: 'inherit',
-                    font: 'inherit',
-                    cursor: 'pointer',
-                    textAlign: 'left',
-                }, children: [_jsx(Text, { sx: { color: 'fg.muted', display: 'inline-block', width: '1em' }, children: open ? '▾' : '▸' }), key, _jsx(Text, { sx: { color: 'fg.muted' }, children: open
-                            ? openMark
-                            : `${openMark} ${items.length} ${type === 'array' ? (items.length === 1 ? 'item' : 'items') : items.length === 1 ? 'key' : 'keys'} ${closeMark}` })] }), open && (_jsxs(Box, { role: "group", children: [items.map(([itemName, item]) => (_jsx(Node, { name: itemName, value: item, depth: depth + 1, expandDepth: expandDepth, stringLimit: stringLimit }, itemName))), _jsx(Text, { sx: { color: 'fg.muted', pl: 3 }, children: closeMark })] }))] }));
-}
-/** A JSON value, as a tree. */
-export function JsonTree({ value, name, expandDepth = 1, copyable = true, stringLimit = 240, }) {
-    const [copied, setCopied] = useState(false);
-    const copy = () => {
-        const text = JSON.stringify(value, null, 2) ?? 'undefined';
-        void navigator.clipboard?.writeText(text).then(() => {
-            setCopied(true);
-            setTimeout(() => setCopied(false), 1500);
-        }, () => undefined);
-    };
-    return (_jsxs(Box, { "data-json-tree": "", sx: { fontFamily: MONO, fontSize: 0, lineHeight: 1.6, minWidth: 0 }, children: [copyable && (_jsx(Button, { size: "small", variant: "invisible", leadingVisual: copied ? CheckIcon : CopyIcon, onClick: copy, "data-json-copy": "", sx: { float: 'right' }, children: copied ? 'Copied' : 'Copy JSON' })), _jsx(Box, { role: "tree", "aria-label": name ?? 'JSON', children: _jsx(Node, { name: name, value: value, depth: 0, expandDepth: expandDepth, stringLimit: stringLimit }) })] }));
-}
-export default JsonTree;

package/lib/components/inspector/a2aInspect.d.ts

@@ -1,56 +0,0 @@
-/**
- * The A2A traffic between two agents, as the Agent Inspector records it: a
- * fetch that hands every request on and records what went (the JSON-RPC
- * request: its method, its message) and what came back — a JSON-RPC
- * response, or each server-sent event of a stream (the task, its status
- * updates, its artifact updates, a message) — with its task, context and
- * state, whole.
- *
- * It sits under the A2A SDK (`ClientFactory`'s `JsonRpcTransportFactory`
- * takes a `fetchImpl`): the SDK reads the response it is handed, and the
- * inspector reads a copy of its body. Nothing it records changes what the
- * SDK sees, and a key sent as a header is never recorded.
- *
- * A peer served by agent-runtimes tells each tool call of its agent on a
- * `working` status (`{tool_call}`, then `{tool_result}`): each call is
- * recorded besides as one entry of its own, the peer's, from its start to
- * its end, linked to the two statuses — an MCP call, a skill, or a tool its
- * runtime runs, by who claims its name. The text chunks of one artifact are
- * one entry, their count kept.
- *
- * {@link linkA2APeerEvent} attaches what the asker made of an event (an
- * `A2APeerEvent`) to the entry it came from.
- *
- * @module components/inspector/a2aInspect
- */
-import type { A2APeerEvent } from '../../runtimes/browser/a2aPeer';
-import { type AgentInspectorEntry, type AgentInspectorSink, type ToolClass } from './agentInspector';
-export type A2AInspectOptions = {
-    sink: AgentInspectorSink;
-    /** The agent that asks: `Sales`. */
-    asker: string;
-    /** The agent asked: `Accounting`. */
-    peer: string;
-    /**
-     * Where a peer's tool call comes from — an MCP server's, a skill, … — and
-     * its mark (`classifyToolCall`, or a team's `teamToolClassifier`).
-     * Without it, a tool the peer's runtime runs (`backend-tool`).
-     */
-    classifyTool?: (name: string, args?: Record<string, unknown>) => ToolClass;
-};
-/** The text of an A2A 1.0 message's or artifact's parts, as JSON carries them. */
-export declare function partsText(parts: unknown): string;
-/** `TASK_STATE_WORKING` is `working`. */
-export declare function stateWord(state: unknown): string;
-/**
- * A fetch that records the A2A traffic it carries into `options.sink`, and
- * hands the SDK what the network gave.
- */
-export declare function inspectA2AFetch(base: typeof globalThis.fetch, options: A2AInspectOptions): typeof globalThis.fetch;
-/**
- * The linker the A2A capture adds to its sink: an `A2APeerEvent` noted
- * (`sink.note`) is attached to the entry it came from.
- */
-export declare function a2aEventLinker(event: unknown): ((entry: AgentInspectorEntry) => boolean) | undefined;
-/** Attach what the asker made of an event to the A2A entry it came from. */
-export declare function linkA2APeerEvent(sink: AgentInspectorSink, event: A2APeerEvent): void;