test-wuying-agentbay-sdk 0.13.1-beta.20251223155807 → 0.13.1-beta.20251223194518

package/docs/api/codespace/code.md

@@ -21,10 +21,52 @@ Handles code execution operations in the AgentBay cloud environment.
 
 ### Methods
 
+- [execute](#execute)
+- [run](#run)
 - [runCode](#runcode)
 
 ## Methods
 
+### execute
+
+▸ **execute**(`code`, `language`, `timeoutS?`): `Promise`\<`CodeExecutionResult`\>
+
+Alias of runCode().
+
+#### Parameters
+
+| Name | Type | Default value |
+| :------ | :------ | :------ |
+| `code` | `string` | `undefined` |
+| `language` | `string` | `undefined` |
+| `timeoutS` | `number` | `60` |
+
+#### Returns
+
+`Promise`\<`CodeExecutionResult`\>
+
+___
+
+### run
+
+▸ **run**(`code`, `language`, `timeoutS?`): `Promise`\<`CodeExecutionResult`\>
+
+Alias of runCode().
+
+#### Parameters
+
+| Name | Type | Default value |
+| :------ | :------ | :------ |
+| `code` | `string` | `undefined` |
+| `language` | `string` | `undefined` |
+| `timeoutS` | `number` | `60` |
+
+#### Returns
+
+`Promise`\<`CodeExecutionResult`\>
+
+___
+
 ### runCode
 
 ▸ **runCode**(`code`, `language`, `timeoutS?`): `Promise`\<`CodeExecutionResult`\>
@@ -37,7 +79,7 @@ Corresponds to Python's run_code() method
 | Name | Type | Default value | Description |
 | :------ | :------ | :------ | :------ |
 | `code` | `string` | `undefined` | The code to execute. |
-| `language` | `string` | `undefined` | The programming language of the code. Must be either 'python' or 'javascript'. |
+| `language` | `string` | `undefined` | The programming language of the code. Case-insensitive. Supported values: 'python', 'javascript', 'r', 'java'. |
 | `timeoutS` | `number` | `60` | The timeout for the code execution in seconds. Default is 60s. Note: Due to gateway limitations, each request cannot exceed 60 seconds. |
 
 #### Returns

package/docs/api/common-features/basics/command.md

@@ -16,10 +16,33 @@ Handles command execution operations in the AgentBay cloud environment.
 
 ### Methods
 
+- [exec](#exec)
 - [executeCommand](#executecommand)
+- [run](#run)
 
 ## Methods
 
+### exec
+
+▸ **exec**(`command`, `timeoutMs?`, `cwd?`, `envs?`): `Promise`\<`CommandResult`\>
+
+Alias of executeCommand().
+
+#### Parameters
+
+| Name | Type | Default value |
+| :------ | :------ | :------ |
+| `command` | `string` | `undefined` |
+| `timeoutMs` | `number` | `1000` |
+| `cwd?` | `string` | `undefined` |
+| `envs?` | `Record`\<`string`, `string`\> | `undefined` |
+
+#### Returns
+
+`Promise`\<`CommandResult`\>
+
+___
+
 ### executeCommand
 
 ▸ **executeCommand**(`command`, `timeoutMs?`, `cwd?`, `envs?`): `Promise`\<`CommandResult`\>
@@ -84,6 +107,27 @@ if (result.success) {
 }
 ```
 
+___
+
+### run
+
+▸ **run**(`command`, `timeoutMs?`, `cwd?`, `envs?`): `Promise`\<`CommandResult`\>
+
+Alias of executeCommand().
+
+#### Parameters
+
+| Name | Type | Default value |
+| :------ | :------ | :------ |
+| `command` | `string` | `undefined` |
+| `timeoutMs` | `number` | `1000` |
+| `cwd?` | `string` | `undefined` |
+| `envs?` | `Record`\<`string`, `string`\> | `undefined` |
+
+#### Returns
+
+`Promise`\<`CommandResult`\>
+
 ## Best Practices
 
 1. Always specify appropriate timeout values based on expected command duration

package/docs/api/common-features/basics/filesystem.md

@@ -12,16 +12,23 @@ Handles file operations in the AgentBay cloud environment.
 ### Methods
 
 - [createDirectory](#createdirectory)
+- [delete](#delete)
 - [deleteFile](#deletefile)
 - [downloadFile](#downloadfile)
 - [editFile](#editfile)
+- [list](#list)
 - [listDirectory](#listdirectory)
+- [ls](#ls)
 - [moveFile](#movefile)
+- [read](#read)
 - [readFile](#readfile)
 - [readMultipleFiles](#readmultiplefiles)
+- [remove](#remove)
+- [rm](#rm)
 - [searchFiles](#searchfiles)
 - [uploadFile](#uploadfile)
 - [watchDirectory](#watchdirectory)
+- [write](#write)
 - [writeFile](#writefile)
 
 ## Methods
@@ -59,6 +66,24 @@ if (result.success) {
 
 ___
 
+### delete
+
+▸ **delete**(`path`): `Promise`\<`BoolResult`\>
+
+Alias of deleteFile().
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `path` | `string` |
+
+#### Returns
+
+`Promise`\<`BoolResult`\>
+
+___
+
 ### deleteFile
 
 ▸ **deleteFile**(`path`): `Promise`\<`BoolResult`\>
@@ -170,6 +195,24 @@ if (result.success) {
 }
 ```
 
+### list
+
+▸ **list**(`path`): `Promise`\<`DirectoryListResult`\>
+
+Alias of listDirectory().
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `path` | `string` |
+
+#### Returns
+
+`Promise`\<`DirectoryListResult`\>
+
+___
+
 ### listDirectory
 
 ▸ **listDirectory**(`path`): `Promise`\<`DirectoryListResult`\>
@@ -218,6 +261,24 @@ if (result.success) {
 
 ___
 
+### ls
+
+▸ **ls**(`path`): `Promise`\<`DirectoryListResult`\>
+
+Alias of listDirectory().
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `path` | `string` |
+
+#### Returns
+
+`Promise`\<`DirectoryListResult`\>
+
+___
+
 ### moveFile
 
 ▸ **moveFile**(`source`, `destination`): `Promise`\<`BoolResult`\>
@@ -253,6 +314,24 @@ if (result.success) {
 
 ___
 
+### read
+
+▸ **read**(`path`): `Promise`\<`FileContentResult`\>
+
+Alias of readFile().
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `path` | `string` |
+
+#### Returns
+
+`Promise`\<`FileContentResult`\>
+
+___
+
 ### readFile
 
 ▸ **readFile**(`path`): `Promise`\<`FileContentResult`\>
@@ -350,6 +429,42 @@ if (result.success) {
 
 ___
 
+### remove
+
+▸ **remove**(`path`): `Promise`\<`BoolResult`\>
+
+Alias of deleteFile().
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `path` | `string` |
+
+#### Returns
+
+`Promise`\<`BoolResult`\>
+
+___
+
+### rm
+
+▸ **rm**(`path`): `Promise`\<`BoolResult`\>
+
+Alias of deleteFile().
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `path` | `string` |
+
+#### Returns
+
+`Promise`\<`BoolResult`\>
+
+___
+
 ### searchFiles
 
 ▸ **searchFiles**(`path`, `pattern`, `excludePatterns?`): `Promise`\<`FileSearchResult`\>
@@ -465,6 +580,26 @@ if (result.success) {
 
 ___
 
+### write
+
+▸ **write**(`path`, `content`, `mode?`): `Promise`\<`BoolResult`\>
+
+Alias of writeFile().
+
+#### Parameters
+
+| Name | Type | Default value |
+| :------ | :------ | :------ |
+| `path` | `string` | `undefined` |
+| `content` | `string` | `undefined` |
+| `mode` | `string` | `"overwrite"` |
+
+#### Returns
+
+`Promise`\<`BoolResult`\>
+
+___
+
 ### writeFile
 
 ▸ **writeFile**(`path`, `content`, `mode?`): `Promise`\<`BoolResult`\>

package/docs/api/common-features/basics/session-params.md

@@ -67,7 +67,7 @@ ___
 
 • `Optional` **enableBrowserReplay**: `boolean`
 
-Whether to enable browser recording for the session. Defaults to undefined (use default behavior, enabled by default).
+Whether to enable browser recording for the session. Defaults to true.
 
 #### Implementation of
 

package/docs/api/common-features/basics/session.md

@@ -12,6 +12,12 @@ Represents a session in the AgentBay cloud environment.
 ### Properties
 
 
+### Accessors
+
+- [files](#files)
+- [filesystem](#filesystem)
+- [fs](#fs)
+
 ### Methods
 
 - [callMcpTool](#callmcptool)
@@ -48,6 +54,42 @@ token: `string` = `""`
 ```
 
 
+## Accessors
+
+### files
+
+• `get` **files**(): [`FileSystem`](filesystem.md)
+
+Alias of fileSystem.
+
+#### Returns
+
+[`FileSystem`](filesystem.md)
+
+___
+
+### filesystem
+
+• `get` **filesystem**(): [`FileSystem`](filesystem.md)
+
+Alias of fileSystem.
+
+#### Returns
+
+[`FileSystem`](filesystem.md)
+
+___
+
+### fs
+
+• `get` **fs**(): [`FileSystem`](filesystem.md)
+
+Alias of fileSystem.
+
+#### Returns
+
+[`FileSystem`](filesystem.md)
+
 ## Methods
 
 ### callMcpTool

package/docs/examples/README.md

@@ -30,7 +30,9 @@ examples/
 ├── mobile-use/                    # Mobile UI automation (mobile_latest)
 │   └── mobile-get-adb-url/        # ADB URL retrieval
 └── codespace/                     # Code execution (code_latest)
-    └── automation/                # Automation workflows
+    ├── automation/                # Automation workflows
+    ├── enhanced_code/             # Enhanced runCode() output (logs/results/error)
+    └── jupyter_context_persistence_r_java/ # Jupyter-like context persistence for R and Java
 ```
 
 ## 🚀 Quick Start
@@ -261,6 +263,8 @@ await browser.close();
 
 **Code Execution:**
 - Automation: `codespace/automation/automation-example.ts`
+- Enhanced code result: `codespace/enhanced_code/index.ts`
+- Jupyter-like context persistence (R/Java): `codespace/jupyter_context_persistence_r_java/index.ts`
 
 **Data Management:**
 - File operations: `common-features/basics/filesystem-example/filesystem-example.ts`

package/docs/examples/codespace/automation/automation-example.ts

@@ -3,7 +3,7 @@
  *
  * This example demonstrates how to use AgentBay SDK automation features in codespace environment, including:
  * - Command execution
- * - Code execution (Python and JavaScript)
+ * - Code execution (Python, JavaScript, R, and Java)
  * - Workflow orchestration
  */
 

package/docs/examples/codespace/jupyter_context_persistence_r_java/index.ts

@@ -0,0 +1,85 @@
+/**
+ * AgentBay SDK - Jupyter Context Persistence (R & Java) Example (TypeScript)
+ *
+ * This example demonstrates that consecutive `session.code.runCode()` calls within the same
+ * session can share an execution context (Jupyter-like behavior) for R and Java, so variables
+ * defined in one call can be reused in subsequent calls.
+ */
+
+import { AgentBay } from "wuying-agentbay-sdk";
+
+async function main(): Promise<void> {
+  const apiKey = process.env.AGENTBAY_API_KEY;
+  if (!apiKey) {
+    console.error("Error: AGENTBAY_API_KEY environment variable not set");
+    process.exit(1);
+  }
+
+  const agentBay = new AgentBay({ apiKey });
+  const sessionResult = await agentBay.create({ imageId: "code_latest" });
+  if (!sessionResult.success || !sessionResult.session) {
+    throw new Error(`Failed to create session: ${sessionResult.errorMessage}`);
+  }
+
+  const session = sessionResult.session;
+  console.log(`Session created: ${session.sessionId}`);
+
+  try {
+    console.log("\n===== R: Jupyter-like context persistence =====");
+    const rSetup = `
+x <- 41
+cat("R_CONTEXT_SETUP_DONE\\n")
+`.trim();
+    const rSetupRes = await session.code.runCode(rSetup, "R");
+    if (!rSetupRes.success) {
+      throw new Error(`R setup failed: ${rSetupRes.errorMessage}`);
+    }
+    console.log(rSetupRes.result);
+
+    const rUse = `cat(paste0("R_CONTEXT_VALUE:", x + 1, "\\n"))\n`;
+    const rUseRes = await session.code.runCode(rUse, "r");
+    if (!rUseRes.success) {
+      throw new Error(`R context use failed: ${rUseRes.errorMessage}`);
+    }
+    console.log(rUseRes.result);
+
+    if (!rUseRes.result.includes("R_CONTEXT_VALUE:42")) {
+      throw new Error("R context persistence verification failed");
+    }
+
+    console.log("\n===== Java: Jupyter-like context persistence =====");
+    const javaSetup = `
+int x = 41;
+System.out.println("JAVA_CONTEXT_SETUP_DONE");
+`.trim();
+    const javaSetupRes = await session.code.runCode(javaSetup, "JAVA");
+    if (!javaSetupRes.success) {
+      throw new Error(`Java setup failed: ${javaSetupRes.errorMessage}`);
+    }
+    console.log(javaSetupRes.result);
+
+    const javaUse = `System.out.println("JAVA_CONTEXT_VALUE:" + (x + 1));\n`;
+    const javaUseRes = await session.code.runCode(javaUse, "java");
+    if (!javaUseRes.success) {
+      throw new Error(`Java context use failed: ${javaUseRes.errorMessage}`);
+    }
+    console.log(javaUseRes.result);
+
+    if (!javaUseRes.result.includes("JAVA_CONTEXT_VALUE:42")) {
+      throw new Error("Java context persistence verification failed");
+    }
+  } finally {
+    await session.delete();
+  }
+}
+
+if (require.main === module) {
+  main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+  });
+}
+
+export { main };
+
+

package/docs/examples/common-features/basics/command-example/command-example.ts

@@ -40,7 +40,7 @@ async function main() {
     log('\n1. Executing simple shell command (echo)...');
     try {
       const echoCommand = "echo 'Hello from AgentBay SDK!'";
-      const echoResponse = await session.command.executeCommand(echoCommand);
+      const echoResponse = await session.command.run(echoCommand);
       log(`Echo command output:\n${echoResponse.output}`);
       log(`Execute Command RequestId: ${echoResponse.requestId}`);
     } catch (error) {
@@ -52,7 +52,7 @@ async function main() {
     try {
       const lsCommand = "ls -la /etc";
       const timeoutMs = 5000; // 5 seconds timeout
-      const lsResponse = await session.command.executeCommand(lsCommand, timeoutMs);
+      const lsResponse = await session.command.run(lsCommand, timeoutMs);
       log(`Directory listing (first few lines):\n${truncateOutput(lsResponse.output, 5)}`);
       log(`Execute Command with Timeout RequestId: ${lsResponse.requestId}`);
     } catch (error) {
@@ -72,7 +72,7 @@ print("Working with numbers in Python:")
 for i in range(1, 6):
     print(f"{i} squared is {i*i}")
 `;
-      const pythonResponse = await session.code.runCode(pythonCode, "python");
+      const pythonResponse = await session.code.run(pythonCode, "python");
       log(`Python code output:\n${pythonResponse.result}`);
       log(`Run Python Code RequestId: ${pythonResponse.requestId}`);
 
@@ -104,7 +104,7 @@ const sum = numbers.reduce((total, n) => total + n, 0);
 console.log("Sum of array:", sum);
 `;
       const timeoutS = 10; // 10 seconds timeout
-      const jsResponse = await session.code.runCode(jsCode, "javascript", timeoutS);
+      const jsResponse = await session.code.run(jsCode, "javascript", timeoutS);
       log(`JavaScript code output:\n${jsResponse.result}`);
       log(`Run JavaScript Code RequestId: ${jsResponse.requestId}`);
     } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "test-wuying-agentbay-sdk",
-  "version": "0.13.1-beta.20251223155807",
+  "version": "0.13.1-beta.20251223194518",
   "description": "TypeScript SDK for interacting with the Wuying AgentBay cloud runtime environment",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",