@agentshouse/kit 0.2.1-cfb7b543f2af6 → 0.2.1-cfbadfb5b5e28

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 (150) hide show
  1. package/README.md +33 -34
  2. package/dist/acp.js +91 -20
  3. package/dist/afk.js +17 -0
  4. package/dist/agents.js +91 -44
  5. package/dist/api.js +5 -5
  6. package/dist/app-git.js +10 -26
  7. package/dist/authority-main.js +3 -3
  8. package/dist/bridge.js +7 -10
  9. package/dist/building.js +50 -0
  10. package/dist/calls.js +71 -0
  11. package/dist/chunks.js +49 -0
  12. package/dist/clis.js +56 -45
  13. package/dist/connection.js +120 -0
  14. package/dist/content.js +63 -0
  15. package/dist/conversations.js +703 -244
  16. package/dist/copies.js +344 -171
  17. package/dist/end.js +15 -4
  18. package/dist/events.js +746 -210
  19. package/dist/files.js +139 -37
  20. package/dist/git.js +49 -16
  21. package/dist/grok.js +39 -0
  22. package/dist/home.js +27 -20
  23. package/dist/house-cli.js +98 -90
  24. package/dist/house-main.js +3 -3
  25. package/dist/instructions.js +29 -10
  26. package/dist/kit-cli.js +5 -8
  27. package/dist/kit-main.js +3 -3
  28. package/dist/login.js +20 -11
  29. package/dist/logout.js +1 -3
  30. package/dist/mcp.js +6 -2
  31. package/dist/placement.js +19 -36
  32. package/dist/relay.js +21 -0
  33. package/dist/resident.js +118 -52
  34. package/dist/scope.js +15 -4
  35. package/dist/scripts.js +255 -0
  36. package/dist/secret-input.js +1 -1
  37. package/dist/service.js +23 -1
  38. package/dist/sign-in.js +22 -39
  39. package/dist/silence.js +28 -0
  40. package/dist/skills.js +42 -97
  41. package/dist/transcription.js +88 -45
  42. package/dist/translate.js +19 -16
  43. package/dist/update.js +113 -127
  44. package/dist/wire.js +37 -3
  45. package/dist/work.js +12 -7
  46. package/package.json +22 -21
  47. package/dist/bootstrap.json +0 -24
  48. package/dist/chatgpt.js +0 -32
  49. package/dist/clis-main.js +0 -23
  50. package/dist/parts.js +0 -82
  51. package/dist/stream.js +0 -123
  52. package/how-we-work.md +0 -33
  53. package/skills/ask-matt/LICENSE +0 -21
  54. package/skills/ask-matt/PHASE-BOUNDARIES.md +0 -55
  55. package/skills/ask-matt/SKILL.md +0 -97
  56. package/skills/ask-matt/agents/openai.yaml +0 -5
  57. package/skills/code-review/LICENSE +0 -21
  58. package/skills/code-review/SKILL.md +0 -89
  59. package/skills/code-review/agents/openai.yaml +0 -3
  60. package/skills/codebase-design/DEEPENING.md +0 -37
  61. package/skills/codebase-design/DESIGN-IT-TWICE.md +0 -44
  62. package/skills/codebase-design/LICENSE +0 -21
  63. package/skills/codebase-design/SKILL.md +0 -114
  64. package/skills/codebase-design/agents/openai.yaml +0 -3
  65. package/skills/diagnosing-bugs/LICENSE +0 -21
  66. package/skills/diagnosing-bugs/SKILL.md +0 -138
  67. package/skills/diagnosing-bugs/agents/openai.yaml +0 -3
  68. package/skills/diagnosing-bugs/scripts/hitl-loop.template.sh +0 -44
  69. package/skills/domain-modeling/ADR-FORMAT.md +0 -47
  70. package/skills/domain-modeling/GLOSSARY-FORMAT.md +0 -60
  71. package/skills/domain-modeling/LICENSE +0 -21
  72. package/skills/domain-modeling/SKILL.md +0 -74
  73. package/skills/domain-modeling/agents/openai.yaml +0 -3
  74. package/skills/grill-me/LICENSE +0 -21
  75. package/skills/grill-me/SKILL.md +0 -7
  76. package/skills/grill-me/agents/openai.yaml +0 -5
  77. package/skills/grill-with-docs/LICENSE +0 -21
  78. package/skills/grill-with-docs/SKILL.md +0 -7
  79. package/skills/grill-with-docs/agents/openai.yaml +0 -5
  80. package/skills/grilling/LICENSE +0 -21
  81. package/skills/grilling/SKILL.md +0 -30
  82. package/skills/grilling/agents/openai.yaml +0 -3
  83. package/skills/handoff/LICENSE +0 -21
  84. package/skills/handoff/SKILL.md +0 -16
  85. package/skills/handoff/agents/openai.yaml +0 -5
  86. package/skills/implement/LICENSE +0 -21
  87. package/skills/implement/SKILL.md +0 -17
  88. package/skills/implement/agents/openai.yaml +0 -5
  89. package/skills/implement-spec/LICENSE +0 -21
  90. package/skills/implement-spec/SKILL.md +0 -40
  91. package/skills/implement-spec/agents/openai.yaml +0 -5
  92. package/skills/improve-codebase-architecture/HTML-REPORT.md +0 -123
  93. package/skills/improve-codebase-architecture/LICENSE +0 -21
  94. package/skills/improve-codebase-architecture/SKILL.md +0 -71
  95. package/skills/improve-codebase-architecture/agents/openai.yaml +0 -5
  96. package/skills/pr/CREDITS.md +0 -3
  97. package/skills/pr/LICENSE +0 -21
  98. package/skills/pr/SKILL.md +0 -170
  99. package/skills/pr/agents/openai.yaml +0 -3
  100. package/skills/prototype/LICENSE +0 -21
  101. package/skills/prototype/LOGIC.md +0 -67
  102. package/skills/prototype/SKILL.md +0 -26
  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 -12
  107. package/skills/research/agents/openai.yaml +0 -3
  108. package/skills/retro/LICENSE +0 -21
  109. package/skills/retro/SKILL.md +0 -44
  110. package/skills/retro/agents/openai.yaml +0 -5
  111. package/skills/tdd/LICENSE +0 -21
  112. package/skills/tdd/SKILL.md +0 -38
  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 -140
  122. package/skills/teach/agents/openai.yaml +0 -5
  123. package/skills/to-questionnaire/LICENSE +0 -21
  124. package/skills/to-questionnaire/SKILL.md +0 -54
  125. package/skills/to-questionnaire/agents/openai.yaml +0 -5
  126. package/skills/to-spec/LICENSE +0 -21
  127. package/skills/to-spec/SKILL.md +0 -75
  128. package/skills/to-spec/agents/openai.yaml +0 -5
  129. package/skills/to-tickets/LICENSE +0 -21
  130. package/skills/to-tickets/SKILL.md +0 -105
  131. package/skills/to-tickets/agents/openai.yaml +0 -5
  132. package/skills/triage/AGENT-BRIEF.md +0 -207
  133. package/skills/triage/LICENSE +0 -21
  134. package/skills/triage/OUT-OF-SCOPE.md +0 -105
  135. package/skills/triage/SKILL.md +0 -112
  136. package/skills/triage/agents/openai.yaml +0 -5
  137. package/skills/wait-what/LICENSE +0 -21
  138. package/skills/wait-what/SKILL.md +0 -7
  139. package/skills/wait-what/agents/openai.yaml +0 -5
  140. package/skills/wayfinder/LICENSE +0 -21
  141. package/skills/wayfinder/SKILL.md +0 -128
  142. package/skills/wayfinder/agents/openai.yaml +0 -5
  143. package/skills/wizard/LICENSE +0 -21
  144. package/skills/wizard/SKILL.md +0 -44
  145. package/skills/wizard/agents/openai.yaml +0 -3
  146. package/skills/wizard/template.sh +0 -223
  147. package/skills/writing-for-agents/LICENSE +0 -21
  148. package/skills/writing-for-agents/SKILL-MECHANICS.md +0 -22
  149. package/skills/writing-for-agents/SKILL.md +0 -81
  150. package/skills/writing-for-agents/agents/openai.yaml +0 -3
