@kuador-npm/runner 0.1.2 → 0.1.4
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/package.json +1 -1
- package/src/api.js +4 -1
- package/src/daemon.js +56 -11
- package/src/sessions.js +54 -0
- package/src/tools.js +42 -7
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kuador-npm/runner",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.4",
|
|
4
4
|
"description": "Deja trabajando a los agentes del tablero de Kuador en tu máquina (Mac, Linux o Windows), con tu propio cliente de IA.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": { "kuador-runner": "bin/kuador-runner.js" },
|
package/src/api.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/** Cliente de la API del tablero (rutas del runner). */
|
|
2
|
-
export const VERSION = "0.1.
|
|
2
|
+
export const VERSION = "0.1.4";
|
|
3
3
|
|
|
4
4
|
export class ApiError extends Error {
|
|
5
5
|
constructor(status, message) {
|
|
@@ -43,6 +43,9 @@ export function api(server, token) {
|
|
|
43
43
|
setup: () => call("GET", "/api/runner/setup").then((r) => r.body),
|
|
44
44
|
heartbeat: (body) => call("PUT", "/api/runner/heartbeat", body).then((r) => r.body),
|
|
45
45
|
claim: (machineId) => call("POST", "/api/runner/claim", { machineId }).then((r) => (r.status === 204 ? null : r.body)),
|
|
46
|
+
claimJob: (machineId) => call("POST", "/api/runner/jobs/claim", { machineId }).then((r) => (r.status === 204 ? null : r.body)),
|
|
47
|
+
completeJob: (machineId, id, text, error) =>
|
|
48
|
+
call("POST", `/api/runner/jobs/${encodeURIComponent(id)}/complete`, { machineId, text: text?.slice(0, 200_000), error: error?.slice(0, 480) }),
|
|
46
49
|
renew: (machineId, key) => call("POST", `/api/runner/leases/${encodeURIComponent(key)}/renew`, { machineId }, { allow: [409] }).then((r) => r.status === 200),
|
|
47
50
|
release: (machineId, key, outcome, message) =>
|
|
48
51
|
call("POST", `/api/runner/leases/${encodeURIComponent(key)}/release`, { machineId, outcome, message: message?.slice(0, 480) }),
|
package/src/daemon.js
CHANGED
|
@@ -1,11 +1,12 @@
|
|
|
1
|
-
import { appendFileSync, createWriteStream, existsSync, rmSync } from "node:fs";
|
|
1
|
+
import { appendFileSync, createWriteStream, existsSync, mkdirSync, rmSync } from "node:fs";
|
|
2
2
|
import { join } from "node:path";
|
|
3
3
|
|
|
4
4
|
import { api, VERSION } from "./api.js";
|
|
5
|
-
import { ensureDirs, LOGS, PAUSE, requireConfig, save, SECRETS, writeState } from "./config.js";
|
|
5
|
+
import { ensureDirs, LOGS, PAUSE, requireConfig, save, SECRETS, WORK, writeState } from "./config.js";
|
|
6
6
|
import { keepAwake, osName } from "./service.js";
|
|
7
|
-
import {
|
|
8
|
-
import {
|
|
7
|
+
import { forget, remember, resumable } from "./sessions.js";
|
|
8
|
+
import { ask, launch, outcome } from "./tools.js";
|
|
9
|
+
import { cleanup, isRepo, prepare } from "./workdir.js";
|
|
9
10
|
|
|
10
11
|
const HEARTBEAT_MS = 30_000;
|
|
11
12
|
const RENEW_MS = 60_000;
|
|
@@ -81,10 +82,35 @@ export async function start() {
|
|
|
81
82
|
timer = setTimeout(pump, 2000 + jobs.size * 3000);
|
|
82
83
|
};
|
|
83
84
|
|
|
85
|
+
/** Los trabajos de texto de la persona (redactar «en mi computador»): rápidos y primero, la web los está esperando. */
|
|
86
|
+
const jobsLoop = async () => {
|
|
87
|
+
for (;;) {
|
|
88
|
+
if (stopping || machine.paused || existsSync(PAUSE) || Date.now() < pausedUntil) return;
|
|
89
|
+
const job = await client.claimJob(config.machineId);
|
|
90
|
+
if (!job) return;
|
|
91
|
+
// Reconocer un proyecto que ya existe: Claude Code lo recorre (solo leyendo) en la carpeta del repo de esta máquina.
|
|
92
|
+
const recognize = job.step === "RECOGNIZE";
|
|
93
|
+
const repo = recognize ? config.repos?.[job.projectKey] : null;
|
|
94
|
+
if (recognize && !(repo && isRepo(repo))) {
|
|
95
|
+
const error = `Esta máquina no tiene la carpeta del repo de ${job.projectKey}. Vincúlala con: kuador-runner link ${job.projectKey} <carpeta del repo>`;
|
|
96
|
+
await client.completeJob(config.machineId, job.id, null, error).catch(() => {});
|
|
97
|
+
log(`Reconocer ${job.projectKey}: falta la carpeta del repo (kuador-runner link ${job.projectKey} <carpeta>)`);
|
|
98
|
+
continue;
|
|
99
|
+
}
|
|
100
|
+
const dir = repo ?? join(WORK, "_textos");
|
|
101
|
+
mkdirSync(dir, { recursive: true });
|
|
102
|
+
log(recognize ? `Reconociendo el proyecto ${job.projectKey} en ${repo} (solo lectura)…` : `Trabajo de texto (${job.step}) para el tablero…`);
|
|
103
|
+
const r = await ask(job.system, job.user, dir, { readOnlyRepo: recognize });
|
|
104
|
+
await client.completeJob(config.machineId, job.id, r.text, r.error).catch((e) => log(`No se pudo entregar el trabajo de texto: ${e.message}`));
|
|
105
|
+
log(r.error ? `Trabajo de texto: falló · ${r.error.slice(0, 160)}` : "Trabajo de texto: listo");
|
|
106
|
+
}
|
|
107
|
+
};
|
|
108
|
+
|
|
84
109
|
const pump = async () => {
|
|
85
110
|
if (pumping) return;
|
|
86
111
|
pumping = true;
|
|
87
112
|
try {
|
|
113
|
+
await jobsLoop().catch((e) => log(`No se pudo pedir un trabajo de texto: ${e.message}`));
|
|
88
114
|
while (canTake()) {
|
|
89
115
|
const claim = await client.claim(config.machineId);
|
|
90
116
|
if (!claim) break;
|
|
@@ -109,12 +135,28 @@ export async function start() {
|
|
|
109
135
|
}
|
|
110
136
|
const logFile = join(LOGS, `${claim.issueKey}-${started.replace(/[:.]/g, "-")}.log`);
|
|
111
137
|
const stream = createWriteStream(logFile);
|
|
112
|
-
|
|
113
|
-
const
|
|
114
|
-
|
|
138
|
+
// Si esta máquina ya trabajó la tarjeta con este rol, se retoma esa conversación (ahorra releer todo).
|
|
139
|
+
const resumeId = resumable(claim, work.dir);
|
|
140
|
+
log(`${claim.issueKey} → ${claim.agentName} (${claim.roleName}) en ${work.dir}${work.repo ? " (copia del repo)" : ""}${resumeId ? " · retoma su conversación" : ""}`);
|
|
141
|
+
const job = { claim, started, child: null, lost: false, timedOut: false };
|
|
142
|
+
const start = (id) => {
|
|
143
|
+
const launched = launch(config, claim, work.dir, stream, id);
|
|
144
|
+
job.child = launched.child;
|
|
145
|
+
if (config.keepAwake !== false) keepAwake(launched.child.pid);
|
|
146
|
+
return launched.done;
|
|
147
|
+
};
|
|
148
|
+
let done = start(resumeId);
|
|
149
|
+
if (resumeId) {
|
|
150
|
+
// Si la conversación ya no existe en Claude Code, se arranca de cero una sola vez.
|
|
151
|
+
done = done.then((result) => {
|
|
152
|
+
if (outcome(result).outcome !== "RESUME_MISSING") return result;
|
|
153
|
+
forget(claim);
|
|
154
|
+
log(`${claim.issueKey}: la conversación anterior ya no existe; empieza de cero.`);
|
|
155
|
+
return start(null);
|
|
156
|
+
});
|
|
157
|
+
}
|
|
115
158
|
jobs.set(claim.issueKey, job);
|
|
116
159
|
state();
|
|
117
|
-
if (config.keepAwake !== false) keepAwake(child.pid);
|
|
118
160
|
|
|
119
161
|
const renew = setInterval(async () => {
|
|
120
162
|
try {
|
|
@@ -122,7 +164,7 @@ export async function start() {
|
|
|
122
164
|
// La tarjeta ya no es de esta máquina (la movieron o la tomó otra): se corta.
|
|
123
165
|
job.lost = true;
|
|
124
166
|
log(`${claim.issueKey}: el préstamo ya no es de esta máquina; se detiene.`);
|
|
125
|
-
child
|
|
167
|
+
job.child?.kill();
|
|
126
168
|
}
|
|
127
169
|
} catch (e) {
|
|
128
170
|
log(`${claim.issueKey}: no se pudo renovar (${e.message}); se reintenta.`);
|
|
@@ -131,7 +173,7 @@ export async function start() {
|
|
|
131
173
|
const limit = setTimeout(() => {
|
|
132
174
|
job.timedOut = true;
|
|
133
175
|
log(`${claim.issueKey}: pasó el tiempo máximo (${config.timeoutMinutes ?? 60} min); se detiene.`);
|
|
134
|
-
child
|
|
176
|
+
job.child?.kill();
|
|
135
177
|
}, (config.timeoutMinutes ?? 60) * 60_000);
|
|
136
178
|
|
|
137
179
|
done.then(async (result) => {
|
|
@@ -142,6 +184,9 @@ export async function start() {
|
|
|
142
184
|
jobs.delete(claim.issueKey);
|
|
143
185
|
if (!job.lost && !stopping) {
|
|
144
186
|
const r = job.timedOut ? { outcome: "TIMEOUT", message: `Pasó el tiempo máximo de ${config.timeoutMinutes ?? 60} minutos.` } : outcome(result);
|
|
187
|
+
// La conversación queda para la próxima vuelta de esta tarjeta con este rol.
|
|
188
|
+
if (r.sessionId) remember(claim, work.dir, r.sessionId);
|
|
189
|
+
if (r.outcome === "RESUME_MISSING") r.outcome = "FAILED";
|
|
145
190
|
if (r.outcome === "RATE_LIMITED") {
|
|
146
191
|
pausedUntil = r.resumeAt.getTime();
|
|
147
192
|
log(`La suscripción llegó a su límite: pausa hasta ${r.resumeAt.toLocaleString()}.`);
|
|
@@ -180,7 +225,7 @@ export async function start() {
|
|
|
180
225
|
log("Deteniendo: se liberan las tarjetas en curso.");
|
|
181
226
|
await Promise.all(
|
|
182
227
|
[...jobs.values()].map(async (j) => {
|
|
183
|
-
j.child
|
|
228
|
+
j.child?.kill();
|
|
184
229
|
await client.release(config.machineId, j.claim.issueKey, "CANCELLED", "Se detuvo el runner.").catch(() => {});
|
|
185
230
|
}),
|
|
186
231
|
);
|
package/src/sessions.js
ADDED
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import { existsSync, readFileSync, writeFileSync } from "node:fs";
|
|
2
|
+
import { join } from "node:path";
|
|
3
|
+
|
|
4
|
+
import { HOME } from "./config.js";
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Las conversaciones de Claude Code por tarjeta y rol, en esta máquina. Si la tarjeta vuelve al mismo rol (QA la
|
|
8
|
+
* devolvió, una persona pidió cambios), se retoma esa conversación: el agente ya tiene el contexto y solo mira lo nuevo.
|
|
9
|
+
* Claude Code guarda cada sesión por carpeta, así que solo se retoma en la misma carpeta de trabajo.
|
|
10
|
+
*/
|
|
11
|
+
const FILE = () => join(HOME, "sessions.json");
|
|
12
|
+
const MAX_AGE_MS = 7 * 24 * 3600_000;
|
|
13
|
+
|
|
14
|
+
const key = (claim) => `${claim.issueKey}|${claim.role}`;
|
|
15
|
+
|
|
16
|
+
function readAll() {
|
|
17
|
+
try {
|
|
18
|
+
return JSON.parse(readFileSync(FILE(), "utf8"));
|
|
19
|
+
} catch {
|
|
20
|
+
return {};
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/** La sesión para retomar (si existe, es reciente y su carpeta sigue ahí), o null. */
|
|
25
|
+
export function resumable(claim, cwd) {
|
|
26
|
+
const s = readAll()[key(claim)];
|
|
27
|
+
if (!s?.id || s.cwd !== cwd || !existsSync(cwd)) return null;
|
|
28
|
+
if (Date.now() - new Date(s.at).getTime() > MAX_AGE_MS) return null;
|
|
29
|
+
return s.id;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
export function remember(claim, cwd, id) {
|
|
33
|
+
if (!id) return;
|
|
34
|
+
const all = readAll();
|
|
35
|
+
all[key(claim)] = { id, cwd, at: new Date().toISOString() };
|
|
36
|
+
// Sin crecer para siempre: se quedan las de la última semana.
|
|
37
|
+
for (const [k, v] of Object.entries(all)) if (Date.now() - new Date(v.at).getTime() > MAX_AGE_MS) delete all[k];
|
|
38
|
+
try {
|
|
39
|
+
writeFileSync(FILE(), JSON.stringify(all, null, 2), { mode: 0o600 });
|
|
40
|
+
} catch {
|
|
41
|
+
// Sin archivo: la próxima vuelta empieza de cero, como antes.
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
export function forget(claim) {
|
|
46
|
+
const all = readAll();
|
|
47
|
+
if (!(key(claim) in all)) return;
|
|
48
|
+
delete all[key(claim)];
|
|
49
|
+
try {
|
|
50
|
+
writeFileSync(FILE(), JSON.stringify(all, null, 2), { mode: 0o600 });
|
|
51
|
+
} catch {
|
|
52
|
+
// Nada que hacer.
|
|
53
|
+
}
|
|
54
|
+
}
|
package/src/tools.js
CHANGED
|
@@ -24,19 +24,22 @@ const claudeModel = (model) => (model && /^(claude-|opus|sonnet|haiku|fable)/i.t
|
|
|
24
24
|
const EFFORTS = ["low", "medium", "high", "xhigh", "max"];
|
|
25
25
|
|
|
26
26
|
/**
|
|
27
|
-
* Lanza el cliente de IA con la tarjeta.
|
|
28
|
-
*
|
|
27
|
+
* Lanza el cliente de IA con la tarjeta. Le da la credencial de esta ejecución (solo esta tarjeta, solo este rol, solo
|
|
28
|
+
* mientras dure el préstamo), nunca la conexión larga de la máquina; va en un archivo fuera de la carpeta de trabajo
|
|
29
|
+
* (nunca dentro del repo) y solo legible por ti. Devuelve el proceso y una promesa con el resultado.
|
|
29
30
|
*/
|
|
30
|
-
export function launch(config, claim, cwd, logStream) {
|
|
31
|
+
export function launch(config, claim, cwd, logStream, resumeId = null) {
|
|
31
32
|
const mcpFile = join(SECRETS, `${claim.issueKey}.json`);
|
|
32
33
|
writeFileSync(
|
|
33
34
|
mcpFile,
|
|
34
|
-
JSON.stringify({ mcpServers: { [claim.mcpServer]: { type: "http", url: claim.mcpUrl, headers: { Authorization: `Bearer ${config.token}` } } } }),
|
|
35
|
+
JSON.stringify({ mcpServers: { [claim.mcpServer]: { type: "http", url: claim.mcpUrl, headers: { Authorization: `Bearer ${claim.runToken ?? config.token}` } } } }),
|
|
35
36
|
{ mode: 0o600 },
|
|
36
37
|
);
|
|
38
|
+
// Al retomar, la conversación ya tiene el contexto: el pedido es solo lo nuevo (lo arma el tablero).
|
|
37
39
|
const args = [
|
|
40
|
+
...(resumeId ? ["--resume", resumeId] : []),
|
|
38
41
|
"-p",
|
|
39
|
-
claim.prompt,
|
|
42
|
+
resumeId && claim.resumePrompt ? claim.resumePrompt : claim.prompt,
|
|
40
43
|
"--mcp-config",
|
|
41
44
|
mcpFile,
|
|
42
45
|
"--strict-mcp-config",
|
|
@@ -69,6 +72,35 @@ export function launch(config, claim, cwd, logStream) {
|
|
|
69
72
|
return { child, done };
|
|
70
73
|
}
|
|
71
74
|
|
|
75
|
+
/**
|
|
76
|
+
* Un pedido de texto del tablero (p. ej. redactar los documentos base «en mi computador»): sin servidores MCP ni
|
|
77
|
+
* herramientas que cambien algo, en una carpeta vacía. Con {@code readOnlyRepo} (reconocer un proyecto existente),
|
|
78
|
+
* en la carpeta del repo y solo con las herramientas de lectura. Devuelve el texto de la respuesta.
|
|
79
|
+
*/
|
|
80
|
+
export function ask(system, user, cwd, { readOnlyRepo = false } = {}) {
|
|
81
|
+
const args = ["-p", user, "--append-system-prompt", system, "--output-format", "json", "--strict-mcp-config",
|
|
82
|
+
"--disallowedTools", "Bash,Edit,Write,MultiEdit,NotebookEdit,WebFetch,WebSearch"];
|
|
83
|
+
if (readOnlyRepo) args.push("--allowedTools", "Read,Grep,Glob,LS");
|
|
84
|
+
const child = spawn(TOOLS.claude.command, args, { cwd, shell: WINDOWS, windowsHide: true });
|
|
85
|
+
let out = "";
|
|
86
|
+
let err = "";
|
|
87
|
+
child.stdout.on("data", (d) => (out += d));
|
|
88
|
+
child.stderr.on("data", (d) => (err += d));
|
|
89
|
+
return new Promise((resolve) => {
|
|
90
|
+
child.on("error", (e) => resolve({ text: null, error: String(e) }));
|
|
91
|
+
child.on("close", (code) => {
|
|
92
|
+
let result = null;
|
|
93
|
+
try {
|
|
94
|
+
result = JSON.parse(out.trim().split("\n").filter(Boolean).pop() ?? "");
|
|
95
|
+
} catch {
|
|
96
|
+
// Sin JSON: se informa el error.
|
|
97
|
+
}
|
|
98
|
+
if (code === 0 && result && !result.is_error) resolve({ text: String(result.result ?? ""), error: null });
|
|
99
|
+
else resolve({ text: null, error: `Claude Code: ${(result?.result || err || out || `salió con código ${code}`).toString().trim().slice(-400)}` });
|
|
100
|
+
});
|
|
101
|
+
});
|
|
102
|
+
}
|
|
103
|
+
|
|
72
104
|
/** Interpreta lo que devolvió Claude Code: terminó bien, falló o llegó al límite de la suscripción. */
|
|
73
105
|
export function outcome({ code, out, err }) {
|
|
74
106
|
const text = `${out}\n${err}`;
|
|
@@ -81,9 +113,12 @@ export function outcome({ code, out, err }) {
|
|
|
81
113
|
if (/usage limit|rate.?limit|limit reached|quota|5-hour limit|weekly limit/i.test(text) && (code !== 0 || result?.is_error)) {
|
|
82
114
|
return { outcome: "RATE_LIMITED", message: "La suscripción de IA llegó a su límite de uso.", resumeAt: resetTime(text) };
|
|
83
115
|
}
|
|
84
|
-
|
|
116
|
+
const sessionId = typeof result?.session_id === "string" ? result.session_id : null;
|
|
117
|
+
// La sesión para retomar ya no existe (se borró o venció en Claude Code): se reintenta de cero, no es un fallo.
|
|
118
|
+
if (code !== 0 && /no conversation found|session.*not found|could not find session/i.test(text)) return { outcome: "RESUME_MISSING", sessionId };
|
|
119
|
+
if (code === 0 && !result?.is_error) return { outcome: "DONE", message: String(result?.result ?? "").slice(0, 300), usage: result?.usage, sessionId };
|
|
85
120
|
const why = (result?.result || err || out || `salió con código ${code}`).toString().trim().split("\n").slice(-3).join(" ");
|
|
86
|
-
return { outcome: "FAILED", message: `Claude Code: ${why}`.slice(0, 480) };
|
|
121
|
+
return { outcome: "FAILED", message: `Claude Code: ${why}`.slice(0, 480), sessionId };
|
|
87
122
|
}
|
|
88
123
|
|
|
89
124
|
/** Si el mensaje dice cuándo se renueva el límite; si no, en 30 minutos se vuelve a intentar. */
|