From 720b6a7d87ad0c5ae442387dead28395bc480bc2 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 18 Jul 2026 20:07:53 +0000 Subject: [PATCH] docs(site): correct plugin verb to 'plugin install' in chat/streams docs The durable-chat recipe, chat tutorial scaffold chapter, and Aspire essay documented 'netscript plugin add streams', but the CLI registers 'plugin install' (kind 'stream'); flagged BLOCKING by the OpenHands docs-accuracy run 29656646840 on PR #865, merged before the fix by maintainer decision. Uses the same verified form as the storefront tutorial: netscript plugin install stream --name streams. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01UVD6TpugadnV8aQw6mcGV6 --- docs/site/ai/how-to/build-a-durable-chat.md | 4 ++-- docs/site/explanation/aspire.md | 2 +- docs/site/tutorials/chat/01-scaffold.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/site/ai/how-to/build-a-durable-chat.md b/docs/site/ai/how-to/build-a-durable-chat.md index 99d5138c9..f1c9d5f9a 100644 --- a/docs/site/ai/how-to/build-a-durable-chat.md +++ b/docs/site/ai/how-to/build-a-durable-chat.md @@ -31,7 +31,7 @@ The chat surface is built from four seams, each a single function: - A NetScript workspace with a scaffolded `apps/dashboard/` Fresh app (`netscript init`). - The **streams runtime** reachable — durable sessions are addressed through the - `@netscript/plugin-streams-core` seam. Add it with `netscript plugin add streams` and + `@netscript/plugin-streams-core` seam. Add it with `netscript plugin install stream --name streams` and bring it up under Aspire. - A model provider key. This recipe calls Anthropic directly through [`@tanstack/ai`](https://tanstack.com/ai); export `ANTHROPIC_API_KEY` before you start @@ -213,7 +213,7 @@ Two RenderPart types exist and must not be conflated. @netscr session stream; `createNetScriptChatConnection` re-polls with backoff and returns an empty stream rather than a terminal error. A hard `401` / `403` propagates immediately. - **Streams runtime unreachable:** the durable stream URL does not resolve. Confirm - `netscript plugin add streams` ran and the streams service is up under Aspire. + `netscript plugin install stream --name streams` ran and the streams service is up under Aspire. - **Model call fails:** `ANTHROPIC_API_KEY` is unset or invalid — `chat()` surfaces the provider error into the assistant stream. diff --git a/docs/site/explanation/aspire.md b/docs/site/explanation/aspire.md index b93c8ff7b..7a06eccc1 100644 --- a/docs/site/explanation/aspire.md +++ b/docs/site/explanation/aspire.md @@ -300,7 +300,7 @@ is `netscript service generate` — it rewrites only the Aspire helper files, ne { name: "Handler / service / app code", type: "hot or restart resource", desc: "Apps and background processors scaffold with Deno watch mode, so they reload on save. A plain service restarts from the dashboard. No regenerate, no AppHost restart." }, { name: "Env / Permissions / Port / Workdir on a resource", type: "generate + restart AppHost", desc: "Edit the resource's section in netscript.config.ts, run `netscript service generate` to rewrite the register-*.mts layer, then restart `aspire start`." }, { name: "A reference: ServiceReferences / pluginReferences / dependsOn", type: "generate + restart AppHost", desc: "Same flow. Pass 2 only re-resolves and re-injects services____http__0 on the next `aspire start` — a declared-but-not-generated reference does nothing." }, - { name: "Add / remove a plugin, or a new appsettings resource", type: "generate + restart AppHost", desc: "`netscript plugin add`/`remove` (or a hand-added resource) changes the graph; the resource only joins on the next generate + `aspire start`." }, + { name: "Add / remove a plugin, or a new appsettings resource", type: "generate + restart AppHost", desc: "`netscript plugin install`/`remove` (or a hand-added resource) changes the graph; the resource only joins on the next generate + `aspire start`." }, { name: "An injected env value Aspire owns (OTEL_*, a connection string)", type: "restart the resource", desc: "Environment is read once at process start, so bounce the affected resource for the new value to take effect." } ] }) }} diff --git a/docs/site/tutorials/chat/01-scaffold.md b/docs/site/tutorials/chat/01-scaffold.md index effafca53..69264d3a5 100644 --- a/docs/site/tutorials/chat/01-scaffold.md +++ b/docs/site/tutorials/chat/01-scaffold.md @@ -71,7 +71,7 @@ A durable chat session is one append-only stream, addressed through the streams the `streams` plugin so `@netscript/fresh/ai` has a runtime to resolve session URLs against: ```sh -netscript plugin add streams +netscript plugin install stream --name streams --samples ``` {{ comp callout { type: "note", title: "Why streams, for a chat app?" } }}