@fonoster/autopilot 0.22.11 → 0.22.12

package/dist/machine/actions/index.d.ts

@@ -16,11 +16,9 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export { greetUser } from "./greetUser";
 export { goodbye } from "./goodbye";
 export { announceSystemError } from "./announceSystemError";
 export { interruptPlayback } from "./interruptPlayback";
-export { announceIdleTimeout } from "./announceIdleTimeout";
 export { increaseIdleTimeoutCount } from "./increaseIdleTimeoutCount";
 export { cleanSpeech } from "./cleanSpeech";
 export { appendSpeech } from "./appendSpeech";

package/dist/machine/actions/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resetState = exports.resetIdleTimeoutCount = exports.appendSpeech = exports.cleanSpeech = exports.increaseIdleTimeoutCount = exports.announceIdleTimeout = exports.interruptPlayback = exports.announceSystemError = exports.goodbye = exports.greetUser = void 0;
+exports.resetState = exports.resetIdleTimeoutCount = exports.appendSpeech = exports.cleanSpeech = exports.increaseIdleTimeoutCount = exports.interruptPlayback = exports.announceSystemError = exports.goodbye = void 0;
 /**
  * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
  * http://github.com/fonoster/fonoster
@@ -19,16 +19,12 @@ exports.resetState = exports.resetIdleTimeoutCount = exports.appendSpeech = expo
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-var greetUser_1 = require("./greetUser");
-Object.defineProperty(exports, "greetUser", { enumerable: true, get: function () { return greetUser_1.greetUser; } });
 var goodbye_1 = require("./goodbye");
 Object.defineProperty(exports, "goodbye", { enumerable: true, get: function () { return goodbye_1.goodbye; } });
 var announceSystemError_1 = require("./announceSystemError");
 Object.defineProperty(exports, "announceSystemError", { enumerable: true, get: function () { return announceSystemError_1.announceSystemError; } });
 var interruptPlayback_1 = require("./interruptPlayback");
 Object.defineProperty(exports, "interruptPlayback", { enumerable: true, get: function () { return interruptPlayback_1.interruptPlayback; } });
-var announceIdleTimeout_1 = require("./announceIdleTimeout");
-Object.defineProperty(exports, "announceIdleTimeout", { enumerable: true, get: function () { return announceIdleTimeout_1.announceIdleTimeout; } });
 var increaseIdleTimeoutCount_1 = require("./increaseIdleTimeoutCount");
 Object.defineProperty(exports, "increaseIdleTimeoutCount", { enumerable: true, get: function () { return increaseIdleTimeoutCount_1.increaseIdleTimeoutCount; } });
 var cleanSpeech_1 = require("./cleanSpeech");

package/dist/machine/actors/doAnnounceIdleTimeout.d.ts

@@ -0,0 +1,4 @@
+import { AutopilotContext } from "../types";
+export declare const doAnnounceIdleTimeout: import("xstate").PromiseActorLogic<void, {
+    context: AutopilotContext;
+}, import("xstate").EventObject>;

package/dist/machine/{actions/announceIdleTimeout.js → actors/doAnnounceIdleTimeout.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.announceIdleTimeout = void 0;
+exports.doAnnounceIdleTimeout = void 0;
 /**
  * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
  * http://github.com/fonoster/fonoster
@@ -20,11 +20,22 @@ exports.announceIdleTimeout = void 0;
  * limitations under the License.
  */
 const logger_1 = require("@fonoster/logger");
+const xstate_1 = require("xstate");
 const logger = (0, logger_1.getLogger)({ service: "autopilot", filePath: __filename });