package/README.md CHANGED
@@ -1,33 +1,33 @@
1
- # House Kit
1
+ # Kit
2
2
 
3
- House Kit connects an Environment, a Linux computer or server, to [agents.house](https://agents.house). It runs
3
+ Kit connects an Environment, a Linux computer or server, to [agents.house](https://agents.house). It runs
4
4
  your Agents' conversations through the agent CLIs you chose and gives each Agent the `house` command.
5
5
 
6
6
  ## Install
7
7
 
8
- Run `curl -fsSL agents.house/kit | sh`, or `irm agents.house/kit.ps1 | iex` on Windows, and again to update;
9
- options follow `sh -s --`. On macOS and Linux it installs House Kit natively under your own account, without an admin password,
10
- as a service that runs while you are logged in. `kit` and `house` are then on
11
- your login shell's `PATH`, and your workspace is `~/AgentsHouse` unless you
12
- pass `--workspace <path>`.
8
+ Run `sh -c 'kit=$(curl -fsSL "$0") || { echo "Kit could not be downloaded; run this command again." >&2; exit 1; }; eval "$kit"' agents.house/kit`,
9
+ or `& { try { $kit = irm agents.house/kit.ps1 } catch { throw 'Kit could not be downloaded; run this command again.' }; & ([scriptblock]::Create($kit)) @args }` on Windows, which run nothing of a failed download, and again to update; options follow `agents.house/kit`.
10
+ On macOS and Linux it installs Kit natively under your own account, without an admin password, as a service that runs
11
+ while you are logged in. `kit` and `house` are then on your login shell's `PATH`, and your workspace is `~/AgentsHouse` unless you
12
+ pass `--workspace <path>`. Every run places the Kit release your Building serves, with the Node.js and agent adapters it runs on, in a directory of its own beside the one that runs, then starts it; the earlier one stays until the next release. Kit also updates itself: when your Building takes another release, Kit places it the same way and, once no turn is open, ends so its service, or the container's restart policy, starts it. When House refuses the Kit that runs as too old or too new, Kit places your Building's release at once, ending any running turn, and ends the same way; while it cannot, it stays offline, prints why with the command that installs it again, and tries again regularly.
13
13
 
14
- Add `--container` to run House Kit in one Docker container instead, with your
15
- workspace mounted at `/agents/house`; your Agents then reach only that
16
- workspace. On Windows 11 the container is the one choice. Append a `kit` or
17
- `house` command to the container's options to run it in that container.
14
+ Add `--container` to run Kit in one Docker container instead, with your workspace mounted at `/agents/house`; your Agents then reach only that
15
+ workspace. The container's image holds no Kit release and no Node.js: every run places them in Kit home's `kit` folder, which a container created again keeps. On Windows,
16
+ Kit home is the Docker volume `house-kit-home` and the container is the one choice. Append a `kit` or `house` command to the container's options to run it in that container.
18
17
  Running the command for the other choice on a connected computer asks you to
19
- confirm, then replaces its Environment, whose Agents end, with a new one.
18
+ confirm, then replaces its Environment, whose Agents end, with a new one. Running it with a different `HOUSE_KIT_HOME`
19
+ from the running Kit process asks you to confirm before it replaces that process, and leaves the earlier Kit home as it was.
20
20
 
21
- On your own Linux server, run the Linux command with `--linux` to
22
- install House Kit natively, with its workspace at `/agents/house`; `kit` and
23
- `house` are then on the server's `PATH`.
21
+ On your own Linux server, run the Linux command with `--linux` to install Kit natively, with its workspace at `/agents/house` and a missing `ca-certificates`, `curl` or `git` installed through apt; `kit` and `house` are then on the server's `PATH`.
24
22
 
25
- House Kit runs the agent CLIs your login shell finds and installs a missing one
26
- through that CLI's own installer. Running the command again offers to update
27
- each CLI older than House Kit needs; add `--update-clis` to update every one to
28
- its latest release without asking. House Kit also gives every Agent on the
29
- Environment a set of agent skills. Add `--no-skills` to the command to leave
30
- them out; running it again without the flag brings them back.
23
+ Kit is built for macOS 27 on Apple silicon, Ubuntu 26.04 LTS on amd64 and Windows 11 on amd64. On another release, distribution or architecture the command prints one warning line, such as `Warning: macOS 26.7.1 is outdated; update to macOS 27.`, and installs anyway. It refuses only an architecture other than amd64 and arm64, a native install on a macOS older than 13.5, and one on a Linux without glibc 2.28 or newer, where `--container` still runs Kit. On a Linux without systemd it installs and connects Kit but starts nothing: run the `kit resident` command it prints under your own service manager, restarting it whenever it ends with a failure. `--container` installs Docker Engine on Ubuntu and Debian; another Linux needs a working Docker Engine first.
24
+
25
+ Kit runs each agent CLI through the link your login shell finds and installs a missing one through that CLI's own
26
+ installer. When it starts and regularly after, Kit runs each CLI's own update command, such as `claude update`, beside
27
+ your conversations: a running conversation keeps its version and the next one runs the new release. A CLI older than
28
+ the oldest release Kit is built for still runs, though its conversations may fail: Kit tells House its version, that
29
+ oldest release and its update command. Kit also gives every Agent on the Environment the agent skills of
30
+ `@agentshouse/skills`, at the version each Kit release installs. Add `--no-skills` to the command to leave them out; running it again without the flag brings them back.
31
31
 
32
32
  ## Commands
33
33
 
@@ -37,24 +37,23 @@ or another, continues on its own and keeps the Environment's credential in
37
37
  reconnects an Environment you already have; `--rooms <ref>[,<ref>...]` gives it
38
38
  only those Rooms and `--no-private` every Room but your Private Room; `--code <code>` connects immediately without a link.
39
39
  A login also connects your own agent: outside an Agent conversation, `house <tool>` calls
40
- House as you and `git` clones and pushes your Apps at `<house>/app/` as you, until you revoke
41
- that connection on Connections. `house help` lists the Tools. Codex sessions started after a
40
+ House as you and `git` clones and pushes your Apps at `<house>/app/` as you, each through the Kit
41
+ home `$HOUSE_KIT_HOME` names where it runs, until you revoke that connection on Connections. `house help` lists the Tools. Codex sessions started after a
42
42
  login run a lone `house` command outside their sandbox. `kit logout` disconnects this
43
- computer, stops House Kit and ends your own agent's connection, so `house` and `git` no
43
+ computer, stops the Kit process and ends your own agent's connection, so `house` and `git` no
44
44
  longer act as you here; a later `kit login` reconnects the same Environment, or connects
45
45
  this computer as a new one when House no longer holds it.
46
- In a container you do not control, such as ChatGPT's, `npm i -g @agentshouse/kit` and `kit chatgpt --key <key>` with a key made on Connections let `house <tool>` act as you, starting and configuring nothing else.
47
46
 
48
- `kit resident` keeps the Environment connected and, as it connects, copies the text of each Room
49
- you chose for it as a Git repository in the workspace's `local-copies`. `house fetch` records
50
- House's changes on each copy's `refs/house/received`; rebase onto it, commit and run
51
- `house push --owner` in the copy, through the install command in the container. An Agent runs
52
- both, without `--owner`. `house upload` and `house download` move a Room's other files.
47
+ `kit resident` keeps the Environment connected and, as it connects, copies the text of each Room you chose for it as a
48
+ Git repository in the workspace's `local-copies`, and keeps a Room's copy as it is, no longer refreshing it, once the
49
+ Room may no longer be copied here. `house fetch` does the same and records House's changes on each copy's
50
+ `refs/house/received`; rebase onto it, commit and run `house push --owner` in the copy, through the install command in
51
+ the container. An Agent runs both, without `--owner`. `house upload` and `house download` move a Room's other files straight between disk and House's store, and a broken upload resumes on its own.
52
+
53
+ Kit turns each audio file your message to an Agent links into text on this computer before the Agent reads it, and keeps a message whose audio it cannot turn into text from starting. While transcription is on, the speech engine and model use about 425 MB beside the Environment's credential; turning it off deletes them.
53
54
 
54
- House Kit turns each audio file of your message to an Agent into text on this
55
- computer before the Agent reads it. While transcription is on, the speech
56
- engine and model use about 425 MB beside the Environment's credential; turning it off deletes them.
55
+ When you press Run on a Web Wizard's page, Kit runs its script with `bash` in a terminal on this computer, as you, in the home and directory it runs agent CLIs from, with your login shell's `PATH`; the page shows that terminal and takes your typing, and closing the page, or Kit losing its connection to House, ends the script and its child processes. Kit keeps nothing the script prints or you type. A script you keep as a function from a Web Wizard runs as you, from the same home, directory and `PATH`, when a Trigger of your Private Room or your agent runs it, with no terminal and nothing on its standard input, and when you press Run now on its page, in a terminal you can type into. Kit writes the run's input as JSON to a file only you can read, whose path is in `HOUSE_INPUT`, and deletes it when the run ends; it ends the script and its child processes at the run's time limit or when it loses its connection to House, and sends House the end of what the script printed, up to the run's output limit, without any line that holds a line you typed.
57
56
 
58
57
  ## License
59
58
 
60
- MIT. The skills come from [mattpocock/skills](https://github.com/mattpocock/skills); thank you, Matt Pocock.
59
+ MIT.
package/dist/acp.js CHANGED
@@ -1,46 +1,113 @@
1
- import { ndJsonStream, PROTOCOL_VERSION, } from '@agentclientprotocol/sdk';
1
+ import { ndJsonStream, PROTOCOL_VERSION, RequestError, } from '@agentclientprotocol/sdk';
2
2
  import { spawn } from 'node:child_process';
3
3
  import { Readable, Writable } from 'node:stream';
4
- import { CLIS, KIT_VERSION, adapterCommand, withoutProxy } from './clis.js';
4
+ import { CLIS, KIT_RELEASE, adapterCommand } from './clis.js';
5
+ import { childEnvironment } from './relay.js';
5
6
  import { killTree } from './scope.js';
7
+ import { Silence } from './silence.js';
8
+ const RETIRED = 'the CLI was retired';
9
+ const SIGNED_OUT = RequestError.authRequired().code;
10
+ export function signedOut(error) {
11
+ return typeof error === 'object' && error !== null && error.code === SIGNED_OUT;
12
+ }
13
+ // Claude Code ends a shell command or a model request after ten minutes, so a CLI that owes the Kit an answer and sends nothing for half an hour has hung.
14
+ export const CLI_SILENCE_MS = 30 * 60_000;
15
+ const SILENT = `the CLI sent nothing for ${CLI_SILENCE_MS / 60_000} minutes`;
6
16
  export async function startAdapter(kind, cli, cwd, app, events = () => undefined, added = {}, signal, scope = null) {
7
17
  const adapter = CLIS[kind].adapter;
8
18
  const started = [adapter === null ? cli : adapterCommand(kind), CLIS[kind].args];
9
19
  const [command, args] = scope?.command(...started) ?? started;
10
20
  const child = spawn(command, args, {
11
21
  cwd,
12
- env: { ...withoutProxy(), ...(adapter === null ? {} : { ...adapter.env, [adapter.executable]: cli }), ...added },
22
+ env: { ...childEnvironment(), ...(adapter === null ? {} : { ...adapter.env, [adapter.executable]: cli }), ...added },
13
23
  stdio: ['pipe', 'pipe', 'pipe'],
14
24
  detached: true,
15
25
  });
16
- const stop = () => killTree(child);
17
- signal?.addEventListener('abort', stop, { once: true });
18
- child.on('exit', () => signal?.removeEventListener('abort', stop));
26
+ let owned = true;
27
+ let retired = false;
28
+ let silent = false;
29
+ let over = false;
30
+ let open = false;
19
31
  let stderr = '';
32
+ const owed = new Set();
33
+ const asked = new Set();
34
+ const silence = new Silence(CLI_SILENCE_MS, () => {
35
+ silent = true;
36
+ connection.close(new Error(SILENT));
37
+ if (child.pid !== undefined)
38
+ killTree(child);
39
+ });
40
+ const watch = () => (!over && (owed.size > 0 || open) && asked.size === 0 ? silence.heard() : silence.stop());
20
41
  child.stderr.on('data', (chunk) => {
21
42
  stderr = (stderr + chunk.toString('utf8')).slice(-4000);
22
43
  });
23
- const exited = new Promise((resolve) => {
24
- child.on('error', (error) => resolve(`the CLI did not start: ${error.message}`));
25
- child.on('exit', (code, signal) => {
26
- const last = stderr.trim().split('\n').at(-1);
27
- resolve(`the CLI exited with ${code ?? signal}${last ? `: ${last}` : ''}`);
28
- });
29
- });
30
44
  const stream = ndJsonStream(Writable.toWeb(child.stdin), Readable.toWeb(child.stdout));
45
+ const output = stream.writable.getWriter();
31
46
  const connection = app.connect({
32
- writable: stream.writable,
47
+ writable: new WritableStream({
48
+ write(message) {
49
+ const sent = message;
50
+ if (sent.id !== undefined) {
51
+ if (sent.method === undefined)
52
+ asked.delete(sent.id);
53
+ else
54
+ owed.add(sent.id);
55
+ watch();
56
+ }
57
+ return output.write(message);
58
+ },
59
+ close: () => output.close(),
60
+ abort: (reason) => output.abort(reason),
61
+ }),
33
62
  readable: stream.readable.pipeThrough(new TransformStream({
34
63
  transform(message, controller) {
35
64
  const read = message;
36
- events(read);
65
+ if (read.id !== undefined) {
66
+ if (read.method === undefined)
67
+ owed.delete(read.id);
68
+ else
69
+ asked.add(read.id);
70
+ }
71
+ watch();
72
+ if (owned)
73
+ events(read);
37
74
  if (read.id !== undefined || (read.method !== 'session/update' && !read.method.startsWith('_'))) {
38
75
  controller.enqueue(message);
39
76
  }
40
77
  },
41
78
  })),
42
79
  });
43
- void exited.then((cause) => connection.close(new Error(cause)));
80
+ const { promise: lost, resolve: lose } = Promise.withResolvers();
81
+ const exited = new Promise((resolve) => {
82
+ const end = (cause) => {
83
+ over = true;
84
+ silence.stop();
85
+ if (owned)
86
+ lose(cause);
87
+ owned = false;
88
+ connection.close(new Error(cause));
89
+ resolve(cause);
90
+ };
91
+ child.on('error', (error) => end(`the CLI did not start: ${error.message}`));
92
+ child.on('exit', (code, signal) => {
93
+ const last = stderr.trim().split('\n').at(-1);
94
+ end(silent ? SILENT : `the CLI exited with ${code ?? signal}${last ? `: ${last}` : ''}`);
95
+ });
96
+ });
97
+ const retire = () => {
98
+ owned = false;
99
+ over = true;
100
+ silence.stop();
101
+ if (retired)
102
+ return;
103
+ retired = true;
104
+ if (child.pid !== undefined)
105
+ killTree(child);
106
+ scope?.kill();
107
+ connection.close(new Error(RETIRED));
108
+ };
109
+ signal?.addEventListener('abort', retire, { once: true });
110
+ child.on('exit', () => signal?.removeEventListener('abort', retire));
44
111
  try {
45
112
  const initialized = await connection.agent.request('initialize', {
46
113
  protocolVersion: PROTOCOL_VERSION,
@@ -49,15 +116,19 @@ export async function startAdapter(kind, cli, cwd, app, events = () => undefined
49
116
  terminal: false,
50
117
  elicitation: { form: {} },
51
118
  session: { compaction: {}, notices: {} },
52
- _meta: { jetbrains: { air: { version: 1, capabilities: CLIS[kind].air } } },
119
+ _meta: { terminal_output: true, jetbrains: { air: { version: 1, capabilities: CLIS[kind].air } } },
53
120
  },
54
- clientInfo: { name: '@agentshouse/kit', version: KIT_VERSION },
121
+ clientInfo: { name: '@agentshouse/kit', version: KIT_RELEASE },
55
122
  });
56
123
  scope?.entered(child.pid);
57
- return { child, connection, initialized, exited };
124
+ const turn = (opened) => {
125
+ open = opened;
126
+ watch();
127
+ };
128
+ return { connection, initialized, exited, lost, silent: () => silent, turn, retire };
58
129
  }
59
130
  catch (error) {
60
- child.kill('SIGKILL');
131
+ retire();
61
132
  throw error;
62
133
  }
63
134
  }
package/dist/afk.js ADDED
@@ -0,0 +1,17 @@
1
+ import { CLIS } from './clis.js';
2
+ const NOBODY_THERE = 'Nobody is there to answer. Decide for yourself and go on.';
3
+ export const PLAN_APPROVED = { outcome: 'approved' };
4
+ function told(fields) {
5
+ return Object.fromEntries(fields.map((field) => [field, NOBODY_THERE]));
6
+ }
7
+ export function permissionAllowed({ options }) {
8
+ const option = options.find(({ kind }) => kind === 'allow_once') ?? options.find(({ kind }) => kind === 'allow_always');
9
+ return { outcome: { outcome: 'selected', optionId: option.optionId } };
10
+ }
11
+ export function formAnswered(kind, request) {
12
+ const fields = CLIS[kind].questionFields(request);
13
+ return fields.length === 0 ? { action: 'decline' } : { action: 'accept', content: told(fields) };
14
+ }
15
+ export function grokQuestionAnswered({ questions }) {
16
+ return { outcome: 'accepted', answers: told(questions.map(({ question }) => question)) };
17
+ }
package/dist/agents.js CHANGED
@@ -1,16 +1,19 @@
1
1
  import { client } from '@agentclientprotocol/sdk';
2
- import { readFile, realpath } from 'node:fs/promises';
2
+ import { readFile } from 'node:fs/promises';
3
3
  import { setTimeout as delay } from 'node:timers/promises';
4
- import { startAdapter } from './acp.js';
5
- import { CLIS, KIT_VERSION, below, installAdapter, installCli, locate, run, versionOf } from './clis.js';
4
+ import { signedOut, startAdapter } from './acp.js';
5
+ import { CLIS, KIT_RELEASE, below, installCli, locate, run, updateCli, versionOf } from './clis.js';
6
6
  import { agentBase, kitHome } from './home.js';
7
- import { updatesItself } from './placement.js';
8
- import { killTree } from './scope.js';
9
7
  import { holdTranscription, transcriptionReport } from './transcription.js';
10
8
  import { KIT_WIRE } from './wire.js';
11
9
  // Two quiet seconds let a fresh conversation start before background model discovery competes for its CPU.
12
10
  const MODEL_PROBE_QUIET_MS = 2_000;
11
+ // A CLI's maker can publish several releases a day, so running each chosen CLI's update command hourly brings a new one to the next conversation within the hour for one small check.
12
+ export const CLI_UPDATE_MS = 60 * 60_000;
13
+ // A sign-in's model read that has not answered in ten seconds leaves its sign-in to the status check, so a hung CLI never holds the sign-in's result.
14
+ const SIGNED_IN_READ_MS = 10_000;
13
15
  const SIGNED_OUT = { signed_in: false, models: [], modes: [] };
16
+ const INSTALLING = { release: null, failure: null, installing: true, ...SIGNED_OUT };
14
17
  function select(options, category) {
15
18
  const option = options.find((candidate) => candidate.category === category);
16
19
  return option?.type === 'select' ? option : undefined;
@@ -69,13 +72,6 @@ async function models(kind, adapter, known) {
69
72
  }
70
73
  return { models: offered, modes };
71
74
  }
72
- async function signedIn(kind, cli, known, signal) {
73
- const probe = CLIS[kind].signedIn;
74
- // A sign-in check that has not answered in half a minute counts as signed out rather than stalling the report.
75
- if ('command' in probe)
76
- return (await run(cli, probe.command, 30_000, false, signal)).status === 0;
77
- return (await offer(kind, cli, known, signal)).signed_in;
78
- }
79
75
  function ended(signal) {
80
76
  return new Promise((_, reject) => {
81
77
  if (signal.aborted)
@@ -102,6 +98,8 @@ async function offer(kind, cli, known, signal) {
102
98
  catch (error) {
103
99
  if (!signal?.aborted)
104
100
  process.stderr.write(`kit: ${kind} did not offer its models: ${causeOf(error)}\n`);
101
+ if (signedOut(error))
102
+ return SIGNED_OUT;
105
103
  return {
106
104
  signed_in: adapter === undefined && 'initializeMeta' in probe ? known.signed_in : true,
107
105
  models: known.models,
@@ -109,26 +107,24 @@ async function offer(kind, cli, known, signal) {
109
107
  };
110
108
  }
111
109
  finally {
112
- if (adapter !== undefined)
113
- killTree(adapter.child);
110
+ adapter?.retire();
114
111
  }
115
112
  }
116
113
  function reported(kind, reading) {
114
+ const { minimum, update } = CLIS[kind];
117
115
  return {
118
116
  kind,
119
117
  release: reading.release,
120
- ...(reading.minimum === undefined ? {} : { minimum: reading.minimum }),
118
+ ...(reading.release !== null && below(reading.release, minimum) ? { minimum, update } : {}),
121
119
  failure: reading.failure,
120
+ ...(reading.installing === undefined ? {} : { installing: reading.installing }),
122
121
  signed_in: reading.signed_in,
123
122
  models: reading.models,
124
123
  modes: reading.modes,
125
124
  full_access: CLIS[kind].fullAccess,
126
125
  };
127
126
  }
128
- function tooOld(kind, release) {
129
- const cli = CLIS[kind];
130
- return `${cli.bin} ${release} is older than ${cli.minimum}, the oldest this Kit runs`;
131
- }
127
+ const NOT_READY = "the Agent's CLI is not ready on this computer";
132
128
  async function sshHostKey() {
133
129
  // Listing a local host key takes a moment, so ten seconds only bounds a stuck ssh-keygen.
134
130
  const listed = await run('ssh-keygen', ['-l', '-E', 'sha256', '-f', '/etc/ssh/ssh_host_ed25519_key.pub'], 10_000);
@@ -163,19 +159,22 @@ export class Agents {
163
159
  reading = Promise.resolve();
164
160
  queues = new Map();
165
161
  installing = Promise.resolve();
162
+ installs = new Map();
166
163
  readings = new Map();
167
164
  reads = new Map();
168
165
  starts = 0;
169
166
  sending = Promise.resolve();
170
167
  sent = null;
171
168
  refreshing = 0;
169
+ loaded = Promise.resolve();
170
+ updating = null;
172
171
  changed;
173
172
  constructor(house, changed = () => undefined) {
174
173
  this.house = house;
175
174
  this.changed = changed;
176
175
  }
177
176
  idle() {
178
- return this.refreshing === 0;
177
+ return this.refreshing === 0 && this.updating === null;
179
178
  }
180
179
  read() {
181
180
  return this.reading.then(() => undefined, () => undefined);
@@ -187,11 +186,11 @@ export class Agents {
187
186
  this.refreshing++;
188
187
  this.changed();
189
188
  const reading = this.read().then(async () => {
190
- this.desired = await this.house.deliver('/kit/agents/desired', {});
189
+ this.desired = await this.house.deliver('/kit/agents/desired/list', {});
191
190
  return this.desired;
192
191
  });
193
192
  this.reading = reading;
194
- reading
193
+ this.loaded = reading
195
194
  .then(({ agents, transcribe }) => Promise.all([
196
195
  holdTranscription(transcribe)
197
196
  .then((changed) => (changed ? this.report() : undefined))
@@ -207,18 +206,25 @@ export class Agents {
207
206
  });
208
207
  return reading.then(() => undefined);
209
208
  }
209
+ keepCurrent(stopping) {
210
+ this.updateAll(this.loaded);
211
+ setInterval(() => {
212
+ if (!stopping())
213
+ this.updateAll(Promise.resolve());
214
+ }, CLI_UPDATE_MS);
215
+ }
210
216
  cli(kind) {
211
217
  this.starts += 1;
212
218
  return this.queue(kind, async () => {
213
219
  const resolved = await this.resolve(kind);
214
220
  if (!('cli' in resolved)) {
215
221
  this.update(kind, resolved);
216
- throw new Error(resolved.failure ?? tooOld(kind, resolved.release));
222
+ throw new Error(NOT_READY);
217
223
  }
218
224
  const { cli, release } = resolved;
219
225
  const known = this.readings.get(kind);
220
- const kept = known?.release === null || known?.minimum !== undefined ? SIGNED_OUT : (known ?? SIGNED_OUT);
221
- if (known?.release !== release || known.minimum !== undefined) {
226
+ const kept = known?.release === null ? SIGNED_OUT : (known ?? SIGNED_OUT);
227
+ if (known?.release !== release || this.installs.has(kind)) {
222
228
  this.update(kind, { release, failure: null, signed_in: kept.signed_in, models: kept.models, modes: kept.modes });
223
229
  }
224
230
  const read = this.nextRead(kind);
@@ -233,7 +239,8 @@ export class Agents {
233
239
  });
234
240
  }
235
241
  located(kind, signal) {
236
- return this.queue(kind, () => this.ensure(kind, signal), signal);
242
+ const owner = {};
243
+ return this.queue(kind, () => this.ensure(kind, signal, owner).finally(() => this.settle(kind, owner)), signal);
237
244
  }
238
245
  async reread(kind) {
239
246
  await this.examine(kind, this.readings.get(kind) ?? SIGNED_OUT, offer);
@@ -241,7 +248,13 @@ export class Agents {
241
248
  }
242
249
  async recheck(kind, signal) {
243
250
  const known = this.readings.get(kind) ?? SIGNED_OUT;
244
- await this.examine(kind, known, async (kind, cli) => ((await signedIn(kind, cli, known, signal)) ? { ...known, signed_in: true } : SIGNED_OUT), signal);
251
+ const owner = {};
252
+ try {
253
+ await this.examine(kind, known, (kind, cli) => offer(kind, cli, known, AbortSignal.any([signal, AbortSignal.timeout(SIGNED_IN_READ_MS)])), signal, owner);
254
+ }
255
+ finally {
256
+ this.settle(kind, owner);
257
+ }
245
258
  if (!signal.aborted)
246
259
  await this.report();
247
260
  }
@@ -255,8 +268,18 @@ export class Agents {
255
268
  this.reads.set(kind, read);
256
269
  return read;
257
270
  }
258
- update(kind, reading) {
271
+ hold(kind, reading) {
259
272
  this.readings.set(kind, reading);
273
+ this.installs.delete(kind);
274
+ }
275
+ update(kind, reading) {
276
+ this.hold(kind, reading);
277
+ this.report().catch(logged);
278
+ }
279
+ settle(kind, owner) {
280
+ if (this.installs.get(kind) !== owner)
281
+ return;
282
+ this.installs.delete(kind);
260
283
  this.report().catch(logged);
261
284
  }
262
285
  queue(kind, work, signal) {
@@ -267,13 +290,12 @@ export class Agents {
267
290
  this.queues.set(kind, queued.catch(() => undefined));
268
291
  return signal === undefined ? queued : Promise.race([queued, ended(signal)]);
269
292
  }
270
- async ensure(kind, signal) {
271
- const failed = await installAdapter(kind, signal);
272
- if (failed !== null)
273
- throw new Error(failed);
293
+ async ensure(kind, signal, owner = {}) {
274
294
  const found = await locate(kind, signal);
275
295
  if (found !== null)
276
296
  return found;
297
+ this.installs.set(kind, owner);
298
+ this.report().catch(logged);
277
299
  const installing = this.installing.catch(() => undefined).then(() => installCli(kind, signal));
278
300
  this.installing = installing;
279
301
  const failure = await installing;
@@ -284,10 +306,10 @@ export class Agents {
284
306
  throw new Error(`the login shell does not find ${CLIS[kind].bin} after its install`);
285
307
  return installed;
286
308
  }
287
- async resolve(kind, signal) {
309
+ async resolve(kind, signal, owner) {
288
310
  let cli;
289
311
  try {
290
- cli = await realpath(await this.ensure(kind, signal));
312
+ cli = await this.ensure(kind, signal, owner);
291
313
  }
292
314
  catch (error) {
293
315
  const failure = causeOf(error);
@@ -297,17 +319,43 @@ export class Agents {
297
319
  const release = await versionOf(cli, signal);
298
320
  if (release === null)
299
321
  return { release: null, failure: `${cli} --version names no version`, ...SIGNED_OUT };
300
- const minimum = CLIS[kind].minimum;
301
- if (below(release, minimum))
302
- return { release, minimum, failure: null, ...SIGNED_OUT };
303
322
  return { cli, release };
304
323
  }
305
- async examine(kind, known, read, signal) {
324
+ async examine(kind, known, read, signal, owner) {
306
325
  const current = this.nextRead(kind);
307
- const resolved = await this.queue(kind, () => this.resolve(kind, signal), signal);
326
+ const resolved = await this.queue(kind, () => this.resolve(kind, signal, owner), signal);
308
327
  const reading = 'cli' in resolved ? { release: resolved.release, failure: null, ...(await read(kind, resolved.cli, known)) } : resolved;
309
328
  if (this.reads.get(kind) === current && !signal?.aborted)
310
- this.readings.set(kind, reading);
329
+ this.hold(kind, reading);
330
+ }
331
+ updateAll(after) {
332
+ if (this.updating !== null)
333
+ return;
334
+ this.updating = after
335
+ .then(async () => {
336
+ for (const kind of this.desired.agents) {
337
+ if (this.installs.has(kind) || !this.readings.get(kind)?.release)
338
+ continue;
339
+ const failure = await updateCli(kind);
340
+ if (failure !== null)
341
+ process.stderr.write(`kit: ${kind} did not update: ${failure}\n`);
342
+ await this.readVersion(kind);
343
+ }
344
+ })
345
+ .catch(logged)
346
+ .finally(() => {
347
+ this.updating = null;
348
+ this.changed();
349
+ });
350
+ this.changed();
351
+ }
352
+ async readVersion(kind) {
353
+ const cli = await locate(kind);
354
+ const release = cli === null ? null : await versionOf(cli);
355
+ const current = this.readings.get(kind);
356
+ if (release === null || !current?.release || current.release === release)
357
+ return;
358
+ this.update(kind, { ...current, release });
311
359
  }
312
360
  async quietOffer(kind, cli, known) {
313
361
  for (let seen = -1; seen !== this.starts;) {
@@ -318,14 +366,14 @@ export class Agents {
318
366
  }
319
367
  async load(kind) {
320
368
  const known = this.readings.get(kind);
321
- if (known !== undefined && known.failure === null && known.minimum === undefined)
369
+ if (known !== undefined && known.failure === null)
322
370
  return;
323
371
  await this.examine(kind, SIGNED_OUT, (kind, cli, known) => this.quietOffer(kind, cli, known));
324
372
  await this.report();
325
373
  }
326
374
  async send() {
327
375
  const agents = this.desired.agents.flatMap((kind) => {
328
- const reading = this.readings.get(kind);
376
+ const reading = this.installs.has(kind) ? INSTALLING : this.readings.get(kind);
329
377
  return reading === undefined ? [] : [reported(kind, reading)];
330
378
  });
331
379
  const hostKey = await sshHostKey();
@@ -333,9 +381,8 @@ export class Agents {
333
381
  const body = {
334
382
  os: await operatingSystem(),
335
383
  ...(form === undefined ? {} : { form }),
336
- kit_version: KIT_VERSION,
384
+ kit_release: KIT_RELEASE,
337
385
  wire: KIT_WIRE,
338
- updates_itself: await updatesItself(),
339
386
  agent_base: agentBase(),
340
387
  agents,
341
388
  transcription: transcriptionReport(),
package/dist/api.js CHANGED
@@ -1,9 +1,9 @@
1
1
  import { setTimeout as delay } from 'node:timers/promises';
2
- import { signInAgain, updateRequired } from './end.js';
2
+ import { signInAgain } from './end.js';
3
3
  import { readEnrolment } from './home.js';
4
4
  import { retryable } from './refusals.js';
5
5
  import { relayed } from './relay.js';
6
- import { KIT_WIRE, KIT_WIRE_HEADER, tooOld } from './wire.js';
6
+ import { endUnserved, KIT_WIRE, KIT_WIRE_HEADER } from './wire.js';
7
7
  export class HouseRefusal extends Error {
8
8
  status;
9
9
  text;
@@ -17,7 +17,7 @@ export function finalRefusal(error) {
17
17
  return error instanceof HouseRefusal && retryable(error.text) === false;
18
18
  }
19
19
  export function retryDelay(attempt) {
20
- // Full jitter, doubling from one second to a 30-second cap, spreads the Kits one outage dropped and retries within half a minute of House's return.
20
+ // Full jitter, doubling from one second to a 30-second cap, spreads the Kit processes one outage dropped and retries within half a minute of House's return.
21
21
  return Math.random() * Math.min(30_000, 1000 * 2 ** attempt);
22
22
  }
23
23
  export async function retrying(sent, signal, pause = retryDelay) {
@@ -45,8 +45,8 @@ export async function post(house, path, body, credential, signal) {
45
45
  signal,
46
46
  });
47
47
  const text = await answer.text();
48
- if (!answer.ok && tooOld(text))
49
- updateRequired(house);
48
+ if (!answer.ok)
49
+ endUnserved(text);
50
50
  if (!answer.ok)
51
51
  throw new HouseRefusal(path, answer.status, text);
52
52
  return JSON.parse(text);