@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-intercom/broker/framing.js

@@ -0,0 +1,74 @@
+export const MAX_FRAME_BYTES = 1024 * 1024;
+/**
+ * Write a length-prefixed message to a socket.
+ * Format: 4-byte big-endian length + JSON payload
+ */
+export function writeMessage(socket, msg) {
+    const json = JSON.stringify(msg);
+    const payload = Buffer.from(json, "utf-8");
+    const header = Buffer.alloc(4);
+    header.writeUInt32BE(payload.length, 0);
+    socket.write(Buffer.concat([header, payload]));
+}
+/**
+ * Create a message reader that handles partial reads.
+ * Calls onMessage for each complete message received.
+ * Protocol or handler errors are reported to onError so the caller can close the socket.
+ */
+export function createMessageReader(onMessage, onError, maxFrameBytes = MAX_FRAME_BYTES) {
+    let buffer = Buffer.alloc(0);
+    function reportMessage(payload) {
+        let msg;
+        try {
+            msg = JSON.parse(payload.toString("utf-8"));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            onError(new Error(`Failed to parse intercom message: ${message}`, { cause: error }));
+            return false;
+        }
+        try {
+            onMessage(msg);
+            return true;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            onError(new Error(`Failed to handle intercom message: ${message}`, { cause: error }));
+            return false;
+        }
+    }
+    return (data) => {
+        let remaining = data;
+        while (remaining.length > 0) {
+            if (buffer.length < 4) {
+                const headerBytes = Math.min(4 - buffer.length, remaining.length);
+                buffer = Buffer.concat([buffer, remaining.subarray(0, headerBytes)]);
+                remaining = remaining.subarray(headerBytes);
+                if (buffer.length < 4) {
+                    return;
+                }
+            }
+            const length = buffer.readUInt32BE(0);
+            if (length > maxFrameBytes) {
+                buffer = Buffer.alloc(0);
+                onError(new Error(`Intercom frame length ${length} exceeds maximum ${maxFrameBytes} bytes`));
+                return;
+            }
+            const missingPayloadBytes = length - Math.max(0, buffer.length - 4);
+            const payloadBytes = Math.min(missingPayloadBytes, remaining.length);
+            if (payloadBytes > 0) {
+                buffer = Buffer.concat([buffer, remaining.subarray(0, payloadBytes)]);
+                remaining = remaining.subarray(payloadBytes);
+            }
+            if (buffer.length < 4 + length) {
+                return;
+            }
+            const payload = buffer.subarray(4, 4 + length);
+            buffer = Buffer.alloc(0);
+            if (!reportMessage(payload)) {
+                return;
+            }
+        }
+    };
+}
+//# sourceMappingURL=framing.js.map

package/dist/builtin-extensions/pi-intercom/broker/framing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.js","sourceRoot":"","sources":["../../../../src/builtin-extensions/pi-intercom/broker/framing.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport type { Socket } from \"net\";\n\nexport const MAX_FRAME_BYTES = 1024 * 1024;\n\n/**\n * Write a length-prefixed message to a socket.\n * Format: 4-byte big-endian length + JSON payload\n */\nexport function writeMessage(socket: Socket, msg: unknown): void {\n  const json = JSON.stringify(msg);\n  const payload = Buffer.from(json, \"utf-8\");\n  const header = Buffer.alloc(4);\n  header.writeUInt32BE(payload.length, 0);\n  socket.write(Buffer.concat([header, payload]));\n}\n\n/**\n * Create a message reader that handles partial reads.\n * Calls onMessage for each complete message received.\n * Protocol or handler errors are reported to onError so the caller can close the socket.\n */\nexport function createMessageReader(\n  onMessage: (msg: unknown) => void,\n  onError: (error: Error) => void,\n  maxFrameBytes = MAX_FRAME_BYTES,\n) {\n  let buffer = Buffer.alloc(0);\n\n  function reportMessage(payload: Buffer): boolean {\n    let msg: unknown;\n    try {\n      msg = JSON.parse(payload.toString(\"utf-8\"));\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      onError(new Error(`Failed to parse intercom message: ${message}`, { cause: error }));\n      return false;\n    }\n\n    try {\n      onMessage(msg);\n      return true;\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      onError(new Error(`Failed to handle intercom message: ${message}`, { cause: error }));\n      return false;\n    }\n  }\n\n  return (data: Buffer) => {\n    let remaining = data;\n\n    while (remaining.length > 0) {\n      if (buffer.length < 4) {\n        const headerBytes = Math.min(4 - buffer.length, remaining.length);\n        buffer = Buffer.concat([buffer, remaining.subarray(0, headerBytes)]);\n        remaining = remaining.subarray(headerBytes);\n        if (buffer.length < 4) {\n          return;\n        }\n      }\n\n      const length = buffer.readUInt32BE(0);\n      if (length > maxFrameBytes) {\n        buffer = Buffer.alloc(0);\n        onError(new Error(`Intercom frame length ${length} exceeds maximum ${maxFrameBytes} bytes`));\n        return;\n      }\n\n      const missingPayloadBytes = length - Math.max(0, buffer.length - 4);\n      const payloadBytes = Math.min(missingPayloadBytes, remaining.length);\n      if (payloadBytes > 0) {\n        buffer = Buffer.concat([buffer, remaining.subarray(0, payloadBytes)]);\n        remaining = remaining.subarray(payloadBytes);\n      }\n\n      if (buffer.length < 4 + length) {\n        return;\n      }\n\n      const payload = buffer.subarray(4, 4 + length);\n      buffer = Buffer.alloc(0);\n      if (!reportMessage(payload)) {\n        return;\n      }\n    }\n  };\n}\n"]}

package/dist/builtin-extensions/pi-intercom/broker/paths.d.ts

@@ -0,0 +1,22 @@
+export declare const INTERCOM_DIR_MODE = 448;
+export declare const INTERCOM_RUNTIME_FILE_MODE = 384;
+export declare const INTERCOM_TCP_HOST = "127.0.0.1";
+export declare const INTERCOM_PROTOCOL_NAME = "pi-intercom";
+export declare const INTERCOM_PROTOCOL_VERSION = 1;
+export interface BrokerTcpEndpoint {
+    transport: "tcp";
+    host: string;
+    port: number;
+    stateId?: string;
+}
+export type BrokerConnectTarget = string | BrokerTcpEndpoint;
+export declare function getAgentDirPath(env?: NodeJS.ProcessEnv, homeDir?: string, cwd?: string): string;
+export declare function getIntercomDirPath(agentDir?: string): string;
+export declare function shouldUseWindowsTcpTransport(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): boolean;
+export declare function getBrokerPortFilePath(intercomDir?: string): string;
+export declare function getBrokerSocketPath(platform?: NodeJS.Platform, agentDir?: string): string;
+export declare function getBrokerConnectTarget(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv, intercomDir?: string): BrokerConnectTarget;
+export declare function getBrokerListenTarget(platform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): BrokerConnectTarget;
+export declare function ensureIntercomRuntimeDir(intercomDir?: string, platform?: NodeJS.Platform): void;
+export declare function restrictIntercomRuntimeFile(filePath: string, platform?: NodeJS.Platform): void;
+//# sourceMappingURL=paths.d.ts.map

