@infilectai/aira 0.0.0-stage → 0.1.0

package/dist/eyes.js

@@ -0,0 +1,173 @@
+import { EventEmitter } from 'node:events';
+import { MeetingSessionPipeline } from './attribution.js';
+import { resolveDiarizationProvider, resolveSTTProvider } from './engine.js';
+/**
+ * Aira Eyes: macOS meeting detection, native AX/DOM speaker scraping,
+ * CoreAudio Process Tap capture, and pluggable STT/Diarization attribution.
+ */
+export class Eyes {
+    engine;
+    capture;
+    constructor(engine, capture) {
+        this.engine = engine;
+        this.capture = capture;
+    }
+    /** Forward visual state from an extension or webview. */
+    async pushChromeEvent(event) {
+        await this.capture.pushChromeEvent(event);
+    }
+    /**
+     * Check or prompt for macOS permissions (`accessibility`, `screen-capture`, `microphone`, `system-audio`).
+     */
+    async checkPermissions(prompt = false) {
+        return this.capture.checkPermissions(prompt);
+    }
+    /**
+     * Open a live attributed-transcript session using `aira-capture` and the configured
+     * (or per-session overridden) `STTProvider` and `DiarizationProvider`.
+     */
+    start(target, opts = {}) {
+        const stt = opts.stt ? resolveSTTProvider(opts.stt) : this.engine.sttProvider;
+        const diarize = opts.diarize ? resolveDiarizationProvider(opts.diarize) : this.engine.diarizationProvider;
+        return new EyesSession(this.capture, target, {
+            stt,
+            diarize,
+            transcribeOptions: opts.transcribeOptions,
+            batchChunkSeconds: opts.batchChunkSeconds,
+        });
+    }
+    /**
+     * Watch for active meeting targets on the local machine.
+     */
+    watchMeetings() {
+        return new MeetingWatcher(this.capture);
+    }
+}
+export class EyesSession extends EventEmitter {
+    capture;
+    target;
+    queue = [];
+    waiters = [];
+    pipeline;
+    startPromise;
+    closed = false;
+    onRosterBound;
+    onSpeakerActivityBound;
+    onSpeakerChangeBound;
+    onAudioBound;
+    constructor(capture, target, opts) {
+        super();
+        this.capture = capture;
+        this.target = target;
+        const pipeline = new MeetingSessionPipeline({
+            stt: opts.stt,
+            diarize: opts.diarize,
+            transcribeOptions: opts.transcribeOptions,
+            batchChunkSeconds: opts.batchChunkSeconds,
+            onEvent: (frame) => this.pushFrame(frame),
+        });
+        this.pipeline = pipeline;
+        this.onRosterBound = (p) => pipeline.handleRoster(p);
+        this.onSpeakerActivityBound = (p) => pipeline.handleSpeakerActivity(p);
+        this.onSpeakerChangeBound = (p) => pipeline.handleSpeakerChange(p);
+        this.onAudioBound = (chunk) => {
+            this.emit('audio', chunk);
+            pipeline.handleAudio(chunk);
+        };
+        this.capture.on('roster', this.onRosterBound);
+        this.capture.on('speaker_activity', this.onSpeakerActivityBound);
+        this.capture.on('speaker_change', this.onSpeakerChangeBound);
+        this.capture.on('audio', this.onAudioBound);
+        this.startPromise = (async () => {
+            await pipeline.start();
+            await this.capture.startCapture(target);
+        })();
+        this.startPromise.catch((err) => {
+            this.pushFrame({
+                type: 'error',
+                message: err instanceof Error ? err.message : String(err),
+            });
+        });
+    }
+    pushFrame(frame) {
+        if (this.closed)
+            return;
+        const w = this.waiters.shift();
+        if (w)
+            w({ value: frame, done: false });
+        else
+            this.queue.push(frame);
+    }
+    get events() {
+        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() {
+        await this.startPromise;
+    }
+    async close() {
+        if (this.closed)
+            return;
+        this.capture.off('roster', this.onRosterBound);
+        this.capture.off('speaker_activity', this.onSpeakerActivityBound);
+        this.capture.off('speaker_change', this.onSpeakerChangeBound);
+        this.capture.off('audio', this.onAudioBound);
+        await this.capture.stopCapture().catch(() => { });
+        await this.pipeline.stop().catch(() => { });
+        this.closed = true;
+        while (this.waiters.length) {
+            const w = this.waiters.shift();
+            w({ value: undefined, done: true });
+        }
+    }
+}
+export class MeetingWatcher extends EventEmitter {
+    capture;
+    closed = false;
+    onMeetingsBound;
+    constructor(capture) {
+        super();
+        this.capture = capture;
+        this.onMeetingsBound = (meetings) => {
+            if (!this.closed) {
+                this.emit('meetings', meetings);
+            }
+        };
+        this.capture.on('meetings', this.onMeetingsBound);
+        this.capture
+            .watchMeetings()
+            .then(() => {
+            if (!this.closed)
+                this.emit('ready');
+        })
+            .catch((err) => {
+            if (!this.closed)
+                this.emit('error', err);
+        });
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.capture.off('meetings', this.onMeetingsBound);
+        void this.capture.stopWatchingMeetings().catch(() => { });
+        this.emit('close');
+    }
+}
+//# sourceMappingURL=eyes.js.map

package/dist/eyes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eyes.js","sourceRoot":"","sources":["../src/eyes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAQzD,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAQ5E;;;GAGG;AACH,MAAM,OAAO,IAAI;IAEI;IACA;IAFnB,YACmB,MAAkB,EAClB,OAA4B;QAD5B,WAAM,GAAN,MAAM,CAAY;QAClB,YAAO,GAAP,OAAO,CAAqB;IAC5C,CAAC;IAEJ,yDAAyD;IACzD,KAAK,CAAC,eAAe,CAAC,KAAkB;QACtC,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,KAAK;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAC9C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAqB,EAAE,OAA4B,EAAE;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAA;QAC7E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAA;QACzG,OAAO,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE;YAC3C,GAAG;YACH,OAAO;YACP,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;SAC1C,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACzC,CAAC;CACF;AAED,MAAM,OAAO,WAAY,SAAQ,YAAY;IAaxB;IACD;IAbD,KAAK,GAAgB,EAAE,CAAA;IACvB,OAAO,GAA+C,EAAE,CAAA;IACxD,QAAQ,CAAwB;IAChC,YAAY,CAAe;IACpC,MAAM,GAAG,KAAK,CAAA;IAEL,aAAa,CAAmC;IAChD,sBAAsB,CAAoC;IAC1D,oBAAoB,CAAoC;IACxD,YAAY,CAAkC;IAE/D,YACmB,OAA4B,EAC7B,MAAqB,EACrC,IAKC;QAED,KAAK,EAAE,CAAA;QATU,YAAO,GAAP,OAAO,CAAqB;QAC7B,WAAM,GAAN,MAAM,CAAe;QASrC,MAAM,QAAQ,GAAG,IAAI,sBAAsB,CAAC;YAC1C,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SAC1C,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QAExB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QACpD,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACtE,IAAI,CAAC,oBAAoB,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAA;QAClE,IAAI,CAAC,YAAY,GAAG,CAAC,KAAK,EAAE,EAAE;YAC5B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;YACzB,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QAC7B,CAAC,CAAA;QAED,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAA;QAC7C,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,CAAC,CAAA;QAChE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,gBAAgB,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAA;QAC5D,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QAE3C,IAAI,CAAC,YAAY,GAAG,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAA;YACtB,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;QACzC,CAAC,CAAC,EAAE,CAAA;QAEJ,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YAC9B,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aAC1D,CAAC,CAAA;QACJ,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,SAAS,CAAC,KAAgB;QAChC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAM;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;QAC9B,IAAI,CAAC;YAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;;YAClC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC7B,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,MAAM,IAAI,CAAC,YAAY,CAAA;IACzB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM;YAAE,OAAM;QACvB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAA;QAC9C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,CAAC,sBAAsB,CAAC,CAAA;QACjE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAA;QAC7D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QAE5C,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAChD,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAE1C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAG,CAAA;YAC/B,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACrC,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,YAAY;IAIjB;IAHrB,MAAM,GAAG,KAAK,CAAA;IACL,eAAe,CAAqC;IAErE,YAA6B,OAA4B;QACvD,KAAK,EAAE,CAAA;QADoB,YAAO,GAAP,OAAO,CAAqB;QAEvD,IAAI,CAAC,eAAe,GAAG,CAAC,QAAyB,EAAE,EAAE;YACnD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;YACjC,CAAC;QACH,CAAC,CAAA;QACD,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,eAAe,CAAC,CAAA;QACjD,IAAI,CAAC,OAAO;aACT,aAAa,EAAE;aACf,IAAI,CAAC,GAAG,EAAE;YACT,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACtC,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACb,IAAI,CAAC,IAAI,CAAC,MAAM;gBAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;IACN,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAM;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,eAAe,CAAC,CAAA;QAClD,KAAK,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACxD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACpB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { Aira, AiraEngine, resolveDiarizationProvider, resolveSTTProvider } from './engine.js';
+export { LiveSession } from './audio.js';
+export { Eyes, EyesSession, MeetingWatcher } from './eyes.js';
+export { NativeCaptureBridge } from './capture.js';
+export { AiraEngineProvider, CallbackDiarizationProvider, CallbackSTTProvider, HttpDiarizationProvider, HttpSTTProvider, WebSocketSTTProvider, encodeWavFromInt16PCM, } from './providers.js';
+export type { AiraEngineProviderOptions, CustomDiarizeFn, CustomTranscribeFn, DiarizationProvider, HttpDiarizationProviderOptions, HttpSTTProviderOptions, STTProvider, STTStreamSession, WebSocketSTTProviderOptions, } from './providers.js';
+export { IncrementalDiarizer, MeetingSessionPipeline, SpeakerAttributionTimeline } from './attribution.js';
+export { EngineHttpError } from './transport.js';
+export { Vectors } from './vectors.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC9F,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,8BAA8B,EAC9B,sBAAsB,EACtB,WAAW,EACX,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA;AAC1G,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,mBAAmB,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { Aira, AiraEngine, resolveDiarizationProvider, resolveSTTProvider } from './engine.js';
+export { LiveSession } from './audio.js';
+export { Eyes, EyesSession, MeetingWatcher } from './eyes.js';
+export { NativeCaptureBridge } from './capture.js';
+export { AiraEngineProvider, CallbackDiarizationProvider, CallbackSTTProvider, HttpDiarizationProvider, HttpSTTProvider, WebSocketSTTProvider, encodeWavFromInt16PCM, } from './providers.js';
+export { IncrementalDiarizer, MeetingSessionPipeline, SpeakerAttributionTimeline } from './attribution.js';
+export { EngineHttpError } from './transport.js';
+export { Vectors } from './vectors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAC9F,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gBAAgB,CAAA;AAYvB,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA;AAC1G,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/dist/lockfile.d.ts

@@ -0,0 +1,14 @@
+export interface EngineLock {
+    pid: number;
+    port: number;
+    startedAt: number;
+}
+export declare class Lockfile {
+    readonly path: string;
+    constructor(path: string);
+    read(): EngineLock | null;
+    write(lock: EngineLock): void;
+    remove(): void;
+}
+export declare function isProcessAlive(pid: number): boolean;
+//# sourceMappingURL=lockfile.d.ts.map

package/dist/lockfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockfile.d.ts","sourceRoot":"","sources":["../src/lockfile.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,qBAAa,QAAQ;aACS,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;IAExC,IAAI,IAAI,UAAU,GAAG,IAAI;IAQzB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAK7B,MAAM,IAAI,IAAI;CAGf;AAID,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOnD"}

package/dist/lockfile.js

@@ -0,0 +1,38 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export class Lockfile {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    read() {
+        try {
+            return JSON.parse(fs.readFileSync(this.path, 'utf8'));
+        }
+        catch {
+            return null;
+        }
+    }
+    write(lock) {
+        fs.mkdirSync(path.dirname(this.path), { recursive: true });
+        fs.writeFileSync(this.path, JSON.stringify(lock), 'utf8');
+    }
+    remove() {
+        try {
+            fs.unlinkSync(this.path);
+        }
+        catch { /* ignore */ }
+    }
+}
+// process.kill(pid, 0) — signal 0 is the "is it alive?" probe.
+// EPERM means the PID exists but is owned by another user; treat as alive.
+export function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        return e.code === 'EPERM';
+    }
+}
+//# sourceMappingURL=lockfile.js.map

