@pellux/goodvibes-sdk 1.0.0 → 1.2.0

package/dist/platform/voice/spoken-turn/text-chunker.js

@@ -0,0 +1,97 @@
+export class TtsTextChunker {
+    buffer = '';
+    firstBufferedAt = null;
+    minBoundaryChars;
+    maxChunkChars;
+    maxLatencyMs;
+    now;
+    constructor(options = {}) {
+        this.minBoundaryChars = options.minBoundaryChars ?? 24;
+        this.maxChunkChars = options.maxChunkChars ?? 320;
+        this.maxLatencyMs = options.maxLatencyMs ?? 1_000;
+        this.now = options.now ?? (() => Date.now());
+    }
+    push(delta) {
+        if (!delta)
+            return [];
+        if (this.firstBufferedAt === null)
+            this.firstBufferedAt = this.now();
+        this.buffer += delta;
+        return this.drainReady(false);
+    }
+    flushDue() {
+        if (!this.buffer.trim() || this.firstBufferedAt === null)
+            return [];
+        if (this.now() - this.firstBufferedAt < this.maxLatencyMs)
+            return [];
+        return this.drainReady(true);
+    }
+    flushAll() {
+        if (!this.buffer.trim()) {
+            this.buffer = '';
+            this.firstBufferedAt = null;
+            return [];
+        }
+        return [this.takeChunk(this.buffer.length)].filter(Boolean);
+    }
+    reset() {
+        this.buffer = '';
+        this.firstBufferedAt = null;
+    }
+    drainReady(forceLatencyFlush) {
+        const chunks = [];
+        while (this.buffer.trim()) {
+            const boundary = this.findBoundary(forceLatencyFlush);
+            if (boundary <= 0)
+                break;
+            const chunk = this.takeChunk(boundary);
+            if (chunk)
+                chunks.push(chunk);
+            forceLatencyFlush = false;
+        }
+        return chunks;
+    }
+    findBoundary(forceLatencyFlush) {
+        const latestSentence = this.findLatestSentenceBoundary();
+        if (latestSentence >= this.minBoundaryChars)
+            return latestSentence;
+        if (this.buffer.length >= this.maxChunkChars) {
+            return this.findWordBoundaryBefore(this.maxChunkChars) || this.maxChunkChars;
+        }
+        if (forceLatencyFlush) {
+            return this.buffer.length;
+        }
+        return -1;
+    }
+    findLatestSentenceBoundary() {
+        let best = -1;
+        for (let i = 0; i < this.buffer.length; i++) {
+            const char = this.buffer[i];
+            if (char !== '.' && char !== '!' && char !== '?' && char !== ';' && char !== ':' && char !== '\n') {
+                continue;
+            }
+            const next = this.buffer[i + 1];
+            if (i === this.buffer.length - 1 || next === undefined || /\s/.test(next)) {
+                best = i + 1;
+            }
+        }
+        return best;
+    }
+    findWordBoundaryBefore(index) {
+        const max = Math.min(index, this.buffer.length);
+        for (let i = max; i > 0; i--) {
+            if (/\s/.test(this.buffer[i - 1] ?? ''))
+                return i;
+        }
+        return -1;
+    }
+    takeChunk(end) {
+        const raw = this.buffer.slice(0, end);
+        this.buffer = this.buffer.slice(end);
+        this.firstBufferedAt = this.buffer.trim() ? this.now() : null;
+        return normalizeSpeechText(raw);
+    }
+}
+export function normalizeSpeechText(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pellux/goodvibes-sdk",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "TypeScript SDK for building GoodVibes operator, peer, web, mobile, and daemon-connected apps with typed contracts, auth, realtime events, and transport layers.",
   "keywords": [
     "goodvibes",
@@ -348,6 +348,10 @@
       "types": "./dist/platform/runtime/sandbox.d.ts",
       "import": "./dist/platform/runtime/sandbox.js"
     },
+    "./platform/runtime/memory-spine": {
+      "types": "./dist/platform/runtime/memory-spine/index.d.ts",
+      "import": "./dist/platform/runtime/memory-spine/index.js"
+    },
     "./platform/runtime/session-spine": {
       "types": "./dist/platform/runtime/session-spine/index.d.ts",
       "import": "./dist/platform/runtime/session-spine/index.js"
@@ -473,14 +477,14 @@
   "sideEffects": false,
   "type": "module",
   "dependencies": {
-    "@pellux/goodvibes-contracts": "1.0.0",
-    "@pellux/goodvibes-daemon-sdk": "1.0.0",
-    "@pellux/goodvibes-errors": "1.0.0",
-    "@pellux/goodvibes-operator-sdk": "1.0.0",
-    "@pellux/goodvibes-peer-sdk": "1.0.0",
-    "@pellux/goodvibes-transport-core": "1.0.0",
-    "@pellux/goodvibes-transport-http": "1.0.0",
-    "@pellux/goodvibes-transport-realtime": "1.0.0"
+    "@pellux/goodvibes-contracts": "1.2.0",
+    "@pellux/goodvibes-daemon-sdk": "1.2.0",
+    "@pellux/goodvibes-errors": "1.2.0",
+    "@pellux/goodvibes-operator-sdk": "1.2.0",
+    "@pellux/goodvibes-peer-sdk": "1.2.0",
+    "@pellux/goodvibes-transport-core": "1.2.0",
+    "@pellux/goodvibes-transport-http": "1.2.0",
+    "@pellux/goodvibes-transport-realtime": "1.2.0"
   },
   "optionalDependencies": {
     "@agentclientprotocol/sdk": "^0.21.0",