@oh-my-pi-zen/omp-stats 16.3.6-zen.1

package/dist/types/client/index.d.ts

@@ -0,0 +1,2 @@
+import "./styles.css";
+import "./data/charts";

package/dist/types/client/routes/BehaviorRoute.d.ts

@@ -0,0 +1,7 @@
+import type { TimeRange } from "../types";
+export interface BehaviorRouteProps {
+    active: boolean;
+    range: TimeRange;
+    refreshTrigger: number;
+}
+export declare function BehaviorRoute({ active, range, refreshTrigger }: BehaviorRouteProps): import("react").JSX.Element;

package/dist/types/client/routes/CostsRoute.d.ts

@@ -0,0 +1,7 @@
+import type { TimeRange } from "../types";
+export interface CostsRouteProps {
+    active: boolean;
+    range: TimeRange;
+    refreshTrigger: number;
+}
+export declare function CostsRoute({ active, range, refreshTrigger }: CostsRouteProps): import("react").JSX.Element;

package/dist/types/client/routes/ErrorsRoute.d.ts

@@ -0,0 +1,8 @@
+import type { TimeRange } from "../types";
+export interface ErrorsRouteProps {
+    active: boolean;
+    range: TimeRange;
+    refreshTrigger: number;
+    onRequestClick: (id: number) => void;
+}
+export declare function ErrorsRoute({ active, refreshTrigger, onRequestClick }: ErrorsRouteProps): import("react").JSX.Element;

package/dist/types/client/routes/GainRoute.d.ts

@@ -0,0 +1,7 @@
+import type { TimeRange } from "../types";
+export interface GainRouteProps {
+    active: boolean;
+    range: TimeRange;
+    refreshTrigger: number;
+}
+export declare function GainRoute({ active, range, refreshTrigger }: GainRouteProps): import("react").JSX.Element;

package/dist/types/client/routes/ModelsRoute.d.ts

@@ -0,0 +1,7 @@
+import type { TimeRange } from "../types";
+export interface ModelsRouteProps {
+    active: boolean;
+    range: TimeRange;
+    refreshTrigger: number;
+}
+export declare function ModelsRoute({ active, range, refreshTrigger }: ModelsRouteProps): import("react").JSX.Element;

package/dist/types/client/routes/OverviewRoute.d.ts

@@ -0,0 +1,8 @@
+import type { TimeRange } from "../types";
+export interface OverviewRouteProps {
+    active: boolean;
+    range: TimeRange;
+    refreshTrigger: number;
+    onRequestClick: (id: number) => void;
+}
+export declare function OverviewRoute({ active, range, refreshTrigger, onRequestClick }: OverviewRouteProps): import("react").JSX.Element;

package/dist/types/client/routes/ProjectsRoute.d.ts

@@ -0,0 +1,7 @@
+import type { TimeRange } from "../types";
+export interface ProjectsRouteProps {
+    active: boolean;
+    range: TimeRange;
+    refreshTrigger: number;
+}
+export declare function ProjectsRoute({ active, range, refreshTrigger }: ProjectsRouteProps): import("react").JSX.Element;

package/dist/types/client/routes/RequestsRoute.d.ts

@@ -0,0 +1,8 @@
+import type { TimeRange } from "../types";
+export interface RequestsRouteProps {
+    active: boolean;
+    range: TimeRange;
+    refreshTrigger: number;
+    onRequestClick: (id: number) => void;
+}
+export declare function RequestsRoute({ active, refreshTrigger, onRequestClick }: RequestsRouteProps): import("react").JSX.Element;

package/dist/types/client/routes/ToolsRoute.d.ts

@@ -0,0 +1,7 @@
+import type { TimeRange } from "../types";
+export interface ToolsRouteProps {
+    active: boolean;
+    range: TimeRange;
+    refreshTrigger: number;
+}
+export declare function ToolsRoute({ active, range, refreshTrigger }: ToolsRouteProps): import("react").JSX.Element;

package/dist/types/client/routes/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./BehaviorRoute";
+export * from "./CostsRoute";
+export * from "./ErrorsRoute";
+export * from "./GainRoute";
+export * from "./ModelsRoute";
+export * from "./OverviewRoute";
+export * from "./ProjectsRoute";
+export * from "./RequestsRoute";
+export * from "./ToolsRoute";

