felona-voice 0.1.0

package/dist/agent.d.ts

@@ -0,0 +1,105 @@
+import { EventEmitter } from "node:events";
+import type { FelAgentConfig, AgentAction } from "./types.js";
+import { JEVEngine } from "./jev/engine.js";
+/**
+ * FelAgent — The main entry point for building a voice agent with Felona Voice.
+ *
+ * Usage:
+ * ```typescript
+ * const agent = new FelAgent({
+ *   name: "Support Bot",
+ *   systemPrompt: "You are a helpful support agent.",
+ *   stt: { provider: "deepgram", apiKey: "..." },
+ *   tts: { provider: "elevenlabs", apiKey: "..." },
+ *   llm: { provider: "openai", apiKey: "...", model: "gpt-4o-mini" },
+ *   actions: [ ... ],
+ * });
+ *
+ * agent.listen({ port: 8080 });
+ * ```
+ *
+ * FelAgent wires together:
+ * - Transport (WebSocket server for audio I/O)
+ * - Voice Pipeline (STT → JEV → LLM → TTS per session)
+ * - JEV Engine (action prediction)
+ * - Memory, Tools, Analytics
+ */
+export declare class FelAgent extends EventEmitter {
+    private readonly config;
+    private transport;
+    private readonly jev;
+    private readonly logger;
+    private readonly tools;
+    private readonly hooks;
+    private readonly sttProvider;
+    private readonly ttsProvider;
+    private readonly vadProvider;
+    private readonly llmProvider;
+    private readonly llmInterface;
+    private pipelines;
+    private initialized;
+    constructor(config: FelAgentConfig);
+    /**
+     * Start the agent — initialize JEV, start the transport, begin accepting calls.
+     */
+    listen(options?: {
+        port?: number;
+        host?: string;
+    }): Promise<void>;
+    /**
+     * Stop the agent — shut down all pipelines and the transport.
+     */
+    stop(): Promise<void>;
+    /**
+     * Handle a new client connection — create a voice pipeline for this session.
+     */
+    private handleConnect;
+    /**
+     * Handle a client disconnection — stop and clean up the pipeline.
+     */
+    private handleDisconnect;
+    /**
+     * Handle incoming audio from a client — route to the correct pipeline.
+     */
+    private handleAudio;
+    /** Create STT provider based on config */
+    private createSTTProvider;
+    /** Create TTS provider based on config */
+    private createTTSProvider;
+    /** Create LLM provider based on config */
+    private createLLMProvider;
+    /** Get the number of active calls */
+    get activeCallCount(): number;
+    /** Check if the agent is running */
+    get isRunning(): boolean;
+    /** Get the agent name */
+    get name(): string;
+    /** Get the JEV engine (for inspection/testing) */
+    get jevEngine(): JEVEngine;
+}
+/**
+ * Helper to define an action with type safety.
+ */
+export declare function defineAction(action: AgentAction): AgentAction;
+/**
+ * Quick-start factory — creates a minimal agent with sensible defaults.
+ * Automatically creates a default "respond" action that uses the LLM directly.
+ */
+export declare function quickStart(config: {
+    llm: {
+        provider: string;
+        apiKey: string;
+        model?: string;
+    };
+    stt: {
+        provider: string;
+        apiKey: string;
+    };
+    tts: {
+        provider: string;
+        apiKey: string;
+        voice?: string;
+    };
+    systemPrompt?: string;
+}): FelAgent;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,cAAc,EAGd,WAAW,EAGZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAa5C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,QAAS,SAAQ,YAAY;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAY;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAY;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAG5C,OAAO,CAAC,SAAS,CAAyC;IAE1D,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,cAAc;IA4ClC;;OAEG;IACG,MAAM,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CvE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B;;OAEG;YACW,aAAa;IA2C3B;;OAEG;YACW,gBAAgB;IAY9B;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB,0CAA0C;IAC1C,OAAO,CAAC,iBAAiB;IAiBzB,0CAA0C;IAC1C,OAAO,CAAC,iBAAiB;IAkBzB,0CAA0C;IAC1C,OAAO,CAAC,iBAAiB;IAiBzB,qCAAqC;IACrC,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,oCAAoC;IACpC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,yBAAyB;IACzB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,kDAAkD;IAClD,IAAI,SAAS,IAAI,SAAS,CAEzB;CACF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,QAAQ,CAgCX"}

