⭐ Key Features

• Function Creation: Create and deploy serverless JavaScript/TypeScript functions (vals) directly from agent conversations
• Code Execution: Run vals with parameters and get real-time results
• Val Discovery: Search and browse existing vals across the Val Town platform
• Serverless Automation: Build APIs, scheduled tasks, and automation workflows without infrastructure management

🧭 Use case examples

---

⚙️ Admin : Setup in Dust

Go to Spaces > Administration > Tools in your Dust workspace, click Add Tools, and select Val Town.

Authentication

Val Town’s REST API supports Bearer Token authentication. You can create and manage your Val Town API tokens on the API Tokens page. In order to use all available tools, the token will need read and write permissions for vals.

Your Val Town API token must be stored as a Dust developer secret. Go to Admin -> Builder Tools Management -> Secrets, and select Create Secret to store your Val Town API token.

User : Usage in Dust

Once the tool has been configured by the admin as described before, it can be selected on any agent. In the Agent Builder, simply click on Add Tool and select Val Town. You will be required to select a developer secret that will be used as a bearer token for all API calls.

Available Tools

Create Val

Creates a new val in Val Town. Use create_file to add files to the val.

Get Val

Gets a specific val by its ID

List Vals

Lists vals available to the user's account

Search Vals

Searches for vals by name, description, or content

List Val Files

Lists all files in a specific val

Get File Content

Gets the content of a specific file in a val using the Val Town API

Delete File

Deletes a specific file from a val using the Val Town API

Update File Content

Updates the content of a specific file in a val. Note: To change file type (e.g., to HTTP), use the file_update tool instead.

Write File

The primary function for writing content to files and updating file metadata. Use this to add content, change file type, rename files, or move files. For HTTP type: return value from serve handler must be a response or a promise resolving to a response.

Create File

Creates a new empty file in an existing val. Use write_file to add content and set the file type.

Call Http Endpoint

Runs an HTTP val endpoint by getting the file's endpoint link and making a request to it