mundogiru-agent 0.1.0

package/README.md

@@ -0,0 +1,82 @@
+# Mundo G.I.R.U — Agente IA local
+
+> Asistente de IA pensado para personas no técnicas. **Un solo comando**
+> para arrancar. Tus datos y tu API key viven solo en tu equipo.
+
+```bash
+npx mundogiru-agent
+```
+
+Se abre un wizard de 4 pasos en tu navegador (`http://localhost:7777/wizard`)
+y, una vez configurado, una ventana de chat (`/chat`).
+
+## Qué hace
+
+- **Asistente IA con memoria local** (SQLite, patrón propose-first).
+- **Multi-proveedor LLM**: Anthropic (Claude), OpenAI (GPT), Groq, Ollama.
+- **100% local**: ningún dato sale de tu máquina.
+- **API keys cifradas** en disco con AES-256-GCM (llave derivada de la
+  identidad de tu máquina con scrypt).
+- **Cross-plataforma**: macOS, Linux, Windows (Node.js ≥ 20).
+
+## Requisitos
+
+- Node.js 20 o superior.
+- Una API key de tu proveedor preferido (no hace falta si usas Ollama
+  local).
+
+## Estructura del proyecto
+
+```
+src/
+├── cli.ts                    # Entry point (`bin`)
+├── server.ts                 # Fastify (puerto 7777)
+├── core/
+│   ├── config.ts             # Carga/guarda config cifrada
+│   ├── memory.ts             # SQLite + propose-first
+│   ├── llm.ts                # Cliente multi-proveedor
+│   └── skills.ts             # Registry de skills
+├── skills/
+│   ├── chat.ts               # Fallback: LLM directo
+│   └── memory-recall.ts      # Búsqueda en memoria
+├── wizard/                   # HTML+JS plano (4 pasos)
+└── ui/chat.html              # Interfaz de chat
+tests/                        # vitest (config, memory, llm, chat e2e)
+```
+
+## Comandos
+
+```bash
+npm install
+npm run dev        # tsx src/cli.ts (hot reload)
+npm run build      # tsc → dist/
+npm test           # vitest
+npm run typecheck  # tsc --noEmit
+```
+
+## Configuración persistente
+
+- Ubicación: `~/.mundogiru/`
+- `config.enc` — config cifrada AES-256-GCM
+- `data/memory.db` — SQLite (memoria + propuestas + historial chat)
+
+## Variables de entorno
+
+| Variable | Default | Descripción |
+|----------|---------|-------------|
+| `MUNDOGIRU_PORT` | `7777` | Puerto del servidor Fastify |
+| `MUNDOGIRU_HOME` | `~/.mundogiru` | Carpeta de datos |
+| `MUNDOGIRU_NO_OPEN` | (vacío) | `1` para no abrir el navegador |
+| `MUNDOGIRU_STATIC_ROOT` | auto | Override de estáticos (dev/test) |
+
+## Privacidad
+
+- **Cifrado en reposo**: AES-256-GCM con llave derivada de
+  `hostname + username` vía scrypt. Si copias `config.enc` a otra máquina,
+  no se puede descifrar.
+- **Sin telemetría**: ninguna petición HTTP saliente excepto al LLM que
+  hayas configurado tú.
+
+## Licencia
+
+MIT — © iaflashelite.com

