@luckydraw/cumulus 0.28.7 → 0.28.9

package/dist/gateway/voice-tts.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Voice TTS module — manages Piper subprocess for text-to-speech.
+ *
+ * Sentence buffering: accumulates tokens until sentence boundary,
+ * then pipes each sentence to Piper and streams raw PCM back.
+ *
+ * Audio format: 16-bit signed PCM, 22050 Hz, mono.
+ */
+export declare const SAMPLE_RATE = 22050;
+export declare const CHANNELS = 1;
+export declare const BIT_DEPTH = 16;
+/**
+ * Buffers streaming tokens into complete sentences for TTS.
+ */
+export declare class SentenceBuffer {
+    private buffer;
+    private onSentence;
+    constructor(onSentence: (sentence: string) => void);
+    /** Add a token to the buffer. Flushes complete sentences. */
+    push(token: string): void;
+    /** Flush any remaining text in the buffer. */
+    flush(): void;
+    /** Clear the buffer without flushing. */
+    clear(): void;
+}
+/**
+ * Check if Piper and the specified voice are available.
+ */
+export declare function isPiperAvailable(voice?: string): boolean;
+export interface VoiceTTSSessionOptions {
+    voice?: string;
+    /** Called with raw PCM chunks (16-bit signed, 22050 Hz, mono) */
+    onAudio: (pcm: Buffer) => void;
+    /** Called when all queued sentences have been spoken */
+    onDone: () => void;
+    /** Called on error */
+    onError?: (err: Error) => void;
+}
+/**
+ * Manages a voice TTS session — buffers tokens into sentences,
+ * synthesizes each with Piper, and streams PCM audio back.
+ */
+export declare class VoiceTTSSession {
+    private voice;
+    private sentenceBuffer;
+    private queue;
+    private processing;
+    private aborted;
+    private finished;
+    private onAudio;
+    private onDone;
+    private onError;
+    private activeProc;
+    constructor(opts: VoiceTTSSessionOptions);
+    /** Feed a streaming token into the session. */
+    pushToken(token: string): void;
+    /** Signal that no more tokens will arrive. Flushes remaining buffer. */
+    finish(): void;
+    /** Abort the session — stop all synthesis immediately. */
+    abort(): void;
+    private processQueue;
+    private synthesizeSentence;
+}
+//# sourceMappingURL=voice-tts.d.ts.map

package/dist/gateway/voice-tts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-tts.d.ts","sourceRoot":"","sources":["../../src/gateway/voice-tts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,eAAO,MAAM,WAAW,QAAQ,CAAC;AACjC,eAAO,MAAM,QAAQ,IAAI,CAAC;AAC1B,eAAO,MAAM,SAAS,KAAK,CAAC;AAM5B;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,UAAU,CAA6B;gBAEnC,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI;IAIlD,6DAA6D;IAC7D,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IA0BzB,8CAA8C;IAC9C,KAAK,IAAI,IAAI;IAQb,yCAAyC;IACzC,KAAK,IAAI,IAAI;CAGd;AAWD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,SAAgB,GAAG,OAAO,CAG/D;AAID,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,wDAAwD;IACxD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,sBAAsB;IACtB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AAED;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAA6B;gBAEnC,IAAI,EAAE,sBAAsB;IAYxC,+CAA+C;IAC/C,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAc9B,wEAAwE;IACxE,MAAM,IAAI,IAAI;IAUd,0DAA0D;IAC1D,KAAK,IAAI,IAAI;YAUC,YAAY;IAuB1B,OAAO,CAAC,kBAAkB;CAmC3B"}

package/dist/gateway/voice-tts.js

