@wizeworks/lens-hub 0.0.0-stage → 0.3.0-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WizeWorks LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,61 @@
-# Temporary Holding Version
+# @wizeworks/lens-hub
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The local hub of [WizeLens](https://github.com/brandonkorous/wizelens): one place for the traces and metrics of every service on your
+machine or team network, with the full dashboard, OTLP intake (traces, logs, and metrics), and a read-only MCP endpoint.
+
+```bash
+npx @wizeworks/lens-hub
+# or
+docker run -p 5960:5960 -v wizelens:/data ghcr.io/brandonkorous/wizelens-hub
+```
+
+Open http://localhost:5960/_wizelens/. Then point your services at it and restart them:
+
+```bash
+WIZELENS_HUB=http://localhost:5960                  # WizeLens add-ons (.NET and Node)
+WIZELENS_PROJECT=my-shop                            # optional: group services by project
+OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:5960   # any OpenTelemetry app
+```
+
+## Options
+
+| Flag | Environment variable | Default |
+|---|---|---|
+| `--port <n>` | `WIZELENS_HUB_PORT` | `5960` |
+| `--host <addr>` | `WIZELENS_HUB_HOST` | `127.0.0.1` (this machine only) |
+| `--data <file>` | `WIZELENS_HUB_DATA` | `~/.wizelens/hub/hub.db` (`memory` for none) |
+| `--token <text>` | `WIZELENS_HUB_TOKEN` | none |
+| `--retention <time>` | `WIZELENS_HUB_RETENTION` | `7d` |
+| `--max-traces <n>` | `WIZELENS_HUB_MAX_TRACES` | `50000` |
+| `--max-metric-points <n>` | `WIZELENS_HUB_MAX_METRIC_POINTS` | `2000000` raw points (they are also kept for `--retention`; rollups are not capped) |
+| `--mcp` | `WIZELENS_HUB_MCP=1` | off |
+| `--import <file>` | | Copy an add-on's `.wizelens/traces.db` in at start |
+
+To share the hub with a team, run it with `--host 0.0.0.0 --token <text>`. Services send `WIZELENS_HUB_TOKEN`; OTLP apps send
+`OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer <text>`; in a browser, open `/_wizelens/?token=<text>` once.
+
+## Stats
+
+The dashboard asks the hub for whole pages (`GET /_wizelens/api/models/{page}?range=&project=&env=`), computed from stats tables
+in the hub file: per-trace facts and rollups in 10 s, 5 min, and 1 h buckets. Ranges reach the hub's `--retention`. Traces are
+settled a few seconds after their last span (every 2 s, at most 150 ms at a time); pages say "Preparing stats" while traces wait.
+Files from older hubs upgrade when opened and backfill, newest traces first. See `docs/CONTRACT.md`, "Stats tables".
+
+## Metrics
+
+OpenTelemetry apps send metrics to `POST /v1/metrics` (JSON or protobuf): gauges, sums, histograms, exponential histograms
+(kept as explicit buckets), and summaries (kept as count and sum). WizeLens add-ons send theirs in their batches. The Metrics page
+reads `GET /_wizelens/api/models/metrics?range=1h&project=&env=&service=&metric=&group=&stat=&q=`, computed in the hub from
+metric rollups (per series, in 10 s, 5 min, and 1 h buckets, written as points arrive), so every range reads all of its points.
+With `--mcp`, agents get `list_metrics` and `get_metric`.
+
+## In code
+
+```ts
+import { createHub } from "@wizeworks/lens-hub";
+
+const hub = createHub({ port: 5960, storagePath: "./hub.db" });
+console.log(await hub.listen());
+```
+
+The wire format is in [CONTRACT.md](https://github.com/brandonkorous/wizelens/blob/main/docs/CONTRACT.md#local-hub-v06-phase-2). MIT licensed.

package/dist/api.d.ts

@@ -0,0 +1,20 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import { type ServiceInfo } from "@wizeworks/lens-core";
+import type { HubData } from "./data.js";
+import type { ResolvedHubOptions } from "./options.js";
+import { type TraceQuery } from "./store-read.js";
+export interface ApiContext {
+    data: HubData;
+    o: ResolvedHubOptions;
+    version: string;
+    startedMs: number;
+}
+export declare function hubInfo(c: ApiContext): ServiceInfo;
+/** `api/traces`: summaries by default, full traces with `full=true`. Filters: since, before, env, project, session. */
+export declare function queryOf(p: URLSearchParams): {
+    q: TraceQuery;
+    full: boolean;
+};
+/** The hub API below `/_wizelens/`. */
+export declare function handleApi(c: ApiContext, sub: string, req: IncomingMessage, res: ServerResponse, url: URL): Promise<void>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD,OAAO,EAAuC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEvF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,CAAC,EAAE,kBAAkB,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD,wBAAgB,OAAO,CAAC,CAAC,EAAE,UAAU,GAAG,WAAW,CAclD;AAED,uHAAuH;AACvH,wBAAgB,OAAO,CAAC,CAAC,EAAE,eAAe,GAAG;IAAE,CAAC,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAM5E;AAmCD,uCAAuC;AACvC,wBAAsB,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAc9H"}

package/dist/api.js

@@ -0,0 +1,90 @@
+import { hostname } from "node:os";
+import { HEADER_HOP } from "@wizeworks/lens-core";
+import { DEFAULT_N_PLUS_ONE, DEFAULT_SLOW_QUERY_MS, firstHeader, sendJson, VERSION as NODE_VERSION } from "@wizeworks/lens-node/kit";
+import { parseJson, readBody } from "./body.js";
+import { parseIngest } from "./ingest.js";
+import { metricParams, metricsPage, rangeOf } from "./metrics-read.js";
+import { sendPageModel } from "./models-api.js";
+import { countRows, distinctOf, listServices } from "./store-read.js";
+const clamp = (v, min, max) => Math.min(max, Math.max(min, v));
+const num = (p, k) => (p.has(k) && Number.isFinite(Number(p.get(k))) ? Number(p.get(k)) : undefined);
+export function hubInfo(c) {
+    return {
+        mode: "hub",
+        capabilities: ["federation", "environments", "registry", "metrics", "serverMetrics", "serverStats"],
+        service: c.o.name,
+        version: c.version,
+        runtime: `node ${process.version} · lens-node ${NODE_VERSION}`,
+        mcp: c.o.enableMcp,
+        host: hostname(),
+        startedMs: c.startedMs,
+        storage: { kind: "sqlite", maxTraces: c.o.maxTraces, maxAgeMs: c.o.maxAgeMs },
+        analysis: { slowQueryMs: DEFAULT_SLOW_QUERY_MS, nPlusOneThreshold: DEFAULT_N_PLUS_ONE },
+        redactKeys: [...c.o.redactKeys],
+    };
+}
+/** `api/traces`: summaries by default, full traces with `full=true`. Filters: since, before, env, project, session. */
+export function queryOf(p) {
+    const full = p.get("full") === "true";
+    const limit = clamp(num(p, "limit") ?? (full ? 1000 : 50), 1, full ? 5000 : 1000);
+    const q = { limit, since: num(p, "since"), before: num(p, "before") };
+    for (const k of ["env", "project", "session"])
+        q[k] = p.get(k) || undefined;
+    return { q, full };
+}
+function services(c) {
+    const db = c.data.store.db;
+    return {
+        services: listServices(db, c.o.now()),
+        environments: distinctOf(db, "env"),
+        projects: distinctOf(db, "project"),
+        ...countRows(db),
+    };
+}
+async function ingest(c, req, res) {
+    try {
+        const w = parseIngest(parseJson(await readBody(req)), c.o.redactKeys);
+        if (!w)
+            return sendJson(res, 400, { error: "sender.service is required" });
+        c.data.write(w);
+        res.writeHead(204).end();
+    }
+    catch {
+        sendJson(res, 400, { error: "invalid body" });
+    }
+}
+function metrics(c, p) {
+    const scope = { project: p.get("project") || undefined, env: p.get("env") || undefined };
+    return metricsPage(c.data.store.db, rangeOf(p.get("range")), scope, metricParams(p), c.o.now());
+}
+async function sendTrace(c, traceId, req, res, url) {
+    const hop = Number(firstHeader(req.headers[HEADER_HOP.toLowerCase()])) || 0;
+    const t = await c.data.getTrace(traceId, url.searchParams.get("federate") === "true", hop);
+    if (t)
+        sendJson(res, 200, t);
+    else
+        sendJson(res, 404, { error: "trace not found" });
+}
+/** The hub API below `/_wizelens/`. */
+export async function handleApi(c, sub, req, res, url) {
+    const method = req.method ?? "GET";
+    if (sub === "api/info" && method === "GET")
+        return sendJson(res, 200, hubInfo(c));
+    if (sub === "api/services" && method === "GET")
+        return sendJson(res, 200, services(c));
+    if (sub === "api/ingest" && method === "POST")
+        return ingest(c, req, res);
+    if (sub === "api/traces" && method === "GET") {
+        const { q, full } = queryOf(url.searchParams);
+        return sendJson(res, 200, full ? c.data.traces(q) : c.data.summaries(q));
+    }
+    if (sub === "api/models/metrics" && method === "GET")
+        return sendJson(res, 200, metrics(c, url.searchParams));
+    if (sub.startsWith("api/models/") && method === "GET")
+        return sendPageModel(c, sub.slice("api/models/".length), url.searchParams, res);
+    const m = /^api\/traces\/([0-9a-f]{32})$/.exec(sub);
+    if (m && method === "GET")
+        return sendTrace(c, m[1], req, res, url);
+    sendJson(res, 404, { error: "not found" });
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/auth.d.ts

@@ -0,0 +1,9 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+export declare const COOKIE = "wizelens_hub";
+/** True when no token is set, or the call carries it (bearer header or the dashboard cookie). */
+export declare function isAllowed(req: IncomingMessage, token: string | undefined): boolean;
+/** `?token=` on a dashboard page: keep it in a cookie, then drop it from the address bar. True when handled. */
+export declare function acceptTokenLink(url: URL, token: string | undefined, res: ServerResponse): boolean;
+/** Answer a call without the token: JSON for the API, a small sign-in page for the dashboard. */
+export declare function deny(res: ServerResponse, api: boolean, url: URL): void;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,eAAO,MAAM,MAAM,iBAAiB,CAAC;AAgBrC,iGAAiG;AACjG,wBAAgB,SAAS,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAMlF;AAED,gHAAgH;AAChH,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAYjG;AAUD,iGAAiG;AACjG,wBAAgB,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,CAMtE"}

package/dist/auth.js

@@ -0,0 +1,55 @@
+import { timingSafeEqual } from "node:crypto";
+export const COOKIE = "wizelens_hub";
+const same = (a, b) => {
+    const x = Buffer.from(a);
+    const y = Buffer.from(b);
+    return x.length === y.length && timingSafeEqual(x, y);
+};
+function cookieOf(req) {
+    for (const part of String(req.headers.cookie ?? "").split(";")) {
+        const [k, ...v] = part.trim().split("=");
+        if (k === COOKIE)
+            return decodeURIComponent(v.join("="));
+    }
+    return undefined;
+}
+/** True when no token is set, or the call carries it (bearer header or the dashboard cookie). */
+export function isAllowed(req, token) {
+    if (!token)
+        return true;
+    const auth = String(req.headers.authorization ?? "");
+    const bearer = auth.toLowerCase().startsWith("bearer ") ? auth.slice(7).trim() : undefined;
+    const given = bearer ?? cookieOf(req);
+    return given !== undefined && same(given, token);
+}
+/** `?token=` on a dashboard page: keep it in a cookie, then drop it from the address bar. True when handled. */
+export function acceptTokenLink(url, token, res) {
+    const given = url.searchParams.get("token");
+    if (!token || given === null)
+        return false;
+    url.searchParams.delete("token");
+    const target = `${url.pathname}${url.search}`;
+    if (!same(given, token)) {
+        res.writeHead(302, { Location: `${target}${url.search ? "&" : "?"}denied=1` }).end();
+        return true;
+    }
+    const cookie = `${COOKIE}=${encodeURIComponent(given)}; Path=/; HttpOnly; SameSite=Strict; Max-Age=2592000`;
+    res.writeHead(302, { Location: target, "Set-Cookie": cookie }).end();
+    return true;
+}
+const LOGIN = (denied) => `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>WizeLens hub</title><style>body{font-family:system-ui;background:#0f1115;color:#e8eaee;display:grid;place-items:center;min-height:100vh;margin:0}
+form{display:grid;gap:12px;width:min(340px,90vw)}input,button{font:inherit;padding:10px 12px;border-radius:8px;border:1px solid #2a2f3a}
+input{background:#171a21;color:inherit}button{background:#3b82f6;color:#fff;border:0;cursor:pointer}p{margin:0;color:#9aa3b2}.e{color:#f87171}</style></head>
+<body><form method="get"><h1 style="margin:0;font-size:20px">WizeLens hub</h1><p>This hub needs an access token.</p>
+${denied ? '<p class="e">That token is not right.</p>' : ""}<input name="token" type="password" placeholder="Access token" autofocus required aria-label="Access token">
+<button type="submit">Open the dashboard</button></form></body></html>`;
+/** Answer a call without the token: JSON for the API, a small sign-in page for the dashboard. */
+export function deny(res, api, url) {
+    if (api) {
+        res.writeHead(401, { "Content-Type": "application/json", "WWW-Authenticate": "Bearer" }).end(JSON.stringify({ error: "token required" }));
+        return;
+    }
+    res.writeHead(401, { "Content-Type": "text/html; charset=utf-8" }).end(LOGIN(url.searchParams.has("denied")));
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/body.d.ts

@@ -0,0 +1,9 @@
+import type { IncomingMessage } from "node:http";
+/** Most bytes one request body may hold, after unzip. */
+export declare const MAX_BODY: number;
+/** Read the raw body, and unzip it when it is gzip. Throws when it is too large. */
+export declare function readBody(req: IncomingMessage): Promise<Buffer>;
+export declare const isProtobuf: (req: IncomingMessage) => boolean;
+/** Parse a JSON body. Undefined when it is empty. */
+export declare function parseJson(body: Buffer): unknown;
+//# sourceMappingURL=body.d.ts.map

package/dist/body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body.d.ts","sourceRoot":"","sources":["../src/body.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGjD,yDAAyD;AACzD,eAAO,MAAM,QAAQ,QAAmB,CAAC;AAEzC,oFAAoF;AACpF,wBAAsB,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAYpE;AAED,eAAO,MAAM,UAAU,QAAS,eAAe,YAAmE,CAAC;AAEnH,qDAAqD;AACrD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG/C"}

package/dist/body.js

@@ -0,0 +1,25 @@
+import { gunzipSync } from "node:zlib";
+/** Most bytes one request body may hold, after unzip. */
+export const MAX_BODY = 16 * 1024 * 1024;
+/** Read the raw body, and unzip it when it is gzip. Throws when it is too large. */
+export async function readBody(req) {
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of req) {
+        const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        size += buf.length;
+        if (size > MAX_BODY)
+            throw new Error("body too large");
+        chunks.push(buf);
+    }
+    const raw = Buffer.concat(chunks);
+    const gzip = String(req.headers["content-encoding"] ?? "").toLowerCase() === "gzip";
+    return gzip ? gunzipSync(raw, { maxOutputLength: MAX_BODY }) : raw;
+}
+export const isProtobuf = (req) => String(req.headers["content-type"] ?? "").includes("protobuf");
+/** Parse a JSON body. Undefined when it is empty. */
+export function parseJson(body) {
+    const text = body.toString("utf8");
+    return text ? JSON.parse(text) : undefined;
+}
+//# sourceMappingURL=body.js.map

package/dist/body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body.js","sourceRoot":"","sources":["../src/body.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,yDAAyD;AACzD,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEzC,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAoB;IACjD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC;QAC1E,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC;QACnB,IAAI,IAAI,GAAG,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACvD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;IACpF,OAAO,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAoB,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AAEnH,qDAAqD;AACrD,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7C,CAAC"}

package/dist/cli-args.d.ts

@@ -0,0 +1,10 @@
+import type { HubOptions } from "./options.js";
+export declare const USAGE = "wizelens-hub: one place for the traces of every service.\n\nUsage: wizelens-hub [options]\n\n  --port <n>          Port. Default 5960.                      (WIZELENS_HUB_PORT)\n  --host <addr>       Address. Default 127.0.0.1. Use 0.0.0.0\n                      for the network, with --token.           (WIZELENS_HUB_HOST)\n  --data <file>       Hub file, or \"memory\".\n                      Default ~/.wizelens/hub/hub.db.          (WIZELENS_HUB_DATA)\n  --token <text>      Require this token on every call.        (WIZELENS_HUB_TOKEN)\n  --retention <time>  Keep traces this long: 30m, 24h, 7d.\n                      Default 7d.                              (WIZELENS_HUB_RETENTION)\n  --max-traces <n>    Keep at most this many. Default 50000.   (WIZELENS_HUB_MAX_TRACES)\n  --max-metric-points <n>\n                      Keep at most this many metric points.\n                      Default 2000000.                         (WIZELENS_HUB_MAX_METRIC_POINTS)\n  --mcp               Turn on the read-only MCP endpoint.      (WIZELENS_HUB_MCP=1)\n  --import <file>     Copy an add-on's .wizelens/traces.db into\n                      the hub at start. Can repeat.\n  --help              Show this help.\n";
+/** "30m", "24h", "7d", or plain ms. Undefined when it is not valid. */
+export declare function parseDuration(v: string | undefined): number | undefined;
+/** Options from the command line, then from the environment. */
+export type CliOptions = HubOptions & {
+    imports: string[];
+};
+export declare function optionsFromArgs(argv: string[], env: NodeJS.ProcessEnv): CliOptions | "help";
+//# sourceMappingURL=cli-args.d.ts.map

package/dist/cli-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../src/cli-args.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,eAAO,MAAM,KAAK,4rCAoBjB,CAAC;AAIF,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIvE;AAID,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE5D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,UAAU,GAAG,MAAM,CA4B3F"}

package/dist/cli-args.js

@@ -0,0 +1,63 @@
+import { parseArgs } from "node:util";
+import { HUB_TOKEN_ENV } from "@wizeworks/lens-core";
+export const USAGE = `wizelens-hub: one place for the traces of every service.
+
+Usage: wizelens-hub [options]
+
+  --port <n>          Port. Default 5960.                      (WIZELENS_HUB_PORT)
+  --host <addr>       Address. Default 127.0.0.1. Use 0.0.0.0
+                      for the network, with --token.           (WIZELENS_HUB_HOST)
+  --data <file>       Hub file, or "memory".
+                      Default ~/.wizelens/hub/hub.db.          (WIZELENS_HUB_DATA)
+  --token <text>      Require this token on every call.        (WIZELENS_HUB_TOKEN)
+  --retention <time>  Keep traces this long: 30m, 24h, 7d.
+                      Default 7d.                              (WIZELENS_HUB_RETENTION)
+  --max-traces <n>    Keep at most this many. Default 50000.   (WIZELENS_HUB_MAX_TRACES)
+  --max-metric-points <n>
+                      Keep at most this many metric points.
+                      Default 2000000.                         (WIZELENS_HUB_MAX_METRIC_POINTS)
+  --mcp               Turn on the read-only MCP endpoint.      (WIZELENS_HUB_MCP=1)
+  --import <file>     Copy an add-on's .wizelens/traces.db into
+                      the hub at start. Can repeat.
+  --help              Show this help.
+`;
+const UNITS = { s: 1000, m: 60_000, h: 3_600_000, d: 86_400_000 };
+/** "30m", "24h", "7d", or plain ms. Undefined when it is not valid. */
+export function parseDuration(v) {
+    const m = /^(\d+(?:\.\d+)?)\s*([smhd]?)$/i.exec(v?.trim() ?? "");
+    if (!m)
+        return undefined;
+    return Number(m[1]) * (m[2] ? UNITS[m[2].toLowerCase()] : 1);
+}
+const int = (v) => (v && /^\d+$/.test(v) ? Number(v) : undefined);
+export function optionsFromArgs(argv, env) {
+    const { values: a } = parseArgs({
+        args: argv,
+        options: {
+            port: { type: "string" },
+            host: { type: "string" },
+            data: { type: "string" },
+            token: { type: "string" },
+            retention: { type: "string" },
+            "max-traces": { type: "string" },
+            "max-metric-points": { type: "string" },
+            mcp: { type: "boolean" },
+            import: { type: "string", multiple: true },
+            help: { type: "boolean", short: "h" },
+        },
+    });
+    if (a.help)
+        return "help";
+    return {
+        port: int(a.port ?? env.WIZELENS_HUB_PORT),
+        host: a.host ?? env.WIZELENS_HUB_HOST,
+        storagePath: a.data ?? env.WIZELENS_HUB_DATA,
+        token: a.token ?? env[HUB_TOKEN_ENV],
+        maxAgeMs: parseDuration(a.retention ?? env.WIZELENS_HUB_RETENTION),
+        maxTraces: int(a["max-traces"] ?? env.WIZELENS_HUB_MAX_TRACES),
+        maxMetricPoints: int(a["max-metric-points"] ?? env.WIZELENS_HUB_MAX_METRIC_POINTS),
+        enableMcp: a.mcp ?? env.WIZELENS_HUB_MCP === "1",
+        imports: a.import ?? [],
+    };
+}
+//# sourceMappingURL=cli-args.js.map

package/dist/cli-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args.js","sourceRoot":"","sources":["../src/cli-args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;CAoBpB,CAAC;AAEF,MAAM,KAAK,GAA2B,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC;AAE1F,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,CAAqB;IACjD,MAAM,CAAC,GAAG,gCAAgC,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,GAAG,GAAG,CAAC,CAAqB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAKtF,MAAM,UAAU,eAAe,CAAC,IAAc,EAAE,GAAsB;IACpE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,CAAC;QAC9B,IAAI,EAAE,IAAI;QACV,OAAO,EAAE;YACP,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC7B,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAChC,mBAAmB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;YACxB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;SACtC;KACF,CAAC,CAAC;IACH,IAAI,CAAC,CAAC,IAAI;QAAE,OAAO,MAAM,CAAC;IAC1B,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,iBAAiB,CAAC;QAC1C,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,iBAAiB;QACrC,WAAW,EAAE,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,iBAAiB;QAC5C,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,aAAa,CAAC;QACpC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,CAAC,sBAAsB,CAAC;QAClE,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,uBAAuB,CAAC;QAC9D,eAAe,EAAE,GAAG,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,GAAG,CAAC,8BAA8B,CAAC;QAClF,SAAS,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,gBAAgB,KAAK,GAAG;QAChD,OAAO,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;KACxB,CAAC;AACJ,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import { createHub, HUB_VERSION } from "./hub.js";
+import { optionsFromArgs, USAGE } from "./cli-args.js";
+import { importAddonFile } from "./import.js";
+import { DEFAULT_STORAGE_PATH } from "./options.js";
+async function main() {
+    const options = optionsFromArgs(process.argv.slice(2), process.env);
+    if (options === "help")
+        return void process.stdout.write(USAGE);
+    const open = options.host === "0.0.0.0" || options.host === "::";
+    if (open && !options.token)
+        console.warn("[wizelens-hub] Warning: the hub is open to the network without a token. Set --token.");
+    const hub = createHub(options);
+    for (const file of options.imports)
+        console.info(`[wizelens-hub] Imported ${importAddonFile(hub.data, file)} traces from ${file}`);
+    const url = await hub.listen();
+    const lines = [
+        `WizeLens hub ${HUB_VERSION}`,
+        `  Dashboard   ${url}/_wizelens/`,
+        `  Add-ons     WIZELENS_HUB=${url}`,
+        `  OTLP/HTTP   OTEL_EXPORTER_OTLP_ENDPOINT=${url}`,
+        `  Data        ${options.storagePath ?? DEFAULT_STORAGE_PATH}`,
+    ];
+    if (options.enableMcp)
+        lines.push(`  MCP         ${url}/_wizelens/mcp`);
+    console.info(lines.join("\n"));
+    const stop = () => void hub.close().then(() => process.exit(0));
+    process.once("SIGINT", stop);
+    process.once("SIGTERM", stop);
+}
+main().catch((err) => {
+    console.error(`[wizelens-hub] ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACpE,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC;IACjE,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK;QAAE,OAAO,CAAC,IAAI,CAAC,sFAAsF,CAAC,CAAC;IACjI,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,2BAA2B,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IACnI,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG;QACZ,gBAAgB,WAAW,EAAE;QAC7B,iBAAiB,GAAG,aAAa;QACjC,8BAA8B,GAAG,EAAE;QACnC,6CAA6C,GAAG,EAAE;QAClD,iBAAiB,OAAO,CAAC,WAAW,IAAI,oBAAoB,EAAE;KAC/D,CAAC;IACF,IAAI,OAAO,CAAC,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,CAAC,CAAC;IACxE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,kBAAkB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/data.d.ts

@@ -0,0 +1,17 @@
+import { type Trace, type TraceSummary } from "@wizeworks/lens-core";
+import { type TraceQuery } from "./store-read.js";
+import type { HubStore, HubWrite } from "./store.js";
+/** The hub's data: writes, reads, and federation to add-ons that do not send to the hub. */
+export declare class HubData {
+    #private;
+    readonly store: HubStore;
+    constructor(store: HubStore);
+    write(w: HubWrite): void;
+    /** Keep a remote only when the hub does not get that service's data. */
+    readonly keepRemote: (endpoint: string) => boolean;
+    traces(q: TraceQuery): Trace[];
+    summaries(q: TraceQuery): TraceSummary[];
+    /** One trace, plus the parts held by add-ons that do not send here. */
+    getTrace(traceId: string, federate?: boolean, hop?: number): Promise<Trace | undefined>;
+}
+//# sourceMappingURL=data.d.ts.map

package/dist/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,KAAK,EAAE,KAAK,YAAY,EAAa,MAAM,sBAAsB,CAAC;AAElH,OAAO,EAA0D,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC1G,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAIrD,4FAA4F;AAC5F,qBAAa,OAAO;;IAClB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAIzB,YAAY,KAAK,EAAE,QAAQ,EAG1B;IAED,KAAK,CAAC,CAAC,EAAE,QAAQ,GAAG,IAAI,CAGvB;IAED,wEAAwE;IACxE,QAAQ,CAAC,UAAU,aAAc,MAAM,KAAG,OAAO,CAA8C;IAE/F,MAAM,CAAC,CAAC,EAAE,UAAU,GAAG,KAAK,EAAE,CAE7B;IAED,SAAS,CAAC,CAAC,EAAE,UAAU,GAAG,YAAY,EAAE,CAEvC;IAED,uEAAuE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,UAAO,EAAE,GAAG,SAAI,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,CAMpF;CACF"}

package/dist/data.js

@@ -0,0 +1,39 @@
+import { MAX_FEDERATION_HOPS, mergeTraces, toSummary } from "@wizeworks/lens-core";
+import { fetchRemote } from "@wizeworks/lens-node/kit";
+import { findTraceIds, getStoredTrace, listServices, loadTraces } from "./store-read.js";
+const normalize = (e) => e.replace(/\/+$/, "");
+/** The hub's data: writes, reads, and federation to add-ons that do not send to the hub. */
+export class HubData {
+    store;
+    /** WizeLens endpoints of add-ons that send here. Their parts are already in the hub. */
+    #connected = new Set();
+    constructor(store) {
+        this.store = store;
+        for (const s of listServices(store.db, store.now()))
+            if (s.endpoint)
+                this.#connected.add(normalize(s.endpoint));
+    }
+    write(w) {
+        this.store.write(w);
+        if (w.sender.endpoint)
+            this.#connected.add(normalize(w.sender.endpoint));
+    }
+    /** Keep a remote only when the hub does not get that service's data. */
+    keepRemote = (endpoint) => !this.#connected.has(normalize(endpoint));
+    traces(q) {
+        return loadTraces(this.store.db, findTraceIds(this.store.db, q), this.keepRemote);
+    }
+    summaries(q) {
+        return this.traces(q).map(toSummary);
+    }
+    /** One trace, plus the parts held by add-ons that do not send here. */
+    async getTrace(traceId, federate = true, hop = 0) {
+        const local = getStoredTrace(this.store.db, traceId, this.keepRemote);
+        if (!federate || hop + 1 > MAX_FEDERATION_HOPS)
+            return local;
+        const parts = await Promise.all((local?.remotes ?? []).map((r) => fetchRemote(r, traceId, hop)));
+        const all = [local, ...parts].filter((t) => !!t && Array.isArray(t.spans));
+        return all.length ? mergeTraces(traceId, all) : undefined;
+    }
+}
+//# sourceMappingURL=data.js.map

package/dist/data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAiC,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAClH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,UAAU,EAAmB,MAAM,iBAAiB,CAAC;AAG1G,MAAM,SAAS,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAEvD,4FAA4F;AAC5F,MAAM,OAAO,OAAO;IACT,KAAK,CAAW;IACzB,wFAAwF;IAC/E,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAExC,YAAY,KAAe;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,KAAK,MAAM,CAAC,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;YAAE,IAAI,CAAC,CAAC,QAAQ;gBAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClH,CAAC;IAED,KAAK,CAAC,CAAW;QACf,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ;YAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,wEAAwE;IAC/D,UAAU,GAAG,CAAC,QAAgB,EAAW,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE/F,MAAM,CAAC,CAAa;QAClB,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACpF,CAAC;IAED,SAAS,CAAC,CAAa;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,GAAG,CAAC;QACtD,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACtE,IAAI,CAAC,QAAQ,IAAI,GAAG,GAAG,CAAC,GAAG,mBAAmB;YAAE,OAAO,KAAK,CAAC;QAC7D,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QACjG,MAAM,GAAG,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAc,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACvF,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,CAAC;CACF"}

package/dist/hub.d.ts

@@ -0,0 +1,14 @@
+import { type Server } from "node:http";
+import { HubData } from "./data.js";
+import { type HubOptions } from "./options.js";
+export declare const HUB_VERSION: string;
+export interface Hub {
+    readonly server: Server;
+    readonly data: HubData;
+    /** Start listening. Resolves to the hub's base URL. */
+    listen(): Promise<string>;
+    close(): Promise<void>;
+}
+/** Create the local hub: one place for the traces of every service, with the dashboard, the API, OTLP, and MCP. */
+export declare function createHub(options?: HubOptions): Hub;
+//# sourceMappingURL=hub.d.ts.map

package/dist/hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub.d.ts","sourceRoot":"","sources":["../src/hub.ts"],"names":[],"mappings":"AACA,OAAO,EAAsC,KAAK,MAAM,EAAuB,MAAM,WAAW,CAAC;AAMjG,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,KAAK,UAAU,EAAqB,MAAM,cAAc,CAAC;AAMlE,eAAO,MAAM,WAAW,EAAE,MAAoE,CAAC;AAK/F,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,uDAAuD;IACvD,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAmCD,mHAAmH;AACnH,wBAAgB,SAAS,CAAC,OAAO,GAAE,UAAe,GAAG,GAAG,CAiCvD"}