[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_182":183,"_184":185},"routes/_app.x.$handle.$name",{"_97":96,"_32":44,"_105":87,"_26":36,"_13":14,"_106":-5,"_11":107,"_108":109,"_110":111,"_112":113,"_114":115,"_20":-5,"_116":-5,"_117":-5,"_118":24,"_119":120,"_121":122,"_123":-5,"_124":-5,"_125":126},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_42":43,"_32":44,"_37":45,"_46":-5,"_47":24,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":-5,"_56":24,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":64,"_65":66,"_67":68,"_69":-5,"_70":71,"_72":71,"_73":74,"_75":74,"_76":74,"_77":71,"_78":71,"_79":80,"_81":82,"_83":84,"_85":24},"version",10,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":24,"_26":27,"_28":29},"file",{"_30":31,"_32":27,"_33":34,"_35":36,"_37":38,"_39":14,"_40":41,"_23":24},"previous","deleted",false,"deletedHere","path","new-file-8043.ts","latestPath","api.ts","fileId","944531e4-553b-11f1-8ed4-ee650bb23af1","name","fileType","script","content","","createdAt",["D",1779384980409],"branchVersion","branchId","8fc40db2-553a-11f1-97ac-ee650bb23af1","id","8fc34bde-553a-11f1-97ac-ee650bb23af1","deployer",["D",1779384543359],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Valtown deployer API","imageUrl","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",{"_97":96,"_104":100},"org",{"_97":96,"_98":-5,"_99":100,"_18":54,"_101":102,"_103":24},"branch",{"_13":86,"_32":87,"_42":41,"_88":43,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":44,"_95":96},"isOwned",15,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","ziggyware","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yekJHRDE5SGVoUHUzUENQaXY2MTRkT3h0cncifQ","tier","free","canRestrictVals","profileImageUrl","branchName","adoptOrgId",{"_42":43,"_32":44,"_37":177,"_46":-5,"_47":24,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":-5,"_56":24,"_57":-5,"_58":-5,"_59":60,"_61":62,"_63":64,"_65":66,"_67":178,"_69":-5,"_70":71,"_72":71,"_73":74,"_75":74,"_76":74,"_77":71,"_78":71,"_79":179,"_81":180,"_83":181,"_85":24},"tree",[164,165,166],"files",[164,165,166],"counts",{"_153":60,"_154":155,"_156":60,"_157":158,"_159":160},"contents",[127,128,129],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles",true,"grants","orgs","customDomains",{},{"_42":144,"_32":145,"_30":146,"_133":-5,"_40":41,"_39":147,"_135":24,"_37":148,"_13":149,"_33":150,"_35":151,"_23":24,"_139":-5,"_26":152},{"_42":141,"_32":27,"_30":31,"_133":-5,"_40":41,"_39":14,"_135":24,"_37":142,"_13":60,"_33":34,"_35":36,"_23":24,"_139":-5,"_26":143},{"_42":130,"_32":131,"_30":132,"_133":-5,"_40":41,"_39":134,"_135":122,"_37":136,"_13":137,"_33":34,"_35":138,"_23":24,"_139":-5,"_26":140},"1ddde7a8-553b-11f1-b24a-ee650bb23af1","valtown-api.ts","02ad359c-553b-11f1-9ec1-ee650bb23af1","parentId",8,"latest",["D",1779384781757],3,"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;","label",[131],"94453130-553b-11f1-8ed4-ee650bb23af1",["D",1779384980409],[27],"7f37b164-553b-11f1-bfc3-ee650bb23af1","main.ts","8fc70724-553a-11f1-97ac-ee650bb23af1",9,["D",1779384945082],4,"http","import valTownvtApi, {\n PaginationControl,\n ValTownvtApi,\n ValTownvtApiConfig,\n} from \"./valtown-api.ts\"; // adjust path as needed\n\n// ============================================================\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: ValTownvtApi,\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: ValTownvtApi): ValTownAPI {\n return new ValTownAPI(vtApi);\n}\n\n/** Pre-built default instance — ready to use immediately. */\nexport const api = new ValTownAPI(valTownvtApi);\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);",[145],"pulls","branches",1,"forks","envVars",{"_161":60,"_163":60},"connections",{"_161":60,"_162":60},"count","unfilledCount","emptyCount",{"_42":144,"_32":145,"_30":146,"_133":-5,"_40":41,"_39":147,"_135":24,"_37":174,"_13":149,"_33":150,"_35":151,"_23":24,"_139":-5,"_168":175,"_26":176},{"_42":141,"_32":27,"_30":31,"_133":-5,"_40":41,"_39":14,"_135":24,"_37":171,"_13":60,"_33":34,"_35":36,"_23":24,"_139":-5,"_168":172,"_26":173},{"_42":130,"_32":131,"_30":132,"_133":-5,"_40":41,"_39":134,"_135":122,"_37":167,"_13":137,"_33":34,"_35":138,"_23":24,"_139":-5,"_168":169,"_26":170},["D",1779384781757],"children",[],[131],["D",1779384980409],[],[27],["D",1779384945082],[],[145],["D",1779384543359],["D",1789495880338],{"_97":96,"_104":100},{"_97":96,"_98":-5,"_99":100,"_18":54,"_101":102,"_103":24},{"_13":86,"_32":87,"_42":41,"_88":43,"_89":-5,"_90":-5,"_91":-5,"_92":-5,"_93":-5,"_94":44,"_95":96},"ctx",{"_79":-5,"_124":215,"_216":217,"_218":219,"_220":24,"_221":24,"_222":24,"_223":122,"_224":-5,"_225":-7,"_226":-7,"_227":60,"_228":24,"_229":24,"_230":-5,"_231":24,"_232":24,"_233":24,"_234":-5},"ENV",{"_186":187,"_188":189,"_190":87,"_191":192,"_193":194,"_195":196,"_197":198,"_199":200,"_201":202,"_203":204,"_205":206,"_207":208,"_209":210,"_211":212,"_213":214},"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 · v10