@directive-run/ai 1.13.0 → 1.14.0

package/dist/devtools.d.cts

@@ -0,0 +1,354 @@
+import { D as DebugTimeline } from './debug-timeline-DpnRMnLU.cjs';
+export { a as DebugTimelineListener, b as DebugTimelineOptions, c as createDebugTimeline, d as createDebugTimelinePlugin } from './debug-timeline-DpnRMnLU.cjs';
+import { A as AgentHealthMetrics, H as HealthMonitor } from './health-monitor-C6xoXrQz.cjs';
+export { a as HealthCircuitState, c as createHealthMonitor } from './health-monitor-C6xoXrQz.cjs';
+import { l as DebugEvent, b8 as BreakpointState } from './types-DJ09LjZX.cjs';
+import '@directive-run/core';
+
+/**
+ * DevTools Server — WebSocket-based bridge between orchestrators and DevTools UI.
+ *
+ * Streams debug timeline events, health metrics, breakpoint state, and system
+ * snapshots in real-time to connected DevTools clients. Accepts commands from
+ * clients to resume/cancel breakpoints and request snapshots.
+ *
+ * Transport-agnostic: works with any WebSocket implementation (ws, Bun, Deno)
+ * via the {@link DevToolsTransport} interface.
+ *
+ * @module
+ */
+
+/** A connected DevTools client */
+interface DevToolsClient {
+    /** Send a JSON-serializable message to this client */
+    send(data: string): void;
+    /** Close the connection */
+    close(): void;
+}
+/**
+ * Transport layer for the DevTools server.
+ *
+ * Implement this interface to bridge any WebSocket library (ws, Bun.serve, Deno.serve).
+ *
+ * @example Node.js with `ws`:
+ * ```typescript
+ * import { WebSocketServer } from "ws";
+ *
+ * function createWsTransport(port: number): DevToolsTransport {
+ *   const wss = new WebSocketServer({ port });
+ *   let onConnect: ((client: DevToolsClient) => void) | null = null;
+ *
+ *   wss.on("connection", (ws) => {
+ *     const client: DevToolsClient = {
+ *       send: (data) => { if (ws.readyState === ws.OPEN) ws.send(data); },
+ *       close: () => ws.close(),
+ *     };
+ *     ws.on("message", (raw) => {
+ *       if (client._onMessage) client._onMessage(raw.toString());
+ *     });
+ *     ws.on("close", () => {
+ *       if (client._onClose) client._onClose();
+ *     });
+ *     onConnect?.(client);
+ *   });
+ *
+ *   return {
+ *     onConnection(handler) { onConnect = handler; },
+ *     close() { wss.close(); },
+ *   };
+ * }
+ * ```
+ */
+interface DevToolsTransport {
+    /** Register a handler for new client connections */
+    onConnection(handler: (client: DevToolsClient, onMessage: (handler: (data: string) => void) => void, onClose: (handler: () => void) => void) => void): void;
+    /** Shut down the transport */
+    close(): void;
+}
+/** Messages sent FROM the server TO clients */
+type DevToolsServerMessage = {
+    type: "welcome";
+    version: number;
+    sessionId: string;
+    timestamp: number;
+} | {
+    type: "event";
+    event: DebugEvent;
+} | {
+    type: "event_batch";
+    events: DebugEvent[];
+} | {
+    type: "snapshot";
+    data: DevToolsSnapshot;
+} | {
+    type: "health";
+    metrics: Record<string, AgentHealthMetrics>;
+} | {
+    type: "breakpoints";
+    state: BreakpointState;
+} | {
+    type: "pong";
+    timestamp: number;
+} | {
+    type: "scratchpad_state";
+    data: Record<string, unknown>;
+} | {
+    type: "scratchpad_update";
+    key: string;
+    value: unknown;
+} | {
+    type: "derived_state";
+    data: Record<string, unknown>;
+} | {
+    type: "derived_update";
+    id: string;
+    value: unknown;
+} | {
+    type: "fork_complete";
+    eventId: number;
+    newEventCount: number;
+} | {
+    type: "token_stream";
+    agentId: string;
+    tokens: string;
+    tokenCount: number;
+} | {
+    type: "stream_done";
+    agentId: string;
+    totalTokens: number;
+} | {
+    type: "error";
+    code: string;
+    message: string;
+};
+/** Messages sent FROM clients TO the server */
+type DevToolsClientMessage = {
+    type: "authenticate";
+    token: string;
+} | {
+    type: "request_snapshot";
+} | {
+    type: "request_health";
+} | {
+    type: "request_events";
+    since?: number;
+} | {
+    type: "request_breakpoints";
+} | {
+    type: "resume_breakpoint";
+    breakpointId: string;
+    modifications?: {
+        input?: string;
+        skip?: boolean;
+    };
+} | {
+    type: "cancel_breakpoint";
+    breakpointId: string;
+    reason?: string;
+} | {
+    type: "export_session";
+} | {
+    type: "import_session";
+    data: string;
+} | {
+    type: "request_scratchpad";
+} | {
+    type: "request_derived";
+} | {
+    type: "fork_from_snapshot";
+    eventId: number;
+} | {
+    type: "ping";
+};
+/** System snapshot sent to clients on demand */
+interface DevToolsSnapshot {
+    timestamp: number;
+    agents: Record<string, {
+        status: string;
+        lastInput?: string;
+        lastOutput?: unknown;
+        totalTokens: number;
+        runCount: number;
+    }>;
+    coordinator?: {
+        globalTokens: number;
+        status: string;
+    };
+    derived?: Record<string, unknown>;
+    eventCount: number;
+}
+/** Configuration for the DevTools server */
+interface DevToolsServerConfig {
+    /** Transport to use for WebSocket connections */
+    transport: DevToolsTransport;
+    /** Debug timeline to subscribe to */
+    timeline: DebugTimeline;
+    /** Health monitor for metrics (optional) */
+    healthMonitor?: HealthMonitor | null;
+    /** Callback to get current agent states for snapshots */
+    getSnapshot?: () => DevToolsSnapshot;
+    /** Callback to get current breakpoint state */
+    getBreakpointState?: () => BreakpointState;
+    /** Callback to resume a breakpoint */
+    onResumeBreakpoint?: (id: string, modifications?: {
+        input?: string;
+        skip?: boolean;
+    }) => void;
+    /** Callback to cancel a breakpoint */
+    onCancelBreakpoint?: (id: string, reason?: string) => void;
+    /** Callback to get current scratchpad state */
+    getScratchpadState?: () => Record<string, unknown>;
+    /** Callback to get current derived state */
+    getDerivedState?: () => Record<string, unknown>;
+    /** Callback to fork from a snapshot event */
+    onForkFromSnapshot?: (eventId: number) => {
+        newEventCount: number;
+    };
+    /** Maximum events to batch before flushing. Default: 1 (no batching) */
+    batchSize?: number;
+    /** Flush interval for batched events (ms). Default: 50 */
+    batchIntervalMs?: number;
+    /** Health metrics push interval (ms). 0 = no auto-push. Default: 0 */
+    healthPushIntervalMs?: number;
+    /** Maximum connected clients. Default: 50 */
+    maxClients?: number;
+    /** Token authentication callback. When set, new connections must send an `authenticate` message before receiving data. */
+    authenticate?: (token: string) => boolean | Promise<boolean>;
+}
+/** DevTools server instance */
+interface DevToolsServer {
+    /** Number of connected clients */
+    readonly clientCount: number;
+    /** Broadcast a message to all connected clients */
+    broadcast(message: DevToolsServerMessage): void;
+    /** Push current health metrics to all clients */
+    pushHealth(): void;
+    /** Push current breakpoint state to all clients */
+    pushBreakpoints(): void;
+    /** Push a scratchpad key update to all clients */
+    pushScratchpadUpdate(key: string, value: unknown): void;
+    /** Push a derived value update to all clients */
+    pushDerivedUpdate(id: string, value: unknown): void;
+    /** Push streaming tokens to all clients */
+    pushTokenStream(agentId: string, tokens: string, tokenCount: number): void;
+    /** Signal stream completion to all clients */
+    pushStreamDone(agentId: string, totalTokens: number): void;
+    /** Shut down the server and disconnect all clients */
+    close(): void;
+}
+/**
+ * Create a DevTools server that bridges orchestrator state to DevTools UI clients.
+ *
+ * @example
+ * ```typescript
+ * const server = createDevToolsServer({
+ *   transport: createWsTransport(4040),
+ *   timeline: orchestrator.timeline!,
+ *   healthMonitor: orchestrator.healthMonitor,
+ *   getSnapshot: () => buildSnapshot(orchestrator),
+ *   getBreakpointState: () => orchestrator.getBreakpointState(),
+ *   onResumeBreakpoint: (id, mods) => orchestrator.resumeBreakpoint(id, mods),
+ *   onCancelBreakpoint: (id, reason) => orchestrator.cancelBreakpoint(id, reason),
+ * });
+ * ```
+ */
+declare function createDevToolsServer(config: DevToolsServerConfig): DevToolsServer;
+/** Options for connecting DevTools to an orchestrator */
+interface ConnectDevToolsOptions {
+    /** Port for the WebSocket server. Default: 4040 */
+    port?: number;
+    /** Host to bind to. Default: "localhost" */
+    host?: string;
+    /** Health metrics push interval (ms). Default: 5000 */
+    healthPushIntervalMs?: number;
+    /** Event batching size. Default: 1 (no batching) */
+    batchSize?: number;
+    /** Token authentication callback. When set, clients must authenticate before receiving data. */
+    authenticate?: (token: string) => boolean | Promise<boolean>;
+}
+/** Minimal orchestrator interface for DevTools connection */
+interface DevToolsCompatibleOrchestrator {
+    timeline: {
+        subscribe: (listener: (event: DebugEvent) => void) => () => void;
+        getEvents: () => DebugEvent[];
+        import: (json: string) => void;
+        export: () => string;
+        forkFrom?: (eventId: number) => void;
+    } | null;
+    healthMonitor?: {
+        getAllMetrics: () => Record<string, AgentHealthMetrics>;
+    } | null;
+    getPendingBreakpoints?: () => Array<{
+        id: string;
+        type: string;
+        agentId: string;
+        input: string;
+        label?: string;
+        requestedAt: number;
+    }>;
+    resumeBreakpoint?: (id: string, modifications?: {
+        input?: string;
+        skip?: boolean;
+    }) => void;
+    cancelBreakpoint?: (id: string, reason?: string) => void;
+    getAllAgentStates?: () => Record<string, {
+        status: string;
+        lastInput?: string;
+        lastOutput?: unknown;
+        totalTokens: number;
+        runCount: number;
+    }>;
+    /** Get current scratchpad state (multi-agent only) */
+    getScratchpadState?: () => Record<string, unknown>;
+    /** Get current derived values (multi-agent only) */
+    getDerivedState?: () => Record<string, unknown>;
+}
+/**
+ * Connect DevTools to an orchestrator instance.
+ *
+ * Convenience function that creates a WebSocket transport and DevTools server,
+ * automatically wiring up the orchestrator's timeline, health monitor, and breakpoint system.
+ *
+ * Requires the `ws` package: `npm install ws`
+ *
+ * **Security:** Binding to `0.0.0.0` exposes the server to all network interfaces.
+ * Only do this behind a firewall or with proper authentication.
+ *
+ * @example
+ * ```typescript
+ * const orchestrator = createMultiAgentOrchestrator({ debug: true, ... });
+ * const devtools = await connectDevTools(orchestrator, { port: 4040 });
+ *
+ * // Later, clean up:
+ * devtools.close();
+ * ```
+ */
+declare function connectDevTools(orchestrator: DevToolsCompatibleOrchestrator, options?: ConnectDevToolsOptions): Promise<DevToolsServer>;
+/**
+ * Configuration for the built-in Node.js `ws` transport.
+ *
+ * Requires the `ws` package to be installed: `npm install ws`
+ */
+interface WsTransportConfig {
+    /** Port to listen on. Default: 4040 */
+    port?: number;
+    /** Host to bind to. Default: "localhost" */
+    host?: string;
+    /** Maximum incoming message size in bytes. Default: 1048576 (1MB) */
+    maxPayloadBytes?: number;
+}
+/**
+ * Create a DevTools transport using the Node.js `ws` WebSocket library.
+ *
+ * This is a convenience helper — you can implement {@link DevToolsTransport}
+ * with any WebSocket library.
+ *
+ * @example
+ * ```typescript
+ * const transport = await createWsTransport({ port: 4040 });
+ * const server = createDevToolsServer({ transport, timeline });
+ * ```
+ */
+declare function createWsTransport(config?: WsTransportConfig): Promise<DevToolsTransport>;
+
+export { AgentHealthMetrics, type ConnectDevToolsOptions, DebugTimeline, type DevToolsClient, type DevToolsClientMessage, type DevToolsCompatibleOrchestrator, type DevToolsServer, type DevToolsServerConfig, type DevToolsServerMessage, type DevToolsSnapshot, type DevToolsTransport, HealthMonitor, type WsTransportConfig, connectDevTools, createDevToolsServer, createWsTransport };

