@marcopeg/hal 1.0.11

package/dist/logger.d.ts

@@ -0,0 +1,17 @@
+import pino from "pino";
+import type { ResolvedProjectConfig } from "./config.js";
+/**
+ * A startup logger for CLI-level messages. Always writes to stdout at info level.
+ * Used before per-project loggers are created, and for process-level notices.
+ */
+export declare function createStartupLogger(): pino.Logger;
+/**
+ * Create a per-project logger that respects flow and persist settings.
+ *
+ * - flow: false → no terminal output
+ * - persist: true → append to <logDir>/YYYY-MM-DD.txt
+ *
+ * If both are false/disabled, a no-op stream is used to keep the logger valid.
+ */
+export declare function createProjectLogger(config: ResolvedProjectConfig): pino.Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAAC,MAAM,CAEjD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,qBAAqB,GAC5B,IAAI,CAAC,MAAM,CA4Bb"}

package/dist/logger.js

@@ -0,0 +1,44 @@
+import { createWriteStream, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { Writable } from "node:stream";
+import pino from "pino";
+/**
+ * A startup logger for CLI-level messages. Always writes to stdout at info level.
+ * Used before per-project loggers are created, and for process-level notices.
+ */
+export function createStartupLogger() {
+    return pino({ level: "info" });
+}
+/**
+ * Create a per-project logger that respects flow and persist settings.
+ *
+ * - flow: false → no terminal output
+ * - persist: true → append to <logDir>/YYYY-MM-DD.txt
+ *
+ * If both are false/disabled, a no-op stream is used to keep the logger valid.
+ */
+export function createProjectLogger(config) {
+    const { level, flow, persist } = config.logging;
+    const streams = [];
+    if (flow) {
+        streams.push({ stream: process.stdout });
+    }
+    if (persist) {
+        mkdirSync(config.logDir, { recursive: true });
+        const date = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
+        const logFile = join(config.logDir, `${date}.txt`);
+        streams.push({ stream: createWriteStream(logFile, { flags: "a" }) });
+    }
+    if (streams.length === 0) {
+        // Both flow and persist are off — use a no-op sink so the logger is valid
+        streams.push({
+            stream: new Writable({
+                write(_chunk, _enc, cb) {
+                    cb();
+                },
+            }),
+        });
+    }
+    return pino({ level }, pino.multistream(streams));
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAA6B;IAE7B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;IAEhD,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa;QACjE,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,0EAA0E;QAC1E,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,IAAI,QAAQ,CAAC;gBACnB,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;oBACpB,EAAE,EAAE,CAAC;gBACP,CAAC;aACF,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/telegram/chunker.d.ts

@@ -0,0 +1,10 @@
+import type { Context } from "grammy";
+/**
+ * Split a long message into chunks that fit Telegram's limits
+ */
+export declare function chunkMessage(text: string): string[];
+/**
+ * Send a potentially long response as multiple messages
+ */
+export declare function sendChunkedResponse(ctx: Context, text: string): Promise<void>;
+//# sourceMappingURL=chunker.d.ts.map

package/dist/telegram/chunker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.d.ts","sourceRoot":"","sources":["../../src/telegram/chunker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAqCtC;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAoBnD;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/telegram/chunker.js

@@ -0,0 +1,88 @@
+const TELEGRAM_MAX_LENGTH = 4096;
+/**
+ * Find a safe split point in text, trying to avoid breaking code blocks
+ */
+function findSafeSplitPoint(text, maxLength) {
+    if (text.length <= maxLength) {
+        return text.length;
+    }
+    // Try to find a good split point
+    const searchText = text.slice(0, maxLength);
+    // Try to split at a double newline (paragraph break)
+    const doubleNewline = searchText.lastIndexOf("\n\n");
+    if (doubleNewline > maxLength * 0.5) {
+        return doubleNewline + 2;
+    }
+    // Try to split at a single newline
+    const newline = searchText.lastIndexOf("\n");
+    if (newline > maxLength * 0.5) {
+        return newline + 1;
+    }
+    // Try to split at a space
+    const space = searchText.lastIndexOf(" ");
+    if (space > maxLength * 0.5) {
+        return space + 1;
+    }
+    // Fall back to hard split at max length
+    return maxLength;
+}
+/**
+ * Split a long message into chunks that fit Telegram's limits
+ */
+export function chunkMessage(text) {
+    if (text.length <= TELEGRAM_MAX_LENGTH) {
+        return [text];
+    }
+    const chunks = [];
+    let remaining = text;
+    while (remaining.length > 0) {
+        if (remaining.length <= TELEGRAM_MAX_LENGTH) {
+            chunks.push(remaining);
+            break;
+        }
+        const splitPoint = findSafeSplitPoint(remaining, TELEGRAM_MAX_LENGTH);
+        chunks.push(remaining.slice(0, splitPoint));
+        remaining = remaining.slice(splitPoint);
+    }
+    return chunks;
+}
+/**
+ * Send a potentially long response as multiple messages
+ */
+export async function sendChunkedResponse(ctx, text) {
+    const chunks = chunkMessage(text);
+    for (let i = 0; i < chunks.length; i++) {
+        const chunk = chunks[i];
+        // Add continuation indicator for multi-part messages
+        let messageText = chunk;
+        if (chunks.length > 1) {
+            if (i === 0) {
+                messageText = `${chunk}\n\n_(continued...)_`;
+            }
+            else if (i < chunks.length - 1) {
+                messageText = `_(part ${i + 1})_\n\n${chunk}\n\n_(continued...)_`;
+            }
+            else {
+                messageText = `_(part ${i + 1})_\n\n${chunk}`;
+            }
+        }
+        try {
+            await ctx.reply(messageText, { parse_mode: "Markdown" });
+        }
+        catch {
+            // If Markdown fails, try without parsing
+            try {
+                await ctx.reply(chunk);
+            }
+            catch (_error) {
+                // Last resort: send error message
+                await ctx.reply(`Error sending message part ${i + 1}`);
+            }
+        }
+        // Small delay between chunks to avoid rate limiting
+        if (i < chunks.length - 1) {
+            await new Promise((resolve) => setTimeout(resolve, 500));
+        }
+    }
+}
+//# sourceMappingURL=chunker.js.map

package/dist/telegram/chunker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunker.js","sourceRoot":"","sources":["../../src/telegram/chunker.ts"],"names":[],"mappings":"AAEA,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC;;GAEG;AACH,SAAS,kBAAkB,CAAC,IAAY,EAAE,SAAiB;IACzD,IAAI,IAAI,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,iCAAiC;IACjC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAE5C,qDAAqD;IACrD,MAAM,aAAa,GAAG,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,aAAa,GAAG,SAAS,GAAG,GAAG,EAAE,CAAC;QACpC,OAAO,aAAa,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,mCAAmC;IACnC,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,OAAO,GAAG,SAAS,GAAG,GAAG,EAAE,CAAC;QAC9B,OAAO,OAAO,GAAG,CAAC,CAAC;IACrB,CAAC;IAED,0BAA0B;IAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,KAAK,GAAG,SAAS,GAAG,GAAG,EAAE,CAAC;QAC5B,OAAO,KAAK,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,wCAAwC;IACxC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,IAAI,CAAC,MAAM,IAAI,mBAAmB,EAAE,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,SAAS,GAAG,IAAI,CAAC;IAErB,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,SAAS,CAAC,MAAM,IAAI,mBAAmB,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvB,MAAM;QACR,CAAC;QAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QAC5C,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAY,EACZ,IAAY;IAEZ,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAExB,qDAAqD;QACrD,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACZ,WAAW,GAAG,GAAG,KAAK,sBAAsB,CAAC;YAC/C,CAAC;iBAAM,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,KAAK,sBAAsB,CAAC;YACpE,CAAC;iBAAM,CAAC;gBACN,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,KAAK,EAAE,CAAC;YAChD,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;YACzC,IAAI,CAAC;gBACH,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC;gBAChB,kCAAkC;gBAClC,MAAM,GAAG,CAAC,KAAK,CAAC,8BAA8B,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,oDAAoD;QACpD,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/telegram/fileSender.d.ts

@@ -0,0 +1,8 @@
+import type { Context } from "grammy";
+import type { ProjectContext } from "../types.js";
+/**
+ * Send all files from the user's downloads folder and delete them after sending.
+ * Returns the number of files sent.
+ */
+export declare function sendDownloadFiles(gramCtx: Context, userDir: string, ctx: ProjectContext): Promise<number>;
+//# sourceMappingURL=fileSender.d.ts.map

package/dist/telegram/fileSender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSender.d.ts","sourceRoot":"","sources":["../../src/telegram/fileSender.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,MAAM,CAAC,CA8CjB"}

package/dist/telegram/fileSender.js

@@ -0,0 +1,46 @@
+import { readdir, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { InputFile } from "grammy";
+import { getDownloadsPath } from "../user/setup.js";
+/**
+ * Send all files from the user's downloads folder and delete them after sending.
+ * Returns the number of files sent.
+ */
+export async function sendDownloadFiles(gramCtx, userDir, ctx) {
+    const { logger } = ctx;
+    const downloadsPath = getDownloadsPath(userDir);
+    let files;
+    try {
+        files = await readdir(downloadsPath);
+    }
+    catch {
+        // Directory doesn't exist or can't be read
+        return 0;
+    }
+    if (files.length === 0) {
+        return 0;
+    }
+    let sentCount = 0;
+    for (const fileName of files) {
+        const filePath = join(downloadsPath, fileName);
+        try {
+            // Send the file
+            await gramCtx.replyWithDocument(new InputFile(filePath, fileName));
+            logger.info({ fileName }, "Sent file to user");
+            // Delete the file after successful send
+            await unlink(filePath);
+            logger.debug({ fileName }, "Deleted sent file");
+            sentCount++;
+        }
+        catch (error) {
+            logger.error({ error, fileName }, "Failed to send file, keeping it for retry");
+            // Don't delete on failure - keep for potential retry
+        }
+        // Small delay between files to avoid rate limiting
+        if (sentCount < files.length) {
+            await new Promise((resolve) => setTimeout(resolve, 500));
+        }
+    }
+    return sentCount;
+}
+//# sourceMappingURL=fileSender.js.map

package/dist/telegram/fileSender.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSender.js","sourceRoot":"","sources":["../../src/telegram/fileSender.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAgB,EAChB,OAAe,EACf,GAAmB;IAEnB,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IACvB,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEhD,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;QAC3C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;QAE/C,IAAI,CAAC;YACH,gBAAgB;YAChB,MAAM,OAAO,CAAC,iBAAiB,CAAC,IAAI,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;YACnE,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,mBAAmB,CAAC,CAAC;YAE/C,wCAAwC;YACxC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YACvB,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,EAAE,mBAAmB,CAAC,CAAC;YAEhD,SAAS,EAAE,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CACV,EAAE,KAAK,EAAE,QAAQ,EAAE,EACnB,2CAA2C,CAC5C,CAAC;YACF,qDAAqD;QACvD,CAAC;QAED,mDAAmD;QACnD,IAAI,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/transcription/whisper.d.ts

@@ -0,0 +1,11 @@
+import type { ProjectContext } from "../types.js";
+export interface TranscriptionResult {
+    text: string;
+    language?: string;
+    duration?: number;
+}
+/**
+ * Transcribe audio file using local Whisper model
+ */
+export declare function transcribeAudio(audioPath: string, ctx: ProjectContext): Promise<TranscriptionResult>;
+//# sourceMappingURL=whisper.d.ts.map

package/dist/transcription/whisper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whisper.d.ts","sourceRoot":"","sources":["../../src/transcription/whisper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkBlD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,mBAAmB,CAAC,CAiD9B"}

package/dist/transcription/whisper.js

@@ -0,0 +1,58 @@
+import { existsSync } from "node:fs";
+// Dynamic import for optional dependency
+let whisperModule = null;
+async function getWhisper() {
+    if (!whisperModule) {
+        try {
+            whisperModule = await import("nodejs-whisper");
+        }
+        catch {
+            throw new Error("nodejs-whisper is not installed. Run: pnpm add nodejs-whisper");
+        }
+    }
+    return whisperModule;
+}
+/**
+ * Transcribe audio file using local Whisper model
+ */
+export async function transcribeAudio(audioPath, ctx) {
+    const { config, logger } = ctx;
+    if (!existsSync(audioPath)) {
+        throw new Error(`Audio file not found: ${audioPath}`);
+    }
+    const whisper = await getWhisper();
+    const modelName = config.transcription?.model ?? "base.en";
+    logger.debug({ audioPath, model: modelName }, "Starting transcription");
+    const startTime = Date.now();
+    try {
+        const transcript = await whisper.nodewhisper(audioPath, {
+            modelName,
+            autoDownloadModelName: modelName,
+            removeWavFileAfterTranscription: false,
+            withCuda: false,
+            whisperOptions: {
+                outputInText: true,
+                language: "auto",
+            },
+            logger: {
+                debug: (message) => logger.debug(message),
+                error: (message) => logger.error(message),
+                log: (message) => logger.info(message),
+            },
+        });
+        const duration = (Date.now() - startTime) / 1000;
+        const text = Array.isArray(transcript)
+            ? transcript.map((t) => t.speech).join(" ")
+            : String(transcript);
+        logger.debug({ duration: `${duration.toFixed(2)}s`, textLength: text.length }, "Transcription complete");
+        return {
+            text: text.trim(),
+            duration,
+        };
+    }
+    catch (error) {
+        logger.error({ error, audioPath }, "Transcription failed");
+        throw error;
+    }
+}
+//# sourceMappingURL=whisper.js.map

package/dist/transcription/whisper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whisper.js","sourceRoot":"","sources":["../../src/transcription/whisper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,yCAAyC;AACzC,IAAI,aAAa,GAA2C,IAAI,CAAC;AAEjE,KAAK,UAAU,UAAU;IACvB,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,aAAa,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,+DAA+D,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAQD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAiB,EACjB,GAAmB;IAEnB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAE/B,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,yBAAyB,SAAS,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,EAAE,KAAK,IAAI,SAAS,CAAC;IAE3D,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,wBAAwB,CAAC,CAAC;IAExE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE;YACtD,SAAS;YACT,qBAAqB,EAAE,SAAS;YAChC,+BAA+B,EAAE,KAAK;YACtC,QAAQ,EAAE,KAAK;YACf,cAAc,EAAE;gBACd,YAAY,EAAE,IAAI;gBAClB,QAAQ,EAAE,MAAM;aACjB;YACD,MAAM,EAAE;gBACN,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;gBACjD,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;gBACjD,GAAG,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;aAC/C;SACF,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;QACjD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;YACpC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAC3C,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAEvB,MAAM,CAAC,KAAK,CACV,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,EAChE,wBAAwB,CACzB,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YACjB,QAAQ;SACT,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,sBAAsB,CAAC,CAAC;QAC3D,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,22 @@
+import type pino from "pino";
+import type { ResolvedProjectConfig } from "./config.js";
+import type { BootContext } from "./context/resolver.js";
+/**
+ * Engine-agnostic interface for making one-shot AI calls from command handlers.
+ * The underlying provider (Claude Code, Codex, etc.) is an implementation detail.
+ */
+export interface Agent {
+    call(prompt: string, options?: {
+        onProgress?: (message: string) => void;
+    }): Promise<string>;
+}
+/**
+ * Per-project context object threaded through all bot internals.
+ * Replaces the former global singletons (getConfig / getLogger).
+ */
+export interface ProjectContext {
+    config: ResolvedProjectConfig;
+    logger: pino.Logger;
+    bootContext: BootContext;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,CACF,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GACnD,OAAO,CAAC,MAAM,CAAC,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/user/setup.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Initialize a new user directory
+ * Creates uploads and downloads folders - Claude config is read from working directory
+ */
+export declare function ensureUserSetup(userDir: string): Promise<void>;
+/**
+ * Clear a user's directory (for /clear command)
+ */
+export declare function clearUserData(userDir: string): Promise<void>;
+/**
+ * Get the path to user's uploads directory
+ */
+export declare function getUploadsPath(userDir: string): string;
+/**
+ * Get the path to user's downloads directory (for sending files to user)
+ */
+export declare function getDownloadsPath(userDir: string): string;
+/**
+ * Save session ID for a user
+ */
+export declare function saveSessionId(userDir: string, sessionId: string): Promise<void>;
+/**
+ * Get saved session ID for a user
+ */
+export declare function getSessionId(userDir: string): Promise<string | null>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/user/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/user/setup.ts"],"names":[],"mappings":"AAoBA;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWpE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAIf;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS1E"}

package/dist/user/setup.js

@@ -0,0 +1,73 @@
+import { constants } from "node:fs";
+import { access, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * Check if a directory exists
+ */
+async function directoryExists(path) {
+    try {
+        await access(path, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Initialize a new user directory
+ * Creates uploads and downloads folders - Claude config is read from working directory
+ */
+export async function ensureUserSetup(userDir) {
+    const uploadsDir = join(userDir, "uploads");
+    const downloadsDir = join(userDir, "downloads");
+    // Create user directory, uploads and downloads folders
+    if (!(await directoryExists(uploadsDir))) {
+        await mkdir(uploadsDir, { recursive: true });
+    }
+    if (!(await directoryExists(downloadsDir))) {
+        await mkdir(downloadsDir, { recursive: true });
+    }
+}
+/**
+ * Clear a user's directory (for /clear command)
+ */
+export async function clearUserData(userDir) {
+    if (await directoryExists(userDir)) {
+        await rm(userDir, { recursive: true, force: true });
+    }
+}
+/**
+ * Get the path to user's uploads directory
+ */
+export function getUploadsPath(userDir) {
+    return join(userDir, "uploads");
+}
+/**
+ * Get the path to user's downloads directory (for sending files to user)
+ */
+export function getDownloadsPath(userDir) {
+    return join(userDir, "downloads");
+}
+/**
+ * Save session ID for a user
+ */
+export async function saveSessionId(userDir, sessionId) {
+    const sessionFile = join(userDir, "session.json");
+    const sessionData = { currentSessionId: sessionId };
+    await writeFile(sessionFile, JSON.stringify(sessionData, null, 2), "utf-8");
+}
+/**
+ * Get saved session ID for a user
+ */
+export async function getSessionId(userDir) {
+    const sessionFile = join(userDir, "session.json");
+    try {
+        const content = await readFile(sessionFile, "utf-8");
+        const sessionData = JSON.parse(content);
+        return sessionData.currentSessionId || null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/user/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/user/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAMjC;;GAEG;AACH,KAAK,UAAU,eAAe,CAAC,IAAY;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAEhD,uDAAuD;IACvD,IAAI,CAAC,CAAC,MAAM,eAAe,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,eAAe,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,IAAI,MAAM,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,SAAiB;IAEjB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAClD,MAAM,WAAW,GAAgB,EAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC;IACjE,MAAM,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAe;IAChD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,WAAW,GAAgB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO,WAAW,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@marcopeg/hal",
+  "version": "1.0.11",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "hal": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "packageManager": "pnpm@10.13.1",
+  "scripts": {
+    "start": "tsx watch src/cli.ts start --cwd examples",
+    "build": "tsc && chmod +x dist/cli.js",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src",
+    "lint:fix": "biome check --write src",
+    "prepublishOnly": "pnpm run build",
+    "prepare": "husky",
+    "deploy": "npm version patch && npm publish --access public"
+  },
+  "keywords": [
+    "telegram",
+    "claude",
+    "bot",
+    "ai",
+    "assistant"
+  ],
+  "author": "",
+  "license": "ISC",
+  "description": "Telegram bot that invokes Claude Code as a personal assistant",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "dependencies": {
+    "chokidar": "^5.0.0",
+    "dotenv": "^17.2.3",
+    "grammy": "^1.39.2",
+    "nodejs-whisper": "^0.2.9",
+    "pino": "^10.2.0",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.11",
+    "@types/node": "^25.0.8",
+    "husky": "^9.1.7",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}