@datalayer/agent-runtimes 1.3.83 → 1.3.85

package/lib/specs/teams/teams.d.ts

@@ -10,7 +10,10 @@ export declare const ANALYZE_SUPPORT_TICKETS_TEAM_SPEC_0_0_1: TeamSpec;
 export declare const AUDIT_INVENTORY_LEVELS_TEAM_SPEC_0_0_1: TeamSpec;
 export declare const AUTOMATE_REGULATORY_REPORTING_TEAM_SPEC_0_0_1: TeamSpec;
 export declare const COMPREHENSIVE_SALES_ANALYTICS_TEAM_SPEC_0_0_1: TeamSpec;
+export declare const CROP_MONITORING_TEAM_SPEC_0_0_1: TeamSpec;
+export declare const DISASTER_ASSESSMENT_TEAM_SPEC_0_0_1: TeamSpec;
 export declare const JUPYTER_TEAM_SPEC_0_0_1: TeamSpec;
+export declare const MONTH_END_CLOSE_TEAM_SPEC_0_0_1: TeamSpec;
 export declare const NOTEBOOK_BENCHMARK_TEAM_SPEC_0_0_1: TeamSpec;
 export declare const OPTIMIZE_GRID_OPERATIONS_TEAM_SPEC_0_0_1: TeamSpec;
 export declare const PROCESS_CITIZEN_REQUESTS_TEAM_SPEC_0_0_1: TeamSpec;

package/lib/specs/teams/teams.js

@@ -704,6 +704,187 @@ export const COMPREHENSIVE_SALES_ANALYTICS_TEAM_SPEC_0_0_1 = {
         storage: 's3://reports/sales-analytics/',
     },
 };
