@inetafrica/open-claudia 3.4.6 → 3.4.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,30 @@
1
1
  # Changelog
2
2
 
3
+ ## 3.4.11
4
+
5
+ - Verify timed-out guard processes from their parent, including forced termination and released concurrency, without racing a child-written receipt.
6
+ - Retain the calling credential-renewal and scheduler fixes from the preceding release candidates.
7
+
8
+ ## 3.4.10
9
+
10
+ - Include managed device ownership generations on bot call signals, reject stale refresh generations, and report local termination once.
11
+ - Renew transport credentials before expiry on the existing Janus session.
12
+ - Give the durable migration regression a bounded two-minute subprocess budget and report spawn errors; the CI probe exceeded its previous thirty-second limit.
13
+
14
+ ## 3.4.9
15
+
16
+ - Keep concurrent Opus codecs valid when WebAssembly memory grows; test 100 simultaneous codecs and legacy packet interoperability.
17
+ - Use the assigned Janus endpoint for managed calls and reject placement changes during credential refresh.
18
+ - Route release builds through the dedicated VM runner after cluster runner startup failures.
19
+
20
+ ## v3.4.8 — Authenticated calling rooms and attempt-safe bot setup
21
+
22
+ - Kazee calling: stage server-authorized room allocation and expiring room credentials, authenticate Janus frames and subscriber joins, preserve call attempt identity across signals, and cancel stale setup. Legacy calls remain supported while room enforcement is disabled. Owner-only audio calling policy is preserved.
23
+
24
+ ## v3.4.7 — Keep scheduled follow-ups queued while the chat is busy
25
+
26
+ - Scheduler: busy chats keep wakeups queued without consuming execution retries. Watch triggers and expiries are saved once, survive restart, and stop polling while delivery is pending. Concurrent callbacks cannot start overlapping runs; advisory notifications are attempted once per occurrence. Real execution failures retain bounded retries.
27
+
3
28
  ## v3.4.6 — Codex runs again: the gate stopped asking for the impossible
4
29
 
5
30
  - **Every Codex turn since Codex CLI 0.153.x failed with `OpenAI Codex is incompatible: Codex rejected the isolated PreToolUse configuration or could not disable uncovered tool transports`.** The mandatory tool-hook gate ran `codex features list` with our overrides and required `unified_exec` to read `false`. Codex 0.153.2, 0.153.3 and 0.153.4 all ignore `-c features.unified_exec=false` (the feature is locked on and `codex features list` reports `unified_exec stable true` regardless), so the gate refused the provider on every turn — the failure Sumeet hit right after switching to gpt-6-astra on 3.4.5.
