@exagone313/dsh-podman 1.0.3 → 1.0.4

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 (89) hide show
  1. package/dist/generated/version.d.ts +2 -2
  2. package/dist/generated/version.js +2 -2
  3. package/docs/development.md +8 -4
  4. package/docs/development.zh.md +7 -4
  5. package/package.json +3 -1
  6. package/dist/approval-reasons.test.d.ts +0 -1
  7. package/dist/approval-reasons.test.js +0 -143
  8. package/dist/approval.test.d.ts +0 -1
  9. package/dist/approval.test.js +0 -593
  10. package/dist/card-route.test.d.ts +0 -1
  11. package/dist/card-route.test.js +0 -223
  12. package/dist/card-test-support.d.ts +0 -15
  13. package/dist/card-test-support.js +0 -133
  14. package/dist/container-env.test.d.ts +0 -1
  15. package/dist/container-env.test.js +0 -93
  16. package/dist/containers.test.d.ts +0 -1
  17. package/dist/containers.test.js +0 -621
  18. package/dist/daemons.test.d.ts +0 -1
  19. package/dist/daemons.test.js +0 -167
  20. package/dist/dsh-version.test.d.ts +0 -1
  21. package/dist/dsh-version.test.js +0 -25
  22. package/dist/env-rows.test.d.ts +0 -1
  23. package/dist/env-rows.test.js +0 -43
  24. package/dist/fs-provider.test.d.ts +0 -1
  25. package/dist/fs-provider.test.js +0 -301
  26. package/dist/guest-rpc.test.d.ts +0 -1
  27. package/dist/guest-rpc.test.js +0 -241
  28. package/dist/images.test.d.ts +0 -1
  29. package/dist/images.test.js +0 -86
  30. package/dist/locales.test.d.ts +0 -1
  31. package/dist/locales.test.js +0 -34
  32. package/dist/misc.test.d.ts +0 -1
  33. package/dist/misc.test.js +0 -169
  34. package/dist/mounts.test.d.ts +0 -1
  35. package/dist/mounts.test.js +0 -478
  36. package/dist/naming.test.d.ts +0 -1
  37. package/dist/naming.test.js +0 -28
  38. package/dist/package-deps.test.d.ts +0 -1
  39. package/dist/package-deps.test.js +0 -49
  40. package/dist/paths.test.d.ts +0 -1
  41. package/dist/paths.test.js +0 -76
  42. package/dist/plugin-meta.test.d.ts +0 -1
  43. package/dist/plugin-meta.test.js +0 -29
  44. package/dist/project-path.test.d.ts +0 -1
  45. package/dist/project-path.test.js +0 -66
  46. package/dist/read-only-shell.test.d.ts +0 -1
  47. package/dist/read-only-shell.test.js +0 -182
  48. package/dist/runtime-client.test.d.ts +0 -1
  49. package/dist/runtime-client.test.js +0 -53
  50. package/dist/secrets.test.d.ts +0 -1
  51. package/dist/secrets.test.js +0 -196
  52. package/dist/settings-commands.test.d.ts +0 -1
  53. package/dist/settings-commands.test.js +0 -596
  54. package/dist/settings-create.test.d.ts +0 -1
  55. package/dist/settings-create.test.js +0 -416
  56. package/dist/settings-default-env.test.d.ts +0 -1
  57. package/dist/settings-default-env.test.js +0 -175
  58. package/dist/settings-mounts.test.d.ts +0 -1
  59. package/dist/settings-mounts.test.js +0 -506
  60. package/dist/settings-paths.test.d.ts +0 -1
  61. package/dist/settings-paths.test.js +0 -65
  62. package/dist/settings-schema.test.d.ts +0 -1
  63. package/dist/settings-schema.test.js +0 -35
  64. package/dist/settings-workspaces.test.d.ts +0 -1
  65. package/dist/settings-workspaces.test.js +0 -240
  66. package/dist/spill-store.test.d.ts +0 -1
  67. package/dist/spill-store.test.js +0 -82
  68. package/dist/subprocess.test.d.ts +0 -1
  69. package/dist/subprocess.test.js +0 -344
  70. package/dist/terminal-preference.test.d.ts +0 -1
  71. package/dist/terminal-preference.test.js +0 -62
  72. package/dist/terminal-route.test.d.ts +0 -1
  73. package/dist/terminal-route.test.js +0 -265
  74. package/dist/terminal-tab.test.d.ts +0 -1
  75. package/dist/terminal-tab.test.js +0 -58
  76. package/dist/terminal-targets.test.d.ts +0 -1
  77. package/dist/terminal-targets.test.js +0 -43
  78. package/dist/terminal-titles.test.d.ts +0 -1
  79. package/dist/terminal-titles.test.js +0 -36
  80. package/dist/test-support.d.ts +0 -358
  81. package/dist/test-support.js +0 -499
  82. package/dist/version-compat.test.d.ts +0 -1
  83. package/dist/version-compat.test.js +0 -27
  84. package/dist/views.test.d.ts +0 -1
  85. package/dist/views.test.js +0 -23
  86. package/dist/volumes.test.d.ts +0 -1
  87. package/dist/volumes.test.js +0 -40
  88. package/dist/workspace-binding.test.d.ts +0 -1
  89. package/dist/workspace-binding.test.js +0 -523
