@charlie.act7/canvas-mcp-server 1.1.8 → 1.2.0

package/.mcp.json

@@ -1,10 +1,12 @@
 {
-  "canvas": {
-    "command": "npx",
-    "args": ["-y", "@charlie.act7/canvas-mcp-server"],
-    "env": {
-      "CANVAS_API_TOKEN": "${CANVAS_API_TOKEN}",
-      "CANVAS_API_DOMAIN": "${CANVAS_API_DOMAIN}"
+  "mcpServers": {
+    "canvas": {
+      "command": "npx",
+      "args": ["-y", "@charlie.act7/canvas-mcp-server"],
+      "env": {
+        "CANVAS_API_TOKEN": "${CANVAS_API_TOKEN}",
+        "CANVAS_API_DOMAIN": "${CANVAS_API_DOMAIN}"
+      }
     }
   }
 }

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Charlie Cárdenas Toledo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,8 @@
 # 🎓 Canvas LMS MCP Server
 
+[![CI](https://github.com/CharlieCardenasToledo/mcp-canvas-server/actions/workflows/ci.yml/badge.svg)](https://github.com/CharlieCardenasToledo/mcp-canvas-server/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/@charlie.act7/canvas-mcp-server)](https://www.npmjs.com/package/@charlie.act7/canvas-mcp-server)
+[![npm downloads](https://img.shields.io/npm/dm/@charlie.act7/canvas-mcp-server)](https://www.npmjs.com/package/@charlie.act7/canvas-mcp-server)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 Bring AI to your Canvas Virtual Classroom! 🚀
@@ -56,16 +58,37 @@ Here are some realistic, everyday prompts you can use with your AI assistant:
 * 💬 *"Show me all ungraded submissions for 'Essay 1: Introduction to Sociology' in Sociology 101."*
 * 💬 *"Who is in Student Group A for the Chemistry class?"*
 * 💬 *"Does the assignment 'Project Proposal' have an active rubric associated? If so, retrieve its criteria."*
+* 💬 *"Search for everything related to 'photosynthesis' across my Biology course — assignments, pages, and discussions."*
 
 ### ✍️ Creating & Organizing Course Content
 * 💬 *"Create a new module named 'Week 1: Foundations' in my course."*
 * 💬 *"Add a SubHeader 'REQUIRED READINGS' inside the 'Week 1' module, and link the syllabus page to it."*
 * 💬 *"In my Business course, create an assignment called 'Case Study 1: Market Analysis'. Add an instructions table with columns for Criteria, Requirements, and Points."*
+* 💬 *"Create a threaded discussion topic in my course titled 'Weekly Reflection' and pin it to the top."*
 
 ### 💯 Grading & Absence Management
 * 💬 *"For assignment 'Case Study 1', find all students who haven't submitted their work. Assign them a grade of 0 and add the comment: 'Activity not submitted. Please contact the instructor if you have a valid excuse.'"*
 * 💬 *"Grade John's submission for 'Essay 1' with a 90 based on the rubric, and add a comment: 'Great job! The analysis is well-structured, though you could expand more on the conclusion. Keep it up!'"*
 
+### 📊 Student Engagement & Analytics
+* 💬 *"Show me the activity analytics for my Calculus course — how active have students been this week?"*
+* 💬 *"Which students haven't been active in course 12345 in the last few days? I want to reach out to them."*
+* 💬 *"Get the analytics for student [ID] in my Biology course — how many page views and participations do they have?"*
+
+### 💬 Messaging & Communication
+* 💬 *"Send a private message to student [ID] reminding them their 'Project Proposal' is due tomorrow."*
+* 💬 *"How many unread messages do I have in my Canvas inbox?"*
+* 💬 *"Show me my last 10 inbox conversations."*
+
+### 👥 Enrollment & Student Management
+* 💬 *"Who is enrolled in my course? Show me students and TAs separately."*
+* 💬 *"Search for a student named 'Maria Gonzalez' in account 1."*
+* 💬 *"Enroll user [ID] as a TA in my Physics course."*
+
+### 🔄 Peer Reviews
+* 💬 *"List all peer review assignments for 'Research Paper' in course 12345."*
+* 💬 *"Manually assign student [ID] to review [other student ID]'s submission for 'Essay 2'."*
+
 ---
 
 ## Setup Guide
@@ -133,28 +156,32 @@ This will guide you step-by-step to input your domain and API token, storing the
 ## Supported Tools & Resources
 
 <details>
-<summary><b>View Detailed List of Supported Tools & Resources (Technical)</b></summary>
-
-### Tools List
-
-The server exposes the following tools organized by category:
-
-| Category | Included Tools |
-|---|---|
-| **Courses** | List courses, get course details, set basic configuration |
-| **Modules** | List and manage course modules |
-| **Pages** | List pages, read page content HTML |
-| **Files** | List files uploaded to a course |
-| **Announcements** | List and create announcements |
-| **Assignments** | List, create, and update assignments; bulk update due dates |
-| **Submissions** | View student submissions and attachments |
-| **Grading** | Grade submissions, audit course grades |
-| **Quizzes** | List quizzes, manage questions, update quiz dates |
-| **Students** | Course roster, progress tracking, and student details |
-| **Groups** | List and manage student groups |
-| **Calendar** | List and create calendar events/reminders |
-| **Rubrics** | Create and manage grading rubrics |
-| **Communication** | Send direct messages, manage discussions and threads |
+<summary><b>View all 111 tools organized by category</b></summary>
+
+### Tool Inventory
+
+| Category | Tools | Description |
+|---|---|---|
+| **Courses** | `list_courses` · `create_course` · `update_course` · `get_syllabus` | Manage and configure courses |
+| **Modules** | `list_modules` · `create_module` · `update_module` · `delete_module` · `create_module_item` · `update_module_item` · `delete_module_item` | Full CRUD for modules and their items |
+| **Pages** | `list_pages` · `get_page_content` · `create_page` · `update_page` · `delete_page` | Manage wiki pages |
+| **Files & Folders** | `list_files` · `upload_file` · `update_file` · `delete_file` · `list_folders` · `create_folder` · `update_folder` · `delete_folder` | File management with folder support |
+| **Assignments** | `get_assignments` · `get_assignment` · `create_assignment` · `update_assignment` · `delete_assignment` · `update_assignment_dates` · `bulk_update_due_dates` · `list_assignment_groups` | Full assignment lifecycle |
+| **Submissions** | `get_submissions` · `get_submission` · `get_submission_comments` · `delete_submission_comment` · `submit_assignment` | View and manage student submissions |
+| **Grading** | `grade_submission` · `grade_multiple_submissions` · `audit_course` | Grade individually or in bulk |
+| **Rubrics** | `list_rubrics` · `get_rubric` · `create_rubric` · `update_rubric` · `create_rubric_association` | Build and attach grading rubrics |
+| **Quizzes (Classic)** | `list_quizzes` · `get_quiz` · `create_quiz` · `update_quiz` · `update_quiz_dates` · `list_quiz_questions` · `get_quiz_question` · `create_quiz_question` · `update_quiz_question` · `delete_quiz_question` · `create_quiz_group` | Classic Canvas quiz engine |
+| **New Quizzes (LTI)** | `create_new_quiz` · `update_new_quiz` · `delete_new_quiz` · `list_new_quiz_items` · `get_new_quiz_item` · `create_new_quiz_item` · `update_new_quiz_item` · `delete_new_quiz_item` | Modern LTI quiz engine (`/api/quiz/v1`) |
+| **Students** | `list_students` · `list_students_with_grades` · `get_student_grades` · `get_student_assignments` · `list_assignment_due_dates` | Roster and progress tracking |
+| **Enrollments** | `list_course_enrollments` · `enroll_user` · `remove_enrollment` · `get_user` · `get_profile` · `search_users` | Manage who is in your course |
+| **Groups** | `list_group_categories` · `create_group_category` · `list_groups_in_category` · `create_group` · `assign_unassigned_members` · `add_group_member` | Student group management |
+| **Discussions** | `list_discussions` · `get_discussion_entries` · `create_discussion` · `delete_discussion` · `post_discussion_reply` | Discussion boards |
+| **Announcements** | `list_announcements` · `post_announcement` · `update_announcement` | Course announcements |
+| **Conversations** | `list_conversations` · `get_conversation` · `get_conversation_unread_count` · `send_conversation` · `reply_to_conversation` | Private inbox messaging |
+| **Calendar** | `list_appointment_groups` · `get_appointment_group` · `create_appointment_group` · `update_appointment_group` · `delete_appointment_group` · `list_appointment_group_users` · `list_appointment_group_groups` · `get_next_appointment` | Scheduling and appointments |
+| **Analytics** | `get_course_analytics` · `get_student_analytics` · `get_course_activity_stream` · `search_course_content` | Engagement data and content search |
+| **Peer Reviews** | `list_peer_reviews` · `get_submission_peer_reviews` · `create_peer_review` · `delete_peer_review` | Configure and manage peer assessments |
+| **Health & Config** | `health_check` · `set_canvas_config` | Verify connection and update credentials at runtime |
 
 ### Supported MCP Resources
 For clients supporting direct resources:

package/dist/http-server.js

@@ -1,6 +1,10 @@
 import Fastify from "fastify";
 import swagger from "@fastify/swagger";
 import swaggerUi from "@fastify/swagger-ui";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { AgentRunner } from "./services/agent-runner.js";
+import { GeminiRunner } from "./services/gemini-runner.js";
 function buildOpenApiSpec() {
     return {
         openapi: "3.1.0",
@@ -21,7 +25,12 @@ function buildOpenApiSpec() {
                     summary: "Health check",
                     responses: {
                         "200": {
-                            description: "Server is healthy"
+                            description: "Server is healthy",
+                            content: {
+                                "application/json": {
+                                    schema: { type: "object", properties: { ok: { type: "boolean" } } }
+                                }
+                            }
                         }
                     }
                 }
@@ -32,7 +41,20 @@ function buildOpenApiSpec() {
                     summary: "Privacy policy",
                     responses: {
                         "200": {
-                            description: "Privacy policy text"
+                            description: "Privacy policy text",
+                            content: {
+                                "application/json": {
+                                    schema: {
+                                        type: "object",
+                                        properties: {
+                                            service: { type: "string" },
+                                            effective_date: { type: "string" },
+                                            summary: { type: "array", items: { type: "string" } },
+                                            contact: { type: "string" }
+                                        }
+                                    }
+                                }
+                            }
                         }
                     }
                 }
@@ -43,7 +65,24 @@ function buildOpenApiSpec() {
                     summary: "List active Canvas courses",
                     responses: {
                         "200": {
-                            description: "Courses list"
+                            description: "Courses list",
+                            content: {
+                                "application/json": {
+                                    schema: {
+                                        type: "array",
+                                        items: {
+                                            type: "object",
+                                            properties: {
+                                                id: { type: "integer" },
+                                                name: { type: "string" },
+                                                course_code: { type: "string" },
+                                                workflow_state: { type: "string" },
+                                                enrollment_term_id: { type: "integer" }
+                                            }
+                                        }
+                                    }
+                                }
+                            }
                         }
                     }
                 }
@@ -86,7 +125,26 @@ function buildOpenApiSpec() {
                     ],
                     responses: {
                         "200": {
-                            description: "Assignments list"
+                            description: "Assignments list",
+                            content: {
+                                "application/json": {
+                                    schema: {
+                                        type: "array",
+                                        items: {
+                                            type: "object",
+                                            properties: {
+                                                id: { type: "integer" },
+                                                name: { type: "string" },
+                                                due_at: { type: "string", nullable: true },
+                                                unlock_at: { type: "string", nullable: true },
+                                                lock_at: { type: "string", nullable: true },
+                                                points_possible: { type: "number", nullable: true },
+                                                published: { type: "boolean", nullable: true }
+                                            }
+                                        }
+                                    }
+                                }
+                            }
                         }
                     }
                 }
@@ -527,7 +585,7 @@ function buildOpenApiSpec() {
         }
     };
 }
-export async function startHttpServer(client, host = "0.0.0.0", port = 3000) {
+export async function startHttpServer(client, host = "0.0.0.0", port = 3000, tools = []) {
     const app = Fastify({ logger: true });
     await app.register(swagger, {
         openapi: buildOpenApiSpec()
@@ -535,6 +593,11 @@ export async function startHttpServer(client, host = "0.0.0.0", port = 3000) {
     await app.register(swaggerUi, {
         routePrefix: "/docs"
     });
+    app.setErrorHandler((error, _request, reply) => {
+        const status = error.statusCode ?? 500;
+        const message = status >= 500 ? "Internal server error" : error.message;
+        reply.code(status).send({ error: message });
+    });
     app.get("/health", async () => ({ ok: true }));
     app.get("/privacy", async () => ({
         service: "Canvas MCP HTTP API",
@@ -756,5 +819,76 @@ export async function startHttpServer(client, host = "0.0.0.0", port = 3000) {
             results
         };
     });
+    // --- POST /chat ---
+    const ollamaRunner = new AgentRunner(client, tools, process.env.OLLAMA_HOST ?? "http://localhost:11434");
+    const GEMINI_API_KEY = process.env.GEMINI_API_KEY ?? "";
+    const geminiRunner = GEMINI_API_KEY
+        ? new GeminiRunner(GEMINI_API_KEY, client, tools)
+        : null;
+    app.post("/chat", async (request, reply) => {
+        const { message, model, mode, provider = "ollama", gemini_key } = request.body ?? {};
+        if (!message || typeof message !== "string" || !message.trim()) {
+            return reply.code(400).send({ error: "El campo 'message' es requerido." });
+        }
+        if (tools.length === 0) {
+            return reply.code(503).send({ error: "El servidor no tiene herramientas cargadas. Inicia con 'serve-http'." });
+        }
+        if (provider === "gemini") {
+            const apiKey = gemini_key || GEMINI_API_KEY;
+            if (!apiKey) {
+                return reply.code(400).send({ error: "Se necesita gemini_key en el body o GEMINI_API_KEY en el entorno." });
+            }
+            const runner = gemini_key
+                ? new GeminiRunner(gemini_key, client, tools)
+                : geminiRunner;
+            return runner.run(message.trim(), { model });
+        }
+        return ollamaRunner.run(message.trim(), { model, mode });
+    });
+    // --- POST /audit ---
+    const SKILL_PATH = process.env.AUDIT_SKILL_PATH ?? path.resolve(process.env.USERPROFILE ?? process.env.HOME ?? ".", "Proyectos Personales", "material-docente - UIDE", ".claude", "commands", "canvas-module-auditor-uide-v2.md");
+    app.post("/audit", async (request, reply) => {
+        const { course_id, week, course_name, provider = "gemini", model, gemini_key } = request.body ?? {};
+        if (!course_id || !week) {
+            return reply.code(400).send({ error: "course_id y week son requeridos." });
+        }
+        if (tools.length === 0) {
+            return reply.code(503).send({ error: "El servidor no tiene herramientas cargadas." });
+        }
+        // Leer el skill de auditoría
+        let skillContent;
+        try {
+            skillContent = await fs.readFile(SKILL_PATH, "utf-8");
+        }
+        catch {
+            return reply.code(500).send({
+                error: `No se encontró el archivo de skill en: ${SKILL_PATH}. Define AUDIT_SKILL_PATH como variable de entorno.`
+            });
+        }
+        // Construir el mensaje de auditoría
+        const courseLabel = course_name ? `${course_name} (course_id: ${course_id})` : `course_id: ${course_id}`;
+        const auditMessage = `Ejecuta una auditoría instruccional completa de la Semana ${week} del curso ${courseLabel}. ` +
+            `Sigue exactamente el flujo de los pasos 1 al 4 definidos en las instrucciones. ` +
+            `Genera el reporte markdown completo con todas las secciones y la calificación global.`;
+        if (provider === "gemini") {
+            const apiKey = gemini_key || GEMINI_API_KEY;
+            if (!apiKey) {
+                return reply.code(400).send({ error: "Se necesita gemini_key en el body o GEMINI_API_KEY en el entorno." });
+            }
+            const runner = gemini_key
+                ? new GeminiRunner(gemini_key, client, tools)
+                : geminiRunner;
+            const result = await runner.run(auditMessage, {
+                model: model ?? "gemini-2.5-flash",
+                systemPrompt: skillContent
+            });
+            return { ...result, course_id, week };
+        }
+        const result = await ollamaRunner.run(auditMessage, {
+            model,
+            systemPrompt: skillContent
+        });
+        return { ...result, course_id, week };
+    });
     await app.listen({ host, port });
 }

package/dist/index.js

@@ -23,6 +23,11 @@ import { configTools } from "./tools/config-tools.js";
 import { rubricTools } from "./tools/rubric-tools.js";
 import { calendarTools } from "./tools/calendar-tools.js";
 import { groupTools } from "./tools/group-tools.js";
+import { enrollmentTools } from "./tools/enrollment-tools.js";
+import { conversationTools } from "./tools/conversation-tools.js";
+import { newQuizTools } from "./tools/new-quiz-tools.js";
+import { analyticsTools } from "./tools/analytics-tools.js";
+import { peerReviewTools } from "./tools/peer-review-tools.js";
 import { canvasResources } from "./resources/canvas-resources.js";
 import { canvasPrompts } from "./prompts/canvas-prompts.js";
 import { startHttpServer } from "./http-server.js";
@@ -33,7 +38,7 @@ const program = new Command();
 program
     .name("canvas-mcp")
     .description("MCP Server for Canvas LMS (Refactored)")
-    .version("1.1.0");
+    .version("1.2.0");
 // --- CLI Commands ---
 program
     .command("config")
@@ -82,7 +87,7 @@ program
     const client = getClient();
     const server = new Server({
         name: "canvas-lms-server",
-        version: "1.0.0",
+        version: "1.2.0",
     }, {
         capabilities: {
             tools: {},
@@ -105,7 +110,12 @@ program
         ...configTools,
         ...rubricTools,
         ...calendarTools,
-        ...groupTools
+        ...groupTools,
+        ...enrollmentTools,
+        ...conversationTools,
+        ...newQuizTools,
+        ...analyticsTools,
+        ...peerReviewTools
     ];
     // --- Tool Handlers ---
     server.setRequestHandler(ListToolsRequestSchema, async () => {
@@ -163,6 +173,27 @@ program
     .action(async (options) => {
     const client = getClient();
     const port = Number.parseInt(options.port, 10);
-    await startHttpServer(client, options.host, port);
+    const allTools = [
+        ...courseTools,
+        ...assignmentTools,
+        ...quizTools,
+        ...gradingTools,
+        ...communicationTools,
+        ...studentTools,
+        ...quizQuestionTools,
+        ...createTools,
+        ...moduleTools,
+        ...fileTools,
+        ...configTools,
+        ...rubricTools,
+        ...calendarTools,
+        ...groupTools,
+        ...enrollmentTools,
+        ...conversationTools,
+        ...newQuizTools,
+        ...analyticsTools,
+        ...peerReviewTools
+    ];
+    await startHttpServer(client, options.host, port, allTools);
 });
 program.parse(process.argv);

package/dist/services/agent-runner.js

@@ -0,0 +1,214 @@
+import { Ollama } from "ollama";
+// ---------------------------------------------------------------------------
+// Detección de modo
+// ---------------------------------------------------------------------------
+async function detectMode(ollama, model, sampleTool) {
+    try {
+        await ollama.chat({
+            model,
+            messages: [{ role: "user", content: "ping" }],
+            tools: [sampleTool],
+            stream: false
+        });
+        return "native";
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes("does not support tools"))
+            return "prompt";
+        throw err;
+    }
+}
+// ---------------------------------------------------------------------------
+// Parseo de tool calls en texto plano (modo prompt)
+// ---------------------------------------------------------------------------
+function parseTextToolCalls(content) {
+    const results = [];
+    const tagPattern = /<tool_call>\s*([\s\S]*?)\s*<\/tool_call>/g;
+    let match;
+    while ((match = tagPattern.exec(content)) !== null) {
+        try {
+            const parsed = JSON.parse(match[1]);
+            if (parsed.name && parsed.arguments) {
+                results.push({ name: parsed.name, arguments: parsed.arguments });
+            }
+        }
+        catch { /* ignorar */ }
+    }
+    if (results.length > 0)
+        return results;
+    // Fallback: JSON suelto con "name" + "arguments"
+    const jsonPattern = /\{[\s\S]*?"name"\s*:\s*"([^"]+)"[\s\S]*?"arguments"\s*:\s*(\{[\s\S]*?\})\s*\}/g;
+    while ((match = jsonPattern.exec(content)) !== null) {
+        try {
+            results.push({ name: match[1], arguments: JSON.parse(match[2]) });
+        }
+        catch { /* ignorar */ }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// System prompt para modo prompt-engineering
+// ---------------------------------------------------------------------------
+const PROMPT_MODE_TOOLS = [
+    "canvas_list_courses",
+    "canvas_get_assignments",
+    "canvas_get_assignment",
+    "canvas_list_students",
+    "canvas_list_students_with_grades",
+    "canvas_get_student_grades",
+    "canvas_list_modules",
+    "canvas_list_quizzes",
+    "canvas_get_submissions",
+    "canvas_get_submission",
+    "canvas_grade_submission",
+    "canvas_list_announcements",
+    "canvas_list_discussions",
+    "canvas_audit_course",
+    "canvas_list_assignment_groups",
+    "canvas_list_assignment_due_dates",
+    "canvas_grade_multiple_submissions",
+    "canvas_get_submission_comments",
+];
+function buildPromptSystemPrompt(tools) {
+    const selected = tools
+        .filter(t => PROMPT_MODE_TOOLS.includes(t.name))
+        .map(t => ({
+        name: t.tool.name,
+        description: t.tool.description,
+        parameters: t.tool.inputSchema
+    }));
+    return `Eres un asistente educativo con acceso a Canvas LMS.
+Responde SIEMPRE en español. Sé conciso y claro.
+
+Herramientas disponibles:
+${JSON.stringify(selected, null, 2)}
+
+REGLAS:
+1. Para consultar Canvas, responde SOLO con un bloque <tool_call>:
+<tool_call>
+{"name": "nombre_herramienta", "arguments": {"param": "valor"}}
+</tool_call>
+2. No escribas nada más cuando hagas una tool call.
+3. Después de recibir el resultado, responde al usuario en español.
+4. Una herramienta a la vez.`;
+}
+const NATIVE_SYSTEM = "Eres un asistente educativo con acceso a Canvas LMS. " +
+    "Usa las herramientas disponibles para responder sobre cursos, tareas, estudiantes y calificaciones. " +
+    "Responde SIEMPRE en español. Sé conciso y claro.";
+// ---------------------------------------------------------------------------
+// AgentRunner
+// ---------------------------------------------------------------------------
+export class AgentRunner {
+    ollama;
+    tools;
+    client;
+    ollamaTools;
+    constructor(client, tools, ollamaHost = "http://localhost:11434") {
+        this.client = client;
+        this.tools = tools;
+        this.ollama = new Ollama({ host: ollamaHost });
+        this.ollamaTools = tools.map(t => ({
+            type: "function",
+            function: {
+                name: t.tool.name,
+                description: t.tool.description ?? "",
+                parameters: t.tool.inputSchema
+            }
+        }));
+    }
+    async run(userMessage, options = {}) {
+        const modelRaw = options.model ?? "qwen2.5";
+        const modeArg = options.mode ?? "auto";
+        // Resolver nombre del modelo (fallback a :latest)
+        let model = modelRaw;
+        try {
+            await this.ollama.show({ model });
+        }
+        catch {
+            const withLatest = model.includes(":") ? model : `${model}:latest`;
+            try {
+                await this.ollama.show({ model: withLatest });
+                model = withLatest;
+            }
+            catch {
+                throw new Error(`Modelo '${modelRaw}' no encontrado en Ollama. Descárgalo con: ollama pull ${modelRaw}`);
+            }
+        }
+        // Detectar modo
+        let mode;
+        if (modeArg === "auto") {
+            mode = await detectMode(this.ollama, model, this.ollamaTools[0]);
+        }
+        else {
+            mode = modeArg;
+        }
+        const defaultSystem = mode === "prompt"
+            ? buildPromptSystemPrompt(this.tools)
+            : NATIVE_SYSTEM;
+        const messages = [{
+                role: "system",
+                content: options.systemPrompt ?? defaultSystem
+            }];
+        messages.push({ role: "user", content: userMessage });
+        const toolsUsed = [];
+        // Agentic loop (máx. 10 iteraciones para evitar loops infinitos)
+        for (let i = 0; i < 10; i++) {
+            const response = await this.ollama.chat({
+                model,
+                messages,
+                ...(mode === "native" ? { tools: this.ollamaTools } : {}),
+                stream: false
+            });
+            const assistantMessage = response.message;
+            messages.push(assistantMessage);
+            // Extraer tool calls
+            let calls = [];
+            if (mode === "native" && assistantMessage.tool_calls?.length) {
+                calls = assistantMessage.tool_calls.map(tc => ({
+                    name: tc.function.name,
+                    arguments: (tc.function.arguments ?? {})
+                }));
+            }
+            else if (mode === "prompt" && assistantMessage.content) {
+                calls = parseTextToolCalls(assistantMessage.content);
+            }
+            // Sin tool calls → respuesta final
+            if (calls.length === 0) {
+                const answer = (assistantMessage.content ?? "")
+                    .replace(/<tool_call>[\s\S]*?<\/tool_call>/g, "")
+                    .trim();
+                return { answer, tools_used: toolsUsed, model, mode };
+            }
+            // Ejecutar cada herramienta
+            for (const call of calls) {
+                const toolDef = this.tools.find(t => t.name === call.name);
+                let resultText;
+                if (!toolDef) {
+                    resultText = `Error: herramienta '${call.name}' no existe.`;
+                }
+                else {
+                    try {
+                        const result = await toolDef.handler(this.client, call.arguments);
+                        const blocks = result?.content ?? [];
+                        resultText = blocks
+                            .filter((b) => b.type === "text" && b.text)
+                            .map((b) => b.text)
+                            .join("\n");
+                        toolsUsed.push(call.name);
+                    }
+                    catch (err) {
+                        resultText = `Error: ${err instanceof Error ? err.message : String(err)}`;
+                    }
+                }
+                messages.push({
+                    role: mode === "native" ? "tool" : "user",
+                    content: mode === "native"
+                        ? `[${call.name}]\n${resultText}`
+                        : `Resultado de ${call.name}:\n${resultText}`
+                });
+            }
+        }
+        throw new Error("El agente excedió el límite de iteraciones (10).");
+    }
+}