package/dist/cli.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+/**
+ * Entry point invocado por `npx mundogiru-agent`.
+ *
+ * Comportamiento:
+ *  1. Lee config si existe → decide ruta wizard o chat.
+ *  2. Arranca Fastify en localhost:7777 (override con MUNDOGIRU_PORT).
+ *  3. Abre el navegador automáticamente con `open` cross-platform.
+ *  4. Mensajes en consola para humanos no técnicos.
+ */
+import open from "open";
+import process from "node:process";
+import { configExists, getConfigPaths } from "./core/config.js";
+import { startServer } from "./server.js";
+async function main() {
+    const port = Number.parseInt(process.env.MUNDOGIRU_PORT ?? "7777", 10);
+    const paths = getConfigPaths();
+    const hasConfig = await configExists();
+    console.log("");
+    console.log("  ╭─────────────────────────────────────────────╮");
+    console.log("  │  Mundo G.I.R.U — Agente local IA            │");
+    console.log("  ╰─────────────────────────────────────────────╯");
+    console.log("");
+    console.log(`  Datos:   ${paths.home}`);
+    console.log(`  Puerto:  ${port}`);
+    console.log("");
+    try {
+        await startServer(port);
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "EADDRINUSE") {
+            console.error(`  ✗ El puerto ${port} ya está ocupado.`);
+            console.error(`    Cierra el proceso anterior o exporta MUNDOGIRU_PORT=<otro>.`);
+            process.exit(1);
+        }
+        throw err;
+    }
+    const url = `http://localhost:${port}`;
+    console.log(`  ▸ Abriendo ${url}${hasConfig ? "/chat" : "/wizard"} en tu navegador…`);
+    console.log(`  ▸ Para cerrar el agente: pulsa Ctrl+C aquí.`);
+    console.log("");
+    if (process.env.MUNDOGIRU_NO_OPEN !== "1") {
+        try {
+            await open(url);
+        }
+        catch {
+            console.log(`  (No pude abrir el navegador automáticamente — visita ${url} manualmente.)`);
+        }
+    }
+    // Mantener vivo el proceso hasta SIGINT.
+    process.on("SIGINT", () => {
+        console.log("\n  ▸ Cerrando agente. Hasta luego.");
+        process.exit(0);
+    });
+}
+main().catch((err) => {
+    console.error("Error arrancando Mundo G.I.R.U:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,KAAK,UAAU,IAAI;IACf,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,MAAM,YAAY,EAAE,CAAC;IAEvC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;IACjE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,IAAI,CAAC;QACD,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,GAA4B,CAAC;QACvC,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,iBAAiB,IAAI,mBAAmB,CAAC,CAAC;YACxD,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;YACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QACD,MAAM,GAAG,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,oBAAoB,IAAI,EAAE,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,mBAAmB,CAAC,CAAC;IACtF,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,GAAG,EAAE,CAAC;QACxC,IAAI,CAAC;YACD,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,CAAC,GAAG,CAAC,0DAA0D,GAAG,gBAAgB,CAAC,CAAC;QAC/F,CAAC;IACL,CAAC;IAED,yCAAyC;IACzC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACtB,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;AACP,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACjB,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC,CAAC"}

package/dist/core/config.js

@@ -0,0 +1,100 @@
+/**
+ * Configuración persistente cifrada.
+ *
+ * Ubicación: ~/.mundogiru/config.enc
+ * Cifrado:   AES-256-GCM
+ * Llave:     scrypt(machineId + username, randomSalt, 32)
+ *
+ * La sal se guarda en claro junto al cifrado. Esto NO defiende contra un
+ * atacante con acceso al disco del usuario (la llave es derivable), pero
+ * sí defiende contra exfiltración del archivo a otra máquina y previene
+ * que la API key aparezca grepable en `~/`.
+ */
+import { createCipheriv, createDecipheriv, randomBytes, scryptSync } from "node:crypto";
+import { promises as fsp } from "node:fs";
+import { hostname, userInfo } from "node:os";
+import { dirname, join } from "node:path";
+import process from "node:process";
+const ALG = "aes-256-gcm";
+const SCRYPT_N = 16384;
+const SCRYPT_R = 8;
+const SCRYPT_P = 1;
+const KEY_LEN = 32;
+const SALT_LEN = 16;
+const IV_LEN = 12;
+export function getConfigPaths() {
+    const home = process.env.MUNDOGIRU_HOME ?? join(userInfo().homedir, ".mundogiru");
+    return {
+        home,
+        config: join(home, "config.enc"),
+        db: join(home, "data", "memory.db"),
+        uiDir: join(home, "ui"),
+    };
+}
+function machineIdentity() {
+    return `${hostname()}:${userInfo().username}`;
+}
+function deriveKey(salt) {
+    return scryptSync(machineIdentity(), salt, KEY_LEN, {
+        N: SCRYPT_N,
+        r: SCRYPT_R,
+        p: SCRYPT_P,
+    });
+}
+export async function configExists() {
+    try {
+        await fsp.access(getConfigPaths().config);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function loadConfig() {
+    const { config: path } = getConfigPaths();
+    try {
+        const blob = await fsp.readFile(path);
+        if (blob.length < SALT_LEN + IV_LEN + 16)
+            return null;
+        const salt = blob.subarray(0, SALT_LEN);
+        const iv = blob.subarray(SALT_LEN, SALT_LEN + IV_LEN);
+        const tag = blob.subarray(blob.length - 16);
+        const ciphertext = blob.subarray(SALT_LEN + IV_LEN, blob.length - 16);
+        const key = deriveKey(salt);
+        const decipher = createDecipheriv(ALG, key, iv);
+        decipher.setAuthTag(tag);
+        const plain = Buffer.concat([decipher.update(ciphertext), decipher.final()]);
+        return JSON.parse(plain.toString("utf8"));
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+export async function saveConfig(config) {
+    const paths = getConfigPaths();
+    await fsp.mkdir(dirname(paths.config), { recursive: true });
+    const salt = randomBytes(SALT_LEN);
+    const iv = randomBytes(IV_LEN);
+    const key = deriveKey(salt);
+    const cipher = createCipheriv(ALG, key, iv);
+    const plain = Buffer.from(JSON.stringify(config), "utf8");
+    const ciphertext = Buffer.concat([cipher.update(plain), cipher.final()]);
+    const tag = cipher.getAuthTag();
+    const blob = Buffer.concat([salt, iv, ciphertext, tag]);
+    await fsp.writeFile(paths.config, blob, { mode: 0o600 });
+}
+export function defaultModelFor(provider) {
+    switch (provider) {
+        case "anthropic":
+            return "claude-sonnet-4-6";
+        case "openai":
+            return "gpt-4o-mini";
+        case "groq":
+            return "llama-3.3-70b-versatile";
+        case "ollama":
+            return "llama3.2";
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"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"}

package/dist/core/llm.js

@@ -0,0 +1,158 @@
+/**
+ * Cliente LLM unificado para Anthropic, OpenAI, Groq y Ollama.
+ *
+ * Sin SDKs externos — `fetch` directo a las APIs HTTP. Ahorra ~10 MB
+ * de dependencias en el bundle npx y elimina problemas de versiones.
+ *
+ * Interfaz: `chat(messages) => { content, totalTokens }`.
+ */
+class HttpError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = "HttpError";
+    }
+}
+function splitSystem(messages) {
+    const systemParts = [];
+    const rest = [];
+    for (const m of messages) {
+        if (m.role === "system")
+            systemParts.push(m.content);
+        else
+            rest.push(m);
+    }
+    return { system: systemParts.join("\n\n"), rest };
+}
+// ---------- Anthropic ----------
+class AnthropicClient {
+    model;
+    apiKey;
+    provider = "anthropic";
+    constructor(model, apiKey) {
+        this.model = model;
+        this.apiKey = apiKey;
+    }
+    async chat(messages) {
+        const { system, rest } = splitSystem(messages);
+        const res = await fetch("https://api.anthropic.com/v1/messages", {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                "x-api-key": this.apiKey,
+                "anthropic-version": "2023-06-01",
+            },
+            body: JSON.stringify({
+                model: this.model,
+                max_tokens: 1024,
+                system: system || undefined,
+                messages: rest.map((m) => ({ role: m.role, content: m.content })),
+            }),
+        });
+        if (!res.ok) {
+            throw new HttpError(res.status, `Anthropic ${res.status}: ${await res.text()}`);
+        }
+        const json = (await res.json());
+        const text = json.content
+            .filter((c) => c.type === "text")
+            .map((c) => c.text)
+            .join("");
+        const totalTokens = json.usage
+            ? json.usage.input_tokens + json.usage.output_tokens
+            : undefined;
+        return { content: text, totalTokens };
+    }
+}
+// ---------- OpenAI / Groq (formato OpenAI) ----------
+class OpenAIStyleClient {
+    provider;
+    model;
+    apiKey;
+    baseUrl;
+    constructor(provider, model, apiKey, baseUrl) {
+        this.provider = provider;
+        this.model = model;
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl;
+    }
+    async chat(messages) {
+        const res = await fetch(`${this.baseUrl}/chat/completions`, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                model: this.model,
+                messages: messages.map((m) => ({ role: m.role, content: m.content })),
+                max_tokens: 1024,
+            }),
+        });
+        if (!res.ok) {
+            throw new HttpError(res.status, `${this.provider} ${res.status}: ${await res.text()}`);
+        }
+        const json = (await res.json());
+        return {
+            content: json.choices[0]?.message.content ?? "",
+            totalTokens: json.usage?.total_tokens,
+        };
+    }
+}
+// ---------- Ollama (local, sin API key) ----------
+class OllamaClient {
+    model;
+    baseUrl;
+    provider = "ollama";
+    constructor(model, baseUrl) {
+        this.model = model;
+        this.baseUrl = baseUrl;
+    }
+    async chat(messages) {
+        const res = await fetch(`${this.baseUrl.replace(/\/$/, "")}/api/chat`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({
+                model: this.model,
+                stream: false,
+                messages: messages.map((m) => ({ role: m.role, content: m.content })),
+            }),
+        });
+        if (!res.ok) {
+            throw new HttpError(res.status, `Ollama ${res.status}: ${await res.text()}`);
+        }
+        const json = (await res.json());
+        return { content: json.message?.content ?? "" };
+    }
+}
+// ---------- factoría ----------
+export function buildLLMClient(config) {
+    switch (config.llmProvider) {
+        case "anthropic":
+            return new AnthropicClient(config.llmModel, config.apiKey);
+        case "openai":
+            return new OpenAIStyleClient("openai", config.llmModel, config.apiKey, "https://api.openai.com/v1");
+        case "groq":
+            return new OpenAIStyleClient("groq", config.llmModel, config.apiKey, "https://api.groq.com/openai/v1");
+        case "ollama":
+            return new OllamaClient(config.llmModel, config.ollamaBaseUrl ?? "http://localhost:11434");
+    }
+}
+/**
+ * Cliente "stub" determinista para tests: hace echo del último mensaje user.
+ */
+export class StubLLMClient {
+    responder;
+    provider = "anthropic";
+    model = "stub";
+    constructor(responder) {
+        this.responder = responder;
+    }
+    async chat(messages) {
+        if (this.responder)
+            return { content: this.responder(messages), totalTokens: 0 };
+        const lastUser = [...messages].reverse().find((m) => m.role === "user");
+        return { content: `[stub] ${lastUser?.content ?? ""}`, totalTokens: 0 };
+    }
+}
+//# sourceMappingURL=llm.js.map

