@speakai/shared 2.1.27 → 2.1.28

package/dist/voice/enums/index.d.ts

@@ -16,6 +16,7 @@ export * from "./livekit.js";
 export * from "./notification.js";
 export * from "./organization.js";
 export * from "./providers.js";
+export * from "./responsePace.js";
 export * from "./structuredOutput.js";
 export * from "./telephony.js";
 export * from "./voice.js";

package/dist/voice/enums/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/voice/enums/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/voice/enums/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/voice/enums/index.js

@@ -16,6 +16,7 @@ export * from "./livekit.js";
 export * from "./notification.js";
 export * from "./organization.js";
 export * from "./providers.js";
+export * from "./responsePace.js";
 export * from "./structuredOutput.js";
 export * from "./telephony.js";
 export * from "./voice.js";

package/dist/voice/enums/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/voice/enums/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/voice/enums/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/voice/enums/responsePace.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Response Pace
+ * How long an agent waits for the caller to finish before it replies
+ */
+export declare enum ResponsePace {
+    /** Replies as soon as the caller pauses */
+    SNAPPY = "snappy",
+    /** The default pause — natural back-and-forth */
+    BALANCED = "balanced",
+    /** Leaves room for the caller to think mid-sentence */
+    PATIENT = "patient",
+    /** Longest wait, for callers who need time to finish */
+    VERY_PATIENT = "very_patient"
+}
+/** Type alias for response pace values */
+export type ResponsePaceType = `${ResponsePace}`;
+/** Array of all valid response paces */
+export declare const RESPONSE_PACES: ResponsePaceType[];
+//# sourceMappingURL=responsePace.d.ts.map

package/dist/voice/enums/responsePace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsePace.d.ts","sourceRoot":"","sources":["../../../src/voice/enums/responsePace.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,YAAY;IACtB,2CAA2C;IAC3C,MAAM,WAAW;IACjB,iDAAiD;IACjD,QAAQ,aAAa;IACrB,uDAAuD;IACvD,OAAO,YAAY;IACnB,wDAAwD;IACxD,YAAY,iBAAiB;CAC9B;AAED,0CAA0C;AAC1C,MAAM,MAAM,gBAAgB,GAAG,GAAG,YAAY,EAAE,CAAC;AAEjD,wCAAwC;AACxC,eAAO,MAAM,cAAc,EAAkC,gBAAgB,EAAE,CAAC"}

package/dist/voice/enums/responsePace.js

@@ -0,0 +1,18 @@
+/**
+ * Response Pace
+ * How long an agent waits for the caller to finish before it replies
+ */
+export var ResponsePace;
+(function (ResponsePace) {
+    /** Replies as soon as the caller pauses */
+    ResponsePace["SNAPPY"] = "snappy";
+    /** The default pause — natural back-and-forth */
+    ResponsePace["BALANCED"] = "balanced";
+    /** Leaves room for the caller to think mid-sentence */
+    ResponsePace["PATIENT"] = "patient";
+    /** Longest wait, for callers who need time to finish */
+    ResponsePace["VERY_PATIENT"] = "very_patient";
+})(ResponsePace || (ResponsePace = {}));
+/** Array of all valid response paces */
+export const RESPONSE_PACES = Object.values(ResponsePace);
+//# sourceMappingURL=responsePace.js.map

package/dist/voice/enums/responsePace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsePace.js","sourceRoot":"","sources":["../../../src/voice/enums/responsePace.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,YASX;AATD,WAAY,YAAY;IACtB,2CAA2C;IAC3C,iCAAiB,CAAA;IACjB,iDAAiD;IACjD,qCAAqB,CAAA;IACrB,uDAAuD;IACvD,mCAAmB,CAAA;IACnB,wDAAwD;IACxD,6CAA6B,CAAA;AAC/B,CAAC,EATW,YAAY,KAAZ,YAAY,QASvB;AAKD,wCAAwC;AACxC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAuB,CAAC"}

package/dist/voice/index.d.ts

@@ -9,4 +9,5 @@
 export * from "./enums/index.js";
 export * from "./interfaces/index.js";
 export * from "./templates/index.js";
+export * from "./responsePace.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/voice/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/voice/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

package/dist/voice/index.js

@@ -9,4 +9,5 @@
 export * from "./enums/index.js";
 export * from "./interfaces/index.js";
 export * from "./templates/index.js";
+export * from "./responsePace.js";
 //# sourceMappingURL=index.js.map

package/dist/voice/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/voice/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/voice/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC"}

package/dist/voice/interfaces/index.d.ts

@@ -20,4 +20,5 @@ export * from "./kbGap.js";
 export * from "./notification.js";
 export * from "./organization.js";
 export * from "./testing.js";
+export * from "./turnTaking.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/voice/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/voice/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/voice/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/voice/interfaces/index.js

@@ -20,4 +20,5 @@ export * from "./kbGap.js";
 export * from "./notification.js";
 export * from "./organization.js";
 export * from "./testing.js";
+export * from "./turnTaking.js";
 //# sourceMappingURL=index.js.map

package/dist/voice/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/voice/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/voice/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/voice/interfaces/turnTaking.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Turn Taking Interfaces
+ */
+/**
+ * LiveKit `turnHandling.endpointing` options. Delays are in milliseconds.
+ */
+export interface TurnTakingConfig {
+    /** `fixed` always waits minDelay; `dynamic` adapts within the delay window */
+    mode: "fixed" | "dynamic";
+    /** Shortest silence, in ms, before the agent may take the turn */
+    minDelay: number;
+    /** Longest silence, in ms, the agent waits before it takes the turn anyway */
+    maxDelay: number;
+    /** Smoothing factor for `dynamic` mode; higher leans towards longer waits */
+    alpha?: number;
+}
+//# sourceMappingURL=turnTaking.d.ts.map

