@noodleseed/agent-kit 0.18.0 → 0.19.1

package/manifest.json

@@ -1,9 +1,9 @@
 {
-  "packageVersion": "0.18.0",
+  "packageVersion": "0.19.1",
   "files": [
     {
       "path": "skills/codex/SKILL.md",
-      "sha256": "e1cdb0f5fcf165fbb759e78398c495b488ec0293ff8d8d6961aee964bffd064d",
+      "sha256": "076f93b1c9e1e2ac9b5efe4ae2d80e4aed9ecb75e0da9257f327085360d802f1",
       "agentTarget": "codex"
     },
     {
@@ -28,7 +28,7 @@
     },
     {
       "path": "skills/codex/references/authoring-workflow.md",
-      "sha256": "23d0ced0b18aea19cf7714f744ea3ac2bbc4ff046b63e54440abb43182736717",
+      "sha256": "fd2a67d3ba67f640edddca6d30ed8d38f278f0f3e9ab1c1669ace2aef8797c01",
       "agentTarget": "codex"
     },
     {
@@ -43,7 +43,7 @@
     },
     {
       "path": "skills/codex/references/widgets-and-apps.md",
-      "sha256": "5cb7142e25574150d9b8e9b1261d63f76ad56a8a0b5260dc24afe9e92cc6f454",
+      "sha256": "853125c2bd73fcb136c3237bc4aa08faeeba8b8cc0d1ef2d0a168d4e7623ec68",
       "agentTarget": "codex"
     },
     {
@@ -193,7 +193,7 @@
     },
     {
       "path": "skills/codex/examples/acme-tasks/README.md",
-      "sha256": "ce9f7748d0258f70471f6f8d26771acde6f9025de54f90640f46a8219fba1359",
+      "sha256": "1d65cde8d1b47ade9e895ef99a92a0aec9d9ffe0c578f0d2dc4bafa0bcccca26",
       "agentTarget": "codex"
     },
     {
@@ -348,7 +348,7 @@
     },
     {
       "path": "skills/claude-code/SKILL.md",
-      "sha256": "dcb8ef876ceb10b803ab653404789851ea58dbef06877f8e2920cf9ae08a3d94",
+      "sha256": "7b487e019e82c28ec2ef1f5ffcb54f8ea15e3b62ecaf10a9de7375a692a4d1f7",
       "agentTarget": "claude-code"
     },
     {
@@ -373,7 +373,7 @@
     },
     {
       "path": "skills/claude-code/references/authoring-workflow.md",
-      "sha256": "23d0ced0b18aea19cf7714f744ea3ac2bbc4ff046b63e54440abb43182736717",
+      "sha256": "fd2a67d3ba67f640edddca6d30ed8d38f278f0f3e9ab1c1669ace2aef8797c01",
       "agentTarget": "claude-code"
     },
     {
@@ -388,7 +388,7 @@
     },
     {
       "path": "skills/claude-code/references/widgets-and-apps.md",
-      "sha256": "5cb7142e25574150d9b8e9b1261d63f76ad56a8a0b5260dc24afe9e92cc6f454",
+      "sha256": "853125c2bd73fcb136c3237bc4aa08faeeba8b8cc0d1ef2d0a168d4e7623ec68",
       "agentTarget": "claude-code"
     },
     {
@@ -538,7 +538,7 @@
     },
     {
       "path": "skills/claude-code/examples/acme-tasks/README.md",
-      "sha256": "ce9f7748d0258f70471f6f8d26771acde6f9025de54f90640f46a8219fba1359",
+      "sha256": "1d65cde8d1b47ade9e895ef99a92a0aec9d9ffe0c578f0d2dc4bafa0bcccca26",
       "agentTarget": "claude-code"
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noodleseed/agent-kit",
-  "version": "0.18.0",
+  "version": "0.19.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.18.0
+version: 0.19.1
 hash: b4952708b1c38f55
 ---
 

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

@@ -89,21 +89,21 @@ assistant: embeddedAssistant({
     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' },
-    },
-  },
+  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.
 
+Install the independently versioned embed SDK in the customer web application with
+`pnpm add @noodleseed/assistant`.
+
 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/references/authoring-workflow.md

@@ -200,7 +200,7 @@ Author managed config as `secret("NAME")` / `variable("NAME")` and operate it wi
 
 ## Embedded assistant
 
-To place the same server tools inside the SaaS web app, add `assistant: embeddedAssistant({ model: openAICompatible({ baseUrl: variable("ASSISTANT_MODEL_BASE_URL"), model: variable("ASSISTANT_MODEL"), apiKey: secret("ASSISTANT_MODEL_API_KEY") }), allowedOrigins: ["https://app.example.com"], appearance: { brand: { name: "Acme Assistant" }, theme: { defaultMode: "auto", light: { accent: "#3157D5" }, dark: { accent: "#9FB4FF" } } } })` to the server options. Keep origins exact. The customer backend uses `@noodleseed/assistant/server` to exchange its already-authenticated user for a short-lived browser session; client and model secrets never enter the browser. Run `noodle check --target embedded-assistant` before deploy, then manage backend credentials with `noodle assistant clients create|list|rotate|revoke`.
+To place the same server tools inside the SaaS web app, declare the shared identity once with `branding: { name: "Acme", accent: "#3157D5", surface: "#FFFFFF", surfaceDark: "#161B26", theme: { dark: { accent: "#9FB4FF" } } }`, then add `assistant: embeddedAssistant({ model: openAICompatible({ baseUrl: variable("ASSISTANT_MODEL_BASE_URL"), model: variable("ASSISTANT_MODEL"), apiKey: secret("ASSISTANT_MODEL_API_KEY") }), allowedOrigins: ["https://app.example.com"], layout: { mode: "floating", position: "bottom-right" } })`. Widgets and the embed inherit the same brand kit. Keep origins exact. Install the independently versioned embed SDK with `pnpm add @noodleseed/assistant`; the customer backend uses its `/server` export to exchange the already-authenticated user for a short-lived browser session, while the browser uses the package root or `/react` export. Client and model secrets never enter the browser. Run `noodle check --target embedded-assistant` before deploy, then manage backend credentials with `noodle assistant clients create|list|rotate|revoke`.
 
 ## Boundaries
 

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

@@ -24,6 +24,7 @@ Author views as React components. `generateHelpers<ServerDefinition>()` (from `@
 | `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. |
+| `useBranding` | Read the server-level brand name and themed logo/mark/avatar URLs when widget content needs identity assets; CSS tokens are applied automatically. |
 | `useRequestDisplayMode` | Request a host-mediated layout change such as fullscreen; treat it as best-effort and keep inline rendering useful. |
 | `useOpenExternal` | Open an external link through the host (never `window.open`); the target origin must be listed in the server-level `handoff.allowedDomains`. |
 | `useSendFollowUpMessage` | Send a follow-up prompt to the model from a user interaction: `send({ prompt })` — trigger only from an explicit user 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.18.0
+version: 0.19.1
 hash: 39c6a606c728d164
 ---
 

package/skills/codex/examples/acme-tasks/README.md

@@ -89,21 +89,21 @@ assistant: embeddedAssistant({
     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' },
-    },
-  },
+  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.
 
+Install the independently versioned embed SDK in the customer web application with
+`pnpm add @noodleseed/assistant`.
+
 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/references/authoring-workflow.md

@@ -200,7 +200,7 @@ Author managed config as `secret("NAME")` / `variable("NAME")` and operate it wi
 
 ## Embedded assistant
 
-To place the same server tools inside the SaaS web app, add `assistant: embeddedAssistant({ model: openAICompatible({ baseUrl: variable("ASSISTANT_MODEL_BASE_URL"), model: variable("ASSISTANT_MODEL"), apiKey: secret("ASSISTANT_MODEL_API_KEY") }), allowedOrigins: ["https://app.example.com"], appearance: { brand: { name: "Acme Assistant" }, theme: { defaultMode: "auto", light: { accent: "#3157D5" }, dark: { accent: "#9FB4FF" } } } })` to the server options. Keep origins exact. The customer backend uses `@noodleseed/assistant/server` to exchange its already-authenticated user for a short-lived browser session; client and model secrets never enter the browser. Run `noodle check --target embedded-assistant` before deploy, then manage backend credentials with `noodle assistant clients create|list|rotate|revoke`.
+To place the same server tools inside the SaaS web app, declare the shared identity once with `branding: { name: "Acme", accent: "#3157D5", surface: "#FFFFFF", surfaceDark: "#161B26", theme: { dark: { accent: "#9FB4FF" } } }`, then add `assistant: embeddedAssistant({ model: openAICompatible({ baseUrl: variable("ASSISTANT_MODEL_BASE_URL"), model: variable("ASSISTANT_MODEL"), apiKey: secret("ASSISTANT_MODEL_API_KEY") }), allowedOrigins: ["https://app.example.com"], layout: { mode: "floating", position: "bottom-right" } })`. Widgets and the embed inherit the same brand kit. Keep origins exact. Install the independently versioned embed SDK with `pnpm add @noodleseed/assistant`; the customer backend uses its `/server` export to exchange the already-authenticated user for a short-lived browser session, while the browser uses the package root or `/react` export. Client and model secrets never enter the browser. Run `noodle check --target embedded-assistant` before deploy, then manage backend credentials with `noodle assistant clients create|list|rotate|revoke`.
 
 ## Boundaries
 

package/skills/codex/references/widgets-and-apps.md

@@ -24,6 +24,7 @@ Author views as React components. `generateHelpers<ServerDefinition>()` (from `@
 | `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. |
+| `useBranding` | Read the server-level brand name and themed logo/mark/avatar URLs when widget content needs identity assets; CSS tokens are applied automatically. |
 | `useRequestDisplayMode` | Request a host-mediated layout change such as fullscreen; treat it as best-effort and keep inline rendering useful. |
 | `useOpenExternal` | Open an external link through the host (never `window.open`); the target origin must be listed in the server-level `handoff.allowedDomains`. |
 | `useSendFollowUpMessage` | Send a follow-up prompt to the model from a user interaction: `send({ prompt })` — trigger only from an explicit user action. |