[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_355":356,"_357":358},"routes/_app.x.$handle.$name",{"_108":107,"_38":50,"_116":94,"_33":117,"_13":14,"_118":-5,"_11":119,"_120":121,"_122":123,"_124":125,"_126":127,"_26":-5,"_128":129,"_130":131,"_132":54,"_133":134,"_135":31,"_136":-5,"_137":-5,"_138":139},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":18,"_19":-5},"project",{"_48":49,"_38":50,"_43":51,"_52":-5,"_53":54,"_55":56,"_57":56,"_58":59,"_60":-5,"_19":61,"_62":-5,"_63":54,"_64":-5,"_65":-5,"_66":67,"_68":69,"_70":71,"_72":73,"_74":75,"_76":-5,"_77":78,"_79":78,"_80":81,"_82":81,"_83":81,"_84":78,"_85":78,"_86":87,"_88":89,"_90":91,"_92":54},"version",7,"changes",[25],"aiChatInfo",{"_20":21,"_22":-5,"_23":-5,"_24":-5},"userId","aiChatMessageId","b4f9a1f4-f871-4c59-b572-6fce6ee8bae0","aiChatThreadId","aiChatThreadUserId","aiChatThreadTitle",{"_26":27,"_28":29,"_30":31,"_32":31,"_33":34,"_35":34},"file",{"_36":37,"_38":34,"_39":40,"_41":42,"_43":44,"_45":14,"_46":47,"_30":31},"previous",{"_36":37,"_38":34,"_39":40,"_41":42},"deleted",true,"deletedHere","path","fax.ts","latestPath","fileId","019e75a2-f04c-7499-b28f-563f43ceb0a7","name","fileType","script","content","// Pluggable fax backend.\n//\n// The document is never stored — it's forwarded to the fax network and dropped;\n// we hand back a job id and read status live from the provider. (A separate\n// metadata log in db.ts records send info only — never the document.)\n//\n// Live: Sinch Fax API v3 — needs SINCH_KEY_ID + SINCH_KEY_SECRET (OAuth2) and\n// SINCH_PROJECT_ID. Otherwise: a deterministic sandbox that simulates sending so\n// the full pay -> fax loop is demoable without a fax account.\n\nexport type FaxStatus = \"queued\" | \"sending\" | \"delivered\" | \"failed\";\nexport type Provider = \"sinch\" | \"sandbox\";\n\nexport interface FaxInput {\n to: string;\n fileUrl?: string; // public URL to a PDF (preferred — Sinch fetches it)\n contentBase64?: string; // base64-encoded document bytes\n fileName?: string; // used with contentBase64\n}\n\nexport interface FaxSendResult {\n provider: Provider;\n jobId: string; // opaque, provider-namespaced id we hand back to the caller\n status: FaxStatus;\n pages: number | null;\n error?: string;\n}\n\nfunction sinchKeyId() {\n return Deno.env.get(\"SINCH_KEY_ID\");\n}\nfunction sinchKeySecret() {\n return Deno.env.get(\"SINCH_KEY_SECRET\");\n}\nfunction sinchProjectId() {\n return Deno.env.get(\"SINCH_PROJECT_ID\");\n}\n\nexport function activeProvider(): Provider {\n return sinchKeyId() && sinchKeySecret() && sinchProjectId() ? \"sinch\" : \"sandbox\";\n}\n\n// --- Input handling ---------------------------------------------------------\n\nexport function normalizeNumber(to: string): string {\n const digits = to.trim().replace(/[^\\d+]/g, \"\");\n if (digits.startsWith(\"+\")) return digits;\n if (/^\\d{10}$/.test(digits)) return \"+1\" + digits; // bare NANP\n if (/^1\\d{10}$/.test(digits)) return \"+\" + digits;\n return \"+\" + digits;\n}\n\nexport function validateInput(input: FaxInput): string | null {\n if (!input.to || normalizeNumber(input.to).replace(/\\D/g, \"\").length < 8) {\n return \"`to` must be a valid phone number in E.164 format, e.g. +14155550123\";\n }\n if (!input.fileUrl && !input.contentBase64) {\n return \"Provide a document via `file_url` (a public PDF URL) or `content_base64`.\";\n }\n if (input.fileUrl && !/^https?:\\/\\//.test(input.fileUrl)) {\n return \"`file_url` must be an http(s) URL.\";\n }\n return null;\n}\n\n// --- Job id (provider-namespaced, carries no payload) -----------------------\n\nexport function encodeJobId(provider: Provider, providerRef: string): string {\n return `${provider === \"sinch\" ? \"snc\" : \"sbx\"}_${providerRef}`;\n}\n\nexport function decodeJobId(id: string): { provider: Provider; ref: string } | null {\n const i = id.indexOf(\"_\");\n if (i < 0) return null;\n const prefix = id.slice(0, i);\n const ref = id.slice(i + 1);\n if (prefix === \"snc\") return { provider: \"sinch\", ref };\n if (prefix === \"sbx\") return { provider: \"sandbox\", ref };\n return null;\n}\n\n// --- Send -------------------------------------------------------------------\n\nexport async function sendFax(input: FaxInput): Promise {\n return activeProvider() === \"sinch\" ? sendViaSinch(input) : sendViaSandbox(input);\n}\n\n/** Live status lookup — no local state. */\nexport async function getStatus(\n jobId: string,\n): Promise<{ status: FaxStatus; pages: number | null; error?: string } | null> {\n const decoded = decodeJobId(jobId);\n if (!decoded) return null;\n return decoded.provider === \"sinch\" ? sinchStatus(decoded.ref) : sandboxStatus(decoded.ref);\n}\n\n// --- Sinch Fax API v3 -------------------------------------------------------\n\nlet _token: { value: string; exp: number } | null = null;\nasync function sinchToken(): Promise {\n const now = Date.now();\n if (_token && _token.exp > now + 60_000) return _token.value;\n const res = await fetch(\"https://auth.sinch.com/oauth2/token\", {\n method: \"POST\",\n headers: {\n Authorization: \"Basic \" + btoa(`${sinchKeyId()}:${sinchKeySecret()}`),\n \"content-type\": \"application/x-www-form-urlencoded\",\n },\n body: \"grant_type=client_credentials\",\n });\n const j = await res.json().catch(() => ({}));\n if (!j.access_token) throw new Error(`Sinch auth failed (HTTP ${res.status})`);\n _token = { value: j.access_token, exp: now + (Number(j.expires_in) || 3600) * 1000 };\n return _token.value;\n}\n\nfunction faxApiBase() {\n return `https://fax.api.sinch.com/v3/projects/${sinchProjectId()}/faxes`;\n}\n\nasync function sendViaSinch(input: FaxInput): Promise {\n let token: string;\n try {\n token = await sinchToken();\n } catch (e) {\n return { provider: \"sinch\", jobId: \"\", status: \"failed\", pages: null, error: String((e as Error).message) };\n }\n\n const form = new FormData();\n form.append(\"to\", normalizeNumber(input.to));\n const from = Deno.env.get(\"SINCH_FROM\");\n if (from) form.append(\"from\", from);\n if (input.fileUrl) {\n form.append(\"contentUrl\", input.fileUrl);\n } else if (input.contentBase64) {\n const blob = new Blob([base64ToBytes(input.contentBase64)], { type: \"application/pdf\" });\n form.append(\"file\", blob, input.fileName || \"document.pdf\");\n }\n\n const res = await fetch(faxApiBase(), {\n method: \"POST\",\n headers: { Authorization: `Bearer ${token}` },\n body: form,\n });\n const j = await res.json().catch(() => ({}));\n if (!res.ok || !j?.id) {\n return {\n provider: \"sinch\",\n jobId: \"\",\n status: \"failed\",\n pages: null,\n error: j?.message || j?.error || `Sinch error (HTTP ${res.status})`,\n };\n }\n return {\n provider: \"sinch\",\n jobId: encodeJobId(\"sinch\", String(j.id)),\n status: mapSinchStatus(j.status),\n pages: j.numberOfPages ?? null,\n };\n}\n\nasync function sinchStatus(ref: string): Promise<{ status: FaxStatus; pages: number | null; error?: string }> {\n const token = await sinchToken();\n const res = await fetch(`${faxApiBase()}/${encodeURIComponent(ref)}`, {\n headers: { Authorization: `Bearer ${token}` },\n });\n const j = await res.json().catch(() => ({}));\n return { status: mapSinchStatus(j?.status), pages: j?.numberOfPages ?? null, error: j?.errorType || undefined };\n}\n\nexport function mapSinchStatus(s: string | undefined): FaxStatus {\n switch (s) {\n case \"COMPLETED\":\n return \"delivered\";\n case \"FAILURE\":\n return \"failed\";\n case \"QUEUED\":\n return \"queued\";\n default:\n return \"sending\"; // IN_PROGRESS + unknowns\n }\n}\n\n// --- Sandbox (stateless: outcome is encoded in the job ref) -----------------\n\nconst SANDBOX_FAIL_NUMBERS = new Set([\"+15550000000\", \"+10000000000\"]);\n\nfunction sendViaSandbox(input: FaxInput): FaxSendResult {\n const to = normalizeNumber(input.to);\n const status: FaxStatus = SANDBOX_FAIL_NUMBERS.has(to) ? \"failed\" : \"delivered\";\n const ref = `${status}.${crypto.randomUUID().slice(0, 8)}`;\n return {\n provider: \"sandbox\",\n jobId: encodeJobId(\"sandbox\", ref),\n status,\n pages: status === \"delivered\" ? 1 : null,\n error: status === \"failed\" ? \"no_answer (simulated)\" : undefined,\n };\n}\n\nfunction sandboxStatus(ref: string): { status: FaxStatus; pages: number | null; error?: string } {\n const status = (ref.split(\".\")[0] as FaxStatus) || \"delivered\";\n return {\n status,\n pages: status === \"delivered\" ? 1 : null,\n error: status === \"failed\" ? \"no_answer (simulated)\" : undefined,\n };\n}\n\nfunction base64ToBytes(b64: string): Uint8Array {\n const bin = atob(b64.replace(/^data:.*;base64,/, \"\"));\n const out = new Uint8Array(bin.length);\n for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);\n return out;\n}\n","createdAt",["D",1780090296588],"branchVersion","branchId","404a0522-5ba5-11f1-b599-ee650bb23af1","id","4042da18-5ba5-11f1-b599-ee650bb23af1","agentsnailmail",["D",1780090073094],"deletedAt","legacyEnvVars",false,"privacy","public","httpPrivacy","description","Fax API for AI agents — paid per fax over x402 (USDC)","imageUrl","4d11709c-f58a-4ebd-9aff-ea1a657da2f8","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","e7772d02-8afa-4fe7-81f0-5d0c516ee833","tursoName","4042da185ba511f1b599ee650bb23af1","tursoHostname","4042da185ba511f1b599ee650bb23af1-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789509043237],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_108":107,"_115":111},"org",{"_108":107,"_109":-5,"_110":111,"_19":61,"_112":113,"_114":54},"branch",{"_13":93,"_38":94,"_48":47,"_95":49,"_96":97,"_98":99,"_100":56,"_101":102,"_103":104,"_105":50,"_106":107},"isOwned",17,"main","projectId","forkedBranchId","dbdd6128-5b69-11f1-a7a0-ee650bb23af1","forkedBranchVersion",140,"forkedProjectPrivacy","forkedProjectId","dbdc95e0-5b69-11f1-a7a0-ee650bb23af1","forkedProjectOrgId","e81e7335-6d4c-4764-a902-d0962bbfa9f7","projectName","userHandle","jchan7","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yb3FTYVlZMHVTOVMzVkV2T1hoT2hGb1o4c1YifQ","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_48":49,"_38":50,"_43":350,"_52":-5,"_53":54,"_55":56,"_57":56,"_58":59,"_60":-5,"_19":61,"_62":-5,"_63":54,"_64":-5,"_65":-5,"_66":67,"_68":69,"_70":71,"_72":73,"_74":351,"_76":-5,"_77":78,"_79":78,"_80":81,"_82":81,"_83":81,"_84":78,"_85":78,"_86":352,"_88":353,"_90":354,"_92":54},"tree",[234,245,246,247,248,249,250,251,252],"files",[234,235,236,237,238,239,240,241,242,243,244,245,246,247,248,249,250,251,252],"counts",{"_223":67,"_224":163,"_225":67,"_226":227,"_228":229},"contents",[150,151,152,153,154,155,156,157,158],"upstreamProject",{"_48":102,"_38":147,"_58":59,"_60":-5,"_55":56,"_86":148},"upstreamBranch",{"_48":97,"_43":140,"_141":142,"_38":94,"_95":102,"_13":143,"_96":-5,"_98":-5,"_144":145,"_52":-5,"_92":54,"_55":56,"_106":146,"_68":104,"_105":147},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1780064564360],"updatedAt",["D",1783436101628],150,"lockfileKey","1783436101842-esm.town_v_stevekrouse_agentfax@150-main","stevekrouse","agentfax",{"_108":146,"_115":149},"https://images.clerk.dev/uploaded/img_2PqHa2Gsy93xQrjh2w78Xu0cChW.jpeg",{"_48":217,"_38":218,"_36":219,"_162":-5,"_46":47,"_45":163,"_164":31,"_43":220,"_13":67,"_39":221,"_41":-5,"_30":54,"_167":-5,"_33":222},{"_48":211,"_38":212,"_36":213,"_162":-5,"_46":47,"_45":163,"_164":31,"_43":214,"_13":67,"_39":26,"_41":215,"_30":54,"_167":-5,"_33":216},{"_48":204,"_38":205,"_36":206,"_162":-5,"_46":47,"_45":207,"_164":31,"_43":208,"_13":163,"_39":40,"_41":209,"_30":54,"_167":-5,"_33":210},{"_48":197,"_38":198,"_36":199,"_162":-5,"_46":47,"_45":200,"_164":31,"_43":201,"_13":67,"_39":40,"_41":202,"_30":54,"_167":-5,"_33":203},{"_48":189,"_38":190,"_36":191,"_162":-5,"_46":47,"_45":192,"_164":31,"_43":193,"_13":163,"_39":194,"_41":195,"_30":54,"_167":-5,"_33":196},{"_48":182,"_38":183,"_36":184,"_162":-5,"_46":47,"_45":185,"_164":54,"_43":186,"_13":163,"_39":40,"_41":187,"_30":54,"_167":-5,"_33":188},{"_48":175,"_38":176,"_36":177,"_162":-5,"_46":47,"_45":178,"_164":31,"_43":179,"_13":163,"_39":40,"_41":180,"_30":54,"_167":-5,"_33":181},{"_48":169,"_38":170,"_36":171,"_162":-5,"_46":47,"_45":163,"_164":31,"_43":172,"_13":67,"_39":40,"_41":173,"_30":54,"_167":-5,"_33":174},{"_48":159,"_38":160,"_36":161,"_162":-5,"_46":47,"_45":163,"_164":31,"_43":165,"_13":67,"_39":40,"_41":166,"_30":54,"_167":-5,"_33":168},"4050d7bc-5ba5-11f1-b599-ee650bb23af1","payment.ts","019e75a2-f04c-7499-b28f-694c692de314","parentId",1,"latest",["D",1780090073094],"// x402 payment wiring.\n//\n// One standard x402 endpoint (USDC, `exact` scheme) is payable by Coinbase\n// x402 agents, Circle agent wallets, and Tempo/MPP agents alike. We gate\n// `POST /v1/fax` with the official x402-hono middleware, which encodes the\n// correct per-network USDC EIP-712 domain so any compliant client can pay.\n//\n// Config (all optional — sane defaults so it runs out of the box):\n// FAX_PAYMENT_MODE \"x402\" (default) | \"sandbox\" (skip payment, for testing)\n// FAX_NETWORK \"base-sepolia\" (default, keyless facilitator) | \"base\"\n// FAX_PRICE_USD \"$0.50\" (default), price per fax\n// FAX_PAYTO_ADDRESS 0x... wallet that receives the USDC\n// CDP_API_KEY_ID / CDP_API_KEY_SECRET required only when FAX_NETWORK=\"base\"\nimport type { Hono } from \"npm:hono\";\nimport { paymentMiddleware } from \"npm:x402-hono\";\n\nexport type PaymentMode = \"x402\" | \"sandbox\";\n\nexport const USDC: Record = {\n \"base\": { address: \"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\", decimals: 6 },\n \"base-sepolia\": { address: \"0x036CbD53842c5426634e7929541eC2318f3dCF7e\", decimals: 6 },\n};\n\nexport function paymentMode(): PaymentMode {\n return (Deno.env.get(\"FAX_PAYMENT_MODE\") || \"x402\").toLowerCase() === \"sandbox\"\n ? \"sandbox\"\n : \"x402\";\n}\n\nfunction hasUsableCdpKey(): boolean {\n const id = Deno.env.get(\"CDP_API_KEY_ID\");\n const secret = Deno.env.get(\"CDP_API_KEY_SECRET\") || \"\";\n // Real CDP secrets are PEM EC keys or long base64 Ed25519 keys. Reject short/malformed.\n return !!id && (secret.includes(\"BEGIN\") || secret.length >= 50);\n}\n\nexport function network(): string {\n const n = Deno.env.get(\"FAX_NETWORK\") || \"base-sepolia\";\n // Mainnet settlement needs a valid CDP facilitator key. If it's missing or\n // malformed, fall back to the keyless Base Sepolia facilitator so the service\n // keeps working — and auto-upgrades to mainnet once a valid key is set.\n if (n === \"base\" && !hasUsableCdpKey()) return \"base-sepolia\";\n return n;\n}\n\nexport function priceUsd(): string {\n const p = Deno.env.get(\"FAX_PRICE_USD\") || \"$0.50\";\n return p.startsWith(\"$\") ? p : `$${p}`;\n}\n\nexport function payToAddress(): string {\n // Default to Steve's known EVM address; override per-deployment.\n return Deno.env.get(\"FAX_PAYTO_ADDRESS\") || \"0xd6f0870b8e1c6af8d712cc506ccf5e96ac040592\";\n}\n\nexport function facilitatorUrl(): string {\n return network() === \"base\"\n ? \"https://api.cdp.coinbase.com/platform/v2/x402\"\n : \"https://x402.org/facilitator\";\n}\n\n/** Public, machine-readable description of how to pay this service. */\nexport function paymentInfo() {\n const net = network();\n return {\n protocol: \"x402\",\n x402Version: 1,\n scheme: \"exact\",\n network: net,\n asset: { symbol: \"USDC\", address: USDC[net]?.address ?? null, decimals: 6 },\n price: priceUsd(),\n payTo: payToAddress(),\n facilitator: facilitatorUrl(),\n mode: paymentMode(),\n payableBy: [\"coinbase-x402\", \"circle-agent-wallets\"],\n };\n}\n\nconst ROUTE_CONFIG = {\n price: priceUsd(),\n network: network(),\n config: {\n description: \"Send a fax to any phone number. Billed once per fax.\",\n mimeType: \"application/json\",\n maxTimeoutSeconds: 120,\n outputSchema: {\n type: \"object\",\n properties: {\n id: { type: \"string\" },\n status: { type: \"string\", enum: [\"queued\", \"sending\", \"delivered\", \"failed\"] },\n to: { type: \"string\" },\n },\n },\n },\n};\n\n/** Install x402 payment gating on POST /v1/fax (no-op in sandbox mode). */\nexport async function installPayment(app: Hono): Promise {\n if (paymentMode() === \"sandbox\") return;\n\n let facilitator: { url: string } | unknown = { url: facilitatorUrl() };\n if (network() === \"base\") {\n // CDP facilitator helper reads CDP_API_KEY_ID / CDP_API_KEY_SECRET.\n const mod = await import(\"npm:@coinbase/x402\");\n facilitator = mod.facilitator;\n }\n\n app.use(\n paymentMiddleware(\n payToAddress() as `0x${string}`,\n { \"POST /v1/fax\": ROUTE_CONFIG },\n facilitator as any,\n ),\n );\n}\n\n/** Decode the x402 X-PAYMENT header to learn who paid (best-effort). */\nexport function decodePayer(header: string | undefined): { payer: string | null; network: string | null } {\n if (!header) return { payer: null, network: null };\n try {\n const payload = JSON.parse(atob(header));\n return {\n payer: payload?.payload?.authorization?.from ?? null,\n network: payload?.network ?? null,\n };\n } catch {\n return { payer: null, network: null };\n }\n}\n","label",[160],"4050bcaa-5ba5-11f1-b599-ee650bb23af1","og.ts","019e75a2-f04c-7499-b28f-6749339e70f4",["D",1780090073094],"// Open Graph / Twitter card image (1200×630), generated with satori (JSX→SVG)\n// + resvg-wasm (SVG→PNG). Served at GET /og.png. Modeled on stevekrouse/secret-share.\nimport satori from \"npm:satori@0.10.13\";\nimport { initWasm, Resvg } from \"npm:@resvg/resvg-wasm@2.6.2\";\n\n// Static-weight TTFs (variable fonts crash satori's opentype.js). PT Sans is the\n// sans sibling of the PT Serif that secret-share uses — same reliable repo path.\nconst SANS_BOLD_TTF =\n \"https://raw.githubusercontent.com/google/fonts/main/ofl/ptsans/PT_Sans-Web-Bold.ttf\";\nconst SANS_REGULAR_TTF =\n \"https://raw.githubusercontent.com/google/fonts/main/ofl/ptsans/PT_Sans-Web-Regular.ttf\";\nconst RESVG_WASM_URL = \"https://unpkg.com/@resvg/resvg-wasm@2.6.2/index_bg.wasm\";\n\nlet fontsPromise: Promise<{ bold: ArrayBuffer; regular: ArrayBuffer }> | null = null;\nfunction loadFonts() {\n if (!fontsPromise) {\n const get = (url: string, label: string) =>\n fetch(url).then((r) => {\n if (!r.ok) throw new Error(`${label} font fetch failed: ${r.status}`);\n return r.arrayBuffer();\n });\n fontsPromise = Promise.all([\n get(SANS_BOLD_TTF, \"Bold\"),\n get(SANS_REGULAR_TTF, \"Regular\"),\n ]).then(([bold, regular]) => ({ bold, regular }));\n }\n return fontsPromise;\n}\n\nlet wasmPromise: Promise | null = null;\nfunction ensureResvg(): Promise {\n if (!wasmPromise) {\n wasmPromise = fetch(RESVG_WASM_URL)\n .then((r) => {\n if (!r.ok) throw new Error(`resvg wasm fetch failed: ${r.status}`);\n return r.arrayBuffer();\n })\n .then((bytes) => initWasm(bytes));\n }\n return wasmPromise;\n}\n\nfunction pill(text: string) {\n return {\n type: \"div\",\n props: {\n style: {\n display: \"flex\",\n fontSize: 26,\n color: \"#d4d4d4\",\n background: \"#1f1f1f\",\n borderRadius: \"999px\",\n padding: \"12px 28px\",\n },\n children: text,\n },\n };\n}\n\n// The favicon's fax glyph as a satori SVG node (0–32 grid), scaled to `size`.\nfunction faxIcon(size: number) {\n return {\n type: \"svg\",\n props: {\n width: size,\n height: size,\n viewBox: \"0 0 32 32\",\n children: [\n { type: \"rect\", props: { width: 32, height: 32, rx: 7, fill: \"#10b981\" } },\n { type: \"rect\", props: { x: 9, y: 5, width: 14, height: 7, rx: 1.5, fill: \"#0a0a0a\" } },\n { type: \"rect\", props: { x: 6, y: 12, width: 20, height: 14, rx: 2.5, fill: \"#0a0a0a\" } },\n { type: \"circle\", props: { cx: 22, cy: 16, r: 1.2, fill: \"#10b981\" } },\n { type: \"rect\", props: { x: 10, y: 19, width: 12, height: 8, rx: 1, fill: \"#10b981\" } },\n { type: \"rect\", props: { x: 12, y: 21, width: 8, height: 1.4, rx: 0.7, fill: \"#0a0a0a\" } },\n { type: \"rect\", props: { x: 12, y: 23.6, width: 6, height: 1.4, rx: 0.7, fill: \"#0a0a0a\" } },\n ],\n },\n };\n}\n\nasync function renderSvg(): Promise {\n const { bold, regular } = await loadFonts();\n const tree = {\n type: \"div\",\n props: {\n style: {\n width: \"1200px\",\n height: \"630px\",\n display: \"flex\",\n background: \"#0a0a0a\",\n padding: \"56px\",\n fontFamily: \"Sans\",\n },\n children: [\n {\n type: \"div\",\n props: {\n style: {\n flex: 1,\n display: \"flex\",\n flexDirection: \"row\",\n alignItems: \"center\",\n justifyContent: \"space-between\",\n padding: \"0 72px\",\n border: \"1px solid #262626\",\n borderRadius: \"28px\",\n background: \"#000\",\n },\n children: [\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", flexDirection: \"column\", maxWidth: \"640px\" },\n children: [\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", fontSize: 28, fontWeight: 700, color: \"#10b981\", letterSpacing: \"6px\" },\n children: \"FAX FOR AI AGENTS\",\n },\n },\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", fontSize: 110, fontWeight: 700, color: \"#ffffff\", letterSpacing: \"-3px\", marginTop: \"18px\" },\n children: \"agentfax\",\n },\n },\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", fontSize: 36, color: \"#a3a3a3\", lineHeight: 1.35, marginTop: \"20px\" },\n children: \"Pay per fax in USDC over Tempo/MPP. No signup, no API key.\",\n },\n },\n {\n type: \"div\",\n props: {\n style: { display: \"flex\", flexDirection: \"row\", gap: \"14px\", marginTop: \"34px\" },\n children: [pill(\"$0.20 / page\"), pill(\"USDC.e on Tempo\")],\n },\n },\n ],\n },\n },\n faxIcon(300),\n ],\n },\n },\n ],\n },\n };\n return await satori(tree as any, {\n width: 1200,\n height: 630,\n fonts: [\n { name: \"Sans\", data: bold, weight: 700, style: \"normal\" },\n { name: \"Sans\", data: regular, weight: 400, style: \"normal\" },\n ],\n });\n}\n\nexport async function renderOg(): Promise {\n try {\n const svg = await renderSvg();\n await ensureResvg();\n const png = new Resvg(svg).render().asPng();\n return new Response(png, {\n headers: { \"content-type\": \"image/png\", \"cache-control\": \"public, max-age=3600\" },\n });\n } catch (err) {\n const msg = err instanceof Error ? err.stack || err.message : String(err);\n return new Response(`OG render failed:\\n${msg}`, {\n status: 500,\n headers: { \"content-type\": \"text/plain\" },\n });\n }\n}\n",[170],"9f278484-5ba5-11f1-8c63-ee650bb23af1","notify.ts","019e75a2-f04c-7499-b28f-6259a130bbf9",5,["D",1780090232290],"// Owner notification — fire a celebratory email whenever a piece of mail is\n// successfully paid for and sent. Best-effort only: callers should never let\n// this block or fail the mailing itself. By default std/email sends to the val\n// owner's address.\nimport { email } from \"https://esm.town/v/std/email\";\n\nexport interface PaidMailNotice {\n id: string;\n type: string; // \"letter\" | \"postcard\"\n toCity: string | null;\n toState: string | null;\n toZip: string | null;\n pages: number | null;\n amount: string | null;\n payer: string | null;\n network: string;\n provider: string;\n status: string;\n expectedDelivery?: string | null;\n live: boolean; // true = real physical mail went out\n created_at: string;\n // Running totals (after this piece), for a little dopamine in the email.\n totals?: { pieces: number; pages: number };\n}\n\nexport async function notifyPaidMail(n: PaidMailNotice): Promise {\n const amount = n.amount ? `$${n.amount}` : \"(unknown)\";\n const dest = [n.toCity, n.toState, n.toZip].filter(Boolean).join(\", \") || \"(unknown)\";\n const realTag = n.live ? \"\" : \" [sandbox]\";\n const icon = n.type === \"postcard\" ? \"📮\" : \"✉️\";\n const subject = `💸${icon} Paid ${n.type}! ${amount} → ${dest}${realTag}`;\n\n const totalsLine = n.totals\n ? `\\nRunning total: ${n.totals.pieces} pieces, ${n.totals.pages} pages 🎉`\n : \"\";\n\n const text = `Someone just paid to send a ${n.type} on AgentSnailMail!${n.live ? \"\" : \"\\n(sandbox / test mode — no physical mail was actually sent)\"}\n\n Amount: ${amount}\n Type: ${n.type}\n To: ${dest}\n Pages: ${n.pages ?? \"?\"}\n Delivery: ${n.expectedDelivery ?? \"(unknown)\"}\n Payer: ${n.payer ?? \"(unknown wallet)\"}\n Network: ${n.network}\n Provider: ${n.provider}\n Status: ${n.status}\n Job ID: ${n.id}\n When: ${n.created_at}\n${totalsLine}`;\n\n await email({ subject, text });\n}\n",[176],"8ee822b8-5ba5-11f1-81c2-ee650bb23af1","mpp.ts","019e75a2-f04c-7499-b28f-5cccd964d007",3,["D",1780090205035],"// Tempo / MPP payment rail — mainnet (chain 4217), USDC.e, priced PER PIECE.\n//\n// Letters are priced per page (we count the PDF's pages on the unpaid request\n// and charge pages × rate + a base postage fee). Postcards are a flat rate. So\n// the 402 tells the agent the exact cost up front. mppx settles directly\n// against the Tempo RPC (no facilitator). Pay in one line:\n// tempo request -X POST --json '{...}' /v1/mail\nimport { Mppx, tempo } from \"npm:mppx@0.6.28/hono\";\nimport { privateKeyToAccount } from \"npm:viem/accounts\";\nimport type { MailType } from \"./mail.ts\";\n\nexport const USDC_E = {\n symbol: \"USDC.e\",\n address: \"0x20C000000000000000000000b9537d11c60E8b50\",\n decimals: 6,\n};\n\nfunction envUsd(key: string, fallback: number): number {\n return parseFloat(Deno.env.get(key) || String(fallback)) || fallback;\n}\n\n/** Flat postage/handling fee applied to every piece (covers postage). */\nexport function baseFeeUsd(): number {\n return envUsd(\"MAIL_BASE_FEE\", 1.0);\n}\n\n/** Marginal cost per printed page on a letter. */\nexport function perPageUsd(): number {\n return envUsd(\"MAIL_PRICE_PER_PAGE\", 0.25);\n}\n\n/** Flat all-in price for a postcard. */\nexport function postcardUsd(): number {\n return envUsd(\"MAIL_POSTCARD_PRICE\", 1.5);\n}\n\nexport function priceLabel(): string {\n return `letters $${baseFeeUsd().toFixed(2)} + $${perPageUsd().toFixed(2)}/page · postcards $${postcardUsd().toFixed(2)}`;\n}\n\nexport function recipient(): string {\n return Deno.env.get(\"TEMPO_RECIPIENT\") || \"0xed5bd29c47d40a054591b18cc2142cea8ab7c18a\";\n}\n\n// --- page counting ----------------------------------------------------------\n\nfunction base64ToBytes(b64: string): Uint8Array {\n const bin = atob(b64.replace(/^data:.*;base64,/, \"\"));\n const out = new Uint8Array(bin.length);\n for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);\n return out;\n}\n\nasync function docBytes(input: { fileUrl?: string; contentBase64?: string }): Promise {\n if (input.contentBase64) {\n try {\n return base64ToBytes(input.contentBase64);\n } catch {\n return null;\n }\n }\n if (input.fileUrl) {\n try {\n const res = await fetch(input.fileUrl);\n if (!res.ok) return null;\n const buf = new Uint8Array(await res.arrayBuffer());\n return buf.byteLength <= 25_000_000 ? buf : null; // 25 MB cap\n } catch {\n return null;\n }\n }\n return null;\n}\n\n/** Count PDF pages. Falls back to 1 page if the doc can't be fetched/parsed. */\nexport async function countPages(input: { fileUrl?: string; contentBase64?: string }): Promise {\n const bytes = await docBytes(input);\n if (!bytes) return 1;\n try {\n const { PDFDocument } = await import(\"npm:pdf-lib\"); // dynamic so an import error can't kill the val\n const doc = await PDFDocument.load(bytes, { updateMetadata: false });\n return Math.max(1, doc.getPageCount());\n } catch {\n return 1; // non-PDF / unparseable → bill a single page\n }\n}\n\n/** Total price for a piece of mail, in USD (string, 2dp). */\nexport function amountForMail(type: MailType, pages: number): string {\n if (type === \"postcard\") return postcardUsd().toFixed(2);\n return (baseFeeUsd() + Math.max(1, pages) * perPageUsd()).toFixed(2);\n}\n\n// --- mppx client ------------------------------------------------------------\n\nfunction signer() {\n const k = Deno.env.get(\"MPP_SIGNER_KEY\");\n return k ? privateKeyToAccount(k as `0x${string}`) : undefined;\n}\n\nlet _client: ReturnType | null = null;\nfunction client() {\n // secretKey from MPP_SECRET_KEY; mainnet + USDC.e are the tempo() defaults.\n // `account` is a server signer tempo() requires (session settlement; unused by charge).\n _client ??= Mppx.create({ methods: [tempo({ recipient: recipient(), account: signer() })] });\n return _client;\n}\n\n/** Hono middleware: price the piece (letter = base + pages×rate; postcard =\n * flat) and charge it. Lazily inits so a config error only affects this route,\n * not the whole val. */\nexport function chargeMail() {\n return async (c: any, next: any) => {\n let body: any = {};\n try {\n body = await c.req.json();\n } catch {\n body = {};\n }\n const type: MailType = body?.type === \"postcard\" ? \"postcard\" : \"letter\";\n const pages = type === \"letter\"\n ? await countPages({\n fileUrl: body?.file_url ? String(body.file_url) : undefined,\n contentBase64: body?.content_base64 ? String(body.content_base64) : undefined,\n })\n : 1;\n const amount = amountForMail(type, pages);\n c.set(\"mailType\", type);\n c.set(\"mailPages\", pages);\n c.set(\"mailAmount\", amount);\n return client().charge({ amount })(c, next);\n };\n}\n\nexport function paymentInfo() {\n const r = recipient();\n return {\n protocol: \"mpp\",\n method: \"tempo\",\n network: \"tempo\",\n chainId: 4217,\n asset: USDC_E,\n pricing: {\n model: \"per_piece\",\n base_fee_usd: baseFeeUsd(),\n per_page_usd: perPageUsd(),\n postcard_usd: postcardUsd(),\n currency: \"USDC.e\",\n },\n price: priceLabel(),\n recipient: r,\n payTo: r, // alias for UI compatibility\n facilitator: \"none (settles via Tempo RPC)\",\n mode: \"mpp\",\n payableBy: [\"tempo-mpp\"],\n };\n}\n",[183],"c30a1c4a-5ba5-11f1-8826-ee650bb23af1","main.ts","019e75a2-f04c-7499-b28f-586d0727a187",6,["D",1780090292498],"http","// AgentSnailMail — a print-and-mail API for AI agents, paid per piece over\n// Tempo/MPP (USDC.e). An agent triggers it to send out *real, physical* mail.\n//\n// No signup, no API key (for the agent): it calls POST /v1/mail with a recipient\n// address and either a letter document or postcard artwork, gets back a 402 with\n// an MPP \"Payment\" challenge, pays in USDC.e on Tempo, and the mail goes out via\n// Lob. Pay in one line with the Tempo CLI:\n// tempo request -X POST --json '{...}' /v1/mail\n//\n// We never store the mail contents — they're forwarded to the print/mail network\n// and dropped. We keep only a minimal metadata log (destination city/state/zip,\n// type, pages, amount, paying wallet). Status is read live from the provider.\nimport { Hono } from \"npm:hono\";\nimport { parseVal, serveFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { activeProvider, decodeJobId, getStatus, isLive, type MailInput, sendMail, validateInput } from \"./mail.ts\";\nimport {\n amountForMail,\n baseFeeUsd,\n chargeMail,\n paymentInfo,\n perPageUsd,\n postcardUsd,\n priceLabel,\n recipient,\n USDC_E,\n} from \"./mpp.ts\";\nimport { renderPage } from \"./frontend/render.tsx\";\nimport { renderOg } from \"./og.ts\";\nimport { logMail, mailStats, mailStatsSafe } from \"./db.ts\";\nimport { notifyPaidMail } from \"./notify.ts\";\n\nconst app = new Hono();\n\nconst origin = (c: { req: { url: string } }) => new URL(c.req.url).origin;\n\n// Best-effort: pull the paying wallet from the MPP credential (the address that\n// isn't our recipient). Returns null if it can't be read — metadata only.\nfunction decodePayer(authHeader: string | undefined, recip: string): string | null {\n if (!authHeader) return null;\n try {\n const json = atob(authHeader.replace(/^Payment\\s+/i, \"\").trim().replace(/-/g, \"+\").replace(/_/g, \"/\"));\n const addrs = [...json.matchAll(/0x[a-fA-F0-9]{40}/g)].map((m) => m[0]);\n return addrs.find((a) => a.toLowerCase() !== recip.toLowerCase()) ?? null;\n } catch {\n return null;\n }\n}\n\n// Parse the request body into a MailInput. `to`/`from` accept either nested\n// objects or flat snake_case fields for CLI ergonomics.\nfunction parseAddress(raw: any): any {\n if (!raw || typeof raw !== \"object\") return undefined;\n return {\n name: raw.name ?? raw.full_name,\n line1: raw.line1 ?? raw.address_line1,\n line2: raw.line2 ?? raw.address_line2,\n city: raw.city ?? raw.address_city,\n state: raw.state ?? raw.address_state,\n zip: raw.zip ?? raw.address_zip,\n country: raw.country ?? raw.address_country,\n };\n}\n\nfunction toMailInput(body: Record): MailInput {\n return {\n type: (body.type === \"postcard\" ? \"postcard\" : \"letter\"),\n to: parseAddress(body.to),\n from: body.from ? parseAddress(body.from) : undefined,\n fileUrl: body.file_url ? String(body.file_url) : undefined,\n contentBase64: body.content_base64 ? String(body.content_base64) : undefined,\n fileName: body.file_name ? String(body.file_name) : undefined,\n front: body.front ? String(body.front) : undefined,\n back: body.back ? String(body.back) : undefined,\n message: body.message ? String(body.message) : undefined,\n color: body.color === undefined ? undefined : Boolean(body.color),\n size: body.size ? String(body.size) : undefined,\n };\n}\n\n// --- Landing page (SSR) -----------------------------------------------------\napp.get(\"/\", async (c) =>\n c.html(renderPage({\n baseUrl: origin(c),\n payment: paymentInfo(),\n provider: activeProvider(),\n live: isLive(),\n price: priceLabel(),\n stats: await mailStatsSafe(500),\n })));\n\n// View source (required for Val Town UIs)\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\n// Static frontend assets (favicon, client demo script)\napp.get(\"/frontend/*\", (c) => serveFile(c.req.path));\n\n// Social card image (Open Graph / Twitter)\napp.get(\"/og.png\", () => renderOg());\n\n// --- Discovery manifest -----------------------------------------------------\nfunction manifest(base: string) {\n return {\n name: \"agentsnailmail\",\n description:\n \"Send real, physical mail (letters & postcards) to any address. Paid per piece in USDC.e over Tempo/MPP — no signup, no API key.\",\n data_retention:\n \"mail contents are never stored; only minimal send metadata is logged (destination city/state/zip, type, pages, amount, payer)\",\n payment: paymentInfo(),\n endpoints: {\n send_mail: {\n method: \"POST\",\n path: \"/v1/mail\",\n paid: true,\n body: {\n type: '\"letter\" | \"postcard\" — required',\n to: \"address object { name, line1, line2?, city, state, zip, country? } — required\",\n from: \"address object (optional return address; a default is used otherwise)\",\n file_url: \"string (public PDF URL) — letters: provide this or content_base64\",\n content_base64: \"string (base64 PDF bytes) — letters\",\n file_name: \"string (optional, used with content_base64)\",\n front: \"string (postcards: PDF/PNG URL or inline HTML for the front)\",\n back: \"string (postcards: PDF/PNG URL or inline HTML for the back)\",\n message: \"string (postcards: simple text for the back, if no `back` artwork)\",\n color: \"boolean (letters: color vs B&W, default false)\",\n size: 'string (postcards: \"4x6\" | \"6x9\" | \"6x11\", default \"4x6\")',\n metadata: \"object (optional, echoed back, not stored)\",\n },\n returns: { id: \"string\", type: \"string\", status: \"queued|processing|mailed|delivered|failed\", expected_delivery: \"string|null\" },\n },\n get_mail: { method: \"GET\", path: \"/v1/mail/{id}\", paid: false, note: \"live status from the mail network\" },\n info: { method: \"GET\", path: \"/v1/info\", paid: false },\n },\n example: {\n tempo_cli:\n `tempo request -X POST --json '{\"type\":\"letter\",\"to\":{\"name\":\"Jane Doe\",\"line1\":\"210 King St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip\":\"94107\"},\"file_url\":\"https://example.com/letter.pdf\"}' ${base}/v1/mail`,\n curl:\n `curl -X POST ${base}/v1/mail -H 'content-type: application/json' -d '{\"type\":\"postcard\",\"to\":{\"name\":\"Jane Doe\",\"line1\":\"210 King St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip\":\"94107\"},\"message\":\"Hello from my agent!\"}'`,\n note:\n \"Without payment this returns HTTP 402 with an MPP 'Payment' challenge. The Tempo CLI (or any MPP client) pays in USDC.e and retries automatically.\",\n },\n };\n}\napp.get(\"/v1/info\", (c) => c.json(manifest(origin(c))));\n\n// MPP discovery document (OpenAPI 3.1 + x-payment-info / x-service-info) so\n// registries like MPPScan can index the service.\napp.get(\"/openapi.json\", (c) => {\n const base = origin(c);\n return c.json({\n openapi: \"3.1.0\",\n info: {\n title: \"agentsnailmail\",\n version: \"1.0.0\",\n description:\n \"Pay-per-piece API for AI agents to send real, physical mail — letters & postcards to any address, priced per piece in USDC.e over Tempo/MPP.\",\n \"x-guidance\":\n \"Send physical mail by POSTing to /v1/mail with `type` (\\\"letter\\\" or \\\"postcard\\\"), a `to` address object ({name, line1, city, state, zip}), and content: letters need `file_url` (a public PDF URL) or `content_base64`; postcards need `front` artwork and a `back`/`message`. Pricing is per piece in USDC.e on Tempo via MPP: letters are a base fee + per page, postcards a flat rate. An unpaid request returns HTTP 402 with a payment challenge — pay it with any MPP client (e.g. `tempo request`) and retry the same request. The mail contents are forwarded to the print/mail network and never stored. Poll GET /v1/mail/{id} for live delivery status.\",\n },\n servers: [{ url: base }],\n \"x-service-info\": {\n name: \"agentsnailmail\",\n description:\n \"Send real, physical mail (letters & postcards) to any address, priced per piece in USDC.e over Tempo/MPP. No signup, no API key; mail contents are never stored.\",\n categories: [\"social\"],\n tags: [\"mail\", \"snail-mail\", \"letters\", \"postcards\", \"agents\", \"tempo\", \"mpp\", \"lob\"],\n docs: { homepage: base, apiReference: `${base}/v1/info`, llms: `${base}/llms.txt` },\n },\n paths: {\n \"/v1/mail\": {\n post: {\n summary: \"Send physical mail\",\n description: \"Send a real letter or postcard to a mailing address, priced per piece. Pay with MPP (USDC.e on Tempo).\",\n requestBody: {\n required: true,\n content: {\n \"application/json\": {\n schema: {\n type: \"object\",\n required: [\"type\", \"to\"],\n properties: {\n type: { type: \"string\", enum: [\"letter\", \"postcard\"], description: \"What to send\" },\n to: {\n type: \"object\",\n description: \"Recipient mailing address\",\n required: [\"name\", \"line1\", \"city\", \"state\", \"zip\"],\n properties: {\n name: { type: \"string\" },\n line1: { type: \"string\" },\n line2: { type: \"string\" },\n city: { type: \"string\" },\n state: { type: \"string\", description: \"2-letter state/province\" },\n zip: { type: \"string\" },\n country: { type: \"string\", description: \"ISO-2, default US\" },\n },\n },\n from: { type: \"object\", description: \"Optional return address (same shape as `to`)\" },\n file_url: { type: \"string\", description: \"Letters: public URL to a PDF (provide this or content_base64)\" },\n content_base64: { type: \"string\", description: \"Letters: base64-encoded PDF bytes\" },\n front: { type: \"string\", description: \"Postcards: front artwork (PDF/PNG URL or HTML)\" },\n back: { type: \"string\", description: \"Postcards: back artwork (PDF/PNG URL or HTML)\" },\n message: { type: \"string\", description: \"Postcards: simple back message if no `back` artwork\" },\n color: { type: \"boolean\", description: \"Letters: color vs B&W (default false)\" },\n size: { type: \"string\", description: 'Postcards: \"4x6\" | \"6x9\" | \"6x11\" (default 4x6)' },\n metadata: { type: \"object\", description: \"Optional, echoed back in the response\" },\n },\n },\n },\n },\n },\n \"x-payment-info\": {\n price: {\n mode: \"dynamic\",\n currency: \"USD\",\n min: amountForMail(\"postcard\", 1),\n max: amountForMail(\"letter\", 100),\n unit: \"piece\",\n },\n protocols: [{\n mpp: {\n method: \"tempo\",\n network: \"tempo\",\n chainId: 4217,\n asset: USDC_E.address,\n amount: String(Math.round((baseFeeUsd() + perPageUsd()) * 1e6)),\n recipient: recipient(),\n },\n }],\n offers: [{\n method: \"tempo\",\n intent: \"charge\",\n currency: USDC_E.address,\n amount: String(Math.round((baseFeeUsd() + perPageUsd()) * 1e6)),\n description:\n `Letters: $${baseFeeUsd().toFixed(2)} base + $${perPageUsd().toFixed(2)}/page. Postcards: flat $${\n postcardUsd().toFixed(2)\n }. In ${USDC_E.symbol}.`,\n }],\n },\n responses: {\n \"200\": {\n description: \"Mail accepted; returns a job id and live status.\",\n content: {\n \"application/json\": {\n schema: {\n type: \"object\",\n properties: {\n id: { type: \"string\", description: \"Mail job id (use with GET /v1/mail/{id})\" },\n type: { type: \"string\", description: \"letter | postcard\" },\n status: { type: \"string\", description: \"queued | processing | mailed | delivered | failed\" },\n pages: { type: \"integer\", description: \"Number of pages (letters)\" },\n expected_delivery: { type: \"string\", description: \"Estimated delivery date (YYYY-MM-DD)\" },\n price_usd: { type: \"string\", description: \"Total charged, in USD\" },\n },\n },\n },\n },\n },\n \"402\": { description: \"Payment Required — pay the MPP challenge and retry.\" },\n },\n },\n },\n },\n });\n});\n\n// llms.txt — point agents at the manifest so they can self-onboard.\napp.get(\"/llms.txt\", (c) => {\n const base = origin(c);\n return c.text(\n `# agentsnailmail\n\n> A pay-per-piece HTTP API for AI agents to send real, physical mail. Send letters & postcards to any address and pay per piece in USDC.e over Tempo/MPP — no signup, no API key. Mail contents are never stored; only minimal send metadata is logged.\n\n## Docs\n- [Machine-readable manifest](${base}/v1/info): payment terms (network, asset, price, recipient), the request schema, and a ready-to-run example.\n- [Homepage](${base}/): overview and a live payment demo.\n\n## Using it\n- POST ${base}/v1/mail with {\"type\":\"letter\",\"to\":{\"name\":\"Jane Doe\",\"line1\":\"210 King St\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip\":\"94107\"},\"file_url\":\"https://.../letter.pdf\"}. For a postcard use {\"type\":\"postcard\", ..., \"message\":\"Hi!\"}. An unpaid request returns HTTP 402 with an MPP Payment challenge; pay with the Tempo CLI (\\`tempo request\\`) or any MPP client and retry.\n- GET ${base}/v1/mail/{id}: live delivery status.\n`,\n 200,\n { \"content-type\": \"text/plain; charset=utf-8\" },\n );\n});\n\n// --- Read mail status (free, proxied live — we hold no state) ---------------\napp.get(\"/v1/mail/:id\", async (c) => {\n const id = c.req.param(\"id\");\n const decoded = decodeJobId(id);\n if (!decoded) return c.json({ error: \"bad_id\", id }, 400);\n const s = await getStatus(id).catch(() => null);\n if (!s) return c.json({ error: \"not_found\", id }, 404);\n return c.json({\n id,\n type: decoded.type,\n status: s.status,\n pages: s.pages,\n expected_delivery: s.expectedDelivery ?? null,\n error: s.error ?? null,\n _links: { self: `${origin(c)}/v1/mail/${id}` },\n });\n});\n\n// --- Send mail (paid via Tempo/MPP) -----------------------------------------\napp.post(\"/v1/mail\", chargeMail(), async (c) => {\n let body: Record = {};\n try {\n body = await c.req.json();\n } catch {\n return c.json({ error: \"invalid_json\", message: \"Request body must be JSON.\" }, 400);\n }\n\n const input = toMailInput(body);\n\n const validationError = validateInput(input);\n if (validationError) return c.json({ error: \"invalid_request\", message: validationError }, 400);\n\n const result = await sendMail(input);\n if (!result.jobId && result.status === \"failed\") {\n return c.json({ error: \"provider_error\", message: result.error ?? \"Failed to submit mail.\" }, 502);\n }\n\n const pages = (c.get(\"mailPages\") as number) ?? result.pages;\n const amount = (c.get(\"mailAmount\") as string) ?? null;\n const payer = decodePayer(c.req.header(\"Authorization\"), recipient());\n const created_at = new Date().toISOString();\n\n // Log innocuous metadata only — never the mail contents. Best-effort; never blocks the mailing.\n try {\n await logMail({\n id: result.jobId,\n type: result.type,\n toCity: input.to?.city ?? null,\n toState: input.to?.state ?? null,\n toZip: input.to?.zip ?? null,\n pages,\n amount,\n payer,\n network: \"tempo\",\n provider: result.provider,\n status: result.status,\n created_at,\n });\n } catch (_e) { /* metadata is best-effort */ }\n\n // 🎉 Email the owner that someone paid to send mail. Best-effort; never blocks the mailing.\n try {\n await notifyPaidMail({\n id: result.jobId,\n type: result.type,\n toCity: input.to?.city ?? null,\n toState: input.to?.state ?? null,\n toZip: input.to?.zip ?? null,\n pages,\n amount,\n payer,\n network: \"tempo\",\n provider: result.provider,\n status: result.status,\n expectedDelivery: result.expectedDelivery,\n live: isLive(),\n created_at,\n totals: await mailStats().catch(() => undefined),\n });\n } catch (_e) { /* notification is best-effort */ }\n\n return c.json({\n id: result.jobId,\n type: result.type,\n status: result.status,\n pages,\n expected_delivery: result.expectedDelivery ?? null,\n provider: result.provider,\n live: isLive(),\n price_usd: amount ? `${amount}` : priceLabel(),\n pricing: \"per_piece\",\n error: result.error ?? null,\n metadata: body.metadata ?? undefined,\n created_at,\n _links: { self: `${origin(c)}/v1/mail/${result.jobId}` },\n }, 200);\n});\n\n// Unwrap Hono errors so logs show real stack traces.\napp.onError((err) => Promise.reject(err));\n\nexport default app.fetch;\n",[190],"7ffcd1cc-5ba5-11f1-8826-ee650bb23af1","mail.ts","7ffcd276-5ba5-11f1-8826-ee650bb23af1",2,["D",1780090180006],"// Pluggable print-and-mail backend.\n//\n// The document is never stored — it's forwarded to the print/mail network and\n// dropped; we hand back a job id and read status live from the provider. (A\n// separate metadata log in db.ts records send info only — never the document.)\n//\n// Live: Lob Print & Mail API (https://docs.lob.com). A *live* secret key\n// (live_...) sends real, physical mail. A *test* secret key (test_...) — or no\n// key at all (built-in sandbox) — simulates sending so the full pay -> mail loop\n// is demoable without a Lob account or real postage.\n\nexport type MailStatus = \"queued\" | \"processing\" | \"mailed\" | \"delivered\" | \"failed\";\nexport type Provider = \"lob\" | \"lob_test\" | \"sandbox\";\nexport type MailType = \"letter\" | \"postcard\";\n\nexport interface Address {\n name: string;\n line1: string;\n line2?: string;\n city: string;\n state: string;\n zip: string;\n country?: string; // ISO-2, default \"US\"\n}\n\nexport interface MailInput {\n type: MailType;\n to: Address;\n from?: Address; // optional return address (Lob requires one; we supply a default)\n // Letters: a printable document.\n fileUrl?: string; // public URL to a PDF (preferred — Lob fetches it)\n contentBase64?: string; // base64-encoded PDF bytes\n fileName?: string; // used with contentBase64\n // Postcards: front/back artwork (URL to PDF/PNG or inline HTML).\n front?: string;\n back?: string;\n message?: string; // simple postcard back message (if no `back` artwork)\n color?: boolean; // letters: color vs black & white (default false)\n size?: string; // postcards: \"4x6\" | \"6x9\" | \"6x11\" (default \"4x6\")\n}\n\nexport interface MailSendResult {\n provider: Provider;\n jobId: string; // opaque, provider-namespaced id we hand back to the caller\n type: MailType;\n status: MailStatus;\n pages: number | null;\n expectedDelivery?: string | null;\n error?: string;\n}\n\n// --- Default return address -------------------------------------------------\n// Lob requires a `from` address. Callers may override per-request; otherwise we\n// use MAIL_FROM_* env vars, falling back to a generic placeholder.\nfunction defaultFrom(): Address {\n return {\n name: Deno.env.get(\"MAIL_FROM_NAME\") || \"AgentSnailMail\",\n line1: Deno.env.get(\"MAIL_FROM_LINE1\") || \"210 King St\",\n line2: Deno.env.get(\"MAIL_FROM_LINE2\") || undefined,\n city: Deno.env.get(\"MAIL_FROM_CITY\") || \"San Francisco\",\n state: Deno.env.get(\"MAIL_FROM_STATE\") || \"CA\",\n zip: Deno.env.get(\"MAIL_FROM_ZIP\") || \"94107\",\n country: Deno.env.get(\"MAIL_FROM_COUNTRY\") || \"US\",\n };\n}\n\nfunction lobKey(): string | undefined {\n return Deno.env.get(\"LOB_API_KEY\")?.trim() || undefined;\n}\n\nexport function activeProvider(): Provider {\n const k = lobKey();\n if (!k) return \"sandbox\";\n return k.startsWith(\"live_\") ? \"lob\" : \"lob_test\";\n}\n\n/** True when real, physical mail will be sent (a live_ Lob key is configured). */\nexport function isLive(): boolean {\n return activeProvider() === \"lob\";\n}\n\n// --- Input handling ---------------------------------------------------------\n\nfunction validateAddress(a: Address | undefined, label: string): string | null {\n if (!a || typeof a !== \"object\") return `\\`${label}\\` must be an address object.`;\n if (!a.name?.trim()) return `\\`${label}.name\\` is required.`;\n if (!a.line1?.trim()) return `\\`${label}.line1\\` is required.`;\n if (!a.city?.trim()) return `\\`${label}.city\\` is required.`;\n if (!a.state?.trim()) return `\\`${label}.state\\` is required (2-letter state/province).`;\n if (!a.zip?.trim()) return `\\`${label}.zip\\` is required.`;\n return null;\n}\n\nexport function validateInput(input: MailInput): string | null {\n if (input.type !== \"letter\" && input.type !== \"postcard\") {\n return \"`type` must be either \\\"letter\\\" or \\\"postcard\\\".\";\n }\n const toErr = validateAddress(input.to, \"to\");\n if (toErr) return toErr;\n if (input.from) {\n const fromErr = validateAddress(input.from, \"from\");\n if (fromErr) return fromErr;\n }\n if (input.type === \"letter\") {\n if (!input.fileUrl && !input.contentBase64) {\n return \"Letters need a document via `file_url` (a public PDF URL) or `content_base64`.\";\n }\n if (input.fileUrl && !/^https?:\\/\\//.test(input.fileUrl)) {\n return \"`file_url` must be an http(s) URL.\";\n }\n } else {\n // postcard\n if (!input.front && !input.message) {\n return \"Postcards need `front` artwork (a PDF/PNG URL or HTML) — and a `back` or `message`.\";\n }\n }\n return null;\n}\n\n// --- Job id (provider-namespaced, carries no payload) -----------------------\n\nfunction prefixFor(p: Provider): string {\n return p === \"lob\" ? \"lob\" : p === \"lob_test\" ? \"lbt\" : \"sbx\";\n}\n\nexport function encodeJobId(provider: Provider, type: MailType, providerRef: string): string {\n return `${prefixFor(provider)}_${type === \"postcard\" ? \"pc\" : \"ltr\"}_${providerRef}`;\n}\n\nexport function decodeJobId(id: string): { provider: Provider; type: MailType; ref: string } | null {\n const parts = id.split(\"_\");\n if (parts.length < 3) return null;\n const [prefix, kind, ...rest] = parts;\n const provider: Provider | null = prefix === \"lob\" ? \"lob\" : prefix === \"lbt\" ? \"lob_test\" : prefix === \"sbx\" ? \"sandbox\" : null;\n if (!provider) return null;\n const type: MailType | null = kind === \"pc\" ? \"postcard\" : kind === \"ltr\" ? \"letter\" : null;\n if (!type) return null;\n return { provider, type, ref: rest.join(\"_\") };\n}\n\n// --- Send -------------------------------------------------------------------\n\nexport async function sendMail(input: MailInput): Promise {\n return activeProvider() === \"sandbox\" ? sendViaSandbox(input) : sendViaLob(input);\n}\n\n/** Live status lookup — no local state. */\nexport async function getStatus(\n jobId: string,\n): Promise<{ status: MailStatus; pages: number | null; expectedDelivery?: string | null; error?: string } | null> {\n const decoded = decodeJobId(jobId);\n if (!decoded) return null;\n return decoded.provider === \"sandbox\" ? sandboxStatus(decoded.ref) : lobStatus(decoded.type, decoded.ref);\n}\n\n// --- Lob Print & Mail API ---------------------------------------------------\n\nconst LOB_BASE = \"https://api.lob.com/v1\";\n\nfunction lobAuthHeader(): string {\n // Basic auth: API key as username, blank password.\n return \"Basic \" + btoa(`${lobKey()}:`);\n}\n\nfunction lobAddress(a: Address): Record {\n return {\n name: a.name,\n address_line1: a.line1,\n ...(a.line2 ? { address_line2: a.line2 } : {}),\n address_city: a.city,\n address_state: a.state,\n address_zip: a.zip,\n address_country: a.country || \"US\",\n };\n}\n\nasync function sendViaLob(input: MailInput): Promise {\n const provider = activeProvider(); // \"lob\" or \"lob_test\"\n const from = input.from ?? defaultFrom();\n const form = new FormData();\n\n // Addresses (inline objects via bracketed form fields).\n for (const [k, v] of Object.entries(lobAddress(input.to))) form.append(`to[${k}]`, v);\n for (const [k, v] of Object.entries(lobAddress(from))) form.append(`from[${k}]`, v);\n\n let endpoint: string;\n if (input.type === \"letter\") {\n endpoint = `${LOB_BASE}/letters`;\n form.append(\"color\", String(!!input.color));\n form.append(\"address_placement\", \"top_first_page\");\n if (input.fileUrl) {\n form.append(\"file\", input.fileUrl);\n } else if (input.contentBase64) {\n const blob = new Blob([base64ToBytes(input.contentBase64)], { type: \"application/pdf\" });\n form.append(\"file\", blob, input.fileName || \"letter.pdf\");\n }\n } else {\n endpoint = `${LOB_BASE}/postcards`;\n form.append(\"size\", input.size || \"4x6\");\n form.append(\"front\", input.front || \"Hello!\");\n form.append(\n \"back\",\n input.back || `${escapeHtml(input.message || \"\")}`,\n );\n }\n\n let res: Response;\n try {\n res = await fetch(endpoint, {\n method: \"POST\",\n headers: { Authorization: lobAuthHeader() },\n body: form,\n });\n } catch (e) {\n return { provider, jobId: \"\", type: input.type, status: \"failed\", pages: null, error: String((e as Error).message) };\n }\n\n const j = await res.json().catch(() => ({} as any));\n if (!res.ok || !j?.id) {\n return {\n provider,\n jobId: \"\",\n type: input.type,\n status: \"failed\",\n pages: null,\n error: j?.error?.message || `Lob error (HTTP ${res.status})`,\n };\n }\n return {\n provider,\n jobId: encodeJobId(provider, input.type, String(j.id)),\n type: input.type,\n status: mapLobStatus(j),\n pages: typeof j.pages === \"number\" ? j.pages : input.type === \"postcard\" ? 1 : null,\n expectedDelivery: j.expected_delivery_date ?? null,\n };\n}\n\nasync function lobStatus(\n type: MailType,\n ref: string,\n): Promise<{ status: MailStatus; pages: number | null; expectedDelivery?: string | null; error?: string }> {\n const path = type === \"postcard\" ? \"postcards\" : \"letters\";\n const res = await fetch(`${LOB_BASE}/${path}/${encodeURIComponent(ref)}`, {\n headers: { Authorization: lobAuthHeader() },\n });\n const j = await res.json().catch(() => ({} as any));\n return {\n status: mapLobStatus(j),\n pages: typeof j?.pages === \"number\" ? j.pages : null,\n expectedDelivery: j?.expected_delivery_date ?? null,\n error: j?.error?.message || undefined,\n };\n}\n\n// Lob tracking events drive real status; on create the object has no events yet.\n// We derive a coarse status from the latest tracking event name when present.\nexport function mapLobStatus(j: any): MailStatus {\n const events: any[] = Array.isArray(j?.tracking_events) ? j.tracking_events : [];\n const latest = events.length ? String(events[events.length - 1].name || \"\").toLowerCase() : \"\";\n if (latest.includes(\"delivered\")) return \"delivered\";\n if (latest.includes(\"returned\") || latest.includes(\"failed\")) return \"failed\";\n if (latest.includes(\"in_transit\") || latest.includes(\"in_local_area\") || latest.includes(\"processed\")) return \"mailed\";\n if (latest.includes(\"mailed\")) return \"mailed\";\n // No events yet: it's been accepted and is being produced.\n return j?.id ? \"processing\" : \"queued\";\n}\n\n// --- Sandbox (stateless: outcome is encoded in the job ref) -----------------\n// A \"to\" zip of 00000 simulates a failure, so the failure path is demoable.\n\nfunction sendViaSandbox(input: MailInput): MailSendResult {\n const willFail = (input.to.zip || \"\").trim() === \"00000\";\n const status: MailStatus = willFail ? \"failed\" : \"processing\";\n const ref = `${status}.${crypto.randomUUID().slice(0, 8)}`;\n const expected = new Date(Date.now() + 5 * 86400_000).toISOString().slice(0, 10);\n return {\n provider: \"sandbox\",\n jobId: encodeJobId(\"sandbox\", input.type, ref),\n type: input.type,\n status,\n pages: input.type === \"postcard\" ? 1 : (status === \"failed\" ? null : 1),\n expectedDelivery: willFail ? null : expected,\n error: willFail ? \"undeliverable_address (simulated)\" : undefined,\n };\n}\n\nfunction sandboxStatus(ref: string): { status: MailStatus; pages: number | null; expectedDelivery?: string | null; error?: string } {\n const status = (ref.split(\".\")[0] as MailStatus) || \"processing\";\n const expected = new Date(Date.now() + 5 * 86400_000).toISOString().slice(0, 10);\n return {\n status,\n pages: status === \"failed\" ? null : 1,\n expectedDelivery: status === \"failed\" ? null : expected,\n error: status === \"failed\" ? \"undeliverable_address (simulated)\" : undefined,\n };\n}\n\n// --- helpers ----------------------------------------------------------------\n\nfunction escapeHtml(s: string): string {\n return s.replace(/&/g, \"&\").replace(//g, \">\");\n}\n\nfunction base64ToBytes(b64: string): Uint8Array {\n const bin = atob(b64.replace(/^data:.*;base64,/, \"\"));\n const out = new Uint8Array(bin.length);\n for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);\n return out;\n}\n",[198],"981ae44c-5ba5-11f1-9682-ee650bb23af1","db.ts","019e75a2-f04c-7499-b28f-50026d0c1ed3",4,["D",1780090220450],"// Minimal metadata log — NEVER the document content. We record only innocuous\n// send metadata (destination city/state/zip, mail type, pages, amount, paying\n// wallet) so we can show a running total and basic analytics. The mail payload\n// (the actual letter/postcard contents) is never persisted.\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\nconst TABLE = \"mail_log_v1\";\n\nlet ready: Promise | null = null;\nfunction init(): Promise {\n ready ??= sqlite\n .execute(`CREATE TABLE IF NOT EXISTS ${TABLE} (\n id TEXT PRIMARY KEY,\n mail_type TEXT,\n to_city TEXT,\n to_state TEXT,\n to_zip TEXT,\n pages INTEGER,\n amount_usd TEXT,\n payer TEXT,\n network TEXT,\n provider TEXT,\n status TEXT,\n created_at TEXT NOT NULL\n )`)\n .then(() => undefined);\n return ready;\n}\n\nexport interface MailLog {\n id: string;\n type: string;\n toCity: string | null;\n toState: string | null;\n toZip: string | null;\n pages: number | null;\n amount: string | null;\n payer: string | null;\n network: string;\n provider: string;\n status: string;\n created_at: string;\n}\n\nexport interface MailStats {\n pieces: number;\n pages: number;\n paidUsd: number;\n /** Cumulative pieces over time (oldest→newest), for a sparkline. */\n series: number[];\n}\n\nexport async function logMail(rec: MailLog): Promise {\n await init();\n await sqlite.execute({\n sql: `INSERT OR REPLACE INTO ${TABLE}\n (id, mail_type, to_city, to_state, to_zip, pages, amount_usd, payer, network, provider, status, created_at)\n VALUES (?,?,?,?,?,?,?,?,?,?,?,?)`,\n args: [\n rec.id,\n rec.type,\n rec.toCity,\n rec.toState,\n rec.toZip,\n rec.pages,\n rec.amount,\n rec.payer,\n rec.network,\n rec.provider,\n rec.status,\n rec.created_at,\n ],\n });\n}\n\n// Downsample a series to at most `max` points so the sparkline stays light as\n// the log grows. Always keeps the last point (the current total).\nfunction downsample(values: number[], max: number): number[] {\n if (values.length <= max) return values;\n const step = (values.length - 1) / (max - 1);\n return Array.from({ length: max }, (_, i) => values[Math.round(i * step)]);\n}\n\nexport async function mailStats(): Promise {\n await init();\n const { rows } = await sqlite.execute(\n `SELECT pages, amount_usd FROM ${TABLE} ORDER BY created_at ASC LIMIT 1000`,\n );\n let pages = 0;\n let paidUsd = 0;\n const series: number[] = [];\n let count = 0;\n for (const row of rows as unknown as { pages: number | null; amount_usd: string | null }[]) {\n pages += Number(row.pages ?? 0);\n paidUsd += Number.parseFloat(row.amount_usd ?? \"\") || 0;\n count += 1;\n series.push(count);\n }\n return { pieces: rows.length, pages, paidUsd, series: downsample(series, 48) };\n}\n\n// Page-load wrapper: race the query against a hard timeout so a slow/unavailable\n// DB never blocks the landing page. Returns null on timeout, error, or no data —\n// the caller drops the stats widget entirely in that case.\nexport async function mailStatsSafe(timeoutMs = 500): Promise {\n let timer: number | undefined;\n const stats = await Promise.race([\n mailStats().catch(() => null),\n new Promise((resolve) => {\n timer = setTimeout(() => resolve(null), timeoutMs);\n }),\n ]);\n clearTimeout(timer);\n if (!stats || stats.pieces === 0) return null;\n return stats;\n}\n",[205],"405007e2-5ba5-11f1-b599-ee650bb23af1","README.md","019e75a2-f04c-7499-b28f-4f9f137955ed",["D",1780090073094],"# agentfax\n\nA fax API for AI agents — **paid per page over [Tempo/MPP](https://mpp.dev) (USDC.e)**. No signup, no\nAPI key, no dashboard. An agent calls one endpoint, gets a `402 Payment Required` with an MPP `Payment`\nchallenge, pays in USDC.e on Tempo, and the fax goes out. It's \"AgentMail, but for faxes.\"\n\nPay it in one line with the Tempo CLI:\n\n```bash\ntempo request -X POST --json '{\"to\":\"+14155550123\",\"file_url\":\"https://example.com/doc.pdf\"}' \\\n https://agentfax.val.run/v1/fax\n```\n\n## Why it's interesting\n\n- **Permissionless monetization.** No marketplace to apply to. You stand up an HTTP endpoint that\n returns a 402 `WWW-Authenticate: Payment` challenge pointing at your wallet; any MPP client pays it.\n- **No facilitator, no keys to babysit.** `mppx` verifies and settles the payment directly against the\n Tempo chain — there's no payment processor in the middle.\n- **Per-page pricing.** On the unpaid request we count the PDF's pages and price the charge as\n pages × rate, so the 402 tells the agent the exact cost up front.\n- **Documents are never stored.** The file is forwarded to the fax network and dropped — it never\n touches our database. We keep only a minimal send-metadata log (destination, pages, amount, payer).\n- **Pluggable fax backend.** Real faxing via the [Sinch Fax API v3](https://developers.sinch.com/docs/fax/)\n when keys are set; otherwise a **sandbox** that simulates sending, so the whole pay→fax loop works with\n no fax account.\n\n## Endpoints\n\n| Method | Path | Paid | Description |\n|--------|------|------|-------------|\n| `POST` | `/v1/fax` | ✅ MPP | Send a fax. Returns `402` (MPP `Payment` challenge) until paid, then a job id. |\n| `GET` | `/v1/fax/{id}` | free | Live delivery status (proxied from the carrier). |\n| `GET` | `/v1/info` | free | Machine-readable manifest (price, network, recipient, schema, example). |\n| `GET` | `/openapi.json` | free | MPP discovery document (for registries like MPPScan). |\n| `GET` | `/llms.txt` | free | Pointer file so an agent can self-onboard. |\n| `GET` | `/og.png` | free | Social card image. |\n\n### Send a fax\n\n`to` is required (E.164). Provide the document as either `file_url` (a public PDF URL) or\n`content_base64` (+ optional `file_name`). `metadata` is optional and echoed back.\n\nUnpaid, `POST /v1/fax` returns `402` with a `WWW-Authenticate: Payment` header. The Tempo CLI (or any\nMPP client) reads it, signs the USDC.e payment, and retries automatically.\n\n## Payments\n\n- **Rail:** MPP (the open `Payment` HTTP-auth scheme) on **Tempo mainnet** (chain id 4217).\n- **Asset:** USDC.e — `0x20C000000000000000000000b9537d11c60E8b50` (6 decimals).\n- **Price:** per page (`FAX_PRICE_PER_PAGE`, default `$0.20`).\n- **Settlement:** verified directly against the Tempo RPC by `mppx` — no facilitator.\n- **You get paid** at `TEMPO_RECIPIENT` (your Tempo wallet).\n- **x402 (Coinbase / Circle) is parked** in the codebase (`payment.ts`); re-enable it with a valid CDP\n facilitator key to also accept Base USDC agents.\n\n## What we store\n\nThe document itself is **never stored**. We keep a minimal SQLite metadata log (`db.ts`) — destination,\npage count, amount, paying wallet, status, timestamp — for a running total. No document content, ever.\n\n## Configuration\n\nSensible defaults; for production set your Sinch keys and Tempo recipient.\n\n| Env var | Default | Purpose |\n|---------|---------|---------|\n| `TEMPO_RECIPIENT` | a demo wallet | Tempo address that **receives** the USDC.e. |\n| `MPP_SECRET_KEY` | (set) | Server HMAC secret binding challenges to credentials. |\n| `MPP_SIGNER_KEY` | (set) | Server signer `mppx` requires (session settlement; unused by one-shot charge). |\n| `FAX_PRICE_PER_PAGE` | `0.20` | Price per page, in USD. |\n| `SINCH_KEY_ID` / `SINCH_KEY_SECRET` | unset → sandbox | Sinch Fax access key (OAuth2) for real faxing. |\n| `SINCH_PROJECT_ID` | unset → sandbox | Sinch project the Fax API is scoped to. |\n| `SINCH_FROM` | unset | Optional sender fax number. |\n\n### Go live (real faxes)\n\n1. **Fund your Tempo wallet** with a little USDC.e (`tempo wallet fund`).\n2. **Add your Sinch Fax credentials** (from dashboard.sinch.com — Access Keys + Project ID):\n\n 👉 Add SINCH_KEY_ID here: https://www.val.town/x/stevekrouse/agentfax/environment-variables?key=SINCH_KEY_ID\n\n 👉 Add SINCH_KEY_SECRET here: https://www.val.town/x/stevekrouse/agentfax/environment-variables?key=SINCH_KEY_SECRET\n\n 👉 Add SINCH_PROJECT_ID here: https://www.val.town/x/stevekrouse/agentfax/environment-variables?key=SINCH_PROJECT_ID\n\n## Files\n\n- `main.ts` — Hono server: routes, MPP payment gate, SSR landing page, metadata logging.\n- `mpp.ts` — Tempo/MPP rail via `mppx` (mainnet, USDC.e), per-page pricing, `paymentInfo()`.\n- `fax.ts` — fax backend (Sinch Fax v3 + sandbox), job-id codec, live status.\n- `db.ts` — minimal metadata log (never the document content).\n- `og.ts` — Open Graph / Twitter card image.\n- `payment.ts` — parked x402 rail (re-enable with a CDP key).\n- `frontend/` — SSR React + Twind landing page.\n\nBuilt on [Val Town](https://val.town). Faxes via [Sinch](https://developers.sinch.com/docs/fax/). Payments via [Tempo/MPP](https://mpp.dev).\n",[212],"405006a2-5ba5-11f1-b599-ee650bb23af1","frontend","019e75a2-f04c-7499-b28f-4ab4005ebedc",["D",1780090073094],"directory",[218],"pulls","branches","forks","envVars",{"_230":232,"_233":232},"connections",{"_230":67,"_231":67},"count","unfilledCount",12,"emptyCount",{"_48":217,"_38":218,"_36":219,"_162":-5,"_46":47,"_45":163,"_164":31,"_43":347,"_13":67,"_39":221,"_41":-5,"_30":54,"_167":-5,"_254":348,"_33":349},{"_48":343,"_38":314,"_36":309,"_162":219,"_46":47,"_45":163,"_164":31,"_43":344,"_13":67,"_39":221,"_41":-5,"_30":54,"_167":-5,"_254":345,"_33":346},{"_48":336,"_38":337,"_36":338,"_162":309,"_46":47,"_45":163,"_164":54,"_43":339,"_13":67,"_39":40,"_41":340,"_30":54,"_167":-5,"_254":341,"_33":342},{"_48":329,"_38":330,"_36":331,"_162":309,"_46":47,"_45":163,"_164":54,"_43":332,"_13":67,"_39":40,"_41":333,"_30":54,"_167":-5,"_254":334,"_33":335},{"_48":322,"_38":323,"_36":324,"_162":309,"_46":47,"_45":163,"_164":54,"_43":325,"_13":67,"_39":40,"_41":326,"_30":54,"_167":-5,"_254":327,"_33":328},{"_48":315,"_38":316,"_36":317,"_162":309,"_46":47,"_45":163,"_164":54,"_43":318,"_13":67,"_39":40,"_41":319,"_30":54,"_167":-5,"_254":320,"_33":321},{"_48":306,"_38":307,"_36":308,"_162":309,"_46":47,"_45":163,"_164":54,"_43":310,"_13":67,"_39":40,"_41":311,"_30":54,"_167":-5,"_254":312,"_33":313},{"_48":299,"_38":300,"_36":301,"_162":219,"_46":47,"_45":163,"_164":54,"_43":302,"_13":67,"_39":40,"_41":303,"_30":54,"_167":-5,"_254":304,"_33":305},{"_48":292,"_38":293,"_36":294,"_162":219,"_46":47,"_45":163,"_164":54,"_43":295,"_13":67,"_39":40,"_41":296,"_30":54,"_167":-5,"_254":297,"_33":298},{"_48":285,"_38":286,"_36":287,"_162":219,"_46":47,"_45":163,"_164":31,"_43":288,"_13":67,"_39":26,"_41":289,"_30":54,"_167":-5,"_254":290,"_33":291},{"_48":278,"_38":279,"_36":280,"_162":219,"_46":47,"_45":163,"_164":54,"_43":281,"_13":67,"_39":40,"_41":282,"_30":54,"_167":-5,"_254":283,"_33":284},{"_48":211,"_38":212,"_36":213,"_162":-5,"_46":47,"_45":163,"_164":31,"_43":275,"_13":67,"_39":26,"_41":215,"_30":54,"_167":-5,"_254":276,"_33":277},{"_48":204,"_38":205,"_36":206,"_162":-5,"_46":47,"_45":207,"_164":31,"_43":272,"_13":163,"_39":40,"_41":209,"_30":54,"_167":-5,"_254":273,"_33":274},{"_48":197,"_38":198,"_36":199,"_162":-5,"_46":47,"_45":200,"_164":31,"_43":269,"_13":67,"_39":40,"_41":202,"_30":54,"_167":-5,"_254":270,"_33":271},{"_48":189,"_38":190,"_36":191,"_162":-5,"_46":47,"_45":192,"_164":31,"_43":266,"_13":163,"_39":194,"_41":195,"_30":54,"_167":-5,"_254":267,"_33":268},{"_48":182,"_38":183,"_36":184,"_162":-5,"_46":47,"_45":185,"_164":54,"_43":263,"_13":163,"_39":40,"_41":187,"_30":54,"_167":-5,"_254":264,"_33":265},{"_48":175,"_38":176,"_36":177,"_162":-5,"_46":47,"_45":178,"_164":31,"_43":260,"_13":163,"_39":40,"_41":180,"_30":54,"_167":-5,"_254":261,"_33":262},{"_48":169,"_38":170,"_36":171,"_162":-5,"_46":47,"_45":163,"_164":31,"_43":257,"_13":67,"_39":40,"_41":173,"_30":54,"_167":-5,"_254":258,"_33":259},{"_48":159,"_38":160,"_36":161,"_162":-5,"_46":47,"_45":163,"_164":31,"_43":253,"_13":67,"_39":40,"_41":166,"_30":54,"_167":-5,"_254":255,"_33":256},["D",1780090073094],"children",[],[160],["D",1780090073094],[],[170],["D",1780090232290],[],[176],["D",1780090205035],[],[183],["D",1780090292498],[],[190],["D",1780090180006],[],[198],["D",1780090220450],[],[205],["D",1780090073094],[],[212],"404ffb94-5ba5-11f1-b599-ee650bb23af1","render.tsx","019e75a2-f04c-7499-b28f-4488837e553b",["D",1780090073094],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n// Server-side render of the landing page. Per Val Town's React SSR quirk we\n// import react-dom/server from esm.sh with a pinned `?deps` to avoid the\n// \"ReactCurrentDispatcher\" mismatch that `npm:` imports trigger.\nimport { renderToString } from \"https://esm.sh/react-dom@18.2.0/server?deps=react@18.2.0\";\nimport { App, type PageData } from \"./App.tsx\";\n\nexport function renderPage(data: PageData): string {\n const body = renderToString();\n const desc = \"Send a fax from an AI agent. Pay per fax in USDC.e over Tempo/MPP — no signup, no API key.\";\n return `\n\n \n \n \n agentfax — a fax API for AI agents\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

