From 4e72b16bd546e347d05e38ababe4d7fb8eac9b5c Mon Sep 17 00:00:00 2001
From: OhYee <oyohyee@oyohyee.com>
Date: Sat, 25 Apr 2026 13:58:44 +0800
Subject: [PATCH 1/5] =?UTF-8?q?fix(sdk):=20=E4=BF=AE=E5=A4=8D=E6=96=B9?=
 =?UTF-8?q?=E6=B3=95=E7=BA=A7=20config=20=E5=9C=A8=E8=B0=83=E7=94=A8?=
 =?UTF-8?q?=E9=93=BE=E4=B8=AD=E8=A2=AB=E6=82=84=E6=82=84=E4=B8=A2=E5=BC=83?=
 =?UTF-8?q?=E7=9A=84=E9=97=AE=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

之前调用方传入的 config 在多个资源链路上都未真正生效：
data-api 的 timeout/ControlAPI 仍读 this.config，sandbox-data 的
withConfigs 顺序反向导致实例 config 反向覆盖方法级 config，model
和 credential 的 client 把结果 Object.assign 到 new ModelProxy()
但从未设置 _config，endpoint/template 的实例 get 也漏掉
config ?? this._config 的 fallback。结果是用户带 config 创建资源
后再链式 update/get/delete 会回落到默认环境，行为与 AgentRuntime
等已规范模块不一致。

本次统一收敛 method > instance > default 的合并优先级，让所有
请求真正遵循调用方传入的 config:

- src/utils/data-api.ts: makeRequest/postFile/getFile 改用合并后
  的 cfg.timeout；取 access token 的 ControlAPI 也用 cfg 构造
- src/sandbox/api/sandbox-data.ts: 反转 Config.withConfigs 入参
  顺序；createSandbox/deleteSandbox/stopSandbox/getSandbox 在
  refreshAccessToken 之后把 params.config 透传给后续 HTTP 调用
- src/model/client.ts: create/delete/update/get/list 10 处把
  Object.assign(new X(), result) 替换为 new X(result, cfg)
- src/model/model-proxy.ts, src/model/model-service.ts: 构造函数
  签名扩展为 (data?, config?)，保持无参兼容；实例 update/delete/
  get 补 config ?? this._config fallback
- src/credential/client.ts: new Credential(result) 全部改为
  new Credential(result, cfg)
- src/agent-runtime/endpoint.ts, src/sandbox/template.ts: 实例
  get 补 config ?? this._config fallback
- src/sandbox/sandbox.ts: Sandbox.get 静态方法把合并后的 cfg 传给
  fromInnerObject 和各模板子类构造，避免返回的 Sandbox 丢失 config
- src/toolset/toolset.ts: toApiSet/callToolAsync/listToolsAsync
  统一以 params?.config ?? this._config 作为 baseConfig

修复后线上行为从"偷偷回落到默认环境"变为"真正遵循方法级 config"，
原本被资源 client 静默吞掉的 endpoint/token/headers 现在都会按
预期生效。

Change-Id: If9961fabaa0830aa1d536e09c4b04b74ee97bcc1
Co-developed-by: Claude <noreply@anthropic.com>
Signed-off-by: OhYee <oyohyee@oyohyee.com>
---
 src/agent-runtime/endpoint.ts   |  2 +-
 src/credential/client.ts        |  8 +++---
 src/model/client.ts             | 44 ++++++++-------------------------
 src/model/model-proxy.ts        | 16 ++++++++----
 src/model/model-service.ts      | 16 ++++++++----
 src/sandbox/api/sandbox-data.ts |  9 ++++---
 src/sandbox/sandbox.ts          | 10 ++++----
 src/sandbox/template.ts         |  2 +-
 src/toolset/toolset.ts          | 18 +++++++-------
 src/utils/data-api.ts           | 17 +++++++------
 10 files changed, 67 insertions(+), 75 deletions(-)

diff --git a/src/agent-runtime/endpoint.ts b/src/agent-runtime/endpoint.ts
index 514070b..1ec5202 100644
--- a/src/agent-runtime/endpoint.ts
+++ b/src/agent-runtime/endpoint.ts
@@ -157,7 +157,7 @@ export class AgentRuntimeEndpoint extends ResourceBase implements AgentRuntimeEn
     return await AgentRuntimeEndpoint.get({
       agentRuntimeId: this.agentRuntimeId!,
       endpointId: this.agentRuntimeEndpointId!,
-      config: params?.config,
+      config: params?.config ?? this._config,
     });
   };
 
diff --git a/src/credential/client.ts b/src/credential/client.ts
index 1fab832..9fbbdd1 100644
--- a/src/credential/client.ts
+++ b/src/credential/client.ts
@@ -84,7 +84,7 @@ export class CredentialClient {
         config: cfg,
       });
 
-      return new Credential(result);
+      return new Credential(result, cfg);
     } catch (error) {
       if (error instanceof HTTPError) {
         throw error.toResourceError('Credential', params?.input?.credentialName);
@@ -106,7 +106,7 @@ export class CredentialClient {
         config: cfg,
       });
 
-      return new Credential(result);
+      return new Credential(result, cfg);
     } catch (error) {
       if (error instanceof HTTPError) {
         throw error.toResourceError('Credential', params?.name);
@@ -165,7 +165,7 @@ export class CredentialClient {
         config: cfg,
       });
 
-      return new Credential(result as any);
+      return new Credential(result as any, cfg);
     } catch (error) {
       if (error instanceof HTTPError) {
         throw error.toResourceError('Credential', params?.name);
@@ -187,7 +187,7 @@ export class CredentialClient {
         credentialName: name,
         config: cfg,
       });
-      return new Credential(result as any);
+      return new Credential(result as any, cfg);
     } catch (error) {
       if (error instanceof HTTPError) {
         throw error.toResourceError('Credential', params?.name);
diff --git a/src/model/client.ts b/src/model/client.ts
index 065f0a9..f499da9 100644
--- a/src/model/client.ts
+++ b/src/model/client.ts
@@ -80,9 +80,7 @@ export class ModelClient {
           input: createInput,
           config: cfg,
         });
-        const proxy = new ModelProxy();
-        Object.assign(proxy, result);
-        return proxy;
+        return new ModelProxy(result, cfg);
       } else {
         // 处理 ModelServiceCreateInput
         const modelServiceInput = input as ModelServiceCreateInput;
@@ -95,9 +93,7 @@ export class ModelClient {
           input: createInput,
           config: cfg,
         });
