add S3 upload tool for sandbox attachments

[hezhefly]

新增功能：为 sandbox 模块的添加了S3上传功能
代码参考：参考oss_storage.py；
依赖说明：新增boto3（AWS S3 官方 SDK）作为基础依赖

[rayrayraykk]

Please see the inline comments, thanks!

[Copilot]

Pull Request Overview

This PR adds S3 support to the sandbox module's file storage system, expanding storage options beyond the existing local and OSS systems.

Key changes:

• Added S3 as a new file system option alongside existing local and OSS storage
• Implemented complete S3Storage class with upload/download functionality and MD5-based file change detection
• Extended configuration models to include S3-specific settings (endpoint, credentials, bucket, region)

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/agentscope_runtime/sandbox/model/manager_config.py	Added S3 configuration fields and validation logic
src/agentscope_runtime/sandbox/manager/storage/s3_storage.py	New S3Storage implementation with boto3 integration
src/agentscope_runtime/sandbox/manager/storage/init.py	Added S3Storage to module exports
src/agentscope_runtime/sandbox/manager/server/config.py	Added S3 settings to server configuration
src/agentscope_runtime/sandbox/manager/server/app.py	Integrated S3 configuration parameters
src/agentscope_runtime/sandbox/manager/sandbox_manager.py	Added S3 storage initialization logic

Comments suppressed due to low confidence (1)

src/agentscope_runtime/sandbox/manager/storage/s3_storage.py:1

• The validation logic doesn't include s3_endpoint_url in the required fields check, but it's marked as required in the field description. Consider adding it to the validation or updating the field description to clarify when it's optional.

# -*- coding: utf-8 -*-

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[rayrayraykk]

And please format your code according to linter: https://github.com/agentscope-ai/agentscope-runtime/actions/runs/18395483723/job/52892764605?pr=113

[hezhefly]

@rayrayraykk 您好！已完成所有评审建议的修复：

1. 移除了 s3_storage.py 中不必要的 sys.path 修改；
2. 重构了 S3 配置字段的验证逻辑，提升可读性；
3. 优化了 ETag 格式判断，避免 multipart 上传场景下的文件对比错误；
4. 在 pyproject.toml 中添加了 boto3 依赖；
5. 修复了 Linter 报错，通过 pre-commit 检查；
6. 解决了与 main 分支的冲突（pyproject.toml、app.py）。
   请帮忙再次评审，谢谢！

[rayrayraykk]

Could you please update the tutorial in Cookbook accordingly, thanks!

[rayrayraykk]

And the pre-commit check still failed: https://github.com/agentscope-ai/agentscope-runtime/actions/runs/18590217929/job/53231232759?pr=113 . Please follow the instruction to format your code: https://runtime.agentscope.io/zh/contribute.html#id7 (e.g., pre-commit run --all-files).

[hezhefly]

Could you please update the tutorial in Cookbook accordingly, thanks!

done!

[hezhefly]

And the pre-commit check still failed: https://github.com/agentscope-ai/agentscope-runtime/actions/runs/18590217929/job/53231232759?pr=113 . Please follow the instruction to format your code: https://runtime.agentscope.io/zh/contribute.html#id7 (e.g., pre-commit run --all-files).

done!

[cla-assistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
0 out of 2 committers have signed the CLA.

❌ Weicheng WC4 He
❌ hezhefly

---

Weicheng WC4 He seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}