feat(adk/backend): implement Agentkit Sandbox and Local filesystem backend adapters #651

zhuangjie1125 · 2026-01-15T08:18:19Z

feat(adk/backend): implement Agentkit Sandbox and Local filesystem backend adapters

Introduces two new backend implementations for the adk/backend filesystem interface
to support flexible file operations in different execution environments: a remote
Agentkit Sandbox backend for secure isolated execution and a local backend for direct
filesystem access.

Agentkit Sandbox Backend

Implements filesystem.Backend interface to integrate with Volcengine's Agentkit Sandbox API
Provides secure remote code execution with request signing using HMAC-SHA256
Manages session lifecycle with automatic token refresh and expiration handling
Supports all core filesystem operations: LsInfo, Read, Write, Edit, GrepRaw, GlobInfo
Includes Python code templates for sandbox execution with proper error handling
Defines comprehensive API types for request/response structures

Local Backend (local)

Implements filesystem.Backend interface for direct local filesystem operations
Supports directory listing (LsInfo) with configurable depth and ignore patterns
Provides file reading (Read) with line-based pagination (offset/limit support)
Enables file writing (Write) with automatic directory creation
Implements content search (GrepRaw) with regex pattern matching
Supports glob pattern matching (GlobInfo) for file discovery
Includes robust input validation (absolute path enforcement, permission checks)

Testing & Documentation

Adds comprehensive unit tests for both backends (323 lines for agentkit, 700 lines for local)
Provides detailed README documentation with usage examples and API references
Includes example implementations demonstrating backend and middleware integration
Updates dependency management (go.mod/go.sum) with required packages

Technical Details

Total additions: 4,216 lines across 16 files
Both backends implement the same filesystem.Backend interface for consistency
Error handling follows Go conventions with wrapped errors for context
Middleware examples demonstrate authentication and logging patterns

adk/backend/local/local.go

adk/backend/agentkit/code_template.go

adk/backend/agentkit/sandbox.go

adk/backend/agentkit/types.go

adk/backend/agentkit/sandbox.go

adk/backend/agentkit/code_template.go

…ckend adapters Introduces two new backend implementations for the adk/backend filesystem interface to support flexible file operations in different execution environments: a remote Agentkit Sandbox backend for secure isolated execution and a local backend for direct filesystem access. **Agentkit Sandbox Backend ** - Implements filesystem.Backend interface to integrate with Volcengine's Agentkit Sandbox API - Provides secure remote code execution with request signing using HMAC-SHA256 - Manages session lifecycle with automatic token refresh and expiration handling - Supports all core filesystem operations: LsInfo, Read, Write, Edit, GrepRaw, GlobInfo - Includes Python code templates for sandbox execution with proper error handling - Defines comprehensive API types for request/response structures **Local Backend (local)** - Implements filesystem.Backend interface for direct local filesystem operations - Supports directory listing (LsInfo) with configurable depth and ignore patterns - Provides file reading (Read) with line-based pagination (offset/limit support) - Enables file writing (Write) with automatic directory creation - Implements content search (GrepRaw) with regex pattern matching - Supports glob pattern matching (GlobInfo) for file discovery - Includes robust input validation (absolute path enforcement, permission checks) **Testing & Documentation** - Adds comprehensive unit tests for both backends (323 lines for agentkit, 700 lines for local) - Provides detailed README documentation with usage examples and API references - Includes example implementations demonstrating backend and middleware integration - Updates dependency management (go.mod/go.sum) with required packages **Technical Details** - Total additions: 4,216 lines across 16 files - Both backends implement the same filesystem.Backend interface for consistency - Error handling follows Go conventions with wrapped errors for context - Middleware examples demonstrate authentication and logging patterns

zhuangjie1125 force-pushed the feat/adk_filesystem branch 10 times, most recently from bb495e0 to 67e24fb Compare January 19, 2026 06:27

zhuangjie1125 changed the title ~~feat(adk/backend): implement arksandbox backend~~ feat(adk/backend): implement both Ark Sandbox and Local filesystem backends Jan 19, 2026

zhuangjie1125 force-pushed the feat/adk_filesystem branch 4 times, most recently from 83ea7b9 to ff469d8 Compare January 20, 2026 09:19

zhuangjie1125 force-pushed the feat/adk_filesystem branch 9 times, most recently from 040bf38 to 71388a9 Compare January 29, 2026 08:43

zhuangjie1125 changed the title ~~feat(adk/backend): implement both Ark Sandbox and Local filesystem backends~~ feat(adk/backend): implement Agentkit Sandbox and Local filesystem backend adapters Jan 29, 2026

zhuangjie1125 force-pushed the feat/adk_filesystem branch from 43df9e9 to 0dc6242 Compare January 30, 2026 02:25

meguminnnnnnnnn reviewed Feb 2, 2026

View reviewed changes

adk/backend/agentkit/sandbox.go Outdated Show resolved Hide resolved

meguminnnnnnnnn reviewed Feb 3, 2026

View reviewed changes