${body}

\n \n \n \n`;\n}\n",[],[218,279],"404ff7ac-5ba5-11f1-b599-ee650bb23af1","favicon.svg","019e75a2-f04c-7499-b28f-421f4310be91",["D",1780090073094],"\n",[],[218,286],"404fe96a-5ba5-11f1-b599-ee650bb23af1","demo.js","019e75a2-f04c-7499-b28f-3ccd15cc430d",["D",1780090073094],"// Minimal client JS: fire a real POST /v1/fax with no payment and show the\n// response (the 402 challenge in x402 mode, or a simulated fax in sandbox mode).\nconst btn = document.getElementById(\"try-btn\");\nconst out = document.getElementById(\"try-out\");\n\nbtn?.addEventListener(\"click\", async () => {\n const label = btn.textContent;\n btn.disabled = true;\n btn.textContent = \"Calling…\";\n out.className = \"text-neutral-200\";\n out.textContent = \"\";\n try {\n const res = await fetch(\"/v1/fax\", {\n method: \"POST\",\n headers: { \"content-type\": \"application/json\" },\n body: JSON.stringify({\n to: \"+14155550123\",\n file_url: \"https://example.com/invoice.pdf\",\n }),\n });\n const text = await res.text();\n let pretty = text;\n try {\n pretty = JSON.stringify(JSON.parse(text), null, 2);\n } catch (_) { /* leave as text */ }\n out.textContent = `HTTP ${res.status} ${res.statusText}\\n\\n${pretty}`;\n } catch (e) {\n out.textContent = \"Error: \" + (e && e.message ? e.message : String(e));\n } finally {\n btn.disabled = false;\n btn.textContent = label;\n }\n});\n\n// \"Copy prompt for your agent\" — copy the onboarding prompt to the clipboard.\nconst copyBtn = document.getElementById(\"copy-prompt\");\ncopyBtn?.addEventListener(\"click\", async () => {\n const text = copyBtn.dataset.prompt || \"\";\n const orig = copyBtn.textContent;\n try {\n await navigator.clipboard.writeText(text);\n } catch (_) {\n const ta = document.createElement(\"textarea\");\n ta.value = text;\n document.body.appendChild(ta);\n ta.select();\n try { document.execCommand(\"copy\"); } catch (e) { /* ignore */ }\n document.body.removeChild(ta);\n }\n copyBtn.textContent = \"Copied — paste it to your agent\";\n setTimeout(() => { copyBtn.textContent = orig; }, 2200);\n});\n",[],[218,293],"404fddd0-5ba5-11f1-b599-ee650bb23af1","App.tsx","019e75a2-f04c-7499-b28f-39887cfea8af",["D",1780090073094],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { type Cfg } from \"./components/ui.tsx\";\nimport { Hero } from \"./components/Hero.tsx\";\nimport { Api } from \"./components/Api.tsx\";\nimport { Footer, HowItWorks, Networks, Privacy, Shingle, TryIt } from \"./components/Sections.tsx\";\nimport { type FaxStats } from \"../db.ts\";\n\nexport interface PageData {\n baseUrl: string;\n payment: {\n network: string;\n price: string;\n payTo: string;\n facilitator: string;\n mode: string;\n asset: { symbol: string; address: string | null; decimals: number };\n };\n provider: \"sinch\" | \"sandbox\";\n price: string;\n stats: FaxStats | null;\n}\n\nexport function App(data: PageData) {\n const cfg: Cfg = {\n baseUrl: data.baseUrl,\n network: data.payment.network,\n price: data.payment.price,\n assetSymbol: data.payment.asset.symbol,\n assetAddress: data.payment.asset.address,\n payTo: data.payment.payTo,\n facilitator: data.payment.facilitator,\n provider: data.provider,\n mode: data.payment.mode,\n };\n\n return (\n

\n \n \n \n \n \n \n \n

\n );\n}\n",[],[218,300],"404fd088-5ba5-11f1-b599-ee650bb23af1","ui.tsx","019e75a2-f04c-7499-b28f-3239b8544638","019e75a2-f04c-7499-b28f-343b07dbc4f9",["D",1780090073094],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n// Shared presentational primitives. Server-rendered; no client JS.\n\nexport interface Cfg {\n baseUrl: string;\n network: string;\n price: string;\n assetSymbol: string;\n assetAddress: string | null;\n payTo: string;\n facilitator: string;\n provider: \"phaxio\" | \"sandbox\";\n mode: \"x402\" | \"sandbox\";\n}\n\nexport function Section(\n { id, className = \"\", children }: { id?: string; className?: string; children: any },\n) {\n return (\n

\n {children}\n

\n );\n}\n\nexport function Eyebrow({ children }: { children: any }) {\n return (\n

\n {children}\n

\n );\n}\n\nconst TONES: Record = {\n neutral: \"bg-neutral-800/80 text-neutral-300 border-neutral-700\",\n green: \"bg-emerald-500/10 text-emerald-300 border-emerald-500/30\",\n amber: \"bg-amber-500/10 text-amber-300 border-amber-500/30\",\n blue: \"bg-sky-500/10 text-sky-300 border-sky-500/30\",\n};\n\nexport function Pill({ tone = \"neutral\", children }: { tone?: string; children: any }) {\n return (\n \n {children}\n \n );\n}\n\nexport function Card({ className = \"\", children }: { className?: string; children: any }) {\n return (\n

\n {children}\n

\n );\n}\n\nexport function CodeBlock(\n { label, children }: { label?: string; children: any },\n) {\n return (\n

\n {label\n ? (\n

\n {label}\n

\n )\n : null}\n

\n        {children}\n

\n );\n}\n\nexport function Mono({ children }: { children: any }) {\n return {children};\n}\n",[],[218,314,307],"components","404fba62-5ba5-11f1-b599-ee650bb23af1","Stats.tsx","019e75a2-f04c-7499-b28f-2d0cdd6807b5",["D",1780090073094],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n// Small, friendly one-line \"public business\" ticker for under the hero CTA:\n// faxes sent · revenue · profit · how long we've been live, plus a tiny growth\n// sparkline. All server-rendered, no client JS. The sparkline is a plain SSR\n//

\n \n \n \n \n \n We've sent {faxes} for{\" \"}\n {usd(stats.paidUsd)}{\" \"}\n ({usd(profit)} profit){\" \"}\n since launching {timeAgo(LAUNCHED_AT)}\n \n \n

\n );\n}\n",[],[218,314,316],"404f95fa-5ba5-11f1-b599-ee650bb23af1","Sections.tsx","019e75a2-f04c-7499-b28f-2a39915d4026",["D",1780090073094],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport {\n Card,\n type Cfg,\n CodeBlock,\n Eyebrow,\n Mono,\n Pill,\n Section,\n} from \"./ui.tsx\";\n\nexport function HowItWorks() {\n const steps = [\n {\n n: \"01\",\n t: \"Ask\",\n d: \"Your agent POSTs a number and document to /v1/fax. With no payment attached, it gets back HTTP 402 — exactly what to pay and where.\",\n },\n {\n n: \"02\",\n t: \"Pay\",\n d: \"The agent's wallet pays and retries with an Authorization: Payment header. We verify the payment on-chain — no facilitator, no keys.\",\n },\n {\n n: \"03\",\n t: \"Fax\",\n d: \"We send the fax, return a job id, and drop the payload. Poll /v1/fax/{id} for status.\",\n },\n ];\n return (\n

\n How it works\n

\n Ask → pay → fax, in one request loop.\n

\n {steps.map((s) => (\n \n

{s.n}

{s.t}

{s.d}

\n \n ))}\n

\n );\n}\n\nexport function Networks() {\n return (\n

\n Payments\n

\n Pay from any MPP client.\n

\n Paid in USDC.e on Tempo mainnet, verified on-chain — no facilitator, no\n keys. tempo request pays in one line, and any MPP-aware\n agent can pay with no SDK lock-in.\n

\n );\n}\n\nexport function Shingle() {\n return (\n

\n Want to hang a shingle?\n

\n Start making money by accepting payments on Tempo MPP.\n

\n Immediately — no marketplace, no approval. This app is open source and\n runs on Val Town.\n

\n \n Remix on Val Town\n \n \n Read the source\n \n

\n );\n}\n\nexport function Privacy({ stats }: { stats: { faxes: number; pages: number } | null }) {\n return (\n

\n \n What we store\n

\n Your documents are never stored.\n

\n The document goes straight to the fax network and is dropped — it never touches our database.\n We keep only minimal send metadata: destination, page count, amount, and the paying wallet.\n {stats && stats.faxes > 0\n ? ` So far we've relayed ${stats.faxes.toLocaleString()} fax${stats.faxes === 1 ? \"\" : \"es\"} (${stats.pages.toLocaleString()} page${stats.pages === 1 ? \"\" : \"s\"}).`\n : \"\"}\n

