@agentshouse/kit 0.2.1-c5987c9cb6553 → 0.2.1-c59ffcda991c1

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 (88) hide show
  1. package/README.md +18 -17
  2. package/dist/agents.js +51 -3
  3. package/dist/api.js +1 -1
  4. package/dist/app-git.js +10 -26
  5. package/dist/bootstrap.json +4 -4
  6. package/dist/bridge.js +3 -6
  7. package/dist/chatgpt.js +9 -2
  8. package/dist/clis.js +12 -2
  9. package/dist/conversations.js +109 -28
  10. package/dist/copies.js +50 -25
  11. package/dist/end.js +3 -2
  12. package/dist/events.js +4 -0
  13. package/dist/files.js +1 -1
  14. package/dist/git.js +2 -3
  15. package/dist/home.js +56 -5
  16. package/dist/house-cli.js +291 -0
  17. package/dist/house-main.js +7 -262
  18. package/dist/instructions.js +4 -28
  19. package/dist/kit-cli.js +68 -0
  20. package/dist/kit-main.js +8 -67
  21. package/dist/login.js +40 -16
  22. package/dist/logout.js +0 -2
  23. package/dist/placement.js +2 -20
  24. package/dist/resident.js +53 -10
  25. package/dist/skills.js +81 -12
  26. package/dist/stream.js +58 -12
  27. package/dist/transcription.js +3 -3
  28. package/dist/update.js +1 -0
  29. package/dist/wire.js +1 -1
  30. package/dist/work.js +3 -5
  31. package/how-we-work.md +13 -3
  32. package/package.json +2 -1
  33. package/skills/ask-matt/SKILL.md +17 -11
  34. package/skills/ask-matt/agents/openai.yaml +1 -0
  35. package/skills/code-review/SKILL.md +5 -5
  36. package/skills/codebase-design/DESIGN-IT-TWICE.md +1 -1
  37. package/skills/codebase-design/SKILL.md +0 -2
  38. package/skills/diagnosing-bugs/SKILL.md +2 -4
  39. package/skills/domain-modeling/{CONTEXT-FORMAT.md → GLOSSARY-FORMAT.md} +10 -10
  40. package/skills/domain-modeling/SKILL.md +12 -14
  41. package/skills/grill-me/SKILL.md +1 -2
  42. package/skills/grill-me/agents/openai.yaml +1 -0
  43. package/skills/grill-with-docs/SKILL.md +1 -2
  44. package/skills/grill-with-docs/agents/openai.yaml +1 -0
  45. package/skills/grilling/SKILL.md +2 -2
  46. package/skills/handoff/SKILL.md +2 -3
  47. package/skills/handoff/agents/openai.yaml +1 -0
  48. package/skills/implement/SKILL.md +5 -4
  49. package/skills/implement/agents/openai.yaml +1 -0
  50. package/skills/implement-spec/SKILL.md +40 -0
  51. package/skills/implement-spec/agents/openai.yaml +5 -0
  52. package/skills/improve-codebase-architecture/SKILL.md +6 -7
  53. package/skills/improve-codebase-architecture/agents/openai.yaml +1 -0
  54. package/skills/pr/CREDITS.md +3 -0
  55. package/skills/pr/LICENSE +21 -0
  56. package/skills/pr/SKILL.md +170 -0
  57. package/skills/pr/agents/openai.yaml +3 -0
  58. package/skills/prototype/SKILL.md +0 -2
  59. package/skills/research/SKILL.md +0 -2
  60. package/skills/retro/LICENSE +21 -0
  61. package/skills/retro/SKILL.md +44 -0
  62. package/skills/retro/agents/openai.yaml +5 -0
  63. package/skills/tdd/SKILL.md +2 -4
  64. package/skills/teach/SKILL.md +3 -4
  65. package/skills/teach/agents/openai.yaml +1 -0
  66. package/skills/to-questionnaire/SKILL.md +1 -2
  67. package/skills/to-questionnaire/agents/openai.yaml +1 -0
  68. package/skills/to-spec/SKILL.md +1 -2
  69. package/skills/to-spec/agents/openai.yaml +1 -0
  70. package/skills/to-tickets/SKILL.md +3 -4
  71. package/skills/to-tickets/agents/openai.yaml +1 -0
  72. package/skills/triage/AGENT-BRIEF.md +207 -0
  73. package/skills/triage/LICENSE +21 -0
  74. package/skills/triage/OUT-OF-SCOPE.md +105 -0
  75. package/skills/triage/SKILL.md +112 -0
  76. package/skills/triage/agents/openai.yaml +5 -0
  77. package/skills/wait-what/SKILL.md +2 -3
  78. package/skills/wait-what/agents/openai.yaml +1 -0
  79. package/skills/wayfinder/SKILL.md +5 -6
  80. package/skills/wayfinder/agents/openai.yaml +1 -0
  81. package/skills/wizard/LICENSE +21 -0
  82. package/skills/wizard/SKILL.md +44 -0
  83. package/skills/wizard/agents/openai.yaml +3 -0
  84. package/skills/wizard/template.sh +223 -0
  85. package/skills/writing-for-agents/SKILL.md +0 -2
  86. package/skills/resolving-merge-conflicts/SKILL.md +0 -16
  87. package/skills/resolving-merge-conflicts/agents/openai.yaml +0 -3
  88. /package/skills/{resolving-merge-conflicts → implement-spec}/LICENSE +0 -0
