agent-embassy 2.0.1 → 3.0.0

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

@@ -1,343 +0,0 @@
-import type { AlertSeverity, 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 consentEdges: 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" | "none";
-export type DashboardExchangeParty = Readonly<{
-    kind: GatewayProvider;
-    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;
-    /** Present only for a threshold-stalled queue behind a busy Codex route. */
-    queueDepth?: number | undefined;
-    guidance: "reobserve_claude" | "consent_edge_unavailable" | "claude_not_observed" | "connector_offline" | "route_stale" | "queue_stalled" | "recipient_waiting_input" | "unconfirmed" | "degraded" | "progress_watch" | "registry_empty" | "registry_rejected" | "generic";
-}>;
-export type DashboardProgressWatchRow = Readonly<{
-    conversationIdSuffix: string;
-    ownerAlias: string;
-    workerAlias: string;
-    lastActivityAt: string;
-    nextActionAt: string;
-    idleForMs: number;
-    dueInMs: number;
-    nudgeCount: 0 | 1 | 2;
-}>;
-export type DashboardProgressWatchEventRow = Readonly<{
-    sequence: number;
-    timestamp: string;
-    conversationIdSuffix: string;
-    ownerAlias: string;
-    workerAlias: string;
-    kind: "opened" | "replaced" | "settled";
-    actor: "owner" | "worker" | "operator" | "gateway" | "unknown";
-    reason?: "done" | "untracked" | "idle_timeout" | "pair_removed" | "endpoint_retired" | "tracking_disabled" | 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 LiveDashboardMessageGroup = DashboardMessageGroup & Readonly<{
-    body?: string | undefined;
-}>;
-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[];
-    operatorAction: boolean;
-    safeErrorCode?: string | undefined;
-}>;
-export type DashboardPeerRow = Readonly<{
-    alias: string;
-    host: string;
-    state: PublicAvailablePeerState;
-    validated: boolean;
-    selected: boolean;
-    selectable: boolean;
-    selectionGuidance?: "alias_collision" | "session_collision" | "discovery_incomplete" | "offline" | undefined;
-    lastSeenAt?: string | undefined;
-    safeErrorCode?: string | undefined;
-}>;
-export type DashboardRouteRow = Readonly<{
-    alias: string;
-    provider: GatewayProvider;
-    host: string;
-    enabled: boolean;
-    state: RouteState;
-    queueDepth: number;
-    oldestQueuedAt?: string | undefined;
-    queueAgeMs?: number | undefined;
-    counters: RouteCounters;
-    lastSeenAt?: string | undefined;
-    safeErrorCode?: string | undefined;
-    mutable?: boolean | undefined;
-}>;
-export type DashboardConsentEndpoint = Readonly<{
-    alias: string;
-    provider: GatewayProvider;
-}>;
-export type DashboardConsentEdgeRow = Readonly<{
-    endpoints: readonly [DashboardConsentEndpoint, DashboardConsentEndpoint];
-    host: string;
-    state: "ready" | "degraded" | "unavailable";
-    counters: RouteCounters;
-    mutable?: boolean | undefined;
-}>;
-export type DashboardGraphFacts = Readonly<{
-    consentEdgeCount: number;
-    readyConsentEdgeCount: number;
-    consentEdgeCountIsLowerBound: boolean;
-    unpairedReadyByProvider: Readonly<Record<GatewayProvider, number>>;
-}>;
-export type DashboardConnectorRow = Readonly<{
-    provider: GatewayProvider;
-    host: string;
-    health: ConnectorHealth;
-    protocol?: string | undefined;
-    protocolVersion?: string | undefined;
-    lastSeenAt?: string | undefined;
-    codexDoctor?: Readonly<{
-        conditions: readonly ("split_brain" | "orphaned" | "attached" | "observation_stale" | "managed_layout_missing" | "unknown")[];
-    }>;
-    safeErrorCode?: string | undefined;
-    registry?: DashboardRegistryObservation | undefined;
-}>;
-export type DashboardRegistryObservation = Readonly<{
-    entriesScanned: number;
-    parseableRecords: number;
-    parseableRecordSeenSinceBoot: boolean;
-    rejected: readonly Readonly<{
-        safeErrorCode: string;
-        count: number;
-    }>[];
-    rejectedCodesOmitted: number;
-}>;
-export type DashboardOmissions = Readonly<{
-    connectors: number;
-    availablePeers: number;
-    routes: number;
-    consentEdges: 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: 2;
-    generatedAt?: string | undefined;
-    inboundMode: "paired" | "open";
-    health: ConnectorHealth;
-    overall: "ready" | "setup" | "attention";
-    exchange: Readonly<{
-        parties: readonly 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[];
-    consentEdges: readonly DashboardConsentEdgeRow[];
-    watches: readonly DashboardProgressWatchRow[];
-    watchEvents: readonly DashboardProgressWatchEventRow[];
-    graph: DashboardGraphFacts;
-    connectors: readonly DashboardConnectorRow[];
-    accounting: GatewayPublicSnapshot["accounting"];
-    deadlinePressure?: GatewayPublicSnapshot["deadlinePressure"];
-    omissions: DashboardOmissions;
-}>;
-export type LiveDashboardViewModel = Omit<DashboardViewModel, "activity"> & Readonly<{
-    activity: readonly LiveDashboardMessageGroup[];
-}>;
-export type DashboardChipKind = "positive" | "qualified" | "active" | "progress" | "warning" | "indeterminate" | "failure" | "inert" | "unknown";
-export type DashboardSemanticDomain = "delivery" | "route" | "peer" | "health" | "overall" | "party" | "severity" | "connection";
-/** JSON-safe semantics embedded once in the live dashboard boot payload. */
-export declare const DASHBOARD_SEMANTICS: Readonly<{
-    readonly statePresentation: {
-        readonly delivery: Readonly<Record<"delivered" | "failed" | "cancelled" | "queued" | "duplicate" | "dispatching" | "transport_written" | "held" | "unconfirmed" | "ambiguous" | "expired" | "abandoned" | "rejected", Readonly<{
-            tone: DashboardTone;
-            chip: DashboardChipKind;
-        }>>>;
-        readonly route: Readonly<Record<"offline" | "stale" | "idle" | "busy" | "awaiting_approval" | "disabled", Readonly<{
-            tone: DashboardTone;
-            chip: DashboardChipKind;
-        }>>>;
-        readonly peer: Readonly<Record<"offline" | "idle" | "busy" | "awaiting_approval", Readonly<{
-            tone: DashboardTone;
-            chip: DashboardChipKind;
-        }>>>;
-        readonly health: Readonly<Record<"offline" | "connecting" | "healthy" | "degraded", Readonly<{
-            tone: DashboardTone;
-            chip: DashboardChipKind;
-        }>>>;
-        readonly overall: Readonly<Record<"ready" | "attention" | "setup", Readonly<{
-            tone: DashboardTone;
-            chip: DashboardChipKind;
-        }>>>;
-        readonly party: Readonly<Record<"busy" | "ready" | "waiting" | "missing" | "attention", Readonly<{
-            tone: DashboardTone;
-            chip: DashboardChipKind;
-        }>>>;
-        readonly severity: Readonly<Record<"error" | "info" | "warning", Readonly<{
-            tone: DashboardTone;
-            chip: DashboardChipKind;
-        }>>>;
-        readonly connection: Readonly<Record<"connected" | "connecting" | "unavailable" | "paused" | "capacity" | "disconnected" | "stopped", Readonly<{
-            tone: DashboardTone;
-            chip: DashboardChipKind;
-        }>>>;
-    };
-    readonly deliveryChipByTargetProvider: {
-        readonly delivered: {
-            readonly claude: "qualified";
-        };
-    };
-    readonly deliveryChipBySafeErrorCode: {
-        readonly rejected: {
-            readonly SENDER_NOT_PAIRED: "inert";
-        };
-    };
-    readonly deliveryToneBySafeErrorCode: {
-        readonly rejected: {
-            readonly SENDER_NOT_PAIRED: "quiet";
-        };
-    };
-    readonly guidanceCopyKeys: {
-        readonly reobserve_claude: "reobserveClaude";
-        readonly consent_edge_unavailable: "consentEdgeUnavailable";
-        readonly claude_not_observed: "claudeNotObserved";
-        readonly connector_offline: "connectorOffline";
-        readonly route_stale: "routeStale";
-        readonly queue_stalled: "queueStalled";
-        readonly recipient_waiting_input: "recipientWaitingInput";
-        readonly unconfirmed: "unconfirmed";
-        readonly degraded: "degraded";
-        readonly progress_watch: "progressWatch";
-        readonly registry_empty: "registryEmpty";
-        readonly registry_rejected: "registryRejected";
-        readonly generic: "generic";
-    };
-    readonly nextActionCopyKeys: {
-        readonly discover_claude: "next.discoverClaude";
-        readonly select_claude: "next.selectClaude";
-        readonly pair_routes: "next.pairRoutes";
-        readonly restore_claude: "next.restoreClaude";
-        readonly repair_claude_inventory: "next.repairClaude";
-        readonly register_codex: "next.registerCodex";
-        readonly none: "next.none";
-    };
-    readonly attentionCommands: {
-        readonly reobserve_claude: "embassy select-claude --alias {alias}";
-        readonly consent_edge_unavailable: "embassy refresh-dashboard";
-        readonly claude_not_observed: "embassy select-claude --alias {alias}";
-        readonly connector_offline: "embassy status";
-        readonly route_stale: "embassy status";
-        readonly queue_stalled: "embassy status";
-        readonly recipient_waiting_input: "embassy status";
-        readonly unconfirmed: "embassy status";
-        readonly degraded: "embassy status";
-        readonly progress_watch: "embassy status";
-        readonly registry_empty: "embassy refresh-dashboard";
-        readonly registry_rejected: "embassy status";
-        readonly generic: "embassy status";
-    };
-    readonly attentionCommandFallbacks: {};
-    readonly deliveryMeaningKeys: {
-        readonly queued: "activity.meaning.queued";
-        readonly duplicate: "activity.meaning.duplicate";
-        readonly dispatching: "activity.meaning.dispatching";
-        readonly transport_written: "activity.meaning.transportWritten";
-        readonly held: "activity.meaning.held";
-        readonly delivered: "activity.meaning.delivered";
-        readonly unconfirmed: "activity.meaning.unconfirmed";
-        readonly failed: "activity.meaning.failed";
-        readonly ambiguous: "activity.meaning.ambiguous";
-        readonly expired: "activity.meaning.expired";
-        readonly cancelled: "activity.meaning.cancelled";
-        readonly abandoned: "activity.meaning.abandoned.generic";
-        readonly rejected: "activity.meaning.rejected";
-    };
-    readonly deliveryMeaningByTargetProvider: {
-        readonly claude: "activity.meaning.delivered.toClaude";
-        readonly codex: "activity.meaning.delivered.toCodex";
-        readonly deepseek: "activity.meaning.delivered.toDeepSeek";
-        readonly grok: "activity.meaning.delivered.toGrok";
-        readonly peer: "activity.meaning.delivered.toPeer";
-    };
-    readonly deliveryMeaningBySafeErrorCode: {
-        readonly SENDER_NOT_PAIRED: "activity.meaning.senderNotPaired";
-        readonly CONTROLLER_RESTARTED: "activity.meaning.abandoned.controllerRestarted";
-        readonly TRANSIENT_BODY_UNAVAILABLE: "activity.meaning.abandoned.transientBody";
-        readonly ROUTE_UNREGISTERED: "activity.meaning.abandoned.routeTerminated";
-        readonly MESSAGE_EXPIRED: "activity.meaning.abandoned.routeTerminated";
-    };
-}>;
-export type DashboardSemantics = typeof DASHBOARD_SEMANTICS;
-export declare function dashboardTone(domain: DashboardSemanticDomain, state: string, safeErrorCode?: string): DashboardTone;
-export declare function deliveryMeaningKey(state: string, direction?: MessageDirection, safeErrorCode?: string): string;
-export declare function guidanceCopyKey(guidance: DashboardAttentionItem["guidance"]): string;
-export declare function nextActionCopyKey(action: DashboardNextAction): string;
-export declare function attentionCommand(item: DashboardAttentionItem): string;
-export declare function buildDashboardViewModel(snapshot: GatewayPublicSnapshot): DashboardViewModel;
-export declare function buildLiveDashboardViewModel(snapshot: GatewayPublicSnapshot): LiveDashboardViewModel;