[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_1228":1229,"_1230":1231},"routes/_app.x.$handle.$name",{"_101":100,"_32":46,"_110":91,"_27":54,"_13":14,"_111":-5,"_11":112,"_113":114,"_115":116,"_117":118,"_119":120,"_20":-5,"_121":-5,"_122":-5,"_123":25,"_124":125,"_126":60,"_127":-5,"_128":-5,"_129":130},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_44":45,"_32":46,"_39":47,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":-5,"_18":56,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":70,"_71":72,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":84,"_85":86,"_87":88,"_89":25},"version",667,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":35,"_36":38,"_39":40,"_41":14,"_42":43,"_24":25},"previous",{"_30":31,"_32":33,"_34":35,"_36":37},"deleted",false,"deletedHere","path","backend/agents/shopify-draft-agent.ts","latestPath","fileId","4e7e33c6-7639-11f1-92b1-1607ee4eb77e","name","shopify-draft-agent.ts","fileType","script","content","// shopify-draft-agent.ts — Focused draft-order agent. Operates on ONE draft order per\n// call: read it, resolve variant IDs via catalog search when adding new items, update\n// line items, and complete it as a COD order. No customer lookup, no cart tools, no\n// policy search — a tight, deterministic subset of the general shopify-mcp-agent.\n//\n// Caller: prompt (required), draft_order_id (required), draft_order_context (optional\n// pre-fetched snapshot that lets the agent skip the initial get_draft_order).\n\nimport { MultiServerMCPClient } from \"npm:@langchain/mcp-adapters@^1.1\";\nimport type { StructuredToolInterface } from \"npm:@langchain/core@^1.1.48/tools\";\nimport { ApiError } from \"../core/api.ts\";\nimport type { ShopifySecrets } from \"../core/app.ts\";\nimport { shopifyConfig } from \"../integrations/shopify/config.ts\";\nimport { shopifyDraftTools } from \"./shopify-draft-tools.ts\";\nimport { runToolLoop, toolLoopData } from \"../agentic-core/tool-loop.ts\";\nimport { compact, str, withContext } from \"../agentic-core/prompt.ts\";\nimport type { Agent, AgentCtx, AgentRunOutput } from \"../agentic-core/types.ts\";\n\n// UCP agent profile required by Shopify for every search_catalog call.\n// Injected automatically via beforeToolCall — the model never sees it.\nconst UCP_AGENT_PROFILE =\n \"https://shopify.dev/ucp/agent-profiles/examples/2026-04-08/valid-with-capabilities.json\";\n\n// Catalog-only subset of the Storefront MCP tools. Cart and policy tools are dropped.\nconst CATALOG_TOOLS = new Set([\"search_catalog\", \"get_product_details\", \"get_product\"]);\n\n// NOTE: newlines preserved intentionally — structured prompts outperform walls of text.\nconst SYSTEM_PROMPT = `\nYou operate ONE Shopify draft order per call. draft_order_id is always in context —\npass it to every draft tool call. Keep every reply short and plain.\n\nIf draft_order_context is provided, treat it as the current state of the draft (items,\nquantities, prices, total). Do NOT call get_draft_order at the start — answer view/confirm\nrequests and report totals directly from it.\n\nTOOLS:\n• get_draft_order(draft_order_id)\n → current line items (each with line_id), total, status. OPTIONAL, not a required first\n step. Call it only when you (a) need a line_id to change or remove an existing line,\n (b) want to re-confirm the exact state after a change, or (c) are unsure/confused.\n• search_catalog(query)\n → find a product_variant_id when ADDING a new item; returns variants with id, title, price.\n• get_product_details(product_id, options?)\n → fallback when search_catalog does not surface the exact variant. Optional; rarely needed.\n• update_draft_order(draft_order_id, add_items?, update_items?, remove_line_ids?, discount?)\n → add_items=[{variant_id, quantity}]; update_items=[{line_id, quantity}] (0 removes);\n remove_line_ids=[line_id]; discount={value, type: \"percentage\"|\"fixed\", title?}.\n Returns updated line items, discount, and total.\n• complete_draft_order(draft_order_id)\n → finalize as a real order. ONLY after the customer confirms. Returns order_name (#1001).\n\nWORKFLOWS:\n1. VIEW → get_draft_order.\n2. ADD NEW ITEM → search_catalog(query) → take variant_id → update_draft_order(add_items).\n3. SET / CHANGE / REMOVE → get_draft_order (take line_id) →\n update_draft_order(update_items or remove_line_ids). No catalog search.\n4. APPLY DISCOUNT → update_draft_order(discount). \"10 percent off\" = {value: 10,\n type: \"percentage\"}; \"₹50 off\" = {value: 50, type: \"fixed\"}. No get_draft_order\n needed first. The draft holds ONE order-level discount — a new one replaces it.\n Never invent a discount the caller did not ask for.\n5. PLACE ORDER → complete_draft_order.\n\nSET vs ADD (read carefully — this is the #1 source of mistakes):\n• \"set/make/change/keep X to/at N\", \"X should be N\", \"reduce/increase X to N\" = SET the\n EXISTING line's quantity to exactly N → get_draft_order for its line_id → update_items.\n• Use add_items ONLY when the customer wants a NEW item or MORE of one — \"add\", \"one more\",\n \"also\", \"another\". add_items MERGES onto the current quantity, so never use it to set a value.\n\nRULES:\n• variant_id and line_id come ONLY from tool responses — never fabricate an ID.\n• complete_draft_order takes ONLY draft_order_id. Completion uses the store's default\n gateway (COD) — never pass or invent a payment gateway id.\n• After every mutation, re-state the new line items, subtotal, delivery charge, and final\n total (per SHIPPING & TOTALS) from the tool response.\n• If search_catalog returns no match, retry ONCE with a simpler query: drop trailing words\n like \"pickle\"/\"achaar\"/\"aachar\" and brand/size/qualifier words, and search the core name\n (e.g. \"Lal Mirch Bharua pickle\" → \"Lal Mirch Bharua\" → \"Lal Mirch\"). If still nothing,\n treat only that item as not found — do not invent a variant.\n• Apply each requested change INDEPENDENTLY. If one part fails (e.g. a product is not found),\n still apply the parts that succeed, then report both. Never drop a valid change because a\n different part failed. Stop only on a hard tool error (draft update/complete failure).\n• NEVER output raw GIDs, JSON, or checkout URLs. Speak in short sentences.\n\nSHIPPING & TOTALS (tool totals are ITEMS-ONLY — always add shipping yourself):\n• Delivery charge: ₹65 when the items subtotal is under ₹750. FREE when subtotal ≥ ₹750.\n Judge the ₹750 threshold on the items subtotal BEFORE any discount.\n• Totals returned by tools AND in draft_order_context are the ITEMS subtotal only — they\n never include shipping. When a discount is on the draft, the tool total is ALREADY net of\n that discount. Compute the final total yourself: (discounted) subtotal + delivery charge.\n• If a change moves the subtotal across the ₹750 boundary, say so explicitly\n (e.g. \"crossed ₹750 — delivery is now free\" or \"dropped below ₹750 — ₹65 delivery applies\").\n\nFINAL ANSWER FORMAT (always end with this):\nStatus: success | partial | failed (partial = some changes applied, some did not)\nItems: , ...\nSubtotal: \nDiscount: none | % | ₹ (from the tool response)\nDelivery: ₹65 | FREE (subtotal ≥ ₹750)\nTotal: \nAction: \n`.trim();\n\nconst DESCRIPTION = compact(`\nDraft-order operator for a Shopify store. Reads a draft order, adds/removes/updates line items\n(resolving variant IDs via catalog search), and completes it as a COD order. Requires\ndraft_order_id plus a natural-language prompt. Does not look up customers or touch carts.\n`);\n\nconst MODEL = \"gpt-5.4-mini\";\nconst MAX_ROUNDS = 8;\n\nexport const shopifyDraftAgent: Agent = {\n name: \"shopify-draft-agent\",\n label: \"Shopify draft agent\",\n description: DESCRIPTION,\n\n async run(ctx: AgentCtx): Promise {\n const prompt = str(ctx.input.prompt);\n if (!prompt) throw new ApiError(\"`prompt` is required\", 400);\n const draftOrderId = str(ctx.input.draft_order_id);\n if (!draftOrderId) throw new ApiError(\"`draft_order_id` is required\", 400);\n const draftContext = str(ctx.input.draft_order_context);\n\n const cfg = shopifyConfig(ctx.secrets);\n const draftTools = shopifyDraftTools(cfg);\n const catalogTools = await loadCatalogTools(cfg.shop);\n\n const result = await runToolLoop({\n model: MODEL,\n system: SYSTEM_PROMPT,\n human: withContext(prompt, {\n draft_order_id: draftOrderId,\n draft_order_context: draftContext,\n }),\n tools: [...draftTools, ...catalogTools],\n maxRounds: MAX_ROUNDS,\n });\n\n return { model: MODEL, data: toolLoopData(result) };\n },\n};\n\n// tools -------------------------------------------------------------------\n\n/** Load the catalog-only subset of Storefront MCP tools from the shop's /api/mcp endpoint.\n * beforeToolCall injects the UCP agent profile for search_catalog. */\nasync function loadCatalogTools(shop: string): Promise {\n const tools = (await buildClient(shop).getTools()) as StructuredToolInterface[];\n return tools.filter((t) => CATALOG_TOOLS.has(t.name));\n}\n\nfunction buildClient(shop: string): MultiServerMCPClient {\n return new MultiServerMCPClient({\n mcpServers: {\n storefront: { transport: \"http\", url: `https://${shop}/api/mcp` },\n },\n beforeToolCall: (req) => {\n if (req.name !== \"search_catalog\") return {};\n return {\n args: {\n ...(req.args as Record),\n meta: { \"ucp-agent\": { profile: UCP_AGENT_PROFILE } },\n },\n };\n },\n });\n}\n","// shopify-draft-agent.ts — Focused draft-order agent. Operates on ONE draft order per\n// call: read it, resolve variant IDs via catalog search when adding new items, update\n// line items, and complete it as a COD order. No customer lookup, no cart tools, no\n// policy search — a tight, deterministic subset of the general shopify-mcp-agent.\n//\n// Caller: prompt (required), draft_order_id (required), draft_order_context (optional\n// pre-fetched snapshot that lets the agent skip the initial get_draft_order).\n\nimport { MultiServerMCPClient } from \"npm:@langchain/mcp-adapters@1.1.4\";\nimport type { StructuredToolInterface } from \"npm:@langchain/core@^1.1.48/tools\";\nimport { ApiError } from \"../core/api.ts\";\nimport type { ShopifySecrets } from \"../core/app.ts\";\nimport { shopifyConfig } from \"../integrations/shopify/config.ts\";\nimport { shopifyDraftTools } from \"./shopify-draft-tools.ts\";\nimport { runToolLoop, toolLoopData } from \"../agentic-core/tool-loop.ts\";\nimport { compact, str, withContext } from \"../agentic-core/prompt.ts\";\nimport type { Agent, AgentCtx, AgentRunOutput } from \"../agentic-core/types.ts\";\n\n// UCP agent profile required by Shopify for every search_catalog call.\n// Injected automatically via beforeToolCall — the model never sees it.\nconst UCP_AGENT_PROFILE =\n \"https://shopify.dev/ucp/agent-profiles/examples/2026-04-08/valid-with-capabilities.json\";\n\n// Catalog-only subset of the Storefront MCP tools. Cart and policy tools are dropped.\nconst CATALOG_TOOLS = new Set([\"search_catalog\", \"get_product_details\", \"get_product\"]);\n\n// NOTE: newlines preserved intentionally — structured prompts outperform walls of text.\nconst SYSTEM_PROMPT = `\nYou operate ONE Shopify draft order per call. draft_order_id is always in context —\npass it to every draft tool call. Keep every reply short and plain.\n\nIf draft_order_context is provided, treat it as the current state of the draft (items,\nquantities, prices, total). Do NOT call get_draft_order at the start — answer view/confirm\nrequests and report totals directly from it.\n\nTOOLS:\n• get_draft_order(draft_order_id)\n → current line items (each with line_id), total, status. OPTIONAL, not a required first\n step. Call it only when you (a) need a line_id to change or remove an existing line,\n (b) want to re-confirm the exact state after a change, or (c) are unsure/confused.\n• search_catalog(query)\n → find a product_variant_id when ADDING a new item; returns variants with id, title, price.\n• get_product_details(product_id, options?)\n → fallback when search_catalog does not surface the exact variant. Optional; rarely needed.\n• update_draft_order(draft_order_id, add_items?, update_items?, remove_line_ids?, discount?)\n → add_items=[{variant_id, quantity}]; update_items=[{line_id, quantity}] (0 removes);\n remove_line_ids=[line_id]; discount={value, type: \"percentage\"|\"fixed\", title?}.\n Returns updated line items, discount, and total.\n• complete_draft_order(draft_order_id)\n → finalize as a real order. ONLY after the customer confirms. Returns order_name (#1001).\n\nWORKFLOWS:\n1. VIEW → get_draft_order.\n2. ADD NEW ITEM → search_catalog(query) → take variant_id → update_draft_order(add_items).\n3. SET / CHANGE / REMOVE → get_draft_order (take line_id) →\n update_draft_order(update_items or remove_line_ids). No catalog search.\n4. APPLY DISCOUNT → update_draft_order(discount). \"10 percent off\" = {value: 10,\n type: \"percentage\"}; \"₹50 off\" = {value: 50, type: \"fixed\"}. No get_draft_order\n needed first. The draft holds ONE order-level discount — a new one replaces it.\n Never invent a discount the caller did not ask for.\n5. PLACE ORDER → complete_draft_order.\n\nSET vs ADD (read carefully — this is the #1 source of mistakes):\n• \"set/make/change/keep X to/at N\", \"X should be N\", \"reduce/increase X to N\" = SET the\n EXISTING line's quantity to exactly N → get_draft_order for its line_id → update_items.\n• Use add_items ONLY when the customer wants a NEW item or MORE of one — \"add\", \"one more\",\n \"also\", \"another\". add_items MERGES onto the current quantity, so never use it to set a value.\n\nRULES:\n• variant_id and line_id come ONLY from tool responses — never fabricate an ID.\n• complete_draft_order takes ONLY draft_order_id. Completion uses the store's default\n gateway (COD) — never pass or invent a payment gateway id.\n• After every mutation, re-state the new line items, subtotal, delivery charge, and final\n total (per SHIPPING & TOTALS) from the tool response.\n• If search_catalog returns no match, retry ONCE with a simpler query: drop trailing words\n like \"pickle\"/\"achaar\"/\"aachar\" and brand/size/qualifier words, and search the core name\n (e.g. \"Lal Mirch Bharua pickle\" → \"Lal Mirch Bharua\" → \"Lal Mirch\"). If still nothing,\n treat only that item as not found — do not invent a variant.\n• Apply each requested change INDEPENDENTLY. If one part fails (e.g. a product is not found),\n still apply the parts that succeed, then report both. Never drop a valid change because a\n different part failed. Stop only on a hard tool error (draft update/complete failure).\n• NEVER output raw GIDs, JSON, or checkout URLs. Speak in short sentences.\n\nSHIPPING & TOTALS (tool totals are ITEMS-ONLY — always add shipping yourself):\n• Delivery charge: ₹65 when the items subtotal is under ₹750. FREE when subtotal ≥ ₹750.\n Judge the ₹750 threshold on the items subtotal BEFORE any discount.\n• Totals returned by tools AND in draft_order_context are the ITEMS subtotal only — they\n never include shipping. When a discount is on the draft, the tool total is ALREADY net of\n that discount. Compute the final total yourself: (discounted) subtotal + delivery charge.\n• If a change moves the subtotal across the ₹750 boundary, say so explicitly\n (e.g. \"crossed ₹750 — delivery is now free\" or \"dropped below ₹750 — ₹65 delivery applies\").\n\nFINAL ANSWER FORMAT (always end with this):\nStatus: success | partial | failed (partial = some changes applied, some did not)\nItems: , ...\nSubtotal: \nDiscount: none | % | ₹ (from the tool response)\nDelivery: ₹65 | FREE (subtotal ≥ ₹750)\nTotal: \nAction: \n`.trim();\n\nconst DESCRIPTION = compact(`\nDraft-order operator for a Shopify store. Reads a draft order, adds/removes/updates line items\n(resolving variant IDs via catalog search), and completes it as a COD order. Requires\ndraft_order_id plus a natural-language prompt. Does not look up customers or touch carts.\n`);\n\nconst MODEL = \"gpt-5.4-mini\";\nconst MAX_ROUNDS = 8;\n\nexport const shopifyDraftAgent: Agent = {\n name: \"shopify-draft-agent\",\n label: \"Shopify draft agent\",\n description: DESCRIPTION,\n\n async run(ctx: AgentCtx): Promise {\n const prompt = str(ctx.input.prompt);\n if (!prompt) throw new ApiError(\"`prompt` is required\", 400);\n const draftOrderId = str(ctx.input.draft_order_id);\n if (!draftOrderId) throw new ApiError(\"`draft_order_id` is required\", 400);\n const draftContext = str(ctx.input.draft_order_context);\n\n const cfg = shopifyConfig(ctx.secrets);\n const draftTools = shopifyDraftTools(cfg);\n const catalogTools = await loadCatalogTools(cfg.shop);\n\n const result = await runToolLoop({\n model: MODEL,\n system: SYSTEM_PROMPT,\n human: withContext(prompt, {\n draft_order_id: draftOrderId,\n draft_order_context: draftContext,\n }),\n tools: [...draftTools, ...catalogTools],\n maxRounds: MAX_ROUNDS,\n });\n\n return { model: MODEL, data: toolLoopData(result) };\n },\n};\n\n// tools -------------------------------------------------------------------\n\n/** Load the catalog-only subset of Storefront MCP tools from the shop's /api/mcp endpoint.\n * beforeToolCall injects the UCP agent profile for search_catalog. */\nasync function loadCatalogTools(shop: string): Promise {\n const tools = (await buildClient(shop).getTools()) as StructuredToolInterface[];\n return tools.filter((t) => CATALOG_TOOLS.has(t.name));\n}\n\nfunction buildClient(shop: string): MultiServerMCPClient {\n return new MultiServerMCPClient({\n mcpServers: {\n storefront: { transport: \"http\", url: `https://${shop}/api/mcp` },\n },\n beforeToolCall: (req) => {\n if (req.name !== \"search_catalog\") return {};\n return {\n args: {\n ...(req.args as Record),\n meta: { \"ucp-agent\": { profile: UCP_AGENT_PROFILE } },\n },\n };\n },\n });\n}\n","createdAt",["D",1788891210392],"branchVersion","branchId","b9c38076-09b5-49a6-8d65-4b509f9cce50","id","30ca1bfe-8d0b-41cd-af05-40f09f5a31a1","uAgents",["D",1780696391552],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","","imageUrl","279c3e70-f2b8-11ef-a073-37253b8bcbda","pinnedFileId","f3dc8b86-6128-11f1-854e-1607ee4eb77e","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","019e994f-fcc4-73e9-86ed-2d14fe9f5dfa","tursoName","30ca1bfe8d0b41cdaf0540f09f5a31a1","tursoHostname","30ca1bfe8d0b41cdaf0540f09f5a31a1-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789531852468],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_101":100,"_109":105},"org",{"_101":100,"_102":103,"_104":105,"_18":-5,"_106":107,"_108":25},"branch",{"_13":90,"_32":91,"_44":43,"_92":45,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":46,"_99":100},"isOwned",679,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","ttai","handle","displayName","Tough Tongue AI","avatar","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/4b8edab4-7879-48e2-f777-109aa5256800/square512?exp=1789577999&sig=7dd62f7e99ff2dd0079169582aecea7ebc57a30a6de3c1528aff9d9adf538052","tier","free","canRestrictVals","profileImageUrl","branchName","adoptOrgId",{"_44":45,"_32":46,"_39":1223,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":-5,"_18":56,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":70,"_71":1224,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":1225,"_85":1226,"_87":1227,"_89":25},"tree",[243,327,342,352,353,354,355,356,357,358,359,360],"files",[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,324,325,326,327,328,329,330,331,332,333,334,335,336,337,338,339,340,341,342,343,344,345,346,347,348,349,350,351,352,353,354,355,356,357,358,359,360],"counts",{"_233":64,"_234":199,"_235":64,"_236":237,"_238":239},"contents",[131,132,133,134,135,136,137,138,139,140,141,142],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_44":228,"_32":229,"_30":230,"_146":-5,"_42":43,"_41":191,"_148":60,"_39":231,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_27":232},{"_44":223,"_32":224,"_30":225,"_146":-5,"_42":43,"_41":199,"_148":60,"_39":226,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_27":227},{"_44":216,"_32":217,"_30":218,"_146":-5,"_42":43,"_41":219,"_148":60,"_39":220,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_27":222},{"_44":209,"_32":210,"_30":211,"_146":-5,"_42":43,"_41":212,"_148":60,"_39":213,"_13":64,"_34":20,"_36":214,"_24":25,"_151":-5,"_27":215},{"_44":202,"_32":203,"_30":204,"_146":-5,"_42":43,"_41":205,"_148":60,"_39":206,"_13":64,"_34":20,"_36":207,"_24":25,"_151":-5,"_27":208},{"_44":194,"_32":195,"_30":196,"_146":-5,"_42":43,"_41":197,"_148":60,"_39":198,"_13":199,"_34":20,"_36":200,"_24":25,"_151":-5,"_27":201},{"_44":186,"_32":187,"_30":188,"_146":-5,"_42":43,"_41":189,"_148":60,"_39":190,"_13":191,"_34":20,"_36":192,"_24":25,"_151":-5,"_27":193},{"_44":178,"_32":179,"_30":180,"_146":-5,"_42":43,"_41":181,"_148":60,"_39":182,"_13":183,"_34":20,"_36":184,"_24":25,"_151":-5,"_27":185},{"_44":170,"_32":171,"_30":172,"_146":-5,"_42":43,"_41":173,"_148":60,"_39":174,"_13":175,"_34":20,"_36":176,"_24":25,"_151":-5,"_27":177},{"_44":161,"_32":162,"_30":58,"_146":-5,"_42":43,"_41":163,"_148":60,"_39":164,"_13":165,"_34":166,"_36":167,"_24":25,"_151":168,"_27":169},{"_44":153,"_32":154,"_30":155,"_146":-5,"_42":43,"_41":156,"_148":60,"_39":157,"_13":158,"_34":20,"_36":159,"_24":25,"_151":-5,"_27":160},{"_44":143,"_32":144,"_30":145,"_146":-5,"_42":43,"_41":147,"_148":60,"_39":149,"_13":64,"_34":20,"_36":150,"_24":25,"_151":-5,"_27":152},"1150c7c0-45dd-4fa3-b920-cdbb58c86b72","valtown-platform-reference.md","56ea040a-aa6d-11f1-8fec-1607ee4eb77e","parentId",637,"latest",["D",1788752201112],"# Val Town Platform Reference\n\n> Preserved vendor-platform reference for uAgents. Follow `AGENTS.md` and `../AGENTS.md` when a local convention differs.\n\n## Core Guidelines\n\n- Ask clarifying questions when requirements are ambiguous.\n- Provide complete, functional solutions rather than skeleton implementations.\n- Test logic against edge cases before presenting it.\n- Follow Val Town platform requirements.\n- Refactor into subcomponents when a section becomes too complex.\n\n## Code Standards\n\n- Generate TypeScript or TSX.\n- Add types and interfaces for data structures.\n- Prefer official SDKs or libraries over direct API calls.\n- Ask for API or library documentation when it is needed to resolve uncertainty.\n- Never put secrets in code; use environment variables.\n- Comment complex logic, not obvious operations.\n- Prefer modern ES6+ and functional patterns where suitable.\n\n## Trigger Types\n\n### HTTP Trigger\n\nCreate web APIs and endpoints. HTTP-trigger files contain `http` in their name.\n\n```ts\nexport default async function (req: Request) {\n return new Response(\"Hello World\");\n}\n```\n\n### Cron Trigger\n\nRun scheduled work. Cron-trigger files contain `cron` in their name.\n\n```ts\nexport default async function () {\n // Scheduled task code\n}\n```\n\n### Email Trigger\n\nProcess incoming emails. Email-trigger files contain `email` in their name.\n\n```ts\nexport default async function (email: Email) {\n // Process email\n}\n```\n\n## Val Town Standard Libraries\n\n### Blob Storage\n\n```ts\nimport { blob } from \"https://esm.town/v/std/blob\";\n\nawait blob.setJSON(\"myKey\", { hello: \"world\" });\nconst value = await blob.getJSON(\"myKey\");\nconst keys = await blob.list(\"app_\");\nawait blob.delete(\"myKey\");\n```\n\n### SQLite\n\n```ts\nimport { sqlite } from \"https://esm.town/v/stevekrouse/sqlite\";\n\nconst tableName = \"todo_app_users_2\";\nawait sqlite.execute(`CREATE TABLE IF NOT EXISTS ${tableName} (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n name TEXT NOT NULL\n)`);\nconst result = await sqlite.execute(`SELECT * FROM ${tableName} WHERE id = ?`, [1]);\n```\n\nChange the table name when a schema changes to create a fresh table. Run creation before querying.\n\n### OpenAI\n\n```ts\nimport { OpenAI } from \"https://esm.town/v/std/openai\";\n\nconst openai = new OpenAI();\nconst completion = await openai.chat.completions.create({\n messages: [{ role: \"user\", content: \"Say hello in a creative way\" }],\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\nawait email({\n subject: \"Hi\",\n text: \"Hi\",\n html: \"