package/dist/kit-main.js CHANGED
@@ -1,69 +1,10 @@
1
1
  #!/usr/bin/env node
2
- import { setGlobalProxyFromEnv } from 'node:http';
3
- import { parseArgs } from 'node:util';
4
- import { answerGitCredential } from './app-git.js';
5
- import { chatgpt } from './chatgpt.js';
6
- import { login } from './login.js';
7
- import { logout } from './logout.js';
8
- import { resident } from './resident.js';
9
- const USAGE = 'usage: kit <login|logout|resident|chatgpt>\n';
10
- const COMMANDS = new Map([
11
- [
12
- 'logout',
13
- {
14
- usage: 'usage: kit logout',
15
- about: "disconnects this computer, stops House Kit and ends your own agent's connection",
16
- operands: 0,
17
- run: logout,
18
- },
19
- ],
20
- [
21
- 'resident',
22
- {
23
- usage: 'usage: kit resident',
24
- about: "keeps this Environment connected; House Kit's service runs it",
25
- operands: 0,
26
- run: resident,
27
- },
28
- ],
29
- [
30
- 'git-credential',
31
- {
32
- usage: 'usage: kit git-credential <get|store|erase>',
33
- about: "answers git with your own agent's House credential; git runs it",
34
- operands: 1,
35
- run: ([operation]) => answerGitCredential(operation),
36
- },
37
- ],
38
- ]);
39
- const [command, ...argv] = process.argv.slice(2);
40
- setGlobalProxyFromEnv();
41
- async function run() {
42
- if (command === 'login')
43
- return login(argv);
44
- if (command === 'chatgpt')
45
- return chatgpt(argv);
46
- if (command === '--help') {
47
- parseArgs({ args: argv });
48
- process.stdout.write(USAGE);
49
- return;
50
- }
51
- const chosen = COMMANDS.get(command ?? '');
52
- if (chosen === undefined) {
53
- process.stderr.write(USAGE);
54
- process.exitCode = 2;
55
- return;
56
- }
57
- const { values, positionals } = parseArgs({ args: argv, options: { help: { type: 'boolean', default: false } }, allowPositionals: true });
58
- if (positionals.length > chosen.operands)
59
- throw new Error(`unexpected argument ${positionals[chosen.operands]}; ${chosen.usage}`);
60
- if (values.help) {
61
- process.stdout.write(`${chosen.usage}\n ${chosen.about}\n`);
62
- return;
63
- }
64
- return chosen.run(positionals);
65
- }
66
- run().catch((error) => {
67
- process.stderr.write(`kit: ${error instanceof Error ? error.message : String(error)}\n`);
2
+ const [major = 0, minor = 0] = process.versions.node.split('.').map(Number);
3
+ if (major < 24 || (major === 24 && minor < 14)) {
4
+ process.stderr.write(`kit: the Kit needs Node 24.14.0 or newer; this is ${process.versions.node}\n`);
68
5
  process.exitCode = 1;
69
- });
6
+ }
7
+ else {
8
+ await import('./kit-cli.js');
9
+ }
10
+ export {};
package/dist/login.js CHANGED
@@ -2,11 +2,12 @@ import { spawn } from 'node:child_process';
2
2
  import { createHash, randomBytes } from 'node:crypto';
3
3
  import { hostname } from 'node:os';
4
4
  import { parseArgs } from 'node:util';
5
- import { post, retrying } from './api.js';
5
+ import { HouseRefusal, post, retrying } from './api.js';
6
6
  import { placeAppGit } from './app-git.js';
7
7
  import { writeCodexRule } from './clis.js';
8
- import { forgetOwnAgent, readDisconnected, readEnrolment, readOwnAgent, writeEnrolment, writeOwnAgent } from './home.js';
8
+ import { forgetDisconnected, forgetOwnAgent, readDisconnected, readEnrolment, readOwnAgent, writeEnrolment, writeOwnAgent, } from './home.js';
9
9
  import { callHouse, rpc } from './mcp.js';
