@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,240 +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 { strict as assert } from "node:assert";
6
- import { baseValue, fakeContext, fakeScope } from "./card-test-support.js";
7
- import { installCardCommandDriver } from "./card-test-support.js";
8
- import { WORKSPACE_ID } from "./test-support.js";
9
- test("refresh on install publishes containers, images and workspaces", async () => {
10
- const scope = fakeScope(baseValue());
11
- const calls = [];
12
- const resolver = {
13
- getConfig: () => ({
14
- defaultImage: "archlinux",
15
- socketsRoot: "/run/dsh-podman",
16
- projectsRoot: "/projects",
17
- }),
18
- setConfig: () => { },
19
- async control(method, request) {
20
- calls.push([method, request]);
21
- if (method === "getVersion")
22
- return { version: "0.2.0", commit: "abc" };
23
- if (method === "listContainers") {
24
- return { containers: [{ containerName: "c1", workspaceSlug: "w1" }] };
25
- }
26
- if (method === "listImages") {
27
- return { images: [{ imageId: "img1" }] };
28
- }
29
- if (method === "listWorkspaces") {
30
- return {
31
- workspaces: [{
32
- workspaceSlug: "w1",
33
- mounts: [{ projectName: "team/app" }],
34
- }],
35
- };
36
- }
37
- if (method === "listVolumes") {
38
- return { volumes: [{ name: "data" }, { name: "cache" }] };
39
- }
40
- if (method === "listSecrets") {
41
- return { secrets: [{ name: "db-pass" }, { name: "api-key" }] };
42
- }
43
- return {};
44
- },
45
- };
46
- await installCardCommandDriver(fakeContext(scope), resolver);
47
- await scope.update({}); // settle the queued async refresh
48
- assert.deepEqual(calls.map(([method]) => method), [
49
- "getVersion",
50
- "listContainers",
51
- "listImages",
52
- "listWorkspaces",
53
- "listVolumes",
54
- "listSecrets",
55
- "listCaches",
56
- ]);
57
- assert.equal(scope.value.containers.length, 1);
58
- assert.equal(scope.value.images.length, 1);
59
- const workspaces = scope.value.workspaces;
60
- assert.equal(workspaces.length, 1);
61
- assert.equal(workspaces[0].workspaceSlug, "w1");
62
- assert.equal(workspaces[0].projectName, "team/app");
63
- assert.deepEqual(scope.value.volumes, [{ name: "data" }, { name: "cache" }]);
64
- assert.deepEqual(scope.value.secrets, [{ name: "db-pass" }, {
65
- name: "api-key",
66
- }]);
67
- });
68
- test("create command drives createWorkspace with env", async () => {
69
- const scope = fakeScope(baseValue());
70
- const calls = [];
71
- const resolver = {
72
- getConfig: () => ({}),
73
- setConfig: () => { },
74
- async control(method, request) {
75
- calls.push([method, request]);
76
- if (method === "listContainers")
77
- return { containers: [] };
78
- if (method === "listImages")
79
- return { images: [] };
80
- if (method === "listWorkspaces")
81
- return { workspaces: [] };
82
- return {};
83
- },
84
- };
85
- await installCardCommandDriver(fakeContext(scope), resolver);
86
- await scope.update({
87
- command: {
88
- op: "create",
89
- workspace: "w1",
90
- projectName: "w1",
91
- image: "img1",
92
- at: 13,
93
- mounts: [],
94
- env: { A: "1", B: "2" },
95
- container: "",
96
- secretEnv: {},
97
- mount: null,
98
- },
99
- });
100
- await new Promise((resolve) => setImmediate(resolve));
101
- const createCall = calls.find(([method]) => method === "createWorkspace");
102
- assert.deepEqual(createCall?.[1], {
103
- workspaceSlug: "w1",
104
- projectName: "w1",
105
- imageId: "img1",
106
- env: { A: "1", B: "2" },
107
- });
108
- assert.equal(scope.value.command, null);
109
- });
110
- test("create command drives createWorkspace without env when empty", async () => {
111
- const scope = fakeScope(baseValue());
112
- const calls = [];
113
- const resolver = {
114
- getConfig: () => ({}),
115
- setConfig: () => { },
116
- async control(method, request) {
117
- calls.push([method, request]);
118
- if (method === "listContainers")
119
- return { containers: [] };
120
- if (method === "listImages")
121
- return { images: [] };
122
- if (method === "listWorkspaces")
123
- return { workspaces: [] };
124
- return {};
125
- },
126
- };
127
- await installCardCommandDriver(fakeContext(scope), resolver);
128
- await scope.update({
129
- command: {
130
- op: "create",
131
- workspace: "w1",
132
- projectName: "w1",
133
- image: "img1",
134
- at: 14,
135
- mounts: [],
136
- env: {},
137
- container: "",
138
- secretEnv: {},
139
- mount: null,
140
- },
141
- });
142
- await new Promise((resolve) => setImmediate(resolve));
143
- const createCall = calls.find(([method]) => method === "createWorkspace");
144
- assert.deepEqual(createCall?.[1], {
145
- workspaceSlug: "w1",
146
- projectName: "w1",
147
- imageId: "img1",
148
- });
149
- assert.equal(scope.value.command, null);
150
- });
151
- test("workspace list comes from the dsh registry even without orchestrator state", async () => {
152
- const scope = fakeScope(baseValue());
153
- const registry = {
154
- list: () => [
155
- {
156
- id: WORKSPACE_ID,
157
- path: "/projects/team/app",
158
- title: "app",
159
- createdAt: "2026-01-01T00:00:00Z",
160
- },
161
- ],
162
- };
163
- const resolver = {
164
- getConfig: () => ({
165
- defaultImage: "archlinux",
166
- socketsRoot: "/run/dsh-podman",
167
- projectsRoot: "/projects",
168
- }),
169
- setConfig: () => { },
170
- async control(method) {
171
- if (method === "listContainers")
172
- return { containers: [] };
173
- if (method === "listImages")
174
- return { images: [] };
175
- if (method === "listWorkspaces")
176
- return { workspaces: [] };
177
- return {};
178
- },
179
- };
180
- await installCardCommandDriver(fakeContext(scope), resolver, registry);
181
- await scope.update({});
182
- const workspaces = scope.value.workspaces;
183
- assert.equal(workspaces.length, 1);
184
- assert.equal(workspaces[0].projectName, "team/app");
185
- assert.equal(workspaces[0].containerName, "");
186
- assert.deepEqual(workspaces[0].mounts, [
187
- { projectName: "team/app", mode: "MOUNT_MODE_READ_WRITE" },
188
- ]);
189
- assert.ok(workspaces[0].workspaceSlug.length > 0);
190
- });
191
- test("dsh workspace layers orchestrator container info", async () => {
192
- const scope = fakeScope(baseValue());
193
- const registry = {
194
- list: () => [
195
- {
196
- id: WORKSPACE_ID,
197
- path: "/projects/team/app",
198
- title: "app",
199
- createdAt: "2026-01-01T00:00:00Z",
200
- },
201
- ],
202
- };
203
- const resolver = {
204
- getConfig: () => ({
205
- defaultImage: "archlinux",
206
- socketsRoot: "/run/dsh-podman",
207
- projectsRoot: "/projects",
208
- }),
209
- setConfig: () => { },
210
- async control(method) {
211
- if (method === "listContainers")
212
- return { containers: [] };
213
- if (method === "listImages")
214
- return { images: [] };
215
- if (method === "listWorkspaces") {
216
- return {
217
- workspaces: [{
218
- workspaceSlug: WORKSPACE_ID,
219
- containerName: `dsh-podman-${WORKSPACE_ID}-default`,
220
- imageId: "arch",
221
- status: "running",
222
- mounts: [{
223
- projectName: "team/app",
224
- mode: "MOUNT_MODE_READ_WRITE",
225
- }],
226
- }],
227
- };
228
- }
229
- return {};
230
- },
231
- };
232
- await installCardCommandDriver(fakeContext(scope), resolver, registry);
233
- await scope.update({});
234
- const workspaces = scope.value.workspaces;
235
- assert.equal(workspaces.length, 1);
236
- assert.equal(workspaces[0].projectName, "team/app");
237
- assert.equal(workspaces[0].containerName, `dsh-podman-${WORKSPACE_ID}-default`);
238
- assert.equal(workspaces[0].status, "running");
239
- assert.equal(workspaces[0].imageId, "arch");
240
- });
@@ -1 +0,0 @@
1
- export {};
@@ -1,82 +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 { createSpillStore, sessionSegment } from "./spill-store.js";
7
- import { guestFileRecorder } from "./test-support.js";
8
- const SESSION_ID = "2c573001-4171-4900-904b-12a5cc02737a";
9
- const SEGMENT = sessionSegment(SESSION_ID);
10
- function fakeCtx(sessions) {
11
- return {
12
- get: (name) => name === "sessions" ? { get: (id) => sessions[id] } : undefined,
13
- };
14
- }
15
- function withSession() {
16
- return fakeCtx({ [SESSION_ID]: { header: { cwd: "/projects/team" } } });
17
- }
18
- test("saveText writes a tool-result spill inside the session container", async () => {
19
- const { writes, mkdirs, resolver } = guestFileRecorder();
20
- const store = createSpillStore(withSession(), resolver);
21
- const content = "x".repeat(60000);
22
- const ref = await store.saveText({
23
- owner: { sessionId: SESSION_ID },
24
- source: {
25
- kind: "tool",
26
- toolName: "web_fetch",
27
- callId: "c1",
28
- label: "result",
29
- },
30
- suggestedName: "web_fetch.txt",
31
- content,
32
- });
33
- assert.equal(mkdirs[0], `/tmp/dsh-podman/spill/${SEGMENT}`);
34
- assert.equal(writes.length, 1);
35
- assert.match(writes[0].path, new RegExp(`^/tmp/dsh-podman/spill/${SEGMENT}/[0-9a-f]{32}-web_fetch\\.txt$`));
36
- assert.equal(ref.locator, writes[0].path);
37
- assert.equal(ref.bytes, content.length);
38
- assert.equal(writes[0].content, content, "the full text is persisted verbatim");
39
- assert.match(ref.retrievalHint, /container_read/);
40
- });
41
- test("saveText never lets the suggested name escape the spill directory", async () => {
42
- const { writes, resolver } = guestFileRecorder();
43
- const store = createSpillStore(withSession(), resolver);
44
- const ref = await store.saveText({
45
- owner: { sessionId: SESSION_ID },
46
- source: {},
47
- suggestedName: "../../etc/passwd",
48
- content: "x",
49
- });
50
- assert.ok(ref.locator.startsWith(`/tmp/dsh-podman/spill/${SEGMENT}/`));
51
- assert.ok(!ref.locator.includes(".."));
52
- assert.equal(writes.length, 1);
53
- });
54
- test("sessionSegment neutralizes path-shaped session ids", () => {
55
- // A session id is not necessarily a UUID, so it must never survive as a path
56
- // segment that can traverse or collide.
57
- for (const id of ["..", ".", "../../etc", "a/b", "session-1", "sess..ion", ""]) {
58
- const segment = sessionSegment(id);
59
- assert.notEqual(segment, "");
60
- assert.notEqual(segment, ".");
61
- assert.notEqual(segment, "..");
62
- assert.doesNotMatch(segment, /[^A-Za-z0-9_-]/);
63
- assert.ok(!segment.includes(".."), `${JSON.stringify(id)} -> ${segment}`);
64
- }
65
- // Distinct ids never share a directory, even when their readable prefixes do.
66
- assert.notEqual(sessionSegment("session-1"), sessionSegment("session_1"));
67
- // The readable prefix is kept for debugging.
68
- assert.match(sessionSegment("session-42"), /^session-42-/);
69
- // A UUID-shaped id stays recognizable.
70
- assert.match(SEGMENT, /^2c573001-4171-4900-904b-[0-9a-f]+$/);
71
- assert.equal(sessionSegment(SESSION_ID), SEGMENT);
72
- });
73
- test("saveText rejects when the session has no working directory", async () => {
74
- const { resolver } = guestFileRecorder();
75
- const store = createSpillStore(fakeCtx({}), resolver);
76
- await assert.rejects(() => store.saveText({
77
- owner: { sessionId: SESSION_ID },
78
- source: {},
79
- suggestedName: "a.txt",
80
- content: "x",
81
- }), /no session working directory/);
82
- });
@@ -1 +0,0 @@
1
- export {};
@@ -1,344 +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 { FakeTerminalCall, fakeTerminalResolver, spawnGuest, spawnSpec, } from "./test-support.js";
7
- import { createSubprocessProvider, globCwd, outputReader, remoteArgv, } from "./index.js";
8
- import { SubprocessExecutableNotFoundError } from "@deepseek-ai/dsh-subprocess";
9
- test("globCwd runs a discovery listing from its absolute search root", () => {
10
- assert.equal(globCwd(["rg", "--files", "--glob=sub/b.txt", "--", "/tmp/globtest"], "/projects/team"), "/tmp/globtest");
11
- assert.equal(globCwd(["rg", "--files", "--glob=a", "--", "sub"], "/projects/team"), undefined, "a relative root keeps the caller's cwd");
12
- assert.equal(globCwd(["rg", "--files", "--glob=a"], "/projects/team"), undefined, "no search root keeps the caller's cwd");
13
- assert.equal(globCwd(["rg", "-n", "x", "--", "/tmp/x"], "/projects/team"), undefined, "only a discovery listing is re-anchored");
14
- assert.equal(globCwd(["bash", "-c", "rg"], "/projects/team"), undefined);
15
- assert.equal(globCwd(["rg", "--files", "--", "/a", "/b"], "/projects/team"), undefined, "several search roots keep the caller's cwd");
16
- });
17
- test("subprocess provider runs a glob listing from its search root", async () => {
18
- const fake = spawnGuest();
19
- const provider = createSubprocessProvider(fake.resolver);
20
- const handle = provider.spawn(spawnSpec({
21
- argv: ["rg", "--files", "--glob=sub/b.txt", "--", "/tmp/globtest"],
22
- }));
23
- await handle.done;
24
- const start = fake.starts[0].start;
25
- assert.equal(start.cwd, "/tmp/globtest");
26
- assert.deepEqual(start.argv, [
27
- "/usr/bin/rg",
28
- "--files",
29
- "--glob=sub/b.txt",
30
- "--",
31
- "/tmp/globtest",
32
- ]);
33
- });
34
- test("remoteArgv remaps ripgrep onto the guest path", () => {
35
- assert.deepEqual(remoteArgv(["rg", "-n", "foo"]), [
36
- "/usr/bin/rg",
37
- "-n",
38
- "foo",
39
- ]);
40
- assert.deepEqual(remoteArgv(["/usr/bin/rg", "-l", "x"]), [
41
- "/usr/bin/rg",
42
- "-l",
43
- "x",
44
- ]);
45
- });
46
- test("remoteArgv unwraps landlock-run wrappers", () => {
47
- assert.deepEqual(remoteArgv(["landlock-run", "--", "/usr/bin/rg", "-l"]), [
48
- "/usr/bin/rg",
49
- "-l",
50
- ]);
51
- assert.deepEqual(remoteArgv(["landlock-run", "--", "rg", "-l", "src"]), ["/usr/bin/rg", "-l", "src"]);
52
- });
53
- test("remoteArgv leaves ordinary commands untouched", () => {
54
- assert.deepEqual(remoteArgv(["bash", "-c", "echo hi"]), [
55
- "bash",
56
- "-c",
57
- "echo hi",
58
- ]);
59
- assert.deepEqual(remoteArgv(["landlock-run", "cmd", "arg"]), [
60
- "landlock-run",
61
- "cmd",
62
- "arg",
63
- ]);
64
- assert.deepEqual(remoteArgv([]), []);
65
- });
66
- test("outputReader is undefined without a bounded mode", () => {
67
- assert.equal(outputReader(undefined), undefined);
68
- assert.equal(outputReader(null), undefined);
69
- assert.equal(outputReader("pipe"), undefined);
70
- assert.equal(outputReader({ maxBytes: -1 }), undefined);
71
- assert.equal(outputReader({ maxBytes: Number.NaN }), undefined);
72
- });
73
- test("outputReader reads appended output", () => {
74
- const reader = outputReader({ maxBytes: 16 });
75
- reader.append(Buffer.from("hello "));
76
- reader.append(Buffer.from("world"));
77
- const first = reader.readFrom(0);
78
- assert.equal(first.text, "hello world");
79
- assert.equal(first.nextOffset, 11);
80
- assert.equal(first.lossy, false);
81
- });
82
- test("outputReader advertises a valid spill only for a lossy read", () => {
83
- const spill = { path: "/tmp/dsh-podman/x.stdout", maxBytes: 64 };
84
- const reader = outputReader({ maxBytes: 4 }, spill);
85
- reader.append(Buffer.from("abcdefgh"));
86
- assert.equal(reader.spillNeeded, true);
87
- const lossy = reader.readFrom(0);
88
- assert.equal(lossy.lossy, true);
89
- assert.equal(lossy.spillPath, spill.path);
90
- reader.setSpillValid(false);
91
- assert.equal(reader.readFrom(0).spillPath, undefined);
92
- const small = outputReader({ maxBytes: 64 }, spill);
93
- small.append(Buffer.from("hi"));
94
- assert.equal(small.spillNeeded, false);
95
- assert.equal(small.readFrom(0).spillPath, undefined);
96
- });
97
- test("outputReader drops bytes beyond the retention window", () => {
98
- const reader = outputReader({ maxBytes: 5 });
99
- reader.append(Buffer.from("hello"));
100
- reader.append(Buffer.from("world"));
101
- const read = reader.readFrom(0);
102
- assert.equal(read.text, "world");
103
- assert.equal(read.nextOffset, 10);
104
- assert.equal(read.lossy, true);
105
- });
106
- test("outputReader with a zero cap retains nothing", () => {
107
- const spill = { path: "/tmp/dsh-podman/x.stdout", maxBytes: 64 };
108
- const reader = outputReader({ maxBytes: 0 }, spill);
109
- reader.append(Buffer.from("abcdef"));
110
- // `subarray(-0)` is the whole buffer, so a zero cap must be special-cased.
111
- assert.equal(reader.readFrom(0).text, "");
112
- assert.equal(reader.readFrom(0).lossy, true);
113
- assert.equal(reader.spillNeeded, true);
114
- assert.equal(reader.readFrom(0).spillPath, spill.path);
115
- });
116
- test("outputReader keeps the exact tail across many small chunks", () => {
117
- const reader = outputReader({ maxBytes: 4 });
118
- for (const character of "0123456789") {
119
- reader.append(Buffer.from(character));
120
- }
121
- const read = reader.readFrom(0);
122
- assert.equal(read.text, "6789");
123
- assert.equal(read.nextOffset, 10);
124
- assert.equal(read.lossy, true);
125
- });
126
- test("outputReader honors in-window offsets", () => {
127
- const reader = outputReader({ maxBytes: 5 });
128
- reader.append(Buffer.from("abcdefghij"));
129
- const atStart = reader.readFrom(5);
130
- assert.equal(atStart.text, "fghij");
131
- assert.equal(atStart.lossy, false);
132
- const pastEnd = reader.readFrom(10);
133
- assert.equal(pastEnd.text, "");
134
- assert.equal(pastEnd.lossy, false);
135
- });
136
- test("resolveExecutable returns absolute paths and reports bare names as not found", async () => {
137
- const provider = createSubprocessProvider({});
138
- assert.equal(await provider.resolveExecutable("/usr/bin/ls"), "/usr/bin/ls");
139
- assert.equal(await provider.resolveExecutable("/bin/sh"), "/bin/sh");
140
- // The harness treats only this class as "not installed", so shell discovery
141
- // skips a candidate the images do not carry instead of failing.
142
- for (const command of ["", "bin/tool", "ls", "zsh"]) {
143
- await assert.rejects(() => provider.resolveExecutable(command), SubprocessExecutableNotFoundError);
144
- }
145
- });
146
- test("terminalEnvironment reports the container's shell family", async () => {
147
- const provider = createSubprocessProvider({});
148
- assert.deepEqual(await provider.terminalEnvironment(), {
149
- platform: "posix",
150
- defaultShell: "/bin/sh",
151
- });
152
- });
153
- test("spawnTerminal drives the guest terminal stream", async () => {
154
- const fake = new FakeTerminalCall();
155
- const provider = createSubprocessProvider(fakeTerminalResolver(fake));
156
- const handle = await provider.spawnTerminal({
157
- argv: ["bash"],
158
- cwd: "/projects/team",
159
- rows: 24,
160
- cols: 80,
161
- terminalType: "xterm-256color",
162
- graceMs: 1000,
163
- });
164
- assert.equal(handle.pid, 42);
165
- assert.equal(fake.start.env.TERM, "xterm-256color");
166
- const chunks = [];
167
- handle.output.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
168
- const outputEnded = new Promise((resolve) => handle.output.on("end", resolve));
169
- fake.emitStdout(Buffer.from("hello"));
170
- await handle.write("ls\n");
171
- assert.deepEqual(fake.stdinChunks.map((chunk) => chunk.toString("utf8")), ["ls\n"]);
172
- await handle.resize(100, 40);
173
- assert.deepEqual(fake.resizes, [{ rows: 40, cols: 100 }]);
174
- const activity = await handle.inspectActivity();
175
- assert.equal(activity.state, "unknown");
176
- assert.ok(activity.revision > 0, "observed activity must advance the revision");
177
- assert.deepEqual(await handle.inspectForeground(), {
178
- processGroupId: 7,
179
- inputWaiting: true,
180
- });
181
- assert.equal(await handle.signalForeground("SIGINT"), 7);
182
- fake.emitExit(0, false);
183
- assert.deepEqual(await handle.done, { exitCode: 0, signal: null });
184
- await outputEnded;
185
- assert.equal(Buffer.concat(chunks).toString("utf8"), "hello");
186
- await handle.terminate();
187
- });
188
- test("spawnTerminal rejects an empty argv", async () => {
189
- const provider = createSubprocessProvider(fakeTerminalResolver(new FakeTerminalCall()));
190
- await assert.rejects(() => provider.spawnTerminal({
191
- argv: [],
192
- cwd: "/projects/team",
193
- rows: 24,
194
- cols: 80,
195
- }), /argv must contain a program/);
196
- });
197
- test("subprocess provider terminates live processes on dispose", async () => {
198
- const { signals, resolver } = spawnGuest({ emitExit: false });
199
- const provider = createSubprocessProvider(resolver);
200
- provider.spawn(spawnSpec());
201
- await new Promise((resolve) => setTimeout(resolve, 0));
202
- provider.dispose();
203
- assert.ok(signals.some((signal) => signal.signal === "SIGTERM"));
204
- });
205
- test("subprocess provider terminates on the spec abort signal", async () => {
206
- const { signals, resolver } = spawnGuest({ emitExit: false });
207
- const provider = createSubprocessProvider(resolver);
208
- const controller = new AbortController();
209
- provider.spawn(spawnSpec({ signal: controller.signal }));
210
- await new Promise((resolve) => setTimeout(resolve, 0));
211
- controller.abort();
212
- assert.ok(signals.some((signal) => signal.signal === "SIGTERM"));
213
- });
214
- test("subprocess provider rejects a pre-aborted spawn synchronously", () => {
215
- const { resolver } = spawnGuest();
216
- const provider = createSubprocessProvider(resolver);
217
- const controller = new AbortController();
218
- controller.abort(new Error("stop"));
219
- assert.throws(() => provider.spawn(spawnSpec({ signal: controller.signal })), /aborted before spawn: Error: stop/);
220
- });
221
- test("subprocess provider waitForExit honors an abort signal", async () => {
222
- const live = spawnGuest({ emitExit: false });
223
- const liveProvider = createSubprocessProvider(live.resolver);
224
- const handle = liveProvider.spawn(spawnSpec());
225
- await new Promise((resolve) => setTimeout(resolve, 0));
226
- const controller = new AbortController();
227
- const pending = handle.waitForExit(controller.signal);
228
- controller.abort();
229
- assert.equal(await pending, false);
230
- liveProvider.dispose();
231
- const exited = spawnGuest();
232
- const exitedProvider = createSubprocessProvider(exited.resolver);
233
- const exitedHandle = exitedProvider.spawn(spawnSpec());
234
- assert.equal(await exitedHandle.waitForExit(), true);
235
- });
236
- test("subprocess provider forwards env tombstones and spills", async () => {
237
- const fake = spawnGuest({ exit: { stdoutSpillValid: true } });
238
- const provider = createSubprocessProvider(fake.resolver);
239
- const handle = provider.spawn(spawnSpec({
240
- env: { KEEP: "1", DROP: undefined },
241
- stdio: {
242
- stdin: "ignore",
243
- stdout: { maxBytes: 4, spill: { maxBytes: 64 } },
244
- stderr: { maxBytes: 4 },
245
- },
246
- }));
247
- await handle.done;
248
- const start = fake.starts[0].start;
249
- assert.deepEqual(start.env, { KEEP: "1" });
250
- assert.deepEqual(start.unsetEnv, ["DROP"]);
251
- assert.equal(start.spillStdout.maxBytes, 64);
252
- assert.match(start.spillStdout.path, /^\/tmp\/dsh-podman\/.+\.stdout$/);
253
- assert.equal(start.spillStderr, undefined);
254
- // No output was emitted, so the in-memory tail covered everything and the
255
- // unneeded spill is discarded.
256
- assert.equal(fake.deletes.length, 1);
257
- assert.equal(fake.deletes[0].path, start.spillStdout.path);
258
- });
259
- test("subprocess provider keeps a spill that holds dropped output", async () => {
260
- const fake = spawnGuest({
261
- exit: { stdoutSpillValid: true },
262
- stdout: "0123456789",
263
- });
264
- const provider = createSubprocessProvider(fake.resolver);
265
- const handle = provider.spawn(spawnSpec({
266
- stdio: {
267
- stdin: "ignore",
268
- stdout: { maxBytes: 4, spill: { maxBytes: 64 } },
269
- stderr: { maxBytes: 4 },
270
- },
271
- }));
272
- await handle.done;
273
- assert.equal(fake.deletes.length, 0);
274
- const read = handle.collected.stdout.readFrom(0);
275
- assert.equal(read.lossy, true);
276
- assert.equal(read.spillPath, fake.starts[0].start.spillStdout.path);
277
- });
278
- test("subprocess provider tears down a failed exec stream", async () => {
279
- const fake = spawnGuest({ emitExit: false });
280
- const provider = createSubprocessProvider(fake.resolver);
281
- const handle = provider.spawn(spawnSpec({
282
- stdio: {
283
- stdin: "ignore",
284
- stdout: "pipe",
285
- stderr: { maxBytes: 4, spill: { maxBytes: 64 } },
286
- },
287
- }));
288
- await new Promise((resolve) => setImmediate(resolve));
289
- const failed = assert.rejects(handle.done, /guest vanished/);
290
- // A paused PassThrough only emits "end" once a consumer reads it to EOF.
291
- handle.stdout.resume();
292
- const outputEnded = new Promise((resolve) => handle.stdout.on("end", () => resolve()));
293
- fake.streams[0].emit("error", new Error("guest vanished"));
294
- await outputEnded;
295
- await failed;
296
- assert.ok(fake.signals.some((signal) => signal.signal === "SIGTERM"), "the process is asked to stop when its stream fails");
297
- const spill = fake.starts[0].start.spillStderr.path;
298
- assert.ok(fake.deletes.some((request) => request.path === spill), "the spill is deleted on the failure path");
299
- });
300
- test("subprocess provider rejects a stream that ends without an exit", async () => {
301
- const fake = spawnGuest({ emitExit: false });
302
- const provider = createSubprocessProvider(fake.resolver);
303
- const handle = provider.spawn(spawnSpec());
304
- await new Promise((resolve) => setImmediate(resolve));
305
- const failed = assert.rejects(handle.done, /ended before the process exited/);
306
- fake.streams[0].emit("end");
307
- await failed;
308
- assert.ok(fake.signals.some((signal) => signal.signal === "SIGTERM"), "a lost stream still asks the process to stop");
309
- });
310
- test("subprocess provider pauses a piped stream while the consumer is behind", async () => {
311
- const chunk = "x".repeat(64 * 1024);
312
- const fake = spawnGuest({ emitExit: false, stdout: chunk });
313
- const provider = createSubprocessProvider(fake.resolver);
314
- const handle = provider.spawn(spawnSpec({ stdio: { stdin: "ignore", stdout: "pipe", stderr: "pipe" } }));
315
- await new Promise((resolve) => setImmediate(resolve));
316
- const stream = fake.streams[0];
317
- assert.ok(stream.paused > 0, "a full PassThrough pauses the guest stream");
318
- const chunks = [];
319
- await new Promise((resolve) => handle.stdout.on("data", (data) => {
320
- chunks.push(Buffer.from(data));
321
- if (Buffer.concat(chunks).length >= chunk.length)
322
- resolve();
323
- }));
324
- await new Promise((resolve) => setImmediate(resolve));
325
- assert.ok(stream.resumed > 0, "draining the consumer resumes the stream");
326
- const exited = handle.done;
327
- stream.emitData({ exit: { exitCode: 0, signaled: false } });
328
- assert.deepEqual(await exited, { exitCode: 0, signal: null });
329
- });
330
- test("subprocess provider disposes a live terminal", async () => {
331
- const fake = new FakeTerminalCall();
332
- const provider = createSubprocessProvider(fakeTerminalResolver(fake));
333
- const handle = await provider.spawnTerminal({
334
- argv: ["bash"],
335
- cwd: "/projects/team",
336
- rows: 24,
337
- cols: 80,
338
- graceMs: 1000,
339
- });
340
- assert.equal(handle.pid, 42);
341
- provider.dispose();
342
- assert.equal(fake.closed, true, "disposal closes the terminal");
343
- assert.equal(fake.ended, true, "disposal ends the terminal stream");
344
- });
@@ -1 +0,0 @@
1
- export {};