@qvac/sdk 0.18.1 → 0.19.0

package/dist/profiling/controller.js

@@ -1,130 +0,0 @@
-/**
- * Central state management for profiling enablement, configuration, and recording.
- *
- * Precedence (highest to lowest):
- * 1. Per-call override
- * 2. Runtime API (enable/disable)
- * 3. Disabled default
- */
-import { getGlobalSingleton } from '../utils/global-singleton.js';
-import { createAggregator, recordEvent as aggregatorRecord, getAggregates as aggregatorGetAggregates, getRecentEvents as aggregatorGetRecentEvents, clearAggregator, setMaxRecentEvents } from './aggregator.js';
-import { nowMs, generateProfileId } from './clock.js';
-const DEFAULT_CONFIG = {
-    enabled: false,
-    mode: 'summary',
-    includeServerBreakdown: false,
-    includeResourceGauges: false,
-    operationFilters: [],
-    maxRecentEvents: 1000
-};
-const CONTROLLER_STATE_KEY = Symbol.for('@qvac/sdk:profiler-controller-state');
-function getControllerState() {
-    const state = getGlobalSingleton(CONTROLLER_STATE_KEY, () => {
-        return {
-            runtimeOverride: undefined,
-            runtimeOptions: {},
-            onRecordCallbacks: [],
-            initialized: false
-        };
-    });
-    if (!state.initialized) {
-        createAggregator(DEFAULT_CONFIG.maxRecentEvents);
-        state.initialized = true;
-    }
-    return state;
-}
-export function enable(options) {
-    const state = getControllerState();
-    state.runtimeOverride = true;
-    state.runtimeOptions = options ? { ...options } : {};
-    clearAggregator();
-    setMaxRecentEvents(DEFAULT_CONFIG.maxRecentEvents);
-}
-export function disable() {
-    const state = getControllerState();
-    state.runtimeOverride = false;
-    state.runtimeOptions = {};
-    setMaxRecentEvents(DEFAULT_CONFIG.maxRecentEvents);
-}
-export function isEnabled() {
-    const state = getControllerState();
-    return state.runtimeOverride ?? false;
-}
-export function getEffectiveConfig() {
-    const state = getControllerState();
-    return {
-        enabled: isEnabled(),
-        mode: state.runtimeOptions.mode ?? DEFAULT_CONFIG.mode,
-        includeServerBreakdown: state.runtimeOptions.includeServerBreakdown ?? DEFAULT_CONFIG.includeServerBreakdown,
-        includeResourceGauges: state.runtimeOptions.includeResourceGauges ?? DEFAULT_CONFIG.includeResourceGauges,
-        operationFilters: [
-            ...(state.runtimeOptions.operationFilters ?? DEFAULT_CONFIG.operationFilters)
-        ],
-        maxRecentEvents: DEFAULT_CONFIG.maxRecentEvents
-    };
-}
-export function shouldProfile(operation, perCallOptions) {
-    if (perCallOptions?.enabled !== undefined) {
-        return perCallOptions.enabled;
-    }
-    if (!isEnabled()) {
-        return false;
-    }
-    const config = getEffectiveConfig();
-    if (config.operationFilters.length > 0) {
-        return config.operationFilters.includes(operation);
-    }
-    return true;
-}
-export function shouldIncludeServerBreakdown(perCallOptions) {
-    if (perCallOptions?.includeServerBreakdown !== undefined) {
-        return perCallOptions.includeServerBreakdown;
-    }
-    return getEffectiveConfig().includeServerBreakdown;
-}
-export function shouldIncludeResourceGauges(perCallOptions) {
-    if (perCallOptions?.includeResourceGauges !== undefined) {
-        return perCallOptions.includeResourceGauges;
-    }
-    return getEffectiveConfig().includeResourceGauges;
-}
-export function generateId() {
-    return generateProfileId();
-}
-export function record(event) {
-    const state = getControllerState();
-    let eventWithTs = event;
-    if (event.ts === undefined) {
-        eventWithTs = { ...event, ts: nowMs() };
-    }
-    const storeInBuffer = getEffectiveConfig().mode === 'verbose';
-    aggregatorRecord(eventWithTs, storeInBuffer);
-    for (const cb of state.onRecordCallbacks) {
-        try {
-            cb(eventWithTs);
-        }
-        catch {
-            // Callback errors should not break profiling
-        }
-    }
-}
-/** Returns unsubscribe function. */
-export function onRecord(callback) {
-    const state = getControllerState();
-    state.onRecordCallbacks.push(callback);
-    return () => {
-        const idx = state.onRecordCallbacks.indexOf(callback);
-        if (idx >= 0) {
-            state.onRecordCallbacks.splice(idx, 1);
-        }
-    };
-}
-export function getAggregates() {
-    return aggregatorGetAggregates();
-}
-export function getRecentEvents() {
-    return aggregatorGetRecentEvents();
-}
-export function clear() {
-    clearAggregator();
-}

