@fonoster/common 0.30.0 → 0.31.0

package/dist/roomr/session.js

@@ -0,0 +1,132 @@
+"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.ENDED_CAUSES = exports.SESSION_EVENT_TYPES = exports.NODE_MESSAGE_TYPES = exports.APP_MESSAGE_TYPES = exports.SESSION_SERVICE_NAME = exports.SESSION_PORT = exports.SESSION_PROTO = void 0;
+exports.messageType = messageType;
+exports.sessionPackage = sessionPackage;
+exports.sessionService = sessionService;
+exports.sessionClient = sessionClient;
+/**
+ * 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 per-call control stream (session.v1.Session, redesign-roomr media-control "Each call opens
+// one control stream to the session endpoint"). The Roomr node is the client: it opens one
+// connection per call and sends Start first; the session endpoint (AppBridge) answers with
+// Answer, Ready or Reject and sends the app's commands. Audio never travels here. The proto is
+// fonoster/roomr's api/session/v1/session.proto; src/protos/session.proto is the copy of the
+// pinned release (npm run sync:roomr; the client test checks it).
+/** The proto file this module loads. */
+exports.SESSION_PROTO = path.join(__dirname, "..", "protos", "session.proto");
+/** The port AppBridge serves Session.Connect (and grpc.health.v1) on by default. */
+exports.SESSION_PORT = 50071;
+/** The gRPC service name, as the health service reports it. */
+exports.SESSION_SERVICE_NAME = "session.v1.Session";
+/** The member a message carries (the oneof's name), for logs and fakes. */
+function messageType(message, members) {
+    if (typeof message.msg === "string")
+        return message.msg;
+    return members.find((m) => message[m] !== undefined && message[m] !== null);
+}
+exports.APP_MESSAGE_TYPES = [
+    "answer",
+    "ready",
+    "reject",
+    "transfer",
+    "transferComplete",
+    "hold",
+    "resume",
+    "sendDtmf",
+    "addListener",
+    "removeListener",
+    "hangup"
+];
+exports.NODE_MESSAGE_TYPES = ["start", "dtmf", "event"];
+exports.SESSION_EVENT_TYPES = [
+    "participantJoined",
+    "participantLeft",
+    "transferResult",
+    "ended"
+];
+/** Ended causes the node sends (media-control "Endings carry a reason"). */
+exports.ENDED_CAUSES = [
+    "caller_hangup",
+    "callee_hangup",
+    "busy",
+    "no_answer",
+    "rejected",
+    "media_timeout",
+    "node_error",
+    "max_duration",
+    "removed",
+    "app_gone"
+];
+let loaded;
+/** The session.v1 package (protoLoader options as for the other Fonoster services). */
+function sessionPackage() {
+    loaded !== null && loaded !== void 0 ? loaded : (loaded = grpc.loadPackageDefinition(protoLoader.loadSync(exports.SESSION_PROTO, {
+        keepCase: false,
+        longs: Number,
+        enums: String,
+        defaults: true,
+        oneofs: true
+    })));
+    return loaded.session.v1;
+}
+/** The Session service definition (AppBridge serves it). */
+function sessionService() {
+    return sessionPackage().Session.service;
+}
+/** The Session client constructor (the node's side; fakes use it). */
+function sessionClient() {
+    return sessionPackage().Session;
+}

package/dist/session/schema.d.ts

@@ -56,6 +56,9 @@ export declare const sessionStartSchema: {
                 readonly type: "object";
             }];
         };
+        readonly traceparent: {
+            readonly type: "string";
+        };
         readonly audio: {
             readonly type: "object";
             readonly required: readonly ["codec", "rate"];
@@ -118,7 +121,7 @@ export declare const sessionEndSchema: {
         };
     };
 };
-export declare const ERROR_CODES: readonly ["bad_message", "unknown_command", "read_only", "not_supported_by_protocol", "provider_unavailable", "provider_timeout", "invalid_catalog_id", "feature_not_supported", "transfer_failed", "on_hold", "queue_full", "play_fetch_failed", "internal"];
+export declare const ERROR_CODES: readonly ["bad_message", "unknown_command", "read_only", "not_supported_by_protocol", "provider_unavailable", "provider_timeout", "invalid_catalog_id", "feature_not_supported", "transfer_failed", "transfer_not_answered", "on_hold", "queue_full", "play_fetch_failed", "key_unavailable", "internal"];
 export declare const errorSchema: {
     readonly type: "object";
     readonly required: readonly ["type", "code", "message", "fatal"];
@@ -328,7 +331,22 @@ export declare const dtmfEventSchema: {
         };
     };
 };
