@kuador-npm/runner 0.1.3 → 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.3",
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.3";
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,12 +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
7
  import { forget, remember, resumable } from "./sessions.js";
8
- import { launch, outcome } from "./tools.js";
9
- import { cleanup, prepare } from "./workdir.js";
8
+ import { ask, launch, outcome } from "./tools.js";
9
+ import { cleanup, isRepo, prepare } from "./workdir.js";
10
10
 
11
11
  const HEARTBEAT_MS = 30_000;
12
12
  const RENEW_MS = 60_000;
@@ -82,10 +82,35 @@ export async function start() {
82
82
  timer = setTimeout(pump, 2000 + jobs.size * 3000);
83
83
  };
84
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
+
85
109
  const pump = async () => {
86
110
  if (pumping) return;
87
111
  pumping = true;
88
112
  try {
113
+ await jobsLoop().catch((e) => log(`No se pudo pedir un trabajo de texto: ${e.message}`));
89
114
  while (canTake()) {
90
115
  const claim = await client.claim(config.machineId);
91
116
  if (!claim) break;
package/src/tools.js CHANGED
@@ -72,6 +72,35 @@ export function launch(config, claim, cwd, logStream, resumeId = null) {
72
72
  return { child, done };
73
73
  }
74
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
+
75
104
  /** Interpreta lo que devolvió Claude Code: terminó bien, falló o llegó al límite de la suscripción. */
76
105
  export function outcome({ code, out, err }) {
77
106
  const text = `${out}\n${err}`;