agent-embassy 1.0.0

package/dist/src/gateway/dashboard-model.d.ts

@@ -0,0 +1,207 @@
+import { type CompatibilityCertificationDepth, type CompatibilityTier, type CompatibilitySurface } from "./compatibility.js";
+import type { AlertSeverity, CompatibilityState, ConnectorHealth, DeliveryState, GatewayProvider, GatewayPublicSnapshot, MessageDirection, PublicAvailablePeerState, RouteCounters, RouteState } from "./types.js";
+export declare const DASHBOARD_MODEL_LIMITS: Readonly<{
+    readonly connectors: 16;
+    readonly availablePeers: 64;
+    readonly routes: 128;
+    readonly pairs: 64;
+    readonly messages: 50;
+    readonly messageEvents: 60;
+    readonly progressWatches: 64;
+    readonly progressWatchEvents: 64;
+    readonly activityEvents: 64;
+    readonly alerts: 32;
+}>;
+export type DashboardTone = "good" | "info" | "warning" | "danger" | "quiet";
+export type DashboardNextAction = "discover_claude" | "select_claude" | "pair_routes" | "restore_claude" | "repair_claude_inventory" | "register_codex" | "restore_codex" | "none";
+export type DashboardExchangeParty = Readonly<{
+    kind: "claude" | "codex";
+    status: "ready" | "busy" | "waiting" | "missing" | "attention";
+    total: number;
+    ready: number;
+    selectable?: number | undefined;
+    countIsLowerBound: boolean;
+    primaryAlias?: string | undefined;
+    nextAction: DashboardNextAction;
+}>;
+export type DashboardAttentionItem = Readonly<{
+    kind: "alert" | "route" | "connector" | "broker" | "watch";
+    code?: string | undefined;
+    severity: AlertSeverity;
+    timestamp?: string | undefined;
+    provider?: GatewayProvider | undefined;
+    alias?: string | undefined;
+    host?: string | undefined;
+    guidance: "reobserve_claude" | "reobserve_codex" | "claude_not_observed" | "codex_stale" | "connector_offline" | "route_stale" | "queue_stalled" | "unconfirmed" | "degraded" | "codex_succession_busy" | "codex_succession_recovery" | "progress_watch" | "generic";
+}>;
+export type DashboardProgressWatchRow = Readonly<{
+    conversationIdSuffix: string;
+    ownerAlias: string;
+    workerAlias: string;
+    phase: "quiet" | "episode";
+    capability: "conversation" | "route";
+    lastActivityAt: string;
+    nextActionAt: string;
+    idleMs: number;
+    idleForMs: number;
+    dueInMs: number;
+    nudgeCount: 0 | 1 | 2;
+    workerReportedComplete: boolean;
+}>;
+export type DashboardProgressWatchEventRow = Readonly<{
+    sequence: number;
+    timestamp: string;
+    conversationIdSuffix: string;
+    ownerAlias: string;
+    workerAlias: string;
+    kind: "opened" | "nudge" | "worker_reported_complete" | "capability_degraded" | "done" | "unresponsive" | "endpoint_retired" | "disabled";
+    nudgeNumber?: 1 | 2 | undefined;
+}>;
+export type DashboardMessageEvent = Readonly<{
+    sequence: number;
+    timestamp?: string | undefined;
+    state: DeliveryState;
+    latencyMs?: number | undefined;
+    safeErrorCode?: string | undefined;
+    conversationIdSuffix?: string | undefined;
+    steer?: true | undefined;
+}>;
+export type DashboardMessageGroup = Readonly<{
+    direction: MessageDirection;
+    sourceAlias: string;
+    targetAlias: string;
+    messageIdSuffix?: string | undefined;
+    conversationIdSuffix?: string | undefined;
+    state: DeliveryState;
+    timestamp?: string | undefined;
+    latencyMs?: number | undefined;
+    bytes: number;
+    safeErrorCode?: string | undefined;
+    steer?: true | undefined;
+    events: readonly DashboardMessageEvent[];
+}>;
+export type DashboardActivityEventRow = Readonly<{
+    sequence: number;
+    timestamp: string;
+    kind: "discovery" | "selection" | "registration" | "pairing" | "watch";
+    action: "discovery_refreshed" | "claude_selected" | "claude_unselected" | "codex_registered" | "codex_succeeded" | "codex_unregistered" | "routes_paired" | "routes_unpaired" | "watch_ended";
+    outcome: "accepted" | "rejected";
+    aliases: readonly string[];
+    safeErrorCode?: string | undefined;
+}>;
+export type DashboardPeerRow = Readonly<{
+    alias: string;
+    host: string;
+    state: PublicAvailablePeerState;
+    compatibility: CompatibilityState;
+    validated: boolean;
+    selected: boolean;
+    selectable: boolean;
+    selectionGuidance?: "alias_collision" | "session_collision" | "discovery_incomplete" | "incompatible" | "offline" | undefined;
+    lastSeenAt?: string | undefined;
+    safeErrorCode?: string | undefined;
+}>;
+export type DashboardRouteRow = Readonly<{
+    alias: string;
+    provider: GatewayProvider;
+    host: string;
+    enabled: boolean;
+    state: RouteState;
+    compatibility: CompatibilityState;
+    queueDepth: number;
+    oldestQueuedAt?: string | undefined;
+    queueAgeMs?: number | undefined;
+    counters: RouteCounters;
+    lastSeenAt?: string | undefined;
+    safeErrorCode?: string | undefined;
+}>;
+export type DashboardPairRow = Readonly<{
+    claudeAlias: string;
+    codexAlias: string;
+    host: string;
+    state: "ready" | "degraded" | "unavailable";
+    counters: RouteCounters;
+}>;
+export type DashboardGraphFacts = Readonly<{
+    pairCount: number;
+    readyPairCount: number;
+    pairCountIsLowerBound: boolean;
+    unpairedReadyClaude: number;
+    unpairedReadyCodex: number;
+}>;
+export type DashboardConnectorRow = Readonly<{
+    provider: GatewayProvider;
+    host: string;
+    health: ConnectorHealth;
+    compatibility: CompatibilityState;
+    protocol?: string | undefined;
+    protocolVersion?: string | undefined;
+    lastSeenAt?: string | undefined;
+    safeErrorCode?: string | undefined;
+}>;
+export type DashboardCompatibilityCheckRow = Readonly<{
+    surface: CompatibilitySurface;
+    version: string;
+    tier: CompatibilityTier;
+    checkedAt: string;
+    certificationDepth?: CompatibilityCertificationDepth | undefined;
+    certificationOutcome?: "pass" | "fail" | undefined;
+    certifiedAt?: string | undefined;
+    certificationSafeErrorCode?: string | undefined;
+    failedProbe?: string | undefined;
+    safeErrorCode?: string | undefined;
+}>;
+export type DashboardOmissions = Readonly<{
+    connectors: number;
+    availablePeers: number;
+    routes: number;
+    pairs: number;
+    progressWatches: number;
+    upstreamProgressWatchEvents: number;
+    progressWatchEvents: number;
+    upstreamMessageEvents: number;
+    messageGroups: number;
+    messageEvents: number;
+    upstreamAlerts: number;
+    attentionItems: number;
+    upstreamActivityEvents: number;
+    activityEvents: number;
+}>;
+export type DashboardViewModel = Readonly<{
+    schemaVersion: 1;
+    generatedAt?: string | undefined;
+    inboundMode: "paired" | "open";
+    health: ConnectorHealth;
+    overall: "ready" | "setup" | "attention";
+    exchange: Readonly<{
+        claude: DashboardExchangeParty;
+        codex: DashboardExchangeParty;
+        queuedMessages: number;
+        queueCountIsLowerBound: boolean;
+        oldestQueueAgeMs?: number | undefined;
+        oldestQueuedAt?: string | undefined;
+    }>;
+    attention: readonly DashboardAttentionItem[];
+    transit: Readonly<{
+        queuedMessages: number;
+        activeDeliveries: number;
+        queueCountIsLowerBound: boolean;
+        activeCountIsLowerBound: boolean;
+        oldestQueueAgeMs?: number | undefined;
+        oldestQueuedAt?: string | undefined;
+    }>;
+    activity: readonly DashboardMessageGroup[];
+    brokerActivity: readonly DashboardActivityEventRow[];
+    peers: readonly DashboardPeerRow[];
+    routes: readonly DashboardRouteRow[];
+    pairs: readonly DashboardPairRow[];
+    watches: readonly DashboardProgressWatchRow[];
+    watchEvents: readonly DashboardProgressWatchEventRow[];
+    graph: DashboardGraphFacts;
+    connectors: readonly DashboardConnectorRow[];
+    compatibilityChecks: readonly DashboardCompatibilityCheckRow[];
+    accounting: GatewayPublicSnapshot["accounting"];
+    deadlinePressure?: GatewayPublicSnapshot["deadlinePressure"];
+    omissions: DashboardOmissions;
+}>;
+export declare function buildDashboardViewModel(snapshot: GatewayPublicSnapshot): DashboardViewModel;