{APP_NAME}

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_602":603,"_604":605},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":16,"_18":19,"_17":-7,"_454":-5,"_20":455,"_22":456,"_457":458,"_459":460,"_26":461,"_24":462,"_463":-5,"_464":-5,"_465":51,"_466":467,"_468":43,"_469":-5,"_470":-5,"_471":472},"routes/_app.x.$handle.$name.branch.$branch.code.$",{"_11":12,"_13":14,"_15":16,"_17":-7,"_18":19,"_20":21,"_22":23,"_24":25,"_26":27,"_28":-5,"_29":-5,"_30":-5,"_31":-5,"_32":-5},"handle","ttai","name","uFns","branchName","main","version","path",".env.sample","project",{"_33":396,"_13":14,"_44":397,"_398":-5,"_399":51,"_400":401,"_402":401,"_403":404,"_405":-5,"_406":407,"_408":74,"_409":43,"_410":-5,"_411":-5,"_412":46,"_413":414,"_415":416,"_417":418,"_419":420,"_421":-5,"_422":423,"_424":423,"_425":426,"_427":426,"_428":426,"_429":423,"_430":423,"_431":432,"_433":434,"_435":436,"_437":51},"tree",[54,55,56,57,58,59,60,61],"file",{"_33":34,"_13":19,"_35":36,"_37":-5,"_38":39,"_40":41,"_42":43,"_44":45,"_17":46,"_47":24,"_48":49,"_50":51,"_52":-5,"_18":53},"contents",[],"upstream","pull","ahead","behind","envVars","id","62fccb20-2409-47d1-b439-93272bd0e887","fileId","e81e6098-9018-11f1-ba51-1607ee4eb77e","parentId","branchId","5ce0246c-39c2-47d2-86b7-4133abafc79e","branchVersion",36,"latest",true,"createdAt",["D",1785857207264],0,"fileType","content","# Val Town env vars for uFns (set in the Val Town sidebar — Deno.env.set() is a no-op).\n\n# Comma-separated Val Town usernames allowed into the admin UI (/, /settings, /info).\n# Case-insensitive; unset or empty = nobody gets in (signed-in visitors see \"Access denied\").\nADMIN_USERS=\n","deleted",false,"label",[19],{"_33":256,"_13":257,"_35":258,"_37":-5,"_38":39,"_40":144,"_42":43,"_44":259,"_17":46,"_47":116,"_48":-5,"_50":51,"_52":-5,"_69":260,"_18":261},{"_33":111,"_13":112,"_35":113,"_37":-5,"_38":39,"_40":114,"_42":43,"_44":115,"_17":46,"_47":116,"_48":-5,"_50":51,"_52":-5,"_69":117,"_18":118},{"_33":34,"_13":19,"_35":36,"_37":-5,"_38":39,"_40":41,"_42":43,"_44":108,"_17":46,"_47":24,"_48":49,"_50":51,"_52":-5,"_69":109,"_18":110},{"_33":99,"_13":100,"_35":101,"_37":-5,"_38":39,"_40":102,"_42":43,"_44":103,"_17":104,"_47":24,"_48":105,"_50":51,"_52":-5,"_69":106,"_18":107},{"_33":90,"_13":91,"_35":92,"_37":-5,"_38":39,"_40":93,"_42":43,"_44":94,"_17":46,"_47":95,"_48":96,"_50":51,"_52":-5,"_69":97,"_18":98},{"_33":82,"_13":83,"_35":84,"_37":-5,"_38":39,"_40":85,"_42":43,"_44":86,"_17":46,"_47":24,"_48":87,"_50":51,"_52":-5,"_69":88,"_18":89},{"_33":72,"_13":73,"_35":74,"_37":-5,"_38":39,"_40":75,"_42":43,"_44":76,"_17":67,"_47":77,"_48":78,"_50":51,"_52":79,"_69":80,"_18":81},{"_33":62,"_13":63,"_35":64,"_37":-5,"_38":39,"_40":65,"_42":43,"_44":66,"_17":67,"_47":24,"_48":68,"_50":51,"_52":-5,"_69":70,"_18":71},"2a4d1b1e-e1cb-4ccc-ba12-27b29f553f8d","val.yml","ec9d2eac-6128-11f1-a087-1607ee4eb77e",99,["D",1785864194556],4,"# val.yml — metadata contract for this val. Not consumed by `vt` today; reserved\n# for a future repo wrapper over vt-cli (safer deploys, env checks, file typing).\nname: \"uFns\"\norg: \"ttai\"\npublic: true\n# Mock/dev integration fns behind one global API key + a beer.css admin UI\n# gated to ADMIN_USERS via Val Town OAuth (see backend/auth.ts). Dev/staging only.\n# Only index.http.ts is the HTTP val and cron.ts the interval val. Other files\n# must avoid Val Town's reserved filename infixes (http, cron, email, …) — e.g.\n# backend/api.ts, not backend/http.ts (previously a stray second HTTP val).\nfiles:\n index.http.ts: http\n cron.ts: interval\n","children",[],[63],"41da38a5-1c51-47ca-811e-1cee58ea9d1f","index.http.ts","ecb9a046-6128-11f1-a23b-1607ee4eb77e",98,["D",1785864195231],"http","// index.http.ts — HTTP entry point built on Hono. Two surfaces:\n// Fn calls → /get-user-details, /get-information*, /webhook — POST-only,\n// each requires the global API key (Authorization: Bearer ).\n// Admin UI → / (tabs), POST /settings, POST /api-key/regenerate — Val Town\n// OAuth, gated to the ADMIN_USERS allow-list (see backend/auth.ts).\n// This file is pure wiring; logic lives in backend/ and frontend/.\n\nimport { Hono } from \"npm:hono@^4\";\nimport type { Context, Next } from \"npm:hono@^4\";\nimport { isHttpError } from \"./backend/api.ts\";\nimport { authenticateApi, getAdminUc, withValTownAuth } from \"./backend/auth.ts\";\nimport { getInformationSlow } from \"./backend/fns/get-information-slow.ts\";\nimport { getInformation } from \"./backend/fns/get-information.ts\";\nimport { getUserDetails } from \"./backend/fns/get-user-details.ts\";\nimport { webhookHandler } from \"./backend/fns/webhook.ts\";\nimport { buildAdminView } from \"./backend/pages/admin.ts\";\nimport { regenerateApiKey, saveSettingsForm } from \"./backend/settings-store.ts\";\nimport { html, jsonError } from \"./backend/shared.ts\";\nimport { renderAdmin } from \"./frontend/admin.tsx\";\nimport { renderDenied, renderLogin } from \"./frontend/auth.tsx\";\nimport type { AdminUser } from \"./frontend/layout.tsx\";\n\nconst app = new Hono<{ Variables: { adminUser: AdminUser } }>();\n\n// ------------------------------------------------------------------------------\n// fn routes — POST-only, each gated by the global API key\n// ------------------------------------------------------------------------------\n\nasync function apiKeyGate(c: Context, next: Next): Promise {\n await authenticateApi(c.req.raw);\n await next();\n}\n\napp.post(\"/get-user-details\", apiKeyGate, async (c) => await getUserDetails(c.req.raw));\napp.post(\"/get-information\", apiKeyGate, async (c) => await getInformation(c.req.raw));\napp.post(\"/get-information-slow\", apiKeyGate, async (c) => await getInformationSlow(c.req.raw));\napp.post(\"/webhook\", apiKeyGate, async (c) => await webhookHandler(c.req.raw));\n\n// ------------------------------------------------------------------------------\n// admin UI — Val Town OAuth, then the tabbed page + its two action routes\n// ------------------------------------------------------------------------------\n\nasync function adminGate(c: Context<{ Variables: { adminUser: AdminUser } }>, next: Next) {\n const uc = await getAdminUc(c.req.raw);\n if (!uc.isAuthed) return html(renderLogin(), 401);\n if (!uc.isAdmin) return html(renderDenied(uc.username ?? \"\"), 403);\n c.set(\"adminUser\", { username: uc.username ?? \"\", avatarUrl: uc.avatarUrl });\n await next();\n}\n\napp.get(\"/\", adminGate, async (c) => {\n const saved = c.req.query(\"saved\") === \"1\";\n const view = await buildAdminView(new URL(c.req.url), saved);\n return html(renderAdmin(view, c.get(\"adminUser\")));\n});\n\napp.post(\"/settings\", adminGate, async (c) => {\n await saveSettingsForm(c.req.raw);\n return c.redirect(\"/?saved=1#data\", 303);\n});\n\napp.post(\"/api-key/regenerate\", adminGate, async (c) => {\n await regenerateApiKey();\n return c.redirect(\"/?saved=1#data\", 303);\n});\n\n// ------------------------------------------------------------------------------\n// error handling\n// ------------------------------------------------------------------------------\n\napp.onError((err) => {\n if (isHttpError(err)) return jsonError(err.message, err.status);\n console.error(\"[uFns] unhandled error:\", err instanceof Error ? err.message : err);\n return jsonError(\"Internal server error\", 500);\n});\napp.notFound((c) => jsonError(`Not found: ${c.req.path}`, 404));\n\nexport default withValTownAuth((req) => app.fetch(req));\n","micro-fns",[],[73],"e70eafe0-39e0-45c4-8d7e-4abf2fd344df","deno.json","ec82e4ac-6128-11f1-9fb3-1607ee4eb77e",8,["D",1780696381966],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/348900b8b79f4a434cab4c74b3bc8d4d2fa8ee74/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": false,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\"dom\", \"dom.iterable\", \"dom.asynciterable\", \"deno.ns\", \"deno.unstable\"]\n },\n \"fmt\": {\n \"lineWidth\": 100\n },\n \"lint\": {\n \"rules\": {\n \"exclude\": [\"no-explicit-any\", \"no-external-import\", \"no-import-prefix\"]\n }\n },\n \"node_modules_dir\": false,\n \"unstable\": [\"temporal\", \"worker-options\", \"sloppy-imports\", \"node-globals\"]\n}\n",[],[83],"612c8dcf-a5cf-490b-8aad-f4f05d872659","cron.ts","eccd21ac-6128-11f1-ac3a-1607ee4eb77e",16,["D",1780696382454],"interval","// cron.ts — Scheduled cleanup: prune logs older than RETENTION_DAYS.\n\nimport { RETENTION_DAYS } from \"./backend/config.ts\";\nimport { deleteOldData } from \"./backend/db.ts\";\n\nexport default async function cleanup() {\n const result = await deleteOldData(RETENTION_DAYS);\n console.log(\n `Cleanup done: deleted ${result.requests} request(s), ${result.webhooks} webhook(s) older than ${RETENTION_DAYS}d`,\n );\n}\n",[],[91],"bf4228e0-d3ee-45c8-9c79-df13780b2579","README.md","eca9edfe-6128-11f1-90f7-1607ee4eb77e",111,["D",1785875509829],7,"# uFns\n\nSmall integration functions for ToughTongue AI — mock user details, weather + headlines lookups,\nwebhook capture, and a single tabbed admin UI (Data / Debug / Activity / Info).\n\nPair with **uAgents** for heavier per-customer agent APIs behind header secrets.\n\n| Val | Role |\n| ----------- | ---------------------------------------------------------------- |\n| **uFns** | Lightweight integration fns (`/get-user-details`, `/webhook`, …) |\n| **uAgents** | Customer-scoped agent fns at `/fns//` |\n\nDeployed to the `ttai` org on Val Town (`vt create … --org-name ttai`).\n\n## Auth\n\nTwo independent surfaces:\n\n- **Fn calls** — one **global API key**, sent as `Authorization: Bearer ` (or\n `X-API-Key: `) on every request. The key is auto-minted on first use, viewable and rotatable\n on the **Data** tab. There is no per-customer scoping (that's what uAgents is for) — one key,\n checked in constant time, guards every fn.\n- **Admin UI** (`/`) — **Val Town sign-in**, gated to an allow-list, same pattern as uAgents. Set\n the `ADMIN_USERS` env var (Val Town sidebar) to a comma-separated list of Val Town usernames\n (case-insensitive). Sign-in uses\n [`std/oauth`](https://docs.val.town/guides/auth/#sign-in-with-val-town); see `backend/auth.ts`.\n\n## Admin UI\n\nA single page at `/` with five hash-routed tabs (`/#data`, `/#debug`, `/#integration`, `/#activity`,\n`/#info`):\n\n| Tab | What |\n| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **Data** | Mock user fields (returned by `/get-user-details`) + the global API key |\n| **Debug** | Pick a fn, edit its JSON body, and fire a live call from the browser — see the resolved URL, `Authorization` header, and an equivalent `curl` update live |\n| **Integration** | Pick a fn and get its endpoint URL, auth header, description, and parameters JSON Schema — ready to paste into a ToughTongue AI tool/function definition |\n| **Activity** | Fn catalog + a live request/webhook log |\n| **Info** | Role, auth model, quick start, pairing with uAgents |\n\n## Fn endpoints\n\nAll POST-only, all require the API key:\n\n| Path | Purpose |\n| ----------------------- | --------------------------------------------------------------------------------------- |\n| `/get-user-details` | Returns the mock user from SQLite |\n| `/get-information` | Weather + headlines, padded to ~3s |\n| `/get-information-slow` | Weather + headlines, padded to ~20s |\n| `/webhook` | Captures a POST body for the Activity log — a regular fn like the rest, not a catch-all |\n\n`/get-information*` accept an optional JSON body `{\"location\": \"Tokyo\"}`; without one they fall back\nto the mock user's `location` (Data tab, default `Paris`).\n\nReady-to-run `curl` examples with the real deployed base URL filled in live on the **Activity** tab\n(empty-state) and the **Info** tab (quick start) — no guessing your val's hostname.\n\n### Weather + headlines API options\n\nBoth fns call **free, keyless** public APIs — no signup, no rate-limit surprises for a dev tool:\n\n- **Weather — [Open-Meteo](https://open-meteo.com)** (chosen). Free forecast + geocoding APIs, no\n API key, no rate limit for reasonable use. Alternatives considered: [wttr.in](https://wttr.in)\n (free, keyless, but plain-text/ANSI-first — JSON is an afterthought) and\n [OpenWeatherMap](https://openweathermap.org/api) (richer data, but requires a free-tier API key —\n adds a required env var for a mock endpoint).\n- **Headlines — [Hacker News (Firebase) API](https://github.com/HackerNews/API)** (chosen). Free,\n keyless, and consistently fast (`topstories.json` + a parallel `item/.json` fetch per story —\n measured ~0.3s per call). Headlines skew tech/HN, not general news. Alternatives considered:\n [GDELT DOC 2.0](https://blog.gdeltproject.org/gdelt-doc-2-0-api-debuts/) (free, keyless, broader\n real-world news coverage via full-text search — but measured ~13s per query from this repo's dev\n network, too slow/unpredictable for a 6–20s budget); **NewsAPI.org** / **GNews** / **currentsapi**\n (broader coverage and categories, but all require a free-tier API key).\n\n## File layout\n\n```\nbackend/\n api.ts HttpError, readJson/readText, dispatch (named api.ts, not\n http.ts — Val Town infers a val's type from its filename;\n only index.http.ts should be an HTTP val)\n auth.ts OAuth admin gate + global API key check\n config.ts mock-user fields, FN_SPECS (fn catalog + Debug samples)\n db.ts SQLite: settings, request log, webhook log\n settings-store.ts mock-user settings + the global API key\n information.ts weather + headlines fetch/pad logic\n fns/ one file per fn handler\n pages/ view-model assembly for SSR (admin.ts, activity.ts)\nfrontend/\n layout.tsx Shell, Tab, Panel, Picker, ReadOnlyField, UserBadge\n admin.tsx composes Data/Debug/Activity/Info into the tabbed page\n data.tsx, debug.tsx, activity.tsx, info.tsx one tab each\n auth.tsx signed-out / access-denied pages\n styles/ modular CSS layers (Next.js-style)\n tokens.ts design tokens + semantic M3 aliases (palette is runtime-generated)\n base.ts document layout + typography scale\n components.ts cards, tabs, key row, fields/buttons/tables, debug box\n index.ts composes layers → GLOBAL_CSS\n```\n\n## Push\n\nFrom this directory:\n\n```bash\nvt create uFns . --org-name ttai --upload-if-exists --no-editor-files\nvt push # ship changes\n```\n\n`val.yml` is not read by `vt` yet — it documents the val contract for a future repo wrapper over\nvt-cli.\n\n## Add a function\n\n1. Write a thin handler in `backend/fns/.ts` — throw `HttpError` for client errors; body\n parsing via `readJson` / `readText` from `backend/api.ts`.\n2. Register it in `ROUTES` inside `index.http.ts`, wrapped in `withAuth(...)` so it requires the\n global API key (dispatch wraps error handling).\n3. Add it to `FN_SPECS` in `backend/config.ts` (path, note, sample body) so it shows up in the\n Activity table and the Debug tab's picker.\n4. `vt push`.\n",[],[100],["D",1785857207264],[],[19],"f3312fd8-02a6-496a-986f-44d7e39f2f13","frontend","ec17eeae-6128-11f1-87d6-1607ee4eb77e",1,["D",1780696381266],"directory",[119,120,121,122,123,124,125,126,127,128,129],[112],{"_33":213,"_13":214,"_35":215,"_37":113,"_38":39,"_40":216,"_42":43,"_44":217,"_17":46,"_47":116,"_48":-5,"_50":51,"_52":-5,"_69":218,"_18":219},{"_33":205,"_13":206,"_35":207,"_37":113,"_38":39,"_40":208,"_42":43,"_44":209,"_17":153,"_47":135,"_48":210,"_50":51,"_52":-5,"_69":211,"_18":212},{"_33":197,"_13":198,"_35":199,"_37":113,"_38":39,"_40":200,"_42":43,"_44":201,"_17":144,"_47":135,"_48":202,"_50":51,"_52":-5,"_69":203,"_18":204},{"_33":189,"_13":190,"_35":191,"_37":113,"_38":39,"_40":192,"_42":43,"_44":193,"_17":114,"_47":135,"_48":194,"_50":51,"_52":-5,"_69":195,"_18":196},{"_33":181,"_13":182,"_35":183,"_37":113,"_38":39,"_40":184,"_42":43,"_44":185,"_17":114,"_47":135,"_48":186,"_50":51,"_52":-5,"_69":187,"_18":188},{"_33":173,"_13":174,"_35":175,"_37":113,"_38":39,"_40":176,"_42":43,"_44":177,"_17":133,"_47":135,"_48":178,"_50":51,"_52":-5,"_69":179,"_18":180},{"_33":165,"_13":166,"_35":167,"_37":113,"_38":39,"_40":168,"_42":43,"_44":169,"_17":153,"_47":135,"_48":170,"_50":51,"_52":-5,"_69":171,"_18":172},{"_33":157,"_13":158,"_35":159,"_37":113,"_38":39,"_40":160,"_42":43,"_44":161,"_17":46,"_47":135,"_48":162,"_50":51,"_52":-5,"_69":163,"_18":164},{"_33":148,"_13":149,"_35":150,"_37":113,"_38":39,"_40":151,"_42":43,"_44":152,"_17":153,"_47":135,"_48":154,"_50":51,"_52":-5,"_69":155,"_18":156},{"_33":139,"_13":140,"_35":141,"_37":113,"_38":39,"_40":142,"_42":43,"_44":143,"_17":144,"_47":135,"_48":145,"_50":51,"_52":-5,"_69":146,"_18":147},{"_33":130,"_13":131,"_35":132,"_37":113,"_38":39,"_40":133,"_42":43,"_44":134,"_17":46,"_47":135,"_48":136,"_50":51,"_52":-5,"_69":137,"_18":138},"4a4fc7c0-88a2-4fc8-907e-a84d47f5d374","utils.ts","ec609fd2-6128-11f1-ac3a-1607ee4eb77e",3,["D",1780696381742],"script","// utils.ts — Formatting helpers for SSR pages.\n\nexport function formatJson(raw: string): string {\n try {\n return JSON.stringify(JSON.parse(raw), null, 2);\n } catch {\n return raw;\n }\n}\n\nexport function truncate(s: string, max: number): string {\n const flat = s.replace(/\\s+/g, \" \").trim();\n return flat.length > max ? flat.slice(0, max) + \"…\" : flat;\n}\n\nexport function isoUtc(ts: string): string {\n return ts.replace(\" \", \"T\") + \"Z\";\n}\n\nexport function methodChip(method: string): string {\n if (method === \"GET\") return \"blue\";\n if (method === \"POST\") return \"green\";\n if (method === \"PUT\" || method === \"PATCH\") return \"orange\";\n if (method === \"DELETE\") return \"red\";\n return \"grey\";\n}\n",[],[112,131],"bccdb792-426f-4081-9aad-a6b7deda33b3","types.ts","ec7b6a4c-6128-11f1-b845-1607ee4eb77e",71,["D",1785861997486],2,"// types.ts — View models passed from backend handlers into SSR pages.\n\nimport type { RequestLogEntry, WebhookLogEntry } from \"../backend/db.ts\";\n\nexport interface UserDetails {\n user_name: string;\n user_email: string;\n dynamic_vars: Record;\n}\n\nexport interface ActivityView {\n requests: RequestLogEntry[];\n webhooks: WebhookLogEntry[];\n reqTotal: number;\n whTotal: number;\n tab: \"requests\" | \"webhooks\";\n page: number;\n totalPages: number;\n}\n\n/** The single admin page: mock user + API key (Data tab) and the Activity log. */\nexport interface AdminView {\n saved: boolean;\n values: Record;\n apiKey: string;\n activity: ActivityView;\n baseUrl: string;\n}\n",[],[112,140],"3e9ce01d-ce1d-47f9-afd5-23fa685528b8","layout.tsx","ec667934-6128-11f1-b2c9-1607ee4eb77e",106,["D",1785871009139],5,"/** @jsxImportSource https://esm.sh/preact@10.29.1 */\n// layout.tsx — Shared beer.css shell: top app bar, hash-based tabs, panels.\n\nimport type { ComponentChildren } from \"https://esm.sh/preact@10.29.1\";\nimport { APP_NAME } from \"../backend/shared.ts\";\nimport { GLOBAL_CSS } from \"./styles/index.ts\";\n\nconst BEER_CSS = \"https://cdn.jsdelivr.net/npm/beercss@4.0.21/dist/cdn/beer.min.css\";\nconst BEER_JS = \"https://cdn.jsdelivr.net/npm/beercss@4.0.21/dist/cdn/beer.min.js\";\nconst MDC_JS =\n \"https://cdn.jsdelivr.net/npm/material-dynamic-colors@1.1.2/dist/cdn/material-dynamic-colors.min.js\";\nconst ICONS =\n \"https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@24,400,0,0\";\n\n/** Brand seed — beer.css generates the full M3 palette from this at runtime.\n * Distinct from uAgents' blue (#2E6BE6) so the two admin UIs read apart. */\nconst BRAND_SEED = \"#7C4DFF\";\n\nexport interface AdminUser {\n username: string;\n avatarUrl?: string;\n}\n\ninterface ShellProps {\n children: ComponentChildren;\n user?: AdminUser;\n}\n\n/** Full HTML document with beer.css and a minimal top app bar. Pass `user` on\n * authenticated admin pages to show the signed-in badge + sign-out button. */\nexport function Shell({ children, user }: ShellProps) {\n return (\n \n \n \n \n {APP_NAME}\n \n \n \n \n