@noodleseed/agent-kit 0.41.0 → 0.42.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. package/manifest.json +231 -231
  2. package/package.json +1 -1
  3. package/skills/claude-code/SKILL.md +2 -2
  4. package/skills/claude-code/authoring-mcp-servers/SKILL.md +1 -1
  5. package/skills/claude-code/building-mcp-apps/SKILL.md +1 -1
  6. package/skills/claude-code/connecting-apis-to-mcp/SKILL.md +1 -1
  7. package/skills/claude-code/debugging-mcp-delivery/SKILL.md +1 -1
  8. package/skills/claude-code/deploying-mcp-services/SKILL.md +1 -1
  9. package/skills/claude-code/designing-mcp-products/SKILL.md +1 -1
  10. package/skills/claude-code/embedding-mcp-assistants/SKILL.md +1 -1
  11. package/skills/claude-code/examples/hello/README.md +3 -0
  12. package/skills/claude-code/publishing-mcp-integrations/SKILL.md +1 -1
  13. package/skills/claude-code/references/agent-contract.md +4 -3
  14. package/skills/claude-code/reporting-noodle-feedback/SKILL.md +1 -1
  15. package/skills/claude-code/verifying-mcp-delivery/SKILL.md +1 -1
  16. package/skills/codex/SKILL.md +2 -2
  17. package/skills/codex/authoring-mcp-servers/SKILL.md +1 -1
  18. package/skills/codex/building-mcp-apps/SKILL.md +1 -1
  19. package/skills/codex/connecting-apis-to-mcp/SKILL.md +1 -1
  20. package/skills/codex/debugging-mcp-delivery/SKILL.md +1 -1
  21. package/skills/codex/deploying-mcp-services/SKILL.md +1 -1
  22. package/skills/codex/designing-mcp-products/SKILL.md +1 -1
  23. package/skills/codex/embedding-mcp-assistants/SKILL.md +1 -1
  24. package/skills/codex/examples/hello/README.md +3 -0
  25. package/skills/codex/publishing-mcp-integrations/SKILL.md +1 -1
  26. package/skills/codex/references/agent-contract.md +4 -3
  27. package/skills/codex/reporting-noodle-feedback/SKILL.md +1 -1
  28. package/skills/codex/verifying-mcp-delivery/SKILL.md +1 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@noodleseed/agent-kit",
3
- "version": "0.41.0",
3
+ "version": "0.42.0",
4
4
  "private": false,
5
5
  "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.",
6
6
  "license": "Apache-2.0",
package/skills/claude-code/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: noodle-seed
3
3
  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."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:2ea7d6dcc8358b35 -->
6
+ <!-- noodle-skill version:0.42.0 hash:0c1ebd532b9c2499 -->
7
7
 
8
8
  # Noodle Seed
9
9
 
@@ -39,7 +39,7 @@ Negative routing examples: “Inspect hosted logs/status” → `inspect-hosted`
39
39
 
40
40
  ## Common machine loop
41
41
 
42
- The cold-agent commands speak the `--json` envelope. Parse machine state instead of scraping human prose; `references/agent-contract.md` owns the envelope and exit codes.
42
+ Every `--json` command speaks the canonical envelope on stdout. Parse machine state instead of scraping human prose; `references/agent-contract.md` owns the envelope, streaming records, and exit codes.
43
43
 
44
44
  1. **Discover** — use `noodle commands --json` when the required command or flags are uncertain; don't read CLI source.
45
45
  2. **Author** — for build routes, edit the configured TypeScript entrypoint, usually `src/server.ts`.
package/skills/claude-code/authoring-mcp-servers/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: authoring-mcp-servers
3
3
  description: "Use when creating or extending a headless Noodle Seed MCP server, tool, resource, prompt, or typed model-facing capability."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:0b2fd8c7e43fc69f -->
6
+ <!-- noodle-skill version:0.42.0 hash:0b2fd8c7e43fc69f -->
7
7
 
8
8
  # authoring-mcp-servers
9
9
 
