theus-cli 0.2.82 → 0.2.84

package/vendor/theus-arsenal/scripts/lib/agent-data-home.js

@@ -1,96 +0,0 @@
-/**
- * Resuelve la raíz de datos del agente Theus (raíz de persistencia de memoria).
- *
- * Orden de resolución (sin mutar process.env):
- *   1. THEUS_AGENT_DATA_HOME — override explícito del usuario (admite `~`).
- *   2. ~/.theus/arsenal — ubicación por defecto.
- *
- * Nota de diseño: THEUS_PLUGIN_DATA se excluye a propósito de la cadena. Ese
- * directorio solo existe en el entorno de los hooks, pero los mismos datos
- * (sesiones, alias, estado) también se leen desde comandos y ejecuciones
- * manuales, donde esa variable no está definida. Usarla partiría los datos en
- * dos ubicaciones según el contexto de ejecución; ~/.theus/arsenal es estable
- * en todos los contextos.
- *
- * Política de documentación: se documentan los puntos de entrada públicos;
- * los helpers internos pequeños (p. ej. `expandHomePath`) se dejan sin JSDoc
- * a propósito, en línea con el resto de módulos de scripts de Theus.
- */
-
-const path = require('path');
-
-const AGENT_DATA_HOME_ENV = 'THEUS_AGENT_DATA_HOME';
-const PLUGIN_DATA_ENV = 'THEUS_PLUGIN_DATA';
-const DEFAULT_THEUS_DIR_NAME = '.theus';
-const DEFAULT_ARSENAL_DIR_NAME = 'arsenal';
-
-/**
- * Directorio home para expansión de `~` y rutas por defecto.
- *
- * Replica intencionalmente `getHomeDir()` de `scripts/lib/utils.js`
- * (HOME/USERPROFILE, luego `os.homedir()`). No importar `utils.getHomeDir`
- * aquí: `utils.js` ya requiere este módulo (`resolveAgentDataHome`), lo que
- * crearía una dependencia circular.
- */
-function getHomeDirFromEnv() {
-  const explicitHome = process.env.HOME || process.env.USERPROFILE;
-  if (explicitHome && String(explicitHome).trim().length > 0) {
-    return path.resolve(explicitHome);
-  }
-  return require('os').homedir();
-}
-
-function expandHomePath(value, baseDir) {
-  if (!value || typeof value !== 'string') return null;
-  const trimmed = value.trim();
-  if (!trimmed) return null;
-  if (trimmed.startsWith('~')) {
-    const remainder = trimmed.slice(1).replace(/^[/\\]+/, '');
-    return remainder ? path.join(getHomeDirFromEnv(), remainder) : getHomeDirFromEnv();
-  }
-  if (path.isAbsolute(trimmed)) {
-    return path.resolve(trimmed);
-  }
-  const base = baseDir && String(baseDir).trim()
-    ? path.resolve(baseDir)
-    : process.cwd();
-  return path.resolve(base, trimmed);
-}
-
-function getDefaultAgentDataHome() {
-  return path.join(getHomeDirFromEnv(), DEFAULT_THEUS_DIR_NAME, DEFAULT_ARSENAL_DIR_NAME);
-}
-
-/**
- * Resuelve la raíz de datos del agente sin mutar process.env.
- */
-function resolveAgentDataHome() {
-  const fromEnv = expandHomePath(process.env[AGENT_DATA_HOME_ENV]);
-  if (fromEnv) return fromEnv;
-
-  return getDefaultAgentDataHome();
-}
-
-/**
- * Fija THEUS_AGENT_DATA_HOME en el proceso actual cuando no está definida
- * (red de seguridad para subprocesos de hooks).
- * @returns {string} Raíz de datos del agente resuelta
- */
-function ensureAgentDataHomeEnv() {
-  const resolved = resolveAgentDataHome();
-  if (!expandHomePath(process.env[AGENT_DATA_HOME_ENV])) {
-    process.env[AGENT_DATA_HOME_ENV] = resolved;
-  }
-  return resolved;
-}
-
-module.exports = {
-  AGENT_DATA_HOME_ENV,
-  PLUGIN_DATA_ENV,
-  DEFAULT_THEUS_DIR_NAME,
-  DEFAULT_ARSENAL_DIR_NAME,
-  expandHomePath,
-  getDefaultAgentDataHome,
-  resolveAgentDataHome,
-  ensureAgentDataHomeEnv,
-};

