@datalayer/agent-runtimes 1.3.84 → 1.3.85

package/lib/specs/appspecSchema.js

@@ -230,6 +230,82 @@ export const APPSPEC_SCHEMA = {
             title: 'AppCriterion',
             type: 'object',
         },
+        AppCustomComponent: {
+            additionalProperties: false,
+            description: "A component the developer writes (LOOP P-17), an A2UI component of this\napplication only: the catalog grows for it, it does not open.\n\nReviewed like any component of the catalog — its properties a JSON\nSchema, what it shows and sends bindings into the page's data — and drawn\nin a sandboxed frame of no origin, its module loaded from `source` and\nnothing else: what it is given is its properties and data, and what it\ngives back is what it sends.",
+            properties: {
+                name: {
+                    description: "Its name on a surface, as a catalog component's (`Gauge`); none of the catalog's own",
+                    pattern: '^[A-Z][A-Za-z0-9]{0,63}$',
+                    title: 'Name',
+                    type: 'string',
+                },
+                description: {
+                    description: 'What it is for, in a sentence: what the palette says',
+                    minLength: 1,
+                    title: 'Description',
+                    type: 'string',
+                },
+                props: {
+                    additionalProperties: true,
+                    description: 'Its properties, as the JSON Schema of an object: each typed `string`, `integer`, `number`, `boolean`, `array` or `object`, or an `enum` of words, with its `title`, `description` and `default`; `required` among them',
+                    title: 'Props',
+                    type: 'object',
+                },
+                shows: {
+                    description: "What it shows from the page's data: each a binding, given a path or a value in place",
+                    items: {
+                        type: 'string',
+                    },
+                    title: 'Shows',
+                    type: 'array',
+                },
+                sends: {
+                    description: 'What it sends back: each a binding it writes, then its `action` dispatched',
+                    items: {
+                        type: 'string',
+                    },
+                    title: 'Sends',
+                    type: 'array',
+                },
+                source: {
+                    description: "The address of its module, a built ES module whose default export draws it (`export default function (root, {props, send})`): over `https://`, or `http://localhost` while it is written. A module of the application's folder waits for its packaging (LOOP P-29)",
+                    title: 'Source',
+                    type: 'string',
+                },
+                integrity: {
+                    default: '',
+                    description: 'The module as it was reviewed: its Subresource Integrity hash (`sha384-…`); a module that differs is not drawn. Any module at the address when unsaid',
+                    title: 'Integrity',
+                    type: 'string',
+                },
+                height: {
+                    default: 240,
+                    description: 'Its height on the page, in pixels',
+                    maximum: 2000,
+                    minimum: 40,
+                    title: 'Height',
+                    type: 'integer',
+                },
+                example: {
+                    anyOf: [
+                        {
+                            additionalProperties: true,
+                            type: 'object',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: 'A configuration of it its schema accepts: what the palette previews',
+                    title: 'Example',
+                },
+            },
+            required: ['name', 'description', 'source'],
+            title: 'AppCustomComponent',
+            type: 'object',
+        },
         AppDecision: {
             additionalProperties: false,
             description: 'What a decision application decides.',
@@ -475,6 +551,14 @@ export const APPSPEC_SCHEMA = {
                     title: 'Components',
                     type: 'array',
                 },
+                custom_components: {
+                    description: "Components its developer wrote (LOOP P-17), of this application only: each named, its props a JSON Schema, its module's address; placed, shown and drawn as the catalog's own",
+                    items: {
+                        $ref: '#/$defs/AppCustomComponent',
+                    },
+                    title: 'Custom Components',
+                    type: 'array',
+                },
                 surface: {
                     anyOf: [
                         {
@@ -487,6 +571,18 @@ export const APPSPEC_SCHEMA = {
                     default: null,
                     description: 'The component tree, when there is one',
                 },
+                page: {
+                    anyOf: [
+                        {
+                            $ref: '#/$defs/AppPage',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: "A widget's page written in its code (`@app.page`, LOOP P-05): its inputs as a form, its outputs as values; run again as an input changes, its outputs shown in place. None when unsaid",
+                },
                 assistant: {
                     anyOf: [
                         {
@@ -669,6 +765,89 @@ export const APPSPEC_SCHEMA = {
             title: 'AppOptionTranslation',
             type: 'object',
         },
+        AppPage: {
+            additionalProperties: false,
+            description: "A widget's page written in its code (LOOP P-05): `@app.page`.\n\nIts inputs are a form, drawn on the page; as one changes, the function\nof its code runs again on them and the page shows what it returned, in\nplace. Without its file nothing runs it, and validation says so.",
+            properties: {
+                function: {
+                    description: 'The function of its code that runs the page',
+                    pattern: '^[A-Za-z_][A-Za-z0-9_]*$',
+                    title: 'Function',
+                    type: 'string',
+                },
+                inputs: {
+                    additionalProperties: true,
+                    description: 'Its inputs: the JSON Schema of a form, an object of named fields, each with its `title` and its `default`; on the page at `/inputs/<name>`, checked by the runtime against the same schema',
+                    title: 'Inputs',
+                    type: 'object',
+                },
+                inputs_ui: {
+                    anyOf: [
+                        {
+                            additionalProperties: true,
+                            type: 'object',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: 'How its inputs are drawn, as `interface.settings_ui` draws the settings: a uiSchema by field name',
+                    title: 'Inputs Ui',
+                },
+                outputs: {
+                    description: 'What it shows for its inputs, in order, each at `/outputs/<name>`',
+                    items: {
+                        $ref: '#/$defs/AppPageOutput',
+                    },
+                    minItems: 1,
+                    title: 'Outputs',
+                    type: 'array',
+                },
+                live: {
+                    default: true,
+                    description: 'Whether it runs again as an input changes; `false`: when the person presses Run',
+                    title: 'Live',
+                    type: 'boolean',
+                },
+            },
+            required: ['function', 'inputs', 'outputs'],
+            title: 'AppPage',
+            type: 'object',
+        },
+        AppPageOutput: {
+            additionalProperties: false,
+            description: 'One thing a page shows for its inputs (LOOP P-05): a value, drawn with a component.',
+            properties: {
+                name: {
+                    description: 'Its name: what its code returns it under, and where the page shows it (`/outputs/<name>`)',
+                    pattern: '^[A-Za-z_][A-Za-z0-9_]*$',
+                    title: 'Name',
+                    type: 'string',
+                },
+                title: {
+                    default: '',
+                    description: 'What a person reads above it; none when unsaid',
+                    title: 'Title',
+                    type: 'string',
+                },
+                component: {
+                    default: 'Text',
+                    description: "What draws it: `Text` (words, unless said), `Image` (an address), `Table` (rows) or `Chart` (points), or a component of the application's own (`interface.custom_components`, LOOP P-17), its value what it shows first",
+                    title: 'Component',
+                    type: 'string',
+                },
+                props: {
+                    additionalProperties: true,
+                    description: "The component's other properties: a Table's `columns`, a Chart's `kind`, `x` and `y`",
+                    title: 'Props',
+                    type: 'object',
+                },
+            },
+            required: ['name'],
+            title: 'AppPageOutput',
+            type: 'object',
+        },
         AppPermissions: {
             additionalProperties: false,
             description: 'What the application may reach beside its connections. Nothing, unless said.',
@@ -1371,7 +1550,7 @@ export const APPSPEC_SCHEMA = {
         },
         HostBridge: {
             additionalProperties: false,
-            description: "What the host page and the application say to each other (LOOP D-10).\n\nThe values of the host it reads (`context`: `user`, `page`, or a name of\nthe host's own), through the tool `host_context`; the functions of the\nhost it may call, each through `host_<name>`. Every one of these tools is\ndecided by a rule that names it, as any tool is: one no rule names is\nleft to the person.",
+            description: "What the host page and the application say to each other (LOOP D-10).\n\nThe values of the host it reads (`context`: `user`, `page`, or a name of\nthe host's own), through the tool `host_context`; the functions of the\nhost it may call, each through `host_<name>`. Every one of these tools is\ndecided by a rule that names it, as any tool is: one no rule names is\nleft to the person.\n\nWho its user is (`user`, LOOP D-21): what the page says (`claimed`), or\nonly what the host's server signed (`signed`) — a short token, HS256\nwith the deployment's secret, naming `sub`, `name` and `exp` at most an\nhour away. An application that acts in each user's name, or shows data\nthat is theirs, says `signed`.",
             properties: {
                 context: {
                     description: "The host's values it reads: `user`, `page`, or names of the host's own",
@@ -1389,6 +1568,11 @@ export const APPSPEC_SCHEMA = {
                     title: 'Functions',
                     type: 'array',
                 },
+                user: {
+                    $ref: '#/$defs/HostUser',
+                    default: 'claimed',
+                    description: "Who its user is: `claimed`, what the page says; `signed`, only a token the host's server signed with the deployment's secret, the unsigned one refused",
+                },
             },
             title: 'HostBridge',
             type: 'object',
@@ -1418,6 +1602,12 @@ export const APPSPEC_SCHEMA = {
             title: 'HostFunction',
             type: 'object',
         },
+        HostUser: {
+            description: "What the host page's word on its visitor is worth (LOOP D-21).",
+            enum: ['claimed', 'signed'],
+            title: 'HostUser',
+            type: 'string',
+        },
         HostedDeployment: {
             additionalProperties: false,
             description: 'The application at an address of its own.',

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

@@ -576,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
@@ -651,7 +709,11 @@ export interface AppInterfaceSpec {
     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.
@@ -764,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';

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. */