-/** Answering-machine detection, once per call, for apps with `amd` (add-media-node 4.3). */
+/** A warm transfer's new party answered; the app may now send transfer.complete. */
+export declare const transferAnsweredSchema: {
+    readonly type: "object";
+    readonly required: readonly ["type", "relatesTo"];
+    readonly properties: {
+        readonly type: {
+            readonly const: "transfer.answered";
+        };
+        readonly relatesTo: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+        };
+    };
+};
+/** Answering-machine detection, once per call, for apps with `amd` (add-roomr 4.3). */
 export declare const amdResultSchema: {
     readonly type: "object";
     readonly required: readonly ["type", "status", "confidence", "detector", "audioMs"];
@@ -630,6 +648,54 @@ export declare const handoffSchema: {
         };
     };
 };
+/**
+ * Model token usage from Fonoster's own Autopilot (add-usage-metering D4). Reserved like
+ * record.note: accepted only from Autopilot agents and left out of the public docs.
+ */
+export declare const usageReportSchema: {
+    readonly type: "object";
+    readonly required: readonly ["type", "lines"];
+    readonly properties: {
+        readonly type: {
+            readonly const: "usage.report";
+        };
+        readonly id: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+        };
+        readonly lines: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly maxItems: 64;
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["meter", "quantity", "provider", "keySource"];
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly meter: {
+                        readonly enum: readonly ["llm.tokens.in", "llm.tokens.out", "llm.tokens.cached", "embedding.tokens"];
+                    };
+                    readonly quantity: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                    };
+                    readonly provider: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly model: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly keySource: {
+                        readonly enum: readonly ["platform", "workspace"];
+                    };
+                };
+            };
+        };
+    };
+};
 export declare const recordNoteSchema: {
     readonly type: "object";
     readonly required: readonly ["type", "data"];
@@ -665,6 +731,7 @@ export type OutputInterrupted = FromSchema<typeof outputInterruptedSchema>;
 export type MarkEvent = FromSchema<typeof markEventSchema>;
 export type DtmfEvent = FromSchema<typeof dtmfEventSchema>;
 export type AmdResult = FromSchema<typeof amdResultSchema>;
+export type TransferAnswered = FromSchema<typeof transferAnsweredSchema>;
 export type Speak = FromSchema<typeof speakSchema>;
 export type Play = FromSchema<typeof playSchema>;
 export type ListenUpdate = FromSchema<typeof listenUpdateSchema>;
@@ -680,10 +747,10 @@ export type Hold = FromSchema<typeof holdSchema>;
 export type Resume = FromSchema<typeof resumeSchema>;
 export type Handoff = FromSchema<typeof handoffSchema>;
 export type RecordNote = FromSchema<typeof recordNoteSchema>;
-export type GatewayMessage = SessionStart | SessionEnd | SessionError | TurnUserStarted | TurnLikelyEnded | TurnEnded | TurnResumed | TurnBackchannel | TurnEstimate | TranscriptPartial | OutputStarted | OutputDone | OutputInterrupted | MarkEvent | DtmfEvent | AmdResult;
+export type AppBridgeMessage = SessionStart | SessionEnd | SessionError | TurnUserStarted | TurnLikelyEnded | TurnEnded | TurnResumed | TurnBackchannel | TurnEstimate | TranscriptPartial | OutputStarted | OutputDone | OutputInterrupted | MarkEvent | DtmfEvent | TransferAnswered | AmdResult;
 export type AppCommand = Speak | Play | ListenUpdate | Subscribe | MarkCommand | Clear | Hangup | DtmfSend | Transfer | TransferComplete | Hold | Resume | Handoff | RecordNote;
 /** Schemas by message type, per direction. "mark" exists in both directions. */
-export declare const GATEWAY_MESSAGE_SCHEMAS: {
+export declare const APPBRIDGE_MESSAGE_SCHEMAS: {
     readonly "session.start": {
         readonly type: "object";
         readonly required: readonly ["type", "protocol", "sessionRef", "callRef", "appRef", "direction", "from", "to", "metadata", "handoff", "audio", "tracks", "speech"];
@@ -722,6 +789,9 @@ export declare const GATEWAY_MESSAGE_SCHEMAS: {
                     readonly type: "object";
                 }];
             };
+            readonly traceparent: {
+                readonly type: "string";
+            };
             readonly audio: {
                 readonly type: "object";
                 readonly required: readonly ["codec", "rate"];
@@ -992,6 +1062,20 @@ export declare const GATEWAY_MESSAGE_SCHEMAS: {
             };
         };
     };
+    readonly "transfer.answered": {
+        readonly type: "object";
+        readonly required: readonly ["type", "relatesTo"];
+        readonly properties: {
+            readonly type: {
+                readonly const: "transfer.answered";
+            };
+            readonly relatesTo: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+            };
+        };
+    };
     readonly "amd.result": {
         readonly type: "object";
         readonly required: readonly ["type", "status", "confidence", "detector", "audioMs"];
@@ -1310,9 +1394,53 @@ export declare const APP_COMMAND_SCHEMAS: {
             };
         };
     };
