docs: trim generated prose

packages/llm/llm-deepseek/src/adapter.ts

@@ -52,14 +52,8 @@ export class DeepSeekAdapter extends LlmAdapter {
   async * stream(options: GenerateOptions): AsyncIterable<StreamChunk> {
     const body = serializeRequest(options, this.options.defaults ?? {})
 
-    // TODO(http): deliberately raw `fetch` for the hand-rolled SSE body.
-    // `@cordisjs/plugin-http` (ctx.http) would give proxy/intercept/timeout
-    // uniformity AND can stream (`responseType: 'stream'` yields the same
-    // ReadableStream<Uint8Array> parseSse consumes), but adopting it today
-    // costs a hard `undici` dependency (it does `require('undici')` with no
-    // globalThis.fetch fallback) plus an unconditional `@cordisjs/fetch-file`
-    // import (pulling file-type + mime-types) for a file:// path we never hit.
-    // Revisit when a second adapter wants shared proxy/intercept config.
+    // TODO(http): adopt the Cordis HTTP service when shared transport configuration
+    // outweighs its additional runtime dependencies.
     const response = await fetch(`${this.options.baseURL}/chat/completions`, {
       method: 'POST',
       headers: {
@@ -79,15 +73,9 @@ export class DeepSeekAdapter extends LlmAdapter {
         const parsed = await response.json() as WireError
         if (parsed.error?.message) message = parsed.error.message
       } catch {
-        // Paranoid by design: `code` and the HTTP status are ALREADY captured
-        // above (and passed to LlmError below), so the only thing this `try`
-        // can add is a richer provider-supplied message. A malformed, empty,
-        // or non-JSON error body is a normal thing for gateways/proxies to
-        // return on a 5xx/429 — swallowing the parse failure keeps the usable
-        // status-line message instead of letting a JSON.parse throw mask the
-        // real HTTP error. Nothing else reaches this catch: response.json()
-        // is the sole statement, and any non-parse failure (e.g. body already
-        // consumed) is equally non-actionable here.
+        // Paranoid by design: `code` and the HTTP status are ALREADY captured above (and passed
+        // to LlmError below), so the only thing this `try` can add is a richer
+        // provider-supplied message.
       }
       throw new LlmError(message, code, response.status)
     }

packages/llm/llm-deepseek/src/index.ts

@@ -1,20 +1,6 @@
 /**
- * DeepSeek LLM adapter plugin: registers a {@link DeepSeekAdapter} for the
- * configured model names on `ctx.llm`.
- *
- * Config is cordis-native (schemastery). Secrets flow per the repo policy:
- * `apiKey` from cordis.yml via the `!!js` tag (`!!js process.env.DEEPSEEK_API_KEY`)
- * or from the environment directly; never from ad-hoc files.
- *
- * ```yaml
- * - id: llm-deepseek
- *   name: '@deepseek-ai/dsh-llm-deepseek'
- *   config:
- *     apiKey: !!js process.env.DEEPSEEK_API_KEY
- *     baseURL: !!js process.env.DEEPSEEK_BASE_URL
- *     models: [deepseek-v4-flash, deepseek-v4-pro]
- * ```
- *
+ * DeepSeek LLM adapter plugin: registers a {@link DeepSeekAdapter} for the configured model
+ * names on `ctx.llm`.
  * @module @deepseek-ai/dsh-llm-deepseek
  */
 

packages/llm/llm-deepseek/src/serialize.ts

@@ -1,17 +1,6 @@
 /**
- * Serialize harness vocabulary (`GenerateOptions`, `Message[]`) into the
- * DeepSeek chat-completions request body.
- *
- * Block-type mapping (core types handled explicitly; merge-extensible unions
- * mean plugin-added block types exist — they are skipped, never errors):
- *
- * - user `text` → string content (joined)
- * - assistant `text` → `content`; `reasoning` → `reasoning_content`, but
- *   ONLY on assistant messages that carry tool calls (the official passback
- *   rule for thinking mode — required there, ignored elsewhere, so we save
- *   the tokens elsewhere); `tool-call` → `tool_calls[]`
- * - `tool-result` → its own `{role: 'tool'}` message (text flattened)
- *
+ * Serialize harness vocabulary (`GenerateOptions`, `Message[]`) into the DeepSeek
+ * chat-completions request body.
  * @module dsh-llm-deepseek/serialize
  */
 

packages/llm/llm-deepseek/src/sse.ts

@@ -1,15 +1,5 @@
 /**
  * Minimal SSE (text/event-stream) parser for the chat-completions stream.
- *
- * Yields each event's `data:` payload as a string, ending with the literal
- * `'[DONE]'` sentinel so the consumer owns end-of-stream flushing. A stream
- * that closes WITHOUT `[DONE]` is a protocol violation → `LlmError`.
- *
- * Handles the wire realities: payloads split across network reads at
- * arbitrary byte positions (including mid-UTF-8), CRLF line endings,
- * multi-`data:` events (joined with newlines per the SSE spec), comment
- * lines, and non-data fields (ignored).
- *
  * @module dsh-llm-deepseek/sse
  */
 

packages/llm/llm-deepseek/src/translate.ts

@@ -1,16 +1,5 @@
 /**
  * Translate DeepSeek wire chunks into the harness `StreamChunk` protocol.
- *
- * A small state machine over the SSE payload stream:
- * - `delta.content` / `delta.reasoning_content` / `delta.tool_calls[i]` each
- *   own one harness block (index allocated on first sight). The first
- *   thinking-mode chunk carries `reasoning_content: ""` — that must NOT open
- *   a reasoning block.
- * - `finish_reason` and `usage` are DEFERRED: emitted only at the `[DONE]`
- *   sentinel, so the wire's two usage shapes (attached to the finish chunk,
- *   or a trailing usage-only chunk) both work and nothing ever follows
- *   `finish`. Last usage wins.
- *
  * @module dsh-llm-deepseek/translate
  */