@infilectai/aira 0.0.0-stage → 0.1.0

package/dist/audio.d.ts

@@ -0,0 +1,26 @@
+import type { AiraEngine } from './engine.js';
+import type { DiarizeOptions, DiarizeResult, LiveTranscriptFrame, SpeakOptions, TranscribeOptions, TranscribeResult } from './types.js';
+export declare class Audio {
+    private readonly engine;
+    constructor(engine: AiraEngine);
+    transcribe(audio: Buffer | Uint8Array, opts?: TranscribeOptions): Promise<TranscribeResult>;
+    diarize(audio: Buffer | Uint8Array, opts?: DiarizeOptions): Promise<DiarizeResult>;
+    /** Buffered: returns a complete WAV (Float32 PCM, 24 kHz mono). */
+    speak(text: string, opts?: SpeakOptions): Promise<Uint8Array>;
+    /** Streams 24 kHz mono Float32 PCM as the engine generates each chunk (~110 ms TTFB). */
+    speakStream(text: string, opts?: SpeakOptions): AsyncGenerator<Uint8Array, void, void>;
+    startLiveTranscription(): LiveSession;
+}
+export declare class LiveSession {
+    private readonly ws;
+    private readonly queue;
+    private readonly waiters;
+    private closed;
+    constructor(url: string);
+    /** Feed 16 kHz mono int16 PCM. */
+    feed(pcm: Int16Array | Uint8Array | Buffer): void;
+    get frames(): AsyncIterable<LiveTranscriptFrame>;
+    ready(): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=audio.d.ts.map

package/dist/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EACV,cAAc,EAAE,aAAa,EAC7B,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EAAE,gBAAgB,EACpC,MAAM,YAAY,CAAA;AAEnB,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEzC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkB/F,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAsB5F,mEAAmE;IAC7D,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAUvE,yFAAyF;IAClF,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC;IAgBjG,sBAAsB,IAAI,WAAW;CAOtC;AAoBD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAW;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA4B;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2D;IACnF,OAAO,CAAC,MAAM,CAAQ;gBAEV,GAAG,EAAE,MAAM;IAoBvB,kCAAkC;IAClC,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,IAAI;IAQjD,IAAI,MAAM,IAAI,aAAa,CAAC,mBAAmB,CAAC,CAmB/C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/dist/audio.js

@@ -0,0 +1,172 @@
+import { WebSocket } from 'ws';
+export class Audio {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    async transcribe(audio, opts = {}) {
+        if (this.engine.sttProvider?.transcribe) {
+            return this.engine.sttProvider.transcribe(audio, opts);
+        }
+        if (!this.engine.baseUrl) {
+            throw new Error('No STT provider or AiraEngine baseUrl configured. Pass `stt` to AiraEngine.create({ stt: ... }).');
+        }
+        const form = new FormData();
+        form.set('file', new Blob([toBlobPart(audio)]), 'audio.wav');
+        if (opts.model)
+            form.set('model', opts.model);
+        if (opts.language)
+            form.set('language', opts.language);
+        if (opts.prompt)
+            form.set('prompt', opts.prompt);
+        return this.engine.http.json('/v1/audio/transcriptions', {
+            method: 'POST',
+            body: form,
+        });
+    }
+    async diarize(audio, opts = {}) {
+        if (this.engine.diarizationProvider) {
+            return this.engine.diarizationProvider.diarize(audio, opts);
+        }
+        if (!this.engine.baseUrl) {
+            throw new Error('No Diarization provider or AiraEngine baseUrl configured. Pass `diarize` to AiraEngine.create({ diarize: ... }).');
+        }
+        const form = new FormData();
+        form.set('file', new Blob([toBlobPart(audio)]), 'audio.wav');
+        if (opts.numSpeakers)
+            form.set('num_speakers', String(opts.numSpeakers));
+        const raw = await this.engine.http.json('/v1/audio/diarize', { method: 'POST', body: form });
+        return {
+            numSpeakers: raw.num_speakers,
+            scores: raw.scores,
+            segments: raw.segments,
+        };
+    }
+    /** Buffered: returns a complete WAV (Float32 PCM, 24 kHz mono). */
+    async speak(text, opts = {}) {
+        const res = await this.engine.http.raw('/v1/audio/speech', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(speakBody(text, opts, false)),
+            signal: opts.signal,
+        });
+        return new Uint8Array(await res.arrayBuffer());
+    }
+    /** Streams 24 kHz mono Float32 PCM as the engine generates each chunk (~110 ms TTFB). */
+    async *speakStream(text, opts = {}) {
+        const res = await this.engine.http.raw('/v1/audio/speech', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(speakBody(text, opts, true)),
+            signal: opts.signal,
+        });
+        if (!res.body)
+            return;
+        const reader = res.body.getReader();
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                return;
+            if (value)
+                yield value;
+        }
+    }
+    startLiveTranscription() {
+        if (!this.engine.baseUrl) {
+            throw new Error('startLiveTranscription requires baseUrl or AiraEngine provider');
+        }
+        const wsUrl = this.engine.baseUrl.replace(/^http/, 'ws') + '/v1/audio/stream';
+        return new LiveSession(wsUrl);
+    }
+}
+// `Buffer`/`Uint8Array<ArrayBufferLike>` could in theory carry a SharedArrayBuffer;
+// the DOM Blob constructor wants an ArrayBuffer-backed view. Narrow without copying.
+function toBlobPart(bytes) {
+    return new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+}
+function speakBody(input, o, stream) {
+    return {
+        input,
+        voice: o.voice,
+        language: o.language,
+        format: stream ? 'stream' : 'wav',
+        temperature: o.temperature,
+        top_k: o.topK,
+        instruction: o.instruction,
+    };
+}
+export class LiveSession {
+    ws;
+    queue = [];
+    waiters = [];
+    closed = false;
+    constructor(url) {
+        this.ws = new WebSocket(url);
+        this.ws.on('message', (data, isBinary) => {
+            if (isBinary)
+                return;
+            try {
+                const frame = JSON.parse(data.toString());
+                const w = this.waiters.shift();
+                if (w)
+                    w({ value: frame, done: false });
+                else
+                    this.queue.push(frame);
+            }
+            catch { /* ignore malformed frames */ }
+        });
+        this.ws.on('close', () => {
+            this.closed = true;
+            while (this.waiters.length) {
+                const w = this.waiters.shift();
+                w({ value: undefined, done: true });
+            }
+        });
+    }
+    /** Feed 16 kHz mono int16 PCM. */
+    feed(pcm) {
+        if (this.closed)
+            throw new Error('LiveSession is closed');
+        const bytes = pcm instanceof Int16Array
+            ? Buffer.from(pcm.buffer, pcm.byteOffset, pcm.byteLength)
+            : pcm;
+        this.ws.send(bytes);
+    }
+    get frames() {
+        const queue = this.queue;
+        const waiters = this.waiters;
+        const isClosed = () => this.closed;
+        return {
+            [Symbol.asyncIterator]() {
+                return {
+                    next() {
+                        if (queue.length) {
+                            return Promise.resolve({ value: queue.shift(), done: false });
+                        }
+                        if (isClosed()) {
+                            return Promise.resolve({ value: undefined, done: true });
+                        }
+                        return new Promise((resolve) => waiters.push(resolve));
+                    },
+                };
+            },
+        };
+    }
+    async ready() {
+        if (this.ws.readyState === WebSocket.OPEN)
+            return;
+        await new Promise((resolve, reject) => {
+            this.ws.once('open', () => resolve());
+            this.ws.once('error', reject);
+        });
+    }
+    async close() {
+        if (this.closed)
+            return;
+        if (this.ws.readyState === WebSocket.OPEN) {
+            this.ws.send(JSON.stringify({ type: 'end' }));
+        }
+        await new Promise((resolve) => this.ws.once('close', () => resolve()));
+    }
+}
+//# sourceMappingURL=audio.js.map

