Merge remote-tracking branch 'origin/master' into worktree/web-plugin-config

# Conflicts:
#	docs/event-producer-consumer.i18n.yaml
#	docs/event-producer-consumer.zh.md
#	docs/module-graph.i18n.yaml
#	packages/client/ui-conversation/README.i18n.yaml
#	packages/client/ui-conversation/README.zh.md

packages/web/tool-web/src/index.ts

@@ -58,7 +58,7 @@ export const Config: z<Config> = z.object({
   fetchMaxOutputChars: z.number().default(DEFAULT_FETCH_MAX_OUTPUT_CHARS),
 })
 
-/** The shape after schemastery applies its defaults to every field. */
+/** Complete config after schemastery applies every field default. */
 type ResolvedConfig = Required<Config>
 
 /** Configured count, timeout, and character caps must be positive integers. */

packages/web/web-fetch-local/src/index.ts

@@ -55,7 +55,7 @@ export const Config: z<Config> = z.object({
   userAgent: z.string().default(DEFAULT_USER_AGENT),
 })
 
-/** The shape after schemastery applies its defaults to every field. */
+/** Complete config after schemastery applies every field default. */
 type ResolvedConfig = Required<Config>
 
 /** A resource limit (byte/char/length/timeout cap) must be a positive finite number. */

packages/web/web-fetch-local/src/provider.ts

@@ -224,7 +224,7 @@ function resolveRedirect(location: string, base: URL): URL {
 
 /**
  * Translate a thrown fetch/stream error into a `WebError`, classified by the
- * deadline signal rather than the error's shape (which differs by phase: the
+ * deadline signal rather than the thrown value (which differs by phase: the
  * request-phase `fetch` rejects with the abort reason, while the read-phase
  * reader surfaces a bare `AbortError`). `timeoutOf(signal, 'WEB_FETCH_TIMEOUT')`
  * recovering OUR reason means our timeout fired (`WEB_FETCH_TIMEOUT`); any other

packages/web/web/src/index.ts

@@ -133,7 +133,7 @@ export class WebService extends Service {
    * time with the selection rules above; throws {@link WebError} when the
    * capability cannot run. The seam enforces `request.maxResults` on the result:
    * if the provider over-returns, `sources[]` is truncated and `truncated` set.
-   * @param request - the query plus result-shaping options.
+   * @param request - the query and optional result limit.
    * @param signal - optional cancellation signal forwarded to the provider.
    * @returns the provider's results, capped to `request.maxResults`.
    */

packages/web/web/src/types.ts

@@ -1,7 +1,7 @@
 /**
  * Vocabulary for the web capability seam (`ctx.web`). Search and fetch deliberately share one
  * seam so provider selection, cancellation, errors, and product configuration have one owner,
- * while retaining separate request and result shapes.
+ * while retaining separate request and result types.
  * @module @deepseek-ai/dsh-web/types
  */