@mo7yw4ng/openape 1.0.0 → 1.0.2

package/esm/src/commands/skills.js

@@ -0,0 +1,110 @@
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+const SKILL_NAME = "openape";
+const GITHUB_RAW_URL = `https://raw.githubusercontent.com/mo7yw4ng/openape/refs/heads/main/skills/${SKILL_NAME}/SKILL.md`;
+/**
+ * Known agent platforms and their skills directories
+ */
+const PLATFORMS = {
+    claude: { name: "Claude Code", path: path.join(os.homedir(), ".claude", "skills") },
+    codex: { name: "Codex CLI", path: path.join(os.homedir(), ".codex", "skills") },
+    opencode: { name: "OpenCode", path: path.join(os.homedir(), ".opencode", "skills") },
+};
+/**
+ * Try to read SKILL.md from local project first (dev mode / bundled build),
+ * fallback to fetching from GitHub (when installed globally via npm).
+ */
+async function readSkillContent() {
+    // Try local path first (relative to this file's location)
+    try {
+        const base = path.dirname(new URL(globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).url).pathname);
+        const normalized = process.platform === "win32" ? base.replace(/^\//, "") : base;
+        // When running from source: src/commands/ → ../../skills/openape/SKILL.md
+        // When bundled by dnt into build/: esm/commands/ or script/ → ../../skills/openape/SKILL.md
+        const localPath = path.resolve(normalized, "..", "..", "skills", SKILL_NAME, "SKILL.md");
+        if (fs.existsSync(localPath)) {
+            return fs.readFileSync(localPath, "utf-8");
+        }
+    }
+    catch {
+        // import.meta.url may be unavailable in some environments
+    }
+    // Fallback: fetch from GitHub
+    const res = await fetch(GITHUB_RAW_URL, { headers: { "User-Agent": "openape-cli" } });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch skill from GitHub: ${res.status} ${res.statusText}`);
+    }
+    return res.text();
+}
+export function registerSkillsCommand(program) {
+    const skills = program
+        .command("skills")
+        .description("Manage OpenApe skills for AI agents");
+    skills
+        .command("install [platform]")
+        .description("Install the OpenApe skill to an agent platform (claude, codex, opencode)")
+        .option("--all", "Detect installed agents and install to all")
+        .action(async (platform, opts) => {
+        try {
+            let targets = [];
+            if (opts?.all) {
+                for (const [key, info] of Object.entries(PLATFORMS)) {
+                    const parentDir = path.dirname(info.path);
+                    if (fs.existsSync(parentDir)) {
+                        targets.push({ key, ...info });
+                    }
+                }
+                if (targets.length === 0) {
+                    console.log("No supported agents detected. Supported platforms: " + Object.keys(PLATFORMS).join(", "));
+                    return;
+                }
+            }
+            else if (platform) {
+                const info = PLATFORMS[platform.toLowerCase()];
+                if (!info) {
+                    console.error(`Unknown platform: ${platform}`);
+                    console.error(`Supported platforms: ${Object.keys(PLATFORMS).join(", ")}`);
+                    process.exitCode = 1;
+                    return;
+                }
+                targets = [{ key: platform.toLowerCase(), ...info }];
+            }
+            else {
+                console.error("Specify a platform or use --all.");
+                console.error(`Example: openape skills install claude`);
+                process.exitCode = 1;
+                return;
+            }
+            console.log(`Fetching ${SKILL_NAME} skill...`);
+            const content = await readSkillContent();
+            for (const target of targets) {
+                console.log(`Installing to ${target.name} (${target.path})...`);
+                const destDir = path.join(target.path, SKILL_NAME);
+                if (!fs.existsSync(destDir)) {
+                    fs.mkdirSync(destDir, { recursive: true });
+                }
+                fs.writeFileSync(path.join(destDir, "SKILL.md"), content, "utf-8");
+                console.log(`  \x1b[32m✔\x1b[0m ${SKILL_NAME} installed!`);
+            }
+            console.log("\nDone!");
+        }
+        catch (err) {
+            console.error(`\x1b[31mFailed to install skill: ${err.message}\x1b[0m`);
+            process.exitCode = 1;
+        }
+    });
+    skills
+        .command("show")
+        .description("Print the raw SKILL.md content")
+        .action(async () => {
+        try {
+            const content = await readSkillContent();
+            process.stdout.write(content);
+        }
+        catch (err) {
+            console.error(`\x1b[31mFailed: ${err.message}\x1b[0m`);
+            process.exitCode = 1;
+        }
+    });
+}

package/esm/src/commands/videos.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function registerVideosCommand(program: Command): void;
+//# sourceMappingURL=videos.d.ts.map

package/esm/src/commands/videos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"videos.d.ts","sourceRoot":"","sources":["../../../src/src/commands/videos.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuV5D"}

package/esm/src/commands/videos.js

@@ -0,0 +1,302 @@
+import { getBaseDir } from "../lib/utils.js";
+import { getEnrolledCourses, getSupervideosInCourse, getSupervideosInCourseApi, getVideoMetadata, completeVideo, downloadVideo } from "../lib/moodle.js";
+import { createLogger } from "../lib/logger.js";
+import { launchAuthenticated } from "../lib/auth.js";
+import { extractSessionInfo } from "../lib/session.js";
+import { closeBrowserSafely } from "../lib/auth.js";
+import { formatAndOutput } from "../index.js";
+import { loadWsToken } from "../lib/token.js";
+import path from "node:path";
+import fs from "node:fs";
+export function registerVideosCommand(program) {
+    const videosCmd = program.command("videos");
+    videosCmd.description("Video progress operations");
+    // Helper to get output format from global or local options
+    function getOutputFormat(command) {
+        const opts = command.optsWithGlobals();
+        return opts.output || "json";
+    }
+    // Pure API context - no browser required (fast!)
+    async function createApiContext(options, command) {
+        const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
+        const outputFormat = getOutputFormat(command || { optsWithGlobals: () => ({ output: "json" }) });
+        const silent = outputFormat === "json" && !opts.verbose;
+        const log = createLogger(opts.verbose, silent);
+        const baseDir = getBaseDir();
+        const sessionPath = path.resolve(baseDir, ".auth", "storage-state.json");
+        // Check if session exists
+        if (!fs.existsSync(sessionPath)) {
+            log.error("未找到登入 session。請先執行 'openape auth login' 進行登入。");
+            log.info(`Session 預期位置: ${sessionPath}`);
+            return null;
+        }
+        // Try to load WS token
+        const wsToken = loadWsToken(sessionPath);
+        if (!wsToken) {
+            log.error("未找到 WS token。請先執行 'openape auth login' 進行登入。");
+            return null;
+        }
+        return {
+            log,
+            session: {
+                wsToken,
+                moodleBaseUrl: "https://ilearning.cycu.edu.tw",
+            },
+        };
+    }
+    // Helper function to create session context (for browser-only commands)
+    async function createSessionContext(options, command) {
+        const opts = command?.optsWithGlobals ? command.optsWithGlobals() : options;
+        const outputFormat = getOutputFormat(command || { optsWithGlobals: () => ({ output: "json" }) });
+        const silent = outputFormat === "json" && !opts.verbose;
+        const log = createLogger(opts.verbose, silent);
+        const baseDir = getBaseDir();
+        const sessionPath = path.resolve(baseDir, ".auth", "storage-state.json");
+        if (!fs.existsSync(sessionPath)) {
+            log.error("未找到登入 session。請先執行 'openape auth login' 進行登入。");
+            return null;
+        }
+        const config = {
+            username: "",
+            password: "",
+            courseUrl: "",
+            moodleBaseUrl: "https://ilearning.cycu.edu.tw",
+            headless: !options.headed,
+            slowMo: 0,
+            authStatePath: sessionPath,
+            ollamaBaseUrl: "",
+        };
+        log.info("啟動瀏覽器...");
+        const { browser, context, page } = await launchAuthenticated(config, log);
+        try {
+            const session = await extractSessionInfo(page, config, log);
+            return { log, page, session, browser, context };
+        }
+        catch (err) {
+            await context.close();
+            await browser.close();
+            throw err;
+        }
+    }
+    videosCmd
+        .command("list")
+        .description("List videos in a course")
+        .argument("<course-id>", "Course ID")
+        .option("--incomplete-only", "Show only incomplete videos")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (courseId, options, command) => {
+        const output = getOutputFormat(command);
+        const apiContext = await createApiContext(options, command);
+        if (!apiContext) {
+            process.exitCode = 1;
+            return;
+        }
+        const videos = await getSupervideosInCourseApi(apiContext.session, parseInt(courseId, 10));
+        // Note: API doesn't provide completion status, so --incomplete-only shows all
+        if (options.incompleteOnly) {
+            apiContext.log.warn("--incomplete-only is not supported in API mode, showing all videos");
+        }
+        formatAndOutput(videos, output, apiContext.log);
+    });
+    videosCmd
+        .command("complete")
+        .description("Complete videos in a course (requires browser)")
+        .argument("<course-id>", "Course ID")
+        .option("--dry-run", "Discover videos but don't complete them")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (courseId, options, command) => {
+        const context = await createSessionContext(options, command);
+        if (!context) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, page, session, browser, context: browserContext } = context;
+        const output = getOutputFormat(command);
+        try {
+            const videos = await getSupervideosInCourse(page, session, parseInt(courseId, 10), log, {
+                incompleteOnly: true, // Only operate on incomplete videos
+            });
+            if (videos.length === 0) {
+                log.info("所有影片已完成（或無影片）。");
+                return;
+            }
+            const results = [];
+            for (const sv of videos) {
+                log.info(`處理中: ${sv.name}`);
+                try {
+                    const video = await getVideoMetadata(page, sv.url, log);
+                    if (options.dryRun) {
+                        log.info(`  [試執行] viewId=${video.viewId}, duration=${video.duration}s`);
+                        results.push({ name: sv.name, success: true });
+                        continue;
+                    }
+                    const success = await completeVideo(page, session, { ...video, cmid: sv.cmid }, log);
+                    if (success) {
+                        log.success(`  已完成！`);
+                        results.push({ name: sv.name, success: true });
+                    }
+                    else {
+                        log.error(`  失敗。`);
+                        results.push({ name: sv.name, success: false, error: "Failed to complete" });
+                    }
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    log.error(`  錯誤: ${msg}`);
+                    results.push({ name: sv.name, success: false, error: msg });
+                }
+            }
+            const completed = results.filter(r => r.success).length;
+            const failed = results.filter(r => !r.success).length;
+            log.info(`\n執行結果: ${completed} 成功, ${failed} 失敗`);
+            if (output !== "silent") {
+                formatAndOutput(results, output, log);
+            }
+        }
+        finally {
+            await closeBrowserSafely(browser, browserContext);
+        }
+    });
+    videosCmd
+        .command("complete-all")
+        .description("Complete all incomplete videos across all courses (requires browser)")
+        .option("--dry-run", "Discover videos but don't complete them")
+        .option("--output <format>", "Output format: json|csv|table|silent")
+        .action(async (options, command) => {
+        const context = await createSessionContext(options, command);
+        if (!context) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, page, session, browser, context: browserContext } = context;
+        const output = getOutputFormat(command);
+        try {
+            const courses = await getEnrolledCourses(page, session, log);
+            const allResults = [];
+            let totalVideos = 0;
+            let totalCompleted = 0;
+            let totalFailed = 0;
+            for (const course of courses) {
+                log.info(`\n======================================`);
+                log.info(`課程: ${course.fullname}`);
+                log.info(`======================================`);
+                const videos = await getSupervideosInCourse(page, session, course.id, log);
+                if (videos.length === 0) {
+                    log.info("  所有影片已完成（或無影片）。");
+                    continue;
+                }
+                totalVideos += videos.length;
+                for (const sv of videos) {
+                    log.info(`  處理中: ${sv.name}`);
+                    try {
+                        const video = await getVideoMetadata(page, sv.url, log);
+                        if (options.dryRun) {
+                            log.info(`    [試執行] viewId=${video.viewId}, duration=${video.duration}s`);
+                            allResults.push({ courseName: course.fullname, name: sv.name, success: true });
+                            continue;
+                        }
+                        const success = await completeVideo(page, session, { ...video, cmid: sv.cmid }, log);
+                        if (success) {
+                            log.success(`    已完成！`);
+                            allResults.push({ courseName: course.fullname, name: sv.name, success: true });
+                            totalCompleted++;
+                        }
+                        else {
+                            log.error(`    失敗。`);
+                            allResults.push({ courseName: course.fullname, name: sv.name, success: false, error: "Failed to complete" });
+                            totalFailed++;
+                        }
+                    }
+                    catch (err) {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        log.error(`    錯誤: ${msg}`);
+                        allResults.push({ courseName: course.fullname, name: sv.name, success: false, error: msg });
+                        totalFailed++;
+                    }
+                }
+            }
+            log.info("\n===== 執行結果 =====");
+            log.info(`掃描課程數: ${courses.length}`);
+            log.info(`掃描影片數: ${totalVideos}`);
+            log.info(`執行影片數: ${totalCompleted}`);
+            if (totalFailed > 0)
+                log.warn(`失敗影片數: ${totalFailed}`);
+            if (output !== "silent") {
+                formatAndOutput(allResults, output, log);
+            }
+        }
+        finally {
+            await closeBrowserSafely(browser, browserContext);
+        }
+    });
+    // Helper function to sanitize filename
+    function sanitizeFilename(name) {
+        return name
+            .replace(/[<>:"/\\|?*]/g, "_")
+            .replace(/\s+/g, "_")
+            .substring(0, 200);
+    }
+    videosCmd
+        .command("download")
+        .description("Download videos from a course (requires browser)")
+        .argument("<course-id>", "Course ID")
+        .option("--output-dir <path>", "Output directory", "./downloads/videos")
+        .option("--incomplete-only", "Download only incomplete videos")
+        .action(async (courseId, options, command) => {
+        const context = await createSessionContext(options, command);
+        if (!context) {
+            process.exitCode = 1;
+            return;
+        }
+        const { log, page, session, browser, context: browserContext } = context;
+        try {
+            const videos = await getSupervideosInCourse(page, session, parseInt(courseId, 10), log, {
+                incompleteOnly: options.incompleteOnly,
+            });
+            log.info(`找到 ${videos.length} 個影片`);
+            const baseDir = getBaseDir();
+            const outputDir = path.resolve(baseDir, options.outputDir);
+            fs.mkdirSync(outputDir, { recursive: true });
+            const downloaded = [];
+            for (const video of videos) {
+                const filename = sanitizeFilename(video.name) + ".mp4";
+                const outputPath = path.join(outputDir, filename);
+                log.info(`處理中: ${video.name}`);
+                try {
+                    const metadata = await getVideoMetadata(page, video.url, log);
+                    const result = await downloadVideo(page, metadata, outputPath, log);
+                    if (result.success) {
+                        log.success(`  已下載: ${result.path}`);
+                        downloaded.push({ name: video.name, path: result.path, success: true, type: result.type });
+                    }
+                    else {
+                        log.warn(`  失敗: ${result.error}`);
+                        downloaded.push({ name: video.name, path: "", success: false, error: result.error, type: result.type });
+                    }
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    log.error(`  錯誤: ${msg}`);
+                    downloaded.push({ name: video.name, path: "", success: false, error: msg });
+                }
+            }
+            const completed = downloaded.filter(d => d.success).length;
+            const failed = downloaded.filter(d => !d.success).length;
+            log.info(`\n執行結果: ${completed} 成功, ${failed} 失敗`);
+            const output = {
+                status: "success",
+                timestamp: new Date().toISOString(),
+                course_id: courseId,
+                output_dir: outputDir,
+                total_videos: videos.length,
+                downloaded: completed,
+                failed,
+                videos: downloaded,
+            };
+            console.log(JSON.stringify(output));
+        }
+        finally {
+            await closeBrowserSafely(browser, browserContext);
+        }
+    });
+}

package/esm/src/index.d.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import "../_dnt.polyfills.js";
+import { createLogger } from "./lib/logger.js";
+import type { AppConfig, Logger, SessionInfo, OutputFormat } from "./lib/types.js";
+/**
+ * Create a session context for commands that need authentication.
+ */
+export declare function createSessionContext(options: {
+    config?: string;
+    session?: string;
+    verbose?: boolean;
+    silent?: boolean;
+    headed?: boolean;
+    interactive?: boolean;
+}): Promise<{
+    config: AppConfig;
+    log: Logger;
+    page: import("playwright-core").Page;
+    session: SessionInfo;
+} | null>;
+/**
+ * Helper to output formatted data.
+ * For JSON output (agent mode), exits immediately after output.
+ */
+export declare function formatAndOutput<T extends Record<string, unknown>>(data: T | T[], format: OutputFormat, log: Logger): void;
+export { createLogger, type AppConfig, type Logger, type SessionInfo, type OutputFormat };
+//# sourceMappingURL=index.d.ts.map

package/esm/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/src/index.ts"],"names":[],"mappings":";AACA,OAAO,sBAAsB,CAAC;AAO9B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAoEnF;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,OAAO,CAAC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,CAAC,CAoBhH;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EACb,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,GACV,IAAI,CAmBN;AA2CD,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,CAAC"}

package/esm/src/index.js

@@ -0,0 +1,149 @@
+#!/usr/bin/env node
+import "../_dnt.polyfills.js";
+import { getBaseDir } from "./lib/utils.js";
+import { Command } from "commander";
+import { loadConfig } from "./lib/config.js";
+import { launchAuthenticated } from "./lib/auth.js";
+import { extractSessionInfo } from "./lib/session.js";
+import { createLogger } from "./lib/logger.js";
+import denoJson from "../deno.js";
+// Import command handlers
+import { registerCoursesCommand } from "./commands/courses.js";
+import { registerVideosCommand } from "./commands/videos.js";
+import { registerQuizzesCommand } from "./commands/quizzes.js";
+import { registerAuthCommand } from "./commands/auth.js";
+import { registerMaterialsCommand } from "./commands/materials.js";
+import { registerGradesCommand } from "./commands/grades.js";
+import { registerForumsCommand } from "./commands/forums.js";
+import { registerAnnouncementsCommand } from "./commands/announcements.js";
+import { registerCalendarCommand } from "./commands/calendar.js";
+import { registerSkillsCommand } from "./commands/skills.js";
+const program = new Command();
+program
+    .name("openape")
+    .description(denoJson.description)
+    .version(denoJson.version);
+// Global options
+program
+    .option("--config <path>", "Custom config file path")
+    .option("--session <path>", "Session file path", ".auth/storage-state.json")
+    .option("--output <format>", "Output format: json|csv|table|silent", "json")
+    .option("--verbose", "Enable debug logging")
+    .option("--silent", "Suppress all log output (JSON only)")
+    .option("--headed", "Run browser in visible mode");
+// Register subcommands
+registerAuthCommand(program);
+registerCoursesCommand(program);
+registerVideosCommand(program);
+registerQuizzesCommand(program);
+registerMaterialsCommand(program);
+registerGradesCommand(program);
+registerForumsCommand(program);
+registerAnnouncementsCommand(program);
+registerCalendarCommand(program);
+registerSkillsCommand(program);
+/**
+ * Load configuration and authenticate, returning the context for commands.
+ */
+async function createCommandContext(options) {
+    const log = createLogger(options.verbose, options.silent);
+    const baseDir = getBaseDir();
+    const config = loadConfig(baseDir);
+    // Apply CLI overrides
+    if (options.headed)
+        config.headless = false;
+    if (options.session)
+        config.authStatePath = options.session;
+    return { config, log };
+}
+/**
+ * Create a session context for commands that need authentication.
+ */
+export async function createSessionContext(options) {
+    const context = await createCommandContext(options);
+    if (!context)
+        return null;
+    const { config, log } = context;
+    log.info("啟動瀏覽器...");
+    const { browser, context: browserContext, page, wsToken } = await launchAuthenticated(config, log);
+    try {
+        const session = await extractSessionInfo(page, config, log, wsToken);
+        // Keep the browser context alive for the duration of the command
+        // Note: Caller is responsible for closing the browser
+        return { config, log, page, session };
+    }
+    catch (err) {
+        await browserContext.close();
+        await browser.close();
+        throw err;
+    }
+}
+/**
+ * Helper to output formatted data.
+ * For JSON output (agent mode), exits immediately after output.
+ */
+export function formatAndOutput(data, format, log) {
+    if (format === "json") {
+        console.log(JSON.stringify(data));
+        // Exit immediately for AI agent - no need to wait for browser cleanup
+        process.exit(0);
+    }
+    else if (format === "csv") {
+        const arr = Array.isArray(data) ? data : [data];
+        if (arr.length === 0)
+            return;
+        const fields = Object.keys(arr[0]);
+        console.log(formatAsCsv(arr, fields));
+    }
+    else if (format === "table") {
+        const arr = Array.isArray(data) ? data : [data];
+        if (arr.length === 0) {
+            console.log("No data");
+            return;
+        }
+        console.log(formatAsTable(arr));
+    }
+    // "silent" produces no output
+}
+function formatAsCsv(data, fields) {
+    const headers = fields.join(",");
+    const rows = data.map((item) => {
+        return fields.map((field) => {
+            const value = item[field];
+            if (value === null || value === undefined)
+                return "";
+            if (typeof value === "string") {
+                if (value.includes(",") || value.includes('"') || value.includes("\n")) {
+                    return `"${value.replace(/"/g, '""')}"`;
+                }
+                return value;
+            }
+            return String(value);
+        }).join(",");
+    });
+    return [headers, ...rows].join("\n");
+}
+function formatAsTable(data) {
+    const allFields = Array.from(new Set(data.flatMap((item) => Object.keys(item))));
+    const widths = {};
+    allFields.forEach((field) => {
+        widths[field] = Math.max(field.length, ...data.map((item) => String(item[field] ?? "").length)) + 2;
+    });
+    const header = allFields.map((f) => f.padEnd(widths[f])).join(" | ");
+    const separator = allFields.map((f) => "-".repeat(widths[f] - 1)).join("-+-");
+    const rows = data.map((item) => {
+        return allFields.map((f) => String(item[f] ?? "").padEnd(widths[f])).join(" | ");
+    });
+    return [header, separator, ...rows].join("\n");
+}
+// Export utilities for commands
+export { createLogger };
+// Run the program
+if (globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).main) {
+    // If no subcommand provided, show help
+    const args = process.argv.slice(2);
+    if (args.length === 0) {
+        program.help();
+    }
+    program.parse();
+}

