af5fbfabec
- Context_Engineering.md: 에이전트 컨텍스트 엔지니어링 개념 정리 문서 추가 - Context_Engineering_Research.ipynb: 연구 노트북 업데이트 - deepagents_sourcecode/: docstring과 주석을 한국어로 번역
126 lines
4.3 KiB
Python
126 lines
4.3 KiB
Python
"""Daytona 샌드박스 백엔드 구현입니다.
|
|
|
|
Daytona sandbox backend implementation.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import TYPE_CHECKING
|
|
|
|
from deepagents.backends.protocol import (
|
|
ExecuteResponse,
|
|
FileDownloadResponse,
|
|
FileUploadResponse,
|
|
)
|
|
from deepagents.backends.sandbox import BaseSandbox
|
|
|
|
if TYPE_CHECKING:
|
|
from daytona import Sandbox
|
|
|
|
|
|
class DaytonaBackend(BaseSandbox):
|
|
"""Daytona backend implementation conforming to SandboxBackendProtocol.
|
|
|
|
This implementation inherits all file operation methods from BaseSandbox
|
|
and only implements the execute() method using Daytona's API.
|
|
"""
|
|
|
|
def __init__(self, sandbox: Sandbox) -> None:
|
|
"""Initialize the DaytonaBackend with a Daytona sandbox client.
|
|
|
|
Args:
|
|
sandbox: Daytona sandbox instance
|
|
"""
|
|
self._sandbox = sandbox
|
|
self._timeout: int = 30 * 60 # 30 mins
|
|
|
|
@property
|
|
def id(self) -> str:
|
|
"""Unique identifier for the sandbox backend."""
|
|
return self._sandbox.id
|
|
|
|
def execute(
|
|
self,
|
|
command: str,
|
|
) -> ExecuteResponse:
|
|
"""Execute a command in the sandbox and return ExecuteResponse.
|
|
|
|
Args:
|
|
command: Full shell command string to execute.
|
|
|
|
Returns:
|
|
ExecuteResponse with combined output, exit code, optional signal, and truncation flag.
|
|
"""
|
|
result = self._sandbox.process.exec(command, timeout=self._timeout)
|
|
|
|
return ExecuteResponse(
|
|
output=result.result, # Daytona combines stdout/stderr
|
|
exit_code=result.exit_code,
|
|
truncated=False,
|
|
)
|
|
|
|
def download_files(self, paths: list[str]) -> list[FileDownloadResponse]:
|
|
"""Download multiple files from the Daytona sandbox.
|
|
|
|
Leverages Daytona's native batch download API for efficiency.
|
|
Supports partial success - individual downloads may fail without
|
|
affecting others.
|
|
|
|
Args:
|
|
paths: List of file paths to download.
|
|
|
|
Returns:
|
|
List of FileDownloadResponse objects, one per input path.
|
|
Response order matches input order.
|
|
|
|
Note: Daytona API 에러 문자열을 표준화된 FileOperationError 코드로 매핑하는 작업은
|
|
추후 보완합니다.
|
|
현재는 정상(happy path) 위주로만 구현되어 있습니다.
|
|
"""
|
|
from daytona import FileDownloadRequest
|
|
|
|
# Create batch download request using Daytona's native batch API
|
|
download_requests = [FileDownloadRequest(source=path) for path in paths]
|
|
daytona_responses = self._sandbox.fs.download_files(download_requests)
|
|
|
|
# Convert Daytona results to our response format
|
|
# NOTE: resp.error를 표준화된 error code로 매핑하는 작업은 추후 보완합니다.
|
|
return [
|
|
FileDownloadResponse(
|
|
path=resp.source,
|
|
content=resp.result,
|
|
error=None, # NOTE: resp.error -> FileOperationError 매핑은 추후 보완
|
|
)
|
|
for resp in daytona_responses
|
|
]
|
|
|
|
def upload_files(self, files: list[tuple[str, bytes]]) -> list[FileUploadResponse]:
|
|
"""Upload multiple files to the Daytona sandbox.
|
|
|
|
Leverages Daytona's native batch upload API for efficiency.
|
|
Supports partial success - individual uploads may fail without
|
|
affecting others.
|
|
|
|
Args:
|
|
files: List of (path, content) tuples to upload.
|
|
|
|
Returns:
|
|
List of FileUploadResponse objects, one per input file.
|
|
Response order matches input order.
|
|
|
|
Note: Daytona API 에러 문자열을 표준화된 FileOperationError 코드로 매핑하는 작업은
|
|
추후 보완합니다.
|
|
현재는 정상(happy path) 위주로만 구현되어 있습니다.
|
|
"""
|
|
from daytona import FileUpload
|
|
|
|
# Create batch upload request using Daytona's native batch API
|
|
upload_requests = [
|
|
FileUpload(source=content, destination=path) for path, content in files
|
|
]
|
|
self._sandbox.fs.upload_files(upload_requests)
|
|
|
|
# NOTE: Daytona가 error 정보를 제공하는 경우, FileOperationError 코드로 매핑하는 작업은
|
|
# 추후 보완합니다.
|
|
return [FileUploadResponse(path=path, error=None) for path, _ in files]
|