package/dist/agent.js

@@ -0,0 +1,287 @@
+import { EventEmitter } from "node:events";
+import { WebSocketTransport } from "./transport/websocket.js";
+import { JEVEngine } from "./jev/engine.js";
+import { OpenAIEmbeddingProvider } from "./jev/embeddings.js";
+import { ConversationMemory } from "./memory/context.js";
+import { ToolRegistry } from "./tools/registry.js";
+import { CallLogger } from "./analytics/logger.js";
+import { VoicePipeline } from "./pipeline.js";
+// Provider imports
+import { DeepgramSTT } from "./stt/deepgram.js";
+import { ElevenLabsTTS } from "./tts/eleven-labs.js";
+import { EnergyVAD } from "./vad/energy.js";
+import { OpenAILLM } from "./llm/openai.js";
+/**
+ * FelAgent — The main entry point for building a voice agent with Felona Voice.
+ *
+ * Usage:
+ * ```typescript
+ * const agent = new FelAgent({
+ *   name: "Support Bot",
+ *   systemPrompt: "You are a helpful support agent.",
+ *   stt: { provider: "deepgram", apiKey: "..." },
+ *   tts: { provider: "elevenlabs", apiKey: "..." },
+ *   llm: { provider: "openai", apiKey: "...", model: "gpt-4o-mini" },
+ *   actions: [ ... ],
+ * });
+ *
+ * agent.listen({ port: 8080 });
+ * ```
+ *
+ * FelAgent wires together:
+ * - Transport (WebSocket server for audio I/O)
+ * - Voice Pipeline (STT → JEV → LLM → TTS per session)
+ * - JEV Engine (action prediction)
+ * - Memory, Tools, Analytics
+ */
+export class FelAgent extends EventEmitter {
+    config;
+    transport;
+    jev;
+    logger;
+    tools;
+    hooks;
+    sttProvider;
+    ttsProvider;
+    vadProvider;
+    llmProvider;
+    llmInterface;
+    // Active pipelines (one per session)
+    pipelines = new Map();
+    initialized = false;
+    constructor(config) {
+        super();
+        this.config = config;
+        this.hooks = config.hooks ?? {};
+        // Initialize logger
+        this.logger = new CallLogger({
+            logDir: config.logging?.logDir,
+            level: config.logging?.level,
+            enabled: config.logging?.enabled ?? true,
+        });
+        // Initialize tools
+        this.tools = new ToolRegistry();
+        if (config.tools) {
+            this.tools.registerAll(config.tools);
+        }
+        // Initialize providers
+        this.sttProvider = this.createSTTProvider();
+        this.ttsProvider = this.createTTSProvider();
+        this.vadProvider = new EnergyVAD();
+        this.llmProvider = this.createLLMProvider();
+        this.llmInterface = this.llmProvider.create({
+            model: config.llm.model ?? "gpt-4o-mini",
+            temperature: config.llm.temperature,
+        });
+        // Initialize JEV engine
+        const embeddingProvider = new OpenAIEmbeddingProvider({
+            apiKey: config.jev?.embeddingApiKey ??
+                config.llm.apiKey ??
+                "",
+        });
+        this.jev = new JEVEngine({
+            embeddingProvider,
+            confidenceThreshold: config.jev?.confidenceThreshold,
+        });
+        // Initialize transport
+        this.transport = new WebSocketTransport();
+    }
+    /**
+     * Start the agent — initialize JEV, start the transport, begin accepting calls.
+     */
+    async listen(options) {
+        const port = options?.port ?? this.config.transport?.port ?? 8080;
+        const host = options?.host ?? this.config.transport?.host;
+        this.logger.log("info", `Starting Felona Voice agent: "${this.config.name}"`);
+        // Step 1: Initialize JEV — embed all action descriptions
+        this.logger.log("info", "Initializing JEV engine...");
+        await this.jev.initialize(this.config.actions);
+        this.logger.log("info", `JEV initialized with ${this.config.actions.length} actions`);
+        // Step 2: Load predictor model if specified
+        if (this.config.jev?.predictorModel) {
+            await this.jev.loadPredictor(this.config.jev.predictorModel);
+        }
+        // Step 3: Wire up transport event handlers
+        this.transport.onConnect((session) => this.handleConnect(session));
+        this.transport.onDisconnect((session) => this.handleDisconnect(session));
+        this.transport.onAudioChunk((sessionId, chunk) => this.handleAudio(sessionId, chunk));
+        // Step 4: Start the transport server
+        await this.transport.start({ port, host });
+        this.initialized = true;
+        this.logger.log("info", `Agent "${this.config.name}" ready on port ${port}`);
+        this.logger.log("info", `  STT: ${this.sttProvider.name}`);
+        this.logger.log("info", `  TTS: ${this.ttsProvider.name}`);
+        this.logger.log("info", `  LLM: ${this.llmProvider.name}`);
+        this.logger.log("info", `  JEV: ${this.jev.hasPredictor ? "trained predictor" : "cold-start mode"}`);
+        this.logger.log("info", `  Actions: ${this.config.actions.map((a) => a.id).join(", ")}`);
+        this.emit("ready", { port, host });
+    }
+    /**
+     * Stop the agent — shut down all pipelines and the transport.
+     */
+    async stop() {
+        this.logger.log("info", "Stopping agent...");
+        // Stop all active pipelines
+        for (const [sessionId, pipeline] of this.pipelines) {
+            await pipeline.stop();
+        }
+        this.pipelines.clear();
+        // Stop transport
+        await this.transport.stop();
+        this.initialized = false;
+        this.logger.log("info", "Agent stopped");
+        this.emit("stopped");
+    }
+    /**
+     * Handle a new client connection — create a voice pipeline for this session.
+     */
+    async handleConnect(session) {
+        this.logger.log("info", `New call: ${session.id}`);
+        // Create per-session memory
+        const memory = new ConversationMemory();
+        // Create a new VAD instance per session (has internal state)
+        const vad = new EnergyVAD();
+        // Create the voice pipeline for this session
+        const pipeline = new VoicePipeline({
+            sessionId: session.id,
+            session,
+            stt: this.sttProvider,
+            tts: this.ttsProvider,
+            vad,
+            llm: this.llmInterface,
+            jev: this.jev,
+            memory,
+            tools: this.tools,
+            logger: this.logger,
+            hooks: this.hooks,
+            systemPrompt: this.config.systemPrompt,
+            sendAudio: (chunk) => this.transport.sendAudio(session.id, chunk),
+        });
+        // Forward pipeline events
+        pipeline.on("transcript", (data) => this.emit("transcript", { sessionId: session.id, ...data }));
+        pipeline.on("error", (error) => this.emit("error", { sessionId: session.id, error }));
+        pipeline.on("bargeIn", () => this.emit("bargeIn", { sessionId: session.id }));
+        this.pipelines.set(session.id, pipeline);
+        await pipeline.start();
+        this.emit("callStarted", session);
+    }
+    /**
+     * Handle a client disconnection — stop and clean up the pipeline.
+     */
+    async handleDisconnect(session) {
+        this.logger.log("info", `Call ended: ${session.id}`);
+        const pipeline = this.pipelines.get(session.id);
+        if (pipeline) {
+            await pipeline.stop();
+            this.pipelines.delete(session.id);
+        }
+        this.emit("callEnded", session);
+    }
+    /**
+     * Handle incoming audio from a client — route to the correct pipeline.
+     */
+    handleAudio(sessionId, chunk) {
+        const pipeline = this.pipelines.get(sessionId);
+        if (pipeline) {
+            pipeline.processAudio(chunk);
+        }
+    }
+    /** Create STT provider based on config */
+    createSTTProvider() {
+        switch (this.config.stt.provider) {
+            case "deepgram":
+                return new DeepgramSTT({
+                    apiKey: this.config.stt.apiKey ?? "",
+                });
+            default:
+                this.logger.log("warn", `Unknown STT provider "${this.config.stt.provider}", falling back to Deepgram`);
+                return new DeepgramSTT({
+                    apiKey: this.config.stt.apiKey ?? "",
+                });
+        }
+    }
+    /** Create TTS provider based on config */
+    createTTSProvider() {
+        switch (this.config.tts.provider) {
+            case "elevenlabs":
+                return new ElevenLabsTTS({
+                    apiKey: this.config.tts.apiKey ?? "",
+                    voice: this.config.tts.voice,
+                });
+            default:
+                this.logger.log("warn", `Unknown TTS provider "${this.config.tts.provider}", falling back to ElevenLabs`);
+                return new ElevenLabsTTS({
+                    apiKey: this.config.tts.apiKey ?? "",
+                });
+        }
+    }
+    /** Create LLM provider based on config */
+    createLLMProvider() {
+        switch (this.config.llm.provider) {
+            case "openai":
+                return new OpenAILLM({
+                    apiKey: this.config.llm.apiKey ?? "",
+                });
+            default:
+                this.logger.log("warn", `Unknown LLM provider "${this.config.llm.provider}", falling back to OpenAI`);
+                return new OpenAILLM({
+                    apiKey: this.config.llm.apiKey ?? "",
+                });
+        }
+    }
+    /** Get the number of active calls */
+    get activeCallCount() {
+        return this.pipelines.size;
+    }
+    /** Check if the agent is running */
+    get isRunning() {
+        return this.initialized;
+    }
+    /** Get the agent name */
+    get name() {
+        return this.config.name;
+    }
+    /** Get the JEV engine (for inspection/testing) */
+    get jevEngine() {
+        return this.jev;
+    }
+}
+/**
+ * Helper to define an action with type safety.
+ */
+export function defineAction(action) {
+    return action;
+}
+/**
+ * Quick-start factory — creates a minimal agent with sensible defaults.
+ * Automatically creates a default "respond" action that uses the LLM directly.
+ */
+export function quickStart(config) {
+    return new FelAgent({
+        name: "Felona Agent",
+        systemPrompt: config.systemPrompt ??
+            "You are a helpful, friendly voice assistant. Keep your responses concise and conversational.",
+        stt: config.stt,
+        tts: config.tts,
+        llm: config.llm,
+        actions: [
+            defineAction({
+                id: "respond",
+                description: "Respond to the user's message helpfully and conversationally",
+                handler: async (ctx) => {
+                    const response = await ctx.llm.generate(`Respond to the user naturally. User said: "${ctx.conversation.currentUtterance}"`, {
+                        systemPrompt: ctx.conversation.systemPrompt,
+                        history: ctx.memory
+                            .getRecentTurns(10)
+                            .map((t) => ({
+                            role: t.role === "user" ? "user" : "assistant",
+                            content: t.content,
+                        })),
+                    });
+                    return response;
+                },
+            }),
+        ],
+    });
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/analytics/index.d.ts

@@ -0,0 +1,3 @@
+export { CallLogger, createCallLogger } from "./logger.js";
+export type { CallLogEntry, JEVDecisionLog, CallMetrics, CallLogFile, } from "./logger.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/analytics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/analytics/index.js

@@ -0,0 +1,2 @@
+export { CallLogger, createCallLogger } from "./logger.js";
+//# sourceMappingURL=index.js.map

package/dist/analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/analytics/logger.d.ts

@@ -0,0 +1,92 @@
+import type { ConversationTurn, Session } from "../types.js";
+/**
+ * CallLogger — Logs structured conversation data for JEV training and analytics.
+ *
+ * Every completed call produces a log file with:
+ * - Session metadata
+ * - All conversation turns
+ * - JEV decisions (action selected, confidence, candidates)
+ * - Timing information
+ *
+ * These logs are the training data for the JEV predictor (Phase 2).
+ */
+export declare class CallLogger {
+    private readonly logDir;
+    private readonly level;
+    private readonly enabled;
+    constructor(options?: {
+        logDir?: string;
+        level?: "debug" | "info" | "warn" | "error";
+        enabled?: boolean;
+    });
+    /**
+     * Log a complete call session.
+     * This is called when a call ends.
+     */
+    logCall(data: CallLogEntry): Promise<string | null>;
+    /**
+     * Log a JEV decision for the current session.
+     * Used to build (context, action) training pairs.
+     */
+    logDecision(decision: JEVDecisionLog): void;
+    /** General-purpose log */
+    log(level: "debug" | "info" | "warn" | "error", message: string, data?: Record<string, unknown>): void;
+}
+/** Data for a complete call log */
+export interface CallLogEntry {
+    session: Session;
+    turns: ConversationTurn[];
+    decisions: JEVDecisionLog[];
+    metrics: CallMetrics;
+}
+/** A single JEV decision record */
+export interface JEVDecisionLog {
+    /** Timestamp of the decision */
+    timestampMs: number;
+    /** The context string that was embedded */
+    contextSummary: string;
+    /** The action that was selected */
+    selectedAction: string;
+    /** Confidence score */
+    confidence: number;
+    /** Top N candidates with scores */
+    candidates: Array<{
+        actionId: string;
+        score: number;
+    }>;
+    /** Time taken for the JEV decision (ms) */
+    latencyMs: number;
+}
+/** Call-level metrics */
+export interface CallMetrics {
+    /** Total number of turns */
+    totalTurns: number;
+    /** Average JEV decision latency (ms) */
+    avgJEVLatencyMs: number;
+    /** Average STT latency (ms) */
+    avgSTTLatencyMs?: number;
+    /** Average TTS latency (ms) */
+    avgTTSLatencyMs?: number;
+    /** Number of barge-in events */
+    bargeInCount: number;
+    /** Average JEV confidence */
+    avgConfidence: number;
+}
+/** Structure of a call log file */
+export interface CallLogFile {
+    version: string;
+    sessionId: string;
+    startedAt: string;
+    endedAt: string;
+    durationMs: number;
+    metadata: Record<string, unknown>;
+    turns: ConversationTurn[];
+    decisions: JEVDecisionLog[];
+    metrics: CallMetrics;
+}
+export declare function createCallLogger(options?: {
+    logDir?: string;
+    level?: "debug" | "info" | "warn" | "error";
+    enabled?: boolean;
+}): CallLogger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/analytics/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/analytics/logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAe,MAAM,aAAa,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,OAAO,CAAC,EAAE;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB;IAMD;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA0BzD;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAQ3C,0BAA0B;IAC1B,GAAG,CACD,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1C,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI;CAaR;AAED,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,mCAAmC;AACnC,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,UAAU,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,yBAAyB;AACzB,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,UAAU,CAEb"}

package/dist/analytics/logger.js

@@ -0,0 +1,75 @@
+import { writeFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * CallLogger — Logs structured conversation data for JEV training and analytics.
+ *
+ * Every completed call produces a log file with:
+ * - Session metadata
+ * - All conversation turns
+ * - JEV decisions (action selected, confidence, candidates)
+ * - Timing information
+ *
+ * These logs are the training data for the JEV predictor (Phase 2).
+ */
+export class CallLogger {
+    logDir;
+    level;
+    enabled;
+    constructor(options) {
+        this.logDir = options?.logDir ?? "./call-logs";
+        this.level = options?.level ?? "info";
+        this.enabled = options?.enabled ?? true;
+    }
+    /**
+     * Log a complete call session.
+     * This is called when a call ends.
+     */
+    async logCall(data) {
+        if (!this.enabled)
+            return null;
+        await mkdir(this.logDir, { recursive: true });
+        const filename = `${data.session.id}_${Date.now()}.json`;
+        const filepath = join(this.logDir, filename);
+        const logData = {
+            version: "1.0",
+            sessionId: data.session.id,
+            startedAt: data.session.startedAt.toISOString(),
+            endedAt: new Date().toISOString(),
+            durationMs: Date.now() - data.session.startedAt.getTime(),
+            metadata: data.session.metadata,
+            turns: data.turns,
+            decisions: data.decisions,
+            metrics: data.metrics,
+        };
+        await writeFile(filepath, JSON.stringify(logData, null, 2));
+        this.log("info", `Call log saved: ${filepath}`);
+        return filepath;
+    }
+    /**
+     * Log a JEV decision for the current session.
+     * Used to build (context, action) training pairs.
+     */
+    logDecision(decision) {
+        if (!this.enabled)
+            return;
+        this.log("debug", `JEV decision: ${decision.selectedAction} (confidence: ${decision.confidence.toFixed(3)})`);
+    }
+    /** General-purpose log */
+    log(level, message, data) {
+        const levels = { debug: 0, info: 1, warn: 2, error: 3 };
+        if (levels[level] < levels[this.level])
+            return;
+        const prefix = `[Felona/${level.toUpperCase()}]`;
+        const timestamp = new Date().toISOString();
+        if (data) {
+            console.log(`${prefix} ${timestamp} ${message}`, data);
+        }
+        else {
+            console.log(`${prefix} ${timestamp} ${message}`);
+        }
+    }
+}
+export function createCallLogger(options) {
+    return new CallLogger(options);
+}
+//# sourceMappingURL=logger.js.map

package/dist/analytics/logger.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Felona Voice — Open-source voice agent framework powered by JEV.
+ *
+ * @packageDocumentation
+ *
+ * @example
+ * ```typescript
+ * import { FelAgent, defineAction } from "felona-voice";
+ *
+ * const agent = new FelAgent({
+ *   name: "My Agent",
+ *   systemPrompt: "You are helpful.",
+ *   stt: { provider: "deepgram", apiKey: process.env.DEEPGRAM_API_KEY },
+ *   tts: { provider: "elevenlabs", apiKey: process.env.ELEVEN_API_KEY },
+ *   llm: { provider: "openai", apiKey: process.env.OPENAI_API_KEY, model: "gpt-4o-mini" },
+ *   actions: [
+ *     defineAction({
+ *       id: "greet",
+ *       description: "Greet the user warmly",
+ *       handler: async (ctx) => ctx.llm.generate("Greet the user", {
+ *         systemPrompt: ctx.conversation.systemPrompt,
+ *       }),
+ *     }),
+ *   ],
+ * });
+ *
+ * agent.listen({ port: 8080 });
+ * ```
+ */
+export { FelAgent, defineAction, quickStart } from "./agent.js";
+export { JEVEngine, createJEVEngine } from "./jev/engine.js";
+export { ActionSpace, cosineSimilarity } from "./jev/action-space.js";
+export { OpenAIEmbeddingProvider } from "./jev/embeddings.js";
+export { VoicePipeline, createPipeline } from "./pipeline.js";
+export { WebSocketTransport, createWebSocketTransport, } from "./transport/websocket.js";
+export { DeepgramSTT, createDeepgramSTT } from "./stt/deepgram.js";
+export { ElevenLabsTTS, createElevenLabsTTS } from "./tts/eleven-labs.js";
+export { EnergyVAD, createEnergyVAD } from "./vad/energy.js";
+export { OpenAILLM, createOpenAILLM } from "./llm/openai.js";
+export { ConversationMemory, createMemory } from "./memory/context.js";
+export { ToolRegistry, defineTool, createToolRegistry } from "./tools/registry.js";
+export { CallLogger, createCallLogger } from "./analytics/logger.js";
+export type { CallLogEntry, JEVDecisionLog, CallMetrics, CallLogFile, } from "./analytics/logger.js";
+export type { AudioChunk, Session, SessionState, ConversationTurn, ConversationContext, AgentAction, ActionContext, ActionMatch, Transport, TransportOptions, STTProvider, STTStream, STTStreamOptions, STTResult, TTSProvider, TTSOptions, VADProvider, VADResult, VADEvent, LLMProvider, LLMInterface, LLMOptions, LLMContext, AgentTool, ToolExecutor, MemoryManager, JEVEngine as JEVEngineInterface, EmbeddingProvider, AgentHooks, FelAgentConfig, } 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;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGhE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG9D,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGnE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG1E,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAG7D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAG7D,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGnF,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACrE,YAAY,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EAEV,UAAU,EAEV,OAAO,EACP,YAAY,EAEZ,gBAAgB,EAChB,mBAAmB,EAEnB,WAAW,EACX,aAAa,EACb,WAAW,EAEX,SAAS,EACT,gBAAgB,EAEhB,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,SAAS,EAET,WAAW,EACX,UAAU,EAEV,WAAW,EACX,SAAS,EACT,QAAQ,EAER,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EAEV,SAAS,EACT,YAAY,EAEZ,aAAa,EAEb,SAAS,IAAI,kBAAkB,EAC/B,iBAAiB,EAEjB,UAAU,EAEV,cAAc,GACf,MAAM,YAAY,CAAC"}