@thinkwell/protocol 0.2.0

package/dist/dispatch.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Dispatch types for conductor message routing
+ *
+ * The Dispatch type is a unified envelope for messages flowing through the conductor.
+ * The Responder abstraction decouples response routing from the message itself,
+ * enabling the conductor to intercept and redirect responses.
+ */
+import type { JsonRpcId, JsonRpcError } from "./json-rpc.js";
+/**
+ * Responder interface for sending responses back to the original requester.
+ *
+ * This abstraction allows the conductor to route responses through different
+ * paths depending on where the original request came from.
+ */
+export interface Responder {
+    /**
+     * Send a successful response
+     */
+    respond(result: unknown): void;
+    /**
+     * Send an error response
+     */
+    respondWithError(error: JsonRpcError): void;
+}
+/**
+ * A request dispatch - carries request data and a responder for sending the response
+ */
+export interface RequestDispatch {
+    type: "request";
+    id: JsonRpcId;
+    method: string;
+    params: unknown;
+    responder: Responder;
+}
+/**
+ * A notification dispatch - fire-and-forget message
+ */
+export interface NotificationDispatch {
+    type: "notification";
+    method: string;
+    params: unknown;
+}
+/**
+ * A response dispatch - result or error for a previous request
+ */
+export interface ResponseDispatch {
+    type: "response";
+    id: JsonRpcId;
+    result?: unknown;
+    error?: JsonRpcError;
+}
+/**
+ * Unified dispatch envelope for all message types.
+ *
+ * Messages flow through the conductor in this envelope format, which
+ * normalizes requests, notifications, and responses into a single type.
+ */
+export type Dispatch = RequestDispatch | NotificationDispatch | ResponseDispatch;
+/**
+ * Type guard for request dispatch
+ */
+export declare function isRequestDispatch(dispatch: Dispatch): dispatch is RequestDispatch;
+/**
+ * Type guard for notification dispatch
+ */
+export declare function isNotificationDispatch(dispatch: Dispatch): dispatch is NotificationDispatch;
+/**
+ * Type guard for response dispatch
+ */
+export declare function isResponseDispatch(dispatch: Dispatch): dispatch is ResponseDispatch;
+/**
+ * Create a simple responder from callback functions
+ */
+export declare function createResponder(onRespond: (result: unknown) => void, onError: (error: JsonRpcError) => void): Responder;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,eAAe,GAAG,oBAAoB,GAAG,gBAAgB,CAAC;AAEjF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,IAAI,eAAe,CAEjF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,IAAI,oBAAoB,CAE3F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,IAAI,gBAAgB,CAEnF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,EACpC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GACrC,SAAS,CAKX"}

package/dist/dispatch.js