+    readonly "usage.report": {
+        readonly type: "object";
+        readonly required: readonly ["type", "lines"];
+        readonly properties: {
+            readonly type: {
+                readonly const: "usage.report";
+            };
+            readonly id: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+            };
+            readonly lines: {
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly maxItems: 64;
+                readonly items: {
+                    readonly type: "object";
+                    readonly required: readonly ["meter", "quantity", "provider", "keySource"];
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly meter: {
+                            readonly enum: readonly ["llm.tokens.in", "llm.tokens.out", "llm.tokens.cached", "embedding.tokens"];
+                        };
+                        readonly quantity: {
+                            readonly type: "integer";
+                            readonly minimum: 0;
+                        };
+                        readonly provider: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                        readonly model: {
+                            readonly type: "string";
+                            readonly minLength: 1;
+                        };
+                        readonly keySource: {
+                            readonly enum: readonly ["platform", "workspace"];
+                        };
+                    };
+                };
+            };
+        };
+    };
 };
 export type AppCommandType = keyof typeof APP_COMMAND_SCHEMAS;
-export type GatewayMessageType = keyof typeof GATEWAY_MESSAGE_SCHEMAS;
+export type AppBridgeMessageType = keyof typeof APPBRIDGE_MESSAGE_SCHEMAS;
 /** The whole protocol as one JSON Schema document, as exported to schema/session.v1.json. */
 export declare function sessionProtocolDocument(): {
     $schema: string;
@@ -1320,7 +1448,7 @@ export declare function sessionProtocolDocument(): {
     title: string;
     description: string;
     protocol: string;
-    gatewayToApp: {
+    appBridgeToApp: {
         readonly "session.start": {
             readonly type: "object";
             readonly required: readonly ["type", "protocol", "sessionRef", "callRef", "appRef", "direction", "from", "to", "metadata", "handoff", "audio", "tracks", "speech"];
@@ -1359,6 +1487,9 @@ export declare function sessionProtocolDocument(): {
                         readonly type: "object";
                     }];
                 };
+                readonly traceparent: {
+                    readonly type: "string";
+                };
                 readonly audio: {
                     readonly type: "object";
                     readonly required: readonly ["codec", "rate"];
@@ -1629,6 +1760,20 @@ export declare function sessionProtocolDocument(): {
                 };
             };
         };
+        readonly "transfer.answered": {
+            readonly type: "object";
+            readonly required: readonly ["type", "relatesTo"];
+            readonly properties: {
+                readonly type: {
+                    readonly const: "transfer.answered";
+                };
+                readonly relatesTo: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                };
+            };
+        };
         readonly "amd.result": {
             readonly type: "object";
             readonly required: readonly ["type", "status", "confidence", "detector", "audioMs"];
@@ -1664,7 +1809,7 @@ export declare function sessionProtocolDocument(): {
             };
         };
     };
