@agentshouse/kit 0.2.1-cd9cbd8b6428c → 0.2.1-cdc3937dea52e

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 (145) hide show
  1. package/README.md +46 -49
  2. package/dist/acp.js +101 -108
  3. package/dist/afk.js +17 -0
  4. package/dist/agents.js +271 -73
  5. package/dist/api.js +43 -6
  6. package/dist/app-git.js +48 -0
  7. package/dist/bridge.js +42 -62
  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 +179 -95
  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 +817 -333
  17. package/dist/copies.js +451 -251
  18. package/dist/earlier.js +263 -0
  19. package/dist/end.js +26 -0
  20. package/dist/events.js +793 -0
  21. package/dist/files.js +139 -17
  22. package/dist/git-main.js +24 -29
  23. package/dist/git.js +57 -21
  24. package/dist/grok.js +39 -0
  25. package/dist/home.js +134 -9
  26. package/dist/house-cli.js +362 -0
  27. package/dist/house-main.js +7 -159
  28. package/dist/instructions.js +7 -11
  29. package/dist/keys.js +238 -0
  30. package/dist/kit-cli.js +78 -0
  31. package/dist/kit-main.js +8 -19
  32. package/dist/login.js +133 -104
  33. package/dist/logout.js +15 -14
  34. package/dist/mcp.js +6 -2
  35. package/dist/owner.js +46 -0
  36. package/dist/placement.js +25 -0
  37. package/dist/refusals.js +12 -0
  38. package/dist/relay.js +33 -2
  39. package/dist/resident.js +161 -61
  40. package/dist/scope.js +214 -0
  41. package/dist/scripts.js +303 -0
  42. package/dist/secret-input.js +5 -2
  43. package/dist/settings.js +188 -0
  44. package/dist/shell.js +3 -0
  45. package/dist/sign-in.js +85 -32
  46. package/dist/silence.js +28 -0
  47. package/dist/skills.js +49 -35
  48. package/dist/supervisor.js +163 -0
  49. package/dist/transcription.js +131 -40
  50. package/dist/translate.js +19 -16
  51. package/dist/update.js +119 -100
  52. package/dist/wire.js +32 -0
  53. package/dist/work.js +353 -0
  54. package/dist/workspace.js +103 -0
  55. package/package.json +26 -21
  56. package/dist/authority-main.js +0 -22
  57. package/dist/blocks.js +0 -51
  58. package/dist/bootstrap.json +0 -24
  59. package/dist/clis-main.js +0 -23
  60. package/dist/configure-main.js +0 -6
  61. package/dist/enrol-main.js +0 -4
  62. package/dist/stream.js +0 -47
  63. package/how-we-work.md +0 -23
  64. package/skills/ask-matt/LICENSE +0 -21
  65. package/skills/ask-matt/PHASE-BOUNDARIES.md +0 -55
  66. package/skills/ask-matt/SKILL.md +0 -91
  67. package/skills/ask-matt/agents/openai.yaml +0 -4
  68. package/skills/code-review/LICENSE +0 -21
  69. package/skills/code-review/SKILL.md +0 -89
  70. package/skills/code-review/agents/openai.yaml +0 -3
  71. package/skills/codebase-design/DEEPENING.md +0 -37
  72. package/skills/codebase-design/DESIGN-IT-TWICE.md +0 -44
  73. package/skills/codebase-design/LICENSE +0 -21
  74. package/skills/codebase-design/SKILL.md +0 -116
  75. package/skills/codebase-design/agents/openai.yaml +0 -3
  76. package/skills/diagnosing-bugs/LICENSE +0 -21
  77. package/skills/diagnosing-bugs/SKILL.md +0 -140
  78. package/skills/diagnosing-bugs/agents/openai.yaml +0 -3
  79. package/skills/diagnosing-bugs/scripts/hitl-loop.template.sh +0 -44
  80. package/skills/domain-modeling/ADR-FORMAT.md +0 -47
  81. package/skills/domain-modeling/CONTEXT-FORMAT.md +0 -60
  82. package/skills/domain-modeling/LICENSE +0 -21
  83. package/skills/domain-modeling/SKILL.md +0 -76
  84. package/skills/domain-modeling/agents/openai.yaml +0 -3
  85. package/skills/grill-me/LICENSE +0 -21
  86. package/skills/grill-me/SKILL.md +0 -8
  87. package/skills/grill-me/agents/openai.yaml +0 -4
  88. package/skills/grill-with-docs/LICENSE +0 -21
  89. package/skills/grill-with-docs/SKILL.md +0 -8
  90. package/skills/grill-with-docs/agents/openai.yaml +0 -4
  91. package/skills/grilling/LICENSE +0 -21
  92. package/skills/grilling/SKILL.md +0 -30
  93. package/skills/grilling/agents/openai.yaml +0 -3
  94. package/skills/handoff/LICENSE +0 -21
  95. package/skills/handoff/SKILL.md +0 -17
  96. package/skills/handoff/agents/openai.yaml +0 -4
  97. package/skills/implement/LICENSE +0 -21
  98. package/skills/implement/SKILL.md +0 -16
  99. package/skills/implement/agents/openai.yaml +0 -4
  100. package/skills/improve-codebase-architecture/HTML-REPORT.md +0 -123
  101. package/skills/improve-codebase-architecture/LICENSE +0 -21
  102. package/skills/improve-codebase-architecture/SKILL.md +0 -72
  103. package/skills/improve-codebase-architecture/agents/openai.yaml +0 -4
  104. package/skills/prototype/LICENSE +0 -21
  105. package/skills/prototype/LOGIC.md +0 -67
  106. package/skills/prototype/SKILL.md +0 -28
  107. package/skills/prototype/UI.md +0 -112
  108. package/skills/prototype/agents/openai.yaml +0 -3
  109. package/skills/research/LICENSE +0 -21
  110. package/skills/research/SKILL.md +0 -14
  111. package/skills/research/agents/openai.yaml +0 -3
  112. package/skills/resolving-merge-conflicts/LICENSE +0 -21
  113. package/skills/resolving-merge-conflicts/SKILL.md +0 -16
  114. package/skills/resolving-merge-conflicts/agents/openai.yaml +0 -3
  115. package/skills/tdd/LICENSE +0 -21
  116. package/skills/tdd/SKILL.md +0 -40
  117. package/skills/tdd/agents/openai.yaml +0 -3
  118. package/skills/tdd/mocking.md +0 -59
  119. package/skills/tdd/tests.md +0 -77
  120. package/skills/teach/GLOSSARY-FORMAT.md +0 -35
  121. package/skills/teach/LEARNING-RECORD-FORMAT.md +0 -46
  122. package/skills/teach/LICENSE +0 -21
  123. package/skills/teach/MISSION-FORMAT.md +0 -31
  124. package/skills/teach/RESOURCES-FORMAT.md +0 -32
  125. package/skills/teach/SKILL.md +0 -141
  126. package/skills/teach/agents/openai.yaml +0 -4
  127. package/skills/to-questionnaire/LICENSE +0 -21
  128. package/skills/to-questionnaire/SKILL.md +0 -55
  129. package/skills/to-questionnaire/agents/openai.yaml +0 -4
  130. package/skills/to-spec/LICENSE +0 -21
  131. package/skills/to-spec/SKILL.md +0 -76
  132. package/skills/to-spec/agents/openai.yaml +0 -4
  133. package/skills/to-tickets/LICENSE +0 -21
  134. package/skills/to-tickets/SKILL.md +0 -106
  135. package/skills/to-tickets/agents/openai.yaml +0 -4
  136. package/skills/wait-what/LICENSE +0 -21
  137. package/skills/wait-what/SKILL.md +0 -8
  138. package/skills/wait-what/agents/openai.yaml +0 -4
  139. package/skills/wayfinder/LICENSE +0 -21
  140. package/skills/wayfinder/SKILL.md +0 -129
  141. package/skills/wayfinder/agents/openai.yaml +0 -4
  142. package/skills/writing-for-agents/LICENSE +0 -21
  143. package/skills/writing-for-agents/SKILL-MECHANICS.md +0 -22
  144. package/skills/writing-for-agents/SKILL.md +0 -83
  145. package/skills/writing-for-agents/agents/openai.yaml +0 -3
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/refusals.js CHANGED
@@ -21,6 +21,18 @@ function spoken(text) {
21
21
  const detail = said.indexOf('\n');
22
22
  return { code: head[1], text: said, conflicts: detail === -1 ? [] : conflictCodes(said.slice(detail + 1)) };
23
23
  }