-        const service = new ModelService();
-        Object.assign(service, result);
-        return service;
+        return new ModelService(result, cfg);
       }
     } catch (e) {
       if (e instanceof HTTPError) {
@@ -136,9 +132,7 @@ export class ModelClient {
           modelProxyName: name,
           config: cfg,
         });
-        const proxy = new ModelProxy();
-        Object.assign(proxy, result);
-        return proxy;
+        return new ModelProxy(result, cfg);
       } catch (e) {
         if (e instanceof HTTPError) {
           error = e;
@@ -159,9 +153,7 @@ export class ModelClient {
         modelServiceName: name,
         config: cfg,
       });
-      const service = new ModelService();
-      Object.assign(service, result);
-      return service;
+      return new ModelService(result, cfg);
     } catch (e) {
       if (e instanceof HTTPError) {
         throw e.toResourceError('Model', name);
@@ -208,9 +200,7 @@ export class ModelClient {
           input: updateInput,
           config: cfg,
         });
-        const proxy = new ModelProxy();
-        Object.assign(proxy, result);
-        return proxy;
+        return new ModelProxy(result, cfg);
       } catch (e) {
         if (e instanceof HTTPError) {
           throw e.toResourceError('Model', name);
@@ -231,9 +221,7 @@ export class ModelClient {
           input: updateInput,
           config: cfg,
         });
-        const service = new ModelService();
-        Object.assign(service, result);
-        return service;
+        return new ModelService(result, cfg);
       } catch (e) {
         if (e instanceof HTTPError) {
           throw e.toResourceError('Model', name);
@@ -268,9 +256,7 @@ export class ModelClient {
           modelProxyName: name,
           config: cfg,
         });
-        const proxy = new ModelProxy();
-        Object.assign(proxy, result);
-        return proxy;
+        return new ModelProxy(result, cfg);
       } catch (e) {
         if (e instanceof HTTPError) {
           error = e;
@@ -291,9 +277,7 @@ export class ModelClient {
         modelServiceName: name,
         config: cfg,
       });
-      const service = new ModelService();
-      Object.assign(service, result);
-      return service;
+      return new ModelService(result, cfg);
     } catch (e) {
       if (e instanceof HTTPError) {
         throw e.toResourceError('Model', name);
@@ -328,11 +312,7 @@ export class ModelClient {
         input: request,
         config: cfg,
       });
-      return (result.items || []).map(item => {
-        const proxy = new ModelProxy();
-        Object.assign(proxy, item);
-        return proxy;
-      });
+      return (result.items || []).map(item => new ModelProxy(item, cfg));
     } else {
       // 处理 ModelServiceListInput 或无参数（默认列出 ModelService）
       const modelServiceInput = (input ?? {}) as ModelServiceListInput;
@@ -345,11 +325,7 @@ export class ModelClient {
         input: request,
         config: cfg,
       });
-      return (result.items || []).map(item => {
-        const service = new ModelService();
-        Object.assign(service, item);
-        return service;
-      });
+      return (result.items || []).map(item => new ModelService(item, cfg));
     }
   };
 }
diff --git a/src/model/model-proxy.ts b/src/model/model-proxy.ts
index 54a93ec..434dddb 100644
--- a/src/model/model-proxy.ts
+++ b/src/model/model-proxy.ts
@@ -8,7 +8,7 @@
 import * as _ from 'lodash';
 
 import { Config } from '../utils/config';
