Workspace

---
name: workspace
description: Read and write files in the shared session workspace. Use this to access files created by any skill — code-agent outputs, office documents, images, and more. All within the same isolated session.
---

# Workspace

Provides unified read/write access to all files in the current session. The `userId` and `sessionId` are injected automatically — you only specify the logical path.

## Path Conventions

| Prefix | What it accesses |
|--------|-----------------|
| `code-agent/<file>` | Files created by the code agent (auto-synced) |
| `code-interpreter/<file>` | Files saved by code interpreter via `output_filename` |
| `documents/powerpoint/<file>` | PowerPoint presentations |
| `documents/word/<file>` | Word documents |
| `documents/excel/<file>` | Excel spreadsheets |
| `documents/image/<file>` | Images from other tools |

> **Note:** Code interpreter only saves to workspace when `output_filename` is set in `execute_code`. Files from `execute_command` or `file_operations` stay inside the sandbox.

## Usage

**See everything in the session:**
```
workspace_list()
workspace_list("code-agent/")
```

**Read a file the code agent created:**
```
workspace_read("code-agent/calculator.png")   # binary → base64
workspace_read("code-agent/report.md")        # text → string
```

**Pass a file from one skill to another:**
```
result = workspace_read("documents/excel/data.xlsx")   # encoding: base64
workspace_write("code-agent/data.xlsx", result["content"], encoding="base64")
```

## Notes

- Text files return `encoding: "text"` with plain string content
- Binary files (images, Office docs, PDF, etc.) return `encoding: "base64"`
- `workspace_write` accepts both encodings — use `"base64"` for binary
- Files written here are immediately available to all other skills in the session

## UI Guidance (from tools-config)

**Path conventions (userId/sessionId injected automatically):**
- `code-agent/<file>` — files from the code agent
- `documents/powerpoint/<file>` — PowerPoint
- `documents/word/<file>` — Word
- `documents/excel/<file>` — Excel
- `documents/image/<file>` — images

**Binary vs text:** images/PDFs/Office files are returned base64-encoded (`encoding: "base64"`); use the same encoding when writing them back.