@agentdeck/bridge 0.1.0 → 0.2.1

package/dist/bridge-core.d.ts

@@ -0,0 +1,162 @@
+import type { Server } from 'http';
+import type WebSocket from 'ws';
+import { UsageTracker } from './usage-tracker.js';
+import { StateMachine } from './state-machine.js';
+import { WsServer } from './ws-server.js';
+import { OllamaProbe, type OllamaStatus } from './ollama-probe.js';
+import { DisplayMonitor } from './display-monitor.js';
+import { BridgeTimelineStore } from './timeline-store.js';
+import type { BridgeLogStream } from './log-stream.js';
+import { type ApiUsageData } from './usage-api.js';
+import type { ApmeModule } from './apme/index.js';
+import { type BridgeEvent, type StateSnapshot, type AgentType, type AgentCapabilities, type ModelCatalogEntry, type VoiceAssistantState } from './types.js';
+export interface BridgeCoreOptions {
+    port: number;
+    sessionId?: string;
+    projectName: string;
+    httpServer: Server;
+}
+/**
+ * Shared infrastructure extracted from index.ts and daemon-server.ts.
+ *
+ * Manages: StateMachine, WsServer, UsageTracker, DisplayMonitor, OllamaProbe,
+ * BridgeTimelineStore, auth, session registry, probes, polling, shutdown.
+ *
+ * Callers (startSession / startDaemon) wire adapters, voice, utility, etc.
+ */
+export declare class BridgeCore {
+    readonly port: number;
+    readonly sessionId: string;
+    readonly projectName: string;
+    readonly stateMachine: StateMachine;
+    readonly usageTracker: UsageTracker;
+    readonly wsServer: WsServer;
+    readonly bridgeTimeline: BridgeTimelineStore;
+    readonly displayMonitor: DisplayMonitor;
+    readonly ollamaProbe: OllamaProbe;
+    readonly authToken: string;
+    readonly wsUrl: string;
+    cachedApiUsage: ApiUsageData | null;
+    lastApiFetchTime: number;
+    oauthConnected: boolean;
+    apiUsageStale: boolean;
+    /** True when cachedApiUsage was synced from relay's already-adjusted values */
+    apiUsagePreAdjusted: boolean;
+    cachedOllamaStatus: OllamaStatus | null;
+    cachedMlxModels: string[] | null;
+    cachedAntigravityStatus: import("./antigravity-local.js").AntigravityStatusInfo | null;
+    cachedGatewayAvailable: boolean;
+    cachedGatewayConnected: boolean;
+    cachedGatewayHasError: boolean;
+    cachedModelCatalog: ModelCatalogEntry[] | null;
+    cachedVoiceAssistantState: VoiceAssistantState;
+    cachedVoiceAssistantText: string | undefined;
+    cachedVoiceAssistantResponseText: string | undefined;
+    private intervals;
+    private timeouts;
+    private lastSessionsListBroadcast;
+    private shutdownInProgress;
+    private shutdownCallbacks;
+    private sseBroadcast?;
+    /** Optional callback to enrich sessions_list (e.g., daemon injects Gateway virtual session) */
+    private sessionsEnricher?;
+    /** Optional callback to expose daemon-owned device/module health on state_update. */
+    private moduleHealthProvider?;
+    /** External client count provider (e.g., ESP32 serial connections) */
+    private externalClientCount;
+    /** Optional APME subsystem — set via setApme() after initApme() resolves. */
+    private apme;
+    private apmeAgentType;
+    private apmeCwd;
+    private static readonly USAGE_STALE_TTL;
+    constructor(opts: BridgeCoreOptions);
+    /** Set optional SSE broadcast callback (for HookServer-based sessions) */
+    setSseBroadcast(cb: (evt: BridgeEvent) => void): void;
+    /** Broadcast to WS + optional SSE */
+    broadcast(evt: BridgeEvent): void;
+    wireTimeline(logStream?: BridgeLogStream): void;
+    private _previousDisplayOn;
+    private _wakeHandler;
+    wireDisplayMonitor(): void;
+    /** Register a callback for system wake recovery. */
+    onSystemWake(handler: () => void): void;
+    /**
+     * Build a state_update BridgeEvent.
+     * Session mode passes full snapshot extras; daemon uses minimal fields.
+     */
+    buildStateEvent(opts: {
+        agentType: AgentType;
+        agentCapabilities?: AgentCapabilities;
+        snapshot?: StateSnapshot;
+    }): BridgeEvent;
+    /** Update cached voice assistant state and trigger a state broadcast */
+    updateVoiceAssistantState(vaState: VoiceAssistantState, text?: string, responseText?: string): void;
+    /** Build and return a usage event */
+    buildUsage(): BridgeEvent;
+    /** Broadcast current usage to all clients */
+    broadcastUsage(): void;
+    /**
+     * Update cached API usage and broadcast.
+     * Handles billingType inference.
+     */
+    updateApiUsage(usage: ApiUsageData): void;
+    /** Fetch usage from API and update cache. Returns true if successful. */
+    fetchAndUpdateUsage(): Promise<boolean>;
+    /** Fetch usage if cache is stale or empty (best-effort, no throw) */
+    fetchUsageIfStale(): Promise<void>;
+    startOllamaProbe(intervalMs?: number): void;
+    startMlxProbe(intervalMs?: number): void;
+    startAntigravityProbe(intervalMs?: number): void;
+    startGatewayProbe(intervalMs: number, onAppeared?: () => void, onDisappeared?: () => void): void;
+    startGatewayHealthCheck(intervalMs?: number, delayMs?: number): void;
+    /**
+     * Start periodic usage tick (session timer on displays).
+     * Also clears stale cache after USAGE_STALE_TTL.
+     */
+    startUsageTick(intervalMs?: number): void;
+    /**
+     * Start periodic API usage refresh.
+     * @param fetchFn Custom fetch function (for daemon relay). Defaults to direct API.
+     */
+    startApiUsagePolling(intervalMs: number, fetchFn?: () => Promise<ApiUsageData | null>): void;
+    /** Start periodic sessions_list broadcast */
+    startSessionsListPolling(intervalMs?: number): void;
+    /** Register a callback to enrich the sessions list before broadcast */
+    setSessionsEnricher(fn: (sessions: import('./session-aggregator.js').EnrichedSession[]) => import('./session-aggregator.js').EnrichedSession[]): void;
+    /** Register daemon module-health provider for dashboard diagnostics. */
+    setModuleHealthProvider(fn: () => Record<string, unknown>): void;
+    /** Register a provider for non-WS client count (e.g., ESP32 serial connections).
+     *  Used to keep sessions_list polling alive even without WebSocket clients. */
+    setExternalClientCountProvider(fn: () => number): void;
+    /** Check if any client (WS or external serial) is connected */
+    private hasClients;
+    /** Broadcast enriched sessions list (debounced 2s from state_changed) */
+    broadcastSessionsList(): Promise<void>;
+    /** Debounced sessions list broadcast (for state_changed handler) */
+    maybeBroadcastSessionsList(): void;
+    /**
+     * Send initial state to a newly connected WebSocket client.
+     * Callers can extend by providing extra events to send.
+     */
+    sendInitialState(ws: WebSocket, opts: {
+        agentType: AgentType;
+        agentCapabilities?: AgentCapabilities;
+        isAlive: boolean;
+        extraEvents?: BridgeEvent[];
+    }): void;
+    registerSession(agentType: AgentType, extra?: Record<string, unknown>): void;
+    deregisterSession(): void;
+    /** Attach the APME subsystem. Optional — bridges boot fine without it. */
+    setApme(apme: ApmeModule | null, cwd?: string): void;
+    /** Expose APME for callers that need to ingest hooks / update usage. */
+    getApme(): ApmeModule | null;
+    addInterval(iv: ReturnType<typeof setInterval>): void;
+    addTimeout(to: ReturnType<typeof setTimeout>): void;
+    /** Register a callback to run during shutdown (before process exit). */
+    onShutdown(cb: () => void | Promise<void>): void;
+    /** Register process-level signal handlers for graceful shutdown. */
+    registerProcessHandlers(label: string): void;
+    /** Graceful shutdown */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=bridge-core.d.ts.map

package/dist/bridge-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-core.d.ts","sourceRoot":"","sources":["../src/bridge-core.ts"],"names":[],"mappings":"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"}