@agentshouse/kit 0.2.1-cbabe8ad337ff → 0.2.1-cc6246211e00c

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 (130) hide show
  1. package/README.md +42 -41
  2. package/dist/acp.js +38 -17
  3. package/dist/agents.js +111 -24
  4. package/dist/api.js +7 -3
  5. package/dist/app-git.js +10 -26
  6. package/dist/authority-main.js +2 -2
  7. package/dist/bridge.js +11 -25
  8. package/dist/building.js +46 -0
  9. package/dist/calls.js +63 -0
  10. package/dist/chatgpt.js +32 -0
  11. package/dist/clis-main.js +2 -2
  12. package/dist/clis.js +87 -22
  13. package/dist/connection.js +126 -0
  14. package/dist/conversations.js +410 -156
  15. package/dist/copies.js +185 -123
  16. package/dist/end.js +23 -4
  17. package/dist/enrol-main.js +7 -1
  18. package/dist/events.js +6 -2
  19. package/dist/files.js +139 -31
  20. package/dist/git.js +13 -11
  21. package/dist/home.js +96 -7
  22. package/dist/house-cli.js +299 -0
  23. package/dist/house-main.js +7 -177
  24. package/dist/instructions.js +8 -10
  25. package/dist/kit-cli.js +68 -0
  26. package/dist/kit-main.js +8 -22
  27. package/dist/login.js +111 -23
  28. package/dist/logout.js +0 -2
  29. package/dist/mcp.js +4 -2
  30. package/dist/parts.js +34 -16
  31. package/dist/placement.js +39 -0
  32. package/dist/relay.js +33 -2
  33. package/dist/resident.js +106 -44
  34. package/dist/scope.js +3 -0
  35. package/dist/service-main.js +9 -0
  36. package/dist/service.js +55 -0
  37. package/dist/sign-in.js +22 -39
  38. package/dist/skills.js +49 -35
  39. package/dist/transcription.js +85 -45
  40. package/dist/translate.js +2 -8
  41. package/dist/update.js +98 -53
  42. package/dist/web-wizard.js +101 -0
  43. package/dist/wire.js +22 -0
  44. package/dist/work.js +3 -5
  45. package/package.json +20 -20
  46. package/dist/bootstrap.json +0 -24
  47. package/dist/stream.js +0 -72
  48. package/how-we-work.md +0 -23
  49. package/skills/ask-matt/LICENSE +0 -21
  50. package/skills/ask-matt/PHASE-BOUNDARIES.md +0 -55
  51. package/skills/ask-matt/SKILL.md +0 -91
  52. package/skills/ask-matt/agents/openai.yaml +0 -4
  53. package/skills/code-review/LICENSE +0 -21
  54. package/skills/code-review/SKILL.md +0 -89
  55. package/skills/code-review/agents/openai.yaml +0 -3
  56. package/skills/codebase-design/DEEPENING.md +0 -37
  57. package/skills/codebase-design/DESIGN-IT-TWICE.md +0 -44
  58. package/skills/codebase-design/LICENSE +0 -21
  59. package/skills/codebase-design/SKILL.md +0 -116
  60. package/skills/codebase-design/agents/openai.yaml +0 -3
  61. package/skills/diagnosing-bugs/LICENSE +0 -21
  62. package/skills/diagnosing-bugs/SKILL.md +0 -140
  63. package/skills/diagnosing-bugs/agents/openai.yaml +0 -3
  64. package/skills/diagnosing-bugs/scripts/hitl-loop.template.sh +0 -44
  65. package/skills/domain-modeling/ADR-FORMAT.md +0 -47
  66. package/skills/domain-modeling/CONTEXT-FORMAT.md +0 -60
  67. package/skills/domain-modeling/LICENSE +0 -21
  68. package/skills/domain-modeling/SKILL.md +0 -76
  69. package/skills/domain-modeling/agents/openai.yaml +0 -3
  70. package/skills/grill-me/LICENSE +0 -21
  71. package/skills/grill-me/SKILL.md +0 -8
  72. package/skills/grill-me/agents/openai.yaml +0 -4
  73. package/skills/grill-with-docs/LICENSE +0 -21
  74. package/skills/grill-with-docs/SKILL.md +0 -8
  75. package/skills/grill-with-docs/agents/openai.yaml +0 -4
  76. package/skills/grilling/LICENSE +0 -21
  77. package/skills/grilling/SKILL.md +0 -30
  78. package/skills/grilling/agents/openai.yaml +0 -3
  79. package/skills/handoff/LICENSE +0 -21
  80. package/skills/handoff/SKILL.md +0 -17
  81. package/skills/handoff/agents/openai.yaml +0 -4
  82. package/skills/implement/LICENSE +0 -21
  83. package/skills/implement/SKILL.md +0 -16
  84. package/skills/implement/agents/openai.yaml +0 -4
  85. package/skills/improve-codebase-architecture/HTML-REPORT.md +0 -123
  86. package/skills/improve-codebase-architecture/LICENSE +0 -21
  87. package/skills/improve-codebase-architecture/SKILL.md +0 -72
  88. package/skills/improve-codebase-architecture/agents/openai.yaml +0 -4
  89. package/skills/prototype/LICENSE +0 -21
  90. package/skills/prototype/LOGIC.md +0 -67
  91. package/skills/prototype/SKILL.md +0 -28
  92. package/skills/prototype/UI.md +0 -112
  93. package/skills/prototype/agents/openai.yaml +0 -3
  94. package/skills/research/LICENSE +0 -21
  95. package/skills/research/SKILL.md +0 -14
  96. package/skills/research/agents/openai.yaml +0 -3
  97. package/skills/resolving-merge-conflicts/LICENSE +0 -21
  98. package/skills/resolving-merge-conflicts/SKILL.md +0 -16
  99. package/skills/resolving-merge-conflicts/agents/openai.yaml +0 -3
  100. package/skills/tdd/LICENSE +0 -21
  101. package/skills/tdd/SKILL.md +0 -40
  102. package/skills/tdd/agents/openai.yaml +0 -3
  103. package/skills/tdd/mocking.md +0 -59
  104. package/skills/tdd/tests.md +0 -77
  105. package/skills/teach/GLOSSARY-FORMAT.md +0 -35
  106. package/skills/teach/LEARNING-RECORD-FORMAT.md +0 -46
  107. package/skills/teach/LICENSE +0 -21
  108. package/skills/teach/MISSION-FORMAT.md +0 -31
  109. package/skills/teach/RESOURCES-FORMAT.md +0 -32
  110. package/skills/teach/SKILL.md +0 -141
  111. package/skills/teach/agents/openai.yaml +0 -4
  112. package/skills/to-questionnaire/LICENSE +0 -21
  113. package/skills/to-questionnaire/SKILL.md +0 -55
  114. package/skills/to-questionnaire/agents/openai.yaml +0 -4
  115. package/skills/to-spec/LICENSE +0 -21
  116. package/skills/to-spec/SKILL.md +0 -76
  117. package/skills/to-spec/agents/openai.yaml +0 -4
  118. package/skills/to-tickets/LICENSE +0 -21
  119. package/skills/to-tickets/SKILL.md +0 -106
  120. package/skills/to-tickets/agents/openai.yaml +0 -4
  121. package/skills/wait-what/LICENSE +0 -21
  122. package/skills/wait-what/SKILL.md +0 -8
  123. package/skills/wait-what/agents/openai.yaml +0 -4
  124. package/skills/wayfinder/LICENSE +0 -21
  125. package/skills/wayfinder/SKILL.md +0 -129
  126. package/skills/wayfinder/agents/openai.yaml +0 -4
  127. package/skills/writing-for-agents/LICENSE +0 -21
  128. package/skills/writing-for-agents/SKILL-MECHANICS.md +0 -22
  129. package/skills/writing-for-agents/SKILL.md +0 -83
  130. package/skills/writing-for-agents/agents/openai.yaml +0 -3
