@datalayer/agent-runtimes 1.5.16 → 1.5.18

package/lib/chat/base/ChatBase.js

@@ -36,7 +36,7 @@ import { askedOf } from '../../apps/apps/records';
 import { extractChatMessagesFromFullContext } from './fullContextMessages';
 import { generateMessageId, createUserMessage, createAssistantMessage, } from '../../types/messages';
 import { AI_MODEL_CATALOGUE, DEFAULT_MODEL, isChatModel, } from '../../specs/models';
-import { internalQueryClient, isToolCallMessage, convertHistoryToDisplayItems, createProtocolAdapter, getApiBaseFromConfig, sanitizeAssistantContent, } from '../../utils';
+import { internalQueryClient, isToolCallMessage, getMessageText, convertHistoryToDisplayItems, createProtocolAdapter, getApiBaseFromConfig, sanitizeAssistantContent, } from '../../utils';
 import { useConfig, useSkills, useSkillActions, useContextSnapshot, useSandbox, } from '../../hooks';
 import { useAgentRuntimeWebSocket } from '../../hooks/useAgentRuntimes';
 import { agentRuntimeStore, useAgentRuntimeStore, useAgentRuntimeWsState, } from '../../stores/agentRuntimeStore';
@@ -50,6 +50,7 @@ import { ChatMessageList, } from '../messages/ChatMessageList';
 import { InputPrompt } from '../prompt/InputPrompt';
 import { DeviceHearing } from '../../voice/hearing';
 import { VoiceInput } from '../../voice/VoiceInput';
+import { ReadAloud, readsAloud } from '../../voice/ReadAloud';
 import { isFloatingChatViewMode } from '../viewModes';
 import { ToolApprovalBanner, ToolApprovalDialog, } from '../tools';
 import { initialModelId, isOffered, offeredModels as offeredModelsFor, } from './modelChoice';