package/skills/claude-code/building-mcp-apps/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: building-mcp-apps
3
3
  description: "Use when a Noodle Seed MCP App, widget, interactive card, visual interaction, or host-visible UI is the primary requested outcome."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:f7fa54992c8d7692 -->
6
+ <!-- noodle-skill version:0.42.0 hash:f7fa54992c8d7692 -->
7
7
 
8
8
  # building-mcp-apps
9
9
 
package/skills/claude-code/connecting-apis-to-mcp/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: connecting-apis-to-mcp
3
3
  description: "Use when credentials, an API URL, an OpenAPI document, or an observed response must become real Noodle Seed MCP behavior."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:1e86b8704f407bd3 -->
6
+ <!-- noodle-skill version:0.42.0 hash:1e86b8704f407bd3 -->
7
7
 
8
8
  # connecting-apis-to-mcp
9
9
 
package/skills/claude-code/debugging-mcp-delivery/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: debugging-mcp-delivery
3
3
  description: "Use when an existing Noodle Seed MCP project has a concrete validation, runtime, connector, App, host, deployment, or production failure."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:aa715bae12041d7c -->
6
+ <!-- noodle-skill version:0.42.0 hash:aa715bae12041d7c -->
7
7
 
8
8
  # debugging-mcp-delivery
9
9
 
package/skills/claude-code/deploying-mcp-services/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: deploying-mcp-services
3
3
  description: "Use when the user explicitly requests a Noodle Seed hosted link, configuration write, deployment, access change, rollback, or connection write."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:93e735b7ffb45df1 -->
6
+ <!-- noodle-skill version:0.42.0 hash:93e735b7ffb45df1 -->
7
7
 
8
8
  # deploying-mcp-services
9
9
 
package/skills/claude-code/designing-mcp-products/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: designing-mcp-products
3
3
  description: "Use when a Noodle Seed MCP product idea needs conversational fit, user benefit, scope, interaction, or evidence design before implementation."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:76cce86729cffbee -->
6
+ <!-- noodle-skill version:0.42.0 hash:76cce86729cffbee -->
7
7
 
8
8
  # designing-mcp-products
9
9
 
package/skills/claude-code/embedding-mcp-assistants/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: embedding-mcp-assistants
3
3
  description: "Use when embedding a Noodle assistant into an existing SaaS or web application with browser, identity, session, and credential boundaries."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:5d8f40f904d6ab4b -->
6
+ <!-- noodle-skill version:0.42.0 hash:5d8f40f904d6ab4b -->
7
7
 
8
8
  # embedding-mcp-assistants
9
9
 
package/skills/claude-code/examples/hello/README.md CHANGED
@@ -12,6 +12,9 @@ guides and operates the validate, preview, deploy, inspect, and debug workflow.
12
12
  If that agent discovers a Noodle Seed product gap while working, the installed skill prepares a
13
13
  sanitized `noodle feedback` proposal, discovers current fields from `noodle commands --json`, and
14
14
  submits it only after showing the exact command and receiving explicit user approval.
15
+ Every `--json` command writes its canonical success or failure envelope to stdout and leaves stderr
16
+ empty. One-shot commands write one envelope; streaming commands write NDJSON snapshot, event, and
17
+ terminal-failure envelopes so agents can parse each line independently.
15
18
 
16
19
  ```sh
17
20
  noodle dev examples/hello/src/server.ts --app hello
package/skills/claude-code/publishing-mcp-integrations/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: publishing-mcp-integrations
3
3
  description: "Use when preparing, reviewing, or submitting a Noodle Seed MCP integration to a host or app directory."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:efffbf82007f935d -->
6
+ <!-- noodle-skill version:0.42.0 hash:efffbf82007f935d -->
7
7
 
8
8
  # publishing-mcp-integrations
9
9
 
package/skills/claude-code/references/agent-contract.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Agent contract: --json, exit codes, output modes
2
2
 
3
- The cold-agent-path commands (`init`, `validate`, `test`, `check`, `tools`/`resources`/`prompts`, `deploy`, `metrics`, `events`, `agents`) are agent-native and return the envelope below; hosted admin/ops commands (`status`, `inspect`, `smoke`, `logs`, `update`) are still being normalized. Decide what to do next by parsing machine state — do not scrape human prose.
3
+ Every `--json` command returns the canonical envelope below on stdout and keeps stderr empty. Decide what to do next by parsing machine state — do not scrape human prose.
4
4
 
5
5
  ## Contents
6
6
 
@@ -11,12 +11,13 @@ The cold-agent-path commands (`init`, `validate`, `test`, `check`, `tools`/`reso
11
11
 