package/dist/profiling/envelope.d.ts

@@ -1,11 +0,0 @@
-/**
- * Helpers to inject/extract __profiling metadata in RPC payloads.
- */
-import { type ProfilingRequestMeta, type ProfilingResponseMeta } from '../schemas/index.js';
-export declare function createProfilingMeta(profileId: string, includeServerBreakdown: boolean, includeResourceGauges: boolean): ProfilingRequestMeta;
-export declare function createProfilingDisabledMeta(): ProfilingRequestMeta;
-export declare function createDelegatedProfilingMeta(profileId: string, meta?: ProfilingRequestMeta): ProfilingRequestMeta;
-export declare function injectProfilingMetaIntoObject(obj: Record<string, unknown>, meta: ProfilingRequestMeta): Record<string, unknown>;
-export declare function extractProfilingMeta(payload: unknown): ProfilingResponseMeta | undefined;
-export declare function stripProfilingMeta<T extends object>(payload: T): T;
-//# sourceMappingURL=envelope.d.ts.map

package/dist/profiling/envelope.js

@@ -1,45 +0,0 @@
-/**
- * Helpers to inject/extract __profiling metadata in RPC payloads.
- */
-import { PROFILING_KEY } from '../schemas/index.js';
-export function createProfilingMeta(profileId, includeServerBreakdown, includeResourceGauges) {
-    return {
-        enabled: true,
-        id: profileId,
-        includeServer: includeServerBreakdown,
-        includeResources: includeResourceGauges
-    };
-}
-export function createProfilingDisabledMeta() {
-    return { enabled: false };
-}
-export function createDelegatedProfilingMeta(profileId, meta) {
-    return {
-        enabled: true,
-        id: profileId,
-        includeServer: meta?.includeServer ?? false,
-        includeResources: meta?.includeResources ?? false,
-        resourceOrigin: 'provider',
-        ...(meta?.mode !== undefined && { mode: meta.mode })
-    };
-}
-export function injectProfilingMetaIntoObject(obj, meta) {
-    return { ...obj, [PROFILING_KEY]: meta };
-}
-export function extractProfilingMeta(payload) {
-    if (typeof payload === 'object' && payload !== null && PROFILING_KEY in payload) {
-        const meta = payload[PROFILING_KEY];
-        if (typeof meta === 'object' && meta !== null) {
-            return meta;
-        }
-    }
-    return undefined;
-}
-export function stripProfilingMeta(payload) {
-    if (PROFILING_KEY in payload) {
-        const { [PROFILING_KEY]: _unused, ...rest } = payload;
-        void _unused;
-        return rest;
-    }
-    return payload;
-}

package/dist/profiling/events.d.ts

