felona-voice 0.1.0

package/dist/index.js

@@ -0,0 +1,54 @@
+/**
+ * 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 });
+ * ```
+ */
+// ─── Main Entry Points ─────────────────────────────────────────────────────
+export { FelAgent, defineAction, quickStart } from "./agent.js";
+// ─── JEV Engine ─────────────────────────────────────────────────────────────
+export { JEVEngine, createJEVEngine } from "./jev/engine.js";
+export { ActionSpace, cosineSimilarity } from "./jev/action-space.js";
+export { OpenAIEmbeddingProvider } from "./jev/embeddings.js";
+// ─── Voice Pipeline ─────────────────────────────────────────────────────────
+export { VoicePipeline, createPipeline } from "./pipeline.js";
+// ─── Transport ──────────────────────────────────────────────────────────────
+export { WebSocketTransport, createWebSocketTransport, } from "./transport/websocket.js";
+// ─── STT Providers ──────────────────────────────────────────────────────────
+export { DeepgramSTT, createDeepgramSTT } from "./stt/deepgram.js";
+// ─── TTS Providers ──────────────────────────────────────────────────────────
+export { ElevenLabsTTS, createElevenLabsTTS } from "./tts/eleven-labs.js";
+// ─── VAD Providers ──────────────────────────────────────────────────────────
+export { EnergyVAD, createEnergyVAD } from "./vad/energy.js";
+// ─── LLM Providers ─────────────────────────────────────────────────────────
+export { OpenAILLM, createOpenAILLM } from "./llm/openai.js";
+// ─── Memory ─────────────────────────────────────────────────────────────────
+export { ConversationMemory, createMemory } from "./memory/context.js";
+// ─── Tools ──────────────────────────────────────────────────────────────────
+export { ToolRegistry, defineTool, createToolRegistry } from "./tools/registry.js";
+// ─── Analytics ──────────────────────────────────────────────────────────────
+export { CallLogger, createCallLogger } from "./analytics/logger.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;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,8EAA8E;AAC9E,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEhE,+EAA+E;AAC/E,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;AAE9D,+EAA+E;AAC/E,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE9D,+EAA+E;AAC/E,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAElC,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEnE,+EAA+E;AAC/E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE1E,+EAA+E;AAC/E,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE7D,8EAA8E;AAC9E,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE7D,+EAA+E;AAC/E,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEvE,+EAA+E;AAC/E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEnF,+EAA+E;AAC/E,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/jev/action-space.d.ts

@@ -0,0 +1,38 @@
+import type { AgentAction, ActionMatch, EmbeddingProvider } from "../types.js";
+/**
+ * ActionSpace — Manages the set of actions available to the agent and
+ * performs embedding-based matching.
+ *
+ * At initialization, each action's description is embedded. During inference,
+ * a predicted/context vector is compared against all action embeddings via
+ * cosine similarity to find the best match.
+ */
+export declare class ActionSpace {
+    private actions;
+    private embeddings;
+    private readonly embeddingProvider;
+    constructor(embeddingProvider: EmbeddingProvider);
+    /**
+     * Initialize the action space — embeds all action descriptions.
+     * Must be called before any matching.
+     */
+    initialize(actions: AgentAction[]): Promise<void>;
+    /**
+     * Find the closest action to the given vector using cosine similarity.
+     */
+    match(vector: Float64Array): ActionMatch;
+    /** Get an action by ID */
+    getAction(id: string): AgentAction | undefined;
+    /** Get the embedding for an action */
+    getEmbedding(actionId: string): Float64Array | undefined;
+    /** Get all actions */
+    getActions(): AgentAction[];
+    /** Number of actions in the space */
+    get size(): number;
+}
+/**
+ * Compute cosine similarity between two vectors.
+ * Returns a value between -1 and 1 (1 = identical direction).
+ */
+export declare function cosineSimilarity(a: Float64Array, b: Float64Array): number;
+//# sourceMappingURL=action-space.d.ts.map