12
12
  ## Response envelope
13
13
 
14
- A `--json` command returns exactly one JSON object:
14
+ A one-shot `--json` command returns exactly one JSON object on stdout; stderr stays empty:
15
15
 
16
16
  - **Success**: `{ ok: true, data, warnings? }` — `data` is the command payload; `warnings?` is an optional array of non-fatal notes.
17
- - **Failure**: `{ ok: false, error: { code, message, cause?, fix, next, requestId? } }` — `code` is the stable machine code to branch on, `message` is human text, `cause?` is the underlying error, `fix` states the correction, `next` names the command to run next, `requestId?` correlates a hosted call.
17
+ - **Failure**: `{ ok: false, error: { code, message, cause?, fix, next, requestId?, retryable?, retryAfterSeconds? } }` — `code` is the stable machine code to branch on, `message` is human text, `cause?` is the underlying error, `fix` states the correction, `next` names the command to run next, `requestId?` correlates a hosted call, and retry metadata tells automation whether and when to retry.
18
18
  - **Field errors** carry a dotted `path`: multi-error commands (e.g. `noodle validate`) nest them under `error.errors[]`, each `{ code, path, message }`. The top-level `error` still carries `code`/`message`/`fix`/`next`; the per-field `path`s live in `error.errors[]`.
19
19
  - **Repair prose is isolated**: ready-to-apply repair text appears only under `error.fixPrompt` (surfaced by `--fix-prompt`), never mixed into `message` or `data`.
20
+ - **Streams are NDJSON envelopes**: the initial snapshot is `{ ok: true, data: { kind: "snapshot", snapshot } }`, subsequent records are `{ ok: true, data: { kind: "event", event } }`, and a terminal failure is the ordinary `{ ok: false, error }` envelope on its own line. Parse each line independently.
20
21
 
21
22
  ## Exit codes
22
23
 
package/skills/claude-code/reporting-noodle-feedback/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: reporting-noodle-feedback
3
3
  description: "Use when a Noodle Seed bug, misleading instruction, missing capability, or concrete product improvement should be proposed to the user."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:1e23938b39956ef8 -->
6
+ <!-- noodle-skill version:0.42.0 hash:1e23938b39956ef8 -->
7
7
 
8
8
  # reporting-noodle-feedback
9
9
 
package/skills/claude-code/verifying-mcp-delivery/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: verifying-mcp-delivery
3
3
  description: "Use when proving a Noodle Seed MCP project works at a named compile, local, connector, App, host, deployment, or production evidence level."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:6ef6ef551e26b78e -->
6
+ <!-- noodle-skill version:0.42.0 hash:6ef6ef551e26b78e -->
7
7
 
8
8
  # verifying-mcp-delivery
9
9
 
package/skills/codex/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: noodle-seed
3
3
  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."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:2ea7d6dcc8358b35 -->
6
+ <!-- noodle-skill version:0.42.0 hash:0c1ebd532b9c2499 -->
7
7
 
8
8
  # Noodle Seed
9
9
 
@@ -39,7 +39,7 @@ Negative routing examples: “Inspect hosted logs/status” → `inspect-hosted`
39
39
 
40
40
  ## Common machine loop
41
41
 
42
- The cold-agent commands speak the `--json` envelope. Parse machine state instead of scraping human prose; `references/agent-contract.md` owns the envelope and exit codes.
42
+ Every `--json` command speaks the canonical envelope on stdout. Parse machine state instead of scraping human prose; `references/agent-contract.md` owns the envelope, streaming records, and exit codes.
43
43
 
