@marinoscar/platform-web 0.0.0-stage → 0.1.0-next.3

package/dist/telemetry/headless/hooks/useTelemetryExplorer.js

@@ -0,0 +1,197 @@
+/**
+ * The Telemetry Explorer's data — issue #537, epic #528.
+ *
+ * - `useTelemetrySchema`: `GET /admin/telemetry/schema`, once on mount.
+ * - `useTelemetryQuery`: `POST /admin/telemetry/query` with cancel. A newer
+ *   run aborts the one in flight; an aborted run leaves the previous result
+ *   on screen and reports nothing.
+ *
+ * Whether a statement is allowed is the API's decision (its SQL guard); the
+ * browser sends the text verbatim and shows the refusal's message and code.
+ */
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { isPlatformApiError } from '../../../core/index.js';
+import { telemetryErrorReason, } from '../services/telemetry.js';
+import { useTelemetryClient } from '../services/client.js';
+import { useIsMounted } from '../../internal/useIsMounted.js';
+function detail(err, key, kind) {
+    const details = err.details;
+    if (typeof details !== 'object' || details === null)
+        return null;
+    const value = details[key];
+    return typeof value === kind ? value : null;
+}
+/**
+ * A rejection as a {@link TelemetryErrorInfo}: a `PlatformApiError`'s status, code and details, or any other error's message.
+ *
+ * @param err - whatever a {@link TelemetryClient} call rejected with.
+ * @param fallback - the message when `err` carries none.
+ * @returns the error as the pages show it.
+ *
+ * @stability experimental
+ */
+export function toTelemetryError(err, fallback) {
+    if (isPlatformApiError(err)) {
+        return {
+            message: err.message || fallback,
+            code: err.code ?? null,
+            reason: telemetryErrorReason(err),
+            status: err.status,
+            sqlState: detail(err, 'sqlState', 'string'),
+            timeoutMs: detail(err, 'timeoutMs', 'number'),
+        };
+    }
+    return {
+        message: err instanceof Error ? err.message : fallback,
+        code: null,
+        reason: null,
+        status: null,
+        sqlState: null,
+        timeoutMs: null,
+    };
+}
+/**
+ * A short human heading for a telemetry error, branching on `details.reason`.
+ *
+ * @stability experimental
+ */
+export function telemetryErrorTitle(error) {
+    switch (error.reason) {
+        case 'TELEMETRY_QUERY_REJECTED':
+            return 'Query not allowed';
+        case 'TELEMETRY_QUERY_FAILED':
+            return error.sqlState ? `Query failed (SQLSTATE ${error.sqlState})` : 'Query failed';
+        case 'TELEMETRY_QUERY_TIMEOUT':
+            return error.timeoutMs !== null
+                ? `Query timed out after ${Math.round(error.timeoutMs / 1000)} s`
+                : 'Query timed out';
+        case 'TELEMETRY_DISABLED':
+            return 'Telemetry is switched off';
+        case 'TELEMETRY_NOT_CONFIGURED':
+            return 'Telemetry store not configured';
+        case 'TELEMETRY_UNREACHABLE':
+            return 'Telemetry store unreachable';
+        case 'TELEMETRY_ASSISTANT_DISABLED':
+            return 'Assistant is switched off';
+        default:
+            return 'Request failed';
+    }
+}
+function isAbort(err) {
+    return typeof err === 'object' && err !== null && err.name === 'AbortError';
+}
+/**
+ * `GET /admin/telemetry/schema`, once on mount: the tables the explorer's schema panel and editor completion read.
+ *
+ * @returns `tables`, `isLoading`, `error` (a message or `null`) and `reload`.
+ * @throws Error outside a `PlatformHostProvider`.
+ *
+ * @stability experimental
+ */
+export function useTelemetrySchema() {
+    const client = useTelemetryClient();
+    const [tables, setTables] = useState([]);
+    const [isLoading, setIsLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const isMounted = useIsMounted();
+    const load = useCallback(async () => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const schema = await client.getTelemetrySchema();
+            if (isMounted())
+                setTables(schema.tables);
+        }
+        catch (err) {
+            if (isMounted())
+                setError(toTelemetryError(err, 'Failed to load the schema').message);
+        }
+        finally {
+            if (isMounted())
+                setIsLoading(false);
+        }
+    }, [client, isMounted]);
+    useEffect(() => {
+        void load();
+    }, [load]);
+    return { tables, isLoading, error, reload: load };
+}
+/**
+ * `POST /admin/telemetry/query` with cancel. A newer run aborts the one in flight; an aborted run leaves the previous result on screen and reports nothing. Whether a statement is allowed is the API's decision.
+ *
+ * @returns the result, the error and the run and cancel actions.
+ * @throws Error outside a `PlatformHostProvider`.
+ *
+ * @stability experimental
+ */
+export function useTelemetryQuery() {
+    const client = useTelemetryClient();
+    const [result, setResult] = useState(null);
+    const [error, setError] = useState(null);
+    const [isRunning, setIsRunning] = useState(false);
+    const controllerRef = useRef(null);
+    const isMounted = useIsMounted();
+    const cancel = useCallback(() => {
+        controllerRef.current?.abort();
+        controllerRef.current = null;
+        if (isMounted())
+            setIsRunning(false);
+    }, [client, isMounted]);
+    useEffect(() => () => controllerRef.current?.abort(), []);
+    const run = useCallback(async (sql) => {
+        controllerRef.current?.abort();
+        const controller = new AbortController();
+        controllerRef.current = controller;
+        setIsRunning(true);
+        setError(null);
+        try {
+            const next = await client.runTelemetryQuery(sql, { signal: controller.signal });
+            if (!isMounted() || controller.signal.aborted)
+                return false;
+            setResult(next);
+            return true;
+        }
+        catch (err) {
+            if (isAbort(err) || controller.signal.aborted)
+                return false;
+            if (isMounted())
+                setError(toTelemetryError(err, 'The query failed'));
+            return false;
+        }
+        finally {
+            if (controllerRef.current === controller) {
+                controllerRef.current = null;
+                if (isMounted())
+                    setIsRunning(false);
+            }
+        }
+    }, [isMounted]);
+    return { result, error, isRunning, run, cancel };
+}
+/**
+ * The assistant's configured provider and model, as a caption — read from the
+ * admin config, so only fetched for a holder of `telemetry:read` (`enabled`).
+ * Best effort: any failure just means no caption.
+ *
+ * @stability experimental
+ */
+export function useTelemetryAssistantModel(enabled) {
+    const client = useTelemetryClient();
+    const [caption, setCaption] = useState(null);
+    const isMounted = useIsMounted();
+    useEffect(() => {
+        if (!enabled)
+            return;
+        client.getTelemetryAdminConfig()
+            .then((config) => {
+            const { provider, modelId } = config.assistant;
+            if (isMounted() && provider && modelId)
+                setCaption(`${provider} · ${modelId}`);
+        })
+            .catch(() => {
+            // No caption.
+        });
+    }, [client, enabled, isMounted]);
+    return caption;
+}
+//# sourceMappingURL=useTelemetryExplorer.js.map

