claude-code-swarm 0.3.3 → 0.3.5

package/references/agent-inbox/hooks/inbox-hook.mjs

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+
+/**
+ * UserPromptSubmit hook — reads the agent's inbox file and injects
+ * pending messages into Claude's context as formatted markdown.
+ *
+ * Setup (in .claude/settings.json or ~/.claude/settings.json):
+ *
+ *   {
+ *     "hooks": {
+ *       "UserPromptSubmit": [{
+ *         "hooks": [{
+ *           "type": "command",
+ *           "command": "node /path/to/agent-inbox/hooks/inbox-hook.mjs"
+ *         }]
+ *       }]
+ *     }
+ *   }
+ *
+ * Environment:
+ *   INBOX_AGENT_ID  — Agent ID to check inbox for (required)
+ *   INBOX_DIR       — Directory containing inbox files
+ *                     (default: ~/.cache/agent-inbox/inboxes)
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+
+const agentId = process.env.INBOX_AGENT_ID;
+if (!agentId) {
+  // No agent ID configured — silently pass through
+  process.exit(0);
+}
+
+const inboxDir =
+  process.env.INBOX_DIR ||
+  path.join(os.homedir(), ".cache", "agent-inbox", "inboxes");
+
+// Sanitize agent ID for filename (matches PushNotifier.agentInboxPath)
+const safe = agentId.replace(/[^a-zA-Z0-9_-]/g, "_");
+const inboxFile = path.join(inboxDir, `${safe}.inbox.jsonl`);
+
+// Read inbox file
+let raw;
+try {
+  raw = fs.readFileSync(inboxFile, "utf-8").trim();
+} catch {
+  // No inbox file — nothing to inject
+  process.exit(0);
+}
+
+if (!raw) {
+  process.exit(0);
+}
+
+// Parse NDJSON entries
+const entries = [];
+for (const line of raw.split("\n")) {
+  if (!line.trim()) continue;
+  try {
+    entries.push(JSON.parse(line));
+  } catch {
+    // Skip malformed lines
+  }
+}
+
+if (entries.length === 0) {
+  process.exit(0);
+}
+
+// Clear the inbox file (atomic: write empty string)
+try {
+  fs.writeFileSync(inboxFile, "");
+} catch {
+  // Best-effort clear
+}
+
+// Format as markdown (mirrors formatInboxMarkdown in src/push/notifier.ts)
+const lines = [];
+lines.push(`## [Inbox] ${entries.length} new message(s)\n`);
+
+for (const entry of entries) {
+  const age = formatAge(entry.timestamp);
+  const priority =
+    entry.importance && entry.importance !== "normal"
+      ? ` [${entry.importance}]`
+      : "";
+  const subject = entry.subject ? ` — ${entry.subject}` : "";
+  const thread = entry.threadTag ? ` (thread: ${entry.threadTag})` : "";
+
+  lines.push(
+    `**From ${entry.from}** (${age} ago)${priority}${subject}${thread}`
+  );
+
+  // Format content
+  const content = entry.content;
+  if (content && typeof content === "object" && content.type === "text") {
+    lines.push(`> ${content.text}`);
+  } else if (typeof content === "string") {
+    lines.push(`> ${content}`);
+  } else {
+    lines.push(`> \`${JSON.stringify(content)}\``);
+  }
+  lines.push("");
+}
+
+// Output to stdout — Claude Code injects this into the agent's context
+process.stdout.write(lines.join("\n"));
+
+function formatAge(timestamp) {
+  if (!timestamp) return "?";
+  const diff = Date.now() - new Date(timestamp).getTime();
+  if (diff < 1000) return "<1s";
+  if (diff < 60_000) return `${Math.floor(diff / 1000)}s`;
+  if (diff < 3_600_000) return `${Math.floor(diff / 60_000)}m`;
+  if (diff < 86_400_000) return `${Math.floor(diff / 3_600_000)}h`;
+  return `${Math.floor(diff / 86_400_000)}d`;
+}

package/references/agent-inbox/hooks/register-hook.mjs

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+
+/**
+ * SessionStart hook — auto-registers the agent with Agent Inbox
+ * so it can receive messages immediately.
+ *
+ * Connects to the Agent Inbox IPC socket and sends a register_agent
+ * request. If the socket isn't running, silently continues.
+ *
+ * Setup (in .claude/settings.json or ~/.claude/settings.json):
+ *
+ *   {
+ *     "hooks": {
+ *       "SessionStart": [{
+ *         "hooks": [{
+ *           "type": "command",
+ *           "command": "node /path/to/agent-inbox/hooks/register-hook.mjs"
+ *         }]
+ *       }]
+ *     }
+ *   }
+ *
+ * Environment:
+ *   INBOX_AGENT_ID   — Agent ID to register (required)
+ *   INBOX_AGENT_NAME — Display name (optional, defaults to agent ID)
+ *   INBOX_SOCKET     — IPC socket path
+ *                      (default: ~/.cache/agent-inbox/inbox.sock)
+ */
+
+import * as net from "node:net";
+import * as path from "node:path";
+import * as os from "node:os";
+
+const agentId = process.env.INBOX_AGENT_ID;
+if (!agentId) {
+  process.exit(0);
+}
+
+const agentName = process.env.INBOX_AGENT_NAME || agentId;
+const socketPath =
+  process.env.INBOX_SOCKET ||
+  path.join(os.homedir(), ".cache", "agent-inbox", "inbox.sock");
+
+const request = JSON.stringify({
+  action: "register_agent",
+  agentId,
+  name: agentName,
+  program: "claude-code",
+}) + "\n";
+
+const client = net.createConnection(socketPath, () => {
+  client.write(request);
+  // Read one response then close
+  client.once("data", () => {
+    client.end();
+    process.exit(0);
+  });
+});
+
+// Best-effort — if socket doesn't exist, just continue
+client.on("error", () => {
+  process.exit(0);
+});
+
+// Timeout after 2 seconds
+setTimeout(() => {
+  client.destroy();
+  process.exit(0);
+}, 2000);