@noodleseed/agent-kit 0.61.0 → 0.62.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noodleseed/agent-kit",
-  "version": "0.61.0",
+  "version": "0.62.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

@@ -3,7 +3,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."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:d83543258e5ca5ff -->
+<!-- noodle-skill version:0.62.0 hash:d83543258e5ca5ff -->
 
 # Noodle Seed
 

package/skills/claude-code/authoring-mcp-servers/SKILL.md

@@ -3,7 +3,7 @@ name: authoring-mcp-servers
 description: "Use when creating or extending a headless Noodle Seed MCP server, tool, resource, prompt, or typed model-facing capability."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:0b2fd8c7e43fc69f -->
+<!-- noodle-skill version:0.62.0 hash:0b2fd8c7e43fc69f -->
 
 # authoring-mcp-servers
 

package/skills/claude-code/building-mcp-apps/SKILL.md

@@ -3,7 +3,7 @@ name: building-mcp-apps
 description: "Use when a Noodle Seed MCP App, widget, interactive card, visual interaction, or host-visible UI is the primary requested outcome."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:f7fa54992c8d7692 -->
+<!-- noodle-skill version:0.62.0 hash:f7fa54992c8d7692 -->
 
 # building-mcp-apps
 

package/skills/claude-code/connecting-apis-to-mcp/SKILL.md

@@ -3,7 +3,7 @@ name: connecting-apis-to-mcp
 description: "Use when all four API-evidence inputs exist—and only then: API base URL, authentication scheme, representative safe read, and observed response."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:21bbd3ec441ffd30 -->
+<!-- noodle-skill version:0.62.0 hash:21bbd3ec441ffd30 -->
 
 # connecting-apis-to-mcp
 

package/skills/claude-code/debugging-mcp-delivery/SKILL.md

@@ -3,7 +3,7 @@ name: debugging-mcp-delivery
 description: "Use when an existing Noodle Seed MCP project has a concrete validation, runtime, connector, App, host, deployment, or production failure."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:aa715bae12041d7c -->
+<!-- noodle-skill version:0.62.0 hash:aa715bae12041d7c -->
 
 # debugging-mcp-delivery
 

package/skills/claude-code/deploying-mcp-services/SKILL.md

@@ -3,7 +3,7 @@ name: deploying-mcp-services
 description: "Use when the user explicitly requests a Noodle Seed hosted link, configuration write, deployment, access change, rollback, or connection write."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:93e735b7ffb45df1 -->
+<!-- noodle-skill version:0.62.0 hash:93e735b7ffb45df1 -->
 
 # deploying-mcp-services
 

package/skills/claude-code/designing-mcp-products/SKILL.md

@@ -3,7 +3,7 @@ name: designing-mcp-products
 description: "Use when a Noodle Seed MCP product idea needs conversational fit, user benefit, scope, interaction, or evidence design before implementation."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:76cce86729cffbee -->
+<!-- noodle-skill version:0.62.0 hash:76cce86729cffbee -->
 
 # designing-mcp-products
 

package/skills/claude-code/embedding-mcp-assistants/SKILL.md

@@ -3,7 +3,7 @@ name: embedding-mcp-assistants
 description: "Use when embedding a Noodle assistant into an existing SaaS or web application with browser, identity, session, and credential boundaries."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:cc54a67f21c0ecdb -->
+<!-- noodle-skill version:0.62.0 hash:cc54a67f21c0ecdb -->
 
 # embedding-mcp-assistants
 

package/skills/claude-code/examples/weather/README.md

@@ -5,7 +5,7 @@ keys**. The `weather_briefing` tool takes a city name and runs a **three-step fl
 
 Capability slots: HTTP connector authoring, ordered fulfilment flows, query/response mapping,
 **list-returning connector output** (a connector that returns a live, variable-length array), and
-sandboxed compute.
+sandboxed compute, including an explicit least-privilege per-operation response-size bound.
 
 1. **`geo.search`** → geocode the city to coordinates (Open-Meteo Geocoding API)
 2. **`forecast.current`** → fetch current weather for those coordinates (Open-Meteo Forecast API)
@@ -30,6 +30,9 @@ It exercises, in one TypeScript-authored app:
 - **A list-returning connector + compute narrowing** — `geo.search_list` binds the whole `results`
   array; `places.narrow` reduces each element to `{ id, label }` and normalizes the no-results case
   to `[]`.
