@fonoster/common 0.30.0 → 0.31.0

package/dist/{assistants → agents}/index.d.ts

@@ -17,5 +17,5 @@
  * limitations under the License.
  */
 export * from "./tools";
-export * from "./sessionAssistantSchema";
+export * from "./sessionAgentSchema";
 export * from "./testCasesSchema";

package/dist/{assistants → agents}/index.js

@@ -33,5 +33,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * limitations under the License.
  */
 __exportStar(require("./tools"), exports);
-__exportStar(require("./sessionAssistantSchema"), exports);
+__exportStar(require("./sessionAgentSchema"), exports);
 __exportStar(require("./testCasesSchema"), exports);

package/dist/{assistants/sessionAssistantSchema.d.ts → agents/sessionAgentSchema.d.ts}

@@ -214,12 +214,16 @@ export declare const sessionConversationSettingsSchema: z.ZodObject<{
     transferOptions: z.ZodOptional<z.ZodObject<{
         phoneNumber: z.ZodString;
         message: z.ZodString;
+        /** Said when the transfer fails, before the conversation goes on (default in Autopilot). */
+        failedMessage: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         message?: string;
         phoneNumber?: string;
+        failedMessage?: string;
     }, {
         message?: string;
         phoneNumber?: string;
+        failedMessage?: string;
     }>>;
     idleOptions: z.ZodOptional<z.ZodObject<{
         message: z.ZodString;
@@ -236,7 +240,7 @@ export declare const sessionConversationSettingsSchema: z.ZodObject<{
     }>>;
     allowUserBargeIn: z.ZodDefault<z.ZodBoolean>;
     /**
-     * The turn-taking patience knob (TT-B5): sent to the gateway with listen.update so its Pacing
+     * The turn-taking patience knob (TT-B5): sent to AppBridge with listen.update so its Pacing
      * policy waits less (low) or more (high) before turn.ended. Autopilot prepares a reply on
      * turn.likely_ended at low and normal, and only on turn.ended at high.
      */
@@ -266,6 +270,7 @@ export declare const sessionConversationSettingsSchema: z.ZodObject<{
     transferOptions?: {
         message?: string;
         phoneNumber?: string;
+        failedMessage?: string;
     };
     idleOptions?: {
         message?: string;
@@ -292,6 +297,7 @@ export declare const sessionConversationSettingsSchema: z.ZodObject<{
     transferOptions?: {
         message?: string;
         phoneNumber?: string;
+        failedMessage?: string;
     };
     idleOptions?: {
         message?: string;
@@ -309,7 +315,7 @@ export declare const sessionConversationSettingsSchema: z.ZodObject<{
     vad?: any;
     maxSpeechWaitTimeout?: any;
 }>;
-export declare const sessionAssistantSchema: z.ZodObject<{
+export declare const sessionAgentSchema: z.ZodObject<{
     conversationSettings: z.ZodObject<{
         firstMessage: z.ZodOptional<z.ZodString>;
         systemPrompt: z.ZodString;
@@ -320,12 +326,16 @@ export declare const sessionAssistantSchema: z.ZodObject<{
         transferOptions: z.ZodOptional<z.ZodObject<{
             phoneNumber: z.ZodString;
             message: z.ZodString;
+            /** Said when the transfer fails, before the conversation goes on (default in Autopilot). */
+            failedMessage: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             message?: string;
             phoneNumber?: string;
+            failedMessage?: string;
         }, {
             message?: string;
             phoneNumber?: string;
+            failedMessage?: string;
         }>>;
         idleOptions: z.ZodOptional<z.ZodObject<{
             message: z.ZodString;
@@ -342,7 +352,7 @@ export declare const sessionAssistantSchema: z.ZodObject<{
         }>>;
         allowUserBargeIn: z.ZodDefault<z.ZodBoolean>;
         /**
-         * The turn-taking patience knob (TT-B5): sent to the gateway with listen.update so its Pacing
+         * The turn-taking patience knob (TT-B5): sent to AppBridge with listen.update so its Pacing
          * policy waits less (low) or more (high) before turn.ended. Autopilot prepares a reply on
          * turn.likely_ended at low and normal, and only on turn.ended at high.
          */
@@ -372,6 +382,7 @@ export declare const sessionAssistantSchema: z.ZodObject<{
         transferOptions?: {
             message?: string;
             phoneNumber?: string;
+            failedMessage?: string;
         };
         idleOptions?: {
             message?: string;
@@ -398,6 +409,7 @@ export declare const sessionAssistantSchema: z.ZodObject<{
         transferOptions?: {
             message?: string;
             phoneNumber?: string;
+            failedMessage?: string;
         };
         idleOptions?: {
             message?: string;
@@ -617,6 +629,7 @@ export declare const sessionAssistantSchema: z.ZodObject<{
         transferOptions?: {
             message?: string;
             phoneNumber?: string;
+            failedMessage?: string;
         };
         idleOptions?: {
             message?: string;
@@ -681,6 +694,7 @@ export declare const sessionAssistantSchema: z.ZodObject<{
         transferOptions?: {
             message?: string;
             phoneNumber?: string;
+            failedMessage?: string;
         };
         idleOptions?: {
             message?: string;
@@ -735,7 +749,7 @@ export declare const sessionAssistantSchema: z.ZodObject<{
     eventsHook?: any;
     audioFilters?: any;
 }>;
-export type SessionAssistant = z.infer<typeof sessionAssistantSchema>;
-export type SessionConversationSettings = SessionAssistant["conversationSettings"];
-export type SessionLanguageModel = SessionAssistant["languageModel"];
+export type SessionAgent = z.infer<typeof sessionAgentSchema>;
+export type SessionConversationSettings = SessionAgent["conversationSettings"];
+export type SessionLanguageModel = SessionAgent["languageModel"];
 export type ToolDefinition = SessionLanguageModel["tools"][number];

package/dist/{assistants/sessionAssistantSchema.js → agents/sessionAgentSchema.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sessionAssistantSchema = exports.sessionConversationSettingsSchema = exports.sessionLanguageModelSchema = void 0;
+exports.sessionAgentSchema = exports.sessionConversationSettingsSchema = exports.sessionLanguageModelSchema = void 0;
 /**
  * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
  * http://github.com/fonoster/fonoster
@@ -21,10 +21,10 @@ exports.sessionAssistantSchema = exports.sessionConversationSettingsSchema = exp
  */
 const zod_1 = require("zod");
 const tools_1 = require("./tools");
-// The assistant config for the rebuilt Autopilot (rework-autopilot A8, A11, A12; tasks 5.1, 5.2,
-// 5.4). Strict: vendor credentials, vendor enums, VAD settings and the assistant webhook are
-// rejected with messages pointing to where they moved. It is the only assistant schema: the legacy
-// one was deleted after the cutover job converts stored assistants (rework-autopilot 8.2).
+// The agent config for the rebuilt Autopilot (rework-autopilot A8, A11, A12; tasks 5.1, 5.2,
+// 5.4). Strict: vendor credentials, vendor enums, VAD settings and the agent webhook are
+// rejected with messages pointing to where they moved. It is the only agent schema: the legacy
+// one was deleted after the cutover job converts stored agents (rework-autopilot 8.2).
 const removed = (key, message) => zod_1.z
     .any()
     .optional()
@@ -73,7 +73,12 @@ exports.sessionConversationSettingsSchema = zod_1.z
         .positive()
         .default(30 * 60 * 1000),
     transferOptions: zod_1.z
-        .object({ phoneNumber: zod_1.z.string(), message: zod_1.z.string() })
+        .object({
+        phoneNumber: zod_1.z.string(),
+        message: zod_1.z.string(),
+        /** Said when the transfer fails, before the conversation goes on (default in Autopilot). */
+        failedMessage: zod_1.z.string().optional()
+    })
         .optional(),
     idleOptions: zod_1.z
         .object({
@@ -84,7 +89,7 @@ exports.sessionConversationSettingsSchema = zod_1.z
         .optional(),
     allowUserBargeIn: zod_1.z.boolean().default(true),
     /**
-     * The turn-taking patience knob (TT-B5): sent to the gateway with listen.update so its Pacing
+     * The turn-taking patience knob (TT-B5): sent to AppBridge with listen.update so its Pacing
      * policy waits less (low) or more (high) before turn.ended. Autopilot prepares a reply on
      * turn.likely_ended at low and normal, and only on turn.ended at high.
      */
@@ -96,17 +101,17 @@ exports.sessionConversationSettingsSchema = zod_1.z
     /** Catalog ids overriding the app's speech defaults on every speak. */
     voice: zod_1.z.string().optional(),
     language: zod_1.z.string().optional(),
-    vad: removed("vad", "turn detection moved to the gateway (turn-taking configuration)"),
-    maxSpeechWaitTimeout: removed("maxSpeechWaitTimeout", "turn detection moved to the gateway")
+    vad: removed("vad", "turn detection moved to AppBridge (turn-taking configuration)"),
+    maxSpeechWaitTimeout: removed("maxSpeechWaitTimeout", "turn detection moved to AppBridge")
 })
     .strict();
-exports.sessionAssistantSchema = zod_1.z
+exports.sessionAgentSchema = zod_1.z
     .object({
     conversationSettings: exports.sessionConversationSettingsSchema,
     languageModel: exports.sessionLanguageModelSchema,
     /** Conversation eval cases, kept as they were (evaluated outside calls). */
     testCases: zod_1.z.any().optional(),
-    eventsHook: removed("eventsHook", "assistant webhooks were retired; use workspace webhooks (conversation.ended → call.ended or call_record.sealed)"),
+    eventsHook: removed("eventsHook", "agent webhooks were retired; use workspace webhooks (conversation.ended → call.ended or call_record.sealed)"),
     audioFilters: removed("audioFilters", "audio filters are part of the app's configuration")
 })
     .strict();

package/dist/cellsecrets/index.d.ts

@@ -52,7 +52,7 @@ export declare class DirectorySecretStore implements CellSecretStore {
 /** The store a config names (dir wins over file). */
 export declare function openCellSecrets(config: CellSecretsConfig, env?: Record<string, string | undefined>): CellSecretStore;
 /**
- * The cell's secrets as a workspace key source (gateway Catalog, Autopilot): a private region
+ * The cell's secrets as a workspace key source (appbridge Catalog, Autopilot): a private region
  * serves one workspace, so the provider name alone picks the key. Read errors count as unset.
  */
 export declare class CellSecretKeys {
@@ -84,7 +84,7 @@ export declare const CELL_WORKSPACE_KEYS_SUBJECT = "cell.workspacekeys.get";
 export declare class NatsWorkspaceKeys {
     private readonly requester;
     private readonly timeoutMs;
-    /** Never cached: the gateway keeps no adapter built with these keys past the call's lookup. */
+    /** Never cached: AppBridge keeps no adapter built with these keys past the call's lookup. */
     readonly cacheable = false;
     constructor(requester: () => Promise<KeyRequester>, timeoutMs?: number);
     get(workspaceRef: string, providerId: string): Promise<string | undefined>;

package/dist/cellsecrets/index.js

@@ -72,7 +72,7 @@ const path = __importStar(require("path"));
 //   - an encrypted file (Compose, bare metal): AES-256-GCM, key derived with scrypt from a
 //     passphrase in the environment (default FONOSTER_REGION_SECRETS_KEY);
 //   - a directory with one file per secret: a mounted Kubernetes Secret.
-// The gateway and the hosted Autopilot read it; `fonoster-region secrets` writes it. Values are
+// AppBridge and the hosted Autopilot read it; `fonoster-region secrets` writes it. Values are
 // never logged; `names()` is what the region agent reports in heartbeats.
 /** Secret names: provider ids and credential refs (`deepgram`, `groq`, `openai`, `s3.secret`). */
 exports.SECRET_NAME = /^[a-z0-9][a-z0-9._-]{0,63}$/;
@@ -224,7 +224,7 @@ function openCellSecrets(config, env = process.env) {
     return new EncryptedFileSecretStore(config.file, key);
 }
 /**
- * The cell's secrets as a workspace key source (gateway Catalog, Autopilot): a private region
+ * The cell's secrets as a workspace key source (appbridge Catalog, Autopilot): a private region
  * serves one workspace, so the provider name alone picks the key. Read errors count as unset.
  */
 class CellSecretKeys {
@@ -275,7 +275,7 @@ class NatsWorkspaceKeys {
     constructor(requester, timeoutMs = 2000) {
         this.requester = requester;
         this.timeoutMs = timeoutMs;
-        /** Never cached: the gateway keeps no adapter built with these keys past the call's lookup. */
+        /** Never cached: AppBridge keeps no adapter built with these keys past the call's lookup. */
         this.cacheable = false;
     }
     get(workspaceRef, providerId) {

package/dist/config/cli/render.d.ts

@@ -27,7 +27,7 @@ export declare const FONOSTER_SERVICE_FILES: string[];
 export declare function renderTemplate(text: string, env: Env, file?: string, substitute?: boolean): string;
 export declare function deepMerge(base: unknown, overlay: unknown): unknown;
 export declare const EXAMPLE: RegExp;
-/** The rendered name of an example (`gateway.example.yaml` → `gateway.yaml`). */
+/** The rendered name of an example (`appbridge.example.yaml` → `appbridge.yaml`). */
 export declare function renderedName(example: string): string | undefined;
 export declare function listExamples(configDir: string): string[];
 export type RenderOptions = {

package/dist/config/cli/render.js

@@ -40,9 +40,9 @@ exports.RenderError = RenderError;
 exports.FONOSTER_SERVICE_FILES = [
     "fonoster",
     "identity",
-    "gateway",
+    "appbridge",
     "autopilot",
-    "medianode"
+    "roomr"
 ];
 /**
  * Checks one template's placeholders and returns it with them kept (`substitute` false) or
@@ -82,7 +82,7 @@ function deepMerge(base, overlay) {
     return out;
 }
 exports.EXAMPLE = /^(.+)\.example\.([A-Za-z0-9]+)$/;
-/** The rendered name of an example (`gateway.example.yaml` → `gateway.yaml`). */
+/** The rendered name of an example (`appbridge.example.yaml` → `appbridge.yaml`). */
 function renderedName(example) {
     const m = exports.EXAMPLE.exec(example);
     return m ? `${m[1]}.${m[2]}` : undefined;

package/dist/config/configHints.d.ts

@@ -16,19 +16,6 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-type Env = Record<string, string | undefined>;
-/** Old key path → new key path, e.g. `{ encryptionKey: "encryption.key" }`. */
-type MovedKeys = Record<string, string>;
-/**
- * Lists the moved keys present in a raw config, as readable hints. The new
- * location may itself be valid, so this only reports what was found.
- */
-declare function findMovedKeys(raw: unknown, movedKeys: MovedKeys): string[];
-/**
- * Names of environment variables that look like the old env-based config for
- * this service. Values are never returned, so they can be logged safely.
- */
-declare function findLegacyEnv(prefixes: string[], env?: Env): string[];
 /** Edit distance between two strings (insertions, deletions, substitutions). */
 declare function levenshtein(a: string, b: string): number;
 /**
@@ -36,4 +23,4 @@ declare function levenshtein(a: string, b: string): number;
  * to be a typo: at most a third of the key's length (at least 1) edits away, ignoring case.
  */
 declare function suggestKey(unknown: string, known: string[]): string | undefined;
-export { findMovedKeys, findLegacyEnv, levenshtein, suggestKey, MovedKeys };
+export { levenshtein, suggestKey };

package/dist/config/configHints.js

@@ -1,39 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findMovedKeys = findMovedKeys;
-exports.findLegacyEnv = findLegacyEnv;
 exports.levenshtein = levenshtein;
 exports.suggestKey = suggestKey;
-function hasPath(input, path) {
-    let current = input;
-    for (const segment of path.split(".")) {
-        if (current === null ||
-            typeof current !== "object" ||
-            !(segment in current)) {
-            return false;
-        }
-        current = current[segment];
-    }
-    return true;
-}
-/**
- * Lists the moved keys present in a raw config, as readable hints. The new
- * location may itself be valid, so this only reports what was found.
- */
-function findMovedKeys(raw, movedKeys) {
-    return Object.entries(movedKeys)
-        .filter(([from]) => hasPath(raw, from))
-        .map(([from, to]) => `"${from}" moved to "${to}"`);
-}
 /**
- * Names of environment variables that look like the old env-based config for
- * this service. Values are never returned, so they can be logged safely.
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
  */
-function findLegacyEnv(prefixes, env = process.env) {
-    return Object.keys(env)
-        .filter((name) => prefixes.some((prefix) => name.startsWith(prefix)))
-        .sort();
-}
 /** Edit distance between two strings (insertions, deletions, substitutions). */
 function levenshtein(a, b) {
     let prev = Array.from({ length: b.length + 1 }, (_, j) => j);

package/dist/config/index.d.ts

@@ -17,7 +17,6 @@
  * limitations under the License.
  */
 export * from "./configHints";
-export * from "./integrationsSchema";
 export * from "./interpolateEnv";
 export * from "./loadServiceConfig";
 export * from "./logsSchema";

package/dist/config/index.js

@@ -33,7 +33,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * limitations under the License.
  */
 __exportStar(require("./configHints"), exports);
-__exportStar(require("./integrationsSchema"), exports);
 __exportStar(require("./interpolateEnv"), exports);
 __exportStar(require("./loadServiceConfig"), exports);
 __exportStar(require("./logsSchema"), exports);

package/dist/config/interpolateEnv.d.ts

@@ -19,7 +19,7 @@
 type Env = Record<string, string | undefined>;
 type InterpolateOptions = {
     /**
-     * Key paths where `${VAR}` may appear, e.g. `database.url` or `influxdb.*`
+     * Key paths where `${VAR}` may appear, e.g. `database.url` or `nats.*`
      * (`*` matches the key and everything below it; `*` alone matches every key). When given,
      * `${...}` at any other path is an error. When omitted, every string is interpolated.
      */

package/dist/config/loadServiceConfig.d.ts

@@ -1,5 +1,4 @@
 import { z, ZodTypeAny } from "zod";
-import { MovedKeys } from "./configHints";
 type Env = Record<string, string | undefined>;
 type LoadServiceConfigOptions<S extends ZodTypeAny> = {
     /** Service name, used in messages. */
@@ -20,10 +19,6 @@ type LoadServiceConfigOptions<S extends ZodTypeAny> = {
      * else is an error.
      */
     interpolatePaths?: string[];
-    /** Old key path → new key path, reported as hints. */
-    movedKeys?: MovedKeys;
-    /** Env var prefixes of the old env-based config, reported as a warning. */
-    legacyEnvPrefixes?: string[];
 };
 /**
  * Loads, interpolates and strictly validates a service's config file.

package/dist/config/loadServiceConfig.js

@@ -21,7 +21,6 @@ exports.loadServiceConfig = loadServiceConfig;
  */
 const fs_1 = require("fs");
 const logger_1 = require("@fonoster/logger");
-const configHints_1 = require("./configHints");
 const interpolateEnv_1 = require("./interpolateEnv");
 const parseConfigFile_1 = require("./parseConfigFile");
 const resolveConfigFile_1 = require("./resolveConfigFile");
@@ -56,17 +55,13 @@ function formatIssues(error) {
  * Throws with the file path and the offending key path on any problem.
  */
 function loadServiceConfig(options) {
-    var _a, _b, _c, _d, _e, _f, _g;
+    var _a, _b, _c, _d, _e;
     const { service, schema } = options;
     const fileBase = (_a = options.fileBase) !== null && _a !== void 0 ? _a : service;
     const argv = (_b = options.argv) !== null && _b !== void 0 ? _b : process.argv;
     const env = (_c = options.env) !== null && _c !== void 0 ? _c : process.env;
-    const legacy = (0, configHints_1.findLegacyEnv)((_d = options.legacyEnvPrefixes) !== null && _d !== void 0 ? _d : [], env);
-    if (legacy.length > 0) {
-        logger.warn(`ignoring ${legacy.length} legacy environment variable(s); ${service} now reads its config file only: ${legacy.join(", ")}`);
-    }
     const resolved = (0, resolveConfigFile_1.resolveConfigFile)(fileBase, argv, options.searchDirs);
-    const where = (_e = resolved.path) !== null && _e !== void 0 ? _e : "(built-in defaults)";
+    const where = (_d = resolved.path) !== null && _d !== void 0 ? _d : "(built-in defaults)";
     let raw = {};
     if ("searched" in resolved) {
         logger.warn(`no ${service} config file found (looked for ${resolved.searched.join(", ")}); using built-in defaults`);
@@ -88,14 +83,10 @@ function loadServiceConfig(options) {
         delete rest.$schema;
         raw = rest;
     }
-    const moved = (0, configHints_1.findMovedKeys)(raw, (_f = options.movedKeys) !== null && _f !== void 0 ? _f : {});
-    if (moved.length > 0) {
-        throw new Error(`invalid ${service} config at ${where}: ${moved.join("; ")}`);
-    }
     let interpolated;
     try {
         interpolated = (0, interpolateEnv_1.interpolateEnv)(raw, env, {
-            allowedPaths: (_g = options.interpolatePaths) !== null && _g !== void 0 ? _g : []
+            allowedPaths: (_e = options.interpolatePaths) !== null && _e !== void 0 ? _e : []
         });
     }
     catch (e) {

package/dist/constants.d.ts

@@ -19,10 +19,8 @@
 import { ServingStatus } from "grpc-health-check";
 export declare const GRPC_NOT_SERVING_STATUS: ServingStatus;
 export declare const GRPC_SERVING_STATUS: ServingStatus;
-export declare const CALL_DETAIL_RECORD_MEASUREMENT = "cdr";
-export declare const INFLUXDB_CALLS_BUCKET = "calls";
 export declare const APP_REF_HEADER = "x-app-ref";
-export declare const ROUTR_DEFAULT_PEER_AOR = "sip:medianode@default";
+export declare const ROUTR_DEFAULT_PEER_AOR = "sip:roomr@default";
 export declare const AUTOPILOT_SPECIAL_LOCAL_ADDRESS = "autopilot.fonoster.local";
 export declare const AUTOPILOT_INTERNAL_ADDRESS = "autopilot:50061";
 export declare const WELCOME_DEMO_SPECIAL_LOCAL_ADDRESS = "welcome.demo.fonoster.local";

package/dist/constants.js

@@ -1,14 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WELCOME_DEMO_SPECIAL_LOCAL_ADDRESS = exports.AUTOPILOT_INTERNAL_ADDRESS = exports.AUTOPILOT_SPECIAL_LOCAL_ADDRESS = exports.ROUTR_DEFAULT_PEER_AOR = exports.APP_REF_HEADER = exports.INFLUXDB_CALLS_BUCKET = exports.CALL_DETAIL_RECORD_MEASUREMENT = exports.GRPC_SERVING_STATUS = exports.GRPC_NOT_SERVING_STATUS = void 0;
+exports.WELCOME_DEMO_SPECIAL_LOCAL_ADDRESS = exports.AUTOPILOT_INTERNAL_ADDRESS = exports.AUTOPILOT_SPECIAL_LOCAL_ADDRESS = exports.ROUTR_DEFAULT_PEER_AOR = exports.APP_REF_HEADER = exports.GRPC_SERVING_STATUS = exports.GRPC_NOT_SERVING_STATUS = void 0;
 exports.GRPC_NOT_SERVING_STATUS = "NOT_SERVING";
 exports.GRPC_SERVING_STATUS = "SERVING";
-exports.CALL_DETAIL_RECORD_MEASUREMENT = "cdr";
-exports.INFLUXDB_CALLS_BUCKET = "calls";
 exports.APP_REF_HEADER = "x-app-ref";
-// The peer app-linked numbers point at: the Go media nodes (least-sessions). Asterisk's
+// The peer app-linked numbers point at: the Go Roomr nodes (least-sessions). Asterisk's
 // sip:voice@default is gone (cleanbreak CB-B3).
-exports.ROUTR_DEFAULT_PEER_AOR = "sip:medianode@default";
+exports.ROUTR_DEFAULT_PEER_AOR = "sip:roomr@default";
 exports.AUTOPILOT_SPECIAL_LOCAL_ADDRESS = "autopilot.fonoster.local";
 exports.AUTOPILOT_INTERNAL_ADDRESS = "autopilot:50061";
 exports.WELCOME_DEMO_SPECIAL_LOCAL_ADDRESS = "welcome.demo.fonoster.local";

package/dist/errors/handleZodError.js

@@ -25,7 +25,9 @@ const zod_validation_error_1 = require("zod-validation-error");
 const logger = (0, logger_1.getLogger)({ service: "apiserver", filePath: __filename });
 function handleZodError(error, callback) {
     if ((error === null || error === void 0 ? void 0 : error.issues[0].code) === "custom") {
-        const message = error === null || error === void 0 ? void 0 : error.issues[0].message;
+        // Named like the other validation errors, so the caller knows which field is at fault.
+        const { message: text, path } = error.issues[0];
+        const message = path.length ? `${text} at "${path.join(".")}"` : text;
         logger.error("custom validation error", { message });
         callback({ code: grpc_js_1.status.INVALID_ARGUMENT, message });
     }

package/dist/filters/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { z } from "zod";
+/**
+ * The audio filters an app may configure (voice-session, "An app's audio filters are set through
+ * the Applications API"). Apps are untrusted input, so each filter exposes a public option schema
+ * here, shared by the apiserver (validation on write) and the appbridge (the filter factory).
+ * Anything that touches the media server's filesystem, environment or credentials stays out.
+ */
+export declare const AI_COUSTICS_FILTER = "aiCoustics";
+/** The ai-coustics filter's public options. */
+export declare const aiCousticsPublicOptionsSchema: z.ZodObject<{
+    model: z.ZodDefault<z.ZodString>;
+    enhancementLevel: z.ZodDefault<z.ZodNumber>;
+    bypass: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    model?: string;
+    enhancementLevel?: number;
+    bypass?: boolean;
+}, {
+    model?: string;
+    enhancementLevel?: number;
+    bypass?: boolean;
+}>;
+/** Public option schemas by filter name. */
+export declare const FILTER_SCHEMAS: Record<string, z.ZodObject<z.ZodRawShape>>;
+/** The filter a noise-cancelling (`nc`) provider runs, by provider id. */
+export declare const FILTER_BY_PROVIDER: Record<string, string>;
+export declare const FILTER_NAMES: string[];
+/** The `nc` provider whose credential a filter runs with, or undefined for a filter without one. */
+export declare function providerOfFilter(name: string): string | undefined;
+export type AudioFilterConfig = {
+    name: string;
+    options?: Record<string, unknown>;
+};
+export declare const audioFilterConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    options?: Record<string, unknown>;
+    name?: string;
+}, {
+    options?: Record<string, unknown>;
+    name?: string;
+}>;
+export declare class AudioFilterConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validates an app's `filters` list: known names and public options only. Returns the list with
+ * each filter's options as given (defaults are applied by the filter itself). Throws
+ * AudioFilterConfigError naming the first offending filter or option.
+ */
+export declare function parseFilters(input: unknown): AudioFilterConfig[];