[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_987":988,"_989":990},"routes/_app.x.$handle.$name",{"_99":98,"_31":44,"_108":89,"_26":52,"_13":14,"_109":-5,"_11":110,"_111":112,"_113":114,"_115":116,"_117":118,"_20":-5,"_119":-5,"_120":-5,"_121":24,"_122":123,"_124":58,"_125":-5,"_126":-5,"_127":128},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_42":43,"_31":44,"_37":45,"_46":-5,"_47":24,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":56,"_57":58,"_59":-5,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":68,"_69":70,"_71":-5,"_72":73,"_74":73,"_75":76,"_77":76,"_78":76,"_79":73,"_80":73,"_81":82,"_83":84,"_85":86,"_87":24},"version",592,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":24,"_26":27,"_28":27},"file",{"_29":30,"_31":32,"_33":34,"_35":36,"_37":38,"_39":14,"_40":41,"_23":24},"previous","deleted",false,"deletedHere","path","backend/customers/jjs/catalog-info.ts","latestPath","fileId","5711612c-8037-11f1-af5a-1607ee4eb77e","name","catalog-info.ts","fileType","script","content","// jjs/catalog-info.ts — Deterministic JhaJi catalog lookup (no LLM, in-memory).\n// Voice agents call this for prices, sizes, availability, spice, garlic-free\n// status, and pack contents. Returns a RANKED top-5 list, never a single guess —\n// the calling agent disambiguates with the customer. See catalog-context.md.\n\nimport { readJsonObject } from \"../../core/api.ts\";\nimport { jsonOk } from \"../../core/shared.ts\";\nimport type { SecretsJjs } from \"../../core/app.ts\";\nimport type { FnCtx, FnSpec } from \"../types.ts\";\nimport { CATALOG_FEED } from \"./catalog-data.ts\";\nimport { CATALOG_OVERLAY, type CatalogProduct } from \"./catalog-overlay.ts\";\n\n// merged catalog -----------------------------------------------------------------\n\nconst CATALOG: CatalogProduct[] = CATALOG_FEED.map((p) => {\n const { category: _ignored, ...overlay } = CATALOG_OVERLAY[p.handle] ?? {};\n return { ...p, ...overlay };\n});\n\n// scoring --------------------------------------------------------------------------\n\nconst PACK_TOKENS = new Set([\"pack\", \"combo\", \"sample\", \"set\", \"bundle\"]);\n\nfunction tokenize(s: string): string[] {\n return s.toLowerCase().replace(/[^a-z0-9\\s]/g, \" \").split(/\\s+/).filter(Boolean);\n}\n\nfunction haystack(p: CatalogProduct): string {\n return [p.name, ...(p.aliases ?? []), ...p.tags, ...(p.contents ?? [])].join(\" \").toLowerCase();\n}\n\n/** All-token matches beat partial; single jars beat packs unless the query asks for one. */\nfunction score(p: CatalogProduct, tokens: string[]): number {\n const hay = haystack(p);\n const matched = tokens.filter((t) => hay.includes(t)).length;\n if (matched === 0) return 0;\n let s = matched === tokens.length ? 100 : (60 * matched) / tokens.length;\n const asksPack = tokens.some((t) => PACK_TOKENS.has(t));\n if (p.category === \"single\" && !asksPack) s += 15;\n if (p.category !== \"single\" && !asksPack) s -= 10;\n if (p.category !== \"single\" && asksPack) s += 15;\n const nameHay = p.name.toLowerCase();\n if (tokens.every((t) => nameHay.includes(t))) s += 10; // exact name hit\n const q = tokens.join(\" \");\n if ((p.aliases ?? []).some((a) => a.toLowerCase() === q)) s += 20; // exact alias hit\n if (!p.variants.some((v) => v.available)) s -= 25; // fully out of stock sinks\n return s;\n}\n\n// response shaping ------------------------------------------------------------------\n\nfunction compact(p: CatalogProduct) {\n return {\n name: p.name,\n category: p.category,\n variants: p.variants.map((v) => `${v.option}: ₹${v.price}${v.available ? \"\" : \" (OUT OF STOCK)\"}`),\n ...(p.contents ? { contains: p.contents } : {}),\n ...(p.spice ? { spice: p.spice } : {}),\n ...(p.garlic_free !== undefined ? { garlic_free: p.garlic_free } : {}),\n ...(p.kid_friendly ? { kid_friendly: true } : {}),\n };\n}\n\nfunction priceLine(p: CatalogProduct): string {\n const cheapest = Math.min(...p.variants.map((v) => v.price));\n const inStock = p.variants.some((v) => v.available);\n return `${p.name} — from ₹${cheapest}${inStock ? \"\" : \" (OUT OF STOCK)\"}`;\n}\n\n// query -------------------------------------------------------------------------------\n\ninterface CatalogQuery {\n query: string;\n category?: string;\n garlic_free?: boolean;\n}\n\nfunction search({ query, category, garlic_free }: CatalogQuery) {\n let pool = CATALOG;\n if (category) pool = pool.filter((p) => p.category === category);\n if (garlic_free !== undefined) pool = pool.filter((p) => p.garlic_free === garlic_free);\n\n const tokens = tokenize(query);\n if (tokens.length === 0) {\n return { count: pool.length, price_list: pool.map(priceLine) };\n }\n const ranked = pool\n .map((p) => ({ p, s: score(p, tokens) }))\n .filter((r) => r.s > 0)\n .sort((a, b) => b.s - a.s)\n .slice(0, 5)\n .map((r) => compact(r.p));\n if (ranked.length === 0) {\n return { count: 0, note: \"No matching product. Try a simpler name, e.g. 'mango' or 'kathal'.\" };\n }\n return { count: ranked.length, products: ranked };\n}\n\n// fn spec ------------------------------------------------------------------------------\n\nexport const catalogInfoFn: FnSpec = {\n description:\n \"JhaJi Store catalog lookup (deterministic, no LLM). Search products by name or alias \" +\n \"(handles STT garblings like 'sooka', 'cattle'), filter by category or garlic-free, and \" +\n \"get prices, sizes, availability, spice notes, and sample-pack contents. Empty query \" +\n \"returns the full price list. Read-only — use draft-sidekick to modify orders.\",\n sampleBody: { query: \"sookha bharua\" },\n paramsSchema: {\n type: \"object\",\n properties: {\n query: {\n type: \"string\",\n description:\n \"Product name or keywords in roman letters, e.g. 'kathal', 'sample pack', \" +\n \"'lal mirch'. Empty string returns the full catalog price list.\",\n },\n category: {\n type: \"string\",\n enum: [\"single\", \"sample_pack\", \"combo\", \"kheer\"],\n description: \"Optional filter. Omit to search everything.\",\n },\n garlic_free: {\n type: \"boolean\",\n description: \"Set true to return only garlic-free (Jain / no-garlic) products.\",\n },\n },\n required: [\"query\"],\n },\n run: async ({ req }: FnCtx) => {\n const input = await readJsonObject(req);\n const query = typeof input.query === \"string\" ? input.query : \"\";\n const category = typeof input.category === \"string\" ? input.category : undefined;\n const garlic_free = typeof input.garlic_free === \"boolean\" ? input.garlic_free : undefined;\n return jsonOk(search({ query, category, garlic_free }));\n },\n};\n","createdAt",["D",1784111059738],"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",{"_99":98,"_107":103},"org",{"_99":98,"_100":101,"_102":103,"_18":-5,"_104":105,"_106":24},"branch",{"_13":88,"_31":89,"_42":41,"_90":43,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":44,"_97":98},"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=1789592319&sig=87d6f5d00bef1efeb36c9ffa1655dbba81bcae9e52f72405b0deecce402615df","tier","free","canRestrictVals","profileImageUrl","branchName","adoptOrgId",{"_42":43,"_31":44,"_37":982,"_46":-5,"_47":24,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":56,"_57":58,"_59":-5,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":68,"_69":983,"_71":-5,"_72":73,"_74":73,"_75":76,"_77":76,"_78":76,"_79":73,"_80":73,"_81":984,"_83":985,"_85":986,"_87":24},"tree",[233,294,309,316,317,318,319,320,321,322,323],"files",[233,234,235,236,237,238,239,240,241,242,243,244,245,246,247,248,249,250,251,252,253,254,255,256,257,258,259,260,261,262,263,264,265,266,267,268,269,270,271,272,273,274,275,276,277,278,279,280,281,282,283,284,285,286,287,288,289,290,291,292,293,294,295,296,297,298,299,300,301,302,303,304,305,306,307,308,309,310,311,312,313,314,315,316,317,318,319,320,321,322,323],"counts",{"_223":62,"_224":181,"_225":62,"_226":227,"_228":229},"contents",[129,130,131,132,133,134,135,136,137,138,139],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_42":217,"_31":218,"_29":219,"_143":-5,"_40":41,"_39":220,"_145":58,"_37":221,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_26":222},{"_42":212,"_31":213,"_29":214,"_143":-5,"_40":41,"_39":181,"_145":58,"_37":215,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_26":216},{"_42":205,"_31":206,"_29":207,"_143":-5,"_40":41,"_39":208,"_145":58,"_37":209,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_26":211},{"_42":198,"_31":199,"_29":200,"_143":-5,"_40":41,"_39":201,"_145":58,"_37":202,"_13":62,"_33":20,"_35":203,"_23":24,"_149":-5,"_26":204},{"_42":191,"_31":192,"_29":193,"_143":-5,"_40":41,"_39":194,"_145":24,"_37":195,"_13":62,"_33":20,"_35":196,"_23":24,"_149":-5,"_26":197},{"_42":184,"_31":185,"_29":186,"_143":-5,"_40":41,"_39":187,"_145":58,"_37":188,"_13":181,"_33":20,"_35":189,"_23":24,"_149":-5,"_26":190},{"_42":176,"_31":177,"_29":178,"_143":-5,"_40":41,"_39":179,"_145":24,"_37":180,"_13":181,"_33":20,"_35":182,"_23":24,"_149":-5,"_26":183},{"_42":168,"_31":169,"_29":170,"_143":-5,"_40":41,"_39":171,"_145":24,"_37":172,"_13":173,"_33":20,"_35":174,"_23":24,"_149":-5,"_26":175},{"_42":160,"_31":161,"_29":162,"_143":-5,"_40":41,"_39":163,"_145":24,"_37":164,"_13":165,"_33":20,"_35":166,"_23":24,"_149":-5,"_26":167},{"_42":151,"_31":152,"_29":56,"_143":-5,"_40":41,"_39":153,"_145":58,"_37":154,"_13":155,"_33":156,"_35":157,"_23":24,"_149":158,"_26":159},{"_42":140,"_31":141,"_29":142,"_143":-5,"_40":41,"_39":144,"_145":24,"_37":146,"_13":147,"_33":20,"_35":148,"_23":24,"_149":-5,"_26":150},"938ac1c7-f8e1-456c-b2de-977bf96a0bfa","val.yml","f3605d0e-6128-11f1-9354-1607ee4eb77e","parentId",537,"latest",["D",1782557041254],11,"# 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#\n# Two surfaces:\n# /c// → customer functions (Bearer key auth; cname from the URL)\n# /admin → Val Town OAuth-gated admin UI (gated to ADMIN_USERS)\n#\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\n# Env vars this app reads. Set them in the Val Town UI sidebar — never in code.\n# Shopify vars are per-customer: prefix = uppercased customer id (JJS = Jhaji).\n# The shop must expose Storefront MCP at https://{shop}/api/mcp.\n#\n# required — app will not work without this\n# recommended — has a safe fallback but set explicitly for production\n# optional — feature-flagged; functions 503 with the exact var name when missing\nenv:\n ADMIN_USERS: required # comma-separated Val Town usernames for /admin access\n OPENAI_API_KEY: required # OpenAI key for all LangChain agent-backed functions\n OAUTH_STATE_ENCRYPTION_KEY: recommended # AES-GCM key for admin OAuth session cookie; `openssl rand -base64 32`\n JJS_SHOPIFY_SHOP: optional # Jhaji store hostname, e.g. ttai-merchandise-dev.myshopify.com (no scheme)\n JJS_SHOPIFY_CLIENT_ID: optional # Jhaji Dev Dashboard app client id (client-credentials grant)\n JJS_SHOPIFY_CLIENT_SECRET: optional # Jhaji Dev Dashboard app client secret\n TTAI_SHOPIFY_SHOP: optional # ToughTongue AI dev store hostname (no scheme)\n TTAI_SHOPIFY_CLIENT_ID: optional # TTAI Dev Dashboard app client id\n TTAI_SHOPIFY_CLIENT_SECRET: optional # TTAI Dev Dashboard app client secret\n FITELO_N8N_WEBHOOK_URL: optional # Fitelo n8n webhook the post-session-sms fn forwards to\n","label",[141],"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",[152],"d01dca8f-bbd5-4bab-b6d0-d78367165f09","deno.json","f353dd04-6128-11f1-ac3a-1607ee4eb77e",522,["D",1782028227618],6,"{\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 \"exclude\": [\".vt\"]\n },\n \"lint\": {\n \"exclude\": [\".vt\"],\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 \"tasks\": {\n \"view-meta\": \"deno run -A scripts/view-meta.ts\",\n \"set-meta\": \"deno run -A scripts/set-meta.ts\",\n \"del-meta\": \"deno run -A scripts/del-meta.ts\",\n \"get-customer-info\": \"deno run -A scripts/get-customer-info.ts\",\n \"fetch-context\": \"deno run -A scripts/fetch-context.ts\"\n }\n}\n",[161],"a4f3781b-af79-4e99-a594-cb9649d2a698","README.md","f3e9fe92-6128-11f1-b4a4-1607ee4eb77e",530,["D",1782157536204],24,"# 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 + task shortcuts\n .env.sample copy → .env and fill in for local scripts (gitignored)\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, compact)\n agents/ concrete agents + their LangChain tool wrappers\n quote-agent.ts the quote agent (structured output)\n shopify-mcp-agent.ts unified Shopify agent (Admin tools + Storefront MCP, ≤12 rounds)\n shopify-admin-tools.ts LangChain tool wrappers for Shopify Admin reads\n integrations/ external-service primitives (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() (fetch, no SDK)\n snapshot.ts resolveCustomer(), resolveCustomerGid(), listAbandonedCheckouts()\n context.ts deterministic reads for fetch-context\n metafields.ts setMetafields(), readMetafields() — generic, no business logic\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 agent-fn.ts agentFn() — bridge any Agent into an FnSpec\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, get-metafields, shopify-sidekick, post-feedback)\n get-customer-info.ts deterministic Shopify read (no LLM)\n get-metafields.ts read customer metafields (all or by namespace)\n post-feedback.ts POST_SESSION hook — writes call feedback as ttai_call.* metafields\n shopify-sidekick.ts function that invokes the 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 scripts/ local Deno scripts for testing against the real store\n get-customer-info.ts fetch customer profile + all metafields by email\n fetch-context.ts fetch exact order context + recent abandoned checkouts\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 auth-header.tsx Authorization header display helper (shared by debug + integration)\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### Security properties (code is public)\n\nThe val is public on Val Town — anyone can read the source. Security rests on secrets, not\nobscurity:\n\n| Surface | Protection | Notes |\n| -------------------- | ------------------------------------------ | ----------------------------------------------------------------------- |\n| `/c//` | Per-customer Bearer key (SQLite) | Constant-time compare; 403 when disabled |\n| `/admin/*` | Val Town OAuth + `ADMIN_USERS` allow-list | All sub-routes including `calls.json` |\n| `/admin/auth` (POST) | OAuth + admin check + registry guard | `customer` field validated against known registry — rejects unknown ids |\n| Shopify creds | Val Town env vars (never in code/logs) | Only read server-side; 503 names missing var |\n| Call log bodies | Stored headers-stripped, capped at 8 KB | Admin-only read; request bodies are logged |\n| Key length timing | Early-exit on mismatched length | Acceptable: all keys share the fixed-length prefix |\n| Rate limiting | None per-customer beyond Val Town platform | An attacker needs a valid key (admin-issued) to reach agents |\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`, `ttai`) — deterministic Shopify Admin read (no LLM). Body with at\n least one of `customer_id` / `customer_email` / `customer_phone` → profile, pending orders,\n abandoned checkouts. The same lookup is exposed to the agent as `get_customer_info`.\n- **`fetch-context`** (`jjs`, `ttai`) — deterministic Shopify Admin read (no LLM). Body\n `{ order_id, user_email?, user_phone? }` returns `user_phone`, `abandoned_ts`, `cart_value`, exact\n order JSON in `order_context`, matching unrecovered last-10-day abandoned checkouts in\n `user_context`, and an empty `related_items` array for response-shape compatibility.\n- **`shopify-sidekick`** (`jjs`, `ttai`) — full-service Shopify agent (`shopify-mcp-agent`). Body\n `{ prompt, customer_id?, customer_email?, customer_phone?, cart_id? }`. Combines two Admin tools\n (customer lookup, abandoned checkouts) with five Storefront MCP tools from the shop's `/api/mcp`\n (catalog search, product details, cart create/update, policies). Up to 12 tool rounds.\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-sidekick.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()`, `ttaiSecrets()`) that reads **only that customer's listed env vars**\n (`JJS_SHOPIFY_*`, `TTAI_SHOPIFY_*`) into a typed object. A customer's\n `defineCustomer({ secrets })` resolver runs once; every `Fn` / `Agent` for that customer is handed\n its own typed `ctx.secrets` (e.g. a `jjs` function sees exactly `SecretsJjs`). Add a customer =\n add a `Secrets` type + resolver in `app.ts`, then 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 — must expose `/api/mcp` (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| `TTAI_SHOPIFY_SHOP` | optional | `integrations/shopify` (`ttai`) | TTAI dev store hostname — must expose `/api/mcp` (no scheme) |\n| `TTAI_SHOPIFY_CLIENT_ID` | optional | `integrations/shopify/token.ts` | TTAI Dev Dashboard app client id — mints Admin tokens |\n| `TTAI_SHOPIFY_CLIENT_SECRET` | optional | `integrations/shopify/token.ts` | TTAI Dev Dashboard app client secret |\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_*` and `TTAI_SHOPIFY_*` only matter for their own Shopify functions. A new merchant\n lists its own vars in a `secretsAcme()` resolver (`app.ts`). Unset shop/client creds ⇒ those\n functions return **503** naming the exact var.\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 scripts\n\nScripts in `scripts/` run with Deno directly against the real store — no val deployment needed. They\nimport the backend primitives via relative paths, so they stay in sync automatically.\n\n**One-time setup** (from `exp/vals/uAgents/`):\n\n```bash\ncp .env.sample .env\n# fill in JJS_SHOPIFY_SHOP, JJS_SHOPIFY_CLIENT_ID, JJS_SHOPIFY_CLIENT_SECRET\n```\n\n### `get-customer-info`\n\nResolves a customer by email and prints their profile, pending orders, abandoned checkouts, and all\nmetafields. Optionally scope metafields to a namespace.\n\n```bash\n# from exp/vals/uAgents/\ndeno task get-customer-info mayank.raj.unofficial@gmail.com\ndeno task get-customer-info mayank.raj.unofficial@gmail.com ttai_call # scope to namespace\n\n# or directly\ndeno run -A scripts/get-customer-info.ts mayank.raj.unofficial@gmail.com\n```\n\n### `fetch-context`\n\nResolves an order, backfills the customer's phone when Shopify has it, returns exact order JSON in\n`order_context`, and returns unrecovered abandoned checkouts in `user_context` only when they match\nthat order's customer/email/phone and were created in the last 10 days. `abandoned_ts` and\n`cart_value` are taken from the newest matching abandoned checkout. This function does not call\nOpenAI or generate related product recommendations; `related_items` is intentionally returned as\n`[]` for compatibility.\n\n```bash\n# from exp/vals/uAgents/\ndeno task fetch-context --order-id '#1001'\ndeno task fetch-context -c jjs '#1001' --user-email priya.sharma@example.com\n\n# or directly\ndeno run -A scripts/fetch-context.ts --order-id '#1001'\n```\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# jjs Shopify sidekick (Admin + Storefront MCP)\ncurl -X POST https://uagents.val.run/c/jjs/shopify-sidekick \\\n -H \"Authorization: Bearer $VT_JJS_APP_TOKEN\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"prompt\":\"Search for hoodies and add the first one to a new cart\",\"customer_email\":\"mayank.raj.unofficial@gmail.com\"}'\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",[169],"5b280113-d54c-44da-8e75-6ab700c98b06","AGENTS.md","a5bb54c0-7571-11f1-b237-1607ee4eb77e",567,["D",1783012393209],1,"You are an advanced assistant specialized in generating Val Town code.\n\n## Core Guidelines\n\n- Ask clarifying questions when requirements are ambiguous\n- Provide complete, functional solutions rather than skeleton implementations\n- Test your logic against edge cases before presenting the final solution\n- Ensure all code follows Val Town's specific platform requirements\n- If a section of code that you're working on is getting too complex, consider refactoring it into\n subcomponents\n\n## Code Standards\n\n- Generate code in TypeScript or TSX\n- Add appropriate TypeScript types and interfaces for all data structures\n- Prefer official SDKs or libraries than writing API calls directly\n- Ask the user to supply API or library documentation if you are at all unsure about it\n- **Never bake in secrets into the code** - always use environment variables\n- Include comments explaining complex logic (avoid commenting obvious operations)\n- Follow modern ES6+ conventions and functional programming practices if possible\n\n## Types of triggers\n\n### 1. HTTP Trigger\n\n- Create web APIs and endpoints\n- Handle HTTP requests and responses\n- Example structure:\n\n```ts\nexport default async function (req: Request) {\n return new Response(\"Hello World\");\n}\n```\n\nFiles that are HTTP triggers have http in their name like `foobar.http.tsx`\n\n### 2. Cron Triggers\n\n- Run on a schedule\n- Use cron expressions for timing\n- Example structure:\n\n```ts\nexport default async function () {\n // Scheduled task code\n}\n```\n\nFiles that are Cron triggers have cron in their name like `foobar.cron.tsx`\n\n### 3. Email Triggers\n\n- Process incoming emails\n- Handle email-based workflows\n- Example structure:\n\n```ts\nexport default async function (email: Email) {\n // Process email\n}\n```\n\nFiles that are Email triggers have email in their name like `foobar.email.tsx`\n\n## Val Town Standard Libraries\n\nVal Town provides several hosted services and utility functions.\n\n### Blob Storage\n\n```ts\nimport { blob } from \"https://esm.town/v/std/blob\";\nawait blob.setJSON(\"myKey\", { hello: \"world\" });\nlet blobDemo = await blob.getJSON(\"myKey\");\nlet appKeys = await blob.list(\"app_\");\nawait blob.delete(\"myKey\");\n```\n\n### SQLite\n\n```ts\nimport { sqlite } from \"https://esm.town/v/stevekrouse/sqlite\";\nconst TABLE_NAME = \"todo_app_users_2\";\n// Create table - do this before usage and change table name when modifying schema\nawait sqlite.execute(`CREATE TABLE IF NOT EXISTS ${TABLE_NAME} (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL\n)`);\n// Query data\nconst result = await sqlite.execute(`SELECT * FROM ${TABLE_NAME} WHERE id = ?`, [1]);\n```\n\nNote: When changing a SQLite table's schema, change the table's name (e.g., add _2 or _3) to create\na fresh table.\n\n### OpenAI\n\n```ts\nimport { OpenAI } from \"https://esm.town/v/std/openai\";\nconst openai = new OpenAI();\nconst completion = await openai.chat.completions.create({\n messages: [\n { role: \"user\", content: \"Say hello in a creative way\" },\n ],\n model: \"gpt-4o-mini\",\n max_tokens: 30,\n});\n```\n\n### Email\n\n```ts\nimport { email } from \"https://esm.town/v/std/email\";\n// By default emails the owner of the val\nawait email({\n subject: \"Hi\",\n text: \"Hi\",\n html: \"