package/esm/src/lib/auth.d.ts

@@ -0,0 +1,25 @@
+import { type Browser, type BrowserContext, type Page } from "playwright-core";
+import type { AppConfig, Logger } from "./types.js";
+/**
+ * Find a Chromium-based browser executable on Windows.
+ * Priority: Edge → Chrome → Brave
+ */
+export declare function findEdgePath(): string;
+/**
+ * Launch a browser and return an authenticated context.
+ * Tries to restore a saved session first; falls back to fresh OAuth login.
+ * Also acquires Moodle Web Service Token for API calls.
+ */
+export declare function launchAuthenticated(config: AppConfig, log: Logger): Promise<{
+    browser: Browser;
+    context: BrowserContext;
+    page: Page;
+    wsToken?: string;
+}>;
+/**
+ * Safely close browser and context with timeout.
+ * Designed for AI agent usage - no human interaction needed.
+ * If noWait is true, initiates cleanup but doesn't wait for completion.
+ */
+export declare function closeBrowserSafely(browser: Browser, context?: BrowserContext, timeoutMs?: number, noWait?: boolean): Promise<void>;
+//# sourceMappingURL=auth.d.ts.map

package/esm/src/lib/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/src/lib/auth.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGpD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAuBrC;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA4DtF;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,cAAc,EACxB,SAAS,GAAE,MAAa,EACxB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,IAAI,CAAC,CA4Bf"}