package/dist/types/client/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Client-side type definitions.
+ *
+ * Shared shapes (aggregations, time-series, dashboard payloads) live in
+ * `../shared-types` and are re-exported here. The types declared inline below
+ * are deliberately client-only because:
+ *   - `Usage` is redeclared locally so the client bundle avoids importing
+ *     `@oh-my-pi-zen/pi-ai` (the server-side AI types package).
+ *   - `MessageStats.stopReason` is widened from the server's `StopReason`
+ *     enum to `string`, again to keep the client free of pi-ai types.
+ *   - `TimeRange`, `OverviewStats`, `ModelDashboardStats`,
+ *     `CostDashboardStats` are UI-only view shapes the server never produces.
+ */
+import type { AgentTypeStats, AggregatedStats, CostTimeSeriesPoint, ModelPerformancePoint, ModelStats, ModelTimeSeriesPoint, TimeSeriesPoint } from "../shared-types";
+export * from "../shared-types";
+export interface Usage {
+    input: number;
+    output: number;
+    cacheRead: number;
+    cacheWrite: number;
+    totalTokens: number;
+    premiumRequests?: number;
+    cost: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+        total: number;
+    };
+}
+export interface MessageStats {
+    id?: number;
+    sessionFile: string;
+    entryId: string;
+    folder: string;
+    model: string;
+    provider: string;
+    api: string;
+    timestamp: number;
+    duration: number | null;
+    ttft: number | null;
+    stopReason: string;
+    errorMessage: string | null;
+    usage: Usage;
+}
+export interface RequestDetails extends MessageStats {
+    messages: unknown[];
+    output: unknown;
+}
+export type TimeRange = "1h" | "24h" | "7d" | "30d" | "90d" | "all";
+export interface OverviewStats {
+    overall: AggregatedStats;
+    byAgentType: AgentTypeStats[];
+    timeSeries: TimeSeriesPoint[];
+}
+export interface ModelDashboardStats {
+    byModel: ModelStats[];
+    modelSeries: ModelTimeSeriesPoint[];
+    modelPerformanceSeries: ModelPerformancePoint[];
+}
+export interface CostDashboardStats {
+    costSeries: CostTimeSeriesPoint[];
+}

package/dist/types/client/ui/AsyncBoundary.d.ts

@@ -0,0 +1,12 @@
+import type React from "react";
+export interface AsyncBoundaryProps {
+    loading: boolean;
+    error: Error | null;
+    data: unknown | null;
+    empty?: boolean;
+    emptyText?: string;
+    fallback?: React.ReactNode;
+    onRetry?: () => void;
+    children: React.ReactNode;
+}
+export declare function AsyncBoundary({ loading, error, data, empty, emptyText, fallback, onRetry, children, }: AsyncBoundaryProps): React.JSX.Element;

package/dist/types/client/ui/DataTable.d.ts

@@ -0,0 +1,17 @@
+import type React from "react";
+export interface DataTableColumn<T> {
+    key: string;
+    header: React.ReactNode;
+    render?: (item: T) => React.ReactNode;
+    className?: string;
+    numeric?: boolean;
+}
+export interface DataTableProps<T> {
+    columns: DataTableColumn<T>[];
+    data: T[];
+    keyExtractor: (item: T) => string | number;
+    onRowClick?: (item: T) => void;
+    renderMobileCard?: (item: T, onClick?: () => void) => React.ReactNode;
+    emptyText?: string;
+}
+export declare function DataTable<T>({ columns, data, keyExtractor, onRowClick, renderMobileCard, emptyText, }: DataTableProps<T>): React.JSX.Element;

package/dist/types/client/ui/EmptyState.d.ts

@@ -0,0 +1,7 @@
+import { type LucideIcon } from "lucide-react";
+export interface EmptyStateProps {
+    message?: string;
+    icon?: LucideIcon;
+    className?: string;
+}
+export declare function EmptyState({ message, icon: Icon, className }: EmptyStateProps): import("react").JSX.Element;

package/dist/types/client/ui/ErrorState.d.ts

