agent-relay-server 0.104.3 → 0.104.5

package/docs/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Relay API",
-    "version": "0.104.0",
+    "version": "0.104.5",
     "description": "Real-time message bus for inter-agent communication. Agent-first: this spec is designed for machine consumption — agents can self-discover the full API surface via GET /api/spec.",
     "license": {
       "name": "MIT",

package/examples/integrations/github-issue.ts

@@ -1,5 +1,7 @@
 #!/usr/bin/env bun
 
+import { RelayHttpClient } from "agent-relay-sdk";
+
 type GitHubIssuePayload = {
   action?: string;
   issue?: {
@@ -20,6 +22,7 @@ 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 relay = new RelayHttpClient({ baseUrl: relayUrl, token });
 const payload = JSON.parse(await Bun.stdin.text()) as GitHubIssuePayload;
 const issue = payload.issue;
 const repo = payload.repository?.full_name || "unknown/repo";
@@ -30,25 +33,15 @@ if (!issue || !["opened", "reopened", "labeled", "edited"].includes(action)) {
 }
 
 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 },
-  }),
+await relay.raiseAlert({
+  source: `github:${repo}`,
+  type: "issue",
+  severity: labels.includes("P0") || labels.includes("critical") ? "critical" : labels.includes("P1") ? "warning" : "info",
+  dedupeKey: `issue:${issue.number}`,
+  title: `${repo}#${issue.number}: ${issue.title}`,
+  body: issue.body || "(no issue body)",
+  payload: { repo, issueNumber: issue.number, action, labels },
+  target,
+  channel,
+  externalUrl: issue.html_url,
 });
-
-if (!response.ok) {
-  throw new Error(`failed to send GitHub issue ${repo}#${issue.number}: ${response.status} ${await response.text()}`);
-}

package/examples/integrations/prometheus-alertmanager.ts

@@ -1,5 +1,7 @@
 #!/usr/bin/env bun
 
+import { RelayHttpClient } from "agent-relay-sdk";
+
 type Alert = {
   status?: string;
   labels?: Record<string, string>;
@@ -19,6 +21,7 @@ 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 relay = new RelayHttpClient({ baseUrl: relayUrl, token });
 const payload = JSON.parse(await Bun.stdin.text()) as AlertmanagerPayload;
 const alerts = payload.alerts ?? [];
 
@@ -29,29 +32,19 @@ for (const alert of alerts) {
   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 },
-    }),
+  await relay.raiseAlert({
+    source: `alertmanager:${service}`,
+    type: name,
+    severity: alertSeverity(labels.severity),
+    status,
+    dedupeKey: alert.fingerprint ? `alertmanager:${alert.fingerprint}` : undefined,
+    title: `${name} (${service})`,
+    body: annotations.description || annotations.summary || JSON.stringify(labels),
+    payload: { labels, annotations, alertStatus: alert.status },
+    target,
+    channel,
+    externalUrl: alert.generatorURL,
   });