@@ -0,0 +1,35 @@
+/**
+ * Dispatch types for conductor message routing
+ *
+ * The Dispatch type is a unified envelope for messages flowing through the conductor.
+ * The Responder abstraction decouples response routing from the message itself,
+ * enabling the conductor to intercept and redirect responses.
+ */
+/**
+ * Type guard for request dispatch
+ */
+export function isRequestDispatch(dispatch) {
+    return dispatch.type === "request";
+}
+/**
+ * Type guard for notification dispatch
+ */
+export function isNotificationDispatch(dispatch) {
+    return dispatch.type === "notification";
+}
+/**
+ * Type guard for response dispatch
+ */
+export function isResponseDispatch(dispatch) {
+    return dispatch.type === "response";
+}
+/**
+ * Create a simple responder from callback functions
+ */
+export function createResponder(onRespond, onError) {
+    return {
+        respond: onRespond,
+        respondWithError: onError,
+    };
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4DH;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,OAAO,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAkB;IACvD,OAAO,QAAQ,CAAC,IAAI,KAAK,cAAc,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAkB;IACnD,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,SAAoC,EACpC,OAAsC;IAEtC,OAAO;QACL,OAAO,EAAE,SAAS;QAClB,gBAAgB,EAAE,OAAO;KAC1B,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export type { JsonValue, JsonObject, JsonSchema } from "./json.js";
+export type { JsonRpcId, JsonRpcError, JsonRpcRequest, JsonRpcNotification, JsonRpcSuccessResponse, JsonRpcErrorResponse, JsonRpcResponse, JsonRpcMessage, } from "./json-rpc.js";
+export { isJsonRpcRequest, isJsonRpcNotification, isJsonRpcResponse, isJsonRpcSuccessResponse, isJsonRpcErrorResponse, JsonRpcErrorCodes, createRequest, createNotification, createSuccessResponse, createErrorResponse, } from "./json-rpc.js";
+export type { McpServerConfig, McpContext, McpConnectRequest, McpConnectResponse, McpMessageRequest, McpMessageResponse, McpContent, McpError, McpDisconnectNotification, McpToolsListResult, McpToolDefinition, McpToolsCallParams, McpToolsCallResult, } from "./mcp-over-acp.js";
+export type { Responder, RequestDispatch, NotificationDispatch, ResponseDispatch, Dispatch, } from "./dispatch.js";
+export { isRequestDispatch, isNotificationDispatch, isResponseDispatch, createResponder, } from "./dispatch.js";
+export type { ProxySuccessorRequestParams, ProxySuccessorNotificationParams, } from "./proxy-protocol.js";
+export { PROXY_SUCCESSOR_REQUEST, PROXY_SUCCESSOR_NOTIFICATION, isProxySuccessorRequest, isProxySuccessorNotification, unwrapProxySuccessorRequest, unwrapProxySuccessorNotification, wrapAsProxySuccessorRequest, wrapAsProxySuccessorNotification, isProxyProtocolMethod, } from "./proxy-protocol.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGnE,YAAY,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,QAAQ,EACR,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,SAAS,EACT,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,QAAQ,GACT,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AAGvB,YAAY,EACV,2BAA2B,EAC3B,gCAAgC,GACjC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,uBAAuB,EACvB,4BAA4B,EAC5B,2BAA2B,EAC3B,gCAAgC,EAChC,2BAA2B,EAC3B,gCAAgC,EAChC,qBAAqB,GACtB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { isJsonRpcRequest, isJsonRpcNotification, isJsonRpcResponse, isJsonRpcSuccessResponse, isJsonRpcErrorResponse, JsonRpcErrorCodes, createRequest, createNotification, createSuccessResponse, createErrorResponse, } from "./json-rpc.js";
+export { isRequestDispatch, isNotificationDispatch, isResponseDispatch, createResponder, } from "./dispatch.js";
+export { PROXY_SUCCESSOR_REQUEST, PROXY_SUCCESSOR_NOTIFICATION, isProxySuccessorRequest, isProxySuccessorNotification, unwrapProxySuccessorRequest, unwrapProxySuccessorNotification, wrapAsProxySuccessorRequest, wrapAsProxySuccessorNotification, isProxyProtocolMethod, } from "./proxy-protocol.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AA4BvB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,GAChB,MAAM,eAAe,CAAC;AAQvB,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,uBAAuB,EACvB,4BAA4B,EAC5B,2BAA2B,EAC3B,gCAAgC,EAChC,2BAA2B,EAC3B,gCAAgC,EAChC,qBAAqB,GACtB,MAAM,qBAAqB,CAAC"}

package/dist/json-rpc.d.ts