-const announceIdleTimeout = async ({ context }) => {
-    logger.verbose("called the announceIdleTimeout action", {
-        idleMessage: context.idleMessage
+// Invoked (not fired-and-forgotten) so the machine stays in
+// "announcingIdleTimeout" until the idle message has been fully played. The
+// idle clock is re-armed only when the machine returns to "idle", so the time
+// the assistant spends talking never counts as user silence.
+exports.doAnnounceIdleTimeout = (0, xstate_1.fromPromise)(async ({ input }) => {
+    const { context } = input;
+    logger.verbose("called the doAnnounceIdleTimeout actor", {
+        idleMessage: context.idleMessage,
+        idleTimeoutCount: context.idleTimeoutCount
     });
-    await context.voice.say(context.idleMessage);
-};
-exports.announceIdleTimeout = announceIdleTimeout;
+    try {
+        await context.voice.say(context.idleMessage);
+    }
+    catch (error) {
+        logger.error("error while announcing the idle timeout", { error });
+    }
+});

package/dist/machine/actors/doGreetUser.d.ts

@@ -0,0 +1,4 @@
+import { AutopilotContext } from "../types";
+export declare const doGreetUser: import("xstate").PromiseActorLogic<void, {
+    context: AutopilotContext;
+}, import("xstate").EventObject>;

package/dist/machine/{actions/greetUser.js → actors/doGreetUser.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.greetUser = void 0;
+exports.doGreetUser = void 0;
 /**
  * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
  * http://github.com/fonoster/fonoster
@@ -20,17 +20,26 @@ exports.greetUser = void 0;
  * limitations under the License.
  */
 const logger_1 = require("@fonoster/logger");
+const xstate_1 = require("xstate");
 const logger = (0, logger_1.getLogger)({ service: "autopilot", filePath: __filename });
-const greetUser = async ({ context }) => {
-    logger.verbose("called the greetUser action", {
+// Invoked (not fired-and-forgotten) so the machine stays in "greeting" until
+// the first message has been fully played. Otherwise the idle clock would start
+// while the assistant is still talking.
+exports.doGreetUser = (0, xstate_1.fromPromise)(async ({ input }) => {
+    const { context } = input;
+    logger.verbose("called the doGreetUser actor", {
         firstMessage: context.firstMessage
     });
-    await context.voice.answer();
-    if (context.initialDtmf) {
-        await context.voice.playDtmf(context.initialDtmf);
+    try {
+        await context.voice.answer();
+        if (context.initialDtmf) {
+            await context.voice.playDtmf(context.initialDtmf);
+        }
+        if (context.firstMessage) {
+            await context.voice.say(context.firstMessage);
+        }
     }
-    if (context.firstMessage) {
-        await context.voice.say(context.firstMessage);
+    catch (error) {
+        logger.error("error while greeting the user", { error });
     }
-};
-exports.greetUser = greetUser;
+});

package/dist/machine/actors/index.d.ts

@@ -17,3 +17,5 @@
  * limitations under the License.
  */
 export * from "./doProcessUserRequest";
+export * from "./doGreetUser";
+export * from "./doAnnounceIdleTimeout";

package/dist/machine/actors/index.js

@@ -33,3 +33,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * limitations under the License.
  */
 __exportStar(require("./doProcessUserRequest"), exports);
+__exportStar(require("./doGreetUser"), exports);
+__exportStar(require("./doAnnounceIdleTimeout"), exports);

package/dist/machine/machine.d.ts

@@ -1,14 +1,34 @@
 declare const machine: import("xstate").StateMachine<any, import("./types").AutopilotEvents, {
     [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<void, {
         context: import("./types").AutopilotContext;
-    }, import("xstate").EventObject>>;
-}, {
-    src: "doProcessUserRequest";
-    logic: import("xstate").PromiseActorLogic<void, {
+    }, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<void, {
+        context: import("./types").AutopilotContext;
+    }, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<void, {
         context: import("./types").AutopilotContext;
-    }, import("xstate").EventObject>;
-    id: string;
+    }, import("xstate").EventObject>>;
 }, import("xstate").Values<{
+    doProcessUserRequest: {
+        src: "doProcessUserRequest";
+        logic: import("xstate").PromiseActorLogic<void, {
+            context: import("./types").AutopilotContext;
+        }, import("xstate").EventObject>;
+        id: string;
+    };
+    doGreetUser: {
+        src: "doGreetUser";
+        logic: import("xstate").PromiseActorLogic<void, {
+            context: import("./types").AutopilotContext;
+        }, import("xstate").EventObject>;
+        id: string;
+    };
+    doAnnounceIdleTimeout: {
+        src: "doAnnounceIdleTimeout";
+        logic: import("xstate").PromiseActorLogic<void, {
+            context: import("./types").AutopilotContext;
+        }, import("xstate").EventObject>;
+        id: string;
+    };
+}>, import("xstate").Values<{
     appendSpeech: {
         type: "appendSpeech";
         params: unknown;
@@ -29,10 +49,6 @@ declare const machine: import("xstate").StateMachine<any, import("./types").Auto
         type: "resetState";
         params: unknown;
     };
-    greetUser: {
-        type: "greetUser";
-        params: unknown;
-    };
     goodbye: {
         type: "goodbye";
         params: unknown;
@@ -45,10 +61,6 @@ declare const machine: import("xstate").StateMachine<any, import("./types").Auto
         type: "interruptPlayback";
         params: unknown;
     };
-    announceIdleTimeout: {
-        type: "announceIdleTimeout";
-        params: unknown;
-    };
 }>, import("xstate").Values<{
     idleTimeoutCountExceedsMax: {
         type: "idleTimeoutCountExceedsMax";
@@ -58,12 +70,11 @@ declare const machine: import("xstate").StateMachine<any, import("./types").Auto
         type: "hasSpeechResult";
         params: unknown;
     };
-}>, "IDLE_TIMEOUT" | "MAX_SPEECH_WAIT_TIMEOUT" | "MAX_SESSION_DURATION", "hangup" | "greeting" | "idle" | "listeningToUser" | "waitingForSpeechTimeout" | "processingUserRequest", string, {
+}>, "IDLE_TIMEOUT" | "MAX_SPEECH_WAIT_TIMEOUT" | "MAX_SESSION_DURATION", "hangup" | "greeting" | "idle" | "listeningToUser" | "announcingIdleTimeout" | "waitingForSpeechTimeout" | "processingUserRequest", string, {
     conversationSettings: import("..").ConversationSettings;
     languageModel: import("..").LanguageModel;
     voice: import("..").Voice;
 }, {}, import("xstate").EventObject, import("xstate").MetaObject, {
-    /** @xstate-layout N4IgpgJg5mDOIC5QDMB2BBAkgYgB6wBcBDAsAOiOVICcAKAWXQA0B9AZQFE23MB5AORYARAKoAldABU+-AJTY0WANoAGALqJQABwD2sAJYF9O1JpC5EAWgDMADgDsZFQDYATAFYAnLevuAjPYALIF+ADQgAJ6IHoFkrp5B9s6ezn6pzu7uAL5Z4YqYZFDUYGBGqFDYqhpIILoGRiZmFgh+tn5k1vYp9tauti7Obc7hUQievmQJzm5efq6uvvY5eRgF+hAANmDYbAAKHBwAwgAS7JLoYpJVZnWGxqY1zZ4qjrbuC-Z9gT3O9vYjiHstlckxcnXsKlaXUCrmWIHyZHWWzwhBI5EoNFomCEABkOCxpPQOLwRJJ5AikWBrjVbg0HqBmu5AipJu42t5PM8VNYMgCWtY-O05p4-F5XMyVIF3NY4RTNtt8MRSBQqGA6Ni8QTMESSWSFKtEfKlH5qto9HdGo9ENZArYyAF-P5fra+q4+YKFmQgv13EF-DypbKDRt9IQwKh9OVJDoRLA1Tt9kdTmIuCIcVd1DdzXSmohnLayLZnNZPIFi5zkkE+TyWZz7Ez4ipJX5mTLcvDg6HSBGozG49QUUr0ar1bj8YTiaTyZ2wz2oNHY2rqWb6vdcy1BXa-r5gYFnh56+6VMCvX4VF5uf7Pm2VlgyAB3Ih3coAMR01DYWhKAGMABaSfQAFswB0ABXAgEwOE4zguDNTVqbM1ytFoIQ6ZsgU5BZXC6YZIkQLx3ELIJXBUV0-kCIM70fZ8oDfD8vzAP8AOAsCIL2KDk1TdNlwQ1dLQZKwpUmOxviSFxmUFdw+Q+JxvilWw90WB1KIKaiylo99Px-f8gJA8DBzRFVMUYVh2KTFgAHUsEkLUdSnfUqKfdS6K0xidJY8CeNpJCBI3Wwtw+NJxl+YE3TwhBxRBbxbG8dxpji7xWhUsgtGoHRvzgAxykXagxDAABHUC4AgiATHISMADcdAAa3IBFUvSzLIygHK8sK4qEEq9KSHuKovMQ-jzEQOZ3g6QY-HGc9xjaPkLzIZk+m3ToQiCZKGoy2Aspa-s2qKwhIPMthzkufq+PpIb+R5e1rDsYtRR6SVPD5DCyCdYJnEhSFkgo9t6rSjattagq9rYxNoJTNg0zgrMzvXAIFK9CFBlLcTj2rPd7WvTpOm8Y9SxydtUB0CA4DMfIYYtc7mksQIJhcDxvF8AJgjCcKW08V65Liss5h6bxkqKEp1IpnNkMsX44krEiSxIotBj5TxXGcea-kVyVuXrXxkspEWfIu30QVSNJ4lSYIIWsBWlZVroSNbTXsl+mdu2ahd+11wbmgcFl2Wsc8BWLTJAlm1JC36Y8eWmtlkrU5qXIYpjdNY92qeGiXUiLPoPqVssg-CksOc+EIlfGewz1+B3bwKX8iHKUCtGT9dLBIwi3AFEVSMSMLRj8G72l8A3bTihKfsrlL-qa7KduB4qG+Q0VpTGwUgQyUibtmhxQ6bBSeWlRWlgJoA */
     readonly context: ({ input }: {
         input: {
             voice: import("..").Voice;
@@ -98,12 +109,29 @@ declare const machine: import("xstate").StateMachine<any, import("./types").Auto
     readonly initial: "greeting";
     readonly states: {
         readonly greeting: {
-            readonly always: {
-                readonly target: "idle";
-                readonly description: "Transition to idle after the initial greeting.";
+            readonly invoke: {
+                readonly src: "doGreetUser";
+                readonly description: "Answer the call and play the first message";
+                readonly input: ({ context }: {
+                    context: any;
+                    event: import("./types").AutopilotEvents;
+                    self: import("xstate").ActorRef<import("xstate").MachineSnapshot<any, import("./types").AutopilotEvents, Record<string, import("xstate").AnyActorRef>, import("xstate").StateValue, string, unknown, any, any>, import("./types").AutopilotEvents, import("xstate").AnyEventObject>;
+                }) => {
+                    context: any;
+                };
+                readonly onDone: {
+                    readonly target: "idle";
+                    readonly description: "Transition to idle after the initial greeting.";
+                };
+                readonly onError: {
+                    readonly target: "idle";
+                };
             };
-            readonly entry: {
-                readonly type: "greetUser";
+            readonly on: {
+                readonly SPEECH_START: {
+                    readonly target: "listeningToUser";
+                    readonly description: "The user barged in during the greeting.";
+                };
             };
         };
         readonly idle: {
@@ -127,28 +155,67 @@ declare const machine: import("xstate").StateMachine<any, import("./types").Auto
                         params: undefined;
                     }>;
                 }, {
-                    readonly target: "idle";
-                    readonly actions: readonly [{
-                        readonly type: "increaseIdleTimeoutCount";
-                    }, {
-                        readonly type: "announceIdleTimeout";
-                    }];
-                    readonly reenter: true;
+                    readonly target: "announcingIdleTimeout";
                 }];
             };
         };
+        readonly announcingIdleTimeout: {
+            readonly entry: readonly [{
+                readonly type: "increaseIdleTimeoutCount";
+            }];
+            readonly invoke: {
+                readonly src: "doAnnounceIdleTimeout";
+                readonly description: "Play the idle message";
+                readonly input: ({ context }: {
+                    context: any;
+                    event: import("./types").AutopilotEvents;
+                    self: import("xstate").ActorRef<import("xstate").MachineSnapshot<any, import("./types").AutopilotEvents, Record<string, import("xstate").AnyActorRef>, import("xstate").StateValue, string, unknown, any, any>, import("./types").AutopilotEvents, import("xstate").AnyEventObject>;
+                }) => {
+                    context: any;
+                };
+                readonly onDone: {
+                    readonly target: "idle";
+                    readonly description: "Re-arm the idle clock once the idle message finishes.";
+                };
+                readonly onError: {
+                    readonly target: "idle";
+                };
+            };
+            readonly on: {
+                readonly SPEECH_START: {
+                    readonly target: "listeningToUser";
+                    readonly description: "The user spoke while the idle message was playing.";
+                };
+            };
+        };
         readonly listeningToUser: {
             readonly entry: readonly [{
                 readonly type: "interruptPlayback";
             }, {
                 readonly type: "resetIdleTimeoutCount";
-            }, import("xstate").ActionFunction<any, import("./types").AutopilotEvents, import("./types").AutopilotEvents, undefined, {
-                src: "doProcessUserRequest";
-                logic: import("xstate").PromiseActorLogic<void, {
-                    context: import("./types").AutopilotContext;
-                }, import("xstate").EventObject>;
-                id: string;
-            }, never, never, never, never>];
+            }, import("xstate").ActionFunction<any, import("./types").AutopilotEvents, import("./types").AutopilotEvents, undefined, import("xstate").Values<{
+                doProcessUserRequest: {
+                    src: "doProcessUserRequest";
+                    logic: import("xstate").PromiseActorLogic<void, {
+                        context: import("./types").AutopilotContext;
+                    }, import("xstate").EventObject>;
+                    id: string;
+                };
+                doGreetUser: {
+                    src: "doGreetUser";
+                    logic: import("xstate").PromiseActorLogic<void, {
+                        context: import("./types").AutopilotContext;
+                    }, import("xstate").EventObject>;
+                    id: string;
+                };
+                doAnnounceIdleTimeout: {
+                    src: "doAnnounceIdleTimeout";
+                    logic: import("xstate").PromiseActorLogic<void, {
+                        context: import("./types").AutopilotContext;
+                    }, import("xstate").EventObject>;
+                    id: string;
+                };
+            }>, never, never, never, never>];
             readonly on: {
                 readonly SPEECH_RESULT: {
                     readonly target: "waitingForSpeechTimeout";
@@ -161,12 +228,16 @@ declare const machine: import("xstate").StateMachine<any, import("./types").Auto
             };
             readonly after: {
                 readonly IDLE_TIMEOUT: readonly [{
-                    readonly target: "idle";
-                    readonly actions: readonly [{
-                        readonly type: "increaseIdleTimeoutCount";
-                    }, {
-                        readonly type: "announceIdleTimeout";
-                    }];
+                    readonly target: "hangup";
+                    readonly actions: {
+                        readonly type: "goodbye";
+                    };
+                    readonly guard: import("xstate/dist/declarations/src/guards").GuardPredicate<any, import("./types").AutopilotEvents, unknown, {
+                        type: "idleTimeoutCountExceedsMax";
+                        params: undefined;
+                    }>;
+                }, {
+                    readonly target: "announcingIdleTimeout";
                 }];
             };
         };
@@ -193,13 +264,29 @@ declare const machine: import("xstate").StateMachine<any, import("./types").Auto
                         type: "SPEECH_RESULT";
                         speech: string;
                         responseTime: number;
-                    }, import("./types").AutopilotEvents, undefined, {
-                        src: "doProcessUserRequest";
-                        logic: import("xstate").PromiseActorLogic<void, {
-                            context: import("./types").AutopilotContext;
-                        }, import("xstate").EventObject>;
-                        id: string;
-                    }, never, never, never, never>];
+                    }, import("./types").AutopilotEvents, undefined, import("xstate").Values<{
+                        doProcessUserRequest: {
+                            src: "doProcessUserRequest";
+                            logic: import("xstate").PromiseActorLogic<void, {
+                                context: import("./types").AutopilotContext;
+                            }, import("xstate").EventObject>;
+                            id: string;
+                        };
+                        doGreetUser: {
+                            src: "doGreetUser";
+                            logic: import("xstate").PromiseActorLogic<void, {
+                                context: import("./types").AutopilotContext;
+                            }, import("xstate").EventObject>;
+                            id: string;
+                        };
+                        doAnnounceIdleTimeout: {
+                            src: "doAnnounceIdleTimeout";
+                            logic: import("xstate").PromiseActorLogic<void, {
+                                context: import("./types").AutopilotContext;
+                            }, import("xstate").EventObject>;
+                            id: string;
+                        };
+                    }>, never, never, never, never>];
                 };
             };
             readonly after: {
@@ -241,13 +328,29 @@ declare const machine: import("xstate").StateMachine<any, import("./types").Auto
                         type: "SPEECH_RESULT";
                         speech: string;
                         responseTime: number;
-                    }, import("./types").AutopilotEvents, undefined, {
-                        src: "doProcessUserRequest";
-                        logic: import("xstate").PromiseActorLogic<void, {
-                            context: import("./types").AutopilotContext;
-                        }, import("xstate").EventObject>;
-                        id: string;
-                    }, never, never, never, never>];
+                    }, import("./types").AutopilotEvents, undefined, import("xstate").Values<{
+                        doProcessUserRequest: {
+                            src: "doProcessUserRequest";
+                            logic: import("xstate").PromiseActorLogic<void, {
+                                context: import("./types").AutopilotContext;
+                            }, import("xstate").EventObject>;
+                            id: string;
+                        };
+                        doGreetUser: {
+                            src: "doGreetUser";
+                            logic: import("xstate").PromiseActorLogic<void, {
+                                context: import("./types").AutopilotContext;
+                            }, import("xstate").EventObject>;
+                            id: string;
+                        };
+                        doAnnounceIdleTimeout: {
+                            src: "doAnnounceIdleTimeout";
+                            logic: import("xstate").PromiseActorLogic<void, {
+                                context: import("./types").AutopilotContext;
+                            }, import("xstate").EventObject>;
+                            id: string;
+                        };
+                    }>, never, never, never, never>];
                     readonly reenter: true;
                 };
             };
