utn-mcp 0.8.2 → 0.9.0

package/build/aula-virtual/client/types.d.ts

@@ -0,0 +1,173 @@
+export interface SiteInfo {
+    sitename: string;
+    username: string;
+    fullname: string;
+    userid: number;
+    release: string;
+    functions: {
+        name: string;
+        version: string;
+    }[];
+}
+export interface Course {
+    id: number;
+    shortname: string;
+    fullname: string;
+    visible: number;
+    progress?: number | null;
+    lastaccess?: number | null;
+}
+export interface CourseModuleContent {
+    type: "file" | "url" | "content";
+    filename: string;
+    filepath: string | null;
+    filesize: number;
+    fileurl: string;
+    timemodified: number | null;
+    mimetype?: string;
+}
+export interface CourseModule {
+    id: number;
+    name: string;
+    modname: string;
+    /** id del plugin, no del módulo: es lo que piden las funciones mod_* (p. ej. forumid). */
+    instance: number;
+    url?: string;
+    description?: string;
+    uservisible: boolean;
+    availabilityinfo?: string;
+    dates?: {
+        label: string;
+        timestamp: number;
+    }[];
+    contents?: CourseModuleContent[];
+}
+export interface CourseSection {
+    id: number;
+    name: string;
+    section: number;
+    summary: string;
+    uservisible?: boolean;
+    modules: CourseModule[];
+}
+export interface ForumDiscussion {
+    /** id de la discusión; es el que pide mod_forum_get_discussion_posts. */
+    discussion: number;
+    subject: string;
+    message: string;
+    userfullname: string;
+    created: number;
+    timemodified: number;
+    numreplies: number;
+    userid: number;
+    pinned: boolean;
+    attachment: boolean;
+}
+export interface ForumPost {
+    id: number;
+    subject: string;
+    /** El asunto que Moodle propone para responderla ("Re: ..."). */
+    replysubject: string;
+    message: string;
+    author: {
+        id: number;
+        fullname: string;
+    };
+    timecreated: number;
+    parentid: number | null;
+    isdeleted: boolean;
+    capabilities: {
+        reply: boolean;
+        edit: boolean;
+        delete: boolean;
+    };
+    attachments: {
+        filename: string;
+        fileurl: string;
+        filesize: number;
+        mimetype?: string;
+    }[];
+}
+export interface MoodleFile {
+    filename: string;
+    filepath?: string | null;
+    filesize: number;
+    fileurl: string;
+    mimetype?: string;
+    timemodified?: number | null;
+}
+/** Un plugin de entrega o de devolución: archivos (`fileareas`) o texto (`editorfields`). */
+export interface AssignPlugin {
+    type: string;
+    name: string;
+    fileareas?: {
+        area: string;
+        files?: MoodleFile[];
+    }[];
+    editorfields?: {
+        name: string;
+        text: string;
+        format: number;
+    }[];
+}
+export interface AssignSubmission {
+    status: "new" | "draft" | "submitted" | "reopened" | string;
+    timemodified: number;
+    plugins?: AssignPlugin[];
+}
+export interface AssignSubmissionStatus {
+    lastattempt?: {
+        submission?: AssignSubmission;
+        /** En las entregas grupales la que cuenta es esta, no la individual. */
+        teamsubmission?: AssignSubmission;
+        locked: boolean;
+        graded: boolean;
+        canedit: boolean;
+        cansubmit: boolean;
+        extensionduedate: number | null;
+        gradingstatus: string;
+    };
+    feedback?: {
+        gradefordisplay?: string;
+        gradeddate?: number;
+        plugins?: AssignPlugin[];
+    };
+}
+export interface Assignment {
+    id: number;
+    cmid: number;
+    duedate: number;
+    cutoffdate: number;
+    allowsubmissionsfromdate: number;
+    /** 1: la entrega queda en borrador hasta que se confirma el envío. */
+    submissiondrafts: number;
+    requiresubmissionstatement: number;
+    /** HTML de la declaración que hay que aceptar al enviar; solo viene si se pide. */
+    submissionstatement?: string;
+    teamsubmission: number;
+    maxattempts: number;
+    configs: {
+        plugin: string;
+        subtype: string;
+        name: string;
+        value: string;
+    }[];
+}
+export interface Choice {
+    id: number;
+    coursemodule: number;
+    allowupdate: boolean;
+    allowmultiple: boolean;
+    timeopen: number;
+    timeclose: number;
+}
+export interface ChoiceOption {
+    id: number;
+    /** En choice es el texto de la opción; en choicegroup viene en `name`. */
+    text?: string;
+    name?: string;
+    maxanswers?: number;
+    countanswers?: number;
+    checked?: boolean;
+    disabled?: boolean;
+}

