agent-relay-server 0.3.11 → 0.4.0

package/examples/integrations/github-issue.ts

@@ -0,0 +1,54 @@
+#!/usr/bin/env bun
+
+type GitHubIssuePayload = {
+  action?: string;
+  issue?: {
+    number: number;
+    title: string;
+    body?: string;
+    html_url?: string;
+    labels?: Array<{ name: string }>;
+  };
+  repository?: {
+    full_name?: string;
+  };
+};
+
+const relayUrl = process.env.AGENT_RELAY_URL || "http://127.0.0.1:4850";
+const token = process.env.AGENT_RELAY_INTEGRATION_TOKEN;
+if (!token) throw new Error("AGENT_RELAY_INTEGRATION_TOKEN is required");
+
+const target = process.env.AGENT_RELAY_TARGET || "cap:triage";
+const channel = process.env.AGENT_RELAY_CHANNEL || "support";
+const payload = JSON.parse(await Bun.stdin.text()) as GitHubIssuePayload;
+const issue = payload.issue;
+const repo = payload.repository?.full_name || "unknown/repo";
+const action = payload.action || "unknown";
+
+if (!issue || !["opened", "reopened", "labeled", "edited"].includes(action)) {
+  process.exit(0);
+}
+
+const labels = issue.labels?.map((label) => label.name) ?? [];
+const response = await fetch(new URL("/api/integrations/events", relayUrl), {
+  method: "POST",
+  headers: {
+    Authorization: `Bearer ${token}`,
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    type: "github-issue",
+    severity: labels.includes("P0") || labels.includes("critical") ? "critical" : labels.includes("P1") ? "warning" : "info",
+    dedupeKey: `github:${repo}:issue:${issue.number}`,
+    title: `${repo}#${issue.number}: ${issue.title}`,
+    body: issue.body || "(no issue body)",
+    target,
+    channel,
+    externalUrl: issue.html_url,
+    metadata: { repo, issueNumber: issue.number, action, labels },
+  }),
+});
+
+if (!response.ok) {
+  throw new Error(`failed to send GitHub issue ${repo}#${issue.number}: ${response.status} ${await response.text()}`);
+}

package/examples/integrations/ops-alert.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+: "${AGENT_RELAY_URL:=http://127.0.0.1:4850}"
+: "${AGENT_RELAY_INTEGRATION_TOKEN:?set an integration token}"
+
+service="${1:-prod-api}"
+severity="${2:-critical}"
+body="${3:-5xx rate is above threshold}"
+
+curl -sS -X POST "${AGENT_RELAY_URL}/api/integrations/events" \
+  -H "Authorization: Bearer ${AGENT_RELAY_INTEGRATION_TOKEN}" \
+  -H "Content-Type: application/json" \
+  -d "$(jq -n \
+    --arg service "$service" \
+    --arg severity "$severity" \
+    --arg body "$body" \
+    '{
+      type: "alarm",
+      severity: $severity,
+      dedupeKey: ("ops:" + $service + ":alarm"),
+      title: ($service + " alarm"),
+      body: $body,
+      target: "cap:ops",
+      channel: "alerts",
+      metadata: { service: $service }
+    }')"

package/examples/integrations/prometheus-alertmanager.ts

@@ -0,0 +1,61 @@
+#!/usr/bin/env bun
+
+type Alert = {
+  status?: string;
+  labels?: Record<string, string>;
+  annotations?: Record<string, string>;
+  fingerprint?: string;
+  generatorURL?: string;
+};
+
+type AlertmanagerPayload = {
+  status?: string;
+  alerts?: Alert[];
+};
+
+const relayUrl = process.env.AGENT_RELAY_URL || "http://127.0.0.1:4850";
+const token = process.env.AGENT_RELAY_INTEGRATION_TOKEN;
+if (!token) throw new Error("AGENT_RELAY_INTEGRATION_TOKEN is required");
+
+const target = process.env.AGENT_RELAY_TARGET || "cap:ops";
+const channel = process.env.AGENT_RELAY_CHANNEL || "alerts";
+const payload = JSON.parse(await Bun.stdin.text()) as AlertmanagerPayload;
+const alerts = payload.alerts ?? [];
+
+for (const alert of alerts) {
+  const labels = alert.labels ?? {};
+  const annotations = alert.annotations ?? {};
+  const name = labels.alertname || "Alertmanager alert";
+  const service = labels.service || labels.job || labels.instance || "unknown";
+  const status = alert.status === "resolved" || payload.status === "resolved" ? "resolved" : undefined;
+
+  const response = await fetch(new URL("/api/integrations/events", relayUrl), {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${token}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      type: "alertmanager",
+      severity: alertSeverity(labels.severity),
+      status,
+      dedupeKey: `alertmanager:${alert.fingerprint || name}:${service}`,
+      title: `${name} (${service})`,
+      body: annotations.description || annotations.summary || JSON.stringify(labels),
+      target,
+      channel,
+      externalUrl: alert.generatorURL,
+      metadata: { labels, annotations, alertStatus: alert.status },
+    }),
+  });
+
+  if (!response.ok) {
+    throw new Error(`failed to send alert ${name}: ${response.status} ${await response.text()}`);
+  }
+}
+
+function alertSeverity(value?: string): "info" | "warning" | "critical" {
+  if (value === "critical" || value === "page") return "critical";
+  if (value === "warning" || value === "warn") return "warning";
+  return "info";
+}

package/examples/integrations/support-ticket.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+: "${AGENT_RELAY_URL:=http://127.0.0.1:4850}"
+: "${AGENT_RELAY_INTEGRATION_TOKEN:?set an integration token}"
+
+ticket_id="${1:?ticket id}"
+title="${2:?title}"
+body="${3:?body}"
+
+curl -sS -X POST "${AGENT_RELAY_URL}/api/integrations/events" \
+  -H "Authorization: Bearer ${AGENT_RELAY_INTEGRATION_TOKEN}" \
+  -H "Content-Type: application/json" \
+  -d "$(jq -n \
+    --arg ticket_id "$ticket_id" \
+    --arg title "$title" \
+    --arg body "$body" \
+    '{
+      type: "ticket",
+      severity: "warning",
+      dedupeKey: ("support:" + $ticket_id),
+      title: $title,
+      body: $body,
+      target: "cap:support",
+      channel: "support",
+      externalUrl: ("https://support.example/tickets/" + $ticket_id),
+      metadata: { ticketId: $ticket_id }
+    }')"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-server",
-  "version": "0.3.11",
+  "version": "0.4.0",
   "description": "Lightweight HTTP message relay for inter-agent communication across machines",
   "module": "src/index.ts",
   "type": "module",
@@ -17,12 +17,15 @@
     "codex/**/*.sh",
     "codex/**/*.ps1",
     "codex/plugin/**",
+    "examples/**",
     "public/**",
     "README.md"
   ],
   "scripts": {
     "start": "bun run src/index.ts",
     "dev": "bun --watch run src/index.ts",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
     "codex:live": "bun run codex/live-sidecar.ts",
     "codex:live:start": "bash codex/start-live.sh",
     "codex:install": "bun run bin/agent-relay-codex.ts install",
@@ -45,9 +48,7 @@
   "license": "MIT",
   "author": "Edin Mujkanovic",
   "devDependencies": {
-    "@types/bun": "latest"
-  },
-  "peerDependencies": {
+    "@types/bun": "latest",
     "typescript": "^5"
   },
   "engines": {