@a5c-ai/genty-platform 5.1.1-staging.00ceebd28cf2

package/dist/mcp/client/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Status: Integrated with agent-platform MCP orchestration wiring.
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-REMOTE-006: MCP Client types.
+ *
+ * Defines server configuration, connection status, and tool metadata
+ * for the MCP client infrastructure.
+ */
+/** Transport type for MCP server connections. */
+export type McpTransportType = "stdio" | "streamable-http";
+/** Configuration for a single named MCP server. */
+export interface McpServerConfig {
+    /** Unique server name (used as connection key). */
+    name: string;
+    /** Transport mechanism. */
+    transport: McpTransportType;
+    /** For stdio: command to spawn. */
+    command?: string;
+    /** For stdio: command arguments. */
+    args?: string[];
+    /** For stdio: environment variables passed to the spawned process. */
+    env?: Record<string, string>;
+    /** For streamable-http: base URL of the MCP server. */
+    url?: string;
+    /** For streamable-http: optional auth headers. */
+    headers?: Record<string, string>;
+    /** Whether to auto-connect on manager initialization. */
+    autoConnect?: boolean;
+    /** Connection timeout in milliseconds. */
+    timeoutMs?: number;
+    /** Whether to attempt reconnection on disconnect. */
+    reconnect?: boolean;
+    /** Maximum reconnection attempts before giving up. */
+    maxReconnectAttempts?: number;
+}
+/** Persisted configuration file shape (mcp-servers.json). */
+export interface McpServersFile {
+    schemaVersion: string;
+    servers: McpServerConfig[];
+}
+/** Lifecycle state of a server connection. */
+export type McpConnectionStatus = "disconnected" | "connecting" | "connected" | "reconnecting" | "error";
+/** Runtime state for a connected (or attempted) MCP server. */
+export interface McpServerConnection {
+    /** Server name (matches McpServerConfig.name). */
+    name: string;
+    /** Current connection lifecycle state. */
+    status: McpConnectionStatus;
+    /** ISO timestamp of last successful connection. */
+    connectedAt?: string;
+    /** ISO timestamp of last status change. */
+    lastStatusChange: string;
+    /** Number of reconnection attempts since last successful connection. */
+    reconnectAttempts: number;
+    /** Error message if status is "error". */
+    error?: string;
+}
+/** JSON Schema (subset) for a tool parameter. */
+export interface McpToolParameterSchema {
+    type: string;
+    description?: string;
+    properties?: Record<string, McpToolParameterSchema>;
+    required?: string[];
+    items?: McpToolParameterSchema;
+    enum?: unknown[];
+    [key: string]: unknown;
+}
+/** Metadata for a single tool exposed by an MCP server. */
+export interface McpToolInfo {
+    /** Tool name as exposed by the server. */
+    name: string;
+    /** Human-readable description. */
+    description?: string;
+    /** JSON Schema for the tool's input parameters. */
+    inputSchema?: McpToolParameterSchema;
+    /** Which server exposes this tool. */
+    serverName: string;
+}
+/** Result of invoking an MCP tool. */
+export interface McpToolResult {
+    /** Whether the tool invocation succeeded. */
+    success: boolean;
+    /** Tool output content. */
+    content: Array<{
+        type: string;
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    /** Error message if success is false. */
+    error?: string;
+    /** Execution duration in milliseconds. */
+    durationMs?: number;
+}
+export declare const MCP_SERVERS_SCHEMA_VERSION = "2026.01.mcp-servers-v1";
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/mcp/client/types.ts"],"names":[],"mappings":"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"}

package/dist/mcp/client/types.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Status: Integrated with agent-platform MCP orchestration wiring.
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-REMOTE-006: MCP Client types.
+ *
+ * Defines server configuration, connection status, and tool metadata
+ * for the MCP client infrastructure.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCP_SERVERS_SCHEMA_VERSION = void 0;
+// ---------------------------------------------------------------------------
+// Schema version
+// ---------------------------------------------------------------------------
+exports.MCP_SERVERS_SCHEMA_VERSION = "2026.01.mcp-servers-v1";

package/dist/mcp/transport/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Status: Integrated with agent-platform MCP orchestration wiring.
+ * Moved from @a5c-ai/babysitter-sdk.
+ */
+export { createWebSocketTransport, authenticateUpgrade, WebSocketConnectionTransport } from "./websocket";
+export { WebSocketSessionManager } from "./session";
+export type { WebSocketServerTransport } from "./websocket";
+export type { WebSocketTransportOptions, WebSocketSession, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/transport/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC1G,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACpD,YAAY,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EACV,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/dist/mcp/transport/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketSessionManager = exports.WebSocketConnectionTransport = exports.authenticateUpgrade = exports.createWebSocketTransport = void 0;
+/**
+ * Status: Integrated with agent-platform MCP orchestration wiring.
+ * Moved from @a5c-ai/babysitter-sdk.
+ */
+var websocket_1 = require("./websocket");
+Object.defineProperty(exports, "createWebSocketTransport", { enumerable: true, get: function () { return websocket_1.createWebSocketTransport; } });
+Object.defineProperty(exports, "authenticateUpgrade", { enumerable: true, get: function () { return websocket_1.authenticateUpgrade; } });
+Object.defineProperty(exports, "WebSocketConnectionTransport", { enumerable: true, get: function () { return websocket_1.WebSocketConnectionTransport; } });
+var session_1 = require("./session");
+Object.defineProperty(exports, "WebSocketSessionManager", { enumerable: true, get: function () { return session_1.WebSocketSessionManager; } });

package/dist/mcp/transport/session.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Status: Integrated with agent-platform MCP orchestration wiring.
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-REMOTE-003: WebSocket Session Manager.
+ *
+ * Tracks active sessions with unique IDs, supports reconnection by session ID.
+ */
+import type { WebSocketSession } from "./types";
+export declare class WebSocketSessionManager {
+    private sessions;
+    createSession(): WebSocketSession;
+    restoreSession(sessionId: string): WebSocketSession | null;
+    removeSession(sessionId: string): boolean;
+    getSession(sessionId: string): WebSocketSession | null;
+    listSessions(): WebSocketSession[];
+    getActiveCount(): number;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/mcp/transport/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/mcp/transport/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGhD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAuC;IAEvD,aAAa,IAAI,gBAAgB;IAYjC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAO1D,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIzC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAItD,YAAY,IAAI,gBAAgB,EAAE;IAIlC,cAAc,IAAI,MAAM;CAGzB"}

package/dist/mcp/transport/session.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Status: Integrated with agent-platform MCP orchestration wiring.
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-REMOTE-003: WebSocket Session Manager.
+ *
+ * Tracks active sessions with unique IDs, supports reconnection by session ID.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketSessionManager = void 0;
+const crypto = __importStar(require("node:crypto"));
+class WebSocketSessionManager {
+    sessions = new Map();
+    createSession() {
+        const sessionId = crypto.randomUUID();
+        const now = new Date().toISOString();
+        const session = {
+            sessionId,
+            connectedAt: now,
+            lastActivity: now,
+        };
+        this.sessions.set(sessionId, session);
+        return session;
+    }
+    restoreSession(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (!session)
+            return null;
+        session.lastActivity = new Date().toISOString();
+        return session;
+    }
+    removeSession(sessionId) {
+        return this.sessions.delete(sessionId);
+    }
+    getSession(sessionId) {
+        return this.sessions.get(sessionId) ?? null;
+    }
+    listSessions() {
+        return [...this.sessions.values()];
+    }
+    getActiveCount() {
+        return this.sessions.size;
+    }
+}
+exports.WebSocketSessionManager = WebSocketSessionManager;

package/dist/mcp/transport/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Status: Integrated with agent-platform MCP orchestration wiring.
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-REMOTE-003: WebSocket transport types.
+ */
+export interface WebSocketTransportOptions {
+    port: number;
+    host?: string;
+    authToken?: string;
+    pingIntervalMs?: number;
+    maxMessagesPerSecond?: number;
+    sessionGracePeriodMs?: number;
+}
+export interface WebSocketSession {
+    sessionId: string;
+    connectedAt: string;
+    lastActivity: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/mcp/transport/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/mcp/transport/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/mcp/transport/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Status: Integrated with agent-platform MCP orchestration wiring.
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-REMOTE-003: WebSocket transport types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/mcp/transport/websocket.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Status: Integrated with agent-platform MCP orchestration wiring.
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-REMOTE-003: WebSocket server transport for MCP.
+ *
+ * Creates a WebSocket server where each connection gets its own MCP Transport,
+ * enabling per-connection McpServer instances for session multiplexing.
+ */
+import { WebSocket } from "ws";
+import * as http from "node:http";
+import type { JSONRPCMessage } from "@modelcontextprotocol/sdk/types.js";
+import type { TransportSendOptions } from "@modelcontextprotocol/sdk/shared/transport.js";
+import type { WebSocketTransportOptions } from "./types";
+import { WebSocketSessionManager } from "./session";
+export declare function authenticateUpgrade(request: http.IncomingMessage, expectedToken: string | undefined): boolean;
+/**
+ * A Transport implementation backed by a single WebSocket connection.
+ * Bridges WS messages to/from the MCP server.
+ */
+export declare class WebSocketConnectionTransport {
+    onclose?: () => void;
+    onerror?: (error: Error) => void;
+    onmessage?: (message: unknown) => void;
+    sessionId?: string;
+    private _ws;
+    private _rateLimiter;
+    private _maxMps;
+    constructor(ws: WebSocket, sessionId: string, maxMessagesPerSecond: number);
+    start(): Promise<void>;
+    send(message: JSONRPCMessage, _options?: TransportSendOptions): Promise<void>;
+    close(): Promise<void>;
+    setProtocolVersion?: (version: string) => void;
+}
+export interface WebSocketServerTransport {
+    port: number;
+    sessionManager: WebSocketSessionManager;
+    close(): Promise<void>;
+    onconnection?: (transport: WebSocketConnectionTransport) => void;
+}
+export declare function createWebSocketTransport(options: WebSocketTransportOptions): Promise<WebSocketServerTransport>;
+//# sourceMappingURL=websocket.d.ts.map

package/dist/mcp/transport/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/mcp/transport/websocket.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAmB,SAAS,EAAE,MAAM,IAAI,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAC1F,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAMpD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,IAAI,CAAC,eAAe,EAC7B,aAAa,EAAE,MAAM,GAAG,SAAS,GAChC,OAAO,CAcT;AAED;;;GAGG;AACH,qBAAa,4BAA4B;IACvC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,YAAY,CAAqC;IACzD,OAAO,CAAC,OAAO,CAAS;gBAEZ,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM;IAQpE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyCtB,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,uBAAuB,CAAC;IACxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,4BAA4B,KAAK,IAAI,CAAC;CAClE;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC,CA2JnC"}

package/dist/mcp/transport/websocket.js

@@ -0,0 +1,271 @@
+"use strict";
+/**
+ * Status: Integrated with agent-platform MCP orchestration wiring.
+ * Moved from @a5c-ai/babysitter-sdk.
+ * GAP-REMOTE-003: WebSocket server transport for MCP.
+ *
+ * Creates a WebSocket server where each connection gets its own MCP Transport,
+ * enabling per-connection McpServer instances for session multiplexing.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketConnectionTransport = void 0;
+exports.authenticateUpgrade = authenticateUpgrade;
+exports.createWebSocketTransport = createWebSocketTransport;
+const ws_1 = require("ws");
+const http = __importStar(require("node:http"));
+const crypto = __importStar(require("node:crypto"));
+const session_1 = require("./session");
+const DEFAULT_PING_INTERVAL_MS = 30_000;
+const DEFAULT_MAX_MESSAGES_PER_SECOND = 100;
+const SESSION_GRACE_PERIOD_MS = 60_000;
+function authenticateUpgrade(request, expectedToken) {
+    if (!expectedToken)
+        return true;
+    const authHeader = request.headers.authorization;
+    if (!authHeader)
+        return false;
+    const expected = `Bearer ${expectedToken}`;
+    if (authHeader.length !== expected.length)
+        return false;
+    try {
+        return crypto.timingSafeEqual(Buffer.from(authHeader), Buffer.from(expected));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * A Transport implementation backed by a single WebSocket connection.
+ * Bridges WS messages to/from the MCP server.
+ */
+class WebSocketConnectionTransport {
+    onclose;
+    onerror;
+    onmessage;
+    sessionId;
+    _ws;
+    _rateLimiter;
+    _maxMps;
+    constructor(ws, sessionId, maxMessagesPerSecond) {
+        this._ws = ws;
+        this.sessionId = sessionId;
+        this._maxMps = maxMessagesPerSecond;
+        this._rateLimiter = { count: 0, resetAt: Date.now() + 1000 };
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await -- Transport interface requires Promise
+    async start() {
+        this._ws.on("message", (data) => {
+            // Rate limit check
+            const now = Date.now();
+            if (now >= this._rateLimiter.resetAt) {
+                this._rateLimiter.count = 0;
+                this._rateLimiter.resetAt = now + 1000;
+            }
+            this._rateLimiter.count++;
+            if (this._rateLimiter.count > this._maxMps) {
+                const errorResponse = JSON.stringify({
+                    jsonrpc: "2.0",
+                    error: { code: -32000, message: "Rate limit exceeded" },
+                    id: null,
+                });
+                this._ws.send(errorResponse);
+                return;
+            }
+            try {
+                const message = JSON.parse(data.toString());
+                if (this.onmessage) {
+                    this.onmessage(message);
+                }
+            }
+            catch (err) {
+                if (this.onerror) {
+                    this.onerror(err instanceof Error ? err : new Error(String(err)));
+                }
+            }
+        });
+        this._ws.on("close", () => {
+            if (this.onclose)
+                this.onclose();
+        });
+        this._ws.on("error", (err) => {
+            if (this.onerror)
+                this.onerror(err);
+        });
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await -- Transport interface requires Promise
+    async send(message, _options) {
+        if (this._ws.readyState === ws_1.WebSocket.OPEN) {
+            this._ws.send(JSON.stringify(message));
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/require-await -- Transport interface requires Promise
+    async close() {
+        this._ws.close(1001, "Server shutting down");
+    }
+    setProtocolVersion;
+}
+exports.WebSocketConnectionTransport = WebSocketConnectionTransport;
+async function createWebSocketTransport(options) {
+    const { port, host = "127.0.0.1", authToken, pingIntervalMs = DEFAULT_PING_INTERVAL_MS, maxMessagesPerSecond = DEFAULT_MAX_MESSAGES_PER_SECOND, sessionGracePeriodMs = SESSION_GRACE_PERIOD_MS, } = options;
+    const sessionManager = new session_1.WebSocketSessionManager();
+    const server = http.createServer();
+    const wss = new ws_1.WebSocketServer({ noServer: true });
+    const connections = new Set();
+    const pingTimers = new Map();
+    const sessionGraceTimers = new Map();
+    let onconnection;
+    server.on("upgrade", (request, socket, head) => {
+        if (!authenticateUpgrade(request, authToken)) {
+            socket.write("HTTP/1.1 401 Unauthorized\r\n\r\n");
+            socket.destroy();
+            return;
+        }
+        wss.handleUpgrade(request, socket, head, (ws) => {
+            // Check for session restore
+            const restoreId = request.headers["x-session-id"];
+            let session;
+            if (restoreId) {
+                session = sessionManager.restoreSession(restoreId);
+                if (session) {
+                    // Cancel any pending grace period cleanup
+                    const graceTimer = sessionGraceTimers.get(restoreId);
+                    if (graceTimer) {
+                        clearTimeout(graceTimer);
+                        sessionGraceTimers.delete(restoreId);
+                    }
+                }
+            }
+            if (!session) {
+                session = sessionManager.createSession();
+            }
+            connections.add(ws);
+            // Set up ping/pong keepalive
+            let alive = true;
+            const pingTimer = setInterval(() => {
+                if (!alive) {
+                    ws.terminate();
+                    return;
+                }
+                alive = false;
+                ws.ping();
+            }, pingIntervalMs);
+            ws.on("pong", () => {
+                alive = true;
+            });
+            // Create per-connection MCP transport
+            const transport = new WebSocketConnectionTransport(ws, session.sessionId, maxMessagesPerSecond);
+            ws.on("close", () => {
+                connections.delete(ws);
+                clearInterval(pingTimer);
+                pingTimers.delete(ws);
+                // Grace period: don't delete session immediately — allow reconnection
+                const sid = transport.sessionId;
+                if (sid) {
+                    const graceTimer = setTimeout(() => {
+                        sessionManager.removeSession(sid);
+                        sessionGraceTimers.delete(sid);
+                    }, sessionGracePeriodMs);
+                    sessionGraceTimers.set(sid, graceTimer);
+                }
+            });
+            pingTimers.set(ws, pingTimer);
+            // Notify consumer so they can connect a McpServer to this transport
+            if (onconnection) {
+                onconnection(transport);
+            }
+            // Send session info
+            ws.send(JSON.stringify({
+                jsonrpc: "2.0",
+                method: "session/initialized",
+                params: { sessionId: session.sessionId },
+            }));
+        });
+    });
+    return new Promise((resolve, reject) => {
+        server.on("error", reject);
+        server.listen(port, host, () => {
+            const addr = server.address();
+            const actualPort = typeof addr === "object" && addr ? addr.port : port;
+            const result = {
+                port: actualPort,
+                sessionManager,
+                get onconnection() {
+                    return onconnection;
+                },
+                set onconnection(handler) {
+                    onconnection = handler;
+                },
+                async close() {
+                    // Clear all grace timers
+                    for (const timer of sessionGraceTimers.values()) {
+                        clearTimeout(timer);
+                    }
+                    sessionGraceTimers.clear();
+                    // Send close frame to all connections
+                    for (const ws of connections) {
+                        ws.close(1001, "Server shutting down");
+                    }
+                    // Clear all ping timers
+                    for (const timer of pingTimers.values()) {
+                        clearInterval(timer);
+                    }
+                    pingTimers.clear();
+                    // Wait for connections to close (max 5s)
+                    await Promise.race([
+                        new Promise((res) => {
+                            if (connections.size === 0) {
+                                res();
+                                return;
+                            }
+                            const check = setInterval(() => {
+                                if (connections.size === 0) {
+                                    clearInterval(check);
+                                    res();
+                                }
+                            }, 100);
+                        }),
+                        new Promise((res) => setTimeout(res, 5000)),
+                    ]);
+                    wss.close();
+                    await new Promise((res, rej) => {
+                        server.close((err) => (err ? rej(err) : res()));
+                    });
+                },
+            };
+            resolve(result);
+        });
+    });
+}

package/dist/observability/alertWebhooks.d.ts

@@ -0,0 +1,35 @@
+export interface WebhookConfig {
+    id: string;
+    url: string;
+    events: string[];
+    headers?: Record<string, string>;
+    retryCount?: number;
+}
+export interface AlertRule {
+    condition: 'budget_exceeded' | 'run_failed' | 'stall_detected' | string;
+    webhookId: string;
+    template?: string;
+}
+export interface WebhookEvent {
+    type: string;
+    data: unknown;
+    timestamp: string;
+}
+export declare class WebhookDispatcher {
+    private webhooks;
+    private alertRules;
+    register(config: WebhookConfig): void;
+    unregister(id: string): boolean;
+    addAlertRule(rule: AlertRule): void;
+    dispatch(event: WebhookEvent): Promise<{
+        sent: number;
+        failed: number;
+    }>;
+    evaluateAlerts(runState: {
+        status?: string;
+        budgetExceeded?: boolean;
+        stalled?: boolean;
+    }): WebhookEvent[];
+    private sendWithRetry;
+}
+//# sourceMappingURL=alertWebhooks.d.ts.map

package/dist/observability/alertWebhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alertWebhooks.d.ts","sourceRoot":"","sources":["../../src/observability/alertWebhooks.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,iBAAiB,GAAG,YAAY,GAAG,gBAAgB,GAAG,MAAM,CAAC;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,UAAU,CAAmB;IAErC,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAIrC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAI7B,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAW9E,cAAc,CAAC,QAAQ,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,YAAY,EAAE;YAc5F,aAAa;CAmB5B"}