@@ -1,167 +0,0 @@
1
- // SPDX-FileCopyrightText: 2026 Elouan Martinet <exa@elou.world>
2
- //
3
- // SPDX-License-Identifier: MIT
4
- import test from "node:test";
5
- import assert from "node:assert/strict";
6
- import { DAEMON_TOOLS } from "./test-support.js";
7
- import { publicDaemon, toolHandlers, TOOLS } from "./index.js";
8
- test("daemon_start accepts optional uid, gid and groups", () => {
9
- const tool = TOOLS.find((entry) => entry.name === "daemon_start");
10
- assert.ok(tool, "daemon_start registered");
11
- const properties = tool.parameters.properties;
12
- assert.equal(properties.name.type, "string");
13
- assert.ok(tool.parameters.required.includes("name"), "daemon_start must require a name");
14
- assert.equal(properties.uid.type, "integer");
15
- assert.equal(properties.uid.minimum, 0);
16
- assert.equal(properties.gid.type, "integer");
17
- assert.equal(properties.gid.minimum, 0);
18
- assert.equal(properties.groups.type, "array");
19
- assert.equal(properties.groups.items.type, "integer");
20
- assert.equal(properties.groups.items.minimum, 0);
21
- assert.equal(properties.inheritEnv.type, "boolean");
22
- });
23
- test("daemon_start serializes uid/gid as protobuf wrapper objects", async () => {
24
- let captured;
25
- const resolver = {
26
- containerBinding: async () => ({
27
- guest: {
28
- startDaemon: (request, _metadata, callback) => {
29
- captured = request;
30
- callback(null, {
31
- name: "valkey-1001",
32
- running: true,
33
- argv: ["valkey-server"],
34
- });
35
- },
36
- },
37
- token: "t",
38
- socket: "/run/x.sock",
39
- }),
40
- };
41
- const exec = { agent: { session: { header: { cwd: "/proj" } } } };
42
- await toolHandlers.daemon_start(resolver, {
43
- container: "valkey-ctr",
44
- argv: ["valkey-server"],
45
- uid: 1001,
46
- gid: 1001,
47
- }, exec);
48
- assert.deepEqual(captured.uid, { value: 1001 });
49
- assert.deepEqual(captured.gid, { value: 1001 });
50
- assert.deepEqual(captured.inheritEnv, { value: true });
51
- captured = undefined;
52
- await toolHandlers.daemon_start(resolver, { container: "valkey-ctr", argv: ["valkey-server"] }, exec);
53
- assert.equal(captured.uid, undefined);
54
- assert.equal(captured.gid, undefined);
55
- assert.deepEqual(captured.inheritEnv, { value: true });
56
- captured = undefined;
57
- await toolHandlers.daemon_start(resolver, { container: "valkey-ctr", argv: ["valkey-server"], inheritEnv: false }, exec);
58
- assert.deepEqual(captured.inheritEnv, { value: false });
59
- });
60
- test("daemon tools require no approval and are valid object-rooted schemas", () => {
61
- for (const name of DAEMON_TOOLS) {
62
- const tool = TOOLS.find((entry) => entry.name === name);
63
- assert.ok(tool, `${name} registered`);
64
- assert.notEqual(tool.approval, true, `${name} must not require approval`);
65
- assert.equal(tool.parameters.type, "object", `${name} type`);
66
- assert.equal(typeof tool.parameters.properties, "object");
67
- assert.ok(Array.isArray(tool.parameters.required));
68
- assert.ok(tool.parameters.required.includes("container"));
69
- }
70
- });
71
- test("publicDaemon omits the exit code while the daemon runs", () => {
72
- const running = publicDaemon({
73
- name: "web",
74
- argv: ["sleep", "600"],
75
- running: true,
76
- exitCode: 0,
77
- });
78
- assert.equal(running.running, true);
79
- assert.equal("exitCode" in running, false);
80
- const exited = publicDaemon({
81
- name: "web",
82
- argv: ["sleep", "600"],
83
- running: false,
84
- exitCode: 3,
85
- });
86
- assert.equal(exited.running, false);
87
- assert.equal(exited.exitCode, 3);
88
- });
89
- test("publicDaemon reports supplementary groups", () => {
90
- const withGroups = publicDaemon({
91
- name: "web",
92
- argv: ["sleep", "600"],
93
- running: true,
94
- uid: 1000,
95
- gid: 1000,
96
- groups: [3000, 4000],
97
- });
98
- assert.deepEqual(withGroups.groups, [3000, 4000]);
99
- const without = publicDaemon({
100
- name: "web",
101
- argv: ["sleep", "600"],
102
- running: true,
103
- groups: [],
104
- });
105
- assert.equal("groups" in without, false);
106
- });
107
- test("daemon_start returns a daemon info object", async () => {
108
- const resolver = {
109
- resolve: async () => ({
110
- guest: {
111
- startDaemon: (_metadata, _request, callback) => callback(null, {
112
- name: "web",
113
- running: true,
114
- argv: ["python3", "-m", "http.server", "8000"],
115
- uid: 1000,
116
- gid: 1000,
117
- }),
118
- },
119
- token: "t",
120
- socket: "/run/x.sock",
121
- }),
122
- };
123
- const exec = { agent: { session: { header: { cwd: "/proj" } } } };
124
- const out = await toolHandlers.daemon_start(resolver, {
125
- container: "default",
126
- argv: ["python3", "-m", "http.server", "8000"],
127
- name: "web",
128
- }, exec);
129
- assert.deepEqual(out, {
130
- name: "web",
131
- running: true,
132
- argv: ["python3", "-m", "http.server", "8000"],
133
- uid: 1000,
134
- gid: 1000,
135
- });
136
- });
137
- test("daemon_start resolves a relative working directory", async () => {
138
- const makeResolver = (defaultCwd) => {
139
- let captured;
140
- const resolver = {
141
- containerBinding: async () => ({
142
- guest: {
143
- startDaemon: (request, _metadata, callback) => {
144
- captured = request;
145
- callback(null, { name: "d", running: true, argv: ["x"] });
146
- },
147
- },
148
- token: "t",
149
- socket: "/run/x.sock",
150
- ...(defaultCwd === undefined ? {} : { defaultCwd }),
151
- }),
152
- };
153
- return { resolver, captured: () => captured };
154
- };
155
- const exec = { agent: { session: { header: { cwd: "/projects/team" } } } };
156
- const relative = makeResolver("/projects/team");
157
- await toolHandlers.daemon_start(relative.resolver, { container: "c", argv: ["x"], cwd: "sub" }, exec);
158
- assert.equal(relative.captured().cwd, "/projects/team/sub");
159
- // No explicit cwd: the mounted session directory is used.
160
- const defaulted = makeResolver("/projects/team");
161
- await toolHandlers.daemon_start(defaulted.resolver, { container: "c", argv: ["x"] }, exec);
162
- assert.equal(defaulted.captured().cwd, "/projects/team");
163
- // Not mounted: the guest agent's own working directory stays in place.
164
- const unmounted = makeResolver();
165
- await toolHandlers.daemon_start(unmounted.resolver, { container: "c", argv: ["x"] }, exec);
166
- assert.equal(unmounted.captured().cwd, undefined);
167
- });
@@ -1 +0,0 @@
1
- export {};
@@ -1,25 +0,0 @@
1
- // SPDX-FileCopyrightText: 2026 Elouan Martinet <exa@elou.world>
2
- //
3
- // SPDX-License-Identifier: MIT
4
- import test from "node:test";
5
- import assert from "node:assert/strict";
6
- import { versionFromPackages } from "./dsh-version.js";
7
- test("versionFromPackages reads the app version through the profile lookup", () => {
8
- const packages = {
9
- packageOf: (specifier, parentURL) => {
10
- assert.equal(specifier, "@deepseek-ai/dsh");
11
- assert.ok(parentURL.startsWith("file:"), "lookup uses this module's URL");
12
- return { version: "1.2.3" };
13
- },
14
- };
15
- assert.equal(versionFromPackages(packages), "1.2.3");
16
- });
17
- test("versionFromPackages reports no version when the package is unknown", () => {
18
- assert.equal(versionFromPackages({ packageOf: () => undefined }), undefined);
19
- });
20
- test("versionFromPackages ignores a missing lookup and unusable versions", () => {
21
- assert.equal(versionFromPackages(undefined), undefined);
22
- assert.equal(versionFromPackages({}), undefined);
23
- assert.equal(versionFromPackages({ packageOf: () => ({ version: "" }) }), undefined);
24
- assert.equal(versionFromPackages({ packageOf: () => ({ version: 3 }) }), undefined);
25
- });
@@ -1 +0,0 @@
1
- export {};
@@ -1,43 +0,0 @@
1
- // SPDX-FileCopyrightText: 2026 Elouan Martinet <exa@elou.world>
2
- //
3
- // SPDX-License-Identifier: MIT
4
- import test from "node:test";
5
- import assert from "node:assert/strict";
6
- import { commitEnvDraft, emptyEnvDraft, envKeyAvailable, envRows, removeEnvRow, renameEnvKey, setEnvValue, } from "./env-rows.js";
7
- test("envRows lists the committed entries and then the pending draft", () => {
8
- assert.deepEqual(envRows({}, undefined), []);
9
- assert.deepEqual(envRows({ A: "1" }, undefined), [
10
- { key: "A", value: "1", pending: false },
11
- ]);
12
- assert.deepEqual(envRows({ A: "1", B: "2" }, emptyEnvDraft()), [
13
- { key: "A", value: "1", pending: false },
14
- { key: "B", value: "2", pending: false },
15
- { key: "", value: "", pending: true },
16
- ]);
17
- });
18
- test("envKeyAvailable accepts only a new, non-empty key", () => {
19
- assert.equal(envKeyAvailable({}, ""), false);
20
- assert.equal(envKeyAvailable({ A: "1" }, "A"), false);
21
- assert.equal(envKeyAvailable({ A: "1" }, "B"), true);
22
- // A key inherited from the prototype is not an existing variable.
23
- assert.equal(envKeyAvailable({}, "toString"), true);
24
- });
25
- test("commitEnvDraft refuses an empty or duplicate key", () => {
26
- assert.equal(commitEnvDraft({}, { key: "", value: "x" }), undefined);
27
- assert.equal(commitEnvDraft({ A: "1" }, { key: "A", value: "x" }), undefined);
28
- });
29
- test("commitEnvDraft appends an accepted key with its value", () => {
30
- assert.deepEqual(commitEnvDraft({ A: "1" }, { key: "B", value: "2" }), {
31
- A: "1",
32
- B: "2",
33
- });
34
- assert.deepEqual(commitEnvDraft({}, { key: "B", value: "" }), { B: "" });
35
- });
36
- test("env transformations keep row order", () => {
37
- const env = { A: "1", B: "2", C: "3" };
38
- assert.deepEqual(renameEnvKey(env, 1, "BB"), { A: "1", BB: "2", C: "3" });
39
- assert.deepEqual(setEnvValue(env, 2, "33"), { A: "1", B: "2", C: "33" });
40
- assert.deepEqual(removeEnvRow(env, 0), { B: "2", C: "3" });
41
- // The input record is never mutated.
42
- assert.deepEqual(env, { A: "1", B: "2", C: "3" });
43
- });
@@ -1 +0,0 @@
1
- export {};
@@ -1,301 +0,0 @@
1
- // SPDX-FileCopyrightText: 2026 Elouan Martinet <exa@elou.world>
2
- //
3
- // SPDX-License-Identifier: MIT
4
- import test from "node:test";
5
- import assert from "node:assert/strict";
6
- import { editGuest, editProvider, fakeGuest, providerFor, stubResolver, } from "./test-support.js";
7
- import { createFilesystemProvider } from "./index.js";
8
- test("filesystem provider resolves absolute safe paths", async () => {
9
- const provider = createFilesystemProvider(stubResolver);
10
- const target = await provider.resolve("/projects/team/app", { cwd: "/x" });
11
- assert.equal(target.targetKey, "/projects/team/app");
12
- assert.equal(target.displayPath, "/projects/team/app");
13
- assert.deepEqual(target.binding, { kind: "binding" });
14
- });
15
- test("filesystem provider resolves absolute paths without a cwd", async () => {
16
- const seen = [];
17
- const provider = createFilesystemProvider({
18
- resolve: async () => ({ kind: "binding" }),
19
- resolveForPath: async (path, cwd) => {
20
- seen.push([path, cwd]);
21
- return { kind: "binding" };
22
- },
23
- });
24
- const target = await provider.resolve("/projects/team/app");
25
- assert.equal(target.targetKey, "/projects/team/app");
26
- assert.deepEqual(target.binding, { kind: "binding" });
27
- assert.deepEqual(seen, [["/projects/team/app", undefined]]);
28
- });
29
- test("filesystem provider resolves relative paths against the cwd", async () => {
30
- const provider = createFilesystemProvider(stubResolver);
31
- const target = await provider.resolve("README.md", {
32
- cwd: "/projects/team/app",
33
- });
34
- assert.equal(target.targetKey, "/projects/team/app/README.md");
35
- assert.equal(target.displayPath, "/projects/team/app/README.md");
36
- assert.deepEqual(target.binding, { kind: "binding" });
37
- });
38
- test("filesystem provider rejects unsafe paths", async () => {
39
- const provider = createFilesystemProvider(stubResolver);
40
- await assert.rejects(() => provider.resolve("/a/../b"));
41
- await assert.rejects(() => provider.resolve("/a/b/../../etc"));
42
- await assert.rejects(() => provider.resolve("../escape", { cwd: "/projects/team/app" }));
43
- });
44
- test("filesystem provider maps targets", () => {
45
- const provider = createFilesystemProvider(stubResolver);
46
- assert.equal(provider.fileUrl({ targetKey: "/a/b" }), "file:///a/b");
47
- assert.equal(provider.processPath({ targetKey: "/a/b" }), "/a/b");
48
- const parent = { targetKey: "/a" };
49
- assert.equal(provider.contains(parent, { targetKey: "/a" }), true);
50
- assert.equal(provider.contains(parent, { targetKey: "/a/b" }), true);
51
- assert.equal(provider.contains(parent, { targetKey: "/a2" }), false);
52
- assert.equal(provider.contains(parent, { targetKey: "/b" }), false);
53
- });
54
- test("filesystem provider lstat maps entry types without following links", async () => {
55
- const requests = [];
56
- const provider = createFilesystemProvider({
57
- resolveForPath: async () => ({
58
- guest: {
59
- stat: (request, _metadata, callback) => {
60
- requests.push(request);
61
- callback(null, {
62
- exists: true,
63
- isDir: false,
64
- isSymlink: true,
65
- size: "3",
66
- mode: "Lrwxrwxrwx",
67
- modifiedAt: "t",
68
- });
69
- },
70
- },
71
- token: "t",
72
- }),
73
- });
74
- const info = await provider.lstat("/projects/team/link", {
75
- cwd: "/projects/team",
76
- });
77
- assert.equal(info.type, "symlink");
78
- assert.equal(info.size, 3);
79
- assert.deepEqual(requests, [{ path: "/projects/team/link", noFollow: true }]);
80
- });
81
- test("filesystem provider lstat reports an absent entry as undefined", async () => {
82
- const provider = createFilesystemProvider({
83
- resolveForPath: async () => ({
84
- guest: {
85
- stat: (_request, _metadata, callback) => callback(null, { exists: false }),
86
- },
87
- token: "t",
88
- }),
89
- });
90
- assert.equal(await provider.lstat("/projects/team/missing", { cwd: "/x" }), undefined);
91
- });
92
- test("filesystem provider streamText decodes UTF-8 and rejects binary", async () => {
93
- const text = providerFor(fakeGuest(Buffer.from("héllo")).guest);
94
- const textTarget = await text.resolve("/a", { cwd: "/x" });
95
- let decoded = "";
96
- for await (const chunk of await text.streamText(textTarget))
97
- decoded += chunk;
98
- assert.equal(decoded, "héllo");
99
- const binary = providerFor(fakeGuest(Buffer.from([0x68, 0x00, 0x69])).guest);
100
- const binaryTarget = await binary.resolve("/a", { cwd: "/x" });
101
- await assert.rejects(async () => {
102
- for await (const _chunk of await binary.streamText(binaryTarget)) {
103
- // Drain the stream so the binary sample is inspected.
104
- }
105
- }, (error) => error instanceof Error &&
106
- error.code === "FS_NOT_TEXT");
107
- });
108
- test("filesystem provider readBytes returns content and caps at maxBytes", async () => {
109
- const fake = fakeGuest(Buffer.from("hello"));
110
- const provider = providerFor(fake.guest);
111
- const target = await provider.resolve("/a", { cwd: "/x" });
112
- const bytes = await provider.readBytes(target, undefined, 10);
113
- assert.equal(Buffer.from(bytes).toString(), "hello");
114
- assert.equal(fake.requests[0].length, 11);
115
- await assert.rejects(() => provider.readBytes(target, undefined, 3), (error) => error instanceof Error &&
116
- error.code === "FS_TOO_LARGE");
117
- });
118
- test("filesystem provider readByteRange returns the window and empty for zero length", async () => {
119
- const fake = fakeGuest(Buffer.from("abcdef"));
120
- const provider = providerFor(fake.guest);
121
- const target = await provider.resolve("/a", { cwd: "/x" });
122
- const empty = await provider.readByteRange(target, { offset: 0, length: 0 });
123
- assert.equal(empty.length, 0);
124
- assert.equal(fake.requests.length, 0);
125
- const window = await provider.readByteRange(target, { offset: 1, length: 3 });
126
- assert.equal(Buffer.from(window).toString(), "bcd");
127
- assert.deepEqual(fake.requests[0], { path: "/a", offset: 1, length: 3 });
128
- });
129
- test("filesystem provider editText reports the harness error codes", async () => {
130
- const binary = editProvider(editGuest({}, Buffer.from([0x68, 0x00, 0x69])));
131
- const binaryTarget = await binary.resolve("/a", { cwd: "/x" });
132
- await assert.rejects(() => binary.editText(binaryTarget, {
133
- oldString: "h",
134
- newString: "H",
135
- replaceAll: false,
136
- }), (error) => error.code === "FS_NOT_TEXT");
137
- const notFound = editProvider(editGuest({}, Buffer.from("hello")));
138
- const notFoundTarget = await notFound.resolve("/a", { cwd: "/x" });
139
- await assert.rejects(() => notFound.editText(notFoundTarget, {
140
- oldString: "zzz",
141
- newString: "x",
142
- replaceAll: false,
143
- }), (error) => error.code === "FS_EDIT_NOT_FOUND");
144
- const ambiguous = editProvider(editGuest({}, Buffer.from("aa")));
145
- const ambiguousTarget = await ambiguous.resolve("/a", { cwd: "/x" });
146
- await assert.rejects(() => ambiguous.editText(ambiguousTarget, {
147
- oldString: "a",
148
- newString: "b",
149
- replaceAll: false,
150
- }), (error) => error.code === "FS_AMBIGUOUS_EDIT");
151
- const stale = editProvider(editGuest({}, Buffer.from("hello")));
152
- const staleTarget = await stale.resolve("/a", { cwd: "/x" });
153
- await assert.rejects(() => stale.editText(staleTarget, { oldString: "h", newString: "H", replaceAll: false }, { version: "other" }), (error) => error.code === "FS_STALE_VERSION");
154
- });
155
- test("filesystem provider writeText reports the harness error codes", async () => {
156
- const existing = editProvider(editGuest({}, Buffer.from("hello")));
157
- const target = await existing.resolve("/a", { cwd: "/x" });
158
- await assert.rejects(() => existing.writeText(target, "x", { kind: "createIfAbsent" }), (error) => error.code === "FS_NOT_OBSERVED");
159
- await assert.rejects(() => existing.writeText(target, "x", {
160
- kind: "replaceIfVersion",
161
- version: "other",
162
- }), (error) => error.code === "FS_STALE_VERSION");
163
- const dir = editProvider(editGuest({ isDir: true }));
164
- const dirTarget = await dir.resolve("/a", { cwd: "/x" });
165
- await assert.rejects(() => dir.writeText(dirTarget, "x"), (error) => error.code === "FS_NOT_REGULAR_FILE");
166
- });
167
- test("filesystem provider writeText creates a file that was removed", async () => {
168
- // A read-then-removed path is a new file: creating it destroys nothing, so
169
- // the write must succeed instead of reporting a stale version.
170
- const gone = editProvider(editGuest({ exists: false }));
171
- const target = await gone.resolve("/a", { cwd: "/x" });
172
- const outcome = await gone.writeText(target, "fresh", {
173
- kind: "replaceIfVersion",
174
- version: "agent:1:5:-rw-r--r--",
175
- });
176
- assert.equal(outcome.operation, "create");
177
- assert.equal(outcome.before, null);
178
- assert.equal(outcome.after, "fresh");
179
- });
180
- test("filesystem provider rejects a pre-aborted signal with FS_ABORTED", async () => {
181
- const provider = editProvider(editGuest({}, Buffer.from("hello")));
182
- const target = await provider.resolve("/a", { cwd: "/x" });
183
- const controller = new AbortController();
184
- controller.abort();
185
- await assert.rejects(() => provider.readText(target, controller.signal), (error) => error.code === "FS_ABORTED");
186
- });
187
- test("filesystem provider editText normalizes line endings for matching", async () => {
188
- const binding = editGuest({}, Buffer.from("a\r\nb\r\n"));
189
- const provider = editProvider(binding);
190
- const target = await provider.resolve("/a", { cwd: "/x" });
191
- const outcome = await provider.editText(target, {
192
- oldString: "b",
193
- newString: "B",
194
- replaceAll: false,
195
- });
196
- // The diff basis is LF-normalized, and the file keeps its CRLF style.
197
- assert.equal(outcome.before, "a\nb\n");
198
- assert.equal(outcome.after, "a\nB\n");
199
- assert.equal(Buffer.concat(binding.writes).toString(), "a\r\nB\r\n");
200
- });
201
- test("filesystem provider maps absolute host paths into the execution world", () => {
202
- const provider = createFilesystemProvider({});
203
- assert.equal(provider.processPathFromHostPath("/home/u/project/f"), "/home/u/project/f");
204
- assert.equal(provider.processPathFromHostPath("rel/f"), undefined);
205
- });
206
- test("filesystem provider listDir returns resolved child targets", async () => {
207
- const requests = [];
208
- const provider = createFilesystemProvider({
209
- resolveForPath: async () => ({
210
- guest: {
211
- readDir: (request, _metadata, callback) => {
212
- requests.push(request);
213
- callback(null, {
214
- entries: [
215
- { name: "src", isDir: true, size: "0", type: "directory" },
216
- { name: "a.txt", isDir: false, size: "3", type: "file" },
217
- { name: "link", isDir: false, size: "1", type: "other" },
218
- ],
219
- });
220
- },
221
- },
222
- token: "t",
223
- }),
224
- });
225
- const target = await provider.resolve("/projects/team", {
226
- cwd: "/projects/team",
227
- });
228
- const entries = await provider.listDir(target);
229
- assert.deepEqual(requests, [{ path: "/projects/team" }]);
230
- assert.deepEqual(entries.map((entry) => ({
231
- name: entry.name,
232
- type: entry.type,
233
- path: entry.target.displayPath,
234
- binding: entry.target.binding.token,
235
- })), [
236
- {
237
- name: "src",
238
- type: "directory",
239
- path: "/projects/team/src",
240
- binding: "t",
241
- },
242
- {
243
- name: "a.txt",
244
- type: "file",
245
- path: "/projects/team/a.txt",
246
- binding: "t",
247
- },
248
- {
249
- name: "link",
250
- type: "other",
251
- path: "/projects/team/link",
252
- binding: "t",
253
- },
254
- ]);
255
- assert.equal(entries[1].size, 3);
256
- assert.equal(entries[0].size, undefined);
257
- });
258
- test("filesystem provider listDir falls back to the directory bit", async () => {
259
- const provider = createFilesystemProvider({
260
- resolveForPath: async () => ({
261
- guest: {
262
- readDir: (_request, _metadata, callback) => callback(null, {
263
- entries: [
264
- { name: "d", isDir: true, size: "0" },
265
- { name: "f", isDir: false, size: "1" },
266
- ],
267
- }),
268
- },
269
- token: "t",
270
- }),
271
- });
272
- const target = await provider.resolve("/w", { cwd: "/w" });
273
- const entries = await provider.listDir(target);
274
- assert.deepEqual(entries.map((entry) => entry.type), [
275
- "directory",
276
- "file",
277
- ]);
278
- });
279
- test("filesystem provider writeText normalizes the diff basis", async () => {
280
- const binding = editGuest({}, Buffer.from("a\r\nb\r\n"));
281
- const provider = editProvider(binding);
282
- const target = await provider.resolve("/a", { cwd: "/x" });
283
- const outcome = await provider.writeText(target, "c\r\nd\r\n");
284
- assert.equal(outcome.before, "a\nb\n");
285
- assert.equal(outcome.after, "c\nd\n");
286
- assert.equal(Buffer.concat(binding.writes).toString(), "c\r\nd\r\n");
287
- });
288
- test("filesystem provider reports watching as unsupported", async () => {
289
- const provider = createFilesystemProvider(stubResolver);
290
- const target = await provider.resolve("/projects/team/app", { cwd: "/x" });
291
- let notified = false;
292
- await assert.rejects(() => provider.watch(target, () => {
293
- notified = true;
294
- }, new AbortController().signal), (error) => error.code === "FS_IO_ERROR" &&
295
- error.message ===
296
- "Filesystem watching is not supported by this provider.");
297
- assert.equal(notified, false, "changed must not fire when watching is unsupported");
298
- const aborted = new AbortController();
299
- aborted.abort();
300
- assert.throws(() => provider.watch(target, () => { }, aborted.signal), (error) => error.code === "FS_ABORTED");
301
- });
@@ -1 +0,0 @@
1
- export {};