@@ -0,0 +1,6 @@
+export interface ErrorStateProps {
+    error?: Error | null;
+    onRetry?: () => void;
+    className?: string;
+}
+export declare function ErrorState({ error, onRetry, className }: ErrorStateProps): import("react").JSX.Element;

package/dist/types/client/ui/JsonBlock.d.ts

@@ -0,0 +1,7 @@
+import type React from "react";
+export interface JsonBlockProps {
+    data: unknown;
+    title?: string;
+    initialCollapsed?: boolean;
+}
+export declare function JsonBlock({ data, title, initialCollapsed }: JsonBlockProps): React.JSX.Element;

package/dist/types/client/ui/MetricCluster.d.ts

@@ -0,0 +1,5 @@
+import type { AggregatedStats } from "../types";
+export interface MetricClusterProps {
+    stats: AggregatedStats;
+}
+export declare function MetricCluster({ stats }: MetricClusterProps): import("react").JSX.Element;

package/dist/types/client/ui/Panel.d.ts

@@ -0,0 +1,7 @@
+import type React from "react";
+export interface PanelProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title"> {
+    title?: React.ReactNode;
+    subtitle?: React.ReactNode;
+    actions?: React.ReactNode;
+}
+export declare function Panel({ title, subtitle, actions, children, className, ...props }: PanelProps): React.JSX.Element;

package/dist/types/client/ui/RequestDrawer.d.ts

@@ -0,0 +1,5 @@
+export interface RequestDrawerProps {
+    id: number | null;
+    onClose: () => void;
+}
+export declare function RequestDrawer({ id, onClose }: RequestDrawerProps): import("react").JSX.Element | null;

package/dist/types/client/ui/SegmentedControl.d.ts

@@ -0,0 +1,12 @@
+export interface SegmentedControlOption<T> {
+    value: T;
+    label: string;
+    title?: string;
+}
+export interface SegmentedControlProps<T> {
+    options: SegmentedControlOption<T>[];
+    value: T;
+    onChange: (value: T) => void;
+    className?: string;
+}
+export declare function SegmentedControl<T>({ options, value, onChange, className }: SegmentedControlProps<T>): import("react").JSX.Element;

package/dist/types/client/ui/Skeleton.d.ts

@@ -0,0 +1,8 @@
+import type React from "react";
+export interface SkeletonProps {
+    variant?: "text" | "rect" | "circle";
+    width?: string | number;
+    height?: string | number;
+    className?: string;
+}
+export declare function Skeleton({ variant, width, height, className }: SkeletonProps): React.JSX.Element;

package/dist/types/client/ui/StatusPill.d.ts

@@ -0,0 +1,7 @@
+import type React from "react";
+export interface StatusPillProps {
+    variant: "success" | "danger" | "warning" | "info" | "default";
+    children: React.ReactNode;
+    className?: string;
+}
+export declare function StatusPill({ variant, children, className }: StatusPillProps): React.JSX.Element;

package/dist/types/client/ui/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./AsyncBoundary";
+export * from "./DataTable";
+export * from "./EmptyState";
+export * from "./ErrorState";
+export * from "./JsonBlock";
+export * from "./MetricCluster";
+export * from "./Panel";
+export * from "./RequestDrawer";
+export * from "./SegmentedControl";
+export * from "./Skeleton";
+export * from "./StatusPill";

package/dist/types/client/useSystemTheme.d.ts

@@ -0,0 +1,11 @@
+export type SystemTheme = "light" | "dark";
+export type ThemePreference = "system" | "light" | "dark";
+export declare function setThemePreference(next: ThemePreference): void;
+/** Reader for the active resolved theme. Reflects system default and overrides. */
+export declare function useSystemTheme(): SystemTheme;
+/** Reader + writer for the theme preference (powers the toggle). */
+export declare function useThemePreference(): {
+    preference: ThemePreference;
+    resolved: SystemTheme;
+    setPreference: (next: ThemePreference) => void;
+};

package/dist/types/db.d.ts

