@chozzz/vargos 2.0.4 → 2.0.6

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

package/dist/lib/provider-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-loader.js","sourceRoot":"","sources":["../../lib/provider-loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,GAAG,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAAC;AAE5C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,gBAAkD;IAElD,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,4BAA4B,IAAI,MAAM,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/retry.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Structured retry with exponential backoff.
+ * Pure utility — no domain imports, no side effects beyond timing.
+ */
+export interface RetryConfig {
+    /** Max number of retry attempts after initial failure. Default: 3 */
+    maxRetries?: number;
+    /** Base delay in ms for backoff calculation. Default: 1000 */
+    baseMs?: number;
+    /** Maximum delay cap in ms. Default: 30_000 */
+    maxMs?: number;
+    /** Add up to 25% random jitter to each delay. Default: true */
+    jitter?: boolean;
+    /** Return false to rethrow immediately without retrying. Default: always retry */
+    shouldRetry?: (error: unknown) => boolean;
+    /** Abort mid-retry on signal cancellation */
+    signal?: AbortSignal;
+}
+export declare function withRetry<T>(fn: () => Promise<T>, config?: RetryConfig): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../lib/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kFAAkF;IAClF,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC1C,6CAA6C;IAC7C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AASD,wBAAsB,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CA+BzF"}

package/dist/lib/retry.js