24
+ export function retryable(text) {
25
+ let body;
26
+ try {
27
+ body = JSON.parse(text);
28
+ }
29
+ catch {
30
+ return null;
31
+ }
32
+ const error = body?.error;
33
+ const verdict = error?.retryable ?? error?.data?.retryable;
34
+ return typeof verdict === 'boolean' ? verdict : null;
35
+ }
24
36
  export function refusalOf(text) {
25
37
  let body;
26
38
  try {
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:')
package/dist/resident.js CHANGED
@@ -2,53 +2,74 @@ import { once } from 'node:events';
2
2
  import { watch } from 'node:fs';
3
3
  import { mkdir, rm, writeFile } from 'node:fs/promises';
4
4
  import { createServer } from 'node:http';
5
- import { extname, join } from 'node:path';
5
+ import { dirname, extname, join } from 'node:path';
6
6
  import { fileURLToPath } from 'node:url';
7
- import { killDescendants } from './acp.js';
8
7
  import { Agents } from './agents.js';
9
8
  import { house } from './api.js';
10
9
  import { received } from './bridge.js';
11
10
  import { Conversations } from './conversations.js';
12
11
  import { LocalCopies } from './copies.js';
13
- import { agentBase, enrolled, kitHome } from './home.js';
12
+ import { restart } from './end.js';
13
+ import { agentBase, enrolled, kitHome, ownerSocket, readEnrolment } from './home.js';
14
+ import { Calls } from './calls.js';
15
+ import { KIT_RELEASE } from './clis.js';
16
+ import { moveEarlier } from './earlier.js';
17
+ import { holdOwner } from './owner.js';
18
+ import { killDescendants } from './scope.js';
19
+ import { removeInputs, Scripts } from './scripts.js';
20
+ import { applySettings, enrolledRoutes, resumeWorkspaceMove } from './settings.js';
21
+ import { quoted } from './shell.js';
14
22
  import { SignIns } from './sign-in.js';
15
23
  import { placeSkillSet } from './skills.js';
16
- import { holdStream } from './stream.js';
17
- import { Updates } from './update.js';
24
+ import { holdConnection } from './connection.js';
25
+ import { KitUpdate } from './update.js';
26
+ import { takeUnservedRelease } from './wire.js';
27
+ import { codexLauncher } from './work.js';
18
28
  function report(error) {
19
29
  process.stderr.write(`kit: ${error instanceof Error ? error.message : String(error)}\n`);
20
30
  }
21
31
  function logged(work) {
22
32
  work.catch(report);
23
33
  }
24
- function quoted(value) {
25
- return `'${value.replaceAll("'", `'\\''`)}'`;
34
+ async function installShim(path, module) {
35
+ const main = fileURLToPath(new URL(`./${module}${extname(fileURLToPath(import.meta.url))}`, import.meta.url));
36
+ await mkdir(dirname(path), { recursive: true });
37
+ await writeFile(path, `#!/bin/sh\nexec ${quoted(process.execPath)} ${quoted(main)} "$@"\n`, { mode: 0o755 });
26
38
  }
27
- async function installShim() {
28
- const main = fileURLToPath(new URL(`./git-main${extname(fileURLToPath(import.meta.url))}`, import.meta.url));
29
- await mkdir(join(kitHome(), 'shim'), { recursive: true });
30
- await writeFile(join(kitHome(), 'shim', 'git'), `#!/bin/sh\nexec ${quoted(process.execPath)} ${quoted(main)} "$@"\n`, {
31
- mode: 0o755,
32
- });
33
- }
34
- async function serveOwner(copies) {
35
- const socketPath = join(kitHome(), 'owner.sock');
36
- await rm(socketPath, { force: true });
39
+ async function serveOwner(lock, copies, settling) {
37
40
  const server = createServer(async (request, response) => {
38
41
  try {
39
- if (request.url !== '/git/push') {
42
+ const text = await received(request);
43
+ let answered;
44
+ if (request.url === '/resident') {
45
+ response.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify({ pid: process.pid, release: KIT_RELEASE }));
46
+ return;
47
+ }
48
+ if (request.url === '/git/fetch') {
49
+ answered = await copies.fetch();
50
+ }
51
+ else if (request.url === '/git/push') {
52
+ const { cwd, commit } = JSON.parse(text);
53
+ answered = await copies.push(cwd, commit, copies.owner);
54
+ }
55
+ else if (request.url === '/settings') {
56
+ const applied = await settling.settle(JSON.parse(text));
57
+ response.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify(applied), () => settling.answered(applied));
58
+ return;
59
+ }
60
+ else {
40
61
  response.writeHead(404).end();
41
62
  return;
42
63
  }
43
- const { cwd, commit } = JSON.parse(await received(request));
44
- const pushed = await copies.push(cwd, commit, copies.owner);
45
- response.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify(pushed));
64
+ response.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify(answered));
46
65
  }
47
66
  catch (error) {
48
67
  response.writeHead(502).end(error instanceof Error ? error.message : String(error));
49
68
  }
50
69
  });
51
- server.listen(socketPath);
70
+ server.on('close', () => lock.close());
71
+ await rm(ownerSocket(), { force: true });
72
+ server.listen(ownerSocket());
52
73
  await once(server, 'listening');
53
74
  }
