theus-cli-linux-arm64 1.2.2 → 1.3.0

package/vendor/theus-arsenal/scripts/lib/plan-canvas/sessions.js

@@ -1,274 +0,0 @@
-'use strict';
-
-/**
- * Almacén de sesiones del Lienzo de planes.
- *
- * Las sesiones se indexan por la ruta canónica del archivo del artefacto,
- * así los agentes nunca tienen que rastrear ids opacos. El estado se
- * persiste como JSON en el directorio de estado del Lienzo de planes para
- * que el feedback humano encolado sobreviva a un reinicio del servidor.
- */
-
-const crypto = require('crypto');
-const fs = require('fs');
-const path = require('path');
-
-const { expandHomePath, resolveAgentDataHome } = require('../agent-data-home');
-
-const FEEDBACK_KINDS = new Set(['chat', 'annotation', 'verdict']);
-const VERDICTS = new Set(['approve', 'request-changes']);
-
-function resolveStateDir(env = process.env) {
-  const override = expandHomePath(env.THEUS_PLAN_CANVAS_STATE_DIR);
-  if (override) return override;
-  return path.join(resolveAgentDataHome(), 'plan-canvas');
-}
-
-// Canonicaliza para que `./plan.md`, los symlinks y las rutas absolutas
-// aterricen todos en la misma sesión.
-function canonicalizeArtifactPath(filePath) {
-  const absolute = path.resolve(filePath);
-  try {
-    return fs.realpathSync(absolute);
-  } catch {
-    return absolute;
-  }
-}
-
-function sessionKeyFor(canonicalPath) {
-  return crypto.createHash('sha256').update(canonicalPath).digest('hex').slice(0, 12);
-}
-
-function nowIso() {
-  return new Date().toISOString();
-}
-
-function sanitizeText(value, maxLength = 4000) {
-  if (typeof value !== 'string') return '';
-  return value.slice(0, maxLength);
-}
-
-// Normaliza un ítem de feedback enviado desde el navegador a la forma que se
-// entrega al agente. Devuelve null ante entrada inutilizable en lugar de
-// lanzar, para que un ítem malformado nunca atasque la cola.
-function normalizeFeedbackItem(raw, counter) {
-  if (!raw || typeof raw !== 'object') return null;
-  const kind = FEEDBACK_KINDS.has(raw.kind) ? raw.kind : null;
-  if (!kind) return null;
-  const item = {
-    id: `fb-${counter}`,
-    kind,
-    text: sanitizeText(raw.text),
-    at: nowIso()
-  };
-  if (kind === 'verdict') {
-    if (!VERDICTS.has(raw.verdict)) return null;
-    item.verdict = raw.verdict;
-  }
-  if (kind === 'annotation') {
-    const anchor = raw.anchor && typeof raw.anchor === 'object' ? raw.anchor : null;
-    if (!anchor || typeof anchor.selector !== 'string') return null;
-    item.anchor = {
-      selector: sanitizeText(anchor.selector, 500),
-      tag: sanitizeText(anchor.tag, 60),
-      snippet: sanitizeText(anchor.snippet, 400)
-    };
-    if (anchor.textRange && typeof anchor.textRange === 'object') {
-      item.anchor.textRange = {
-        text: sanitizeText(anchor.textRange.text, 1000)
-      };
-    }
-    if (!item.text) return null;
-  }
-  if (kind === 'chat' && !item.text) return null;
-  return item;
-}
-
-function createSessionStore({ stateDir = resolveStateDir() } = {}) {
-  const stateFile = path.join(stateDir, 'sessions.json');
-  let state = { sessions: {}, feedbackCounter: 0 };
-
-  function load() {
-    try {
-      const parsed = JSON.parse(fs.readFileSync(stateFile, 'utf8'));
-      if (parsed && typeof parsed === 'object' && parsed.sessions) {
-        state = {
-          sessions: parsed.sessions,
-          feedbackCounter: Number(parsed.feedbackCounter) || 0
-        };
-      }
-    } catch {
-      // Un estado ausente o corrupto arranca de cero; perder feedback
-      // encolado por un archivo corrupto es mejor que negarse a arrancar.
-    }
-  }
-
-  function persist() {
-    fs.mkdirSync(stateDir, { recursive: true });
-    const tmpFile = `${stateFile}.tmp`;
-    fs.writeFileSync(tmpFile, JSON.stringify(state, null, 2));
-    fs.renameSync(tmpFile, stateFile);
-  }
-
-  load();
-
-  function get(key) {
-    return state.sessions[key] || null;
-  }
-
-  function findByFile(filePath) {
-    const canonical = canonicalizeArtifactPath(filePath);
-    return get(sessionKeyFor(canonical));
-  }
-
-  // Abre (o retoma) una sesión. Una sesión que el *usuario* terminó desde el
-  // navegador es pegajosa: rechaza un reopen simple para que los agentes no
-  // vuelvan a abrir el navegador sin invitación. Pasa reopen:true solo
-  // cuando la persona lo pidió.
-  function open(filePath, { reopen = false } = {}) {
-    const canonical = canonicalizeArtifactPath(filePath);
-    const key = sessionKeyFor(canonical);
-    const existing = state.sessions[key];
-    if (existing && existing.status === 'ended' && existing.endedBy === 'user' && !reopen) {
-      return { session: existing, refused: true };
-    }
-    const session = existing || {
-      key,
-      file: canonical,
-      chat: [],
-      pendingFeedback: [],
-      createdAt: nowIso()
-    };
-    session.status = 'open';
-    delete session.endedBy;
-    session.updatedAt = nowIso();
-    state.sessions[key] = session;
-    persist();
-    return { session, refused: false };
-  }
-
-  // Encola feedback del navegador. Los ítems de tipo chat se reflejan de
-  // inmediato en la transcripción de la sesión para que el panel de
-  // conversación se mantenga coherente entre recargas.
-  function queueFeedback(key, rawItems, { endSession = false } = {}) {
-    const session = get(key);
-    if (!session || session.status === 'ended') return null;
-    const accepted = [];
-    for (const raw of Array.isArray(rawItems) ? rawItems : []) {
-      state.feedbackCounter += 1;
-      const item = normalizeFeedbackItem(raw, state.feedbackCounter);
-      if (item) accepted.push(item);
-    }
-    session.pendingFeedback.push(...accepted);
-    for (const item of accepted) {
-      session.chat.push({ role: 'user', kind: item.kind, text: chatLineFor(item), at: item.at });
-    }
-    if (endSession) {
-      session.status = 'ended';
-      session.endedBy = 'user';
-    } else if (accepted.length > 0) {
-      session.status = 'feedback';
-    }
-    session.updatedAt = nowIso();
-    persist();
-    return { accepted, pending: session.pendingFeedback.length, session };
-  }
-
-  // Entregar-y-vaciar: el feedback se entrega exactamente a una llamada de
-  // await, tras lo cual la sesión vuelve a estado open. Una sesión terminada
-  // sigue reportando ended (con atribución) para que los agentes sepan que
-  // deben dejar de consultar.
-  function takeFeedback(key) {
-    const session = get(key);
-    if (!session) return { status: 'missing' };
-    if (session.pendingFeedback.length > 0) {
-      const items = session.pendingFeedback;
-      session.pendingFeedback = [];
-      const result = { status: 'feedback', items };
-      if (session.status === 'ended') {
-        result.sessionEnded = true;
-        result.endedBy = session.endedBy;
-      } else {
-        session.status = 'open';
-      }
-      session.updatedAt = nowIso();
-      persist();
-      return result;
-    }
-    if (session.status === 'ended') {
-      return { status: 'ended', endedBy: session.endedBy };
-    }
-    return { status: 'waiting' };
-  }
-
-  function addAgentReply(key, text) {
-    const session = get(key);
-    if (!session) return null;
-    const entry = { role: 'agent', kind: 'chat', text: sanitizeText(text), at: nowIso() };
-    session.chat.push(entry);
-    session.updatedAt = nowIso();
-    persist();
-    return entry;
-  }
-
-  function end(key, endedBy) {
-    const session = get(key);
-    if (!session) return null;
-    session.status = 'ended';
-    session.endedBy = endedBy === 'user' ? 'user' : 'agent';
-    session.updatedAt = nowIso();
-    persist();
-    return session;
-  }
-
-  function list() {
-    return Object.values(state.sessions).map(session => ({
-      key: session.key,
-      file: session.file,
-      status: session.status,
-      endedBy: session.endedBy,
-      pending: session.pendingFeedback.length,
-      updatedAt: session.updatedAt
-    }));
-  }
-
-  function hasOpenSessions() {
-    return Object.values(state.sessions).some(session => session.status !== 'ended');
-  }
-
-  return {
-    stateDir,
-    stateFile,
-    open,
-    get,
-    findByFile,
-    queueFeedback,
-    takeFeedback,
-    addAgentReply,
-    end,
-    list,
-    hasOpenSessions
-  };
-}
-
-// Render de una línea de un ítem de feedback para la transcripción de la
-// conversación.
-function chatLineFor(item) {
-  if (item.kind === 'verdict') {
-    const label = item.verdict === 'approve' ? 'Aprobó el plan' : 'Pidió cambios';
-    return item.text ? `${label}: ${item.text}` : label;
-  }
-  if (item.kind === 'annotation') {
-    const where = item.anchor.snippet || item.anchor.selector;
-    return `[${where}] ${item.text}`;
-  }
-  return item.text;
-}
-
-module.exports = {
-  canonicalizeArtifactPath,
-  createSessionStore,
-  normalizeFeedbackItem,
-  resolveStateDir,
-  sessionKeyFor
-};