package/dist/voice/interfaces/turnTaking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnTaking.d.ts","sourceRoot":"","sources":["../../../src/voice/interfaces/turnTaking.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/voice/interfaces/turnTaking.js

@@ -0,0 +1,5 @@
+/**
+ * Turn Taking Interfaces
+ */
+export {};
+//# sourceMappingURL=turnTaking.js.map

package/dist/voice/interfaces/turnTaking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnTaking.js","sourceRoot":"","sources":["../../../src/voice/interfaces/turnTaking.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/voice/responsePace.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Response-pace presets
+ *
+ * The single mapping from a named `ResponsePace` to the `TurnTakingConfig` each
+ * backend sends to the worker, so an agent paces the same way whichever pool
+ * answers the call.
+ */
+import { type ResponsePaceType } from "./enums/responsePace.js";
+import type { TurnTakingConfig } from "./interfaces/turnTaking.js";
+/** Pace applied when an agent stores no preset of its own */
+export declare const DEFAULT_RESPONSE_PACE: ResponsePaceType;
+/** Turn-taking numbers behind each preset */
+export declare const RESPONSE_PACE_PRESETS: Readonly<Record<ResponsePaceType, Readonly<TurnTakingConfig>>>;
+/**
+ * Resolve a stored response-pace value to its turn-taking config.
+ *
+ * Anything that is not a known preset key — undefined, null, a non-string, an
+ * unknown string, or an inherited `Object.prototype` key — resolves to the
+ * balanced preset, which is the pace agents ran at before presets existed.
+ *
+ * @param pace raw value read off the agent document
+ * @returns a fresh, mutable copy of the resolved config
+ */
+export declare const resolveResponsePace: (pace?: unknown) => TurnTakingConfig;
+//# sourceMappingURL=responsePace.d.ts.map

package/dist/voice/responsePace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsePace.d.ts","sourceRoot":"","sources":["../../src/voice/responsePace.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,EAAE,gBAAwC,CAAC;AAE7E,6CAA6C;AAC7C,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAC1C,MAAM,CAAC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAgBC,CAAC;AAExD;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG,gBAOpD,CAAC"}

package/dist/voice/responsePace.js

@@ -0,0 +1,44 @@
+/**
+ * Response-pace presets
+ *
+ * The single mapping from a named `ResponsePace` to the `TurnTakingConfig` each
+ * backend sends to the worker, so an agent paces the same way whichever pool
+ * answers the call.
+ */
+import { ResponsePace } from "./enums/responsePace.js";
+/** Pace applied when an agent stores no preset of its own */
+export const DEFAULT_RESPONSE_PACE = ResponsePace.BALANCED;
+/** Turn-taking numbers behind each preset */
+export const RESPONSE_PACE_PRESETS = Object.freeze({
+    [ResponsePace.SNAPPY]: Object.freeze({ mode: "fixed", minDelay: 200, maxDelay: 2000 }),
+    [ResponsePace.BALANCED]: Object.freeze({ mode: "fixed", minDelay: 300, maxDelay: 2500 }),
+    [ResponsePace.PATIENT]: Object.freeze({
+        mode: "dynamic",
+        minDelay: 600,
+        maxDelay: 3500,
+        alpha: 0.9,
+    }),
+    [ResponsePace.VERY_PATIENT]: Object.freeze({
+        mode: "dynamic",
+        minDelay: 900,
+        maxDelay: 5000,
+        alpha: 0.9,
+    }),
+});
+/**
+ * Resolve a stored response-pace value to its turn-taking config.
+ *
+ * Anything that is not a known preset key — undefined, null, a non-string, an
+ * unknown string, or an inherited `Object.prototype` key — resolves to the
+ * balanced preset, which is the pace agents ran at before presets existed.
+ *
+ * @param pace raw value read off the agent document
+ * @returns a fresh, mutable copy of the resolved config
+ */
+export const resolveResponsePace = (pace) => {
+    const key = typeof pace === "string" && Object.prototype.hasOwnProperty.call(RESPONSE_PACE_PRESETS, pace)
+        ? pace
+        : DEFAULT_RESPONSE_PACE;
+    return { ...RESPONSE_PACE_PRESETS[key] };
+};
+//# sourceMappingURL=responsePace.js.map

package/dist/voice/responsePace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responsePace.js","sourceRoot":"","sources":["../../src/voice/responsePace.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAyB,MAAM,yBAAyB,CAAC;AAG9E,6DAA6D;AAC7D,MAAM,CAAC,MAAM,qBAAqB,GAAqB,YAAY,CAAC,QAAQ,CAAC;AAE7E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAE9B,MAAM,CAAC,MAAM,CAAC;IAChB,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACtF,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACxF,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC;QACpC,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,GAAG;QACb,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,GAAG;KACX,CAAC;IACF,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC;QACzC,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,GAAG;QACb,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,GAAG;KACX,CAAC;CACkD,CAAC,CAAC;AAExD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAc,EAAoB,EAAE;IACtE,MAAM,GAAG,GACP,OAAO,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,qBAAqB,EAAE,IAAI,CAAC;QAC3F,CAAC,CAAE,IAAyB;QAC5B,CAAC,CAAC,qBAAqB,CAAC;IAE5B,OAAO,EAAE,GAAG,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC;AAC3C,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speakai/shared",
-  "version": "2.1.27",
+  "version": "2.1.28",
   "description": "Shared types, enums and interfaces for Speak AI platform",
   "type": "module",
   "main": "dist/index.js",