@ajna-inc/webrtc 0.1.0 → 0.2.0

package/build/webrtc/messages/OfferMessage.d.ts

@@ -1,14 +1,34 @@
 import { AgentMessage } from '@credo-ts/core';
+/**
+ * ICE policy for NAT traversal
+ * - 'all': Use all available candidates (host, srflx, relay)
+ * - 'relay-preferred': Prefer relay candidates but allow others
+ * - 'relay-only': Only use relay (TURN) candidates - best for strict NAT/firewall
+ */
+export type IcePolicy = 'all' | 'relay-preferred' | 'relay-only';
 export declare class IceServerConfig {
-    urls: string;
+    /**
+     * STUN/TURN server URL(s). Can be a single URL or array of URLs.
+     * Examples: 'stun:stun.example.org:3478', ['turn:turn.example.org:3478', 'turns:turn.example.org:5349']
+     */
+    urls?: string | string[];
+    url?: string;
     username?: string;
     credential?: string;
+    credentialType?: 'password' | 'oauth';
+    /**
+     * Get URLs as array (handles both urls and legacy url field)
+     */
+    getUrls(): string[];
 }
 export interface OfferMessageOptions {
     id?: string;
     threadId: string;
+    parentThreadId?: string;
     sdp: string;
     iceServers?: IceServerConfig[];
+    policy?: IcePolicy;
+    trickle?: boolean;
     jws?: Record<string, unknown>;
 }
 export declare class OfferMessage extends AgentMessage {
@@ -17,5 +37,13 @@ export declare class OfferMessage extends AgentMessage {
     static readonly type: import("@credo-ts/core").ParsedMessageType;
     sdp: string;
     iceServers?: IceServerConfig[];
+    /**
+     * ICE policy for NAT traversal
+     */
+    policy?: IcePolicy;
+    /**
+     * Whether trickle ICE is supported/requested
+     */
+    trickle?: boolean;
     jws?: Record<string, unknown>;
 }

package/build/webrtc/messages/OfferMessage.js

@@ -14,12 +14,30 @@ const core_1 = require("@credo-ts/core");
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
 class IceServerConfig {
+    /**
+     * Get URLs as array (handles both urls and legacy url field)
+     */
+    getUrls() {
+        if (this.urls) {
+            return Array.isArray(this.urls) ? this.urls : [this.urls];
+        }
+        if (this.url) {
+            return [this.url];
+        }
+        return [];
+    }
 }
 exports.IceServerConfig = IceServerConfig;
 __decorate([
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
-    __metadata("design:type", String)
+    __metadata("design:type", Object)
 ], IceServerConfig.prototype, "urls", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], IceServerConfig.prototype, "url", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
@@ -30,6 +48,11 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], IceServerConfig.prototype, "credential", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], IceServerConfig.prototype, "credentialType", void 0);
 class OfferMessage extends core_1.AgentMessage {
     constructor(options) {
         super();
@@ -38,8 +61,10 @@ class OfferMessage extends core_1.AgentMessage {
             this.id = options.id ?? this.generateId();
             this.sdp = options.sdp;
             this.iceServers = options.iceServers;
+            this.policy = options.policy;
+            this.trickle = options.trickle;
             this.jws = options.jws;
-            this.setThread({ threadId: options.threadId });
+            this.setThread({ threadId: options.threadId, parentThreadId: options.parentThreadId });
         }
     }
 }
@@ -60,6 +85,16 @@ __decorate([
     (0, class_validator_1.IsArray)(),
     __metadata("design:type", Array)
 ], OfferMessage.prototype, "iceServers", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], OfferMessage.prototype, "policy", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], OfferMessage.prototype, "trickle", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsObject)(),

package/build/webrtc/messages/OfferMessage.js.map