package/dist/telemetry/headless/hooks/useTelemetryExplorer.js.map

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

package/dist/telemetry/headless/hooks/useTelemetryStack.d.ts

@@ -0,0 +1,69 @@
+import { type TelemetryStack, type TelemetryStackDeploy } from '../services/telemetry.js';
+/**
+ * How often {@link useTelemetryStack} polls while a deploy is pending or running.
+ *
+ * @stability experimental
+ */
+export declare const TELEMETRY_STACK_ACTIVE_POLL_MS = 3000;
+/**
+ * How often {@link useTelemetryStack} polls otherwise.
+ *
+ * @stability experimental
+ */
+export declare const TELEMETRY_STACK_IDLE_POLL_MS = 30000;
+/**
+ * What {@link useTelemetryStack} takes.
+ *
+ * @stability experimental
+ */
+export interface UseTelemetryStackOptions {
+    /** Poll interval while a deploy is active. Default {@link TELEMETRY_STACK_ACTIVE_POLL_MS}. */
+    activeIntervalMs?: number;
+    /** Poll interval otherwise. Default {@link TELEMETRY_STACK_IDLE_POLL_MS}. */
+    idleIntervalMs?: number;
+}
+/**
+ * What {@link useTelemetryStack} returns.
+ *
+ * @stability experimental
+ */
+export interface UseTelemetryStackReturn {
+    /** The services and the latest deploy, or `null` before the first load. */
+    stack: TelemetryStack | null;
+    /** The first load is in flight. */
+    isLoading: boolean;
+    /** Why the stack could not be loaded, or `null`. */
+    loadError: string | null;
+    /** The deploy POST is in flight. */
+    isRequesting: boolean;
+    /** Why the last deploy request failed, or `null`. */
+    deployError: string | null;
+    /** A deploy is requested or its job is pending/running. */
+    isDeploying: boolean;
+    /** The job id the last successful POST returned, until the stack reports it settled. */
+    requestedJobId: string | null;
+    /** Load the stack again. */
+    reload: () => Promise<void>;
+    /** Ask the API to (re)deploy the telemetry services; resolves `true` when the job was enqueued. */
+    deploy: () => Promise<boolean>;
+}
+/**
+ * Whether a deploy job is still pending or running.
+ *
+ * @param deploy - the latest deploy job, if any.
+ * @returns `true` while it is pending or running.
+ *
+ * @stability experimental
+ */
+export declare function isDeployActive(deploy: TelemetryStackDeploy | null | undefined): boolean;
+/**
+ * The Telemetry services section's data: `GET /admin/telemetry/stack`, polled only while the tab is visible (faster while a deploy runs), and `POST …/stack/deploy` (a queue job runs it server-side).
+ *
+ * @param options - poll intervals; `0` disables polling.
+ * @returns the stack and the deploy action.
+ * @throws Error outside a `PlatformHostProvider`.
+ *
+ * @stability experimental
+ */
+export declare function useTelemetryStack(options?: UseTelemetryStackOptions): UseTelemetryStackReturn;
+//# sourceMappingURL=useTelemetryStack.d.ts.map

