@missionsquad/browserai 0.1.0

package/dist/proxy-verify.js

@@ -0,0 +1,98 @@
+import { ProxyVerificationError } from "./errors.js";
+/**
+ * Pre-load health checks for a deployed proxy Worker (the `worker-template/` in this package).
+ * Failing fast with an actionable message beats letting an engine surface an opaque artifact
+ * fetch error hundreds of megabytes into a download.
+ */
+/** The X-Proxy-Worker prefixes accepted as "this looks like a compatible proxy Worker". */
+const KNOWN_WORKER_PREFIXES = ["browserai-proxy/", "browser-json-llm-app/"];
+async function fetchWorkerHealth(proxyOrigin) {
+    const healthResponse = await fetch(new URL("/__worker-health", proxyOrigin), { cache: "no-store" });
+    if (!healthResponse.ok) {
+        throw new ProxyVerificationError(`Proxy Worker is not active: ${proxyOrigin}/__worker-health returned ${healthResponse.status}. Deploy the worker-template with \`npx wrangler deploy\`.`);
+    }
+    return healthResponse;
+}
+/** Verify the proxy Worker is live and can serve the selected WebLLM model's config + wasm library. */
+export async function verifyWebLLMProxy(proxyOrigin, modelId, appConfig) {
+    const healthResponse = await fetchWorkerHealth(proxyOrigin);
+    const healthText = await healthResponse.text().catch(() => "");
+    let healthBody = healthText;
+    try {
+        healthBody = JSON.parse(healthText);
+    }
+    catch {
+        // Static HTML/old Worker response stays raw for diagnostics.
+    }
+    const workerHeader = healthResponse.headers.get("X-Proxy-Worker") ?? "";
+    const healthObject = typeof healthBody === "object" && healthBody !== null ? healthBody : {};
+    const workerLooksCurrent = KNOWN_WORKER_PREFIXES.some((prefix) => workerHeader.startsWith(prefix)) ||
+        (healthObject.ok === true && typeof healthObject.version === "string");
+    if (!workerLooksCurrent) {
+        throw new ProxyVerificationError(`Proxy Worker health check did not look like a compatible Worker. Status ${healthResponse.status}, X-Proxy-Worker: ${workerHeader || "missing"}.`);
+    }
+    const selectedRecord = appConfig.model_list.find((record) => record.model_id === modelId);
+    if (!selectedRecord) {
+        throw new ProxyVerificationError(`Model ${modelId} is not present in the WebLLM AppConfig.`);
+    }
+    const configProbeUrl = buildModelConfigProbeUrl(selectedRecord, proxyOrigin);
+    configProbeUrl.searchParams.set("probe", String(Date.now()));
+    const configProbeResponse = await fetch(configProbeUrl, { cache: "no-store" });
+    const configProxyHeader = configProbeResponse.headers.get("X-Proxy-Worker");
+    if (!configProbeResponse.ok || (configProbeUrl.origin === new URL(proxyOrigin).origin && !configProxyHeader)) {
+        throw new ProxyVerificationError(`Proxy /hf model-config probe failed for ${modelId}: ${configProbeResponse.status}. URL: ${configProbeUrl.pathname}. ${await readResponseBodyForError(configProbeResponse)}`);
+    }
+    const modelLib = selectedRecord.model_lib;
+    if (modelLib && modelLib.startsWith(proxyOrigin)) {
+        const modelLibProbeUrl = new URL(modelLib);
+        modelLibProbeUrl.searchParams.set("probe", String(Date.now()));
+        const modelLibProbeResponse = await fetch(modelLibProbeUrl, { method: "HEAD", cache: "no-store" });
+        const libProxyHeader = modelLibProbeResponse.headers.get("X-Proxy-Worker");
+        if (!modelLibProbeResponse.ok || !libProxyHeader) {
+            throw new ProxyVerificationError(`Proxy model-library probe failed for ${modelId}: ${modelLibProbeResponse.status}. URL: ${modelLibProbeUrl.pathname}.`);
+        }
+    }
+}
+function buildModelConfigProbeUrl(record, proxyOrigin) {
+    const modelUrl = new URL(record.model, proxyOrigin);
+    const path = modelUrl.pathname.replace(/\/+$/, "");
+    if (/\/resolve\/[^/]+(?:\/|$)/.test(path)) {
+        const base = new URL(modelUrl.href.endsWith("/") ? modelUrl.href : `${modelUrl.href}/`);
+        return new URL("mlc-chat-config.json", base);
+    }
+    return new URL(`${path}/resolve/main/mlc-chat-config.json`, modelUrl.origin);
+}
+/** Verify the proxy Worker can serve a Transformers.js repo's config through /hf-transformers/. */
+export async function verifyTransformersProxy(proxyOrigin, modelId) {
+    await fetchWorkerHealth(proxyOrigin);
+    const { owner, repo } = splitHuggingFaceRepoId(modelId);
+    let lastStatus = "not fetched";
+    for (const file of ["generation_config.json", "config.json"]) {
+        const url = new URL(`/hf-transformers/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/resolve/main/${file}`, proxyOrigin);
+        url.searchParams.set("probe", String(Date.now()));
+        const response = await fetch(url, { method: "HEAD", cache: "no-store" });
+        const proxyHeader = response.headers.get("X-Proxy-Worker");
+        lastStatus = `${url.pathname}: ${response.status}, X-Proxy-Worker=${proxyHeader ?? "missing"}`;
+        if (response.ok && proxyHeader)
+            return;
+    }
+    throw new ProxyVerificationError(`Proxy Transformers.js probe failed for ${modelId}. Last status: ${lastStatus}`);
+}
+export function splitHuggingFaceRepoId(modelId) {
+    const parts = modelId.split("/");
+    if (parts.length < 2)
+        throw new ProxyVerificationError(`Expected a Hugging Face repo ID in owner/repo form, got ${modelId}`);
+    return { owner: parts[0], repo: parts.slice(1).join("/") };
+}
+async function readResponseBodyForError(response) {
+    const text = await response.text().catch(() => "");
+    if (!text)
+        return `${response.status} ${response.statusText}`;
+    try {
+        return JSON.stringify(JSON.parse(text));
+    }
+    catch {
+        return text.slice(0, 300);
+    }
+}
+//# sourceMappingURL=proxy-verify.js.map