@@ -0,0 +1,103 @@
+/**
+ * JSON-RPC 2.0 protocol types
+ */
+/**
+ * JSON-RPC message ID - can be string, number, or null
+ */
+export type JsonRpcId = string | number | null;
+/**
+ * JSON-RPC error object
+ */
+export interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/**
+ * JSON-RPC request message
+ */
+export interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    method: string;
+    params?: unknown;
+}
+/**
+ * JSON-RPC notification message (request without id)
+ */
+export interface JsonRpcNotification {
+    jsonrpc: "2.0";
+    method: string;
+    params?: unknown;
+}
+/**
+ * JSON-RPC success response
+ */
+export interface JsonRpcSuccessResponse {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    result: unknown;
+}
+/**
+ * JSON-RPC error response
+ */
+export interface JsonRpcErrorResponse {
+    jsonrpc: "2.0";
+    id: JsonRpcId;
+    error: JsonRpcError;
+}
+/**
+ * JSON-RPC response (success or error)
+ */
+export type JsonRpcResponse = JsonRpcSuccessResponse | JsonRpcErrorResponse;
+/**
+ * Any JSON-RPC message
+ */
+export type JsonRpcMessage = JsonRpcRequest | JsonRpcNotification | JsonRpcResponse;
+/**
+ * Type guard for JSON-RPC request
+ */
+export declare function isJsonRpcRequest(message: JsonRpcMessage): message is JsonRpcRequest;
+/**
+ * Type guard for JSON-RPC notification
+ */
+export declare function isJsonRpcNotification(message: JsonRpcMessage): message is JsonRpcNotification;
+/**
+ * Type guard for JSON-RPC response
+ */
+export declare function isJsonRpcResponse(message: JsonRpcMessage): message is JsonRpcResponse;
+/**
+ * Type guard for JSON-RPC success response
+ */
+export declare function isJsonRpcSuccessResponse(message: JsonRpcMessage): message is JsonRpcSuccessResponse;
+/**
+ * Type guard for JSON-RPC error response
+ */
+export declare function isJsonRpcErrorResponse(message: JsonRpcMessage): message is JsonRpcErrorResponse;
+/**
+ * Standard JSON-RPC error codes
+ */
+export declare const JsonRpcErrorCodes: {
+    readonly PARSE_ERROR: -32700;
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+};
+/**
+ * Create a JSON-RPC request
+ */
+export declare function createRequest(id: JsonRpcId, method: string, params?: unknown): JsonRpcRequest;
+/**
+ * Create a JSON-RPC notification
+ */
+export declare function createNotification(method: string, params?: unknown): JsonRpcNotification;
+/**
+ * Create a JSON-RPC success response
+ */
+export declare function createSuccessResponse(id: JsonRpcId, result: unknown): JsonRpcSuccessResponse;
+/**
+ * Create a JSON-RPC error response
+ */
+export declare function createErrorResponse(id: JsonRpcId, error: JsonRpcError): JsonRpcErrorResponse;
+//# sourceMappingURL=json-rpc.d.ts.map

package/dist/json-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.d.ts","sourceRoot":"","sources":["../src/json-rpc.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,SAAS,CAAC;IACd,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,mBAAmB,GAAG,eAAe,CAAC;AAEpF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,IAAI,cAAc,CAEnF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,IAAI,mBAAmB,CAE7F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,IAAI,eAAe,CAErF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,cAAc,GACtB,OAAO,IAAI,sBAAsB,CAEnC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,IAAI,oBAAoB,CAE/F;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;CAMpB,CAAC;AAEX;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,cAAc,CAM7F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAMxF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAG,sBAAsB,CAE5F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,oBAAoB,CAE5F"}

package/dist/json-rpc.js

@@ -0,0 +1,76 @@
+/**
+ * JSON-RPC 2.0 protocol types
+ */
+/**
+ * Type guard for JSON-RPC request
+ */
+export function isJsonRpcRequest(message) {
+    return "method" in message && "id" in message;
+}
+/**
+ * Type guard for JSON-RPC notification
+ */
+export function isJsonRpcNotification(message) {
+    return "method" in message && !("id" in message);
+}
+/**
+ * Type guard for JSON-RPC response
+ */
+export function isJsonRpcResponse(message) {
+    return "id" in message && !("method" in message);
+}
+/**
+ * Type guard for JSON-RPC success response
+ */
+export function isJsonRpcSuccessResponse(message) {
+    return isJsonRpcResponse(message) && "result" in message;
+}
+/**
+ * Type guard for JSON-RPC error response
+ */
+export function isJsonRpcErrorResponse(message) {
+    return isJsonRpcResponse(message) && "error" in message;
+}
+/**
+ * Standard JSON-RPC error codes
+ */
+export const JsonRpcErrorCodes = {
+    PARSE_ERROR: -32700,
+    INVALID_REQUEST: -32600,
+    METHOD_NOT_FOUND: -32601,
+    INVALID_PARAMS: -32602,
+    INTERNAL_ERROR: -32603,
+};
+/**
+ * Create a JSON-RPC request
+ */
+export function createRequest(id, method, params) {
+    const request = { jsonrpc: "2.0", id, method };
+    if (params !== undefined) {
+        request.params = params;
+    }
+    return request;
+}
+/**
+ * Create a JSON-RPC notification
+ */
+export function createNotification(method, params) {
+    const notification = { jsonrpc: "2.0", method };
+    if (params !== undefined) {
+        notification.params = params;
+    }
+    return notification;
+}
+/**
+ * Create a JSON-RPC success response
+ */
+export function createSuccessResponse(id, result) {
+    return { jsonrpc: "2.0", id, result };
+}
+/**
+ * Create a JSON-RPC error response
+ */
+export function createErrorResponse(id, error) {
+    return { jsonrpc: "2.0", id, error };
+}
+//# sourceMappingURL=json-rpc.js.map

