@datalayer/agent-runtimes 1.3.81 → 1.3.83

package/lib/protocols/BrowserAgentAdapter.d.ts

@@ -26,6 +26,7 @@ import { type LanguageModel } from 'ai';
 import type { ProtocolAdapterConfig } from '../types/protocol';
 import type { ChatMessage } from '../types/messages';
 import type { FrontendToolDefinition } from '../types/tools';
+import type { AppModeEffect } from '../types/agentspecs';
 import type { AgentStreamSubagentPayload } from '../types/stream';
 import { BaseProtocolAdapter } from './BaseProtocolAdapter';
 import type { TeamContextSharing } from '../types/teams';
@@ -63,6 +64,13 @@ export interface BrowserAgentAdapterConfig extends ProtocolAdapterConfig, Fronte
     sharing?: TeamContextSharing;
     /** Told what a delegated run does, as it does it — see `subagentTools`. */
     onSubagentEvent?: (event: AgentStreamSubagentPayload) => void;
+    /**
+     * What the modes a run is sent in (`forwardedProps.loop.modes`, LOOP P-19)
+     * tell it, and the model it runs on: an application's, by agentspecs'
+     * rules. Unsaid for an agent with no modes, which refuses a run sent in
+     * some.
+     */
+    modeEffect?: (chosen: Record<string, string>) => AppModeEffect;
 }
 /**
  * An agent loop running in the page, speaking the protocol adapter interface.
@@ -111,6 +119,15 @@ export declare class BrowserAgentAdapter extends BaseProtocolAdapter {
      * `languageModel` is the host's own choice and is not swapped out.
      */
     private resolveModel;
+    /**
+     * What the modes a run is sent in tell it, and the model it runs on (LOOP
+     * P-19) — the runtime's session API applies the same, for that run only.
+     *
+     * Refused, in a sentence, rather than run without them: modes sent to an
+     * agent that has none, modes that are not the application's, and a mode
+     * naming a model for an agent whose model is the host's own.
+     */
+    private runModes;
     /**
      * Run one turn of the loop and report it as it happens.
      *
@@ -121,5 +138,6 @@ export declare class BrowserAgentAdapter extends BaseProtocolAdapter {
     sendMessage(message: ChatMessage, options?: {
         messages?: ChatMessage[];
         model?: string;
+        forwardedProps?: Record<string, unknown>;
     }): Promise<void>;
 }

package/lib/protocols/BrowserAgentAdapter.js

@@ -140,6 +140,30 @@ export class BrowserAgentAdapter extends BaseProtocolAdapter {
         }
         return createBrowserModel({ ...inference, model: requested || model });
     }
+    /**
+     * What the modes a run is sent in tell it, and the model it runs on (LOOP
+     * P-19) — the runtime's session API applies the same, for that run only.
+     *
+     * Refused, in a sentence, rather than run without them: modes sent to an
+     * agent that has none, modes that are not the application's, and a mode
+     * naming a model for an agent whose model is the host's own.
+     */
+    runModes(forwardedProps) {
+        const loop = forwardedProps?.loop;
+        const chosen = loop?.modes;
+        if (!chosen || Object.keys(chosen).length === 0) {
+            return undefined;
+        }
+        const { modeEffect, languageModel } = this.browserConfig;
+        if (!modeEffect) {
+            throw new Error('This agent has no modes: the options chosen in the composer cannot be applied to it.');
+        }
+        const effect = modeEffect(chosen);
+        if (effect.model && languageModel) {
+            throw new Error(`The mode chosen runs on ${effect.model}, and this agent's model is its host's own: it cannot run on another.`);
+        }
+        return effect;
+    }
     /**
      * Run one turn of the loop and report it as it happens.
      *
@@ -194,9 +218,18 @@ export class BrowserAgentAdapter extends BaseProtocolAdapter {
             this.emit({ type: 'message', message: assistant, timestamp: new Date() });
         };
         try {
+            // The modes the person is in, for this run only: their instructions
+            // after the agent's, and the model one names over the chat's.
+            const modes = this.runModes(options?.forwardedProps);
+            const { instructions } = this.browserConfig;
+            const system = modes?.instructions
+                ? [instructions?.trim(), modes.instructions]
+                    .filter(Boolean)
+                    .join('\n\n')
+                : instructions;
             const result = streamText({
-                model: this.resolveModel(options?.model),
-                system: this.browserConfig.instructions,
+                model: this.resolveModel(modes?.model || options?.model),
+                system,
                 messages: history,
                 tools: this.tools,
                 stopWhen: stepCountIs(this.browserConfig.maxSteps ?? DEFAULT_BROWSER_MAX_STEPS),

package/lib/runtimes/__tests__/fixtures/accounting-agent-card.json

@@ -38,6 +38,14 @@
           "pause": "/api/v1/a2a/pause",
           "steer": "/api/v1/a2a/steer"
         }
+      },
+      {
+        "uri": "https://datalayer.ai/extensions/face/v1",
+        "description": "Its face: an emoji, and an avatar when it has one.",
+        "required": false,
+        "params": {
+          "emoji": "🧾"
+        }
       }
     ]
   },

package/lib/runtimes/browser/a2aPeer.d.ts

@@ -37,7 +37,18 @@ export type A2APeer = {
     client: Client;
     card: AgentCard;
     skill: AgentSkill;
+    /** Its face, when its card carries one (`A2A_FACE_EXTENSION_URI`). */
+    face?: A2APeerFace;
 };