package/dist/lockfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockfile.js","sourceRoot":"","sources":["../src/lockfile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAQjC,MAAM,OAAO,QAAQ;IACS;IAA5B,YAA4B,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;IAAG,CAAC;IAE5C,IAAI;QACF,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAe,CAAA;QACrE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAgB;QACpB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1D,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;IAC3D,CAAC;IAED,MAAM;QACJ,IAAI,CAAC;YAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IACzD,CAAC;CACF;AAED,+DAA+D;AAC/D,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;QACpB,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,OAAQ,CAA2B,CAAC,IAAI,KAAK,OAAO,CAAA;IACtD,CAAC;AACH,CAAC"}

package/dist/providers.d.ts

@@ -0,0 +1,162 @@
+import { HttpClient } from './transport.js';
+import type { DiarizeOptions, DiarizeResult, DiarizeSegment, LiveTranscriptFrame, TranscribeOptions, TranscribeResult, TranscribeSegment } from './types.js';
+export interface STTStreamSession {
+    /** Feed 16 kHz mono Int16 PCM bytes. */
+    feed(pcm: Buffer | Uint8Array | Int16Array): void;
+    /** Async iterator yielding partial and final transcript frames. */
+    readonly frames: AsyncIterable<LiveTranscriptFrame>;
+    /** Wait until the stream connection is ready. */
+    ready(): Promise<void>;
+    /** Finalize and close the stream. */
+    close(): Promise<void>;
+}
+export interface STTProvider {
+    /**
+     * Batch transcription of a 16 kHz mono WAV buffer.
+     * Compatible with any OpenAI `/v1/audio/transcriptions` endpoint or custom callback.
+     */
+    transcribe?(wavBuffer: Buffer | Uint8Array, opts?: TranscribeOptions): Promise<TranscribeResult>;
+    /**
+     * Optional real-time WebSocket / streaming transcription session.
+     * When absent or returning `undefined`, `AiraSDK` automatically chunks live meeting
+     * audio using VAD and calls `transcribe()` on each speech segment.
+     */
+    startStream?(opts?: TranscribeOptions): STTStreamSession | undefined;
+}
+export interface DiarizationProvider {
+    /**
+     * Diarize a 16 kHz mono WAV buffer into speaker segments `[{ start, end, speaker }]`.
+     */
+    diarize(wavBuffer: Buffer | Uint8Array, opts?: DiarizeOptions): Promise<DiarizeResult>;
+}
+export interface HttpSTTProviderOptions {
+    /**
+     * Full endpoint URL (e.g. `https://api.openai.com/v1/audio/transcriptions`,
+     * `https://api.groq.com/openai/v1/audio/transcriptions`, or `http://127.0.0.1:50060/v1/audio/transcriptions`)
+     * or base URL (if it doesn't end with a path, `/v1/audio/transcriptions` is appended).
+     */
+    url: string;
+    /** Optional Bearer API key (e.g. OpenAI / Groq / custom key). */
+    apiKey?: string;
+    /** Additional HTTP headers. */
+    headers?: Record<string, string>;
+    /** Default model name (e.g. `whisper-1`, `whisper-large-v3`, `gpt-4o-transcribe`). */
+    model?: string;
+    /** Default ISO-639-1 language code (e.g. `en`). */
+    language?: string;
+    /** Default response_format sent in multipart form (`verbose_json` by default when model is set). */
+    responseFormat?: string;
+}
+/**
+ * Pluggable HTTP STT provider that works with any OpenAI-compatible
+ * `/v1/audio/transcriptions` endpoint (OpenAI, Groq, local whisper.cpp, FastAPI, AiraEngine, etc.).
+ */
+export declare class HttpSTTProvider implements STTProvider {
+    private readonly opts;
+    readonly endpointUrl: string;
+    constructor(opts: HttpSTTProviderOptions);
+    transcribe(audio: Buffer | Uint8Array, callOpts?: TranscribeOptions): Promise<TranscribeResult>;
+}
+export interface WebSocketSTTProviderOptions {
+    /** WebSocket endpoint URL (e.g. `ws://127.0.0.1:50060/v1/audio/stream`) or HTTP base URL. */
+    wsUrl: string;
+    /** Optional HTTP headers for the WebSocket handshake (e.g. Authorization). */
+    headers?: Record<string, string>;
+    /** Optional fallback HTTP STT provider for batch `.transcribe()` calls. */
+    httpFallback?: STTProvider;
+}
+/**
+ * Pluggable WebSocket streaming STT provider.
+ * Streams 16 kHz mono Int16 PCM binary frames and parses `{ type: 'partial' | 'final', text, t0, t1 }`.
+ */
+export declare class WebSocketSTTProvider implements STTProvider {
+    private readonly opts;
+    readonly wsEndpointUrl: string;
+    constructor(opts: WebSocketSTTProviderOptions);
+    transcribe(audio: Buffer | Uint8Array, opts?: TranscribeOptions): Promise<TranscribeResult>;
+    startStream(_opts?: TranscribeOptions): STTStreamSession;
+}
+export declare class WebSocketStreamSession implements STTStreamSession {
+    private readonly ws;
+    private readonly queue;
+    private readonly waiters;
+    private closed;
+    constructor(url: string, headers?: Record<string, string>);
+    feed(pcm: Int16Array | Uint8Array | Buffer): void;
+    get frames(): AsyncIterable<LiveTranscriptFrame>;
+    ready(): Promise<void>;
+    close(): Promise<void>;
+}
+export type CustomTranscribeFn = (wavBuffer: Buffer, opts?: TranscribeOptions) => Promise<TranscribeResult | {
+    text: string;
+    segments?: TranscribeSegment[];
+} | string>;
+/**
+ * Pluggable callback STT provider — wrap any third-party SDK (Deepgram, ElevenLabs, AssemblyAI, etc.)
+ * with a simple async function.
+ */
+export declare class CallbackSTTProvider implements STTProvider {
+    private readonly fn;
+    private readonly streamFactory?;
+    constructor(fn: CustomTranscribeFn, streamFactory?: ((opts?: TranscribeOptions) => STTStreamSession) | undefined);
+    transcribe(audio: Buffer | Uint8Array, opts?: TranscribeOptions): Promise<TranscribeResult>;
+    startStream(opts?: TranscribeOptions): STTStreamSession | undefined;
+}
+export interface HttpDiarizationProviderOptions {
+    /**
+     * Full endpoint URL (e.g. `http://127.0.0.1:50060/v1/audio/diarize`)
+     * or base URL (if it doesn't end with a path, `/v1/audio/diarize` is appended).
+     */
+    url: string;
+    /** Optional Bearer API key. */
+    apiKey?: string;
+    /** Additional HTTP headers. */
+    headers?: Record<string, string>;
+}
+/**
+ * Pluggable HTTP Diarization provider that works with any `/v1/audio/diarize`
+ * endpoint (AiraEngine, pyannote HTTP microservice, etc.).
+ */
+export declare class HttpDiarizationProvider implements DiarizationProvider {
+    private readonly opts;
+    readonly endpointUrl: string;
+    constructor(opts: HttpDiarizationProviderOptions);
+    diarize(audio: Buffer | Uint8Array, opts?: DiarizeOptions): Promise<DiarizeResult>;
+}
+export type CustomDiarizeFn = (wavBuffer: Buffer, opts?: DiarizeOptions) => Promise<DiarizeResult | DiarizeSegment[]>;
+/**
+ * Pluggable callback Diarization provider.
+ */
+export declare class CallbackDiarizationProvider implements DiarizationProvider {
+    private readonly fn;
+    constructor(fn: CustomDiarizeFn);
+    diarize(audio: Buffer | Uint8Array, opts?: DiarizeOptions): Promise<DiarizeResult>;
+}
+export interface AiraEngineProviderOptions {
+    /** Base URL of a running AiraEngine server (e.g. `http://127.0.0.1:50060`). */
+    baseUrl: string;
+    /** Use batch `/v1/audio/transcriptions` instead of WebSocket `/v1/audio/stream` for meetings. */
+    preferBatchSTT?: boolean;
+}
+/**
+ * Connects `AiraSDK` to an `AiraEngine` compute instance (WhisperKit STT + SpeakerKit Diarization).
+ * Can be passed to `AiraEngine.create({ stt: provider, diarize: provider })` or `new AiraClient(...)`.
+ */
+export declare class AiraEngineProvider implements STTProvider, DiarizationProvider {
+    readonly baseUrl: string;
+    readonly http: HttpClient;
+    private readonly httpSTT;
+    private readonly wsSTT;
+    private readonly httpDiarize;
+    private readonly preferBatchSTT;
+    constructor(opts: AiraEngineProviderOptions | string);
+    transcribe(audio: Buffer | Uint8Array, opts?: TranscribeOptions): Promise<TranscribeResult>;
+    startStream(): STTStreamSession | undefined;
+    diarize(audio: Buffer | Uint8Array, opts?: DiarizeOptions): Promise<DiarizeResult>;
+}
+export declare function toBlobPart(bytes: Buffer | Uint8Array): Uint8Array<ArrayBuffer>;
+/** Wraps raw 16 kHz 16-bit mono little-endian PCM bytes in a 44-byte RIFF WAVE header. */
+export declare function encodeWavFromInt16PCM(pcmBytes: Buffer, sampleRate?: number): Buffer;
+export declare function extractPcmFromWavOrRaw(audio: Buffer | Uint8Array): Buffer;
+export declare function estimateWavDurationSeconds(audio: Buffer | Uint8Array): number;
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,YAAY,CAAA;AAInB,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,IAAI,CAAA;IACjD,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;IACnD,iDAAiD;IACjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,qCAAqC;IACrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,UAAU,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAEhG;;;;OAIG;IACH,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,SAAS,CAAA;CACrE;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CACvF;AAID,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAA;IACX,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oGAAoG;IACpG,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;GAGG;AACH,qBAAa,eAAgB,YAAW,WAAW;IAGrC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;gBAEC,IAAI,EAAE,sBAAsB;IAQnD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,QAAQ,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAuD1G;AAED,MAAM,WAAW,2BAA2B;IAC1C,6FAA6F;IAC7F,KAAK,EAAE,MAAM,CAAA;IACb,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,2EAA2E;IAC3E,YAAY,CAAC,EAAE,WAAW,CAAA;CAC3B;AAED;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,WAAW;IAG1C,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;gBAED,IAAI,EAAE,2BAA2B;IASxD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8BjG,WAAW,CAAC,KAAK,CAAC,EAAE,iBAAiB,GAAG,gBAAgB;CAGzD;AAED,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,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,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAsBzD,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,IAAI;IASjD,IAAI,MAAM,IAAI,aAAa,CAAC,mBAAmB,CAAC,CAmB/C;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B;AAED,MAAM,MAAM,kBAAkB,GAAG,CAC/B,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,iBAAiB,KACrB,OAAO,CAAC,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAA;CAAE,GAAG,MAAM,CAAC,CAAA;AAE1F;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IAEnD,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;gBADd,EAAE,EAAE,kBAAkB,EACtB,aAAa,CAAC,GAAE,CAAC,IAAI,CAAC,EAAE,iBAAiB,KAAK,gBAAgB,aAAA;IAG3E,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6BjG,WAAW,CAAC,IAAI,CAAC,EAAE,iBAAiB,GAAG,gBAAgB,GAAG,SAAS;CAGpE;AAID,MAAM,WAAW,8BAA8B;IAC7C;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAA;IACX,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IAGrD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;gBAEC,IAAI,EAAE,8BAA8B;IAQ3D,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;CAoC7F;AAED,MAAM,MAAM,eAAe,GAAG,CAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,cAAc,KAClB,OAAO,CAAC,aAAa,GAAG,cAAc,EAAE,CAAC,CAAA;AAE9C;;GAEG;AACH,qBAAa,2BAA4B,YAAW,mBAAmB;IACzD,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,eAAe;IAE1C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAYzF;AAID,MAAM,WAAW,yBAAyB;IACxC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAA;IACf,iGAAiG;IACjG,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,WAAW,EAAE,mBAAmB;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,IAAI,EAAE,yBAAyB,GAAG,MAAM;IAa9C,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIjG,WAAW,IAAI,gBAAgB,GAAG,SAAS;IAKrC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAGzF;AAID,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC,WAAW,CAAC,CAE9E;AAED,0FAA0F;AAC1F,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,SAAQ,GAAG,MAAM,CAgBlF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAczE;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAG7E"}