package/dist/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAA;AAU9B,MAAM,OAAO,KAAK;IACa;IAA7B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;IAAG,CAAC;IAEnD,KAAK,CAAC,UAAU,CAAC,KAA0B,EAAE,OAA0B,EAAE;QACvE,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QACxD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,kGAAkG,CAAC,CAAA;QACrH,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAA;QAC3B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAA;QAC5D,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;QAC7C,IAAI,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;QACtD,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QAChD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAmB,0BAA0B,EAAE;YACzE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;SACX,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA0B,EAAE,OAAuB,EAAE;QACjE,IAAI,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAC7D,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,kHAAkH,CAAC,CAAA;QACrI,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAA;QAC3B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAA;QAC5D,IAAI,IAAI,CAAC,WAAW;YAAE,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAA;QACxE,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAIpC,mBAAmB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACvD,OAAO;YACL,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB,CAAA;IACH,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,OAAqB,EAAE;QAC/C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE;YACzD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAClD,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAA;QACF,OAAO,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAA;IAChD,CAAC;IAED,yFAAyF;IACzF,KAAK,CAAC,CAAC,WAAW,CAAC,IAAY,EAAE,OAAqB,EAAE;QACtD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE;YACzD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;YACjD,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,OAAM;QACrB,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;QACnC,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;YAC3C,IAAI,IAAI;gBAAE,OAAM;YAChB,IAAI,KAAK;gBAAE,MAAM,KAAK,CAAA;QACxB,CAAC;IACH,CAAC;IAED,sBAAsB;QACpB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAA;QACnF,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,kBAAkB,CAAA;QAC7E,OAAO,IAAI,WAAW,CAAC,KAAK,CAAC,CAAA;IAC/B,CAAC;CACF;AAED,oFAAoF;AACpF,qFAAqF;AACrF,SAAS,UAAU,CAAC,KAA0B;IAC5C,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,MAAqB,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;AACxF,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,CAAe,EAAE,MAAe;IAChE,OAAO;QACL,KAAK;QACL,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;QACjC,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,KAAK,EAAE,CAAC,CAAC,IAAI;QACb,WAAW,EAAE,CAAC,CAAC,WAAW;KAC3B,CAAA;AACH,CAAC;AAED,MAAM,OAAO,WAAW;IACL,EAAE,CAAW;IACb,KAAK,GAA0B,EAAE,CAAA;IACjC,OAAO,GAAyD,EAAE,CAAA;IAC3E,MAAM,GAAG,KAAK,CAAA;IAEtB,YAAY,GAAW;QACrB,IAAI,CAAC,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAA;QAC5B,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE;YACvC,IAAI,QAAQ;gBAAE,OAAM;YACpB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAwB,CAAA;gBAChE,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;gBAC9B,IAAI,CAAC;oBAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;;oBAClC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC7B,CAAC;YAAC,MAAM,CAAC,CAAC,6BAA6B,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;YAClB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAG,CAAA;gBAC/B,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YACrC,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,kCAAkC;IAClC,IAAI,CAAC,GAAqC;QACxC,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;QACzD,MAAM,KAAK,GAAG,GAAG,YAAY,UAAU;YACrC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC;YACzD,CAAC,CAAC,GAAG,CAAA;QACP,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACrB,CAAC;IAED,IAAI,MAAM;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC5B,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAA;QAClC,OAAO;YACL,CAAC,MAAM,CAAC,aAAa,CAAC;gBACpB,OAAO;oBACL,IAAI;wBACF,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;4BACjB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;wBAChE,CAAC;wBACD,IAAI,QAAQ,EAAE,EAAE,CAAC;4BACf,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;wBAC1D,CAAC;wBACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;oBACxD,CAAC;iBACF,CAAA;YACH,CAAC;SACF,CAAA;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;YAAE,OAAM;QACjD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAA;YACrC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAC/B,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM;YAAE,OAAM;QACvB,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YAC1C,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;QAC/C,CAAC;QACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IAC9E,CAAC;CACF"}