package/dist/builtin-extensions/pi-intercom/broker/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../src/builtin-extensions/pi-intercom/broker/paths.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,iBAAiB,MAAQ,CAAC;AACvC,eAAO,MAAM,0BAA0B,MAAQ,CAAC;AAChD,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAC7C,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AACpD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,KAAK,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAS7D,wBAAgB,eAAe,CAC7B,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,OAAO,GAAE,MAAkB,EAC3B,GAAG,GAAE,MAAsB,GAC1B,MAAM,CASR;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,GAAE,MAA0B,GAAG,MAAM,CAE/E;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAYT;AAED,wBAAgB,qBAAqB,CAAC,WAAW,GAAE,MAA6B,GAAG,MAAM,CAExF;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,QAAQ,GAAE,MAA0B,GACnC,MAAM,CAMR;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,WAAW,GAAE,MAAiD,GAC7D,mBAAmB,CAyBrB;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,mBAAmB,CAMrB;AAED,wBAAgB,wBAAwB,CACtC,WAAW,GAAE,MAA6B,EAC1C,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,IAAI,CAKN;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,IAAI,CAIN","sourcesContent":["// @ts-nocheck\nimport { chmodSync, mkdirSync, readFileSync } from \"fs\";\nimport { isAbsolute, join, resolve } from \"path\";\nimport { homedir } from \"os\";\n\nexport const INTERCOM_DIR_MODE = 0o700;\nexport const INTERCOM_RUNTIME_FILE_MODE = 0o600;\nexport const INTERCOM_TCP_HOST = \"127.0.0.1\";\nexport const INTERCOM_PROTOCOL_NAME = \"pi-intercom\";\nexport const INTERCOM_PROTOCOL_VERSION = 1;\n\nexport interface BrokerTcpEndpoint {\n  transport: \"tcp\";\n  host: string;\n  port: number;\n  stateId?: string;\n}\n\nexport type BrokerConnectTarget = string | BrokerTcpEndpoint;\n\nfunction sanitizePipeSegment(value: string): string {\n  return value\n    .replace(/[^a-zA-Z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .toLowerCase() || \"default\";\n}\n\nexport function getAgentDirPath(\n  env: NodeJS.ProcessEnv = process.env,\n  homeDir: string = homedir(),\n  cwd: string = process.cwd(),\n): string {\n  const configured = env.PI_CODING_AGENT_DIR?.trim();\n  if (!configured) {\n    // lunr: fallback was ~/.pi/agent — lunr's agent dir is ~/.lunr/agent. Normally the\n    // env branch wins because core config.ts defaults PI_CODING_AGENT_DIR at startup.\n    return join(homeDir, \".lunr/agent\");\n  }\n\n  return isAbsolute(configured) ? configured : resolve(cwd, configured);\n}\n\nexport function getIntercomDirPath(agentDir: string = getAgentDirPath()): string {\n  return join(agentDir, \"intercom\");\n}\n\nexport function shouldUseWindowsTcpTransport(\n  platform: NodeJS.Platform = process.platform,\n  env: NodeJS.ProcessEnv = process.env,\n): boolean {\n  if (platform !== \"win32\") {\n    return false;\n  }\n\n  const transport = env.PI_INTERCOM_TRANSPORT?.trim().toLowerCase();\n  if (transport === \"tcp\") {\n    return true;\n  }\n\n  const legacyOptIn = env.PI_INTERCOM_TCP?.trim().toLowerCase();\n  return legacyOptIn === \"1\" || legacyOptIn === \"true\";\n}\n\nexport function getBrokerPortFilePath(intercomDir: string = getIntercomDirPath()): string {\n  return join(intercomDir, \"broker.port.json\");\n}\n\nexport function getBrokerSocketPath(\n  platform: NodeJS.Platform = process.platform,\n  agentDir: string = getAgentDirPath(),\n): string {\n  if (platform === \"win32\") {\n    return `\\\\\\\\.\\\\pipe\\\\pi-intercom-${sanitizePipeSegment(agentDir)}`;\n  }\n\n  return join(getIntercomDirPath(agentDir), \"broker.sock\");\n}\n\nexport function getBrokerConnectTarget(\n  platform: NodeJS.Platform = process.platform,\n  env: NodeJS.ProcessEnv = process.env,\n  intercomDir: string = getIntercomDirPath(getAgentDirPath(env)),\n): BrokerConnectTarget {\n  if (shouldUseWindowsTcpTransport(platform, env)) {\n    const endpointFile = getBrokerPortFilePath(intercomDir);\n    const raw = readFileSync(endpointFile, \"utf-8\");\n    const parsed: unknown = JSON.parse(raw);\n    if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n      throw new Error(`Invalid intercom TCP endpoint at ${endpointFile}: expected a JSON object`);\n    }\n    const endpoint = parsed as Record<string, unknown>;\n    if (\n      endpoint.transport !== \"tcp\"\n      || endpoint.host !== INTERCOM_TCP_HOST\n      || typeof endpoint.port !== \"number\"\n      || !Number.isSafeInteger(endpoint.port)\n      || endpoint.port <= 0\n      || endpoint.port > 65535\n      || typeof endpoint.stateId !== \"string\"\n      || endpoint.stateId.length === 0\n    ) {\n      throw new Error(`Invalid intercom TCP endpoint at ${endpointFile}`);\n    }\n    return { transport: \"tcp\", host: endpoint.host, port: endpoint.port, stateId: endpoint.stateId };\n  }\n\n  return getBrokerSocketPath(platform, getAgentDirPath(env));\n}\n\nexport function getBrokerListenTarget(\n  platform: NodeJS.Platform = process.platform,\n  env: NodeJS.ProcessEnv = process.env,\n): BrokerConnectTarget {\n  if (shouldUseWindowsTcpTransport(platform, env)) {\n    return { transport: \"tcp\", host: INTERCOM_TCP_HOST, port: 0 };\n  }\n\n  return getBrokerSocketPath(platform, getAgentDirPath(env));\n}\n\nexport function ensureIntercomRuntimeDir(\n  intercomDir: string = getIntercomDirPath(),\n  platform: NodeJS.Platform = process.platform,\n): void {\n  mkdirSync(intercomDir, { recursive: true, mode: INTERCOM_DIR_MODE });\n  if (platform !== \"win32\") {\n    chmodSync(intercomDir, INTERCOM_DIR_MODE);\n  }\n}\n\nexport function restrictIntercomRuntimeFile(\n  filePath: string,\n  platform: NodeJS.Platform = process.platform,\n): void {\n  if (platform !== \"win32\") {\n    chmodSync(filePath, INTERCOM_RUNTIME_FILE_MODE);\n  }\n}\n"]}

