agents-relay 2.0.163 → 2.0.164

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-relay",
-  "version": "2.0.163",
+  "version": "2.0.164",
   "description": "Durable async agent jobs coordinated through GitHub pull requests",
   "repository": {
     "type": "git",

package/skills/agents-relay/SKILL.md

@@ -1,6 +1,9 @@
 ---
 name: agents-relay
 description: Use when work needs durable, multi-agent orchestration across turns or processes: plan and execute Jobs/Tasks, coordinate dependencies and reviews, recover failures, and track authoritative lifecycle events. Also use for content-generation workflows (research, story, production, human review, publication) that need explicit agent roles and handoff boundaries. Not for simple one-shot tasks with no durable coordination.
+requires:
+  skills:
+    - daemon-service-manage
 ---
 
 # Agents Relay
@@ -124,3 +127,7 @@ Keep secrets, credentials, private prompts, and large private payloads out of du
 When an ACTIVE Job contains a current-run `FAILED` task, reconciliation may create one P0-priority `troubleshooter` recovery task for that exact failed attempt. `BLOCKED` is resolved only through authoritative unblock, which records evidence and transitions the Task to `UNBLOCKED`. The recovery task is routed to a local Codex-capable worker with repository/tool access and runs under the bundled Troubleshooter agent contract. Autonomous `UNBLOCKED` Tasks are historical and feed the next Planner round instead of being retried or sent through Troubleshooter. Each Planner round is durably represented by an `agents-relay:plan:v1` PR comment created before generated Task comments and updated in place with its assessment and generated Task IDs. Troubleshooter diagnosis is event-first: it must inspect the failed task's task-scoped lifecycle event history (including ordering, duplicate/missing/late events, source and phase data) before classifying root cause or retrying.
 
 The Troubleshooter diagnoses before retrying. A task-local or transient blocker is repaired narrowly; a shared worker/runtime/tool defect is repaired through the owning repository's P0/self-job workflow. Only after the blocker is removed does it retry the original task and verify durable progress. Historical failures from older scheduled autonomous runs do not spawn recovery work, and deterministic reconciliation does not duplicate a Troubleshooter task for the same failed attempt.
+
+## Persistent service bootstrap
+
+This Skill owns `agents-relay/daemon`, `agents-relay/dashboard-tunnel`. The `daemon-service-manage` Skill is required. Run `node skills/agents-relay/bin/services.mjs setup` for idempotent registration through `serviceman`; run `status` to inspect or `doctor` to fail if a service is not online. Existing process configuration is preserved. Do not create unqualified legacy PM2 names.

package/skills/agents-relay/bin/services.mjs

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import {spawnSync} from 'node:child_process';
+const skill="agents-relay";
+const definitions=[["daemon", "npx", ["-y", "--package", "agents-relay@latest", "agents-relayd", "--workspace", "__HOME__/Workspace", "--port", "8787", "--concurrency", "4", "--interval", "300000", "--refresh-ms", "300000", "--github-webhook-secret-file", "__HOME__/.agents-relay/github-webhook-secret"]], ["dashboard-tunnel", "cloudflared", ["tunnel", "--protocol", "http2", "--no-autoupdate", "run", "--url", "http://127.0.0.1:8787", "agents-relay-dashboard"]]];
+const home=process.env.HOME||'';
+const expand=s=>s.replaceAll('__HOME__',home);
+const action=process.argv[2]||'status';
+if(!['setup','status','doctor'].includes(action)){console.error('usage: node skills/'+skill+'/bin/services.mjs setup|status|doctor');process.exit(2)}
+const run=(cmd,args)=>{const p=spawnSync(cmd,args,{encoding:'utf8'});if(p.error)throw p.error;if(p.status!==0)throw new Error(cmd+' failed: '+String(p.stderr||p.stdout).slice(0,300));return p.stdout};
+try {
+ const pm2=JSON.parse(run('npx',['--yes','pm2','jlist']));
+ const report=[];
+ for(const [service,binary,args] of definitions){
+   const id=skill+'/'+service;
+   const current=pm2.find(x=>x.name===id);
+   if(action==='setup'&&!current){
+      if(skill==='family-tutor')throw new Error('family-tutor/orchestrator missing: provision product runtime before setup; serviceman must not infer its working directory');
+      const result=spawnSync('serviceman',['define','--skill',skill,'--service',service,'--apply','--',binary,...args.map(expand)],{stdio:'inherit'});
+      if(result.error)throw result.error;
+      if(result.status!==0)throw new Error('failed to define '+id);
+   }
+   const live=action==='setup'?JSON.parse(run('npx',['--yes','pm2','jlist'])).find(x=>x.name===id):current;
+   report.push({service:id,state:live?.pm2_env?.status||'missing',registered:Boolean(live)});
+ }
+ console.log(JSON.stringify({skill,services:report},null,2));
+ if(report.some(x=>x.state!=='online'))process.exitCode=2;
+} catch(e){console.error(e.message);process.exitCode=2}