@datalayer/agent-runtimes 1.3.75 → 1.3.79

package/lib/examples/AssistantExample.js

@@ -25,7 +25,7 @@ import { AssistantCharactersPlugin, assistantCharacterNamed, assistantCharacters
 import { OwlCharacterPlugin } from './utils/owlCharacterPlugin';
 import { readTestSpriteCharacter } from './utils/testSpriteCharacter';
 import { CLIPPY_JS_CHARACTERS, CLIPPY_JS_VERSION, readClippyJsCharacter, } from './utils/clippyJsCharacters';
-import { readAcsCharacter, readClippyCharacter, } from '../chat/assistant/formats';
+import { CHARACTER_FILES_ACCEPT, readCharacterFiles, } from '../chat/assistant/formats';
 /**
  * The agent-runtimes server the assistant talks to: `?agentRuntimesUrl=`
  * when given, else this machine's on port 8765. It serves the `assistant`
@@ -75,27 +75,6 @@ const CATALOGUE = assistantCharactersOf(reactor).map(entry => ({
     id: entry.id,
     name: entry.character.name,
 }));
-/**
- * A character file a person picked, read in the page (T-26): one `.acs`, or
- * a clippy.js character's `agent.js` and `map.png` (and its sounds file).
- */
-async function readPicked(files) {
-    const acs = files.find(file => file.name.toLowerCase().endsWith('.acs'));
-    if (acs) {
-        return readAcsCharacter(await acs.arrayBuffer());
-    }
-    const agentJs = files.find(file => file.name.toLowerCase() === 'agent.js');
-    const mapPng = files.find(file => /\.(png|gif|webp|jpe?g)$/i.test(file.name));
-    const soundsJs = files.find(file => /^sounds-.*\.js$/i.test(file.name));
-    if (!agentJs || !mapPng) {
-        throw new Error('Pick one .acs file, or a clippy.js character: its agent.js and its map image (and a sounds file if you have one).');
-    }
-    return readClippyCharacter({
-        agentJs: await agentJs.text(),
-        mapPng,
-        soundsJs: soundsJs ? await soundsJs.text() : undefined,
-    });
-}
 const AssistantExample = () => {
     const [character, setCharacter] = useState('paperclip');
     // A character chosen by id is the one its plugin contributes.
@@ -185,13 +164,13 @@ const AssistantExample = () => {
                                             onClick: () => setBalloon(balloon === 'history' ? 'current' : 'history') }), _jsx(Text, { "aria-live": "polite", "data-toggle-state": "", sx: { color: 'fg.muted' }, children: balloon === 'history' ? 'History' : 'Current' })] })] }), _jsxs(Box, { as: "section", sx: { mt: 4 }, children: [_jsx(Heading, { as: "h2", sx: { fontSize: 2, mb: 1 }, children: "The clippy.js characters" }), _jsxs(Text, { as: "p", sx: { color: 'fg.muted', mb: 2 }, children: ["Fetched when picked from the", ' ', _jsxs("code", { children: ["clippyjs@", CLIPPY_JS_VERSION] }), " package on jsDelivr and read as data by the same reader. They are not in this repository: clippy.js\u2019s licence covers its code only, and the characters are Microsoft\u2019s."] }), _jsx(Box, { sx: { display: 'flex', gap: 2, flexWrap: 'wrap' }, children: CLIPPY_JS_CHARACTERS.map(name => {
                                         const picked = clippyJs[name] !== undefined && character === clippyJs[name];
                                         return (_jsx(Button, { variant: picked ? 'primary' : 'default', onClick: () => void pickClippyJs(name), disabled: fetching !== undefined, "aria-pressed": picked, "data-assistant-character": `clippy-js-${name.toLowerCase()}`, children: fetching === name ? `${name}…` : name }, name));
-                                    }) })] }), _jsxs(Box, { as: "section", sx: { mt: 4 }, children: [_jsx(Heading, { as: "h2", sx: { fontSize: 2, mb: 1 }, children: "A character you bring" }), _jsxs(Text, { as: "p", sx: { color: 'fg.muted', mb: 2 }, children: ["The characters of Microsoft Office \u2014 Clippy, Merlin, Links and the others \u2014 are Microsoft\u2019s. Load only a character file you have the right to use: a Microsoft Agent ", _jsx("code", { children: ".acs" }), " file, or a clippy.js character\u2019s ", _jsx("code", { children: "agent.js" }), " and map image. It is read in this page and sent nowhere."] }), _jsx("input", { type: "file", multiple: true, accept: ".acs,.js,.png,.gif,.webp,.jpg,.jpeg", "aria-label": "Character files", onChange: async (event) => {
+                                    }) })] }), _jsxs(Box, { as: "section", sx: { mt: 4 }, children: [_jsx(Heading, { as: "h2", sx: { fontSize: 2, mb: 1 }, children: "A character you bring" }), _jsxs(Text, { as: "p", sx: { color: 'fg.muted', mb: 2 }, children: ["The characters of Microsoft Office \u2014 Clippy, Merlin, Links and the others \u2014 are Microsoft\u2019s. Load only a character file you have the right to use: a Microsoft Agent ", _jsx("code", { children: ".acs" }), " file, or a clippy.js character\u2019s ", _jsx("code", { children: "agent.js" }), " and map image. It is read in this page and sent nowhere."] }), _jsx("input", { type: "file", multiple: true, accept: CHARACTER_FILES_ACCEPT, "aria-label": "Character files", onChange: async (event) => {
                                         const files = Array.from(event.target.files ?? []);
                                         if (!files.length) {
                                             return;
                                         }
                                         try {
-                                            setCharacter(await readPicked(files));
+                                            setCharacter(await readCharacterFiles(files));
                                             setLoadError(undefined);
                                         }
                                         catch (error) {

package/lib/examples/AssistantGalleryExample.js

@@ -163,7 +163,8 @@ const AssistantGalleryExample = () => {
                     {
                         id: 'notebook',
                         role: 'assistant',
-                        text: SAMPLE_NOTEBOOK_SAYING,
+                        content: SAMPLE_NOTEBOOK_SAYING,
+                        createdAt: new Date(0),
                     },
                 ]
                 : []),

package/lib/examples/exampleGroups.d.ts

@@ -5,5 +5,5 @@
  *
  * @module examples/exampleGroups
  */
-export declare const EXAMPLE_GROUP_ORDER: readonly ["Apps", "A2UI", "A2A", "AG-UI", "Assistant", "Chat", "Document", "Notebook", "Capabilities", "Cell", "CopilotKit"];
+export declare const EXAMPLE_GROUP_ORDER: readonly ["Apps", "Assistant", "A2UI", "A2A", "AG-UI", "Chat", "Document", "Notebook", "Capabilities", "Cell", "CopilotKit"];
 export declare const getExampleGroup: (id: string) => string;

package/lib/examples/exampleGroups.js

@@ -11,10 +11,10 @@
  */
 export const EXAMPLE_GROUP_ORDER = [
     'Apps',
+    'Assistant',
     'A2UI',
     'A2A',
     'AG-UI',
-    'Assistant',
     'Chat',
     'Document',
     'Notebook',

package/lib/examples/utils/assistantGallery.d.ts

@@ -8,7 +8,8 @@
  */
 import type { AssistantStageProps } from '../../chat/assistant/AssistantStage';
 import { type BalloonToolLine, type ToolLinePhase } from '../../chat/assistant/toolLine';
-import { type AssistantState, type BalloonApproval, type BalloonHistoryMessage } from '../../chat/assistant/state';
+import { type AssistantState, type BalloonApproval } from '../../chat/assistant/state';
+import type { DisplayItem } from '../../types/chat';
 /** What the gallery poses a character in: a state, or stepped aside. */
 export type GalleryPose = AssistantState | 'aside';
 /** Every state, in the order an assistant lives them, then stepped aside. */
@@ -29,11 +30,11 @@ export declare function sampleSaying(index: number): {
     more: boolean;
 };
 /**
- * The conversation so far, after `count` sample exchanges (wrapping), as the
- * `history` balloon lists it: every message, the person's and the agent's,
- * read by `balloonHistoryOf` as the floating assistant reads the chat.
+ * The conversation so far, after `count` sample exchanges (wrapping), as
+ * the chat holds it — its messages and tool calls — which the `history`
+ * balloon draws with the chat's components.
  */
-export declare function sampleHistory(count: number): BalloonHistoryMessage[];
+export declare function sampleHistory(count: number): DisplayItem[];
 /** The tool the gallery calls (T-23): Odoo's, as Accounting calls it. */
 export declare const SAMPLE_TOOL = "list_invoices";
 /** The sample tool's line, at a phase: "Using list_invoices…", "Done: …", "… failed". */
@@ -133,7 +134,7 @@ export declare function balloonForPose(pose: GalleryPose, { saying, approval, to
     /** What goes with the words in a `current` balloon: a notebook. */
     attachment?: NonNullable<AssistantStageProps['balloon']>['attachment'];
     /** The conversation so far, listed in a `history` balloon. */
-    history?: readonly BalloonHistoryMessage[];
+    history?: readonly DisplayItem[];
     /** The large visual the attachment is the compact form of: expandable. */
     visual?: NonNullable<AssistantStageProps['balloon']>['visual'];
 }): AssistantStageProps['balloon'];

package/lib/examples/utils/assistantGallery.js

@@ -3,7 +3,7 @@
  * Distributed under the terms of the Modified BSD License.
  */
 import { toolLineText, } from '../../chat/assistant/toolLine';
-import { ASSISTANT_WORDS, balloonHistoryOf, latestSaying, } from '../../chat/assistant/state';
+import { ASSISTANT_WORDS, latestSaying, } from '../../chat/assistant/state';
 /** Every state, in the order an assistant lives them, then stepped aside. */
 export const GALLERY_POSES = [
     'idle',
@@ -75,20 +75,35 @@ export function sampleSaying(index) {
     return { text: saying.text, more: saying.more };
 }
 /**
- * The conversation so far, after `count` sample exchanges (wrapping), as the
- * `history` balloon lists it: every message, the person's and the agent's,
- * read by `balloonHistoryOf` as the floating assistant reads the chat.
+ * The conversation so far, after `count` sample exchanges (wrapping), as
+ * the chat holds it — its messages and tool calls — which the `history`
+ * balloon draws with the chat's components.
  */
 export function sampleHistory(count) {
     const items = [];
     for (let turn = 0; turn < count; turn += 1) {
         const conversation = SAMPLE_CONVERSATIONS[turn % SAMPLE_CONVERSATIONS.length];
-        for (const item of conversation) {
-            const message = item;
-            items.push({ ...message, id: `${turn}-${message.id}` });
+        for (const entry of conversation) {
+            const item = entry;
+            const id = `${turn}-${item.id}`;
+            items.push(item.toolName
+                ? {
+                    id,
+                    type: 'tool-call',
+                    toolCallId: id,
+                    toolName: item.toolName,
+                    args: {},
+                    status: 'complete',
+                }
+                : {
+                    id,
+                    role: item.role,
+                    content: item.content,
+                    createdAt: new Date(0),
+                });
         }
     }
-    return balloonHistoryOf(items);
+    return items;
 }
 /** The tool the gallery calls (T-23): Odoo's, as Accounting calls it. */
 export const SAMPLE_TOOL = 'list_invoices';

package/lib/jupyter/exec/Python.d.ts

@@ -1,4 +1,3 @@
-export declare function listVariables(): string;
 export declare function saveVariables(variables: string[]): string;
 export declare function loadVariables(variables: string): string;
 export declare function changeCurrentWorkingDirectory(path: string): string;

package/lib/jupyter/exec/Python.js

@@ -2,38 +2,6 @@
  * Copyright (c) 2025-2026 Datalayer, Inc.
  * Distributed under the terms of the Modified BSD License.
  */
-export function listVariables() {
-    return `
-def _list_variables():
-    import json
-    from types import BuiltinFunctionType, BuiltinMethodType, FunctionType, MethodType, MethodWrapperType, ModuleType, TracebackType
-
-    _FORBIDDEN_TYPES = [type, BuiltinFunctionType, BuiltinMethodType, FunctionType, MethodType, MethodWrapperType, ModuleType, TracebackType]
-    try:
-        from IPython.core.autocall import ExitAutocall
-        _FORBIDDEN_TYPES.append(ExitAutocall)
-    except ImportError:
-        pass
-    _exclude = tuple(_FORBIDDEN_TYPES)
-
-    _all = frozenset(globals())
-    _vars = {}
-    for _n in _all:
-        _v = globals()[_n]
-        
-        if not (
-            _n.startswith('_') or
-            isinstance(_v, _exclude) or
-            # Special IPython variables
-            (_n == 'In' and isinstance(_v, list)) or
-            (_n == 'Out' and isinstance(_v, dict))
-        ):
-            _vars[_n] = type(_v).__qualname__
-
-    return json.dumps(_vars)
-
-_list_variables()`;
-}
 export function saveVariables(variables) {
     return `
 def _pickle_variables():

package/lib/jupyter/exec/Snippets.d.ts

@@ -1,5 +1,9 @@
 /**
  * Runtime snippets.
+ *
+ * Listing a kernel's variables is not one of them: jupyter-react's
+ * `listKernelVariables` does it, with the one snippet every variables view
+ * shares.
  */
 export interface IRuntimeSnippets {
     /**
@@ -9,12 +13,6 @@ export interface IRuntimeSnippets {
      * @returns The code snippet
      */
     changeCurrentWorkingDirectory(path: string): string;
-    /**
-     * Code snippet to list the transferable kernel variables.
-     *
-     * @returns The code snippet
-     */
-    listVariables(): string;
     /**
      * Code snippet to load kernel variables.
      *
@@ -75,12 +73,6 @@ export declare class RuntimeSnippetsFacade {
      * @returns The code snippet
      */
     changeCurrentWorkingDirectory(path: string): string;
-    /**
-     * Code snippet to list the transferable kernel variables.
-     *
-     * @returns The code snippet
-     */
-    listVariables(): string;
     /**
      * Code snippet to load kernel variables.
      *

package/lib/jupyter/exec/Snippets.js

@@ -56,14 +56,6 @@ export class RuntimeSnippetsFacade {
             .get(this.language)
             .changeCurrentWorkingDirectory(path);
     }
-    /**
-     * Code snippet to list the transferable kernel variables.
-     *
-     * @returns The code snippet
-     */
-    listVariables() {
-        return RuntimeSnippetsFacade.$language.get(this.language).listVariables();
-    }
     /**
      * Code snippet to load kernel variables.
      *

package/lib/loop/apps/AppFeedback.js

@@ -55,7 +55,9 @@ export function AppFeedback({ app, workspace, }) {
             flexDirection: 'column',
             gap: 4,
             padding: '4px 8px',
-        }, children: [_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 4 }, children: [_jsx(Text, { sx: { fontSize: 0, color: 'fg.muted' }, children: FEEDBACK_WORDS.ask }), _jsx(IconButton, { size: "small", variant: choice === true ? 'primary' : 'invisible', icon: ThumbsupIcon, "aria-label": FEEDBACK_WORDS.liked, "aria-pressed": choice === true, onClick: () => setLiked({ turn: turn.id, liked: true }) }), _jsx(IconButton, { size: "small", variant: choice === false ? 'danger' : 'invisible', icon: ThumbsdownIcon, "aria-label": FEEDBACK_WORDS.disliked, "aria-pressed": choice === false, onClick: () => setLiked({ turn: turn.id, liked: false }) })] }), choice !== null ? (_jsxs(_Fragment, { children: [_jsx(Textarea, { "aria-label": FEEDBACK_WORDS.comment, placeholder: FEEDBACK_WORDS.comment, value: comment, rows: 2, resize: "vertical", block: true, onChange: event => setComment(event.target.value) }), _jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 8 }, children: [_jsx(Button, { size: "small", variant: "primary", disabled: done?.state === 'sending', onClick: () => void send(), children: FEEDBACK_WORDS.send }), _jsx(Text, { sx: { fontSize: 0, color: 'fg.muted' }, children: FEEDBACK_WORDS.where(app.name) })] })] })) : null, done?.state === 'refused' ? (_jsx(Text, { sx: { fontSize: 0, color: 'danger.fg' }, children: done.says })) : null] }));
+        }, children: [_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 4 }, children: [_jsx(Text, { sx: { fontSize: 0, color: 'fg.muted' }, children: FEEDBACK_WORDS.ask }), _jsx(IconButton, { size: "small", variant: choice === true ? 'default' : 'invisible', icon: ThumbsupIcon, "aria-label": FEEDBACK_WORDS.liked, "aria-pressed": choice === true, onClick: () => setLiked({ turn: turn.id, liked: true }) }), _jsx(IconButton, { size: "small", variant: choice === false ? 'default' : 'invisible', icon: ThumbsdownIcon, "aria-label": FEEDBACK_WORDS.disliked, "aria-pressed": choice === false, onClick: () => setLiked({ turn: turn.id, liked: false }) })] }), choice !== null ? (_jsxs(_Fragment, { children: [_jsx(Textarea, { "aria-label": FEEDBACK_WORDS.comment, placeholder: FEEDBACK_WORDS.comment, value: comment, rows: 2, resize: "vertical", block: true, onChange: event => setComment(event.target.value) }), _jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: 8 }, children: [_jsx(Button, { size: "small", variant: "default", disabled: done?.state === 'sending', onClick: () => void send(), children: FEEDBACK_WORDS.send }), _jsx(Text, { sx: { fontSize: 0, color: 'fg.muted' }, children: FEEDBACK_WORDS.where(app.name) })] })] })) : null, done?.state === 'refused' ? (
+            // Said in the ink, as an alert: not a verdict, so not its colour.
+            _jsx(Text, { role: "alert", sx: { fontSize: 0, color: 'fg.default' }, children: done.says })) : null] }));
 }
 /**
  * The plugin, for one application: the strip above its prompt. Made once per

package/lib/loop/apps/AppKept.d.ts

@@ -0,0 +1,22 @@
+/**
+ * What a hosted or embedded application keeps, said under its prompt before
+ * the first message (LOOP R-31) — in every layout, since the composer draws
+ * what is hung on `LoopPromptPanel` wherever it stands. Gone once a message
+ * is sent: what it keeps was said before anything was.
+ *
+ * `AppRenderer` adds the plugin for an application that runs as a
+ * deployment — at its address, embedded — not for its builder's Preview.
+ *
+ * @module loop/apps/AppKept
+ */
+import type { JSX } from 'react';
+import type { AppSpec } from '../../types/agentspecs';
+export declare const APP_KEPT_PLUGIN_NAME = "@datalayer/loop-plugin-app-kept";
+export declare function AppKept({ says }: {
+    says: string;
+}): JSX.Element | null;
+/**
+ * The plugin, for one application: what it keeps, under its prompt. Made
+ * once per application and sentence — a new plugin rebuilds the workspace.
+ */
+export declare function defineAppKeptPlugin(app: Pick<AppSpec, 'id' | 'name'>, says: string): import("@datalayer/reactor").ReactorPlugin<Record<string, never>, unknown, unknown>;

package/lib/loop/apps/AppKept.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Text } from '@primer/react';
+import { contribution, definePlugin, signal } from '@datalayer/reactor';
+import { useContributions, useSignalValue } from '@datalayer/reactor/react';
+import { LoopChatTurn, LoopPromptPanel } from '../core';
+import { beforeFirstMessage } from './kept';
+export const APP_KEPT_PLUGIN_NAME = '@datalayer/loop-plugin-app-kept';
+/* A signal to read when no chat contributed a turn: the hook needs one. */
+const NO_TURN = signal({ id: 0, status: 'idle' });
+export function AppKept({ says }) {
+    const turns = useContributions(LoopChatTurn);
+    const turn = useSignalValue(turns[0]?.value.turn ?? NO_TURN);
+    if (!beforeFirstMessage(turn)) {
+        return null;
+    }
+    return (_jsx("div", { role: "note", style: { padding: '4px 8px' }, children: _jsx(Text, { sx: { fontSize: 0, color: 'fg.muted' }, children: says }) }));
+}
+/**
+ * The plugin, for one application: what it keeps, under its prompt. Made
+ * once per application and sentence — a new plugin rebuilds the workspace.
+ */
+export function defineAppKeptPlugin(app, says) {
+    function Panel() {
+        return _jsx(AppKept, { says: says });
+    }
+    return definePlugin({
+        name: `${APP_KEPT_PLUGIN_NAME}-${app.id}`,
+        displayName: `${app.name}: what it keeps`,
+        description: `What ${app.name} keeps of a conversation, and for how long, said before the first message.`,
+        octicon: 'archive',
+        emoji: '\u{1F5C4}',
+        contributes: [
+            contribution(LoopPromptPanel, { id: 'app-kept', placement: 'below', order: 30, Component: Panel }, { id: 'app-kept' }),
+        ],
+    });
+}

package/lib/loop/apps/AppRenderer.d.ts

@@ -157,7 +157,9 @@ export type AppPreset = {
  *   its page (`app-page`) when it has one, with the Canvas's block plugins
  *   but those of the UI plugins its organization turned off (`pluginsOff`),
  *   whose contributions are the blocks it may draw (R-01b); a thumb and a
- *   comment on each answer when its record keeps feedback (V-18); with
+ *   comment on each answer when its record keeps feedback (V-18); what it
+ *   keeps and for how long, under its prompt before the first message, when
+ *   `kept` says it (R-31); with
  *   `sidebar`, its rules and approvals card, its activity feed and its
  *   computer (R-01b, R-23);
  *   laid out as `interface.layout` says;
@@ -174,6 +176,14 @@ export declare function appPreset(app: AppSpec, options?: {
     sidebar?: boolean;
     /** What its record is kept under: its activity's. */
     appUid?: string;
+    /**
+     * Say what it keeps before the first message (R-31): at its address and
+     * embedded, not in its builder's Preview — to a `visitor` not signed
+     * in, that nothing is kept (R-30).
+     */
+    kept?: {
+        visitor: boolean;
+    };
 }): AppPreset;
 /**
  * What an application's agent is created with on a Datalayer runtime: under

package/lib/loop/apps/AppRenderer.js

@@ -55,7 +55,9 @@ import { defineAppActivityPlugin } from '../plugins/app-activity';
 import { defineAppComputerPlugin } from '../plugins/app-computer';
 import { defineAppRulesPlugin } from '../plugins/app-rules';
 import { defineAppFeedbackPlugin } from './AppFeedback';
+import { defineAppKeptPlugin } from './AppKept';
 import { keepsFeedback } from './feedback';
+import { keptBeforeFirstMessage } from './kept';
 /** The id of an agent or a Cog, without its version. */
 export const agentIdOf = (app) => {
     const reference = app.agent || app.team;
@@ -144,7 +146,9 @@ export function appLayoutOptions(app) {
  *   its page (`app-page`) when it has one, with the Canvas's block plugins
  *   but those of the UI plugins its organization turned off (`pluginsOff`),
  *   whose contributions are the blocks it may draw (R-01b); a thumb and a
- *   comment on each answer when its record keeps feedback (V-18); with
+ *   comment on each answer when its record keeps feedback (V-18); what it
+ *   keeps and for how long, under its prompt before the first message, when
+ *   `kept` says it (R-31); with
  *   `sidebar`, its rules and approvals card, its activity feed and its
  *   computer (R-01b, R-23);
  *   laid out as `interface.layout` says;
@@ -179,6 +183,10 @@ export function appPreset(app, options = {}) {
             // A thumb and a comment on each answer, kept in its record (LOOP
             // V-18): only for an application whose record keeps feedback.
             ...(keepsFeedback(app) ? [defineAppFeedbackPlugin(app)] : []),
+            // What it keeps, and for how long, before anything is said (R-31).
+            ...(options.kept
+                ? [defineAppKeptPlugin(app, keptBeforeFirstMessage(app, options.kept))]
+                : []),
             // What its builder reads beside its page (R-01b): its rules and the
             // approvals waiting, and what it did.
             ...(options.sidebar
@@ -261,6 +269,13 @@ export function AppRenderer({ app, plugins = NO_PLUGINS, instance, onPresence, o
      */
     const source = JSON.stringify(dumpAppspec(app));
     const off = [...(pluginsOff ?? [])].sort().join(',');
+    /*
+     * What it keeps, said before the first message (R-31): run as a
+     * deployment — at its address, embedded — and not in its builder's
+     * Preview; to a visitor not signed in, that nothing is kept (R-30).
+     */
+    const deployed = Boolean(instance?.deploymentUid);
+    const visitor = Boolean(embed.datalayerVisitors);
     const preset = useMemo(() => {
         try {
             return appPreset(app, {
@@ -268,6 +283,7 @@ export function AppRenderer({ app, plugins = NO_PLUGINS, instance, onPresence, o
                 pluginsOff,
                 sidebar,
                 appUid: instance?.appUid,
+                ...(deployed ? { kept: { visitor } } : {}),
             });
         }
         catch (error) {
@@ -277,7 +293,7 @@ export function AppRenderer({ app, plugins = NO_PLUGINS, instance, onPresence, o
         }
     }, 
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    [source, page, off, sidebar, instance?.appUid]);
+    [source, page, off, sidebar, instance?.appUid, deployed, visitor]);
     const allPlugins = useMemo(() => ('problem' in preset ? plugins : [...preset.plugins, ...plugins]), [preset, plugins]);
     /*
      * On Datalayer, the application runs on a runtime: allocated with a plain
@@ -312,7 +328,9 @@ export function AppRenderer({ app, plugins = NO_PLUGINS, instance, onPresence, o
             ? {
                 frameTitle: [app.emoji, app.name].filter(Boolean).join(' '),
             }
-            : {}), teamPicker: false, showAgentVariants: false, graph: false, pluginsPanel: false, datalayerAgentSpecId: DATALAYER_BOOTSTRAP_AGENTSPEC, 
+            : {}), 
+        // Its rules, activity and computer on a rail, one at a time (T-07).
+        sidebarRail: sidebar, teamPicker: false, showAgentVariants: false, graph: false, pluginsPanel: false, datalayerAgentSpecId: DATALAYER_BOOTSTRAP_AGENTSPEC, 
         // Where an application runs is decided by its host — the Studio's
         // Preview, the hosted page — not offered to its user.
         targetFixed: true, 

package/lib/loop/apps/checks.d.ts

@@ -15,6 +15,13 @@ export interface AppCheck {
  */
 export declare const componentNamed: (name: string) => ComponentSpec | undefined;
 /** How an organization's own context is named: never a catalogue id (agentspecs' `ORGANIZATION_FRAME_PREFIX`). */
+/**
+ * What stops a Form block from asking (LOOP C-16), in agentspecs'
+ * `form_problems` sentences: its schema is an object of named fields, each
+ * required one among them, so that the page draws it and the runtime checks
+ * what it receives against the same schema.
+ */
+export declare function formProblems(node: Record<string, unknown>): string[];
 export declare const ORGANIZATION_FRAME_PREFIX = "org-";
 /** Whether a reference names an organization's own context rather than the catalogue's (LOOP U-32). */
 export declare const isOrganizationFrame: (ref: string) => boolean;

package/lib/loop/apps/checks.js

@@ -135,6 +135,42 @@ function shapeProblems(app) {
     return problems;
 }
 /** How an organization's own context is named: never a catalogue id (agentspecs' `ORGANIZATION_FRAME_PREFIX`). */
+/**
+ * What stops a Form block from asking (LOOP C-16), in agentspecs'
+ * `form_problems` sentences: its schema is an object of named fields, each
+ * required one among them, so that the page draws it and the runtime checks
+ * what it receives against the same schema.
+ */
+export function formProblems(node) {
+    const said = `The form “${String(node.id)}”`;
+    const schema = node.schema;
+    if (!isPlainRecord(schema)) {
+        return [
+            `${said} has no fields: its schema is the JSON Schema of what it asks.`,
+        ];
+    }
+    const fields = schema.properties;
+    if (schema.type !== 'object' ||
+        !isPlainRecord(fields) ||
+        Object.keys(fields).length === 0) {
+        return [
+            `${said} asks for no named field: its schema is an object with properties.`,
+        ];
+    }
+    const problems = [];
+    for (const [name, field] of Object.entries(fields)) {
+        if (!isPlainRecord(field)) {
+            problems.push(`${said}'s field “${name}” is not a schema.`);
+        }
+    }
+    const required = Array.isArray(schema.required) ? schema.required : [];
+    const missing = required.filter(name => !(String(name) in fields));
+    if (missing.length > 0) {
+        problems.push(`${said} requires ${missing.map(name => `“${String(name)}”`).join(', ')}, which it does not ask.`);
+    }
+    return problems;
+}
+const isPlainRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 export const ORGANIZATION_FRAME_PREFIX = 'org-';
 /** Whether a reference names an organization's own context rather than the catalogue's (LOOP U-32). */
 export const isOrganizationFrame = (ref) => idOf(ref).startsWith(ORGANIZATION_FRAME_PREFIX);
@@ -208,6 +244,9 @@ function referenceProblems(app, organizationFrames) {
         if (!componentNamed(String(node.component))) {
             problems.push(`The surface's “${String(node.id)}” is a “${String(node.component)}”, which the catalog does not have.`);
         }
+        else if (node.component === 'Form') {
+            problems.push(...formProblems(node));
+        }
     }
     const decider = app.decision?.decisionModel;
     if (decider) {

package/lib/loop/apps/index.d.ts

@@ -5,11 +5,14 @@
  */
 export * from './agent';
 export * from './AppFeedback';
+export * from './AppKept';
 export * from './AppRenderer';
 export * from './appspec';
 export * from './checks';
 export * from './computer';
 export * from './feedback';
+export * from './kept';
 export * from './records';
 export * from './rules';
+export * from './saved';
 export * from './yaml';

package/lib/loop/apps/index.js

@@ -9,11 +9,14 @@
  */
 export * from './agent';
 export * from './AppFeedback';
+export * from './AppKept';
 export * from './AppRenderer';
 export * from './appspec';
 export * from './checks';
 export * from './computer';
 export * from './feedback';
+export * from './kept';
 export * from './records';
 export * from './rules';
+export * from './saved';
 export * from './yaml';

package/lib/loop/apps/kept.d.ts

@@ -0,0 +1,30 @@
+/**
+ * What an application keeps, said before the first message (LOOP R-31).
+ *
+ * A hosted or embedded application tells whoever uses it what its record
+ * keeps of the conversation — what its `record.include` names — and for how
+ * long — its `record.keep_for` — before they write anything. A session's
+ * start is kept whatever `include` says, so an application that keeps
+ * nothing else says that the conversation took place is kept. A visitor not
+ * signed in has nothing kept (R-30), and is told so.
+ *
+ * Pure: no React.
+ *
+ * @module loop/apps/kept
+ */
+import type { AppSpec } from '../../types/agentspecs';
+import type { ChatTurnSnapshot } from '../core';
+/** What each item of `record.include` keeps, in a person's words. */
+export declare const KEPT_ITEMS: Record<string, string>;
+/** A retention in words: `30_days` → "30 days", `1_years` → "a year". */
+export declare function keptForWords(keepFor: string): string;
+/**
+ * What an application says it keeps, before the first message.
+ *
+ * `visitor`: the person is not signed in, and nothing of theirs is kept.
+ */
+export declare function keptBeforeFirstMessage(app: Pick<AppSpec, 'name' | 'record'>, { visitor }?: {
+    visitor?: boolean;
+}): string;
+/** Whether it is still before the first message: what it keeps is said then only. */
+export declare const beforeFirstMessage: (turn: ChatTurnSnapshot) => boolean;

package/lib/loop/apps/kept.js

@@ -0,0 +1,52 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/** What each item of `record.include` keeps, in a person's words. */
+export const KEPT_ITEMS = {
+    conversations: 'this conversation',
+    actions: 'what it does',
+    decisions: 'how its rules decided',
+    approvals: 'what is approved',
+    checks: 'what its checks stopped',
+    outputs: 'its answers',
+    feedback: 'what you say of its answers',
+};
+const RETENTION = /^([1-9]\d*)_(day|days|month|months|year|years)$/;
+/** A retention in words: `30_days` → "30 days", `1_years` → "a year". */
+export function keptForWords(keepFor) {
+    const matched = RETENTION.exec(keepFor.trim());
+    if (!matched) {
+        throw new Error(`Cannot read the retention \`${keepFor}\`: write 90_days, 18_months or 1_years.`);
+    }
+    const count = Number(matched[1]);
+    const unit = matched[2].replace(/s$/, '');
+    return count === 1 ? `a ${unit}` : `${count} ${unit}s`;
+}
+/** A list in words: "a", "a and b", "a, b and c". */
+function inWords(items) {
+    return items.length < 2
+        ? (items[0] ?? '')
+        : `${items.slice(0, -1).join(', ')} and ${items[items.length - 1]}`;
+}
+/**
+ * What an application says it keeps, before the first message.
+ *
+ * `visitor`: the person is not signed in, and nothing of theirs is kept.
+ */
+export function keptBeforeFirstMessage(app, { visitor = false } = {}) {
+    if (visitor) {
+        return 'Nothing of this conversation is kept: you are not signed in.';
+    }
+    const name = app.name || 'This application';
+    const days = keptForWords(app.record.keepFor);
+    const kept = app.record.include
+        .map(item => KEPT_ITEMS[item])
+        .filter((words) => Boolean(words));
+    if (!kept.length) {
+        return `${name} keeps only that this conversation took place, for ${days}.`;
+    }
+    return `${name} keeps ${inWords(kept)} for ${days}, then deletes it.`;
+}
+/** Whether it is still before the first message: what it keeps is said then only. */
+export const beforeFirstMessage = (turn) => turn.id === 0 && !turn.user;