[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_249":250,"_251":252},"routes/_app.x.$handle.$name",{"_94":93,"_31":43,"_102":84,"_26":103,"_13":14,"_104":-5,"_11":105,"_106":107,"_108":109,"_110":111,"_112":113,"_20":-5,"_114":-5,"_115":-5,"_116":24,"_117":118,"_119":47,"_120":-5,"_121":-5,"_122":123},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_41":42,"_31":43,"_36":44,"_45":-5,"_46":47,"_48":49,"_50":49,"_51":-5,"_52":-5,"_18":53,"_54":55,"_56":47,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":-5,"_64":-5,"_65":-5,"_66":-5,"_67":68,"_69":68,"_70":71,"_72":71,"_73":71,"_74":68,"_75":68,"_76":77,"_78":79,"_80":81,"_82":24},"version",23,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":24,"_26":27,"_28":27},"file",{"_29":30,"_31":27,"_32":33,"_34":35,"_36":37,"_38":14,"_39":40,"_23":24},"previous","deleted",false,"deletedHere","path","groq.ts","latestPath","fileId","9315b744-b8f1-11f0-85fe-0224a6c84d84","name","fileType","script","content","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","createdAt",["D",1762200814266],"branchVersion","branchId","632d0edc-2793-11f0-9d52-569c3dd06744","id","632cc576-2793-11f0-9d52-569c3dd06744","groq-docs",["D",1746217442601],"deletedAt","legacyEnvVars",true,"privacy","public","httpPrivacy","description","imageUrl","a8270e74-6479-475a-8025-9b69544ee0e7","pinnedFileId","632eed24-2793-11f0-9d52-569c3dd06744","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","8319defa-6e1a-46d4-ba66-2114ffd3360b","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_94":93,"_101":97},"org",{"_94":93,"_95":-5,"_96":97,"_18":53,"_98":99,"_100":24},"branch",{"_13":83,"_31":84,"_41":40,"_85":42,"_86":-5,"_87":-5,"_88":-5,"_89":-5,"_90":-5,"_91":43,"_92":93},"isOwned",105,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","yawnxyz","handle","displayName","avatar","https://images.clerk.dev/oauth_github/img_2NnaHhpxNuH1xWRIRjQNoo16TVc.jpeg","tier","pro","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_41":42,"_31":43,"_36":245,"_45":-5,"_46":47,"_48":49,"_50":49,"_51":-5,"_52":-5,"_18":53,"_54":55,"_56":47,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":-5,"_64":-5,"_65":-5,"_66":-5,"_67":68,"_69":68,"_70":71,"_72":71,"_73":71,"_74":68,"_75":68,"_76":246,"_78":247,"_80":248,"_82":24},"tree",[208,209,210,211,212,213,214,215,216],"files",[208,209,210,211,212,213,214,215,216],"counts",{"_198":60,"_199":174,"_200":60,"_201":202,"_203":204},"contents",[124,125,126,127,128,129,130,131,132],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_41":191,"_31":192,"_29":193,"_136":-5,"_39":40,"_38":194,"_138":24,"_36":195,"_13":60,"_32":20,"_34":196,"_23":24,"_141":-5,"_26":197},{"_41":184,"_31":185,"_29":186,"_136":-5,"_39":40,"_38":187,"_138":47,"_36":188,"_13":60,"_32":20,"_34":189,"_23":24,"_141":-5,"_26":190},{"_41":177,"_31":178,"_29":179,"_136":-5,"_39":40,"_38":180,"_138":24,"_36":181,"_13":174,"_32":20,"_34":182,"_23":24,"_141":-5,"_26":183},{"_41":169,"_31":170,"_29":171,"_136":-5,"_39":40,"_38":172,"_138":24,"_36":173,"_13":174,"_32":20,"_34":175,"_23":24,"_141":-5,"_26":176},{"_41":166,"_31":27,"_29":30,"_136":-5,"_39":40,"_38":14,"_138":47,"_36":167,"_13":60,"_32":33,"_34":35,"_23":24,"_141":-5,"_26":168},{"_41":159,"_31":160,"_29":161,"_136":-5,"_39":40,"_38":162,"_138":24,"_36":163,"_13":60,"_32":33,"_34":164,"_23":24,"_141":-5,"_26":165},{"_41":150,"_31":151,"_29":55,"_136":-5,"_39":40,"_38":152,"_138":24,"_36":153,"_13":154,"_32":155,"_34":156,"_23":24,"_141":157,"_26":158},{"_41":143,"_31":144,"_29":145,"_136":-5,"_39":40,"_38":146,"_138":24,"_36":147,"_13":60,"_32":33,"_34":148,"_23":24,"_141":-5,"_26":149},{"_41":133,"_31":134,"_29":135,"_136":-5,"_39":40,"_38":137,"_138":24,"_36":139,"_13":60,"_32":20,"_34":140,"_23":24,"_141":-5,"_26":142},"7ebe7c70-b8ee-11f0-bdd9-0224a6c84d84","todo.md","7ebe7d74-b8ee-11f0-bdd9-0224a6c84d84","parentId",15,"latest",["D",1762199491650],"\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","label",[134],"9300cdf2-b8f1-11f0-85fe-0224a6c84d84","search.ts","9300cec4-b8f1-11f0-85fe-0224a6c84d84",21,["D",1762200814117],"// Embeddings and Search utilities\n// TODO: Replace fake implementations with actual embeddings API and vector search\n\n// Generate embeddings for content (fake default implementation)\nexport const generateEmbeddings = async (content: string): Promise => {\n // TODO: Replace with actual embeddings API when available\n // For now, return a fake embedding vector\n console.debug(\"Generating fake embeddings (replace with actual API when available)\");\n \n // Generate a fake embedding of fixed size (e.g., 384 dimensions)\n // Using a simple hash-based approach to create deterministic fake embeddings\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 // Create deterministic fake values based on content hash and position\n const value = Math.sin(hash + i) * 0.5 + 0.5; // Normalize to 0-1\n fakeEmbedding.push(value);\n }\n \n return fakeEmbedding;\n};\n\n// Calculate cosine similarity between two embedding vectors\nconst 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// Search pages by query (fake implementation using keyword matching)\n// TODO: Replace with actual vector similarity search using embeddings\nexport const searchPages = async (\n query: string,\n pages: Array<{\n path: string;\n url: string;\n content: string;\n title?: string;\n embeddings?: number[] | null;\n metadata?: any;\n }>,\n options: {\n limit?: number;\n minScore?: number;\n } = {}\n): Promise> => {\n const limit = options.limit || 10;\n const minScore = options.minScore || 0;\n \n // TODO: Use embeddings for semantic search\n // For now, use simple keyword matching\n \n const queryLower = query.toLowerCase();\n const queryWords = queryLower.split(/\\s+/).filter(w => w.length > 0);\n \n const results: Array<{\n path: string;\n url: string;\n title?: string;\n score: number;\n snippet?: string;\n }> = [];\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 // Generate snippet (first 200 chars around first match)\n let snippet: string | undefined;\n const firstMatchIndex = contentLower.indexOf(queryWords[0]);\n if (firstMatchIndex >= 0) {\n const start = Math.max(0, firstMatchIndex - 50);\n const end = Math.min(page.content.length, firstMatchIndex + queryWords[0].length + 150);\n snippet = page.content.substring(start, end);\n if (start > 0) snippet = '...' + snippet;\n if (end < page.content.length) snippet = snippet + '...';\n } else {\n snippet = page.content.substring(0, 200) + '...';\n }\n \n results.push({\n path: page.path,\n url: page.url,\n title: page.title,\n score,\n snippet,\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// Vector similarity search (for future use with embeddings)\nexport const vectorSearch = async (\n queryEmbedding: number[],\n pages: Array<{\n path: string;\n url: string;\n title?: string;\n embeddings: number[] | null;\n }>,\n options: {\n limit?: number;\n minSimilarity?: number;\n } = {}\n): Promise> => {\n const limit = options.limit || 10;\n const minSimilarity = options.minSimilarity || 0;\n \n const results: Array<{\n path: string;\n url: string;\n title?: string;\n similarity: number;\n }> = [];\n \n for (const page of pages) {\n if (!page.embeddings) {\n continue;\n }\n \n const similarity = cosineSimilarity(queryEmbedding, page.embeddings);\n \n if (similarity >= minSimilarity) {\n results.push({\n path: page.path,\n url: page.url,\n title: page.title,\n similarity,\n });\n }\n }\n \n // Sort by similarity descending\n results.sort((a, b) => b.similarity - a.similarity);\n \n return results.slice(0, limit);\n};\n\n",[144],"930c0938-b8f1-11f0-8e5d-0224a6c84d84","main.tsx",22,["D",1762200814123],12,"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 { generateEmbeddings, searchPages } from \"./search.ts\";\n\nconst app = new Hono();\n\n\n\nconst urls = [\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/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/api-reference.md\",\n \"https://console.groq.com/docs/arize.md\",\n \"https://console.groq.com/docs/autogen.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/browserbase.md\",\n \"https://console.groq.com/docs/browseruse.md\",\n \"https://console.groq.com/docs/changelog.md\",\n \"https://console.groq.com/docs/changelog/compound.md\",\n \"https://console.groq.com/docs/code-execution.md\",\n \"https://console.groq.com/docs/composio.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-beta.md\",\n \"https://console.groq.com/docs/compound/systems/compound-beta-mini.md\",\n \"https://console.groq.com/docs/compound/systems/compound-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/crewai.md\",\n \"https://console.groq.com/docs/deprecations.md\",\n \"https://console.groq.com/docs/e2b.md\",\n \"https://console.groq.com/docs/errors.md\",\n \"https://console.groq.com/docs/exa.md\",\n \"https://console.groq.com/docs/examples.md\",\n \"https://console.groq.com/docs/firecrawl.md\",\n \"https://console.groq.com/docs/flex-processing.md\",\n \"https://console.groq.com/docs/flutterflow.md\",\n \"https://console.groq.com/docs/gradio.md\",\n \"https://console.groq.com/docs/guides/speech-to-text/prompting.md\",\n \"https://console.groq.com/docs/huggingface.md\",\n \"https://console.groq.com/docs/integrations.md\",\n \"https://console.groq.com/docs/jigsawstack.md\",\n \"https://console.groq.com/docs/langchain.md\",\n \"https://console.groq.com/docs/legacy-changelog.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/litellm.md\",\n \"https://console.groq.com/docs/livekit.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/openai.md\",\n \"https://console.groq.com/docs/overview.md\",\n \"https://console.groq.com/docs/parallel.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/tavily.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/toolhouse.md\",\n \"https://console.groq.com/docs/vision.md\",\n \"https://console.groq.com/docs/web-search.md\",\n \"https://console.groq.com/docs/wolfram-alpha.md\",\n \"https://console.groq.com/docs/xrx.md\",\n \"https://console.groq.com/docs/your-data.md\",\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 return c.json(data);\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\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 // Get all pages for searching\n const pageData = await Promise.all(\n urls.map(async (url) => {\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 cache first\n const cached = await getFromCache(url);\n \n if (cached) {\n const frontmatter = cached.frontmatter;\n return {\n path,\n url: cached.frontmatter?.urlSource || url,\n content: cached.content,\n title: frontmatter?.title || path,\n embeddings: cached.embeddings,\n metadata: cached.metadata,\n };\n }\n \n // If not cached, fetch it (but don't cache during search to avoid slowing down)\n try {\n const pageData = await getPageByPath(path, false);\n if (pageData) {\n const frontmatter = parseFrontmatter(pageData.content);\n return {\n path,\n url: pageData.url,\n content: pageData.content,\n title: frontmatter?.title || path,\n embeddings: null, // Not generated yet\n metadata: null,\n };\n }\n } catch (error) {\n // Skip pages that fail to fetch\n return null;\n }\n \n return null;\n })\n );\n \n // Filter out nulls\n const validPages = pageData.filter((p): p is NonNullable => p !== null);\n \n // Perform search\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\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\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\nexport default (typeof Deno !== \"undefined\" && Deno.env.get(\"valtown\")) ? app.fetch : app;\n","groqdocs",[151],"657bf32a-b8e7-11f0-9be7-0224a6c84d84","main-old.tsx","657bf3c0-b8e7-11f0-9be7-0224a6c84d84",7,["D",1762196442795],"import { Hono } from \"https://deno.land/x/hono@v3.11.7/mod.ts\";\nimport \"jsr:@std/dotenv/load\";\n\nconst app = new Hono();\n\n\nconst getTextFromUrl = async (url) => {\n const response = await fetch(\"https://r.jina.ai/\"+url);\n const text = await response.text();\n return text;\n};\n\nconst stripExistingFrontmatter = (text) => {\n // Remove any existing YAML frontmatter (between --- markers at start)\n const frontmatterRegex = /^---\\s*\\n[\\s\\S]*?\\n---\\s*\\n?/;\n return text.replace(frontmatterRegex, '').trim();\n};\n\nconst extractMetadata = (text, url) => {\n let title = '';\n let description = '';\n let image = '';\n \n // Jina includes \"Title: ...\" in the output\n const titleMatch = text.match(/^Title:\\s*(.+?)(?:\\n|$)/m);\n if (titleMatch) {\n title = titleMatch[1].trim();\n } else {\n // Fallback to first heading\n const headingMatch = text.match(/^#+\\s+(.+)$/m);\n if (headingMatch) {\n title = headingMatch[1].trim();\n }\n }\n \n // Try to find description (usually first paragraph after title)\n const descMatch = text.match(/Description:\\s*(.+?)(?:\\n|$)/i) || \n text.match(/^(?!#|Title:|URL Source:)(.+?)(?:\\n\\n|\\n#)/m);\n if (descMatch) {\n description = descMatch[1].trim();\n }\n \n // Try to find og:image or image metadata\n const imageMatch = text.match(/og:image[:\\s]+(.+?)(?:\\n|$)/i) ||\n text.match(/image[:\\s]+(.+?)(?:\\n|$)/i);\n if (imageMatch) {\n image = imageMatch[1].trim();\n }\n \n return { title, description, image };\n};\n\nconst cleanJinaContent = (text) => {\n // Remove Jina's metadata lines like \"Title:\", \"URL Source:\", \"Markdown Content:\"\n let cleaned = text\n .replace(/^Title:\\s*.+$/gm, '')\n .replace(/^URL Source:\\s*.+$/gm, '')\n .replace(/^Markdown Content:\\s*$/gm, '')\n .replace(/^={10,}$/gm, '') // Remove separator lines\n .trim();\n \n // Remove extra blank lines\n cleaned = cleaned.replace(/\\n{3,}/g, '\\n\\n');\n \n return cleaned;\n};\n\nconst formatWithYamlHeader = (url, text) => {\n // Strip any existing frontmatter first\n let cleanedText = stripExistingFrontmatter(text);\n \n // Extract metadata before cleaning content\n const metadata = extractMetadata(cleanedText, url);\n \n // Clean up the content\n cleanedText = cleanJinaContent(cleanedText);\n \n return `---\ntitle: ${metadata.title || url}\ndescription: ${metadata.description || ''}\nimage: ${metadata.image || ''}\nurlSource: ${url}\n---\n\n${cleanedText}\n`;\n};\n\n\nconst urls = [\n \"https://console.groq.com/docs/quickstart\",\n \"https://console.groq.com/docs/openai\",\n \"https://console.groq.com/docs/models\",\n \"https://console.groq.com/docs/rate-limits\",\n \"https://console.groq.com/docs/text-chat\",\n \"https://console.groq.com/docs/speech-to-text\",\n \"https://console.groq.com/docs/text-to-speech\",\n \"https://console.groq.com/docs/reasoning\",\n \"https://console.groq.com/docs/vision\",\n \"https://console.groq.com/docs/agentic-tooling\",\n \"https://console.groq.com/docs/batch\",\n \"https://console.groq.com/docs/flex-processing\",\n \"https://console.groq.com/docs/content-moderation\",\n \"https://console.groq.com/docs/prefilling\",\n \"https://console.groq.com/docs/tool-use\",\n \"https://console.groq.com/docs/libraries\",\n];\nconst getPageContent = async () => {\n const promises = urls.map(async url => {\n const text = await getTextFromUrl(url);\n return formatWithYamlHeader(url, text);\n });\n const texts = await Promise.all(promises);\n return texts.join(\"\\n\\n\");\n};\n\n\n\n\napp.get(\"/\", async (c) => {\n const content = await getPageContent();\n return c.text(content);\n});\n\nexport default (typeof Deno !== \"undefined\" && Deno.env.get(\"valtown\")) ? app.fetch : app;\n",[160],"9315b67c-b8f1-11f0-85fe-0224a6c84d84",["D",1762200814266],[27],"7ecd5b6e-b8ee-11f0-8d74-0224a6c84d84","deno.json","656e5404-b8e7-11f0-a061-0224a6c84d84",17,["D",1762199491670],1,"{\n \"tasks\": {\n \"serve\": \"deno serve --allow-net --allow-import --allow-read --allow-write --allow-env main.tsx\"\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}",[170],"7eddfda2-b8ee-11f0-9b38-0224a6c84d84","README.md","6566e58e-b8e7-11f0-9e62-0224a6c84d84",18,["D",1762199491669],"# 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, and token counts in SQLite\n- Token counting using tiktoken (GPT-4 encoding)\n- AI-generated metadata (categories, tags, use cases, sample questions)\n- Rate limiting with async-sema to avoid WAF blocking\n- RESTful API endpoints for accessing pages and managing cache\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\nPOST /cache/recalculate\n```\n\nThis will:\n- Fetch all pages from the URLs list\n- Calculate token counts for each page\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 121+ pages and calculates tokens for each. Be patient!\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\n\n### ⚠️ Partial Updates\n\nFor single page updates, you can use:\n\n```bash\nPOST /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 to catch any documentation updates\n- **After major docs changes**: Clear and recalculate\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 /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#### `POST /cache/clear`\nClear the entire cache.\n\n**Response:**\n```json\n{\n \"message\": \"Cache cleared\"\n}\n```\n\n#### `POST /cache/clear/:path`\nClear cache for a specific page.\n\n**Example:**\n```bash\nPOST /cache/clear/api-reference\n```\n\n**Response:**\n```json\n{\n \"message\": \"Cache cleared for api-reference\"\n}\n```\n\n#### `POST /cache/recalculate`\nRecalculate all pages (bypasses cache, fetches fresh, recaches everything).\n\n**Response:**\n```json\n{\n \"message\": \"Recalculated 121 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 },\n ...\n ]\n}\n```\n\n**Important**: This can take several minutes depending on:\n- Number of pages (currently 121)\n- Network speed\n- Token calculation time\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 (\n url TEXT PRIMARY KEY,\n content TEXT NOT NULL,\n charCount INTEGER NOT NULL,\n tokenCount INTEGER,\n frontmatter TEXT NOT NULL,\n cachedAt INTEGER NOT NULL\n)\n```\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## 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## Development\n\n### Local Development\n\n```bash\ndeno run --allow-net --allow-env main.tsx\n```\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\n",[178],"6575fc7c-b8e7-11f0-ba05-0224a6c84d84","AGENTS.md","6575fd58-b8e7-11f0-ba05-0224a6c84d84",6,["D",1762196442671],"You are an advanced assistant specialized in generating Val Town code.\n\n## Core Guidelines\n\n- Ask clarifying questions when requirements are ambiguous\n- Provide complete, functional solutions rather than skeleton implementations\n- Test your logic against edge cases before presenting the final solution\n- Ensure all code follows Val Town's specific platform requirements\n- If a section of code that you're working on is getting too complex, consider refactoring it into subcomponents\n\n## Code Standards\n\n- Generate code in TypeScript or TSX\n- Add appropriate TypeScript types and interfaces for all data structures\n- Prefer official SDKs or libraries than writing API calls directly\n- Ask the user to supply API or library documentation if you are at all unsure about it\n- **Never bake in secrets into the code** - always use environment variables\n- Include comments explaining complex logic (avoid commenting obvious operations)\n- Follow modern ES6+ conventions and functional programming practices if possible\n\n## Types of triggers\n\n### 1. HTTP Trigger\n\n- Create web APIs and endpoints\n- Handle HTTP requests and responses\n- Example structure:\n\n```ts\nexport default async function (req: Request) {\n return new Response(\"Hello World\");\n}\n```\n\nFiles that are HTTP triggers have http in their name like `foobar.http.tsx`\n\n### 2. Cron Triggers\n\n- Run on a schedule\n- Use cron expressions for timing\n- Example structure:\n\n```ts\nexport default async function () {\n // Scheduled task code\n}\n```\n\nFiles that are Cron triggers have cron in their name like `foobar.cron.tsx`\n\n### 3. Email Triggers\n\n- Process incoming emails\n- Handle email-based workflows\n- Example structure:\n\n```ts\nexport default async function (email: Email) {\n // Process email\n}\n```\n\nFiles that are Email triggers have email in their name like `foobar.email.tsx`\n\n\n## Val Town Standard Libraries\n\nVal Town provides several hosted services and utility functions.\n\n### Blob Storage\n\n```ts\nimport { blob } from \"https://esm.town/v/std/blob\";\nawait blob.setJSON(\"myKey\", { hello: \"world\" });\nlet blobDemo = await blob.getJSON(\"myKey\");\nlet appKeys = await blob.list(\"app_\");\nawait blob.delete(\"myKey\");\n```\n\n### SQLite\n\n```ts\nimport { sqlite } from \"https://esm.town/v/stevekrouse/sqlite\";\nconst TABLE_NAME = 'todo_app_users_2';\n// Create table - do this before usage and change table name when modifying schema\nawait sqlite.execute(`CREATE TABLE IF NOT EXISTS ${TABLE_NAME} (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL\n)`);\n// Query data\nconst result = await sqlite.execute(`SELECT * FROM ${TABLE_NAME} WHERE id = ?`, [1]);\n```\n\nNote: When changing a SQLite table's schema, change the table's name (e.g., add _2 or _3) to create a fresh table.\n\n### OpenAI\n\n```ts\nimport { OpenAI } from \"https://esm.town/v/std/openai\";\nconst openai = new OpenAI();\nconst completion = await openai.chat.completions.create({\n messages: [\n { role: \"user\", content: \"Say hello in a creative way\" },\n ],\n model: \"gpt-4o-mini\",\n max_tokens: 30,\n});\n```\n\n### Email\n\n```ts\nimport { email } from \"https://esm.town/v/std/email\";\n// By default emails the owner of the val\nawait email({ \n subject: \"Hi\", \n text: \"Hi\", \n html: \"

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",[185],"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",[192],"pulls","branches","forks","envVars",{"_205":60,"_207":60},"connections",{"_205":60,"_206":60},"count","unfilledCount","emptyCount",{"_41":191,"_31":192,"_29":193,"_136":-5,"_39":40,"_38":194,"_138":24,"_36":242,"_13":60,"_32":20,"_34":196,"_23":24,"_141":-5,"_218":243,"_26":244},{"_41":184,"_31":185,"_29":186,"_136":-5,"_39":40,"_38":187,"_138":47,"_36":239,"_13":60,"_32":20,"_34":189,"_23":24,"_141":-5,"_218":240,"_26":241},{"_41":177,"_31":178,"_29":179,"_136":-5,"_39":40,"_38":180,"_138":24,"_36":236,"_13":174,"_32":20,"_34":182,"_23":24,"_141":-5,"_218":237,"_26":238},{"_41":169,"_31":170,"_29":171,"_136":-5,"_39":40,"_38":172,"_138":24,"_36":233,"_13":174,"_32":20,"_34":175,"_23":24,"_141":-5,"_218":234,"_26":235},{"_41":166,"_31":27,"_29":30,"_136":-5,"_39":40,"_38":14,"_138":47,"_36":230,"_13":60,"_32":33,"_34":35,"_23":24,"_141":-5,"_218":231,"_26":232},{"_41":159,"_31":160,"_29":161,"_136":-5,"_39":40,"_38":162,"_138":24,"_36":227,"_13":60,"_32":33,"_34":164,"_23":24,"_141":-5,"_218":228,"_26":229},{"_41":150,"_31":151,"_29":55,"_136":-5,"_39":40,"_38":152,"_138":24,"_36":224,"_13":154,"_32":155,"_34":156,"_23":24,"_141":157,"_218":225,"_26":226},{"_41":143,"_31":144,"_29":145,"_136":-5,"_39":40,"_38":146,"_138":24,"_36":221,"_13":60,"_32":33,"_34":148,"_23":24,"_141":-5,"_218":222,"_26":223},{"_41":133,"_31":134,"_29":135,"_136":-5,"_39":40,"_38":137,"_138":24,"_36":217,"_13":60,"_32":20,"_34":140,"_23":24,"_141":-5,"_218":219,"_26":220},["D",1762199491650],"children",[],[134],["D",1762200814117],[],[144],["D",1762200814123],[],[151],["D",1762196442795],[],[160],["D",1762200814266],[],[27],["D",1762199491670],[],[170],["D",1762199491669],[],[178],["D",1762196442671],[],[185],["D",1762196442809],[],[192],["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":282,"_283":284,"_285":286,"_287":24,"_288":24,"_289":24,"_290":47,"_291":-5,"_292":-7,"_293":-7,"_294":60,"_295":24,"_296":24,"_297":-5,"_298":24,"_299":24,"_300":24,"_301":-5},"ENV",{"_253":254,"_255":256,"_257":84,"_258":259,"_260":261,"_262":263,"_264":265,"_266":267,"_268":269,"_270":271,"_272":273,"_274":275,"_276":277,"_278":279,"_280":281},"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 · v23