docs: JSDoc the ServeStreamOptions interface and server option properties

Restore API-doc coverage: document ServeStreamOptions and the VgiRpcServer
constructor option properties (enableDescribe, serverId, dispatchHook,
externalLocation, protocolVersion).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: rustyconover

dist/index.js.map

@@ -20,10 +20,15 @@ export declare class VgiRpcServer {
      *  re-fires rather than silently skipping. Mirrors Python 7b3999c. */
     private serveStartFired;
     constructor(protocol: Protocol, options?: {
+        /** Enable the `describe` RPC method (service self-description). Default `true`. */
         enableDescribe?: boolean;
+        /** Opaque per-process server identifier surfaced to clients and the landing page. */
         serverId?: string;
+        /** Hook invoked around each dispatched request (tracing/metrics/auth enrichment). */
         dispatchHook?: DispatchHook;
+        /** Configuration for externalizing oversized record batches to blob storage. */
         externalLocation?: ExternalLocationConfig;
+        /** Protocol version string reported in the service description. */
         protocolVersion?: string;
         /** Lifecycle hook fired once before the first dispatched request. */
         onServeStart?: ServeStartHook;

dist/server.d.ts

@@ -14,6 +14,7 @@ import type { Protocol } from "./protocol.js";
 import { VgiRpcServer } from "./server.js";
 import { TransportKind } from "./types.js";
 
+/** Options for {@link serveStream} — a single RPC session over one stream pair. */
 export interface ServeStreamOptions {
   /** Incoming request bytes — a web `ReadableStream<Uint8Array>` or a Node
    *  `Readable` (e.g. a `Duplex` bridging a MessagePort). */

dist/server.d.ts.map

@@ -68,10 +68,15 @@ export class VgiRpcServer {
   constructor(
     protocol: Protocol,
     options?: {
+      /** Enable the `describe` RPC method (service self-description). Default `true`. */
       enableDescribe?: boolean;
+      /** Opaque per-process server identifier surfaced to clients and the landing page. */
       serverId?: string;
+      /** Hook invoked around each dispatched request (tracing/metrics/auth enrichment). */
       dispatchHook?: DispatchHook;
+      /** Configuration for externalizing oversized record batches to blob storage. */
       externalLocation?: ExternalLocationConfig;
+      /** Protocol version string reported in the service description. */
       protocolVersion?: string;
       /** Lifecycle hook fired once before the first dispatched request. */
       onServeStart?: ServeStartHook;