Hi

\",\n});\n```\n\n## Val Town Utility Functions\n\nVal Town provides several utility functions to help with common project tasks.\n\n### Importing Utilities\n\nAlways import utilities with version pins to avoid breaking changes:\n\n```ts\nimport { parseProject, readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n```\n\n### Available Utilities\n\n#### **serveFile** - Serve project files with proper content types\n\nFor example, in Hono:\n\n```ts\n// serve all files in frontend/ and shared/\napp.get(\"/frontend/*\", (c) => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", (c) => serveFile(c.req.path, import.meta.url));\n```\n\n#### **readFile** - Read files from within the project:\n\n```ts\n// Read a file from the project\nconst fileContent = await readFile(\"/frontend/index.html\", import.meta.url);\n```\n\n#### **listFiles** - List all files in the project\n\n```ts\nconst files = await listFiles(import.meta.url);\n```\n\n#### **parseProject** - Extract information about the current project from import.meta.url\n\nThis is useful for including info for linking back to a val, ie in \"view source\" urls:\n\n```ts\nconst projectVal = parseProject(import.meta.url);\nconsole.log(projectVal.username); // Owner of the project\nconsole.log(projectVal.name); // Project name\nconsole.log(projectVal.version); // Version number\nconsole.log(projectVal.branch); // Branch name\nconsole.log(projectVal.links.self.project); // URL to the project page\n```\n\nHowever, it's _extremely importing_ to note that `parseProject` and other Standard Library utilities\nONLY RUN ON THE SERVER. If you need access to this data on the client, run it in the server and pass\nit to the client by splicing it into the HTML page or by making an API request for it.\n\n## Val Town Platform Specifics\n\n- **Redirects:** Use\n `return new Response(null, { status: 302, headers: { Location: \"/place/to/redirect\" }})` instead\n of `Response.redirect` which is broken\n- **Images:** Avoid external images or base64 images. Use emojis, unicode symbols, or icon\n fonts/libraries instead\n- **AI Image:** To inline generate an AI image use:\n `

