@datalayer/agent-runtimes 1.3.75 → 1.3.79

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

@@ -11,7 +11,11 @@
 /** What a record entry is. */
 export type RecordKind = 'session' | 'tool_call' | 'decision' | 'check' | 'approval' | 'output' | 'feedback'
 /** A turn of a conversation: what was asked, what it answered. */
- | 'turn';
+ | 'turn'
+/** A run began: what Activity reads as in progress until it answers (R-15). */
+ | 'run'
+/** What one of its channels was sent, or why not (R-37). */
+ | 'notification';
 /** One entry of an application's record. */
 export type RecordEntry = {
     uid: string;
@@ -36,7 +40,11 @@ export declare const RECORD_KIND_WORDS: Record<RecordKind, string>;
 export declare function entryOf(raw: Record<string, unknown>): RecordEntry;
 /** A session in a sentence: how many calls, what stopped it, how it ended. */
 export declare function sessionSentence(entries: readonly RecordEntry[]): string;
-/** The sessions of an application, newest first: their opening entries. */
-export declare function listSessions(context: RecordsContext, appUid: string, limit?: number): Promise<RecordEntry[]>;
-/** What one session did, in order. */
+/**
+ * The sessions of an application, newest first: their opening entries. Real
+ * use only — the sessions its tests ran are read apart (R-07) — unless
+ * `tests` says otherwise: `true` for the tests only, `null` for both.
+ */
+export declare function listSessions(context: RecordsContext, appUid: string, limit?: number, tests?: boolean | null): Promise<RecordEntry[]>;
+/** What one session did, in order: a run's start is a mark, not a step (R-15). */
 export declare function readSession(context: RecordsContext, sessionUid: string): Promise<RecordEntry[]>;

package/lib/loop/apps/records.js

@@ -12,6 +12,8 @@ export const RECORD_KIND_WORDS = {
     output: 'Answer',
     feedback: 'Feedback',
     turn: 'Turn',
+    run: 'Working',
+    notification: 'Notification',
 };
 /** An entry as ai-agents answers with it. */
 export function entryOf(raw) {
@@ -65,17 +67,23 @@ async function read(context, path, failure) {
     }
     return body;
 }
-/** The sessions of an application, newest first: their opening entries. */
-export async function listSessions(context, appUid, limit = 20) {
-    const body = await read(context, `/sessions?app_uid=${encodeURIComponent(appUid)}&limit=${limit}`, 'The sessions could not be read');
+/**
+ * The sessions of an application, newest first: their opening entries. Real
+ * use only — the sessions its tests ran are read apart (R-07) — unless
+ * `tests` says otherwise: `true` for the tests only, `null` for both.
+ */
+export async function listSessions(context, appUid, limit = 20, tests = false) {
+    const body = await read(context, `/sessions?app_uid=${encodeURIComponent(appUid)}&limit=${limit}${tests === null ? '' : `&tests=${tests}`}`, 'The sessions could not be read');
     return Array.isArray(body.sessions)
         ? body.sessions.map(entryOf)
         : [];
 }
-/** What one session did, in order. */
+/** What one session did, in order: a run's start is a mark, not a step (R-15). */
 export async function readSession(context, sessionUid) {
     const body = await read(context, `/records?session_uid=${encodeURIComponent(sessionUid)}&limit=500`, 'The session could not be read');
     return Array.isArray(body.entries)
-        ? body.entries.map(entryOf)
+        ? body.entries
+            .map(entryOf)
+            .filter(entry => entry.kind !== 'run')
         : [];
 }

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

@@ -0,0 +1,30 @@
+/**
+ * Approve and save (LOOP R-24): what an application wants to keep, shown
+ * before it is kept. The runtime asks every `save_to_space` call on the
+ * approvals path with the title and the whole text; an approvals card shows
+ * them, with *Approve and save* and *Decline* in place of *Approve* and
+ * *Reject*.
+ *
+ * Pure: no React.
+ *
+ * @module loop/apps/saved
+ */
+/** The runtime's tool that saves a result as a page of a Space. */
+export declare const SAVE_TOOL = "save_to_space";
+/** What an approvals card says of a result to keep. */
+export declare const SAVE_WORDS: {
+    readonly approve: "Approve and save";
+    readonly decline: "Decline";
+    readonly where: (space: string) => string;
+};
+/** The result an approval asks to save: its title, its text, its Space. */
+export type Draft = {
+    title: string;
+    content: string;
+    space: string;
+};
+/** The draft an approval carries, or null for any other approval. */
+export declare function draftOfApproval(approval: {
+    tool_name: string;
+    tool_args?: Record<string, unknown>;
+}): Draft | null;

package/lib/loop/apps/saved.js

@@ -0,0 +1,40 @@
+/*
+ * Copyright (c) 2025-2026 Datalayer, Inc.
+ * Distributed under the terms of the Modified BSD License.
+ */
+/**
+ * Approve and save (LOOP R-24): what an application wants to keep, shown
+ * before it is kept. The runtime asks every `save_to_space` call on the
+ * approvals path with the title and the whole text; an approvals card shows
+ * them, with *Approve and save* and *Decline* in place of *Approve* and
+ * *Reject*.
+ *
+ * Pure: no React.
+ *
+ * @module loop/apps/saved
+ */
+/** The runtime's tool that saves a result as a page of a Space. */
+export const SAVE_TOOL = 'save_to_space';
+/** What an approvals card says of a result to keep. */
+export const SAVE_WORDS = {
+    approve: 'Approve and save',
+    decline: 'Decline',
+    where: (space) => space
+        ? `To keep as a page of ${space}:`
+        : 'To keep as a page of its Space:',
+};
+/** The draft an approval carries, or null for any other approval. */
+export function draftOfApproval(approval) {
+    if (approval.tool_name !== SAVE_TOOL) {
+        return null;
+    }
+    const said = (key) => {
+        const value = approval.tool_args?.[key];
+        return typeof value === 'string' ? value : '';
+    };
+    return {
+        title: said('title'),
+        content: said('content'),
+        space: said('space'),
+    };
+}

package/lib/loop/embed/AppEmbed.d.ts

@@ -23,6 +23,13 @@ export type AppEmbedProps = {
     serverUrl?: string;
     /** What its record is kept under, on Datalayer. */
     instance?: AppInstance;
+    /**
+     * The embed token the host's server was issued for this visit (LOOP R-20):
+     * what the chat speaks to the application's session with on the
+     * agent-runtimes server that runs its deployment (`serverUrl`). It runs a
+     * session of that deployment, and reaches nothing else.
+     */
+    embedToken?: string;
     /** Height of an inline application. */
     height?: number | string;
     /**
@@ -55,5 +62,5 @@ export declare function EmbedThemed({ accent, colorMode, font, children, style,
     children: ReactNode;
     style?: CSSProperties;
 }): JSX.Element;
-export declare function AppEmbed({ app, mode, accent, colorMode, font, serverUrl, instance, height, ownPortal, plugins, }: AppEmbedProps): JSX.Element;
+export declare function AppEmbed({ app, mode, accent, colorMode, font, serverUrl, instance, embedToken, height, ownPortal, plugins, }: AppEmbedProps): JSX.Element;
 export default AppEmbed;

package/lib/loop/embed/AppEmbed.js

@@ -72,7 +72,7 @@ function Face({ emoji }) {
  * The workspace tells the chrome what the application is doing and what it
  * last said (`onPresence`, `onSaying`).
  */
-function FloatingApp({ app, view, colorMode, themeOverrides, character, serverUrl, instance, }) {
+function FloatingApp({ app, view, colorMode, themeOverrides, character, serverUrl, instance, embedToken, }) {
     const [presence, setPresence] = useState('idle');
     const [said, setSaid] = useState({ answering: false });
     const welcome = app.interface.welcome || app.description;
@@ -83,7 +83,7 @@ function FloatingApp({ app, view, colorMode, themeOverrides, character, serverUr
     return (_jsx(ChatFloating, { defaultViewMode: view, ...(character ? { assistantCharacter: character } : {}), ...(app.interface.balloon
             ? { balloonDisplay: app.interface.balloon }
             : {}), title: app.name, description: welcome, brandIcon: _jsx(Face, { emoji: app.emoji }), buttonIcon: _jsx(Face, { emoji: app.emoji }), buttonTooltip: `Talk to ${app.name}`, colorMode: colorMode, useStore: false, conversation: {
-            body: signedOut ? (_jsx(Text, { as: "p", role: "status", sx: { p: 3, m: 0, fontSize: 1 }, children: signedOutSentence(app) })) : (_jsx(AppRenderer, { app: app, target: serverUrl ? 'local' : 'datalayer', ...(serverUrl ? { serverUrl } : {}), instance: instance, 
+            body: signedOut ? (_jsx(Text, { as: "p", role: "status", sx: { p: 3, m: 0, fontSize: 1 }, children: signedOutSentence(app) })) : (_jsx(AppRenderer, { app: app, target: serverUrl ? 'local' : 'datalayer', ...(serverUrl ? { serverUrl } : {}), ...(serverUrl && embedToken ? { embedToken } : {}), instance: instance, 
                 // The host's accent and face over the application's own, inside
                 // its conversation too, in the embed's mode.
                 themeOverrides: themeOverrides, colorMode: colorMode, 
@@ -139,7 +139,7 @@ export function EmbedThemed({ accent, colorMode, font, children, style, }) {
      */
     _jsx("div", { "data-color-mode": colorMode, style: { display: 'contents' }, children: _jsx(DatalayerThemeProvider, { colorMode: colorMode, theme: loopTheme, themeStyles: themeStyles, baseStyles: style, children: children }) }));
 }
-export function AppEmbed({ app, mode, accent, colorMode = 'auto', font, serverUrl, instance, height = 640, ownPortal = false, plugins = NO_PLUGINS, }) {
+export function AppEmbed({ app, mode, accent, colorMode = 'auto', font, serverUrl, instance, embedToken, height = 640, ownPortal = false, plugins = NO_PLUGINS, }) {
     const system = useSystemMode();
     const resolvedMode = colorMode === 'auto' ? system : colorMode;
     const shownAs = mode ?? app.deployment.embedded?.mode ?? 'inline';
@@ -157,7 +157,7 @@ export function AppEmbed({ app, mode, accent, colorMode = 'auto', font, serverUr
     return (_jsxs(EmbedThemed, { accent: worn, colorMode: resolvedMode, font: font, style: view
             ? // Floating: nothing in the page's flow, nothing painted behind.
                 { backgroundColor: 'transparent' }
-            : { height, display: 'flex', flexDirection: 'column' }, children: [ownPortal ? _jsx(OwnPortalRoot, {}) : null, view ? (_jsx(FloatingApp, { app: app, view: view, serverUrl: serverUrl, instance: instance, colorMode: resolvedMode, themeOverrides: themeOverrides, character: character })) : (_jsx(AppRenderer, { app: app, target: serverUrl ? 'local' : 'datalayer', ...(serverUrl ? { serverUrl } : {}), instance: instance, 
+            : { height, display: 'flex', flexDirection: 'column' }, children: [ownPortal ? _jsx(OwnPortalRoot, {}) : null, view ? (_jsx(FloatingApp, { app: app, view: view, serverUrl: serverUrl, instance: instance, embedToken: embedToken, colorMode: resolvedMode, themeOverrides: themeOverrides, character: character })) : (_jsx(AppRenderer, { app: app, target: serverUrl ? 'local' : 'datalayer', ...(serverUrl ? { serverUrl } : {}), ...(serverUrl && embedToken ? { embedToken } : {}), instance: instance, 
                 // The host's accent and face over the application's own, inside
                 // its conversation too, in the embed's mode: the host's or its
                 // visitor's system's, not a Datalayer setting.

package/lib/loop/embed/LoopEmbed.d.ts

@@ -48,6 +48,11 @@ export type LoopEmbedProps = LoopPresetOptions & {
      * which is what a full-page host wants.
      */
     frameHeight?: number | string;
+    /**
+     * The sidebar as a rail of line icons, one panel shown at a time (LOOP
+     * T-07). See `LoopWorkspaceProps.sidebarRail`.
+     */
+    sidebarRail?: boolean;
     /**
      * The host's own plugins, mounted alongside the preset's.
      *
@@ -58,5 +63,5 @@ export type LoopEmbedProps = LoopPresetOptions & {
      */
     plugins?: PluginRef[];
 };
-export declare function LoopEmbed({ agentId, showHeader, chatHeaderActions, headerActions, headerContainer, frameTitle, frameHeight, plugins, ...preset }: LoopEmbedProps): React.JSX.Element;
+export declare function LoopEmbed({ agentId, showHeader, chatHeaderActions, headerActions, headerContainer, frameTitle, frameHeight, sidebarRail, plugins, ...preset }: LoopEmbedProps): React.JSX.Element;
 export default LoopEmbed;

package/lib/loop/embed/LoopEmbed.js

@@ -30,7 +30,7 @@ import { internalQueryClient } from '../../utils';
 import { buildLoopReactor, LoopWorkspace } from '../shell';
 import { loopPlugins } from '../presets';
 import { WindowFrame } from '../plugins/window-frame';
-export function LoopEmbed({ agentId = '', showHeader = false, chatHeaderActions, headerActions, headerContainer, frameTitle, frameHeight, plugins = [], ...preset }) {
+export function LoopEmbed({ agentId = '', showHeader = false, chatHeaderActions, headerActions, headerContainer, frameTitle, frameHeight, sidebarRail = false, plugins = [], ...preset }) {
     /*
      * The latest `firstPromptHook`, kept in a ref rather than closed over
      * directly.
@@ -77,6 +77,8 @@ export function LoopEmbed({ agentId = '', showHeader = false, chatHeaderActions,
         // By its content: an application's spec written inline is a new object each render.
         JSON.stringify(preset.datalayerCreatePayload ?? null),
         JSON.stringify(preset.datalayerVisitors ?? null),
+        preset.datalayerKept?.url,
+        preset.embedToken,
         preset.defaultEditor,
         preset.showViewSelector,
         preset.hideChatHeader,
@@ -135,7 +137,7 @@ export function LoopEmbed({ agentId = '', showHeader = false, chatHeaderActions,
      * view and the workspace draws "No view is available yet".
      */
     useReactor(reactor);
-    const shell = (_jsx(LoopWorkspace, { serverUrl: preset.serverUrl ?? '', agentId: agentId, reactor: reactor, manageReactor: false, showViewSelector: preset.showViewSelector, showHeader: showHeader, chatHeaderActions: chatHeaderActions, headerActions: headerActions, headerContainer: headerContainer }));
+    const shell = (_jsx(LoopWorkspace, { serverUrl: preset.serverUrl ?? '', agentId: agentId, reactor: reactor, manageReactor: false, showViewSelector: preset.showViewSelector, showHeader: showHeader, chatHeaderActions: chatHeaderActions, headerActions: headerActions, headerContainer: headerContainer, sidebarRail: sidebarRail }));
     return (_jsx(QueryClientProvider, { client: internalQueryClient, children: frameTitle !== undefined ? (_jsx(WindowFrame, { title: frameTitle, height: frameHeight, children: shell })) : (
         // Filling its host, whatever the host is: in a flex row it used to
         // shrink to the chat's own width and leave the rest of the frame bare.

package/lib/loop/embed/element.js

@@ -378,7 +378,7 @@ export function defineDatalayerAppElement(options = {}) {
             shadow.appendChild(mount);
             this.root = createRoot(mount);
             const server = this.getAttribute('server') || undefined;
-            this.root.render(_jsx(StyleSheetManager, { target: shadow, children: _jsx(AppEmbed, { app: source.app, mode: look.mode, accent: look.accent, colorMode: look.colorMode, font: look.font, serverUrl: server, height: inlineHeightOf(this.getAttribute('height')), ownPortal: true }) }));
+            this.root.render(_jsx(StyleSheetManager, { target: shadow, children: _jsx(AppEmbed, { app: source.app, mode: look.mode, accent: look.accent, colorMode: look.colorMode, font: look.font, serverUrl: server, ...(server && this.token ? { embedToken: this.token } : {}), height: inlineHeightOf(this.getAttribute('height')), ownPortal: true }) }));
         }
         onMessage(event) {
             if (!this.frame || event.source !== this.frame.contentWindow) {

package/lib/loop/plugins/agents/DatalayerAgentBridge.js

@@ -25,6 +25,11 @@ export function DatalayerAgentBridge() {
     // A conversation without an account (LOOP R-30): the agent is already on
     // the visitors' runtime, kept warm there; nothing is allocated or made.
     const visitors = agentsConfig?.datalayerVisitors;
+    // A deployment kept on a runtime of its own (LOOP R-33): its agent was made
+    // there from the deployment record as the runtime started; nothing is
+    // allocated or made either.
+    const kept = agentsConfig?.datalayerKept;
+    const already = visitors?.url ?? kept?.url;
     const service = useOptionalSandboxService();
     const target = useSignalValue(service?.target ?? IDLE_SANDBOX_TARGET_SIGNAL);
     const onDatalayer = target === 'datalayer';
@@ -68,19 +73,20 @@ export function DatalayerAgentBridge() {
         agentSpecId,
         agentConfig,
         variant: 'cloud-pydanticai',
-        autoStart: onDatalayer && !visitors,
-        autoCreateAgent: onDatalayer && !visitors,
+        autoStart: onDatalayer && !already,
+        autoCreateAgent: onDatalayer && !already,
     });
     useEffect(() => {
         if (!service || !onDatalayer) {
             return;
         }
-        if (visitors) {
+        if (already) {
             service.report({
                 variant: 'datalayer',
-                // No sandbox: a visitor's application runs no code.
+                // No sandbox reported: the agent is already on its runtime, and the
+                // chat is all the page talks to.
                 sandbox_running: false,
-                agent_base_url: visitors.url,
+                agent_base_url: already,
             });
             return;
         }
@@ -118,7 +124,7 @@ export function DatalayerAgentBridge() {
             // host's server for an agent that is not on it.
             agent_base_url: runtime.agentBaseUrl,
         });
-    }, [service, onDatalayer, runtime, status, error, visitors]);
+    }, [service, onDatalayer, runtime, status, error, already]);
     return null;
 }
 export default DatalayerAgentBridge;

package/lib/loop/plugins/agents/browserService.d.ts

@@ -1,4 +1,4 @@
-import type { ServiceManager } from '@jupyterlab/services';
+import type { Kernel, ServiceManager } from '@jupyterlab/services';
 import type { SandboxService } from './service';
 /** What a browser sandbox additionally exposes. */
 export type BrowserSandboxService = SandboxService & {
@@ -13,6 +13,12 @@ export type BrowserSandboxService = SandboxService & {
      * point of a shared sandbox.
      */
     getServiceManager: () => ServiceManager.IManager | null;
+    /**
+     * The kernel's connection, once it is up: what a view that follows the
+     * kernel itself listens to — its variables (jupyter-react's
+     * `KernelVariables`), refreshed after each execution.
+     */
+    getKernelConnection: () => Kernel.IKernelConnection | null;
 };
 /**
  * How a kernel-backed sandbox gets its services.

package/lib/loop/plugins/agents/browserService.js

@@ -126,6 +126,7 @@ export function createBrowserSandboxService(source = browserSource()) {
     const ready = computed(() => lifecycle.value === 'running');
     let serviceManager = null;
     let kernel = null;
+    let kernelConnection = null;
     let starting = null;
     async function start() {
         if (kernel) {
@@ -139,6 +140,7 @@ export function createBrowserSandboxService(source = browserSource()) {
             type: 'notebook',
             kernel: { name: 'python' },
         });
+        kernelConnection = connection.kernel;
         kernel = connection.kernel;
         status.value = {
             variant: source.variant,
@@ -158,6 +160,7 @@ export function createBrowserSandboxService(source = browserSource()) {
         // lives on the server — should ask `kind` rather than discover it here.
         serverUrl: '',
         getServiceManager: () => serviceManager,
+        getKernelConnection: () => kernelConnection,
         report(next) {
             status.value = next;
         },
@@ -182,6 +185,7 @@ export function createBrowserSandboxService(source = browserSource()) {
                 // notebook that is open.
                 void kernel?.shutdown?.();
                 kernel = null;
+                kernelConnection = null;
                 serviceManager = source.owned ? null : serviceManager;
                 // And hand back whatever the source borrowed from the page.
                 source.release?.();

package/lib/loop/plugins/agents/plugin.d.ts

@@ -103,6 +103,22 @@ export type AgentsConfig = {
      * and the chat speaks to it with a visitor's token for the application.
      */
     datalayerVisitors?: DatalayerVisitors;
+    /**
+     * A deployment kept on a runtime of its own (LOOP R-33): its agent is
+     * already there, made from the deployment record when the runtime started,
+     * so nothing is allocated or created, and the chat speaks to it with the
+     * person's own token. `url` is the runtime's agent-runtimes address.
+     */
+    datalayerKept?: {
+        url: string;
+    };
+    /**
+     * An embed token for the application (LOOP R-20): what an embedded
+     * application's chat speaks to its session with, for a visitor the platform
+     * does not know — it runs a session of the application's deployment, and
+     * reaches nothing else.
+     */
+    embedToken?: string;
     /**
      * The target is the host's decision, not the reader's: started there even
      * with the control hidden. For an application that runs where it is

package/lib/loop/plugins/agents/switchable.d.ts

@@ -18,6 +18,7 @@
  * @module loop/plugins/agents/switchable
  */
 import { type ReadonlySignal } from '@datalayer/reactor';
+import type { Kernel } from '@jupyterlab/services';
 import { type ServiceManagerSource } from './browserService';
 import { type SandboxService } from './service';
 /** Where the sandbox runs. */
@@ -72,6 +73,8 @@ export type SwitchableSandboxService = SandboxService & {
     setTarget: (target: SandboxTarget) => Promise<void>;
     /** The in-browser services, when the browser is the active target. */
     getServiceManager: () => unknown | null;
+    /** The in-browser kernel's connection, when the browser is the active target. */
+    getKernelConnection: () => Kernel.IKernelConnection | null;
 };
 export type SwitchableConfig = {
     serverUrl: string;

package/lib/loop/plugins/agents/switchable.js

@@ -239,6 +239,7 @@ export function createSwitchableSandboxService({ serverUrl, initialTarget = 'loc
         lastExecution,
         serverUrl,
         getServiceManager: () => target.peek() === 'browser' ? browser.getServiceManager() : null,
+        getKernelConnection: () => target.peek() === 'browser' ? browser.getKernelConnection() : null,
         report(next) {
             active.peek().report(next);
         },

package/lib/loop/plugins/app-activity/index.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { definePlugin } from '@datalayer/reactor';
+import { PulseIcon } from '@primer/octicons-react';
 import { LoopSlots } from '../../core';
 import { AppActivity } from './AppActivity';
 export const APP_ACTIVITY_PLUGIN_NAME = '@datalayer/loop-plugin-app-activity';
@@ -25,6 +26,8 @@ export function defineAppActivityPlugin(app, appUid) {
                     slot: LoopSlots.sidebar,
                     order: 20,
                     Component: Feed,
+                    // Its line icon on the workspace's rail (T-07).
+                    rail: { label: 'Activity', icon: PulseIcon },
                 },
             ],
         }),

package/lib/loop/plugins/app-computer/index.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { definePlugin } from '@datalayer/reactor';
+import { DeviceDesktopIcon } from '@primer/octicons-react';
 import { LoopSlots } from '../../core';
 import { AppComputer } from './AppComputer';
 export const APP_COMPUTER_PLUGIN_NAME = '@datalayer/loop-plugin-app-computer';
@@ -21,6 +22,8 @@ export function defineAppComputerPlugin(app) {
                     slot: LoopSlots.sidebar,
                     order: 30,
                     Component: Computer,
+                    // Its line icon on the workspace's rail (T-07).
+                    rail: { label: 'Computer', icon: DeviceDesktopIcon },
                 },
             ],
         }),

package/lib/loop/plugins/app-rules/AppRulesCard.d.ts

@@ -12,6 +12,7 @@
  */
 import type { JSX } from 'react';
 import type { AppRuleSpec, AppSpec } from '../../../types/agentspecs';
+import { type Draft } from '../../apps/saved';
 import { type ApprovalRecord } from '../../../hooks/useToolApprovals';
 /** What the card says. */
 export declare const APP_RULES_WORDS: {
@@ -45,6 +46,10 @@ export declare const ruleOfApproval: (approval: ApprovalRecord) => string;
  * person's pages over the same `/ws`.
  */
 export declare function approvalsOfApp(approvals: ApprovalRecord[], appId: string): ApprovalRecord[];
+/** A result it wants to keep, shown whole before it is (LOOP R-24). */
+export declare function DraftShown({ draft }: {
+    draft: Draft;
+}): JSX.Element;
 export declare function AppRulesCard({ app }: {
     app: AppSpec;
 }): JSX.Element;

package/lib/loop/plugins/app-rules/AppRulesCard.js

@@ -4,6 +4,7 @@ import { Button, Heading, Label, Text } from '@primer/react';
 import { Box } from '@datalayer/primer-addons';
 import { useIAMStore } from '@datalayer/core/lib/state/substates/IAMState';
 import { BEHAVIOUR_WORDS, coverOf } from '../../apps/rules';
+import { SAVE_WORDS, draftOfApproval } from '../../apps/saved';
 import { useApproveToolRequest, useRejectToolRequest, useToolApprovalsQuery, } from '../../../hooks/useToolApprovals';
 /** What the card says. */
 export const APP_RULES_WORDS = {
@@ -46,17 +47,35 @@ export function approvalsOfApp(approvals, appId) {
     return approvals.filter(approval => approval.agent_id === appId || approval.tool_args?._app === appId);
 }
 const PENDING = { status: 'pending' };
+/** A result it wants to keep, shown whole before it is (LOOP R-24). */
+export function DraftShown({ draft }) {
+    return (_jsxs(Box, { "data-testid": "app-draft", sx: { mt: 1 }, children: [_jsx(Text, { as: "p", sx: { m: 0, fontSize: 0, color: 'fg.muted' }, children: SAVE_WORDS.where(draft.space) }), _jsx(Text, { as: "p", sx: { m: 0, fontWeight: 'semibold' }, children: draft.title }), _jsx(Box, { as: "pre", sx: {
+                    m: 0,
+                    mt: 1,
+                    p: 2,
+                    maxHeight: 240,
+                    overflow: 'auto',
+                    whiteSpace: 'pre-wrap',
+                    fontFamily: 'inherit',
+                    fontSize: 0,
+                    bg: 'canvas.subtle',
+                    borderRadius: 2,
+                }, children: draft.content })] }));
+}
 function Approvals({ app }) {
     const query = useToolApprovalsQuery(PENDING);
     const approve = useApproveToolRequest();
     const reject = useRejectToolRequest();
     const waiting = useMemo(() => approvalsOfApp(query.data?.approvals ?? [], app.id), [query.data, app.id]);
-    return (_jsxs(Box, { "data-testid": "app-approvals", children: [_jsx(Heading, { as: "h4", sx: { fontSize: 1, mt: 3, mb: 1 }, children: APP_RULES_WORDS.waiting }), approve.connectionState !== 'connected' ? (_jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', m: 0, mb: 1 }, children: APP_RULES_WORDS.offline })) : null, waiting.length === 0 ? (_jsx(Text, { as: "p", sx: { fontSize: 1, color: 'fg.muted', m: 0 }, children: APP_RULES_WORDS.nothingWaiting })) : (_jsx(Box, { as: "ul", sx: { listStyle: 'none', p: 0, m: 0 }, children: waiting.map(approval => (_jsxs(Box, { as: "li", sx: {
-                        py: 2,
-                        borderTop: '1px solid',
-                        borderColor: 'border.muted',
-                        fontSize: 1,
-                    }, children: [_jsx(Text, { sx: { fontWeight: 'semibold' }, children: approval.tool_name }), ruleOfApproval(approval) ? (_jsx(Text, { as: "p", sx: { m: 0, color: 'fg.muted', fontSize: 0 }, children: ruleOfApproval(approval) })) : null, _jsxs(Box, { sx: { display: 'flex', gap: 2, mt: 1 }, children: [_jsx(Button, { size: "small", variant: "primary", disabled: approve.isPending, onClick: () => approve.mutate({ id: approval.id }), children: APP_RULES_WORDS.approve }), _jsx(Button, { size: "small", disabled: reject.isPending, onClick: () => reject.mutate({ id: approval.id }), children: APP_RULES_WORDS.reject })] })] }, approval.id))) }))] }));
+    return (_jsxs(Box, { "data-testid": "app-approvals", children: [_jsx(Heading, { as: "h4", sx: { fontSize: 1, mt: 3, mb: 1 }, children: APP_RULES_WORDS.waiting }), approve.connectionState !== 'connected' ? (_jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', m: 0, mb: 1 }, children: APP_RULES_WORDS.offline })) : null, waiting.length === 0 ? (_jsx(Text, { as: "p", sx: { fontSize: 1, color: 'fg.muted', m: 0 }, children: APP_RULES_WORDS.nothingWaiting })) : (_jsx(Box, { as: "ul", sx: { listStyle: 'none', p: 0, m: 0 }, children: waiting.map(approval => {
+                    const draft = draftOfApproval(approval);
+                    return (_jsxs(Box, { as: "li", sx: {
+                            py: 2,
+                            borderTop: '1px solid',
+                            borderColor: 'border.muted',
+                            fontSize: 1,
+                        }, children: [_jsx(Text, { sx: { fontWeight: 'semibold' }, children: approval.tool_name }), ruleOfApproval(approval) ? (_jsx(Text, { as: "p", sx: { m: 0, color: 'fg.muted', fontSize: 0 }, children: ruleOfApproval(approval) })) : null, draft ? _jsx(DraftShown, { draft: draft }) : null, _jsxs(Box, { sx: { display: 'flex', gap: 2, mt: 1 }, children: [_jsx(Button, { size: "small", variant: "primary", disabled: approve.isPending, onClick: () => approve.mutate({ id: approval.id }), children: draft ? SAVE_WORDS.approve : APP_RULES_WORDS.approve }), _jsx(Button, { size: "small", disabled: reject.isPending, onClick: () => reject.mutate({ id: approval.id }), children: draft ? SAVE_WORDS.decline : APP_RULES_WORDS.reject })] })] }, approval.id));
+                }) }))] }));
 }
 export function AppRulesCard({ app }) {
     const signedIn = Boolean(useIAMStore(state => state.token));

package/lib/loop/plugins/app-rules/index.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { definePlugin } from '@datalayer/reactor';
+import { ShieldCheckIcon } from '@primer/octicons-react';
 import { LoopSlots } from '../../core';
 import { AppRulesCard } from './AppRulesCard';
 export const APP_RULES_PLUGIN_NAME = '@datalayer/loop-plugin-app-rules';
@@ -21,6 +22,8 @@ export function defineAppRulesPlugin(app) {
                     slot: LoopSlots.sidebar,
                     order: 10,
                     Component: Card,
+                    // Its line icon on the workspace's rail (T-07).
+                    rail: { label: 'Rules', icon: ShieldCheckIcon },
                 },
             ],
         }),

package/lib/loop/plugins/assistant/index.d.ts

@@ -28,7 +28,7 @@
 import type { JSX } from 'react';
 import { type AssistantState } from '../../../chat/assistant/state';
 import type { PresenceState } from '../../../chat/presence/presenceStatus';
-import { type ChatTurnSnapshot } from '../../core';
+import { type ChatTurnSnapshot, type LoopWorkspaceContext } from '../../core';
 import type { BalloonDisplay } from '../../../chat/assistant/toolLine';
 export declare const LOOP_ASSISTANT_PLUGIN_NAME = "@datalayer/loop-plugin-assistant";
 export type LoopAssistantConfig = {
@@ -58,6 +58,11 @@ export type LoopAssistantConfig = {
      * (`current`). The Appspec's `interface.balloon`.
      */
     balloon?: BalloonDisplay;
+    /**
+     * The workspace it is drawn over (the root slot's): its agent and
+     * server, for *Agent Details…* and *Code Sandbox Details…*.
+     */
+    workspace?: LoopWorkspaceContext;
 };
 /**
  * What the character acts out (T-22), from what the application is doing as
@@ -68,6 +73,6 @@ export declare function assistantStateOfTurn(turn: ChatTurnSnapshot, presence: P
     arriving?: boolean;
     leaving?: boolean;
 }): AssistantState;
-export declare function LoopAssistant({ app, person, appId, decisions, balloon: displayGiven, }: LoopAssistantConfig): JSX.Element | null;
+export declare function LoopAssistant({ app, person, appId, decisions, balloon: displayGiven, workspace, }: LoopAssistantConfig): JSX.Element | null;
 export declare const LoopAssistantPlugin: import("@datalayer/reactor").ReactorPlugin<LoopAssistantConfig, unknown, unknown>;
 export default LoopAssistantPlugin;