@fonoster/autopilot 0.16.11 → 0.17.0

package/README.md

@@ -183,13 +183,19 @@ For example:
 
 Please use the following environment variables to configure the Autopilot:
 
-- `ASSISTANTS`: The path to the configuration file.
-- `OPEN_API_KEY`: The OpenAI API key for embeddings support.
-- `KNOWLEDGE_BASE_ENABLED`: Enable knowledge base powered by AWS S3 and Unstructured API.
-- `AWS_S3_ACCESS_KEY_ID`: The AWS S3 access key.
-- `AWS_S3_SECRET_ACCESS_KEY`: The AWS S3 secret access key.
-- `UNSTRUCTURED_API_KEY`: The Unstructured API key.
-- `UNSTRUCTURED_API_URL`: The Unstructured API URL. Default is `https://api.unstructured.com`.
+- `AUTOPILOT_AWS_S3_ACCESS_KEY_ID`: The AWS S3 access key.
+- `AUTOPILOT_AWS_S3_ENDPOINT`: The AWS S3 endpoint.
+- `AUTOPILOT_AWS_S3_REGION`: The AWS S3 region.
+- `AUTOPILOT_AWS_S3_SECRET_ACCESS_KEY`: The AWS S3 secret access key.
+- `AUTOPILOT_CONVERSATION_PROVIDER`: The conversation provider.
+- `AUTOPILOT_KNOWLEDGE_BASE_ENABLED`: Enable knowledge base powered by AWS S3 and Unstructured API.
+- `AUTOPILOT_LOGS_FORMAT`: The logs format.
+- `AUTOPILOT_LOGS_LEVEL`: The logs level.
+- `AUTOPILOT_LOGS_TRANSPORT`: The logs transport.
+- `AUTOPILOT_OPENAI_API_KEY`: The OpenAI API key needed for embeddings support.
+- `AUTOPILOT_UNSTRUCTURED_API_KEY`: The Unstructured API key.
+- `AUTOPILOT_UNSTRUCTURED_API_URL`: The Unstructured API URL. Default is `https://api.unstructured.com`.
+- `AUTOPILOT_RECORDING_BASE_URL`: The recording base URL. Default is `http://localhost:9876/api/recordings`.
 
 ## What's Next
 

package/dist/envs.d.ts

@@ -12,3 +12,4 @@ export declare const APISERVER_ENDPOINT: string;
 export declare const INTEGRATIONS_FILE: string;
 export declare const OPENAI_API_KEY: string;
 export declare const SKIP_IDENTITY: boolean;
+export declare const RECORDING_BASE_URL: string;