@@ -266,13 +369,29 @@ declare const machine: import("xstate").StateMachine<any, import("./types").Auto
                     readonly reenter: true;
                     readonly actions: readonly [{
                         readonly type: "cleanSpeech";
-                    }, import("xstate").ActionFunction<any, import("xstate").DoneActorEvent<void, string>, import("./types").AutopilotEvents, undefined, {
-                        src: "doProcessUserRequest";
-                        logic: import("xstate").PromiseActorLogic<void, {
-                            context: import("./types").AutopilotContext;
-                        }, import("xstate").EventObject>;
-                        id: string;
-                    }, never, never, never, never>];
+                    }, import("xstate").ActionFunction<any, import("xstate").DoneActorEvent<void, string>, import("./types").AutopilotEvents, undefined, import("xstate").Values<{
+                        doProcessUserRequest: {
+                            src: "doProcessUserRequest";
+                            logic: import("xstate").PromiseActorLogic<void, {
+                                context: import("./types").AutopilotContext;
+                            }, import("xstate").EventObject>;
+                            id: string;
+                        };
+                        doGreetUser: {
+                            src: "doGreetUser";
+                            logic: import("xstate").PromiseActorLogic<void, {
+                                context: import("./types").AutopilotContext;
+                            }, import("xstate").EventObject>;
+                            id: string;
+                        };
+                        doAnnounceIdleTimeout: {
+                            src: "doAnnounceIdleTimeout";
+                            logic: import("xstate").PromiseActorLogic<void, {
+                                context: import("./types").AutopilotContext;
+                            }, import("xstate").EventObject>;
+                            id: string;
+                        };
+                    }>, never, never, never, never>];
                 };
             };
         };

