@plumbus/voice-livekit 0.1.3 → 0.2.0

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,36 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.2.0 — 2026-09-10
4
+
5
+ ### Upgrade boundary
6
+
7
+ - This release is an explicit minor-line upgrade. Previous caret ranges exclude it; install the coordinated core 0.7.x family and follow the [migration checklist](../../docs/upgrading-security-release.md). Packages stage under the `next` dist-tag.
8
+
9
+ ### Fixed
10
+
11
+ - Room-session shutdown is idempotent: concurrent or repeated `stop()` calls share one cleanup and one cost-recording attempt. Resources are released before awaiting accounting, including when accounting rejects or stalls.
12
+ - Failed room connection, track publication, or initial hello releases acquired resources while preserving the startup error. Native transport cleanup attempts every resource even when another close fails.
13
+ - The simulated worker integration now runs without credentials in the default suite; added lifecycle failure and concurrency regression tests. Public APIs and pricing remain unchanged.
14
+
15
+ ### Agent instructions
16
+
17
+ - Updated packaged guidance for the security release and linked the core upgrade checklist. Refresh generated app instructions with `plumbus init --patch` (wiring v16).
18
+
19
+ ### Security
20
+
21
+ - Include tenant identity in default room names when supplied by the voice runtime. Room resolvers receive optional tenant identity.
22
+
23
+ ### Compatibility
24
+
25
+ - Explicitly configured room names remain unchanged; callers without a tenant keep their previous naming behavior. Clients should use returned room names, not reconstruct them. App-authorized shared rooms remain supported.
26
+ - Deploy with voice 0.5.0 and core 0.7.0 for automatic tenant propagation and the complete security release. [Migration guide](../../docs/upgrading-security-release.md).
27
+
28
+ ## 0.1.4
29
+
30
+ ### Fixed
31
+
32
+ - **LiveKit transport rate corrected to $0.0005/participant-minute** (was $0.02 — 40× the LiveKit Cloud Ship-tier WebRTC overage rate). Below each plan's included monthly allotment (5k–1.5M participant-minutes) the marginal cost is $0; this records the overage rate. A self-hosted agent joining the room bills as an ordinary participant.
33
+
3
34
  ## 0.1.3
4
35
 
5
36
  ### Changed
package/README.md CHANGED
@@ -1,11 +1,16 @@
1
1
  # @plumbus/voice-livekit
2
2
 
3
+ ## Release family 0.2.0
4
+
5
+ This package requires an explicit upgrade from its previous minor line. Current Plumbus peers: `@plumbus/core` `0.7.x`, `@plumbus/voice` `0.5.x`. Install the matching versions of all Plumbus packages the app uses; do not bypass peer checks with `--force` or `--legacy-peer-deps`. Historical feature floors below describe earlier releases, not compatibility with this new family. Packages stage under `next`; read the core `instructions/upgrading-security-release.md` checklist and refresh agent wiring with `plumbus init --patch` (v16).
6
+
7
+
3
8
  > **LiveKit transport, agent worker, and browser session helpers for [Plumbus](https://github.com/plumbus-framework/plumbus) voice.** Register as `transport.provider: 'livekit'`, mint room tokens, join agent workers, and run continuous or push-to-talk sessions without pulling LiveKit into `@plumbus/voice` itself.
4
9
 
5
10
  [![npm](https://img.shields.io/npm/v/@plumbus/voice-livekit.svg)](https://www.npmjs.com/package/@plumbus/voice-livekit)
6
11
  [![license](https://img.shields.io/npm/l/@plumbus/voice-livekit.svg)](./LICENSE)
7
- [![peer: @plumbus/core 0.6.x](https://img.shields.io/badge/peer-%40plumbus%2Fcore%200.6.x-blue)](https://www.npmjs.com/package/@plumbus/core)
8
- [![peer: @plumbus/voice 0.4.x](https://img.shields.io/badge/peer-%40plumbus%2Fvoice%200.4.x-blue)](https://www.npmjs.com/package/@plumbus/voice)
12
+ [![peer: @plumbus/core 0.7.x](https://img.shields.io/badge/peer-%40plumbus%2Fcore%200.7.x-blue)](https://www.npmjs.com/package/@plumbus/core)
13
+ [![peer: @plumbus/voice 0.5.x](https://img.shields.io/badge/peer-%40plumbus%2Fvoice%200.5.x-blue)](https://www.npmjs.com/package/@plumbus/voice)
9
14
 
10
15
  ## What is this?
11
16
 
@@ -41,7 +46,7 @@ LiveKit (and its agent/noise-cancellation SDKs) are heavy. Keeping them out of `
41
46
 
42
47
  ## Status
43
48
 
44
- Optional add-on of `@plumbus/voice` `0.4.x` and `@plumbus/core` `0.6.x`. Implements LiveKit transport registration, agent worker bootstrap, browser session helpers, NC engines, and transport cost recording. WebSocket transport stays built into `@plumbus/voice`.
49
+ Optional add-on of `@plumbus/voice` `0.5.x` and `@plumbus/core` `0.7.x`. Implements LiveKit transport registration, agent worker bootstrap, browser session helpers, NC engines, and transport cost recording. WebSocket transport stays built into `@plumbus/voice`.
45
50
 
46
51
  ## Install
47
52
 
@@ -51,8 +56,8 @@ pnpm add @plumbus/voice @plumbus/voice-livekit
51
56
 
52
57
  Peers (copy literals):
53
58
 
54
- - `@plumbus/core` `0.6.x` — required
55
- - `@plumbus/voice` `0.4.x` — required
59
+ - `@plumbus/core` `0.7.x` — required
60
+ - `@plumbus/voice` `0.5.x` — required
56
61
  - `livekit-client` `^2.0.0` — optional; needed for browser sessions
57
62
  - `@livekit/krisp-noise-filter` `^0.4.0` — optional; client Krisp NC
58
63
  - `fastify` `^5.0.0` — optional peer (reserved for app servers)