@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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kuador-npm/runner",
3
- "version": "0.1.0",
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
@@ -1,5 +1,5 @@
1
1
  /** Cliente de la API del tablero (rutas del runner). */
2
- export const VERSION = "0.1.0";
2
+ export const VERSION = "0.1.3";
3
3
 
4
4
  export class ApiError extends Error {
5
5
  constructor(status, message) {
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
- log(`${claim.issueKey} → ${claim.agentName} (${claim.roleName}) en ${work.dir}${work.repo ? " (copia del repo)" : ""}`);
113
- const { child, done } = launch(config, claim, work.dir, stream);
114
- const job = { claim, started, child, lost: false, timedOut: false };
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.kill();
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.kill();
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.kill();
203
+ j.child?.kill();
184
204
  await client.release(config.machineId, j.claim.issueKey, "CANCELLED", "Se detuvo el runner.").catch(() => {});
185
205
  }),
186
206
  );
@@ -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. La conexión al tablero va en un archivo fuera de la carpeta de trabajo (nunca
28
- * dentro del repo) y solo legible por ti. Devuelve el proceso y una promesa con el resultado.
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
- if (code === 0 && !result?.is_error) return { outcome: "DONE", message: String(result?.result ?? "").slice(0, 300), usage: result?.usage };
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. */