@agent-relay/utils 2.0.31 → 2.0.32

package/dist/cjs/client-helpers.js

@@ -0,0 +1,127 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var client_helpers_exports = {};
+__export(client_helpers_exports, {
+  createRequestEnvelope: () => createRequestEnvelope,
+  createRequestHandler: () => createRequestHandler,
+  generateRequestId: () => generateRequestId,
+  handleResponse: () => handleResponse,
+  isMatchingResponse: () => isMatchingResponse,
+  toReleaseResult: () => toReleaseResult,
+  toSpawnResult: () => toSpawnResult
+});
+module.exports = __toCommonJS(client_helpers_exports);
+var import_node_net = require("node:net");
+var import_node_crypto = require("node:crypto");
+var import_protocol = require("@agent-relay/protocol");
+function isMatchingResponse(response, requestId, correlationId) {
+  const responsePayload = response.payload;
+  const ackPayload = response.type === "ACK" ? response.payload : null;
+  return response.id === requestId || responsePayload?.replyTo === requestId || !!correlationId && (responsePayload?.correlationId === correlationId || ackPayload?.correlationId === correlationId);
+}
+function handleResponse(response, resolve, reject) {
+  const responsePayload = response.payload;
+  if (response.type === "ERROR") {
+    reject(
+      new Error(responsePayload?.message || responsePayload?.code || "Unknown error")
+    );
+  } else if (response.type === "ACK" || response.type === "SPAWN_RESULT" || response.type === "RELEASE_RESULT") {
+    resolve(response.payload);
+  } else if (responsePayload?.error && !responsePayload?.success) {
+    reject(new Error(responsePayload.error));
+  } else {
+    resolve(response.payload);
+  }
+}
+function createRequestEnvelope(type, payload, requestId, options) {
+  const envelope = {
+    v: import_protocol.PROTOCOL_VERSION,
+    type,
+    id: requestId,
+    ts: Date.now(),
+    payload,
+    from: options?.envelopeProps?.from,
+    to: options?.envelopeProps?.to
+  };
+  if (options?.payloadMeta) {
+    envelope.payload_meta = options.payloadMeta;
+  }
+  return envelope;
+}
+function toSpawnResult(payload) {
+  return {
+    success: payload.success,
+    error: payload.error,
+    pid: payload.pid,
+    name: payload.name
+  };
+}
+function toReleaseResult(payload) {
+  return {
+    success: payload.success,
+    error: payload.error,
+    name: payload.name
+  };
+}
+function createRequestHandler(socketPath, envelope, options) {
+  return new Promise((resolve, reject) => {
+    const correlationId = options.payloadMeta?.sync?.correlationId;
+    let timedOut = false;
+    const parser = new import_protocol.FrameParser();
+    parser.setLegacyMode(true);
+    const socket = (0, import_node_net.createConnection)(socketPath);
+    const timeoutId = setTimeout(() => {
+      timedOut = true;
+      socket.destroy();
+      reject(new Error(`Request timeout after ${options.timeout}ms`));
+    }, options.timeout);
+    socket.on("connect", () => {
+      socket.write((0, import_protocol.encodeFrameLegacy)(envelope));
+    });
+    socket.on("data", (data) => {
+      if (timedOut) return;
+      const frames = parser.push(data);
+      for (const response of frames) {
+        if (isMatchingResponse(response, envelope.id, correlationId)) {
+          clearTimeout(timeoutId);
+          socket.end();
+          handleResponse(response, resolve, reject);
+          return;
+        }
+      }
+    });
+    socket.on("error", (err) => {
+      clearTimeout(timeoutId);
+      reject(err);
+    });
+  });
+}
+function generateRequestId(prefix = "") {
+  return `${prefix}${Date.now().toString(36)}-${(0, import_node_crypto.randomUUID)().slice(0, 8)}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createRequestEnvelope,
+  createRequestHandler,
+  generateRequestId,
+  handleResponse,
+  isMatchingResponse,
+  toReleaseResult,
+  toSpawnResult
+});

package/dist/cjs/index.js

@@ -24,6 +24,7 @@ __reExport(index_exports, require("./update-checker.js"), module.exports);
 __reExport(index_exports, require("./error-tracking.js"), module.exports);
 __reExport(index_exports, require("./model-mapping.js"), module.exports);
 __reExport(index_exports, require("./relay-pty-path.js"), module.exports);
+__reExport(index_exports, require("./client-helpers.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./name-generator.js"),
@@ -34,5 +35,6 @@ __reExport(index_exports, require("./relay-pty-path.js"), module.exports);
   ...require("./update-checker.js"),
   ...require("./error-tracking.js"),
   ...require("./model-mapping.js"),
-  ...require("./relay-pty-path.js")
+  ...require("./relay-pty-path.js"),
+  ...require("./client-helpers.js")
 });

package/dist/client-helpers.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Shared client helpers for SDK and MCP implementations
+ *
+ * This module provides common request/response handling and type aliases
+ * to ensure SDK and MCP clients stay in lockstep and avoid inconsistencies.
+ */
+import { type Envelope, type MessageType, type SpawnResultPayload, type ReleaseResultPayload } from '@agent-relay/protocol';
+/**
+ * Common return type aliases to ensure consistency between SDK and MCP
+ */
+export type SpawnResult = {
+    success: boolean;
+    error?: string;
+    pid?: number;
+    name?: string;
+};
+export type ReleaseResult = {
+    success: boolean;
+    error?: string;
+    name?: string;
+};
+/**
+ * Options for request/response operations
+ */
+export interface RequestOptions {
+    /** Custom timeout in milliseconds */
+    timeoutMs?: number;
+    /** Payload metadata (for sync operations) */
+    payloadMeta?: {
+        sync?: {
+            blocking?: boolean;
+            correlationId?: string;
+            timeoutMs?: number;
+        };
+    };
+    /** Envelope properties (from/to) */
+    envelopeProps?: {
+        from?: string;
+        to?: string;
+    };
+}
+/**
+ * Response matching logic for request/response operations
+ */
+export declare function isMatchingResponse(response: Envelope, requestId: string, correlationId?: string): boolean;
+/**
+ * Handle response resolution/rejection logic
+ */
+export declare function handleResponse<T>(response: Envelope, resolve: (value: T) => void, reject: (error: Error) => void): void;
+/**
+ * Create a request envelope
+ */
+export declare function createRequestEnvelope(type: MessageType, payload: Record<string, unknown>, requestId: string, options?: RequestOptions): Envelope;
+/**
+ * Convert SpawnResultPayload to SpawnResult
+ */
+export declare function toSpawnResult(payload: SpawnResultPayload): SpawnResult;
+/**
+ * Convert ReleaseResultPayload to ReleaseResult
+ */
+export declare function toReleaseResult(payload: ReleaseResultPayload): ReleaseResult;
+/**
+ * Create a request/response handler using a socket connection
+ * This is the core logic shared between SDK and MCP clients
+ */
+export declare function createRequestHandler<T>(socketPath: string, envelope: Envelope, options: RequestOptions & {
+    timeout: number;
+}): Promise<T>;
+/**
+ * Generate a unique request ID
+ */
+export declare function generateRequestId(prefix?: string): string;
+//# sourceMappingURL=client-helpers.d.ts.map

package/dist/client-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-helpers.d.ts","sourceRoot":"","sources":["../src/client-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,WAAW,EAEhB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAI1B,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,WAAW,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE;YACL,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;IACF,oCAAoC;IACpC,aAAa,CAAC,EAAE;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAgBT;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAC3B,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAC7B,IAAI,CA0BN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,QAAQ,CAiBV;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAOtE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAM5E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,cAAc,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5C,OAAO,CAAC,CAAC,CAAC,CAsCZ;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,SAAK,GAAG,MAAM,CAErD"}

package/dist/client-helpers.js

@@ -0,0 +1,130 @@
+/**
+ * Shared client helpers for SDK and MCP implementations
+ *
+ * This module provides common request/response handling and type aliases
+ * to ensure SDK and MCP clients stay in lockstep and avoid inconsistencies.
+ */
+import { createConnection } from 'node:net';
+import { randomUUID } from 'node:crypto';
+import { encodeFrameLegacy, FrameParser, PROTOCOL_VERSION, } from '@agent-relay/protocol';
+/**
+ * Response matching logic for request/response operations
+ */
+export function isMatchingResponse(response, requestId, correlationId) {
+    const responsePayload = response.payload;
+    // For ACK messages, match by correlationId
+    const ackPayload = response.type === 'ACK' ? response.payload : null;
+    return (response.id === requestId ||
+        responsePayload?.replyTo === requestId ||
+        (!!correlationId &&
+            (responsePayload?.correlationId === correlationId ||
+                ackPayload?.correlationId === correlationId)));
+}
+/**
+ * Handle response resolution/rejection logic
+ */
+export function handleResponse(response, resolve, reject) {
+    const responsePayload = response.payload;
+    if (response.type === 'ERROR') {
+        reject(new Error(responsePayload?.message || responsePayload?.code || 'Unknown error'));
+    }
+    else if (response.type === 'ACK' ||
+        response.type === 'SPAWN_RESULT' ||
+        response.type === 'RELEASE_RESULT') {
+        // ACK, SPAWN_RESULT, and RELEASE_RESULT are valid responses even if they contain error info
+        // For ACK, the error is in response field; for spawn/release, it's in error field
+        resolve(response.payload);
+    }
+    else if (responsePayload?.error && !responsePayload?.success) {
+        // For other response types, reject if there's an error and no success flag
+        reject(new Error(responsePayload.error));
+    }
+    else {
+        resolve(response.payload);
+    }
+}
+/**
+ * Create a request envelope
+ */
+export function createRequestEnvelope(type, payload, requestId, options) {
+    const envelope = {
+        v: PROTOCOL_VERSION,
+        type,
+        id: requestId,
+        ts: Date.now(),
+        payload,
+        from: options?.envelopeProps?.from,
+        to: options?.envelopeProps?.to,
+    };
+    if (options?.payloadMeta) {
+        envelope.payload_meta =
+            options.payloadMeta;
+    }
+    return envelope;
+}
+/**
+ * Convert SpawnResultPayload to SpawnResult
+ */
+export function toSpawnResult(payload) {
+    return {
+        success: payload.success,
+        error: payload.error,
+        pid: payload.pid,
+        name: payload.name,
+    };
+}
+/**
+ * Convert ReleaseResultPayload to ReleaseResult
+ */
+export function toReleaseResult(payload) {
+    return {
+        success: payload.success,
+        error: payload.error,
+        name: payload.name,
+    };
+}
+/**
+ * Create a request/response handler using a socket connection
+ * This is the core logic shared between SDK and MCP clients
+ */
+export function createRequestHandler(socketPath, envelope, options) {
+    return new Promise((resolve, reject) => {
+        const correlationId = options.payloadMeta?.sync?.correlationId;
+        let timedOut = false;
+        const parser = new FrameParser();
+        parser.setLegacyMode(true); // Use legacy 4-byte header format
+        const socket = createConnection(socketPath);
+        const timeoutId = setTimeout(() => {
+            timedOut = true;
+            socket.destroy();
+            reject(new Error(`Request timeout after ${options.timeout}ms`));
+        }, options.timeout);
+        socket.on('connect', () => {
+            socket.write(encodeFrameLegacy(envelope));
+        });
+        socket.on('data', (data) => {
+            if (timedOut)
+                return;
+            const frames = parser.push(data);
+            for (const response of frames) {
+                if (isMatchingResponse(response, envelope.id, correlationId)) {
+                    clearTimeout(timeoutId);
+                    socket.end();
+                    handleResponse(response, resolve, reject);
+                    return;
+                }
+            }
+        });
+        socket.on('error', (err) => {
+            clearTimeout(timeoutId);
+            reject(err);
+        });
+    });
+}
+/**
+ * Generate a unique request ID
+ */
+export function generateRequestId(prefix = '') {
+    return `${prefix}${Date.now().toString(36)}-${randomUUID().slice(0, 8)}`;
+}
+//# sourceMappingURL=client-helpers.js.map

package/dist/client-helpers.js.map

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

package/dist/index.d.ts

@@ -7,4 +7,5 @@ export * from './update-checker.js';
 export * from './error-tracking.js';
 export * from './model-mapping.js';
 export * from './relay-pty-path.js';
+export * from './client-helpers.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -7,4 +7,5 @@ export * from './update-checker.js';
 export * from './error-tracking.js';
 export * from './model-mapping.js';
 export * from './relay-pty-path.js';
+export * from './client-helpers.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/utils",
-  "version": "2.0.31",
+  "version": "2.0.32",
   "description": "Shared utilities for agent-relay: logging, name generation, command resolution, update checking",
   "type": "module",
   "main": "dist/cjs/index.js",
@@ -66,6 +66,12 @@
       "import": "./dist/relay-pty-path.js",
       "default": "./dist/cjs/relay-pty-path.js"
     },
+    "./client-helpers": {
+      "types": "./dist/client-helpers.d.ts",
+      "require": "./dist/cjs/client-helpers.js",
+      "import": "./dist/client-helpers.js",
+      "default": "./dist/cjs/client-helpers.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -88,6 +94,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
+    "@agent-relay/protocol": "2.0.32",
     "compare-versions": "^6.1.1"
   },
   "publishConfig": {