package/dist/telemetry/headless/hooks/useTelemetryStack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTelemetryStack.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/headless/hooks/useTelemetryStack.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAKlC;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,OAAQ,CAAC;AACpD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,8FAA8F;IAC9F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,2EAA2E;IAC3E,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7B,mCAAmC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,oCAAoC;IACpC,YAAY,EAAE,OAAO,CAAC;IACtB,qDAAqD;IACrD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2DAA2D;IAC3D,WAAW,EAAE,OAAO,CAAC;IACrB,wFAAwF;IACxF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,4BAA4B;IAC5B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,mGAAmG;IACnG,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEvF;AAMD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,uBAAuB,CAyEjG"}

package/dist/telemetry/headless/hooks/useTelemetryStack.js

@@ -0,0 +1,129 @@
+/**
+ * The Telemetry services section's data — issue #567.
+ *
+ * Loads `GET /admin/telemetry/stack` and polls it: every `activeIntervalMs`
+ * (3 s) while a deploy job is pending/running, else every `idleIntervalMs`
+ * (30 s). Polling pauses with the tab (`useVisiblePolling`) and stops on
+ * unmount. `deploy()` POSTs `/admin/telemetry/stack/deploy` and re-reads the
+ * stack at once, so the progress indicator appears without waiting a tick.
+ *
+ * The browser never decides anything here: the API reports the containers and
+ * the job, and runs the deployment as a queue job.
+ *
+ * Writes resolve `true`/`false` and never throw.
+ */
+import { useCallback, useEffect, useState } from 'react';
+import { isPlatformApiError } from '../../../core/index.js';
+import { useTelemetryClient } from '../services/client.js';
+import { useIsMounted } from '../../internal/useIsMounted.js';
+import { useVisiblePolling } from '../../internal/useVisiblePolling.js';
+/**
+ * How often {@link useTelemetryStack} polls while a deploy is pending or running.
+ *
+ * @stability experimental
+ */
+export const TELEMETRY_STACK_ACTIVE_POLL_MS = 3_000;
+/**
+ * How often {@link useTelemetryStack} polls otherwise.
+ *
+ * @stability experimental
+ */
+export const TELEMETRY_STACK_IDLE_POLL_MS = 30_000;
+/**
+ * Whether a deploy job is still pending or running.
+ *
+ * @param deploy - the latest deploy job, if any.
+ * @returns `true` while it is pending or running.
+ *
+ * @stability experimental
+ */
+export function isDeployActive(deploy) {
+    return deploy?.status === 'pending' || deploy?.status === 'running';
+}
+function message(err, fallback) {
+    return isPlatformApiError(err) || err instanceof Error ? err.message : fallback;
+}
+/**
+ * The Telemetry services section's data: `GET /admin/telemetry/stack`, polled only while the tab is visible (faster while a deploy runs), and `POST …/stack/deploy` (a queue job runs it server-side).
+ *
+ * @param options - poll intervals; `0` disables polling.
+ * @returns the stack and the deploy action.
+ * @throws Error outside a `PlatformHostProvider`.
+ *
+ * @stability experimental
+ */
+export function useTelemetryStack(options = {}) {
+    const client = useTelemetryClient();
+    const activeIntervalMs = options.activeIntervalMs ?? TELEMETRY_STACK_ACTIVE_POLL_MS;
+    const idleIntervalMs = options.idleIntervalMs ?? TELEMETRY_STACK_IDLE_POLL_MS;
+    const [stack, setStack] = useState(null);
+    const [isLoading, setIsLoading] = useState(true);
+    const [loadError, setLoadError] = useState(null);
+    const [isRequesting, setIsRequesting] = useState(false);
+    const [deployError, setDeployError] = useState(null);
+    const [requestedJobId, setRequestedJobId] = useState(null);
+    const isMounted = useIsMounted();
+    const reload = useCallback(async () => {
+        try {
+            const next = await client.getTelemetryStack();
+            if (!isMounted())
+                return;
+            setStack(next);
+            setLoadError(null);
+        }
+        catch (err) {
+            if (isMounted())
+                setLoadError(message(err, 'Failed to load the telemetry services'));
+        }
+        finally {
+            if (isMounted())
+                setIsLoading(false);
+        }
+    }, [client, isMounted]);
+    useEffect(() => {
+        void reload();
+    }, [reload]);
+    // The requested job is tracked until the stack reports it settled — the
+    // first GET after the POST can still describe the previous deploy.
+    useEffect(() => {
+        if (requestedJobId &&
+            stack?.deploy?.jobId === requestedJobId &&
+            !isDeployActive(stack.deploy)) {
+            setRequestedJobId(null);
+        }
+    }, [requestedJobId, stack]);
+    const isDeploying = isRequesting || !!requestedJobId || isDeployActive(stack?.deploy);
+    useVisiblePolling(() => void reload(), isDeploying ? activeIntervalMs : idleIntervalMs);
+    const deploy = useCallback(async () => {
+        setIsRequesting(true);
+        setDeployError(null);
+        try {
+            const { jobId } = await client.deployTelemetryStack();
+            if (isMounted())
+                setRequestedJobId(jobId);
+            await reload();
+            return true;
+        }
+        catch (err) {
+            if (isMounted())
+                setDeployError(message(err, 'The deployment could not be started'));
+            return false;
+        }
+        finally {
+            if (isMounted())
+                setIsRequesting(false);
+        }
+    }, [client, isMounted, reload]);
+    return {
+        stack,
+        isLoading,
+        loadError,
+        isRequesting,
+        deployError,
+        isDeploying,
+        requestedJobId,
+        reload,
+        deploy,
+    };
+}
+//# sourceMappingURL=useTelemetryStack.js.map

