@orchestrator-claude/definitions 3.32.2 → 3.34.0

package/hooks/mailbox-listener.mjs

@@ -0,0 +1,259 @@
+import { createRequire as __createRequireShim } from 'node:module'; const require = __createRequireShim(import.meta.url);
+
+// hooks/mailbox-listener.ts
+import {
+  readdirSync as readdirSync2,
+  readFileSync as readFileSync2,
+  unlinkSync as unlinkSync2,
+  renameSync,
+  existsSync,
+  mkdirSync as mkdirSync2,
+  writeFileSync as writeFileSync2
+} from "node:fs";
+import { join as join2 } from "node:path";
+import { randomUUID } from "node:crypto";
+
+// hooks/lib/api-client.ts
+import { readFileSync, writeFileSync, mkdirSync, statSync, unlinkSync, readdirSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+var PROJECT_ROOT = join(__dirname, "..", "..", "..");
+var STATE_DIR = join(PROJECT_ROOT, ".orchestrator", ".state");
+var JWT_CACHE = join(STATE_DIR, "jwt-token");
+var DEBUG_LOG = join(STATE_DIR, "hook-debug.log");
+mkdirSync(STATE_DIR, { recursive: true });
+var API_URL = process.env.ORCHESTRATOR_API_URL || "http://localhost:3001";
+var AUTH_EMAIL = process.env.ORCHESTRATOR_ADMIN_EMAIL || process.env.ORCHESTRATOR_AUTH_EMAIL || "system@orchestrator.local";
+var AUTH_PASSWORD = process.env.ORCHESTRATOR_ADMIN_PASSWORD || process.env.ORCHESTRATOR_AUTH_PASSWORD || "system123";
+var PROJECT_ID = process.env.ORCHESTRATOR_PROJECT_ID || "";
+function log(prefix, msg) {
+  const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/\.\d+Z$/, "Z");
+  try {
+    const line = `[${ts}] ${prefix}: ${msg}
+`;
+    writeFileSync(DEBUG_LOG, line, { flag: "a" });
+  } catch {
+  }
+}
+var LAST_COMPLETED_FILE = join(STATE_DIR, "last-completed-workflow.json");
+var LAST_COMPLETED_TTL_MS = 60 * 60 * 1e3;
+var INVOCATIONS_DIR = join(STATE_DIR, "invocations");
+var INVOCATION_STATE_TTL_MS = 4 * 60 * 60 * 1e3;
+var DISPATCH_INTENT_DIR = join(STATE_DIR, "dispatch-intent");
+function outputContext(hookEvent, context) {
+  console.log(
+    JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: hookEvent,
+        additionalContext: context
+      }
+    })
+  );
+}
+
+// hooks/mailbox-listener.ts
+var HOOK = "MAILBOX-LISTENER";
+async function readStdinPayload() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+  const raw = Buffer.concat(chunks).toString("utf-8").trim();
+  if (!raw) return {};
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+function consumeInbox(inboxPath, quarantinePath, paneRole) {
+  let files;
+  try {
+    files = readdirSync2(inboxPath).filter((f) => f.endsWith(".json") && !f.startsWith(".tmp-")).sort();
+  } catch {
+    return { consumed: [], errors: [] };
+  }
+  if (files.length === 0) {
+    return { consumed: [], errors: [] };
+  }
+  log(HOOK, `${files.length} message(s) in ${paneRole} inbox`);
+  const consumed = [];
+  const errors = [];
+  for (const file of files) {
+    const filePath = join2(inboxPath, file);
+    try {
+      const raw = readFileSync2(filePath, "utf-8");
+      const parsed = JSON.parse(raw);
+      if (!parsed.id || !parsed.from || !parsed.to || !parsed.body?.type) {
+        throw new Error(`Invalid envelope: missing required fields`);
+      }
+      unlinkSync2(filePath);
+      consumed.push(parsed);
+      log(
+        HOOK,
+        `Consumed: ${parsed.id} (${parsed.body.type} from ${parsed.from.role}-${parsed.from.index})`
+      );
+    } catch (err) {
+      const errMsg = err instanceof Error ? err.message : String(err);
+      errors.push(`${file}: ${errMsg}`);
+      log(HOOK, `Quarantine: ${file} \u2014 ${errMsg}`);
+      try {
+        mkdirSync2(quarantinePath, { recursive: true });
+        renameSync(filePath, join2(quarantinePath, file));
+      } catch {
+      }
+    }
+  }
+  return { consumed, errors };
+}
+function buildContext(consumed, errors, paneRole) {
+  if (consumed.length === 0 && errors.length === 0) {
+    return null;
+  }
+  const parts = [`[MAILBOX] ${consumed.length} new message(s) for ${paneRole}:`];
+  for (const msg of consumed) {
+    const from = `${msg.from.role}-${msg.from.index}`;
+    parts.push("");
+    parts.push(`--- Message from ${from} (${msg.body.type}) ---`);
+    switch (msg.body.type) {
+      case "task_assignment":
+        parts.push(`Task: ${msg.body.taskId}`);
+        parts.push(`Title: ${msg.body.title}`);
+        if (msg.body.description) parts.push(`Description: ${msg.body.description}`);
+        if (msg.body.acceptanceCriteria?.length) {
+          parts.push(`Acceptance Criteria:`);
+          for (const ac of msg.body.acceptanceCriteria) {
+            parts.push(`  - ${ac}`);
+          }
+        }
+        break;
+      case "task_complete":
+        parts.push(`Task: ${msg.body.taskId}`);
+        parts.push(`Summary: ${msg.body.summary}`);
+        break;
+      case "status_update":
+        parts.push(`Task: ${msg.body.taskId}`);
+        parts.push(`Progress: ${msg.body.progress}%`);
+        parts.push(`Status: ${msg.body.message}`);
+        break;
+      case "error_report":
+        parts.push(`Error: ${msg.body.errorCode}`);
+        parts.push(`Message: ${msg.body.message}`);
+        if (msg.body.taskId) parts.push(`Task: ${msg.body.taskId}`);
+        break;
+      case "ping":
+        parts.push(`Ping received \u2014 respond with pong if appropriate.`);
+        break;
+      case "pong":
+        parts.push(`Pong received \u2014 heartbeat confirmed.`);
+        break;
+      default:
+        parts.push(`Type: ${msg.body.type}`);
+        parts.push(`Raw: ${JSON.stringify(msg.body)}`);
+    }
+  }
+  if (errors.length > 0) {
+    parts.push("");
+    parts.push(`[MAILBOX-WARN] ${errors.length} malformed message(s) quarantined:`);
+    for (const e of errors) {
+      parts.push(`  - ${e}`);
+    }
+  }
+  return parts.join("\n");
+}
+var SIDECAR_ROLE_ALLOWLIST = /* @__PURE__ */ new Set([
+  "debug-sidecar",
+  "test-sidecar",
+  "doc-sidecar"
+]);
+function enumerateSidecarAddresses(sprintId, deps = { readdirSync: readdirSync2, writeFileSync: writeFileSync2 }) {
+  const registryDir = `/tmp/${sprintId}/registry`;
+  let files;
+  try {
+    files = deps.readdirSync(registryDir);
+  } catch {
+    return [];
+  }
+  const results = [];
+  for (const filename of files) {
+    if (!filename.endsWith(".json")) continue;
+    const base = filename.slice(0, -5);
+    if (!base.includes("sidecar")) continue;
+    const lastDash = base.lastIndexOf("-");
+    if (lastDash === -1) continue;
+    const indexStr = base.slice(lastDash + 1);
+    const index = parseInt(indexStr, 10);
+    if (isNaN(index)) continue;
+    const role = base.slice(0, lastDash);
+    if (!SIDECAR_ROLE_ALLOWLIST.has(role)) continue;
+    results.push({ role, index });
+  }
+  return results;
+}
+function relaySidecarMessages(consumed, sprintId, paneRole, deps = { readdirSync: readdirSync2, writeFileSync: writeFileSync2 }) {
+  const roleComponent = paneRole.slice(0, paneRole.lastIndexOf("-"));
+  if (roleComponent !== "orchestrator") return;
+  const taskCompletes = consumed.filter((m) => m.body.type === "task_complete");
+  if (taskCompletes.length === 0) return;
+  const sidecars = enumerateSidecarAddresses(sprintId, deps);
+  if (sidecars.length === 0) return;
+  for (const msg of taskCompletes) {
+    for (const sidecar of sidecars) {
+      try {
+        const envelope = {
+          id: randomUUID(),
+          from: { role: "orchestrator", index: 0 },
+          to: { role: sidecar.role, index: sidecar.index },
+          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+          body: msg.body
+        };
+        const sidecarAddr = `${sidecar.role}-${String(sidecar.index)}`;
+        const targetInbox = `/tmp/${sprintId}/mailbox/${sidecarAddr}/inbox`;
+        const targetPath = join2(targetInbox, `${envelope.id}.json`);
+        deps.writeFileSync(targetPath, JSON.stringify(envelope), "utf-8");
+        log(HOOK, `Relayed task_complete to ${sidecarAddr}: ${envelope.id}`);
+      } catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        log(HOOK, `Relay failed for ${sidecar.role}-${String(sidecar.index)}: ${errMsg}`);
+      }
+    }
+  }
+}
+async function main() {
+  const sprintId = process.env.SPRINT_ID;
+  const paneRole = process.env.PANE_ROLE;
+  if (!sprintId || !paneRole) {
+    return;
+  }
+  const inboxPath = `/tmp/${sprintId}/mailbox/${paneRole}/inbox`;
+  const quarantinePath = `/tmp/${sprintId}/mailbox/${paneRole}/quarantine`;
+  if (!existsSync(inboxPath)) {
+    return;
+  }
+  let hookEventName;
+  if (!process.stdin.isTTY) {
+    try {
+      const payload = await readStdinPayload();
+      hookEventName = payload.hook_event_name;
+    } catch {
+    }
+  }
+  const { consumed, errors } = consumeInbox(inboxPath, quarantinePath, paneRole);
+  if (consumed.length === 0 && errors.length === 0) {
+    return;
+  }
+  relaySidecarMessages(consumed, sprintId, paneRole);
+  const context = buildContext(consumed, errors, paneRole);
+  if (!context) {
+    return;
+  }
+  const effectiveEvent = hookEventName === "SessionStart" ? "SessionStart" : "PostToolUse";
+  outputContext(effectiveEvent, context);
+}
+void main();
+export {
+  enumerateSidecarAddresses,
+  relaySidecarMessages
+};