@danieltmn/tamnora 0.12.0 → 0.13.0

package/harness/packages/server/public/app.js

@@ -195,7 +195,7 @@ function activateTab(name) {
   hideMoreMenu();
   if (name === 'runs') refreshRuns();
   if (name === 'providers') refreshProviders();
-  if (name === 'ajustes') { refreshMcp(); refreshSkills(); refreshChannels(); refreshLimits(); refreshVoz(); refreshAsesor(); refreshTranscribe(); refreshProfile(); }
+  if (name === 'ajustes') { refreshMcp(); refreshSkills(); refreshMemory(); refreshChannels(); refreshLimits(); refreshVoz(); refreshAsesor(); refreshTranscribe(); refreshProfile(); }
 }
 
 document.querySelectorAll('.tab[data-tab]').forEach((t) =>
@@ -3701,6 +3701,10 @@ const mcpForm = $('#mcp-form');
 const skillListEl = $('#skill-list');
 const skillModal = $('#skill-modal');
 const skillForm = $('#skill-form');
+const memoryListEl = $('#memory-list');
+const memoryIndexEl = $('#memory-index');
+const memoryModal = $('#memory-modal');
+const memoryForm = $('#memory-form');
 const tgTokenEl = $('#tg-token');
 const tgChatsEl = $('#tg-chats');
 const tgTranscribeEl = $('#tg-transcribe');
@@ -3989,6 +3993,88 @@ async function submitSkill(event) {
   refreshSkills();
 }
 
+/* --- ajustes: Memoria ---------------------------------------------------- */
+
+async function refreshMemory() {
+  if (!memoryListEl) return;
+  const data = await api('/api/memory').catch(() => null);
+  if (!data) return;
+  if (memoryIndexEl && document.activeElement !== memoryIndexEl) memoryIndexEl.value = data.index ?? '';
+  clear(memoryListEl);
+  if (!data.topics?.length) {
+    memoryListEl.appendChild(el('li', 'muted', 'sin memoria todavía'));
+    return;
+  }
+  for (const t of data.topics) {
+    const li = el('li', 'active');
+    const main = el('div', 'grow');
+    main.append(
+      el('div', '', t.title || t.name),
+      el('div', 'pmeta', `${t.name}${t.bytes ? ` · ${Math.max(1, Math.round(t.bytes / 1024))} KB` : ''}`)
+    );
+    li.appendChild(main);
+    const actions = el('div', 'pactions');
+    actions.appendChild(button('editar', (event) => { event.stopPropagation(); openMemoryForm(t.name); }));
+    actions.appendChild(button('borrar', (event) => { event.stopPropagation(); removeMemory(t.name); }, 'btn danger'));
+    li.appendChild(actions);
+    li.addEventListener('click', () => openMemoryForm(t.name));
+    memoryListEl.appendChild(li);
+  }
+}
+
+async function openMemoryForm(name = null) {
+  $('#memory-title').textContent = name ? `editar ${name}` : 'nuevo tema';
+  $('#mem-name').value = name ? name.replace(/\.md$/i, '') : '';
+  $('#mem-name').readOnly = Boolean(name);
+  $('#mem-title').value = '';
+  $('#mem-body').value = '';
+  setStatus('#mem-status', '');
+  if (name) {
+    const data = await api(`/api/memory/${encodeURIComponent(name)}`).catch(() => null);
+    if (data?.topic) {
+      $('#mem-title').value = data.topic.title ?? '';
+      $('#mem-body').value = data.topic.body ?? '';
+    }
+  }
+  memoryModal.showModal();
+  if (!name) $('#mem-name').focus();
+}
+
+function closeMemoryForm() {
+  if (memoryModal.open) memoryModal.close();
+}
+
+async function removeMemory(name) {
+  await deleteEntity(`/api/memory/${encodeURIComponent(name)}`, {
+    confirmText: `¿Borrar la memoria "${name}"?`,
+    refresh: refreshMemory,
+  });
+}
+
+async function submitMemory(event) {
+  event.preventDefault();
+  const name = $('#mem-name').value.trim();
+  if (!name) return setStatus('#mem-status', 'Falta el tema.', 'err');
+  const body = { title: $('#mem-title').value.trim(), body: $('#mem-body').value };
+  try {
+    await api(`/api/memory/${encodeURIComponent(name)}`, { method: 'PUT', body });
+  } catch (error) {
+    return setStatus('#mem-status', error.message, 'err');
+  }
+  closeMemoryForm();
+  refreshMemory();
+}
+
+async function saveMemoryIndex() {
+  try {
+    await api('/api/memory', { method: 'PUT', body: { index: memoryIndexEl.value } });
+  } catch (error) {
+    return setStatus('#memory-status', error.message, 'err');
+  }
+  setStatus('#memory-status', 'guardado', 'ok');
+  refreshMemory();
+}
+
 async function refreshChannels() {
   if (!tgStatusEl) return;
   const data = await api('/api/channels').catch(() => null);
@@ -4665,6 +4751,15 @@ $('#asesor-test')?.addEventListener('click', testAsesor);
   skillModal.addEventListener('click', (event) => {
     if (event.target === skillModal) closeSkillForm();
   });
+
+  $('#memory-new')?.addEventListener('click', () => openMemoryForm());
+  $('#memory-close')?.addEventListener('click', closeMemoryForm);
+  $('#mem-cancel')?.addEventListener('click', closeMemoryForm);
+  memoryForm?.addEventListener('submit', submitMemory);
+  $('#memory-save-index')?.addEventListener('click', saveMemoryIndex);
+  memoryModal?.addEventListener('click', (event) => {
+    if (event.target === memoryModal) closeMemoryForm();
+  });
 }
 
 /* --- eval ---------------------------------------------------------------- */

package/harness/packages/server/public/index.html

@@ -37,7 +37,7 @@
   </head>
   <body>
     <header class="topbar">
-      <div class="brand"><span class="logo"><img src="/icons/logo.png" alt="Tamnora" /></span> <span id="topbar-section" class="topbar-section">chat</span> <span class="ver">v0.12.0</span></div>
+      <div class="brand"><span class="logo"><img src="/icons/logo.png" alt="Tamnora" /></span> <span id="topbar-section" class="topbar-section">chat</span> <span class="ver">v0.13.0</span></div>
       <nav class="tabs">
         <button class="tab active" data-tab="chat">chat</button>
         <button class="tab" data-tab="providers">proveedores</button>
@@ -461,6 +461,7 @@
             <button type="button" class="ajustes-tab" data-panel="sesiones" role="tab">Sesiones</button>
             <button type="button" class="ajustes-tab" data-panel="mcp" role="tab">MCP</button>
             <button type="button" class="ajustes-tab" data-panel="skills" role="tab">Skills</button>
+            <button type="button" class="ajustes-tab" data-panel="memoria" role="tab">Memoria</button>
             <button type="button" class="ajustes-tab" data-panel="telegram" role="tab">Telegram</button>
           <button type="button" class="ajustes-tab" data-panel="voz" role="tab">Voz</button>
           <button type="button" class="ajustes-tab" data-panel="asesor" role="tab">Asesor</button>
@@ -583,6 +584,25 @@
           <ul id="skill-list" class="providers"></ul>
         </div>
 
+        <div class="panel ajustes-panel" data-panel="memoria">
+          <div class="row between">
+            <h2>Memoria</h2>
+            <button id="memory-new" class="btn">+ tema</button>
+          </div>
+          <p class="muted verify-line">
+            Lo que el proyecto recuerda entre sesiones (<code>.tamnora/memory/</code>). El agente la mantiene con la
+            herramienta <code>memory</code>; acá la podés revisar y editar.
+          </p>
+          <label class="field"><span>índice (MEMORY.md)</span>
+            <textarea id="memory-index" rows="6" spellcheck="false" placeholder="# Memoria del proyecto"></textarea>
+          </label>
+          <div class="row between settings-actions">
+            <span id="memory-status" class="summary"></span>
+            <button id="memory-save-index" class="btn" type="button">guardar índice</button>
+          </div>
+          <ul id="memory-list" class="providers"></ul>
+        </div>
+
         <div class="panel ajustes-panel" data-panel="telegram">
           <div class="row between">
             <h2>Telegram</h2>
@@ -956,6 +976,31 @@
       </form>
     </dialog>
 
+    <dialog id="memory-modal" class="modal">
+      <form id="memory-form" class="modal-card">
+        <div class="row between">
+          <h3 id="memory-title">nuevo tema</h3>
+          <button type="button" id="memory-close" class="btn icon" title="cerrar" aria-label="cerrar">
+            <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+              <path d="M18 6 6 18M6 6l12 12" />
+            </svg>
+          </button>
+        </div>
+        <div class="row">
+          <label class="field"><span>tema (slug)</span><input id="mem-name" spellcheck="false" placeholder="arquitectura" /></label>
+          <label class="field grow"><span>título</span><input id="mem-title" spellcheck="false" placeholder="Arquitectura" /></label>
+        </div>
+        <label class="field"><span>contenido (markdown)</span>
+          <textarea id="mem-body" rows="10" spellcheck="false" placeholder="Qué recordar del proyecto…"></textarea>
+        </label>
+        <div class="row between settings-actions">
+          <button type="button" id="mem-cancel" class="btn">cancelar</button>
+          <button type="submit" class="btn primary">guardar</button>
+        </div>
+        <div id="mem-status" class="summary"></div>
+      </form>
+    </dialog>
+
     <dialog id="palette-modal" class="modal palette-modal">
       <div class="palette">
         <div class="palette-row">

package/harness/packages/server/src/lib/agentRun.js

@@ -27,9 +27,9 @@ export function combineToolset({ local, admin = null, tasks = null, exposeAdmin
     ...(admin ? admin.definitions.filter((d) => adminAllowed(d.function.name)) : []),
     ...(tasks ? tasks.definitions : []),
   ];
-  const execute = (name, args, context) => {
+  const execute = (name, args, context = {}) => {
     if (tasks?.handles(name)) return tasks.execute(name, args);
-    if (adminAllowed(name)) return admin.execute(name, args, approve ? { approve } : undefined);
+    if (adminAllowed(name)) return admin.execute(name, args, { approve, ...context });
     return local.execute(name, args, context);
   };
   return { definitions, execute };

package/harness/packages/server/src/lib/agentTools.js

@@ -12,6 +12,12 @@ import {
   registryServerToConfig,
   normalizeMcpConfig,
   homeDir,
+  memorySlug,
+  listMemoryTopics,
+  readMemoryIndex,
+  readMemoryTopic,
+  writeMemory,
+  searchMemory,
 } from './core.js';
 import { SKILL_ID_PATTERN, skillsView, writeSkill, setSkillEnabled, findSkill } from './skills.js';
 
@@ -71,6 +77,18 @@ const DEFINITIONS = [
     },
     []
   ),
+  definition(
+    'memory',
+    'Memoria durable del proyecto, persiste entre sesiones. Acciones: list (temas), read (índice o un tema), search (busca) y write (crea/actualiza un tema). Guardá ahí lo que valga la pena recordar del proyecto.',
+    {
+      action: { type: 'string', enum: ['list', 'read', 'search', 'write'], description: 'Acción a ejecutar' },
+      topic: { type: 'string', description: 'Tema (slug) para read/write' },
+      query: { type: 'string', description: 'Texto a buscar (action=search)' },
+      title: { type: 'string', description: 'Título del tema (action=write)' },
+      content: { type: 'string', description: 'Contenido markdown (action=write)' },
+    },
+    ['action']
+  ),
 ];
 
 async function fetchText(url) {
@@ -90,24 +108,26 @@ async function fetchText(url) {
   }
 }
 
-function decisionFor(ctx, name) {
+function decisionFor(ctx, name, args) {
   const perms = ctx.config.permissions ?? {};
   const value = perms[name];
   if (value === 'allow' || value === 'ask' || value === 'deny') return value;
+  if (name === 'memory') return String(args?.action ?? 'read').toLowerCase() === 'write' ? 'ask' : 'allow';
   return name.startsWith('list_') || name === 'skill' ? 'allow' : 'ask';
 }
 
 /**
- * Crea las tools de administracion. `execute(name, args, { approve })`, donde
- * `approve(name, args)` resuelve true/false para los permisos "ask".
+ * Crea las tools de administracion. `execute(name, args, { approve, cwd })`,
+ * donde `approve(name, args)` resuelve true/false para los permisos "ask" y
+ * `cwd` es la carpeta de la sesion (para la memoria del proyecto).
  */
 export function createAgentTools(ctx) {
   function handles(name) {
     return DEFINITIONS.some((d) => d.function.name === name);
   }
 
-  async function execute(name, args = {}, { approve } = {}) {
-    const decision = decisionFor(ctx, name);
+  async function execute(name, args = {}, { approve, cwd } = {}) {
+    const decision = decisionFor(ctx, name, args);
     if (decision === 'deny') return `Permiso denegado para "${name}".`;
     if (decision === 'ask') {
       const ok = approve ? await approve(name, args) : false;
@@ -248,6 +268,41 @@ export function createAgentTools(ctx) {
         return `Skill "${id}" instalada.`;
       }
 
+      case 'memory': {
+        const root = cwd ?? ctx.cwd;
+        const action = String(args.action ?? 'read').toLowerCase();
+        if (action === 'list') {
+          const topics = listMemoryTopics(root);
+          if (!topics.length) return 'No hay memoria guardada todavía para este proyecto.';
+          return JSON.stringify(topics.map(({ name, title, bytes }) => ({ name, title, bytes })), null, 2);
+        }
+        if (action === 'search') {
+          const query = String(args.query ?? '').trim();
+          if (!query) return 'Pasá "query" para buscar en la memoria.';
+          const hits = searchMemory(root, query);
+          if (!hits.length) return `Sin resultados para "${query}".`;
+          return hits.map((h) => `### ${h.title} (${h.name})\n${h.snippet}`).join('\n\n');
+        }
+        if (action === 'write') {
+          const content = String(args.content ?? '').trim();
+          if (!content) return 'Pasá "content" para guardar en memoria.';
+          try {
+            const saved = await writeMemory(root, { topic: args.topic ?? args.title, title: args.title, content });
+            return `Guardado en memoria: ${saved.name} (${saved.title}).`;
+          } catch (error) {
+            return `No se pudo guardar la memoria: ${error.message}`;
+          }
+        }
+        const topic = String(args.topic ?? '').trim();
+        if (topic) {
+          const name = topic.endsWith('.md') ? topic : `${memorySlug(topic)}.md`;
+          const read = readMemoryTopic(root, name);
+          if (!read) return `No hay memoria del tema "${topic}".`;
+          return read.body;
+        }
+        return readMemoryIndex(root).trim() || 'No hay índice de memoria todavía.';
+      }
+
       default:
         return `Herramienta desconocida: ${name}`;
     }

package/harness/packages/server/src/lib/channels/telegram.js

@@ -25,6 +25,7 @@ import {
   toolCallPayload,
 } from '../agentRun.js';
 import { mp3AOgg } from '../ffmpeg.js';
+import { createRulesInjector } from '../rules.js';
 import { resolveTts } from '../ttsSettings.js';
 import { transcribeAudio } from '../transcribe.js';
 
@@ -505,6 +506,8 @@ export function startTelegramChannel(
         messages,
         tools: definitions,
         execute,
+        toolContext: { cwd, sessionId },
+        onLifecycle: createRulesInjector({ cwd, patterns: ctx.config.rules ?? [] }) ?? undefined,
         signal: controller.signal,
         maxRounds: ctx.effectiveMaxRounds?.() ?? ctx.config.maxRounds,
         maxTokens: ctx.effectiveMaxTokens?.() ?? 0,

package/harness/packages/server/src/lib/prompt.js

@@ -1,4 +1,4 @@
-import { loadInstructions } from './core.js';
+import { loadInstructions, loadRules, buildStaticRulesBlock, memoryPrompt } from './core.js';
 
 export const DEFAULT_SYSTEM_PROMPT =
   'Eres Tamnora, un asistente útil. Responde en el idioma del usuario y usa las herramientas cuando aporten valor.';
@@ -34,14 +34,21 @@ function workspacePreamble(cwd) {
  * @param {() => string} [opts.profileText] - user profile block, re-read on every call
  * @param {() => string} [opts.skillsText] - skills block, re-read on every call
  * @param {() => string} [opts.scopeText] - strict-scope block, re-read on every call
+ * @param {string[]} [opts.ruleFiles] - glob patterns of project rule files
+ * @param {boolean} [opts.memory] - inject the project memory block
  */
-export function createPromptBuilder({ cwd, files, profileText, skillsText, scopeText }) {
+export function createPromptBuilder({ cwd, files, profileText, skillsText, scopeText, ruleFiles = [], memory = false }) {
   const cache = new Map();
 
   async function buildFor(workspace) {
     const instructions = (await loadInstructions(workspace, files)).trim();
     const base = workspacePreamble(workspace);
-    return instructions ? `${base}\n\n---\n\n${instructions}` : base;
+    let text = instructions ? `${base}\n\n---\n\n${instructions}` : base;
+    if (ruleFiles.length) {
+      const block = buildStaticRulesBlock(await loadRules(workspace, ruleFiles).catch(() => []));
+      if (block) text = `${text}\n\n---\n\n${block}`;
+    }
+    return text;
   }
 
   return async function systemPromptFor(workspace = cwd) {
@@ -53,6 +60,10 @@ export function createPromptBuilder({ cwd, files, profileText, skillsText, scope
     if (profile) parts.push(profile);
     const extra = typeof skillsText === 'function' ? String(skillsText() ?? '').trim() : '';
     if (extra) parts.push(extra);
+    if (memory) {
+      const mem = memoryPrompt(key);
+      if (mem) parts.push(mem);
+    }
     const scope = typeof scopeText === 'function' ? String(scopeText() ?? '').trim() : '';
     if (scope) parts.push(scope);
     return parts.join('\n\n---\n\n');

package/harness/packages/server/src/lib/rules.js

@@ -0,0 +1,43 @@
+// Reglas de proyecto por path inyectadas en runtime. Se engancha al seam de
+// ciclo de vida del agente: cuando una tool toca un archivo que matchea el
+// `paths:` de una regla, se agrega al contexto de las proximas rondas (efimera,
+// no se persiste). Dedup: una instancia por run, cada regla una vez.
+
+import { loadRules, rulesForPath, buildPathRulesBlock } from './core.js';
+
+const PATH_TOOLS = new Set(['read', 'write', 'edit', 'list']);
+
+/**
+ * Crea un handler `onLifecycle(event, payload)` para las reglas por path.
+ * Devuelve `null` si no hay patrones configurados.
+ */
+export function createRulesInjector({ cwd, patterns = [] }) {
+  if (!patterns.length) return null;
+  let cached = null;
+  let loading = null;
+  const injected = new Set();
+
+  async function all() {
+    if (cached) return cached;
+    if (!loading) {
+      loading = loadRules(cwd, patterns)
+        .catch(() => [])
+        .then((rules) => {
+          cached = rules;
+          return rules;
+        });
+    }
+    return loading;
+  }
+
+  return async function onLifecycle(event) {
+    if (event?.type !== 'tool.after' || !PATH_TOOLS.has(event.name)) return undefined;
+    const rel = event.args?.path ?? event.args?.file;
+    if (!rel || typeof rel !== 'string') return undefined;
+    const rules = await all();
+    const matches = rulesForPath(rules, rel).filter((rule) => !injected.has(rule.id));
+    if (!matches.length) return undefined;
+    for (const rule of matches) injected.add(rule.id);
+    return { inject: buildPathRulesBlock(matches, rel) };
+  };
+}

package/harness/packages/server/src/routes/chat.js

@@ -19,6 +19,7 @@ import {
 import { fraseInicio, fraseFin, fraseError, createFiltroTools } from '../lib/announcer.js';
 import { resolveAdvisor, advisorShouldRun, consultAdvisor } from '../lib/advisor.js';
 import { maybeAutoCompact } from '../lib/compact.js';
+import { createRulesInjector } from '../lib/rules.js';
 
 /**
  * Emit streaming partials at most once per `ms` window, keeping only the
@@ -268,6 +269,8 @@ export function registerChat(route, ctx) {
           messages,
           tools: definitions,
           execute,
+          toolContext: { cwd: sessionCwd, sessionId },
+          onLifecycle: createRulesInjector({ cwd: sessionCwd, patterns: ctx.config.rules ?? [] }) ?? undefined,
           signal: ctx.runs.signal(sessionId),
           maxRounds: Number(body.maxRounds) || ctx.effectiveMaxRounds?.() || MAX_TOOL_ROUNDS,
           maxTokens: Number(body.maxTokens) || ctx.effectiveMaxTokens?.() || 0,

package/harness/packages/server/src/routes/memory.js

@@ -0,0 +1,66 @@
+// Memoria durable del proyecto (`<cwd>/.tamnora/memory`). El agente la usa con la
+// tool `memory`; la consola la lista, edita y borra desde la pestaña Memoria.
+
+import {
+  memoryRoot,
+  isMemoryTopic,
+  readMemoryIndex,
+  listMemoryTopics,
+  readMemoryTopic,
+  writeMemory,
+  deleteMemory,
+  writeMemoryIndex,
+} from '../lib/core.js';
+import { readJson, sendJson, sendError } from '../lib/http.js';
+
+/** Acepta el slug o el nombre de archivo (`x` o `x.md`). */
+function topicFile(name) {
+  const raw = String(name ?? '');
+  return /\.md$/i.test(raw) ? raw : `${raw}.md`;
+}
+
+function memoryView(cwd) {
+  return {
+    root: memoryRoot(cwd),
+    index: readMemoryIndex(cwd),
+    topics: listMemoryTopics(cwd),
+  };
+}
+
+export function registerMemory(route, ctx) {
+  route('GET', '/api/memory', ({ res }) => {
+    sendJson(res, 200, memoryView(ctx.cwd));
+  });
+
+  route('PUT', '/api/memory', async ({ req, res }) => {
+    const body = await readJson(req);
+    await writeMemoryIndex(ctx.cwd, String(body.index ?? ''));
+    sendJson(res, 200, memoryView(ctx.cwd));
+  });
+
+  route('GET', '/api/memory/:name', ({ res, params }) => {
+    const topic = readMemoryTopic(ctx.cwd, topicFile(params.name));
+    if (!topic) return sendError(res, 404, 'Memoria no encontrada.');
+    sendJson(res, 200, { topic });
+  });
+
+  route('PUT', '/api/memory/:name', async ({ req, res, params }) => {
+    const file = topicFile(params.name);
+    if (!isMemoryTopic(file)) return sendError(res, 400, 'Nombre de memoria inválido.');
+    const body = await readJson(req);
+    const content = String(body.body ?? body.content ?? '').trim();
+    if (!content) return sendError(res, 400, 'La memoria necesita contenido.');
+    await writeMemory(ctx.cwd, {
+      topic: file.replace(/\.md$/i, ''),
+      title: body.title,
+      content,
+    });
+    sendJson(res, 200, memoryView(ctx.cwd));
+  });
+
+  route('DELETE', '/api/memory/:name', async ({ res, params }) => {
+    const removed = await deleteMemory(ctx.cwd, topicFile(params.name));
+    if (!removed) return sendError(res, 404, 'Memoria no encontrada.');
+    sendJson(res, 200, memoryView(ctx.cwd));
+  });
+}

package/harness/packages/server/src/server.js

@@ -36,6 +36,7 @@ import { registerModels } from './routes/models.js';
 import { registerProviders } from './routes/providers.js';
 import { registerMcp } from './routes/mcp.js';
 import { registerSkills } from './routes/skills.js';
+import { registerMemory } from './routes/memory.js';
 import { registerChannels } from './routes/channels.js';
 import { registerProfile } from './routes/profile.js';
 import { registerTts } from './routes/tts.js';
@@ -208,6 +209,8 @@ export async function createTamnoraServer({
     profileText: () => profilePrompt(resolveProfile(ctx.app)),
     skillsText: () => skillsBlock(ctx),
     scopeText: () => scopeDirective(ctx.effectiveStrictScope()),
+    ruleFiles: config.rules ?? [],
+    memory: config.memory?.enabled !== false,
   });
   ctx.systemPrompt = (await ctx.systemPromptFor(cwd)) || DEFAULT_SYSTEM_PROMPT;
   ctx.agentTools = createAgentTools(ctx);
@@ -245,6 +248,7 @@ export async function createTamnoraServer({
   registerProviders(route, ctx);
   registerMcp(route, ctx);
   registerSkills(route, ctx);
+  registerMemory(route, ctx);
   registerChannels(route, ctx);
   registerProfile(route, ctx);
   registerTts(route, ctx);