package/dist/proxy-verify.js.map

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

package/dist/schema-validator.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Lightweight JSON Schema validator for the subset used by this demo. It intentionally avoids
+ * pulling in a large validation dependency so npm install stays fast.
+ */
+export declare function validateAgainstJsonSchema(value: unknown, schema: unknown): string[];
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../src/schema-validator.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAKnF"}

package/dist/schema-validator.js

@@ -0,0 +1,104 @@
+/**
+ * Lightweight JSON Schema validator for the subset used by this demo. It intentionally avoids
+ * pulling in a large validation dependency so npm install stays fast.
+ */
+export function validateAgainstJsonSchema(value, schema) {
+    if (!isObject(schema)) {
+        return ["Schema must be a JSON object."];
+    }
+    return validateNode(value, schema, "$", []);
+}
+function validateNode(value, schema, path, errors) {
+    const allowedTypes = normalizeTypeList(schema.type);
+    if (allowedTypes.length > 0 && !allowedTypes.some((type) => matchesJsonType(value, type))) {
+        errors.push(`${path} must be ${allowedTypes.join(" or ")}.`);
+        return errors;
+    }
+    const enumValues = schema.enum;
+    if (Array.isArray(enumValues) && !enumValues.some((candidate) => deepEqual(candidate, value))) {
+        errors.push(`${path} must be one of ${enumValues.map(String).join(", ")}.`);
+    }
+    if (typeof value === "string") {
+        if (typeof schema.minLength === "number" && value.length < schema.minLength) {
+            errors.push(`${path} must contain at least ${schema.minLength} characters.`);
+        }
+        if (typeof schema.maxLength === "number" && value.length > schema.maxLength) {
+            errors.push(`${path} must contain no more than ${schema.maxLength} characters.`);
+        }
+    }
+    if (typeof value === "number") {
+        if (typeof schema.minimum === "number" && value < schema.minimum) {
+            errors.push(`${path} must be >= ${schema.minimum}.`);
+        }
+        if (typeof schema.maximum === "number" && value > schema.maximum) {
+            errors.push(`${path} must be <= ${schema.maximum}.`);
+        }
+    }
+    if (Array.isArray(value)) {
+        if (typeof schema.minItems === "number" && value.length < schema.minItems) {
+            errors.push(`${path} must contain at least ${schema.minItems} items.`);
+        }
+        if (typeof schema.maxItems === "number" && value.length > schema.maxItems) {
+            errors.push(`${path} must contain no more than ${schema.maxItems} items.`);
+        }
+        if (isObject(schema.items)) {
+            value.forEach((item, index) => validateNode(item, schema.items, `${path}[${index}]`, errors));
+        }
+    }
+    if (isObject(value)) {
+        const properties = isObject(schema.properties) ? schema.properties : {};
+        const required = Array.isArray(schema.required) ? schema.required.filter((item) => typeof item === "string") : [];
+        for (const key of required) {
+            if (!(key in value)) {
+                errors.push(`${path}.${key} is required.`);
+            }
+        }
+        for (const [key, propertySchema] of Object.entries(properties)) {
+            if (key in value && isObject(propertySchema)) {
+                validateNode(value[key], propertySchema, `${path}.${key}`, errors);
+            }
+        }
+        if (schema.additionalProperties === false) {
+            for (const key of Object.keys(value)) {
+                if (!(key in properties)) {
+                    errors.push(`${path}.${key} is not allowed by additionalProperties:false.`);
+                }
+            }
+        }
+    }
+    return errors;
+}
+function normalizeTypeList(type) {
+    if (typeof type === "string")
+        return [type];
+    if (Array.isArray(type))
+        return type.filter((item) => typeof item === "string");
+    return [];
+}
+function matchesJsonType(value, type) {
+    switch (type) {
+        case "object":
+            return isObject(value);
+        case "array":
+            return Array.isArray(value);
+        case "string":
+            return typeof value === "string";
+        case "number":
+            return typeof value === "number" && Number.isFinite(value);
+        case "integer":
+            return Number.isInteger(value);
+        case "boolean":
+            return typeof value === "boolean";
+        case "null":
+            return value === null;
+        default:
+            return true;
+    }
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function deepEqual(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/schema-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.js","sourceRoot":"","sources":["../src/schema-validator.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,KAAc,EAAE,MAAe;IACvE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,YAAY,CAAC,KAAc,EAAE,MAAkB,EAAE,IAAY,EAAE,MAAgB;IACtF,MAAM,YAAY,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;QAC1F,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,YAAY,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;QAC9F,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,mBAAmB,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;YAC5E,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,0BAA0B,MAAM,CAAC,SAAS,cAAc,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;YAC5E,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,8BAA8B,MAAM,CAAC,SAAS,cAAc,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,eAAe,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,eAAe,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC1E,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,0BAA0B,MAAM,CAAC,QAAQ,SAAS,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC1E,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,8BAA8B,MAAM,CAAC,QAAQ,SAAS,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,KAAmB,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QAC9G,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAE,MAAM,CAAC,UAAsC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrG,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAElI,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,GAAG,eAAe,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,KAAK,MAAM,CAAC,GAAG,EAAE,cAAc,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/D,IAAI,GAAG,IAAI,KAAK,IAAI,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC7C,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,cAAc,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;YACrE,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,oBAAoB,KAAK,KAAK,EAAE,CAAC;YAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrC,IAAI,CAAC,CAAC,GAAG,IAAI,UAAU,CAAC,EAAE,CAAC;oBACzB,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,GAAG,gDAAgD,CAAC,CAAC;gBAC9E,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAa;IACtC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;IAChG,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc,EAAE,IAAY;IACnD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;QACnC,KAAK,QAAQ;YACX,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC7D,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACjC,KAAK,SAAS;YACZ,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;QACpC,KAAK,MAAM;YACT,OAAO,KAAK,KAAK,IAAI,CAAC;QACxB;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,SAAS,CAAC,CAAU,EAAE,CAAU;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Example JSON Schema for structured extraction. Useful as a starting point for schema-constrained
+ * generation; hosts supply their own schema for real workloads.
+ */
+export declare const DEFAULT_EXTRACTION_SCHEMA: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly summary: {
+            readonly type: "string";
+            readonly maxLength: 240;
+            readonly description: "One concise sentence summarizing the input text.";
+        };
+        readonly language: {
+            readonly type: "string";
+            readonly maxLength: 40;
+            readonly description: "The primary language of the input text, e.g. English.";
+        };
+        readonly sentiment: {
+            readonly type: "string";
+            readonly enum: readonly ["positive", "neutral", "negative", "mixed"];
+        };
+        readonly entities: {
+            readonly type: "array";
+            readonly maxItems: 8;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly text: {
+                        readonly type: "string";
+                        readonly maxLength: 120;
+                    };
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["person", "organization", "product_feature", "integration", "competitor", "date", "money", "other"];
+                    };
+                };
+                readonly required: readonly ["text", "type"];
+            };
+        };
+        readonly intents: {
+            readonly type: "array";
+            readonly maxItems: 5;
+            readonly items: {
+                readonly type: "string";
+                readonly maxLength: 80;
+            };
+            readonly description: "Likely user intents, such as request_feature, ask_pricing, report_blocker, or schedule_followup.";
+        };
+        readonly action_items: {
+            readonly type: "array";
+            readonly maxItems: 5;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly owner: {
+                        readonly type: readonly ["string", "null"];
+                        readonly maxLength: 80;
+                    };
+                    readonly task: {
+                        readonly type: "string";
+                        readonly maxLength: 160;
+                    };
+                    readonly due_date: {
+                        readonly type: readonly ["string", "null"];
+                        readonly maxLength: 80;
+                    };
+                };
+                readonly required: readonly ["owner", "task", "due_date"];
+            };
+        };
+        readonly risk_flags: {
+            readonly type: "array";
+            readonly maxItems: 8;
+            readonly items: {
+                readonly type: "string";
+                readonly maxLength: 120;
+            };
+            readonly description: "Adoption blockers, competitive risks, deadlines, or security/compliance concerns present in the text.";
+        };
+        readonly confidence: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly maximum: 1;
+            readonly description: "Model confidence from 0 to 1.";
+        };
+    };
+    readonly required: readonly ["summary", "language", "sentiment", "entities", "intents", "action_items", "risk_flags", "confidence"];
+};
+export declare function stringifySchema(schema: unknown): string;
+/**
+ * The schema sent to the constrained decoder does not need human-only metadata.
+ * Removing descriptions keeps the prompt and grammar-construction work smaller.
+ */
+export declare function stripSchemaMetadata(value: unknown): unknown;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsF5B,CAAC;AAEX,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAiB3D"}