package/build/aula-virtual/format/actions.d.ts

@@ -0,0 +1,57 @@
+import type { AulaSession } from "../client/session.js";
+/**
+ * Con la dirección de un foro abre un hilo; con la de una discusión responde. Así el modelo no elige
+ * entre dos operaciones: la dirección que ya tiene dice cuál es.
+ */
+export declare function postToForum(session: AulaSession, rawAddress: string, message: string, subject?: string, replyTo?: number): Promise<{
+    publicado: string;
+    direccion: string;
+    id?: undefined;
+    respuestaA?: undefined;
+} | {
+    publicado: string;
+    direccion: string;
+    id: number;
+    respuestaA: number;
+}>;
+export declare function editForumPost(session: AulaSession, rawAddress: string, postId: number, message: string, subject?: string): Promise<{
+    editado: boolean;
+    direccion: string;
+    id: number;
+}>;
+export declare function deleteForumPost(session: AulaSession, rawAddress: string, postId: number): Promise<{
+    borrado: boolean;
+    id: number;
+    discusionBorrada: true | undefined;
+    direccion: string | undefined;
+}>;
+/** Deja elegidas exactamente `optionIds`; vacío borra la respuesta. Devuelve cómo quedó. */
+export declare function answerChoice(session: AulaSession, rawAddress: string, optionIds: number[]): Promise<{
+    elegidas: number[];
+    aviso: string | undefined;
+    opciones: {
+        id: number;
+        texto: string | undefined;
+        elegida: true | undefined;
+        deshabilitada: true | undefined;
+        cupo: number | undefined;
+        anotados: number | undefined;
+    }[];
+}>;
+export declare function sendMessage(session: AulaSession, userId: number, message: string): Promise<{
+    enviado: boolean;
+    para: string;
+}>;
+export declare function addCalendarEvent(session: AulaSession, event: {
+    name: string;
+    start: string;
+    durationMinutes?: number;
+    description?: string;
+}): Promise<{
+    creado: boolean;
+    id: number;
+    nombre: string;
+    inicio: string | null;
+    fin: string | null | undefined;
+    url: string;
+}>;

package/build/aula-virtual/format/activities.d.ts

@@ -0,0 +1,86 @@
+import type { AulaSession } from "../client/session.js";
+import type { ChoiceOption, CourseModule } from "../client/types.js";
+/** La entrega del usuario (o la de su grupo): qué acepta la tarea, qué subió y la devolución si la hay. */
+export declare function viewSubmission(session: AulaSession, courseId: number, module: CourseModule): Promise<{
+    estado: string;
+    grupal: true | undefined;
+    modificada: string | undefined;
+    abre: string | undefined;
+    vence: string | undefined;
+    prorroga: string | undefined;
+    cierreDefinitivo: string | undefined;
+    acepta: ({
+        tipo: string;
+        maximo: number | undefined;
+        tamanioMaximo: number | undefined;
+        extensiones: string | undefined;
+        limitePalabras?: undefined;
+    } | {
+        maximo?: undefined;
+        tamanioMaximo?: undefined;
+        extensiones?: undefined;
+        tipo: string;
+        limitePalabras: number | undefined;
+    })[] | undefined;
+    requiereConfirmarEnvio: true | undefined;
+    requiereDeclaracion: true | undefined;
+    declaracion: string | undefined;
+    puedeEditar: boolean;
+    puedeEnviar: true | undefined;
+    bloqueada: true | undefined;
+    devolucion: {
+        calificacion: string | undefined;
+        fecha: string | null;
+        archivos: {
+            nombre: string;
+            ruta: string | undefined;
+            tamanio: number;
+            mimetype: string | undefined;
+            modificado: string | null;
+            url: string;
+        }[] | undefined;
+        texto: string | undefined;
+    } | undefined;
+    archivos: {
+        nombre: string;
+        ruta: string | undefined;
+        tamanio: number;
+        mimetype: string | undefined;
+        modificado: string | null;
+        url: string;
+    }[] | undefined;
+    texto: string | undefined;
+}>;
+export declare function viewChoice(session: AulaSession, courseId: number, module: CourseModule): Promise<{
+    multiple: true | undefined;
+    puedeCambiar: boolean | undefined;
+    abre: string | undefined;
+    cierra: string | undefined;
+    opciones: {
+        id: number;
+        texto: string | undefined;
+        elegida: true | undefined;
+        deshabilitada: true | undefined;
+        cupo: number | undefined;
+        anotados: number | undefined;
+    }[];
+}>;
+/** El plugin no expone si deja cambiar o elegir varios grupos: eso lo dice la descripción o el error al elegir. */
+export declare function viewChoicegroup(session: AulaSession, module: CourseModule): Promise<{
+    opciones: {
+        id: number;
+        texto: string | undefined;
+        elegida: true | undefined;
+        deshabilitada: true | undefined;
+        cupo: number | undefined;
+        anotados: number | undefined;
+    }[];
+}>;
+export declare function toOption(o: ChoiceOption): {
+    id: number;
+    texto: string | undefined;
+    elegida: true | undefined;
+    deshabilitada: true | undefined;
+    cupo: number | undefined;
+    anotados: number | undefined;
+};