package/dist/builtin-extensions/pi-intercom/broker/paths.js

@@ -0,0 +1,88 @@
+// @ts-nocheck
+import { chmodSync, mkdirSync, readFileSync } from "fs";
+import { isAbsolute, join, resolve } from "path";
+import { homedir } from "os";
+export const INTERCOM_DIR_MODE = 0o700;
+export const INTERCOM_RUNTIME_FILE_MODE = 0o600;
+export const INTERCOM_TCP_HOST = "127.0.0.1";
+export const INTERCOM_PROTOCOL_NAME = "pi-intercom";
+export const INTERCOM_PROTOCOL_VERSION = 1;
+function sanitizePipeSegment(value) {
+    return value
+        .replace(/[^a-zA-Z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .toLowerCase() || "default";
+}
+export function getAgentDirPath(env = process.env, homeDir = homedir(), cwd = process.cwd()) {
+    const configured = env.PI_CODING_AGENT_DIR?.trim();
+    if (!configured) {
+        // lunr: fallback was ~/.pi/agent — lunr's agent dir is ~/.lunr/agent. Normally the
+        // env branch wins because core config.ts defaults PI_CODING_AGENT_DIR at startup.
+        return join(homeDir, ".lunr/agent");
+    }
+    return isAbsolute(configured) ? configured : resolve(cwd, configured);
+}
+export function getIntercomDirPath(agentDir = getAgentDirPath()) {
+    return join(agentDir, "intercom");
+}
+export function shouldUseWindowsTcpTransport(platform = process.platform, env = process.env) {
+    if (platform !== "win32") {
+        return false;
+    }
+    const transport = env.PI_INTERCOM_TRANSPORT?.trim().toLowerCase();
+    if (transport === "tcp") {
+        return true;
+    }
+    const legacyOptIn = env.PI_INTERCOM_TCP?.trim().toLowerCase();
+    return legacyOptIn === "1" || legacyOptIn === "true";
+}
+export function getBrokerPortFilePath(intercomDir = getIntercomDirPath()) {
+    return join(intercomDir, "broker.port.json");
+}
+export function getBrokerSocketPath(platform = process.platform, agentDir = getAgentDirPath()) {
+    if (platform === "win32") {
+        return `\\\\.\\pipe\\pi-intercom-${sanitizePipeSegment(agentDir)}`;
+    }
+    return join(getIntercomDirPath(agentDir), "broker.sock");
+}
+export function getBrokerConnectTarget(platform = process.platform, env = process.env, intercomDir = getIntercomDirPath(getAgentDirPath(env))) {
+    if (shouldUseWindowsTcpTransport(platform, env)) {
+        const endpointFile = getBrokerPortFilePath(intercomDir);
+        const raw = readFileSync(endpointFile, "utf-8");
+        const parsed = JSON.parse(raw);
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            throw new Error(`Invalid intercom TCP endpoint at ${endpointFile}: expected a JSON object`);
+        }
+        const endpoint = parsed;
+        if (endpoint.transport !== "tcp"
+            || endpoint.host !== INTERCOM_TCP_HOST
+            || typeof endpoint.port !== "number"
+            || !Number.isSafeInteger(endpoint.port)
+            || endpoint.port <= 0
+            || endpoint.port > 65535
+            || typeof endpoint.stateId !== "string"
+            || endpoint.stateId.length === 0) {
+            throw new Error(`Invalid intercom TCP endpoint at ${endpointFile}`);
+        }
+        return { transport: "tcp", host: endpoint.host, port: endpoint.port, stateId: endpoint.stateId };
+    }
+    return getBrokerSocketPath(platform, getAgentDirPath(env));
+}
+export function getBrokerListenTarget(platform = process.platform, env = process.env) {
+    if (shouldUseWindowsTcpTransport(platform, env)) {
+        return { transport: "tcp", host: INTERCOM_TCP_HOST, port: 0 };
+    }
+    return getBrokerSocketPath(platform, getAgentDirPath(env));
+}
+export function ensureIntercomRuntimeDir(intercomDir = getIntercomDirPath(), platform = process.platform) {
+    mkdirSync(intercomDir, { recursive: true, mode: INTERCOM_DIR_MODE });
+    if (platform !== "win32") {
+        chmodSync(intercomDir, INTERCOM_DIR_MODE);
+    }
+}
+export function restrictIntercomRuntimeFile(filePath, platform = process.platform) {
+    if (platform !== "win32") {
+        chmodSync(filePath, INTERCOM_RUNTIME_FILE_MODE);
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/builtin-extensions/pi-intercom/broker/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../src/builtin-extensions/pi-intercom/broker/paths.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport { chmodSync, mkdirSync, readFileSync } from \"fs\";\nimport { isAbsolute, join, resolve } from \"path\";\nimport { homedir } from \"os\";\n\nexport const INTERCOM_DIR_MODE = 0o700;\nexport const INTERCOM_RUNTIME_FILE_MODE = 0o600;\nexport const INTERCOM_TCP_HOST = \"127.0.0.1\";\nexport const INTERCOM_PROTOCOL_NAME = \"pi-intercom\";\nexport const INTERCOM_PROTOCOL_VERSION = 1;\n\nexport interface BrokerTcpEndpoint {\n  transport: \"tcp\";\n  host: string;\n  port: number;\n  stateId?: string;\n}\n\nexport type BrokerConnectTarget = string | BrokerTcpEndpoint;\n\nfunction sanitizePipeSegment(value: string): string {\n  return value\n    .replace(/[^a-zA-Z0-9]+/g, \"-\")\n    .replace(/^-+|-+$/g, \"\")\n    .toLowerCase() || \"default\";\n}\n\nexport function getAgentDirPath(\n  env: NodeJS.ProcessEnv = process.env,\n  homeDir: string = homedir(),\n  cwd: string = process.cwd(),\n): string {\n  const configured = env.PI_CODING_AGENT_DIR?.trim();\n  if (!configured) {\n    // lunr: fallback was ~/.pi/agent — lunr's agent dir is ~/.lunr/agent. Normally the\n    // env branch wins because core config.ts defaults PI_CODING_AGENT_DIR at startup.\n    return join(homeDir, \".lunr/agent\");\n  }\n\n  return isAbsolute(configured) ? configured : resolve(cwd, configured);\n}\n\nexport function getIntercomDirPath(agentDir: string = getAgentDirPath()): string {\n  return join(agentDir, \"intercom\");\n}\n\nexport function shouldUseWindowsTcpTransport(\n  platform: NodeJS.Platform = process.platform,\n  env: NodeJS.ProcessEnv = process.env,\n): boolean {\n  if (platform !== \"win32\") {\n    return false;\n  }\n\n  const transport = env.PI_INTERCOM_TRANSPORT?.trim().toLowerCase();\n  if (transport === \"tcp\") {\n    return true;\n  }\n\n  const legacyOptIn = env.PI_INTERCOM_TCP?.trim().toLowerCase();\n  return legacyOptIn === \"1\" || legacyOptIn === \"true\";\n}\n\nexport function getBrokerPortFilePath(intercomDir: string = getIntercomDirPath()): string {\n  return join(intercomDir, \"broker.port.json\");\n}\n\nexport function getBrokerSocketPath(\n  platform: NodeJS.Platform = process.platform,\n  agentDir: string = getAgentDirPath(),\n): string {\n  if (platform === \"win32\") {\n    return `\\\\\\\\.\\\\pipe\\\\pi-intercom-${sanitizePipeSegment(agentDir)}`;\n  }\n\n  return join(getIntercomDirPath(agentDir), \"broker.sock\");\n}\n\nexport function getBrokerConnectTarget(\n  platform: NodeJS.Platform = process.platform,\n  env: NodeJS.ProcessEnv = process.env,\n  intercomDir: string = getIntercomDirPath(getAgentDirPath(env)),\n): BrokerConnectTarget {\n  if (shouldUseWindowsTcpTransport(platform, env)) {\n    const endpointFile = getBrokerPortFilePath(intercomDir);\n    const raw = readFileSync(endpointFile, \"utf-8\");\n    const parsed: unknown = JSON.parse(raw);\n    if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n      throw new Error(`Invalid intercom TCP endpoint at ${endpointFile}: expected a JSON object`);\n    }\n    const endpoint = parsed as Record<string, unknown>;\n    if (\n      endpoint.transport !== \"tcp\"\n      || endpoint.host !== INTERCOM_TCP_HOST\n      || typeof endpoint.port !== \"number\"\n      || !Number.isSafeInteger(endpoint.port)\n      || endpoint.port <= 0\n      || endpoint.port > 65535\n      || typeof endpoint.stateId !== \"string\"\n      || endpoint.stateId.length === 0\n    ) {\n      throw new Error(`Invalid intercom TCP endpoint at ${endpointFile}`);\n    }\n    return { transport: \"tcp\", host: endpoint.host, port: endpoint.port, stateId: endpoint.stateId };\n  }\n\n  return getBrokerSocketPath(platform, getAgentDirPath(env));\n}\n\nexport function getBrokerListenTarget(\n  platform: NodeJS.Platform = process.platform,\n  env: NodeJS.ProcessEnv = process.env,\n): BrokerConnectTarget {\n  if (shouldUseWindowsTcpTransport(platform, env)) {\n    return { transport: \"tcp\", host: INTERCOM_TCP_HOST, port: 0 };\n  }\n\n  return getBrokerSocketPath(platform, getAgentDirPath(env));\n}\n\nexport function ensureIntercomRuntimeDir(\n  intercomDir: string = getIntercomDirPath(),\n  platform: NodeJS.Platform = process.platform,\n): void {\n  mkdirSync(intercomDir, { recursive: true, mode: INTERCOM_DIR_MODE });\n  if (platform !== \"win32\") {\n    chmodSync(intercomDir, INTERCOM_DIR_MODE);\n  }\n}\n\nexport function restrictIntercomRuntimeFile(\n  filePath: string,\n  platform: NodeJS.Platform = process.platform,\n): void {\n  if (platform !== \"win32\") {\n    chmodSync(filePath, INTERCOM_RUNTIME_FILE_MODE);\n  }\n}\n"]}

package/dist/builtin-extensions/pi-intercom/broker/spawn.d.ts

@@ -0,0 +1,27 @@
+type BrokerLaunchSpec = {
+    kind: "direct";
+    command: string;
+    args: string[];
+} | {
+    kind: "windows-launcher";
+    command: string;
+    args: string[];
+    launcherPath: string;
+    launcherCommandLine: string;
+};
+export declare function getTsxCliPath(extensionDir?: string): string;
+export declare function getWindowsHiddenLauncherPath(intercomDir?: string): string;
+export declare function getWindowsBrokerCommandLine(brokerPath: string, extensionDir?: string, nodePath?: string, brokerCommand?: string, brokerArgs?: string[]): string;
+export declare function getWindowsHiddenLauncherScript(commandLine: string): string;
+export declare function isBrokerHealthOkMessage(message: unknown, requestId: string): boolean;
+export declare function getBrokerLaunchSpec(brokerPath: string, brokerCommand: string, brokerArgs: string[], extensionDir?: string, platform?: NodeJS.Platform, intercomDir?: string, nodePath?: string): BrokerLaunchSpec;
+export declare function getBrokerSpawnOptions(extensionDir?: string, env?: NodeJS.ProcessEnv): {
+    detached: true;
+    stdio: "ignore";
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    windowsHide: true;
+};
+export declare function spawnBrokerIfNeeded(brokerCommand: string, brokerArgs: string[]): Promise<void>;
+export {};
+//# sourceMappingURL=spawn.d.ts.map

package/dist/builtin-extensions/pi-intercom/broker/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../../src/builtin-extensions/pi-intercom/broker/spawn.ts"],"names":[],"mappings":"AA0BA,KAAK,gBAAgB,GACjB;IACA,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GACC;IACA,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC;AAMJ,wBAAgB,aAAa,CAAC,YAAY,GAAE,MAAsB,GAAG,MAAM,CAa1E;AAMD,wBAAgB,4BAA4B,CAAC,WAAW,GAAE,MAAqB,GAAG,MAAM,CAEvF;AASD,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,EAClB,YAAY,GAAE,MAAsB,EACpC,QAAQ,GAAE,MAAyB,EACnC,aAAa,SAAQ,EACrB,UAAU,GAAE,MAAM,EAA4B,GAC7C,MAAM,CAMR;AAED,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAO1E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CASpF;AAeD,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,GAAE,MAAsB,EACpC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,WAAW,GAAE,MAAqB,EAClC,QAAQ,GAAE,MAAyB,GAClC,gBAAgB,CAyBlB;AAED,wBAAgB,qBAAqB,CACnC,YAAY,GAAE,MAAsB,EACpC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC;IACD,QAAQ,EAAE,IAAI,CAAC;IACf,KAAK,EAAE,QAAQ,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,WAAW,EAAE,IAAI,CAAC;CACnB,CAQA;AAMD,wBAAsB,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8DpG","sourcesContent":["// @ts-nocheck\nimport { spawn } from \"child_process\";\nimport { existsSync, readFileSync, unlinkSync, writeFileSync } from \"fs\";\nimport { join, dirname } from \"path\";\nimport { fileURLToPath } from \"url\";\nimport { createRequire } from \"module\";\nimport net from \"net\";\nimport { randomUUID } from \"crypto\";\nimport { createMessageReader, writeMessage } from \"./framing.ts\";\nimport {\n  ensureIntercomRuntimeDir,\n  getAgentDirPath,\n  getBrokerConnectTarget,\n  getIntercomDirPath,\n  INTERCOM_PROTOCOL_NAME,\n  INTERCOM_PROTOCOL_VERSION,\n  INTERCOM_RUNTIME_FILE_MODE,\n  restrictIntercomRuntimeFile,\n  type BrokerConnectTarget,\n} from \"./paths.ts\";\n\nconst INTERCOM_DIR = getIntercomDirPath();\nconst EXTENSION_DIR = join(dirname(fileURLToPath(import.meta.url)), \"..\");\nconst BROKER_PID = join(INTERCOM_DIR, \"broker.pid\");\nconst BROKER_SPAWN_LOCK = join(INTERCOM_DIR, \"broker.spawn.lock\");\n\ntype BrokerLaunchSpec =\n  | {\n    kind: \"direct\";\n    command: string;\n    args: string[];\n  }\n  | {\n    kind: \"windows-launcher\";\n    command: string;\n    args: string[];\n    launcherPath: string;\n    launcherCommandLine: string;\n  };\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise(resolve => setTimeout(resolve, ms));\n}\n\nexport function getTsxCliPath(extensionDir: string = EXTENSION_DIR): string {\n  // Resolve tsx via Node's module resolution so it works regardless of whether\n  // tsx is bundled under extensionDir/node_modules or hoisted to a workspace\n  // root by npm. We resolve the tsx package main entry (its \"exports\" field\n  // does not expose ./dist/cli.mjs as a subpath) and then locate cli.mjs next\n  // to it. Falls back to the legacy relative path if resolution fails.\n  try {\n    const requireFromExtension = createRequire(import.meta.url);\n    const tsxMain = requireFromExtension.resolve(\"tsx\");\n    return join(dirname(tsxMain), \"cli.mjs\");\n  } catch {\n    return join(extensionDir, \"node_modules\", \"tsx\", \"dist\", \"cli.mjs\");\n  }\n}\n\nfunction quoteWindowsArg(value: string): string {\n  return `\"${value.replace(/\"/g, '\"\"')}\"`;\n}\n\nexport function getWindowsHiddenLauncherPath(intercomDir: string = INTERCOM_DIR): string {\n  return join(intercomDir, \"broker-launch.vbs\");\n}\n\nfunction usesDefaultBrokerCommand(brokerCommand: string, brokerArgs: string[]): boolean {\n  return brokerCommand === \"npx\"\n    && brokerArgs.length === 2\n    && brokerArgs[0] === \"--no-install\"\n    && brokerArgs[1] === \"tsx\";\n}\n\nexport function getWindowsBrokerCommandLine(\n  brokerPath: string,\n  extensionDir: string = EXTENSION_DIR,\n  nodePath: string = process.execPath,\n  brokerCommand = \"npx\",\n  brokerArgs: string[] = [\"--no-install\", \"tsx\"],\n): string {\n  if (usesDefaultBrokerCommand(brokerCommand, brokerArgs)) {\n    return [quoteWindowsArg(nodePath), quoteWindowsArg(getTsxCliPath(extensionDir)), quoteWindowsArg(brokerPath)].join(\" \");\n  }\n\n  return [quoteWindowsArg(brokerCommand), ...brokerArgs.map(quoteWindowsArg), quoteWindowsArg(brokerPath)].join(\" \");\n}\n\nexport function getWindowsHiddenLauncherScript(commandLine: string): string {\n  return [\n    'Set WshShell = CreateObject(\"WScript.Shell\")',\n    `WshShell.Run \"${commandLine.replace(/\"/g, '\"\"')}\", 0, False`,\n    'Set WshShell = Nothing',\n    '',\n  ].join(\"\\r\\n\");\n}\n\nexport function isBrokerHealthOkMessage(message: unknown, requestId: string): boolean {\n  if (typeof message !== \"object\" || message === null || !(\"type\" in message)) {\n    return false;\n  }\n  const response = message as Record<string, unknown>;\n  return response.type === \"health_ok\"\n    && response.requestId === requestId\n    && response.protocol === INTERCOM_PROTOCOL_NAME\n    && response.version === INTERCOM_PROTOCOL_VERSION;\n}\n\nfunction writeWindowsHiddenLauncher(\n  commandLine: string,\n  launcherPath: string = getWindowsHiddenLauncherPath(),\n): string {\n  ensureIntercomRuntimeDir(dirname(launcherPath));\n  writeFileSync(launcherPath, getWindowsHiddenLauncherScript(commandLine), {\n    encoding: \"utf-8\",\n    mode: INTERCOM_RUNTIME_FILE_MODE,\n  });\n  restrictIntercomRuntimeFile(launcherPath);\n  return launcherPath;\n}\n\nexport function getBrokerLaunchSpec(\n  brokerPath: string,\n  brokerCommand: string,\n  brokerArgs: string[],\n  extensionDir: string = EXTENSION_DIR,\n  platform: NodeJS.Platform = process.platform,\n  intercomDir: string = INTERCOM_DIR,\n  nodePath: string = process.execPath,\n): BrokerLaunchSpec {\n  if (platform === \"win32\") {\n    const launcherPath = getWindowsHiddenLauncherPath(intercomDir);\n    return {\n      kind: \"windows-launcher\",\n      command: \"wscript.exe\",\n      args: [launcherPath],\n      launcherPath,\n      launcherCommandLine: getWindowsBrokerCommandLine(brokerPath, extensionDir, nodePath, brokerCommand, brokerArgs),\n    };\n  }\n\n  if (usesDefaultBrokerCommand(brokerCommand, brokerArgs)) {\n    return {\n      kind: \"direct\",\n      command: nodePath,\n      args: [getTsxCliPath(extensionDir), brokerPath],\n    };\n  }\n\n  return {\n    kind: \"direct\",\n    command: brokerCommand,\n    args: [...brokerArgs, brokerPath],\n  };\n}\n\nexport function getBrokerSpawnOptions(\n  extensionDir: string = EXTENSION_DIR,\n  env: NodeJS.ProcessEnv = process.env,\n): {\n  detached: true;\n  stdio: \"ignore\";\n  cwd: string;\n  env: NodeJS.ProcessEnv;\n  windowsHide: true;\n} {\n  return {\n    detached: true,\n    stdio: \"ignore\",\n    cwd: extensionDir,\n    env: { ...env, PI_CODING_AGENT_DIR: getAgentDirPath(env), NODE_NO_WARNINGS: \"1\" },\n    windowsHide: true,\n  };\n}\n\nfunction toError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error));\n}\n\nexport async function spawnBrokerIfNeeded(brokerCommand: string, brokerArgs: string[]): Promise<void> {\n  ensureIntercomRuntimeDir(INTERCOM_DIR);\n\n  if (await isBrokerRunning()) {\n    return;\n  }\n\n  const ownsLock = acquireSpawnLock();\n  if (!ownsLock) {\n    await waitForBroker();\n    return;\n  }\n\n  try {\n    if (await isBrokerRunning()) {\n      return;\n    }\n\n    const brokerPath = join(dirname(fileURLToPath(import.meta.url)), \"broker.ts\");\n    const launch = getBrokerLaunchSpec(brokerPath, brokerCommand, brokerArgs);\n    if (launch.kind === \"windows-launcher\") {\n      writeWindowsHiddenLauncher(launch.launcherCommandLine, launch.launcherPath);\n    }\n    const child = spawn(launch.command, launch.args, getBrokerSpawnOptions());\n    child.unref();\n\n    await new Promise<void>((resolve, reject) => {\n      const cleanup = () => {\n        child.off(\"error\", onError);\n        child.off(\"exit\", onExit);\n      };\n\n      const onError = (error: Error) => {\n        cleanup();\n        reject(new Error(`Failed to spawn intercom broker: ${error.message}`, { cause: error }));\n      };\n\n      const onExit = (code: number | null, signal: NodeJS.Signals | null) => {\n        if (launch.kind === \"windows-launcher\" && code === 0 && signal === null) {\n          return;\n        }\n        cleanup();\n        if (signal) {\n          reject(new Error(`Intercom broker exited before startup with signal ${signal}`));\n          return;\n        }\n        reject(new Error(`Intercom broker exited before startup with code ${code ?? \"unknown\"}`));\n      };\n\n      child.once(\"error\", onError);\n      child.once(\"exit\", onExit);\n      waitForBroker().then(() => {\n        cleanup();\n        resolve();\n      }, (error) => {\n        cleanup();\n        reject(toError(error));\n      });\n    });\n  } finally {\n    releaseSpawnLock();\n  }\n}\n\nasync function isBrokerRunning(): Promise<boolean> {\n  if (await checkSocketConnectable()) {\n    return true;\n  }\n\n  if (!existsSync(BROKER_PID)) return false;\n\n  try {\n    const pid = parseInt(readFileSync(BROKER_PID, \"utf-8\").trim(), 10);\n    if (!Number.isFinite(pid)) return false;\n    process.kill(pid, 0);\n    return checkSocketConnectable();\n  } catch {\n    // Missing or unreadable PID state means there is no live broker to reuse.\n    return false;\n  }\n}\n\nfunction connectToBrokerTarget(target: BrokerConnectTarget): net.Socket {\n  return typeof target === \"string\"\n    ? net.connect(target)\n    : net.connect({ host: target.host, port: target.port });\n}\n\nfunction checkSocketConnectable(): Promise<boolean> {\n  return new Promise((resolve) => {\n    let target: BrokerConnectTarget;\n    try {\n      target = getBrokerConnectTarget();\n    } catch {\n      resolve(false);\n      return;\n    }\n\n    const socket = connectToBrokerTarget(target);\n    const requestId = randomUUID();\n    const expectedStateId = typeof target === \"string\" ? undefined : target.stateId;\n    let settled = false;\n    const finish = (isConnected: boolean) => {\n      if (settled) {\n        return;\n      }\n      settled = true;\n      clearTimeout(timeout);\n      socket.off(\"connect\", onConnect);\n      socket.off(\"error\", onError);\n      socket.off(\"data\", reader);\n      socket.destroy();\n      resolve(isConnected);\n    };\n    const onConnect = () => {\n      try {\n        writeMessage(socket, {\n          type: \"health\",\n          requestId,\n          ...(expectedStateId ? { stateId: expectedStateId } : {}),\n        });\n      } catch {\n        finish(false);\n      }\n    };\n    const onError = () => finish(false);\n    const reader = createMessageReader((message) => {\n      finish(isBrokerHealthOkMessage(message, requestId));\n    }, () => finish(false));\n    socket.on(\"connect\", onConnect);\n    socket.on(\"error\", onError);\n    socket.on(\"data\", reader);\n    const timeout = setTimeout(() => finish(false), 1000);\n  });\n}\n\nfunction acquireSpawnLock(): boolean {\n  const maxRetries = 5;\n  for (let attempt = 0; attempt < maxRetries; attempt++) {\n    try {\n      writeFileSync(BROKER_SPAWN_LOCK, `${process.pid}\\n${Date.now()}\\n`, {\n        flag: \"wx\",\n        mode: INTERCOM_RUNTIME_FILE_MODE,\n      });\n      restrictIntercomRuntimeFile(BROKER_SPAWN_LOCK);\n      return true;\n    } catch (error) {\n      if (!(error instanceof Error) || (error as NodeJS.ErrnoException).code !== \"EEXIST\") {\n        throw error;\n      }\n      if (isSpawnLockStale()) {\n        try {\n          unlinkSync(BROKER_SPAWN_LOCK);\n        } catch {\n          // If we can't delete the stale lock, retry a few times before giving up\n        }\n        continue;\n      }\n      return false;\n    }\n  }\n  return false;\n}\n\nfunction isSpawnLockStale(): boolean {\n  if (!existsSync(BROKER_SPAWN_LOCK)) {\n    return false;\n  }\n\n  try {\n    const [pidLine = \"\", createdAtLine = \"0\"] = readFileSync(BROKER_SPAWN_LOCK, \"utf-8\").trim().split(\"\\n\");\n    const pid = Number.parseInt(pidLine, 10);\n    const createdAt = Number.parseInt(createdAtLine, 10);\n    const ageMs = Date.now() - createdAt;\n\n    if (Number.isFinite(pid)) {\n      try {\n        process.kill(pid, 0);\n      } catch {\n        // The process that created the lock is gone.\n        return true;\n      }\n    }\n\n    return !Number.isFinite(createdAt) || ageMs > 10_000;\n  } catch {\n    // Unreadable lock contents are treated as stale so a new broker can start.\n    return true;\n  }\n}\n\nfunction releaseSpawnLock(): void {\n  try {\n    unlinkSync(BROKER_SPAWN_LOCK);\n  } catch {\n    // Another cleanup path may already have removed the lock.\n  }\n}\n\nasync function waitForBroker(timeoutMs = 5000): Promise<void> {\n  const start = Date.now();\n  while (Date.now() - start < timeoutMs) {\n    if (await checkSocketConnectable()) {\n      return;\n    }\n    await sleep(100);\n  }\n  throw new Error(\"Broker failed to start within timeout\");\n}\n"]}

package/dist/builtin-extensions/pi-intercom/broker/spawn.js

@@ -0,0 +1,313 @@
+// @ts-nocheck
+import { spawn } from "child_process";
+import { existsSync, readFileSync, unlinkSync, writeFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { createRequire } from "module";
+import net from "net";
+import { randomUUID } from "crypto";
+import { createMessageReader, writeMessage } from "./framing.js";
+import { ensureIntercomRuntimeDir, getAgentDirPath, getBrokerConnectTarget, getIntercomDirPath, INTERCOM_PROTOCOL_NAME, INTERCOM_PROTOCOL_VERSION, INTERCOM_RUNTIME_FILE_MODE, restrictIntercomRuntimeFile, } from "./paths.js";
+const INTERCOM_DIR = getIntercomDirPath();
+const EXTENSION_DIR = join(dirname(fileURLToPath(import.meta.url)), "..");
+const BROKER_PID = join(INTERCOM_DIR, "broker.pid");
+const BROKER_SPAWN_LOCK = join(INTERCOM_DIR, "broker.spawn.lock");
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+export function getTsxCliPath(extensionDir = EXTENSION_DIR) {
+    // Resolve tsx via Node's module resolution so it works regardless of whether
+    // tsx is bundled under extensionDir/node_modules or hoisted to a workspace
+    // root by npm. We resolve the tsx package main entry (its "exports" field
+    // does not expose ./dist/cli.mjs as a subpath) and then locate cli.mjs next
+    // to it. Falls back to the legacy relative path if resolution fails.
+    try {
+        const requireFromExtension = createRequire(import.meta.url);
+        const tsxMain = requireFromExtension.resolve("tsx");
+        return join(dirname(tsxMain), "cli.mjs");
+    }
+    catch {
+        return join(extensionDir, "node_modules", "tsx", "dist", "cli.mjs");
+    }
+}
+function quoteWindowsArg(value) {
+    return `"${value.replace(/"/g, '""')}"`;
+}
+export function getWindowsHiddenLauncherPath(intercomDir = INTERCOM_DIR) {
+    return join(intercomDir, "broker-launch.vbs");
+}
+function usesDefaultBrokerCommand(brokerCommand, brokerArgs) {
+    return brokerCommand === "npx"
+        && brokerArgs.length === 2
+        && brokerArgs[0] === "--no-install"
+        && brokerArgs[1] === "tsx";
+}
+export function getWindowsBrokerCommandLine(brokerPath, extensionDir = EXTENSION_DIR, nodePath = process.execPath, brokerCommand = "npx", brokerArgs = ["--no-install", "tsx"]) {
+    if (usesDefaultBrokerCommand(brokerCommand, brokerArgs)) {
+        return [quoteWindowsArg(nodePath), quoteWindowsArg(getTsxCliPath(extensionDir)), quoteWindowsArg(brokerPath)].join(" ");
+    }
+    return [quoteWindowsArg(brokerCommand), ...brokerArgs.map(quoteWindowsArg), quoteWindowsArg(brokerPath)].join(" ");
+}
+export function getWindowsHiddenLauncherScript(commandLine) {
+    return [
+        'Set WshShell = CreateObject("WScript.Shell")',
+        `WshShell.Run "${commandLine.replace(/"/g, '""')}", 0, False`,
+        'Set WshShell = Nothing',
+        '',
+    ].join("\r\n");
+}
+export function isBrokerHealthOkMessage(message, requestId) {
+    if (typeof message !== "object" || message === null || !("type" in message)) {
+        return false;
+    }
+    const response = message;
+    return response.type === "health_ok"
+        && response.requestId === requestId
+        && response.protocol === INTERCOM_PROTOCOL_NAME
+        && response.version === INTERCOM_PROTOCOL_VERSION;
+}
+function writeWindowsHiddenLauncher(commandLine, launcherPath = getWindowsHiddenLauncherPath()) {
+    ensureIntercomRuntimeDir(dirname(launcherPath));
+    writeFileSync(launcherPath, getWindowsHiddenLauncherScript(commandLine), {
+        encoding: "utf-8",
+        mode: INTERCOM_RUNTIME_FILE_MODE,
+    });
+    restrictIntercomRuntimeFile(launcherPath);
+    return launcherPath;
+}
+export function getBrokerLaunchSpec(brokerPath, brokerCommand, brokerArgs, extensionDir = EXTENSION_DIR, platform = process.platform, intercomDir = INTERCOM_DIR, nodePath = process.execPath) {
+    if (platform === "win32") {
+        const launcherPath = getWindowsHiddenLauncherPath(intercomDir);
+        return {
+            kind: "windows-launcher",
+            command: "wscript.exe",
+            args: [launcherPath],
+            launcherPath,
+            launcherCommandLine: getWindowsBrokerCommandLine(brokerPath, extensionDir, nodePath, brokerCommand, brokerArgs),
+        };
+    }
+    if (usesDefaultBrokerCommand(brokerCommand, brokerArgs)) {
+        return {
+            kind: "direct",
+            command: nodePath,
+            args: [getTsxCliPath(extensionDir), brokerPath],
+        };
+    }
+    return {
+        kind: "direct",
+        command: brokerCommand,
+        args: [...brokerArgs, brokerPath],
+    };
+}
+export function getBrokerSpawnOptions(extensionDir = EXTENSION_DIR, env = process.env) {
+    return {
+        detached: true,
+        stdio: "ignore",
+        cwd: extensionDir,
+        env: { ...env, PI_CODING_AGENT_DIR: getAgentDirPath(env), NODE_NO_WARNINGS: "1" },
+        windowsHide: true,
+    };
+}
+function toError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+export async function spawnBrokerIfNeeded(brokerCommand, brokerArgs) {
+    ensureIntercomRuntimeDir(INTERCOM_DIR);
+    if (await isBrokerRunning()) {
+        return;
+    }
+    const ownsLock = acquireSpawnLock();
+    if (!ownsLock) {
+        await waitForBroker();
+        return;
+    }
+    try {
+        if (await isBrokerRunning()) {
+            return;
+        }
+        const brokerPath = join(dirname(fileURLToPath(import.meta.url)), "broker.ts");
+        const launch = getBrokerLaunchSpec(brokerPath, brokerCommand, brokerArgs);
+        if (launch.kind === "windows-launcher") {
+            writeWindowsHiddenLauncher(launch.launcherCommandLine, launch.launcherPath);
+        }
+        const child = spawn(launch.command, launch.args, getBrokerSpawnOptions());
+        child.unref();
+        await new Promise((resolve, reject) => {
+            const cleanup = () => {
+                child.off("error", onError);
+                child.off("exit", onExit);
+            };
+            const onError = (error) => {
+                cleanup();
+                reject(new Error(`Failed to spawn intercom broker: ${error.message}`, { cause: error }));
+            };
+            const onExit = (code, signal) => {
+                if (launch.kind === "windows-launcher" && code === 0 && signal === null) {
+                    return;
+                }
+                cleanup();
+                if (signal) {
+                    reject(new Error(`Intercom broker exited before startup with signal ${signal}`));
+                    return;
+                }
+                reject(new Error(`Intercom broker exited before startup with code ${code ?? "unknown"}`));
+            };
+            child.once("error", onError);
+            child.once("exit", onExit);
+            waitForBroker().then(() => {
+                cleanup();
+                resolve();
+            }, (error) => {
+                cleanup();
+                reject(toError(error));
+            });
+        });
+    }
+    finally {
+        releaseSpawnLock();
+    }
+}
+async function isBrokerRunning() {
+    if (await checkSocketConnectable()) {
+        return true;
+    }
+    if (!existsSync(BROKER_PID))
+        return false;
+    try {
+        const pid = parseInt(readFileSync(BROKER_PID, "utf-8").trim(), 10);
+        if (!Number.isFinite(pid))
+            return false;
+        process.kill(pid, 0);
+        return checkSocketConnectable();
+    }
+    catch {
+        // Missing or unreadable PID state means there is no live broker to reuse.
+        return false;
+    }
+}
+function connectToBrokerTarget(target) {
+    return typeof target === "string"
+        ? net.connect(target)
+        : net.connect({ host: target.host, port: target.port });
+}
+function checkSocketConnectable() {
+    return new Promise((resolve) => {
+        let target;
+        try {
+            target = getBrokerConnectTarget();
+        }
+        catch {
+            resolve(false);
+            return;
+        }
+        const socket = connectToBrokerTarget(target);
+        const requestId = randomUUID();
+        const expectedStateId = typeof target === "string" ? undefined : target.stateId;
+        let settled = false;
+        const finish = (isConnected) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timeout);
+            socket.off("connect", onConnect);
+            socket.off("error", onError);
+            socket.off("data", reader);
+            socket.destroy();
+            resolve(isConnected);
+        };
+        const onConnect = () => {
+            try {
+                writeMessage(socket, {
+                    type: "health",
+                    requestId,
+                    ...(expectedStateId ? { stateId: expectedStateId } : {}),
+                });
+            }
+            catch {
+                finish(false);
+            }
+        };
+        const onError = () => finish(false);
+        const reader = createMessageReader((message) => {
+            finish(isBrokerHealthOkMessage(message, requestId));
+        }, () => finish(false));
+        socket.on("connect", onConnect);
+        socket.on("error", onError);
+        socket.on("data", reader);
+        const timeout = setTimeout(() => finish(false), 1000);
+    });
+}
+function acquireSpawnLock() {
+    const maxRetries = 5;
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        try {
+            writeFileSync(BROKER_SPAWN_LOCK, `${process.pid}\n${Date.now()}\n`, {
+                flag: "wx",
+                mode: INTERCOM_RUNTIME_FILE_MODE,
+            });
+            restrictIntercomRuntimeFile(BROKER_SPAWN_LOCK);
+            return true;
+        }
+        catch (error) {
+            if (!(error instanceof Error) || error.code !== "EEXIST") {
+                throw error;
+            }
+            if (isSpawnLockStale()) {
+                try {
+                    unlinkSync(BROKER_SPAWN_LOCK);
+                }
+                catch {
+                    // If we can't delete the stale lock, retry a few times before giving up
+                }
+                continue;
+            }
+            return false;
+        }
+    }
+    return false;
+}
+function isSpawnLockStale() {
+    if (!existsSync(BROKER_SPAWN_LOCK)) {
+        return false;
+    }
+    try {
+        const [pidLine = "", createdAtLine = "0"] = readFileSync(BROKER_SPAWN_LOCK, "utf-8").trim().split("\n");
+        const pid = Number.parseInt(pidLine, 10);
+        const createdAt = Number.parseInt(createdAtLine, 10);
+        const ageMs = Date.now() - createdAt;
+        if (Number.isFinite(pid)) {
+            try {
+                process.kill(pid, 0);
+            }
+            catch {
+                // The process that created the lock is gone.
+                return true;
+            }
+        }
+        return !Number.isFinite(createdAt) || ageMs > 10_000;
+    }
+    catch {
+        // Unreadable lock contents are treated as stale so a new broker can start.
+        return true;
+    }
+}
+function releaseSpawnLock() {
+    try {
+        unlinkSync(BROKER_SPAWN_LOCK);
+    }
+    catch {
+        // Another cleanup path may already have removed the lock.
+    }
+}
+async function waitForBroker(timeoutMs = 5000) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        if (await checkSocketConnectable()) {
+            return;
+        }
+        await sleep(100);
+    }
+    throw new Error("Broker failed to start within timeout");
+}
+//# sourceMappingURL=spawn.js.map