docs(dx): document config-interface members (ChatConfig/AgentConfig/RenderConfig)

The objects app developers fill in when wiring the framework now carry both an
interface-level summary and per-member JSDoc:
- chat ChatConfig: interface summary (members were already documented)
- ag-ui AgentConfig: url/agentId/threadId/headers member docs + clean summary
- render RenderConfig: interface summary + registry/store/functions/handlers docs
(langgraph AgentConfig was already fully documented.)

chat/ag-ui/render build green; api-docs regenerated.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: blove

apps/website/content/docs/ag-ui/api/api-docs.json

@@ -367,18 +367,18 @@
   {
     "name": "AgentConfig",
     "kind": "interface",
-    "description": "Configuration for the AG-UI agent provider.\nHttpAgentConfig shape (from @ag-ui/client@0.0.52):\n  - url: string (required) — endpoint for the HTTP agent\n  - agentId: string (optional) — agent identifier\n  - threadId: string (optional) — thread identifier\n  - headers: Record<string, string> (optional) — custom HTTP headers",
+    "description": "Connection options for the AG-UI agent provider, passed to provideAgent.\nMirrors the underlying `HttpAgent` config (`@ag-ui/client`) plus an optional\ntelemetry sink.",
     "properties": [
       {
         "name": "agentId",
         "type": "string",
-        "description": "",
+        "description": "Agent identifier, when the endpoint serves more than one agent.",
         "optional": true
       },
       {
         "name": "headers",
         "type": "Record<string, string>",
-        "description": "",
+        "description": "Extra HTTP headers sent with every request (e.g. auth tokens).",
         "optional": true
       },
       {
@@ -390,13 +390,13 @@
       {
         "name": "threadId",
         "type": "string",
-        "description": "",
+        "description": "Thread to connect to on start; omit to begin a fresh conversation.",
         "optional": true
       },
       {
         "name": "url",
         "type": "string",
-        "description": "",
+        "description": "Endpoint URL of the AG-UI HTTP agent (e.g. `'http://localhost:8000/agent'`). Required.",
         "optional": false
       }
     ],

apps/website/content/docs/chat/api/api-docs.json

@@ -5887,7 +5887,7 @@
   {
     "name": "ChatConfig",
     "kind": "interface",
-    "description": "",
+    "description": "Application-wide options for provideChat. Every field is optional;\nthe values are exposed to all chat components in the tree via the\n`CHAT_CONFIG` injection token, so you set them once at bootstrap instead of\nthreading props through every component.",
     "properties": [
       {
         "name": "__licenseEnvHint",

apps/website/content/docs/render/api/api-docs.json

@@ -251,30 +251,30 @@
   {
     "name": "RenderConfig",
     "kind": "interface",
-    "description": "",
+    "description": "Options for provideRender — the registry, state, computed functions,\nand action handlers the render engine uses to turn a spec into live Angular\ncomponents. Every field is optional.",
     "properties": [
       {
         "name": "functions",
         "type": "Record<string, ComputedFunction>",
-        "description": "",
+        "description": "Named computed functions a spec can reference (e.g. via `$compute`) to derive values from state.",
         "optional": true
       },
       {
         "name": "handlers",
         "type": "Record<string, (params: Record<string, unknown>) => unknown>",
-        "description": "",
+        "description": "Named action handlers invoked when interactive elements fire (e.g. a Button's `onClick`).",
         "optional": true
       },
       {
         "name": "registry",
         "type": "AngularRegistry",
-        "description": "",
+        "description": "Component registry mapping spec element `type`s to Angular components.",
         "optional": true
       },
       {
         "name": "store",
         "type": "StateStore",
-        "description": "",
+        "description": "Backing state store that `$bindState` paths read from and interactive elements write to.",
         "optional": true
       }
     ],

libs/ag-ui/src/lib/provide-agent.ts

@@ -5,17 +5,18 @@ import type { AgentRef, AgentRuntimeTelemetrySink } from '@threadplane/chat';
 import { toAgent, type AgUiAgent } from './to-agent';
 
 /**
- * Configuration for the AG-UI agent provider.
- * HttpAgentConfig shape (from @ag-ui/client@0.0.52):
- *   - url: string (required) — endpoint for the HTTP agent
- *   - agentId: string (optional) — agent identifier
- *   - threadId: string (optional) — thread identifier
- *   - headers: Record<string, string> (optional) — custom HTTP headers
+ * Connection options for the AG-UI agent provider, passed to {@link provideAgent}.
+ * Mirrors the underlying `HttpAgent` config (`@ag-ui/client`) plus an optional
+ * telemetry sink.
  */
 export interface AgentConfig {
+  /** Endpoint URL of the AG-UI HTTP agent (e.g. `'http://localhost:8000/agent'`). Required. */
   url: string;
+  /** Agent identifier, when the endpoint serves more than one agent. */
   agentId?: string;
+  /** Thread to connect to on start; omit to begin a fresh conversation. */
   threadId?: string;
+  /** Extra HTTP headers sent with every request (e.g. auth tokens). */
   headers?: Record<string, string>;
   /** Optional app-owned telemetry sink. No telemetry is emitted unless this is provided. */
   telemetry?: AgentRuntimeTelemetrySink | false;

libs/chat/src/lib/provide-chat.ts

@@ -9,6 +9,12 @@ import type { AngularRegistry } from '@threadplane/render';
 
 const PACKAGE_NAME = '@threadplane/chat';
 
+/**
+ * Application-wide options for {@link provideChat}. Every field is optional;
+ * the values are exposed to all chat components in the tree via the
+ * `CHAT_CONFIG` injection token, so you set them once at bootstrap instead of
+ * threading props through every component.
+ */
 export interface ChatConfig {
   /** Shared render registry for consumers that read CHAT_CONFIG. */
   renderRegistry?: AngularRegistry;

libs/render/src/lib/render.types.ts

@@ -58,9 +58,18 @@ export interface AngularRegistry {
   names(): string[];
 }
 
+/**
+ * Options for {@link provideRender} — the registry, state, computed functions,
+ * and action handlers the render engine uses to turn a spec into live Angular
+ * components. Every field is optional.
+ */
 export interface RenderConfig {
+  /** Component registry mapping spec element `type`s to Angular components. */
   registry?: AngularRegistry;
+  /** Backing state store that `$bindState` paths read from and interactive elements write to. */
   store?: StateStore;
+  /** Named computed functions a spec can reference (e.g. via `$compute`) to derive values from state. */
   functions?: Record<string, ComputedFunction>;
+  /** Named action handlers invoked when interactive elements fire (e.g. a Button's `onClick`). */
   handlers?: Record<string, (params: Record<string, unknown>) => unknown | Promise<unknown>>;
 }