@noodleseed/agent-kit 0.16.0 → 0.18.0

package/skills/claude-code/references/widgets-and-apps.md

@@ -12,7 +12,7 @@
 
 ## Tools and views
 
-Use `toolWithWidget(name, { description, input, output, fulfil, view })` for a model-visible tool that renders a widget, and `toolForWidget(name, { ... })` for a widget-only helper hidden from the model. A `view` is `{ component: "name", entry: "./views/name.tsx" }` — a React component the compiler bundles at validate/deploy time.
+Use `tool(name, { description, input, output, fulfil, view })` for a model-visible tool that renders a widget, and the same `tool(name, { ..., visibility: ["app"] })` for an app-only helper hidden from the model. A `view` is `{ component: "name", entry: "./views/name.tsx" }` — a React component the compiler bundles at validate/deploy time.
 
 ## React hook surface
 
@@ -21,7 +21,7 @@ Author views as React components. `generateHelpers<ServerDefinition>()` (from `@
 | Hook | Use for |
 | :-- | :-- |
 | `useToolInfo` | Read the invoking tool result; `structuredContent` is the widget’s typed data payload. |
-| `useCallTool` | Call a tool from the widget — returns `{ status, callTool, callToolAsync, data, structuredContent, error, reset }`; target a model-visible tool or a hidden `toolForWidget` helper. |
+| `useCallTool` | Call a tool from the widget — returns `{ status, callTool, callToolAsync, data, structuredContent, error, reset }`; target a model-visible tool or a hidden `tool` helper. |
 | `useViewState` | Persist per-widget UI state across re-renders and restores: `const [value, setValue] = useViewState("key", initial)`. |
 | `useLayout` | Read host layout: `{ theme, displayMode, locale?, host?, supports? }` (`displayMode` is `"inline"`/`"pip"`/`"fullscreen"`) — adapt styling to the host theme and mode. |
 | `useRequestDisplayMode` | Request a host-mediated layout change such as fullscreen; treat it as best-effort and keep inline rendering useful. |
@@ -94,10 +94,10 @@ export default function OrderStatus() {
 
 ### 2. The tool declaration
 
-`toolWithWidget` is the model-visible tool that renders the view; pair it with `toolForWidget` helpers the view calls (hidden from the model). Wire `view: { component, entry }`, `csp`, a widget `domain`, and a real `output` schema so non-Apps hosts still receive structured data. Inside `fulfil`, `input` is a symbolic ref recorded into a flow — reference it in output/template strings, but never use it as an object key or `if` condition.
+`tool` declares both the model-visible tool that renders the view and app-only helpers the view calls. Put `visibility: ["app"]` on each helper. Wire `view: { component, entry }`, `csp`, a widget `domain`, and a real `output` schema so non-Apps hosts still receive structured data. Inside `fulfil`, `input` is a symbolic ref recorded into a flow — reference it in output/template strings, but never use it as an object key or `if` condition.
 
 ```ts
-import { annotations, server, toolForWidget, toolWithWidget, z } from '@noodleseed/one';
+import { annotations, server, tool, z } from '@noodleseed/one';
 
 const item = z.enum(['falafel_wrap', 'lentil_soup', 'mint_lemonade']).default('falafel_wrap');
 const checkoutUrl = (customer: string) =>
@@ -112,7 +112,7 @@ export default server(
     handoff: { allowedDomains: ['https://orders.example.com'] },
   },
   [
-    toolWithWidget('show_order', {
+    tool('show_order', {
       description: 'Show the pickup order and render the ordering widget.',
       // Declare tool annotations — a ChatGPT-submission requirement. A read → `readOnly()`.
       annotations: annotations.readOnly(),
@@ -129,8 +129,8 @@ export default server(
         total: 12,
         checkoutUrl: checkoutUrl(input.customer),
       }),
-      widgetTitle: 'Pickup order',
-      widgetDescription: 'Pick an item and place a pickup order.',
+      viewTitle: 'Pickup order',
+      viewDescription: 'Pick an item and place a pickup order.',
       // A ChatGPT App is this widget + a domain: one https origin per app.
       domain: 'https://pickup.example.com',
       view: { component: 'order-status', entry: './views/order-status.tsx' },
@@ -142,7 +142,8 @@ export default server(
       },
     }),
     // Widget-only helper the view calls with useCallTool('place_order'); hidden from the model.
-    toolForWidget('place_order', {
+    tool('place_order', {
+      visibility: ['app'],
       description: 'Place a pickup order from the widget.',
       // A write that reaches the outside world → `action()` (not read-only, not destructive).
       annotations: annotations.action(),

package/skills/codex/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.16.0
+version: 0.18.0
 hash: 39c6a606c728d164
 ---
 

package/skills/codex/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/codex/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/codex/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/codex/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/codex/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/codex/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/codex/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/codex/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/codex/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/codex/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,34 @@ 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'],
+  appearance: {
+    brand: { name: 'Acme Tasks Assistant' },
+    theme: {
+      defaultMode: 'auto',
+      light: { accent: '#3157D5' },
+      dark: { accent: '#9FB4FF' },
+    },
+  },
+}),
+```
+
+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/codex/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.
 
 ---
 

package/skills/codex/examples/acme-tasks/design/wireframe.html

@@ -217,7 +217,7 @@
     <div class="rationale">
       <h4>How to read these wireframes</h4>
       <p>Solid-border phones are the <strong>in-ChatGPT app</strong>. Acme Tasks is a <strong>two-way (read + write) app</strong>, not a discovery funnel: every widget reflects the user's real list, and each action — capture, re-prioritize, complete — is <strong>recorded through a tool call</strong> and confirmed in-chat. The single dashed phone is the <strong>one-time account link</strong> (<span class="mono">customerAuth</span>); there is no transactional off-app step.</p>
-      <p>Widgets are built with the Noodle Seed authoring SDK — <span class="mono">toolWithWidget</span> renders <span class="mono">TaskList</span>; <span class="mono">toolForWidget</span> powers the in-widget re-prioritize. Styling uses host/Noodle Seed semantic tokens via CSS cascade layers; the brand accent (<span class="mono">#7C3AED</span>) is reserved for the logo, checks, primary CTA and <em>high</em> emphasis. Priority uses fixed semantic colors: high red · medium amber · low slate.</p>
+      <p>Widgets are built with the Noodle Seed authoring SDK — <span class="mono">tool + view</span> renders <span class="mono">TaskList</span>; <span class="mono">tool + app visibility</span> powers the in-widget re-prioritize. Styling uses host/Noodle Seed semantic tokens via CSS cascade layers; the brand accent (<span class="mono">#7C3AED</span>) is reserved for the logo, checks, primary CTA and <em>high</em> emphasis. Priority uses fixed semantic colors: high red · medium amber · low slate.</p>
       <p><span class="r-tag ux">UX</span> flow rationale &nbsp; <span class="r-tag ui">UI</span> interface rationale &nbsp; <span class="r-tag acme">ACME</span> product-model fit &nbsp; <span class="r-tag trust">TRUST</span> write-safety / grounding guardrail</p>
     </div>
   </div>
@@ -401,11 +401,11 @@
   <div class="section" id="prioritize">
     <span class="section-label">Flow 2 · the hub</span>
     <h2 class="section-title">Prioritize — read the day, then re-order it in place</h2>
-    <p class="section-subtitle"><span class="mono">list_today</span> renders the grounded list, highest priority first; the per-row priority control (a <span class="mono">toolForWidget</span> helper hidden from the model) lets the user re-rank without describing the task twice. This is the widget the other two flows write into.</p>
+    <p class="section-subtitle"><span class="mono">list_today</span> renders the grounded list, highest priority first; the per-row priority control (a <span class="mono">tool + app visibility</span> helper hidden from the model) lets the user re-rank without describing the task twice. This is the widget the other two flows write into.</p>
     <div class="rationale">
       <h4>Why it's built this way</h4>
       <p><span class="r-tag ux">UX</span> "What's on my plate?" wants an answer <em>and</em> a next move. The list is grouped high → low so the triager sees the real order at a glance and adjusts with one tap.</p>
-      <p><span class="r-tag acme">ACME</span> Re-prioritize is <span class="mono">set_priority</span> as <span class="mono">toolForWidget</span> — <strong>widget-only</strong>, hidden from the model's tool surface. The model reasons about three tools (list, add, complete); the fourth is pure UI plumbing, keeping the model's choices clean.</p>
+      <p><span class="r-tag acme">ACME</span> Re-prioritize is <span class="mono">set_priority</span> as <span class="mono">tool + app visibility</span> — <strong>widget-only</strong>, hidden from the model's tool surface. The model reasons about three tools (list, add, complete); the fourth is pure UI plumbing, keeping the model's choices clean.</p>
       <p><span class="r-tag trust">TRUST</span> The list only ever shows tasks that exist — the app never invents a task or a priority. Every re-rank echoes a confirmation ("Set review_pr to high priority").</p>
     </div>
     <div class="phones-row">
@@ -543,7 +543,7 @@
   <div class="section" id="api">
     <span class="section-label">Technical appendix</span>
     <h2 class="section-title">MCP tools &amp; call sequence</h2>
-    <p class="section-subtitle">The four tools behind the flows. <span class="mono">list_today</span> is the only widget-opening tool (<span class="mono">toolWithWidget</span>); <span class="mono">set_priority</span> is widget-only (<span class="mono">toolForWidget</span>, hidden from the model); <span class="mono">add_task</span> and <span class="mono">complete_task</span> are model-visible.</p>
+    <p class="section-subtitle">The four tools behind the flows. <span class="mono">list_today</span> is the only widget-opening tool (<span class="mono">tool + view</span>); <span class="mono">set_priority</span> is widget-only (<span class="mono">tool + app visibility</span>, hidden from the model); <span class="mono">add_task</span> and <span class="mono">complete_task</span> are model-visible.</p>
 
     <div class="api-panel">
       <h4>Read &amp; render (Flow 2 · the hub)</h4>
@@ -559,7 +559,7 @@
 
     <div class="api-panel">
       <h4>Prioritize (Flow 2 helper) &amp; Complete (Flow 3)</h4>
-      <div class="api-step"><span class="verb">WRITE</span><span><span class="tname">set_priority</span> — returns { status, task, priority } · toolForWidget, hidden from the model</span></div>
+      <div class="api-step"><span class="verb">WRITE</span><span><span class="tname">set_priority</span> — returns { status, task, priority } · tool + app visibility, hidden from the model</span></div>
       <div class="api-note">Input <span class="mono">{ task:id, priority }</span>. Called only by the priority ▾ in TaskList — keeps the model's tool surface to the three it should reason about.</div>
       <div class="api-step"><span class="verb">WRITE</span><span><span class="tname">complete_task</span> — returns { status, task } · model-visible</span></div>
       <div class="api-note">Input <span class="mono">{ task:id, title:"" }</span>. Model-visible so "I finished X" completes directly; local non-destructive write, confirmed with the remaining count.</div>
@@ -596,7 +596,7 @@
 
 <div class="footer">
   Acme Tasks × ChatGPT — Two-Way App Wireframes · Noodle Seed · v1 · July 2026<br>
-  Illustrative wireframes for a fictional app. Built with the Noodle Seed authoring SDK (toolWithWidget / toolForWidget · customerAuth). This flagship seeds the task list; a production deployment connects the user's account. Task data shown is sample content.
+  Illustrative wireframes for a fictional app. Built with the Noodle Seed authoring SDK (tool + view / tool + app visibility · customerAuth). This flagship seeds the task list; a production deployment connects the user's account. Task data shown is sample content.
 </div>
 
 </body>

package/skills/codex/examples/acme-tasks/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 Tasks is a fictional productivity app. It is a two-way (read + write) experience rather than a
 // top-of-funnel handoff: the top-3 prioritized user flows all complete in chat — Capture, Prioritize,
@@ -52,7 +52,7 @@ export default server(
   },
   [
     // Flow 2 — Prioritize / Today: render the list so the human triages and the model can speak to it.
-    toolWithWidget('list_today', {
+    tool('list_today', {
       description: 'Show today’s Acme Tasks and render the task-list widget.',
       annotations: readOnly,
       input: z.object({ focus: z.string().default('today') }),
@@ -66,8 +66,8 @@ export default server(
         focus: input.focus,
         tasks: today,
       }),
-      widgetTitle: 'Today’s tasks',
-      widgetDescription: 'A prioritized task list: capture, re-prioritize, and complete in place.',
+      viewTitle: 'Today’s tasks',
+      viewDescription: 'A prioritized task list: capture, re-prioritize, and complete in place.',
       // ChatGPT host status copy (openai/toolInvocation/*) — required for widget-opening tools.
       invoking: 'Loading your tasks…',
       invoked: 'Tasks ready',
@@ -119,7 +119,8 @@ export default server(
       }),
     }),
     // Flow 2 helper (widget-only): re-prioritize a task from the list widget.
-    toolForWidget('set_priority', {
+    tool('set_priority', {
+      visibility: ['app'],
       description: 'Re-prioritize a task from the list widget.',
       annotations: localWrite,
       input: z.object({

package/skills/codex/examples/food-ordering/src/server.ts

@@ -1,15 +1,4 @@
-import {
-  annotations,
-  asset,
-  connector,
-  resource,
-  server,
-  tool,
-  toolForWidget,
-  toolWithWidget,
-  widget,
-  z,
-} from '@noodleseed/one';
+import { annotations, asset, connector, resource, server, tool, z } from '@noodleseed/one';
 
 const heroImage = asset('assets/noodle-bowl.jpg');
 
@@ -17,28 +6,28 @@ const state = connector('noodle_state')
   .version('1.0.0')
   .operation('read_state', {
     type: 'read',
-    input: {
-      handle: { type: 'string', required: true },
-      key: { type: 'string' },
-    },
-    output: {
-      value: { type: 'object', required: true },
-      revision: { type: 'integer', required: true },
-      status: { type: 'string', required: true },
-    },
+    input: z.object({
+      handle: z.string(),
+      key: z.string().optional(),
+    }),
+    output: z.object({
+      value: z.record(z.string(), z.unknown()),
+      revision: z.number().int(),
+      status: z.string(),
+    }),
   })
   .operation('patch_state', {
     type: 'action',
-    input: {
-      handle: { type: 'string', required: true },
-      expectedRevision: { type: 'integer', required: true },
-      value: { type: 'object', required: true },
-    },
-    output: {
-      value: { type: 'object', required: true },
-      revision: { type: 'integer', required: true },
-      status: { type: 'string', required: true },
-    },
+    input: z.object({
+      handle: z.string(),
+      expectedRevision: z.number().int(),
+      value: z.record(z.string(), z.unknown()),
+    }),
+    output: z.object({
+      value: z.record(z.string(), z.unknown()),
+      revision: z.number().int(),
+      status: z.string(),
+    }),
   });
 
 const stores = [
@@ -235,7 +224,7 @@ export default server(
     },
   },
   [
-    toolWithWidget('open_ordering', {
+    tool('open_ordering', {
       description:
         'Open a complete food-ordering widget with store discovery, menu browsing, cart review, and checkout handoff.',
       annotations: readOnly,
@@ -257,13 +246,13 @@ export default server(
         featuredItems: menu,
         fallback: 'Open stores: Harbor Noodles (Noodles), Garden Wraps (Vegetarian).',
       }),
-      widgetTitle: 'Food ordering',
+      viewTitle: 'Food ordering',
       domain: 'https://orders.example.com',
       view: {
         component: 'ordering-flow',
         entry: './views/ordering-flow.tsx',
       },
-      widgetDescription:
+      viewDescription:
         'A complete consumer ordering surface with app-only helper tools, cart state, and checkout handoff.',
       csp: {
         connectDomains: ['https://orders.example.com'],
@@ -272,7 +261,8 @@ export default server(
       },
       permissions: { clipboardWrite: {} },
     }),
-    toolForWidget('search_stores', {
+    tool('search_stores', {
+      visibility: ['app'],
       description: 'Filter synthetic restaurants for the ordering widget.',
       annotations: readOnly,
       input: z.object({
@@ -282,7 +272,8 @@ export default server(
       output: z.object({ stores: z.array(storeShape) }),
       fulfil: () => ({ stores }),
     }),
-    toolForWidget('load_menu', {
+    tool('load_menu', {
+      visibility: ['app'],
       description: 'Load synthetic menu categories and items for one store.',
       annotations: readOnly,
       input: z.object({ storeId: z.string() }),
@@ -293,14 +284,16 @@ export default server(
       }),
       fulfil: ({ input }) => ({ storeId: input.storeId, stores, items: menu }),
     }),
-    toolForWidget('load_item', {
+    tool('load_item', {
+      visibility: ['app'],
       description: 'Load item details and modifier options for the ordering widget.',
       annotations: readOnly,
       input: z.object({ itemId: z.string() }),
       output: z.object({ itemId: z.string(), items: z.array(menuItemShape) }),
       fulfil: ({ input }) => ({ itemId: input.itemId, items: menu }),
     }),
-    toolForWidget('read_cart', {
+    tool('read_cart', {
+      visibility: ['app'],
       description: 'Read the caller-scoped ordering cart state.',
       annotations: readOnly,
       input: z.object({}),
@@ -314,7 +307,8 @@ export default server(
         return { value: state.value, revision: state.revision, status: state.status };
       },
     }),
-    toolForWidget('sync_cart', {
+    tool('sync_cart', {
+      visibility: ['app'],
       description: 'Patch the caller-scoped ordering cart with the widget cart mirror.',
       annotations: action,
       input: cartInput,
@@ -333,7 +327,8 @@ export default server(
         return { cart, revision: state.revision, status: state.status };
       },
     }),
-    toolForWidget('prepare_checkout', {
+    tool('prepare_checkout', {
+      visibility: ['app'],
       description: 'Prepare the caller-scoped cart for checkout handoff.',
       annotations: action,
       input: cartInput,
@@ -375,6 +370,17 @@ export default server(
         status: 'Food Ordering widget capabilities are ready.',
         note: 'Standalone preview covers React views, helper tools, cart state, handoff, CSP, and permissions.',
       }),
+      viewName: 'capabilities_card',
+      viewTitle: 'Food Ordering capabilities',
+      viewDescription: 'Standalone widget resource for previewing the ordering capability surface.',
+      domain: 'https://orders.example.com',
+      view: { component: 'capabilities-card', entry: './views/capabilities-card.tsx' },
+      csp: {
+        connectDomains: ['https://orders.example.com'],
+        resourceDomains: ['https://orders.example.com'],
+        frameDomains: ['https://orders.example.com'],
+      },
+      permissions: { clipboardWrite: {} },
     }),
     resource('food_ordering_guide', {
       uri: 'docs://food-ordering',
@@ -392,21 +398,5 @@ export default server(
           '- Checkout opens an allowlisted example URL; payment and final ordering remain out of scope.',
         ].join('\n'),
     }),
-    widget('capabilities_card', {
-      tool: 'show_capabilities',
-      title: 'Food Ordering capabilities',
-      domain: 'https://orders.example.com',
-      description: 'Standalone widget resource for previewing the ordering capability surface.',
-      view: {
-        component: 'capabilities-card',
-        entry: './views/capabilities-card.tsx',
-      },
-      csp: {
-        connectDomains: ['https://orders.example.com'],
-        resourceDomains: ['https://orders.example.com'],
-        frameDomains: ['https://orders.example.com'],
-      },
-      permissions: { clipboardWrite: {} },
-    }),
   ],
 );