@agentshouse/kit 0.2.1-cd646adba3f64 → 0.2.1-cdc381ebf021f

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 (141) hide show
  1. package/README.md +42 -48
  2. package/dist/acp.js +102 -108
  3. package/dist/afk.js +17 -0
  4. package/dist/agents.js +227 -68
  5. package/dist/api.js +19 -10
  6. package/dist/app-git.js +10 -26
  7. package/dist/bridge.js +18 -47
  8. package/dist/building.js +50 -0
  9. package/dist/calls.js +88 -0
  10. package/dist/chunks.js +49 -0
  11. package/dist/clis.js +157 -100
  12. package/dist/codex-main.js +58 -0
  13. package/dist/connect.js +108 -0
  14. package/dist/connection.js +120 -0
  15. package/dist/content.js +106 -0
  16. package/dist/conversations.js +815 -335
  17. package/dist/copies.js +439 -232
  18. package/dist/earlier.js +263 -0
  19. package/dist/end.js +23 -5
  20. package/dist/events.js +793 -0
  21. package/dist/files.js +139 -17
  22. package/dist/git.js +57 -21
  23. package/dist/grok.js +39 -0
  24. package/dist/home.js +122 -8
  25. package/dist/house-cli.js +359 -0
  26. package/dist/house-main.js +7 -159
  27. package/dist/instructions.js +7 -11
  28. package/dist/kit-cli.js +78 -0
  29. package/dist/kit-main.js +8 -22
  30. package/dist/login.js +132 -107
  31. package/dist/logout.js +15 -17
  32. package/dist/mcp.js +6 -2
  33. package/dist/owner.js +46 -0
  34. package/dist/placement.js +25 -0
  35. package/dist/relay.js +33 -2
  36. package/dist/resident.js +160 -58
  37. package/dist/scope.js +214 -0
  38. package/dist/scripts.js +303 -0
  39. package/dist/secret-input.js +1 -1
  40. package/dist/settings.js +188 -0
  41. package/dist/sign-in.js +40 -33
  42. package/dist/silence.js +28 -0
  43. package/dist/skills.js +49 -35
  44. package/dist/supervisor.js +163 -0
  45. package/dist/transcription.js +90 -47
  46. package/dist/translate.js +19 -16
  47. package/dist/update.js +119 -102
  48. package/dist/wire.js +32 -0
  49. package/dist/work.js +353 -0
  50. package/dist/workspace.js +103 -0
  51. package/package.json +25 -21
  52. package/dist/authority-main.js +0 -22
  53. package/dist/blocks.js +0 -51
  54. package/dist/bootstrap.json +0 -24
  55. package/dist/clis-main.js +0 -23
  56. package/dist/configure-main.js +0 -6
  57. package/dist/enrol-main.js +0 -4
  58. package/dist/stream.js +0 -72
  59. package/how-we-work.md +0 -23
  60. package/skills/ask-matt/LICENSE +0 -21
  61. package/skills/ask-matt/PHASE-BOUNDARIES.md +0 -55
  62. package/skills/ask-matt/SKILL.md +0 -91
  63. package/skills/ask-matt/agents/openai.yaml +0 -4
  64. package/skills/code-review/LICENSE +0 -21
  65. package/skills/code-review/SKILL.md +0 -89
  66. package/skills/code-review/agents/openai.yaml +0 -3
  67. package/skills/codebase-design/DEEPENING.md +0 -37
  68. package/skills/codebase-design/DESIGN-IT-TWICE.md +0 -44
  69. package/skills/codebase-design/LICENSE +0 -21
  70. package/skills/codebase-design/SKILL.md +0 -116
  71. package/skills/codebase-design/agents/openai.yaml +0 -3
  72. package/skills/diagnosing-bugs/LICENSE +0 -21
  73. package/skills/diagnosing-bugs/SKILL.md +0 -140
  74. package/skills/diagnosing-bugs/agents/openai.yaml +0 -3
  75. package/skills/diagnosing-bugs/scripts/hitl-loop.template.sh +0 -44
  76. package/skills/domain-modeling/ADR-FORMAT.md +0 -47
  77. package/skills/domain-modeling/CONTEXT-FORMAT.md +0 -60
  78. package/skills/domain-modeling/LICENSE +0 -21
  79. package/skills/domain-modeling/SKILL.md +0 -76
  80. package/skills/domain-modeling/agents/openai.yaml +0 -3
  81. package/skills/grill-me/LICENSE +0 -21
  82. package/skills/grill-me/SKILL.md +0 -8
  83. package/skills/grill-me/agents/openai.yaml +0 -4
  84. package/skills/grill-with-docs/LICENSE +0 -21
  85. package/skills/grill-with-docs/SKILL.md +0 -8
  86. package/skills/grill-with-docs/agents/openai.yaml +0 -4
  87. package/skills/grilling/LICENSE +0 -21
  88. package/skills/grilling/SKILL.md +0 -30
  89. package/skills/grilling/agents/openai.yaml +0 -3
  90. package/skills/handoff/LICENSE +0 -21
  91. package/skills/handoff/SKILL.md +0 -17
  92. package/skills/handoff/agents/openai.yaml +0 -4
  93. package/skills/implement/LICENSE +0 -21
  94. package/skills/implement/SKILL.md +0 -16
  95. package/skills/implement/agents/openai.yaml +0 -4
  96. package/skills/improve-codebase-architecture/HTML-REPORT.md +0 -123
  97. package/skills/improve-codebase-architecture/LICENSE +0 -21
  98. package/skills/improve-codebase-architecture/SKILL.md +0 -72
  99. package/skills/improve-codebase-architecture/agents/openai.yaml +0 -4
  100. package/skills/prototype/LICENSE +0 -21
  101. package/skills/prototype/LOGIC.md +0 -67
  102. package/skills/prototype/SKILL.md +0 -28
  103. package/skills/prototype/UI.md +0 -112
  104. package/skills/prototype/agents/openai.yaml +0 -3
  105. package/skills/research/LICENSE +0 -21
  106. package/skills/research/SKILL.md +0 -14
  107. package/skills/research/agents/openai.yaml +0 -3
  108. package/skills/resolving-merge-conflicts/LICENSE +0 -21
  109. package/skills/resolving-merge-conflicts/SKILL.md +0 -16
  110. package/skills/resolving-merge-conflicts/agents/openai.yaml +0 -3
  111. package/skills/tdd/LICENSE +0 -21
  112. package/skills/tdd/SKILL.md +0 -40
  113. package/skills/tdd/agents/openai.yaml +0 -3
  114. package/skills/tdd/mocking.md +0 -59
  115. package/skills/tdd/tests.md +0 -77
  116. package/skills/teach/GLOSSARY-FORMAT.md +0 -35
  117. package/skills/teach/LEARNING-RECORD-FORMAT.md +0 -46
  118. package/skills/teach/LICENSE +0 -21
  119. package/skills/teach/MISSION-FORMAT.md +0 -31
  120. package/skills/teach/RESOURCES-FORMAT.md +0 -32
  121. package/skills/teach/SKILL.md +0 -141
  122. package/skills/teach/agents/openai.yaml +0 -4
  123. package/skills/to-questionnaire/LICENSE +0 -21
  124. package/skills/to-questionnaire/SKILL.md +0 -55
  125. package/skills/to-questionnaire/agents/openai.yaml +0 -4
  126. package/skills/to-spec/LICENSE +0 -21
  127. package/skills/to-spec/SKILL.md +0 -76
  128. package/skills/to-spec/agents/openai.yaml +0 -4
  129. package/skills/to-tickets/LICENSE +0 -21
  130. package/skills/to-tickets/SKILL.md +0 -106
  131. package/skills/to-tickets/agents/openai.yaml +0 -4
  132. package/skills/wait-what/LICENSE +0 -21
  133. package/skills/wait-what/SKILL.md +0 -8
  134. package/skills/wait-what/agents/openai.yaml +0 -4
  135. package/skills/wayfinder/LICENSE +0 -21
  136. package/skills/wayfinder/SKILL.md +0 -129
  137. package/skills/wayfinder/agents/openai.yaml +0 -4
  138. package/skills/writing-for-agents/LICENSE +0 -21
  139. package/skills/writing-for-agents/SKILL-MECHANICS.md +0 -22
  140. package/skills/writing-for-agents/SKILL.md +0 -83
  141. package/skills/writing-for-agents/agents/openai.yaml +0 -3
