@noodleseed/agent-kit 0.17.0 → 0.19.0

package/manifest.json

@@ -1,19 +1,19 @@
 {
-  "packageVersion": "0.17.0",
+  "packageVersion": "0.19.0",
   "files": [
     {
       "path": "skills/codex/SKILL.md",
-      "sha256": "5f24dd83ca00ad0b078de17f0a978b28ee17b17678ab103a0151f550444e1c47",
+      "sha256": "590f306f725fbc64e576fbcba6dad4bb4b163bb2cbfc799cad04adac7645a77f",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/references/sdk-surface.md",
-      "sha256": "7275aedfb2338040f1b9f989765179ce970d1b25c77066b3d3f4f4e2fe39f7cc",
+      "sha256": "f19560c3232558eb692dc4ff0cee74850ebca9029f95272233e734aa3854faba",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/references/cli-commands.md",
-      "sha256": "c50bf5ec6f43bd9fb7115ea9c9eb8de33c93e123f3e2d396785fe75ba094d40d",
+      "sha256": "3a6df9f9a1311843d929c06698a87695fe8e4197d4c6ca64b2768c2990386557",
       "agentTarget": "codex"
     },
     {
@@ -23,12 +23,12 @@
     },
     {
       "path": "skills/codex/references/compile-errors.md",
-      "sha256": "22692f2fda9c7d8ef0aa54e58148d22cf740bf722ceb79a942f6f146009a6bda",
+      "sha256": "de43b81d6b9c1a065aa1905fdb469e518e50e80bf34306964593e608649f6868",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/references/authoring-workflow.md",
-      "sha256": "bf59d1550ce72fa188e50e74b7d586be49a0e5473501ee3b83a5f41687ac5163",
+      "sha256": "b078cfc3481824ed09a7445346a793a89387b0a07de500f7bb5343487ec62e58",
       "agentTarget": "codex"
     },
     {
@@ -38,12 +38,12 @@
     },
     {
       "path": "skills/codex/references/experience-design.md",
-      "sha256": "f07ed621eb1e8cdfa08abd10d5a6331c7e9d8198da422b8b4ad54d23475b2d4d",
+      "sha256": "40c5d7081f4c81cca5a7a2cfabe2e0fa8818eaabfd0214539765b70b6750d3cb",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/references/widgets-and-apps.md",
-      "sha256": "dea06536f780f0bb6d26dc63a6f1f35e2d6eb97f7a9c1c8574ed7377ccfe37a8",
+      "sha256": "853125c2bd73fcb136c3237bc4aa08faeeba8b8cc0d1ef2d0a168d4e7623ec68",
       "agentTarget": "codex"
     },
     {
@@ -53,7 +53,7 @@
     },
     {
       "path": "skills/codex/references/troubleshooting.md",
-      "sha256": "b08dc48e72fa186fc953cf7052bfb7500b4586a772a1f4c54ff1e53a29f21eb2",
+      "sha256": "0fac5c07a9707ffeb88860905f351c58b567dcae1337ea9ac044cf5df8c8afef",
       "agentTarget": "codex"
     },
     {
@@ -78,22 +78,22 @@
     },
     {
       "path": "skills/codex/examples/acme-bistro/README.md",
-      "sha256": "ad617758f117adbe5b3384c0e199c9c2d9ead856490ee4f29635436effc601aa",
+      "sha256": "d94f67f7518208cba14920c26ed8aaa1546b496d96e55645e85b5d75a1a64127",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/examples/acme-bistro/design/UX-Document.md",
-      "sha256": "11b83135ffa7291ccf3d1253e260bb1c47b406291a8999c3c072ae7884cf3df0",
+      "sha256": "b4627bbd31764f2432a408efdad3ffeba138ac5bac3ac483afbd97d33f0c37f3",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/examples/acme-bistro/design/api-contract.md",
-      "sha256": "41dace6414ebecc0926f3f3caedd43bb5dc2734c777ad93462bea72f6d55de34",
+      "sha256": "52b3a77db550ceb4126f0c3742b23606414a6b75f532f41f56c12d907949e744",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/examples/acme-bistro/design/wireframe.html",
-      "sha256": "1fe4c8327bcc91118fcc66d5e073f78a3816fe6ca01cbf544bc17888e27beb8b",
+      "sha256": "25bb48e8f2634b6c7fc0a773ca2d5c4678f11f813e96784ac4cf99cb34b84d49",
       "agentTarget": "codex"
     },
     {
@@ -113,7 +113,7 @@
     },
     {
       "path": "skills/codex/examples/acme-bistro/src/server.ts",
-      "sha256": "9599427833eefc27fcdc0eb83c26134e1a8b61f6998802e66dd6c8176c105112",
+      "sha256": "3f707b40fdf84ab2e8738367a2e0cccaf075a07aa945801ffb3a534f98ee1dcd",
       "agentTarget": "codex"
     },
     {
@@ -138,17 +138,17 @@
     },
     {
       "path": "skills/codex/examples/acme-discovery/README.md",
-      "sha256": "1ca6e3aeee967715936eeb68be05793a10bf78ecfa80050322883828310288aa",
+      "sha256": "c909d5d18a0889b44ce63cb9e02c969243be1bba85454f1181c64809b1160b97",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/examples/acme-discovery/design/UX-Document.md",
-      "sha256": "36d16c09f6593c0b3f55f6d657335635b8c7ef9f2cf00761ae0d866a855ec5a8",
+      "sha256": "186be2e58210f7dc76a3305b5b7b47357236586a8f5648c3a88f5367933dfa56",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/examples/acme-discovery/design/wireframe.html",
-      "sha256": "43a1d14693856d81af4c8976abd0102d640b649b984ba27bac1526e800c9ba51",
+      "sha256": "6b1098c755c0a4bb8d477cec40b6dbf34e12e236dc6b1a7b438ff069bd84ea18",
       "agentTarget": "codex"
     },
     {
@@ -168,7 +168,7 @@
     },
     {
       "path": "skills/codex/examples/acme-discovery/src/server.ts",
-      "sha256": "b013868ef61c9a2eb41ad963d41cc7ea321e3c1692bcb67f11b0f70c5c7d322b",
+      "sha256": "3a8d1285b375b6e650db95033af0f1cb0c8f5468a6a454e4cbcc8aaae7f6ff9d",
       "agentTarget": "codex"
     },
     {
@@ -193,17 +193,17 @@
     },
     {
       "path": "skills/codex/examples/acme-tasks/README.md",
-      "sha256": "82dcfc5151744e6f043d0bf3eb36e6ca116da52ce5d7c5a787f97fc05347618d",
+      "sha256": "f97b264bd7c696ffd8ddbba846cdcd8c2e1b0940738e94d057654b5e42d14d1a",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/examples/acme-tasks/design/UX-Document.md",
-      "sha256": "85fbcaf80877257ac80d81497f154b3c0633f515fbadd6682a6f1783aae82111",
+      "sha256": "9eb6fda14200bb7a2f67a2b2bb8b2e0b7914c98a7da8e272dc2707110f0ef027",
       "agentTarget": "codex"
     },
     {
       "path": "skills/codex/examples/acme-tasks/design/wireframe.html",
-      "sha256": "f5f486122e3cef6528c601b343b65ae1aefe066c4048c0e1ad5f80a3a421d303",
+      "sha256": "be5a9803eaaff93ee0ceb8afadc5dedf1df0c0712fc32b226c441b6d310af39e",
       "agentTarget": "codex"
     },
     {
@@ -223,7 +223,7 @@
     },
     {
       "path": "skills/codex/examples/acme-tasks/src/server.ts",
-      "sha256": "a83668cf5226faca41ac2ada928c44c27d488f9d3cdc3b6ab08dde15ab7aabda",
+      "sha256": "3876daf95af0e55d245e641b5e91a7cdd40bdccb6a4f0bd50c65a462ac98d37d",
       "agentTarget": "codex"
     },
     {
@@ -268,7 +268,7 @@
     },
     {
       "path": "skills/codex/examples/food-ordering/src/server.ts",
-      "sha256": "491e7e7e8289d4295d09ca2a5f7035f00a06e1d9f3349c406397f90a966269df",
+      "sha256": "1b1329c99af4798072b69979f1f0861c3b3587b237df46d3cf7b923060f134cb",
       "agentTarget": "codex"
     },
     {
@@ -348,17 +348,17 @@
     },
     {
       "path": "skills/claude-code/SKILL.md",
-      "sha256": "24cdedbf4db8484b6e06823037b5b8fd0ef7ee39a57eb0fd135d167196fea3ff",
+      "sha256": "09ceee39251194a1528986cc7df57970218e865646779ce01e98872ccadfaffd",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/references/sdk-surface.md",
-      "sha256": "7275aedfb2338040f1b9f989765179ce970d1b25c77066b3d3f4f4e2fe39f7cc",
+      "sha256": "f19560c3232558eb692dc4ff0cee74850ebca9029f95272233e734aa3854faba",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/references/cli-commands.md",
-      "sha256": "c50bf5ec6f43bd9fb7115ea9c9eb8de33c93e123f3e2d396785fe75ba094d40d",
+      "sha256": "3a6df9f9a1311843d929c06698a87695fe8e4197d4c6ca64b2768c2990386557",
       "agentTarget": "claude-code"
     },
     {
@@ -368,12 +368,12 @@
     },
     {
       "path": "skills/claude-code/references/compile-errors.md",
-      "sha256": "22692f2fda9c7d8ef0aa54e58148d22cf740bf722ceb79a942f6f146009a6bda",
+      "sha256": "de43b81d6b9c1a065aa1905fdb469e518e50e80bf34306964593e608649f6868",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/references/authoring-workflow.md",
-      "sha256": "bf59d1550ce72fa188e50e74b7d586be49a0e5473501ee3b83a5f41687ac5163",
+      "sha256": "b078cfc3481824ed09a7445346a793a89387b0a07de500f7bb5343487ec62e58",
       "agentTarget": "claude-code"
     },
     {
@@ -383,12 +383,12 @@
     },
     {
       "path": "skills/claude-code/references/experience-design.md",
-      "sha256": "f07ed621eb1e8cdfa08abd10d5a6331c7e9d8198da422b8b4ad54d23475b2d4d",
+      "sha256": "40c5d7081f4c81cca5a7a2cfabe2e0fa8818eaabfd0214539765b70b6750d3cb",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/references/widgets-and-apps.md",
-      "sha256": "dea06536f780f0bb6d26dc63a6f1f35e2d6eb97f7a9c1c8574ed7377ccfe37a8",
+      "sha256": "853125c2bd73fcb136c3237bc4aa08faeeba8b8cc0d1ef2d0a168d4e7623ec68",
       "agentTarget": "claude-code"
     },
     {
@@ -398,7 +398,7 @@
     },
     {
       "path": "skills/claude-code/references/troubleshooting.md",
-      "sha256": "b08dc48e72fa186fc953cf7052bfb7500b4586a772a1f4c54ff1e53a29f21eb2",
+      "sha256": "0fac5c07a9707ffeb88860905f351c58b567dcae1337ea9ac044cf5df8c8afef",
       "agentTarget": "claude-code"
     },
     {
@@ -423,22 +423,22 @@
     },
     {
       "path": "skills/claude-code/examples/acme-bistro/README.md",
-      "sha256": "ad617758f117adbe5b3384c0e199c9c2d9ead856490ee4f29635436effc601aa",
+      "sha256": "d94f67f7518208cba14920c26ed8aaa1546b496d96e55645e85b5d75a1a64127",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/examples/acme-bistro/design/UX-Document.md",
-      "sha256": "11b83135ffa7291ccf3d1253e260bb1c47b406291a8999c3c072ae7884cf3df0",
+      "sha256": "b4627bbd31764f2432a408efdad3ffeba138ac5bac3ac483afbd97d33f0c37f3",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/examples/acme-bistro/design/api-contract.md",
-      "sha256": "41dace6414ebecc0926f3f3caedd43bb5dc2734c777ad93462bea72f6d55de34",
+      "sha256": "52b3a77db550ceb4126f0c3742b23606414a6b75f532f41f56c12d907949e744",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/examples/acme-bistro/design/wireframe.html",
-      "sha256": "1fe4c8327bcc91118fcc66d5e073f78a3816fe6ca01cbf544bc17888e27beb8b",
+      "sha256": "25bb48e8f2634b6c7fc0a773ca2d5c4678f11f813e96784ac4cf99cb34b84d49",
       "agentTarget": "claude-code"
     },
     {
@@ -458,7 +458,7 @@
     },
     {
       "path": "skills/claude-code/examples/acme-bistro/src/server.ts",
-      "sha256": "9599427833eefc27fcdc0eb83c26134e1a8b61f6998802e66dd6c8176c105112",
+      "sha256": "3f707b40fdf84ab2e8738367a2e0cccaf075a07aa945801ffb3a534f98ee1dcd",
       "agentTarget": "claude-code"
     },
     {
@@ -483,17 +483,17 @@
     },
     {
       "path": "skills/claude-code/examples/acme-discovery/README.md",
-      "sha256": "1ca6e3aeee967715936eeb68be05793a10bf78ecfa80050322883828310288aa",
+      "sha256": "c909d5d18a0889b44ce63cb9e02c969243be1bba85454f1181c64809b1160b97",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/examples/acme-discovery/design/UX-Document.md",
-      "sha256": "36d16c09f6593c0b3f55f6d657335635b8c7ef9f2cf00761ae0d866a855ec5a8",
+      "sha256": "186be2e58210f7dc76a3305b5b7b47357236586a8f5648c3a88f5367933dfa56",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/examples/acme-discovery/design/wireframe.html",
-      "sha256": "43a1d14693856d81af4c8976abd0102d640b649b984ba27bac1526e800c9ba51",
+      "sha256": "6b1098c755c0a4bb8d477cec40b6dbf34e12e236dc6b1a7b438ff069bd84ea18",
       "agentTarget": "claude-code"
     },
     {
@@ -513,7 +513,7 @@
     },
     {
       "path": "skills/claude-code/examples/acme-discovery/src/server.ts",
-      "sha256": "b013868ef61c9a2eb41ad963d41cc7ea321e3c1692bcb67f11b0f70c5c7d322b",
+      "sha256": "3a8d1285b375b6e650db95033af0f1cb0c8f5468a6a454e4cbcc8aaae7f6ff9d",
       "agentTarget": "claude-code"
     },
     {
@@ -538,17 +538,17 @@
     },
     {
       "path": "skills/claude-code/examples/acme-tasks/README.md",
-      "sha256": "82dcfc5151744e6f043d0bf3eb36e6ca116da52ce5d7c5a787f97fc05347618d",
+      "sha256": "f97b264bd7c696ffd8ddbba846cdcd8c2e1b0940738e94d057654b5e42d14d1a",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/examples/acme-tasks/design/UX-Document.md",
-      "sha256": "85fbcaf80877257ac80d81497f154b3c0633f515fbadd6682a6f1783aae82111",
+      "sha256": "9eb6fda14200bb7a2f67a2b2bb8b2e0b7914c98a7da8e272dc2707110f0ef027",
       "agentTarget": "claude-code"
     },
     {
       "path": "skills/claude-code/examples/acme-tasks/design/wireframe.html",
-      "sha256": "f5f486122e3cef6528c601b343b65ae1aefe066c4048c0e1ad5f80a3a421d303",
+      "sha256": "be5a9803eaaff93ee0ceb8afadc5dedf1df0c0712fc32b226c441b6d310af39e",
       "agentTarget": "claude-code"
     },
     {
@@ -568,7 +568,7 @@
     },
     {
       "path": "skills/claude-code/examples/acme-tasks/src/server.ts",
-      "sha256": "a83668cf5226faca41ac2ada928c44c27d488f9d3cdc3b6ab08dde15ab7aabda",
+      "sha256": "3876daf95af0e55d245e641b5e91a7cdd40bdccb6a4f0bd50c65a462ac98d37d",
       "agentTarget": "claude-code"
     },
     {
@@ -613,7 +613,7 @@
     },
     {
       "path": "skills/claude-code/examples/food-ordering/src/server.ts",
-      "sha256": "491e7e7e8289d4295d09ca2a5f7035f00a06e1d9f3349c406397f90a966269df",
+      "sha256": "1b1329c99af4798072b69979f1f0861c3b3587b237df46d3cf7b923060f134cb",
       "agentTarget": "claude-code"
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noodleseed/agent-kit",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "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.17.0
+version: 0.19.0
 hash: b4952708b1c38f55
 ---
 

package/skills/claude-code/examples/acme-bistro/README.md

@@ -3,7 +3,7 @@
 A Noodle MCP App for **Acme Bistro**, a fictional restaurant. It is the flagship for the **end-to-end
 transaction** pattern: the customer browses the menu and builds the order *in chat*, and the order
 completes in chat — only **payment** hands off, via a signed checkout deep link (the card never touches
-the app). It pairs a `toolWithWidget` menu/cart with `toolForWidget` cart helpers and a model-visible
+the app). It pairs a view-backed `tool` menu/cart with app-only `tool` cart helpers and a model-visible
 `create_checkout` tool backed by `handoff.allowedDomains`.
 
 Capability slot: **end-to-end in-chat transaction + payment-only handoff**, plus a worked **design-first**

package/skills/claude-code/examples/acme-bistro/design/UX-Document.md

@@ -204,7 +204,7 @@ APP:  [tool: create_checkout {customer:"Guest",
 
 ## 5. UI Widget Specifications
 
-> The widget is authored as a Noodle Seed React `view` (`toolWithWidget` → `MenuCart`), styled with **vanilla CSS cascade layers** so it inherits the host's light/dark theme and adapts to ChatGPT's surface. Compliance is verified with `noodle check --target chatgpt`.
+> The widget is authored as a Noodle Seed React `view` (`tool` → `MenuCart`), styled with **vanilla CSS cascade layers** so it inherits the host's light/dark theme and adapts to ChatGPT's surface. Compliance is verified with `noodle check --target chatgpt`.
 
 ### 5.1 Design System Compliance
 
@@ -250,20 +250,20 @@ Modes deliberately **not** used: no Carousel (a single flat menu doesn't need on
 
 ## 6. Tool Definitions (App Backend)
 
-### ★ Tool 1: `show_menu` — `toolWithWidget`
+### ★ Tool 1: `show_menu` — `tool`
 **Input:** `{ customer?: string = "Guest" }`
 **Output:** `{ status, customer, items[] }` where each item is `{ id, name, price, kind }`.
 **Renders:** the `MenuCart` widget.
 **Annotations:** read-only.
 **Triggers:** any menu / ordering intent ("show me Acme's menu", "order from Acme").
 
-### Tool 2: `add_to_cart` — `toolForWidget`
+### Tool 2: `add_to_cart` — `tool`
 **Input:** `{ customer?, item: <menu id> = "stone_pizza", quantity?: int ≥1 = 1, notes?: string }`
 **Output:** `{ status, item, quantity, notes }`.
 **Annotations:** local write (non-destructive).
 **Triggers:** natural-language additions ("add two margheritas", "and a lemon tart"). Widget-facing helper — reflects NL selections into the visible cart.
 
-### Tool 3: `remove_from_cart` — `toolForWidget`
+### Tool 3: `remove_from_cart` — `tool`
 **Input:** `{ customer?, item: <menu id> = "stone_pizza" }`
 **Output:** `{ status, item }`.
 **Annotations:** local write (non-destructive).

package/skills/claude-code/examples/acme-bistro/design/api-contract.md

@@ -8,9 +8,9 @@ The app maps to four tools:
 
 | Tool | Kind | Job |
 |------|------|-----|
-| `show_menu` | `toolWithWidget` (read-only) | Return the menu + render the `MenuCart` widget |
-| `add_to_cart` | `toolForWidget` (local write) | Reflect a natural-language addition into the visible cart |
-| `remove_from_cart` | `toolForWidget` (local write) | Remove one unit of an item |
+| `show_menu` | `tool` (read-only) | Return the menu + render the `MenuCart` widget |
+| `add_to_cart` | `tool` (local write) | Reflect a natural-language addition into the visible cart |
+| `remove_from_cart` | `tool` (local write) | Remove one unit of an item |
 | `create_checkout` | model-visible `tool` (open-link) | Mint the signed, expiring payment link |
 
 Menu item IDs are the stable enum: `stone_pizza`, `roast_bowl`, `house_salad`, `lemon_tart`, `sparkling`.

package/skills/claude-code/examples/acme-bistro/design/wireframe.html

@@ -496,13 +496,13 @@
       <div class="api-panel-header">Browse &amp; Build (Steps 1–3)</div>
       <div class="api-step">
         <div class="api-step-label">Step 1 — Show the menu</div>
-        <div class="api-endpoint"><span class="kind read">READ</span><span class="path">show_menu</span><span class="desc">— toolWithWidget. Returns the 5-item menu and renders MenuCart.</span></div>
+        <div class="api-endpoint"><span class="kind read">READ</span><span class="path">show_menu</span><span class="desc">— tool + view. Returns the 5-item menu and renders MenuCart.</span></div>
         <div class="api-note"><strong>Design intent:</strong> the menu is small and static, so it ships in one read — no pagination, no follow-up call. The <code>items[]</code> array is the model's only source of dish names and prices.</div>
       </div>
       <div class="api-step">
         <div class="api-step-label">Steps 2–3 — Build &amp; edit the cart</div>
-        <div class="api-endpoint"><span class="kind write">WRITE</span><span class="path">add_to_cart</span><span class="desc">— toolForWidget. Reflects a natural-language addition (item + quantity) into the visible cart.</span></div>
-        <div class="api-endpoint"><span class="kind write">WRITE</span><span class="path">remove_from_cart</span><span class="desc">— toolForWidget. Removes one unit; the widget's − button calls the same tool.</span></div>
+        <div class="api-endpoint"><span class="kind write">WRITE</span><span class="path">add_to_cart</span><span class="desc">— tool + app visibility. Reflects a natural-language addition (item + quantity) into the visible cart.</span></div>
+        <div class="api-endpoint"><span class="kind write">WRITE</span><span class="path">remove_from_cart</span><span class="desc">— tool + app visibility. Removes one unit; the widget's − button calls the same tool.</span></div>
         <div class="api-note"><strong>Natural-language parsing:</strong> "two margheritas and a lemon tart" becomes <code>add_to_cart{item:"stone_pizza",quantity:2}</code> + <code>add_to_cart{item:"lemon_tart",quantity:1}</code> — the model fills the fields; no UI round-trip. The running total is summed live in the widget (React), not in a tool.</div>
       </div>
     </div>

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

@@ -1,4 +1,4 @@
-import { annotations, server, tool, toolForWidget, toolWithWidget, z } from '@noodleseed/one';
+import { annotations, server, tool, z } from '@noodleseed/one';
 
 // Acme Bistro is a fictional restaurant. This app is deliberately END-TO-END: the customer browses the
 // menu and builds the order in chat, and the order completes in chat — only *payment* hands off, via a
@@ -52,7 +52,7 @@ export default server(
     },
   },
   [
-    toolWithWidget('show_menu', {
+    tool('show_menu', {
       description: 'Show the Acme Bistro menu and render the ordering widget.',
       annotations: readOnly,
       input: z.object({ customer: z.string().default('Guest') }),
@@ -66,8 +66,8 @@ export default server(
         customer: input.customer,
         items: menu,
       }),
-      widgetTitle: 'Order at Acme Bistro',
-      widgetDescription: 'Browse the menu, build an order in chat, and hand off to pay.',
+      viewTitle: 'Order at Acme Bistro',
+      viewDescription: 'Browse the menu, build an order in chat, and hand off to pay.',
       invoking: 'Loading the menu…',
       invoked: 'Menu ready',
       domain: 'https://order.acme.example',
@@ -82,7 +82,8 @@ export default server(
       },
     }),
     // Widget-only cart edits — the model fills the item from natural language ("add two margheritas").
-    toolForWidget('add_to_cart', {
+    tool('add_to_cart', {
+      visibility: ['app'],
       description: 'Add a menu item to the Acme Bistro order from the widget.',
       annotations: localWrite,
       input: z.object({
@@ -104,7 +105,8 @@ export default server(
         notes: input.notes,
       }),
     }),
-    toolForWidget('remove_from_cart', {
+    tool('remove_from_cart', {
+      visibility: ['app'],
       description: 'Remove a menu item from the Acme Bistro order.',
       annotations: localWrite,
       input: z.object({

package/skills/claude-code/examples/acme-discovery/README.md

@@ -3,7 +3,7 @@
 A Noodle MCP App for **Acme Getaways**, a fictional travel brand. It is the flagship for the
 **top-of-funnel discovery → handoff** pattern: discovery and configuration happen inside ChatGPT; the
 booking/transaction happens off-app on Acme's own site, reached through a signed, attributable handoff
-deep link. It pairs a `toolWithWidget` discovery carousel with a model-visible `create_handoff` tool and
+deep link. It pairs a `tool` discovery carousel with a model-visible `create_handoff` tool and
 server-level `handoff.allowedDomains`.
 
 Capability slots: top-of-funnel funnel discipline, discovery carousel widget, `create_handoff` deep-link

package/skills/claude-code/examples/acme-discovery/design/UX-Document.md

@@ -202,7 +202,7 @@ Inside the widget, **Continue on Acme** calls `create_handoff(destination="coral
 
 ## 5. UI Widget Specifications (OpenAI Apps SDK Compliant)
 
-> The app has **one** widget, `DiscoveryCarousel`, authored as a React `view` on the `discover_getaways` `toolWithWidget`. It follows the OpenAI Apps SDK UI Guidelines (system fonts, monochrome outlined icons, WCAG AA, ≤2 actions per card, no nested scroll). Styling uses Noodle Seed's server-level `branding` tokens and CSS cascade layers — not app-specific global CSS. Acme's accent teal is restricted to the primary CTA, the logo mark, and the "Shortlisted" state only.
+> The app has **one** widget, `DiscoveryCarousel`, authored as a React `view` on the `discover_getaways` `tool`. It follows the OpenAI Apps SDK UI Guidelines (system fonts, monochrome outlined icons, WCAG AA, ≤2 actions per card, no nested scroll). Styling uses Noodle Seed's server-level `branding` tokens and CSS cascade layers — not app-specific global CSS. Acme's accent teal is restricted to the primary CTA, the logo mark, and the "Shortlisted" state only.
 
 ### 5.1 Design System Compliance
 
@@ -378,8 +378,8 @@ The demo's arc: *a vague mood → four real, priced, reasoned getaways → one s
 ```
 ChatGPT ──tool calls──►  Noodle Seed runtime (server 'acme_discovery')
                               │  app-owned curated catalog (static data)
-                              ├──► discover_getaways   (toolWithWidget → DiscoveryCarousel)
-                              ├──► shortlist_getaway    (toolForWidget, local write)
+                              ├──► discover_getaways   (tool → DiscoveryCarousel)
+                              ├──► shortlist_getaway    (tool, local write)
                               ├──► create_handoff       (open-link → signed Acme deep link)
                               └──► React view bundle (DiscoveryCarousel, branding tokens, CSP)
                                              │

package/skills/claude-code/examples/acme-discovery/design/wireframe.html

@@ -585,14 +585,14 @@
       <div class="api-step">
         <div class="an">1</div>
         <div class="ac">
-          <div class="tool">discover_getaways<span class="kind">toolWithWidget</span></div>
+          <div class="tool">discover_getaways<span class="kind">tool + view</span></div>
           <div class="api-note">In <code>{ vibe, month, travelers }</code> → out <code>{ status, vibe, month, travelers, options[] }</code> and renders <code>DiscoveryCarousel</code>. Returns the <strong>full curated catalog verbatim</strong> (4 destinations); the model narrates fit. Host status: "Finding getaways…" → "Getaways ready". <code>read-only</code>.</div>
         </div>
       </div>
       <div class="api-step">
         <div class="an">2</div>
         <div class="ac">
-          <div class="tool">shortlist_getaway<span class="kind">toolForWidget</span></div>
+          <div class="tool">shortlist_getaway<span class="kind">tool + app visibility</span></div>
           <div class="api-note">In <code>{ destination, note }</code> → out <code>{ status, destination, note }</code>. Called from inside the carousel when a card's <strong>Shortlist</strong> is tapped; updates widget view-state. <code>local-action</code>, non-destructive — not a booking.</div>
         </div>
       </div>

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

@@ -1,4 +1,4 @@
-import { annotations, server, tool, toolForWidget, toolWithWidget, z } from '@noodleseed/one';
+import { annotations, server, tool, z } from '@noodleseed/one';
 
 // Acme Getaways is a fictional travel brand. This app is deliberately top-of-funnel: discovery and
 // configuration happen inside ChatGPT; the booking/transaction happens off-app on Acme's own site,
@@ -115,7 +115,7 @@ export default server(
     },
   },
   [
-    toolWithWidget('discover_getaways', {
+    tool('discover_getaways', {
       description:
         'Suggest Acme Getaways destinations for a vibe and month and render a discovery carousel.',
       annotations: readOnly,
@@ -136,7 +136,7 @@ export default server(
         travelers: input.travelers,
         options: catalog,
       }),
-      widgetTitle: 'Discover getaways',
+      viewTitle: 'Discover getaways',
       // ChatGPT host status copy (openai/toolInvocation/*) — required for widget-opening tools.
       invoking: 'Finding getaways…',
       invoked: 'Getaways ready',
@@ -145,7 +145,7 @@ export default server(
         component: 'discovery-carousel',
         entry: './views/discovery-carousel.tsx',
       },
-      widgetDescription:
+      viewDescription:
         'A top-of-funnel discovery carousel: pick a destination, then hand off to Acme to book.',
       csp: {
         connectDomains: ['https://acme.example'],
@@ -180,7 +180,8 @@ export default server(
         handoffUrl: `https://book.acme.example/plan?dest=${input.destination}&month=${input.month}&pax=${input.travelers}&src=chatgpt`,
       }),
     }),
-    toolForWidget('shortlist_getaway', {
+    tool('shortlist_getaway', {
+      visibility: ['app'],
       description: 'Record the traveler’s shortlisted destination from the discovery widget.',
       annotations: localWrite,
       input: z.object({

package/skills/claude-code/examples/acme-tasks/README.md

@@ -7,7 +7,7 @@ in one `TaskList` widget. It shows the "identify and prioritize the flows first,
 the `noodle-seed` skill's `references/experience-design.md` teaches.
 
 Capability slots: prioritized multi-flow app design, a two-way (read + write) in-chat pattern, a task-list
-widget with `toolForWidget` helpers, and a worked **design-first** artifact (the flow spec + wireframe
+widget with `tool` helpers, and a worked **design-first** artifact (the flow spec + wireframe
 below). A real deployment would connect the user's account with the end-user auth pattern — see
 [`../customer-auth/README.md`](../customer-auth/README.md); this example seeds a list so the focus stays
 on the flows.
@@ -76,5 +76,31 @@ noodle deploy --access owner-only
 noodle open
 ```
 
+## Optional in-product assistant
+
+The same task tools can also sit inside Acme's authenticated web app. Add an `assistant` option to this
+server without creating a second tool set:
+
+```ts
+assistant: embeddedAssistant({
+  model: openAICompatible({
+    baseUrl: variable('ASSISTANT_MODEL_BASE_URL'),
+    model: variable('ASSISTANT_MODEL'),
+    apiKey: secret('ASSISTANT_MODEL_API_KEY'),
+  }),
+  allowedOrigins: ['https://tasks.example.com'],
+  layout: { mode: 'floating', position: 'bottom-right' },
+  labels: { welcomeHeading: 'How can I help with Acme Tasks?' },
+}),
+```
+
+The assistant automatically inherits this server's existing `branding` block, so its name, accent,
+light/dark surfaces, density, and radius match the `TaskList` widget without a second brand declaration.
+
+The customer backend exchanges its authenticated user through `@noodleseed/assistant/server`; the browser
+uses the Web Component or React wrapper and never receives the embed client or model secret. Validate with
+`noodle check --target embedded-assistant`, then create the backend credential with
+`noodle assistant clients create` after deployment.
+
 This example has no connector secrets and does not include tokens, caller-key mechanisms, or
 `.env.noodle` values. All tasks are fictional seed data.

package/skills/claude-code/examples/acme-tasks/design/UX-Document.md

@@ -155,7 +155,7 @@ All tools are atomic, model-fillable from natural language, and each returns a s
 **★ `list_today`** *(read-only · renders `TaskList`)*
 - **Input:** `{ focus: string = "today" }`
 - **Output:** `{ status, focus, tasks: [{ id, title, priority, done }] }`
-- **Notes:** `toolWithWidget` — the one tool that opens the widget. Host status copy: invoking "Loading your tasks…", invoked "Tasks ready".
+- **Notes:** `tool` — the one tool that opens the widget. Host status copy: invoking "Loading your tasks…", invoked "Tasks ready".
 
 **★ `add_task`** *(local write, non-destructive · model-visible)*
 - **Input:** `{ title: string, priority: "high"|"medium"|"low" = "medium" }`
@@ -170,7 +170,7 @@ All tools are atomic, model-fillable from natural language, and each returns a s
 **`set_priority`** *(local write, non-destructive · widget-only)*
 - **Input:** `{ task: string (id), priority: "high"|"medium"|"low" }`
 - **Output:** `{ status, task, priority }`
-- **Notes:** `toolForWidget` — hidden from the model; the `<select>` in `TaskList` is its only caller, keeping the model's tool surface to the three it should reason about.
+- **Notes:** `tool` — hidden from the model; the `<select>` in `TaskList` is its only caller, keeping the model's tool surface to the three it should reason about.
 
 ---