+/** The extension an agent card carries its face in: its name stays plain. */
+export declare const A2A_FACE_EXTENSION_URI = "https://datalayer.ai/extensions/face/v1";
+/** A peer's face: its emoji and, when it has one, its avatar's name. */
+export type A2APeerFace = {
+    emoji: string;
+    avatar?: string;
+};
+/** The face an agent card carries, if it carries one. */
+export declare function faceOfCard(card: AgentCard): A2APeerFace | undefined;
 export type ConnectA2APeerOptions = {
     /** Where the peer is served: `…/api/v1/a2a/agents/<application id>`. */
     url: string;

package/lib/runtimes/browser/a2aPeer.js

@@ -36,6 +36,19 @@ import { ClientFactory, ClientFactoryOptions, DefaultAgentCardResolver, JsonRpcT
 import { jsonSchema, tool } from 'ai';
 /** Where an A2A agent's card is, under the address it is served at. */
 export const AGENT_CARD_PATH = '.well-known/agent-card.json';
+/** The extension an agent card carries its face in: its name stays plain. */
+export const A2A_FACE_EXTENSION_URI = 'https://datalayer.ai/extensions/face/v1';
+/** The face an agent card carries, if it carries one. */
+export function faceOfCard(card) {
+    const extension = card.capabilities?.extensions?.find(candidate => candidate.uri === A2A_FACE_EXTENSION_URI);
+    const params = (extension?.params ?? {});
+    if (typeof params.emoji !== 'string' || !params.emoji) {
+        return undefined;
+    }
+    return typeof params.avatar === 'string' && params.avatar
+        ? { emoji: params.emoji, avatar: params.avatar }
+        : { emoji: params.emoji };
+}
 /** A fetch that sends the key as a bearer token, beside the caller's headers. */
 function withKey(base, key) {
     if (!key) {
@@ -69,7 +82,8 @@ export async function connectA2APeer(options) {
     if (!skill) {
         throw new Error(`${card.name || root} offers no skill on its agent card: there is nothing to ask it.`);
     }
-    return { client, card, skill };
+    const face = faceOfCard(card);
+    return face ? { client, card, skill, face } : { client, card, skill };
 }
 /** The media types an answer in words comes in: the answer itself, never an artifact of its own. */
 export const TEXT_MEDIA_TYPES = [

package/lib/runtimes/browser/protocol.d.ts

@@ -12,6 +12,7 @@ import type { ProtocolConfig } from '../../types/protocol';
 import type { AgentStreamSubagentPayload } from '../../types/stream';
 import type { FrontendToolDefinition } from '../../types/tools';
 import type { TeamContextSharing } from '../../types/teams';
+import type { AppModeEffect } from '../../types/agentspecs';
 import type { BrowserModelOptions } from './model';
 import type { BrowserSubagent } from './subagents';
 export type BrowserProtocolOptions = {
@@ -37,6 +38,8 @@ export type BrowserProtocolOptions = {
     sharing?: TeamContextSharing;
     /** Told what a delegated run does, as it does it — see `subagentTools`. */
     onSubagentEvent?: (event: AgentStreamSubagentPayload) => void;
+    /** What the modes a run is sent in tell it (LOOP P-19); none when unsaid. */
+    modeEffect?: (chosen: Record<string, string>) => AppModeEffect;
 };
 /**
  * The protocol config for an agent whose loop runs in this page.

package/lib/runtimes/browser/protocol.js

@@ -16,7 +16,7 @@
  *   keystroke, so an omitted flag reads as a chat that silently ignores typing.
  */
 export function browserProtocolConfig(options) {
-    const { agentId, instructions, model, frontendTools, inference, subagents, sharing, onSubagentEvent, } = options;
+    const { agentId, instructions, model, frontendTools, inference, subagents, sharing, onSubagentEvent, modeEffect, } = options;
     return {
         type: 'browser-vercel-ai',
         endpoint: '',
@@ -30,6 +30,7 @@ export function browserProtocolConfig(options) {
             subagents,
             sharing,
             onSubagentEvent,
+            modeEffect,
         },
     };
 }

package/lib/specs/agents/agents.js

@@ -4900,8 +4900,9 @@ export const JUPYTER_DATA_ANALYST_AGENTSPEC_0_0_1 = {
         'collaboration',
     ],
     domain: undefined,
-    enabled: false,
+    enabled: true,
     model: 'bedrock:us.anthropic.claude-sonnet-4-6',
+    modelAdditionals: ['alibaba:qwen-max'],
     mcpServers: [],
     skills: [].filter(Boolean),
     backendTools: [TOOL_MAP['runtime-echo:0.0.1']],
@@ -7966,8 +7967,9 @@ export const WORKER_CUSTOMER_INTERVIEWER_AGENTSPEC_0_0_1 = {
     description: `Conducts adaptive, AI-led interviews that respond intelligently to each answer. It asks relevant follow-up questions, uncovers motivations and decision-making patterns, and transforms conversations into structured, actionable insights.`,
     tags: ['research', 'customer-support', 'analysis'],
     domain: 'market-analyst',
-    enabled: false,
+    enabled: true,
     model: 'bedrock:us.anthropic.claude-sonnet-4-6',
+    modelAdditionals: ['alibaba:qwen-max'],
     mcpServers: [],
     skills: [
         SKILL_MAP['text-summarizer:0.0.1']
@@ -8249,8 +8251,9 @@ export const WORKER_DOCUMENT_QA_AGENTSPEC_0_0_1 = {
         'qa',
     ],
     domain: 'personal-assistant',
-    enabled: false,
+    enabled: true,
     model: 'bedrock:us.anthropic.claude-sonnet-4-6',
+    modelAdditionals: ['alibaba:qwen-max'],
     mcpServers: [],
     skills: [
         SKILL_MAP['events:0.0.1']