@chozzz/vargos 2.0.3

package/dist/lib/heartbeat.js

@@ -0,0 +1,62 @@
+/**
+ * Heartbeat utilities — pure functions for heartbeat poll logic
+ */
+/**
+ * Returns true if HEARTBEAT.md content has no actionable tasks.
+ * Skips blank lines, markdown headers, empty list items, and HTML comments.
+ */
+export function isHeartbeatContentEffectivelyEmpty(content) {
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        if (trimmed.startsWith('#'))
+            continue;
+        if (trimmed === '-' || trimmed === '- [ ]')
+            continue;
+        if (trimmed.startsWith('<!--') && trimmed.endsWith('-->'))
+            continue;
+        return false;
+    }
+    return true;
+}
+// Matches HEARTBEAT_OK with optional markdown wrapping (bold, backtick, strikethrough)
+const HEARTBEAT_TOKEN_RE = /(?:\*{1,2}|`|~~)?HEARTBEAT_OK(?:\*{1,2}|`|~~)?/g;
+/**
+ * Strip HEARTBEAT_OK token from response text.
+ * Returns null if the entire response was only the token (signal to skip delivery).
+ * Returns cleaned text otherwise.
+ */
+export function stripHeartbeatToken(text) {
+    const stripped = text.replace(HEARTBEAT_TOKEN_RE, '').trim();
+    if (!stripped)
+        return null;
+    return stripped;
+}
+function currentHourInZone(timeZone) {
+    const parts = new Intl.DateTimeFormat('en-GB', {
+        timeZone,
+        hour: 'numeric',
+        hour12: false,
+    }).formatToParts(new Date());
+    const hourPart = parts.find(p => p.type === 'hour');
+    return parseInt(hourPart?.value ?? '0', 10);
+}
+/**
+ * Check if the current hour is within active hours.
+ * Returns true if no config (always active).
+ * Supports overnight ranges (e.g. 22→6).
+ *
+ * @param activeHours [startHour, endHour] (0–23). Interpreted in `timeZone` when set, else UTC.
+ */
+export function isWithinActiveHours(activeHours, timeZone) {
+    if (!activeHours)
+        return true;
+    const [start, end] = activeHours;
+    const hour = timeZone ? currentHourInZone(timeZone) : new Date().getUTCHours();
+    if (start <= end)
+        return hour >= start && hour < end;
+    // Overnight: e.g. [22, 6] → active 22:00→06:00
+    return hour >= start || hour < end;
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/lib/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../lib/heartbeat.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,UAAU,kCAAkC,CAAC,OAAe;IAChE,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACtC,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,OAAO;YAAE,SAAS;QACrD,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uFAAuF;AACvF,MAAM,kBAAkB,GAAG,iDAAiD,CAAC;AAE7E;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7D,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QAC7C,QAAQ;QACR,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,KAAK;KACd,CAAC,CAAC,aAAa,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACpD,OAAO,QAAQ,CAAC,QAAQ,EAAE,KAAK,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAA8B,EAC9B,QAAiB;IAEjB,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC;IACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/E,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,IAAI,IAAI,KAAK,IAAI,IAAI,GAAG,GAAG,CAAC;IACrD,+CAA+C;IAC/C,OAAO,IAAI,IAAI,KAAK,IAAI,IAAI,GAAG,GAAG,CAAC;AACrC,CAAC"}

package/dist/lib/html.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared HTML utilities backed by turndown.
+ * - stripHtml: simple tag stripping (for link expansion)
+ * - htmlToMarkdown: proper conversion preserving links, headings, lists (for web.fetch)
+ */
+export declare function htmlToMarkdown(html: string): string;
+export declare function stripHtml(html: string): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/lib/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../lib/html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY9C"}

package/dist/lib/html.js

@@ -0,0 +1,28 @@
+/**
+ * Shared HTML utilities backed by turndown.
+ * - stripHtml: simple tag stripping (for link expansion)
+ * - htmlToMarkdown: proper conversion preserving links, headings, lists (for web.fetch)
+ */
+import TurndownService from 'turndown';
+const turndown = new TurndownService({ headingStyle: 'atx', bulletListMarker: '-' });
+turndown.remove(['script', 'style', 'noscript']);
+export function htmlToMarkdown(html) {
+    const titleMatch = html.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
+    const title = titleMatch?.[1]?.trim();
+    const text = turndown.turndown(html).replace(/\n{3,}/g, '\n\n').trim();
+    return title ? `# ${title}\n\n${text}` : text;
+}
+export function stripHtml(html) {
+    return html
+        .replace(/<(script|style)[^>]*>[\s\S]*?<\/\1>/gi, ' ')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&nbsp;/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+//# sourceMappingURL=html.js.map

package/dist/lib/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../lib/html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,eAAe,MAAM,UAAU,CAAC;AAEvC,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;AACrF,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AAEjD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACvE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI;SACR,OAAO,CAAC,uCAAuC,EAAE,GAAG,CAAC;SACrD,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/lib/http-validate.d.ts

@@ -0,0 +1,12 @@
+/** HTTP response validation utilities */
+export interface HttpResponse {
+    ok: boolean;
+    status: number;
+    statusText?: string;
+}
+/**
+ * Validate HTTP response and throw with formatted error message.
+ * Extracts method/URL context from error message if available.
+ */
+export declare function validateHttpResponse(res: HttpResponse, context: string): void;
+//# sourceMappingURL=http-validate.d.ts.map

package/dist/lib/http-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-validate.d.ts","sourceRoot":"","sources":["../../lib/http-validate.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAEzC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,MAAM,GACd,IAAI,CAIN"}

package/dist/lib/http-validate.js

@@ -0,0 +1,11 @@
+/** HTTP response validation utilities */
+/**
+ * Validate HTTP response and throw with formatted error message.
+ * Extracts method/URL context from error message if available.
+ */
+export function validateHttpResponse(res, context) {
+    if (!res.ok) {
+        throw new Error(`${context} failed: ${res.status} ${res.statusText || 'error'}`);
+    }
+}
+//# sourceMappingURL=http-validate.js.map

package/dist/lib/http-validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-validate.js","sourceRoot":"","sources":["../../lib/http-validate.ts"],"names":[],"mappings":"AAAA,yCAAyC;AAQzC;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAiB,EACjB,OAAe;IAEf,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,YAAY,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,IAAI,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;AACH,CAAC"}

package/dist/lib/id.d.ts

@@ -0,0 +1,3 @@
+/** Generate a short unique ID with a prefix: `prefix-timestamp-random` */
+export declare function generateId(prefix: string): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/lib/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../lib/id.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/lib/id.js

@@ -0,0 +1,5 @@
+/** Generate a short unique ID with a prefix: `prefix-timestamp-random` */
+export function generateId(prefix) {
+    return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`;
+}
+//# sourceMappingURL=id.js.map

package/dist/lib/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../lib/id.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC"}

package/dist/lib/logger.d.ts

@@ -0,0 +1,12 @@
+import type { Bus } from '../gateway/bus.js';
+import type { Json } from '../gateway/events.js';
+/** Called once by LogService.boot() to wire the global logger to the bus. */
+export declare function setLoggerBus(bus: Bus): void;
+export declare function ts(): string;
+export declare function createLogger(service: string): {
+    debug: (msg: string, data?: Json) => void;
+    info: (msg: string, data?: Json) => void;
+    warn: (msg: string, data?: Json) => void;
+    error: (msg: string, data?: Json) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/lib/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../lib/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAIjD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAE3C;AAED,wBAAgB,EAAE,IAAI,MAAM,CAK3B;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM;iBAU3B,MAAM,SAAS,IAAI;gBACnB,MAAM,SAAS,IAAI;gBACnB,MAAM,SAAS,IAAI;iBACnB,MAAM,SAAS,IAAI;EAEnC"}

package/dist/lib/logger.js

@@ -0,0 +1,28 @@
+let _bus = null;
+/** Called once by LogService.boot() to wire the global logger to the bus. */
+export function setLoggerBus(bus) {
+    _bus = bus;
+}
+export function ts() {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ` +
+        `${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}.${Math.floor(d.getMilliseconds() / 100)}`;
+}
+export function createLogger(service) {
+    function write(level, message, data) {
+        if (_bus) {
+            _bus.emit('log.onLog', { level, service, message, ...(data !== undefined ? { data } : {}) });
+        }
+        else {
+            console.error(`${ts()} [${service}] ${level.toUpperCase()} ${message}`, data ?? '');
+        }
+    }
+    return {
+        debug: (msg, data) => write('debug', msg, data),
+        info: (msg, data) => write('info', msg, data),
+        warn: (msg, data) => write('warn', msg, data),
+        error: (msg, data) => write('error', msg, data),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/lib/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../lib/logger.ts"],"names":[],"mappings":"AAGA,IAAI,IAAI,GAAe,IAAI,CAAC;AAE5B,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,GAAQ;IACnC,IAAI,GAAG,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,EAAE;IAChB,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG;QAClE,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;AACvH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,SAAS,KAAK,CAAC,KAA0C,EAAE,OAAe,EAAE,IAAW;QACrF,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/F,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,KAAK,OAAO,KAAK,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,CAAC,GAAW,EAAE,IAAW,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;QAC9D,IAAI,EAAG,CAAC,GAAW,EAAE,IAAW,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAG,GAAG,EAAE,IAAI,CAAC;QAC9D,IAAI,EAAG,CAAC,GAAW,EAAE,IAAW,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAG,GAAG,EAAE,IAAI,CAAC;QAC9D,KAAK,EAAE,CAAC,GAAW,EAAE,IAAW,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;KAC/D,CAAC;AACJ,CAAC"}

package/dist/lib/media-transcribe.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Media utilities — constants and helpers for file operations
+ *
+ * Transcription is implemented in MediaService via the media.transcribeAudio bus event.
+ * Image vision APIs can be added to MediaService as needed.
+ */
+export declare const WHISPER_EXTS: Set<string>;
+export declare const MIME_TO_AUDIO_EXT: Record<string, string>;
+export declare const MIME_EXT: Record<string, string>;
+export declare const MEDIA_TYPE_MIME_DEFAULTS: Record<string, string>;
+export declare const EXT_TO_MIME: Record<string, string>;
+export declare const IMAGE_MIMES: {
+    readonly 'image/jpeg': true;
+    readonly 'image/png': true;
+    readonly 'image/gif': true;
+    readonly 'image/webp': true;
+    readonly 'image/bmp': true;
+    readonly 'image/svg+xml': true;
+};
+export declare const AUDIO_MIMES: {
+    readonly 'audio/ogg': true;
+    readonly 'audio/mpeg': true;
+    readonly 'audio/mp4': true;
+    readonly 'audio/wav': true;
+    readonly 'audio/webm': true;
+    readonly 'audio/flac': true;
+    readonly 'audio/x-m4a': true;
+    readonly 'audio/mp3': true;
+};
+export declare const VIDEO_MIMES: {
+    readonly 'video/mp4': true;
+};
+export declare const DOCUMENT_MIMES: {
+    readonly 'text/plain': true;
+    readonly 'text/markdown': true;
+    readonly 'application/pdf': true;
+    readonly 'application/vnd.openxmlformats-officedocument.wordprocessingml.document': true;
+    readonly 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': true;
+};
+export type ImageMimeType = keyof typeof IMAGE_MIMES;
+export type AudioMimeType = keyof typeof AUDIO_MIMES;
+export type VideoMimeType = keyof typeof VIDEO_MIMES;
+export type DocumentMimeType = keyof typeof DOCUMENT_MIMES;
+/**
+ * Get file extension for MIME type
+ */
+export declare function extFromMime(mimeType: string): string;
+/**
+ * Get MIME type from file extension
+ */
+export declare function getMimeTypeFromExt(ext: string): string;
+/**
+ * Normalize API base URL by removing trailing /v1 (or /v1/)
+ * Supports both formats: 'https://api.openai.com' and 'https://api.openai.com/v1'
+ */
+export declare function normalizeApiBaseUrl(baseUrl?: string): string;
+//# sourceMappingURL=media-transcribe.d.ts.map

package/dist/lib/media-transcribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-transcribe.d.ts","sourceRoot":"","sources":["../../lib/media-transcribe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,eAAO,MAAM,YAAY,aAAgG,CAAC;AAG1H,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIpD,CAAC;AAGF,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAY3C,CAAC;AAGF,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK3D,CAAC;AAGF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAS9C,CAAC;AAGF,eAAO,MAAM,WAAW;;;;;;;CAOd,CAAC;AAEX,eAAO,MAAM,WAAW;;;;;;;;;CASd,CAAC;AAEX,eAAO,MAAM,WAAW;;CAEd,CAAC;AAEX,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,WAAW,CAAC;AACrD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,WAAW,CAAC;AACrD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,WAAW,CAAC;AACrD,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,cAAc,CAAC;AAE3D;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5D"}

package/dist/lib/media-transcribe.js

@@ -0,0 +1,98 @@
+/**
+ * Media utilities — constants and helpers for file operations
+ *
+ * Transcription is implemented in MediaService via the media.transcribeAudio bus event.
+ * Image vision APIs can be added to MediaService as needed.
+ */
+// Supported audio extensions for Whisper API
+export const WHISPER_EXTS = new Set(['.flac', '.m4a', '.mp3', '.mp4', '.mpeg', '.mpga', '.oga', '.ogg', '.wav', '.webm']);
+// MIME type to audio extension mapping
+export const MIME_TO_AUDIO_EXT = {
+    'audio/ogg': '.ogg', 'audio/mpeg': '.mp3', 'audio/mp4': '.m4a',
+    'audio/wav': '.wav', 'audio/webm': '.webm', 'audio/flac': '.flac',
+    'audio/x-m4a': '.m4a', 'audio/mp3': '.mp3',
+};
+// MIME type to file extension mapping (includes images and video)
+export const MIME_EXT = {
+    'image/jpeg': '.jpg',
+    'image/png': '.png',
+    'image/gif': '.gif',
+    'image/webp': '.webp',
+    'image/bmp': '.bmp',
+    'image/svg+xml': '.svg',
+    'audio/ogg': '.ogg',
+    'audio/mpeg': '.mp3',
+    'audio/mp4': '.m4a',
+    'video/mp4': '.mp4',
+    'application/pdf': '.pdf',
+};
+// Media type to default MIME type mapping (for fallback when MIME is unknown)
+export const MEDIA_TYPE_MIME_DEFAULTS = {
+    image: 'image/jpeg',
+    audio: 'audio/ogg',
+    video: 'video/mp4',
+    document: 'application/pdf',
+};
+// Extension to MIME type mapping (inverse of MIME_EXT, includes common variations)
+export const EXT_TO_MIME = {
+    '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg',
+    '.png': 'image/png', '.gif': 'image/gif', '.webp': 'image/webp',
+    '.mp4': 'video/mp4', '.mp3': 'audio/mpeg',
+    '.ogg': 'audio/ogg', '.m4a': 'audio/mp4',
+    '.pdf': 'application/pdf',
+    '.txt': 'text/plain', '.md': 'text/markdown',
+    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+};
+// Typed MIME constants by media type
+export const IMAGE_MIMES = {
+    'image/jpeg': true,
+    'image/png': true,
+    'image/gif': true,
+    'image/webp': true,
+    'image/bmp': true,
+    'image/svg+xml': true,
+};
+export const AUDIO_MIMES = {
+    'audio/ogg': true,
+    'audio/mpeg': true,
+    'audio/mp4': true,
+    'audio/wav': true,
+    'audio/webm': true,
+    'audio/flac': true,
+    'audio/x-m4a': true,
+    'audio/mp3': true,
+};
+export const VIDEO_MIMES = {
+    'video/mp4': true,
+};
+export const DOCUMENT_MIMES = {
+    'text/plain': true,
+    'text/markdown': true,
+    'application/pdf': true,
+    'application/vnd.openxmlformats-officedocument.wordprocessingml.document': true,
+    'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': true,
+};
+/**
+ * Get file extension for MIME type
+ */
+export function extFromMime(mimeType) {
+    return MIME_EXT[mimeType] || '.bin';
+}
+/**
+ * Get MIME type from file extension
+ */
+export function getMimeTypeFromExt(ext) {
+    return EXT_TO_MIME[ext.toLowerCase()] || 'image/jpeg';
+}
+/**
+ * Normalize API base URL by removing trailing /v1 (or /v1/)
+ * Supports both formats: 'https://api.openai.com' and 'https://api.openai.com/v1'
+ */
+export function normalizeApiBaseUrl(baseUrl) {
+    let url = baseUrl ?? 'https://api.openai.com';
+    // Remove trailing /v1 or /v1/ if present
+    url = url.replace(/\/v1\/?$/, '');
+    return url;
+}
+//# sourceMappingURL=media-transcribe.js.map

package/dist/lib/media-transcribe.js.map

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

package/dist/lib/media.d.ts

@@ -0,0 +1,7 @@
+export declare function saveMedia(params: {
+    buffer: Buffer;
+    sessionKey: string;
+    mimeType: string;
+    mediaDir: string;
+}): Promise<string>;
+//# sourceMappingURL=media.d.ts.map

package/dist/lib/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../lib/media.ts"],"names":[],"mappings":"AAKA,wBAAsB,SAAS,CAAC,MAAM,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,MAAM,CAAC,CAelB"}

package/dist/lib/media.js

@@ -0,0 +1,18 @@
+import { createHash } from 'node:crypto';
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { extFromMime } from './media-transcribe.js';
+export async function saveMedia(params) {
+    const dir = path.join(params.mediaDir, params.sessionKey.replace(/:/g, '-'));
+    await mkdir(dir, { recursive: true });
+    const now = new Date();
+    const date = now.toISOString().slice(0, 10);
+    const time = now.toISOString().slice(11, 19).replace(/:/g, '');
+    const hash = createHash('sha256').update(params.buffer).digest('hex').slice(0, 4);
+    const ext = extFromMime(params.mimeType);
+    const filename = `${date}_${time}_${hash}${ext}`;
+    const filepath = path.join(dir, filename);
+    await writeFile(filepath, params.buffer);
+    return filepath;
+}
+//# sourceMappingURL=media.js.map

package/dist/lib/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../lib/media.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAK/B;IACC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7E,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClF,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEzC,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,IAAI,IAAI,IAAI,GAAG,GAAG,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAE1C,MAAM,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/lib/mime.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MIME type detection from file buffer
+ * Simple implementation based on magic numbers
+ */
+export declare function detectMimeType(buffer: Buffer): Promise<string>;
+//# sourceMappingURL=mime.d.ts.map

package/dist/lib/mime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../../lib/mime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2EpE"}

package/dist/lib/mime.js

@@ -0,0 +1,71 @@
+/**
+ * MIME type detection from file buffer
+ * Simple implementation based on magic numbers
+ */
+export async function detectMimeType(buffer) {
+    // Check magic numbers
+    if (buffer.length < 4) {
+        return 'application/octet-stream';
+    }
+    const hex = buffer.toString('hex', 0, 4);
+    // PNG
+    if (hex.startsWith('89504e47')) {
+        return 'image/png';
+    }
+    // JPEG
+    if (hex.startsWith('ffd8ff')) {
+        return 'image/jpeg';
+    }
+    // GIF
+    if (hex.startsWith('47494638')) {
+        return 'image/gif';
+    }
+    // WebP
+    if (hex.startsWith('52494646') && buffer.length >= 12) {
+        const webpHex = buffer.toString('hex', 8, 12);
+        if (webpHex.startsWith('57454250')) {
+            return 'image/webp';
+        }
+    }
+    // BMP
+    if (hex.startsWith('424d')) {
+        return 'image/bmp';
+    }
+    // SVG (check content)
+    const contentStart = buffer.toString('utf-8', 0, Math.min(100, buffer.length));
+    if (contentStart.includes('<?xml') && contentStart.includes('<svg')) {
+        return 'image/svg+xml';
+    }
+    if (contentStart.includes('<svg')) {
+        return 'image/svg+xml';
+    }
+    // Text files
+    const textContent = buffer.toString('utf-8', 0, Math.min(100, buffer.length));
+    if (textContent.includes('<?xml')) {
+        return 'application/xml';
+    }
+    if (textContent.includes('<!DOCTYPE html') || textContent.includes('<html')) {
+        return 'text/html';
+    }
+    if (textContent.includes('{') || textContent.includes('[')) {
+        // Might be JSON
+        try {
+            JSON.parse(textContent.slice(0, textContent.indexOf('\n')) || textContent);
+            return 'application/json';
+        }
+        catch {
+            // Not valid JSON
+        }
+    }
+    // Check if mostly printable (text)
+    const printable = buffer.slice(0, Math.min(100, buffer.length)).toString('utf-8');
+    const nonPrintable = [...printable].filter(c => {
+        const code = c.charCodeAt(0);
+        return code < 32 && code !== 9 && code !== 10 && code !== 13;
+    }).length;
+    if (nonPrintable === 0) {
+        return 'text/plain';
+    }
+    return 'application/octet-stream';
+}
+//# sourceMappingURL=mime.js.map

package/dist/lib/mime.js.map

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

package/dist/lib/paginate.d.ts

@@ -0,0 +1,3 @@
+import type { Pagination } from '../gateway/events.js';
+export declare function paginate<T>(items: T[], page?: number, limit?: number): Pagination<T>;
+//# sourceMappingURL=paginate.d.ts.map

package/dist/lib/paginate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.d.ts","sourceRoot":"","sources":["../../lib/paginate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,GAAE,MAAU,EAAE,KAAK,GAAE,MAAW,GAAG,UAAU,CAAC,CAAC,CAAC,CAG3F"}

package/dist/lib/paginate.js

@@ -0,0 +1,5 @@
+export function paginate(items, page = 1, limit = 20) {
+    const start = (page - 1) * limit;
+    return { items: items.slice(start, start + limit), page, limit };
+}
+//# sourceMappingURL=paginate.js.map

package/dist/lib/paginate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate.js","sourceRoot":"","sources":["../../lib/paginate.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CAAI,KAAU,EAAE,OAAe,CAAC,EAAE,QAAgB,EAAE;IAC1E,MAAM,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;IACjC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACnE,CAAC"}

package/dist/lib/paths.d.ts

@@ -0,0 +1,14 @@
+export interface DataPaths {
+    dataDir: string;
+    workspaceDir: string;
+    sessionsDir: string;
+    channelsDir: string;
+    cronDir: string;
+    logsDir: string;
+    cacheDir: string;
+    configFile: string;
+}
+/** Cached singleton — reads $VARGOS_DATA_DIR or ~/.vargos on first call. */
+export declare function getDataPaths(): DataPaths;
+export declare function resetDataPaths(): void;
+//# sourceMappingURL=paths.d.ts.map

package/dist/lib/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../lib/paths.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,4EAA4E;AAC5E,wBAAgB,YAAY,IAAI,SAAS,CAyBxC;AAED,wBAAgB,cAAc,IAAI,IAAI,CAAmB"}

package/dist/lib/paths.js

@@ -0,0 +1,29 @@
+import path from 'node:path';
+import os from 'node:os';
+let _cache = null;
+/** Cached singleton — reads $VARGOS_DATA_DIR or ~/.vargos on first call. */
+export function getDataPaths() {
+    if (_cache)
+        return _cache;
+    const env = process.env.VARGOS_DATA_DIR?.trim();
+    const dataDir = env
+        ? (env.startsWith('~') ? path.join(os.homedir(), env.slice(1)) : env)
+        : path.join(os.homedir(), '.vargos');
+    const xdg = process.env.XDG_CACHE_HOME?.trim();
+    const base = xdg
+        ? (xdg.startsWith('~') ? path.join(os.homedir(), xdg.slice(1)) : xdg)
+        : path.join(os.homedir(), '.cache');
+    _cache = {
+        dataDir,
+        workspaceDir: path.join(dataDir, 'workspace'),
+        sessionsDir: path.join(dataDir, 'sessions'),
+        channelsDir: path.join(dataDir, 'channels'),
+        cronDir: path.join(dataDir, 'cron'),
+        logsDir: path.join(dataDir, 'logs'),
+        cacheDir: path.join(base, 'vargos'),
+        configFile: path.join(dataDir, 'config.json'),
+    };
+    return _cache;
+}
+export function resetDataPaths() { _cache = null; }
+//# sourceMappingURL=paths.js.map

package/dist/lib/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../lib/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAazB,IAAI,MAAM,GAAqB,IAAI,CAAC;AAEpC,4EAA4E;AAC5E,MAAM,UAAU,YAAY;IAC1B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;IAChD,MAAM,OAAO,GAAG,GAAG;QACjB,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACrE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAEvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC;IAC/C,MAAM,IAAI,GAAG,GAAG;QACd,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACrE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;IAEtC,MAAM,GAAG;QACP,OAAO;QACP,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC;QAC7C,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;QAC3C,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC;QAC3C,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;QACnC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;QACnC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;QACnC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC;KAC9C,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc,KAAW,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC"}

package/dist/lib/provider-loader.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generic dynamic provider loader — reusable across services.
+ * Supports lazy-loaded providers with error handling and logging.
+ */
+/**
+ * Loads and returns providers from a registry of lazy loaders.
+ * Logs warnings for failed providers, continues loading others.
+ */
+export declare function loadProviders<T>(providerRegistry: Record<string, () => Promise<T>>): Promise<T[]>;
+//# sourceMappingURL=provider-loader.d.ts.map

package/dist/lib/provider-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-loader.d.ts","sourceRoot":"","sources":["../../lib/provider-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;GAGG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,GACjD,OAAO,CAAC,CAAC,EAAE,CAAC,CAWd"}

package/dist/lib/provider-loader.js

@@ -0,0 +1,24 @@
+/**
+ * Generic dynamic provider loader — reusable across services.
+ * Supports lazy-loaded providers with error handling and logging.
+ */
+import { createLogger } from './logger.js';
+const log = createLogger('provider-loader');
+/**
+ * Loads and returns providers from a registry of lazy loaders.
+ * Logs warnings for failed providers, continues loading others.
+ */
+export async function loadProviders(providerRegistry) {
+    const loaded = [];
+    for (const [name, loader] of Object.entries(providerRegistry)) {
+        try {
+            const provider = await loader();
+            loaded.push(provider);
+        }
+        catch (err) {
+            log.warn(`failed to load provider "${name}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return loaded;
+}
+//# sourceMappingURL=provider-loader.js.map