wuying-agentbay-sdk 0.11.0 → 0.12.0

package/dist/model-CNCGFWJH.cjs

@@ -0,0 +1,200 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkSL5GCAQEcjs = require('./chunk-SL5GCAQE.cjs');
+require('./chunk-4IPTHWLM.cjs');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.ApplyMqttTokenRequest = _chunkSL5GCAQEcjs.ApplyMqttTokenRequest; exports.ApplyMqttTokenResponse = _chunkSL5GCAQEcjs.ApplyMqttTokenResponse; exports.ApplyMqttTokenResponseBody = _chunkSL5GCAQEcjs.ApplyMqttTokenResponseBody; exports.ApplyMqttTokenResponseBodyData = _chunkSL5GCAQEcjs.ApplyMqttTokenResponseBodyData; exports.CallMcpToolRequest = _chunkSL5GCAQEcjs.CallMcpToolRequest; exports.CallMcpToolResponse = _chunkSL5GCAQEcjs.CallMcpToolResponse; exports.CallMcpToolResponseBody = _chunkSL5GCAQEcjs.CallMcpToolResponseBody; exports.ClearContextRequest = _chunkSL5GCAQEcjs.ClearContextRequest; exports.ClearContextResponse = _chunkSL5GCAQEcjs.ClearContextResponse; exports.ClearContextResponseBody = _chunkSL5GCAQEcjs.ClearContextResponseBody; exports.CreateMcpSessionRequest = _chunkSL5GCAQEcjs.CreateMcpSessionRequest; exports.CreateMcpSessionRequestPersistenceDataList = _chunkSL5GCAQEcjs.CreateMcpSessionRequestPersistenceDataList; exports.CreateMcpSessionResponse = _chunkSL5GCAQEcjs.CreateMcpSessionResponse; exports.CreateMcpSessionResponseBody = _chunkSL5GCAQEcjs.CreateMcpSessionResponseBody; exports.CreateMcpSessionResponseBodyData = _chunkSL5GCAQEcjs.CreateMcpSessionResponseBodyData; exports.CreateMcpSessionShrinkRequest = _chunkSL5GCAQEcjs.CreateMcpSessionShrinkRequest; exports.DeleteContextFileRequest = _chunkSL5GCAQEcjs.DeleteContextFileRequest; exports.DeleteContextFileResponse = _chunkSL5GCAQEcjs.DeleteContextFileResponse; exports.DeleteContextFileResponseBody = _chunkSL5GCAQEcjs.DeleteContextFileResponseBody; exports.DeleteContextRequest = _chunkSL5GCAQEcjs.DeleteContextRequest; exports.DeleteContextResponse = _chunkSL5GCAQEcjs.DeleteContextResponse; exports.DeleteContextResponseBody = _chunkSL5GCAQEcjs.DeleteContextResponseBody; exports.DescribeContextFilesRequest = _chunkSL5GCAQEcjs.DescribeContextFilesRequest; exports.DescribeContextFilesResponse = _chunkSL5GCAQEcjs.DescribeContextFilesResponse; exports.DescribeContextFilesResponseBody = _chunkSL5GCAQEcjs.DescribeContextFilesResponseBody; exports.GetAdbLinkRequest = _chunkSL5GCAQEcjs.GetAdbLinkRequest; exports.GetAdbLinkResponse = _chunkSL5GCAQEcjs.GetAdbLinkResponse; exports.GetAdbLinkResponseBody = _chunkSL5GCAQEcjs.GetAdbLinkResponseBody; exports.GetAdbLinkResponseBodyData = _chunkSL5GCAQEcjs.GetAdbLinkResponseBodyData; exports.GetCdpLinkRequest = _chunkSL5GCAQEcjs.GetCdpLinkRequest; exports.GetCdpLinkResponse = _chunkSL5GCAQEcjs.GetCdpLinkResponse; exports.GetCdpLinkResponseBody = _chunkSL5GCAQEcjs.GetCdpLinkResponseBody; exports.GetCdpLinkResponseBodyData = _chunkSL5GCAQEcjs.GetCdpLinkResponseBodyData; exports.GetContextFileDownloadUrlRequest = _chunkSL5GCAQEcjs.GetContextFileDownloadUrlRequest; exports.GetContextFileDownloadUrlResponse = _chunkSL5GCAQEcjs.GetContextFileDownloadUrlResponse; exports.GetContextFileDownloadUrlResponseBody = _chunkSL5GCAQEcjs.GetContextFileDownloadUrlResponseBody; exports.GetContextFileUploadUrlRequest = _chunkSL5GCAQEcjs.GetContextFileUploadUrlRequest; exports.GetContextFileUploadUrlResponse = _chunkSL5GCAQEcjs.GetContextFileUploadUrlResponse; exports.GetContextFileUploadUrlResponseBody = _chunkSL5GCAQEcjs.GetContextFileUploadUrlResponseBody; exports.GetContextInfoRequest = _chunkSL5GCAQEcjs.GetContextInfoRequest; exports.GetContextInfoResponse = _chunkSL5GCAQEcjs.GetContextInfoResponse; exports.GetContextInfoResponseBody = _chunkSL5GCAQEcjs.GetContextInfoResponseBody; exports.GetContextInfoResponseBodyData = _chunkSL5GCAQEcjs.GetContextInfoResponseBodyData; exports.GetContextRequest = _chunkSL5GCAQEcjs.GetContextRequest; exports.GetContextResponse = _chunkSL5GCAQEcjs.GetContextResponse; exports.GetContextResponseBody = _chunkSL5GCAQEcjs.GetContextResponseBody; exports.GetContextResponseBodyData = _chunkSL5GCAQEcjs.GetContextResponseBodyData; exports.GetLabelRequest = _chunkSL5GCAQEcjs.GetLabelRequest; exports.GetLabelResponse = _chunkSL5GCAQEcjs.GetLabelResponse; exports.GetLabelResponseBody = _chunkSL5GCAQEcjs.GetLabelResponseBody; exports.GetLabelResponseBodyData = _chunkSL5GCAQEcjs.GetLabelResponseBodyData; exports.GetLinkRequest = _chunkSL5GCAQEcjs.GetLinkRequest; exports.GetLinkResponse = _chunkSL5GCAQEcjs.GetLinkResponse; exports.GetLinkResponseBody = _chunkSL5GCAQEcjs.GetLinkResponseBody; exports.GetLinkResponseBodyData = _chunkSL5GCAQEcjs.GetLinkResponseBodyData; exports.GetMcpResourceRequest = _chunkSL5GCAQEcjs.GetMcpResourceRequest; exports.GetMcpResourceResponse = _chunkSL5GCAQEcjs.GetMcpResourceResponse; exports.GetMcpResourceResponseBody = _chunkSL5GCAQEcjs.GetMcpResourceResponseBody; exports.GetMcpResourceResponseBodyData = _chunkSL5GCAQEcjs.GetMcpResourceResponseBodyData; exports.GetMcpResourceResponseBodyDataDesktopInfo = _chunkSL5GCAQEcjs.GetMcpResourceResponseBodyDataDesktopInfo; exports.GetSessionRequest = _chunkSL5GCAQEcjs.GetSessionRequest; exports.GetSessionResponse = _chunkSL5GCAQEcjs.GetSessionResponse; exports.GetSessionResponseBody = _chunkSL5GCAQEcjs.GetSessionResponseBody; exports.GetSessionResponseBodyData = _chunkSL5GCAQEcjs.GetSessionResponseBodyData; exports.InitBrowserRequest = _chunkSL5GCAQEcjs.InitBrowserRequest; exports.InitBrowserResponse = _chunkSL5GCAQEcjs.InitBrowserResponse; exports.InitBrowserResponseBody = _chunkSL5GCAQEcjs.InitBrowserResponseBody; exports.InitBrowserResponseBodyData = _chunkSL5GCAQEcjs.InitBrowserResponseBodyData; exports.ListContextsRequest = _chunkSL5GCAQEcjs.ListContextsRequest; exports.ListContextsResponse = _chunkSL5GCAQEcjs.ListContextsResponse; exports.ListContextsResponseBody = _chunkSL5GCAQEcjs.ListContextsResponseBody; exports.ListContextsResponseBodyData = _chunkSL5GCAQEcjs.ListContextsResponseBodyData; exports.ListMcpToolsRequest = _chunkSL5GCAQEcjs.ListMcpToolsRequest; exports.ListMcpToolsResponse = _chunkSL5GCAQEcjs.ListMcpToolsResponse; exports.ListMcpToolsResponseBody = _chunkSL5GCAQEcjs.ListMcpToolsResponseBody; exports.ListSessionRequest = _chunkSL5GCAQEcjs.ListSessionRequest; exports.ListSessionResponse = _chunkSL5GCAQEcjs.ListSessionResponse; exports.ListSessionResponseBody = _chunkSL5GCAQEcjs.ListSessionResponseBody; exports.ListSessionResponseBodyData = _chunkSL5GCAQEcjs.ListSessionResponseBodyData; exports.ModifyContextRequest = _chunkSL5GCAQEcjs.ModifyContextRequest; exports.ModifyContextResponse = _chunkSL5GCAQEcjs.ModifyContextResponse; exports.ModifyContextResponseBody = _chunkSL5GCAQEcjs.ModifyContextResponseBody; exports.PauseSessionAsyncRequest = _chunkSL5GCAQEcjs.PauseSessionAsyncRequest; exports.PauseSessionAsyncResponse = _chunkSL5GCAQEcjs.PauseSessionAsyncResponse; exports.PauseSessionAsyncResponseBody = _chunkSL5GCAQEcjs.PauseSessionAsyncResponseBody; exports.ReleaseMcpSessionRequest = _chunkSL5GCAQEcjs.ReleaseMcpSessionRequest; exports.ReleaseMcpSessionResponse = _chunkSL5GCAQEcjs.ReleaseMcpSessionResponse; exports.ReleaseMcpSessionResponseBody = _chunkSL5GCAQEcjs.ReleaseMcpSessionResponseBody; exports.ResumeSessionAsyncRequest = _chunkSL5GCAQEcjs.ResumeSessionAsyncRequest; exports.ResumeSessionAsyncResponse = _chunkSL5GCAQEcjs.ResumeSessionAsyncResponse; exports.ResumeSessionAsyncResponseBody = _chunkSL5GCAQEcjs.ResumeSessionAsyncResponseBody; exports.SetLabelRequest = _chunkSL5GCAQEcjs.SetLabelRequest; exports.SetLabelResponse = _chunkSL5GCAQEcjs.SetLabelResponse; exports.SetLabelResponseBody = _chunkSL5GCAQEcjs.SetLabelResponseBody; exports.SyncContextRequest = _chunkSL5GCAQEcjs.SyncContextRequest; exports.SyncContextResponse = _chunkSL5GCAQEcjs.SyncContextResponse; exports.SyncContextResponseBody = _chunkSL5GCAQEcjs.SyncContextResponseBody;
+//# sourceMappingURL=model-CNCGFWJH.cjs.map