\n documents never stored\n metadata only\n on-chain settlement\n

\n \n

\n );\n}\n\nexport function TryIt({ cfg }: { cfg: Cfg }) {\n return (\n

\n Try it\n

\n See the 402 challenge live.\n

\n Send a real request with no payment attached and see the exact 402 an\n agent would get.\n

\n \n Send a test request\n \n \n \n {`// press the button to call ${cfg.baseUrl}/v1/fax`}\n \n \n

\n Want to watch a real{\" \"}\n fax arrive? Have an agent fax +19725329272 —{\" \"}\n \n Faxbeep\n 's free public test line — then find your pages in its gallery.\n (That's how the demo above was verified.)\n

\n );\n}\n\nexport function Footer() {\n return (\n \n );\n}",[],[218,314,323],"404f8524-5ba5-11f1-b599-ee650bb23af1","Hero.tsx","019e75a2-f04c-7499-b28f-2662d63a284c",["D",1780090073094],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { type Cfg, CodeBlock, Eyebrow, Pill, Section } from \"./ui.tsx\";\nimport { type FaxStats as FaxStatsData } from \"../../db.ts\";\nimport { FaxStats } from \"./Stats.tsx\";\n\nfunction shorten(addr: string) {\n return addr && addr.length > 12 ? `${addr.slice(0, 6)}…${addr.slice(-4)}` : addr;\n}\n\nexport function Hero({ cfg, stats }: { cfg: Cfg; stats: FaxStatsData | null }) {\n const agentPrompt =\n `You can send a real fax through agentfax — a pay-per-fax HTTP API for AI agents. ` +\n `Read ${cfg.baseUrl}/v1/info to learn the endpoints, parameters, and pricing ` +\n `(and ${cfg.baseUrl} for more context). It's paid per call over Tempo/MPP (USDC.e over HTTP 402), ` +\n `so use your wallet to pay. Once you understand the API, send a test fax for me.`;\n\n return (\n

\n Fax for AI agents\n

\n Your agent can send a fax now.\n

\n One HTTP endpoint. Your agent pays a few cents in {cfg.assetSymbol} over{\" \"}\n \n Tempo/MPP\n , and the fax goes out — no account, no API key.\n

\n\n

\n Tempo mainnet\n {cfg.price}\n no document storage\n

\n\n

\n \n Copy prompt for your agent\n \n

\n\n {stats ? : null}\n\n

\n \n {`$ tempo request -X POST ${cfg.baseUrl}/v1/fax \\\\\n --json '{\n \"to\": \"+14155550123\",\n \"file_url\": \"https://example.com/invoice.pdf\"\n }'`}\n \n \n {`HTTP/1.1 402 Payment Required\nWWW-Authenticate: Payment\n method=\"tempo\", intent=\"charge\",\n amount=\"400000\" // 2 pages × ${cfg.price}, in ${cfg.assetSymbol}\n currency=\"0x20C0…60E8b50\" // ${cfg.assetSymbol}\n recipient=\"${shorten(cfg.payTo)}\"\n chainId=4217 // Tempo mainnet`}\n \n

\n Any MPP client reads the challenge, pays, and retries — your code just gets back a job id.\n

\n );\n}\n",[],[218,314,330],"404f61f2-5ba5-11f1-b599-ee650bb23af1","Api.tsx","019e75a2-f04c-7499-b28f-21419bead9eb",["D",1780090073094],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { type Cfg, Card, CodeBlock, Eyebrow, Mono, Pill, Section } from \"./ui.tsx\";\n\nfunction Endpoint(\n { method, path, paid, children }: { method: string; path: string; paid?: boolean; children: any },\n) {\n const methodTone = method === \"GET\" ? \"blue\" : \"green\";\n return (\n \n