Hi

\",\n});\n```\n\n## Utility Imports\n\nPin utility imports to a version:\n\n```ts\nimport { parseProject, readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n```\n\n### `serveFile`\n\n```ts\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`\n\n```ts\nconst fileContent = await readFile(\"/frontend/index.html\", import.meta.url);\n```\n\n### `listFiles`\n\n```ts\nconst files = await listFiles(import.meta.url);\n```\n\n### `parseProject`\n\n```ts\nconst projectVal = parseProject(import.meta.url);\nconsole.log(projectVal.username);\nconsole.log(projectVal.name);\nconsole.log(projectVal.version);\nconsole.log(projectVal.branch);\nconsole.log(projectVal.links.self.project);\n```\n\n`parseProject` and the other standard-library utilities run only on the server. Pass needed data to\nthe client through HTML or an API request.\n\n## Platform Specifics\n\n- Redirect with `new Response(null, { status: 302, headers: { Location: \"/place/to/redirect\" }})` rather than `Response.redirect`.\n- Avoid external or base64 images. Prefer emoji, Unicode, icon libraries, or platform-supported image generation.\n- Use `

` for inline AI images.\n- Do not use Deno KV for storage.\n- Do not use browser `alert()`, `prompt()`, or `confirm()`.\n- Use Open-Meteo for weather unless the task says otherwise.\n- Add a view-source link from `import.meta.url.replace(\"ems.sh\", \"val.town\")` with `target=\"_top\"`.\n- Add `` to capture client errors.\n- Use `try`/`catch` only with a clear local resolution; let contextual errors bubble.\n- Read environment variables with `Deno.env.get(\"KEY\")`; prefer APIs that avoid keys when possible.\n- Use `https://esm.sh` for npm and Deno dependencies that must work on server and browser.\n- Prefer static client-side sites unless backend storage is explicitly required.\n\n## React and Styling\n\nWhen React is needed, pin matching versions and put this first in the file:\n\n```ts\n/** @jsxImportSource https://esm.sh/react@18.2.0 */\n```\n\nPin React and its dependencies consistently. The generic platform default is Tailwind through\n``; uAgents instead follows the local\nbeer.css conventions in `../AGENTS.md`.\n\n## Recommended Structure\n\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts\n│ │ ├── queries.ts\n│ │ └── README.md\n│ ├── routes/\n│ │ ├── [route].ts\n│ │ └── static.ts\n│ └── index.ts\n├── frontend/\n│ ├── components/\n│ │ ├── App.tsx\n│ │ └── [Component].tsx\n│ ├── favicon.svg\n│ ├── index.html\n│ ├── index.tsx\n│ ├── README.md\n│ └── style.css\n├── README.md\n└── shared/\n └── utils.ts\n```\n\n## Backend (Hono) Patterns\n\n- Use Hono for APIs.\n- Keep the entry point at `backend/index.ts`.\n- Serve static assets with `serveFile`.\n- Create RESTful CRUD routes.\n- Re-throw Hono errors to retain original error detail:\n\n```ts\napp.onError((err, c) => {\n throw err;\n});\n```\n\nFor an HTML entry point that needs initial server data, read the file, fetch the data, inject a\nserialized script before ``, and return `c.html(html)`.\n\n## Database Patterns\n\n- Run migrations on startup or comment them out when performance requires it.\n- Change table names instead of altering existing SQLite tables.\n- Export clear, typed query functions.\n\n## Common Gotchas\n\n1. Val Town runs Deno serverlessly, not Node.js.\n2. Code in `shared/` must work in browser and server contexts; do not use `Deno` there.\n3. Use `https://esm.sh` imports that work in both contexts.\n4. SQLite has limited `ALTER TABLE` support; create a new table and copy data for schema changes.\n5. Pin React to 18.2.0 consistently; mismatched versions cause rendering issues.\n6. Val Town supports text files only. Use `readFile` helpers to read project files across branches and forks.\n7. A `fetch` handler is the HTTP entry point: `export default app.fetch`.\n\n## Key Files\n\n- `AGENTS.md` — uAgents-local conventions and module map\n- `../AGENTS.md` — Val Town repository conventions\n- `README.md` — uAgents architecture and operating contracts\n","label",[144],"23efb6f3-0083-4d06-915b-e688f35160ca","val.yml","f3605d0e-6128-11f1-9354-1607ee4eb77e",651,["D",1788773355439],13,"# 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 booking SMS to\n FITELO_PAYMENT_WEBHOOK_URL: optional # Fitelo n8n ezweight payment-link webhook (payment_link_requested branch)\n FITELO_EZWEIGHT_PRODUCT_ID: optional # Fitelo POS productId for the EZWeight 999 first step\n CORESTACK_RESEND_API_KEY: optional # Resend API key for notify-qualified — same key as backend RESEND_API_KEY\n CORESTACK_NOTIFY_EMAILS: optional # Comma-separated sales-team recipients for the qualified-lead email\n CORESTACK_FROM_EMAIL: optional # Override from-address; defaults to \"Tough Tongue AI \"\n",[154],"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",[162],"fd314dfe-9e8a-4e72-9448-9c8d14a748ad","deno.json","f353dd04-6128-11f1-ac3a-1607ee4eb77e",610,["D",1785503537350],7,"{\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 \"resolve-incoming-caller\": \"deno run -A scripts/resolve-incoming-caller.ts\"\n }\n}\n",[171],"f5a034a1-6f82-4a71-8662-5a100b9e22e1","README.md","f3e9fe92-6128-11f1-b4a4-1607ee4eb77e",633,["D",1786181484238],26,"# 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 (8k-row + 14d retention)\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 ident-matching.ts shared email/phone matching helpers (used by snapshot.ts + context.ts)\n metafields.ts setMetafields(), readMetafields() — generic, no business logic\n tags.ts addTags(), removeTags() — generic resource tagging (split out of metafields.ts)\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). The log is a shared\n ring buffer: rows older than 14 days are deleted, and once past 8,000 rows the oldest 500 are\n dropped in a batch.\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 | Headers stripped; 2 KB detail / 8 KB body | Admin-only; drop >14d, then 8,000-row cap (prune 500) |\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",[179],"30ce2821-4fe4-4973-909d-41ce65b1d219","AGENTS.md","a5bb54c0-7571-11f1-b237-1607ee4eb77e",640,["D",1788752201431],2,"# uAgents — Local Guide\n\n> A single Val Town Hono app for authenticated customer functions and the beer.css admin UI. Read `../AGENTS.md` first; this file adds uAgents-only boundaries.\n\n## Start Here\n\n1. Read `README.md` for architecture, routes, auth, data retention, and environment contracts.\n2. Read `val.yml` before deployment or environment changes; it is the local metadata contract.\n3. Read `valtown-platform-reference.md` only for generic Val Town API and platform facts; this local guide wins on project conventions.\n4. Read the nearest module before editing: `backend/core/`, `backend/customers/`, `backend/agents/`, `backend/integrations/`, or `frontend/`.\n5. Keep `index.http.ts` as the only HTTP-trigger filename. Val Town infers trigger type from filenames.\n\n## Module Map\n\n```\nindex.http.ts\n├── backend/core/ app setup, auth, API errors, SQLite, admin handlers\n├── backend/customers/ customer definitions, route registration, function contracts\n├── backend/agentic-core/ shared agent runtime and tool loop\n├── backend/agents/ concrete agents and tool adapters\n├── backend/integrations/ customer-agnostic external-service clients\n├── frontend/ Preact admin UI and beer.css layers\n└── scripts/ local, real-service diagnostic helpers\n```\n\n## Change Boundaries\n\n| Change | Start with | Preserve |\n| --- | --- | --- |\n| Customer function | `backend/customers//` + `registry.ts` | Customer-scoped auth and explicit registration |\n| Agent behavior | `backend/agents/` + `agentic-core/` | Shared runtime owns LLM setup; agents stay declarative |\n| External integration | `backend/integrations//` | Typed per-customer secrets; visible 4xx/503 failures |\n| API/auth/admin | `backend/core/` | Hono middleware, constant-time key comparison, admin gate |\n| Admin UI | `frontend/` | beer.css tokens → base → components; no baked palette |\n\n## Non-Negotiables\n\n- Keep routing in Hono. Do not hand-roll path parsing.\n- Keep reusable integration logic customer-agnostic; customer modules own route registration and validation.\n- Read secrets only through the typed resolver in `backend/core/app.ts`; never put a value in source, logs, or responses.\n- Keep function request and response logging bounded and header-free; preserve retention limits.\n- Use Deno-native imports and the native `vt` CLI from this directory. Do not add Node build tooling.\n- Run `deno check --allow-import index.http.ts`, `deno lint`, and `deno fmt` before deployment.\n- Do not alter `.vt/` link state by hand.\n\n## Key Files\n\n- `README.md` — full architecture, API surface, auth, environment, and local scripts\n- `valtown-platform-reference.md` — preserved Val Town platform/API reference\n- `val.yml` — Val Town metadata, trigger declaration, and environment inventory\n- `index.http.ts` — only HTTP entry point\n- `backend/core/app.ts` — typed global and customer secret resolvers\n- `backend/customers/registry.ts` — registered customer applications\n- `backend/agentic-core/runtime.ts` — shared LLM runtime\n- `frontend/styles/index.ts` — composed admin UI stylesheet\n",[187],"5115440a-9447-4dc7-9012-dd40a4d49af6",".vtignore","a5c30cba-7571-11f1-ad5a-1607ee4eb77e",575,["D",1783058175024],1,".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor\n",[195],"c43a91fc-7768-445d-894c-09919e8212d3",".gitignore","a9258dc4-843a-11f1-b20a-1607ee4eb77e",603,["D",1784552289835],".env\nscripts/.env\n",[203],"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",[210],"ff7f2101-71a5-425e-a367-560ef13a2086","scripts","a06c5628-68a5-11f1-b189-1607ee4eb77e",416,["D",1781519599541],"directory",[217],"6d14e6de-c8d3-45e7-ba6f-2ed984a1f71b","frontend","f2b2b82a-6128-11f1-9496-1607ee4eb77e",["D",1780696392346],[224],"157d3e42-b14b-4a4a-b3d1-13e8c95b8213","backend","f2d380b4-6128-11f1-b4a4-1607ee4eb77e",["D",1780696392550],[229],"pulls","branches","forks","envVars",{"_240":199,"_242":64},"connections",{"_240":64,"_241":64},"count","unfilledCount","emptyCount",{"_44":228,"_32":229,"_30":230,"_146":-5,"_42":43,"_41":191,"_148":60,"_39":1220,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":1221,"_27":1222},{"_44":1215,"_32":1190,"_30":1184,"_146":230,"_42":43,"_41":1216,"_148":60,"_39":1217,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":1218,"_27":1219},{"_44":1207,"_32":1208,"_30":1209,"_146":1184,"_42":43,"_41":1210,"_148":60,"_39":1211,"_13":191,"_34":35,"_36":1212,"_24":25,"_151":-5,"_362":1213,"_27":1214},{"_44":1199,"_32":1200,"_30":1201,"_146":1184,"_42":43,"_41":1202,"_148":60,"_39":1203,"_13":665,"_34":35,"_36":1204,"_24":25,"_151":-5,"_362":1205,"_27":1206},{"_44":1191,"_32":1192,"_30":1193,"_146":1184,"_42":43,"_41":1194,"_148":60,"_39":1195,"_13":495,"_34":35,"_36":1196,"_24":25,"_151":-5,"_362":1197,"_27":1198},{"_44":1182,"_32":466,"_30":1183,"_146":1184,"_42":43,"_41":1185,"_148":60,"_39":1186,"_13":590,"_34":35,"_36":1187,"_24":25,"_151":-5,"_362":1188,"_27":1189},{"_44":1177,"_32":1068,"_30":1062,"_146":230,"_42":43,"_41":1178,"_148":60,"_39":1179,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":1180,"_27":1181},{"_44":1169,"_32":1170,"_30":1171,"_146":1062,"_42":43,"_41":1172,"_148":60,"_39":1173,"_13":191,"_34":35,"_36":1174,"_24":25,"_151":-5,"_362":1175,"_27":1176},{"_44":1161,"_32":1162,"_30":1163,"_146":1062,"_42":43,"_41":1164,"_148":60,"_39":1165,"_13":199,"_34":35,"_36":1166,"_24":25,"_151":-5,"_362":1167,"_27":1168},{"_44":1153,"_32":1154,"_30":1155,"_146":1062,"_42":43,"_41":1156,"_148":25,"_39":1157,"_13":64,"_34":35,"_36":1158,"_24":25,"_151":-5,"_362":1159,"_27":1160},{"_44":1145,"_32":1146,"_30":1147,"_146":1062,"_42":43,"_41":1148,"_148":25,"_39":1149,"_13":64,"_34":35,"_36":1150,"_24":25,"_151":-5,"_362":1151,"_27":1152},{"_44":1137,"_32":1138,"_30":1139,"_146":1062,"_42":43,"_41":1140,"_148":25,"_39":1141,"_13":64,"_34":35,"_36":1142,"_24":25,"_151":-5,"_362":1143,"_27":1144},{"_44":1129,"_32":1130,"_30":1131,"_146":1062,"_42":43,"_41":1132,"_148":25,"_39":1133,"_13":64,"_34":35,"_36":1134,"_24":25,"_151":-5,"_362":1135,"_27":1136},{"_44":1121,"_32":1122,"_30":1123,"_146":1062,"_42":43,"_41":1124,"_148":25,"_39":1125,"_13":64,"_34":35,"_36":1126,"_24":25,"_151":-5,"_362":1127,"_27":1128},{"_44":1113,"_32":1114,"_30":1115,"_146":1062,"_42":43,"_41":1116,"_148":25,"_39":1117,"_13":64,"_34":35,"_36":1118,"_24":25,"_151":-5,"_362":1119,"_27":1120},{"_44":1105,"_32":1106,"_30":1107,"_146":1062,"_42":43,"_41":1108,"_148":25,"_39":1109,"_13":64,"_34":35,"_36":1110,"_24":25,"_151":-5,"_362":1111,"_27":1112},{"_44":1097,"_32":1098,"_30":1099,"_146":1062,"_42":43,"_41":1100,"_148":25,"_39":1101,"_13":64,"_34":35,"_36":1102,"_24":25,"_151":-5,"_362":1103,"_27":1104},{"_44":1089,"_32":1090,"_30":1091,"_146":1062,"_42":43,"_41":1092,"_148":60,"_39":1093,"_13":665,"_34":35,"_36":1094,"_24":25,"_151":-5,"_362":1095,"_27":1096},{"_44":1081,"_32":1082,"_30":1083,"_146":1062,"_42":43,"_41":1084,"_148":60,"_39":1085,"_13":165,"_34":35,"_36":1086,"_24":25,"_151":-5,"_362":1087,"_27":1088},{"_44":1077,"_32":33,"_30":31,"_146":1062,"_42":43,"_41":14,"_148":60,"_39":1078,"_13":665,"_34":35,"_36":38,"_24":25,"_151":-5,"_362":1079,"_27":1080},{"_44":1069,"_32":1070,"_30":1071,"_146":1062,"_42":43,"_41":1072,"_148":60,"_39":1073,"_13":191,"_34":35,"_36":1074,"_24":25,"_151":-5,"_362":1075,"_27":1076},{"_44":1059,"_32":1060,"_30":1061,"_146":1062,"_42":43,"_41":1063,"_148":25,"_39":1064,"_13":165,"_34":35,"_36":1065,"_24":25,"_151":-5,"_362":1066,"_27":1067},{"_44":1054,"_32":1013,"_30":1007,"_146":230,"_42":43,"_41":1055,"_148":60,"_39":1056,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":1057,"_27":1058},{"_44":1046,"_32":1047,"_30":1048,"_146":1007,"_42":43,"_41":1049,"_148":60,"_39":1050,"_13":191,"_34":35,"_36":1051,"_24":25,"_151":-5,"_362":1052,"_27":1053},{"_44":1038,"_32":1039,"_30":1040,"_146":1007,"_42":43,"_41":1041,"_148":60,"_39":1042,"_13":470,"_34":35,"_36":1043,"_24":25,"_151":-5,"_362":1044,"_27":1045},{"_44":1030,"_32":1031,"_30":1032,"_146":1007,"_42":43,"_41":1033,"_148":60,"_39":1034,"_13":175,"_34":35,"_36":1035,"_24":25,"_151":-5,"_362":1036,"_27":1037},{"_44":1022,"_32":1023,"_30":1024,"_146":1007,"_42":43,"_41":1025,"_148":60,"_39":1026,"_13":470,"_34":35,"_36":1027,"_24":25,"_151":-5,"_362":1028,"_27":1029},{"_44":1014,"_32":1015,"_30":1016,"_146":1007,"_42":43,"_41":1017,"_148":60,"_39":1018,"_13":470,"_34":35,"_36":1019,"_24":25,"_151":-5,"_362":1020,"_27":1021},{"_44":1004,"_32":1005,"_30":1006,"_146":1007,"_42":43,"_41":1008,"_148":60,"_39":1009,"_13":495,"_34":35,"_36":1010,"_24":25,"_151":-5,"_362":1011,"_27":1012},{"_44":999,"_32":717,"_30":711,"_146":230,"_42":43,"_41":1000,"_148":60,"_39":1001,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":1002,"_27":1003},{"_44":994,"_32":986,"_30":980,"_146":711,"_42":43,"_41":995,"_148":60,"_39":996,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":997,"_27":998},{"_44":987,"_32":551,"_30":988,"_146":980,"_42":43,"_41":989,"_148":60,"_39":990,"_13":64,"_34":35,"_36":991,"_24":25,"_151":-5,"_362":992,"_27":993},{"_44":977,"_32":978,"_30":979,"_146":980,"_42":43,"_41":981,"_148":60,"_39":982,"_13":64,"_34":35,"_36":983,"_24":25,"_151":-5,"_362":984,"_27":985},{"_44":972,"_32":964,"_30":958,"_146":711,"_42":43,"_41":973,"_148":60,"_39":974,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":975,"_27":976},{"_44":965,"_32":551,"_30":966,"_146":958,"_42":43,"_41":967,"_148":60,"_39":968,"_13":64,"_34":35,"_36":969,"_24":25,"_151":-5,"_362":970,"_27":971},{"_44":955,"_32":956,"_30":957,"_146":958,"_42":43,"_41":959,"_148":25,"_39":960,"_13":64,"_34":35,"_36":961,"_24":25,"_151":-5,"_362":962,"_27":963},{"_44":950,"_32":942,"_30":936,"_146":711,"_42":43,"_41":951,"_148":60,"_39":952,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":953,"_27":954},{"_44":943,"_32":551,"_30":944,"_146":936,"_42":43,"_41":945,"_148":60,"_39":946,"_13":64,"_34":35,"_36":947,"_24":25,"_151":-5,"_362":948,"_27":949},{"_44":933,"_32":934,"_30":935,"_146":936,"_42":43,"_41":937,"_148":60,"_39":938,"_13":64,"_34":35,"_36":939,"_24":25,"_151":-5,"_362":940,"_27":941},{"_44":928,"_32":920,"_30":914,"_146":711,"_42":43,"_41":929,"_148":60,"_39":930,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":931,"_27":932},{"_44":921,"_32":551,"_30":922,"_146":914,"_42":43,"_41":923,"_148":60,"_39":924,"_13":199,"_34":35,"_36":925,"_24":25,"_151":-5,"_362":926,"_27":927},{"_44":911,"_32":912,"_30":913,"_146":914,"_42":43,"_41":915,"_148":60,"_39":916,"_13":665,"_34":35,"_36":917,"_24":25,"_151":-5,"_362":918,"_27":919},{"_44":906,"_32":858,"_30":852,"_146":711,"_42":43,"_41":907,"_148":60,"_39":908,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":909,"_27":910},{"_44":898,"_32":899,"_30":900,"_146":852,"_42":43,"_41":901,"_148":60,"_39":902,"_13":64,"_34":20,"_36":903,"_24":25,"_151":-5,"_362":904,"_27":905},{"_44":890,"_32":891,"_30":892,"_146":852,"_42":43,"_41":893,"_148":60,"_39":894,"_13":64,"_34":35,"_36":895,"_24":25,"_151":-5,"_362":896,"_27":897},{"_44":882,"_32":883,"_30":884,"_146":852,"_42":43,"_41":885,"_148":60,"_39":886,"_13":199,"_34":35,"_36":887,"_24":25,"_151":-5,"_362":888,"_27":889},{"_44":874,"_32":875,"_30":876,"_146":852,"_42":43,"_41":877,"_148":60,"_39":878,"_13":64,"_34":35,"_36":879,"_24":25,"_151":-5,"_362":880,"_27":881},{"_44":866,"_32":551,"_30":867,"_146":852,"_42":43,"_41":868,"_148":60,"_39":869,"_13":870,"_34":35,"_36":871,"_24":25,"_151":-5,"_362":872,"_27":873},{"_44":859,"_32":761,"_30":860,"_146":852,"_42":43,"_41":861,"_148":60,"_39":862,"_13":158,"_34":35,"_36":863,"_24":25,"_151":-5,"_362":864,"_27":865},{"_44":850,"_32":752,"_30":851,"_146":852,"_42":43,"_41":853,"_148":60,"_39":854,"_13":64,"_34":35,"_36":855,"_24":25,"_151":-5,"_362":856,"_27":857},{"_44":845,"_32":796,"_30":790,"_146":711,"_42":43,"_41":846,"_148":60,"_39":847,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":848,"_27":849},{"_44":837,"_32":838,"_30":839,"_146":790,"_42":43,"_41":840,"_148":60,"_39":841,"_13":191,"_34":35,"_36":842,"_24":25,"_151":-5,"_362":843,"_27":844},{"_44":829,"_32":830,"_30":831,"_146":790,"_42":43,"_41":832,"_148":60,"_39":833,"_13":495,"_34":35,"_36":834,"_24":25,"_151":-5,"_362":835,"_27":836},{"_44":821,"_32":822,"_30":823,"_146":790,"_42":43,"_41":824,"_148":60,"_39":825,"_13":191,"_34":35,"_36":826,"_24":25,"_151":-5,"_362":827,"_27":828},{"_44":813,"_32":814,"_30":815,"_146":790,"_42":43,"_41":816,"_148":60,"_39":817,"_13":470,"_34":35,"_36":818,"_24":25,"_151":-5,"_362":819,"_27":820},{"_44":805,"_32":806,"_30":807,"_146":790,"_42":43,"_41":808,"_148":60,"_39":809,"_13":470,"_34":35,"_36":810,"_24":25,"_151":-5,"_362":811,"_27":812},{"_44":797,"_32":798,"_30":799,"_146":790,"_42":43,"_41":800,"_148":60,"_39":801,"_13":199,"_34":35,"_36":802,"_24":25,"_151":-5,"_362":803,"_27":804},{"_44":788,"_32":752,"_30":789,"_146":790,"_42":43,"_41":791,"_148":60,"_39":792,"_13":191,"_34":35,"_36":793,"_24":25,"_151":-5,"_362":794,"_27":795},{"_44":783,"_32":100,"_30":754,"_146":711,"_42":43,"_41":784,"_148":60,"_39":785,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":786,"_27":787},{"_44":775,"_32":776,"_30":777,"_146":754,"_42":43,"_41":778,"_148":60,"_39":779,"_13":175,"_34":35,"_36":780,"_24":25,"_151":-5,"_362":781,"_27":782},{"_44":768,"_32":551,"_30":769,"_146":754,"_42":43,"_41":770,"_148":60,"_39":771,"_13":158,"_34":35,"_36":772,"_24":25,"_151":-5,"_362":773,"_27":774},{"_44":760,"_32":761,"_30":762,"_146":754,"_42":43,"_41":763,"_148":60,"_39":764,"_13":199,"_34":35,"_36":765,"_24":25,"_151":-5,"_362":766,"_27":767},{"_44":751,"_32":752,"_30":753,"_146":754,"_42":43,"_41":755,"_148":60,"_39":756,"_13":64,"_34":35,"_36":757,"_24":25,"_151":-5,"_362":758,"_27":759},{"_44":743,"_32":744,"_30":745,"_146":711,"_42":43,"_41":746,"_148":60,"_39":747,"_13":495,"_34":35,"_36":748,"_24":25,"_151":-5,"_362":749,"_27":750},{"_44":735,"_32":736,"_30":737,"_146":711,"_42":43,"_41":738,"_148":60,"_39":739,"_13":175,"_34":35,"_36":740,"_24":25,"_151":-5,"_362":741,"_27":742},{"_44":726,"_32":727,"_30":728,"_146":711,"_42":43,"_41":729,"_148":60,"_39":730,"_13":731,"_34":35,"_36":732,"_24":25,"_151":-5,"_362":733,"_27":734},{"_44":718,"_32":719,"_30":720,"_146":711,"_42":43,"_41":721,"_148":60,"_39":722,"_13":175,"_34":35,"_36":723,"_24":25,"_151":-5,"_362":724,"_27":725},{"_44":709,"_32":466,"_30":710,"_146":711,"_42":43,"_41":712,"_148":60,"_39":713,"_13":470,"_34":35,"_36":714,"_24":25,"_151":-5,"_362":715,"_27":716},{"_44":704,"_32":594,"_30":678,"_146":230,"_42":43,"_41":705,"_148":60,"_39":706,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":707,"_27":708},{"_44":699,"_32":691,"_30":685,"_146":678,"_42":43,"_41":700,"_148":60,"_39":701,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":702,"_27":703},{"_44":692,"_32":670,"_30":693,"_146":685,"_42":43,"_41":694,"_148":60,"_39":695,"_13":64,"_34":35,"_36":696,"_24":25,"_151":-5,"_362":697,"_27":698},{"_44":683,"_32":661,"_30":684,"_146":685,"_42":43,"_41":686,"_148":60,"_39":687,"_13":64,"_34":35,"_36":688,"_24":25,"_151":-5,"_362":689,"_27":690},{"_44":677,"_32":595,"_30":587,"_146":678,"_42":43,"_41":679,"_148":60,"_39":680,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":681,"_27":682},{"_44":669,"_32":670,"_30":671,"_146":587,"_42":43,"_41":672,"_148":60,"_39":673,"_13":665,"_34":35,"_36":674,"_24":25,"_151":-5,"_362":675,"_27":676},{"_44":660,"_32":661,"_30":662,"_146":587,"_42":43,"_41":663,"_148":60,"_39":664,"_13":665,"_34":35,"_36":666,"_24":25,"_151":-5,"_362":667,"_27":668},{"_44":652,"_32":653,"_30":654,"_146":587,"_42":43,"_41":655,"_148":60,"_39":656,"_13":191,"_34":35,"_36":657,"_24":25,"_151":-5,"_362":658,"_27":659},{"_44":644,"_32":645,"_30":646,"_146":587,"_42":43,"_41":647,"_148":60,"_39":648,"_13":394,"_34":35,"_36":649,"_24":25,"_151":-5,"_362":650,"_27":651},{"_44":636,"_32":637,"_30":638,"_146":587,"_42":43,"_41":639,"_148":60,"_39":640,"_13":394,"_34":35,"_36":641,"_24":25,"_151":-5,"_362":642,"_27":643},{"_44":628,"_32":629,"_30":630,"_146":587,"_42":43,"_41":631,"_148":60,"_39":632,"_13":64,"_34":35,"_36":633,"_24":25,"_151":-5,"_362":634,"_27":635},{"_44":620,"_32":621,"_30":622,"_146":587,"_42":43,"_41":623,"_148":60,"_39":624,"_13":175,"_34":35,"_36":625,"_24":25,"_151":-5,"_362":626,"_27":627},{"_44":612,"_32":613,"_30":614,"_146":587,"_42":43,"_41":615,"_148":60,"_39":616,"_13":64,"_34":35,"_36":617,"_24":25,"_151":-5,"_362":618,"_27":619},{"_44":604,"_32":605,"_30":606,"_146":587,"_42":43,"_41":607,"_148":60,"_39":608,"_13":470,"_34":35,"_36":609,"_24":25,"_151":-5,"_362":610,"_27":611},{"_44":596,"_32":597,"_30":598,"_146":587,"_42":43,"_41":599,"_148":60,"_39":600,"_13":64,"_34":35,"_36":601,"_24":25,"_151":-5,"_362":602,"_27":603},{"_44":584,"_32":585,"_30":586,"_146":587,"_42":43,"_41":588,"_148":60,"_39":589,"_13":590,"_34":35,"_36":591,"_24":25,"_151":-5,"_362":592,"_27":593},{"_44":223,"_32":224,"_30":225,"_146":-5,"_42":43,"_41":199,"_148":60,"_39":581,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":582,"_27":583},{"_44":576,"_32":549,"_30":543,"_146":225,"_42":43,"_41":577,"_148":60,"_39":578,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":579,"_27":580},{"_44":567,"_32":568,"_30":569,"_146":543,"_42":43,"_41":570,"_148":60,"_39":571,"_13":572,"_34":35,"_36":573,"_24":25,"_151":-5,"_362":574,"_27":575},{"_44":558,"_32":559,"_30":560,"_146":543,"_42":43,"_41":561,"_148":60,"_39":562,"_13":563,"_34":35,"_36":564,"_24":25,"_151":-5,"_362":565,"_27":566},{"_44":550,"_32":551,"_30":552,"_146":543,"_42":43,"_41":553,"_148":60,"_39":554,"_13":64,"_34":35,"_36":555,"_24":25,"_151":-5,"_362":556,"_27":557},{"_44":540,"_32":541,"_30":542,"_146":543,"_42":43,"_41":544,"_148":60,"_39":545,"_13":175,"_34":35,"_36":546,"_24":25,"_151":-5,"_362":547,"_27":548},{"_44":531,"_32":532,"_30":533,"_146":225,"_42":43,"_41":534,"_148":60,"_39":535,"_13":536,"_34":35,"_36":537,"_24":25,"_151":-5,"_362":538,"_27":539},{"_44":523,"_32":524,"_30":525,"_146":225,"_42":43,"_41":526,"_148":60,"_39":527,"_13":191,"_34":35,"_36":528,"_24":25,"_151":-5,"_362":529,"_27":530},{"_44":515,"_32":516,"_30":517,"_146":225,"_42":43,"_41":518,"_148":60,"_39":519,"_13":199,"_34":35,"_36":520,"_24":25,"_151":-5,"_362":521,"_27":522},{"_44":507,"_32":508,"_30":509,"_146":225,"_42":43,"_41":510,"_148":60,"_39":511,"_13":175,"_34":35,"_36":512,"_24":25,"_151":-5,"_362":513,"_27":514},{"_44":499,"_32":500,"_30":501,"_146":225,"_42":43,"_41":502,"_148":60,"_39":503,"_13":158,"_34":35,"_36":504,"_24":25,"_151":-5,"_362":505,"_27":506},{"_44":490,"_32":491,"_30":492,"_146":225,"_42":43,"_41":493,"_148":60,"_39":494,"_13":495,"_34":35,"_36":496,"_24":25,"_151":-5,"_362":497,"_27":498},{"_44":482,"_32":483,"_30":484,"_146":225,"_42":43,"_41":485,"_148":60,"_39":486,"_13":470,"_34":35,"_36":487,"_24":25,"_151":-5,"_362":488,"_27":489},{"_44":474,"_32":475,"_30":476,"_146":225,"_42":43,"_41":477,"_148":60,"_39":478,"_13":158,"_34":35,"_36":479,"_24":25,"_151":-5,"_362":480,"_27":481},{"_44":465,"_32":466,"_30":467,"_146":225,"_42":43,"_41":468,"_148":60,"_39":469,"_13":470,"_34":35,"_36":471,"_24":25,"_151":-5,"_362":472,"_27":473},{"_44":216,"_32":217,"_30":218,"_146":-5,"_42":43,"_41":219,"_148":60,"_39":462,"_13":64,"_34":221,"_36":-5,"_24":25,"_151":-5,"_362":463,"_27":464},{"_44":454,"_32":455,"_30":456,"_146":218,"_42":43,"_41":457,"_148":60,"_39":458,"_13":191,"_34":35,"_36":459,"_24":25,"_151":-5,"_362":460,"_27":461},{"_44":446,"_32":447,"_30":448,"_146":218,"_42":43,"_41":449,"_148":60,"_39":450,"_13":191,"_34":35,"_36":451,"_24":25,"_151":-5,"_362":452,"_27":453},{"_44":438,"_32":439,"_30":440,"_146":218,"_42":43,"_41":441,"_148":60,"_39":442,"_13":199,"_34":35,"_36":443,"_24":25,"_151":-5,"_362":444,"_27":445},{"_44":430,"_32":431,"_30":432,"_146":218,"_42":43,"_41":433,"_148":25,"_39":434,"_13":64,"_34":35,"_36":435,"_24":25,"_151":-5,"_362":436,"_27":437},{"_44":422,"_32":423,"_30":424,"_146":218,"_42":43,"_41":425,"_148":60,"_39":426,"_13":64,"_34":35,"_36":427,"_24":25,"_151":-5,"_362":428,"_27":429},{"_44":414,"_32":415,"_30":416,"_146":218,"_42":43,"_41":417,"_148":60,"_39":418,"_13":394,"_34":35,"_36":419,"_24":25,"_151":-5,"_362":420,"_27":421},{"_44":406,"_32":407,"_30":408,"_146":218,"_42":43,"_41":409,"_148":60,"_39":410,"_13":64,"_34":35,"_36":411,"_24":25,"_151":-5,"_362":412,"_27":413},{"_44":398,"_32":399,"_30":400,"_146":218,"_42":43,"_41":401,"_148":60,"_39":402,"_13":191,"_34":35,"_36":403,"_24":25,"_151":-5,"_362":404,"_27":405},{"_44":389,"_32":390,"_30":391,"_146":218,"_42":43,"_41":392,"_148":60,"_39":393,"_13":394,"_34":35,"_36":395,"_24":25,"_151":-5,"_362":396,"_27":397},{"_44":209,"_32":210,"_30":211,"_146":-5,"_42":43,"_41":212,"_148":60,"_39":386,"_13":64,"_34":20,"_36":214,"_24":25,"_151":-5,"_362":387,"_27":388},{"_44":202,"_32":203,"_30":204,"_146":-5,"_42":43,"_41":205,"_148":60,"_39":383,"_13":64,"_34":20,"_36":207,"_24":25,"_151":-5,"_362":384,"_27":385},{"_44":194,"_32":195,"_30":196,"_146":-5,"_42":43,"_41":197,"_148":60,"_39":380,"_13":199,"_34":20,"_36":200,"_24":25,"_151":-5,"_362":381,"_27":382},{"_44":186,"_32":187,"_30":188,"_146":-5,"_42":43,"_41":189,"_148":60,"_39":377,"_13":191,"_34":20,"_36":192,"_24":25,"_151":-5,"_362":378,"_27":379},{"_44":178,"_32":179,"_30":180,"_146":-5,"_42":43,"_41":181,"_148":60,"_39":374,"_13":183,"_34":20,"_36":184,"_24":25,"_151":-5,"_362":375,"_27":376},{"_44":170,"_32":171,"_30":172,"_146":-5,"_42":43,"_41":173,"_148":60,"_39":371,"_13":175,"_34":20,"_36":176,"_24":25,"_151":-5,"_362":372,"_27":373},{"_44":161,"_32":162,"_30":58,"_146":-5,"_42":43,"_41":163,"_148":60,"_39":368,"_13":165,"_34":166,"_36":167,"_24":25,"_151":168,"_362":369,"_27":370},{"_44":153,"_32":154,"_30":155,"_146":-5,"_42":43,"_41":156,"_148":60,"_39":365,"_13":158,"_34":20,"_36":159,"_24":25,"_151":-5,"_362":366,"_27":367},{"_44":143,"_32":144,"_30":145,"_146":-5,"_42":43,"_41":147,"_148":60,"_39":361,"_13":64,"_34":20,"_36":150,"_24":25,"_151":-5,"_362":363,"_27":364},["D",1788752201112],"children",[],[144],["D",1788773355439],[],[154],["D",1780941501215],[],[162],["D",1785503537350],[],[171],["D",1786181484238],[],[179],["D",1788752201431],[],[187],["D",1783058175024],[],[195],["D",1784552289835],[],[203],["D",1781519599844],[],[210],"758e4b73-5355-41f8-b4d5-a7e4323e0be6","view-meta.ts","81da3cbc-68c2-11f1-8bd7-1607ee4eb77e",602,["D",1784552289843],3,"#!/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\";\nimport { getOrderSummary } from \"../backend/integrations/shopify/orders.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\n// order header + tags ----\nif (opt(p.type) === \"order\") {\n const order = await getOrderSummary(cfg, gid);\n if (order) {\n console.log(`${order.name} ${order.financial_status} ${order.created_at}`);\n if (order.customer) {\n const c = order.customer;\n console.log(`customer: ${c.display_name} ${c.email ?? \"\"} ${c.phone ?? \"\"}`.trimEnd());\n }\n for (const li of order.line_items) console.log(` ${li.quantity}× ${li.title}`);\n console.log(`tags: ${order.tags.length ? order.tags.join(\", \") : \"(none)\"}`);\n if (order.note) console.log(`note: ${order.note}`);\n console.log(\"\");\n }\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",[],[217,390],"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",[],[217,399],"31b04834-afaa-4fea-b28f-93cf8ae88def","resolve-incoming-caller.ts","747702a6-8ce1-11f1-b49c-1607ee4eb77e",611,["D",1785503537455],"#!/usr/bin/env -S deno run --allow-env --allow-net --allow-read\n// resolve-incoming-caller.ts — Local dry-run of the SIP pre-connect hook.\n\nimport { bootstrap, die, usage, wantsHelp } from \"./_common.ts\";\nimport { lookupCallerByPhone } from \"../backend/integrations/shopify/snapshot.ts\";\n\nif (wantsHelp(Deno.args.length)) {\n usage([\n \"resolve-incoming-caller — SIP pre-connect hook dry-run (no HTTP / no vt push).\",\n \"\",\n \"Usage:\",\n \" deno task resolve-incoming-caller \",\n \" deno task resolve-incoming-caller -c jjs \",\n \"\",\n \"Options:\",\n \" Caller E.164 (required), e.g. +919876543210\",\n \" -c Store to query (default: ttai)\",\n \"\",\n \"Prints the PreCallHookResult shape: user_name, user_email, dynamic_vars.\",\n ]);\n}\n\nconst { cfg, store, args } = await bootstrap();\nconst phone = args[0];\nif (!phone) die(\"Usage: deno task resolve-incoming-caller [-c ttai|jjs] \");\n\nconsole.log(`[${store}] Resolving caller ${phone} …\\n`);\n\nconst found = await lookupCallerByPhone(cfg, phone);\nif (!found) {\n console.log(JSON.stringify({ user_name: null, user_email: null, dynamic_vars: {} }, null, 2));\n Deno.exit(0);\n}\n\nconst userName = found.first_name || found.display_name || null;\nconst vars: Record = {};\nif (found.first_name) vars.firstname = found.first_name;\nif (found.order) {\n vars.shopify_order_id = found.order.name;\n vars.order_date = found.order.created_at;\n if (found.order.delivery_date) vars.delivery_date = found.order.delivery_date;\n if (found.order.product_name) vars.product_name = found.order.product_name;\n}\n\nconsole.log(\n JSON.stringify(\n {\n user_name: userName,\n user_email: found.email,\n dynamic_vars: vars,\n },\n null,\n 2,\n ),\n);\nconsole.log();\n",[],[217,407],"2c0f21c8-7e8f-4d8d-9f80-170778eda71c","get-customer-info.ts","a0e38a86-68a5-11f1-a4b4-1607ee4eb77e",547,["D",1782893137775],"#!/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",[],[217,415],"b32c278b-f918-4e12-a998-66c5fc6a1fcd","gen-jjs-catalog.ts","571a99f4-8037-11f1-84c3-1607ee4eb77e",593,["D",1784111059795],"// gen-jjs-catalog.ts — Regenerate the JhaJi curated catalog data module.\n// Fetches the public Shopify feed, applies transform rules, validates against the\n// hand-curated overlay, and rewrites backend/customers/jjs/catalog-data.ts.\n//\n// Usage: deno run -A scripts/gen-jjs-catalog.ts\n// Runbook: backend/customers/jjs/catalog-context.md\n\nimport {\n CATALOG_OVERLAY,\n type CatalogCategory,\n type CatalogFeedProduct,\n type CatalogVariant,\n} from \"../backend/customers/jjs/catalog-overlay.ts\";\n\nconst FEED_URL = \"https://jhajistore.com/products.json?limit=250\";\nconst OUT_PATH = new URL(\"../backend/customers/jjs/catalog-data.ts\", import.meta.url);\n\n// transform ---------------------------------------------------------------------\n\ninterface FeedVariant {\n id: number;\n title: string;\n price: string;\n available: boolean;\n}\ninterface FeedProduct {\n title: string;\n handle: string;\n tags: string[];\n variants: FeedVariant[];\n}\n\n/** Title heuristic; overlay `category` overrides the result. */\nfunction classify(title: string, handle: string): CatalogCategory {\n const t = `${title} ${handle}`.toLowerCase();\n if (t.includes(\"kheer\")) return \"kheer\";\n if (t.includes(\"sample pack\") || t.includes(\"sample-pack\")) return \"sample_pack\";\n if (/combo|bundle|duo|pack of|pick your own|make you|pickle pack/.test(t)) return \"combo\";\n if (/^\\d+\\s/.test(title)) return \"combo\"; // \"3 Unique Bihari Pickles | …\"\n return \"single\";\n}\n\nfunction toProduct(p: FeedProduct): CatalogFeedProduct {\n const name = p.title.split(\"|\")[0].trim();\n const category = CATALOG_OVERLAY[p.handle]?.category ?? classify(p.title, p.handle);\n const variants: CatalogVariant[] = p.variants.map((v) => ({\n option: v.title,\n price: Math.round(Number(v.price)),\n available: v.available,\n variant_id: v.id,\n }));\n return { handle: p.handle, name, category, tags: p.tags, variants };\n}\n\n// validate ----------------------------------------------------------------------\n\nfunction validate(products: CatalogFeedProduct[]): void {\n for (const p of products) {\n const overlay = CATALOG_OVERLAY[p.handle];\n if (!overlay) {\n console.warn(`⚠ no overlay entry: ${p.handle} — add aliases/flags in catalog-overlay.ts`);\n continue;\n }\n if ((p.category === \"sample_pack\" || p.category === \"combo\") && !overlay.contents) {\n console.warn(`⚠ ${p.category} without contents[]: ${p.handle} — customers can't ask what's inside`);\n }\n }\n const staleOverlays = Object.keys(CATALOG_OVERLAY).filter(\n (h) => !products.some((p) => p.handle === h),\n );\n for (const h of staleOverlays) console.warn(`⚠ overlay entry no longer in feed: ${h}`);\n}\n\n// emit ---------------------------------------------------------------------------\n\nfunction emit(products: CatalogFeedProduct[]): string {\n const dated = new Date().toISOString().slice(0, 10);\n return `// jjs/catalog-data.ts — GENERATED by scripts/gen-jjs-catalog.ts on ${dated}.\n// Do NOT edit by hand — regenerate per catalog-context.md. Curation (aliases,\n// spice, contents) lives in catalog-overlay.ts and is merged at runtime.\n//\n// Special File: upto 2500 lines tolerated (generated data — grows with the catalog)\n\nimport type { CatalogFeedProduct } from \"./catalog-overlay.ts\";\n\nexport const CATALOG_FEED: CatalogFeedProduct[] = ${JSON.stringify(products, null, 2)};\n`;\n}\n\n// main ---------------------------------------------------------------------------\n\nconst res = await fetch(FEED_URL);\nif (!res.ok) {\n console.error(`Feed fetch failed: ${res.status} ${res.statusText}`);\n Deno.exit(1);\n}\nconst feed = (await res.json()) as { products: FeedProduct[] };\nconst products = feed.products.map(toProduct);\nvalidate(products);\nawait Deno.writeTextFile(OUT_PATH, emit(products));\nconsole.log(`✓ wrote ${products.length} products to backend/customers/jjs/catalog-data.ts`);\n",[],[217,423],"48096979-3839-4e2b-a437-63a80b40a843","gen-collegevidya-chapters.ts","805fa59e-abb0-11f1-a990-1607ee4eb77e",664,["D",1788890997980],"// gen-collegevidya-chapters.ts — Regenerate the College Vidya chapter data modules.\n// Reads each chapter's markdown from py/jarvis/scenario-data/college_vidya/training/\n// module_3/reading/ (source of truth, owned by the training-content team), pairs it\n// with the hand-curated overlay (slug, file, aliases), extracts the title from the\n// first H1 heading, and rewrites backend/agents/collegevidya-chapter-data-N.ts plus\n// the collegevidya-chapter-data.ts aggregator.\n//\n// Split into PART_COUNT files because Val Town enforces an 80,000-character\n// per-file limit (https://www.val.town/limits) and the full catalog exceeds it.\n//\n// Usage (from exp/vals/uAgents/): deno run -A scripts/gen-collegevidya-chapters.ts\n// Re-run whenever a chapter markdown file changes.\n\nimport {\n CHAPTER_OVERLAY,\n type ChapterRecord,\n} from \"../backend/agents/collegevidya-chapter-overlay.ts\";\n\nconst READING_DIR = new URL(\n \"../../../../py/jarvis/scenario-data/college_vidya/training/module_3/reading/\",\n import.meta.url,\n);\nconst AGENTS_DIR = new URL(\"../backend/agents/\", import.meta.url);\nconst PART_COUNT = 4;\n\nfunction titleOf(markdown: string, slug: string): string {\n const heading = markdown.split(\"\\n\").find((line) => line.startsWith(\"# \"));\n if (!heading) throw new Error(`No H1 heading found in chapter: ${slug}`);\n return heading.slice(2).trim();\n}\n\nasync function loadChapter(slug: string): Promise {\n const overlay = CHAPTER_OVERLAY[slug];\n const content = (await Deno.readTextFile(new URL(overlay.file, READING_DIR))).trim();\n return { slug, title: titleOf(content, slug), aliases: overlay.aliases, content };\n}\n\nfunction chunk(items: T[], parts: number): T[][] {\n const size = Math.ceil(items.length / parts);\n const chunks: T[][] = [];\n for (let i = 0; i < items.length; i += size) chunks.push(items.slice(i, i + size));\n return chunks;\n}\n\nfunction emitPart(chapters: ChapterRecord[], partNum: number, dated: string): string {\n return `// collegevidya-chapter-data-${partNum}.ts — GENERATED by scripts/gen-collegevidya-chapters.ts\n// on ${dated}. Do NOT edit by hand — part ${partNum} of the chapter catalog, split to stay under\n// Val Town's 80,000-character per-file limit. Regenerate via the script when a chapter changes.\n\nimport type { ChapterRecord } from \"./collegevidya-chapter-overlay.ts\";\n\nexport const CHAPTER_DATA_PART_${partNum}: ChapterRecord[] = ${JSON.stringify(chapters, null, 2)};\n`;\n}\n\nfunction emitIndex(partCount: number, dated: string): string {\n const imports = Array.from(\n { length: partCount },\n (_, i) =>\n `import { CHAPTER_DATA_PART_${i + 1} } from \"./collegevidya-chapter-data-${i + 1}.ts\";`,\n ).join(\"\\n\");\n const spread = Array.from({ length: partCount }, (_, i) => `...CHAPTER_DATA_PART_${i + 1}`).join(\n \", \",\n );\n return `// collegevidya-chapter-data.ts — GENERATED by scripts/gen-collegevidya-chapters.ts on ${dated}.\n// Do NOT edit by hand — merges the chapter-data-N.ts parts (split to stay under Val Town's\n// 80,000-character per-file limit) into one array. Regenerate via the script when a chapter\n// markdown file changes (source: py/jarvis/scenario-data/college_vidya/training/module_3/reading/).\n\nexport type { ChapterRecord } from \"./collegevidya-chapter-overlay.ts\";\n${imports}\n\nexport const CHAPTER_DATA = [${spread}];\n`;\n}\n\nconst slugs = Object.keys(CHAPTER_OVERLAY);\nconst chapters = await Promise.all(slugs.map(loadChapter));\nconst parts = chunk(chapters, PART_COUNT);\nconst dated = new Date().toISOString().slice(0, 10);\n\nawait Promise.all(\n parts.map((part, i) =>\n Deno.writeTextFile(\n new URL(`collegevidya-chapter-data-${i + 1}.ts`, AGENTS_DIR),\n emitPart(part, i + 1, dated),\n )\n ),\n);\nawait Deno.writeTextFile(\n new URL(\"collegevidya-chapter-data.ts\", AGENTS_DIR),\n emitIndex(parts.length, dated),\n);\nconsole.log(\n `✓ wrote ${chapters.length} chapters across ${parts.length} parts to backend/agents/collegevidya-chapter-data*.ts`,\n);\n",[],[217,431],"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",[],[217,439],"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",[],[217,447],"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",[],[217,455],["D",1781519599541],[343,344,345,346,347,348,349,350,351],[217],"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",[],[224,466],"a1457f60-24f4-4020-a557-4cff6f56b16e","shared.tsx","fe520698-632d-11f1-aacf-1607ee4eb77e",386,["D",1780952006405],"/** @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 · v667