@missionsquad/browserai 0.1.0

package/dist/history.d.ts

@@ -0,0 +1,81 @@
+import type { ModelPreset } from "./models.js";
+import type { StorageLike } from "./config.js";
+/**
+ * Run-history persistence + aggregation. Ported from small-ai with the storage injected: pass any
+ * `StorageLike` (or `null` for in-memory only); the default is `globalThis.localStorage` when present.
+ */
+/** Suggested task keys for logged runs (hosts may use their own strings). */
+export type RunCaseKey = "json" | "chat" | "summarize" | "classify" | "qa" | "voice" | "vision";
+export type ModelVendor = "qwen" | "google" | "meta" | "openai" | "ibm" | "microsoft" | "nvidia" | "liquid" | "huggingface" | "mistral" | "other";
+/**
+ * One logged generation. This is the persisted shape, so every field is a primitive and the
+ * set is intentionally minimal: exactly what comparison views need to rebuild their aggregates
+ * (decode/ttft by model, run log) without storing full prompts/outputs. Storing raw text or
+ * per-token arrays would blow up the storage footprint, so those are excluded.
+ */
+export type RunRecord = {
+    /** Epoch milliseconds. */
+    ts: number;
+    /** Model short name, e.g. "Qwen3.5 0.8B". */
+    model: string;
+    /** Derived vendor bucket for filtering/labels. */
+    vendor: ModelVendor;
+    /** Backend used for the run. */
+    backend: "webllm" | "transformers-js";
+    /** Task key ({@link RunCaseKey} suggested; any non-empty string accepted). */
+    case: string;
+    promptTokens: number;
+    completionTokens: number;
+    /** Decode speed in tokens/sec. */
+    decode: number;
+    /** Time to first token in seconds. */
+    ttft: number;
+    /** Measured wall-clock time in milliseconds. */
+    totalMs: number;
+    /** Measured completion tokens/sec over wall-clock time. */
+    measured: number;
+};
+export type ModelAggregate = {
+    model: string;
+    vendor: ModelVendor;
+    runs: number;
+    decode: number;
+    ttft: number;
+    totalMs: number;
+    measured: number;
+};
+export declare const DEFAULT_HISTORY_KEY = "browserai:v1:history";
+export declare const DEFAULT_HISTORY_MAX_RECORDS = 200;
+export type RunHistoryOptions = {
+    /** Persistence. Defaults to `globalThis.localStorage` when available; `null` = in-memory only. */
+    storage?: StorageLike | null;
+    key?: string;
+    maxRecords?: number;
+};
+/**
+ * A persisted, capped run log (newest first). All storage errors are swallowed: quota failures and
+ * unavailable storage degrade to in-memory history rather than breaking generation flows.
+ */
+export declare class RunHistoryStore {
+    #private;
+    constructor(options?: RunHistoryOptions);
+    /** The in-memory records, newest first. */
+    get records(): readonly RunRecord[];
+    /** Prepend a record and persist. Returns the updated list. */
+    append(record: RunRecord): readonly RunRecord[];
+    /** Overwrite the history (e.g. after deleting selected rows). */
+    replace(records: RunRecord[]): void;
+    clear(): void;
+    aggregateByModel(caseFilter?: string | "all"): ModelAggregate[];
+}
+/**
+ * Derive a vendor bucket from a preset. Uses explicit id/name matching rather than the repo owner
+ * so re-hosted artifacts (e.g. onnx-community mirrors) still map to the true model vendor.
+ */
+export declare function vendorForModel(preset: ModelPreset): ModelVendor;
+export declare const VENDOR_LABELS: Record<ModelVendor, string>;
+/**
+ * Group runs by model (optionally filtered by case) and average the per-run metrics.
+ */
+export declare function aggregateByModel(history: readonly RunRecord[], caseFilter: string | "all"): ModelAggregate[];
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,IAAI,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhG,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,KAAK,GACL,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,aAAa,GACb,SAAS,GACT,OAAO,CAAC;AAEZ;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,MAAM,EAAE,WAAW,CAAC;IACpB,gCAAgC;IAChC,OAAO,EAAE,QAAQ,GAAG,iBAAiB,CAAC;IACtC,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAC1D,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAgB/C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,kGAAkG;IAClG,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAuCF;;;GAGG;AACH,qBAAa,eAAe;;gBAMd,OAAO,GAAE,iBAAsB;IAO3C,2CAA2C;IAC3C,IAAI,OAAO,IAAI,SAAS,SAAS,EAAE,CAElC;IAED,8DAA8D;IAC9D,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,SAAS,EAAE;IAM/C,iEAAiE;IACjE,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI;IAKnC,KAAK,IAAI,IAAI;IASb,gBAAgB,CAAC,UAAU,GAAE,MAAM,GAAG,KAAa,GAAG,cAAc,EAAE;CAyBvE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAe/D;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAYrD,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,cAAc,EAAE,CAuB5G"}

