@datalayer/agent-runtimes 1.3.27 → 1.3.29

package/lib/specs/appspecSchema.js

@@ -311,6 +311,18 @@ export const APPSPEC_SCHEMA = {
                     default: null,
                     description: 'The component tree, when there is one',
                 },
+                assistant: {
+                    anyOf: [
+                        {
+                            $ref: '#/$defs/AssistantCharacter',
+                        },
+                        {
+                            type: 'null',
+                        },
+                    ],
+                    default: null,
+                    description: 'The character its floating assistant shows: `paperclip`, `wizard`, `cat` or `eyes`. The paper clip when unsaid; a person may choose another in their settings',
+                },
             },
             title: 'AppInterface',
             type: 'object',
@@ -659,6 +671,12 @@ export const APPSPEC_SCHEMA = {
             title: 'AppTrigger',
             type: 'object',
         },
+        AssistantCharacter: {
+            description: "The character an application's floating assistant shows (LOOP T-24):\none of those a UI plugin contributes. Datalayer's are these four.",
+            enum: ['paperclip', 'wizard', 'cat', 'eyes'],
+            title: 'AssistantCharacter',
+            type: 'string',
+        },
         Behaviour: {
             description: 'What an application does when it meets an action: the four a person chooses from.',
             enum: ['do_it', 'if_asked', 'ask_first', 'leave_to_me'],
@@ -673,7 +691,7 @@ export const APPSPEC_SCHEMA = {
         },
         EmbedMode: {
             description: "How an application sits in another product's page.",
-            enum: ['inline', 'bubble', 'panel'],
+            enum: ['inline', 'bubble', 'panel', 'assistant'],
             title: 'EmbedMode',
             type: 'string',
         },
@@ -684,7 +702,7 @@ export const APPSPEC_SCHEMA = {
                 mode: {
                     $ref: '#/$defs/EmbedMode',
                     default: 'inline',
-                    description: '`inline`, `bubble` or `panel`',
+                    description: '`inline`, `bubble`, `panel` or `assistant`',
                 },
                 origins: {
                     description: 'The origins allowed to embed it',

package/lib/types/agentspecs.d.ts

@@ -377,6 +377,13 @@ export type AppBehaviour = 'do_it' | 'if_asked' | 'ask_first' | 'leave_to_me';
 export type AppLayout = 'chat' | 'page' | 'split';
 /** The one colour of an application; everything else is neutral. */
 export type AppAccent = 'green' | 'rose' | 'sky' | 'lime' | 'sun' | 'violet';
+/**
+ * The character an application's floating assistant shows (LOOP T-24): one of
+ * those Datalayer's plugin contributes.
+ */
+export type AppAssistantCharacter = 'paperclip' | 'wizard' | 'cat' | 'eyes';
+/** How an application sits in another product's page (LOOP D-07). */
+export type AppEmbedMode = 'inline' | 'bubble' | 'panel' | 'assistant';
 /** Something an application reaches. */
 export interface AppConnectionSpec {
     /** An MCP server, `id` or `id:version`. */
@@ -443,6 +450,8 @@ export interface AppInterfaceSpec {
     /** The components of the catalog the surface may use. */
     components: string[];
     surface?: AppSurfaceSpec;
+    /** The character its floating assistant shows; the paper clip when unsaid. */
+    assistant?: AppAssistantCharacter;
 }
 export interface AppTestCaseSpec {
     ask: string;
@@ -474,7 +483,7 @@ export interface AppDeploymentSpec {
         slug: string;
     };
     embedded?: {
-        mode: 'inline' | 'bubble' | 'panel';
+        mode: AppEmbedMode;
         origins: string[];
     };
 }

package/lib/types/chat.d.ts

@@ -66,7 +66,7 @@ export interface ToolCallCompleteContext {
  * - 'floating-draggable': The popup with a handle, movable anywhere in the viewport
  * - 'sidebar': Docked sidebar panel — offered only where the host has a mount point for it
  */
-export type ChatViewMode = 'floating' | 'floating-small' | 'floating-draggable' | 'sidebar';
+export type ChatViewMode = 'floating' | 'floating-small' | 'floating-draggable' | 'assistant' | 'sidebar';
 /**
  * Companion "ephemeral surface" shown next to the chat.
  * - 'none': chat only, no companion surface

package/package.json

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