@@ -1 +1 @@
-{"version":3,"file":"OfferMessage.js","sourceRoot":"","sources":["../../../src/webrtc/messages/OfferMessage.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAmF;AACnF,qDAAyF;AACzF,yDAAwC;AAExC,MAAa,eAAe;CAW3B;AAXD,0CAWC;AATQ;IADN,IAAA,0BAAQ,GAAE;;6CACS;AAIb;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;iDACa;AAIjB;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;mDACe;AAW5B,MAAa,YAAa,SAAQ,mBAAY;IAC5C,YAAmB,OAA4B;QAC7C,KAAK,EAAE,CAAA;QAWO,SAAI,GAAG,YAAY,CAAC,IAAI,CAAC,cAAc,CAAA;QAVrD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAA;YACzC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAA;YACtB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;YACpC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAA;YACtB,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;QAChD,CAAC;IACH,CAAC;;AAVH,oCA4BC;AAdwB,iBAAI,GAAG,IAAA,uBAAgB,EAAC,sCAAsC,CAAC,AAA3D,CAA2D;AADtE;IADf,IAAA,yBAAkB,EAAC,YAAY,CAAC,IAAI,CAAC;;0CACiB;AAIhD;IADN,IAAA,0BAAQ,GAAE;;yCACQ;AAMZ;IAJN,IAAA,4BAAU,GAAE;IACZ,IAAA,gCAAc,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,eAAe,CAAC;IAC3B,IAAA,yBAAO,GAAE;;gDAC2B;AAI9B;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;yCACyB"}
+{"version":3,"file":"OfferMessage.js","sourceRoot":"","sources":["../../../src/webrtc/messages/OfferMessage.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAmF;AACnF,qDAAoG;AACpG,yDAAwC;AAUxC,MAAa,eAAe;IAyB1B;;OAEG;IACI,OAAO;QACZ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3D,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACnB,CAAC;QACD,OAAO,EAAE,CAAA;IACX,CAAC;CACF;AArCD,0CAqCC;AA9BQ;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;6CACoB;AAIxB;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;4CACQ;AAIZ;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;iDACa;AAIjB;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;mDACe;AAInB;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;uDACiC;AA2B9C,MAAa,YAAa,SAAQ,mBAAY;IAC5C,YAAmB,OAA4B;QAC7C,KAAK,EAAE,CAAA;QAaO,SAAI,GAAG,YAAY,CAAC,IAAI,CAAC,cAAc,CAAA;QAZrD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAA;YACzC,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAA;YACtB,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;YACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;YAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;YAC9B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAA;YACtB,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;QACxF,CAAC;IACH,CAAC;;AAZH,oCA4CC;AA5BwB,iBAAI,GAAG,IAAA,uBAAgB,EAAC,sCAAsC,CAAC,AAA3D,CAA2D;AADtE;IADf,IAAA,yBAAkB,EAAC,YAAY,CAAC,IAAI,CAAC;;0CACiB;AAIhD;IADN,IAAA,0BAAQ,GAAE;;yCACQ;AAMZ;IAJN,IAAA,4BAAU,GAAE;IACZ,IAAA,gCAAc,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,eAAe,CAAC;IAC3B,IAAA,yBAAO,GAAE;;gDAC2B;AAO9B;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;4CACc;AAOlB;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;6CACY;AAIjB;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;yCACyB"}

package/build/webrtc/messages/ProposeMessage.d.ts

@@ -1,12 +1,63 @@
 import { AgentMessage } from '@credo-ts/core';
+import { IceServerConfig, IcePolicy } from './OfferMessage';
+/**
+ * Media types that can be requested in a call
+ */
+export type MediaType = 'audio' | 'video';
 export interface ProposeMessageOptions {
     id?: string;
     threadId?: string;
+    parentThreadId?: string;
+    /** Requested media types */
+    media?: MediaType[];
+    /** Whether data channel is requested */
+    data?: boolean;
+    /** Topology hint: 'mesh' for P2P */
+    topology?: 'mesh' | 'sfu';
+    /** Whether trickle ICE is supported */
+    trickle?: boolean;
+    /** ICE policy for NAT traversal */
+    policy?: IcePolicy;
+    /** ICE servers (STUN/TURN) for NAT traversal */
+    iceServers?: IceServerConfig[];
+    /** Optional reason/context for the call */
     reason?: string;
 }
+/**
+ * ProposeMessage - Caller initiates a WebRTC session request
+ * This message is sent before the offer to negotiate capabilities and share ICE servers
+ */
 export declare class ProposeMessage extends AgentMessage {
     constructor(options: ProposeMessageOptions);
     readonly type: string;
     static readonly type: import("@credo-ts/core").ParsedMessageType;
+    /**
+     * Requested media types: ['audio'], ['video'], or ['audio', 'video']
+     */
+    media?: MediaType[];
+    /**
+     * Whether a data channel is requested
+     */
+    data?: boolean;
+    /**
+     * Topology: 'mesh' for P2P, 'sfu' for server-mediated
+     */
+    topology?: 'mesh' | 'sfu';
+    /**
+     * Whether trickle ICE is supported
+     */
+    trickle?: boolean;
+    /**
+     * ICE policy for NAT traversal
+     */
+    policy?: IcePolicy;
+    /**
+     * ICE servers (STUN/TURN) for NAT traversal
+     * Shared early so callee can configure RTCPeerConnection before receiving offer
+     */
+    iceServers?: IceServerConfig[];
+    /**
+     * Optional reason/context for the call
+     */
     reason?: string;
 }

package/build/webrtc/messages/ProposeMessage.js

@@ -12,15 +12,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProposeMessage = void 0;
 const core_1 = require("@credo-ts/core");
 const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const OfferMessage_1 = require("./OfferMessage");
+/**
+ * ProposeMessage - Caller initiates a WebRTC session request
+ * This message is sent before the offer to negotiate capabilities and share ICE servers
+ */
 class ProposeMessage extends core_1.AgentMessage {
     constructor(options) {
         super();
         this.type = ProposeMessage.type.messageTypeUri;
         if (options) {
             this.id = options.id ?? this.generateId();
+            this.media = options.media;
+            this.data = options.data;
+            this.topology = options.topology ?? 'mesh';
+            this.trickle = options.trickle ?? true;
+            this.policy = options.policy;
+            this.iceServers = options.iceServers;
             this.reason = options.reason;
-            if (options.threadId)
-                this.setThread({ threadId: options.threadId });
+            if (options.threadId) {
+                this.setThread({ threadId: options.threadId, parentThreadId: options.parentThreadId });
+            }
         }
     }
 }
@@ -30,6 +43,39 @@ __decorate([
     (0, core_1.IsValidMessageType)(ProposeMessage.type),
     __metadata("design:type", Object)
 ], ProposeMessage.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], ProposeMessage.prototype, "media", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], ProposeMessage.prototype, "data", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ProposeMessage.prototype, "topology", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], ProposeMessage.prototype, "trickle", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ProposeMessage.prototype, "policy", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => OfferMessage_1.IceServerConfig),
