{`uAgents · ${title}`}

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_521":522,"_523":524},"routes/_app.x.$handle.$name",{"_101":100,"_32":46,"_110":91,"_27":54,"_13":14,"_111":-5,"_11":112,"_113":114,"_115":116,"_117":118,"_119":120,"_20":-5,"_121":-5,"_122":-5,"_123":25,"_124":125,"_126":60,"_127":-5,"_128":-5,"_129":130},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_44":45,"_32":46,"_39":47,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":-5,"_18":56,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":70,"_71":72,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":84,"_85":86,"_87":88,"_89":25},"version",144,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":35,"_36":38,"_39":40,"_41":14,"_42":43,"_24":25},"previous",{"_30":31,"_32":33,"_34":35,"_36":37},"deleted",false,"deletedHere","path","frontend/styles/tokens.ts","latestPath","fileId","7dd3613c-6338-11f1-87cb-1607ee4eb77e","name","tokens.ts","fileType","script","content","// tokens.ts — Design tokens as CSS custom properties. The single source of truth\n// for spacing, radii, the type scale, and surface colors. Everything else in the\n// stylesheet references these — change a value here, it propagates everywhere.\n\nexport const TOKENS = `\n:root {\n /* spacing scale */\n --space-1: .25rem; --space-2: .5rem; --space-3: .75rem;\n --space-4: 1rem; --space-5: 1.5rem; --space-6: 2rem;\n\n /* corner radii — deliberately restrained for a flatter, elegant feel */\n --r-sm: .4rem; --r-md: .55rem; --r-lg: .75rem;\n\n /* type scale — compact; one size per role */\n --fs-xs: .75rem; --fs-sm: .8125rem; --fs-md: .9rem;\n --fs-lg: 1rem; --fs-xl: 1.2rem;\n --lh-tight: 1.25; --lh: 1.5;\n\n /* content width + app-bar height */\n --content-w: 960px;\n --bar-h: 3.25rem;\n}\n\n/* Material 3 role mappings — defined on body because beer.css puts the dark\n palette on body.dark (the light palette lives on :root). Referencing them here\n picks up the correct themed values. */\nbody {\n --border: var(--outline-variant);\n --card-bg: var(--surface-container);\n --inset-bg: var(--surface-container-high);\n --accent: var(--primary);\n}\n`;\n","// tokens.ts — Design tokens as CSS custom properties. The single source of truth\n// for spacing, radii, the type scale, and surface colors. Everything else in the\n// stylesheet references these — change a value here, it propagates everywhere.\n\nexport const TOKENS = `\n:root {\n /* spacing scale */\n --space-1: .25rem; --space-2: .5rem; --space-3: .75rem;\n --space-4: 1rem; --space-5: 1.5rem; --space-6: 2rem;\n\n /* corner radii — deliberately restrained for a flatter, elegant feel */\n --r-sm: .4rem; --r-md: .55rem; --r-lg: .75rem;\n\n /* type scale — compact; one size per role */\n --fs-xs: .75rem; --fs-sm: .8125rem; --fs-md: .9rem;\n --fs-lg: 1rem; --fs-xl: 1.2rem;\n --lh-tight: 1.25; --lh: 1.5;\n\n /* content width + app-bar height */\n --content-w: 960px;\n --bar-h: 3.25rem;\n}\n\n/* Brand theme — Material 3 dark palette generated by beer.css's own\n material-dynamic-colors from the blue brand seed (#2E6BE6, matched to the\n logo). Baked in, so there's no runtime theming lib and no purple→blue flash.\n This overrides beer's default purple because it loads after beer.min.css. */\nbody.dark {\n --primary: #b2c5ff; --on-primary: #002b72;\n --primary-container: #0040a1; --on-primary-container: #dae2ff;\n --secondary: #c0c6dd; --on-secondary: #2a3042;\n --secondary-container: #404659; --on-secondary-container: #dce2f9;\n --tertiary: #e1bbdd; --on-tertiary: #412741;\n --tertiary-container: #5a3d59; --on-tertiary-container: #fed7f9;\n --background: #1b1b1f; --on-background: #e4e2e6;\n --surface: #131316; --on-surface: #e4e2e6;\n --surface-variant: #45464f; --on-surface-variant: #c5c6d0;\n --outline: #8f909a; --outline-variant: #45464f;\n --inverse-surface: #e4e2e6; --inverse-on-surface: #303034; --inverse-primary: #0256d1;\n --surface-dim: #131316; --surface-bright: #39393c;\n --surface-container-lowest: #0d0e11; --surface-container-low: #1b1b1f;\n --surface-container: #1f1f23; --surface-container-high: #292a2d;\n --surface-container-highest: #343438;\n}\n\n/* Material 3 role mappings — defined on body because beer.css puts the dark\n palette on body.dark (the light palette lives on :root). Referencing them here\n picks up the correct themed values. Card/inset step up the surface ramp so\n cards read clearly above the page background. */\nbody {\n --border: var(--outline-variant);\n --card-bg: var(--surface-container-high);\n --inset-bg: var(--surface-container-highest);\n --accent: var(--primary);\n}\n`;\n","createdAt",["D",1780925499689],"branchVersion","branchId","b9c38076-09b5-49a6-8d65-4b509f9cce50","id","30ca1bfe-8d0b-41cd-af05-40f09f5a31a1","uAgents",["D",1780696391552],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","","imageUrl","279c3e70-f2b8-11ef-a073-37253b8bcbda","pinnedFileId","f3dc8b86-6128-11f1-854e-1607ee4eb77e","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","019e994f-fcc4-73e9-86ed-2d14fe9f5dfa","tursoName","30ca1bfe8d0b41cdaf0540f09f5a31a1","tursoHostname","30ca1bfe8d0b41cdaf0540f09f5a31a1-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789531852468],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_101":100,"_109":105},"org",{"_101":100,"_102":103,"_104":105,"_18":-5,"_106":107,"_108":25},"branch",{"_13":90,"_32":91,"_44":43,"_92":45,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":46,"_99":100},"isOwned",679,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","ttai","handle","displayName","Tough Tongue AI","avatar","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/4b8edab4-7879-48e2-f777-109aa5256800/square512?exp=1789588799&sig=1e7ad78cdd57075a01956d9db9b0bcccc37046e5fda001d3494bb7ff2313aa1b","tier","free","canRestrictVals","profileImageUrl","branchName","adoptOrgId",{"_44":45,"_32":46,"_39":516,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":-5,"_18":56,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":70,"_71":517,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":518,"_85":519,"_87":520,"_89":25},"tree",[209,230,243,244,245,246,247,248],"files",[209,210,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238,239,240,241,242,243,244,245,246,247,248],"counts",{"_199":64,"_200":164,"_201":64,"_202":203,"_204":205},"contents",[131,132,133,134,135,136,137,138],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_44":193,"_32":194,"_30":195,"_142":-5,"_42":43,"_41":196,"_144":60,"_39":197,"_13":64,"_34":186,"_36":-5,"_24":25,"_148":-5,"_27":198},{"_44":188,"_32":189,"_30":190,"_142":-5,"_42":43,"_41":164,"_144":60,"_39":191,"_13":64,"_34":186,"_36":-5,"_24":25,"_148":-5,"_27":192},{"_44":182,"_32":51,"_30":183,"_142":-5,"_42":43,"_41":184,"_144":25,"_39":185,"_13":64,"_34":186,"_36":-5,"_24":25,"_148":-5,"_27":187},{"_44":175,"_32":176,"_30":177,"_142":-5,"_42":43,"_41":178,"_144":25,"_39":179,"_13":64,"_34":20,"_36":180,"_24":25,"_148":-5,"_27":181},{"_44":167,"_32":168,"_30":169,"_142":-5,"_42":43,"_41":170,"_144":25,"_39":171,"_13":172,"_34":20,"_36":173,"_24":25,"_148":-5,"_27":174},{"_44":159,"_32":160,"_30":161,"_142":-5,"_42":43,"_41":162,"_144":25,"_39":163,"_13":164,"_34":20,"_36":165,"_24":25,"_148":-5,"_27":166},{"_44":150,"_32":151,"_30":58,"_142":-5,"_42":43,"_41":152,"_144":25,"_39":153,"_13":154,"_34":155,"_36":156,"_24":25,"_148":157,"_27":158},{"_44":139,"_32":140,"_30":141,"_142":-5,"_42":43,"_41":143,"_144":25,"_39":145,"_13":146,"_34":20,"_36":147,"_24":25,"_148":-5,"_27":149},"7356c43c-13ac-46b4-a8ef-a76ebc76451f","val.yml","f3605d0e-6128-11f1-9354-1607ee4eb77e","parentId",87,"latest",["D",1780918461860],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: \"uAgents\"\norg: \"ttai\"\npublic: true # intended private; free-plan private-val limit forced public at create\n# Single HTTP service. Two surfaces:\n# /c// → customer functions (key auth; cname taken from the URL)\n# a function may or may not invoke an agent internally\n# /admin → Val Town OAuth-gated admin UI (beer.css)\n# Only index.http.ts is the HTTP val. Other files must avoid Val Town's reserved\n# filename infixes (http, cron, email, …) — e.g. core/api.ts, not core/http.ts.\nfiles:\n index.http.ts: http\n# Env vars this App reads. Set them in the Val Town UI sidebar — never in code.\n# required: App will not work without it | optional: has a safe default\nenv:\n ADMIN_USERS: required # comma-separated Val Town usernames allowed into /admin\n OPENAI_API_KEY: required # used by the LangChain agents (/c//)\n OAUTH_STATE_ENCRYPTION_KEY: recommended # AES key for the admin OAuth session cookie; `openssl rand -base64 32`\n","label",[140],"1a6cbc39-0331-4e00-b2a8-58dc407f0219","index.http.ts",127,["D",1780924248432],6,"http","// index.http.ts — HTTP entry point, built on Hono. Two surfaces, one app:\n// /c// → customer functions (each customer is a mounted sub-app)\n// /admin → Val Town OAuth admin UI (gated to ADMIN_USERS)\n// A function may invoke an agent internally; the API doesn't distinguish.\n// This file is pure wiring; logic lives in backend/ and frontend/.\n\nimport { Hono } from \"npm:hono@^4\";\nimport { type AdminUc, getAdminUc, withValTownAuth } from \"./backend/core/auth.ts\";\nimport { buildAdminView, buildCallsView, saveAuthForm } from \"./backend/core/handlers.ts\";\nimport { toErrorResponse } from \"./backend/core/api.ts\";\nimport { mountCustomers } from \"./backend/customers/registry.ts\";\nimport { LOGO_BYTES, LOGO_MIME } from \"./frontend/assets.ts\";\nimport { renderAdmin, renderDenied, renderLogin } from \"./frontend/admin.tsx\";\nimport { renderCalls } from \"./frontend/calls.tsx\";\n\nconst app = new Hono();\n\n// -----------------------------------------------------------------------------\n// public assets — logo / favicon (no auth; served once, browser-cached)\n// -----------------------------------------------------------------------------\nconst logoResponse = () =>\n new Response(new Blob([LOGO_BYTES], { type: LOGO_MIME }), {\n headers: { \"cache-control\": \"public, max-age=604800\" },\n });\napp.get(\"/logo.png\", logoResponse);\napp.get(\"/favicon.ico\", logoResponse);\n\n// -----------------------------------------------------------------------------\n// admin — OAuth gate to ADMIN_USERS, then three pages\n// -----------------------------------------------------------------------------\nconst admin = new Hono<{ Variables: { uc: AdminUc } }>();\n\nadmin.use(\"*\", async (c, next) => {\n const uc = await getAdminUc(c.req.raw);\n if (!uc.isAuthed) return c.html(renderLogin(), 401);\n if (!uc.isAdmin) return c.html(renderDenied(uc.username ?? \"\"), 403);\n c.set(\"uc\", uc);\n await next();\n});\n\nadmin.get(\"/\", async (c) => {\n const uc = c.get(\"uc\");\n const saved = c.req.query(\"saved\") === \"1\";\n const view = await buildAdminView(\n uc.username ?? \"\",\n uc.avatarUrl,\n new URL(c.req.url).origin,\n saved,\n );\n return c.html(renderAdmin(view));\n});\n\nadmin.get(\"/calls\", async (c) => {\n const uc = c.get(\"uc\");\n return c.html(renderCalls(await buildCallsView(uc.username ?? \"\", uc.avatarUrl)));\n});\n\nadmin.post(\"/auth\", async (c) => {\n await saveAuthForm(c.req.raw);\n return c.redirect(\"/admin?saved=1\", 303);\n});\n\n// -----------------------------------------------------------------------------\n// wiring — mount surfaces; one error boundary; JSON 404\n// -----------------------------------------------------------------------------\napp.get(\"/\", (c) => c.redirect(\"/admin\"));\napp.route(\"/admin\", admin);\nmountCustomers(app);\n\napp.onError((err) => {\n const res = toErrorResponse(err);\n if (res) return res;\n throw err; // unknown error → surface the full stack (Val Town best practice)\n});\napp.notFound((c) => c.json({ ok: false, error: `Not found: ${c.req.path}` }, 404));\n\nexport default withValTownAuth((req) => app.fetch(req));\n","uagents",[151],"24194f00-10cf-47fb-bd6a-e98987c1c4f6","deno.json","f353dd04-6128-11f1-ac3a-1607ee4eb77e",89,["D",1780918461984],1,"{\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\": [\n \"https://www.val.town/types/valtown.d.ts\"\n ],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"fmt\": {\n \"lineWidth\": 100,\n \"exclude\": [\".vt\"]\n },\n \"lint\": {\n \"exclude\": [\".vt\"],\n \"rules\": {\n \"exclude\": [\n \"no-explicit-any\",\n \"no-external-import\",\n \"no-import-prefix\"\n ]\n }\n },\n \"node_modules_dir\": false,\n \"unstable\": [\"temporal\", \"worker-options\", \"sloppy-imports\", \"node-globals\"]\n}\n",[160],"444b44cc-7f5d-47ae-8d0d-03ee2a862919","README.md","f3e9fe92-6128-11f1-b4a4-1607ee4eb77e",136,["D",1780924799709],7,"# uAgents\n\nA single Val Town HTTP val ([Hono](https://hono.dev) router) that exposes small, per-customer\n**functions** behind a per-customer API key, plus a [beer.css](https://www.beercss.com/) admin UI to\nmanage those keys. A function is a plain request→response unit that **may or may not invoke an\nagent** (LangChain + OpenAI) internally. Deno-native, no build step. Deployed to the `ttai` org.\nPair with **uFns** for lightweight integration endpoints.\n\nTwo surfaces, one val:\n\n| Surface | Path | Auth |\n| --------- | --------------------------- | -------------------------------------- |\n| Functions | `GET\\|POST /c//` | Bearer key, verified for that `cname` |\n| Admin UI | `GET /admin` (`/` → it) | Val Town OAuth, gated to `ADMIN_USERS` |\n\n> This repo does **not** use `vtx`. Use the native `vt` CLI directly. Pushing cleanly is your\n> responsibility.\n\n---\n\n## Layout\n\n```\nuAgents/\n index.http.ts Hono root app: admin sub-app + customer sub-apps + /logo.png\n val.yml name, files contract, env declarations\n deno.json Deno/Val Town compiler + lint config\n .vtignore excludes public/ (Val Town can't host binary files)\n public/uAgents.png source logo image (vt-ignored; embedded in assets.ts)\n backend/\n core/ cross-cutting infrastructure\n shared.ts env(), JSON helpers, mintKey()\n api.ts ApiError, readJsonObject(), error mapping ← mini framework\n db.ts SQLite: customer_auth + call_log\n auth.ts OAuth admin gate + authenticate(req, cname)\n handlers.ts admin view assembly + key-config form save\n agents/ LLM capability — functions call into this\n types.ts Agent / AgentCtx / AgentResult contract\n runtime.ts LangChain ChatOpenAI wiring + runAgent()\n get-a-new-quote.ts the quote agent (structured output)\n customers/ one auth scope per customer; their functions live here\n types.ts Fn / FnCtx / Customer / CustomerSpec contracts\n define.ts defineCustomer() — a Hono sub-app per customer\n builtins.ts reusable functions (echo) customers can register\n registry.ts all customers + mountCustomers() ← register here\n jjs/index.ts customer: Jhaji (echo)\n ttai/\n index.ts customer: ToughTongue AI (echo, get-a-new-quote)\n get-a-new-quote.ts function that invokes the quote agent\n frontend/\n layout.tsx Shell: beer.css doc + top app bar (logo + brand + actions + user)\n shared.tsx doc(), UserBadge (navbar), logout, banner\n assets.ts app logo as base64 → served at /logo.png (favicon + navbar)\n admin.tsx admin (Auth + Debug tabs) / login / denied\n debug.tsx Debug tab: live runner (URL + Authorization + curl + body)\n calls.tsx Recent calls page\n types.ts admin view models\n styles/ modular CSS layers (Next.js-style)\n tokens.ts design tokens: spacing, radii, type scale, surfaces\n base.ts document layout + typography scale\n components.ts cards, key row, tabs, chips, table, debug box\n index.ts composes layers → GLOBAL_CSS\n```\n\n> File naming: only `index.http.ts` is the HTTP entry. Val Town infers a file's val-type from\n> reserved name infixes (`http`, `cron`, `email`, …), so the mini-framework lives in `core/api.ts`,\n> **not** `core/http.ts`.\n\n---\n\n## Auth model (per-customer key, cname in the URL)\n\nThe customer (`cname`) is the first path segment: `/c//`. Auth is scoped to that cname:\n\n- Send the key as `Authorization: Bearer ` (or `X-API-Key: `).\n- Each customer is a [Hono](https://hono.dev) sub-app mounted at `/c/`. Its middleware (bound to\n that `id`) calls `authenticate(req, cname)` — loads ``'s config and compares the bearer\n token to the stored key in constant time. Rejected when the customer is unconfigured/disabled\n (403) or the key is missing/wrong (401). The customer module \"owns\" its name + validation by\n construction. A second middleware records every call (success or denied) to the call log.\n- **Admin UI** is gated by Val Town OAuth — only usernames in `ADMIN_USERS` get in.\n\nKeys are minted in the admin UI (generated on first save, rotatable), stored in SQLite, and shown in\nthe UI so you can copy them. They carry a readable `utt__` prefix, but routing no\nlonger depends on the prefix — the URL's `cname` is authoritative.\n\n---\n\n## Customers & functions\n\nEverything served over the API is a **function** — a `Fn = (ctx) => Response`. Functions are\nregistered per customer and exposed at `/c//`. A function may invoke an agent or not; the\nAPI doesn't distinguish. A customer's `index.ts` declares its functions via\n`defineCustomer({ id, label, fns })`; the factory builds a Hono sub-app, wiring auth + call-logging\nmiddleware (bound to that `id`) and a route per function. Routing, methods, and errors are Hono's\njob — there is no hand-rolled path parsing.\n\nEach customer is a folder under `backend/customers/`. To add one:\n\n1. Copy `backend/customers/jjs/` to `backend/customers//` and edit the id + label.\n2. Register it in `backend/customers/registry.ts`.\n3. In the admin UI, generate + enable its key.\n\nCurrent functions:\n\n- **`echo`** (builtin, all customers) — reflects method, query, and body back to the caller.\n- **`get-a-new-quote`** (`ttai`) — invokes a LangChain + OpenAI agent that invents a fresh, original\n quote. Output is schema-constrained (`quote`, `author`, `theme`) via structured output. Optional\n JSON body `{ \"theme\": \"courage\" }`; otherwise a theme is picked for you.\n\n**Add a function** — drop a file in `backend/customers//` exporting an `Fn`, then add it to that\ncustomer's `fns` map. Reusable functions (like `echo`) live in `backend/customers/builtins.ts`.\n\n**Invoke an agent from a function** — see `customers/ttai/get-a-new-quote.ts`: it adapts the request\ninto an `AgentCtx` and calls `runAgent()`. The runtime (`agents/runtime.ts`) owns all LLM wiring, so\nagents stay declarative; add new agents under `backend/agents/`.\n\n---\n\n## Environment variables\n\nSet these in the **Val Town UI sidebar** — never in code (`Deno.env.set()` is a no-op on Val Town).\nOur own vars are read through `env()` in `backend/core/shared.ts`; declared in `val.yml`.\n`OAUTH_STATE_ENCRYPTION_KEY` is read directly by the Val Town OAuth middleware (`std/oauth`).\n\n| Var | Status | Used by | Purpose |\n| ---------------------------- | ----------- | --------------------------------- | ------------------------------------------------------------ |\n| `ADMIN_USERS` | required | `core/auth.ts` (`/admin`) | Comma-separated Val Town usernames allowed into the admin |\n| `OPENAI_API_KEY` | required | `agents/runtime.ts` | OpenAI key for the LangChain agents (agent-backed functions) |\n| `OAUTH_STATE_ENCRYPTION_KEY` | recommended | `std/oauth` via `withValTownAuth` | AES-GCM key material that encrypts the admin session cookie |\n\nNotes:\n\n- `ADMIN_USERS` example: `alice,bob`. Empty/unset ⇒ nobody can reach `/admin` (everyone is denied).\n- `OPENAI_API_KEY` only matters for agents. Unset ⇒ agent-backed functions return **503**; plain\n functions (e.g. `echo`) still work.\n- `OAUTH_STATE_ENCRYPTION_KEY` — if unset, the middleware auto-generates a key and stores it in Val\n Town blob storage per redirect URI. That works, but **set it explicitly** so admin sessions\n survive redeploys and work on self-hosted runtimes. Any high-entropy string works (it's SHA-256'd\n to a 256-bit AES key); generate one with:\n\n```bash\n# generate a 32-byte base64 key (macOS: append `| pbcopy` to copy it)\nopenssl rand -base64 32\n```\n\nThen paste the value into the val's **Environment Variables** sidebar as\n`OAUTH_STATE_ENCRYPTION_KEY`. `vt` does not manage env vars — they must be set in the Val Town UI.\n\n---\n\n## Local → Val Town with `vt`\n\nRun from **inside this directory** (`exp/vals/uAgents/`).\n\n```bash\nvt status # review what changed\nvt push # push (forceful — revert via the Val Town website if needed)\nvt browse # open the deployed val\n```\n\nFirst push of a brand-new val: `vt create uAgents .`. To link an existing remote val, `vt clone` it\nto a temp dir and move its `.vt/` folder next to this code. After pushing, set the\n[environment variables](#environment-variables) in the Val Town UI.\n\n---\n\n## Try it\n\n```bash\n# 1. In /admin, generate + enable a key for \"ttai\", then:\nexport VT_TTAI_APP_TOKEN=\"generate-from-admin-ui\"\nexport VT_JJS_APP_TOKEN=\"generate-from-admin-ui\"\n\n# plain function (echo)\ncurl -X POST https://uagents.val.run/c/ttai/echo \\\n -H \"Authorization: Bearer $VT_TTAI_APP_TOKEN\" \\\n -H \"Content-Type: application/json\" -d '{\"hi\":\"there\"}'\n\n# agent-backed function (fresh quote)\ncurl -X POST https://uagents.val.run/c/ttai/get-a-new-quote \\\n -H \"Authorization: Bearer $VT_TTAI_APP_TOKEN\" \\\n -H \"Content-Type: application/json\" -d '{\"theme\":\"craftsmanship\"}'\n```\n\nNegative paths (auth + routing) — handy as a quick smoke test:\n\n```bash\nBASE=https://uagents.val.run\n\n# missing key → 401\ncurl -s -o /dev/null -w '%{http_code}\\n' -X POST \"$BASE/c/ttai/echo\" -d '{}'\n\n# wrong key → 401\ncurl -s -o /dev/null -w '%{http_code}\\n' -X POST \"$BASE/c/ttai/echo\" \\\n -H \"Authorization: Bearer nope\" -d '{}'\n\n# unknown customer → 404\ncurl -s -o /dev/null -w '%{http_code}\\n' -X POST \"$BASE/c/nope/echo\" \\\n -H \"Authorization: Bearer $VT_TTAI_APP_TOKEN\" -d '{}'\n\n# unknown function on a real customer → 404\ncurl -s -o /dev/null -w '%{http_code}\\n' -X POST \"$BASE/c/ttai/nope\" \\\n -H \"Authorization: Bearer $VT_TTAI_APP_TOKEN\" -d '{}'\n```\n",[168],"1db9578a-99f7-4045-8315-19bffb1abab3",".vtignore","779e4658-633b-11f1-91a4-1607ee4eb77e",128,["D",1780924248425],"public/\n",[176],"778fd8ad-492a-49a1-8f1c-acaf4a44ad0e","d658787c-633a-11f1-9b14-1607ee4eb77e",117,["D",1780923978042],"directory",[51],"6d14e6de-c8d3-45e7-ba6f-2ed984a1f71b","frontend","f2b2b82a-6128-11f1-9496-1607ee4eb77e",["D",1780696392346],[189],"157d3e42-b14b-4a4a-b3d1-13e8c95b8213","backend","f2d380b4-6128-11f1-b4a4-1607ee4eb77e",2,["D",1780696392550],[194],"pulls","branches","forks","envVars",{"_206":164,"_208":64},"connections",{"_206":64,"_207":64},"count","unfilledCount","emptyCount",{"_44":193,"_32":194,"_30":195,"_142":-5,"_42":43,"_41":196,"_144":60,"_39":513,"_13":64,"_34":186,"_36":-5,"_24":25,"_148":-5,"_250":514,"_27":515},{"_44":508,"_32":492,"_30":486,"_142":195,"_42":43,"_41":509,"_144":60,"_39":510,"_13":64,"_34":186,"_36":-5,"_24":25,"_148":-5,"_250":511,"_27":512},{"_44":501,"_32":406,"_30":502,"_142":486,"_42":43,"_41":503,"_144":25,"_39":504,"_13":164,"_34":35,"_36":505,"_24":25,"_148":-5,"_250":506,"_27":507},{"_44":493,"_32":494,"_30":495,"_142":486,"_42":43,"_41":496,"_144":25,"_39":497,"_13":196,"_34":35,"_36":498,"_24":25,"_148":-5,"_250":499,"_27":500},{"_44":484,"_32":269,"_30":485,"_142":486,"_42":43,"_41":487,"_144":25,"_39":488,"_13":164,"_34":35,"_36":489,"_24":25,"_148":-5,"_250":490,"_27":491},{"_44":479,"_32":446,"_30":440,"_142":195,"_42":43,"_41":480,"_144":60,"_39":481,"_13":64,"_34":186,"_36":-5,"_24":25,"_148":-5,"_250":482,"_27":483},{"_44":471,"_32":472,"_30":473,"_142":440,"_42":43,"_41":474,"_144":25,"_39":475,"_13":64,"_34":35,"_36":476,"_24":25,"_148":-5,"_250":477,"_27":478},{"_44":463,"_32":464,"_30":465,"_142":440,"_42":43,"_41":466,"_144":25,"_39":467,"_13":146,"_34":35,"_36":468,"_24":25,"_148":-5,"_250":469,"_27":470},{"_44":455,"_32":456,"_30":457,"_142":440,"_42":43,"_41":458,"_144":25,"_39":459,"_13":196,"_34":35,"_36":460,"_24":25,"_148":-5,"_250":461,"_27":462},{"_44":447,"_32":448,"_30":449,"_142":440,"_42":43,"_41":450,"_144":25,"_39":451,"_13":273,"_34":35,"_36":452,"_24":25,"_148":-5,"_250":453,"_27":454},{"_44":437,"_32":438,"_30":439,"_142":440,"_42":43,"_41":441,"_144":25,"_39":442,"_13":273,"_34":35,"_36":443,"_24":25,"_148":-5,"_250":444,"_27":445},{"_44":432,"_32":372,"_30":366,"_142":195,"_42":43,"_41":433,"_144":60,"_39":434,"_13":64,"_34":186,"_36":-5,"_24":25,"_148":-5,"_250":435,"_27":436},{"_44":427,"_32":426,"_30":420,"_142":366,"_42":43,"_41":428,"_144":60,"_39":429,"_13":64,"_34":186,"_36":-5,"_24":25,"_148":-5,"_250":430,"_27":431},{"_44":418,"_32":333,"_30":419,"_142":420,"_42":43,"_41":421,"_144":25,"_39":422,"_13":273,"_34":35,"_36":423,"_24":25,"_148":-5,"_250":424,"_27":425},{"_44":413,"_32":100,"_30":399,"_142":366,"_42":43,"_41":414,"_144":60,"_39":415,"_13":64,"_34":186,"_36":-5,"_24":25,"_148":-5,"_250":416,"_27":417},{"_44":405,"_32":406,"_30":407,"_142":399,"_42":43,"_41":408,"_144":25,"_39":409,"_13":164,"_34":35,"_36":410,"_24":25,"_148":-5,"_250":411,"_27":412},{"_44":397,"_32":333,"_30":398,"_142":399,"_42":43,"_41":400,"_144":25,"_39":401,"_13":273,"_34":35,"_36":402,"_24":25,"_148":-5,"_250":403,"_27":404},{"_44":389,"_32":390,"_30":391,"_142":366,"_42":43,"_41":392,"_144":25,"_39":393,"_13":196,"_34":35,"_36":394,"_24":25,"_148":-5,"_250":395,"_27":396},{"_44":381,"_32":382,"_30":383,"_142":366,"_42":43,"_41":384,"_144":25,"_39":385,"_13":64,"_34":35,"_36":386,"_24":25,"_148":-5,"_250":387,"_27":388},{"_44":373,"_32":374,"_30":375,"_142":366,"_42":43,"_41":376,"_144":25,"_39":377,"_13":273,"_34":35,"_36":378,"_24":25,"_148":-5,"_250":379,"_27":380},{"_44":364,"_32":269,"_30":365,"_142":366,"_42":43,"_41":367,"_144":25,"_39":368,"_13":196,"_34":35,"_36":369,"_24":25,"_148":-5,"_250":370,"_27":371},{"_44":188,"_32":189,"_30":190,"_142":-5,"_42":43,"_41":164,"_144":60,"_39":361,"_13":64,"_34":186,"_36":-5,"_24":25,"_148":-5,"_250":362,"_27":363},{"_44":356,"_32":331,"_30":327,"_142":190,"_42":43,"_41":357,"_144":60,"_39":358,"_13":64,"_34":186,"_36":-5,"_24":25,"_148":-5,"_250":359,"_27":360},{"_44":348,"_32":349,"_30":350,"_142":327,"_42":43,"_41":351,"_144":25,"_39":352,"_13":273,"_34":35,"_36":353,"_24":25,"_148":-5,"_250":354,"_27":355},{"_44":340,"_32":341,"_30":342,"_142":327,"_42":43,"_41":343,"_144":25,"_39":344,"_13":146,"_34":35,"_36":345,"_24":25,"_148":-5,"_250":346,"_27":347},{"_44":332,"_32":333,"_30":334,"_142":327,"_42":43,"_41":335,"_144":60,"_39":336,"_13":64,"_34":35,"_36":337,"_24":25,"_148":-5,"_250":338,"_27":339},{"_44":326,"_32":33,"_30":31,"_142":327,"_42":43,"_41":14,"_144":25,"_39":328,"_13":273,"_34":35,"_36":38,"_24":25,"_148":-5,"_250":329,"_27":330},{"_44":317,"_32":318,"_30":319,"_142":190,"_42":43,"_41":320,"_144":25,"_39":321,"_13":322,"_34":35,"_36":323,"_24":25,"_148":-5,"_250":324,"_27":325},{"_44":309,"_32":310,"_30":311,"_142":190,"_42":43,"_41":312,"_144":25,"_39":313,"_13":164,"_34":35,"_36":314,"_24":25,"_148":-5,"_250":315,"_27":316},{"_44":301,"_32":302,"_30":303,"_142":190,"_42":43,"_41":304,"_144":25,"_39":305,"_13":164,"_34":35,"_36":306,"_24":25,"_148":-5,"_250":307,"_27":308},{"_44":293,"_32":294,"_30":295,"_142":190,"_42":43,"_41":296,"_144":25,"_39":297,"_13":146,"_34":35,"_36":298,"_24":25,"_148":-5,"_250":299,"_27":300},{"_44":285,"_32":286,"_30":287,"_142":190,"_42":43,"_41":288,"_144":25,"_39":289,"_13":146,"_34":35,"_36":290,"_24":25,"_148":-5,"_250":291,"_27":292},{"_44":277,"_32":278,"_30":279,"_142":190,"_42":43,"_41":280,"_144":25,"_39":281,"_13":196,"_34":35,"_36":282,"_24":25,"_148":-5,"_250":283,"_27":284},{"_44":268,"_32":269,"_30":270,"_142":190,"_42":43,"_41":271,"_144":25,"_39":272,"_13":273,"_34":35,"_36":274,"_24":25,"_148":-5,"_250":275,"_27":276},{"_44":182,"_32":51,"_30":183,"_142":-5,"_42":43,"_41":184,"_144":25,"_39":265,"_13":64,"_34":186,"_36":-5,"_24":25,"_148":-5,"_250":266,"_27":267},{"_44":175,"_32":176,"_30":177,"_142":-5,"_42":43,"_41":178,"_144":25,"_39":262,"_13":64,"_34":20,"_36":180,"_24":25,"_148":-5,"_250":263,"_27":264},{"_44":167,"_32":168,"_30":169,"_142":-5,"_42":43,"_41":170,"_144":25,"_39":259,"_13":172,"_34":20,"_36":173,"_24":25,"_148":-5,"_250":260,"_27":261},{"_44":159,"_32":160,"_30":161,"_142":-5,"_42":43,"_41":162,"_144":25,"_39":256,"_13":164,"_34":20,"_36":165,"_24":25,"_148":-5,"_250":257,"_27":258},{"_44":150,"_32":151,"_30":58,"_142":-5,"_42":43,"_41":152,"_144":25,"_39":253,"_13":154,"_34":155,"_36":156,"_24":25,"_148":157,"_250":254,"_27":255},{"_44":139,"_32":140,"_30":141,"_142":-5,"_42":43,"_41":143,"_144":25,"_39":249,"_13":146,"_34":20,"_36":147,"_24":25,"_148":-5,"_250":251,"_27":252},["D",1780918461860],"children",[],[140],["D",1780924248432],[],[151],["D",1780918461984],[],[160],["D",1780924799709],[],[168],["D",1780924248425],[],[176],["D",1780923978042],[],[51],"e6c43e3f-a453-4a65-b1fb-325865833366","types.ts","f4109fca-6128-11f1-90f7-1607ee4eb77e",84,["D",1780918461680],3,"// types.ts — View models passed from backend handlers into the admin UI.\n\nexport interface CustomerView {\n id: string;\n label: string;\n fns: string[];\n secret: string;\n enabled: boolean;\n configured: boolean;\n updatedTs: string;\n}\n\nexport interface CallView {\n id: number;\n customer: string;\n fn: string;\n ok: boolean;\n ts: string;\n}\n\nexport interface AdminView {\n username: string;\n avatarUrl?: string;\n baseUrl: string;\n customers: CustomerView[];\n saved: boolean;\n}\n\nexport interface CallsView {\n username: string;\n avatarUrl?: string;\n calls: CallView[];\n}\n",[],[189,269],"7484c24d-ae34-4adf-bfde-7431a73b0049","shared.tsx","fe520698-632d-11f1-aacf-1607ee4eb77e",134,["D",1780924799492],"/** @jsxImportSource https://esm.sh/preact@10.29.1 */\n// shared.tsx — Render helpers + navbar/chrome shared across admin pages.\n\nimport { render } from \"https://esm.sh/preact-render-to-string@6.6.7?deps=preact@10.29.1\";\nimport type { VNode } from \"https://esm.sh/preact@10.29.1\";\n\n/** Serialize a Preact tree into a full HTML document string. */\nexport function doc(node: VNode): string {\n return \"\" + render(node);\n}\n\n/** SQLite `YYYY-MM-DD HH:MM:SS` (UTC) → ISO string for ``. */\nexport function isoUtc(ts: string): string {\n return ts.replace(\" \", \"T\") + \"Z\";\n}\n\n/** Signed-in user pill (avatar + name). Clicking reveals the sign-out popover —\n * toggled by USER_MENU_JS in the Shell. */\nexport function UserMenu({ username, avatarUrl }: { username: string; avatarUrl?: string }) {\n return (\n \n );\n}\n\n/** Signed-out affordance for the top app bar. */\nexport function LoginLink() {\n return (\n \n login\n Sign in\n \n );\n}\n\nexport function LogoutButton({ small }: { small?: boolean }) {\n return (\n \n );\n}\n\nexport function SavedBanner() {\n return (\n