package/build/aula-virtual/format/address.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Direcciones de navegación del aula: un path que el modelo recibe en una respuesta
+ * y devuelve tal cual para entrar ahí. No hay estado en el servidor; la dirección
+ * dice todo lo necesario, y el padre se deduce del texto (eso es el "volver").
+ */
+export declare const AddressLevel: {
+    readonly Root: "root";
+    readonly Course: "course";
+    readonly Module: "module";
+    readonly Discussion: "discussion";
+};
+export type AddressLevel = (typeof AddressLevel)[keyof typeof AddressLevel];
+export type Address = {
+    level: "root";
+} | {
+    level: "course";
+    courseId: number;
+} | {
+    level: "module";
+    courseId: number;
+    cmid: number;
+} | {
+    level: "discussion";
+    courseId: number;
+    cmid: number;
+    discussionId: number;
+};
+export declare const ROOT = "/";
+export declare const courseAddr: (courseId: number) => string;
+export declare const moduleAddr: (courseId: number, cmid: number) => string;
+export declare const discussionAddr: (courseId: number, cmid: number, discussionId: number) => string;
+export declare function parseAddress(raw: string): Address;
+/** La dirección en texto, tal como la ve el modelo. */
+export declare function formatAddress(address: Address): string;
+/** La dirección de un nivel más arriba, o null si ya estamos en la raíz. */
+export declare function parentOf(address: Address): string | null;

package/build/aula-virtual/format/address.js

@@ -1,3 +1,14 @@
+/**
+ * Direcciones de navegación del aula: un path que el modelo recibe en una respuesta
+ * y devuelve tal cual para entrar ahí. No hay estado en el servidor; la dirección
+ * dice todo lo necesario, y el padre se deduce del texto (eso es el "volver").
+ */
+export const AddressLevel = {
+    Root: "root",
+    Course: "course",
+    Module: "module",
+    Discussion: "discussion",
+};
 export const ROOT = "/";
 export const courseAddr = (courseId) => `/curso/${courseId}`;
 export const moduleAddr = (courseId, cmid) => `/curso/${courseId}/mod/${cmid}`;

package/build/aula-virtual/format/fields.d.ts

@@ -0,0 +1,11 @@
+import type { MoodleFile } from "../client/types.js";
+/** Los timestamps de Moodle (segundos) en ISO; 0 o vacío es "sin fecha". */
+export declare const isoDate: (seconds: number | null | undefined) => string | null;
+export declare function toFile(f: MoodleFile): {
+    nombre: string;
+    ruta: string | undefined;
+    tamanio: number;
+    mimetype: string | undefined;
+    modificado: string | null;
+    url: string;
+};

package/build/aula-virtual/format/files.d.ts

@@ -0,0 +1,32 @@
+import { type Part } from "../../shared/documents/index.js";
+import type { AulaSession } from "../client/session.js";
+/** El más grande que hay hoy en los cursos pesa 12 MB. */
+export declare const MAX_BYTES: number;
+/**
+ * Moodle devuelve las URLs del web service, que piden token. Al usuario le sirve la misma ruta sin
+ * `/webservice`, que se abre con la sesión de su navegador. Es la única que mostramos: el token no
+ * sale nunca del servidor. `fileurl` viene de Moodle: ya es del aula del usuario.
+ */
+export declare function userFacingUrl(fileurl: string): string;
+/**
+ * Acepta cualquiera de las dos formas y devuelve la del web service. Solo archivos del aula del
+ * usuario (`baseUrl`): con cualquier otra URL estaríamos mandando su token a donde diga el modelo.
+ */
+export declare function downloadUrl(baseUrl: string, url: string): URL;
+/** Lo que ve el modelo de una lectura (las claves van en castellano) más las partes leídas. */
+export interface FileRead {
+    archivo: string;
+    formato: string;
+    unidad: string;
+    total: number;
+    desde: number;
+    hasta: number;
+    /** El `desde` para pedir lo que sigue; no está si ya se leyó todo. */
+    siguiente?: number;
+    urlParaUsuario: string;
+    parts: (Part & {
+        number: number;
+    })[];
+}
+/** Baja un archivo del aula y devuelve desde la parte `from` tantas como entren en el presupuesto. */
+export declare function readAulaFile(session: AulaSession, url: string, from?: number): Promise<FileRead>;

