> ## Documentation Index
> Fetch the complete documentation index at: https://docs.genesiscomputing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Storage Manager

> Browse, search, organize, and govern persistent files across the platform with a single storage interface.

## **Overview**

### **Tool Name**

```json theme={null}
storage_manager
```

### **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**

<Steps>
  <Step title="Browse Persistent Storage" icon="folder-open">
    Explore directories and files with filters for path, name, type, and date.
  </Step>

  <Step title="Search at Scale" icon="magnifying-glass">
    Find files by name, content, or metadata with result limits and scoring.
  </Step>

  <Step title="Organize & Rename" icon="sort">
    Restructure folders and rename files to keep libraries clean.
  </Step>

  <Step title="Move & Create" icon="files">
    Move batches of files and create directories with parent auto-creation.
  </Step>

  <Step title="Monitor Usage" icon="meter">
    Retrieve storage usage and quota details for planning and governance.
  </Step>

  <Step title="Clean Up Safely" icon="trash">
    Delete with confirmations and optional backups to avoid accidental loss.
  </Step>
</Steps>

<Tip>
  Start with **LIST\_FILES** or **SEARCH\_FILES** to scope changes, then organize with **RENAME\_FILE**, **MOVE\_FILES**, or **DELETE\_FILES**.
</Tip>

## **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 |

<Note>
  Use `search_type = "metadata"` when you have rich tags or attributes indexed for your files.
</Note>

### **`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**

1. Manage long-term archives of reports and analysis outputs for future reference.
2. Organize mission documentation and assets into shared, persistent libraries.
3. Clean up obsolete or duplicate files to free space across projects.
4. Search historical data files and notebooks for research and audits.
5. Keep backup copies of critical configuration files and templates.
6. Publish shared resources and templates for reuse across teams.
7. Maintain compliant archives for governance and audit needs.

## **Workflow/How It Works**

1. **Discover** with `LIST_FILES` or `SEARCH_FILES` to identify targets.
2. **Organize** using `RENAME_FILE`, `MOVE_FILES`, and `CREATE_DIRECTORY`.
3. **Govern** by checking `GET_STORAGE_INFO` for usage and quotas.
4. **Clean up** with `DELETE_FILES` using confirmations and optional backups.
5. **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.

<Warning>
  Deletions are destructive. Set `confirm_deletion = true` only after you have reviewed the target list, and enable `backup_before_delete` for critical content.
</Warning>

## **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**

1. File deletion is permanent unless a backup is created first.
2. Large operations can take time and may consume significant resources.
3. Search speed depends on indexing and storage size.
4. Access and visibility follow workspace permissions and security policies.
5. Quotas may block writes or moves if free space is low.
6. Network or remote storage can affect latency and reliability.
7. 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.