package/dist/brain.d.ts

@@ -0,0 +1,11 @@
+import type { AiraEngine } from './engine.js';
+import type { ChatChunk, ChatMessage, ChatOptions, ChatResult } from './types.js';
+export declare class Brain {
+    private readonly engine;
+    constructor(engine: AiraEngine);
+    chat(messages: ChatMessage[], opts?: ChatOptions): Promise<ChatResult>;
+    chatStream(messages: ChatMessage[], opts?: ChatOptions): AsyncGenerator<ChatChunk, void, void>;
+    embed(input: string): Promise<Float32Array>;
+    embed(input: string[]): Promise<Float32Array[]>;
+}
+//# sourceMappingURL=brain.d.ts.map

package/dist/brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../src/brain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEjF,qBAAa,KAAK;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEzC,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAazE,UAAU,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC;IAsCnG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAStD"}

package/dist/brain.js

@@ -0,0 +1,70 @@
+export class Brain {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    async chat(messages, opts = {}) {
+        const raw = await this.engine.http.post('/v1/chat/completions', { ...openaiChatBody(messages, opts), stream: false });
+        return {
+            id: raw.id,
+            model: raw.model,
+            content: raw.choices[0]?.message.content ?? '',
+        };
+    }
+    async *chatStream(messages, opts = {}) {
+        const res = await this.engine.http.raw('/v1/chat/completions', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ ...openaiChatBody(messages, opts), stream: true }),
+            signal: opts.signal,
+        });
+        if (!res.body)
+            return;
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buf = '';
+        let id = '';
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            buf += decoder.decode(value, { stream: true });
+            let nl;
+            while ((nl = buf.indexOf('\n\n')) >= 0) {
+                const event = buf.slice(0, nl);
+                buf = buf.slice(nl + 2);
+                const line = event.startsWith('data: ') ? event.slice(6) : event;
+                if (line === '[DONE]') {
+                    yield { id, delta: '', done: true };
+                    return;
+                }
+                try {
+                    const json = JSON.parse(line);
+                    if (json.id)
+                        id = json.id;
+                    const delta = json.choices?.[0]?.delta?.content ?? '';
+                    if (delta)
+                        yield { id, delta, done: false };
+                }
+                catch { /* SSE keep-alive or malformed line */ }
+            }
+        }
+    }
+    async embed(input) {
+        const raw = await this.engine.http.post('/v1/embeddings', { input });
+        const sorted = [...raw.data].sort((a, b) => a.index - b.index);
+        const vecs = sorted.map((d) => Float32Array.from(d.embedding));
+        return Array.isArray(input) ? vecs : vecs[0];
+    }
+}
+function openaiChatBody(messages, opts) {
+    return {
+        model: opts.model,
+        messages,
+        temperature: opts.temperature,
+        top_p: opts.topP,
+        top_k: opts.topK,
+        max_tokens: opts.maxTokens,
+    };
+}
+//# sourceMappingURL=brain.js.map