+- **A per-operation transport bound** — `search_list` sets
+  `limits: { maxResponseBytes: 256 * 1024 }`, tightening this known-small endpoint below the 1 MiB default.
+  Raise a limit only when representative evidence proves the required raw response is larger.
 - **Sandboxed compute** (no network/fs/env/clock) turning raw numbers into conditions + advice.
 - **Typed input/output schemas** emitted as JSON Schema 2020-12.
 

package/skills/claude-code/examples/weather/src/server.ts

@@ -44,6 +44,8 @@ const geocoding = connector('open_meteo_geocoding')
         method: 'GET',
         path: '/v1/search',
         query: ['name', 'count'],
+        // This endpoint is intentionally small; tighten its allowance below the 1 MiB default.
+        limits: { maxResponseBytes: 256 * 1024 },
         input: z.object({ name: z.string(), count: z.number().optional() }),
         output: z.object({ results: z.array(z.unknown()).optional() }),
         response: {

package/skills/claude-code/examples/weather/test/server.test.ts

@@ -26,4 +26,15 @@ describe('weather example', () => {
     expect(wire).toContain('search_list');
     expect(wire).toContain('narrow');
   });
+
+  it('demonstrates an explicit least-privilege response-size bound', () => {
+    const catalog = app.toConnectorCatalog();
+    const geocoding = catalog?.connectors.find(
+      (candidate) => candidate.id === 'open_meteo_geocoding',
+    );
+
+    expect(geocoding?.operations.search_list?.limits).toEqual({
+      maxResponseBytes: 256 * 1024,
+    });
+  });
 });

package/skills/claude-code/executing-noodle-plans/SKILL.md

@@ -3,7 +3,7 @@ name: executing-noodle-plans
 description: "Use when the user asks to execute an approved, decision-complete implementation plan for a Noodle Seed project task by task with test-first changes, review, recovery, and final verification."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:6a9f132ddb79352e -->
+<!-- noodle-skill version:0.62.0 hash:6a9f132ddb79352e -->
 
 # Execute a Noodle Seed implementation plan
 

package/skills/claude-code/publishing-mcp-integrations/SKILL.md

@@ -3,7 +3,7 @@ name: publishing-mcp-integrations
 description: "Use when preparing, reviewing, or submitting a Noodle Seed MCP integration to a host or app directory."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:efffbf82007f935d -->
+<!-- noodle-skill version:0.62.0 hash:efffbf82007f935d -->
 
 # publishing-mcp-integrations
 

package/skills/claude-code/references/connect-an-api.md