@@ -0,0 +1,144 @@
+import { Database } from "bun:sqlite";
+import type { AgentTypeStats, AggregatedStats, BehaviorModelStats, BehaviorOverallStats, BehaviorTimeSeriesPoint, CostTimeSeriesPoint, FolderStats, MessageStats, ModelPerformancePoint, ModelStats, ModelTimeSeriesPoint, TimeSeriesPoint, ToolCallStats, ToolModelStats, ToolResultLink, ToolTimeSeriesPoint, ToolUsageStats, UserMessageLink, UserMessageStats } from "./types";
+/**
+ * Initialize the database and create tables.
+ */
+export declare function initDb(): Promise<Database>;
+/**
+ * Get the stored offset for a session file.
+ */
+export declare function getFileOffset(sessionFile: string): {
+    offset: number;
+    lastModified: number;
+} | null;
+/**
+ * Update the stored offset for a session file.
+ */
+export declare function setFileOffset(sessionFile: string, offset: number, lastModified: number): void;
+/**
+ * Insert message stats into the database.
+ *
+ * Forked / branched sessions (see `SessionManager.fork()` and
+ * `createBranchedSession()` in `@oh-my-pi-zen/pi-coding-agent`) deep-copy a parent
+ * session's entries into a new JSONL — same `entry_id`, `timestamp`, `model`,
+ * `provider`, token counts, and `responseId`. The `UNIQUE(session_file,
+ * entry_id)` constraint alone keys each row by file, so without the guard
+ * below the same provider request would land twice and inflate every
+ * aggregate. The `WHERE NOT EXISTS` clause skips inserts whose
+ * `(entry_id, timestamp)` already exists under a different `session_file` —
+ * first-write-wins across the lineage. Same-file re-syncs still hit the
+ * `ON CONFLICT(session_file, entry_id)` upsert below so historical
+ * `premium_requests` fix-ups continue to work.
+ */
+export declare function insertMessageStats(stats: MessageStats[]): number;
+/**
+ * Get overall aggregated stats.
+ */
+export declare function getOverallStats(cutoff?: number): AggregatedStats;
+/**
+ * Get stats grouped by model.
+ */
+export declare function getStatsByModel(cutoff?: number): ModelStats[];
+/**
+ * Get stats grouped by folder.
+ */
+export declare function getStatsByFolder(cutoff?: number): FolderStats[];
+/**
+ * Get token usage grouped by agent type (main agent, task subagents, advisor).
+ * Token columns are explicit so the dashboard's share denominator matches the
+ * counts it renders. Rows missing `agent_type` (defensive) fall back to "main".
+ */
+export declare function getStatsByAgentType(cutoff?: number): AgentTypeStats[];
+/**
+ * Get time series data.
+ */
+export declare function getTimeSeries(hours?: number, cutoff?: number | null, bucketMs?: number): TimeSeriesPoint[];
+/**
+ * Get daily performance time series data for the last N days.
+ */
+/**
+ * Get daily model usage time series data for the last N days.
+ */
+export declare function getModelTimeSeries(days?: number, cutoff?: number | null, bucketMs?: number): ModelTimeSeriesPoint[];
+/**
+ * Get daily model performance time series data for the last N days.
+ */
+export declare function getModelPerformanceSeries(days?: number, cutoff?: number | null, bucketMs?: number): ModelPerformancePoint[];
+/**
+ * Get total message count.
+ */
+export declare function getMessageCount(): number;
+/**
+ * Close the database connection.
+ */
+export declare function closeDb(): void;
+export declare function getRecentRequests(limit?: number): MessageStats[];
+export declare function getRecentErrors(limit?: number): MessageStats[];
+export declare function getMessageById(id: number): MessageStats | null;
+/**
+ * Get daily cost time series data for the last N days, broken down by model.
+ */
+export declare function getCostTimeSeries(days?: number, cutoff?: number | null): CostTimeSeriesPoint[];
+export declare function markPriorityPremiumRequestsBackfillComplete(): void;
+export declare function markUserMessagesBackfillComplete(): void;
+export declare function markUserMessageLinksRepairComplete(): void;
+/**
+ * Insert user-message stats. Idempotent via UNIQUE(session_file, entry_id).
+ * The `WHERE NOT EXISTS` clause matches {@link insertMessageStats}: forks
+ * copy user entries verbatim into the child JSONL, so the same
+ * `(entry_id, timestamp)` must not land twice across different session files.
+ */
+export declare function insertUserMessageStats(stats: UserMessageStats[]): number;
+/**
+ * Backfill the responding `model`/`provider` on user-message rows that were
+ * persisted before their assistant reply was parsed (a side effect of
+ * incremental `fromOffset` syncing: the `userByEntryId` map in
+ * `parseSessionFile` only spans a single pass). Each row is updated at most
+ * once because the `model IS NULL` guard short-circuits subsequent passes.
+ *
+ * Returns the number of rows actually updated.
+ */
+export declare function updateUserMessageLinks(links: UserMessageLink[]): number;
+/**
+ * Daily behavioral time series, grouped by responding model+provider.
+ */
+export declare function getBehaviorTimeSeries(cutoff?: number | null): BehaviorTimeSeriesPoint[];
+/**
+ * Overall behavioral totals across the cutoff window.
+ */
+export declare function getBehaviorOverall(cutoff?: number | null): BehaviorOverallStats;
+/**
+ * Per-model behavioral totals over the cutoff window. "Unknown" represents
+ * user messages that never received an assistant reply.
+ */
+export declare function getBehaviorByModel(cutoff?: number | null): BehaviorModelStats[];
+/**
+ * Insert tool-call rows. Idempotent via UNIQUE(session_file, tool_call_id);
+ * the `WHERE NOT EXISTS` guard mirrors {@link insertMessageStats}: forked
+ * sessions deep-copy assistant entries (same `entry_id`, `timestamp`, and
+ * tool-call ids under a new file), so first-write-wins across the lineage
+ * keeps aggregates from double counting. Keyed on the assistant entry
+ * identity, not the call id alone — provider call ids are not a global
+ * namespace across unrelated sessions.
+ */
+export declare function insertToolCalls(calls: ToolCallStats[]): number;
+/**
+ * Attach result size / error flag to persisted tool-call rows. Results can
+ * land in a later incremental sync pass than the call that produced them, so
+ * this is an UPDATE keyed by (session_file, tool_call_id). The `IS NULL`
+ * guard makes re-syncs idempotent; rows skipped by the fork guard simply
+ * never match.
+ */
+export declare function updateToolResults(links: ToolResultLink[]): number;
+/**
+ * Get tool usage aggregated by tool name.
+ */
+export declare function getToolStats(cutoff?: number): ToolUsageStats[];
+/**
+ * Get tool usage aggregated by (tool, model, provider).
+ */
+export declare function getToolStatsByModel(cutoff?: number): ToolModelStats[];
+/**
+ * Get tool-call time series (one point per bucket per tool).
+ */
+export declare function getToolTimeSeries(days?: number, cutoff?: number | null, bucketMs?: number): ToolTimeSeriesPoint[];