+export const CROP_MONITORING_TEAM_SPEC_0_0_1 = {
+    id: 'crop-monitoring',
+    version: '0.0.1',
+    name: 'Crop monitoring',
+    description: `One agent, its data: Crop monitoring follows crop vigour and growth over a season from the satellite imagery NASA Earthdata holds, and flags the fields that need attention.`,
+    tags: [
+        'example',
+        'scene',
+        'earth-observation',
+        'agriculture',
+        'earthdata',
+        'a2a',
+    ],
+    enabled: true,
+    icon: 'telescope',
+    emoji: '🛰️',
+    color: '#1a7f37',
+    agentSpecId: '',
+    orchestrationProtocol: 'a2a',
+    executionMode: 'supervisor',
+    supervisor: {
+        name: 'Crop monitoring',
+        ref: '',
+        app: 'crop-monitoring:0.0.1',
+        model: '',
+        goal: ``,
+        instructions: ``,
+        approval: 'auto',
+        canTerminate: true,
+    },
+    routingInstructions: `Crop monitoring answers every request from the imagery itself, one search at a time, and reports what the granules show without adding to it.`,
+    entry: 'crop-monitoring',
+    suggestions: [
+        {
+            text: 'How has crop vigour evolved over the last three months around 45.5N, 10.2E?',
+            emoji: '🌱',
+        },
+        {
+            text: 'Which fields around 41.9N, 12.5E show a drop in vegetation this month compared with last?',
+            emoji: '🌾',
+        },
+        {
+            text: 'Which datasets and granules cover the Po valley for June 2026?',
+            emoji: '🛰️',
+        },
+    ],
+    delegation: {
+        maxDepth: 0,
+        allowPeerDelegation: false,
+        includeGeneralPurpose: false,
+    },
+    context: { sharing: 'shared' },
+    validation: { timeout: '300s', retryOnFailure: false, maxRetries: 0 },
+    agents: [
+        {
+            id: 'crop-monitoring',
+            name: '',
+            ref: '',
+            app: 'crop-monitoring:0.0.1',
+            runsIn: 'runtime',
+            role: 'initiator',
+            goal: `Take the person's field and period, search the imagery that covers them, and report the vigour, the growth and the fields to watch.`,
+            dependsOn: [],
+            subagents: [],
+            model: '',
+            mcpServer: '',
+            tools: [],
+            trigger: '',
+            approval: 'auto',
+        },
+    ],
+};
+export const DISASTER_ASSESSMENT_TEAM_SPEC_0_0_1 = {
+    id: 'disaster-assessment',
+    version: '0.0.1',
+    name: 'Disaster assessment',
+    description: `An event desk in the browser that gets the area a disaster affected and the damage from Disaster assessment, and what changed on the ground from Change detection, each on a runtime over A2A, each reading NASA Earthdata. Event response takes the event and reports; the two others read the imagery and answer.`,
+    tags: [
+        'example',
+        'scene',
+        'earth-observation',
+        'disaster',
+        'insurance',
+        'earthdata',
+        'a2a',
+    ],
+    enabled: true,
+    icon: 'pulse',
+    emoji: '🛰️',
+    color: '#cf222e',
+    agentSpecId: '',
+    orchestrationProtocol: 'a2a',
+    executionMode: 'supervisor',
+    supervisor: {
+        name: 'Event response',
+        ref: '',
+        app: 'event-response:0.0.1',
+        model: '',
+        goal: ``,
+        instructions: ``,
+        approval: 'auto',
+        canTerminate: true,
+    },
+    routingInstructions: `Event response asks Disaster assessment for the area and the damage, and Change detection for the change on the ground, one request each, and reports what they answer without adding to it.`,
+    entry: 'event-response',
+    suggestions: [
+        {
+            text: 'Valencia, Spain, was flooded on 29 October 2024. What was affected, and what changed?',
+            emoji: '🌊',
+        },
+        {
+            text: 'Fires burned around Los Angeles from 7 January 2025. What was affected, and what changed?',
+            emoji: '🔥',
+        },
+        {
+            text: 'The Ahr valley was hit by a storm on 14 July 2021. What was affected, and what changed?',
+            emoji: '🌧️',
+        },
+    ],
+    delegation: {
+        maxDepth: 1,
+        allowPeerDelegation: true,
+        includeGeneralPurpose: false,
+    },
+    context: { sharing: 'shared' },
+    validation: { timeout: '600s', retryOnFailure: false, maxRetries: 0 },
+    agents: [
+        {
+            id: 'event-response',
+            name: '',
+            ref: '',
+            app: 'event-response:0.0.1',
+            runsIn: 'browser',
+            talksTo: [
+                { member: 'disaster-assessment', over: 'a2a' },
+                { member: 'change-detection', over: 'a2a' },
+            ],
+            role: 'initiator',
+            goal: `Take the person's event, ask Disaster assessment and Change detection for it, and report what they answered.`,
+            dependsOn: [],
+            subagents: [],
+            model: '',
+            mcpServer: '',
+            tools: [],
+            trigger: '',
+            approval: 'auto',
+        },
+        {
+            id: 'disaster-assessment',
+            name: '',
+            ref: '',
+            app: 'disaster-assessment:0.0.1',
+            runsIn: 'runtime',
+            role: 'contributor',
+            goal: `Estimate the area the event affected and the extent of the damage from the imagery before and after it, over A2A.`,
+            dependsOn: [],
+            subagents: [],
+            model: '',
+            mcpServer: '',
+            tools: [],
+            trigger: '',
+            approval: 'auto',
+        },
+        {
+            id: 'change-detection',
+            name: '',
+            ref: '',
+            app: 'change-detection:0.0.1',
+            runsIn: 'runtime',
+            role: 'contributor',
+            goal: `Find what changed on the ground between the two dates from the imagery, over A2A.`,
+            dependsOn: [],
+            subagents: [],
+            model: '',
+            mcpServer: '',
+            tools: [],
+            trigger: '',
+            approval: 'auto',
+        },
+    ],
+};
 export const JUPYTER_TEAM_SPEC_0_0_1 = {
     id: 'jupyter',
     version: '0.0.1',
@@ -928,6 +1109,71 @@ export const JUPYTER_TEAM_SPEC_0_0_1 = {
         storage: '',
     },
 };
