@saga-a2ui/react-mcp-stack 0.7.7-rc.1 → 0.9.0-rc.1

package/README.md

@@ -6,7 +6,7 @@ The React stack for an MCP Apps view: it connects one React renderer to one deli
 - `/faithful-card`: `FaithfulCardApp`, `startFaithfulCardApp`, `CardResultOutcome`, `CardResultReader`, `DeliveredResult` (what the definition's one `result` reader receives), `useHostLink` and `readingProfile`.
 - `/faithful-card.css`: the card's stylesheet.
 - `/content-policy`: `createContentPolicy` and `embedContentPolicy`, for the server that states the policy the card application reads from its document.
-- `/server`: `createServerBudgets`, `registerPublicOperation`, `operationViewFromHtml`, `viewUriForHtml`, `attachRequestLifetime`, and the types `OperationView` and `RequestLifetime`. Node only; no browser entry imports it.
+- `/server`: `createServerBudgets`, `registerPublicOperation`, `registerProtectedOperation`, `operationViewFromHtml`, `viewUriForHtml`, `attachRequestLifetime`, and the types `OperationView` and `RequestLifetime`. Node only; no browser entry imports it.
 
 The main entry does not import `@saga-a2ui/components`, so an own-catalog bundle contains neither FaithfulCard nor Markdown. The package still declares the components package, so one install makes the `/faithful-card` and `/content-policy` entries work. React and React DOM are peers, both exactly 19.3.1.
 

package/package.json

@@ -1 +1 @@
-{"name":"@saga-a2ui/react-mcp-stack","private":false,"description":"The React and MCP Apps stack for SAGA A2UI: starts a view for an application's own catalog, and a FaithfulCard application from one validated definition, so an application installs one stack plus React and writes only its own decisions","license":"Apache-2.0","type":"module","sideEffects":["**/*.css"],"exports":{".":"./src/index.ts","./faithful-card":"./src/faithful-card/index.ts","./content-policy":"./src/content-policy/index.ts","./server":"./src/server/index.ts","./faithful-card.css":"./src/faithful-card/faithful-card.css"},"files":["src","!src/**/*.test.ts","!src/**/*.test-support.ts"],"scripts":{"typecheck":"tsc --noEmit"},"dependencies":{"@modelcontextprotocol/ext-apps":"2.0.3","@saga-a2ui/components":"0.7.7-rc.1","@saga-a2ui/core":"0.7.7-rc.1","@saga-a2ui/mcp":"0.7.7-rc.1","@saga-a2ui/react":"0.7.7-rc.1","zod":"4.6.7"},"peerDependencies":{"react":"19.3.1","react-dom":"19.3.1"},"devDependencies":{"@modelcontextprotocol/client":"2.3.1","@types/node":"22.20.5","@types/react":"19.3.0","@types/react-dom":"19.3.0","jsdom":"28.1.0","react":"19.3.1","react-dom":"19.3.1","typescript":"^5.9.0","vitest":"^5.0.4"},"version":"0.7.7-rc.1","engines":{"node":">=22.12.0"},"repository":{"type":"git","url":"https://github.com/MachineWisdomAI/saga-a2ui.git","directory":"packages/react-mcp-stack"},"publishConfig":{"access":"public","tag":"next"}}
+{"name":"@saga-a2ui/react-mcp-stack","private":false,"description":"The React and MCP Apps stack for SAGA A2UI: starts a view for an application's own catalog, and a FaithfulCard application from one validated definition, so an application installs one stack plus React and writes only its own decisions","license":"Apache-2.0","type":"module","sideEffects":["**/*.css"],"exports":{".":"./src/index.ts","./faithful-card":"./src/faithful-card/index.ts","./content-policy":"./src/content-policy/index.ts","./server":"./src/server/index.ts","./faithful-card.css":"./src/faithful-card/faithful-card.css","./server/node":"./src/server/node/index.ts"},"files":["src","!src/**/*.test.ts","!src/**/*.test-support.ts"],"scripts":{"typecheck":"tsc --noEmit"},"dependencies":{"@modelcontextprotocol/ext-apps":"2.0.3","@saga-a2ui/components":"0.9.0-rc.1","@saga-a2ui/core":"0.9.0-rc.1","@saga-a2ui/mcp":"0.9.0-rc.1","@saga-a2ui/react":"0.9.0-rc.1","zod":"4.6.7"},"peerDependencies":{"react":"19.3.1","react-dom":"19.3.1"},"devDependencies":{"@modelcontextprotocol/client":"2.3.1","@types/node":"22.20.5","@types/react":"19.3.0","@types/react-dom":"19.3.0","jsdom":"28.1.0","react":"19.3.1","react-dom":"19.3.1","typescript":"^5.9.0","vitest":"^5.0.4"},"version":"0.9.0-rc.1","engines":{"node":">=22.12.0"},"repository":{"type":"git","url":"https://github.com/MachineWisdomAI/saga-a2ui.git","directory":"packages/react-mcp-stack"},"publishConfig":{"access":"public","tag":"next"}}

package/src/index.ts

@@ -21,6 +21,12 @@ export {
   type StartMisuse,
 } from './start-failure.js';
 export type { RunningView } from './running-view.js';
+// The conversation a running view hands its actions, and the results of adding a message to it.
+export type {
+  AppendResult,
+  Conversation,
+  RequestOutcome,
+} from '@saga-a2ui/core/conversation';
 // The shapes of the two notifications an application's handlers receive.
 export type { ToolInput, ToolResult } from '@saga-a2ui/mcp/view';
 // How the reader meets the host (device or desktop), for an application that maps its own tokens.

package/src/server/index.ts

@@ -7,8 +7,12 @@ export {
   attachRequestLifetime,
   createServerBudgets,
   operationViewFromHtml,
+  registerProtectedOperation,
   registerPublicOperation,
   viewUriForHtml,
+  type BudgetSettings,
+  type LifetimeCause,
+  type OperationOutcome,
   type OperationView,
   type RequestLifetime,
 } from '@saga-a2ui/mcp/server';

package/src/server/node/index.ts

@@ -0,0 +1,5 @@
+export {
+  startLocalMcpServer,
+  type LocalMcpServer,
+  type LocalMcpServerOptions,
+} from '@saga-a2ui/mcp/server/node';

package/src/start-a2ui-view.tsx

@@ -7,8 +7,14 @@ import {
 } from '@saga-a2ui/react/a2ui';
 import { ActionsScope, type ReactActions } from '@saga-a2ui/react/actions';
 import type { ServerTransport } from '@saga-a2ui/core/actions';
+import type { Conversation } from '@saga-a2ui/core/conversation';
 import type { SurfaceLayout } from '@saga-a2ui/core/protocols/a2ui/v0_9';
-import type { HostContext, ToolInput, ToolResult } from '@saga-a2ui/mcp/view';
+import {
+  conversationFromApp,
+  type HostContext,
+  type ToolInput,
+  type ToolResult,
+} from '@saga-a2ui/mcp/view';
 import { createElement, Fragment, type ReactNode } from 'react';
 import { watchActionSetup } from './action-setup.js';
 import {
@@ -35,6 +41,8 @@ import type { ErrorPhase } from './start-failure.js';
 export interface ViewHost {
   /** The way an action reaches the application’s server, through the host. */
   readonly server: ServerTransport<ServerReply>;
+  /** The one way to add a message to the conversation, optionally with context for the assistant. Ends with the view. */
+  readonly conversation: Conversation;
 }
 
 export interface StartA2uiViewOptions<TData> {
@@ -133,6 +141,7 @@ export function startA2uiViewOn<TData>(
     const opened = surface;
     const connection = connect();
     const { app } = connection;
+    const lifetime = new AbortController();
     const { actions: makeActions } = options;
     const actions =
       typeof makeActions === 'function'
@@ -142,6 +151,7 @@ export function startA2uiViewOn<TData>(
                 callServerTool: (request, requestOptions) =>
                   app.callServerTool(request, requestOptions),
               },
+              conversation: conversationFromApp(app, lifetime.signal),
             }),
           )
         : makeActions;
@@ -171,7 +181,7 @@ export function startA2uiViewOn<TData>(
 
     const running = runView({
       connection,
-      lifetime: new AbortController(),
+      lifetime,
       releaseContainer: claim.release,
       sizing: options.sizing ?? 'host',
       ...(readiness === undefined ? {} : { readyWhen: readiness }),