[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_271":272,"_273":274},"routes/_app.x.$handle.$name",{"_98":97,"_32":45,"_107":86,"_27":108,"_13":14,"_109":-5,"_11":110,"_111":112,"_113":114,"_115":116,"_117":118,"_20":-5,"_119":-5,"_120":121,"_122":49,"_123":124,"_125":49,"_126":-5,"_127":-5,"_128":129},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_43":44,"_32":45,"_38":46,"_47":-5,"_48":49,"_50":51,"_52":51,"_53":54,"_55":-5,"_18":56,"_57":-5,"_58":49,"_59":-5,"_60":-5,"_61":62,"_63":64,"_65":-5,"_66":-5,"_67":-5,"_68":-5,"_69":70,"_71":70,"_72":73,"_74":73,"_75":73,"_76":70,"_77":70,"_78":79,"_80":81,"_82":83,"_84":49},"version",55,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":35,"_36":37,"_38":39,"_40":14,"_41":42,"_24":25},"previous",{"_30":31,"_32":33,"_34":35,"_36":37},"deleted",true,"deletedHere","path","generated-test-files/test-cron-1767921947018.ts","latestPath","fileId","019ba2b1-62b1-73ff-a8e8-cdb984914260","name","test-cron-1767921947018.ts","fileType","interval","content","export default async () => console.log('hello')","createdAt",["D",1767965604113],"branchVersion","branchId","449e20e0-ed55-11f0-a73a-42dde27851f2","id","f2b9a2a0-ece5-11f0-868f-42dde27851f2","valtown-mcp-client",["D",1767913281222],"deletedAt","legacyEnvVars",false,"privacy","public","httpPrivacy","description","A minimal client for Val Town MCP","imageUrl","3ee322c5-8742-48e0-86c7-5f3ae129683b","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","f427167a-3263-4778-81d8-f79626323ff5","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_98":97,"_106":102},"org",{"_98":97,"_99":100,"_101":102,"_18":56,"_103":104,"_105":49},"branch",{"_13":85,"_32":86,"_43":42,"_87":44,"_88":89,"_90":91,"_92":51,"_93":44,"_94":64,"_95":45,"_96":97},"isOwned",64,"generate-types","projectId","forkedBranchId","f2ba1f96-ece5-11f0-868f-42dde27851f2","forkedBranchVersion",80,"forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","kamalnrf","handle","displayName","Kamal","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yaVpXT3l1d2hWSFdtWTNoZFIwZ0lFUUhOd2oifQ","tier","pro","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_43":44,"_32":45,"_38":267,"_47":-5,"_48":49,"_50":51,"_52":51,"_53":54,"_55":-5,"_18":56,"_57":-5,"_58":49,"_59":-5,"_60":-5,"_61":62,"_63":64,"_65":-5,"_66":-5,"_67":-5,"_68":-5,"_69":70,"_71":70,"_72":73,"_74":73,"_75":73,"_76":70,"_77":70,"_78":268,"_80":269,"_82":270,"_84":49},"tree",[210,215,216,217,218,219,220],"files",[210,211,212,213,214,215,216,217,218,219,220],"counts",{"_199":62,"_200":201,"_202":62,"_203":204,"_205":206},"contents",[137,138,139,140,141,142,143],"upstreamProject","upstreamBranch",{"_43":89,"_38":130,"_131":132,"_32":133,"_87":44,"_13":134,"_88":-5,"_90":-5,"_135":136,"_47":-5,"_84":49,"_50":51,"_96":97,"_63":64,"_95":45},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1767913281222],"updatedAt",["D",1767967139016],"main",100,"lockfileKey","1767967132553-esm.town_v_kamalnrf_valtown-mcp-client@98-main",{"_43":193,"_32":194,"_30":195,"_147":-5,"_41":42,"_40":175,"_149":25,"_38":196,"_13":62,"_34":197,"_36":-5,"_24":49,"_154":-5,"_27":198},{"_43":187,"_32":188,"_30":189,"_147":-5,"_41":42,"_40":175,"_149":49,"_38":190,"_13":62,"_34":20,"_36":191,"_24":49,"_154":-5,"_27":192},{"_43":179,"_32":180,"_30":181,"_147":-5,"_41":42,"_40":182,"_149":25,"_38":183,"_13":184,"_34":152,"_36":185,"_24":49,"_154":-5,"_27":186},{"_43":172,"_32":173,"_30":174,"_147":-5,"_41":42,"_40":175,"_149":25,"_38":176,"_13":62,"_34":152,"_36":177,"_24":49,"_154":-5,"_27":178},{"_43":164,"_32":165,"_30":166,"_147":-5,"_41":42,"_40":167,"_149":49,"_38":168,"_13":169,"_34":152,"_36":170,"_24":49,"_154":-5,"_27":171},{"_43":156,"_32":157,"_30":158,"_147":-5,"_41":42,"_40":159,"_149":25,"_38":160,"_13":161,"_34":152,"_36":162,"_24":49,"_154":-5,"_27":163},{"_43":144,"_32":145,"_30":146,"_147":-5,"_41":42,"_40":148,"_149":49,"_38":150,"_13":151,"_34":152,"_36":153,"_24":49,"_154":-5,"_27":155},"28062fe0-ed5f-11f0-a9a6-42dde27851f2","valtown.ts","019ba2b1-62b1-73ff-a8e8-f318724ecda4","parentId",45,"latest",["D",1767965339757],2,"script","import { createMCPClient } from \"./create-mcp-client.ts\";\nimport type { Call, ToolContent, ToolResult } from \"./types.generated.ts\";\n\nconst API_TOKEN = Deno.env.get(\"VAL_TOWN\");\n\nasync function connect() {\n try {\n console.log(\"Connecting to Val Town MCP...\\n\");\n const client = await createMCPClient({\n url: \"https://api.val.town/v3/mcp\",\n headers: {\n Authorization: `Bearer ${API_TOKEN}`,\n },\n });\n return client;\n } catch (error) {\n console.error(\"Error: \", error);\n throw new Error(\"Failed to connecting to MCP Server\");\n }\n}\n\nfunction createToolResult(content: ToolContent[]): ToolResult {\n return {\n content,\n text: () => content.find((c) => c.type === \"text\")?.text,\n json: () => {\n const text = content.find((c) => c.type === \"text\")?.text;\n if (!text) throw new Error(\"No text content\");\n return JSON.parse(text) as T;\n },\n };\n}\n\nexport default async function valTownMCP() {\n const client = await connect();\n\n const callTool: Call = async (name, args) => {\n const result = await client.callTool({\n name,\n _arguments: args,\n get arguments() {\n return this._arguments;\n },\n set arguments(value) {\n this._arguments = value;\n },\n });\n\n return createToolResult(result.content as ToolContent[]);\n };\n\n return {\n listTools: async () => {\n const { tools } = await client.listTools();\n return tools;\n },\n callTool,\n async close() {\n await client.close();\n },\n };\n}","label",[145],"9f50760a-ed5f-11f0-ae22-42dde27851f2","types.generated.ts","1a3da40c-ed59-11f0-b627-42dde27851f2",51,["D",1767965539890],18,"// Auto-generated from compile-types.ts - 2026-01-09T13:32:19.658Z\n// Do not edit this file \n\nimport type { TextContent, ImageContent, EmbeddedResource } from \"npm:@modelcontextprotocol/sdk@1.12.0/types.js\"; \n\n/** List all vals (projects) for the authenticated user, including name, description, privacy status, creation date, and links. Each val includes an 'identifier' field (format: handle/valName) that can be used directly in other tools that require val identification. */\nexport interface ListVals {\n /**\n * Maximum number of vals to return (1-100, default 32)\n */\n limit?: number;\n /**\n * Number of vals to skip for pagination\n */\n offset?: number;\n /**\n * Filter vals by name (case-insensitive partial match)\n */\n name?: string;\n /**\n * Filter vals created after this date (ISO date string)\n */\n createdAfter?: string;\n /**\n * Filter vals created before this date (ISO date string)\n */\n createdBefore?: string;\n /**\n * Filter vals updated after this date (ISO date string)\n */\n updatedAfter?: string;\n /**\n * Filter vals updated before this date (ISO date string)\n */\n updatedBefore?: string;\n /**\n * Sort vals by: 'updated', 'created', or 'name'\n */\n sortBy?: \"updated\" | \"created\" | \"name\";\n /**\n * Sort order: 'desc' or 'asc'\n */\n sortOrder?: \"asc\" | \"desc\";\n /**\n * Filter vals by user or organization handle. If not specified, returns the authenticated user's vals.\n */\n handle?: string;\n}\n\n/** Read the code or raw content of a specific file in a val/project. Returns content with line numbers by default. Provide the val in 'handle/valName' format. */\nexport interface ReadFile {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * The file path within the val (e.g., 'src/index.ts')\n */\n path: string;\n /**\n * Include line numbers in the output (default: true)\n */\n show_line_numbers?: boolean;\n}\n\n/** List files and directories in a val/project. Optionally provide a path to browse subdirectories. Provide the val in 'handle/valName' format. */\nexport interface ListFiles {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * Optional: The directory path to list. Omit to list root directory.\n */\n path?: string;\n}\n\n/** Get detailed information about a specific val/project including metadata, author, privacy settings, available branches, and links. Provide the val in 'handle/valName' format. */\nexport interface GetValDetail {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n}\n\n/** List all multi-member organizations that the authenticated user is a member of. Returns organization handle, avatar, display name, and the user's role (owner or member). Use this to discover organizations before listing their vals. Note: This excludes the user's personal organization. */\nexport interface ListOrgs {}\n\n/** List all branches for a specific val/project, including branch names, versions, and metadata. Provide the val in 'handle/valName' format (use the 'identifier' field from list_vals or get_val_detail responses). */\nexport interface ListBranches {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n}\n\n/** List all environment variable keys for a val/project. Returns keys, descriptions, and metadata only. Does NOT return actual secret values for security reasons. */\nexport interface ListEnvVars {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n}\n\n/** Fetch commit history for a val/branch. Returns commits with user information, file changes, pull requests, merges, and reverts. Commits are grouped by version number and sorted from newest to oldest. */\nexport interface GetValHistory {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * Number of commits to fetch (default: 32, max: 100). Fetches one extra to determine if there are more results.\n */\n limit?: number;\n /**\n * Number of commits to skip for pagination (default: 0)\n */\n offset?: number;\n}\n\n/** Fetches the HTTP endpoint of a val. Useful for MCP clients with security restrictions that need to fetch val endpoint URLs. Only works with HTTP-type vals. */\nexport interface FetchValEndpoint {\n /**\n * Val identifier in the format 'handle/valName' (e.g., 'alice/myval'). The handle is the val author's username (found in author.username field from val responses). You can also use the 'identifier' field directly from list_vals, get_val_detail, or create_val responses.\n */\n val: string;\n /**\n * File or directory path within a val\n */\n path: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * Optional URL pathname to append to the endpoint (e.g., '/api/users')\n */\n pathname?: string;\n}\n\n/** Fetch recent telemetry traces (execution runs) for a specific file in a val. Returns the 3 most recent traces from the past hour, including HTTP details, status, errors, and timing information. */\nexport interface GetTraces {\n /**\n * The UUID of the file to fetch traces for\n */\n fileId: string;\n /**\n * Branch ID (optional, defaults to main branch if not provided)\n */\n branchId?: string;\n}\n\n/** Fetch recent console logs (from console.log, console.error, etc.) for a specific file in a val. Returns logs from the past hour, optionally filtered by trace IDs. Use this to see output from val executions. */\nexport interface GetLogs {\n /**\n * The UUID of the file to fetch logs for\n */\n fileId: string;\n /**\n * Branch ID (optional, defaults to main branch if not provided)\n */\n branchId?: string;\n /**\n * Optional array of trace IDs to filter logs. Trace IDs should be 32 hex characters (without dashes).\n */\n traceIds?: string[];\n /**\n * Maximum number of logs to return. Defaults to 16, maximum is 100.\n */\n limit?: number;\n}\n\n/** List all blobs in your blob storage. Optionally filter by key prefix. Returns blob metadata including key, size, and last modified timestamp. */\nexport interface ListBlobs {\n /**\n * If specified, only include blobs whose keys start with this prefix\n */\n prefix?: string;\n}\n\n/** Get metadata for a blob. Returns the blob key, size in bytes, and last modified timestamp. */\nexport interface GetBlob {\n /**\n * Blob storage key (will be prefixed with user/org ID)\n */\n key: string;\n}\n\n/** Get the interval schedule configuration for an interval file within a val. The file must have fileType='interval'. Returns the type (delay or cron), delay value, unit, and cron expression. Provide the val in 'handle/valName' format and the file path. */\nexport interface ReadIntervalSettings {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * The file path of the interval file within the val (e.g., 'main.ts' or 'cron/daily.ts')\n */\n path: string;\n}\n\n/** Create a new file in a val/project. Supports nested paths, different file types (http, script, interval, email, file), and editing on any branch. Val Town uses Deno: use 'npm:package' imports. Provide the val in 'handle/valName' format (use the 'identifier' field from list_vals or get_val_detail responses). */\nexport interface CreateFile {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * The file path (e.g., 'utils/helper.ts' or 'main.ts')\n */\n path: string;\n /**\n * The initial content for the file\n */\n content?: string;\n /**\n * File type: 'http' for HTTP handlers, 'script' for general code, 'interval' for cron jobs, 'email' for email handlers, 'file' for static files. Defaults to 'file'.\n */\n fileType?: \"http\" | \"script\" | \"interval\" | \"email\" | \"file\";\n}\n\n/** Update the content of an existing file in a val/project. Use this to edit code, fix bugs, or modify files. Supports editing on any branch. Val Town runs Deno: use 'npm:package' for imports, TypeScript recommended. Provide the val in 'handle/valName' format (use the 'identifier' field from list_vals or get_val_detail responses). */\nexport interface UpdateFile {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * The file path within the val (e.g., 'src/index.ts' or 'main.ts')\n */\n path: string;\n /**\n * The new content for the file. Should be valid TypeScript for .ts/.tsx files.\n */\n content: string;\n}\n\n/** Delete a file from a val/project. Supports deleting on any branch. The file will be marked as deleted but can be recovered if needed. Provide the val in 'handle/valName' format (use the 'identifier' field from list_vals or get_val_detail responses). */\nexport interface DeleteFile {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * The file path to delete (e.g., 'utils/old.ts')\n */\n path: string;\n}\n\n/** Replace exact text matches in a file with new content. Supports editing on any branch. The old_str must match exactly for safety. Can replace first occurrence or all occurrences. */\nexport interface ReplaceInFile {\n /**\n * The val identifier in 'handle/valName' format containing the file\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * The file path within the val (e.g., 'src/utils.ts')\n */\n path: string;\n /**\n * The exact string to find and replace. Must match exactly (case-sensitive).\n */\n old_str: string;\n /**\n * The new string to replace with. Can be empty to delete.\n */\n new_str: string;\n /**\n * If true, replace all occurrences. If false (default), replace only the first occurrence.\n */\n replace_all?: boolean;\n}\n\n/** Insert text at a specific line number in a file. The text is inserted before the specified line (pushing existing content down). Line numbers start at 1. Supports editing on any branch. */\nexport interface InsertAtLine {\n /**\n * The val identifier in 'handle/valName' format containing the file\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * The file path within the val (e.g., 'src/utils.ts')\n */\n path: string;\n /**\n * The line number where text should be inserted (1-indexed). Text is inserted before this line.\n */\n line_number: number;\n /**\n * The text to insert. Include newline characters (\\n) if you want to add multiple lines.\n */\n content: string;\n}\n\n/** Append content to the end of a file. Useful for adding new functions, exports, or code sections without knowing the file length. Supports editing on any branch. */\nexport interface AppendToFile {\n /**\n * The val identifier in 'handle/valName' format containing the file\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * The file path within the val (e.g., 'src/utils.ts')\n */\n path: string;\n /**\n * The content to append to the end of the file. Include \\n at the start if you want a blank line separator.\n */\n content: string;\n}\n\n/** Prepend content to the beginning of a file. Useful for adding imports, file headers, or license comments. Val Town uses Deno: use 'npm:package' for imports. Supports editing on any branch. */\nexport interface PrependToFile {\n /**\n * The val identifier in 'handle/valName' format containing the file\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * The file path within the val (e.g., 'src/utils.ts')\n */\n path: string;\n /**\n * The content to prepend to the beginning of the file. Include \\n at the end if you want a blank line separator.\n */\n content: string;\n}\n\n/** Rename a file or directory within a val/project. This only changes the name, not the location. Works for both files and directories. */\nexport interface RenameFile {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * The UUID of the file or directory to rename\n */\n fileId: string;\n /**\n * The new name for the file or directory (e.g., 'utils.ts', 'components')\n */\n newName: string;\n}\n\n/** Move a file or directory to a new location within a val/project. Works for both files and directories (moves the entire directory tree). Set newParentPath to null to move to root, or provide a directory path like 'src/utils'. */\nexport interface MoveFile {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * The UUID of the file or directory to move\n */\n fileId: string;\n /**\n * The destination directory path (e.g., 'src/utils'), or null to move to root\n */\n newParentPath: string | null;\n}\n\n/** Create a new directory (folder) in a val/project. Parent directories must exist before creating nested directories. Use this to organize files into folders. */\nexport interface CreateDirectory {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * The directory path (e.g., 'utils' or 'src/components')\n */\n path: string;\n}\n\n/** Change the type of a file in a val/project. Supported types: 'script' (library/utility code), 'http' (web endpoint), 'email' (email handler), 'interval' (scheduled cron), 'file' (plain file). */\nexport interface SetFileType {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * The UUID of the file to modify\n */\n fileId: string;\n /**\n * The new file type: 'script', 'http', 'email', 'interval', or 'file'\n */\n fileType: \"file\" | \"interval\" | \"http\" | \"email\" | \"script\";\n}\n\n/** Create a new val (project) on Val Town. Creates a project with a default main branch. The response includes an 'identifier' field (format: handle/valName) that can be used in subsequent tool calls. Optionally add initial content and specify privacy level. */\nexport interface CreateVal {\n /**\n * The name for the val (alphanumeric, hyphens, underscores allowed)\n */\n name: string;\n /**\n * Optional description for the val\n */\n description?: string | null;\n /**\n * Privacy level: 'public' (discoverable), 'private' (only you), or 'unlisted' (accessible via link). Defaults to 'private'.\n */\n privacy?: \"public\" | \"private\" | \"unlisted\";\n /**\n * Optional initial file to create in the val with code content\n */\n initialFile?: {\n /**\n * Initial file name (defaults to main.ts)\n */\n name?: string;\n /**\n * Initial code content for the file\n */\n content: string;\n /**\n * File type: 'http', 'script', 'interval', 'email', or 'file'\n */\n fileType?: \"http\" | \"script\" | \"interval\" | \"email\" | \"file\";\n };\n}\n\n/** Update a val's metadata including name, privacy, description, and image. All fields are optional - only provide the fields you want to update. Provide the val in 'handle/valName' format (use the 'identifier' field from list_vals or get_val_detail responses). */\nexport interface UpdateVal {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * New name for the val (alphanumeric, hyphens, underscores allowed)\n */\n name?: string;\n /**\n * Privacy level: 'public' (discoverable), 'private' (only you), or 'unlisted' (accessible via link)\n */\n privacy?: \"public\" | \"private\" | \"unlisted\";\n /**\n * Description for the val (supports markdown)\n */\n description?: string | null;\n /**\n * URL to an image for the val's preview\n */\n imageUrl?: string;\n}\n\n/** Create a new branch in a val/project by forking from an existing branch. This creates an independent copy of the source branch's files that can be edited separately. Provide the val in 'handle/valName' format (use the 'identifier' field from list_vals or get_val_detail responses). */\nexport interface CreateBranch {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * The name of the branch to fork from (optional, defaults to 'main')\n */\n sourceBranch?: string;\n /**\n * Name for the new branch (alphanumeric, dots, hyphens, underscores). Can be supplied by the user or generated by the LLM/client.\n */\n name: string;\n}\n\n/** Revert a branch or individual file to a previous version. If fileId is provided, only that file is reverted. Otherwise, the entire branch is reverted to the specified version. This creates a new commit with the reverted content. */\nexport interface RevertToVersion {\n /**\n * The UUID of the branch to revert (required)\n */\n branchId: string;\n /**\n * The version number to revert to. Must be less than the current branch version.\n */\n version: number;\n /**\n * Optional file ID. If provided, only this file will be reverted to the specified version. If omitted, the entire branch is reverted.\n */\n fileId?: string;\n}\n\n/** Add a new environment variable to a val/project. The value will be securely encrypted. If an environment variable with the same key already exists, this will fail - use update instead. */\nexport interface AddEnvVar {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * The environment variable key/name (e.g., 'API_KEY', 'DATABASE_URL')\n */\n key: string;\n /**\n * The environment variable value (will be encrypted)\n */\n value: string;\n /**\n * Optional description for the environment variable\n */\n description: string;\n}\n\n/** Execute a single SQL statement against your Turso database (libSQL/SQLite-compatible) and return results. Supports SELECT, INSERT, UPDATE, DELETE, and other SQL operations.\n\n**Returns**: Object with { columns: string[], columnTypes: string[], rows: any[][], rowsAffected: number, lastInsertRowid: bigint|null }\n- columns: Array of column names [\"id\", \"name\"]\n- rows: Array of row arrays [[1, \"Alice\"], [2, \"Bob\"]]\n- Note: rows need to be mapped to objects using column names\n\nExamples:\n- Simple query: { sql: \"SELECT * FROM users\" }\n- Positional params: { sql: \"SELECT * FROM users WHERE id = ?\", args: [123] }\n- Named params: { sql: \"SELECT * FROM users WHERE name = :name\", args: { name: \"Alice\" } }\n\nUse this for debugging or one-time operations. For application code in Vals, use `import { sqlite } from \"https://esm.town/v/std/sqlite\"` instead.\n\nSee https://docs.turso.tech/sdk/ts/reference for more details. */\nexport interface SqliteExecute {\n /**\n * SQL statement to execute. Use ? for positional placeholders or :name/:key/@key for named placeholders.\n */\n sql: string;\n /**\n * Arguments for placeholders. Use an array for positional (?) placeholders, or an object for named (:name, $name, @name) placeholders.\n */\n args?:\n | (string | number | boolean | null)[]\n | {\n [k: string]: string | number | boolean | null;\n };\n}\n\n/** Execute multiple SQL statements atomically in a single transaction against your Turso database. All statements succeed or all fail together (rollback on error).\n\n**Returns**: Object with { results: Array<{ columns, columnTypes, rows, rowsAffected, lastInsertRowid }> }\n- Each result has same format as sqlite_execute\n- columns: Array of column names, rows: Array of row arrays\n- Note: rows need to be mapped to objects using column names\n\nExamples:\n- Simple batch: [{ sql: \"CREATE TABLE users (id INT)\" }, { sql: \"INSERT INTO users VALUES (1)\" }]\n- With params: [{ sql: \"INSERT INTO users VALUES (?)\", args: [1] }, { sql: \"INSERT INTO users VALUES (?)\", args: [2] }]\n- Read-only: statements: [{ sql: \"SELECT * FROM users\" }], mode: \"read\"\n\nUse this for debugging or one-time operations. For application code in Vals, use `import { sqlite } from \"https://esm.town/v/std/sqlite\"` instead.\n\nSee https://docs.turso.tech/sdk/ts/reference#batch-transactions for more details. */\nexport interface SqliteBatch {\n /**\n * Array of SQL statements to execute atomically. Each statement is an object with 'sql' and optional 'args'.\n */\n statements: {\n /**\n * SQL statement to execute. Use ? for positional placeholders or :name/:key/@key for named placeholders.\n */\n sql: string;\n /**\n * Arguments for placeholders. Use an array for positional (?) or an object for named placeholders.\n */\n args?:\n | (string | number | boolean | null)[]\n | {\n [k: string]: string | number | boolean | null;\n };\n }[];\n /**\n * Transaction mode (optional, defaults to 'deferred'): 'write' - immediate write lock for INSERT/UPDATE/DELETE operations; 'read' - read-only transaction, prevents writes; 'deferred' - lock acquired when first needed (default, most flexible).\n */\n mode?: \"write\" | \"read\" | \"deferred\";\n}\n\n/** Store UTF-8 text data in blob storage. Maximum content size is 100KB. */\nexport interface StoreBlob {\n /**\n * Blob storage key (will be prefixed with user/org ID)\n */\n key: string;\n /**\n * The UTF-8 text content to store.\n */\n content: string;\n}\n\n/** Delete a blob from storage. Note: Deleting a non-existent blob succeeds silently (this is standard S3 behavior). */\nexport interface DeleteBlob {\n /**\n * Blob storage key (will be prefixed with user/org ID)\n */\n key: string;\n}\n\n/** Update the interval schedule configuration for an interval file within a val. The file must have fileType='interval'. Can configure delay-based (every N minutes/hours) or cron-based schedules. Validates tier limits (free: 15min minimum, pro: 1min minimum). Provide the val in 'handle/valName' format and the file path. */\nexport interface WriteIntervalSettings {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n /**\n * The file path of the interval file within the val (e.g., 'main.ts' or 'cron/daily.ts')\n */\n path: string;\n /**\n * The new interval configuration with type (delay or cron), delay (milliseconds), unit, and cron expression\n */\n intervalConfig: {\n type: \"delay\" | \"cron\";\n delay: number | null;\n unit: (\"minute\" | \"hour\" | \"day\" | \"week\" | \"month\" | \"year\") | null;\n cron: string | null;\n };\n}\n\n/** Run a val file and return the execution results and logs. Supports script, http, interval, and email file types. The execution runs in the Val Town runtime environment with access to the val's environment variables and permissions. Use this to test val code or trigger executions. */\nexport interface RunFile {\n /**\n * The val identifier in 'handle/valName' format\n */\n val: string;\n /**\n * The file path within the val to run (e.g., 'main.ts' or 'scripts/test.ts')\n */\n path: string;\n /**\n * Branch name (optional, defaults to 'main' if not provided)\n */\n branch?: string;\n}\n\nexport type ToolContent = TextContent | ImageContent | EmbeddedResource;\n\nexport interface ToolResult {\n content: ToolContent[];\n json: () => T;\n text: () => string | undefined;\n}\n\nexport type ToolMap = {\n \"list_vals\": ListVals;\n \"read_file\": ReadFile;\n \"list_files\": ListFiles;\n \"get_val_detail\": GetValDetail;\n \"list_orgs\": ListOrgs;\n \"list_branches\": ListBranches;\n \"list_env_vars\": ListEnvVars;\n \"get_val_history\": GetValHistory;\n \"fetch_val_endpoint\": FetchValEndpoint;\n \"get_traces\": GetTraces;\n \"get_logs\": GetLogs;\n \"listBlobs\": ListBlobs;\n \"getBlob\": GetBlob;\n \"read_interval_settings\": ReadIntervalSettings;\n \"create_file\": CreateFile;\n \"update_file\": UpdateFile;\n \"delete_file\": DeleteFile;\n \"replace_in_file\": ReplaceInFile;\n \"insert_at_line\": InsertAtLine;\n \"append_to_file\": AppendToFile;\n \"prepend_to_file\": PrependToFile;\n \"rename_file\": RenameFile;\n \"move_file\": MoveFile;\n \"create_directory\": CreateDirectory;\n \"set_file_type\": SetFileType;\n \"create_val\": CreateVal;\n \"update_val\": UpdateVal;\n \"create_branch\": CreateBranch;\n \"revert_to_version\": RevertToVersion;\n \"add_env_var\": AddEnvVar;\n \"sqlite_execute\": SqliteExecute;\n \"sqlite_batch\": SqliteBatch;\n \"storeBlob\": StoreBlob;\n \"deleteBlob\": DeleteBlob;\n \"write_interval_settings\": WriteIntervalSettings;\n \"run_file\": RunFile;\n};\n\nexport type Call = (name: T, params: ToolMap[T]) => Promise;",[157],"03fe9172-ed56-11f0-b9dc-42dde27851f2","test.ts","019ba2b1-62b1-73ff-a8e8-ef884748bd35",6,["D",1767961413837],5,"// import { createMCPClient } from \"./create-mcp-client.ts\";\n\n// const API_TOKEN = Deno.env.get(\"valtown\");\n\n// export default async function valTownMCPTools() {\n// try {\n// console.log(\"Connecting to Val Town MCP...\\n\");\n// const client = await createMCPClient({\n// url: \"https://api.val.town/v3/mcp\",\n// headers: {\n// Authorization: `Bearer ${API_TOKEN}`,\n// },\n// });\n\n// const { tools } = await client.listTools();\n// return tools;\n// } catch (error) {\n// console.error(\"Error: \", error);\n// throw new Error(\"Failed to connecting to MCP Server\");\n// }\n// }\n\n// console.log(\"All Tools:\", await valTownMCPTools());\n\nimport valtown from \"./valtown.ts\";\n\nconst mcpClient = await valtown();\nconsole.log(mcpClient);\n\n// All Tools\n// console.log(\n// await mcpClient.listTools(),\n// );\n\n// List Val\n// console.log(\n// await mcpClient.call(\"list_vals\", {\n// \"limit\": 32,\n// \"offset\": 0,\n// \"sortBy\": \"updated\",\n// \"sortOrder\": \"desc\",\n// }),\n// );\n\n// Create a CRON and update its schedule\n// const filePath = `generated-test-files/test-cron-${Date.now()}.ts`;\n// const res = await mcpClient.call(\"create_file\", {\n// val: \"kamalnrf/valtown-mcp\",\n// path: filePath,\n// content: \"export default async () => console.log('hello')\",\n// fileType: \"interval\",\n// });\n\n// console.log(\"Res =>\", res);\n\n/// Update Interval Settings\n// await mcpClient.call(\"write_interval_settings\", {\n// val: \"kamalnrf/valtown-mcp\",\n// path: filePath,\n// intervalConfig: {\n// type: \"delay\",\n// delay: \"7\",\n// unit: \"day\",\n\n// // Ignored Field\n// cron: \"0 0 * * 0\",\n// },\n// });\n\n// const writeRes = await mcpClient.call(\"write_interval_settings\", {\n// val: \"kamalnrf/valtown-mcp\",\n// path: filePath,\n// intervalConfig: {\n// type: \"cron\",\n// cron: \"0 0 * * 0\",\n\n// // Ignored Fields\n// delay: 60000,\n// unit: \"day\",\n// },\n// });\n\n// console.log(writeRes);\n\nawait mcpClient.close();",[165],"44a2495e-ed55-11f0-a73a-42dde27851f2","create-mcp-client.ts","019ba2b1-62b1-73ff-a8e8-e83e8103eceb",1,["D",1767961092788],"import { Client } from \"npm:@modelcontextprotocol/sdk@1.12.0/client/index.js\";\nimport { StreamableHTTPClientTransport } from \"npm:@modelcontextprotocol/sdk@1.12.0/client/streamableHttp.js\";\nimport { SSEClientTransport } from \"npm:@modelcontextprotocol/sdk@1.12.0/client/sse.js\";\n\ninterface MCPClientConfig {\n url: string;\n headers?: Record;\n name?: string;\n version?: string;\n}\n\ntype TransportType = \"streamable-http\" | \"sse\";\n\nexport async function createMCPClient(\n config: MCPClientConfig,\n transport: TransportType = \"streamable-http\",\n): Promise {\n const {\n url,\n headers = {},\n name = \"val-town-mcp-client\",\n version = \"1.0.0\",\n } = config;\n\n const baseUrl = new URL(url);\n const requestInit = { headers };\n\n // Streamable HTTP transport\n if (transport === \"streamable-http\") {\n try {\n const client = new Client({ name, version });\n const httpTransport = new StreamableHTTPClientTransport(baseUrl, {\n requestInit,\n });\n await client.connect(httpTransport);\n console.log(\"✓ Connected via Streamable HTTP\");\n return client;\n } catch (error) {\n if (transport === \"streamable-http\") {\n throw error;\n }\n console.log(\"Streamable HTTP failed, trying SSE...\");\n }\n }\n\n // SSE transport (legacy)\n if (transport === \"sse\") {\n try {\n const client = new Client({ name, version });\n const sseTransport = new SSEClientTransport(baseUrl, {\n requestInit,\n });\n await client.connect(sseTransport);\n console.log(\"✓ Connected via SSE\");\n return client;\n } catch (error) {\n throw new Error(`Failed to connect: ${error}`);\n }\n }\n\n throw new Error(`Unknown transport type: ${transport}`);\n}",[173],"9dfb86be-ed5f-11f0-befb-42dde27851f2","compile-types.ts","2c0b434a-ed56-11f0-8522-42dde27851f2",50,["D",1767965537655],23,"import { compile } from \"npm:json-schema-to-typescript@15.0.4\";\nimport valTownMCP from \"./valtown.ts\";\n\nfunction toPascalCase(str: string): string {\n return str\n .replace(/[-_](.)/g, (_, c) => c.toUpperCase())\n .replace(/^./, (c) => c.toUpperCase());\n}\n\nfunction parseValUrl(url: string): { valName: string; branch: string } {\n const m = url.match(\n /\\/v\\/(?[^/@]+)\\/(?[^/@]+)(?:@(?[^-/]+)-(?[^/]+))?/,\n );\n if (!m || !m.groups) {\n throw new Error(\"Not a valid Val URL\");\n }\n\n const valName = `${m.groups.user}/${m.groups.val}`;\n const branch = m.groups.branch ? m.groups.branch : \"main\";\n return { valName, branch };\n}\n\nconst client = await valTownMCP();\n\nconst tools = await client.listTools();\nconst { valName, branch } = parseValUrl(import.meta.url);\n\nconst lines = [\n `// Auto-generated from compile-types.ts - ${new Date().toISOString()}`,\n \"// Do not edit this file \\n\",\n 'import type { TextContent, ImageContent, EmbeddedResource } from \"npm:@modelcontextprotocol/sdk@1.12.0/types.js\"; \\n',\n];\nconst toolTypeNames = [];\n\n// Generate Tool Param Types\nfor (const tool of tools) {\n const typeName = tool.name;\n toolTypeNames.push(typeName);\n\n try {\n const ts = await compile(tool.inputSchema, typeName, {\n bannerComment: \"\",\n additionalProperties: false,\n });\n\n if (tool.description) {\n lines.push(`/** ${tool.description} */`);\n }\n lines.push(ts.trim());\n lines.push(``);\n } catch (e) {\n console.warn(`Skipping ${tool.name}:`, e);\n }\n}\n\n// Generate Tool Call Function Types\nlines.push(\n `export type ToolContent = TextContent | ImageContent | EmbeddedResource;`,\n);\nlines.push(``);\nlines.push(`export interface ToolResult {\n content: ToolContent[];\n json: () => T;\n text: () => string | undefined;\n}`);\nlines.push(``);\nlines.push(`export type ToolMap = {`);\nfor (const tool of tools) {\n lines.push(` \"${tool.name}\": ${toPascalCase(tool.name)};`);\n}\nlines.push(`};`);\nlines.push(``);\nlines.push(\n `export type Call = (name: T, params: ToolMap[T]) => Promise;`,\n);\n\nconst res = await client.callTool(\"update_file\", {\n val: valName,\n branch,\n path: \"types.generated.ts\",\n content: lines.join(\"\\n\"),\n});\n\nconsole.log(res.json());\n\nclient.close();",[180],"44a24418-ed55-11f0-a73a-42dde27851f2","README.md","019ba2b1-62b1-73ff-a8e8-e7ebbedf39c6",["D",1767961092788],"## Val Town MCP Client\n\nA minimal MCP client for Val Town\n\n### Setup\n\n- Get your API token from `val.town/settings/api`\n- Add it as an environment variable: `VAL_TOWN`\n\nNote: Enable write permissions for Vals if you want to create or edit files.\n\n### Usage\n\n```ts\nimport valTownMCP from \"https://esm.town/v/kamalnrf/valtown-mcp/valtown.ts\";\n\nconst client = await valTownMCP();\n\n// List available tools\nconst tools = await client.listTools();\n\n// Call a tool list_val\nconst vals = await client.call(\"list_vals\", {\n \"limit\": 32,\n \"offset\": 0,\n \"sortBy\": \"updated\",\n \"sortOrder\": \"desc\",\n }),\n);\n\nawait client.close();\n```",[188],"44a242c4-ed55-11f0-a73a-42dde27851f2","generated-test-files","019ba2b1-62b1-73ff-a8e8-e2937b6ab0e8",["D",1767961092788],"directory",[194],"pulls","branches",3,"forks","envVars",{"_207":175,"_209":62},"connections",{"_207":62,"_208":62},"count","unfilledCount","emptyCount",{"_43":193,"_32":194,"_30":195,"_147":-5,"_41":42,"_40":175,"_149":25,"_38":264,"_13":62,"_34":197,"_36":-5,"_24":49,"_154":-5,"_222":265,"_27":266},{"_43":258,"_32":259,"_30":260,"_147":195,"_41":42,"_40":175,"_149":49,"_38":261,"_13":62,"_34":35,"_36":37,"_24":49,"_154":-5,"_222":262,"_27":263},{"_43":252,"_32":253,"_30":254,"_147":195,"_41":42,"_40":175,"_149":49,"_38":255,"_13":62,"_34":35,"_36":37,"_24":49,"_154":-5,"_222":256,"_27":257},{"_43":246,"_32":247,"_30":248,"_147":195,"_41":42,"_40":175,"_149":49,"_38":249,"_13":62,"_34":35,"_36":37,"_24":49,"_154":-5,"_222":250,"_27":251},{"_43":240,"_32":241,"_30":242,"_147":195,"_41":42,"_40":175,"_149":49,"_38":243,"_13":62,"_34":35,"_36":37,"_24":49,"_154":-5,"_222":244,"_27":245},{"_43":187,"_32":188,"_30":189,"_147":-5,"_41":42,"_40":175,"_149":49,"_38":237,"_13":62,"_34":20,"_36":191,"_24":49,"_154":-5,"_222":238,"_27":239},{"_43":179,"_32":180,"_30":181,"_147":-5,"_41":42,"_40":182,"_149":25,"_38":234,"_13":184,"_34":152,"_36":185,"_24":49,"_154":-5,"_222":235,"_27":236},{"_43":172,"_32":173,"_30":174,"_147":-5,"_41":42,"_40":175,"_149":25,"_38":231,"_13":62,"_34":152,"_36":177,"_24":49,"_154":-5,"_222":232,"_27":233},{"_43":164,"_32":165,"_30":166,"_147":-5,"_41":42,"_40":167,"_149":49,"_38":228,"_13":169,"_34":152,"_36":170,"_24":49,"_154":-5,"_222":229,"_27":230},{"_43":156,"_32":157,"_30":158,"_147":-5,"_41":42,"_40":159,"_149":25,"_38":225,"_13":161,"_34":152,"_36":162,"_24":49,"_154":-5,"_222":226,"_27":227},{"_43":144,"_32":145,"_30":146,"_147":-5,"_41":42,"_40":148,"_149":49,"_38":221,"_13":151,"_34":152,"_36":153,"_24":49,"_154":-5,"_222":223,"_27":224},["D",1767965339757],"children",[],[145],["D",1767965539890],[],[157],["D",1767961413837],[],[165],["D",1767961092788],[],[173],["D",1767965537655],[],[180],["D",1767961092788],[],[188],"44a23e96-ed55-11f0-a73a-42dde27851f2","test-cron-1767922098269.ts","019ba2b1-62b1-73ff-a8e8-de18159a4946",["D",1767961092788],[],[194,241],"44a23cde-ed55-11f0-a73a-42dde27851f2","test-cron-1767922073021.ts","019ba2b1-62b1-73ff-a8e8-dba5e98efec2",["D",1767961092788],[],[194,247],"44a23b4e-ed55-11f0-a73a-42dde27851f2","test-cron-1767922018727.ts","019ba2b1-62b1-73ff-a8e8-d7dfbf364dc2",["D",1767961092788],[],[194,253],"44a23946-ed55-11f0-a73a-42dde27851f2","test-cron-1767921991340.ts","019ba2b1-62b1-73ff-a8e8-d26260aab670",["D",1767961092788],[],[194,259],["D",1767961092788],[211,212,213,214],[194],["D",1767913281222],{"_98":97,"_106":102},{"_98":97,"_99":100,"_101":102,"_18":56,"_103":104,"_105":49},{"_13":85,"_32":86,"_43":42,"_87":44,"_88":89,"_90":91,"_92":51,"_93":44,"_94":64,"_95":45,"_96":97},"ctx",{"_78":-5,"_127":304,"_305":306,"_307":308,"_309":49,"_310":49,"_311":49,"_312":25,"_313":-5,"_314":-7,"_315":-7,"_316":62,"_317":49,"_318":49,"_319":-5,"_320":49,"_321":49,"_322":49,"_323":-5},"ENV",{"_275":276,"_277":278,"_279":133,"_280":281,"_282":283,"_284":285,"_286":287,"_288":289,"_290":291,"_292":293,"_294":295,"_296":297,"_298":299,"_300":301,"_302":303},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","5015b8df46402d8bba4f485ecc37aec202b0e06b","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 · v55