package/dist/telemetry/headless/hooks/useTelemetryStack.js.map

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

package/dist/telemetry/headless/index.d.ts

@@ -0,0 +1,34 @@
+export * from './services/telemetry.js';
+export * from './services/telemetryDashboard.js';
+export { createTelemetryClient, useTelemetryClient } from './services/client.js';
+export type { TelemetryClient, TelemetryRequestOptions, TelemetryStackDeployAccepted } from './services/client.js';
+export { TELEMETRY_CONFIG_DISABLED, TelemetryConfigContext, isTelemetryOn, useTelemetryConfig, useTelemetryConfigQuery, useTelemetryFeatures, } from './context/telemetryConfig.js';
+export type { TelemetryFeatureFlags, UseTelemetryConfigReturn } from './context/telemetryConfig.js';
+export { TelemetryConfigProvider } from './context/TelemetryConfigProvider.js';
+export type { TelemetryConfigProviderProps } from './context/TelemetryConfigProvider.js';
+export { RequireTelemetryEnabled } from './guards/RequireTelemetryEnabled.js';
+export type { RequireTelemetryEnabledProps } from './guards/RequireTelemetryEnabled.js';
+export { DEFAULT_TELEMETRY_WEB_ADAPTERS, TelemetryWebAdaptersProvider, useTelemetryWebAdapters, } from './adapters/TelemetryWebAdapters.js';
+export type { TelemetryAiEnabledState, TelemetryAssistantModelOption, TelemetryAssistantModelsState, TelemetryWebAdapters, } from './adapters/TelemetryWebAdapters.js';
+export { useTelemetryAdmin } from './hooks/useTelemetryAdmin.js';
+export type { UseTelemetryAdminReturn } from './hooks/useTelemetryAdmin.js';
+export { useTelemetryConnection } from './hooks/useTelemetryConnection.js';
+export type { UseTelemetryConnectionReturn } from './hooks/useTelemetryConnection.js';
+export { TELEMETRY_STACK_ACTIVE_POLL_MS, TELEMETRY_STACK_IDLE_POLL_MS, isDeployActive, useTelemetryStack, } from './hooks/useTelemetryStack.js';
+export type { UseTelemetryStackOptions, UseTelemetryStackReturn } from './hooks/useTelemetryStack.js';
+export { telemetryErrorTitle, toTelemetryError, useTelemetryAssistantModel, useTelemetryQuery, useTelemetrySchema, } from './hooks/useTelemetryExplorer.js';
+export type { TelemetryErrorInfo, UseTelemetryQueryReturn, UseTelemetrySchemaReturn } from './hooks/useTelemetryExplorer.js';
+export { ASSISTANT_HISTORY_ANSWER_MAX, ASSISTANT_HISTORY_TURNS, ASSISTANT_QUESTION_MAX, answerAsHistory, buildAssistantHistory, useTelemetryAssistant, } from './hooks/useTelemetryAssistant.js';
+export type { AssistantMessage, AssistantReplyError, AssistantReplyMessage, AssistantUserMessage, UseTelemetryAssistantOptions, UseTelemetryAssistantReturn, } from './hooks/useTelemetryAssistant.js';
+export { useTelemetryAssistantAvailable } from './hooks/useTelemetryAssistantAvailable.js';
+export { useDashboardEvents, useDashboardFilters, useDashboardMetricGroups, useDashboardMetrics, useDashboardSummary, useDashboardTimeseries, useDashboardTop, } from './hooks/useTelemetryDashboard.js';
+export type { DashboardEventsResource, DashboardResource } from './hooks/useTelemetryDashboard.js';
+export { formatBytes, formatDuration } from './lib/format.js';
+export { TELEMETRY_DASHBOARD_PATH, TELEMETRY_EXPLORER_PATH, TELEMETRY_SETTINGS_PATH, explorerSqlUrl, } from './lib/explorerHandoff.js';
+export { METRIC_SECTION_TITLES, metricSectionTitle } from './lib/metrics/metricSections.js';
+export { STARTER_QUERIES, traceQuery } from './lib/starterQueries.js';
+export type { StarterQuery } from './lib/starterQueries.js';
+export { QUERY_HISTORY_KEY } from './lib/queryHistory.js';
+export { telemetryTokens, useTelemetryTokens, withTelemetryTokens } from '../theme/telemetryTokens.js';
+export type { TelemetryChartTokens, TelemetryStatusTokens, TelemetryTokens } from '../theme/telemetryTokens.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/telemetry/headless/index.d.ts.map

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