@@ -1,20 +0,0 @@
-import type { ProfilingEventKind } from './types.js';
-import type { ServerBreakdown, DelegationBreakdown } from '../schemas/index.js';
-export interface BaseTimings {
-    profileId: string;
-    requestType: string;
-    requestStart: number;
-}
-export interface BaseEvent {
-    ts: number;
-    op: string;
-    kind: ProfilingEventKind;
-    profileId: string;
-}
-export declare function recordPhase(base: BaseEvent, phase: string, ms?: number, extra?: {
-    count?: number;
-}): void;
-export declare function recordFailure(base: BaseEvent, startTime: number, error: unknown): void;
-export declare function recordServerBreakdownPhases(base: BaseEvent, server: ServerBreakdown, prefix?: string): void;
-export declare function recordDelegationBreakdownPhases(base: BaseEvent, delegation: DelegationBreakdown, prefix?: string): void;
-//# sourceMappingURL=events.d.ts.map

package/dist/profiling/events.js

@@ -1,35 +0,0 @@
-import { nowMs } from './clock.js';
-import { record } from './controller.js';
-export function recordPhase(base, phase, ms, extra) {
-    if (ms === undefined)
-        return;
-    record({ ...base, phase, ms, ...extra });
-}
-export function recordFailure(base, startTime, error) {
-    const now = nowMs();
-    record({
-        ...base,
-        ts: now,
-        phase: 'failed',
-        ms: now - startTime,
-        tags: {
-            error: error instanceof Error ? error.name : 'Unknown',
-            message: error instanceof Error ? error.message.slice(0, 100) : String(error).slice(0, 100)
-        }
-    });
-}
-export function recordServerBreakdownPhases(base, server, prefix = 'server') {
-    recordPhase(base, `${prefix}.request.jsonParse`, server.requestJsonParseMs);
-    recordPhase(base, `${prefix}.request.zodValidation`, server.requestZodValidationMs);
-    recordPhase(base, `${prefix}.handlerExecution`, server.handlerExecutionMs);
-    recordPhase(base, `${prefix}.response.zodValidation`, server.responseZodValidationMs);
-    recordPhase(base, `${prefix}.response.stringify`, server.responseStringifyMs);
-    recordPhase(base, `${prefix}.totalServerTime`, server.totalServerMs);
-}
-export function recordDelegationBreakdownPhases(base, delegation, prefix = 'delegation') {
-    recordPhase(base, `${prefix}.connection`, delegation.connectionMs);
-    recordPhase(base, `${prefix}.request.stringify`, delegation.requestStringifyMs);
-    recordPhase(base, `${prefix}.serverWait`, delegation.serverWaitMs);
-    recordPhase(base, `${prefix}.response.jsonParse`, delegation.responseJsonParseMs);
-    recordPhase(base, `${prefix}.totalDelegationTime`, delegation.totalDelegationMs);
-}

package/dist/profiling/exporters.d.ts

@@ -1,10 +0,0 @@
-/**
- * JSON, table, and summary export utilities for profiling data.
- */
-import type { ProfilerExport } from './types.js';
-export declare function exportJSON(options?: {
-    includeRecentEvents?: boolean;
-}): ProfilerExport;
-export declare function exportTable(): string;
-export declare function exportSummary(): string;
-//# sourceMappingURL=exporters.d.ts.map

package/dist/profiling/exporters.js

