agents-relay 1.0.78 → 1.0.80

package/README.md

@@ -108,6 +108,10 @@ Pushes to `main` run `.github/workflows/publish.yml`: install, test, choose the
 
 Normal consumers should invoke the CLI with `npx agents-relay ...` (or `npx agents-relayd ...`).
 
+After a successful npm publish, the workflow records one idempotent `agents-relay:package-published:v1` marker comment on the originating managed PR. The existing GitHub `issue_comment` webhook resolves that PR back to its durable Job and emits a correlated `package.published` events-bus event containing repository, package, version, registry, commit SHA, PR number, and webhook delivery ID. Its source identity is the GitHub delivery (`github/<repository>/delivery/<delivery-id>`), not a worker execution identity.
+
+`package.published` is a release fact, not a service-management command. Agents Relay does not pull packages, restart PM2, or decide which local service consumes a package. An external deployment subscriber may listen for this event, verify that the exact version is pullable, update/restart the affected service, verify its running version and health, and publish its own deployment outcome event. This keeps publication, deployment, and healthy-running as separate facts and removes the need for an orchestrator thread to synchronously wait for npm readiness.
+
 For explicit local demo/test mode:
 
 ~~~sh

package/dist/github-webhook.js

@@ -1,5 +1,32 @@
 import { createHmac, timingSafeEqual } from 'node:crypto';
+export const PACKAGE_PUBLISHED_MARKER = 'agents-relay:package-published:v1';
 const WAKE_EVENTS = new Set(['pull_request', 'issue_comment', 'pull_request_review', 'pull_request_review_comment', 'check_run', 'check_suite', 'workflow_run']);
+function parsePackagePublication(body) {
+    if (typeof body !== 'string')
+        return null;
+    const prefix = '<!-- ' + PACKAGE_PUBLISHED_MARKER + ' ';
+    const start = body.indexOf(prefix);
+    if (start < 0)
+        return null;
+    const end = body.indexOf(' -->', start + prefix.length);
+    if (end < 0)
+        return null;
+    let value;
+    try {
+        value = JSON.parse(body.slice(start + prefix.length, end));
+    }
+    catch {
+        return null;
+    }
+    if (typeof value.package !== 'string' || !value.package || typeof value.version !== 'string' || !value.version)
+        return null;
+    return {
+        package: value.package,
+        version: value.version,
+        registry: typeof value.registry === 'string' ? value.registry : null,
+        sha: typeof value.sha === 'string' ? value.sha : null,
+    };
+}
 export function verifyGitHubWebhook(secret, body, signature) {
     if (!secret || !signature?.startsWith('sha256='))
         return false;
@@ -23,7 +50,16 @@ export function parseGitHubWebhook(headers, body) {
     const pullRequest = payload.pull_request;
     const issue = payload.issue;
     const number = Number(pullRequest?.number ?? (issue?.pull_request ? issue.number : 0));
-    return { deliveryId, event, action: typeof payload.action === 'string' ? payload.action : null, repository: typeof repository?.full_name === 'string' ? repository.full_name : null, pullRequest: Number.isInteger(number) && number > 0 ? number : null };
+    const comment = payload.comment;
+    const publication = event === 'issue_comment' ? parsePackagePublication(comment?.body) : null;
+    return {
+        deliveryId,
+        event,
+        action: typeof payload.action === 'string' ? payload.action : null,
+        repository: typeof repository?.full_name === 'string' ? repository.full_name : null,
+        pullRequest: Number.isInteger(number) && number > 0 ? number : null,
+        publication,
+    };
 }
 export class DeliveryDeduper {
     ttlMs;

package/dist/pool.js

@@ -108,9 +108,21 @@ export class RepositoryWorkerPool {
                 await this.reconcile();
         });
     }
-    async webhookWake(bus, job, deliveryId, event, action) {
+    async webhookWake(bus, job, wake) {
         if (bus) {
-            await bus.publish(eventFor(job.id, 'github', null, 'github.webhook', 'queued', `GitHub webhook ${event}${action ? ':' + action : ''}`, 'orchestrator', { deliveryId, event, action, repository: job.repository, prNumber: job.prNumber }));
+            const source = { id: `github/${job.repository}/delivery/${wake.deliveryId}`, component: 'github-webhook' };
+            if (wake.publication) {
+                await bus.publish(eventFor(job.id, 'release', null, 'package.published', 'succeeded', `Published ${wake.publication.package}@${wake.publication.version}`, 'orchestrator', {
+                    deliveryId: wake.deliveryId,
+                    repository: job.repository,
+                    prNumber: job.prNumber,
+                    package: wake.publication.package,
+                    version: wake.publication.version,
+                    registry: wake.publication.registry,
+                    sha: wake.publication.sha,
+                }, source));
+            }
+            await bus.publish(eventFor(job.id, 'github', null, 'github.webhook', 'queued', `GitHub webhook ${wake.event}${wake.action ? ':' + wake.action : ''}`, 'orchestrator', { deliveryId: wake.deliveryId, event: wake.event, action: wake.action, repository: job.repository, prNumber: job.prNumber }, source));
             return;
         }
         await this.reconcileTarget(job.repository, job.prNumber, job.id);

package/dist/relayd.js

@@ -151,7 +151,7 @@ export async function runDaemon(argv) {
             try {
                 const refreshed = cachedOverviews.filter(item => item.job.repository === event.repository && item.job.prNumber === event.pullRequest);
                 for (const item of refreshed)
-                    await pool.webhookWake(bus, item.job, event.deliveryId, event.event, event.action);
+                    await pool.webhookWake(bus, item.job, event);
             }
             catch (error) {
                 process.stderr.write(`warning: webhook wake unavailable: ${error instanceof Error ? error.message : String(error)}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-relay",
-  "version": "1.0.78",
+  "version": "1.0.80",
   "description": "Durable async agent jobs coordinated through GitHub pull requests",
   "type": "module",
   "bin": {