44
44
  1. **Discover** — use `noodle commands --json` when the required command or flags are uncertain; don't read CLI source.
45
45
  2. **Author** — for build routes, edit the configured TypeScript entrypoint, usually `src/server.ts`.
package/skills/codex/authoring-mcp-servers/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: authoring-mcp-servers
3
3
  description: "Use when creating or extending a headless Noodle Seed MCP server, tool, resource, prompt, or typed model-facing capability."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:0b2fd8c7e43fc69f -->
6
+ <!-- noodle-skill version:0.42.0 hash:0b2fd8c7e43fc69f -->
7
7
 
8
8
  # authoring-mcp-servers
9
9
 
package/skills/codex/building-mcp-apps/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: building-mcp-apps
3
3
  description: "Use when a Noodle Seed MCP App, widget, interactive card, visual interaction, or host-visible UI is the primary requested outcome."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:f7fa54992c8d7692 -->
6
+ <!-- noodle-skill version:0.42.0 hash:f7fa54992c8d7692 -->
7
7
 
8
8
  # building-mcp-apps
9
9
 
package/skills/codex/connecting-apis-to-mcp/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: connecting-apis-to-mcp
3
3
  description: "Use when credentials, an API URL, an OpenAPI document, or an observed response must become real Noodle Seed MCP behavior."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:1e86b8704f407bd3 -->
6
+ <!-- noodle-skill version:0.42.0 hash:1e86b8704f407bd3 -->
7
7
 
8
8
  # connecting-apis-to-mcp
9
9
 
package/skills/codex/debugging-mcp-delivery/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: debugging-mcp-delivery
3
3
  description: "Use when an existing Noodle Seed MCP project has a concrete validation, runtime, connector, App, host, deployment, or production failure."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:aa715bae12041d7c -->
6
+ <!-- noodle-skill version:0.42.0 hash:aa715bae12041d7c -->
7
7
 
8
8
  # debugging-mcp-delivery
9
9
 
package/skills/codex/deploying-mcp-services/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: deploying-mcp-services
3
3
  description: "Use when the user explicitly requests a Noodle Seed hosted link, configuration write, deployment, access change, rollback, or connection write."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:93e735b7ffb45df1 -->
6
+ <!-- noodle-skill version:0.42.0 hash:93e735b7ffb45df1 -->
7
7
 
8
8
  # deploying-mcp-services
9
9
 
package/skills/codex/designing-mcp-products/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: designing-mcp-products
3
3
  description: "Use when a Noodle Seed MCP product idea needs conversational fit, user benefit, scope, interaction, or evidence design before implementation."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:76cce86729cffbee -->
6
+ <!-- noodle-skill version:0.42.0 hash:76cce86729cffbee -->
7
7
 
8
8
  # designing-mcp-products
9
9
 
package/skills/codex/embedding-mcp-assistants/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: embedding-mcp-assistants
3
3
  description: "Use when embedding a Noodle assistant into an existing SaaS or web application with browser, identity, session, and credential boundaries."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:5d8f40f904d6ab4b -->
6
+ <!-- noodle-skill version:0.42.0 hash:5d8f40f904d6ab4b -->
7
7
 
8
8
  # embedding-mcp-assistants
9
9
 
package/skills/codex/examples/hello/README.md CHANGED
@@ -12,6 +12,9 @@ guides and operates the validate, preview, deploy, inspect, and debug workflow.
12
12
  If that agent discovers a Noodle Seed product gap while working, the installed skill prepares a
13
13
  sanitized `noodle feedback` proposal, discovers current fields from `noodle commands --json`, and
14
14
  submits it only after showing the exact command and receiving explicit user approval.
15
+ Every `--json` command writes its canonical success or failure envelope to stdout and leaves stderr
16
+ empty. One-shot commands write one envelope; streaming commands write NDJSON snapshot, event, and
17
+ terminal-failure envelopes so agents can parse each line independently.
15
18
 