package/dist/brain.js.map

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

package/dist/capture.d.ts

@@ -0,0 +1,48 @@
+import { EventEmitter } from 'node:events';
+import type { ChromeEvent, MeetingTarget, Participant } from './types.js';
+export interface CaptureRosterPayload {
+    participants: Participant[];
+    localUserId: string;
+    localUserName: string;
+}
+export interface CaptureSpeakerPayload {
+    participantId: string;
+    name: string;
+    t: number;
+    source: string;
+}
+export interface CaptureAudioPayload {
+    pcm: Buffer;
+    t0: number;
+    t1: number;
+    sysRMS: number;
+    micRMS: number;
+    micActive: boolean;
+}
+/**
+ * Lightweight stdio bridge to the zero-dependency `bin/aira-capture` macOS binary.
+ * Handles meeting detection, native AX/DOM speaker scraping (Zoom, Meet, Teams),
+ * CoreAudio Process Tap system audio capture, and microphone RMS monitoring.
+ */
+export declare class NativeCaptureBridge extends EventEmitter {
+    private child;
+    private rl;
+    private nextId;
+    private readonly pending;
+    private readyPromise;
+    private readonly captureBinPath;
+    constructor(captureBinPath?: string);
+    ensureStarted(): Promise<void>;
+    private handleEvent;
+    private rejectAllPending;
+    sendCommand<T = any>(command: string, params?: Record<string, unknown>): Promise<T>;
+    checkPermissions(prompt?: boolean): Promise<Record<string, 'granted' | 'denied'>>;
+    watchMeetings(): Promise<void>;
+    stopWatchingMeetings(): Promise<void>;
+    startCapture(target: MeetingTarget): Promise<void>;
+    stopCapture(): Promise<void>;
+    pushChromeEvent(event: ChromeEvent): Promise<void>;
+    close(): Promise<void>;
+}
+export declare function resolveCaptureBinPath(explicit?: string): string;
+//# sourceMappingURL=capture.d.ts.map

