docs: rebalance prose cleanup and add trimming skill

packages/llm/llm/src/index.ts

@@ -54,7 +54,10 @@ export class LlmError extends HarnessError {
 }
 
 /**
- * Base class for LLM provider adapters.
+ * Provider-wire adapter for the harness message and stream vocabulary. Register implementations
+ * with `ctx.llm.registerAdapter(models, adapter)`. Every provider HTTP request must include
+ * `attributionHeaders()`; prove that at the wire or library header-hook boundary. The hand-rolled
+ * DeepSeek and pi-ai adapters intentionally exercise this contract through different internals.
  */
 export abstract class LlmAdapter {
   /**