package/dist/telemetry/headless/index.js

@@ -0,0 +1,34 @@
+// `@marinoscar/platform-web/telemetry/headless`: the telemetry UI's client,
+// hooks, config context, route guard, app adapters, theme tokens and pure
+// helpers, with no component (issue #704). Imports nothing from an `@mui/*`
+// component module (`@mui/material/styles` only, for the token contract);
+// `test/telemetry/boundaries.test.ts` enforces it. Documented in ../README.md.
+// The wire types (aliased from `@marinoscar/platform-contract/telemetry`),
+// the web's display constants and the pure helpers of the two services.
+export * from './services/telemetry.js';
+export * from './services/telemetryDashboard.js';
+// The client over the platform host's transport.
+export { createTelemetryClient, useTelemetryClient } from './services/client.js';
+// `GET /telemetry/config`, once per shell.
+export { TELEMETRY_CONFIG_DISABLED, TelemetryConfigContext, isTelemetryOn, useTelemetryConfig, useTelemetryConfigQuery, useTelemetryFeatures, } from './context/telemetryConfig.js';
+export { TelemetryConfigProvider } from './context/TelemetryConfigProvider.js';
+export { RequireTelemetryEnabled } from './guards/RequireTelemetryEnabled.js';
+// What the app hands in (AI on/off, the model catalogue, its spinner).
+export { DEFAULT_TELEMETRY_WEB_ADAPTERS, TelemetryWebAdaptersProvider, useTelemetryWebAdapters, } from './adapters/TelemetryWebAdapters.js';
+// The hooks behind the three pages.
+export { useTelemetryAdmin } from './hooks/useTelemetryAdmin.js';
+export { useTelemetryConnection } from './hooks/useTelemetryConnection.js';
+export { TELEMETRY_STACK_ACTIVE_POLL_MS, TELEMETRY_STACK_IDLE_POLL_MS, isDeployActive, useTelemetryStack, } from './hooks/useTelemetryStack.js';
+export { telemetryErrorTitle, toTelemetryError, useTelemetryAssistantModel, useTelemetryQuery, useTelemetrySchema, } from './hooks/useTelemetryExplorer.js';
+export { ASSISTANT_HISTORY_ANSWER_MAX, ASSISTANT_HISTORY_TURNS, ASSISTANT_QUESTION_MAX, answerAsHistory, buildAssistantHistory, useTelemetryAssistant, } from './hooks/useTelemetryAssistant.js';
+export { useTelemetryAssistantAvailable } from './hooks/useTelemetryAssistantAvailable.js';
+export { useDashboardEvents, useDashboardFilters, useDashboardMetricGroups, useDashboardMetrics, useDashboardSummary, useDashboardTimeseries, useDashboardTop, } from './hooks/useTelemetryDashboard.js';
+// Pure helpers apps reuse.
+export { formatBytes, formatDuration } from './lib/format.js';
+export { TELEMETRY_DASHBOARD_PATH, TELEMETRY_EXPLORER_PATH, TELEMETRY_SETTINGS_PATH, explorerSqlUrl, } from './lib/explorerHandoff.js';
+export { METRIC_SECTION_TITLES, metricSectionTitle } from './lib/metrics/metricSections.js';
+export { STARTER_QUERIES, traceQuery } from './lib/starterQueries.js';
+export { QUERY_HISTORY_KEY } from './lib/queryHistory.js';
+// The theme-token contract (`palette.status`, `palette.chart.series`).
+export { telemetryTokens, useTelemetryTokens, withTelemetryTokens } from '../theme/telemetryTokens.js';
+//# sourceMappingURL=index.js.map

