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",[],[683],{"_104":691,"_95":191,"_155":692,"_157":-5,"_158":140,"_159":693,"_161":22,"_106":694,"_100":695,"_163":176,"_165":696,"_166":22,"_167":-5,"_168":697,"_98":698},"936414fc-b8f1-11f0-92bd-0224a6c84d84","6566e58e-b8e7-11f0-9e62-0224a6c84d84",25,["D",1762200814124],2,"# Groq Docs API\n\nA Hono API server that fetches, caches, and processes Groq documentation pages with token counting and AI-generated metadata.\n\n## Features\n\n- Fetches documentation pages from Groq's console\n- Caches page content, metadata, token counts, and embeddings in SQLite\n- Token counting using tiktoken (GPT-4 encoding)\n- AI-generated metadata (categories, tags, use cases, sample questions)\n- Content embeddings generation (currently fake, ready for Groq API integration)\n- Hash-based change detection to skip unchanged pages during recalculation\n- Rate limiting with async-sema to avoid WAF blocking\n- RESTful API endpoints for accessing pages and managing cache\n- Modular code structure (utils.ts for utilities, groq.ts for Groq API functions)\n\n## First-Time Setup\n\n### 1. Initial Cache Population\n\nOn first run, the cache will be empty. You should populate it by running:\n\n```bash\nGET /cache/recalculate\n```\n\nThis will:\n- Fetch all pages from the URLs list\n- Calculate token counts for each page\n- Generate AI metadata (categories, tags, use cases, questions)\n- Generate embeddings for each page\n- Calculate content hashes for change detection\n- Store everything in the SQLite cache\n- Return a summary of what was cached\n\n**Important**: This will take some time as it processes all pages, generates metadata, and calculates tokens for each. Be patient!\n\n**Note**: On subsequent runs, unchanged pages (detected by content hash) will be automatically skipped unless you use force mode.\n\n### 2. Verify Cache\n\nCheck that the cache was populated:\n\n```bash\nGET /cache/stats\n```\n\nThis returns:\n```json\n{\n \"cachedPages\": 121,\n \"totalTokens\": 1234567\n}\n```\n\n## When to Recalculate\n\nYou should run `/cache/recalculate` in these scenarios:\n\n### ✅ Required Recalculations\n\n1. **First time setup** - Cache is empty\n2. **URL list changes** - You've added or removed URLs from the `urls` array\n3. **Content updates** - Documentation pages have been updated and you want fresh data\n4. **Token count needed** - You need accurate token counts for new content\n5. **Metadata refresh** - You want to regenerate AI metadata or embeddings\n\n### 🔄 Default Mode (Smart Recalculation)\n\nBy default, `/cache/recalculate` uses hash-based change detection:\n\n```bash\nGET /cache/recalculate\n```\n\n**Behavior:**\n- Fetches each page and calculates its content hash (SHA-256)\n- Compares hash with cached version\n- **Skips pages with unchanged content** (saves time and API calls)\n- Only processes pages that have changed\n- Still generates embeddings and metadata for changed pages\n\n**Response includes:**\n- `processed` - Number of pages actually processed\n- `skipped` - Number of pages skipped (unchanged)\n- `force` - Always `false` in default mode\n\n### ⚡ Force Mode (Recalculate Everything)\n\nTo force recalculation of all pages (ignoring hash checks):\n\n```bash\nGET /cache/recalculate?force=true\n```\n\n**Use cases:**\n- Regenerating all metadata/embeddings even if content unchanged\n- After updating metadata generation prompts\n- When you want to ensure everything is fresh\n\n### ⚠️ Partial Updates\n\nFor single page updates, you can use:\n\n```bash\nGET /cache/clear/:path\n```\n\nThis clears the cache for a specific page. The next time that page is requested via `/page/:path`, it will be fetched fresh and recached.\n\n### 🔄 Routine Maintenance\n\n- **Weekly**: Run recalculate (default mode) to catch any documentation updates efficiently\n- **After major docs changes**: Use force mode to regenerate everything\n- **When adding new pages**: Update the `urls` array, then run recalculate\n\n## API Endpoints\n\n### Page Endpoints\n\n#### `GET /page/docs`\nGet the root docs page (cached if available).\n\n#### `GET /page/:path`\nGet a specific page by path. Examples:\n- `/page/api-reference`\n- `/page/agentic-tooling/compound-beta`\n- `/page/model/llama-3.1-8b-instant`\n\n**Response includes:**\n- `url` - The source URL\n- `content` - Full page content with frontmatter\n- `charCount` - Character count\n- `tokenCount` - Token count (calculated with tiktoken)\n- All frontmatter fields flattened (title, description, image, etc.)\n\n**Caching**: Responses are cached. First request fetches and caches, subsequent requests are instant.\n\n#### `GET /list`\nGet a list of all available page paths.\n\n**Response:**\n```json\n[\n \"docs\",\n \"agentic-tooling\",\n \"api-reference\",\n ...\n]\n```\n\n#### `GET /search`\nSearch pages by query string.\n\n**Query Parameters:**\n- `q` (required) - Search query string\n- `limit` (optional) - Maximum number of results (default: 10)\n- `minScore` (optional) - Minimum score threshold (default: 0)\n\n**Example:**\n```bash\nGET /search?q=authentication&limit=5\n```\n\n**Response:**\n```json\n{\n \"query\": \"authentication\",\n \"results\": [\n {\n \"path\": \"api-reference\",\n \"url\": \"https://console.groq.com/docs/api-reference.md\",\n \"title\": \"API Reference\",\n \"score\": 45,\n \"snippet\": \"...authentication tokens are required for all API requests...\"\n },\n {\n \"path\": \"quickstart\",\n \"url\": \"https://console.groq.com/docs/quickstart.md\",\n \"title\": \"Quick Start\",\n \"score\": 32,\n \"snippet\": \"...get your API key for authentication...\"\n }\n ],\n \"totalResults\": 2,\n \"totalPages\": 121\n}\n```\n\n**Search Features:**\n- Keyword matching in titles and content\n- Metadata boost (tags, categories, use cases)\n- Score-based ranking\n- Content snippets around matches\n- Uses cached pages when available for faster results\n\n**Note**: Currently uses keyword-based search. Future versions will use embeddings for semantic search.\n\n#### `GET /data`\nGet metadata for all pages (does not use cache - fetches fresh).\n\n**Response:**\n```json\n{\n \"pages\": [\n {\n \"url\": \"...\",\n \"charCount\": 1234,\n \"frontmatter\": {...}\n }\n ],\n \"contents\": [...],\n \"totalPages\": 121,\n \"totalChars\": 1234567\n}\n```\n\n### Cache Management Endpoints\n\n#### `GET /cache/stats`\nGet cache statistics.\n\n**Response:**\n```json\n{\n \"cachedPages\": 121,\n \"totalTokens\": 1234567\n}\n```\n\n#### `GET /cache/clear`\nClear the entire cache.\n\n**Response:**\n```json\n{\n \"message\": \"Cache cleared\",\n \"success\": true\n}\n```\n\n#### `GET /cache/clear/:path`\nClear cache for a specific page.\n\n**Example:**\n```bash\nGET /cache/clear/api-reference\n```\n\n**Response:**\n```json\n{\n \"message\": \"Cache cleared for api-reference\",\n \"success\": true\n}\n```\n\n#### `GET /cache/recalculate`\nRecalculate pages with AI metadata and embeddings generation.\n\n**Query Parameters:**\n- `force` (optional): Set to `true` to force recalculation of all pages, ignoring hash checks\n\n**Default Mode** (no query params):\n```bash\nGET /cache/recalculate\n```\n\n**Force Mode**:\n```bash\nGET /cache/recalculate?force=true\n```\n\n**Response** (Default Mode):\n```json\n{\n \"message\": \"Recalculated 5 pages, skipped 116 unchanged pages\",\n \"results\": [\n {\n \"path\": \"api-reference\",\n \"url\": \"https://console.groq.com/docs/api-reference.md\",\n \"charCount\": 1234,\n \"tokenCount\": 567,\n \"title\": \"API Reference\",\n \"metadata\": {\n \"categories\": [\"API\", \"Reference\"],\n \"tags\": [\"api\", \"endpoints\", \"rest\"],\n \"useCases\": [\"Integrating with Groq API\"],\n \"questions\": [\"How do I authenticate?\", \"What endpoints are available?\"]\n }\n },\n {\n \"path\": \"docs\",\n \"skipped\": true,\n \"reason\": \"Content unchanged (hash matches)\"\n }\n ],\n \"totalPages\": 121,\n \"processed\": 5,\n \"skipped\": 116,\n \"withMetadata\": 5,\n \"withoutMetadata\": 0,\n \"cached\": true,\n \"force\": false\n}\n```\n\n**Response** (Force Mode):\n```json\n{\n \"message\": \"Recalculated 121 pages with AI metadata (force mode)\",\n \"results\": [...],\n \"totalPages\": 121,\n \"processed\": 121,\n \"skipped\": 0,\n \"force\": true\n}\n```\n\n**What it does:**\n- Fetches all pages (or skips unchanged ones in default mode)\n- Calculates token counts\n- Generates AI metadata (categories, tags, use cases, questions)\n- Generates embeddings (currently fake, ready for Groq API)\n- Calculates content hashes for change detection\n- Stores everything in cache\n\n**Important**: This can take several minutes depending on:\n- Number of pages to process (skipped pages are fast)\n- Network speed\n- Token calculation time\n- AI metadata generation time (uses Groq API)\n\n## Cache Behavior\n\n### How Caching Works\n\n1. **First Request**: \n - Check cache → Not found\n - Fetch from URL\n - Calculate tokens\n - Store in cache\n - Return data\n\n2. **Subsequent Requests**:\n - Check cache → Found\n - Return cached data immediately\n\n### Cache Storage\n\nCache is stored in SQLite with the following schema:\n\n```sql\nCREATE TABLE groq_docs_cache_v3 (\n url TEXT PRIMARY KEY,\n content TEXT NOT NULL,\n charCount INTEGER NOT NULL,\n tokenCount INTEGER,\n frontmatter TEXT NOT NULL,\n metadata TEXT,\n contentHash TEXT,\n embeddings TEXT,\n cachedAt INTEGER NOT NULL\n)\n```\n\n**Fields:**\n- `url` - Source URL (primary key)\n- `content` - Full page content with frontmatter\n- `charCount` - Character count\n- `tokenCount` - Token count (calculated with tiktoken)\n- `frontmatter` - Parsed frontmatter (JSON)\n- `metadata` - AI-generated metadata (categories, tags, use cases, questions)\n- `contentHash` - SHA-256 hash of content (for change detection)\n- `embeddings` - Content embeddings vector (JSON array)\n- `cachedAt` - Timestamp when cached\n\n### Cache Invalidation\n\nCache is invalidated when:\n- You manually clear it via `/cache/clear`\n- You recalculate via `/cache/recalculate`\n- Cache is cleared for a specific page via `/cache/clear/:path`\n\n**Note**: Cache does NOT automatically expire. If documentation changes, you must manually recalculate.\n\n## Adding New Pages\n\n1. **Add URL to the `urls` array** in `main.tsx`:\n ```typescript\n const urls = [\n // ... existing URLs\n \"https://console.groq.com/docs/new-page.md\",\n ];\n ```\n\n2. **Run recalculate**:\n ```bash\n POST /cache/recalculate\n ```\n\n3. **Verify**:\n ```bash\n GET /cache/stats\n GET /list # Should include your new page\n ```\n\n## Token Counting\n\nToken counts are calculated using [tiktoken](https://github.com/openai/tiktoken) with the `gpt-4` encoding (cl100k_base). This is the same encoding used by:\n- GPT-4\n- GPT-3.5-turbo\n- Many other OpenAI models\n\nToken counts are:\n- Calculated on first fetch\n- Stored in cache\n- Returned in API responses\n- Expensive to compute (which is why caching is important)\n\n## AI Metadata Generation\n\nEach page can have AI-generated metadata using Groq's chat completions API:\n\n- **Categories**: 2-4 broad categories (e.g., \"API\", \"Authentication\", \"Models\")\n- **Tags**: 5-10 specific tags/keywords\n- **Use Cases**: 2-4 practical use cases or scenarios\n- **Questions**: 5-10 questions users might ask\n\nMetadata is generated during `/cache/recalculate` and stored in the cache.\n\n## Search\n\nThe API includes a search endpoint (`/search`) that allows you to search across all documentation pages.\n\n### Current Implementation (Keyword-Based)\n\nCurrently uses keyword matching:\n- Searches in page titles and content\n- Boosts results matching metadata (tags, categories, use cases)\n- Returns ranked results with relevance scores\n- Includes content snippets around matches\n\n### Future Implementation (Semantic Search)\n\nThe search system is designed to support embeddings-based semantic search:\n- `generateEmbeddings()` - Generates embeddings (currently fake, ready for real API)\n- `vectorSearch()` - Vector similarity search function (ready to use when embeddings are real)\n- Will enable semantic understanding of queries (not just keyword matching)\n\n## Embeddings\n\nContent embeddings are generated for each page. Currently using a fake implementation (deterministic 384-dimensional vectors) that's ready to be replaced with actual embeddings API when available.\n\nEmbeddings are:\n- Generated during recalculation\n- Stored in cache\n- Will be used for semantic search and similarity matching (currently using keyword search)\n\n## Hash-Based Change Detection\n\nContent hashes (SHA-256) are calculated and stored for each page. This enables:\n\n- **Smart recalculation**: Skip unchanged pages automatically\n- **Efficient updates**: Only process pages that have actually changed\n- **Performance**: Significantly faster recalculation when most content is unchanged\n\nHashes are compared during `/cache/recalculate` (default mode) to determine if a page needs reprocessing.\n\n## Troubleshooting\n\n### Cache seems stale\nRun `/cache/recalculate` to refresh everything.\n\n### Page not found\n1. Check `/list` to see if the path exists\n2. Verify the URL is in the `urls` array\n3. Ensure the path matches the URL structure (e.g., `api-reference` for `/docs/api-reference.md`)\n\n### Token counts seem wrong\n1. Clear cache for that page: `POST /cache/clear/:path`\n2. Request the page again: `GET /page/:path`\n3. Or recalculate everything: `POST /cache/recalculate`\n\n### Performance issues\n- Use `/page/:path` endpoints (cached) instead of `/data` (uncached)\n- Check cache stats: `GET /cache/stats`\n- Ensure cache is populated before production use\n\n## Code Structure\n\nThe codebase is organized into modular files:\n\n- **`main.tsx`** - Main Hono app, routes, and URL definitions\n- **`utils.ts`** - Utility functions:\n - Cache management (getFromCache, setCache, clearCache, getCacheStats)\n - Content fetching (getTextFromUrl)\n - Frontmatter parsing (parseFrontmatter, addUrlSourceToFrontmatter)\n - Token counting (calculateTokenCount)\n - Hash calculation (calculateContentHash)\n - Rate limiting for fetches\n- **`groq.ts`** - Groq API functions:\n - Chat completions (groqChatCompletion)\n - Metadata generation (generatePageMetadata)\n- **`search.ts`** - Search and embeddings utilities:\n - Embeddings generation (generateEmbeddings) - fake implementation ready for real API\n - Search functions (searchPages) - keyword-based search (will use embeddings later)\n - Vector similarity search (vectorSearch) - ready for embeddings-based search\n\n## Development\n\n### Local Development\n\n```bash\ndeno run --allow-net --allow-env main.tsx\n```\n\n**Note**: SQLite caching is automatically disabled when running locally (detected via `valtown` environment variable). The app will work without caching, but cache-related endpoints will return appropriate messages.\n\n### Val Town\n\nThe app is configured to work with Val Town. Export uses:\n```typescript\nexport default (typeof Deno !== \"undefined\" && Deno.env.get(\"valtown\")) ? app.fetch : app;\n```\n\nSQLite caching is automatically enabled when running in Val Town (detected via `valtown` environment variable).\n\n### Environment Variables\n\n- `GROQ_API_KEY` - Required for AI metadata generation (optional, will disable metadata if not set)\n- `valtown` - Automatically set by Val Town (detects environment)\n\n## Performance Tips\n\n1. **Use default recalculate mode** - Automatically skips unchanged pages\n2. **Cache is your friend** - Always populate cache before production use\n3. **Rate limiting** - Built-in rate limiting prevents WAF blocking (1 request per 3 seconds for docs, 2 requests per second for Groq API)\n4. **Hash checking** - Default recalculation mode is much faster when most content is unchanged\n\n",[],[191],{"_104":700,"_95":701,"_155":702,"_157":-5,"_158":140,"_159":101,"_161":110,"_106":703,"_100":704,"_163":176,"_165":705,"_166":22,"_167":-5,"_168":706,"_98":707},"808c02b6-b9ca-11f0-9b64-0224a6c84d84","deno.json","656e5404-b8e7-11f0-a061-0224a6c84d84",["D",1762293983950],3,"{\n \"tasks\": {\n \"serve\": \"deno serve --allow-net --allow-import --allow-read --allow-write --allow-env main.tsx\",\n \"recalc\": \"deno run --allow-ffi --allow-net --allow-import --allow-read --allow-write --allow-env testing/recalculate.ts\",\n \"recalc-force\": \"deno run --allow-ffi --allow-net --allow-import --allow-read --allow-write --allow-env testing/recalculate.ts --force\",\n \"recalc-mxbai\": \"deno run --allow-net --allow-import --allow-read --allow-write --allow-env testing/recalculate-mixedbread.ts\",\n \"recalc-mxbai-force\": \"deno run --allow-net --allow-import --allow-read --allow-write --allow-env testing/recalculate-mixedbread.ts --force\",\n \"search\": \"deno run --allow-ffi --allow-net --allow-import --allow-read --allow-write --allow-env testing/test-search.ts\",\n \"answer\": \"deno run --allow-ffi --allow-net --allow-import --allow-read --allow-write --allow-env testing/test-answer.ts\"\n },\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/98f62cee78e85bfc47c62ed703777c6bc8794f1c/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": true,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"include\": [\"deno:/https/esm.town/**/*\"],\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n }\n}",[],[701],{"_104":709,"_95":710,"_155":711,"_157":-5,"_158":140,"_159":712,"_161":110,"_106":713,"_100":32,"_163":213,"_165":714,"_166":22,"_167":-5,"_168":715,"_98":716},"9315b67c-b8f1-11f0-85fe-0224a6c84d84","groq.ts","9315b744-b8f1-11f0-85fe-0224a6c84d84",23,["D",1762200814266],"import { RateLimit } from \"npm:async-sema@latest\";\n\n// Groq API Configuration\nconst GROQ_API_KEY = Deno.env.get(\"GROQ_API_KEY\");\nconst GROQ_API_URL = \"https://api.groq.com/openai/v1/chat/completions\";\n\n// Rate limiter for Groq API: 2 requests per second to avoid rate limits\nconst groqApiRateLimiter = RateLimit(2);\n\n// Groq Chat Completions Utility\nexport const groqChatCompletion = async (messages: Array<{ role: string; content: string }>, options: {\n model?: string;\n temperature?: number;\n max_tokens?: number;\n response_format?: { type: string };\n} = {}) => {\n if (!GROQ_API_KEY) {\n console.warn(\"GROQ_API_KEY not found - AI metadata generation disabled\");\n return null;\n }\n\n // Rate limit Groq API calls\n await groqApiRateLimiter();\n\n try {\n const response = await fetch(GROQ_API_URL, {\n method: \"POST\",\n headers: {\n \"Authorization\": `Bearer ${GROQ_API_KEY}`,\n \"Content-Type\": \"application/json\",\n },\n body: JSON.stringify({\n model: options.model || \"llama-3.3-70b-versatile\",\n messages,\n temperature: options.temperature ?? 0.4,\n // max_tokens: options.max_tokens ?? 1024,\n ...(options.response_format && { response_format: options.response_format }),\n }),\n });\n\n if (!response.ok) {\n const errorText = await response.text().catch(() => response.statusText);\n throw new Error(`Groq API error: ${response.status} ${response.statusText} - ${errorText.substring(0, 200)}`);\n }\n\n const data = await response.json();\n return data.choices[0]?.message?.content || null;\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n console.error(\"Groq API call failed:\", errorMessage);\n // Don't throw - return null so metadata generation doesn't break the whole process\n return null;\n }\n};\n\n// Generate AI metadata for a page\nexport const generatePageMetadata = async (content: string, title: string) => {\n const prompt = `Analyze this documentation page and provide metadata in JSON format.\n\nPage Title: ${title}\n\nContent:\n${content.substring(0, 4000)} ${content.length > 4000 ? '...(truncated)' : ''}\n\nGenerate the following metadata:\n1. categories: Array of 2-4 broad categories (e.g., \"API\", \"Authentication\", \"Models\", \"Integration\")\n2. tags: Array of 5-10 specific tags/keywords\n3. useCases: Array of 2-4 practical use cases or scenarios when this page would be helpful\n4. questions: Array of 5-10 questions users might ask that this page answers\n\nReturn ONLY valid JSON in this exact format:\n{\n \"categories\": [\"Category1\", \"Category2\"],\n \"tags\": [\"tag1\", \"tag2\", \"tag3\"],\n \"useCases\": [\"Use case 1\", \"Use case 2\"],\n \"questions\": [\"Question 1?\", \"Question 2?\"]\n}`;\n\n const response = await groqChatCompletion([\n { role: \"user\", content: prompt }\n ], {\n model: \"llama-3.3-70b-versatile\",\n temperature: 0.3,\n max_tokens: 1024,\n });\n\n if (!response) {\n return null;\n }\n\n try {\n // Extract JSON from response (in case it's wrapped in markdown)\n const jsonMatch = response.match(/\\{[\\s\\S]*\\}/);\n if (jsonMatch) {\n return JSON.parse(jsonMatch[0]);\n }\n return JSON.parse(response);\n } catch (error) {\n console.error(\"Failed to parse AI metadata:\", error);\n return null;\n }\n};\n\n",[],[710],{"_104":718,"_95":719,"_155":117,"_157":-5,"_158":140,"_159":720,"_161":110,"_106":721,"_100":722,"_163":723,"_165":724,"_166":22,"_167":725,"_168":726,"_98":727},"807b7306-b9ca-11f0-83d0-0224a6c84d84","main.tsx",91,["D",1762293983847],15,"http","import { Hono } from \"https://deno.land/x/hono@v3.11.7/mod.ts\";\nimport \"jsr:@std/dotenv/load\";\nimport {\n IS_VALTOWN,\n getFromCache,\n setCache,\n clearCache,\n getCacheStats,\n getTextFromUrl,\n parseFrontmatter,\n addUrlSourceToFrontmatter,\n calculateTokenCount,\n calculateContentHash,\n} from \"./utils.ts\";\nimport { generatePageMetadata } from \"./groq.ts\";\nimport { searchPages, getActiveEmbeddingsFunction, type Page } from \"./search/index.ts\";\nimport { answerQuestion, answerStrategy } from \"./answer/index.ts\";\nimport { urls } from \"./urls.ts\";\n\nconst app = new Hono();\n\n\n\n\n\n\nconst getPageContent = async () => {\n const promises = urls.map(async url => {\n const text = await getTextFromUrl(url);\n return addUrlSourceToFrontmatter(text, url);\n });\n const texts = await Promise.all(promises);\n return texts.join(\"\\n\\n\");\n};\n\nconst getPageData = async () => {\n const pageData = await Promise.all(\n urls.map(async (url) => {\n // Check if cached\n const cached = await getFromCache(url);\n let text, processedText, charCount, frontmatter, wasCached;\n \n let metadata = null;\n \n if (cached) {\n // Use cached data\n text = cached.content;\n processedText = cached.content;\n charCount = cached.charCount;\n frontmatter = cached.frontmatter;\n metadata = cached.metadata;\n wasCached = true;\n } else {\n // Fetch fresh\n text = await getTextFromUrl(url);\n processedText = addUrlSourceToFrontmatter(text, url);\n charCount = processedText.length;\n frontmatter = parseFrontmatter(processedText);\n wasCached = false;\n }\n \n // Extract urlSource and rename it to url, then flatten remaining frontmatter properties\n const urlSource = (frontmatter as any).urlSource;\n const restFrontmatter = { ...frontmatter };\n delete (restFrontmatter as any).urlSource;\n \n return {\n url: urlSource || url, // Use urlSource from frontmatter, fallback to url\n content: processedText,\n charCount,\n cached: wasCached,\n ...restFrontmatter, // Flatten frontmatter properties\n ...(metadata || {}), // Include AI-generated metadata if available\n };\n })\n );\n \n return {\n pages: pageData,\n totalPages: pageData.length,\n totalChars: pageData.reduce((sum, { charCount }) => sum + charCount, 0),\n cachedPages: pageData.filter(({ cached }) => cached).length,\n };\n};\n\napp.get(\"/\", async (c) => {\n const content = await getPageContent();\n return c.text(content);\n});\n\napp.get(\"/data\", async (c) => {\n const data = await getPageData();\n \n // Extract page paths/names (same logic as /list endpoint)\n const pagePaths = urls.map(url => {\n const match = url.match(/\\/docs\\/(.+?)\\.md$/);\n if (match) {\n return match[1];\n }\n if (url.endsWith(\"/docs.md\")) {\n return \"docs\";\n }\n return null;\n }).filter(path => path !== null);\n \n // Return metadata first, then the large data object\n return c.json({\n metadata: {\n urls: pagePaths,\n },\n ...data,\n });\n});\n\napp.get(\"/list\", async (c) => {\n const paths = urls.map(url => {\n // Extract the path part after /docs/ and remove .md extension\n const match = url.match(/\\/docs\\/(.+?)\\.md$/);\n if (match) {\n return match[1];\n }\n // Handle the case where URL is just /docs.md - return \"docs\"\n if (url.endsWith(\"/docs.md\")) {\n return \"docs\";\n }\n return null;\n }).filter(path => path !== null);\n \n return c.json(paths);\n});\n\n// Helper function to load data from latest.json (for local development)\nasync function loadLatestJsonForSearch(): 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 \n // Use fast-json for faster parsing (only extracts what we need)\n const { parseLatestJson } = await import(\"./utils/json-parser.ts\");\n const data = await parseLatestJson(latestData, { enableTiming: false });\n \n const cacheMap: Record = {};\n \n if (data.results && Array.isArray(data.results)) {\n for (const result of data.results) {\n if (result.url) { // fast-json already filters skipped/error entries\n cacheMap[result.url] = {\n title: result.title,\n embeddings: result.embeddings || null,\n metadata: result.metadata || null,\n };\n }\n }\n }\n \n return cacheMap;\n } catch {\n return null;\n }\n}\n\n// Helper function to get all pages for searching\n// IMPORTANT: This ONLY uses cached data (JSON locally, SQLite on Val Town)\n// It NEVER fetches live data - that's what recalculate is for!\n// Run `deno task recalculate` to populate the cache before searching.\nexport const getAllPagesForSearch = async (enableTiming: boolean = false): Promise => {\n const timings: Record = {};\n const startTime = performance.now();\n \n // Load JSON cache when running locally (Val Town uses SQLite instead)\n const jsonCacheStart = performance.now();\n const jsonCache = await loadLatestJsonForSearch();\n if (enableTiming) {\n timings.jsonCacheLoad = performance.now() - jsonCacheStart;\n if (IS_VALTOWN) {\n // On Val Town, JSON cache is skipped (uses SQLite instead)\n timings.jsonCacheLoad = 0;\n }\n }\n \n const pageDataStart = performance.now();\n const uncachedUrls: string[] = [];\n \n const pageData: (Page | null)[] = await Promise.all(\n urls.map(async (url): Promise => {\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 return null;\n }\n \n // Try to get from SQLite cache first (Val Town)\n const cached = await getFromCache(url);\n \n if (cached) {\n const frontmatter = cached.frontmatter;\n // On Val Town, SQLite cache already has everything we need\n // Content is available, embeddings are available - no need to fetch!\n return {\n path,\n url: cached.frontmatter?.urlSource || url,\n content: cached.content, // Already cached in SQLite, no fetch needed!\n title: frontmatter?.title || path,\n embeddings: cached.embeddings, // Already cached in SQLite\n metadata: cached.metadata,\n };\n }\n \n // If not in SQLite, try JSON cache (when running locally)\n if (jsonCache && jsonCache[url]) {\n const jsonData = jsonCache[url];\n // JSON cache has embeddings, title, metadata from recalculate\n // We skip fetching content to speed up search - content is only for snippets\n // NO NETWORK CALLS - everything is from the JSON cache!\n if (jsonData.embeddings && Array.isArray(jsonData.embeddings) && jsonData.embeddings.length > 0) {\n // Use cached data - NO network fetch! This is why it's fast (was 6.5s, now 0.16ms)\n return {\n path,\n url: url,\n content: '', // Skipped - only needed for snippets, can fetch lazily if needed\n title: jsonData.title || path,\n embeddings: jsonData.embeddings, // From JSON cache (from recalculate)\n metadata: jsonData.metadata || null,\n };\n } else {\n // Missing embeddings - this shouldn't happen if recalculate ran successfully\n uncachedUrls.push(url);\n }\n } else {\n // Not in cache at all!\n uncachedUrls.push(url);\n }\n \n // If not cached anywhere OR cached data has no embeddings, skip it\n // (search requires embeddings to work, and we NEVER fetch live data - that's the point!)\n return null;\n })\n );\n if (enableTiming) timings.pageDataLoad = performance.now() - pageDataStart;\n \n // Filter out nulls\n const filterStart = performance.now();\n const filtered = pageData.filter((p): p is Page => p !== null);\n if (enableTiming) timings.filter = performance.now() - filterStart;\n \n if (enableTiming) {\n timings.total = performance.now() - startTime;\n console.log(`⏱️ getAllPagesForSearch:`);\n if (IS_VALTOWN) {\n console.log(` SQLite cache load: ${timings.jsonCacheLoad?.toFixed(2)}ms (Val Town - using SQLite)`);\n } else if (timings.jsonCacheLoad) {\n console.log(` JSON cache load (local): ${timings.jsonCacheLoad.toFixed(2)}ms`);\n }\n console.log(` Page data load: ${timings.pageDataLoad?.toFixed(2)}ms`);\n console.log(` Filter: ${timings.filter?.toFixed(2)}ms`);\n console.log(` Total: ${timings.total.toFixed(2)}ms`);\n \n if (uncachedUrls.length > 0) {\n console.warn(` ⚠️ ${uncachedUrls.length} pages not in cache (skipped): ${uncachedUrls.slice(0, 3).join(', ')}${uncachedUrls.length > 3 ? '...' : ''}`);\n console.warn(` 💡 Run 'deno task recalculate' to populate cache`);\n }\n }\n \n return filtered;\n};\n\n// Search endpoint - uses active strategy from search/index.ts\napp.get(\"/search\", async (c) => {\n const query = c.req.query(\"q\");\n const limit = parseInt(c.req.query(\"limit\") || \"10\");\n const minScore = parseFloat(c.req.query(\"minScore\") || \"0\");\n \n if (!query) {\n return c.json({ error: \"Query parameter 'q' is required\" }, 400);\n }\n \n const validPages = await getAllPagesForSearch();\n \n // Perform search using active strategy\n const results = await searchPages(query, validPages, {\n limit,\n minScore,\n });\n \n return c.json({\n query,\n results,\n totalResults: results.length,\n totalPages: validPages.length,\n });\n});\n\n// Test search endpoint - runs test queries against active search strategy\napp.get(\"/search/test\", async (c) => {\n try {\n // Import test utilities and get active strategy info\n const { runSearchTest } = await import(\"./testing/search-harness.ts\");\n const { questions } = await import(\"./testing/questions.ts\");\n const { searchStrategy } = await import(\"./search/index.ts\");\n \n const validPages = await getAllPagesForSearch();\n const testQueries = questions;\n \n const testResults: Array<{\n query: string;\n results: Array<{\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 durationMs: number;\n resultCount: number;\n error?: string;\n }> = [];\n \n for (const query of testQueries) {\n const testResult = await runSearchTest(query, validPages, {\n limit: 10,\n minScore: 0,\n enableTiming: true,\n });\n \n testResults.push({\n query,\n results: testResult.results.map(r => ({\n path: r.path,\n url: r.url,\n title: r.title,\n score: r.score,\n snippet: r.snippet?.substring(0, 200) || '', // Limit snippet length\n metadata: r.metadata,\n })),\n durationMs: testResult.durationMs,\n resultCount: testResult.results.length,\n error: testResult.error || undefined,\n });\n }\n \n return c.json({\n strategy: {\n name: searchStrategy.name,\n description: searchStrategy.description,\n },\n totalQueries: testQueries.length,\n totalPages: validPages.length,\n tests: testResults,\n summary: {\n totalDurationMs: testResults.reduce((sum, t) => sum + t.durationMs, 0),\n avgDurationMs: testResults.reduce((sum, t) => sum + t.durationMs, 0) / testResults.length,\n totalResults: testResults.reduce((sum, t) => sum + t.resultCount, 0),\n errors: testResults.filter(t => t.error).length,\n },\n });\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n return c.json({ \n error: \"Test search failed\", \n message: errorMessage \n }, 500);\n }\n});\n\n// Answer endpoint - uses active answer strategy with RAG (search + LLM)\napp.get(\"/answer\", async (c) => {\n const query = c.req.query(\"q\");\n const limit = parseInt(c.req.query(\"limit\") || \"10\");\n const minScore = parseFloat(c.req.query(\"minScore\") || \"0\");\n const maxContextPages = parseInt(c.req.query(\"maxContextPages\") || \"5\");\n const temperature = parseFloat(c.req.query(\"temperature\") || \"0.3\");\n const model = c.req.query(\"model\");\n \n if (!query) {\n return c.json({ error: \"Query parameter 'q' is required\" }, 400);\n }\n \n try {\n // Generate answer using active strategy\n const result = await answerQuestion(query, {\n limit,\n minScore,\n maxContextPages,\n temperature,\n ...(model && { model }),\n enableTiming: true,\n });\n \n return c.json(result);\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n return c.json({ \n error: \"Answer generation failed\", \n message: errorMessage \n }, 500);\n }\n});\n\n// Answer info endpoint - returns information about the active answer strategy\napp.get(\"/answer/info\", async (c) => {\n return c.json({\n strategy: {\n name: answerStrategy.name,\n description: answerStrategy.description,\n },\n defaultOptions: {\n model: \"llama-3.3-70b-versatile\",\n temperature: 0.3,\n maxContextPages: 5,\n },\n availableParams: {\n q: \"Query string (required)\",\n limit: \"Max search results to consider (default: 10)\",\n minScore: \"Minimum search score threshold (default: 0)\",\n maxContextPages: \"Max pages to include in LLM context (default: 5)\",\n temperature: \"LLM temperature (default: 0.3)\",\n model: \"Override LLM model (optional)\",\n },\n });\n});\n\n// Test answer endpoint - runs test queries against active answer strategy\napp.get(\"/answer/test\", async (c) => {\n try {\n // Import test utilities\n const { runAnswerTest } = await import(\"./testing/answer-harness.ts\");\n const { questions } = await import(\"./testing/questions.ts\");\n \n const testQueries = questions;\n \n const testResults: Array<{\n query: string;\n answer: string;\n searchResults: Array<{\n path: string;\n url: string;\n title?: string;\n score: number;\n }>;\n contextUsed: number;\n totalTokens?: number;\n durationMs: number;\n timings?: Record;\n error?: string;\n }> = [];\n \n for (const query of testQueries) {\n const testResult = await runAnswerTest(query, {\n limit: 10,\n minScore: 0,\n maxContextPages: 5,\n temperature: 0.3,\n });\n \n testResults.push({\n query,\n ...testResult,\n });\n }\n \n // Calculate summary statistics\n const avgTimings = testResults.reduce((acc, t) => {\n if (t.timings) {\n acc.search += t.timings.search || 0;\n acc.contextPrep += t.timings.contextPrep || 0;\n acc.llm += t.timings.llm || 0;\n acc.total += t.timings.total || 0;\n acc.count++;\n }\n return acc;\n }, { search: 0, contextPrep: 0, llm: 0, total: 0, count: 0 });\n \n const avgCount = avgTimings.count || 1;\n \n return c.json({\n strategy: {\n name: answerStrategy.name,\n description: answerStrategy.description,\n },\n totalQueries: testQueries.length,\n tests: testResults,\n summary: {\n totalDurationMs: testResults.reduce((sum, t) => sum + t.durationMs, 0),\n avgDurationMs: testResults.reduce((sum, t) => sum + t.durationMs, 0) / testResults.length,\n avgSearchMs: avgTimings.search / avgCount,\n avgContextPrepMs: avgTimings.contextPrep / avgCount,\n avgLlmMs: avgTimings.llm / avgCount,\n avgTotalMs: avgTimings.total / avgCount,\n totalContextUsed: testResults.reduce((sum, t) => sum + t.contextUsed, 0),\n totalTokens: testResults.reduce((sum, t) => sum + (t.totalTokens || 0), 0),\n errors: testResults.filter(t => t.error).length,\n },\n });\n } catch (error) {\n const errorMessage = error instanceof Error ? error.message : String(error);\n return c.json({ \n error: \"Test answer failed\", \n message: errorMessage \n }, 500);\n }\n});\n\nconst getPageByPath = async (pathParam: string, useCache: boolean = true) => {\n // Find the matching URL\n const matchingUrl = urls.find(url => {\n // Extract the path part after /docs/ and remove .md extension\n const match = url.match(/\\/docs\\/(.+?)\\.md$/);\n if (match) {\n return match[1] === pathParam;\n }\n // Handle the case where URL is just /docs.md and pathParam is \"docs\"\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 // Extract urlSource and rename it to url, then flatten remaining frontmatter properties\n const urlSource = (cached.frontmatter as any).urlSource;\n const restFrontmatter = { ...cached.frontmatter };\n delete (restFrontmatter as any).urlSource;\n \n return {\n url: urlSource || matchingUrl,\n content: cached.content,\n charCount: cached.charCount,\n tokenCount: cached.tokenCount,\n cached: true,\n ...restFrontmatter,\n ...(cached.metadata || {}), // Include AI-generated metadata if available\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 const frontmatter = parseFrontmatter(processedText);\n \n // Cache the result (without metadata for now - generated during recalculate)\n if (useCache) {\n // Wrap in additional error handling to ensure it never throws\n try {\n await setCache(matchingUrl, {\n content: processedText,\n charCount,\n tokenCount,\n frontmatter,\n });\n } catch (error) {\n // Double safety - setCache should already catch, but just in case\n console.debug(\"Cache write error (ignored):\", error instanceof Error ? error.message.substring(0, 100) : String(error).substring(0, 100));\n }\n }\n \n // Extract urlSource and rename it to url, then flatten remaining frontmatter properties\n const urlSource = (frontmatter as any).urlSource;\n const restFrontmatter = { ...frontmatter };\n delete (restFrontmatter as any).urlSource;\n \n return {\n url: urlSource || matchingUrl, // Use urlSource from frontmatter, fallback to matchingUrl\n content: processedText,\n charCount,\n tokenCount,\n cached: false,\n ...restFrontmatter,\n };\n};\n\napp.get(\"/page/docs\", async (c) => {\n // Handle root docs case\n const pageData = await getPageByPath(\"docs\");\n if (!pageData) {\n return c.json({ error: \"Page not found\" }, 404);\n }\n return c.json(pageData);\n});\n\napp.get(\"/page/*\", async (c) => {\n // Get the path from the URL (everything after /page/)\n const urlPath = new URL(c.req.url).pathname;\n const pathParam = urlPath.replace(\"/page/\", \"\") || \"\";\n \n const pageData = await getPageByPath(pathParam);\n if (!pageData) {\n return c.json({ error: \"Page not found\" }, 404);\n }\n return c.json(pageData);\n});\n\n// Cache management endpoints (all GET for browser access)\napp.get(\"/cache/stats\", async (c) => {\n const stats = await getCacheStats();\n return c.json(stats);\n});\n\napp.get(\"/cache/clear\", async (c) => {\n try {\n await clearCache();\n return c.json({ message: \"Cache cleared\", success: true });\n } catch (error) {\n return c.json({ \n message: \"Cache unavailable (caching disabled)\", \n success: false,\n error: \"SQLite not available - caching disabled\" \n });\n }\n});\n\napp.get(\"/cache/clear/:path\", async (c) => {\n const pathParam = c.req.param(\"path\");\n \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 c.json({ error: \"Page not found\" }, 404);\n }\n \n try {\n await clearCache(matchingUrl);\n return c.json({ message: `Cache cleared for ${pathParam}`, success: true });\n } catch (error) {\n return c.json({ \n message: `Cache unavailable for ${pathParam} (caching disabled)`, \n success: false,\n error: \"SQLite not available - caching disabled\" \n });\n }\n});\n\napp.get(\"/cache/recalculate\", async (c) => {\n // Check for force mode (bypass hash checking)\n const force = c.req.query(\"force\") === \"true\";\n \n // Recalculate all pages (bypass cache) with AI metadata generation\n const results: Array<{ \n path: string; \n url: string; \n charCount: number; \n tokenCount: number | undefined;\n title?: string;\n metadata?: any;\n error?: string;\n cacheError?: string;\n skipped?: boolean;\n reason?: string;\n }> = [];\n \n let processedCount = 0;\n let skippedCount = 0;\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 const cached = await getFromCache(url);\n if (cached && cached.contentHash) {\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 === cached.contentHash) {\n shouldSkip = true;\n skippedCount++;\n console.log(` Skipped ${path} (content unchanged, hash: ${newHash.substring(0, 8)}...)`);\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 skipped: true,\n reason: \"Content unchanged (hash matches)\",\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 (rate limiting handled by async-sema)\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 (failures are handled inside generatePageMetadata)\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 const embeddings = await generateEmbeddings(pageData.content);\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, // Include full metadata in results\n ...(cacheError && { cacheError }), // Include cache error if present\n });\n \n if (cacheError) {\n console.warn(`Completed ${path} (metadata: ${metadata ? 'yes' : 'no'}, embeddings: ${embeddings ? 'yes' : 'no'}, cache error: ${cacheError})`);\n } else {\n console.log(`Completed ${path} (metadata: ${metadata ? 'yes' : 'no'}, embeddings: ${embeddings ? 'yes' : 'no'}, 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 return c.json({\n message: force \n ? `Recalculated ${processedResults.length} pages with AI metadata (force mode)` \n : `Recalculated ${processedResults.length} pages, skipped ${skippedCount} unchanged pages`,\n results, // Now includes full metadata for each page\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, // True if all pages cached successfully\n cacheErrors: cacheErrors.length > 0 ? cacheErrors.map(r => ({ path: r.path, error: r.cacheError })) : undefined,\n force,\n });\n});\n\n// Helper function to save test data to /data/mm-dd-yyyy.json and /data/latest.json\nexport const saveTestData = async (data: any, customDate?: Date) => {\n const date = customDate || new Date();\n const month = String(date.getMonth() + 1).padStart(2, '0');\n const day = String(date.getDate()).padStart(2, '0');\n const year = date.getFullYear();\n const filename = `${month}-${day}-${year}.json`;\n const datedFilepath = `./data/${filename}`;\n const latestFilepath = `./data/latest.json`;\n \n try {\n // Ensure data directory exists\n try {\n await Deno.mkdir(\"./data\", { recursive: true });\n } catch {\n // Directory already exists, ignore\n }\n \n const jsonData = JSON.stringify(data, null, 2);\n \n // Write both files\n await Deno.writeTextFile(datedFilepath, jsonData);\n await Deno.writeTextFile(latestFilepath, jsonData);\n \n console.log(`Data saved to ${datedFilepath} and ${latestFilepath}`);\n return { datedFilepath, latestFilepath };\n } catch (error) {\n console.error(`Failed to save test data:`, error);\n throw error;\n }\n};\n\nexport default (typeof Deno !== \"undefined\" && Deno.env.get(\"valtown\")) ? app.fetch : app;\n","groqdocs",[],[719],{"_104":729,"_95":730,"_155":731,"_157":-5,"_158":140,"_159":732,"_161":22,"_106":733,"_100":734,"_163":176,"_165":735,"_166":22,"_167":-5,"_168":736,"_98":737},"31eadcc8-b901-11f0-9996-0224a6c84d84","todo.md","7ebe7d74-b8ee-11f0-bdd9-0224a6c84d84",47,["D",1762207522872],1,"\n## todos\n- [ ] markdown endpoint\n- [ ] pre-calculate metadata around each markdown page\n- [ ] pre-calculate complex question query q&a pairs that map to various pages and categories\n\n\n## future\n- [ ] (Ben) can we have a blind eval ranker - aka we show the two results side by side and you pick A or B and do this like 20 times, then it shows you which one ranked better",[],[730],{"_104":739,"_95":740,"_155":741,"_157":-5,"_158":140,"_159":742,"_161":22,"_106":743,"_100":734,"_163":213,"_165":744,"_166":22,"_167":-5,"_168":745,"_98":746},"8085cebe-b9ca-11f0-98dd-0224a6c84d84","urls.ts","3178e244-b901-11f0-87ce-0224a6c84d84",92,["D",1762293983912],"export\n const urls = [\n // partners // kind of poisons the answers\n // \"https://console.groq.com/docs/agno.md\",\n // \"https://console.groq.com/docs/ai-sdk.md\",\n // \"https://console.groq.com/docs/anchorbrowser.md\",\n // \"https://console.groq.com/docs/arize.md\",\n // \"https://console.groq.com/docs/autogen.md\",\n // \"https://console.groq.com/docs/browserbase.md\",\n // \"https://console.groq.com/docs/composio.md\",\n // \"https://console.groq.com/docs/crewai.md\",\n // \"https://console.groq.com/docs/e2b.md\",\n // \"https://console.groq.com/docs/firecrawl.md\",\n // \"https://console.groq.com/docs/flutterflow.md\",\n // \"https://console.groq.com/docs/gradio.md\",\n // \"https://console.groq.com/docs/huggingface.md\",\n // \"https://console.groq.com/docs/jigsawstack.md\",\n \"https://console.groq.com/docs/langchain.md\",\n \"https://console.groq.com/docs/litellm.md\",\n \"https://console.groq.com/docs/livekit.md\",\n \"https://console.groq.com/docs/openai.md\",\n \"https://console.groq.com/docs/tavily.md\",\n // \"https://console.groq.com/docs/toolhouse.md\",\n // \"https://console.groq.com/docs/wolfram-alpha.md\",\n // \"https://console.groq.com/docs/xrx.md\",\n // \"https://console.groq.com/docs/parallel.md\",\n // \"https://console.groq.com/docs/exa.md\",\n\n // other\n // \"https://console.groq.com/docs/changelog.md\",\n // \"https://console.groq.com/docs/changelog/compound.md\",\n // \"https://console.groq.com/docs/legacy-changelog.md\",\n\n // main\n \"https://console.groq.com/docs.md\",\n \"https://console.groq.com/docs/agentic-tooling.md\",\n \"https://console.groq.com/docs/agentic-tooling/compound-beta.md\",\n \"https://console.groq.com/docs/agentic-tooling/compound-beta-mini.md\",\n \"https://console.groq.com/docs/api-reference.md\",\n \"https://console.groq.com/docs/badge.md\",\n \"https://console.groq.com/docs/batch.md\",\n \"https://console.groq.com/docs/billing-faqs.md\",\n \"https://console.groq.com/docs/browser-automation.md\",\n \"https://console.groq.com/docs/browser-search.md\",\n \"https://console.groq.com/docs/browseruse.md\",\n \"https://console.groq.com/docs/code-execution.md\",\n \"https://console.groq.com/docs/compound.md\",\n \"https://console.groq.com/docs/compound/built-in-tools.md\",\n \"https://console.groq.com/docs/compound/systems.md\",\n \"https://console.groq.com/docs/compound/systems/compound.md\",\n \"https://console.groq.com/docs/compound/systems/compound-mini.md\",\n \"https://console.groq.com/docs/compound/systems/compound-beta.md\",\n \"https://console.groq.com/docs/compound/systems/compound-beta-mini.md\",\n \"https://console.groq.com/docs/compound/use-cases.md\",\n \"https://console.groq.com/docs/content-moderation.md\",\n \"https://console.groq.com/docs/deprecations.md\",\n \"https://console.groq.com/docs/errors.md\",\n \"https://console.groq.com/docs/examples.md\",\n \"https://console.groq.com/docs/flex-processing.md\",\n \"https://console.groq.com/docs/guides/speech-to-text/prompting.md\",\n \"https://console.groq.com/docs/integrations.md\",\n \"https://console.groq.com/docs/legal.md\",\n \"https://console.groq.com/docs/legal/ai-policy.md\",\n \"https://console.groq.com/docs/legal/services-agreement.md\",\n \"https://console.groq.com/docs/libraries.md\",\n \"https://console.groq.com/docs/llama-index.md\",\n \"https://console.groq.com/docs/lora.md\",\n \"https://console.groq.com/docs/mastra.md\",\n \"https://console.groq.com/docs/mcp.md\",\n \"https://console.groq.com/docs/mlflow.md\",\n \"https://console.groq.com/docs/model-permissions.md\",\n \"https://console.groq.com/docs/model/llama-3.1-8b-instant.md\",\n \"https://console.groq.com/docs/model/llama-3.3-70b-versatile.md\",\n \"https://console.groq.com/docs/model/llama-4-maverick-17b-128e-instruct.md\",\n \"https://console.groq.com/docs/model/llama-4-scout-17b-16e-instruct.md\",\n \"https://console.groq.com/docs/model/llama-guard-4-12b.md\",\n \"https://console.groq.com/docs/model/llama-prompt-guard-2-22m.md\",\n \"https://console.groq.com/docs/model/llama-prompt-guard-2-86m.md\",\n \"https://console.groq.com/docs/model/meta-llama/llama-4-maverick-17b-128e-instruct.md\",\n \"https://console.groq.com/docs/model/meta-llama/llama-4-scout-17b-16e-instruct.md\",\n \"https://console.groq.com/docs/model/meta-llama/llama-guard-4-12b.md\",\n \"https://console.groq.com/docs/model/meta-llama/llama-prompt-guard-2-22m.md\",\n \"https://console.groq.com/docs/model/meta-llama/llama-prompt-guard-2-86m.md\",\n \"https://console.groq.com/docs/model/moonshotai/kimi-k2-instruct.md\",\n \"https://console.groq.com/docs/model/moonshotai/kimi-k2-instruct-0905.md\",\n \"https://console.groq.com/docs/model/openai/gpt-oss-120b.md\",\n \"https://console.groq.com/docs/model/openai/gpt-oss-20b.md\",\n \"https://console.groq.com/docs/model/openai/gpt-oss-safeguard-20b.md\",\n \"https://console.groq.com/docs/model/playai-tts.md\",\n \"https://console.groq.com/docs/model/playai-tts-arabic.md\",\n \"https://console.groq.com/docs/model/qwen/qwen3-32b.md\",\n \"https://console.groq.com/docs/model/qwen3-32b.md\",\n \"https://console.groq.com/docs/model/whisper-large-v3.md\",\n \"https://console.groq.com/docs/model/whisper-large-v3-turbo.md\",\n \"https://console.groq.com/docs/models.md\",\n \"https://console.groq.com/docs/overview.md\",\n \"https://console.groq.com/docs/prefilling.md\",\n \"https://console.groq.com/docs/production-readiness/optimizing-latency.md\",\n \"https://console.groq.com/docs/production-readiness/production-ready-checklist.md\",\n \"https://console.groq.com/docs/production-readiness/security-onboarding.md\",\n \"https://console.groq.com/docs/projects.md\",\n \"https://console.groq.com/docs/prompt-caching.md\",\n \"https://console.groq.com/docs/prompting.md\",\n \"https://console.groq.com/docs/prompting/model-migration.md\",\n \"https://console.groq.com/docs/prompting/patterns.md\",\n \"https://console.groq.com/docs/quickstart.md\",\n \"https://console.groq.com/docs/rate-limits.md\",\n \"https://console.groq.com/docs/reasoning.md\",\n \"https://console.groq.com/docs/responses-api.md\",\n \"https://console.groq.com/docs/speech-text.md\",\n \"https://console.groq.com/docs/speech-to-text.md\",\n \"https://console.groq.com/docs/spend-limits.md\",\n \"https://console.groq.com/docs/structured-outputs.md\",\n \"https://console.groq.com/docs/text-chat.md\",\n \"https://console.groq.com/docs/text-to-speech.md\",\n \"https://console.groq.com/docs/tool-use.md\",\n \"https://console.groq.com/docs/vision.md\",\n \"https://console.groq.com/docs/web-search.md\",\n \"https://console.groq.com/docs/your-data.md\",\n ];\n",[],[740],{"_104":748,"_95":246,"_155":749,"_157":-5,"_158":140,"_159":750,"_161":110,"_106":751,"_100":32,"_163":213,"_165":752,"_166":22,"_167":-5,"_168":753,"_98":754},"93344376-b8f1-11f0-ab7b-0224a6c84d84","93344448-b8f1-11f0-ab7b-0224a6c84d84",24,["D",1762200814128],"import { sqlite } from \"https://esm.town/v/std/sqlite\";\nimport { encoding_for_model } from \"npm:tiktoken\";\nimport { RateLimit } from \"npm:async-sema@latest\";\n\n// Detect if we're running in Val Town (caching enabled) or locally (caching disabled)\n// valtown env var contains a token string when running in Val Town, undefined/null when local\nexport const IS_VALTOWN = typeof Deno !== \"undefined\" && !!Deno.env.get(\"valtown\");\n\n// Rate limiter: 0.33 requests per second (1 request per 3 seconds) to avoid WAF blocking\n// Slower rate to avoid console.groq.com WAF blocking\nexport const fetchRateLimiter = RateLimit(0.33);\n\n// Initialize cache table only in Val Town (bypass SQLite when running locally)\nconst CACHE_TABLE = \"groq_docs_cache_v3\"; // Updated table with hash and embeddings\nif (IS_VALTOWN) {\n try {\n await sqlite.execute(`CREATE TABLE IF NOT EXISTS ${CACHE_TABLE} (\n url TEXT PRIMARY KEY,\n content TEXT NOT NULL,\n charCount INTEGER NOT NULL,\n tokenCount INTEGER,\n frontmatter TEXT NOT NULL,\n metadata TEXT,\n contentHash TEXT,\n embeddings TEXT,\n cachedAt INTEGER NOT NULL\n )`);\n console.log(\"SQLite cache initialized (Val Town)\");\n } catch (error) {\n console.warn(\"Cache table creation failed:\", error instanceof Error ? error.message.substring(0, 100) : String(error).substring(0, 100));\n }\n} else {\n console.log(\"Running locally - SQLite caching disabled\");\n}\n\n// Calculate hash of content for change detection\nexport const calculateContentHash = async (content: string): Promise => {\n // Use Web Crypto API for SHA-256 hashing\n const encoder = new TextEncoder();\n const data = encoder.encode(content);\n const hashBuffer = await crypto.subtle.digest(\"SHA-256\", data);\n const hashArray = Array.from(new Uint8Array(hashBuffer));\n const hashHex = hashArray.map(b => b.toString(16).padStart(2, '0')).join('');\n return hashHex;\n};\n\n// Debug: Log environment detection\nif (typeof Deno !== \"undefined\") {\n const valtownToken = Deno.env.get(\"valtown\");\n console.log(`Environment detection: IS_VALTOWN=${IS_VALTOWN}, valtown token exists: ${!!valtownToken}`);\n}\n\n// Cache helper functions (bypass SQLite when running locally)\nexport const getFromCache = async (url: string): Promise<{\n content: string;\n charCount: number;\n tokenCount: number | null;\n frontmatter: any;\n metadata: any | null;\n contentHash: string | null;\n embeddings: number[] | null;\n} | null> => {\n if (!IS_VALTOWN) {\n return null; // Skip cache when running locally\n }\n \n try {\n const result = await sqlite.execute({\n sql: `SELECT content, charCount, tokenCount, frontmatter, metadata, contentHash, embeddings FROM ${CACHE_TABLE} WHERE url = ?`,\n args: [url]\n });\n if (result && result.rows && result.rows.length > 0) {\n // Convert row array to object using column names\n const row = result.rows[0];\n const rowObj: any = {};\n result.columns.forEach((col: string, index: number) => {\n rowObj[col] = row[index];\n });\n return {\n content: rowObj.content as string,\n charCount: rowObj.charCount as number,\n tokenCount: rowObj.tokenCount as number | null,\n frontmatter: JSON.parse(rowObj.frontmatter as string),\n metadata: rowObj.metadata ? JSON.parse(rowObj.metadata as string) : null,\n contentHash: rowObj.contentHash as string | null,\n embeddings: rowObj.embeddings ? JSON.parse(rowObj.embeddings as string) : null,\n };\n }\n } catch (error) {\n // Silently fail - caching unavailable\n const errorMessage = error instanceof Error ? error.message : String(error);\n const shortError = errorMessage.length > 200 ? errorMessage.substring(0, 200) + '...' : errorMessage;\n console.debug(\"Cache read failed:\", shortError);\n }\n return null;\n};\n\nexport const setCache = async (url: string, data: { content: string; charCount: number; tokenCount: number | null; frontmatter: any; metadata?: any; contentHash?: string; embeddings?: number[] | null }): Promise => {\n if (!IS_VALTOWN) {\n return \"Cache unavailable - running locally\";\n }\n \n try {\n await sqlite.execute({\n sql: `INSERT OR REPLACE INTO ${CACHE_TABLE} (url, content, charCount, tokenCount, frontmatter, metadata, contentHash, embeddings, cachedAt) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n args: [\n url,\n data.content,\n data.charCount,\n data.tokenCount,\n JSON.stringify(data.frontmatter),\n data.metadata ? JSON.stringify(data.metadata) : null,\n data.contentHash || null,\n data.embeddings ? JSON.stringify(data.embeddings) : null,\n Date.now(),\n ]\n });\n return null; // Success - no error\n } catch (error) {\n // Return error message for tracking\n const errorMessage = error instanceof Error ? error.message : String(error);\n const shortError = errorMessage.length > 200 ? errorMessage.substring(0, 200) + '...' : errorMessage;\n console.debug(\"Cache write failed:\", shortError);\n return shortError;\n }\n};\n\nexport const clearCache = async (url?: string) => {\n if (!IS_VALTOWN) {\n throw new Error(\"Cache unavailable - running locally\");\n }\n \n try {\n if (url) {\n await sqlite.execute({\n sql: `DELETE FROM ${CACHE_TABLE} WHERE url = ?`,\n args: [url]\n });\n } else {\n await sqlite.execute(`DELETE FROM ${CACHE_TABLE}`);\n }\n } catch (error) {\n console.debug(\"Cache clear failed:\", error instanceof Error ? error.message.substring(0, 100) : String(error).substring(0, 100));\n throw error; // Re-throw for endpoints that need to know if it failed\n }\n};\n\nexport const getCacheStats = async () => {\n if (!IS_VALTOWN) {\n return {\n cachedPages: 0,\n totalTokens: 0,\n message: \"Cache unavailable - running locally\",\n };\n }\n \n try {\n const result = await sqlite.execute(`SELECT COUNT(*) as count, SUM(tokenCount) as totalTokens FROM ${CACHE_TABLE}`);\n if (result && result.rows && result.rows.length > 0) {\n const row = result.rows[0];\n const rowObj: any = {};\n result.columns.forEach((col: string, index: number) => {\n rowObj[col] = row[index];\n });\n return {\n cachedPages: rowObj.count || 0,\n totalTokens: rowObj.totalTokens || 0,\n };\n }\n return {\n cachedPages: 0,\n totalTokens: 0,\n };\n } catch (error) {\n console.debug(\"Cache stats failed:\", error instanceof Error ? error.message.substring(0, 100) : String(error).substring(0, 100));\n return {\n cachedPages: 0,\n totalTokens: 0,\n };\n }\n};\n\nexport const getTextFromUrl = async (url: string) => {\n // Use rate limiter to avoid WAF blocking\n await fetchRateLimiter();\n \n const response = await fetch(url, {\n headers: {\n \"User-Agent\": \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36\",\n \"Accept\": \"text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8\",\n }\n });\n \n if (!response.ok) {\n throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n }\n \n const text = await response.text();\n return text;\n};\n\nexport const parseFrontmatter = (text: string) => {\n const frontmatterRegex = /^---\\s*\\n([\\s\\S]*?)\\n---\\s*\\n?/;\n const match = text.match(frontmatterRegex);\n \n if (!match) {\n return {};\n }\n \n const frontmatterText = match[1];\n const metadata: any = {};\n \n // Parse YAML-like frontmatter (simple key: value parsing)\n const lines = frontmatterText.split('\\n');\n for (const line of lines) {\n const colonIndex = line.indexOf(':');\n if (colonIndex > 0) {\n const key = line.substring(0, colonIndex).trim();\n const value = line.substring(colonIndex + 1).trim();\n // Remove quotes if present\n metadata[key] = value.replace(/^[\"']|[\"']$/g, '');\n }\n }\n \n return metadata;\n};\n\nexport const addUrlSourceToFrontmatter = (text: string, url: string) => {\n // Check if frontmatter exists\n const frontmatterRegex = /^---\\s*\\n([\\s\\S]*?)\\n---\\s*\\n?/;\n const match = text.match(frontmatterRegex);\n \n if (match) {\n // Frontmatter exists, add urlSource to it\n const existingFrontmatter = match[1];\n \n // Check if urlSource already exists\n if (existingFrontmatter.includes('urlSource:')) {\n // Replace existing urlSource\n const updatedFrontmatter = existingFrontmatter.replace(\n /urlSource:\\s*.+$/m,\n `urlSource: ${url}`\n );\n return text.replace(frontmatterRegex, `---\\n${updatedFrontmatter}\\n---\\n`);\n } else {\n // Add urlSource at the end of frontmatter\n const updatedFrontmatter = existingFrontmatter.trim() + `\\nurlSource: ${url}`;\n return text.replace(frontmatterRegex, `---\\n${updatedFrontmatter}\\n---\\n\\n`);\n }\n } else {\n // No frontmatter exists, add it\n return `---\nurlSource: ${url}\n---\n\n${text}`;\n }\n};\n\nexport const calculateTokenCount = (text: string): number => {\n try {\n // Use cl100k_base encoding (used by GPT-4 and many models)\n const encoding = encoding_for_model(\"gpt-4\");\n return encoding.encode(text).length;\n } catch (error) {\n console.error(\"Error calculating token count:\", error);\n return 0;\n }\n};\n\n",[],[246],"files",[152,170,180,189,198,207,217,226,235,244,254,262,269,276,283,290,299,308,317,326,335,345,354,362,371,380,390,399,407,416,425,434,443,453,461,469,478,487,495,504,513,522,531,540,549,558,567,575,584,591,600,609,618,627,636,645,655,662,672,681,690,699,708,717,728,738,747],"counts",{"_759":32,"_760":734,"_761":32,"_762":763},"pulls","branches","forks","envVars",{"_764":32,"_765":32},"count","emptyCount","contents",[768,771,774,777,780,783],{"_104":291,"_95":292,"_155":293,"_157":286,"_158":140,"_159":294,"_161":110,"_106":769,"_100":32,"_163":176,"_165":296,"_166":22,"_167":-5,"_98":770},["D",1762293982987],[264,271,278,285,292],{"_104":300,"_95":301,"_155":302,"_157":286,"_158":140,"_159":303,"_161":110,"_106":772,"_100":32,"_163":176,"_165":305,"_166":22,"_167":-5,"_98":773},["D",1762293983161],[264,271,278,285,301],{"_104":309,"_95":310,"_155":311,"_157":286,"_158":140,"_159":312,"_161":110,"_106":775,"_100":32,"_163":176,"_165":314,"_166":22,"_167":-5,"_98":776},["D",1762293983038],[264,271,278,285,310],{"_104":318,"_95":319,"_155":320,"_157":286,"_158":140,"_159":321,"_161":110,"_106":778,"_100":32,"_163":176,"_165":323,"_166":22,"_167":-5,"_98":779},["D",1762293982831],[264,271,278,285,319],{"_104":327,"_95":328,"_155":329,"_157":286,"_158":140,"_159":330,"_161":110,"_106":781,"_100":32,"_163":176,"_165":332,"_166":22,"_167":-5,"_98":782},["D",1762293982920],[264,271,278,285,328],{"_104":336,"_95":337,"_155":338,"_157":286,"_158":140,"_159":339,"_161":110,"_106":784,"_100":32,"_163":176,"_165":341,"_166":22,"_167":-5,"_98":785},["D",1762293983138],[264,271,278,285,337],{"_104":284,"_95":285,"_155":286,"_157":279,"_158":140,"_159":287,"_161":110,"_106":787,"_100":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_98":788},["D",1762293981620],[264,271,278,285],"upstreamProject","upstreamBranch","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.branch.$branch.version.$version.code.$",{"_93":94,"_95":96,"_97":43,"_100":101,"_98":99,"_102":797,"_150":802,"_755":1004,"_176":1005,"_766":1007,"_1020":-5,"_1021":-5,"_1022":-5,"_1023":-5,"_1024":1025},{"_104":105,"_95":96,"_106":798,"_108":-5,"_109":110,"_111":112,"_113":-5,"_114":-5,"_14":115,"_116":117,"_118":110,"_119":-5,"_120":32,"_16":121,"_122":123,"_124":123,"_125":126,"_127":126,"_128":126,"_129":123,"_130":123,"_23":799,"_134":800,"_137":801,"_149":22},["D",1746217442601],{"_93":94,"_132":133},{"_93":94,"_136":133,"_14":115},{"_100":139,"_95":43,"_104":140,"_141":105,"_142":-5,"_143":-5,"_144":-5,"_145":-5,"_146":-5,"_147":96,"_148":94},[803,833,836,947,971,977,980,983,986,989,992,995,998,1001],{"_104":153,"_95":154,"_155":156,"_157":-5,"_158":140,"_159":160,"_161":110,"_106":162,"_100":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":804,"_98":832},[805,808,811,814,817,820,823,826,829],{"_104":171,"_95":172,"_155":173,"_157":156,"_158":140,"_159":174,"_161":110,"_106":175,"_100":32,"_163":176,"_165":177,"_166":22,"_167":-5,"_168":806,"_98":807},[],[154,172],{"_104":181,"_95":182,"_155":183,"_157":156,"_158":140,"_159":184,"_161":110,"_106":185,"_100":32,"_163":176,"_165":186,"_166":22,"_167":-5,"_168":809,"_98":810},[],[154,182],{"_104":190,"_95":191,"_155":192,"_157":156,"_158":140,"_159":193,"_161":110,"_106":194,"_100":32,"_163":176,"_165":195,"_166":22,"_167":-5,"_168":812,"_98":813},[],[154,191],{"_104":199,"_95":200,"_155":201,"_157":156,"_158":140,"_159":202,"_161":110,"_106":203,"_100":32,"_163":176,"_165":204,"_166":22,"_167":-5,"_168":815,"_98":816},[],[154,200],{"_104":208,"_95":209,"_155":210,"_157":156,"_158":140,"_159":211,"_161":110,"_106":212,"_100":32,"_163":213,"_165":214,"_166":22,"_167":-5,"_168":818,"_98":819},[],[154,209],{"_104":218,"_95":219,"_155":220,"_157":156,"_158":140,"_159":221,"_161":110,"_106":222,"_100":32,"_163":213,"_165":223,"_166":22,"_167":-5,"_168":821,"_98":822},[],[154,219],{"_104":227,"_95":228,"_155":229,"_157":156,"_158":140,"_159":230,"_161":110,"_106":231,"_100":32,"_163":213,"_165":232,"_166":22,"_167":-5,"_168":824,"_98":825},[],[154,228],{"_104":236,"_95":237,"_155":238,"_157":156,"_158":140,"_159":239,"_161":110,"_106":240,"_100":32,"_163":213,"_165":241,"_166":22,"_167":-5,"_168":827,"_98":828},[],[154,237],{"_104":245,"_95":246,"_155":247,"_157":156,"_158":140,"_159":248,"_161":110,"_106":249,"_100":32,"_163":213,"_165":250,"_166":22,"_167":-5,"_168":830,"_98":831},[],[154,246],[154],{"_104":255,"_95":256,"_155":257,"_157":-5,"_158":140,"_159":258,"_161":110,"_106":259,"_100":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":834,"_98":835},[],[256],{"_104":263,"_95":264,"_155":265,"_157":-5,"_158":140,"_159":266,"_161":110,"_106":267,"_100":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":837,"_98":946},[838,901,904,907,910,913,916,919,922,925,928,931,934,937,940,943],{"_104":270,"_95":271,"_155":272,"_157":265,"_158":140,"_159":273,"_161":110,"_106":274,"_100":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":839,"_98":900},[840,879,882,885,888,891,894,897],{"_104":277,"_95":278,"_155":279,"_157":272,"_158":140,"_159":280,"_161":110,"_106":281,"_100":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":841,"_98":878},[842,863,866,869,872,875],{"_104":284,"_95":285,"_155":286,"_157":279,"_158":140,"_159":287,"_161":110,"_106":288,"_100":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":843,"_98":862},[844,847,850,853,856,859],{"_104":291,"_95":292,"_155":293,"_157":286,"_158":140,"_159":294,"_161":110,"_106":295,"_100":32,"_163":176,"_165":296,"_166":22,"_167":-5,"_168":845,"_98":846},[],[264,271,278,285,292],{"_104":300,"_95":301,"_155":302,"_157":286,"_158":140,"_159":303,"_161":110,"_106":304,"_100":32,"_163":176,"_165":305,"_166":22,"_167":-5,"_168":848,"_98":849},[],[264,271,278,285,301],{"_104":309,"_95":310,"_155":311,"_157":286,"_158":140,"_159":312,"_161":110,"_106":313,"_100":32,"_163":176,"_165":314,"_166":22,"_167":-5,"_168":851,"_98":852},[],[264,271,278,285,310],{"_104":318,"_95":319,"_155":320,"_157":286,"_158":140,"_159":321,"_161":110,"_106":322,"_100":32,"_163":176,"_165":323,"_166":22,"_167":-5,"_168":854,"_98":855},[],[264,271,278,285,319],{"_104":327,"_95":328,"_155":329,"_157":286,"_158":140,"_159":330,"_161":110,"_106":331,"_100":32,"_163":176,"_165":332,"_166":22,"_167":-5,"_168":857,"_98":858},[],[264,271,278,285,328],{"_104":336,"_95":337,"_155":338,"_157":286,"_158":140,"_159":339,"_161":110,"_106":340,"_100":32,"_163":176,"_165":341,"_166":22,"_167":-5,"_168":860,"_98":861},[],[264,271,278,285,337],[264,271,278,285],{"_104":346,"_95":347,"_155":348,"_157":279,"_158":140,"_159":349,"_161":110,"_106":350,"_100":32,"_163":176,"_165":351,"_166":22,"_167":-5,"_168":864,"_98":865},[],[264,271,278,347],{"_104":355,"_95":191,"_155":356,"_157":279,"_158":140,"_159":357,"_161":110,"_106":358,"_100":32,"_163":176,"_165":359,"_166":22,"_167":-5,"_168":867,"_98":868},[],[264,271,278,191],{"_104":363,"_95":364,"_155":365,"_157":279,"_158":140,"_159":366,"_161":110,"_106":367,"_100":32,"_163":176,"_165":368,"_166":22,"_167":-5,"_168":870,"_98":871},[],[264,271,278,364],{"_104":372,"_95":373,"_155":374,"_157":279,"_158":140,"_159":375,"_161":110,"_106":376,"_100":32,"_163":176,"_165":377,"_166":22,"_167":-5,"_168":873,"_98":874},[],[264,271,278,373],{"_104":381,"_95":382,"_155":383,"_157":279,"_158":140,"_159":384,"_161":110,"_106":385,"_100":32,"_163":176,"_165":386,"_166":22,"_167":-5,"_168":876,"_98":877},[],[264,271,278,382],[264,271,278],{"_104":391,"_95":392,"_155":393,"_157":272,"_158":140,"_159":394,"_161":110,"_106":395,"_100":32,"_163":176,"_165":396,"_166":22,"_167":-5,"_168":880,"_98":881},[],[264,271,392],{"_104":400,"_95":191,"_155":401,"_157":272,"_158":140,"_159":402,"_161":110,"_106":403,"_100":32,"_163":176,"_165":404,"_166":22,"_167":-5,"_168":883,"_98":884},[],[264,271,191],{"_104":408,"_95":409,"_155":410,"_157":272,"_158":140,"_159":411,"_161":110,"_106":412,"_100":32,"_163":176,"_165":413,"_166":22,"_167":-5,"_168":886,"_98":887},[],[264,271,409],{"_104":417,"_95":418,"_155":419,"_157":272,"_158":140,"_159":420,"_161":110,"_106":421,"_100":32,"_163":176,"_165":422,"_166":22,"_167":-5,"_168":889,"_98":890},[],[264,271,418],{"_104":426,"_95":427,"_155":428,"_157":272,"_158":140,"_159":429,"_161":110,"_106":430,"_100":32,"_163":213,"_165":431,"_166":22,"_167":-5,"_168":892,"_98":893},[],[264,271,427],{"_104":435,"_95":436,"_155":437,"_157":272,"_158":140,"_159":438,"_161":110,"_106":439,"_100":32,"_163":213,"_165":440,"_166":22,"_167":-5,"_168":895,"_98":896},[],[264,271,436],{"_104":444,"_95":445,"_155":446,"_157":272,"_158":140,"_159":447,"_161":110,"_106":448,"_100":32,"_163":213,"_165":449,"_166":22,"_167":-5,"_168":898,"_98":899},[],[264,271,445],[264,271],{"_104":454,"_95":191,"_155":455,"_157":265,"_158":140,"_159":456,"_161":110,"_106":457,"_100":32,"_163":176,"_165":458,"_166":22,"_167":-5,"_168":902,"_98":903},[],[264,191],{"_104":462,"_95":200,"_155":463,"_157":265,"_158":140,"_159":464,"_161":110,"_106":465,"_100":32,"_163":176,"_165":466,"_166":22,"_167":-5,"_168":905,"_98":906},[],[264,200],{"_104":470,"_95":471,"_155":472,"_157":265,"_158":140,"_159":473,"_161":110,"_106":474,"_100":32,"_163":213,"_165":475,"_166":22,"_167":-5,"_168":908,"_98":909},[],[264,471],{"_104":479,"_95":480,"_155":481,"_157":265,"_158":140,"_159":482,"_161":110,"_106":483,"_100":32,"_163":213,"_165":484,"_166":22,"_167":-5,"_168":911,"_98":912},[],[264,480],{"_104":488,"_95":219,"_155":489,"_157":265,"_158":140,"_159":490,"_161":22,"_106":491,"_100":32,"_163":213,"_165":492,"_166":22,"_167":-5,"_168":914,"_98":915},[],[264,219],{"_104":496,"_95":497,"_155":498,"_157":265,"_158":140,"_159":499,"_161":110,"_106":500,"_100":32,"_163":213,"_165":501,"_166":22,"_167":-5,"_168":917,"_98":918},[],[264,497],{"_104":505,"_95":506,"_155":507,"_157":265,"_158":140,"_159":508,"_161":110,"_106":509,"_100":32,"_163":213,"_165":510,"_166":22,"_167":-5,"_168":920,"_98":921},[],[264,506],{"_104":514,"_95":515,"_155":516,"_157":265,"_158":140,"_159":517,"_161":110,"_106":518,"_100":32,"_163":213,"_165":519,"_166":22,"_167":-5,"_168":923,"_98":924},[],[264,515],{"_104":523,"_95":524,"_155":525,"_157":265,"_158":140,"_159":526,"_161":110,"_106":527,"_100":32,"_163":213,"_165":528,"_166":22,"_167":-5,"_168":926,"_98":927},[],[264,524],{"_104":532,"_95":533,"_155":534,"_157":265,"_158":140,"_159":535,"_161":110,"_106":536,"_100":32,"_163":213,"_165":537,"_166":22,"_167":-5,"_168":929,"_98":930},[],[264,533],{"_104":541,"_95":542,"_155":543,"_157":265,"_158":140,"_159":544,"_161":110,"_106":545,"_100":32,"_163":213,"_165":546,"_166":22,"_167":-5,"_168":932,"_98":933},[],[264,542],{"_104":550,"_95":551,"_155":552,"_157":265,"_158":140,"_159":553,"_161":22,"_106":554,"_100":32,"_163":213,"_165":555,"_166":22,"_167":-5,"_168":935,"_98":936},[],[264,551],{"_104":559,"_95":560,"_155":561,"_157":265,"_158":140,"_159":562,"_161":110,"_106":563,"_100":32,"_163":213,"_165":564,"_166":22,"_167":-5,"_168":938,"_98":939},[],[264,560],{"_104":568,"_95":237,"_155":569,"_157":265,"_158":140,"_159":570,"_161":110,"_106":571,"_100":32,"_163":213,"_165":572,"_166":22,"_167":-5,"_168":941,"_98":942},[],[264,237],{"_104":576,"_95":246,"_155":577,"_157":265,"_158":140,"_159":578,"_161":22,"_106":579,"_100":32,"_163":213,"_165":580,"_166":22,"_167":-5,"_168":944,"_98":945},[],[264,246],[264],{"_104":585,"_95":586,"_155":587,"_157":-5,"_158":140,"_159":588,"_161":110,"_106":589,"_100":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":948,"_98":970},[949,952,955,958,961,964,967],{"_104":592,"_95":593,"_155":594,"_157":587,"_158":140,"_159":595,"_161":110,"_106":596,"_100":32,"_163":213,"_165":597,"_166":22,"_167":-5,"_168":950,"_98":951},[],[586,593],{"_104":601,"_95":602,"_155":603,"_157":587,"_158":140,"_159":604,"_161":22,"_106":605,"_100":32,"_163":213,"_165":606,"_166":22,"_167":-5,"_168":953,"_98":954},[],[586,602],{"_104":610,"_95":611,"_155":612,"_157":587,"_158":140,"_159":613,"_161":110,"_106":614,"_100":32,"_163":213,"_165":615,"_166":22,"_167":-5,"_168":956,"_98":957},[],[586,611],{"_104":619,"_95":620,"_155":621,"_157":587,"_158":140,"_159":622,"_161":22,"_106":623,"_100":32,"_163":213,"_165":624,"_166":22,"_167":-5,"_168":959,"_98":960},[],[586,620],{"_104":628,"_95":629,"_155":630,"_157":587,"_158":140,"_159":631,"_161":110,"_106":632,"_100":32,"_163":213,"_165":633,"_166":22,"_167":-5,"_168":962,"_98":963},[],[586,629],{"_104":637,"_95":638,"_155":639,"_157":587,"_158":140,"_159":640,"_161":110,"_106":641,"_100":32,"_163":213,"_165":642,"_166":22,"_167":-5,"_168":965,"_98":966},[],[586,638],{"_104":646,"_95":647,"_155":648,"_157":587,"_158":140,"_159":649,"_161":22,"_106":650,"_100":32,"_163":213,"_165":651,"_166":22,"_167":-5,"_168":968,"_98":969},[],[586,647],[586],{"_104":656,"_95":657,"_155":658,"_157":-5,"_158":140,"_159":659,"_161":110,"_106":660,"_100":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_168":972,"_98":976},[973],{"_104":663,"_95":664,"_155":665,"_157":658,"_158":140,"_159":666,"_161":110,"_106":667,"_100":32,"_163":213,"_165":668,"_166":22,"_167":-5,"_168":974,"_98":975},[],[657,664],[657],{"_104":673,"_95":674,"_155":675,"_157":-5,"_158":140,"_159":676,"_161":22,"_106":677,"_100":32,"_163":176,"_165":678,"_166":22,"_167":-5,"_168":978,"_98":979},[],[674],{"_104":682,"_95":683,"_155":684,"_157":-5,"_158":140,"_159":685,"_161":110,"_106":686,"_100":32,"_163":176,"_165":687,"_166":22,"_167":-5,"_168":981,"_98":982},[],[683],{"_104":691,"_95":191,"_155":692,"_157":-5,"_158":140,"_159":693,"_161":22,"_106":694,"_100":695,"_163":176,"_165":696,"_166":22,"_167":-5,"_168":984,"_98":985},[],[191],{"_104":700,"_95":701,"_155":702,"_157":-5,"_158":140,"_159":101,"_161":110,"_106":703,"_100":704,"_163":176,"_165":705,"_166":22,"_167":-5,"_168":987,"_98":988},[],[701],{"_104":709,"_95":710,"_155":711,"_157":-5,"_158":140,"_159":712,"_161":110,"_106":713,"_100":32,"_163":213,"_165":714,"_166":22,"_167":-5,"_168":990,"_98":991},[],[710],{"_104":718,"_95":719,"_155":117,"_157":-5,"_158":140,"_159":720,"_161":110,"_106":721,"_100":722,"_163":723,"_165":724,"_166":22,"_167":725,"_168":993,"_98":994},[],[719],{"_104":729,"_95":730,"_155":731,"_157":-5,"_158":140,"_159":732,"_161":22,"_106":733,"_100":734,"_163":176,"_165":735,"_166":22,"_167":-5,"_168":996,"_98":997},[],[730],{"_104":739,"_95":740,"_155":741,"_157":-5,"_158":140,"_159":742,"_161":22,"_106":743,"_100":734,"_163":213,"_165":744,"_166":22,"_167":-5,"_168":999,"_98":1000},[],[740],{"_104":748,"_95":246,"_155":749,"_157":-5,"_158":140,"_159":750,"_161":110,"_106":751,"_100":32,"_163":213,"_165":752,"_166":22,"_167":-5,"_168":1002,"_98":1003},[],[246],[803,805,808,811,814,817,820,823,826,829,833,836,838,840,842,844,847,850,853,856,859,863,866,869,872,875,879,882,885,888,891,894,897,901,904,907,910,913,916,919,922,925,928,931,934,937,940,943,947,949,952,955,958,961,964,967,971,973,977,980,983,986,989,992,995,998,1001],{"_104":284,"_95":285,"_155":286,"_157":279,"_158":140,"_159":287,"_161":110,"_106":787,"_100":32,"_163":164,"_165":-5,"_166":22,"_167":-5,"_98":1006},[264,271,278,285],[1008,1010,1012,1014,1016,1018],{"_104":291,"_95":292,"_155":293,"_157":286,"_158":140,"_159":294,"_161":110,"_106":769,"_100":32,"_163":176,"_165":296,"_166":22,"_167":-5,"_98":1009},[264,271,278,285,292],{"_104":300,"_95":301,"_155":302,"_157":286,"_158":140,"_159":303,"_161":110,"_106":772,"_100":32,"_163":176,"_165":305,"_166":22,"_167":-5,"_98":1011},[264,271,278,285,301],{"_104":309,"_95":310,"_155":311,"_157":286,"_158":140,"_159":312,"_161":110,"_106":775,"_100":32,"_163":176,"_165":314,"_166":22,"_167":-5,"_98":1013},[264,271,278,285,310],{"_104":318,"_95":319,"_155":320,"_157":286,"_158":140,"_159":321,"_161":110,"_106":778,"_100":32,"_163":176,"_165":323,"_166":22,"_167":-5,"_98":1015},[264,271,278,285,319],{"_104":327,"_95":328,"_155":329,"_157":286,"_158":140,"_159":330,"_161":110,"_106":781,"_100":32,"_163":176,"_165":332,"_166":22,"_167":-5,"_98":1017},[264,271,278,285,328],{"_104":336,"_95":337,"_155":338,"_157":286,"_158":140,"_159":339,"_161":110,"_106":784,"_100":32,"_163":176,"_165":341,"_166":22,"_167":-5,"_98":1019},[264,271,278,285,337],"upstream","pull","ahead","behind","templates",[],"actionData","errors"]

yawnxyz

groq-docs