@ariaflowagents/livekit-plugin 0.9.6 → 0.9.7

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 export { AudioFrame } from './audio_frame.js';
 export { AudioByteStream } from './audio_byte_stream.js';
 export { TransportAdapter } from './transport_adapter.js';
+export type { NativeAudioTransport } from './native_audio_transport.js';
+export { LiveKitSessionRunner, type LiveKitSessionRunnerConfig, type LiveKitSessionRunnerSession, type LiveKitSessionRunnerAdapter, } from './session/LiveKitSessionRunner.js';
 export { SessionManager } from './session_manager.js';
 export { AudioInput, AudioOutput, TextOutput, isTimedString, createTimedString } from './livekit_io.js';
 export type { TimedString } from './livekit_io.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACxG,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC9F,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKnH,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,KAAK,4BAA4B,EAAE,KAAK,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtJ,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,GAChC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,kCAAkC,GACxC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGlE,OAAO,EAAE,uBAAuB,EAAE,KAAK,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACtI,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAC9G,OAAO,EAAE,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAC3G,OAAO,EAAE,sBAAsB,EAAE,KAAK,6BAA6B,EAAE,KAAK,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAGvI,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACjF,YAAY,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGhE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1E,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EACL,oBAAoB,EACpB,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,GACjC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACxG,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC9F,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKnH,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,KAAK,4BAA4B,EAAE,KAAK,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtJ,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,GAChC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,kCAAkC,GACxC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGlE,OAAO,EAAE,uBAAuB,EAAE,KAAK,wBAAwB,EAAE,KAAK,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACtI,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAC9G,OAAO,EAAE,oBAAoB,EAAE,KAAK,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAC3G,OAAO,EAAE,sBAAsB,EAAE,KAAK,6BAA6B,EAAE,KAAK,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAGvI,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACjF,YAAY,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGhE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1E,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,EAC1B,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC"}

package/dist/index.js

@@ -2,6 +2,7 @@
 export { AudioFrame } from './audio_frame.js';
 export { AudioByteStream } from './audio_byte_stream.js';
 export { TransportAdapter } from './transport_adapter.js';
+export { LiveKitSessionRunner, } from './session/LiveKitSessionRunner.js';
 export { SessionManager } from './session_manager.js';
 export { AudioInput, AudioOutput, TextOutput, isTimedString, createTimedString } from './livekit_io.js';
 export { TransportEvent } from './types.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGxG,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEnH,wBAAwB;AAExB,2BAA2B;AAC3B,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAA2D,MAAM,gCAAgC,CAAC;AACtJ,OAAO,EACL,sBAAsB,GAGvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,GAE9B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,iCAAiC;AACjC,OAAO,EAAE,uBAAuB,EAAyD,MAAM,sCAAsC,CAAC;AACtI,OAAO,EAAE,qBAAqB,EAAqC,MAAM,oCAAoC,CAAC;AAC9G,OAAO,EAAE,oBAAoB,EAAoC,MAAM,mCAAmC,CAAC;AAC3G,OAAO,EAAE,sBAAsB,EAA4D,MAAM,qCAAqC,CAAC;AAEvI,kBAAkB;AAClB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGjF,qBAAqB;AACrB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAIhE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1E,YAAY;AACZ,cAAc,sBAAsB,CAAC;AAErC,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,GAG3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EACL,oBAAoB,GAIrB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGxG,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEnH,wBAAwB;AAExB,2BAA2B;AAC3B,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAA2D,MAAM,gCAAgC,CAAC;AACtJ,OAAO,EACL,sBAAsB,GAGvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,GAE9B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAElE,iCAAiC;AACjC,OAAO,EAAE,uBAAuB,EAAyD,MAAM,sCAAsC,CAAC;AACtI,OAAO,EAAE,qBAAqB,EAAqC,MAAM,oCAAoC,CAAC;AAC9G,OAAO,EAAE,oBAAoB,EAAoC,MAAM,mCAAmC,CAAC;AAC3G,OAAO,EAAE,sBAAsB,EAA4D,MAAM,qCAAqC,CAAC;AAEvI,kBAAkB;AAClB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGjF,qBAAqB;AACrB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAIhE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1E,YAAY;AACZ,cAAc,sBAAsB,CAAC;AAErC,iBAAiB;AACjB,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,GAG3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC"}