@@ -0,0 +1,53 @@
1
+ "use strict";
2
+ const { randomUUID } = require("crypto");
3
+ function validServer(value) {
4
+ if (value === undefined) return true;
5
+ if (typeof value !== 'string') return false;
6
+ try { const url = new URL(value); return url.protocol === 'wss:' && !!url.hostname && !url.username && !url.password && !url.hash; }
7
+ catch { return false; }
8
+ }
9
+
10
+ function publicCallIdentity(payload = {}) {
11
+ return {
12
+ ...(payload.callAttemptId ? { callAttemptId: payload.callAttemptId } : {}),
13
+ ...(payload.organizationId ? { organizationId: payload.organizationId } : {}),
14
+ ...(payload.roomId != null ? { roomId: Number(payload.roomId) } : {}),
15
+ };
16
+ }
17
+
18
+ function requestRoomAccess(socket, operation, input, { signal, timeoutMs = 10000 } = {}) {
19
+ if (!socket?.connected) return Promise.reject(new Error("Call socket unavailable"));
20
+ if (signal?.aborted) return Promise.reject(new Error("Call cancelled"));
21
+ const requestId = randomUUID();
22
+ const event = `call:${operation}-result`;
23
+ return new Promise((resolve, reject) => {
24
+ const cleanup = () => { clearTimeout(timer); socket.off(event, receive); signal?.removeEventListener("abort", abort); };
25
+ const fail = (message) => { cleanup(); reject(new Error(message)); };
26
+ const abort = () => fail("Call cancelled");
27
+ const receive = (reply = {}) => {
28
+ if (reply.requestId !== requestId) return;
29
+ if (!reply.ok) return fail("Call room access denied");
30
+ if (reply.protocolVersion !== 3 || typeof reply.callAttemptId !== "string" || !/^[\w-]{16,128}$/.test(reply.callAttemptId)
31
+ || typeof reply.organizationId !== "string" || !reply.organizationId || reply.deviceId !== input.deviceId
32
+ || !Number.isSafeInteger(reply.roomId) || reply.roomId <= 0 || !Number.isSafeInteger(reply.generation) || reply.generation < 0
33
+ || (input.callAttemptId && reply.callAttemptId !== input.callAttemptId)
34
+ || (input.organizationId && reply.organizationId !== input.organizationId)
35
+ || (input.roomId && reply.roomId !== Number(input.roomId)) || (input.chatId && reply.chatId !== input.chatId)
36
+ || !validServer(reply.server)
37
+ || (reply.janusTokenExpiresAt !== undefined && (!Number.isFinite(reply.janusTokenExpiresAt) || reply.janusTokenExpiresAt <= Date.now()))
38
+ || typeof reply.janusToken !== "string" || !reply.janusToken || typeof reply.roomToken !== "string" || !reply.roomToken
39
+ || (reply.leaseExpiresAt !== undefined && (!Number.isFinite(reply.leaseExpiresAt) || reply.leaseExpiresAt <= Date.now()))
40
+ || !Number.isFinite(reply.roomTokenExpiresAt) || reply.roomTokenExpiresAt <= Date.now()) return fail("Invalid call room access response");
41
+ cleanup();
42
+ resolve({ ...publicCallIdentity(reply), protocolVersion: 3, deviceId: reply.deviceId, generation: reply.generation,
43
+ ...(reply.janusTokenExpiresAt !== undefined ? {janusTokenExpiresAt: reply.janusTokenExpiresAt} : {}),
44
+ chatId: reply.chatId, nodeId: reply.nodeId, ...(reply.server !== undefined ? { server: reply.server } : {}), janusToken: reply.janusToken, roomToken: reply.roomToken, roomTokenExpiresAt: reply.roomTokenExpiresAt, ...(reply.leaseExpiresAt !== undefined ? { leaseExpiresAt: reply.leaseExpiresAt } : {}) });
45
+ };
46
+ const timer = setTimeout(() => fail("Call room access timed out"), timeoutMs);
47
+ socket.on(event, receive);
48
+ signal?.addEventListener("abort", abort, { once: true });
49
+ try { socket.emit(`call:${operation}`, { ...input, requestId }); }
50
+ catch (_) { fail("Call socket unavailable"); }
51
+ });
52
+ }
53
+ module.exports = { publicCallIdentity, requestRoomAccess };
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
 
3
- const OpusScript = require("opusscript");
3
+ const OpusScript = require("./opus-codec");
4
4
 
5
5
  const WEBRTC_RATE = 48000;
6
6
  const STT_RATE = 16000;
@@ -8,9 +8,10 @@ function transactionId() {
8
8
  }
9
9
 