package/dist/types/embedded-client.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Embedded stats dashboard archive handling.
+ *
+ * `embedded-client.generated.txt` holds the base64 of a gzipped tar of the
+ * built dashboard (`dist/client`). It is populated by
+ * `gen:stats` for compiled binaries and the
+ * prepacked npm bundle, and reset to an empty file afterwards so the dev tree
+ * keeps building the dashboard from source.
+ */
+/**
+ * Decode the generated archive text.
+ *
+ * Returns `null` when the content is blank or not a raw gzip archive encoded as
+ * base64 — notably the legacy placeholder that contained a TypeScript
+ * `export const … = "";` stub, which must be treated as "no archive embedded"
+ * rather than decoded into garbage bytes.
+ */
+export declare function decodeEmbeddedClientArchive(txt: string): Buffer | null;

package/dist/types/gain-aggregator.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Aggregates token-savings data for the Gain dashboard.
+ *
+ * Source:
+ *   1. Snapcompact: colocated with stats.db as snapcompact-savings.jsonl
+ *
+ * Missing files are treated as zero records — never an error.
+ */
+import type { GainDashboardStats } from "./shared-types";
+/**
+ * Collapse conventional worktree sub-paths to their logical project root.
+ *
+ * Rules are generic: omp internal wt paths are dropped; conventional worktree
+ * suffixes (`.wt/`, `-wt/`, `.worktrees/`, `-worktrees/`) are stripped. No
+ * author-specific IDE or tool paths are baked in.
+ *
+ * Returns null to drop temp/internal paths entirely.
+ */
+export declare function normalizeProjectPath(p: string): string | null;
+/**
+ * Given a raw set of paths, normalize worktree paths and remove sub-paths
+ * that are already covered by a shorter parent at depth ≥ 4.
+ * Returns a sorted, deduped list of meaningful project roots.
+ */
+export declare function dedupeProjects(rawPaths: Set<string>): string[];
+export declare function getGainDashboardStats(range?: string | null, project?: string | null): Promise<GainDashboardStats>;

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env bun
+export { getDashboardStats, getToolDashboardStats, getTotalMessageCount, type SyncOptions, type SyncProgress, smokeTestSyncWorker, syncAllSessions, } from "./aggregator";
+export { closeDb } from "./db";
+export { getGainDashboardStats } from "./gain-aggregator";
+export { startServer } from "./server";
+export type { GainDashboardStats, GainSource, GainSourceTotals, GainTimeSeriesPoint, } from "./shared-types";
+export type { AggregatedStats, DashboardStats, FolderStats, MessageStats, ModelPerformancePoint, ModelStats, ModelTimeSeriesPoint, TimeSeriesPoint, ToolDashboardStats, ToolModelStats, ToolTimeSeriesPoint, ToolUsageStats, } from "./types";