-    appToGateway: {
+    appToAppBridge: {
         readonly speak: {
             readonly type: "object";
             readonly required: readonly ["type", "text"];
@@ -1947,5 +2092,49 @@ export declare function sessionProtocolDocument(): {
                 };
             };
         };
+        readonly "usage.report": {
+            readonly type: "object";
+            readonly required: readonly ["type", "lines"];
+            readonly properties: {
+                readonly type: {
+                    readonly const: "usage.report";
+                };
+                readonly id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                };
+                readonly lines: {
+                    readonly type: "array";
+                    readonly minItems: 1;
+                    readonly maxItems: 64;
+                    readonly items: {
+                        readonly type: "object";
+                        readonly required: readonly ["meter", "quantity", "provider", "keySource"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly meter: {
+                                readonly enum: readonly ["llm.tokens.in", "llm.tokens.out", "llm.tokens.cached", "embedding.tokens"];
+                            };
+                            readonly quantity: {
+                                readonly type: "integer";
+                                readonly minimum: 0;
+                            };
+                            readonly provider: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly model: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                            };
+                            readonly keySource: {
+                                readonly enum: readonly ["platform", "workspace"];
+                            };
+                        };
+                    };
+                };
+            };
+        };
     };
 };

package/dist/session/schema.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.APP_COMMAND_SCHEMAS = exports.GATEWAY_MESSAGE_SCHEMAS = exports.recordNoteSchema = exports.handoffSchema = exports.resumeSchema = exports.holdSchema = exports.transferCompleteSchema = exports.transferSchema = exports.TRANSFER_MODES = exports.dtmfSendSchema = exports.hangupSchema = exports.clearSchema = exports.markCommandSchema = exports.subscribeSchema = exports.SUBSCRIBABLE_EVENTS = exports.listenUpdateSchema = exports.playSchema = exports.speakSchema = exports.amdResultSchema = exports.dtmfEventSchema = exports.markEventSchema = exports.outputInterruptedSchema = exports.outputDoneSchema = exports.outputStartedSchema = exports.transcriptPartialSchema = exports.turnEstimateSchema = exports.turnBackchannelSchema = exports.turnResumedSchema = exports.turnEndedSchema = exports.turnLikelyEndedSchema = exports.turnUserStartedSchema = exports.errorSchema = exports.ERROR_CODES = exports.sessionEndSchema = exports.SESSION_END_REASONS = exports.sessionStartSchema = exports.SESSION_PROTOCOL = void 0;
+exports.APP_COMMAND_SCHEMAS = exports.APPBRIDGE_MESSAGE_SCHEMAS = exports.recordNoteSchema = exports.usageReportSchema = exports.handoffSchema = exports.resumeSchema = exports.holdSchema = exports.transferCompleteSchema = exports.transferSchema = exports.TRANSFER_MODES = exports.dtmfSendSchema = exports.hangupSchema = exports.clearSchema = exports.markCommandSchema = exports.subscribeSchema = exports.SUBSCRIBABLE_EVENTS = exports.listenUpdateSchema = exports.playSchema = exports.speakSchema = exports.amdResultSchema = exports.transferAnsweredSchema = exports.dtmfEventSchema = exports.markEventSchema = exports.outputInterruptedSchema = exports.outputDoneSchema = exports.outputStartedSchema = exports.transcriptPartialSchema = exports.turnEstimateSchema = exports.turnBackchannelSchema = exports.turnResumedSchema = exports.turnEndedSchema = exports.turnLikelyEndedSchema = exports.turnUserStartedSchema = exports.errorSchema = exports.ERROR_CODES = exports.sessionEndSchema = exports.SESSION_END_REASONS = exports.sessionStartSchema = exports.SESSION_PROTOCOL = void 0;
 exports.sessionProtocolDocument = sessionProtocolDocument;
 // The fonoster.session.v1 messages (fonoster protocol), as JSON Schema. These schemas are the source
 // of truth: TypeScript types are derived from them below, and schema/session.v1.json is exported
@@ -11,7 +11,7 @@ exports.sessionProtocolDocument = sessionProtocolDocument;
 exports.SESSION_PROTOCOL = "fonoster.session.v1";
 const id = { type: "string", minLength: 1, maxLength: 128 };
 const catalogId = { type: "string", minLength: 1 };
