Hi

\"\n});\n```\n\n## Val Town Utility Functions\n\nVal Town provides several utility functions to help with common project tasks.\n\n### Importing Utilities\n\nAlways import utilities with version pins to avoid breaking changes:\n\n```ts\nimport { parseProject, readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n```\n\n### Available Utilities\n\n\n#### **serveFile** - Serve project files with proper content types\n\nFor example, in Hono:\n\n```ts\n// serve all files in frontend/ and shared/\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n```\n\n#### **readFile** - Read files from within the project:\n\n```ts\n// Read a file from the project\nconst fileContent = await readFile(\"/frontend/index.html\", import.meta.url);\n```\n\n#### **listFiles** - List all files in the project\n\n```ts\nconst files = await listFiles(import.meta.url);\n```\n\n#### **parseProject** - Extract information about the current project from import.meta.url\n\nThis is useful for including info for linking back to a val, ie in \"view source\" urls:\n\n```ts\nconst projectVal = parseProject(import.meta.url);\nconsole.log(projectVal.username); // Owner of the project\nconsole.log(projectVal.name); // Project name\nconsole.log(projectVal.version); // Version number\nconsole.log(projectVal.branch); // Branch name\nconsole.log(projectVal.links.self.project); // URL to the project page\n```\n\nHowever, it's *extremely importing* to note that `parseProject` and other Standard Library utilities ONLY RUN ON THE SERVER.\nIf you need access to this data on the client, run it in the server and pass it to the client by splicing it into the HTML page\nor by making an API request for it.\n\n## Val Town Platform Specifics\n\n- **Redirects:** Use `return new Response(null, { status: 302, headers: { Location: \"/place/to/redirect\" }})` instead of `Response.redirect` which is broken\n- **Images:** Avoid external images or base64 images. Use emojis, unicode symbols, or icon fonts/libraries instead\n- **AI Image:** To inline generate an AI image use: `