package/dist/core/llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/core/llm.ts"],"names":[],"mappings":"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"}

package/dist/core/memory.js

@@ -0,0 +1,180 @@
+/**
+ * Memoria persistente con `better-sqlite3` (SÍNCRONA).
+ *
+ * Patrón propose-first (copiado de giru-agent):
+ *   1. `proposeMemory()` crea fila en `memory_proposals` con status=pending.
+ *   2. `approveProposal()` la migra a `memory_records`.
+ *   3. `rejectProposal()` la marca rechazada sin tocar `memory_records`.
+ *
+ * Esto evita que el agente meta cosas en memoria por sorpresa: la UI/skill
+ * decide explícitamente qué se confirma.
+ */
+import Database from "better-sqlite3";
+import { randomUUID } from "node:crypto";
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { getConfigPaths } from "./config.js";
+const SCHEMA = `
+PRAGMA journal_mode = WAL;
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE IF NOT EXISTS memory_records (
+    id          TEXT PRIMARY KEY,
+    type        TEXT NOT NULL DEFAULT 'semantic',
+    content     TEXT NOT NULL,
+    importance  REAL NOT NULL DEFAULT 0.5,
+    created_at  INTEGER NOT NULL,
+    updated_at  INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_records_type ON memory_records(type);
+CREATE INDEX IF NOT EXISTS idx_memory_records_updated ON memory_records(updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS memory_proposals (
+    id          TEXT PRIMARY KEY,
+    op          TEXT NOT NULL,
+    type        TEXT NOT NULL,
+    content     TEXT NOT NULL,
+    importance  REAL NOT NULL DEFAULT 0.5,
+    status      TEXT NOT NULL DEFAULT 'pending',
+    target_id   TEXT,
+    created_at  INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_proposals_status ON memory_proposals(status);
+
+CREATE TABLE IF NOT EXISTS chat_messages (
+    id          TEXT PRIMARY KEY,
+    role        TEXT NOT NULL,
+    content     TEXT NOT NULL,
+    created_at  INTEGER NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_chat_messages_created ON chat_messages(created_at DESC);
+`;
+let cached = null;
+export function getDb(path) {
+    if (cached)
+        return cached;
+    const dbPath = path ?? getConfigPaths().db;
+    if (dbPath !== ":memory:") {
+        mkdirSync(dirname(dbPath), { recursive: true });
+    }
+    const db = new Database(dbPath);
+    db.exec(SCHEMA);
+    cached = db;
+    return db;
+}
+export function resetDbForTests() {
+    if (cached)
+        cached.close();
+    cached = null;
+}
+// ---------- propose-first ----------
+export function proposeMemory(db, args) {
+    const proposal = {
+        id: randomUUID(),
+        op: args.op ?? "create",
+        type: args.type ?? "semantic",
+        content: args.content,
+        importance: args.importance ?? 0.5,
+        status: "pending",
+        target_id: args.targetId ?? null,
+        created_at: Date.now(),
+    };
+    db.prepare(`INSERT INTO memory_proposals (id, op, type, content, importance, status, target_id, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?)`).run(proposal.id, proposal.op, proposal.type, proposal.content, proposal.importance, proposal.status, proposal.target_id, proposal.created_at);
+    return proposal;
+}
+export function listPendingProposals(db) {
+    return db
+        .prepare(`SELECT * FROM memory_proposals WHERE status = 'pending' ORDER BY created_at DESC`)
+        .all();
+}
+export function approveProposal(db, proposalId) {
+    const proposal = db
+        .prepare(`SELECT * FROM memory_proposals WHERE id = ?`)
+        .get(proposalId);
+    if (!proposal || proposal.status !== "pending")
+        return null;
+    const now = Date.now();
+    const record = {
+        id: randomUUID(),
+        type: proposal.type,
+        content: proposal.content,
+        importance: proposal.importance,
+        created_at: now,
+        updated_at: now,
+    };
+    const tx = db.transaction(() => {
+        db.prepare(`INSERT INTO memory_records (id, type, content, importance, created_at, updated_at)
+             VALUES (?, ?, ?, ?, ?, ?)`).run(record.id, record.type, record.content, record.importance, record.created_at, record.updated_at);
+        db.prepare(`UPDATE memory_proposals SET status = 'approved' WHERE id = ?`).run(proposalId);
+    });
+    tx();
+    return record;
+}
+export function rejectProposal(db, proposalId) {
+    const result = db
+        .prepare(`UPDATE memory_proposals SET status = 'rejected' WHERE id = ? AND status = 'pending'`)
+        .run(proposalId);
+    return result.changes > 0;
+}
+// ---------- consultas ----------
+const STOPWORDS = new Set([
+    "que", "qué", "de", "la", "el", "los", "las", "un", "una", "y", "o", "a",
+    "en", "del", "al", "por", "para", "con", "sin", "es", "ser", "esta", "estás",
+    "estoy", "tu", "tú", "mi", "mí", "me", "te", "se", "lo", "le", "como", "cómo",
+    "cuando", "cuándo", "donde", "dónde", "qué", "quien", "quién",
+    "recuerda", "recuerdas", "recordar", "memoria", "sabes", "sabe", "saber",
+    "the", "is", "of", "and", "to", "what", "do", "you", "know",
+]);
+const COMBINING_MARKS_RX = /[̀-ͯ]/g;
+function stripDiacritics(text) {
+    return text.normalize("NFD").replace(COMBINING_MARKS_RX, "");
+}
+function tokenize(text) {
+    return stripDiacritics(text.toLowerCase())
+        .split(/[^a-z0-9ñü]+/i)
+        .filter((t) => t.length >= 3 && !STOPWORDS.has(t));
+}
+function normalizeForCompare(text) {
+    return stripDiacritics(text.toLowerCase());
+}
+export function recallMemory(db, query, limit = 5) {
+    const all = db
+        .prepare(`SELECT * FROM memory_records ORDER BY importance DESC, updated_at DESC`)
+        .all();
+    const tokens = tokenize(query);
+    if (tokens.length === 0) {
+        // Sin tokens útiles → devolvemos los más importantes recientes.
+        return all.slice(0, limit);
+    }
+    const matched = all.filter((r) => {
+        const normalized = normalizeForCompare(r.content);
+        return tokens.some((t) => normalized.includes(t));
+    });
+    return matched.slice(0, limit);
+}
+export function listMemory(db, limit = 50) {
+    return db
+        .prepare(`SELECT * FROM memory_records ORDER BY updated_at DESC LIMIT ?`)
+        .all(limit);
+}
+export function appendChatMessage(db, role, content) {
+    const row = {
+        id: randomUUID(),
+        role,
+        content,
+        created_at: Date.now(),
+    };
+    db.prepare(`INSERT INTO chat_messages (id, role, content, created_at) VALUES (?, ?, ?, ?)`).run(row.id, row.role, row.content, row.created_at);
+    return row;
+}
+export function recentChatMessages(db, limit = 20) {
+    const rows = db
+        .prepare(`SELECT * FROM chat_messages ORDER BY created_at DESC, rowid DESC LIMIT ?`)
+        .all(limit);
+    return rows.reverse();
+}
+//# sourceMappingURL=memory.js.map

