@backendkit-labs/agent-sandbox 0.1.0 → 0.1.1
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.
- package/README.md +2 -2
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -1
- package/dist/index.js.map +1 -1
- package/dist/paths.d.ts +9 -0
- package/dist/paths.d.ts.map +1 -0
- package/dist/paths.js +46 -0
- package/dist/paths.js.map +1 -0
- package/dist/service.d.ts.map +1 -1
- package/dist/service.js +30 -11
- package/dist/service.js.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -108,9 +108,9 @@ Host processes start from a scrubbed environment: names matching `KEY`, `SECRET`
|
|
|
108
108
|
|
|
109
109
|
- **Tools that start processes on their own.** Only calls that go through `ctx.sandbox.run(...)` are confined (`run_command` does). A custom or MCP tool that spawns a process itself is outside the sandbox: write it against `ctx.sandbox`.
|
|
110
110
|
- **`read-only` refuses tools by name.** It refuses exactly the tools listed in `writeTools` (the coding set lists `write_file` and `edit_file`). MCP tools and your own tools that write are not blocked unless you list them.
|
|
111
|
-
- **File tools
|
|
111
|
+
- **File tools run in the host process**, so they are not confined by a backend: the service judges the path instead (`authorizePath`). It follows symlinks and junctions, so a link inside the workspace cannot reach outside; the tool's own workspace check stays as the floor, even in full access. A tool that does its own I/O must call `ctx.sandbox.authorizePath(...)` itself.
|
|
112
112
|
- **Several engines may share one service**: each engine reports only the decisions of its own calls on its transport and audit log. `sandbox.onDecision(...)` on the service sees all of them.
|
|
113
113
|
|
|
114
114
|
## Not here yet
|
|
115
115
|
|
|
116
|
-
`request_escalation` (S2),
|
|
116
|
+
`request_escalation` (S2), a terminal tool through the service (there is none in this repo yet), `bwrap`/`landlock`, Windows and `ssh` backends (S4), private temp directories and waiting for child exit after a kill.
|
package/dist/index.d.ts
CHANGED
|
@@ -4,6 +4,7 @@ export { createSandboxPolicy, parsePolicyConfig, SandboxPolicyError } from './po
|
|
|
4
4
|
export type { SandboxPolicy, SandboxPolicyConfig, SandboxRule, ResolvedPolicy } from './policy';
|
|
5
5
|
export { PERMISSION_PRESETS, isPermissionPreset, matchPreset, needsApproval } from './presets';
|
|
6
6
|
export type { PermissionPreset, PresetDefinition, ApprovalLevel, ActionKind } from './presets';
|
|
7
|
+
export { realPathOf, isInside as isInsideDir } from './paths';
|
|
7
8
|
export { scrubEnv } from './env';
|
|
8
9
|
export type { EnvPolicy } from './env';
|
|
9
10
|
export { NoneBackend } from './backends/none';
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACtF,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/F,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC/F,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAClF,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACtF,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAChG,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/F,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC/F,OAAO,EAAE,UAAU,EAAE,QAAQ,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAClF,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.DEFAULT_MAX_OUTPUT_CHARS = exports.killProcessTree = exports.runProcess = exports.buildDockerArgs = exports.DockerBackend = exports.NoneBackend = exports.scrubEnv = exports.needsApproval = exports.matchPreset = exports.isPermissionPreset = exports.PERMISSION_PRESETS = exports.SandboxPolicyError = exports.parsePolicyConfig = exports.createSandboxPolicy = exports.createSandboxService = void 0;
|
|
3
|
+
exports.DEFAULT_MAX_OUTPUT_CHARS = exports.killProcessTree = exports.runProcess = exports.buildDockerArgs = exports.DockerBackend = exports.NoneBackend = exports.scrubEnv = exports.isInsideDir = exports.realPathOf = exports.needsApproval = exports.matchPreset = exports.isPermissionPreset = exports.PERMISSION_PRESETS = exports.SandboxPolicyError = exports.parsePolicyConfig = exports.createSandboxPolicy = exports.createSandboxService = void 0;
|
|
4
4
|
var service_1 = require("./service");
|
|
5
5
|
Object.defineProperty(exports, "createSandboxService", { enumerable: true, get: function () { return service_1.createSandboxService; } });
|
|
6
6
|
var policy_1 = require("./policy");
|
|
@@ -12,6 +12,9 @@ Object.defineProperty(exports, "PERMISSION_PRESETS", { enumerable: true, get: fu
|
|
|
12
12
|
Object.defineProperty(exports, "isPermissionPreset", { enumerable: true, get: function () { return presets_1.isPermissionPreset; } });
|
|
13
13
|
Object.defineProperty(exports, "matchPreset", { enumerable: true, get: function () { return presets_1.matchPreset; } });
|
|
14
14
|
Object.defineProperty(exports, "needsApproval", { enumerable: true, get: function () { return presets_1.needsApproval; } });
|
|
15
|
+
var paths_1 = require("./paths");
|
|
16
|
+
Object.defineProperty(exports, "realPathOf", { enumerable: true, get: function () { return paths_1.realPathOf; } });
|
|
17
|
+
Object.defineProperty(exports, "isInsideDir", { enumerable: true, get: function () { return paths_1.isInside; } });
|
|
15
18
|
var env_1 = require("./env");
|
|
16
19
|
Object.defineProperty(exports, "scrubEnv", { enumerable: true, get: function () { return env_1.scrubEnv; } });
|
|
17
20
|
var none_1 = require("./backends/none");
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAiD;AAAxC,+GAAA,oBAAoB,OAAA;AAE7B,mCAAsF;AAA7E,6GAAA,mBAAmB,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAEnE,qCAA+F;AAAtF,6GAAA,kBAAkB,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAAE,sGAAA,WAAW,OAAA;AAAE,wGAAA,aAAa,OAAA;AAE3E,6BAAiC;AAAxB,+FAAA,QAAQ,OAAA;AAEjB,wCAA8C;AAArC,mGAAA,WAAW,OAAA;AACpB,4CAAmE;AAA1D,uGAAA,aAAa,OAAA;AAAE,yGAAA,eAAe,OAAA;AAGvC,qCAAkF;AAAzE,qGAAA,UAAU,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,mHAAA,wBAAwB,OAAA"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAiD;AAAxC,+GAAA,oBAAoB,OAAA;AAE7B,mCAAsF;AAA7E,6GAAA,mBAAmB,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,4GAAA,kBAAkB,OAAA;AAEnE,qCAA+F;AAAtF,6GAAA,kBAAkB,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAAE,sGAAA,WAAW,OAAA;AAAE,wGAAA,aAAa,OAAA;AAE3E,iCAA8D;AAArD,mGAAA,UAAU,OAAA;AAAE,oGAAA,QAAQ,OAAe;AAC5C,6BAAiC;AAAxB,+FAAA,QAAQ,OAAA;AAEjB,wCAA8C;AAArC,mGAAA,WAAW,OAAA;AACpB,4CAAmE;AAA1D,uGAAA,aAAa,OAAA;AAAE,yGAAA,eAAe,OAAA;AAGvC,qCAAkF;AAAzE,qGAAA,UAAU,OAAA;AAAE,0GAAA,eAAe,OAAA;AAAE,mHAAA,wBAAwB,OAAA"}
|
package/dist/paths.d.ts
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Where `target` really points, symlinks and junctions followed, even when the file (or some of its parent
|
|
3
|
+
* directories) does not exist yet: the nearest existing ancestor is resolved and the missing tail appended.
|
|
4
|
+
* A dangling link on the way is followed to where it WOULD land, so it cannot be used to write outside.
|
|
5
|
+
*/
|
|
6
|
+
export declare function realPathOf(target: string, hops?: number): string;
|
|
7
|
+
/** Normalised containment test; case-insensitive on Windows, separator-agnostic. */
|
|
8
|
+
export declare function isInside(root: string, target: string): boolean;
|
|
9
|
+
//# sourceMappingURL=paths.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,MAAM,CAkB3D;AAED,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAQ9D"}
|
package/dist/paths.js
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.realPathOf = realPathOf;
|
|
4
|
+
exports.isInside = isInside;
|
|
5
|
+
const fs_1 = require("fs");
|
|
6
|
+
const path_1 = require("path");
|
|
7
|
+
const MAX_LINK_HOPS = 40;
|
|
8
|
+
/**
|
|
9
|
+
* Where `target` really points, symlinks and junctions followed, even when the file (or some of its parent
|
|
10
|
+
* directories) does not exist yet: the nearest existing ancestor is resolved and the missing tail appended.
|
|
11
|
+
* A dangling link on the way is followed to where it WOULD land, so it cannot be used to write outside.
|
|
12
|
+
*/
|
|
13
|
+
function realPathOf(target, hops = 0) {
|
|
14
|
+
const abs = (0, path_1.resolve)(target);
|
|
15
|
+
if (hops > MAX_LINK_HOPS)
|
|
16
|
+
throw new Error(`too many symbolic links resolving "${target}"`);
|
|
17
|
+
try {
|
|
18
|
+
return fs_1.realpathSync.native(abs);
|
|
19
|
+
}
|
|
20
|
+
catch { /* it, or an ancestor, does not exist: handled below */ }
|
|
21
|
+
let isLink = false;
|
|
22
|
+
try {
|
|
23
|
+
isLink = (0, fs_1.lstatSync)(abs).isSymbolicLink();
|
|
24
|
+
}
|
|
25
|
+
catch { /* not there at all */ }
|
|
26
|
+
if (isLink) {
|
|
27
|
+
// Exists as a link but its target does not: follow it to where it would land.
|
|
28
|
+
const dest = (0, fs_1.readlinkSync)(abs);
|
|
29
|
+
return realPathOf((0, path_1.isAbsolute)(dest) ? dest : (0, path_1.join)((0, path_1.dirname)(abs), dest), hops + 1);
|
|
30
|
+
}
|
|
31
|
+
const parent = (0, path_1.dirname)(abs);
|
|
32
|
+
if (parent === abs)
|
|
33
|
+
return abs;
|
|
34
|
+
return (0, path_1.join)(realPathOf(parent, hops + 1), (0, path_1.basename)(abs));
|
|
35
|
+
}
|
|
36
|
+
/** Normalised containment test; case-insensitive on Windows, separator-agnostic. */
|
|
37
|
+
function isInside(root, target) {
|
|
38
|
+
const norm = (p) => {
|
|
39
|
+
const s = (0, path_1.resolve)(p).replace(/\\/g, '/');
|
|
40
|
+
return process.platform === 'win32' ? s.toLowerCase() : s;
|
|
41
|
+
};
|
|
42
|
+
const r = norm(root);
|
|
43
|
+
const t = norm(target);
|
|
44
|
+
return t === r || t.startsWith(r.endsWith('/') ? r : r + '/');
|
|
45
|
+
}
|
|
46
|
+
//# sourceMappingURL=paths.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":";;AAUA,gCAkBC;AAGD,4BAQC;AAvCD,2BAA2D;AAC3D,+BAAoE;AAEpE,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB;;;;GAIG;AACH,SAAgB,UAAU,CAAC,MAAc,EAAE,IAAI,GAAG,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAA,cAAO,EAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,IAAI,GAAG,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,MAAM,GAAG,CAAC,CAAC;IAC3F,IAAI,CAAC;QACD,OAAO,iBAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC,CAAC,uDAAuD,CAAC,CAAC;IAEnE,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,CAAC;QAAC,MAAM,GAAG,IAAA,cAAS,EAAC,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC;IAClF,IAAI,MAAM,EAAE,CAAC;QACT,8EAA8E;QAC9E,MAAM,IAAI,GAAG,IAAA,iBAAY,EAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,UAAU,CAAC,IAAA,iBAAU,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAA,WAAI,EAAC,IAAA,cAAO,EAAC,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,cAAO,EAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,GAAG,CAAC;IAC/B,OAAO,IAAA,WAAI,EAAC,UAAU,CAAC,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,EAAE,IAAA,eAAQ,EAAC,GAAG,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED,oFAAoF;AACpF,SAAgB,QAAQ,CAAC,IAAY,EAAE,MAAc;IACjD,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE;QACvB,MAAM,CAAC,GAAG,IAAA,cAAO,EAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACzC,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC,CAAC;IACF,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;AAClE,CAAC"}
|
package/dist/service.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACO,eAAe,
|
|
1
|
+
{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACO,eAAe,EACV,aAAa,EACpC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;AAEnE,MAAM,WAAW,qBAAqB;IAClC,MAAM,EAAE,aAAa,CAAC;IACtB,qGAAqG;IACrG,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACjD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,4GAA4G;IAC5G,UAAU,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAAC;CACtD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CAsHnF"}
|
package/dist/service.js
CHANGED
|
@@ -4,17 +4,8 @@ exports.createSandboxService = createSandboxService;
|
|
|
4
4
|
const promises_1 = require("fs/promises");
|
|
5
5
|
const path_1 = require("path");
|
|
6
6
|
const env_1 = require("./env");
|
|
7
|
+
const paths_1 = require("./paths");
|
|
7
8
|
const presets_1 = require("./presets");
|
|
8
|
-
/** Normalised containment test; case-insensitive on Windows, separator-agnostic. */
|
|
9
|
-
function isInside(root, target) {
|
|
10
|
-
const norm = (p) => {
|
|
11
|
-
const s = (0, path_1.resolve)(p).replace(/\\/g, '/');
|
|
12
|
-
return process.platform === 'win32' ? s.toLowerCase() : s;
|
|
13
|
-
};
|
|
14
|
-
const r = norm(root);
|
|
15
|
-
const t = norm(target);
|
|
16
|
-
return t === r || t.startsWith(r.endsWith('/') ? r : r + '/');
|
|
17
|
-
}
|
|
18
9
|
function createSandboxService(options) {
|
|
19
10
|
const { policy, backends } = options;
|
|
20
11
|
const listeners = new Set();
|
|
@@ -56,6 +47,34 @@ function createSandboxService(options) {
|
|
|
56
47
|
const kind = policy.commandTools().includes(tool) ? 'command' : policy.writeTools().includes(tool) ? 'write' : 'read';
|
|
57
48
|
return (0, presets_1.needsApproval)(r.approval, kind) ? 'ask' : 'none';
|
|
58
49
|
},
|
|
50
|
+
authorizePath(caller, req) {
|
|
51
|
+
const r = policy.resolve(caller, req.tool);
|
|
52
|
+
const deny = (reason) => {
|
|
53
|
+
emit({ ...base(caller, req.tool), mode: r.mode, network: r.network, outcome: 'SANDBOX_DENIED', reason });
|
|
54
|
+
return { ok: false, code: 'SANDBOX_DENIED', reason };
|
|
55
|
+
};
|
|
56
|
+
if (r.mode === 'danger-full-access')
|
|
57
|
+
return { ok: true };
|
|
58
|
+
if (req.access === 'write' && r.mode === 'read-only') {
|
|
59
|
+
return deny(`"${req.path}" is not writable: the sandbox policy for agent "${caller.agentId}" is read-only`);
|
|
60
|
+
}
|
|
61
|
+
// Judge where the path really lands, and against roots that are themselves resolved (a root may be a link too).
|
|
62
|
+
let real;
|
|
63
|
+
let roots;
|
|
64
|
+
try {
|
|
65
|
+
real = (0, paths_1.realPathOf)(req.path);
|
|
66
|
+
roots = [req.workspace, ...r.roots, ...(req.extraRoots ?? [])].map(root => (0, paths_1.realPathOf)(root));
|
|
67
|
+
}
|
|
68
|
+
catch (err) {
|
|
69
|
+
return deny(`cannot resolve "${req.path}": ${err instanceof Error ? err.message : String(err)}`);
|
|
70
|
+
}
|
|
71
|
+
if (!roots.some(root => (0, paths_1.isInside)(root, real))) {
|
|
72
|
+
return deny(`"${req.path}" resolves to "${real}", outside the allowed roots`);
|
|
73
|
+
}
|
|
74
|
+
if (req.access === 'write')
|
|
75
|
+
emit({ ...base(caller, req.tool), mode: r.mode, network: r.network, outcome: 'allowed' });
|
|
76
|
+
return { ok: true };
|
|
77
|
+
},
|
|
59
78
|
async run(caller, req) {
|
|
60
79
|
const r = policy.resolve(caller, req.tool);
|
|
61
80
|
const refuse = (code, reason, backend) => {
|
|
@@ -63,7 +82,7 @@ function createSandboxService(options) {
|
|
|
63
82
|
return { ok: false, code, reason, mode: r.mode, network: r.network, ...(backend ? { backend } : {}) };
|
|
64
83
|
};
|
|
65
84
|
const workspace = req.workspace ?? req.cwd;
|
|
66
|
-
if (r.mode !== 'danger-full-access' && ![workspace, ...r.roots].some(root => isInside(root, req.cwd))) {
|
|
85
|
+
if (r.mode !== 'danger-full-access' && ![workspace, ...r.roots].some(root => (0, paths_1.isInside)(root, req.cwd))) {
|
|
67
86
|
return refuse('SANDBOX_DENIED', `working directory "${req.cwd}" is outside the allowed roots`);
|
|
68
87
|
}
|
|
69
88
|
// First backend that can really enforce the mode. Never "the host, because nothing else works".
|
package/dist/service.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@backendkit-labs/agent-sandbox",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Confinement and permissions for what agents run: sandbox modes, presets, a single policy point, swappable backends (host, docker) and environment hygiene, for @backendkit-labs/agent-core",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
"test": "jest"
|
|
23
23
|
},
|
|
24
24
|
"peerDependencies": {
|
|
25
|
-
"@backendkit-labs/agent-core": ">=0.
|
|
25
|
+
"@backendkit-labs/agent-core": ">=0.31.0 <0.32.0"
|
|
26
26
|
},
|
|
27
27
|
"devDependencies": {
|
|
28
28
|
"@types/jest": "^29.0.0",
|