CR

Author: idosal

specification/draft/apps.mdx

@@ -565,7 +565,7 @@ Host SHOULD add the message to the conversation thread, preserving the specified
 }
 ```
 
-Guest UI MAY send this request to inform the agent about app state changes that should be stored in the conversation context for future reasoning. This event serves a different use case from `notifications/message` (logging) and `ui/message` (which also trigger followups).
+Guest UI MAY send this request to inform the agent about app state changes that should be stored in the conversation context for future reasoning. This event serves a different use case from `notifications/message` (logging) and `ui/message` (which also trigger follow-ups).
 
 Host behavior:
 - SHOULD store the context update in the conversation context

src/app-bridge.test.ts

@@ -213,15 +213,15 @@ describe("App <-> AppBridge integration", () => {
       });
     });
 
-    it("app.sendContext triggers bridge.oncontext and returns result", async () => {
+    it("app.sendUpdateContext triggers bridge.onupdatecontext and returns result", async () => {
       const receivedContexts: unknown[] = [];
-      bridge.oncontext = async (params) => {
+      bridge.onupdatecontext = async (params) => {
         receivedContexts.push(params);
         return {};
       };
 
       await app.connect(appTransport);
-      const result = await app.sendContext({
+      const result = await app.sendUpdateContext({
         role: "user",
         content: [{ type: "text", text: "User selected 3 items" }],
       });
@@ -234,15 +234,15 @@ describe("App <-> AppBridge integration", () => {
       expect(result).toEqual({});
     });
 
-    it("app.sendContext works with multiple content blocks", async () => {
+    it("app.sendUpdateContext works with multiple content blocks", async () => {
       const receivedContexts: unknown[] = [];
-      bridge.oncontext = async (params) => {
+      bridge.onupdatecontext = async (params) => {
         receivedContexts.push(params);
         return {};
       };
 
       await app.connect(appTransport);
-      const result = await app.sendContext({
+      const result = await app.sendUpdateContext({
         role: "user",
         content: [
           { type: "text", text: "Filter applied" },
@@ -261,13 +261,13 @@ describe("App <-> AppBridge integration", () => {
       expect(result).toEqual({});
     });
 
-    it("app.sendContext returns error result when handler indicates error", async () => {
-      bridge.oncontext = async () => {
+    it("app.sendUpdateContext returns error result when handler indicates error", async () => {
+      bridge.onupdatecontext = async () => {
         return { isError: true };
       };
 
       await app.connect(appTransport);
-      const result = await app.sendContext({
+      const result = await app.sendUpdateContext({
         role: "user",
         content: [{ type: "text", text: "Test" }],
       });

src/app-bridge.ts

@@ -521,7 +521,7 @@ export class AppBridge extends Protocol<Request, Notification, Result> {
    *
    * @example
    * ```typescript
-   * bridge.oncontext = async ({ role, content }, extra) => {
+   * bridge.onupdatecontext = async ({ role, content }, extra) => {
    *   try {
    *     // Store context update for agent reasoning
    *     conversationContext.push({
@@ -541,7 +541,7 @@ export class AppBridge extends Protocol<Request, Notification, Result> {
    * @see {@link McpUiUpdateContextRequest} for the request type
    * @see {@link McpUiUpdateContextResult} for the result type
    */
-  set oncontext(
+  set onupdatecontext(
     callback: (
       params: McpUiUpdateContextRequest["params"],
       extra: RequestHandlerExtra,

src/app.ts

@@ -680,22 +680,22 @@ export class App extends Protocol<Request, Notification, Result> {
    *
    * Unlike `sendLog` which is for debugging/telemetry, context updates are intended
    * to inform the agent about app state changes that should be available for future
-   * reasoning without requiring a follow-up action (i.e., a prompt).
+   * reasoning without requiring a follow-up action (like `sendMessage`).
    *
    * @param params - Context role and content (same structure as ui/message)
    * @param options - Request options (timeout, etc.)
    *
    * @example Notify agent of significant state change
    * ```typescript
-   * await app.sendContext({
+   * await app.sendUpdateContext({
    *   role: "user",
    *   content: [{ type: "text", text: "User selected 3 items totaling $150.00" }]
    * });
    * ```
    *
    * @returns Promise that resolves when the context update is acknowledged
    */
-  sendContext(
+  sendUpdateContext(
     params: McpUiUpdateContextRequest["params"],
     options?: RequestOptions,
   ) {