@agentshouse/kit 0.2.1-c9a26041e119a → 0.2.1-ca0e1517cce79

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 (138) hide show
  1. package/README.md +28 -28
  2. package/dist/acp.js +36 -16
  3. package/dist/agents.js +52 -19
  4. package/dist/api.js +5 -5
  5. package/dist/app-git.js +10 -26
  6. package/dist/bootstrap.json +4 -4
  7. package/dist/bridge.js +4 -7
  8. package/dist/calls.js +63 -0
  9. package/dist/chatgpt.js +7 -1
  10. package/dist/clis.js +15 -3
  11. package/dist/{stream.js → connection.js} +33 -30
  12. package/dist/conversations.js +404 -154
  13. package/dist/copies.js +77 -50
  14. package/dist/end.js +9 -4
  15. package/dist/events.js +6 -2
  16. package/dist/files.js +139 -37
  17. package/dist/git.js +3 -4
  18. package/dist/home.js +27 -13
  19. package/dist/house-cli.js +300 -0
  20. package/dist/house-main.js +7 -289
  21. package/dist/instructions.js +28 -7
  22. package/dist/kit-cli.js +68 -0
  23. package/dist/kit-main.js +8 -67
  24. package/dist/login.js +15 -8
  25. package/dist/logout.js +0 -2
  26. package/dist/mcp.js +4 -2
  27. package/dist/placement.js +9 -18
  28. package/dist/resident.js +88 -37
  29. package/dist/scope.js +3 -0
  30. package/dist/service.js +23 -1
  31. package/dist/sign-in.js +19 -37
  32. package/dist/skills.js +12 -93
  33. package/dist/transcription.js +51 -20
  34. package/dist/translate.js +2 -8
  35. package/dist/update.js +42 -45
  36. package/dist/web-wizard.js +100 -0
  37. package/dist/wire.js +19 -3
  38. package/dist/work.js +3 -5
  39. package/package.json +12 -12
  40. package/how-we-work.md +0 -33
  41. package/skills/ask-matt/LICENSE +0 -21
  42. package/skills/ask-matt/PHASE-BOUNDARIES.md +0 -55
  43. package/skills/ask-matt/SKILL.md +0 -97
  44. package/skills/ask-matt/agents/openai.yaml +0 -5
  45. package/skills/code-review/LICENSE +0 -21
  46. package/skills/code-review/SKILL.md +0 -89
  47. package/skills/code-review/agents/openai.yaml +0 -3
  48. package/skills/codebase-design/DEEPENING.md +0 -37
  49. package/skills/codebase-design/DESIGN-IT-TWICE.md +0 -44
  50. package/skills/codebase-design/LICENSE +0 -21
  51. package/skills/codebase-design/SKILL.md +0 -114
  52. package/skills/codebase-design/agents/openai.yaml +0 -3
  53. package/skills/diagnosing-bugs/LICENSE +0 -21
  54. package/skills/diagnosing-bugs/SKILL.md +0 -138
  55. package/skills/diagnosing-bugs/agents/openai.yaml +0 -3
  56. package/skills/diagnosing-bugs/scripts/hitl-loop.template.sh +0 -44
  57. package/skills/domain-modeling/ADR-FORMAT.md +0 -47
  58. package/skills/domain-modeling/GLOSSARY-FORMAT.md +0 -60
  59. package/skills/domain-modeling/LICENSE +0 -21
  60. package/skills/domain-modeling/SKILL.md +0 -74
  61. package/skills/domain-modeling/agents/openai.yaml +0 -3
  62. package/skills/grill-me/LICENSE +0 -21
  63. package/skills/grill-me/SKILL.md +0 -7
  64. package/skills/grill-me/agents/openai.yaml +0 -5
  65. package/skills/grill-with-docs/LICENSE +0 -21
  66. package/skills/grill-with-docs/SKILL.md +0 -7
  67. package/skills/grill-with-docs/agents/openai.yaml +0 -5
  68. package/skills/grilling/LICENSE +0 -21
  69. package/skills/grilling/SKILL.md +0 -30
  70. package/skills/grilling/agents/openai.yaml +0 -3
  71. package/skills/handoff/LICENSE +0 -21
  72. package/skills/handoff/SKILL.md +0 -16
  73. package/skills/handoff/agents/openai.yaml +0 -5
  74. package/skills/implement/LICENSE +0 -21
  75. package/skills/implement/SKILL.md +0 -17
  76. package/skills/implement/agents/openai.yaml +0 -5
  77. package/skills/implement-spec/LICENSE +0 -21
  78. package/skills/implement-spec/SKILL.md +0 -40
  79. package/skills/implement-spec/agents/openai.yaml +0 -5
  80. package/skills/improve-codebase-architecture/HTML-REPORT.md +0 -123
  81. package/skills/improve-codebase-architecture/LICENSE +0 -21
  82. package/skills/improve-codebase-architecture/SKILL.md +0 -71
  83. package/skills/improve-codebase-architecture/agents/openai.yaml +0 -5
  84. package/skills/pr/CREDITS.md +0 -3
  85. package/skills/pr/LICENSE +0 -21
  86. package/skills/pr/SKILL.md +0 -170
  87. package/skills/pr/agents/openai.yaml +0 -3
  88. package/skills/prototype/LICENSE +0 -21
  89. package/skills/prototype/LOGIC.md +0 -67
  90. package/skills/prototype/SKILL.md +0 -26
  91. package/skills/prototype/UI.md +0 -112
  92. package/skills/prototype/agents/openai.yaml +0 -3
  93. package/skills/research/LICENSE +0 -21
  94. package/skills/research/SKILL.md +0 -12
  95. package/skills/research/agents/openai.yaml +0 -3
  96. package/skills/retro/LICENSE +0 -21
  97. package/skills/retro/SKILL.md +0 -44
  98. package/skills/retro/agents/openai.yaml +0 -5
  99. package/skills/tdd/LICENSE +0 -21
  100. package/skills/tdd/SKILL.md +0 -38
  101. package/skills/tdd/agents/openai.yaml +0 -3
  102. package/skills/tdd/mocking.md +0 -59
  103. package/skills/tdd/tests.md +0 -77
  104. package/skills/teach/GLOSSARY-FORMAT.md +0 -35
  105. package/skills/teach/LEARNING-RECORD-FORMAT.md +0 -46
  106. package/skills/teach/LICENSE +0 -21
  107. package/skills/teach/MISSION-FORMAT.md +0 -31
  108. package/skills/teach/RESOURCES-FORMAT.md +0 -32
  109. package/skills/teach/SKILL.md +0 -140
  110. package/skills/teach/agents/openai.yaml +0 -5
  111. package/skills/to-questionnaire/LICENSE +0 -21
  112. package/skills/to-questionnaire/SKILL.md +0 -54
  113. package/skills/to-questionnaire/agents/openai.yaml +0 -5
  114. package/skills/to-spec/LICENSE +0 -21
  115. package/skills/to-spec/SKILL.md +0 -75
  116. package/skills/to-spec/agents/openai.yaml +0 -5
  117. package/skills/to-tickets/LICENSE +0 -21
  118. package/skills/to-tickets/SKILL.md +0 -105
  119. package/skills/to-tickets/agents/openai.yaml +0 -5
  120. package/skills/triage/AGENT-BRIEF.md +0 -207
  121. package/skills/triage/LICENSE +0 -21
  122. package/skills/triage/OUT-OF-SCOPE.md +0 -105
  123. package/skills/triage/SKILL.md +0 -112
  124. package/skills/triage/agents/openai.yaml +0 -5
  125. package/skills/wait-what/LICENSE +0 -21
  126. package/skills/wait-what/SKILL.md +0 -7
  127. package/skills/wait-what/agents/openai.yaml +0 -5
  128. package/skills/wayfinder/LICENSE +0 -21
  129. package/skills/wayfinder/SKILL.md +0 -128
  130. package/skills/wayfinder/agents/openai.yaml +0 -5
  131. package/skills/wizard/LICENSE +0 -21
  132. package/skills/wizard/SKILL.md +0 -44
  133. package/skills/wizard/agents/openai.yaml +0 -3
  134. package/skills/wizard/template.sh +0 -223
  135. package/skills/writing-for-agents/LICENSE +0 -21
  136. package/skills/writing-for-agents/SKILL-MECHANICS.md +0 -22
  137. package/skills/writing-for-agents/SKILL.md +0 -81
  138. package/skills/writing-for-agents/agents/openai.yaml +0 -3