package/dist/history.js

@@ -0,0 +1,193 @@
+export const DEFAULT_HISTORY_KEY = "browserai:v1:history";
+export const DEFAULT_HISTORY_MAX_RECORDS = 200;
+const VALID_VENDORS = new Set([
+    "qwen",
+    "google",
+    "meta",
+    "openai",
+    "ibm",
+    "microsoft",
+    "nvidia",
+    "liquid",
+    "huggingface",
+    "mistral",
+    "other",
+]);
+function defaultStorage() {
+    try {
+        // `localStorage` can throw in private-mode / sandboxed contexts; history becomes ephemeral.
+        return globalThis.localStorage ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function isFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value);
+}
+function coerceRecord(value) {
+    if (!value || typeof value !== "object")
+        return null;
+    const record = value;
+    const numericKeys = ["ts", "promptTokens", "completionTokens", "decode", "ttft", "totalMs", "measured"];
+    for (const key of numericKeys) {
+        if (!isFiniteNumber(record[key]))
+            return null;
+    }
+    if (typeof record.model !== "string" || typeof record.case !== "string" || record.case.length === 0)
+        return null;
+    return {
+        ts: record.ts,
+        model: record.model,
+        vendor: VALID_VENDORS.has(record.vendor) ? record.vendor : "other",
+        backend: record.backend === "transformers-js" ? "transformers-js" : "webllm",
+        case: record.case,
+        promptTokens: record.promptTokens,
+        completionTokens: record.completionTokens,
+        decode: record.decode,
+        ttft: record.ttft,
+        totalMs: record.totalMs,
+        measured: record.measured,
+    };
+}
+/**
+ * A persisted, capped run log (newest first). All storage errors are swallowed: quota failures and
+ * unavailable storage degrade to in-memory history rather than breaking generation flows.
+ */
+export class RunHistoryStore {
+    #storage;
+    #key;
+    #maxRecords;
+    #records;
+    constructor(options = {}) {
+        this.#storage = options.storage === undefined ? defaultStorage() : options.storage;
+        this.#key = options.key ?? DEFAULT_HISTORY_KEY;
+        this.#maxRecords = options.maxRecords ?? DEFAULT_HISTORY_MAX_RECORDS;
+        this.#records = this.#load();
+    }
+    /** The in-memory records, newest first. */
+    get records() {
+        return this.#records;
+    }
+    /** Prepend a record and persist. Returns the updated list. */
+    append(record) {
+        this.#records = [record, ...this.#records].slice(0, this.#maxRecords);
+        this.#persist(this.#records);
+        return this.#records;
+    }
+    /** Overwrite the history (e.g. after deleting selected rows). */
+    replace(records) {
+        this.#records = records.slice(0, this.#maxRecords);
+        this.#persist(this.#records);
+    }
+    clear() {
+        this.#records = [];
+        try {
+            this.#storage?.removeItem(this.#key);
+        }
+        catch {
+            // Clearing is best-effort.
+        }
+    }
+    aggregateByModel(caseFilter = "all") {
+        return aggregateByModel(this.#records, caseFilter);
+    }
+    #load() {
+        if (!this.#storage)
+            return [];
+        try {
+            const raw = this.#storage.getItem(this.#key);
+            if (!raw)
+                return [];
+            const parsed = JSON.parse(raw);
+            if (!Array.isArray(parsed))
+                return [];
+            return parsed.map(coerceRecord).filter((record) => record !== null);
+        }
+        catch {
+            return [];
+        }
+    }
+    #persist(records) {
+        if (!this.#storage)
+            return;
+        try {
+            this.#storage.setItem(this.#key, JSON.stringify(records));
+        }
+        catch {
+            // Quota errors are non-fatal; the list still lives in memory for this session.
+        }
+    }
+}
+/**
+ * Derive a vendor bucket from a preset. Uses explicit id/name matching rather than the repo owner
+ * so re-hosted artifacts (e.g. onnx-community mirrors) still map to the true model vendor.
+ */
+export function vendorForModel(preset) {
+    const haystack = `${preset.id} ${preset.shortName}`.toLowerCase();
+    if (haystack.includes("qwen"))
+        return "qwen";
+    if (haystack.includes("gemma"))
+        return "google";
+    if (haystack.includes("llama") || haystack.includes("hermes"))
+        return "meta";
+    if (haystack.includes("whisper"))
+        return "openai";
+    if (haystack.includes("granite"))
+        return "ibm";
+    if (haystack.includes("phi"))
+        return "microsoft";
+    if (haystack.includes("nemotron") || haystack.includes("parakeet"))
+        return "nvidia";
+    if (haystack.includes("lfm") || haystack.includes("liquid"))
+        return "liquid";
+    if (haystack.includes("smollm") || haystack.includes("smolvlm"))
+        return "huggingface";
+    if (haystack.includes("mistral") || haystack.includes("ministral") || haystack.includes("voxtral"))
+        return "mistral";
+    if (haystack.includes("olmo"))
+        return "other";
+    if (haystack.includes("minicpm"))
+        return "other";
+    return "other";
+}
+export const VENDOR_LABELS = {
+    qwen: "Qwen",
+    google: "Google",
+    meta: "Meta",
+    openai: "OpenAI",
+    ibm: "IBM",
+    microsoft: "Microsoft",
+    nvidia: "NVIDIA",
+    liquid: "Liquid",
+    huggingface: "HuggingFace",
+    mistral: "Mistral",
+    other: "Other",
+};
+/**
+ * Group runs by model (optionally filtered by case) and average the per-run metrics.
+ */
+export function aggregateByModel(history, caseFilter) {
+    const buckets = new Map();
+    for (const record of history) {
+        if (caseFilter !== "all" && record.case !== caseFilter)
+            continue;
+        const bucket = buckets.get(record.model) ?? { vendor: record.vendor, runs: 0, decode: 0, ttft: 0, totalMs: 0, measured: 0 };
+        bucket.runs += 1;
+        bucket.decode += record.decode;
+        bucket.ttft += record.ttft;
+        bucket.totalMs += record.totalMs;
+        bucket.measured += record.measured;
+        buckets.set(record.model, bucket);
+    }
+    return Array.from(buckets.entries()).map(([model, bucket]) => ({
+        model,
+        vendor: bucket.vendor,
+        runs: bucket.runs,
+        decode: bucket.decode / bucket.runs,
+        ttft: bucket.ttft / bucket.runs,
+        totalMs: bucket.totalMs / bucket.runs,
+        measured: bucket.measured / bucket.runs,
+    }));
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @missionsquad/browserai — run small open AI models entirely in the browser with WebGPU.
+ *
+ * Core entry points:
+ * - {@link BrowserAI} — model catalog + capability-slot manager + inference façade.
+ * - {@link VoicePipeline} — headless press-to-talk voice assistant (mic → STT → LLM → TTS).
+ */
+export { BrowserAI, buildModelCacheTarget, normalizeContextLength } from "./client.js";
+export type { BrowserAIEvents, GenerateTextOptions, LoadOptions, LoadProgress, LoadedModel, StreamingTtsSession, TtsOverrides } from "./client.js";
+export { DEFAULT_CONTEXT_LENGTH, resolveConfig } from "./config.js";
+export type { BrowserAIConfig, HistoryOptions, KokoroOptions, ResolvedConfig, StorageLike, TtsDefaults, WebLLMOptions } from "./config.js";
+export { BrowserAIError, formatError, MicrophoneError, MissingModelError, ModelLoadError, ProxyVerificationError, UnknownModelError, VoiceTurnError, WebGPUUnavailableError, } from "./errors.js";
+export { TypedEmitter } from "./events.js";
+export type { EventMap, Listener } from "./events.js";
+export { applyCuratedModelRecordOverrides, CUSTOM_MODEL_RECORD_IDS, CUSTOM_MODEL_RECORDS, formatMB, getModelPreset, KOKORO_MODEL_ID, KOKORO_VOICES, MODALITY_ICONS, MODALITY_LABELS, MODEL_PRESETS, MODEL_RECORD_OVERRIDES, modelRepoLabel, modelSlots, presetModalityIn, presetModalityOut, presetTasks, SLOT_ORDER, SUPERTONIC_2_MODEL_ID, SUPERTONIC_MODEL_ID, SUPERTONIC_VOICES, TASK_ICONS, TASK_LABELS, ttsVoicesForModel, } from "./models.js";
+export type { Modality, ModelBackend, ModelPreset, ModelTask, MultimodalRuntime, RuntimePreset, TtsVoice } from "./models.js";
+export { buildResponseFormat, clampNumber, parseOptionalInteger, runtimeParamsFromPreset } from "./generation.js";
+export type { JsonMode, RuntimeParameters } from "./generation.js";
+export { buildRuntimeStatsText, collectGenericStats, EMPTY_RESPONSE, generate, normalizeLatencyBreakdown } from "./inference.js";
+export type { ChatMessage, EngineHandles, GenerateOptions, GenerationResult, LatencyBreakdown, RuntimeStats, TransformersModule, TransformersTextGenerationPipeline, TransformersTokenizer, WebLLMUsageExtra, } from "./inference.js";
+export { capSrc, DEFAULT_KOKORO_CDN, describeImage, disposeMultimodal, generateGemmaText, loadMultimodal, planGemmaAudioWindows, runAudioLm, runGemma, runVoxtralRealtime, supertonicVoiceUrl, supportsStreamingTts, synthesize, synthesizeStream, transcribe, } from "./multimodal.js";
+export type { AudioWindow, GenStats, KokoroModule, LoadMultimodalOptions, MultimodalDevice, MultimodalHandle, MultimodalTransformers, ProgressCallback, RawAudio, SttResult, TextTurn, TtsTextSplitter, VlmResult, } from "./multimodal.js";
+export { detectLikelyRepetition, extractJsonCandidate, normalizeModelText, parseJsonFromModel, prettyJson } from "./json.js";
+export type { JsonParseResult } from "./json.js";
+export { validateAgainstJsonSchema } from "./schema-validator.js";
+export { DEFAULT_EXTRACTION_SCHEMA, stringifySchema, stripSchemaMetadata } from "./schema.js";
+export { buildExtractionMessages, DEFAULT_EXTRACTION_INSTRUCTIONS } from "./prompt.js";
+export { applyContextOverride, buildProxiedAppConfig, buildWebLLMAppConfig, modelSourceDescription, proxyHuggingFaceUrl, proxyModelLibraryUrl, proxyModelRecord, proxyRawGithubUrl, TRANSFORMERS_CACHE_KEY, withCustomModelRecords, } from "./model-source.js";
+export type { BrowserCacheBackend, ModelSourceMode } from "./model-source.js";
+export { splitHuggingFaceRepoId, verifyTransformersProxy, verifyWebLLMProxy } from "./proxy-verify.js";
+export { collectHardwareSnapshot, formatBytes, formatHardwareSnapshot, modelSafetyHint } from "./hardware.js";
+export type { HardwareSnapshot } from "./hardware.js";
+export { deleteOneModelArtifactsFromBrowserStorage, deleteTransformersModelArtifactsFromBrowserStorage, deleteTransformersModelFromBrowserCache, deleteWebLLMModelArtifactsFromBrowserStorage, estimateOriginStorage, getCachedModelStatus, hasTransformersModelInBrowserCache, matchesModelCacheTarget, TRANSFORMERS_CACHE_SCOPE, WEBLLM_CACHE_SCOPES, } from "./model-cache.js";
+export type { CacheCleanupResult, CacheCleanupScopeResult, CachedModelStatus, IndividualModelCacheStatus, IndividualModelCleanupResult, ModelCacheTarget, StorageEstimateSnapshot, } from "./model-cache.js";
+export { buildMultimodalStats, runRecordFromStats, wordCountGenStats } from "./metrics.js";
+export { aggregateByModel, DEFAULT_HISTORY_KEY, DEFAULT_HISTORY_MAX_RECORDS, RunHistoryStore, VENDOR_LABELS, vendorForModel, } from "./history.js";
+export type { ModelAggregate, ModelVendor, RunCaseKey, RunHistoryOptions, RunRecord } from "./history.js";
+export { AUDIO_SR, encodeWavBlob, pitchShiftBuffer } from "./audio/pcm.js";
+export { decodeAudioTo16kMono } from "./audio/decode.js";
+export { MicRecorder } from "./audio/recorder.js";
+export type { MicRecorderOptions } from "./audio/recorder.js";
+export { createStreamingAudioPlayer } from "./audio/streaming-player.js";
+export type { StreamingAudioPlayer, StreamingAudioPlayerOptions } from "./audio/streaming-player.js";
+export { clipFromRawAudio, clipPlaybackRate, playClipThroughElement, releaseClip, repitchClip, synthesizeClip } from "./audio/clip.js";
+export type { SynthClip, SynthesizeClipOptions } from "./audio/clip.js";
+export { stripThinkTags } from "./text-utils.js";
+export { capPipelineHistory, missingPipelineModels, PIPELINE_HISTORY_MAX_TURNS, PIPELINE_RECOMMENDED, PIPELINE_SYSTEM_PROMPT, PIPELINE_TASKS, shouldSpeakReply, streamedDelta, } from "./voice/helpers.js";
+export type { PipelineTask } from "./voice/helpers.js";
+export { VoicePipeline } from "./voice/voice-pipeline.js";
+export type { TurnDiscardReason, VoicePipelineEvents, VoicePipelineOptions, VoicePipelineStage } from "./voice/voice-pipeline.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,50 @@
+/**
+ * @missionsquad/browserai — run small open AI models entirely in the browser with WebGPU.
+ *
+ * Core entry points:
+ * - {@link BrowserAI} — model catalog + capability-slot manager + inference façade.
+ * - {@link VoicePipeline} — headless press-to-talk voice assistant (mic → STT → LLM → TTS).
+ */
+// Client
+export { BrowserAI, buildModelCacheTarget, normalizeContextLength } from "./client.js";
+// Configuration
+export { DEFAULT_CONTEXT_LENGTH, resolveConfig } from "./config.js";
+// Errors
+export { BrowserAIError, formatError, MicrophoneError, MissingModelError, ModelLoadError, ProxyVerificationError, UnknownModelError, VoiceTurnError, WebGPUUnavailableError, } from "./errors.js";
+// Events
+export { TypedEmitter } from "./events.js";
+// Model catalog
+export { applyCuratedModelRecordOverrides, CUSTOM_MODEL_RECORD_IDS, CUSTOM_MODEL_RECORDS, formatMB, getModelPreset, KOKORO_MODEL_ID, KOKORO_VOICES, MODALITY_ICONS, MODALITY_LABELS, MODEL_PRESETS, MODEL_RECORD_OVERRIDES, modelRepoLabel, modelSlots, presetModalityIn, presetModalityOut, presetTasks, SLOT_ORDER, SUPERTONIC_2_MODEL_ID, SUPERTONIC_MODEL_ID, SUPERTONIC_VOICES, TASK_ICONS, TASK_LABELS, ttsVoicesForModel, } from "./models.js";
+// Generation parameters + JSON mode
+export { buildResponseFormat, clampNumber, parseOptionalInteger, runtimeParamsFromPreset } from "./generation.js";
+// Text inference
+export { buildRuntimeStatsText, collectGenericStats, EMPTY_RESPONSE, generate, normalizeLatencyBreakdown } from "./inference.js";
+// Multimodal runtimes (STT / TTS / VLM / Gemma)
+export { capSrc, DEFAULT_KOKORO_CDN, describeImage, disposeMultimodal, generateGemmaText, loadMultimodal, planGemmaAudioWindows, runAudioLm, runGemma, runVoxtralRealtime, supertonicVoiceUrl, supportsStreamingTts, synthesize, synthesizeStream, transcribe, } from "./multimodal.js";
+// JSON helpers + schema validation
+export { detectLikelyRepetition, extractJsonCandidate, normalizeModelText, parseJsonFromModel, prettyJson } from "./json.js";
+export { validateAgainstJsonSchema } from "./schema-validator.js";
+export { DEFAULT_EXTRACTION_SCHEMA, stringifySchema, stripSchemaMetadata } from "./schema.js";
+export { buildExtractionMessages, DEFAULT_EXTRACTION_INSTRUCTIONS } from "./prompt.js";
+// Model source (direct vs proxy) + proxy verification
+export { applyContextOverride, buildProxiedAppConfig, buildWebLLMAppConfig, modelSourceDescription, proxyHuggingFaceUrl, proxyModelLibraryUrl, proxyModelRecord, proxyRawGithubUrl, TRANSFORMERS_CACHE_KEY, withCustomModelRecords, } from "./model-source.js";
+export { splitHuggingFaceRepoId, verifyTransformersProxy, verifyWebLLMProxy } from "./proxy-verify.js";
+// Hardware probing
+export { collectHardwareSnapshot, formatBytes, formatHardwareSnapshot, modelSafetyHint } from "./hardware.js";
+// Model artifact cache management
+export { deleteOneModelArtifactsFromBrowserStorage, deleteTransformersModelArtifactsFromBrowserStorage, deleteTransformersModelFromBrowserCache, deleteWebLLMModelArtifactsFromBrowserStorage, estimateOriginStorage, getCachedModelStatus, hasTransformersModelInBrowserCache, matchesModelCacheTarget, TRANSFORMERS_CACHE_SCOPE, WEBLLM_CACHE_SCOPES, } from "./model-cache.js";
+// Metrics + run history
+export { buildMultimodalStats, runRecordFromStats, wordCountGenStats } from "./metrics.js";
+export { aggregateByModel, DEFAULT_HISTORY_KEY, DEFAULT_HISTORY_MAX_RECORDS, RunHistoryStore, VENDOR_LABELS, vendorForModel, } from "./history.js";
+// Audio utilities
+export { AUDIO_SR, encodeWavBlob, pitchShiftBuffer } from "./audio/pcm.js";
+export { decodeAudioTo16kMono } from "./audio/decode.js";
+export { MicRecorder } from "./audio/recorder.js";
+export { createStreamingAudioPlayer } from "./audio/streaming-player.js";
+export { clipFromRawAudio, clipPlaybackRate, playClipThroughElement, releaseClip, repitchClip, synthesizeClip } from "./audio/clip.js";
+// Text utilities
+export { stripThinkTags } from "./text-utils.js";
+// Voice pipeline
+export { capPipelineHistory, missingPipelineModels, PIPELINE_HISTORY_MAX_TURNS, PIPELINE_RECOMMENDED, PIPELINE_SYSTEM_PROMPT, PIPELINE_TASKS, shouldSpeakReply, streamedDelta, } from "./voice/helpers.js";
+export { VoicePipeline } from "./voice/voice-pipeline.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/inference.d.ts

@@ -0,0 +1,89 @@
+import type { MLCEngineInterface } from "@mlc-ai/web-llm";
+import type { ModelBackend, ModelPreset } from "./models.js";
+import type { RuntimeParameters } from "./generation.js";
+export type ChatMessage = {
+    role: "system" | "user" | "assistant";
+    content: string;
+};
+export type LatencyBreakdown = Record<string, number[]>;
+export type WebLLMUsageExtra = {
+    e2e_latency_s?: number;
+    prefill_tokens_per_s?: number;
+    decode_tokens_per_s?: number;
+    time_to_first_token_s?: number;
+    time_per_output_token_s?: number;
+    grammar_init_s?: number;
+    grammar_per_token_s?: number;
+    latencyBreakdown?: LatencyBreakdown;
+    token_count_source?: string;
+    [key: string]: unknown;
+};
+export type RuntimeStats = {
+    rawText: string;
+    model: string;
+    backend: ModelBackend | "unknown";
+    finishReason: string;
+    measuredElapsedMs: number;
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+    measuredCompletionTokensPerSecond?: number;
+    extra?: WebLLMUsageExtra;
+    latencyBreakdown?: LatencyBreakdown;
+    legacyStats?: string;
+    error?: string;
+};
+export type TransformersTokenizer = {
+    apply_chat_template?: (messages: unknown, options?: Record<string, unknown>) => unknown;
+    encode?: (text: string, options?: Record<string, unknown>) => unknown;
+    decode?: (tokens: unknown, options?: Record<string, unknown>) => string;
+    batch_decode?: (tokens: unknown, options?: Record<string, unknown>) => string[];
+    all_special_ids?: unknown[];
+    (input: unknown, options?: Record<string, unknown>): unknown;
+};
+export type TransformersTextGenerationPipeline = ((input: unknown, options?: Record<string, unknown>) => Promise<unknown>) & {
+    tokenizer?: TransformersTokenizer;
+    model?: {
+        dispose?: () => unknown;
+    };
+    dispose?: () => unknown;
+};
+export type TransformersModule = {
+    env?: Record<string, unknown>;
+    pipeline: (task: string, model: string, options?: Record<string, unknown>) => Promise<TransformersTextGenerationPipeline>;
+    TextStreamer?: new (tokenizer: TransformersTokenizer, options?: Record<string, unknown>) => unknown;
+};
+/**
+ * Live engine references owned by the client and passed into the stateless generation helpers.
+ */
+export type EngineHandles = {
+    engine: MLCEngineInterface | null;
+    transformersGenerator: TransformersTextGenerationPipeline | null;
+    transformersTokenizer: TransformersTokenizer | null;
+    transformersModule: TransformersModule | null;
+    backend: ModelBackend | null;
+    modelId: string | null;
+};
+export type GenerationResult = {
+    text: string;
+    stats: RuntimeStats;
+};
+export type GenerateOptions = {
+    /** Structured cases pass a schema + json mode for WebLLM constrained decoding. */
+    schema?: unknown;
+    /** Stream tokens to this callback (receives the full accumulated text so far). */
+    onDelta?: (fullText: string) => void;
+    /** Reset the WebLLM KV cache before generating. Default true (stateless). Set false for multi-turn chat that relies on passed history — history is still passed explicitly, so reset stays safe. */
+    resetChat?: boolean;
+};
+/** Sentinel substituted for blank model output; exported so callers can detect/skip it (e.g. TTS). */
+export declare const EMPTY_RESPONSE = "[empty response]";
+/**
+ * Run one generation against whichever backend is loaded and return the text plus normalized stats.
+ * Dispatches to WebLLM (streaming or blocking) or Transformers.js. Throws if no engine is loaded.
+ */
+export declare function generate(handles: EngineHandles, messages: ChatMessage[], runtime: RuntimeParameters, preset: ModelPreset, options?: GenerateOptions): Promise<GenerationResult>;
+export declare function collectGenericStats(model: string, backend: ModelBackend | "unknown", started: number, ended: number, error?: string): RuntimeStats;
+export declare function buildRuntimeStatsText(stats: RuntimeStats): string;
+export declare function normalizeLatencyBreakdown(value: unknown): LatencyBreakdown | undefined;
+//# sourceMappingURL=inference.d.ts.map

package/dist/inference.d.ts.map

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