sensorium-mcp 2.16.28 → 2.16.30

package/dist/integrations/openai/speech.js

@@ -0,0 +1,75 @@
+/**
+ * OpenAI speech services: TTS (text-to-speech) and Whisper transcription.
+ *
+ * Extracted from openai.ts for modular decomposition (Phase 3B).
+ */
+// ─── TTS ──────────────────────────────────────────────────────────────────
+/** Valid TTS voice names. */
+export const TTS_VOICES = [
+    "alloy", "echo", "fable", "onyx", "nova", "shimmer",
+];
+/**
+ * Convert text to speech using OpenAI TTS API.
+ * Returns OGG Opus audio suitable for Telegram's sendVoice.
+ */
+export async function textToSpeech(text, apiKey, voice = "nova") {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 60_000);
+    try {
+        const response = await fetch("https://api.openai.com/v1/audio/speech", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({
+                model: "tts-1",
+                input: text,
+                voice,
+                response_format: "opus",
+            }),
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            const errText = await response.text().catch(() => response.statusText);
+            throw new Error(`OpenAI TTS failed: ${response.status} ${errText}`);
+        }
+        return Buffer.from(await response.arrayBuffer());
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Transcribe an audio buffer using OpenAI Whisper API.
+ * @param audioBuffer  Raw audio content (OGG Opus from Telegram voice messages).
+ * @param apiKey       OpenAI API key.
+ * @returns The transcribed text (empty string if no speech detected).
+ */
+export async function transcribeAudio(audioBuffer, apiKey, filename = "voice.ogg") {
+    // Telegram stores voice as .oga (OGG Opus). Whisper accepts .ogg but
+    // not .oga, so we hardcode the extension.
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 60_000);
+    try {
+        const formData = new FormData();
+        formData.append("file", new Blob([new Uint8Array(audioBuffer)]), filename);
+        formData.append("model", "whisper-1");
+        const response = await fetch("https://api.openai.com/v1/audio/transcriptions", {
+            method: "POST",
+            headers: { Authorization: `Bearer ${apiKey}` },
+            body: formData,
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            const errText = await response.text().catch(() => response.statusText);
+            throw new Error(`OpenAI Whisper transcription failed: ${response.status} ${errText}`);
+        }
+        const result = (await response.json());
+        return result.text ?? "";
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=speech.js.map

package/dist/integrations/openai/speech.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech.js","sourceRoot":"","sources":["../../../src/integrations/openai/speech.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6EAA6E;AAE7E,6BAA6B;AAC7B,MAAM,CAAC,MAAM,UAAU,GAAG;IACtB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS;CAC7C,CAAC;AAGX;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,IAAY,EACZ,MAAc,EACd,QAAkB,MAAM;IAExB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IAC3D,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,wCAAwC,EAAE;YACnE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACL,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,MAAM,EAAE;aACpC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACjB,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,IAAI;gBACX,KAAK;gBACL,eAAe,EAAE,MAAM;aAC1B,CAAC;YACF,MAAM,EAAE,UAAU,CAAC,MAAM;SAC5B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACrD,CAAC;YAAS,CAAC;QACP,YAAY,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,WAAmB,EACnB,MAAc,EACd,WAAmB,WAAW;IAE9B,qEAAqE;IACrE,0CAA0C;IAC1C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;IAC3D,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,QAAQ,CAAC,MAAM,CACX,MAAM,EACN,IAAI,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,EACvC,QAAQ,CACX,CAAC;QACF,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAEtC,MAAM,QAAQ,GAAG,MAAM,KAAK,CACxB,gDAAgD,EAChD;YACI,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE;YAC9C,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,UAAU,CAAC,MAAM;SAC5B,CACJ,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YACvE,MAAM,IAAI,KAAK,CACX,wCAAwC,QAAQ,CAAC,MAAM,IAAI,OAAO,EAAE,CACvE,CAAC;QACN,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAC;QAC5D,OAAO,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IAC7B,CAAC;YAAS,CAAC;QACP,YAAY,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;AACL,CAAC"}

package/dist/integrations/openai/video.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Video frame extraction (ffmpeg) and GPT-4o-mini vision analysis.
+ * Extracted from openai.ts for modular decomposition (Phase 3).
+ */
+/** Maximum number of frames to extract from a video. */
+export declare const MAX_FRAMES = 6;
+/**
+ * Extract key frames from a video buffer using ffmpeg.
+ * Writes video to a temp file and reads JPEG frames from stdout.
+ * @param videoBuffer  Raw video file content (MP4).
+ * @param durationSec  Video duration in seconds (used to calculate interval).
+ * @returns Array of JPEG-encoded frame buffers.
+ */
+export declare function extractVideoFrames(videoBuffer: Buffer, durationSec: number): Promise<Buffer[]>;
+//# sourceMappingURL=video.d.ts.map

package/dist/integrations/openai/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../../../src/integrations/openai/video.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2DH,wDAAwD;AACxD,eAAO,MAAM,UAAU,IAAI,CAAC;AAkB5B;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAC9B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CAsDnB"}

package/dist/integrations/openai/video.js

@@ -0,0 +1,131 @@
+/**
+ * Video frame extraction (ffmpeg) and GPT-4o-mini vision analysis.
+ * Extracted from openai.ts for modular decomposition (Phase 3).
+ */
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { mkdirSync, readdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+// ---------------------------------------------------------------------------
+// Temp-file management
+// ---------------------------------------------------------------------------
+// Dedicated temp directory so crash-leftover files are cleaned on next startup.
+const TEMP_DIR = join(homedir(), ".remote-copilot-mcp", "tmp");
+/** Remove stale files from TEMP_DIR; create the dir if absent. */
+function cleanupTempDir() {
+    mkdirSync(TEMP_DIR, { recursive: true });
+    const STALE_AGE = 5 * 60 * 1000; // 5 minutes — any temp file this old is a crash leftover
+    const now = Date.now();
+    for (const name of readdirSync(TEMP_DIR)) {
+        try {
+            const fullPath = join(TEMP_DIR, name);
+            const mtime = statSync(fullPath).mtimeMs;
+            if (now - mtime > STALE_AGE) {
+                unlinkSync(fullPath);
+            }
+        }
+        catch { /* ignore per-file errors */ }
+    }
+}
+// Track in-flight temp files for cleanup on unexpected exit.
+const activeTempFiles = new Set();
+function registerTempFile(path) {
+    activeTempFiles.add(path);
+}
+function unregisterTempFile(path) {
+    activeTempFiles.delete(path);
+    try {
+        unlinkSync(path);
+    }
+    catch { /* ignore */ }
+}
+// Clean up in-flight temp files on graceful/forced shutdown.
+for (const sig of ["exit", "SIGINT", "SIGTERM"]) {
+    process.on(sig, () => {
+        for (const f of activeTempFiles) {
+            try {
+                unlinkSync(f);
+            }
+            catch { /* ignore */ }
+        }
+    });
+}
+// Run once when the module loads.
+cleanupTempDir();
+// ---------------------------------------------------------------------------
+// Frame extraction
+// ---------------------------------------------------------------------------
+/** Maximum number of frames to extract from a video. */
+export const MAX_FRAMES = 6;
+/**
+ * Split a buffer of concatenated JPEG images by SOI marker (0xFFD8).
+ */
+function splitJpegs(buf) {
+    const frames = [];
+    let start = 0;
+    for (let i = 2; i < buf.length - 1; i++) {
+        if (buf[i] === 0xFF && buf[i + 1] === 0xD8) {
+            frames.push(buf.subarray(start, i));
+            start = i;
+        }
+    }
+    if (start < buf.length)
+        frames.push(buf.subarray(start));
+    return frames.filter(f => f.length > 100); // drop tiny garbage
+}
+/**
+ * Extract key frames from a video buffer using ffmpeg.
+ * Writes video to a temp file and reads JPEG frames from stdout.
+ * @param videoBuffer  Raw video file content (MP4).
+ * @param durationSec  Video duration in seconds (used to calculate interval).
+ * @returns Array of JPEG-encoded frame buffers.
+ */
+export function extractVideoFrames(videoBuffer, durationSec) {
+    const tempPath = join(TEMP_DIR, `video-${randomUUID()}.mp4`);
+    writeFileSync(tempPath, videoBuffer);
+    registerTempFile(tempPath);
+    return new Promise((resolve, reject) => {
+        // Calculate frame interval: aim for ~1 frame every 5s, capped at MAX_FRAMES.
+        const interval = Math.max(1, Math.ceil(durationSec / MAX_FRAMES));
+        const args = [
+            "-i", tempPath,
+            "-vf", `fps=1/${interval}`,
+            "-c:v", "mjpeg",
+            "-f", "image2pipe",
+            "-q:v", "3",
+            "pipe:1",
+        ];
+        const proc = spawn("ffmpeg", args, {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const chunks = [];
+        const errChunks = [];
+        proc.stdout.on("data", (chunk) => chunks.push(chunk));
+        proc.stderr.on("data", (chunk) => errChunks.push(chunk));
+        // Kill ffmpeg if it hangs for more than 30 seconds.
+        const killTimer = setTimeout(() => proc.kill("SIGKILL"), 30_000);
+        proc.on("error", (err) => {
+            clearTimeout(killTimer);
+            reject(new Error(`ffmpeg not found or failed to start: ${err.message}`));
+        });
+        proc.on("close", (code) => {
+            clearTimeout(killTimer);
+            if (code !== 0) {
+                const stderr = Buffer.concat(errChunks).toString("utf8").slice(-500);
+                reject(new Error(`ffmpeg exited with code ${code}: ${stderr}`));
+                return;
+            }
+            const combined = Buffer.concat(chunks);
+            if (combined.length === 0) {
+                resolve([]);
+                return;
+            }
+            const frames = splitJpegs(combined).slice(0, MAX_FRAMES);
+            resolve(frames);
+        });
+    }).finally(() => {
+        unregisterTempFile(tempPath);
+    });
+}
+//# sourceMappingURL=video.js.map

package/dist/integrations/openai/video.js.map

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

package/dist/integrations/openai/vision.d.ts

@@ -0,0 +1,23 @@
+/**
+ * OpenAI vision services: image analysis (GPT-4o) and video frame analysis (GPT-4o-mini).
+ *
+ * Extracted from openai.ts for modular decomposition (Phase 3C).
+ */
+/**
+ * Analyze an image using GPT-4o vision capability.
+ * Sends the image as base64 with a text prompt and returns the analysis.
+ * @param imageBuffer  Raw image content (JPEG, PNG, etc.).
+ * @param prompt       The analysis prompt to send alongside the image.
+ * @param apiKey       OpenAI API key.
+ * @returns The vision model's text response.
+ */
+export declare function analyzeImage(imageBuffer: Buffer, prompt: string, apiKey: string): Promise<string>;
+/**
+ * Analyze video frames using OpenAI GPT-4o-mini vision.
+ * @param frames     Array of JPEG frame buffers.
+ * @param durationSec  Video duration for timestamp context.
+ * @param apiKey     OpenAI API key.
+ * @returns Human-readable description of the video content.
+ */
+export declare function analyzeVideoFrames(frames: Buffer[], durationSec: number, apiKey: string): Promise<string>;
+//# sourceMappingURL=vision.d.ts.map

package/dist/integrations/openai/vision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision.d.ts","sourceRoot":"","sources":["../../../src/integrations/openai/vision.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAC9B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CA4CjB;AAID;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACpC,MAAM,EAAE,MAAM,EAAE,EAChB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CA0DjB"}

package/dist/integrations/openai/vision.js

@@ -0,0 +1,116 @@
+/**
+ * OpenAI vision services: image analysis (GPT-4o) and video frame analysis (GPT-4o-mini).
+ *
+ * Extracted from openai.ts for modular decomposition (Phase 3C).
+ */
+import { MAX_FRAMES } from "./video.js";
+// ─── Image / Vision Analysis ──────────────────────────────────────────────
+/**
+ * Analyze an image using GPT-4o vision capability.
+ * Sends the image as base64 with a text prompt and returns the analysis.
+ * @param imageBuffer  Raw image content (JPEG, PNG, etc.).
+ * @param prompt       The analysis prompt to send alongside the image.
+ * @param apiKey       OpenAI API key.
+ * @returns The vision model's text response.
+ */
+export async function analyzeImage(imageBuffer, prompt, apiKey) {
+    const base64 = imageBuffer.toString("base64");
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 30_000);
+    try {
+        const response = await fetch("https://api.openai.com/v1/chat/completions", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({
+                model: "gpt-4o",
+                messages: [
+                    {
+                        role: "user",
+                        content: [
+                            { type: "text", text: prompt },
+                            {
+                                type: "image_url",
+                                image_url: {
+                                    url: `data:image/jpeg;base64,${base64}`,
+                                    detail: "low",
+                                },
+                            },
+                        ],
+                    },
+                ],
+                max_completion_tokens: 150,
+                temperature: 0,
+            }),
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            const errText = await response.text().catch(() => response.statusText);
+            throw new Error(`OpenAI vision analysis failed: ${response.status} ${errText}`);
+        }
+        const json = await response.json();
+        return json.choices?.[0]?.message?.content?.trim() ?? "";
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+// ─── Video Frame Vision Analysis ──────────────────────────────────────────
+/**
+ * Analyze video frames using OpenAI GPT-4o-mini vision.
+ * @param frames     Array of JPEG frame buffers.
+ * @param durationSec  Video duration for timestamp context.
+ * @param apiKey     OpenAI API key.
+ * @returns Human-readable description of the video content.
+ */
+export async function analyzeVideoFrames(frames, durationSec, apiKey) {
+    if (frames.length === 0) {
+        return "(no frames could be extracted from the video)";
+    }
+    const interval = Math.max(1, Math.ceil(durationSec / MAX_FRAMES));
+    const timestamps = frames.map((_, i) => `${i * interval}s`).join(", ");
+    const content = [
+        {
+            type: "text",
+            text: `These are ${frames.length} sequential frames extracted from a ${durationSec}s video message at timestamps: [${timestamps}]. ` +
+                `Describe what is happening in the video concisely (2-3 sentences). ` +
+                `Note any people, actions, objects, movement, text, or scene changes.`,
+        },
+        ...frames.map((frame) => ({
+            type: "image_url",
+            image_url: {
+                url: `data:image/jpeg;base64,${frame.toString("base64")}`,
+                detail: "low", // circle videos are small (240-384px)
+            },
+        })),
+    ];
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 60_000);
+    try {
+        const response = await fetch("https://api.openai.com/v1/chat/completions", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({
+                model: "gpt-4o-mini",
+                messages: [{ role: "user", content }],
+                max_completion_tokens: 300,
+            }),
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            const errText = await response.text().catch(() => response.statusText);
+            throw new Error(`OpenAI vision analysis failed: ${response.status} ${errText}`);
+        }
+        const result = (await response.json());
+        return result.choices?.[0]?.message?.content?.trim() ?? "(no description generated)";
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=vision.js.map

package/dist/integrations/openai/vision.js.map

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

package/dist/integrations/openai/voice-emotion.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Voice emotion analysis via an external microservice.
+ * Extracted from openai.ts for modular decomposition (Phase 3).
+ */
+export interface AudioEvent {
+    label: string;
+    score: number;
+}
+export interface Paralinguistics {
+    speech_rate?: number;
+    mean_pitch_hz?: number;
+    pitch_std_hz?: number;
+    jitter?: number;
+    shimmer?: number;
+    hnr_db?: number;
+}
+export interface VoiceAnalysisResult {
+    emotion: string | null;
+    emotion_scores?: Record<string, number>;
+    arousal: number | null;
+    dominance: number | null;
+    valence: number | null;
+    gender: string | null;
+    age_estimate: number | null;
+    duration_seconds: number;
+    audio_events?: AudioEvent[];
+    paralinguistics?: Paralinguistics;
+}
+/**
+ * Analyze a voice message for emotion using an external microservice.
+ * @param audioBuffer  Raw audio content (OGG).
+ * @param serviceUrl   Base URL of the voice analysis service (e.g. https://voice-analysis.example.com).
+ * @param timeoutMs    Request timeout in milliseconds (default: 15000).
+ * @returns Analysis result, or null if the service is unavailable or errors.
+ */
+export declare function analyzeVoiceEmotion(audioBuffer: Buffer, serviceUrl: string, options?: {
+    mimeType?: string;
+    filename?: string;
+    timeoutMs?: number;
+}): Promise<VoiceAnalysisResult | null>;
+//# sourceMappingURL=voice-emotion.d.ts.map

package/dist/integrations/openai/voice-emotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-emotion.d.ts","sourceRoot":"","sources":["../../../src/integrations/openai/voice-emotion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAE,eAAe,CAAC;CACrC;AAMD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACrC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAuCrC"}

package/dist/integrations/openai/voice-emotion.js

@@ -0,0 +1,50 @@
+/**
+ * Voice emotion analysis via an external microservice.
+ * Extracted from openai.ts for modular decomposition (Phase 3).
+ */
+import { log } from "../../logger.js";
+// ---------------------------------------------------------------------------
+// Service client
+// ---------------------------------------------------------------------------
+/**
+ * Analyze a voice message for emotion using an external microservice.
+ * @param audioBuffer  Raw audio content (OGG).
+ * @param serviceUrl   Base URL of the voice analysis service (e.g. https://voice-analysis.example.com).
+ * @param timeoutMs    Request timeout in milliseconds (default: 15000).
+ * @returns Analysis result, or null if the service is unavailable or errors.
+ */
+export async function analyzeVoiceEmotion(audioBuffer, serviceUrl, options) {
+    const { mimeType = "audio/ogg", filename = "voice.ogg", timeoutMs = 120_000 } = options ?? {};
+    const start = Date.now();
+    const baseUrl = serviceUrl.replace(/\/+$/, "");
+    log.verbose("voice-analysis", `Starting analysis (timeout: ${timeoutMs}ms, format: ${mimeType})...`);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const formData = new FormData();
+        formData.append("file", new Blob([new Uint8Array(audioBuffer)], { type: mimeType }), filename);
+        const response = await fetch(`${baseUrl}/analyze`, {
+            method: "POST",
+            body: formData,
+            signal: controller.signal,
+        });
+        const elapsed = Date.now() - start;
+        if (!response.ok) {
+            log.warn(`[voice-analysis] HTTP ${response.status} after ${elapsed}ms`);
+            return null;
+        }
+        const result = (await response.json());
+        log.verbose("voice-analysis", `Success in ${elapsed}ms`);
+        return result;
+    }
+    catch (err) {
+        const elapsed = Date.now() - start;
+        const msg = err instanceof Error ? err.message : String(err);
+        log.error(`[voice-analysis] Failed after ${elapsed}ms: ${msg}`);
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=voice-emotion.js.map

package/dist/integrations/openai/voice-emotion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-emotion.js","sourceRoot":"","sources":["../../../src/integrations/openai/voice-emotion.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAiCtC,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,WAAmB,EACnB,UAAkB,EAClB,OAAsE;IAEtE,MAAM,EAAE,QAAQ,GAAG,WAAW,EAAE,QAAQ,GAAG,WAAW,EAAE,SAAS,GAAG,OAAO,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAC9F,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC/C,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,+BAA+B,SAAS,eAAe,QAAQ,MAAM,CAAC,CAAC;IAErG,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAC9D,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;QAChC,QAAQ,CAAC,MAAM,CACX,MAAM,EACN,IAAI,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAC3D,QAAQ,CACX,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,UAAU,EAAE;YAC/C,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,UAAU,CAAC,MAAM;SAC5B,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACnC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,yBAAyB,QAAQ,CAAC,MAAM,UAAU,OAAO,IAAI,CAAC,CAAC;YACxE,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAwB,CAAC;QAC9D,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,cAAc,OAAO,IAAI,CAAC,CAAC;QACzD,OAAO,MAAM,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACnC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,GAAG,CAAC,KAAK,CAAC,iCAAiC,OAAO,OAAO,GAAG,EAAE,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC;IAChB,CAAC;YAAS,CAAC;QACP,YAAY,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;AACL,CAAC"}

package/dist/integrations/telegram/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Telegram Bot API type definitions.
+ * Extracted from telegram.ts for modularity.
+ */
+export interface TelegramSticker {
+    file_id: string;
+    file_unique_id: string;
+    emoji?: string;
+    set_name?: string;
+}
+export interface TelegramAnimation {
+    file_id: string;
+    file_unique_id: string;
+    width?: number;
+    height?: number;
+    duration?: number;
+    mime_type?: string;
+    file_name?: string;
+    file_size?: number;
+    thumbnail?: PhotoSize;
+    thumb?: PhotoSize;
+}
+export interface TelegramMessage {
+    message_id: number;
+    chat: {
+        id: number;
+    };
+    text?: string;
+    caption?: string;
+    date: number;
+    message_thread_id?: number;
+    photo?: PhotoSize[];
+    document?: TelegramDocument;
+    voice?: TelegramVoice;
+    video_note?: TelegramVideoNote;
+    sticker?: TelegramSticker;
+    animation?: TelegramAnimation;
+}
+export interface PhotoSize {
+    file_id: string;
+    file_unique_id: string;
+    width: number;
+    height: number;
+    file_size?: number;
+}
+export interface TelegramDocument {
+    file_id: string;
+    file_unique_id: string;
+    file_name?: string;
+    mime_type?: string;
+    file_size?: number;
+}
+export interface TelegramVoice {
+    file_id: string;
+    file_unique_id: string;
+    duration: number;
+    mime_type?: string;
+    file_size?: number;
+}
+export interface TelegramVideoNote {
+    file_id: string;
+    file_unique_id: string;
+    length: number;
+    duration: number;
+    thumbnail?: PhotoSize;
+    file_size?: number;
+}
+export interface TelegramMessageReaction {
+    chat: {
+        id: number;
+    };
+    message_id: number;
+    date: number;
+    new_reaction: Array<{
+        type: string;
+        emoji?: string;
+    }>;
+}
+export interface TelegramUpdate {
+    update_id: number;
+    message?: TelegramMessage;
+    message_reaction?: TelegramMessageReaction;
+}
+export interface GetUpdatesResult {
+    ok: boolean;
+    result: TelegramUpdate[];
+    description?: string;
+}
+export interface SendMessageResult {
+    ok: boolean;
+    result?: TelegramMessage;
+    description?: string;
+}
+export interface ForumTopic {
+    message_thread_id: number;
+    name: string;
+}
+export interface CreateForumTopicResult {
+    ok: boolean;
+    result?: ForumTopic;
+    description?: string;
+}
+export interface TelegramFile {
+    file_id: string;
+    file_path: string;
+}
+export interface GetFileResult {
+    ok: boolean;
+    result?: TelegramFile;
+    description?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/integrations/telegram/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/integrations/telegram/types.ts"],"names":[],"mappings":"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"}

package/dist/integrations/telegram/types.js

@@ -0,0 +1,6 @@
+/**
+ * Telegram Bot API type definitions.
+ * Extracted from telegram.ts for modularity.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/integrations/telegram/types.js.map

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