package/dist/clis.js CHANGED
@@ -60,6 +60,9 @@ export async function allowHouseInCodex(path) {
60
60
  await rename(temporary, file);
61
61
  }
62
62
  async function nothing() { }
63
+ function answered(error) {
64
+ return typeof error === 'object' && error !== null ? error : {};
65
+ }
63
66
  function bridgeInClaudeSandbox(bridge) {
64
67
  return process.platform === 'darwin' ? { allowUnixSockets: [bridge] } : { allowAllUnixSockets: true };
65
68
  }
@@ -77,6 +80,10 @@ export const CLIS = {
77
80
  args: [],
78
81
  fullAccess: 'agent-full-access',
79
82
  sessionMeta: () => ({}),
83
+ unknownSession: (error) => {
84
+ const { code, data } = answered(error);
85
+ return code === -32603 && typeof data?.details === 'string' && data.details.startsWith('no rollout found');
86
+ },
80
87
  renames: true,
81
88
  allowHouse: allowHouseInCodex,
82
89
  signedIn: { command: ['login', 'status'] },
@@ -106,6 +113,7 @@ export const CLIS = {
106
113
  emitRawSDKMessages: RAW_SUBTYPES.map((subtype) => ({ type: 'system', subtype })),
107
114
  },
108
115
  }),