package/build/aula-virtual/format/files.js

@@ -7,7 +7,7 @@ const BUDGET_CHARS = 30_000;
 /** Lo que cuesta una página como imagen (~1.600 tokens), medido en caracteres de texto. */
 const IMAGE_COST_CHARS = 6_000;
 /** El más grande que hay hoy en los cursos pesa 12 MB. */
-const MAX_BYTES = 30 * 1024 * 1024;
+export const MAX_BYTES = 30 * 1024 * 1024;
 /**
  * Moodle devuelve las URLs del web service, que piden token. Al usuario le sirve la misma ruta sin
  * `/webservice`, que se abre con la sesión de su navegador. Es la única que mostramos: el token no
@@ -32,7 +32,7 @@ export function userFacingUrl(fileurl) {
  * Acepta cualquiera de las dos formas y devuelve la del web service. Solo archivos del aula del
  * usuario (`baseUrl`): con cualquier otra URL estaríamos mandando su token a donde diga el modelo.
  */
-function downloadUrl(baseUrl, url) {
+export function downloadUrl(baseUrl, url) {
     let u;
     try {
         u = new URL(url);

package/build/aula-virtual/format/navigate.d.ts

@@ -0,0 +1,213 @@
+import type { AulaSession } from "../client/session.js";
+import type { CourseModule } from "../client/types.js";
+/**
+ * Entra a una dirección del aula y devuelve su contenido, el padre y las direcciones de lo que hay
+ * adentro. Es el único lugar que decide qué ve el modelo y cuánto texto le cuesta.
+ */
+export declare function open(session: AulaSession, rawAddress: string, page?: number): Promise<{
+    direccion: string;
+    padre: string | null;
+    cursos: {
+        direccion: string;
+        id: number;
+        nombre: string;
+        nombreCorto: string;
+        visible: boolean;
+        progreso: number | null;
+        ultimoAcceso: string | null;
+    }[];
+} | {
+    direccion: string;
+    padre: string | null;
+    secciones: {
+        nombre: string;
+        numero: number;
+        resumen: string | undefined;
+        modulos: {
+            direccion: string;
+            id: number;
+            nombre: string;
+            tipo: string;
+            url: string | undefined;
+            descripcion: string | undefined;
+            restriccion: string | undefined;
+            fechas: {
+                etiqueta: string;
+                fecha: string | null;
+            }[] | undefined;
+            archivos: {
+                nombre: string;
+                ruta: string | undefined;
+                tamanio: number;
+                mimetype: string | undefined;
+                modificado: string | null;
+                url: string;
+            }[] | undefined;
+            enlaces: string[] | undefined;
+        }[];
+    }[];
+} | {
+    direccion: string;
+    padre: string | null;
+    seccion: string;
+    modulo: {
+        direccion: string;
+        id: number;
+        nombre: string;
+        tipo: string;
+        url: string | undefined;
+        descripcion: string | undefined;
+        restriccion: string | undefined;
+        fechas: {
+            etiqueta: string;
+            fecha: string | null;
+        }[] | undefined;
+        archivos: {
+            nombre: string;
+            ruta: string | undefined;
+            tamanio: number;
+            mimetype: string | undefined;
+            modificado: string | null;
+            url: string;
+        }[] | undefined;
+        enlaces: string[] | undefined;
+    };
+} | {
+    direccion: string;
+    padre: string | null;
+    seccion: string;
+    modulo: {
+        direccion: string;
+        id: number;
+        nombre: string;
+        tipo: string;
+        url: string | undefined;
+        descripcion: string | undefined;
+        restriccion: string | undefined;
+        fechas: {
+            etiqueta: string;
+            fecha: string | null;
+        }[] | undefined;
+        archivos: {
+            nombre: string;
+            ruta: string | undefined;
+            tamanio: number;
+            mimetype: string | undefined;
+            modificado: string | null;
+            url: string;
+        }[] | undefined;
+        enlaces: string[] | undefined;
+    };
+    entrega: {
+        estado: string;
+        grupal: true | undefined;
+        modificada: string | undefined;
+        abre: string | undefined;
+        vence: string | undefined;
+        prorroga: string | undefined;
+        cierreDefinitivo: string | undefined;
+        acepta: ({
+            tipo: string;
+            maximo: number | undefined;
+            tamanioMaximo: number | undefined;
+            extensiones: string | undefined;
+            limitePalabras?: undefined;
+        } | {
+            maximo?: undefined;
+            tamanioMaximo?: undefined;
+            extensiones?: undefined;
+            tipo: string;
+            limitePalabras: number | undefined;
+        })[] | undefined;
+        requiereConfirmarEnvio: true | undefined;
+        requiereDeclaracion: true | undefined;
+        declaracion: string | undefined;
+        puedeEditar: boolean;
+        puedeEnviar: true | undefined;
+        bloqueada: true | undefined;
+        devolucion: {
+            calificacion: string | undefined;
+            fecha: string | null;
+            archivos: {
+                nombre: string;
+                ruta: string | undefined;
+                tamanio: number;
+                mimetype: string | undefined;
+                modificado: string | null;
+                url: string;
+            }[] | undefined;
+            texto: string | undefined;
+        } | undefined;
+        archivos: {
+            nombre: string;
+            ruta: string | undefined;
+            tamanio: number;
+            mimetype: string | undefined;
+            modificado: string | null;
+            url: string;
+        }[] | undefined;
+        texto: string | undefined;
+    };
+} | {
+    direccion: string;
+    padre: string | null;
+    seccion: string;
+    modulo: {
+        direccion: string;
+        id: number;
+        nombre: string;
+        tipo: string;
+        url: string | undefined;
+        descripcion: string | undefined;
+        restriccion: string | undefined;
+        fechas: {
+            etiqueta: string;
+            fecha: string | null;
+        }[] | undefined;
+        archivos: {
+            nombre: string;
+            ruta: string | undefined;
+            tamanio: number;
+            mimetype: string | undefined;
+            modificado: string | null;
+            url: string;
+        }[] | undefined;
+        enlaces: string[] | undefined;
+    };
+    eleccion: {
+        opciones: {
+            id: number;
+            texto: string | undefined;
+            elegida: true | undefined;
+            deshabilitada: true | undefined;
+            cupo: number | undefined;
+            anotados: number | undefined;
+        }[];
+    };
+} | {
+    direccion: string;
+    padre: string | null;
+    asunto: string;
+    publicaciones: {
+        autor: string;
+        autorId: number;
+        fecha: string | null;
+        respuestaA: number | undefined;
+        id: number;
+        mensaje: string;
+        adjuntos: {
+            nombre: string;
+            ruta: string | undefined;
+            tamanio: number;
+            mimetype: string | undefined;
+            modificado: string | null;
+            url: string;
+        }[] | undefined;
+        acciones: (string | false)[] | undefined;
+    }[];
+}>;
+/** Ubica un módulo por su cmid y se queda con la sección que lo contiene. */
+export declare function findModule(session: AulaSession, courseId: number, cmid: number): Promise<{
+    sectionName: string;
+    module: CourseModule;
+}>;

package/build/aula-virtual/format/study-pack.d.ts

@@ -0,0 +1,33 @@
+import type { AulaSession } from "../client/session.js";
+/**
+ * Escribe el pack sin pisar packs anteriores: nombre con fecha-hora y, si ya existe (dos packs
+ * en el mismo segundo), un sufijo -2, -3... La escritura es atómica por nombre (bandera "wx").
+ */
+export declare function writePackFile(dir: string, courseName: string, bytes: Uint8Array): Promise<string>;
+/**
+ * Baja PDF de un curso y los une en un solo archivo con índice, guardado en exportsDir().
+ * Con `archivos` une solo las URL pedidas (tal como las devuelve aula_open, validadas con
+ * `downloadUrl` como en aula_read_file); sin `archivos`, todos los PDF del curso. El pack sigue
+ * el orden del aula, no el de la lista, para que el índice acompañe las unidades. Los duplicados
+ * exactos se descartan al armar, porque ahí se bajan igual. Todo lo omitido queda listado en
+ * `omitidos` con el motivo; en el atajo sin `archivos`, los archivos que no son PDF solo se
+ * cuentan en `archivosNoPdf` en vez de listarse uno por uno.
+ */
+export declare function buildStudyPack(session: AulaSession, rawAddress: string, archivos?: string[]): Promise<{
+    archivo: string;
+    curso: string;
+    paginas: number;
+    materiales: {
+        nombre: string;
+        seccion: string;
+        modulo: string;
+        paginas: number;
+        empiezaEn: number;
+    }[];
+    omitidos: {
+        nombre: string;
+        seccion: string;
+        motivo: string;
+    }[] | undefined;
+    archivosNoPdf: number | undefined;
+}>;