@noodleseed/agent-kit 0.22.0 → 0.23.1

package/manifest.json

@@ -1,19 +1,19 @@
 {
-  "packageVersion": "0.22.0",
+  "packageVersion": "0.23.1",
   "files": [
     {
       "path": "skills/codex/SKILL.md",
-      "sha256": "854f9f274724ac7eeb5bdeb933f83b36cbcbeb3643e0de806ecc33fce89da832",
+      "sha256": "92202210906f0c056e4e34c169be95e4c52dd73c2c11f8074b60bacc4e24af28",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/references/sdk-surface.md",
-      "sha256": "0916b1f4df01053c424b46eeb4e8ee0910709d66b956c4d19da77d5abc4b046b",
+      "sha256": "23b901198b1d6a2cb5c140810b2fc4d58b7008c2afb2fdd57a8e2993333a7600",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/references/cli-commands.md",
-      "sha256": "3a6df9f9a1311843d929c06698a87695fe8e4197d4c6ca64b2768c2990386557",
+      "sha256": "abcd6d76e1c9e22e3104b04ca2eb436a0ee19ee114648689a7ba43e164007b34",
       "agentTarget": "codex"
     },
     {
@@ -23,17 +23,17 @@
     },
     {
       "path": "skills/codex/references/compile-errors.md",
-      "sha256": "1039e245421e8c128cf1a81cf7a3ce809b0149478917040abebc124ffcb60423",
+      "sha256": "1ed667250f8f14625012bd8e931812c5d80bac323fa2f39a79ec83dc119fc385",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/references/authoring-workflow.md",
-      "sha256": "a2389c7cdbb28a817b8e5b616b625c02fed25fc017845349892c6e1b546a71c0",
+      "sha256": "3f4767bfe361090e172c7554f1121fe415e618f3a90304498535d177b0c633be",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/references/embedded-assistant.md",
-      "sha256": "e72fbea15298b980ccd876ced45f9e0b17b472859e1f5731283d7677ed9b0f13",
+      "sha256": "3e96c4f322cadbd509957781005060a8526c8e60e610bcb7246edc1e86349bf9",
       "agentTarget": "codex"
     },
     {
@@ -48,7 +48,7 @@
     },
     {
       "path": "skills/codex/references/widgets-and-apps.md",
-      "sha256": "69ff229945465793e6c9ae10e5185fc3b5e59b9fb508f03a81ab8d2a12b39efc",
+      "sha256": "7e77eb1520883ad8bd0492fcefae97dfdb0e5bbe9351a7c554d19ee1f7c087cc",
       "agentTarget": "codex"
     },
     {
@@ -63,7 +63,7 @@
     },
     {
       "path": "skills/codex/references/deploy-and-ops.md",
-      "sha256": "1b359a78e76ad6a71003a3d235685019cd2e1e2bbabd95ec520761d9915a2259",
+      "sha256": "d029cb301ae2d06337f573a356c98106f283a1ef8f5f905fb63fe4d4bdf5c599",
       "agentTarget": "codex"
     },
     {
@@ -118,7 +118,7 @@
     },
     {
       "path": "skills/codex/examples/acme-bistro/src/server.ts",
-      "sha256": "3f707b40fdf84ab2e8738367a2e0cccaf075a07aa945801ffb3a534f98ee1dcd",
+      "sha256": "35b735b5451499dad7b5bba9f4a0e0e57cc579d1ca8bcdd75317a044ed72c91b",
       "agentTarget": "codex"
     },
     {
@@ -173,7 +173,7 @@
     },
     {
       "path": "skills/codex/examples/acme-discovery/src/server.ts",
-      "sha256": "3a8d1285b375b6e650db95033af0f1cb0c8f5468a6a454e4cbcc8aaae7f6ff9d",
+      "sha256": "0d5a6c50a126b379ffcc67b5089665e079f2aa5f7ddb1c6a5a99d6a6d37669e4",
       "agentTarget": "codex"
     },
     {
@@ -228,7 +228,7 @@
     },
     {
       "path": "skills/codex/examples/acme-tasks/src/server.ts",
-      "sha256": "3876daf95af0e55d245e641b5e91a7cdd40bdccb6a4f0bd50c65a462ac98d37d",
+      "sha256": "769982ba567460af08d79517d6bf259ce4e8f7882cd3525fadbd5b22639e08ff",
       "agentTarget": "codex"
     },
     {
@@ -243,7 +243,7 @@
     },
     {
       "path": "skills/codex/examples/acme-tasks/test/server.test.ts",
-      "sha256": "b170fb0963c21c804949dead018b9ce15deae0ecaa014abab19b4a7a05f42070",
+      "sha256": "1a6c729cceae3cf5ac5fea9081eb61c686a0a72c8a90539e5b0dee4307a4ff81",
       "agentTarget": "codex"
     },
     {
@@ -278,7 +278,7 @@
     },
     {
       "path": "skills/codex/examples/food-ordering/README.md",
-      "sha256": "4d42dfbaf46ee8003ae84b3ef79c9d2a8b716943b85e2e9329fa875007019524",
+      "sha256": "1e8a08868efa70fe79bacc02d27effa5a65fbb5b497e76a7ce1268586ec559dc",
       "agentTarget": "codex"
     },
     {
@@ -293,12 +293,12 @@
     },
     {
       "path": "skills/codex/examples/food-ordering/src/helpers.ts",
-      "sha256": "9d8a510ddfe3892340446dcadd6e40e3f88ea9f5b82ff780fc743771656f3e5b",
+      "sha256": "91f8dec747e4eb050c2e8dc8c22679443f22468c7fe7cf821e97f42eadb629e5",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/examples/food-ordering/src/server.ts",
-      "sha256": "6e8c4c17e6f3a7867232880e1a8d0e45428ebfd3938282d6bec7d8542ae7d712",
+      "sha256": "55942f7b6424ea6019479ab2df98afd0d5c33e154acddaf6638cf78d144da639",
       "agentTarget": "codex"
     },
     {
@@ -308,7 +308,7 @@
     },
     {
       "path": "skills/codex/examples/food-ordering/src/views/ordering-flow.tsx",
-      "sha256": "81f8247c4a6370b5075279ac8cd54ddb669b5995c8fa385f4784720b99cb6203",
+      "sha256": "57690826caf1c7d4cd6da95a82fc8df3be1106f0de75716a3ccbb4dece2a953e",
       "agentTarget": "codex"
     },
     {
@@ -318,7 +318,7 @@
     },
     {
       "path": "skills/codex/examples/food-ordering/test/server.test.ts",
-      "sha256": "e2f2fc0462073ba188c4a70251dafb029d7b3ae585275312c5fa55ba54127fc2",
+      "sha256": "6819457eed88b302d8369a24dc22581066d25c9092dca3a1141366665e246e52",
       "agentTarget": "codex"
     },
     {
@@ -378,17 +378,17 @@
     },
     {
       "path": "skills/claude-code/SKILL.md",
-      "sha256": "6b0569348845fc943f50fe9a4ba408034316c9f8bf4867734b41bfba494f8310",
+      "sha256": "a2729d4dd959a01b7ff39f375855c4e0026f95adae8d1390748c9f7c8198ef38",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/references/sdk-surface.md",
-      "sha256": "0916b1f4df01053c424b46eeb4e8ee0910709d66b956c4d19da77d5abc4b046b",
+      "sha256": "23b901198b1d6a2cb5c140810b2fc4d58b7008c2afb2fdd57a8e2993333a7600",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/references/cli-commands.md",
-      "sha256": "3a6df9f9a1311843d929c06698a87695fe8e4197d4c6ca64b2768c2990386557",
+      "sha256": "abcd6d76e1c9e22e3104b04ca2eb436a0ee19ee114648689a7ba43e164007b34",
       "agentTarget": "claude-code"
     },
     {
@@ -398,17 +398,17 @@
     },
     {
       "path": "skills/claude-code/references/compile-errors.md",
-      "sha256": "1039e245421e8c128cf1a81cf7a3ce809b0149478917040abebc124ffcb60423",
+      "sha256": "1ed667250f8f14625012bd8e931812c5d80bac323fa2f39a79ec83dc119fc385",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/references/authoring-workflow.md",
-      "sha256": "a2389c7cdbb28a817b8e5b616b625c02fed25fc017845349892c6e1b546a71c0",
+      "sha256": "3f4767bfe361090e172c7554f1121fe415e618f3a90304498535d177b0c633be",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/references/embedded-assistant.md",
-      "sha256": "e72fbea15298b980ccd876ced45f9e0b17b472859e1f5731283d7677ed9b0f13",
+      "sha256": "3e96c4f322cadbd509957781005060a8526c8e60e610bcb7246edc1e86349bf9",
       "agentTarget": "claude-code"
     },
     {
@@ -423,7 +423,7 @@
     },
     {
       "path": "skills/claude-code/references/widgets-and-apps.md",
-      "sha256": "69ff229945465793e6c9ae10e5185fc3b5e59b9fb508f03a81ab8d2a12b39efc",
+      "sha256": "7e77eb1520883ad8bd0492fcefae97dfdb0e5bbe9351a7c554d19ee1f7c087cc",
       "agentTarget": "claude-code"
     },
     {
@@ -438,7 +438,7 @@
     },
     {
       "path": "skills/claude-code/references/deploy-and-ops.md",
-      "sha256": "1b359a78e76ad6a71003a3d235685019cd2e1e2bbabd95ec520761d9915a2259",
+      "sha256": "d029cb301ae2d06337f573a356c98106f283a1ef8f5f905fb63fe4d4bdf5c599",
       "agentTarget": "claude-code"
     },
     {
@@ -493,7 +493,7 @@
     },
     {
       "path": "skills/claude-code/examples/acme-bistro/src/server.ts",
-      "sha256": "3f707b40fdf84ab2e8738367a2e0cccaf075a07aa945801ffb3a534f98ee1dcd",
+      "sha256": "35b735b5451499dad7b5bba9f4a0e0e57cc579d1ca8bcdd75317a044ed72c91b",
       "agentTarget": "claude-code"
     },
     {
@@ -548,7 +548,7 @@
     },
     {
       "path": "skills/claude-code/examples/acme-discovery/src/server.ts",
-      "sha256": "3a8d1285b375b6e650db95033af0f1cb0c8f5468a6a454e4cbcc8aaae7f6ff9d",
+      "sha256": "0d5a6c50a126b379ffcc67b5089665e079f2aa5f7ddb1c6a5a99d6a6d37669e4",
       "agentTarget": "claude-code"
     },
     {
@@ -603,7 +603,7 @@
     },
     {
       "path": "skills/claude-code/examples/acme-tasks/src/server.ts",
-      "sha256": "3876daf95af0e55d245e641b5e91a7cdd40bdccb6a4f0bd50c65a462ac98d37d",
+      "sha256": "769982ba567460af08d79517d6bf259ce4e8f7882cd3525fadbd5b22639e08ff",
       "agentTarget": "claude-code"
     },
     {
@@ -618,7 +618,7 @@
     },
     {
       "path": "skills/claude-code/examples/acme-tasks/test/server.test.ts",
-      "sha256": "b170fb0963c21c804949dead018b9ce15deae0ecaa014abab19b4a7a05f42070",
+      "sha256": "1a6c729cceae3cf5ac5fea9081eb61c686a0a72c8a90539e5b0dee4307a4ff81",
       "agentTarget": "claude-code"
     },
     {
@@ -653,7 +653,7 @@
     },
     {
       "path": "skills/claude-code/examples/food-ordering/README.md",
-      "sha256": "4d42dfbaf46ee8003ae84b3ef79c9d2a8b716943b85e2e9329fa875007019524",
+      "sha256": "1e8a08868efa70fe79bacc02d27effa5a65fbb5b497e76a7ce1268586ec559dc",
       "agentTarget": "claude-code"
     },
     {
@@ -668,12 +668,12 @@
     },
     {
       "path": "skills/claude-code/examples/food-ordering/src/helpers.ts",
-      "sha256": "9d8a510ddfe3892340446dcadd6e40e3f88ea9f5b82ff780fc743771656f3e5b",
+      "sha256": "91f8dec747e4eb050c2e8dc8c22679443f22468c7fe7cf821e97f42eadb629e5",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/examples/food-ordering/src/server.ts",
-      "sha256": "6e8c4c17e6f3a7867232880e1a8d0e45428ebfd3938282d6bec7d8542ae7d712",
+      "sha256": "55942f7b6424ea6019479ab2df98afd0d5c33e154acddaf6638cf78d144da639",
       "agentTarget": "claude-code"
     },
     {
@@ -683,7 +683,7 @@
     },
     {
       "path": "skills/claude-code/examples/food-ordering/src/views/ordering-flow.tsx",
-      "sha256": "81f8247c4a6370b5075279ac8cd54ddb669b5995c8fa385f4784720b99cb6203",
+      "sha256": "57690826caf1c7d4cd6da95a82fc8df3be1106f0de75716a3ccbb4dece2a953e",
       "agentTarget": "claude-code"
     },
     {
@@ -693,7 +693,7 @@
     },
     {
       "path": "skills/claude-code/examples/food-ordering/test/server.test.ts",
-      "sha256": "e2f2fc0462073ba188c4a70251dafb029d7b3ae585275312c5fa55ba54127fc2",
+      "sha256": "6819457eed88b302d8369a24dc22581066d25c9092dca3a1141366665e246e52",
       "agentTarget": "claude-code"
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noodleseed/agent-kit",
-  "version": "0.22.0",
+  "version": "0.23.1",
   "private": false,
   "description": "Self-checking, self-updating agent skills for the Noodle Seed CLI. Authored in this repo by @noodle-borg/agent-kit; this is the published, independently-versioned canonical skills artifact the CLI fetches and verifies.",
   "license": "Apache-2.0",

package/skills/claude-code/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: noodle-seed
 description: Use when building, validating, testing, deploying, or operating a local or hosted Noodle Seed MCP server or app authored in TypeScript with the noodle CLI.
-version: 0.22.0
+version: 0.23.1
 hash: b4fc528d406e2149
 ---
 

package/skills/claude-code/examples/acme-bistro/src/server.ts

@@ -29,7 +29,7 @@ const menuItemOutput = z.object({
 // Tool annotations for host planners: the menu read is read-only; cart edits are local writes; checkout
 // opens an external (payment) link.
 const readOnly = annotations.readOnly();
-const localWrite = annotations.localAction({ destructive: false });
+const localWrite = annotations.localAction({ destructive: false, confirm: false });
 const openLink = annotations.openAction();
 
 export default server(

package/skills/claude-code/examples/acme-discovery/src/server.ts

@@ -83,7 +83,7 @@ const discoverInput = z.object({
 // shortlisting is a local non-destructive write.
 const readOnly = annotations.readOnly();
 const openLink = annotations.openAction();
-const localWrite = annotations.localAction({ destructive: false });
+const localWrite = annotations.localAction({ destructive: false, confirm: false });
 
 const destinationOutput = z.object({
   id: z.string(),

package/skills/claude-code/examples/acme-tasks/src/server.ts

@@ -28,6 +28,8 @@ const priority = z.enum(['high', 'medium', 'low']);
 // non-destructive writes.
 const readOnly = annotations.readOnly();
 const localWrite = annotations.localAction({ destructive: false });
+const confirmedWrite = annotations.localAction({ destructive: false, confirm: true });
+const widgetWrite = annotations.localAction({ destructive: false, confirm: false });
 
 const taskOutput = z.object({
   id: z.string(),
@@ -104,7 +106,7 @@ export default server(
     // Flow 3 — Complete: mark a task done. Model-visible so the model can complete on request.
     tool('complete_task', {
       description: 'Mark an Acme task complete. Pass the task id and its title.',
-      annotations: localWrite,
+      annotations: confirmedWrite,
       input: z.object({
         task: z.string(),
         title: z.string().min(1),
@@ -122,7 +124,7 @@ export default server(
     tool('set_priority', {
       visibility: ['app'],
       description: 'Re-prioritize a task from the list widget.',
-      annotations: localWrite,
+      annotations: widgetWrite,
       input: z.object({
         task: z.string(),
         priority,

package/skills/claude-code/examples/acme-tasks/test/server.test.ts

@@ -19,4 +19,13 @@ describe('acme-tasks example', () => {
     const text = JSON.stringify(await app.toManifest());
     expect(text).toMatch(/"tasks":\[\{"id":"email_vendor".*"priority":"high"/);
   });
+
+  it('opts the conversational completion action into runtime confirmation', async () => {
+    const manifest = await app.toManifest();
+    const completeTask = manifest.tools.find((candidate) => candidate.name === 'complete_task');
+    const addTask = manifest.tools.find((candidate) => candidate.name === 'add_task');
+
+    expect(completeTask?.annotations?.confirm).toBe(true);
+    expect(addTask?.annotations).not.toHaveProperty('confirm');
+  });
 });

package/skills/claude-code/examples/food-ordering/README.md

@@ -1,8 +1,9 @@
 # Food Ordering
 
 **Owns:** The flagship consumer ordering MCP App example: React view authoring, app-only helper tools,
-caller-scoped cart state handles, packaged image assets, checkout handoff policy, host actions,
-CSP/permissions metadata, and widget preview coverage.
+caller-scoped cart state handles, invocation context, model-visible widget state/lifecycle, packaged image
+assets, portable structured elicitation, checkout handoff policy, host actions, CSP/permissions metadata,
+and widget preview coverage.
 
 Food Ordering is a generic, synthetic version of a live marketplace ordering app. It lets a user search
 stores, browse menus, customize an item, build a multi-line cart, review the order, and hand off checkout to
@@ -14,10 +15,13 @@ private customer data.
 | Capability | Example |
 | :--- | :--- |
 | Public entry tool | `open_ordering` returns structured fallback content and renders the React widget |
-| App-only helper tools | `search_stores`, `load_menu`, `load_item`, `read_cart`, `sync_cart`, `prepare_checkout` |
+| App-only helper tools | `search_stores`, `load_menu`, `load_item`, `read_cart`, `sync_cart`, `prepare_checkout`; mutating widget-owned helpers use `confirm: false` (equivalent to omission) and execute directly because action hints alone never gate |
 | Durable cart state | `server(..., { state: { handles: { cart } }, use: { state } })` with caller scope and revision checks |
 | React app runtime kit | `@noodleseed/one/react` supplies app flow, shell/nav/view, async state, form, quantity, choice, and handoff primitives |
 | Multi-step widget flow | One React shell navigates stores, menu, item customization, cart, review, and handoff views through `useAppFlow` |
+| Invocation context | `server.context` sets locale/time-zone defaults, derives an ambient service area/date, and makes the same snapshot available to tools and the reserved `noodle_context` MCP adapter |
+| Structured missing input | `plan_order` uses `ctx.elicit` to collect a fulfilment method and date in embedded/headless renderers and bidirectional MCP adapters; the stateless hosted MCP endpoint does not yet carry the server-initiated exchange |
+| Model-visible widget state | `useUpdateModelContext` publishes one cohesive replacement snapshot when supported; `useWidgetLifecycle` auto-publishes mounted/cancelled/dismissed and reports author-owned submitted milestones for future context (not host-presentation proof), while the user-triggered submit pairs `useSendFollowUpMessage` for an immediate reply |
 | Handoff | `handoff.allowedDomains` allows only `https://orders.example.com` checkout URLs |
 | Progressive enhancement | Non-Apps hosts still receive stores, featured items, and a readable fallback summary |
 

package/skills/claude-code/examples/food-ordering/src/helpers.ts

@@ -30,5 +30,7 @@ export const {
   useOpenExternal,
   useSendFollowUpMessage,
   useToolInfo,
+  useUpdateModelContext,
   useViewState,
+  useWidgetLifecycle,
 } = generateHelpers<AppType>();

package/skills/claude-code/examples/food-ordering/src/server.ts

@@ -174,7 +174,10 @@ type CartInput = {
 };
 
 const readOnly = annotations.readOnly();
-const action = annotations.openAction({ destructive: false });
+// These writes are app-only controls inside the cart widget. The widget already presents the
+// reviewed state and explicit button; `confirm: false` documents direct execution and is equivalent
+// to omission because action/open-world hints alone never enable the confirmation gate.
+const action = annotations.openAction({ destructive: false, confirm: false });
 
 function checkoutUrl(customer: string): string {
   return `https://orders.example.com/checkout?customer=${encodeURIComponent(customer)}`;
@@ -198,6 +201,16 @@ export default server(
     title: 'Food Ordering',
     version: '1.0.0',
     use: { state },
+    context: {
+      defaults: { locale: 'en-US', timeZone: 'America/New_York' },
+      ambient: {
+        output: z.object({ serviceArea: z.string(), orderingDate: z.string() }),
+        fulfil: ({ context }) => ({
+          serviceArea: 'Harbor District',
+          orderingDate: context.temporal.localDate,
+        }),
+      },
+    },
     state: {
       handles: {
         cart: {
@@ -239,13 +252,17 @@ export default server(
         customer: z.string(),
         stores: z.array(storeShape),
         featuredItems: z.array(menuItemShape),
+        localDate: z.string(),
+        serviceArea: z.string(),
         fallback: z.string(),
       }),
-      fulfil: ({ input }) => ({
+      fulfil: ({ input, context }) => ({
         status: 'Ready to build a food order.',
         customer: input.customer,
         stores,
         featuredItems: menu,
+        localDate: context.temporal.localDate,
+        serviceArea: context.ambient.serviceArea,
         fallback: 'Open stores: Harbor Noodles (Noodles), Garden Wraps (Vegetarian).',
       }),
       viewTitle: 'Food ordering',
@@ -363,6 +380,34 @@ export default server(
       }),
       fulfil: () => ({ stores, featuredItems: menu }),
     }),
+    tool('plan_order', {
+      description:
+        'Collect a fulfilment method and requested date as structured input, then return a reviewable order plan without placing an order.',
+      annotations: readOnly,
+      input: z.object({ customer: z.string().default('Guest') }),
+      output: z.object({
+        customer: z.string(),
+        method: z.enum(['pickup', 'delivery']),
+        requestedDate: z.string(),
+        serviceArea: z.string(),
+      }),
+      fulfil: ({ input, context, elicit }) => {
+        const preference = elicit({
+          id: 'choose_fulfilment',
+          message: 'How should we fulfil this order?',
+          input: z.object({
+            method: z.enum(['pickup', 'delivery']).describe('Fulfilment method'),
+            requestedDate: z.string().describe('Requested date').meta({ format: 'date' }),
+          }),
+        });
+        return {
+          customer: input.customer,
+          method: preference.method,
+          requestedDate: preference.requestedDate,
+          serviceArea: context.ambient.serviceArea,
+        };
+      },
+    }),
     tool('show_capabilities', {
       description: 'Return a concise summary for the standalone widget capability preview.',
       annotations: readOnly,

package/skills/claude-code/examples/food-ordering/src/views/ordering-flow.tsx

@@ -1,4 +1,4 @@
-import { useMemo, useState } from 'react';
+import { useEffect, useMemo, useState } from 'react';
 import {
   ActionBar,
   AppShell,
@@ -19,7 +19,9 @@ import {
   useLayout,
   useSendFollowUpMessage,
   useToolInfo,
+  useUpdateModelContext,
   useViewState,
+  useWidgetLifecycle,
   View,
   ViewStack,
 } from '../helpers.js';
@@ -90,7 +92,7 @@ function modifierLabel(value: string): string {
 }
 
 export default function OrderingFlow() {
-  const { displayMode, theme } = useLayout();
+  const { displayMode, supports, theme } = useLayout();
   const entry = structured<{
     readonly customer?: string;
     readonly stores?: readonly Store[];
@@ -106,6 +108,8 @@ export default function OrderingFlow() {
   const setView = flow.navigate;
   const handoff = useHandoff();
   const sendFollowUpMessage = useSendFollowUpMessage();
+  const updateModelContext = useUpdateModelContext();
+  const publishLifecycle = useWidgetLifecycle('ordering-flow');
   const searchStores = useCallTool('search_stores');
   const loadMenu = useCallTool('load_menu');
   const loadItem = useCallTool('load_item');
@@ -134,6 +138,7 @@ export default function OrderingFlow() {
   const setRevision = (value: number) => revisionStore.setState({ value });
   const [quantity, setQuantity] = useState(1);
   const [selectedModifiers, setSelectedModifiers] = useState<readonly string[]>([]);
+  const [lifecycle, setLifecycle] = useState<'active' | 'submitted'>('active');
 
   const storeData = structured<{ readonly stores?: readonly Store[] }>(searchStores.data);
   const menuData = structured<{
@@ -170,6 +175,37 @@ export default function OrderingFlow() {
   const llmSummary = `${view} view for ${customer}; ${cart.lines.length} cart lines; subtotal ${currency(
     cart.subtotal,
   )}`;
+  const canUpdateModelContext = supports?.modelContext === true;
+
+  useEffect(() => {
+    if (!canUpdateModelContext) return;
+    // Each call replaces model context, so publish one cohesive snapshot of current surface state.
+    void updateModelContext({
+      content: [{ type: 'text', text: `Food ordering: ${llmSummary}; ${lifecycle}.` }],
+      structuredContent: {
+        widget: { name: 'ordering-flow', lifecycle },
+        ordering: {
+          view,
+          customer,
+          cartLines: cart.lines.length,
+          subtotal: cart.subtotal,
+          selectedStoreId: selectedStoreId ?? null,
+          selectedItemId: selectedItemId ?? null,
+        },
+      },
+    });
+  }, [
+    canUpdateModelContext,
+    cart.lines.length,
+    cart.subtotal,
+    customer,
+    lifecycle,
+    llmSummary,
+    selectedItemId,
+    selectedStoreId,
+    updateModelContext,
+    view,
+  ]);
 
   async function chooseStore(store: Store) {
     setSelectedStoreId(store.id);
@@ -246,9 +282,26 @@ export default function OrderingFlow() {
       readonly revision?: number;
       readonly checkoutUrl?: string;
     }>(result);
-    setCart(prepared?.cart ?? cart);
+    const preparedCart = prepared?.cart ?? cart;
+    setCart(preparedCart);
     setRevision(prepared?.revision ?? revision + 1);
+    setLifecycle('submitted');
     setView('handoff');
+    if (canUpdateModelContext) {
+      await publishLifecycle('submitted', {
+        view: 'handoff',
+        customer,
+        cartLines: preparedCart.lines.length,
+        subtotal: preparedCart.subtotal,
+        selectedStoreId: preparedCart.selectedStoreId ?? null,
+        selectedItemId: selectedItemId ?? null,
+      });
+    }
+    if (supports?.followUpMessage) {
+      await sendFollowUpMessage({
+        prompt: 'Checkout is prepared. Confirm the cart summary and explain the final handoff.',
+      });
+    }
   }
 
   return (

package/skills/claude-code/examples/food-ordering/test/server.test.ts

@@ -10,6 +10,13 @@ describe('food-ordering example', () => {
     const manifest = (await app.toManifest()) as {
       server: {
         name: string;
+        context?: {
+          defaults?: { locale?: string; timeZone?: string };
+          ambient?: {
+            outputSchema?: unknown;
+            fulfilment?: { output?: unknown };
+          };
+        };
       };
       handoff?: { allowedDomains?: string[] };
       state?: { handles?: Record<string, { kind: string; scope: string }> };
@@ -17,7 +24,9 @@ describe('food-ordering example', () => {
       tools: Array<{
         name: string;
         visibility?: string[];
+        annotations?: Record<string, unknown>;
         output?: unknown;
+        fulfilment?: { steps?: unknown[]; output?: unknown };
       }>;
       widgets?: Array<{
         name: string;
@@ -27,6 +36,17 @@ describe('food-ordering example', () => {
     };
 
     expect(manifest.server.name).toBe('food_ordering');
+    expect(manifest.server.context).toMatchObject({
+      defaults: { locale: 'en-US', timeZone: 'America/New_York' },
+      ambient: {
+        fulfilment: {
+          output: {
+            serviceArea: 'Harbor District',
+            orderingDate: '${context.temporal.localDate}',
+          },
+        },
+      },
+    });
     expect(manifest.state?.handles?.cart).toMatchObject({
       kind: 'cart',
       scope: 'caller',
@@ -52,7 +72,33 @@ describe('food-ordering example', () => {
       expect(tools.get(helper)?.visibility).toEqual(['app']);
     }
     expect(JSON.stringify(tools.get('open_ordering'))).toContain('featuredItems');
+    expect(JSON.stringify(tools.get('open_ordering'))).toContain('${context.temporal.localDate}');
+    expect(JSON.stringify(tools.get('open_ordering'))).toContain('${context.ambient.serviceArea}');
     expect(JSON.stringify(tools.get('sync_cart'))).toContain('revision');
+    expect(tools.get('sync_cart')?.annotations?.confirm).toBe(false);
+    expect(tools.get('prepare_checkout')?.annotations?.confirm).toBe(false);
+    expect(tools.get('plan_order')?.fulfilment).toMatchObject({
+      steps: [
+        {
+          id: 'choose_fulfilment',
+          elicit: {
+            message: 'How should we fulfil this order?',
+            requestedSchema: {
+              type: 'object',
+              properties: {
+                method: { type: 'string', enum: ['pickup', 'delivery'] },
+                requestedDate: { type: 'string', format: 'date' },
+              },
+              required: ['method', 'requestedDate'],
+            },
+          },
+        },
+      ],
+      output: {
+        method: '${steps.choose_fulfilment.method}',
+        requestedDate: '${steps.choose_fulfilment.requestedDate}',
+      },
+    });
     expect(manifest.widgets?.map((widget) => widget.name)).toContain('capabilities_card');
   });
 });