{`uAgents · ${title}`}

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_663":664,"_665":666},"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",336,"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","backend/customers/types.ts","latestPath","fileId","94f64bc0-6326-11f1-ba2d-1607ee4eb77e","name","types.ts","fileType","script","content","// types.ts — A customer is an auth scope that owns a set of functions, served at\n// `/c//`. A function is a plain request→response unit; it may or may\n// not invoke an agent internally. Auth config (the API key) lives in SQLite,\n// keyed by the customer `id`. `defineCustomer` (define.ts) turns a spec into a\n// mounted Hono sub-app.\n\nimport type { Hono } from \"npm:hono@^4\";\nimport type { JsonObject } from \"../core/shared.ts\";\nimport type { CustomerSecrets } from \"../core/app.ts\";\n\n// `S` is the customer's own secrets shape (e.g. SecretsJjs). It defaults to the\n// union so shared builtins (echo) can be registered by any customer.\nexport interface FnCtx {\n req: Request;\n url: URL;\n customer: string; // the cname from the URL\n fn: string; // function name, e.g. \"echo\"\n secrets: S; // exactly this customer's declared secrets (see core/app.ts)\n}\n\nexport type Fn = (ctx: FnCtx) => Response | Promise;\n\n/** A function plus optional debug metadata. Register either a bare `Fn` or this. */\nexport interface FnSpec {\n run: Fn;\n /** Example POST body, prefilled in the Debug tab when this function is picked. */\n sampleBody?: JsonObject;\n /** JSON Schema of the POST body — shown on the TTAI Integration tab to paste\n * into a ToughTongue AI tool definition. Follow the function-parameters standard:\n * `{ type: \"object\", properties: { : { type, description } }, required: [...] }`\n * (omit `required` when nothing is mandatory). */\n paramsSchema?: JsonObject;\n}\n\nexport type FnEntry = Fn | FnSpec;\nexport type FnMap = Record>;\n\n/** What a customer folder declares; the factory turns it into a `Customer`. */\nexport interface CustomerSpec {\n id: string; // key prefix + db key, e.g. \"ttai\"\n label: string; // human-friendly name for the admin UI\n secrets: () => S; // resolve this customer's secrets from env (see core/app.ts)\n fns: FnMap;\n}\n\n/** A registered customer: a Hono sub-app (mounted at /c/) that authenticates\n * and dispatches, plus the metadata the admin UI needs. */\nexport interface Customer {\n id: string;\n label: string;\n fnNames: string[];\n sampleBodies: Record; // fn name → example POST body\n paramsSchemas: Record; // fn name → JSON Schema of the body\n app: Hono;\n}\n","// types.ts — A customer is an auth scope that owns a set of functions, served at\n// `/c//`. A function is a plain request→response unit; it may or may\n// not invoke an agent internally. Auth config (the API key) lives in SQLite,\n// keyed by the customer `id`. `defineCustomer` (define.ts) turns a spec into a\n// mounted Hono sub-app.\n\nimport type { Hono } from \"npm:hono@^4\";\nimport type { JsonObject } from \"../core/shared.ts\";\nimport type { CustomerSecrets } from \"../core/app.ts\";\n\n// `S` is the customer's own secrets shape (e.g. SecretsJjs). It defaults to the\n// union so shared builtins (echo) can be registered by any customer.\nexport interface FnCtx {\n req: Request;\n url: URL;\n customer: string; // the cname from the URL\n fn: string; // function name, e.g. \"echo\"\n secrets: S; // exactly this customer's declared secrets (see core/app.ts)\n}\n\nexport type Fn = (ctx: FnCtx) => Response | Promise;\n\n/** A function plus optional debug metadata. Register either a bare `Fn` or this. */\nexport interface FnSpec {\n run: Fn;\n /** What this function does, in plain language — surfaced on the TTAI Integration\n * tab so an external agent can understand the tool. Agent-backed functions\n * inherit their agent's `description` automatically via `agentFn`. */\n description?: string;\n /** Example POST body, prefilled in the Debug tab when this function is picked. */\n sampleBody?: JsonObject;\n /** JSON Schema of the POST body — shown on the TTAI Integration tab to paste\n * into a ToughTongue AI tool definition. Follow the function-parameters standard:\n * `{ type: \"object\", properties: { : { type, description } }, required: [...] }`\n * (omit `required` when nothing is mandatory). */\n paramsSchema?: JsonObject;\n}\n\nexport type FnEntry = Fn | FnSpec;\nexport type FnMap = Record>;\n\n/** What a customer folder declares; the factory turns it into a `Customer`. */\nexport interface CustomerSpec {\n id: string; // key prefix + db key, e.g. \"ttai\"\n label: string; // human-friendly name for the admin UI\n secrets: () => S; // resolve this customer's secrets from env (see core/app.ts)\n fns: FnMap;\n}\n\n/** A registered customer: a Hono sub-app (mounted at /c/) that authenticates\n * and dispatches, plus the metadata the admin UI needs. */\nexport interface Customer {\n id: string;\n label: string;\n fnNames: string[];\n descriptions: Record; // fn name → plain-language description\n sampleBodies: Record; // fn name → example POST body\n paramsSchemas: Record; // fn name → JSON Schema of the body\n app: Hono;\n}\n","createdAt",["D",1780944386592],"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":658,"_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":659,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":660,"_85":661,"_87":662,"_89":25},"tree",[195,233,247,248,249,250],"files",[195,196,197,198,199,200,201,202,203,204,205,206,207,208,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,249,250],"counts",{"_185":64,"_186":162,"_187":64,"_188":189,"_190":191},"contents",[131,132,133,134,135,136],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_44":179,"_32":180,"_30":181,"_140":-5,"_42":43,"_41":182,"_142":60,"_39":183,"_13":64,"_34":177,"_36":-5,"_24":25,"_146":-5,"_27":184},{"_44":173,"_32":174,"_30":175,"_140":-5,"_42":43,"_41":162,"_142":60,"_39":176,"_13":64,"_34":177,"_36":-5,"_24":25,"_146":-5,"_27":178},{"_44":165,"_32":166,"_30":167,"_140":-5,"_42":43,"_41":168,"_142":25,"_39":169,"_13":170,"_34":20,"_36":171,"_24":25,"_146":-5,"_27":172},{"_44":157,"_32":158,"_30":159,"_140":-5,"_42":43,"_41":160,"_142":25,"_39":161,"_13":162,"_34":20,"_36":163,"_24":25,"_146":-5,"_27":164},{"_44":148,"_32":149,"_30":58,"_140":-5,"_42":43,"_41":150,"_142":60,"_39":151,"_13":152,"_34":153,"_36":154,"_24":25,"_146":155,"_27":156},{"_44":137,"_32":138,"_30":139,"_140":-5,"_42":43,"_41":141,"_142":25,"_39":143,"_13":144,"_34":20,"_36":145,"_24":25,"_146":-5,"_27":147},"c0e424dc-0aca-443e-809e-d34ff7e4c74c","val.yml","f3605d0e-6128-11f1-9354-1607ee4eb77e","parentId",212,"latest",["D",1780936729321],7,"# 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\n#\n# Shopify integration is per-customer: it reads `_SHOPIFY_*` (uppercased\n# customer id). Jhaji (`jjs`) → JJS_SHOPIFY_*. Add a merchant by setting their vars.\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 JJS_SHOPIFY_SHOP: optional # jjs Shopify store hostname, e.g. jhaji.myshopify.com (no scheme)\n JJS_SHOPIFY_CLIENT_ID: optional # jjs Dev Dashboard app client id (client-credentials grant)\n JJS_SHOPIFY_CLIENT_SECRET: optional # jjs Dev Dashboard app client secret\n JJS_SHOPIFY_STOREFRONT_TOKEN: optional # jjs Storefront API token (cart mutations)\n","label",[138],"a17d6cb6-e1b8-4017-bfe6-f364eeab5315","index.http.ts",280,["D",1780941501215],10,"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 {\n buildAdminView,\n buildCalls,\n buildCallsView,\n saveAuthForm,\n} from \"./backend/core/handlers.ts\";\nimport { apiErrorHandler } from \"./backend/core/api.ts\";\nimport { mountCustomers } from \"./backend/customers/registry.ts\";\nimport { LOGO_MIME, LOGO_SVG } 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 — SVG logo / favicon (no auth; browser-cached)\n// -----------------------------------------------------------------------------\nconst logoResponse = () =>\n new Response(LOGO_SVG, {\n headers: { \"content-type\": LOGO_MIME, \"cache-control\": \"public, max-age=604800\" },\n });\napp.get(\"/logo.svg\", 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\", (c) => {\n const uc = c.get(\"uc\");\n const view = buildCallsView(uc.username ?? \"\", uc.avatarUrl, new URL(c.req.url).origin);\n return c.html(renderCalls(view));\n});\n\n// JSON feed for the Recent calls page: filter by customer + selected functions.\nadmin.get(\"/calls.json\", async (c) => {\n const customer = c.req.query(\"customer\") ?? \"\";\n const fns = c.req.queries(\"fn\") ?? [];\n return c.json({ calls: await buildCalls(customer, fns) });\n});\n\nadmin.post(\"/auth\", async (c) => {\n await saveAuthForm(c.req.raw);\n return c.redirect(\"/admin?saved=1\", 303);\n});\nadmin.onError(apiErrorHandler);\n\n// -----------------------------------------------------------------------------\n// wiring — mount surfaces; root error boundary; JSON 404\n// -----------------------------------------------------------------------------\napp.get(\"/\", (c) => c.redirect(\"/admin\"));\napp.route(\"/admin\", admin);\nmountCustomers(app);\n\napp.onError(apiErrorHandler);\napp.notFound((c) => c.json({ ok: false, error: `Not found: ${c.req.path}` }, 404));\n\nexport default withValTownAuth((req) => app.fetch(req));\n","uagents",[149],"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",[158],"2a100004-8026-46f1-8d84-f722c16fcfbf","README.md","f3e9fe92-6128-11f1-b4a4-1607ee4eb77e",326,["D",1780943836300],18,"# 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.svg\n val.yml name, files contract, env declarations\n deno.json Deno/Val Town compiler + lint config\n backend/\n core/ cross-cutting infrastructure\n shared.ts env(), JSON helpers, mintKey()\n app.ts static config: globals() + per-customer Secrets types ← registry\n api.ts ApiError, readJsonObject(), error mapping ← mini framework\n db.ts SQLite: customer_auth + call_log (req+resp bodies, batched prune)\n auth.ts OAuth admin gate + authenticate(req, cname)\n handlers.ts admin view assembly + key-config form save + call queries\n agentic-core/ the agent framework — no concrete agents live here\n types.ts Agent / AgentCtx / AgentResult contract\n runtime.ts LangChain ChatOpenAI wiring (global LLM key) + runAgent()\n tool-loop.ts generic model→tools→model loop (reusable by any agent)\n prompt.ts shared input-shaping helpers (withContext, str)\n agents/ concrete agents built on agentic-core\n get-a-new-quote.ts the quote agent (structured output)\n shopify-omni-agent.ts general Shopify operator (full toolset, up to 12 rounds)\n integrations/ external-service modules (one folder per integration)\n shopify/\n config.ts validate a customer's ShopifySecrets → ShopifyConfig (503 on missing)\n token.ts Admin token via client-credentials grant (cached ~24h)\n errors.ts map scope/credential failures to visible 4xx (not masked 502)\n client.ts adminGql() + storefrontGql() (fetch, no SDK)\n snapshot.ts customer profile + pending orders + abandoned checkouts\n cart.ts Storefront cart read / lines add / lines remove\n tools.ts five LangChain tools bound to one store's config\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/\n index.ts customer: Jhaji (echo, get-customer-info, shopify-omni-agent)\n get-customer-info.ts deterministic Shopify read (no LLM)\n shopify-omni-agent.ts function that invokes the omni Shopify agent\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(), UserMenu/LoginLink (navbar), logout, banner\n assets.ts inline SVG \"uA\" logo → served at /logo.svg (favicon + navbar)\n admin.tsx admin (Auth + Debug + TTAI Integration tabs) / login / denied\n debug.tsx Debug tab: live runner (URL + Authorization + curl + body)\n integration.tsx TTAI Integration tab: endpoint URL + params-schema JSON\n calls.tsx Recent calls page (customer + fn filters, expandable req/resp)\n types.ts admin view models\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, 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. An outer middleware records every call (success or denied) to the call log — status,\n latency, and the full request + response bodies (headers stripped, capped).\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- **`get-customer-info`** (`jjs`) — deterministic Shopify Admin read (no LLM). Body with at least\n one of `customer_id` / `email` / `phone` → profile, pending orders, abandoned checkouts. The same\n lookup is also exposed to the omni agent as its `get_customer_info` tool.\n- **`shopify-omni-agent`** (`jjs`) — the single general-purpose Shopify operator. Body\n `{ prompt, customer_id?, cart_id? }`; plans across the full toolset (customer lookup by\n GID/email/phone, pending orders, abandoned checkouts, cart read + add/remove) over up to 12\n rounds, then summarises what it found or changed.\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` or\n`customers/jjs/shopify-omni-agent.ts`: each adapts the request into an `AgentCtx` and calls\n`runAgent()`. The runtime (`agentic-core/runtime.ts`) owns all LLM wiring, so agents stay\ndeclarative; add new concrete agents under `backend/agents/`. Tool-using agents reuse\n`agentic-core/tool-loop.ts` (model→tools→model). The framework lives in `agentic-core/`; `agents/`\nholds only the concrete agents.\n\n**Add an integration** — create `backend/integrations//` with a customer-agnostic client +\nhelpers (see `shopify/`). Resolve per-customer credentials from `__*` env so adding\na merchant is config-only.\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).\nAll config is **static and explicit** in `backend/core/app.ts` (declared in `val.yml`).\n`OAUTH_STATE_ENCRYPTION_KEY` is read directly by the Val Town OAuth middleware (`std/oauth`).\n\n**Two kinds of config, listed explicitly — no prefix magic:**\n\n- **Globals** — `globals()` returns a typed `{ openaiKey, adminUsers }`. Shared infra (the LLM key,\n the admin allow-list); used by the runtime + auth only.\n- **Per-customer secrets** — each customer has a named type (`SecretsJjs`, `SecretsTtai`) and a\n resolver (`jjsSecrets()`) that reads **only that customer's listed env vars** (`JJS_SHOPIFY_*`)\n into a typed object. A customer's `defineCustomer({ secrets })` resolver runs once; every `Fn` /\n `Agent` for that customer is handed its own typed `ctx.secrets` (e.g. a `jjs` function sees\n exactly `SecretsJjs`). Add a customer = add a `Secrets` type + resolver in `app.ts`, then\n pass it in that customer's `index.ts`.\n\n> The isolation is a **soft convention**, not a hard wall — nothing physically stops code from\n> importing `env()`. The value is clarity + types: what each customer can read is declared in one\n> place, and the type system keeps a `jjs` function from reaching another customer's (or a global's)\n> secrets.\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 | `agentic-core/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| `JJS_SHOPIFY_SHOP` | optional | `integrations/shopify` (`jjs`) | jjs store hostname, e.g. `jhaji.myshopify.com` (no scheme) |\n| `JJS_SHOPIFY_CLIENT_ID` | optional | `integrations/shopify/token.ts` | jjs Dev Dashboard app client id — mints Admin tokens |\n| `JJS_SHOPIFY_CLIENT_SECRET` | optional | `integrations/shopify/token.ts` | jjs Dev Dashboard app client secret |\n| `JJS_SHOPIFY_STOREFRONT_TOKEN` | optional | `integrations/shopify` (`jjs`) | jjs Storefront API token — cart mutations |\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- `JJS_SHOPIFY_*` only matter for the `jjs` Shopify functions. A new merchant lists its own vars in\n a `secretsAcme()` resolver (`app.ts`). Unset ⇒ those functions return **503** naming the exact\n var. Storefront token is needed only for cart read + mutations (`shopify-omni-agent`).\n- **Admin auth (Shopify Dev Dashboard):** set `CLIENT_ID` + `CLIENT_SECRET` from the app's Settings\n page. `token.ts` exchanges them for a ~24h Admin token via the client-credentials grant and caches\n it. See\n [Admin & Storefront API → Generate tokens](../../../docs/wiki/integrations/shopify/admin-api.md).\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",[166],"6d14e6de-c8d3-45e7-ba6f-2ed984a1f71b","frontend","f2b2b82a-6128-11f1-9496-1607ee4eb77e",["D",1780696392346],"directory",[174],"157d3e42-b14b-4a4a-b3d1-13e8c95b8213","backend","f2d380b4-6128-11f1-b4a4-1607ee4eb77e",2,["D",1780696392550],[180],"pulls","branches","forks","envVars",{"_192":162,"_194":64},"connections",{"_192":64,"_193":64},"count","unfilledCount","emptyCount",{"_44":179,"_32":180,"_30":181,"_140":-5,"_42":43,"_41":182,"_142":60,"_39":655,"_13":64,"_34":177,"_36":-5,"_24":25,"_146":-5,"_252":656,"_27":657},{"_44":650,"_32":625,"_30":619,"_140":181,"_42":43,"_41":651,"_142":60,"_39":652,"_13":64,"_34":177,"_36":-5,"_24":25,"_146":-5,"_252":653,"_27":654},{"_44":642,"_32":643,"_30":644,"_140":619,"_42":43,"_41":645,"_142":25,"_39":646,"_13":162,"_34":35,"_36":647,"_24":25,"_146":-5,"_252":648,"_27":649},{"_44":634,"_32":635,"_30":636,"_140":619,"_42":43,"_41":637,"_142":25,"_39":638,"_13":310,"_34":35,"_36":639,"_24":25,"_146":-5,"_252":640,"_27":641},{"_44":626,"_32":627,"_30":628,"_140":619,"_42":43,"_41":629,"_142":25,"_39":630,"_13":456,"_34":35,"_36":631,"_24":25,"_146":-5,"_252":632,"_27":633},{"_44":617,"_32":33,"_30":618,"_140":619,"_42":43,"_41":620,"_142":25,"_39":621,"_13":390,"_34":35,"_36":622,"_24":25,"_146":-5,"_252":623,"_27":624},{"_44":612,"_32":604,"_30":598,"_140":181,"_42":43,"_41":613,"_142":60,"_39":614,"_13":64,"_34":177,"_36":-5,"_24":25,"_146":-5,"_252":615,"_27":616},{"_44":605,"_32":494,"_30":606,"_140":598,"_42":43,"_41":607,"_142":25,"_39":608,"_13":182,"_34":35,"_36":609,"_24":25,"_146":-5,"_252":610,"_27":611},{"_44":596,"_32":507,"_30":597,"_140":598,"_42":43,"_41":599,"_142":25,"_39":600,"_13":310,"_34":35,"_36":601,"_24":25,"_146":-5,"_252":602,"_27":603},{"_44":591,"_32":550,"_30":544,"_140":181,"_42":43,"_41":592,"_142":60,"_39":593,"_13":64,"_34":177,"_36":-5,"_24":25,"_146":-5,"_252":594,"_27":595},{"_44":583,"_32":584,"_30":585,"_140":544,"_42":43,"_41":586,"_142":60,"_39":587,"_13":182,"_34":35,"_36":588,"_24":25,"_146":-5,"_252":589,"_27":590},{"_44":575,"_32":576,"_30":577,"_140":544,"_42":43,"_41":578,"_142":25,"_39":579,"_13":182,"_34":35,"_36":580,"_24":25,"_146":-5,"_252":581,"_27":582},{"_44":567,"_32":568,"_30":569,"_140":544,"_42":43,"_41":570,"_142":25,"_39":571,"_13":465,"_34":35,"_36":572,"_24":25,"_146":-5,"_252":573,"_27":574},{"_44":559,"_32":560,"_30":561,"_140":544,"_42":43,"_41":562,"_142":25,"_39":563,"_13":390,"_34":35,"_36":564,"_24":25,"_146":-5,"_252":565,"_27":566},{"_44":551,"_32":552,"_30":553,"_140":544,"_42":43,"_41":554,"_142":25,"_39":555,"_13":465,"_34":35,"_36":556,"_24":25,"_146":-5,"_252":557,"_27":558},{"_44":541,"_32":542,"_30":543,"_140":544,"_42":43,"_41":545,"_142":60,"_39":546,"_13":390,"_34":35,"_36":547,"_24":25,"_146":-5,"_252":548,"_27":549},{"_44":536,"_32":450,"_30":446,"_140":181,"_42":43,"_41":537,"_142":60,"_39":538,"_13":64,"_34":177,"_36":-5,"_24":25,"_146":-5,"_252":539,"_27":540},{"_44":531,"_32":515,"_30":509,"_140":446,"_42":43,"_41":532,"_142":60,"_39":533,"_13":64,"_34":177,"_36":-5,"_24":25,"_146":-5,"_252":534,"_27":535},{"_44":523,"_32":524,"_30":525,"_140":509,"_42":43,"_41":526,"_142":25,"_39":527,"_13":310,"_34":35,"_36":528,"_24":25,"_146":-5,"_252":529,"_27":530},{"_44":516,"_32":342,"_30":517,"_140":509,"_42":43,"_41":518,"_142":25,"_39":519,"_13":268,"_34":35,"_36":520,"_24":25,"_146":-5,"_252":521,"_27":522},{"_44":506,"_32":507,"_30":508,"_140":509,"_42":43,"_41":510,"_142":25,"_39":511,"_13":465,"_34":35,"_36":512,"_24":25,"_146":-5,"_252":513,"_27":514},{"_44":501,"_32":100,"_30":487,"_140":446,"_42":43,"_41":502,"_142":60,"_39":503,"_13":64,"_34":177,"_36":-5,"_24":25,"_146":-5,"_252":504,"_27":505},{"_44":493,"_32":494,"_30":495,"_140":487,"_42":43,"_41":496,"_142":25,"_39":497,"_13":465,"_34":35,"_36":498,"_24":25,"_146":-5,"_252":499,"_27":500},{"_44":485,"_32":342,"_30":486,"_140":487,"_42":43,"_41":488,"_142":25,"_39":489,"_13":390,"_34":35,"_36":490,"_24":25,"_146":-5,"_252":491,"_27":492},{"_44":477,"_32":478,"_30":479,"_140":446,"_42":43,"_41":480,"_142":25,"_39":481,"_13":456,"_34":35,"_36":482,"_24":25,"_146":-5,"_252":483,"_27":484},{"_44":469,"_32":470,"_30":471,"_140":446,"_42":43,"_41":472,"_142":25,"_39":473,"_13":310,"_34":35,"_36":474,"_24":25,"_146":-5,"_252":475,"_27":476},{"_44":460,"_32":461,"_30":462,"_140":446,"_42":43,"_41":463,"_142":25,"_39":464,"_13":465,"_34":35,"_36":466,"_24":25,"_146":-5,"_252":467,"_27":468},{"_44":451,"_32":452,"_30":453,"_140":446,"_42":43,"_41":454,"_142":25,"_39":455,"_13":456,"_34":35,"_36":457,"_24":25,"_146":-5,"_252":458,"_27":459},{"_44":445,"_32":33,"_30":31,"_140":446,"_42":43,"_41":14,"_142":60,"_39":447,"_13":268,"_34":35,"_36":38,"_24":25,"_146":-5,"_252":448,"_27":449},{"_44":440,"_32":383,"_30":435,"_140":181,"_42":43,"_41":441,"_142":60,"_39":442,"_13":64,"_34":177,"_36":-5,"_24":25,"_146":-5,"_252":443,"_27":444},{"_44":434,"_32":384,"_30":377,"_140":435,"_42":43,"_41":436,"_142":60,"_39":437,"_13":64,"_34":177,"_36":-5,"_24":25,"_146":-5,"_252":438,"_27":439},{"_44":426,"_32":427,"_30":428,"_140":377,"_42":43,"_41":429,"_142":25,"_39":430,"_13":162,"_34":35,"_36":431,"_24":25,"_146":-5,"_252":432,"_27":433},{"_44":418,"_32":419,"_30":420,"_140":377,"_42":43,"_41":421,"_142":25,"_39":422,"_13":182,"_34":35,"_36":423,"_24":25,"_146":-5,"_252":424,"_27":425},{"_44":410,"_32":411,"_30":412,"_140":377,"_42":43,"_41":413,"_142":25,"_39":414,"_13":390,"_34":35,"_36":415,"_24":25,"_146":-5,"_252":416,"_27":417},{"_44":402,"_32":403,"_30":404,"_140":377,"_42":43,"_41":405,"_142":25,"_39":406,"_13":182,"_34":35,"_36":407,"_24":25,"_146":-5,"_252":408,"_27":409},{"_44":394,"_32":395,"_30":396,"_140":377,"_42":43,"_41":397,"_142":25,"_39":398,"_13":182,"_34":35,"_36":399,"_24":25,"_146":-5,"_252":400,"_27":401},{"_44":385,"_32":386,"_30":387,"_140":377,"_42":43,"_41":388,"_142":25,"_39":389,"_13":390,"_34":35,"_36":391,"_24":25,"_146":-5,"_252":392,"_27":393},{"_44":374,"_32":375,"_30":376,"_140":377,"_42":43,"_41":378,"_142":25,"_39":379,"_13":182,"_34":35,"_36":380,"_24":25,"_146":-5,"_252":381,"_27":382},{"_44":173,"_32":174,"_30":175,"_140":-5,"_42":43,"_41":162,"_142":60,"_39":371,"_13":64,"_34":177,"_36":-5,"_24":25,"_146":-5,"_252":372,"_27":373},{"_44":366,"_32":340,"_30":334,"_140":175,"_42":43,"_41":367,"_142":60,"_39":368,"_13":64,"_34":177,"_36":-5,"_24":25,"_146":-5,"_252":369,"_27":370},{"_44":358,"_32":359,"_30":360,"_140":334,"_42":43,"_41":361,"_142":60,"_39":362,"_13":277,"_34":35,"_36":363,"_24":25,"_146":-5,"_252":364,"_27":365},{"_44":349,"_32":350,"_30":351,"_140":334,"_42":43,"_41":352,"_142":25,"_39":353,"_13":354,"_34":35,"_36":355,"_24":25,"_146":-5,"_252":356,"_27":357},{"_44":341,"_32":342,"_30":343,"_140":334,"_42":43,"_41":344,"_142":60,"_39":345,"_13":64,"_34":35,"_36":346,"_24":25,"_146":-5,"_252":347,"_27":348},{"_44":331,"_32":332,"_30":333,"_140":334,"_42":43,"_41":335,"_142":25,"_39":336,"_13":310,"_34":35,"_36":337,"_24":25,"_146":-5,"_252":338,"_27":339},{"_44":322,"_32":323,"_30":324,"_140":175,"_42":43,"_41":325,"_142":25,"_39":326,"_13":327,"_34":35,"_36":328,"_24":25,"_146":-5,"_252":329,"_27":330},{"_44":314,"_32":315,"_30":316,"_140":175,"_42":43,"_41":317,"_142":60,"_39":318,"_13":182,"_34":35,"_36":319,"_24":25,"_146":-5,"_252":320,"_27":321},{"_44":305,"_32":306,"_30":307,"_140":175,"_42":43,"_41":308,"_142":25,"_39":309,"_13":310,"_34":35,"_36":311,"_24":25,"_146":-5,"_252":312,"_27":313},{"_44":297,"_32":298,"_30":299,"_140":175,"_42":43,"_41":300,"_142":25,"_39":301,"_13":152,"_34":35,"_36":302,"_24":25,"_146":-5,"_252":303,"_27":304},{"_44":289,"_32":290,"_30":291,"_140":175,"_42":43,"_41":292,"_142":25,"_39":293,"_13":162,"_34":35,"_36":294,"_24":25,"_146":-5,"_252":295,"_27":296},{"_44":281,"_32":282,"_30":283,"_140":175,"_42":43,"_41":284,"_142":60,"_39":285,"_13":268,"_34":35,"_36":286,"_24":25,"_146":-5,"_252":287,"_27":288},{"_44":272,"_32":273,"_30":274,"_140":175,"_42":43,"_41":275,"_142":25,"_39":276,"_13":277,"_34":35,"_36":278,"_24":25,"_146":-5,"_252":279,"_27":280},{"_44":264,"_32":33,"_30":265,"_140":175,"_42":43,"_41":266,"_142":60,"_39":267,"_13":268,"_34":35,"_36":269,"_24":25,"_146":-5,"_252":270,"_27":271},{"_44":165,"_32":166,"_30":167,"_140":-5,"_42":43,"_41":168,"_142":25,"_39":261,"_13":170,"_34":20,"_36":171,"_24":25,"_146":-5,"_252":262,"_27":263},{"_44":157,"_32":158,"_30":159,"_140":-5,"_42":43,"_41":160,"_142":25,"_39":258,"_13":162,"_34":20,"_36":163,"_24":25,"_146":-5,"_252":259,"_27":260},{"_44":148,"_32":149,"_30":58,"_140":-5,"_42":43,"_41":150,"_142":60,"_39":255,"_13":152,"_34":153,"_36":154,"_24":25,"_146":155,"_252":256,"_27":257},{"_44":137,"_32":138,"_30":139,"_140":-5,"_42":43,"_41":141,"_142":25,"_39":251,"_13":144,"_34":20,"_36":145,"_24":25,"_146":-5,"_252":253,"_27":254},["D",1780936729321],"children",[],[138],["D",1780941501215],[],[149],["D",1780918461984],[],[158],["D",1780943836300],[],[166],"8df317d9-1e53-4d64-bbaf-05bab76aa472","f4109fca-6128-11f1-90f7-1607ee4eb77e",334,["D",1780944386447],8,"// types.ts — View models passed from backend handlers into the admin UI.\n\n/** One customer row for the Auth tab + the data the Debug/Integration tabs need. */\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 descriptions: Record; // fn name → plain-language description\n sampleBodies: Record>; // fn name → example POST body\n paramsSchemas: Record>; // fn name → JSON Schema\n}\n\n/** A single logged invocation, shown (expandable) on the Recent calls page. */\nexport interface CallView {\n id: number;\n customer: string;\n fn: string;\n ok: boolean;\n status: number;\n latency_ms: number;\n detail: string;\n req_body: string;\n resp_body: string;\n ts: string;\n}\n\n/** The full /admin page model: signed-in user + every customer's config. */\nexport interface AdminView {\n username: string;\n avatarUrl?: string;\n baseUrl: string;\n customers: CustomerView[];\n saved: boolean;\n}\n\n/** A customer's selectable functions, for the Recent calls page filters. */\nexport interface CallsCustomer {\n id: string;\n label: string;\n fns: string[];\n}\n\nexport interface CallsView {\n username: string;\n avatarUrl?: string;\n baseUrl: string;\n customers: CallsCustomer[];\n}\n",[],[174,33],"1b1ff412-0372-4f2a-8797-34a97e149e6d","shared.tsx","fe520698-632d-11f1-aacf-1607ee4eb77e",333,["D",1780944386288],11,"/** @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 { ComponentChildren, 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
\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\n/** Sign-out form button; `small` renders the compact variant for the user popover. */\nexport function LogoutButton({ small }: { small?: boolean }) {\n return (\n
\n \n
\n );\n}\n\n/** Navbar breadcrumb crumbs (`› Admin › Debug`), one notch smaller than the brand.\n * A crumb with an `id` can be updated live (e.g. the active tab name); one with an\n * `href` renders as a link back to that page (e.g. Admin from a sub-page). */\nexport function Breadcrumb({ crumbs }: { crumbs: Crumb[] }) {\n return (\n <>\n {crumbs.map((c) => (\n \n ›\n {c.href\n ? {c.label}\n : {c.label}}\n \n ))}\n \n );\n}\n\ninterface Crumb {\n label: string;\n id?: string;\n href?: string;\n}\n\n/** One admin tab: an icon + label link. The hash-tab script (`TABS_JS`) toggles\n * `.active` and reads the `` label, so keep that inner structure. */\nexport function Tab(\n { slug, icon, label, active }: { slug: string; icon: string; label: string; active?: boolean },\n) {\n return (\n \n {icon}\n {label}\n \n );\n}\n\n/** A beer.css dropdown (select with a floating label + caret). */\nexport function Picker({\n id,\n label,\n children,\n}: {\n id: string;\n label: string;\n children?: ComponentChildren;\n}) {\n return (\n
\n \n {label}\n arrow_drop_down\n
\n );\n}\n\n/** A labelled, read-only value with a copy button (filled live by a client script).\n * `multiline` lets long prose (e.g. a tool description) wrap instead of scrolling. */\nexport function ReadOnlyField(\n { id, label, multiline }: { id: string; label: string; multiline?: boolean },\n) {\n return (\n
\n {label}\n
\n
\n \n
\n
\n );\n}\n\n/** Inline confirmation shown after a successful key-config save. */\nexport function SavedBanner() {\n return (\n
\n check_circle Saved.\n
\n );\n}\n",[],[174,273],"c2613c73-f342-42b0-9d54-ea3cbc683e66","layout.tsx","f3474b16-6128-11f1-b4a4-1607ee4eb77e",257,["D",1780940365700],"/** @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 { LOGO_SVG } from \"./assets.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 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@40,400,0,0\";\n\n/** Brand seed — beer.css generates the full M3 palette from this at runtime. */\nconst BRAND_SEED = \"#2E6BE6\";\n\nexport interface ShellUser {\n username: string;\n avatarUrl?: string;\n}\n\ninterface ShellProps {\n title: string;\n user?: ShellUser;\n breadcrumb?: ComponentChildren; // crumbs rendered after the brand (e.g. › Admin › Debug)\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, breadcrumb, navActions, children }: ShellProps) {\n return (\n \n \n \n \n {`uAgents · ${title}`}\n \n \n \n \n \n

Diff · v336