54
75
  function connected() {
@@ -67,75 +88,154 @@ function connected() {
67
88
  resolve();
68
89
  });
69
90
  }
70
- export async function resident() {
91
+ async function started() {
71
92
  await connected();
72
- watch(kitHome(), () => {
73
- if (enrolled())
93
+ await placeSkillSet((await readEnrolment()).house);
94
+ await mkdir(agentBase(), { recursive: true });
95
+ await installShim(join(kitHome(), 'shim', 'git'), 'git-main');
96
+ await installShim(codexLauncher(), 'codex-main');
97
+ }
98
+ export async function resident() {
99
+ await moveEarlier();
100
+ await mkdir(kitHome(), { recursive: true, mode: 0o700 });
101
+ const lock = await holdOwner();
102
+ await resumeWorkspaceMove();
103
+ const copies = new LocalCopies(house);
104
+ await copies.load();
105
+ let running = null;
106
+ let settings = Promise.resolve();
107
+ const settle = (change) => {
108
+ const applied = settings.then(() => applySettings(change, {
109
+ working: () => running !== null && (running.conversations.turnOpen() || running.calls.busy()),
110
+ end: () => {
111
+ running?.conversations.stopped();
112
+ killDescendants();
113
+ },
114
+ routes: async () => {
115
+ if (running === null)
116
+ return enrolledRoutes();
117
+ await running.agents.read();
118
+ return running.agents.desired.routes;
119
+ },
120
+ }));
121
+ settings = applied.catch(() => undefined);
122
+ return applied.then((answer) => {
123
+ if ('settings' in answer && !answer.moved)
124
+ running?.agents.report().catch(report);
125
+ return answer;
126
+ });
127
+ };
128
+ const answered = (applied) => {
129
+ if ('settings' in applied ? !applied.moved : !applied.ended)
74
130
  return;
75
- killDescendants();
131
+ const ended = 'settings' in applied
132
+ ? `the workspace moved to ${applied.settings.workspace}; its supervisor starts Kit there`
133
+ : 'the workspace stays where it was; its supervisor starts Kit again';
134
+ if (running === null)
135
+ restart(ended);
136
+ else
137
+ void running.stop(() => restart(ended));
138
+ };
139
+ await serveOwner(lock, copies, { settle, answered });
140
+ await copies.swept();
141
+ await started().catch((error) => {
142
+ report(error);
76
143
  process.exit(1);
77
144
  });
78
- await placeSkillSet();
79
- await mkdir(agentBase(), { recursive: true });
80
145
  process.env.HOUSE_KIT_RESIDENT = String(process.pid);
81
- const agents = new Agents(house);
82
- const copies = new LocalCopies(house);
83
- await copies.load();
84
- await installShim();
85
- await serveOwner(copies);
86
- let stream = null;
146
+ const agents = new Agents(house, () => changed());
147
+ let connection = null;
87
148
  let reported = false;
88
- const idle = () => conversations.idle() && signIns.idle();
149
+ let stopping = false;
150
+ const stop = async (then) => {
151
+ if (stopping)
152
+ return;
153
+ stopping = true;
154
+ conversations.stopped();
155
+ killDescendants();
156
+ await connection?.close();
157
+ then();
158
+ };
159
+ const idle = () => calls.idle() && conversations.idle() && agents.idle();
89
160
  const changed = () => {
90
161
  if (!idle()) {
91
162
  reported = false;
92
163
  }
164
+ else if (update.placedRelease() !== null && conversations.quiet() && process.env.HOUSE_KIT_SANDBOX !== '1') {
165
+ const placed = update.placedRelease();
166
+ void stop(() => restart(`Kit ${placed} is placed; its supervisor starts it`));
167
+ }
93
168
  else if (!reported) {
94
169
  reported = true;
95
- logged(house.deliver('/kit/idle', {}, idle));
170
+ logged(house.deliver('kits/report-idle', {}, idle));
96
171
  }
97
172
  };
173
+ const calls = new Calls(house, changed);
98
174
  const conversations = new Conversations({
99
175
  house,
100
176
  agents,
101
177
  copies,
102
- send: (frame) => stream?.send(frame) ?? false,
178
+ calls,
179
+ send: (oneWayCall) => connection?.send(oneWayCall) ?? false,
103
180
  changed,
104
181
  });
105
- const signIns = new SignIns(house, agents, changed);
106
- const updates = new Updates(house);
182
+ const signIns = new SignIns(house, agents, calls);
183
+ const update = new KitUpdate(calls);
184
+ takeUnservedRelease((release) => logged(update.takeRefused(release)));
185
+ removeInputs();
186
+ const scripts = new Scripts(calls, (oneWayCall) => connection?.send(oneWayCall) ?? false);
187
+ running = { conversations, agents, calls, stop };
107
188
  for (const signal of ['SIGTERM', 'SIGINT']) {
108
189
  process.once(signal, () => {
109
- killDescendants();
110
- process.kill(process.pid, signal);
190
+ void stop(() => {
191
+ removeInputs();
192
+ process.kill(process.pid, signal);
193
+ });
111
194
  });
112
195
  }
113
- await house.deliver('/kit/restarted', {}).catch(report);
114
- await updates.resumed().catch(report);
196
+ const unenrolled = () => {
197
+ if (!enrolled())
198
+ void stop(() => process.exit(1));
199
+ };
200
+ watch(kitHome(), unenrolled);
201
+ unenrolled();
202
+ await house.deliver('kits/report-restart', {}).catch(report);
115
203
  logged(agents.refresh());
116
- stream = holdStream({
204
+ agents.keepCurrent(() => process.env.HOUSE_KIT_SANDBOX === '1' && reported);
205
+ connection = holdConnection({
117
206
  opened: () => {
118
207
  conversations.opened();
208
+ scripts.connected();
119
209
  changed();
120
- logged(copies.select());
210
+ logged(copies.connected());
121
211
  },
122
- frame: (arrived) => {
123
- if (arrived.type === 'work_available' && arrived.subject === 'agents')
124
- logged(agents.refresh());
125
- if (arrived.type === 'work_available' && arrived.subject === 'local_copy')
126
- logged(copies.select());
127
- if (arrived.type === 'entries') {
128
- copies.entries(arrived);
129
- }
130
- if (arrived.type === 'input') {
131
- reported = false;
132
- if (arrived.kind === 'sign_in')
133
- signIns.start(arrived);
134
- else if (arrived.kind === 'update')
135
- updates.start(arrived);
136
- else
137
- conversations.input(arrived);
212
+ closed: () => scripts.disconnected(),
213
+ call: (call) => {
214
+ if (call.kind === 'sign_in')
215
+ signIns.start(call);
216
+ else if (call.kind === 'update')
217
+ update.take(call);
218
+ else if (call.kind === 'settings') {
219
+ void calls.carrySettings(call.input_id, async () => {
220
+ const applied = await settle(call);
221
+ const result = 'refused' in applied ? { refused: applied.refused } : { settings: applied.settings };
222
+ if ('settings' in applied ? !applied.moved : !applied.ended)
223
+ return { result };
224
+ calls.keepResult(call.input_id, result);
225
+ return new Promise(() => answered(applied));
226
+ });
138
227
  }
228
+ else if (call.kind === 'run_wizard' || call.kind === 'run_function')
229
+ scripts.start(call);
230
+ else
231
+ conversations.call(call);
232
+ },
233
+ oneWayCall: (oneWayCall) => {
234
+ if (oneWayCall.type === 'watching')
235
+ conversations.watching(oneWayCall.watching);
236
+ if (oneWayCall.type === 'work_available' && oneWayCall.subject === 'agents')
237
+ logged(agents.refresh());
238
+ scripts.notified(oneWayCall);
139
239
  },
140
240
  });
141
241
  }
package/dist/scope.js ADDED
@@ -0,0 +1,214 @@
1
+ import { execFileSync } from 'node:child_process';
2
+ import { mkdirSync, readdirSync, readFileSync, realpathSync, rmdirSync, statSync, writeFileSync } from 'node:fs';
3
+ import { join } from 'node:path';
4
+ const LISTING_BYTES = 1 << 28;
5
+ const CGROUPS = '/sys/fs/cgroup';
6
+ const GONE = new Set(['ENOENT', 'ESRCH']);
7
+ const EXITED = new Set(['Z', 'X']);
8
+ function failure(error) {
9
+ return error.code ?? '';
10
+ }
11
+ function listed(environment) {
12
+ const found = new Map();
13
+ const output = execFileSync('ps', [environment ? '-AEww' : '-Aww', '-o', 'pid=,ppid=,sess=,command='], {
14
+ encoding: 'utf8',
15
+ maxBuffer: LISTING_BYTES,
16
+ });
17
+ for (const line of output.split('\n')) {
18
+ const fields = /^\s*(\d+)\s+(\d+)\s+(\S+)\s?(.*)$/.exec(line);
19
+ if (fields !== null)
20
+ found.set(Number(fields[1]), { parent: Number(fields[2]), session: fields[3], command: fields[4] });
21
+ }
22
+ return found;
23
+ }
24
+ function read(pid) {
25
+ try {
26
+ const stat = readFileSync(`/proc/${pid}/stat`, 'utf8');
27
+ const fields = stat.slice(stat.lastIndexOf(')') + 2).split(' ');
28
+ if (EXITED.has(fields[0]))
29
+ return null;
30
+ const command = readFileSync(`/proc/${pid}/cmdline`, 'utf8').replaceAll('\0', ' ');
31
+ return { parent: Number(fields[1]), session: fields[3], command };
32
+ }
33
+ catch (error) {
34
+ if (GONE.has(failure(error)))
35
+ return null;
36
+ throw error;
37
+ }
38
+ }
39
+ function processes() {
40
+ if (process.platform === 'darwin')
41
+ return listed(false);
42
+ const found = new Map();
43
+ for (const entry of readdirSync('/proc')) {
44
+ const running = /^\d+$/.test(entry) ? read(entry) : null;
45
+ if (running !== null)
46
+ found.set(Number(entry), running);
47
+ }
48
+ return found;
49
+ }
50
+ function descendants(roots, table = processes()) {
51
+ const children = new Map();
52
+ for (const [pid, { parent }] of table)
53
+ children.set(parent, [...(children.get(parent) ?? []), pid]);
54
+ const tree = [];
55
+ const pending = roots.flatMap((root) => children.get(root) ?? []);
56
+ while (pending.length > 0) {
57
+ const pid = pending.pop();
58
+ tree.push(pid);
59
+ pending.push(...(children.get(pid) ?? []));
60
+ }
61
+ return tree;
62
+ }
63
+ function marked(marker, doubted) {
64
+ if (process.platform === 'darwin') {
65
+ return [...listed(true)].filter(([, { command }]) => ` ${command} `.includes(` ${marker} `)).map(([pid]) => pid);
66
+ }
67
+ return readdirSync('/proc')
68
+ .filter((entry) => /^\d+$/.test(entry) && carries(entry, marker, doubted))
69
+ .map(Number);
70
+ }
71
+ function carries(pid, marker, doubted) {
72
+ try {
73
+ return readFileSync(`/proc/${pid}/environ`, 'utf8').split('\0').includes(marker);
74
+ }
75
+ catch (error) {
76
+ if (GONE.has(failure(error)))
77
+ return false;
78
+ if (failure(error) !== 'EACCES')
79
+ throw error;
80
+ return doubted && statSync(`/proc/${pid}`, { throwIfNoEntry: false })?.uid === process.getuid();
81
+ }
82
+ }
83
+ function killAll(pids) {
84
+ for (const pid of pids) {
85
+ for (const target of [-pid, pid]) {
86
+ try {
87
+ process.kill(target, 'SIGKILL');
88
+ }
89
+ catch { }
90
+ }
91
+ }
92
+ }
93
+ export function killTree(child) {
94
+ killAll([child.pid, ...descendants([child.pid])]);
95
+ }
96
+ export function killMarked(marker) {
97
+ const pids = marked(marker, false);
98
+ killAll([...pids, ...descendants(pids)]);
99
+ }
100
+ export function killDescendants() {
101
+ const pids = marked(`HOUSE_KIT_RESIDENT=${process.pid}`, false);
102
+ killAll([...pids, ...descendants([process.pid, ...pids])]);
103
+ }
104
+ function ownGroup() {
105
+ if (process.platform !== 'linux')
106
+ return null;
107
+ try {
108
+ const line = readFileSync('/proc/self/cgroup', 'utf8')
109
+ .split('\n')
110
+ .find((entry) => entry.startsWith('0::'));
111
+ return line === undefined ? null : join(CGROUPS, line.slice(3));
112
+ }
113
+ catch {
114
+ return null;
115
+ }
116
+ }
117
+ function members(group) {
118
+ const pids = readFileSync(join(group, 'cgroup.procs'), 'utf8').split('\n').filter(Boolean).map(Number);
119
+ for (const entry of readdirSync(group, { withFileTypes: true })) {
120
+ if (entry.isDirectory())
121
+ pids.push(...members(join(group, entry.name)));
122
+ }
123
+ return pids;
124
+ }
125
+ function besideCli(cli) {
126
+ try {
127
+ return `${realpathSync(cli)}-`;
128
+ }
129
+ catch {
130
+ return null;
131
+ }
132
+ }
133
+ export class Scope {
134
+ marker;
135
+ helpers;
136
+ group;
137
+ session = null;
138
+ recorded = null;
139
+ constructor(marker, name, cli) {
140
+ this.marker = marker;
141
+ this.helpers = besideCli(cli);
142
+ const own = ownGroup();
143
+ this.group = own === null ? null : join(own, name);
144
+ try {
145
+ if (this.group !== null)
146
+ mkdirSync(this.group);
147
+ }
148
+ catch {
149
+ this.group = null;
150
+ }
151
+ }
152
+ command(command, args) {
153
+ if (this.group === null)
154
+ return [command, args];
155
+ return ['/bin/sh', ['-c', 'echo $$ > "$0/cgroup.procs" 2>/dev/null; exec "$@"', this.group, command, ...args]];
156
+ }
157
+ entered(pid) {
158
+ this.session = process.platform === 'darwin' ? (listed(false).get(pid)?.session ?? null) : String(pid);
159
+ if (this.group === null)
160
+ return;
161
+ const joined = readFileSync(`/proc/${pid}/cgroup`, 'utf8').split('\n').find((entry) => entry.startsWith('0::'));
162
+ if (joined !== undefined && join(CGROUPS, joined.slice(3)) === this.group)
163
+ return;
164
+ this.close();
165
+ this.group = null;
166
+ }
167
+ record() {
168
+ const found = this.found();
169
+ if (found === null)
170
+ return;
171
+ this.recorded = new Set([...found].filter(([, { session }]) => session === this.session).map(([pid]) => pid));
172
+ }
173
+ working() {
174
+ const found = this.found();
175
+ if (found === null)
176
+ return true;
177
+ if (this.recorded === null)
178
+ return found.size > 0;
179
+ return [...found].some(([pid, { session, command }]) => session !== this.session || !(this.recorded.has(pid) || (this.helpers !== null && command.startsWith(this.helpers))));
180
+ }
181
+ empty() {
182
+ return this.found()?.size === 0;
183
+ }
184
+ kill() {
185
+ killMarked(this.marker);
186
+ if (this.group === null)
187
+ return;
188
+ try {
189
+ writeFileSync(join(this.group, 'cgroup.kill'), '1');
190
+ }
191
+ catch {
192
+ killAll([...(this.found()?.keys() ?? [])]);
193
+ }
194
+ }
195
+ close() {
196
+ if (this.group === null)
197
+ return;
198
+ try {
199
+ rmdirSync(this.group);
200
+ }
201
+ catch { }
202
+ }
203
+ found() {
204
+ try {
205
+ const table = processes();
206
+ const roots = this.group === null ? marked(this.marker, true) : members(this.group);
207
+ const pids = this.group === null ? [...roots, ...descendants(roots, table)] : roots;
208
+ return new Map(pids.flatMap((pid) => (table.has(pid) ? [[pid, table.get(pid)]] : [])));
209
+ }
210
+ catch {
211
+ return null;
212
+ }
213
+ }
214
+ }