@datalayer/agent-runtimes 1.3.17 → 1.3.18

package/lib/loop/apps/appspec.js

@@ -103,6 +103,8 @@ export function emptyAppspec(kind = 'chat') {
         tags: [],
         icon: DEFAULT_ICON,
         emoji: DEFAULT_EMOJI,
+        avatar: '',
+        banner: '',
     };
 }
 // --- reading --------------------------------------------------------------------------
@@ -139,6 +141,8 @@ const KNOWN_KEYS = [
     'tags',
     'icon',
     'emoji',
+    'avatar',
+    'banner',
 ];
 function parseConnection(data) {
     return {
@@ -353,6 +357,8 @@ export function parseAppspec(document) {
         tags: texts(data.tags),
         icon: text(data.icon, DEFAULT_ICON),
         emoji: text(data.emoji, DEFAULT_EMOJI) || DEFAULT_EMOJI,
+        avatar: text(data.avatar).trim(),
+        banner: text(data.banner).trim(),
     };
     if (isData(data.decision)) {
         app.decision = parseDecision(data.decision);
@@ -559,7 +565,9 @@ export function dumpAppspec(app) {
         .value('enabled', app.enabled, true)
         .list('tags', app.tags)
         .text('icon', app.icon ?? DEFAULT_ICON, DEFAULT_ICON)
-        .text('emoji', app.emoji, DEFAULT_EMOJI);
+        .text('emoji', app.emoji, DEFAULT_EMOJI)
+        .text('avatar', app.avatar ?? '', '')
+        .text('banner', app.banner ?? '', '');
     return writer.data;
 }
 /** The keys of a document in the order they are written. */

package/lib/loop/apps/checks.js

@@ -408,9 +408,18 @@ export function documentShapeProblems(document) {
         'memory',
         'emoji',
         'icon',
+        'avatar',
+        'banner',
     ]) {
         text(d[key], key);
     }
+    // A drawing is named as it is in the profile's sets, `AstronautIcon`.
+    for (const key of ['avatar', 'banner']) {
+        const name = typeof d[key] === 'string' ? d[key].trim() : '';
+        if (name && !/^[A-Z][A-Za-z0-9]{0,63}$/.test(name)) {
+            at(key, 'is named as its drawing is, `AstronautIcon`');
+        }
+    }
     for (const key of [
         'skills',
         'tools',

package/lib/specs/apps.js

@@ -154,6 +154,8 @@ export const INBOX_TRIAGE_APP_0_0_1 = {
     tags: ['example', 'worker', 'mail'],
     icon: 'mail',
     emoji: '📬',
+    avatar: '',
+    banner: '',
     setup: [
         "The agent 'worker-mail-triage:0.0.1' is not enabled.",
         "The MCP server 'google-workspace:0.0.1' is not enabled.",
@@ -342,6 +344,8 @@ export const QUOTE_CALCULATOR_APP_0_0_1 = {
     tags: ['example', 'widget'],
     icon: 'number',
     emoji: '🧮',
+    avatar: '',
+    banner: '',
     setup: ["The agent 'jupyter-data-analyst:0.0.1' is not enabled."],
 };
 export const SHIP_OR_FIX_APP_0_0_1 = {
@@ -497,6 +501,8 @@ export const SHIP_OR_FIX_APP_0_0_1 = {
     tags: ['example', 'decision', 'benchmarks'],
     icon: 'checklist',
     emoji: '🚢',
+    avatar: '',
+    banner: '',
     setup: ["The agent 'jupyter-data-analyst:0.0.1' is not enabled."],
 };
 export const WEB_RESEARCH_APP_0_0_1 = {
@@ -603,6 +609,8 @@ export const WEB_RESEARCH_APP_0_0_1 = {
     tags: ['example', 'research'],
     icon: 'search',
     emoji: '🔎',
+    avatar: '',
+    banner: '',
     setup: [],
 };
 export const APP_CATALOGUE = {

package/lib/types/agentspecs.d.ts

@@ -524,6 +524,13 @@ export interface AppSpec {
     icon?: string;
     /** Its face: one emoji, shown wherever the application appears. */
     emoji: string;
+    /**
+     * Its avatar, by name: a drawing of the set people choose theirs from on
+     * their profile. Empty, its emoji stands for it.
+     */
+    avatar: string;
+    /** Its banner, by name, from the same profile's set. Empty, its id seeds one. */
+    banner: string;
 }
 export interface Agentspec {
     /** Unique agent identifier */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@datalayer/agent-runtimes",
-    "version": "1.3.17",
+    "version": "1.3.18",
     "type": "module",
     "workspaces": [
         ".",