crowdplaysdk 0.3.4 → 0.4.0

package/ios/CrowdPlayRNModule.swift

@@ -278,8 +278,20 @@ public final class CrowdPlayRNModule: RCTEventEmitter {
 
     @objc public func join(_ displayName: NSString, roomCode: NSString,
                            consentGrantedAtMs: NSNumber,
+                           agent: NSDictionary?,
                            resolver: @escaping RCTPromiseResolveBlock,
                            rejecter: @escaping RCTPromiseRejectBlock) {
+        // Per-join voice-AI overrides (D-095): the JS layer already clamped
+        // and dropped blanks; nil means "dashboard defaults".
+        var agentOptions: CrowdPlayAgentOptions?
+        if let agent {
+            let voice = agent["voice"] as? String
+            let prompt = agent["systemPrompt"] as? String
+            let context = agent["context"] as? String
+            if voice != nil || prompt != nil || context != nil {
+                agentOptions = CrowdPlayAgentOptions(voice: voice, systemPrompt: prompt, context: context)
+            }
+        }
         Task { @MainActor in
             let core = CrowdPlayRNCore.shared
             core.displayName = displayName as String
@@ -292,7 +304,8 @@ public final class CrowdPlayRNModule: RCTEventEmitter {
             )
             await core.engine.join(displayName: displayName as String,
                                    roomCode: roomCode as String,
-                                   consent: consent)
+                                   consent: consent,
+                                   agent: agentOptions)
             if case let .failed(message) = core.engine.phase {
                 rejecter("join_failed", message, nil)
             } else {

package/ios/CrowdPlayReactNative.m

@@ -13,6 +13,7 @@ RCT_EXTERN_METHOD(consentText : (RCTPromiseResolveBlock)resolve
 RCT_EXTERN_METHOD(join : (NSString *)displayName
                   roomCode : (NSString *)roomCode
                   consentGrantedAtMs : (nonnull NSNumber *)consentGrantedAtMs
+                  agent : (NSDictionary *)agent
                   resolver : (RCTPromiseResolveBlock)resolve
                   rejecter : (RCTPromiseRejectBlock)reject)
 RCT_EXTERN_METHOD(leave : (RCTPromiseResolveBlock)resolve

package/ios/wire.rb

@@ -25,7 +25,7 @@ SDK_URL = 'https://github.com/symbiateam/crowdplaysdk'
 # The ENGINE release this bridge was tested against. The npm package
 # version may be AHEAD of this (bridge/docs fixes ship without a new
 # engine binary); that is deliberate, not drift.
-SDK_VERSION = '0.3.4'
+SDK_VERSION = '0.4.0'
 BRIDGE_FILES = ['CrowdPlayRNModule.swift', 'CrowdPlayRNVideoView.swift', 'CrowdPlayReactNative.m'].freeze
 
 project_name = ARGV[0] or abort 'usage: ruby wire.rb <YourProjectName>'

package/lib/index.d.ts

@@ -58,6 +58,28 @@ export interface ConsentGrant {
     /** Date.now() at the moment the participant agreed. */
     grantedAtMs: number;
 }
+/**
+ * Per-join settings for the voice AI (D-095), for apps with the Voice AI
+ * switch on. The dashboard config stays the default; anything passed here
+ * overrides it for THIS session only. Fixed once the session starts (leave
+ * and join again to change). The options of the join that creates the AI
+ * apply to the whole room. The app can never change the provider, the
+ * model, or the API key from here.
+ */
+export interface AgentOptions {
+    /** A voice of the app's configured provider. Gemini: Charon, Aoede,
+     * Fenrir, Kore, Puck. OpenAI: marin, cedar, alloy, ash, ballad, coral,
+     * echo, sage, shimmer, verse. Grok: Ara, Rex, Sal, Eve, Leo. Unknown
+     * names fall back to the dashboard voice. */
+    voice?: string;
+    /** Replaces the dashboard persona for this session. Max 8192 chars. */
+    systemPrompt?: string;
+    /** Short text appended to the persona: what the app knows about this
+     * user, where they left off. This is how an app gives the AI memory:
+     * keep a few sentences per user in your own storage and pass them
+     * here. Max 4000 chars. */
+    context?: string;
+}
 export type Phase = 'idle' | 'connecting' | 'connected' | 'failed';
 export interface RecordingSnapshot {
     /** Seconds of audio safely written so far. */
@@ -161,6 +183,7 @@ declare const CrowdPlay: {
         displayName: string;
         roomCode: string;
         consent: ConsentGrant;
+        agent?: AgentOptions;
     }): Promise<void>;
     /** Leave the room. Recording stops; uploads proceed automatically (they
      * survive backgrounding; force-quit pauses them until next launch). */

package/lib/index.js

@@ -81,7 +81,7 @@ const CrowdPlay = {
         if (!configured) {
             throw new Error('crowdplaysdk: call CrowdPlay.configure() before join()');
         }
-        const { displayName, roomCode, consent } = options ?? {};
+        const { displayName, roomCode, consent, agent } = options ?? {};
         if (!displayName?.trim())
             throw new Error('crowdplaysdk: displayName is required');
         if (!roomCode?.trim())
@@ -91,7 +91,19 @@ const CrowdPlay = {
                 '(or your own UI displaying CrowdPlay.consentText()) and pass its result. ' +
                 'Recording without consent is not supported.');
         }
-        return native().join(displayName.trim(), roomCode, consent.grantedAtMs);
+        // Flat strings, clamped to the server's caps; blanks are not sent.
+        let agentFields = null;
+        if (agent && typeof agent === 'object') {
+            const put = (key, value, max) => {
+                if (typeof value === 'string' && value.trim()) {
+                    agentFields = { ...(agentFields ?? {}), [key]: value.slice(0, max) };
+                }
+            };
+            put('voice', agent.voice, 60);
+            put('systemPrompt', agent.systemPrompt, 8192);
+            put('context', agent.context, 4000);
+        }
+        return native().join(displayName.trim(), roomCode, consent.grantedAtMs, agentFields);
     },
     /** Leave the room. Recording stops; uploads proceed automatically (they
      * survive backgrounding; force-quit pauses them until next launch). */

package/llms.txt

@@ -132,7 +132,9 @@ Default export `CrowdPlay`:
   consentText(): Promise<string>       // the REQUIRED consent wording
   warmUp(): void                       // pre-warm backend from the join screen
   join(opts: { displayName: string; roomCode: string;
-               consent: ConsentGrant }): Promise<void>   // THROWS without consent
+               consent: ConsentGrant;
+               agent?: AgentOptions }): Promise<void>   // THROWS without consent
+  AgentOptions { voice?: string; systemPrompt?: string; context?: string }  // 0.4.0+, voice-AI apps
   leave(): Promise<void>
   setMicMuted(muted: boolean): Promise<void>
   setCameraEnabled(enabled: boolean): Promise<void>
@@ -159,8 +161,21 @@ call, CrowdPlay's servers put a live AI participant into the room within
 the user, and holds a real spoken conversation (speech-to-speech: it
 hears the user directly, answers in natural voice, can be interrupted).
 The app writes ZERO AI code — no model API calls, no AI keys, no chat
-backend, no STT/TTS. Persona (system prompt), voice, and model are set by
-the BUILDER on the CrowdPlay dashboard and apply from the next call.
+backend, no STT/TTS. Provider, model and API key are set by the BUILDER on
+the CrowdPlay dashboard, and so are the DEFAULT persona and voice.
+Per-join overrides (0.4.0+): the app MAY pass `agent` to join() to change
+the voice and the persona and give a short context text for one session:
+  await CrowdPlay.join({ displayName, roomCode, consent: grant,
+    agent: { voice: 'Aoede', context: "The user's name is Sam. Last time you practised past tense." } });
+voice must be one of the configured provider's voices (Gemini: Charon,
+Aoede, Fenrir, Kore, Puck; OpenAI: marin, cedar, alloy, ash, ballad,
+coral, echo, sage, shimmer, verse; Grok: Ara, Rex, Sal, Eve, Leo), unknown
+falls back to the dashboard voice. Caps: systemPrompt 8192 chars, context
+4000. The options of the join that CREATES the AI apply to the whole room;
+fixed for the session (leave and join again to change); provider, model
+and key cannot be changed from the app. MEMORY is built with `context`:
+keep a few sentences per user in the app's own storage and pass them at
+every join.
 Conversations are recorded and transcribed by the platform automatically.
 RECOMMENDED: voice-AI apps should be AUDIO-ONLY (audioOnly: true — no
 camera permission, no video anywhere); a camera adds nothing to talking

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "crowdplaysdk",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "description": "CrowdPlay lossless conversation capture for React Native (iOS). Studio-grade per-participant recording during live video calls, delivered to CrowdPlay automatically.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/src/index.ts

@@ -68,6 +68,29 @@ export interface ConsentGrant {
   grantedAtMs: number;
 }
 
+/**
+ * Per-join settings for the voice AI (D-095), for apps with the Voice AI
+ * switch on. The dashboard config stays the default; anything passed here
+ * overrides it for THIS session only. Fixed once the session starts (leave
+ * and join again to change). The options of the join that creates the AI
+ * apply to the whole room. The app can never change the provider, the
+ * model, or the API key from here.
+ */
+export interface AgentOptions {
+  /** A voice of the app's configured provider. Gemini: Charon, Aoede,
+   * Fenrir, Kore, Puck. OpenAI: marin, cedar, alloy, ash, ballad, coral,
+   * echo, sage, shimmer, verse. Grok: Ara, Rex, Sal, Eve, Leo. Unknown
+   * names fall back to the dashboard voice. */
+  voice?: string;
+  /** Replaces the dashboard persona for this session. Max 8192 chars. */
+  systemPrompt?: string;
+  /** Short text appended to the persona: what the app knows about this
+   * user, where they left off. This is how an app gives the AI memory:
+   * keep a few sentences per user in your own storage and pass them
+   * here. Max 4000 chars. */
+  context?: string;
+}
+
 export type Phase = 'idle' | 'connecting' | 'connected' | 'failed';
 
 export interface RecordingSnapshot {
@@ -144,7 +167,8 @@ export type CrowdPlayEventName = keyof CrowdPlayEvents;
 interface NativeCrowdPlay {
   configure(config: Record<string, unknown>): void;
   consentText(): Promise<string>;
-  join(displayName: string, roomCode: string, consentGrantedAtMs: number): Promise<void>;
+  join(displayName: string, roomCode: string, consentGrantedAtMs: number,
+       agent: Record<string, string> | null): Promise<void>;
   leave(): Promise<void>;
   setMicMuted(muted: boolean): Promise<void>;
   setCameraEnabled(enabled: boolean): Promise<void>;
@@ -220,11 +244,13 @@ const CrowdPlay = {
    * your own UI at the moment of agreement. There is no way to record
    * without it, here or natively.
    */
-  async join(options: { displayName: string; roomCode: string; consent: ConsentGrant }): Promise<void> {
+  async join(options: {
+    displayName: string; roomCode: string; consent: ConsentGrant; agent?: AgentOptions;
+  }): Promise<void> {
     if (!configured) {
       throw new Error('crowdplaysdk: call CrowdPlay.configure() before join()');
     }
-    const { displayName, roomCode, consent } = options ?? ({} as never);
+    const { displayName, roomCode, consent, agent } = options ?? ({} as never);
     if (!displayName?.trim()) throw new Error('crowdplaysdk: displayName is required');
     if (!roomCode?.trim()) throw new Error('crowdplaysdk: roomCode is required');
     if (!consent || typeof consent.grantedAtMs !== 'number' || consent.grantedAtMs <= 0) {
@@ -234,7 +260,19 @@ const CrowdPlay = {
           'Recording without consent is not supported.'
       );
     }
-    return native().join(displayName.trim(), roomCode, consent.grantedAtMs);
+    // Flat strings, clamped to the server's caps; blanks are not sent.
+    let agentFields: Record<string, string> | null = null;
+    if (agent && typeof agent === 'object') {
+      const put = (key: string, value: unknown, max: number) => {
+        if (typeof value === 'string' && value.trim()) {
+          agentFields = { ...(agentFields ?? {}), [key]: value.slice(0, max) };
+        }
+      };
+      put('voice', agent.voice, 60);
+      put('systemPrompt', agent.systemPrompt, 8192);
+      put('context', agent.context, 4000);
+    }
+    return native().join(displayName.trim(), roomCode, consent.grantedAtMs, agentFields);
   },
 
   /** Leave the room. Recording stops; uploads proceed automatically (they