package/dist/schema.js

@@ -0,0 +1,115 @@
+/**
+ * Example JSON Schema for structured extraction. Useful as a starting point for schema-constrained
+ * generation; hosts supply their own schema for real workloads.
+ */
+export const DEFAULT_EXTRACTION_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+        summary: {
+            type: "string",
+            maxLength: 240,
+            description: "One concise sentence summarizing the input text.",
+        },
+        language: {
+            type: "string",
+            maxLength: 40,
+            description: "The primary language of the input text, e.g. English.",
+        },
+        sentiment: {
+            type: "string",
+            enum: ["positive", "neutral", "negative", "mixed"],
+        },
+        entities: {
+            type: "array",
+            maxItems: 8,
+            items: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    text: { type: "string", maxLength: 120 },
+                    type: {
+                        type: "string",
+                        enum: [
+                            "person",
+                            "organization",
+                            "product_feature",
+                            "integration",
+                            "competitor",
+                            "date",
+                            "money",
+                            "other",
+                        ],
+                    },
+                },
+                required: ["text", "type"],
+            },
+        },
+        intents: {
+            type: "array",
+            maxItems: 5,
+            items: { type: "string", maxLength: 80 },
+            description: "Likely user intents, such as request_feature, ask_pricing, report_blocker, or schedule_followup.",
+        },
+        action_items: {
+            type: "array",
+            maxItems: 5,
+            items: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    owner: { type: ["string", "null"], maxLength: 80 },
+                    task: { type: "string", maxLength: 160 },
+                    due_date: { type: ["string", "null"], maxLength: 80 },
+                },
+                required: ["owner", "task", "due_date"],
+            },
+        },
+        risk_flags: {
+            type: "array",
+            maxItems: 8,
+            items: { type: "string", maxLength: 120 },
+            description: "Adoption blockers, competitive risks, deadlines, or security/compliance concerns present in the text.",
+        },
+        confidence: {
+            type: "number",
+            minimum: 0,
+            maximum: 1,
+            description: "Model confidence from 0 to 1.",
+        },
+    },
+    required: [
+        "summary",
+        "language",
+        "sentiment",
+        "entities",
+        "intents",
+        "action_items",
+        "risk_flags",
+        "confidence",
+    ],
+};
+export function stringifySchema(schema) {
+    return JSON.stringify(schema, null, 2);
+}
+/**
+ * The schema sent to the constrained decoder does not need human-only metadata.
+ * Removing descriptions keeps the prompt and grammar-construction work smaller.
+ */
+export function stripSchemaMetadata(value) {
+    if (Array.isArray(value)) {
+        return value.map(stripSchemaMetadata);
+    }
+    if (!value || typeof value !== "object") {
+        return value;
+    }
+    const result = {};
+    for (const [key, child] of Object.entries(value)) {
+        if (["description", "examples", "title", "$comment"].includes(key)) {
+            continue;
+        }
+        result[key] = stripSchemaMetadata(child);
+    }
+    return result;
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/text-utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Remove `<think>…</think>` blocks from model output. Some chat templates emit an empty think pair
+ * even when thinking is disabled (enable_thinking:false), and reasoning models emit filled ones;
+ * neither belongs in a visible answer — or in text fed to TTS. Also hides an unclosed block while
+ * it is still streaming.
+ */
+export declare function stripThinkTags(text: string): string;
+//# sourceMappingURL=text-utils.d.ts.map

package/dist/text-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-utils.d.ts","sourceRoot":"","sources":["../src/text-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnD"}

package/dist/text-utils.js

@@ -0,0 +1,14 @@
+/**
+ * Remove `<think>…</think>` blocks from model output. Some chat templates emit an empty think pair
+ * even when thinking is disabled (enable_thinking:false), and reasoning models emit filled ones;
+ * neither belongs in a visible answer — or in text fed to TTS. Also hides an unclosed block while
+ * it is still streaming.
+ */
+export function stripThinkTags(text) {
+    let out = text.replace(/<think>[\s\S]*?<\/think>/gi, "");
+    const openIndex = out.search(/<think>/i);
+    if (openIndex !== -1)
+        out = out.slice(0, openIndex);
+    return out.replace(/^\s+/, "");
+}
+//# sourceMappingURL=text-utils.js.map

package/dist/text-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-utils.js","sourceRoot":"","sources":["../src/text-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,EAAE,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,SAAS,KAAK,CAAC,CAAC;QAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC"}

package/dist/voice/helpers.d.ts

@@ -0,0 +1,35 @@
+import { type ModelTask } from "../models.js";
+/**
+ * Pure helpers for the voice pipeline (mic → STT → text LLM → TTS voice assistant). Kept free of
+ * engine and DOM state so the chain-readiness logic, recommended-model map, and history cap are
+ * unit-testable.
+ */
+/** The capability slots the voice-assistant pipeline chains, in signal order (mic → … → speakers). */
+export declare const PIPELINE_TASKS: readonly ["stt", "text", "tts"];
+export type PipelineTask = (typeof PIPELINE_TASKS)[number];
+/**
+ * The recommended model per pipeline slot — low-resource defaults (Whisper Base / Qwen3.5 0.8B /
+ * Kokoro 82M). They occupy disjoint capability slots, so loading all three never evicts another;
+ * total ≈2.5 GB VRAM.
+ */
+export declare const PIPELINE_RECOMMENDED: Record<PipelineTask, string>;
+/** The pipeline slots not yet filled by a loaded model, in {@link PIPELINE_TASKS} order. */
+export declare function missingPipelineModels(filledSlots: ReadonlySet<ModelTask>): PipelineTask[];
+/** Whether a generated reply is worth speaking — skips blank output and the empty-response sentinel. */
+export declare function shouldSpeakReply(reply: string): boolean;
+/** How many user↔assistant exchanges the pipeline keeps as conversation context. */
+export declare const PIPELINE_HISTORY_MAX_TURNS = 6;
+/**
+ * Cap a pipeline conversation history (alternating user/assistant entries, system turn excluded) to
+ * the most recent `maxTurns` exchanges. Returns the input array unchanged when already within bounds.
+ */
+export declare function capPipelineHistory<T>(messages: T[], maxTurns?: number): T[];
+/**
+ * The newly-appended suffix when `next` extends `prev` (a monotonically-growing stream); "" when `next`
+ * is not an extension of `prev` (e.g. a think-tag block was stripped, shrinking the text). Used to push
+ * only new text into a streaming TTS splitter without repeating already-spoken text.
+ */
+export declare function streamedDelta(prev: string, next: string): string;
+/** System turn for the voice assistant — replies must be short and speakable (fed to TTS verbatim). */
+export declare const PIPELINE_SYSTEM_PROMPT = "You are a helpful voice assistant. Reply in 1-3 short, natural sentences suitable for being spoken aloud. Do not use markdown, lists, or code blocks.";
+//# sourceMappingURL=helpers.d.ts.map

package/dist/voice/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/voice/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAG/D;;;;GAIG;AAEH,sGAAsG;AACtG,eAAO,MAAM,cAAc,iCAAkC,CAAC;AAC9D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAI7D,CAAC;AAEF,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,YAAY,EAAE,CAEzF;AAED,wGAAwG;AACxG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED,oFAAoF;AACpF,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,QAAQ,GAAE,MAAmC,GAAG,CAAC,EAAE,CAGvG;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,uGAAuG;AACvG,eAAO,MAAM,sBAAsB,0JACsH,CAAC"}

package/dist/voice/helpers.js

@@ -0,0 +1,49 @@
+import { KOKORO_MODEL_ID } from "../models.js";
+import { EMPTY_RESPONSE } from "../inference.js";
+/**
+ * Pure helpers for the voice pipeline (mic → STT → text LLM → TTS voice assistant). Kept free of
+ * engine and DOM state so the chain-readiness logic, recommended-model map, and history cap are
+ * unit-testable.
+ */
+/** The capability slots the voice-assistant pipeline chains, in signal order (mic → … → speakers). */
+export const PIPELINE_TASKS = ["stt", "text", "tts"];
+/**
+ * The recommended model per pipeline slot — low-resource defaults (Whisper Base / Qwen3.5 0.8B /
+ * Kokoro 82M). They occupy disjoint capability slots, so loading all three never evicts another;
+ * total ≈2.5 GB VRAM.
+ */
+export const PIPELINE_RECOMMENDED = {
+    stt: "onnx-community/whisper-base",
+    text: "Qwen3.5-0.8B-q4f16_1-MLC",
+    tts: KOKORO_MODEL_ID,
+};
+/** The pipeline slots not yet filled by a loaded model, in {@link PIPELINE_TASKS} order. */
+export function missingPipelineModels(filledSlots) {
+    return PIPELINE_TASKS.filter((task) => !filledSlots.has(task));
+}
+/** Whether a generated reply is worth speaking — skips blank output and the empty-response sentinel. */
+export function shouldSpeakReply(reply) {
+    const trimmed = reply.trim();
+    return trimmed.length > 0 && trimmed !== EMPTY_RESPONSE;
+}
+/** How many user↔assistant exchanges the pipeline keeps as conversation context. */
+export const PIPELINE_HISTORY_MAX_TURNS = 6;
+/**
+ * Cap a pipeline conversation history (alternating user/assistant entries, system turn excluded) to
+ * the most recent `maxTurns` exchanges. Returns the input array unchanged when already within bounds.
+ */
+export function capPipelineHistory(messages, maxTurns = PIPELINE_HISTORY_MAX_TURNS) {
+    const maxEntries = maxTurns * 2;
+    return messages.length > maxEntries ? messages.slice(-maxEntries) : messages;
+}
+/**
+ * The newly-appended suffix when `next` extends `prev` (a monotonically-growing stream); "" when `next`
+ * is not an extension of `prev` (e.g. a think-tag block was stripped, shrinking the text). Used to push
+ * only new text into a streaming TTS splitter without repeating already-spoken text.
+ */
+export function streamedDelta(prev, next) {
+    return next.startsWith(prev) ? next.slice(prev.length) : "";
+}
+/** System turn for the voice assistant — replies must be short and speakable (fed to TTS verbatim). */
+export const PIPELINE_SYSTEM_PROMPT = "You are a helpful voice assistant. Reply in 1-3 short, natural sentences suitable for being spoken aloud. Do not use markdown, lists, or code blocks.";
+//# sourceMappingURL=helpers.js.map

package/dist/voice/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/voice/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkB,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;;;GAIG;AAEH,sGAAsG;AACtG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAU,CAAC;AAG9D;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAiC;IAChE,GAAG,EAAE,6BAA6B;IAClC,IAAI,EAAE,0BAA0B;IAChC,GAAG,EAAE,eAAe;CACrB,CAAC;AAEF,4FAA4F;AAC5F,MAAM,UAAU,qBAAqB,CAAC,WAAmC;IACvE,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,KAAK,cAAc,CAAC;AAC1D,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAI,QAAa,EAAE,WAAmB,0BAA0B;IAChG,MAAM,UAAU,GAAG,QAAQ,GAAG,CAAC,CAAC;IAChC,OAAO,QAAQ,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAY;IACtD,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,uGAAuG;AACvG,MAAM,CAAC,MAAM,sBAAsB,GACjC,uJAAuJ,CAAC"}