@@ -0,0 +1,40 @@
+/**
+ * Structured retry with exponential backoff.
+ * Pure utility — no domain imports, no side effects beyond timing.
+ */
+import { sleep } from './sleep.js';
+function computeDelay(attempt, baseMs, maxMs, jitter) {
+    const base = Math.min(baseMs * 2 ** attempt, maxMs);
+    // Jitter adds 0–25% of the capped delay to spread retries
+    const extra = jitter ? Math.random() * 0.25 * base : 0;
+    return base + extra;
+}
+export async function withRetry(fn, config) {
+    const maxRetries = config?.maxRetries ?? 3;
+    const baseMs = config?.baseMs ?? 1000;
+    const maxMs = config?.maxMs ?? 30_000;
+    const jitter = config?.jitter ?? true;
+    const shouldRetry = config?.shouldRetry ?? (() => true);
+    const signal = config?.signal;
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err;
+            if (!shouldRetry(err))
+                throw err;
+            if (signal?.aborted) {
+                throw signal.reason ?? new DOMException('Aborted', 'AbortError');
+            }
+            // No delay after final attempt — just fall through and rethrow
+            if (attempt === maxRetries)
+                break;
+            const delay = computeDelay(attempt, baseMs, maxMs, jitter);
+            await sleep(delay, signal);
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/lib/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../lib/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAiBnC,SAAS,YAAY,CAAC,OAAe,EAAE,MAAc,EAAE,KAAa,EAAE,MAAe;IACnF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,EAAE,KAAK,CAAC,CAAC;IACpD,0DAA0D;IAC1D,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,OAAO,IAAI,GAAG,KAAK,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAI,EAAoB,EAAE,MAAoB;IAC3E,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,IAAI,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,IAAI,CAAC;IACtC,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,MAAM,CAAC;IACtC,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,IAAI,CAAC;IACtC,MAAM,WAAW,GAAG,MAAM,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC;IAE9B,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,SAAS,GAAG,GAAG,CAAC;YAEhB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;gBAAE,MAAM,GAAG,CAAC;YAEjC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM,MAAM,CAAC,MAAM,IAAI,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;YACnE,CAAC;YAED,+DAA+D;YAC/D,IAAI,OAAO,KAAK,UAAU;gBAAE,MAAM;YAElC,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC3D,MAAM,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC"}

package/dist/lib/safe-async.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Safe async execution utilities — centralized error context and handling.
+ * Reduces boilerplate in services that wrap async operations with logging.
+ */
+/**
+ * Execute async operation with automatic error logging.
+ * Returns result or undefined if operation throws.
+ */
+export declare function safeAwait<T>(promise: Promise<T>, context: {
+    operation: string;
+    service: string;
+    log: {
+        error(msg: string, data?: unknown): void;
+    };
+}): Promise<T | undefined>;
+/**
+ * Wrap async function with error context logging.
+ * Useful for event handlers and callbacks.
+ */
+export declare function withErrorContext<Args extends unknown[], R>(fn: (...args: Args) => Promise<R>, context: {
+    operation: string;
+    service: string;
+    log: {
+        error(msg: string, data?: unknown): void;
+    };
+}): (...args: Args) => Promise<R | undefined>;
+//# sourceMappingURL=safe-async.d.ts.map

package/dist/lib/safe-async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-async.d.ts","sourceRoot":"","sources":["../../lib/safe-async.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;GAGG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE;QAAE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,GACjG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CASxB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,EACxD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EACjC,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE;QAAE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,GACjG,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAW3C"}

package/dist/lib/safe-async.js

@@ -0,0 +1,38 @@
+/**
+ * Safe async execution utilities — centralized error context and handling.
+ * Reduces boilerplate in services that wrap async operations with logging.
+ */
+import { toMessage } from './error.js';
+/**
+ * Execute async operation with automatic error logging.
+ * Returns result or undefined if operation throws.
+ */
+export async function safeAwait(promise, context) {
+    try {
+        return await promise;
+    }
+    catch (err) {
+        context.log.error(`${context.operation} failed in ${context.service}`, {
+            error: toMessage(err),
+        });
+        return undefined;
+    }
+}
+/**
+ * Wrap async function with error context logging.
+ * Useful for event handlers and callbacks.
+ */
+export function withErrorContext(fn, context) {
+    return async (...args) => {
+        try {
+            return await fn(...args);
+        }
+        catch (err) {
+            context.log.error(`${context.operation} failed`, {
+                error: toMessage(err),
+            });
+            return undefined;
+        }
+    };
+}
+//# sourceMappingURL=safe-async.js.map

package/dist/lib/safe-async.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-async.js","sourceRoot":"","sources":["../../lib/safe-async.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAmB,EACnB,OAAkG;IAElG,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,SAAS,cAAc,OAAO,CAAC,OAAO,EAAE,EAAE;YACrE,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC;SACtB,CAAC,CAAC;QACH,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAAiC,EACjC,OAAkG;IAElG,OAAO,KAAK,EAAE,GAAG,IAAU,EAAE,EAAE;QAC7B,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,SAAS,SAAS,EAAE;gBAC/C,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC;aACtB,CAAC,CAAC;YACH,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/lib/skills.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resolve `<root>/skills/` for each input root, filtered to directories that exist on disk.
+ * Order is preserved (caller-defined precedence). Used to feed Pi SDK's `additionalSkillPaths`.
+ *
+ * Pi SDK's `DefaultResourceLoader` already auto-loads `<agentDir>/skills/` and
+ * `<cwd>/.pi/skills/` — don't pass those here, they'd double-load.
+ */
+export declare function resolveSkillPaths(...roots: string[]): string[];
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../lib/skills.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAI9D"}

package/dist/lib/skills.js

@@ -0,0 +1,15 @@
+import path from 'node:path';
+import { existsSync } from 'node:fs';
+/**
+ * Resolve `<root>/skills/` for each input root, filtered to directories that exist on disk.
+ * Order is preserved (caller-defined precedence). Used to feed Pi SDK's `additionalSkillPaths`.
+ *
+ * Pi SDK's `DefaultResourceLoader` already auto-loads `<agentDir>/skills/` and
+ * `<cwd>/.pi/skills/` — don't pass those here, they'd double-load.
+ */
+export function resolveSkillPaths(...roots) {
+    return roots
+        .map(p => path.join(p, 'skills'))
+        .filter(p => existsSync(p));
+}
+//# sourceMappingURL=skills.js.map

package/dist/lib/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../lib/skills.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAG,KAAe;IAClD,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;SAChC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/dist/lib/sleep.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Interruptible sleep utility.
+ * Resolves after `ms` milliseconds, or rejects early if the signal is aborted.
+ */
+export declare function sleep(ms: number, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../lib/sleep.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBrE"}

package/dist/lib/sleep.js

@@ -0,0 +1,22 @@
+/**
+ * Interruptible sleep utility.
+ * Resolves after `ms` milliseconds, or rejects early if the signal is aborted.
+ */
+export function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(signal.reason ?? new DOMException('Aborted', 'AbortError'));
+            return;
+        }
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(signal.reason ?? new DOMException('Aborted', 'AbortError'));
+        };
+        const timer = setTimeout(() => {
+            signal?.removeEventListener('abort', onAbort);
+            resolve();
+        }, ms);
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=sleep.js.map

package/dist/lib/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../lib/sleep.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU,EAAE,MAAoB;IACpD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,MAAO,CAAC,MAAM,IAAI,IAAI,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;QACtE,CAAC,CAAC;QAEF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9C,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC"}