@agentshouse/kit 0.2.1-c7a397cb0cce7 → 0.2.1-c7e034a9950ad
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 +22 -22
- package/dist/acp.js +2 -2
- package/dist/agents.js +2 -2
- package/dist/api.js +5 -5
- package/dist/bootstrap.json +4 -4
- package/dist/bridge.js +1 -1
- package/dist/{inputs.js → calls.js} +20 -20
- package/dist/clis.js +6 -3
- package/dist/{stream.js → connection.js} +30 -27
- package/dist/conversations.js +144 -84
- package/dist/copies.js +15 -29
- package/dist/end.js +6 -2
- package/dist/events.js +2 -2
- package/dist/files.js +123 -37
- package/dist/git.js +1 -1
- package/dist/house-cli.js +81 -86
- package/dist/instructions.js +28 -8
- package/dist/kit-cli.js +2 -2
- package/dist/login.js +1 -3
- package/dist/mcp.js +4 -2
- package/dist/placement.js +11 -2
- package/dist/resident.js +38 -32
- package/dist/service.js +1 -1
- package/dist/sign-in.js +19 -19
- package/dist/skills.js +12 -93
- package/dist/transcription.js +51 -20
- package/dist/update.js +32 -32
- package/dist/web-wizard.js +100 -0
- package/dist/wire.js +19 -3
- package/package.json +6 -6
- package/how-we-work.md +0 -33
- package/skills/ask-matt/LICENSE +0 -21
- package/skills/ask-matt/PHASE-BOUNDARIES.md +0 -55
- package/skills/ask-matt/SKILL.md +0 -97
- package/skills/ask-matt/agents/openai.yaml +0 -5
- 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 -114
- package/skills/codebase-design/agents/openai.yaml +0 -3
- package/skills/diagnosing-bugs/LICENSE +0 -21
- package/skills/diagnosing-bugs/SKILL.md +0 -138
- 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/GLOSSARY-FORMAT.md +0 -60
- package/skills/domain-modeling/LICENSE +0 -21
- package/skills/domain-modeling/SKILL.md +0 -74
- package/skills/domain-modeling/agents/openai.yaml +0 -3
- package/skills/grill-me/LICENSE +0 -21
- package/skills/grill-me/SKILL.md +0 -7
- package/skills/grill-me/agents/openai.yaml +0 -5
- package/skills/grill-with-docs/LICENSE +0 -21
- package/skills/grill-with-docs/SKILL.md +0 -7
- package/skills/grill-with-docs/agents/openai.yaml +0 -5
- 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 -16
- package/skills/handoff/agents/openai.yaml +0 -5
- package/skills/implement/LICENSE +0 -21
- package/skills/implement/SKILL.md +0 -17
- package/skills/implement/agents/openai.yaml +0 -5
- package/skills/implement-spec/LICENSE +0 -21
- package/skills/implement-spec/SKILL.md +0 -40
- package/skills/implement-spec/agents/openai.yaml +0 -5
- 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 -71
- package/skills/improve-codebase-architecture/agents/openai.yaml +0 -5
- package/skills/pr/CREDITS.md +0 -3
- package/skills/pr/LICENSE +0 -21
- package/skills/pr/SKILL.md +0 -170
- package/skills/pr/agents/openai.yaml +0 -3
- package/skills/prototype/LICENSE +0 -21
- package/skills/prototype/LOGIC.md +0 -67
- package/skills/prototype/SKILL.md +0 -26
- 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 -12
- package/skills/research/agents/openai.yaml +0 -3
- package/skills/retro/LICENSE +0 -21
- package/skills/retro/SKILL.md +0 -44
- package/skills/retro/agents/openai.yaml +0 -5
- package/skills/tdd/LICENSE +0 -21
- package/skills/tdd/SKILL.md +0 -38
- 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 -140
- package/skills/teach/agents/openai.yaml +0 -5
- package/skills/to-questionnaire/LICENSE +0 -21
- package/skills/to-questionnaire/SKILL.md +0 -54
- package/skills/to-questionnaire/agents/openai.yaml +0 -5
- package/skills/to-spec/LICENSE +0 -21
- package/skills/to-spec/SKILL.md +0 -75
- package/skills/to-spec/agents/openai.yaml +0 -5
- package/skills/to-tickets/LICENSE +0 -21
- package/skills/to-tickets/SKILL.md +0 -105
- package/skills/to-tickets/agents/openai.yaml +0 -5
- package/skills/triage/AGENT-BRIEF.md +0 -207
- package/skills/triage/LICENSE +0 -21
- package/skills/triage/OUT-OF-SCOPE.md +0 -105
- package/skills/triage/SKILL.md +0 -112
- package/skills/triage/agents/openai.yaml +0 -5
- package/skills/wait-what/LICENSE +0 -21
- package/skills/wait-what/SKILL.md +0 -7
- package/skills/wait-what/agents/openai.yaml +0 -5
- package/skills/wayfinder/LICENSE +0 -21
- package/skills/wayfinder/SKILL.md +0 -128
- package/skills/wayfinder/agents/openai.yaml +0 -5
- package/skills/wizard/LICENSE +0 -21
- package/skills/wizard/SKILL.md +0 -44
- package/skills/wizard/agents/openai.yaml +0 -3
- package/skills/wizard/template.sh +0 -223
- 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 -81
- package/skills/writing-for-agents/agents/openai.yaml +0 -3
package/dist/resident.js
CHANGED
|
@@ -8,17 +8,18 @@ import { fileURLToPath } from 'node:url';
|
|
|
8
8
|
import { Agents } from './agents.js';
|
|
9
9
|
import { house } from './api.js';
|
|
10
10
|
import { received } from './bridge.js';
|
|
11
|
-
import {
|
|
11
|
+
import { CONVERSATION_METHODS, Conversations } from './conversations.js';
|
|
12
12
|
import { LocalCopies } from './copies.js';
|
|
13
13
|
import { restart } from './end.js';
|
|
14
14
|
import { agentBase, enrolled, forgetRestart, kitHome, ownerLock, ownerSocket, restartAsked } from './home.js';
|
|
15
|
-
import {
|
|
15
|
+
import { Calls } from './calls.js';
|
|
16
16
|
import { killDescendants } from './scope.js';
|
|
17
17
|
import { quoted } from './shell.js';
|
|
18
18
|
import { SignIns } from './sign-in.js';
|
|
19
19
|
import { placeSkillSet } from './skills.js';
|
|
20
|
-
import {
|
|
21
|
-
import {
|
|
20
|
+
import { holdConnection } from './connection.js';
|
|
21
|
+
import { KitUpdate } from './update.js';
|
|
22
|
+
import { WebWizards } from './web-wizard.js';
|
|
22
23
|
import { codexLauncher } from './work.js';
|
|
23
24
|
function report(error) {
|
|
24
25
|
process.stderr.write(`kit: ${error instanceof Error ? error.message : String(error)}\n`);
|
|
@@ -47,7 +48,7 @@ async function serveOwner(copies) {
|
|
|
47
48
|
if (!claimed(lock)) {
|
|
48
49
|
lock.close();
|
|
49
50
|
const running = await runningResident();
|
|
50
|
-
throw new Error(`${running === null ? 'another Kit' : `Kit ${running}`} already runs this Environment from Kit home ${kitHome()}; stop it first to run another here`);
|
|
51
|
+
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`);
|
|
51
52
|
}
|
|
52
53
|
const server = createServer(async (request, response) => {
|
|
53
54
|
try {
|
|
@@ -132,9 +133,9 @@ export async function resident() {
|
|
|
132
133
|
});
|
|
133
134
|
process.env.HOUSE_KIT_RESIDENT = String(process.pid);
|
|
134
135
|
const agents = new Agents(house, () => changed());
|
|
135
|
-
let
|
|
136
|
+
let connection = null;
|
|
136
137
|
let reported = false;
|
|
137
|
-
const idle = () =>
|
|
138
|
+
const idle = () => calls.idle() && conversations.idle() && agents.idle();
|
|
138
139
|
const changed = () => {
|
|
139
140
|
if (!idle()) {
|
|
140
141
|
reported = false;
|
|
@@ -147,17 +148,18 @@ export async function resident() {
|
|
|
147
148
|
logged(house.deliver('/kit/idle', {}, idle));
|
|
148
149
|
}
|
|
149
150
|
};
|
|
150
|
-
const
|
|
151
|
+
const calls = new Calls(house, changed);
|
|
151
152
|
const conversations = new Conversations({
|
|
152
153
|
house,
|
|
153
154
|
agents,
|
|
154
155
|
copies,
|
|
155
|
-
|
|
156
|
-
send: (
|
|
156
|
+
calls,
|
|
157
|
+
send: (notification) => connection?.send(notification) ?? false,
|
|
157
158
|
changed,
|
|
158
159
|
});
|
|
159
|
-
const signIns = new SignIns(house, agents,
|
|
160
|
-
const
|
|
160
|
+
const signIns = new SignIns(house, agents, calls);
|
|
161
|
+
const update = new KitUpdate(calls);
|
|
162
|
+
const wizards = new WebWizards(calls, (notification) => connection?.send(notification) ?? false);
|
|
161
163
|
for (const signal of ['SIGTERM', 'SIGINT']) {
|
|
162
164
|
process.once(signal, () => {
|
|
163
165
|
killDescendants();
|
|
@@ -165,33 +167,37 @@ export async function resident() {
|
|
|
165
167
|
});
|
|
166
168
|
}
|
|
167
169
|
await house.deliver('/kit/restarted', {}).catch(report);
|
|
168
|
-
await
|
|
170
|
+
await update.resumed().catch(report);
|
|
169
171
|
logged(agents.refresh());
|
|
170
|
-
|
|
172
|
+
connection = holdConnection({
|
|
171
173
|
opened: () => {
|
|
172
174
|
conversations.opened();
|
|
173
175
|
changed();
|
|
174
176
|
logged(copies.connected());
|
|
175
177
|
},
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
conversations.input(arrived);
|
|
190
|
-
else {
|
|
191
|
-
const refused = { refused: `This Kit does not know ${arrived.kind}; update the Kit` };
|
|
192
|
-
void inputs.carry(String(arrived.input_id), async () => ({ ack: refused }));
|
|
193
|
-
}
|
|
178
|
+
closed: () => wizards.disconnected(),
|
|
179
|
+
call: (call) => {
|
|
180
|
+
if (call.kind === 'sign_in')
|
|
181
|
+
signIns.start(call);
|
|
182
|
+
else if (call.kind === 'update')
|
|
183
|
+
update.start(call);
|
|
184
|
+
else if (call.kind === 'run_wizard')
|
|
185
|
+
wizards.start(call);
|
|
186
|
+
else if (CONVERSATION_METHODS.has(call.kind))
|
|
187
|
+
conversations.call(call);
|
|
188
|
+
else {
|
|
189
|
+
const refused = { refused: `This Kit does not know ${call.kind}; update the Kit` };
|
|
190
|
+
void calls.carry(call.input_id, async () => ({ result: refused }));
|
|
194
191
|
}
|
|
195
192
|
},
|
|
193
|
+
notification: (notification) => {
|
|
194
|
+
if (notification.type === 'watching')
|
|
195
|
+
conversations.watching(notification.watching === true);
|
|
196
|
+
if (notification.type === 'authority_changed')
|
|
197
|
+
logged(copies.changed(notification.rooms));
|
|
198
|
+
if (notification.type === 'work_available' && notification.subject === 'agents')
|
|
199
|
+
logged(agents.refresh());
|
|
200
|
+
wizards.notified(notification);
|
|
201
|
+
},
|
|
196
202
|
});
|
|
197
203
|
}
|
package/dist/service.js
CHANGED
|
@@ -13,7 +13,7 @@ function start(command, args) {
|
|
|
13
13
|
if (started.status === 0)
|
|
14
14
|
return;
|
|
15
15
|
const cause = started.error?.message ?? (started.stderr.trim() || `${command} exited with ${started.status ?? 'a signal'}`);
|
|
16
|
-
throw new Error(`the
|
|
16
|
+
throw new Error(`the Kit service could not be started: ${cause}`);
|
|
17
17
|
}
|
|
18
18
|
function physical(path) {
|
|
19
19
|
return existsSync(path) ? realpathSync(path) : resolve(path);
|
package/dist/sign-in.js
CHANGED
|
@@ -15,44 +15,44 @@ function endOf(signal) {
|
|
|
15
15
|
export class SignIns {
|
|
16
16
|
house;
|
|
17
17
|
agents;
|
|
18
|
-
|
|
19
|
-
constructor(house, agents,
|
|
18
|
+
calls;
|
|
19
|
+
constructor(house, agents, calls) {
|
|
20
20
|
this.house = house;
|
|
21
21
|
this.agents = agents;
|
|
22
|
-
this.
|
|
22
|
+
this.calls = calls;
|
|
23
23
|
}
|
|
24
|
-
start(
|
|
25
|
-
void this.
|
|
24
|
+
start(call) {
|
|
25
|
+
void this.calls.carry(call.input_id, () => this.signIn(call));
|
|
26
26
|
}
|
|
27
|
-
async signIn(
|
|
27
|
+
async signIn(call) {
|
|
28
28
|
const ending = new AbortController();
|
|
29
29
|
// House stops waiting for a sign-in ten minutes after it wrote it and sends the seconds left, so its install and login end with the page.
|
|
30
|
-
const timer = setTimeout(() => ending.abort(),
|
|
31
|
-
const ended = await Promise.race([this.signedIn(
|
|
30
|
+
const timer = setTimeout(() => ending.abort(), call.ends_in * 1000);
|
|
31
|
+
const ended = await Promise.race([this.signedIn(call, ending.signal), endOf(ending.signal)]);
|
|
32
32
|
clearTimeout(timer);
|
|
33
33
|
if (ended)
|
|
34
|
-
process.stderr.write(`kit: the ${
|
|
35
|
-
return ended ? {
|
|
34
|
+
process.stderr.write(`kit: the ${call.cli} sign-in reached the end House set for it\n`);
|
|
35
|
+
return ended ? { result: {} } : { result: {}, returned: () => this.agents.reread(call.cli) };
|
|
36
36
|
}
|
|
37
|
-
async signedIn(
|
|
38
|
-
await this.login(
|
|
37
|
+
async signedIn(call, signal) {
|
|
38
|
+
await this.login(call, signal);
|
|
39
39
|
if (!signal.aborted)
|
|
40
|
-
await this.agents.recheck(
|
|
40
|
+
await this.agents.recheck(call.cli, signal);
|
|
41
41
|
return false;
|
|
42
42
|
}
|
|
43
|
-
async login(
|
|
43
|
+
async login(call, signal) {
|
|
44
44
|
let cli;
|
|
45
45
|
try {
|
|
46
|
-
cli = await this.agents.located(
|
|
46
|
+
cli = await this.agents.located(call.cli, signal);
|
|
47
47
|
}
|
|
48
48
|
catch (error) {
|
|
49
49
|
if (!signal.aborted)
|
|
50
|
-
process.stderr.write(`kit: the ${
|
|
50
|
+
process.stderr.write(`kit: the ${call.cli} sign-in failed: ${causeOf(error)}\n`);
|
|
51
51
|
return;
|
|
52
52
|
}
|
|
53
53
|
if (signal.aborted)
|
|
54
54
|
return;
|
|
55
|
-
const login = CLIS[
|
|
55
|
+
const login = CLIS[call.cli].login;
|
|
56
56
|
const child = spawn(cli, login.args, {
|
|
57
57
|
stdio: ['pipe', 'pipe', 'pipe'],
|
|
58
58
|
detached: true,
|
|
@@ -84,7 +84,7 @@ export class SignIns {
|
|
|
84
84
|
return;
|
|
85
85
|
held = true;
|
|
86
86
|
const steps = [{ kind: 'visit', label: 'Open this link and sign in', url: link }, step];
|
|
87
|
-
void holdSecretInput(this.house,
|
|
87
|
+
void holdSecretInput(this.house, call.input_id, steps, running).then((content) => {
|
|
88
88
|
if (!running())
|
|
89
89
|
return;
|
|
90
90
|
if (content === null)
|
|
@@ -101,6 +101,6 @@ export class SignIns {
|
|
|
101
101
|
});
|
|
102
102
|
signal.removeEventListener('abort', stop);
|
|
103
103
|
if (failed !== null && !signal.aborted)
|
|
104
|
-
process.stderr.write(`kit: the ${
|
|
104
|
+
process.stderr.write(`kit: the ${call.cli} sign-in failed: ${failed}\n`);
|
|
105
105
|
}
|
|
106
106
|
}
|
package/dist/skills.js
CHANGED
|
@@ -1,31 +1,10 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { readFileSync } from 'node:fs';
|
|
3
|
-
import { cp, lstat, mkdir, readdir, realpath, rm, symlink } from 'node:fs/promises';
|
|
1
|
+
import { cp, lstat, mkdir, realpath, rm, symlink } from 'node:fs/promises';
|
|
4
2
|
import { homedir } from 'node:os';
|
|
5
3
|
import { join, relative } from 'node:path';
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
8
|
-
import { KIT_VERSION } from './clis.js';
|
|
4
|
+
import { listSkills } from '@agentshouse/skills';
|
|
5
|
+
import { KIT_RELEASE } from './clis.js';
|
|
9
6
|
import { kitHome, readConfiguration, readHome, writeHome } from './home.js';
|
|
10
|
-
import { refusalOf } from './refusals.js';
|
|
11
|
-
const HOW_WE_WORK = '/rooms/private/how-we-work.md';
|
|
12
|
-
const SKILL_SET = fileURLToPath(new URL('../skills/', import.meta.url));
|
|
13
|
-
const HOW_WE_WORK_TEXT = readFileSync(new URL('../how-we-work.md', import.meta.url), 'utf8');
|
|
14
|
-
const SHIPPED_HOW_WE_WORK = [
|
|
15
|
-
'ae4dda60da7b174f22dc5fa9bf07fc27c25864932a74230de4f9f509ddd91f41',
|
|
16
|
-
'0bdcd43e1603ba6673a3cae56d70bbf90657cbeefd124e91a47be2ca1cbd6c93',
|
|
17
|
-
'4106a87ec66da6f7b2a10e74d18e6559d68d5f4fe7415dae68f5c7bdb9081968',
|
|
18
|
-
'ac814a2197038f037b657bb719340395f89f319ac9fcdd386629c3fe2cec68f1',
|
|
19
|
-
'29951ee394aad9979eecfed3e5dc32c2c86e2226b6a380db5dbd4f305f4d1156',
|
|
20
|
-
];
|
|
21
7
|
const RECORD = 'skill-set.json';
|
|
22
|
-
const WRITTEN = 'how-we-work.json';
|
|
23
|
-
const UNWRITABLE = new Set(['room_not_found', 'operation_denied']);
|
|
24
|
-
const PRESENT = new Set(['path_exists']);
|
|
25
|
-
const CHANGED = new Set(['base_revision_stale', 'path_absent']);
|
|
26
|
-
const UNREADABLE = /^(?:\S+: )?(?:path_not_found|room_not_found|operation_denied)\b/;
|
|
27
|
-
const FAILED = /^exit: [1-9]\d*$/;
|
|
28
|
-
const CUT = /^stderr: shell: output_cut (\d+) of \d+ bytes; continue with: (.+)$/;
|
|
29
8
|
function skillsDirectory() {
|
|
30
9
|
return join(homedir(), '.agents', 'skills');
|
|
31
10
|
}
|
|
@@ -44,23 +23,24 @@ async function present(path) {
|
|
|
44
23
|
}
|
|
45
24
|
}
|
|
46
25
|
async function install() {
|
|
47
|
-
const
|
|
48
|
-
for (const
|
|
49
|
-
if (!(await present(join(skillsDirectory(), name))) && !(await present(join(claudeDirectory(), name)))) {
|
|
50
|
-
|
|
26
|
+
const placed = [];
|
|
27
|
+
for (const skill of listSkills()) {
|
|
28
|
+
if (!(await present(join(skillsDirectory(), skill.name))) && !(await present(join(claudeDirectory(), skill.name)))) {
|
|
29
|
+
placed.push(skill);
|
|
51
30
|
}
|
|
52
31
|
}
|
|
32
|
+
const names = placed.map((skill) => skill.name);
|
|
53
33
|
await writeHome(RECORD, { names });
|
|
54
34
|
await mkdir(skillsDirectory(), { recursive: true });
|
|
55
35
|
await mkdir(claudeDirectory(), { recursive: true });
|
|
56
36
|
const skills = await realpath(skillsDirectory());
|
|
57
37
|
const claude = await realpath(claudeDirectory());
|
|
58
|
-
for (const name of
|
|
59
|
-
await cp(
|
|
38
|
+
for (const { name, directory } of placed) {
|
|
39
|
+
await cp(directory, join(skillsDirectory(), name), { recursive: true });
|
|
60
40
|
if (claude !== skills)
|
|
61
41
|
await symlink(relative(claude, join(skills, name)), join(claudeDirectory(), name));
|
|
62
42
|
}
|
|
63
|
-
await writeHome(RECORD, { version:
|
|
43
|
+
await writeHome(RECORD, { version: KIT_RELEASE, names });
|
|
64
44
|
}
|
|
65
45
|
export async function placeSkillSet() {
|
|
66
46
|
try {
|
|
@@ -73,7 +53,7 @@ export async function placeSkillSet() {
|
|
|
73
53
|
async function replaceSkillSet() {
|
|
74
54
|
const accepted = (await readConfiguration()).skills;
|
|
75
55
|
const installed = await readHome(RECORD);
|
|
76
|
-
if (accepted && installed?.version ===
|
|
56
|
+
if (accepted && installed?.version === KIT_RELEASE)
|
|
77
57
|
return;
|
|
78
58
|
for (const name of installed?.names ?? []) {
|
|
79
59
|
await rm(join(claudeDirectory(), name), { recursive: true, force: true });
|
|
@@ -84,64 +64,3 @@ async function replaceSkillSet() {
|
|
|
84
64
|
else
|
|
85
65
|
await rm(join(kitHome(), RECORD), { force: true });
|
|
86
66
|
}
|
|
87
|
-
function sha256(text) {
|
|
88
|
-
return createHash('sha256').update(text).digest('hex');
|
|
89
|
-
}
|
|
90
|
-
function cutOf(lines) {
|
|
91
|
-
const cut = CUT.exec(lines[0] ?? '');
|
|
92
|
-
return cut !== null && Buffer.byteLength(lines.slice(1).join('\n')) === Number(cut[1]) ? cut : null;
|
|
93
|
-
}
|
|
94
|
-
export async function readHowWeWork(bridge) {
|
|
95
|
-
let document = '';
|
|
96
|
-
for (let command = `cat ${HOW_WE_WORK}`; command !== undefined;) {
|
|
97
|
-
const read = await bridge.tool('shell', { command });
|
|
98
|
-
const text = read.content.map((content) => content.text).join('\n');
|
|
99
|
-
const lines = text.split('\n');
|
|
100
|
-
if (read.isError === true || (FAILED.test(lines[0] ?? '') && lines[1]?.startsWith('stderr: '))) {
|
|
101
|
-
const refusal = read.isError === true ? text : lines.slice(1).join('\n').replace(/^stderr: /gm, '');
|
|
102
|
-
if (UNREADABLE.test(refusal))
|
|
103
|
-
return '';
|
|
104
|
-
throw new Error(refusal);
|
|
105
|
-
}
|
|
106
|
-
const cut = cutOf(lines);
|
|
107
|
-
document += lines.slice(cut === null ? 0 : 1).join('\n');
|
|
108
|
-
command = cut?.[2];
|
|
109
|
-
}
|
|
110
|
-
return document;
|
|
111
|
-
}
|
|
112
|
-
async function currentRevision(bridge) {
|
|
113
|
-
const inspected = await bridge.tool('inspect', { path: HOW_WE_WORK });
|
|
114
|
-
const text = inspected.content.map((content) => content.text).join('\n');
|
|
115
|
-
if (inspected.isError === true)
|
|
116
|
-
throw new Error(text);
|
|
117
|
-
return parse(text).revisions[0].revision;
|
|
118
|
-
}
|
|
119
|
-
async function edit(bridge, change, kept) {
|
|
120
|
-
const edited = await bridge.tool('edit', { changes: [{ ...change, path: HOW_WE_WORK, content: HOW_WE_WORK_TEXT }] });
|
|
121
|
-
if (edited.isError !== true)
|
|
122
|
-
return 'written';
|
|
123
|
-
const text = edited.content.map((content) => content.text).join('\n');
|
|
124
|
-
const refusal = refusalOf(text);
|
|
125
|
-
if (UNWRITABLE.has(refusal?.code ?? ''))
|
|
126
|
-
return 'unwritable';
|
|
127
|
-
if (refusal?.code === 'edit_conflict' && refusal.conflicts.some((conflict) => kept.has(conflict)))
|
|
128
|
-
return 'kept';
|
|
129
|
-
throw new Error(text);
|
|
130
|
-
}
|
|
131
|
-
export async function createHowWeWork(bridge) {
|
|
132
|
-
if (!(await readConfiguration()).skills || (await readHome(RECORD))?.version === undefined)
|
|
133
|
-
return;
|
|
134
|
-
const current = sha256(HOW_WE_WORK_TEXT);
|
|
135
|
-
if ((await readHome(WRITTEN)) === current)
|
|
136
|
-
return;
|
|
137
|
-
const created = await edit(bridge, { op: 'create' }, PRESENT);
|
|
138
|
-
if (created === 'unwritable')
|
|
139
|
-
return;
|
|
140
|
-
if (created === 'kept') {
|
|
141
|
-
const base = await currentRevision(bridge);
|
|
142
|
-
const held = sha256(await readHowWeWork(bridge));
|
|
143
|
-
if (held !== current && SHIPPED_HOW_WE_WORK.includes(held) && (await edit(bridge, { op: 'replace', base }, CHANGED)) === 'unwritable')
|
|
144
|
-
return;
|
|
145
|
-
}
|
|
146
|
-
await writeHome(WRITTEN, current);
|
|
147
|
-
}
|
package/dist/transcription.js
CHANGED
|
@@ -6,6 +6,7 @@ import { basename, join } from 'node:path';
|
|
|
6
6
|
import { pipeline } from 'node:stream/promises';
|
|
7
7
|
import { unlessAborted } from './abort.js';
|
|
8
8
|
import { failureOf, run } from './clis.js';
|
|
9
|
+
import { downloaded, fetched } from './files.js';
|
|
9
10
|
import { kitHome } from './home.js';
|
|
10
11
|
const RELEASE = 'https://github.com/agentshouse/kit/releases/download/engine-2';
|
|
11
12
|
export const MODEL = {
|
|
@@ -28,6 +29,11 @@ export const ENGINES = {
|
|
|
28
29
|
},
|
|
29
30
|
};
|
|
30
31
|
const CHUNK_SECONDS = 20;
|
|
32
|
+
const OFF = "transcription is off on the Agent's Environment, so this message's audio has no text; turn it on or write instead";
|
|
33
|
+
const NOT_INSTALLED = "the speech engine is not installed on the Agent's Environment, so this message's audio has no text";
|
|
34
|
+
const NOT_DOWNLOADED = 'an audio file this message links could not be downloaded; send the message again';
|
|
35
|
+
const UNDECODABLE = 'an audio file this message links could not be decoded';
|
|
36
|
+
const UNTRANSCRIBED = 'an audio file this message links could not be transcribed';
|
|
31
37
|
let held = Promise.resolve();
|
|
32
38
|
let holding = Promise.resolve();
|
|
33
39
|
let setting = null;
|
|
@@ -62,6 +68,20 @@ async function sha256(path) {
|
|
|
62
68
|
function causeOf(error) {
|
|
63
69
|
return error instanceof Error ? error.message : String(error);
|
|
64
70
|
}
|
|
71
|
+
async function failing(reason, work) {
|
|
72
|
+
try {
|
|
73
|
+
return await work;
|
|
74
|
+
}
|
|
75
|
+
catch (error) {
|
|
76
|
+
throw new Error(reason, { cause: error });
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
function ready() {
|
|
80
|
+
if (setting !== true)
|
|
81
|
+
throw new Error(OFF);
|
|
82
|
+
if (!readiness.installed)
|
|
83
|
+
throw new Error(NOT_INSTALLED);
|
|
84
|
+
}
|
|
65
85
|
function pinnedHere() {
|
|
66
86
|
return ENGINES[`${process.platform}-${process.arch}`];
|
|
67
87
|
}
|
|
@@ -133,27 +153,23 @@ export function holdTranscription(transcribe) {
|
|
|
133
153
|
export function transcriptionReport() {
|
|
134
154
|
return readiness;
|
|
135
155
|
}
|
|
136
|
-
async function transcribed(
|
|
156
|
+
async function transcribed(audio, parts, signal) {
|
|
137
157
|
const pinned = pinnedHere();
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
await rm(work, { recursive: true, force: true });
|
|
152
|
-
}
|
|
158
|
+
await mkdir(parts);
|
|
159
|
+
await failing(UNDECODABLE, executed(installed(pinned.decoder), ['-nostdin', '-hide_banner', '-loglevel', 'error', '-i', audio, '-ar', '16000', '-ac', '1', '-c:a', 'pcm_s16le',
|
|
160
|
+
'-f', 'segment', '-segment_time', String(CHUNK_SECONDS), join(parts, '%05d.wav')], signal));
|
|
161
|
+
const segments = (await readdir(parts)).sort().flatMap((part) => ['-f', join(parts, part)]);
|
|
162
|
+
const said = await failing(UNTRANSCRIBED, executed(installed(pinned.engine), ['-t', String(await threads()), '-np', '-m', installed(MODEL), ...segments], signal));
|
|
163
|
+
const text = said
|
|
164
|
+
.split('\n')
|
|
165
|
+
.map((line) => line.trim())
|
|
166
|
+
.filter((line) => line !== '')
|
|
167
|
+
.join(' ');
|
|
168
|
+
if (text === '')
|
|
169
|
+
throw new Error(UNTRANSCRIBED);
|
|
170
|
+
return text;
|
|
153
171
|
}
|
|
154
|
-
|
|
155
|
-
if (!readiness.installed)
|
|
156
|
-
return null;
|
|
172
|
+
async function alone(work, signal) {
|
|
157
173
|
const before = held;
|
|
158
174
|
let release;
|
|
159
175
|
const mine = new Promise((resolve) => {
|
|
@@ -162,9 +178,24 @@ export async function transcribe(path, signal) {
|
|
|
162
178
|
held = Promise.all([before, mine]);
|
|
163
179
|
try {
|
|
164
180
|
await unlessAborted(before, signal);
|
|
165
|
-
return
|
|
181
|
+
return await work();
|
|
166
182
|
}
|
|
167
183
|
finally {
|
|
168
184
|
release();
|
|
169
185
|
}
|
|
170
186
|
}
|
|
187
|
+
export async function transcribe(address, signal) {
|
|
188
|
+
ready();
|
|
189
|
+
const work = await mkdtemp(join(tmpdir(), 'kit-transcription-'));
|
|
190
|
+
try {
|
|
191
|
+
const audio = join(work, 'audio');
|
|
192
|
+
await failing(NOT_DOWNLOADED, downloaded(address, (url) => fetched(url, signal), audio, 'audio'));
|
|
193
|
+
return await alone(() => {
|
|
194
|
+
ready();
|
|
195
|
+
return transcribed(audio, join(work, 'parts'), signal);
|
|
196
|
+
}, signal);
|
|
197
|
+
}
|
|
198
|
+
finally {
|
|
199
|
+
await rm(work, { recursive: true, force: true });
|
|
200
|
+
}
|
|
201
|
+
}
|
package/dist/update.js
CHANGED
|
@@ -15,8 +15,8 @@ function pending() {
|
|
|
15
15
|
function outcome() {
|
|
16
16
|
return join(directory(), 'outcome');
|
|
17
17
|
}
|
|
18
|
-
function unit(
|
|
19
|
-
return `house-kit-update-${
|
|
18
|
+
function unit(callId) {
|
|
19
|
+
return `house-kit-update-${callId}`;
|
|
20
20
|
}
|
|
21
21
|
function manager() {
|
|
22
22
|
return service() === 'user' ? ['--user'] : [];
|
|
@@ -33,7 +33,7 @@ function placement() {
|
|
|
33
33
|
function record() {
|
|
34
34
|
return `outcome=$1; shift; bash "$0" "$@"; printf %s "$?" > "$outcome"; ${[...elevated(), 'systemctl', ...manager(), 'start', 'house-kit.service'].join(' ')}`;
|
|
35
35
|
}
|
|
36
|
-
async function
|
|
36
|
+
async function pendingCall() {
|
|
37
37
|
try {
|
|
38
38
|
return JSON.parse(await readFile(pending(), 'utf8')).input_id;
|
|
39
39
|
}
|
|
@@ -47,26 +47,26 @@ async function recorded() {
|
|
|
47
47
|
return null;
|
|
48
48
|
return status.trim() === '0' ? {} : { refused: `the Kit bootstrap exited with ${status.trim()}` };
|
|
49
49
|
}
|
|
50
|
-
async function forget(
|
|
51
|
-
if ((await
|
|
50
|
+
async function forget(callId) {
|
|
51
|
+
if ((await pendingCall()) !== callId)
|
|
52
52
|
return;
|
|
53
53
|
await rm(pending(), { force: true });
|
|
54
54
|
await rm(outcome(), { force: true });
|
|
55
55
|
}
|
|
56
|
-
async function finished(
|
|
56
|
+
async function finished(callId) {
|
|
57
57
|
for (;;) {
|
|
58
|
-
const
|
|
59
|
-
if (
|
|
60
|
-
return
|
|
58
|
+
const result = await recorded();
|
|
59
|
+
if (result !== null)
|
|
60
|
+
return result;
|
|
61
61
|
// systemctl answers at once, so ten seconds only bounds a stuck service manager.
|
|
62
|
-
if ((await run('systemctl', [...manager(), 'is-active', '--quiet', unit(
|
|
62
|
+
if ((await run('systemctl', [...manager(), 'is-active', '--quiet', unit(callId)], 10_000)).status !== 0) {
|
|
63
63
|
return (await recorded()) ?? { refused: 'the Kit bootstrap did not finish' };
|
|
64
64
|
}
|
|
65
65
|
// The bootstrap runs for minutes, so checking each second sees its outcome within a second at little cost.
|
|
66
66
|
await new Promise((resolve) => setTimeout(resolve, 1000));
|
|
67
67
|
}
|
|
68
68
|
}
|
|
69
|
-
function rerun(script,
|
|
69
|
+
function rerun(script, callId, flags) {
|
|
70
70
|
return new Promise((resolve) => {
|
|
71
71
|
const [command, ...args] = [
|
|
72
72
|
...elevated(),
|
|
@@ -76,7 +76,7 @@ function rerun(script, inputId, flags) {
|
|
|
76
76
|
'--wait',
|
|
77
77
|
'--collect',
|
|
78
78
|
'--quiet',
|
|
79
|
-
`--unit=${unit(
|
|
79
|
+
`--unit=${unit(callId)}`,
|
|
80
80
|
`--setenv=HOME=${homedir()}`,
|
|
81
81
|
`--setenv=HOUSE_KIT_HOME=${kitHome()}`,
|
|
82
82
|
'/bin/sh',
|
|
@@ -88,50 +88,50 @@ function rerun(script, inputId, flags) {
|
|
|
88
88
|
...flags,
|
|
89
89
|
];
|
|
90
90
|
const child = spawn(command, args, { stdio: ['ignore', 'ignore', 'inherit'] });
|
|
91
|
-
child.on('error', () => resolve({ refused: 'no service manager runs this Kit' }));
|
|
91
|
+
child.on('error', () => resolve({ refused: 'no service manager runs this Kit process' }));
|
|
92
92
|
child.on('close', () => resolve(null));
|
|
93
93
|
});
|
|
94
94
|
}
|
|
95
|
-
export class
|
|
96
|
-
|
|
95
|
+
export class KitUpdate {
|
|
96
|
+
calls;
|
|
97
97
|
queue = Promise.resolve();
|
|
98
|
-
constructor(
|
|
99
|
-
this.
|
|
98
|
+
constructor(calls) {
|
|
99
|
+
this.calls = calls;
|
|
100
100
|
}
|
|
101
101
|
async resumed() {
|
|
102
|
-
const
|
|
103
|
-
if (
|
|
102
|
+
const callId = await pendingCall();
|
|
103
|
+
if (callId === null)
|
|
104
104
|
return;
|
|
105
|
-
await this.enqueue(
|
|
105
|
+
await this.enqueue(callId, () => finished(callId));
|
|
106
106
|
}
|
|
107
|
-
start(
|
|
108
|
-
void this.enqueue(
|
|
107
|
+
start(call) {
|
|
108
|
+
void this.enqueue(call.input_id, () => this.carry(call));
|
|
109
109
|
}
|
|
110
|
-
enqueue(
|
|
110
|
+
enqueue(callId, work) {
|
|
111
111
|
const before = this.queue;
|
|
112
|
-
const carried = this.
|
|
112
|
+
const carried = this.calls.carry(callId, async () => {
|
|
113
113
|
await before;
|
|
114
|
-
return {
|
|
114
|
+
return { result: await work(), returned: () => forget(callId) };
|
|
115
115
|
});
|
|
116
116
|
this.queue = before.then(() => carried);
|
|
117
117
|
return carried;
|
|
118
118
|
}
|
|
119
|
-
async carry(
|
|
120
|
-
if ((await
|
|
121
|
-
return finished(
|
|
122
|
-
const answer = await fetch(
|
|
119
|
+
async carry(call) {
|
|
120
|
+
if ((await pendingCall()) === call.input_id)
|
|
121
|
+
return finished(call.input_id);
|
|
122
|
+
const answer = await fetch(call.bootstrap);
|
|
123
123
|
if (!answer.ok)
|
|
124
124
|
return { refused: `the Kit bootstrap could not be downloaded: ${answer.status}` };
|
|
125
125
|
const script = Buffer.from(await answer.arrayBuffer());
|
|
126
|
-
if (createHash('sha256').update(script).digest('hex') !==
|
|
126
|
+
if (createHash('sha256').update(script).digest('hex') !== call.sha256) {
|
|
127
127
|
return { refused: 'the Kit bootstrap does not match its sha256' };
|
|
128
128
|
}
|
|
129
129
|
await mkdir(directory(), { recursive: true, mode: 0o700 });
|
|
130
130
|
const path = join(directory(), 'connect-linux.sh');
|
|
131
131
|
await writeFile(path, script, { mode: 0o700 });
|
|
132
132
|
await rm(outcome(), { force: true });
|
|
133
|
-
await writeFile(pending(), `${JSON.stringify({ input_id:
|
|
134
|
-
return (await rerun(path,
|
|
133
|
+
await writeFile(pending(), `${JSON.stringify({ input_id: call.input_id })}\n`, { mode: 0o600 });
|
|
134
|
+
return (await rerun(path, call.input_id, call.update_clis ? ['--update-clis'] : [])) ?? (await recorded()) ?? {
|
|
135
135
|
refused: 'the Kit bootstrap did not finish',
|
|
136
136
|
};
|
|
137
137
|
}
|