@agentshouse/kit 0.2.1-c14f8446ba284 → 0.2.1-c1873657edab7

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 (126) hide show
  1. package/README.md +42 -40
  2. package/dist/acp.js +36 -16
  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/bootstrap.json +4 -4
  7. package/dist/bridge.js +10 -24
  8. package/dist/calls.js +63 -0
  9. package/dist/chatgpt.js +32 -0
  10. package/dist/clis.js +52 -10
  11. package/dist/connection.js +125 -0
  12. package/dist/conversations.js +405 -155
  13. package/dist/copies.js +185 -123
  14. package/dist/end.js +23 -4
  15. package/dist/enrol-main.js +7 -1
  16. package/dist/events.js +6 -2
  17. package/dist/files.js +123 -31
  18. package/dist/git.js +11 -9
  19. package/dist/home.js +96 -7
  20. package/dist/house-cli.js +286 -0
  21. package/dist/house-main.js +7 -177
  22. package/dist/instructions.js +7 -9
  23. package/dist/kit-cli.js +68 -0
  24. package/dist/kit-main.js +8 -22
  25. package/dist/login.js +111 -23
  26. package/dist/logout.js +14 -16
  27. package/dist/mcp.js +4 -2
  28. package/dist/parts.js +34 -16
  29. package/dist/placement.js +39 -0
  30. package/dist/relay.js +12 -2
  31. package/dist/resident.js +99 -43
  32. package/dist/scope.js +3 -0
  33. package/dist/service-main.js +9 -0
  34. package/dist/service.js +55 -0
  35. package/dist/sign-in.js +19 -37
  36. package/dist/skills.js +20 -32
  37. package/dist/transcription.js +53 -22
  38. package/dist/translate.js +2 -8
  39. package/dist/update.js +69 -50
  40. package/dist/wire.js +22 -0
  41. package/dist/work.js +3 -5
  42. package/package.json +6 -6
  43. package/dist/stream.js +0 -72
  44. package/how-we-work.md +0 -23
  45. package/skills/ask-matt/LICENSE +0 -21
  46. package/skills/ask-matt/PHASE-BOUNDARIES.md +0 -55
  47. package/skills/ask-matt/SKILL.md +0 -91
  48. package/skills/ask-matt/agents/openai.yaml +0 -4
  49. package/skills/code-review/LICENSE +0 -21
  50. package/skills/code-review/SKILL.md +0 -89
  51. package/skills/code-review/agents/openai.yaml +0 -3
  52. package/skills/codebase-design/DEEPENING.md +0 -37
  53. package/skills/codebase-design/DESIGN-IT-TWICE.md +0 -44
  54. package/skills/codebase-design/LICENSE +0 -21
  55. package/skills/codebase-design/SKILL.md +0 -116
  56. package/skills/codebase-design/agents/openai.yaml +0 -3
  57. package/skills/diagnosing-bugs/LICENSE +0 -21
  58. package/skills/diagnosing-bugs/SKILL.md +0 -140
  59. package/skills/diagnosing-bugs/agents/openai.yaml +0 -3
  60. package/skills/diagnosing-bugs/scripts/hitl-loop.template.sh +0 -44
  61. package/skills/domain-modeling/ADR-FORMAT.md +0 -47
  62. package/skills/domain-modeling/CONTEXT-FORMAT.md +0 -60
  63. package/skills/domain-modeling/LICENSE +0 -21
  64. package/skills/domain-modeling/SKILL.md +0 -76
  65. package/skills/domain-modeling/agents/openai.yaml +0 -3
  66. package/skills/grill-me/LICENSE +0 -21
  67. package/skills/grill-me/SKILL.md +0 -8
  68. package/skills/grill-me/agents/openai.yaml +0 -4
  69. package/skills/grill-with-docs/LICENSE +0 -21
  70. package/skills/grill-with-docs/SKILL.md +0 -8
  71. package/skills/grill-with-docs/agents/openai.yaml +0 -4
  72. package/skills/grilling/LICENSE +0 -21
  73. package/skills/grilling/SKILL.md +0 -30
  74. package/skills/grilling/agents/openai.yaml +0 -3
  75. package/skills/handoff/LICENSE +0 -21
  76. package/skills/handoff/SKILL.md +0 -17
  77. package/skills/handoff/agents/openai.yaml +0 -4
  78. package/skills/implement/LICENSE +0 -21
  79. package/skills/implement/SKILL.md +0 -16
  80. package/skills/implement/agents/openai.yaml +0 -4
  81. package/skills/improve-codebase-architecture/HTML-REPORT.md +0 -123
  82. package/skills/improve-codebase-architecture/LICENSE +0 -21
  83. package/skills/improve-codebase-architecture/SKILL.md +0 -72
  84. package/skills/improve-codebase-architecture/agents/openai.yaml +0 -4
  85. package/skills/prototype/LICENSE +0 -21
  86. package/skills/prototype/LOGIC.md +0 -67
  87. package/skills/prototype/SKILL.md +0 -28
  88. package/skills/prototype/UI.md +0 -112
  89. package/skills/prototype/agents/openai.yaml +0 -3
  90. package/skills/research/LICENSE +0 -21
  91. package/skills/research/SKILL.md +0 -14
  92. package/skills/research/agents/openai.yaml +0 -3
  93. package/skills/resolving-merge-conflicts/LICENSE +0 -21
  94. package/skills/resolving-merge-conflicts/SKILL.md +0 -16
  95. package/skills/resolving-merge-conflicts/agents/openai.yaml +0 -3
  96. package/skills/tdd/LICENSE +0 -21
  97. package/skills/tdd/SKILL.md +0 -40
  98. package/skills/tdd/agents/openai.yaml +0 -3
  99. package/skills/tdd/mocking.md +0 -59
  100. package/skills/tdd/tests.md +0 -77
  101. package/skills/teach/GLOSSARY-FORMAT.md +0 -35
  102. package/skills/teach/LEARNING-RECORD-FORMAT.md +0 -46
  103. package/skills/teach/LICENSE +0 -21
  104. package/skills/teach/MISSION-FORMAT.md +0 -31
  105. package/skills/teach/RESOURCES-FORMAT.md +0 -32
  106. package/skills/teach/SKILL.md +0 -141
  107. package/skills/teach/agents/openai.yaml +0 -4
  108. package/skills/to-questionnaire/LICENSE +0 -21
  109. package/skills/to-questionnaire/SKILL.md +0 -55
  110. package/skills/to-questionnaire/agents/openai.yaml +0 -4
  111. package/skills/to-spec/LICENSE +0 -21
  112. package/skills/to-spec/SKILL.md +0 -76
  113. package/skills/to-spec/agents/openai.yaml +0 -4
  114. package/skills/to-tickets/LICENSE +0 -21
  115. package/skills/to-tickets/SKILL.md +0 -106
  116. package/skills/to-tickets/agents/openai.yaml +0 -4
  117. package/skills/wait-what/LICENSE +0 -21
  118. package/skills/wait-what/SKILL.md +0 -8
  119. package/skills/wait-what/agents/openai.yaml +0 -4
  120. package/skills/wayfinder/LICENSE +0 -21
  121. package/skills/wayfinder/SKILL.md +0 -129
  122. package/skills/wayfinder/agents/openai.yaml +0 -4
  123. package/skills/writing-for-agents/LICENSE +0 -21
  124. package/skills/writing-for-agents/SKILL-MECHANICS.md +0 -22
  125. package/skills/writing-for-agents/SKILL.md +0 -83
  126. package/skills/writing-for-agents/agents/openai.yaml +0 -3
