@agentshouse/kit 0.2.1-cf110d15f69c8 → 0.2.1-cf268dff1869b
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.
- package/README.md +38 -37
- package/dist/acp.js +90 -19
- package/dist/agents.js +155 -45
- package/dist/api.js +5 -1
- package/dist/app-git.js +10 -26
- package/dist/authority-main.js +2 -2
- package/dist/bridge.js +4 -7
- package/dist/building.js +50 -0
- package/dist/calls.js +71 -0
- package/dist/chatgpt.js +32 -0
- package/dist/clis.js +52 -42
- package/dist/connection.js +105 -0
- package/dist/conversations.js +526 -175
- package/dist/copies.js +89 -52
- package/dist/end.js +17 -2
- package/dist/events.js +33 -8
- package/dist/files.js +139 -31
- package/dist/git.js +13 -11
- package/dist/home.js +56 -12
- package/dist/house-cli.js +299 -0
- package/dist/house-main.js +7 -206
- package/dist/instructions.js +7 -11
- package/dist/kit-cli.js +68 -0
- package/dist/kit-main.js +8 -22
- package/dist/login.js +49 -31
- package/dist/logout.js +0 -2
- package/dist/mcp.js +6 -2
- package/dist/placement.js +31 -0
- package/dist/relay.js +22 -1
- package/dist/resident.js +97 -38
- package/dist/scope.js +15 -4
- package/dist/scripts.js +255 -0
- package/dist/service.js +23 -1
- package/dist/sign-in.js +22 -39
- package/dist/silence.js +28 -0
- package/dist/skills.js +49 -35
- package/dist/transcription.js +85 -45
- package/dist/translate.js +2 -8
- package/dist/update.js +113 -105
- package/dist/wire.js +40 -0
- package/dist/work.js +3 -5
- package/package.json +20 -20
- package/dist/bootstrap.json +0 -24
- package/dist/clis-main.js +0 -23
- package/dist/stream.js +0 -74
- package/how-we-work.md +0 -23
- package/skills/ask-matt/LICENSE +0 -21
- package/skills/ask-matt/PHASE-BOUNDARIES.md +0 -55
- package/skills/ask-matt/SKILL.md +0 -91
- package/skills/ask-matt/agents/openai.yaml +0 -4
- package/skills/code-review/LICENSE +0 -21
- package/skills/code-review/SKILL.md +0 -89
- package/skills/code-review/agents/openai.yaml +0 -3
- package/skills/codebase-design/DEEPENING.md +0 -37
- package/skills/codebase-design/DESIGN-IT-TWICE.md +0 -44
- package/skills/codebase-design/LICENSE +0 -21
- package/skills/codebase-design/SKILL.md +0 -116
- package/skills/codebase-design/agents/openai.yaml +0 -3
- package/skills/diagnosing-bugs/LICENSE +0 -21
- package/skills/diagnosing-bugs/SKILL.md +0 -140
- package/skills/diagnosing-bugs/agents/openai.yaml +0 -3
- package/skills/diagnosing-bugs/scripts/hitl-loop.template.sh +0 -44
- package/skills/domain-modeling/ADR-FORMAT.md +0 -47
- package/skills/domain-modeling/CONTEXT-FORMAT.md +0 -60
- package/skills/domain-modeling/LICENSE +0 -21
- package/skills/domain-modeling/SKILL.md +0 -76
- package/skills/domain-modeling/agents/openai.yaml +0 -3
- package/skills/grill-me/LICENSE +0 -21
- package/skills/grill-me/SKILL.md +0 -8
- package/skills/grill-me/agents/openai.yaml +0 -4
- package/skills/grill-with-docs/LICENSE +0 -21
- package/skills/grill-with-docs/SKILL.md +0 -8
- package/skills/grill-with-docs/agents/openai.yaml +0 -4
- package/skills/grilling/LICENSE +0 -21
- package/skills/grilling/SKILL.md +0 -30
- package/skills/grilling/agents/openai.yaml +0 -3
- package/skills/handoff/LICENSE +0 -21
- package/skills/handoff/SKILL.md +0 -17
- package/skills/handoff/agents/openai.yaml +0 -4
- package/skills/implement/LICENSE +0 -21
- package/skills/implement/SKILL.md +0 -16
- package/skills/implement/agents/openai.yaml +0 -4
- package/skills/improve-codebase-architecture/HTML-REPORT.md +0 -123
- package/skills/improve-codebase-architecture/LICENSE +0 -21
- package/skills/improve-codebase-architecture/SKILL.md +0 -72
- package/skills/improve-codebase-architecture/agents/openai.yaml +0 -4
- package/skills/prototype/LICENSE +0 -21
- package/skills/prototype/LOGIC.md +0 -67
- package/skills/prototype/SKILL.md +0 -28
- package/skills/prototype/UI.md +0 -112
- package/skills/prototype/agents/openai.yaml +0 -3
- package/skills/research/LICENSE +0 -21
- package/skills/research/SKILL.md +0 -14
- package/skills/research/agents/openai.yaml +0 -3
- package/skills/resolving-merge-conflicts/LICENSE +0 -21
- package/skills/resolving-merge-conflicts/SKILL.md +0 -16
- package/skills/resolving-merge-conflicts/agents/openai.yaml +0 -3
- package/skills/tdd/LICENSE +0 -21
- package/skills/tdd/SKILL.md +0 -40
- package/skills/tdd/agents/openai.yaml +0 -3
- package/skills/tdd/mocking.md +0 -59
- package/skills/tdd/tests.md +0 -77
- package/skills/teach/GLOSSARY-FORMAT.md +0 -35
- package/skills/teach/LEARNING-RECORD-FORMAT.md +0 -46
- package/skills/teach/LICENSE +0 -21
- package/skills/teach/MISSION-FORMAT.md +0 -31
- package/skills/teach/RESOURCES-FORMAT.md +0 -32
- package/skills/teach/SKILL.md +0 -141
- package/skills/teach/agents/openai.yaml +0 -4
- package/skills/to-questionnaire/LICENSE +0 -21
- package/skills/to-questionnaire/SKILL.md +0 -55
- package/skills/to-questionnaire/agents/openai.yaml +0 -4
- package/skills/to-spec/LICENSE +0 -21
- package/skills/to-spec/SKILL.md +0 -76
- package/skills/to-spec/agents/openai.yaml +0 -4
- package/skills/to-tickets/LICENSE +0 -21
- package/skills/to-tickets/SKILL.md +0 -106
- package/skills/to-tickets/agents/openai.yaml +0 -4
- package/skills/wait-what/LICENSE +0 -21
- package/skills/wait-what/SKILL.md +0 -8
- package/skills/wait-what/agents/openai.yaml +0 -4
- package/skills/wayfinder/LICENSE +0 -21
- package/skills/wayfinder/SKILL.md +0 -129
- package/skills/wayfinder/agents/openai.yaml +0 -4
- package/skills/writing-for-agents/LICENSE +0 -21
- package/skills/writing-for-agents/SKILL-MECHANICS.md +0 -22
- package/skills/writing-for-agents/SKILL.md +0 -83
- package/skills/writing-for-agents/agents/openai.yaml +0 -3
package/dist/instructions.js
CHANGED
|
@@ -1,10 +1,6 @@
|
|
|
1
|
+
import { agentInstructions } from '@agentshouse/skills';
|
|
1
2
|
import { HOUSE_REF } from './git.js';
|
|
2
|
-
|
|
3
|
-
const SOURCE_LINE = "From House:";
|
|
4
|
-
const HOUSE_LINE = "Work with House through the `house` CLI: run `house --help`, and `house find_command` for House's guides and formats.";
|
|
5
|
-
const FILE_LINE = 'To give the User a file, upload it with `house upload` and link it; for an App, a Site or a website, follow `house find_command \'{"query":"app"}\'`. Never start a server.';
|
|
6
|
-
const READ_LINE = "Optional per-Room instructions: `/rooms/private/rooms/<handle>/AGENTS.md`.";
|
|
7
|
-
const COPIES_LINE = `House Local copies; before work run \`house fetch\` and rebase onto \`${HOUSE_REF}\`; after it commit, then \`house push\`:`;
|
|
3
|
+
const OWNER_RULES = '/rooms/private/owner-rules.md';
|
|
8
4
|
const UNREADABLE = /^(?:\S+: )?(?:path_not_found|room_not_found|operation_denied)\b/;
|
|
9
5
|
const FAILED = /^exit: [1-9]\d*$/;
|
|
10
6
|
const CUT = /^stderr: shell: output_cut (\d+) of \d+ bytes; continue with: (.+)$/;
|
|
@@ -12,9 +8,9 @@ function cutOf(lines) {
|
|
|
12
8
|
const cut = CUT.exec(lines[0] ?? '');
|
|
13
9
|
return cut !== null && Buffer.byteLength(lines.slice(1).join('\n')) === Number(cut[1]) ? cut : null;
|
|
14
10
|
}
|
|
15
|
-
async function
|
|
11
|
+
async function readOwnerRules(bridge) {
|
|
16
12
|
let document = '';
|
|
17
|
-
for (let command = `cat ${
|
|
13
|
+
for (let command = `cat ${OWNER_RULES}`; command !== undefined;) {
|
|
18
14
|
const read = await bridge.tool('shell', { command });
|
|
19
15
|
const text = read.content.map((content) => content.text).join('\n');
|
|
20
16
|
const lines = text.split('\n');
|
|
@@ -28,9 +24,9 @@ async function howWeWork(bridge) {
|
|
|
28
24
|
document += lines.slice(cut === null ? 0 : 1).join('\n');
|
|
29
25
|
command = cut?.[2];
|
|
30
26
|
}
|
|
31
|
-
return document
|
|
27
|
+
return document;
|
|
32
28
|
}
|
|
33
29
|
export async function instructions(bridge, base, copies) {
|
|
34
|
-
const lines =
|
|
35
|
-
return [lines.join('\n'), base, await
|
|
30
|
+
const lines = agentInstructions(HOUSE_REF, copies);
|
|
31
|
+
return [lines.join('\n'), base, (await readOwnerRules(bridge)).replace(/\n$/, '')].filter((part) => part !== '').join('\n\n');
|
|
36
32
|
}
|
package/dist/kit-cli.js
ADDED
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import { parseArgs } from 'node:util';
|
|
2
|
+
import { answerGitCredential } from './app-git.js';
|
|
3
|
+
import { chatgpt } from './chatgpt.js';
|
|
4
|
+
import { login } from './login.js';
|
|
5
|
+
import { logout } from './logout.js';
|
|
6
|
+
import { proxyUnlessRelayed } from './relay.js';
|
|
7
|
+
import { resident } from './resident.js';
|
|
8
|
+
const USAGE = 'usage: kit <login|logout|resident|chatgpt>\n';
|
|
9
|
+
const COMMANDS = new Map([
|
|
10
|
+
[
|
|
11
|
+
'logout',
|
|
12
|
+
{
|
|
13
|
+
usage: 'usage: kit logout',
|
|
14
|
+
about: "disconnects this computer, stops the Kit process and ends your own agent's connection",
|
|
15
|
+
operands: 0,
|
|
16
|
+
run: logout,
|
|
17
|
+
},
|
|
18
|
+
],
|
|
19
|
+
[
|
|
20
|
+
'resident',
|
|
21
|
+
{
|
|
22
|
+
usage: 'usage: kit resident',
|
|
23
|
+
about: "keeps this Environment connected; Kit's service runs it",
|
|
24
|
+
operands: 0,
|
|
25
|
+
run: resident,
|
|
26
|
+
},
|
|
27
|
+
],
|
|
28
|
+
[
|
|
29
|
+
'git-credential',
|
|
30
|
+
{
|
|
31
|
+
usage: 'usage: kit git-credential <get|store|erase>',
|
|
32
|
+
about: "answers git with your own agent's House credential; git runs it",
|
|
33
|
+
operands: 1,
|
|
34
|
+
run: ([operation]) => answerGitCredential(operation),
|
|
35
|
+
},
|
|
36
|
+
],
|
|
37
|
+
]);
|
|
38
|
+
const [command, ...argv] = process.argv.slice(2);
|
|
39
|
+
proxyUnlessRelayed();
|
|
40
|
+
async function run() {
|
|
41
|
+
if (command === 'login')
|
|
42
|
+
return login(argv);
|
|
43
|
+
if (command === 'chatgpt')
|
|
44
|
+
return chatgpt(argv);
|
|
45
|
+
if (command === '--help') {
|
|
46
|
+
parseArgs({ args: argv });
|
|
47
|
+
process.stdout.write(USAGE);
|
|
48
|
+
return;
|
|
49
|
+
}
|
|
50
|
+
const chosen = COMMANDS.get(command ?? '');
|
|
51
|
+
if (chosen === undefined) {
|
|
52
|
+
process.stderr.write(USAGE);
|
|
53
|
+
process.exitCode = 2;
|
|
54
|
+
return;
|
|
55
|
+
}
|
|
56
|
+
const { values, positionals } = parseArgs({ args: argv, options: { help: { type: 'boolean', default: false } }, allowPositionals: true });
|
|
57
|
+
if (positionals.length > chosen.operands)
|
|
58
|
+
throw new Error(`unexpected argument ${positionals[chosen.operands]}; ${chosen.usage}`);
|
|
59
|
+
if (values.help) {
|
|
60
|
+
process.stdout.write(`${chosen.usage}\n ${chosen.about}\n`);
|
|
61
|
+
return;
|
|
62
|
+
}
|
|
63
|
+
return chosen.run(positionals);
|
|
64
|
+
}
|
|
65
|
+
run().catch((error) => {
|
|
66
|
+
process.stderr.write(`kit: ${error instanceof Error ? error.message : String(error)}\n`);
|
|
67
|
+
process.exitCode = 1;
|
|
68
|
+
});
|
package/dist/kit-main.js
CHANGED
|
@@ -1,24 +1,10 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
import { logout } from './logout.js';
|
|
6
|
-
import { resident } from './resident.js';
|
|
7
|
-
const [command, ...argv] = process.argv.slice(2);
|
|
8
|
-
setGlobalProxyFromEnv();
|
|
9
|
-
async function run() {
|
|
10
|
-
if (command === 'login')
|
|
11
|
-
return login(argv);
|
|
12
|
-
if (command === 'logout')
|
|
13
|
-
return logout();
|
|
14
|
-
if (command === 'resident')
|
|
15
|
-
return resident();
|
|
16
|
-
if (command === 'git-credential')
|
|
17
|
-
return answerGitCredential(argv[0]);
|
|
18
|
-
process.stderr.write('usage: kit <login|logout|resident>\n');
|
|
19
|
-
process.exitCode = 2;
|
|
20
|
-
}
|
|
21
|
-
run().catch((error) => {
|
|
22
|
-
process.stderr.write(`kit: ${error instanceof Error ? error.message : String(error)}\n`);
|
|
2
|
+
const [major = 0, minor = 0, patch = 0] = process.versions.node.split('.').map(Number);
|
|
3
|
+
if (major < 24 || (major === 24 && (minor < 22 || (minor === 22 && patch < 1)))) {
|
|
4
|
+
process.stderr.write(`kit: the Kit needs Node 24.22.1 or newer; this is ${process.versions.node}\n`);
|
|
23
5
|
process.exitCode = 1;
|
|
24
|
-
}
|
|
6
|
+
}
|
|
7
|
+
else {
|
|
8
|
+
await import('./kit-cli.js');
|
|
9
|
+
}
|
|
10
|
+
export {};
|
package/dist/login.js
CHANGED
|
@@ -1,17 +1,17 @@
|
|
|
1
1
|
import { spawn } from 'node:child_process';
|
|
2
2
|
import { createHash, randomBytes } from 'node:crypto';
|
|
3
|
-
import { hostname } from 'node:os';
|
|
4
|
-
import { delimiter, dirname } from 'node:path';
|
|
5
3
|
import { parseArgs } from 'node:util';
|
|
6
|
-
import { post, retrying } from './api.js';
|
|
4
|
+
import { HouseRefusal, post, retrying } from './api.js';
|
|
7
5
|
import { placeAppGit } from './app-git.js';
|
|
8
|
-
import {
|
|
9
|
-
import { forgetOwnAgent, readDisconnected, readEnrolment, readOwnAgent, writeEnrolment, writeOwnAgent } from './home.js';
|
|
6
|
+
import { writeCodexRule } from './clis.js';
|
|
7
|
+
import { forgetDisconnected, forgetOwnAgent, readDisconnected, readEnrolment, readOwnAgent, writeEnrolment, writeOwnAgent, } from './home.js';
|
|
10
8
|
import { callHouse, rpc } from './mcp.js';
|
|
9
|
+
import { refusalOf } from './refusals.js';
|
|
11
10
|
import { selectRelay } from './relay.js';
|
|
12
11
|
import { startService } from './service.js';
|
|
13
12
|
import { placeSkillSet } from './skills.js';
|
|
14
|
-
|
|
13
|
+
import { endUnserved } from './wire.js';
|
|
14
|
+
export const DEFAULT_HOUSE = 'https://agents.house';
|
|
15
15
|
const OPENER = process.platform === 'darwin' ? 'open' : 'xdg-open';
|
|
16
16
|
// Polling every two seconds brings the User's confirmation to the waiting Kit moments after they give it.
|
|
17
17
|
const POLL_INTERVAL_MS = 2000;
|
|
@@ -20,21 +20,33 @@ function open(link) {
|
|
|
20
20
|
.on('error', () => undefined)
|
|
21
21
|
.unref();
|
|
22
22
|
}
|
|
23
|
-
async function accepted(house, credential) {
|
|
23
|
+
export async function accepted(house, credential) {
|
|
24
24
|
const checked = await callHouse(house, credential, rpc('tools/list', {}));
|
|
25
25
|
if (checked.status === 200)
|
|
26
26
|
return true;
|
|
27
27
|
if (checked.status === 401)
|
|
28
28
|
return false;
|
|
29
|
+
endUnserved(checked.text);
|
|
29
30
|
throw new Error(`House answered ${checked.status} when Kit checked this computer's own agent's connection: ${checked.text}`);
|
|
30
31
|
}
|
|
31
|
-
const USAGE = `usage: kit login [--house <origin>] [--environment <id>] [--rooms <ref>[,<ref>...] | --no-private]
|
|
32
|
+
const USAGE = `usage: kit login [--house <origin>] [--environment <id>] [--rooms <ref>[,<ref>...] | --no-private]
|
|
33
|
+
kit login [--house <origin>] --code <code>
|
|
32
34
|
--house <origin> the House to connect to, ${DEFAULT_HOUSE} unless one is stored
|
|
33
35
|
--environment <id> reconnect this Environment
|
|
34
36
|
--rooms <ref>[,<ref>...] give this Environment only these Rooms
|
|
35
37
|
--no-private give this Environment every Room but your Private Room
|
|
36
38
|
--code <code> connect this machine with a login code
|
|
37
39
|
`;
|
|
40
|
+
function connected(house, named, environment) {
|
|
41
|
+
if (named === undefined)
|
|
42
|
+
return `Environment ${environment} is connected to ${house}.\n`;
|
|
43
|
+
if (named === environment)
|
|
44
|
+
return `Environment ${environment} is reconnected to ${house}.\n`;
|
|
45
|
+
return `Environment ${named} stays with its account; this computer is connected to ${house} as new Environment ${environment} of the account that confirmed.\n`;
|
|
46
|
+
}
|
|
47
|
+
function gone(error) {
|
|
48
|
+
return error instanceof HouseRefusal && refusalOf(error.text)?.code === 'kit_environment_not_found';
|
|
49
|
+
}
|
|
38
50
|
function chosenRooms(rooms, noPrivate) {
|
|
39
51
|
if (rooms !== undefined && noPrivate)
|
|
40
52
|
throw new Error('--rooms and --no-private are two choices of Rooms; pass one');
|
|
@@ -73,57 +85,63 @@ export async function login(argv) {
|
|
|
73
85
|
selectRelay(relay);
|
|
74
86
|
const house = values.house ?? enrolled?.house ?? DEFAULT_HOUSE;
|
|
75
87
|
const replaces = process.env.HOUSE_KIT_REPLACES;
|
|
76
|
-
const
|
|
88
|
+
const remembered = replaces === undefined && values.environment === undefined && enrolled?.house === house ? enrolled.environment : undefined;
|
|
89
|
+
const environment = replaces === undefined ? (values.environment ?? remembered) : undefined;
|
|
77
90
|
const ownAgent = await readOwnAgent();
|
|
78
91
|
let held = false;
|
|
92
|
+
let named = environment;
|
|
79
93
|
let exchanged;
|
|
80
94
|
if (values.code !== undefined) {
|
|
81
|
-
exchanged = await post(house, '/kit/token', { code: values.code
|
|
95
|
+
exchanged = await post(house, '/kit/token', { code: values.code });
|
|
82
96
|
}
|
|
83
97
|
else {
|
|
84
98
|
held = ownAgent !== null && ownAgent.house === house && (await accepted(house, ownAgent.credential));
|
|
85
99
|
const verifier = randomBytes(32).toString('base64url');
|
|
86
|
-
const
|
|
87
|
-
|
|
88
|
-
...(environment === undefined
|
|
100
|
+
const start = () => retrying(() => post(house, '/kit', {
|
|
101
|
+
...(named === undefined
|
|
89
102
|
? { act: 'new_environment', ...(replaces === undefined ? {} : { replaces }) }
|
|
90
|
-
: { act: 'existing_environment', environment_id:
|
|
103
|
+
: { act: 'existing_environment', environment_id: named }),
|
|
91
104
|
...rooms,
|
|
92
105
|
code_challenge: createHash('sha256').update(verifier).digest('base64url'),
|
|
93
106
|
...(held ? {} : { headless: true }),
|
|
94
107
|
}));
|
|
108
|
+
let started;
|
|
109
|
+
try {
|
|
110
|
+
started = await start();
|
|
111
|
+
}
|
|
112
|
+
catch (error) {
|
|
113
|
+
if (remembered === undefined || !gone(error))
|
|
114
|
+
throw error;
|
|
115
|
+
await forgetDisconnected();
|
|
116
|
+
process.stdout.write(`House no longer holds Environment ${remembered}; connecting this computer as a new one.\n`);
|
|
117
|
+
named = undefined;
|
|
118
|
+
started = await start();
|
|
119
|
+
}
|
|
95
120
|
process.stdout.write(`Open this link and confirm: ${started.start_url}\n`);
|
|
96
121
|
open(started.start_url);
|
|
97
122
|
exchanged = await retrying(() => post(house, '/kit/token', { login: started.login, code_verifier: verifier }), undefined, () => POLL_INTERVAL_MS);
|
|
98
123
|
}
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
}
|
|
102
|
-
catch (error) {
|
|
103
|
-
process.stderr.write(`kit: the skills could not be placed: ${error.message}\n`);
|
|
104
|
-
}
|
|
105
|
-
try {
|
|
106
|
-
const shell = await loginPath().catch(() => '');
|
|
107
|
-
await allowHouseInCodex([dirname(process.execPath), process.env.PATH ?? '', shell].join(delimiter));
|
|
108
|
-
}
|
|
109
|
-
catch (error) {
|
|
110
|
-
process.stderr.write(`kit: Codex's rule for house could not be written: ${error.message}\n`);
|
|
111
|
-
}
|
|
124
|
+
await placeSkillSet(house);
|
|
125
|
+
await writeCodexRule().catch((error) => process.stderr.write(`kit: ${error.message}\n`));
|
|
126
|
+
const relayRecord = relay === undefined ? {} : { relay };
|
|
112
127
|
await writeEnrolment({
|
|
113
128
|
house,
|
|
114
|
-
...
|
|
129
|
+
...relayRecord,
|
|
115
130
|
environment: exchanged.environment,
|
|
116
131
|
credential: exchanged.credential,
|
|
117
132
|
});
|
|
118
|
-
process.stdout.write(
|
|
133
|
+
process.stdout.write(connected(house, named, exchanged.environment));
|
|
119
134
|
if (exchanged.headless_credential !== undefined) {
|
|
120
|
-
await writeOwnAgent({ house, user: exchanged.user, credential: exchanged.headless_credential });
|
|
135
|
+
await writeOwnAgent({ house, ...relayRecord, user: exchanged.user, credential: exchanged.headless_credential });
|
|
121
136
|
}
|
|
122
137
|
else if (held && ownAgent !== null && ownAgent.user !== exchanged.user) {
|
|
123
138
|
await forgetOwnAgent();
|
|
124
139
|
process.stdout.write("This computer's own agent was another User's; run kit login again to connect it to you.\n");
|
|
125
140
|
}
|
|
126
|
-
|
|
141
|
+
else if (held && ownAgent !== null) {
|
|
142
|
+
await writeOwnAgent({ house, ...relayRecord, user: ownAgent.user, credential: ownAgent.credential });
|
|
143
|
+
}
|
|
144
|
+
await placeAppGit(await readOwnAgent()).catch((error) => process.stderr.write(`kit: ${error.message}\n`));
|
|
127
145
|
try {
|
|
128
146
|
startService();
|
|
129
147
|
}
|
package/dist/logout.js
CHANGED
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
import { HouseRefusal, post } from './api.js';
|
|
2
|
-
import { forgetAppGit } from './app-git.js';
|
|
3
2
|
import { forgetEnrolment, forgetOwnAgent, readEnrolment } from './home.js';
|
|
4
3
|
export async function logout() {
|
|
5
4
|
const enrolled = await readEnrolment();
|
|
@@ -13,7 +12,6 @@ export async function logout() {
|
|
|
13
12
|
}
|
|
14
13
|
await forgetEnrolment(enrolled);
|
|
15
14
|
}
|
|
16
|
-
await forgetAppGit();
|
|
17
15
|
await forgetOwnAgent();
|
|
18
16
|
process.stdout.write(enrolled === null
|
|
19
17
|
? 'This computer is not connected to House.\n'
|
package/dist/mcp.js
CHANGED
|
@@ -1,8 +1,11 @@
|
|
|
1
1
|
import { randomUUID } from 'node:crypto';
|
|
2
|
-
import {
|
|
2
|
+
import { KIT_RELEASE } from './clis.js';
|
|
3
3
|
import { relayed } from './relay.js';
|
|
4
|
+
import { KIT_WIRE, KIT_WIRE_HEADER } from './wire.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:
|
|
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]: String(KIT_WIRE),
|
|
34
38
|
},
|
|
35
39
|
body: mcpBody(message, operation),
|
|
36
40
|
signal,
|
|
@@ -0,0 +1,31 @@
|
|
|
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 machine() {
|
|
18
|
+
const placed = recorded('placement');
|
|
19
|
+
if (placed === 'container' || placed === 'server' || placed === 'windows')
|
|
20
|
+
return placed;
|
|
21
|
+
return process.platform === 'darwin' ? 'macos' : 'linux';
|
|
22
|
+
}
|
|
23
|
+
export function placedPrefix() {
|
|
24
|
+
const prefix = process.env.HOUSE_KIT_PREFIX;
|
|
25
|
+
if (prefix === undefined || prefix === '')
|
|
26
|
+
throw new Error('this Kit process was not started by a launcher its installer placed');
|
|
27
|
+
return resolve(prefix);
|
|
28
|
+
}
|
|
29
|
+
export function releaseDirectory(release) {
|
|
30
|
+
return join(placedPrefix(), 'releases', release);
|
|
31
|
+
}
|
package/dist/relay.js
CHANGED
|
@@ -1,13 +1,34 @@
|
|
|
1
|
+
import { setGlobalProxyFromEnv } from 'node:http';
|
|
2
|
+
const PROXY = /^https?_proxy$/i;
|
|
3
|
+
const LOOPBACK = ['127.0.0.1', 'localhost', '::1'];
|
|
1
4
|
let selected;
|
|
5
|
+
let restoreProxy;
|
|
2
6
|
export function selectRelay(relay) {
|
|
3
7
|
selected = relay === undefined || relay === '' ? null : relay;
|
|
8
|
+
proxyUnlessRelayed();
|
|
4
9
|
}
|
|
5
|
-
function relayOrigin() {
|
|
10
|
+
export function relayOrigin() {
|
|
6
11
|
if (selected !== undefined)
|
|
7
12
|
return selected ?? undefined;
|
|
8
13
|
const ambient = process.env.HOUSE_KIT_RELAY;
|
|
9
14
|
return ambient === undefined || ambient === '' ? undefined : ambient;
|
|
10
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
|
+
}
|
|
11
32
|
export function relayed(target) {
|
|
12
33
|
const url = new URL(target);
|
|
13
34
|
const relay = relayOrigin();
|
package/dist/resident.js
CHANGED
|
@@ -1,22 +1,26 @@
|
|
|
1
1
|
import { once } from 'node:events';
|
|
2
2
|
import { watch } from 'node:fs';
|
|
3
3
|
import { mkdir, rm, writeFile } from 'node:fs/promises';
|
|
4
|
-
import { createServer } from 'node:http';
|
|
4
|
+
import { createServer, get } from 'node:http';
|
|
5
5
|
import { dirname, extname, join } from 'node:path';
|
|
6
|
+
import { DatabaseSync } from 'node:sqlite';
|
|
6
7
|
import { fileURLToPath } from 'node:url';
|
|
7
8
|
import { Agents } from './agents.js';
|
|
8
9
|
import { house } from './api.js';
|
|
9
10
|
import { received } from './bridge.js';
|
|
10
|
-
import { Conversations } from './conversations.js';
|
|
11
|
+
import { CONVERSATION_METHODS, Conversations } from './conversations.js';
|
|
11
12
|
import { LocalCopies } from './copies.js';
|
|
12
|
-
import { restart } from './end.js';
|
|
13
|
-
import { agentBase, enrolled,
|
|
13
|
+
import { restart, unknownMethod } from './end.js';
|
|
14
|
+
import { agentBase, enrolled, kitHome, ownerLock, ownerSocket, readEnrolment } from './home.js';
|
|
15
|
+
import { Calls } from './calls.js';
|
|
14
16
|
import { killDescendants } from './scope.js';
|
|
17
|
+
import { removeInputs, Scripts } from './scripts.js';
|
|
15
18
|
import { quoted } from './shell.js';
|
|
16
19
|
import { SignIns } from './sign-in.js';
|
|
17
20
|
import { placeSkillSet } from './skills.js';
|
|
18
|
-
import {
|
|
19
|
-
import {
|
|
21
|
+
import { holdConnection } from './connection.js';
|
|
22
|
+
import { KitUpdate } from './update.js';
|
|
23
|
+
import { takeUnservedRelease } from './wire.js';
|
|
20
24
|
import { codexLauncher } from './work.js';
|
|
21
25
|
function report(error) {
|
|
22
26
|
process.stderr.write(`kit: ${error instanceof Error ? error.message : String(error)}\n`);
|
|
@@ -29,13 +33,32 @@ async function installShim(path, module) {
|
|
|
29
33
|
await mkdir(dirname(path), { recursive: true });
|
|
30
34
|
await writeFile(path, `#!/bin/sh\nexec ${quoted(process.execPath)} ${quoted(main)} "$@"\n`, { mode: 0o755 });
|
|
31
35
|
}
|
|
36
|
+
function claimed(lock) {
|
|
37
|
+
try {
|
|
38
|
+
lock.exec('BEGIN EXCLUSIVE');
|
|
39
|
+
return true;
|
|
40
|
+
}
|
|
41
|
+
catch (error) {
|
|
42
|
+
if (error.errcode === 5)
|
|
43
|
+
return false;
|
|
44
|
+
throw error;
|
|
45
|
+
}
|
|
46
|
+
}
|
|
32
47
|
async function serveOwner(copies) {
|
|
33
|
-
const
|
|
34
|
-
|
|
48
|
+
const lock = new DatabaseSync(ownerLock());
|
|
49
|
+
if (!claimed(lock)) {
|
|
50
|
+
lock.close();
|
|
51
|
+
const running = await runningResident();
|
|
52
|
+
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`);
|
|
53
|
+
}
|
|
35
54
|
const server = createServer(async (request, response) => {
|
|
36
55
|
try {
|
|
37
56
|
const text = await received(request);
|
|
38
57
|
let answered;
|
|
58
|
+
if (request.url === '/resident') {
|
|
59
|
+
response.writeHead(200, { 'content-type': 'application/json' }).end(JSON.stringify({ pid: process.pid }));
|
|
60
|
+
return;
|
|
61
|
+
}
|
|
39
62
|
if (request.url === '/git/fetch') {
|
|
40
63
|
answered = await copies.fetch();
|
|
41
64
|
}
|
|
@@ -53,9 +76,23 @@ async function serveOwner(copies) {
|
|
|
53
76
|
response.writeHead(502).end(error instanceof Error ? error.message : String(error));
|
|
54
77
|
}
|
|
55
78
|
});
|
|
56
|
-
server.
|
|
79
|
+
server.on('close', () => lock.close());
|
|
80
|
+
await rm(ownerSocket(), { force: true });
|
|
81
|
+
server.listen(ownerSocket());
|
|
57
82
|
await once(server, 'listening');
|
|
58
83
|
}
|
|
84
|
+
function runningResident() {
|
|
85
|
+
return new Promise((resolve, reject) => {
|
|
86
|
+
get({ socketPath: ownerSocket(), path: '/resident' }, (answer) => {
|
|
87
|
+
received(answer).then((text) => resolve(JSON.parse(text).pid), reject);
|
|
88
|
+
}).on('error', (error) => {
|
|
89
|
+
if (error.code === 'ENOENT' || error.code === 'ECONNREFUSED')
|
|
90
|
+
resolve(null);
|
|
91
|
+
else
|
|
92
|
+
reject(error);
|
|
93
|
+
});
|
|
94
|
+
});
|
|
95
|
+
}
|
|
59
96
|
function connected() {
|
|
60
97
|
return new Promise((resolve) => {
|
|
61
98
|
const watcher = watch(kitHome(), () => {
|
|
@@ -72,77 +109,99 @@ function connected() {
|
|
|
72
109
|
resolve();
|
|
73
110
|
});
|
|
74
111
|
}
|
|
75
|
-
|
|
112
|
+
async function started() {
|
|
76
113
|
await connected();
|
|
77
|
-
await forgetRestart();
|
|
78
114
|
watch(kitHome(), () => {
|
|
79
115
|
if (enrolled())
|
|
80
116
|
return;
|
|
81
117
|
killDescendants();
|
|
82
118
|
process.exit(1);
|
|
83
119
|
});
|
|
84
|
-
await placeSkillSet();
|
|
120
|
+
await placeSkillSet((await readEnrolment()).house);
|
|
85
121
|
await mkdir(agentBase(), { recursive: true });
|
|
86
|
-
process.env.HOUSE_KIT_RESIDENT = String(process.pid);
|
|
87
|
-
const agents = new Agents(house);
|
|
88
|
-
const copies = new LocalCopies(house);
|
|
89
|
-
await copies.load();
|
|
90
122
|
await installShim(join(kitHome(), 'shim', 'git'), 'git-main');
|
|
91
123
|
await installShim(codexLauncher(), 'codex-main');
|
|
124
|
+
}
|
|
125
|
+
export async function resident() {
|
|
126
|
+
await mkdir(kitHome(), { recursive: true, mode: 0o700 });
|
|
127
|
+
const copies = new LocalCopies(house);
|
|
128
|
+
await copies.load();
|
|
92
129
|
await serveOwner(copies);
|
|
93
|
-
|
|
130
|
+
await started().catch((error) => {
|
|
131
|
+
report(error);
|
|
132
|
+
process.exit(1);
|
|
133
|
+
});
|
|
134
|
+
process.env.HOUSE_KIT_RESIDENT = String(process.pid);
|
|
135
|
+
const agents = new Agents(house, () => changed());
|
|
136
|
+
let connection = null;
|
|
94
137
|
let reported = false;
|
|
95
|
-
const idle = () => conversations.idle() &&
|
|
138
|
+
const idle = () => calls.idle() && conversations.idle() && agents.idle();
|
|
96
139
|
const changed = () => {
|
|
97
140
|
if (!idle()) {
|
|
98
141
|
reported = false;
|
|
99
142
|
}
|
|
100
|
-
else if (
|
|
101
|
-
restart(
|
|
143
|
+
else if (update.placedRelease() !== null && conversations.quiet()) {
|
|
144
|
+
restart(`Kit ${update.placedRelease()} is placed; its supervisor starts it`);
|
|
102
145
|
}
|
|
103
146
|
else if (!reported) {
|
|
104
147
|
reported = true;
|
|
105
148
|
logged(house.deliver('/kit/idle', {}, idle));
|
|
106
149
|
}
|
|
107
150
|
};
|
|
151
|
+
const calls = new Calls(house, changed);
|
|
108
152
|
const conversations = new Conversations({
|
|
109
153
|
house,
|
|
110
154
|
agents,
|
|
111
155
|
copies,
|
|
112
|
-
|
|
156
|
+
calls,
|
|
157
|
+
send: (notification) => connection?.send(notification) ?? false,
|
|
113
158
|
changed,
|
|
114
159
|
});
|
|
115
|
-
const signIns = new SignIns(house, agents,
|
|
116
|
-
const
|
|
160
|
+
const signIns = new SignIns(house, agents, calls);
|
|
161
|
+
const update = new KitUpdate(calls);
|
|
162
|
+
if (process.env.HOUSE_KIT_SANDBOX !== '1')
|
|
163
|
+
takeUnservedRelease((release) => logged(update.takeRefused(release)));
|
|
164
|
+
removeInputs();
|
|
165
|
+
const scripts = new Scripts(calls, (notification) => connection?.send(notification) ?? false);
|
|
117
166
|
for (const signal of ['SIGTERM', 'SIGINT']) {
|
|
118
167
|
process.once(signal, () => {
|
|
119
168
|
killDescendants();
|
|
169
|
+
removeInputs();
|
|
120
170
|
process.kill(process.pid, signal);
|
|
121
171
|
});
|
|
122
172
|
}
|
|
123
173
|
await house.deliver('/kit/restarted', {}).catch(report);
|
|
124
|
-
await updates.resumed().catch(report);
|
|
125
174
|
logged(agents.refresh());
|
|
126
|
-
|
|
175
|
+
agents.keepCurrent();
|
|
176
|
+
connection = holdConnection({
|
|
127
177
|
opened: () => {
|
|
128
178
|
conversations.opened();
|
|
129
179
|
changed();
|
|
130
180
|
logged(copies.connected());
|
|
131
181
|
},
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
182
|
+
closed: () => scripts.disconnected(),
|
|
183
|
+
call: (call) => {
|
|
184
|
+
if (call.kind === 'sign_in')
|
|
185
|
+
signIns.start(call);
|
|
186
|
+
else if (call.kind === 'update')
|
|
187
|
+
update.take(call);
|
|
188
|
+
else if (call.kind === 'run_wizard' || call.kind === 'run_function')
|
|
189
|
+
scripts.start(call);
|
|
190
|
+
else if (CONVERSATION_METHODS.has(call.kind))
|
|
191
|
+
conversations.call(call);
|
|
192
|
+
else {
|
|
193
|
+
const refused = { refused: unknownMethod(call.kind) };
|
|
194
|
+
void calls.carry(call.input_id, async () => ({ result: refused }));
|
|
145
195
|
}
|
|
146
196
|
},
|
|
197
|
+
notification: (notification) => {
|
|
198
|
+
if (notification.type === 'watching')
|
|
199
|
+
conversations.watching(notification.watching === true);
|
|
200
|
+
if (notification.type === 'authority_changed')
|
|
201
|
+
logged(copies.changed(notification.rooms));
|
|
202
|
+
if (notification.type === 'work_available' && notification.subject === 'agents')
|
|
203
|
+
logged(agents.refresh());
|
|
204
|
+
scripts.notified(notification);
|
|
205
|
+
},
|
|
147
206
|
});
|
|
148
207
|
}
|