+    (0, class_validator_1.IsArray)(),
+    __metadata("design:type", Array)
+], ProposeMessage.prototype, "iceServers", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),

package/build/webrtc/messages/ProposeMessage.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProposeMessage.js","sourceRoot":"","sources":["../../../src/webrtc/messages/ProposeMessage.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAmF;AACnF,qDAAsD;AAQtD,MAAa,cAAe,SAAQ,mBAAY;IAC9C,YAAmB,OAA8B;QAC/C,KAAK,EAAE,CAAA;QASO,SAAI,GAAG,cAAc,CAAC,IAAI,CAAC,cAAc,CAAA;QARvD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAA;YACzC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;YAC5B,IAAI,OAAO,CAAC,QAAQ;gBAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;QACtE,CAAC;IACH,CAAC;;AARH,wCAiBC;AALwB,mBAAI,GAAG,IAAA,uBAAgB,EAAC,wCAAwC,CAAC,AAA7D,CAA6D;AADxE;IADf,IAAA,yBAAkB,EAAC,cAAc,CAAC,IAAI,CAAC;;4CACiB;AAKlD;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;8CACW"}
+{"version":3,"file":"ProposeMessage.js","sourceRoot":"","sources":["../../../src/webrtc/messages/ProposeMessage.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAmF;AACnF,qDAA0F;AAC1F,yDAAwC;AAExC,iDAA2D;AA2B3D;;;GAGG;AACH,MAAa,cAAe,SAAQ,mBAAY;IAC9C,YAAmB,OAA8B;QAC/C,KAAK,EAAE,CAAA;QAiBO,SAAI,GAAG,cAAc,CAAC,IAAI,CAAC,cAAc,CAAA;QAhBvD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAA;YACzC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;YAC1B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;YACxB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAA;YAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAA;YACtC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;YAC5B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;YACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;YAC5B,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACrB,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;YACxF,CAAC;QACH,CAAC;IACH,CAAC;;AAhBH,wCA0EC;AAtDwB,mBAAI,GAAG,IAAA,uBAAgB,EAAC,wCAAwC,CAAC,AAA7D,CAA6D;AADxE;IADf,IAAA,yBAAkB,EAAC,cAAc,CAAC,IAAI,CAAC;;4CACiB;AASlD;IAHN,IAAA,4BAAU,GAAE;IACZ,IAAA,yBAAO,GAAE;IACT,IAAA,0BAAQ,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;;6CACC;AAOnB;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;4CACS;AAOd;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;gDACqB;AAOzB;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;+CACY;AAOjB;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;8CACc;AAUlB;IAJN,IAAA,4BAAU,GAAE;IACZ,IAAA,gCAAc,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,8BAAe,CAAC;IAC3B,IAAA,yBAAO,GAAE;;kDAC2B;AAO9B;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;8CACW"}

package/build/webrtc/messages/RenegotiateMessage.d.ts

@@ -0,0 +1,52 @@
+import { AgentMessage } from '@credo-ts/core';
+import { IceServerConfig, IcePolicy } from './OfferMessage';
+/**
+ * Reasons for renegotiation
+ */
+export type RenegotiateReason = 'add-track' | 'remove-track' | 'add-screenshare' | 'remove-screenshare' | 'ice-restart' | 'codec-change' | 'bandwidth-change' | 'other';
+export interface RenegotiateMessageOptions {
+    id?: string;
+    threadId: string;
+    parentThreadId?: string;
+    /** Reason for renegotiation */
+    reason: RenegotiateReason | string;
+    /** Whether to perform an ICE restart (required for recovering failed connections) */
+    iceRestart?: boolean;
+    /** New ICE servers to use (useful when switching networks) */
+    iceServers?: IceServerConfig[];
+    /** Updated ICE policy */
+    policy?: IcePolicy;
+}
+/**
+ * RenegotiateMessage - Request to renegotiate the WebRTC session
+ * Used for:
+ * - Adding/removing media tracks (screenshare, camera switch)
+ * - ICE restart when connection fails (critical for NAT/firewall recovery)
+ * - Changing codecs or bandwidth constraints
+ */
+export declare class RenegotiateMessage extends AgentMessage {
+    constructor(options: RenegotiateMessageOptions);
+    readonly type: string;
+    static readonly type: import("@credo-ts/core").ParsedMessageType;
+    /**
+     * Reason for renegotiation
+     */
+    reason: RenegotiateReason | string;
+    /**
+     * Whether to perform an ICE restart
+     * Set to true when:
+     * - ICE connection state is 'failed' or 'disconnected'
+     * - Network change detected (WiFi to cellular, etc.)
+     * - NAT binding expired
+     */
+    iceRestart?: boolean;
+    /**
+     * New ICE servers to use
+     * Useful when switching networks or when original servers are unreachable
+     */
+    iceServers?: IceServerConfig[];
+    /**
+     * Updated ICE policy
+     */
+    policy?: IcePolicy;
+}

package/build/webrtc/messages/RenegotiateMessage.js

@@ -0,0 +1,65 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RenegotiateMessage = void 0;
+const core_1 = require("@credo-ts/core");
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const OfferMessage_1 = require("./OfferMessage");
+/**
+ * RenegotiateMessage - Request to renegotiate the WebRTC session
+ * Used for:
+ * - Adding/removing media tracks (screenshare, camera switch)
+ * - ICE restart when connection fails (critical for NAT/firewall recovery)
+ * - Changing codecs or bandwidth constraints
+ */
+class RenegotiateMessage extends core_1.AgentMessage {
+    constructor(options) {
+        super();
+        this.type = RenegotiateMessage.type.messageTypeUri;
+        if (options) {
+            this.id = options.id ?? this.generateId();
+            this.reason = options.reason;
+            this.iceRestart = options.iceRestart ?? false;
+            this.iceServers = options.iceServers;
+            this.policy = options.policy;
+            this.setThread({ threadId: options.threadId, parentThreadId: options.parentThreadId });
+        }
+    }
+}
+exports.RenegotiateMessage = RenegotiateMessage;
+RenegotiateMessage.type = (0, core_1.parseMessageType)('https://didcomm.org/webrtc/1.0/renegotiate');
+__decorate([
+    (0, core_1.IsValidMessageType)(RenegotiateMessage.type),
+    __metadata("design:type", Object)
+], RenegotiateMessage.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RenegotiateMessage.prototype, "reason", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], RenegotiateMessage.prototype, "iceRestart", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => OfferMessage_1.IceServerConfig),
+    (0, class_validator_1.IsArray)(),
+    __metadata("design:type", Array)
+], RenegotiateMessage.prototype, "iceServers", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RenegotiateMessage.prototype, "policy", void 0);
+//# sourceMappingURL=RenegotiateMessage.js.map