-import { listAllResourcesFunction, ResourceBase } from '../utils/resource';
+import { listAllResourcesFunction, ResourceBase, updateObjectProperties } from '../utils/resource';
 
 import { ModelAPI, ModelInfo } from './api/model-api';
 import {
@@ -56,11 +56,17 @@ export class ModelProxy
 
   private modelApi: ModelAPI;
 
-  constructor() {
+  constructor(data?: any, config?: Config) {
     super();
     this.modelApi = new ModelAPI(this.modelInfo);
     this.completion = this.modelApi.completion;
     this.embedding = this.modelApi.embedding;
+    if (data) {
+      updateObjectProperties(this, data);
+    }
+    if (config) {
+      this._config = config;
+    }
   }
 
   completion: (typeof ModelAPI)['prototype']['completion'];
@@ -183,7 +189,7 @@ export class ModelProxy
     const result = await ModelProxy.update({
       name: this.modelProxyName,
       input,
-      config,
+      config: config ?? this._config,
     });
     this.updateSelf(result);
 
@@ -203,7 +209,7 @@ export class ModelProxy
 
     return await ModelProxy.delete({
       name: this.modelProxyName,
-      config: params?.config,
+      config: params?.config ?? this._config,
     });
   };
 
@@ -220,7 +226,7 @@ export class ModelProxy
 
     const result = await ModelProxy.get({
       name: this.modelProxyName,
-      config: params?.config,
+      config: params?.config ?? this._config,
     });
     this.updateSelf(result);
 
diff --git a/src/model/model-service.ts b/src/model/model-service.ts
index 18b5b4f..4106937 100644
--- a/src/model/model-service.ts
+++ b/src/model/model-service.ts
@@ -6,7 +6,7 @@
  */
 
 import { Config } from '../utils/config';
-import { listAllResourcesFunction, ResourceBase } from '../utils/resource';
+import { listAllResourcesFunction, ResourceBase, updateObjectProperties } from '../utils/resource';
 import { ModelAPI } from './api/model-api';
 
 import {
@@ -48,11 +48,17 @@ export class ModelService
   modelType?: ModelServiceImmutableProps['modelType'];
 
   private modelApi: ModelAPI;
-  constructor() {
+  constructor(data?: any, config?: Config) {
     super();
     this.modelApi = new ModelAPI(this.modelInfo);
     this.completion = this.modelApi.completion;
     this.embedding = this.modelApi.embedding;
+    if (data) {
+      updateObjectProperties(this, data);
+    }
+    if (config) {
+      this._config = config;
+    }
   }
 
   completion: (typeof ModelAPI)['prototype']['completion'];
@@ -173,7 +179,7 @@ export class ModelService
     const result = await ModelService.update({
       name: this.modelServiceName,
       input,
-      config,
+      config: config ?? this._config,
     });
     this.updateSelf(result);
 
@@ -193,7 +199,7 @@ export class ModelService
 
     return await ModelService.delete({
       name: this.modelServiceName,
-      config: params?.config,
+      config: params?.config ?? this._config,
     });
   };
 
@@ -210,7 +216,7 @@ export class ModelService
 
     const result = await ModelService.get({
       name: this.modelServiceName,
-      config: params?.config,
+      config: params?.config ?? this._config,
     });
     this.updateSelf(result);
 
diff --git a/src/sandbox/api/sandbox-data.ts b/src/sandbox/api/sandbox-data.ts
index 1f11f92..a3d7ab0 100644
--- a/src/sandbox/api/sandbox-data.ts
+++ b/src/sandbox/api/sandbox-data.ts
@@ -63,7 +63,7 @@ export class SandboxDataAPI {
     config?: Config;
   }): Promise<void> {
     const { sandboxId, templateName, config } = params;
-    const cfg = Config.withConfigs(config, this.config);
+    const cfg = Config.withConfigs(this.config, config);
 
     const cacheKey = (sandboxId || templateName)!;
     const cachedToken = this.accessTokenMap.get(cacheKey);
@@ -424,6 +424,7 @@ export class SandboxDataAPI {
     return this.post({
       path: '/',
       data,
+      config: params.config,
     });
   };
 
@@ -436,7 +437,7 @@ export class SandboxDataAPI {
       config: params.config,
     });
 
-    return this.delete({ path: '/' });
+    return this.delete({ path: '/', config: params.config });
   };
 
   /**
@@ -448,7 +449,7 @@ export class SandboxDataAPI {
       config: params.config,
     });
 
-    return this.post({ path: '/stop' });
+    return this.post({ path: '/stop', config: params.config });
   };
 
   /**
@@ -460,6 +461,6 @@ export class SandboxDataAPI {
       config: params.config,
     });
 
-    return this.get({ path: '/' });
+    return this.get({ path: '/', config: params.config });
   };
 }
diff --git a/src/sandbox/sandbox.ts b/src/sandbox/sandbox.ts
index 7941e70..c8e5b0c 100644
--- a/src/sandbox/sandbox.ts
+++ b/src/sandbox/sandbox.ts
@@ -282,7 +282,7 @@ export class Sandbox extends ResourceBase implements SandboxData {
 
       // Extract data and create Sandbox instance
       const data = result.data || {};
-      const baseSandbox = Sandbox.fromInnerObject(data as any, config);
+      const baseSandbox = Sandbox.fromInnerObject(data as any, cfg);
 
       // If templateType is specified, return the appropriate subclass
       if (templateType) {
@@ -291,25 +291,25 @@ export class Sandbox extends ResourceBase implements SandboxData {
           case TemplateType.CODE_INTERPRETER: {
             const { CodeInterpreterSandbox } = await import('./code-interpreter-sandbox');
             // Pass baseSandbox instead of raw data
-            const sandbox = new CodeInterpreterSandbox(baseSandbox, config);
+            const sandbox = new CodeInterpreterSandbox(baseSandbox, cfg);
             return sandbox;
           }
           case TemplateType.BROWSER: {
             const { BrowserSandbox } = await import('./browser-sandbox');
             // Pass baseSandbox instead of raw data
-            const sandbox = new BrowserSandbox(baseSandbox, config);
+            const sandbox = new BrowserSandbox(baseSandbox, cfg);
             return sandbox;
           }
           case TemplateType.AIO: {
             const { AioSandbox } = await import('./aio-sandbox');
             // Pass baseSandbox instead of raw data
-            const sandbox = new AioSandbox(baseSandbox, config);
+            const sandbox = new AioSandbox(baseSandbox, cfg);
             return sandbox;
           }
           case TemplateType.CUSTOM: {
             const { CustomSandbox } = await import('./custom-sandbox');
             // Pass baseSandbox instead of raw data
-            const sandbox = new CustomSandbox(baseSandbox, config);
+            const sandbox = new CustomSandbox(baseSandbox, cfg);
             return sandbox;
           }
         }
diff --git a/src/sandbox/template.ts b/src/sandbox/template.ts
index d7fd83a..476b46e 100644
--- a/src/sandbox/template.ts
+++ b/src/sandbox/template.ts
@@ -163,7 +163,7 @@ export class Template extends ResourceBase implements TemplateData {
   get = async (params: { config?: Config } = {}): Promise<Template> => {
     return await Template.get({
       name: this.templateName!,
-      config: params.config,
+      config: params.config ?? this._config,
     });
   };
 
diff --git a/src/toolset/toolset.ts b/src/toolset/toolset.ts
index 4e506a4..080dd5f 100644
--- a/src/toolset/toolset.ts
+++ b/src/toolset/toolset.ts
@@ -232,7 +232,7 @@ export class ToolSet implements ToolSetData {
       return mcpTools.map((tool: any) => ToolInfo.fromMCPTool(tool));
     } else if (this.type() === ToolSetSchemaType.OPENAPI) {
       // OpenAPI tools - use toApiSet
-      const apiset = await this.toApiSet(params);
+      const apiset = await this.toApiSet({ config: params?.config ?? this._config });
       return apiset.tools;
     }
     return [];
@@ -255,7 +255,8 @@ export class ToolSet implements ToolSetData {
     args?: Record<string, unknown>,
     config?: Config
   ): Promise<any> => {
-    const apiset = await this.toApiSet({ config });
+    const effectiveConfig = config ?? this._config;
+    const apiset = await this.toApiSet({ config: effectiveConfig });
     // eslint-disable-next-line @typescript-eslint/no-var-requires
     const { ToolSetSchemaType } = require('./model');
 
@@ -278,7 +279,7 @@ export class ToolSet implements ToolSetData {
     }
 
     logger.debug(`Invoke tool ${name} with arguments`, args);
-    const result = await apiset.invoke(name, args, config);
+    const result = await apiset.invoke(name, args, effectiveConfig);
     logger.debug(`Invoke tool ${name} got result`, result);
     return result;
   };
@@ -301,6 +302,8 @@ export class ToolSet implements ToolSetData {
     // eslint-disable-next-line @typescript-eslint/no-var-requires
     const { ToolSetSchemaType } = require('./model');
 
+    const baseConfig = params?.config ?? this._config;
+
     if (this.type() === ToolSetSchemaType.MCP) {
       // eslint-disable-next-line @typescript-eslint/no-var-requires
       const { MCPToolSet } = require('./api/mcp');
@@ -310,10 +313,7 @@ export class ToolSet implements ToolSetData {
         throw new Error('MCP server URL is missing.');
       }
 
-      const cfg = Config.withConfigs(
-        params?.config,
-        new Config({ headers: mcpServerConfig.headers })
-      );
+      const cfg = Config.withConfigs(baseConfig, new Config({ headers: mcpServerConfig.headers }));
 
       const mcpClient = new MCPToolSet(mcpServerConfig.url, cfg);
 
@@ -339,7 +339,7 @@ export class ToolSet implements ToolSetData {
         baseUrl: this._getOpenAPIBaseUrl(),
         headers,
         queryParams: query,
-        config: params?.config,
+        config: baseConfig,
       });
 
       // Convert OpenAPI tools to ToolInfo format
@@ -354,7 +354,7 @@ export class ToolSet implements ToolSetData {
           })
       );
 
-      return new ApiSet(tools, openapi, undefined, headers, query, params?.config);
+      return new ApiSet(tools, openapi, undefined, headers, query, baseConfig);
     }
 
     throw new Error(`Unsupported ToolSet type: ${this.type()}`);
diff --git a/src/utils/data-api.ts b/src/utils/data-api.ts
index 44baf85..c27829a 100644
--- a/src/utils/data-api.ts
+++ b/src/utils/data-api.ts
@@ -151,7 +151,7 @@ export class DataAPI {
         const { ControlAPI } = await import('./control-api');
         const $AgentRun = await import('@alicloud/agentrun20250910');
 
-        const cli = new ControlAPI(this.config).getClient();
+        const cli = new ControlAPI(cfg).getClient();
 
         const input =
           this.resourceType === ResourceType.Sandbox
@@ -260,13 +260,14 @@ export class DataAPI {
     headers?: Record<string, string>,
     config?: Config
   ): Promise<DataAPIResponse> {
+    const cfg = Config.withConfigs(this.config, config);
     const fullUrl = this.withPath(path, query);
     const {
       method: reqMethod,
       url: reqUrl,
       headers: reqHeaders,
       body: reqBody,
-    } = await this.prepareRequest(method, fullUrl, data, headers, undefined, config);
+    } = await this.prepareRequest(method, fullUrl, data, headers, undefined, cfg);
 
     const client = reqUrl.startsWith('https') ? https : http;
     const urlObj = new URL(reqUrl);
@@ -277,7 +278,7 @@ export class DataAPI {
       path: urlObj.pathname + urlObj.search,
       method: reqMethod,
       headers: reqHeaders,
-      timeout: this.config.timeout,
+      timeout: cfg.timeout,
     };
 
     return new Promise((resolve, reject) => {
@@ -429,6 +430,7 @@ export class DataAPI {
     headers?: Record<string, string>,
     config?: Config
   ): Promise<DataAPIResponse> {
+    const cfg = Config.withConfigs(this.config, config);
     const fullUrl = this.withPath(path, query);
     const { url: reqUrl, headers: reqHeaders } = await this.prepareRequest(
       'POST',
@@ -436,7 +438,7 @@ export class DataAPI {
       undefined,
       headers,
       undefined,
-      config
+      cfg
     );
 
     const client = reqUrl.startsWith('https') ? https : http;
@@ -455,7 +457,7 @@ export class DataAPI {
         path: urlObj.pathname + urlObj.search,
         method: 'POST',
         headers: contentHeaders,
-        timeout: this.config.timeout,
+        timeout: cfg.timeout,
       };
 
       const req = client.request(options, res => {
@@ -536,6 +538,7 @@ export class DataAPI {
     headers?: Record<string, string>,
     config?: Config
   ): Promise<FileDownloadResult> {
+    const cfg = Config.withConfigs(this.config, config);
     const fullUrl = this.withPath(path, query);
     const { url: reqUrl, headers: reqHeaders } = await this.prepareRequest(
       'GET',
@@ -543,7 +546,7 @@ export class DataAPI {
       undefined,
       headers,
       undefined,
-      config
+      cfg
     );
 
     const client = reqUrl.startsWith('https') ? https : http;
@@ -556,7 +559,7 @@ export class DataAPI {
         path: urlObj.pathname + urlObj.search,
         method: 'GET',
         headers: reqHeaders,
-        timeout: this.config.timeout,
+        timeout: cfg.timeout,
       };
 
       const req = client.request(options, res => {

From 7e9fe5ffc0f8702ac9d2cad18353e5a0f7fa4aaf Mon Sep 17 00:00:00 2001
From: OhYee <oyohyee@oyohyee.com>
Date: Sat, 25 Apr 2026 13:59:08 +0800
Subject: [PATCH 2/5] =?UTF-8?q?fix(sandbox):=20createSandbox=20=E7=9A=84?=
 =?UTF-8?q?=2030s=20readTimeout=20=E6=94=B9=E4=B8=BA=E5=8F=AF=E8=A2=AB=20c?=
 =?UTF-8?q?onfig=20=E8=A6=86=E7=9B=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

createSandbox 之前在 RuntimeOptions 里写死 readTimeout: 30000，让
用户即使在 Config 上显式配置了 readTimeout 也无法生效。直接删掉硬
编码会让默认从 30s 变成 100000000ms，创建卡死时要等近 28 小时才
报错，体验更差。需要的是"软默认"：未显式配置时维持 30s 快速失败，
显式配置时尊重用户。

为此让 Config 区分"用户未设置"与"使用默认值"，让具体 API 能定义
自己的默认 fallback:

- src/utils/config.ts: 内部 _readTimeout 由 number 改为
  number | undefined，构造时不再强制填默认；update() 合并改用
  !== undefined 判断以支持显式 0；公开 getter readTimeout 仍返回
  _readTimeout ?? 100000000，向后兼容；新增 hasReadTimeout 和
  readTimeoutOr(fallback) 供 API 层定义专属默认
- src/sandbox/api/control.ts: createSandbox 改为
  Config.withConfigs(this.config, config) 后用
  cfg.readTimeoutOr(30000)，并把 cfg 传给 getClient 保持透传一致

测试同步覆盖新行为:

- tests/unittests/utils/config.test.ts: 新增 6 个 readTimeoutOr/
  hasReadTimeout 用例，包括 withConfigs 合并下的传递行为
- tests/unittests/sandbox/control-api.test.ts: 新增 4 个用例验证
  createSandbox 默认 30s、instance config 覆盖、method-level
  config 覆盖、method 优先于 instance

修复后默认行为不变（仍是 30s 快速失败），需要长 readTimeout 的用户
通过 new Config({ readTimeout: ... }) 即可覆盖；其他读取
cfg.readTimeout 的位置默认值保持 100000000，零扩散影响。

Change-Id: I611cbe54218a3537223fdf1032cc87f1d345004f
Co-developed-by: Claude <noreply@anthropic.com>
Signed-off-by: OhYee <oyohyee@oyohyee.com>
---
 src/sandbox/api/control.ts                  |  7 +-
 src/utils/config.ts                         | 33 ++++++++-
 tests/unittests/sandbox/control-api.test.ts | 82 +++++++++++++++++++++
 tests/unittests/utils/config.test.ts        | 36 +++++++++
 4 files changed, 152 insertions(+), 6 deletions(-)
 create mode 100644 tests/unittests/sandbox/control-api.test.ts

diff --git a/src/sandbox/api/control.ts b/src/sandbox/api/control.ts
index 85d80aa..c0653ff 100644
--- a/src/sandbox/api/control.ts
+++ b/src/sandbox/api/control.ts
@@ -273,9 +273,12 @@ export class SandboxControlAPI extends ControlAPI {
     const { input, headers, config } = params;
 
     try {
-      const client = this.getClient(config);
+      const cfg = Config.withConfigs(this.config, config);
+      const client = this.getClient(cfg);
+      // createSandbox should fail fast (default 30s) but honor an explicit
+      // readTimeout from the caller's Config when provided.
       const runtime = new $Util.RuntimeOptions({
-        readTimeout: 30000,
+        readTimeout: cfg.readTimeoutOr(30000),
       });
 
       const response = await client.createSandboxWithOptions(
diff --git a/src/utils/config.ts b/src/utils/config.ts
index 56d44b9..3310efb 100644
--- a/src/utils/config.ts
+++ b/src/utils/config.ts
@@ -123,7 +123,12 @@ export class Config {
   private _token?: string;
   private _regionId: string;
   private _timeout: number;
-  private _readTimeout: number;
+  /**
+   * Read timeout in ms. `undefined` means user has not explicitly set it,
+   * so callers can apply their own fallback (see `readTimeoutOr`). Public
+   * `readTimeout` getter still returns the historical default 100000000.
+   */
+  private _readTimeout?: number;
   private _controlEndpoint: string;
   private _dataEndpoint: string;
   private _devsEndpoint: string;