@@ -1,243 +0,0 @@
-/**
- * JSON, table, and summary export utilities for profiling data.
- */
-import { getEffectiveConfig, getAggregates, getRecentEvents } from './controller.js';
-import { getDroppedCount, getEventCount } from './aggregator.js';
-import { nowMs, getClockSource, isMonotonic } from './clock.js';
-export function exportJSON(options) {
-    const config = getEffectiveConfig();
-    const includeRecent = options?.includeRecentEvents ?? true;
-    const result = {
-        config,
-        aggregates: getAggregates(),
-        exportedAt: nowMs()
-    };
-    if (includeRecent && config.mode === 'verbose') {
-        result.recentEvents = getRecentEvents();
-    }
-    return result;
-}
-function aggregateMatchingStats(aggregates, predicate) {
-    const matches = Object.entries(aggregates).filter(([key]) => predicate(key));
-    if (matches.length === 0) {
-        return undefined;
-    }
-    let count = 0;
-    let sum = 0;
-    let min = Infinity;
-    let max = -Infinity;
-    let last = 0;
-    for (const [, stats] of matches) {
-        count += stats.count;
-        sum += stats.sum;
-        if (stats.count > 0) {
-            if (stats.min < min)
-                min = stats.min;
-            if (stats.max > max)
-                max = stats.max;
-            last = stats.last;
-        }
-    }
-    return {
-        count,
-        min: count > 0 ? min : 0,
-        max: count > 0 ? max : 0,
-        avg: count > 0 ? sum / count : 0,
-        sum,
-        last
-    };
-}
-function formatDuration(ms) {
-    if (ms < 1) {
-        return `${(ms * 1000).toFixed(0)}μs`;
-    }
-    if (ms < 1000) {
-        return `${ms.toFixed(1)}ms`;
-    }
-    if (ms < 60000) {
-        return `${(ms / 1000).toFixed(2)}s`;
-    }
-    return `${(ms / 60000).toFixed(2)}m`;
-}
-function formatBytes(bytes) {
-    if (bytes < 1024)
-        return `${bytes.toFixed(0)} B`;
-    if (bytes < 1024 * 1024)
-        return `${(bytes / 1024).toFixed(1)} KB`;
-    if (bytes < 1024 * 1024 * 1024)
-        return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
-    return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GB`;
-}
-function formatThroughput(bps) {
-    if (bps < 1024)
-        return `${bps.toFixed(0)} B/s`;
-    if (bps < 1024 * 1024)
-        return `${(bps / 1024).toFixed(1)} KB/s`;
-    if (bps < 1024 * 1024 * 1024)
-        return `${(bps / (1024 * 1024)).toFixed(2)} MB/s`;
-    return `${(bps / (1024 * 1024 * 1024)).toFixed(2)} GB/s`;
-}
-function formatNumber(n) {
-    if (Number.isInteger(n)) {
-        return n.toLocaleString();
-    }
-    if (n === 0)
-        return '0';
-    if (Math.abs(n) < 0.01)
-        return n.toExponential(2);
-    if (Math.abs(n) < 1)
-        return n.toFixed(3);
-    if (Math.abs(n) < 100)
-        return n.toFixed(2);
-    return n.toFixed(1);
-}
-const METRIC_TYPE_REGISTRY = {
-    // Exceptions that patterns can't infer correctly
-    timeToFirstToken: 'duration',
-    totalSegments: 'number',
-    totalSamples: 'number'
-};
-function inferMetricTypeFromPattern(lowerName) {
-    if (lowerName.includes('bps') || lowerName.includes('speed')) {
-        return 'throughput';
-    }
-    if (lowerName.includes('bytes') ||
-        lowerName.includes('downloaded') ||
-        lowerName.includes('size')) {
-        return 'bytes';
-    }
-    if (lowerName.endsWith('time') ||
-        lowerName.endsWith('ms') ||
-        lowerName.endsWith('duration') ||
-        lowerName.includes('ttfb') ||
-        lowerName.includes('latency') ||
-        lowerName.includes('overhead') ||
-        lowerName.includes('execution')) {
-        return 'duration';
-    }
-    if (lowerName.includes('count') || lowerName.includes('tokens') || lowerName.includes('factor')) {
-        return 'number';
-    }
-    // Default to duration for unknown metrics (most profiling is timing)
-    return 'duration';
-}
-function detectMetricType(metricName) {
-    if (METRIC_TYPE_REGISTRY[metricName]) {
-        return METRIC_TYPE_REGISTRY[metricName];
-    }
-    return inferMetricTypeFromPattern(metricName.toLowerCase());
-}
-function formatMetricValue(value, metricName) {
-    const type = detectMetricType(metricName);
-    switch (type) {
-        case 'bytes':
-            return formatBytes(value);
-        case 'throughput':
-            return formatThroughput(value);
-        case 'number':
-            return formatNumber(value);
-        case 'duration':
-        default:
-            return formatDuration(value);
-    }
-}
-function pad(s, len, align = 'left') {
-    if (s.length >= len)
-        return s.substring(0, len);
-    const spaces = ' '.repeat(len - s.length);
-    return align === 'left' ? s + spaces : spaces + s;
-}
-export function exportTable() {
-    const aggregates = getAggregates();
-    const entries = Object.entries(aggregates);
-    if (entries.length === 0) {
-        return 'No profiling data recorded.';
-    }
-    const metricWidth = 48;
-    const numWidth = 12;
-    const header = [
-        pad('Metric', metricWidth),
-        pad('Count', numWidth, 'right'),
-        pad('Min', numWidth, 'right'),
-        pad('Max', numWidth, 'right'),
-        pad('Avg', numWidth, 'right'),
-        pad('Total', numWidth, 'right')
-    ].join(' | ');
-    const separator = '-'.repeat(header.length);
-    const rows = entries
-        .sort((a, b) => a[0].localeCompare(b[0]))
-        .map(([metric, stats]) => {
-        return [
-            pad(metric, metricWidth),
-            pad(formatNumber(stats.count), numWidth, 'right'),
-            pad(formatMetricValue(stats.min, metric), numWidth, 'right'),
-            pad(formatMetricValue(stats.max, metric), numWidth, 'right'),
-            pad(formatMetricValue(stats.avg, metric), numWidth, 'right'),
-            pad(formatMetricValue(stats.sum, metric), numWidth, 'right')
-        ].join(' | ');
-    });
-    return [separator, header, separator, ...rows, separator].join('\n');
-}
-export function exportSummary() {
-    const aggregates = getAggregates();
-    const config = getEffectiveConfig();
-    const eventCount = getEventCount();
-    const droppedCount = getDroppedCount();
-    const lines = [
-        '='.repeat(60),
-        'PROFILER SUMMARY',
-        '='.repeat(60),
-        '',
-        'Session:',
-        `  Status:        ${config.enabled ? 'enabled' : 'disabled'}`,
-        `  Mode:          ${config.mode}`,
-        `  Clock:         ${getClockSource()} (monotonic: ${isMonotonic()})`,
-        `  Events:        ${eventCount.toLocaleString()}`,
-        `  Dropped:       ${droppedCount.toLocaleString()}`,
-        ''
-    ];
-    const keyMetrics = [
-        {
-            label: 'RPC Total',
-            stats: aggregateMatchingStats(aggregates, (key) => key.endsWith('.totalClientTime'))
-        },
-        {
-            label: 'Handler',
-            stats: aggregateMatchingStats(aggregates, (key) => key.endsWith('.server.handlerExecution') || !key.includes('.'))
-        },
-        {
-            label: 'Model Load',
-            stats: aggregateMatchingStats(aggregates, (key) => key === 'load.totalTime' || key.endsWith('.load.totalTime'))
-        },
-        {
-            label: 'Download',
-            stats: aggregateMatchingStats(aggregates, (key) => key === 'download.time' || key.endsWith('.download.time'))
-        }
-    ];
-    const hasMetrics = keyMetrics.some((m) => m.stats);
-    if (hasMetrics) {
-        lines.push('Key Metrics:');
-        lines.push('-'.repeat(60));
-        lines.push('  ' +
-            'Metric'.padEnd(18) +
-            'Samples'.padStart(10) +
-            'Avg'.padStart(12) +
-            'Total'.padStart(12));
-        lines.push('-'.repeat(60));
-        for (const { label, stats } of keyMetrics) {
-            if (stats) {
-                const name = label.padEnd(18);
-                const samples = String(stats.count).padStart(10);
-                const avg = formatDuration(stats.avg).padStart(12);
-                const total = formatDuration(stats.sum).padStart(12);
-                lines.push(`  ${name}${samples}${avg}${total}`);
-            }
-        }
-    }
-    else {
-        lines.push('No metrics recorded yet.');
-    }
-    lines.push('');
-    lines.push('='.repeat(60));
-    return lines.join('\n');
-}

package/dist/profiling/index.d.ts

@@ -1,86 +0,0 @@
-/**
- * QVAC SDK Profiler
- *
- * @example
- * ```ts
- * import { profiler } from "@qvac/sdk";
- *
- * profiler.enable({ mode: "summary" });
- * // ... run SDK operations ...
- * console.log(profiler.exportTable());
- * profiler.disable();
- * ```
- */
-import * as controller from './controller.js';
-import type { ProfilerRuntimeOptions, ProfilingEvent, ProfilerExport, AggregatedStats } from './types.js';
-export declare const profiler: {
-    /**
-     * Enables profiling and resets all previously aggregated data.
-     *
-     * @param options - Optional runtime options (profiling mode, server breakdown, operation filters, ring-buffer capacity).
-     */
-    enable: (options?: ProfilerRuntimeOptions) => void;
-    /**
-     * Disables profiling. New SDK operations will no longer be recorded.
-     */
-    disable: () => void;
-    /**
-     * Returns whether profiling is currently enabled.
-     *
-     * @returns `true` when profiling is currently enabled, `false` otherwise.
-     */
-    isEnabled: () => boolean;
-    /**
-     * Exports profiling data as a structured JSON object suitable for machine consumption.
-     *
-     * @param options - Export options.
-     * @param options.includeRecentEvents - When `true`, includes the ring buffer of recent events in the export (only populated when profiler was enabled in `"verbose"` mode).
-     * @returns A `ProfilerExport` snapshot of aggregated stats and (optionally) recent events.
-     */
-    exportJSON: (options?: {
-        includeRecentEvents?: boolean;
-    }) => ProfilerExport;
-    /**
-     * Exports aggregated stats as a formatted ASCII table suitable for terminal output.
-     *
-     * @returns A multi-line string rendering of the aggregated stats table.
-     */
-    exportTable: () => string;
-    /**
-     * Exports a short, human-readable summary string of the aggregated stats.
-     *
-     * @returns A one-paragraph summary of the profiling data.
-     */
-    exportSummary: () => string;
-    /**
-     * Registers a listener for profiling events; returns an unsubscribe function.
-     *
-     * @param callback - Invoked once per recorded profiling event.
-     * @returns An unsubscribe function; call it to remove the listener.
-     */
-    onRecord: (callback: (event: ProfilingEvent) => void) => () => void;
-    /**
-     * Returns the current effective profiler configuration.
-     *
-     * @returns The effective `ResolvedProfilerConfig` (defaults merged with user overrides).
-     */
-    getConfig: () => controller.ResolvedProfilerConfig;
-    /**
-     * Returns all aggregated stats keyed by operation name.
-     *
-     * @returns A record of `AggregatedStats` keyed by operation name.
-     */
-    getAggregates: () => Record<string, AggregatedStats>;
-    /**
-     * Clears all aggregated data and the recent-events ring buffer.
-     */
-    clear: () => void;
-};
-export type { ProfilerRuntimeOptions, ProfilingEvent, ProfilerExport, AggregatedStats, ProfilingEventKind } from './types.js';
-export type { ProfilerMode, ProfilerGPUResourceGauge, ProfilerResourceGauge } from '../schemas/index.js';
-export { nowMs } from './clock.js';
-export { attachBackendDiagnostics } from './backend-diagnostics.js';
-export { record, shouldProfile, shouldIncludeServerBreakdown, shouldIncludeResourceGauges, generateId, isEnabled, type ResolvedProfilerConfig } from './controller.js';
-export { createProfilingMeta, createDelegatedProfilingMeta, createProfilingDisabledMeta, injectProfilingMetaIntoObject, extractProfilingMeta, stripProfilingMeta } from './envelope.js';
-export { recordPhase, recordFailure, recordServerBreakdownPhases, recordDelegationBreakdownPhases, type BaseTimings, type BaseEvent } from './events.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/profiling/index.js

@@ -1,81 +0,0 @@
-/**
- * QVAC SDK Profiler
- *
- * @example
- * ```ts
- * import { profiler } from "@qvac/sdk";
- *
- * profiler.enable({ mode: "summary" });
- * // ... run SDK operations ...
- * console.log(profiler.exportTable());
- * profiler.disable();
- * ```
- */
-import * as controller from './controller.js';
-import * as exporters from './exporters.js';
-export const profiler = {
-    /**
-     * Enables profiling and resets all previously aggregated data.
-     *
-     * @param options - Optional runtime options (profiling mode, server breakdown, operation filters, ring-buffer capacity).
-     */
-    enable: (options) => controller.enable(options),
-    /**
-     * Disables profiling. New SDK operations will no longer be recorded.
-     */
-    disable: () => controller.disable(),
-    /**
-     * Returns whether profiling is currently enabled.
-     *
-     * @returns `true` when profiling is currently enabled, `false` otherwise.
-     */
-    isEnabled: () => controller.isEnabled(),
-    /**
-     * Exports profiling data as a structured JSON object suitable for machine consumption.
-     *
-     * @param options - Export options.
-     * @param options.includeRecentEvents - When `true`, includes the ring buffer of recent events in the export (only populated when profiler was enabled in `"verbose"` mode).
-     * @returns A `ProfilerExport` snapshot of aggregated stats and (optionally) recent events.
-     */
-    exportJSON: (options) => exporters.exportJSON(options),
-    /**
-     * Exports aggregated stats as a formatted ASCII table suitable for terminal output.
-     *
-     * @returns A multi-line string rendering of the aggregated stats table.
-     */
-    exportTable: () => exporters.exportTable(),
-    /**
-     * Exports a short, human-readable summary string of the aggregated stats.
-     *
-     * @returns A one-paragraph summary of the profiling data.
-     */
-    exportSummary: () => exporters.exportSummary(),
-    /**
-     * Registers a listener for profiling events; returns an unsubscribe function.
-     *
-     * @param callback - Invoked once per recorded profiling event.
-     * @returns An unsubscribe function; call it to remove the listener.
-     */
-    onRecord: (callback) => controller.onRecord(callback),
-    /**
-     * Returns the current effective profiler configuration.
-     *
-     * @returns The effective `ResolvedProfilerConfig` (defaults merged with user overrides).
-     */
-    getConfig: () => controller.getEffectiveConfig(),
-    /**
-     * Returns all aggregated stats keyed by operation name.
-     *
-     * @returns A record of `AggregatedStats` keyed by operation name.
-     */
-    getAggregates: () => controller.getAggregates(),
-    /**
-     * Clears all aggregated data and the recent-events ring buffer.
-     */
-    clear: () => controller.clear()
-};
-export { nowMs } from './clock.js';
-export { attachBackendDiagnostics } from './backend-diagnostics.js';
-export { record, shouldProfile, shouldIncludeServerBreakdown, shouldIncludeResourceGauges, generateId, isEnabled } from './controller.js';
-export { createProfilingMeta, createDelegatedProfilingMeta, createProfilingDisabledMeta, injectProfilingMetaIntoObject, extractProfilingMeta, stripProfilingMeta } from './envelope.js';
-export { recordPhase, recordFailure, recordServerBreakdownPhases, recordDelegationBreakdownPhases } from './events.js';

package/dist/profiling/model-execution.d.ts

@@ -1,16 +0,0 @@
-/**
- * Helpers for propagating model execution timing via internal symbols.
- */
-export declare function hasDefinedValues<T extends Record<string, unknown>>(obj: T): boolean;
-export declare function attachModelExecutionMs<T>(target: T, ms: number | undefined): T;
-export declare function readModelExecutionMs(target: unknown): number | undefined;
-export declare function forwardModelExecution<T>(target: T, source: unknown): T;
-export interface StreamResult<S = unknown> {
-    modelExecutionMs: number;
-    stats?: S;
-}
-export declare function buildStreamResult<S extends Record<string, unknown>>(modelExecutionMs: number, stats?: S): StreamResult<S>;
-export declare function buildUnaryResult<T extends Record<string, unknown>, S extends Record<string, unknown>>(response: T, modelExecutionMs: number, stats?: S): T & {
-    stats?: S;
-};
-//# sourceMappingURL=model-execution.d.ts.map