@agentshouse/kit 0.2.1-cb6679d048e60 → 0.2.1-cb997daca91ed
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 +42 -41
- package/dist/acp.js +50 -106
- package/dist/agents.js +180 -51
- package/dist/api.js +36 -3
- package/dist/app-git.js +48 -0
- package/dist/authority-main.js +2 -2
- package/dist/bridge.js +40 -59
- package/dist/building.js +46 -0
- package/dist/calls.js +63 -0
- package/dist/chatgpt.js +32 -0
- package/dist/clis-main.js +2 -2
- package/dist/clis.js +171 -76
- package/dist/codex-main.js +58 -0
- package/dist/connection.js +143 -0
- package/dist/conversations.js +625 -323
- package/dist/copies.js +205 -150
- package/dist/end.js +27 -0
- package/dist/enrol-main.js +7 -1
- package/dist/events.js +525 -0
- package/dist/files.js +140 -17
- package/dist/git.js +13 -11
- package/dist/home.js +96 -7
- package/dist/house-cli.js +299 -0
- package/dist/house-main.js +7 -159
- package/dist/instructions.js +8 -10
- package/dist/kit-cli.js +68 -0
- package/dist/kit-main.js +8 -19
- package/dist/login.js +117 -104
- package/dist/logout.js +14 -13
- package/dist/mcp.js +6 -3
- package/dist/parts.js +82 -0
- package/dist/placement.js +39 -0
- package/dist/refusals.js +12 -0
- package/dist/relay.js +41 -0
- package/dist/resident.js +116 -51
- package/dist/scope.js +206 -0
- package/dist/secret-input.js +4 -1
- package/dist/service-main.js +9 -0
- package/dist/service.js +55 -0
- package/dist/shell.js +3 -0
- package/dist/sign-in.js +40 -32
- package/dist/skills.js +49 -35
- package/dist/transcription.js +129 -41
- package/dist/translate.js +2 -8
- package/dist/update.js +112 -53
- package/dist/web-wizard.js +101 -0
- package/dist/wire.js +22 -0
- package/dist/work.js +346 -0
- package/package.json +20 -20
- package/dist/blocks.js +0 -51
- package/dist/bootstrap.json +0 -24
- package/dist/stream.js +0 -46
- 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/skills.js
CHANGED
|
@@ -1,17 +1,14 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { cp, lstat, mkdir, readdir, realpath, rm, symlink, writeFile } from 'node:fs/promises';
|
|
1
|
+
import { cp, lstat, mkdir, realpath, rm, symlink, writeFile } from 'node:fs/promises';
|
|
3
2
|
import { homedir } from 'node:os';
|
|
4
3
|
import { join, relative } from 'node:path';
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
4
|
+
import { GUIDE, listSkills } from '@agentshouse/skills';
|
|
5
|
+
import { parse } from 'yaml';
|
|
6
|
+
import { KIT_RELEASE } from './clis.js';
|
|
7
7
|
import { kitHome, readConfiguration, readHome, writeHome } from './home.js';
|
|
8
|
-
import { refusalOf } from './refusals.js';
|
|
9
|
-
export const HOW_WE_WORK = '/private/how-we-work.md';
|
|
10
|
-
const SKILL_SET = fileURLToPath(new URL('../skills/', import.meta.url));
|
|
11
|
-
const HOW_WE_WORK_TEXT = readFileSync(new URL('../how-we-work.md', import.meta.url), 'utf8');
|
|
12
8
|
const RECORD = 'skill-set.json';
|
|
13
|
-
const
|
|
14
|
-
const
|
|
9
|
+
const ENTRY = 'SKILL.md';
|
|
10
|
+
const FRONTMATTER = /^---\n([\s\S]*?)\n---\n/u;
|
|
11
|
+
const ORIGIN = '<origin>';
|
|
15
12
|
function skillsDirectory() {
|
|
16
13
|
return join(homedir(), '.agents', 'skills');
|
|
17
14
|
}
|
|
@@ -29,50 +26,67 @@ async function present(path) {
|
|
|
29
26
|
throw error;
|
|
30
27
|
}
|
|
31
28
|
}
|
|
32
|
-
|
|
33
|
-
const
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
29
|
+
function skillName(text) {
|
|
30
|
+
const front = FRONTMATTER.exec(text);
|
|
31
|
+
const fields = (front === null ? null : parse(front[1]));
|
|
32
|
+
return typeof fields?.name === 'string' && typeof fields.description === 'string' ? fields.name : undefined;
|
|
33
|
+
}
|
|
34
|
+
function skillSet(origin) {
|
|
35
|
+
const upstream = listSkills().map(({ name, directory }) => ({
|
|
36
|
+
name,
|
|
37
|
+
place: (destination) => cp(directory, destination, { recursive: true }),
|
|
38
|
+
}));
|
|
39
|
+
const pages = GUIDE.flatMap(({ text }) => {
|
|
40
|
+
const name = skillName(text);
|
|
41
|
+
if (name === undefined)
|
|
42
|
+
return [];
|
|
43
|
+
const place = async (destination) => {
|
|
44
|
+
await mkdir(destination);
|
|
45
|
+
await writeFile(join(destination, ENTRY), text.replaceAll(ORIGIN, origin));
|
|
46
|
+
};
|
|
47
|
+
return [{ name, place }];
|
|
48
|
+
});
|
|
49
|
+
return [...upstream, ...pages].sort((left, right) => (left.name < right.name ? -1 : 1));
|
|
50
|
+
}
|
|
51
|
+
async function install(origin) {
|
|
52
|
+
const placed = [];
|
|
53
|
+
for (const skill of skillSet(origin)) {
|
|
54
|
+
if (!(await present(join(skillsDirectory(), skill.name))) && !(await present(join(claudeDirectory(), skill.name)))) {
|
|
55
|
+
placed.push(skill);
|
|
37
56
|
}
|
|
38
57
|
}
|
|
58
|
+
const names = placed.map((skill) => skill.name);
|
|
39
59
|
await writeHome(RECORD, { names });
|
|
40
60
|
await mkdir(skillsDirectory(), { recursive: true });
|
|
41
61
|
await mkdir(claudeDirectory(), { recursive: true });
|
|
42
62
|
const skills = await realpath(skillsDirectory());
|
|
43
63
|
const claude = await realpath(claudeDirectory());
|
|
44
|
-
for (const name of
|
|
45
|
-
await
|
|
64
|
+
for (const { name, place } of placed) {
|
|
65
|
+
await place(join(skillsDirectory(), name));
|
|
46
66
|
if (claude !== skills)
|
|
47
67
|
await symlink(relative(claude, join(skills, name)), join(claudeDirectory(), name));
|
|
48
68
|
}
|
|
49
|
-
await writeHome(RECORD, { version:
|
|
69
|
+
await writeHome(RECORD, { version: KIT_RELEASE, origin, names });
|
|
70
|
+
}
|
|
71
|
+
export async function placeSkillSet(origin) {
|
|
72
|
+
try {
|
|
73
|
+
await replaceSkillSet(origin);
|
|
74
|
+
}
|
|
75
|
+
catch (error) {
|
|
76
|
+
process.stderr.write(`kit: the skills could not be placed: ${error.message}\n`);
|
|
77
|
+
}
|
|
50
78
|
}
|
|
51
|
-
|
|
79
|
+
async function replaceSkillSet(origin) {
|
|
52
80
|
const accepted = (await readConfiguration()).skills;
|
|
53
81
|
const installed = await readHome(RECORD);
|
|
54
|
-
if (accepted && installed?.version ===
|
|
82
|
+
if (accepted && installed?.version === KIT_RELEASE && installed.origin === origin)
|
|
55
83
|
return;
|
|
56
84
|
for (const name of installed?.names ?? []) {
|
|
57
85
|
await rm(join(claudeDirectory(), name), { recursive: true, force: true });
|
|
58
86
|
await rm(join(skillsDirectory(), name), { recursive: true, force: true });
|
|
59
87
|
}
|
|
60
88
|
if (accepted)
|
|
61
|
-
await install();
|
|
89
|
+
await install(origin);
|
|
62
90
|
else
|
|
63
91
|
await rm(join(kitHome(), RECORD), { force: true });
|
|
64
92
|
}
|
|
65
|
-
export async function createHowWeWork(bridge) {
|
|
66
|
-
if ((await readHome(RECORD)) === null || (await present(join(kitHome(), CREATED))))
|
|
67
|
-
return;
|
|
68
|
-
const created = await bridge.tool('edit', { changes: [{ op: 'create', path: HOW_WE_WORK, content: HOW_WE_WORK_TEXT }] });
|
|
69
|
-
if (created.isError === true) {
|
|
70
|
-
const text = created.content.map((content) => content.text).join('\n');
|
|
71
|
-
const refusal = refusalOf(text);
|
|
72
|
-
if (UNWRITABLE.has(refusal?.code ?? ''))
|
|
73
|
-
return;
|
|
74
|
-
if (refusal?.code !== 'edit_conflict' || !refusal.conflicts.includes('path_exists'))
|
|
75
|
-
throw new Error(text);
|
|
76
|
-
}
|
|
77
|
-
await writeFile(join(kitHome(), CREATED), '');
|
|
78
|
-
}
|
package/dist/transcription.js
CHANGED
|
@@ -1,34 +1,44 @@
|
|
|
1
|
-
import { createHash } from 'node:crypto';
|
|
2
|
-
import { createReadStream } from 'node:fs';
|
|
3
1
|
import { chmod, mkdir, mkdtemp, readdir, readFile, rename, rm, stat } from 'node:fs/promises';
|
|
4
2
|
import { availableParallelism, tmpdir } from 'node:os';
|
|
5
3
|
import { basename, join } from 'node:path';
|
|
6
|
-
import { pipeline } from 'node:stream/promises';
|
|
7
4
|
import { unlessAborted } from './abort.js';
|
|
5
|
+
import { downloadServed } from './building.js';
|
|
8
6
|
import { failureOf, run } from './clis.js';
|
|
7
|
+
import { downloaded, fetched } from './files.js';
|
|
9
8
|
import { kitHome } from './home.js';
|
|
10
9
|
const RELEASE = 'https://github.com/agentshouse/kit/releases/download/engine-2';
|
|
11
10
|
export const MODEL = {
|
|
12
|
-
|
|
11
|
+
name: 'ggml-parakeet-tdt-0.6b-v3-q4_k.bin',
|
|
12
|
+
from: 'https://huggingface.co/ggml-org/parakeet-GGUF/resolve/35156454d1a39de06863303dd209fd2bed6ee079/ggml-parakeet-tdt-0.6b-v3-q4_k.bin',
|
|
13
13
|
sha256: '8b205b8b39c6535e153de6fb11c51db46125d45c4f16ba496fe41a0fe71b885e',
|
|
14
|
+
bytes: 415_611_879,
|
|
14
15
|
executable: false,
|
|
15
16
|
};
|
|
16
17
|
export const ENGINES = {
|
|
17
18
|
'linux-x64': {
|
|
18
|
-
decoder: {
|
|
19
|
-
engine: {
|
|
19
|
+
decoder: { name: 'ffmpeg-linux-x86_64', from: `${RELEASE}/ffmpeg-linux-x86_64`, sha256: '1f8235d206428305afb89c6e8ab99d100425a0ba61e22bb4c7aff017db8c8de5', bytes: 5_175_832, executable: true },
|
|
20
|
+
engine: { name: 'parakeet-cli-linux-x86_64', from: `${RELEASE}/parakeet-cli-linux-x86_64`, sha256: 'bb2585695992fe1927a33960002cdf51b8a90a96ad65593c3d0a9f1fbc0865c2', bytes: 3_801_616, executable: true },
|
|
20
21
|
},
|
|
21
22
|
'linux-arm64': {
|
|
22
|
-
decoder: {
|
|
23
|
-
engine: {
|
|
23
|
+
decoder: { name: 'ffmpeg-linux-aarch64', from: `${RELEASE}/ffmpeg-linux-aarch64`, sha256: 'a7e08a0fae0179d1078312f6bb13d2a9aa4d4c71a1d82a022953f25dee452f5e', bytes: 4_590_208, executable: true },
|
|
24
|
+
engine: { name: 'parakeet-cli-linux-aarch64', from: `${RELEASE}/parakeet-cli-linux-aarch64`, sha256: 'cbc0bedc8daae97f1ef9dcee4200c06226218e300e0fd62ead1306d22742b7ed', bytes: 3_477_624, executable: true },
|
|
24
25
|
},
|
|
25
26
|
'darwin-arm64': {
|
|
26
|
-
decoder: {
|
|
27
|
-
engine: {
|
|
27
|
+
decoder: { name: 'ffmpeg-darwin-arm64', from: `${RELEASE}/ffmpeg-darwin-arm64`, sha256: '7abe154aaed3d6b49f5167ca7221bb66bed51388925d99a7e4261a41fe52fba6', bytes: 3_696_768, executable: true },
|
|
28
|
+
engine: { name: 'parakeet-cli-darwin-arm64', from: `${RELEASE}/parakeet-cli-darwin-arm64`, sha256: '9a2aafc0922ad7c0b6db6eff1641e96572ba32ac40bf995a1df242ed2febf297', bytes: 1_939_728, executable: true },
|
|
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();
|
|
38
|
+
let holding = Promise.resolve();
|
|
39
|
+
let setting = null;
|
|
40
|
+
let downloading = null;
|
|
41
|
+
let readiness = { installed: false, failure: null };
|
|
32
42
|
function directory() {
|
|
33
43
|
return join(kitHome(), 'transcription');
|
|
34
44
|
}
|
|
@@ -36,6 +46,7 @@ function installed(artifact) {
|
|
|
36
46
|
return join(directory(), artifact.sha256);
|
|
37
47
|
}
|
|
38
48
|
async function executed(command, args, signal) {
|
|
49
|
+
// A decode or a transcription runs as long as its audio needs; the setting turning off or the turn's interrupt or end aborts it instead.
|
|
39
50
|
const ran = await run(command, args, 0, false, signal);
|
|
40
51
|
if (ran.status !== 0)
|
|
41
52
|
throw new Error(failureOf(ran, basename(command)));
|
|
@@ -44,15 +55,49 @@ async function executed(command, args, signal) {
|
|
|
44
55
|
function present(path) {
|
|
45
56
|
return stat(path).then(() => true, () => false);
|
|
46
57
|
}
|
|
47
|
-
async function
|
|
58
|
+
async function threads() {
|
|
48
59
|
const [quota, period] = (await readFile('/sys/fs/cgroup/cpu.max', 'utf8').catch(() => 'max')).split(' ');
|
|
49
60
|
const allowed = quota === 'max' ? Infinity : Math.ceil(Number(quota) / Number(period));
|
|
50
|
-
return Math.min(availableParallelism(), allowed);
|
|
61
|
+
return Math.max(1, Math.floor(Math.min(availableParallelism(), allowed) / 2));
|
|
51
62
|
}
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
63
|
+
function causeOf(error) {
|
|
64
|
+
return error instanceof Error ? error.message : String(error);
|
|
65
|
+
}
|
|
66
|
+
async function failing(reason, work) {
|
|
67
|
+
try {
|
|
68
|
+
return await work;
|
|
69
|
+
}
|
|
70
|
+
catch (error) {
|
|
71
|
+
throw new Error(reason, { cause: error });
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
function ready() {
|
|
75
|
+
if (setting !== true)
|
|
76
|
+
throw new Error(OFF);
|
|
77
|
+
if (!readiness.installed)
|
|
78
|
+
throw new Error(NOT_INSTALLED);
|
|
79
|
+
}
|
|
80
|
+
function pinnedHere() {
|
|
81
|
+
return ENGINES[`${process.platform}-${process.arch}`];
|
|
82
|
+
}
|
|
83
|
+
const DOWNLOADS = 3;
|
|
84
|
+
async function downloadedAgain(artifact, signal) {
|
|
85
|
+
// An artifact arrives at a hundred kilobytes a second or its download ends, so a stalled Building cannot hold the install open.
|
|
86
|
+
const deadlineMs = Math.ceil(artifact.bytes / 100);
|
|
87
|
+
const deadline = AbortSignal.timeout(deadlineMs);
|
|
88
|
+
for (let attempt = 1;; attempt++) {
|
|
89
|
+
try {
|
|
90
|
+
return await downloadServed(artifact.name, artifact.sha256, `${installed(artifact)}.part`, AbortSignal.any([signal, deadline]), artifact.bytes);
|
|
91
|
+
}
|
|
92
|
+
catch (error) {
|
|
93
|
+
if (signal.aborted)
|
|
94
|
+
throw error;
|
|
95
|
+
if (deadline.aborted)
|
|
96
|
+
throw new Error(`${artifact.name} did not arrive within ${Math.ceil(deadlineMs / 1000)} seconds`);
|
|
97
|
+
if (attempt === DOWNLOADS)
|
|
98
|
+
throw error;
|
|
99
|
+
}
|
|
100
|
+
}
|
|
56
101
|
}
|
|
57
102
|
async function install(artifacts, signal) {
|
|
58
103
|
await mkdir(directory(), { recursive: true });
|
|
@@ -66,12 +111,8 @@ async function install(artifacts, signal) {
|
|
|
66
111
|
if (!(await present(installed(artifact))))
|
|
67
112
|
missing.push(artifact);
|
|
68
113
|
try {
|
|
69
|
-
for (const artifact of missing)
|
|
70
|
-
|
|
71
|
-
await executed('curl', ['-fsSL', '--retry', '3', '-o', part, artifact.url], signal);
|
|
72
|
-
if ((await sha256(part)) !== artifact.sha256)
|
|
73
|
-
throw new Error(`${artifact.url} does not match its sha256`);
|
|
74
|
-
}
|
|
114
|
+
for (const artifact of missing)
|
|
115
|
+
await downloadedAgain(artifact, signal);
|
|
75
116
|
for (const artifact of missing) {
|
|
76
117
|
if (artifact.executable)
|
|
77
118
|
await chmod(`${installed(artifact)}.part`, 0o755);
|
|
@@ -83,29 +124,61 @@ async function install(artifacts, signal) {
|
|
|
83
124
|
await rm(`${installed(artifact)}.part`, { force: true });
|
|
84
125
|
}
|
|
85
126
|
}
|
|
86
|
-
|
|
87
|
-
const
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
127
|
+
function reported(next) {
|
|
128
|
+
const changed = next.installed !== readiness.installed || next.failure !== readiness.failure;
|
|
129
|
+
readiness = next;
|
|
130
|
+
return changed;
|
|
131
|
+
}
|
|
132
|
+
async function settle(transcribe) {
|
|
133
|
+
if (transcribe === setting)
|
|
134
|
+
return false;
|
|
135
|
+
setting = transcribe;
|
|
136
|
+
if (!transcribe) {
|
|
137
|
+
await rm(directory(), { recursive: true, force: true });
|
|
138
|
+
return reported({ installed: false, failure: null });
|
|
139
|
+
}
|
|
140
|
+
const download = new AbortController();
|
|
141
|
+
downloading = download;
|
|
93
142
|
try {
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
.filter((line) => line !== '')
|
|
102
|
-
.join(' ');
|
|
143
|
+
const pinned = pinnedHere();
|
|
144
|
+
await install([pinned.decoder, pinned.engine, MODEL], download.signal);
|
|
145
|
+
return reported({ installed: true, failure: null });
|
|
146
|
+
}
|
|
147
|
+
catch (error) {
|
|
148
|
+
await rm(directory(), { recursive: true, force: true });
|
|
149
|
+
return reported({ installed: false, failure: download.signal.aborted ? null : causeOf(error) });
|
|
103
150
|
}
|
|
104
151
|
finally {
|
|
105
|
-
|
|
152
|
+
downloading = null;
|
|
106
153
|
}
|
|
107
154
|
}
|
|
108
|
-
export
|
|
155
|
+
export function holdTranscription(transcribe) {
|
|
156
|
+
if (!transcribe)
|
|
157
|
+
downloading?.abort();
|
|
158
|
+
const settled = holding.then(() => settle(transcribe));
|
|
159
|
+
holding = settled.catch(() => undefined);
|
|
160
|
+
return settled;
|
|
161
|
+
}
|
|
162
|
+
export function transcriptionReport() {
|
|
163
|
+
return readiness;
|
|
164
|
+
}
|
|
165
|
+
async function transcribed(audio, parts, signal) {
|
|
166
|
+
const pinned = pinnedHere();
|
|
167
|
+
await mkdir(parts);
|
|
168
|
+
await failing(UNDECODABLE, executed(installed(pinned.decoder), ['-nostdin', '-hide_banner', '-loglevel', 'error', '-i', audio, '-ar', '16000', '-ac', '1', '-c:a', 'pcm_s16le',
|
|
169
|
+
'-f', 'segment', '-segment_time', String(CHUNK_SECONDS), join(parts, '%05d.wav')], signal));
|
|
170
|
+
const segments = (await readdir(parts)).sort().flatMap((part) => ['-f', join(parts, part)]);
|
|
171
|
+
const said = await failing(UNTRANSCRIBED, executed(installed(pinned.engine), ['-t', String(await threads()), '-np', '-m', installed(MODEL), ...segments], signal));
|
|
172
|
+
const text = said
|
|
173
|
+
.split('\n')
|
|
174
|
+
.map((line) => line.trim())
|
|
175
|
+
.filter((line) => line !== '')
|
|
176
|
+
.join(' ');
|
|
177
|
+
if (text === '')
|
|
178
|
+
throw new Error(UNTRANSCRIBED);
|
|
179
|
+
return text;
|
|
180
|
+
}
|
|
181
|
+
async function alone(work, signal) {
|
|
109
182
|
const before = held;
|
|
110
183
|
let release;
|
|
111
184
|
const mine = new Promise((resolve) => {
|
|
@@ -114,9 +187,24 @@ export async function transcribe(path, signal) {
|
|
|
114
187
|
held = Promise.all([before, mine]);
|
|
115
188
|
try {
|
|
116
189
|
await unlessAborted(before, signal);
|
|
117
|
-
return await
|
|
190
|
+
return await work();
|
|
118
191
|
}
|
|
119
192
|
finally {
|
|
120
193
|
release();
|
|
121
194
|
}
|
|
122
195
|
}
|
|
196
|
+
export async function transcribe(address, signal) {
|
|
197
|
+
ready();
|
|
198
|
+
const work = await mkdtemp(join(tmpdir(), 'kit-transcription-'));
|
|
199
|
+
try {
|
|
200
|
+
const audio = join(work, 'audio');
|
|
201
|
+
await failing(NOT_DOWNLOADED, downloaded(address, (url) => fetched(url, signal), audio, 'audio'));
|
|
202
|
+
return await alone(() => {
|
|
203
|
+
ready();
|
|
204
|
+
return transcribed(audio, join(work, 'parts'), signal);
|
|
205
|
+
}, signal);
|
|
206
|
+
}
|
|
207
|
+
finally {
|
|
208
|
+
await rm(work, { recursive: true, force: true });
|
|
209
|
+
}
|
|
210
|
+
}
|
package/dist/translate.js
CHANGED
|
@@ -3,14 +3,8 @@ function same(left, right) {
|
|
|
3
3
|
return JSON.stringify(left) === JSON.stringify(right);
|
|
4
4
|
}
|
|
5
5
|
function applied(document, changes) {
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
const result = apply(current, change);
|
|
9
|
-
if (result.outcome !== 'applied')
|
|
10
|
-
return null;
|
|
11
|
-
current = result.document;
|
|
12
|
-
}
|
|
13
|
-
return serialize(current);
|
|
6
|
+
const result = apply(document, changes);
|
|
7
|
+
return result.outcome === 'applied' ? serialize(result.document) : null;
|
|
14
8
|
}
|
|
15
9
|
function components(path, before, after, text) {
|
|
16
10
|
const edits = [];
|
package/dist/update.js
CHANGED
|
@@ -4,11 +4,12 @@ import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
|
|
|
4
4
|
import { homedir } from 'node:os';
|
|
5
5
|
import { join } from 'node:path';
|
|
6
6
|
import { run } from './clis.js';
|
|
7
|
-
import { kitHome } from './home.js';
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
7
|
+
import { kitHome, workspaceRoot } from './home.js';
|
|
8
|
+
import { service, throughSudo } from './placement.js';
|
|
9
|
+
import { relayed } from './relay.js';
|
|
10
|
+
const BOOTSTRAP_BYTES = 1_000_000;
|
|
11
|
+
// A bootstrap is at most a million bytes, so two minutes carry it over ten kilobytes a second and no stalled host holds the update queue.
|
|
12
|
+
const BOOTSTRAP_MS = 120_000;
|
|
12
13
|
function directory() {
|
|
13
14
|
return join(kitHome(), 'update');
|
|
14
15
|
}
|
|
@@ -18,10 +19,25 @@ function pending() {
|
|
|
18
19
|
function outcome() {
|
|
19
20
|
return join(directory(), 'outcome');
|
|
20
21
|
}
|
|
21
|
-
function unit(
|
|
22
|
-
return `house-kit-update-${
|
|
22
|
+
function unit(callId) {
|
|
23
|
+
return `house-kit-update-${callId}`;
|
|
24
|
+
}
|
|
25
|
+
function manager() {
|
|
26
|
+
return service() === 'user' ? ['--user'] : [];
|
|
27
|
+
}
|
|
28
|
+
function elevated() {
|
|
29
|
+
return throughSudo() ? ['sudo', '-n'] : [];
|
|
30
|
+
}
|
|
31
|
+
function account() {
|
|
32
|
+
return throughSudo() ? [`--uid=${process.getuid()}`, `--gid=${process.getgid()}`] : [];
|
|
33
|
+
}
|
|
34
|
+
function placement() {
|
|
35
|
+
return service() === 'user' ? ['--workspace', workspaceRoot()] : ['--linux'];
|
|
23
36
|
}
|
|
24
|
-
|
|
37
|
+
function record() {
|
|
38
|
+
return `outcome=$1; shift; bash "$0" "$@"; printf %s "$?" > "$outcome"; ${[...elevated(), 'systemctl', ...manager(), 'start', 'house-kit.service'].join(' ')}`;
|
|
39
|
+
}
|
|
40
|
+
async function pendingCall() {
|
|
25
41
|
try {
|
|
26
42
|
return JSON.parse(await readFile(pending(), 'utf8')).input_id;
|
|
27
43
|
}
|
|
@@ -35,83 +51,126 @@ async function recorded() {
|
|
|
35
51
|
return null;
|
|
36
52
|
return status.trim() === '0' ? {} : { refused: `the Kit bootstrap exited with ${status.trim()}` };
|
|
37
53
|
}
|
|
38
|
-
async function
|
|
54
|
+
async function forget(callId) {
|
|
55
|
+
if ((await pendingCall()) !== callId)
|
|
56
|
+
return;
|
|
57
|
+
await rm(pending(), { force: true });
|
|
58
|
+
await rm(outcome(), { force: true });
|
|
59
|
+
}
|
|
60
|
+
async function finished(callId) {
|
|
39
61
|
for (;;) {
|
|
40
|
-
const
|
|
41
|
-
if (
|
|
42
|
-
return
|
|
43
|
-
|
|
62
|
+
const result = await recorded();
|
|
63
|
+
if (result !== null)
|
|
64
|
+
return result;
|
|
65
|
+
// systemctl answers at once, so ten seconds only bounds a stuck service manager.
|
|
66
|
+
if ((await run('systemctl', [...manager(), 'is-active', '--quiet', unit(callId)], 10_000)).status !== 0) {
|
|
44
67
|
return (await recorded()) ?? { refused: 'the Kit bootstrap did not finish' };
|
|
45
68
|
}
|
|
69
|
+
// The bootstrap runs for minutes, so checking each second sees its outcome within a second at little cost.
|
|
46
70
|
await new Promise((resolve) => setTimeout(resolve, 1000));
|
|
47
71
|
}
|
|
48
72
|
}
|
|
49
|
-
function
|
|
73
|
+
async function bounded(body, most) {
|
|
74
|
+
const chunks = [];
|
|
75
|
+
let bytes = 0;
|
|
76
|
+
for await (const chunk of body ?? []) {
|
|
77
|
+
bytes += chunk.length;
|
|
78
|
+
if (bytes > most)
|
|
79
|
+
return null;
|
|
80
|
+
chunks.push(chunk);
|
|
81
|
+
}
|
|
82
|
+
return Buffer.concat(chunks, bytes);
|
|
83
|
+
}
|
|
84
|
+
function rerun(script, callId, flags) {
|
|
50
85
|
return new Promise((resolve) => {
|
|
51
|
-
const
|
|
86
|
+
const [command, ...args] = [
|
|
87
|
+
...elevated(),
|
|
88
|
+
'systemd-run',
|
|
89
|
+
...manager(),
|
|
90
|
+
...account(),
|
|
52
91
|
'--wait',
|
|
53
92
|
'--collect',
|
|
54
93
|
'--quiet',
|
|
55
|
-
`--unit=${unit(
|
|
94
|
+
`--unit=${unit(callId)}`,
|
|
56
95
|
`--setenv=HOME=${homedir()}`,
|
|
96
|
+
`--setenv=HOUSE_KIT_HOME=${kitHome()}`,
|
|
57
97
|
'/bin/sh',
|
|
58
98
|
'-c',
|
|
59
|
-
|
|
99
|
+
record(),
|
|
60
100
|
script,
|
|
61
101
|
outcome(),
|
|
102
|
+
...placement(),
|
|
62
103
|
...flags,
|
|
63
|
-
]
|
|
64
|
-
child
|
|
104
|
+
];
|
|
105
|
+
const child = spawn(command, args, { stdio: ['ignore', 'ignore', 'inherit'] });
|
|
106
|
+
child.on('error', () => resolve({ refused: 'no service manager runs this Kit process' }));
|
|
65
107
|
child.on('close', () => resolve(null));
|
|
66
108
|
});
|
|
67
109
|
}
|
|
68
|
-
export class
|
|
69
|
-
|
|
70
|
-
|
|
110
|
+
export class KitUpdate {
|
|
111
|
+
calls;
|
|
112
|
+
changed;
|
|
113
|
+
waiting = new Map();
|
|
71
114
|
queue = Promise.resolve();
|
|
72
|
-
constructor(
|
|
73
|
-
this.
|
|
115
|
+
constructor(calls, changed) {
|
|
116
|
+
this.calls = calls;
|
|
117
|
+
this.changed = changed;
|
|
74
118
|
}
|
|
75
119
|
async resumed() {
|
|
76
|
-
const
|
|
77
|
-
if (
|
|
120
|
+
const callId = await pendingCall();
|
|
121
|
+
if (callId === null)
|
|
78
122
|
return;
|
|
79
|
-
await this.
|
|
123
|
+
await this.enqueue(callId, () => finished(callId));
|
|
80
124
|
}
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
125
|
+
hold(call) {
|
|
126
|
+
this.waiting.set(call.input_id, call);
|
|
127
|
+
this.changed();
|
|
128
|
+
}
|
|
129
|
+
held() {
|
|
130
|
+
return this.waiting.size > 0;
|
|
131
|
+
}
|
|
132
|
+
apply(resume) {
|
|
133
|
+
const held = [...this.waiting.values()];
|
|
134
|
+
this.waiting.clear();
|
|
135
|
+
void Promise.all(held.map((call) => this.enqueue(call.input_id, () => this.carry(call)))).then(resume);
|
|
90
136
|
}
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
137
|
+
enqueue(callId, work) {
|
|
138
|
+
const before = this.queue;
|
|
139
|
+
const carried = this.calls.carry(callId, async () => {
|
|
140
|
+
await before;
|
|
141
|
+
return { result: await work(), returned: () => forget(callId) };
|
|
142
|
+
});
|
|
143
|
+
this.queue = before.then(() => carried);
|
|
144
|
+
return carried;
|
|
145
|
+
}
|
|
146
|
+
async carry(call) {
|
|
147
|
+
if ((await pendingCall()) === call.input_id)
|
|
148
|
+
return finished(call.input_id);
|
|
149
|
+
const deadline = AbortSignal.timeout(BOOTSTRAP_MS);
|
|
150
|
+
let script;
|
|
151
|
+
try {
|
|
152
|
+
const answer = await fetch(relayed(call.bootstrap), { signal: deadline });
|
|
153
|
+
if (!answer.ok)
|
|
154
|
+
return { refused: `the Kit bootstrap could not be downloaded: ${answer.status}` };
|
|
155
|
+
script = await bounded(answer.body, BOOTSTRAP_BYTES);
|
|
156
|
+
}
|
|
157
|
+
catch (error) {
|
|
158
|
+
if (!deadline.aborted)
|
|
159
|
+
throw error;
|
|
160
|
+
return { refused: `the Kit bootstrap did not arrive within ${BOOTSTRAP_MS / 1000} seconds` };
|
|
161
|
+
}
|
|
162
|
+
if (script === null)
|
|
163
|
+
return { refused: `the Kit bootstrap is larger than ${BOOTSTRAP_BYTES} bytes` };
|
|
164
|
+
if (createHash('sha256').update(script).digest('hex') !== call.sha256) {
|
|
99
165
|
return { refused: 'the Kit bootstrap does not match its sha256' };
|
|
100
166
|
}
|
|
101
167
|
await mkdir(directory(), { recursive: true, mode: 0o700 });
|
|
102
168
|
const path = join(directory(), 'connect-linux.sh');
|
|
103
169
|
await writeFile(path, script, { mode: 0o700 });
|
|
104
170
|
await rm(outcome(), { force: true });
|
|
105
|
-
await writeFile(pending(), `${JSON.stringify({ input_id:
|
|
106
|
-
return (await rerun(path,
|
|
171
|
+
await writeFile(pending(), `${JSON.stringify({ input_id: call.input_id })}\n`, { mode: 0o600 });
|
|
172
|
+
return (await rerun(path, call.input_id, call.update_clis ? ['--update-clis'] : [])) ?? (await recorded()) ?? {
|
|
107
173
|
refused: 'the Kit bootstrap did not finish',
|
|
108
174
|
};
|
|
109
175
|
}
|
|
110
|
-
async acknowledge(inputId, ack) {
|
|
111
|
-
await this.house.deliver(`/kit/inputs/${inputId}/ack`, ack);
|
|
112
|
-
if ((await pendingInput()) !== inputId)
|
|
113
|
-
return;
|
|
114
|
-
await rm(pending(), { force: true });
|
|
115
|
-
await rm(outcome(), { force: true });
|
|
116
|
-
}
|
|
117
176
|
}
|