package/dist/telemetry/headless/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telemetry/headless/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,4EAA4E;AAC5E,0EAA0E;AAC1E,+EAA+E;AAE/E,2EAA2E;AAC3E,wEAAwE;AACxE,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AAEjD,iDAAiD;AACjD,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGjF,2CAA2C;AAC3C,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,aAAa,EACb,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAG9E,uEAAuE;AACvE,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,oCAAoC,CAAC;AAQ5C,oCAAoC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EACL,8BAA8B,EAC9B,4BAA4B,EAC5B,cAAc,EACd,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,EACvB,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAS1C,OAAO,EAAE,8BAA8B,EAAE,MAAM,2CAA2C,CAAC;AAC3F,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,GAChB,MAAM,kCAAkC,CAAC;AAG1C,2BAA2B;AAC3B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,GACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,uEAAuE;AACvE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/telemetry/headless/lib/assistantExport.d.ts

@@ -0,0 +1,12 @@
+import type { AssistantMessage, AssistantReplyMessage } from '../hooks/useTelemetryAssistant.js';
+export interface ConversationExportOptions {
+    exportedAt: Date;
+    modelCaption?: string | null;
+}
+/** `telemetry-assistant-<ISO stamp, ":" and "." as "-">.md` */
+export declare function assistantExportFilename(now?: Date): string;
+/** Just the answer of one reply (no steps), for the per-reply Copy. */
+export declare function replyToMarkdown(reply: AssistantReplyMessage): string;
+/** The whole conversation, written for another AI agent to read. */
+export declare function conversationToMarkdown(messages: AssistantMessage[], { exportedAt, modelCaption }: ConversationExportOptions): string;
+//# sourceMappingURL=assistantExport.d.ts.map

package/dist/telemetry/headless/lib/assistantExport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistantExport.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/headless/lib/assistantExport.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAEjG,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,IAAI,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,+DAA+D;AAC/D,wBAAgB,uBAAuB,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAEtE;AAkDD,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAEpE;AAqBD,oEAAoE;AACpE,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,yBAAyB,GACtD,MAAM,CAwBR"}

package/dist/telemetry/headless/lib/assistantExport.js

