@qvac/sdk 0.14.1 → 0.15.0

package/dist/profiling/controller.js

@@ -6,24 +6,24 @@
  * 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";
+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",
+    mode: 'summary',
     includeServerBreakdown: false,
     operationFilters: [],
-    maxRecentEvents: 1000,
+    maxRecentEvents: 1000
 };
-const CONTROLLER_STATE_KEY = Symbol.for("@qvac/sdk:profiler-controller-state");
+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,
+            initialized: false
         };
     });
     if (!state.initialized) {
@@ -54,12 +54,11 @@ export function getEffectiveConfig() {
     return {
         enabled: isEnabled(),
         mode: state.runtimeOptions.mode ?? DEFAULT_CONFIG.mode,
-        includeServerBreakdown: state.runtimeOptions.includeServerBreakdown ??
-            DEFAULT_CONFIG.includeServerBreakdown,
+        includeServerBreakdown: state.runtimeOptions.includeServerBreakdown ?? DEFAULT_CONFIG.includeServerBreakdown,
         operationFilters: [
-            ...(state.runtimeOptions.operationFilters ?? DEFAULT_CONFIG.operationFilters),
+            ...(state.runtimeOptions.operationFilters ?? DEFAULT_CONFIG.operationFilters)
         ],
-        maxRecentEvents: DEFAULT_CONFIG.maxRecentEvents,
+        maxRecentEvents: DEFAULT_CONFIG.maxRecentEvents
     };
 }
 export function shouldProfile(operation, perCallOptions) {
@@ -90,7 +89,7 @@ export function record(event) {
     if (event.ts === undefined) {
         eventWithTs = { ...event, ts: nowMs() };
     }
-    const storeInBuffer = getEffectiveConfig().mode === "verbose";
+    const storeInBuffer = getEffectiveConfig().mode === 'verbose';
     aggregatorRecord(eventWithTs, storeInBuffer);
     for (const cb of state.onRecordCallbacks) {
         try {

package/dist/profiling/envelope.d.ts

@@ -1,7 +1,7 @@
 /**
  * Helpers to inject/extract __profiling metadata in RPC payloads.
  */
-import { type ProfilingRequestMeta, type ProfilingResponseMeta } from "../schemas/index";
+import { type ProfilingRequestMeta, type ProfilingResponseMeta } from '../schemas/index';
 export declare function createProfilingMeta(profileId: string, includeServerBreakdown: boolean): ProfilingRequestMeta;
 export declare function createProfilingDisabledMeta(): ProfilingRequestMeta;
 export declare function injectProfilingMetaIntoObject(obj: Record<string, unknown>, meta: ProfilingRequestMeta): Record<string, unknown>;

package/dist/profiling/envelope.js

@@ -1,12 +1,12 @@
 /**
  * Helpers to inject/extract __profiling metadata in RPC payloads.
  */
-import { PROFILING_KEY, } from "../schemas/index.js";
+import { PROFILING_KEY } from '../schemas/index.js';
 export function createProfilingMeta(profileId, includeServerBreakdown) {
     return {
         enabled: true,
         id: profileId,
-        includeServer: includeServerBreakdown,
+        includeServer: includeServerBreakdown
     };
 }
 export function createProfilingDisabledMeta() {
@@ -16,11 +16,9 @@ export function injectProfilingMetaIntoObject(obj, meta) {
     return { ...obj, [PROFILING_KEY]: meta };
 }
 export function extractProfilingMeta(payload) {
-    if (typeof payload === "object" &&
-        payload !== null &&
-        PROFILING_KEY in payload) {
+    if (typeof payload === 'object' && payload !== null && PROFILING_KEY in payload) {
         const meta = payload[PROFILING_KEY];
-        if (typeof meta === "object" && meta !== null) {
+        if (typeof meta === 'object' && meta !== null) {
             return meta;
         }
     }

package/dist/profiling/events.d.ts

@@ -1,5 +1,5 @@
-import type { ProfilingEventKind } from "./types";
-import type { ServerBreakdown, DelegationBreakdown } from "../schemas/index";
+import type { ProfilingEventKind } from './types';
+import type { ServerBreakdown, DelegationBreakdown } from '../schemas/index';
 export interface BaseTimings {
     profileId: string;
     requestType: string;

package/dist/profiling/events.js

@@ -1,5 +1,5 @@
-import { nowMs } from "./clock.js";
-import { record } from "./controller.js";
+import { nowMs } from './clock.js';
+import { record } from './controller.js';
 export function recordPhase(base, phase, ms, extra) {
     if (ms === undefined)
         return;
@@ -10,17 +10,15 @@ export function recordFailure(base, startTime, error) {
     record({
         ...base,
         ts: now,
-        phase: "failed",
+        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),
-        },
+            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") {
+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);
@@ -28,7 +26,7 @@ export function recordServerBreakdownPhases(base, server, prefix = "server") {
     recordPhase(base, `${prefix}.response.stringify`, server.responseStringifyMs);
     recordPhase(base, `${prefix}.totalServerTime`, server.totalServerMs);
 }
-export function recordDelegationBreakdownPhases(base, delegation, prefix = "delegation") {
+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);

package/dist/profiling/exporters.d.ts

@@ -1,7 +1,7 @@
 /**
  * JSON, table, and summary export utilities for profiling data.
  */
-import type { ProfilerExport } from "./types";
+import type { ProfilerExport } from './types';
 export declare function exportJSON(options?: {
     includeRecentEvents?: boolean;
 }): ProfilerExport;

package/dist/profiling/exporters.js

@@ -1,18 +1,18 @@
 /**
  * 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";
+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(),
+        exportedAt: nowMs()
     };
-    if (includeRecent && config.mode === "verbose") {
+    if (includeRecent && config.mode === 'verbose') {
         result.recentEvents = getRecentEvents();
     }
     return result;
@@ -44,7 +44,7 @@ function aggregateMatchingStats(aggregates, predicate) {
         max: count > 0 ? max : 0,
         avg: count > 0 ? sum / count : 0,
         sum,
-        last,
+        last
     };
 }
 function formatDuration(ms) {
@@ -82,7 +82,7 @@ function formatNumber(n) {
         return n.toLocaleString();
     }
     if (n === 0)
-        return "0";
+        return '0';
     if (Math.abs(n) < 0.01)
         return n.toExponential(2);
     if (Math.abs(n) < 1)
@@ -93,31 +93,33 @@ function formatNumber(n) {
 }
 const METRIC_TYPE_REGISTRY = {
     // Exceptions that patterns can't infer correctly
-    timeToFirstToken: "duration",
-    totalSegments: "number",
-    totalSamples: "number",
+    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";
+    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";
+    return 'duration';
 }
 function detectMetricType(metricName) {
     if (METRIC_TYPE_REGISTRY[metricName]) {
@@ -128,53 +130,53 @@ function detectMetricType(metricName) {
 function formatMetricValue(value, metricName) {
     const type = detectMetricType(metricName);
     switch (type) {
-        case "bytes":
+        case 'bytes':
             return formatBytes(value);
-        case "throughput":
+        case 'throughput':
             return formatThroughput(value);
-        case "number":
+        case 'number':
             return formatNumber(value);
-        case "duration":
+        case 'duration':
         default:
             return formatDuration(value);
     }
 }
-function pad(s, len, align = "left") {
+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;
+    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.";
+        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);
+        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(" | ");
+            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");
+    return [separator, header, separator, ...rows, separator].join('\n');
 }
 export function exportSummary() {
     const aggregates = getAggregates();
@@ -182,46 +184,46 @@ export function exportSummary() {
     const eventCount = getEventCount();
     const droppedCount = getDroppedCount();
     const lines = [
-        "=".repeat(60),
-        "PROFILER SUMMARY",
-        "=".repeat(60),
-        "",
-        "Session:",
-        `  Status:        ${config.enabled ? "enabled" : "disabled"}`,
+        '='.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: 'RPC Total',
+            stats: aggregateMatchingStats(aggregates, (key) => key.endsWith('.totalClientTime'))
         },
         {
-            label: "Handler",
-            stats: aggregateMatchingStats(aggregates, (key) => key.endsWith(".server.handlerExecution") || !key.includes(".")),
+            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: '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")),
-        },
+            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));
+        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);
@@ -233,9 +235,9 @@ export function exportSummary() {
         }
     }
     else {
-        lines.push("No metrics recorded yet.");
+        lines.push('No metrics recorded yet.');
     }
-    lines.push("");
-    lines.push("=".repeat(60));
-    return lines.join("\n");
+    lines.push('');
+    lines.push('='.repeat(60));
+    return lines.join('\n');
 }

package/dist/profiling/index.d.ts

@@ -11,8 +11,8 @@
  * profiler.disable();
  * ```
  */
-import * as controller from "./controller";
-import type { ProfilerRuntimeOptions, ProfilingEvent, ProfilerExport, AggregatedStats } from "./types";
+import * as controller from './controller';
+import type { ProfilerRuntimeOptions, ProfilingEvent, ProfilerExport, AggregatedStats } from './types';
 export declare const profiler: {
     /**
      * Enables profiling and resets all previously aggregated data.
@@ -76,10 +76,10 @@ export declare const profiler: {
      */
     clear: () => void;
 };
-export type { ProfilerRuntimeOptions, ProfilingEvent, ProfilerExport, AggregatedStats, ProfilingEventKind, } from "./types";
-export type { ProfilerMode } from "../schemas/index";
-export { nowMs } from "./clock";
-export { record, shouldProfile, shouldIncludeServerBreakdown, generateId, isEnabled, type ResolvedProfilerConfig, } from "./controller";
-export { createProfilingMeta, createProfilingDisabledMeta, injectProfilingMetaIntoObject, extractProfilingMeta, stripProfilingMeta, } from "./envelope";
-export { recordPhase, recordFailure, recordServerBreakdownPhases, recordDelegationBreakdownPhases, type BaseTimings, type BaseEvent, } from "./events";
+export type { ProfilerRuntimeOptions, ProfilingEvent, ProfilerExport, AggregatedStats, ProfilingEventKind } from './types';
+export type { ProfilerMode } from '../schemas/index';
+export { nowMs } from './clock';
+export { record, shouldProfile, shouldIncludeServerBreakdown, generateId, isEnabled, type ResolvedProfilerConfig } from './controller';
+export { createProfilingMeta, createProfilingDisabledMeta, injectProfilingMetaIntoObject, extractProfilingMeta, stripProfilingMeta } from './envelope';
+export { recordPhase, recordFailure, recordServerBreakdownPhases, recordDelegationBreakdownPhases, type BaseTimings, type BaseEvent } from './events';
 //# sourceMappingURL=index.d.ts.map

package/dist/profiling/index.js

@@ -11,8 +11,8 @@
  * profiler.disable();
  * ```
  */
-import * as controller from "./controller.js";
-import * as exporters from "./exporters.js";
+import * as controller from './controller.js';
+import * as exporters from './exporters.js';
 export const profiler = {
     /**
      * Enables profiling and resets all previously aggregated data.
@@ -72,9 +72,9 @@ export const profiler = {
     /**
      * Clears all aggregated data and the recent-events ring buffer.
      */
-    clear: () => controller.clear(),
+    clear: () => controller.clear()
 };
-export { nowMs } from "./clock.js";
-export { record, shouldProfile, shouldIncludeServerBreakdown, generateId, isEnabled, } from "./controller.js";
-export { createProfilingMeta, createProfilingDisabledMeta, injectProfilingMetaIntoObject, extractProfilingMeta, stripProfilingMeta, } from "./envelope.js";
-export { recordPhase, recordFailure, recordServerBreakdownPhases, recordDelegationBreakdownPhases, } from "./events.js";
+export { nowMs } from './clock.js';
+export { record, shouldProfile, shouldIncludeServerBreakdown, generateId, isEnabled } from './controller.js';
+export { createProfilingMeta, createProfilingDisabledMeta, injectProfilingMetaIntoObject, extractProfilingMeta, stripProfilingMeta } from './envelope.js';
+export { recordPhase, recordFailure, recordServerBreakdownPhases, recordDelegationBreakdownPhases } from './events.js';

package/dist/profiling/model-execution.js

@@ -1,12 +1,13 @@
 /**
  * Helpers for propagating model execution timing via internal symbols.
  */
-import { MODEL_EXECUTION_KEY } from "../schemas/index.js";
+import { MODEL_EXECUTION_KEY } from '../schemas/index.js';
 export function hasDefinedValues(obj) {
     return Object.values(obj).some((v) => v !== undefined);
 }
 export function attachModelExecutionMs(target, ms) {
     if (ms !== undefined) {
+        ;
         target[MODEL_EXECUTION_KEY] = ms;
     }
     return target;

package/dist/profiling/ring-buffer.js

@@ -2,7 +2,7 @@
  * O(1) bounded buffer for event storage.
  * Oldest events are overwritten when full.
  */
-import { ProfilerInvalidCapacityError } from "../utils/errors-client.js";
+import { ProfilerInvalidCapacityError } from '../utils/errors-client.js';
 export function createRingBuffer(capacity) {
     if (capacity < 1) {
         throw new ProfilerInvalidCapacityError(1);
@@ -12,7 +12,7 @@ export function createRingBuffer(capacity) {
         capacity,
         head: 0,
         size: 0,
-        totalPushed: 0,
+        totalPushed: 0
     };
 }
 // Returns the overwritten item if buffer was full, undefined otherwise.

package/dist/profiling/types.d.ts

@@ -1,4 +1,4 @@
-export type ProfilingEventKind = "rpc" | "handler" | "download" | "load" | "delegation";
+export type ProfilingEventKind = 'rpc' | 'handler' | 'download' | 'load' | 'delegation';
 export interface ProfilingEvent {
     /** Timestamp when event was recorded (monotonic ms) */
     ts: number;
@@ -16,7 +16,7 @@ export interface ProfilingEvent {
     tags?: Record<string, string>;
 }
 export interface ProfilerRuntimeOptions {
-    mode?: "summary" | "verbose";
+    mode?: 'summary' | 'verbose';
     includeServerBreakdown?: boolean;
     operationFilters?: string[];
 }
@@ -31,7 +31,7 @@ export interface AggregatedStats {
 export interface ProfilerExport {
     config: {
         enabled: boolean;
-        mode: "summary" | "verbose";
+        mode: 'summary' | 'verbose';
         includeServerBreakdown: boolean;
         operationFilters: string[];
         maxRecentEvents: number;

package/dist/schemas/archive.d.ts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import { z } from 'zod';
 export declare const SUPPORTED_ARCHIVE_EXTENSIONS: readonly [".tar", ".tar.gz", ".tgz"];
 export declare const archiveTypeSchema: z.ZodEnum<{
     tar: "tar";

package/dist/schemas/archive.js

@@ -1,17 +1,11 @@
-import { z } from "zod";
-export const SUPPORTED_ARCHIVE_EXTENSIONS = [
-    ".tar",
-    ".tar.gz",
-    ".tgz",
-];
-export const archiveTypeSchema = z.enum(["tar", "tar.gz"]);
-export const filenameToArchiveTypeSchema = z
-    .string()
-    .transform((filename) => {
+import { z } from 'zod';
+export const SUPPORTED_ARCHIVE_EXTENSIONS = ['.tar', '.tar.gz', '.tgz'];
+export const archiveTypeSchema = z.enum(['tar', 'tar.gz']);
+export const filenameToArchiveTypeSchema = z.string().transform((filename) => {
     const lower = filename.toLowerCase();
-    if (lower.endsWith(".tar.gz") || lower.endsWith(".tgz"))
-        return "tar.gz";
-    if (lower.endsWith(".tar"))
-        return "tar";
+    if (lower.endsWith('.tar.gz') || lower.endsWith('.tgz'))
+        return 'tar.gz';
+    if (lower.endsWith('.tar'))
+        return 'tar';
     return null;
 });