116
+ unknownSession: (error) => answered(error).code === -32002,
109
117
  renames: false,
110
118
  allowHouse: nothing,
111
119
  signedIn: { command: ['auth', 'status'] },
@@ -120,6 +128,7 @@ export const CLIS = {
120
128
  args: ['--sandbox', 'off', 'agent', '--always-approve', '--no-leader', 'stdio'],
121
129
  fullAccess: null,
122
130
  sessionMeta: () => ({}),
131
+ unknownSession: (error) => answered(error).data?.code === 'FS_NOT_FOUND',
123
132
  renames: false,
124
133
  allowHouse: nothing,
125
134
  signedIn: { initializeMeta: 'defaultAuthMethodId' },
@@ -128,7 +137,7 @@ export const CLIS = {
128
137
  },
129
138
  };
130
139
  const KIT_PACKAGE = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
131
- export const KIT_VERSION = KIT_PACKAGE.version;
140
+ export const KIT_RELEASE = KIT_PACKAGE.version;
132
141
  const PROXY = /^https?_proxy$/i;
133
142
  const VERSION = /\d+\.\d+\.\d+(?:-[0-9A-Za-z.]+)?/;
134
143
  // An install still running after fifteen minutes is ended and reported as failed, so a hung download cannot hold its CLI's report.
@@ -216,10 +225,13 @@ const USER_BIN = 'case ":$PATH:" in *":$HOME/.local/bin:"*) ;; *) PATH="$PATH:$H
216
225
  function inLoginShell(script, argument = '', signal) {
217
226
  return run(loginShell(), ['-l', '-i', '-c', `exec /bin/sh -c '${USER_BIN}; ${script}' sh ${argument}`], READ_MS, true, signal);
218
227
  }