@@ -1,33 +1,39 @@
1
- import { createHash } from 'node:crypto';
2
- import { createReadStream } from 'node:fs';
3
1
  import { chmod, mkdir, mkdtemp, readdir, readFile, rename, rm, stat } from 'node:fs/promises';
4
2
  import { availableParallelism, tmpdir } from 'node:os';
5
3
  import { basename, join } from 'node:path';
6
- import { pipeline } from 'node:stream/promises';
7
4
  import { unlessAborted } from './abort.js';
5
+ import { downloadServed } from './building.js';
8
6
  import { failureOf, run } from './clis.js';
7
+ import { downloaded, fetched } from './files.js';
9
8
  import { kitHome } from './home.js';
10
9
  const RELEASE = 'https://github.com/agentshouse/kit/releases/download/engine-2';
11
10
  export const MODEL = {
12
- url: 'https://huggingface.co/ggml-org/parakeet-GGUF/resolve/35156454d1a39de06863303dd209fd2bed6ee079/ggml-parakeet-tdt-0.6b-v3-q4_k.bin',
11
+ name: 'ggml-parakeet-tdt-0.6b-v3-q4_k.bin',
12
+ from: 'https://huggingface.co/ggml-org/parakeet-GGUF/resolve/35156454d1a39de06863303dd209fd2bed6ee079/ggml-parakeet-tdt-0.6b-v3-q4_k.bin',
13
13
  sha256: '8b205b8b39c6535e153de6fb11c51db46125d45c4f16ba496fe41a0fe71b885e',
14
+ bytes: 415_611_879,
14
15
  executable: false,
15
16
  };
