@agentshouse/kit 0.2.1-alpha.9 → 0.2.1-c02dacffca87c
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 +48 -29
- package/dist/abort.js +9 -0
- package/dist/acp.js +102 -88
- package/dist/agents.js +356 -52
- package/dist/api.js +40 -4
- package/dist/app-git.js +48 -0
- package/dist/authority-main.js +2 -2
- package/dist/bridge.js +93 -78
- package/dist/building.js +50 -0
- package/dist/calls.js +71 -0
- package/dist/chatgpt.js +32 -0
- package/dist/chunks.js +49 -0
- package/dist/clis.js +224 -88
- package/dist/codex-main.js +58 -0
- package/dist/connection.js +105 -0
- package/dist/conversations.js +749 -270
- package/dist/copies.js +475 -260
- package/dist/end.js +33 -0
- package/dist/enrol-main.js +7 -1
- package/dist/events.js +546 -0
- package/dist/files.js +140 -17
- package/dist/git-main.js +2 -2
- package/dist/git.js +62 -22
- package/dist/home.js +120 -9
- package/dist/house-cli.js +299 -0
- package/dist/house-main.js +5 -102
- package/dist/instructions.js +17 -18
- package/dist/kit-cli.js +68 -0
- package/dist/kit-main.js +8 -16
- package/dist/login.js +130 -95
- package/dist/logout.js +19 -0
- package/dist/mcp.js +43 -0
- package/dist/operation.js +7 -4
- package/dist/parts.js +82 -0
- package/dist/placement.js +31 -0
- package/dist/refusals.js +53 -0
- package/dist/relay.js +41 -0
- package/dist/resident.js +144 -52
- package/dist/scope.js +214 -0
- package/dist/scripts.js +255 -0
- package/dist/secret-input.js +7 -2
- package/dist/service-main.js +9 -0
- package/dist/service.js +55 -0
- package/dist/shell.js +3 -0
- package/dist/sign-in.js +52 -32
- package/dist/silence.js +28 -0
- package/dist/skills.js +48 -39
- package/dist/transcription.js +210 -0
- package/dist/translate.js +2 -8
- package/dist/update.js +127 -0
- package/dist/wire.js +40 -0
- package/dist/work.js +346 -0
- package/package.json +21 -24
- package/dist/blocks.js +0 -51
- package/dist/bootstrap.json +0 -28
- package/dist/stream.js +0 -47
- package/how-we-work.md +0 -25
- 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
|
@@ -0,0 +1,299 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto';
|
|
2
|
+
import { createReadStream } from 'node:fs';
|
|
3
|
+
import { request } from 'node:http';
|
|
4
|
+
import { request as httpsRequest } from 'node:https';
|
|
5
|
+
import { extname, join, resolve } from 'node:path';
|
|
6
|
+
import { Readable } from 'node:stream';
|
|
7
|
+
import { pipeline } from 'node:stream/promises';
|
|
8
|
+
import { downloaded, inspectedFile, storeRefusal, uploaded } from './files.js';
|
|
9
|
+
import { HOUSE_REF } from './git.js';
|
|
10
|
+
import { ownerSocket, readOwnAgent } from './home.js';
|
|
11
|
+
import { callHouse, rpc, UNREACHABLE, Unsettled } from './mcp.js';
|
|
12
|
+
import { refusalOf, retryable } from './refusals.js';
|
|
13
|
+
import { proxyUnlessRelayed, relayed, selectRelay } from './relay.js';
|
|
14
|
+
import { parse } from 'yaml';
|
|
15
|
+
const USAGE = "usage: house <tool> ['<arguments as JSON>']";
|
|
16
|
+
const PUSH_USAGE = 'usage: house push [commit] [--owner]';
|
|
17
|
+
const PUSH = "push [commit]: sends the Local copy's committed changes to House";
|
|
18
|
+
const FETCH_USAGE = 'usage: house fetch';
|
|
19
|
+
const FETCH = `fetch: records House's changes on each Local copy's ${HOUSE_REF}`;
|
|
20
|
+
const DOWNLOAD_USAGE = `usage: house download '{"path":"/rooms/<handle>/<path>","file":"<local file>"}', adding "ref" for a revision`;
|
|
21
|
+
const DOWNLOAD = 'download: writes a binary file of a Room to the local file named by file';
|
|
22
|
+
const ARGUMENTS = `the arguments are one JSON object in single quotes, like house search '{"query":"invoice"}'`;
|
|
23
|
+
const CLOSED = "this conversation's House connection is closed; nothing to do from here";
|
|
24
|
+
const SANDBOXED = "your CLI's sandbox kept house from House; run house directly, not through another program";
|
|
25
|
+
const REVOKED = 'this conversation no longer has House access; nothing to do from here';
|
|
26
|
+
const UNCONNECTED = "this computer's own agent has no House connection; run kit login, or kit chatgpt --key <key> with a script key";
|
|
27
|
+
const DISCONNECTED = "House no longer accepts this computer's own agent; run kit login, or kit chatgpt --key <key> with a script key";
|
|
28
|
+
const UNCONFIRMED = 'with no result; a write may or may not have taken effect, so read before you repeat it';
|
|
29
|
+
const socketPath = process.env.HOUSE_BRIDGE;
|
|
30
|
+
const MEDIA_TYPES = new Map([
|
|
31
|
+
['avif', 'image/avif'],
|
|
32
|
+
['csv', 'text/csv'],
|
|
33
|
+
['docx', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'],
|
|
34
|
+
['gif', 'image/gif'],
|
|
35
|
+
['heic', 'image/heic'],
|
|
36
|
+
['html', 'text/html'],
|
|
37
|
+
['jpeg', 'image/jpeg'],
|
|
38
|
+
['jpg', 'image/jpeg'],
|
|
39
|
+
['json', 'application/json'],
|
|
40
|
+
['m4a', 'audio/mp4'],
|
|
41
|
+
['md', 'text/markdown'],
|
|
42
|
+
['mov', 'video/quicktime'],
|
|
43
|
+
['mp3', 'audio/mpeg'],
|
|
44
|
+
['mp4', 'video/mp4'],
|
|
45
|
+
['ogg', 'audio/ogg'],
|
|
46
|
+
['pdf', 'application/pdf'],
|
|
47
|
+
['png', 'image/png'],
|
|
48
|
+
['pptx', 'application/vnd.openxmlformats-officedocument.presentationml.presentation'],
|
|
49
|
+
['svg', 'image/svg+xml'],
|
|
50
|
+
['txt', 'text/plain'],
|
|
51
|
+
['wav', 'audio/wav'],
|
|
52
|
+
['webm', 'video/webm'],
|
|
53
|
+
['webp', 'image/webp'],
|
|
54
|
+
['xlsx', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'],
|
|
55
|
+
['zip', 'application/zip'],
|
|
56
|
+
]);
|
|
57
|
+
function refused(path, status, text, local) {
|
|
58
|
+
const refusal = refusalOf(text);
|
|
59
|
+
if (refusal !== null)
|
|
60
|
+
return refusal.text;
|
|
61
|
+
if (status === 401)
|
|
62
|
+
return REVOKED;
|
|
63
|
+
if (status === 502 && local)
|
|
64
|
+
return text;
|
|
65
|
+
return path === '/' ? unconfirmed(status) : `${path} answered ${status}`;
|
|
66
|
+
}
|
|
67
|
+
function unconfirmed(status) {
|
|
68
|
+
return `House answered ${status} ${UNCONFIRMED}`;
|
|
69
|
+
}
|
|
70
|
+
function bridged(path, body, to = socketPath) {
|
|
71
|
+
return new Promise((resolve, reject) => {
|
|
72
|
+
const sent = request({ socketPath: to, path, method: 'POST', headers: { 'content-type': 'application/json' } }, (answer) => {
|
|
73
|
+
const chunks = [];
|
|
74
|
+
answer.on('data', (chunk) => chunks.push(chunk));
|
|
75
|
+
answer.on('end', () => {
|
|
76
|
+
const text = Buffer.concat(chunks).toString('utf8');
|
|
77
|
+
if (answer.statusCode === 200)
|
|
78
|
+
resolve(text);
|
|
79
|
+
else
|
|
80
|
+
reject(new Error(refused(path, answer.statusCode, text, answer.headers['content-type'] === undefined)));
|
|
81
|
+
});
|
|
82
|
+
});
|
|
83
|
+
sent.on('error', (error) => reject(new Error(error.code === 'EPERM' || error.code === 'EACCES' ? SANDBOXED : CLOSED)));
|
|
84
|
+
sent.end(JSON.stringify(body));
|
|
85
|
+
});
|
|
86
|
+
}
|
|
87
|
+
async function direct(message) {
|
|
88
|
+
const ownAgent = await readOwnAgent();
|
|
89
|
+
if (ownAgent === null)
|
|
90
|
+
throw new Error(UNCONNECTED);
|
|
91
|
+
selectRelay(process.env.HOUSE_KIT_RELAY || ownAgent.relay);
|
|
92
|
+
const answer = await callHouse(ownAgent.house, ownAgent.credential, message).catch(() => {
|
|
93
|
+
throw new Unsettled(UNREACHABLE);
|
|
94
|
+
});
|
|
95
|
+
if (answer.status === 200)
|
|
96
|
+
return answer.text;
|
|
97
|
+
if (answer.status === 401)
|
|
98
|
+
throw new Error(DISCONNECTED);
|
|
99
|
+
const refusal = refusalOf(answer.text)?.text ?? unconfirmed(answer.status);
|
|
100
|
+
throw retryable(answer.text) === false ? new Error(refusal) : new Unsettled(refusal);
|
|
101
|
+
}
|
|
102
|
+
async function mcp(method, params) {
|
|
103
|
+
const message = rpc(method, params);
|
|
104
|
+
const answer = JSON.parse(socketPath === undefined ? await direct(message) : await bridged('/', message));
|
|
105
|
+
if (answer.error !== undefined)
|
|
106
|
+
throw new Error(answer.error.message);
|
|
107
|
+
return answer.result;
|
|
108
|
+
}
|
|
109
|
+
async function tools() {
|
|
110
|
+
return (await mcp('tools/list', {})).tools;
|
|
111
|
+
}
|
|
112
|
+
function unreadable(path, error) {
|
|
113
|
+
return new Error(error.code === 'EISDIR'
|
|
114
|
+
? `${path} is a folder; upload one file at a time`
|
|
115
|
+
: `${path} is not a readable file`);
|
|
116
|
+
}
|
|
117
|
+
function opened(url, method, headers, body) {
|
|
118
|
+
return new Promise((answered, failed) => {
|
|
119
|
+
const local = socketPath !== undefined;
|
|
120
|
+
const target = local ? null : relayed(url);
|
|
121
|
+
if (!local)
|
|
122
|
+
proxyUnlessRelayed();
|
|
123
|
+
const sent = target === null
|
|
124
|
+
? request({ socketPath, path: url, method, headers }, answered)
|
|
125
|
+
: (target.protocol === 'https:' ? httpsRequest : request)(target, { method, headers }, answered);
|
|
126
|
+
sent.on('error', (error) => failed(new Error(!local ? UNREACHABLE : error.code === 'EPERM' || error.code === 'EACCES' ? SANDBOXED : CLOSED)));
|
|
127
|
+
if (body === undefined)
|
|
128
|
+
sent.end();
|
|
129
|
+
else
|
|
130
|
+
pipeline(body, sent).catch(() => undefined);
|
|
131
|
+
});
|
|
132
|
+
}
|
|
133
|
+
function ranged(file, start, end) {
|
|
134
|
+
return end === start ? undefined : createReadStream(file, { start, end: end - 1 });
|
|
135
|
+
}
|
|
136
|
+
async function* read(file, start, end) {
|
|
137
|
+
try {
|
|
138
|
+
yield* ranged(file, start, end) ?? [];
|
|
139
|
+
}
|
|
140
|
+
catch (error) {
|
|
141
|
+
throw unreadable(file, error);
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
async function sentPart(url, file, start, end, headers) {
|
|
145
|
+
const answer = await opened(url, 'PUT', { ...headers, 'content-length': String(end - start) }, ranged(file, start, end));
|
|
146
|
+
await answer.toArray();
|
|
147
|
+
if (answer.statusCode !== 200)
|
|
148
|
+
throw storeRefusal('upload', answer.statusCode);
|
|
149
|
+
}
|
|
150
|
+
async function download(args) {
|
|
151
|
+
const { flags, positionals: [argument] } = accepted(args, ['--help'], 1, DOWNLOAD_USAGE);
|
|
152
|
+
if (flags.has('--help'))
|
|
153
|
+
return DOWNLOAD_USAGE;
|
|
154
|
+
const { file, ...selected } = argumentsOf(argument);
|
|
155
|
+
if (typeof file !== 'string' || file === '')
|
|
156
|
+
throw new Error('download needs "file", the local file to write');
|
|
157
|
+
const written = resolve(file);
|
|
158
|
+
await downloaded(async () => {
|
|
159
|
+
const file = inspectedFile(await called('inspect', selected));
|
|
160
|
+
if (file === null)
|
|
161
|
+
throw new Error(`${String(selected.path)} holds no binary file; shell reads its text`);
|
|
162
|
+
return file;
|
|
163
|
+
}, async (url) => {
|
|
164
|
+
const answer = await opened(url, 'GET', {});
|
|
165
|
+
return { status: answer.statusCode, body: answer };
|
|
166
|
+
}, written, String(selected.path));
|
|
167
|
+
return written;
|
|
168
|
+
}
|
|
169
|
+
async function described(file) {
|
|
170
|
+
const digest = createHash('sha256');
|
|
171
|
+
let bytes = 0;
|
|
172
|
+
try {
|
|
173
|
+
for await (const chunk of createReadStream(file)) {
|
|
174
|
+
digest.update(chunk);
|
|
175
|
+
bytes += chunk.length;
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
catch (error) {
|
|
179
|
+
throw unreadable(file, error);
|
|
180
|
+
}
|
|
181
|
+
const mediaType = MEDIA_TYPES.get(extname(file).slice(1).toLowerCase());
|
|
182
|
+
return { bytes, sha256: digest.digest('hex'), ...(mediaType === undefined ? {} : { media_type: mediaType }) };
|
|
183
|
+
}
|
|
184
|
+
async function finished(upload, room, partSha256) {
|
|
185
|
+
const text = await called('upload', { upload, room_ref: room, part_sha256: partSha256 });
|
|
186
|
+
const answer = parse(text);
|
|
187
|
+
return answer !== null && 'upload' in answer ? answer : { text };
|
|
188
|
+
}
|
|
189
|
+
async function upload({ file, ...destination }) {
|
|
190
|
+
if (typeof file !== 'string' || file === '')
|
|
191
|
+
throw new Error('upload needs "file", a local file');
|
|
192
|
+
const description = await described(file);
|
|
193
|
+
const answer = await called('upload', { ...destination, ...description });
|
|
194
|
+
const declared = parse(answer);
|
|
195
|
+
if (declared?.upload === undefined)
|
|
196
|
+
return answer;
|
|
197
|
+
const accepted = await uploaded(declared.upload, {
|
|
198
|
+
name: file,
|
|
199
|
+
bytes: description.bytes,
|
|
200
|
+
sha256: description.sha256,
|
|
201
|
+
read: (start, end) => read(file, start, end),
|
|
202
|
+
send: (url, start, end, headers) => sentPart(url, file, start, end, headers),
|
|
203
|
+
finish: (id, partSha256) => finished(id, destination.room_ref, partSha256),
|
|
204
|
+
});
|
|
205
|
+
return accepted.text;
|
|
206
|
+
}
|
|
207
|
+
function unexpected(argument, usage) {
|
|
208
|
+
return new Error(`unexpected argument ${argument}; ${usage}`);
|
|
209
|
+
}
|
|
210
|
+
function accepted(args, flags, positionals, usage) {
|
|
211
|
+
const given = { flags: new Set(), positionals: [] };
|
|
212
|
+
for (const arg of args) {
|
|
213
|
+
if (flags.includes(arg))
|
|
214
|
+
given.flags.add(arg);
|
|
215
|
+
else if (!arg.startsWith('-') && given.positionals.length < positionals)
|
|
216
|
+
given.positionals.push(arg);
|
|
217
|
+
else
|
|
218
|
+
throw unexpected(arg, usage);
|
|
219
|
+
}
|
|
220
|
+
return given;
|
|
221
|
+
}
|
|
222
|
+
async function push(args) {
|
|
223
|
+
const { flags, positionals: [commit = 'HEAD'] } = accepted(args, ['--help', '--owner'], 1, PUSH_USAGE);
|
|
224
|
+
if (flags.has('--help'))
|
|
225
|
+
return PUSH_USAGE;
|
|
226
|
+
const owner = flags.has('--owner');
|
|
227
|
+
if (owner && socketPath !== undefined)
|
|
228
|
+
throw new Error('--owner is not for Agent conversations; run house push without it');
|
|
229
|
+
if (!owner && socketPath === undefined)
|
|
230
|
+
throw new Error('outside an Agent conversation, house push needs --owner');
|
|
231
|
+
const pushed = JSON.parse(await bridged('/git/push', { cwd: process.cwd(), commit }, owner ? ownerSocket() : socketPath));
|
|
232
|
+
if (pushed.refused)
|
|
233
|
+
throw new Error(pushed.text);
|
|
234
|
+
return pushed.text;
|
|
235
|
+
}
|
|
236
|
+
async function fetched(args) {
|
|
237
|
+
if (accepted(args, ['--help'], 0, FETCH_USAGE).flags.has('--help'))
|
|
238
|
+
return FETCH_USAGE;
|
|
239
|
+
const answer = JSON.parse(await bridged('/git/fetch', {}, socketPath ?? ownerSocket()));
|
|
240
|
+
if (answer.refused)
|
|
241
|
+
throw new Error(answer.text);
|
|
242
|
+
return answer.text;
|
|
243
|
+
}
|
|
244
|
+
function argumentsOf(argument) {
|
|
245
|
+
if (argument === undefined)
|
|
246
|
+
return {};
|
|
247
|
+
let parsed;
|
|
248
|
+
try {
|
|
249
|
+
parsed = JSON.parse(argument);
|
|
250
|
+
}
|
|
251
|
+
catch {
|
|
252
|
+
throw new Error(ARGUMENTS);
|
|
253
|
+
}
|
|
254
|
+
if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed))
|
|
255
|
+
throw new Error(ARGUMENTS);
|
|
256
|
+
return parsed;
|
|
257
|
+
}
|
|
258
|
+
async function house(args) {
|
|
259
|
+
const { flags, positionals: [verb, argument] } = accepted(args, ['--help'], 2, USAGE);
|
|
260
|
+
if (verb === 'help' && argument !== undefined)
|
|
261
|
+
throw unexpected(argument, USAGE);
|
|
262
|
+
if (flags.has('--help') && argument !== undefined)
|
|
263
|
+
throw unexpected('--help', USAGE);
|
|
264
|
+
if (verb === undefined || verb === 'help') {
|
|
265
|
+
return [USAGE, 'help', PUSH, FETCH, DOWNLOAD, ...(await tools()).map((tool) => (tool.description === undefined ? tool.name : `${tool.name}: ${tool.description}`))].join('\n');
|
|
266
|
+
}
|
|
267
|
+
if (flags.has('--help')) {
|
|
268
|
+
const tool = (await tools()).find((listed) => listed.name === verb);
|
|
269
|
+
if (tool === undefined)
|
|
270
|
+
throw new Error(`${verb} is no Tool; house find_command '{"query":"${verb}"}' finds Commands`);
|
|
271
|
+
return [...(tool.description === undefined ? [] : [tool.description]), JSON.stringify(tool.inputSchema)].join('\n');
|
|
272
|
+
}
|
|
273
|
+
const parsed = argumentsOf(argument);
|
|
274
|
+
return verb === 'upload' ? upload(parsed) : called(verb, parsed);
|
|
275
|
+
}
|
|
276
|
+
async function called(name, args) {
|
|
277
|
+
const result = await mcp('tools/call', { name, arguments: args });
|
|
278
|
+
const text = result.content.map((content) => content.text).join('\n');
|
|
279
|
+
if (result.isError === true)
|
|
280
|
+
throw new Error(text.replace(/\n+$/, ''));
|
|
281
|
+
return text;
|
|
282
|
+
}
|
|
283
|
+
const argv = process.argv.slice(2);
|
|
284
|
+
const named = argv.findIndex((arg) => !arg.startsWith('-'));
|
|
285
|
+
const rest = argv.filter((_arg, index) => index !== named);
|
|
286
|
+
(argv[named] === 'push'
|
|
287
|
+
? push(rest)
|
|
288
|
+
: argv[named] === 'fetch'
|
|
289
|
+
? fetched(rest)
|
|
290
|
+
: argv[named] === 'download'
|
|
291
|
+
? download(rest)
|
|
292
|
+
: house(argv)).then((text) => {
|
|
293
|
+
process.stdout.write(`${text}\n`);
|
|
294
|
+
if (argv[0] === 'shell')
|
|
295
|
+
process.exitCode = Number(/^exit: (\d+)(?:\n|$)/.exec(text)?.[1] ?? 0);
|
|
296
|
+
}, (error) => {
|
|
297
|
+
process.stderr.write(`house: ${error instanceof Error ? error.message : String(error)}\n`);
|
|
298
|
+
process.exitCode = 1;
|
|
299
|
+
});
|
package/dist/house-main.js
CHANGED
|
@@ -1,107 +1,10 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
import { basename, join } from 'node:path';
|
|
6
|
-
import { kitHome } from './home.js';
|
|
7
|
-
const USAGE = "usage: house <tool> ['<arguments as JSON>']";
|
|
8
|
-
const GIT_HELP = 'Submit a Room commit to House; default HEAD. Use --owner only outside an Agent conversation. Native git push is not a House remote.';
|
|
9
|
-
const GIT_USAGE = `usage: house git push [commit] [--owner]\n${GIT_HELP}`;
|
|
10
|
-
const socketPath = process.env.HOUSE_BRIDGE;
|
|
11
|
-
function bridged(path, body, headers = { 'content-type': 'application/json' }, to = socketPath) {
|
|
12
|
-
return new Promise((resolve, reject) => {
|
|
13
|
-
const sent = request({ socketPath: to, path, method: 'POST', headers }, (answer) => {
|
|
14
|
-
let text = '';
|
|
15
|
-
answer.setEncoding('utf8');
|
|
16
|
-
answer.on('data', (chunk) => {
|
|
17
|
-
text += chunk;
|
|
18
|
-
});
|
|
19
|
-
answer.on('end', () => {
|
|
20
|
-
if (answer.statusCode === 200)
|
|
21
|
-
resolve(text);
|
|
22
|
-
else
|
|
23
|
-
reject(new Error(`${path} answered ${answer.statusCode}: ${text}`));
|
|
24
|
-
});
|
|
25
|
-
});
|
|
26
|
-
sent.on('error', reject);
|
|
27
|
-
sent.end(body instanceof Buffer ? body : JSON.stringify(body));
|
|
28
|
-
});
|
|
29
|
-
}
|
|
30
|
-
async function mcp(method, params) {
|
|
31
|
-
const answer = JSON.parse(await bridged('/', { jsonrpc: '2.0', id: 1, method, params }));
|
|
32
|
-
if (answer.error !== undefined)
|
|
33
|
-
throw new Error(answer.error.message);
|
|
34
|
-
return answer.result;
|
|
35
|
-
}
|
|
36
|
-
async function tools() {
|
|
37
|
-
return (await mcp('tools/list', {})).tools;
|
|
38
|
-
}
|
|
39
|
-
async function upload(path, roomRef) {
|
|
40
|
-
const bytes = await readFile(path);
|
|
41
|
-
const declared = JSON.parse(await bridged('/kit/attachments/upload', {
|
|
42
|
-
...(roomRef === undefined ? {} : { room_ref: roomRef }),
|
|
43
|
-
version: randomUUID(),
|
|
44
|
-
name: basename(path),
|
|
45
|
-
bytes: bytes.length,
|
|
46
|
-
sha256: createHash('sha256').update(bytes).digest('hex'),
|
|
47
|
-
}));
|
|
48
|
-
return bridged(declared.upload.url, bytes, {
|
|
49
|
-
'content-type': 'application/octet-stream',
|
|
50
|
-
'x-house-byte-operation': declared.upload.operation,
|
|
51
|
-
});
|
|
52
|
-
}
|
|
53
|
-
async function gitPush(args) {
|
|
54
|
-
if (args.includes('--help'))
|
|
55
|
-
return GIT_USAGE;
|
|
56
|
-
if (args[0] !== 'push')
|
|
57
|
-
throw new Error(GIT_USAGE);
|
|
58
|
-
const owner = args.includes('--owner');
|
|
59
|
-
const commit = args.slice(1).find((arg) => arg !== '--owner') ?? 'HEAD';
|
|
60
|
-
if (owner && socketPath !== undefined)
|
|
61
|
-
throw new Error('house git push --owner runs outside an Agent conversation');
|
|
62
|
-
if (!owner && socketPath === undefined)
|
|
63
|
-
throw new Error('outside an Agent conversation, house git push needs --owner');
|
|
64
|
-
const pushed = JSON.parse(await bridged('/git/push', { cwd: process.cwd(), commit }, undefined, owner ? join(kitHome(), 'owner.sock') : socketPath));
|
|
65
|
-
if (pushed.refused)
|
|
66
|
-
throw new Error(pushed.text);
|
|
67
|
-
return pushed.text;
|
|
68
|
-
}
|
|
69
|
-
async function house([verb, argument]) {
|
|
70
|
-
if (verb === undefined || verb === '--help') {
|
|
71
|
-
return [USAGE, `git push [commit]: ${GIT_HELP}`, ...(await tools()).map((tool) => `${tool.name}: ${tool.description}`)].join('\n');
|
|
72
|
-
}
|
|
73
|
-
if (argument === '--help') {
|
|
74
|
-
const tool = (await tools()).find((listed) => listed.name === verb);
|
|
75
|
-
if (tool === undefined)
|
|
76
|
-
throw new Error(`House has no tool ${verb}`);
|
|
77
|
-
return `${tool.description}\n${JSON.stringify(tool.inputSchema, null, 2)}`;
|
|
78
|
-
}
|
|
79
|
-
const args = (argument === undefined ? {} : JSON.parse(argument));
|
|
80
|
-
if (verb === 'upload_attachment')
|
|
81
|
-
return upload(String(args.path), args.room_ref);
|
|
82
|
-
if (verb === 'append_record' && Array.isArray(args.attachments)) {
|
|
83
|
-
const attachments = [];
|
|
84
|
-
for (const path of args.attachments) {
|
|
85
|
-
attachments.push(JSON.parse(await upload(String(path), args.room_ref)).attachment);
|
|
86
|
-
}
|
|
87
|
-
args.attachments = attachments;
|
|
88
|
-
}
|
|
89
|
-
const result = await mcp('tools/call', { name: verb, arguments: args });
|
|
90
|
-
const text = result.content.map((content) => content.text).join('\n');
|
|
91
|
-
if (result.isError === true)
|
|
92
|
-
throw new Error(text);
|
|
93
|
-
return text;
|
|
94
|
-
}
|
|
95
|
-
const argv = process.argv.slice(2);
|
|
96
|
-
if (argv[0] !== 'git' && socketPath === undefined) {
|
|
97
|
-
process.stderr.write('house: house runs inside an Agent conversation\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(`house: the Kit needs Node 24.22.1 or newer; this is ${process.versions.node}\n`);
|
|
98
5
|
process.exitCode = 1;
|
|
99
6
|
}
|
|
100
7
|
else {
|
|
101
|
-
(
|
|
102
|
-
process.stdout.write(`${text}\n`);
|
|
103
|
-
}, (error) => {
|
|
104
|
-
process.stderr.write(`house: ${error instanceof Error ? error.message : String(error)}\n`);
|
|
105
|
-
process.exitCode = 1;
|
|
106
|
-
});
|
|
8
|
+
await import('./house-cli.js');
|
|
107
9
|
}
|
|
10
|
+
export {};
|
package/dist/instructions.js
CHANGED
|
@@ -1,33 +1,32 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
const
|
|
4
|
-
const FILE_LINE = 'To give the User a file, upload it with `house upload_attachment` and link it in your answer.';
|
|
5
|
-
const COPIES_LINE = 'These House paths are Git working copies here; commit in one and run `house git push` to send the commit to House:';
|
|
1
|
+
import { agentInstructions } from '@agentshouse/skills';
|
|
2
|
+
import { HOUSE_REF } from './git.js';
|
|
3
|
+
const OWNER_RULES = '/rooms/private/owner-rules.md';
|
|
6
4
|
const UNREADABLE = /^(?:\S+: )?(?:path_not_found|room_not_found|operation_denied)\b/;
|
|
5
|
+
const FAILED = /^exit: [1-9]\d*$/;
|
|
7
6
|
const CUT = /^stderr: shell: output_cut (\d+) of \d+ bytes; continue with: (.+)$/;
|
|
8
|
-
|
|
7
|
+
function cutOf(lines) {
|
|
8
|
+
const cut = CUT.exec(lines[0] ?? '');
|
|
9
|
+
return cut !== null && Buffer.byteLength(lines.slice(1).join('\n')) === Number(cut[1]) ? cut : null;
|
|
10
|
+
}
|
|
11
|
+
async function readOwnerRules(bridge) {
|
|
9
12
|
let document = '';
|
|
10
|
-
for (let command = `cat ${
|
|
13
|
+
for (let command = `cat ${OWNER_RULES}`; command !== undefined;) {
|
|
11
14
|
const read = await bridge.tool('shell', { command });
|
|
12
15
|
const text = read.content.map((content) => content.text).join('\n');
|
|
13
16
|
const lines = text.split('\n');
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
const refusal = read.isError === true ? text : lines.slice(at).join('\n').replace(/^stderr: /gm, '');
|
|
17
|
+
if (read.isError === true || (FAILED.test(lines[0] ?? '') && lines[1]?.startsWith('stderr: '))) {
|
|
18
|
+
const refusal = read.isError === true ? text : lines.slice(1).join('\n').replace(/^stderr: /gm, '');
|
|
17
19
|
if (UNREADABLE.test(refusal))
|
|
18
20
|
return '';
|
|
19
21
|
throw new Error(refusal);
|
|
20
22
|
}
|
|
21
|
-
const cut =
|
|
22
|
-
|
|
23
|
-
document += (cut === null ? shown : shown.subarray(0, Number(cut[1]))).toString();
|
|
23
|
+
const cut = cutOf(lines);
|
|
24
|
+
document += lines.slice(cut === null ? 0 : 1).join('\n');
|
|
24
25
|
command = cut?.[2];
|
|
25
26
|
}
|
|
26
|
-
return document
|
|
27
|
+
return document;
|
|
27
28
|
}
|
|
28
29
|
export async function instructions(bridge, base, copies) {
|
|
29
|
-
const
|
|
30
|
-
|
|
31
|
-
const lines = [HOUSE_LINE, FILE_LINE, appLine, ...(copies.length === 0 ? [] : [COPIES_LINE, ...copies])];
|
|
32
|
-
return [lines.join('\n'), base, await howWeWork(bridge)].filter((part) => part !== '').join('\n\n');
|
|
30
|
+
const lines = agentInstructions(HOUSE_REF, copies);
|
|
31
|
+
return [lines.join('\n'), base, (await readOwnerRules(bridge)).replace(/\n$/, '')].filter((part) => part !== '').join('\n\n');
|
|
33
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,18 +1,10 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
const [command, ...argv] = process.argv.slice(2);
|
|
6
|
-
setGlobalProxyFromEnv();
|
|
7
|
-
async function run() {
|
|
8
|
-
if (command === 'login')
|
|
9
|
-
return login(argv);
|
|
10
|
-
if (command === 'resident')
|
|
11
|
-
return resident();
|
|
12
|
-
process.stderr.write('usage: kit <login|resident>\n');
|
|
13
|
-
process.exitCode = 2;
|
|
14
|
-
}
|
|
15
|
-
run().catch((error) => {
|
|
16
|
-
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`);
|
|
17
5
|
process.exitCode = 1;
|
|
18
|
-
}
|
|
6
|
+
}
|
|
7
|
+
else {
|
|
8
|
+
await import('./kit-cli.js');
|
|
9
|
+
}
|
|
10
|
+
export {};
|