@@ -6,6 +6,7 @@ import { basename, join } from 'node:path';
6
6
  import { pipeline } from 'node:stream/promises';
7
7
  import { unlessAborted } from './abort.js';
8
8
  import { failureOf, run } from './clis.js';
9
+ import { downloaded, fetched } from './files.js';
9
10
  import { kitHome } from './home.js';
10
11
  const RELEASE = 'https://github.com/agentshouse/kit/releases/download/engine-2';
11
12
  export const MODEL = {
@@ -28,6 +29,11 @@ export const ENGINES = {
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;
@@ -49,10 +55,10 @@ 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);
61
+ return Math.max(1, Math.floor(Math.min(availableParallelism(), allowed) / 2));
56
62
  }
57
63
  async function sha256(path) {
58
64
  const hash = createHash('sha256');
@@ -62,6 +68,20 @@ async function sha256(path) {
62
68
  function causeOf(error) {
63
69
  return error instanceof Error ? error.message : String(error);
64
70
  }
71
+ async function failing(reason, work) {
72
+ try {
73
+ return await work;
74
+ }
75
+ catch (error) {
76
+ throw new Error(reason, { cause: error });
77
+ }
78
+ }
79
+ function ready() {
80
+ if (setting !== true)
81
+ throw new Error(OFF);
82
+ if (!readiness.installed)
83
+ throw new Error(NOT_INSTALLED);
84
+ }
65
85
  function pinnedHere() {
66
86
  return ENGINES[`${process.platform}-${process.arch}`];
67
87
  }
@@ -133,27 +153,23 @@ export function holdTranscription(transcribe) {
133
153
  export function transcriptionReport() {
134
154
  return readiness;
135
155
  }
136
- async function transcribed(path, signal) {
156
+ async function transcribed(audio, parts, signal) {
137
157
  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
- }
158
+ await mkdir(parts);
159
+ await failing(UNDECODABLE, executed(installed(pinned.decoder), ['-nostdin', '-hide_banner', '-loglevel', 'error', '-i', audio, '-ar', '16000', '-ac', '1', '-c:a', 'pcm_s16le',
160
+ '-f', 'segment', '-segment_time', String(CHUNK_SECONDS), join(parts, '%05d.wav')], signal));
161
+ const segments = (await readdir(parts)).sort().flatMap((part) => ['-f', join(parts, part)]);
162
+ const said = await failing(UNTRANSCRIBED, executed(installed(pinned.engine), ['-t', String(await threads()), '-np', '-m', installed(MODEL), ...segments], signal));
163
+ const text = said
164
+ .split('\n')
165
+ .map((line) => line.trim())
166
+ .filter((line) => line !== '')
167
+ .join(' ');
168
+ if (text === '')
169
+ throw new Error(UNTRANSCRIBED);
170
+ return text;
153
171
  }
154
- export async function transcribe(path, signal) {
155
- if (!readiness.installed)
156
- return null;
172
+ async function alone(work, signal) {
157
173
  const before = held;
158
174
  let release;
159
175
  const mine = new Promise((resolve) => {
@@ -162,9 +178,24 @@ export async function transcribe(path, signal) {
162
178
  held = Promise.all([before, mine]);
163
179
  try {
164
180
  await unlessAborted(before, signal);
165
- return readiness.installed ? await transcribed(path, signal) : null;
181
+ return await work();
166
182
  }
167
183
  finally {
168
184
  release();
169
185
  }
170
186
  }
187
+ export async function transcribe(address, signal) {
188
+ ready();
189
+ const work = await mkdtemp(join(tmpdir(), 'kit-transcription-'));
190
+ try {
191
+ const audio = join(work, 'audio');
192
+ await failing(NOT_DOWNLOADED, downloaded(address, (url) => fetched(url, signal), audio, 'audio'));
193
+ return await alone(() => {
194
+ ready();
195
+ return transcribed(audio, join(work, 'parts'), signal);
196
+ }, signal);
197
+ }
198
+ finally {
199
+ await rm(work, { recursive: true, force: true });
200
+ }
201
+ }
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,8 @@ 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';
12
9
  function directory() {
13
10
  return join(kitHome(), 'update');
14
11
  }
@@ -18,10 +15,25 @@ function pending() {
18
15
  function outcome() {
19
16
  return join(directory(), 'outcome');
20
17
  }
21
- function unit(inputId) {
22
- return `house-kit-update-${inputId}`;
18
+ function unit(callId) {
19
+ return `house-kit-update-${callId}`;
20
+ }
21
+ function manager() {
22
+ return service() === 'user' ? ['--user'] : [];
23
+ }
24
+ function elevated() {
25
+ return throughSudo() ? ['sudo', '-n'] : [];
26
+ }
27
+ function account() {
28
+ return throughSudo() ? [`--uid=${process.getuid()}`, `--gid=${process.getgid()}`] : [];
29
+ }
30
+ function placement() {
31
+ return service() === 'user' ? ['--workspace', workspaceRoot()] : ['--linux'];
32
+ }
33
+ function record() {
34
+ return `outcome=$1; shift; bash "$0" "$@"; printf %s "$?" > "$outcome"; ${[...elevated(), 'systemctl', ...manager(), 'start', 'house-kit.service'].join(' ')}`;
23
35
  }
24
- async function pendingInput() {
36
+ async function pendingCall() {
25
37
  try {
26
38
  return JSON.parse(await readFile(pending(), 'utf8')).input_id;
27
39
  }
@@ -35,85 +47,92 @@ async function recorded() {
35
47
  return null;
36
48
  return status.trim() === '0' ? {} : { refused: `the Kit bootstrap exited with ${status.trim()}` };
37
49
  }
38
- async function finished(inputId) {
50
+ async function forget(callId) {
51
+ if ((await pendingCall()) !== callId)
52
+ return;
53
+ await rm(pending(), { force: true });
54
+ await rm(outcome(), { force: true });
55
+ }
56
+ async function finished(callId) {
39
57
  for (;;) {
40
- const ack = await recorded();
41
- if (ack !== null)
42
- return ack;
58
+ const result = await recorded();
59
+ if (result !== null)
60
+ return result;
43
61
  // 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) {
62
+ if ((await run('systemctl', [...manager(), 'is-active', '--quiet', unit(callId)], 10_000)).status !== 0) {
45
63
  return (await recorded()) ?? { refused: 'the Kit bootstrap did not finish' };
46
64
  }
47
65
  // The bootstrap runs for minutes, so checking each second sees its outcome within a second at little cost.
48
66
  await new Promise((resolve) => setTimeout(resolve, 1000));
49
67
  }
50
68
  }
51
- function rerun(script, inputId, flags) {
69
+ function rerun(script, callId, flags) {
52
70
  return new Promise((resolve) => {
53
- const child = spawn('systemd-run', [
71
+ const [command, ...args] = [
72
+ ...elevated(),
73
+ 'systemd-run',
74
+ ...manager(),
75
+ ...account(),
54
76
  '--wait',
55
77
  '--collect',
56
78
  '--quiet',
57
- `--unit=${unit(inputId)}`,
79
+ `--unit=${unit(callId)}`,
58
80
  `--setenv=HOME=${homedir()}`,
81
+ `--setenv=HOUSE_KIT_HOME=${kitHome()}`,
59
82
  '/bin/sh',
60
83
  '-c',
61
- RECORD,
84
+ record(),
62
85
  script,
63
86
  outcome(),
87
+ ...placement(),
64
88
  ...flags,
65
- ], { stdio: ['ignore', 'ignore', 'inherit'] });
66
- child.on('error', () => resolve({ refused: 'no service manager runs this Kit' }));
89
+ ];
90
+ const child = spawn(command, args, { stdio: ['ignore', 'ignore', 'inherit'] });
91
+ child.on('error', () => resolve({ refused: 'no service manager runs this Kit process' }));
67
92
  child.on('close', () => resolve(null));
68
93
  });
69
94
  }
70
- export class Updates {
71
- house;
72
- held = new Set();
95
+ export class KitUpdate {
96
+ calls;
73
97
  queue = Promise.resolve();
74
- constructor(house) {
75
- this.house = house;
98
+ constructor(calls) {
99
+ this.calls = calls;
76
100
  }
77
101
  async resumed() {
78
- const inputId = await pendingInput();
79
- if (inputId === null)
102
+ const callId = await pendingCall();
103
+ if (callId === null)
80
104
  return;
81
- await this.acknowledge(inputId, await finished(inputId));
105
+ await this.enqueue(callId, () => finished(callId));
82
106
  }
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));
107
+ start(call) {
108
+ void this.enqueue(call.input_id, () => this.carry(call));
109
+ }
110
+ enqueue(callId, work) {
111
+ const before = this.queue;
112
+ const carried = this.calls.carry(callId, async () => {
113
+ await before;
114
+ return { result: await work(), returned: () => forget(callId) };
115
+ });
116
+ this.queue = before.then(() => carried);
117
+ return carried;
92
118
  }
93
- async carry(input) {
94
- if ((await pendingInput()) === input.input_id)
95
- return finished(input.input_id);
96
- const answer = await fetch(input.bootstrap);
119
+ async carry(call) {
120
+ if ((await pendingCall()) === call.input_id)
121
+ return finished(call.input_id);
122
+ const answer = await fetch(call.bootstrap);
97
123
  if (!answer.ok)
98
124
  return { refused: `the Kit bootstrap could not be downloaded: ${answer.status}` };
99
125
  const script = Buffer.from(await answer.arrayBuffer());
100
- if (createHash('sha256').update(script).digest('hex') !== input.sha256) {
126
+ if (createHash('sha256').update(script).digest('hex') !== call.sha256) {
101
127
  return { refused: 'the Kit bootstrap does not match its sha256' };
102
128
  }
103
129
  await mkdir(directory(), { recursive: true, mode: 0o700 });
104
130
  const path = join(directory(), 'connect-linux.sh');
105
131
  await writeFile(path, script, { mode: 0o700 });
106
132
  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()) ?? {
133
+ await writeFile(pending(), `${JSON.stringify({ input_id: call.input_id })}\n`, { mode: 0o600 });
134
+ return (await rerun(path, call.input_id, call.update_clis ? ['--update-clis'] : [])) ?? (await recorded()) ?? {
109
135
  refused: 'the Kit bootstrap did not finish',
110
136
  };
111
137
  }
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
138
  }
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-c14f8446ba284",
4
- "description": "House Kit connects an Environment to agents.house.",
3
+ "version": "0.2.1-c1873657edab7",
4
+ "description": "Kit connects an Environment to agents.house.",
5
5
  "license": "MIT",
6
6
  "repository": {
7
7
  "type": "git",
@@ -16,18 +16,18 @@
16
16
  "./bootstrap": "./dist/bootstrap.json"
17
17
  },
18
18
  "files": [
19
- "dist",
20
- "how-we-work.md",
21
- "skills"
19
+ "dist"
22
20
  ],
23
21
  "scripts": {
24
22
  "build": "tsc -p tsconfig.build.json && node scripts/bootstrap-manifest.mjs",
25
23
  "engine": "mkdir -p tmp/engine && docker run --rm -v \"$PWD:/kit\" -w /kit alpine:3.24@sha256:294b683cb724975bec92580e1e685676bd4b50bda910ddb8c51d4cabeaec77e6 sh scripts/engine.sh tmp/engine",
24
+ "follow-skills": "node scripts/follow-skills.mjs",
26
25
  "test": "tsc -p tsconfig.json && vitest run"
27
26
  },
28
27
  "dependencies": {
29
28
  "@agentclientprotocol/sdk": "1.7.0",
30
- "@agentshouse/mdmodel": "0.1.0-alpha.19",
29
+ "@agentshouse/mdmodel": "0.1.0-cabd61587647f",
30
+ "@agentshouse/skills": "0.1.0-c6411c39c6d0f",
31
31
  "yaml": "2.9.1"
32
32
  },
33
33
  "peerDependencies": {
package/dist/stream.js DELETED
@@ -1,72 +0,0 @@
1
- import { subscribe } from 'node:diagnostics_channel';
2
- import { finalRefusal, HouseRefusal, retryDelay } from './api.js';
3
- import { end, REPLACED, SIGN_IN_AGAIN } from './end.js';
4
- import { readEnrolment } from './home.js';
5
- import { relayed } from './relay.js';
6
- const PATH = '/kit/stream';
7
- const SUBPROTOCOL = 'house.kit.stream.1';
8
- const REFUSAL_HEADER = 'x-house-refusal';
9
- function streamUrl(house) {
10
- const url = new URL(PATH, house);
11
- url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
12
- return url;
13
- }
14
- function header(headers, name) {
15
- for (let index = 0; index < headers.length; index += 2) {
16
- if (headers[index].toString('latin1').toLowerCase() === name)
17
- return headers[index + 1].toString('latin1');
18
- }
19
- return '';
20
- }
21
- let refused = null;
22
- subscribe('undici:request:headers', (message) => {
23
- const { request, response } = message;
24
- if (!request.path.endsWith(PATH))
25
- return;
26
- refused = new HouseRefusal(PATH, response.statusCode, header(response.headers, REFUSAL_HEADER) || response.statusText);
27
- });
28
- export function holdStream(handlers) {
29
- let socket = null;
30
- let failures = 0;
31
- const connect = async () => {
32
- const { house, credential } = (await readEnrolment());
33
- refused = null;
34
- const opening = new WebSocket(relayed(streamUrl(house)), {
35
- protocols: [SUBPROTOCOL],
36
- headers: { authorization: `Bearer ${credential}` },
37
- });
38
- let opened = false;
39
- opening.onopen = () => {
40
- opened = true;
41
- failures = 0;
42
- socket = opening;
43
- handlers.opened();
44
- };
45
- opening.onmessage = (event) => {
46
- handlers.frame(JSON.parse(String(event.data)));
47
- };
48
- opening.onerror = () => undefined;
49
- opening.onclose = (event) => {
50
- if (socket === opening)
51
- socket = null;
52
- process.stderr.write(`kit: control stream closed ${event.code} ${event.reason}\n`);
53
- if (event.reason === 'replaced')
54
- end(REPLACED);
55
- if (event.reason === 'credential_rejected' || refused?.status === 401)
56
- end(SIGN_IN_AGAIN);
57
- if (finalRefusal(refused))
58
- end(refused.message);
59
- // A closed socket reopens in one to three seconds, spread so Kits one restart closed return apart; an opening House refused as retryable or left unanswered backs off on the jittered curve.
60
- setTimeout(() => void connect(), opened ? 1000 + Math.random() * 2000 : retryDelay(failures++));
61
- };
62
- };
63
- void connect();
64
- return {
65
- send(frame) {
66
- if (socket === null || socket.readyState !== WebSocket.OPEN)
67
- return false;
68
- socket.send(JSON.stringify(frame));
69
- return true;
70
- },
71
- };
72
- }
package/how-we-work.md DELETED
@@ -1,23 +0,0 @@
1
- # How we work
2
-
3
- A Room is where information people share is kept; it is not the place for
4
- private information. Work goes into the Room it belongs to, or the First Room
5
- when none is named.
6
-
7
- The skills are already set up; never run `setup-matt-pocock-skills`.
8
-
9
- ## Where skill output goes
10
-
11
- - Glossary (`CONTEXT.md`): `glossary.md`
12
- - Decisions (ADRs): `decisions/NNNN-<slug>.md`
13
- - Plan (spec): `projects/<name>/plan.md`
14
- - Tasks (tickets): `projects/<name>/tasks/NN-<slug>.md`, with a
15
- `Status:` line (`needs-triage`, `needs-info`, `ready-for-agent`,
16
- `ready-for-human`, `wontfix`), a `Blocked by:` line and comments under
17
- `## Comments`
18
- - Map (Wayfinding): `projects/<name>/map.md`, its tasks under
19
- `tasks/` with `Type:`, `Status: claimed|resolved` and `Blocked by:` lines
20
- - Research: `research/<slug>.md`
21
- - Questionnaires: `questionnaires/<slug>.md`
22
- - Learning: `learning/<topic>/`
23
- - Prototype: one HTML file with every variant on one page.
@@ -1,21 +0,0 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Matt Pocock
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
@@ -1,55 +0,0 @@
1
- # Phase boundaries
2
-
3
- A **phase** is a chunk of work inside a session: the grilling, the implementation, the QA. The definition is fuzzy on purpose: a phase ends when you think *"ok, we're done with that"*.
4
-
5
- The **phase boundary** is the gap between two phases, and it is the only place this decision belongs. Mid-phase there is no decision to make: continue, or split the work that's left into subagents. Compacting mid-phase makes the agent lose the thread.
6
-
7
- ## The five options
8
-
9
- | Option | What it does |
10
- | ------------ | --------------------------------------------------------------- |
11
- | **Continue** | Stay in the session. No context switch at all. |
12
- | **`/clear`** | Empty the context window and start from nothing. |
13
- | **`/handoff`** | Write a portable markdown file and seed a session anywhere with it. |
14
- | **Subagent** | Send the task to its own context window and get a report back. |
15
- | **`/compact`** | Compress this context and seed a fresh session with the summary. |
16
-
17
- ## The tree
18
-
19
- Work top to bottom at the boundary. The first **yes** wins.
20
-
21
- **1. Can you continue in this session?** Two things make the answer yes: the next phase needs this phase as a **primary source**, or you have enough [smart zone](https://www.aihero.dev/ai-coding-dictionary/smart-zone) left (~150k tokens) for the next phase to fit. Grilling → implementation is the standard yes: the implementation wants the reasoning verbatim, not a summary of it. Continue costs nothing and loses nothing, so rule it out before anything else.
22
-
23
- **2. Is the context irrelevant to what comes next?** Is everything in this session (the exploration, the decisions, the dead ends) disposable? If so, **`/clear`**. It is the cheapest move on the board: it takes no time and hands back the whole window. `/clear` also isn't terminal: the old session stays resumable.
24
-
25
- The cost of getting this wrong is one-way. Clear a *relevant* context and you lose the **why** behind what you built, and no amount of reading the diff back gets it returned.
26
-
27
- **3. Do you need to hand off?** `/handoff` is narrow. You need it only when you are:
28
-
29
- - swapping to a **new harness** (Claude → Codex),
30
- - moving to a **new directory** or repo,
31
- - sending the work to a **colleague**,
32
- - or forking a side task you found **mid-phase** without derailing what you're doing.
33
-
34
- That list is the whole clause. What `/handoff` buys is **portability**: a file that travels. If nothing is travelling, you don't need it.
35
-
36
- **4. Can the task be done AFK?** Is it scoped tightly enough to run with you away from the keyboard, no steering? Then send it to a **subagent** and leave this session untouched. Automated review is the standard case: the agent reads the diff and reports, and you aren't needed while it does.
37
-
38
- **5. Otherwise, `/compact`.** Relevant context, same harness, same directory, and you need to stay in the loop: this is where the tree lands, and it lands here often. Pass it an instruction (`/compact we're going to QA this area`) so the summary keeps what the next phase needs.
39
-
40
- `/compact` is the **default, not the first reach**. It sits at the bottom because the four questions above it are all cheaper or more precise. The failure mode when people start here is a fresh session that is confidently wrong about a decision the summary flattened.
41
-
42
- ## Primary and secondary sources
43
-
44
- Every move except **Continue** turns a **primary source** into a **secondary source**: the session as it happened, replaced by a summary of it. The trade is always the same shape:
45
-
46
- | Source | Information | Noise | Room to move |
47
- | --------------------------------- | ----------- | ----- | ------------ |
48
- | Primary (Continue) | Full | Lots | Little |
49
- | Secondary (`/compact`, `/handoff`) | Lossy | Less | Lots |
50
-
51
- This is why question 1 comes first. You only pay the lossiness when staying costs more than it saves.
52
-
53
- ## These are judgement calls
54
-
55
- The questions are not objective: each has taste in it, and the same boundary can go two ways on two days. The value is in asking them **in order**, at the boundary rather than in the middle of the work.