package/dist/jev/action-space.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-space.d.ts","sourceRoot":"","sources":["../../src/jev/action-space.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EAClB,MAAM,aAAa,CAAC;AAErB;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,UAAU,CAAwC;IAC1D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;gBAE1C,iBAAiB,EAAE,iBAAiB;IAIhD;;;OAGG;IACG,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvD;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW;IA8BxC,0BAA0B;IAC1B,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI9C,sCAAsC;IACtC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIxD,sBAAsB;IACtB,UAAU,IAAI,WAAW,EAAE;IAI3B,qCAAqC;IACrC,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAqBzE"}

package/dist/jev/action-space.js

@@ -0,0 +1,92 @@
+/**
+ * ActionSpace — Manages the set of actions available to the agent and
+ * performs embedding-based matching.
+ *
+ * At initialization, each action's description is embedded. During inference,
+ * a predicted/context vector is compared against all action embeddings via
+ * cosine similarity to find the best match.
+ */
+export class ActionSpace {
+    actions = [];
+    embeddings = new Map();
+    embeddingProvider;
+    constructor(embeddingProvider) {
+        this.embeddingProvider = embeddingProvider;
+    }
+    /**
+     * Initialize the action space — embeds all action descriptions.
+     * Must be called before any matching.
+     */
+    async initialize(actions) {
+        this.actions = actions;
+        // Batch embed all action descriptions
+        const descriptions = actions.map((a) => a.description);
+        const vectors = await this.embeddingProvider.embedBatch(descriptions);
+        for (let i = 0; i < actions.length; i++) {
+            this.embeddings.set(actions[i].id, vectors[i]);
+        }
+    }
+    /**
+     * Find the closest action to the given vector using cosine similarity.
+     */
+    match(vector) {
+        if (this.actions.length === 0) {
+            throw new Error("ActionSpace not initialized — call initialize() first");
+        }
+        const candidates = [];
+        for (const action of this.actions) {
+            const actionEmbedding = this.embeddings.get(action.id);
+            if (!actionEmbedding)
+                continue;
+            const score = cosineSimilarity(vector, actionEmbedding);
+            candidates.push({ actionId: action.id, score });
+        }
+        // Sort by score descending
+        candidates.sort((a, b) => b.score - a.score);
+        const bestMatch = candidates[0];
+        const matchedAction = this.actions.find((a) => a.id === bestMatch.actionId);
+        return {
+            action: matchedAction,
+            confidence: bestMatch.score,
+            candidates,
+        };
+    }
+    /** Get an action by ID */
+    getAction(id) {
+        return this.actions.find((a) => a.id === id);
+    }
+    /** Get the embedding for an action */
+    getEmbedding(actionId) {
+        return this.embeddings.get(actionId);
+    }
+    /** Get all actions */
+    getActions() {
+        return [...this.actions];
+    }
+    /** Number of actions in the space */
+    get size() {
+        return this.actions.length;
+    }
+}
+/**
+ * Compute cosine similarity between two vectors.
+ * Returns a value between -1 and 1 (1 = identical direction).
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Vector dimension mismatch: ${a.length} vs ${b.length}`);
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denominator === 0)
+        return 0;
+    return dotProduct / denominator;
+}
+//# sourceMappingURL=action-space.js.map

package/dist/jev/action-space.js.map

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

package/dist/jev/embeddings.d.ts

@@ -0,0 +1,23 @@
+import type { EmbeddingProvider } from "../types.js";
+/**
+ * OpenAI Embedding Provider — uses the OpenAI API for text embeddings.
+ *
+ * Default embedding model for JEV in Phase 1.
+ * Uses `text-embedding-3-small` (1536 dimensions) for best quality/cost tradeoff.
+ */
+export declare class OpenAIEmbeddingProvider implements EmbeddingProvider {
+    readonly name = "openai";
+    readonly dimensions: number;
+    private readonly apiKey;
+    private readonly model;
+    private readonly baseUrl;
+    constructor(options: {
+        apiKey: string;
+        model?: string;
+        dimensions?: number;
+        baseUrl?: string;
+    });
+    embed(text: string): Promise<Float64Array>;
+    embedBatch(texts: string[]): Promise<Float64Array[]>;
+}
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/jev/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/jev/embeddings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;GAKG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;IAOK,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAyB1C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CA4B3D"}

