Overview
Tool Name
Purpose
The storage_manager tool centralizes long-term file storage. List and search libraries, rename and move files, create folders, and clean up space with safety controls like confirmations and optional backups.Key Features & Functions
Browse Persistent Storage
Explore directories and files with filters for path, name, type, and date.
Search at Scale
Find files by name, content, or metadata with result limits and scoring.
Organize & Rename
Restructure folders and rename files to keep libraries clean.
Move & Create
Move batches of files and create directories with parent auto-creation.
Monitor Usage
Retrieve storage usage and quota details for planning and governance.
Clean Up Safely
Delete with confirmations and optional backups to avoid accidental loss.
Start with LIST_FILES or SEARCH_FILES to scope changes, then organize with RENAME_FILE, MOVE_FILES, or DELETE_FILES.
Input Parameters for Each Function
All operations are routed through_storage_manager with an action value.
LIST_FILES
Parameters
| Name | Definition | Format |
|---|---|---|
| directory_path | Directory to list. Defaults to the storage root. | String |
| file_pattern | Filename pattern to match. | String |
| recursive | Include subdirectories when listing. | Boolean |
| sort_by | Sort criteria: name, size, date, type. | String |
| limit | Max number of files to return. | Integer |
SEARCH_FILES
Parameters
| Name | Definition | Format |
|---|---|---|
| search_query | Terms or criteria to search for. | String |
| search_type | name, content, metadata, or all. | String |
| file_types | Restrict to extensions or MIME groups. | Array |
| date_range | Filter by modified date range. | Object |
| size_range | Filter by file size range. | Object |
| max_results | Max results to return. | Integer |
Use
search_type = "metadata" when you have rich tags or attributes indexed for your files.RENAME_FILE
Parameters
| Name | Definition | Format |
|---|---|---|
| current_path | Full current file path. | String |
| new_name | New filename to assign. | String |
| preserve_extension | Keep the original extension. | Boolean |
MOVE_FILES
Parameters
| Name | Definition | Format |
|---|---|---|
| source_paths | One or more files to move. | Array |
| destination_directory | Target directory. | String |
| overwrite_existing | Replace files if they exist at destination. | Boolean |
CREATE_DIRECTORY
Parameters
| Name | Definition | Format |
|---|---|---|
| directory_path | Path for the new directory. | String |
| create_parents | Auto-create missing parent folders. | Boolean |
DELETE_FILES
Parameters
| Name | Definition | Format |
|---|---|---|
| file_paths | Files to delete. | Array |
| confirm_deletion | Must be true to proceed. | Boolean |
| backup_before_delete | Create a backup before deletion. | Boolean |
GET_STORAGE_INFO
Parameters
| Name | Definition | Format |
|---|---|---|
| include_usage | Include current usage stats. | Boolean |
| include_quotas | Include quota information. | Boolean |
Use Cases
- Manage long-term archives of reports and analysis outputs for future reference.
- Organize mission documentation and assets into shared, persistent libraries.
- Clean up obsolete or duplicate files to free space across projects.
- Search historical data files and notebooks for research and audits.
- Keep backup copies of critical configuration files and templates.
- Publish shared resources and templates for reuse across teams.
- Maintain compliant archives for governance and audit needs.
Workflow/How It Works
- Discover with
LIST_FILESorSEARCH_FILESto identify targets. - Organize using
RENAME_FILE,MOVE_FILES, andCREATE_DIRECTORY. - Govern by checking
GET_STORAGE_INFOfor usage and quotas. - Clean up with
DELETE_FILESusing confirmations and optional backups. - Repeat as libraries evolve, using filters to keep operations focused.
Integration Relevance
- file_manager_tools for end-to-end lifecycle management and attachments.
- project_manager_tools to align storage with missions and todos.
- artifact_manager_tools to archive generated outputs.
- document_index_tools to index stored documents for semantic search.
- git_action when versioning stored files or promoting templates.
Deletions are destructive. Set
confirm_deletion = true only after you have reviewed the target list, and enable backup_before_delete for critical content.Configuration Details
- Use consistent path separators and naming conventions across teams.
- Tailor
file_pattern, date, and size filters to reduce result sets. - Ensure directory creation follows your organization’s structure and permissions.
- Apply backups for regulated or business-critical content before bulk changes.
- Align sort and limit options with UI or API consumer expectations.
Limitations or Notes
- File deletion is permanent unless a backup is created first.
- Large operations can take time and may consume significant resources.
- Search speed depends on indexing and storage size.
- Access and visibility follow workspace permissions and security policies.
- Quotas may block writes or moves if free space is low.
- Network or remote storage can affect latency and reliability.
- Concurrent operations may conflict and require retries.
Output
- Listings
Arrays of files with name, size, type, modified date, and path. - Search Results
Matched files with relevance scoring and snippets. - Rename or Move
Confirmations with old and new paths. - Create Directory
Confirmation with path and permissions. - Delete
Confirmation with optional backup reference. - Storage Info
Usage and quota metrics for capacity planning. - Errors
Actionable messages for permission, path, or conflict issues.