modelcontextprotocol/ext-apps
Watch
1
0
Fork
You've already forked ext-apps
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Complete "Passing contextual information" pattern documentation

Browse source 
Documents `updateModelContext` for keeping the model informed about user
interactions. The example shows a shopping cart use case with YAML frontmatter
for structured, parseable context.

Also refines the `updateModelContext` JSDoc to clarify the difference from
`sendMessage` and removes the `structuredContent` example.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Jonathan Hefner 2026-01-19 18:16:56 -06:00
commit 89653cbb7a
1 changed files with 27 additions and 21 deletions
Download patch file Download diff file Expand all files Collapse all files

12
src/app.ts
View file

@ -654,13 +654,12 @@ export class App extends Protocol<AppRequest, AppNotification, AppResult> {
/**
* Update the host's model context with app state.
*
* Unlike `sendLog`, which is for debugging/telemetry, context updates
* are intended to be available to the model in future reasoning,
* without requiring a follow-up action (like `sendMessage`).
* Context updates are intended to be available to the model in future
* turns, without triggering an immediate model response (unlike {@link sendMessage}).
*
* The host will typically defer sending the context to the model until the
* next user message (including `ui/message`), and will only send the last
* update received. Each call overwrites any previous context update.
* next user message — either from the actual user or via `sendMessage`. Only
* the last update is sent; each call overwrites any previous context.
*
* @param params - Context content and/or structured content
* @param options - Request options (timeout, etc.)
@ -671,9 +670,6 @@ export class App extends Protocol<AppRequest, AppNotification, AppResult> {
* @example Update model context with current app state
* {@includeCode ./app.examples.ts#App_updateModelContext_appState}
*
* @example Update with structured content
* {@includeCode ./app.examples.ts#App_updateModelContext_structuredContent}
*
* @example Report runtime error to model
* {@includeCode ./app.examples.ts#App_updateModelContext_reportError}
*