feat: enhance filesystem support with bind mount entries and update package structure (#1361)

Author: chickenlj

agentscope-dependencies-bom/pom.xml

@@ -112,6 +112,8 @@
         <kotlin.version>1.9.24</kotlin.version>
         <kotlin.coroutines.version>1.10.2</kotlin.coroutines.version>
         <jgit.version>7.6.0.202603022253-r</jgit.version>
+        <fabric8.kubernetes-client.version>6.13.4</fabric8.kubernetes-client.version>
+        <protobuf.java.version>4.29.3</protobuf.java.version>
 
         <spotless.version>3.4.0</spotless.version>
         <maven-gpg-plugin.version>3.2.8</maven-gpg-plugin.version>
@@ -142,6 +144,21 @@
                 <scope>import</scope>
             </dependency>
 
+            <!-- Fabric8 Kubernetes client -->
+            <dependency>
+                <groupId>io.fabric8</groupId>
+                <artifactId>kubernetes-client-bom</artifactId>
+                <version>${fabric8.kubernetes-client.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+
+            <dependency>
+                <groupId>com.google.protobuf</groupId>
+                <artifactId>protobuf-java</artifactId>
+                <version>${protobuf.java.version}</version>
+            </dependency>
+
             <!-- Reactor -->
             <dependency>
                 <groupId>io.projectreactor</groupId>

agentscope-examples/harness-examples/harness-example-remote/src/main/java/io/agentscope/examples/harness/remote/DataAgentService.java

@@ -24,7 +24,7 @@
 import io.agentscope.examples.harness.remote.data.SqliteTool;
 import io.agentscope.harness.agent.HarnessAgent;
 import io.agentscope.harness.agent.IsolationScope;
-import io.agentscope.harness.agent.filesystem.RemoteFilesystemSpec;
+import io.agentscope.harness.agent.filesystem.spec.RemoteFilesystemSpec;
 import io.agentscope.harness.agent.store.InMemoryStore;
 import jakarta.annotation.PostConstruct;
 import java.io.InputStream;

agentscope-examples/harness-examples/harness-example-remote/src/main/java/io/agentscope/examples/harness/remote/HarnessRemoteApplication.java

@@ -15,6 +15,7 @@
  */
 package io.agentscope.examples.harness.remote;
 
+import io.agentscope.harness.agent.filesystem.spec.RemoteFilesystemSpec;
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 
@@ -23,7 +24,7 @@
  *
  * <p>Set {@code DASHSCOPE_API_KEY}. Default port {@code 8788} (see {@code application.properties}).
  *
- * <p>This module demonstrates {@link io.agentscope.harness.agent.filesystem.RemoteFilesystemSpec}
+ * <p>This module demonstrates {@link RemoteFilesystemSpec}
  * ({@code docs/zh/harness/filesystem.md} <strong>模式一</strong>). Sandbox (<strong>模式二</strong>)
  * is {@code harness-example-sandbox}.
  */

agentscope-examples/harness-examples/harness-example-remote/src/main/java/io/agentscope/examples/harness/remote/WorkspaceClasspathMaterializer.java

@@ -15,6 +15,7 @@
  */
 package io.agentscope.examples.harness.remote;
 
+import io.agentscope.harness.agent.filesystem.spec.RemoteFilesystemSpec;
 import java.io.IOException;
 import java.io.InputStream;
 import java.io.UncheckedIOException;
@@ -26,7 +27,7 @@
 
 /**
  * Copies {@code classpath:workspace/...} into a temp directory used as the local side of the
- * composite workspace for {@link io.agentscope.harness.agent.filesystem.RemoteFilesystemSpec}.
+ * composite workspace for {@link RemoteFilesystemSpec}.
  */
 public final class WorkspaceClasspathMaterializer {
 

agentscope-examples/harness-examples/harness-example-sandbox/src/main/java/io/agentscope/examples/harness/sandbox/support/InMemorySandbox.java

@@ -15,6 +15,7 @@
  */
 package io.agentscope.examples.harness.sandbox.support;
 
+import io.agentscope.core.agent.RuntimeContext;
 import io.agentscope.harness.agent.sandbox.ExecResult;
 import io.agentscope.harness.agent.sandbox.Sandbox;
 import io.agentscope.harness.agent.sandbox.SandboxState;
@@ -110,7 +111,8 @@ public SandboxState getState() {
     }
 
     @Override
-    public ExecResult exec(String command, Integer timeoutSeconds) throws Exception {
+    public ExecResult exec(RuntimeContext runtimeContext, String command, Integer timeoutSeconds)
+            throws Exception {
         int timeout = timeoutSeconds != null ? timeoutSeconds : defaultTimeoutSeconds;
         ProcessBuilder pb = new ProcessBuilder("sh", "-c", command);
         pb.directory(workspaceDir.toFile());

agentscope-examples/harness-examples/harness-example-sandbox/src/main/java/io/agentscope/examples/harness/sandbox/support/InMemorySandboxFilesystemSpec.java

@@ -15,10 +15,10 @@
  */
 package io.agentscope.examples.harness.sandbox.support;
 
+import io.agentscope.harness.agent.filesystem.spec.SandboxFilesystemSpec;
 import io.agentscope.harness.agent.sandbox.SandboxClient;
 import io.agentscope.harness.agent.sandbox.SandboxClientOptions;
 import io.agentscope.harness.agent.sandbox.WorkspaceSpec;
-import io.agentscope.harness.agent.sandbox.filesystem.SandboxFilesystemSpec;
 import io.agentscope.harness.agent.sandbox.snapshot.SandboxSnapshotSpec;
 
 /**

agentscope-examples/harness-examples/harness-sandbox-docker/src/main/java/io/agentscope/examples/harness/sandbox/DockerPythonSandboxExample.java

@@ -25,9 +25,9 @@
 import io.agentscope.core.model.DashScopeChatModel;
 import io.agentscope.core.model.Model;
 import io.agentscope.harness.agent.HarnessAgent;
+import io.agentscope.harness.agent.filesystem.spec.DockerFilesystemSpec;
+import io.agentscope.harness.agent.filesystem.spec.SandboxFilesystemSpec;
 import io.agentscope.harness.agent.sandbox.SandboxDistributedOptions;
-import io.agentscope.harness.agent.sandbox.filesystem.DockerFilesystemSpec;
-import io.agentscope.harness.agent.sandbox.filesystem.SandboxFilesystemSpec;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;

agentscope-harness/pom.xml

@@ -61,5 +61,21 @@
             <artifactId>aliyun-sdk-oss</artifactId>
             <version>3.18.5</version>
         </dependency>
+
+        <!-- Optional sandbox backends (io.agentscope.harness.agent.sandbox.impl.*) -->
+        <dependency>
+            <groupId>io.fabric8</groupId>
+            <artifactId>kubernetes-client</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>com.google.protobuf</groupId>
+            <artifactId>protobuf-java</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>io.fabric8</groupId>
+            <artifactId>kubernetes-server-mock</artifactId>
+            <scope>test</scope>
+        </dependency>
     </dependencies>
 </project>