bulkhead-runtime 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (220) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +625 -0
  3. package/dist/cli.d.ts +3 -0
  4. package/dist/cli.d.ts.map +1 -0
  5. package/dist/cli.js +43 -0
  6. package/dist/cli.js.map +1 -0
  7. package/dist/config/index.d.ts +29 -0
  8. package/dist/config/index.d.ts.map +1 -0
  9. package/dist/config/index.js +24 -0
  10. package/dist/config/index.js.map +1 -0
  11. package/dist/credentials/index.d.ts +4 -0
  12. package/dist/credentials/index.d.ts.map +1 -0
  13. package/dist/credentials/index.js +3 -0
  14. package/dist/credentials/index.js.map +1 -0
  15. package/dist/credentials/proxy.d.ts +3 -0
  16. package/dist/credentials/proxy.d.ts.map +1 -0
  17. package/dist/credentials/proxy.js +11 -0
  18. package/dist/credentials/proxy.js.map +1 -0
  19. package/dist/credentials/store.d.ts +7 -0
  20. package/dist/credentials/store.d.ts.map +1 -0
  21. package/dist/credentials/store.js +91 -0
  22. package/dist/credentials/store.js.map +1 -0
  23. package/dist/credentials/types.d.ts +14 -0
  24. package/dist/credentials/types.d.ts.map +1 -0
  25. package/dist/credentials/types.js +2 -0
  26. package/dist/credentials/types.js.map +1 -0
  27. package/dist/hooks/index.d.ts +3 -0
  28. package/dist/hooks/index.d.ts.map +1 -0
  29. package/dist/hooks/index.js +2 -0
  30. package/dist/hooks/index.js.map +1 -0
  31. package/dist/hooks/runner.d.ts +7 -0
  32. package/dist/hooks/runner.d.ts.map +1 -0
  33. package/dist/hooks/runner.js +20 -0
  34. package/dist/hooks/runner.js.map +1 -0
  35. package/dist/hooks/types.d.ts +39 -0
  36. package/dist/hooks/types.d.ts.map +1 -0
  37. package/dist/hooks/types.js +2 -0
  38. package/dist/hooks/types.js.map +1 -0
  39. package/dist/index.d.ts +14 -0
  40. package/dist/index.d.ts.map +1 -0
  41. package/dist/index.js +21 -0
  42. package/dist/index.js.map +1 -0
  43. package/dist/infra/env.d.ts +2 -0
  44. package/dist/infra/env.d.ts.map +1 -0
  45. package/dist/infra/env.js +6 -0
  46. package/dist/infra/env.js.map +1 -0
  47. package/dist/infra/warning-filter.d.ts +8 -0
  48. package/dist/infra/warning-filter.d.ts.map +1 -0
  49. package/dist/infra/warning-filter.js +66 -0
  50. package/dist/infra/warning-filter.js.map +1 -0
  51. package/dist/logging/subsystem.d.ts +15 -0
  52. package/dist/logging/subsystem.d.ts.map +1 -0
  53. package/dist/logging/subsystem.js +57 -0
  54. package/dist/logging/subsystem.js.map +1 -0
  55. package/dist/memory/embeddings-debug.d.ts +2 -0
  56. package/dist/memory/embeddings-debug.d.ts.map +1 -0
  57. package/dist/memory/embeddings-debug.js +12 -0
  58. package/dist/memory/embeddings-debug.js.map +1 -0
  59. package/dist/memory/embeddings.d.ts +16 -0
  60. package/dist/memory/embeddings.d.ts.map +1 -0
  61. package/dist/memory/embeddings.js +180 -0
  62. package/dist/memory/embeddings.js.map +1 -0
  63. package/dist/memory/fs-utils.d.ts +12 -0
  64. package/dist/memory/fs-utils.d.ts.map +1 -0
  65. package/dist/memory/fs-utils.js +24 -0
  66. package/dist/memory/fs-utils.js.map +1 -0
  67. package/dist/memory/hybrid.d.ts +46 -0
  68. package/dist/memory/hybrid.d.ts.map +1 -0
  69. package/dist/memory/hybrid.js +81 -0
  70. package/dist/memory/hybrid.js.map +1 -0
  71. package/dist/memory/index.d.ts +12 -0
  72. package/dist/memory/index.d.ts.map +1 -0
  73. package/dist/memory/index.js +12 -0
  74. package/dist/memory/index.js.map +1 -0
  75. package/dist/memory/internal.d.ts +39 -0
  76. package/dist/memory/internal.d.ts.map +1 -0
  77. package/dist/memory/internal.js +292 -0
  78. package/dist/memory/internal.js.map +1 -0
  79. package/dist/memory/manager-search.d.ts +61 -0
  80. package/dist/memory/manager-search.d.ts.map +1 -0
  81. package/dist/memory/manager-search.js +102 -0
  82. package/dist/memory/manager-search.js.map +1 -0
  83. package/dist/memory/mmr.d.ts +63 -0
  84. package/dist/memory/mmr.d.ts.map +1 -0
  85. package/dist/memory/mmr.js +165 -0
  86. package/dist/memory/mmr.js.map +1 -0
  87. package/dist/memory/query-expansion.d.ts +42 -0
  88. package/dist/memory/query-expansion.d.ts.map +1 -0
  89. package/dist/memory/query-expansion.js +776 -0
  90. package/dist/memory/query-expansion.js.map +1 -0
  91. package/dist/memory/simple-manager.d.ts +23 -0
  92. package/dist/memory/simple-manager.d.ts.map +1 -0
  93. package/dist/memory/simple-manager.js +193 -0
  94. package/dist/memory/simple-manager.js.map +1 -0
  95. package/dist/memory/sqlite.d.ts +2 -0
  96. package/dist/memory/sqlite.d.ts.map +1 -0
  97. package/dist/memory/sqlite.js +16 -0
  98. package/dist/memory/sqlite.js.map +1 -0
  99. package/dist/memory/temporal-decay.d.ts +26 -0
  100. package/dist/memory/temporal-decay.d.ts.map +1 -0
  101. package/dist/memory/temporal-decay.js +120 -0
  102. package/dist/memory/temporal-decay.js.map +1 -0
  103. package/dist/memory/types.d.ts +95 -0
  104. package/dist/memory/types.d.ts.map +1 -0
  105. package/dist/memory/types.js +2 -0
  106. package/dist/memory/types.js.map +1 -0
  107. package/dist/package.json +36 -0
  108. package/dist/platform/index.d.ts +3 -0
  109. package/dist/platform/index.d.ts.map +1 -0
  110. package/dist/platform/index.js +2 -0
  111. package/dist/platform/index.js.map +1 -0
  112. package/dist/platform/platform.d.ts +3 -0
  113. package/dist/platform/platform.d.ts.map +1 -0
  114. package/dist/platform/platform.js +68 -0
  115. package/dist/platform/platform.js.map +1 -0
  116. package/dist/platform/types.d.ts +16 -0
  117. package/dist/platform/types.d.ts.map +1 -0
  118. package/dist/platform/types.js +2 -0
  119. package/dist/platform/types.js.map +1 -0
  120. package/dist/runtime/agent.d.ts +28 -0
  121. package/dist/runtime/agent.d.ts.map +1 -0
  122. package/dist/runtime/agent.js +102 -0
  123. package/dist/runtime/agent.js.map +1 -0
  124. package/dist/runtime/index.d.ts +2 -0
  125. package/dist/runtime/index.d.ts.map +1 -0
  126. package/dist/runtime/index.js +2 -0
  127. package/dist/runtime/index.js.map +1 -0
  128. package/dist/sandbox/cgroup.d.ts +17 -0
  129. package/dist/sandbox/cgroup.d.ts.map +1 -0
  130. package/dist/sandbox/cgroup.js +69 -0
  131. package/dist/sandbox/cgroup.js.map +1 -0
  132. package/dist/sandbox/index.d.ts +11 -0
  133. package/dist/sandbox/index.d.ts.map +1 -0
  134. package/dist/sandbox/index.js +9 -0
  135. package/dist/sandbox/index.js.map +1 -0
  136. package/dist/sandbox/ipc.d.ts +23 -0
  137. package/dist/sandbox/ipc.d.ts.map +1 -0
  138. package/dist/sandbox/ipc.js +138 -0
  139. package/dist/sandbox/ipc.js.map +1 -0
  140. package/dist/sandbox/manager.d.ts +5 -0
  141. package/dist/sandbox/manager.d.ts.map +1 -0
  142. package/dist/sandbox/manager.js +245 -0
  143. package/dist/sandbox/manager.js.map +1 -0
  144. package/dist/sandbox/namespace.d.ts +12 -0
  145. package/dist/sandbox/namespace.d.ts.map +1 -0
  146. package/dist/sandbox/namespace.js +120 -0
  147. package/dist/sandbox/namespace.js.map +1 -0
  148. package/dist/sandbox/proxy-tools.d.ts +14 -0
  149. package/dist/sandbox/proxy-tools.d.ts.map +1 -0
  150. package/dist/sandbox/proxy-tools.js +63 -0
  151. package/dist/sandbox/proxy-tools.js.map +1 -0
  152. package/dist/sandbox/rootfs.d.ts +15 -0
  153. package/dist/sandbox/rootfs.d.ts.map +1 -0
  154. package/dist/sandbox/rootfs.js +163 -0
  155. package/dist/sandbox/rootfs.js.map +1 -0
  156. package/dist/sandbox/seccomp.d.ts +13 -0
  157. package/dist/sandbox/seccomp.d.ts.map +1 -0
  158. package/dist/sandbox/seccomp.js +120 -0
  159. package/dist/sandbox/seccomp.js.map +1 -0
  160. package/dist/sandbox/types.d.ts +68 -0
  161. package/dist/sandbox/types.d.ts.map +1 -0
  162. package/dist/sandbox/types.js +8 -0
  163. package/dist/sandbox/types.js.map +1 -0
  164. package/dist/sandbox/worker.d.ts +12 -0
  165. package/dist/sandbox/worker.d.ts.map +1 -0
  166. package/dist/sandbox/worker.js +84 -0
  167. package/dist/sandbox/worker.js.map +1 -0
  168. package/dist/sessions/index.d.ts +2 -0
  169. package/dist/sessions/index.d.ts.map +1 -0
  170. package/dist/sessions/index.js +2 -0
  171. package/dist/sessions/index.js.map +1 -0
  172. package/dist/sessions/store.d.ts +17 -0
  173. package/dist/sessions/store.d.ts.map +1 -0
  174. package/dist/sessions/store.js +48 -0
  175. package/dist/sessions/store.js.map +1 -0
  176. package/dist/skills/enablement.d.ts +10 -0
  177. package/dist/skills/enablement.d.ts.map +1 -0
  178. package/dist/skills/enablement.js +52 -0
  179. package/dist/skills/enablement.js.map +1 -0
  180. package/dist/skills/index.d.ts +4 -0
  181. package/dist/skills/index.d.ts.map +1 -0
  182. package/dist/skills/index.js +4 -0
  183. package/dist/skills/index.js.map +1 -0
  184. package/dist/skills/loader.d.ts +8 -0
  185. package/dist/skills/loader.d.ts.map +1 -0
  186. package/dist/skills/loader.js +8 -0
  187. package/dist/skills/loader.js.map +1 -0
  188. package/dist/skills/registry.d.ts +19 -0
  189. package/dist/skills/registry.d.ts.map +1 -0
  190. package/dist/skills/registry.js +106 -0
  191. package/dist/skills/registry.js.map +1 -0
  192. package/dist/utils/boolean.d.ts +6 -0
  193. package/dist/utils/boolean.d.ts.map +1 -0
  194. package/dist/utils/boolean.js +28 -0
  195. package/dist/utils/boolean.js.map +1 -0
  196. package/dist/utils/run-with-concurrency.d.ts +12 -0
  197. package/dist/utils/run-with-concurrency.d.ts.map +1 -0
  198. package/dist/utils/run-with-concurrency.js +40 -0
  199. package/dist/utils/run-with-concurrency.js.map +1 -0
  200. package/dist/utils.d.ts +3 -0
  201. package/dist/utils.d.ts.map +1 -0
  202. package/dist/utils.js +38 -0
  203. package/dist/utils.js.map +1 -0
  204. package/dist/workspace/index.d.ts +3 -0
  205. package/dist/workspace/index.d.ts.map +1 -0
  206. package/dist/workspace/index.js +2 -0
  207. package/dist/workspace/index.js.map +1 -0
  208. package/dist/workspace/runner.d.ts +19 -0
  209. package/dist/workspace/runner.d.ts.map +1 -0
  210. package/dist/workspace/runner.js +158 -0
  211. package/dist/workspace/runner.js.map +1 -0
  212. package/dist/workspace/types.d.ts +36 -0
  213. package/dist/workspace/types.d.ts.map +1 -0
  214. package/dist/workspace/types.js +2 -0
  215. package/dist/workspace/types.js.map +1 -0
  216. package/dist/workspace/workspace.d.ts +12 -0
  217. package/dist/workspace/workspace.d.ts.map +1 -0
  218. package/dist/workspace/workspace.js +76 -0
  219. package/dist/workspace/workspace.js.map +1 -0
  220. package/package.json +53 -0