package/build/webrtc/messages/RenegotiateMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenegotiateMessage.js","sourceRoot":"","sources":["../../../src/webrtc/messages/RenegotiateMessage.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAmF;AACnF,qDAA0F;AAC1F,yDAAwC;AAExC,iDAA2D;AA6B3D;;;;;;GAMG;AACH,MAAa,kBAAmB,SAAQ,mBAAY;IAClD,YAAmB,OAAkC;QACnD,KAAK,EAAE,CAAA;QAYO,SAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,cAAc,CAAA;QAX3D,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAA;YACzC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;YAC5B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,KAAK,CAAA;YAC7C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;YACpC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;YAC5B,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;QACxF,CAAC;IACH,CAAC;;AAXH,gDAkDC;AAnCwB,uBAAI,GAAG,IAAA,uBAAgB,EAAC,4CAA4C,CAAC,AAAjE,CAAiE;AAD5E;IADf,IAAA,yBAAkB,EAAC,kBAAkB,CAAC,IAAI,CAAC;;gDACiB;AAOtD;IADN,IAAA,0BAAQ,GAAE;;kDAC+B;AAWnC;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,GAAE;;sDACe;AAUpB;IAJN,IAAA,4BAAU,GAAE;IACZ,IAAA,gCAAc,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,8BAAe,CAAC;IAC3B,IAAA,yBAAO,GAAE;;sDAC2B;AAO9B;IAFN,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;;kDACc"}