package/dist/types/parser.d.ts

@@ -0,0 +1,53 @@
+import type { AgentType, MessageStats, SessionEntry, ToolCallStats, ToolResultLink, UserMessageLink, UserMessageStats } from "./types";
+/**
+ * Classify which agent produced a transcript from its path within the sessions
+ * directory. Layout: `<sessionsDir>/<project>/<file>.jsonl` is the `main`
+ * agent; subagent and advisor transcripts live nested one level deeper inside
+ * the session's artifacts dir (`<project>/<session>/<id>.jsonl`,
+ * `<project>/<session>/__advisor.jsonl`). Any advisor transcript
+ * (`__advisor.jsonl` or `__advisor.<slug>.jsonl`) — at any depth, including a
+ * subagent's own advisor — counts as `advisor`; every other nested transcript
+ * is a task `subagent`.
+ */
+export declare function classifyAgentType(sessionPath: string): AgentType;
+/**
+ * Parse a session file and extract all assistant message stats.
+ * Uses incremental reading with offset tracking.
+ *
+ * Service-tier carry-over: `currentServiceTier` is a session-scoped piece of
+ * state derived from `service_tier_change` entries that affects whether
+ * subsequent OpenAI assistant replies count as premium requests. Incremental
+ * syncs that resume past the most-recent tier change would otherwise lose
+ * that state and silently record `premiumRequests = 0` for priority traffic
+ * (the coding-agent stopped folding the tier into `usage.premiumRequests`
+ * after 13f59162e — the parser is now the sole source of truth). When
+ * `fromOffset > 0` we therefore scan the bytes preceding `fromOffset`
+ * for the latest service-tier value before parsing the unprocessed tail.
+ * The scan only keeps the current tier and does not materialize prefix
+ * entries, preserving offset-based memory behavior for large sessions.
+ */
+export interface ParseSessionResult {
+    stats: MessageStats[];
+    userStats: UserMessageStats[];
+    userLinks: UserMessageLink[];
+    toolCalls: ToolCallStats[];
+    toolResults: ToolResultLink[];
+    newOffset: number;
+}
+export declare function parseSessionFile(sessionPath: string, fromOffset?: number): Promise<ParseSessionResult>;
+/**
+ * List all session directories (folders).
+ */
+export declare function listSessionFolders(): Promise<string[]>;
+/**
+ * List all session files in a folder.
+ */
+export declare function listSessionFiles(folderPath: string): Promise<string[]>;
+/**
+ * List all session files across all folders.
+ */
+export declare function listAllSessionFiles(): Promise<string[]>;
+/**
+ * Find a specific entry in a session file.
+ */
+export declare function getSessionEntry(sessionPath: string, entryId: string): Promise<SessionEntry | null>;

package/dist/types/server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Start the HTTP server.
+ */
+export declare function startServer(port?: number): Promise<{
+    port: number;
+    stop: () => void;
+}>;