agents-relay 1.0.168 → 1.0.169

package/dist/cli-help.js

@@ -1,4 +1,4 @@
-export const usage = 'agents-relay <job|task|plan|blocker|context|init|record|agent-register|agent-discover|status|reconcile|tick|serve> [options]';
+export const usage = 'agents-relay <job|task|plan|blocker|context|init|record|agent-register|agent-discover|status|reconcile|serve> [options]';
 const help = {
     root: `Agents Relay coordinates durable asynchronous agent jobs through GitHub pull requests.
 
@@ -17,7 +17,6 @@ Commands:
   agent-discover           Find registered agents matching hard filters
   status                   Show live aggregate runtime status from agents-relayd
   reconcile                Run reconciliation once
-  tick                     Run the indexed autonomous scheduler heartbeat
   serve                    Run the dashboard and reconciliation service
 
 Run 'npx agents-relay <command> --help' for command options and examples.
@@ -184,13 +183,6 @@ Managed GitHub jobs are reconciled by agents-relayd. The CLI publishes a job.wak
 
 Example:
   npx agents-relay reconcile --repo OWNER/REPO --pr 12 --id job-1`,
-    tick: `Process autonomous jobs indexed into current/recent GitHub next-run buckets.
-
-Required: --repo OWNER/REPO.
-Common: --lookback-buckets N (default 3).
-
-Example:
-  npx agents-relay tick --repo OWNER/REPO`,
     init: `Initialize a new job. GitHub mode requires --repo and --pr; local mode requires explicit --file.
 
 Common: --id ID, --title TEXT, --objective TEXT, --mode fixed|autonomous, --priority P0|P1|P2|P3.

package/dist/cli.js

@@ -18,7 +18,6 @@ import { decisionMode, LayaCliDecisionEngine } from './decision.js';
 import { discoverAgents } from './registry.js';
 import { AgentObjectivePlanner, CommandObjectivePlanner } from './planner.js';
 import { extendRetryBudget, transitionJobEvent, transitionTaskEvent } from './scheduler.js';
-import { dueBuckets, processDueScheduledJobs, syncScheduleLabels } from './scheduled-jobs.js';
 import { resolveExecutionContext } from './execution-context.js';
 import { defaultWorkspaceRoot, resolveManagedProjectPath, resolveRepositoryProjectPath } from './workspace.js';
 import { runBlockerCommand } from './cli-blocker.js';
@@ -35,8 +34,6 @@ export async function ensureManagedGitHubJob(client, repositoryName, trustedAuth
     const store = new GitHubStore(client, repositoryName, pr.number, trustedAuthors);
     try {
         const existing = await store.load(options.id);
-        if (existing.schedule)
-            await syncScheduleLabels(client, repositoryName, existing);
         return { job: existing, pr };
     }
     catch (error) {
@@ -66,8 +63,6 @@ export async function ensureManagedGitHubJob(client, repositoryName, trustedAuth
     if (options.schedule)
         job.schedule = options.schedule;
     await store.saveJob(job);
-    if (job.schedule)
-        await syncScheduleLabels(client, repositoryName, job);
     return { job: await store.load(options.id), pr };
 }
 async function workerTaskFromArgs(job, args, now) {
@@ -450,8 +445,6 @@ async function runJobCommand(action, args) {
     }
     job.updatedAt = new Date().toISOString();
     await store.saveJob(job);
-    if (hasArg(args, '--schedule') && job.schedule)
-        await syncScheduleLabels(auth.client, repo, job);
     console.log(JSON.stringify(await store.load(id), null, 2));
 }
 export function runtimePlanner(args) { const plannerCommand = arg([...args], '--planner-command'); const modelRuntime = arg([...args], '--codex', 'codex'); return plannerCommand ? new CommandObjectivePlanner(plannerCommand) : new AgentObjectivePlanner(modelRuntime); }
@@ -629,23 +622,6 @@ async function main() {
         console.log(JSON.stringify(await response.json(), null, 2));
         return;
     }
-    if (command === 'tick') {
-        const repo = repository(args);
-        const auth = await githubAuthContext(args);
-        const nowValue = arg(args, '--now');
-        const now = nowValue ? new Date(nowValue) : new Date();
-        if (Number.isNaN(now.getTime()))
-            throw new Error('--now must be a valid ISO timestamp');
-        const results = await processDueScheduledJobs({
-            client: auth.client,
-            repository: repo,
-            trustedAuthors: auth.trustedAuthors,
-            buckets: dueBuckets(now, integerArg(args, '--lookback-buckets', 3)),
-            now,
-        });
-        console.log(JSON.stringify({ repository: repo, processed: results.length, results }, null, 2));
-        return;
-    }
     const loaded = await storeFor(args);
     const { store, job, localFile } = loaded;
     if (command === 'plan') {

package/dist/scheduled-jobs.js

@@ -1,134 +1,5 @@
-import { GitHubStore, loadManagedGitHubPullRequestGraphql } from './store.js';
-import { bucketStart, nextScheduleRun, parseRunBucketLabel, runBucketLabel, scheduleBucket } from './scheduler.js';
-export const AUTONOMOUS_LABEL = 'agents-relay:autonomous';
-function searchPath(query, page) {
-    return `search/issues?q=${encodeURIComponent(query)}&sort=created&order=asc&per_page=100&page=${page}`;
-}
-export function dueBuckets(now, lookbackBuckets) {
-    if (!Number.isInteger(lookbackBuckets) || lookbackBuckets < 1 || lookbackBuckets > 36)
-        throw new Error('--lookback-buckets must be an integer from 1 to 36');
-    const result = [];
-    for (let age = lookbackBuckets - 1; age >= 0; age -= 1) {
-        result.push(scheduleBucket(new Date(bucketStart(now).getTime() - age * 600_000)));
-    }
-    return result;
-}
-export function indexedDueQuery(repository, bucket) {
-    const label = runBucketLabel(bucket);
-    return `repo:${repository} is:open is:pr label:"${AUTONOMOUS_LABEL}" label:"${label}"`;
-}
-async function issueLabels(client, repository, prNumber) {
-    const labels = [];
-    let page = 1;
-    for (;;) {
-        const response = await client.request(`repos/${repository}/issues/${prNumber}/labels?per_page=100&page=${page}`);
-        const items = Array.isArray(response) ? response : response.items;
-        if (!Array.isArray(items))
-            throw new Error(`GitHub label response for PR #${prNumber} was invalid`);
-        for (const item of items) {
-            const name = item.name;
-            if (typeof name === 'string')
-                labels.push(name);
-        }
-        if (items.length < 100)
-            return labels;
-        page += 1;
-    }
-}
-async function addLabel(client, repository, prNumber, label) {
-    await client.request(`repos/${repository}/issues/${prNumber}/labels`, {
-        method: 'POST',
-        body: JSON.stringify({ labels: [label] }),
-    });
-}
-async function removeLabel(client, repository, prNumber, label) {
-    await client.request(`repos/${repository}/issues/${prNumber}/labels/${encodeURIComponent(label)}`, { method: 'DELETE' });
-}
-async function ensureRepositoryLabel(client, repository, label, color) {
-    try {
-        await client.request(`repos/${repository}/labels/${encodeURIComponent(label)}`);
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        if (!/404|Not Found/i.test(message))
-            throw error;
-        await client.request(`repos/${repository}/labels`, {
-            method: 'POST',
-            body: JSON.stringify({ name: label, color }),
-        });
-    }
-}
-export async function syncScheduleLabels(client, repository, job) {
-    const current = await issueLabels(client, repository, job.prNumber);
-    const target = job.schedule ? runBucketLabel(scheduleBucket(new Date(job.schedule.nextRunAt))) : null;
-    const expected = new Set(job.schedule ? [AUTONOMOUS_LABEL, target] : []);
-    if (job.schedule || current.includes(AUTONOMOUS_LABEL))
-        await ensureRepositoryLabel(client, repository, AUTONOMOUS_LABEL, '0E8A16');
-    if (target !== null)
-        await ensureRepositoryLabel(client, repository, target, 'D4C5F9');
-    for (const label of current) {
-        const isSchedulerLabel = label === AUTONOMOUS_LABEL || parseRunBucketLabel(label) !== null || /^agents-relay:next-run:\d{8}T\d{4}Z$/.test(label);
-        if (isSchedulerLabel && !expected.has(label))
-            await removeLabel(client, repository, job.prNumber, label);
-    }
-    if (job.schedule) {
-        if (!current.includes(AUTONOMOUS_LABEL))
-            await addLabel(client, repository, job.prNumber, AUTONOMOUS_LABEL);
-        if (target !== null && !current.includes(target))
-            await addLabel(client, repository, job.prNumber, target);
-    }
-}
-const SCHEDULE_WAKE_MARKER = '<!-- agents-relay:schedule-wake:v1 -->';
-async function pulseScheduleWake(client, repository, job) {
-    const body = `${SCHEDULE_WAKE_MARKER}
-Scheduled autonomous wake for \`${job.id}\` at \`${job.schedule?.lastScheduledSlot ?? 'unknown'}\`.`;
-    let page = 1;
-    for (;;) {
-        const response = await client.request(`repos/${repository}/issues/${job.prNumber}/comments?per_page=100&page=${page}`);
-        const items = Array.isArray(response) ? response : [];
-        const existing = items.find(item => typeof item.body === 'string' && String(item.body).includes(SCHEDULE_WAKE_MARKER));
-        if (existing && Number.isInteger(Number(existing.id))) {
-            await client.request(`repos/${repository}/issues/comments/${Number(existing.id)}`, { method: 'PATCH', body: JSON.stringify({ body }) });
-            return;
-        }
-        if (items.length < 100)
-            break;
-        page += 1;
-    }
-    await client.request(`repos/${repository}/issues/${job.prNumber}/comments`, { method: 'POST', body: JSON.stringify({ body }) });
-}
-export async function listIndexedScheduledJobs(client, repository, trustedAuthors, buckets) {
-    const found = new Map();
-    const seenPrs = new Set();
-    for (const bucket of buckets) {
-        const query = indexedDueQuery(repository, bucket);
-        for (let page = 1; page <= 10; page += 1) {
-            const response = await client.request(searchPath(query, page));
-            const items = Array.isArray(response?.items) ? response.items : [];
-            for (const item of items) {
-                const prNumber = Number(item.number);
-                if (!Number.isInteger(prNumber) || prNumber <= 0 || seenPrs.has(prNumber))
-                    continue;
-                seenPrs.add(prNumber);
-                const overviews = await loadManagedGitHubPullRequestGraphql(client, repository, prNumber, trustedAuthors).catch((error) => {
-                    if (error instanceof Error && error.message.includes('has no durable'))
-                        return [];
-                    throw error;
-                });
-                const job = overviews.find(overview => overview.githubState === 'OPEN' && overview.job.schedule !== undefined)?.job;
-                if (!job?.schedule)
-                    continue;
-                const slotBucket = scheduleBucket(new Date(job.schedule.nextRunAt));
-                if (!buckets.includes(slotBucket))
-                    continue;
-                found.set(`${prNumber}:${job.id}`, { prNumber, jobId: job.id, bucket: slotBucket });
-            }
-            if (items.length < 100)
-                break;
-        }
-    }
-    return [...found.values()];
-}
+import { GitHubStore } from './store.js';
+import { nextScheduleRun, scheduleBucket } from './scheduler.js';
 async function refresh(client, repository, trustedAuthors, ref) {
     const store = new GitHubStore(client, repository, ref.prNumber, trustedAuthors);
     return await store.load(ref.jobId);
@@ -140,11 +11,9 @@ export async function runScheduledBucket(client, repository, trustedAuthors, ref
         throw new Error(`Scheduled job ${job.id} has no schedule metadata`);
     const slot = new Date(schedule.nextRunAt);
     if (scheduleBucket(slot) !== ref.bucket || slot.getTime() > now.getTime()) {
-        await syncScheduleLabels(client, repository, job);
         return { job, status: 'skipped-idempotent' };
     }
     if (schedule.lastScheduledSlot && new Date(schedule.lastScheduledSlot).getTime() >= slot.getTime()) {
-        await syncScheduleLabels(client, repository, job);
         return { job, status: 'skipped-idempotent' };
     }
     if (job.state !== 'ACTIVE')
@@ -155,11 +24,9 @@ export async function runScheduledBucket(client, repository, trustedAuthors, ref
         schedule.nextRunAt = nextScheduleRun(schedule, now).toISOString();
         job.updatedAt = now.toISOString();
         await new GitHubStore(client, repository, ref.prNumber, trustedAuthors).saveJob(job);
-        await syncScheduleLabels(client, repository, job);
         return { job, status: 'skipped-active' };
     }
     if (active && schedule.concurrencyPolicy === 'queue') {
-        await syncScheduleLabels(client, repository, job);
         return { job, status: 'skipped-active' };
     }
     const missedRunPolicy = schedule.missedRunPolicy;
@@ -170,27 +37,15 @@ export async function runScheduledBucket(client, repository, trustedAuthors, ref
     const schedulerStore = new GitHubStore(client, repository, ref.prNumber, trustedAuthors);
     await schedulerStore.saveJob(job);
     job = await schedulerStore.load(job.id);
-    await syncScheduleLabels(client, repository, job);
-    if (engine) {
-        await engine.reconcile(job.id);
-        await engine.idle();
-        const finished = await schedulerStore.load(job.id);
-        if (!finished.schedule)
-            throw new Error(`Scheduled job ${job.id} lost its schedule metadata`);
-        finished.schedule.lastRunAt = now.toISOString();
-        finished.updatedAt = now.toISOString();
-        await schedulerStore.saveJob(finished);
-        return { job: finished, status: 'completed' };
-    }
-    await pulseScheduleWake(client, repository, job);
-    return { job, status: 'dispatched' };
-}
-export async function processDueScheduledJobs(options) {
-    const due = await listIndexedScheduledJobs(options.client, options.repository, options.trustedAuthors, options.buckets);
-    const results = [];
-    for (const ref of due) {
-        const engine = options.engine ? options.engine(await refresh(options.client, options.repository, options.trustedAuthors, ref)) : undefined;
-        results.push(await runScheduledBucket(options.client, options.repository, options.trustedAuthors, ref, engine, options.now));
-    }
-    return results;
+    if (!engine)
+        throw new Error('Scheduled jobs require the local relayd scheduler engine');
+    await engine.reconcile(job.id);
+    await engine.idle();
+    const finished = await schedulerStore.load(job.id);
+    if (!finished.schedule)
+        throw new Error(`Scheduled job ${job.id} lost its schedule metadata`);
+    finished.schedule.lastRunAt = now.toISOString();
+    finished.updatedAt = now.toISOString();
+    await schedulerStore.saveJob(finished);
+    return { job: finished, status: 'completed' };
 }

package/dist/scheduler.js

@@ -62,7 +62,6 @@ export async function transitionJobEvent(job, event, context = {}) {
     return decision;
 }
 export const SCHEDULE_RESOLUTION_MS = 600_000;
-export const RUN_BUCKET_LABEL_COUNT = 144;
 const CRON_PART = /^(?:\*|(\d+)(?:-(\d+))?)(?:\/(\d+))?$/;
 function cronField(raw, name, minimum, maximum) {
     const values = new Set();
@@ -189,21 +188,3 @@ export function scheduleBucket(time) {
     const bucket = bucketStart(time);
     return `${bucket.toISOString().slice(0, 4)}${bucket.toISOString().slice(5, 7)}${bucket.toISOString().slice(8, 10)}T${bucket.toISOString().slice(11, 13)}${bucket.toISOString().slice(14, 16)}Z`;
 }
-export function runBucketLabel(bucket) {
-    if (!/^\d{8}T\d{4}Z$/.test(bucket))
-        throw new Error(`Invalid schedule bucket: ${bucket}`);
-    const hour = Number(bucket.slice(9, 11));
-    const minute = Number(bucket.slice(11, 13));
-    const slot = hour * 6 + minute / 10;
-    return `agents-relay:next-run:${slot}`;
-}
-export function parseRunBucketLabel(label) {
-    const prefix = 'agents-relay:next-run:';
-    if (!label.startsWith(prefix))
-        return null;
-    const value = label.slice(prefix.length);
-    if (!/^\d{1,3}$/.test(value))
-        return null;
-    const slot = Number(value);
-    return Number.isInteger(slot) && slot >= 0 && slot < RUN_BUCKET_LABEL_COUNT ? value : null;
-}

package/package.json

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

package/skills/agents-relay/contracts/task-job-contract.md

@@ -109,9 +109,9 @@ SHA-bound final reviewer. For example, `video-director + market + style ->
 review-chair -> unified revision plan` is a project pattern, not a hard-coded
 Relay reviewer list.
 
-A scheduled autonomous job adds cron/timezone/next-run and missed-run/concurrency policy to the trusted job marker, plus the `agents-relay:autonomous` label and one bounded time-of-day `agents-relay:next-run:*` index label. The always-on `agents-relayd` process is the authoritative heartbeat for repositories it manages: it evaluates due schedule buckets on startup and every ten minutes and reconciles claimed work through the local worker pool. A repository may also install `.github/workflows/autonomous-scheduler.yml` as an optional cloud fallback; GitHub `schedule` delivery is best-effort and must not be relied on for precise cadence. Unscheduled autonomous Jobs and fixed Jobs do not use the scheduler heartbeat.
+A scheduled autonomous job adds cron/timezone/next-run and missed-run/concurrency policy to the trusted job marker. The always-on `agents-relayd` process is the sole heartbeat for repositories it manages: on startup and every ten minutes it evaluates cached managed Jobs and reconciles due work through the local worker pool. There is no GitHub Actions scheduler fallback. Unscheduled autonomous Jobs and fixed Jobs do not use the scheduler heartbeat.
 
-The scheduler heartbeat discovers only indexed due candidates, validates the marker's exact `nextRunAt`, claims the slot idempotently, advances the durable next run, and pulses `agents-relay:schedule-wake`. GitHub webhook delivery then wakes local Relay for planner/worker execution. While the schedule is active, the durable Job remains `ACTIVE`; between runs its derived runtime status is `WAITING`. Scheduled recurring Jobs do not enter one-shot final-review/auto-merge after each satisfied run; older-cycle failures are historical evidence and do not block a later slot.
+The scheduler heartbeat filters cached managed Jobs, reloads each due Job to validate the marker's exact `nextRunAt`, claims the slot idempotently, advances the durable next run, and reconciles planner/worker execution locally. While the schedule is active, the durable Job remains `ACTIVE`; between runs its derived runtime status is `WAITING`. Scheduled recurring Jobs do not enter one-shot final-review/auto-merge after each satisfied run; older-cycle failures are historical evidence and do not block a later slot.
 
 
 ## Task evidence and head identity