@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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kuador-npm/runner",
3
- "version": "0.1.2",
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";
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 { launch, outcome } from "./tools.js";
8
- import { cleanup, prepare } from "./workdir.js";
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
- 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 };
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.kill();
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.kill();
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.kill();
228
+ j.child?.kill();
184
229
  await client.release(config.machineId, j.claim.issueKey, "CANCELLED", "Se detuvo el runner.").catch(() => {});
185
230
  }),
186
231
  );
@@ -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",
@@ -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
- if (code === 0 && !result?.is_error) return { outcome: "DONE", message: String(result?.result ?? "").slice(0, 300), usage: result?.usage };
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. */