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