219
- export async function locate(kind, signal) {
220
- const ran = await inLoginShell(LOOKUP, CLIS[kind].bin, signal);
228
+ export async function onLoginPath(program, signal) {
229
+ const ran = await inLoginShell(LOOKUP, program, signal);
221
230
  return ran.stdout.split('\n').findLast((line) => line.startsWith(FOUND))?.slice(FOUND.length) ?? null;
222
231
  }
232
+ export function locate(kind, signal) {
233
+ return onLoginPath(CLIS[kind].bin, signal);
234
+ }
223
235
  export async function loginPath() {
224
236
  const marker = 'house-kit-path ';
225
237
  const ran = await inLoginShell(`printf "${marker}%s\\n" "$PATH"`);
@@ -1,24 +1,24 @@
1
1
  import { subscribe } from 'node:diagnostics_channel';
2
- import { finalRefusal, HouseRefusal, retryDelay } from './api.js';
3
- import { end, REPLACED, signInAgain, updateRequired } from './end.js';
2
+ import { HouseRefusal, retryDelay } from './api.js';
3
+ import { end, REPLACED, signInAgain } from './end.js';
4
4
  import { readEnrolment } from './home.js';
5
5
  import { relayed } from './relay.js';
6
- import { KIT_WIRE, tooOld } from './wire.js';
6
+ import { endUnserved, KIT_WIRE } from './wire.js';
7
7
  const PATH = '/kit/stream';
8
8
  const SUBPROTOCOL = `house.kit.stream.${KIT_WIRE}`;
9
9
  const REFUSAL_HEADER = 'x-house-refusal';
10
- // House beats each stream every thirty seconds, so two silent beats mean this Kit cannot hear House.
11
- export const STREAM_SILENCE_MS = 60_000;
12
- const SYSTEM_STREAM_CLOCK = {
10
+ // House beats each Kit connection every thirty seconds, so two silent beats mean this Kit process cannot hear House.
11
+ export const CONNECTION_SILENCE_MS = 60_000;
12
+ const SYSTEM_CONNECTION_CLOCK = {
13
13
  later: (delay, callback) => setTimeout(callback, delay),
14
14
  clear: (timer) => clearTimeout(timer),
15
15
  };
16
- export class StreamSilence {
16
+ export class ConnectionSilence {
17
17
  timer = null;
18
18
  silent;
19
19
  clock;
20
20
  interval;
21
- constructor(silent, clock = SYSTEM_STREAM_CLOCK, interval = STREAM_SILENCE_MS) {
21
+ constructor(silent, clock = SYSTEM_CONNECTION_CLOCK, interval = CONNECTION_SILENCE_MS) {
22
22
  this.silent = silent;
23
23
  this.clock = clock;
24
24
  this.interval = interval;
@@ -37,7 +37,7 @@ export class StreamSilence {
37
37
  this.timer = null;
38
38
  }
39
39
  }
40
- function streamUrl(house) {
40
+ function connectionUrl(house) {
41
41
  const url = new URL(PATH, house);
42
42
  url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
43
43
  return url;
@@ -56,13 +56,13 @@ subscribe('undici:request:headers', (message) => {
56
56
  return;
57
57
  refused = new HouseRefusal(PATH, response.statusCode, header(response.headers, REFUSAL_HEADER) || response.statusText);
58
58
  });
59
- export function holdStream(handlers) {
60
- let socket = null;
59
+ export function holdConnection(handlers) {
60
+ let connection = null;
61
61
  let failures = 0;
62
62
  const connect = async () => {
63
63
  const { house, credential } = (await readEnrolment());
64
64
  refused = null;
65
- const opening = new WebSocket(relayed(streamUrl(house)), {
65
+ const opening = new WebSocket(relayed(connectionUrl(house)), {
66
66
  protocols: [SUBPROTOCOL],
67
67
  headers: { authorization: `Bearer ${credential}` },
68
68
  });
@@ -71,30 +71,31 @@ export function holdStream(handlers) {
71
71
  const closed = (event) => {
72
72
  silence?.stop();
73
73
  silence = null;
74
- if (socket === opening)
75
- socket = null;
76
- process.stderr.write(`kit: control stream closed ${event.code} ${event.reason}\n`);
74
+ if (connection === opening)
75
+ connection = null;
76
+ handlers.closed();
77
+ process.stderr.write(`kit: connection closed ${event.code} ${event.reason}\n`);
77
78
  if (event.reason === 'replaced')
78
79
  end(REPLACED);
79
80
  if (event.reason === 'credential_rejected' || refused?.status === 401) {
80
81
  void signInAgain(credential);
81
82
  return;
82
83
  }
83
- if (refused !== null && tooOld(refused.text))
84
- updateRequired(house);
85
- if (finalRefusal(refused))
86
- end(refused.message);
87
- // A closed socket reopens in one to three seconds, spread so Kits one restart closed return apart; an opening House refused as retryable or left unanswered backs off on the jittered curve.
84
+ if (refused !== null)
85
+ endUnserved(refused.text);
86
+ if (!opened && refused !== null)
87
+ process.stderr.write(`kit: ${refused.message}\n`);
88
+ // A closed connection reopens in one to three seconds, spread so Kit processes one restart closed return apart; an opening House refused or left unanswered backs off on the jittered curve, retryable or not, since a resident outlives a House deploy.
88
89
  setTimeout(() => void connect(), opened ? 1000 + Math.random() * 2000 : retryDelay(failures++));
89
90
  };
90
91
  opening.onopen = () => {
91
92
  opened = true;
92
93
  failures = 0;
93
- socket = opening;
94
- silence = new StreamSilence(() => {
95
- if (socket !== opening)
94
+ connection = opening;
95
+ silence = new ConnectionSilence(() => {
96
+ if (connection !== opening)
96
97
  return;
97
- socket = null;
98
+ connection = null;
98
99
  opening.onclose = null;
99
100
  opening.close();
100
101
  closed(new CloseEvent('close', { code: 1006, reason: 'heartbeat_missed' }));
@@ -104,19 +105,21 @@ export function holdStream(handlers) {
104
105
  };
105
106
  opening.onmessage = (event) => {
106
107
  silence?.heard();
107
- const frame = JSON.parse(String(event.data));
108
- if (frame.type !== 'beat')
109
- handlers.frame(frame);
108
+ const arrived = JSON.parse(String(event.data));
109
+ if (arrived.type === 'input')
110
+ handlers.call(arrived);
111
+ else if (arrived.type !== 'beat')
112
+ handlers.notification(arrived);
110
113
  };
111
114
  opening.onerror = () => undefined;
112
115
  opening.onclose = closed;
113
116
  };
114
117
  void connect();
115
118
  return {
116
- send(frame) {
117
- if (socket === null || socket.readyState !== WebSocket.OPEN)
119
+ send(notification) {
120
+ if (connection === null || connection.readyState !== WebSocket.OPEN)
118
121
  return false;
119
- socket.send(JSON.stringify(frame));
122
+ connection.send(JSON.stringify(notification));
120
123
  return true;
121
124
  },
122
125
  };