\n {method}\n {path}\n {paid ? 402 · paid : free}\n

\n {children}\n \n );\n}\n\nexport function Api({ cfg }: { cfg: Cfg }) {\n return (\n

\n API\n

Three endpoints. That's the whole thing.

\n Discover the service at GET /v1/info. Everything an agent needs — price, network,\n receiving address, and the request schema — is machine-readable.\n

\n\n

\n \n

\n Send a fax. Returns 402 with payment terms until paid; on success returns a job id.\n

\n \n {`{\n \"to\": \"+14155550123\", // E.164, required\n \"file_url\": \"https://…/doc.pdf\", // a public PDF URL …\n \"content_base64\": \"JVBERi0…\", // … or raw base64 bytes\n \"file_name\": \"doc.pdf\", // optional\n \"metadata\": { \"ref\": \"inv-42\" } // optional, echoed back, not stored\n}`}\n \n \n {`{\n \"id\": \"snc_8675309\",\n \"status\": \"sending\",\n \"to\": \"+14155550123\",\n \"pages\": 2,\n \"price_usd\": \"$0.40\",\n \"_links\": { \"self\": \"${cfg.baseUrl}/v1/fax/snc_8675309\" }\n}`}\n \n \n\n \n

\n Poll delivery status — proxied live from the fax network. Status is one of{\" \"}\n queued, sending, delivered, failed. We hold\n no record of the destination or document.\n

\n \n\n \n

\n The machine-readable manifest: payment terms, the request schema, and a ready-to-run example.\n

\n \n

\n );\n}\n",[],[218,314,337],"404fdc7c-5ba5-11f1-b599-ee650bb23af1",["D",1780090073094],[236,237,238,239,240],[218,314],["D",1780090073094],[235,241,242,243,244],[218],["D",1780090073094],["D",1789509043237],{"_108":107,"_115":111},{"_108":107,"_109":-5,"_110":111,"_19":61,"_112":113,"_114":54},{"_13":93,"_38":94,"_48":47,"_95":49,"_96":97,"_98":99,"_100":56,"_101":102,"_103":104,"_105":50,"_106":107},"ctx",{"_86":-5,"_137":388,"_389":390,"_391":392,"_393":54,"_394":54,"_395":54,"_396":31,"_397":-5,"_398":-7,"_399":-7,"_400":67,"_401":54,"_402":54,"_403":-5,"_404":54,"_405":54,"_406":54,"_407":-5},"ENV",{"_359":360,"_361":362,"_363":94,"_364":365,"_366":367,"_368":369,"_370":371,"_372":373,"_374":375,"_376":377,"_378":379,"_380":381,"_382":383,"_384":385,"_386":387},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v7