package/dist/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAM1C,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAOzE,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,WAAW,EAAE,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,CAAC,EAAE,MAAM,CAAA;IACT,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,OAAO,CAAA;CACnB;AAOD;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,YAAY;IACnD,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,EAAE,CAAkC;IAC5C,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;gBAE3B,cAAc,CAAC,EAAE,MAAM;IAK7B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA8EpC,OAAO,CAAC,WAAW;IAgBnB,OAAO,CAAC,gBAAgB;IAOlB,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBvF,gBAAgB,CAAC,MAAM,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC,CAAC;IAI/E,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAoB7B;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ/D"}

package/dist/capture.js

@@ -0,0 +1,195 @@
+import { spawn } from 'node:child_process';
+import { EventEmitter } from 'node:events';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as readline from 'node:readline';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PROTOCOL_PREFIX = 'aira_capture|';
+/**
+ * Lightweight stdio bridge to the zero-dependency `bin/aira-capture` macOS binary.
+ * Handles meeting detection, native AX/DOM speaker scraping (Zoom, Meet, Teams),
+ * CoreAudio Process Tap system audio capture, and microphone RMS monitoring.
+ */
+export class NativeCaptureBridge extends EventEmitter {
+    child = null;
+    rl = null;
+    nextId = 1;
+    pending = new Map();
+    readyPromise = null;
+    captureBinPath;
+    constructor(captureBinPath) {
+        super();
+        this.captureBinPath = resolveCaptureBinPath(captureBinPath);
+    }
+    async ensureStarted() {
+        if (this.child && this.child.exitCode === null && !this.child.killed) {
+            if (this.readyPromise)
+                await this.readyPromise;
+            return;
+        }
+        this.readyPromise = new Promise((resolve, reject) => {
+            const child = spawn(this.captureBinPath, [], {
+                stdio: ['pipe', 'pipe', 'inherit'],
+            });
+            this.child = child;
+            if (!child.stdout || !child.stdin) {
+                reject(new Error(`Failed to spawn ${this.captureBinPath}`));
+                return;
+            }
+            let settled = false;
+            const timer = setTimeout(() => {
+                if (!settled) {
+                    settled = true;
+                    reject(new Error('aira-capture did not announce ready within 10s'));
+                }
+            }, 10_000);
+            this.rl = readline.createInterface({ input: child.stdout, crlfDelay: Infinity });
+            this.rl.on('line', (line) => {
+                if (!line.startsWith(PROTOCOL_PREFIX))
+                    return;
+                try {
+                    const msg = JSON.parse(line.slice(PROTOCOL_PREFIX.length));
+                    if (msg.type === 'event') {
+                        if (msg.event === 'ready' && !settled) {
+                            settled = true;
+                            clearTimeout(timer);
+                            resolve();
+                        }
+                        this.handleEvent(msg.event, msg.payload);
+                    }
+                    else if (msg.type === 'response') {
+                        const p = this.pending.get(msg.id);
+                        if (p) {
+                            this.pending.delete(msg.id);
+                            if (msg.status === 'success')
+                                p.resolve(msg.result);
+                            else
+                                p.reject(new Error(msg.error ?? 'aira-capture command failed'));
+                        }
+                    }
+                }
+                catch {
+                    // ignore malformed line
+                }
+            });
+            child.once('error', (err) => {
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(timer);
+                    reject(err);
+                }
+                this.rejectAllPending(err);
+            });
+            child.once('exit', (code, signal) => {
+                this.rl?.close();
+                this.rl = null;
+                this.child = null;
+                this.readyPromise = null;
+                const err = new Error(`aira-capture exited (code=${code}, signal=${signal})`);
+                if (!settled) {
+                    settled = true;
+                    clearTimeout(timer);
+                    reject(err);
+                }
+                this.rejectAllPending(err);
+                this.emit('exit', code, signal);
+            });
+        });
+        await this.readyPromise;
+    }
+    handleEvent(event, payload) {
+        if (event === 'audio' && payload?.pcmBase64) {
+            const audioPayload = {
+                pcm: Buffer.from(payload.pcmBase64, 'base64'),
+                t0: payload.t0,
+                t1: payload.t1,
+                sysRMS: payload.sysRMS,
+                micRMS: payload.micRMS,
+                micActive: Boolean(payload.micActive),
+            };
+            this.emit('audio', audioPayload);
+            return;
+        }
+        this.emit(event, payload);
+    }
+    rejectAllPending(err) {
+        for (const [, p] of this.pending) {
+            p.reject(err);
+        }
+        this.pending.clear();
+    }
+    async sendCommand(command, params = {}) {
+        await this.ensureStarted();
+        const stdin = this.child?.stdin;
+        if (!stdin || stdin.destroyed || !stdin.writable) {
+            throw new Error('aira-capture stdin is not writable');
+        }
+        const id = String(this.nextId++);
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+            const line = JSON.stringify({ id, command, ...params }) + '\n';
+            stdin.write(line, (err) => {
+                if (err) {
+                    this.pending.delete(id);
+                    reject(err);
+                }
+            });
+        });
+    }
+    async checkPermissions(prompt = false) {
+        return this.sendCommand('checkPermissions', { prompt });
+    }
+    async watchMeetings() {
+        await this.sendCommand('watchMeetings');
+    }
+    async stopWatchingMeetings() {
+        await this.sendCommand('stopWatchingMeetings');
+    }
+    async startCapture(target) {
+        await this.sendCommand('startCapture', { target });
+    }
+    async stopCapture() {
+        if (!this.child)
+            return;
+        await this.sendCommand('stopCapture');
+    }
+    async pushChromeEvent(event) {
+        await this.sendCommand('pushChromeEvent', { event });
+    }
+    async close() {
+        if (!this.child)
+            return;
+        const proc = this.child;
+        try {
+            await this.sendCommand('shutdown');
+        }
+        catch {
+            proc.kill('SIGTERM');
+        }
+        await new Promise((resolve) => {
+            if (proc.exitCode !== null)
+                return resolve();
+            const timer = setTimeout(() => {
+                proc.kill('SIGKILL');
+                resolve();
+            }, 2_000);
+            proc.once('exit', () => {
+                clearTimeout(timer);
+                resolve();
+            });
+        });
+    }
+}
+export function resolveCaptureBinPath(explicit) {
+    if (explicit)
+        return explicit;
+    if (process.env.AIRA_CAPTURE_BIN)
+        return process.env.AIRA_CAPTURE_BIN;
+    const candidate = path.resolve(__dirname, '..', 'bin', 'aira-capture');
+    if (fs.existsSync(candidate))
+        return candidate;
+    throw new Error(`aira-capture binary not found at ${candidate}. Run \`npm run build:capture\` or set AIRA_CAPTURE_BIN.`);
+}
+//# sourceMappingURL=capture.js.map

