@sandbank.dev/core 0.2.1 → 0.3.4

package/README.md

@@ -18,11 +18,17 @@ const provider = createProvider(
   new DaytonaAdapter({ apiKey: process.env.DAYTONA_API_KEY! })
 )
 
-// Create and use a sandbox
-const sandbox = await provider.create({ image: 'node:22' })
+// Create a sandbox with a non-root user
+const sandbox = await provider.create({
+  image: 'node:22',
+  user: 'sandbank',            // creates non-root user with sudo
+})
 const { stdout } = await sandbox.exec('node --version')
 await sandbox.writeFile('/app/index.js', 'console.log("hi")')
 
+// Run privileged commands with asRoot
+await sandbox.exec('apt-get update', { asRoot: true })
+
 // Capability detection
 const terminal = withTerminal(sandbox)
 if (terminal) {

package/dist/hooks.d.ts

@@ -0,0 +1,78 @@
+import type { Sandbox } from './types.js';
+export type ClaudeHookEvent = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'Stop';
+export interface InjectHooksConfig {
+    /**
+     * Event destination.
+     * - http: 使用 Claude Code 内置 HTTP hook 类型（sandbox 需能访问该 URL）
+     * - file: 使用 command hook 将事件追加到 JSONL 文件
+     */
+    endpoint: {
+        type: 'http';
+        url: string;
+        headers?: Record<string, string>;
+    } | {
+        type: 'file';
+        path?: string;
+    };
+    /** 要捕获的事件。默认: ['PostToolUse', 'Stop'] */
+    events?: ClaudeHookEvent[];
+    /** 是否异步执行 hook（不阻塞 agent）。默认: true */
+    async?: boolean;
+    /**
+     * settings.json 写入路径。默认: 自动检测 $HOME/.claude/settings.json
+     * 传入目录时会追加 /.claude/settings.json
+     */
+    settingsDir?: string;
+}
+export interface HookEventData {
+    /** Unix timestamp (ms) */
+    ts: number;
+    /** 原始 hook 输入数据 */
+    data: Record<string, unknown>;
+}
+export interface ClaudeLoginConfig {
+    /** 每次按 Enter 的间隔秒数。默认: 2 */
+    enterInterval?: number;
+    /** 最大按 Enter 次数。默认: 30 */
+    maxRetries?: number;
+    /** 安装依赖的命令。默认: apt-get update -qq && apt-get install -y -qq screen */
+    installCommand?: string;
+}
+export interface ClaudeLoginResult {
+    /** OAuth 授权 URL，用户需要在浏览器中打开 */
+    url: string;
+    /**
+     * 将 OAuth 回调返回的 auth code 发送到沙箱内的 claude login 进程。
+     * 使用 screen -X source 注入字符到 PTY，避免 shell 转义问题。
+     */
+    sendCode: (code: string) => Promise<void>;
+    /**
+     * 等待登录完成。用户在浏览器中完成授权后，此函数 resolve。
+     * 超时则 reject。
+     */
+    waitForCredentials: (timeoutMs?: number) => Promise<void>;
+}
+export declare const DEFAULT_EVENTS_FILE = "/tmp/sandbank-hook-events.jsonl";
+/**
+ * 将 Claude Code hooks 配置注入沙箱。
+ * hooks 会在 agent 的每次工具调用后自动触发，将事件发送到指定端点。
+ */
+export declare function injectClaudeHooks(sandbox: Sandbox, config: InjectHooksConfig): Promise<void>;
+/**
+ * 从沙箱内的 JSONL 文件读取 hook 事件。
+ * 用于 file 模式下拉取事件。
+ */
+export declare function readHookEvents(sandbox: Sandbox, path?: string): Promise<HookEventData[]>;
+/**
+ * 在沙箱内自动化 `claude login`，捕获 OAuth 授权 URL。
+ *
+ * 使用 GNU screen 管理 PTY:
+ * - screen 提供真实 PTY，满足 claude login 的 TUI 需求
+ * - screen -X stuff 注入按键（导航 TUI）
+ * - screen -X hardcopy 截取屏幕纯文本（无 ANSI 转义码）
+ * - screen -X source 执行 stuff 命令文件（精确控制注入内容）
+ *
+ * 返回 URL 和 sendCode/waitForCredentials 回调。
+ */
+export declare function startClaudeLogin(sandbox: Sandbox, config?: ClaudeLoginConfig): Promise<ClaudeLoginResult>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAIzC,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,aAAa,GAAG,oBAAoB,GAAG,MAAM,CAAA;AAE1F,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,EACJ;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAC/D;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAEnC,yCAAyC;IACzC,MAAM,CAAC,EAAE,eAAe,EAAE,CAAA;IAE1B,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAA;IAEf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAA;IACX;;;OAGG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC;;;OAGG;IACH,kBAAkB,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1D;AAID,eAAO,MAAM,mBAAmB,oCAAoC,CAAA;AAOpE;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CAoCf;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,EAAE,CAAC,CAU1B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAwH5B"}

package/dist/hooks.js

@@ -0,0 +1,218 @@
+// --- Constants ---
+export const DEFAULT_EVENTS_FILE = '/tmp/sandbank-hook-events.jsonl';
+const HANDLER_SCRIPT_PATH = '/tmp/sandbank-hook-handler.sh';
+const SCREEN_SESSION = 'claude-login';
+const SCREEN_OUTPUT = '/tmp/sandbank-screen-output';
+// --- Public API ---
+/**
+ * 将 Claude Code hooks 配置注入沙箱。
+ * hooks 会在 agent 的每次工具调用后自动触发，将事件发送到指定端点。
+ */
+export async function injectClaudeHooks(sandbox, config) {
+    const events = config.events ?? ['PostToolUse', 'Stop'];
+    const isAsync = config.async ?? true;
+    const hooksConfig = {};
+    for (const event of events) {
+        const hookDef = buildHookDef(event, config, isAsync);
+        hooksConfig[event] = [{
+                ...(event !== 'Stop' ? { matcher: '.*' } : {}),
+                hooks: [hookDef],
+            }];
+    }
+    const settings = { hooks: hooksConfig };
+    // 确定 settings 目录：用户指定 > 自动检测 $HOME
+    let baseDir = config.settingsDir;
+    if (!baseDir) {
+        const homeResult = await sandbox.exec('echo $HOME');
+        baseDir = homeResult.stdout.trim() || '/root';
+    }
+    const claudeDir = `${baseDir}/.claude`;
+    const settingsPath = `${claudeDir}/settings.json`;
+    // 确保 .claude 目录存在
+    await sandbox.exec(`mkdir -p '${claudeDir}'`);
+    // 写入 settings.json
+    await sandbox.writeFile(settingsPath, JSON.stringify(settings, null, 2));
+    // file 模式: 写入 handler 脚本并创建事件文件
+    if (config.endpoint.type === 'file') {
+        const eventsPath = config.endpoint.path ?? DEFAULT_EVENTS_FILE;
+        await writeHandlerScript(sandbox, eventsPath);
+    }
+}
+/**
+ * 从沙箱内的 JSONL 文件读取 hook 事件。
+ * 用于 file 模式下拉取事件。
+ */
+export async function readHookEvents(sandbox, path) {
+    const filePath = path ?? DEFAULT_EVENTS_FILE;
+    const result = await sandbox.exec(`cat '${filePath}' 2>/dev/null || true`);
+    const output = result.stdout.trim();
+    if (!output)
+        return [];
+    return output
+        .split('\n')
+        .filter(line => line.trim())
+        .map(line => JSON.parse(line));
+}
+/**
+ * 在沙箱内自动化 `claude login`，捕获 OAuth 授权 URL。
+ *
+ * 使用 GNU screen 管理 PTY:
+ * - screen 提供真实 PTY，满足 claude login 的 TUI 需求
+ * - screen -X stuff 注入按键（导航 TUI）
+ * - screen -X hardcopy 截取屏幕纯文本（无 ANSI 转义码）
+ * - screen -X source 执行 stuff 命令文件（精确控制注入内容）
+ *
+ * 返回 URL 和 sendCode/waitForCredentials 回调。
+ */
+export async function startClaudeLogin(sandbox, config) {
+    const enterInterval = config?.enterInterval ?? 2;
+    const maxRetries = config?.maxRetries ?? 30;
+    const installCmd = config?.installCommand
+        ?? 'apt-get update -qq && apt-get install -y -qq screen';
+    // 1. 确保 screen 已安装（需 root 权限安装包）
+    const checkScreen = await sandbox.exec('which screen 2>/dev/null');
+    if (checkScreen.exitCode !== 0) {
+        const installResult = await sandbox.exec(installCmd, { timeout: 60_000, asRoot: true });
+        if (installResult.exitCode !== 0) {
+            throw new Error(`Failed to install screen: ${installResult.stderr || installResult.stdout}`);
+        }
+    }
+    // 2. 清理旧文件和 screen 会话
+    await sandbox.exec(`screen -S ${SCREEN_SESSION} -X quit 2>/dev/null || true; `
+        + `rm -f '${SCREEN_OUTPUT}' /tmp/sandbank-code-debug /tmp/sandbank-screen-cmd`);
+    // 3. 在 screen 会话中启动 claude login
+    //    **不要** stty columns 1000 — screen 虚拟终端固定 80 列，
+    //    stty 改宽度会让 TUI 不换行，但超出 80 列的部分直接不可见（hardcopy 不捕获）。
+    //    保持默认 80 列让 URL 自然换行，extractUrlFromText 会 trimEnd+join 重组。
+    await sandbox.exec(`screen -dmS ${SCREEN_SESSION} bash -c 'exec claude login'`);
+    // 等待 screen 会话启动
+    await new Promise(r => setTimeout(r, 2000));
+    // 4. 反复检查屏幕并发送 Enter 直到出现 OAuth URL
+    //    关键: 先检查再发送 Enter，避免 URL 出现后多发一个 Enter 误提交空 code
+    let urlFound = false;
+    for (let i = 0; i < maxRetries; i++) {
+        await new Promise(r => setTimeout(r, enterInterval * 1000));
+        // 先检查当前屏幕（纯文本，无 ANSI 转义码）
+        await sandbox.exec(`screen -S ${SCREEN_SESSION} -X hardcopy ${SCREEN_OUTPUT}`);
+        const result = await sandbox.exec(`cat '${SCREEN_OUTPUT}' 2>/dev/null || true`);
+        if (result.stdout.includes('claude.ai/oauth')) {
+            urlFound = true;
+            break;
+        }
+        // URL 未找到，发送 Enter 导航 TUI
+        await sandbox.exec(`screen -S ${SCREEN_SESSION} -X stuff $'\\r'`);
+    }
+    if (!urlFound) {
+        const output = await sandbox.exec(`cat '${SCREEN_OUTPUT}' 2>/dev/null || true`);
+        throw new Error(`Failed to detect OAuth URL after ${maxRetries} retries.\n`
+            + `Screen output:\n${output.stdout.substring(0, 1000)}`);
+    }
+    // 5. 从 hardcopy 提取完整 URL（extractUrlFromText 处理 80 列断行）
+    const screenResult = await sandbox.exec(`cat '${SCREEN_OUTPUT}' 2>/dev/null || true`);
+    const url = extractUrlFromText(screenResult.stdout);
+    if (!url) {
+        throw new Error(`OAuth URL detected but failed to extract.\n`
+            + `Screen output:\n${screenResult.stdout.substring(0, 1000)}`);
+    }
+    // 6. sendCode: 用 screen source + stuff 注入 code
+    const sendCode = async (code) => {
+        // 检查当前 screen 状态 — 如果之前的 Enter 导致了 "Invalid code"，先恢复
+        await sandbox.exec(`screen -S ${SCREEN_SESSION} -X hardcopy /tmp/sandbank-pre-send`);
+        const preState = await sandbox.exec('cat /tmp/sandbank-pre-send 2>/dev/null');
+        if (preState.stdout.match(/retry|try.again|Invalid/i)) {
+            // 发送 Enter 跳过 retry 提示，回到 code 输入
+            await sandbox.exec(`screen -S ${SCREEN_SESSION} -X stuff $'\\r'`);
+            await new Promise(r => setTimeout(r, 3000));
+        }
+        // 直接用 screen -X stuff 注入 code + CR
+        // 不能用 source 文件：auth code 含 # 字符，screen source 解析器会把 # 后内容当注释
+        // 用 $'...\r' 安全发送：$'...' 内 # 是字面量，\r 被 bash 解释为 CR
+        const escaped = code.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+        await sandbox.exec(`screen -S ${SCREEN_SESSION} -X stuff $'${escaped}\\r'`);
+    };
+    // 7. waitForCredentials
+    const waitForCredentials = async (timeoutMs = 300_000) => {
+        const homeResult = await sandbox.exec('echo $HOME');
+        const home = homeResult.stdout.trim() || '/root';
+        const credPath = `${home}/.claude/.credentials.json`;
+        const start = Date.now();
+        const interval = 2000;
+        while (Date.now() - start < timeoutMs) {
+            const check = await sandbox.exec(`test -s '${credPath}' && echo OK || echo MISSING`);
+            if (check.stdout.trim() === 'OK') {
+                return;
+            }
+            await new Promise(r => setTimeout(r, interval));
+        }
+        // 收集诊断信息
+        const diag = [`Timed out waiting for credentials at ${credPath} (${timeoutMs}ms)`];
+        await sandbox.exec(`screen -S ${SCREEN_SESSION} -X hardcopy /tmp/sandbank-screen-final 2>/dev/null || true`);
+        const screenFinal = await sandbox.exec('cat /tmp/sandbank-screen-final 2>/dev/null');
+        if (screenFinal.stdout)
+            diag.push(`Screen (final):\n${screenFinal.stdout}`);
+        const codeDebug = await sandbox.exec('cat /tmp/sandbank-code-debug 2>/dev/null');
+        if (codeDebug.stdout)
+            diag.push(`Code debug:\n${codeDebug.stdout}`);
+        const screenCmd = await sandbox.exec('cat /tmp/sandbank-screen-cmd 2>/dev/null');
+        if (screenCmd.stdout)
+            diag.push(`Screen cmd:\n${screenCmd.stdout}`);
+        const psResult = await sandbox.exec('ps aux | grep -E "screen|claude" | grep -v grep 2>/dev/null');
+        if (psResult.stdout)
+            diag.push(`Processes:\n${psResult.stdout}`);
+        throw new Error(diag.join('\n\n'));
+    };
+    return { url, sendCode, waitForCredentials };
+}
+// --- Internal ---
+function buildHookDef(event, config, isAsync) {
+    if (config.endpoint.type === 'http') {
+        return {
+            type: 'http',
+            url: config.endpoint.url,
+            ...(config.endpoint.headers ? { headers: config.endpoint.headers } : {}),
+            timeout: 10,
+        };
+    }
+    // file 模式: 使用 command hook 调用 handler 脚本
+    return {
+        type: 'command',
+        command: HANDLER_SCRIPT_PATH,
+        timeout: 5,
+        async: isAsync,
+    };
+}
+const URL_RE = /https?:\/\/[^\s'"><]+/g;
+/**
+ * 从 screen hardcopy 纯文本中提取 OAuth URL。
+ *
+ * hardcopy 按 screen 虚拟终端宽度（默认 80 列）输出，
+ * 长 URL 会被断行，每行尾部填充空格到 80 列。
+ * 先 trimEnd 每行再拼接，消除断行产生的空格，重组完整 URL。
+ */
+function extractUrlFromText(text) {
+    if (!text)
+        return null;
+    // 重组被 hardcopy 断行的长 URL
+    const joined = text.split('\n').map(line => line.trimEnd()).join('');
+    const urls = joined.match(URL_RE);
+    if (!urls)
+        return null;
+    const oauthUrls = urls.filter(u => u.includes('claude.ai/oauth'));
+    if (oauthUrls.length === 0)
+        return null;
+    return oauthUrls.reduce((a, b) => a.length >= b.length ? a : b);
+}
+async function writeHandlerScript(sandbox, eventsPath) {
+    // 使用纯 POSIX shell 以保证最大兼容性
+    // tr -d '\n' 确保多行 JSON 输入被压成单行 JSONL
+    const script = `#!/bin/sh
+TS=$(($(date +%s) * 1000))
+INPUT=$(cat | tr -d '\\n')
+printf '{"ts":%d,"data":%s}\\n' "$TS" "$INPUT" >> '${eventsPath}'
+`;
+    await sandbox.writeFile(HANDLER_SCRIPT_PATH, script);
+    // writeFile 以 root 写入，chmod 需 root 权限
+    await sandbox.exec(`chmod +x '${HANDLER_SCRIPT_PATH}'`, { asRoot: true });
+    // events 文件由 hook handler（以沙箱用户身份）追加写入，需用户可写
+    await sandbox.exec(`touch '${eventsPath}'`);
+}

package/dist/index.d.ts

@@ -1,10 +1,15 @@
-export type { SandboxProvider, Sandbox, CreateConfig, ExecOptions, ExecResult, SandboxState, SandboxInfo, ListFilter, Capability, StreamableSandbox, TerminalSandbox, TerminalOptions, TerminalInfo, TerminalSession, Disposable, SleepableSandbox, PortExposeSandbox, SnapshotSandbox, VolumeProvider, VolumeConfig, VolumeInfo, ServiceType, ServiceConfig, ServiceCredentials, ServiceInfo, ServiceProvider, ServiceBinding, SandboxAdapter, AdapterSandbox, SkillDefinition, } from './types.js';
+export type { SandboxProvider, Sandbox, CreateConfig, ExecOptions, ExecResult, SandboxState, SandboxInfo, ListFilter, Capability, StreamableSandbox, TerminalSandbox, TerminalOptions, TerminalInfo, TerminalSession, Disposable, SleepableSandbox, PortExposeSandbox, SnapshotSandbox, VolumeProvider, VolumeConfig, VolumeInfo, ServiceType, ServiceConfig, ServiceCredentials, ServiceInfo, ServiceProvider, ServiceBinding, SandboxAdapter, AdapterSandbox, SkillDefinition, SandboxUser, SandboxUserInfo, } from './types.js';
 export { createProvider } from './provider.js';
 export { hasCapability, withStreaming, withTerminal, withSleep, withPortExpose, withSnapshot, withVolumes, withServices, } from './capabilities.js';
 export { SandboxError, SandboxNotFoundError, SandboxStateError, ExecTimeoutError, RateLimitError, ProviderError, CapabilityNotSupportedError, } from './errors.js';
 export { connectTerminal } from './terminal.js';
 export { injectSkills } from './skill-inject.js';
 export { writeFileViaExec, readFileViaExec, uploadArchiveViaExec, downloadArchiveViaExec } from './file-helpers.js';
+export { setupSandboxUser, wrapAsUser } from './sandbox-user.js';
+export type { SandboxEvent, SandboxEventType, SandboxObserver, ProviderOptions } from './observer.js';
+export { emitEvent, createNoopObserver, createWebhookObserver } from './observer.js';
+export type { ClaudeHookEvent, InjectHooksConfig, HookEventData, ClaudeLoginConfig, ClaudeLoginResult } from './hooks.js';
+export { injectClaudeHooks, readHookEvents, startClaudeLogin, DEFAULT_EVENTS_FILE } from './hooks.js';
 export type { MessagePriority, SessionMessage, ContextStore, CompletionStatus, SandboxCompletion, SendOptions, Session, RelayConfig, CreateSessionConfig, JsonRpcRequest, JsonRpcResponse, JsonRpcNotification, JsonRpcError, Transport, } from './session-types.js';
 export { createSession } from './session.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAEV,eAAe,EACf,OAAO,EACP,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EAEV,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,UAAU,EAEV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,cAAc,EAEd,cAAc,EACd,cAAc,EAEd,eAAe,GAChB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAG9C,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,SAAS,EACT,cAAc,EACd,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,2BAA2B,GAC5B,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAG/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGhD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAGnH,YAAY,EACV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,OAAO,EACP,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,SAAS,GACV,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAEV,eAAe,EACf,OAAO,EACP,YAAY,EACZ,WAAW,EACX,UAAU,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EAEV,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,UAAU,EAEV,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,cAAc,EAEd,cAAc,EACd,cAAc,EAEd,eAAe,EAEf,WAAW,EACX,eAAe,GAChB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAG9C,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,SAAS,EACT,cAAc,EACd,YAAY,EACZ,WAAW,EACX,YAAY,GACb,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,2BAA2B,GAC5B,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAG/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGhD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAGnH,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAGhE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACrG,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAGpF,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACzH,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAGrG,YAAY,EACV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,OAAO,EACP,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,SAAS,GACV,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA"}

package/dist/index.js

@@ -10,5 +10,9 @@ export { connectTerminal } from './terminal.js';
 export { injectSkills } from './skill-inject.js';
 // File helpers (for adapter authors)
 export { writeFileViaExec, readFileViaExec, uploadArchiveViaExec, downloadArchiveViaExec } from './file-helpers.js';
+// Sandbox user
+export { setupSandboxUser, wrapAsUser } from './sandbox-user.js';
+export { emitEvent, createNoopObserver, createWebhookObserver } from './observer.js';
+export { injectClaudeHooks, readHookEvents, startClaudeLogin, DEFAULT_EVENTS_FILE } from './hooks.js';
 // Session factory
 export { createSession } from './session.js';

package/dist/observer.d.ts

@@ -0,0 +1,32 @@
+export type SandboxEventType = 'sandbox:exec' | 'sandbox:writeFile' | 'sandbox:readFile' | 'sandbox:uploadArchive' | 'sandbox:downloadArchive';
+export interface SandboxEvent {
+    /** 事件类型 */
+    type: SandboxEventType;
+    /** 沙箱 ID */
+    sandboxId: string;
+    /** 关联的任务 ID（可选） */
+    taskId?: string;
+    /** 事件时间戳（Unix ms） */
+    timestamp: number;
+    /** 事件数据（命令、路径、退出码等） */
+    data: Record<string, unknown>;
+}
+export interface SandboxObserver {
+    /** 接收一个沙箱事件。可以返回 Promise，但调用方不会等待。 */
+    onEvent(event: SandboxEvent): void | Promise<void>;
+}
+export interface ProviderOptions {
+    /** 可选的事件观察者。设置后，所有沙箱操作都会自动记录。 */
+    observer?: SandboxObserver;
+    /** 默认任务 ID，会附加到所有事件上 */
+    taskId?: string;
+}
+/** 安全地发射事件：不阻塞、不抛错 */
+export declare function emitEvent(observer: SandboxObserver, event: SandboxEvent): void;
+/** 空观察者，不做任何操作 */
+export declare function createNoopObserver(): SandboxObserver;
+/** Webhook 观察者，将事件 POST 到指定 URL */
+export declare function createWebhookObserver(url: string, options?: {
+    headers?: Record<string, string>;
+}): SandboxObserver;
+//# sourceMappingURL=observer.d.ts.map

package/dist/observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../src/observer.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,mBAAmB,GACnB,kBAAkB,GAClB,uBAAuB,GACvB,yBAAyB,CAAA;AAE7B,MAAM,WAAW,YAAY;IAC3B,WAAW;IACX,IAAI,EAAE,gBAAgB,CAAA;IACtB,YAAY;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,mBAAmB;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACnD;AAED,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,sBAAsB;AACtB,wBAAgB,SAAS,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAS9E;AAED,kBAAkB;AAClB,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAED,mCAAmC;AACnC,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC7C,eAAe,CAajB"}

package/dist/observer.js

@@ -0,0 +1,33 @@
+// --- Sandbox Observer ---
+/** 安全地发射事件：不阻塞、不抛错 */
+export function emitEvent(observer, event) {
+    try {
+        const result = observer.onEvent(event);
+        if (result && typeof result.catch === 'function') {
+            ;
+            result.catch(() => { });
+        }
+    }
+    catch {
+        // observer 报错不影响沙箱操作
+    }
+}
+/** 空观察者，不做任何操作 */
+export function createNoopObserver() {
+    return { onEvent() { } };
+}
+/** Webhook 观察者，将事件 POST 到指定 URL */
+export function createWebhookObserver(url, options) {
+    return {
+        onEvent(event) {
+            return fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...options?.headers,
+                },
+                body: JSON.stringify(event),
+            }).then(() => { });
+        },
+    };
+}