package/dist/machine/machine.js

@@ -24,18 +24,31 @@ const xstate_2 = require("xstate");
 const context_1 = require("./context");
 const setup_1 = require("./setup");
 const machine = setup_1.machineSetup.createMachine({
-    /** @xstate-layout N4IgpgJg5mDOIC5QDMB2BBAkgYgB6wBcBDAsAOiOVICcAKAWXQA0B9AZQFE23MB5AORYARAKoAldABU+-AJTY0WANoAGALqJQABwD2sAJYF9O1JpC5EAWgDMADgDsZFQDYATAFYAnLevuAjPYALIF+ADQgAJ6IHoFkrp5B9s6ezn6pzu7uAL5Z4YqYZFDUYGBGqFDYqhpIILoGRiZmFgh+tn5k1vYp9tauti7Obc7hUQievmQJzm5efq6uvvY5eRgF+hAANmDYbAAKHBwAwgAS7JLoYpJVZnWGxqY1zZ4qjrbuC-Z9gT3O9vYjiHstlckxcnXsKlaXUCrmWIHyZHWWzwhBI5EoNFomCEABkOCxpPQOLwRJJ5AikWBrjVbg0HqBmu5AipJu42t5PM8VNYMgCWtY-O05p4-F5XMyVIF3NY4RTNtt8MRSBQqGA6Ni8QTMESSWSFKtEfKlH5qto9HdGo9ENZArYyAF-P5fra+q4+YKFmQgv13EF-DypbKDRt9IQwKh9OVJDoRLA1Tt9kdTmIuCIcVd1DdzXSmohnLayLZnNZPIFi5zkkE+TyWZz7Ez4ipJX5mTLcvDg6HSBGozG49QUUr0ar1bj8YTiaTyZ2wz2oNHY2rqWb6vdcy1BXa-r5gYFnh56+6VMCvX4VF5uf7Pm2VlgyAB3Ih3coAMR01DYWhKAGMABaSfQAFswB0ABXAgEwOE4zguDNTVqbM1ytFoIQ6ZsgU5BZXC6YZIkQLx3ELIJXBUV0-kCIM70fZ8oDfD8vzAP8AOAsCIL2KDk1TdNlwQ1dLQZKwpUmOxviSFxmUFdw+Q+JxvilWw90WB1KIKaiylo99Px-f8gJA8DBzRFVMUYVh2KTFgAHUsEkLUdSnfUqKfdS6K0xidJY8CeNpJCBI3Wwtw+NJxl+YE3TwhBxRBbxbG8dxpji7xWhUsgtGoHRvzgAxykXagxDAABHUC4AgiATHISMADcdAAa3IBFUvSzLIygHK8sK4qEEq9KSHuKovMQ-jzEQOZ3g6QY-HGc9xjaPkLzIZk+m3ToQiCZKGoy2Aspa-s2qKwhIPMthzkufq+PpIb+R5e1rDsYtRR6SVPD5DCyCdYJnEhSFkgo9t6rSjattagq9rYxNoJTNg0zgrMzvXAIFK9CFBlLcTj2rPd7WvTpOm8Y9SxydtUB0CA4DMfIYYtc7mksQIJhcDxvF8AJgjCcKW08V65Liss5h6bxkqKEp1IpnNkMsX44krEiSxIotBj5TxXGcea-kVyVuXrXxkspEWfIu30QVSNJ4lSYIIWsBWlZVroSNbTXsl+mdu2ahd+11wbmgcFl2Wsc8BWLTJAlm1JC36Y8eWmtlkrU5qXIYpjdNY92qeGiXUiLPoPqVssg-CksOc+EIlfGewz1+B3bwKX8iHKUCtGT9dLBIwi3AFEVSMSMLRj8G72l8A3bTihKfsrlL-qa7KduB4qG+Q0VpTGwUgQyUibtmhxQ6bBSeWlRWlgJoA */
     context: context_1.context,
     id: "fnAI",
     initial: "greeting",
     states: {
         greeting: {
-            always: {
-                target: "idle",
-                description: "Transition to idle after the initial greeting."
+            // The greeting is invoked (not fired-and-forgotten) so the machine only
+            // moves to "idle", and therefore only arms the idle clock, once the
+            // first message has been fully played.
+            invoke: {
+                src: "doGreetUser",
+                description: "Answer the call and play the first message",
+                input: ({ context }) => ({ context }),
+                onDone: {
+                    target: "idle",
+                    description: "Transition to idle after the initial greeting."
+                },
+                onError: {
+                    target: "idle"
+                }
             },
-            entry: {
-                type: "greetUser"
+            on: {
+                SPEECH_START: {
+                    target: "listeningToUser",
+                    description: "The user barged in during the greeting."
+                }
             }
         },
         idle: {
@@ -54,16 +67,37 @@ const machine = setup_1.machineSetup.createMachine({
                         guard: (0, xstate_1.and)(["idleTimeoutCountExceedsMax"])
                     },
                     {
-                        target: "idle",
-                        actions: [
-                            { type: "increaseIdleTimeoutCount" },
-                            { type: "announceIdleTimeout" }
-                        ],
-                        reenter: true
+                        target: "announcingIdleTimeout"
                     }
                 ]
             }
         },
+        announcingIdleTimeout: {
+            // A dedicated state, with no IDLE_TIMEOUT of its own, so the idle clock
+            // is stopped while the idle message plays. It is re-armed only when the
+            // message finishes and the machine goes back to "idle". This prevents
+            // back-to-back idle announcements (and a premature hangup) when the
+            // idle timeout is short relative to the message duration.
+            entry: [{ type: "increaseIdleTimeoutCount" }],
+            invoke: {
+                src: "doAnnounceIdleTimeout",
+                description: "Play the idle message",
+                input: ({ context }) => ({ context }),
+                onDone: {
+                    target: "idle",
+                    description: "Re-arm the idle clock once the idle message finishes."
+                },
+                onError: {
+                    target: "idle"
+                }
+            },
+            on: {
+                SPEECH_START: {
+                    target: "listeningToUser",
+                    description: "The user spoke while the idle message was playing."
+                }
+            }
+        },
         listeningToUser: {
             entry: [
                 { type: "interruptPlayback" },
@@ -83,11 +117,12 @@ const machine = setup_1.machineSetup.createMachine({
             after: {
                 IDLE_TIMEOUT: [
                     {
-                        target: "idle",
-                        actions: [
-                            { type: "increaseIdleTimeoutCount" },
-                            { type: "announceIdleTimeout" }
-                        ]
+                        target: "hangup",
+                        actions: { type: "goodbye" },
+                        guard: (0, xstate_1.and)(["idleTimeoutCountExceedsMax"])
+                    },
+                    {
+                        target: "announcingIdleTimeout"
                     }
                 ]
             }

package/dist/machine/setup.d.ts

@@ -3,13 +3,29 @@ import { LanguageModel } from "../models";
 import { Voice } from "../voice";
 import { AutopilotContext, AutopilotEvents } from "./types";
 declare const machineSetup: {
-    createMachine: <const TConfig extends import("xstate").MachineConfig<any, AutopilotEvents, {
-        src: "doProcessUserRequest";
-        logic: import("xstate").PromiseActorLogic<void, {
-            context: AutopilotContext;
-        }, import("xstate").EventObject>;
-        id: string;
-    }, import("xstate").Values<{
+    createMachine: <const TConfig extends import("xstate").MachineConfig<any, AutopilotEvents, import("xstate").Values<{
+        doProcessUserRequest: {
+            src: "doProcessUserRequest";
+            logic: import("xstate").PromiseActorLogic<void, {
+                context: AutopilotContext;
+            }, import("xstate").EventObject>;
+            id: string;
+        };
+        doGreetUser: {
+            src: "doGreetUser";
+            logic: import("xstate").PromiseActorLogic<void, {
+                context: AutopilotContext;
+            }, import("xstate").EventObject>;
+            id: string;
+        };
+        doAnnounceIdleTimeout: {
+            src: "doAnnounceIdleTimeout";
+            logic: import("xstate").PromiseActorLogic<void, {
+                context: AutopilotContext;
+            }, import("xstate").EventObject>;
+            id: string;
+        };
+    }>, import("xstate").Values<{
         appendSpeech: {
             type: "appendSpeech";
             params: unknown;
@@ -30,10 +46,6 @@ declare const machineSetup: {
             type: "resetState";
             params: unknown;
         };
-        greetUser: {
-            type: "greetUser";
-            params: unknown;
-        };
         goodbye: {
             type: "goodbye";
             params: unknown;
@@ -46,10 +58,6 @@ declare const machineSetup: {
             type: "interruptPlayback";
             params: unknown;
         };
-        announceIdleTimeout: {
-            type: "announceIdleTimeout";
-            params: unknown;
-        };
     }>, import("xstate").Values<{
         idleTimeoutCountExceedsMax: {
             type: "idleTimeoutCountExceedsMax";
@@ -66,14 +74,34 @@ declare const machineSetup: {
     }, {}, import("xstate").EventObject, import("xstate").MetaObject>>(config: TConfig) => import("xstate").StateMachine<any, AutopilotEvents, {
         [x: string]: import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<void, {
             context: AutopilotContext;
-        }, import("xstate").EventObject>>;
-    }, {
-        src: "doProcessUserRequest";
-        logic: import("xstate").PromiseActorLogic<void, {
+        }, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<void, {
             context: AutopilotContext;
-        }, import("xstate").EventObject>;
-        id: string;
+        }, import("xstate").EventObject>> | import("xstate").ActorRefFromLogic<import("xstate").PromiseActorLogic<void, {
+            context: AutopilotContext;
+        }, import("xstate").EventObject>>;
     }, import("xstate").Values<{
+        doProcessUserRequest: {
+            src: "doProcessUserRequest";
+            logic: import("xstate").PromiseActorLogic<void, {
+                context: AutopilotContext;
+            }, import("xstate").EventObject>;
+            id: string;
+        };
+        doGreetUser: {
+            src: "doGreetUser";
+            logic: import("xstate").PromiseActorLogic<void, {
+                context: AutopilotContext;
+            }, import("xstate").EventObject>;
+            id: string;
+        };
+        doAnnounceIdleTimeout: {
+            src: "doAnnounceIdleTimeout";
+            logic: import("xstate").PromiseActorLogic<void, {
+                context: AutopilotContext;
+            }, import("xstate").EventObject>;
+            id: string;
+        };
+    }>, import("xstate").Values<{
         appendSpeech: {
             type: "appendSpeech";
             params: unknown;
@@ -94,10 +122,6 @@ declare const machineSetup: {
             type: "resetState";
             params: unknown;
         };
-        greetUser: {
-            type: "greetUser";
-            params: unknown;
-        };
         goodbye: {
             type: "goodbye";
             params: unknown;
@@ -110,10 +134,6 @@ declare const machineSetup: {
             type: "interruptPlayback";
             params: unknown;
         };
-        announceIdleTimeout: {
-            type: "announceIdleTimeout";
-            params: unknown;
-        };
     }>, import("xstate").Values<{
         idleTimeoutCountExceedsMax: {
             type: "idleTimeoutCountExceedsMax";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonoster/autopilot",
-  "version": "0.22.11",
+  "version": "0.22.12",
   "description": "Voice AI for the Fonoster platform",
   "author": "Pedro Sanders <psanders@fonoster.com>",
   "homepage": "https://github.com/fonoster/fonoster#readme",
@@ -59,5 +59,5 @@
     "xstate": "^5.17.3",
     "zod": "^3.25.76"
   },
-  "gitHead": "d4425a19b1971da1edb6ea717e96bf2fddaefcc4"
+  "gitHead": "facc2ea4a1d403afe29ce62f8f8dab3eaedbf015"
 }

package/dist/machine/actions/announceIdleTimeout.d.ts

@@ -1,4 +0,0 @@
-import { AutopilotContext } from "../types";
-export declare const announceIdleTimeout: ({ context }: {
-    context: AutopilotContext;
-}) => Promise<void>;

package/dist/machine/actions/greetUser.d.ts

@@ -1,4 +0,0 @@
-import { AutopilotContext } from "../types";
-export declare const greetUser: ({ context }: {
-    context: AutopilotContext;
-}) => Promise<void>;