package/vendor/theus-arsenal/scripts/lib/cost-estimate.js

@@ -1,66 +0,0 @@
-'use strict';
-
-/**
- * Estimación de costos compartida para los hooks del arsenal Theus.
- *
- * Tarifas aproximadas por millón de tokens (USD), datos internos de
- * estimación. Los nombres de familia de modelos de esta tabla son datos de
- * referencia de tarifas upstream, no copy visible: el registro guarda el
- * modelo tal cual venga en el transcript y estas tarifas solo sirven para
- * calcular una cifra estimada.
- *
- * Escritura en caché: 1.25x la tarifa de entrada. Lectura de caché: 0.1x.
- * Los modelos que no coinciden con ninguna familia usan la tarifa media
- * (fila `sonnet`) como valor conservador por defecto.
- */
-
-const RATE_TABLE = {
-  haiku: { in: 0.8, out: 4.0, cacheWrite: 1.0, cacheRead: 0.08 },
-  sonnet: { in: 3.0, out: 15.0, cacheWrite: 3.75, cacheRead: 0.3 },
-  opus: { in: 15.0, out: 75.0, cacheWrite: 18.75, cacheRead: 1.5 }
-};
-
-/**
- * Devuelve la fila de tarifas aplicable a un nombre de modelo.
- * @param {string} model - Nombre del modelo tal cual aparece en el transcript
- * @returns {{in: number, out: number, cacheWrite: number, cacheRead: number}}
- */
-function getRates(model) {
-  const normalized = String(model || '').toLowerCase();
-  if (normalized.includes('haiku')) return RATE_TABLE.haiku;
-  if (normalized.includes('opus')) return RATE_TABLE.opus;
-  return RATE_TABLE.sonnet;
-}
-
-/**
- * Estima el costo en USD a partir de los tokens de entrada/salida.
- * @param {string} model - Nombre del modelo
- * @param {number} inputTokens
- * @param {number} outputTokens
- * @returns {number} Costo estimado en USD (redondeado a 6 decimales)
- */
-function estimateCost(model, inputTokens, outputTokens) {
-  const rates = getRates(model);
-  const cost = (inputTokens / 1_000_000) * rates.in + (outputTokens / 1_000_000) * rates.out;
-  return Math.round(cost * 1e6) / 1e6;
-}
-
-/**
- * Estima el costo en USD incluyendo los tokens de caché.
- * @param {string} model - Nombre del modelo
- * @param {{inputTokens?: number, outputTokens?: number, cacheWriteTokens?: number, cacheReadTokens?: number}} usage
- * @returns {number} Costo estimado en USD (redondeado a 6 decimales)
- */
-function estimateCostWithCache(model, usage) {
-  const rates = getRates(model);
-  const u = usage || {};
-  const num = v => (Number.isFinite(Number(v)) ? Number(v) : 0);
-  const cost =
-    (num(u.inputTokens) / 1_000_000) * rates.in +
-    (num(u.outputTokens) / 1_000_000) * rates.out +
-    (num(u.cacheWriteTokens) / 1_000_000) * rates.cacheWrite +
-    (num(u.cacheReadTokens) / 1_000_000) * rates.cacheRead;
-  return Math.round(cost * 1e6) / 1e6;
-}
-
-module.exports = { estimateCost, estimateCostWithCache, getRates, RATE_TABLE };