package/dist/jev/embeddings.js

@@ -0,0 +1,63 @@
+/**
+ * OpenAI Embedding Provider — uses the OpenAI API for text embeddings.
+ *
+ * Default embedding model for JEV in Phase 1.
+ * Uses `text-embedding-3-small` (1536 dimensions) for best quality/cost tradeoff.
+ */
+export class OpenAIEmbeddingProvider {
+    name = "openai";
+    dimensions;
+    apiKey;
+    model;
+    baseUrl;
+    constructor(options) {
+        this.apiKey = options.apiKey;
+        this.model = options.model ?? "text-embedding-3-small";
+        this.dimensions = options.dimensions ?? 1536;
+        this.baseUrl = options.baseUrl ?? "https://api.openai.com/v1";
+    }
+    async embed(text) {
+        const response = await fetch(`${this.baseUrl}/embeddings`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                input: text,
+                model: this.model,
+                dimensions: this.dimensions,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`OpenAI embedding failed: ${response.status} ${error}`);
+        }
+        const data = (await response.json());
+        return new Float64Array(data.data[0].embedding);
+    }
+    async embedBatch(texts) {
+        // OpenAI supports batching natively
+        const response = await fetch(`${this.baseUrl}/embeddings`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify({
+                input: texts,
+                model: this.model,
+                dimensions: this.dimensions,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`OpenAI batch embedding failed: ${response.status} ${error}`);
+        }
+        const data = (await response.json());
+        // Sort by index to maintain order
+        const sorted = data.data.sort((a, b) => a.index - b.index);
+        return sorted.map((d) => new Float64Array(d.embedding));
+    }
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/jev/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../src/jev/embeddings.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,uBAAuB;IACzB,IAAI,GAAG,QAAQ,CAAC;IAChB,UAAU,CAAS;IACX,MAAM,CAAS;IACf,KAAK,CAAS;IACd,OAAO,CAAS;IAEjC,YAAY,OAKX;QACC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,wBAAwB,CAAC;QACvD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,2BAA2B,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,aAAa,EAAE;YACzD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACvC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,IAAI;gBACX,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAElC,CAAC;QACF,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,oCAAoC;QACpC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,aAAa,EAAE;YACzD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;aACvC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAElC,CAAC;QAEF,kCAAkC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/jev/engine.d.ts

@@ -0,0 +1,101 @@
+import type { JEVEngine as IJEVEngine, AgentAction, ActionMatch, ConversationContext, EmbeddingProvider } from "../types.js";
+import { ActionSpace } from "./action-space.js";
+/**
+ * JEVEngine — The core Joint Embedding Vector engine.
+ *
+ * This is the brain of Felona Voice. It decides what the agent should do next
+ * by encoding the conversation context into a vector and matching it against
+ * the action space.
+ *
+ * Two modes:
+ *
+ * 1. **Cold Start (no predictor)**: Encodes the current context directly and
+ *    matches against action embeddings via cosine similarity. Works out of the
+ *    box with zero training data.
+ *
+ * 2. **Trained (with predictor)**: Uses a trained MLP predictor to transform
+ *    the context vector into a predicted next-state vector before matching.
+ *    The predictor learns conversation flow patterns from call logs.
+ *
+ * The engine gracefully degrades: if no predictor is loaded, it falls back
+ * to cold-start mode automatically.
+ */
+export declare class JEVEngine implements IJEVEngine {
+    private readonly embeddingProvider;
+    private readonly actionSpace;
+    private readonly confidenceThreshold;
+    private predictorModel;
+    private initialized;
+    constructor(options: {
+        embeddingProvider: EmbeddingProvider;
+        confidenceThreshold?: number;
+    });
+    /**
+     * Initialize the engine — embed all action descriptions into the action space.
+     */
+    initialize(actions: AgentAction[]): Promise<void>;
+    /**
+     * Load a trained predictor model.
+     * In Phase 1, this is a no-op — we run in cold-start mode.
+     * Phase 2 will add ONNX.js predictor loading.
+     */
+    loadPredictor(modelPath: string): Promise<void>;
+    /**
+     * Full decision pipeline:
+     * 1. Encode the conversation context
+     * 2. Predict next state (or use context directly if no predictor)
+     * 3. Match against action space
+     */
+    decide(context: ConversationContext): Promise<ActionMatch>;
+    /**
+     * Encode the conversation context into a single embedding vector.
+     *
+     * The context string is constructed from:
+     * - System prompt (agent personality)
+     * - Recent conversation history
+     * - Current user utterance
+     * - Extracted slots
+     *
+     * This is the input to the predictor network.
+     */
+    encode(context: ConversationContext): Promise<Float64Array>;
+    /**
+     * Predict the next-state vector from a context vector.
+     *
+     * In cold-start mode (no predictor), returns the input vector unchanged.
+     * With a trained predictor, transforms the context vector to predict
+     * what the next conversation state should look like.
+     */
+    predict(contextVector: Float64Array): Promise<Float64Array>;
+    /**
+     * Match a vector against the action space.
+     */
+    match(vector: Float64Array): Promise<ActionMatch>;
+    /**
+     * Build a text string from the conversation context for embedding.
+     *
+     * Design: We want the embedding to capture:
+     * - What kind of agent this is (system prompt excerpt)
+     * - What has been discussed (recent turns)
+     * - What the user just said (current utterance)
+     * - What we know so far (slots)
+     */
+    private buildContextString;
+    /** Get the action space (for testing/inspection) */
+    getActionSpace(): ActionSpace;
+    /** Check if the engine is initialized */
+    get isInitialized(): boolean;
+    /** Check if a predictor model is loaded */
+    get hasPredictor(): boolean;
+    /** Get the confidence threshold */
+    get threshold(): number;
+    private assertInitialized;
+}
+/**
+ * Create a JEV engine with the given embedding provider.
+ */
+export declare function createJEVEngine(options: {
+    embeddingProvider: EmbeddingProvider;
+    confidenceThreshold?: number;
+}): JEVEngine;
+//# sourceMappingURL=engine.d.ts.map

package/dist/jev/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/jev/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,IAAI,UAAU,EACvB,WAAW,EACX,WAAW,EACX,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,SAAU,YAAW,UAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE;QACnB,iBAAiB,EAAE,iBAAiB,CAAC;QACrC,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B;IAMD;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASrD;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAiBhE;;;;;;;;;;OAUG;IACG,MAAM,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IAKjE;;;;;;OAMG;IACG,OAAO,CAAC,aAAa,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAWjE;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAKvD;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAsC1B,oDAAoD;IACpD,cAAc,IAAI,WAAW;IAI7B,yCAAyC;IACzC,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,2CAA2C;IAC3C,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,mCAAmC;IACnC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,OAAO,CAAC,iBAAiB;CAO1B;AAUD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,GAAG,SAAS,CAEZ"}

package/dist/jev/engine.js

@@ -0,0 +1,173 @@
+import { ActionSpace } from "./action-space.js";
+/**
+ * JEVEngine — The core Joint Embedding Vector engine.
+ *
+ * This is the brain of Felona Voice. It decides what the agent should do next
+ * by encoding the conversation context into a vector and matching it against
+ * the action space.
+ *
+ * Two modes:
+ *
+ * 1. **Cold Start (no predictor)**: Encodes the current context directly and
+ *    matches against action embeddings via cosine similarity. Works out of the
+ *    box with zero training data.
+ *
+ * 2. **Trained (with predictor)**: Uses a trained MLP predictor to transform
+ *    the context vector into a predicted next-state vector before matching.
+ *    The predictor learns conversation flow patterns from call logs.
+ *
+ * The engine gracefully degrades: if no predictor is loaded, it falls back
+ * to cold-start mode automatically.
+ */
+export class JEVEngine {
+    embeddingProvider;
+    actionSpace;
+    confidenceThreshold;
+    predictorModel = null;
+    initialized = false;
+    constructor(options) {
+        this.embeddingProvider = options.embeddingProvider;
+        this.actionSpace = new ActionSpace(options.embeddingProvider);
+        this.confidenceThreshold = options.confidenceThreshold ?? 0.3;
+    }
+    /**
+     * Initialize the engine — embed all action descriptions into the action space.
+     */
+    async initialize(actions) {
+        await this.actionSpace.initialize(actions);
+        this.initialized = true;
+    }
+    /**
+     * Load a trained predictor model.
+     * In Phase 1, this is a no-op — we run in cold-start mode.
+     * Phase 2 will add ONNX.js predictor loading.
+     */
+    async loadPredictor(modelPath) {
+        // Phase 2: Load ONNX model here
+        // this.predictorModel = await loadONNXModel(modelPath);
+        console.log(`[JEV] Predictor model loading not yet implemented. Path: ${modelPath}`);
+        console.log("[JEV] Running in cold-start mode (direct embedding similarity)");
+    }
+    /**
+     * Full decision pipeline:
+     * 1. Encode the conversation context
+     * 2. Predict next state (or use context directly if no predictor)
+     * 3. Match against action space
+     */
+    async decide(context) {
+        this.assertInitialized();
+        // Step 1: Encode context
+        const contextVector = await this.encode(context);
+        // Step 2: Predict (or passthrough in cold-start mode)
+        const targetVector = this.predictorModel
+            ? await this.predict(contextVector)
+            : contextVector;
+        // Step 3: Match against action space
+        const match = await this.match(targetVector);
+        return match;
+    }
+    /**
+     * Encode the conversation context into a single embedding vector.
+     *
+     * The context string is constructed from:
+     * - System prompt (agent personality)
+     * - Recent conversation history
+     * - Current user utterance
+     * - Extracted slots
+     *
+     * This is the input to the predictor network.
+     */
+    async encode(context) {
+        const contextString = this.buildContextString(context);
+        return this.embeddingProvider.embed(contextString);
+    }
+    /**
+     * Predict the next-state vector from a context vector.
+     *
+     * In cold-start mode (no predictor), returns the input vector unchanged.
+     * With a trained predictor, transforms the context vector to predict
+     * what the next conversation state should look like.
+     */
+    async predict(contextVector) {
+        if (!this.predictorModel) {
+            // Cold-start mode: direct passthrough
+            return contextVector;
+        }
+        // Phase 2: Run ONNX predictor
+        // return this.predictorModel.predict(contextVector);
+        return contextVector;
+    }
+    /**
+     * Match a vector against the action space.
+     */
+    async match(vector) {
+        this.assertInitialized();
+        return this.actionSpace.match(vector);
+    }
+    /**
+     * Build a text string from the conversation context for embedding.
+     *
+     * Design: We want the embedding to capture:
+     * - What kind of agent this is (system prompt excerpt)
+     * - What has been discussed (recent turns)
+     * - What the user just said (current utterance)
+     * - What we know so far (slots)
+     */
+    buildContextString(context) {
+        const parts = [];
+        // Agent personality (truncated to keep embedding focused)
+        if (context.systemPrompt) {
+            const truncated = context.systemPrompt.slice(0, 200);
+            parts.push(`Agent: ${truncated}`);
+        }
+        // Recent conversation history (last 5 turns for embedding focus)
+        const recentTurns = context.turns.slice(-5);
+        if (recentTurns.length > 0) {
+            const history = recentTurns
+                .map((t) => `${t.role === "user" ? "User" : "Agent"}: ${t.content}`)
+                .join("\n");
+            parts.push(`History:\n${history}`);
+        }
+        // Current user utterance (most important for decision)
+        if (context.currentUtterance) {
+            parts.push(`Current user message: ${context.currentUtterance}`);
+        }
+        // Extracted slots
+        const slotEntries = Object.entries(context.slots);
+        if (slotEntries.length > 0) {
+            const slotsStr = slotEntries
+                .map(([k, v]) => `${k}: ${String(v)}`)
+                .join(", ");
+            parts.push(`Known information: ${slotsStr}`);
+        }
+        return parts.join("\n\n");
+    }
+    /** Get the action space (for testing/inspection) */
+    getActionSpace() {
+        return this.actionSpace;
+    }
+    /** Check if the engine is initialized */
+    get isInitialized() {
+        return this.initialized;
+    }
+    /** Check if a predictor model is loaded */
+    get hasPredictor() {
+        return this.predictorModel !== null;
+    }
+    /** Get the confidence threshold */
+    get threshold() {
+        return this.confidenceThreshold;
+    }
+    assertInitialized() {
+        if (!this.initialized) {
+            throw new Error("JEV engine not initialized — call initialize() with actions first");
+        }
+    }
+}
+/**
+ * Create a JEV engine with the given embedding provider.
+ */
+export function createJEVEngine(options) {
+    return new JEVEngine(options);
+}
+//# sourceMappingURL=engine.js.map

package/dist/jev/engine.js.map

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

package/dist/jev/index.d.ts

@@ -0,0 +1,4 @@
+export { JEVEngine, createJEVEngine } from "./engine.js";
+export { ActionSpace, cosineSimilarity } from "./action-space.js";
+export { OpenAIEmbeddingProvider } from "./embeddings.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jev/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/jev/index.js

@@ -0,0 +1,4 @@
+export { JEVEngine, createJEVEngine } from "./engine.js";
+export { ActionSpace, cosineSimilarity } from "./action-space.js";
+export { OpenAIEmbeddingProvider } from "./embeddings.js";
+//# sourceMappingURL=index.js.map

package/dist/jev/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jev/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/llm/index.d.ts

@@ -0,0 +1,2 @@
+export { OpenAILLM, createOpenAILLM } from "./openai.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/llm/index.js

@@ -0,0 +1,2 @@
+export { OpenAILLM, createOpenAILLM } from "./openai.js";
+//# sourceMappingURL=index.js.map

package/dist/llm/index.js.map

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

package/dist/llm/openai.d.ts

@@ -0,0 +1,22 @@
+import type { LLMProvider, LLMInterface, LLMOptions } from "../types.js";
+/**
+ * OpenAILLM — LLM provider using OpenAI's chat completions API.
+ *
+ * The LLM in Felona Voice is used for **content generation**, not flow control.
+ * JEV decides what to do; the LLM decides how to say it.
+ */
+export declare class OpenAILLM implements LLMProvider {
+    readonly name = "openai";
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(options: {
+        apiKey: string;
+        baseUrl?: string;
+    });
+    create(options: LLMOptions): LLMInterface;
+}
+export declare function createOpenAILLM(options: {
+    apiKey: string;
+    baseUrl?: string;
+}): OpenAILLM;
+//# sourceMappingURL=openai.d.ts.map

package/dist/llm/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/llm/openai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAc,MAAM,aAAa,CAAC;AAErF;;;;;GAKG;AACH,qBAAa,SAAU,YAAW,WAAW;IAC3C,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAKzD,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,YAAY;CAS1C;AAiJD,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,SAAS,CAEZ"}