refactor(sandbox): migrate to object-based API parameters with backward compatibility

This commit refactors the entire sandbox API to use object-based parameter passing
instead of positional arguments. All methods now accept parameters as objects
with { input, config } pattern while maintaining backward compatibility through
deprecation warnings for old signatures.

The changes affect:
- Client methods (createTemplate, deleteTemplate, etc.)
- Sandbox creation and management methods
- Template operations
- All sandbox subclasses (AIO, Browser, CodeInterpreter, Custom)
- Test suites updated for new parameter patterns

Additionally, numeric field normalization is added to templates to ensure
consistent data types across string and number representations.

BREAKING CHANGE: Old parameter patterns are deprecated and will be removed in future versions.

此提交重构了整个沙箱 API 以使用基于对象的参数传递，
而不是位置参数。所有方法现在都接受 { input, config } 模式的对象参数，
同时通过弃用警告保留旧签名的向后兼容性。

更改影响：
- 客户端方法（createTemplate、deleteTemplate 等）
- 沙箱创建和管理方法
- 模板操作
- 所有沙箱子类（AIO、Browser、CodeInterpreter、Custom）
- 更新测试套件以适应新的参数模式

此外，向模板添加数字字段规范化，以确保字符串和数字表示形式的数据类型一致。

重大变更：旧参数模式已被弃用，并将在未来版本中移除。

Change-Id: I73e043e97ae2c8363a0f1172eed14da27a777e7c
Signed-off-by: OhYee <oyohyee@oyohyee.com>

Author: OhYee

examples/sandbox.ts

@@ -39,7 +39,7 @@ const client = new SandboxClient();
 async function listTemplates(): Promise<void> {
   log('枚举模板列表 / Listing templates');
 
-  const templates = await client.listAllTemplates();
+  const templates = await client.listTemplates();
   log(`共有 ${templates.length} 个模板 / Total ${templates.length} templates:`);
 
   for (const template of templates) {
@@ -76,10 +76,12 @@ async function codeInterpreterExample(): Promise<void> {
   // 创建模板 / Create template
   log('\n--- 创建模板 / Creating template ---');
   const template = await Template.create({
-    templateName,
-    templateType: TemplateType.CODE_INTERPRETER,
-    description: 'Test template from Node.js SDK',
-    sandboxIdleTimeoutInSeconds: 600,
+    input: {
+      templateName,
+      templateType: TemplateType.CODE_INTERPRETER,
+      description: 'Test template from Node.js SDK',
+      sandboxIdleTimeoutInSeconds: 600,
+    }
   });
 
   log(`✓ 创建模板成功 / Template created: ${template.templateName}`);
@@ -158,9 +160,9 @@ async function codeInterpreterExample(): Promise<void> {
   });
   log(`✓ 上传文件成功 / File uploaded successfully`);
 
-  const filestat = await sandbox.fileSystem.stat(
-    '/home/user/test-move/test_file.txt'
-  );
+  const filestat = await sandbox.fileSystem.stat({
+    path: '/home/user/test-move/test_file.txt'
+  });
   log(`✓ 上传文件详情 / Uploaded file stat:`, filestat);
 
   const downloadPath = './downloaded_test_file.txt';
@@ -187,7 +189,7 @@ async function codeInterpreterExample(): Promise<void> {
   });
   log(`✓ 写入文件成功 / File written successfully`);
 
-  const readResult = await sandbox.file.read('/home/user/test/test.txt');
+  const readResult = await sandbox.file.read({ path: '/home/user/test/test.txt' });
   log(`✓ 读取文件结果 / File read result:`, readResult);
 
   // 测试文件移动 / File move test
@@ -198,19 +200,19 @@ async function codeInterpreterExample(): Promise<void> {
   });
   log(`✓ 移动文件成功 / File moved successfully`);
 
-  const movedContent = await sandbox.file.read(
-    '/home/user/test-move/test2.txt'
-  );
+  const movedContent = await sandbox.file.read({
+    path: '/home/user/test-move/test2.txt'
+  });
   log(`✓ 读取移动后的文件 / Read moved file:`, movedContent);
 
   // 测试文件详情 / File stat test
   log('\n--- 测试文件详情 / Testing file stat ---');
-  const dirStat = await sandbox.fileSystem.stat('/home/user/test-move');
+  const dirStat = await sandbox.fileSystem.stat({ path: '/home/user/test-move' });
   log(`✓ 文件详情 / File stat:`, dirStat);
 
   // 测试删除文件 / Delete test
   log('\n--- 测试删除文件 / Testing file deletion ---');
-  await sandbox.fileSystem.remove('/home/user/test-move');
+  await sandbox.fileSystem.remove({ path: '/home/user/test-move' });
   log(`✓ 删除文件夹成功 / Directory deleted successfully`);
 
   // 测试进程操作 / Process operations
@@ -221,7 +223,7 @@ async function codeInterpreterExample(): Promise<void> {
   const cmdResult = await sandbox.process.cmd({ command: 'ls', cwd: '/' });
   log(`✓ 进程执行结果 / Process execution result:`, cmdResult);
 
-  const processDetails = await sandbox.process.get('1');
+  const processDetails = await sandbox.process.get({ pid: '1' });
   log(`✓ 进程详情 / Process details:`, processDetails);
 
   // 清理上下文

src/sandbox/aio-sandbox.ts

@@ -311,19 +311,19 @@ export class AioSandbox extends Sandbox {
     },
     config?: Config
   ): Promise<AioSandbox> {
-    const sandbox = await Sandbox.create(
-      {
+    const sandbox = await Sandbox.create({
+      input: {
         templateName,
         sandboxIdleTimeoutSeconds: options?.sandboxIdleTimeoutSeconds,
         nasConfig: options?.nasConfig,
         ossMountConfig: options?.ossMountConfig,
         polarFsConfig: options?.polarFsConfig,
       },
-      config
-    );
+      templateType: TemplateType.AIO,
+      config,
+    });
 
-    const aioSandbox = new AioSandbox(sandbox, config);
-    return aioSandbox;
+    return sandbox as AioSandbox;
   }
 
   constructor(sandbox: Sandbox, config?: Config) {

src/sandbox/browser-sandbox.ts

@@ -38,19 +38,19 @@ export class BrowserSandbox extends Sandbox {
     },
     config?: Config
   ): Promise<BrowserSandbox> {
-    const sandbox = await Sandbox.create(
-      {
+    const sandbox = await Sandbox.create({
+      input: {
         templateName,
         sandboxIdleTimeoutSeconds: options?.sandboxIdleTimeoutSeconds,
         nasConfig: options?.nasConfig,
         ossMountConfig: options?.ossMountConfig,
         polarFsConfig: options?.polarFsConfig,
       },
-      config
-    );
+      templateType: TemplateType.BROWSER,
+      config,
+    });
 
-    const browserSandbox = new BrowserSandbox(sandbox, config);
-    return browserSandbox;
+    return sandbox as BrowserSandbox;
   }
 
   constructor(sandbox: Sandbox, config?: Config) {