@@ -151,7 +156,8 @@ export class Config {
       options.regionId ?? getEnvWithDefault('cn-hangzhou', 'AGENTRUN_REGION', 'FC_REGION');
 
     this._timeout = options.timeout ?? 600000;
-    this._readTimeout = options.readTimeout ?? 100000000;
+    // Keep undefined when caller did not set it, so per-API defaults can apply.
+    this._readTimeout = options.readTimeout;
 
     this._controlEndpoint =
       options.controlEndpoint ?? getEnvWithDefault('', 'AGENTRUN_CONTROL_ENDPOINT');
@@ -186,7 +192,7 @@ export class Config {
       if (config._token) this._token = config._token;
       if (config._regionId) this._regionId = config._regionId;
       if (config._timeout) this._timeout = config._timeout;
-      if (config._readTimeout) this._readTimeout = config._readTimeout;
+      if (config._readTimeout !== undefined) this._readTimeout = config._readTimeout;
       if (config._controlEndpoint) this._controlEndpoint = config._controlEndpoint;
       if (config._dataEndpoint) this._dataEndpoint = config._dataEndpoint;
       if (config._devsEndpoint) this._devsEndpoint = config._devsEndpoint;
@@ -231,7 +237,26 @@ export class Config {
   }
 
   get readTimeout(): number {
-    return this._readTimeout || 100000000;
+    return this._readTimeout ?? 100000000;
+  }
+
+  /**
+   * Whether the user explicitly set readTimeout (vs falling back to default).
+   * Useful for APIs that want a different default than the global one.
+   */
+  get hasReadTimeout(): boolean {
+    return this._readTimeout !== undefined;
+  }
+
+  /**
+   * Returns the user-configured readTimeout if set, otherwise the given
+   * fallback (in ms). Use this for per-API defaults that differ from the
+   * global 100000000 ms default.
+   *
+   * @param fallback Default value in milliseconds when user has not set readTimeout.
+   */
+  readTimeoutOr(fallback: number): number {
+    return this._readTimeout ?? fallback;
   }
 
   get controlEndpoint(): string {
diff --git a/tests/unittests/sandbox/control-api.test.ts b/tests/unittests/sandbox/control-api.test.ts
new file mode 100644
index 0000000..13391ee
--- /dev/null
+++ b/tests/unittests/sandbox/control-api.test.ts
@@ -0,0 +1,82 @@
+/**
+ * SandboxControlAPI readTimeout behaviour tests.
+ *
+ * Verifies that createSandbox uses 30000ms by default but honors a
+ * user-provided readTimeout from Config.
+ */
+
+const mockRuntimeOptions = jest.fn().mockImplementation(opts => ({ ...opts }));
+
+const mockCreateSandboxWithOptions = jest.fn().mockResolvedValue({
+  body: { data: { sandboxId: 'sb-1' }, requestId: 'req-1' },
+});
+
+jest.mock('@alicloud/tea-util', () => ({
+  RuntimeOptions: mockRuntimeOptions,
+}));
+
+jest.mock('@alicloud/agentrun20250910', () => {
+  const CreateSandboxRequest = jest.fn().mockImplementation(params => params);
+  const MockClient = jest.fn().mockImplementation(() => ({
+    createSandboxWithOptions: mockCreateSandboxWithOptions,
+  }));
+  return {
+    default: MockClient,
+    CreateSandboxRequest,
+  };
+});
+
+import { Config } from '../../../src/utils/config';
+import { SandboxControlAPI } from '../../../src/sandbox/api/control';
+
+describe('SandboxControlAPI.createSandbox readTimeout', () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+  });
+
+  it('uses 30000ms default when caller has not set readTimeout', async () => {
+    const api = new SandboxControlAPI(new Config({ accountId: 'acc' }));
+    await api.createSandbox({ input: {} as any });
+
+    expect(mockRuntimeOptions).toHaveBeenCalledWith(
+      expect.objectContaining({ readTimeout: 30000 })
+    );
+  });
+
+  it('honors readTimeout from instance config', async () => {
+    const api = new SandboxControlAPI(
+      new Config({ accountId: 'acc', readTimeout: 60000 })
+    );
+    await api.createSandbox({ input: {} as any });
+
+    expect(mockRuntimeOptions).toHaveBeenCalledWith(
+      expect.objectContaining({ readTimeout: 60000 })
+    );
+  });
+
+  it('honors readTimeout from method-level config override', async () => {
+    const api = new SandboxControlAPI(new Config({ accountId: 'acc' }));
+    await api.createSandbox({
+      input: {} as any,
+      config: new Config({ accountId: 'acc', readTimeout: 90000 }),
+    });
+
+    expect(mockRuntimeOptions).toHaveBeenCalledWith(
+      expect.objectContaining({ readTimeout: 90000 })
+    );
+  });
+
+  it('method-level config wins over instance config', async () => {
+    const api = new SandboxControlAPI(
+      new Config({ accountId: 'acc', readTimeout: 60000 })
+    );
+    await api.createSandbox({
+      input: {} as any,
+      config: new Config({ accountId: 'acc', readTimeout: 90000 }),
+    });
+
+    expect(mockRuntimeOptions).toHaveBeenCalledWith(
+      expect.objectContaining({ readTimeout: 90000 })
+    );
+  });
+});
diff --git a/tests/unittests/utils/config.test.ts b/tests/unittests/utils/config.test.ts
index 6e12417..c38e98f 100644
--- a/tests/unittests/utils/config.test.ts
+++ b/tests/unittests/utils/config.test.ts
@@ -117,6 +117,42 @@ describe('Config', () => {
     });
   });
 