package/vendor/theus-arsenal/scripts/lib/hook-flags.js

@@ -1,79 +0,0 @@
-#!/usr/bin/env node
-/**
- * Controles compartidos para habilitar/deshabilitar hooks.
- *
- * Controles:
- * - THEUS_HOOK_PROFILE=minimal|standard|strict (por defecto: standard)
- * - THEUS_DISABLED_HOOKS=ids,de,hooks,separados,por,comas
- */
-
-'use strict';
-
-const VALID_PROFILES = new Set(['minimal', 'standard', 'strict']);
-
-function normalizeId(value) {
-  return String(value || '').trim().toLowerCase();
-}
-
-function getHookProfile() {
-  const raw = String(process.env.THEUS_HOOK_PROFILE || 'standard').trim().toLowerCase();
-  return VALID_PROFILES.has(raw) ? raw : 'standard';
-}
-
-function getDisabledHookIds() {
-  const raw = String(process.env.THEUS_DISABLED_HOOKS || '');
-  if (!raw.trim()) return new Set();
-
-  return new Set(
-    raw
-      .split(',')
-      .map(v => normalizeId(v))
-      .filter(Boolean)
-  );
-}
-
-function parseProfiles(rawProfiles, fallback = ['standard', 'strict']) {
-  if (!rawProfiles) return [...fallback];
-
-  if (Array.isArray(rawProfiles)) {
-    const parsed = rawProfiles
-      .map(v => String(v || '').trim().toLowerCase())
-      .filter(v => VALID_PROFILES.has(v));
-    return parsed.length > 0 ? parsed : [...fallback];
-  }
-
-  const parsed = String(rawProfiles)
-    .split(',')
-    .map(v => v.trim().toLowerCase())
-    .filter(v => VALID_PROFILES.has(v));
-
-  return parsed.length > 0 ? parsed : [...fallback];
-}
-
-function isDryRun() {
-  return process.env.THEUS_DRY_RUN === '1';
-}
-
-function isHookEnabled(hookId, options = {}) {
-  const id = normalizeId(hookId);
-  if (!id) return true;
-
-  const disabled = getDisabledHookIds();
-  if (disabled.has(id)) {
-    return false;
-  }
-
-  const profile = getHookProfile();
-  const allowedProfiles = parseProfiles(options.profiles);
-  return allowedProfiles.includes(profile);
-}
-
-module.exports = {
-  VALID_PROFILES,
-  normalizeId,
-  getHookProfile,
-  getDisabledHookIds,
-  parseProfiles,
-  isHookEnabled,
-  isDryRun,
-};

package/vendor/theus-arsenal/scripts/lib/llm-summary.js