@@ -416,7 +417,7 @@ function ChatBaseInner({ title, subtitle, showHeader = false, showTokenUsage = t
 // Mode selection
 useStore: useStoreMode = true, protocol: protocolRaw, onSendMessage, onSendReady, onLoadingChange, onContextSnapshot, enableStreaming = false, 
 // Extended props
-brandIcon, avatarConfig, headerButtons, showPoweredBy = false, poweredByProps, emptyState, renderHeader, showTurnFooter = true, notebookToolSurfacesId, footerContent, welcome, trailingContent, voice, voiceSpeaking = false, onStopSpeaking, showInformation = false, onInformationClick, headerContent, children, borderRadius, backgroundColor, border, boxShadow, compact = false, placeholder, description = 'Start a conversation with the AI agent.', onStateUpdate, onNewChat, onClear, onMessagesChange, onItemsChange, onDisplayItemsChange, autoFocus = false, suggestions, submitOnSuggestionClick = true, hideMessagesAfterToolUI = false, focusTrigger, frontendTools: frontendToolsProp, enableEphemeralNotebook = false, initialEphemeralNotebookOpen = true, onEphemeralNotebookOpenChange, enableEphemeralDocument = false, initialEphemeralSurfaceMode, onEphemeralSurfaceModeChange, collapsed = false, onExpandFromCollapsed, ephemeralNotebookToolbar, ephemeralNotebookToolbarExtraItems, ephemeralDocumentToolbarExtraItems, ephemeralNotebookCollaborationProvider, ephemeralNotebookCollaborationDocumentId, ephemeralDocumentCollaboration, ephemeralRuntimeOverride, 
+brandIcon, avatarConfig, headerButtons, showPoweredBy = false, poweredByProps, emptyState, renderHeader, showTurnFooter = true, notebookToolSurfacesId, footerContent, welcome, trailingContent, voice, voiceSpeaking = false, onStopSpeaking, onReadAloud, showInformation = false, onInformationClick, headerContent, children, borderRadius, backgroundColor, border, boxShadow, compact = false, placeholder, description = 'Start a conversation with the AI agent.', onStateUpdate, onNewChat, onClear, onMessagesChange, onItemsChange, onDisplayItemsChange, autoFocus = false, suggestions, submitOnSuggestionClick = true, hideMessagesAfterToolUI = false, focusTrigger, frontendTools: frontendToolsProp, enableEphemeralNotebook = false, initialEphemeralNotebookOpen = true, onEphemeralNotebookOpenChange, enableEphemeralDocument = false, initialEphemeralSurfaceMode, onEphemeralSurfaceModeChange, collapsed = false, onExpandFromCollapsed, ephemeralNotebookToolbar, ephemeralNotebookToolbarExtraItems, ephemeralDocumentToolbarExtraItems, ephemeralNotebookCollaborationProvider, ephemeralNotebookCollaborationDocumentId, ephemeralDocumentCollaboration, ephemeralRuntimeOverride, 
 // Tool invocation hooks
 onToolCallStart, onToolCallComplete, inspector: inspectorGiven, 
 // Identity/Authorization props
@@ -1467,7 +1468,9 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
     useEffect(() => {
         onContextSnapshot?.(agentUsage);
     }, [agentUsage, onContextSnapshot]);
-    const sandboxStatusQuery = useSandbox(configQueriesEnabled && showHeader, protocol?.configEndpoint, protocol?.authToken, protocol?.agentId);
+    // Never on a runtime held to the application's own routes: it answers no
+    // sandbox socket (OwnRoutesOnly).
+    const sandboxStatusQuery = useSandbox(configQueriesEnabled && showHeader && !protocol?.ownRoutesOnly, protocol?.configEndpoint, protocol?.authToken, protocol?.agentId);
     // ---- Refs ----
     const adapterRef = useRef(null);
     const unsubscribeRef = useRef(null);
@@ -1794,8 +1797,16 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
     const wsBaseUrl = protocol?.configEndpoint
         ? protocol.configEndpoint.replace(/\/api\/v1\/(config|configure)\/?$/, '')
         : (protocol?.endpoint?.replace(/\/api\/v1\/.*$/, '') ?? '');
+    /*
+     * Not on a runtime held to the application's own routes (OwnRoutesOnly): it
+     * answers no monitoring stream, and an application's session asks its
+     * approvals in the conversation, over its ui socket.
+     */
     useAgentRuntimeWebSocket({
-        enabled: !!protocol && !!wsBaseUrl && !isAgentNodeTunnelAgUi,
+        enabled: !!protocol &&
+            !!wsBaseUrl &&
+            !isAgentNodeTunnelAgUi &&
+            !protocol.ownRoutesOnly,
         baseUrl: wsBaseUrl,
         authToken: protocol?.authToken,
         agentId: protocol?.agentId,
@@ -3739,6 +3750,21 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
             ...displayItems,
         ]
         : displayItems;
+    /*
+     * *Read aloud* under each answer the agent has finished (VOICE.md VO-21),
+     * when the host reads answers aloud on request.
+     */
+    const writingId = isLoading || isStreaming
+        ? [...welcomedItems]
+            .reverse()
+            .find((item) => !isToolCallMessage(item) && item.role === 'assistant')?.id
+        : undefined;
+    const readAloudFooter = onReadAloud
+        ? (message) => {
+            const text = getMessageText(message);
+            return readsAloud(message, text, writingId) ? (_jsx(ReadAloud, { onRead: () => onReadAloud(text) })) : null;
+        }
+        : undefined;
     const messagesContent = children ? (children) : (_jsxs(Box, { display: "flex", flexDirection: "column", minHeight: 0, 
         /*
             A reading column, not a full-bleed sheet.
@@ -3752,7 +3778,7 @@ showToolApprovalBanner = true, pendingApprovals: pendingApprovalsProp, onApprove
                 // Tool calls are drawn by the page's Reactor plugins; a named
                 // notebook's cell surfaces stand in for the default row of its tools,
                 // so every chat with a headless notebook gets the same transcript.
-                notebookToolSurfacesId: notebookToolSurfacesId, approvalConfig: approvalConfig, messagesEndRef: messagesEndRef, onRespond: handleRespond, showTurnFooters: showTurnFooter, agentUsage: agentUsage, onRemoveItems: handleRemoveItems, mcpServers: filteredMcpServers, emptyContent: launching ? null : (_jsx(ChatEmptyState, { emptyState: emptyState, brandIcon: brandIcon, description: resolvedDescription, suggestions: resolvedSuggestions, submitOnSuggestionClick: submitOnSuggestionClick, onSuggestionSubmit: handleSuggestionSubmit, onSuggestionFill: handleSuggestionFill })) }), trailingContent] }));
+                notebookToolSurfacesId: notebookToolSurfacesId, approvalConfig: approvalConfig, messagesEndRef: messagesEndRef, onRespond: handleRespond, showTurnFooters: showTurnFooter, renderMessageFooter: readAloudFooter, agentUsage: agentUsage, onRemoveItems: handleRemoveItems, mcpServers: filteredMcpServers, emptyContent: launching ? null : (_jsx(ChatEmptyState, { emptyState: emptyState, brandIcon: brandIcon, description: resolvedDescription, suggestions: resolvedSuggestions, submitOnSuggestionClick: submitOnSuggestionClick, onSuggestionSubmit: handleSuggestionSubmit, onSuggestionFill: handleSuggestionFill })) }), trailingContent] }));
     // The microphone, in the composer's footer (VO-10).
     const voiceControl = hearing && voice ? (_jsx(VoiceInput, { hearing: hearing, language: voice.language, consentKey: voice.consentKey ?? 'chat', disabled: disabled || launching, speaking: voiceSpeaking, onStopSpeaking: onStopSpeaking, onListen: onStopSpeaking, onTranscript: (transcript) => {
             if (voice.sendWhatISay) {

package/lib/chat/messages/ChatMessageList.js

@@ -611,7 +611,7 @@ export function ChatMessageList({ displayItems, actOn, upload, isLoading, isStre
                                                 whiteSpace: 'pre-wrap',
                                                 wordBreak: 'break-word',
                                             }, children: [message.metadata?.input === 'voice' ? (_jsx(Box, { as: "span", "data-spoken": "", title: "Said aloud", "aria-label": "Said aloud:", display: "inline-flex", verticalAlign: "text-bottom", mr: 1, opacity: 0.85, children: _jsx(MicrophoneIcon, { size: 14, "aria-hidden": "true" }) })) : null, text] }));
-                                    })()) : message.live && !getMessageText(message) ? (_jsx(TypingDots, { size: 6 })) : (_jsx(ChatMarkdown, { density: density, text: getMessageText(message) || (isStreaming ? '...' : '') }))] }), message.displays?.length ? (_jsx(Box, { "data-chat-displays": "", display: "flex", flexDirection: "column", gap: 2, mt: 2, width: "100%", children: message.displays.map(display => platform ? (_jsx(ReactorDisplay, { display: display, act: actOn?.(display), upload: upload }, display.id)) : (_jsx(DisplayText, { display: display }, display.id))) })) : null, renderMessageFooter ? (_jsx(Box, { display: "flex", gap: 2, alignItems: "center", mt: 1, flexWrap: "wrap", flexDirection: isUser ? 'row-reverse' : 'row', children: renderMessageFooter(message) })) : null] })] }) }, message.id));
+                                    })()) : message.live && !getMessageText(message) ? (_jsx(TypingDots, { size: 6 })) : (_jsx(ChatMarkdown, { density: density, text: getMessageText(message) || (isStreaming ? '...' : '') }))] }), message.displays?.length ? (_jsx(Box, { "data-chat-displays": "", display: "flex", flexDirection: "column", gap: 2, mt: 2, width: "100%", children: message.displays.map(display => platform ? (_jsx(ReactorDisplay, { display: display, act: actOn?.(display), upload: upload }, display.id)) : (_jsx(DisplayText, { display: display }, display.id))) })) : null, renderMessageFooter?.(message) ? (_jsx(Box, { display: "flex", gap: 2, alignItems: "center", mt: 1, flexWrap: "wrap", flexDirection: isUser ? 'row-reverse' : 'row', children: renderMessageFooter(message) })) : null] })] }) }, message.id));
     };
     return (_jsxs(_Fragment, { children: [displayItems.map((item, index) => {
                 const itemUI = renderItem(item, index);

package/lib/config/AgentConfiguration.d.ts

@@ -29,7 +29,11 @@ export interface LibraryAgentspec {
     welcomeDocument?: string | null;
     sandboxVariant?: string | null;
     protocol?: string | null;
-    ui?: string | null;
+    /** Its UI plugins, each with the renderer it is exposed through (AGENTIC_UI R8). */
+    ui?: Array<{
+        plugin: string;
+        renderer?: string;
+    }> | null;
     trigger?: Record<string, unknown> | null;
     modelConfig?: Record<string, unknown> | null;
     mcpServerTools?: Array<Record<string, unknown>> | null;

package/lib/examples/AgentA2ATeamExample.js

@@ -11,12 +11,13 @@ import { useBrowserInference } from '../hooks/useBrowserInference';
 import { readJwtClaims, tokenLifetimeMs, useAnonymousSessionStore, } from '../runtimes/browser/anonymousToken';
 import { connectA2APeer } from '../runtimes/browser/a2aPeer';
 import { A2ATeamGraph, SceneView, NOTEBOOK_AND_WORDS, teamConnectionsOf, teamToolClassifier, useA2ATeam, usePeerSandbox, } from '../components/teams';
-import { ACCOUNTING_APP_0_0_1, SALES_APP_0_0_2 } from '../specs/apps';
+import { APP_CATALOGUE } from '../specs/apps';
 import { AgentInspector, classifyToolCall, traceA2AFetch, useAgentInspector, } from '../components/inspector';
-import { SALES_AND_ACCOUNTING_TEAM_SPEC_0_0_1 } from '../specs/teams/teams';
-const TEAM = SALES_AND_ACCOUNTING_TEAM_SPEC_0_0_1;
-const SALES = SALES_APP_0_0_2;
-const ACCOUNTING = ACCOUNTING_APP_0_0_1;
+import { TEAM_SPECS } from '../specs/teams/teams';
+// By id, never by the version-named constants: a version bump touches no caller.
+const TEAM = TEAM_SPECS['sales-and-accounting'];
+const SALES = APP_CATALOGUE['sales'];
+const ACCOUNTING = APP_CATALOGUE['accounting'];
 /** What Accounting reaches, from its Appspec: Odoo, through the odoo-accounting MCP server. */
 const ACCOUNTING_CONNECTIONS = teamConnectionsOf(ACCOUNTING);
 /** The members of the team, as the team spec says them. */

package/lib/examples/ChatExample.js

@@ -30,13 +30,13 @@ import { uniqueAgentId } from './utils/agentId';
 import { useExampleAgentRuntime } from './hooks/useExampleAgentRuntime';
 import { BROWSER_SIGN_IN_REASON, useExampleAgentProtocol, } from './hooks/useExampleAgentProtocol';
 import { runsInBrowser } from '../runtimes/variants';
-import { EXAMPLE_SIMPLE_AGENTSPEC_0_0_1 } from '../specs/agents/agents';
+import { AGENTSPECS } from '../specs/agents/agents';
 import { ErrorView } from './components';
 import { Chat } from '../chat';
 setupPrimerPortals();
 const AGENTSPEC_ID = 'example-simple';
 const AGENT_NAME = 'simple';
-const SPEC = EXAMPLE_SIMPLE_AGENTSPEC_0_0_1;
+const SPEC = AGENTSPECS[AGENTSPEC_ID];
 const AgentRuntimeChatExample = () => {
     const agentName = useMemo(() => uniqueAgentId(AGENT_NAME), []);
     const { agentId, baseUrl, error, status, isReady, variant } = useExampleAgentRuntime({

package/lib/examples/VoiceChatExample.js

@@ -45,21 +45,27 @@ const LANGUAGES = [
     { tag: 'en-US', label: 'English' },
     { tag: 'fr-FR', label: 'Français' },
 ];
+/** When answers are heard (VO-21): on request is the Appspec's default. */
+const OUTPUTS = [
+    { output: 'on_request', label: 'Read aloud on request' },
+    { output: 'always', label: 'Always read aloud' },
+];
 const VoiceChatExample = () => {
     const { token } = useSimpleAuthStore();
     const [language, setLanguage] = useState('en-US');
+    const [output, setOutput] = useState('on_request');
     const voiceSpec = voiceFor(language) ?? VOICE_CATALOGUE['kokoro-af-heart'];
     const voice = useMemo(() => ({
         language,
         input: 'push_to_talk',
-        output: 'always',
+        output,
         voice: voiceSpec.id,
         modelsUrl: MODELS,
         engines: ENGINES,
         speechUrl: SPEECH,
         token: token || undefined,
         consentKey: 'voice-chat-example',
-    }), [language, voiceSpec.id, token]);
-    return (_jsx(ThemedProvider, { children: _jsxs(Box, { minHeight: "100vh", bg: "canvas.default", p: 4, children: [_jsxs(Box, { maxWidth: 720, mx: "auto", children: [_jsx(Heading, { as: "h1", sx: { mb: 2 }, children: "Voice chat" }), _jsxs(Text, { as: "p", sx: { color: 'fg.muted', mb: 3 }, children: ["Talk to the assistant instead of typing: hold the microphone in its composer, or ", _jsx("kbd", { children: "Ctrl" }), "+", _jsx("kbd", { children: "Space" }), ", speak, and let go. What you say is heard in this page and never leaves it; the words go in the message box for you to send. Its answers are read aloud as they are written, by Datalayer\u2019s speech service, and not kept.", ' ', _jsx("kbd", { children: "Esc" }), " stops its voice."] }), _jsxs(Box, { display: "flex", alignItems: "center", gap: 3, mb: 3, children: [_jsx(SegmentedControl, { "aria-label": "Language", children: LANGUAGES.map(option => (_jsx(SegmentedControl.Button, { selected: language === option.tag, onClick: () => setLanguage(option.tag), "data-voice-language": option.tag, children: option.label }, option.tag))) }), _jsxs(Text, { sx: { color: 'fg.muted', fontSize: 1 }, children: ["Voice: ", voiceSpec.name] })] }), voiceSpec.attribution && (_jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', mb: 3 }, children: voiceSpec.attribution })), _jsxs(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted' }, children: ["Models from ", MODELS, ", speech from ", SPEECH, ", the agent at ", SERVER, ". See", ' ', _jsx(Link, { href: "https://agent-runtimes.datalayer.tech/chat/voice", children: "Voice" }), ' ', "for how to run each."] })] }), _jsx(ChatFloating, { defaultViewMode: "assistant", assistantCharacter: "paperclip", protocol: "vercel-ai", endpoint: `${SERVER}/api/v1/vercel-ai/assistant`, title: "Assistant", description: "Hello! Hold the microphone and ask me anything.", position: "bottom-right", useStore: false, voice: voice })] }) }));
+    }), [language, output, voiceSpec.id, token]);
+    return (_jsx(ThemedProvider, { children: _jsxs(Box, { minHeight: "100vh", bg: "canvas.default", p: 4, children: [_jsxs(Box, { maxWidth: 720, mx: "auto", children: [_jsx(Heading, { as: "h1", sx: { mb: 2 }, children: "Voice chat" }), _jsxs(Text, { as: "p", sx: { color: 'fg.muted', mb: 3 }, children: ["Talk to the assistant instead of typing: hold the microphone in its composer, or ", _jsx("kbd", { children: "Ctrl" }), "+", _jsx("kbd", { children: "Space" }), ", speak, and let go. What you say is heard in this page and never leaves it; the words go in the message box for you to send. Its answers are read aloud by Datalayer\u2019s speech service, and not kept: on request, with", ' ', _jsx("em", { children: "Read aloud" }), " under an answer, or always, as they are written.", ' ', _jsx("kbd", { children: "Esc" }), " stops its voice."] }), _jsxs(Box, { display: "flex", alignItems: "center", gap: 3, mb: 3, flexWrap: "wrap", children: [_jsx(SegmentedControl, { "aria-label": "Language", children: LANGUAGES.map(option => (_jsx(SegmentedControl.Button, { selected: language === option.tag, onClick: () => setLanguage(option.tag), "data-voice-language": option.tag, children: option.label }, option.tag))) }), _jsx(SegmentedControl, { "aria-label": "When answers are heard", children: OUTPUTS.map(option => (_jsx(SegmentedControl.Button, { selected: output === option.output, onClick: () => setOutput(option.output), "data-voice-output": option.output, children: option.label }, option.output))) }), _jsxs(Text, { sx: { color: 'fg.muted', fontSize: 1 }, children: ["Voice: ", voiceSpec.name] })] }), voiceSpec.attribution && (_jsx(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted', mb: 3 }, children: voiceSpec.attribution })), _jsxs(Text, { as: "p", sx: { fontSize: 0, color: 'fg.muted' }, children: ["Models from ", MODELS, ", speech from ", SPEECH, ", the agent at ", SERVER, ". See", ' ', _jsx(Link, { href: "https://agent-runtimes.datalayer.tech/chat/voice", children: "Voice" }), ' ', "for how to run each."] })] }), _jsx(ChatFloating, { defaultViewMode: "assistant", assistantCharacter: "paperclip", protocol: "vercel-ai", endpoint: `${SERVER}/api/v1/vercel-ai/assistant`, title: "Assistant", description: "Hello! Hold the microphone and ask me anything.", position: "bottom-right", useStore: false, voice: voice })] }) }));
 };
 export default VoiceChatExample;

package/lib/hooks/useBrowserAgent.d.ts

@@ -14,7 +14,7 @@ export type UseBrowserAgentOptions = CreateBrowserAgentOptions & {
  * ```tsx
  * const frontendTools = useNotebookTools(notebookId);
  * const { messages, sendMessage, status } = useBrowserAgent({
- *   spec: JUPYTER_NOTEBOOK_COMPACTOR_AGENTSPEC_0_0_1,
+ *   spec: AGENTSPECS['jupyter-notebook-compactor'],
  *   frontendTools,
  *   inference: { inferenceUrl, token },
  * });

package/lib/hooks/useBrowserAgent.js

@@ -35,7 +35,7 @@ import { createBrowserAgent, } from '../runtimes/browser';
  * ```tsx
  * const frontendTools = useNotebookTools(notebookId);
  * const { messages, sendMessage, status } = useBrowserAgent({
- *   spec: JUPYTER_NOTEBOOK_COMPACTOR_AGENTSPEC_0_0_1,
+ *   spec: AGENTSPECS['jupyter-notebook-compactor'],
  *   frontendTools,
  *   inference: { inferenceUrl, token },
  * });

package/lib/protocols/AGUIAdapter.d.ts

@@ -15,6 +15,11 @@ export declare const RUN_CUT_SHORT = "The run stopped before it finished, withou
 export interface AGUIAdapterConfig extends ProtocolAdapterConfig {
     /** Runtime URL (e.g., /api/copilotkit) */
     runtimeUrl?: string;
+    /**
+     * An application's sessions (`…/api/v1/apps/sessions`): Stop is the
+     * thread's session's (`ProtocolConfig.appSessions`).
+     */
+    appSessions?: string;
 }
 /**
  * AG-UI protocol adapter
@@ -63,6 +68,12 @@ export declare class AGUIAdapter extends BaseProtocolAdapter {
      * Terminate a running agent thread on the backend
      */
     terminateAgent(threadId?: string): Promise<void>;
+    /**
+     * Stop an application's session (`POST {sessions}/{uid}/stop`): what runs
+     * is cancelled and it waits to be resumed. Its thread is the session; with
+     * none, nothing was sent and there is nothing to stop.
+     */
+    private stopSession;
     /**
      * Send a message through AG-UI protocol
      * @param message - The new message to send

package/lib/protocols/AGUIAdapter.js

@@ -86,8 +86,10 @@ export class AGUIAdapter extends BaseProtocolAdapter {
     disconnect() {
         // Abort every ongoing fetch request, not merely the newest.
         this.stopGeneration();
-        // Send terminate request to backend if we have a thread ID
-        if (this.currentThreadId) {
+        // Send terminate request to backend if we have a thread ID. Never an
+        // application's session: a page going away, or the chat rebuilt with a
+        // fresh token, is not the person's Stop — it waits for them to come back.
+        if (this.currentThreadId && !this.aguiConfig.appSessions) {
             this.terminateAgent(this.currentThreadId).catch(err => {
                 console.warn('[AGUIAdapter] Failed to terminate agent:', err);
             });
@@ -98,6 +100,11 @@ export class AGUIAdapter extends BaseProtocolAdapter {
      * Terminate a running agent thread on the backend
      */
     async terminateAgent(threadId) {
+        const sessions = this.aguiConfig.appSessions;
+        if (sessions) {
+            await this.stopSession(sessions, threadId || this.currentThreadId);
+            return;
+        }
         try {
             // Derive the terminate endpoint from the base URL
             // e.g., http://localhost:8765/api/v1/ag-ui/default -> http://localhost:8765/api/v1/ag-ui/terminate
@@ -121,6 +128,24 @@ export class AGUIAdapter extends BaseProtocolAdapter {
             // Ignore errors - agent may have already completed
         }
     }
+    /**
+     * Stop an application's session (`POST {sessions}/{uid}/stop`): what runs
+     * is cancelled and it waits to be resumed. Its thread is the session; with
+     * none, nothing was sent and there is nothing to stop.
+     */
+    async stopSession(sessions, threadId) {
+        if (!threadId) {
+            return;
+        }
+        const url = `${sessions.replace(/\/+$/, '')}/${encodeURIComponent(threadId)}/stop`;
+        const response = await this.fetchOf()(url, {
+            method: 'POST',
+            headers: this.buildHeaders(),
+        });
+        if (!response.ok) {
+            throw new Error(`The session ${threadId} could not be stopped (${response.status}).`);
+        }
+    }
     /**
      * Send a message through AG-UI protocol
      * @param message - The new message to send