package/build/webrtc/messages/index.d.ts

@@ -2,4 +2,5 @@ export * from './ProposeMessage';
 export * from './OfferMessage';
 export * from './AnswerMessage';
 export * from './IceMessage';
+export * from './RenegotiateMessage';
 export * from './EndMessage';

package/build/webrtc/messages/index.js

@@ -18,5 +18,6 @@ __exportStar(require("./ProposeMessage"), exports);
 __exportStar(require("./OfferMessage"), exports);
 __exportStar(require("./AnswerMessage"), exports);
 __exportStar(require("./IceMessage"), exports);
+__exportStar(require("./RenegotiateMessage"), exports);
 __exportStar(require("./EndMessage"), exports);
 //# sourceMappingURL=index.js.map

package/build/webrtc/messages/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/webrtc/messages/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAgC;AAChC,iDAA8B;AAC9B,kDAA+B;AAC/B,+CAA4B;AAC5B,+CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/webrtc/messages/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAgC;AAChC,iDAA8B;AAC9B,kDAA+B;AAC/B,+CAA4B;AAC5B,uDAAoC;AACpC,+CAA4B"}

package/build/webrtc/services/WebRTCService.d.ts

@@ -1,25 +1,86 @@
 import type { AgentContext, InboundMessageContext } from '@credo-ts/core';
 import type { ConnectionRecord } from '@credo-ts/core';
 import { EventEmitter } from '@credo-ts/core';