`\n- **Storage:** DO NOT use the Deno KV module for storage\n- **Browser APIs:** DO NOT use the `alert()`, `prompt()`, or `confirm()` methods\n- **Weather Data:** Use open-meteo for weather data (doesn't require API keys) unless otherwise\n specified\n- **View Source:** Add a view source link by importing & using\n `import.meta.url.replace(\"ems.sh\", \"val.town)\"` (or passing this data to the client) and include\n `target=\"_top\"` attribute\n- **Error Debugging:** Add `` to HTML to capture\n client-side errors\n- **Error Handling:** Only use try...catch when there's a clear local resolution; Avoid catches that\n merely log or return 500s. Let errors bubble up with full context\n- **Environment Variables:** Use `Deno.env.get('keyname')` when you need to, but generally prefer\n APIs that don't require keys\n- **Imports:** Use `https://esm.sh` for npm and Deno dependencies to ensure compatibility on server\n and browser\n- **Storage Strategy:** Only use backend storage if explicitly required; prefer simple static\n client-side sites\n- **React Configuration:** When using React libraries, pin versions with\n `?deps=react@18.2.0,react-dom@18.2.0` and start the file with\n `/** @jsxImportSource https://esm.sh/react@18.2.0 */`\n- Ensure all React dependencies and sub-dependencies are pinned to the same version\n- **Styling:** Default to using TailwindCSS via\n `` unless otherwise specified\n\n## Project Structure and Design Patterns\n\n### Recommended Directory Structure\n\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Schema definitions\n│ │ ├── queries.ts # DB query functions\n│ │ └── README.md\n│ └── routes/ # Route modules\n│ ├── [route].ts\n│ └── static.ts # Static file serving\n│ ├── index.ts # Main entry point\n│ └── README.md\n├── frontend/\n│ ├── components/\n│ │ ├── App.tsx\n│ │ └── [Component].tsx\n│ ├── favicon.svg\n│ ├── index.html # Main HTML template\n│ ├── index.tsx # Frontend JS entry point\n│ ├── README.md\n│ └── style.css\n├── README.md\n└── shared/\n ├── README.md\n └── utils.ts # Shared types and functions\n```\n\n### Backend (Hono) Best Practices\n\n- Hono is the recommended API framework\n- Main entry point should be `backend/index.ts`\n- **Static asset serving:** Use the utility functions to read and serve project files:\n ```ts\n import { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\n // serve all files in frontend/ and shared/\n app.get(\"/frontend/*\", (c) => serveFile(c.req.path, import.meta.url));\n app.get(\"/shared/*\", (c) => serveFile(c.req.path, import.meta.url));\n\n // For index.html, often you'll want to bootstrap with initial data\n app.get(\"/\", async (c) => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n\n // Inject data to avoid extra round-trips\n const initialData = await fetchInitialData();\n const dataScript = ``;\n\n html = html.replace(\"\", `${dataScript}`);\n return c.html(html);\n });\n ```\n- Create RESTful API routes for CRUD operations\n- Always include this snippet at the top-level Hono app to re-throwing errors to see full stack\n traces:\n ```ts\n // Unwrap Hono errors to see original error details\n app.onError((err, c) => {\n throw err;\n });\n ```\n\n### Database Patterns\n\n- Run migrations on startup or comment out for performance\n- Change table names when modifying schemas rather than altering\n- Export clear query functions with proper TypeScript typing\n\n## Common Gotchas and Solutions\n\n1. **Environment Limitations:**\n - Val Town runs on Deno in a serverless context, not Node.js\n - Code in `shared/` must work in both frontend and backend environments\n - Cannot use `Deno` keyword in shared code\n - Use `https://esm.sh` for imports that work in both environments\n\n2. **SQLite Peculiarities:**\n - Limited support for ALTER TABLE operations\n - Create new tables with updated schemas and copy data when needed\n - Always run table creation before querying\n\n3. **React Configuration:**\n - All React dependencies must be pinned to 18.2.0\n - Always include `@jsxImportSource https://esm.sh/react@18.2.0` at the top of React files\n - Rendering issues often come from mismatched React versions\n\n4. **File Handling:**\n - Val Town only supports text files, not binary\n - Use the provided utilities to read files across branches and forks\n - For files in the project, use `readFile` helpers\n\n5. **API Design:**\n - `fetch` handler is the entry point for HTTP vals\n - Run the Hono app with `export default app.fetch // This is the entry point for HTTP vals`\n",[177],"5115440a-9447-4dc7-9012-dd40a4d49af6",".vtignore","a5c30cba-7571-11f1-ad5a-1607ee4eb77e",575,["D",1783058175024],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor\n",[185],"ed26c467-4364-40b5-9a09-ae75cab95f12",".gitignore","a117d82c-68a5-11f1-926a-1607ee4eb77e",427,["D",1781519600473],".env\nscripts/.env\n",[192],"d84c0d0f-d790-4707-b0e0-a3639874eb9d",".env.sample","a09df8b8-68a5-11f1-9dd7-1607ee4eb77e",420,["D",1781519599844],"# Shopify Dev Dashboard app credentials (same vars as pushed to Val Town)\n# JJS — Jhaji merchant store\nJJS_SHOPIFY_SHOP=ttai-merchandise-dev.myshopify.com\nJJS_SHOPIFY_CLIENT_ID=\nJJS_SHOPIFY_CLIENT_SECRET=\n\n# TTAI — ToughTongue AI internal dev store (for testing before production)\nTTAI_SHOPIFY_SHOP=\nTTAI_SHOPIFY_CLIENT_ID=\nTTAI_SHOPIFY_CLIENT_SECRET=\n",[199],"ff7f2101-71a5-425e-a367-560ef13a2086","scripts","a06c5628-68a5-11f1-b189-1607ee4eb77e",416,["D",1781519599541],"directory",[206],"6d14e6de-c8d3-45e7-ba6f-2ed984a1f71b","frontend","f2b2b82a-6128-11f1-9496-1607ee4eb77e",["D",1780696392346],[213],"157d3e42-b14b-4a4a-b3d1-13e8c95b8213","backend","f2d380b4-6128-11f1-b4a4-1607ee4eb77e",2,["D",1780696392550],[218],"pulls","branches","forks","envVars",{"_230":181,"_232":62},"connections",{"_230":62,"_231":62},"count","unfilledCount","emptyCount",{"_42":217,"_31":218,"_29":219,"_143":-5,"_40":41,"_39":220,"_145":58,"_37":979,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_325":980,"_26":981},{"_42":974,"_31":949,"_29":943,"_143":219,"_40":41,"_39":975,"_145":58,"_37":976,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_325":977,"_26":978},{"_42":966,"_31":967,"_29":968,"_143":943,"_40":41,"_39":969,"_145":58,"_37":970,"_13":220,"_33":34,"_35":971,"_23":24,"_149":-5,"_325":972,"_26":973},{"_42":958,"_31":959,"_29":960,"_143":943,"_40":41,"_39":961,"_145":58,"_37":962,"_13":165,"_33":34,"_35":963,"_23":24,"_149":-5,"_325":964,"_26":965},{"_42":950,"_31":951,"_29":952,"_143":943,"_40":41,"_39":953,"_145":58,"_37":954,"_13":432,"_33":34,"_35":955,"_23":24,"_149":-5,"_325":956,"_26":957},{"_42":941,"_31":402,"_29":942,"_143":943,"_40":41,"_39":944,"_145":58,"_37":945,"_13":528,"_33":34,"_35":946,"_23":24,"_149":-5,"_325":947,"_26":948},{"_42":936,"_31":887,"_29":881,"_143":219,"_40":41,"_39":937,"_145":58,"_37":938,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_325":939,"_26":940},{"_42":928,"_31":929,"_29":930,"_143":881,"_40":41,"_39":931,"_145":58,"_37":932,"_13":220,"_33":34,"_35":933,"_23":24,"_149":-5,"_325":934,"_26":935},{"_42":920,"_31":921,"_29":922,"_143":881,"_40":41,"_39":923,"_145":58,"_37":924,"_13":181,"_33":34,"_35":925,"_23":24,"_149":-5,"_325":926,"_26":927},{"_42":912,"_31":913,"_29":914,"_143":881,"_40":41,"_39":915,"_145":58,"_37":916,"_13":165,"_33":34,"_35":917,"_23":24,"_149":-5,"_325":918,"_26":919},{"_42":904,"_31":905,"_29":906,"_143":881,"_40":41,"_39":907,"_145":58,"_37":908,"_13":155,"_33":34,"_35":909,"_23":24,"_149":-5,"_325":910,"_26":911},{"_42":896,"_31":897,"_29":898,"_143":881,"_40":41,"_39":899,"_145":24,"_37":900,"_13":432,"_33":34,"_35":901,"_23":24,"_149":-5,"_325":902,"_26":903},{"_42":888,"_31":889,"_29":890,"_143":881,"_40":41,"_39":891,"_145":24,"_37":892,"_13":181,"_33":34,"_35":893,"_23":24,"_149":-5,"_325":894,"_26":895},{"_42":878,"_31":879,"_29":880,"_143":881,"_40":41,"_39":882,"_145":24,"_37":883,"_13":155,"_33":34,"_35":884,"_23":24,"_149":-5,"_325":885,"_26":886},{"_42":873,"_31":832,"_29":826,"_143":219,"_40":41,"_39":874,"_145":58,"_37":875,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_325":876,"_26":877},{"_42":865,"_31":866,"_29":867,"_143":826,"_40":41,"_39":868,"_145":58,"_37":869,"_13":220,"_33":34,"_35":870,"_23":24,"_149":-5,"_325":871,"_26":872},{"_42":857,"_31":858,"_29":859,"_143":826,"_40":41,"_39":860,"_145":24,"_37":861,"_13":528,"_33":34,"_35":862,"_23":24,"_149":-5,"_325":863,"_26":864},{"_42":849,"_31":850,"_29":851,"_143":826,"_40":41,"_39":852,"_145":24,"_37":853,"_13":165,"_33":34,"_35":854,"_23":24,"_149":-5,"_325":855,"_26":856},{"_42":841,"_31":842,"_29":843,"_143":826,"_40":41,"_39":844,"_145":24,"_37":845,"_13":528,"_33":34,"_35":846,"_23":24,"_149":-5,"_325":847,"_26":848},{"_42":833,"_31":834,"_29":835,"_143":826,"_40":41,"_39":836,"_145":58,"_37":837,"_13":406,"_33":34,"_35":838,"_23":24,"_149":-5,"_325":839,"_26":840},{"_42":823,"_31":824,"_29":825,"_143":826,"_40":41,"_39":827,"_145":58,"_37":828,"_13":432,"_33":34,"_35":829,"_23":24,"_149":-5,"_325":830,"_26":831},{"_42":818,"_31":609,"_29":603,"_143":219,"_40":41,"_39":819,"_145":58,"_37":820,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_325":821,"_26":822},{"_42":813,"_31":805,"_29":799,"_143":603,"_40":41,"_39":814,"_145":58,"_37":815,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_325":816,"_26":817},{"_42":806,"_31":490,"_29":807,"_143":799,"_40":41,"_39":808,"_145":58,"_37":809,"_13":62,"_33":34,"_35":810,"_23":24,"_149":-5,"_325":811,"_26":812},{"_42":796,"_31":797,"_29":798,"_143":799,"_40":41,"_39":800,"_145":58,"_37":801,"_13":62,"_33":34,"_35":802,"_23":24,"_149":-5,"_325":803,"_26":804},{"_42":791,"_31":783,"_29":777,"_143":603,"_40":41,"_39":792,"_145":58,"_37":793,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_325":794,"_26":795},{"_42":784,"_31":490,"_29":785,"_143":777,"_40":41,"_39":786,"_145":24,"_37":787,"_13":62,"_33":34,"_35":788,"_23":24,"_149":-5,"_325":789,"_26":790},{"_42":774,"_31":775,"_29":776,"_143":777,"_40":41,"_39":778,"_145":24,"_37":779,"_13":432,"_33":34,"_35":780,"_23":24,"_149":-5,"_325":781,"_26":782},{"_42":769,"_31":749,"_29":743,"_143":603,"_40":41,"_39":770,"_145":58,"_37":771,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_325":772,"_26":773},{"_42":765,"_31":32,"_29":30,"_143":743,"_40":41,"_39":14,"_145":24,"_37":766,"_13":62,"_33":34,"_35":36,"_23":24,"_149":-5,"_325":767,"_26":768},{"_42":757,"_31":490,"_29":758,"_143":743,"_40":41,"_39":759,"_145":24,"_37":760,"_13":761,"_33":34,"_35":762,"_23":24,"_149":-5,"_325":763,"_26":764},{"_42":750,"_31":652,"_29":751,"_143":743,"_40":41,"_39":752,"_145":58,"_37":753,"_13":415,"_33":34,"_35":754,"_23":24,"_149":-5,"_325":755,"_26":756},{"_42":741,"_31":643,"_29":742,"_143":743,"_40":41,"_39":744,"_145":58,"_37":745,"_13":62,"_33":34,"_35":746,"_23":24,"_149":-5,"_325":747,"_26":748},{"_42":736,"_31":687,"_29":681,"_143":603,"_40":41,"_39":737,"_145":58,"_37":738,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_325":739,"_26":740},{"_42":728,"_31":729,"_29":730,"_143":681,"_40":41,"_39":731,"_145":58,"_37":732,"_13":220,"_33":34,"_35":733,"_23":24,"_149":-5,"_325":734,"_26":735},{"_42":720,"_31":721,"_29":722,"_143":681,"_40":41,"_39":723,"_145":24,"_37":724,"_13":220,"_33":34,"_35":725,"_23":24,"_149":-5,"_325":726,"_26":727},{"_42":712,"_31":713,"_29":714,"_143":681,"_40":41,"_39":715,"_145":58,"_37":716,"_13":220,"_33":34,"_35":717,"_23":24,"_149":-5,"_325":718,"_26":719},{"_42":704,"_31":705,"_29":706,"_143":681,"_40":41,"_39":707,"_145":24,"_37":708,"_13":165,"_33":34,"_35":709,"_23":24,"_149":-5,"_325":710,"_26":711},{"_42":696,"_31":697,"_29":698,"_143":681,"_40":41,"_39":699,"_145":24,"_37":700,"_13":528,"_33":34,"_35":701,"_23":24,"_149":-5,"_325":702,"_26":703},{"_42":688,"_31":689,"_29":690,"_143":681,"_40":41,"_39":691,"_145":58,"_37":692,"_13":181,"_33":34,"_35":693,"_23":24,"_149":-5,"_325":694,"_26":695},{"_42":679,"_31":643,"_29":680,"_143":681,"_40":41,"_39":682,"_145":24,"_37":683,"_13":181,"_33":34,"_35":684,"_23":24,"_149":-5,"_325":685,"_26":686},{"_42":674,"_31":98,"_29":645,"_143":603,"_40":41,"_39":675,"_145":58,"_37":676,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_325":677,"_26":678},{"_42":666,"_31":667,"_29":668,"_143":645,"_40":41,"_39":669,"_145":58,"_37":670,"_13":450,"_33":34,"_35":671,"_23":24,"_149":-5,"_325":672,"_26":673},{"_42":659,"_31":490,"_29":660,"_143":645,"_40":41,"_39":661,"_145":24,"_37":662,"_13":441,"_33":34,"_35":663,"_23":24,"_149":-5,"_325":664,"_26":665},{"_42":651,"_31":652,"_29":653,"_143":645,"_40":41,"_39":654,"_145":58,"_37":655,"_13":181,"_33":34,"_35":656,"_23":24,"_149":-5,"_325":657,"_26":658},{"_42":642,"_31":643,"_29":644,"_143":645,"_40":41,"_39":646,"_145":58,"_37":647,"_13":62,"_33":34,"_35":648,"_23":24,"_149":-5,"_325":649,"_26":650},{"_42":634,"_31":635,"_29":636,"_143":603,"_40":41,"_39":637,"_145":58,"_37":638,"_13":432,"_33":34,"_35":639,"_23":24,"_149":-5,"_325":640,"_26":641},{"_42":626,"_31":627,"_29":628,"_143":603,"_40":41,"_39":629,"_145":58,"_37":630,"_13":450,"_33":34,"_35":631,"_23":24,"_149":-5,"_325":632,"_26":633},{"_42":618,"_31":619,"_29":620,"_143":603,"_40":41,"_39":621,"_145":24,"_37":622,"_13":406,"_33":34,"_35":623,"_23":24,"_149":-5,"_325":624,"_26":625},{"_42":610,"_31":611,"_29":612,"_143":603,"_40":41,"_39":613,"_145":24,"_37":614,"_13":528,"_33":34,"_35":615,"_23":24,"_149":-5,"_325":616,"_26":617},{"_42":601,"_31":402,"_29":602,"_143":603,"_40":41,"_39":604,"_145":58,"_37":605,"_13":406,"_33":34,"_35":606,"_23":24,"_149":-5,"_325":607,"_26":608},{"_42":596,"_31":532,"_29":591,"_143":219,"_40":41,"_39":597,"_145":58,"_37":598,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_325":599,"_26":600},{"_42":590,"_31":533,"_29":525,"_143":591,"_40":41,"_39":592,"_145":58,"_37":593,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_325":594,"_26":595},{"_42":582,"_31":583,"_29":584,"_143":525,"_40":41,"_39":585,"_145":58,"_37":586,"_13":165,"_33":34,"_35":587,"_23":24,"_149":-5,"_325":588,"_26":589},{"_42":574,"_31":575,"_29":576,"_143":525,"_40":41,"_39":577,"_145":58,"_37":578,"_13":165,"_33":34,"_35":579,"_23":24,"_149":-5,"_325":580,"_26":581},{"_42":566,"_31":567,"_29":568,"_143":525,"_40":41,"_39":569,"_145":24,"_37":570,"_13":181,"_33":34,"_35":571,"_23":24,"_149":-5,"_325":572,"_26":573},{"_42":558,"_31":559,"_29":560,"_143":525,"_40":41,"_39":561,"_145":24,"_37":562,"_13":181,"_33":34,"_35":563,"_23":24,"_149":-5,"_325":564,"_26":565},{"_42":550,"_31":551,"_29":552,"_143":525,"_40":41,"_39":553,"_145":58,"_37":554,"_13":370,"_33":34,"_35":555,"_23":24,"_149":-5,"_325":556,"_26":557},{"_42":542,"_31":543,"_29":544,"_143":525,"_40":41,"_39":545,"_145":24,"_37":546,"_13":528,"_33":34,"_35":547,"_23":24,"_149":-5,"_325":548,"_26":549},{"_42":534,"_31":535,"_29":536,"_143":525,"_40":41,"_39":537,"_145":24,"_37":538,"_13":165,"_33":34,"_35":539,"_23":24,"_149":-5,"_325":540,"_26":541},{"_42":522,"_31":523,"_29":524,"_143":525,"_40":41,"_39":526,"_145":58,"_37":527,"_13":528,"_33":34,"_35":529,"_23":24,"_149":-5,"_325":530,"_26":531},{"_42":212,"_31":213,"_29":214,"_143":-5,"_40":41,"_39":181,"_145":58,"_37":519,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_325":520,"_26":521},{"_42":514,"_31":488,"_29":482,"_143":214,"_40":41,"_39":515,"_145":58,"_37":516,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_325":517,"_26":518},{"_42":506,"_31":507,"_29":508,"_143":482,"_40":41,"_39":509,"_145":58,"_37":510,"_13":147,"_33":34,"_35":511,"_23":24,"_149":-5,"_325":512,"_26":513},{"_42":497,"_31":498,"_29":499,"_143":482,"_40":41,"_39":500,"_145":24,"_37":501,"_13":502,"_33":34,"_35":503,"_23":24,"_149":-5,"_325":504,"_26":505},{"_42":489,"_31":490,"_29":491,"_143":482,"_40":41,"_39":492,"_145":58,"_37":493,"_13":62,"_33":34,"_35":494,"_23":24,"_149":-5,"_325":495,"_26":496},{"_42":479,"_31":480,"_29":481,"_143":482,"_40":41,"_39":483,"_145":24,"_37":484,"_13":165,"_33":34,"_35":485,"_23":24,"_149":-5,"_325":486,"_26":487},{"_42":470,"_31":471,"_29":472,"_143":214,"_40":41,"_39":473,"_145":24,"_37":474,"_13":475,"_33":34,"_35":476,"_23":24,"_149":-5,"_325":477,"_26":478},{"_42":462,"_31":463,"_29":464,"_143":214,"_40":41,"_39":465,"_145":58,"_37":466,"_13":220,"_33":34,"_35":467,"_23":24,"_149":-5,"_325":468,"_26":469},{"_42":454,"_31":455,"_29":456,"_143":214,"_40":41,"_39":457,"_145":58,"_37":458,"_13":181,"_33":34,"_35":459,"_23":24,"_149":-5,"_325":460,"_26":461},{"_42":445,"_31":446,"_29":447,"_143":214,"_40":41,"_39":448,"_145":58,"_37":449,"_13":450,"_33":34,"_35":451,"_23":24,"_149":-5,"_325":452,"_26":453},{"_42":436,"_31":437,"_29":438,"_143":214,"_40":41,"_39":439,"_145":24,"_37":440,"_13":441,"_33":34,"_35":442,"_23":24,"_149":-5,"_325":443,"_26":444},{"_42":427,"_31":428,"_29":429,"_143":214,"_40":41,"_39":430,"_145":58,"_37":431,"_13":432,"_33":34,"_35":433,"_23":24,"_149":-5,"_325":434,"_26":435},{"_42":419,"_31":420,"_29":421,"_143":214,"_40":41,"_39":422,"_145":58,"_37":423,"_13":406,"_33":34,"_35":424,"_23":24,"_149":-5,"_325":425,"_26":426},{"_42":410,"_31":411,"_29":412,"_143":214,"_40":41,"_39":413,"_145":58,"_37":414,"_13":415,"_33":34,"_35":416,"_23":24,"_149":-5,"_325":417,"_26":418},{"_42":401,"_31":402,"_29":403,"_143":214,"_40":41,"_39":404,"_145":58,"_37":405,"_13":406,"_33":34,"_35":407,"_23":24,"_149":-5,"_325":408,"_26":409},{"_42":205,"_31":206,"_29":207,"_143":-5,"_40":41,"_39":208,"_145":58,"_37":398,"_13":62,"_33":210,"_35":-5,"_23":24,"_149":-5,"_325":399,"_26":400},{"_42":390,"_31":391,"_29":392,"_143":207,"_40":41,"_39":393,"_145":58,"_37":394,"_13":220,"_33":34,"_35":395,"_23":24,"_149":-5,"_325":396,"_26":397},{"_42":382,"_31":383,"_29":384,"_143":207,"_40":41,"_39":385,"_145":58,"_37":386,"_13":220,"_33":34,"_35":387,"_23":24,"_149":-5,"_325":388,"_26":389},{"_42":374,"_31":375,"_29":376,"_143":207,"_40":41,"_39":377,"_145":58,"_37":378,"_13":181,"_33":34,"_35":379,"_23":24,"_149":-5,"_325":380,"_26":381},{"_42":365,"_31":366,"_29":367,"_143":207,"_40":41,"_39":368,"_145":58,"_37":369,"_13":370,"_33":34,"_35":371,"_23":24,"_149":-5,"_325":372,"_26":373},{"_42":357,"_31":358,"_29":359,"_143":207,"_40":41,"_39":360,"_145":58,"_37":361,"_13":220,"_33":34,"_35":362,"_23":24,"_149":-5,"_325":363,"_26":364},{"_42":349,"_31":350,"_29":351,"_143":207,"_40":41,"_39":352,"_145":24,"_37":353,"_13":220,"_33":34,"_35":354,"_23":24,"_149":-5,"_325":355,"_26":356},{"_42":198,"_31":199,"_29":200,"_143":-5,"_40":41,"_39":201,"_145":58,"_37":346,"_13":62,"_33":20,"_35":203,"_23":24,"_149":-5,"_325":347,"_26":348},{"_42":191,"_31":192,"_29":193,"_143":-5,"_40":41,"_39":194,"_145":24,"_37":343,"_13":62,"_33":20,"_35":196,"_23":24,"_149":-5,"_325":344,"_26":345},{"_42":184,"_31":185,"_29":186,"_143":-5,"_40":41,"_39":187,"_145":58,"_37":340,"_13":181,"_33":20,"_35":189,"_23":24,"_149":-5,"_325":341,"_26":342},{"_42":176,"_31":177,"_29":178,"_143":-5,"_40":41,"_39":179,"_145":24,"_37":337,"_13":181,"_33":20,"_35":182,"_23":24,"_149":-5,"_325":338,"_26":339},{"_42":168,"_31":169,"_29":170,"_143":-5,"_40":41,"_39":171,"_145":24,"_37":334,"_13":173,"_33":20,"_35":174,"_23":24,"_149":-5,"_325":335,"_26":336},{"_42":160,"_31":161,"_29":162,"_143":-5,"_40":41,"_39":163,"_145":24,"_37":331,"_13":165,"_33":20,"_35":166,"_23":24,"_149":-5,"_325":332,"_26":333},{"_42":151,"_31":152,"_29":56,"_143":-5,"_40":41,"_39":153,"_145":58,"_37":328,"_13":155,"_33":156,"_35":157,"_23":24,"_149":158,"_325":329,"_26":330},{"_42":140,"_31":141,"_29":142,"_143":-5,"_40":41,"_39":144,"_145":24,"_37":324,"_13":147,"_33":20,"_35":148,"_23":24,"_149":-5,"_325":326,"_26":327},["D",1782557041254],"children",[],[141],["D",1780941501215],[],[152],["D",1782028227618],[],[161],["D",1782157536204],[],[169],["D",1783012393209],[],[177],["D",1783058175024],[],[185],["D",1781519600473],[],[192],["D",1781519599844],[],[199],"9c4320cd-3e7d-4b5b-b58e-d95340fbbecd","view-meta.ts","81da3cbc-68c2-11f1-8bd7-1607ee4eb77e",546,["D",1782893137728],"#!/usr/bin/env -S deno run --allow-env --allow-net --allow-read\n// view-meta.ts — Read metafields for a customer or order.\n\nimport { parseArgs } from \"jsr:@std/cli@^1/parse-args\";\nimport { bootstrap, opt, resolveGid, usage, wantsHelp } from \"./_common.ts\";\nimport { readMetafields, readMetafieldsByGid } from \"../backend/integrations/shopify/metafields.ts\";\n\nif (wantsHelp(Deno.args.length)) {\n usage([\n \"view-meta — Read metafields for a Shopify customer or order.\",\n \"\",\n \"Usage:\",\n \" deno task view-meta --type user --email \",\n \" deno task view-meta --type user --phone \",\n \" deno task view-meta --type user --id \",\n \" deno task view-meta --type order --order-id \",\n \"\",\n \"Options:\",\n \" --type Resource type (required)\",\n \" --email Customer email (user)\",\n \" --phone Customer phone in E.164 (user)\",\n \" --id Customer Shopify GID (user)\",\n \" --order-id Order ID, #name, or full GID (order)\",\n \" --namespace Filter to a specific namespace\",\n \" -c Store to query (default: ttai)\",\n ]);\n}\n\nconst { cfg, store } = await bootstrap();\nconst p = parseArgs(Deno.args, {\n string: [\"type\", \"email\", \"phone\", \"id\", \"order-id\", \"namespace\", \"c\"],\n});\n\nconst ns = opt(p.namespace);\nconst { gid } = await resolveGid(cfg, store, {\n type: opt(p.type),\n email: opt(p.email),\n phone: opt(p.phone),\n id: opt(p.id),\n \"order-id\": opt(p[\"order-id\"]),\n});\n\nconst mf = opt(p.type) === \"user\"\n ? await readMetafields(cfg, gid, ns)\n : await readMetafieldsByGid(cfg, gid, ns);\n\nif (!mf.length) {\n console.log(\"(no metafields)\");\n Deno.exit(0);\n}\n\nconst nW = ns ? 0 : Math.max(...mf.map((m) => m.namespace.length), 9);\nconst kW = Math.max(...mf.map((m) => m.key.length), 3);\nconst hdr = ns\n ? `${\"KEY\".padEnd(kW)} ${\"VALUE\".padEnd(40)} UPDATED`\n : `${\"NS\".padEnd(nW)} ${\"KEY\".padEnd(kW)} ${\"VALUE\".padEnd(40)} UPDATED`;\nconsole.log(hdr);\nconsole.log(\"─\".repeat(hdr.length));\nfor (const m of mf) {\n const v = m.value.length > 39 ? m.value.slice(0, 36) + \"…\" : m.value;\n console.log(\n ns\n ? `${m.key.padEnd(kW)} ${v.padEnd(40)} ${m.updatedAt}`\n : `${m.namespace.padEnd(nW)} ${m.key.padEnd(kW)} ${v.padEnd(40)} ${m.updatedAt}`,\n );\n}\nconsole.log(`\\n${mf.length} metafield(s)`);\n",[],[206,350],"9b26b63f-09aa-491d-bf4e-cf9324a9b669","set-meta.ts","81b25940-68c2-11f1-a0f2-1607ee4eb77e",549,["D",1782893137906],"#!/usr/bin/env -S deno run --allow-env --allow-net --allow-read\n// set-meta.ts — Write metafields on a customer or order.\n\nimport { parseArgs } from \"jsr:@std/cli@^1/parse-args\";\nimport { bootstrap, die, opt, resolveGid, usage, wantsHelp } from \"./_common.ts\";\nimport { setMetafields } from \"../backend/integrations/shopify/metafields.ts\";\nimport type { MetafieldInput, MetafieldType } from \"../backend/integrations/shopify/metafields.ts\";\n\nif (wantsHelp(Deno.args.length)) {\n usage([\n \"set-meta — Write metafields on a Shopify customer or order.\",\n \"\",\n \"Usage:\",\n \" deno task set-meta --type user --email [ ...]\",\n \" deno task set-meta --type order --order-id '#1001' rating 9 outcome confirmed\",\n \"\",\n \"Options:\",\n \" --type Resource type (required)\",\n \" --email Customer email (user)\",\n \" --phone Customer phone in E.164 (user)\",\n \" --id Customer Shopify GID (user)\",\n \" --order-id Order ID, #name, or full GID (order)\",\n \" --namespace Metafield namespace (default: ttai_call)\",\n \" --field-type Field type shortcode (default: str)\",\n \" -c Store to write to (default: ttai)\",\n \"\",\n \"Field types:\",\n \" str single_line_text_field (default)\",\n \" text multi_line_text_field\",\n ]);\n}\n\nconst TYPES: Record = {\n str: \"single_line_text_field\",\n text: \"multi_line_text_field\",\n};\n\nconst { cfg, store } = await bootstrap();\nconst p = parseArgs(Deno.args, {\n string: [\"type\", \"email\", \"phone\", \"id\", \"order-id\", \"namespace\", \"field-type\", \"c\"],\n});\n\nconst ns = opt(p.namespace) ?? \"ttai_call\";\nconst ft = opt(p[\"field-type\"]) ?? \"str\";\nconst fieldType = TYPES[ft];\nif (!fieldType) die(`Unknown --field-type: ${ft}. Valid: ${Object.keys(TYPES).join(\", \")}`);\n\nconst { gid, label } = await resolveGid(cfg, store, {\n type: opt(p.type),\n email: opt(p.email),\n phone: opt(p.phone),\n id: opt(p.id),\n \"order-id\": opt(p[\"order-id\"]),\n});\n\nconst pos = p._.map(String);\nif (pos.length < 2 || pos.length % 2 !== 0) die(\"Args: [ ...]\");\n\nconst inputs: MetafieldInput[] = [];\nfor (let i = 0; i < pos.length; i += 2) {\n inputs.push({ ownerId: gid, namespace: ns, key: pos[i], type: fieldType, value: pos[i + 1] });\n}\n\nif (inputs.length > 25) {\n die(`Too many key/value pairs (${inputs.length}). metafieldsSet is capped at 25 per call.`);\n}\n\nconsole.log(`Writing ${inputs.length} field(s) to ${ns} [${ft}] …`);\nconst result = await setMetafields(cfg, inputs);\nif (result.userErrors.length) {\n die(`Write failed: ${result.userErrors.map((e) => e.message).join(\"; \")}`);\n}\n\nfor (const m of result.metafields) console.log(` ${m.key} = ${m.value}`);\nconsole.log(`\\n✅ ${result.metafields.length} metafield(s) on ${label}`);\n",[],[206,358],"2c0f21c8-7e8f-4d8d-9f80-170778eda71c","get-customer-info.ts","a0e38a86-68a5-11f1-a4b4-1607ee4eb77e",547,["D",1782893137775],3,"#!/usr/bin/env -S deno run --allow-env --allow-net --allow-read\n// get-customer-info.ts — Full customer profile: identity, orders, checkouts, metafields.\n\nimport { bootstrap, die, usage, wantsHelp } from \"./_common.ts\";\nimport {\n listAbandonedCheckouts,\n resolveCustomer,\n} from \"../backend/integrations/shopify/snapshot.ts\";\nimport { readMetafields } from \"../backend/integrations/shopify/metafields.ts\";\n\nif (wantsHelp(Deno.args.length)) {\n usage([\n \"get-customer-info — Full Shopify customer snapshot.\",\n \"\",\n \"Usage:\",\n \" deno task get-customer-info [namespace]\",\n \" deno task get-customer-info -c jjs \",\n \"\",\n \"Options:\",\n \" Customer email (required, positional)\",\n \" [namespace] Filter metafields to this namespace (optional)\",\n \" -c Store to query (default: ttai)\",\n \"\",\n \"Returns: profile, pending orders, abandoned checkouts, metafields.\",\n ]);\n}\n\nconst { cfg, store, args } = await bootstrap();\nconst [email, namespace] = args;\nif (!email) die(\"Usage: deno task get-customer-info [--c ttai|jjs] [namespace]\");\n\nconsole.log(`[${store}] Looking up ${email} …\\n`);\n\nconst resolved = await resolveCustomer(cfg, { email });\nif (!resolved) {\n console.log(`No customer found for: ${email}`);\n Deno.exit(0);\n}\n\nconst { customer: c, orders } = resolved;\nconst [abandoned, metafields] = await Promise.all([\n listAbandonedCheckouts(cfg, { email: c.email ?? email, customer_id: c.id }),\n readMetafields(cfg, c.id, namespace),\n]);\n\nconsole.log(\"── Customer ────────────────────────────────────────────────\");\nconsole.log(` ID: ${c.id}\\n Name: ${c.display_name}`);\nconsole.log(\n ` Email: ${c.email ?? \"—\"}\\n Phone: ${c.phone ?? \"—\"}\\n Orders: ${c.orders_count}`,\n);\n\nif (orders.length) {\n console.log(\"\\n── Pending Orders ──────────────────────────────────────────\");\n for (const o of orders) {\n console.log(` ${o.name} [${o.financial_status}]`);\n for (const li of o.line_items) console.log(` • ${li.title} × ${li.quantity}`);\n }\n}\nif (abandoned.length) {\n console.log(\"\\n── Abandoned Checkouts ─────────────────────────────────────\");\n for (const ac of abandoned) {\n console.log(` ${ac.created_at.slice(0, 10)}${ac.total_price ? ` ₹${ac.total_price}` : \"\"}`);\n for (const li of ac.line_items) console.log(` • ${li.title} × ${li.quantity}`);\n }\n}\n\nconst mfLabel = namespace ? `(${namespace})` : \"(all)\";\nconsole.log(`\\n── Metafields ${mfLabel} ${\"─\".repeat(40)}`);\nif (!metafields.length) {\n console.log(\" (none)\");\n} else {\n const w = Math.max(...metafields.map((m) => `${m.namespace}.${m.key}`.length), 10);\n for (const m of metafields) {\n const v = m.value.length > 70 ? m.value.slice(0, 67) + \"…\" : m.value;\n console.log(` ${`${m.namespace}.${m.key}`.padEnd(w)} ${v}`);\n }\n}\nconsole.log();\n",[],[206,366],"fed8fed3-d5e9-4bd3-aa34-fcffac087aa1","fetch-context.ts","de5d4448-6d45-11f1-ba3c-1607ee4eb77e",533,["D",1782157536216],"#!/usr/bin/env -S deno run --allow-env --allow-net --allow-read\n// fetch-context.ts — Fetch exact order context and recent abandoned checkouts.\n\nimport { parseArgs } from \"jsr:@std/cli@^1/parse-args\";\nimport { bootstrap, die, opt, usage, wantsHelp } from \"./_common.ts\";\nimport { fetchContext } from \"../backend/integrations/shopify/context.ts\";\n\nif (wantsHelp(Deno.args.length)) {\n usage([\n \"fetch-context — Fetch exact Shopify order context and recent abandoned checkouts.\",\n \"\",\n \"Usage:\",\n \" deno task fetch-context --order-id [--user-email ] [--user-phone ]\",\n \" deno task fetch-context -c jjs '#1001' --user-email priya@example.com\",\n \"\",\n \"Options:\",\n \" --order-id Order ID, #name, or full GID (positional also accepted)\",\n \" --user-email Optional customer email override\",\n \" --user-phone Optional customer phone override\",\n \" -c Store to query (default: ttai)\",\n \"\",\n \"Returns JSON:\",\n \" { user_phone, abandoned_ts, cart_value, user_context, order_context, related_items: [] }\",\n ]);\n}\n\nconst { cfg, store } = await bootstrap();\nconst p = parseArgs(Deno.args, {\n string: [\"order-id\", \"user-email\", \"user-phone\", \"c\"],\n});\n\nconst orderId = opt(p[\"order-id\"]) ?? opt(p._[0]);\nif (!orderId) die(\"Usage: deno task fetch-context [-c ttai|jjs] --order-id \");\n\nconsole.log(`[${store}] Fetching context for order ${orderId} …\\n`);\n\nconst result = await fetchContext(cfg, {\n order_id: orderId,\n user_email: opt(p[\"user-email\"]),\n user_phone: opt(p[\"user-phone\"]),\n});\n\nconsole.log(JSON.stringify(result, null, 2));\n",[],[206,375],"5823d85b-a170-46e6-87d5-0f901922a8d0","del-meta.ts","83d705ea-68c2-11f1-bd6e-1607ee4eb77e",550,["D",1782893137939],"#!/usr/bin/env -S deno run --allow-env --allow-net --allow-read\n// del-meta.ts — Delete ALL metafields on a customer or order. TTAI store only.\n\nimport { parseArgs } from \"jsr:@std/cli@^1/parse-args\";\nimport { load } from \"jsr:@std/dotenv@^0.225\";\nimport { ttaiSecrets } from \"../backend/core/app.ts\";\nimport { shopifyConfig } from \"../backend/integrations/shopify/config.ts\";\nimport { die, opt, resolveGid, usage, wantsHelp } from \"./_common.ts\";\nimport {\n deleteMetafields,\n readMetafields,\n readMetafieldsByGid,\n} from \"../backend/integrations/shopify/metafields.ts\";\n\nif (wantsHelp(Deno.args.length)) {\n usage([\n \"del-meta — Delete ALL metafields on a Shopify customer or order.\",\n \" Safety: only works on the ttai dev store.\",\n \"\",\n \"Usage:\",\n \" deno task del-meta --type user --email \",\n \" deno task del-meta --type user --phone \",\n \" deno task del-meta --type order --order-id \",\n \"\",\n \"Options:\",\n \" --type Resource type (required)\",\n \" --email Customer email (user)\",\n \" --phone Customer phone in E.164 (user)\",\n \" --id Customer Shopify GID (user)\",\n \" --order-id Order ID, #name, or full GID (order)\",\n \"\",\n \"Note: -c flag is ignored; this script is hardcoded to ttai.\",\n ]);\n}\n\nawait load({ export: true });\n\nconst p = parseArgs(Deno.args, {\n string: [\"type\", \"email\", \"phone\", \"id\", \"order-id\", \"c\"],\n});\nif (p.c && p.c !== \"ttai\") die(\"del-meta only works on the ttai store.\");\n\nconst cfg = shopifyConfig(ttaiSecrets());\nconst { gid, label } = await resolveGid(cfg, \"ttai\", {\n type: opt(p.type),\n email: opt(p.email),\n phone: opt(p.phone),\n id: opt(p.id),\n \"order-id\": opt(p[\"order-id\"]),\n});\n\nconst mf = opt(p.type) === \"user\"\n ? await readMetafields(cfg, gid)\n : await readMetafieldsByGid(cfg, gid);\n\nif (!mf.length) {\n console.log(`No metafields on ${label}.`);\n Deno.exit(0);\n}\n\nconsole.log(`Found ${mf.length} metafield(s) on ${label}:`);\nfor (const m of mf) console.log(` ${m.namespace}.${m.key} = ${m.value.slice(0, 50)}`);\n\nconst toDelete = mf.map((m) => ({ ownerId: gid, namespace: m.namespace, key: m.key }));\nif (toDelete.length > 25) {\n die(\n `Too many metafields (${toDelete.length}). deleteMetafields is capped at 25 per call. Delete in batches.`,\n );\n}\n\nconst result = await deleteMetafields(cfg, toDelete);\n\nif (result.userErrors.length) {\n die(`Delete failed: ${result.userErrors.map((e) => e.message).join(\"; \")}`);\n}\nconsole.log(`\\n✅ Deleted ${result.deletedMetafields.length} metafield(s).`);\n",[],[206,383],"783d8c5c-d303-431c-8af6-300b83077802","_common.ts","b9a49a52-68a9-11f1-bf28-1607ee4eb77e",548,["D",1782893137811],"// _common.ts — Shared bootstrap + resource resolution for scripts.\n\nimport { load } from \"jsr:@std/dotenv@^0.225\";\nimport { parseArgs } from \"jsr:@std/cli@^1/parse-args\";\nimport { jjsSecrets, ttaiSecrets } from \"../backend/core/app.ts\";\nimport { type ShopifyConfig, shopifyConfig } from \"../backend/integrations/shopify/config.ts\";\nimport { resolveCustomerGid, resolveOrderGid } from \"../backend/integrations/shopify/snapshot.ts\";\nimport type { ShopifySecrets } from \"../backend/core/app.ts\";\n\nconst STORES: Record ShopifySecrets> = { ttai: ttaiSecrets, jjs: jjsSecrets };\n\nexport interface ScriptCtx {\n cfg: ShopifyConfig;\n store: string;\n args: string[];\n}\n\n/** Parse --c flag, load .env, return ShopifyConfig + positional args. */\nexport async function bootstrap(): Promise {\n await load({ export: true });\n const parsed = parseArgs(Deno.args, { string: [\"c\"], default: { c: \"ttai\" } });\n const store = parsed.c as string;\n const resolver = STORES[store];\n if (!resolver) {\n console.error(`Unknown store: ${store}. Valid: ${Object.keys(STORES).join(\", \")}`);\n Deno.exit(1);\n }\n return { cfg: shopifyConfig(resolver()), store, args: parsed._.map(String) };\n}\n\n/** Resolve a Shopify GID from parsed flags. Returns GID + human label, or exits. */\nexport async function resolveGid(\n cfg: ShopifyConfig,\n store: string,\n opts: { type?: string; email?: string; phone?: string; id?: string; \"order-id\"?: string },\n): Promise<{ gid: string; label: string }> {\n const t = opts.type?.trim();\n if (!t || ![\"user\", \"order\"].includes(t)) die(\"--type must be user or order\");\n\n if (t === \"user\") {\n const email = opts.email?.trim() || undefined;\n const phone = opts.phone?.trim() || undefined;\n const id = opts.id?.trim() || undefined;\n if (!email && !phone && !id) die(\"Provide --email, --phone, or --id\");\n console.log(`[${store}] Resolving customer …`);\n const gid = await resolveCustomerGid(cfg, { email, phone, customer_id: id });\n if (!gid) die(`Customer not found: ${email ?? phone ?? id}`);\n console.log(` → ${gid}\\n`);\n return { gid, label: `customer ${email ?? phone ?? id}` };\n }\n\n const ref = opts[\"order-id\"]?.trim();\n if (!ref) die(\"Provide --order-id\");\n console.log(`[${store}] Resolving order ${ref} …`);\n const gid = await resolveOrderGid(cfg, ref);\n if (!gid) die(`Order not found: ${ref}`);\n console.log(` → ${gid}\\n`);\n return { gid, label: `order ${ref}` };\n}\n\nexport function die(msg: string): never {\n console.error(msg);\n Deno.exit(1);\n}\n\n/** Shorthand: trim or undefined. */\nexport function opt(v: unknown): string | undefined {\n return typeof v === \"string\" && v.trim() ? v.trim() : undefined;\n}\n\n/** Print usage and exit. Lines are joined with newline. */\nexport function usage(lines: string[]): never {\n console.log(lines.join(\"\\n\"));\n Deno.exit(0);\n}\n\n/** True if user passed --help or -h, or no meaningful args at all. */\nexport function wantsHelp(argCount: number): boolean {\n return Deno.args.includes(\"--help\") || Deno.args.includes(\"-h\") || argCount === 0;\n}\n",[],[206,391],["D",1781519599541],[310,311,312,313,314,315],[206],"8df317d9-1e53-4d64-bbaf-05bab76aa472","types.ts","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",[],[213,402],"a1457f60-24f4-4020-a557-4cff6f56b16e","shared.tsx","fe520698-632d-11f1-aacf-1607ee4eb77e",386,["D",1780952006405],13,"/** @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/** Serialize data for safe inlining inside a `\n \n

Diff · v592