package/dist/envs.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SKIP_IDENTITY = exports.OPENAI_API_KEY = exports.INTEGRATIONS_FILE = exports.APISERVER_ENDPOINT = exports.CONVERSATION_PROVIDER_FILE = exports.CONVERSATION_PROVIDER = exports.UNSTRUCTURED_API_URL = exports.UNSTRUCTURED_API_KEY = exports.NODE_ENV = exports.KNOWLEDGE_BASE_ENABLED = exports.AWS_S3_SECRET_ACCESS_KEY = exports.AWS_S3_REGION = exports.AWS_S3_ENDPOINT = exports.AWS_S3_ACCESS_KEY_ID = void 0;
+exports.RECORDING_BASE_URL = exports.SKIP_IDENTITY = exports.OPENAI_API_KEY = exports.INTEGRATIONS_FILE = exports.APISERVER_ENDPOINT = exports.CONVERSATION_PROVIDER_FILE = exports.CONVERSATION_PROVIDER = exports.UNSTRUCTURED_API_URL = exports.UNSTRUCTURED_API_KEY = exports.NODE_ENV = exports.KNOWLEDGE_BASE_ENABLED = exports.AWS_S3_SECRET_ACCESS_KEY = exports.AWS_S3_REGION = exports.AWS_S3_ENDPOINT = exports.AWS_S3_ACCESS_KEY_ID = void 0;
 /**
  * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
  * http://github.com/fonoster/fonoster
@@ -54,6 +54,9 @@ exports.INTEGRATIONS_FILE = e.AUTOPILOT_INTEGRATIONS_FILE
     : "/opt/fonoster/integrations.json";
 exports.OPENAI_API_KEY = e.AUTOPILOT_OPENAI_API_KEY;
 exports.SKIP_IDENTITY = e.AUTOPILOT_SKIP_IDENTITY === "true";
+exports.RECORDING_BASE_URL = e.AUTOPILOT_RECORDING_BASE_URL
+    ? e.AUTOPILOT_RECORDING_BASE_URL
+    : "http://localhost:9876/api/recordings";
 if (exports.CONVERSATION_PROVIDER.toLocaleLowerCase() !== types_1.ConversationProvider.API &&
     exports.CONVERSATION_PROVIDER.toLocaleLowerCase() !== types_1.ConversationProvider.FILE) {
     console.error("CONVERSATION_PROVIDER must be set to 'api' or 'file'");

package/dist/handleVoiceRequest.js

@@ -66,12 +66,13 @@ const sendConversationEndedEvent_1 = require("./sendConversationEndedEvent");
 const _1 = __importStar(require("."));
 const logger = (0, logger_1.getLogger)({ service: "autopilot", filePath: __filename });
 async function handleVoiceRequest(req, res) {
-    const { accessKeyId, callerNumber, ingressNumber, sessionRef, appRef, callDirection, metadata } = req;
+    const { accessKeyId, callerNumber, ingressNumber, mediaSessionRef, appRef, callRef, callDirection, metadata } = req;
     logger.verbose("voice request", {
         accessKeyId,
         ingressNumber,
-        sessionRef,
+        mediaSessionRef,
         appRef,
+        callRef,
         metadata
     });
     const assistantConfig = envs_1.CONVERSATION_PROVIDER === _1.ConversationProvider.FILE
@@ -103,7 +104,7 @@ async function handleVoiceRequest(req, res) {
     knowledgeBase?.load().then(() => {
         logger.verbose("knowledge base loaded");
     });
-    const voice = new _1.VoiceImpl(sessionRef, res);
+    const voice = new _1.VoiceImpl(mediaSessionRef, res);
     const languageModel = (0, createLanguageModel_1.createLanguageModel)({
         voice,
         assistantConfig,
@@ -138,11 +139,14 @@ async function handleVoiceRequest(req, res) {
             })
                 .filter(Boolean);
             if (assistantConfig.eventsHook?.url) {
+                // Construct recording URL: baseUrl + appRef + mediaSessionRef
+                const recordingUrl = `${envs_1.RECORDING_BASE_URL}/${appRef}_${mediaSessionRef}.wav`;
                 await (0, sendConversationEndedEvent_1.sendConversationEndedEvent)(assistantConfig.eventsHook, {
-                    chatHistory: chatHistory,
-                    phone: ingressNumber,
                     appRef,
-                    sessionRef
+                    callRef,
+                    phone: ingressNumber,
+                    chatHistory: chatHistory,
+                    recordingUrl
                 });
             }
         });

package/dist/machine/actions/interruptPlayback.js

@@ -23,7 +23,7 @@ const logger_1 = require("@fonoster/logger");
 const logger = (0, logger_1.getLogger)({ service: "autopilot", filePath: __filename });
 const interruptPlayback = async ({ context }) => {
     logger.verbose("called the interruptPlayback action", {
-        sessionRef: context.sessionRef
+        mediaSessionRef: context.mediaSessionRef
     });
     await context.voice.stopSpeech();
 };

package/dist/machine/context.d.ts

@@ -26,7 +26,7 @@ declare const context: ({ input }: {
         conversationSettings: ConversationSettings;
     };
 }) => {
-    sessionRef: string;
+    mediaSessionRef: string;
     voice: Voice;
     languageModel: LanguageModel;
     speechBuffer: string;

package/dist/machine/context.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.context = void 0;
 const context = ({ input }) => ({
-    sessionRef: input.voice.sessionRef,
+    mediaSessionRef: input.voice.mediaSessionRef,
     voice: input.voice,
     languageModel: input.languageModel,
     speechBuffer: "",

package/dist/machine/machine.d.ts

@@ -71,7 +71,7 @@ declare const machine: import("xstate").StateMachine<any, import("./types").Auto
             conversationSettings: import("..").ConversationSettings;
         };
     }) => {
-        sessionRef: string;
+        mediaSessionRef: string;
         voice: import("..").Voice;
         languageModel: import("..").LanguageModel;
         speechBuffer: string;

package/dist/machine/types.d.ts

@@ -19,7 +19,7 @@
 import { LanguageModel } from "../models";
 import { Voice } from "../voice";
 type AutopilotContext = {
-    sessionRef: string;
+    mediaSessionRef: string;
     languageModel: LanguageModel;
     voice: Voice;
     firstMessage?: string;

package/dist/sendConversationEndedEvent.d.ts

@@ -23,8 +23,9 @@ export type EventsHook = {
     headers?: Record<string, string>;
 };
 export declare function sendConversationEndedEvent(eventsHook: EventsHook, data: {
-    chatHistory: Record<string, string>[];
-    phone: string;
     appRef: string;
-    sessionRef: string;
+    callRef: string;
+    phone: string;
+    chatHistory: Record<string, string>[];
+    recordingUrl: string;
 }): Promise<void>;

package/dist/sendConversationEndedEvent.js

@@ -23,7 +23,7 @@ const common_1 = require("@fonoster/common");
 const logger_1 = require("@fonoster/logger");
 const logger = (0, logger_1.getLogger)({ service: "autopilot", filePath: __filename });
 async function sendConversationEndedEvent(eventsHook, data) {
-    const { chatHistory, phone, appRef, sessionRef } = data;
+    const { chatHistory, phone, appRef, callRef, recordingUrl } = data;
     if (!eventsHook?.events.includes(common_1.EventsHookAllowedEvents.CONVERSATION_ENDED) &&
         !eventsHook?.events.includes(common_1.EventsHookAllowedEvents.ALL)) {
         return;
@@ -32,9 +32,10 @@ async function sendConversationEndedEvent(eventsHook, data) {
     const params = {
         eventType: common_1.EventsHookAllowedEvents.CONVERSATION_ENDED,
         appRef,
-        sessionRef,
+        callRef,
         phone,
-        chatHistory
+        chatHistory,
+        ...(recordingUrl && { recordingUrl })
     };
     try {
         await (0, common_1.sendHttpRequest)({

package/dist/voice/Voice.d.ts

@@ -3,7 +3,7 @@ import { Voice } from "./types";
 declare class VoiceImpl implements Voice {
     private readonly voice;
     private readonly playbackRef;
-    sessionRef: string;
+    mediaSessionRef: string;
     sgatherStream: {
         stop: () => Promise<void>;
         onData: (cb: (payload: {
@@ -15,7 +15,7 @@ declare class VoiceImpl implements Voice {
         stop: () => Promise<void>;
         onData: (cb: (chunk: Uint8Array) => void) => void;
     };
-    constructor(sessionRef: string, voice: VoiceResponse);
+    constructor(mediaSessionRef: string, voice: VoiceResponse);
     answer(): Promise<void>;
     hangup(): Promise<void>;
     say(text: string): Promise<void>;

package/dist/voice/Voice.js

@@ -22,9 +22,9 @@ exports.VoiceImpl = void 0;
 const common_1 = require("@fonoster/common");
 const uuid_1 = require("uuid");
 class VoiceImpl {
-    constructor(sessionRef, voice) {
+    constructor(mediaSessionRef, voice) {
         this.voice = voice;
-        this.sessionRef = sessionRef;
+        this.mediaSessionRef = mediaSessionRef;
         this.playbackRef = (0, uuid_1.v4)();
     }
     async answer() {

package/dist/voice/types.d.ts

@@ -32,7 +32,7 @@ type TransferOptions = {
     record?: boolean;
 };
 type Voice = {
-    sessionRef: string;
+    mediaSessionRef: string;
     answer: () => Promise<void>;
     hangup: () => Promise<void>;
     say: (text: string) => Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonoster/autopilot",
-  "version": "0.16.11",
+  "version": "0.17.0",
   "description": "Voice AI for the Fonoster platform",
   "author": "Pedro Sanders <psanders@fonoster.com>",
   "homepage": "https://github.com/fonoster/fonoster#readme",
@@ -35,11 +35,11 @@
   "dependencies": {
     "@aws-sdk/client-s3": "^3.958.0",
     "@dmitryrechkin/json-schema-to-zod": "^1.0.1",
-    "@fonoster/common": "^0.16.8",
-    "@fonoster/logger": "^0.16.7",
-    "@fonoster/sdk": "^0.16.8",
-    "@fonoster/types": "^0.16.7",
-    "@fonoster/voice": "^0.16.10",
+    "@fonoster/common": "^0.17.0",
+    "@fonoster/logger": "^0.17.0",
+    "@fonoster/sdk": "^0.17.0",
+    "@fonoster/types": "^0.17.0",
+    "@fonoster/voice": "^0.17.0",
     "@langchain/anthropic": "^1.3.3",
     "@langchain/community": "^1.1.1",
     "@langchain/core": "^1.1.8",
@@ -59,5 +59,5 @@
     "xstate": "^5.17.3",
     "zod": "^3.25.76"
   },
-  "gitHead": "680281a11296cb509f64823461a30de237960a05"
+  "gitHead": "4d1a9afaec6f294184386e009d1a4e292fb3583b"
 }