package/dist/native_audio_transport.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Port interface for native (Gemini Live / Path B) audio I/O.
+ * Parallel to {@link RealtimeTransportSession} in core, but owned here and
+ * without optional interruption hooks.
+ */
+export interface NativeAudioTransport {
+    /** Send PCM s16le audio to the end-user client (bytes = Int16 LE samples). */
+    sendAudio(data: Uint8Array): void;
+    /** Subscribe to PCM s16le from the end-user client. */
+    onAudio(handler: (data: Uint8Array) => void): void;
+    /** Subscribe to transport close (may fire multiple times; handlers should be idempotent). */
+    onClose(handler: () => void): void;
+    close(): void;
+}
+//# sourceMappingURL=native_audio_transport.d.ts.map

package/dist/native_audio_transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native_audio_transport.d.ts","sourceRoot":"","sources":["../src/native_audio_transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,uDAAuD;IACvD,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IACnD,6FAA6F;IAC7F,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACnC,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/native_audio_transport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=native_audio_transport.js.map

package/dist/native_audio_transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native_audio_transport.js","sourceRoot":"","sources":["../src/native_audio_transport.ts"],"names":[],"mappings":""}

package/dist/session/LiveKitSessionRunner.d.ts

@@ -0,0 +1,45 @@
+import { AudioFrame } from '@livekit/rtc-node';
+import { llm } from '@livekit/agents';
+import type { NativeAudioTransport } from '../native_audio_transport.js';
+/** Duck-typed realtime session for Path B (matches transport-ws wire types). */
+export type LiveKitSessionRunnerSession = {
+    on(event: string, handler: (...args: unknown[]) => void): unknown;
+    chatCtx: llm.ChatContext;
+    tools?: llm.ToolContext;
+    pushAudio(frame: AudioFrame): void;
+    updateChatCtx(chatCtx: llm.ChatContext): Promise<void>;
+    close(): Promise<void>;
+};
+export type LiveKitSessionRunnerAdapter = {
+    attach(session: LiveKitSessionRunnerSession): Promise<void>;
+    detach(): Promise<void>;
+    onTurnComplete(): Promise<void>;
+};
+export interface LiveKitSessionRunnerConfig {
+    session: LiveKitSessionRunnerSession;
+    adapter: LiveKitSessionRunnerAdapter;
+    transport: NativeAudioTransport;
+    sessionId?: string;
+    sampleRate?: number;
+    numChannels?: number;
+    onToolResult?: (toolName: string, args: unknown, result: unknown, success: boolean) => void;
+    /** Fired after {@link LiveKitSessionRunnerAdapter.onTurnComplete} resolves. */
+    onTurnComplete?: () => void;
+    /** Fired if {@link LiveKitSessionRunnerAdapter.onTurnComplete} rejects. */
+    onTurnCompleteError?: () => void;
+    onUserTranscript?: (text: string) => void;
+    onSessionEnd?: (reason: string) => void;
+}
+/**
+ * Transport-agnostic plumbing for LiveKit native audio sessions: tool execution,
+ * adapter lifecycle hooks, and PCM ↔ {@link AudioFrame} bridging.
+ */
+export declare class LiveKitSessionRunner {
+    #private;
+    readonly sessionId: string;
+    constructor(config: LiveKitSessionRunnerConfig);
+    get running(): boolean;
+    start(): Promise<void>;
+    stop(reason?: string): Promise<void>;
+}
+//# sourceMappingURL=LiveKitSessionRunner.d.ts.map