@@ -111,6 +111,24 @@ pagination: {
 response: { tasks: '${response.items}' },
 ```
 
+### Bound exceptional response sizes
+
+HTTP operations default to a 1 MiB decoded-response limit. Narrow the upstream query, paginate, or
+reduce the requested dataset before raising it; a `response` mapping runs only after the raw body is
+buffered. When representative evidence proves one operation legitimately needs more, grant only that
+operation the required bytes, up to the 3 MiB authoring maximum:
+
+```ts
+search: {
+  type: 'read', method: 'GET', path: '/search',
+  limits: { maxResponseBytes: 3 * 1024 * 1024 },
+  // input / output / response omitted
+},
+```
+
+The inclusive limit counts decoded streamed bytes. `response_too_large` is a safe structured reason;
+never copy a response body, header, URL, credential, or upstream error prose into user-visible output.
+
 ### Create, update, delete
 
 Pair the read/list with the mutations your intent tools need:

package/skills/claude-code/reporting-noodle-feedback/SKILL.md

@@ -3,7 +3,7 @@ name: reporting-noodle-feedback
 description: "Use when a Noodle Seed bug, misleading instruction, missing capability, or concrete product improvement should be proposed to the user."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:0f404109f4845683 -->
+<!-- noodle-skill version:0.62.0 hash:0f404109f4845683 -->
 
 # reporting-noodle-feedback
 

package/skills/claude-code/verifying-mcp-delivery/SKILL.md

@@ -3,7 +3,7 @@ name: verifying-mcp-delivery
 description: "Use when proving a Noodle Seed MCP project works at a named compile, local, connector, App, host, deployment, or production evidence level."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:6ef6ef551e26b78e -->
+<!-- noodle-skill version:0.62.0 hash:6ef6ef551e26b78e -->
 
 # verifying-mcp-delivery
 

package/skills/claude-code/wrapping-existing-applications/SKILL.md

@@ -3,7 +3,7 @@ name: wrapping-existing-applications
 description: "Use when an existing application has no stable usable API and needs a read-only, identity-first Noodle Seed integration plan before implementation."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:eccc3c158dcafba8 -->
+<!-- noodle-skill version:0.62.0 hash:eccc3c158dcafba8 -->
 
 # wrapping-existing-applications
 

package/skills/codex/SKILL.md

@@ -3,7 +3,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."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:d83543258e5ca5ff -->
+<!-- noodle-skill version:0.62.0 hash:d83543258e5ca5ff -->
 
 # Noodle Seed
 

package/skills/codex/authoring-mcp-servers/SKILL.md

@@ -3,7 +3,7 @@ name: authoring-mcp-servers
 description: "Use when creating or extending a headless Noodle Seed MCP server, tool, resource, prompt, or typed model-facing capability."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:0b2fd8c7e43fc69f -->
+<!-- noodle-skill version:0.62.0 hash:0b2fd8c7e43fc69f -->
 
 # authoring-mcp-servers
 

package/skills/codex/building-mcp-apps/SKILL.md

@@ -3,7 +3,7 @@ name: building-mcp-apps
 description: "Use when a Noodle Seed MCP App, widget, interactive card, visual interaction, or host-visible UI is the primary requested outcome."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:f7fa54992c8d7692 -->
+<!-- noodle-skill version:0.62.0 hash:f7fa54992c8d7692 -->
 
 # building-mcp-apps
 

package/skills/codex/connecting-apis-to-mcp/SKILL.md

@@ -3,7 +3,7 @@ name: connecting-apis-to-mcp
 description: "Use when all four API-evidence inputs exist—and only then: API base URL, authentication scheme, representative safe read, and observed response."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:21bbd3ec441ffd30 -->
+<!-- noodle-skill version:0.62.0 hash:21bbd3ec441ffd30 -->
 
 # connecting-apis-to-mcp
 

package/skills/codex/debugging-mcp-delivery/SKILL.md

@@ -3,7 +3,7 @@ name: debugging-mcp-delivery
 description: "Use when an existing Noodle Seed MCP project has a concrete validation, runtime, connector, App, host, deployment, or production failure."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:aa715bae12041d7c -->
+<!-- noodle-skill version:0.62.0 hash:aa715bae12041d7c -->
 
 # debugging-mcp-delivery
 

package/skills/codex/deploying-mcp-services/SKILL.md

@@ -3,7 +3,7 @@ name: deploying-mcp-services
 description: "Use when the user explicitly requests a Noodle Seed hosted link, configuration write, deployment, access change, rollback, or connection write."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:93e735b7ffb45df1 -->
+<!-- noodle-skill version:0.62.0 hash:93e735b7ffb45df1 -->
 
 # deploying-mcp-services
 

package/skills/codex/designing-mcp-products/SKILL.md

@@ -3,7 +3,7 @@ name: designing-mcp-products
 description: "Use when a Noodle Seed MCP product idea needs conversational fit, user benefit, scope, interaction, or evidence design before implementation."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:76cce86729cffbee -->
+<!-- noodle-skill version:0.62.0 hash:76cce86729cffbee -->
 
 # designing-mcp-products
 

package/skills/codex/embedding-mcp-assistants/SKILL.md

@@ -3,7 +3,7 @@ name: embedding-mcp-assistants
 description: "Use when embedding a Noodle assistant into an existing SaaS or web application with browser, identity, session, and credential boundaries."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:cc54a67f21c0ecdb -->
+<!-- noodle-skill version:0.62.0 hash:cc54a67f21c0ecdb -->
 
 # embedding-mcp-assistants
 

package/skills/codex/examples/weather/README.md

@@ -5,7 +5,7 @@ keys**. The `weather_briefing` tool takes a city name and runs a **three-step fl
 
 Capability slots: HTTP connector authoring, ordered fulfilment flows, query/response mapping,
 **list-returning connector output** (a connector that returns a live, variable-length array), and
-sandboxed compute.
+sandboxed compute, including an explicit least-privilege per-operation response-size bound.
 
 1. **`geo.search`** → geocode the city to coordinates (Open-Meteo Geocoding API)
 2. **`forecast.current`** → fetch current weather for those coordinates (Open-Meteo Forecast API)
@@ -30,6 +30,9 @@ It exercises, in one TypeScript-authored app:
 - **A list-returning connector + compute narrowing** — `geo.search_list` binds the whole `results`
   array; `places.narrow` reduces each element to `{ id, label }` and normalizes the no-results case
   to `[]`.
+- **A per-operation transport bound** — `search_list` sets
+  `limits: { maxResponseBytes: 256 * 1024 }`, tightening this known-small endpoint below the 1 MiB default.
+  Raise a limit only when representative evidence proves the required raw response is larger.
 - **Sandboxed compute** (no network/fs/env/clock) turning raw numbers into conditions + advice.
 - **Typed input/output schemas** emitted as JSON Schema 2020-12.
 

package/skills/codex/examples/weather/src/server.ts

@@ -44,6 +44,8 @@ const geocoding = connector('open_meteo_geocoding')
         method: 'GET',
         path: '/v1/search',
         query: ['name', 'count'],
+        // This endpoint is intentionally small; tighten its allowance below the 1 MiB default.
+        limits: { maxResponseBytes: 256 * 1024 },
         input: z.object({ name: z.string(), count: z.number().optional() }),
         output: z.object({ results: z.array(z.unknown()).optional() }),
         response: {

package/skills/codex/examples/weather/test/server.test.ts

@@ -26,4 +26,15 @@ describe('weather example', () => {
     expect(wire).toContain('search_list');
     expect(wire).toContain('narrow');
   });
+
+  it('demonstrates an explicit least-privilege response-size bound', () => {
+    const catalog = app.toConnectorCatalog();
+    const geocoding = catalog?.connectors.find(
+      (candidate) => candidate.id === 'open_meteo_geocoding',
+    );
+
+    expect(geocoding?.operations.search_list?.limits).toEqual({
+      maxResponseBytes: 256 * 1024,
+    });
+  });
 });

package/skills/codex/executing-noodle-plans/SKILL.md

@@ -3,7 +3,7 @@ name: executing-noodle-plans
 description: "Use when the user asks to execute an approved, decision-complete implementation plan for a Noodle Seed project task by task with test-first changes, review, recovery, and final verification."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:6a9f132ddb79352e -->
+<!-- noodle-skill version:0.62.0 hash:6a9f132ddb79352e -->
 
 # Execute a Noodle Seed implementation plan
 

package/skills/codex/publishing-mcp-integrations/SKILL.md

@@ -3,7 +3,7 @@ name: publishing-mcp-integrations
 description: "Use when preparing, reviewing, or submitting a Noodle Seed MCP integration to a host or app directory."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:efffbf82007f935d -->
+<!-- noodle-skill version:0.62.0 hash:efffbf82007f935d -->
 
 # publishing-mcp-integrations
 

package/skills/codex/references/connect-an-api.md

@@ -111,6 +111,24 @@ pagination: {
 response: { tasks: '${response.items}' },
 ```
 
+### Bound exceptional response sizes
+
+HTTP operations default to a 1 MiB decoded-response limit. Narrow the upstream query, paginate, or
+reduce the requested dataset before raising it; a `response` mapping runs only after the raw body is
+buffered. When representative evidence proves one operation legitimately needs more, grant only that
+operation the required bytes, up to the 3 MiB authoring maximum:
+
+```ts
+search: {
+  type: 'read', method: 'GET', path: '/search',
+  limits: { maxResponseBytes: 3 * 1024 * 1024 },
+  // input / output / response omitted
+},
+```
+
+The inclusive limit counts decoded streamed bytes. `response_too_large` is a safe structured reason;
+never copy a response body, header, URL, credential, or upstream error prose into user-visible output.
+
 ### Create, update, delete
 
 Pair the read/list with the mutations your intent tools need:

package/skills/codex/reporting-noodle-feedback/SKILL.md

@@ -3,7 +3,7 @@ name: reporting-noodle-feedback
 description: "Use when a Noodle Seed bug, misleading instruction, missing capability, or concrete product improvement should be proposed to the user."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:0f404109f4845683 -->
+<!-- noodle-skill version:0.62.0 hash:0f404109f4845683 -->
 
 # reporting-noodle-feedback
 

package/skills/codex/verifying-mcp-delivery/SKILL.md

@@ -3,7 +3,7 @@ name: verifying-mcp-delivery
 description: "Use when proving a Noodle Seed MCP project works at a named compile, local, connector, App, host, deployment, or production evidence level."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:6ef6ef551e26b78e -->
+<!-- noodle-skill version:0.62.0 hash:6ef6ef551e26b78e -->
 
 # verifying-mcp-delivery
 

package/skills/codex/wrapping-existing-applications/SKILL.md

@@ -3,7 +3,7 @@ name: wrapping-existing-applications
 description: "Use when an existing application has no stable usable API and needs a read-only, identity-first Noodle Seed integration plan before implementation."
 ---
 
-<!-- noodle-skill version:0.61.0 hash:eccc3c158dcafba8 -->
+<!-- noodle-skill version:0.62.0 hash:eccc3c158dcafba8 -->
 
 # wrapping-existing-applications