@@ -0,0 +1,116 @@
+/** `telemetry-assistant-<ISO stamp, ":" and "." as "-">.md` */
+export function assistantExportFilename(now = new Date()) {
+    return `telemetry-assistant-${now.toISOString().replace(/[:.]/g, '-')}.md`;
+}
+function fenced(content, lang = '') {
+    const longest = (content.match(/`+/g) ?? []).reduce((max, run) => Math.max(max, run.length), 0);
+    const fence = '`'.repeat(Math.max(3, longest + 1));
+    return `${fence}${lang}\n${content}\n${fence}`;
+}
+function reportMarkdown(report) {
+    const out = [`Status: ${report.status} (confidence: ${report.confidence})`, '', report.summary];
+    if (report.findings.length) {
+        out.push('', '### Findings');
+        for (const finding of report.findings) {
+            out.push('', `- [${finding.severity}] ${finding.title}`, `  Evidence: ${finding.evidence}`);
+        }
+    }
+    if (report.rootCause)
+        out.push('', '### Root cause', '', report.rootCause);
+    if (report.recommendations.length) {
+        out.push('', '### Recommendations', '');
+        report.recommendations.forEach((item, i) => out.push(`${i + 1}. ${item}`));
+    }
+    if (report.queries.length) {
+        out.push('', '### Supporting queries');
+        for (const query of report.queries)
+            out.push('', `**${query.title}**`, '', fenced(query.sql, 'sql'));
+    }
+    return out;
+}
+function answerMarkdown(answer) {
+    if (answer.report)
+        return reportMarkdown(answer.report);
+    const out = [answer.explanation];
+    if (answer.sql)
+        out.push('', fenced(answer.sql, 'sql'));
+    return out;
+}
+/** The body of a reply's `## Answer` (answer, error or "Stopped"), or `null` when there is none. */
+function replyBody(reply) {
+    const out = [];
+    if (reply.answer)
+        out.push(...answerMarkdown(reply.answer));
+    if (reply.error) {
+        if (out.length)
+            out.push('');
+        out.push(`Error${reply.error.code ? ` (${reply.error.code})` : ''}: ${reply.error.message}`);
+    }
+    if (reply.status === 'stopped') {
+        if (out.length)
+            out.push('');
+        out.push('Stopped');
+    }
+    return out.length ? out : null;
+}
+/** Just the answer of one reply (no steps), for the per-reply Copy. */
+export function replyToMarkdown(reply) {
+    return (replyBody(reply) ?? []).join('\n');
+}
+function stepMarkdown(step, position) {
+    const out = [];
+    if (step.thought)
+        out.push(`Thought: ${step.thought}`, '');
+    out.push(`${position}. ${step.tool}`);
+    const details = [];
+    const input = step.input;
+    if (input?.table)
+        details.push(`table: ${input.table}`);
+    if (input?.window)
+        details.push(`window: ${input.window}`);
+    if (input?.group)
+        details.push(`group: ${input.group}`);
+    if (input?.traceId)
+        details.push(`traceId: ${input.traceId}`);
+    if (step.rowCount !== undefined)
+        details.push(`rows: ${step.rowCount}`);
+    if (step.truncated)
+        details.push('truncated: true');
+    details.push(`duration: ${step.durationMs}ms`);
+    if (step.error)
+        details.push(`error: ${step.error}`);
+    for (const detail of details)
+        out.push(`   - ${detail}`);
+    if (input?.sql)
+        out.push('', fenced(input.sql, 'sql').replace(/^/gm, '   '));
+    return out;
+}
+/** The whole conversation, written for another AI agent to read. */
+export function conversationToMarkdown(messages, { exportedAt, modelCaption }) {
+    const out = [
+        '# Telemetry assistant conversation',
+        '',
+        `Exported at: ${exportedAt.toISOString()}`,
+    ];
+    if (modelCaption)
+        out.push(`Model: ${modelCaption}`);
+    for (const message of messages) {
+        if (message.role === 'user') {
+            out.push('', '## Question', '', message.text);
+            continue;
+        }
+        if (message.steps.length) {
+            out.push('', '## Investigation', '');
+            message.steps.forEach((step, i) => {
+                if (i > 0)
+                    out.push('');
+                out.push(...stepMarkdown(step, i + 1));
+            });
+        }
+        const body = replyBody(message);
+        if (body)
+            out.push('', '## Answer', '', ...body);
+    }
+    return `${out.join('\n')}\n`;
+}
+//# sourceMappingURL=assistantExport.js.map

package/dist/telemetry/headless/lib/assistantExport.js.map

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