package/dist/json-rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc.js","sourceRoot":"","sources":["../src/json-rpc.ts"],"names":[],"mappings":"AAAA;;GAEG;AA+DH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,OAAO,QAAQ,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAuB;IAC3D,OAAO,QAAQ,IAAI,OAAO,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAuB;IACvD,OAAO,IAAI,IAAI,OAAO,IAAI,CAAC,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAuB;IAEvB,OAAO,iBAAiB,CAAC,OAAO,CAAC,IAAI,QAAQ,IAAI,OAAO,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAuB;IAC5D,OAAO,iBAAiB,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,OAAO,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,CAAC,KAAK;IACnB,eAAe,EAAE,CAAC,KAAK;IACvB,gBAAgB,EAAE,CAAC,KAAK;IACxB,cAAc,EAAE,CAAC,KAAK;IACtB,cAAc,EAAE,CAAC,KAAK;CACd,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,EAAa,EAAE,MAAc,EAAE,MAAgB;IAC3E,MAAM,OAAO,GAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAC/D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IAC1B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,MAAgB;IACjE,MAAM,YAAY,GAAwB,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACrE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,YAAY,CAAC,MAAM,GAAG,MAAM,CAAC;IAC/B,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAa,EAAE,MAAe;IAClE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAa,EAAE,KAAmB;IACpE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AACvC,CAAC"}

package/dist/json.d.ts

