[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_823":824,"_825":826},"routes/_app.x.$handle.$name",{"_99":98,"_32":45,"_108":89,"_27":53,"_13":14,"_109":-5,"_11":110,"_111":112,"_113":114,"_115":116,"_117":118,"_20":-5,"_119":-5,"_120":-5,"_121":26,"_122":123,"_124":24,"_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",{"_43":44,"_32":45,"_38":46,"_47":-5,"_48":26,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":57,"_58":24,"_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":26},"version",455,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":26,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":35,"_36":37,"_38":39,"_40":14,"_41":42,"_23":26},"previous","deleted",true,"deletedHere",false,"path","scripts/order-metafields.ts","latestPath","fileId","3bfed3ae-68b0-11f1-a31d-1607ee4eb77e","name","order-metafields.ts","fileType","script","content","#!/usr/bin/env -S deno run --allow-env --allow-net --allow-read\n// order-metafields.ts — Read or write metafields on a Shopify order.\n//\n// Usage (from exp/vals/uAgents/):\n// # read all metafields on an order\n// deno task order-metafields --order '#1001'\n// deno task order-metafields --order 5678901234 --namespace ttai_call\n//\n// # write one or more key=value pairs\n// deno task order-metafields --order '#1001' --key call_outcome --value order_confirmed\n// deno task order-metafields --order '#1001' --key rating --value 9 --key agent_notes --value \"happy customer\"\n//\n// # target jjs store\n// deno task order-metafields --c jjs --order '#1001' --key call_outcome --value order_confirmed\n\nimport { parseArgs } from \"jsr:@std/cli@^1/parse-args\";\nimport { bootstrap } from \"./_common.ts\";\nimport { resolveOrderGid } from \"../backend/integrations/shopify/snapshot.ts\";\nimport {\n readMetafieldsByGid,\n setMetafields,\n} from \"../backend/integrations/shopify/metafields.ts\";\nimport type { MetafieldInput } from \"../backend/integrations/shopify/metafields.ts\";\n\nconst { cfg, customer } = await bootstrap();\n\n// -----------------------------------------------------------------------------\n// args\n// -----------------------------------------------------------------------------\n\nconst parsed = parseArgs(Deno.args, {\n string: [\"order\", \"namespace\", \"key\", \"value\", \"c\"],\n collect: [\"key\", \"value\"],\n default: { namespace: \"ttai_call\" },\n});\n\nconst orderRef = (parsed.order as string | undefined)?.trim();\nif (!orderRef) {\n console.error(\"Usage: --order [--key K --value V ...] [--namespace NS]\");\n Deno.exit(1);\n}\n\nconst keys = (parsed.key ?? []) as string[];\nconst values = (parsed.value ?? []) as string[];\n\nif (keys.length !== values.length) {\n console.error(`--key / --value count mismatch (${keys.length} keys, ${values.length} values)`);\n Deno.exit(1);\n}\n\nconst namespace = (parsed.namespace as string) || \"ttai_call\";\nconst isWrite = keys.length > 0;\n\n// -----------------------------------------------------------------------------\n// resolve order\n// -----------------------------------------------------------------------------\n\nconsole.log(`[${customer}] Resolving order ${orderRef} …`);\nconst orderId = await resolveOrderGid(cfg, orderRef);\nif (!orderId) {\n console.error(`Order not found: ${orderRef}`);\n Deno.exit(1);\n}\nconsole.log(` → ${orderId}\\n`);\n\n// -----------------------------------------------------------------------------\n// write\n// -----------------------------------------------------------------------------\n\nif (isWrite) {\n const inputs: MetafieldInput[] = keys.map((key, i) => ({\n ownerId: orderId,\n namespace,\n key,\n type: \"single_line_text_field\",\n value: values[i],\n }));\n\n console.log(`Writing ${inputs.length} metafield(s) to ${namespace} …`);\n const result = await setMetafields(cfg, inputs);\n\n if (result.userErrors.length) {\n console.error(\"Write errors:\", result.userErrors.map((e) => e.message).join(\"; \"));\n Deno.exit(1);\n }\n\n const colW = Math.max(...result.metafields.map((m) => m.key.length), 3);\n console.log(`\\n${\"KEY\".padEnd(colW)} VALUE`);\n console.log(\"─\".repeat(colW + 42));\n for (const m of result.metafields) {\n console.log(`${m.key.padEnd(colW)} ${m.value}`);\n }\n console.log(`\\n✅ Written ${result.metafields.length} metafield(s)`);\n}\n\n// -----------------------------------------------------------------------------\n// read (always shown after write, or standalone)\n// -----------------------------------------------------------------------------\n\nconsole.log(`\\nReading ${namespace}.* …`);\nconst metafields = await readMetafieldsByGid(cfg, orderId, namespace);\n\nif (!metafields.length) {\n console.log(\" (no metafields found)\");\n Deno.exit(0);\n}\n\nconst colW = Math.max(...metafields.map((m) => m.key.length), 3);\nconsole.log(`\\n${\"KEY\".padEnd(colW)} ${\"VALUE\".padEnd(40)} UPDATED`);\nconsole.log(\"─\".repeat(colW + 60));\nfor (const m of metafields) {\n console.log(\n `${m.key.padEnd(colW)} ${m.value.slice(0, 39).padEnd(40)} ${m.updatedAt}`,\n );\n}\nconsole.log(`\\nTotal: ${metafields.length} metafield(s)`);\n","createdAt",["D",1781524155519],"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","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":26},"branch",{"_13":88,"_32":89,"_43":42,"_90":44,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":45,"_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=1789587801&sig=5c4071b92bb0e705584811dcbf396580e48c3a050145f8999675a9c23575173f","tier","free","canRestrictVals","profileImageUrl","branchName","adoptOrgId",{"_43":44,"_32":45,"_38":818,"_47":-5,"_48":26,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":57,"_58":24,"_59":-5,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":68,"_69":819,"_71":-5,"_72":73,"_74":73,"_75":76,"_77":76,"_78":76,"_79":73,"_80":73,"_81":820,"_83":821,"_85":822,"_87":26},"tree",[215,261,276,282,283,284,285,286,287],"files",[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,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],"counts",{"_205":62,"_206":197,"_207":62,"_208":209,"_210":211},"contents",[129,130,131,132,133,134,135,136,137],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_43":200,"_32":201,"_30":202,"_141":-5,"_41":42,"_40":162,"_143":24,"_38":203,"_13":62,"_34":192,"_36":-5,"_23":26,"_147":-5,"_27":204},{"_43":194,"_32":195,"_30":196,"_141":-5,"_41":42,"_40":197,"_143":24,"_38":198,"_13":62,"_34":192,"_36":-5,"_23":26,"_147":-5,"_27":199},{"_43":187,"_32":188,"_30":189,"_141":-5,"_41":42,"_40":190,"_143":24,"_38":191,"_13":62,"_34":192,"_36":-5,"_23":26,"_147":-5,"_27":193},{"_43":180,"_32":181,"_30":182,"_141":-5,"_41":42,"_40":183,"_143":24,"_38":184,"_13":62,"_34":20,"_36":185,"_23":26,"_147":-5,"_27":186},{"_43":173,"_32":174,"_30":175,"_141":-5,"_41":42,"_40":176,"_143":26,"_38":177,"_13":62,"_34":20,"_36":178,"_23":26,"_147":-5,"_27":179},{"_43":165,"_32":166,"_30":167,"_141":-5,"_41":42,"_40":168,"_143":26,"_38":169,"_13":170,"_34":20,"_36":171,"_23":26,"_147":-5,"_27":172},{"_43":157,"_32":158,"_30":159,"_141":-5,"_41":42,"_40":160,"_143":26,"_38":161,"_13":162,"_34":20,"_36":163,"_23":26,"_147":-5,"_27":164},{"_43":149,"_32":150,"_30":57,"_141":-5,"_41":42,"_40":151,"_143":24,"_38":152,"_13":145,"_34":153,"_36":154,"_23":26,"_147":155,"_27":156},{"_43":138,"_32":139,"_30":140,"_141":-5,"_41":42,"_40":142,"_143":26,"_38":144,"_13":145,"_34":20,"_36":146,"_23":26,"_147":-5,"_27":148},"14184c70-fbf1-46a8-9d30-d6c560e493a0","val.yml","f3605d0e-6128-11f1-9354-1607ee4eb77e","parentId",426,"latest",["D",1781519600495],10,"# 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","label",[139],"a17d6cb6-e1b8-4017-bfe6-f364eeab5315","index.http.ts",280,["D",1780941501215],"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",[150],"20c09144-5d7a-4416-92c4-ffa0c7f2b2a7","deno.json","f353dd04-6128-11f1-ac3a-1607ee4eb77e",442,["D",1781519600595],2,"{\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 \"get-customer-info\": \"deno run -A scripts/get-customer-info.ts\",\n \"set-metafields\": \"deno run -A scripts/set-metafields.ts\",\n \"delete-metafields\": \"deno run -A scripts/delete-metafields.ts\"\n }\n}\n",[158],"08f25fc7-2afd-43ca-b2e3-64023657b149","README.md","f3e9fe92-6128-11f1-b4a4-1607ee4eb77e",441,["D",1781519602158],22,"# 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 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 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 obscurity:\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`) — deterministic Shopify Admin read (no LLM). Body with at least\n one of `customer_id` / `customer_email` / `customer_phone` → profile, pending orders, abandoned\n checkouts. The same lookup is exposed to the agent as `get_customer_info`.\n- **`shopify-sidekick`** (`jjs`) — 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()`) 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 — 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\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 shop/client creds ⇒ those functions return **503**\n 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.\nThey import 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,\nand all metafields. 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---\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",[166],"ed26c467-4364-40b5-9a09-ae75cab95f12",".gitignore","a117d82c-68a5-11f1-926a-1607ee4eb77e",427,["D",1781519600473],".env\nscripts/.env\n",[174],"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",[181],"ff7f2101-71a5-425e-a367-560ef13a2086","scripts","a06c5628-68a5-11f1-b189-1607ee4eb77e",416,["D",1781519599541],"directory",[188],"6d14e6de-c8d3-45e7-ba6f-2ed984a1f71b","frontend","f2b2b82a-6128-11f1-9496-1607ee4eb77e",1,["D",1780696392346],[195],"157d3e42-b14b-4a4a-b3d1-13e8c95b8213","backend","f2d380b4-6128-11f1-b4a4-1607ee4eb77e",["D",1780696392550],[201],"pulls","branches","forks","envVars",{"_212":197,"_214":62},"connections",{"_212":62,"_213":62},"count","unfilledCount","emptyCount",{"_43":200,"_32":201,"_30":202,"_141":-5,"_41":42,"_40":162,"_143":24,"_38":815,"_13":62,"_34":192,"_36":-5,"_23":26,"_147":-5,"_289":816,"_27":817},{"_43":810,"_32":785,"_30":779,"_141":202,"_41":42,"_40":811,"_143":24,"_38":812,"_13":62,"_34":192,"_36":-5,"_23":26,"_147":-5,"_289":813,"_27":814},{"_43":802,"_32":803,"_30":804,"_141":779,"_41":42,"_40":805,"_143":24,"_38":806,"_13":162,"_34":35,"_36":807,"_23":26,"_147":-5,"_289":808,"_27":809},{"_43":794,"_32":795,"_30":796,"_141":779,"_41":42,"_40":797,"_143":26,"_38":798,"_13":474,"_34":35,"_36":799,"_23":26,"_147":-5,"_289":800,"_27":801},{"_43":786,"_32":787,"_30":788,"_141":779,"_41":42,"_40":789,"_143":24,"_38":790,"_13":377,"_34":35,"_36":791,"_23":26,"_147":-5,"_289":792,"_27":793},{"_43":777,"_32":347,"_30":778,"_141":779,"_41":42,"_40":780,"_143":24,"_38":781,"_13":474,"_34":35,"_36":782,"_23":26,"_147":-5,"_289":783,"_27":784},{"_43":772,"_32":754,"_30":748,"_141":202,"_41":42,"_40":773,"_143":24,"_38":774,"_13":62,"_34":192,"_36":-5,"_23":26,"_147":-5,"_289":775,"_27":776},{"_43":764,"_32":765,"_30":766,"_141":748,"_41":42,"_40":767,"_143":26,"_38":768,"_13":474,"_34":35,"_36":769,"_23":26,"_147":-5,"_289":770,"_27":771},{"_43":755,"_32":756,"_30":757,"_141":748,"_41":42,"_40":758,"_143":26,"_38":759,"_13":760,"_34":35,"_36":761,"_23":26,"_147":-5,"_289":762,"_27":763},{"_43":745,"_32":746,"_30":747,"_141":748,"_41":42,"_40":749,"_143":26,"_38":750,"_13":351,"_34":35,"_36":751,"_23":26,"_147":-5,"_289":752,"_27":753},{"_43":740,"_32":699,"_30":693,"_141":202,"_41":42,"_40":741,"_143":24,"_38":742,"_13":62,"_34":192,"_36":-5,"_23":26,"_147":-5,"_289":743,"_27":744},{"_43":732,"_32":733,"_30":734,"_141":693,"_41":42,"_40":735,"_143":24,"_38":736,"_13":162,"_34":35,"_36":737,"_23":26,"_147":-5,"_289":738,"_27":739},{"_43":724,"_32":725,"_30":726,"_141":693,"_41":42,"_40":727,"_143":26,"_38":728,"_13":501,"_34":35,"_36":729,"_23":26,"_147":-5,"_289":730,"_27":731},{"_43":716,"_32":717,"_30":718,"_141":693,"_41":42,"_40":719,"_143":26,"_38":720,"_13":430,"_34":35,"_36":721,"_23":26,"_147":-5,"_289":722,"_27":723},{"_43":708,"_32":709,"_30":710,"_141":693,"_41":42,"_40":711,"_143":26,"_38":712,"_13":474,"_34":35,"_36":713,"_23":26,"_147":-5,"_289":714,"_27":715},{"_43":700,"_32":701,"_30":702,"_141":693,"_41":42,"_40":703,"_143":24,"_38":704,"_13":351,"_34":35,"_36":705,"_23":26,"_147":-5,"_289":706,"_27":707},{"_43":690,"_32":691,"_30":692,"_141":693,"_41":42,"_40":694,"_143":24,"_38":695,"_13":377,"_34":35,"_36":696,"_23":26,"_147":-5,"_289":697,"_27":698},{"_43":685,"_32":540,"_30":534,"_141":202,"_41":42,"_40":686,"_143":24,"_38":687,"_13":62,"_34":192,"_36":-5,"_23":26,"_147":-5,"_289":688,"_27":689},{"_43":680,"_32":634,"_30":627,"_141":534,"_41":42,"_40":681,"_143":24,"_38":682,"_13":62,"_34":192,"_36":-5,"_23":26,"_147":-5,"_289":683,"_27":684},{"_43":673,"_32":320,"_30":674,"_141":627,"_41":42,"_40":675,"_143":26,"_38":676,"_13":145,"_34":35,"_36":677,"_23":26,"_147":-5,"_289":678,"_27":679},{"_43":666,"_32":598,"_30":667,"_141":627,"_41":42,"_40":668,"_143":26,"_38":669,"_13":62,"_34":35,"_36":670,"_23":26,"_147":-5,"_289":671,"_27":672},{"_43":658,"_32":659,"_30":660,"_141":627,"_41":42,"_40":661,"_143":26,"_38":662,"_13":62,"_34":35,"_36":663,"_23":26,"_147":-5,"_289":664,"_27":665},{"_43":650,"_32":436,"_30":651,"_141":627,"_41":42,"_40":652,"_143":26,"_38":653,"_13":654,"_34":35,"_36":655,"_23":26,"_147":-5,"_289":656,"_27":657},{"_43":643,"_32":583,"_30":644,"_141":627,"_41":42,"_40":645,"_143":26,"_38":646,"_13":162,"_34":35,"_36":647,"_23":26,"_147":-5,"_289":648,"_27":649},{"_43":635,"_32":636,"_30":637,"_141":627,"_41":42,"_40":638,"_143":26,"_38":639,"_13":62,"_34":35,"_36":640,"_23":26,"_147":-5,"_289":641,"_27":642},{"_43":625,"_32":574,"_30":626,"_141":627,"_41":42,"_40":628,"_143":26,"_38":629,"_13":630,"_34":35,"_36":631,"_23":26,"_147":-5,"_289":632,"_27":633},{"_43":620,"_32":98,"_30":576,"_141":534,"_41":42,"_40":621,"_143":24,"_38":622,"_13":62,"_34":192,"_36":-5,"_23":26,"_147":-5,"_289":623,"_27":624},{"_43":612,"_32":613,"_30":614,"_141":576,"_41":42,"_40":615,"_143":24,"_38":616,"_13":395,"_34":35,"_36":617,"_23":26,"_147":-5,"_289":618,"_27":619},{"_43":605,"_32":320,"_30":606,"_141":576,"_41":42,"_40":607,"_143":26,"_38":608,"_13":62,"_34":35,"_36":609,"_23":26,"_147":-5,"_289":610,"_27":611},{"_43":597,"_32":598,"_30":599,"_141":576,"_41":42,"_40":600,"_143":26,"_38":601,"_13":62,"_34":35,"_36":602,"_23":26,"_147":-5,"_289":603,"_27":604},{"_43":590,"_32":436,"_30":591,"_141":576,"_41":42,"_40":592,"_143":26,"_38":593,"_13":474,"_34":35,"_36":594,"_23":26,"_147":-5,"_289":595,"_27":596},{"_43":582,"_32":583,"_30":584,"_141":576,"_41":42,"_40":585,"_143":26,"_38":586,"_13":197,"_34":35,"_36":587,"_23":26,"_147":-5,"_289":588,"_27":589},{"_43":573,"_32":574,"_30":575,"_141":576,"_41":42,"_40":577,"_143":26,"_38":578,"_13":62,"_34":35,"_36":579,"_23":26,"_147":-5,"_289":580,"_27":581},{"_43":565,"_32":566,"_30":567,"_141":534,"_41":42,"_40":568,"_143":26,"_38":569,"_13":501,"_34":35,"_36":570,"_23":26,"_147":-5,"_289":571,"_27":572},{"_43":557,"_32":558,"_30":559,"_141":534,"_41":42,"_40":560,"_143":24,"_38":561,"_13":395,"_34":35,"_36":562,"_23":26,"_147":-5,"_289":563,"_27":564},{"_43":549,"_32":550,"_30":551,"_141":534,"_41":42,"_40":552,"_143":26,"_38":553,"_13":351,"_34":35,"_36":554,"_23":26,"_147":-5,"_289":555,"_27":556},{"_43":541,"_32":542,"_30":543,"_141":534,"_41":42,"_40":544,"_143":26,"_38":545,"_13":501,"_34":35,"_36":546,"_23":26,"_147":-5,"_289":547,"_27":548},{"_43":532,"_32":347,"_30":533,"_141":534,"_41":42,"_40":535,"_143":24,"_38":536,"_13":351,"_34":35,"_36":537,"_23":26,"_147":-5,"_289":538,"_27":539},{"_43":527,"_32":478,"_30":522,"_141":202,"_41":42,"_40":528,"_143":24,"_38":529,"_13":62,"_34":192,"_36":-5,"_23":26,"_147":-5,"_289":530,"_27":531},{"_43":521,"_32":479,"_30":471,"_141":522,"_41":42,"_40":523,"_143":24,"_38":524,"_13":62,"_34":192,"_36":-5,"_23":26,"_147":-5,"_289":525,"_27":526},{"_43":513,"_32":514,"_30":515,"_141":471,"_41":42,"_40":516,"_143":26,"_38":517,"_13":474,"_34":35,"_36":518,"_23":26,"_147":-5,"_289":519,"_27":520},{"_43":505,"_32":506,"_30":507,"_141":471,"_41":42,"_40":508,"_143":24,"_38":509,"_13":430,"_34":35,"_36":510,"_23":26,"_147":-5,"_289":511,"_27":512},{"_43":496,"_32":497,"_30":498,"_141":471,"_41":42,"_40":499,"_143":24,"_38":500,"_13":501,"_34":35,"_36":502,"_23":26,"_147":-5,"_289":503,"_27":504},{"_43":488,"_32":489,"_30":490,"_141":471,"_41":42,"_40":491,"_143":26,"_38":492,"_13":162,"_34":35,"_36":493,"_23":26,"_147":-5,"_289":494,"_27":495},{"_43":480,"_32":481,"_30":482,"_141":471,"_41":42,"_40":483,"_143":26,"_38":484,"_13":474,"_34":35,"_36":485,"_23":26,"_147":-5,"_289":486,"_27":487},{"_43":468,"_32":469,"_30":470,"_141":471,"_41":42,"_40":472,"_143":24,"_38":473,"_13":474,"_34":35,"_36":475,"_23":26,"_147":-5,"_289":476,"_27":477},{"_43":194,"_32":195,"_30":196,"_141":-5,"_41":42,"_40":197,"_143":24,"_38":465,"_13":62,"_34":192,"_36":-5,"_23":26,"_147":-5,"_289":466,"_27":467},{"_43":460,"_32":434,"_30":427,"_141":196,"_41":42,"_40":461,"_143":24,"_38":462,"_13":62,"_34":192,"_36":-5,"_23":26,"_147":-5,"_289":463,"_27":464},{"_43":452,"_32":453,"_30":454,"_141":427,"_41":42,"_40":455,"_143":24,"_38":456,"_13":386,"_34":35,"_36":457,"_23":26,"_147":-5,"_289":458,"_27":459},{"_43":443,"_32":444,"_30":445,"_141":427,"_41":42,"_40":446,"_143":26,"_38":447,"_13":448,"_34":35,"_36":449,"_23":26,"_147":-5,"_289":450,"_27":451},{"_43":435,"_32":436,"_30":437,"_141":427,"_41":42,"_40":438,"_143":24,"_38":439,"_13":62,"_34":35,"_36":440,"_23":26,"_147":-5,"_289":441,"_27":442},{"_43":424,"_32":425,"_30":426,"_141":427,"_41":42,"_40":428,"_143":26,"_38":429,"_13":430,"_34":35,"_36":431,"_23":26,"_147":-5,"_289":432,"_27":433},{"_43":415,"_32":416,"_30":417,"_141":196,"_41":42,"_40":418,"_143":26,"_38":419,"_13":420,"_34":35,"_36":421,"_23":26,"_147":-5,"_289":422,"_27":423},{"_43":407,"_32":408,"_30":409,"_141":196,"_41":42,"_40":410,"_143":24,"_38":411,"_13":162,"_34":35,"_36":412,"_23":26,"_147":-5,"_289":413,"_27":414},{"_43":399,"_32":400,"_30":401,"_141":196,"_41":42,"_40":402,"_143":24,"_38":403,"_13":197,"_34":35,"_36":404,"_23":26,"_147":-5,"_289":405,"_27":406},{"_43":390,"_32":391,"_30":392,"_141":196,"_41":42,"_40":393,"_143":24,"_38":394,"_13":395,"_34":35,"_36":396,"_23":26,"_147":-5,"_289":397,"_27":398},{"_43":381,"_32":382,"_30":383,"_141":196,"_41":42,"_40":384,"_143":26,"_38":385,"_13":386,"_34":35,"_36":387,"_23":26,"_147":-5,"_289":388,"_27":389},{"_43":372,"_32":373,"_30":374,"_141":196,"_41":42,"_40":375,"_143":24,"_38":376,"_13":377,"_34":35,"_36":378,"_23":26,"_147":-5,"_289":379,"_27":380},{"_43":364,"_32":365,"_30":366,"_141":196,"_41":42,"_40":367,"_143":24,"_38":368,"_13":351,"_34":35,"_36":369,"_23":26,"_147":-5,"_289":370,"_27":371},{"_43":355,"_32":356,"_30":357,"_141":196,"_41":42,"_40":358,"_143":24,"_38":359,"_13":360,"_34":35,"_36":361,"_23":26,"_147":-5,"_289":362,"_27":363},{"_43":346,"_32":347,"_30":348,"_141":196,"_41":42,"_40":349,"_143":24,"_38":350,"_13":351,"_34":35,"_36":352,"_23":26,"_147":-5,"_289":353,"_27":354},{"_43":187,"_32":188,"_30":189,"_141":-5,"_41":42,"_40":190,"_143":24,"_38":343,"_13":62,"_34":192,"_36":-5,"_23":26,"_147":-5,"_289":344,"_27":345},{"_43":335,"_32":336,"_30":337,"_141":189,"_41":42,"_40":338,"_143":26,"_38":339,"_13":62,"_34":35,"_36":340,"_23":26,"_147":-5,"_289":341,"_27":342},{"_43":327,"_32":328,"_30":329,"_141":189,"_41":42,"_40":330,"_143":26,"_38":331,"_13":197,"_34":35,"_36":332,"_23":26,"_147":-5,"_289":333,"_27":334},{"_43":319,"_32":320,"_30":321,"_141":189,"_41":42,"_40":322,"_143":26,"_38":323,"_13":197,"_34":35,"_36":324,"_23":26,"_147":-5,"_289":325,"_27":326},{"_43":315,"_32":33,"_30":31,"_141":189,"_41":42,"_40":14,"_143":26,"_38":316,"_13":62,"_34":35,"_36":37,"_23":26,"_147":-5,"_289":317,"_27":318},{"_43":307,"_32":308,"_30":309,"_141":189,"_41":42,"_40":310,"_143":26,"_38":311,"_13":197,"_34":35,"_36":312,"_23":26,"_147":-5,"_289":313,"_27":314},{"_43":180,"_32":181,"_30":182,"_141":-5,"_41":42,"_40":183,"_143":24,"_38":304,"_13":62,"_34":20,"_36":185,"_23":26,"_147":-5,"_289":305,"_27":306},{"_43":173,"_32":174,"_30":175,"_141":-5,"_41":42,"_40":176,"_143":26,"_38":301,"_13":62,"_34":20,"_36":178,"_23":26,"_147":-5,"_289":302,"_27":303},{"_43":165,"_32":166,"_30":167,"_141":-5,"_41":42,"_40":168,"_143":26,"_38":298,"_13":170,"_34":20,"_36":171,"_23":26,"_147":-5,"_289":299,"_27":300},{"_43":157,"_32":158,"_30":159,"_141":-5,"_41":42,"_40":160,"_143":26,"_38":295,"_13":162,"_34":20,"_36":163,"_23":26,"_147":-5,"_289":296,"_27":297},{"_43":149,"_32":150,"_30":57,"_141":-5,"_41":42,"_40":151,"_143":24,"_38":292,"_13":145,"_34":153,"_36":154,"_23":26,"_147":155,"_289":293,"_27":294},{"_43":138,"_32":139,"_30":140,"_141":-5,"_41":42,"_40":142,"_143":26,"_38":288,"_13":145,"_34":20,"_36":146,"_23":26,"_147":-5,"_289":290,"_27":291},["D",1781519600495],"children",[],[139],["D",1780941501215],[],[150],["D",1781519600595],[],[158],["D",1781519602158],[],[166],["D",1781519600473],[],[174],["D",1781519599844],[],[181],"10d98b3f-a366-4e53-9e62-f8e6a8085ee8","set-metafields.ts","a0c6b2bc-68a5-11f1-a8ac-1607ee4eb77e",444,["D",1781521359865],"#!/usr/bin/env -S deno run --allow-env --allow-net --allow-read\n// set-metafields.ts — QA script: write a known post-session payload to Mayank's\n// customer record and confirm the metafields came back correctly.\n// Hardcoded — run this after any change to post-feedback logic to verify end-to-end.\n//\n// Usage (from exp/vals/uAgents/):\n// deno task set-metafields\n// deno task set-metafields --c jjs\n\nimport { bootstrap } from \"./_common.ts\";\nimport { resolveCustomerGid } from \"../backend/integrations/shopify/snapshot.ts\";\nimport { setMetafields, readMetafields } from \"../backend/integrations/shopify/metafields.ts\";\nimport type { MetafieldInput, MetafieldType } from \"../backend/integrations/shopify/metafields.ts\";\n\nconst { cfg, customer } = await bootstrap();\n\n// -----------------------------------------------------------------------------\n// hardcoded QA fixture\n// -----------------------------------------------------------------------------\n\nconst QA_EMAIL = \"mayank.raj.unofficial@gmail.com\";\nconst NAMESPACE = \"ttai_call\";\n\nconst QA_VARS: Record = {\n call_outcome: \"order_placed\",\n cart_recovery_score: \"9\",\n items_ordered: \"Mithila Special Mango 250g\",\n order_total: \"490\",\n abandonment_reason: \"cod_not_showing\",\n customer_address: \"Pre-existing address confirmed\",\n follow_up_action: \"Send WhatsApp confirmation — Rs 490 COD order placed\",\n};\n\nconst QA_SESSION = {\n session_id: \"qa-script-001\",\n scenario_id: \"b67e6a0867d19142d9c90521\",\n call_ts: \"2026-06-15T00:00:00Z\",\n};\n\nconst TYPE_MAP: Record = {\n cart_recovery_score: \"number_integer\",\n order_total: \"number_decimal\",\n call_ts: \"date_time\",\n};\n\n// Shopify normalises number_decimal values (e.g. \"490\" → \"490.0\").\nconst DECIMAL_KEYS = new Set(\n Object.entries(TYPE_MAP)\n .filter(([, t]) => t === \"number_decimal\")\n .map(([k]) => k),\n);\nfunction normaliseValue(key: string, value: string): string {\n if (DECIMAL_KEYS.has(key) && !value.includes(\".\")) return `${value}.0`;\n return value;\n}\n\n// -----------------------------------------------------------------------------\n// write\n// -----------------------------------------------------------------------------\n\nconsole.log(`[${customer}] Writing QA metafields for ${QA_EMAIL} …\\n`);\n\nconst customerId = await resolveCustomerGid(cfg, { email: QA_EMAIL });\nif (!customerId) {\n console.error(`Customer not found: ${QA_EMAIL}`);\n Deno.exit(1);\n}\n\nconst inputs: MetafieldInput[] = [\n {\n ownerId: customerId,\n namespace: NAMESPACE,\n key: \"session_id\",\n type: \"single_line_text_field\",\n value: QA_SESSION.session_id,\n },\n {\n ownerId: customerId,\n namespace: NAMESPACE,\n key: \"scenario_id\",\n type: \"single_line_text_field\",\n value: QA_SESSION.scenario_id,\n },\n {\n ownerId: customerId,\n namespace: NAMESPACE,\n key: \"call_ts\",\n type: \"date_time\",\n value: QA_SESSION.call_ts,\n },\n ...Object.entries(QA_VARS).map(\n ([key, value]): MetafieldInput => ({\n ownerId: customerId,\n namespace: NAMESPACE,\n key,\n type: TYPE_MAP[key] ?? \"single_line_text_field\",\n value,\n }),\n ),\n];\n\nconsole.log(`Writing ${inputs.length} metafields …`);\nconst result = await setMetafields(cfg, inputs);\n\nif (result.userErrors.length) {\n console.error(\"Write errors:\", result.userErrors.map((e) => e.message).join(\"; \"));\n Deno.exit(1);\n}\nconsole.log(`✅ Written: ${result.metafields.map((m) => m.key).join(\", \")}`);\n\n// -----------------------------------------------------------------------------\n// verify\n// -----------------------------------------------------------------------------\n\nconsole.log(`\\nReading back ${NAMESPACE}.* …`);\nconst written = await readMetafields(cfg, customerId, NAMESPACE);\n\nconst expected: Record = {\n ...QA_SESSION,\n ...QA_VARS,\n};\n\nlet allOk = true;\nconst colW = Math.max(...written.map((m) => m.key.length), 10);\nconsole.log(`\\n${\"KEY\".padEnd(colW)} ${\"EXPECTED\".padEnd(35)} ${\"ACTUAL\".padEnd(35)} MATCH`);\nconsole.log(\"─\".repeat(colW + 80));\n\nfor (const m of written) {\n const raw = expected[m.key];\n if (raw === undefined) continue;\n const exp = normaliseValue(m.key, raw);\n const match = exp === m.value ? \"✅\" : \"❌\";\n if (match === \"❌\") allOk = false;\n console.log(\n `${m.key.padEnd(colW)} ${exp.slice(0, 34).padEnd(35)} ${m.value.slice(0, 34).padEnd(35)} ${match}`,\n );\n}\n\nconsole.log(`\\n${allOk ? \"All fields match ✅\" : \"Mismatches found ❌\"}`);\nif (!allOk) Deno.exit(1);\n",[],[188,308],"7ffe2d99-4cf1-45fd-b1ba-206503450c69",["D",1781524155519],[],[188,33],"04750411-558b-43ab-9a32-dc572983a4f5","get-customer-info.ts","a0e38a86-68a5-11f1-a4b4-1607ee4eb77e",446,["D",1781521359868],"#!/usr/bin/env -S deno run --allow-env --allow-net --allow-read\n// get-customer-info.ts — Fetch full customer profile + metafields from Shopify.\n//\n// Usage (from exp/vals/uAgents/):\n// deno task get-customer-info mayank.raj.unofficial@gmail.com\n// deno task get-customer-info mayank.raj.unofficial@gmail.com ttai_call\n// deno task get-customer-info --c jjs mayank.raj.unofficial@gmail.com\n//\n// Reads .env from cwd. Copy .env.sample → .env and fill in credentials.\n\nimport { bootstrap } from \"./_common.ts\";\nimport {\n resolveCustomer,\n listAbandonedCheckouts,\n} from \"../backend/integrations/shopify/snapshot.ts\";\nimport { readMetafields } from \"../backend/integrations/shopify/metafields.ts\";\n\n// -----------------------------------------------------------------------------\n// bootstrap\n// -----------------------------------------------------------------------------\n\nconst { cfg, customer, args } = await bootstrap();\n\nconst [email, namespace] = args;\nif (!email) {\n console.error(\"Usage: deno task get-customer-info [--c ttai|jjs] [namespace]\");\n Deno.exit(1);\n}\n\nconsole.log(`[${customer}] Looking up ${email} …\\n`);\n\n// -----------------------------------------------------------------------------\n// fetch\n// -----------------------------------------------------------------------------\n\nconst resolved = await resolveCustomer(cfg, { email }).catch((err: unknown) => {\n console.error(\"Customer lookup failed:\", err instanceof Error ? err.message : err);\n Deno.exit(1);\n});\n\nif (!resolved) {\n console.log(`No customer found for: ${email}`);\n Deno.exit(0);\n}\n\nconst { customer: cust, orders } = resolved;\n\nconst [abandoned, metafields] = await Promise.all([\n listAbandonedCheckouts(cfg, { email: cust.email ?? email, customer_id: cust.id }),\n readMetafields(cfg, cust.id, namespace),\n]);\n\n// -----------------------------------------------------------------------------\n// output\n// -----------------------------------------------------------------------------\n\nconsole.log(\"── Customer ────────────────────────────────────────────────\");\nconsole.log(` ID: ${cust.id}`);\nconsole.log(` Name: ${cust.display_name}`);\nconsole.log(` Email: ${cust.email ?? \"—\"}`);\nconsole.log(` Phone: ${cust.phone ?? \"—\"}`);\nconsole.log(` Orders: ${cust.orders_count}`);\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}\n\nif (abandoned.length) {\n console.log(\"\\n── Abandoned Checkouts ─────────────────────────────────────\");\n for (const ac of abandoned) {\n const total = ac.total_price ? ` ₹${ac.total_price}` : \"\";\n console.log(` ${ac.created_at.slice(0, 10)}${total}`);\n for (const li of ac.line_items) console.log(` • ${li.title} × ${li.quantity}`);\n }\n}\n\nconsole.log(\n \"\\n── Metafields\" +\n (namespace ? ` (${namespace})` : \" (all)\") +\n \" ─────────────────────────────────────\",\n);\nif (!metafields.length) {\n console.log(\" (none)\");\n} else {\n const colW = Math.max(...metafields.map((m) => `${m.namespace}.${m.key}`.length), 10);\n for (const m of metafields) {\n const key = `${m.namespace}.${m.key}`.padEnd(colW);\n const val = m.value.length > 80 ? m.value.slice(0, 77) + \"…\" : m.value;\n console.log(` ${key} ${val}`);\n }\n}\n\nconsole.log();\n",[],[188,320],"8ec7026c-648a-4b29-84bb-f524c9569787","delete-metafields.ts","a0f28f54-68a5-11f1-b802-1607ee4eb77e",448,["D",1781521360095],"#!/usr/bin/env -S deno run --allow-env --allow-net --allow-read\n// delete-metafields.ts — Delete ALL metafields for Mayank's customer record.\n// Reads current metafields (with their GIDs), bulk-deletes them, then verifies.\n//\n// Usage (from exp/vals/uAgents/):\n// deno task delete-metafields\n// deno task delete-metafields --c jjs\n\nimport { bootstrap } from \"./_common.ts\";\nimport { resolveCustomerGid } from \"../backend/integrations/shopify/snapshot.ts\";\nimport { adminGql } from \"../backend/integrations/shopify/client.ts\";\n\nconst { cfg, customer } = await bootstrap();\n\nconst QA_EMAIL = \"mayank.raj.unofficial@gmail.com\";\n\n// queries + mutation -----------------------------------------------------------\n\nconst FETCH_QUERY = `\nquery($id: ID!) {\n customer(id: $id) {\n metafields(first: 50) {\n edges { node { id namespace key } }\n }\n }\n}`;\n\nconst DELETE_MUTATION = `\nmutation MetafieldsDelete($metafields: [MetafieldIdentifierInput!]!) {\n metafieldsDelete(metafields: $metafields) {\n deletedMetafields { key namespace }\n userErrors { message }\n }\n}`;\n\n// run -------------------------------------------------------------------------\n\nconsole.log(`[${customer}] Deleting metafields for ${QA_EMAIL} …\\n`);\n\nconst customerId = await resolveCustomerGid(cfg, { email: QA_EMAIL });\nif (!customerId) {\n console.error(`Customer not found: ${QA_EMAIL}`);\n Deno.exit(1);\n}\n\nconst fetched = await adminGql<{\n customer: { metafields: { edges: { node: { id: string; namespace: string; key: string } }[] } };\n}>(cfg, FETCH_QUERY, { id: customerId });\n\nconst nodes = fetched.customer.metafields.edges.map((e) => e.node);\n\nif (!nodes.length) {\n console.log(\"No metafields to delete.\");\n Deno.exit(0);\n}\n\nconsole.log(`Deleting ${nodes.length} metafield(s):`);\nfor (const n of nodes) console.log(` ${n.namespace}.${n.key} (${n.id})`);\n\nconst ids = nodes.map((n) => ({ namespace: n.namespace, key: n.key, ownerId: customerId }));\nconst result = await adminGql<{\n metafieldsDelete: { deletedMetafields: { key: string }[]; userErrors: { message: string }[] };\n}>(cfg, DELETE_MUTATION, { metafields: ids });\n\nif (result.metafieldsDelete.userErrors.length) {\n console.error(\"Errors:\", result.metafieldsDelete.userErrors.map((e) => e.message).join(\"; \"));\n Deno.exit(1);\n}\n\nconsole.log(`✅ Deleted ${result.metafieldsDelete.deletedMetafields.length} metafield(s).`);\n\n// verify\nconst check = await adminGql<{\n customer: { metafields: { edges: unknown[] } };\n}>(cfg, FETCH_QUERY, { id: customerId });\n\nconst remaining = check.customer.metafields.edges.length;\nconsole.log(\n remaining === 0\n ? \"\\nAll clear ✅ — no metafields remaining.\"\n : `\\n⚠️ ${remaining} metafield(s) still present.`,\n);\n",[],[188,328],"d4170c71-3004-48b6-b765-df16fe008879","_common.ts","b9a49a52-68a9-11f1-bf28-1607ee4eb77e",443,["D",1781521359842],"// _common.ts — Shared bootstrap for local QA scripts.\n// Parses --c (default: ttai) and loads .env from cwd.\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 { shopifyConfig, type ShopifyConfig } from \"../backend/integrations/shopify/config.ts\";\nimport type { ShopifySecrets } from \"../backend/core/app.ts\";\n\nconst CUSTOMERS: Record ShopifySecrets> = {\n ttai: ttaiSecrets,\n jjs: jjsSecrets,\n};\n\nexport interface ScriptCtx {\n cfg: ShopifyConfig;\n customer: string;\n args: string[];\n}\n\n/** Parse --c flag, load .env, and return a ready-to-use ShopifyConfig.\n * Remaining positional args are returned in `args`. */\nexport async function bootstrap(): Promise {\n await load({ export: true });\n\n const parsed = parseArgs(Deno.args, {\n string: [\"c\"],\n default: { c: \"ttai\" },\n });\n\n const customer = parsed.c as string;\n const resolver = CUSTOMERS[customer];\n if (!resolver) {\n console.error(`Unknown customer: ${customer}. Valid: ${Object.keys(CUSTOMERS).join(\", \")}`);\n Deno.exit(1);\n }\n\n const cfg = shopifyConfig(resolver());\n return { cfg, customer, args: parsed._.map(String) };\n}\n",[],[188,336],["D",1781519599541],[277,278,279,280,281],[188],"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",[],[195,347],"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 · v455