10
10
  class JanusClient {
11
- constructor({ url, WebSocketImpl = WebSocket, requestTimeoutMs = 10000, keepaliveMs = 25000 } = {}) {
11
+ constructor({ url, token, WebSocketImpl = WebSocket, requestTimeoutMs = 10000, keepaliveMs = 25000 } = {}) {
12
12
  if (!url) throw new Error("Janus URL is required");
13
13
  this.url = url;
14
+ this.token = token;
14
15
  this.WebSocketImpl = WebSocketImpl;
15
16
  this.requestTimeoutMs = requestTimeoutMs;
16
17
  this.keepaliveMs = keepaliveMs;
@@ -72,6 +73,7 @@ class JanusClient {
72
73
  const transaction = transactionId();
73
74
  const frame = {
74
75
  ...payload,
76
+ ...(this.token ? { token: this.token } : {}),
75
77
  ...(withSession && this.sessionId ? { session_id: this.sessionId } : {}),
76
78
  transaction,
77
79
  };
@@ -0,0 +1,70 @@
1
+ // Same platform-neutral lease policy as the web/mobile call client.
2
+ "use strict";
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.CallLeaseHeartbeat = void 0;
5
+ /** Only measured, accepted media activates the server's managed-call lease. */
6
+ class CallLeaseHeartbeat {
7
+ constructor(transport, identity, failed, initialLeaseExpiresAt, newRequestId = () => crypto.randomUUID()) {
8
+ this.transport = transport;
9
+ this.identity = identity;
10
+ this.failed = failed;
11
+ this.newRequestId = newRequestId;
12
+ this.requestId = null;
13
+ this.leaseExpiresAt = 0;
14
+ this.started = false;
15
+ this.closed = false;
16
+ if (Number.isFinite(initialLeaseExpiresAt))
17
+ this.leaseExpiresAt = initialLeaseExpiresAt;
18
+ this.unsubscribe = transport.on('call:heartbeat-result', data => {
19
+ if (this.closed || !this.requestId || data?.requestId !== this.requestId)
20
+ return;
21
+ this.requestId = null;
22
+ clearTimeout(this.timeout);
23
+ if (!data.ok || !Number.isFinite(data.leaseExpiresAt) || data.leaseExpiresAt <= Date.now()) {
24
+ this.close();
25
+ this.failed('denied');
26
+ return;
27
+ }
28
+ // A malformed distant lease must not remove the local outage bound.
29
+ this.leaseExpiresAt = Math.min(data.leaseExpiresAt, Date.now() + 120000);
30
+ });
31
+ }
32
+ activate() {
33
+ if (this.started || this.closed)
34
+ return;
35
+ this.started = true;
36
+ if (!this.leaseExpiresAt)
37
+ this.leaseExpiresAt = Date.now() + 120000;
38
+ this.interval = setInterval(() => this.beat(), 30000);
39
+ this.beat();
40
+ }
41
+ beat() {
42
+ if (this.closed)
43
+ return;
44
+ if (Date.now() >= this.leaseExpiresAt) {
45
+ this.close();
46
+ this.failed('expired');
47
+ return;
48
+ }
49
+ if (this.requestId)
50
+ return;
51
+ const requestId = this.newRequestId();
52
+ this.requestId = requestId;
53
+ this.timeout = setTimeout(() => { if (this.requestId === requestId)
54
+ this.requestId = null; }, 15000);
55
+ try {
56
+ this.transport.emit('call:heartbeat', { ...this.identity(), requestId, mediaReady: true });
57
+ }
58
+ catch { /* A transient transport failure consumes time from the same lease. */ }
59
+ }
60
+ close() {
61
+ if (this.closed)
62
+ return;
63
+ this.closed = true;
64
+ clearInterval(this.interval);
65
+ clearTimeout(this.timeout);
66
+ this.requestId = null;
67
+ this.unsubscribe();
68
+ }
69
+ }
70
+ exports.CallLeaseHeartbeat = CallLeaseHeartbeat;
@@ -1,5 +1,8 @@
1
1
  "use strict";
2
2
 
3
+ const { randomUUID, randomInt } = require("crypto");
4
+ const { CallLeaseHeartbeat } = require("./lease");
5
+ const { publicCallIdentity, requestRoomAccess } = require("./access");
3
6
  const { canonicalForChannel } = require("../../../core/identity");
4
7
  const { KazeeCallSession } = require("./session");
5
8
 
@@ -9,10 +12,7 @@ const DEFAULT_ICE_SERVERS = [
9
12
  { urls: "stun:stun.l.google.com:19302" },
10
13
  ];
11
14
  // FCM push TTL is 60s and chat-central treats ringing logs as fresh for 90s.
12
- // Must comfortably outlast the mobile client's own 30s ring timeout: a callee
13
- // device auto-ends at 30s, the human then answers late, and chat-central
14
- // revives the CallLog — the room has to still exist when that answer lands
15
- // (first live outbound test 2026-08-08: end at 30s, real answer at 44s).
15
+ // This is the outbound invitation deadline; terminal server events end it early.
16
16
  const RING_TIMEOUT_MS = 60_000;
17
17
  const OUTGOING_GREETING = "Hey, it's Claudia. Can you hear me okay?";
18
18
  // Inbound must greet too: callers get silence until they speak first, which
@@ -21,19 +21,21 @@ const INCOMING_GREETING = "Hey, it's Claudia — you're through. Can you hear me
21
21
 
22
22
  class KazeeCallManager {
23
23
  constructor({ adapter, SessionImpl = KazeeCallSession, janusUrl = process.env.KAZEE_JANUS_URL || DEFAULT_JANUS_URL,
24
- iceServers = DEFAULT_ICE_SERVERS } = {}) {
24
+ iceServers = DEFAULT_ICE_SERVERS, deviceId = randomUUID() } = {}) {
25
25
  this.adapter = adapter;
26
26
  this.SessionImpl = SessionImpl;
27
27
  this.janusUrl = janusUrl;
28
28
  this.iceServers = iceServers;
29
29
  this.session = null;
30
+ this.deviceId = deviceId;
31
+ this._pending = null;
30
32
  this._ringTimer = null;
31
33
  }
32
34
 
33
35
  wire(socket) {
34
- socket.on("call:incoming", (payload) => this.incoming(payload));
35
- socket.on("call:ended", (payload) => this.ended(payload));
36
- socket.on("call:rejected", (payload) => this.rejected(payload));
36
+ socket.on("call:incoming", (payload) => this.incoming(payload).catch(() => console.error("Kazee call incoming failed")));
37
+ socket.on("call:ended", (payload) => this.ended(payload).catch(() => console.error("Kazee call cleanup failed")));
38
+ socket.on("call:rejected", (payload) => this.rejected(payload).catch(() => console.error("Kazee call cleanup failed")));
37
39
  socket.on("call:accepted", (payload) => this.accepted(payload));
38
40
  socket.on("call:ringing", (payload) => {
39
41
  if (this.session) console.log(`Kazee call ringing: chat=${String(payload?.chatId || "")}`);
@@ -46,26 +48,72 @@ class KazeeCallManager {
46
48
  // TURN credentials at /webrtc/config — the same endpoint the web and mobile
47
49
  // clients use. werift's ICE stack is UDP-only, so tcp/tls variants are
48
50
  // filtered out before they can break candidate gathering.
49
- async _fetchIceServers() {
50
- if (typeof this.adapter?._request !== "function") return this.iceServers;
51
- try {
52
- const res = await this.adapter._request("GET", "/webrtc/config");
53
- const fetched = Array.isArray(res?.config?.iceServers) ? res.config.iceServers : [];
54
- const usable = fetched.filter((server) => {
55
- const url = String(Array.isArray(server.urls) ? server.urls[0] : server.urls || "");
56
- if (url.startsWith("stun:")) return true;
57
- return url.startsWith("turn:") && !url.includes("transport=tcp");
58
- });
59
- const turns = usable.filter((s) => String(Array.isArray(s.urls) ? s.urls[0] : s.urls).startsWith("turn:")).length;
60
- if (turns > 0) {
61
- console.log(`Kazee call ICE config: ${usable.length} servers (${turns} TURN) from /webrtc/config`);
62
- return usable;
63
- }
64
- console.warn("Kazee call ICE config: /webrtc/config returned no usable TURN entry, using defaults");
65
- } catch (error) {
66
- console.error(`Kazee call ICE config fetch failed, using defaults: ${error.message}`);
67
- }
68
- return this.iceServers;
51
+ async _fetchCallConfig() {
52
+ // Dependency-only test adapters may supply their own media configuration.
53
+ if (typeof this.adapter?._request !== "function") return { iceServers: this.iceServers, janusServer: this.janusUrl, roomAdmissionEnabled: false };
54
+ let res;
55
+ try { res = await this.adapter._request("GET", "/webrtc/config"); }
56
+ catch (_) { throw new Error("Call configuration unavailable"); }
57
+ const config = res?.config;
58
+ if (!config || !Array.isArray(config.iceServers)) throw new Error("Call configuration unavailable");
59
+ const usable = config.iceServers.flatMap(server => {
60
+ const urls = (Array.isArray(server.urls) ? server.urls : [server.urls]).filter(url => typeof url === "string" && (url.startsWith("stun:") || (url.startsWith("turn:") && !url.includes("transport=tcp"))));
61
+ return urls.length ? [{ ...server, urls }] : [];
62
+ });
63
+ if (!usable.some(server => server.urls.some(url => url.startsWith("turn:")))) throw new Error("Call configuration has no supported TURN route");
64
+ return { iceServers: usable, janusServer: config.janusServer || this.janusUrl, janusToken: config.janusToken,
65
+ roomAdmissionEnabled: config.roomAdmissionEnabled === true };
66
+ }
67
+
68
+ async _fetchIceServers() { return (await this._fetchCallConfig()).iceServers; }
69
+
70
+ _matches(payload, session = this.session) {
71
+ if (!session || (!payload.callAttemptId && payload.roomId == null && !payload.chatId)) return false;
72
+ const identity = session.callIdentity || {};
73
+ if (payload.callAttemptId && payload.callAttemptId !== identity.callAttemptId) return false;
74
+ if (payload.organizationId && identity.organizationId && payload.organizationId !== identity.organizationId) return false;
75
+ if (payload.roomId != null && Number(payload.roomId) !== session.roomId) return false;
76
+ if (payload.chatId && payload.chatId !== session.chatId) return false;
77
+ return true;
78
+ }
79
+
80
+ _sessionOptions(config, access, identity, signal) {
81
+ return { janusUrl: access?.server || config.janusServer, iceServers: config.iceServers, janusToken: access?.janusToken || config.janusToken,
82
+ janusTokenExpiresAt: access?.janusTokenExpiresAt, managedRoom: config.roomAdmissionEnabled, roomToken: access?.roomToken, roomTokenExpiresAt: access?.roomTokenExpiresAt,
83
+ refreshRoomAccess: config.roomAdmissionEnabled ? async () => {
84
+ const next = await requestRoomAccess(this.adapter._socket, "room-access", { ...identity, deviceId: this.deviceId }, { signal });
85
+ if (next.server !== access?.server || next.nodeId !== access?.nodeId || next.generation !== access?.generation) throw new Error('Call room placement changed');
86
+ return next;
87
+ } : undefined };
88
+ }
89
+
90
+ _sessionEnded(session, reason) {
91
+ if (this.session !== session) return;
92
+ this.session = null;
93
+ if (this.adapter._socket?.connected) this.adapter._socket.emit("call:end", {
94
+ ...session.callIdentity, chatId: session.chatId, toUserId: session.callerId, reason,
95
+ });
96
+ }
97
+
98
+ _manageLease(session, access) {
99
+ if (!access) return;
100
+ const socket = this.adapter._socket;
101
+ session._leaseHeartbeat = new CallLeaseHeartbeat({
102
+ emit: (event, payload) => socket.emit(event, payload),
103
+ on: (event, listener) => { socket.on(event, listener); return () => socket.off(event, listener); },
104
+ }, () => ({ ...session.callIdentity, deviceId: this.deviceId, generation: access.generation }), reason => {
105
+ if (this.session !== session || session.closed) return;
106
+ console.warn(`Kazee managed call lease ${reason}`);
107
+ socket.emit("call:end", { ...session.callIdentity, deviceId: this.deviceId, chatId: session.chatId, toUserId: session.callerId, reason: "network-timeout" });
108
+ this.session = null;
109
+ session.close(`lease-${reason}`).catch(() => console.error("Kazee call lease cleanup failed"));
110
+ }, access.leaseExpiresAt, randomUUID);
111
+ }
112
+
113
+ _mediaReady(session) {
114
+ if (!session || session.closed || this.session !== session) return;
115
+ session._mediaReady = true;
116
+ if (session._accepted) session._leaseHeartbeat?.activate();
69
117
  }
70
118
 
71
119
  async incoming(payload = {}) {
@@ -73,46 +121,43 @@ class KazeeCallManager {
73
121
  const chatId = String(payload.chatId || "");
74
122
  const roomId = Number(payload.roomId);
75
123
  const callType = String(payload.callType || "");
76
- const owner = String(this.adapter.ownerUserId || "");
77
- console.log(`Kazee call incoming: room=${roomId} chat=${chatId} from=${callerId} type=${callType}`);
78
- const reject = (reason) => {
79
- console.log(`Kazee call rejected: room=${roomId} from=${callerId} reason=${reason}`);
80
- this.adapter._socket?.emit("call:reject", {
81
- toUserId: callerId, callType, chatId, roomId, reason,
82
- });
83
- };
84
-
85
- if (!callerId || !chatId || !Number.isSafeInteger(roomId)) return reject("invalid_call");
86
- if (callerId !== owner) return reject("not_allowed");
124
+ const identity = publicCallIdentity(payload);
125
+ const reject = (reason) => this.adapter._socket?.emit("call:reject", { ...identity, ...(identity.callAttemptId ? { deviceId: this.deviceId, generation: Number.isSafeInteger(payload.generation) && payload.generation >= 0 ? payload.generation : 0 } : {}), toUserId: callerId, callType, chatId, roomId, reason });
126
+ if (!callerId || !chatId || !Number.isSafeInteger(roomId) || roomId <= 0) return reject("invalid_call");
127
+ if (callerId !== String(this.adapter.ownerUserId || "")) return reject("not_allowed");
87
128
  if (callType !== "audio") return reject("unsupported_media");
88
- if (this.session) return reject("busy");
89
-
90
- // Human callee devices emit call:ringing as soon as they show the ring UI;
91
- // chat-central relays it and the caller's client uses it to advance the
92
- // status flow (calling -> ringing). Without it a web caller sits on
93
- // "calling" with no feedback while we fetch ICE + join Janus (2026-08-16).
94
- this.adapter._socket?.emit("call:ringing", { toUserId: callerId, chatId });
95
-
96
- const iceServers = await this._fetchIceServers();
97
- const session = new this.SessionImpl({
98
- roomId, chatId, callerId, botUserId: this.adapter.botUserId,
99
- janusUrl: this.janusUrl, iceServers, greeting: INCOMING_GREETING,
100
- onTranscript: (text, meta) => this._transcript(text, payload, meta),
101
- onEnded: () => { if (this.session === session) this.session = null; },
102
- });
103
- this.session = session;
129
+ if (this.session || this._pending) return reject("busy");
130
+ const pending = { identity: { ...identity, chatId }, controller: new AbortController() };
131
+ this._pending = pending;
132
+ this.adapter._socket?.emit("call:ringing", { ...identity, toUserId: callerId, chatId });
133
+ let session;
104
134
  try {
105
- await session.start();
106
- console.log(`Kazee call accepted: room=${roomId} from=${callerId}`);
107
- this.adapter._socket?.emit("call:accept", {
108
- toUserId: callerId, callType: "audio", chatId, roomId,
135
+ const config = await this._fetchCallConfig();
136
+ if (config.roomAdmissionEnabled && !identity.callAttemptId) throw new Error("Call identity required");
137
+ const access = config.roomAdmissionEnabled ? await requestRoomAccess(this.adapter._socket, "room-access", { ...identity, chatId, deviceId: this.deviceId }, { signal: pending.controller.signal }) : null;
138
+ if (pending.controller.signal.aborted) return;
139
+ const boundIdentity = access ? { ...publicCallIdentity(access), deviceId: this.deviceId, generation: access.generation } : identity;
140
+ session = new this.SessionImpl({ roomId, chatId, callerId, botUserId: this.adapter.botUserId,
141
+ ...this._sessionOptions(config, access, boundIdentity, pending.controller.signal), greeting: INCOMING_GREETING,
142
+ onTranscript: (text, meta) => this._transcript(text, { ...payload, ...boundIdentity }, meta),
143
+ onMediaReady: () => this._mediaReady(session),
144
+ onEnded: reason => { session?._leaseHeartbeat?.close(); pending.controller.abort(); this._sessionEnded(session, reason); },
109
145
  });
110
- } catch (error) {
111
- console.error("Kazee call connect:", error.message);
112
- this.session = null;
113
- await session.close("connect-failed").catch(() => {});
114
- reject("connection_failed");
115
- }
146
+ session.callIdentity = boundIdentity;
147
+ session.chatId = chatId;
148
+ this.session = session;
149
+ this._manageLease(session, access);
150
+ await session.start();
151
+ if (this.session !== session || session.closed || pending.controller.signal.aborted) return;
152
+ this.adapter._socket?.emit("call:accept", { ...boundIdentity, toUserId: callerId, callType: "audio", chatId, roomId });
153
+ session._accepted = true;
154
+ if (session._mediaReady) session._leaseHeartbeat?.activate();
155
+ } catch (_) {
156
+ const cancelled = pending.controller.signal.aborted;
157
+ if (this.session === session) this.session = null;
158
+ if (session) await session.close("connect-failed").catch(() => {});
159
+ if (!cancelled) reject("connection_failed");
160
+ } finally { if (this._pending === pending) this._pending = null; }
116
161
  }
117
162
 
118
163
  // Bot-initiated call. Mirrors what a human caller's client does: create the
@@ -124,44 +169,49 @@ class KazeeCallManager {
124
169
  const target = String(toUserId || this.adapter.ownerUserId || "");
125
170
  const chat = String(chatId || "");
126
171
  if (!target || !chat) throw new Error("missing chatId/toUserId");
127
- if (this.session) throw new Error("busy: a call session is already active");
172
+ if (target !== String(this.adapter.ownerUserId || "")) throw new Error("Calls are restricted to the owner");
173
+ if (this.session || this._pending) throw new Error("busy: a call session is already active");
128
174
  if (!this.adapter._socket?.connected) throw new Error("kazee socket is not connected");
129
- const roomId = Math.floor(Math.random() * 1e9);
130
- const iceServers = await this._fetchIceServers();
131
- // _transcript() reads chatId/fromUserId/roomId off the inbound invite
132
- // payload; for outbound the remote human is the "from" side.
133
- const remote = { chatId: chat, fromUserId: target, roomId, fromUserName: "" };
134
- const session = new this.SessionImpl({
135
- roomId, chatId: chat, callerId: target, botUserId: this.adapter.botUserId,
136
- janusUrl: this.janusUrl, iceServers, asCaller: true, greeting: OUTGOING_GREETING,
137
- onTranscript: (text, meta) => this._transcript(text, remote, meta),
138
- onEnded: () => {
139
- this._clearRingTimer();
140
- if (this.session === session) this.session = null;
141
- },
142
- });
143
- this.session = session;
175
+ const pending = { identity: { chatId: chat }, controller: new AbortController() };
176
+ this._pending = pending;
177
+ let session;
144
178
  try {
179
+ const config = await this._fetchCallConfig();
180
+ const access = config.roomAdmissionEnabled ? await requestRoomAccess(this.adapter._socket, "allocate", { chatId: chat, participants: [target], callType: "audio", deviceId: this.deviceId }, { signal: pending.controller.signal }) : null;
181
+ if (pending.controller.signal.aborted) throw new Error("Call cancelled");
182
+ const identity = access ? { ...publicCallIdentity(access), deviceId: this.deviceId, generation: access.generation } : { callAttemptId: randomUUID(), roomId: randomInt(1000000, 2 ** 48 - 1) };
183
+ const roomId = identity.roomId;
184
+ pending.identity = { ...identity, chatId: chat };
185
+ const remote = { ...identity, chatId: chat, fromUserId: target, fromUserName: "" };
186
+ session = new this.SessionImpl({ roomId, chatId: chat, callerId: target, botUserId: this.adapter.botUserId,
187
+ ...this._sessionOptions(config, access, identity, pending.controller.signal), asCaller: true, greeting: OUTGOING_GREETING,
188
+ onTranscript: (text, meta) => this._transcript(text, remote, meta),
189
+ onMediaReady: () => this._mediaReady(session),
190
+ onEnded: reason => { session?._leaseHeartbeat?.close(); pending.controller.abort(); this._clearRingTimer(); this._sessionEnded(session, reason); },
191
+ });
192
+ session.callIdentity = identity;
193
+ session.chatId = chat;
194
+ this.session = session;
195
+ this._manageLease(session, access);
145
196
  await session.start();
197
+ if (this.session !== session || session.closed || pending.controller.signal.aborted) throw new Error("Call cancelled");
198
+ this.adapter._socket.emit("call:invite", { ...identity, toUserId: target, callType: "audio", chatId: chat });
199
+ this._ringTimer = setTimeout(() => { this._ringTimer = null; this._ringTimeout(target, chat, roomId).catch(() => console.error("Kazee call ring timeout failed")); }, RING_TIMEOUT_MS);
200
+ this._ringTimer.unref?.();
201
+ return { ...identity, chatId: chat, toUserId: target };
146
202
  } catch (error) {
147
- this.session = null;
148
- await session.close("connect-failed").catch(() => {});
203
+ if (this.session === session) this.session = null;
204
+ if (session) await session.close("connect-failed").catch(() => {});
149
205
  throw error;
150
- }
151
- console.log(`Kazee call outgoing: room=${roomId} chat=${chat} to=${target}`);
152
- this.adapter._socket.emit("call:invite", { toUserId: target, callType: "audio", chatId: chat, roomId });
153
- this._ringTimer = setTimeout(() => {
154
- this._ringTimer = null;
155
- this._ringTimeout(target, chat, roomId).catch((error) => console.error("Kazee call ring timeout:", error.message));
156
- }, RING_TIMEOUT_MS);
157
- if (typeof this._ringTimer.unref === "function") this._ringTimer.unref();
158
- return { roomId, chatId: chat, toUserId: target };
206
+ } finally { if (this._pending === pending) this._pending = null; }
159
207
  }
160
208
 
161
209
  accepted(payload = {}) {
162
- if (!this.session || !this._ringTimer) return;
210
+ if (!this.session || !this._matches(payload)) return;
163
211
  console.log(`Kazee call answered: room=${this.session.roomId} chat=${String(payload.chatId || "")}`);
164
212
  this._clearRingTimer();
213
+ this.session._accepted = true;
214
+ if (this.session._mediaReady) this.session._leaseHeartbeat?.activate();
165
215
  }
166
216
 
167
217
  async _ringTimeout(toUserId, chatId, roomId) {
@@ -170,7 +220,7 @@ class KazeeCallManager {
170
220
  console.log(`Kazee call unanswered: room=${roomId} to=${toUserId}`);
171
221
  // Caller hanging up while ringing: chat-central finalizes the CallLog as
172
222
  // missed and dismisses the callee's ringing UI/push.
173
- this.adapter._socket?.emit("call:end", { toUserId, chatId });
223
+ this.adapter._socket?.emit("call:end", { ...session.callIdentity, toUserId, chatId });
174
224
  this.session = null;
175
225
  await session.close("no-answer").catch(() => {});
176
226
  }
@@ -218,25 +268,17 @@ class KazeeCallManager {
218
268
  }
219
269
 
220
270
  async ended(payload = {}) {
221
- if (!this.session) return;
271
+ if (this._pending && (!payload.callAttemptId || payload.callAttemptId === this._pending.identity.callAttemptId) && (!payload.chatId || payload.chatId === this._pending.identity.chatId) && (payload.roomId == null || this._pending.identity.roomId == null || Number(payload.roomId) === this._pending.identity.roomId)) this._pending.controller.abort();
272
+ if (!this.session || !this._matches(payload)) return;
222
273
  if (payload.roomId != null && Number(payload.roomId) !== this.session.roomId) return;
223
- // While our outbound ring is live, a call:ended is usually a callee DEVICE
224
- // giving up (mobile auto-ends its ring at 30s), not the human declining.
225
- // chat-central revives the CallLog if they answer late, so the caller must
226
- // keep the room alive until its own ring timeout — tearing down here left
227
- // the late answer joining a destroyed room, stuck on "Connecting" (2026-08-08).
228
- // A deliberate decline arrives as call:rejected and still closes.
229
- if (this._ringTimer) {
230
- console.log(`Kazee call ignoring ended-while-ringing: room=${this.session.roomId}`);
231
- return;
232
- }
274
+ // Terminal server state is authoritative; ended attempts are never revived.
233
275
  const session = this.session;
234
276
  this.session = null;
235
277
  await session.close("remote-ended");
236
278
  }
237
279
 
238
280
  async rejected(payload = {}) {
239
- if (!this.session) return;
281
+ if (!this.session || !this._matches(payload)) return;
240
282
  if (payload.roomId != null && Number(payload.roomId) !== this.session.roomId) return;
241
283
  const session = this.session;
242
284
  this.session = null;
@@ -244,6 +286,8 @@ class KazeeCallManager {
244
286
  }
245
287
 
246
288
  async stop() {
289
+ this._pending?.controller.abort();
290
+ this._clearRingTimer();
247
291
  if (!this.session) return;
248
292
  const session = this.session;
249
293
  this.session = null;
@@ -0,0 +1,44 @@
1
+ "use strict";
2
+
3
+ // opusscript 0.1.1 caches typed-array views that detach when its shared WASM
4
+ // memory grows. Use the same packaged native binding with fresh views for each
5
+ // operation. Native _encode/_decode represent PCM bytes as uint16 elements.
6
+ let native;
7
+ class OpusCodec {
8
+ constructor(rate, channels, application) {
9
+ native ||= require("opusscript/build/opusscript_native_wasm.js")();
10
+ this.channels = channels;
11
+ this.handler = new native.OpusScriptHandler(rate, channels, application);
12
+ this.pcmElements = 5760 * channels;
13
+ this.packetBytes = 3828;
14
+ this.pcmInput = native._malloc(this.pcmElements * 2);
15
+ this.pcmOutput = native._malloc(this.pcmElements * 2);
16
+ this.packetInput = native._malloc(this.packetBytes);
17
+ this.packetOutput = native._malloc(this.packetBytes);
18
+ }
19
+ encode(bytes, samples) {
20
+ if (!this.handler) throw new Error("Opus codec closed");
21
+ if (bytes.length > this.pcmElements) throw new Error("Opus PCM exceeds frame limit");
22
+ native.HEAPU16.set(bytes, this.pcmInput / 2);
23
+ const length = this.handler._encode(this.pcmInput, bytes.length, this.packetOutput, samples);
24
+ if (length < 0 || length > this.packetBytes) throw new Error(`Opus encode failed (${length})`);
25
+ return Buffer.from(native.HEAPU8.subarray(this.packetOutput, this.packetOutput + length));
26
+ }
27
+ decode(bytes) {
28
+ if (!this.handler) throw new Error("Opus codec closed");
29
+ if (bytes.length > this.packetBytes) throw new Error("Opus packet exceeds size limit");
30
+ native.HEAPU8.set(bytes, this.packetInput);
31
+ const samples = this.handler._decode(this.packetInput, bytes.length, this.pcmOutput);
32
+ const length = samples * this.channels * 2;
33
+ if (samples < 0 || length > this.pcmElements) throw new Error(`Opus decode failed (${samples})`);
34
+ return Buffer.from(native.HEAPU16.subarray(this.pcmOutput / 2, this.pcmOutput / 2 + length));
35
+ }
36
+ delete() {
37
+ if (!this.handler) return;
38
+ native.OpusScriptHandler.destroy_handler(this.handler);
39
+ this.handler = null;
40
+ for (const pointer of [this.pcmInput,this.pcmOutput,this.packetInput,this.packetOutput]) native._free(pointer);
41
+ }
42
+ }
43
+ OpusCodec.Application = { VOIP: 2048 };
44
+ module.exports = OpusCodec;