package/dist/provider.d.ts

@@ -1,4 +1,8 @@
 import type { SandboxAdapter, SandboxProvider } from './types.js';
+import type { SandboxObserver } from './observer.js';
 /** 创建一个 SandboxProvider */
-export declare function createProvider(adapter: SandboxAdapter): SandboxProvider;
+export declare function createProvider(adapter: SandboxAdapter, options?: {
+    observer?: SandboxObserver;
+    taskId?: string;
+}): SandboxProvider;
 //# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAQV,cAAc,EAEd,eAAe,EAShB,MAAM,YAAY,CAAA;AAqGnB,2BAA2B;AAC3B,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,CA0EvE"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAQV,cAAc,EAEd,eAAe,EAShB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,eAAe,CAAA;AA8ItE,2BAA2B;AAC3B,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxD,eAAe,CAmFjB"}

package/dist/provider.js

@@ -1,37 +1,66 @@
+import { emitEvent } from './observer.js';
 import { CapabilityNotSupportedError, ProviderError } from './errors.js';
 import { injectSkills } from './skill-inject.js';
 import { readFileViaExec, writeFileViaExec, uploadArchiveViaExec, downloadArchiveViaExec } from './file-helpers.js';
+import { setupSandboxUser, wrapAsUser } from './sandbox-user.js';
 /**
  * 将 AdapterSandbox 包装为完整的 Sandbox 接口。
  * 自动补充缺失的 writeFile/readFile 默认实现。
+ * 若传入 observer，自动对所有操作发射事件。
  */
