@narumitw/pi-subagents 2.1.3 → 3.0.0

package/dist/child-communication-bridge.ts

@@ -0,0 +1,136 @@
+// @generated by scripts/build-runtime.mjs; do not edit.
+// @ts-nocheck -- generated entries use .ts extensions for Pi's Jiti loader.
+import {
+  MAX_FRAME_BYTES,
+  MAX_IDENTIFIER_LENGTH,
+  captureBrokerCredentials,
+  createChildCommunicationExtension
+} from "./chunks/chunk-UKTWUQRM.js";
+
+// src/child-communication-bridge.ts
+import net from "node:net";
+var CONNECT_TIMEOUT_MS = 2e3;
+var SEND_RESPONSE_TIMEOUT_MS = 5e3;
+var captured = captureBrokerCredentials();
+var childCommunicationBridge = captured ? createChildCommunicationExtension(createBrokerClient(captured)) : () => void 0;
+var child_communication_bridge_default = childCommunicationBridge;
+function createBrokerClient(credentials) {
+  return {
+    async send(params, signal) {
+      const response = await requestBroker(
+        credentials,
+        { type: "send", token: credentials.token, ...params },
+        signal,
+        SEND_RESPONSE_TIMEOUT_MS
+      );
+      if (response.ok !== true) throw brokerError(response);
+      if (typeof response.requestId !== "string" || !response.requestId || response.requestId.length > MAX_IDENTIFIER_LENGTH || typeof response.accepted !== "boolean" || typeof response.duplicate !== "boolean") {
+        throw new Error("Subagent broker returned an invalid send acknowledgement.");
+      }
+      return {
+        requestId: response.requestId,
+        accepted: response.accepted,
+        duplicate: response.duplicate
+      };
+    },
+    async wait(requestId, timeoutMs, signal) {
+      const response = await requestBroker(
+        credentials,
+        {
+          type: "wait",
+          token: credentials.token,
+          requestId,
+          ...timeoutMs !== void 0 ? { timeoutMs } : {}
+        },
+        signal
+      );
+      if (response.ok !== true) throw brokerError(response);
+      if (typeof response.response !== "string") {
+        throw new Error("Subagent broker returned an invalid plain-text response.");
+      }
+      return response.response;
+    }
+  };
+}
+function requestBroker(credentials, request, signal, responseTimeoutMs) {
+  if (signal?.aborted) return Promise.reject(abortError("Subagent broker request was cancelled."));
+  return new Promise((resolve, reject) => {
+    const socket = net.createConnection({ host: credentials.host, port: credentials.port });
+    let response = Buffer.alloc(0);
+    let settled = false;
+    let responseTimer;
+    const connectTimer = setTimeout(
+      () => finish(new Error("Subagent broker connection timed out.")),
+      CONNECT_TIMEOUT_MS
+    );
+    connectTimer.unref();
+    const onAbort = () => finish(abortError("Subagent broker request was cancelled."));
+    const finish = (error, value) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(connectTimer);
+      if (responseTimer) clearTimeout(responseTimer);
+      signal?.removeEventListener("abort", onAbort);
+      socket.destroy();
+      if (error) reject(error);
+      else resolve(value ?? {});
+    };
+    signal?.addEventListener("abort", onAbort, { once: true });
+    socket.once("connect", () => {
+      clearTimeout(connectTimer);
+      if (responseTimeoutMs !== void 0) {
+        responseTimer = setTimeout(
+          () => finish(new Error("Subagent broker response timed out.")),
+          responseTimeoutMs
+        );
+        responseTimer.unref();
+      }
+      socket.write(`${JSON.stringify(request)}
+`);
+    });
+    socket.on("data", (chunk) => {
+      if (settled) return;
+      response = Buffer.concat([response, chunk]);
+      if (response.byteLength > MAX_FRAME_BYTES) {
+        finish(new Error("Subagent broker response exceeded its size limit."));
+        return;
+      }
+      const newline = response.indexOf(10);
+      if (newline < 0) return;
+      const trailing = response.subarray(newline + 1).toString("utf8").trim();
+      if (trailing) {
+        finish(new Error("Subagent broker returned more than one response frame."));
+        return;
+      }
+      try {
+        const parsed = JSON.parse(response.subarray(0, newline).toString("utf8"));
+        if (!isRecord(parsed)) throw new Error();
+        finish(void 0, parsed);
+      } catch {
+        finish(new Error("Subagent broker returned malformed JSON."));
+      }
+    });
+    socket.once("error", (error) => finish(error));
+    socket.once("close", () => {
+      if (!settled) finish(new Error("Subagent broker closed without a response."));
+    });
+  });
+}
+function brokerError(response) {
+  return new Error(
+    typeof response.error === "string" ? response.error : "Subagent broker rejected the request."
+  );
+}
+function abortError(message) {
+  const error = new Error(message);
+  error.name = "AbortError";
+  return error;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export {
+  createBrokerClient,
+  child_communication_bridge_default as default
+};
+//# sourceMappingURL=child-communication-bridge.ts.map

package/dist/child-communication-bridge.ts.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/child-communication-bridge.ts"],
+  "sourcesContent": ["import net from \"node:net\";\nimport type { ExtensionFactory } from \"@earendil-works/pi-coding-agent\";\nimport { captureBrokerCredentials } from \"./broker-credentials.js\";\nimport {\n\ttype ChildCommunicationClient,\n\tcreateChildCommunicationExtension,\n} from \"./child-communication-tools.js\";\nimport { MAX_FRAME_BYTES, MAX_IDENTIFIER_LENGTH } from \"./message-broker.js\";\nimport type { BrokerCredentials } from \"./types.js\";\n\nconst CONNECT_TIMEOUT_MS = 2_000;\nconst SEND_RESPONSE_TIMEOUT_MS = 5_000;\n\nconst captured = captureBrokerCredentials();\n\nconst childCommunicationBridge: ExtensionFactory = captured\n\t? createChildCommunicationExtension(createBrokerClient(captured))\n\t: () => undefined;\n\nexport default childCommunicationBridge;\n\nexport function createBrokerClient(credentials: BrokerCredentials): ChildCommunicationClient {\n\treturn {\n\t\tasync send(params, signal) {\n\t\t\tconst response = await requestBroker(\n\t\t\t\tcredentials,\n\t\t\t\t{ type: \"send\", token: credentials.token, ...params },\n\t\t\t\tsignal,\n\t\t\t\tSEND_RESPONSE_TIMEOUT_MS,\n\t\t\t);\n\t\t\tif (response.ok !== true) throw brokerError(response);\n\t\t\tif (\n\t\t\t\ttypeof response.requestId !== \"string\" ||\n\t\t\t\t!response.requestId ||\n\t\t\t\tresponse.requestId.length > MAX_IDENTIFIER_LENGTH ||\n\t\t\t\ttypeof response.accepted !== \"boolean\" ||\n\t\t\t\ttypeof response.duplicate !== \"boolean\"\n\t\t\t) {\n\t\t\t\tthrow new Error(\"Subagent broker returned an invalid send acknowledgement.\");\n\t\t\t}\n\t\t\treturn {\n\t\t\t\trequestId: response.requestId,\n\t\t\t\taccepted: response.accepted,\n\t\t\t\tduplicate: response.duplicate,\n\t\t\t};\n\t\t},\n\t\tasync wait(requestId, timeoutMs, signal) {\n\t\t\tconst response = await requestBroker(\n\t\t\t\tcredentials,\n\t\t\t\t{\n\t\t\t\t\ttype: \"wait\",\n\t\t\t\t\ttoken: credentials.token,\n\t\t\t\t\trequestId,\n\t\t\t\t\t...(timeoutMs !== undefined ? { timeoutMs } : {}),\n\t\t\t\t},\n\t\t\t\tsignal,\n\t\t\t);\n\t\t\tif (response.ok !== true) throw brokerError(response);\n\t\t\tif (typeof response.response !== \"string\") {\n\t\t\t\tthrow new Error(\"Subagent broker returned an invalid plain-text response.\");\n\t\t\t}\n\t\t\treturn response.response;\n\t\t},\n\t};\n}\n\nfunction requestBroker(\n\tcredentials: BrokerCredentials,\n\trequest: Record<string, unknown>,\n\tsignal?: AbortSignal,\n\tresponseTimeoutMs?: number,\n): Promise<Record<string, unknown>> {\n\tif (signal?.aborted) return Promise.reject(abortError(\"Subagent broker request was cancelled.\"));\n\treturn new Promise((resolve, reject) => {\n\t\tconst socket = net.createConnection({ host: credentials.host, port: credentials.port });\n\t\tlet response = Buffer.alloc(0);\n\t\tlet settled = false;\n\t\tlet responseTimer: NodeJS.Timeout | undefined;\n\t\tconst connectTimer = setTimeout(\n\t\t\t() => finish(new Error(\"Subagent broker connection timed out.\")),\n\t\t\tCONNECT_TIMEOUT_MS,\n\t\t);\n\t\tconnectTimer.unref();\n\t\tconst onAbort = () => finish(abortError(\"Subagent broker request was cancelled.\"));\n\t\tconst finish = (error?: Error, value?: Record<string, unknown>) => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tclearTimeout(connectTimer);\n\t\t\tif (responseTimer) clearTimeout(responseTimer);\n\t\t\tsignal?.removeEventListener(\"abort\", onAbort);\n\t\t\tsocket.destroy();\n\t\t\tif (error) reject(error);\n\t\t\telse resolve(value ?? {});\n\t\t};\n\t\tsignal?.addEventListener(\"abort\", onAbort, { once: true });\n\t\tsocket.once(\"connect\", () => {\n\t\t\tclearTimeout(connectTimer);\n\t\t\tif (responseTimeoutMs !== undefined) {\n\t\t\t\tresponseTimer = setTimeout(\n\t\t\t\t\t() => finish(new Error(\"Subagent broker response timed out.\")),\n\t\t\t\t\tresponseTimeoutMs,\n\t\t\t\t);\n\t\t\t\tresponseTimer.unref();\n\t\t\t}\n\t\t\tsocket.write(`${JSON.stringify(request)}\\n`);\n\t\t});\n\t\tsocket.on(\"data\", (chunk: Buffer) => {\n\t\t\tif (settled) return;\n\t\t\tresponse = Buffer.concat([response, chunk]);\n\t\t\tif (response.byteLength > MAX_FRAME_BYTES) {\n\t\t\t\tfinish(new Error(\"Subagent broker response exceeded its size limit.\"));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tconst newline = response.indexOf(0x0a);\n\t\t\tif (newline < 0) return;\n\t\t\tconst trailing = response\n\t\t\t\t.subarray(newline + 1)\n\t\t\t\t.toString(\"utf8\")\n\t\t\t\t.trim();\n\t\t\tif (trailing) {\n\t\t\t\tfinish(new Error(\"Subagent broker returned more than one response frame.\"));\n\t\t\t\treturn;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tconst parsed = JSON.parse(response.subarray(0, newline).toString(\"utf8\")) as unknown;\n\t\t\t\tif (!isRecord(parsed)) throw new Error();\n\t\t\t\tfinish(undefined, parsed);\n\t\t\t} catch {\n\t\t\t\tfinish(new Error(\"Subagent broker returned malformed JSON.\"));\n\t\t\t}\n\t\t});\n\t\tsocket.once(\"error\", (error) => finish(error));\n\t\tsocket.once(\"close\", () => {\n\t\t\tif (!settled) finish(new Error(\"Subagent broker closed without a response.\"));\n\t\t});\n\t});\n}\n\nfunction brokerError(response: Record<string, unknown>): Error {\n\treturn new Error(\n\t\ttypeof response.error === \"string\" ? response.error : \"Subagent broker rejected the request.\",\n\t);\n}\n\nfunction abortError(message: string): Error {\n\tconst error = new Error(message);\n\terror.name = \"AbortError\";\n\treturn error;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n"],
+  "mappings": "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",
+  "names": []
+}