16
19
  ```sh
17
20
  noodle dev examples/hello/src/server.ts --app hello
package/skills/codex/publishing-mcp-integrations/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: publishing-mcp-integrations
3
3
  description: "Use when preparing, reviewing, or submitting a Noodle Seed MCP integration to a host or app directory."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:efffbf82007f935d -->
6
+ <!-- noodle-skill version:0.42.0 hash:efffbf82007f935d -->
7
7
 
8
8
  # publishing-mcp-integrations
9
9
 
package/skills/codex/references/agent-contract.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Agent contract: --json, exit codes, output modes
2
2
 
3
- The cold-agent-path commands (`init`, `validate`, `test`, `check`, `tools`/`resources`/`prompts`, `deploy`, `metrics`, `events`, `agents`) are agent-native and return the envelope below; hosted admin/ops commands (`status`, `inspect`, `smoke`, `logs`, `update`) are still being normalized. Decide what to do next by parsing machine state — do not scrape human prose.
3
+ Every `--json` command returns the canonical envelope below on stdout and keeps stderr empty. Decide what to do next by parsing machine state — do not scrape human prose.
4
4
 
5
5
  ## Contents
6
6
 
@@ -11,12 +11,13 @@ The cold-agent-path commands (`init`, `validate`, `test`, `check`, `tools`/`reso
11
11
 
12
12
  ## Response envelope
13
13
 
14
- A `--json` command returns exactly one JSON object:
14
+ A one-shot `--json` command returns exactly one JSON object on stdout; stderr stays empty:
15
15
 
16
16
  - **Success**: `{ ok: true, data, warnings? }` — `data` is the command payload; `warnings?` is an optional array of non-fatal notes.
17
- - **Failure**: `{ ok: false, error: { code, message, cause?, fix, next, requestId? } }` — `code` is the stable machine code to branch on, `message` is human text, `cause?` is the underlying error, `fix` states the correction, `next` names the command to run next, `requestId?` correlates a hosted call.
17
+ - **Failure**: `{ ok: false, error: { code, message, cause?, fix, next, requestId?, retryable?, retryAfterSeconds? } }` — `code` is the stable machine code to branch on, `message` is human text, `cause?` is the underlying error, `fix` states the correction, `next` names the command to run next, `requestId?` correlates a hosted call, and retry metadata tells automation whether and when to retry.
18
18
  - **Field errors** carry a dotted `path`: multi-error commands (e.g. `noodle validate`) nest them under `error.errors[]`, each `{ code, path, message }`. The top-level `error` still carries `code`/`message`/`fix`/`next`; the per-field `path`s live in `error.errors[]`.
19
19
  - **Repair prose is isolated**: ready-to-apply repair text appears only under `error.fixPrompt` (surfaced by `--fix-prompt`), never mixed into `message` or `data`.
20
+ - **Streams are NDJSON envelopes**: the initial snapshot is `{ ok: true, data: { kind: "snapshot", snapshot } }`, subsequent records are `{ ok: true, data: { kind: "event", event } }`, and a terminal failure is the ordinary `{ ok: false, error }` envelope on its own line. Parse each line independently.
20
21
 
21
22
  ## Exit codes
22
23
 
package/skills/codex/reporting-noodle-feedback/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: reporting-noodle-feedback
3
3
  description: "Use when a Noodle Seed bug, misleading instruction, missing capability, or concrete product improvement should be proposed to the user."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:1e23938b39956ef8 -->
6
+ <!-- noodle-skill version:0.42.0 hash:1e23938b39956ef8 -->
7
7
 
8
8
  # reporting-noodle-feedback
9
9
 
package/skills/codex/verifying-mcp-delivery/SKILL.md CHANGED
@@ -3,7 +3,7 @@ name: verifying-mcp-delivery
3
3
  description: "Use when proving a Noodle Seed MCP project works at a named compile, local, connector, App, host, deployment, or production evidence level."
4
4
  ---
5
5
 
6
- <!-- noodle-skill version:0.41.0 hash:6ef6ef551e26b78e -->
6
+ <!-- noodle-skill version:0.42.0 hash:6ef6ef551e26b78e -->
7
7
 
8
8
  # verifying-mcp-delivery
9
9