package/dist/{model-2G37RFQQ.cjs.map → model-CNCGFWJH.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/wuying-agentbay-sdk/wuying-agentbay-sdk/typescript/dist/model-2G37RFQQ.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,s6NAAC","file":"/home/runner/work/wuying-agentbay-sdk/wuying-agentbay-sdk/typescript/dist/model-2G37RFQQ.cjs"}
+{"version":3,"sources":["/home/runner/work/wuying-agentbay-sdk/wuying-agentbay-sdk/typescript/dist/model-CNCGFWJH.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,85OAAC","file":"/home/runner/work/wuying-agentbay-sdk/wuying-agentbay-sdk/typescript/dist/model-CNCGFWJH.cjs"}

package/dist/{model-ZFTLKEMC.mjs → model-LGWQJWKQ.mjs}

@@ -90,16 +90,22 @@ import {
   ModifyContextRequest,
   ModifyContextResponse,
   ModifyContextResponseBody,
+  PauseSessionAsyncRequest,
+  PauseSessionAsyncResponse,
+  PauseSessionAsyncResponseBody,
   ReleaseMcpSessionRequest,
   ReleaseMcpSessionResponse,
   ReleaseMcpSessionResponseBody,
+  ResumeSessionAsyncRequest,
+  ResumeSessionAsyncResponse,
+  ResumeSessionAsyncResponseBody,
   SetLabelRequest,
   SetLabelResponse,
   SetLabelResponseBody,
   SyncContextRequest,
   SyncContextResponse,
   SyncContextResponseBody
-} from "./chunk-E7QC5S76.mjs";
+} from "./chunk-BVWUCG4J.mjs";
 import "./chunk-KNEDRAP6.mjs";
 export {
   ApplyMqttTokenRequest,
@@ -184,9 +190,15 @@ export {
   ModifyContextRequest,
   ModifyContextResponse,
   ModifyContextResponseBody,
+  PauseSessionAsyncRequest,
+  PauseSessionAsyncResponse,
+  PauseSessionAsyncResponseBody,
   ReleaseMcpSessionRequest,
   ReleaseMcpSessionResponse,
   ReleaseMcpSessionResponseBody,
+  ResumeSessionAsyncRequest,
+  ResumeSessionAsyncResponse,
+  ResumeSessionAsyncResponseBody,
   SetLabelRequest,
   SetLabelResponse,
   SetLabelResponseBody,
@@ -194,4 +206,4 @@ export {
   SyncContextResponse,
   SyncContextResponseBody
 };
-//# sourceMappingURL=model-ZFTLKEMC.mjs.map
+//# sourceMappingURL=model-LGWQJWKQ.mjs.map

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

@@ -18,6 +18,8 @@ Main class for interacting with the AgentBay cloud runtime environment.
 - [delete](#delete)
 - [get](#get)
 - [list](#list)
+- [pauseAsync](#pauseasync)
+- [resumeAsync](#resumeasync)
 
 ## Properties
 
@@ -174,6 +176,100 @@ if (result.success) {
 }
 ```
 
+___
+
+### pauseAsync
+
+▸ **pauseAsync**(`session`, `timeout?`, `pollInterval?`): `Promise`\<`SessionPauseResult`\>
+
+Asynchronously pause a session, putting it into a dormant state.
+
+This method directly calls the PauseSessionAsync API without waiting for the session
+to reach the PAUSED state.
+
+#### Parameters
+
+| Name | Type | Default value | Description |
+| :------ | :------ | :------ | :------ |
+| `session` | [`Session`](session.md) | `undefined` | The session to pause. |
+| `timeout` | `number` | `600` | Timeout in seconds to wait for the session to pause. Defaults to 600 seconds. |
+| `pollInterval` | `number` | `2.0` | Interval in seconds between status polls. Defaults to 2.0 seconds. |
+
+#### Returns
+
+`Promise`\<`SessionPauseResult`\>
+
+SessionPauseResult indicating success or failure and request ID
+
+**`Example`**
+
+```typescript
+const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+const session = (await agentBay.create()).session;
+const pauseResult = await agentBay.pauseAsync(session);
+await agentBay.resumeAsync(session);
+await session.delete();
+```
+
+**`Remarks`**
+
+**Behavior:**
+- This method does not wait for the session to reach the PAUSED state
+- It only submits the pause request to the API
+- The session state transitions from RUNNING -> PAUSING -> PAUSED
+- Paused sessions consume fewer resources but maintain their state
+
+**`See`**
+
+[resumeAsync](#resumeasync), [Session.pauseAsync](session.md#pauseasync)
+
+___
+
+### resumeAsync
+
+▸ **resumeAsync**(`session`, `timeout?`, `pollInterval?`): `Promise`\<`SessionResumeResult`\>
+
+Asynchronously resume a session from a paused state.
+
+This method directly calls the ResumeSessionAsync API without waiting for the session
+to reach the RUNNING state.
+
+#### Parameters
+
+| Name | Type | Default value | Description |
+| :------ | :------ | :------ | :------ |
+| `session` | [`Session`](session.md) | `undefined` | The session to resume. |
+| `timeout` | `number` | `600` | Timeout in seconds to wait for the session to resume. Defaults to 600 seconds. |
+| `pollInterval` | `number` | `2.0` | Interval in seconds between status polls. Defaults to 2.0 seconds. |
+
+#### Returns
+
+`Promise`\<`SessionResumeResult`\>
+
+SessionResumeResult indicating success or failure and request ID
+
+**`Example`**
+
+```typescript
+const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+const session = (await agentBay.create()).session;
+await agentBay.pauseAsync(session);
+const resumeResult = await agentBay.resumeAsync(session);
+await session.delete();
+```
+
+**`Remarks`**
+
+**Behavior:**
+- This method does not wait for the session to reach the RUNNING state
+- It only submits the resume request to the API
+- The session state transitions from PAUSED -> RESUMING -> RUNNING
+- Only sessions in PAUSED state can be resumed
+
+**`See`**
+
+[pauseAsync](#pauseasync), [Session.resumeAsync](session.md#resumeasync)
+
 ## Related Resources
 
 - [Session API Reference](session.md)

package/docs/api/common-features/basics/context-manager.md

@@ -93,8 +93,8 @@ Synchronizes a context with the session. Supports both async and callback modes.
 
 | Name | Type | Default value | Description |
 | :------ | :------ | :------ | :------ |
-| `contextId?` | `string` | `undefined` | Optional context ID to synchronize |
-| `path?` | `string` | `undefined` | Optional path where the context should be mounted |
+| `contextId?` | `string` | `undefined` | Optional context ID to synchronize. If provided, `path` must also be provided. |
+| `path?` | `string` | `undefined` | Optional path where the context should be mounted. If provided, `contextId` must also be provided. |
 | `mode?` | `string` | `undefined` | Optional synchronization mode (e.g., "upload", "download") |
 | `callback?` | ``SyncCallback`` | `undefined` | Optional callback function. If provided, runs in background and calls callback when complete |
 | `maxRetries` | `number` | `150` | Maximum number of retries for polling completion status (default: 150) |
@@ -110,8 +110,27 @@ Promise resolving to ContextSyncResult with success status and request ID
 
 Error if the API call fails
 
+**`Throws`**
+
+Error if `contextId` or `path` is provided without the other parameter.
+              Both must be provided together, or both must be omitted.
+
+**`Example`**
+
+Sync all contexts (no parameters):
+```typescript
+const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+const result = await agentBay.create();
+if (result.success) {
+  const syncResult = await result.session.context.sync();
+  console.log(`Sync: ${syncResult.success}`);
+  await result.session.delete();
+}
+```
+
 **`Example`**
 
+Sync specific context with path:
 ```typescript
 const agentBay = new AgentBay({ apiKey: 'your_api_key' });
 const result = await agentBay.create();

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

@@ -21,6 +21,8 @@ Represents a session in the AgentBay cloud environment.
 - [getLinkAsync](#getlinkasync)
 - [info](#info)
 - [listMcpTools](#listmcptools)
+- [pauseAsync](#pauseasync)
+- [resumeAsync](#resumeasync)
 - [setLabels](#setlabels)
 
 ## Properties
@@ -368,6 +370,134 @@ if (result.success) {
 
 ___
 
+### pauseAsync
+
+▸ **pauseAsync**(`timeout?`, `pollInterval?`): `Promise`\<`SessionPauseResult`\>
+
+Asynchronously pause this session, putting it into a dormant state.
+
+This method calls the PauseSessionAsync API to initiate the pause operation and then polls
+the GetSession API to check the session status until it becomes PAUSED or until timeout is reached.
+During the paused state, resource usage and costs are reduced while session state is preserved.
+
+#### Parameters
+
+| Name | Type | Default value | Description |
+| :------ | :------ | :------ | :------ |
+| `timeout` | `number` | `600` | Timeout in seconds to wait for the session to pause. Defaults to 600 seconds. |
+| `pollInterval` | `number` | `2.0` | Interval in seconds between status polls. Defaults to 2.0 seconds. |
+
+#### Returns
+
+`Promise`\<`SessionPauseResult`\>
+
+Promise resolving to SessionPauseResult containing:
+         - success: Whether the pause operation succeeded
+         - requestId: Unique identifier for this API request
+         - status: Final session status (should be "PAUSED" if successful)
+         - errorMessage: Error description if pause failed
+
+**`Throws`**
+
+Error if the API call fails or network issues occur.
+
+**`Example`**
+
+```typescript
+const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+const result = await agentBay.create();
+if (result.success) {
+  const pauseResult = await result.session.pauseAsync();
+  if (pauseResult.success) {
+    console.log('Session paused successfully');
+  }
+}
+```
+
+**`Remarks`**
+
+**Behavior:**
+- Initiates pause operation through PauseSessionAsync API
+- Polls session status until PAUSED state or timeout
+- Session state transitions: RUNNING -> PAUSING -> PAUSED
+- All session state is preserved during pause
+
+**Important Notes:**
+- Paused sessions cannot perform operations (deletion, task execution, etc.)
+- Use [resumeAsync](#resumeasync) to restore the session to RUNNING state
+- During pause, both resource usage and costs are lower
+- If timeout is exceeded, returns with success=false
+
+**`See`**
+
+[resumeAsync](#resumeasync)
+
+___
+
+### resumeAsync
+
+▸ **resumeAsync**(`timeout?`, `pollInterval?`): `Promise`\<`SessionResumeResult`\>
+
+Asynchronously resume this session from a paused state.
+
+This method calls the ResumeSessionAsync API to initiate the resume operation and then polls
+the GetSession API to check the session status until it becomes RUNNING or until timeout is reached.
+After resuming, the session restores full functionality and can perform all operations normally.
+
+#### Parameters
+
+| Name | Type | Default value | Description |
+| :------ | :------ | :------ | :------ |
+| `timeout` | `number` | `600` | Timeout in seconds to wait for the session to resume. Defaults to 600 seconds. |
+| `pollInterval` | `number` | `2.0` | Interval in seconds between status polls. Defaults to 2.0 seconds. |
+
+#### Returns
+
+`Promise`\<`SessionResumeResult`\>
+
+Promise resolving to SessionResumeResult containing:
+         - success: Whether the resume operation succeeded
+         - requestId: Unique identifier for this API request
+         - status: Final session status (should be "RUNNING" if successful)
+         - errorMessage: Error description if resume failed
+
+**`Throws`**
+
+Error if the API call fails or network issues occur.
+
+**`Example`**
+
+```typescript
+const agentBay = new AgentBay({ apiKey: 'your_api_key' });
+const result = await agentBay.get('paused_session_id');
+if (result.success) {
+  const resumeResult = await result.session.resumeAsync();
+  if (resumeResult.success) {
+    console.log('Session resumed successfully');
+  }
+}
+```
+
+**`Remarks`**
+
+**Behavior:**
+- Initiates resume operation through ResumeSessionAsync API
+- Polls session status until RUNNING state or timeout
+- Session state transitions: PAUSED -> RESUMING -> RUNNING
+- All previous session state is restored during resume
+
+**Important Notes:**
+- Only sessions in PAUSED state can be resumed
+- After resume, the session can perform all operations normally
+- Use [pauseAsync](#pauseasync) to put a session into PAUSED state
+- If timeout is exceeded, returns with success=false
+
+**`See`**
+
+[pauseAsync](#pauseasync)
+
+___
+
 ### setLabels
 
 ▸ **setLabels**(`labels`): `Promise`\<`OperationResult`\>

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

@@ -12,6 +12,7 @@
  * - Error handling and cleanup
  */
 
+// @ts-nocheck
 import { AgentBay, ExtensionsService, Extension, ExtensionOption, BrowserContext } from "wuying-agentbay-sdk";
 import * as fs from "fs";
 
@@ -32,7 +33,7 @@ async function basicExtensionExample(): Promise<boolean> {
 
   try {
     // Example extension path (update with your actual extension)
-    const extensionPath = "/path/to/your-extension.zip";
+    const extensionPath = "/Users/shiwen/extension/welcome_extension.zip";
 
     if (!fs.existsSync(extensionPath)) {
       console.log(`❌ Extension file not found: ${extensionPath}`);

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