@@ -0,0 +1,34 @@
+/**
+ * JSON value types
+ */
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/**
+ * JSON object type
+ */
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+/**
+ * JSON Schema type for tool input/output validation.
+ *
+ * This is a structural subset of JSON Schema, designed to be compatible
+ * with schemas produced by third-party libraries without requiring them
+ * as dependencies.
+ */
+export interface JsonSchema {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    description?: string;
+    enum?: JsonValue[];
+    oneOf?: JsonSchema[];
+    anyOf?: JsonSchema[];
+    allOf?: JsonSchema[];
+    $ref?: string;
+    additionalProperties?: boolean | JsonSchema;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,EAAE,GACX;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEjC;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oBAAoB,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/json.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":""}

package/dist/mcp-over-acp.d.ts

@@ -0,0 +1,125 @@
+/**
+ * MCP-over-ACP protocol types
+ *
+ * These types define the protocol for bridging MCP (Model Context Protocol)
+ * over ACP (Agent Client Protocol) connections.
+ */
+import type { JsonSchema } from "./json.js";
+/**
+ * MCP server configuration for session requests
+ */
+export interface McpServerConfig {
+    type: "http";
+    name: string;
+    url: string;
+}
+/**
+ * Context provided to tool handlers
+ */
+export interface McpContext {
+    /** The connection ID for this MCP session */
+    connectionId: string;
+    /** The session ID for the ACP session */
+    sessionId: string;
+}
+/**
+ * MCP connect request from conductor
+ */
+export interface McpConnectRequest {
+    method: "_mcp/connect";
+    params: {
+        connectionId: string;
+        url: string;
+    };
+}
+/**
+ * MCP connect response
+ */
+export interface McpConnectResponse {
+    connectionId: string;
+    serverInfo: {
+        name: string;
+        version: string;
+    };
+    capabilities: {
+        tools?: Record<string, unknown>;
+    };
+    /** Optional tool definitions - the bridge may use these to pre-populate tool info */
+    tools?: McpToolDefinition[];
+}
+/**
+ * MCP message request (tool call, etc.)
+ */
+export interface McpMessageRequest {
+    method: "_mcp/message";
+    params: {
+        connectionId: string;
+        method: string;
+        id?: string | number;
+        params?: unknown;
+    };
+}
+/**
+ * MCP message response
+ */
+export interface McpMessageResponse {
+    connectionId: string;
+    content?: McpContent[];
+    result?: unknown;
+    error?: McpError;
+}
+/**
+ * MCP content block
+ */
+export interface McpContent {
+    type: "text" | "image" | "resource";
+    text?: string;
+    data?: string;
+    mimeType?: string;
+}
+/**
+ * MCP error
+ */
+export interface McpError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/**
+ * MCP disconnect notification
+ */
+export interface McpDisconnectNotification {
+    method: "_mcp/disconnect";
+    params: {
+        connectionId: string;
+    };
+}
+/**
+ * MCP tools/list response
+ */
+export interface McpToolsListResult {
+    tools: McpToolDefinition[];
+}
+/**
+ * MCP tool definition
+ */
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: JsonSchema;
+}
+/**
+ * MCP tools/call request params
+ */
+export interface McpToolsCallParams {
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/**
+ * MCP tools/call response
+ */
+export interface McpToolsCallResult {
+    content: McpContent[];
+    isError?: boolean;
+}
+//# sourceMappingURL=mcp-over-acp.d.ts.map

package/dist/mcp-over-acp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-over-acp.d.ts","sourceRoot":"","sources":["../src/mcp-over-acp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,YAAY,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC;IACF,qFAAqF;IACrF,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/dist/mcp-over-acp.js

@@ -0,0 +1,8 @@
+/**
+ * MCP-over-ACP protocol types
+ *
+ * These types define the protocol for bridging MCP (Model Context Protocol)
+ * over ACP (Agent Client Protocol) connections.
+ */
+export {};
+//# sourceMappingURL=mcp-over-acp.js.map

package/dist/mcp-over-acp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-over-acp.js","sourceRoot":"","sources":["../src/mcp-over-acp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/proxy-protocol.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Proxy protocol types for `_proxy/successor/*` messages
+ *
+ * Proxies communicate with their downstream component (next proxy or agent)
+ * through the conductor using these extension methods.
+ */
+import type { JsonRpcRequest, JsonRpcNotification, JsonRpcMessage } from "./json-rpc.js";
+/**
+ * Method names for proxy-to-successor communication
+ */
+export declare const PROXY_SUCCESSOR_REQUEST = "_proxy/successor/request";
+export declare const PROXY_SUCCESSOR_NOTIFICATION = "_proxy/successor/notification";
+/**
+ * Parameters for `_proxy/successor/request`
+ *
+ * When a proxy receives an ACP request from upstream and wants to forward it
+ * (possibly transformed) to the downstream component, it sends this to the conductor.
+ */
+export interface ProxySuccessorRequestParams {
+    /** The method of the inner request to forward */
+    method: string;
+    /** The params of the inner request (optional) */
+    params?: unknown;
+}
+/**
+ * Parameters for `_proxy/successor/notification`
+ *
+ * When a proxy receives a notification from upstream and wants to forward it downstream.
+ */
+export interface ProxySuccessorNotificationParams {
+    /** The method of the inner notification to forward */
+    method: string;
+    /** The params of the inner notification (optional) */
+    params?: unknown;
+}
+/**
+ * Type guard for `_proxy/successor/request` messages
+ */
+export declare function isProxySuccessorRequest(message: JsonRpcMessage): message is JsonRpcRequest & {
+    params: ProxySuccessorRequestParams;
+};
+/**
+ * Type guard for `_proxy/successor/notification` messages
+ */
+export declare function isProxySuccessorNotification(message: JsonRpcMessage): message is JsonRpcNotification & {
+    params: ProxySuccessorNotificationParams;
+};
+/**
+ * Extract the inner request from a `_proxy/successor/request` message
+ */
+export declare function unwrapProxySuccessorRequest(params: ProxySuccessorRequestParams): {
+    method: string;
+    params: unknown;
+};
+/**
+ * Extract the inner notification from a `_proxy/successor/notification` message
+ */
+export declare function unwrapProxySuccessorNotification(params: ProxySuccessorNotificationParams): {
+    method: string;
+    params: unknown;
+};
+/**
+ * Wrap a request for forwarding to a predecessor proxy
+ *
+ * When the conductor needs to send a message FROM a successor TO a proxy,
+ * it wraps the message in `_proxy/successor/request` format.
+ */
+export declare function wrapAsProxySuccessorRequest(method: string, params: unknown): ProxySuccessorRequestParams;
+/**
+ * Wrap a notification for forwarding to a predecessor proxy
+ */
+export declare function wrapAsProxySuccessorNotification(method: string, params: unknown): ProxySuccessorNotificationParams;
+/**
+ * Check if a method is a proxy protocol method (starts with `_proxy/`)
+ */
+export declare function isProxyProtocolMethod(method: string): boolean;
+//# sourceMappingURL=proxy-protocol.d.ts.map

package/dist/proxy-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-protocol.d.ts","sourceRoot":"","sources":["../src/proxy-protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEzF;;GAEG;AACH,eAAO,MAAM,uBAAuB,6BAA6B,CAAC;AAClE,eAAO,MAAM,4BAA4B,kCAAkC,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,gCAAgC;IAC/C,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,cAAc,GACtB,OAAO,IAAI,cAAc,GAAG;IAAE,MAAM,EAAE,2BAA2B,CAAA;CAAE,CAMrE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,cAAc,GACtB,OAAO,IAAI,mBAAmB,GAAG;IAAE,MAAM,EAAE,gCAAgC,CAAA;CAAE,CAM/E;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,2BAA2B,GAClC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAKrC;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,gCAAgC,GACvC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAKrC;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,GACd,2BAA2B,CAE7B;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,GACd,gCAAgC,CAElC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D"}

package/dist/proxy-protocol.js

@@ -0,0 +1,67 @@
+/**
+ * Proxy protocol types for `_proxy/successor/*` messages
+ *
+ * Proxies communicate with their downstream component (next proxy or agent)
+ * through the conductor using these extension methods.
+ */
+/**
+ * Method names for proxy-to-successor communication
+ */
+export const PROXY_SUCCESSOR_REQUEST = "_proxy/successor/request";
+export const PROXY_SUCCESSOR_NOTIFICATION = "_proxy/successor/notification";
+/**
+ * Type guard for `_proxy/successor/request` messages
+ */
+export function isProxySuccessorRequest(message) {
+    return ("method" in message &&
+        "id" in message &&
+        message.method === PROXY_SUCCESSOR_REQUEST);
+}
+/**
+ * Type guard for `_proxy/successor/notification` messages
+ */
+export function isProxySuccessorNotification(message) {
+    return ("method" in message &&
+        !("id" in message) &&
+        message.method === PROXY_SUCCESSOR_NOTIFICATION);
+}
+/**
+ * Extract the inner request from a `_proxy/successor/request` message
+ */
+export function unwrapProxySuccessorRequest(params) {
+    return {
+        method: params.method,
+        params: params.params,
+    };
+}
+/**
+ * Extract the inner notification from a `_proxy/successor/notification` message
+ */
+export function unwrapProxySuccessorNotification(params) {
+    return {
+        method: params.method,
+        params: params.params,
+    };
+}
+/**
+ * Wrap a request for forwarding to a predecessor proxy
+ *
+ * When the conductor needs to send a message FROM a successor TO a proxy,
+ * it wraps the message in `_proxy/successor/request` format.
+ */
+export function wrapAsProxySuccessorRequest(method, params) {
+    return { method, params };
+}
+/**
+ * Wrap a notification for forwarding to a predecessor proxy
+ */
+export function wrapAsProxySuccessorNotification(method, params) {
+    return { method, params };
+}
+/**
+ * Check if a method is a proxy protocol method (starts with `_proxy/`)
+ */
+export function isProxyProtocolMethod(method) {
+    return method.startsWith("_proxy/");
+}
+//# sourceMappingURL=proxy-protocol.js.map

package/dist/proxy-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-protocol.js","sourceRoot":"","sources":["../src/proxy-protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,0BAA0B,CAAC;AAClE,MAAM,CAAC,MAAM,4BAA4B,GAAG,+BAA+B,CAAC;AA2B5E;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAuB;IAEvB,OAAO,CACL,QAAQ,IAAI,OAAO;QACnB,IAAI,IAAI,OAAO;QACf,OAAO,CAAC,MAAM,KAAK,uBAAuB,CAC3C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,OAAuB;IAEvB,OAAO,CACL,QAAQ,IAAI,OAAO;QACnB,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC;QAClB,OAAO,CAAC,MAAM,KAAK,4BAA4B,CAChD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAmC;IAEnC,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAC9C,MAAwC;IAExC,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAc,EACd,MAAe;IAEf,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gCAAgC,CAC9C,MAAc,EACd,MAAe;IAEf,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,OAAO,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@thinkwell/protocol",
+  "version": "0.2.0",
+  "description": "Shared protocol types for Thinkwell packages (JSON-RPC, MCP-over-ACP, Dispatch)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "node --test --import tsx src/**/*.test.ts"
+  },
+  "keywords": [
+    "acp",
+    "mcp",
+    "thinkwell",
+    "json-rpc",
+    "protocol"
+  ],
+  "author": "David Herman",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^24.10.4",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  }
+}