+  describe('readTimeoutOr / hasReadTimeout', () => {
+    it('hasReadTimeout returns false when user has not set readTimeout', () => {
+      const config = new Config();
+      expect(config.hasReadTimeout).toBe(false);
+    });
+
+    it('hasReadTimeout returns true once readTimeout is provided', () => {
+      const config = new Config({ readTimeout: 12345 });
+      expect(config.hasReadTimeout).toBe(true);
+    });
+
+    it('readTimeoutOr returns the fallback when user has not set readTimeout', () => {
+      const config = new Config();
+      expect(config.readTimeoutOr(30000)).toBe(30000);
+    });
+
+    it('readTimeoutOr returns the user value when set, ignoring the fallback', () => {
+      const config = new Config({ readTimeout: 60000 });
+      expect(config.readTimeoutOr(30000)).toBe(60000);
+    });
+
+    it('readTimeoutOr respects readTimeout merged from withConfigs', () => {
+      const base = new Config();
+      const override = new Config({ readTimeout: 45000 });
+      const merged = Config.withConfigs(base, override);
+      expect(merged.hasReadTimeout).toBe(true);
+      expect(merged.readTimeoutOr(30000)).toBe(45000);
+    });
+
+    it('readTimeoutOr stays at fallback when neither config sets readTimeout', () => {
+      const merged = Config.withConfigs(new Config(), new Config());
+      expect(merged.hasReadTimeout).toBe(false);
+      expect(merged.readTimeoutOr(30000)).toBe(30000);
+    });
+  });
+
   describe('controlEndpoint', () => {
     it('should use custom control endpoint', () => {
       const config = new Config({

From 31b2e078027b3ca29276945a42648adfebfe9d4b Mon Sep 17 00:00:00 2001
From: OhYee <oyohyee@oyohyee.com>
Date: Sat, 25 Apr 2026 14:04:40 +0800
Subject: [PATCH 3/5] =?UTF-8?q?docs(readme):=20=E4=BF=AE=E6=AD=A3=E4=B8=8E?=
 =?UTF-8?q?=E4=BB=A3=E7=A0=81=E4=B8=8D=E4=B8=80=E8=87=B4=E7=9A=84=E7=A4=BA?=
 =?UTF-8?q?=E4=BE=8B=E5=92=8C=E7=8E=AF=E5=A2=83=E5=8F=98=E9=87=8F=E8=AF=B4?=
 =?UTF-8?q?=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

之前 README 多处与实际 API/包配置不符，导致按文档照抄会直接报错或
找不到符号：包名写成 @alicloud/agentrun-sdk（实际为 @agentrun/sdk）；
AgentRuntime/Endpoint 等创建接口示例缺少 input 包装；waitUntilReady
方法不存在（实际为 waitUntilReadyOrFailed）；codeConfiguration 示例
手写 zipFile 字符串不可运行；createCodeInterpreterSandbox 写成位置
参数（实际为对象参数）；环境变量列了不存在的 AGENTRUN_TIMEOUT 且漏
列 SECURITY_TOKEN/CONTROL_ENDPOINT/DATA_ENDPOINT/DEVS_ENDPOINT 与
其 fallback；npm run example:quick-start 脚本指向不存在的源文件。

按 src/utils/config.ts、src/agent-runtime、src/sandbox 与 examples/
当前实现重写：

- 包名统一为 @agentrun/sdk
- Agent Runtime 示例改为 AgentRuntime.create({ input }) 并用
  codeFromFile 替代手写 zipFile，等待用 waitUntilReadyOrFailed
- Sandbox 示例改用 Template.create({ input })、对象参数的
  createCodeInterpreterSandbox、waitUntilRunning + waitUntilReadyOrFailed
  组合，并补一段 sandbox.context.create + ctx.execute 真实可运行示例
- 模块表补齐 ToolSet / Server / Integration
- 示例小节移除失效的 example:quick-start 与 example:quick-start-with-tools
  脚本，改为列出 examples/ 下真实存在的文件以及 npx tsx 直接运行方式
- 环境变量表按 Config 实际读取顺序补齐 7 项变量及其 ALIBABA_CLOUD_* /
  FC_* fallback；额外说明 timeout/readTimeout 仅支持代码配置

修正后照着 README 抄写的代码可以直接通过类型检查并运行。

Change-Id: I1a65101653453bc52f87dd301e1c4d5e5b788ca7
Co-developed-by: Claude <noreply@anthropic.com>
Signed-off-by: OhYee <oyohyee@oyohyee.com>
---
 README.md | 102 ++++++++++++++++++++++++++++++++++--------------------
 1 file changed, 65 insertions(+), 37 deletions(-)

diff --git a/README.md b/README.md
index 23aa137..c292001 100644
--- a/README.md
+++ b/README.md
@@ -8,13 +8,14 @@ AgentRun SDK 是阿里云 AgentRun 服务的 Node.js 客户端库，为 AI Agent
 - 📜 **Credential**: 安全的凭证管理
 - 🔧 **Model**: 模型服务和代理管理
 - 📦 **Sandbox**: 代码解释器和浏览器沙箱
+- 🧰 **ToolSet**: OpenAPI / MCP 工具集管理
 - 🌐 **Server**: OpenAI 兼容的 HTTP 服务器
 - 🔌 **Integration**: Mastra 框架集成
 
 ## 安装
 
 ```bash
-npm install @alicloud/agentrun-sdk
+npm install @agentrun/sdk
 ```
 
 ## 快速开始
@@ -24,13 +25,13 @@ npm install @alicloud/agentrun-sdk
 SDK 支持从环境变量或代码中配置：
 
 ```typescript
-import { Config } from '@alicloud/agentrun-sdk';
+import { Config } from '@agentrun/sdk';
 
 // 从环境变量读取配置
-// AGENTRUN_ACCESS_KEY_ID
-// AGENTRUN_ACCESS_KEY_SECRET
-// AGENTRUN_ACCOUNT_ID
-// AGENTRUN_REGION (默认: cn-hangzhou)
+// AGENTRUN_ACCESS_KEY_ID     (回退到 ALIBABA_CLOUD_ACCESS_KEY_ID)
+// AGENTRUN_ACCESS_KEY_SECRET (回退到 ALIBABA_CLOUD_ACCESS_KEY_SECRET)
+// AGENTRUN_ACCOUNT_ID        (回退到 FC_ACCOUNT_ID)
+// AGENTRUN_REGION            (回退到 FC_REGION，默认 cn-hangzhou)
 const config = new Config();
 
 // 或者直接传入配置
@@ -45,27 +46,36 @@ const config = new Config({
 ### Agent Runtime
 
 ```typescript
-import { AgentRuntime, AgentRuntimeLanguage } from '@alicloud/agentrun-sdk';
+import {
+  AgentRuntime,
+  AgentRuntimeLanguage,
+  codeFromFile,
+} from '@agentrun/sdk';
 
 // 创建 Agent Runtime
 const runtime = await AgentRuntime.create({
-  agentRuntimeName: 'my-agent',
-  codeConfiguration: {
-    language: AgentRuntimeLanguage.NODEJS18,
-    command: ['node', 'index.js'],
-    zipFile: 'base64-encoded-zip',
+  input: {
+    agentRuntimeName: 'my-agent',
+    codeConfiguration: await codeFromFile(
+      AgentRuntimeLanguage.NODEJS18,
+      ['node', 'index.js'],
+      './my-agent-code'
+    ),
+    port: 9000,
+    cpu: 2,
+    memory: 4096,
   },
 });
 
-// 等待就绪
-await runtime.waitUntilReady();
+// 等待就绪 (READY 或 *_FAILED)
+await runtime.waitUntilReadyOrFailed();
 
 // 创建端点
 const endpoint = await runtime.createEndpoint({
-  agentRuntimeEndpointName: 'default',
+  input: { agentRuntimeEndpointName: 'default' },
 });
 
-await endpoint.waitUntilReady();
+await endpoint.waitUntilReadyOrFailed();
 console.log('Endpoint URL:', endpoint.endpointPublicUrl);
 
 // 删除
@@ -75,26 +85,31 @@ await runtime.delete();
 ### Sandbox
 
 ```typescript
-import { SandboxClient, TemplateType } from '@alicloud/agentrun-sdk';
+import { SandboxClient, Template, TemplateType } from '@agentrun/sdk';
 
 const client = new SandboxClient();
 
 // 创建模板
-const template = await client.createTemplate({
-  templateName: 'my-template',
-  templateType: TemplateType.CODE_INTERPRETER,
+const template = await Template.create({
+  input: {
+    templateName: 'my-template',
+    templateType: TemplateType.CODE_INTERPRETER,
+  },
 });
 
-await template.waitUntilReady();
+await template.waitUntilReadyOrFailed();
 
 // 创建沙箱
-const sandbox = await client.createCodeInterpreterSandbox(
-  template.templateName!
-);
+const sandbox = await client.createCodeInterpreterSandbox({
+  templateName: template.templateName!,
+});
 await sandbox.waitUntilRunning();
+await sandbox.waitUntilReadyOrFailed();
 
-// 执行代码 (需要数据 API 支持)
-// const result = await sandbox.executeCode('print("Hello!")');
+// 执行代码
+const ctx = await sandbox.context.create();
+const result = await ctx.execute({ code: "print('Hello!')" });
+console.log(result);
 
 // 删除
 await sandbox.delete();
@@ -109,15 +124,15 @@ await template.delete();
 | **Credential**   | 凭证管理                          |
 | **Model**        | 模型服务和代理管理                |
 | **Sandbox**      | 沙箱环境管理 (代码解释器、浏览器) |
+| **ToolSet**      | OpenAPI / MCP 工具集管理          |
+| **Server**       | OpenAI 兼容的 HTTP 服务器         |
+| **Integration**  | Mastra 等第三方框架集成           |
 
 ## 示例
 
-运行示例：
+`examples/` 目录下提供了各模块的端到端示例：
 
 ```bash
-# 快速开始 - 启动 Agent 服务器
-npm run example:quick-start
-
 # Agent Runtime 示例
 npm run example:agent-runtime
 
@@ -128,6 +143,14 @@ npm run example:credential
 npm run example:sandbox
 ```
 
+其他可直接运行的示例（用 `npx tsx` 启动）：
+
+```bash
+npx tsx examples/model.ts
+npx tsx examples/toolset.ts
+npx tsx examples/mastra.ts
+```
+
 ## 开发
 
 ```bash
@@ -156,13 +179,18 @@ npm run format:fix  # 同时运行格式化和lint修复
 
 ## 环境变量
 
-| 变量                         | 描述                     | 默认值        |
-| ---------------------------- | ------------------------ | ------------- |
-| `AGENTRUN_ACCESS_KEY_ID`     | 阿里云 Access Key ID     | -             |
-| `AGENTRUN_ACCESS_KEY_SECRET` | 阿里云 Access Key Secret | -             |
-| `AGENTRUN_ACCOUNT_ID`        | 阿里云账号 ID            | -             |
-| `AGENTRUN_REGION`            | 区域 ID                  | `cn-hangzhou` |
-| `AGENTRUN_TIMEOUT`           | API 超时时间 (毫秒)      | `600000`      |
+| 变量                         | 描述                                                                 | 默认值        |
+| ---------------------------- | -------------------------------------------------------------------- | ------------- |
+| `AGENTRUN_ACCESS_KEY_ID`     | 阿里云 Access Key ID（回退到 `ALIBABA_CLOUD_ACCESS_KEY_ID`）         | -             |
+| `AGENTRUN_ACCESS_KEY_SECRET` | 阿里云 Access Key Secret（回退到 `ALIBABA_CLOUD_ACCESS_KEY_SECRET`） | -             |
+| `AGENTRUN_SECURITY_TOKEN`    | STS 临时安全令牌（回退到 `ALIBABA_CLOUD_SECURITY_TOKEN`）            | -             |
+| `AGENTRUN_ACCOUNT_ID`        | 阿里云账号 ID（回退到 `FC_ACCOUNT_ID`）                              | -             |
+| `AGENTRUN_REGION`            | 区域 ID（回退到 `FC_REGION`）                                        | `cn-hangzhou` |
+| `AGENTRUN_CONTROL_ENDPOINT`  | 自定义控制面 API 端点                                                | 区域默认值    |
+| `AGENTRUN_DATA_ENDPOINT`     | 自定义数据面 API 端点                                                | 区域默认值    |
+| `DEVS_ENDPOINT`              | 自定义 DevS API 端点                                                 | 区域默认值    |
+
+> 超时和读超时通过 `new Config({ timeout, readTimeout })` 在代码中配置（单位：毫秒），不通过环境变量读取。
 
 ## 兼容性
 

From 20486f72735e7790ce28925d55c0d1e3b730b266 Mon Sep 17 00:00:00 2001
From: OhYee <oyohyee@oyohyee.com>
Date: Sat, 25 Apr 2026 14:04:54 +0800
Subject: [PATCH 4/5] =?UTF-8?q?style(test):=20=E5=BA=94=E7=94=A8=20prettie?=
 =?UTF-8?q?r=20=E4=BF=AE=E6=AD=A3=20control-api=20=E6=B5=8B=E8=AF=95?=
 =?UTF-8?q?=E6=A0=BC=E5=BC=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

上一次提交 control-api.test.ts 时未跑 prettier，仓库 format:check
检测到行宽超限。此次不改任何断言/逻辑，仅由 prettier 把过长的行
合并为单行，使 npm run format:check 重新通过。

Change-Id: Ibd76e461ffd5e1b576ce44cf4282637d0e9935f1
Co-developed-by: Claude <noreply@anthropic.com>
Signed-off-by: OhYee <oyohyee@oyohyee.com>
---
 tests/unittests/sandbox/control-api.test.ts | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/tests/unittests/sandbox/control-api.test.ts b/tests/unittests/sandbox/control-api.test.ts
index 13391ee..6c1b39a 100644
--- a/tests/unittests/sandbox/control-api.test.ts
+++ b/tests/unittests/sandbox/control-api.test.ts
@@ -44,9 +44,7 @@ describe('SandboxControlAPI.createSandbox readTimeout', () => {
   });
 
   it('honors readTimeout from instance config', async () => {
-    const api = new SandboxControlAPI(
-      new Config({ accountId: 'acc', readTimeout: 60000 })
-    );
+    const api = new SandboxControlAPI(new Config({ accountId: 'acc', readTimeout: 60000 }));
     await api.createSandbox({ input: {} as any });
 
     expect(mockRuntimeOptions).toHaveBeenCalledWith(
@@ -67,9 +65,7 @@ describe('SandboxControlAPI.createSandbox readTimeout', () => {
   });
 
   it('method-level config wins over instance config', async () => {
-    const api = new SandboxControlAPI(
-      new Config({ accountId: 'acc', readTimeout: 60000 })
-    );
+    const api = new SandboxControlAPI(new Config({ accountId: 'acc', readTimeout: 60000 }));
     await api.createSandbox({
       input: {} as any,
       config: new Config({ accountId: 'acc', readTimeout: 90000 }),

From 60b53c95fe03d334e2ab41bdcb146171a8065e7f Mon Sep 17 00:00:00 2001
From: OhYee <oyohyee@oyohyee.com>
Date: Sat, 25 Apr 2026 15:13:41 +0800
Subject: [PATCH 5/5] =?UTF-8?q?test(sdk):=20=E8=A6=86=E7=9B=96=20endpoint/?=
 =?UTF-8?q?template=20=E5=AE=9E=E4=BE=8B=20get=20=E7=9A=84=20=5Fconfig=20f?=
 =?UTF-8?q?allback=20=E5=88=86=E6=94=AF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

之前在 fix(sdk): 修复方法级 config 在调用链中被悄悄丢弃中给
AgentRuntimeEndpoint.get 与 Template.get 的实例方法补了
config ?? this._config fallback，但没有相应的测试覆盖两个分支，
导致 agent-runtime 分支覆盖率从 ≥95% 跌到 93.64%、sandbox 跌到
90%，未能通过覆盖率门禁。

补两组等价的 case 分别命中两个分支:

- tests/unittests/agent-runtime/agent-runtime.test.ts: 新增
  describe('get (instance)')，分别验证 endpoint.get({ config })
  时透传 params.config，以及 endpoint.get() 时回落到构造时传入的
  instance _config
- tests/unittests/sandbox/template.test.ts: 同构地为 Template
  实例 get 增加 params.config 与 _config fallback 两个 case

补完后覆盖率：agent-runtime 分支 95.45%、sandbox 分支 100%、全量
分支 97.37%，重新跨过 95% 门槛。

Change-Id: I61ddc203253722378e83abe4eef639932bda8b64
Co-developed-by: Claude <noreply@anthropic.com>
Signed-off-by: OhYee <oyohyee@oyohyee.com>
---
 .../agent-runtime/agent-runtime.test.ts       | 49 +++++++++++++++++++
 tests/unittests/sandbox/template.test.ts      | 38 ++++++++++++++
 2 files changed, 87 insertions(+)

diff --git a/tests/unittests/agent-runtime/agent-runtime.test.ts b/tests/unittests/agent-runtime/agent-runtime.test.ts
index 3aaa761..a273841 100644
--- a/tests/unittests/agent-runtime/agent-runtime.test.ts
+++ b/tests/unittests/agent-runtime/agent-runtime.test.ts
@@ -1568,6 +1568,55 @@ describe('Agent Runtime Module', () => {
         });
       });
 
+      describe('get (instance)', () => {
+        it('should fetch using params.config when provided', async () => {
+          mockControlApi.getAgentRuntimeEndpoint.mockResolvedValue({
+            agentRuntimeEndpointId: 'endpoint-123',
+            agentRuntimeEndpointName: 'test-endpoint',
+            status: 'READY',
+          });
+
+          const instanceConfig = new Config({ accountId: 'instance-acc' });
+          const callConfig = new Config({ accountId: 'call-acc' });
+
+          const endpoint = new AgentRuntimeEndpoint(
+            {
+              agentRuntimeId: 'runtime-123',
+              agentRuntimeEndpointId: 'endpoint-123',
+            },
+            instanceConfig
+          );
+
+          await endpoint.get({ config: callConfig });
+
+          expect(mockControlApi.getAgentRuntimeEndpoint).toHaveBeenCalledWith(
+            expect.objectContaining({ config: callConfig })
+          );
+        });
+
+        it('should fall back to instance _config when params.config is missing', async () => {
+          mockControlApi.getAgentRuntimeEndpoint.mockResolvedValue({
+            agentRuntimeEndpointId: 'endpoint-123',
+          });
+
+          const instanceConfig = new Config({ accountId: 'instance-acc' });
+
+          const endpoint = new AgentRuntimeEndpoint(
+            {
+              agentRuntimeId: 'runtime-123',
+              agentRuntimeEndpointId: 'endpoint-123',
+            },
+            instanceConfig
+          );
+
+          await endpoint.get();
+
+          expect(mockControlApi.getAgentRuntimeEndpoint).toHaveBeenCalledWith(
+            expect.objectContaining({ config: instanceConfig })
+          );
+        });
+      });
+
       describe('waitUntilReady', () => {
         it('should wait until status is READY', async () => {
           let callCount = 0;
diff --git a/tests/unittests/sandbox/template.test.ts b/tests/unittests/sandbox/template.test.ts
index 6f04f5f..fcaf35a 100644
--- a/tests/unittests/sandbox/template.test.ts
+++ b/tests/unittests/sandbox/template.test.ts
@@ -725,6 +725,44 @@ describe('Template', () => {
       });
     });
 
+    describe('get (instance)', () => {
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const { Config } = require('../../../src/utils/config');
+
+      it('should fetch using params.config when provided', async () => {
+        mockClientGetTemplate.mockResolvedValue({
+          templateId: 'template-123',
+          templateName: 'test-template',
+        });
+
+        const instanceConfig = new Config({ accountId: 'instance-acc' });
+        const callConfig = new Config({ accountId: 'call-acc' });
+
+        const template = new Template({ templateName: 'test-template' }, instanceConfig);
+        await template.get({ config: callConfig });
+
+        expect(mockClientGetTemplate).toHaveBeenCalledWith(
+          expect.objectContaining({ config: callConfig })
+        );
+      });
+
+      it('should fall back to instance _config when params.config is missing', async () => {
+        mockClientGetTemplate.mockResolvedValue({
+          templateId: 'template-123',
+          templateName: 'test-template',
+        });
+
+        const instanceConfig = new Config({ accountId: 'instance-acc' });
+        const template = new Template({ templateName: 'test-template' }, instanceConfig);
+
+        await template.get();
+
+        expect(mockClientGetTemplate).toHaveBeenCalledWith(
+          expect.objectContaining({ config: instanceConfig })
+        );
+      });
+    });
+
     describe('waitUntilReady', () => {
       it('should return immediately if already ready', async () => {
         mockClientGetTemplate.mockResolvedValue({