-
-  if (!response.ok) {
-    throw new Error(`failed to send alert ${name}: ${response.status} ${await response.text()}`);
-  }
 }
 
 function alertSeverity(value?: string): "info" | "warning" | "critical" {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-server",
-  "version": "0.104.3",
+  "version": "0.104.5",
   "description": "Lightweight HTTP message relay for inter-agent communication across machines",
   "module": "src/index.ts",
   "type": "module",
@@ -37,7 +37,7 @@
   ],
   "dependencies": {
     "agent-relay-providers": "0.104.0",
-    "agent-relay-sdk": "0.2.88",
+    "agent-relay-sdk": "0.2.90",
     "ajv": "^8.20.0"
   },
   "scripts": {
@@ -101,6 +101,7 @@
   "devDependencies": {
     "@types/bun": "latest",
     "@types/madge": "^5.0.3",
+    "callmux": "0.23.0",
     "madge": "^8.0.0",
     "typescript": "^5"
   },

package/runner/plugins/claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-relay-runner",
   "description": "Thin Agent Relay runner bridge for Claude Code",
-  "version": "0.104.0",
+  "version": "0.104.5",
   "agentRelayContracts": {
     "providerPluginProtocol": 1
   }

package/src/db/integrations.ts

@@ -90,10 +90,11 @@ export function ingestIntegrationEvent(input: IntegrationEventInput, integration
   const targetStatus = input.status === "resolved" ? "done" : input.status;
   const attachmentRefs = input.attachments ?? [];
   validateAttachmentRefs(attachmentRefs);
-  updateIntegrationObserved(source, now);
+  updateIntegrationObserved(integrationName, now);
 
   return getDb().transaction(() => {
     const existing = input.dedupeKey ? findOpenTaskByDedupe(source, input.dedupeKey) : null;
+    const metadata = integrationTaskMetadata(input.metadata, integrationName, existing?.metadata);
     let taskId: number;
     let created = false;
 
@@ -112,7 +113,7 @@ export function ingestIntegrationEvent(input: IntegrationEventInput, integration
         input.target,
         input.channel ?? null,
         input.externalUrl ?? null,
-        JSON.stringify(input.metadata ?? existing.metadata),
+        JSON.stringify(metadata),
         now,
         now,
         targetStatus ?? null,
@@ -136,7 +137,7 @@ export function ingestIntegrationEvent(input: IntegrationEventInput, integration
         input.channel ?? null,
         input.dedupeKey ?? null,
         input.externalUrl ?? null,
-        JSON.stringify(input.metadata ?? {}),
+        JSON.stringify(metadata),
         now,
         now,
         now,
@@ -153,7 +154,7 @@ export function ingestIntegrationEvent(input: IntegrationEventInput, integration
       severity,
       title: input.title,
       body: input.body,
-      metadata: input.metadata ?? {},
+      metadata,
     }, now);
 
     let message: Message | undefined;
@@ -185,11 +186,23 @@ export function ingestIntegrationEvent(input: IntegrationEventInput, integration
   })();
 }
 
+function integrationTaskMetadata(
+  metadata: Record<string, unknown> | undefined,
+  integrationName: string,
+  fallback: Record<string, unknown> | undefined,
+): Record<string, unknown> {
+  return {
+    ...(fallback ?? {}),
+    ...(metadata ?? {}),
+    relayIntegrationName: integrationName,
+  };
+}
+
 
 export function listIntegrationTaskStats(): IntegrationTaskStats[] {
   const rows = getDb().query(`
     SELECT
-      source,
+      coalesce(json_extract(metadata, '$.relayIntegrationName'), source) AS source,
       COUNT(*) AS tasks,
       SUM(CASE WHEN status NOT IN ('done', 'failed', 'canceled') THEN 1 ELSE 0 END) AS open_tasks,
       SUM(CASE WHEN status IN ('open', 'blocked') AND claimed_by IS NULL THEN 1 ELSE 0 END) AS waiting_tasks,
@@ -197,7 +210,7 @@ export function listIntegrationTaskStats(): IntegrationTaskStats[] {
       MAX(last_seen_at) AS last_seen_at,
       MAX(updated_at) AS last_updated_at
     FROM tasks
-    GROUP BY source
+    GROUP BY coalesce(json_extract(metadata, '$.relayIntegrationName'), source)
     ORDER BY last_seen_at DESC, source ASC
   `).all() as any[];
 
@@ -337,4 +350,3 @@ export function isIntegrationRegistryEnabled(name: string): boolean {
   const registry = getIntegrationRegistry(name);
   return registry?.enabled !== false;
 }
-

package/src/routes/integrations.ts

@@ -606,13 +606,13 @@ export const postIntegrationEvent: Handler = async (req) => {
   const parsed = await parseBody<unknown>(req);
   if (!parsed.ok) return error(parsed.error, parsed.status);
   try {
-    const normalized = { ...normalizeIntegrationEvent(parsed.body), source: integrationName };
+    const normalized = normalizeIntegrationEvent(parsed.body);
     const requestedChannelId = channelIdFromIntegrationTarget(normalized.target);
     const integrationScope = auth && !hasIntegrationScope(auth, "events:create") ? "task:write" : "integration:write";
     if (!isRequestAuthorizedFor(req, { scope: integrationScope, resource: { integrationName, target: normalized.target, channel: normalized.channel ?? requestedChannelId } })) {
       return error("integration token cannot target this task", 403);
     }
-    const input = resolveIntegrationEventTarget(normalized);
+    const input = resolveIntegrationEventTarget({ ...normalized, source: normalized.source ?? integrationName });
     const result = ingestIntegrationEvent(input, integrationName);
     if (result.message) emitNewMessage(result.message);
     emitTaskChanged(result.task, result.created ? "task.created" : "task.updated");