`\n- **Storage:** DO NOT use the Deno KV module for storage\n- **Browser APIs:** DO NOT use the `alert()`, `prompt()`, or `confirm()` methods\n- **Weather Data:** Use open-meteo for weather data (doesn't require API keys) unless otherwise specified\n- **View Source:** Add a view source link by importing & using `import.meta.url.replace(\"ems.sh\", \"val.town)\"` (or passing this data to the client) and include `target=\"_top\"` attribute\n- **Error Debugging:** Add `` to HTML to capture client-side errors\n- **Error Handling:** Only use try...catch when there's a clear local resolution; Avoid catches that merely log or return 500s. Let errors bubble up with full context\n- **Environment Variables:** Use `Deno.env.get('keyname')` when you need to, but generally prefer APIs that don't require keys\n- **Imports:** Use `https://esm.sh` for npm and Deno dependencies to ensure compatibility on server and browser\n- **Storage Strategy:** Only use backend storage if explicitly required; prefer simple static client-side sites\n- **React Configuration:** When using React libraries, pin versions with `?deps=react@18.2.0,react-dom@18.2.0` and start the file with `/** @jsxImportSource https://esm.sh/react@18.2.0 */`\n- Ensure all React dependencies and sub-dependencies are pinned to the same version\n- **Styling:** Default to using TailwindCSS via `` unless otherwise specified\n\n## Project Structure and Design Patterns\n\n### Recommended Directory Structure\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Schema definitions\n│ │ ├── queries.ts # DB query functions\n│ │ └── README.md\n│ └── routes/ # Route modules\n│ ├── [route].ts\n│ └── static.ts # Static file serving\n│ ├── index.ts # Main entry point\n│ └── README.md\n├── frontend/\n│ ├── components/\n│ │ ├── App.tsx\n│ │ └── [Component].tsx\n│ ├── favicon.svg\n│ ├── index.html # Main HTML template\n│ ├── index.tsx # Frontend JS entry point\n│ ├── README.md\n│ └── style.css\n├── README.md\n└── shared/\n ├── README.md\n └── utils.ts # Shared types and functions\n```\n\n### Backend (Hono) Best Practices\n\n- Hono is the recommended API framework\n- Main entry point should be `backend/index.ts`\n- **Static asset serving:** Use the utility functions to read and serve project files:\n ```ts\n import { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n \n // serve all files in frontend/ and shared/\n app.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\n app.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n \n // For index.html, often you'll want to bootstrap with initial data\n app.get(\"/\", async c => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n \n // Inject data to avoid extra round-trips\n const initialData = await fetchInitialData();\n const dataScript = ``;\n \n html = html.replace(\"\", `${dataScript}`);\n return c.html(html);\n });\n ```\n- Create RESTful API routes for CRUD operations\n- Always include this snippet at the top-level Hono app to re-throwing errors to see full stack traces:\n ```ts\n // Unwrap Hono errors to see original error details\n app.onError((err, c) => {\n throw err;\n });\n ```\n\n### Database Patterns\n- Run migrations on startup or comment out for performance\n- Change table names when modifying schemas rather than altering\n- Export clear query functions with proper TypeScript typing\n\n## Common Gotchas and Solutions\n\n1. **Environment Limitations:** \n - Val Town runs on Deno in a serverless context, not Node.js\n - Code in `shared/` must work in both frontend and backend environments\n - Cannot use `Deno` keyword in shared code\n - Use `https://esm.sh` for imports that work in both environments\n\n2. **SQLite Peculiarities:**\n - Limited support for ALTER TABLE operations\n - Create new tables with updated schemas and copy data when needed\n - Always run table creation before querying\n\n3. **React Configuration:**\n - All React dependencies must be pinned to 18.2.0\n - Always include `@jsxImportSource https://esm.sh/react@18.2.0` at the top of React files\n - Rendering issues often come from mismatched React versions\n\n4. **File Handling:**\n - Val Town only supports text files, not binary\n - Use the provided utilities to read files across branches and forks\n - For files in the project, use `readFile` helpers\n\n5. **API Design:**\n - `fetch` handler is the entry point for HTTP vals\n - Run the Hono app with `export default app.fetch // This is the entry point for HTTP vals`\n\n",[196],"65892a86-b8e7-11f0-ba05-0224a6c84d84",".vtignore","65892b4e-b8e7-11f0-ba05-0224a6c84d84",9,["D",1762196442809],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor",[203],"7ecff464-b9ca-11f0-8b68-0224a6c84d84","utils","7ecff54a-b9ca-11f0-8b68-0224a6c84d84",49,["D",1762293981048],"directory",[210],"30dc0596-b901-11f0-a3b9-0224a6c84d84","testing","30dc0668-b901-11f0-a3b9-0224a6c84d84",28,["D",1762207521420],[217],"30c2711c-b901-11f0-b5de-0224a6c84d84","search","30c2722a-b901-11f0-b5de-0224a6c84d84",27,["D",1762207521254],[223],"31189d8a-b901-11f0-87ce-0224a6c84d84","data","31189e3e-b901-11f0-87ce-0224a6c84d84",29,["D",1762207521817],[229],"7eb3aa8e-b9ca-11f0-98dd-0224a6c84d84","answer","7eb3ab56-b9ca-11f0-98dd-0224a6c84d84",48,["D",1762293980863],[235],"pulls","branches","forks","envVars",{"_247":60,"_249":60},"connections",{"_247":60,"_248":60},"count","unfilledCount","emptyCount",{"_41":234,"_31":235,"_29":236,"_141":-5,"_39":40,"_38":237,"_143":47,"_36":641,"_13":60,"_33":214,"_34":-5,"_23":24,"_147":-5,"_304":642,"_26":643},{"_41":633,"_31":634,"_29":635,"_141":236,"_39":40,"_38":636,"_143":47,"_36":637,"_13":60,"_33":20,"_34":638,"_23":24,"_147":-5,"_304":639,"_26":640},{"_41":625,"_31":626,"_29":627,"_141":236,"_39":40,"_38":628,"_143":47,"_36":629,"_13":60,"_33":20,"_34":630,"_23":24,"_147":-5,"_304":631,"_26":632},{"_41":618,"_31":189,"_29":619,"_141":236,"_39":40,"_38":620,"_143":47,"_36":621,"_13":60,"_33":20,"_34":622,"_23":24,"_147":-5,"_304":623,"_26":624},{"_41":611,"_31":457,"_29":612,"_141":236,"_39":40,"_38":613,"_143":47,"_36":614,"_13":60,"_33":20,"_34":615,"_23":24,"_147":-5,"_304":616,"_26":617},{"_41":603,"_31":604,"_29":605,"_141":236,"_39":40,"_38":606,"_143":47,"_36":607,"_13":60,"_33":145,"_34":608,"_23":24,"_147":-5,"_304":609,"_26":610},{"_41":596,"_31":449,"_29":597,"_141":236,"_39":40,"_38":598,"_143":47,"_36":599,"_13":60,"_33":145,"_34":600,"_23":24,"_147":-5,"_304":601,"_26":602},{"_41":588,"_31":589,"_29":590,"_141":236,"_39":40,"_38":591,"_143":47,"_36":592,"_13":60,"_33":145,"_34":593,"_23":24,"_147":-5,"_304":594,"_26":595},{"_41":581,"_31":385,"_29":582,"_141":236,"_39":40,"_38":583,"_143":47,"_36":584,"_13":60,"_33":145,"_34":585,"_23":24,"_147":-5,"_304":586,"_26":587},{"_41":574,"_31":139,"_29":575,"_141":236,"_39":40,"_38":576,"_143":47,"_36":577,"_13":60,"_33":145,"_34":578,"_23":24,"_147":-5,"_304":579,"_26":580},{"_41":228,"_31":229,"_29":230,"_141":-5,"_39":40,"_38":231,"_143":47,"_36":571,"_13":60,"_33":214,"_34":-5,"_23":24,"_147":-5,"_304":572,"_26":573},{"_41":222,"_31":223,"_29":224,"_141":-5,"_39":40,"_38":225,"_143":47,"_36":568,"_13":60,"_33":214,"_34":-5,"_23":24,"_147":-5,"_304":569,"_26":570},{"_41":563,"_31":473,"_29":467,"_141":224,"_39":40,"_38":564,"_143":47,"_36":565,"_13":60,"_33":214,"_34":-5,"_23":24,"_147":-5,"_304":566,"_26":567},{"_41":558,"_31":522,"_29":516,"_141":467,"_39":40,"_38":559,"_143":47,"_36":560,"_13":60,"_33":214,"_34":-5,"_23":24,"_147":-5,"_304":561,"_26":562},{"_41":553,"_31":540,"_29":534,"_141":516,"_39":40,"_38":554,"_143":47,"_36":555,"_13":60,"_33":214,"_34":-5,"_23":24,"_147":-5,"_304":556,"_26":557},{"_41":549,"_31":32,"_29":30,"_141":534,"_39":40,"_38":14,"_143":47,"_36":550,"_13":60,"_33":20,"_34":35,"_23":24,"_147":-5,"_304":551,"_26":552},{"_41":541,"_31":542,"_29":543,"_141":534,"_39":40,"_38":544,"_143":47,"_36":545,"_13":60,"_33":20,"_34":546,"_23":24,"_147":-5,"_304":547,"_26":548},{"_41":531,"_31":532,"_29":533,"_141":534,"_39":40,"_38":535,"_143":47,"_36":536,"_13":60,"_33":20,"_34":537,"_23":24,"_147":-5,"_304":538,"_26":539},{"_41":523,"_31":524,"_29":525,"_141":516,"_39":40,"_38":526,"_143":47,"_36":527,"_13":60,"_33":20,"_34":528,"_23":24,"_147":-5,"_304":529,"_26":530},{"_41":513,"_31":514,"_29":515,"_141":516,"_39":40,"_38":517,"_143":47,"_36":518,"_13":60,"_33":20,"_34":519,"_23":24,"_147":-5,"_304":520,"_26":521},{"_41":505,"_31":506,"_29":507,"_141":467,"_39":40,"_38":508,"_143":47,"_36":509,"_13":60,"_33":20,"_34":510,"_23":24,"_147":-5,"_304":511,"_26":512},{"_41":498,"_31":189,"_29":499,"_141":467,"_39":40,"_38":500,"_143":47,"_36":501,"_13":60,"_33":20,"_34":502,"_23":24,"_147":-5,"_304":503,"_26":504},{"_41":490,"_31":491,"_29":492,"_141":467,"_39":40,"_38":493,"_143":47,"_36":494,"_13":60,"_33":20,"_34":495,"_23":24,"_147":-5,"_304":496,"_26":497},{"_41":482,"_31":483,"_29":484,"_141":467,"_39":40,"_38":485,"_143":47,"_36":486,"_13":60,"_33":20,"_34":487,"_23":24,"_147":-5,"_304":488,"_26":489},{"_41":474,"_31":475,"_29":476,"_141":467,"_39":40,"_38":477,"_143":47,"_36":478,"_13":60,"_33":145,"_34":479,"_23":24,"_147":-5,"_304":480,"_26":481},{"_41":464,"_31":465,"_29":466,"_141":467,"_39":40,"_38":468,"_143":47,"_36":469,"_13":60,"_33":145,"_34":470,"_23":24,"_147":-5,"_304":471,"_26":472},{"_41":456,"_31":457,"_29":458,"_141":224,"_39":40,"_38":459,"_143":47,"_36":460,"_13":60,"_33":20,"_34":461,"_23":24,"_147":-5,"_304":462,"_26":463},{"_41":448,"_31":449,"_29":450,"_141":224,"_39":40,"_38":451,"_143":24,"_36":452,"_13":60,"_33":145,"_34":453,"_23":24,"_147":-5,"_304":454,"_26":455},{"_41":440,"_31":441,"_29":442,"_141":224,"_39":40,"_38":443,"_143":47,"_36":444,"_13":60,"_33":145,"_34":445,"_23":24,"_147":-5,"_304":446,"_26":447},{"_41":432,"_31":433,"_29":434,"_141":224,"_39":40,"_38":435,"_143":47,"_36":436,"_13":60,"_33":145,"_34":437,"_23":24,"_147":-5,"_304":438,"_26":439},{"_41":424,"_31":425,"_29":426,"_141":224,"_39":40,"_38":427,"_143":47,"_36":428,"_13":60,"_33":145,"_34":429,"_23":24,"_147":-5,"_304":430,"_26":431},{"_41":416,"_31":417,"_29":418,"_141":224,"_39":40,"_38":419,"_143":47,"_36":420,"_13":60,"_33":145,"_34":421,"_23":24,"_147":-5,"_304":422,"_26":423},{"_41":408,"_31":409,"_29":410,"_141":224,"_39":40,"_38":411,"_143":47,"_36":412,"_13":60,"_33":145,"_34":413,"_23":24,"_147":-5,"_304":414,"_26":415},{"_41":400,"_31":401,"_29":402,"_141":224,"_39":40,"_38":403,"_143":24,"_36":404,"_13":60,"_33":145,"_34":405,"_23":24,"_147":-5,"_304":406,"_26":407},{"_41":392,"_31":393,"_29":394,"_141":224,"_39":40,"_38":395,"_143":47,"_36":396,"_13":60,"_33":145,"_34":397,"_23":24,"_147":-5,"_304":398,"_26":399},{"_41":384,"_31":385,"_29":386,"_141":224,"_39":40,"_38":387,"_143":47,"_36":388,"_13":60,"_33":145,"_34":389,"_23":24,"_147":-5,"_304":390,"_26":391},{"_41":377,"_31":139,"_29":378,"_141":224,"_39":40,"_38":379,"_143":24,"_36":380,"_13":60,"_33":145,"_34":381,"_23":24,"_147":-5,"_304":382,"_26":383},{"_41":216,"_31":217,"_29":218,"_141":-5,"_39":40,"_38":219,"_143":47,"_36":374,"_13":60,"_33":214,"_34":-5,"_23":24,"_147":-5,"_304":375,"_26":376},{"_41":366,"_31":367,"_29":368,"_141":218,"_39":40,"_38":369,"_143":24,"_36":370,"_13":60,"_33":145,"_34":371,"_23":24,"_147":-5,"_304":372,"_26":373},{"_41":358,"_31":359,"_29":360,"_141":218,"_39":40,"_38":361,"_143":24,"_36":362,"_13":60,"_33":145,"_34":363,"_23":24,"_147":-5,"_304":364,"_26":365},{"_41":350,"_31":351,"_29":352,"_141":218,"_39":40,"_38":353,"_143":47,"_36":354,"_13":60,"_33":145,"_34":355,"_23":24,"_147":-5,"_304":356,"_26":357},{"_41":342,"_31":343,"_29":344,"_141":218,"_39":40,"_38":345,"_143":24,"_36":346,"_13":60,"_33":145,"_34":347,"_23":24,"_147":-5,"_304":348,"_26":349},{"_41":209,"_31":210,"_29":211,"_141":-5,"_39":40,"_38":212,"_143":47,"_36":339,"_13":60,"_33":214,"_34":-5,"_23":24,"_147":-5,"_304":340,"_26":341},{"_41":331,"_31":332,"_29":333,"_141":211,"_39":40,"_38":334,"_143":47,"_36":335,"_13":60,"_33":145,"_34":336,"_23":24,"_147":-5,"_304":337,"_26":338},{"_41":202,"_31":203,"_29":204,"_141":-5,"_39":40,"_38":205,"_143":24,"_36":328,"_13":60,"_33":20,"_34":207,"_23":24,"_147":-5,"_304":329,"_26":330},{"_41":195,"_31":196,"_29":197,"_141":-5,"_39":40,"_38":198,"_143":47,"_36":325,"_13":60,"_33":20,"_34":200,"_23":24,"_147":-5,"_304":326,"_26":327},{"_41":188,"_31":189,"_29":190,"_141":-5,"_39":40,"_38":191,"_143":24,"_36":322,"_13":185,"_33":20,"_34":193,"_23":24,"_147":-5,"_304":323,"_26":324},{"_41":180,"_31":181,"_29":182,"_141":-5,"_39":40,"_38":183,"_143":24,"_36":319,"_13":185,"_33":20,"_34":186,"_23":24,"_147":-5,"_304":320,"_26":321},{"_41":173,"_31":174,"_29":175,"_141":-5,"_39":40,"_38":176,"_143":47,"_36":316,"_13":60,"_33":145,"_34":178,"_23":24,"_147":-5,"_304":317,"_26":318},{"_41":164,"_31":165,"_29":55,"_141":-5,"_39":40,"_38":166,"_143":24,"_36":313,"_13":168,"_33":169,"_34":170,"_23":24,"_147":171,"_304":314,"_26":315},{"_41":156,"_31":157,"_29":158,"_141":-5,"_39":40,"_38":159,"_143":24,"_36":310,"_13":161,"_33":20,"_34":162,"_23":24,"_147":-5,"_304":311,"_26":312},{"_41":149,"_31":150,"_29":151,"_141":-5,"_39":40,"_38":152,"_143":24,"_36":307,"_13":60,"_33":145,"_34":154,"_23":24,"_147":-5,"_304":308,"_26":309},{"_41":138,"_31":139,"_29":140,"_141":-5,"_39":40,"_38":142,"_143":47,"_36":303,"_13":60,"_33":145,"_34":146,"_23":24,"_147":-5,"_304":305,"_26":306},["D",1762200814128],"children",[],[139],["D",1762207522123],[],[150],["D",1762207522872],[],[157],["D",1762207522732],[],[165],["D",1762200814266],[],[174],["D",1762207522854],[],[181],["D",1762200814124],[],[189],["D",1762196442671],[],[196],["D",1762196442809],[],[203],"7f7fe9aa-b9ca-11f0-9789-0224a6c84d84","json-parser.ts","7f7fea72-b9ca-11f0-9789-0224a6c84d84",60,["D",1762293982187],"// Fast JSON parser utility using fast-json for selective parsing\n// This is much faster than JSON.parse() for large JSON files when we only need specific fields\n\nimport { FastJson } from \"npm:fast-json@latest\";\n\ninterface ParseLatestJsonOptions {\n enableTiming?: boolean;\n}\n\n/**\n * Parse latest.json using fast-json, extracting only the fields we need\n * Much faster than JSON.parse() for large files\n */\nexport async function parseLatestJson(\n jsonString: string,\n options: ParseLatestJsonOptions = {}\n): Promise<{\n totalPages?: number;\n results?: Array<{\n url: string;\n title?: string;\n embeddings?: number[] | null;\n metadata?: any;\n contentHash?: string;\n charCount?: number;\n tokenCount?: number;\n skipped?: boolean;\n error?: string;\n }>;\n}> {\n const { enableTiming = false } = options;\n const timings: Record = {};\n const startTime = performance.now();\n \n return new Promise((resolve, reject) => {\n const fastJson = new FastJson();\n const resultsMap = new Map();\n let totalPages: number | undefined;\n let currentIndex = -1;\n \n // Track array index as we enter arrays\n fastJson.on('results', () => {\n currentIndex = -1;\n });\n \n // Extract totalPages\n fastJson.on('totalPages', (value) => {\n totalPages = value as unknown as number;\n });\n \n // Extract results array items - track index for each result\n fastJson.on('results[*]', () => {\n currentIndex++;\n if (!resultsMap.has(currentIndex)) {\n resultsMap.set(currentIndex, {});\n }\n });\n \n fastJson.on('results[*].url', (value) => {\n if (!resultsMap.has(currentIndex)) resultsMap.set(currentIndex, {});\n resultsMap.get(currentIndex)!.url = value as unknown as string;\n });\n \n fastJson.on('results[*].title', (value) => {\n if (!resultsMap.has(currentIndex)) resultsMap.set(currentIndex, {});\n resultsMap.get(currentIndex)!.title = value as unknown as string;\n });\n \n // Embeddings are arrays - need to handle them specially\n // fast-json emits arrays element by element, so we need to collect them\n const embeddingsBuffer = new Map();\n \n fastJson.on('results[*].embeddings[*]', (value) => {\n if (!resultsMap.has(currentIndex)) resultsMap.set(currentIndex, {});\n if (!embeddingsBuffer.has(currentIndex)) embeddingsBuffer.set(currentIndex, []);\n embeddingsBuffer.get(currentIndex)!.push(value as unknown as number);\n });\n \n // When embeddings array is done, store it\n fastJson.on('results[*].embeddings', (value) => {\n if (!resultsMap.has(currentIndex)) resultsMap.set(currentIndex, {});\n // If value is already an array, use it directly (fallback)\n if (Array.isArray(value)) {\n resultsMap.get(currentIndex)!.embeddings = value;\n } else if (embeddingsBuffer.has(currentIndex)) {\n // Use collected array elements\n resultsMap.get(currentIndex)!.embeddings = embeddingsBuffer.get(currentIndex)!;\n embeddingsBuffer.delete(currentIndex);\n } else {\n resultsMap.get(currentIndex)!.embeddings = value as unknown as number[] | null;\n }\n });\n \n fastJson.on('results[*].metadata', (value) => {\n if (!resultsMap.has(currentIndex)) resultsMap.set(currentIndex, {});\n resultsMap.get(currentIndex)!.metadata = value;\n });\n \n fastJson.on('results[*].contentHash', (value) => {\n if (!resultsMap.has(currentIndex)) resultsMap.set(currentIndex, {});\n resultsMap.get(currentIndex)!.contentHash = value as unknown as string;\n });\n \n fastJson.on('results[*].charCount', (value) => {\n if (!resultsMap.has(currentIndex)) resultsMap.set(currentIndex, {});\n resultsMap.get(currentIndex)!.charCount = value as unknown as number;\n });\n \n fastJson.on('results[*].tokenCount', (value) => {\n if (!resultsMap.has(currentIndex)) resultsMap.set(currentIndex, {});\n resultsMap.get(currentIndex)!.tokenCount = value as unknown as number;\n });\n \n fastJson.on('results[*].skipped', (value) => {\n if (!resultsMap.has(currentIndex)) resultsMap.set(currentIndex, {});\n resultsMap.get(currentIndex)!.skipped = value as unknown as boolean;\n });\n \n fastJson.on('results[*].error', (value) => {\n if (!resultsMap.has(currentIndex)) resultsMap.set(currentIndex, {});\n resultsMap.get(currentIndex)!.error = value as unknown as string;\n });\n \n // Parse the JSON string\n const parseStart = performance.now();\n try {\n fastJson.write(jsonString);\n \n const results = Array.from(resultsMap.values()).filter(r => r.url);\n \n if (enableTiming) {\n timings.parse = performance.now() - parseStart;\n timings.total = performance.now() - startTime;\n console.log(`⏱️ fast-json parsing:`);\n console.log(` Parse: ${timings.parse?.toFixed(2)}ms`);\n console.log(` Total: ${timings.total.toFixed(2)}ms`);\n console.log(` Results extracted: ${results.length}`);\n }\n \n resolve({\n totalPages,\n results,\n });\n } catch (error) {\n // Fall back to JSON.parse if fast-json fails\n console.warn('fast-json failed, falling back to JSON.parse:', error);\n const fallbackStart = performance.now();\n try {\n const data = JSON.parse(jsonString);\n if (enableTiming) {\n timings.fallbackParse = performance.now() - fallbackStart;\n console.log(` Fallback JSON.parse: ${timings.fallbackParse?.toFixed(2)}ms`);\n }\n resolve(data);\n } catch (parseError) {\n reject(parseError);\n }\n }\n });\n}\n\n",[],[210,332],["D",1762293981048],[293],[210],"31b6d658-b901-11f0-bfbc-0224a6c84d84","test-search.ts","31b6d70c-b901-11f0-bfbc-0224a6c84d84",43,["D",1762207522693],"// Test script for search strategies\n// Run with: deno task test-search\n// Requires: Run `deno task recalculate` first to generate /data/latest.json\n\nimport \"jsr:@std/dotenv/load\";\nimport { getAllPagesForSearch } from \"../main.tsx\";\nimport { runSearchTest } from \"./search-harness.ts\";\nimport { questions } from \"./questions.ts\";\n\nasync function testSearchStrategies() {\n // Load cached data from latest.json\n let cachedData: any = null;\n try {\n const latestData = await Deno.readTextFile(\"./data/latest.json\");\n cachedData = JSON.parse(latestData);\n console.log(`Loaded cached data from /data/latest.json (${cachedData.totalPages} pages)`);\n } catch (error) {\n console.error(\"Failed to load /data/latest.json. Please run 'deno task recalculate' first.\");\n console.error(error);\n Deno.exit(1);\n }\n \n // Load actual pages with embeddings for search\n const pagesWithEmbeddings = await getAllPagesForSearch();\n console.log(`Loaded ${pagesWithEmbeddings.length} pages with embeddings for search`);\n \n // Load test questions\n const testQueries = questions;\n console.log(`Loaded ${testQueries.length} test questions\\n`);\n \n for (const query of testQueries) {\n console.log(`\\n${\"=\".repeat(60)}`);\n console.log(`Testing query: \"${query}\"`);\n console.log(`${\"=\".repeat(60)}`);\n \n const testResult = await runSearchTest(query, pagesWithEmbeddings, {\n limit: 10,\n minScore: 0,\n enableTiming: true, // Enable timing breakdown\n });\n \n if (testResult.error) {\n console.error(` ❌ Error: ${testResult.error}`);\n console.log(` ⏱️ Duration: ${testResult.durationMs.toFixed(2)}ms`);\n } else {\n console.log(` ✅ Found ${testResult.results.length} results in ${testResult.durationMs.toFixed(2)}ms\\n`);\n \n if (testResult.results.length === 0) {\n console.log(\" No results found.\");\n } else {\n testResult.results.forEach((result, index) => {\n console.log(` ${index + 1}. ${result.title || result.path}`);\n console.log(` Path: ${result.path}`);\n console.log(` Score: ${result.score.toFixed(2)}${result.metadata?.similarity ? ` (similarity: ${(result.metadata.similarity * 100).toFixed(2)}%)` : ''}`);\n if (result.snippet) {\n const snippet = result.snippet.length > 150 \n ? result.snippet.substring(0, 150) + '...' \n : result.snippet;\n console.log(` Snippet: ${snippet}`);\n }\n console.log('');\n });\n }\n }\n }\n \n console.log(`\\n${\"=\".repeat(60)}`);\n console.log(\"Test completed!\");\n console.log(`${\"=\".repeat(60)}\\n`);\n}\n\n// Run if executed directly\nif (import.meta.main) {\n testSearchStrategies().catch(console.error);\n}\n\n",[],[217,343],"3193ad5e-b901-11f0-a764-0224a6c84d84","search-harness.ts","3193ae26-b901-11f0-a764-0224a6c84d84",39,["D",1762207522627],"// Test harness for search functionality\n// Reusable function for testing search queries\n\nimport { searchPages } from \"../search/index.ts\";\nimport type { Page, SearchResult, SearchOptions } from \"../search/types.ts\";\n\nexport interface SearchTestResult {\n results: SearchResult[];\n durationMs: number;\n error?: string;\n}\n\n/**\n * Test harness function for running a single search query\n * @param query - The search query string\n * @param pages - Array of pages to search through\n * @param options - Search options (limit, minScore, etc.)\n * @returns Promise with results and timing information\n */\nexport async function runSearchTest(\n query: string,\n pages: Page[],\n options: SearchOptions = {}\n): Promise {\n const startTime = performance.now();\n \n try {\n const results = await searchPages(query, pages, options);\n const endTime = performance.now();\n const durationMs = endTime - startTime;\n \n return {\n results,\n durationMs,\n };\n } catch (error) {\n const endTime = performance.now();\n const durationMs = endTime - startTime;\n \n return {\n results: [],\n durationMs,\n error: error instanceof Error ? error.message : String(error),\n };\n }\n}\n\n",[],[217,351],"319c6fde-b901-11f0-a8ca-0224a6c84d84","recalculate.ts","319c70b0-b901-11f0-a8ca-0224a6c84d84",40,["D",1762207522645],"// Recalculate script - runs cache recalculation and saves to /data/latest.json and /data/mm-dd-yyyy.json\n// Run with: deno task recalculate\n\nimport \"jsr:@std/dotenv/load\";\nimport { urls } from \"../urls.ts\";\nimport {\n IS_VALTOWN,\n getFromCache,\n setCache,\n calculateContentHash,\n getTextFromUrl,\n parseFrontmatter,\n addUrlSourceToFrontmatter,\n calculateTokenCount,\n} from \"../utils.ts\";\nimport { generatePageMetadata } from \"../groq.ts\";\nimport { getActiveEmbeddingsFunction } from \"../search/index.ts\";\nimport { saveTestData } from \"../main.tsx\";\n\n// Load cached data from latest.json (for local hash checking)\nasync function loadLatestJson(): Promise | null> {\n if (IS_VALTOWN) {\n return null; // Use SQLite when in Val Town\n }\n \n try {\n const latestData = await Deno.readTextFile(\"./data/latest.json\");\n const data = JSON.parse(latestData);\n \n // Create a map of url -> cached data\n const cacheMap: Record = {};\n \n if (data.results && Array.isArray(data.results)) {\n for (const result of data.results) {\n if (result.url) {\n cacheMap[result.url] = {\n contentHash: result.contentHash,\n charCount: result.charCount,\n tokenCount: result.tokenCount,\n title: result.title,\n metadata: result.metadata,\n embeddings: result.embeddings || null,\n };\n }\n }\n }\n \n return cacheMap;\n } catch {\n // latest.json doesn't exist or is invalid - that's okay, just return null\n return null;\n }\n}\n\nasync function recalculate(force: boolean = false) {\n console.log(`Starting recalculation (force: ${force}, local: ${!IS_VALTOWN})...`);\n \n // Load latest.json for hash checking when running locally\n const latestJsonData = await loadLatestJson();\n if (latestJsonData && !force) {\n console.log(`Loaded ${Object.keys(latestJsonData).length} cached hashes from latest.json`);\n }\n \n const results: Array<{ \n path: string; \n url: string; \n charCount: number; \n tokenCount: number | undefined;\n title?: string;\n metadata?: any;\n contentHash?: string;\n embeddings?: number[] | null;\n error?: string;\n cacheError?: string;\n skipped?: boolean;\n reason?: string;\n }> = [];\n \n let processedCount = 0;\n let skippedCount = 0;\n \n const getPageByPath = async (pathParam: string, useCache: boolean = true) => {\n // Find the matching URL\n const matchingUrl = urls.find(url => {\n const match = url.match(/\\/docs\\/(.+?)\\.md$/);\n if (match) {\n return match[1] === pathParam;\n }\n if (url.endsWith(\"/docs.md\") && pathParam === \"docs\") {\n return true;\n }\n return false;\n });\n \n if (!matchingUrl) {\n return null;\n }\n \n // Try to get from cache first\n if (useCache) {\n const cached = await getFromCache(matchingUrl);\n if (cached) {\n return {\n url: cached.frontmatter?.urlSource || matchingUrl,\n content: cached.content,\n charCount: cached.charCount,\n tokenCount: cached.tokenCount,\n };\n }\n }\n \n // Fetch and process the single page\n const text = await getTextFromUrl(matchingUrl);\n const processedText = addUrlSourceToFrontmatter(text, matchingUrl);\n const charCount = processedText.length;\n const tokenCount = calculateTokenCount(processedText);\n \n return {\n url: matchingUrl,\n content: processedText,\n charCount,\n tokenCount,\n };\n };\n \n for (const url of urls) {\n // Extract path from URL\n const match = url.match(/\\/docs\\/(.+?)\\.md$/);\n const path = match ? match[1] : (url.endsWith(\"/docs.md\") ? \"docs\" : null);\n \n if (path) {\n console.log(`[${processedCount + 1}/${urls.length}] Processing ${path}...`);\n \n try {\n // Check cached hash if not forcing\n let shouldSkip = false;\n if (!force) {\n // Try SQLite cache first (if in Val Town)\n let cached = await getFromCache(url);\n \n // If no SQLite cache, try latest.json (for local development)\n let cachedHash: string | null = null;\n let cachedFromJson: any = null;\n \n if (cached) {\n cachedHash = cached.contentHash;\n } else if (latestJsonData && latestJsonData[url]) {\n cachedFromJson = latestJsonData[url];\n cachedHash = cachedFromJson.contentHash || null;\n }\n \n if (cachedHash) {\n // Fetch fresh content to check hash\n try {\n const pageData = await getPageByPath(path, false);\n if (pageData) {\n const newHash = await calculateContentHash(pageData.content);\n if (newHash === cachedHash) {\n shouldSkip = true;\n skippedCount++;\n console.log(` Skipped ${path} (content unchanged, hash: ${newHash.substring(0, 8)}...)`);\n \n // Use cached data from SQLite or latest.json\n if (cached) {\n results.push({\n path,\n url,\n charCount: cached.charCount,\n tokenCount: cached.tokenCount || undefined,\n title: (cached.frontmatter as any).title || path,\n metadata: cached.metadata || undefined,\n contentHash: cachedHash,\n embeddings: cached.embeddings || null,\n skipped: true,\n reason: \"Content unchanged (hash matches)\",\n });\n } else if (cachedFromJson) {\n results.push({\n path,\n url,\n charCount: cachedFromJson.charCount || 0,\n tokenCount: cachedFromJson.tokenCount || undefined,\n title: cachedFromJson.title || path,\n metadata: cachedFromJson.metadata || undefined,\n contentHash: cachedHash,\n embeddings: cachedFromJson.embeddings || null,\n skipped: true,\n reason: \"Content unchanged (hash matches)\",\n });\n }\n }\n }\n } catch (hashCheckError) {\n // If hash check fails, continue with processing\n console.debug(` Hash check failed for ${path}, continuing...`);\n }\n }\n }\n \n if (shouldSkip) {\n processedCount++;\n continue;\n }\n \n // Fetch without cache\n let pageData;\n try {\n pageData = await getPageByPath(path, false);\n } catch (fetchError) {\n const fetchErrorMessage = fetchError instanceof Error ? fetchError.message : String(fetchError);\n console.error(` Failed to fetch ${path}:`, fetchErrorMessage);\n throw new Error(`Fetch failed: ${fetchErrorMessage}`);\n }\n \n if (pageData) {\n const frontmatter = parseFrontmatter(pageData.content);\n const title = (frontmatter as any).title || path;\n \n // Calculate content hash\n const contentHash = await calculateContentHash(pageData.content);\n \n // Generate AI metadata\n const metadata = await generatePageMetadata(pageData.content, title);\n if (!metadata) {\n console.warn(` Metadata generation failed for ${path} (continuing without metadata)`);\n }\n \n // Generate embeddings using active strategy's embeddings function\n const generateEmbeddings = getActiveEmbeddingsFunction();\n let embeddings: number[] | null = null;\n let embeddingsError: string | undefined = undefined;\n \n try {\n embeddings = await generateEmbeddings(pageData.content);\n if (!embeddings) {\n embeddingsError = \"Embeddings generation returned null\";\n console.error(` ❌ Embeddings generation failed for ${path}: ${embeddingsError}`);\n }\n } catch (embedError) {\n const embedErrorMessage = embedError instanceof Error ? embedError.message : String(embedError);\n embeddingsError = `Embeddings generation threw error: ${embedErrorMessage}`;\n console.error(` ❌ Embeddings generation failed for ${path}: ${embeddingsError}`);\n // Don't throw - continue with null embeddings, but log the error\n }\n \n // Cache it with metadata, hash, and embeddings - track errors\n const cacheError = await setCache(url, {\n content: pageData.content,\n charCount: pageData.charCount,\n tokenCount: pageData.tokenCount || null,\n frontmatter,\n metadata,\n contentHash,\n embeddings,\n });\n \n results.push({ \n path, \n url, \n charCount: pageData.charCount, \n tokenCount: pageData.tokenCount,\n title,\n metadata,\n contentHash,\n embeddings: embeddings || null,\n ...(cacheError && { cacheError }),\n ...(embeddingsError && { embeddingsError }),\n });\n \n const statusParts = [\n `metadata: ${metadata ? 'yes' : 'no'}`,\n `embeddings: ${embeddings ? 'yes' : 'no'}`,\n ];\n \n if (embeddingsError) {\n statusParts.push(`embeddings error: ${embeddingsError.substring(0, 50)}...`);\n }\n if (cacheError) {\n statusParts.push(`cache error: ${cacheError}`);\n }\n \n const status = statusParts.join(', ');\n if (embeddingsError || cacheError) {\n console.warn(`Completed ${path} (${status})`);\n } else {\n console.log(`Completed ${path} (${status}, cached: yes)`);\n }\n }\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n console.error(`Error processing ${path}:`, errorMessage);\n results.push({\n path,\n url,\n charCount: 0,\n tokenCount: 0,\n error: errorMessage,\n });\n }\n \n processedCount++;\n }\n }\n \n const cacheErrors = results.filter(r => r.cacheError);\n const processedResults = results.filter(r => !r.skipped);\n \n const summary = {\n message: force \n ? `Recalculated ${processedResults.length} pages with AI metadata (force mode)` \n : `Recalculated ${processedResults.length} pages, skipped ${skippedCount} unchanged pages`,\n timestamp: new Date().toISOString(),\n results,\n totalPages: results.length,\n processed: processedResults.length,\n skipped: skippedCount,\n withMetadata: processedResults.filter(r => r.metadata).length,\n withoutMetadata: processedResults.filter(r => !r.metadata).length,\n cached: processedResults.length > 0 && cacheErrors.length === 0,\n cacheErrors: cacheErrors.length > 0 ? cacheErrors.map(r => ({ path: r.path, error: r.cacheError })) : undefined,\n force,\n };\n \n // Save to both latest.json and dated file\n await saveTestData(summary);\n console.log(\"\\nRecalculation completed!\");\n \n return summary;\n}\n\n// Run if executed directly\nif (import.meta.main) {\n const force = Deno.args.includes(\"--force\") || Deno.args.includes(\"-f\");\n recalculate(force).catch(console.error);\n}\n\n",[],[217,359],"31a38e68-b901-11f0-a3b9-0224a6c84d84","questions.ts","31a38f30-b901-11f0-a3b9-0224a6c84d84",41,["D",1762207522633],"// Test questions for search testing\n// Full sentence questions about Groq\n\nexport const questions: string[] = [\n \"What is Compound and how does it work?\",\n // \"How do I authenticate with the Groq API?\",\n // \"What are the rate limits for Groq models?\",\n // \"How do I integrate Groq with my JavaScript application?\",\n // \"What is the difference between compound and compound-mini?\",\n // \"Can I use Groq for real-time web search?\",\n // \"How do I get started with Groq's API?\",\n // \"What models are available on Groq?\",\n // \"How does Groq's Compound AI system work?\",\n // \"Can I use custom tools with Groq's Compound AI?\",\n];\n\n",[],[217,367],["D",1762207521420],[288,289,290,291],[217],"31528cd4-b901-11f0-a3b9-0224a6c84d84","31528d88-b901-11f0-a3b9-0224a6c84d84",32,["D",1762207522155],"// Shared utilities for search strategies\n\n// Calculate cosine similarity between two embedding vectors\nexport const cosineSimilarity = (vecA: number[], vecB: number[]): number => {\n if (vecA.length !== vecB.length) {\n return 0;\n }\n \n let dotProduct = 0;\n let normA = 0;\n let normB = 0;\n \n for (let i = 0; i < vecA.length; i++) {\n dotProduct += vecA[i] * vecB[i];\n normA += vecA[i] * vecA[i];\n normB += vecB[i] * vecB[i];\n }\n \n if (normA === 0 || normB === 0) {\n return 0;\n }\n \n return dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));\n};\n\n// Helper function to generate snippets\nexport const generateSnippet = (content: string, queryWords: string[], queryLower: string): string => {\n const contentLower = content.toLowerCase();\n const firstMatchIndex = contentLower.indexOf(queryWords[0]);\n \n if (firstMatchIndex >= 0) {\n const start = Math.max(0, firstMatchIndex - 50);\n const end = Math.min(content.length, firstMatchIndex + queryWords[0].length + 150);\n let snippet = content.substring(start, end);\n if (start > 0) snippet = '...' + snippet;\n if (end < content.length) snippet = snippet + '...';\n return snippet;\n }\n \n return content.substring(0, 200) + '...';\n};\n\n",[],[223,139],"316a968a-b901-11f0-9996-0224a6c84d84","types.ts","316a973e-b901-11f0-9996-0224a6c84d84",34,["D",1762207522301],"// Search strategy types and interfaces\n\nexport type SearchResult = {\n path: string;\n url: string;\n title?: string;\n score: number;\n snippet?: string;\n metadata?: {\n strategy?: string;\n [key: string]: any;\n };\n};\n\nexport type Page = {\n path: string;\n url: string;\n content: string;\n title?: string;\n embeddings?: number[] | null;\n metadata?: any;\n};\n\nexport type SearchOptions = {\n limit?: number;\n minScore?: number;\n [key: string]: any;\n};\n\nexport type SearchStrategy = {\n name: string;\n description: string;\n search: (query: string, pages: Page[], options: SearchOptions) => Promise;\n};\n\n",[],[223,385],"7f8a6948-b9ca-11f0-ac30-0224a6c84d84","transformers-local-onnx.ts","7f8a6d08-b9ca-11f0-ac30-0224a6c84d84",61,["D",1762293982236],"// Transformers.js + Local ONNX Models + Cosine Similarity Strategy\n// Uses pre-downloaded ONNX models from the models/ directory\n// Fastest option - no downloads, no API calls, runs entirely locally\n// Model: all-MiniLM-L6-v2 (~23MB or ~6MB quantized, ~384 dimensions)\n\nimport type { SearchStrategy, SearchResult, Page, SearchOptions } from \"./types.ts\";\nimport { generateSnippet, cosineSimilarity } from \"./utils.ts\";\n\n// Lazy-loaded pipeline (cached after first load)\nlet embeddingPipeline: any = null;\nlet pipelineLoading: Promise | null = null;\n\n// Configuration\nconst MODEL_PATH = new URL(\"./models/all-MiniLM-L6-v2\", import.meta.url).pathname;\nconst USE_QUANTIZED = false; // Set to true to use model_quantized.onnx (faster, slightly less accurate)\n\n// Cleanup function to dispose of pipeline resources\nexport const disposePipeline = async (): Promise => {\n if (embeddingPipeline) {\n try {\n if (typeof embeddingPipeline.dispose === 'function') {\n await embeddingPipeline.dispose();\n } else if (typeof embeddingPipeline.disconnect === 'function') {\n await embeddingPipeline.disconnect();\n }\n embeddingPipeline = null;\n } catch (error) {\n console.debug(\"Pipeline cleanup error (ignored):\", error);\n }\n }\n};\n\n// Prevent ONNX runtime cleanup crash on exit\n// The crash is harmless but annoying - this suppresses it\nif (typeof Deno !== \"undefined\") {\n Deno.addSignalListener(\"SIGINT\", () => {\n // Force immediate exit without cleanup\n Deno.exit(0);\n });\n \n // Also handle unload event\n globalThis.addEventListener(\"unload\", () => {\n // Prevent any cleanup that might cause mutex errors\n embeddingPipeline = null;\n });\n}\n\nasync function getEmbeddingPipeline() {\n // Return cached pipeline if already loaded\n if (embeddingPipeline) {\n return embeddingPipeline;\n }\n \n // If loading in progress, wait for it\n if (pipelineLoading) {\n return pipelineLoading;\n }\n \n // Start loading pipeline\n pipelineLoading = (async () => {\n const modelLoadTimings: Record = {};\n const modelLoadStart = performance.now();\n \n try {\n // Import transformers.js - use npm: prefix for Deno compatibility\n const importStart = performance.now();\n const { pipeline, env } = await import(\"npm:@huggingface/transformers@latest\");\n modelLoadTimings.npmImport = performance.now() - importStart;\n \n // Configure to use local models\n env.allowRemoteModels = false; // Prevent downloading from HuggingFace\n env.allowLocalModels = true;\n \n // Load feature extraction pipeline from local ONNX model\n const pipelineStart = performance.now();\n const modelType = USE_QUANTIZED ? 'quantized' : 'full';\n \n console.log(`📂 Loading local ONNX model from: ${MODEL_PATH}`);\n console.log(` Using ${modelType} model`);\n \n embeddingPipeline = await pipeline(\n 'feature-extraction',\n MODEL_PATH,\n {\n device: 'cpu',\n dtype: 'fp32',\n // Point to local model files - don't specify model_file_name as it causes double .onnx extension\n local_files_only: true,\n ...(USE_QUANTIZED ? { quantized: true } : {}),\n }\n );\n \n modelLoadTimings.pipelineLoad = performance.now() - pipelineStart;\n modelLoadTimings.totalModelLoad = performance.now() - modelLoadStart;\n \n console.log(`✅ Local ONNX model loaded successfully:`);\n console.log(` npm import: ${modelLoadTimings.npmImport?.toFixed(2)}ms`);\n console.log(` pipeline load: ${modelLoadTimings.pipelineLoad?.toFixed(2)}ms (from local files)`);\n console.log(` total model load: ${modelLoadTimings.totalModelLoad?.toFixed(2)}ms`);\n \n return embeddingPipeline;\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n const fullError = `Failed to load local ONNX model from ${MODEL_PATH}: ${errorMessage}\\n` +\n `\\nPlease ensure the model files are downloaded. See search/models/README.md for setup instructions.\\n` +\n `\\nTo download the model:\\n` +\n ` cd search/models\\n` +\n ` git clone https://huggingface.co/Xenova/all-MiniLM-L6-v2\\n` +\n ` rm -rf all-MiniLM-L6-v2/.git\\n`;\n console.error(fullError);\n if (modelLoadTimings.npmImport) {\n console.error(` Failed after npm import (${modelLoadTimings.npmImport.toFixed(2)}ms)`);\n }\n throw new Error(fullError);\n } finally {\n pipelineLoading = null;\n }\n })();\n \n return pipelineLoading;\n}\n\n// Generate embeddings using local ONNX model (runs locally, no network calls)\nexport const generateEmbeddings = async (content: string): Promise => {\n try {\n const pipeline = await getEmbeddingPipeline();\n \n // Generate embeddings - returns a tensor, we need to extract the array\n const output = await pipeline(content, {\n pooling: 'mean',\n normalize: true,\n });\n \n // Extract the embedding vector from the tensor\n if (output && typeof output === 'object') {\n // Check for .data property (common tensor format)\n if (output.data && Array.isArray(output.data)) {\n return output.data;\n }\n \n // Check if it's a nested array (tensor shape)\n if (Array.isArray(output)) {\n if (Array.isArray(output[0])) {\n return output[0]; // Return first row if 2D\n }\n return output;\n }\n \n // Try accessing tensor properties\n if (output.size && output.data) {\n return Array.from(output.data);\n }\n \n // Try tolist() method if available\n if (typeof output.tolist === 'function') {\n const list = output.tolist();\n return Array.isArray(list[0]) ? list[0] : list;\n }\n }\n \n // Fallback: try to convert to array\n return Array.from(output as any);\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n console.error(\"Local ONNX embeddings failed:\", errorMessage);\n return null;\n }\n};\n\nexport const searchStrategy: SearchStrategy = {\n name: \"transformers-local-onnx\",\n description: \"Semantic search using local pre-downloaded ONNX models with cosine similarity (fastest, no downloads, no API calls)\",\n search: async (query: string, pages: Page[], options: SearchOptions = {}): Promise => {\n const limit = options.limit || 10;\n const minSimilarity = (options.minScore || 0) / 100; // Convert to 0-1 scale\n const enableTiming = options.enableTiming || false;\n \n const timings: Record = {};\n const startTime = performance.now();\n \n // Generate query embedding (local, no network calls)\n const queryEmbedStart = performance.now();\n const queryEmbedding = await generateEmbeddings(query);\n if (enableTiming) {\n timings.queryEmbedding = performance.now() - queryEmbedStart;\n }\n \n if (!queryEmbedding) {\n console.warn(\"Query embedding generation failed, returning empty results\");\n return [];\n }\n \n // Calculate cosine similarity for each page\n const similarityStart = performance.now();\n const scoredPages: Array<{ page: Page; similarity: number }> = [];\n \n for (const page of pages) {\n const pageEmbedding = page.embeddings;\n if (!pageEmbedding || pageEmbedding.length !== queryEmbedding.length) {\n continue; // Skip pages without embeddings or wrong dimension\n }\n \n const similarity = cosineSimilarity(queryEmbedding, pageEmbedding);\n if (similarity >= minSimilarity) {\n scoredPages.push({ page, similarity });\n }\n }\n \n if (enableTiming) timings.similarity = performance.now() - similarityStart;\n \n // Sort by similarity (descending) and limit\n const sortStart = performance.now();\n scoredPages.sort((a, b) => b.similarity - a.similarity);\n const topPages = scoredPages.slice(0, limit);\n if (enableTiming) timings.sort = performance.now() - sortStart;\n \n // Transform to SearchResult format\n const transformStart = performance.now();\n const queryWords = query.toLowerCase().split(/\\s+/).filter(w => w.length > 0);\n const results: SearchResult[] = topPages.map(({ page, similarity }) => ({\n path: page.path,\n url: page.url,\n title: page.title || page.path,\n score: similarity * 100, // Convert to 0-100 scale\n snippet: generateSnippet(page.content, queryWords, query.toLowerCase()),\n metadata: {\n strategy: \"transformers-local-onnx\",\n similarity,\n localModel: true,\n modelPath: MODEL_PATH,\n quantized: USE_QUANTIZED,\n ...(enableTiming && { timings }),\n },\n }));\n if (enableTiming) timings.transform = performance.now() - transformStart;\n \n if (enableTiming) {\n timings.total = performance.now() - startTime;\n console.log(` ⏱️ Timing breakdown (Local ONNX):`);\n console.log(` Query embedding: ${timings.queryEmbedding?.toFixed(2)}ms (local model - no network)`);\n console.log(` Cosine similarity: ${timings.similarity?.toFixed(2)}ms`);\n console.log(` Sort: ${timings.sort?.toFixed(2)}ms`);\n console.log(` Transform: ${timings.transform?.toFixed(2)}ms`);\n console.log(` Total: ${timings.total?.toFixed(2)}ms`);\n }\n \n return results;\n },\n};\n\n",[],[223,393],"31884234-b901-11f0-b784-0224a6c84d84","transformers-cosine.ts","31884324-b901-11f0-b784-0224a6c84d84",38,["D",1762207522387],"// Transformers.js + Cosine Similarity Strategy: Local embeddings in browser/Deno\n// Fastest option - no API calls, runs entirely client-side\n// Model: all-MiniLM-L6-v2 (80MB, ~384 dimensions, very fast)\n\nimport type { SearchStrategy, SearchResult, Page, SearchOptions } from \"./types.ts\";\nimport { generateSnippet, cosineSimilarity } from \"./utils.ts\";\n\n// Lazy-loaded pipeline (cached after first load)\nlet embeddingPipeline: any = null;\nlet pipelineLoading: Promise | null = null;\n\nasync function getEmbeddingPipeline() {\n // Return cached pipeline if already loaded\n if (embeddingPipeline) {\n return embeddingPipeline;\n }\n \n // If loading in progress, wait for it\n if (pipelineLoading) {\n return pipelineLoading;\n }\n \n // Start loading pipeline\n pipelineLoading = (async () => {\n try {\n // Import transformers.js - use npm: prefix for Deno compatibility\n // NOTE: transformers.js is primarily designed for browsers. In Deno, it may require --allow-ffi\n // For browser usage, this will work seamlessly. For Deno, you may need additional permissions.\n const { pipeline } = await import(\"npm:@huggingface/transformers@latest\");\n \n // Load feature extraction pipeline with all-MiniLM-L6-v2 model\n // This is a small, fast model optimized for embeddings (80MB, ~384 dims)\n embeddingPipeline = await pipeline(\n 'feature-extraction',\n 'Xenova/all-MiniLM-L6-v2',\n {\n // Use CPU - WebGPU might not be available in all environments\n device: 'cpu',\n dtype: 'fp32',\n }\n );\n \n return embeddingPipeline;\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n const fullError = `Failed to load transformers.js pipeline: ${errorMessage}\\n` +\n `NOTE: transformers.js is primarily designed for browser environments. ` +\n `If running in Deno, you may need --allow-ffi permissions, or use a different embedding strategy.`;\n console.error(fullError);\n throw new Error(fullError);\n } finally {\n pipelineLoading = null;\n }\n })();\n \n return pipelineLoading;\n}\n\n// Generate embeddings using transformers.js (runs locally, no API calls)\nexport const generateEmbeddings = async (content: string): Promise => {\n try {\n const pipeline = await getEmbeddingPipeline();\n \n // Generate embeddings - returns a tensor, we need to extract the array\n const output = await pipeline(content, {\n pooling: 'mean',\n normalize: true,\n });\n \n // Extract the embedding vector from the tensor\n // Transformers.js returns a Tensor object - handle different formats\n if (output && typeof output === 'object') {\n // Check for .data property (common tensor format)\n if (output.data && Array.isArray(output.data)) {\n return output.data;\n }\n \n // Check if it's a nested array (tensor shape)\n if (Array.isArray(output)) {\n // Flatten if nested\n if (Array.isArray(output[0])) {\n return output[0]; // Return first row if 2D\n }\n return output;\n }\n \n // Try accessing tensor properties\n if (output.size && output.data) {\n return Array.from(output.data);\n }\n \n // Try tolist() method if available\n if (typeof output.tolist === 'function') {\n const list = output.tolist();\n return Array.isArray(list[0]) ? list[0] : list;\n }\n }\n \n // Fallback: try to convert to array\n return Array.from(output as any);\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n console.error(\"Transformers.js embeddings failed:\", errorMessage);\n return null;\n }\n};\n\nexport const searchStrategy: SearchStrategy = {\n name: \"transformers-cosine\",\n description: \"Semantic search using Transformers.js local embeddings with cosine similarity (fastest, no API calls)\",\n search: async (query: string, pages: Page[], options: SearchOptions = {}): Promise => {\n const limit = options.limit || 10;\n const minSimilarity = (options.minScore || 0) / 100; // Convert to 0-1 scale\n const enableTiming = options.enableTiming || false;\n \n const timings: Record = {};\n const startTime = performance.now();\n \n // Generate query embedding (local, no API call)\n const queryEmbedStart = performance.now();\n const queryEmbedding = await generateEmbeddings(query);\n if (enableTiming) {\n timings.queryEmbedding = performance.now() - queryEmbedStart;\n }\n \n if (!queryEmbedding) {\n console.warn(\"Query embedding generation failed, returning empty results\");\n return [];\n }\n \n // Calculate cosine similarity for each page\n const similarityStart = performance.now();\n const scoredPages: Array<{ page: Page; similarity: number }> = [];\n \n for (const page of pages) {\n const pageEmbedding = page.embeddings;\n if (!pageEmbedding || pageEmbedding.length !== queryEmbedding.length) {\n continue; // Skip pages without embeddings or wrong dimension\n }\n \n const similarity = cosineSimilarity(queryEmbedding, pageEmbedding);\n if (similarity >= minSimilarity) {\n scoredPages.push({ page, similarity });\n }\n }\n \n if (enableTiming) timings.similarity = performance.now() - similarityStart;\n \n // Sort by similarity (descending) and limit\n const sortStart = performance.now();\n scoredPages.sort((a, b) => b.similarity - a.similarity);\n const topPages = scoredPages.slice(0, limit);\n if (enableTiming) timings.sort = performance.now() - sortStart;\n \n // Transform to SearchResult format\n const transformStart = performance.now();\n const queryWords = query.toLowerCase().split(/\\s+/).filter(w => w.length > 0);\n const results: SearchResult[] = topPages.map(({ page, similarity }) => ({\n path: page.path,\n url: page.url,\n title: page.title || page.path,\n score: similarity * 100, // Convert to 0-100 scale\n snippet: generateSnippet(page.content, queryWords, query.toLowerCase()),\n metadata: {\n strategy: \"transformers-cosine\",\n similarity,\n ...(enableTiming && { timings }),\n },\n }));\n if (enableTiming) timings.transform = performance.now() - transformStart;\n \n if (enableTiming) {\n timings.total = performance.now() - startTime;\n console.log(` ⏱️ Timing breakdown:`);\n console.log(` Query embedding: ${timings.queryEmbedding?.toFixed(2)}ms (local model - no API)`);\n console.log(` Cosine similarity: ${timings.similarity?.toFixed(2)}ms`);\n console.log(` Sort: ${timings.sort?.toFixed(2)}ms`);\n console.log(` Transform: ${timings.transform?.toFixed(2)}ms`);\n console.log(` Total: ${timings.total?.toFixed(2)}ms`);\n }\n \n return results;\n },\n};\n\n",[],[223,401],"3181e164-b901-11f0-a3b9-0224a6c84d84","placeholder.ts","3181e22c-b901-11f0-a3b9-0224a6c84d84",37,["D",1762207522458],"// Placeholder Strategy: Keyword-based search (current default)\n\nimport type { SearchStrategy, SearchResult, Page, SearchOptions } from \"./types.ts\";\nimport { generateSnippet } from \"./utils.ts\";\n\n// Fake embeddings function for placeholder (not actually used, but kept for interface consistency)\nexport const generateEmbeddings = async (content: string): Promise => {\n // Not used in placeholder strategy, but kept for consistency\n // Returns fake embeddings for caching purposes\n console.debug(\"Generating fake embeddings for placeholder strategy\");\n \n const fakeEmbedding: number[] = [];\n const hash = content.split('').reduce((acc, char) => acc + char.charCodeAt(0), 0);\n \n for (let i = 0; i < 384; i++) {\n const value = Math.sin(hash + i) * 0.5 + 0.5;\n fakeEmbedding.push(value);\n }\n \n return fakeEmbedding;\n};\n\nexport const searchStrategy: SearchStrategy = {\n name: \"placeholder\",\n description: \"Keyword-based search using title, content, and metadata matching\",\n search: async (query: string, pages: Page[], options: SearchOptions = {}): Promise => {\n const limit = options.limit || 10;\n const minScore = options.minScore || 0;\n \n const queryLower = query.toLowerCase();\n const queryWords = queryLower.split(/\\s+/).filter(w => w.length > 0);\n \n const results: SearchResult[] = [];\n \n for (const page of pages) {\n let score = 0;\n const contentLower = page.content.toLowerCase();\n const titleLower = (page.title || page.path).toLowerCase();\n \n // Title matches are worth more\n for (const word of queryWords) {\n if (titleLower.includes(word)) {\n score += 10;\n }\n // Count occurrences in content\n const contentMatches = (contentLower.match(new RegExp(word, 'g')) || []).length;\n score += Math.min(contentMatches, 5); // Cap at 5 points per word\n }\n \n // Exact phrase match bonus\n if (contentLower.includes(queryLower)) {\n score += 20;\n }\n \n // Metadata boost (if query matches tags or categories)\n if (page.metadata) {\n const tags = (page.metadata.tags || []).join(' ').toLowerCase();\n const categories = (page.metadata.categories || []).join(' ').toLowerCase();\n const useCases = (page.metadata.useCases || []).join(' ').toLowerCase();\n \n for (const word of queryWords) {\n if (tags.includes(word)) score += 3;\n if (categories.includes(word)) score += 2;\n if (useCases.includes(word)) score += 2;\n }\n }\n \n if (score > minScore) {\n results.push({\n path: page.path,\n url: page.url,\n title: page.title,\n score,\n snippet: generateSnippet(page.content, queryWords, queryLower),\n metadata: {\n strategy: \"placeholder\",\n },\n });\n }\n }\n \n // Sort by score descending\n results.sort((a, b) => b.score - a.score);\n \n return results.slice(0, limit);\n },\n};\n\n",[],[223,409],"314db04c-b901-11f0-a764-0224a6c84d84","openai-orama.ts","314db0ec-b901-11f0-a764-0224a6c84d84",31,["D",1762207522111],"// OpenAI + Orama Strategy: Semantic search using OpenAI embeddings and Orama\n// Faster than JigsawStack (~100-200ms vs ~550ms for query embeddings)\n\nimport type { SearchStrategy, SearchResult, Page, SearchOptions } from \"./types.ts\";\nimport { generateSnippet } from \"./utils.ts\";\nimport { create, insertMultiple, search } from \"npm:@orama/orama@latest\";\n\n// OpenAI embeddings function\nexport const generateEmbeddings = async (content: string): Promise => {\n const OPENAI_API_KEY = Deno.env.get(\"OPENAI_API_KEY\");\n const OPENAI_API_URL = \"https://api.openai.com/v1/embeddings\";\n \n if (!OPENAI_API_KEY) {\n console.warn(\"OPENAI_API_KEY not found - embeddings disabled\");\n return null;\n }\n \n try {\n const response = await fetch(OPENAI_API_URL, {\n method: \"POST\",\n headers: {\n \"Authorization\": `Bearer ${OPENAI_API_KEY}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n model: \"text-embedding-3-small\", // Fast and efficient model\n input: content,\n }),\n });\n \n if (!response.ok) {\n const errorText = await response.text().catch(() => response.statusText);\n throw new Error(`OpenAI API error: ${response.status} ${response.statusText} - ${errorText.substring(0, 200)}`);\n }\n \n const data = await response.json();\n \n if (data.data && Array.isArray(data.data) && data.data.length > 0) {\n return data.data[0].embedding; // Return the embedding vector\n }\n \n return null;\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n console.error(\"OpenAI embeddings failed:\", errorMessage);\n return null;\n }\n};\n\n// No caching for query embeddings - we want to benchmark actual API performance\n\nexport const searchStrategy: SearchStrategy = {\n name: \"openai-orama\",\n description: \"Semantic search using OpenAI embeddings with Orama vector search (faster than JigsawStack)\",\n search: async (query: string, pages: Page[], options: SearchOptions = {}): Promise => {\n const limit = options.limit || 10;\n const minSimilarity = (options.minScore || 0) / 100; // Convert to 0-1 scale\n const enableTiming = options.enableTiming || false;\n \n const timings: Record = {};\n const startTime = performance.now();\n \n // Generate query embedding (no caching - benchmarking actual API performance)\n const queryEmbedStart = performance.now();\n const queryEmbedding = await generateEmbeddings(query);\n if (enableTiming) {\n timings.queryEmbedding = performance.now() - queryEmbedStart;\n }\n \n if (!queryEmbedding) {\n console.warn(\"Query embedding generation failed, returning empty results\");\n return [];\n }\n \n // Determine embedding dimension from query (or first page with embeddings)\n const embeddingDimension = queryEmbedding.length;\n if (embeddingDimension === 0) {\n return [];\n }\n \n // Create Orama database with vector field\n const dbCreateStart = performance.now();\n const db = await create({\n schema: {\n path: \"string\",\n url: \"string\",\n title: \"string\",\n content: \"string\",\n embedding: `vector[${embeddingDimension}]`,\n },\n });\n if (enableTiming) timings.dbCreate = performance.now() - dbCreateStart;\n \n // Prepare documents with embeddings for insertion\n const documents: Array<{\n path: string;\n url: string;\n title: string;\n content: string;\n embedding: number[];\n }> = [];\n \n // Collect pages with embeddings\n const docPrepStart = performance.now();\n for (const page of pages) {\n // Use cached embeddings if available, otherwise generate\n let pageEmbedding = page.embeddings;\n if (!pageEmbedding) {\n // Generate embedding if not cached (should be cached from recalculate, but handle missing)\n pageEmbedding = await generateEmbeddings(page.content);\n if (!pageEmbedding || pageEmbedding.length !== embeddingDimension) {\n continue; // Skip pages without embeddings or wrong dimension\n }\n }\n \n // Ensure embedding dimension matches\n if (pageEmbedding.length !== embeddingDimension) {\n continue;\n }\n \n documents.push({\n path: page.path,\n url: page.url,\n title: page.title || page.path,\n content: page.content,\n embedding: pageEmbedding,\n });\n }\n if (enableTiming) timings.docPrep = performance.now() - docPrepStart;\n \n // Insert all documents into Orama\n const insertStart = performance.now();\n if (documents.length > 0) {\n await insertMultiple(db, documents);\n } else {\n return []; // No documents to search\n }\n if (enableTiming) timings.insert = performance.now() - insertStart;\n \n // Perform vector similarity search using Orama\n const searchStart = performance.now();\n const searchResults = await search(db, {\n mode: \"vector\",\n vector: {\n value: queryEmbedding,\n property: \"embedding\",\n },\n similarity: minSimilarity,\n limit,\n includeVectors: false, // Don't need vectors in response\n });\n if (enableTiming) timings.search = performance.now() - searchStart;\n \n // Transform Orama results to SearchResult format\n const transformStart = performance.now();\n const results: SearchResult[] = searchResults.hits.map((hit: any) => {\n const page = pages.find(p => p.path === hit.document.path);\n const queryWords = query.toLowerCase().split(/\\s+/).filter(w => w.length > 0);\n \n return {\n path: hit.document.path,\n url: hit.document.url,\n title: hit.document.title,\n score: (hit.score || 0) * 100, // Convert similarity to score (0-100)\n snippet: page ? generateSnippet(page.content, queryWords, query.toLowerCase()) : hit.document.content.substring(0, 200) + '...',\n metadata: {\n strategy: \"openai-orama\",\n similarity: hit.score,\n ...(enableTiming && { timings }),\n },\n };\n });\n if (enableTiming) timings.transform = performance.now() - transformStart;\n \n if (enableTiming) {\n timings.total = performance.now() - startTime;\n console.log(` ⏱️ Timing breakdown:`);\n console.log(` Query embedding: ${timings.queryEmbedding?.toFixed(2)}ms (API call)`);\n console.log(` DB create: ${timings.dbCreate?.toFixed(2)}ms`);\n console.log(` Doc prep: ${timings.docPrep?.toFixed(2)}ms`);\n console.log(` Insert: ${timings.insert?.toFixed(2)}ms`);\n console.log(` Search: ${timings.search?.toFixed(2)}ms`);\n console.log(` Transform: ${timings.transform?.toFixed(2)}ms`);\n console.log(` Total: ${timings.total?.toFixed(2)}ms`);\n }\n \n return results;\n },\n};\n\n",[],[223,417],"31459b96-b901-11f0-9996-0224a6c84d84","openai-cosine.ts","31459c22-b901-11f0-9996-0224a6c84d84",30,["D",1762207522106],"// OpenAI + Cosine Similarity Strategy: Direct cosine similarity calculation\n// Fastest for small datasets (<100 pages) - no DB overhead\n\nimport type { SearchStrategy, SearchResult, Page, SearchOptions } from \"./types.ts\";\nimport { generateSnippet, cosineSimilarity } from \"./utils.ts\";\n\n// OpenAI embeddings function\nexport const generateEmbeddings = async (content: string): Promise => {\n const OPENAI_API_KEY = Deno.env.get(\"OPENAI_API_KEY\");\n const OPENAI_API_URL = \"https://api.openai.com/v1/embeddings\";\n \n if (!OPENAI_API_KEY) {\n console.warn(\"OPENAI_API_KEY not found - embeddings disabled\");\n return null;\n }\n \n try {\n const response = await fetch(OPENAI_API_URL, {\n method: \"POST\",\n headers: {\n \"Authorization\": `Bearer ${OPENAI_API_KEY}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n model: \"text-embedding-3-small\", // Fast and efficient model\n input: content,\n }),\n });\n \n if (!response.ok) {\n const errorText = await response.text().catch(() => response.statusText);\n throw new Error(`OpenAI API error: ${response.status} ${response.statusText} - ${errorText.substring(0, 200)}`);\n }\n \n const data = await response.json();\n \n if (data.data && Array.isArray(data.data) && data.data.length > 0) {\n return data.data[0].embedding; // Return the embedding vector\n }\n \n return null;\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n console.error(\"OpenAI embeddings failed:\", errorMessage);\n return null;\n }\n};\n\n// No caching for query embeddings - we want to benchmark actual API performance\n\n\nexport const searchStrategy: SearchStrategy = {\n name: \"openai-cosine\",\n description: \"Semantic search using OpenAI embeddings with direct cosine similarity (fastest for small datasets)\",\n search: async (query: string, pages: Page[], options: SearchOptions = {}): Promise => {\n const limit = options.limit || 10;\n const minSimilarity = (options.minScore || 0) / 100; // Convert to 0-1 scale\n const enableTiming = options.enableTiming || false;\n \n const timings: Record = {};\n const startTime = performance.now();\n \n // Generate query embedding (no caching - benchmarking actual API performance)\n const queryEmbedStart = performance.now();\n const queryEmbedding = await generateEmbeddings(query);\n if (enableTiming) {\n timings.queryEmbedding = performance.now() - queryEmbedStart;\n }\n \n if (!queryEmbedding) {\n console.warn(\"Query embedding generation failed, returning empty results\");\n return [];\n }\n \n // Calculate cosine similarity for each page\n const similarityStart = performance.now();\n const scoredPages: Array<{ page: Page; similarity: number }> = [];\n \n for (const page of pages) {\n const pageEmbedding = page.embeddings;\n if (!pageEmbedding || pageEmbedding.length !== queryEmbedding.length) {\n continue; // Skip pages without embeddings or wrong dimension\n }\n \n const similarity = cosineSimilarity(queryEmbedding, pageEmbedding);\n if (similarity >= minSimilarity) {\n scoredPages.push({ page, similarity });\n }\n }\n \n if (enableTiming) timings.similarity = performance.now() - similarityStart;\n \n // Sort by similarity (descending) and limit\n const sortStart = performance.now();\n scoredPages.sort((a, b) => b.similarity - a.similarity);\n const topPages = scoredPages.slice(0, limit);\n if (enableTiming) timings.sort = performance.now() - sortStart;\n \n // Transform to SearchResult format\n const transformStart = performance.now();\n const queryWords = query.toLowerCase().split(/\\s+/).filter(w => w.length > 0);\n const results: SearchResult[] = topPages.map(({ page, similarity }) => ({\n path: page.path,\n url: page.url,\n title: page.title || page.path,\n score: similarity * 100, // Convert to 0-100 scale\n snippet: generateSnippet(page.content, queryWords, query.toLowerCase()),\n metadata: {\n strategy: \"openai-cosine\",\n similarity,\n ...(enableTiming && { timings }),\n },\n }));\n if (enableTiming) timings.transform = performance.now() - transformStart;\n \n if (enableTiming) {\n timings.total = performance.now() - startTime;\n console.log(` ⏱️ Timing breakdown:`);\n console.log(` Query embedding: ${timings.queryEmbedding?.toFixed(2)}ms (API call)`);\n console.log(` Cosine similarity: ${timings.similarity?.toFixed(2)}ms`);\n console.log(` Sort: ${timings.sort?.toFixed(2)}ms`);\n console.log(` Transform: ${timings.transform?.toFixed(2)}ms`);\n console.log(` Total: ${timings.total?.toFixed(2)}ms`);\n }\n \n return results;\n },\n};\n\n",[],[223,425],"7f93bcdc-b9ca-11f0-8edf-0224a6c84d84","mixedbread-embeddings-cosine.ts","7f93bde0-b9ca-11f0-8edf-0224a6c84d84",63,["D",1762293982319],"// Mixedbread Embeddings + Cosine Similarity Strategy\n// Uses Mixedbread's Embeddings API for vector generation with local cosine similarity\n// Model: mxbai-embed-large-v1 (state-of-the-art English embeddings)\n\nimport type { SearchStrategy, SearchResult, Page, SearchOptions } from \"./types.ts\";\nimport { generateSnippet, cosineSimilarity } from \"./utils.ts\";\n\n// Lazy-loaded Mixedbread client\nlet mxbaiClient: any = null;\nlet clientLoading: Promise | null = null;\n\nasync function getMixedbreadClient() {\n // Return cached client if already loaded\n if (mxbaiClient) {\n return mxbaiClient;\n }\n \n // If loading in progress, wait for it\n if (clientLoading) {\n return clientLoading;\n }\n \n // Start loading client\n clientLoading = (async () => {\n try {\n // Import Mixedbread SDK\n const { Mixedbread } = await import(\"npm:@mixedbread/sdk@latest\");\n \n const MIXEDBREAD_API_KEY = Deno.env.get(\"MIXEDBREAD_API_KEY\") || Deno.env.get(\"MXBAI_API_KEY\");\n \n if (!MIXEDBREAD_API_KEY) {\n throw new Error(\"MIXEDBREAD_API_KEY or MXBAI_API_KEY not found - embeddings disabled\");\n }\n \n mxbaiClient = new Mixedbread({ apiKey: MIXEDBREAD_API_KEY });\n return mxbaiClient;\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n throw new Error(`Failed to load Mixedbread client: ${errorMessage}`);\n } finally {\n clientLoading = null;\n }\n })();\n \n return clientLoading;\n}\n\n// Generate embeddings using Mixedbread Embeddings API\nexport const generateEmbeddings = async (content: string): Promise => {\n try {\n const client = await getMixedbreadClient();\n \n // Generate embeddings using the SDK's embeddings.create() method\n const response = await client.embeddings.create({\n model: \"mixedbread-ai/mxbai-embed-large-v1\",\n input: content,\n normalized: true, // Normalize for cosine similarity\n encoding_format: \"float\", // Use float for compatibility\n truncation_strategy: \"end\", // Truncate long content at the end\n });\n \n // Extract the embedding vector from the response\n // Response format: { data: [{ embedding: [...] }] }\n if (response.data && Array.isArray(response.data) && response.data.length > 0) {\n const embedding = response.data[0].embedding;\n if (Array.isArray(embedding)) {\n return embedding;\n }\n }\n \n console.warn(\"Unexpected Mixedbread Embeddings API response format:\", JSON.stringify(response, null, 2));\n return null;\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n console.error(\"Mixedbread embeddings failed:\", errorMessage);\n if (error instanceof Error && error.stack) {\n console.error(\"Stack trace:\", error.stack);\n }\n return null;\n }\n};\n\nexport const searchStrategy: SearchStrategy = {\n name: \"mixedbread-embeddings-cosine\",\n description: \"Semantic search using Mixedbread Embeddings API (mxbai-embed-large-v1) with local cosine similarity\",\n search: async (query: string, pages: Page[], options: SearchOptions = {}): Promise => {\n const limit = options.limit || 10;\n const minSimilarity = (options.minScore || 0) / 100; // Convert to 0-1 scale\n const enableTiming = options.enableTiming || false;\n \n const timings: Record = {};\n const startTime = performance.now();\n \n // Generate query embedding (Mixedbread API call)\n const queryEmbedStart = performance.now();\n const queryEmbedding = await generateEmbeddings(query);\n if (enableTiming) {\n timings.queryEmbedding = performance.now() - queryEmbedStart;\n }\n \n if (!queryEmbedding) {\n console.warn(\"Query embedding generation failed, returning empty results\");\n return [];\n }\n \n // Calculate cosine similarity for each page\n const similarityStart = performance.now();\n const scoredPages: Array<{ page: Page; similarity: number }> = [];\n \n for (const page of pages) {\n const pageEmbedding = page.embeddings;\n if (!pageEmbedding || pageEmbedding.length !== queryEmbedding.length) {\n continue; // Skip pages without embeddings or wrong dimension\n }\n \n const similarity = cosineSimilarity(queryEmbedding, pageEmbedding);\n if (similarity >= minSimilarity) {\n scoredPages.push({ page, similarity });\n }\n }\n \n if (enableTiming) timings.similarity = performance.now() - similarityStart;\n \n // Sort by similarity (descending) and limit\n const sortStart = performance.now();\n scoredPages.sort((a, b) => b.similarity - a.similarity);\n const topPages = scoredPages.slice(0, limit);\n if (enableTiming) timings.sort = performance.now() - sortStart;\n \n // Transform to SearchResult format\n const transformStart = performance.now();\n const queryWords = query.toLowerCase().split(/\\s+/).filter(w => w.length > 0);\n const results: SearchResult[] = topPages.map(({ page, similarity }) => ({\n path: page.path,\n url: page.url,\n title: page.title || page.path,\n score: similarity * 100, // Convert to 0-100 scale\n snippet: generateSnippet(page.content, queryWords, query.toLowerCase()),\n metadata: {\n strategy: \"mixedbread-embeddings-cosine\",\n similarity,\n embeddingDimension: queryEmbedding.length,\n model: \"mxbai-embed-large-v1\",\n ...(enableTiming && { timings }),\n },\n }));\n if (enableTiming) timings.transform = performance.now() - transformStart;\n \n if (enableTiming) {\n timings.total = performance.now() - startTime;\n console.log(` ⏱️ Timing breakdown:`);\n console.log(` Query embedding: ${timings.queryEmbedding?.toFixed(2)}ms (Mixedbread API)`);\n console.log(` Cosine similarity: ${timings.similarity?.toFixed(2)}ms`);\n console.log(` Sort: ${timings.sort?.toFixed(2)}ms`);\n console.log(` Transform: ${timings.transform?.toFixed(2)}ms`);\n console.log(` Total: ${timings.total?.toFixed(2)}ms`);\n }\n \n return results;\n },\n};\n\n",[],[223,433],"315f55ae-b901-11f0-8f9e-0224a6c84d84","jigsawstack-orama.ts","315f56bc-b901-11f0-8f9e-0224a6c84d84",33,["D",1762207522117],"// JigsawStack + Orama Strategy: Semantic search using JigsawStack embeddings and Orama\n\nimport type { SearchStrategy, SearchResult, Page, SearchOptions } from \"./types.ts\";\nimport { generateSnippet } from \"./utils.ts\";\nimport { create, insertMultiple, search } from \"npm:@orama/orama@latest\";\n\n// JigsawStack embeddings function (v2 API)\nexport const generateEmbeddings = async (content: string): Promise => {\n const JIGSAWSTACK_API_KEY = Deno.env.get(\"JIGSAWSTACK_API_KEY\");\n const JIGSAWSTACK_API_URL = \"https://api.jigsawstack.com/v2/embedding\";\n \n if (!JIGSAWSTACK_API_KEY) {\n console.warn(\"JIGSAWSTACK_API_KEY not found - embeddings disabled\");\n return null;\n }\n \n try {\n const response = await fetch(JIGSAWSTACK_API_URL, {\n method: \"POST\",\n headers: {\n \"X-Api-Key\": JIGSAWSTACK_API_KEY,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n text: content,\n type: \"text\",\n }),\n });\n \n if (!response.ok) {\n const errorText = await response.text().catch(() => response.statusText);\n throw new Error(`JigsawStack API error: ${response.status} ${response.statusText} - ${errorText.substring(0, 200)}`);\n }\n \n const data = await response.json();\n \n // JigsawStack v2 returns: { success: true, embeddings: [[...]], chunks: [...], _usage: {...} }\n // embeddings is an array of arrays, we want the first embedding vector\n if (data.success && data.embeddings && Array.isArray(data.embeddings) && data.embeddings.length > 0) {\n return data.embeddings[0]; // Return the first embedding vector\n }\n \n return null;\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n console.error(\"JigsawStack embeddings failed:\", errorMessage);\n return null;\n }\n};\n\nexport const searchStrategy: SearchStrategy = {\n name: \"jigsawstack-orama\",\n description: \"Semantic search using JigsawStack embeddings with Orama vector search\",\n search: async (query: string, pages: Page[], options: SearchOptions = {}): Promise => {\n const limit = options.limit || 10;\n const minSimilarity = (options.minScore || 0) / 100; // Convert to 0-1 scale\n const enableTiming = options.enableTiming || false;\n \n const timings: Record = {};\n const startTime = performance.now();\n \n // Generate query embedding (this is the main bottleneck - external API call)\n const queryEmbedStart = performance.now();\n const queryEmbedding = await generateEmbeddings(query);\n if (enableTiming) timings.queryEmbedding = performance.now() - queryEmbedStart;\n \n if (!queryEmbedding) {\n console.warn(\"Query embedding generation failed, returning empty results\");\n return [];\n }\n \n // Determine embedding dimension from query (or first page with embeddings)\n const embeddingDimension = queryEmbedding.length;\n if (embeddingDimension === 0) {\n return [];\n }\n \n // Create Orama database with vector field\n const dbCreateStart = performance.now();\n const db = await create({\n schema: {\n path: \"string\",\n url: \"string\",\n title: \"string\",\n content: \"string\",\n embedding: `vector[${embeddingDimension}]`,\n },\n });\n if (enableTiming) timings.dbCreate = performance.now() - dbCreateStart;\n \n // Prepare documents with embeddings for insertion\n const documents: Array<{\n path: string;\n url: string;\n title: string;\n content: string;\n embedding: number[];\n }> = [];\n \n // Collect pages with embeddings\n const docPrepStart = performance.now();\n for (const page of pages) {\n // Use cached embeddings if available, otherwise generate\n let pageEmbedding = page.embeddings;\n if (!pageEmbedding) {\n // Generate embedding if not cached (should be cached from recalculate, but handle missing)\n pageEmbedding = await generateEmbeddings(page.content);\n if (!pageEmbedding || pageEmbedding.length !== embeddingDimension) {\n continue; // Skip pages without embeddings or wrong dimension\n }\n }\n \n // Ensure embedding dimension matches\n if (pageEmbedding.length !== embeddingDimension) {\n continue;\n }\n \n documents.push({\n path: page.path,\n url: page.url,\n title: page.title || page.path,\n content: page.content,\n embedding: pageEmbedding,\n });\n }\n if (enableTiming) timings.docPrep = performance.now() - docPrepStart;\n \n // Insert all documents into Orama\n const insertStart = performance.now();\n if (documents.length > 0) {\n await insertMultiple(db, documents);\n } else {\n return []; // No documents to search\n }\n if (enableTiming) timings.insert = performance.now() - insertStart;\n \n // Perform vector similarity search using Orama\n const searchStart = performance.now();\n const searchResults = await search(db, {\n mode: \"vector\",\n vector: {\n value: queryEmbedding,\n property: \"embedding\",\n },\n similarity: minSimilarity,\n limit,\n includeVectors: false, // Don't need vectors in response\n });\n if (enableTiming) timings.search = performance.now() - searchStart;\n \n // Transform Orama results to SearchResult format\n const transformStart = performance.now();\n const results: SearchResult[] = searchResults.hits.map((hit: any) => {\n const page = pages.find(p => p.path === hit.document.path);\n const queryWords = query.toLowerCase().split(/\\s+/).filter(w => w.length > 0);\n \n return {\n path: hit.document.path,\n url: hit.document.url,\n title: hit.document.title,\n score: (hit.score || 0) * 100, // Convert similarity to score (0-100)\n snippet: page ? generateSnippet(page.content, queryWords, query.toLowerCase()) : hit.document.content.substring(0, 200) + '...',\n metadata: {\n strategy: \"jigsawstack-orama\",\n similarity: hit.score,\n ...(enableTiming && { timings }),\n },\n };\n });\n if (enableTiming) timings.transform = performance.now() - transformStart;\n \n if (enableTiming) {\n timings.total = performance.now() - startTime;\n console.log(` ⏱️ Timing breakdown:`);\n console.log(` Query embedding: ${timings.queryEmbedding?.toFixed(2)}ms (API call - main bottleneck)`);\n console.log(` DB create: ${timings.dbCreate?.toFixed(2)}ms`);\n console.log(` Doc prep: ${timings.docPrep?.toFixed(2)}ms`);\n console.log(` Insert: ${timings.insert?.toFixed(2)}ms`);\n console.log(` Search: ${timings.search?.toFixed(2)}ms`);\n console.log(` Transform: ${timings.transform?.toFixed(2)}ms`);\n console.log(` Total: ${timings.total?.toFixed(2)}ms`);\n }\n \n return results;\n },\n};\n\n",[],[223,441],"31712298-b901-11f0-878c-0224a6c84d84","index.ts","3171232e-b901-11f0-878c-0224a6c84d84",35,["D",1762207522385],"// Search - Main entry point\n// To switch strategies, comment/uncomment the imports and function calls below\n\nexport * from \"./types.ts\";\nexport * from \"./utils.ts\";\n\nimport type { Page, SearchOptions, SearchResult } from \"./types.ts\";\n// import { searchStrategy, generateEmbeddings } from \"./placeholder.ts\";\n// import { searchStrategy, generateEmbeddings } from \"./jigsawstack-orama.ts\"; // ~550ms query embeddings (API)\n// import { searchStrategy, generateEmbeddings } from \"./openai-orama.ts\"; // ~100-200ms query embeddings (API), ~29ms DB overhead\n// import { searchStrategy, generateEmbeddings } from \"./transformers-cosine.ts\"; // ~10-30ms (browser only), requires --allow-ffi in Deno\nimport { searchStrategy, generateEmbeddings } from \"./openai-cosine.ts\"; // ~100-200ms query embeddings (API), <1ms cosine calc\n\n// Main search function - comment/uncomment imports above to switch strategies\nexport const searchPages = async (\n query: string,\n pages: Page[],\n options: SearchOptions = {}\n): Promise => {\n return searchStrategy.search(query, pages, options);\n};\n\n// Export search strategy for introspection (e.g., /search/test endpoint)\nexport { searchStrategy };\n\n// Embeddings function for recalculate - uses same import as search strategy\nexport const getActiveEmbeddingsFunction = (): ((content: string) => Promise) => {\n return generateEmbeddings;\n};\n\n\n",[],[223,449],"7f996d58-b9ca-11f0-83d0-0224a6c84d84","STRATEGY-COMPARISON.md","7f996e0c-b9ca-11f0-83d0-0224a6c84d84",64,["D",1762293982370],"# Search Strategy Comparison\n\nThis document helps you choose the best search strategy for your use case.\n\n## Quick Decision Tree\n\n```\n┌─ Need to run on Cloudflare Workers?\n│ └─ YES → Use cloudflare-bge-cosine.ts\n│\n├─ Need 100% offline, no network calls?\n│ └─ YES → Use transformers-local-onnx.ts (after downloading model)\n│\n├─ Want fastest setup with good performance?\n│ └─ YES → Use transformers-cosine.ts (auto-downloads on first run)\n│\n├─ Need the best accuracy?\n│ └─ YES → Use mixedbread-embeddings-cosine.ts or openai-cosine.ts\n│\n└─ Want managed search (no embeddings management)?\n └─ YES → Use jigsawstack-orama.ts or mixedbread.ts\n```\n\n## Detailed Comparison\n\n### Performance Metrics\n\n| Strategy | First Load | Cached Load | Query Time | Total (cached) | Network Required |\n|----------|-----------|-------------|------------|----------------|------------------|\n| **transformers-local-onnx** | ~150ms | ~50ms | ~10-30ms | **~60-80ms** | ❌ No |\n| **transformers-cosine** | ~3-5s | ~150ms | ~10-30ms | ~160-180ms | ✅ First run only |\n| **mixedbread-embeddings** | N/A | N/A | ~50-100ms | ~50-100ms | ✅ Every query |\n| **openai-cosine** | N/A | N/A | ~100-200ms | ~100-200ms | ✅ Every query |\n| **hf-inference-qwen3** | N/A | N/A | ~150-300ms | ~150-300ms | ✅ Every query |\n| **cloudflare-bge** | N/A | N/A | ~50-150ms | ~50-150ms | ✅ Every query |\n| **jigsawstack-orama** | N/A | N/A | ~550ms | ~550ms | ✅ Every query |\n\n### Cost Comparison\n\n| Strategy | Cost | Free Tier | Notes |\n|----------|------|-----------|-------|\n| **transformers-local-onnx** | $0 | ∞ | 100% free, runs locally |\n| **transformers-cosine** | $0 | ∞ | 100% free, runs locally |\n| **mixedbread-embeddings** | $0-$ | Generous | Free tier: 150 req/min, 100M tokens/mo |\n| **openai-cosine** | $$ | Limited | $0.0001/1K tokens (text-embedding-3-small) |\n| **hf-inference-qwen3** | $0 | Generous | Free tier: 1000 req/day |\n| **cloudflare-bge** | $0 | Generous | Free tier: 10,000 req/day |\n| **jigsawstack-orama** | $0-$ | Limited | Free tier: limited requests |\n\n### Accuracy Comparison\n\nBased on MTEB (Massive Text Embedding Benchmark) scores:\n\n| Strategy | Model | Dimensions | MTEB Score | Notes |\n|----------|-------|------------|------------|-------|\n| **transformers-local-onnx** | all-MiniLM-L6-v2 | 384 | ~58 | Fast, good quality |\n| **transformers-cosine** | all-MiniLM-L6-v2 | 384 | ~58 | Same as local |\n| **mixedbread-embeddings** | mxbai-embed-large-v1 | 1024 | ~64 | Higher quality |\n| **openai-cosine** | text-embedding-3-small | 1536 | ~62 | Reliable, tested |\n| **hf-inference-qwen3** | Qwen3-Embedding-8B | 768 | ~65 | Very high quality |\n| **cloudflare-bge** | bge-large-en-v1.5 | 1024 | ~64 | Good quality |\n\n## Use Case Recommendations\n\n### 🏆 Production Deployment (Recommended)\n\n**Use**: `transformers-local-onnx.ts`\n\n**Why**:\n- Predictable performance (no network variance)\n- No API costs\n- No rate limits\n- Works offline\n- Fast after initial load\n\n**Best for**:\n- Deno Deploy\n- Render / Railway / Fly.io\n- Docker containers\n- Any environment with file system access\n\n### 🚀 Quick Start / Prototyping\n\n**Use**: `transformers-cosine.ts`\n\n**Why**:\n- Zero setup (auto-downloads model)\n- No API keys needed\n- Good performance after first run\n- Easy to switch to local later\n\n**Best for**:\n- Development\n- Testing\n- Quick demos\n- When you don't want to download models manually\n\n### ☁️ Cloudflare Workers\n\n**Use**: `cloudflare-bge-cosine.ts`\n\n**Why**:\n- Workers have 1MB code size limit (can't fit local models)\n- Cloudflare AI is optimized for Workers\n- Free tier is generous\n- Low latency\n\n**Best for**:\n- Cloudflare Workers/Pages\n- Edge deployment\n- Global low-latency requirements\n\n### 🎯 Maximum Accuracy\n\n**Use**: `hf-inference-qwen3-cosine.ts` or `mixedbread-embeddings-cosine.ts`\n\n**Why**:\n- Higher MTEB scores\n- Better semantic understanding\n- More dimensions (768-1024 vs 384)\n\n**Best for**:\n- When accuracy matters more than speed\n- Complex semantic queries\n- Production with budget for API calls\n\n### 📦 Managed Solution\n\n**Use**: `mixedbread.ts` or `jigsawstack-orama.ts`\n\n**Why**:\n- No embedding management needed\n- Handles storage, search, and embeddings\n- Less code to maintain\n\n**Best for**:\n- When you want a managed solution\n- Don't want to store embeddings yourself\n- Prefer APIs over local computation\n\n## Migration Path\n\n### From API-based to Local\n\n1. Download the model:\n ```bash\n cd search/models\n ./download-model.sh\n ```\n\n2. Update `search/index.ts`:\n ```typescript\n // Before\n // import { searchStrategy, generateEmbeddings } from \"./openai-cosine.ts\";\n \n // After\n import { searchStrategy, generateEmbeddings } from \"./transformers-local-onnx.ts\";\n ```\n\n3. Recalculate embeddings (if dimensions differ):\n ```bash\n GET /cache/recalculate?force=true\n ```\n\n### From transformers-cosine to transformers-local-onnx\n\n1. Download the model (same as above)\n2. Update the import\n3. No recalculation needed (same model, same dimensions)\n\n## Environment-Specific Notes\n\n### Val.town\n- **Recommended**: `transformers-cosine.ts` (isolate has caching)\n- **Alternative**: Any API-based strategy\n- **Avoid**: `transformers-local-onnx.ts` (no persistent file system)\n\n### Deno Deploy\n- **Recommended**: `transformers-local-onnx.ts` (with deployment package)\n- **Alternative**: `transformers-cosine.ts` or API-based\n- **Note**: Include model files in deployment\n\n### Docker\n- **Recommended**: `transformers-local-onnx.ts`\n- **Note**: Include model files in image\n- **Example**:\n ```dockerfile\n COPY search/models/all-MiniLM-L6-v2 /app/search/models/all-MiniLM-L6-v2\n ```\n\n### Serverless (AWS Lambda, Google Cloud Functions)\n- **Recommended**: API-based strategies (less cold start time)\n- **Alternative**: `transformers-local-onnx.ts` (if you can handle cold starts)\n- **Note**: Local models increase deployment package size\n\n### Local Development\n- **Recommended**: `transformers-cosine.ts` (auto-download)\n- **Alternative**: `transformers-local-onnx.ts` (if downloaded)\n- **Note**: Both work great for development\n\n## Benchmarking Your Setup\n\nRun the test harness to compare strategies on your infrastructure:\n\n```bash\ncd testing\ndeno run --allow-read --allow-env --allow-net test-search.ts\n```\n\nThis will show actual performance numbers for your specific setup.\n\n## Summary Table\n\n| Criteria | Best Choice |\n|----------|-------------|\n| **Fastest** | transformers-local-onnx |\n| **Easiest Setup** | transformers-cosine |\n| **Most Accurate** | hf-inference-qwen3 |\n| **Cheapest** | transformers-local-onnx (free) |\n| **Best for Production** | transformers-local-onnx |\n| **Best for Cloudflare** | cloudflare-bge-cosine |\n| **Best for Val.town** | transformers-cosine |\n| **Most Reliable** | openai-cosine |\n| **Fully Managed** | mixedbread or jigsawstack |\n\n## Still Unsure?\n\nDefault recommendation: **transformers-local-onnx.ts**\n\nIt offers the best combination of speed, cost (free), and reliability for most production use cases. The only downside is the initial setup (downloading model files), which takes a few minutes.\n\nIf you can't download models or need to deploy immediately, use **transformers-cosine.ts** as it auto-downloads on first run.\n\n",[],[223,457],"7fbe24b8-b9ca-11f0-83d0-0224a6c84d84","test-server-mode.ts","7fbe2580-b9ca-11f0-83d0-0224a6c84d84","7eec2a9e-b9ca-11f0-8b68-0224a6c84d84",68,["D",1762293982610],"// Test that verifies the ONNX crash doesn't happen in server mode (long-running process)\n// Run with: deno run --allow-read --allow-env --allow-net --allow-ffi test-server-mode.ts\n\nimport { searchStrategy, generateEmbeddings } from \"../transformers-local-onnx.ts\";\n\nconsole.log(\"🧪 Testing ONNX in Server Mode (long-running process)\\n\");\n\n// Simulate a server that stays running\nconsole.log(\"Starting simulated server...\");\n\nlet requestCount = 0;\n\n// Simulate incoming requests every second\nconst interval = setInterval(async () => {\n requestCount++;\n console.log(`\\n📨 Request #${requestCount}`);\n \n const query = requestCount % 2 === 0 ? \"How to use Groq API?\" : \"What are the pricing options?\";\n console.log(` Query: \"${query}\"`);\n \n const start = performance.now();\n const embedding = await generateEmbeddings(query);\n const elapsed = performance.now() - start;\n \n if (embedding) {\n console.log(` ✅ Generated embedding (${embedding.length} dims) in ${elapsed.toFixed(2)}ms`);\n } else {\n console.log(` ❌ Failed to generate embedding`);\n }\n \n // Stop after 5 requests\n if (requestCount >= 5) {\n console.log(\"\\n✅ Completed 5 requests successfully!\");\n console.log(\" No crashes! Server mode works perfectly.\");\n console.log(\"\\n💡 The mutex crash only affects standalone scripts that exit immediately.\");\n console.log(\" Your main.tsx server will run without any issues.\");\n clearInterval(interval);\n \n // Exit gracefully\n console.log(\"\\nStopping server...\");\n setTimeout(() => {\n console.log(\"Server stopped cleanly!\");\n Deno.exit(0);\n }, 100);\n }\n}, 1000);\n\nconsole.log(\"Server running... (will process 5 requests then stop)\\n\");\n\n",[],[223,473,465],"models","7fb0abf8-b9ca-11f0-a8b3-0224a6c84d84","test-local-model.ts","7fb0acc0-b9ca-11f0-a8b3-0224a6c84d84",67,["D",1762293982506],"// Test script for local ONNX model\n// Run with: deno run --allow-read --allow-env --allow-net test-local-model.ts\n\nimport { searchStrategy, generateEmbeddings } from \"../transformers-local-onnx.ts\";\n\nconsole.log(\"🧪 Testing Local ONNX Model Strategy\\n\");\n\n// Test 1: Generate embeddings for a simple query\nconsole.log(\"Test 1: Generate embeddings for a query\");\nconsole.log(\"Query: 'What is Groq?'\\n\");\n\nconst start = performance.now();\nconst embeddings = await generateEmbeddings(\"What is Groq?\");\nconst elapsed = performance.now() - start;\n\nif (embeddings) {\n console.log(`✅ Generated embeddings successfully!`);\n console.log(` Dimensions: ${embeddings.length}`);\n console.log(` First 5 values: [${embeddings.slice(0, 5).map(v => v.toFixed(4)).join(\", \")}...]`);\n console.log(` Time: ${elapsed.toFixed(2)}ms`);\n} else {\n console.log(`❌ Failed to generate embeddings`);\n}\n\nconsole.log(\"\\n\" + \"=\".repeat(60) + \"\\n\");\n\n// Test 2: Generate embeddings for multiple queries (to test caching)\nconsole.log(\"Test 2: Generate embeddings for multiple queries (testing cache)\");\n\nconst queries = [\n \"How to use Groq API?\",\n \"What models are available?\",\n \"Pricing information\"\n];\n\nfor (const query of queries) {\n const queryStart = performance.now();\n const queryEmbedding = await generateEmbeddings(query);\n const queryElapsed = performance.now() - queryStart;\n \n if (queryEmbedding) {\n console.log(`✅ \"${query}\"`);\n console.log(` Time: ${queryElapsed.toFixed(2)}ms (cached pipeline)`);\n } else {\n console.log(`❌ \"${query}\" - Failed`);\n }\n}\n\nconsole.log(\"\\n\" + \"=\".repeat(60) + \"\\n\");\n\n// Test 3: Test search strategy with mock data\nconsole.log(\"Test 3: Test search strategy with mock data\");\n\nconst mockPages = [\n {\n path: \"/docs/introduction\",\n url: \"https://console.groq.com/docs/introduction\",\n title: \"Introduction to Groq\",\n content: \"Groq is a fast AI inference platform that provides APIs for various language models.\",\n embeddings: await generateEmbeddings(\"Groq is a fast AI inference platform that provides APIs for various language models.\"),\n },\n {\n path: \"/docs/api-keys\",\n url: \"https://console.groq.com/docs/api-keys\",\n title: \"API Keys\",\n content: \"Learn how to create and manage your Groq API keys for authentication.\",\n embeddings: await generateEmbeddings(\"Learn how to create and manage your Groq API keys for authentication.\"),\n },\n {\n path: \"/docs/models\",\n url: \"https://console.groq.com/docs/models\",\n title: \"Available Models\",\n content: \"Groq supports various language models including Llama, Mixtral, and Gemma.\",\n embeddings: await generateEmbeddings(\"Groq supports various language models including Llama, Mixtral, and Gemma.\"),\n },\n];\n\nconst searchQuery = \"How do I get API keys?\";\nconsole.log(`Query: \"${searchQuery}\"\\n`);\n\nconst searchStart = performance.now();\nconst results = await searchStrategy.search(searchQuery, mockPages, {\n limit: 3,\n enableTiming: true,\n});\nconst searchElapsed = performance.now() - searchStart;\n\nconsole.log(`\\nSearch Results (${results.length}):`);\nresults.forEach((result, idx) => {\n console.log(`\\n${idx + 1}. ${result.title}`);\n console.log(` Path: ${result.path}`);\n console.log(` Score: ${result.score.toFixed(2)}`);\n console.log(` Snippet: ${result.snippet}`);\n});\n\nconsole.log(`\\n⏱️ Total search time: ${searchElapsed.toFixed(2)}ms`);\n\nconsole.log(\"\\n\" + \"=\".repeat(60) + \"\\n\");\n\nconsole.log(\"✅ All tests completed!\");\nconsole.log(\"\\n💡 Tips:\");\nconsole.log(\" - First run downloads the model (~90MB)\");\nconsole.log(\" - Subsequent runs use cached model (~50-150ms load)\");\nconsole.log(\" - Local ONNX = No network calls, completely offline\");\nconsole.log(\" - Perfect for serverless deployments (Deno Deploy, Render, Railway)\");\n\n// Note: You may see a \"mutex lock failed\" error on exit\n// This is a known issue with ONNX runtime cleanup in Deno when scripts exit immediately\n// The error is harmless and only affects standalone scripts - long-running servers (like your main app) won't have this issue\n// All functionality works correctly despite the error message\n\n",[],[223,473,475],"7fc2b366-b9ca-11f0-8b68-0224a6c84d84","download-model.sh","7fc2b3fc-b9ca-11f0-8b68-0224a6c84d84",69,["D",1762293982640],"#!/bin/bash\n# Download all-MiniLM-L6-v2 ONNX model from Hugging Face\n\nset -e # Exit on error\n\nMODEL_NAME=\"all-MiniLM-L6-v2\"\nHF_REPO=\"Xenova/all-MiniLM-L6-v2\"\n\necho \"📦 Downloading ${MODEL_NAME} from Hugging Face...\"\necho \" Repository: https://huggingface.co/${HF_REPO}\"\necho \"\"\n\n# Check if git-lfs is installed\nif ! command -v git-lfs &> /dev/null; then\n echo \"⚠️ Warning: git-lfs is not installed. Large files may not download correctly.\"\n echo \" Install git-lfs first: https://git-lfs.github.com/\"\n echo \"\"\n read -p \"Continue anyway? (y/N) \" -n 1 -r\n echo\n if [[ ! $REPLY =~ ^[Yy]$ ]]; then\n exit 1\n fi\nfi\n\n# Clone the repository\necho \"🔽 Cloning repository (this may take a few minutes)...\"\ngit clone https://huggingface.co/${HF_REPO} ${MODEL_NAME}\n\n# Clean up .git directory to save space\necho \"🧹 Cleaning up .git directory...\"\nrm -rf ${MODEL_NAME}/.git\n\n# Display downloaded files\necho \"\"\necho \"✅ Model downloaded successfully!\"\necho \"\"\necho \"📂 Files in ${MODEL_NAME}:\"\nls -lh ${MODEL_NAME}\necho \"\"\necho \"📊 Total size:\"\ndu -sh ${MODEL_NAME}\necho \"\"\n\n# Check for required files\necho \"🔍 Verifying required files...\"\nREQUIRED_FILES=(\n \"${MODEL_NAME}/onnx/model.onnx\"\n \"${MODEL_NAME}/tokenizer.json\"\n \"${MODEL_NAME}/tokenizer_config.json\"\n \"${MODEL_NAME}/config.json\"\n)\n\nALL_FOUND=true\nfor file in \"${REQUIRED_FILES[@]}\"; do\n if [ -f \"$file\" ]; then\n echo \" ✅ Found: $file\"\n else\n echo \" ❌ Missing: $file\"\n ALL_FOUND=false\n fi\ndone\n\necho \"\"\nif [ \"$ALL_FOUND\" = true ]; then\n echo \"🎉 All required files are present!\"\n echo \"\"\n echo \"Next steps:\"\n echo \"1. Update search/index.ts to use the local ONNX strategy:\"\n echo \" import { searchStrategy, generateEmbeddings } from \\\"./transformers-local-onnx.ts\\\";\"\n echo \"\"\n echo \"2. Run your application - the model will load from local files!\"\nelse\n echo \"⚠️ Some required files are missing. The model may not work correctly.\"\n echo \" Try running this script again or download manually from:\"\n echo \" https://huggingface.co/${HF_REPO}/tree/main\"\nfi\n\n",[],[223,473,483],"7fab0310-b9ca-11f0-8b68-0224a6c84d84","SETUP.md","7fab03b0-b9ca-11f0-8b68-0224a6c84d84",66,["D",1762293982468],"# Local ONNX Model Setup Guide\n\nThis guide will help you set up pre-downloaded ONNX models for the fastest embedding generation with zero network overhead.\n\n## Quick Start\n\n```bash\n# Navigate to the models directory\ncd search/models\n\n# Run the download script\n./download-model.sh\n\n# Wait for download to complete (may take a few minutes depending on connection)\n# The model is ~90MB total\n```\n\n## Manual Download (Alternative)\n\nIf the script doesn't work, you can download manually:\n\n```bash\ncd search/models\n\n# Clone the Hugging Face repository\ngit clone https://huggingface.co/Xenova/all-MiniLM-L6-v2\n\n# Remove .git directory to save space\nrm -rf all-MiniLM-L6-v2/.git\n```\n\nOr download individual files from: https://huggingface.co/Xenova/all-MiniLM-L6-v2/tree/main\n\nRequired files:\n- `onnx/model.onnx` (~23MB) - Main ONNX model\n- `onnx/model_quantized.onnx` (~6MB) - Quantized version (optional, faster)\n- `tokenizer.json` - Tokenizer vocabulary\n- `tokenizer_config.json` - Tokenizer configuration\n- `config.json` - Model configuration\n\n## Verify Installation\n\nCheck that the model files exist:\n\n```bash\nls -lh all-MiniLM-L6-v2/\nls -lh all-MiniLM-L6-v2/onnx/\n```\n\nYou should see:\n```\nall-MiniLM-L6-v2/\n├── onnx/\n│ ├── model.onnx (~23MB)\n│ └── model_quantized.onnx (~6MB)\n├── config.json\n├── tokenizer.json\n├── tokenizer_config.json\n└── ...\n```\n\n## Switch to Local Model Strategy\n\nIn `search/index.ts`, make sure this line is active:\n\n```typescript\nimport { searchStrategy, generateEmbeddings } from \"./transformers-local-onnx.ts\";\n```\n\nComment out other strategies:\n\n```typescript\n// import { searchStrategy, generateEmbeddings } from \"./transformers-cosine.ts\";\n```\n\n## Configuration Options\n\nEdit `search/transformers-local-onnx.ts` to customize:\n\n```typescript\n// Use quantized model (faster, slightly less accurate)\nconst USE_QUANTIZED = true; // Default: false\n\n// Model path (change if you want to use a different model)\nconst MODEL_PATH = new URL(\"./models/all-MiniLM-L6-v2\", import.meta.url).pathname;\n```\n\n## Performance Comparison\n\n| Strategy | First Run | Cached | Network | Model Size |\n|----------|-----------|--------|---------|------------|\n| `transformers-cosine.ts` | ~3-5s | ~150ms | Required (downloads from HF) | ~23MB cached |\n| `transformers-local-onnx.ts` | ~150ms | ~50ms | **None** | ~23MB local |\n\nThe local ONNX version:\n- ✅ No network calls - works completely offline\n- ✅ No downloads on first run - instant startup\n- ✅ No isolate loading delays\n- ✅ Same accuracy as the cached version\n- ✅ Perfect for serverless/edge deployments\n\n## Deployment Notes\n\n### For Val.town\n- Upload the model files to Val.town's blob storage or use a CDN\n- Update `MODEL_PATH` to point to the remote location\n- Or use the regular `transformers-cosine.ts` which downloads to isolate cache\n\n### For Deno Deploy\n- Include the models in your deployment package\n- Models will be read from the file system\n- Works perfectly with the local strategy\n\n### For Cloudflare Workers\n- Workers have a 1MB size limit, so the local strategy won't work\n- Use `cloudflare-bge-cosine.ts` instead (uses Cloudflare AI)\n\n### For Render / Railway / Fly.io\n- Include the models directory in your Docker image\n- Works perfectly with local file system access\n- Fastest option for these platforms\n\n## Troubleshooting\n\n### Error: \"Failed to load local ONNX model\"\n- Ensure model files are downloaded: `ls -lh search/models/all-MiniLM-L6-v2/`\n- Run the download script: `./search/models/download-model.sh`\n- Check file permissions: `chmod -R 755 search/models/all-MiniLM-L6-v2/`\n\n### Error: \"Cannot find module\"\n- Make sure you're using the correct import in `search/index.ts`\n- Check that the file path is correct\n\n### Slow performance\n- Try the quantized model: set `USE_QUANTIZED = true` in `transformers-local-onnx.ts`\n- Check if model files are on a fast disk (SSD recommended)\n\n### Out of memory\n- The model requires ~100-200MB RAM when loaded\n- Use the quantized version to reduce memory usage\n\n## Alternative: Use Different Models\n\nYou can use other ONNX models from Hugging Face. Popular options:\n\n- **all-MiniLM-L6-v2** (default) - 384 dims, 23MB, fast\n- **all-mpnet-base-v2** - 768 dims, 420MB, more accurate\n- **paraphrase-multilingual-MiniLM-L12-v2** - 384 dims, 470MB, multilingual\n\nTo use a different model:\n1. Download it to `search/models/[model-name]`\n2. Update `MODEL_PATH` in `transformers-local-onnx.ts`\n3. Update embedding dimension in your data pipeline if needed\n\n## Clean Up\n\nTo remove the model and reclaim disk space:\n\n```bash\ncd search/models\nrm -rf all-MiniLM-L6-v2\n```\n\nThen switch back to a different strategy in `search/index.ts`.\n\n",[],[223,473,491],"7fdcccf6-b9ca-11f0-9362-0224a6c84d84","7fdccdbe-b9ca-11f0-9362-0224a6c84d84",72,["D",1762293982616],"# Local ONNX Models\n\nThis directory contains pre-downloaded ONNX models for local embedding generation.\n\n## Setup Instructions\n\n### 1. Download the all-MiniLM-L6-v2 Model\n\nDownload the ONNX model files from Hugging Face:\n\n```bash\n# Create the model directory\nmkdir -p all-MiniLM-L6-v2\n\n# Download the ONNX model files\n# You can download these manually from: https://huggingface.co/Xenova/all-MiniLM-L6-v2/tree/main/onnx\n# Required files:\n# - model.onnx\n# - tokenizer.json\n# - tokenizer_config.json\n# - config.json\n# - special_tokens_map.json (optional)\n```\n\nOr use this script to download automatically:\n\n```bash\ncd models\ngit clone https://huggingface.co/Xenova/all-MiniLM-L6-v2\n# Clean up .git directory to save space\nrm -rf all-MiniLM-L6-v2/.git\n```\n\n### 2. Verify the Files\n\nYour directory structure should look like:\n\n```\nmodels/\n all-MiniLM-L6-v2/\n onnx/\n model.onnx # ~23MB - the main ONNX model\n model_quantized.onnx # ~6MB - quantized version (optional, faster)\n tokenizer.json # Tokenizer configuration\n tokenizer_config.json # Additional tokenizer settings\n config.json # Model configuration\n```\n\n### 3. Switch to Local Model Strategy\n\nIn `search/index.ts`, uncomment the local model strategy:\n\n```typescript\nimport { searchStrategy, generateEmbeddings } from \"./transformers-local-onnx.ts\";\n```\n\n## Model Details\n\n- **Model**: all-MiniLM-L6-v2 (Sentence Transformers)\n- **Dimensions**: 384\n- **Size**: ~23MB (full) or ~6MB (quantized)\n- **Speed**: ~10-30ms per embedding (after initial load)\n- **Advantage**: No network calls, works offline, completely local\n\n## Notes\n\n- The model files are binary and should be kept in this directory\n- The quantized model (`model_quantized.onnx`) is smaller and faster but slightly less accurate\n- This strategy requires the model files to be present before running\n- For deployment, ensure these files are included in your build/deployment package\n\n### About the \"mutex lock failed\" Error\n\nYou may see this error when running test scripts:\n```\nlibc++abi: terminating due to uncaught exception of type std::__1::system_error: mutex lock failed: Invalid argument\n```\n\n**This is harmless and expected!** Here's why:\n- The error happens in ONNX runtime's C++ cleanup code when the process exits\n- It occurs **after** all work is completed successfully\n- It **does not** affect functionality, data, or results\n- It only appears when scripts exit immediately\n- Long-running servers (like your main app) typically don't exit, so you won't see this in production\n\n**What to do**: Just ignore the error message. All tests pass successfully before it appears.\n\n",[],[223,473,189],"7fc802e4-b9ca-11f0-a8b3-0224a6c84d84",".gitignore","7fc80370-b9ca-11f0-a8b3-0224a6c84d84",70,["D",1762293982674],"# Ignore all downloaded model files (they're large!)\nall-MiniLM-L6-v2/\n\n# But keep the README and download script\n!README.md\n!download-model.sh\n!.gitignore\n\n",[],[223,473,506],"7fd41336-b9ca-11f0-8b68-0224a6c84d84","tokenizer_config.json","7fd413ea-b9ca-11f0-8b68-0224a6c84d84","7f049ff2-b9ca-11f0-98dd-0224a6c84d84",71,["D",1762293982754],"{\n \"clean_up_tokenization_spaces\": true,\n \"cls_token\": \"[CLS]\",\n \"do_basic_tokenize\": true,\n \"do_lower_case\": true,\n \"mask_token\": \"[MASK]\",\n \"model_max_length\": 512,\n \"never_split\": null,\n \"pad_token\": \"[PAD]\",\n \"sep_token\": \"[SEP]\",\n \"strip_accents\": null,\n \"tokenize_chinese_chars\": true,\n \"tokenizer_class\": \"BertTokenizer\",\n \"unk_token\": \"[UNK]\"\n}\n",[],[223,473,522,514],"all-MiniLM-L6-v2","7ff2d50a-b9ca-11f0-83d0-0224a6c84d84","special_tokens_map.json","7ff2d5a0-b9ca-11f0-83d0-0224a6c84d84",75,["D",1762293982796],"{\n \"cls_token\": \"[CLS]\",\n \"mask_token\": \"[MASK]\",\n \"pad_token\": \"[PAD]\",\n \"sep_token\": \"[SEP]\",\n \"unk_token\": \"[UNK]\"\n}\n",[],[223,473,522,524],"7fed5bac-b9ca-11f0-b636-0224a6c84d84","model_q4f16.onnx","7fed5c9c-b9ca-11f0-b636-0224a6c84d84","7f271ab4-b9ca-11f0-8b68-0224a6c84d84",74,["D",1762293982920],"version https://git-lfs.github.com/spec/v1\noid sha256:eb08a666c46109637e0b6cb04f6052a68efd59bb0252d4e0438d28fb6b2d853d\nsize 30018257\n",[],[223,473,522,540,532],"onnx","7fe5757c-b9ca-11f0-b636-0224a6c84d84","model_q4.onnx","7fe5766c-b9ca-11f0-b636-0224a6c84d84",73,["D",1762293982831],"version https://git-lfs.github.com/spec/v1\noid sha256:ac0f989345605769651a18bb796fda6235d921a37bd4ac065cb51781da44d079\nsize 54578772\n",[],[223,473,522,540,542],"7ff7bc28-b9ca-11f0-b636-0224a6c84d84",["D",1762293982987],[],[223,473,522,540,32],"7f271a00-b9ca-11f0-8b68-0224a6c84d84",52,["D",1762293981620],[265,266,267],[223,473,522,540],"7f049f52-b9ca-11f0-98dd-0224a6c84d84",51,["D",1762293981385],[264,268,269],[223,473,522],"7eec29cc-b9ca-11f0-8b68-0224a6c84d84",50,["D",1762293981234],[263,270,271,272,273,274,275],[223,473],["D",1762207521254],[262,276,277,278,279,280,281,282,283,284,285,286],[223],["D",1762207521817],[],[229],"7f537686-b9ca-11f0-8b68-0224a6c84d84","7f537758-b9ca-11f0-8b68-0224a6c84d84",55,["D",1762293981908],"// Answer strategy utilities\n\nimport type { Page } from \"../search/types.ts\";\n\n// Calculate approximate token count (rough estimate: 1 token ≈ 4 characters)\nexport const estimateTokens = (text: string): number => {\n return Math.ceil(text.length / 4);\n};\n\n// Truncate content to fit within token limit\nexport const truncateToTokenLimit = (content: string, maxTokens: number): string => {\n const maxChars = maxTokens * 4;\n if (content.length <= maxChars) {\n return content;\n }\n return content.substring(0, maxChars) + \"\\n...(truncated)\";\n};\n\n// Format pages into context for LLM\nexport const formatPagesAsContext = (\n pages: Page[],\n maxPages?: number,\n maxTokensPerPage?: number\n): { context: string; pagesUsed: number; totalTokens: number } => {\n const pagesToUse = maxPages ? pages.slice(0, maxPages) : pages;\n \n let context = \"\";\n let totalTokens = 0;\n \n for (const page of pagesToUse) {\n let pageContent = page.content;\n \n // Truncate individual page content if needed\n if (maxTokensPerPage) {\n pageContent = truncateToTokenLimit(pageContent, maxTokensPerPage);\n }\n \n const pageTokens = estimateTokens(pageContent);\n totalTokens += pageTokens;\n \n context += `\\n\\n---\\n`;\n context += `Source: ${page.title || page.path}\\n`;\n context += `URL: ${page.url}\\n`;\n context += `---\\n\\n`;\n context += pageContent;\n }\n \n return {\n context,\n pagesUsed: pagesToUse.length,\n totalTokens,\n };\n};\n\n// Default system prompt for documentation Q&A\nexport const DEFAULT_SYSTEM_PROMPT = `You are a helpful AI assistant that answers questions about Groq's documentation.\n\nYou will be provided with relevant documentation pages as context. Use this context to provide accurate, helpful answers to user questions.\n\nGuidelines:\n- Base your answers on the provided documentation context\n- If the answer isn't in the context, say so politely\n- Be concise but thorough\n- Include relevant code examples when available in the context\n- Reference specific documentation sections when helpful\n- Format your response in markdown\n- If multiple approaches are mentioned in the docs, present them clearly\n- When linking to documentation, remove the .md extension from URLs (e.g., use /docs/api-reference instead of /docs/api-reference.md)\n- Use the exact URLs provided in the context, but without .md extensions\n\nRemember: You are answering questions specifically about Groq's API, models, and services based on their official documentation.`;\n\n// Post-process answer to clean up any .md extensions in URLs\nexport const cleanupMarkdownLinks = (answer: string): string => {\n // Remove .md from markdown links: [text](url.md) -> [text](url)\n // Handles various cases:\n // - [text](url.md) -> [text](url)\n // - [text](url.md#anchor) -> [text](url#anchor)\n // - [text](url.md?query) -> [text](url?query)\n return answer.replace(/(\\[[^\\]]+\\]\$[^)]+)\\.md(\$|#|\\?)/g, '$1$2');\n};\n\n",[],[235,139],"7f600aae-b9ca-11f0-8b68-0224a6c84d84","7f600b58-b9ca-11f0-8b68-0224a6c84d84",57,["D",1762293981956],"// Answer strategy types and interfaces\n\nexport type AnswerResult = {\n answer: string;\n query: string;\n searchResults: Array<{\n path: string;\n url: string;\n title?: string;\n score: number;\n }>;\n contextUsed: number; // Number of pages used in context\n totalTokens?: number;\n metadata?: {\n strategy?: string;\n model?: string;\n timings?: Record;\n [key: string]: any;\n };\n};\n\nexport type AnswerOptions = {\n limit?: number; // Max number of search results to use\n minScore?: number; // Minimum search score threshold\n maxContextPages?: number; // Max pages to include in context\n temperature?: number; // LLM temperature\n model?: string; // Override the default model\n systemPrompt?: string; // Override the default system prompt\n enableTiming?: boolean; // Enable timing tracking\n trackTime?: (label: string) => void; // Callback for tracking time points\n [key: string]: any;\n};\n\nexport type AnswerStrategy = {\n name: string;\n description: string;\n answer: (query: string, options?: AnswerOptions) => Promise;\n};\n\n",[],[235,385],"7f8f7a6e-b9ca-11f0-8f8b-0224a6c84d84","llama-3.3-70b-default.ts","7f8f7b36-b9ca-11f0-8f8b-0224a6c84d84",62,["D",1762293982145],"// Default Answer Strategy using Llama 3.3 70B\n// Uses the active search strategy to find relevant docs, then feeds them to Groq's Llama 3.3 70B model\n\nimport \"jsr:@std/dotenv/load\"; // needed for deno run; not req for smallweb or valtown\nimport type { AnswerStrategy, AnswerResult, AnswerOptions } from \"./types.ts\";\nimport type { Page } from \"../search/types.ts\";\nimport { formatPagesAsContext, DEFAULT_SYSTEM_PROMPT, cleanupMarkdownLinks } from \"./utils.ts\";\nimport { groqChatCompletion } from \"../groq.ts\";\nimport { searchPages } from \"../search/index.ts\";\n\n// Model configuration\nconst DEFAULT_MODEL = \"llama-3.3-70b-versatile\";\nconst DEFAULT_MAX_CONTEXT_PAGES = 5; // Use top 5 search results\nconst DEFAULT_TEMPERATURE = 0.3;\nconst MAX_TOKENS_PER_PAGE = 10000; // Limit per page to manage context window\n\n// Get all pages for answering with content\n// Loads from latest.json which now includes full content\nconst getAllPagesForAnswering = async (): Promise => {\n try {\n const jsonPath = new URL(\"../data/latest.json\", import.meta.url).pathname;\n const jsonText = await Deno.readTextFile(jsonPath);\n const jsonData = JSON.parse(jsonText);\n \n if (jsonData.results && Array.isArray(jsonData.results)) {\n return jsonData.results.map((result: any) => ({\n path: result.path,\n url: result.url,\n content: result.content || \"\", // Content now included in JSON\n title: result.title,\n embeddings: result.embeddings,\n metadata: result.metadata,\n }));\n }\n \n return [];\n } catch (error) {\n console.error(\"Failed to load pages for answering:\", error);\n return [];\n }\n};\n\nexport const answerStrategy: AnswerStrategy = {\n name: \"llama-3.3-70b-default\",\n description: \"RAG using active search strategy + Llama 3.3 70B with up to 5 doc pages in context\",\n \n answer: async (query: string, options: AnswerOptions = {}): Promise => {\n const enableTiming = options.enableTiming || false;\n const timings: Record = {};\n const startTime = performance.now();\n \n // Step 1: Search for relevant pages\n const searchStart = performance.now();\n const pages = await getAllPagesForAnswering();\n const searchResults = await searchPages(query, pages, {\n limit: options.limit || 10, // Get more results, but we'll only use top N for context\n minScore: options.minScore || 0,\n enableTiming: true, // Enable detailed search timing\n });\n if (enableTiming) timings.search = performance.now() - searchStart;\n \n // Capture detailed search timings from first result's metadata\n const searchMetadata = searchResults[0]?.metadata || {};\n \n if (searchResults.length === 0) {\n return {\n answer: \"I couldn't find any relevant documentation to answer your question. Please try rephrasing or ask about a different topic.\",\n query,\n searchResults: [],\n contextUsed: 0,\n metadata: {\n strategy: \"llama-3.3-70b-default\",\n model: DEFAULT_MODEL,\n error: \"No search results found\",\n ...(enableTiming && { timings }),\n },\n };\n }\n \n // Step 2: Get full content for top search results\n const contextStart = performance.now();\n const maxContextPages = options.maxContextPages || DEFAULT_MAX_CONTEXT_PAGES;\n const topResults = searchResults.slice(0, maxContextPages);\n \n // Get pages with content (now included in JSON from recalculate)\n const pagesWithContent: Page[] = [];\n for (const result of topResults) {\n const page = pages.find(p => p.path === result.path);\n if (page && page.content) {\n pagesWithContent.push(page);\n }\n }\n \n // Format pages as context\n const { context, pagesUsed, totalTokens } = formatPagesAsContext(\n pagesWithContent,\n maxContextPages,\n MAX_TOKENS_PER_PAGE\n );\n if (enableTiming) timings.contextPrep = performance.now() - contextStart;\n \n // Step 3: Call Groq LLM with context\n const llmStart = performance.now();\n const systemPrompt = options.systemPrompt || DEFAULT_SYSTEM_PROMPT;\n const userPrompt = `Context from documentation:\\n${context}\\n\\n---\\n\\nUser Question: ${query}\\n\\nPlease provide a helpful answer based on the documentation context above.`;\n\n \n const llmResponse = await groqChatCompletion([\n { role: \"system\", content: systemPrompt },\n { role: \"user\", content: userPrompt },\n ], {\n model: options.model || DEFAULT_MODEL,\n temperature: options.temperature ?? DEFAULT_TEMPERATURE,\n });\n if (enableTiming) timings.llm = performance.now() - llmStart;\n \n if (!llmResponse) {\n return {\n answer: \"Sorry, I encountered an error while generating the answer. Please try again.\",\n query,\n searchResults: topResults.map(r => ({\n path: r.path,\n url: r.url,\n title: r.title,\n score: r.score,\n })),\n contextUsed: pagesUsed,\n metadata: {\n strategy: \"llama-3.3-70b-default\",\n model: DEFAULT_MODEL,\n error: \"LLM call failed\",\n ...(enableTiming && { timings }),\n },\n };\n }\n \n if (enableTiming) {\n timings.total = performance.now() - startTime;\n console.log(` ⏱️ Answer timing breakdown:`);\n console.log(` Search: ${timings.search?.toFixed(2)}ms`);\n console.log(` Context prep: ${timings.contextPrep?.toFixed(2)}ms`);\n console.log(` LLM call: ${timings.llm?.toFixed(2)}ms`);\n console.log(` Total: ${timings.total?.toFixed(2)}ms`);\n }\n \n // Clean up any .md extensions in markdown links\n const cleanedAnswer = cleanupMarkdownLinks(llmResponse);\n \n // Return result\n return {\n answer: cleanedAnswer,\n query,\n searchResults: topResults.map(r => ({\n path: r.path,\n url: r.url,\n title: r.title,\n score: r.score,\n })),\n contextUsed: pagesUsed,\n totalTokens,\n metadata: {\n strategy: \"llama-3.3-70b-default\",\n model: options.model || DEFAULT_MODEL,\n temperature: options.temperature ?? DEFAULT_TEMPERATURE,\n searchResultsCount: searchResults.length,\n searchStrategy: searchMetadata.strategy,\n searchTimings: searchMetadata.timings, // Detailed search timings\n ...(enableTiming && { timings }),\n },\n };\n },\n};\n\n",[],[235,589],"7fa5ca80-b9ca-11f0-9362-0224a6c84d84","7fa5cb2a-b9ca-11f0-9362-0224a6c84d84",65,["D",1762293982125],"// Answer - Main entry point\n// To switch strategies, comment/uncomment the imports and function calls below\n\nexport * from \"./types.ts\";\nexport * from \"./utils.ts\"; // Exports cleanupMarkdownLinks and other utilities\n\nimport type { AnswerOptions, AnswerResult } from \"./types.ts\";\n\n// Answer strategies - uncomment to switch\n// import { answerStrategy } from \"./llama-3.3-70b-default.ts\"; // Llama 3.3 70B with up to 5 doc pages\nimport { answerStrategy } from \"./gpt-oss-20b-default.ts\"; // Default: GPT-OSS 20B with up to 5 doc pages\n// Add more strategies here as needed:\n// import { answerStrategy } from \"./llama-3.1-8b-fast.ts\"; // Fast strategy with smaller model\n// import { answerStrategy } from \"./mixtral-8x7b-extended.ts\"; // More context with Mixtral\n\n// Main answer function - comment/uncomment imports above to switch strategies\nexport const answerQuestion = async (\n query: string,\n options: AnswerOptions = {}\n): Promise => {\n return answerStrategy.answer(query, options);\n};\n\n// Export answer strategy for introspection (e.g., /answer/info endpoint)\nexport { answerStrategy };\n\n",[],[235,449],"7f745b80-b9ca-11f0-83d0-0224a6c84d84","gpt-oss-20b-default.ts","7f745c16-b9ca-11f0-83d0-0224a6c84d84",59,["D",1762293982099],"// Answer Strategy using GPT-OSS 20B\n// Uses the active search strategy to find relevant docs, then feeds them to Groq's GPT-OSS 20B model\n\nimport \"jsr:@std/dotenv/load\"; // needed for deno run; not req for smallweb or valtown\nimport type { AnswerStrategy, AnswerResult, AnswerOptions } from \"./types.ts\";\nimport type { Page } from \"../search/types.ts\";\nimport { formatPagesAsContext, DEFAULT_SYSTEM_PROMPT, cleanupMarkdownLinks } from \"./utils.ts\";\nimport { groqChatCompletion } from \"../groq.ts\";\nimport { searchPages } from \"../search/index.ts\";\n\n// Model configuration\nconst DEFAULT_MODEL = \"openai/gpt-oss-20b\";\nconst DEFAULT_MAX_CONTEXT_PAGES = 7; // Use top 5 search results\nconst DEFAULT_TEMPERATURE = 0.3;\nconst MAX_TOKENS_PER_PAGE = 10000; // Limit per page to manage context window\n\n// Get all pages for answering with content\n// Loads from latest.json which now includes full content\nconst getAllPagesForAnswering = async (): Promise => {\n try {\n const jsonPath = new URL(\"../data/latest.json\", import.meta.url).pathname;\n const jsonText = await Deno.readTextFile(jsonPath);\n const jsonData = JSON.parse(jsonText);\n \n if (jsonData.results && Array.isArray(jsonData.results)) {\n return jsonData.results.map((result: any) => ({\n path: result.path,\n url: result.url,\n content: result.content || \"\", // Content now included in JSON\n title: result.title,\n embeddings: result.embeddings,\n metadata: result.metadata,\n }));\n }\n \n return [];\n } catch (error) {\n console.error(\"Failed to load pages for answering:\", error);\n return [];\n }\n};\n\nexport const answerStrategy: AnswerStrategy = {\n name: \"gpt-oss-20b-default\",\n description: \"RAG using active search strategy + GPT-OSS 20B with up to 5 doc pages in context\",\n \n answer: async (query: string, options: AnswerOptions = {}): Promise => {\n const enableTiming = options.enableTiming || false;\n const timings: Record = {};\n const startTime = performance.now();\n const trackTime = options.trackTime || (() => {});\n \n // Step 1: Load pages and search\n trackTime(\"Pre: Load pages for search\");\n const pages = await getAllPagesForAnswering();\n trackTime(\"Post: Pages loaded\");\n \n trackTime(\"Pre: Generate query embedding\");\n const searchStart = performance.now();\n const searchResults = await searchPages(query, pages, {\n limit: options.limit || 10, // Get more results, but we'll only use top N for context\n minScore: options.minScore || 0,\n enableTiming: true, // Enable detailed search timing\n });\n if (enableTiming) timings.search = performance.now() - searchStart;\n trackTime(\"Post: Search complete (embedding + similarity)\");\n \n // Capture detailed search timings from first result's metadata\n const searchMetadata = searchResults[0]?.metadata || {};\n \n if (searchResults.length === 0) {\n return {\n answer: \"I couldn't find any relevant documentation to answer your question. Please try rephrasing or ask about a different topic.\",\n query,\n searchResults: [],\n contextUsed: 0,\n metadata: {\n strategy: \"gpt-oss-20b-default\",\n model: DEFAULT_MODEL,\n error: \"No search results found\",\n ...(enableTiming && { timings }),\n },\n };\n }\n \n // Step 2: Prepare context from search results\n trackTime(\"Pre: Prepare context from search results\");\n const contextStart = performance.now();\n const maxContextPages = options.maxContextPages || DEFAULT_MAX_CONTEXT_PAGES;\n const topResults = searchResults.slice(0, maxContextPages);\n \n // Get pages with content (now included in JSON from recalculate)\n const pagesWithContent: Page[] = [];\n for (const result of topResults) {\n const page = pages.find(p => p.path === result.path);\n if (page && page.content) {\n pagesWithContent.push(page);\n }\n }\n \n // Format pages as context\n const { context, pagesUsed, totalTokens } = formatPagesAsContext(\n pagesWithContent,\n maxContextPages,\n MAX_TOKENS_PER_PAGE\n );\n if (enableTiming) timings.contextPrep = performance.now() - contextStart;\n trackTime(\"Post: Context prepared\");\n \n // Step 3: Call Groq LLM with context\n trackTime(\"Pre: Call LLM\");\n const llmStart = performance.now();\n const systemPrompt = options.systemPrompt || DEFAULT_SYSTEM_PROMPT;\n const userPrompt = `Context from documentation:\\n${context}\\n\\n---\\n\\nUser Question: ${query}\\n\\nPlease provide a helpful answer based on the documentation context above.`;\n\n \n const llmResponse = await groqChatCompletion([\n { role: \"system\", content: systemPrompt },\n { role: \"user\", content: userPrompt },\n ], {\n model: options.model || DEFAULT_MODEL,\n temperature: options.temperature ?? DEFAULT_TEMPERATURE,\n });\n if (enableTiming) timings.llm = performance.now() - llmStart;\n trackTime(\"Post: LLM response received\");\n \n if (!llmResponse) {\n return {\n answer: \"Sorry, I encountered an error while generating the answer. Please try again.\",\n query,\n searchResults: topResults.map(r => ({\n path: r.path,\n url: r.url,\n title: r.title,\n score: r.score,\n })),\n contextUsed: pagesUsed,\n metadata: {\n strategy: \"gpt-oss-20b-default\",\n model: DEFAULT_MODEL,\n error: \"LLM call failed\",\n ...(enableTiming && { timings }),\n },\n };\n }\n \n if (enableTiming) {\n timings.total = performance.now() - startTime;\n console.log(` ⏱️ Answer timing breakdown:`);\n console.log(` Search: ${timings.search?.toFixed(2)}ms`);\n console.log(` Context prep: ${timings.contextPrep?.toFixed(2)}ms`);\n console.log(` LLM call: ${timings.llm?.toFixed(2)}ms`);\n console.log(` Total: ${timings.total?.toFixed(2)}ms`);\n }\n \n // Clean up any .md extensions in markdown links\n const cleanedAnswer = cleanupMarkdownLinks(llmResponse);\n \n // Return result\n return {\n answer: cleanedAnswer,\n query,\n searchResults: topResults.map(r => ({\n path: r.path,\n url: r.url,\n title: r.title,\n score: r.score,\n })),\n contextUsed: pagesUsed,\n totalTokens,\n metadata: {\n strategy: \"gpt-oss-20b-default\",\n model: options.model || DEFAULT_MODEL,\n temperature: options.temperature ?? DEFAULT_TEMPERATURE,\n searchResultsCount: searchResults.length,\n searchStrategy: searchMetadata.strategy,\n searchTimings: searchMetadata.timings, // Detailed search timings\n ...(enableTiming && { timings }),\n },\n };\n },\n};\n\n\n",[],[235,604],"7f483adc-b9ca-11f0-b7be-0224a6c84d84","7f483b86-b9ca-11f0-b7be-0224a6c84d84",54,["D",1762293981801],"# Answer Strategy Comparison\n\nThis document helps you choose the right answer strategy for your use case.\n\n## Current Strategies\n\n### 1. llama-3.3-70b-default ✅ (Active)\n\n**Best for**: General-purpose Q&A, complex questions, high-quality answers\n\n**Configuration**:\n- Model: `llama-3.3-70b-versatile`\n- Max context pages: 5\n- Temperature: 0.3\n- Tokens per page: ~2000\n\n**Performance**:\n- Search: 50-500ms (depends on search strategy)\n- Context prep: <50ms\n- LLM call: 500-3000ms\n- **Total: ~1-3.5s**\n\n**Quality**: ⭐⭐⭐⭐⭐ (5/5)\n**Speed**: ⭐⭐⭐ (3/5)\n**Cost**: ⭐⭐⭐ (3/5)\n\n**Pros**:\n- ✅ Excellent reasoning and comprehension\n- ✅ Handles complex multi-part questions\n- ✅ Good at code examples and technical details\n- ✅ Consistent, reliable answers\n\n**Cons**:\n- ❌ Slower than 8B models\n- ❌ More expensive per token\n- ❌ May be overkill for simple questions\n\n**Use cases**:\n- Complex how-to questions\n- Multi-step implementations\n- Comparing features/models\n- Debugging and troubleshooting\n- Code generation with explanations\n\n---\n\n## Future Strategies (Templates)\n\n### 2. llama-3.1-8b-fast (Not yet implemented)\n\n**Best for**: Simple factual questions, quick lookups, high-volume traffic\n\n**Configuration**:\n- Model: `llama-3.1-8b-instant`\n- Max context pages: 2-3\n- Temperature: 0.3\n- Tokens per page: ~1000\n\n**Expected Performance**:\n- Search: 50-500ms\n- Context prep: <30ms\n- LLM call: 200-800ms\n- **Total: ~0.3-1.3s**\n\n**Quality**: ⭐⭐⭐⭐ (4/5)\n**Speed**: ⭐⭐⭐⭐⭐ (5/5)\n**Cost**: ⭐⭐⭐⭐⭐ (5/5)\n\n**Best for**:\n- \"What models are available?\"\n- \"What is X?\"\n- \"How much does Y cost?\"\n- Simple API lookups\n\n---\n\n### 3. mixtral-8x7b-extended (Not yet implemented)\n\n**Best for**: Very complex questions requiring lots of context\n\n**Configuration**:\n- Model: `mixtral-8x7b-32768`\n- Max context pages: 10\n- Temperature: 0.3\n- Tokens per page: ~3000\n\n**Expected Performance**:\n- Search: 50-500ms\n- Context prep: ~100ms\n- LLM call: 1000-4000ms\n- **Total: ~1.5-5s**\n\n**Quality**: ⭐⭐⭐⭐⭐ (5/5)\n**Speed**: ⭐⭐ (2/5)\n**Cost**: ⭐⭐ (2/5)\n\n**Best for**:\n- \"Compare all available models\"\n- \"How do I implement a complete chat system with X, Y, Z features?\"\n- Questions requiring synthesis across many docs\n\n---\n\n### 4. llama-3.3-70b-code (Not yet implemented)\n\n**Best for**: Code generation and technical implementation questions\n\n**Configuration**:\n- Model: `llama-3.3-70b-versatile`\n- Max context pages: 5\n- Temperature: 0.2 (more deterministic for code)\n- Custom system prompt optimized for code\n\n**Expected Performance**:\n- Similar to llama-3.3-70b-default\n- **Total: ~1-3.5s**\n\n**Quality**: ⭐⭐⭐⭐⭐ (5/5) for code\n**Speed**: ⭐⭐⭐ (3/5)\n**Cost**: ⭐⭐⭐ (3/5)\n\n**Best for**:\n- \"Show me example code for X\"\n- \"How do I implement Y in Python/JavaScript?\"\n- API usage examples\n- Debugging code issues\n\n---\n\n### 5. citation-mode (Not yet implemented)\n\n**Best for**: Academic/research use, when you need to cite sources\n\n**Configuration**:\n- Model: `llama-3.3-70b-versatile`\n- Max context pages: 5\n- Temperature: 0.3\n- Custom system prompt for citations\n- Post-processing to add inline citations\n\n**Expected Performance**:\n- Similar to llama-3.3-70b-default\n- +50-100ms for citation processing\n- **Total: ~1.5-4s**\n\n**Quality**: ⭐⭐⭐⭐⭐ (5/5)\n**Speed**: ⭐⭐⭐ (3/5)\n**Cost**: ⭐⭐⭐ (3/5)\n\n**Best for**:\n- Documentation generation\n- Training materials\n- When you need exact source references\n- Verifying information\n\n---\n\n## Comparison Matrix\n\n| Strategy | Speed | Quality | Cost | Context | Best For |\n|----------|-------|---------|------|---------|----------|\n| **llama-3.3-70b-default** ✅ | Medium | Excellent | Medium | 5 pages | General purpose, complex Q&A |\n| llama-3.1-8b-fast | Fast | Good | Low | 2-3 pages | Simple lookups, high volume |\n| mixtral-8x7b-extended | Slow | Excellent | High | 10 pages | Very complex questions |\n| llama-3.3-70b-code | Medium | Excellent | Medium | 5 pages | Code generation |\n| citation-mode | Medium | Excellent | Medium | 5 pages | Research, documentation |\n\n## Choosing a Strategy\n\n### Decision Tree\n\n1. **Is the question simple and factual?**\n - Yes → Use `llama-3.1-8b-fast` (when implemented)\n - No → Continue\n\n2. **Does it require lots of documentation context?**\n - Yes → Use `mixtral-8x7b-extended` (when implemented)\n - No → Continue\n\n3. **Is it primarily about code/implementation?**\n - Yes → Use `llama-3.3-70b-code` (when implemented)\n - No → Continue\n\n4. **Do you need citations?**\n - Yes → Use `citation-mode` (when implemented)\n - No → Use `llama-3.3-70b-default` ✅\n\n### By Question Type\n\n**Factual Questions** (\"What is X?\")\n- 🥇 llama-3.1-8b-fast (fast + good enough)\n- 🥈 llama-3.3-70b-default (better quality)\n\n**How-To Questions** (\"How do I X?\")\n- 🥇 llama-3.3-70b-default (balanced)\n- 🥈 llama-3.3-70b-code (if code-heavy)\n\n**Complex Questions** (\"How do I build X with Y and Z?\")\n- 🥇 mixtral-8x7b-extended (more context)\n- 🥈 llama-3.3-70b-default (usually sufficient)\n\n**Code Examples** (\"Show me code for X\")\n- 🥇 llama-3.3-70b-code (optimized)\n- 🥈 llama-3.3-70b-default (good enough)\n\n**Comparison Questions** (\"What's the difference between X and Y?\")\n- 🥇 llama-3.3-70b-default (good reasoning)\n- 🥈 mixtral-8x7b-extended (if comparing many things)\n\n### By Performance Requirements\n\n**Need fastest response** (<1s goal)\n- Use `llama-3.1-8b-fast` (when implemented)\n- Reduce `maxContextPages` to 2\n- Use fastest search strategy\n\n**Need best quality** (no time constraint)\n- Use `mixtral-8x7b-extended` (when implemented)\n- Increase `maxContextPages` to 10\n- Raise `minScore` to 60+\n\n**Balanced** (1-3s acceptable)\n- Use `llama-3.3-70b-default` ✅ (current default)\n- Default settings work well\n\n### By Traffic Patterns\n\n**High volume, many simple questions**\n- Implement and use `llama-3.1-8b-fast`\n- Consider caching common answers\n- Use rate limiting\n\n**Low volume, complex questions**\n- Use `llama-3.3-70b-default` or `mixtral-8x7b-extended`\n- Quality over speed\n\n**Mixed traffic**\n- Route simple questions to fast strategy\n- Route complex questions to powerful strategy\n- Consider implementing multi-strategy endpoint\n\n## Cost Considerations\n\nApproximate token costs per answer (based on Groq pricing):\n\n### llama-3.3-70b-default\n- Context: ~10k tokens (5 pages × 2k each)\n- Answer: ~500 tokens\n- **Total: ~10.5k tokens per answer**\n\n### llama-3.1-8b-fast (estimated)\n- Context: ~3k tokens (3 pages × 1k each)\n- Answer: ~300 tokens\n- **Total: ~3.3k tokens per answer**\n- **~3x cheaper than 70B**\n\n### mixtral-8x7b-extended (estimated)\n- Context: ~30k tokens (10 pages × 3k each)\n- Answer: ~700 tokens\n- **Total: ~30.7k tokens per answer**\n- **~3x more expensive than default**\n\n### Cost-saving strategies:\n1. Use smaller models for simple questions\n2. Reduce `maxContextPages`\n3. Increase `minScore` (fewer pages in context)\n4. Cache common questions/answers\n5. Implement tiered routing\n\n## Implementation Guide\n\n### Adding a New Strategy\n\n1. **Copy template**:\n ```bash\n cp answer/llama-3.3-70b-default.ts answer/my-strategy.ts\n ```\n\n2. **Modify configuration**:\n ```typescript\n const DEFAULT_MODEL = \"your-model\";\n const DEFAULT_MAX_CONTEXT_PAGES = 3;\n const DEFAULT_TEMPERATURE = 0.5;\n ```\n\n3. **Update strategy metadata**:\n ```typescript\n export const answerStrategy: AnswerStrategy = {\n name: \"my-strategy\",\n description: \"What makes it special\",\n answer: async (query, options) => { /* ... */ }\n };\n ```\n\n4. **Activate**:\n ```typescript\n // answer/index.ts\n import { answerStrategy } from \"./my-strategy.ts\";\n ```\n\n5. **Test**:\n ```bash\n curl \"http://localhost:8000/answer/info\"\n curl \"http://localhost:8000/answer?q=test\"\n ```\n\n### Testing Multiple Strategies\n\nCreate a comparison test script:\n\n```typescript\n// testing/answer-comparison.ts\nimport { questions } from \"./questions.ts\";\n\nconst strategies = [\n \"llama-3.3-70b-default\",\n \"llama-3.1-8b-fast\",\n \"mixtral-8x7b-extended\"\n];\n\nfor (const strategy of strategies) {\n for (const question of questions) {\n // Switch strategy\n // Run question\n // Collect metrics\n }\n}\n// Compare results\n```\n\n## Monitoring and Optimization\n\n### Key Metrics to Track\n\n1. **Response time breakdown**:\n - Search duration\n - Context prep duration\n - LLM duration\n - Total duration\n\n2. **Quality metrics**:\n - User feedback/ratings\n - Answer correctness\n - Relevance of sources\n\n3. **Cost metrics**:\n - Tokens per answer\n - Cost per answer\n - Monthly spend\n\n4. **Usage patterns**:\n - Question types\n - Model distribution\n - Cache hit rates\n\n### Optimization Tips\n\n1. **Speed**: \n - Profile with `enableTiming: true`\n - Optimize slowest component\n - Consider caching\n\n2. **Quality**:\n - Test with real questions\n - Tune system prompts\n - Adjust context size\n\n3. **Cost**:\n - Route by question complexity\n - Cache common answers\n - Use smaller models when possible\n\n## Future Enhancements\n\n### Multi-Strategy Routing\n\nAutomatically select strategy based on question analysis:\n\n```typescript\nasync function smartRoute(question: string) {\n const complexity = analyzeComplexity(question);\n const type = classifyQuestion(question);\n \n if (complexity === \"simple\" && type === \"factual\") {\n return \"llama-3.1-8b-fast\";\n } else if (type === \"code\") {\n return \"llama-3.3-70b-code\";\n } else if (complexity === \"complex\") {\n return \"mixtral-8x7b-extended\";\n }\n return \"llama-3.3-70b-default\";\n}\n```\n\n### Answer Caching\n\nCache answers for common questions:\n\n```typescript\nconst cachedAnswer = await cache.get(questionHash);\nif (cachedAnswer) return cachedAnswer;\n\nconst answer = await generateAnswer(question);\nawait cache.set(questionHash, answer, ttl);\n```\n\n### Follow-up Questions\n\nSupport conversation context:\n\n```typescript\nawait answerQuestion(question, {\n conversationHistory: previousQA,\n maxContextPages: 3 // Reduced to fit history\n});\n```\n\n## Resources\n\n- **Groq Models**: https://console.groq.com/docs/models\n- **Groq Pricing**: https://groq.com/pricing/\n- **Model Benchmarks**: https://console.groq.com/docs/benchmarks\n\n",[],[235,457],"7f6d8314-b9ca-11f0-8f8b-0224a6c84d84","7f6d83c8-b9ca-11f0-8f8b-0224a6c84d84",58,["D",1762293981918],"# Answer Strategies\n\nAnswer strategies implement Retrieval-Augmented Generation (RAG) to answer user questions using documentation search and LLM inference.\n\n## How It Works\n\nEach answer strategy follows this general pattern:\n\n1. **Search**: Use the active search strategy to find relevant documentation pages\n2. **Retrieve**: Get full content from the top N search results\n3. **Format**: Format the documentation as context for the LLM\n4. **Generate**: Call the Groq LLM with the context and user question to generate an answer\n\n## Active Strategy\n\nThe active strategy is selected in `answer/index.ts` by uncommenting the desired import.\n\n### Current Active Strategy\n\n**llama-3.3-70b-default** - Default strategy using Llama 3.3 70B\n- Uses up to 5 documentation pages in context\n- Truncates each page to ~2000 tokens to manage context window\n- Temperature: 0.3 (relatively focused/deterministic)\n- Model: `llama-3.3-70b-versatile`\n\n## Available Strategies\n\n### 1. llama-3.3-70b-default.ts\n\n**Best for**: General purpose Q&A with good balance of quality and speed\n\n- **Model**: `llama-3.3-70b-versatile`\n- **Context**: Up to 5 pages, 2000 tokens each\n- **Temperature**: 0.3 (default)\n- **Performance**: ~1-3s depending on search and LLM response time\n\n**Configuration options**:\n```typescript\n{\n limit: 10, // Search results to consider\n minScore: 0, // Minimum search score\n maxContextPages: 5, // Pages to include in context\n temperature: 0.3, // LLM temperature\n model: \"llama-3.3-70b-versatile\" // Override model\n}\n```\n\n## Creating New Strategies\n\nTo create a new answer strategy:\n\n1. Create a new file in `/answer/` (e.g., `llama-3.1-8b-fast.ts`)\n2. Implement the `AnswerStrategy` interface:\n\n```typescript\nimport type { AnswerStrategy, AnswerResult, AnswerOptions } from \"./types.ts\";\n\nexport const answerStrategy: AnswerStrategy = {\n name: \"your-strategy-name\",\n description: \"Brief description of your strategy\",\n \n answer: async (query: string, options: AnswerOptions = {}): Promise => {\n // Your implementation here\n // 1. Search for relevant pages\n // 2. Get full content\n // 3. Format as context\n // 4. Call LLM\n // 5. Return AnswerResult\n },\n};\n```\n\n3. Add the import to `answer/index.ts` and comment out other strategies\n4. Test your strategy\n\n### Strategy Ideas\n\nHere are some ideas for additional strategies you might want to implement:\n\n- **llama-3.1-8b-fast**: Faster responses with smaller model, fewer pages\n- **mixtral-8x7b-extended**: More context pages with Mixtral's larger context window\n- **llama-3.3-70b-code-focused**: Specialized prompts for code examples and API usage\n- **multi-step-reasoning**: Break down complex questions into sub-questions\n- **citation-mode**: Include specific citations/references in the answer\n- **conversational**: Support follow-up questions with conversation history\n\n## API Usage\n\n### Basic Answer Request\n\n```bash\nGET /answer?q=How+do+I+use+the+Groq+API\n```\n\n### With Options\n\n```bash\nGET /answer?q=What+models+are+available&maxContextPages=3&temperature=0.5\n```\n\n### Get Strategy Info\n\n```bash\nGET /answer/info\n```\n\n## Response Format\n\n```json\n{\n \"answer\": \"markdown formatted answer\",\n \"query\": \"user's original question\",\n \"searchResults\": [\n {\n \"path\": \"api/reference\",\n \"url\": \"https://...\",\n \"title\": \"API Reference\",\n \"score\": 95.2\n }\n ],\n \"contextUsed\": 5,\n \"totalTokens\": 8500,\n \"metadata\": {\n \"strategy\": \"llama-3.3-70b-default\",\n \"model\": \"llama-3.3-70b-versatile\",\n \"temperature\": 0.3,\n \"searchResultsCount\": 10,\n \"timings\": {\n \"search\": 45.2,\n \"contextPrep\": 5.1,\n \"llm\": 1250.3,\n \"total\": 1300.6\n }\n }\n}\n```\n\n## Tuning Your Strategy\n\n### Context Size\n\n- **More pages** = more comprehensive but slower and more expensive\n- **Fewer pages** = faster but might miss relevant info\n- Recommended: 3-5 pages for most questions\n\n### Token Limits\n\n- **Per page**: 1000-3000 tokens is a good range\n- **Total context**: Stay under 32k tokens for most models\n- Llama 3.3 70B supports up to 128k context, but quality may degrade\n\n### Temperature\n\n- **0.0-0.3**: Focused, deterministic answers (good for facts)\n- **0.4-0.7**: Balanced creativity and accuracy\n- **0.8-1.0**: More creative but less consistent (avoid for docs Q&A)\n\n### Search Configuration\n\n- **Higher limit**: More pages to choose from (10-20 recommended)\n- **Higher minScore**: Only use highly relevant pages (50-70 threshold)\n- Balance between precision (fewer, better pages) and recall (more pages, might miss relevant info)\n\n## Best Practices\n\n1. **Match model to task**:\n - Simple factual questions: Smaller/faster models\n - Complex reasoning: Larger models (70B+)\n - Code generation: Models fine-tuned for code\n\n2. **System prompts matter**:\n - Be specific about the documentation domain (Groq API)\n - Set expectations for answer format (markdown, citations, etc.)\n - Provide guidelines for handling missing information\n - Include URL formatting instructions (e.g., \"remove .md extensions\")\n\n3. **Manage context window**:\n - Don't just dump all pages - be selective\n - Truncate long pages intelligently\n - Consider summarizing very long pages first\n\n4. **Error handling**:\n - Gracefully handle search failures\n - Provide fallback responses when LLM fails\n - Include relevant metadata for debugging\n\n5. **Post-processing**:\n - Use `cleanupMarkdownLinks()` to remove .md extensions from generated links\n - Add custom post-processing for your specific needs\n - Validate links and citations if needed\n\n## URL Cleanup\n\nAnswers automatically clean up markdown links to remove `.md` extensions:\n\n```typescript\n// Before cleanup\n[Compound](https://console.groq.com/docs/agentic-tooling/compound-beta.md)\n\n// After cleanup \n[Compound](https://console.groq.com/docs/agentic-tooling/compound-beta)\n```\n\nThis happens through:\n1. **System prompt**: Instructs the LLM to avoid .md extensions\n2. **Post-processing**: `cleanupMarkdownLinks()` function removes any remaining .md extensions\n\nTo disable cleanup (not recommended):\n```typescript\n// In your custom strategy, skip the cleanup:\nreturn {\n answer: llmResponse, // Don't call cleanupMarkdownLinks()\n // ... rest of result\n};\n```\n\n## Testing\n\nTest your strategy with various question types:\n\n- **Factual**: \"What models does Groq support?\"\n- **How-to**: \"How do I authenticate with the API?\"\n- **Comparison**: \"What's the difference between model X and Y?\"\n- **Code examples**: \"Show me an example of streaming responses\"\n- **Complex**: \"How do I implement rate limiting with retries?\"\n\n## Performance Benchmarks\n\nTarget performance for answer strategies:\n\n- **Search**: 50-500ms (depends on active search strategy)\n- **Context prep**: <50ms\n- **LLM call**: 500-3000ms (depends on model and response length)\n- **Total**: 1-4s for most queries\n\nStrategies taking >5s should be optimized or marked as \"detailed\" mode.\n\n",[],[235,189],"7f58d5d6-b9ca-11f0-afaf-0224a6c84d84","QUICK-START.md","7f58d680-b9ca-11f0-afaf-0224a6c84d84",56,["D",1762293981932],"# Answer Strategies - Quick Start Guide\n\nThis guide will help you quickly get started with answer strategies for RAG-based question answering.\n\n## What Are Answer Strategies?\n\nAnswer strategies implement **Retrieval-Augmented Generation (RAG)** - they search documentation, retrieve relevant pages, and use an LLM to generate answers to user questions.\n\n## Quick Test\n\n### 1. Run Tests Locally (Recommended)\n\n```bash\n# Run comprehensive test suite with timing breakdown\ndeno task answer\n```\n\nThis will:\n- Load test questions from `testing/questions.ts`\n- Run each question through the active answer strategy\n- Show detailed timing breakdown (search, context prep, LLM call)\n- Display search results used for context\n- Show generated answers\n- Provide summary statistics\n\n### 2. Test via API Endpoints\n\n#### Start the Server\n\n```bash\ndeno task serve\n```\n\n#### Test Single Questions\n\n```bash\n# Basic question\ncurl \"http://localhost:8000/answer?q=How+do+I+use+the+Groq+API\"\n\n# With options\ncurl \"http://localhost:8000/answer?q=What+models+are+available&maxContextPages=3\"\n\n# Get strategy info\ncurl \"http://localhost:8000/answer/info\"\n\n# Run test suite via API\ncurl \"http://localhost:8000/answer/test\"\n```\n\n## How It Works\n\n### Step-by-Step Process\n\n1. **User asks a question**: \"How do I authenticate with the Groq API?\"\n\n2. **Search** (50-500ms): The active search strategy finds relevant docs\n ```\n → Search query: \"authenticate groq api\"\n → Returns: Top 10 matching pages ranked by relevance\n ```\n\n3. **Retrieve** (fast, from cache): Get full content for top 5 pages\n ```\n → Loads content from latest.json (local cache)\n → Each page limited to ~2000 tokens\n ```\n\n4. **Format** (<50ms): Package docs as LLM context\n ```\n → Formats pages with titles, URLs, and content\n → Adds system prompt with instructions\n → Creates user prompt with question\n ```\n\n5. **Generate** (500-3000ms): LLM generates answer\n ```\n → Calls Groq API with Llama 3.3 70B\n → Returns markdown-formatted answer\n → Includes citations and examples from docs\n ```\n\n## Understanding the Response\n\n```json\n{\n \"answer\": \"To authenticate with the Groq API...\",\n \"query\": \"How do I authenticate with the Groq API?\",\n \"searchResults\": [\n {\n \"path\": \"api/authentication\",\n \"url\": \"https://console.groq.com/docs/api/authentication\",\n \"title\": \"Authentication\",\n \"score\": 92.5\n }\n ],\n \"contextUsed\": 5,\n \"totalTokens\": 8500,\n \"metadata\": {\n \"strategy\": \"llama-3.3-70b-default\",\n \"model\": \"llama-3.3-70b-versatile\",\n \"temperature\": 0.3,\n \"searchResultsCount\": 10,\n \"timings\": {\n \"search\": 45.2,\n \"contextPrep\": 5.1,\n \"llm\": 1250.3,\n \"total\": 1300.6\n }\n }\n}\n```\n\n### Key Fields\n\n- **answer**: The LLM-generated answer (markdown formatted)\n- **query**: Your original question\n- **searchResults**: Top pages used as context (with scores)\n- **contextUsed**: Number of pages actually sent to the LLM\n- **totalTokens**: Approximate tokens in the context\n- **metadata.timings**: Performance breakdown\n\n## Switching Strategies\n\n### Current Strategy\n\nThe active strategy is set in `answer/index.ts`:\n\n```typescript\n// Default: Llama 3.3 70B with up to 5 doc pages\nimport { answerStrategy } from \"./llama-3.3-70b-default.ts\";\n```\n\n### Available Strategies\n\nCurrently available:\n- ✅ **llama-3.3-70b-default**: Balanced quality and speed\n\nComing soon (you can implement these!):\n- ⚡ **llama-3.1-8b-fast**: Faster responses with smaller model\n- 📚 **mixtral-8x7b-extended**: More context with larger model\n- 💻 **llama-3.3-70b-code**: Optimized for code examples\n- 🔗 **citation-mode**: Includes specific citations\n\n### Switching\n\n1. Comment out current strategy in `answer/index.ts`\n2. Uncomment the strategy you want to use\n3. Restart the server\n\n```typescript\n// answer/index.ts\n\n// Comment out default\n// import { answerStrategy } from \"./llama-3.3-70b-default.ts\";\n\n// Use fast strategy instead\nimport { answerStrategy } from \"./llama-3.1-8b-fast.ts\";\n```\n\n## Query Parameters\n\n### Required\n\n- **q**: The question to answer\n ```bash\n ?q=How+do+I+use+streaming\n ```\n\n### Optional\n\n- **limit**: Max search results (default: 10)\n ```bash\n ?limit=20\n ```\n\n- **minScore**: Minimum search score 0-100 (default: 0)\n ```bash\n ?minScore=50\n ```\n\n- **maxContextPages**: Pages to send to LLM (default: 5)\n ```bash\n ?maxContextPages=3\n ```\n\n- **temperature**: LLM temperature 0-1 (default: 0.3)\n ```bash\n ?temperature=0.5\n ```\n\n- **model**: Override the model (optional)\n ```bash\n ?model=llama-3.1-8b-instant\n ```\n\n### Example Combinations\n\n```bash\n# Fast mode: fewer pages, instant model\ncurl \"http://localhost:8000/answer?q=What+is+Groq&maxContextPages=2&model=llama-3.1-8b-instant\"\n\n# High quality: more pages, higher threshold\ncurl \"http://localhost:8000/answer?q=How+to+implement+retry+logic&limit=20&minScore=60&maxContextPages=7\"\n\n# Creative mode: higher temperature\ncurl \"http://localhost:8000/answer?q=Ideas+for+using+Groq+API&temperature=0.8\"\n```\n\n## Common Question Types\n\n### Factual Questions\n\n**Good for**: Quick facts, definitions, model names\n\n```bash\ncurl \"http://localhost:8000/answer?q=What+models+does+Groq+support\"\n```\n\n**Best settings**: Default (5 pages, temp 0.3)\n\n### How-To Questions\n\n**Good for**: Implementation guides, step-by-step instructions\n\n```bash\ncurl \"http://localhost:8000/answer?q=How+do+I+implement+streaming\"\n```\n\n**Best settings**: More pages (6-8), low temp (0.2-0.3)\n\n### Code Examples\n\n**Good for**: Requesting code snippets\n\n```bash\ncurl \"http://localhost:8000/answer?q=Show+me+a+Python+example+of+calling+the+API\"\n```\n\n**Best settings**: Code-focused strategy (when available), temp 0.3\n\n### Comparison Questions\n\n**Good for**: Comparing models, features, approaches\n\n```bash\ncurl \"http://localhost:8000/answer?q=Difference+between+Llama+3.1+and+3.3\"\n```\n\n**Best settings**: More pages (7-10), temp 0.3\n\n### Complex Questions\n\n**Good for**: Multi-part questions requiring reasoning\n\n```bash\ncurl \"http://localhost:8000/answer?q=How+to+build+a+chatbot+with+streaming+and+conversation+history\"\n```\n\n**Best settings**: More pages (8-10), 70B+ model, temp 0.4\n\n## Troubleshooting\n\n### No Answer Generated\n\n**Problem**: Returns error or empty answer\n\n**Possible causes**:\n- No search results found\n- GROQ_API_KEY not set\n- Rate limit exceeded\n\n**Solution**:\n```bash\n# Check if search works\ncurl \"http://localhost:8000/search?q=your+question\"\n\n# Verify API key\necho $GROQ_API_KEY\n\n# Check strategy info\ncurl \"http://localhost:8000/answer/info\"\n```\n\n### Poor Answer Quality\n\n**Problem**: Answer is vague, incorrect, or unhelpful\n\n**Possible causes**:\n- Search results not relevant\n- Not enough context (too few pages)\n- Temperature too high\n\n**Solutions**:\n```bash\n# Check search results first\ncurl \"http://localhost:8000/search?q=your+question&limit=10\"\n\n# Increase context\ncurl \"http://localhost:8000/answer?q=your+question&maxContextPages=8\"\n\n# Lower temperature\ncurl \"http://localhost:8000/answer?q=your+question&temperature=0.2\"\n\n# Increase search quality threshold\ncurl \"http://localhost:8000/answer?q=your+question&minScore=60\"\n```\n\n### Slow Responses\n\n**Problem**: Takes >5 seconds to respond\n\n**Possible causes**:\n- Slow search strategy\n- Too many pages in context\n- Large model\n\n**Solutions**:\n```bash\n# Use fewer pages\ncurl \"http://localhost:8000/answer?q=your+question&maxContextPages=3\"\n\n# Switch to faster model\ncurl \"http://localhost:8000/answer?q=your+question&model=llama-3.1-8b-instant\"\n\n# Check timing breakdown in response metadata\n```\n\n## Creating Your Own Strategy\n\n### 1. Copy the Template\n\n```bash\ncp answer/llama-3.3-70b-default.ts answer/my-custom-strategy.ts\n```\n\n### 2. Modify Configuration\n\n```typescript\n// Change these constants\nconst DEFAULT_MODEL = \"your-preferred-model\";\nconst DEFAULT_MAX_CONTEXT_PAGES = 3; // Adjust as needed\nconst DEFAULT_TEMPERATURE = 0.5;\nconst MAX_TOKENS_PER_PAGE = 1000; // Adjust as needed\n```\n\n### 3. Customize System Prompt (Optional)\n\n```typescript\nimport { DEFAULT_SYSTEM_PROMPT } from \"./utils.ts\";\n\n// Or create your own:\nconst CUSTOM_SYSTEM_PROMPT = `You are a helpful assistant that...`;\n```\n\n### 4. Update Strategy Info\n\n```typescript\nexport const answerStrategy: AnswerStrategy = {\n name: \"my-custom-strategy\",\n description: \"What makes your strategy special\",\n answer: async (query: string, options: AnswerOptions = {}) => {\n // Your implementation\n },\n};\n```\n\n### 5. Activate Your Strategy\n\nEdit `answer/index.ts`:\n\n```typescript\nimport { answerStrategy } from \"./my-custom-strategy.ts\";\n```\n\n### 6. Test It\n\n```bash\ncurl \"http://localhost:8000/answer/info\" # Verify active strategy\ncurl \"http://localhost:8000/answer?q=test+question\"\n```\n\n## Performance Tips\n\n### Optimize for Speed\n\n1. Use faster models (8B instead of 70B)\n2. Reduce context pages (2-3 instead of 5)\n3. Use faster search strategy\n4. Lower token limits per page\n\n### Optimize for Quality\n\n1. Use larger models (70B+)\n2. Increase context pages (7-10)\n3. Use higher search score thresholds\n4. Include more search results to choose from\n\n### Balance Both\n\n1. Start with default (5 pages, 70B, temp 0.3)\n2. Monitor timing breakdown in responses\n3. Adjust based on question complexity\n4. Cache common questions (future enhancement)\n\n## Next Steps\n\n1. ✅ Test the default strategy\n2. ✅ Try different query parameters\n3. ✅ Check the README.md for more details\n4. ⚡ Create a fast strategy for simple questions\n5. 📚 Create an extended strategy for complex questions\n6. 🔧 Customize system prompts for your use case\n7. 📊 Build a testing harness (like `/search/test`)\n\n## Resources\n\n- **Search Strategies**: See `/search/` for how document retrieval works\n- **Groq Models**: https://console.groq.com/docs/models\n- **API Reference**: https://console.groq.com/docs/api-reference\n\n## Questions?\n\nCheck out:\n- `answer/README.md` - Detailed documentation\n- `answer/types.ts` - Type definitions\n- `answer/utils.ts` - Helper functions\n- `main.tsx` - How endpoints are implemented\n\n",[],[235,626],"7f40d292-b9ca-11f0-8b68-0224a6c84d84",".gitkeep","7f40d350-b9ca-11f0-8b68-0224a6c84d84",53,["D",1762293981787],"# Answer Strategies Directory\n\nThis folder contains RAG (Retrieval-Augmented Generation) strategies for answering questions about Groq documentation.\n\nSee README.md and QUICK-START.md for documentation.\n\n",[],[235,634],["D",1762293980863],[251,252,253,254,255,256,257,258,259],[235],["D",1746217442601],{"_94":93,"_101":97},{"_94":93,"_95":-5,"_96":97,"_18":53,"_98":99,"_100":24},{"_13":83,"_31":84,"_41":40,"_85":42,"_86":-5,"_87":-5,"_88":-5,"_89":-5,"_90":-5,"_91":43,"_92":93},"ctx",{"_76":-5,"_121":681,"_682":683,"_684":685,"_686":24,"_687":24,"_688":24,"_689":47,"_690":-5,"_691":-7,"_692":-7,"_693":60,"_694":24,"_695":24,"_696":-5,"_697":24,"_698":24,"_699":24,"_700":-5},"ENV",{"_652":653,"_654":655,"_656":84,"_657":658,"_659":660,"_661":662,"_663":664,"_665":666,"_667":668,"_669":670,"_671":672,"_673":674,"_675":676,"_677":678,"_679":680},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v76