package/dist/capture.js.map

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

package/dist/engine.d.ts

@@ -0,0 +1,61 @@
+import { EventEmitter } from 'node:events';
+import { Audio } from './audio.js';
+import { Brain } from './brain.js';
+import { NativeCaptureBridge } from './capture.js';
+import { Eyes, type EyesSession, type MeetingWatcher } from './eyes.js';
+import { type DiarizationProvider, type STTProvider } from './providers.js';
+import { HttpClient } from './transport.js';
+import type { AiraEngineOptions, ChromeEvent, DiarizationProviderInput, HealthResponse, MeetingTarget, STTProviderInput, StartMeetingOptions } from './types.js';
+export declare function resolveSTTProvider(input?: STTProviderInput): STTProvider | undefined;
+export declare function resolveDiarizationProvider(input?: DiarizationProviderInput): DiarizationProvider | undefined;
+export declare class AiraEngine extends EventEmitter {
+    private readonly child;
+    private readonly lockfile;
+    readonly baseUrl: string;
+    readonly http: HttpClient;
+    readonly audio: Audio;
+    readonly brain: Brain;
+    readonly eyes: Eyes;
+    readonly capture: NativeCaptureBridge;
+    sttProvider?: STTProvider;
+    diarizationProvider?: DiarizationProvider;
+    private constructor();
+    /**
+     * Configure or swap the STT / Diarization providers at runtime.
+     */
+    setProviders(opts: {
+        stt?: STTProviderInput;
+        diarize?: DiarizationProviderInput;
+    }): void;
+    /**
+     * Downloads the required GGUF models directly to the modelsDir (when using the optional AiraEngine provider).
+     */
+    static downloadModels(opts?: AiraEngineOptions): Promise<void>;
+    /**
+     * Creates an Aira SDK instance.
+     *
+     * - Always starts the lightweight `aira-capture` helper (~450 KB, zero external deps) for
+     *   macOS meeting detection, native AX/DOM speaker scraping, and CoreAudio capture.
+     * - If `stt` / `diarize` endpoints or callbacks are passed (and no `baseUrl` / `enginePath`),
+     *   runs completely standalone without spawning `aira-engine`!
+     * - If `baseUrl` is passed, or an `aira-engine` binary is configured/discovered, wires
+     *   `AiraEngineProvider` as the default STT/Diarization/LLM provider.
+     */
+    static create(opts?: AiraEngineOptions): Promise<AiraEngine>;
+    health(): Promise<HealthResponse>;
+    /**
+     * Starts an attributed-transcript meeting session.
+     * Accepts optional per-session `stt` and `diarize` overrides.
+     */
+    startMeeting(target: MeetingTarget, opts?: StartMeetingOptions): EyesSession;
+    watchActiveMeetings(): MeetingWatcher;
+    onMeetingDetected(callback: (meeting: MeetingTarget) => void): MeetingWatcher;
+    pushChromeEvent(event: ChromeEvent): Promise<void>;
+    checkPermissions(prompt?: boolean): Promise<Record<string, 'granted' | 'denied'>>;
+    summarize(text: string): Promise<string>;
+    embed(text: string | string[]): Promise<Float32Array[]>;
+    close(): Promise<void>;
+    private waitForHealth;
+}
+export { AiraEngine as Aira };
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAM1C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AAEvE,OAAO,EAOL,KAAK,mBAAmB,EACxB,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACX,wBAAwB,EACxB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,YAAY,CAAA;AAUnB,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,WAAW,GAAG,SAAS,CAqBpF;AAED,wBAAgB,0BAA0B,CACxC,KAAK,CAAC,EAAE,wBAAwB,GAC/B,mBAAmB,GAAG,SAAS,CAejC;AAED,qBAAa,UAAW,SAAQ,YAAY;IAYxC,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAZ3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAA;IACrC,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;IAEzC,OAAO;IA0BP;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,gBAAgB,CAAC;QAAC,OAAO,CAAC,EAAE,wBAAwB,CAAA;KAAE,GAAG,IAAI;IASxF;;OAEG;WACU,cAAc,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAsGxE;;;;;;;;;OASG;WACU,MAAM,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC;IAgHhE,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAcvC;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,GAAE,mBAAwB,GAAG,WAAW;IAwBhF,mBAAmB,IAAI,cAAc;IAIrC,iBAAiB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,cAAc;IAiBvE,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,gBAAgB,CAAC,MAAM,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC,CAAC;IAI/E,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUxC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAoBvD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAiBd,aAAa;CAc5B;AAED,OAAO,EAAE,UAAU,IAAI,IAAI,EAAE,CAAA"}