package/dist/core/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/core/memory.ts"],"names":[],"mappings":"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"}

package/dist/core/skills.js

@@ -0,0 +1,32 @@
+/**
+ * Sistema de skills: registro modular en memoria.
+ *
+ * Cada skill expone `match(ctx)` (boolean) y `handle(ctx)` (Promise<string>).
+ * La primera que matchea gana. Si ninguna matchea, usamos el fallback.
+ */
+export class SkillRegistry {
+    skills = [];
+    fallback = null;
+    register(skill) {
+        this.skills.push(skill);
+    }
+    setFallback(skill) {
+        this.fallback = skill;
+    }
+    list() {
+        return [...this.skills, ...(this.fallback ? [this.fallback] : [])];
+    }
+    async run(ctx) {
+        for (const skill of this.skills) {
+            if (skill.match(ctx)) {
+                const reply = await skill.handle(ctx);
+                return { skill: skill.name, reply };
+            }
+        }
+        if (this.fallback) {
+            return { skill: this.fallback.name, reply: await this.fallback.handle(ctx) };
+        }
+        return { skill: "noop", reply: "No tengo skills registradas todavía." };
+    }
+}
+//# sourceMappingURL=skills.js.map

package/dist/core/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/core/skills.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH,MAAM,OAAO,aAAa;IACd,MAAM,GAAY,EAAE,CAAC;IACrB,QAAQ,GAAiB,IAAI,CAAC;IAEtC,QAAQ,CAAC,KAAY;QACjB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,WAAW,CAAC,KAAY;QACpB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,IAAI;QACA,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAiB;QACvB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACtC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;YACxC,CAAC;QACL,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QACjF,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;IAC5E,CAAC;CACJ"}