@kuador-npm/runner 0.1.0 → 0.1.3
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 +1 -1
- package/src/daemon.js +27 -7
- package/src/sessions.js +54 -0
- package/src/tools.js +13 -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.3",
|
|
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
package/src/daemon.js
CHANGED
|
@@ -4,6 +4,7 @@ import { join } from "node:path";
|
|
|
4
4
|
import { api, VERSION } from "./api.js";
|
|
5
5
|
import { ensureDirs, LOGS, PAUSE, requireConfig, save, SECRETS, writeState } from "./config.js";
|
|
6
6
|
import { keepAwake, osName } from "./service.js";
|
|
7
|
+
import { forget, remember, resumable } from "./sessions.js";
|
|
7
8
|
import { launch, outcome } from "./tools.js";
|
|
8
9
|
import { cleanup, prepare } from "./workdir.js";
|
|
9
10
|
|
|
@@ -109,12 +110,28 @@ export async function start() {
|
|
|
109
110
|
}
|
|
110
111
|
const logFile = join(LOGS, `${claim.issueKey}-${started.replace(/[:.]/g, "-")}.log`);
|
|
111
112
|
const stream = createWriteStream(logFile);
|
|
112
|
-
|
|
113
|
-
const
|
|
114
|
-
|
|
113
|
+
// Si esta máquina ya trabajó la tarjeta con este rol, se retoma esa conversación (ahorra releer todo).
|
|
114
|
+
const resumeId = resumable(claim, work.dir);
|
|
115
|
+
log(`${claim.issueKey} → ${claim.agentName} (${claim.roleName}) en ${work.dir}${work.repo ? " (copia del repo)" : ""}${resumeId ? " · retoma su conversación" : ""}`);
|
|
116
|
+
const job = { claim, started, child: null, lost: false, timedOut: false };
|
|
117
|
+
const start = (id) => {
|
|
118
|
+
const launched = launch(config, claim, work.dir, stream, id);
|
|
119
|
+
job.child = launched.child;
|
|
120
|
+
if (config.keepAwake !== false) keepAwake(launched.child.pid);
|
|
121
|
+
return launched.done;
|
|
122
|
+
};
|
|
123
|
+
let done = start(resumeId);
|
|
124
|
+
if (resumeId) {
|
|
125
|
+
// Si la conversación ya no existe en Claude Code, se arranca de cero una sola vez.
|
|
126
|
+
done = done.then((result) => {
|
|
127
|
+
if (outcome(result).outcome !== "RESUME_MISSING") return result;
|
|
128
|
+
forget(claim);
|
|
129
|
+
log(`${claim.issueKey}: la conversación anterior ya no existe; empieza de cero.`);
|
|
130
|
+
return start(null);
|
|
131
|
+
});
|
|
132
|
+
}
|
|
115
133
|
jobs.set(claim.issueKey, job);
|
|
116
134
|
state();
|
|
117
|
-
if (config.keepAwake !== false) keepAwake(child.pid);
|
|
118
135
|
|
|
119
136
|
const renew = setInterval(async () => {
|
|
120
137
|
try {
|
|
@@ -122,7 +139,7 @@ export async function start() {
|
|
|
122
139
|
// La tarjeta ya no es de esta máquina (la movieron o la tomó otra): se corta.
|
|
123
140
|
job.lost = true;
|
|
124
141
|
log(`${claim.issueKey}: el préstamo ya no es de esta máquina; se detiene.`);
|
|
125
|
-
child
|
|
142
|
+
job.child?.kill();
|
|
126
143
|
}
|
|
127
144
|
} catch (e) {
|
|
128
145
|
log(`${claim.issueKey}: no se pudo renovar (${e.message}); se reintenta.`);
|
|
@@ -131,7 +148,7 @@ export async function start() {
|
|
|
131
148
|
const limit = setTimeout(() => {
|
|
132
149
|
job.timedOut = true;
|
|
133
150
|
log(`${claim.issueKey}: pasó el tiempo máximo (${config.timeoutMinutes ?? 60} min); se detiene.`);
|
|
134
|
-
child
|
|
151
|
+
job.child?.kill();
|
|
135
152
|
}, (config.timeoutMinutes ?? 60) * 60_000);
|
|
136
153
|
|
|
137
154
|
done.then(async (result) => {
|
|
@@ -142,6 +159,9 @@ export async function start() {
|
|
|
142
159
|
jobs.delete(claim.issueKey);
|
|
143
160
|
if (!job.lost && !stopping) {
|
|
144
161
|
const r = job.timedOut ? { outcome: "TIMEOUT", message: `Pasó el tiempo máximo de ${config.timeoutMinutes ?? 60} minutos.` } : outcome(result);
|
|
162
|
+
// La conversación queda para la próxima vuelta de esta tarjeta con este rol.
|
|
163
|
+
if (r.sessionId) remember(claim, work.dir, r.sessionId);
|
|
164
|
+
if (r.outcome === "RESUME_MISSING") r.outcome = "FAILED";
|
|
145
165
|
if (r.outcome === "RATE_LIMITED") {
|
|
146
166
|
pausedUntil = r.resumeAt.getTime();
|
|
147
167
|
log(`La suscripción llegó a su límite: pausa hasta ${r.resumeAt.toLocaleString()}.`);
|
|
@@ -180,7 +200,7 @@ export async function start() {
|
|
|
180
200
|
log("Deteniendo: se liberan las tarjetas en curso.");
|
|
181
201
|
await Promise.all(
|
|
182
202
|
[...jobs.values()].map(async (j) => {
|
|
183
|
-
j.child
|
|
203
|
+
j.child?.kill();
|
|
184
204
|
await client.release(config.machineId, j.claim.issueKey, "CANCELLED", "Se detuvo el runner.").catch(() => {});
|
|
185
205
|
}),
|
|
186
206
|
);
|
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",
|
|
@@ -81,9 +84,12 @@ export function outcome({ code, out, err }) {
|
|
|
81
84
|
if (/usage limit|rate.?limit|limit reached|quota|5-hour limit|weekly limit/i.test(text) && (code !== 0 || result?.is_error)) {
|
|
82
85
|
return { outcome: "RATE_LIMITED", message: "La suscripción de IA llegó a su límite de uso.", resumeAt: resetTime(text) };
|
|
83
86
|
}
|
|
84
|
-
|
|
87
|
+
const sessionId = typeof result?.session_id === "string" ? result.session_id : null;
|
|
88
|
+
// La sesión para retomar ya no existe (se borró o venció en Claude Code): se reintenta de cero, no es un fallo.
|
|
89
|
+
if (code !== 0 && /no conversation found|session.*not found|could not find session/i.test(text)) return { outcome: "RESUME_MISSING", sessionId };
|
|
90
|
+
if (code === 0 && !result?.is_error) return { outcome: "DONE", message: String(result?.result ?? "").slice(0, 300), usage: result?.usage, sessionId };
|
|
85
91
|
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) };
|
|
92
|
+
return { outcome: "FAILED", message: `Claude Code: ${why}`.slice(0, 480), sessionId };
|
|
87
93
|
}
|
|
88
94
|
|
|
89
95
|
/** Si el mensaje dice cuándo se renueva el límite; si no, en 30 minutos se vuelve a intentar. */
|