[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_310":311,"_312":313},"routes/_app.x.$handle.$name",{"_105":104,"_38":50,"_113":93,"_33":114,"_13":14,"_115":-5,"_11":116,"_117":118,"_119":120,"_121":122,"_123":124,"_26":-5,"_125":-5,"_126":127,"_128":91,"_129":130,"_131":31,"_132":-5,"_133":-5,"_134":135},"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":31,"_54":55,"_56":55,"_57":-5,"_58":-5,"_19":59,"_60":-5,"_61":31,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":76,"_77":78,"_79":78,"_80":78,"_81":78,"_82":76,"_83":76,"_84":85,"_86":87,"_88":89,"_90":91},"version",20,"changes",[25],"aiChatInfo",{"_20":21,"_22":-5,"_23":-5,"_24":-5},"userId","aiChatMessageId","765ad7d6-f80b-4cf8-b771-7efe3afeb192","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","_dump_me.ts","latestPath","fileId","1d8023c4-8c64-11f1-9317-1607ee4eb77e","name","fileType","script","content","import { API_URL } from \"https://esm.town/v/std/API_URL?v=5\";\n\nconst token = Deno.env.get(\"valtown\");\nconst res = await fetch(`${API_URL}/v1/me`, {\n headers: { Authorization: `Bearer ${token}` },\n});\nconst me = await res.json();\nconsole.log(JSON.stringify(me, null, 2));\n","createdAt",["D",1785449741595],"branchVersion","branchId","a80aaeda-02f0-4886-bd9d-87ed4b354904","id","be1ca424-25fe-11f0-b0b8-569c3dd06744","openai",["D",1746043648993],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","imageUrl","c9143560-63b6-444f-8f9f-e2647fabe09f","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",10,"orgId","c606f87f-4d7e-48c8-9c39-ef5ab94aec49","tursoName","be1ca42425fe11f0b0b8569c3dd06744","tursoHostname","be1ca42425fe11f0b0b8569c3dd06744-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789474235934],"pinned","userPerm","r","valPerm","rw","blobPerm","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_105":104,"_112":108},"org",{"_105":104,"_106":-5,"_107":108,"_19":-5,"_109":110,"_111":91},"branch",{"_13":92,"_38":93,"_48":47,"_94":49,"_95":96,"_97":98,"_99":55,"_100":49,"_101":67,"_102":50,"_103":104},"isOwned",false,25,"dollar-rate-limiting","projectId","forkedBranchId","be1ce31c-25fe-11f0-b0b8-569c3dd06744","forkedBranchVersion",38,"forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","std","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvdXBsb2FkZWQvaW1nXzJVaVhpQ1BId3dscVpBbkdZVWlMNjJtcjkxWS5wbmcifQ","tier","pro","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_48":49,"_38":50,"_43":305,"_52":-5,"_53":31,"_54":55,"_56":55,"_57":-5,"_58":-5,"_19":59,"_60":-5,"_61":31,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":306,"_74":-5,"_75":76,"_77":78,"_79":78,"_80":78,"_81":78,"_82":76,"_83":76,"_84":307,"_86":308,"_88":309,"_90":91},"tree",[225,229,231,233,234,235,236,237,238],"files",[225,226,227,228,229,230,231,232,233,234,235,236,237,238],"counts",{"_214":158,"_215":216,"_217":65,"_218":219,"_220":221},"contents",[142,143,144,145,146,147,148,149,150],"upstreamProject","upstreamBranch",{"_48":96,"_43":136,"_137":138,"_38":139,"_94":49,"_13":98,"_95":-5,"_97":-5,"_140":141,"_52":-5,"_90":91,"_54":55,"_103":104,"_66":67,"_102":50},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1746043648993],"updatedAt",["D",1785445784006],"main","lockfileKey","1785445784166-esm.town_v_std_openai@38-main",{"_48":209,"_38":210,"_36":211,"_154":-5,"_46":47,"_45":158,"_156":31,"_43":212,"_13":166,"_39":201,"_41":-5,"_30":91,"_160":-5,"_33":213},{"_48":203,"_38":204,"_36":205,"_154":-5,"_46":47,"_45":206,"_156":31,"_43":207,"_13":166,"_39":201,"_41":-5,"_30":91,"_160":-5,"_33":208},{"_48":196,"_38":197,"_36":198,"_154":-5,"_46":47,"_45":199,"_156":31,"_43":200,"_13":166,"_39":201,"_41":-5,"_30":91,"_160":-5,"_33":202},{"_48":189,"_38":190,"_36":191,"_154":-5,"_46":47,"_45":192,"_156":91,"_43":193,"_13":158,"_39":26,"_41":194,"_30":91,"_160":-5,"_33":195},{"_48":183,"_38":184,"_36":185,"_154":-5,"_46":47,"_45":158,"_156":91,"_43":186,"_13":166,"_39":26,"_41":187,"_30":91,"_160":-5,"_33":188},{"_48":176,"_38":177,"_36":178,"_154":-5,"_46":47,"_45":179,"_156":31,"_43":180,"_13":158,"_39":40,"_41":181,"_30":91,"_160":-5,"_33":182},{"_48":169,"_38":170,"_36":171,"_154":-5,"_46":47,"_45":172,"_156":31,"_43":173,"_13":158,"_39":40,"_41":174,"_30":91,"_160":-5,"_33":175},{"_48":162,"_38":163,"_36":164,"_154":-5,"_46":47,"_45":158,"_156":31,"_43":165,"_13":166,"_39":40,"_41":167,"_30":91,"_160":-5,"_33":168},{"_48":151,"_38":152,"_36":153,"_154":-5,"_46":47,"_45":155,"_156":91,"_43":157,"_13":158,"_39":40,"_41":159,"_30":91,"_160":-5,"_33":161},"17e8f32d-486e-4b4d-bf7e-a5a691533997","pricing.ts","371fabe4-8c5d-11f1-82b4-1607ee4eb77e","parentId",11,"latest",["D",1785449313150],1,"/**\n * ┌────────────────────────┬────────────┬────────────┬─────────────┐\n * │ Model │ Input $/1M │ Cached $/1M│ Output $/1M │\n * ├────────────────────────┼────────────┼────────────┼─────────────┤\n * │ gpt-5.4-nano │ 0.20 │ 0.10 │ 1.20 │\n * │ gpt-5.6-luna │ 0.20 │ 0.10 │ 1.00 │\n * │ gpt-5.2 │ 2.50 │ 1.25 │ 10.00 │\n * │ gpt-5.2-mini │ 0.50 │ 0.25 │ 2.00 │\n * │ gpt-5.1 │ 5.00 │ 2.50 │ 15.00 │\n * │ gpt-5.1-mini │ 1.00 │ 0.50 │ 4.00 │\n * │ o4-pro │ 25.00 │ 12.50 │ 125.00 │\n * │ o3 │ 10.00 │ 5.00 │ 40.00 │\n * │ o3-mini │ 1.00 │ 0.50 │ 4.00 │\n * │ o4-mini │ 1.25 │ 0.625 │ 5.00 │\n * │ text-embedding-3-small │ 0.02 │ — │ — │\n * │ text-embedding-3-large │ 0.13 │ — │ — │\n * └────────────────────────┴────────────┴────────────┴─────────────┘\n *\n * Prices are in USD per 1 million tokens, sourced from OpenAI's pricing page.\n * Update this table when OpenAI changes prices or adds new models.\n *\n * Unknown models are REJECTED (400) rather than allowed for free.\n * If a model is missing, add it here.\n *\n * Costs and budgets are stored as REAL (dollar amounts) in SQLite.\n * No integer unit conversion needed — just normal decimals.\n */\n\nexport type ModelPricing = {\n input: number; // $ per 1M input tokens\n cachedInput: number; // $ per 1M cached input tokens (prompt cache)\n output: number; // $ per 1M output tokens\n outputOnly?: boolean; // true for embedding models (no output tokens billed)\n};\n\nexport const PRICING: Record = {\n \"gpt-5.4-nano\": { input: 0.20, cachedInput: 0.10, output: 1.20 },\n \"gpt-5.6-luna\": { input: 0.20, cachedInput: 0.10, output: 1.00 },\n \"gpt-5.2\": { input: 2.50, cachedInput: 1.25, output: 10.00 },\n \"gpt-5.2-mini\": { input: 0.50, cachedInput: 0.25, output: 2.00 },\n \"gpt-5.1\": { input: 5.00, cachedInput: 2.50, output: 15.00 },\n \"gpt-5.1-mini\": { input: 1.00, cachedInput: 0.50, output: 4.00 },\n \"o4-pro\": { input: 25.00, cachedInput: 12.50, output: 125.00 },\n \"o3\": { input: 10.00, cachedInput: 5.00, output: 40.00 },\n \"o3-mini\": { input: 1.00, cachedInput: 0.50, output: 4.00 },\n \"o4-mini\": { input: 1.25, cachedInput: 0.625, output: 5.00 },\n \"text-embedding-3-small\": { input: 0.02, cachedInput: 0, output: 0, outputOnly: true },\n \"text-embedding-3-large\": { input: 0.13, cachedInput: 0, output: 0, outputOnly: true },\n};\n\n/** Monthly budget in USD per calendar month, by tier. */\nexport const MONTHLY_BUDGET: Record = {\n free: 1, // $1\n pro: 10, // $10\n business: 40, // $40\n};\n\n/** Get the monthly budget for a tier, defaulting to the free tier. */\nexport function getBudget(tier: string): number {\n return MONTHLY_BUDGET[tier] ?? MONTHLY_BUDGET.free;\n}\n\n/**\n * Calculate cost in USD for a single request.\n *\n * cost = ((input - cached) × inputPrice + cached × cachedPrice + output × outputPrice) / 1,000,000\n *\n * Returns a normal decimal dollar amount (e.g., 0.0000062).\n */\nexport function calculateCost(\n model: string,\n inputTokens: number,\n cachedTokens: number,\n outputTokens: number,\n): number {\n const p = PRICING[model];\n if (!p) throw new Error(`No pricing for model: ${model}`);\n\n const inputCost = (inputTokens - cachedTokens) * p.input;\n const cachedCost = cachedTokens * p.cachedInput;\n const outputCost = p.outputOnly ? 0 : outputTokens * p.output;\n\n return (inputCost + cachedCost + outputCost) / 1_000_000;\n}\n\n/** Check if a model is in our pricing table. */\nexport function hasPricing(model: string): boolean {\n return model in PRICING;\n}\n","label",[152],"a8dd130e-eecd-4c74-a550-65b3988f149a","main.tsx","019fb4ea-df76-7108-899d-58059457a360",["D",1785446719355],0,"// For backward compatibility\nexport { OpenAI } from \"./main.ts\";",[163],"f369695a-840d-4985-9bb2-58015fee4c7b","main.ts","019fb4ea-df76-7108-899d-571b7c4b5996",5,["D",1785446871390],"import { type ClientOptions, OpenAI as RawOpenAI } from \"npm:openai\";\n\nexport class ValTownOpenAI extends RawOpenAI {\n constructor(options: ClientOptions) {\n super({\n ...options,\n // TODO: When we cut over, set the custom subdomain on proxy/main.ts\n // For now this points at the branch endpoint for testing.\n baseURL: \"https://std--7fb4e69e8c5d11f188fd1607ee4eb77e.web.val.run/v1\",\n apiKey: Deno.env.get(\"valtown\"),\n organization: null,\n });\n }\n}\n\nexport const OpenAI = ValTownOpenAI;",[170],"dc96188c-3a39-4d98-a4d2-c6d59d29342a","ledger.ts","42357f90-8c5d-11f1-a3bd-1607ee4eb77e",12,["D",1785449330437],"import { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\nimport { calculateCost, getBudget } from \"./pricing.ts\";\n\n/**\n * Dollar-based spend tracking.\n *\n * Two tables:\n * - openai_spend: append-only ledger of every request with token counts and cost\n * - openai_monthly_budget: aggregate spend per subject per month (for fast pre-flight checks)\n *\n * All monetary values are stored as REAL (dollar amounts) in SQLite.\n *\n * \"Subject\" is the budget owner: either a user (personal val) or an org (team val).\n * The budget follows the val's owning org tier.\n */\n\nexport async function initSchema(): Promise {\n await sqlite.batch([\n {\n sql: `CREATE TABLE IF NOT EXISTS openai_spend (\n id INTEGER PRIMARY KEY,\n subject_id TEXT NOT NULL,\n subject_type TEXT NOT NULL,\n handle TEXT NOT NULL,\n tier TEXT NOT NULL,\n month TEXT NOT NULL,\n model TEXT NOT NULL,\n input_tokens INTEGER NOT NULL DEFAULT 0,\n cached_tokens INTEGER NOT NULL DEFAULT 0,\n output_tokens INTEGER NOT NULL DEFAULT 0,\n cost REAL NOT NULL,\n timestamp TEXT NOT NULL DEFAULT (datetime('now'))\n )`,\n args: [],\n },\n {\n sql: `CREATE TABLE IF NOT EXISTS openai_monthly_budget (\n subject_id TEXT NOT NULL,\n month TEXT NOT NULL,\n spent REAL NOT NULL DEFAULT 0,\n PRIMARY KEY (subject_id, month)\n )`,\n args: [],\n },\n {\n sql: `CREATE INDEX IF NOT EXISTS idx_spend_subject ON openai_spend(subject_id, month)`,\n args: [],\n },\n {\n sql: `CREATE INDEX IF NOT EXISTS idx_spend_timestamp ON openai_spend(timestamp)`,\n args: [],\n },\n ]);\n}\n\n/** Returns the current month as 'YYYY-MM' (UTC calendar month). */\nexport function getCurrentMonth(): string {\n return new Date().toISOString().slice(0, 7); // \"2026-07\"\n}\n\nexport type Subject = {\n id: string;\n type: \"user\" | \"org\";\n handle: string;\n tier: string;\n};\n\nexport type BudgetCheck = {\n exceeded: boolean;\n spent: number; // USD\n budget: number; // USD\n remaining: number; // USD\n};\n\n/**\n * Check if a subject has exceeded their monthly budget.\n * Does NOT write — safe to call as a pre-flight check.\n */\nexport async function checkBudget(subject: Subject): Promise {\n const month = getCurrentMonth();\n const budget = getBudget(subject.tier);\n\n const result = await sqlite.execute({\n sql: `SELECT spent FROM openai_monthly_budget\n WHERE subject_id = ? AND month = ?`,\n args: [subject.id, month],\n });\n\n const spent = result.rows.length > 0\n ? Number(result.rows[0][0])\n : 0;\n\n return {\n exceeded: spent >= budget,\n spent,\n budget,\n remaining: Math.max(0, budget - spent),\n };\n}\n\n/**\n * Record a completed request's cost in the ledger.\n * Writes to both openai_spend (detail) and openai_monthly_budget (aggregate).\n * Called fire-and-forget after the OpenAI response is returned.\n */\nexport async function recordSpend(\n subject: Subject,\n model: string,\n inputTokens: number,\n cachedTokens: number,\n outputTokens: number,\n): Promise {\n const month = getCurrentMonth();\n const cost = calculateCost(\n model,\n inputTokens,\n cachedTokens,\n outputTokens,\n );\n\n await sqlite.batch([\n {\n sql: `INSERT INTO openai_spend\n (subject_id, subject_type, handle, tier, month, model,\n input_tokens, cached_tokens, output_tokens, cost)\n VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n args: [\n subject.id,\n subject.type,\n subject.handle,\n subject.tier,\n month,\n model,\n inputTokens,\n cachedTokens,\n outputTokens,\n cost,\n ],\n },\n {\n sql: `INSERT INTO openai_monthly_budget (subject_id, month, spent)\n VALUES (?, ?, ?)\n ON CONFLICT (subject_id, month) DO UPDATE SET\n spent = spent + ?`,\n args: [subject.id, month, cost, cost],\n },\n ]);\n\n return cost;\n}\n\n/**\n * Get spend stats for the dashboard.\n * Returns per-subject totals for the current month.\n */\nexport type SpendStat = {\n subject_id: string;\n handle: string;\n tier: string;\n spent: number;\n budget: number;\n request_count: number;\n};\n\nexport async function getMonthlySpendStats(limit = 100): Promise {\n const month = getCurrentMonth();\n const result = await sqlite.execute({\n sql: `SELECT\n s.subject_id, s.handle, s.tier,\n SUM(s.cost) as spent,\n COUNT(*) as count\n FROM openai_spend s\n WHERE s.month = ?\n GROUP BY s.subject_id, s.handle, s.tier\n ORDER BY spent DESC\n LIMIT ?`,\n args: [month, limit],\n });\n\n return result.rows.map((row) => ({\n subject_id: String(row[0]),\n handle: String(row[1]),\n tier: String(row[2]),\n spent: Number(row[3]),\n budget: getBudget(String(row[2])),\n request_count: Number(row[4]),\n }));\n}\n",[177],"7cb790f1-b45b-4737-b7b4-9a27c93d310b","README.md","019fb4ea-df76-7108-899d-52a56e2a413c",["D",1785446719355],"# std/openai - [Docs ↗](https://docs.val.town/std/openai)\n\nUse OpenAI's chat completion API with\n[`std/openai`](https://www.val.town/v/std/openai). This integration enables\naccess to OpenAI's language models without needing to acquire API keys.\n\nVal Town free users can use any affordable model – such as `gpt-5.6-luna`. Val\nTown Pro users can make 10 expensive requests (e.g. `gpt-5.6-sol`) per rolling\n24-hour window, and are then bumped down to `gpt-5.6-luna`.\n\nThis SDK is powered by\n[our openapiproxy](https://www.val.town/x/std/openaiproxy).\n\n## Basic Usage\n\n```ts title=\"Example\" val\nimport { OpenAI } from \"https://esm.town/v/std/openai/main.ts\";\n\nconst openai = new OpenAI();\n\nconst completion = await openai.chat.completions.create({\n messages: [\n { role: \"user\", content: \"Say hello in a creative way\" },\n ],\n model: \"gpt-5.6-luna\",\n max_completion_tokens: 100,\n});\n\nconsole.log(completion.choices[0].message.content);\n```\n\n## Bring Your Own API Key\n\nThe free proxy is great for getting started, but you may outgrow the rate\nlimits. The easiest upgrade path is to bring your own OpenAI API key — just set\n`OPENAI_API_KEY` and use the `npm:openai` client directly when it's available,\nfalling back to `ValTownOpenAI` otherwise. This way your val works with or\nwithout a key.\n\n```ts title=\"Bring Your Own Key\" val\nimport { ValTownOpenAI } from \"https://esm.town/v/std/openai/main.ts\";\nimport OpenAI from \"npm:openai\";\n\n// Use your own key if available, otherwise the Val Town proxy.\nconst apiKey = Deno.env.get(\"OPENAI_API_KEY\");\nconst openai = apiKey ? new OpenAI({ apiKey }) : new ValTownOpenAI({});\n\nconst completion = await openai.chat.completions.create({\n model: \"gpt-5.6-luna\",\n messages: [{ role: \"user\", content: \"Say hello in one word.\" }],\n});\n\nconsole.log(completion.choices[0].message.content);\n```\n\nSee the runnable example:\n[`examples/bring-your-own-key.ts`](https://www.val.town/x/std/openai/code/examples/bring-your-own-key.ts)\n\n## Responses API & Web Search\n\nThe Responses API (`responses.create`) is fully supported through the Val Town\nproxy. It enables the **web_search** tool, which lets the model browse the web\nin real time — incredibly effective for enrichment, research, and anything where\nfresh data beats stale training knowledge.\n\n```ts title=\"Web Search\" val\nimport { ValTownOpenAI } from \"https://esm.town/v/std/openai/main.ts\";\n\nconst openai = new ValTownOpenAI({});\n\nconst response = await openai.responses.create({\n model: \"gpt-5.6-luna\",\n tools: [{ type: \"web_search\" }],\n instructions:\n \"You research companies. Given a company name, reply in 2-3 short plain-text lines: what they do, their stage, and why a developer might care. No markdown.\",\n input: \"Val Town\",\n});\n\nconsole.log(response.output_text);\n```\n\nSee the runnable example:\n[`examples/web-search.ts`](https://www.val.town/x/std/openai/code/examples/web-search.ts)\n\n## Structured Outputs\n\nInstead of asking the model to \"return JSON\" and manually parsing the response,\npass a JSON schema in `text.format`. The model is constrained to output JSON\nthat matches your schema exactly — no fence stripping, no regex, no try/catch on\nmalformed JSON. This is the idiomatic approach for classification, scoring,\nextraction, routing, or any task where you need typed data back.\n\n```ts title=\"Structured Outputs\" val\nimport { ValTownOpenAI } from \"https://esm.town/v/std/openai/main.ts\";\n\nconst openai = new ValTownOpenAI({});\n\nconst response = await openai.responses.create({\n model: \"gpt-5.6-luna\",\n instructions:\n \"You classify user feedback. Given a piece of feedback, classify it and write a one-sentence summary.\",\n input:\n \"The app keeps logging me out every 5 minutes, it's really frustrating.\",\n text: {\n format: {\n type: \"json_schema\",\n name: \"classification\",\n schema: {\n type: \"object\",\n properties: {\n category: {\n type: \"string\",\n enum: [\"bug\", \"feature_request\", \"praise\", \"question\"],\n },\n priority: {\n type: \"string\",\n enum: [\"low\", \"medium\", \"high\"],\n },\n summary: { type: \"string\" },\n },\n required: [\"category\", \"priority\", \"summary\"],\n additionalProperties: false,\n },\n },\n },\n});\n\n// output_text is guaranteed valid JSON matching the schema.\nconst result = JSON.parse(response.output_text);\nconsole.log(result);\n```\n\nSee the runnable example:\n[`examples/structured-outputs.ts`](https://www.val.town/x/std/openai/code/examples/structured-outputs.ts)\n\n## Images\n\nTo send an image to ChatGPT, the easiest way is by converting it to a data URL,\nwhich is easiest to do with\n[@stevekrouse/fileToDataURL](https://www.val.town/v/stevekrouse/fileToDataURL).\n\n```ts title=\"Image Example\" val\nimport { fileToDataURL } from \"https://esm.town/v/stevekrouse/fileToDataURL\";\n\nconst dataURL = await fileToDataURL(file);\nconst response = await chat([\n {\n role: \"system\",\n content: `You are an nutritionist. \n Estimate the calories.\n We only need a VERY ROUGH estimate.\n Respond ONLY in a JSON array with values conforming to: {ingredient: string, calories: number}\n `,\n },\n {\n role: \"user\",\n content: [{\n type: \"image_url\",\n image_url: {\n url: dataURL,\n },\n }],\n },\n], {\n model: \"gpt-5.6-luna\",\n max_completion_tokens: 200,\n});\n```\n\n## OpenAI Agents SDK\n\nThe [OpenAI Agents SDK](https://openai.github.io/openai-agents-js/) works with\n`std/openai` too, including hosted tools like web search:\n\n```ts title=\"Agents Example\" val\nimport { ValTownOpenAI } from \"https://esm.town/v/std/openai/main.ts\";\nimport {\n Agent,\n run,\n setDefaultOpenAIClient,\n setTracingDisabled,\n webSearchTool,\n} from \"npm:@openai/agents\";\n\nsetTracingDisabled(true); // tracing requires your own OpenAI key\nsetDefaultOpenAIClient(new ValTownOpenAI({}));\n\nconst agent = new Agent({\n name: \"Researcher\",\n tools: [webSearchTool()],\n});\n\nconst result = await run(agent, \"What's new in Val Town?\");\nconsole.log(result.finalOutput);\n```\n\n## Limits\n\nWhile our wrapper simplifies the integration of OpenAI, there are a few\nlimitations to keep in mind:\n\n- **Usage Quota**: We limit each user to 100 requests per day.\n- **Features**: Chat completions and the Responses API are the only endpoints\n available. The Responses API supports the `web_search` tool and structured\n outputs (`text.format` with `json_schema`).\n\nIf these limits are too low, let us know! You can also get around the limitation\nby [bringing your own API key](#bring-your-own-api-key).\n\n[📝 Edit docs](https://github.com/val-town/val-town-docs/edit/main/src/content/docs/std/openai.mdx)",[184],"7a26a536-c522-460d-90a0-4d83b66bf3c7","AGENTS.md","019fb4ea-df76-7108-899d-4c0be1bf7963",6,["D",1785446888490],"# std/openai\n\nClient SDK for using OpenAI's API through Val Town's proxy. No API key needed.\n\n## File Map\n\n| File | Type | Description |\n|------|------|-------------|\n| `main.ts` | script | `ValTownOpenAI` class — extends OpenAI SDK to use Val Town's proxy automatically |\n| `main.tsx` | script | Backward compatibility re-export from `main.ts` |\n| `pricing.ts` | script | Model pricing table ($/1M tokens) + budget tiers + cost calculation |\n| `ledger.ts` | script | Dollar-based spend tracking in project-scoped SQLite (openai_spend + openai_monthly_budget tables) |\n| `proxy/main.ts` | http | **New proxy** — authenticates users, enforces dollar budgets, records actual spend |\n| `examples/web-search.ts` | script | Example: web search via Responses API |\n| `examples/structured-outputs.ts` | script | Example: structured outputs with JSON schema |\n| `examples/bring-your-own-key.ts` | script | Example: using your own OpenAI API key with fallback to proxy |\n| `README.md` | file | User-facing documentation |\n| `AGENTS.md` | file | This file |\n\n## Architecture (dollar-rate-limiting branch)\n\nThe proxy has been moved from `std/openaiproxy` into this val (`proxy/main.ts`) to use project-scoped SQLite.\n\n### How rate limiting works now\n\n1. User's val calls OpenAI via the SDK → proxy authenticates via `/v1/me` → identifies the val's owning org + tier\n2. Pre-flight check: has this subject (user or org) exceeded their monthly dollar budget?\n3. Budgets (per calendar month, UTC):\n - free: $1/month\n - pro: $10/month\n - business: $40/month\n4. If over budget → 402 with remaining-budget info\n5. Proxy to OpenAI, parse response usage, calculate cost in microdollars\n6. Record spend (fire-and-forget, doesn't add to request latency)\n\n### What was removed (vs old openaiproxy)\n\n- ❌ Request count limits (was 100/day) — dollars are the only guard now\n- ❌ Model gating (was: free users forced to cheap models, pro users get 10 expensive requests) — any priced model is allowed, budget is the guard\n- ❌ Streaming support — rejected with 400 (simplifies usage extraction)\n- ❌ Unknown models allowed — now rejected with 400 (never free-by-accident)\n\n### Cost calculation\n\n- Prices stored as USD per 1M tokens in `pricing.ts` (readable, easy to update)\n- Cost calculated in **microdollars** (integer) to avoid floating-point issues\n- Formula: `cost_microdollars = round(tokens × price_per_1M)` (works because $/1M × tokens = microdollars directly)\n\n### SQLite tables\n\n- `openai_spend` — append-only ledger: subject, model, token counts, cost, timestamp\n- `openai_monthly_budget` — aggregate: subject_id × month → spent_microdollars (for fast pre-flight checks)\n\nBoth use project-scoped SQLite (`std/sqlite/main.ts`), not the deprecated global DB.\n\n## Environment Variables\n\n- `OPENAI_API_KEY` — OpenAI API key (needs to be added to this val before cutover)\n- `OPENAI_API_ORG` — OpenAI organization ID (needs to be added to this val before cutover)\n\n## Cutover plan\n\n1. ✅ Build proxy on `dollar-rate-limiting` branch\n2. ⬜ Add `OPENAI_API_KEY` + `OPENAI_API_ORG` env vars to this val\n3. ⬜ Merge branch to main\n4. ⬜ Set custom subdomain `std-openaiproxy` on `proxy/main.ts` (with `force: true`)\n5. ⬜ Archive `std/openaiproxy`\n\n## Related Vals\n\n- [std/openaiproxy](https://www.val.town/x/std/openaiproxy) — Old proxy (to be archived after cutover)\n",[190],"df6180ff-2070-4390-aa62-b2d7df767d75","tests","622d9d61-914e-4390-9281-9d8b62dbb1a3",7,["D",1785447223616],"directory",[197],"1743ee63-eb5b-464e-86fa-568997e2f840","proxy","95bed124-9bf3-479e-9c36-fdd2f6dcc960",4,["D",1785446862743],[204],"f1080d92-5fb2-424f-b9c2-d33b4de7414e","examples","019fb4ea-df76-7108-899d-48c5ac28bf1c",["D",1785446719355],[210],"pulls","branches",2,"forks","envVars",{"_222":216,"_224":166},"connections",{"_222":166,"_223":166},"count","unfilledCount","emptyCount",{"_48":209,"_38":210,"_36":211,"_154":-5,"_46":47,"_45":158,"_156":31,"_43":302,"_13":166,"_39":201,"_41":-5,"_30":91,"_160":-5,"_240":303,"_33":304},{"_48":295,"_38":296,"_36":297,"_154":211,"_46":47,"_45":158,"_156":31,"_43":298,"_13":166,"_39":40,"_41":299,"_30":91,"_160":-5,"_240":300,"_33":301},{"_48":288,"_38":289,"_36":290,"_154":211,"_46":47,"_45":158,"_156":31,"_43":291,"_13":166,"_39":40,"_41":292,"_30":91,"_160":-5,"_240":293,"_33":294},{"_48":281,"_38":282,"_36":283,"_154":211,"_46":47,"_45":158,"_156":31,"_43":284,"_13":166,"_39":40,"_41":285,"_30":91,"_160":-5,"_240":286,"_33":287},{"_48":203,"_38":204,"_36":205,"_154":-5,"_46":47,"_45":206,"_156":31,"_43":278,"_13":166,"_39":201,"_41":-5,"_30":91,"_160":-5,"_240":279,"_33":280},{"_48":270,"_38":170,"_36":271,"_154":205,"_46":47,"_45":272,"_156":91,"_43":273,"_13":192,"_39":274,"_41":275,"_30":91,"_160":-5,"_240":276,"_33":277},{"_48":196,"_38":197,"_36":198,"_154":-5,"_46":47,"_45":199,"_156":31,"_43":267,"_13":166,"_39":201,"_41":-5,"_30":91,"_160":-5,"_240":268,"_33":269},{"_48":258,"_38":259,"_36":260,"_154":198,"_46":47,"_45":261,"_156":31,"_43":262,"_13":263,"_39":40,"_41":264,"_30":91,"_160":-5,"_240":265,"_33":266},{"_48":189,"_38":190,"_36":191,"_154":-5,"_46":47,"_45":192,"_156":91,"_43":255,"_13":158,"_39":26,"_41":194,"_30":91,"_160":-5,"_240":256,"_33":257},{"_48":183,"_38":184,"_36":185,"_154":-5,"_46":47,"_45":158,"_156":91,"_43":252,"_13":166,"_39":26,"_41":187,"_30":91,"_160":-5,"_240":253,"_33":254},{"_48":176,"_38":177,"_36":178,"_154":-5,"_46":47,"_45":179,"_156":31,"_43":249,"_13":158,"_39":40,"_41":181,"_30":91,"_160":-5,"_240":250,"_33":251},{"_48":169,"_38":170,"_36":171,"_154":-5,"_46":47,"_45":172,"_156":31,"_43":246,"_13":158,"_39":40,"_41":174,"_30":91,"_160":-5,"_240":247,"_33":248},{"_48":162,"_38":163,"_36":164,"_154":-5,"_46":47,"_45":158,"_156":31,"_43":243,"_13":166,"_39":40,"_41":167,"_30":91,"_160":-5,"_240":244,"_33":245},{"_48":151,"_38":152,"_36":153,"_154":-5,"_46":47,"_45":155,"_156":91,"_43":239,"_13":158,"_39":40,"_41":159,"_30":91,"_160":-5,"_240":241,"_33":242},["D",1785449313150],"children",[],[152],["D",1785446719355],[],[163],["D",1785446871390],[],[170],["D",1785449330437],[],[177],["D",1785446719355],[],[184],["D",1785446888490],[],[190],"10a5dd82-9daf-46d5-bc45-6c5059055f00","integration.ts","56cdfbe8-8c5e-11f1-a52a-1607ee4eb77e",18,["D",1785449381929],3,"import { httpEndpoint } from \"https://esm.town/v/std/utils/index.ts\";\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\nconst endpoint = await httpEndpoint(\"proxy/main.ts\");\nconst token = Deno.env.get(\"valtown\");\n\ntype TestResult = { name: string; passed: boolean; error?: string };\nconst results: TestResult[] = [];\n\nasync function test(name: string, fn: () => Promise) {\n try {\n await fn();\n results.push({ name, passed: true });\n console.log(`✅ ${name}`);\n } catch (e) {\n const msg = e instanceof Error ? e.message : String(e);\n results.push({ name, passed: false, error: msg });\n console.log(`❌ ${name}: ${msg}`);\n }\n}\n\nfunction assert(condition: boolean, message: string) {\n if (!condition) throw new Error(message);\n}\n\n// --- Backward compatibility tests (same API surface as old proxy) ---\n\n// 1. Unsupported path returns 404\nawait test(\"unsupported path returns 404\", async () => {\n const res = await fetch(`${endpoint}/v1/foo`);\n assert(res.status === 404, `Expected 404, got ${res.status}`);\n});\n\n// 2. No auth returns 401\nawait test(\"no auth returns 401\", async () => {\n const res = await fetch(`${endpoint}/v1/chat/completions`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({ model: \"gpt-5.6-luna\", messages: [] }),\n });\n assert(res.status === 401, `Expected 401, got ${res.status}`);\n});\n\n// 3. Invalid auth returns 401\nawait test(\"invalid auth returns 401\", async () => {\n const res = await fetch(`${endpoint}/v1/chat/completions`, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": \"Bearer invalid-token\",\n },\n body: JSON.stringify({ model: \"gpt-5.6-luna\", messages: [] }),\n });\n assert(res.status === 401, `Expected 401, got ${res.status}`);\n});\n\n// 4. Chat completions succeeds (backward compat: same API surface)\nawait test(\"chat completions succeeds\", async () => {\n const res = await fetch(`${endpoint}/v1/chat/completions`, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": `Bearer ${token}`,\n },\n body: JSON.stringify({\n model: \"gpt-5.6-luna\",\n messages: [{ role: \"user\", content: \"Say hello in one word\" }],\n max_completion_tokens: 10,\n }),\n });\n const body = await res.text();\n assert(res.status === 200, `Expected 200, got ${res.status}: ${body}`);\n const data = JSON.parse(body);\n assert(data.choices?.[0]?.message?.content, \"No message content in response\");\n // Verify spend header is present\n const remaining = res.headers.get(\"x-vt-openai-spend-remaining\");\n assert(remaining !== null, \"Missing x-vt-openai-spend-remaining header\");\n});\n\n// 5. Responses API succeeds (backward compat: same API surface)\nawait test(\"responses API succeeds\", async () => {\n const res = await fetch(`${endpoint}/v1/responses`, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": `Bearer ${token}`,\n },\n body: JSON.stringify({\n model: \"gpt-5.6-luna\",\n input: \"Say hello in one word\",\n }),\n });\n const body = await res.text();\n assert(res.status === 200, `Expected 200, got ${res.status}: ${body}`);\n const data = JSON.parse(body);\n const outputMsg = data.output?.find((o: { type: string }) => o.type === \"message\");\n const text = outputMsg?.content?.find((c: { type: string }) => c.type === \"output_text\")?.text;\n assert(text, `No output text in response. Body: ${body.slice(0, 500)}`);\n});\n\n// 6. SDK backward compatibility — ValTownOpenAI works end-to-end\nawait test(\"ValTownOpenAI SDK works end-to-end\", async () => {\n const { ValTownOpenAI } = await import(\"../main.ts\");\n const client = new ValTownOpenAI({});\n const response = await client.chat.completions.create({\n model: \"gpt-5.6-luna\",\n messages: [{ role: \"user\", content: \"Say hello in one word\" }],\n max_completion_tokens: 10,\n });\n assert(\n response.choices[0].message.content,\n \"No message content from SDK response\",\n );\n});\n\n// --- New behavior tests ---\n\n// 7. Streaming rejected with 400\nawait test(\"streaming rejected with 400\", async () => {\n const res = await fetch(`${endpoint}/v1/chat/completions`, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": `Bearer ${token}`,\n },\n body: JSON.stringify({\n model: \"gpt-5.6-luna\",\n messages: [{ role: \"user\", content: \"Hi\" }],\n stream: true,\n }),\n });\n assert(res.status === 400, `Expected 400, got ${res.status}`);\n const data = await res.json();\n assert(\n data.error?.toLowerCase().includes(\"stream\"),\n `Expected streaming error, got: ${data.error}`,\n );\n});\n\n// 8. Unknown model rejected with 400\nawait test(\"unknown model rejected with 400\", async () => {\n const res = await fetch(`${endpoint}/v1/chat/completions`, {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n \"Authorization\": `Bearer ${token}`,\n },\n body: JSON.stringify({\n model: \"gpt-999-turbo\",\n messages: [{ role: \"user\", content: \"Hi\" }],\n }),\n });\n assert(res.status === 400, `Expected 400, got ${res.status}`);\n const data = await res.json();\n assert(\n data.error?.includes(\"pricing table\"),\n `Expected pricing error, got: ${data.error}`,\n );\n assert(\n Array.isArray(data.available) && data.available.length > 0,\n \"Expected available models list\",\n );\n});\n\n// 9. Spend recorded in SQLite after successful request\nawait test(\"spend recorded in SQLite\", async () => {\n // Give the fire-and-forget write time to complete\n await new Promise((r) => setTimeout(r, 2000));\n\n const result = await sqlite.execute({\n sql: `SELECT COUNT(*) as count, SUM(cost) as total\n FROM openai_spend\n WHERE timestamp > datetime('now', '-5 minutes')`,\n args: [],\n });\n const count = Number(result.rows[0][0]);\n const total = Number(result.rows[0][1] ?? 0);\n assert(count > 0, \"No spend records found in the last 5 minutes\");\n assert(total > 0, \"Spend total is zero — cost was not recorded\");\n console.log(` Found ${count} spend records, total cost: ${total.toFixed(8)}`);\n});\n\n// Summary\nconst passed = results.filter((r) => r.passed).length;\nconst failed = results.length - passed;\nconsole.log(\n `\\n${passed}/${results.length} tests passed${failed ? `, ${failed} failed` : \"\"}`,\n);\n",[],[197,259],["D",1785447223616],[232],[197],"e9dd5295-9283-4352-b940-d2fda5281107","7fb4e69e-8c5d-11f1-88fd-1607ee4eb77e",16,["D",1785449369525],"http","import { parseBearerString } from \"https://esm.town/v/andreterron/parseBearerString\";\nimport { API_URL } from \"https://esm.town/v/std/API_URL?v=5\";\nimport { hasPricing, PRICING, calculateCost } from \"../pricing.ts\";\nimport {\n initSchema,\n checkBudget,\n recordSpend,\n type Subject,\n} from \"../ledger.ts\";\n\n/**\n * OpenAI API proxy with dollar-based rate limiting.\n *\n * Replaces std/openaiproxy. Moved into std/openai to use project-scoped SQLite.\n *\n * Simplifications vs old proxy:\n * - No streaming (rejected with 400)\n * - No model gating — any priced model is allowed, budget is the guard\n * - No request count limits — dollars are the only limit\n * - Unknown models rejected (400) — never free-by-accident\n *\n * Budgets (per calendar month, UTC):\n * - free: $1\n * - pro: $10\n * - business: $40\n *\n * Budget follows the val's owning org (from /v1/me).\n *\n * Env vars (add to std/openai before cutover):\n * - OPENAI_API_KEY\n * - OPENAI_API_ORG\n */\n\nconst allowedPathnames = [\n \"/\",\n \"/v1/chat/completions\",\n \"/v1/responses\",\n \"/v1/embeddings\",\n];\n\nlet schemaInitialized = false;\n\nexport default async function(req: Request): Promise {\n if (!schemaInitialized) {\n await initSchema();\n schemaInitialized = true;\n }\n\n const { pathname, search } = new URL(req.url);\n\n if (pathname === \"/\") {\n return new Response(\"OK\");\n }\n\n if (!allowedPathnames.includes(pathname)) {\n return new Response(\"Path not supported\", { status: 404 });\n }\n\n // --- Authenticate ---\n const authHeader = req.headers.get(\"Proxy-Authorization\") ||\n req.headers.get(\"Authorization\");\n const token = authHeader ? parseBearerString(authHeader) : undefined;\n const meRes = await fetch(`${API_URL}/v1/me`, {\n headers: { Authorization: `Bearer ${token}` },\n });\n if (!meRes.ok) {\n return new Response(\"Unauthorized\", { status: 401 });\n }\n const me = await meRes.json();\n\n // --- Determine budget subject (the val's owning org) ---\n const subject: Subject = me.org\n ? {\n id: me.org.id,\n type: \"org\",\n handle: me.org.name ?? me.username,\n tier: me.org.tier ?? me.tier ?? \"free\",\n }\n : {\n id: me.id,\n type: \"user\",\n handle: me.username,\n tier: me.tier ?? \"free\",\n };\n\n // --- Pre-flight budget check ---\n const budget = await checkBudget(subject);\n if (budget.exceeded) {\n return jsonResponse(\n {\n error: \"Monthly budget exceeded\",\n spent: formatUSD(budget.spent),\n budget: formatUSD(budget.budget),\n resets: \"next calendar month (UTC)\",\n },\n 402,\n { \"x-vt-openai-spend-remaining\": \"0\" },\n );\n }\n\n // --- Parse request body ---\n let body: Record;\n try {\n body = await req.json();\n } catch {\n return jsonResponse({ error: \"Invalid JSON body\" }, 400);\n }\n\n // --- Reject streaming ---\n if (body.stream === true) {\n return jsonResponse(\n { error: \"Streaming is not supported. Set stream: false or omit it.\" },\n 400,\n );\n }\n\n // --- Reject unknown models ---\n const model = body.model as string | undefined;\n if (!model || !hasPricing(model)) {\n return jsonResponse(\n {\n error: `Model '${model}' is not in the pricing table.`,\n available: Object.keys(PRICING),\n },\n 400,\n );\n }\n\n // --- Proxy to OpenAI ---\n const url = new URL(\".\" + pathname, \"https://api.openai.com\");\n url.search = search;\n\n const headers = new Headers(req.headers);\n headers.set(\"Host\", url.hostname);\n headers.set(\"Authorization\", `Bearer ${Deno.env.get(\"OPENAI_API_KEY\")}`);\n headers.set(\"OpenAI-Organization\", Deno.env.get(\"OPENAI_API_ORG\") ?? \"\");\n headers.delete(\"Proxy-Authorization\");\n\n const openAIRes = await fetch(url, {\n method: req.method,\n headers,\n body: JSON.stringify(body),\n redirect: \"manual\",\n });\n\n // Copy response headers (fetch response headers are immutable in Deno)\n const responseHeaders = new Headers(openAIRes.headers);\n responseHeaders.delete(\"openai-organization\");\n\n // --- Pass through non-200 responses without recording spend ---\n if (openAIRes.status !== 200) {\n return new Response(openAIRes.body, {\n status: openAIRes.status,\n headers: responseHeaders,\n });\n }\n\n // --- Parse response to extract usage ---\n const responseText = await openAIRes.text();\n let responseData: Record;\n try {\n responseData = JSON.parse(responseText);\n } catch {\n // Can't parse — return as-is\n return new Response(responseText, {\n status: openAIRes.status,\n headers: responseHeaders,\n });\n }\n\n // --- Extract usage and record spend ---\n const usage = extractUsage(pathname, responseData);\n let cost = 0;\n if (usage) {\n cost = calculateCost(\n model,\n usage.input,\n usage.cached,\n usage.output,\n );\n // Fire-and-forget — don't add to request latency\n recordSpend(subject, model, usage.input, usage.cached, usage.output)\n .catch((e) => console.error(\"Failed to record spend:\", e));\n }\n\n // --- Return response with spend header ---\n const remainingAfter = Math.max(\n 0,\n budget.remaining - cost,\n );\n const res = new Response(responseText, {\n status: openAIRes.status,\n headers: responseHeaders,\n });\n res.headers.set(\"x-vt-openai-spend-remaining\", String(remainingAfter));\n return res;\n}\n\n/**\n * Extract token usage from different OpenAI API response formats.\n *\n * Chat completions: usage.prompt_tokens, usage.completion_tokens,\n * usage.prompt_tokens_details.cached_tokens\n * Responses API: usage.input_tokens, usage.output_tokens,\n * usage.input_tokens_details.cached_tokens\n * Embeddings: usage.prompt_tokens (output is always 0)\n */\nfunction extractUsage(\n pathname: string,\n data: Record,\n): { input: number; cached: number; output: number } | null {\n const usage = data.usage as Record | undefined;\n if (!usage) return null;\n\n if (pathname === \"/v1/responses\") {\n const inputDetails = usage.input_tokens_details as\n | Record\n | undefined;\n return {\n input: Number(usage.input_tokens) || 0,\n cached: Number(inputDetails?.cached_tokens) || 0,\n output: Number(usage.output_tokens) || 0,\n };\n }\n\n // Chat completions + embeddings share the same shape\n const promptDetails = usage.prompt_tokens_details as\n | Record\n | undefined;\n return {\n input: Number(usage.prompt_tokens) || 0,\n cached: Number(promptDetails?.cached_tokens) || 0,\n output: Number(usage.completion_tokens) || 0,\n };\n}\n\nfunction jsonResponse(\n body: unknown,\n status: number,\n extraHeaders?: Record,\n): Response {\n const headers: Record = {\n \"Content-Type\": \"application/json\",\n ...extraHeaders,\n };\n return new Response(JSON.stringify(body), { status, headers });\n}\n\nfunction formatUSD(amount: number): string {\n return `${amount.toFixed(2)}`;\n}\n",[],[204,170],["D",1785446862743],[230],[204],"24f4c05a-6867-497e-95f6-1413499358d7","web-search.ts","019fb4ea-df76-7108-899d-476b76b86df2",["D",1785446719355],"// Web search via the Responses API — incredibly effective for enrichment.\n//\n// The Responses API (responses.create) supports the web_search tool, which lets\n// the model browse the web in real time. This is dramatically more effective than\n// passing static text — the model can look up people, companies, products, and\n// current events on its own.\n//\n// Great use cases: lead enrichment, company research, summarizing a topic,\n// fact-checking, or anything where fresh data beats stale training knowledge.\n\nimport { ValTownOpenAI } from \"../main.ts\";\n\nconst openai = new ValTownOpenAI({});\n\nconst response = await openai.responses.create({\n model: \"gpt-5.6-luna\",\n tools: [{ type: \"web_search\" }],\n instructions:\n \"You research companies. Given a company name, reply in 2-3 short plain-text lines: what they do, their stage, and why a developer might care. No markdown.\",\n input: \"Val Town\",\n});\n\nconsole.log(response.output_text);\n",[],[210,282],"c9a57e15-5ed3-4b2e-8e25-1e0d4fff5aef","structured-outputs.ts","019fb4ea-df76-7108-899d-43a30fa43e51",["D",1785446719355],"// Structured outputs via the Responses API — reliable, typed JSON.\n//\n// Instead of asking the model to \"return JSON\" and manually parsing/free-text\n// cleaning the response, pass a JSON schema in `text.format`. The model is\n// constrained to output JSON that matches your schema exactly — no fence\n// stripping, no regex, no try/catch on malformed JSON.\n//\n// This is the idiomatic approach for any task where you need the model's answer\n// as structured data: classification, scoring, extraction, routing decisions, etc.\n\nimport { ValTownOpenAI } from \"../main.ts\";\n\nconst openai = new ValTownOpenAI({});\n\nconst response = await openai.responses.create({\n model: \"gpt-5.6-luna\",\n instructions:\n \"You classify user feedback. Given a piece of feedback, classify it and write a one-sentence summary.\",\n input: \"The app keeps logging me out every 5 minutes, it's really frustrating.\",\n text: {\n format: {\n type: \"json_schema\",\n name: \"classification\",\n schema: {\n type: \"object\",\n properties: {\n category: {\n type: \"string\",\n enum: [\"bug\", \"feature_request\", \"praise\", \"question\"],\n },\n priority: {\n type: \"string\",\n enum: [\"low\", \"medium\", \"high\"],\n },\n summary: { type: \"string\" },\n },\n required: [\"category\", \"priority\", \"summary\"],\n additionalProperties: false,\n },\n },\n },\n});\n\n// output_text is guaranteed valid JSON matching the schema.\nconst result = JSON.parse(response.output_text);\nconsole.log(result);\n",[],[210,289],"cc3de97b-e809-46ab-b4f5-ada6b8808bb2","bring-your-own-key.ts","019fb4ea-df75-7236-add3-8098418c5d6a",["D",1785446719355],"// Bring your own OpenAI API key — or use the built-in Val Town proxy.\n//\n// If you set the OPENAI_API_KEY environment variable, all requests go directly\n// to OpenAI with no rate limits or proxy restrictions. If you don't, requests\n// fall back to ValTownOpenAI, which routes through our proxy (no key needed,\n// subject to free-tier quotas).\n//\n// This is the recommended pattern for production vals: start on the free proxy,\n// then add an API key when you outgrow the limits.\n\nimport { ValTownOpenAI } from \"../main.ts\";\nimport OpenAI from \"npm:openai\";\n\n// Use your own key if available, otherwise the Val Town proxy.\nconst apiKey = Deno.env.get(\"OPENAI_API_KEY\");\nconst openai = apiKey ? new OpenAI({ apiKey }) : new ValTownOpenAI({});\n\nconst completion = await openai.chat.completions.create({\n model: \"gpt-5.6-luna\",\n messages: [{ role: \"user\", content: \"Say hello in one word.\" }],\n});\n\nconsole.log(completion.choices[0].message.content);\n",[],[210,296],["D",1785446719355],[226,227,228],[210],["D",1746043648993],["D",1789474235934],{"_105":104,"_112":108},{"_105":104,"_106":-5,"_107":108,"_19":-5,"_109":110,"_111":91},{"_13":92,"_38":93,"_48":47,"_94":49,"_95":96,"_97":98,"_99":55,"_100":49,"_101":67,"_102":50,"_103":104},"ctx",{"_84":-5,"_133":343,"_344":345,"_346":347,"_348":91,"_349":91,"_350":91,"_351":31,"_352":-5,"_353":-7,"_354":-7,"_355":166,"_356":91,"_357":91,"_358":-5,"_359":91,"_360":91,"_361":91,"_362":-5},"ENV",{"_314":315,"_316":317,"_318":139,"_319":320,"_321":322,"_323":324,"_325":326,"_327":328,"_329":330,"_331":332,"_333":334,"_335":336,"_337":338,"_339":340,"_341":342},"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 · v20