Tool VFS
v1.0.1
What's new
See LOPs 0.1.1 Full changelog →
Tool VFS v1.0.1 [ September 2, 2025 ]
- New virtual file system operator for agent communication
- File operations without touching actual filesystem
- Operations tracking table with timestamp and status
- Menu cleanup and unnecessary parameter removal
Overview
Section titled “Overview”The Tool VFS (Virtual File System) operator provides a sandboxed environment for agents to perform file operations without touching the actual filesystem. It enables agents to read, write, list, search, and delete files within a virtual workspace, making it a safe and powerful tool for a wide range of applications.
Requirements
Section titled “Requirements”- ChatTD Operator: Required for logging.
Parameters
Section titled “Parameters”Page: Settings
Section titled “Page: Settings” Tool Name (Toolname)
op('tool_vfs').par.Toolname
Str - Default:
file_tool
VirtualFile Component (Virtualfilecomponent)
op('tool_vfs').par.Virtualfilecomponent
COMP - Default:
None
Create External VirtualFile (Createifmissing)
op('tool_vfs').par.Createifmissing
Toggle - Default:
None
Source Folder (Sourcefolder)
op('tool_vfs').par.Sourcefolder
Folder - Default:
None
Load Folder (Loadfolder)
op('tool_vfs').par.Loadfolder
Pulse - Default:
None
Export Folder (Exportfolder)
op('tool_vfs').par.Exportfolder
Folder - Default:
None
Export All (Exportall)
op('tool_vfs').par.Exportall
Pulse - Default:
None
Clear All VFS (Clearall)
op('tool_vfs').par.Clearall
Pulse - Default:
None
Max Files (Maxfiles)
op('tool_vfs').par.Maxfiles
Int - Default:
100
Max File Size (MB) (Maxfilesize)
op('tool_vfs').par.Maxfilesize
Int - Default:
10
Allowed Extensions (Allowedextensions)
op('tool_vfs').par.Allowedextensions
Str - Default:
txt json md py js css html xml yml yaml log
Overwrite Existing Files (Overwriteexisting)
op('tool_vfs').par.Overwriteexisting
Toggle - Default:
None
Check VFS (Checkvfs)
op('tool_vfs').par.Checkvfs
Pulse - Default:
None
Page: Tool Toggles
Section titled “Page: Tool Toggles” Enable Operations (Enableoperations)
op('tool_vfs').par.Enableoperations
Toggle - Default:
None
Enable Read (Enableread)
op('tool_vfs').par.Enableread
Toggle - Default:
None
Enable Write (Enablewrite)
op('tool_vfs').par.Enablewrite
Toggle - Default:
None
Enable List (Enablelist)
op('tool_vfs').par.Enablelist
Toggle - Default:
None
Enable Search (Enablesearch)
op('tool_vfs').par.Enablesearch
Toggle - Default:
None
Enable Delete (Enabledelete)
op('tool_vfs').par.Enabledelete
Toggle - Default:
None
Enable Grab/Move (Enablegrab)
op('tool_vfs').par.Enablegrab
Toggle - Default:
None
Enable Context Injection (Enablecontext)
op('tool_vfs').par.Enablecontext
Toggle - Default:
None
Show Full Virtual Paths (Showvirtualpaths)
op('tool_vfs').par.Showvirtualpaths
Toggle - Default:
None
Page: About
Section titled “Page: About” Bypass (Bypass)
op('tool_vfs').par.Bypass
Toggle - Default:
None
Show Built-in Parameters (Showbuiltin)
op('tool_vfs').par.Showbuiltin
Toggle - Default:
None
Enable Logging (Enablelogging)
op('tool_vfs').par.Enablelogging
Toggle - Default:
None
Version (Version)
op('tool_vfs').par.Version
Str - Default:
None
Last Updated (Lastupdated)
op('tool_vfs').par.Lastupdated
Str - Default:
None
Creator (Creator)
op('tool_vfs').par.Creator
Str - Default:
None
Website (Website)
op('tool_vfs').par.Website
Str - Default:
None
ChatTD Operator (Chattd)
op('tool_vfs').par.Chattd
OP - Default:
None
Usage Examples
Section titled “Usage Examples”Basic Setup
Section titled “Basic Setup”- Create a
tool_vfs
operator. - Connect it to an
agent
operator. - The agent can now use the file operations as tools.
Loading Files from a Folder
Section titled “Loading Files from a Folder”- Set the
Source Folder
parameter to the folder you want to load. - Pulse the
Load Folder
parameter. - The files from the folder will be loaded into the virtual file system.
Agent Instruction Examples
Section titled “Agent Instruction Examples”"Use the file_tool to write a file named 'my_notes.txt' with the content 'Hello, world!'."
"Use the file_tool to list all the files in the virtual workspace."
"Use the file_tool to read the content of the file 'my_notes.txt'."