@datalayer/agent-runtimes 1.3.60 → 1.3.62

package/lib/types/chat.d.ts

@@ -964,6 +964,18 @@ export interface ChatBaseProps {
     notebookToolSurfacesId?: string;
     /** Custom footer content (rendered above input) */
     footerContent?: ReactNode;
+    /**
+     * The agent's welcome, said as the first message of the history: drawn as
+     * the chat draws the agent's messages, and never sent nor kept. The floating
+     * assistant's balloon opens on it (LOOP T-23).
+     */
+    welcome?: string;
+    /**
+     * What follows the last message, inside the history and scrolled with it:
+     * the floating assistant's balloon holds an approval there, as a message
+     * with *Approve* and *Deny* (T-23).
+     */
+    trailingContent?: ReactNode;
     /**
      * Show the information icon in the header.
      * When clicked, fires onInformationClick.

package/lib/types/teams.d.ts

@@ -56,6 +56,13 @@ export interface TeamDelegationSpec {
     /** Whether members also get the general-purpose subagent. */
     includeGeneralPurpose: boolean;
 }
+/** One member asking another directly, over a protocol (agentspecs `TeamLink`). */
+export interface TeamLinkSpec {
+    /** The member asked, by its id in the team. */
+    member: string;
+    /** The protocol: `a2a`. */
+    over: 'a2a';
+}
 export interface TeamAgentspec {
     /** Agent identifier within the team */
     id: string;
@@ -68,6 +75,15 @@ export interface TeamAgentspec {
      * the fields below then say what is different about it in this team.
      */
     ref?: string;
+    /**
+     * Application catalogue reference, in place of `ref`: the member is that
+     * application, with its agent, connections, rules and interface.
+     */
+    app?: 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. */
+    talksTo?: TeamLinkSpec[];
     /** Structural role: coordinator, initiator, contributor, reviewer, finalizer. */
     role?: string;
     /**
@@ -100,6 +116,8 @@ export interface TeamSupervisorSpec {
     name: string;
     /** Agent catalogue reference, `id` or `id:version`. */
     ref?: string;
+    /** Application catalogue reference, in a team of applications. */
+    app?: string;
     /** Model id, overriding the referenced agent's. */
     model?: string;
     /** What the supervisor is accountable for across the whole run. */
@@ -203,6 +221,8 @@ export interface TeamSpec {
     supervisor: TeamSupervisorSpec;
     /** Instructions for routing tasks between agents */
     routingInstructions?: string;
+    /** The member a person talks to, by its id: the team's front door. */
+    entry?: string;
     /**
      * Openers shown in an empty chat.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.3.60",
+    "version": "1.3.62",
     "type": "module",
     "workspaces": [
         ".",
@@ -132,7 +132,7 @@
         "watch:lib:src": "tsc -b -w"
     },
     "dependencies": {
-        "@a2a-js/sdk": "^0.3.6",
+        "@a2a-js/sdk": "^1.3.0",
         "@a2ui/markdown-it": "0.2.0",
         "@a2ui/react": "0.12.0",
         "@a2ui/web_core": "0.12.0",

package/scripts/codegen/generate_teams.py

@@ -147,6 +147,19 @@ def _generate_team_agent_py(agent: Dict[str, Any]) -> str:
     # The reference into the agent catalogue. Emitted before the overrides
     # because it is what the member *is*; the rest says how it differs here.
     lines.append(f'            ref="{agent.get("ref", "")}",')
+    # A member that is an application, where it runs and whom it asks:
+    # emitted only when said, as a team of agents says none of them.
+    if agent.get("app"):
+        lines.append(f'            app="{agent["app"]}",')
+    if agent.get("runs_in"):
+        lines.append(f'            runs_in="{agent["runs_in"]}",')
+    links = agent.get("talks_to") or []
+    if links:
+        rendered_links = ", ".join(
+            f'TeamLinkSpec(member="{link["member"]}", over="{link.get("over", "a2a")}")'
+            for link in links
+        )
+        lines.append(f"            talks_to=[{rendered_links}],")
     lines.append(f'            role="{agent.get("role", "contributor")}",')
     goal = agent.get("goal", "").replace('"', '\\"').replace("\n", " ").strip()
     lines.append(f'            goal="{goal}",')
@@ -204,10 +217,25 @@ def _generate_team_agent_ts(agent: Dict[str, Any]) -> str:
         if subagents
         else "[]"
     )
+    links = agent.get("talks_to") or []
+    application = (
+        (f"\n      app: '{agent['app']}'," if agent.get("app") else "")
+        + (f"\n      runsIn: '{agent['runs_in']}'," if agent.get("runs_in") else "")
+        + (
+            "\n      talksTo: ["
+            + ", ".join(
+                f"{{ member: '{link['member']}', over: '{link.get('over', 'a2a')}' }}"
+                for link in links
+            )
+            + "],"
+            if links
+            else ""
+        )
+    )
     return f"""    {{
       id: '{agent.get("id", "")}',
       name: '{agent.get("name", "")}',
-      ref: '{agent.get("ref", "")}',
+      ref: '{agent.get("ref", "")}',{application}
       role: '{agent.get("role", "contributor")}',
       goal: `{goal}`,
       dependsOn: {depends_on},
@@ -236,6 +264,7 @@ from typing import Dict, Optional
 
 from agent_runtimes.types import (
     TeamAgentspec,
+    TeamLinkSpec,
     TeamContextSpec,
     TeamDelegationSpec,
     TeamSubagentspec,
@@ -314,8 +343,11 @@ from agent_runtimes.types import (
                     .replace("\n", " ")
                     .strip()
                 )
+                sup_app = (
+                    f'app="{supervisor["app"]}", ' if supervisor.get("app") else ""
+                )
                 supervisor_code = (
-                    f'TeamSupervisorSpec(name="{sup_name}", ref="{sup_ref}", '
+                    f'TeamSupervisorSpec(name="{sup_name}", ref="{sup_ref}", {sup_app}'
                     f'model="{sup_model}", goal="{sup_goal}", '
                     f'instructions="{sup_instructions}", '
                     f'approval="{supervisor.get("approval", "auto")}", '
@@ -426,6 +458,8 @@ from agent_runtimes.types import (
             )
             code += f"    supervisor={supervisor_code},\n"
             code += f'    routing_instructions="{routing}",\n'
+            if spec.get("entry"):
+                code += f'    entry="{spec["entry"]}",\n'
             suggestions = spec.get("suggestions") or []
             if suggestions:
                 rendered = ", ".join(
@@ -596,8 +630,11 @@ import type {{ TeamSpec }} from '{types_import_path}';
                     .replace("\n", " ")
                     .strip()
                 )
+                sup_app_ts = (
+                    f"app: '{supervisor['app']}', " if supervisor.get("app") else ""
+                )
                 supervisor_ts = (
-                    f"{{ name: '{sup_name}', ref: '{sup_ref}', "
+                    f"{{ name: '{sup_name}', ref: '{sup_ref}', {sup_app_ts}"
                     f"model: '{sup_model}', goal: `{sup_goal}`, "
                     f"instructions: `{sup_instructions}`, "
                     f"approval: '{supervisor.get('approval', 'auto')}', "
@@ -714,6 +751,8 @@ import type {{ TeamSpec }} from '{types_import_path}';
             code += f"  executionMode: '{spec.get('execution_mode', 'sequential')}',\n"
             code += f"  supervisor: {supervisor_ts},\n"
             code += f"  routingInstructions: `{routing}`,\n"
+            if spec.get("entry"):
+                code += f"  entry: '{spec['entry']}',\n"
             # What an empty chat offers. Emitted only when the team names
             # some: an empty array in every generated team would be four
             # hundred lines saying nothing.

package/lib/examples/AgentStrategyExample.d.ts

@@ -1,12 +0,0 @@
-import { ServiceManager } from '@jupyterlab/services';
-interface AgentStrategyExampleInnerProps {
-    serviceManager?: ServiceManager.IManager;
-}
-export declare function AgentStrategyExampleInner({ serviceManager, }: AgentStrategyExampleInnerProps): import("react").JSX.Element;
-/**
- * Main example component with Jupyter provider wrapper.
- */
-export declare function AgentStrategyExample({ serviceManager, }: {
-    serviceManager?: ServiceManager.IManager;
-}): import("react").JSX.Element;
-export default AgentStrategyExample;