@@ -0,0 +1,245 @@
1
+ import { spawn } from "node:child_process";
2
+ import * as fs from "node:fs";
3
+ import * as path from "node:path";
4
+ import * as os from "node:os";
5
+ import * as crypto from "node:crypto";
6
+ import { detectCapabilities, buildUnshareArgs, buildNamespaceFlags } from "./namespace.js";
7
+ import { createCgroupController, cgroupLimitsFromConfig } from "./cgroup.js";
8
+ import { prepareRootfs, buildMountScript } from "./rootfs.js";
9
+ export function createSandboxManager() {
10
+ let cachedCapabilities = null;
11
+ return {
12
+ async capabilities() {
13
+ if (!cachedCapabilities) {
14
+ cachedCapabilities = detectCapabilities();
15
+ }
16
+ return cachedCapabilities;
17
+ },
18
+ async spawn(options) {
19
+ const caps = await this.capabilities();
20
+ if (caps.platform === "linux" && caps.hasUnshare) {
21
+ return spawnLinuxSandbox(options, caps);
22
+ }
23
+ return spawnFallbackSandbox(options);
24
+ },
25
+ };
26
+ }
27
+ function generateSandboxId() {
28
+ return `sb_${Date.now()}_${crypto.randomBytes(4).toString("hex")}`;
29
+ }
30
+ async function spawnLinuxSandbox(options, caps) {
31
+ const sandboxId = generateSandboxId();
32
+ const config = options.config;
33
+ const nsFlags = buildNamespaceFlags(caps, config.networkIsolation ?? false);
34
+ const unshareArgs = buildUnshareArgs(nsFlags);
35
+ let cgroup = null;
36
+ if (caps.hasCgroupV2) {
37
+ const limits = cgroupLimitsFromConfig(config);
38
+ cgroup = createCgroupController(sandboxId, limits);
39
+ }
40
+ let rootfs = null;
41
+ let wrapperScriptPath = null;
42
+ if (nsFlags.mount) {
43
+ rootfs = prepareRootfs({
44
+ sandboxId,
45
+ workspaceDir: options.cwd,
46
+ additionalBinds: config.mountBinds,
47
+ });
48
+ const mountScript = buildMountScript(rootfs.rootDir, rootfs.mounts, options.cwd);
49
+ wrapperScriptPath = writeWrapperScript(sandboxId, mountScript, options);
50
+ }
51
+ const sanitizedEnv = {
52
+ PATH: "/usr/local/bin:/usr/bin:/bin",
53
+ HOME: "/tmp",
54
+ NODE_ENV: "production",
55
+ SANDBOX_ID: sandboxId,
56
+ ...options.env,
57
+ };
58
+ const preserved = preserveKeys(sanitizedEnv, options.protectedKeys);
59
+ removeCredentialKeys(sanitizedEnv);
60
+ Object.assign(sanitizedEnv, preserved);
61
+ let fullArgs;
62
+ if (wrapperScriptPath) {
63
+ fullArgs = [...unshareArgs, "/bin/sh", wrapperScriptPath];
64
+ }
65
+ else {
66
+ fullArgs = [...unshareArgs, options.command, ...options.args];
67
+ }
68
+ const child = spawn("unshare", fullArgs, {
69
+ cwd: options.cwd,
70
+ env: sanitizedEnv,
71
+ stdio: ["pipe", "pipe", "pipe"],
72
+ });
73
+ let spawnError = null;
74
+ child.on("error", (err) => {
75
+ spawnError = err;
76
+ });
77
+ if (cgroup && child.pid) {
78
+ cgroup.apply(child.pid);
79
+ }
80
+ if (options.onStderr && child.stderr) {
81
+ child.stderr.on("data", (data) => {
82
+ options.onStderr(data.toString("utf-8"));
83
+ });
84
+ }
85
+ let timeoutTimer = null;
86
+ if (config.timeoutMs) {
87
+ timeoutTimer = setTimeout(() => {
88
+ child.kill("SIGKILL");
89
+ }, config.timeoutMs);
90
+ }
91
+ const cleanupAll = () => {
92
+ if (timeoutTimer)
93
+ clearTimeout(timeoutTimer);
94
+ cgroup?.cleanup();
95
+ rootfs?.cleanup();
96
+ if (wrapperScriptPath)
97
+ cleanupFile(wrapperScriptPath);
98
+ };
99
+ child.on("exit", cleanupAll);
100
+ return {
101
+ pid: child.pid ?? -1,
102
+ stdin: child.stdin,
103
+ stdout: child.stdout,
104
+ stderr: child.stderr,
105
+ kill() {
106
+ try {
107
+ child.kill("SIGKILL");
108
+ }
109
+ catch { /* already dead */ }
110
+ },
111
+ waitForExit() {
112
+ return new Promise((resolve, reject) => {
113
+ if (spawnError) {
114
+ reject(spawnError);
115
+ return;
116
+ }
117
+ if (child.exitCode !== null) {
118
+ resolve(child.exitCode);
119
+ return;
120
+ }
121
+ child.on("error", reject);
122
+ child.on("exit", (code) => { resolve(code ?? 1); });
123
+ });
124
+ },
125
+ };
126
+ }
127
+ async function spawnFallbackSandbox(options) {
128
+ const sandboxId = generateSandboxId();
129
+ const sanitizedEnv = {
130
+ PATH: process.env["PATH"] ?? "/usr/local/bin:/usr/bin:/bin",
131
+ HOME: process.env["HOME"] ?? "/tmp",
132
+ NODE_ENV: "production",
133
+ SANDBOX_ID: sandboxId,
134
+ ...options.env,
135
+ };
136
+ const preserved = preserveKeys(sanitizedEnv, options.protectedKeys);
137
+ removeCredentialKeys(sanitizedEnv);
138
+ Object.assign(sanitizedEnv, preserved);
139
+ const child = spawn(options.command, options.args, {
140
+ cwd: options.cwd,
141
+ env: sanitizedEnv,
142
+ stdio: ["pipe", "pipe", "pipe"],
143
+ });
144
+ let spawnError = null;
145
+ child.on("error", (err) => {
146
+ spawnError = err;
147
+ });
148
+ if (options.onStderr && child.stderr) {
149
+ child.stderr.on("data", (data) => {
150
+ options.onStderr(data.toString("utf-8"));
151
+ });
152
+ }
153
+ let timeoutTimer = null;
154
+ if (options.config.timeoutMs) {
155
+ timeoutTimer = setTimeout(() => {
156
+ child.kill("SIGKILL");
157
+ }, options.config.timeoutMs);
158
+ }
159
+ return {
160
+ pid: child.pid ?? -1,
161
+ stdin: child.stdin,
162
+ stdout: child.stdout,
163
+ stderr: child.stderr,
164
+ kill() {
165
+ if (timeoutTimer)
166
+ clearTimeout(timeoutTimer);
167
+ try {
168
+ child.kill("SIGKILL");
169
+ }
170
+ catch { /* already dead */ }
171
+ },
172
+ waitForExit() {
173
+ return new Promise((resolve, reject) => {
174
+ if (spawnError) {
175
+ reject(spawnError);
176
+ return;
177
+ }
178
+ if (child.exitCode !== null) {
179
+ resolve(child.exitCode);
180
+ return;
181
+ }
182
+ child.on("error", reject);
183
+ child.on("exit", (code) => {
184
+ if (timeoutTimer)
185
+ clearTimeout(timeoutTimer);
186
+ resolve(code ?? 1);
187
+ });
188
+ });
189
+ },
190
+ };
191
+ }
192
+ function writeWrapperScript(sandboxId, mountScript, options) {
193
+ const tmpDir = path.join(os.tmpdir(), "openclaw-sandbox");
194
+ fs.mkdirSync(tmpDir, { recursive: true });
195
+ const scriptPath = path.join(tmpDir, `${sandboxId}-init.sh`);
196
+ const escapedArgs = options.args.map((a) => `'${a.replace(/'/g, "'\\''")}'`).join(" ");
197
+ const script = [
198
+ "#!/bin/sh",
199
+ "set -e",
200
+ "",
201
+ mountScript,
202
+ "",
203
+ `exec ${options.command} ${escapedArgs}`,
204
+ ].join("\n");
205
+ fs.writeFileSync(scriptPath, script, { mode: 0o755 });
206
+ return scriptPath;
207
+ }
208
+ function cleanupFile(filePath) {
209
+ try {
210
+ fs.unlinkSync(filePath);
211
+ }
212
+ catch {
213
+ // best effort
214
+ }
215
+ }
216
+ const CREDENTIAL_KEY_PATTERNS = [
217
+ /_API_KEY$/,
218
+ /_SECRET$/,
219
+ /_TOKEN$/,
220
+ /_PASSWORD$/,
221
+ /^AWS_/,
222
+ /^OPENAI_/,
223
+ /^ANTHROPIC_/,
224
+ /^GEMINI_/,
225
+ /^GOOGLE_/,
226
+ /^OPENCLAW_CREDENTIAL/,
227
+ ];
228
+ export function preserveKeys(env, keys) {
229
+ if (!keys)
230
+ return {};
231
+ const saved = {};
232
+ for (const key of keys) {
233
+ if (key in env)
234
+ saved[key] = env[key];
235
+ }
236
+ return saved;
237
+ }
238
+ export function removeCredentialKeys(env) {
239
+ for (const key of Object.keys(env)) {
240
+ if (CREDENTIAL_KEY_PATTERNS.some((p) => p.test(key))) {
241
+ delete env[key];
242
+ }
243
+ }
244
+ }
245
+ //# sourceMappingURL=manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/sandbox/manager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { SandboxCapabilities } from "./types.js";
2
+ export declare function detectCapabilities(): SandboxCapabilities;
3
+ export interface NamespaceFlags {
4
+ user: boolean;
5
+ mount: boolean;
6
+ pid: boolean;
7
+ net: boolean;
8
+ uts: boolean;
9
+ }
10
+ export declare function buildUnshareArgs(flags: NamespaceFlags): string[];
11
+ export declare function buildNamespaceFlags(capabilities: SandboxCapabilities, networkIsolation: boolean): NamespaceFlags;
12
+ //# sourceMappingURL=namespace.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/sandbox/namespace.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAgB,kBAAkB,IAAI,mBAAmB,CA0BxD;AAqED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,EAAE,OAAO,CAAC;CACd;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,EAAE,CAsBhE;AAED,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,mBAAmB,EACjC,gBAAgB,EAAE,OAAO,GACxB,cAAc,CAQhB"}
@@ -0,0 +1,120 @@
1
+ import { execSync } from "node:child_process";
2
+ import * as fs from "node:fs";
3
+ export function detectCapabilities() {
4
+ const platform = detectPlatform();
5
+ if (platform !== "linux") {
6
+ return {
7
+ hasUserNamespace: false,
8
+ hasPidNamespace: false,
9
+ hasMountNamespace: false,
10
+ hasNetNamespace: false,
11
+ hasCgroupV2: false,
12
+ hasSeccomp: false,
13
+ hasUnshare: false,
14
+ platform,
15
+ };
16
+ }
17
+ return {
18
+ hasUserNamespace: checkUserNamespace(),
19
+ hasPidNamespace: checkNamespaceSupport("pid"),
20
+ hasMountNamespace: checkNamespaceSupport("mnt"),
21
+ hasNetNamespace: checkNamespaceSupport("net"),
22
+ hasCgroupV2: checkCgroupV2(),
23
+ hasSeccomp: checkSeccomp(),
24
+ hasUnshare: checkUnshare(),
25
+ platform,
26
+ };
27
+ }
28
+ function detectPlatform() {
29
+ switch (process.platform) {
30
+ case "linux":
31
+ return "linux";
32
+ case "darwin":
33
+ return "darwin";
34
+ default:
35
+ return "other";
36
+ }
37
+ }
38
+ function checkUserNamespace() {
39
+ try {
40
+ const max = fs
41
+ .readFileSync("/proc/sys/user/max_user_namespaces", "utf-8")
42
+ .trim();
43
+ return parseInt(max, 10) > 0;
44
+ }
45
+ catch {
46
+ return false;
47
+ }
48
+ }
49
+ function checkNamespaceSupport(ns) {
50
+ if (!fs.existsSync(`/proc/self/ns/${ns}`))
51
+ return false;
52
+ const flagMap = { mnt: "--mount", pid: "--pid", net: "--net" };
53
+ const flag = flagMap[ns];
54
+ if (!flag)
55
+ return false;
56
+ try {
57
+ execSync(`unshare --user --map-root-user ${flag} ${ns === "pid" ? "--fork" : ""} -- true`, { stdio: "pipe", timeout: 3000 });
58
+ return true;
59
+ }
60
+ catch {
61
+ return false;
62
+ }
63
+ }
64
+ function checkCgroupV2() {
65
+ try {
66
+ const mounts = fs.readFileSync("/proc/mounts", "utf-8");
67
+ return mounts.includes("cgroup2");
68
+ }
69
+ catch {
70
+ return false;
71
+ }
72
+ }
73
+ function checkSeccomp() {
74
+ try {
75
+ const status = fs.readFileSync("/proc/self/status", "utf-8");
76
+ return status.includes("Seccomp:");
77
+ }
78
+ catch {
79
+ return false;
80
+ }
81
+ }
82
+ function checkUnshare() {
83
+ try {
84
+ execSync("which unshare", { stdio: "pipe" });
85
+ return true;
86
+ }
87
+ catch {
88
+ return false;
89
+ }
90
+ }
91
+ export function buildUnshareArgs(flags) {
92
+ const args = [];
93
+ if (flags.user) {
94
+ args.push("--user", "--map-root-user");
95
+ }
96
+ if (flags.mount) {
97
+ args.push("--mount");
98
+ }
99
+ if (flags.pid) {
100
+ args.push("--pid", "--fork");
101
+ }
102
+ if (flags.net) {
103
+ args.push("--net");
104
+ }
105
+ if (flags.uts) {
106
+ args.push("--uts");
107
+ }
108
+ args.push("--");
109
+ return args;
110
+ }
111
+ export function buildNamespaceFlags(capabilities, networkIsolation) {
112
+ return {
113
+ user: capabilities.hasUserNamespace,
114
+ mount: capabilities.hasMountNamespace,
115
+ pid: capabilities.hasPidNamespace,
116
+ net: networkIsolation && capabilities.hasNetNamespace,
117
+ uts: capabilities.hasUserNamespace,
118
+ };
119
+ }
120
+ //# sourceMappingURL=namespace.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../src/sandbox/namespace.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import type { IpcPeer } from "./ipc.js";
2
+ interface ProxyToolResult {
3
+ resultForAssistant: string;
4
+ }
5
+ interface ProxyToolDef {
6
+ name: string;
7
+ label: string;
8
+ description: string;
9
+ parameters: Record<string, unknown>;
10
+ execute(toolCallId: string, params: Record<string, unknown>, signal: AbortSignal | undefined, onUpdate: unknown, ctx: unknown): Promise<ProxyToolResult>;
11
+ }
12
+ export declare function createProxyTools(peer: IpcPeer): ProxyToolDef[];
13
+ export {};
14
+ //# sourceMappingURL=proxy-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"proxy-tools.d.ts","sourceRoot":"","sources":["../../src/sandbox/proxy-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,UAAU,eAAe;IACvB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7B;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,EAAE,CAgE9D"}
@@ -0,0 +1,63 @@
1
+ export function createProxyTools(peer) {
2
+ return [
3
+ {
4
+ name: "memory_search",
5
+ label: "Memory Search",
6
+ description: "Search your memory for relevant information. Returns matching memories ranked by relevance.",
7
+ parameters: {
8
+ type: "Object",
9
+ properties: {
10
+ query: { type: "String" },
11
+ maxResults: { type: "Number" },
12
+ },
13
+ required: ["query"],
14
+ },
15
+ async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
16
+ const results = await peer.call("memory.search", {
17
+ query: params.query,
18
+ maxResults: params.maxResults ?? 5,
19
+ });
20
+ return { resultForAssistant: JSON.stringify(results, null, 2) };
21
+ },
22
+ },
23
+ {
24
+ name: "memory_store",
25
+ label: "Memory Store",
26
+ description: "Store information in your memory for future reference. Use this to remember important facts.",
27
+ parameters: {
28
+ type: "Object",
29
+ properties: {
30
+ content: { type: "String" },
31
+ },
32
+ required: ["content"],
33
+ },
34
+ async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
35
+ const result = await peer.call("memory.store", {
36
+ content: params.content,
37
+ });
38
+ return { resultForAssistant: JSON.stringify(result) };
39
+ },
40
+ },
41
+ {
42
+ name: "skill_execute",
43
+ label: "Execute Skill",
44
+ description: "Execute an enabled skill. Credentials are injected automatically by the platform.",
45
+ parameters: {
46
+ type: "Object",
47
+ properties: {
48
+ skillId: { type: "String" },
49
+ params: { type: "Object" },
50
+ },
51
+ required: ["skillId"],
52
+ },
53
+ async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
54
+ const result = await peer.call("skill.execute", {
55
+ skillId: params.skillId,
56
+ params: params.params,
57
+ });
58
+ return { resultForAssistant: JSON.stringify(result) };
59
+ },
60
+ },
61
+ ];
62
+ }
63
+ //# sourceMappingURL=proxy-tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"proxy-tools.js","sourceRoot":"","sources":["../../src/sandbox/proxy-tools.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO;QACL;YACE,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,eAAe;YACtB,WAAW,EACT,6FAA6F;YAC/F,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC/B;gBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;aACpB;YACD,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI;gBACzD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;oBAC/C,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;iBACnC,CAAC,CAAC;gBACH,OAAO,EAAE,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;YAClE,CAAC;SACF;QACD;YACE,IAAI,EAAE,cAAc;YACpB,KAAK,EAAE,cAAc;YACrB,WAAW,EACT,8FAA8F;YAChG,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC5B;gBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;aACtB;YACD,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI;gBACzD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE;oBAC7C,OAAO,EAAE,MAAM,CAAC,OAAO;iBACxB,CAAC,CAAC;gBACH,OAAO,EAAE,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,CAAC;SACF;QACD;YACE,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,eAAe;YACtB,WAAW,EACT,mFAAmF;YACrF,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC3B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC3B;gBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;aACtB;YACD,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI;gBACzD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE;oBAC9C,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,MAAM,EAAE,MAAM,CAAC,MAAM;iBACtB,CAAC,CAAC;gBACH,OAAO,EAAE,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,15 @@
1
+ import type { MountBind } from "./types.js";
2
+ export interface RootfsOptions {
3
+ sandboxId: string;
4
+ workspaceDir: string;
5
+ nodeExecutable?: string;
6
+ additionalBinds?: MountBind[];
7
+ }
8
+ export interface PreparedRootfs {
9
+ rootDir: string;
10
+ mounts: MountBind[];
11
+ cleanup(): void;
12
+ }
13
+ export declare function prepareRootfs(options: RootfsOptions): PreparedRootfs;
14
+ export declare function buildMountScript(rootDir: string, mounts: MountBind[], cwd: string): string;
15
+ //# sourceMappingURL=rootfs.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rootfs.d.ts","sourceRoot":"","sources":["../../src/sandbox/rootfs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,SAAS,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,OAAO,IAAI,IAAI,CAAC;CACjB;AAkBD,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CA0FpE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAqC1F"}
@@ -0,0 +1,163 @@
1
+ import * as fs from "node:fs";
2
+ import * as path from "node:path";
3
+ import * as os from "node:os";
4
+ const SYSTEM_READONLY_PATHS = [
5
+ "/usr",
6
+ "/lib",
7
+ "/lib64",
8
+ "/bin",
9
+ "/sbin",
10
+ "/etc/alternatives",
11
+ "/etc/ssl",
12
+ "/etc/ca-certificates",
13
+ "/etc/resolv.conf",
14
+ "/etc/hosts",
15
+ "/etc/nsswitch.conf",
16
+ "/etc/passwd",
17
+ "/etc/group",
18
+ ];
19
+ export function prepareRootfs(options) {
20
+ const rootDir = path.join(os.tmpdir(), "openclaw-rootfs", options.sandboxId);
21
+ fs.mkdirSync(rootDir, { recursive: true });
22
+ const mounts = [];
23
+ for (const sysPath of SYSTEM_READONLY_PATHS) {
24
+ if (!fs.existsSync(sysPath))
25
+ continue;
26
+ const targetInRoot = path.join(rootDir, sysPath);
27
+ const stat = safeStat(sysPath);
28
+ if (stat?.isDirectory()) {
29
+ fs.mkdirSync(targetInRoot, { recursive: true });
30
+ }
31
+ else {
32
+ fs.mkdirSync(path.dirname(targetInRoot), { recursive: true });
33
+ safeTouch(targetInRoot);
34
+ }
35
+ mounts.push({ source: sysPath, target: targetInRoot, readonly: true });
36
+ }
37
+ const nodeExec = options.nodeExecutable ?? process.execPath;
38
+ const nodeDir = path.dirname(nodeExec);
39
+ const nodeDirInRoot = path.join(rootDir, nodeDir);
40
+ fs.mkdirSync(nodeDirInRoot, { recursive: true });
41
+ mounts.push({ source: nodeDir, target: nodeDirInRoot, readonly: true });
42
+ const nodeModulesPath = findNodeModules();
43
+ if (nodeModulesPath) {
44
+ const nmInRoot = path.join(rootDir, nodeModulesPath);
45
+ fs.mkdirSync(nmInRoot, { recursive: true });
46
+ mounts.push({ source: nodeModulesPath, target: nmInRoot, readonly: true });
47
+ }
48
+ const wsInRoot = path.join(rootDir, options.workspaceDir);
49
+ fs.mkdirSync(wsInRoot, { recursive: true });
50
+ mounts.push({
51
+ source: options.workspaceDir,
52
+ target: wsInRoot,
53
+ readonly: false,
54
+ });
55
+ const tmpInRoot = path.join(rootDir, "tmp");
56
+ fs.mkdirSync(tmpInRoot, { recursive: true });
57
+ const devDir = path.join(rootDir, "dev");
58
+ fs.mkdirSync(devDir, { recursive: true });
59
+ for (const dev of ["null", "zero", "urandom", "random"]) {
60
+ const devPath = `/dev/${dev}`;
61
+ if (fs.existsSync(devPath)) {
62
+ const devInRoot = path.join(rootDir, "dev", dev);
63
+ safeTouch(devInRoot);
64
+ mounts.push({ source: devPath, target: devInRoot, readonly: true });
65
+ }
66
+ }
67
+ const procDir = path.join(rootDir, "proc");
68
+ fs.mkdirSync(procDir, { recursive: true });
69
+ const oldRootDir = path.join(rootDir, ".old-root");
70
+ fs.mkdirSync(oldRootDir, { recursive: true });
71
+ if (options.additionalBinds) {
72
+ for (const bind of options.additionalBinds) {
73
+ const targetInRoot = path.join(rootDir, bind.target);
74
+ const srcStat = safeStat(bind.source);
75
+ if (srcStat?.isDirectory()) {
76
+ fs.mkdirSync(targetInRoot, { recursive: true });
77
+ }
78
+ else {
79
+ fs.mkdirSync(path.dirname(targetInRoot), { recursive: true });
80
+ safeTouch(targetInRoot);
81
+ }
82
+ mounts.push({ source: bind.source, target: targetInRoot, readonly: bind.readonly });
83
+ }
84
+ }
85
+ return {
86
+ rootDir,
87
+ mounts,
88
+ cleanup() {
89
+ try {
90
+ fs.rmSync(rootDir, { recursive: true, force: true });
91
+ }
92
+ catch {
93
+ // best effort
94
+ }
95
+ },
96
+ };
97
+ }
98
+ export function buildMountScript(rootDir, mounts, cwd) {
99
+ const lines = [
100
+ "#!/bin/sh",
101
+ "set -e",
102
+ "",
103
+ `ROOTDIR="${rootDir}"`,
104
+ "",
105
+ '# Make rootDir a mount point for pivot_root',
106
+ 'mount --bind "$ROOTDIR" "$ROOTDIR"',
107
+ "",
108
+ ];
109
+ for (const mount of mounts) {
110
+ if (mount.readonly) {
111
+ lines.push(`mount --bind "${mount.source}" "${mount.target}"`);
112
+ lines.push(`mount -o remount,ro,bind "${mount.target}"`);
113
+ }
114
+ else {
115
+ lines.push(`mount --bind "${mount.source}" "${mount.target}"`);
116
+ }
117
+ }
118
+ lines.push("");
119
+ lines.push("# Mount proc inside the new root");
120
+ lines.push(`mount -t proc proc "$ROOTDIR/proc" 2>/dev/null || true`);
121
+ lines.push("");
122
+ lines.push("# pivot_root: swap root filesystem");
123
+ lines.push(`cd "$ROOTDIR"`);
124
+ lines.push('pivot_root . .old-root');
125
+ lines.push("");
126
+ lines.push("# Unmount old root - fail-closed: abort if old root stays visible");
127
+ lines.push("umount -l /.old-root 2>/dev/null");
128
+ lines.push('if [ -d "/.old-root" ]; then');
129
+ lines.push(' rmdir /.old-root 2>/dev/null || { echo "FATAL: old root still accessible" >&2; exit 1; }');
130
+ lines.push("fi");
131
+ lines.push("");
132
+ return lines.join("\n");
133
+ }
134
+ function findNodeModules() {
135
+ let dir = process.cwd();
136
+ for (let i = 0; i < 10; i++) {
137
+ const nmPath = path.join(dir, "node_modules");
138
+ if (fs.existsSync(nmPath))
139
+ return nmPath;
140
+ const parent = path.dirname(dir);
141
+ if (parent === dir)
142
+ break;
143
+ dir = parent;
144
+ }
145
+ return null;
146
+ }
147
+ function safeStat(p) {
148
+ try {
149
+ return fs.statSync(p);
150
+ }
151
+ catch {
152
+ return null;
153
+ }
154
+ }
155
+ function safeTouch(p) {
156
+ try {
157
+ fs.writeFileSync(p, "", { flag: "a" });
158
+ }
159
+ catch {
160
+ // best effort
161
+ }
162
+ }
163
+ //# sourceMappingURL=rootfs.js.map