@datalayer/agent-runtimes 1.3.84 → 1.3.86

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

@@ -31,6 +31,7 @@ export * from './outputs';
 export * from './personas';
 export * from './protocol';
 export * from './sandbox';
+export * from './scenes';
 export * from './skills';
 export * from './stream';
 export * from './teams';

package/lib/types/index.js

@@ -35,6 +35,7 @@ export * from './outputs';
 export * from './personas';
 export * from './protocol';
 export * from './sandbox';
+export * from './scenes';
 export * from './skills';
 export * from './stream';
 export * from './teams';

package/lib/types/scenes.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Scenes (agentspecs `scenes`, `schema: loop.scene/v1`, LOOP A-11): a team,
+ * staged. The team says who is on stage; the scene says what happens there —
+ * the setting, the script, the stage directions, the audience, the rehearsal
+ * and where it plays.
+ *
+ * In the generated catalogue the cast is resolved: every member of the team,
+ * each with its persona filled from its application, and the `entry` said.
+ *
+ * @module types/scenes
+ */
+import type { AppVerifiedSpec } from './agentspecs';
+import type { TeamLinkSpec } from './teams';
+/** How a member appears to the audience, in a scene. */
+export interface ScenePersonaSpec {
+    /** The name the audience sees. */
+    name: string;
+    /** One emoji, its face on stage. */
+    face: string;
+    /** One line of *who I am here*. */
+    line: string;
+}
+/** A member of the cast: a member of the team, with its persona and its brief. */
+export interface SceneCastMemberSpec {
+    /** Its id in the team. */
+    member: string;
+    /** The application it is, `id:version`; empty for an agent or a server. */
+    app: string;
+    /** The agent it is, when it is not an application. */
+    ref: string;
+    /** The MCP server it is, a system of the scene, when it is one. */
+    server: string;
+    /** What it is for, structurally: initiator, contributor, … */
+    role?: string;
+    /** Where its loop turns. */
+    runsIn?: 'browser' | 'runtime';
+    /** Whom it asks, and over what; absent when it asks nobody. */
+    talksTo?: TeamLinkSpec[];
+    persona: ScenePersonaSpec;
+    /** What it is for in this scene, over its application's instructions. */
+    brief: string;
+}
+/** A system on stage: an MCP server the cast reaches. */
+export interface SceneSystemSpec {
+    /** The server, `id` or `id:version`. */
+    server: string;
+    /** The name the audience reads on the graph and in the transcript. */
+    as: string;
+    /** What it holds in this scene. */
+    holds: string;
+}
+/** The stage: what is on it, and what the audience is told. */
+export interface SceneSettingSpec {
+    systems: SceneSystemSpec[];
+    /** The Frames the scene plays under, over the team's; absent when none. */
+    frames?: string[];
+    /** The data in play; absent when none. */
+    contents?: string[];
+    /** When the scene plays, in words. */
+    period: string;
+    /** The language it plays in, `en`. */
+    language: string;
+    /** What the audience is told before it starts: the line under the title. */
+    assumes: string;
+}
+/** What starts a beat: one of the three is said. */
+export interface SceneCueSpec {
+    /** An opener the audience may say: the entry's suggestion on the page. */
+    say: string;
+    schedule: string;
+    event: string;
+}
+/** What kind of answer comes back, and what the page shows. */
+export type SceneAnswerKind = 'words' | 'table' | 'chart' | 'notebook' | 'map' | 'file' | 'image';
+/** How fast a beat plays for the audience. */
+export type ScenePace = 'quick' | 'steady' | 'slow';
+/** One member asking another over a protocol, or answering the audience. */
+export interface SceneMoveSpec {
+    /** The member moving, by its id in the cast. */
+    who: string;
+    /** Whom: a member or a system; empty when it answers the audience. */
+    asks: string;
+    /** `a2a` to a member, `mcp` to a system. */
+    over?: 'a2a' | 'mcp';
+    /** What it asks for, or what it answers, in words. */
+    what: string;
+    /** Over `mcp`: the tool, by name or pattern. */
+    tool: string;
+    /** The kind of tool: `read`, `write`, … */
+    does?: string;
+    /** What kind of answer comes back. */
+    answers?: SceneAnswerKind;
+}
+/** What a beat does instead when a decision holds. */
+export interface SceneBranchSpec {
+    decision: string;
+    expect: string;
+    /** The moves then, when they differ; absent otherwise. */
+    moves?: SceneMoveSpec[];
+    /** The beat that follows, by id. */
+    then: string;
+}
+/** One beat of the script. */
+export interface SceneBeatSpec {
+    id: string;
+    cue: SceneCueSpec;
+    /** One line for the audience, read in the transcript. */
+    narration: string;
+    moves: SceneMoveSpec[];
+    /** What should happen, in words. */
+    expect: string;
+    /** What the page shows: said, or the kinds of the answers to the audience. */
+    shows: SceneAnswerKind[];
+    /** Its pace; the stage's when absent. */
+    pace?: ScenePace;
+    /** What it does instead, on a decision; absent when it never branches. */
+    branch?: SceneBranchSpec[];
+}
+/** Where a member stands: fractions of the box. */
+export interface ScenePositionSpec {
+    x: number;
+    y: number;
+}
+/** What the transcript shows. */
+export interface SceneTranscriptSpec {
+    tools: boolean;
+    narration: boolean;
+    /** Words withheld; absent when none. */
+    withhold?: ('credentials' | 'ids' | 'addresses' | 'amounts')[];
+}
+/** Directions for the page. */
+export interface SceneStageSpec {
+    positions: Record<string, ScenePositionSpec>;
+    /** Whose balloon opens first; the entry's when empty. */
+    opensFirst: string;
+    transcript: SceneTranscriptSpec;
+    inspectors: ('agent' | 'tools' | 'a2a' | 'notebook' | 'cost')[];
+    /** How long the scene plays before it rests, `10m`. */
+    restsAfter: string;
+    pace: ScenePace;
+}
+/** Who may watch and ask, and what an ask may cost. */
+export interface SceneAudienceSpec {
+    who: 'visitors' | 'signed-in' | 'nobody';
+    /** What one ask may cost, in USD; the site's when 0. */
+    ceilingPerAsk: number;
+    /** How many asks a visitor gets a day; the site's when 0. */
+    asksADay: number;
+}
+/** What a beat's transcript must look like. */
+export interface SceneRehearsalBeatSpec {
+    beat: string;
+    /** The shape, in order: `Sales → Accounting`, `Accounting → Odoo: odoo_accounting_*`, `Accounting: a table`. */
+    lines: string[];
+    mustSay?: string[];
+    mustNotSay?: string[];
+    within: string;
+}
+/** A transcript recorded once, played when the scene cannot play live (LOOP H-08). */
+export interface SceneRecordingSpec {
+    path: string;
+    taken: string;
+    note: string;
+}
+/** The scene's tests: a passing rehearsal is the gallery's *Live*. */
+export interface SceneRehearsalSpec {
+    beats: SceneRehearsalBeatSpec[];
+    within: string;
+    recording?: SceneRecordingSpec;
+    verified: AppVerifiedSpec;
+}
+/** Where the scene plays. */
+export interface SceneDeploymentSpec {
+    account: string;
+    /** The page it plays on. */
+    page: string;
+    /** For each member on a runtime, the variable its address is read from at build. */
+    addresses: Record<string, string>;
+}
+/** Specification for a scene: a team, staged. */
+export interface SceneSpec {
+    /** The version of the spec itself: `loop.scene/v1`. */
+    schema: string;
+    id: string;
+    version: string;
+    /** The tab's name. */
+    name: string;
+    description: string;
+    tags: string[];
+    icon: string;
+    /** Its face: one emoji, drawn before its name. */
+    emoji: string;
+    /** The team it stages, `id:version`; empty when the cast was written inline. */
+    team: string;
+    /** The member the audience talks to. */
+    entry: string;
+    /** The cast, resolved: every member of the team with its persona filled. */
+    cast: SceneCastMemberSpec[];
+    setting: SceneSettingSpec;
+    script: SceneBeatSpec[];
+    stage: SceneStageSpec;
+    audience: SceneAudienceSpec;
+    rehearsal: SceneRehearsalSpec;
+    deployment: SceneDeploymentSpec;
+    /** What it names that is not enabled today, in sentences. */
+    setup: string[];
+}

package/lib/types/scenes.js

@@ -0,0 +1,5 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+export {};

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