+export const MONTH_END_CLOSE_TEAM_SPEC_0_0_1 = {
+    id: 'month-end-close',
+    version: '0.0.1',
+    name: 'Month-end close',
+    description: `One agent, its data: Month-end close drives the close from the Odoo books, which it only reads — the checklist, the accruals to book, the reconciliation gaps that remain.`,
+    tags: ['example', 'scene', 'accounting', 'finance', 'odoo', 'a2a'],
+    enabled: true,
+    icon: 'sync',
+    emoji: '🧾',
+    color: '#bf8700',
+    agentSpecId: '',
+    orchestrationProtocol: 'a2a',
+    executionMode: 'supervisor',
+    supervisor: {
+        name: 'Month-end close',
+        ref: '',
+        app: 'month-end-close:0.0.1',
+        model: '',
+        goal: ``,
+        instructions: ``,
+        approval: 'auto',
+        canTerminate: true,
+    },
+    routingInstructions: `Month-end close answers every request from the books itself, one read at a time, and reports what the books hold without adding to it.`,
+    entry: 'month-end-close',
+    suggestions: [
+        {
+            text: 'Where does the month-end close stand for last month? Give me the checklist.',
+            emoji: '☑️',
+        },
+        {
+            text: 'Which accruals should be booked for last month, and for how much?',
+            emoji: '🧾',
+        },
+        {
+            text: 'Which bank lines and open items are still unreconciled for last month?',
+            emoji: '🏦',
+        },
+    ],
+    delegation: {
+        maxDepth: 0,
+        allowPeerDelegation: false,
+        includeGeneralPurpose: false,
+    },
+    context: { sharing: 'shared' },
+    validation: { timeout: '300s', retryOnFailure: false, maxRetries: 0 },
+    agents: [
+        {
+            id: 'month-end-close',
+            name: '',
+            ref: '',
+            app: 'month-end-close:0.0.1',
+            runsIn: 'runtime',
+            role: 'initiator',
+            goal: `Take the person's request, read the period's books, and report where the close stands: what is done, what is to book, what is still open.`,
+            dependsOn: [],
+            subagents: [],
+            model: '',
+            mcpServer: '',
+            tools: [],
+            trigger: '',
+            approval: 'auto',
+        },
+    ],
+};
 export const NOTEBOOK_BENCHMARK_TEAM_SPEC_0_0_1 = {
     id: 'notebook-benchmark',
     version: '0.0.1',
@@ -1679,7 +1925,10 @@ export const TEAM_SPECS = {
     'audit-inventory-levels': AUDIT_INVENTORY_LEVELS_TEAM_SPEC_0_0_1,
     'automate-regulatory-reporting': AUTOMATE_REGULATORY_REPORTING_TEAM_SPEC_0_0_1,
     'comprehensive-sales-analytics': COMPREHENSIVE_SALES_ANALYTICS_TEAM_SPEC_0_0_1,
+    'crop-monitoring': CROP_MONITORING_TEAM_SPEC_0_0_1,
+    'disaster-assessment': DISASTER_ASSESSMENT_TEAM_SPEC_0_0_1,
     jupyter: JUPYTER_TEAM_SPEC_0_0_1,
+    'month-end-close': MONTH_END_CLOSE_TEAM_SPEC_0_0_1,
     'notebook-benchmark': NOTEBOOK_BENCHMARK_TEAM_SPEC_0_0_1,
     'optimize-grid-operations': OPTIMIZE_GRID_OPERATIONS_TEAM_SPEC_0_0_1,
     'process-citizen-requests': PROCESS_CITIZEN_REQUESTS_TEAM_SPEC_0_0_1,

package/lib/specs/uiPlugins.js

@@ -949,7 +949,7 @@ export const A2UI_UI_PLUGIN_0_0_1 = {
             category: 'input',
             emoji: '🧾',
             description: 'Several fields asked at once, from a JSON Schema, checked as they are filled and again when they arrive (drawn with @datalayer/primer-rjsf).',
-            version: '1.0.0',
+            version: '1.1.0',
             standard: false,
             properties: {
                 type: 'object',
@@ -965,6 +965,11 @@ export const A2UI_UI_PLUGIN_0_0_1 = {
                         title: 'Fields',
                         description: 'The JSON Schema of what is asked: its fields, their types, what is required.',
                     },
+                    ui: {
+                        type: 'object',
+                        title: 'How its fields are drawn',
+                        description: "By field name, the ui: options @datalayer/primer-rjsf reads (a uiSchema): ui:widget one of select, radio, range, updown, switch, checkbox, text, textarea, date, checkboxes, tags; each field's own widget when unsaid.",
+                    },
                     submit_label: {
                         type: 'string',
                         title: 'Send button',

package/lib/types/agentspecs.d.ts

@@ -446,6 +446,59 @@ export interface AppPermissionsSpec {
 export interface AppStarterSpec {
     label: string;
     message: string;
+    /**
+     * The heading it is offered under (LOOP P-20): the starters of one
+     * category together, those without one first. Absent when unsaid.
+     */
+    category?: string;
+}
+/**
+ * One of several assistants in one application (LOOP P-20): picked before
+ * the conversation starts — the first unless another is — and kept to its
+ * end. Its instructions are told in every run, its model run in place of the
+ * application's (a mode's wins over it), its starters offered in place of
+ * the application's.
+ */
+export interface AppProfileSpec {
+    id: string;
+    label: string;
+    description: string;
+    instructions: string;
+    model: string | null;
+    starters: AppStarterSpec[];
+}
+/**
+ * What a person reads of an application in another language (LOOP P-26):
+ * each part keyed by what names it in the spec — a starter by its label, a
+ * category by its words, a setting by its field, a command by its name, a
+ * mode and a profile by their ids. Every key present; empty is untranslated.
+ */
+export interface AppTranslationSpec {
+    name: string;
+    description: string;
+    welcome: string;
+    starters: Record<string, {
+        label: string;
+        message: string;
+    }>;
+    categories: Record<string, string>;
+    settings: Record<string, {
+        title: string;
+        description: string;
+        options: Record<string, string>;
+    }>;
+    commands: Record<string, string>;
+    modes: Record<string, {
+        label: string;
+        options: Record<string, {
+            label: string;
+            description: string;
+        }>;
+    }>;
+    profiles: Record<string, {
+        label: string;
+        description: string;
+    }>;
 }
 /** A slash command the user picks in the composer (LOOP P-19). */
 export interface AppCommandSpec {
@@ -523,6 +576,64 @@ export interface AppSurfaceSpec {
     composedBy: string;
     composedAt: string;
 }
+/** What a page's output is drawn with of the catalog (LOOP P-05). */
+export type AppPageOutputComponent = 'Text' | 'Image' | 'Table' | 'Chart';
+/**
+ * A component its developer wrote (LOOP P-17), of one application only: the
+ * catalog grows for it, it does not open. Reviewed as the catalog's own — its
+ * properties a JSON Schema, what it shows and sends bindings — and drawn in a
+ * sandboxed frame of no origin from the built ES module at `source`.
+ */
+export interface AppCustomComponentSpec {
+    /** Its name on a surface (`Gauge`); none of the catalog's own. */
+    name: string;
+    /** What it is for, in a sentence: what the palette says. */
+    description: string;
+    /** Its properties: the JSON Schema of an object. */
+    props: Record<string, unknown>;
+    /** What it shows from the page's data: bindings. */
+    shows: string[];
+    /** What it sends back: bindings it writes, then its action. */
+    sends: string[];
+    /** The address of its module: `https://`, or `http://localhost` while written. */
+    source: string;
+    /** Its Subresource Integrity hash (`sha384-…`); empty when unsaid. */
+    integrity: string;
+    /** Its height on the page, in pixels. */
+    height: number;
+    /** A configuration its schema accepts: what the palette previews. */
+    example?: Record<string, unknown>;
+}
+/** One thing a widget's page shows for its inputs (LOOP P-05), at `/outputs/<name>`. */
+export interface AppPageOutputSpec {
+    name: string;
+    /** What a person reads above it; none when empty. */
+    title: string;
+    /**
+     * `Text` (words) unless said, `Image` (an address), `Table` (rows), `Chart`
+     * (points) — an `AppPageOutputComponent` — or a component of the
+     * application's own (P-17), its value what it shows first.
+     */
+    component: string;
+    /** The component's other properties: a Table's `columns`, a Chart's `kind`, `x`, `y`. */
+    props: Record<string, unknown>;
+}
+/**
+ * A widget's page written in its code (LOOP P-05, `@app.page`): its inputs a
+ * form, drawn at `/inputs/<name>`; its outputs values, shown at
+ * `/outputs/<name>`. As an input changes, the function its code names runs
+ * again on all of them, and the outputs change in place.
+ */
+export interface AppPageSpec {
+    /** The function of its code that runs it. */
+    function: string;
+    inputs: AppFormSchema;
+    /** How the inputs are drawn, as `settingsUi` draws the settings. */
+    inputsUi?: Record<string, unknown>;
+    outputs: AppPageOutputSpec[];
+    /** Whether it runs again as an input changes; else when Run is pressed. */
+    live: boolean;
+}
 /**
  * An application's voice (VOICE.md VO-41), off unless said: whether a person
  * may talk to it, whether its answers are heard, with which voice of the
@@ -537,6 +648,25 @@ export interface AppVoiceSpec {
     language: string;
     where: 'auto' | 'device' | 'server';
 }
+/**
+ * A kind of file a person may send, and how large (LOOP P-21): a media type
+ * (`application/pdf`), a family (`image/*`, `audio/*`) or an extension
+ * (`.csv`), lowercase.
+ */
+export interface AppUploadKindSpec {
+    type: string;
+    /** The largest file of this kind, in megabytes; 10 unless said, 25 at most. */
+    maxMb: number;
+}
+/**
+ * What a person may send in the composer without being asked (LOOP P-21):
+ * the kinds it takes, each with its largest size, and how many at once.
+ */
+export interface AppUploadsSpec {
+    kinds: AppUploadKindSpec[];
+    /** The most files sent with one message; 5 unless said. */
+    maxFiles: number;
+}
 /** What the user of an application sees. */
 export interface AppInterfaceSpec {
     layout: AppLayout;
@@ -550,14 +680,40 @@ export interface AppInterfaceSpec {
     commands: AppCommandSpec[];
     /** Mode switches in the composer, the option picked going with every run (P-19). */
     modes: AppModeSpec[];
+    /**
+     * Several assistants in one application (P-20): two at least, or none.
+     * Absent from a spec made before profiles.
+     */
+    profiles?: AppProfileSpec[];
     /**
      * What a person may set: the JSON Schema of a form (C-16), drawn beside the
      * conversation and on a deployment's Ship card; none when unsaid.
      */
     settings?: AppFormSchema;
+    /**
+     * How the settings' fields are drawn (P-20): a uiSchema as
+     * `@datalayer/primer-rjsf` reads it, by field name — `ui:widget` one of
+     * `select`, `radio`, `range`, `updown`, `switch`, `checkbox`, `text`,
+     * `textarea`, `date`, `checkboxes`, `tags`. Each field's own when unsaid.
+     */
+    settingsUi?: Record<string, unknown>;
+    /** The language its own words are in, BCP 47 (P-26); `en` when absent. */
+    language?: string;
+    /** Its words in other languages, by BCP 47 tag (P-26). */
+    translations?: Record<string, AppTranslationSpec>;
+    /**
+     * What a person may send in the composer without being asked (P-21): none
+     * when unsaid — the composer offers no attachment, and the runtime refuses
+     * a file sent with a message.
+     */
+    uploads?: AppUploadsSpec;
     /** The components of the catalog the surface may use. */
     components: string[];
+    /** Components its developer wrote (P-17); absent from a spec made before them. */
+    customComponents?: AppCustomComponentSpec[];
     surface?: AppSurfaceSpec;
+    /** A widget's page written in its code (P-05); none when unsaid. */
+    page?: AppPageSpec;
     /**
      * The character its floating assistant shows; the paper clip when unsaid.
      * Said, it wins over the one the person chose in their settings.
@@ -581,6 +737,12 @@ export interface AppInterfaceSpec {
 export interface AppTestCaseSpec {
     ask: string;
     expect: string;
+    /**
+     * The function of its code that decides the case, by name (LOOP P-06:
+     * `@app.test`); `expect` still says it in words, and decides it without
+     * the file. Empty, or absent, for a case in words alone.
+     */
+    code?: string;
 }
 /**
  * What was verified, and how, each in a sentence a person reads (LOOP E-14):
@@ -612,11 +774,38 @@ export interface AppRecordSpec {
      */
     suggestTests: boolean;
 }
-/** Optional checks from the catalogue. */
+/** Where a check of an application's code runs (LOOP P-06). */
+export type AppCheckStage = 'answer' | 'tool_call';
+/** A check written in an application's code (LOOP P-06: `@app.check`). */
+export interface AppCodeCheckSpec {
+    /** The function of its code that checks. */
+    name: string;
+    /** On every answer, or every tool call the rules let through. */
+    on: AppCheckStage;
+    /** What it checks, in a sentence a person reads. */
+    description: string;
+}
+/** Optional checks from the catalogue, and its code's own. */
 export interface AppChecksSpec {
     guards: string[];
     gates: string[];
     track: string;
+    /** Checks written in its code (LOOP P-06); absent when it has none. */
+    code?: AppCodeCheckSpec[];
+}
+/**
+ * A tool of an application's own, written in its code (LOOP P-06:
+ * `@app.tool`): its agent calls it, and the rules decide each call by what
+ * it `does`, or by a rule that names it by its name alone.
+ */
+export interface AppToolSpec {
+    name: string;
+    /** What it does, for the agent. */
+    description: string;
+    /** The JSON Schema of its arguments, an object. */
+    parameters: Record<string, unknown>;
+    /** What it does, by class of action: `read`, `write`, `send`… */
+    does: string[];
 }
 /** A function of the host page the application's agent may call (LOOP D-10). */
 export interface AppHostFunctionSpec {
@@ -637,7 +826,15 @@ export interface AppHostFunctionSpec {
 export interface AppHostBridgeSpec {
     context: string[];
     functions: AppHostFunctionSpec[];
+    /**
+     * Who its user is (LOOP D-21): `claimed`, what the page says (unless
+     * said); `signed`, only a token the host's server signed with the
+     * deployment's secret — the unsigned one refused.
+     */
+    user?: AppHostUser;
 }
+/** What the host page's word on its visitor is worth (LOOP D-21). */
+export type AppHostUser = 'claimed' | 'signed';
 export interface AppDeploymentSpec {
     hosted?: {
         visibility: 'private' | 'invited' | 'organization' | 'link' | 'public';
@@ -711,6 +908,8 @@ export interface AppSpec {
     skills: string[];
     /** Backend tools (agentspecs/backend-tools) it adds to its agent's. */
     backendTools: string[];
+    /** Tools of its own, written in its code (LOOP P-06); absent when it has none. */
+    tools?: AppToolSpec[];
     /** The Frames it works under. */
     context: string[];
     /** The documents and datasets it answers from. */

package/lib/types/chat.d.ts

@@ -8,7 +8,7 @@ import type { ComponentType, ReactNode } from 'react';
 import type { ICollaborationProvider } from '@datalayer/jupyter-react';
 import type { ChatMessage, MessageHandler } from './messages';
 import type { Protocol, ProtocolConfig } from './protocol';
-import type { AgentInspectorSink } from '../components/inspector/agentInspector';
+import type { OtelLiveTracer } from '@datalayer/core/lib/otel/live';
 import type { McpServerSelection } from './inference';
 import type { MCPServerTool } from './mcp';
 import type { AgentRuntimeConfig } from './config';
@@ -1273,11 +1273,12 @@ export interface ChatBaseProps {
      */
     onToolCallComplete?: (context: ToolCallCompleteContext) => void;
     /**
-     * The Agent Inspector's sink: the agent's turns (its model, its tokens)
-     * and its tool calls, from start to end, are recorded there. Without it,
-     * the sink of the nearest `AgentInspectorProvider`, if any.
+     * The Agent Inspector's tracer: the agent's turns (`invoke_agent` spans:
+     * its model, its tokens) and its tool calls (`execute_tool` spans), from
+     * start to end, are recorded there. Without it, the tracer of the nearest
+     * `AgentInspectorProvider`, if any.
      */
-    inspector?: AgentInspectorSink | null;
+    inspector?: OtelLiveTracer | null;
     /**
      * Whether to render the top-of-chat tool approval banner (and its review
      * dialog) when `pendingApprovals` is non-empty. The banner/dialog render

package/lib/types/teams.d.ts

@@ -46,6 +46,11 @@ export interface TeamContextSpec {
      * what the team *is*.
      */
     sharing: TeamContextSharing;
+    /**
+     * The Frames every member works under, in order, `id` or `id:version`
+     * (LOOP A-04): the team's shared context, as a Cog names its own.
+     */
+    frames?: string[];
 }
 /** How far members may hand work to each other, and to subagents. */
 export interface TeamDelegationSpec {
@@ -60,8 +65,8 @@ export interface TeamDelegationSpec {
 export interface TeamLinkSpec {
     /** The member asked, by its id in the team. */
     member: string;
-    /** The protocol: `a2a`. */
-    over: 'a2a';
+    /** The protocol: `a2a` to an agent or an application, `mcp` to a server member. */
+    over: 'a2a' | 'mcp';
 }
 export interface TeamAgentspec {
     /** Agent identifier within the team */
@@ -80,6 +85,12 @@ export interface TeamAgentspec {
      * application, with its agent, connections, rules and interface.
      */
     app?: string;
+    /**
+     * MCP server catalogue reference, in place of `ref` and `app`: the member
+     * is that server, a system of the scene the others reach over MCP
+     * (LOOP A-04). It asks nobody.
+     */
+    server?: string;
     /** Where its loop turns: in the person's `browser`, or on a `runtime`. */
     runsIn?: 'browser' | 'runtime';
     /** The members it asks directly while it works, and over what. */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.3.83",
+    "version": "1.3.85",
     "type": "module",
     "workspaces": [
         ".",
@@ -147,7 +147,7 @@
         "@ai-sdk/react": "4.0.93",
         "@anthropic-ai/sdk": "^0.52.0",
         "@datalayer/agent-teams": "^1.0.0",
-        "@datalayer/core": "^1.2.14",
+        "@datalayer/core": "^1.2.18",
         "@datalayer/decks": "^1.0.4",
         "@datalayer/icons-react": "^1.0.16",
         "@datalayer/jupyter-lexical": "^2.0.18",