package/dist/session/LiveKitSessionRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LiveKitSessionRunner.d.ts","sourceRoot":"","sources":["../../src/session/LiveKitSessionRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AACtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,gFAAgF;AAChF,MAAM,MAAM,2BAA2B,GAAG;IACxC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;IAClE,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC;IACzB,KAAK,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC;IACxB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,2BAA2B,CAAC;IACrC,OAAO,EAAE,2BAA2B,CAAC;IACrC,SAAS,EAAE,oBAAoB,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,CACb,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO,KACb,IAAI,CAAC;IACV,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED;;;GAGG;AACH,qBAAa,oBAAoB;;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAOf,MAAM,EAAE,0BAA0B;IAO9C,IAAI,OAAO,IAAI,OAAO,CAErB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0HtB,IAAI,CAAC,MAAM,GAAE,MAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;CAsD5D"}

package/dist/session/LiveKitSessionRunner.js

@@ -0,0 +1,197 @@
+import { AudioFrame } from '@livekit/rtc-node';
+import { llm } from '@livekit/agents';
+/**
+ * Transport-agnostic plumbing for LiveKit native audio sessions: tool execution,
+ * adapter lifecycle hooks, and PCM ↔ {@link AudioFrame} bridging.
+ */
+export class LiveKitSessionRunner {
+    sessionId;
+    #config;
+    #sampleRate;
+    #numChannels;
+    #running = false;
+    #stopped = false;
+    constructor(config) {
+        this.#config = config;
+        this.sessionId = config.sessionId ?? `bridge-${Date.now()}`;
+        this.#sampleRate = config.sampleRate ?? 24000;
+        this.#numChannels = config.numChannels ?? 1;
+    }
+    get running() {
+        return this.#running;
+    }
+    async start() {
+        if (this.#running || this.#stopped) {
+            throw new Error('LiveKitSessionRunner: already started or stopped');
+        }
+        const { session, adapter, transport } = this.#config;
+        session.on('generation_created', (...args) => {
+            const event = args[0];
+            const messageReader = event.messageStream.getReader();
+            void (async () => {
+                try {
+                    while (true) {
+                        const { done, value: message } = await messageReader.read();
+                        if (done)
+                            break;
+                        const audioReader = message.audioStream.getReader();
+                        void (async () => {
+                            try {
+                                while (true) {
+                                    const { done: audioDone, value: frame } = await audioReader.read();
+                                    if (audioDone)
+                                        break;
+                                    const f = frame.data;
+                                    try {
+                                        transport.sendAudio(new Uint8Array(f.buffer, f.byteOffset, f.byteLength));
+                                    }
+                                    catch {
+                                        /* ignore */
+                                    }
+                                }
+                            }
+                            catch {
+                                /* ignore */
+                            }
+                        })();
+                        const textReader = message.textStream.getReader();
+                        void (async () => {
+                            try {
+                                while (true) {
+                                    const { done: textDone } = await textReader.read();
+                                    if (textDone)
+                                        break;
+                                }
+                            }
+                            catch {
+                                /* ignore */
+                            }
+                        })();
+                    }
+                }
+                catch {
+                    /* ignore */
+                }
+            })();
+            const functionReader = event.functionStream.getReader();
+            void (async () => {
+                try {
+                    while (true) {
+                        const { done, value: fnCall } = await functionReader.read();
+                        if (done)
+                            break;
+                        await this.#executeFunctionCall(fnCall);
+                    }
+                }
+                catch {
+                    /* ignore */
+                }
+            })();
+        });
+        session.on('turn_complete', () => {
+            void adapter
+                .onTurnComplete()
+                .then(() => {
+                this.#config.onTurnComplete?.();
+            })
+                .catch(() => {
+                this.#config.onTurnCompleteError?.();
+            });
+        });
+        session.on('input_audio_transcription_completed', (...args) => {
+            const evt = args[0];
+            if (evt.isFinal && evt.transcript?.trim()) {
+                this.#config.onUserTranscript?.(evt.transcript);
+            }
+        });
+        transport.onAudio((data) => {
+            if (this.#stopped)
+                return;
+            const n = Math.floor(data.byteLength / 2);
+            if (n <= 0)
+                return;
+            const int16 = new Int16Array(n);
+            for (let i = 0; i < n; i++) {
+                int16[i] = data[i * 2] | (data[i * 2 + 1] << 8);
+            }
+            try {
+                session.pushAudio(new AudioFrame(int16, this.#sampleRate, this.#numChannels, n));
+            }
+            catch {
+                /* ignore */
+            }
+        });
+        transport.onClose(() => {
+            void this.stop('transport_close');
+        });
+        try {
+            await adapter.attach(session);
+        }
+        catch (err) {
+            this.#stopped = true;
+            await adapter.detach().catch(() => { });
+            await session.close().catch(() => { });
+            this.#config.onSessionEnd?.('attach_failed');
+            try {
+                transport.close();
+            }
+            catch {
+                /* ignore */
+            }
+            throw err;
+        }
+        this.#running = true;
+    }
+    async stop(reason = 'external_stop') {
+        if (this.#stopped)
+            return;
+        this.#stopped = true;
+        this.#running = false;
+        const { adapter, session, transport } = this.#config;
+        await adapter.detach().catch(() => { });
+        await session.close().catch(() => { });
+        try {
+            transport.close();
+        }
+        catch {
+            /* ignore */
+        }
+        this.#config.onSessionEnd?.(reason);
+    }
+    async #executeFunctionCall(fnCall) {
+        const { session } = this.#config;
+        const toolDef = session.tools?.[fnCall.name];
+        if (!toolDef || typeof toolDef.execute !== 'function') {
+            return;
+        }
+        let args = fnCall.args ?? {};
+        if (typeof args === 'string') {
+            try {
+                args = JSON.parse(args || '{}');
+            }
+            catch {
+                args = {};
+            }
+        }
+        let output;
+        let isError = false;
+        try {
+            output = await toolDef.execute(args, llm.createToolOptions(fnCall.callId));
+        }
+        catch (err) {
+            isError = true;
+            output = { error: err instanceof Error ? err.message : String(err) };
+        }
+        const chatCtx = session.chatCtx.copy();
+        chatCtx.insert(new llm.FunctionCallOutput({
+            callId: fnCall.callId,
+            name: fnCall.name,
+            output: typeof output === 'string' ? output : JSON.stringify(output ?? {}),
+            isError,
+            createdAt: Date.now(),
+        }));
+        await session.updateChatCtx(chatCtx);
+        this.#config.onToolResult?.(fnCall.name, args, output, !isError);
+    }
+}
+//# sourceMappingURL=LiveKitSessionRunner.js.map

package/dist/session/LiveKitSessionRunner.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ariaflowagents/livekit-plugin",
-  "version": "0.9.6",
+  "version": "0.9.7",
   "description": "AriaFlow plugin for LiveKit Agents — runtime adapter, transport foundation, Gemini STT/TTS",
   "type": "module",
   "main": "dist/index.js",
@@ -34,7 +34,7 @@
     "@livekit/agents": ">=1.0.0",
     "@livekit/rtc-node": ">=0.12.0",
     "zod": "^3.23.0",
-    "@ariaflowagents/core": "0.9.6"
+    "@ariaflowagents/core": "0.9.7"
   },
   "dependencies": {
     "@google/genai": "1.43.0",
@@ -45,7 +45,7 @@
     "@huggingface/hub": "^1.1.2",
     "@huggingface/transformers": "^3.7.2",
     "alawmulaw": "^6.0.0",
-    "@ariaflowagents/gemini-native-audio": "0.9.6"
+    "@ariaflowagents/gemini-native-audio": "0.9.7"
   },
   "devDependencies": {
     "@types/node": "^25.3.2",