@@ -1,185 +0,0 @@
-#!/usr/bin/env node
-/**
- * Generador de resúmenes de sesión con LLM
- *
- * Usa `theus -p` (el CLI de Theus) para generar resúmenes de sesión ricos y
- * contextuales a partir de transcripciones JSONL. No requiere clave de API —
- * reutiliza la propia autenticación del CLI de Theus.
- *
- * Guarda anti-recursión: define THEUS_SKIP_LLM_SUMMARY=1 en el entorno del
- * subproceso para que los hooks Stop disparados por el subproceso NO vuelvan
- * a entrar en la generación de resúmenes.
- */
-
-'use strict';
-
-const { spawnSync } = require('child_process');
-const fs = require('fs');
-
-const MAX_TRANSCRIPT_CHARS = 7000;
-const MAX_TURNS = 25;
-const LLM_TIMEOUT_MS = 90000;
-
-/**
- * Modelo a usar para el resumen. Si THEUS_LLM_SUMMARY_MODEL no está definida,
- * devuelve null y se deja que el enrutado multimodelo nativo de Theus elija
- * un modelo económico del catálogo.
- */
-function getLLMModel() {
-  return process.env.THEUS_LLM_SUMMARY_MODEL || null;
-}
-
-function getContextThreshold() {
-  const raw = parseInt(process.env.THEUS_LLM_SUMMARY_CONTEXT_THRESHOLD || '20', 10);
-  return Number.isFinite(raw) && raw > 0 && raw <= 100 ? raw : 20;
-}
-
-/**
- * Extrae los últimos MAX_TURNS turnos usuario+asistente de una transcripción JSONL.
- * Devuelve null cuando la transcripción no existe o no tiene turnos parseables.
- */
-function extractConversationText(transcriptPath) {
-  let content;
-  try {
-    content = fs.readFileSync(transcriptPath, 'utf8');
-  } catch {
-    return null;
-  }
-
-  const lines = content.split('\n').filter(Boolean);
-  const turns = [];
-
-  for (const line of lines) {
-    try {
-      const entry = JSON.parse(line);
-      const isUser = entry.type === 'user' || entry.message?.role === 'user';
-      const isAssistant = entry.type === 'assistant';
-
-      if (isUser) {
-        const rawContent = entry.message?.content ?? entry.content;
-        const text =
-          typeof rawContent === 'string'
-            ? rawContent
-            : Array.isArray(rawContent)
-              ? rawContent
-                  .filter(c => c?.type === 'text')
-                  .map(c => c.text)
-                  .join(' ')
-              : '';
-        const cleaned = text.replace(/\n+/g, ' ').trim();
-        if (cleaned) {
-          turns.push({ role: 'Usuario', text: cleaned.slice(0, 400) });
-        }
-      }
-
-      if (isAssistant && Array.isArray(entry.message?.content)) {
-        const textParts = entry.message.content
-          .filter(b => b?.type === 'text')
-          .map(b => b.text)
-          .join(' ')
-          .replace(/\n+/g, ' ')
-          .trim();
-        if (textParts) {
-          turns.push({ role: 'Theus', text: textParts.slice(0, 600) });
-        }
-      }
-    } catch {
-      // Omitir líneas no parseables
-    }
-  }
-
-  if (turns.length === 0) return null;
-
-  const recent = turns.slice(-MAX_TURNS);
-  const formatted = recent.map(t => `**${t.role}:** ${t.text}`).join('\n\n');
-  return formatted.length > MAX_TRANSCRIPT_CHARS ? '...(inicio omitido)\n\n' + formatted.slice(-MAX_TRANSCRIPT_CHARS) : formatted;
-}
-
-/**
- * Lee el porcentaje de contexto restante a partir del último registro de uso
- * de una transcripción. Devuelve null cuando no está disponible.
- */
-function getContextRemainingPct(transcriptPath) {
-  try {
-    const { readLatestContextTokens, resolveContextWindowTokens } = require('./transcript-context');
-    const usage = readLatestContextTokens(transcriptPath);
-    if (!usage) return null;
-    const windowTokens = resolveContextWindowTokens(usage.tokens, usage.model);
-    return Math.round((1 - usage.tokens / windowTokens) * 100);
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Genera un resumen de sesión usando `theus -p`.
- * Devuelve la cadena del resumen, o null si falla o si la guarda
- * anti-recursión está activa.
- */
-function generateSessionSummary(transcriptPath) {
-  if (process.env.THEUS_SKIP_LLM_SUMMARY) return null;
-
-  const conversation = extractConversationText(transcriptPath);
-  if (!conversation) return null;
-
-  const prompt = [
-    'A continuación hay un registro de conversación de una sesión de programación con Theus.',
-    'Crea un resumen que ayude a la próxima sesión a entender el contexto rápidamente.',
-    '',
-    '## Prioriza incluir',
-    '- Decisiones de diseño y elecciones tecnológicas tomadas en esta sesión',
-    '- Bugs y problemas resueltos',
-    '- Archivos cambiados o creados, con una breve descripción de los cambios',
-    '- Tareas inconclusas y trabajo a continuar en la próxima sesión',
-    '- Contexto importante que la próxima sesión necesita conocer',
-    '',
-    '## Registro de conversación',
-    conversation,
-    '',
-    '## Formato de salida (solo Markdown, sin preámbulo)',
-    '',
-    '## Resumen de sesión',
-    '',
-    '### Tareas',
-    '(tareas principales trabajadas en esta sesión)',
-    '',
-    '### Decisiones tomadas',
-    '(decisiones de diseño y elecciones tecnológicas)',
-    '',
-    '### Archivos modificados',
-    '(archivos cambiados o creados)',
-    '',
-    '### Temas pendientes',
-    '(tareas inconclusas y trabajo a continuar)',
-    '',
-    '### Contexto para la próxima sesión',
-    '(contexto importante para la próxima sesión)'
-  ].join('\n');
-
-  try {
-    const model = getLLMModel();
-    const args = model ? ['--model', model, '-p'] : ['-p'];
-    const result = spawnSync('theus', args, {
-      input: prompt,
-      encoding: 'utf8',
-      env: {
-        ...process.env,
-        THEUSCODE: '',
-        THEUS_SKIP_LLM_SUMMARY: '1'
-      },
-      timeout: LLM_TIMEOUT_MS,
-      shell: process.platform === 'win32'
-    });
-
-    if (result.error || result.status !== 0) {
-      return null;
-    }
-
-    const output = (result.stdout || '').trim();
-    return output || null;
-  } catch {
-    return null;
-  }
-}
-
-module.exports = { generateSessionSummary, extractConversationText, getContextRemainingPct, getContextThreshold, getLLMModel };

package/vendor/theus-arsenal/scripts/lib/loopback-guard.js

@@ -1,54 +0,0 @@
-'use strict';
-
-/**
- * Filtro de cabeceras Host/Origin para los servidores HTTP de loopback del
- * arsenal (p. ej. el Lienzo de planes). Un ataque de DNS rebinding puede
- * apuntar un hostname controlado por el atacante a 127.0.0.1, así que cada
- * petición debe presentar una cabecera Host de esta lista de permitidos antes
- * de que el servidor haga cualquier trabajo.
- */
-
-const LOOPBACK_HOSTNAMES = new Set(['127.0.0.1', 'localhost', '[::1]', '::1']);
-
-// Extrae la porción de hostname de una cabecera HTTP Host, descartando el
-// puerto. Devuelve null cuando la cabecera falta o está malformada.
-function parseHostHeader(value) {
-  if (!value || typeof value !== 'string') return null;
-  const trimmed = value.trim();
-  if (!trimmed) return null;
-  const match = trimmed.match(/^(\[[^\]]+\]|[^:]+)(?::\d+)?$/);
-  if (!match) return null;
-  return match[1].toLowerCase();
-}
-
-function buildAllowedHostnames(configuredHost) {
-  const set = new Set(LOOPBACK_HOSTNAMES);
-  if (configuredHost) set.add(String(configuredHost).toLowerCase());
-  return set;
-}
-
-function isAllowedHostHeader(hostHeader, allowedHostnames) {
-  const hostname = parseHostHeader(hostHeader);
-  if (!hostname) return false;
-  return allowedHostnames.has(hostname);
-}
-
-// Origin no viene en navegaciones same-origin ni en clientes de CLI; cuando
-// está presente debe resolver a un hostname permitido.
-function isAllowedOrigin(originHeader, allowedHostnames) {
-  if (!originHeader || typeof originHeader !== 'string') return true;
-  try {
-    const url = new URL(originHeader);
-    return allowedHostnames.has(url.hostname.toLowerCase());
-  } catch {
-    return false;
-  }
-}
-
-module.exports = {
-  LOOPBACK_HOSTNAMES,
-  buildAllowedHostnames,
-  isAllowedHostHeader,
-  isAllowedOrigin,
-  parseHostHeader
-};