@@ -0,0 +1,191 @@
+/**
+ * Voice TTS module — manages Piper subprocess for text-to-speech.
+ *
+ * Sentence buffering: accumulates tokens until sentence boundary,
+ * then pipes each sentence to Piper and streams raw PCM back.
+ *
+ * Audio format: 16-bit signed PCM, 22050 Hz, mono.
+ */
+import { spawn } from 'child_process';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+// ─── Configuration ───────────────────────────────────────────────────────────
+const PIPER_VOICES_DIR = path.join(os.homedir(), '.cumulus', 'piper-voices');
+const DEFAULT_VOICE = 'en_US-amy-medium';
+export const SAMPLE_RATE = 22050;
+export const CHANNELS = 1;
+export const BIT_DEPTH = 16;
+// ─── Sentence buffering ─────────────────────────────────────────────────────
+const SENTENCE_ENDINGS = /[.!?]\s|[.!?]$/;
+/**
+ * Buffers streaming tokens into complete sentences for TTS.
+ */
+export class SentenceBuffer {
+    buffer = '';
+    onSentence;
+    constructor(onSentence) {
+        this.onSentence = onSentence;
+    }
+    /** Add a token to the buffer. Flushes complete sentences. */
+    push(token) {
+        this.buffer += token;
+        // Check for sentence boundaries
+        let match;
+        while ((match = SENTENCE_ENDINGS.exec(this.buffer)) !== null) {
+            const endIdx = match.index + match[0].length;
+            const sentence = this.buffer.slice(0, endIdx).trim();
+            this.buffer = this.buffer.slice(endIdx);
+            if (sentence) {
+                this.onSentence(sentence);
+            }
+        }
+        // Also check for paragraph breaks
+        const paraIdx = this.buffer.indexOf('\n\n');
+        if (paraIdx >= 0) {
+            const sentence = this.buffer.slice(0, paraIdx).trim();
+            this.buffer = this.buffer.slice(paraIdx + 2);
+            if (sentence) {
+                this.onSentence(sentence);
+            }
+        }
+    }
+    /** Flush any remaining text in the buffer. */
+    flush() {
+        const remaining = this.buffer.trim();
+        this.buffer = '';
+        if (remaining) {
+            this.onSentence(remaining);
+        }
+    }
+    /** Clear the buffer without flushing. */
+    clear() {
+        this.buffer = '';
+    }
+}
+// ─── Piper subprocess manager ────────────────────────────────────────────────
+/**
+ * Resolves the path to a Piper voice model.
+ */
+function getVoicePath(voice) {
+    return path.join(PIPER_VOICES_DIR, `${voice}.onnx`);
+}
+/**
+ * Check if Piper and the specified voice are available.
+ */
+export function isPiperAvailable(voice = DEFAULT_VOICE) {
+    const voicePath = getVoicePath(voice);
+    return fs.existsSync(voicePath);
+}
+/**
+ * Manages a voice TTS session — buffers tokens into sentences,
+ * synthesizes each with Piper, and streams PCM audio back.
+ */
+export class VoiceTTSSession {
+    voice;
+    sentenceBuffer;
+    queue = [];
+    processing = false;
+    aborted = false;
+    finished = false;
+    onAudio;
+    onDone;
+    onError;
+    activeProc = null;
+    constructor(opts) {
+        this.voice = opts.voice || DEFAULT_VOICE;
+        this.onAudio = opts.onAudio;
+        this.onDone = opts.onDone;
+        this.onError = opts.onError || (() => { });
+        this.sentenceBuffer = new SentenceBuffer(sentence => {
+            this.queue.push(sentence);
+            this.processQueue();
+        });
+    }
+    /** Feed a streaming token into the session. */
+    pushToken(token) {
+        if (this.aborted)
+            return;
+        // Strip markdown/blex for TTS
+        const clean = token
+            .replace(/~~~blex:[\s\S]*?~~~/g, '')
+            .replace(/```[\s\S]*?```/g, '')
+            .replace(/[*_~`#]/g, '');
+        if (clean) {
+            this.sentenceBuffer.push(clean);
+        }
+    }
+    /** Signal that no more tokens will arrive. Flushes remaining buffer. */
+    finish() {
+        if (this.aborted)
+            return;
+        this.finished = true;
+        this.sentenceBuffer.flush();
+        // If queue is empty and not processing, we're done
+        if (this.queue.length === 0 && !this.processing) {
+            this.onDone();
+        }
+    }
+    /** Abort the session — stop all synthesis immediately. */
+    abort() {
+        this.aborted = true;
+        this.queue.length = 0;
+        this.sentenceBuffer.clear();
+        if (this.activeProc) {
+            this.activeProc.kill('SIGTERM');
+            this.activeProc = null;
+        }
+    }
+    async processQueue() {
+        if (this.processing || this.aborted)
+            return;
+        this.processing = true;
+        while (this.queue.length > 0 && !this.aborted) {
+            const sentence = this.queue.shift();
+            try {
+                await this.synthesizeSentence(sentence);
+            }
+            catch (err) {
+                if (!this.aborted) {
+                    this.onError(err instanceof Error ? err : new Error(String(err)));
+                }
+            }
+        }
+        this.processing = false;
+        // If finished and queue is drained, signal done
+        if (this.finished && this.queue.length === 0 && !this.aborted) {
+            this.onDone();
+        }
+    }
+    synthesizeSentence(text) {
+        return new Promise((resolve, reject) => {
+            const voicePath = getVoicePath(this.voice);
+            const proc = spawn('python3', ['-m', 'piper', '-m', voicePath, '--output-raw'], {
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            this.activeProc = proc;
+            proc.stdout.on('data', (chunk) => {
+                // Stream audio chunks directly to the client as they arrive
+                if (!this.aborted) {
+                    this.onAudio(chunk);
+                }
+            });
+            proc.on('error', err => {
+                this.activeProc = null;
+                reject(err);
+            });
+            proc.on('close', code => {
+                this.activeProc = null;
+                if (code !== 0) {
+                    reject(new Error(`Piper exited with code ${code}`));
+                }
+                else {
+                    resolve();
+                }
+            });
+            proc.stdin.write(text);
+            proc.stdin.end();
+        });
+    }
+}
+//# sourceMappingURL=voice-tts.js.map

package/dist/gateway/voice-tts.js.map

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

package/dist/lib/version-check.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Version check module — checks npm registry for newer published versions.
+ * Non-blocking, never throws. Caches results for 1 hour.
+ */
+export interface VersionInfo {
+    current: string;
+    latest: string;
+    updateAvailable: boolean;
+    releaseNotes?: string;
+}
+export interface UpdateState {
+    previousVersion: string;
+    updatedAt: string;
+    updatedFrom: string;
+    updatedTo: string;
+}
+/** Get the current installed version from package.json */
+export declare function getCurrentVersion(): string;
+/** Simple semver compare: returns true if latest > current */
+export declare function isNewer(latest: string, current: string): boolean;
+/** Count minor version gap (e.g., 0.28.7 → 0.30.0 = 2) */
+export declare function minorVersionGap(latest: string, current: string): number;
+/**
+ * Check for available updates. Caches result for 1 hour.
+ * Never throws — returns { updateAvailable: false } on any error.
+ */
+export declare function checkForUpdate(skipCache?: boolean): Promise<VersionInfo>;
+/** Clear the cache (useful after an update) */
+export declare function clearVersionCache(): void;
+/** Save the current version before updating (for rollback) */
+export declare function saveUpdateState(from: string, to: string): void;
+/** Read the saved update state (for rollback) */
+export declare function readUpdateState(): UpdateState | null;
+/** Check if sudo is needed for global npm install */
+export declare function needsSudo(): Promise<boolean>;
+/** Run the npm install to update to a specific version */
+export declare function performUpdate(version: string): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=version-check.d.ts.map

package/dist/lib/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../src/lib/version-check.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAUD,0DAA0D;AAC1D,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AA+BD,8DAA8D;AAC9D,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAOhE;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMvE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,SAAS,UAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAwB5E;AAED,+CAA+C;AAC/C,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAoCD,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAS9D;AAED,iDAAiD;AACjD,wBAAgB,eAAe,IAAI,WAAW,GAAG,IAAI,CAOpD;AAID,qDAAqD;AACrD,wBAAsB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CASlD;AAED,0DAA0D;AAC1D,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAc/C"}

package/dist/lib/version-check.js

@@ -0,0 +1,181 @@
+/**
+ * Version check module — checks npm registry for newer published versions.
+ * Non-blocking, never throws. Caches results for 1 hour.
+ */
+import * as fs from 'fs';
+import * as https from 'https';
+import { createRequire } from 'module';
+import * as os from 'os';
+import * as path from 'path';
+const _require = createRequire(import.meta.url);
+const PACKAGE_NAME = '@luckydraw/cumulus';
+const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+const CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
+const UPDATE_STATE_FILE = path.join(os.homedir(), '.cumulus', 'update-state.json');
+let cachedResult = null;
+let cacheTimestamp = 0;
+/** Get the current installed version from package.json */
+export function getCurrentVersion() {
+    return _require('../../package.json').version;
+}
+/** Fetch latest version from npm registry */
+function fetchLatestVersion() {
+    return new Promise((resolve, reject) => {
+        const req = https.get(REGISTRY_URL, { headers: { Accept: 'application/json' } }, res => {
+            let data = '';
+            res.on('data', (chunk) => {
+                data += chunk.toString();
+            });
+            res.on('end', () => {
+                try {
+                    const json = JSON.parse(data);
+                    if (json.version) {
+                        resolve(json.version);
+                    }
+                    else {
+                        reject(new Error('No version field in registry response'));
+                    }
+                }
+                catch (e) {
+                    reject(e);
+                }
+            });
+        });
+        req.on('error', reject);
+        req.setTimeout(10000, () => {
+            req.destroy();
+            reject(new Error('Registry request timed out'));
+        });
+    });
+}
+/** Simple semver compare: returns true if latest > current */
+export function isNewer(latest, current) {
+    const parse = (v) => v.replace(/^v/, '').split('.').map(Number);
+    const [lMaj = 0, lMin = 0, lPat = 0] = parse(latest);
+    const [cMaj = 0, cMin = 0, cPat = 0] = parse(current);
+    if (lMaj !== cMaj)
+        return lMaj > cMaj;
+    if (lMin !== cMin)
+        return lMin > cMin;
+    return lPat > cPat;
+}
+/** Count minor version gap (e.g., 0.28.7 → 0.30.0 = 2) */
+export function minorVersionGap(latest, current) {
+    const parse = (v) => v.replace(/^v/, '').split('.').map(Number);
+    const [lMaj = 0, lMin = 0] = parse(latest);
+    const [cMaj = 0, cMin = 0] = parse(current);
+    if (lMaj !== cMaj)
+        return 99; // major version gap
+    return lMin - cMin;
+}
+/**
+ * Check for available updates. Caches result for 1 hour.
+ * Never throws — returns { updateAvailable: false } on any error.
+ */
+export async function checkForUpdate(skipCache = false) {
+    const now = Date.now();
+    if (!skipCache && cachedResult && now - cacheTimestamp < CACHE_TTL_MS) {
+        return cachedResult;
+    }
+    const current = getCurrentVersion();
+    try {
+        const latest = await fetchLatestVersion();
+        const updateAvailable = isNewer(latest, current);
+        const result = { current, latest, updateAvailable };
+        // Try to read release notes from local CHANGELOG.md
+        if (updateAvailable) {
+            result.releaseNotes = readChangelogNotes(current, latest);
+        }
+        cachedResult = result;
+        cacheTimestamp = now;
+        return result;
+    }
+    catch {
+        return { current, latest: current, updateAvailable: false };
+    }
+}
+/** Clear the cache (useful after an update) */
+export function clearVersionCache() {
+    cachedResult = null;
+    cacheTimestamp = 0;
+}
+/** Read release notes from CHANGELOG.md between two versions */
+function readChangelogNotes(fromVersion, toVersion) {
+    try {
+        const changelogPath = path.resolve(_require.resolve('../../package.json'), '..', 'CHANGELOG.md');
+        const content = fs.readFileSync(changelogPath, 'utf-8');
+        // Extract sections between fromVersion and toVersion
+        const lines = content.split('\n');
+        const notes = [];
+        let capturing = false;
+        for (const line of lines) {
+            const versionMatch = line.match(/^## v?(\d+\.\d+\.\d+)/);
+            if (versionMatch) {
+                const v = versionMatch[1];
+                if (v === fromVersion || (!isNewer(v, fromVersion) && v !== toVersion)) {
+                    break; // Stop at or before the current version
+                }
+                capturing = true;
+            }
+            if (capturing) {
+                notes.push(line);
+            }
+        }
+        return notes.length > 0 ? notes.join('\n').trim() : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+// ─── Update state (for rollback) ─────────────────────────────
+/** Save the current version before updating (for rollback) */
+export function saveUpdateState(from, to) {
+    const state = {
+        previousVersion: from,
+        updatedAt: new Date().toISOString(),
+        updatedFrom: from,
+        updatedTo: to,
+    };
+    fs.mkdirSync(path.dirname(UPDATE_STATE_FILE), { recursive: true });
+    fs.writeFileSync(UPDATE_STATE_FILE, JSON.stringify(state, null, 2), 'utf-8');
+}
+/** Read the saved update state (for rollback) */
+export function readUpdateState() {
+    try {
+        const raw = fs.readFileSync(UPDATE_STATE_FILE, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+// ─── Perform update ──────────────────────────────────────────
+/** Check if sudo is needed for global npm install */
+export async function needsSudo() {
+    const { execSync } = await import('child_process');
+    try {
+        const prefix = execSync('npm prefix -g', { encoding: 'utf-8' }).trim();
+        fs.accessSync(prefix, fs.constants.W_OK);
+        return false;
+    }
+    catch {
+        return true;
+    }
+}
+/** Run the npm install to update to a specific version */
+export async function performUpdate(version) {
+    const { execSync } = await import('child_process');
+    const current = getCurrentVersion();
+    const sudo = await needsSudo();
+    const cmd = `${sudo ? 'sudo ' : ''}npm install -g ${PACKAGE_NAME}@${version}`;
+    try {
+        saveUpdateState(current, version);
+        execSync(cmd, { encoding: 'utf-8', stdio: 'pipe', timeout: 120000 });
+        clearVersionCache();
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+}
+//# sourceMappingURL=version-check.js.map

package/dist/lib/version-check.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@luckydraw/cumulus",
-  "version": "0.28.7",
+  "version": "0.28.9",
   "description": "RLM-based CLI chat wrapper for Claude with external history context management",
   "type": "module",
   "main": "dist/index.js",
@@ -24,7 +24,8 @@
   },
   "files": [
     "dist/",
-    "package.json"
+    "package.json",
+    "CHANGELOG.md"
   ],
   "bin": {
     "cumulus": "./dist/cli/cumulus.js",
@@ -40,6 +41,7 @@
     "format:check": "prettier --check \"src/**/*.{ts,tsx,json,md}\"",
     "type-check": "tsc --noEmit",
     "test": "vitest",
+    "preversion": "bash scripts/generate-changelog.sh || true",
     "prepublishOnly": "npm run build && npm run type-check",
     "prepare": "husky"
   },