package/dist/devtools.d.ts

@@ -0,0 +1,354 @@
+import { D as DebugTimeline } from './debug-timeline-L13P-U2I.js';
+export { a as DebugTimelineListener, b as DebugTimelineOptions, c as createDebugTimeline, d as createDebugTimelinePlugin } from './debug-timeline-L13P-U2I.js';
+import { A as AgentHealthMetrics, H as HealthMonitor } from './health-monitor-qL9RNMH3.js';
+export { a as HealthCircuitState, c as createHealthMonitor } from './health-monitor-qL9RNMH3.js';
+import { l as DebugEvent, b8 as BreakpointState } from './types-DJ09LjZX.js';
+import '@directive-run/core';
+
+/**
+ * DevTools Server — WebSocket-based bridge between orchestrators and DevTools UI.
+ *
+ * Streams debug timeline events, health metrics, breakpoint state, and system
+ * snapshots in real-time to connected DevTools clients. Accepts commands from
+ * clients to resume/cancel breakpoints and request snapshots.
+ *
+ * Transport-agnostic: works with any WebSocket implementation (ws, Bun, Deno)
+ * via the {@link DevToolsTransport} interface.
+ *
+ * @module
+ */
+
+/** A connected DevTools client */
+interface DevToolsClient {
+    /** Send a JSON-serializable message to this client */
+    send(data: string): void;
+    /** Close the connection */
+    close(): void;
+}
+/**
+ * Transport layer for the DevTools server.
+ *
+ * Implement this interface to bridge any WebSocket library (ws, Bun.serve, Deno.serve).
+ *
+ * @example Node.js with `ws`:
+ * ```typescript
+ * import { WebSocketServer } from "ws";
+ *
+ * function createWsTransport(port: number): DevToolsTransport {
+ *   const wss = new WebSocketServer({ port });
+ *   let onConnect: ((client: DevToolsClient) => void) | null = null;
+ *
+ *   wss.on("connection", (ws) => {
+ *     const client: DevToolsClient = {
+ *       send: (data) => { if (ws.readyState === ws.OPEN) ws.send(data); },
+ *       close: () => ws.close(),
+ *     };
+ *     ws.on("message", (raw) => {
+ *       if (client._onMessage) client._onMessage(raw.toString());
+ *     });
+ *     ws.on("close", () => {
+ *       if (client._onClose) client._onClose();
+ *     });
+ *     onConnect?.(client);
+ *   });
+ *
+ *   return {
+ *     onConnection(handler) { onConnect = handler; },
+ *     close() { wss.close(); },
+ *   };
+ * }
+ * ```
+ */
+interface DevToolsTransport {
+    /** Register a handler for new client connections */
+    onConnection(handler: (client: DevToolsClient, onMessage: (handler: (data: string) => void) => void, onClose: (handler: () => void) => void) => void): void;
+    /** Shut down the transport */
+    close(): void;
+}
+/** Messages sent FROM the server TO clients */
+type DevToolsServerMessage = {
+    type: "welcome";
+    version: number;
+    sessionId: string;
+    timestamp: number;
+} | {
+    type: "event";
+    event: DebugEvent;
+} | {
+    type: "event_batch";
+    events: DebugEvent[];
+} | {
+    type: "snapshot";
+    data: DevToolsSnapshot;
+} | {
+    type: "health";
+    metrics: Record<string, AgentHealthMetrics>;
+} | {
+    type: "breakpoints";
+    state: BreakpointState;
+} | {
+    type: "pong";
+    timestamp: number;
+} | {
+    type: "scratchpad_state";
+    data: Record<string, unknown>;
+} | {
+    type: "scratchpad_update";
+    key: string;
+    value: unknown;
+} | {
+    type: "derived_state";
+    data: Record<string, unknown>;
+} | {
+    type: "derived_update";
+    id: string;
+    value: unknown;
+} | {
+    type: "fork_complete";
+    eventId: number;
+    newEventCount: number;
+} | {
+    type: "token_stream";
+    agentId: string;
+    tokens: string;
+    tokenCount: number;
+} | {
+    type: "stream_done";
+    agentId: string;
+    totalTokens: number;
+} | {
+    type: "error";
+    code: string;
+    message: string;
+};
+/** Messages sent FROM clients TO the server */
+type DevToolsClientMessage = {
+    type: "authenticate";
+    token: string;
+} | {
+    type: "request_snapshot";
+} | {
+    type: "request_health";
+} | {
+    type: "request_events";
+    since?: number;
+} | {
+    type: "request_breakpoints";
+} | {
+    type: "resume_breakpoint";
+    breakpointId: string;
+    modifications?: {
+        input?: string;
+        skip?: boolean;
+    };
+} | {
+    type: "cancel_breakpoint";
+    breakpointId: string;
+    reason?: string;
+} | {
+    type: "export_session";
+} | {
+    type: "import_session";
+    data: string;
+} | {
+    type: "request_scratchpad";
+} | {
+    type: "request_derived";
+} | {
+    type: "fork_from_snapshot";
+    eventId: number;
+} | {
+    type: "ping";
+};
+/** System snapshot sent to clients on demand */
+interface DevToolsSnapshot {
+    timestamp: number;
+    agents: Record<string, {
+        status: string;
+        lastInput?: string;
+        lastOutput?: unknown;
+        totalTokens: number;
+        runCount: number;
+    }>;
+    coordinator?: {
+        globalTokens: number;
+        status: string;
+    };
+    derived?: Record<string, unknown>;
+    eventCount: number;
+}
+/** Configuration for the DevTools server */
+interface DevToolsServerConfig {
+    /** Transport to use for WebSocket connections */
+    transport: DevToolsTransport;
+    /** Debug timeline to subscribe to */
+    timeline: DebugTimeline;
+    /** Health monitor for metrics (optional) */
+    healthMonitor?: HealthMonitor | null;
+    /** Callback to get current agent states for snapshots */
+    getSnapshot?: () => DevToolsSnapshot;
+    /** Callback to get current breakpoint state */
+    getBreakpointState?: () => BreakpointState;
+    /** Callback to resume a breakpoint */
+    onResumeBreakpoint?: (id: string, modifications?: {
+        input?: string;
+        skip?: boolean;
+    }) => void;
+    /** Callback to cancel a breakpoint */
+    onCancelBreakpoint?: (id: string, reason?: string) => void;
+    /** Callback to get current scratchpad state */
+    getScratchpadState?: () => Record<string, unknown>;
+    /** Callback to get current derived state */
+    getDerivedState?: () => Record<string, unknown>;
+    /** Callback to fork from a snapshot event */
+    onForkFromSnapshot?: (eventId: number) => {
+        newEventCount: number;
+    };
+    /** Maximum events to batch before flushing. Default: 1 (no batching) */
+    batchSize?: number;
+    /** Flush interval for batched events (ms). Default: 50 */
+    batchIntervalMs?: number;
+    /** Health metrics push interval (ms). 0 = no auto-push. Default: 0 */
+    healthPushIntervalMs?: number;
+    /** Maximum connected clients. Default: 50 */
+    maxClients?: number;
+    /** Token authentication callback. When set, new connections must send an `authenticate` message before receiving data. */
+    authenticate?: (token: string) => boolean | Promise<boolean>;
+}
+/** DevTools server instance */
+interface DevToolsServer {
+    /** Number of connected clients */
+    readonly clientCount: number;
+    /** Broadcast a message to all connected clients */
+    broadcast(message: DevToolsServerMessage): void;
+    /** Push current health metrics to all clients */
+    pushHealth(): void;
+    /** Push current breakpoint state to all clients */
+    pushBreakpoints(): void;
+    /** Push a scratchpad key update to all clients */
+    pushScratchpadUpdate(key: string, value: unknown): void;
+    /** Push a derived value update to all clients */
+    pushDerivedUpdate(id: string, value: unknown): void;
+    /** Push streaming tokens to all clients */
+    pushTokenStream(agentId: string, tokens: string, tokenCount: number): void;
+    /** Signal stream completion to all clients */
+    pushStreamDone(agentId: string, totalTokens: number): void;
+    /** Shut down the server and disconnect all clients */
+    close(): void;
+}
+/**
+ * Create a DevTools server that bridges orchestrator state to DevTools UI clients.
+ *
+ * @example
+ * ```typescript
+ * const server = createDevToolsServer({
+ *   transport: createWsTransport(4040),
+ *   timeline: orchestrator.timeline!,
+ *   healthMonitor: orchestrator.healthMonitor,
+ *   getSnapshot: () => buildSnapshot(orchestrator),
+ *   getBreakpointState: () => orchestrator.getBreakpointState(),
+ *   onResumeBreakpoint: (id, mods) => orchestrator.resumeBreakpoint(id, mods),
+ *   onCancelBreakpoint: (id, reason) => orchestrator.cancelBreakpoint(id, reason),
+ * });
+ * ```
+ */
+declare function createDevToolsServer(config: DevToolsServerConfig): DevToolsServer;
+/** Options for connecting DevTools to an orchestrator */
+interface ConnectDevToolsOptions {
+    /** Port for the WebSocket server. Default: 4040 */
+    port?: number;
+    /** Host to bind to. Default: "localhost" */
+    host?: string;
+    /** Health metrics push interval (ms). Default: 5000 */
+    healthPushIntervalMs?: number;
+    /** Event batching size. Default: 1 (no batching) */
+    batchSize?: number;
+    /** Token authentication callback. When set, clients must authenticate before receiving data. */
+    authenticate?: (token: string) => boolean | Promise<boolean>;
+}
+/** Minimal orchestrator interface for DevTools connection */
+interface DevToolsCompatibleOrchestrator {
+    timeline: {
+        subscribe: (listener: (event: DebugEvent) => void) => () => void;
+        getEvents: () => DebugEvent[];
+        import: (json: string) => void;
+        export: () => string;
+        forkFrom?: (eventId: number) => void;
+    } | null;
+    healthMonitor?: {
+        getAllMetrics: () => Record<string, AgentHealthMetrics>;
+    } | null;
+    getPendingBreakpoints?: () => Array<{
+        id: string;
+        type: string;
+        agentId: string;
+        input: string;
+        label?: string;
+        requestedAt: number;
+    }>;
+    resumeBreakpoint?: (id: string, modifications?: {
+        input?: string;
+        skip?: boolean;
+    }) => void;
+    cancelBreakpoint?: (id: string, reason?: string) => void;
+    getAllAgentStates?: () => Record<string, {
+        status: string;
+        lastInput?: string;
+        lastOutput?: unknown;
+        totalTokens: number;
+        runCount: number;
+    }>;
+    /** Get current scratchpad state (multi-agent only) */
+    getScratchpadState?: () => Record<string, unknown>;
+    /** Get current derived values (multi-agent only) */
+    getDerivedState?: () => Record<string, unknown>;
+}
+/**
+ * Connect DevTools to an orchestrator instance.
+ *
+ * Convenience function that creates a WebSocket transport and DevTools server,
+ * automatically wiring up the orchestrator's timeline, health monitor, and breakpoint system.
+ *
+ * Requires the `ws` package: `npm install ws`
+ *
+ * **Security:** Binding to `0.0.0.0` exposes the server to all network interfaces.
+ * Only do this behind a firewall or with proper authentication.
+ *
+ * @example
+ * ```typescript
+ * const orchestrator = createMultiAgentOrchestrator({ debug: true, ... });
+ * const devtools = await connectDevTools(orchestrator, { port: 4040 });
+ *
+ * // Later, clean up:
+ * devtools.close();
+ * ```
+ */
+declare function connectDevTools(orchestrator: DevToolsCompatibleOrchestrator, options?: ConnectDevToolsOptions): Promise<DevToolsServer>;
+/**
+ * Configuration for the built-in Node.js `ws` transport.
+ *
+ * Requires the `ws` package to be installed: `npm install ws`
+ */
+interface WsTransportConfig {
+    /** Port to listen on. Default: 4040 */
+    port?: number;
+    /** Host to bind to. Default: "localhost" */
+    host?: string;
+    /** Maximum incoming message size in bytes. Default: 1048576 (1MB) */
+    maxPayloadBytes?: number;
+}
+/**
+ * Create a DevTools transport using the Node.js `ws` WebSocket library.
+ *
+ * This is a convenience helper — you can implement {@link DevToolsTransport}
+ * with any WebSocket library.
+ *
+ * @example
+ * ```typescript
+ * const transport = await createWsTransport({ port: 4040 });
+ * const server = createDevToolsServer({ transport, timeline });
+ * ```
+ */
+declare function createWsTransport(config?: WsTransportConfig): Promise<DevToolsTransport>;
+
+export { AgentHealthMetrics, type ConnectDevToolsOptions, DebugTimeline, type DevToolsClient, type DevToolsClientMessage, type DevToolsCompatibleOrchestrator, type DevToolsServer, type DevToolsServerConfig, type DevToolsServerMessage, type DevToolsSnapshot, type DevToolsTransport, HealthMonitor, type WsTransportConfig, connectDevTools, createDevToolsServer, createWsTransport };

package/dist/devtools.js

@@ -0,0 +1,2 @@
+export{b as connectDevTools,a as createDevToolsServer,c as createWsTransport}from'./chunk-5JQ2A3JK.js';export{a as createDebugTimeline,b as createDebugTimelinePlugin,c as createHealthMonitor}from'./chunk-FBT73WFY.js';//# sourceMappingURL=devtools.js.map
+//# sourceMappingURL=devtools.js.map