-function wrapSandbox(raw, providerName) {
+function wrapSandbox(raw, providerName, observer, taskId, userInfo) {
+    function emit(type, data) {
+        if (!observer)
+            return;
+        emitEvent(observer, { type, sandboxId: raw.id, taskId, timestamp: Date.now(), data });
+    }
     const sandbox = {
         get id() { return raw.id; },
         get state() { return raw.state; },
         get createdAt() { return raw.createdAt; },
-        exec(command, options) {
-            return raw.exec(command, options);
+        get user() { return userInfo; },
+        async exec(command, options) {
+            let cmd = command;
+            let opts = options;
+            // 非 root 用户包装: 默认以该用户执行，asRoot 跳过
+            if (userInfo && !options?.asRoot) {
+                cmd = wrapAsUser(command, userInfo.name, options?.cwd);
+                // cwd 已包含在 wrapped command 中，不再传给 adapter
+                opts = options ? { ...options, cwd: undefined, asRoot: undefined } : undefined;
+            }
+            const start = Date.now();
+            try {
+                const result = await raw.exec(cmd, opts);
+                emit('sandbox:exec', { command, exitCode: result.exitCode, duration: Date.now() - start });
+                return result;
+            }
+            catch (err) {
+                emit('sandbox:exec', { command, error: err.message, duration: Date.now() - start });
+                throw err;
+            }
         },
-        writeFile(path, content) {
-            if (raw.writeFile)
-                return raw.writeFile(path, content);
-            return writeFileViaExec(raw, path, content);
+        async writeFile(path, content) {
+            const size = typeof content === 'string' ? content.length : content.byteLength;
+            const fn = raw.writeFile ? raw.writeFile.bind(raw) : (p, c) => writeFileViaExec(raw, p, c);
+            await fn(path, content);
+            emit('sandbox:writeFile', { path, size });
         },
-        readFile(path) {
-            if (raw.readFile)
-                return raw.readFile(path);
-            return readFileViaExec(raw, path);
+        async readFile(path) {
+            const fn = raw.readFile ? raw.readFile.bind(raw) : (p) => readFileViaExec(raw, p);
+            const result = await fn(path);
+            emit('sandbox:readFile', { path, size: result.byteLength });
+            return result;
         },
-        uploadArchive(archive, destDir) {
-            if (raw.uploadArchive)
-                return raw.uploadArchive(archive, destDir);
-            return uploadArchiveViaExec(raw, archive, destDir);
+        async uploadArchive(archive, destDir) {
+            const fn = raw.uploadArchive ? raw.uploadArchive.bind(raw) : (a, d) => uploadArchiveViaExec(raw, a, d);
+            await fn(archive, destDir);
+            emit('sandbox:uploadArchive', { destDir: destDir ?? '/' });
         },
-        downloadArchive(srcDir) {
-            if (raw.downloadArchive)
-                return raw.downloadArchive(srcDir);
-            return downloadArchiveViaExec(raw, srcDir);
+        async downloadArchive(srcDir) {
+            const fn = raw.downloadArchive ? raw.downloadArchive.bind(raw) : (s) => downloadArchiveViaExec(raw, s);
+            const result = await fn(srcDir);
+            emit('sandbox:downloadArchive', { srcDir: srcDir ?? '/' });
+            return result;
         },
     };
     // 转发可选能力方法（只有 adapter 真正实现的才转发）
@@ -89,8 +118,10 @@ function detectCapabilities(adapter) {
     return validated;
 }
 /** 创建一个 SandboxProvider */
-export function createProvider(adapter) {
+export function createProvider(adapter, options) {
     const capabilities = detectCapabilities(adapter);
+    const observer = options?.observer;
+    const taskId = options?.taskId;
     const provider = {
         get name() { return adapter.name; },
         get capabilities() { return capabilities; },
@@ -115,7 +146,12 @@ export function createProvider(adapter) {
                 config = { ...config, env: mergedEnv };
             }
             const raw = await adapter.createSandbox(config);
-            const sandbox = wrapSandbox(raw, adapter.name);
+            // 创建非 root 用户（如果配置了）
+            let userInfo;
+            if (config.user) {
+                userInfo = await setupSandboxUser(raw, config.user);
+            }
+            const sandbox = wrapSandbox(raw, adapter.name, observer, taskId, userInfo);
             if (config.skills?.length) {
                 try {
                     await injectSkills(sandbox, config.skills);
@@ -129,7 +165,7 @@ export function createProvider(adapter) {
         },
         async get(id) {
             const raw = await adapter.getSandbox(id);
-            return wrapSandbox(raw, adapter.name);
+            return wrapSandbox(raw, adapter.name, observer, taskId);
         },
         async list(filter) {
             return adapter.listSandboxes(filter);

package/dist/sandbox-user.d.ts

@@ -0,0 +1,15 @@
+import type { AdapterSandbox, SandboxUser, SandboxUserInfo } from './types.js';
+/**
+ * 在沙箱中创建非 root 用户。
+ * 假设 Debian/Ubuntu 基础镜像（useradd）。
+ */
+export declare function setupSandboxUser(sandbox: AdapterSandbox, config: string | SandboxUser): Promise<SandboxUserInfo>;
+/**
+ * 将命令包装为指定用户执行。
+ * 使用 `su - <user> -c '...'` — 由 root 调用无需密码，`-` 设置完整环境。
+ *
+ * 构建 inner command（su 的 bash 将执行的内容），然后整体做一次
+ * 单引号转义放入外层 `'...'`。cwd 在 inner command 中用双引号包裹。
+ */
+export declare function wrapAsUser(command: string, user: string, cwd?: string): string;
+//# sourceMappingURL=sandbox-user.d.ts.map

package/dist/sandbox-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-user.d.ts","sourceRoot":"","sources":["../src/sandbox-user.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE9E;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GAAG,WAAW,GAC3B,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ9E"}

package/dist/sandbox-user.js

@@ -0,0 +1,47 @@
+/**
+ * 在沙箱中创建非 root 用户。
+ * 假设 Debian/Ubuntu 基础镜像（useradd）。
+ */
+export async function setupSandboxUser(sandbox, config) {
+    const opts = typeof config === 'string' ? { name: config } : config;
+    const name = opts.name ?? 'sandbank';
+    const sudo = opts.sudo ?? true;
+    // 1. 创建用户（如果不存在）
+    const uidFlag = opts.uid != null ? `-u ${opts.uid}` : '';
+    const result = await sandbox.exec(`id ${name} >/dev/null 2>&1 || useradd -m -s /bin/bash ${uidFlag} ${name}`);
+    if (result.exitCode !== 0) {
+        throw new Error(`Failed to create user '${name}': ${result.stderr || result.stdout}`);
+    }
+    // 2. 获取 home 目录
+    const homeResult = await sandbox.exec(`eval echo ~${name}`);
+    const home = homeResult.stdout.trim();
+    if (!home || home === `~${name}`) {
+        throw new Error(`Failed to resolve home directory for user '${name}'`);
+    }
+    // 3. 配置 sudo（可选）
+    if (sudo) {
+        await sandbox.exec(`command -v sudo >/dev/null 2>&1 || (apt-get update -qq && apt-get install -y -qq sudo) 2>/dev/null; `
+            + `echo '${name} ALL=(ALL) NOPASSWD:ALL' > /etc/sudoers.d/${name} && chmod 440 /etc/sudoers.d/${name}`);
+    }
+    return { name, home };
+}
+/**
+ * 将命令包装为指定用户执行。
+ * 使用 `su - <user> -c '...'` — 由 root 调用无需密码，`-` 设置完整环境。
+ *
+ * 构建 inner command（su 的 bash 将执行的内容），然后整体做一次
+ * 单引号转义放入外层 `'...'`。cwd 在 inner command 中用双引号包裹。
+ */
+export function wrapAsUser(command, user, cwd) {
+    let innerCmd = command;
+    if (cwd) {
+        // 双引号包裹 cwd，转义双引号上下文中的特殊字符
+        const safeCwd = cwd.replace(/["$`\\]/g, '\\$&');
+        innerCmd = `cd "${safeCwd}" && ${command}`;
+    }
+    return `su - ${user} -c '${escapeSingleQuotes(innerCmd)}'`;
+}
+/** POSIX 单引号转义: ' → '\'' */
+function escapeSingleQuotes(s) {
+    return s.replace(/'/g, "'\\''");
+}

package/dist/types.d.ts

@@ -19,8 +19,8 @@ export interface SkillDefinition {
     content: string;
 }
 export interface CreateConfig {
-    /** 容器镜像（如 'node:22-slim', 'ubuntu:24.04'） */
-    image: string;
+    /** 容器镜像（如 'node:22-slim', 'ubuntu:24.04'）。使用 snapshot 时可省略。 */
+    image?: string;
     /** 环境变量注入 */
     env?: Record<string, string>;
     /** 资源配置（provider 会映射到最接近的规格） */
@@ -47,11 +47,34 @@ export interface CreateConfig {
     skills?: SkillDefinition[];
     /** 绑定的服务。凭证自动注入为环境变量（需 provider 支持 'services' 能力） */
     services?: ServiceBinding[];
+    /** 端口映射 [hostPort, guestPort][]。本地模式使用，将容器端口转发到宿主机端口 */
+    ports?: [number, number][];
+    /**
+     * 创建非 root 用户并以该用户身份执行命令。
+     * - string: 用户名（等价于 { name: 'xxx' }）
+     * - object: 完整配置
+     * - 未设置: 保持 root（向后兼容）
+     */
+    user?: string | SandboxUser;
 }
 export interface ListFilter {
     state?: SandboxState | SandboxState[];
     limit?: number;
 }
+export interface SandboxUser {
+    /** 用户名。默认: 'sandbank' */
+    name?: string;
+    /** 指定 UID。默认: 自动分配 */
+    uid?: number;
+    /** 是否授予 sudo 权限。默认: true */
+    sudo?: boolean;
+}
+export interface SandboxUserInfo {
+    /** 用户名 */
+    name: string;
+    /** Home 目录路径 */
+    home: string;
+}
 export interface Sandbox {
     /** 沙箱唯一 ID */
     readonly id: string;
@@ -59,6 +82,8 @@ export interface Sandbox {
     readonly state: SandboxState;
     /** 创建时间 */
     readonly createdAt: string;
+    /** 非 root 用户信息（如已配置） */
+    readonly user?: SandboxUserInfo;
     /** 执行命令，等待完成 */
     exec(command: string, options?: ExecOptions): Promise<ExecResult>;
     /** 写入单个文件 */
@@ -76,6 +101,8 @@ export interface ExecOptions {
     timeout?: number;
     /** 工作目录 */
     cwd?: string;
+    /** 以 root 身份执行（仅在配置了 user 时有意义）。默认: false */
+    asRoot?: boolean;
 }
 export interface ExecResult {
     stdout: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sandbank.dev/core",
-  "version": "0.2.1",
+  "version": "0.3.4",
   "description": "Unified sandbox SDK for AI agents — provider abstraction, capability system, and error types",
   "license": "MIT",
   "type": "module",