16
17
  export const ENGINES = {
17
18
  'linux-x64': {
18
- decoder: { url: `${RELEASE}/ffmpeg-linux-x86_64`, sha256: '1f8235d206428305afb89c6e8ab99d100425a0ba61e22bb4c7aff017db8c8de5', executable: true },
19
- engine: { url: `${RELEASE}/parakeet-cli-linux-x86_64`, sha256: 'bb2585695992fe1927a33960002cdf51b8a90a96ad65593c3d0a9f1fbc0865c2', executable: true },
19
+ decoder: { name: 'ffmpeg-linux-x86_64', from: `${RELEASE}/ffmpeg-linux-x86_64`, sha256: '1f8235d206428305afb89c6e8ab99d100425a0ba61e22bb4c7aff017db8c8de5', bytes: 5_175_832, executable: true },
20
+ engine: { name: 'parakeet-cli-linux-x86_64', from: `${RELEASE}/parakeet-cli-linux-x86_64`, sha256: 'bb2585695992fe1927a33960002cdf51b8a90a96ad65593c3d0a9f1fbc0865c2', bytes: 3_801_616, executable: true },
20
21
  },
21
22
  'linux-arm64': {
22
- decoder: { url: `${RELEASE}/ffmpeg-linux-aarch64`, sha256: 'a7e08a0fae0179d1078312f6bb13d2a9aa4d4c71a1d82a022953f25dee452f5e', executable: true },
23
- engine: { url: `${RELEASE}/parakeet-cli-linux-aarch64`, sha256: 'cbc0bedc8daae97f1ef9dcee4200c06226218e300e0fd62ead1306d22742b7ed', executable: true },
23
+ decoder: { name: 'ffmpeg-linux-aarch64', from: `${RELEASE}/ffmpeg-linux-aarch64`, sha256: 'a7e08a0fae0179d1078312f6bb13d2a9aa4d4c71a1d82a022953f25dee452f5e', bytes: 4_590_208, executable: true },
24
+ engine: { name: 'parakeet-cli-linux-aarch64', from: `${RELEASE}/parakeet-cli-linux-aarch64`, sha256: 'cbc0bedc8daae97f1ef9dcee4200c06226218e300e0fd62ead1306d22742b7ed', bytes: 3_477_624, executable: true },
24
25
  },
25
26
  'darwin-arm64': {
26
- decoder: { url: `${RELEASE}/ffmpeg-darwin-arm64`, sha256: '7abe154aaed3d6b49f5167ca7221bb66bed51388925d99a7e4261a41fe52fba6', executable: true },
27
- engine: { url: `${RELEASE}/parakeet-cli-darwin-arm64`, sha256: '9a2aafc0922ad7c0b6db6eff1641e96572ba32ac40bf995a1df242ed2febf297', executable: true },
27
+ decoder: { name: 'ffmpeg-darwin-arm64', from: `${RELEASE}/ffmpeg-darwin-arm64`, sha256: '7abe154aaed3d6b49f5167ca7221bb66bed51388925d99a7e4261a41fe52fba6', bytes: 3_696_768, executable: true },
28
+ engine: { name: 'parakeet-cli-darwin-arm64', from: `${RELEASE}/parakeet-cli-darwin-arm64`, sha256: '9a2aafc0922ad7c0b6db6eff1641e96572ba32ac40bf995a1df242ed2febf297', bytes: 1_939_728, executable: true },
28
29
  },
29
30
  };
30
31
  const CHUNK_SECONDS = 20;
32
+ const OFF = "transcription is off on the Agent's Environment, so this message's audio has no text; turn it on or write instead";
33
+ const NOT_INSTALLED = "the speech engine is not installed on the Agent's Environment, so this message's audio has no text";
34
+ const NOT_DOWNLOADED = 'an audio file this message links could not be downloaded; send the message again';
35
+ const UNDECODABLE = 'an audio file this message links could not be decoded';
36
+ const UNTRANSCRIBED = 'an audio file this message links could not be transcribed';
31
37
  let held = Promise.resolve();
32
38
  let holding = Promise.resolve();
33
39
  let setting = null;
@@ -40,7 +46,7 @@ function installed(artifact) {
40
46
  return join(directory(), artifact.sha256);
41
47
  }
