agent-relay-server 0.101.0 → 0.101.1

package/docs/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Relay API",
-    "version": "0.101.0",
+    "version": "0.101.1",
     "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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-server",
-  "version": "0.101.0",
+  "version": "0.101.1",
   "description": "Lightweight HTTP message relay for inter-agent communication across machines",
   "module": "src/index.ts",
   "type": "module",
@@ -34,7 +34,7 @@
     "CONTRIBUTING.md"
   ],
   "dependencies": {
-    "agent-relay-sdk": "0.2.82",
+    "agent-relay-sdk": "0.2.83",
     "ajv": "^8.20.0"
   },
   "scripts": {

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.101.0",
+  "version": "0.101.1",
   "agentRelayContracts": {
     "providerPluginProtocol": 1
   }

package/src/quota-band-transition.ts

@@ -20,7 +20,7 @@
 import { emitRelayEvent } from "./events";
 import { routeNotification } from "./notification-router";
 import { getSpawnCapableAgentIds } from "./routing-policy-push";
-import { getProviderBandInfo } from "./spawn-targets";
+import { getProviderBandInfo, windowRecommendedAction } from "./spawn-targets";
 import type { ProviderBandInfo, ProviderBandWindow, QuotaBand } from "./spawn-targets";
 import type { ProviderQuotaAdvisoryInput } from "./db/provider-quotas";
 
@@ -112,7 +112,10 @@ export function processBandTransitions(input: ProviderQuotaAdvisoryInput): void
         provider: input.provider,
         window,
         previousBand,
-        recommendedAction: info.recommendedAction,
+        // #761 — use the window's own band for the action text, not the provider-level band.
+        // e.g. a 5h→prefer transition on a provider whose 7d is at avoid-large must say
+        // "Prefer…", not "Avoid large jobs…".
+        recommendedAction: windowRecommendedAction(effectiveBand, window.slack),
         now: input.now,
       });
     } else {

package/src/routes/_shared.ts

@@ -362,6 +362,21 @@ export function auditEvent(input: ActivityEventInput): void {
   }
 }
 
+/**
+ * Derive a human-readable actor label from the request's auth context, for use as
+ * `updatedBy` in config writes. Prefixes distinguish the auth type so notifications
+ * show "by dashboard:alice" rather than an opaque id.
+ */
+export function resolveActorLabel(req: Request): string | undefined {
+  const acting = resolveActingUser(req);
+  if (acting) return `dashboard:${acting.userId}`;
+  const component = getComponentAuth(req);
+  if (component) return `agent:${component.sub}`;
+  const integration = getIntegrationAuth(req);
+  if (integration) return `integration:${integration.name}`;
+  return undefined;
+}
+
 export function memoryContext(req: Request): MemoryBrokerContext {
   const component = getComponentAuth(req);
   if (component) {

package/src/routes/routing-policy.ts

@@ -2,7 +2,7 @@
 // GET: agent:read (coordinators read the policy to apply rules).
 // PUT: settings:write:routing (admin writes).
 import { ValidationError } from "../db";
-import { error, json, parseBody, type Handler } from "./_shared";
+import { error, json, parseBody, resolveActorLabel, type Handler } from "./_shared";
 import { getRoutingPolicy, setRoutingPolicy } from "../routing-policy-store";
 import { isRecord } from "agent-relay-sdk";
 import { cleanString } from "../validation";
@@ -15,7 +15,8 @@ export const putRoutingPolicyRoute: Handler = async (req) => {
   const parsed = await parseBody<unknown>(req);
   if (!parsed.ok) return error(parsed.error, parsed.status);
   try {
-    const updatedBy = isRecord(parsed.body) ? cleanString(parsed.body.updatedBy, "updatedBy", { max: 200 }) : undefined;
+    const bodyUpdatedBy = isRecord(parsed.body) ? cleanString(parsed.body.updatedBy, "updatedBy", { max: 200 }) : undefined;
+    const updatedBy = bodyUpdatedBy ?? resolveActorLabel(req);
     const policy = setRoutingPolicy(parsed.body, { updatedBy });
     return json(policy);
   } catch (e) {

package/src/routing-policy-store.ts

@@ -31,9 +31,17 @@ export function getRoutingPolicy(): RoutingPolicy {
  * Persist the routing policy. The incoming value is normalized so partial bodies
  * still produce a valid document. Emits `config.changed` via `setConfig` so the
  * dashboard + any live listeners pick it up immediately.
+ *
+ * No-op detection: if the normalized incoming policy is deep-equal to the current
+ * persisted one, the write and the fleet notification are both skipped so identical
+ * saves are fully silent.
  */
 export function setRoutingPolicy(value: unknown, opts: { updatedBy?: string } = {}): RoutingPolicy {
   const normalized = normalizeRoutingPolicy(value);
+  const current = getRoutingPolicy();
+  if (JSON.stringify(normalized) === JSON.stringify(current)) {
+    return normalized;
+  }
   setConfig(ROUTING_POLICY_NAMESPACE, ROUTING_POLICY_KEY, normalized, opts.updatedBy);
   notifyRoutingPolicyChanged(normalized, opts);
   return normalized;

package/src/spawn-targets.ts

@@ -356,12 +356,20 @@ function recommendedAction(input: { quotaPenaltyBand: SpawnQuotaBurnBand; blocke
       ? "Quota is blocked now; switch provider or escalate unless this provider was explicitly requested."
       : "5h quota is blocked now; wait for reset or use another provider unless the job is urgent.";
   }
-  if (input.quotaPenaltyBand === "hard-avoid") return "Hard avoid unless explicitly requested or no healthier alternate exists.";
-  if (input.quotaPenaltyBand === "avoid-large") return "Avoid large jobs if a healthier alternate exists.";
-  if (input.quotaPenaltyBand === "caution") return "Caution: prefer cheaper effort/model when practical.";
+  return windowRecommendedAction(input.quotaPenaltyBand, input.slack);
+}
+
+/**
+ * Per-window recommended action text for a given band — used by band-transition notifications
+ * so each window's notification reflects ITS own band, not the provider-level band.
+ */
+export function windowRecommendedAction(band: QuotaBand, slack: number | null): string {
+  if (band === "hard-avoid") return "Hard avoid unless explicitly requested or no healthier alternate exists.";
+  if (band === "avoid-large") return "Avoid large jobs if a healthier alternate exists.";
+  if (band === "caution") return "Caution: prefer cheaper effort/model when practical.";
   // #760 — surface the underburn signal so coordinators load-shift big/deferrable jobs here.
-  if (input.quotaPenaltyBand === "prefer") {
-    const headroom = input.slack !== null ? ` (~${Math.round(input.slack * 100)}% quota would otherwise go unused at reset)` : "";
+  if (band === "prefer") {
+    const headroom = slack !== null ? ` (~${Math.round(slack * 100)}% quota would otherwise go unused at reset)` : "";
     return `Prefer for large or deferrable jobs${headroom}.`;
   }
   return "Spawn normally.";