-// ---- gateway → app ---------------------------------------------------------------------
+// ---- appbridge → app ---------------------------------------------------------------------
 exports.sessionStartSchema = {
     type: "object",
     required: [
@@ -40,6 +40,8 @@ exports.sessionStartSchema = {
         to: { type: "string" },
         metadata: { type: "object" },
         handoff: { oneOf: [{ type: "null" }, { type: "object" }] },
+        // W3C traceparent of the call's span, so the app's spans join the call's trace (optional).
+        traceparent: { type: "string" },
         audio: {
             type: "object",
             required: ["codec", "rate"],
@@ -95,9 +97,11 @@ exports.ERROR_CODES = [
     "invalid_catalog_id",
     "feature_not_supported",
     "transfer_failed",
+    "transfer_not_answered",
     "on_hold",
     "queue_full",
     "play_fetch_failed",
+    "key_unavailable",
     "internal"
 ];
 exports.errorSchema = {
@@ -204,7 +208,16 @@ exports.dtmfEventSchema = {
         digit: { type: "string", pattern: "^[0-9A-D*#]$" }
     }
 };
-/** Answering-machine detection, once per call, for apps with `amd` (add-media-node 4.3). */
+/** A warm transfer's new party answered; the app may now send transfer.complete. */
+exports.transferAnsweredSchema = {
+    type: "object",
+    required: ["type", "relatesTo"],
+    properties: {
+        type: { const: "transfer.answered" },
+        relatesTo: id
+    }
+};
+/** Answering-machine detection, once per call, for apps with `amd` (add-roomr 4.3). */
 exports.amdResultSchema = {
     type: "object",
     required: ["type", "status", "confidence", "detector", "audioMs"],
@@ -221,7 +234,7 @@ exports.amdResultSchema = {
         reason: { type: "string" }
     }
 };
-// ---- app → gateway ---------------------------------------------------------------------
+// ---- app → appbridge ---------------------------------------------------------------------
 exports.speakSchema = {
     type: "object",
     required: ["type", "text"],
@@ -339,6 +352,42 @@ exports.handoffSchema = {
         payload: { type: "object" }
     }
 };
+/**
+ * Model token usage from Fonoster's own Autopilot (add-usage-metering D4). Reserved like
+ * record.note: accepted only from Autopilot agents and left out of the public docs.
+ */
+exports.usageReportSchema = {
+    type: "object",
+    required: ["type", "lines"],
+    properties: {
+        type: { const: "usage.report" },
+        id,
+        lines: {
+            type: "array",
+            minItems: 1,
+            maxItems: 64,
+            items: {
+                type: "object",
+                required: ["meter", "quantity", "provider", "keySource"],
+                additionalProperties: false,
+                properties: {
+                    meter: {
+                        enum: [
+                            "llm.tokens.in",
+                            "llm.tokens.out",
+                            "llm.tokens.cached",
+                            "embedding.tokens"
+                        ]
+                    },
+                    quantity: { type: "integer", minimum: 0 },
+                    provider: { type: "string", minLength: 1 },
+                    model: { type: "string", minLength: 1 },
+                    keySource: { enum: ["platform", "workspace"] }
+                }
+            }
+        }
+    }
+};
 exports.recordNoteSchema = {
     type: "object",
     required: ["type", "data"],
@@ -349,7 +398,7 @@ exports.recordNoteSchema = {
     }
 };
 /** Schemas by message type, per direction. "mark" exists in both directions. */
-exports.GATEWAY_MESSAGE_SCHEMAS = {
+exports.APPBRIDGE_MESSAGE_SCHEMAS = {
     "session.start": exports.sessionStartSchema,
     "session.end": exports.sessionEndSchema,
     error: exports.errorSchema,
@@ -365,6 +414,7 @@ exports.GATEWAY_MESSAGE_SCHEMAS = {
     "output.interrupted": exports.outputInterruptedSchema,
     mark: exports.markEventSchema,
     dtmf: exports.dtmfEventSchema,
+    "transfer.answered": exports.transferAnsweredSchema,
     "amd.result": exports.amdResultSchema
 };
 exports.APP_COMMAND_SCHEMAS = {
@@ -381,7 +431,8 @@ exports.APP_COMMAND_SCHEMAS = {
     hold: exports.holdSchema,
     resume: exports.resumeSchema,
     handoff: exports.handoffSchema,
-    "record.note": exports.recordNoteSchema
+    "record.note": exports.recordNoteSchema,
+    "usage.report": exports.usageReportSchema
 };
 /** The whole protocol as one JSON Schema document, as exported to schema/session.v1.json. */
 function sessionProtocolDocument() {
@@ -391,7 +442,7 @@ function sessionProtocolDocument() {
         title: exports.SESSION_PROTOCOL,
         description: "Messages of the Fonoster session protocol (a stream with protocol fonoster). Unknown types and fields must be ignored.",
         protocol: exports.SESSION_PROTOCOL,
-        gatewayToApp: exports.GATEWAY_MESSAGE_SCHEMAS,
-        appToGateway: exports.APP_COMMAND_SCHEMAS
+        appBridgeToApp: exports.APPBRIDGE_MESSAGE_SCHEMAS,
+        appToAppBridge: exports.APP_COMMAND_SCHEMAS
     };
 }

package/dist/sessions/index.d.ts

@@ -18,26 +18,29 @@
  */
 import type { KV, NatsConnection } from "nats";
 /**
- * The session registry (add-platform 2.3, add-media-node 3.2, decision D3): one NATS JetStream KV
+ * The session registry (add-platform 2.3, add-roomr 3.2, decision D3): one NATS JetStream KV
  * bucket shared by every service. Keys are `<kind>.<id>`:
  *
- *   nodes.<nodeId>        media node: { nodeId, rooms, draining, at }      (written by the node)
- *   rooms.<roomRef>       media node: { roomRef, nodeId, at }              (written by the node)
- *   calls.<callRef>       gateway:    { callRef, gatewayRef, nodeId, roomRef, direction, at }
- *                                     + once answered: { appRef, from, to, startedAt }
- *   gateways.<gatewayRef> gateway:    { gatewayRef, calls, at }
+ *   calls.<callRef>       appbridge:    { callRef, bridgeRef, nodeId, roomRef, direction, at }
+ *                                     + once answered: { appRef, workspaceRef, from, to, startedAt }
+ *   appbridges.<bridgeRef> retired: AppBridge no longer writes it (redesign-roomr 15.3)
+ *   placements.<callRef>  apiserver:  { callRef, nodeRef, controlAddr, roomRef?, at }
+ *                                     while an outbound call is being placed (CreateCall)
  *
- * The control plane reads `calls` and `gateways`: a call whose entry and whose gateway's entry
- * both stop being rewritten lost its gateway mid-call, and gets `call.ended` (`appbridge-lost`).
+ * Roomr nodes write nothing here (core NATS only: heartbeat and events); the control plane learns
+ * nodes from their heartbeats.
+ *
+ * The control plane reads `calls` (billing counts active calls from them). A call that loses its
+ * AppBridge mid-call is reported by its node's `call.ended` with cause `app_gone` (redesign-roomr
+ * 15.4), not by expired `appbridges` entries.
  *
  * Entries are leases: the bucket keeps a value for SESSIONS_TTL_MS after its last write, owners
- * rewrite theirs every SESSIONS_REFRESH_MS, and a crashed owner's entries expire on their own. The
- * Go node uses the same bucket, TTL and key rules (go/medianode/internal/registry).
+ * rewrite theirs every SESSIONS_REFRESH_MS, and a crashed owner's entries expire on their own.
  */
 export declare const SESSIONS_BUCKET = "fonoster_sessions";
 export declare const SESSIONS_TTL_MS = 15000;
 export declare const SESSIONS_REFRESH_MS = 5000;
-export type SessionKind = "nodes" | "rooms" | "calls" | "gateways";
+export type SessionKind = "nodes" | "rooms" | "calls" | "appbridges" | "placements";
 /** `<kind>.<id>` with characters KV keys do not allow replaced by `_`. */
 export declare const sessionKey: (kind: SessionKind, id: string) => string;
 /** Opens the bucket, creating it when it does not exist yet. */
@@ -49,7 +52,7 @@ type Logger = {
     warn(message: string): void;
 };
 /**
- * An owner's entries, kept alive until deleted (the gateway's calls and its own gateway entry).
+ * An owner's entries, kept alive until deleted (AppBridge's calls and its own appbridge entry).
  * Writes never throw: the registry is best effort and entries are rewritten on the next refresh.
  */
 export declare class SessionLeases {