10
+ import { refusalOf } from './refusals.js';
10
11
  import { selectRelay } from './relay.js';
11
12
  import { startService } from './service.js';
12
13
  import { placeSkillSet } from './skills.js';
@@ -35,6 +36,16 @@ const USAGE = `usage: kit login [--house <origin>] [--environment <id>] [--rooms
35
36
  --no-private give this Environment every Room but your Private Room
36
37
  --code <code> connect this machine with a login code
37
38
  `;
39
+ function connected(house, named, environment) {
40
+ if (named === undefined)
41
+ return `Environment ${environment} is connected to ${house}.\n`;
42
+ if (named === environment)
43
+ return `Environment ${environment} is reconnected to ${house}.\n`;
44
+ return `Environment ${named} stays with its account; this computer is connected to ${house} as new Environment ${environment} of the account that confirmed.\n`;
45
+ }
46
+ function gone(error) {
47
+ return error instanceof HouseRefusal && refusalOf(error.text)?.code === 'kit_environment_not_found';
48
+ }
38
49
  function chosenRooms(rooms, noPrivate) {
39
50
  if (rooms !== undefined && noPrivate)
40
51
  throw new Error('--rooms and --no-private are two choices of Rooms; pass one');
@@ -73,9 +84,11 @@ export async function login(argv) {
73
84
  selectRelay(relay);
74
85
  const house = values.house ?? enrolled?.house ?? DEFAULT_HOUSE;
75
86
  const replaces = process.env.HOUSE_KIT_REPLACES;
76
- const environment = replaces === undefined ? (values.environment ?? (enrolled?.house === house ? enrolled.environment : undefined)) : undefined;
87
+ const remembered = replaces === undefined && values.environment === undefined && enrolled?.house === house ? enrolled.environment : undefined;
88
+ const environment = replaces === undefined ? (values.environment ?? remembered) : undefined;
77
89
  const ownAgent = await readOwnAgent();
78
90
  let held = false;
91
+ let named = environment;
79
92
  let exchanged;
80
93
  if (values.code !== undefined) {
81
94
  exchanged = await post(house, '/kit/token', { code: values.code, label: hostname() });
@@ -83,41 +96,52 @@ export async function login(argv) {
83
96
  else {
84
97
  held = ownAgent !== null && ownAgent.house === house && (await accepted(house, ownAgent.credential));
85
98
  const verifier = randomBytes(32).toString('base64url');
86
- const started = await retrying(() => post(house, '/kit', {
99
+ const start = () => retrying(() => post(house, '/kit', {
87
100
  label: hostname(),
88
- ...(environment === undefined
101
+ ...(named === undefined
89
102
  ? { act: 'new_environment', ...(replaces === undefined ? {} : { replaces }) }
90
- : { act: 'existing_environment', environment_id: environment }),
103
+ : { act: 'existing_environment', environment_id: named }),
91
104
  ...rooms,
92
105
  code_challenge: createHash('sha256').update(verifier).digest('base64url'),
93
106
  ...(held ? {} : { headless: true }),
94
107
  }));
108
+ let started;
109
+ try {
110
+ started = await start();
111
+ }
112
+ catch (error) {
113
+ if (remembered === undefined || !gone(error))
114
+ throw error;
115
+ await forgetDisconnected();
116
+ process.stdout.write(`House no longer holds Environment ${remembered}; connecting this computer as a new one.\n`);
117
+ named = undefined;
118
+ started = await start();
119
+ }
95
120
  process.stdout.write(`Open this link and confirm: ${started.start_url}\n`);
96
121
  open(started.start_url);
97
122
  exchanged = await retrying(() => post(house, '/kit/token', { login: started.login, code_verifier: verifier }), undefined, () => POLL_INTERVAL_MS);
98
123
  }
99
- try {
100
- await placeSkillSet();
101
- }
102
- catch (error) {
103
- process.stderr.write(`kit: the skills could not be placed: ${error.message}\n`);
104
- }
124
+ await placeSkillSet();
105
125
  await writeCodexRule().catch((error) => process.stderr.write(`kit: ${error.message}\n`));
126
+ const relayRecord = relay === undefined ? {} : { relay };
106
127
  await writeEnrolment({
107
128
  house,
108
- ...(relay === undefined ? {} : { relay }),
129
+ ...relayRecord,
109
130
  environment: exchanged.environment,
110
131
  credential: exchanged.credential,
111
132
  });
112
- process.stdout.write(`Environment ${exchanged.environment} is connected to ${house}.\n`);
133
+ process.stdout.write(connected(house, named, exchanged.environment));
113
134
  if (exchanged.headless_credential !== undefined) {
114
- await writeOwnAgent({ house, user: exchanged.user, credential: exchanged.headless_credential });
135
+ await writeOwnAgent({ house, ...relayRecord, user: exchanged.user, credential: exchanged.headless_credential });
115
136
  }
116
137
  else if (held && ownAgent !== null && ownAgent.user !== exchanged.user) {
117
138
  await forgetOwnAgent();
118
139
  process.stdout.write("This computer's own agent was another User's; run kit login again to connect it to you.\n");
119
140
  }
120
- await placeAppGit(ownAgent, await readOwnAgent());
141
+ else if (held && ownAgent !== null) {
142
+ await writeOwnAgent({ house, ...relayRecord, user: ownAgent.user, credential: ownAgent.credential });
143
+ }
144
+ await placeAppGit(await readOwnAgent()).catch((error) => process.stderr.write(`kit: ${error.message}\n`));
121
145
  try {
122
146
  startService();
123
147
  }
package/dist/logout.js CHANGED
@@ -1,5 +1,4 @@
1
1
  import { HouseRefusal, post } from './api.js';
2
- import { forgetAppGit } from './app-git.js';
3
2
  import { forgetEnrolment, forgetOwnAgent, readEnrolment } from './home.js';
4
3
  export async function logout() {
5
4
  const enrolled = await readEnrolment();
@@ -13,7 +12,6 @@ export async function logout() {
13
12
  }
14
13
  await forgetEnrolment(enrolled);
15
14
  }
16
- await forgetAppGit();
17
15
  await forgetOwnAgent();
18
16
  process.stdout.write(enrolled === null
19
17
  ? 'This computer is not connected to House.\n'
package/dist/placement.js CHANGED
@@ -2,7 +2,6 @@ import { readFileSync } from 'node:fs';
2
2
  import { join } from 'node:path';
3
3
  import { run } from './clis.js';
4
4
  import { kitHome } from './home.js';
5
- import { relayOrigin } from './relay.js';
6
5
  export function service() {
7
6
  if (process.platform !== 'linux' || !process.env.INVOCATION_ID)
8
7
  return null;
@@ -19,9 +18,9 @@ export async function updatesItself() {
19
18
  // sudo answers at once, so ten seconds only bounds a stuck sudo.
20
19
  return (await run('sudo', ['-n', 'true'], 10_000)).status === 0;
21
20
  }
22
- function installed() {
21
+ export function installCommand() {
23
22
  try {
24
- return readFileSync(join(kitHome(), 'placement'), 'utf8').trim();
23
+ return readFileSync(join(kitHome(), 'install-command'), 'utf8').trim();
25
24
  }
26
25
  catch (error) {
27
26
  if (error.code === 'ENOENT')
@@ -29,20 +28,3 @@ function installed() {
29
28
  throw error;
30
29
  }
31
30
  }
32
- function entries(house) {
33
- const host = new URL(house).host;
34
- const relay = relayOrigin();
35
- if (relay === undefined)
36
- return [`curl -fsSL ${host}/kit | sh`, `irm ${host}/kit.ps1 | iex`];
37
- const entry = `${relay}/${host}/kit`;
38
- return [`curl -fsSL ${entry} | HOUSE_KIT_RELAY=${relay} sh`, `$env:HOUSE_KIT_RELAY='${relay}'; irm ${entry}.ps1 | iex`];
39
- }
40
- export function installCommand(house) {
41
- const [shell, windows] = entries(house);
42
- const placement = installed();
43
- if (placement === 'native')
44
- return shell;
45
- if (placement === 'server')
46
- return `${shell} -s -- --linux`;
47
- return `${shell} -s -- --container, or ${windows} on Windows`;
48
- }
package/dist/resident.js CHANGED
@@ -1,8 +1,9 @@
1
1
  import { once } from 'node:events';
2
2
  import { watch } from 'node:fs';
3
3
  import { mkdir, rm, writeFile } from 'node:fs/promises';
4
- import { createServer } from 'node:http';
4
+ import { createServer, get } from 'node:http';
5
5
  import { dirname, extname, join } from 'node:path';
6
+ import { DatabaseSync } from 'node:sqlite';
6
7
  import { fileURLToPath } from 'node:url';
7
8
  import { Agents } from './agents.js';
8
9
  import { house } from './api.js';
@@ -10,7 +11,7 @@ import { received } from './bridge.js';
10
11
  import { CONVERSATION_INPUTS, Conversations } from './conversations.js';
11
12
  import { LocalCopies } from './copies.js';
12
13
  import { restart } from './end.js';
13
- import { agentBase, enrolled, forgetRestart, kitHome, restartAsked } from './home.js';
14
+ import { agentBase, enrolled, forgetRestart, kitHome, ownerLock, ownerSocket, restartAsked } from './home.js';
14
15
  import { killDescendants } from './scope.js';
15
16
  import { quoted } from './shell.js';
16
17
  import { SignIns } from './sign-in.js';
@@ -29,13 +30,32 @@ async function installShim(path, module) {
29
30
  await mkdir(dirname(path), { recursive: true });
30
31
  await writeFile(path, `#!/bin/sh\nexec ${quoted(process.execPath)} ${quoted(main)} "$@"\n`, { mode: 0o755 });
31
32
  }
33
+ function claimed(lock) {
34
+ try {
35
+ lock.exec('BEGIN EXCLUSIVE');
36
+ return true;
37
+ }
38
+ catch (error) {
39
+ if (error.errcode === 5)
40
+ return false;
41
+ throw error;
42
+ }
43
+ }
32
44
  async function serveOwner(copies) {
33
- const socketPath = join(kitHome(), 'owner.sock');
34
- await rm(socketPath, { force: true });
45
+ const lock = new DatabaseSync(ownerLock());
46
+ if (!claimed(lock)) {
47
+ lock.close();
48
+ const running = await runningResident();
49
+ throw new Error(`${running === null ? 'another Kit' : `Kit ${running}`} already runs this Environment from Kit home ${kitHome()}; stop it first to run another here`);
50
+ }
35
51
  const server = createServer(async (request, response) => {
36
52
  try {
37
53
  const text = await received(request);
38
54
  let answered;
55
+ if (request.url === '/resident') {
56
+ response.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify({ pid: process.pid }));
57
+ return;
58
+ }
39
59
  if (request.url === '/git/fetch') {
40
60
  answered = await copies.fetch();
41
61
  }
@@ -53,9 +73,23 @@ async function serveOwner(copies) {
53
73
  response.writeHead(502).end(error instanceof Error ? error.message : String(error));
54
74
  }
55
75
  });
56
- server.listen(socketPath);
76
+ server.on('close', () => lock.close());
77
+ await rm(ownerSocket(), { force: true });
78
+ server.listen(ownerSocket());
57
79
  await once(server, 'listening');
58
80
  }
81
+ function runningResident() {
82
+ return new Promise((resolve, reject) => {
83
+ get({ socketPath: ownerSocket(), path: '/resident' }, (answer) => {
84
+ received(answer).then((text) => resolve(JSON.parse(text).pid), reject);
85
+ }).on('error', (error) => {
86
+ if (error.code === 'ENOENT' || error.code === 'ECONNREFUSED')
87
+ resolve(null);
88
+ else
89
+ reject(error);
90
+ });
91
+ });
92
+ }
59
93
  function connected() {
60
94
  return new Promise((resolve) => {
61
95
  const watcher = watch(kitHome(), () => {
@@ -72,7 +106,7 @@ function connected() {
72
106
  resolve();
73
107
  });
74
108
  }
75
- export async function resident() {
109
+ async function started() {
76
110
  await connected();
77
111
  await forgetRestart();
78
112
  watch(kitHome(), () => {
@@ -83,13 +117,20 @@ export async function resident() {
83
117
  });
84
118
  await placeSkillSet();
85
119
  await mkdir(agentBase(), { recursive: true });
86
- process.env.HOUSE_KIT_RESIDENT = String(process.pid);
87
- const agents = new Agents(house, () => changed());
88
- const copies = new LocalCopies(house);
89
- await copies.load();
90
120
  await installShim(join(kitHome(), 'shim', 'git'), 'git-main');
91
121
  await installShim(codexLauncher(), 'codex-main');
122
+ }
123
+ export async function resident() {
124
+ await mkdir(kitHome(), { recursive: true, mode: 0o700 });
125
+ const copies = new LocalCopies(house);
126
+ await copies.load();
92
127
  await serveOwner(copies);
128
+ await started().catch((error) => {
129
+ report(error);
130
+ process.exit(1);
131
+ });
132
+ process.env.HOUSE_KIT_RESIDENT = String(process.pid);
133
+ const agents = new Agents(house, () => changed());
93
134
  let stream = null;
94
135
  let reported = false;
95
136
  const idle = () => conversations.idle() && signIns.idle() && agents.idle();
@@ -132,6 +173,8 @@ export async function resident() {
132
173
  frame: (arrived) => {
133
174
  if (arrived.type === 'watching')
134
175
  conversations.watching(arrived.watching === true);
176
+ if (arrived.type === 'authority_changed')
177
+ logged(copies.connected());
135
178
  if (arrived.type === 'work_available' && arrived.subject === 'agents')
136
179
  logged(agents.refresh());
137
180
  if (arrived.type === 'input') {
package/dist/skills.js CHANGED
@@ -1,17 +1,31 @@
1
+ import { createHash } from 'node:crypto';
1
2
  import { readFileSync } from 'node:fs';
2
- import { cp, lstat, mkdir, readdir, realpath, rm, symlink, writeFile } from 'node:fs/promises';
3
+ import { cp, lstat, mkdir, readdir, realpath, rm, symlink } from 'node:fs/promises';
3
4
  import { homedir } from 'node:os';
4
5
  import { join, relative } from 'node:path';
5
6
  import { fileURLToPath } from 'node:url';
7
+ import { parse } from 'yaml';
6
8
  import { KIT_VERSION } from './clis.js';
7
9
  import { kitHome, readConfiguration, readHome, writeHome } from './home.js';
8
10
  import { refusalOf } from './refusals.js';
9
- export const HOW_WE_WORK = '/rooms/private/how-we-work.md';
11
+ const HOW_WE_WORK = '/rooms/private/how-we-work.md';
10
12
  const SKILL_SET = fileURLToPath(new URL('../skills/', import.meta.url));
11
13
  const HOW_WE_WORK_TEXT = readFileSync(new URL('../how-we-work.md', import.meta.url), 'utf8');
14
+ const SHIPPED_HOW_WE_WORK = [
15
+ 'ae4dda60da7b174f22dc5fa9bf07fc27c25864932a74230de4f9f509ddd91f41',
16
+ '0bdcd43e1603ba6673a3cae56d70bbf90657cbeefd124e91a47be2ca1cbd6c93',
17
+ '4106a87ec66da6f7b2a10e74d18e6559d68d5f4fe7415dae68f5c7bdb9081968',
18
+ 'ac814a2197038f037b657bb719340395f89f319ac9fcdd386629c3fe2cec68f1',
19
+ '29951ee394aad9979eecfed3e5dc32c2c86e2226b6a380db5dbd4f305f4d1156',
20
+ ];
12
21
  const RECORD = 'skill-set.json';
13
- const CREATED = 'how-we-work-created';
22
+ const WRITTEN = 'how-we-work.json';
14
23
  const UNWRITABLE = new Set(['room_not_found', 'operation_denied']);
24
+ const PRESENT = new Set(['path_exists']);
25
+ const CHANGED = new Set(['base_revision_stale', 'path_absent']);
26
+ const UNREADABLE = /^(?:\S+: )?(?:path_not_found|room_not_found|operation_denied)\b/;
27
+ const FAILED = /^exit: [1-9]\d*$/;
28
+ const CUT = /^stderr: shell: output_cut (\d+) of \d+ bytes; continue with: (.+)$/;
15
29
  function skillsDirectory() {
16
30
  return join(homedir(), '.agents', 'skills');
17
31
  }
@@ -49,6 +63,14 @@ async function install() {
49
63
  await writeHome(RECORD, { version: KIT_VERSION, names });
50
64
  }
51
65
  export async function placeSkillSet() {
66
+ try {
67
+ await replaceSkillSet();
68
+ }
69
+ catch (error) {
70
+ process.stderr.write(`kit: the skills could not be placed: ${error.message}\n`);
71
+ }
72
+ }
73
+ async function replaceSkillSet() {
52
74
  const accepted = (await readConfiguration()).skills;
53
75
  const installed = await readHome(RECORD);
54
76
  if (accepted && installed?.version === KIT_VERSION)
@@ -62,17 +84,64 @@ export async function placeSkillSet() {
62
84
  else
63
85
  await rm(join(kitHome(), RECORD), { force: true });
64
86
  }
87
+ function sha256(text) {
88
+ return createHash('sha256').update(text).digest('hex');
89
+ }
90
+ function cutOf(lines) {
91
+ const cut = CUT.exec(lines[0] ?? '');
92
+ return cut !== null && Buffer.byteLength(lines.slice(1).join('\n')) === Number(cut[1]) ? cut : null;
93
+ }
94
+ export async function readHowWeWork(bridge) {
95
+ let document = '';
96
+ for (let command = `cat ${HOW_WE_WORK}`; command !== undefined;) {
97
+ const read = await bridge.tool('shell', { command });
98
+ const text = read.content.map((content) => content.text).join('\n');
99
+ const lines = text.split('\n');
100
+ if (read.isError === true || (FAILED.test(lines[0] ?? '') && lines[1]?.startsWith('stderr: '))) {
101
+ const refusal = read.isError === true ? text : lines.slice(1).join('\n').replace(/^stderr: /gm, '');
102
+ if (UNREADABLE.test(refusal))
103
+ return '';
104
+ throw new Error(refusal);
105
+ }
106
+ const cut = cutOf(lines);
107
+ document += lines.slice(cut === null ? 0 : 1).join('\n');
108
+ command = cut?.[2];
109
+ }
110
+ return document;
111
+ }
112
+ async function currentRevision(bridge) {
113
+ const inspected = await bridge.tool('inspect', { path: HOW_WE_WORK });
114
+ const text = inspected.content.map((content) => content.text).join('\n');
115
+ if (inspected.isError === true)
116
+ throw new Error(text);
117
+ return parse(text).revisions[0].revision;
118
+ }
119
+ async function edit(bridge, change, kept) {
120
+ const edited = await bridge.tool('edit', { changes: [{ ...change, path: HOW_WE_WORK, content: HOW_WE_WORK_TEXT }] });
121
+ if (edited.isError !== true)
122
+ return 'written';
123
+ const text = edited.content.map((content) => content.text).join('\n');
124
+ const refusal = refusalOf(text);
125
+ if (UNWRITABLE.has(refusal?.code ?? ''))
126
+ return 'unwritable';
127
+ if (refusal?.code === 'edit_conflict' && refusal.conflicts.some((conflict) => kept.has(conflict)))
128
+ return 'kept';
129
+ throw new Error(text);
130
+ }
65
131
  export async function createHowWeWork(bridge) {
66
- if ((await readHome(RECORD)) === null || (await present(join(kitHome(), CREATED))))
132
+ if (!(await readConfiguration()).skills || (await readHome(RECORD))?.version === undefined)
133
+ return;
134
+ const current = sha256(HOW_WE_WORK_TEXT);
135
+ if ((await readHome(WRITTEN)) === current)
136
+ return;
137
+ const created = await edit(bridge, { op: 'create' }, PRESENT);
138
+ if (created === 'unwritable')
67
139
  return;
68
- const created = await bridge.tool('edit', { changes: [{ op: 'create', path: HOW_WE_WORK, content: HOW_WE_WORK_TEXT }] });
69
- if (created.isError === true) {
70
- const text = created.content.map((content) => content.text).join('\n');
71
- const refusal = refusalOf(text);
72
- if (UNWRITABLE.has(refusal?.code ?? ''))
140
+ if (created === 'kept') {
141
+ const base = await currentRevision(bridge);
142
+ const held = sha256(await readHowWeWork(bridge));
143
+ if (held !== current && SHIPPED_HOW_WE_WORK.includes(held) && (await edit(bridge, { op: 'replace', base }, CHANGED)) === 'unwritable')
73
144
  return;
74
- if (refusal?.code !== 'edit_conflict' || !refusal.conflicts.includes('path_exists'))
75
- throw new Error(text);
76
145
  }
77
- await writeFile(join(kitHome(), CREATED), '');
146
+ await writeHome(WRITTEN, current);
78
147
  }
package/dist/stream.js CHANGED
@@ -7,6 +7,36 @@ import { KIT_WIRE, tooOld } from './wire.js';
7
7
  const PATH = '/kit/stream';
8
8
  const SUBPROTOCOL = `house.kit.stream.${KIT_WIRE}`;
9
9
  const REFUSAL_HEADER = 'x-house-refusal';
10
+ // House beats each stream every thirty seconds, so two silent beats mean this Kit cannot hear House.
11
+ export const STREAM_SILENCE_MS = 60_000;
12
+ const SYSTEM_STREAM_CLOCK = {
13
+ later: (delay, callback) => setTimeout(callback, delay),
14
+ clear: (timer) => clearTimeout(timer),
15
+ };
16
+ export class StreamSilence {
17
+ timer = null;
18
+ silent;
19
+ clock;
20
+ interval;
21
+ constructor(silent, clock = SYSTEM_STREAM_CLOCK, interval = STREAM_SILENCE_MS) {
22
+ this.silent = silent;
23
+ this.clock = clock;
24
+ this.interval = interval;
25
+ }
26
+ heard() {
27
+ this.stop();
28
+ this.timer = this.clock.later(this.interval, () => {
29
+ this.timer = null;
30
+ this.silent();
31
+ });
32
+ }
33
+ stop() {
34
+ if (this.timer === null)
35
+ return;
36
+ this.clock.clear(this.timer);
37
+ this.timer = null;
38
+ }
39
+ }
10
40
  function streamUrl(house) {
11
41
  const url = new URL(PATH, house);
12
42
  url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
@@ -37,17 +67,10 @@ export function holdStream(handlers) {
37
67
  headers: { authorization: `Bearer ${credential}` },
38
68
  });
39
69
  let opened = false;
40
- opening.onopen = () => {
41
- opened = true;
42
- failures = 0;
43
- socket = opening;
44
- handlers.opened();
45
- };
46
- opening.onmessage = (event) => {
47
- handlers.frame(JSON.parse(String(event.data)));
48
- };
49
- opening.onerror = () => undefined;
50
- opening.onclose = (event) => {
70
+ let silence = null;
71
+ const closed = (event) => {
72
+ silence?.stop();
73
+ silence = null;
51
74
  if (socket === opening)
52
75
  socket = null;
53
76
  process.stderr.write(`kit: control stream closed ${event.code} ${event.reason}\n`);
@@ -58,12 +81,35 @@ export function holdStream(handlers) {
58
81
  return;
59
82
  }
60
83
  if (refused !== null && tooOld(refused.text))
61
- updateRequired(house);
84
+ updateRequired();
62
85
  if (finalRefusal(refused))
63
86
  end(refused.message);
64
87
  // 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.
65
88
  setTimeout(() => void connect(), opened ? 1000 + Math.random() * 2000 : retryDelay(failures++));
66
89
  };
90
+ opening.onopen = () => {
91
+ opened = true;
92
+ failures = 0;
93
+ socket = opening;
94
+ silence = new StreamSilence(() => {
95
+ if (socket !== opening)
96
+ return;
97
+ socket = null;
98
+ opening.onclose = null;
99
+ opening.close();
100
+ closed(new CloseEvent('close', { code: 1006, reason: 'heartbeat_missed' }));
101
+ });
102
+ silence.heard();
103
+ handlers.opened();
104
+ };
105
+ opening.onmessage = (event) => {
106
+ silence?.heard();
107
+ const frame = JSON.parse(String(event.data));
108
+ if (frame.type !== 'beat')
109
+ handlers.frame(frame);
110
+ };
111
+ opening.onerror = () => undefined;
112
+ opening.onclose = closed;
67
113
  };
68
114
  void connect();
69
115
  return {
@@ -49,10 +49,10 @@ async function executed(command, args, signal) {
49
49
  function present(path) {
50
50
  return stat(path).then(() => true, () => false);
51
51
  }
52
- async function cpus() {
52
+ async function threads() {
53
53
  const [quota, period] = (await readFile('/sys/fs/cgroup/cpu.max', 'utf8').catch(() => 'max')).split(' ');
54
54
  const allowed = quota === 'max' ? Infinity : Math.ceil(Number(quota) / Number(period));
55
- return Math.min(availableParallelism(), allowed);
55
+ return Math.max(1, Math.floor(Math.min(availableParallelism(), allowed) / 2));
56
56
  }
57
57
  async function sha256(path) {
58
58
  const hash = createHash('sha256');
@@ -140,7 +140,7 @@ async function transcribed(path, signal) {
140
140
  await executed(installed(pinned.decoder), ['-nostdin', '-hide_banner', '-loglevel', 'error', '-i', path, '-ar', '16000', '-ac', '1', '-c:a', 'pcm_s16le',
141
141
  '-f', 'segment', '-segment_time', String(CHUNK_SECONDS), join(work, '%05d.wav')], signal);
142
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);
143
+ const text = await executed(installed(pinned.engine), ['-t', String(await threads()), '-np', '-m', installed(MODEL), ...parts], signal);
144
144
  return text
145
145
  .split('\n')
146
146
  .map((line) => line.trim())
package/dist/update.js CHANGED
@@ -75,6 +75,7 @@ function rerun(script, inputId, flags) {
75
75
  '--quiet',
76
76
  `--unit=${unit(inputId)}`,
77
77
  `--setenv=HOME=${homedir()}`,
78
+ `--setenv=HOUSE_KIT_HOME=${kitHome()}`,
78
79
  '/bin/sh',
79
80
  '-c',
80
81
  record(),
package/dist/wire.js CHANGED
@@ -1,5 +1,5 @@
1
1
  import { refusalOf } from './refusals.js';
2
- export const KIT_WIRE = 1;
2
+ export const KIT_WIRE = 2;
3
3
  export const KIT_WIRE_HEADER = 'x-house-kit-wire';
4
4
  export function tooOld(text) {
5
5
  return refusalOf(text)?.code === 'kit_update_required';
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');