\n check_circle Saved.\n

\n );\n}\n",[],[189,278],"4c750f45-8c72-4a3d-a4b6-9133e70ca059","layout.tsx","f3474b16-6128-11f1-b4a4-1607ee4eb77e",138,["D",1780924799716],"/** @jsxImportSource https://esm.sh/preact@10.29.1 */\n// layout.tsx — Shared beer.css (Material Design 3) document shell. The top app bar\n// is the app's persistent chrome: brand on the left; page actions, the signed-in\n// user, and sign-out on the right. Styling comes from the modular styles/ layer.\n\nimport type { ComponentChildren } from \"https://esm.sh/preact@10.29.1\";\nimport { GLOBAL_CSS } from \"./styles/index.ts\";\nimport { LoginLink, UserMenu } from \"./shared.tsx\";\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 ICONS =\n \"https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@40,400,0,0\";\n\nexport interface ShellUser {\n username: string;\n avatarUrl?: string;\n}\n\ninterface ShellProps {\n title: string;\n user?: ShellUser;\n navActions?: ComponentChildren;\n children: ComponentChildren;\n}\n\n/** Full HTML document: top app bar (brand + actions + user) and a page container. */\nexport function Shell({ title, user, navActions, children }: ShellProps) {\n return (\n \n \n \n \n {`uAgents · ${title}`}\n \n \n \n \n \n \n \n \n

{children}

Diff · v144