[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_431":432,"_433":434},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":16,"_72":222,"_41":-7,"_223":-5,"_17":224,"_225":226,"_227":228,"_229":230,"_231":232,"_161":-5,"_233":-5,"_234":235,"_236":49,"_237":238,"_239":26,"_240":-5,"_241":-5,"_242":243},"routes/_app.x.$handle.$name.compare.$branch",{"_11":12,"_13":14,"_15":16,"_17":18,"_19":20,"_21":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":-5},"handle","c15r","name","ContextualLite","branchName","dev","project",{"_32":40,"_13":14,"_34":184,"_47":-5,"_185":49,"_50":51,"_186":51,"_187":-5,"_188":-5,"_189":190,"_191":192,"_193":26,"_194":26,"_195":-5,"_196":20,"_53":54,"_197":-5,"_198":-5,"_199":-5,"_200":-5,"_201":202,"_203":202,"_204":205,"_206":205,"_207":205,"_208":202,"_209":202,"_210":211,"_212":213,"_214":28,"_48":49},"ahead",0,"behind",206,"diff",{"_62":63,"_64":65,"_66":67},"hasChanges",true,"sourceBranch",{"_41":56,"_13":16,"_32":57,"_39":40,"_43":33,"_44":58,"_59":51,"_60":40,"_61":54,"_55":14,"_52":12},"targetBranch",{"_32":33,"_34":35,"_36":37,"_13":38,"_39":40,"_41":42,"_43":-5,"_44":-5,"_45":46,"_47":-5,"_48":49,"_50":51,"_52":12,"_53":54,"_55":14},"pull","id","c5966aa0-4557-11f0-999b-76b3cceeab13","createdAt",["D",1749490372788],"updatedAt",["D",1752273140378],"main","projectId","c5961c8a-4557-11f0-999b-76b3cceeab13","version",560,"forkedBranchId","forkedBranchVersion","lockfileKey","1768832249725-esm.town_v_c15r_ContextualLite@560-main","deletedAt","isOwned",false,"privacy","public","userHandle","orgId","0630d977-f678-453e-926c-52043293f59f","projectName",22,"3698a1dc-4d55-11f0-a716-76b3cceeab13",353,"forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","added",[173],"deleted",[],"modified",[68,69,70,71],{"_72":154,"_74":155,"_76":156},{"_72":131,"_74":132,"_76":133},{"_72":110,"_74":111,"_76":112},{"_72":73,"_74":75,"_76":77},"path","src/tools/handlers/index.ts","targetFile",{"_32":102,"_13":79,"_80":103,"_82":104,"_84":33,"_85":105,"_87":49,"_34":106,"_41":89,"_90":91,"_92":107,"_64":49,"_94":-5,"_95":-7,"_72":108,"_97":109},"sourceFile",{"_32":78,"_13":79,"_80":81,"_82":83,"_84":57,"_85":86,"_87":26,"_34":88,"_41":89,"_90":91,"_92":93,"_64":49,"_94":-5,"_95":-7,"_72":96,"_97":98},"04a9b02a-4d56-11f0-8ba1-76b3cceeab13","index.ts","fileId","c2e6c134-71d1-43a4-bcef-f5801cda107d","parentId","6393b01b-962a-4980-a95e-5840b6728f62","branchId","branchVersion",5,"latest",["D",1750369228909],1,"fileType","script","content","/**\n * Unified tool handlers export\n */\n\nexport { KVToolHandlers } from \"./kv-tools.ts\";\nexport { FilesToolHandlers } from \"./files-tools.ts\";\nexport { CodeToolHandlers } from \"./code-tools.ts\";\nexport { SystemToolHandlers } from \"./system-tools.ts\";\nexport { OpenAIToolHandlers } from \"./openai-tools.ts\";","label","children",[99,100,101,79],"contentHash","d4904ec4dc800eb44ff0412f1684d3c6a9dce999b889ef0371e6c41f230c18b7","src","tools","handlers","c20ba334-4906-11f0-92e1-76b3cceeab13","6e8fab8e-482e-11f0-bd4c-76b3cceeab13","c4074bc4-47df-472c-97b7-7eec60d9dc23",301,["D",1749895382254],"/**\n * Unified tool handlers export\n */\n\nexport { KVToolHandlers } from \"./kv-tools.ts\";\nexport { FilesToolHandlers } from \"./files-tools.ts\";\nexport { CodeToolHandlers } from \"./code-tools.ts\";\nexport { SystemToolHandlers } from \"./system-tools.ts\";",[99,100,101,79],"beb70851fd18ce336672dc3bd16057db036c5e2d82d03b02e6f2fc27a3ffb4d0","src/tools/definitions.ts",{"_32":123,"_13":114,"_80":124,"_82":125,"_84":33,"_85":126,"_87":49,"_34":127,"_41":119,"_90":91,"_92":128,"_64":49,"_94":-5,"_95":-7,"_72":129,"_97":130},{"_32":113,"_13":114,"_80":115,"_82":116,"_84":57,"_85":117,"_87":26,"_34":118,"_41":119,"_90":91,"_92":120,"_64":49,"_94":-5,"_95":-7,"_72":121,"_97":122},"e564eaee-4d56-11f0-a449-76b3cceeab13","definitions.ts","311669fc-fb56-4c0f-875e-4199452f221a","c7419bf7-fd4d-407c-bdeb-bf4ae2a812e7",13,["D",1750369605947],3,"/**\n * Tool definitions for the AWS MCP Server\n */\n\n// Key-Value Store Tools (Namespaced)\nexport const KV_TOOLS = [\n {\n name: \"kv-get\",\n description: \"Get a value by key from your personal key-value store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The key to retrieve\"\n }\n },\n required: [\"key\"]\n }\n },\n {\n name: \"kv-put\",\n description: \"Store a key-value pair in your personal key-value store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The key to store\"\n },\n value: {\n description: \"The value to store (can be any JSON-serializable data)\"\n },\n ttl: {\n type: \"number\",\n description: \"Optional time-to-live in seconds (data will be automatically deleted after this time)\"\n }\n },\n required: [\"key\", \"value\"]\n }\n },\n {\n name: \"kv-delete\",\n description: \"Delete a key-value pair from your personal key-value store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The key to delete\"\n }\n },\n required: [\"key\"]\n }\n },\n {\n name: \"kv-list\",\n description: \"List keys in your personal key-value store with optional prefix filter\",\n inputSchema: {\n type: \"object\",\n properties: {\n prefix: {\n type: \"string\",\n description: \"Optional key prefix to filter by (e.g., 'user-' to list all keys starting with 'user-')\"\n },\n limit: {\n type: \"number\",\n description: \"Maximum number of keys to return (1-1000)\",\n default: 100,\n minimum: 1,\n maximum: 1000\n }\n }\n }\n },\n {\n name: \"kv-query\",\n description: \"Query key-value pairs by key pattern from your personal key-value store\",\n inputSchema: {\n type: \"object\",\n properties: {\n keyPattern: {\n type: \"string\",\n description: \"Key pattern to match (supports prefix matching, e.g., 'config*' matches all keys starting with 'config')\"\n },\n limit: {\n type: \"number\",\n description: \"Maximum number of items to return (1-1000)\",\n default: 100,\n minimum: 1,\n maximum: 1000\n }\n },\n required: [\"keyPattern\"]\n }\n }\n] as const;\n\n// Files Store Tools (Namespaced)\nexport const FILES_TOOLS = [\n {\n name: \"files-get\",\n description: \"Get a file by key from your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The file key to retrieve\"\n },\n versionId: {\n type: \"string\",\n description: \"Optional version ID to retrieve a specific version\"\n }\n },\n required: [\"key\"]\n }\n },\n {\n name: \"files-put\",\n description: \"Store a file in your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The file key to store\"\n },\n content: {\n type: \"string\",\n description: \"The file content to store\"\n },\n contentType: {\n type: \"string\",\n description: \"Optional content type (will be inferred from file extension if not provided)\"\n },\n metadata: {\n type: \"object\",\n description: \"Optional metadata key-value pairs to store with the file\"\n }\n },\n required: [\"key\", \"content\"]\n }\n },\n {\n name: \"files-delete\",\n description: \"Delete a file from your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The file key to delete\"\n },\n versionId: {\n type: \"string\",\n description: \"Optional version ID to delete a specific version\"\n }\n },\n required: [\"key\"]\n }\n },\n {\n name: \"files-list\",\n description: \"List files in your personal file store with optional prefix filter\",\n inputSchema: {\n type: \"object\",\n properties: {\n prefix: {\n type: \"string\",\n description: \"Optional key prefix to filter by (e.g., 'documents/' to list all files in documents folder)\"\n },\n limit: {\n type: \"number\",\n description: \"Maximum number of files to return (1-1000)\",\n default: 100,\n minimum: 1,\n maximum: 1000\n }\n }\n }\n },\n {\n name: \"files-list-versions\",\n description: \"List all versions of files in your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"Optional specific file key to list versions for (if not provided, lists versions for all files)\"\n },\n limit: {\n type: \"number\",\n description: \"Maximum number of versions to return (1-1000)\",\n default: 100,\n minimum: 1,\n maximum: 1000\n }\n }\n }\n },\n {\n name: \"files-move\",\n description: \"Move/rename a file within your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n sourceKey: {\n type: \"string\",\n description: \"The source file key\"\n },\n destinationKey: {\n type: \"string\",\n description: \"The destination file key\"\n }\n },\n required: [\"sourceKey\", \"destinationKey\"]\n }\n },\n {\n name: \"files-copy\",\n description: \"Copy a file within your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n sourceKey: {\n type: \"string\",\n description: \"The source file key\"\n },\n destinationKey: {\n type: \"string\",\n description: \"The destination file key\"\n }\n },\n required: [\"sourceKey\", \"destinationKey\"]\n }\n },\n {\n name: \"files-exists\",\n description: \"Check if a file exists in your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The file key to check\"\n }\n },\n required: [\"key\"]\n }\n },\n {\n name: \"files-metadata\",\n description: \"Get metadata for a file in your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The file key to get metadata for\"\n },\n versionId: {\n type: \"string\",\n description: \"Optional version ID to get metadata for a specific version\"\n }\n },\n required: [\"key\"]\n }\n }\n] as const;\n\n// Code Execution Tools\nexport const CODE_TOOLS = [\n {\n name: \"code-exec\",\n description:\n \"Execute JavaScript/TypeScript code. The code must define an async execute function which will receive input and tools params. You can provide code either directly as a string or reference a files store key containing the code.\",\n inputSchema: {\n type: \"object\",\n properties: {\n code: {\n type: \"string\",\n description: \"The JavaScript/TypeScript code to execute directly (mutually exclusive with 'key')\",\n },\n key: {\n type: \"string\",\n description: \"Files store key containing the code to execute (mutually exclusive with 'code')\",\n },\n input: {\n type: \"object\",\n description: \"Input parameters for the skill execution\",\n },\n },\n required: [\"input\"],\n oneOf: [\n {\n required: [\"code\", \"input\"]\n },\n {\n required: [\"key\", \"input\"]\n }\n ],\n },\n },\n {\n name: \"register-skill\",\n description:\n \"Register a stored code file as a reusable skill tool. The skill will be available as a normal tool with its own input schema for this user only.\",\n inputSchema: {\n type: \"object\",\n properties: {\n name: {\n type: \"string\",\n description: \"The name for the skill (will be used as the tool name)\",\n pattern: \"^[a-zA-Z][a-zA-Z0-9_-]*$\"\n },\n description: {\n type: \"string\",\n description: \"Description of what the skill does\"\n },\n fileKey: {\n type: \"string\",\n description: \"Files store key containing the skill code\"\n },\n inputSchema: {\n type: \"object\",\n description: \"JSON Schema defining the input parameters for the skill\"\n }\n },\n required: [\"name\", \"description\", \"fileKey\", \"inputSchema\"]\n }\n },\n {\n name: \"unregister-skill\",\n description: \"Unregister a previously registered skill tool.\",\n inputSchema: {\n type: \"object\",\n properties: {\n name: {\n type: \"string\",\n description: \"The name of the skill to unregister\"\n }\n },\n required: [\"name\"]\n }\n },\n {\n name: \"list-skills\",\n description: \"List all registered skills for the current user.\",\n inputSchema: {\n type: \"object\",\n properties: {}\n }\n }\n] as const;\n\n// OpenAI Tools\nexport const OPENAI_TOOLS = [\n {\n name: \"openai-chat-completion\",\n description: \"Create a chat completion using OpenAI's API via Val Town's OpenAI integration\",\n inputSchema: {\n type: \"object\",\n properties: {\n messages: {\n type: \"array\",\n description: \"Array of message objects for the conversation\",\n items: {\n type: \"object\",\n properties: {\n role: {\n type: \"string\",\n enum: [\"system\", \"user\", \"assistant\"],\n description: \"The role of the message author\"\n },\n content: {\n type: \"string\",\n description: \"The content of the message\"\n }\n },\n required: [\"role\", \"content\"]\n }\n },\n model: {\n type: \"string\",\n description: \"The OpenAI model to use\",\n default: \"gpt-4o-mini\",\n enum: [\n \"gpt-4o\",\n \"gpt-4o-mini\", \n \"gpt-4-turbo\",\n \"gpt-4\",\n \"gpt-3.5-turbo\"\n ]\n },\n max_tokens: {\n type: \"number\",\n description: \"Maximum number of tokens to generate\",\n minimum: 1,\n maximum: 4096\n },\n temperature: {\n type: \"number\",\n description: \"Sampling temperature (0-2)\",\n minimum: 0,\n maximum: 2,\n default: 1\n },\n top_p: {\n type: \"number\",\n description: \"Nucleus sampling parameter (0-1)\",\n minimum: 0,\n maximum: 1,\n default: 1\n },\n frequency_penalty: {\n type: \"number\",\n description: \"Frequency penalty (-2 to 2)\",\n minimum: -2,\n maximum: 2,\n default: 0\n },\n presence_penalty: {\n type: \"number\",\n description: \"Presence penalty (-2 to 2)\",\n minimum: -2,\n maximum: 2,\n default: 0\n }\n },\n required: [\"messages\"]\n }\n }\n] as const;\n\n// System Tools (Only available in system mode)\nexport const SYSTEM_TOOLS = [\n {\n name: \"system-read-file\",\n description: \"Read a source code file from the project using Val Town API (system mode only)\",\n inputSchema: {\n type: \"object\",\n properties: {\n path: {\n type: \"string\",\n description: \"The file path to read (e.g., 'src/auth/auth-manager.ts', 'index.ts', '/README.md')\"\n }\n },\n required: [\"path\"]\n }\n },\n {\n name: \"system-list-files\",\n description: \"List all files in the project directory structure using Val Town API (system mode only)\",\n inputSchema: {\n type: \"object\",\n properties: {\n path: {\n type: \"string\",\n description: \"Optional directory path to list (defaults to root '/')\",\n default: \"/\"\n },\n recursive: {\n type: \"boolean\",\n description: \"Whether to list files recursively\",\n default: false\n }\n }\n }\n },\n {\n name: \"system-project-info\",\n description: \"Get project information and structure overview using Val Town API (system mode only)\",\n inputSchema: {\n type: \"object\",\n properties: {}\n }\n }\n] as const;\n\n// All tools combined\nexport const ALL_TOOLS = [\n ...KV_TOOLS,\n ...FILES_TOOLS,\n ...CODE_TOOLS,\n ...OPENAI_TOOLS\n] as const;\n\n// All tools including system tools (for system mode)\nexport const ALL_TOOLS_WITH_SYSTEM = [\n ...KV_TOOLS,\n ...FILES_TOOLS,\n ...CODE_TOOLS,\n ...OPENAI_TOOLS,\n ...SYSTEM_TOOLS\n] as const;",[99,100,114],"629a6027b94e9ef74d13c6e3790abfe371e9d535203fa9d919338a81cd5d4bb8","0c27870c-490d-11f0-8581-76b3cceeab13","1d9b767c-482e-11f0-a175-76b3cceeab13","8ca530fd-5572-459f-a5cb-36d769fb7219",319,["D",1749898083571],"/**\n * Tool definitions for the AWS MCP Server\n */\n\n// Key-Value Store Tools (Namespaced)\nexport const KV_TOOLS = [\n {\n name: \"kv-get\",\n description: \"Get a value by key from your personal key-value store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The key to retrieve\"\n }\n },\n required: [\"key\"]\n }\n },\n {\n name: \"kv-put\",\n description: \"Store a key-value pair in your personal key-value store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The key to store\"\n },\n value: {\n description: \"The value to store (can be any JSON-serializable data)\"\n },\n ttl: {\n type: \"number\",\n description: \"Optional time-to-live in seconds (data will be automatically deleted after this time)\"\n }\n },\n required: [\"key\", \"value\"]\n }\n },\n {\n name: \"kv-delete\",\n description: \"Delete a key-value pair from your personal key-value store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The key to delete\"\n }\n },\n required: [\"key\"]\n }\n },\n {\n name: \"kv-list\",\n description: \"List keys in your personal key-value store with optional prefix filter\",\n inputSchema: {\n type: \"object\",\n properties: {\n prefix: {\n type: \"string\",\n description: \"Optional key prefix to filter by (e.g., 'user-' to list all keys starting with 'user-')\"\n },\n limit: {\n type: \"number\",\n description: \"Maximum number of keys to return (1-1000)\",\n default: 100,\n minimum: 1,\n maximum: 1000\n }\n }\n }\n },\n {\n name: \"kv-query\",\n description: \"Query key-value pairs by key pattern from your personal key-value store\",\n inputSchema: {\n type: \"object\",\n properties: {\n keyPattern: {\n type: \"string\",\n description: \"Key pattern to match (supports prefix matching, e.g., 'config*' matches all keys starting with 'config')\"\n },\n limit: {\n type: \"number\",\n description: \"Maximum number of items to return (1-1000)\",\n default: 100,\n minimum: 1,\n maximum: 1000\n }\n },\n required: [\"keyPattern\"]\n }\n }\n] as const;\n\n// Files Store Tools (Namespaced)\nexport const FILES_TOOLS = [\n {\n name: \"files-get\",\n description: \"Get a file by key from your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The file key to retrieve\"\n },\n versionId: {\n type: \"string\",\n description: \"Optional version ID to retrieve a specific version\"\n }\n },\n required: [\"key\"]\n }\n },\n {\n name: \"files-put\",\n description: \"Store a file in your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The file key to store\"\n },\n content: {\n type: \"string\",\n description: \"The file content to store\"\n },\n contentType: {\n type: \"string\",\n description: \"Optional content type (will be inferred from file extension if not provided)\"\n },\n metadata: {\n type: \"object\",\n description: \"Optional metadata key-value pairs to store with the file\"\n }\n },\n required: [\"key\", \"content\"]\n }\n },\n {\n name: \"files-delete\",\n description: \"Delete a file from your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The file key to delete\"\n },\n versionId: {\n type: \"string\",\n description: \"Optional version ID to delete a specific version\"\n }\n },\n required: [\"key\"]\n }\n },\n {\n name: \"files-list\",\n description: \"List files in your personal file store with optional prefix filter\",\n inputSchema: {\n type: \"object\",\n properties: {\n prefix: {\n type: \"string\",\n description: \"Optional key prefix to filter by (e.g., 'documents/' to list all files in documents folder)\"\n },\n limit: {\n type: \"number\",\n description: \"Maximum number of files to return (1-1000)\",\n default: 100,\n minimum: 1,\n maximum: 1000\n }\n }\n }\n },\n {\n name: \"files-list-versions\",\n description: \"List all versions of files in your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"Optional specific file key to list versions for (if not provided, lists versions for all files)\"\n },\n limit: {\n type: \"number\",\n description: \"Maximum number of versions to return (1-1000)\",\n default: 100,\n minimum: 1,\n maximum: 1000\n }\n }\n }\n },\n {\n name: \"files-move\",\n description: \"Move/rename a file within your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n sourceKey: {\n type: \"string\",\n description: \"The source file key\"\n },\n destinationKey: {\n type: \"string\",\n description: \"The destination file key\"\n }\n },\n required: [\"sourceKey\", \"destinationKey\"]\n }\n },\n {\n name: \"files-copy\",\n description: \"Copy a file within your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n sourceKey: {\n type: \"string\",\n description: \"The source file key\"\n },\n destinationKey: {\n type: \"string\",\n description: \"The destination file key\"\n }\n },\n required: [\"sourceKey\", \"destinationKey\"]\n }\n },\n {\n name: \"files-exists\",\n description: \"Check if a file exists in your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The file key to check\"\n }\n },\n required: [\"key\"]\n }\n },\n {\n name: \"files-metadata\",\n description: \"Get metadata for a file in your personal file store\",\n inputSchema: {\n type: \"object\",\n properties: {\n key: {\n type: \"string\",\n description: \"The file key to get metadata for\"\n },\n versionId: {\n type: \"string\",\n description: \"Optional version ID to get metadata for a specific version\"\n }\n },\n required: [\"key\"]\n }\n }\n] as const;\n\n// Code Execution Tools\nexport const CODE_TOOLS = [\n {\n name: \"code-exec\",\n description:\n \"Execute JavaScript/TypeScript code. The code must define an async execute function which will receive input and tools params. You can provide code either directly as a string or reference a files store key containing the code.\",\n inputSchema: {\n type: \"object\",\n properties: {\n code: {\n type: \"string\",\n description: \"The JavaScript/TypeScript code to execute directly (mutually exclusive with 'key')\",\n },\n key: {\n type: \"string\",\n description: \"Files store key containing the code to execute (mutually exclusive with 'code')\",\n },\n input: {\n type: \"object\",\n description: \"Input parameters for the skill execution\",\n },\n },\n required: [\"input\"],\n oneOf: [\n {\n required: [\"code\", \"input\"]\n },\n {\n required: [\"key\", \"input\"]\n }\n ],\n },\n },\n {\n name: \"register-skill\",\n description:\n \"Register a stored code file as a reusable skill tool. The skill will be available as a normal tool with its own input schema for this user only.\",\n inputSchema: {\n type: \"object\",\n properties: {\n name: {\n type: \"string\",\n description: \"The name for the skill (will be used as the tool name)\",\n pattern: \"^[a-zA-Z][a-zA-Z0-9_-]*$\"\n },\n description: {\n type: \"string\",\n description: \"Description of what the skill does\"\n },\n fileKey: {\n type: \"string\",\n description: \"Files store key containing the skill code\"\n },\n inputSchema: {\n type: \"object\",\n description: \"JSON Schema defining the input parameters for the skill\"\n }\n },\n required: [\"name\", \"description\", \"fileKey\", \"inputSchema\"]\n }\n },\n {\n name: \"unregister-skill\",\n description: \"Unregister a previously registered skill tool.\",\n inputSchema: {\n type: \"object\",\n properties: {\n name: {\n type: \"string\",\n description: \"The name of the skill to unregister\"\n }\n },\n required: [\"name\"]\n }\n },\n {\n name: \"list-skills\",\n description: \"List all registered skills for the current user.\",\n inputSchema: {\n type: \"object\",\n properties: {}\n }\n }\n] as const;\n\n// System Tools (Only available in system mode)\nexport const SYSTEM_TOOLS = [\n {\n name: \"system-read-file\",\n description: \"Read a source code file from the project using Val Town API (system mode only)\",\n inputSchema: {\n type: \"object\",\n properties: {\n path: {\n type: \"string\",\n description: \"The file path to read (e.g., 'src/auth/auth-manager.ts', 'index.ts', '/README.md')\"\n }\n },\n required: [\"path\"]\n }\n },\n {\n name: \"system-list-files\",\n description: \"List all files in the project directory structure using Val Town API (system mode only)\",\n inputSchema: {\n type: \"object\",\n properties: {\n path: {\n type: \"string\",\n description: \"Optional directory path to list (defaults to root '/')\",\n default: \"/\"\n },\n recursive: {\n type: \"boolean\",\n description: \"Whether to list files recursively\",\n default: false\n }\n }\n }\n },\n {\n name: \"system-project-info\",\n description: \"Get project information and structure overview using Val Town API (system mode only)\",\n inputSchema: {\n type: \"object\",\n properties: {}\n }\n }\n] as const;\n\n// All tools combined\nexport const ALL_TOOLS = [\n ...KV_TOOLS,\n ...FILES_TOOLS,\n ...CODE_TOOLS\n] as const;\n\n// All tools including system tools (for system mode)\nexport const ALL_TOOLS_WITH_SYSTEM = [\n ...KV_TOOLS,\n ...FILES_TOOLS,\n ...CODE_TOOLS,\n ...SYSTEM_TOOLS\n] as const;",[99,100,114],"6dcdf21e24b4bdc294a70c1ad9ef2389a73ed395fa3ad9c53daded25c3357b1d","src/mcp/handler.ts",{"_32":145,"_13":135,"_80":146,"_82":147,"_84":33,"_85":148,"_87":49,"_34":149,"_41":150,"_90":91,"_92":151,"_64":49,"_94":-5,"_95":-7,"_72":152,"_97":153},{"_32":134,"_13":135,"_80":136,"_82":137,"_84":57,"_85":138,"_87":26,"_34":139,"_41":140,"_90":91,"_92":141,"_64":49,"_94":-5,"_95":-7,"_72":142,"_97":143},"18396184-4d57-11f0-aa62-76b3cceeab13","handler.ts","11511559-1f34-412d-9375-9a8604ddaded","3a7ad6ed-ef44-4849-98f4-d1e0c50229b1",17,["D",1750369691228],8,"/**\n * Refactored MCP SDK Handler for JSON-RPC requests\n * Uses extracted tool handlers and protocol handlers\n */\n\nimport { AuthContext } from \"../storage/kv-store.ts\";\nimport { ExtendedAuthContext, AuthManager } from \"../auth/auth-manager.ts\";\nimport { createAWSClients } from \"../aws/clients.ts\";\nimport { MCPProtocolHandlers } from \"./protocol-handlers.ts\";\nimport { KVToolHandlers, FilesToolHandlers, CodeToolHandlers, SystemToolHandlers, OpenAIToolHandlers } from \"../tools/handlers/index.ts\";\n\n// Environment variables\nconst S3_BUCKET = Deno.env.get(\"S3_BUCKET\") || \"example-bucket\";\nconst DYNAMODB_TABLE = Deno.env.get(\"DYNAMODB_TABLE\") || \"example-table\";\n\nexport class MCPHandler {\n private authManager: AuthManager;\n private protocolHandlers: MCPProtocolHandlers;\n private kvHandlers: KVToolHandlers;\n private filesHandlers: FilesToolHandlers;\n private codeHandlers: CodeToolHandlers;\n private systemHandlers: SystemToolHandlers;\n private openaiHandlers: OpenAIToolHandlers;\n\n constructor() {\n this.authManager = new AuthManager();\n \n // Create AWS clients\n const { docClient, s3Client } = createAWSClients();\n \n // Initialize handlers\n this.protocolHandlers = new MCPProtocolHandlers(s3Client);\n this.kvHandlers = new KVToolHandlers(docClient, DYNAMODB_TABLE);\n this.filesHandlers = new FilesToolHandlers(s3Client, S3_BUCKET);\n this.systemHandlers = new SystemToolHandlers();\n this.openaiHandlers = new OpenAIToolHandlers();\n \n // Create tools context for code execution\n const toolsContext = this.createToolsContext();\n this.codeHandlers = new CodeToolHandlers(this.filesHandlers, toolsContext, docClient, DYNAMODB_TABLE);\n \n // Set code handlers reference in protocol handlers for skill listing\n this.protocolHandlers.setCodeHandlers(this.codeHandlers);\n }\n\n private createToolsContext(): Record {\n const toolsContext: Record = {\n test: () => \"noOp\",\n };\n\n // Add all available tools to the context\n const allTools = [\n { name: \"kv-get\", handler: (args: any, authContext: AuthContext) => this.kvHandlers.handleKVGet(args, authContext) },\n { name: \"kv-put\", handler: (args: any, authContext: AuthContext) => this.kvHandlers.handleKVPut(args, authContext) },\n { name: \"kv-delete\", handler: (args: any, authContext: AuthContext) => this.kvHandlers.handleKVDelete(args, authContext) },\n { name: \"kv-list\", handler: (args: any, authContext: AuthContext) => this.kvHandlers.handleKVList(args, authContext) },\n { name: \"kv-query\", handler: (args: any, authContext: AuthContext) => this.kvHandlers.handleKVQuery(args, authContext) },\n { name: \"files-get\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesGet(args, authContext) },\n { name: \"files-put\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesPut(args, authContext) },\n { name: \"files-delete\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesDelete(args, authContext) },\n { name: \"files-list\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesList(args, authContext) },\n { name: \"files-list-versions\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesListVersions(args, authContext) },\n { name: \"files-move\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesMove(args, authContext) },\n { name: \"files-copy\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesCopy(args, authContext) },\n { name: \"files-exists\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesExists(args, authContext) },\n { name: \"files-metadata\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesMetadata(args, authContext) },\n { name: \"openai-chat-completion\", handler: (args: any, authContext: AuthContext) => this.openaiHandlers.handleChatCompletion(args, authContext) },\n ];\n\n // Store the auth context for later use in tool execution\n let currentAuthContext: AuthContext;\n\n allTools.forEach(tool => {\n toolsContext[tool.name] = async (args: any) => {\n console.log(`[CodeExec] Executing tool ${tool.name}`, args);\n return await tool.handler(args, currentAuthContext);\n };\n });\n\n // Store a reference to set the auth context\n (toolsContext as any)._setAuthContext = (authContext: AuthContext) => {\n currentAuthContext = authContext;\n };\n\n return toolsContext;\n }\n\n // Handle streamable HTTP request\n async handleStreamableRequest(request: Request, body: any, authContext: ExtendedAuthContext): Promise {\n try {\n // Set auth context for code execution tools\n (this.codeHandlers as any).toolsContext._setAuthContext(authContext);\n\n // Process JSON-RPC request directly\n console.log(\"[MCP] Received JSON-RPC request:\", body);\n const { jsonrpc, method, params, id } = body;\n\n if (jsonrpc !== \"2.0\") {\n return {\n jsonrpc: \"2.0\",\n id,\n error: {\n code: -32600,\n message: \"Invalid Request: jsonrpc must be '2.0'\",\n },\n };\n }\n\n // Route the method to appropriate handler\n let result;\n\n switch (method) {\n case \"initialize\":\n result = await this.protocolHandlers.handleInitialize(params);\n break;\n case \"prompts/list\":\n result = await this.protocolHandlers.handleListPrompts();\n break;\n case \"prompts/get\":\n result = await this.protocolHandlers.handleGetPrompt(params);\n break;\n case \"resources/list\":\n result = await this.protocolHandlers.handleListResources(authContext);\n break;\n case \"resources/read\":\n result = await this.protocolHandlers.handleReadResource(params, authContext);\n break;\n case \"tools/list\":\n result = await this.protocolHandlers.handleListTools(authContext);\n break;\n case \"tools/call\":\n result = await this.handleCallTool(params, authContext);\n break;\n case \"notifications/initialized\":\n return null;\n default:\n console.error(`[MCP] Unknown method: ${method}`);\n return {\n jsonrpc: \"2.0\",\n id,\n error: {\n code: -32601,\n message: `Method not found: ${method}`,\n },\n };\n }\n console.log(\"[MCP] Response:\", result);\n return {\n jsonrpc: \"2.0\",\n id,\n result,\n };\n } catch (error) {\n console.error(`[MCP] handleStreamableRequest Error:`, error);\n return {\n jsonrpc: \"2.0\",\n id: body?.id || null,\n error: {\n code: -32603,\n message: error.message || \"Internal error\",\n },\n };\n }\n }\n\n private async handleCallTool(params: any, authContext: ExtendedAuthContext) {\n const { name, arguments: args } = params;\n\n console.log(`[MCP] Calling tool: ${name}`, args);\n\n const toolErrorWrapper = async (p: Promise) => {\n try {\n return await p;\n } catch (err) {\n console.error(`[MCP] Tool (${name}) error`, err);\n return {\n content: [{\n type: \"text\",\n text: `Error: ${name} tool failed. With error: ${\n JSON.stringify({ message: err.message, stack: err.stack })\n }`,\n }],\n };\n }\n };\n\n switch (name) {\n // KV Store tools\n case \"kv-get\":\n return await toolErrorWrapper(this.kvHandlers.handleKVGet(args, authContext));\n case \"kv-put\":\n return await toolErrorWrapper(this.kvHandlers.handleKVPut(args, authContext));\n case \"kv-delete\":\n return await toolErrorWrapper(this.kvHandlers.handleKVDelete(args, authContext));\n case \"kv-list\":\n return await toolErrorWrapper(this.kvHandlers.handleKVList(args, authContext));\n case \"kv-query\":\n return await toolErrorWrapper(this.kvHandlers.handleKVQuery(args, authContext));\n \n // Files Store tools\n case \"files-get\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesGet(args, authContext));\n case \"files-put\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesPut(args, authContext));\n case \"files-delete\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesDelete(args, authContext));\n case \"files-list\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesList(args, authContext));\n case \"files-list-versions\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesListVersions(args, authContext));\n case \"files-move\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesMove(args, authContext));\n case \"files-copy\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesCopy(args, authContext));\n case \"files-exists\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesExists(args, authContext));\n case \"files-metadata\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesMetadata(args, authContext));\n \n // Code execution\n case \"code-exec\":\n return await toolErrorWrapper(this.codeHandlers.handleCodeExec(args, authContext));\n \n // Skill management\n case \"register-skill\":\n return await toolErrorWrapper(this.codeHandlers.handleRegisterSkill(args, authContext));\n case \"unregister-skill\":\n return await toolErrorWrapper(this.codeHandlers.handleUnregisterSkill(args, authContext));\n case \"list-skills\":\n return await toolErrorWrapper(this.codeHandlers.handleListSkills(args, authContext));\n \n // System tools (only available in system mode)\n case \"system-read-file\":\n return await toolErrorWrapper(this.systemHandlers.handleSystemReadFile(args, authContext));\n case \"system-list-files\":\n return await toolErrorWrapper(this.systemHandlers.handleSystemListFiles(args, authContext));\n case \"system-project-info\":\n return await toolErrorWrapper(this.systemHandlers.handleSystemProjectInfo(args, authContext));\n \n // OpenAI tools\n case \"openai-chat-completion\":\n return await toolErrorWrapper(this.openaiHandlers.handleChatCompletion(args, authContext));\n \n default:\n // Check if it's a registered skill\n try {\n const registeredSkills = await this.codeHandlers.getRegisteredSkills(authContext);\n const skill = registeredSkills.find(s => s.name === name);\n if (skill) {\n return await toolErrorWrapper(this.codeHandlers.handleSkillExecution(name, args, authContext));\n }\n } catch (error) {\n console.error(`Error checking registered skills: ${error.message}`);\n }\n \n throw new Error(`Unknown tool: ${name}`);\n }\n }\n}",[99,144,135],"1b179fee50c039fac17284f93b9eeb92c02d92f2e0589d3a4876483d6992d461","mcp","4738c3e8-4907-11f0-b9a7-76b3cceeab13","94f6ca0a-482e-11f0-8e60-76b3cceeab13","6935723a-650d-4d16-90b7-662be8ca3f3c",309,["D",1749895605686],10,"/**\n * Refactored MCP SDK Handler for JSON-RPC requests\n * Uses extracted tool handlers and protocol handlers\n */\n\nimport { AuthContext } from \"../storage/kv-store.ts\";\nimport { ExtendedAuthContext, AuthManager } from \"../auth/auth-manager.ts\";\nimport { createAWSClients } from \"../aws/clients.ts\";\nimport { MCPProtocolHandlers } from \"./protocol-handlers.ts\";\nimport { KVToolHandlers, FilesToolHandlers, CodeToolHandlers, SystemToolHandlers } from \"../tools/handlers/index.ts\";\n\n// Environment variables\nconst S3_BUCKET = Deno.env.get(\"S3_BUCKET\") || \"example-bucket\";\nconst DYNAMODB_TABLE = Deno.env.get(\"DYNAMODB_TABLE\") || \"example-table\";\n\nexport class MCPHandler {\n private authManager: AuthManager;\n private protocolHandlers: MCPProtocolHandlers;\n private kvHandlers: KVToolHandlers;\n private filesHandlers: FilesToolHandlers;\n private codeHandlers: CodeToolHandlers;\n private systemHandlers: SystemToolHandlers;\n\n constructor() {\n this.authManager = new AuthManager();\n \n // Create AWS clients\n const { docClient, s3Client } = createAWSClients();\n \n // Initialize handlers\n this.protocolHandlers = new MCPProtocolHandlers(s3Client);\n this.kvHandlers = new KVToolHandlers(docClient, DYNAMODB_TABLE);\n this.filesHandlers = new FilesToolHandlers(s3Client, S3_BUCKET);\n this.systemHandlers = new SystemToolHandlers();\n \n // Create tools context for code execution\n const toolsContext = this.createToolsContext();\n this.codeHandlers = new CodeToolHandlers(this.filesHandlers, toolsContext, docClient, DYNAMODB_TABLE);\n \n // Set code handlers reference in protocol handlers for skill listing\n this.protocolHandlers.setCodeHandlers(this.codeHandlers);\n }\n\n private createToolsContext(): Record {\n const toolsContext: Record = {\n test: () => \"noOp\",\n };\n\n // Add all available tools to the context\n const allTools = [\n { name: \"kv-get\", handler: (args: any, authContext: AuthContext) => this.kvHandlers.handleKVGet(args, authContext) },\n { name: \"kv-put\", handler: (args: any, authContext: AuthContext) => this.kvHandlers.handleKVPut(args, authContext) },\n { name: \"kv-delete\", handler: (args: any, authContext: AuthContext) => this.kvHandlers.handleKVDelete(args, authContext) },\n { name: \"kv-list\", handler: (args: any, authContext: AuthContext) => this.kvHandlers.handleKVList(args, authContext) },\n { name: \"kv-query\", handler: (args: any, authContext: AuthContext) => this.kvHandlers.handleKVQuery(args, authContext) },\n { name: \"files-get\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesGet(args, authContext) },\n { name: \"files-put\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesPut(args, authContext) },\n { name: \"files-delete\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesDelete(args, authContext) },\n { name: \"files-list\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesList(args, authContext) },\n { name: \"files-list-versions\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesListVersions(args, authContext) },\n { name: \"files-move\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesMove(args, authContext) },\n { name: \"files-copy\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesCopy(args, authContext) },\n { name: \"files-exists\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesExists(args, authContext) },\n { name: \"files-metadata\", handler: (args: any, authContext: AuthContext) => this.filesHandlers.handleFilesMetadata(args, authContext) },\n ];\n\n // Store the auth context for later use in tool execution\n let currentAuthContext: AuthContext;\n\n allTools.forEach(tool => {\n toolsContext[tool.name] = async (args: any) => {\n console.log(`[CodeExec] Executing tool ${tool.name}`, args);\n return await tool.handler(args, currentAuthContext);\n };\n });\n\n // Store a reference to set the auth context\n (toolsContext as any)._setAuthContext = (authContext: AuthContext) => {\n currentAuthContext = authContext;\n };\n\n return toolsContext;\n }\n\n // Handle streamable HTTP request\n async handleStreamableRequest(request: Request, body: any, authContext: ExtendedAuthContext): Promise {\n try {\n // Set auth context for code execution tools\n (this.codeHandlers as any).toolsContext._setAuthContext(authContext);\n\n // Process JSON-RPC request directly\n console.log(\"[MCP] Received JSON-RPC request:\", body);\n const { jsonrpc, method, params, id } = body;\n\n if (jsonrpc !== \"2.0\") {\n return {\n jsonrpc: \"2.0\",\n id,\n error: {\n code: -32600,\n message: \"Invalid Request: jsonrpc must be '2.0'\",\n },\n };\n }\n\n // Route the method to appropriate handler\n let result;\n\n switch (method) {\n case \"initialize\":\n result = await this.protocolHandlers.handleInitialize(params);\n break;\n case \"prompts/list\":\n result = await this.protocolHandlers.handleListPrompts();\n break;\n case \"prompts/get\":\n result = await this.protocolHandlers.handleGetPrompt(params);\n break;\n case \"resources/list\":\n result = await this.protocolHandlers.handleListResources(authContext);\n break;\n case \"resources/read\":\n result = await this.protocolHandlers.handleReadResource(params, authContext);\n break;\n case \"tools/list\":\n result = await this.protocolHandlers.handleListTools(authContext);\n break;\n case \"tools/call\":\n result = await this.handleCallTool(params, authContext);\n break;\n case \"notifications/initialized\":\n return null;\n default:\n console.error(`[MCP] Unknown method: ${method}`);\n return {\n jsonrpc: \"2.0\",\n id,\n error: {\n code: -32601,\n message: `Method not found: ${method}`,\n },\n };\n }\n console.log(\"[MCP] Response:\", result);\n return {\n jsonrpc: \"2.0\",\n id,\n result,\n };\n } catch (error) {\n console.error(`[MCP] handleStreamableRequest Error:`, error);\n return {\n jsonrpc: \"2.0\",\n id: body?.id || null,\n error: {\n code: -32603,\n message: error.message || \"Internal error\",\n },\n };\n }\n }\n\n private async handleCallTool(params: any, authContext: ExtendedAuthContext) {\n const { name, arguments: args } = params;\n\n console.log(`[MCP] Calling tool: ${name}`, args);\n\n const toolErrorWrapper = async (p: Promise) => {\n try {\n return await p;\n } catch (err) {\n console.error(`[MCP] Tool (${name}) error`, err);\n return {\n content: [{\n type: \"text\",\n text: `Error: ${name} tool failed. With error: ${\n JSON.stringify({ message: err.message, stack: err.stack })\n }`,\n }],\n };\n }\n };\n\n switch (name) {\n // KV Store tools\n case \"kv-get\":\n return await toolErrorWrapper(this.kvHandlers.handleKVGet(args, authContext));\n case \"kv-put\":\n return await toolErrorWrapper(this.kvHandlers.handleKVPut(args, authContext));\n case \"kv-delete\":\n return await toolErrorWrapper(this.kvHandlers.handleKVDelete(args, authContext));\n case \"kv-list\":\n return await toolErrorWrapper(this.kvHandlers.handleKVList(args, authContext));\n case \"kv-query\":\n return await toolErrorWrapper(this.kvHandlers.handleKVQuery(args, authContext));\n \n // Files Store tools\n case \"files-get\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesGet(args, authContext));\n case \"files-put\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesPut(args, authContext));\n case \"files-delete\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesDelete(args, authContext));\n case \"files-list\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesList(args, authContext));\n case \"files-list-versions\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesListVersions(args, authContext));\n case \"files-move\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesMove(args, authContext));\n case \"files-copy\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesCopy(args, authContext));\n case \"files-exists\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesExists(args, authContext));\n case \"files-metadata\":\n return await toolErrorWrapper(this.filesHandlers.handleFilesMetadata(args, authContext));\n \n // Code execution\n case \"code-exec\":\n return await toolErrorWrapper(this.codeHandlers.handleCodeExec(args, authContext));\n \n // Skill management\n case \"register-skill\":\n return await toolErrorWrapper(this.codeHandlers.handleRegisterSkill(args, authContext));\n case \"unregister-skill\":\n return await toolErrorWrapper(this.codeHandlers.handleUnregisterSkill(args, authContext));\n case \"list-skills\":\n return await toolErrorWrapper(this.codeHandlers.handleListSkills(args, authContext));\n \n // System tools (only available in system mode)\n case \"system-read-file\":\n return await toolErrorWrapper(this.systemHandlers.handleSystemReadFile(args, authContext));\n case \"system-list-files\":\n return await toolErrorWrapper(this.systemHandlers.handleSystemListFiles(args, authContext));\n case \"system-project-info\":\n return await toolErrorWrapper(this.systemHandlers.handleSystemProjectInfo(args, authContext));\n \n default:\n // Check if it's a registered skill\n try {\n const registeredSkills = await this.codeHandlers.getRegisteredSkills(authContext);\n const skill = registeredSkills.find(s => s.name === name);\n if (skill) {\n return await toolErrorWrapper(this.codeHandlers.handleSkillExecution(name, args, authContext));\n }\n } catch (error) {\n console.error(`Error checking registered skills: ${error.message}`);\n }\n \n throw new Error(`Unknown tool: ${name}`);\n }\n }\n}",[99,144,135],"b751382f519e792b2cd4a2dd94330aafb7342d4b65c3edfaea049ce099904472","README.md",{"_32":165,"_13":154,"_80":166,"_82":-5,"_84":33,"_85":167,"_87":49,"_34":168,"_41":169,"_90":161,"_92":170,"_64":49,"_94":-5,"_95":-7,"_72":171,"_97":172},{"_32":157,"_13":154,"_80":158,"_82":-5,"_84":57,"_85":56,"_87":26,"_34":159,"_41":160,"_90":161,"_92":162,"_64":49,"_94":-5,"_95":-7,"_72":163,"_97":164},"6e9ef6d8-4d57-11f0-a260-76b3cceeab13","34849c4b-e839-4497-9128-4c9cd2735a87",["D",1750369836177],7,"file","# Remote HTTP AWS MCP Server\n\nA remote HTTP Model Context Protocol (MCP) server that provides access to AWS services including DynamoDB and S3. This server now uses the official MCP SDK for JSON-RPC handling and exposes prompts, resources, and tools via both JSON-RPC and legacy HTTP endpoints with bearer token authentication.\n\n## Project Structure\n\nThe codebase is organized into a clean, modular structure:\n\n```\n├── index.ts # Main HTTP entry point\n├── src/\n│ ├── auth/\n│ │ └── auth-manager.ts # Authentication and namespace management\n│ ├── aws/\n│ │ └── clients.ts # AWS client configuration utilities\n│ ├── mcp/\n│ │ ├── handler.ts # Main MCP request handler\n│ │ └── protocol-handlers.ts # MCP protocol-specific handlers (prompts, resources)\n│ ├── storage/\n│ │ ├── kv-store.ts # Namespaced DynamoDB key-value store\n│ │ └── files-store.ts # Namespaced S3 files store\n│ ├── tools/\n│ │ ├── definitions.ts # Tool schema definitions\n│ │ └── handlers/\n│ │ ├── index.ts # Unified tool handlers export\n│ │ ├── kv-tools.ts # Key-value store tool handlers\n│ │ ├── files-tools.ts # Files store tool handlers\n│ │ ├── code-tools.ts # Code execution tool handlers\n│ │ ├── openai-tools.ts # OpenAI API tool handlers\n│ │ └── system-tools.ts # System tools using Val Town API\n│ └── valtown/\n│ └── client.ts # Val Town API client for project file access\n└── README.md\n```\n\nThis modular structure provides:\n- **Separation of concerns**: Each component has a single responsibility\n- **Easy testing**: Individual components can be tested in isolation\n- **Maintainability**: Changes to one area don't affect others\n- **Extensibility**: New tools and handlers can be easily added\n\n## Features\n\n### JSON-RPC Endpoint (Recommended)\n- **POST /mcp**: Primary JSON-RPC endpoint using MCP SDK for all operations\n- Supports all MCP operations: prompts, resources, and tools\n- Proper JSON-RPC 2.0 protocol compliance\n- Batch request support\n\n### Legacy HTTP Endpoints (Deprecated)\n- **GET /**: Server information and capabilities\n- **GET /health**: Health check endpoint\n- **GET /mcp/prompts**: List available prompts (deprecated)\n- **POST /mcp/prompts/:name**: Get specific prompt content (deprecated)\n- **GET /mcp/resources**: List S3 resources (deprecated, requires auth)\n- **GET /mcp/resources/***: Read specific S3 resource (deprecated, requires auth)\n- **GET /mcp/tools**: List available tools (deprecated)\n- **POST /mcp/tools/:name**: Execute specific tool (deprecated, requires auth)\n\n### Authentication\n\n- Uses Bearer token authentication\n- AWS_SECRET_ACCESS_KEY is passed via `Authorization: Bearer ` header\n- Other AWS credentials are configured via environment variables\n- **User Isolation**: Each bearer token creates an isolated namespace for data storage\n - KV Store operations are automatically namespaced per user\n - Files Store operations are automatically namespaced per user\n - Resources (file listings) are automatically filtered per user namespace\n- **Demo Mode**: Requests without valid authentication use a shared \"demo\" namespace with limited capabilities\n- **System Mode**: When the bearer token matches the AWS_SECRET_ACCESS_KEY environment variable, the system enters \"system mode\" with access to:\n - All regular user tools and operations within the user's own namespace\n - Special system tools for reading project source code\n - Project structure inspection capabilities\n - Enhanced debugging and administration features\n - **Important**: System mode preserves the original user's namespace instead of switching to a separate \"system\" namespace, ensuring consistent data access across modes\n\n### Prompts\n- **analyze-data**: Analyze data from DynamoDB and S3 resources\n- **data-summary**: Generate a summary of available data sources\n\n### Resources\n- **Files**: Access and read files from your personal file store\n- Automatic MIME type detection\n- File metadata (size, last modified, version information)\n- Namespace isolation per user\n\n### Tools\n\n#### Key-Value Store Operations (Namespaced)\n- **kv-get**: Get a value by key from your personal key-value store\n- **kv-put**: Store a key-value pair in your personal key-value store\n- **kv-delete**: Delete a key-value pair from your personal key-value store\n- **kv-list**: List keys in your personal key-value store with optional prefix filter\n- **kv-query**: Query key-value pairs by key pattern from your personal key-value store\n\n#### Files Store Operations (Namespaced)\n- **files-get**: Get a file by key from your personal file store (supports versioning)\n- **files-put**: Store a file in your personal file store\n- **files-delete**: Delete a file from your personal file store (supports version-specific deletion)\n- **files-list**: List files in your personal file store with optional prefix filter\n- **files-list-versions**: List all versions of files in your personal file store\n- **files-move**: Move/rename a file within your personal file store\n- **files-copy**: Copy a file within your personal file store\n- **files-exists**: Check if a file exists in your personal file store\n- **files-metadata**: Get metadata for a file in your personal file store (supports versioning)\n\n#### Code Execution\n- **code-exec**: Execute JavaScript/TypeScript code with access to all MCP tools. Code can be provided directly as a string or referenced via files store key\n\n#### Skill Management\n- **register-skill**: Register a stored code file as a reusable skill tool with custom input schema\n- **unregister-skill**: Remove a previously registered skill\n- **list-skills**: List all registered skills for the current user\n- **[user-skills]**: Dynamically registered skills appear as individual tools with their own schemas\n\n#### System Tools (System Mode Only)\n- **system-read-file**: Read a source code file from the project using Val Town API (requires system mode access)\n- **system-list-files**: List all files in the project directory structure using Val Town API (requires system mode access)\n- **system-project-info**: Get project information and structure overview using Val Town API (requires system mode access)\n\n#### OpenAI API Tools\n- **openai-chat-completion**: Create chat completions using OpenAI's API via Val Town's built-in OpenAI integration (supports GPT-4, GPT-3.5, and other models)\n\n## OpenAI Integration\n\nThe server includes OpenAI chat completion functionality using Val Town's built-in OpenAI integration. This provides seamless access to OpenAI's models without requiring additional API key configuration.\n\n### Example Usage\n\n```bash\n# Simple chat completion\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"openai-chat-completion\",\n \"arguments\": {\n \"messages\": [\n {\"role\": \"user\", \"content\": \"Say hello in a creative way\"}\n ],\n \"model\": \"gpt-4o-mini\",\n \"max_tokens\": 30\n }\n },\n \"id\": 1\n }'\n\n# Chat with system prompt\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"openai-chat-completion\",\n \"arguments\": {\n \"messages\": [\n {\"role\": \"system\", \"content\": \"You are a helpful assistant.\"},\n {\"role\": \"user\", \"content\": \"Explain quantum computing in simple terms.\"}\n ],\n \"model\": \"gpt-4o-mini\",\n \"max_tokens\": 500,\n \"temperature\": 0.7\n }\n },\n \"id\": 1\n }'\n```\n\n## Code Execution Feature\n\nThe `code-exec` tool allows you to execute JavaScript/TypeScript code with full access to all MCP tools (KV store and Files store operations). This enables powerful automation and data processing workflows.\n\n## Skill Management System\n\nThe skill management system allows you to register stored code files as reusable tools with custom input schemas. Once registered, skills appear as individual tools in the tools list and can be called like any other MCP tool.\n\n### Skill Registration\n\nUse the `register-skill` tool to register a code file as a skill:\n\n```json\n{\n \"name\": \"data-analyzer\",\n \"description\": \"Analyzes data from KV store and generates reports\",\n \"fileKey\": \"skills/data-analyzer.js\",\n \"inputSchema\": {\n \"type\": \"object\",\n \"properties\": {\n \"dataKey\": {\n \"type\": \"string\",\n \"description\": \"Key of data to analyze\"\n },\n \"reportType\": {\n \"type\": \"string\",\n \"enum\": [\"summary\", \"detailed\"],\n \"description\": \"Type of report to generate\"\n }\n },\n \"required\": [\"dataKey\"]\n }\n}\n```\n\n### Skill Management Tools\n\n- **register-skill**: Register a new skill from a files store key\n- **unregister-skill**: Remove a registered skill\n- **list-skills**: List all your registered skills\n\n### Using Registered Skills\n\nOnce registered, skills appear in the tools list and can be called directly:\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"data-analyzer\",\n \"arguments\": {\n \"dataKey\": \"user-data-2024\",\n \"reportType\": \"detailed\"\n }\n },\n \"id\": 1\n}\n```\n\n### Code Requirements\n\nYour code must define an `async execute` function that accepts two parameters:\n- `input`: Object containing input parameters for your script\n- `tools`: Object containing all available MCP tools as callable functions\n\n```javascript\nasync function execute(input, tools) {\n // Your code logic here\n const result = await tools[\"kv-get\"]({key: input.key});\n return { message: \"Processing complete\", data: result };\n}\n```\n\n### Available Tools in Code Context\n\nWithin your executed code, you have access to all MCP tools via the `tools` object:\n- `tools[\"kv-get\"](args)` - Get from your personal key-value store\n- `tools[\"kv-put\"](args)` - Put to your personal key-value store \n- `tools[\"kv-delete\"](args)` - Delete from your personal key-value store\n- `tools[\"kv-list\"](args)` - List keys in your personal key-value store\n- `tools[\"kv-query\"](args)` - Query your personal key-value store\n- `tools[\"files-get\"](args)` - Get file from your personal file store\n- `tools[\"files-put\"](args)` - Put file to your personal file store\n- `tools[\"files-delete\"](args)` - Delete file from your personal file store\n- `tools[\"files-list\"](args)` - List files in your personal file store\n- `tools[\"files-list-versions\"](args)` - List file versions in your personal file store\n- `tools[\"files-move\"](args)` - Move file in your personal file store\n- `tools[\"files-copy\"](args)` - Copy file in your personal file store\n- `tools[\"files-exists\"](args)` - Check if file exists in your personal file store\n- `tools[\"files-metadata\"](args)` - Get file metadata from your personal file store\n- `tools[\"openai-chat-completion\"](args)` - Create OpenAI chat completions\n\n### Two Execution Modes\n\n#### 1. Direct Code Execution\nProvide the code directly in the request:\n\n```json\n{\n \"code\": \"async function execute(input, tools) { /* your code */ }\",\n \"input\": { \"param1\": \"value1\" }\n}\n```\n\n#### 2. Files Store Code Execution \nStore your code in your personal file store and reference it by key:\n\n```json\n{\n \"key\": \"scripts/my-processor.js\",\n \"input\": { \"param1\": \"value1\" }\n}\n```\n\nThis approach is ideal for:\n- Reusable scripts and workflows\n- Version control of automation code (files store supports versioning)\n- Sharing scripts across different executions\n- Complex multi-function scripts\n- Personal script libraries isolated per user\n\n### Security Considerations\n\n- Code execution runs in a sandboxed environment\n- No access to global objects or external network calls\n- Only MCP tools are available for external operations\n- All AWS operations use the same authentication as other MCP tools\n\n## Setup\n\n### Environment Variables\n\nSet the following environment variables on your Val Town:\n\n```bash\nAWS_REGION=us-east-1\nAWS_ACCESS_KEY_ID=your-access-key-id\nS3_BUCKET=your-bucket-name\nDYNAMODB_TABLE=your-table-name\nMCP_SERVER_NAME=aws-mcp-server\nMCP_SERVER_VERSION=1.0.0\n```\n\n**Note**: `AWS_SECRET_ACCESS_KEY` is NOT set as an environment variable. Instead, it's passed via the Authorization header for security.\n\n**OpenAI Integration**: OpenAI functionality uses Val Town's built-in OpenAI integration, which automatically handles API key management. No additional environment variables are required for OpenAI tools.\n\n### DynamoDB Table Schema\n\nThe KV Store requires a DynamoDB table with the following schema:\n\n**Table Configuration:**\n- **Partition Key**: `pk` (String) - Contains the user namespace\n- **Sort Key**: `sk` (String) - Contains the user's key\n- **Billing Mode**: On-demand or Provisioned (your choice)\n- **TTL**: Optional - Set TTL attribute to `ttl` if you want automatic expiration\n\n**Example AWS CLI command to create the table:**\n```bash\naws dynamodb create-table \\\n --table-name your-table-name \\\n --attribute-definitions \\\n AttributeName=pk,AttributeType=S \\\n AttributeName=sk,AttributeType=S \\\n --key-schema \\\n AttributeName=pk,KeyType=HASH \\\n AttributeName=sk,KeyType=RANGE \\\n --billing-mode PAY_PER_REQUEST\n```\n\n**Example CloudFormation template:**\n```yaml\nDynamoDBTable:\n Type: AWS::DynamoDB::Table\n Properties:\n TableName: your-table-name\n AttributeDefinitions:\n - AttributeName: pk\n AttributeType: S\n - AttributeName: sk\n AttributeType: S\n KeySchema:\n - AttributeName: pk\n KeyType: HASH\n - AttributeName: sk\n KeyType: RANGE\n BillingMode: PAY_PER_REQUEST\n TimeToLiveSpecification:\n AttributeName: ttl\n Enabled: true\n```\n\n**Data Structure:**\nEach item in the table has the following structure:\n- `pk` (String): User namespace (e.g., \"user123\", \"demo\")\n- `sk` (String): User's key (e.g., \"settings\", \"config-app\")\n- `data` (Any): The actual value stored by the user\n- `created` (String): ISO timestamp when item was created\n- `updated` (String): ISO timestamp when item was last updated\n- `ttl` (Number, Optional): Unix timestamp for automatic expiration\n\n### Deployment\n\n1. Deploy to Val Town as an HTTP val\n2. Set the required environment variables\n3. The server will be available at your Val Town URL\n\n## Usage Examples\n\n### JSON-RPC Endpoint (Recommended)\n\nAll MCP operations should now use the JSON-RPC endpoint at `POST /mcp`. This provides proper MCP protocol compliance and better error handling.\n\n#### Authentication\n\nAll authenticated requests require the Authorization header:\n\n```bash\nAuthorization: Bearer your-aws-secret-access-key\n```\n\n#### List Prompts\n\n```bash\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"prompts/list\",\n \"params\": {},\n \"id\": 1\n }'\n```\n\n#### Get Prompt Content\n\n```bash\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"prompts/get\",\n \"params\": {\n \"name\": \"analyze-data\",\n \"arguments\": {\n \"table_key\": \"user123\",\n \"s3_key\": \"data/analytics.json\"\n }\n },\n \"id\": 1\n }'\n```\n\n#### List Resources (Files)\n\n```bash\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"resources/list\",\n \"params\": {},\n \"id\": 1\n }'\n```\n\n#### Read Files Resource\n\n```bash\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"resources/read\",\n \"params\": {\n \"uri\": \"files://path/to/file.txt\"\n },\n \"id\": 1\n }'\n```\n\n#### List Tools\n\n```bash\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/list\",\n \"params\": {},\n \"id\": 1\n }'\n```\n\n#### Execute Files Operations\n\n```bash\n# Store a file in your personal file store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-put\",\n \"arguments\": {\n \"key\": \"documents/my-file.txt\",\n \"content\": \"Hello, World!\",\n \"contentType\": \"text/plain\"\n }\n },\n \"id\": 1\n }'\n\n# Get a file from your personal file store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-get\",\n \"arguments\": {\n \"key\": \"documents/my-file.txt\"\n }\n },\n \"id\": 1\n }'\n\n# List files in your personal file store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-list\",\n \"arguments\": {\n \"prefix\": \"documents/\"\n }\n },\n \"id\": 1\n }'\n\n# List all versions of a file\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-list-versions\",\n \"arguments\": {\n \"key\": \"documents/my-file.txt\"\n }\n },\n \"id\": 1\n }'\n\n# Get a specific version of a file\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-get\",\n \"arguments\": {\n \"key\": \"documents/my-file.txt\",\n \"versionId\": \"specific-version-id\"\n }\n },\n \"id\": 1\n }'\n\n# Copy a file within your personal file store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-copy\",\n \"arguments\": {\n \"sourceKey\": \"documents/my-file.txt\",\n \"destinationKey\": \"backup/my-file-backup.txt\"\n }\n },\n \"id\": 1\n }'\n\n# Check if a file exists\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-exists\",\n \"arguments\": {\n \"key\": \"documents/my-file.txt\"\n }\n },\n \"id\": 1\n }'\n\n# Get file metadata\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-metadata\",\n \"arguments\": {\n \"key\": \"documents/my-file.txt\"\n }\n },\n \"id\": 1\n }'\n\n# Delete a file\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-delete\",\n \"arguments\": {\n \"key\": \"documents/my-file.txt\"\n }\n },\n \"id\": 1\n }'\n```\n\n#### Execute KV Store Operations\n\n```bash\n# Store a key-value pair in your personal store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"kv-put\",\n \"arguments\": {\n \"key\": \"user-settings\",\n \"value\": {\"theme\": \"dark\", \"language\": \"en\"},\n \"ttl\": 3600\n }\n },\n \"id\": 1\n }'\n\n# Get a value from your personal store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"kv-get\",\n \"arguments\": {\n \"key\": \"user-settings\"\n }\n },\n \"id\": 1\n }'\n\n# List keys in your personal store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"kv-list\",\n \"arguments\": {\n \"prefix\": \"user-\"\n }\n },\n \"id\": 1\n }'\n\n# Query key-value pairs by pattern\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"kv-query\",\n \"arguments\": {\n \"keyPattern\": \"config*\"\n }\n },\n \"id\": 1\n }'\n```\n\n#### Execute Skill Management Operations\n\n```bash\n# Register a skill\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"register-skill\",\n \"arguments\": {\n \"name\": \"data-analyzer\",\n \"description\": \"Analyzes data from KV store and generates reports\",\n \"fileKey\": \"skills/data-analyzer.js\",\n \"inputSchema\": {\n \"type\": \"object\",\n \"properties\": {\n \"dataKey\": {\n \"type\": \"string\",\n \"description\": \"Key of data to analyze\"\n },\n \"reportType\": {\n \"type\": \"string\",\n \"enum\": [\"summary\", \"detailed\"],\n \"description\": \"Type of report to generate\"\n }\n },\n \"required\": [\"dataKey\"]\n }\n }\n },\n \"id\": 1\n }'\n\n# List registered skills\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"list-skills\",\n \"arguments\": {}\n },\n \"id\": 1\n }'\n\n# Execute a registered skill\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"data-analyzer\",\n \"arguments\": {\n \"dataKey\": \"user-data-2024\",\n \"reportType\": \"detailed\"\n }\n },\n \"id\": 1\n }'\n\n# Unregister a skill\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"unregister-skill\",\n \"arguments\": {\n \"name\": \"data-analyzer\"\n }\n },\n \"id\": 1\n }'\n```\n\n```bash\n# Execute code directly (inline)\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"code-exec\",\n \"arguments\": {\n \"code\": \"async function execute(input, tools) { const result = await tools[\\\"kv-get\\\"]({key: input.key}); return {message: \\\"Data retrieved\\\", data: result}; }\",\n \"input\": {\n \"key\": \"user-settings\"\n }\n }\n },\n \"id\": 1\n }'\n\n# Execute code from files store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"code-exec\",\n \"arguments\": {\n \"key\": \"scripts/data-processor.js\",\n \"input\": {\n \"operation\": \"analyze\"\n }\n }\n },\n \"id\": 1\n }'\n```\n\n#### Batch Requests\n\nYou can send multiple JSON-RPC requests in a single HTTP request:\n\n```bash\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '[\n {\n \"jsonrpc\": \"2.0\",\n \"method\": \"prompts/list\",\n \"params\": {},\n \"id\": 1\n },\n {\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/list\",\n \"params\": {},\n \"id\": 2\n },\n {\n \"jsonrpc\": \"2.0\",\n \"method\": \"resources/list\",\n \"params\": {},\n \"id\": 3\n }\n ]'\n```\n\n### Legacy HTTP Endpoints (Deprecated)\n\nThe following endpoints are maintained for backward compatibility but are deprecated. Use the JSON-RPC endpoint instead.\n\n### Server Information\n\n```bash\ncurl https://your-val-town-url.web.val.run/\n```\n\n### List Prompts\n\n```bash\ncurl https://your-val-town-url.web.val.run/mcp/prompts\n```\n\n### Get Prompt Content\n\n```bash\ncurl -X POST https://your-val-town-url.web.val.run/mcp/prompts/analyze-data \\\n -H \"Content-Type: application/json\" \\\n -d '{\"table_key\": \"user123\", \"s3_key\": \"data/analytics.json\"}'\n```\n\n### List Resources (S3 Objects)\n\n```bash\ncurl https://your-val-town-url.web.val.run/mcp/resources \\\n -H \"Authorization: Bearer your-aws-secret-access-key\"\n```\n\n### Read S3 Resource\n\n```bash\ncurl \"https://your-val-town-url.web.val.run/mcp/resources/s3://your-bucket/path/to/file.txt\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\"\n```\n\n### List Tools\n\n```bash\ncurl https://your-val-town-url.web.val.run/mcp/tools\n```\n\n### Execute DynamoDB Operations\n\n```bash\n# Get an item\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/dynamodb-get \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"key\": {\"id\": \"user123\"}}'\n\n# Put an item\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/dynamodb-put \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"item\": {\"id\": \"user123\", \"name\": \"John Doe\", \"email\": \"john@example.com\"}}'\n\n# Query items\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/dynamodb-query \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"keyConditionExpression\": \"id = :id\", \"expressionAttributeValues\": {\":id\": \"user123\"}}'\n\n# Delete an item\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/dynamodb-delete \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"key\": {\"id\": \"user123\"}}'\n```\n\n### Execute S3 Operations\n\n```bash\n# Get object content\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/s3-get \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"key\": \"documents/report.txt\"}'\n\n# Upload content\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/s3-put \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"key\": \"documents/new-file.txt\", \"content\": \"Hello, World!\", \"contentType\": \"text/plain\"}'\n\n# Move/rename object\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/s3-move \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"sourceKey\": \"old-location/file.txt\", \"destinationKey\": \"new-location/file.txt\"}'\n\n# Delete object\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/s3-delete \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"key\": \"documents/old-file.txt\"}'\n```\n\n### Execute Code\n\n```bash\n# Execute code directly (inline)\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/code-exec \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"code\": \"async function execute(input, tools) { const result = await tools[\\\"dynamodb-get\\\"]({key: {id: input.userId}}); return {message: \\\"User data retrieved\\\", data: result}; }\",\n \"input\": {\n \"userId\": \"user123\"\n }\n }'\n\n# Execute code from S3 object\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/code-exec \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"key\": \"scripts/data-processor.js\",\n \"input\": {\n \"userId\": \"user123\",\n \"operation\": \"analyze\"\n }\n }'\n```\n\n## MCP Client Integration\n\nTo integrate with MCP clients like Claude Desktop, you can create a client that makes JSON-RPC requests to the `/mcp` endpoint. Here's an example configuration:\n\n```json\n{\n \"mcpServers\": {\n \"aws-http-mcp-server\": {\n \"command\": \"node\",\n \"args\": [\"mcp-http-client.js\"],\n \"env\": {\n \"MCP_SERVER_URL\": \"https://your-val-town-url.web.val.run\",\n \"AWS_SECRET_ACCESS_KEY\": \"${AWS_SECRET_ACCESS_KEY}\"\n }\n }\n }\n}\n```\n\n## JSON-RPC Response Format\n\n### Success Response\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"result\": {\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Response content here\"\n }\n ]\n },\n \"id\": 1\n}\n```\n\n### Error Response\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"error\": {\n \"code\": -32603,\n \"message\": \"Error message description\"\n },\n \"id\": 1\n}\n```\n\n## JSON-RPC Error Codes\n\n- `-32700`: Parse error (Invalid JSON)\n- `-32600`: Invalid Request\n- `-32601`: Method not found\n- `-32602`: Invalid params\n- `-32603`: Internal error\n- `-32001`: Authentication error (custom)\n\n## Security Considerations\n\n- **Bearer Token Authentication**: AWS_SECRET_ACCESS_KEY is passed via Authorization header, not stored in environment variables\n- **HTTPS Only**: Always use HTTPS in production to protect the bearer token\n- **IAM Permissions**: Use IAM roles with minimal required permissions\n- **Token Rotation**: Regularly rotate your AWS secret access keys\n- **Rate Limiting**: Consider implementing rate limiting for production use\n\n## Required AWS Permissions\n\n### S3 Permissions\n```json\n{\n \"Version\": \"2012-10-17\",\n \"Statement\": [\n {\n \"Effect\": \"Allow\",\n \"Action\": [\n \"s3:GetObject\",\n \"s3:PutObject\",\n \"s3:DeleteObject\",\n \"s3:ListBucket\"\n ],\n \"Resource\": [\n \"arn:aws:s3:::your-bucket-name\",\n \"arn:aws:s3:::your-bucket-name/*\"\n ]\n }\n ]\n}\n```\n\n### DynamoDB Permissions\n```json\n{\n \"Version\": \"2012-10-17\",\n \"Statement\": [\n {\n \"Effect\": \"Allow\",\n \"Action\": [\n \"dynamodb:GetItem\",\n \"dynamodb:PutItem\",\n \"dynamodb:DeleteItem\",\n \"dynamodb:Query\"\n ],\n \"Resource\": \"arn:aws:dynamodb:region:account:table/your-table-name\"\n }\n ]\n}\n```\n\n**Note**: The KV Store uses DynamoDB Query operations with a composite key structure (partition key + sort key) for efficient namespace isolation and prefix matching. Scan operations are not required.\n\n## Error Handling\n\nThe server includes comprehensive error handling for:\n- Missing or invalid Authorization headers\n- AWS service errors\n- Invalid parameters\n- Network connectivity issues\n- JSON-RPC protocol errors\n\n### JSON-RPC Errors\nAll JSON-RPC errors follow the standard format with appropriate error codes.\n\n### Legacy HTTP Errors\nLegacy endpoints return errors with HTTP status codes:\n- `401`: Authentication errors\n- `400`: Bad request (invalid parameters)\n- `404`: Resource or tool not found\n- `500`: Server errors (AWS service errors, etc.)\n\n## Legacy API Response Format (Deprecated)\n\n### Success Response\n```json\n{\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Response content here\"\n }\n ]\n}\n```\n\n### Error Response\n```json\n{\n \"error\": \"Error message description\"\n}\n```\n\n## Health Check\n\nThe server provides a health check endpoint:\n\n```bash\ncurl https://your-val-town-url.web.val.run/health\n```\n\nResponse:\n```json\n{\n \"status\": \"healthy\",\n \"timestamp\": \"2024-01-01T00:00:00.000Z\"\n}\n```\n\n## System Mode Tools\n\nWhen the bearer token matches the AWS_SECRET_ACCESS_KEY environment variable, the system enters \"system mode\" and provides additional tools for project inspection and debugging using the Val Town API:\n\n### System Tools Usage Examples\n\n```bash\n# Read a project source file using Val Town API\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"system-read-file\",\n \"arguments\": {\n \"path\": \"src/auth/auth-manager.ts\"\n }\n },\n \"id\": 1\n }'\n\n# List project files recursively using Val Town API\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"system-list-files\",\n \"arguments\": {\n \"path\": \"/src\",\n \"recursive\": true\n }\n },\n \"id\": 1\n }'\n\n# Get comprehensive project information using Val Town API\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"system-project-info\",\n \"arguments\": {}\n },\n \"id\": 1\n }'\n```\n\n### System Mode Security\n\n- System mode is only activated when the bearer token exactly matches the AWS_SECRET_ACCESS_KEY environment variable\n- System tools provide read-only access to project files and structure via Val Town API\n- No write operations are permitted through system tools\n- System mode enables debugging and administration without compromising user data isolation\n- All file access is handled through Val Town's secure API infrastructure\n- **Namespace Preservation**: System mode preserves the original user's namespace, ensuring consistent access to the user's data across regular and system operations\n```",[154],"f6481b5248f09262518b2ee79d76bb5b2bdc61c26e7da55e97f5f746baa7fe90","4269c5e4-4914-11f0-b90c-76b3cceeab13","929abcdc-45d4-11f0-a87c-76b3cceeab13",330,["D",1749901181079],37,"# Remote HTTP AWS MCP Server\n\nA remote HTTP Model Context Protocol (MCP) server that provides access to AWS services including DynamoDB and S3. This server now uses the official MCP SDK for JSON-RPC handling and exposes prompts, resources, and tools via both JSON-RPC and legacy HTTP endpoints with bearer token authentication.\n\n## Project Structure\n\nThe codebase is organized into a clean, modular structure:\n\n```\n├── index.ts # Main HTTP entry point\n├── src/\n│ ├── auth/\n│ │ └── auth-manager.ts # Authentication and namespace management\n│ ├── aws/\n│ │ └── clients.ts # AWS client configuration utilities\n│ ├── mcp/\n│ │ ├── handler.ts # Main MCP request handler\n│ │ └── protocol-handlers.ts # MCP protocol-specific handlers (prompts, resources)\n│ ├── storage/\n│ │ ├── kv-store.ts # Namespaced DynamoDB key-value store\n│ │ └── files-store.ts # Namespaced S3 files store\n│ ├── tools/\n│ │ ├── definitions.ts # Tool schema definitions\n│ │ └── handlers/\n│ │ ├── index.ts # Unified tool handlers export\n│ │ ├── kv-tools.ts # Key-value store tool handlers\n│ │ ├── files-tools.ts # Files store tool handlers\n│ │ ├── code-tools.ts # Code execution tool handlers\n│ │ └── system-tools.ts # System tools using Val Town API\n│ └── valtown/\n│ └── client.ts # Val Town API client for project file access\n└── README.md\n```\n\nThis modular structure provides:\n- **Separation of concerns**: Each component has a single responsibility\n- **Easy testing**: Individual components can be tested in isolation\n- **Maintainability**: Changes to one area don't affect others\n- **Extensibility**: New tools and handlers can be easily added\n\n## Features\n\n### JSON-RPC Endpoint (Recommended)\n- **POST /mcp**: Primary JSON-RPC endpoint using MCP SDK for all operations\n- Supports all MCP operations: prompts, resources, and tools\n- Proper JSON-RPC 2.0 protocol compliance\n- Batch request support\n\n### Legacy HTTP Endpoints (Deprecated)\n- **GET /**: Server information and capabilities\n- **GET /health**: Health check endpoint\n- **GET /mcp/prompts**: List available prompts (deprecated)\n- **POST /mcp/prompts/:name**: Get specific prompt content (deprecated)\n- **GET /mcp/resources**: List S3 resources (deprecated, requires auth)\n- **GET /mcp/resources/***: Read specific S3 resource (deprecated, requires auth)\n- **GET /mcp/tools**: List available tools (deprecated)\n- **POST /mcp/tools/:name**: Execute specific tool (deprecated, requires auth)\n\n### Authentication\n\n- Uses Bearer token authentication\n- AWS_SECRET_ACCESS_KEY is passed via `Authorization: Bearer ` header\n- Other AWS credentials are configured via environment variables\n- **User Isolation**: Each bearer token creates an isolated namespace for data storage\n - KV Store operations are automatically namespaced per user\n - Files Store operations are automatically namespaced per user\n - Resources (file listings) are automatically filtered per user namespace\n- **Demo Mode**: Requests without valid authentication use a shared \"demo\" namespace with limited capabilities\n- **System Mode**: When the bearer token matches the AWS_SECRET_ACCESS_KEY environment variable, the system enters \"system mode\" with access to:\n - All regular user tools and operations within the user's own namespace\n - Special system tools for reading project source code\n - Project structure inspection capabilities\n - Enhanced debugging and administration features\n - **Important**: System mode preserves the original user's namespace instead of switching to a separate \"system\" namespace, ensuring consistent data access across modes\n\n### Prompts\n- **analyze-data**: Analyze data from DynamoDB and S3 resources\n- **data-summary**: Generate a summary of available data sources\n\n### Resources\n- **Files**: Access and read files from your personal file store\n- Automatic MIME type detection\n- File metadata (size, last modified, version information)\n- Namespace isolation per user\n\n### Tools\n\n#### Key-Value Store Operations (Namespaced)\n- **kv-get**: Get a value by key from your personal key-value store\n- **kv-put**: Store a key-value pair in your personal key-value store\n- **kv-delete**: Delete a key-value pair from your personal key-value store\n- **kv-list**: List keys in your personal key-value store with optional prefix filter\n- **kv-query**: Query key-value pairs by key pattern from your personal key-value store\n\n#### Files Store Operations (Namespaced)\n- **files-get**: Get a file by key from your personal file store (supports versioning)\n- **files-put**: Store a file in your personal file store\n- **files-delete**: Delete a file from your personal file store (supports version-specific deletion)\n- **files-list**: List files in your personal file store with optional prefix filter\n- **files-list-versions**: List all versions of files in your personal file store\n- **files-move**: Move/rename a file within your personal file store\n- **files-copy**: Copy a file within your personal file store\n- **files-exists**: Check if a file exists in your personal file store\n- **files-metadata**: Get metadata for a file in your personal file store (supports versioning)\n\n#### Code Execution\n- **code-exec**: Execute JavaScript/TypeScript code with access to all MCP tools. Code can be provided directly as a string or referenced via files store key\n\n#### Skill Management\n- **register-skill**: Register a stored code file as a reusable skill tool with custom input schema\n- **unregister-skill**: Remove a previously registered skill\n- **list-skills**: List all registered skills for the current user\n- **[user-skills]**: Dynamically registered skills appear as individual tools with their own schemas\n\n#### System Tools (System Mode Only)\n- **system-read-file**: Read a source code file from the project using Val Town API (requires system mode access)\n- **system-list-files**: List all files in the project directory structure using Val Town API (requires system mode access)\n- **system-project-info**: Get project information and structure overview using Val Town API (requires system mode access)\n\n## Code Execution Feature\n\nThe `code-exec` tool allows you to execute JavaScript/TypeScript code with full access to all MCP tools (KV store and Files store operations). This enables powerful automation and data processing workflows.\n\n## Skill Management System\n\nThe skill management system allows you to register stored code files as reusable tools with custom input schemas. Once registered, skills appear as individual tools in the tools list and can be called like any other MCP tool.\n\n### Skill Registration\n\nUse the `register-skill` tool to register a code file as a skill:\n\n```json\n{\n \"name\": \"data-analyzer\",\n \"description\": \"Analyzes data from KV store and generates reports\",\n \"fileKey\": \"skills/data-analyzer.js\",\n \"inputSchema\": {\n \"type\": \"object\",\n \"properties\": {\n \"dataKey\": {\n \"type\": \"string\",\n \"description\": \"Key of data to analyze\"\n },\n \"reportType\": {\n \"type\": \"string\",\n \"enum\": [\"summary\", \"detailed\"],\n \"description\": \"Type of report to generate\"\n }\n },\n \"required\": [\"dataKey\"]\n }\n}\n```\n\n### Skill Management Tools\n\n- **register-skill**: Register a new skill from a files store key\n- **unregister-skill**: Remove a registered skill\n- **list-skills**: List all your registered skills\n\n### Using Registered Skills\n\nOnce registered, skills appear in the tools list and can be called directly:\n\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"data-analyzer\",\n \"arguments\": {\n \"dataKey\": \"user-data-2024\",\n \"reportType\": \"detailed\"\n }\n },\n \"id\": 1\n}\n```\n\n### Code Requirements\n\nYour code must define an `async execute` function that accepts two parameters:\n- `input`: Object containing input parameters for your script\n- `tools`: Object containing all available MCP tools as callable functions\n\n```javascript\nasync function execute(input, tools) {\n // Your code logic here\n const result = await tools[\"kv-get\"]({key: input.key});\n return { message: \"Processing complete\", data: result };\n}\n```\n\n### Available Tools in Code Context\n\nWithin your executed code, you have access to all MCP tools via the `tools` object:\n- `tools[\"kv-get\"](args)` - Get from your personal key-value store\n- `tools[\"kv-put\"](args)` - Put to your personal key-value store \n- `tools[\"kv-delete\"](args)` - Delete from your personal key-value store\n- `tools[\"kv-list\"](args)` - List keys in your personal key-value store\n- `tools[\"kv-query\"](args)` - Query your personal key-value store\n- `tools[\"files-get\"](args)` - Get file from your personal file store\n- `tools[\"files-put\"](args)` - Put file to your personal file store\n- `tools[\"files-delete\"](args)` - Delete file from your personal file store\n- `tools[\"files-list\"](args)` - List files in your personal file store\n- `tools[\"files-list-versions\"](args)` - List file versions in your personal file store\n- `tools[\"files-move\"](args)` - Move file in your personal file store\n- `tools[\"files-copy\"](args)` - Copy file in your personal file store\n- `tools[\"files-exists\"](args)` - Check if file exists in your personal file store\n- `tools[\"files-metadata\"](args)` - Get file metadata from your personal file store\n\n### Two Execution Modes\n\n#### 1. Direct Code Execution\nProvide the code directly in the request:\n\n```json\n{\n \"code\": \"async function execute(input, tools) { /* your code */ }\",\n \"input\": { \"param1\": \"value1\" }\n}\n```\n\n#### 2. Files Store Code Execution \nStore your code in your personal file store and reference it by key:\n\n```json\n{\n \"key\": \"scripts/my-processor.js\",\n \"input\": { \"param1\": \"value1\" }\n}\n```\n\nThis approach is ideal for:\n- Reusable scripts and workflows\n- Version control of automation code (files store supports versioning)\n- Sharing scripts across different executions\n- Complex multi-function scripts\n- Personal script libraries isolated per user\n\n### Security Considerations\n\n- Code execution runs in a sandboxed environment\n- No access to global objects or external network calls\n- Only MCP tools are available for external operations\n- All AWS operations use the same authentication as other MCP tools\n\n## Setup\n\n### Environment Variables\n\nSet the following environment variables on your Val Town:\n\n```bash\nAWS_REGION=us-east-1\nAWS_ACCESS_KEY_ID=your-access-key-id\nS3_BUCKET=your-bucket-name\nDYNAMODB_TABLE=your-table-name\nMCP_SERVER_NAME=aws-mcp-server\nMCP_SERVER_VERSION=1.0.0\n```\n\n**Note**: `AWS_SECRET_ACCESS_KEY` is NOT set as an environment variable. Instead, it's passed via the Authorization header for security.\n\n### DynamoDB Table Schema\n\nThe KV Store requires a DynamoDB table with the following schema:\n\n**Table Configuration:**\n- **Partition Key**: `pk` (String) - Contains the user namespace\n- **Sort Key**: `sk` (String) - Contains the user's key\n- **Billing Mode**: On-demand or Provisioned (your choice)\n- **TTL**: Optional - Set TTL attribute to `ttl` if you want automatic expiration\n\n**Example AWS CLI command to create the table:**\n```bash\naws dynamodb create-table \\\n --table-name your-table-name \\\n --attribute-definitions \\\n AttributeName=pk,AttributeType=S \\\n AttributeName=sk,AttributeType=S \\\n --key-schema \\\n AttributeName=pk,KeyType=HASH \\\n AttributeName=sk,KeyType=RANGE \\\n --billing-mode PAY_PER_REQUEST\n```\n\n**Example CloudFormation template:**\n```yaml\nDynamoDBTable:\n Type: AWS::DynamoDB::Table\n Properties:\n TableName: your-table-name\n AttributeDefinitions:\n - AttributeName: pk\n AttributeType: S\n - AttributeName: sk\n AttributeType: S\n KeySchema:\n - AttributeName: pk\n KeyType: HASH\n - AttributeName: sk\n KeyType: RANGE\n BillingMode: PAY_PER_REQUEST\n TimeToLiveSpecification:\n AttributeName: ttl\n Enabled: true\n```\n\n**Data Structure:**\nEach item in the table has the following structure:\n- `pk` (String): User namespace (e.g., \"user123\", \"demo\")\n- `sk` (String): User's key (e.g., \"settings\", \"config-app\")\n- `data` (Any): The actual value stored by the user\n- `created` (String): ISO timestamp when item was created\n- `updated` (String): ISO timestamp when item was last updated\n- `ttl` (Number, Optional): Unix timestamp for automatic expiration\n\n### Deployment\n\n1. Deploy to Val Town as an HTTP val\n2. Set the required environment variables\n3. The server will be available at your Val Town URL\n\n## Usage Examples\n\n### JSON-RPC Endpoint (Recommended)\n\nAll MCP operations should now use the JSON-RPC endpoint at `POST /mcp`. This provides proper MCP protocol compliance and better error handling.\n\n#### Authentication\n\nAll authenticated requests require the Authorization header:\n\n```bash\nAuthorization: Bearer your-aws-secret-access-key\n```\n\n#### List Prompts\n\n```bash\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"prompts/list\",\n \"params\": {},\n \"id\": 1\n }'\n```\n\n#### Get Prompt Content\n\n```bash\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"prompts/get\",\n \"params\": {\n \"name\": \"analyze-data\",\n \"arguments\": {\n \"table_key\": \"user123\",\n \"s3_key\": \"data/analytics.json\"\n }\n },\n \"id\": 1\n }'\n```\n\n#### List Resources (Files)\n\n```bash\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"resources/list\",\n \"params\": {},\n \"id\": 1\n }'\n```\n\n#### Read Files Resource\n\n```bash\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"resources/read\",\n \"params\": {\n \"uri\": \"files://path/to/file.txt\"\n },\n \"id\": 1\n }'\n```\n\n#### List Tools\n\n```bash\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/list\",\n \"params\": {},\n \"id\": 1\n }'\n```\n\n#### Execute Files Operations\n\n```bash\n# Store a file in your personal file store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-put\",\n \"arguments\": {\n \"key\": \"documents/my-file.txt\",\n \"content\": \"Hello, World!\",\n \"contentType\": \"text/plain\"\n }\n },\n \"id\": 1\n }'\n\n# Get a file from your personal file store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-get\",\n \"arguments\": {\n \"key\": \"documents/my-file.txt\"\n }\n },\n \"id\": 1\n }'\n\n# List files in your personal file store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-list\",\n \"arguments\": {\n \"prefix\": \"documents/\"\n }\n },\n \"id\": 1\n }'\n\n# List all versions of a file\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-list-versions\",\n \"arguments\": {\n \"key\": \"documents/my-file.txt\"\n }\n },\n \"id\": 1\n }'\n\n# Get a specific version of a file\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-get\",\n \"arguments\": {\n \"key\": \"documents/my-file.txt\",\n \"versionId\": \"specific-version-id\"\n }\n },\n \"id\": 1\n }'\n\n# Copy a file within your personal file store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-copy\",\n \"arguments\": {\n \"sourceKey\": \"documents/my-file.txt\",\n \"destinationKey\": \"backup/my-file-backup.txt\"\n }\n },\n \"id\": 1\n }'\n\n# Check if a file exists\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-exists\",\n \"arguments\": {\n \"key\": \"documents/my-file.txt\"\n }\n },\n \"id\": 1\n }'\n\n# Get file metadata\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-metadata\",\n \"arguments\": {\n \"key\": \"documents/my-file.txt\"\n }\n },\n \"id\": 1\n }'\n\n# Delete a file\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"files-delete\",\n \"arguments\": {\n \"key\": \"documents/my-file.txt\"\n }\n },\n \"id\": 1\n }'\n```\n\n#### Execute KV Store Operations\n\n```bash\n# Store a key-value pair in your personal store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"kv-put\",\n \"arguments\": {\n \"key\": \"user-settings\",\n \"value\": {\"theme\": \"dark\", \"language\": \"en\"},\n \"ttl\": 3600\n }\n },\n \"id\": 1\n }'\n\n# Get a value from your personal store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"kv-get\",\n \"arguments\": {\n \"key\": \"user-settings\"\n }\n },\n \"id\": 1\n }'\n\n# List keys in your personal store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"kv-list\",\n \"arguments\": {\n \"prefix\": \"user-\"\n }\n },\n \"id\": 1\n }'\n\n# Query key-value pairs by pattern\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"kv-query\",\n \"arguments\": {\n \"keyPattern\": \"config*\"\n }\n },\n \"id\": 1\n }'\n```\n\n#### Execute Skill Management Operations\n\n```bash\n# Register a skill\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"register-skill\",\n \"arguments\": {\n \"name\": \"data-analyzer\",\n \"description\": \"Analyzes data from KV store and generates reports\",\n \"fileKey\": \"skills/data-analyzer.js\",\n \"inputSchema\": {\n \"type\": \"object\",\n \"properties\": {\n \"dataKey\": {\n \"type\": \"string\",\n \"description\": \"Key of data to analyze\"\n },\n \"reportType\": {\n \"type\": \"string\",\n \"enum\": [\"summary\", \"detailed\"],\n \"description\": \"Type of report to generate\"\n }\n },\n \"required\": [\"dataKey\"]\n }\n }\n },\n \"id\": 1\n }'\n\n# List registered skills\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"list-skills\",\n \"arguments\": {}\n },\n \"id\": 1\n }'\n\n# Execute a registered skill\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"data-analyzer\",\n \"arguments\": {\n \"dataKey\": \"user-data-2024\",\n \"reportType\": \"detailed\"\n }\n },\n \"id\": 1\n }'\n\n# Unregister a skill\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"unregister-skill\",\n \"arguments\": {\n \"name\": \"data-analyzer\"\n }\n },\n \"id\": 1\n }'\n```\n\n```bash\n# Execute code directly (inline)\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"code-exec\",\n \"arguments\": {\n \"code\": \"async function execute(input, tools) { const result = await tools[\\\"kv-get\\\"]({key: input.key}); return {message: \\\"Data retrieved\\\", data: result}; }\",\n \"input\": {\n \"key\": \"user-settings\"\n }\n }\n },\n \"id\": 1\n }'\n\n# Execute code from files store\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"code-exec\",\n \"arguments\": {\n \"key\": \"scripts/data-processor.js\",\n \"input\": {\n \"operation\": \"analyze\"\n }\n }\n },\n \"id\": 1\n }'\n```\n\n#### Batch Requests\n\nYou can send multiple JSON-RPC requests in a single HTTP request:\n\n```bash\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '[\n {\n \"jsonrpc\": \"2.0\",\n \"method\": \"prompts/list\",\n \"params\": {},\n \"id\": 1\n },\n {\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/list\",\n \"params\": {},\n \"id\": 2\n },\n {\n \"jsonrpc\": \"2.0\",\n \"method\": \"resources/list\",\n \"params\": {},\n \"id\": 3\n }\n ]'\n```\n\n### Legacy HTTP Endpoints (Deprecated)\n\nThe following endpoints are maintained for backward compatibility but are deprecated. Use the JSON-RPC endpoint instead.\n\n### Server Information\n\n```bash\ncurl https://your-val-town-url.web.val.run/\n```\n\n### List Prompts\n\n```bash\ncurl https://your-val-town-url.web.val.run/mcp/prompts\n```\n\n### Get Prompt Content\n\n```bash\ncurl -X POST https://your-val-town-url.web.val.run/mcp/prompts/analyze-data \\\n -H \"Content-Type: application/json\" \\\n -d '{\"table_key\": \"user123\", \"s3_key\": \"data/analytics.json\"}'\n```\n\n### List Resources (S3 Objects)\n\n```bash\ncurl https://your-val-town-url.web.val.run/mcp/resources \\\n -H \"Authorization: Bearer your-aws-secret-access-key\"\n```\n\n### Read S3 Resource\n\n```bash\ncurl \"https://your-val-town-url.web.val.run/mcp/resources/s3://your-bucket/path/to/file.txt\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\"\n```\n\n### List Tools\n\n```bash\ncurl https://your-val-town-url.web.val.run/mcp/tools\n```\n\n### Execute DynamoDB Operations\n\n```bash\n# Get an item\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/dynamodb-get \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"key\": {\"id\": \"user123\"}}'\n\n# Put an item\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/dynamodb-put \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"item\": {\"id\": \"user123\", \"name\": \"John Doe\", \"email\": \"john@example.com\"}}'\n\n# Query items\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/dynamodb-query \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"keyConditionExpression\": \"id = :id\", \"expressionAttributeValues\": {\":id\": \"user123\"}}'\n\n# Delete an item\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/dynamodb-delete \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"key\": {\"id\": \"user123\"}}'\n```\n\n### Execute S3 Operations\n\n```bash\n# Get object content\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/s3-get \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"key\": \"documents/report.txt\"}'\n\n# Upload content\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/s3-put \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"key\": \"documents/new-file.txt\", \"content\": \"Hello, World!\", \"contentType\": \"text/plain\"}'\n\n# Move/rename object\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/s3-move \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"sourceKey\": \"old-location/file.txt\", \"destinationKey\": \"new-location/file.txt\"}'\n\n# Delete object\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/s3-delete \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"key\": \"documents/old-file.txt\"}'\n```\n\n### Execute Code\n\n```bash\n# Execute code directly (inline)\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/code-exec \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"code\": \"async function execute(input, tools) { const result = await tools[\\\"dynamodb-get\\\"]({key: {id: input.userId}}); return {message: \\\"User data retrieved\\\", data: result}; }\",\n \"input\": {\n \"userId\": \"user123\"\n }\n }'\n\n# Execute code from S3 object\ncurl -X POST https://your-val-town-url.web.val.run/mcp/tools/code-exec \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"key\": \"scripts/data-processor.js\",\n \"input\": {\n \"userId\": \"user123\",\n \"operation\": \"analyze\"\n }\n }'\n```\n\n## MCP Client Integration\n\nTo integrate with MCP clients like Claude Desktop, you can create a client that makes JSON-RPC requests to the `/mcp` endpoint. Here's an example configuration:\n\n```json\n{\n \"mcpServers\": {\n \"aws-http-mcp-server\": {\n \"command\": \"node\",\n \"args\": [\"mcp-http-client.js\"],\n \"env\": {\n \"MCP_SERVER_URL\": \"https://your-val-town-url.web.val.run\",\n \"AWS_SECRET_ACCESS_KEY\": \"${AWS_SECRET_ACCESS_KEY}\"\n }\n }\n }\n}\n```\n\n## JSON-RPC Response Format\n\n### Success Response\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"result\": {\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Response content here\"\n }\n ]\n },\n \"id\": 1\n}\n```\n\n### Error Response\n```json\n{\n \"jsonrpc\": \"2.0\",\n \"error\": {\n \"code\": -32603,\n \"message\": \"Error message description\"\n },\n \"id\": 1\n}\n```\n\n## JSON-RPC Error Codes\n\n- `-32700`: Parse error (Invalid JSON)\n- `-32600`: Invalid Request\n- `-32601`: Method not found\n- `-32602`: Invalid params\n- `-32603`: Internal error\n- `-32001`: Authentication error (custom)\n\n## Security Considerations\n\n- **Bearer Token Authentication**: AWS_SECRET_ACCESS_KEY is passed via Authorization header, not stored in environment variables\n- **HTTPS Only**: Always use HTTPS in production to protect the bearer token\n- **IAM Permissions**: Use IAM roles with minimal required permissions\n- **Token Rotation**: Regularly rotate your AWS secret access keys\n- **Rate Limiting**: Consider implementing rate limiting for production use\n\n## Required AWS Permissions\n\n### S3 Permissions\n```json\n{\n \"Version\": \"2012-10-17\",\n \"Statement\": [\n {\n \"Effect\": \"Allow\",\n \"Action\": [\n \"s3:GetObject\",\n \"s3:PutObject\",\n \"s3:DeleteObject\",\n \"s3:ListBucket\"\n ],\n \"Resource\": [\n \"arn:aws:s3:::your-bucket-name\",\n \"arn:aws:s3:::your-bucket-name/*\"\n ]\n }\n ]\n}\n```\n\n### DynamoDB Permissions\n```json\n{\n \"Version\": \"2012-10-17\",\n \"Statement\": [\n {\n \"Effect\": \"Allow\",\n \"Action\": [\n \"dynamodb:GetItem\",\n \"dynamodb:PutItem\",\n \"dynamodb:DeleteItem\",\n \"dynamodb:Query\"\n ],\n \"Resource\": \"arn:aws:dynamodb:region:account:table/your-table-name\"\n }\n ]\n}\n```\n\n**Note**: The KV Store uses DynamoDB Query operations with a composite key structure (partition key + sort key) for efficient namespace isolation and prefix matching. Scan operations are not required.\n\n## Error Handling\n\nThe server includes comprehensive error handling for:\n- Missing or invalid Authorization headers\n- AWS service errors\n- Invalid parameters\n- Network connectivity issues\n- JSON-RPC protocol errors\n\n### JSON-RPC Errors\nAll JSON-RPC errors follow the standard format with appropriate error codes.\n\n### Legacy HTTP Errors\nLegacy endpoints return errors with HTTP status codes:\n- `401`: Authentication errors\n- `400`: Bad request (invalid parameters)\n- `404`: Resource or tool not found\n- `500`: Server errors (AWS service errors, etc.)\n\n## Legacy API Response Format (Deprecated)\n\n### Success Response\n```json\n{\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"Response content here\"\n }\n ]\n}\n```\n\n### Error Response\n```json\n{\n \"error\": \"Error message description\"\n}\n```\n\n## Health Check\n\nThe server provides a health check endpoint:\n\n```bash\ncurl https://your-val-town-url.web.val.run/health\n```\n\nResponse:\n```json\n{\n \"status\": \"healthy\",\n \"timestamp\": \"2024-01-01T00:00:00.000Z\"\n}\n```\n\n## System Mode Tools\n\nWhen the bearer token matches the AWS_SECRET_ACCESS_KEY environment variable, the system enters \"system mode\" and provides additional tools for project inspection and debugging using the Val Town API:\n\n### System Tools Usage Examples\n\n```bash\n# Read a project source file using Val Town API\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"system-read-file\",\n \"arguments\": {\n \"path\": \"src/auth/auth-manager.ts\"\n }\n },\n \"id\": 1\n }'\n\n# List project files recursively using Val Town API\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"system-list-files\",\n \"arguments\": {\n \"path\": \"/src\",\n \"recursive\": true\n }\n },\n \"id\": 1\n }'\n\n# Get comprehensive project information using Val Town API\ncurl -X POST https://your-val-town-url.web.val.run/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer your-aws-secret-access-key\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"system-project-info\",\n \"arguments\": {}\n },\n \"id\": 1\n }'\n```\n\n### System Mode Security\n\n- System mode is only activated when the bearer token exactly matches the AWS_SECRET_ACCESS_KEY environment variable\n- System tools provide read-only access to project files and structure via Val Town API\n- No write operations are permitted through system tools\n- System mode enables debugging and administration without compromising user data isolation\n- All file access is handled through Val Town's secure API infrastructure\n- **Namespace Preservation**: System mode preserves the original user's namespace, ensuring consistent access to the user's data across regular and system operations\n```",[154],"d1950bae4b6e6a917224e2fe8b35ada5eea41fe882ca45ec3e16a6403e1efd3f",{"_72":174,"_74":-7,"_76":175},"src/tools/handlers/openai-tools.ts",{"_32":176,"_13":177,"_80":178,"_82":83,"_84":57,"_85":179,"_87":26,"_34":180,"_41":89,"_90":91,"_92":181,"_64":49,"_94":-5,"_95":-7,"_72":182,"_97":183},"066c61cc-4d57-11f0-aa9a-76b3cceeab13","openai-tools.ts","ff4fce7a-4d55-11f0-a790-76b3cceeab13",14,["D",1750369661344],"/**\n * OpenAI API tool handlers using Val Town's OpenAI integration\n */\n\nimport { OpenAI } from \"https://esm.town/v/std/openai\";\nimport { AuthContext } from \"../../storage/kv-store.ts\";\n\n// OpenAI API types\ninterface ChatMessage {\n role: \"system\" | \"user\" | \"assistant\";\n content: string;\n}\n\ninterface ChatCompletionRequest {\n messages: ChatMessage[];\n model?: string;\n max_tokens?: number;\n temperature?: number;\n top_p?: number;\n frequency_penalty?: number;\n presence_penalty?: number;\n}\n\nexport class OpenAIToolHandlers {\n private openai: OpenAI;\n\n constructor() {\n this.openai = new OpenAI();\n }\n\n async handleChatCompletion(args: ChatCompletionRequest, authContext: AuthContext) {\n try {\n const completion = await this.openai.chat.completions.create({\n messages: args.messages,\n model: args.model || \"gpt-4o-mini\",\n ...(args.max_tokens && { max_tokens: args.max_tokens }),\n ...(args.temperature !== undefined && { temperature: args.temperature }),\n ...(args.top_p !== undefined && { top_p: args.top_p }),\n ...(args.frequency_penalty !== undefined && { frequency_penalty: args.frequency_penalty }),\n ...(args.presence_penalty !== undefined && { presence_penalty: args.presence_penalty })\n });\n\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify(completion, null, 2)\n }\n ]\n };\n } catch (error) {\n throw new Error(`OpenAI API error: ${error.message}`);\n }\n }\n}",[99,100,101,177],"7d91456603f09484c94fe70da0089109529cb6d6f670fdf3a6c1d686b9ea29a3",["D",1749490372788],"legacyEnvVars","httpPrivacy","description","imageUrl","userId","21f2e37e-8066-4730-9dc7-d27cf8d3c9f3","pinnedFileId","6e010d7c-45d4-11f0-a0c9-76b3cceeab13","pinPreview","pinMigrated","screenshotVersion","likeCount","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_11":12,"_221":217},"org",{"_11":12,"_215":-5,"_216":217,"_189":190,"_218":219,"_220":49},"branch","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yb2RJNlc1czZ1NlpZRmoxdGJ2eFVNNVhmeTYifQ","tier","pro","canRestrictVals","profileImageUrl","","adoptOrgId",{"_32":40,"_13":14,"_34":427,"_47":-5,"_185":49,"_50":51,"_186":51,"_187":-5,"_188":-5,"_189":190,"_191":192,"_193":26,"_194":26,"_195":-5,"_196":20,"_53":54,"_197":-5,"_198":-5,"_199":-5,"_200":-5,"_201":202,"_203":202,"_204":205,"_206":205,"_207":205,"_208":202,"_209":202,"_210":428,"_212":429,"_214":430,"_48":49},"tree",[273,296,297],"files",[273,274,275,276,277,278,279,280,281,282,283,284,285,286,287,288,289,290,291,292,293,294,295,296,297],"counts",{"_262":20,"_263":264,"_265":20,"_266":267,"_268":269},"contents",[246,247,248],"upstreamProject","upstreamBranch",{"_32":33,"_34":244,"_36":245,"_13":38,"_39":40,"_41":42,"_43":-5,"_44":-5,"_45":46,"_47":-5,"_48":49,"_50":51,"_52":12,"_53":54,"_55":14},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1749490372788],["D",1752273140378],{"_32":257,"_13":99,"_80":258,"_82":-5,"_84":57,"_85":89,"_87":26,"_34":259,"_41":20,"_90":260,"_92":-5,"_64":49,"_94":-5,"_72":261},{"_32":157,"_13":154,"_80":158,"_82":-5,"_84":57,"_85":56,"_87":26,"_34":255,"_41":160,"_90":161,"_92":162,"_64":49,"_94":-5,"_72":256},{"_32":249,"_13":79,"_80":250,"_82":-5,"_84":57,"_85":89,"_87":26,"_34":251,"_41":20,"_90":252,"_92":253,"_64":49,"_94":-5,"_72":254},"369ef1f4-4d55-11f0-a716-76b3cceeab13","935ebf7c-f329-44cc-9dbe-499f2a3c84fa",["D",1750368883229],"http","/**\n * Remote HTTP Model Context Protocol (MCP) Server\n * Uses streamable HTTP transport with raw Web API\n * Exposes prompts, S3 resources, and tools for DynamoDB/S3 operations\n */\n\nimport { AuthManager, ExtendedAuthContext } from \"./src/auth/auth-manager.ts\";\nimport { MCPHandler } from \"./src/mcp/handler.ts\";\n\n// Environment variables\nconst MCP_SERVER_NAME = Deno.env.get(\"MCP_SERVER_NAME\") || \"aws-mcp-server\";\nconst MCP_SERVER_VERSION = Deno.env.get(\"MCP_SERVER_VERSION\") || \"1.0.0\";\n\nconst mcpHandler = new MCPHandler();\nconst authManager = new AuthManager();\n\n// Authentication function for MCP requests\nfunction authenticateRequest(request: Request): string | null {\n const authHeader = request.headers.get(\"Authorization\");\n\n if (!authHeader || !authHeader.startsWith(\"Bearer \")) {\n return null;\n }\n\n const awsSecretAccessKey = authHeader.substring(7); // Remove \"Bearer \" prefix\n\n if (!awsSecretAccessKey) {\n return null;\n }\n\n return awsSecretAccessKey;\n}\n\n// Create JSON-RPC error response\nfunction createErrorResponse(id: any, code: number, message: string): Response {\n return new Response(\n JSON.stringify({\n jsonrpc: \"2.0\",\n id,\n error: {\n code,\n message,\n },\n }),\n {\n status: code === -32001 ? 401 : 400,\n headers: {\n \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Methods\": \"GET, POST, OPTIONS\",\n \"Access-Control-Allow-Headers\": \"Content-Type, Authorization\",\n },\n },\n );\n}\n\n// Main request handler using raw Web API\nexport default async function handler(request: Request): Promise {\n const url = new URL(request.url);\n const pathname = url.pathname;\n\n // Handle CORS preflight requests\n if (request.method === \"OPTIONS\") {\n return new Response(null, {\n status: 200,\n headers: {\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Methods\": \"GET, POST, OPTIONS\",\n \"Access-Control-Allow-Headers\": \"Content-Type, Authorization\",\n },\n });\n }\n\n // Only handle POST requests to /mcp\n if (pathname !== \"/mcp\" || request.method !== \"POST\") {\n console.error(`[Server] Invalid request: ${request.method} ${pathname}`);\n return new Response(\n JSON.stringify(\n {\n error: \"Only POST requests to /mcp are supported\",\n note: \"This server only supports the MCP JSON-RPC endpoint at POST /mcp\",\n },\n null,\n 2,\n ),\n {\n status: 404,\n headers: {\n \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n },\n },\n );\n }\n\n try {\n // Parse request body\n const body = await request.json();\n\n // Resolve authentication context\n const authContext: ExtendedAuthContext = authManager.resolveAuthContext(request);\n\n // Check if this is an initialize request or prompts request (doesn't require auth)\n const isInitializeRequest = body?.method === \"initialize\";\n const isNotification = body?.method?.startsWith(\"notifications/\");\n const isPromptsRequest = body?.method?.startsWith(\"prompts/\");\n const isToolsListRequest = body?.method === \"tools/list\";\n const requiresAuth = !isInitializeRequest && !isPromptsRequest && !isToolsListRequest;\n\n if (isNotification) {\n console.warn(`[Server] Notification request: ${request.method} ${pathname}`);\n return new Response(null, {\n status: 202,\n headers: {\n // \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Methods\": \"GET, POST, OPTIONS\",\n \"Access-Control-Allow-Headers\": \"Content-Type, Authorization\",\n },\n });\n }\n\n // Authenticate request (skip for initialize and prompts)\n if (requiresAuth) {\n const awsSecretAccessKey = authManager.extractAWSCredentials(request);\n if (!awsSecretAccessKey) {\n return createErrorResponse(\n body?.id || null,\n -32001,\n \"Missing or invalid Authorization header. Expected: Bearer \",\n );\n }\n // Set credentials in MCP handler\n // mcpHandler.setCredentials(awsSecretAccessKey);\n }\n\n // Connect and handle the request using streamable HTTP transport\n const response = await mcpHandler.handleStreamableRequest(request, body, authContext);\n\n return new Response(JSON.stringify(response), {\n status: 200,\n headers: {\n \"Content-Type\": \"application/json\",\n \"Access-Control-Allow-Origin\": \"*\",\n \"Access-Control-Allow-Methods\": \"GET, POST, OPTIONS\",\n \"Access-Control-Allow-Headers\": \"Content-Type, Authorization\",\n },\n });\n } catch (error) {\n console.error(`[Server] Error:`, error);\n\n // Try to get request ID from body if possible\n let requestId = null;\n try {\n const body = await request.clone().json();\n requestId = body?.id || null;\n } catch {\n // Ignore parsing errors for error response\n }\n\n return createErrorResponse(\n requestId,\n -32700,\n \"Parse error: Invalid JSON-RPC request\",\n );\n }\n}",[79],["D",1750369836177],[154],"369edbce-4d55-11f0-a716-76b3cceeab13","b55c0d81-d886-4ed2-8f25-79706a38e790",["D",1750368883229],"directory",[99],"pulls","branches",2,"forks","envVars",{"_270":160,"_272":20},"connections",{"_270":20,"_271":20},"count","unfilledCount","emptyCount",{"_32":257,"_13":99,"_80":258,"_82":-5,"_84":57,"_85":89,"_87":26,"_34":424,"_41":20,"_90":260,"_92":-5,"_64":49,"_94":-5,"_95":425,"_72":426},{"_32":420,"_13":419,"_80":414,"_82":258,"_84":57,"_85":89,"_87":26,"_34":421,"_41":20,"_90":260,"_92":-5,"_64":49,"_94":-5,"_95":422,"_72":423},{"_32":411,"_13":412,"_80":413,"_82":414,"_84":57,"_85":89,"_87":26,"_34":415,"_41":20,"_90":91,"_92":416,"_64":49,"_94":-5,"_95":417,"_72":418},{"_32":407,"_13":406,"_80":401,"_82":258,"_84":57,"_85":89,"_87":26,"_34":408,"_41":20,"_90":260,"_92":-5,"_64":49,"_94":-5,"_95":409,"_72":410},{"_32":398,"_13":399,"_80":400,"_82":401,"_84":57,"_85":89,"_87":26,"_34":402,"_41":20,"_90":91,"_92":403,"_64":49,"_94":-5,"_95":404,"_72":405},{"_32":394,"_13":144,"_80":137,"_82":258,"_84":57,"_85":89,"_87":26,"_34":395,"_41":20,"_90":260,"_92":-5,"_64":49,"_94":-5,"_95":396,"_72":397},{"_32":134,"_13":135,"_80":136,"_82":137,"_84":57,"_85":138,"_87":26,"_34":139,"_41":140,"_90":91,"_92":141,"_64":49,"_94":-5,"_95":392,"_72":393},{"_32":385,"_13":386,"_80":387,"_82":137,"_84":57,"_85":89,"_87":26,"_34":388,"_41":20,"_90":91,"_92":389,"_64":49,"_94":-5,"_95":390,"_72":391},{"_32":381,"_13":366,"_80":361,"_82":258,"_84":57,"_85":89,"_87":26,"_34":382,"_41":20,"_90":260,"_92":-5,"_64":49,"_94":-5,"_95":383,"_72":384},{"_32":374,"_13":375,"_80":376,"_82":361,"_84":57,"_85":89,"_87":26,"_34":377,"_41":20,"_90":91,"_92":378,"_64":49,"_94":-5,"_95":379,"_72":380},{"_32":367,"_13":368,"_80":369,"_82":361,"_84":57,"_85":89,"_87":26,"_34":370,"_41":20,"_90":91,"_92":371,"_64":49,"_94":-5,"_95":372,"_72":373},{"_32":358,"_13":359,"_80":360,"_82":361,"_84":57,"_85":89,"_87":26,"_34":362,"_41":20,"_90":91,"_92":363,"_64":49,"_94":-5,"_95":364,"_72":365},{"_32":354,"_13":100,"_80":116,"_82":258,"_84":57,"_85":89,"_87":26,"_34":355,"_41":20,"_90":260,"_92":-5,"_64":49,"_94":-5,"_95":356,"_72":357},{"_32":350,"_13":101,"_80":83,"_82":116,"_84":57,"_85":89,"_87":26,"_34":351,"_41":20,"_90":260,"_92":-5,"_64":49,"_94":-5,"_95":352,"_72":353},{"_32":343,"_13":344,"_80":345,"_82":83,"_84":57,"_85":89,"_87":26,"_34":346,"_41":20,"_90":91,"_92":347,"_64":49,"_94":-5,"_95":348,"_72":349},{"_32":336,"_13":337,"_80":338,"_82":83,"_84":57,"_85":89,"_87":26,"_34":339,"_41":20,"_90":91,"_92":340,"_64":49,"_94":-5,"_95":341,"_72":342},{"_32":78,"_13":79,"_80":81,"_82":83,"_84":57,"_85":86,"_87":26,"_34":88,"_41":89,"_90":91,"_92":93,"_64":49,"_94":-5,"_95":334,"_72":335},{"_32":327,"_13":328,"_80":329,"_82":83,"_84":57,"_85":89,"_87":26,"_34":330,"_41":20,"_90":91,"_92":331,"_64":49,"_94":-5,"_95":332,"_72":333},{"_32":176,"_13":177,"_80":178,"_82":83,"_84":57,"_85":179,"_87":26,"_34":180,"_41":89,"_90":91,"_92":181,"_64":49,"_94":-5,"_95":325,"_72":326},{"_32":318,"_13":319,"_80":320,"_82":83,"_84":57,"_85":89,"_87":26,"_34":321,"_41":20,"_90":91,"_92":322,"_64":49,"_94":-5,"_95":323,"_72":324},{"_32":113,"_13":114,"_80":115,"_82":116,"_84":57,"_85":117,"_87":26,"_34":118,"_41":119,"_90":91,"_92":120,"_64":49,"_94":-5,"_95":316,"_72":317},{"_32":312,"_13":311,"_80":306,"_82":258,"_84":57,"_85":89,"_87":26,"_34":313,"_41":20,"_90":260,"_92":-5,"_64":49,"_94":-5,"_95":314,"_72":315},{"_32":303,"_13":304,"_80":305,"_82":306,"_84":57,"_85":89,"_87":26,"_34":307,"_41":20,"_90":91,"_92":308,"_64":49,"_94":-5,"_95":309,"_72":310},{"_32":157,"_13":154,"_80":158,"_82":-5,"_84":57,"_85":56,"_87":26,"_34":159,"_41":160,"_90":161,"_92":162,"_64":49,"_94":-5,"_95":301,"_72":302},{"_32":249,"_13":79,"_80":250,"_82":-5,"_84":57,"_85":89,"_87":26,"_34":298,"_41":20,"_90":252,"_92":253,"_64":49,"_94":-5,"_95":299,"_72":300},["D",1750368883229],[],[79],[],[154],"369ed2e6-4d55-11f0-a716-76b3cceeab13","client.ts","63397103-7d36-4fa5-8aae-bcb457ebb96a","badc066c-0c29-4265-a06e-7b63f07e6d55",["D",1750368883229],"/**\n * Val Town API Client\n * Provides access to Val Town's API for reading project files and structure\n */\n\nexport interface ValTownFile {\n name: string;\n type: 'file' | 'directory';\n path: string;\n content?: string;\n size?: number;\n lastModified?: string;\n}\n\nexport interface ValTownProjectInfo {\n name: string;\n description?: string;\n files: ValTownFile[];\n environment?: Record;\n}\n\nexport class ValTownClient {\n private baseUrl: string;\n private apiToken?: string;\n\n constructor(apiToken?: string) {\n this.baseUrl = 'https://api.val.town';\n this.apiToken = apiToken;\n }\n\n /**\n * Get project information including file structure\n */\n async getProjectInfo(): Promise {\n try {\n // For now, we'll use the import.meta.url to determine the project structure\n // This is a placeholder implementation that would need to be replaced with actual Val Town API calls\n const projectUrl = import.meta.url;\n const projectName = this.extractProjectName(projectUrl);\n \n // Get file list using the listFiles utility\n const files = await this.listProjectFiles();\n \n return {\n name: projectName,\n description: 'Val Town MCP Server Project',\n files,\n environment: this.getEnvironmentInfo()\n };\n } catch (error) {\n throw new Error(`Failed to get project info: ${error.message}`);\n }\n }\n\n /**\n * Read a specific file from the project\n */\n async readFile(path: string): Promise {\n try {\n // Import the readFile utility from Val Town's standard library\n const { readFile } = await import(\"https://esm.town/v/std/utils@85-main/index.ts\");\n \n // Normalize path - ensure it starts with /\n const normalizedPath = path.startsWith('/') ? path : `/${path}`;\n \n const content = await readFile(normalizedPath, import.meta.url);\n return content;\n } catch (error) {\n if (error.message?.includes('not found') || error.message?.includes('ENOENT')) {\n throw new Error(`File not found: ${path}`);\n }\n throw new Error(`Failed to read file ${path}: ${error.message}`);\n }\n }\n\n /**\n * List all files in the project\n */\n async listProjectFiles(path: string = '/', recursive: boolean = false): Promise {\n try {\n // Import the listFiles utility from Val Town's standard library\n const { listFiles } = await import(\"https://esm.town/v/std/utils@85-main/index.ts\");\n \n const fileList = await listFiles(import.meta.url);\n \n // Convert the file list to our format\n const files: ValTownFile[] = [];\n \n for (const item of fileList) {\n // Handle the Val Town file object structure\n if (item && typeof item === 'object' && item.path) {\n const pathStr = item.path;\n const isDirectory = item.type === 'directory';\n const name = item.name || pathStr.split('/').pop() || pathStr;\n \n files.push({\n name,\n type: isDirectory ? 'directory' : 'file',\n path: pathStr.startsWith('/') ? pathStr : `/${pathStr}`\n });\n }\n }\n\n // Filter by path if specified\n if (path !== '/') {\n const normalizedPath = path.startsWith('/') ? path.substring(1) : path;\n const filtered = files.filter(file => {\n const filePath = file.path.startsWith('/') ? file.path.substring(1) : file.path;\n return filePath.startsWith(normalizedPath) && filePath !== normalizedPath;\n });\n return filtered;\n }\n\n // Apply recursive filtering if needed\n if (!recursive && path === '/') {\n // Only return top-level files and directories\n return files.filter(file => {\n const pathParts = file.path.substring(1).split('/').filter(part => part.length > 0);\n return pathParts.length === 1;\n });\n }\n\n return files;\n } catch (error) {\n throw new Error(`Failed to list files: ${error.message}`);\n }\n }\n\n /**\n * Check if a file exists in the project\n */\n async fileExists(path: string): Promise {\n try {\n await this.readFile(path);\n return true;\n } catch (error) {\n if (error.message?.includes('File not found')) {\n return false;\n }\n throw error;\n }\n }\n\n /**\n * Get file metadata\n */\n async getFileMetadata(path: string): Promise> {\n try {\n const content = await this.readFile(path);\n const name = path.split('/').pop() || path;\n \n return {\n name,\n type: 'file',\n path: path.startsWith('/') ? path : `/${path}`,\n size: content.length,\n lastModified: new Date().toISOString() // Val Town doesn't provide this, so use current time\n };\n } catch (error) {\n throw new Error(`Failed to get file metadata for ${path}: ${error.message}`);\n }\n }\n\n /**\n * Extract project name from import.meta.url\n */\n private extractProjectName(url: string): string {\n try {\n // Extract project name from Val Town URL pattern\n const match = url.match(/https:\\/\\/([^.]+)\\.web\\.val\\.run/);\n if (match) {\n return match[1];\n }\n \n // Fallback to generic name\n return 'val-town-project';\n } catch {\n return 'val-town-project';\n }\n }\n\n /**\n * Get environment information (non-sensitive)\n */\n private getEnvironmentInfo(): Record {\n const envVars = [\n 'AWS_REGION',\n 'S3_BUCKET',\n 'DYNAMODB_TABLE',\n 'MCP_SERVER_NAME',\n 'MCP_SERVER_VERSION'\n ];\n \n const env: Record = {};\n \n for (const key of envVars) {\n const value = Deno.env.get(key);\n env[key] = value || 'not set';\n }\n \n // Add sensitive keys as redacted\n const sensitiveKeys = ['AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY'];\n for (const key of sensitiveKeys) {\n const value = Deno.env.get(key);\n env[key] = value ? '[REDACTED]' : 'not set';\n }\n \n return env;\n }\n}",[],[99,311,304],"valtown","369ed82c-4d55-11f0-a716-76b3cceeab13",["D",1750368883229],[295],[99,311],[],[99,100,114],"369ec27e-4d55-11f0-a716-76b3cceeab13","system-tools.ts","c86f31ac-bb0d-4ce6-8afd-7afc20ef9464",["D",1750368883229],"/**\n * System Tools Handlers\n * Provides access to project source code and structure via Val Town API (system mode only)\n */\n\nimport { ExtendedAuthContext } from \"../../auth/auth-manager.ts\";\nimport { ValTownClient } from \"../../valtown/client.ts\";\n\nexport class SystemToolHandlers {\n private valTownClient: ValTownClient;\n\n constructor() {\n this.valTownClient = new ValTownClient();\n }\n\n /**\n * Read a source code file from the project using Val Town API\n */\n async handleSystemReadFile(args: any, authContext: ExtendedAuthContext) {\n if (!authContext.isSystemMode) {\n throw new Error(\"System tools are only available in system mode\");\n }\n\n const { path } = args;\n \n if (!path) {\n throw new Error(\"Path parameter is required\");\n }\n\n try {\n const fileContent = await this.valTownClient.readFile(path);\n \n return {\n content: [{\n type: \"text\",\n text: `File: ${path}\\n\\n${fileContent}`\n }]\n };\n } catch (error) {\n if (error.message?.includes('File not found')) {\n return {\n content: [{\n type: \"text\",\n text: `Error: File not found: ${path}`\n }]\n };\n }\n throw error;\n }\n }\n\n /**\n * List files in the project directory using Val Town API\n */\n async handleSystemListFiles(args: any, authContext: ExtendedAuthContext) {\n if (!authContext.isSystemMode) {\n throw new Error(\"System tools are only available in system mode\");\n }\n\n const { path = \"/\", recursive = false } = args;\n \n try {\n const files = await this.valTownClient.listProjectFiles(path, recursive);\n \n const formattedFiles = files.map(file => {\n const icon = file.type === 'directory' ? '📁' : '📄';\n const suffix = file.type === 'directory' ? '/' : '';\n return `${icon} ${file.path}${suffix}`;\n });\n \n formattedFiles.sort();\n \n return {\n content: [{\n type: \"text\",\n text: `Files in ${path}:\\n\\n${formattedFiles.join('\\n')}`\n }]\n };\n } catch (error) {\n return {\n content: [{\n type: \"text\",\n text: `Error: Failed to list files in ${path}: ${error.message}`\n }]\n };\n }\n }\n\n /**\n * Get project information and structure overview using Val Town API\n */\n async handleSystemProjectInfo(args: any, authContext: ExtendedAuthContext) {\n if (!authContext.isSystemMode) {\n throw new Error(\"System tools are only available in system mode\");\n }\n\n try {\n const projectInfo = await this.valTownClient.getProjectInfo();\n \n // Format file structure\n const structure = projectInfo.files.map(file => {\n const icon = file.type === 'directory' ? '📁' : '📄';\n const suffix = file.type === 'directory' ? '/' : '';\n return `${icon} ${file.path}${suffix}`;\n });\n \n // Read README if it exists\n let readmeContent = \"\";\n try {\n readmeContent = await this.valTownClient.readFile(\"README.md\");\n } catch {\n // README doesn't exist or can't be read\n }\n \n // Format environment info\n const envInfo = Object.entries(projectInfo.environment || {})\n .map(([key, value]) => `${key}: ${value}`)\n .join('\\n');\n \n const projectInfoText = [\n \"# Project Information\",\n \"\",\n `## Project: ${projectInfo.name}`,\n projectInfo.description ? projectInfo.description : \"\",\n \"\",\n \"## Environment Configuration\",\n envInfo,\n \"\",\n \"## Project Structure\",\n structure.slice(0, 50).join('\\n'), // Limit to first 50 files\n structure.length > 50 ? `\\n... and ${structure.length - 50} more files` : \"\",\n \"\",\n \"## README Content\",\n readmeContent ? readmeContent.substring(0, 2000) + (readmeContent.length > 2000 ? \"\\n\\n[README truncated...]\" : \"\") : \"No README.md found\"\n ].join('\\n');\n \n return {\n content: [{\n type: \"text\",\n text: projectInfoText\n }]\n };\n } catch (error) {\n throw new Error(`Failed to get project info: ${error.message}`);\n }\n }\n}",[],[99,100,101,319],[],[99,100,101,177],"369eb572-4d55-11f0-a716-76b3cceeab13","kv-tools.ts","cf2299ed-6017-42c0-98a9-b113868b6f10",["D",1750368883229],"/**\n * Key-Value Store tool handlers\n */\n\nimport { DynamoDBDocumentClient } from \"https://esm.sh/@aws-sdk/lib-dynamodb@3.490.0\";\nimport { NamespacedKVStore, AuthContext } from \"../../storage/kv-store.ts\";\n\nexport class KVToolHandlers {\n private docClient: DynamoDBDocumentClient;\n private tableName: string;\n\n constructor(docClient: DynamoDBDocumentClient, tableName: string) {\n this.docClient = docClient;\n this.tableName = tableName;\n }\n\n async handleKVGet(args: any, authContext: AuthContext) {\n const { key } = args;\n if (!key) {\n throw new Error(\"Key is required for KV get operation\");\n }\n\n const kvStore = new NamespacedKVStore(authContext, this.docClient, this.tableName);\n \n const value = await kvStore.get(key);\n \n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify(value, null, 2),\n },\n ],\n };\n }\n\n async handleKVPut(args: any, authContext: AuthContext) {\n const { key, value, ttl } = args;\n if (!key || value === undefined) {\n throw new Error(\"Key and value are required for KV put operation\");\n }\n\n const kvStore = new NamespacedKVStore(authContext, this.docClient, this.tableName);\n \n await kvStore.put(key, value, ttl);\n \n return {\n content: [\n {\n type: \"text\",\n text: `Successfully stored key: ${key}${ttl ? ` (TTL: ${ttl}s)` : ''}`,\n },\n ],\n };\n }\n\n async handleKVDelete(args: any, authContext: AuthContext) {\n const { key } = args;\n if (!key) {\n throw new Error(\"Key is required for KV delete operation\");\n }\n\n const kvStore = new NamespacedKVStore(authContext, this.docClient, this.tableName);\n \n await kvStore.delete(key);\n \n return {\n content: [\n {\n type: \"text\",\n text: `Successfully deleted key: ${key}`,\n },\n ],\n };\n }\n\n async handleKVList(args: any, authContext: AuthContext) {\n const { prefix, limit = 100 } = args;\n\n const kvStore = new NamespacedKVStore(authContext, this.docClient, this.tableName);\n \n const keys = await kvStore.list(prefix, limit);\n \n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify(keys, null, 2),\n },\n ],\n };\n }\n\n async handleKVQuery(args: any, authContext: AuthContext) {\n const { keyPattern, limit = 100 } = args;\n if (!keyPattern) {\n throw new Error(\"Key pattern is required for KV query operation\");\n }\n\n const kvStore = new NamespacedKVStore(authContext, this.docClient, this.tableName);\n \n const items = await kvStore.query(keyPattern, limit);\n \n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify(items, null, 2),\n },\n ],\n };\n }\n}",[],[99,100,101,328],[],[99,100,101,79],"369eb09a-4d55-11f0-a716-76b3cceeab13","files-tools.ts","ee99e10e-f72e-4cb2-85e7-2bbba67a3745",["D",1750368883229],"/**\n * Files Store tool handlers\n */\n\nimport { S3Client } from \"https://esm.sh/@aws-sdk/client-s3@3.490.0\";\nimport { NamespacedFilesStore, AuthContext } from \"../../storage/files-store.ts\";\n\nexport class FilesToolHandlers {\n private s3Client: S3Client;\n private bucketName: string;\n\n constructor(s3Client: S3Client, bucketName: string) {\n this.s3Client = s3Client;\n this.bucketName = bucketName;\n }\n\n async handleFilesGet(args: any, authContext: AuthContext) {\n const { key, versionId } = args;\n if (!key) {\n throw new Error(\"Key is required for files get operation\");\n }\n\n const filesStore = new NamespacedFilesStore(authContext, this.s3Client, this.bucketName);\n \n const file = await filesStore.get(key, versionId);\n \n if (!file) {\n return {\n content: [\n {\n type: \"text\",\n text: \"File not found\",\n },\n ],\n };\n }\n \n return {\n content: [\n {\n type: \"text\",\n text: file.content,\n },\n ],\n };\n }\n\n async handleFilesPut(args: any, authContext: AuthContext) {\n const { key, content, contentType, metadata } = args;\n if (!key || content === undefined) {\n throw new Error(\"Key and content are required for files put operation\");\n }\n\n const filesStore = new NamespacedFilesStore(authContext, this.s3Client, this.bucketName);\n \n const result = await filesStore.put(key, content, contentType, metadata);\n \n return {\n content: [\n {\n type: \"text\",\n text: `Successfully stored file: ${key}${result.versionId ? ` (Version: ${result.versionId})` : ''}`,\n },\n ],\n };\n }\n\n async handleFilesDelete(args: any, authContext: AuthContext) {\n const { key, versionId } = args;\n if (!key) {\n throw new Error(\"Key is required for files delete operation\");\n }\n\n const filesStore = new NamespacedFilesStore(authContext, this.s3Client, this.bucketName);\n \n await filesStore.delete(key, versionId);\n \n return {\n content: [\n {\n type: \"text\",\n text: `Successfully deleted file: ${key}${versionId ? ` (Version: ${versionId})` : ''}`,\n },\n ],\n };\n }\n\n async handleFilesList(args: any, authContext: AuthContext) {\n const { prefix, limit = 100 } = args;\n\n const filesStore = new NamespacedFilesStore(authContext, this.s3Client, this.bucketName);\n \n const files = await filesStore.list(prefix, limit);\n \n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify(files, null, 2),\n },\n ],\n };\n }\n\n async handleFilesListVersions(args: any, authContext: AuthContext) {\n const { key, limit = 100 } = args;\n\n const filesStore = new NamespacedFilesStore(authContext, this.s3Client, this.bucketName);\n \n const versions = await filesStore.listVersions(key, limit);\n \n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify(versions, null, 2),\n },\n ],\n };\n }\n\n async handleFilesMove(args: any, authContext: AuthContext) {\n const { sourceKey, destinationKey } = args;\n if (!sourceKey || !destinationKey) {\n throw new Error(\"Source and destination keys are required for files move operation\");\n }\n\n const filesStore = new NamespacedFilesStore(authContext, this.s3Client, this.bucketName);\n \n await filesStore.move(sourceKey, destinationKey);\n \n return {\n content: [\n {\n type: \"text\",\n text: `Successfully moved file from ${sourceKey} to ${destinationKey}`,\n },\n ],\n };\n }\n\n async handleFilesCopy(args: any, authContext: AuthContext) {\n const { sourceKey, destinationKey } = args;\n if (!sourceKey || !destinationKey) {\n throw new Error(\"Source and destination keys are required for files copy operation\");\n }\n\n const filesStore = new NamespacedFilesStore(authContext, this.s3Client, this.bucketName);\n \n const result = await filesStore.copy(sourceKey, destinationKey);\n \n return {\n content: [\n {\n type: \"text\",\n text: `Successfully copied file from ${sourceKey} to ${destinationKey}${result.versionId ? ` (Version: ${result.versionId})` : ''}`,\n },\n ],\n };\n }\n\n async handleFilesExists(args: any, authContext: AuthContext) {\n const { key } = args;\n if (!key) {\n throw new Error(\"Key is required for files exists operation\");\n }\n\n const filesStore = new NamespacedFilesStore(authContext, this.s3Client, this.bucketName);\n \n const exists = await filesStore.exists(key);\n \n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify({ key, exists }, null, 2),\n },\n ],\n };\n }\n\n async handleFilesMetadata(args: any, authContext: AuthContext) {\n const { key, versionId } = args;\n if (!key) {\n throw new Error(\"Key is required for files metadata operation\");\n }\n\n const filesStore = new NamespacedFilesStore(authContext, this.s3Client, this.bucketName);\n \n const metadata = await filesStore.getMetadata(key, versionId);\n \n if (!metadata) {\n return {\n content: [\n {\n type: \"text\",\n text: \"File not found\",\n },\n ],\n };\n }\n \n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify(metadata, null, 2),\n },\n ],\n };\n }\n}",[],[99,100,101,337],"369ea834-4d55-11f0-a716-76b3cceeab13","code-tools.ts","99b9c551-323c-4d00-86c4-7e5f5af586c3",["D",1750368883229],"/**\n * Code execution tool handlers\n */\n\nimport { DynamoDBDocumentClient } from \"https://esm.sh/@aws-sdk/lib-dynamodb@3.490.0\";\nimport { AuthContext } from \"../../storage/kv-store.ts\";\nimport { SkillRegistry } from \"../../storage/skill-registry.ts\";\nimport { FilesToolHandlers } from \"./files-tools.ts\";\n\n// Import Node.js VM module for better code execution\nimport { createContext, runInNewContext } from \"node:vm\";\n\nexport class CodeToolHandlers {\n private filesHandler: FilesToolHandlers;\n private toolsContext: Record;\n private skillRegistry: SkillRegistry;\n\n constructor(\n filesHandler: FilesToolHandlers,\n toolsContext: Record,\n docClient: DynamoDBDocumentClient,\n tableName: string,\n ) {\n this.filesHandler = filesHandler;\n this.toolsContext = toolsContext;\n this.skillRegistry = new SkillRegistry(docClient, tableName);\n }\n\n /**\n * Execute code using Node.js VM module for better isolation and stack traces\n */\n private async executeWithVM(codeSource: string, input: any, authContext: AuthContext): Promise {\n // Create execution context with tools and input\n const context = createContext({\n input,\n tools: this.toolsContext,\n console: {\n log: console.log,\n error: console.error,\n warn: console.warn,\n info: console.info\n },\n // Restricted environment - no access to dangerous globals\n setTimeout,\n clearTimeout,\n setInterval,\n clearInterval,\n Promise,\n JSON,\n Math,\n Date,\n Array,\n Object,\n String,\n Number,\n Boolean,\n RegExp,\n Error,\n TypeError,\n ReferenceError,\n SyntaxError\n });\n\n // Build the execution script:\n // 1. User code first (preserves line numbers)\n // 2. Execution logic appended\n const executionScript = `${codeSource}\n\n// === EXECUTION LOGIC (appended to preserve user code line numbers) ===\n(async () => {\n if (typeof execute !== 'function') {\n throw new Error('Code must define an execute function');\n }\n \n return await execute(input, tools);\n})();`;\n\n try {\n // Execute in VM context with proper filename for stack traces\n const result = runInNewContext(executionScript, context, {\n filename: 'user-code.js', // This provides proper filenames in stack traces\n timeout: 30000, // 30 second timeout\n displayErrors: true\n });\n\n // Handle promise results\n if (result instanceof Promise) {\n return await result;\n }\n\n return result;\n } catch (error) {\n // Re-throw with enhanced error information\n if (error instanceof Error) {\n // The VM module preserves original line numbers and provides better stack traces\n throw error;\n }\n throw new Error(`Code execution failed: ${String(error)}`);\n }\n }\n\n /**\n * Validate code syntax before execution using VM\n */\n private async validateCodeSyntax(code: string): Promise<{ valid: boolean; error?: string }> {\n try {\n // Try to create a VM context and compile the code\n const context = createContext({});\n \n // Test compilation without execution\n runInNewContext(`\n ${code}\n // Check if execute function exists\n if (typeof execute !== 'function') {\n throw new Error('Code must define an execute function');\n }\n `, context, {\n filename: 'syntax-check.js',\n timeout: 1000,\n displayErrors: true\n });\n \n return { valid: true };\n } catch (error) {\n return {\n valid: false,\n error: error instanceof Error ? error.message : String(error)\n };\n }\n }\n\n async handleCodeExec(args: any, authContext: AuthContext) {\n const { code, key, input } = args;\n let codeSource: string;\n\n try {\n // Determine code source: either direct code string or fetch from Files Store key\n if (code && key) {\n throw new Error(\"Cannot specify both 'code' and 'key' parameters. Use either direct code or Files Store key.\");\n }\n\n if (!code && !key) {\n throw new Error(\n \"Must specify either 'code' (direct code string) or 'key' (Files Store object key containing code).\",\n );\n }\n\n if (key) {\n // Fetch code from Files Store (namespaced)\n console.log(`[CodeExec] Fetching code from files key: ${key}`);\n const filesResponse = await this.filesHandler.handleFilesGet({ key }, authContext);\n codeSource = filesResponse.content[0].text;\n console.log(`[CodeExec] Retrieved code from files store (${codeSource.length} characters)`);\n } else {\n // Use direct code string\n codeSource = code;\n console.log(`[CodeExec] Using direct code string (${codeSource.length} characters)`);\n }\n\n console.log(\"Executing code with VM\");\n\n // Execute code using VM module for better stack traces\n const result = await this.executeWithVM(codeSource, input, authContext);\n \n console.log(\"[MCP] Code execution result\", result);\n\n return {\n content: [\n {\n type: \"text\",\n text: JSON.stringify(result, null, 2),\n },\n ],\n };\n } catch (error) {\n console.error(\"Error executing code\", error);\n\n // Format error with better stack trace information\n let errorText = `❌ **Code Execution Error**\\n\\n**Message:** ${error.message}\\n\\n`;\n \n if (error.stack) {\n errorText += `**Stack Trace:**\\n\\`\\`\\`\\n${error.stack}\\n\\`\\`\\`\\n`;\n }\n\n return {\n content: [\n {\n type: \"text\",\n text: errorText,\n },\n ],\n };\n }\n }\n\n async handleRegisterSkill(args: any, authContext: AuthContext) {\n const { name, description, fileKey, inputSchema } = args;\n\n try {\n // Validate skill name format\n if (!/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(name)) {\n throw new Error(\n \"Skill name must start with a letter and contain only letters, numbers, underscores, and hyphens\",\n );\n }\n\n // Check if skill already exists\n const existingSkill = await this.skillRegistry.getSkill(authContext, name);\n if (existingSkill) {\n throw new Error(`Skill '${name}' already exists. Use unregister-skill first to replace it.`);\n }\n\n // Verify the file exists and validate its syntax\n let skillCode: string;\n try {\n const filesResponse = await this.filesHandler.handleFilesGet({ key: fileKey }, authContext);\n skillCode = filesResponse.content[0].text;\n } catch (error) {\n throw new Error(`File '${fileKey}' not found in your file store: ${error.message}`);\n }\n\n // Validate the skill code syntax before registration\n const syntaxCheck = await this.validateCodeSyntax(skillCode);\n if (!syntaxCheck.valid) {\n throw new Error(`Skill code has syntax errors:\\n${syntaxCheck.error}`);\n }\n\n // Validate input schema is a valid JSON Schema object\n if (typeof inputSchema !== \"object\" || inputSchema === null) {\n throw new Error(\"inputSchema must be a valid JSON Schema object\");\n }\n\n // Register the skill\n await this.skillRegistry.registerSkill(authContext, name, description, fileKey, inputSchema);\n\n return {\n content: [\n {\n type: \"text\",\n text: `✅ Skill '${name}' registered successfully. It is now available as a tool.`,\n },\n ],\n };\n } catch (error) {\n console.error(\"Error registering skill\", error);\n return {\n content: [\n {\n type: \"text\",\n text: `❌ Error registering skill: ${error.message}`,\n },\n ],\n };\n }\n }\n\n async handleUnregisterSkill(args: any, authContext: AuthContext) {\n const { name } = args;\n\n try {\n const success = await this.skillRegistry.unregisterSkill(authContext, name);\n\n if (success) {\n return {\n content: [\n {\n type: \"text\",\n text: `✅ Skill '${name}' unregistered successfully.`,\n },\n ],\n };\n } else {\n return {\n content: [\n {\n type: \"text\",\n text: `⚠️ Skill '${name}' not found.`,\n },\n ],\n };\n }\n } catch (error) {\n console.error(\"Error unregistering skill\", error);\n return {\n content: [\n {\n type: \"text\",\n text: `❌ Error unregistering skill: ${error.message}`,\n },\n ],\n };\n }\n }\n\n async handleListSkills(args: any, authContext: AuthContext) {\n try {\n const skills = await this.skillRegistry.listSkills(authContext);\n\n if (skills.length === 0) {\n return {\n content: [\n {\n type: \"text\",\n text: \"No skills registered.\",\n },\n ],\n };\n }\n\n const skillsList = skills.map(skill => `- **${skill.name}**: ${skill.description} (file: ${skill.fileKey})`).join(\n \"\\n\",\n );\n\n return {\n content: [\n {\n type: \"text\",\n text: `📋 **Registered Skills:**\\n\\n${skillsList}`,\n },\n ],\n };\n } catch (error) {\n console.error(\"Error listing skills\", error);\n return {\n content: [\n {\n type: \"text\",\n text: `❌ Error listing skills: ${error.message}`,\n },\n ],\n };\n }\n }\n\n async handleSkillExecution(skillName: string, args: any, authContext: AuthContext) {\n try {\n // Get the skill definition\n const skill = await this.skillRegistry.getSkill(authContext, skillName);\n if (!skill) {\n throw new Error(`Skill '${skillName}' not found`);\n }\n\n // Execute the skill using the code-exec logic\n return await this.handleCodeExec({\n key: skill.fileKey,\n input: args,\n }, authContext);\n } catch (error) {\n console.error(`Error executing skill ${skillName}`, error);\n return {\n content: [\n {\n type: \"text\",\n text: `❌ Error executing skill '${skillName}': ${error.message}`,\n },\n ],\n };\n }\n }\n\n async getRegisteredSkills(authContext: AuthContext) {\n return await this.skillRegistry.listSkills(authContext);\n }\n}",[],[99,100,101,344],"369ec62a-4d55-11f0-a716-76b3cceeab13",["D",1750368883229],[287,288,289,290,291,292],[99,100,101],"369ed0f2-4d55-11f0-a716-76b3cceeab13",["D",1750368883229],[286,293],[99,100],"369ea28a-4d55-11f0-a716-76b3cceeab13","skill-registry.ts","818c3f44-bb59-4023-b70d-cebc100355ae","944a7d56-2a8c-48ec-8b0e-77d7c15874ba",["D",1750368883229],"/**\n * Skill Registry for managing user-registered skills\n * Skills are stored in the KV store with a special prefix\n */\n\nimport { AuthContext, NamespacedKVStore } from \"./kv-store.ts\";\nimport { DynamoDBDocumentClient } from \"https://esm.sh/@aws-sdk/lib-dynamodb@3.490.0\";\n\nexport interface SkillDefinition {\n name: string;\n description: string;\n fileKey: string;\n inputSchema: any;\n createdAt: string;\n updatedAt: string;\n}\n\nexport class SkillRegistry {\n private kvStore: NamespacedKVStore;\n private static readonly SKILL_PREFIX = \"__skills__:\";\n\n constructor(docClient: DynamoDBDocumentClient, tableName: string) {\n // Create a dummy auth context for the KV store - we'll override the namespace\n const dummyAuthContext: AuthContext = { namespace: \"dummy\", isDemo: false };\n this.kvStore = new NamespacedKVStore(dummyAuthContext, docClient, tableName);\n }\n\n private getSkillKey(userNamespace: string, skillName: string): string {\n return `__skills__:${userNamespace}:${skillName}`;\n }\n\n private getUserSkillsPrefix(userNamespace: string): string {\n return `__skills__:${userNamespace}:`;\n }\n\n async registerSkill(\n authContext: AuthContext,\n skillName: string,\n description: string,\n fileKey: string,\n inputSchema: any\n ): Promise {\n console.log('[SkillRegistry] registerSkill', skillName, fileKey);\n const skillKey = this.getSkillKey(authContext.namespace, skillName);\n const now = new Date().toISOString();\n\n const skillDefinition: SkillDefinition = {\n name: skillName,\n description,\n fileKey,\n inputSchema,\n createdAt: now,\n updatedAt: now,\n };\n\n \n console.log('[SkillRegistry] skillDefinition', skillKey, skillDefinition);\n // Store in KV with a special key structure that bypasses normal namespacing\n await this.kvStore.put(skillKey, skillDefinition, undefined, true); // true = bypass namespace\n }\n\n async getSkill(authContext: AuthContext, skillName: string): Promise {\n console.log('[SkillRegistry] getSkill', skillName);\n const skillKey = this.getSkillKey(authContext.namespace, skillName);\n console.log('[SkillRegistry] skillKey', skillKey);\n return await this.kvStore.get(skillKey, true); // true = bypass namespace\n }\n\n async listSkills(authContext: AuthContext): Promise {\n const prefix = this.getUserSkillsPrefix(authContext.namespace);\n const results = await this.kvStore.query(`${prefix}*`, 1000, true); // true = bypass namespace\n \n return results.map(item => item.value as SkillDefinition);\n }\n\n async unregisterSkill(authContext: AuthContext, skillName: string): Promise {\n const skillKey = this.getSkillKey(authContext.namespace, skillName);\n return await this.kvStore.delete(skillKey, true); // true = bypass namespace\n }\n\n async skillExists(authContext: AuthContext, skillName: string): Promise {\n const skill = await this.getSkill(authContext, skillName);\n return skill !== null;\n }\n}",[],[99,366,359],"storage","369e9d9e-4d55-11f0-a716-76b3cceeab13","kv-store.ts","4141e3f7-41d0-46d3-a664-d443bea33c74",["D",1750368883229],"/**\n * Namespaced Key-Value Store abstraction over DynamoDB\n * Provides transparent multi-tenancy with namespace isolation\n */\n\nimport {\n DeleteCommand,\n DynamoDBDocumentClient,\n GetCommand,\n PutCommand,\n QueryCommand,\n} from \"https://esm.sh/@aws-sdk/lib-dynamodb@3.490.0\";\n\nexport interface AuthContext {\n namespace: string;\n isDemo: boolean;\n}\n\nexport interface KVItem {\n key: string;\n value: any;\n}\n\nexport interface NamespacedKVItem {\n pk: string; // Partition key: namespace\n sk: string; // Sort key: user key\n data: any; // User's value\n ttl?: number; // Optional TTL\n created: string; // Timestamp\n updated: string; // Timestamp\n}\n\nexport class NamespacedKVStore {\n private namespace: string;\n private docClient: DynamoDBDocumentClient;\n private tableName: string;\n\n constructor(authContext: AuthContext, docClient: DynamoDBDocumentClient, tableName: string) {\n this.namespace = authContext.namespace;\n this.docClient = docClient;\n this.tableName = tableName;\n }\n\n // Convert user key to partition and sort keys\n private getKeys(userKey: string, bypassNamespace: boolean = false): { pk: string; sk: string } {\n if (bypassNamespace) {\n // For bypassing namespace, the userKey should contain both pk and sk separated by ':'\n const parts = userKey.split(':');\n if (parts.length > 1) {\n return { pk: parts[0], sk: parts.slice(1).join(':') };\n }\n // If no separator, treat the whole key as sk with empty pk\n return { pk: '', sk: userKey };\n }\n \n return {\n pk: this.namespace,\n sk: userKey\n };\n }\n\n async get(key: string, bypassNamespace: boolean = false): Promise {\n if (!key) {\n throw new Error(\"Key is required\");\n }\n\n const { pk, sk } = this.getKeys(key, bypassNamespace);\n const response = await this.docClient.send(new GetCommand({\n TableName: this.tableName,\n Key: { pk, sk }\n }));\n\n return response.Item?.data || null;\n }\n\n async put(key: string, value: any, ttl?: number, bypassNamespace: boolean = false): Promise {\n if (!key || value === undefined) {\n throw new Error(\"Key and value are required\");\n }\n\n const now = new Date().toISOString();\n const { pk, sk } = this.getKeys(key, bypassNamespace);\n const item: NamespacedKVItem = {\n pk,\n sk,\n data: value,\n created: now,\n updated: now\n };\n\n if (ttl && ttl > 0) {\n item.ttl = Math.floor(Date.now() / 1000) + ttl;\n }\n\n await this.docClient.send(new PutCommand({\n TableName: this.tableName,\n Item: item\n }));\n }\n\n async delete(key: string, bypassNamespace: boolean = false): Promise {\n if (!key) {\n throw new Error(\"Key is required\");\n }\n\n const { pk, sk } = this.getKeys(key, bypassNamespace);\n const response = await this.docClient.send(new DeleteCommand({\n TableName: this.tableName,\n Key: { pk, sk }\n }));\n\n // Return true if item was deleted (existed before deletion)\n return response.$metadata.httpStatusCode === 200;\n }\n\n async list(prefix?: string, limit: number = 100): Promise {\n if (limit <= 0 || limit > 1000) {\n throw new Error(\"Limit must be between 1 and 1000\");\n }\n\n const queryParams: any = {\n TableName: this.tableName,\n KeyConditionExpression: 'pk = :pk',\n ExpressionAttributeValues: {\n ':pk': this.namespace\n },\n Limit: limit,\n ProjectionExpression: 'sk'\n };\n\n // If prefix is provided, add begins_with condition on sort key\n if (prefix) {\n queryParams.KeyConditionExpression += ' AND begins_with(sk, :prefix)';\n queryParams.ExpressionAttributeValues[':prefix'] = prefix;\n }\n\n const response = await this.docClient.send(new QueryCommand(queryParams));\n\n return (response.Items || []).map(item => item.sk);\n }\n\n async query(keyPattern: string, limit: number = 100, bypassNamespace: boolean = false): Promise {\n if (!keyPattern) {\n throw new Error(\"Key pattern is required\");\n }\n \n if (limit <= 0 || limit > 1000) {\n throw new Error(\"Limit must be between 1 and 1000\");\n }\n\n if (bypassNamespace) {\n // For bypassed namespace queries, the pattern should be in format \"pk:sk_pattern\"\n const parts = keyPattern.split(':');\n \n if (parts.length <= 2) {\n throw new Error(\"For bypassed namespace queries, pattern must be in format 'pk:sk_pattern'\");\n }\n\n const pk = parts[0];\n const skPattern = parts.slice(1).join(':');\n const cleanPattern = skPattern.replace(/\\*+$/, ''); // Remove trailing wildcards\n\n const queryParams: any = {\n TableName: this.tableName,\n KeyConditionExpression: 'pk = :pk AND begins_with(sk, :pattern)',\n ExpressionAttributeValues: {\n ':pk': pk,\n ':pattern': cleanPattern\n },\n Limit: limit\n };\n\n const response = await this.docClient.send(new QueryCommand(queryParams));\n\n return (response.Items || []).map(item => ({\n key: item.sk,\n value: item.data\n }));\n }\n\n // For now, treat pattern as prefix (can be enhanced later for wildcards)\n const cleanPattern = keyPattern.replace(/\\*+$/, ''); // Remove trailing wildcards\n\n const queryParams: any = {\n TableName: this.tableName,\n KeyConditionExpression: 'pk = :pk AND begins_with(sk, :pattern)',\n ExpressionAttributeValues: {\n ':pk': this.namespace,\n ':pattern': cleanPattern\n },\n Limit: limit\n };\n\n const response = await this.docClient.send(new QueryCommand(queryParams));\n\n return (response.Items || []).map(item => ({\n key: item.sk,\n value: item.data\n }));\n }\n}",[],[99,366,368],"369e9060-4d55-11f0-a716-76b3cceeab13","files-store.ts","8b44380e-875a-4224-bc0b-71f84ec50d99",["D",1750368883229],"/**\n * Namespaced Files Store abstraction over S3\n * Provides transparent multi-tenancy with namespace isolation and versioning support\n */\n\nimport {\n CopyObjectCommand,\n DeleteObjectCommand,\n GetObjectCommand,\n ListObjectsV2Command,\n ListObjectVersionsCommand,\n PutObjectCommand,\n S3Client,\n HeadObjectCommand,\n} from \"https://esm.sh/@aws-sdk/client-s3@3.490.0\";\n\nexport interface AuthContext {\n namespace: string;\n isDemo: boolean;\n}\n\nexport interface FileItem {\n key: string;\n content: string;\n contentType?: string;\n size?: number;\n lastModified?: Date;\n versionId?: string;\n isLatest?: boolean;\n}\n\nexport interface FileMetadata {\n key: string;\n size: number;\n lastModified: Date;\n contentType: string;\n versionId?: string;\n isLatest?: boolean;\n etag?: string;\n}\n\nexport interface NamespacedFileItem {\n key: string; // Namespaced key: `${namespace}/${userKey}`\n content: string;\n contentType: string;\n metadata?: Record;\n versionId?: string;\n}\n\nexport class NamespacedFilesStore {\n private namespace: string;\n private s3Client: S3Client;\n private bucketName: string;\n private isDemo: boolean;\n\n constructor(authContext: AuthContext, s3Client: S3Client, bucketName: string) {\n this.namespace = authContext.namespace;\n this.s3Client = s3Client;\n this.bucketName = bucketName;\n this.isDemo = authContext.isDemo;\n }\n\n // Convert user key to namespaced key\n private namespacedKey(userKey: string): string {\n // Remove leading slash if present to avoid double slashes\n const cleanKey = userKey.startsWith('/') ? userKey.substring(1) : userKey;\n return `${this.namespace}/${cleanKey}`;\n }\n\n // Strip namespace from key to return to user\n private stripNamespace(namespacedKey: string): string {\n const prefix = `${this.namespace}/`;\n return namespacedKey.startsWith(prefix) \n ? namespacedKey.substring(prefix.length)\n : namespacedKey;\n }\n\n // Utility function to determine MIME type\n private getMimeType(filename: string): string {\n const ext = filename.split(\".\").pop()?.toLowerCase();\n const mimeTypes: Record = {\n \"txt\": \"text/plain\",\n \"json\": \"application/json\",\n \"csv\": \"text/csv\",\n \"xml\": \"application/xml\",\n \"html\": \"text/html\",\n \"js\": \"application/javascript\",\n \"ts\": \"application/typescript\",\n \"md\": \"text/markdown\",\n \"pdf\": \"application/pdf\",\n \"png\": \"image/png\",\n \"jpg\": \"image/jpeg\",\n \"jpeg\": \"image/jpeg\",\n \"gif\": \"image/gif\",\n \"svg\": \"image/svg+xml\",\n \"css\": \"text/css\",\n \"yaml\": \"application/x-yaml\",\n \"yml\": \"application/x-yaml\",\n };\n\n return mimeTypes[ext || \"\"] || \"application/octet-stream\";\n }\n\n async get(key: string, versionId?: string): Promise {\n if (!key) {\n throw new Error(\"Key is required\");\n }\n\n const command = new GetObjectCommand({\n Bucket: this.bucketName,\n Key: this.namespacedKey(key),\n VersionId: versionId,\n });\n\n try {\n const response = await this.s3Client.send(command);\n const content = await response.Body?.transformToString() || \"\";\n\n return {\n key,\n content,\n contentType: response.ContentType || this.getMimeType(key),\n size: response.ContentLength,\n lastModified: response.LastModified,\n versionId: response.VersionId,\n };\n } catch (error: any) {\n if (error.name === 'NoSuchKey') {\n return null;\n }\n throw error;\n }\n }\n\n async put(key: string, content: string, contentType?: string, metadata?: Record): Promise<{ versionId?: string }> {\n if (!key || content === undefined) {\n throw new Error(\"Key and content are required\");\n }\n\n // Demo namespace restrictions\n if (this.isDemo) {\n const maxSize = 10 * 1024; // 10KB limit for demo\n if (content.length > maxSize) {\n throw new Error(`Demo accounts are limited to ${maxSize} bytes per file`);\n }\n }\n\n const command = new PutObjectCommand({\n Bucket: this.bucketName,\n Key: this.namespacedKey(key),\n Body: content,\n ContentType: contentType || this.getMimeType(key),\n Metadata: {\n ...metadata,\n namespace: this.namespace,\n originalKey: key,\n uploadedAt: new Date().toISOString(),\n },\n });\n\n const response = await this.s3Client.send(command);\n return {\n versionId: response.VersionId,\n };\n }\n\n async delete(key: string, versionId?: string): Promise {\n if (!key) {\n throw new Error(\"Key is required\");\n }\n\n const command = new DeleteObjectCommand({\n Bucket: this.bucketName,\n Key: this.namespacedKey(key),\n VersionId: versionId,\n });\n\n await this.s3Client.send(command);\n }\n\n async list(prefix?: string, limit: number = 100): Promise {\n if (limit <= 0 || limit > 1000) {\n throw new Error(\"Limit must be between 1 and 1000\");\n }\n\n const keyPrefix = prefix \n ? this.namespacedKey(prefix)\n : `${this.namespace}/`;\n\n const command = new ListObjectsV2Command({\n Bucket: this.bucketName,\n Prefix: keyPrefix,\n MaxKeys: limit,\n });\n\n const response = await this.s3Client.send(command);\n \n return (response.Contents || []).map(object => ({\n key: this.stripNamespace(object.Key || \"\"),\n size: object.Size || 0,\n lastModified: object.LastModified || new Date(),\n contentType: this.getMimeType(object.Key || \"\"),\n etag: object.ETag,\n }));\n }\n\n async listVersions(key?: string, limit: number = 100): Promise {\n if (limit <= 0 || limit > 1000) {\n throw new Error(\"Limit must be between 1 and 1000\");\n }\n\n const keyPrefix = key \n ? this.namespacedKey(key)\n : `${this.namespace}/`;\n\n const command = new ListObjectVersionsCommand({\n Bucket: this.bucketName,\n Prefix: keyPrefix,\n MaxKeys: limit,\n });\n\n const response = await this.s3Client.send(command);\n \n const versions: FileMetadata[] = [];\n \n // Add object versions\n if (response.Versions) {\n versions.push(...response.Versions.map(version => ({\n key: this.stripNamespace(version.Key || \"\"),\n size: version.Size || 0,\n lastModified: version.LastModified || new Date(),\n contentType: this.getMimeType(version.Key || \"\"),\n versionId: version.VersionId,\n isLatest: version.IsLatest,\n etag: version.ETag,\n })));\n }\n\n // Add delete markers (if any)\n if (response.DeleteMarkers) {\n versions.push(...response.DeleteMarkers.map(marker => ({\n key: this.stripNamespace(marker.Key || \"\"),\n size: 0,\n lastModified: marker.LastModified || new Date(),\n contentType: \"application/x-delete-marker\",\n versionId: marker.VersionId,\n isLatest: marker.IsLatest,\n })));\n }\n\n // Sort by last modified date (newest first)\n return versions.sort((a, b) => b.lastModified.getTime() - a.lastModified.getTime());\n }\n\n async move(sourceKey: string, destinationKey: string): Promise {\n if (!sourceKey || !destinationKey) {\n throw new Error(\"Source and destination keys are required\");\n }\n\n // Copy object to new location\n const copyCommand = new CopyObjectCommand({\n Bucket: this.bucketName,\n CopySource: `${this.bucketName}/${this.namespacedKey(sourceKey)}`,\n Key: this.namespacedKey(destinationKey),\n });\n\n await this.s3Client.send(copyCommand);\n\n // Delete original object\n await this.delete(sourceKey);\n }\n\n async copy(sourceKey: string, destinationKey: string): Promise<{ versionId?: string }> {\n if (!sourceKey || !destinationKey) {\n throw new Error(\"Source and destination keys are required\");\n }\n\n const copyCommand = new CopyObjectCommand({\n Bucket: this.bucketName,\n CopySource: `${this.bucketName}/${this.namespacedKey(sourceKey)}`,\n Key: this.namespacedKey(destinationKey),\n });\n\n const response = await this.s3Client.send(copyCommand);\n return {\n versionId: response.VersionId,\n };\n }\n\n async exists(key: string): Promise {\n if (!key) {\n throw new Error(\"Key is required\");\n }\n\n try {\n const command = new HeadObjectCommand({\n Bucket: this.bucketName,\n Key: this.namespacedKey(key),\n });\n\n await this.s3Client.send(command);\n return true;\n } catch (error: any) {\n if (error.name === 'NotFound' || error.name === 'NoSuchKey') {\n return false;\n }\n throw error;\n }\n }\n\n async getMetadata(key: string, versionId?: string): Promise {\n if (!key) {\n throw new Error(\"Key is required\");\n }\n\n try {\n const command = new HeadObjectCommand({\n Bucket: this.bucketName,\n Key: this.namespacedKey(key),\n VersionId: versionId,\n });\n\n const response = await this.s3Client.send(command);\n \n return {\n key,\n size: response.ContentLength || 0,\n lastModified: response.LastModified || new Date(),\n contentType: response.ContentType || this.getMimeType(key),\n versionId: response.VersionId,\n etag: response.ETag,\n };\n } catch (error: any) {\n if (error.name === 'NotFound' || error.name === 'NoSuchKey') {\n return null;\n }\n throw error;\n }\n }\n\n // Utility method to get namespace info (for debugging/admin)\n getNamespaceInfo(): { namespace: string; isDemo: boolean } {\n return {\n namespace: this.namespace,\n isDemo: this.isDemo,\n };\n }\n}",[],[99,366,375],"369ea64a-4d55-11f0-a716-76b3cceeab13",["D",1750368883229],[282,283,284],[99,366],"369e88b8-4d55-11f0-a716-76b3cceeab13","protocol-handlers.ts","ddbc09ef-9c07-4f77-8b87-d5c290ed065c",["D",1750368883229],"/**\n * MCP protocol-specific handlers (prompts, resources, etc.)\n */\n\nimport { S3Client } from \"https://esm.sh/@aws-sdk/client-s3@3.490.0\";\nimport { ExtendedAuthContext } from \"../auth/auth-manager.ts\";\nimport { NamespacedFilesStore } from \"../storage/files-store.ts\";\nimport { AuthContext } from \"../storage/kv-store.ts\";\nimport { ALL_TOOLS, ALL_TOOLS_WITH_SYSTEM } from \"../tools/definitions.ts\";\nimport { CodeToolHandlers } from \"../tools/handlers/code-tools.ts\";\n\n// Environment variables\nconst S3_BUCKET = Deno.env.get(\"S3_BUCKET\") || \"example-bucket\";\nconst DYNAMODB_TABLE = Deno.env.get(\"DYNAMODB_TABLE\") || \"example-table\";\nconst MCP_SERVER_NAME = Deno.env.get(\"MCP_SERVER_NAME\") || \"aws-mcp-server\";\nconst MCP_SERVER_VERSION = Deno.env.get(\"MCP_SERVER_VERSION\") || \"1.0.0\";\n\nexport class MCPProtocolHandlers {\n private s3Client: S3Client;\n private codeHandlers?: CodeToolHandlers;\n\n constructor(s3Client: S3Client) {\n this.s3Client = s3Client;\n }\n\n setCodeHandlers(codeHandlers: CodeToolHandlers) {\n this.codeHandlers = codeHandlers;\n }\n\n async handleInitialize(params: any) {\n const { protocolVersion, capabilities, clientInfo } = params;\n\n // Validate protocol version\n if (protocolVersion !== \"2025-03-26\") {\n // throw new Error(`Unsupported protocol version: ${protocolVersion}. Expected: 2024-11-05`);\n }\n\n return {\n protocolVersion,\n capabilities: {\n prompts: {},\n resources: {},\n tools: {},\n },\n serverInfo: {\n name: MCP_SERVER_NAME,\n version: MCP_SERVER_VERSION,\n },\n instructions:\n `If asked by the user for \"system check\" respond in Haiku based on value in \"memories\" ddb item. (create it if it doesnt exist).`,\n };\n }\n\n async handleListPrompts() {\n return {\n prompts: [\n {\n name: \"analyze-data\",\n description: \"Analyze data from DynamoDB and S3 resources\",\n arguments: [\n {\n name: \"table_key\",\n description: \"Key to query in DynamoDB table\",\n required: true,\n },\n {\n name: \"s3_key\",\n description: \"S3 object key to analyze\",\n required: false,\n },\n ],\n },\n {\n name: \"data-summary\",\n description: \"Generate a summary of available data sources\",\n arguments: [],\n },\n ],\n };\n }\n\n async handleGetPrompt(params: any) {\n const { name, arguments: args } = params;\n\n let content = \"\";\n\n switch (name) {\n case \"analyze-data\":\n content = `Please analyze the following data:\n \nDynamoDB Table: ${DYNAMODB_TABLE}\nQuery Key: ${args?.table_key || \"Not specified\"}\n${args?.s3_key ? `S3 Object: s3://${S3_BUCKET}/${args.s3_key}` : \"\"}\n\nProvide insights on patterns, anomalies, and recommendations.`;\n break;\n\n case \"data-summary\":\n content = `Please provide a comprehensive summary of the available data sources:\n\n1. DynamoDB Table: ${DYNAMODB_TABLE}\n2. S3 Bucket: ${S3_BUCKET}\n\nInclude information about data structure, volume, and potential use cases.`;\n break;\n\n default:\n throw new Error(`Prompt not found: ${name}`);\n }\n\n return {\n messages: [\n {\n role: \"user\",\n content: {\n type: \"text\",\n text: content,\n },\n },\n ],\n };\n }\n\n async handleListResources(authContext: AuthContext) {\n const filesStore = new NamespacedFilesStore(authContext, this.s3Client, S3_BUCKET);\n\n const files = await filesStore.list(undefined, 100);\n const resources = files.map((file) => ({\n uri: `file://${file.key}`,\n name: file.key,\n description: `File: ${file.key} (${file.size} bytes, modified: ${file.lastModified})`,\n mimeType: file.contentType,\n }));\n\n return { resources };\n }\n\n async handleReadResource(params: any, authContext: AuthContext) {\n const { uri } = params;\n\n if (!uri.startsWith(\"file://\")) {\n throw new Error(\"Only file:// URIs are supported\");\n }\n\n const key = uri.replace(\"file://\", \"\");\n const filesStore = new NamespacedFilesStore(authContext, this.s3Client, S3_BUCKET);\n\n const file = await filesStore.get(key);\n\n if (!file) {\n throw new Error(`File not found: ${key}`);\n }\n\n return {\n contents: [\n {\n uri: `file://${key}`,\n mimeType: file.contentType || \"text/plain\",\n text: file.content,\n },\n ],\n };\n }\n\n async handleListTools(authContext?: ExtendedAuthContext) {\n // Use system tools if in system mode, otherwise use regular tools\n let tools = authContext?.isSystemMode ? [...ALL_TOOLS_WITH_SYSTEM] : [...ALL_TOOLS];\n\n // Add registered skills if we have an auth context and code handlers\n if (authContext && this.codeHandlers) {\n try {\n const registeredSkills = await this.codeHandlers.getRegisteredSkills(authContext);\n const skillTools = registeredSkills.map(skill => ({\n name: skill.name,\n description: skill.description,\n inputSchema: skill.inputSchema,\n }));\n tools = [...tools, ...skillTools];\n } catch (error) {\n console.error(\"Error loading registered skills:\", error);\n // Continue without registered skills\n }\n }\n\n return {\n tools,\n };\n }\n}",[],[99,144,386],[],[99,144,135],"369e8ed0-4d55-11f0-a716-76b3cceeab13",["D",1750368883229],[279,280],[99,144],"369e78b4-4d55-11f0-a716-76b3cceeab13","clients.ts","276f6128-69f8-4344-bfff-0142899dd9a2","7e9279cd-9ef6-4e1e-a28f-eb06627aa748",["D",1750368883229],"/**\n * AWS client configuration and creation utilities\n */\n\nimport { DynamoDBClient } from \"https://esm.sh/@aws-sdk/client-dynamodb@3.490.0\";\nimport { S3Client } from \"https://esm.sh/@aws-sdk/client-s3@3.490.0\";\nimport { DynamoDBDocumentClient } from \"https://esm.sh/@aws-sdk/lib-dynamodb@3.490.0\";\n\n// Environment variables\nconst AWS_REGION = Deno.env.get(\"AWS_REGION\") || \"us-east-1\";\nconst AWS_ACCESS_KEY_ID = Deno.env.get(\"AWS_ACCESS_KEY_ID\") || \"EXAMPLE_ACCESS_KEY\";\nconst AWS_SECRET_ACCESS_KEY = Deno.env.get(\"AWS_SECRET_ACCESS_KEY\") || \"EXAMPLE_SECRET_KEY\";\n\nexport interface AWSClients {\n docClient: DynamoDBDocumentClient;\n s3Client: S3Client;\n}\n\n// Create AWS clients with credentials from environment\nexport function createAWSClients(): AWSClients {\n const credentials = {\n accessKeyId: AWS_ACCESS_KEY_ID!,\n secretAccessKey: AWS_SECRET_ACCESS_KEY!,\n };\n\n const dynamoClient = new DynamoDBClient({\n region: AWS_REGION,\n credentials,\n });\n\n const docClient = DynamoDBDocumentClient.from(dynamoClient);\n\n const s3Client = new S3Client({\n region: AWS_REGION,\n credentials,\n });\n\n return { docClient, s3Client };\n}",[],[99,406,399],"aws","369e7b5c-4d55-11f0-a716-76b3cceeab13",["D",1750368883229],[277],[99,406],"369e65fe-4d55-11f0-a716-76b3cceeab13","auth-manager.ts","f726a4f2-9dc3-4496-ac4e-283b3aaa7c3e","c3198aa9-113f-4e46-891f-dd42f2e02ea7",["D",1750368883229],"/**\n * Authentication and namespace management\n * Handles token-to-namespace resolution and access control\n */\n\nimport { AuthContext } from \"../storage/kv-store.ts\";\n\nexport interface ExtendedAuthContext extends AuthContext {\n isSystemMode?: boolean;\n originalToken?: string;\n}\n\nexport class AuthManager {\n /**\n * Resolve authentication context from request\n * Returns namespace and authentication status, including system mode detection\n */\n resolveAuthContext(request: Request): ExtendedAuthContext {\n const authHeader = request.headers.get(\"Authorization\");\n \n if (!authHeader?.startsWith(\"Bearer \")) {\n return { namespace: \"demo\", isDemo: true };\n }\n \n const token = authHeader.substring(7).trim();\n \n if (!token) {\n return { namespace: \"demo\", isDemo: true };\n }\n \n // Store original token for namespace generation\n const originalToken = token;\n \n // Check if token matches AWS secret key for system mode\n const awsSecretKey = Deno.env.get(\"AWS_SECRET_ACCESS_KEY\");\n const systemModeToken = Deno.env.get(\"SYSTEM_MODE_TOKEN\") || \"system-admin-key\";\n \n // System mode can be activated by either AWS secret key or system mode token\n const isSystemMode = (awsSecretKey && token === awsSecretKey) || \n (token === systemModeToken);\n \n if (isSystemMode) {\n // SURGICAL CHANGE: Generate namespace from original token \n // This ensures consistent namespace across modes\n const systemNamespace = this.tokenToNamespace(originalToken);\n return { \n namespace: systemNamespace, // Use generated namespace instead of hardcoded \"system\"\n isDemo: false, \n isSystemMode: true,\n originalToken // Optionally store original token for additional context\n };\n }\n \n // Generate namespace from token\n const namespace = this.tokenToNamespace(token);\n \n return { namespace, isDemo: false, isSystemMode: false };\n }\n\n /**\n * Extract AWS secret key from request for AWS operations\n * Returns null if not authenticated or invalid format\n */\n extractAWSCredentials(request: Request): string | null {\n const authHeader = request.headers.get(\"Authorization\");\n \n if (!authHeader?.startsWith(\"Bearer \")) {\n return null;\n }\n \n const token = authHeader.substring(7).trim();\n \n if (!token) {\n return null;\n }\n \n return token;\n }\n\n /**\n * Convert token to namespace identifier\n * Uses a simple hash for now, can be enhanced with lookup tables\n */\n private tokenToNamespace(token: string): string {\n // Simple hash function for namespace generation\n let hash = 0;\n for (let i = 0; i < token.length; i++) {\n const char = token.charCodeAt(i);\n hash = ((hash << 5) - hash) + char;\n hash = hash & hash; // Convert to 32-bit integer\n }\n \n // Create a readable namespace identifier\n const hashStr = Math.abs(hash).toString(36);\n return `ns_${hashStr}`;\n }\n\n /**\n * Validate if a namespace has access to perform operations\n * System mode has access to all operations including system tools\n */\n validateAccess(namespace: string, operation: string, isSystemMode: boolean = false): boolean {\n // System mode has access to everything\n if (isSystemMode) {\n return true;\n }\n \n // Demo namespace has limited access (could add restrictions here)\n if (namespace === \"demo\") {\n return true; // Allow demo operations for now\n }\n \n // All other namespaces have full access to their own data\n return true;\n }\n\n /**\n * Check if the current context has system-level access\n */\n hasSystemAccess(authContext: ExtendedAuthContext): boolean {\n return authContext.isSystemMode === true;\n }\n}",[],[99,419,412],"auth","369e7652-4d55-11f0-a716-76b3cceeab13",["D",1750368883229],[275],[99,419],["D",1750368883229],[274,276,278,281,285,294],[99],["D",1749490372788],{"_11":12,"_221":217},{"_11":12,"_215":-5,"_216":217,"_189":190,"_218":219,"_220":49},{"_41":56,"_13":16,"_32":57,"_39":40,"_43":33,"_44":58,"_59":51,"_60":40,"_61":54,"_55":14,"_52":12},"ctx",{"_210":-5,"_241":464,"_465":466,"_467":468,"_469":49,"_470":49,"_471":49,"_472":26,"_473":-5,"_474":-7,"_475":-7,"_476":20,"_477":49,"_478":49,"_479":-5,"_480":49,"_481":49,"_482":49,"_483":-5},"ENV",{"_435":436,"_437":438,"_439":38,"_440":441,"_442":443,"_444":445,"_446":447,"_448":449,"_450":451,"_452":453,"_454":455,"_456":457,"_458":459,"_460":461,"_462":463},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","fdb67791413f4386b4dbf18f354029a617f6160f","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"]

Compare

Mergedevintomain

README.md+57-0

src/mcp/handler.ts+8-1

src/tools/definitions.ts+82-1

src/tools/handlers/index.ts+2-1

src/tools/handlers/openai-tools.ts+55-0