@fonoster/common 0.30.0 → 0.31.0

package/dist/registry/prisma.js

@@ -71,7 +71,12 @@ class PrismaRegistryStore extends stores_1.MemoryRegistryStore {
                     id: p.id,
                     adapter: p.adapter,
                     capabilities: p.capabilities,
-                    credentialRef: p.credentialRef,
+                    credentialRef: opt(p.credentialRef),
+                    label: opt(p.label),
+                    // Stored as {} when the provider names none.
+                    endpoints: p.endpoints && Object.keys(p.endpoints).length
+                        ? p.endpoints
+                        : undefined,
                     state: fromState(p.state),
                     replacement: opt(p.replacement),
                     retireOn: opt(p.retireOn)
@@ -80,6 +85,7 @@ class PrismaRegistryStore extends stores_1.MemoryRegistryStore {
                 entries.set(m.id, clean({
                     kind: "model",
                     id: m.id,
+                    label: opt(m.label),
                     type: m.type,
                     features: m.features,
                     languages: m.languages,
@@ -92,6 +98,7 @@ class PrismaRegistryStore extends stores_1.MemoryRegistryStore {
                 entries.set(v.id, clean({
                     kind: "voice",
                     id: v.id,
+                    label: opt(v.label),
                     models: v.models.map((r) => r.modelId),
                     language: opt(v.language),
                     gender: opt(v.gender),
@@ -111,19 +118,20 @@ class PrismaRegistryStore extends stores_1.MemoryRegistryStore {
         });
     }
     put(entry) {
-        var _a, _b;
+        var _a, _b, _c;
         super.put(entry);
         const e = JSON.parse(JSON.stringify(entry));
         const common = {
+            label: (_a = e.label) !== null && _a !== void 0 ? _a : null,
             state: toState(e.state),
-            replacement: (_a = e.replacement) !== null && _a !== void 0 ? _a : null,
-            retireOn: (_b = e.retireOn) !== null && _b !== void 0 ? _b : null
+            replacement: (_b = e.replacement) !== null && _b !== void 0 ? _b : null,
+            retireOn: (_c = e.retireOn) !== null && _c !== void 0 ? _c : null
         };
         const provider = e.id.split("/")[0];
         this.writes.push(() => __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c;
+            var _a, _b, _c, _d, _e;
             if (e.kind === "provider") {
-                const data = Object.assign({ adapter: e.adapter, capabilities: e.capabilities, credentialRef: e.credentialRef }, common);
+                const data = Object.assign({ adapter: e.adapter, capabilities: e.capabilities, credentialRef: (_a = e.credentialRef) !== null && _a !== void 0 ? _a : null, endpoints: (_b = e.endpoints) !== null && _b !== void 0 ? _b : {} }, common);
                 yield this.prisma.registryProvider.upsert({
                     where: { id: e.id },
                     create: Object.assign({ id: e.id }, data),
@@ -139,7 +147,7 @@ class PrismaRegistryStore extends stores_1.MemoryRegistryStore {
                 });
             }
             else {
-                const data = Object.assign({ providerId: provider, language: (_a = e.language) !== null && _a !== void 0 ? _a : null, gender: (_b = e.gender) !== null && _b !== void 0 ? _b : null, ownerWorkspace: (_c = e.ownerWorkspace) !== null && _c !== void 0 ? _c : null }, common);
+                const data = Object.assign({ providerId: provider, language: (_c = e.language) !== null && _c !== void 0 ? _c : null, gender: (_d = e.gender) !== null && _d !== void 0 ? _d : null, ownerWorkspace: (_e = e.ownerWorkspace) !== null && _e !== void 0 ? _e : null }, common);
                 yield this.prisma.$transaction([
                     this.prisma.registryVoice.upsert({
                         where: { id: e.id },
@@ -182,8 +190,8 @@ class PrismaRegistryStore extends stores_1.MemoryRegistryStore {
 }
 exports.PrismaRegistryStore = PrismaRegistryStore;
 /**
- * Usages of catalog ids in apps (speech defaults: voice, TTS and STT models) and assistants (the
- * Autopilot assistant in an app's Intelligence config: `languageModel.model`, and
+ * Usages of catalog ids in apps (speech defaults: voice, TTS and STT models) and agents (the
+ * Autopilot agent in an app's Intelligence config: `languageModel.model`, and
  * `conversationSettings.voice`). Legacy rows with raw vendor names are not usages until migrated
  * to catalog ids (task 5.1).
  */
@@ -250,10 +258,10 @@ class PrismaUsageSource {
                     requires: ["streaming"]
                 }, { kind: "app-stt", row });
             }
-            const assistant = (_d = row.intelligence) === null || _d === void 0 ? void 0 : _d.config;
-            const llm = (_e = assistant === null || assistant === void 0 ? void 0 : assistant.languageModel) === null || _e === void 0 ? void 0 : _e.model;
+            const agent = (_d = row.intelligence) === null || _d === void 0 ? void 0 : _d.config;
+            const llm = (_e = agent === null || agent === void 0 ? void 0 : agent.languageModel) === null || _e === void 0 ? void 0 : _e.model;
             const config = {
-                kind: "assistant",
+                kind: "agent",
                 ref: row.ref,
                 name: row.name
             };
@@ -263,12 +271,12 @@ class PrismaUsageSource {
                     config,
                     model: llm,
                     settings: [],
-                    requires: ((_g = (_f = assistant === null || assistant === void 0 ? void 0 : assistant.languageModel) === null || _f === void 0 ? void 0 : _f.tools) === null || _g === void 0 ? void 0 : _g.length)
+                    requires: ((_g = (_f = agent === null || agent === void 0 ? void 0 : agent.languageModel) === null || _f === void 0 ? void 0 : _f.tools) === null || _g === void 0 ? void 0 : _g.length)
                         ? ["streaming", "tool-calling"]
                         : ["streaming"]
-                }, { kind: "assistant-llm", row, model: llm });
+                }, { kind: "agent-llm", row, model: llm });
             }
-            const voice = (_h = assistant === null || assistant === void 0 ? void 0 : assistant.conversationSettings) === null || _h === void 0 ? void 0 : _h.voice;
+            const voice = (_h = agent === null || agent === void 0 ? void 0 : agent.conversationSettings) === null || _h === void 0 ? void 0 : _h.voice;
             if (voice === id) {
                 add({
                     workspace: row.accessKeyId,
@@ -277,7 +285,7 @@ class PrismaUsageSource {
                     voice,
                     settings: [],
                     requires: ["streaming"]
-                }, { kind: "assistant-voice", row, voice });
+                }, { kind: "agent-voice", row, voice });
             }
         }
         return out;
@@ -325,7 +333,7 @@ class PrismaUsageSource {
         const config = JSON.parse(JSON.stringify((_b = (_a = row.intelligence) === null || _a === void 0 ? void 0 : _a.config) !== null && _b !== void 0 ? _b : {}));
         let path;
         let expected;
-        if (origin.kind === "assistant-llm") {
+        if (origin.kind === "agent-llm") {
             path = ["languageModel", "model"];
             expected = origin.model;
             if (change.model)
@@ -343,7 +351,7 @@ class PrismaUsageSource {
                 data: { config }
             });
             if (count === 0)
-                conflict("assistant changed since it was read");
+                conflict("agent changed since it was read");
             else
                 yield this.prisma.application.update({
                     where: { ref: row.ref },

package/dist/registry/types.d.ts

@@ -17,14 +17,22 @@
  * limitations under the License.
  */
 export type Lifecycle = "active" | "deprecated" | "retired";
-export type Capability = "stt" | "tts" | "llm";
+/** What a provider or model serves: speech, language models, or noise cancelling (`nc`). */
+export type Capability = "stt" | "tts" | "llm" | "nc";
+export declare const CAPABILITIES: Capability[];
 export type ItemKind = "provider" | "model" | "voice";
+/** Where a provider serves each capability; services use these unless their config overrides. */
+export type ProviderEndpoints = Partial<Record<Capability, string>>;
 export type ProviderEntry = {
     kind: "provider";
     id: string;
+    /** A display name ("Deepgram"); the dashboard shows the id without one. */
+    label?: string;
     adapter: string;
     capabilities: Capability[];
-    credentialRef: string;
+    /** The platform credential's name; omitted for a keyless provider (no key needed). */
+    credentialRef?: string;
+    endpoints?: ProviderEndpoints;
     state: Lifecycle;
     replacement?: string;
     retireOn?: string;
@@ -32,6 +40,8 @@ export type ProviderEntry = {
 export type ModelEntry = {
     kind: "model";
     id: string;
+    /** A display name ("Nova 3"); the dashboard shows the id without one. */
+    label?: string;
     type: Capability;
     features: string[];
     languages: string[];
@@ -44,6 +54,8 @@ export type ModelEntry = {
 export type VoiceEntry = {
     kind: "voice";
     id: string;
+    /** A display name ("Aura 2 Thalia"); the dashboard shows the id without one. */
+    label?: string;
     models: string[];
     language?: string;
     gender?: string;
@@ -61,11 +73,11 @@ export type AuditEntry = {
     target: string;
     details?: Record<string, unknown>;
 };
-/** One place a catalog id is used: an app's speech config or an assistant's model config. */
+/** One place a catalog id is used: an app's speech config or an agent's model config. */
 export type Usage = {
     workspace: string;
     config: {
-        kind: "app" | "assistant";
+        kind: "app" | "agent";
         ref: string;
         name: string;
     };
@@ -76,7 +88,7 @@ export type Usage = {
     /** Hard features the config needs (derived from its content, e.g. tools need tool-calling). */
     requires: string[];
 };
-/** Where usages come from (apps and assistants in the control-plane database). */
+/** Where usages come from (apps and agents in the control-plane database). */
 export interface UsageSource {
     find(id: string): Usage[];
     /** Rewrites one config; returns false if it changed since it was read. */

package/dist/registry/types.js

@@ -20,3 +20,5 @@
 // The provider registry (add-provider-registry): providers, models and voices by catalog id,
 // with a manual lifecycle. The catalog never holds a secret: providers name a credentialRef.
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CAPABILITIES = void 0;
+exports.CAPABILITIES = ["stt", "tts", "llm", "nc"];

package/dist/roomr/health.d.ts

@@ -0,0 +1,9 @@
+/** How long one health check may take. */
+export declare const HEALTH_CHECK_TIMEOUT_MS = 2000;
+/**
+ * Whether `address` (host:port) answers the standard gRPC health check (grpc.health.v1) with
+ * SERVING for the server as a whole. False on any error, a timeout or any other status (a Roomr
+ * node or AppBridge replica draining after SIGTERM reports NOT_SERVING). Through a Kubernetes
+ * Service or a Compose service name the check reaches one ready replica.
+ */
+export declare function checkGrpcHealth(address: string, timeoutMs?: number): Promise<boolean>;

package/dist/roomr/health.js

@@ -0,0 +1,75 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HEALTH_CHECK_TIMEOUT_MS = void 0;
+exports.checkGrpcHealth = checkGrpcHealth;
+/**
+ * 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.
+ */
+const grpc = __importStar(require("@grpc/grpc-js"));
+const grpc_health_check_1 = require("grpc-health-check");
+/** How long one health check may take. */
+exports.HEALTH_CHECK_TIMEOUT_MS = 2000;
+/**
+ * Whether `address` (host:port) answers the standard gRPC health check (grpc.health.v1) with
+ * SERVING for the server as a whole. False on any error, a timeout or any other status (a Roomr
+ * node or AppBridge replica draining after SIGTERM reports NOT_SERVING). Through a Kubernetes
+ * Service or a Compose service name the check reaches one ready replica.
+ */
+function checkGrpcHealth(address, timeoutMs = exports.HEALTH_CHECK_TIMEOUT_MS) {
+    const Health = grpc.makeGenericClientConstructor(grpc_health_check_1.service, "Health");
+    const client = new Health(address, grpc.credentials.createInsecure());
+    return new Promise((resolve) => {
+        client.Check({ service: "" }, { deadline: Date.now() + timeoutMs }, (error, res) => {
+            client.close();
+            resolve(!error && ((res === null || res === void 0 ? void 0 : res.status) === "SERVING" || (res === null || res === void 0 ? void 0 : res.status) === 1));
+        });
+    });
+}

package/dist/roomr/index.d.ts

@@ -0,0 +1,75 @@
+import * as grpc from "@grpc/grpc-js";
+/** The proto file this package loads. */
+export declare const ROOMR_PROTO: string;
+export type SipAuth = {
+    username: string;
+    password: string;
+};
+export type SipTarget = {
+    uri: string;
+    proxy?: string;
+    headers?: Record<string, string>;
+    auth?: SipAuth;
+};
+export type CreateCallRequest = {
+    callRef?: string;
+    to: SipTarget;
+    from?: string;
+    roomRef?: string;
+    session?: string;
+    ringTimeoutS?: number;
+    /** Passed through untouched in the events for this call (e.g. { app_ref }). */
+    metadata?: Record<string, string>;
+    maxDurationS?: number;
+};
+export type Call = {
+    callRef: string;
+    roomRef: string;
+    state: "RINGING" | "ANSWERED" | "ENDED";
+    participantRef: string;
+};
+export type CreateRoomRequest = {
+    roomRef?: string;
+    maxDurationS?: number;
+    /** Overrides the node's emptyRoomTimeout for this room (0: the node's). */
+    emptyTimeoutS?: number;
+    /** Overrides the node's maxParticipants for this room (0: the node's). */
+    maxParticipants?: number;
+};
+export type Room = {
+    roomRef: string;
+};
+/** The RPCs the control plane uses, each against one node's control address. */
+export type RoomrCalls = {
+    createCall(addr: string, request: CreateCallRequest): Promise<Call>;
+    createRoom(addr: string, request: CreateRoomRequest): Promise<Room>;
+    endCall(addr: string, request: {
+        callRef: string;
+    }): Promise<void>;
+    endRoom(addr: string, request: {
+        roomRef: string;
+    }): Promise<void>;
+};
+/** A failed RPC, with its gRPC status code. */
+export declare class RoomrError extends Error {
+    readonly code: grpc.status;
+    constructor(code: grpc.status, message: string);
+}
+/** The roomr.v1 package (protoLoader options as for the other Fonoster services). */
+export declare function roomrPackage(): grpc.GrpcObject;
+/** The Roomr service definition (fakes serve it). */
+export declare function roomrService(): grpc.ServiceDefinition;
+/** Each call's deadline (ms). */
+export declare const ROOMR_DEADLINE_MS = 2000;
+/**
+ * One gRPC channel per node address, reused by every call to it, with HTTP/2 keepalive and a
+ * deadline per call. Plaintext: the control port is reachable only inside the deployment's
+ * network. `close()` closes every channel.
+ */
+export declare function createRoomrPool(options?: {
+    deadlineMs?: number;
+}): RoomrCalls & {
+    close(): void;
+};
+export * from "./health";
+export * from "./session";

package/dist/roomr/index.js

@@ -0,0 +1,146 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROOMR_DEADLINE_MS = exports.RoomrError = exports.ROOMR_PROTO = void 0;
+exports.roomrPackage = roomrPackage;
+exports.roomrService = roomrService;
+exports.createRoomrPool = createRoomrPool;
+/**
+ * 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.
+ */
+const path = __importStar(require("path"));
+const grpc = __importStar(require("@grpc/grpc-js"));
+const protoLoader = __importStar(require("@grpc/proto-loader"));
+// The controller's side of Roomr (roomr.v1.Roomr, redesign-roomr "Roomr is a gRPC service
+// with three nouns"). The proto is fonoster/roomr's api/roomr/v1/roomr.proto; src/protos/roomr.proto
+// is the copy of the pinned release (npm run sync:roomr; the client test checks it).
+/** The proto file this package loads. */
+exports.ROOMR_PROTO = path.join(__dirname, "..", "protos", "roomr.proto");
+/** A failed RPC, with its gRPC status code. */
+class RoomrError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "RoomrError";
+    }
+}
+exports.RoomrError = RoomrError;
+let loaded;
+/** The roomr.v1 package (protoLoader options as for the other Fonoster services). */
+function roomrPackage() {
+    loaded !== null && loaded !== void 0 ? loaded : (loaded = grpc.loadPackageDefinition(protoLoader.loadSync(exports.ROOMR_PROTO, {
+        keepCase: false,
+        longs: String,
+        enums: String,
+        defaults: true,
+        oneofs: true
+    })));
+    return loaded.roomr.v1;
+}
+/** The Roomr service definition (fakes serve it). */
+function roomrService() {
+    return roomrPackage().Roomr.service;
+}
+/** Each call's deadline (ms). */
+exports.ROOMR_DEADLINE_MS = 2000;
+/**
+ * One gRPC channel per node address, reused by every call to it, with HTTP/2 keepalive and a
+ * deadline per call. Plaintext: the control port is reachable only inside the deployment's
+ * network. `close()` closes every channel.
+ */
+function createRoomrPool(options = {}) {
+    const Client = roomrPackage().Roomr;
+    const clients = new Map();
+    const client = (addr) => {
+        let c = clients.get(addr);
+        if (!c) {
+            c = new Client(addr, grpc.credentials.createInsecure(), {
+                "grpc.keepalive_time_ms": 10000,
+                "grpc.keepalive_timeout_ms": 5000,
+                "grpc.keepalive_permit_without_calls": 1
+            });
+            clients.set(addr, c);
+        }
+        return c;
+    };
+    const call = (method) => (addr, request) => new Promise((resolve, reject) => {
+        var _a;
+        const rpc = client(addr)[method].bind(client(addr));
+        rpc(request, { deadline: Date.now() + ((_a = options.deadlineMs) !== null && _a !== void 0 ? _a : exports.ROOMR_DEADLINE_MS) }, (err, res) => err ? reject(new RoomrError(err.code, err.details)) : resolve(res));
+    });
+    const empty = (method) => (addr, request) => __awaiter(this, void 0, void 0, function* () {
+        yield call(method)(addr, request);
+    });
+    return {
+        createCall: call("CreateCall"),
+        createRoom: call("CreateRoom"),
+        endCall: empty("EndCall"),
+        endRoom: empty("EndRoom"),
+        close() {
+            for (const c of clients.values())
+                c.close();
+            clients.clear();
+        }
+    };
+}
+__exportStar(require("./health"), exports);
+__exportStar(require("./session"), exports);

package/dist/roomr/session.d.ts

@@ -0,0 +1,133 @@
+import * as grpc from "@grpc/grpc-js";
+/** The proto file this module loads. */
+export declare const SESSION_PROTO: string;
+/** The port AppBridge serves Session.Connect (and grpc.health.v1) on by default. */
+export declare const SESSION_PORT = 50071;
+/** The gRPC service name, as the health service reports it. */
+export declare const SESSION_SERVICE_NAME = "session.v1.Session";
+/** An RTP endpoint: `codec` is "L16/16000" on app legs; `srtpKey` (SDES, base64) when encrypted. */
+export type MediaEndpoint = {
+    ip: string;
+    port: number;
+    codec?: string;
+    srtpKey?: string;
+};
+export type SessionSipTarget = {
+    uri: string;
+    proxy?: string;
+    headers?: Record<string, string>;
+    auth?: {
+        username: string;
+        password: string;
+    };
+};
+export type SessionStart = {
+    callRef: string;
+    direction: "INBOUND" | "OUTBOUND";
+    from: string;
+    to: string;
+    /** Every INVITE header (inbound) or CreateCall's to.headers (outbound). */
+    headers: Record<string, string>;
+    /** CreateCall's metadata, untouched (outbound calls carry `app_ref`). */
+    metadata: Record<string, string>;
+    roomRef: string;
+    /** The node's RTP endpoint for this call's app leg. */
+    media?: MediaEndpoint;
+    nodeRef: string;
+};
+export type SessionDtmf = {
+    digit: string;
+    source?: string;
+};
+export type SessionEvent = {
+    participantJoined?: {
+        participantRef: string;
+        trackId: number;
+    };
+    participantLeft?: {
+        participantRef: string;
+        cause: string;
+    };
+    transferResult?: {
+        status: string;
+        cause?: string;
+        sipStatus?: number;
+    };
+    ended?: {
+        cause: string;
+        sipStatus?: number;
+    };
+    /** The oneof member that is set (protoLoader `oneofs: true`). */
+    event?: "participantJoined" | "participantLeft" | "transferResult" | "ended";
+};
+/** A message from the node. */
+export type NodeMessage = {
+    start?: SessionStart;
+    dtmf?: SessionDtmf;
+    event?: SessionEvent;
+    msg?: "start" | "dtmf" | "event";
+};
+export type ListenTrack = {
+    trackId: number;
+    rtp: MediaEndpoint;
+};
+/** A message to the node (exactly one member set). */
+export type AppMessage = {
+    answer?: {
+        media: MediaEndpoint;
+        maxDurationS?: number;
+    };
+    ready?: {
+        media: MediaEndpoint;
+    };
+    reject?: {
+        sipStatus: number;
+        reason?: string;
+    };
+    transfer?: {
+        to: SessionSipTarget;
+        mode: "cold" | "warm" | "refer";
+        music?: string;
+        ringTimeoutS?: number;
+    };
+    transferComplete?: Record<string, never>;
+    /** Cuts the caller off from the app; the node loops `music` (a WAV URL) to the caller alone. */
+    hold?: {
+        music?: string;
+    };
+    resume?: Record<string, never>;
+    /** RFC 4733 events on the caller's leg, in order. */
+    sendDtmf?: {
+        digits: string;
+    };
+    addListener?: {
+        listenerRef: string;
+        listen: ListenTrack[];
+    };
+    removeListener?: {
+        listenerRef: string;
+    };
+    hangup?: {
+        sipStatus?: number;
+        reason?: string;
+    };
+    msg?: AppMessageType;
+};
+export type AppMessageType = "answer" | "ready" | "reject" | "transfer" | "transferComplete" | "hold" | "resume" | "sendDtmf" | "addListener" | "removeListener" | "hangup";
+/** The member a message carries (the oneof's name), for logs and fakes. */
+export declare function messageType<T extends Record<string, unknown>>(message: T, members: readonly string[]): string | undefined;
+export declare const APP_MESSAGE_TYPES: readonly AppMessageType[];
+export declare const NODE_MESSAGE_TYPES: readonly ["start", "dtmf", "event"];
+export declare const SESSION_EVENT_TYPES: readonly ["participantJoined", "participantLeft", "transferResult", "ended"];
+/** Ended causes the node sends (media-control "Endings carry a reason"). */
+export declare const ENDED_CAUSES: readonly ["caller_hangup", "callee_hangup", "busy", "no_answer", "rejected", "media_timeout", "node_error", "max_duration", "removed", "app_gone"];
+/** The session.v1 package (protoLoader options as for the other Fonoster services). */
+export declare function sessionPackage(): grpc.GrpcObject;
+/** The Session service definition (AppBridge serves it). */
+export declare function sessionService(): grpc.ServiceDefinition;
+/** The Session client constructor (the node's side; fakes use it). */
+export declare function sessionClient(): grpc.ServiceClientConstructor;
+/** The server side of one control stream. */
+export type SessionServerStream = grpc.ServerDuplexStream<NodeMessage, AppMessage>;
+/** The client side of one control stream. */
+export type SessionClientStream = grpc.ClientDuplexStream<NodeMessage, AppMessage>;