-import { AnswerMessage, EndMessage, IceMessage, OfferMessage, ProposeMessage } from '../messages';
+import { AnswerMessage, EndMessage, IceMessage, OfferMessage, ProposeMessage, RenegotiateMessage } from '../messages';
+import type { IcePolicy, IceServerConfig } from '../messages/OfferMessage';
+import type { MediaType } from '../messages/ProposeMessage';
+import type { RenegotiateReason } from '../messages/RenegotiateMessage';
 import { WebRTCCallRecord } from '../repository/WebRTCCallRecord';
 import { WebRTCCallRepository } from '../repository/WebRTCCallRepository';
 export declare class WebRTCService {
     private repo;
     private events;
     constructor(repo: WebRTCCallRepository, events: EventEmitter);
-    createOffer(agentContext: AgentContext, connection: ConnectionRecord, threadId: string, sdp: string, iceServers?: OfferMessage['iceServers']): {
+    /**
+     * Create a propose message to initiate a call
+     */
+    createPropose(options: {
+        threadId?: string;
+        parentThreadId?: string;
+        media?: MediaType[];
+        data?: boolean;
+        topology?: 'mesh' | 'sfu';
+        trickle?: boolean;
+        policy?: IcePolicy;
+        iceServers?: IceServerConfig[];
+        reason?: string;
+    }): {
+        message: ProposeMessage;
+    };
+    /**
+     * Create an offer message with SDP
+     */
+    createOffer(agentContext: AgentContext, connection: ConnectionRecord, threadId: string, parentThreadId: string | undefined, sdp: string, iceServers?: IceServerConfig[], policy?: IcePolicy, trickle?: boolean): {
         message: OfferMessage;
         record: WebRTCCallRecord;
     };
-    createAnswer(agentContext: AgentContext, connection: ConnectionRecord, threadId: string, sdp: string): {
+    /**
+     * Create an answer message with SDP
+     */
+    createAnswer(agentContext: AgentContext, connection: ConnectionRecord, threadId: string, parentThreadId: string | undefined, sdp: string, iceServers?: IceServerConfig[]): {
         message: AnswerMessage;
     };
-    createIce(threadId: string, candidate: Record<string, unknown> | undefined, endOfCandidates?: boolean): IceMessage;
-    createEnd(threadId: string, reason?: string): EndMessage;
+    /**
+     * Create an ICE candidate message
+     */
+    createIce(threadId: string, parentThreadId: string | undefined, candidate: Record<string, unknown> | undefined, endOfCandidates?: boolean): IceMessage;
+    /**
+     * Create a renegotiate message (for ICE restart, track changes, etc.)
+     */
+    createRenegotiate(options: {
+        threadId: string;
+        parentThreadId?: string;
+        reason: RenegotiateReason | string;
+        iceRestart?: boolean;
+        iceServers?: IceServerConfig[];
+        policy?: IcePolicy;
+    }): RenegotiateMessage;
+    /**
+     * Create an end call message
+     */
+    createEnd(threadId: string, parentThreadId: string | undefined, reason?: string): EndMessage;
+    /**
+     * Process incoming propose message
+     */
     processPropose(messageContext: InboundMessageContext<ProposeMessage>): Promise<void>;
+    /**
+     * Process incoming offer message
+     */
     processOffer(messageContext: InboundMessageContext<OfferMessage>): Promise<void>;
+    /**
+     * Process incoming answer message
+     */
     processAnswer(messageContext: InboundMessageContext<AnswerMessage>): Promise<void>;
+    /**
+     * Process incoming ICE candidate message
+     */
     processIce(messageContext: InboundMessageContext<IceMessage>): Promise<void>;
+    /**
+     * Process incoming renegotiate message
+     */
+    processRenegotiate(messageContext: InboundMessageContext<RenegotiateMessage>): Promise<void>;
+    /**
+     * Process incoming end call message
+     */
     processEnd(messageContext: InboundMessageContext<EndMessage>): Promise<void>;
 }