wuying-agentbay-sdk 0.11.0 → 0.13.0

package/docs/examples/browser-use/browser/run-2048.ts

@@ -6,35 +6,29 @@
  * - Utilize PageUseAgent to run 2048 game
  */
 
-import { AgentBay, CreateSessionParams } from '../../../../typescript/src/agent-bay';
-import { BrowserOption, ExtractOptions, ActOptions } from '../../../../typescript/src/browser';
-// import { chromium } from 'playwright';
-
-class GameState {
-  score?: number;
-  highestTile?: number;
-  grid: number[][] = [];
-}
+import { AgentBay, CreateSessionParams } from "wuying-agentbay-sdk";
+import { BrowserOption, ExtractOptions } from "wuying-agentbay-sdk";
+import { z } from "zod";
 
-class MoveAnalysis {
-  move?: number;
-  confidence: number = 0;
-  reasoning: string = "";
-}
+const GameStateSchema = z.object({
+  score: z.number().optional(),
+  highestTile: z.number().optional(),
+  grid: z.array(z.array(z.number())),
+});
 
 function transposeGrid(grid: number[][]): number[][] {
   if (!grid || grid.length === 0) {
     return [];
   }
-  return grid[0].map((_, colIndex) => grid.map(row => row[colIndex]));
+  return grid[0].map((_, colIndex) => grid.map((row) => row[colIndex]));
 }
 
 function formatGridForLlmInstruction(gridData: number[][]): string {
   const formattedRows: string[] = [];
   for (let i = 0; i < gridData.length; i++) {
-    formattedRows.push(`row${i + 1}: [${gridData[i].join(', ')}]`);
+    formattedRows.push(`row${i + 1}: [${gridData[i].join(", ")}]`);
   }
-  return formattedRows.join('\n');
+  return formattedRows.join("\n");
 }
 
 async function main() {
@@ -66,17 +60,17 @@ async function main() {
       console.log("endpoint_url =", endpointUrl);
 
       // Note: Install playwright with: npm install playwright
-      const { chromium } = require('playwright');
+      const { chromium } = require("playwright");
       const browser = await chromium.connectOverCDP(endpointUrl);
       let page = null;
 
       try {
-        const context = browser.contexts()[0]
+        const context = browser.contexts()[0];
         page = await context.newPage();
         console.log("🌐 Navigating to 2048...");
         await page.goto("https://ovolve.github.io/2048-AI/", {
           waitUntil: "domcontentloaded",
-          timeout: 180000
+          timeout: 180000,
         });
         console.log("🌐 Navigated to 2048 done");
         await page.waitForSelector(".grid-container", { timeout: 10000 });
@@ -87,11 +81,11 @@ async function main() {
 
         while (true) {
           console.log("🔄 Game loop iteration...");
-          await new Promise(resolve => setTimeout(resolve, 300));
+          await new Promise((resolve) => setTimeout(resolve, 300));
 
           // Get current game state
           console.log("📊 Extracting game state...");
-          const gameStateOptions: ExtractOptions<GameState> = {
+          const gameStateOptions: ExtractOptions<typeof GameStateSchema> = {
             instruction: `
               Extract the current game state:
               1. Score from the score counter
@@ -105,20 +99,25 @@ async function main() {
                  For instance, if the only tiles present are the two above, the grid should be:[[0, 0, 0, 2], [0, 0, 0, 0], [0, 0, 0, 0], [2, 0, 0, 0]]
               3. Highest tile value present
             `,
-            schema: GameState,
-            use_text_extract: false
-
+            schema: GameStateSchema,
+            use_text_extract: false,
           };
 
-          const [success, gameStates] = await session.browser.agent.extract(gameStateOptions, page);
-          if (success && gameStates.length > 0) {
-            const gameState = gameStates[0];
+          const [success, gameState] = await session.browser.agent.extract(
+            gameStateOptions,
+            page
+          );
+          if (success && gameState) {
             const transposedGrid = transposeGrid(gameState.grid);
             console.log(`transposed grid: ${JSON.stringify(transposedGrid)}`);
             console.log(`gameState: ${JSON.stringify(gameState)}`);
             const gridInstruction = formatGridForLlmInstruction(transposedGrid);
 
-            if (lastTransposedGrid !== null && JSON.stringify(transposedGrid) === JSON.stringify(lastTransposedGrid)) {
+            if (
+              lastTransposedGrid !== null &&
+              JSON.stringify(transposedGrid) ===
+                JSON.stringify(lastTransposedGrid)
+            ) {
               transposedGridNotChangedTimes += 1;
             } else {
               transposedGridNotChangedTimes = 0;
@@ -144,22 +143,33 @@ async function main() {
 
             if (transposedGridNotChangedTimes >= 1) {
               instructionStr += `
-                9. Do not generate move value in ${JSON.stringify(lastMoveHistory)}
-                10. If last move value ${lastMoveHistory[lastMoveHistory.length - 1]} moves up or down, then generate move value with left or right direction, otherwise generate move value with up or down direction
+                9. Do not generate move value in ${JSON.stringify(
+                  lastMoveHistory
+                )}
+                10. If last move value ${
+                  lastMoveHistory[lastMoveHistory.length - 1]
+                } moves up or down, then generate move value with left or right direction, otherwise generate move value with up or down direction
               `;
             }
 
-            const nextMoveOptions: ExtractOptions<MoveAnalysis> = {
+            const nextMoveOptions: ExtractOptions<any> = {
               instruction: instructionStr,
-              schema: MoveAnalysis,
-              use_text_extract: false
+              schema: z.object({
+                move: z.number().optional(),
+                confidence: z.number().optional(),
+                reasoning: z.string().optional(),
+              }),
+              use_text_extract: false,
             };
 
-            const [moveSuccess, nextMove] = await session.browser.agent.extract(nextMoveOptions, page);
+            const [moveSuccess, nextMove] = await session.browser.agent.extract(
+              nextMoveOptions,
+              page
+            );
             let selectedMove = 4; // Default to no move
 
-            if (moveSuccess && nextMove.length > 0) {
-              selectedMove = nextMove[0].move ?? 4;
+            if (moveSuccess && nextMove && typeof nextMove === "object") {
+              selectedMove = (nextMove as any).move ?? 4;
             } else {
               console.log("❌ Failed to extract next move, retry observing");
               continue;

package/docs/examples/browser-use/browser/run-sudoku.ts

@@ -6,20 +6,28 @@
  * - Utilize PageUseAgent to run sudoku game
  */
 
-import { AgentBay, CreateSessionParams,BrowserOption, ExtractOptions, ActOptions } from 'wuying-agentbay-sdk';
-
-import { chromium } from 'playwright';
-
-class SudokuBoard {
-  board: number[][] = [];
-}
-
-class SudokuSolution {
-  solution: number[][] = [];
-}
-
+import {
+  AgentBay,
+  CreateSessionParams,
+  BrowserOption,
+  ExtractOptions,
+  ActOptions,
+} from "wuying-agentbay-sdk";
+
+import { chromium } from "playwright";
+import { z } from "zod";
+
+const SudokuBoardSchema = z.object({
+  board: z.array(z.array(z.number())),
+});
+type SudokuBoardType = z.infer<typeof SudokuBoardSchema>;
+
+const SudokuSolutionSchema = z.object({
+  solution: z.array(z.array(z.number())),
+});
+type SudokuSolutionType = z.infer<typeof SudokuSolutionSchema>;
 function formatBoardForLlm(board: number[][]): string {
-  return board.map(row => `  [${row.join(', ')}]`).join('\n');
+  return board.map((row) => `  [${row.join(", ")}]`).join("\n");
 }
 
 async function main() {
@@ -52,7 +60,7 @@ async function main() {
 
       const browser = await chromium.connectOverCDP(endpointUrl);
       try {
-        const context = browser.contexts()[0]
+        const context = browser.contexts()[0];
         const page = await context.newPage();
         console.log("🌐 Navigating to Sudoku site...");
         const url = "https://widget.websudoku.com/";
@@ -65,27 +73,31 @@ async function main() {
 
         while (!success) {
           console.log("📊 Extracting sudoku board...");
-          const options: ExtractOptions<SudokuBoard> = {
-            instruction: "Extract the current sudoku board as a 9x9 array. Each cell should be a number (1-9) if filled, or 0 if empty.",
-            schema: SudokuBoard,
-            use_text_extract: false
+          const options: ExtractOptions<typeof SudokuBoardSchema> = {
+            instruction:
+              "Extract the current sudoku board as a 9x9 array. Each cell should be a number (1-9) if filled, or 0 if empty.",
+            schema: SudokuBoardSchema,
+            use_text_extract: false,
           };
 
-          const [extractSuccess, boardObjs] = await session.browser.agent.extract(options, page);
-          if (extractSuccess && boardObjs.length > 0) {
+          const [extractSuccess, boardObj] =
+            await session.browser.agent.extract(options, page);
+          if (extractSuccess && boardObj) {
             success = true;
-            board = boardObjs[0].board;
+            board = boardObj.board;
           } else {
             console.log("❌ Failed to extract sudoku board, retry extracting");
-            await new Promise(resolve => setTimeout(resolve, 3000));
+            await new Promise((resolve) => setTimeout(resolve, 3000));
           }
         }
 
-        console.log("Current Board:\n" + board.map(row => row.join(' ')).join('\n'));
-        const originalBoard = board.map(row => [...row]);
+        console.log(
+          "Current Board:\n" + board.map((row) => row.join(" ")).join("\n")
+        );
+        const originalBoard = board.map((row) => [...row]);
 
         // 2. Solve the sudoku
-        const solutionOptions: ExtractOptions<SudokuSolution> = {
+        const solutionOptions: ExtractOptions<typeof SudokuSolutionSchema> = {
           instruction: `You are an expert sudoku solver. Given the following sudoku board as a 9x9 array (0 means empty), solve the sudoku and return the completed 9x9 array as 'solution'.
 
 Sudoku rules:
@@ -103,39 +115,46 @@ Return:
 {
   solution: number[][] // 9x9, all filled, valid sudoku
 }`,
-          schema: SudokuSolution,
-          use_text_extract: false
+          schema: SudokuSolutionSchema,
+          use_text_extract: false,
         };
 
-        const [solutionSuccess, solutionObjs] = await session.browser.agent.extract(solutionOptions, page);
-        if (!solutionSuccess || solutionObjs.length === 0) {
+        const [solutionSuccess, solutionObj] =
+          await session.browser.agent.extract(solutionOptions, page);
+        if (!solutionSuccess || !solutionObj) {
           console.log("❌ Failed to solve sudoku");
           return;
         }
 
-        const solution = solutionObjs[0].solution;
-        console.log("Solved Board:\n" + solution.map((row:any) => row.join(' ')).join('\n'));
+        const solution = solutionObj.solution;
+        console.log(
+          "Solved Board:\n" +
+            solution.map((row: any) => row.join(" ")).join("\n")
+        );
 
         // 3. Fill the solution
         for (let row = 0; row < 9; row++) {
           for (let col = 0; col < 9; col++) {
             if (originalBoard[row][col] === 0) {
               const inputId = `f${col}${row}`;
-              console.log(`Type '${solution[row][col]}' into the cell with id '${inputId}'`);
+              console.log(
+                `Type '${solution[row][col]}' into the cell with id '${inputId}'`
+              );
 
               // Use the act method for natural language action
               const actOptions: ActOptions = {
-                action: `Enter '${solution[row][col]}' into the input element where the attribute id is exactly '${inputId}' (for example, if id='f53', you must match the full string 'f53', not just the number 53; do not split or extract numbers from the id)`
+                action: `Enter '${solution[row][col]}' into the input element where the attribute id is exactly '${inputId}' (for example, if id='f53', you must match the full string 'f53', not just the number 53; do not split or extract numbers from the id)`,
               };
 
               await session.browser.agent.act(actOptions, page);
-              await new Promise(resolve => setTimeout(resolve, 500));
+              await new Promise((resolve) => setTimeout(resolve, 500));
             }
           }
         }
 
-        console.log("✅ Finished! The board has been solved and filled in the browser.");
-
+        console.log(
+          "✅ Finished! The board has been solved and filled in the browser."
+        );
       } catch (error) {
         console.log(`❌ Error in game loop: ${error}`);
       }

package/docs/examples/browser-use/browser/screenshot-example.ts

@@ -75,8 +75,8 @@ async function main() {
     // console.log(`✅ Browser screenshot captured (${screenshotData.length} bytes)`);
     
     // Save the screenshot to a file
-    // await writeFile("browser_screenshot.png", Buffer.from(screenshotData));
-    // console.log("✅ Browser screenshot saved as browser_screenshot.png");
+    // await writeFile("temp_browser_screenshot.png", Buffer.from(screenshotData));
+// console.log("✅ Browser screenshot saved as temp_browser_screenshot.png");
     
     // Take a full page screenshot with custom options
     // const fullPageData = await session.browser.screenshot(
@@ -90,8 +90,8 @@ async function main() {
     // console.log(`✅ Browser full page screenshot captured (${fullPageData.length} bytes)`);
     
     // Save the full page screenshot
-    // await writeFile("browser_full_page_screenshot.jpg", Buffer.from(fullPageData));
-    // console.log("✅ Browser full page screenshot saved as browser_full_page_screenshot.jpg");
+    // await writeFile("temp_browser_full_page_screenshot.jpg", Buffer.from(fullPageData));
+// console.log("✅ Browser full page screenshot saved as temp_browser_full_page_screenshot.jpg");
     
     // Take a screenshot with custom viewport settings
     // const customScreenshot = await session.browser.screenshot(
@@ -105,8 +105,8 @@ async function main() {
     // console.log(`✅ Browser custom screenshot captured (${customScreenshot.length} bytes)`);
     
     // Save the custom screenshot
-    // await writeFile("browser_custom_screenshot.png", Buffer.from(customScreenshot));
-    // console.log("✅ Browser custom screenshot saved as browser_custom_screenshot.png");
+    // await writeFile("temp_browser_custom_screenshot.png", Buffer.from(customScreenshot));
+// console.log("✅ Browser custom screenshot saved as temp_browser_custom_screenshot.png");
     
     await browser.close();
     

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

@@ -0,0 +1,86 @@
+import { AgentBay } from 'wuying-agentbay-sdk';
+
+async function main() {
+  const apiKey = process.env.AGENTBAY_API_KEY;
+  if (!apiKey) {
+    console.error("Please set AGENTBAY_API_KEY environment variable");
+    process.exit(1);
+  }
+
+  const agentBay = new AgentBay({ apiKey });
+
+  console.log("Creating session...");
+  const sessionResult = await agentBay.create({ imageId: "code_latest" });
+  if (!sessionResult.success || !sessionResult.session) {
+    console.error("Failed to create session:", sessionResult.errorMessage);
+    process.exit(1);
+  }
+
+  const session = sessionResult.session;
+  console.log(`Session created: ${session.sessionId}`);
+
+  try {
+    // 1. Logs Capture
+    console.log("\n--- Logs Capture Test ---");
+    const logsCode = `
+import sys
+print("This goes to stdout")
+print("This goes to stderr", file=sys.stderr)
+`;
+    const logsResult = await session.code.runCode(logsCode, "python");
+    printResult(logsResult);
+
+    // 2. Rich Output (HTML)
+    console.log("\n--- Rich Output (HTML) Test ---");
+    const htmlCode = `
+from IPython.display import display, HTML
+display(HTML("<h1>Hello from AgentBay</h1>"))
+`;
+    const htmlResult = await session.code.runCode(htmlCode, "python");
+    printResult(htmlResult);
+
+    // 3. Error Handling
+    console.log("\n--- Error Handling Test ---");
+    const errorCode = `
+raise ValueError("Something went wrong")
+`;
+    const errorResult = await session.code.runCode(errorCode, "python");
+    printResult(errorResult);
+
+  } finally {
+    console.log("\nCleaning up...");
+    await session.delete();
+  }
+}
+
+function printResult(result: any) {
+  if (result.success) {
+    console.log("Success: true");
+    if (result.logs) {
+      if (result.logs.stdout.length > 0) {
+        console.log("Stdout:", JSON.stringify(result.logs.stdout));
+      }
+      if (result.logs.stderr.length > 0) {
+        console.log("Stderr:", JSON.stringify(result.logs.stderr));
+      }
+    }
+    if (result.results) {
+      console.log("Results count:", result.results.length);
+      result.results.forEach((item: any, index: number) => {
+        const types = Object.keys(item).filter(k => k !== 'isMainResult');
+        console.log(`Result [${index}] types:`, types.join(", "));
+        if (item.text) console.log(`  Text: ${item.text.substring(0, 50)}...`);
+        if (item.html) console.log(`  HTML: ${item.html.substring(0, 50)}...`);
+      });
+    }
+  } else {
+    console.log("Success: false");
+    console.log("Error Message:", result.errorMessage);
+    if (result.error) {
+      console.log("Error Details:", JSON.stringify(result.error));
+    }
+  }
+}
+
+main().catch(console.error);
+

package/docs/examples/common-features/advanced/agent-module-example.ts

@@ -33,7 +33,7 @@ async function main() {
       const taskDescription = "Calculate the square root of 144";
       console.log(`Executing task: ${taskDescription}`);
       
-      const executionResult = await session.agent.executeTask(taskDescription, 5);
+      const executionResult = await session.agent.computer.executeTask(taskDescription, 5);
       
       if (executionResult.success) {
         console.log("Task completed successfully!");

package/docs/examples/common-features/advanced/archive-upload-mode-example/README.md

@@ -45,7 +45,7 @@ const contextSync = newContextSync(
 ### Session Creation with Context Sync
 
 ```typescript
-const sessionParams: CreateSessionParams = {
+const sessionParams = {
   labels: {
     example: `archive-mode-${uniqueId}`,
     type: "archive-upload-demo",

package/docs/examples/common-features/advanced/archive-upload-mode-example/archive-upload-mode-example.ts

@@ -1,4 +1,4 @@
-import { AgentBay, CreateSessionParams, Session, newContextSync, newSyncPolicy, FileSystem } from "wuying-agentbay-sdk";
+import { AgentBay, CreateSessionParams, Session, newContextSync, newSyncPolicy, FileSystem, UploadMode } from "wuying-agentbay-sdk";
 
 /**
  * Archive Upload Mode Context Sync Example
@@ -57,10 +57,9 @@ async function archiveUploadModeExample(): Promise<void> {
     // Step 2: Configure sync policy with Archive upload mode
     console.log("\n⚙️  Step 2: Configuring sync policy with Archive upload mode...");
     const syncPolicy = newSyncPolicy();
-    syncPolicy.uploadPolicy!.uploadMode = "Archive"; // Set to Archive mode
-    
-    console.log(`✅ Sync policy configured with uploadMode: ${syncPolicy.uploadPolicy!.uploadMode}`);
+    syncPolicy.uploadPolicy!.uploadMode = UploadMode.Archive;
 
+    console.log(`✅ Sync policy configured with uploadMode: ${syncPolicy.uploadPolicy!.uploadMode}`);
     // Step 3: Create context sync configuration
     console.log("\n🔧 Step 3: Creating context sync configuration...");
     const contextSync = newContextSync(
@@ -76,7 +75,7 @@ async function archiveUploadModeExample(): Promise<void> {
 
     // Step 4: Create session with Archive mode context sync
     console.log("\n🏗️  Step 4: Creating session with Archive mode context sync...");
-    const sessionParams: CreateSessionParams = {
+    const sessionParams = {
       labels: {
         example: `archive-mode-${uniqueId}`,
         type: "archive-upload-demo",
@@ -173,7 +172,7 @@ async function archiveUploadModeExample(): Promise<void> {
     console.log("\n🎉 Archive upload mode example completed successfully!");
     console.log("✅ All operations completed without errors.");
 
-  } catch (error) {
+   } catch (error) {
     console.error("\n❌ Error occurred during example execution:");
     console.error(error);
   } finally {

package/docs/examples/common-features/basics/archive-upload-mode-example/README.md

@@ -48,7 +48,7 @@ const contextSync = newContextSync(
 ### Session Creation with Context Sync
 
 ```typescript
-const sessionParams: CreateSessionParams = {
+const sessionParams = {
   labels: {
     example: `archive-mode-${uniqueId}`,
     type: "archive-upload-demo",

package/docs/examples/common-features/basics/archive-upload-mode-example/main.ts

@@ -76,7 +76,7 @@ async function archiveUploadModeExample(): Promise<void> {
 
     // Step 4: Create session with Archive mode context sync
     console.log("\n🏗️  Step 4: Creating session with Archive mode context sync...");
-    const sessionParams: CreateSessionParams = {
+    const sessionParams = {
       labels: {
         example: `archive-mode-${uniqueId}`,
         type: "archive-upload-demo",

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

@@ -145,6 +145,19 @@ async function main() {
     } catch (error) {
       log(`Error moving file: ${error}`);
     }
+
+    // 9. Delete file
+    log(`\nDeleting file: ${newFilePath}`);
+    try {
+      const deleteResponse = await session.fileSystem.deleteFile(newFilePath);
+      log(`File deleted successfully: ${deleteResponse.success}`);
+      log(`Delete File RequestId: ${deleteResponse.requestId}`);
+
+      const infoAfterDelete = await session.fileSystem.getFileInfo(newFilePath);
+      log(`Get File Info After Delete: success=${infoAfterDelete.success}`);
+    } catch (error) {
+      log(`Error deleting file: ${error}`);
+    }
   } finally {
     // Clean up by deleting the session when we're done
     log('\nDeleting the session...');

package/docs/examples/common-features/basics/filesystem-example/filesystem-filetransfer-example.ts

@@ -30,7 +30,7 @@ async function main() {
     const createResponse = await agentBay.create({
       imageId: 'code_latest'
     });
-    
+
     if (!createResponse.success || !createResponse.session) {
       log(`Failed to create session: ${createResponse.errorMessage}`);
       return;
@@ -39,13 +39,12 @@ async function main() {
     const session = createResponse.session;
     log(`\nSession created with ID: ${session.sessionId}`);
     log(`Create Session RequestId: ${createResponse.requestId}`);
-    log(`Session fileTransferContextId: ${session.fileTransferContextId}`);
 
     try {
       // 1. Upload a file
       const remotePath = '/tmp/file_transfer_test/uploaded-file.txt';
       log(`\nUploading file from ${localUploadPath} to ${remotePath}`);
-      
+
       // Create the remote directory first
       const dirPath = path.dirname(remotePath);
       const createDirResult = await session.fileSystem.createDirectory(dirPath);
@@ -69,7 +68,7 @@ async function main() {
         log(`Bytes sent: ${uploadResult.bytesSent}`);
         log(`Request ID (upload URL): ${uploadResult.requestIdUploadUrl}`);
         log(`Request ID (sync): ${uploadResult.requestIdSync}`);
-        
+
         // Verify the file exists in remote location
         const listResult = await session.fileSystem.listDirectory(dirPath);
         if (listResult.success) {
@@ -87,7 +86,7 @@ async function main() {
       // 2. Create a file in the remote location for download
       const remoteDownloadPath = '/tmp/file_transfer_test/download-test.txt';
       const downloadContent = "This is a test file for AgentBay FileTransfer download functionality.\n".repeat(15);
-      
+
       log(`\nCreating remote file for download: ${remoteDownloadPath}`);
       const writeResult = await session.fileSystem.writeFile(remoteDownloadPath, downloadContent);
       if (writeResult.success) {
@@ -99,7 +98,7 @@ async function main() {
       // 3. Download the file
       const localDownloadPath = path.join(tempDir, 'downloaded-file.txt');
       log(`\nDownloading file from ${remoteDownloadPath} to ${localDownloadPath}`);
-      
+
       const downloadResult = await session.fileSystem.downloadFile(
         remoteDownloadPath,
         localDownloadPath,
@@ -115,7 +114,7 @@ async function main() {
         log(`Bytes received: ${downloadResult.bytesReceived}`);
         log(`Request ID (download URL): ${downloadResult.requestIdDownloadUrl}`);
         log(`Request ID (sync): ${downloadResult.requestIdSync}`);
-        
+
         // Verify downloaded file content
         const downloadedContent = fs.readFileSync(localDownloadPath, 'utf-8');
         if (downloadedContent === downloadContent) {

package/docs/examples/common-features/basics/filesystem-example/watch-directory-example.ts

@@ -25,7 +25,7 @@ async function main(): Promise<void> {
     console.log("✅ AgentBay client initialized");
 
     // Create session with code_latest ImageId
-    const sessionParams: CreateSessionParams = { imageId: "code_latest" };
+    const sessionParams = { imageId: "code_latest" };
     const sessionResult = await agentbay.create(sessionParams);
 
     if (!sessionResult.success) {

package/docs/examples/common-features/basics/session-pause-resume/README.md

@@ -0,0 +1,53 @@
+# Session Pause and Resume Example
+
+This example demonstrates how to pause and resume sessions using the Wuying AgentBay SDK. Pausing a session puts it into a dormant state, consuming fewer resources while maintaining its state. Resuming a session brings it back to an active state.
+
+## Features Demonstrated
+
+- Pausing and resuming sessions
+- Handling non-existent session operations
+- Using custom timeout and polling interval parameters
+- Checking session status before and after operations
+- Performing work in sessions before and after pause/resume cycles
+
+## Running the Example
+
+```bash
+cd session-pause-resume
+npx ts-node session-pause-resume.ts
+```
+
+Make sure you have set the `AGENTBAY_API_KEY` environment variable or replace the placeholder in the code with your actual API key.
+
+## Prerequisites
+
+- Node.js installed
+- TypeScript installed
+- ts-node installed (`npm install -g ts-node`)
+- Required dependencies installed (`npm install`)
+
+## Understanding Session States
+
+When working with pause and resume operations, sessions can be in different states:
+
+1. **RUNNING**: Session is active and ready to accept commands
+2. **PAUSING**: Session is transitioning to paused state
+3. **PAUSED**: Session is in dormant state, consuming fewer resources
+4. **RESUMING**: Session is transitioning back to running state
+
+The pause and resume operations are asynchronous, meaning they initiate the state transition and then poll for completion.
+
+## Best Practices
+
+1. **Always check operation results**: Verify that pause and resume operations succeeded
+2. **Handle errors gracefully**: Non-existent sessions and other errors should be handled appropriately
+3. **Use appropriate timeouts**: Custom timeout values can be used based on your specific requirements
+4. **Verify session state**: Check session status before and after operations to ensure expected behavior
+5. **Clean up resources**: Always delete sessions when done to avoid resource leaks
+
+## Use Cases
+
+- **Cost optimization**: Pause sessions during idle periods to reduce resource consumption
+- **Long-running workflows**: Suspend sessions overnight or during maintenance windows
+- **Development and testing**: Pause test environments when not actively working on them
+- **Batch processing**: Pause and resume processing jobs based on system load