package/dist/login.js CHANGED
@@ -1,54 +1,31 @@
1
+ import { KIT_LOGIN_PATHS, } from '@agentshouse/kit-wire';
2
+ import { spawn } from 'node:child_process';
1
3
  import { createHash, randomBytes } from 'node:crypto';
2
- import { createServer } from 'node:http';
3
- import { hostname } from 'node:os';
4
- import { createInterface } from 'node:readline/promises';
5
4
  import { parseArgs } from 'node:util';
6
- import { post } from './api.js';
5
+ import { HouseRefusal, post, retrying } from './api.js';
7
6
  import { placeAppGit } from './app-git.js';
8
- import { forgetOwnAgent, readDisconnected, readEnrolment, readOwnAgent, writeEnrolment, writeOwnAgent } from './home.js';
7
+ import { writeCodexRule } from './clis.js';
8
+ import { forgetDisconnected, forgetOwnAgent, readDisconnected, readEnrolment, readOwnAgent, writeEnrolment, writeOwnAgent, } from './home.js';
9
9
  import { callHouse, rpc } from './mcp.js';
10
- const DEFAULT_HOUSE = 'https://agents.house';
11
- function listen() {
12
- return new Promise((resolve, reject) => {
13
- let deliver = () => undefined;
14
- let held = null;
15
- const code = new Promise((settle) => {
16
- deliver = settle;
17
- });
18
- const server = createServer((request, response) => {
19
- const received = new URL(request.url ?? '/', 'http://127.0.0.1').searchParams.get('code');
20
- if (received === null || held !== null) {
21
- response.writeHead(404).end();
22
- return;
23
- }
24
- held = response;
25
- deliver(received);
26
- });
27
- const close = () => {
28
- server.close();
29
- server.closeAllConnections();
30
- };
31
- const port = Number(process.env.HOUSE_KIT_LOGIN_PORT ?? 0);
32
- server.once('error', reject);
33
- server.listen(port, port === 0 ? '127.0.0.1' : '0.0.0.0', () => {
34
- const address = server.address();
35
- if (address === null || typeof address === 'string') {
36
- reject(new Error('the login callback has no port'));
37
- return;
38
- }
39
- resolve({
40
- uri: `http://127.0.0.1:${address.port}/callback`,
41
- code,
42
- answer: (text) => new Promise((written) => {
43
- if (held === null || held.destroyed || !held.socket || held.socket.destroyed)
44
- return written();
45
- held.once('close', () => written());
46
- held.writeHead(200, { 'content-type': 'text/plain; charset=utf-8', connection: 'close' }).end(`${text}\n`);
47
- }),
48
- close,
49
- });
50
- });
51
- });
10
+ import { refusalOf } from './refusals.js';
11
+ import { selectRelay } from './relay.js';
12
+ import { startService } from './supervisor.js';
13
+ import { placeSkillSet } from './skills.js';
14
+ import { endUnserved } from './wire.js';
15
+ export const DEFAULT_HOUSE = 'https://agents.house';
16
+ const OPENER = process.platform === 'darwin' ? 'open' : 'xdg-open';
17
+ // Polling every two seconds brings the User's confirmation to the waiting Kit moments after they give it.
18
+ const POLL_INTERVAL_MS = 2000;
19
+ function startLogin(house, request) {
20
+ return post(house, KIT_LOGIN_PATHS.start, request);
21
+ }
22
+ function pollLogin(house, request) {
23
+ return post(house, KIT_LOGIN_PATHS.poll, request);
24
+ }
25
+ function open(link) {
26
+ spawn(OPENER, [link], { detached: true, stdio: 'ignore' })
27
+ .on('error', () => undefined)
28
+ .unref();
52
29
  }
53
30
  async function accepted(house, credential) {
54
31
  const checked = await callHouse(house, credential, rpc('tools/list', {}));
@@ -56,19 +33,33 @@ async function accepted(house, credential) {
56
33
  return true;
57
34
  if (checked.status === 401)
58
35
  return false;
36
+ endUnserved(checked.text);
59
37
  throw new Error(`House answered ${checked.status} when Kit checked this computer's own agent's connection: ${checked.text}`);
60
38
  }
61
- async function typed(question) {
62
- const reader = createInterface({ input: process.stdin, output: process.stdout });
63
- const closed = new Promise((_, reject) => {
64
- reader.once('close', () => reject(new Error('no code was typed')));
65
- });
66
- try {
67
- return (await Promise.race([reader.question(question), closed])).trim();
68
- }
69
- finally {
70
- reader.close();
71
- }
39
+ const USAGE = `usage: kit login [--house <origin>] [--environment <id>] [--rooms <ref>[,<ref>...] | --no-private]
40
+ kit login [--house <origin>] --code <code>
41
+ --house <origin> the House to connect to, ${DEFAULT_HOUSE} unless one is stored
42
+ --environment <id> reconnect this Environment
43
+ --rooms <ref>[,<ref>...] give this Environment only these Rooms
44
+ --no-private give this Environment every Room but your Private Room
45
+ --code <code> connect this machine with a login code
46
+ `;
47
+ function connected(house, named, environment) {
48
+ if (named === undefined)
49
+ return `Environment ${environment} is connected to ${house}.\n`;
50
+ if (named === environment)
51
+ return `Environment ${environment} is reconnected to ${house}.\n`;
52
+ return `Environment ${named} stays with its account; this computer is connected to ${house} as new Environment ${environment} of the account that confirmed.\n`;
53
+ }
54
+ function gone(error) {
55
+ return error instanceof HouseRefusal && refusalOf(error.text)?.code === 'kit_environment_not_found';
56
+ }
57
+ function chosenRooms(rooms, noPrivate) {
58
+ if (rooms !== undefined && noPrivate)
59
+ throw new Error('--rooms and --no-private are two choices of Rooms; pass one');
60
+ if (rooms !== undefined)
61
+ return { rooms: { reach: 'selected', refs: rooms.split(',') } };
62
+ return noPrivate ? { rooms: { reach: 'all_but_private' } } : {};
72
63
  }
73
64
  export async function login(argv) {
74
65
  const { values } = parseArgs({
@@ -76,65 +67,99 @@ export async function login(argv) {
76
67
  options: {
77
68
  house: { type: 'string' },
78
69
  environment: { type: 'string' },
79
- manual: { type: 'boolean', default: false },
70
+ rooms: { type: 'string' },
71
+ 'no-private': { type: 'boolean', default: false },
72
+ code: { type: 'string' },
73
+ help: { type: 'boolean', default: false },
80
74
  },
81
75
  });
76
+ if (values.help) {
77
+ process.stdout.write(USAGE);
78
+ return;
79
+ }
80
+ const house = await enrol(values);
81
+ await placeConnection(house);
82
+ try {
83
+ startService();
84
+ }
85
+ catch (error) {
86
+ process.stderr.write(`kit: ${error.message}\n`);
87
+ }
88
+ }
89
+ export async function placeConnection(house) {
90
+ await placeSkillSet(house);
91
+ await writeCodexRule().catch((error) => process.stderr.write(`kit: ${error.message}\n`));
92
+ await placeAppGit(await readOwnAgent()).catch((error) => process.stderr.write(`kit: ${error.message}\n`));
93
+ }
94
+ export async function enrol(values) {
95
+ if (values.code !== undefined && values.rooms !== undefined)
96
+ throw new Error('--code cannot be used with --rooms');
97
+ if (values.code !== undefined && values['no-private'])
98
+ throw new Error('--code cannot be used with --no-private');
99
+ if (values.code !== undefined && values.environment !== undefined)
100
+ throw new Error('--code cannot be used with --environment');
101
+ const rooms = chosenRooms(values.rooms, values['no-private']);
82
102
  const enrolled = (await readEnrolment()) ?? (await readDisconnected());
103
+ if (values.code !== undefined && enrolled !== null) {
104
+ throw new Error(`--code connects a new machine; this Kit home records Environment ${enrolled.environment}, so run kit login to reconnect it`);
105
+ }
106
+ const relay = process.env.HOUSE_KIT_RELAY || undefined;
107
+ selectRelay(relay);
83
108
  const house = values.house ?? enrolled?.house ?? DEFAULT_HOUSE;
84
- const replaces = process.env.HOUSE_KIT_REPLACES;
85
- const environment = replaces === undefined ? (values.environment ?? (enrolled?.house === house ? enrolled.environment : undefined)) : undefined;
109
+ const remembered = values.environment === undefined && enrolled?.house === house ? enrolled.environment : undefined;
110
+ const environment = values.environment ?? remembered;
111
+ if (environment !== undefined && rooms.rooms !== undefined) {
112
+ throw new Error(`Environment ${environment} keeps its Rooms; change them on its page in House`);
113
+ }
86
114
  const ownAgent = await readOwnAgent();
87
- const held = ownAgent !== null && ownAgent.house === house && (await accepted(house, ownAgent.credential));
88
- const verifier = randomBytes(32).toString('base64url');
89
- const started = {
90
- ...(environment === undefined
91
- ? { act: 'new_environment', label: hostname(), ...(replaces === undefined ? {} : { replaces }) }
92
- : { act: 'existing_environment', environment_id: environment }),
93
- code_challenge: createHash('sha256').update(verifier).digest('base64url'),
94
- ...(held ? {} : { headless: true }),
95
- };
96
- const exchange = async (code) => {
97
- const exchanged = await post(house, '/kit/token', { code, code_verifier: verifier });
98
- await writeEnrolment({ house, environment: exchanged.environment, credential: exchanged.credential });
99
- process.stdout.write(`Environment ${exchanged.environment} is connected to ${house}.\n`);
100
- if (exchanged.headless_credential !== undefined) {
101
- await writeOwnAgent({ house, user: exchanged.user, credential: exchanged.headless_credential });
102
- }
103
- else if (held && ownAgent.user !== exchanged.user) {
104
- await forgetOwnAgent();
105
- process.stdout.write("This computer's own agent was another User's; run kit login again to connect it to you.\n");
106
- }
107
- };
108
- const placeGit = async () => placeAppGit(ownAgent, await readOwnAgent());
109
- if (values.manual) {
110
- const { start_url } = await post(house, '/kit', {
111
- ...started,
112
- presentation: 'manual',
113
- });
114
- process.stdout.write(`Open this link and confirm: ${start_url}\n`);
115
- await exchange(await typed('Code: '));
116
- await placeGit();
117
- return;
115
+ let held = false;
116
+ let named = environment;
117
+ let exchanged;
118
+ if (values.code !== undefined) {
119
+ exchanged = await pollLogin(house, { code: values.code });
118
120
  }
119
- const callback = await listen();
120
- try {
121
- const { start_url } = await post(house, '/kit', {
122
- ...started,
123
- presentation: 'loopback',
124
- loopback_uri: callback.uri,
125
- });
126
- process.stdout.write(`Open this link and confirm: ${start_url}\n`);
121
+ else {
122
+ held = ownAgent !== null && ownAgent.house === house && (await accepted(house, ownAgent.credential));
123
+ const verifier = randomBytes(32).toString('base64url');
124
+ const start = () => retrying(() => startLogin(house, {
125
+ ...(named === undefined ? { act: 'new_environment' } : { act: 'existing_environment', environment_id: named }),
126
+ ...rooms,
127
+ code_challenge: createHash('sha256').update(verifier).digest('base64url'),
128
+ ...(held ? {} : { headless: true }),
129
+ }));
130
+ let started;
127
131
  try {
128
- await exchange(await callback.code);
132
+ started = await start();
129
133
  }
130
134
  catch (error) {
131
- await callback.answer(`This Environment was not connected: ${error.message}`);
132
- throw error;
135
+ if (remembered === undefined || !gone(error))
136
+ throw error;
137
+ await forgetDisconnected();
138
+ process.stdout.write(`House no longer holds Environment ${remembered}; connecting this computer as a new one.\n`);
139
+ named = undefined;
140
+ started = await start();
133
141
  }
134
- await callback.answer('This Environment is connected. You can close this tab.');
142
+ process.stdout.write(`Open this link and confirm: ${started.start_url}\n`);
143
+ open(started.start_url);
144
+ exchanged = await retrying(() => pollLogin(house, { login: started.login, code_verifier: verifier }), undefined, () => POLL_INTERVAL_MS);
145
+ }
146
+ const relayRecord = relay === undefined ? {} : { relay };
147
+ await writeEnrolment({
148
+ house,
149
+ ...relayRecord,
150
+ environment: exchanged.environment,
151
+ credential: exchanged.credential,
152
+ });
153
+ process.stdout.write(connected(house, named, exchanged.environment));
154
+ if (exchanged.headless_credential !== undefined) {
155
+ await writeOwnAgent({ house, ...relayRecord, user: exchanged.user, credential: exchanged.headless_credential });
156
+ }
157
+ else if (held && ownAgent !== null && ownAgent.user !== exchanged.user) {
158
+ await forgetOwnAgent();
159
+ process.stdout.write("This computer's own agent was another User's; run kit login again to connect it to you.\n");
135
160
  }
136
- finally {
137
- callback.close();
161
+ else if (held && ownAgent !== null) {
162
+ await writeOwnAgent({ house, ...relayRecord, user: ownAgent.user, credential: ownAgent.credential });
138
163
  }
139
- await placeGit();
164
+ return house;
140
165
  }
package/dist/logout.js CHANGED
@@ -1,21 +1,19 @@
1
- import { HouseRefusal, post } from './api.js';
2
- import { forgetAppGit } from './app-git.js';
3
- import { forgetEnrolment, readEnrolment } from './home.js';
1
+ import { HouseRefusal, kitAct } from './api.js';
2
+ import { forgetEnrolment, forgetOwnAgent, readEnrolment } from './home.js';
4
3
  export async function logout() {
5
4
  const enrolled = await readEnrolment();
6
- if (enrolled === null) {
7
- await forgetAppGit();
8
- process.stdout.write('This computer is not connected to House.\n');
9
- return;
5
+ if (enrolled !== null) {
6
+ try {
7
+ await kitAct(enrolled.house, 'kits/log-out', {}, enrolled.credential);
8
+ }
9
+ catch (error) {
10
+ if (!(error instanceof HouseRefusal && error.status === 401))
11
+ throw error;
12
+ }
13
+ await forgetEnrolment(enrolled);
10
14
  }
11
- try {
12
- await post(enrolled.house, '/kit/logout', {}, enrolled.credential);
13
- }
14
- catch (error) {
15
- if (!(error instanceof HouseRefusal && error.status === 401))
16
- throw error;
17
- }
18
- await forgetEnrolment(enrolled);
19
- await forgetAppGit();
20
- process.stdout.write(`Environment ${enrolled.environment} is disconnected; kit login reconnects it.\n`);
15
+ await forgetOwnAgent();
16
+ process.stdout.write(enrolled === null
17
+ ? 'This computer is not connected to House.\n'
18
+ : `Environment ${enrolled.environment} is disconnected; kit login reconnects it.\n`);
21
19
  }
package/dist/mcp.js CHANGED
@@ -1,8 +1,11 @@
1
+ import { KIT_WIRE, KIT_WIRE_HEADER } from '@agentshouse/kit-wire';
1
2
  import { randomUUID } from 'node:crypto';
2
- import { KIT_VERSION } from './clis.js';
3
+ import { KIT_RELEASE } from './clis.js';
3
4
  import { relayed } from './relay.js';
4
5
  const MCP_PROTOCOL_VERSION = '2026-07-28';
5
6
  export const UNREACHABLE = 'House is unreachable; call again in a minute';
7
+ export class Unsettled extends Error {
8
+ }
6
9
  export function rpc(method, params) {
7
10
  return { jsonrpc: '2.0', id: randomUUID(), method, params };
8
11
  }
@@ -13,7 +16,7 @@ export function mcpBody(message, operation) {
13
16
  ...message.params,
14
17
  _meta: {
15
18
  'io.modelcontextprotocol/protocolVersion': MCP_PROTOCOL_VERSION,
16
- 'io.modelcontextprotocol/clientInfo': { name: '@agentshouse/kit', version: KIT_VERSION },
19
+ 'io.modelcontextprotocol/clientInfo': { name: '@agentshouse/kit', version: KIT_RELEASE },
17
20
  'io.modelcontextprotocol/clientCapabilities': {},
18
21
  ...(operation === null ? {} : { 'agents.house/agent-operation': operation }),
19
22
  },
@@ -31,6 +34,7 @@ export async function callHouse(origin, credential, message, operation = null, s
31
34
  'mcp-protocol-version': MCP_PROTOCOL_VERSION,
32
35
  'mcp-method': message.method,
33
36
  ...(tool === null ? {} : { 'mcp-name': tool }),
37
+ [KIT_WIRE_HEADER]: KIT_WIRE,
34
38
  },
35
39
  body: mcpBody(message, operation),
36
40
  signal,
package/dist/owner.js ADDED
@@ -0,0 +1,46 @@
1
+ import { request } from 'node:http';
2
+ import { DatabaseSync } from 'node:sqlite';
3
+ import { received } from './bridge.js';
4
+ import { kitHome, ownerLock, ownerSocket } from './home.js';
5
+ function claimed(lock) {
6
+ try {
7
+ lock.exec('BEGIN EXCLUSIVE');
8
+ return true;
9
+ }
10
+ catch (error) {
11
+ if (error.errcode === 5)
12
+ return false;
13
+ throw error;
14
+ }
15
+ }
16
+ export function askOwner(path, body) {
17
+ return new Promise((resolve, reject) => {
18
+ const sent = request({ socketPath: ownerSocket(), path, method: body === undefined ? 'GET' : 'POST', headers: { 'content-type': 'application/json' } }, (answer) => {
19
+ received(answer).then((text) => {
20
+ if (answer.statusCode === 200)
21
+ resolve(JSON.parse(text));
22
+ else
23
+ reject(new Error(text));
24
+ }, reject);
25
+ });
26
+ sent.on('error', (error) => {
27
+ if (error.code === 'ENOENT' || error.code === 'ECONNREFUSED')
28
+ resolve(null);
29
+ else
30
+ reject(error);
31
+ });
32
+ sent.end(body === undefined ? undefined : JSON.stringify(body));
33
+ });
34
+ }
35
+ export async function holdOwner() {
36
+ const lock = new DatabaseSync(ownerLock());
37
+ if (claimed(lock))
38
+ return lock;
39
+ lock.close();
40
+ const running = (await askOwner('/resident'))?.pid ?? null;
41
+ throw new Error(`${running === null ? 'another Kit process' : `Kit process ${running}`} already runs this Environment from Kit home ${kitHome()}; stop it first to run another Kit process here`);
42
+ }
43
+ export async function runningRelease() {
44
+ const running = await askOwner('/resident');
45
+ return running === null ? null : (running.release ?? '');
46
+ }
@@ -0,0 +1,25 @@
1
+ import { readFileSync } from 'node:fs';
2
+ import { join, resolve } from 'node:path';
3
+ import { kitHome } from './home.js';
4
+ function recorded(name) {
5
+ try {
6
+ return readFileSync(join(kitHome(), name), 'utf8').trim();
7
+ }
8
+ catch (error) {
9
+ if (error.code === 'ENOENT')
10
+ return null;
11
+ throw error;
12
+ }
13
+ }
14
+ export function installCommand() {
15
+ return recorded('install-command');
16
+ }
17
+ export function placedPrefix() {
18
+ const prefix = process.env.HOUSE_KIT_PREFIX;
19
+ if (prefix === undefined || prefix === '')
20
+ throw new Error('this Kit process was not started by a launcher its installer placed');
21
+ return resolve(prefix);
22
+ }
23
+ export function releaseDirectory(release) {
24
+ return join(placedPrefix(), 'releases', release);
25
+ }
package/dist/relay.js CHANGED
@@ -1,7 +1,38 @@
1
+ import { setGlobalProxyFromEnv } from 'node:http';
2
+ const PROXY = /^https?_proxy$/i;
3
+ const LOOPBACK = ['127.0.0.1', 'localhost', '::1'];
4
+ let selected;
5
+ let restoreProxy;
6
+ export function selectRelay(relay) {
7
+ selected = relay === undefined || relay === '' ? null : relay;
8
+ proxyUnlessRelayed();
9
+ }
10
+ export function relayOrigin() {
11
+ if (selected !== undefined)
12
+ return selected ?? undefined;
13
+ const ambient = process.env.HOUSE_KIT_RELAY;
14
+ return ambient === undefined || ambient === '' ? undefined : ambient;
15
+ }
16
+ function unlessRelayed() {
17
+ if (relayOrigin() === undefined)
18
+ return { ...process.env };
19
+ return Object.fromEntries(Object.entries(process.env).filter(([name]) => !PROXY.test(name)));
20
+ }
21
+ export function proxyUnlessRelayed() {
22
+ restoreProxy?.();
23
+ restoreProxy = setGlobalProxyFromEnv(unlessRelayed());
24
+ }
25
+ export function childEnvironment() {
26
+ const environment = unlessRelayed();
27
+ if (!Object.keys(environment).some((name) => PROXY.test(name)))
28
+ return environment;
29
+ const bypassed = [environment.NO_PROXY ?? environment.no_proxy, ...LOOPBACK].filter((entry) => entry !== undefined && entry !== '').join(',');
30
+ return { ...environment, NO_PROXY: bypassed, no_proxy: bypassed };
31
+ }
1
32
  export function relayed(target) {
2
33
  const url = new URL(target);
3
- const relay = process.env.HOUSE_KIT_RELAY;
4
- if (relay === undefined || relay === '')
34
+ const relay = relayOrigin();
35
+ if (relay === undefined)
5
36
  return url;
6
37
  const through = new URL(`${url.host}${url.pathname}${url.search}`, `${relay}/`);
7
38
  if (url.protocol === 'wss:' || url.protocol === 'ws:')