42
48
  async function executed(command, args, signal) {
43
- // A download or a transcription runs as long as its size needs; the setting turning off or the turn's interrupt or end aborts it instead.
49
+ // A decode or a transcription runs as long as its audio needs; the setting turning off or the turn's interrupt or end aborts it instead.
44
50
  const ran = await run(command, args, 0, false, signal);
45
51
  if (ran.status !== 0)
46
52
  throw new Error(failureOf(ran, basename(command)));
@@ -49,22 +55,50 @@ async function executed(command, args, signal) {
49
55
  function present(path) {
50
56
  return stat(path).then(() => true, () => false);
51
57
  }
52
- async function cpus() {
58
+ async function threads() {
53
59
  const [quota, period] = (await readFile('/sys/fs/cgroup/cpu.max', 'utf8').catch(() => 'max')).split(' ');
54
60
  const allowed = quota === 'max' ? Infinity : Math.ceil(Number(quota) / Number(period));
55
- return Math.min(availableParallelism(), allowed);
56
- }
57
- async function sha256(path) {
58
- const hash = createHash('sha256');
59
- await pipeline(createReadStream(path), hash);
60
- return hash.digest('hex');
61
+ return Math.max(1, Math.floor(Math.min(availableParallelism(), allowed) / 2));
61
62
  }
62
63
  function causeOf(error) {
63
64
  return error instanceof Error ? error.message : String(error);
64
65
  }
66
+ async function failing(reason, work) {
67
+ try {
68
+ return await work;
69
+ }
70
+ catch (error) {
71
+ throw new Error(reason, { cause: error });
72
+ }
73
+ }
74
+ function ready() {
75
+ if (setting !== true)
76
+ throw new Error(OFF);
77
+ if (!readiness.installed)
78
+ throw new Error(NOT_INSTALLED);
79
+ }
65
80
  function pinnedHere() {
66
81
  return ENGINES[`${process.platform}-${process.arch}`];
67
82
  }
83
+ const DOWNLOADS = 3;
84
+ async function downloadedAgain(artifact, signal) {
85
+ // An artifact arrives at a hundred kilobytes a second or its download ends, so a stalled Building cannot hold the install open.
86
+ const deadlineMs = Math.ceil(artifact.bytes / 100);
87
+ const deadline = AbortSignal.timeout(deadlineMs);
88
+ for (let attempt = 1;; attempt++) {
89
+ try {
90
+ return await downloadServed(artifact.name, artifact.sha256, `${installed(artifact)}.part`, AbortSignal.any([signal, deadline]), artifact.bytes);
91
+ }
92
+ catch (error) {
93
+ if (signal.aborted)
94
+ throw error;
95
+ if (deadline.aborted)
96
+ throw new Error(`${artifact.name} did not arrive within ${Math.ceil(deadlineMs / 1000)} seconds`);
97
+ if (attempt === DOWNLOADS)
98
+ throw error;
99
+ }
100
+ }
101
+ }
68
102
  async function install(artifacts, signal) {
69
103
  await mkdir(directory(), { recursive: true });
70
104
  const pinned = new Set(artifacts.map((artifact) => artifact.sha256));
@@ -77,13 +111,8 @@ async function install(artifacts, signal) {
77
111
  if (!(await present(installed(artifact))))
78
112
  missing.push(artifact);
79
113
  try {
80
- for (const artifact of missing) {
81
- const part = `${installed(artifact)}.part`;
82
- // Three retries carry a large download past a dropped connection before the download fails.
83
- await executed('curl', ['-fsSL', '--retry', '3', '-o', part, artifact.url], signal);
84
- if ((await sha256(part)) !== artifact.sha256)
85
- throw new Error(`${artifact.url} does not match its sha256`);
86
- }
114
+ for (const artifact of missing)
115
+ await downloadedAgain(artifact, signal);
87
116
  for (const artifact of missing) {
88
117
  if (artifact.executable)
89
118
  await chmod(`${installed(artifact)}.part`, 0o755);
@@ -133,27 +162,23 @@ export function holdTranscription(transcribe) {
133
162
  export function transcriptionReport() {
134
163
  return readiness;
135
164
  }
136
- async function transcribed(path, signal) {
165
+ async function transcribed(audio, parts, signal) {
137
166
  const pinned = pinnedHere();
138
- const work = await mkdtemp(join(tmpdir(), 'kit-transcription-'));
139
- try {
140
- await executed(installed(pinned.decoder), ['-nostdin', '-hide_banner', '-loglevel', 'error', '-i', path, '-ar', '16000', '-ac', '1', '-c:a', 'pcm_s16le',
141
- '-f', 'segment', '-segment_time', String(CHUNK_SECONDS), join(work, '%05d.wav')], signal);
142
- const parts = (await readdir(work)).sort().flatMap((part) => ['-f', join(work, part)]);
143
- const text = await executed(installed(pinned.engine), ['-t', String(await cpus()), '-np', '-m', installed(MODEL), ...parts], signal);
144
- return text
145
- .split('\n')
146
- .map((line) => line.trim())
147
- .filter((line) => line !== '')
148
- .join(' ');
149
- }
150
- finally {
151
- await rm(work, { recursive: true, force: true });
152
- }
167
+ await mkdir(parts);
168
+ await failing(UNDECODABLE, executed(installed(pinned.decoder), ['-nostdin', '-hide_banner', '-loglevel', 'error', '-i', audio, '-ar', '16000', '-ac', '1', '-c:a', 'pcm_s16le',
169
+ '-f', 'segment', '-segment_time', String(CHUNK_SECONDS), join(parts, '%05d.wav')], signal));
170
+ const segments = (await readdir(parts)).sort().flatMap((part) => ['-f', join(parts, part)]);
171
+ const said = await failing(UNTRANSCRIBED, executed(installed(pinned.engine), ['-t', String(await threads()), '-np', '-m', installed(MODEL), ...segments], signal));
172
+ const text = said
173
+ .split('\n')
174
+ .map((line) => line.trim())
175
+ .filter((line) => line !== '')
176
+ .join(' ');
177
+ if (text === '')
178
+ throw new Error(UNTRANSCRIBED);
179
+ return text;
153
180
  }
154
- export async function transcribe(path, signal) {
155
- if (!readiness.installed)
156
- return null;
181
+ async function alone(work, signal) {
157
182
  const before = held;
158
183
  let release;
159
184
  const mine = new Promise((resolve) => {
@@ -162,9 +187,24 @@ export async function transcribe(path, signal) {
162
187
  held = Promise.all([before, mine]);
163
188
  try {
164
189
  await unlessAborted(before, signal);
165
- return readiness.installed ? await transcribed(path, signal) : null;
190
+ return await work();
166
191
  }
167
192
  finally {
168
193
  release();
169
194
  }
170
195
  }
196
+ export async function transcribe(address, signal) {
197
+ ready();
198
+ const work = await mkdtemp(join(tmpdir(), 'kit-transcription-'));
199
+ try {
200
+ const audio = join(work, 'audio');
201
+ await failing(NOT_DOWNLOADED, downloaded(address, (url) => fetched(url, signal), audio, 'audio'));
202
+ return await alone(() => {
203
+ ready();
204
+ return transcribed(audio, join(work, 'parts'), signal);
205
+ }, signal);
206
+ }
207
+ finally {
208
+ await rm(work, { recursive: true, force: true });
209
+ }
210
+ }
package/dist/translate.js CHANGED
@@ -3,14 +3,8 @@ function same(left, right) {
3
3
  return JSON.stringify(left) === JSON.stringify(right);
4
4
  }
5
5
  function applied(document, changes) {
6
- let current = document;
7
- for (const change of changes) {
8
- const result = apply(current, change);
9
- if (result.outcome !== 'applied')
10
- return null;
11
- current = result.document;
12
- }
13
- return serialize(current);
6
+ const result = apply(document, changes);
7
+ return result.outcome === 'applied' ? serialize(result.document) : null;
14
8
  }
15
9
  function components(path, before, after, text) {
16
10
  const edits = [];
package/dist/update.js CHANGED
@@ -4,11 +4,12 @@ import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
4
4
  import { homedir } from 'node:os';
5
5
  import { join } from 'node:path';
6
6
  import { run } from './clis.js';
7
- import { kitHome } from './home.js';
8
- const RECORD = 'outcome=$1; shift; bash "$0" --linux "$@"; printf %s "$?" > "$outcome"; systemctl start house-kit.service';
9
- function logged(error) {
10
- process.stderr.write(`kit: ${error instanceof Error ? error.message : String(error)}\n`);
11
- }
7
+ import { kitHome, workspaceRoot } from './home.js';
8
+ import { service, throughSudo } from './placement.js';
9
+ import { relayed } from './relay.js';
10
+ const BOOTSTRAP_BYTES = 1_000_000;
11
+ // A bootstrap is at most a million bytes, so two minutes carry it over ten kilobytes a second and no stalled host holds the update queue.
12
+ const BOOTSTRAP_MS = 120_000;
12
13
  function directory() {
13
14
  return join(kitHome(), 'update');
14
15
  }
@@ -18,10 +19,25 @@ function pending() {
18
19
  function outcome() {
19
20
  return join(directory(), 'outcome');
20
21
  }
21
- function unit(inputId) {
22
- return `house-kit-update-${inputId}`;
22
+ function unit(callId) {
23
+ return `house-kit-update-${callId}`;
24
+ }
25
+ function manager() {
26
+ return service() === 'user' ? ['--user'] : [];
27
+ }
28
+ function elevated() {
29
+ return throughSudo() ? ['sudo', '-n'] : [];
30
+ }
31
+ function account() {
32
+ return throughSudo() ? [`--uid=${process.getuid()}`, `--gid=${process.getgid()}`] : [];
23
33
  }
24
- async function pendingInput() {
34
+ function placement() {
35
+ return service() === 'user' ? ['--workspace', workspaceRoot()] : ['--linux'];
36
+ }
37
+ function record() {
38
+ return `outcome=$1; shift; bash "$0" "$@"; printf %s "$?" > "$outcome"; ${[...elevated(), 'systemctl', ...manager(), 'start', 'house-kit.service'].join(' ')}`;
39
+ }
40
+ async function pendingCall() {
25
41
  try {
26
42
  return JSON.parse(await readFile(pending(), 'utf8')).input_id;
27
43
  }
@@ -35,85 +51,114 @@ async function recorded() {
35
51
  return null;
36
52
  return status.trim() === '0' ? {} : { refused: `the Kit bootstrap exited with ${status.trim()}` };
37
53
  }
38
- async function finished(inputId) {
54
+ async function forget(callId) {
55
+ if ((await pendingCall()) !== callId)
56
+ return;
57
+ await rm(pending(), { force: true });
58
+ await rm(outcome(), { force: true });
59
+ }
60
+ async function finished(callId) {
39
61
  for (;;) {
40
- const ack = await recorded();
41
- if (ack !== null)
42
- return ack;
62
+ const result = await recorded();
63
+ if (result !== null)
64
+ return result;
43
65
  // systemctl answers at once, so ten seconds only bounds a stuck service manager.
44
- if ((await run('systemctl', ['is-active', '--quiet', unit(inputId)], 10_000)).status !== 0) {
66
+ if ((await run('systemctl', [...manager(), 'is-active', '--quiet', unit(callId)], 10_000)).status !== 0) {
45
67
  return (await recorded()) ?? { refused: 'the Kit bootstrap did not finish' };
46
68
  }
47
69
  // The bootstrap runs for minutes, so checking each second sees its outcome within a second at little cost.
48
70
  await new Promise((resolve) => setTimeout(resolve, 1000));
49
71
  }
50
72
  }
51
- function rerun(script, inputId, flags) {
73
+ async function bounded(body, most) {
74
+ const chunks = [];
75
+ let bytes = 0;
76
+ for await (const chunk of body ?? []) {
77
+ bytes += chunk.length;
78
+ if (bytes > most)
79
+ return null;
80
+ chunks.push(chunk);
81
+ }
82
+ return Buffer.concat(chunks, bytes);
83
+ }
84
+ function rerun(script, callId, flags) {
52
85
  return new Promise((resolve) => {
53
- const child = spawn('systemd-run', [
86
+ const [command, ...args] = [
87
+ ...elevated(),
88
+ 'systemd-run',
89
+ ...manager(),
90
+ ...account(),
54
91
  '--wait',
55
92
  '--collect',
56
93
  '--quiet',
57
- `--unit=${unit(inputId)}`,
94
+ `--unit=${unit(callId)}`,
58
95
  `--setenv=HOME=${homedir()}`,
96
+ `--setenv=HOUSE_KIT_HOME=${kitHome()}`,
59
97
  '/bin/sh',
60
98
  '-c',
61
- RECORD,
99
+ record(),
62
100
  script,
63
101
  outcome(),
102
+ ...placement(),
64
103
  ...flags,
65
- ], { stdio: ['ignore', 'ignore', 'inherit'] });
66
- child.on('error', () => resolve({ refused: 'no service manager runs this Kit' }));
104
+ ];
105
+ const child = spawn(command, args, { stdio: ['ignore', 'ignore', 'inherit'] });
106
+ child.on('error', () => resolve({ refused: 'no service manager runs this Kit process' }));
67
107
  child.on('close', () => resolve(null));
68
108
  });
69
109
  }
70
- export class Updates {
71
- house;
72
- held = new Set();
110
+ export class KitUpdate {
111
+ calls;
73
112
  queue = Promise.resolve();
74
- constructor(house) {
75
- this.house = house;
113
+ constructor(calls) {
114
+ this.calls = calls;
76
115
  }
77
116
  async resumed() {
78
- const inputId = await pendingInput();
79
- if (inputId === null)
117
+ const callId = await pendingCall();
118
+ if (callId === null)
80
119
  return;
81
- await this.acknowledge(inputId, await finished(inputId));
120
+ await this.enqueue(callId, () => finished(callId));
82
121
  }
83
- start(input) {
84
- if (this.held.has(input.input_id))
85
- return;
86
- this.held.add(input.input_id);
87
- this.queue = this.queue
88
- .then(() => this.carry(input))
89
- .then((ack) => this.acknowledge(input.input_id, ack))
90
- .catch(logged)
91
- .finally(() => this.held.delete(input.input_id));
122
+ start(call) {
123
+ void this.enqueue(call.input_id, () => this.carry(call));
92
124
  }
93
- async carry(input) {
94
- if ((await pendingInput()) === input.input_id)
95
- return finished(input.input_id);
96
- const answer = await fetch(input.bootstrap);
97
- if (!answer.ok)
98
- return { refused: `the Kit bootstrap could not be downloaded: ${answer.status}` };
99
- const script = Buffer.from(await answer.arrayBuffer());
100
- if (createHash('sha256').update(script).digest('hex') !== input.sha256) {
125
+ enqueue(callId, work) {
126
+ const before = this.queue;
127
+ const carried = this.calls.carry(callId, async () => {
128
+ await before;
129
+ return { result: await work(), returned: () => forget(callId) };
130
+ });
131
+ this.queue = before.then(() => carried);
132
+ return carried;
133
+ }
134
+ async carry(call) {
135
+ if ((await pendingCall()) === call.input_id)
136
+ return finished(call.input_id);
137
+ const deadline = AbortSignal.timeout(BOOTSTRAP_MS);
138
+ let script;
139
+ try {
140
+ const answer = await fetch(relayed(call.bootstrap), { signal: deadline });
141
+ if (!answer.ok)
142
+ return { refused: `the Kit bootstrap could not be downloaded: ${answer.status}` };
143
+ script = await bounded(answer.body, BOOTSTRAP_BYTES);
144
+ }
145
+ catch (error) {
146
+ if (!deadline.aborted)
147
+ throw error;
148
+ return { refused: `the Kit bootstrap did not arrive within ${BOOTSTRAP_MS / 1000} seconds` };
149
+ }
150
+ if (script === null)
151
+ return { refused: `the Kit bootstrap is larger than ${BOOTSTRAP_BYTES} bytes` };
152
+ if (createHash('sha256').update(script).digest('hex') !== call.sha256) {
101
153
  return { refused: 'the Kit bootstrap does not match its sha256' };
102
154
  }
103
155
  await mkdir(directory(), { recursive: true, mode: 0o700 });
104
156
  const path = join(directory(), 'connect-linux.sh');
105
157
  await writeFile(path, script, { mode: 0o700 });
106
158
  await rm(outcome(), { force: true });
107
- await writeFile(pending(), `${JSON.stringify({ input_id: input.input_id })}\n`, { mode: 0o600 });
108
- return (await rerun(path, input.input_id, input.update_clis ? ['--update-clis'] : [])) ?? (await recorded()) ?? {
159
+ await writeFile(pending(), `${JSON.stringify({ input_id: call.input_id })}\n`, { mode: 0o600 });
160
+ return (await rerun(path, call.input_id, call.update_clis ? ['--update-clis'] : [])) ?? (await recorded()) ?? {
109
161
  refused: 'the Kit bootstrap did not finish',
110
162
  };
111
163
  }
112
- async acknowledge(inputId, ack) {
113
- await this.house.deliver(`/kit/inputs/${inputId}/ack`, ack);
114
- if ((await pendingInput()) !== inputId)
115
- return;
116
- await rm(pending(), { force: true });
117
- await rm(outcome(), { force: true });
118
- }
119
164
  }
@@ -0,0 +1,101 @@
1
+ import { loginPath, onLoginPath } from './clis.js';
2
+ import { childEnvironment } from './relay.js';
3
+ import { killTree } from './scope.js';
4
+ const TERMINAL = 'xterm-256color';
5
+ const SIGNALLED = 128;
6
+ const NO_BASH = "bash is not on the login shell's PATH";
7
+ const LOST = { refused: 'the Kit lost its connection to House' };
8
+ function causeOf(error) {
9
+ return error instanceof Error ? error.message : String(error);
10
+ }
11
+ function failed(cause) {
12
+ process.stderr.write(`kit: a Web Wizard could not start: ${cause}\n`);
13
+ return { refused: `the script could not start: ${cause}` };
14
+ }
15
+ export class WebWizards {
16
+ calls;
17
+ send;
18
+ runs = new Map();
19
+ constructor(calls, send) {
20
+ this.calls = calls;
21
+ this.send = send;
22
+ }
23
+ start(call) {
24
+ void this.calls.carry(call.input_id, () => this.run(call));
25
+ }
26
+ notified(notification) {
27
+ const run = this.runs.get(String(notification.wizard));
28
+ if (run === undefined)
29
+ return;
30
+ if (notification.type === 'wizard_input')
31
+ this.typed(run, String(notification.data));
32
+ if (notification.type === 'wizard_size')
33
+ this.resized(run, { cols: Number(notification.cols), rows: Number(notification.rows) });
34
+ if (notification.type === 'wizard_end')
35
+ this.end(run, {});
36
+ }
37
+ disconnected() {
38
+ for (const run of this.runs.values())
39
+ this.end(run, LOST);
40
+ }
41
+ async run(call) {
42
+ const run = { terminal: null, size: null, typed: [], ended: null, sized: Promise.withResolvers() };
43
+ this.runs.set(call.input_id, run);
44
+ try {
45
+ return { result: await this.ran(call.input_id, call.script, run) };
46
+ }
47
+ finally {
48
+ this.runs.delete(call.input_id);
49
+ }
50
+ }
51
+ async ran(wizard, script, run) {
52
+ let terminal;
53
+ try {
54
+ const { spawn } = await import('@lydell/node-pty');
55
+ const shell = await onLoginPath('bash');
56
+ if (shell === null)
57
+ return failed(NO_BASH);
58
+ const path = await loginPath();
59
+ await run.sized.promise;
60
+ if (run.ended !== null)
61
+ return run.ended;
62
+ terminal = spawn(shell, ['-c', script], {
63
+ name: TERMINAL,
64
+ ...run.size,
65
+ cwd: process.cwd(),
66
+ env: { ...childEnvironment(), PATH: path },
67
+ });
68
+ }
69
+ catch (error) {
70
+ return failed(causeOf(error));
71
+ }
72
+ run.terminal = terminal;
73
+ terminal.onData((data) => this.send({ type: 'wizard_output', wizard, data }));
74
+ for (const data of run.typed.splice(0))
75
+ terminal.write(data);
76
+ const exited = await new Promise((resolve) => terminal.onExit(resolve));
77
+ return run.ended ?? { exit_code: exited.signal ? SIGNALLED + exited.signal : exited.exitCode };
78
+ }
79
+ typed(run, data) {
80
+ if (run.terminal === null)
81
+ run.typed.push(data);
82
+ else
83
+ run.terminal.write(data);
84
+ }
85
+ resized(run, size) {
86
+ run.size = size;
87
+ run.sized.resolve();
88
+ try {
89
+ run.terminal?.resize(size.cols, size.rows);
90
+ }
91
+ catch { }
92
+ }
93
+ end(run, result) {
94
+ if (run.ended !== null)
95
+ return;
96
+ run.ended = result;
97
+ run.sized.resolve();
98
+ if (run.terminal !== null)
99
+ killTree(run.terminal);
100
+ }
101
+ }
package/dist/wire.js ADDED
@@ -0,0 +1,22 @@
1
+ import { newerThanHouse, updateRequired } from './end.js';
2
+ import { machine } from './placement.js';
3
+ import { refusalOf } from './refusals.js';
4
+ export const KIT_WIRE = 3;
5
+ export const KIT_WIRE_HEADER = 'x-house-kit-wire';
6
+ function newer(text) {
7
+ let body;
8
+ try {
9
+ body = JSON.parse(text);
10
+ }
11
+ catch {
12
+ return null;
13
+ }
14
+ return body?.error?.code === 'kit_newer_than_house' ? body.error : null;
15
+ }
16
+ export function endUnserved(text) {
17
+ if (refusalOf(text)?.code === 'kit_update_required')
18
+ updateRequired();
19
+ const refused = newer(text);
20
+ if (refused !== null)
21
+ newerThanHouse(refused.release, refused.commands[machine()]);
22
+ }
package/dist/work.js CHANGED
@@ -1,11 +1,11 @@
1
1
  import { randomUUID } from 'node:crypto';
2
2
  import { once } from 'node:events';
3
3
  import { readFileSync } from 'node:fs';
4
- import { mkdir, rm } from 'node:fs/promises';
4
+ import { rm } from 'node:fs/promises';
5
5
  import { createServer } from 'node:net';
6
6
  import { join } from 'node:path';
7
7
  import { RUNNING_JOB } from './events.js';
8
- import { kitHome } from './home.js';
8
+ import { kitHome, socketDirectory } from './home.js';
9
9
  const ENDED_TASK = new Set(['completed', 'failed', 'killed']);
10
10
  const SCHEDULING = new Set(['CronCreate', 'CronDelete', 'ScheduleWakeup']);
11
11
  const QUEUE_LIST = 'house-kit-queue-';
@@ -194,9 +194,7 @@ class CodexWork extends Work {
194
194
  proving = -1;
195
195
  proven = -1;
196
196
  async open(cli) {
197
- const sockets = join(kitHome(), 'bridges');
198
- await mkdir(sockets, { recursive: true, mode: 0o700 });
199
- this.path = join(sockets, `${randomUUID()}.sock`);
197
+ this.path = join(socketDirectory(), `${randomUUID()}.sock`);
200
198
  this.server = createServer((socket) => this.connected(socket));
201
199
  this.server.listen(this.path);
202
200
  await once(this.server, 'listening');
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@agentshouse/kit",
3
- "version": "0.2.1-cbabe8ad337ff",
4
- "description": "House Kit connects an Environment to agents.house.",
3
+ "version": "0.2.1-cc6246211e00c",
4
+ "description": "Kit connects an Environment to agents.house.",
5
5
  "license": "MIT",
6
6
  "repository": {
7
7
  "type": "git",
@@ -12,27 +12,27 @@
12
12
  "kit": "dist/kit-main.js",
13
13
  "house": "dist/house-main.js"
14
14
  },
15
- "exports": {
16
- "./bootstrap": "./dist/bootstrap.json"
17
- },
18
15
  "files": [
19
- "dist",
20
- "how-we-work.md",
21
- "skills"
16
+ "dist"
22
17
  ],
23
18
  "scripts": {
24
- "build": "tsc -p tsconfig.build.json && node scripts/bootstrap-manifest.mjs",
19
+ "bootstrap-manifest": "node scripts/bootstrap-manifest.mjs",
20
+ "build": "tsc -p tsconfig.build.json",
25
21
  "engine": "mkdir -p tmp/engine && docker run --rm -v \"$PWD:/kit\" -w /kit alpine:3.24@sha256:294b683cb724975bec92580e1e685676bd4b50bda910ddb8c51d4cabeaec77e6 sh scripts/engine.sh tmp/engine",
22
+ "follow-skills": "node scripts/follow-skills.mjs",
23
+ "release-files": "node scripts/release-files.mjs",
26
24
  "test": "tsc -p tsconfig.json && vitest run"
27
25
  },
28
26
  "dependencies": {
29
- "@agentclientprotocol/sdk": "1.7.0",
30
- "@agentshouse/mdmodel": "0.1.0-alpha.19",
27
+ "@agentclientprotocol/sdk": "2.0.1",
28
+ "@agentshouse/mdmodel": "0.1.0-c4f4d37bc9d6a",
29
+ "@agentshouse/skills": "0.1.0-c08575ab21b57",
30
+ "@lydell/node-pty": "1.2.0-beta.15",
31
31
  "yaml": "2.9.1"
32
32
  },
33
33
  "peerDependencies": {
34
- "@agentclientprotocol/claude-agent-acp": "0.85.1",
35
- "@agentclientprotocol/codex-acp": "2.1.1"
34
+ "@agentclientprotocol/claude-agent-acp": "0.94.0",
35
+ "@agentclientprotocol/codex-acp": "2.2.2"
36
36
  },
37
37
  "peerDependenciesMeta": {
38
38
  "@agentclientprotocol/claude-agent-acp": {
@@ -43,26 +43,26 @@
43
43
  }
44
44
  },
45
45
  "devDependencies": {
46
- "@types/node": "24.13.6",
46
+ "@types/node": "24.19.2",
47
47
  "@types/ws": "8.18.2",
48
48
  "typescript": "7.0.2",
49
- "vitest": "5.0.1",
49
+ "vitest": "5.0.5",
50
50
  "ws": "8.22.0"
51
51
  },
52
- "packageManager": "npm@11.19.0",
52
+ "packageManager": "npm@11.19.1",
53
53
  "engines": {
54
- "node": "24.21.0",
55
- "npm": "11.19.0"
54
+ "node": "24.22.1",
55
+ "npm": "11.19.1"
56
56
  },
57
57
  "devEngines": {
58
58
  "runtime": {
59
59
  "name": "node",
60
- "version": "24.21.0",
60
+ "version": "24.22.1",
61
61
  "onFail": "error"
62
62
  },
63
63
  "packageManager": {
64
64
  "name": "npm",
65
- "version": "11.19.0",
65
+ "version": "11.19.1",
66
66
  "onFail": "error"
67
67
  }
68
68
  }