[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_193":194,"_195":196},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":16,"_18":19,"_17":-7,"_145":-5,"_20":146,"_22":147,"_148":149,"_150":151,"_25":152,"_24":-5,"_153":-5,"_154":-5,"_155":55,"_156":157,"_158":46,"_159":-5,"_160":-5,"_161":162},"routes/_app.x.$handle.$name.branch.$branch.code.$",{"_11":12,"_13":14,"_15":16,"_17":-7,"_18":19,"_20":21,"_22":23,"_24":-7,"_25":26,"_27":-5,"_28":-5,"_29":-5,"_30":-5,"_31":-5},"handle","ziggyware","name","deployer","branchName","main","version","path","","project",{"_35":87,"_13":14,"_47":88,"_89":-5,"_90":55,"_91":92,"_93":92,"_94":95,"_96":-5,"_97":98,"_99":-5,"_100":55,"_101":-5,"_102":-5,"_103":104,"_105":106,"_107":108,"_109":110,"_111":112,"_113":-5,"_114":115,"_116":115,"_117":118,"_119":118,"_120":118,"_121":115,"_122":115,"_123":124,"_125":126,"_127":128,"_129":55},"tree",[74,75,76],"file","contents",[32,33,34],"upstream","pull","ahead","behind","envVars",{"_35":67,"_13":68,"_38":69,"_40":-5,"_41":42,"_43":70,"_45":46,"_47":71,"_17":72,"_50":64,"_52":19,"_54":55,"_56":-5,"_18":73},{"_35":58,"_13":59,"_38":60,"_40":-5,"_41":42,"_43":61,"_45":46,"_47":62,"_17":63,"_50":64,"_52":65,"_54":55,"_56":-5,"_18":66},{"_35":36,"_13":37,"_38":39,"_40":-5,"_41":42,"_43":44,"_45":46,"_47":48,"_17":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_18":57},"id","1ddde7a8-553b-11f1-b24a-ee650bb23af1","valtown-api.ts","fileId","02ad359c-553b-11f1-9ec1-ee650bb23af1","parentId","branchId","8fc40db2-553a-11f1-97ac-ee650bb23af1","branchVersion",8,"latest",true,"createdAt",["D",1779384781757],3,"fileType","script","content","import { Context, Hono } from \"npm:hono\";\n\nconst app = new Hono();\n\n// --- API DATA STRUCTURES ---\n\ninterface User {\n id: string;\n username: string;\n profileImageUrl: string | null;\n bio: string | null;\n}\n\ninterface Agent {\n id: string;\n name: string;\n author: User;\n privacy: \"public\" | \"unlisted\" | \"private\";\n}\n\ninterface AgentFile {\n agentId: string;\n name: string;\n path: string;\n content: string;\n type: \"file\" | \"http\" | \"script\";\n version: number;\n createdAt: string;\n updatedAt: string;\n}\n\ninterface Result {\n ok: boolean;\n data: T | string;\n}\n\n// --- HELPERS ---\n\nconst validateBody = (\n body: any,\n requiredFields: string[],\n): { valid: boolean; message: string } => {\n for (const field of requiredFields) {\n if (!body || !body[field]) {\n return { valid: false, message: `Missing required field: '${field}'` };\n }\n }\n return { valid: true, message: \"OK\" };\n};\n\nconst callValTownApi = async (\n url: string,\n method: string,\n bodyData: object | null = null,\n): Promise> => {\n const options: RequestInit = {\n method: method,\n headers: {\n \"Authorization\": \"Bearer \" + Deno.env.get(\"APITOKEN\"),\n \"Content-Type\": \"application/json\",\n },\n };\n\n if (bodyData) {\n options.body = JSON.stringify(bodyData);\n }\n\n try {\n const resp = await fetch(url, options);\n const text = await resp.text();\n\n if (!resp.ok) {\n return { ok: false, data: `API Error ${resp.status}: ${text}` };\n }\n\n try {\n const data = JSON.parse(text);\n return { ok: true, data: data };\n } catch {\n return { ok: true, data: text };\n }\n } catch (e: any) {\n return { ok: false, data: `Internal error: ${e.message}` };\n }\n};\n\n// --- CRUD Operations for Val Resources ---\n\nconst createAgent = async (\n config: {\n name: string;\n description?: string;\n privacy?: Agent[\"privacy\"];\n code?: string;\n },\n): Promise> => {\n const createConfig = {\n ...config,\n privacy: config.privacy || \"public\",\n };\n\n const result = await callValTownApi(\n \"https://api.val.town/v2/vals\",\n \"POST\",\n createConfig,\n );\n return (result.ok\n ? { ok: true, data: result.data as Agent }\n : result as Result);\n};\n\nconst updateAgent = async (\n agentId: string,\n config: {\n name?: string;\n description?: string;\n privacy?: Agent[\"privacy\"];\n code?: string;\n },\n): Promise> => {\n const result = await callValTownApi(\n `https://api.val.town/v2/vals/${agentId}`,\n \"PUT\",\n config,\n );\n return result.ok ? { ok: true, data: result.data as Agent } : result;\n};\n\nconst deleteAgent = async (agentId: string): Promise> => {\n const result = await callValTownApi(\n `https://api.val.town/v2/vals/${agentId}`,\n \"DELETE\",\n );\n return result.ok ? { ok: true, data: \"Agent deleted successfully\" } : result;\n};\n\n/**\n * Adds an environment variable to a specific Val.\n */\nconst addEnvironmentVariable = async (\n agentId: string,\n key: string,\n value: string,\n): Promise> => {\n const url = `https://api.val.town/v2/vals/${agentId}/environment_variables`;\n const body = { key, value };\n return await callValTownApi(url, \"POST\", body);\n};\n\n// --- CRUD Operations for Val File Resources ---\nconst createOrUpdateFile = async (\n agentId: string,\n path: string,\n fileName: string,\n fileType: string,\n content: string,\n method: \"POST\" | \"PUT\",\n): Promise> => {\n const fullPath: string = path + fileName;\n // We do NOT split the path here anymore. The 'name' field in the body represents the path.\n const requestBody = {\n type: fileType,\n name: fileName, // e.g. \"src/data.json\"\n content: content,\n };\n\n // We send the request to the base /files endpoint. The 'name' in the body dictates the path.\n const url = `https://api.val.town/v2/vals/${agentId}/files?path=${fullPath}`;\n\n const result = await callValTownApi(url, method, requestBody);\n return result.ok ? { ok: true, data: result.data as AgentFile } : result;\n};\n\nconst deleteFile = async (\n agentId: string,\n path: string,\n fileName: string,\n): Promise> => {\n const fullPath = path + fileName;\n // Ensure the path parameter handles slashes correctly if required by API,\n // though usually query params handle strings as-is (encoded by browser/fetch).\n const result = await callValTownApi(\n `https://api.val.town/v2/vals/${agentId}/files?path=${fullPath}`,\n \"DELETE\",\n );\n return result.ok ? { ok: true, data: \"File deleted successfully\" } : result;\n};\n\n// --- ORCHESTRATION FUNCTIONS ---\n\n// --- MIDDLEWARE ---\n\napp.use(\"*\", async (c, next) => {\n c.header(\"Access-Control-Allow-Origin\", \"https://agentfactory.val.run\");\n c.header(\"Access-Control-Allow-Methods\", \"GET, POST, PUT, DELETE, OPTIONS\");\n c.header(\"Access-Control-Allow-Headers\", \"Content-Type, Authorization\");\n\n if (c.req.method === \"OPTIONS\") return c.text(\"OK\", 200);\n await next();\n});\n\n// --- ROUTES ---\n\napp.post(\"/agent\", async (c) => {\n try {\n const body = await c.req.json();\n const validation = validateBody(body, [\"name\"]);\n\n if (!validation.valid) {\n return c.json({ ok: false, data: validation.message }, 400);\n }\n\n const res = await createAgent(body);\n return c.json(res, res.ok ? 200 : 400);\n } catch (e: any) {\n return c.json({ ok: false, data: e.message }, 500);\n }\n});\n\napp.put(\"/agent/:agentId\", async (c) => {\n try {\n const agentId = c.req.param(\"agentId\");\n const body = await c.req.json();\n\n if (Object.keys(body).length === 0) {\n return c.json({ ok: false, data: \"No update parameters provided.\" }, 400);\n }\n\n const res = await updateAgent(agentId, body);\n return c.json(res, res.ok ? 200 : 400);\n } catch (e: any) {\n return c.json({\n ok: false,\n data: `Error in update agent: data: ${e.message}\\n${e.stack}`,\n }, 500);\n }\n});\n\napp.delete(\"/agent/:agentId\", async (c) => {\n try {\n const agentId = c.req.param(\"agentId\");\n const res = await deleteAgent(agentId);\n return c.json(res, res.ok ? 200 : 400);\n } catch (e: any) {\n return c.json({ ok: false, data: e.message }, 500);\n }\n});\n\napp.post(\"/agent/:agentId/files\", async (c) => {\n try {\n const agentId = c.req.param(\"agentId\");\n const path = c.req.query(\"path\");\n const body = await c.req.json();\n\n const validation = validateBody(body, [\"content\", \"type\", \"name\"]);\n if (!validation.valid) {\n return c.json({ ok: false, data: validation.message }, 400);\n }\n\n // filename here might contain slashes if encoded correctly in URL, or passed differently.\n // However, createOrUpdateFile now treats the second argument as the full path.\n const res = await createOrUpdateFile(\n agentId,\n path,\n body.name,\n body.type,\n body.content,\n \"POST\",\n );\n return c.json(res, res.ok ? 200 : 400);\n } catch (e: any) {\n return c.json({ ok: false, data: e.message }, 500);\n }\n});\n\napp.put(\"/agent/:agentId/files\", async (c) => {\n try {\n const agentId = c.req.param(\"agentId\");\n const path = c.req.query(\"path\");\n const body = await c.req.json();\n\n const validation = validateBody(body, [\"content\", \"type\"]);\n if (!validation.valid) {\n return c.json({ ok: false, data: validation.message }, 400);\n }\n\n const res = await createOrUpdateFile(\n agentId,\n path,\n body.filename,\n body.type,\n body.content,\n \"PUT\",\n );\n return c.json(res, res.ok ? 200 : 400);\n } catch (e: any) {\n return c.json({ ok: false, data: e.message }, 500);\n }\n});\n\napp.delete(\"/agent/:agentId/files\", async (c) => {\n try {\n const agentId = c.req.param(\"agentId\");\n const path = c.req.query(\"path\");\n const filename = c.req.query(\"filename\");\n const res = await deleteFile(agentId, path, filename);\n return c.json(res, res.ok ? 200 : 400);\n } catch (e: any) {\n return c.json({ ok: false, data: e.message }, 500);\n }\n});\n\napp.get(\"/\", (c) => {\n return c.json({\n \"info\": {\n \"title\": \"AgentFactory API\",\n \"version\": \"1.0.0\",\n \"description\":\n \"Orchestration API for managing Agents (Vals) and their associated Files.\",\n },\n \"models\": [\n {\n \"name\": \"User\",\n \"description\": \"Represents the author of an Agent.\",\n \"fields\": [\n {\n \"name\": \"id\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"username\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"profileImageUrl\",\n \"type\": \"string | null\",\n \"required\": false,\n },\n {\n \"name\": \"bio\",\n \"type\": \"string | null\",\n \"required\": false,\n },\n ],\n },\n {\n \"name\": \"Agent\",\n \"description\": \"The core resource representing a Val.\",\n \"fields\": [\n {\n \"name\": \"id\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"name\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"author\",\n \"type\": \"User\",\n \"required\": true,\n },\n {\n \"name\": \"privacy\",\n \"type\": \"'public' | 'unlisted' | 'private'\",\n \"required\": true,\n },\n ],\n },\n {\n \"name\": \"AgentFile\",\n \"description\": \"A file belonging to an Agent.\",\n \"fields\": [\n {\n \"name\": \"agentId\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"name\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"path\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"content\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"type\",\n \"type\": \"'file' | 'http' | 'script'\",\n \"required\": true,\n },\n {\n \"name\": \"version\",\n \"type\": \"number\",\n \"required\": true,\n },\n {\n \"name\": \"createdAt\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"updatedAt\",\n \"type\": \"string\",\n \"required\": true,\n },\n ],\n },\n {\n \"name\": \"Result\",\n \"description\": \"Standard API response wrapper.\",\n \"fields\": [\n {\n \"name\": \"ok\",\n \"type\": \"boolean\",\n \"required\": true,\n },\n {\n \"name\": \"data\",\n \"type\": \"T | string\",\n \"required\": true,\n \"description\": \"Payload or error message\",\n },\n ],\n },\n ],\n \"endpoints\": [\n {\n \"method\": \"GET\",\n \"path\": \"/\",\n \"summary\": \"System Diagnostics\",\n \"description\":\n \"Runs a full workflow test: creates an agent, adds files, updates them, and cleans up.\",\n \"parameters\": [],\n \"responses\": [\n {\n \"status\": 200,\n \"type\": \"Result<{ ok: boolean, debugInfo: string[] }>\",\n \"description\": \"Test sequence successful\",\n },\n {\n \"status\": 400,\n \"type\": \"Result<{ ok: boolean, debugInfo: string[] }>\",\n \"description\": \"Test sequence failed\",\n },\n ],\n },\n {\n \"method\": \"POST\",\n \"path\": \"/agent\",\n \"summary\": \"Create Agent\",\n \"description\": \"Creates a new Agent (Val) resource.\",\n \"parameters\": [],\n \"body\": {\n \"fields\": [\n {\n \"name\": \"name\",\n \"type\": \"string\",\n \"required\": true,\n \"description\": \"Unique name for the agent\",\n },\n {\n \"name\": \"description\",\n \"type\": \"string\",\n \"required\": false,\n },\n {\n \"name\": \"privacy\",\n \"type\": \"'public' | 'unlisted' | 'private'\",\n \"required\": false,\n \"default\": \"'public'\",\n },\n {\n \"name\": \"code\",\n \"type\": \"string\",\n \"required\": false,\n \"description\": \"Initial source code\",\n },\n ],\n },\n \"responses\": [\n {\n \"status\": 200,\n \"type\": \"Result\",\n },\n {\n \"status\": 400,\n \"type\": \"Result\",\n \"description\": \"Validation error\",\n },\n {\n \"status\": 500,\n \"type\": \"Result\",\n \"description\": \"Internal server error\",\n },\n ],\n },\n {\n \"method\": \"PUT\",\n \"path\": \"/agent/:agentId\",\n \"summary\": \"Update Agent\",\n \"description\":\n \"Updates an existing Agent's metadata or privacy settings.\",\n \"parameters\": [\n {\n \"name\": \"agentId\",\n \"in\": \"path\",\n \"type\": \"string\",\n \"required\": true,\n },\n ],\n \"body\": {\n \"fields\": [\n {\n \"name\": \"name\",\n \"type\": \"string\",\n \"required\": false,\n },\n {\n \"name\": \"description\",\n \"type\": \"string\",\n \"required\": false,\n },\n {\n \"name\": \"privacy\",\n \"type\": \"'public' | 'unlisted' | 'private'\",\n \"required\": false,\n },\n {\n \"name\": \"code\",\n \"type\": \"string\",\n \"required\": false,\n },\n ],\n },\n \"responses\": [\n {\n \"status\": 200,\n \"type\": \"Result\",\n },\n {\n \"status\": 400,\n \"type\": \"Result\",\n \"description\": \"No parameters provided\",\n },\n {\n \"status\": 500,\n \"type\": \"Result\",\n },\n ],\n },\n {\n \"method\": \"DELETE\",\n \"path\": \"/agent/:agentId\",\n \"summary\": \"Delete Agent\",\n \"description\": \"Permanently removes an Agent resource.\",\n \"parameters\": [\n {\n \"name\": \"agentId\",\n \"in\": \"path\",\n \"type\": \"string\",\n \"required\": true,\n },\n ],\n \"responses\": [\n {\n \"status\": 200,\n \"type\": \"Result\",\n \"description\": \"Success message\",\n },\n {\n \"status\": 500,\n \"type\": \"Result\",\n },\n ],\n },\n {\n \"method\": \"POST\",\n \"path\": \"/agent/:agentId/files\",\n \"summary\": \"Create File\",\n \"description\": \"Adds a new file to the specified Agent.\",\n \"parameters\": [\n {\n \"name\": \"agentId\",\n \"in\": \"path\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"path\",\n \"in\": \"query\",\n \"type\": \"string\",\n \"required\": false,\n \"description\": \"Base directory path\",\n },\n ],\n \"body\": {\n \"fields\": [\n {\n \"name\": \"name\",\n \"type\": \"string\",\n \"required\": true,\n \"description\": \"Filename (appended to path)\",\n },\n {\n \"name\": \"type\",\n \"type\": \"'file' | 'http' | 'script'\",\n \"required\": true,\n },\n {\n \"name\": \"content\",\n \"type\": \"string\",\n \"required\": true,\n },\n ],\n },\n \"responses\": [\n {\n \"status\": 200,\n \"type\": \"Result\",\n },\n {\n \"status\": 400,\n \"type\": \"Result\",\n \"description\": \"Validation error\",\n },\n {\n \"status\": 500,\n \"type\": \"Result\",\n },\n ],\n },\n {\n \"method\": \"PUT\",\n \"path\": \"/agent/:agentId/files\",\n \"summary\": \"Update File\",\n \"description\": \"Updates content of an existing file.\",\n \"parameters\": [\n {\n \"name\": \"agentId\",\n \"in\": \"path\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"path\",\n \"in\": \"query\",\n \"type\": \"string\",\n \"required\": true,\n \"description\": \"Full filename/path to update\",\n },\n ],\n \"body\": {\n \"fields\": [\n {\n \"name\": \"type\",\n \"type\": \"'file' | 'http' | 'script'\",\n \"required\": true,\n },\n {\n \"name\": \"content\",\n \"type\": \"string\",\n \"required\": true,\n },\n ],\n },\n \"responses\": [\n {\n \"status\": 200,\n \"type\": \"Result\",\n },\n {\n \"status\": 400,\n \"type\": \"Result\",\n },\n {\n \"status\": 500,\n \"type\": \"Result\",\n },\n ],\n },\n {\n \"method\": \"DELETE\",\n \"path\": \"/agent/:agentId/files\",\n \"summary\": \"Delete File\",\n \"description\": \"Removes a file from the Agent.\",\n \"parameters\": [\n {\n \"name\": \"agentId\",\n \"in\": \"path\",\n \"type\": \"string\",\n \"required\": true,\n },\n {\n \"name\": \"path\",\n \"in\": \"query\",\n \"type\": \"string\",\n \"required\": true,\n \"description\": \"path part of file to delete\",\n },\n {\n \"name\": \"filename\",\n \"in\": \"query\",\n \"type\": \"string\",\n \"required\": true,\n \"description\": \"filename of file path to delete\",\n },\n ],\n \"responses\": [\n {\n \"status\": 200,\n \"type\": \"Result\",\n \"description\": \"Success message\",\n },\n {\n \"status\": 500,\n \"type\": \"Result\",\n },\n ],\n },\n ],\n });\n});\n\n// Test Route for full workflow\napp.get(\"/test\", async (c) => {\n const testAgentName = \"test_\" + new Date().getTime().toString();\n const testFilename = \"main.ts\"; // Basic name\n const testPath = \"src/\";\n\n const initialContent = \"export function run() { return 'Test content'; }\";\n\n let debug: string[] = [];\n let agentRes: Result;\n let fileRes: Result | null = null;\n\n try {\n // 1. Create Val\n agentRes = await createAgent({ name: testAgentName, code: initialContent });\n debug.push(`Create Agent response: ${JSON.stringify(agentRes)}`);\n\n if (agentRes.ok) {\n const agentId = (agentRes.data as Agent).id;\n\n // --- ADD ENVIRONMENT VARIABLE ---\n const currentApiToken = Deno.env.get(\"APITOKEN\");\n if (currentApiToken) {\n const envVarResult = await addEnvironmentVariable(\n agentId,\n \"APITOKEN\",\n currentApiToken,\n );\n debug.push(`Add Env Var response: ${JSON.stringify(envVarResult)}`);\n } else {\n debug.push(\n \"SKIPPING Env Var: No APITOKEN found in current environment\",\n );\n }\n // --------------------------------\n\n // 2. Create File within Val (USING FULL PATH)\n fileRes = await createOrUpdateFile(\n agentId,\n testPath,\n testFilename,\n \"http\",\n initialContent,\n \"POST\",\n );\n debug.push(`Create HTTP File response: ${JSON.stringify(fileRes)}`);\n\n // 3. Update File\n let updateResult;\n if (fileRes.ok === true) {\n const updatedContent =\n \"export function run() { return 'Updated content'; }\";\n updateResult = await createOrUpdateFile(\n agentId,\n testPath,\n testFilename,\n \"http\",\n updatedContent,\n \"PUT\",\n );\n if (updateResult.ok === true) {\n debug.push(`Update File response: ${JSON.stringify(updateResult)}`);\n } else {\n const msg = `ERROR IN UPDATE FILE RESPONSE ${\n JSON.stringify(updateResult)\n }`;\n debug.push(msg);\n }\n } else {\n const msg = `ERROR IN CREATE FILE RESPONSE ${\n JSON.stringify(updateResult)\n }`;\n debug.push(msg);\n throw new Error(msg);\n }\n }\n } catch (e: any) {\n debug.push(`Caught error during test: ${e.message}`);\n } finally {\n // 4. Cleanup\n if (agentRes && agentRes.ok === true) {\n const agentId = (agentRes.data as Agent).id;\n try {\n const delFileRes = await deleteFile(agentId, testPath, testFilename);\n if (delFileRes.ok === true) {\n debug.push(\n `Delete File cleanup response: ${JSON.stringify(delFileRes)}`,\n );\n } else {\n debug.push(`DELETE FILE FAILED: ${JSON.stringify(delFileRes)}`);\n }\n } catch (err) {\n debug.push(`ERROR IN CLEANUP: ${err.message}\\n${err.stack}`);\n }\n try {\n const delAgentRes = await deleteAgent(agentId);\n if (delAgentRes.ok === true) {\n debug.push(\n `Delete agent cleanup response: ${JSON.stringify(delAgentRes)}`,\n );\n } else {\n debug.push(`DELETE AGENT FAILED: ${JSON.stringify(delAgentRes)}`);\n }\n } catch (err) {\n debug.push(`ERROR IN CLEANUP: ${err.message}\\n${err.stack}`);\n }\n }\n }\n\n const overallSuccess = agentRes?.ok === true && fileRes?.ok === true;\n return c.json(\n { ok: overallSuccess, debugInfo: debug },\n overallSuccess ? 200 : 400,\n );\n});\n\nexport default app.fetch;","deleted",false,"label",[37],"29063b62-5dce-11f1-8cf6-1607ee4eb77e","main.ts","8fc70724-553a-11f1-97ac-ee650bb23af1",15,["D",1780327545785],7,"http","// ============================================================\n// TYPES\n// ============================================================\n\nexport type Privacy = \"public\" | \"unlisted\" | \"private\";\nexport type FileType = \"file\" | \"http\" | \"interval\" | \"email\" | \"script\";\n\nexport interface Val {\n id: string;\n name: string;\n privacy: Privacy;\n description?: string;\n createdAt: string;\n httpUrl: string;\n}\n\nexport interface ValFile {\n path: string;\n name: string;\n type: FileType;\n version: number;\n lastModified?: string;\n}\n\nexport interface EnvVar {\n key: string;\n description: string;\n createdAt: string;\n updatedAt: string;\n}\n\nexport interface HttpResponse {\n status: number;\n ok: boolean;\n text: string;\n json: unknown;\n}\n\nexport interface CreateValOptions {\n privacy?: Privacy;\n description?: string;\n code?: string;\n}\n\nexport interface CreateFileOptions {\n content?: string;\n type?: FileType;\n branchId?: string;\n}\n\nexport interface UpdateFileOptions {\n content: string;\n type?: FileType;\n branchId?: string;\n parentPath?: string;\n}\n\nexport interface ListFilesOptions extends PaginationControl {\n path?: string;\n recursive?: boolean;\n}\n\nexport interface CallOptions {\n method?: \"GET\" | \"POST\" | \"PUT\" | \"DELETE\";\n body?: unknown;\n headers?: Record;\n}\n\n// ============================================================\n// RESULT / ERROR TYPES (never throw — always return)\n// ============================================================\n\nexport type Result =\n | { ok: true; data: T }\n | { ok: false; error: Error };\n\nfunction ok(data: T): Result {\n return { ok: true, data };\n}\n\nfunction fail(e: unknown): Result {\n return { ok: false, error: e instanceof Error ? e : new Error(String(e)) };\n}\n\nasync function wrap(fn: () => Promise): Promise> {\n try {\n return ok(await fn());\n } catch (e) {\n return fail(e);\n }\n}\n\n// ============================================================\n// FILE BUILDER (fluent chain for a single file inside a Val)\n// ============================================================\n\nexport class FileBuilder {\n constructor(\n private readonly vtApi: ValTownAPI,\n private readonly valId: string,\n private readonly path: string,\n ) {}\n\n /** Read the raw text content of this file. */\n async read(): Promise> {\n return await wrap(() =>\n this.vtApi.getFileContentText(this.valId, { path: this.path })\n );\n }\n\n /** Read the raw Response object (useful for binary / streaming). */\n async readResponse(): Promise> {\n return await wrap(() =>\n this.vtApi.getFileContentResponse(this.valId, { path: this.path })\n );\n }\n\n /** Overwrite the file with new content. */\n async write(\n content: string,\n opts: UpdateFileOptions = { content },\n ): Promise> {\n const name = this.path.split(\"/\").at(-1) ?? this.path;\n return await wrap(async () => {\n const r = await this.vtApi.updateFile(this.valId, {\n path: this.path,\n content: opts.content ?? content,\n type: opts.type ?? \"file\",\n name,\n branchId: opts.branchId,\n parent_path: opts.parentPath,\n });\n return r as ValFile;\n });\n }\n\n /** Delete this file. Pass `recursive: true` to remove a directory. */\n async delete(recursive = false): Promise> {\n return await wrap(() =>\n this.vtApi.deleteFile(this.valId, { path: this.path, recursive })\n );\n }\n\n /** Convenience: parse the file as JSON. */\n async readJson(): Promise> {\n const res = await this.read();\n if (!res.ok) return res;\n try {\n return ok(JSON.parse(res.data) as T);\n } catch (e) {\n return fail(e);\n }\n }\n\n /** Convenience: write an object as pretty-printed JSON. */\n async writeJson(value: unknown, indent = 2): Promise> {\n return this.write(JSON.stringify(value, null, indent));\n }\n}\n\n// ============================================================\n// VAL BUILDER (fluent chain for a single Val)\n// ============================================================\n\nexport class ValBuilder {\n constructor(\n private readonly vtApi: ValTownvtApi,\n private readonly id: string,\n ) {}\n\n // ---- files ------------------------------------------------\n\n /** Target a specific file by path. Returns a FileBuilder. */\n file(path: string): FileBuilder {\n return new FileBuilder(this.vtApi, this.id, path);\n }\n\n /**\n * Create a new file in this Val.\n * Returns a FileBuilder for the new file.\n */\n async createFile(\n path: string,\n opts: CreateFileOptions = {},\n ): Promise> {\n return await wrap(async () => {\n await this.vtApi.createFile(this.id, {\n path,\n content: opts.content,\n type: opts.type ?? \"file\",\n branchId: opts.branchId,\n });\n return this.file(path);\n });\n }\n\n /** List all files in this Val. */\n async listFiles(opts: ListFilesOptions = {}): Promise> {\n return await wrap(() =>\n this.vtApi.listFiles(this.id, opts) as Promise\n );\n }\n\n // ---- env vars ---------------------------------------------\n\n /** Add or set an environment variable. */\n async setEnv(key: string, value: string): Promise> {\n return await wrap(async () => {\n try {\n return await this.vtApi.createEnvVar(this.id, {\n key,\n value,\n }) as EnvVar;\n } catch {\n // Fall back to update if it already exists\n return await this.vtApi.updateEnvVar(this.id, key, value) as EnvVar;\n }\n });\n }\n\n /** List all environment variables (keys only — values are secret). */\n async listEnvs(): Promise> {\n return await wrap(() =>\n this.vtApi.listEnvVars(this.id) as Promise\n );\n }\n\n /** Remove an environment variable by key. */\n async deleteEnv(key: string): Promise> {\n return await wrap(() => this.vtApi.deleteEnvVar(this.id, key));\n }\n\n // ---- HTTP calls -------------------------------------------\n\n /** Call this Val's HTTP endpoint. */\n async call(\n url: string,\n opts: CallOptions = {},\n ): Promise> {\n return await wrap(() => this.vtApi.callValHttp(url, opts));\n }\n\n // ---- lifecycle --------------------------------------------\n\n /** Permanently delete this Val. */\n async delete(): Promise> {\n return await wrap(() => this.vtApi.deleteVal(this.id));\n }\n}\n\n// ============================================================\n// MAIN API CLASS\n// ============================================================\n\nexport class ValTownAPI {\n private readonly vtApi: ValTownvtApi;\n\n constructor(vtApiOrConfig?: ValTownvtApi | ValTownvtApiConfig) {\n if (vtApiOrConfig instanceof ValTownvtApi) {\n this.vtApi = vtApiOrConfig;\n } else {\n this.vtApi = new ValTownvtApi(vtApiOrConfig);\n }\n }\n\n // ---- identity ---------------------------------------------\n\n /** Return the authenticated user's username. */\n async username(): Promise> {\n return await wrap(() => this.vtApi.getUsername());\n }\n\n // ---- val discovery ----------------------------------------\n\n /**\n * Look up a Val by exact name.\n * Returns a ValBuilder + metadata on success.\n */\n async find(name: string): Promise> {\n return await wrap(async () => {\n const v = await this.vtApi.getValByName(name);\n if (!v) throw new Error(`Val not found: \"${name}\"`);\n return { ...v, privacy: v.privacy as Privacy, builder: this.val(v.id) };\n });\n }\n\n /**\n * Look up a Val by ID.\n * Returns a ValBuilder + metadata on success.\n */\n async findById(id: string): Promise> {\n return await wrap(async () => {\n const v = await this.vtApi.getValById(id);\n if (!v) throw new Error(`Val not found with id: \"${id}\"`);\n return { ...v, privacy: v.privacy as Privacy, builder: this.val(v.id) };\n });\n }\n\n /** List all Vals owned by the authenticated user. */\n async list(ctrl?: PaginationControl): Promise> {\n return await wrap(async () => {\n const vals = await this.vtApi.listVals(ctrl);\n return vals.map((v) => ({ ...v, privacy: v.privacy as Privacy }));\n });\n }\n\n // ---- val creation -----------------------------------------\n\n /**\n * Create a new Val and return a ValBuilder for it.\n *\n * @example\n * const { data: builder } = await api.create(\"my-val\", { privacy: \"unlisted\" });\n */\n async create(\n name: string,\n opts: CreateValOptions = {},\n ): Promise> {\n return await wrap(async () => {\n const v = await this.vtApi.createVal({\n name,\n privacy: opts.privacy ?? \"private\",\n description: opts.description,\n code: opts.code,\n });\n return { ...v, privacy: v.privacy as Privacy, builder: this.val(v.id) };\n });\n }\n\n /**\n * Find an existing Val or create it if it doesn't exist.\n * Useful for idempotent setup scripts.\n */\n async findOrCreate(\n name: string,\n defaults: CreateValOptions = {},\n ): Promise> {\n return await wrap(async () => {\n const existing = await this.vtApi.getValByName(name);\n if (existing) {\n return {\n ...existing,\n privacy: existing.privacy as Privacy,\n builder: this.val(existing.id),\n created: false,\n };\n }\n const created = await this.vtApi.createVal({\n name,\n privacy: defaults.privacy ?? \"private\",\n description: defaults.description,\n code: defaults.code,\n });\n return {\n ...created,\n privacy: created.privacy as Privacy,\n builder: this.val(created.id),\n created: true,\n };\n });\n }\n\n // ---- direct builder access --------------------------------\n\n /**\n * Get a ValBuilder directly by ID — no network round-trip.\n * Use when you already know the Val ID.\n */\n val(id: string): ValBuilder {\n return new ValBuilder(this.vtApi, id);\n }\n\n // ---- HTTP shorthand ---------------------------------------\n\n /** GET a Val's HTTP endpoint at `url`. */\n async get(\n url: string,\n headers?: Record,\n ): Promise> {\n return await wrap(() =>\n this.vtApi.callValHttp(url, { method: \"GET\", headers })\n );\n }\n\n /** POST JSON to a Val's HTTP endpoint. */\n async post(\n url: string,\n body: unknown,\n headers?: Record,\n ): Promise> {\n return await wrap(() =>\n this.vtApi.callValHttp(url, { method: \"POST\", body, headers })\n );\n }\n\n /** PUT JSON to a Val's HTTP endpoint. */\n async put(\n url: string,\n body: unknown,\n headers?: Record,\n ): Promise> {\n return await wrap(() =>\n this.vtApi.callValHttp(url, { method: \"PUT\", body, headers })\n );\n }\n\n /** DELETE a resource at a Val's HTTP endpoint. */\n async delete(\n url: string,\n headers?: Record,\n ): Promise> {\n return await wrap(() =>\n this.vtApi.callValHttp(url, { method: \"DELETE\", headers })\n );\n }\n\n // ---- utilities --------------------------------------------\n\n /** Sanitize a string into a valid Val name. */\n sanitizeName(name: string): string {\n return this.vtApi.sanitizeName(name);\n }\n\n /** Sleep for `ms` milliseconds. */\n sleep(ms: number): Promise {\n return this.vtApi.sleep(ms);\n }\n\n /**\n * Run a full integration smoke-test.\n * Creates a throwaway Val, exercises every major operation, then deletes it.\n */\n async smokeTest(\n namePrefix = \"api-smoke-test\",\n ): Promise>> {\n return await wrap(() => this.vtApi.fullDemo(namePrefix));\n }\n}\n\n// ============================================================\n// FACTORY / DEFAULT EXPORT\n// ============================================================\n\n/**\n * Create a new ValTownAPI instance.\n *\n * @example\n * import { createAPI } from \"./valtown_api.ts\";\n * const api = createAPI();\n */\nexport function createAPI(config?: ValTownvtApiConfig): ValTownAPI {\n return new ValTownAPI(config);\n}\n\n/**\n * Wrap an existing ValTownvtApi in the fluent API.\n *\n * @example\n * import { wrapvtApi } from \"./valtown_api.ts\";\n * const api = wrapvtApi(myExistingvtApi);\n */\nexport function wrapvtApi(vtApi: ValTownAPI): ValTownAPI {\n return new ValTownAPI(vtApi);\n}\n\n/** Pre-built default instance — ready to use immediately. */\nexport const api = new ValTownAPI(new vtApi());\nexport default api;\n\n// ============================================================\n// USAGE EXAMPLES (run with: deno run -A valtown_api.ts)\n// ============================================================\n\n// ---- 1. Create a val, write a file, read it back ----\n//\n// const result = await api.create(\"hello-world\", {\n// privacy: \"unlisted\",\n// description: \"My first val via the fluent API\",\n// });\n//\n// if (!result.ok) throw result.error;\n//\n// const { builder } = result.data;\n//\n// await builder.createFile(\"notes.md\", { content: \"# Hello\\nWorld!\" });\n//\n// const read = await builder.file(\"notes.md\").read();\n// console.log(read.ok ? read.data : read.error);\n//\n// await builder.delete();\n\n// ---- 2. Find-or-create (idempotent setup) ----\n//\n// const r = await api.findOrCreate(\"my-config\", { privacy: \"private\" });\n// if (r.ok) {\n// console.log(r.data.created ? \"Created fresh\" : \"Found existing\");\n// await r.data.builder.setEnv(\"MY_SECRET\", \"abc123\");\n// }\n\n// ---- 3. Call a deployed HTTP val ----\n//\n// const resp = await api.post(\"https://username-myval.val.run\", { msg: \"hi\" });\n// if (resp.ok && resp.data.ok) console.log(resp.data.json);\n\n// ---- 4. Enumerate all vals and their file counts ----\n//\n// const vals = await api.list();\n// if (vals.ok) {\n// for (const v of vals.data) {\n// const files = await api.val(v.id).listFiles();\n// console.log(v.name, files.ok ? files.data.length : \"error\");\n// }\n// }\n\n// ---- 5. Smoke-test everything ----\n//\n// const test = await api.smokeTest();\n// console.log(test.ok ? test.data : test.error.message);",[59],"3f867e6e-553c-11f1-8845-ee650bb23af1","api.ts","944531e4-553b-11f1-8ed4-ee650bb23af1",14,["D",1779385267718],2,[68],{"_35":67,"_13":68,"_38":69,"_40":-5,"_41":42,"_43":70,"_45":46,"_47":84,"_17":72,"_50":64,"_52":19,"_54":55,"_56":-5,"_78":85,"_18":86},{"_35":58,"_13":59,"_38":60,"_40":-5,"_41":42,"_43":61,"_45":46,"_47":81,"_17":63,"_50":64,"_52":65,"_54":55,"_56":-5,"_78":82,"_18":83},{"_35":36,"_13":37,"_38":39,"_40":-5,"_41":42,"_43":44,"_45":46,"_47":77,"_17":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_78":79,"_18":80},["D",1779384781757],"children",[],[37],["D",1780327545785],[],[59],["D",1779385267718],[],[68],"8fc34bde-553a-11f1-97ac-ee650bb23af1",["D",1779384543359],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Valtown deployer API","imageUrl","userId","2c6d46b0-54dd-11f0-a86c-6fbc2b29331a","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","850db142-aa5e-4914-bceb-1e2e085ae4c5","tursoName","8fc34bde553a11f197acee650bb23af1","tursoHostname","8fc34bde553a11f197acee650bb23af1-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789495880338],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_144":140},"org",{"_11":12,"_138":-5,"_139":140,"_97":98,"_141":142,"_143":55},"branch",{"_17":61,"_13":16,"_35":42,"_130":87,"_131":-5,"_132":-5,"_133":-5,"_134":-5,"_135":-5,"_136":14,"_137":12},"isOwned","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yekJHRDE5SGVoUHUzUENQaXY2MTRkT3h0cncifQ","tier","free","canRestrictVals","profileImageUrl","adoptOrgId",{"_35":87,"_13":14,"_47":188,"_89":-5,"_90":55,"_91":92,"_93":92,"_94":95,"_96":-5,"_97":98,"_99":-5,"_100":55,"_101":-5,"_102":-5,"_103":104,"_105":106,"_107":108,"_109":110,"_111":189,"_113":-5,"_114":115,"_116":115,"_117":118,"_119":118,"_120":118,"_121":115,"_122":115,"_123":190,"_125":191,"_127":192,"_129":55},[179,180,181],"files",[179,180,181],"counts",{"_169":104,"_170":171,"_172":104,"_31":173,"_174":175},[163,164,165],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_35":67,"_13":68,"_38":69,"_40":-5,"_41":42,"_43":70,"_45":46,"_47":71,"_17":72,"_50":64,"_52":19,"_54":55,"_56":-5,"_18":168},{"_35":58,"_13":59,"_38":60,"_40":-5,"_41":42,"_43":61,"_45":46,"_47":62,"_17":63,"_50":64,"_52":65,"_54":55,"_56":-5,"_18":167},{"_35":36,"_13":37,"_38":39,"_40":-5,"_41":42,"_43":44,"_45":46,"_47":48,"_17":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_18":166},[37],[59],[68],"pulls","branches",1,"forks",{"_176":104,"_178":104},"connections",{"_176":104,"_177":104},"count","unfilledCount","emptyCount",{"_35":67,"_13":68,"_38":69,"_40":-5,"_41":42,"_43":70,"_45":46,"_47":84,"_17":72,"_50":64,"_52":19,"_54":55,"_56":-5,"_78":186,"_18":187},{"_35":58,"_13":59,"_38":60,"_40":-5,"_41":42,"_43":61,"_45":46,"_47":81,"_17":63,"_50":64,"_52":65,"_54":55,"_56":-5,"_78":184,"_18":185},{"_35":36,"_13":37,"_38":39,"_40":-5,"_41":42,"_43":44,"_45":46,"_47":77,"_17":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_78":182,"_18":183},[],[37],[],[59],[],[68],["D",1779384543359],["D",1789495880338],{"_11":12,"_144":140},{"_11":12,"_138":-5,"_139":140,"_97":98,"_141":142,"_143":55},{"_17":61,"_13":16,"_35":42,"_130":87,"_131":-5,"_132":-5,"_133":-5,"_134":-5,"_135":-5,"_136":14,"_137":12},"ctx",{"_123":-5,"_160":226,"_227":228,"_229":230,"_231":55,"_232":55,"_233":55,"_234":46,"_235":-5,"_236":-7,"_237":-7,"_238":104,"_239":55,"_240":55,"_241":-5,"_242":55,"_243":55,"_244":55,"_245":-5},"ENV",{"_197":198,"_199":200,"_201":16,"_202":203,"_204":205,"_206":207,"_208":209,"_210":211,"_212":213,"_214":215,"_216":217,"_218":219,"_220":221,"_222":223,"_224":225},"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"]

Code