agent-relay-server 0.106.0 → 0.108.0

package/src/task-dispatcher.ts

@@ -0,0 +1,461 @@
+// #839 — the declarative task dispatcher.
+//
+// A pure function from (Task work-shape + live system state) → a concrete spawn
+// (provider / model / effort) plus a human-readable rationale. The work-shape is the
+// small, stable taxonomy a coordinator declares on the Task's `dispatch` field
+// ({complexity, type, contextFootprint, criticality}); the routing heuristics that map
+// it onto an agent live as INSPECTABLE, EDITABLE policy (RoutingPolicy.dispatch, with a
+// built-in default) — never hardcoded here, never tribal coordinator knowledge.
+//
+// Guarantees this module is built to keep (the #839 GUARD):
+//   1. Every decision reports WHY (rationale string + structured factors).
+//   2. Every decision is overridable by an explicit model/provider pin.
+//   3. The function is PURE — no DB writes, no spawning. The MCP entrypoint
+//      (mcp-dispatch-tools.ts) consumes the decision; #838 (spawn-with-task) will
+//      hydrate + actually spawn. Auto-review surfaces as a PLAN the caller may enact.
+import type {
+  DispatchAutoReview,
+  DispatchMatch,
+  DispatchModelTarget,
+  DispatchPolicy,
+  DispatchRule,
+  SpawnProvider,
+  TaskDispatch,
+} from "agent-relay-sdk";
+import type { ProviderCatalogEntry, ProviderModelCatalogEntry } from "agent-relay-sdk/provider-catalog";
+import { effectiveProviderCatalogList } from "./provider-catalog-store";
+import { getDispatchPolicy } from "./routing-policy-store";
+import { providerQuotaBands, type ProviderQuotaBand, type QuotaBand } from "./spawn-targets";
+
+/** An explicit per-case override. Any field set wins over the policy-derived target. */
+export interface DispatchPin {
+  provider?: SpawnProvider;
+  model?: string;
+  effort?: string;
+}
+
+/**
+ * Live-state inputs. All optional + injectable so the dispatcher is unit-testable without a
+ * running fleet; each defaults to the real source (policy store / quota bands / catalog).
+ */
+export interface DispatchContext {
+  policy?: DispatchPolicy;
+  bands?: ProviderQuotaBand[];
+  catalog?: ProviderCatalogEntry[];
+}
+
+export interface DispatchTarget {
+  provider: SpawnProvider;
+  model?: string;
+  effort?: string;
+}
+
+/** Structured trace of the inputs that produced the decision (the machine-readable rationale). */
+export interface DispatchFactors {
+  complexity?: string;
+  type?: string;
+  contextFootprint?: string;
+  criticality?: string;
+  /** Label of the matched rule, or a "fallback"/"pin" marker. */
+  matchedRule: string;
+  /** The final provider's live quota band. */
+  band: QuotaBand;
+  /** Context window of the chosen model, when known. */
+  contextWindowTokens?: number;
+  /** Model was escalated to a bigger-window family member for a large footprint. */
+  escalatedForFootprint?: boolean;
+  /** Provider was rerouted away from a scarce/blocked pool; original provider recorded here. */
+  reroutedFromProvider?: SpawnProvider;
+  /** Which target fields were set by an explicit pin. */
+  pinnedFields?: string[];
+}
+
+/** A dependent review Task the caller may create (high criticality / complex work). */
+export interface ReviewPlan {
+  /** Work-shape for the review Task. */
+  dispatch: TaskDispatch;
+  target: DispatchTarget;
+  rationale: string;
+  /** Why the review was triggered (e.g. "criticality=high"). */
+  reason: string;
+}
+
+export interface DispatchDecision {
+  target: DispatchTarget;
+  /** True when any target field came from an explicit pin. */
+  pinned: boolean;
+  /** Human-readable explanation, e.g. `opus-4.8 high: type=build, complexity=complex; claude band=normal`. */
+  rationale: string;
+  factors: DispatchFactors;
+  /** Non-fatal advisories (e.g. scarce pool, no model meets the footprint). */
+  warnings: string[];
+  /** Present when the policy's auto-review threshold is met. */
+  review?: ReviewPlan;
+}
+
+// ---------------------------------------------------------------------------
+// Public entrypoint
+// ---------------------------------------------------------------------------
+
+/**
+ * Map a work-shape + live state onto a concrete spawn. `pin` overrides any field per-case;
+ * the rationale always explains the choice (including why a pin or reroute happened).
+ */
+export function dispatchTask(shape: TaskDispatch | undefined, pin: DispatchPin = {}, ctx: DispatchContext = {}): DispatchDecision {
+  const policy = ctx.policy ?? getDispatchPolicy();
+  const catalog = ctx.catalog ?? effectiveProviderCatalogList();
+  const bands = ctx.bands ?? providerQuotaBands();
+  const work: TaskDispatch = shape ?? {};
+  const warnings: string[] = [];
+
+  const matched = resolvePolicyTarget(work, policy);
+  let target: DispatchTarget = { ...matched.target };
+  const factors: DispatchFactors = {
+    ...(work.complexity ? { complexity: work.complexity } : {}),
+    ...(work.type ? { type: work.type } : {}),
+    ...(work.contextFootprint ? { contextFootprint: work.contextFootprint } : {}),
+    ...(work.criticality ? { criticality: work.criticality } : {}),
+    matchedRule: matched.label,
+    band: "normal",
+  };
+
+  const pinnedFields = applyPin(target, pin);
+  const providerPinned = pinnedFields.includes("provider");
+  const modelPinned = pinnedFields.includes("model");
+  const effortPinned = pinnedFields.includes("effort");
+  if (pinnedFields.length) factors.pinnedFields = pinnedFields;
+
+  // Footprint escalation (skip when the model is explicitly pinned — respect the human choice).
+  if (!modelPinned) escalateForFootprint(target, work, policy, catalog, factors, warnings);
+
+  // Band-aware rerouting (skip when the provider is explicitly pinned). Protects scarce pools
+  // and load-shifts large/blocked work onto an abundant one. Re-validates footprint + a pinned
+  // effort on the rerouted provider so neither is silently dropped.
+  if (!providerPinned) rerouteForBand(target, work, policy, bands, catalog, factors, warnings, { effortPinned });
+
+  // Record the FINAL provider's band + the chosen model's window for transparency.
+  factors.band = bandFor(target.provider, bands);
+  const finalWindow = contextWindowOf(catalog, target.provider, target.model);
+  if (finalWindow !== undefined) factors.contextWindowTokens = finalWindow;
+  collectBandWarnings(target.provider, work, bands, providerPinned, warnings);
+
+  const review = planAutoReview(work, policy, bands, catalog);
+
+  return {
+    target,
+    pinned: pinnedFields.length > 0,
+    rationale: buildRationale(target, factors, warnings),
+    factors,
+    warnings,
+    ...(review ? { review } : {}),
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Policy rule matching
+// ---------------------------------------------------------------------------
+
+function resolvePolicyTarget(work: TaskDispatch, policy: DispatchPolicy): { target: DispatchModelTarget; label: string } {
+  for (const rule of policy.rules) {
+    if (rule.enabled === false) continue;
+    if (matchesShape(rule.match, work)) {
+      return { target: rule.target, label: rule.label ?? "rule" };
+    }
+  }
+  return { target: policy.fallback, label: "fallback (no rule matched)" };
+}
+
+function matchesShape(match: DispatchMatch, work: TaskDispatch): boolean {
+  return (
+    dimensionMatches(match.complexity, work.complexity) &&
+    dimensionMatches(match.type, work.type) &&
+    dimensionMatches(match.contextFootprint, work.contextFootprint) &&
+    dimensionMatches(match.criticality, work.criticality)
+  );
+}
+
+// An unset criterion is a wildcard. A set criterion needs a present work value that is one of
+// the (possibly array) allowed values.
+function dimensionMatches(criterion: string | string[] | undefined, value: string | undefined): boolean {
+  if (criterion === undefined) return true;
+  if (value === undefined) return false;
+  const allowed = Array.isArray(criterion) ? criterion : [criterion];
+  return allowed.includes(value);
+}
+
+// ---------------------------------------------------------------------------
+// Pin application
+// ---------------------------------------------------------------------------
+
+function applyPin(target: DispatchTarget, pin: DispatchPin): string[] {
+  const fields: string[] = [];
+  if (pin.provider) {
+    // A provider change invalidates a provider-specific policy model/effort unless the pin
+    // also restates them; clear them so we fall back to that provider's defaults.
+    if (pin.provider !== target.provider) {
+      if (!pin.model) target.model = undefined;
+      if (!pin.effort) target.effort = undefined;
+    }
+    target.provider = pin.provider;
+    fields.push("provider");
+  }
+  if (pin.model) {
+    target.model = pin.model;
+    fields.push("model");
+  }
+  if (pin.effort) {
+    target.effort = pin.effort;
+    fields.push("effort");
+  }
+  return fields;
+}
+
+// ---------------------------------------------------------------------------
+// Footprint → context-window escalation
+// ---------------------------------------------------------------------------
+
+function escalateForFootprint(
+  target: DispatchTarget,
+  work: TaskDispatch,
+  policy: DispatchPolicy,
+  catalog: ProviderCatalogEntry[],
+  factors: DispatchFactors,
+  warnings: string[],
+): void {
+  const footprint = work.contextFootprint;
+  if (!footprint) return;
+  const minTokens = policy.footprintMinContextTokens?.[footprint];
+  if (!minTokens) return;
+  const entry = catalogEntry(catalog, target.provider);
+  if (!entry) return;
+  const alias = target.model ?? entry.defaultModel;
+  const current = alias ? contextWindowFromEntry(entry, alias) : undefined;
+  if (current !== undefined && current >= minTokens) return; // already big enough
+
+  // Prefer widening the SAME model family (opus-4.8 → opus-4.8[1m]); fall back to any other
+  // sufficient model on this provider before giving up (e.g. after a reroute reset us to a small
+  // default). Smallest sufficient window wins so we don't over-allocate.
+  const pick = biggestSufficient(entry, minTokens, alias);
+  if (pick && pick.alias !== alias) {
+    target.model = pick.alias;
+    factors.escalatedForFootprint = true;
+    return;
+  }
+  if (!pick && current === undefined) return; // unknown window AND no sufficient alternative — can't assert a gap
+  // Nothing on this provider satisfies the footprint — surface it rather than silently downgrade.
+  warnings.push(
+    `contextFootprint=${footprint} wants ≥${minTokens} tokens but ${target.provider}/${alias ?? "default"} offers ${current ?? "unknown"}; no model on ${target.provider} meets it — review the pick.`,
+  );
+}
+
+// The smallest-window model on this provider whose window meets the requirement. Prefers the
+// same model family as `alias` (e.g. opus-4.8 → opus-4.8[1m]) when one qualifies, else any family.
+function biggestSufficient(
+  entry: ProviderCatalogEntry,
+  minTokens: number,
+  alias: string | undefined,
+): ProviderModelCatalogEntry | undefined {
+  const sufficient = entry.models
+    .filter((m) => !m.disabled && !m.unavailable)
+    .map((m) => ({ model: m, window: m.limits?.contextWindowTokens?.value }))
+    .filter((c): c is { model: ProviderModelCatalogEntry; window: number } => typeof c.window === "number" && c.window >= minTokens)
+    .sort((a, b) => a.window - b.window);
+  const base = alias ? familyBase(alias) : undefined;
+  const sameFamily = base ? sufficient.find((c) => familyBase(c.model.alias) === base) : undefined;
+  return (sameFamily ?? sufficient[0])?.model;
+}
+
+function familyBase(alias: string): string {
+  return alias.trim().toLowerCase().replace(/\[[^\]]+\]$/, "");
+}
+
+// ---------------------------------------------------------------------------
+// Quota-band aware rerouting
+// ---------------------------------------------------------------------------
+
+function rerouteForBand(
+  target: DispatchTarget,
+  work: TaskDispatch,
+  policy: DispatchPolicy,
+  bands: ProviderQuotaBand[],
+  catalog: ProviderCatalogEntry[],
+  factors: DispatchFactors,
+  warnings: string[],
+  opts: { effortPinned: boolean },
+): void {
+  const band = bandFor(target.provider, bands);
+  const blocked = isBlocked(target.provider, bands);
+  const isLarge = work.contextFootprint === "large";
+  // Reroute when the pool is at capacity / hard-avoid, or a large job lands on an avoid-large pool.
+  const mustMove = blocked || band === "hard-avoid" || (isLarge && band === "avoid-large");
+  if (!mustMove) return;
+
+  const alt = healthiestAlternative(target.provider, bands, catalog);
+  if (!alt) {
+    warnings.push(`${target.provider} band=${band}${blocked ? " (at capacity)" : ""} and no healthier provider is available — keeping it; expect contention.`);
+    return;
+  }
+  const altEntry = catalogEntry(catalog, alt.provider)!;
+  factors.reroutedFromProvider = target.provider;
+  warnings.push(`Rerouted ${target.provider} (band=${band}${blocked ? ", at capacity" : ""}) → ${alt.provider} (band=${alt.band}) to ${alt.band === "prefer" ? "use abundant quota" : "avoid the scarce pool"}.`);
+  const prevEffort = target.effort;
+  target.provider = alt.provider;
+  // Provider changed → model is provider-specific; reset to the new provider's default, then
+  // RE-VALIDATE the footprint on the new provider (it may widen to a 1M model, or warn if it
+  // cannot meet the footprint) so a large job is never silently downgraded onto a small window.
+  target.model = altEntry.defaultModel;
+  // Re-derive escalation against the NEW provider — the prior provider's escalation flag is stale.
+  delete factors.escalatedForFootprint;
+  escalateForFootprint(target, work, policy, catalog, factors, warnings);
+  // Effort: a pinned effort is authoritative and survives the reroute (warn if the rerouted model
+  // doesn't list it, rather than silently dropping it). An unpinned effort is kept only if supported.
+  if (opts.effortPinned) {
+    target.effort = prevEffort;
+    if (prevEffort && effortIfSupported(altEntry, target.model, prevEffort) === undefined) {
+      warnings.push(`Pinned effort '${prevEffort}' isn't listed for ${alt.provider}/${target.model ?? "default"}; honoring the pin anyway.`);
+    }
+  } else {
+    target.effort = effortIfSupported(altEntry, target.model, prevEffort);
+  }
+}
+
+// Best healthy provider other than `avoid`, considering EVERY spawnable provider in the live
+// catalog — not only those with a quota advisory. A provider with no quota record defaults to the
+// "normal" band (via bandFor), so a healthy catalog provider is never skipped just because it has
+// no burn data yet. Prefer "prefer" band, then "normal"; never a blocked one.
+function healthiestAlternative(
+  avoid: SpawnProvider,
+  bands: ProviderQuotaBand[],
+  catalog: ProviderCatalogEntry[],
+): { provider: SpawnProvider; band: QuotaBand } | undefined {
+  const ranked = catalog
+    .map((c) => c.provider)
+    .filter((provider) => provider !== avoid)
+    .map((provider) => ({ provider, band: bandFor(provider, bands), blockedNow: isBlocked(provider, bands) }))
+    .filter((c) => !c.blockedNow && (c.band === "prefer" || c.band === "normal"))
+    .sort((a, b) => bandRank(a.band) - bandRank(b.band));
+  return ranked[0];
+}
+
+function collectBandWarnings(provider: SpawnProvider, work: TaskDispatch, bands: ProviderQuotaBand[], providerPinned: boolean, warnings: string[]): void {
+  if (!providerPinned) return; // non-pinned scarce pools were already handled by reroute
+  const band = bandFor(provider, bands);
+  if (band === "hard-avoid" || isBlocked(provider, bands)) {
+    warnings.push(`Pinned provider ${provider} is band=${band}${isBlocked(provider, bands) ? " (at capacity)" : ""}; honoring the pin but it may be slow or blocked.`);
+  } else if (band === "avoid-large" && work.contextFootprint === "large") {
+    warnings.push(`Pinned provider ${provider} is band=avoid-large for a large job; honoring the pin.`);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Auto-review planning
+// ---------------------------------------------------------------------------
+
+function planAutoReview(
+  work: TaskDispatch,
+  policy: DispatchPolicy,
+  bands: ProviderQuotaBand[],
+  catalog: ProviderCatalogEntry[],
+): ReviewPlan | undefined {
+  const cfg = policy.autoReview;
+  if (!cfg) return undefined;
+  const reason = autoReviewReason(work, cfg);
+  if (!reason) return undefined;
+  // The review Task's own work-shape: a review, inheriting the parent's criticality. Its target
+  // is resolved through the SAME policy (so review routing stays single-source) — either the
+  // explicit autoReview.target or whatever the review-type rules pick. No pin, no recursion into
+  // auto-review (a review of a review isn't wanted).
+  const reviewShape: TaskDispatch = {
+    type: "review",
+    ...(work.criticality ? { criticality: work.criticality } : {}),
+    ...(work.complexity ? { complexity: work.complexity } : {}),
+  };
+  const reviewPolicy: DispatchPolicy = cfg.target
+    ? { ...policy, rules: [{ label: "auto-review target", match: { type: "review" }, target: cfg.target }, ...policy.rules], autoReview: undefined }
+    : { ...policy, autoReview: undefined };
+  const decision = dispatchTask(reviewShape, {}, { policy: reviewPolicy, bands, catalog });
+  return {
+    dispatch: reviewShape,
+    target: decision.target,
+    rationale: decision.rationale,
+    reason,
+  };
+}
+
+function autoReviewReason(work: TaskDispatch, cfg: DispatchAutoReview): string | undefined {
+  if (work.criticality && cfg.whenCriticality?.includes(work.criticality)) return `criticality=${work.criticality}`;
+  if (work.complexity && cfg.whenComplexity?.includes(work.complexity)) return `complexity=${work.complexity}`;
+  return undefined;
+}
+
+// ---------------------------------------------------------------------------
+// Rationale rendering
+// ---------------------------------------------------------------------------
+
+function buildRationale(target: DispatchTarget, factors: DispatchFactors, warnings: string[]): string {
+  const head = `${target.model ?? `${target.provider} default`}${target.effort ? ` ${target.effort}` : ""}`;
+  const shape = [
+    factors.type ? `type=${factors.type}` : undefined,
+    factors.complexity ? `complexity=${factors.complexity}` : undefined,
+    factors.contextFootprint ? `contextFootprint=${factors.contextFootprint}` : undefined,
+    factors.criticality ? `criticality=${factors.criticality}` : undefined,
+  ].filter(Boolean).join(", ");
+  const parts = [`${head}:`];
+  if (shape) parts.push(shape + ";");
+  parts.push(`matched ${factors.matchedRule};`);
+  parts.push(`${capitalize(target.provider)} band=${factors.band}`);
+  if (factors.escalatedForFootprint) parts.push(`(escalated to ${target.model} for footprint)`);
+  if (factors.reroutedFromProvider) parts.push(`(rerouted from ${factors.reroutedFromProvider})`);
+  if (factors.pinnedFields?.length) parts.push(`(pinned: ${factors.pinnedFields.join(", ")})`);
+  return parts.join(" ");
+}
+
+function capitalize(value: string): string {
+  return value ? value[0]!.toUpperCase() + value.slice(1) : value;
+}
+
+// ---------------------------------------------------------------------------
+// Catalog / band helpers
+// ---------------------------------------------------------------------------
+
+function catalogEntry(catalog: ProviderCatalogEntry[], provider: SpawnProvider): ProviderCatalogEntry | undefined {
+  return catalog.find((c) => c.provider === provider);
+}
+
+function contextWindowOf(catalog: ProviderCatalogEntry[], provider: SpawnProvider, model: string | undefined): number | undefined {
+  const entry = catalogEntry(catalog, provider);
+  if (!entry) return undefined;
+  const alias = model ?? entry.defaultModel;
+  return alias ? contextWindowFromEntry(entry, alias) : undefined;
+}
+
+function contextWindowFromEntry(entry: ProviderCatalogEntry, alias: string): number | undefined {
+  const model = entry.models.find((m) => m.alias === alias) ?? entry.models.find((m) => m.providerModel === alias);
+  return model?.limits?.contextWindowTokens?.value;
+}
+
+function effortIfSupported(entry: ProviderCatalogEntry, alias: string | undefined, effort: string | undefined): string | undefined {
+  if (!effort || !alias) return undefined;
+  const model = entry.models.find((m) => m.alias === alias);
+  return model && model.efforts.includes(effort) ? effort : undefined;
+}
+
+function bandFor(provider: SpawnProvider, bands: ProviderQuotaBand[]): QuotaBand {
+  return bands.find((b) => b.provider === provider)?.band ?? "normal";
+}
+
+function isBlocked(provider: SpawnProvider, bands: ProviderQuotaBand[]): boolean {
+  return bands.find((b) => b.provider === provider)?.blockedNow ?? false;
+}
+
+// Lower = healthier. Mirrors the bandRank ordering used elsewhere (prefer is the best state).
+function bandRank(band: QuotaBand): number {
+  switch (band) {
+    case "prefer": return 0;
+    case "normal": return 1;
+    case "caution": return 2;
+    case "avoid-large": return 3;
+    case "hard-avoid": return 4;
+    default: return 1;
+  }
+}

package/src/upgrade-install-verify.ts

@@ -1,4 +1,4 @@
-import { chmodSync, existsSync, readFileSync, rmSync } from "node:fs";
+import { chmodSync, existsSync, readFileSync, realpathSync, rmSync } from "node:fs";
 import { join } from "node:path";
 
 /**
@@ -143,10 +143,29 @@ export const defaultInstallIo: InstallIo = {
       : bin && typeof bin === "object"
         ? Object.values(bin as Record<string, unknown>).filter((v): v is string => typeof v === "string")
         : [];
+    // Resolve the real node_modules path once so we can guard against workspace
+    // symlinks that point back into the repo working tree (#825).
+    let realNodeModules: string;
+    try {
+      realNodeModules = realpathSync(join(prefix, "node_modules"));
+    } catch {
+      return [];
+    }
     const restored: string[] = [];
     for (const rel of targets) {
       const file = join(pkgDir, rel);
       if (!existsSync(file)) continue;
+      // Skip if the realpath resolves outside node_modules (e.g. a workspace symlink
+      // node_modules/pkg → ../pkg points into the tracked source tree). Chmodding
+      // through such a symlink flips the source file's mode and makes the working
+      // tree appear dirty, mis-routing the landed path into the WIP-preserve path.
+      let realFile: string;
+      try {
+        realFile = realpathSync(file);
+      } catch {
+        continue;
+      }
+      if (!realFile.startsWith(realNodeModules + "/")) continue;
       try {
         chmodSync(file, 0o755);
         restored.push(file);

package/public/assets/display-BWi8DQCp.js

@@ -1,3 +0,0 @@
-import{c as e,d as t,n,o as r,t as i,u as a}from"./types-DorDDvEb.js";var o=`user`,s=o,c=5e3,l=new Set([`done`,`failed`,`canceled`]),u=new Set([`open`,`blocked`]),d={online:0,idle:0,busy:2,offline:3},f={idle:0,online:0,busy:2,offline:4},p={from:``,to:``,body:``,channel:``,subject:``,claimable:!1},m={toMode:`agent`,to:``,body:``,channel:``,subject:``,claimable:!1},h={pairId:``,from:``,body:``,subject:``},ee={requesterId:``,targetId:``,objective:``},te={user:`User`,system:`Server`,channel:`MessagesSquare`,agent:`Bot`},ne={user:`Human operator`,system:`System`,channel:`Channel`,agent:`Agent`};({...te,...Object.fromEntries(e().map(e=>[e,`Bot`]))}),{...ne,...Object.fromEntries(e().map(e=>[e,`${a(e)} agent`]))};var re=[{key:`overview`,label:`Overview`,icon:`LayoutDashboard`},{key:`chat`,label:`Chat`,icon:`MessageCircle`},{key:`agents`,label:`Agents`,icon:`Bot`},{key:`managed`,label:`Managed Agents`,icon:`Workflow`},{key:`teams`,label:`Teams`,icon:`Users`},{key:`profiles`,label:`Agent Profiles`,icon:`UserCog`},{key:`orchestrators`,label:`Orchestrators`,icon:`Server`},{key:`workspaces`,label:`Workspaces`,icon:`GitBranch`},{key:`files`,label:`Files`,icon:`FolderTree`},{key:`channels`,label:`Channels`,icon:`MessagesSquare`},{key:`connectors`,label:`Connectors`,icon:`Plug`},{key:`integrations`,label:`Integrations`,icon:`PlugZap`},{key:`security`,label:`Security`,icon:`Shield`},{key:`memory`,label:`Memory`,icon:`BrainCircuit`},{key:`activity`,label:`Activity`,icon:`Activity`},{key:`pairs`,label:`Pairs`,icon:`Link`},{key:`messages`,label:`Messages`,icon:`Mail`},{key:`work`,label:`Work Queue`,icon:`ListChecks`},{key:`tasks`,label:`Tasks`,icon:`ClipboardList`},{key:`automation`,label:`Automation`,icon:`CalendarClock`},{key:`analytics`,label:`Analytics`,icon:`AreaChart`},{key:`insights`,label:`Insights`,icon:`Lightbulb`},{key:`projects`,label:`Projects`,icon:`Boxes`},{key:`prompts`,label:`Prompts`,icon:`FileText`},{key:`registry`,label:`Registry`,icon:`PackagePlus`},{key:`maintenance`,label:`Maintenance`,icon:`Wrench`},{key:`settings`,label:`Settings`,icon:`Settings`}],ie={critical:`text-red-400 bg-red-500/10`,warning:`text-yellow-400 bg-yellow-500/10`,info:`text-blue-400 bg-blue-500/10`},ae={active:`bg-emerald-500/20 text-emerald-400`,pending:`bg-yellow-500/20 text-yellow-400`,ended:`bg-zinc-500/20 text-zinc-400`,rejected:`bg-red-500/20 text-red-400`,expired:`bg-red-500/20 text-red-400`};function g(e){let t=typeof e==`number`?e:new Date(e||0).getTime();return Number.isFinite(t)?t:0}var _=[`lifecycle.`,`commands.`,`capabilities.`],v={"+1":`👍`,":+1:":`👍`,thumbsup:`👍`,":thumbsup:":`👍`,"thumbs-up":`👍`,":thumbs-up:":`👍`,thumbs_up:`👍`,":thumbs_up:":`👍`,thumb_up:`👍`,":thumb_up:":`👍`,like:`👍`,":like:":`👍`,heart:`❤️`,":heart:":`❤️`,redheart:`❤️`,red_heart:`❤️`,":red_heart:":`❤️`,check:`✅`,":check:":`✅`,checkmark:`✅`,":checkmark:":`✅`,white_check_mark:`✅`,":white_check_mark:":`✅`,eyes:`👀`,":eyes:":`👀`};function y(e){let t=e.trim();return v[t.toLowerCase()]??t}function oe(e){return e.filter(e=>!_.some(t=>e.startsWith(t)))}function se(e,t=2){if(!e)return``;let n=e.replace(/\/+$/,``).split(`/`);return n.length<=t?e:n.slice(-t).join(`/`)}function b(e){return e.trim().replace(/\\/g,`/`).replace(/\/+$/,``)||`/`}function ce(e,t){if(!e?.trim()||!t?.trim())return!1;let n=b(e),r=b(t);return r===`/`?n.startsWith(`/`):n===`/`?!1:n===r||n.startsWith(r+`/`)}function x(e){return e?.meta?.builtin===!0||e?.id===`user`||e?.id===`system`}function S(e){let t=e?.tags||[],n=e?.capabilities||[],r=typeof e?.meta?.policyName==`string`?e.meta.policyName:``;return e?.kind===`channel`||e?.meta?.kind===`channel`||t.includes(`channel`)||t.some(e=>e.startsWith(`channel:`))||n.includes(`channel`)||n.some(e=>e.startsWith(`channel:`))||t.includes(`telegram`)||n.includes(`telegram`)||r===`telegram-main`}function C(e){return!!(typeof e?.meta?.automationId==`string`||typeof e?.meta?.automationRunId==`string`||e?.tags?.includes(`automation`))}function w(e){return x(e)||S(e)||C(e)}function T(t){if(t?.id===`user`)return`user`;if(t?.id===`system`)return`system`;if(S(t))return`channel`;let n=e(),r=typeof t?.meta?.provider==`string`?t.meta.provider.toLowerCase():void 0;if(r&&n.includes(r))return r;let i=[...t?.tags||[],t?.meta?.client,t?.meta?.runtime,t?.meta?.agentType].filter(e=>typeof e==`string`).map(e=>e.toLowerCase());for(let e of n)if(i.some(t=>t.includes(e)))return e;return`agent`}function E(e,t){if(!t?.lastSeen||t.status===`offline`||t.id===`user`||t.id===`system`)return!1;let n=t.meta?.transport;if(r(n)&&n.connected===!0)return!1;let i=new Date(t.lastSeen).getTime();return Number.isFinite(i)?e-i>6e4:!1}function D(e,t){if(!e||x(e)||S(e)||t===`resume`)return!1;if(t===`interrupt`)return e.providerCapabilities?.liveSession?.interrupt===!0&&e.status===`busy`;if(k(e)&&(t===`restart`||t===`shutdown`||t===`compact`||t===`clearContext`)&&!O(e))return!1;let n=e.providerCapabilities?.lifecycle;if(n){if(t===`restart`)return n.restartHard===!0;if(t===`shutdown`)return n.shutdownHard===!0;if(t===`reconnect`)return n.reconnect===!0}return t===`compact`?e.providerCapabilities?.context?.compact===!0:t===`clearContext`?e.providerCapabilities?.context?.clear===!0:e.meta?.runnerManaged===!0&&(t===`restart`||t===`shutdown`)}function O(e){return typeof e.meta?.tmuxSession==`string`&&e.meta.tmuxSession.trim().length>0}function k(e){return(typeof e?.meta?.provider==`string`?t(e.meta.provider):void 0)?.capabilityDefaults?.terminal?.mode===`live`}function A(e){return D(e,`restart`)||D(e,`shutdown`)||D(e,`reconnect`)||D(e,`compact`)||D(e,`clearContext`)}function j(e){return!!(e&&!x(e)&&!S(e)&&!A(e)&&(e.status===`offline`||e.status===`stale`))}function M(e,t){if(e.status!==`offline`)return!1;let n=typeof e.meta?.policyName==`string`?e.meta.policyName:``;if(!n)return!1;let r=t.find(e=>e.policy.name===n);return!!(r?.state.agentId&&r.state.agentId!==e.id)}function N(e,t,n=[]){let r=e.filter(e=>!M(e,n));return t?r:r.filter(e=>!w(e))}function P(e){return e?e.label||e.name||e.id.slice(-12):`?`}function F(e,t){let r=n(e);return r?t[r]:void 0}function I(e,t){let n=F(e,t);return n?.displayName?.trim()||n?.handle?.trim()||`User`}var L=[`text-sky-300`,`text-amber-300`,`text-emerald-300`,`text-violet-300`,`text-rose-300`,`text-cyan-300`];function R(e){let t=n(e)||``,r=0;for(let e=0;e<t.length;e++)r=r*31+t.charCodeAt(e)>>>0;return L[r%L.length]}function z(e,t){if(!e)return`?`;if(e===`broadcast`)return`broadcast`;if(e.startsWith(`tag:`))return`#`+e.slice(4);if(e.startsWith(`cap:`))return e.slice(4);if(e.startsWith(`label:`))return e.slice(6);if(e.startsWith(`team:`)){let n=e.slice(5),r=Object.values(t).find(e=>e.teamId===n);return r?`team:${P(r)}`:`team:${n.slice(-8)}`}let n=t[e];return n?P(n):e.slice(-8)}function B(e){if(!e)return``;let t=e.payload||{},n=t.message;if(n&&typeof n==`object`&&typeof n.text==`string`&&n.text.trim())return n.text;let r=t.interaction;if(r&&typeof r==`object`){let e=typeof r.title==`string`?r.title.trim():``,t=typeof r.description==`string`?r.description.trim():``;if(e&&t)return e+`
-`+t;if(e)return e;if(t)return t}let i=t.reaction;if(i&&typeof i==`object`){let e=typeof i.name==`string`?i.name:``,t=typeof i.emoji==`string`?i.emoji:``,n=typeof i.value==`string`?i.value:``;return[`Reaction`,y(t||e||n)].filter(Boolean).join(`: `)}let a=t.activity;return a&&typeof a==`object`?[typeof a.kind==`string`?a.kind:`activity`,typeof a.state==`string`?a.state:``].filter(Boolean).join(` `):typeof t.text==`string`&&t.text.trim()?t.text:typeof t.message==`string`&&t.message.trim()?t.message:U(e.body||``)??(e.body||``)}function V(e){if(!e?.payload)return!1;let t=e.payload.event;return e.payload.reactionNotification===!0||t?.type===`message.reaction`}function H(e){if(!e)return null;let t=e.trim();if(!t.startsWith(`{`))return null;try{let e=JSON.parse(t);if(typeof e!=`object`||!e||Array.isArray(e))return null;let n=typeof e.text==`string`?e.text:typeof e.message==`string`?e.message:null;if(!n?.trim())return null;let r=new Set([`text`,`message`]);return{text:n,meta:Object.entries(e).filter(([e,t])=>!r.has(e)&&(typeof t==`string`||typeof t==`number`||typeof t==`boolean`)).map(([e,t])=>[e,String(t)]),raw:e}}catch{return null}}function U(e){return H(e)?.text??null}function W(e){let t=e?.subject||B(e)||``;return t.length>90?t.slice(0,90)+`...`:t}function G(e){return i(e.from)&&e.to?e.to:i(e.to)&&e.from?e.from:``}function K(e){return i(e.to)&&!i(e.from)}function le(e){if(e.kind!==`session`)return!1;let t=e.payload?.session?.type;return t===`reasoning`||t===`tool`}function q(e){return e.kind===`session`&&e.payload?.session?.final===!0}function ue(e,t){let n=e.trim(),r=t.trim();return r?n===r?!0:n.startsWith(`${r}\n\n`)||n.endsWith(`\n\n${r}`)||n.includes(`\n\n${r}\n\n`):!1}function de(e,t,n){if(!K(n)||!q(n)||(n.readBy||[]).includes(`user`))return!1;let r=Number(e[t]||0);return n.id>(Number.isFinite(r)?r:0)}function J(e){return u.has(e.status)&&!e.claimedBy}function fe(e){return!!(e.claimable&&!e.claimedBy&&!(e.kind===`task`&&Number.isSafeInteger(e.payload?.taskId)))}function pe(e,t){return!e||!t?!1:e===`broadcast`||e===t.id?!0:e.startsWith(`tag:`)?(t.tags||[]).includes(e.slice(4)):e.startsWith(`cap:`)?(t.capabilities||[]).includes(e.slice(4)):e.startsWith(`label:`)?t.label===e.slice(6):e.startsWith(`team:`)?t.teamId===e.slice(5):!1}function me(e,t){return e?t.from===e||t.to===e||t.resolvedToAgent===e:!1}function he(e,t){if(!e||!t)return!1;let n=[t.id,t.type,...t.topicChannels||[]].filter(Boolean);if(e.channel&&n.includes(e.channel))return!0;let r=e.payload?.channel;if(r&&typeof r==`object`){let e=[r.agentId,r.provider,r.accountId].filter(Boolean);if(e.includes(t.id)||e.includes(t.type)||t.accountId&&e.includes(t.accountId))return!0}return!!(t.agentId&&(e.from===t.agentId||e.to===t.agentId))}function Y(e){let t=e?.meta?.providerState;return!r(t)||typeof t.state!=`string`?null:{state:t.state,reason:typeof t.reason==`string`?t.reason:void 0,label:typeof t.label==`string`&&t.label?t.label:t.state,recommendedAction:typeof t.recommendedAction==`string`?t.recommendedAction:void 0,source:typeof t.source==`string`?t.source:void 0,raw:t.raw,updatedAt:typeof t.updatedAt==`number`?t.updatedAt:void 0,pendingApproval:ge(t.pendingApproval)}}function ge(e){if(!r(e)||typeof e.id!=`string`)return;let t=Array.isArray(e.choices)?e.choices.filter(r).map(e=>({id:e.id,label:typeof e.label==`string`?e.label:String(e.id||``)})).filter(e=>(e.id===`approve`||e.id===`approve-session`||e.id===`deny`||e.id===`abort`)&&!!e.label):[],n=Array.isArray(e.questions)?e.questions.filter(r).map(e=>({question:typeof e.question==`string`?e.question:``,header:typeof e.header==`string`?e.header:void 0,multiSelect:e.multiSelect===!0,options:Array.isArray(e.options)?e.options.filter(r).map(e=>({label:typeof e.label==`string`?e.label:String(e.label??``),description:typeof e.description==`string`?e.description:void 0})).filter(e=>!!e.label):[]})).filter(e=>!!e.question&&e.options.length>0):void 0;return{id:e.id,provider:typeof e.provider==`string`?e.provider:void 0,kind:typeof e.kind==`string`?e.kind:void 0,title:typeof e.title==`string`&&e.title?e.title:`Permission request`,body:typeof e.body==`string`?e.body:``,choices:t,...n&&n.length?{questions:n}:{}}}function X(e){let t=Y(e);return t?.state===`blocked`?t:null}function _e(e){return!!e?.id}function ve(e){return _e(X(e)?.pendingApproval)}function Z(e){let t=e?.meta?.activeSubagents;if(!Array.isArray(t)){let t=typeof e?.meta?.activeSubagentCount==`number`?e.meta.activeSubagentCount:0;return t>0?Array.from({length:t},(e,t)=>({id:`subagent-${t+1}`,label:`Subagent ${t+1}`})):[]}return t.filter(r).map((e,t)=>{let n=typeof e.id==`string`&&e.id?e.id:`subagent-${t+1}`,r=typeof e.role==`string`&&e.role?e.role:void 0;return{id:n,label:typeof e.label==`string`&&e.label?e.label:r||n,role:r,startedAt:typeof e.startedAt==`number`?e.startedAt:void 0}})}function Q(e){let t=e?.meta?.activeWork;if(!Array.isArray(t))return null;let n=t.find(e=>r(e)&&e.kind===`background-script`);return!n||!r(n)?null:typeof n.label==`string`&&n.label?n.label:`background script`}function ye(e,t,n,r){let i=typeof t?.meta?.lifecycleAction==`string`?t.meta.lifecycleAction:``,a=E(e,t),o=t?.status!==`offline`&&!t?.ready&&a,s=t?.status!==`offline`&&!t?.ready&&!a,c=n.unread>0&&t?.status!==`busy`,l=X(t),u=be(t,n,r);if(t?.status===`offline`)return{label:`offline`,tone:`secondary`,icon:`PlugZap`,stale:!1,reconnecting:!1,badges:u};if(i.startsWith(`finalizing-`))return{label:`wrapping up (${i.slice(11)})`,tone:`warning`,icon:`Hourglass`,stale:a,reconnecting:o,badges:u};if(i===`shutting-down`)return{label:`shutting down`,tone:`warning`,icon:`Power`,stale:a,reconnecting:o,badges:u};if(i===`killing`)return{label:`killing`,tone:`danger`,icon:`Power`,stale:a,reconnecting:o,badges:u};if(i===`restarting`)return{label:`restarting`,tone:`warning`,icon:`RefreshCw`,stale:a,reconnecting:o,badges:u};if(t?.status===`stale`)return{label:`stale`,tone:`danger`,icon:`RefreshCw`,stale:!0,reconnecting:!0,badges:u};if(o)return{label:`reconnecting`,tone:`danger`,icon:`RefreshCw`,stale:a,reconnecting:o,badges:u};if(s)return{label:`online, not ready`,tone:`warning`,icon:`Loader`,stale:a,reconnecting:o,badges:u};if(l)return{label:`blocked: ${l.label}`,tone:`danger`,icon:`AlertCircle`,stale:a,reconnecting:o,badges:u};if(t?.status===`busy`){let e=Array.isArray(t?.meta?.busyReasons)?t.meta.busyReasons:[];return Q(t)&&!e.includes(`provider-turn`)&&!e.includes(`subagent`)?{label:`running background work`,tone:`warning`,icon:`Play`,stale:a,reconnecting:o,badges:u}:{label:`busy in turn`,tone:`warning`,icon:`Play`,stale:a,reconnecting:o,badges:u}}return r?.status===`active`?{label:`paired`,tone:`success`,icon:`Link`,stale:a,reconnecting:o,badges:u}:c?{label:`idle, unread`,tone:`danger`,icon:`Bell`,stale:a,reconnecting:o,badges:u}:{label:t?.status===`idle`?`idle`:`ready`,tone:`success`,icon:`CircleCheck`,stale:a,reconnecting:o,badges:u}}function be(e,t,n){let r=[],i=X(e),a=Z(e).length;i&&r.push({label:i.reason?`blocked: ${i.reason}`:`blocked`,className:`bg-red-500/20 text-red-400`}),a&&r.push({label:a===1?`1 subagent`:a+` subagents`,className:`bg-cyan-500/20 text-cyan-300`});let o=Q(e);return o&&r.push({label:o,className:`bg-indigo-500/20 text-indigo-300`}),n?.status===`active`&&r.push({label:`paired`,className:`bg-emerald-500/20 text-emerald-400`}),n?.status===`pending`&&r.push({label:`pair invite`,className:`bg-yellow-500/20 text-yellow-400`}),t.needsHumanResponse&&r.push({label:`needs response`,className:`bg-amber-500/20 text-amber-300`}),t.unread&&r.push({label:t.unread+` unread`,className:`bg-red-500/20 text-red-400`}),t.claimableTasks&&r.push({label:t.claimableTasks+` claimable`,className:`bg-orange-500/20 text-orange-400`}),r}function xe(){return{unread:0,needsHumanResponse:!1,pendingPairInvite:!1,claimableTasks:0,total:0,score:0}}function $(e){return!e||e.status===`offline`?!1:e.targetHealth?.status===`ok`?!0:e.targetHealth?.status===`error`||e.targetHealth?.status===`warning`?!1:e.ready}function Se(e){return e?e.targetHealth?.status===`error`?{label:`target broken`,tone:`danger`,icon:`AlertTriangle`,badges:[]}:e.targetHealth?.status===`warning`?{label:`target warning`,tone:`warning`,icon:`AlertCircle`,badges:[]}:e.status===`offline`?{label:`offline`,tone:`secondary`,icon:`PlugZap`,badges:[]}:e.status===`busy`?{label:`busy`,tone:`warning`,icon:`Activity`,badges:[]}:$(e)?{label:`ready`,tone:`success`,icon:`CircleCheck`,badges:[]}:{label:`not ready`,tone:`warning`,icon:`Loader`,badges:[]}:{label:`unknown`,tone:`secondary`,icon:`PlugZap`,badges:[]}}function Ce(e){let t=e?.runtime||{};return t.status===`error`?{label:`error`,tone:`danger`,icon:`AlertTriangle`,badges:[]}:t.status===`warn`?{label:`warning`,tone:`warning`,icon:`AlertCircle`,badges:[]}:t.running?{label:`running`,tone:`success`,icon:`CircleCheck`,badges:[]}:t.enabled===!1?{label:`disabled`,tone:`secondary`,icon:`Pause`,badges:[]}:t.status===`ok`?{label:`ok`,tone:`success`,icon:`CircleCheck`,badges:[]}:{label:`unknown`,tone:`secondary`,icon:`HelpCircle`,badges:[]}}function we(e){let t=e?.taskStats||{};return(t.waitingTasks||0)>0?{label:`waiting`,tone:`warning`,icon:`AlertCircle`,badges:[]}:(t.openTasks||0)>0?{label:`active`,tone:`info`,icon:`Activity`,badges:[]}:e?.configured?e.observed?{label:`quiet`,tone:`success`,icon:`CircleCheck`,badges:[]}:{label:`configured`,tone:`primary`,icon:`PlugZap`,badges:[]}:{label:`observed only`,tone:`secondary`,icon:`Eye`,badges:[]}}function Te(e){let t=e?.health;return!t||t.status===`ok`?e?.version||e?.package?.version?`compatible`:`unknown version`:t.status===`upgrade-required`?`upgrade required`:t.status===`restart-required`?`restart required`:t.status===`unknown`?`unknown contract`:(t.issues||[]).some(e=>e.code===`protocol-mismatch`)?`protocol mismatch`:(t.issues||[]).some(e=>e.code===`package-drift`)?`package drift`:t.restartRequired?`restart required`:t.status}function Ee(e){let t=e?.health?.status;return t===`upgrade-required`?`text-red-400 bg-red-500/10`:t===`warn`||t===`restart-required`?`text-yellow-400 bg-yellow-500/10`:t===`unknown`?`text-zinc-400 bg-zinc-500/10`:`text-emerald-400 bg-emerald-500/10`}function De(e,t){if(!t)return``;let n=new Date(t).getTime();if(!Number.isFinite(n))return``;let r=Math.max(0,(e-n)/1e3);return r<60?Math.floor(r)+`s ago`:r<3600?Math.floor(r/60)+`m ago`:r<86400?Math.floor(r/3600)+`h ago`:Math.floor(r/86400)+`d ago`}function Oe(e){return e?new Date(e).toLocaleString():``}function ke(e){return String(e||`export`).replace(/[^a-z0-9._-]+/gi,`-`).replace(/^-+|-+$/g,``).slice(0,80)||`export`}function Ae(e){return e.filter(e=>e.status!==`ok`).map(e=>{let t={name:e.name,status:e.status,detail:e.detail||e.name,impact:je(e),subjects:e.subjects||[],actions:[{label:`Inspect logs`,icon:`FileSearch`,copy:`agent-relay daemon logs`},{label:`Restart daemon`,icon:`RefreshCw`,copy:`agent-relay daemon restart`},{label:`Copy env`,icon:`Copy`,copy:`agent-relay doctor`}]};return e.name===`stale-live-agents`?t.actions.unshift({label:`Run reaper`,icon:`Eraser`,api:`POST`,path:`/system/reap`},{label:`Show stale`,icon:`Filter`,view:`agents`,preset:`offline_stale`}):e.name===`channel-delivery-targets`?t.actions.unshift({label:`Open channels`,icon:`MessagesSquare`,view:`channels`},{label:`Run reaper`,icon:`Eraser`,api:`POST`,path:`/system/reap`}):[`expired-message-claims`,`expired-task-claims`,`offline-claimed-tasks`].includes(e.name)&&t.actions.unshift({label:`Run reaper`,icon:`Eraser`,api:`POST`,path:`/system/reap`},{label:`Open work`,icon:`ListChecks`,view:`work`}),t})}function je(e){return{database:`Relay persistence is unavailable; messages, state, and audit writes may fail.`,"stale-live-agents":`Agents may look online even though their heartbeat has stopped.`,"expired-message-claims":`Claimable messages may be stuck until the reaper releases expired claims.`,"expired-task-claims":`Tasks can appear owned by agents that no longer hold a live lease.`,"offline-claimed-tasks":`Offline agents are still shown as owners for active work.`,"channel-delivery-targets":`Inbound channel messages may be accepted but routed to no live delivery agent.`}[e.name]||`Relay health is degraded for this check.`}function Me(e){return{success:`text-emerald-400`,warning:`text-yellow-400`,danger:`text-red-400`,info:`text-blue-400`,primary:`text-blue-400`,secondary:`text-zinc-400`}[e]||`text-zinc-400`}function Ne(e,t){return!e||e.status===`offline`?`bg-zinc-500 opacity-50`:typeof e.meta?.lifecycleAction==`string`&&e.meta.lifecycleAction.startsWith(`finalizing-`)?`bg-amber-500 animate-pulse`:e.meta?.lifecycleAction===`shutting-down`||e.meta?.lifecycleAction===`restarting`?`bg-yellow-500 animate-pulse`:e.meta?.lifecycleAction===`killing`||X(e)?`bg-red-500 animate-pulse`:e.status===`busy`?`bg-yellow-500`:t&&E(t,e)?`bg-red-500 animate-pulse`:e.ready?`bg-emerald-500 shadow-[0_0_6px_theme(colors.emerald.500)]`:`bg-emerald-500 animate-pulse`}function Pe(e,t,n){if(typeof document>`u`||typeof URL>`u`||typeof Blob>`u`)return;let r=URL.createObjectURL(new Blob([t],{type:n})),i=document.createElement(`a`);i.href=r,i.download=e,i.click(),URL.revokeObjectURL(r)}export{p as $,me as A,Y as B,fe as C,le as D,V as E,Ee as F,Ne as G,ue as H,Te as I,Me as J,De as K,H as L,W as M,b as N,de as O,y as P,l as Q,ce as R,q as S,K as T,ke as U,F as V,se as W,N as X,oe as Y,f as Z,R as _,D as a,c as at,we as b,Se as c,ie as ct,P as d,m as et,z as f,Ae as g,Oe as h,ye as i,s as it,he as j,B as k,Ce as l,d as lt,xe as m,j as n,h as nt,T as o,re as ot,Pe as p,g as q,ve as r,o as rt,$ as s,ae as st,Z as t,ee as tt,pe as u,I as v,J as w,E as x,G as y,X as z};
-//# sourceMappingURL=display-BWi8DQCp.js.map