@convai/web-sdk 1.8.0-beta.5 → 1.8.0-beta.7

package/dist/core/CharacterRoster.js

@@ -0,0 +1,348 @@
+const PROVISIONING_STATUSES = [
+    "dispatch_queued",
+    "dispatch_accepted",
+    "dispatch_failed",
+];
+/**
+ * Coerce a wire status into the closed union.
+ *
+ * An unrecognised value becomes `dispatch_queued`, the one state that promises
+ * nothing: it means "still working", so a client waits for `bot-ready` rather
+ * than acting. Mapping to `dispatch_accepted` would imply an actor exists, and
+ * to `dispatch_failed` would hide a member that is actually coming up.
+ */
+function toProvisioningStatus(value) {
+    return typeof value === "string" && PROVISIONING_STATUSES.includes(value)
+        ? value
+        : "dispatch_queued";
+}
+/**
+ * Convert a wire entry into an instance, or null when it cannot be attributed.
+ *
+ * A member with no `membership_id` is unaddressable: it cannot be targeted,
+ * removed, or matched to a participant. The contract's rule throughout is to
+ * fail closed rather than guess, so it is dropped instead of being given a
+ * synthesised id that would later collide.
+ */
+function toInstance(raw) {
+    if (!raw?.membership_id)
+        return null;
+    return {
+        membershipId: raw.membership_id,
+        characterId: raw.character_id ?? "",
+        sessionId: raw.session_id ?? null,
+        characterSessionId: raw.character_session_id ?? null,
+        // Identity is derivable and always `character:{membership_id}`. Falling
+        // back to it is safe; falling back to a positional name or a LiveKit SID
+        // would not be, so those are never used.
+        participantIdentity: raw.participant_identity || `character:${raw.membership_id}`,
+        isInitial: raw.is_initial === true,
+        provisioningStatus: toProvisioningStatus(raw.provisioning_status),
+        displayName: raw.display_name ?? null,
+        description: raw.description ?? null,
+        failureCode: raw.failure_code ?? null,
+        isReady: false,
+    };
+}
+export class CharacterRoster {
+    constructor() {
+        this._characters = [];
+        this._activeMembershipId = null;
+        this._roomSessionId = null;
+        this._roomName = null;
+        this._requestTraceId = null;
+        this._routeEpoch = 0;
+        this._rosterEpoch = 0;
+        this._partialDispatch = false;
+    }
+    /** Character instances in roster order. Empty in single-character mode. */
+    get characters() {
+        return this._characters;
+    }
+    /** Membership currently receiving user turns, or null. */
+    get activeMembershipId() {
+        return this._activeMembershipId;
+    }
+    get roomSessionId() {
+        return this._roomSessionId;
+    }
+    get routeEpoch() {
+        return this._routeEpoch;
+    }
+    get rosterEpoch() {
+        return this._rosterEpoch;
+    }
+    /** True once a multi-character connect response has been applied. */
+    get isMultiCharacter() {
+        return this._characters.length > 0;
+    }
+    /** The server-owned snapshot, or null for a single-character session. */
+    get roomSession() {
+        if (!this._roomSessionId)
+            return null;
+        return {
+            roomSessionId: this._roomSessionId,
+            roomName: this._roomName,
+            requestTraceId: this._requestTraceId,
+            activeMembershipId: this._activeMembershipId,
+            routeEpoch: this._routeEpoch,
+            rosterEpoch: this._rosterEpoch,
+            partialDispatch: this._partialDispatch,
+            characters: this._characters,
+        };
+    }
+    find(membershipId) {
+        return this._characters.find((c) => c.membershipId === membershipId);
+    }
+    /** Members that have sent their own `bot-ready`. */
+    get readyCharacters() {
+        return this._characters.filter((c) => c.isReady);
+    }
+    /**
+     * Mark a member ready from its own `bot-ready`, filling in any detail the
+     * connect response did not yet have.
+     *
+     * Returns whether anything changed, so the caller only pushes state when it
+     * did. A single-character `bot-ready` also carries these fields, so nothing
+     * is tracked until a roster is actually seeded.
+     */
+    applyBotReady(about) {
+        if (!about || !this.isMultiCharacter)
+            return false;
+        const incoming = toInstance(about);
+        if (!incoming)
+            return false;
+        const index = this._characters.findIndex((c) => c.membershipId === incoming.membershipId);
+        if (index === -1) {
+            // A member added at runtime announces itself this way.
+            this._characters = [...this._characters, { ...incoming, isReady: true }];
+            return true;
+        }
+        const existing = this._characters[index];
+        const merged = {
+            ...existing,
+            characterSessionId: incoming.characterSessionId ?? existing.characterSessionId,
+            sessionId: incoming.sessionId ?? existing.sessionId,
+            displayName: incoming.displayName ?? existing.displayName,
+            participantIdentity: incoming.participantIdentity || existing.participantIdentity,
+            isReady: true,
+        };
+        if (existing.isReady &&
+            merged.characterSessionId === existing.characterSessionId &&
+            merged.sessionId === existing.sessionId &&
+            merged.participantIdentity === existing.participantIdentity) {
+            return false;
+        }
+        this._characters = [
+            ...this._characters.slice(0, index),
+            merged,
+            ...this._characters.slice(index + 1),
+        ];
+        return true;
+    }
+    /**
+     * Apply a `character-status` transition. Readiness recorded here is
+     * bookkeeping for replacement selection; `bot-ready` remains what gates
+     * interaction.
+     */
+    applyCharacterStatus(status) {
+        const index = this._characters.findIndex((c) => c.membershipId === status.membershipId);
+        if (index === -1)
+            return false;
+        const existing = this._characters[index];
+        const next = {
+            ...existing,
+            ...(status.status === "failed"
+                ? {
+                    provisioningStatus: "dispatch_failed",
+                    failureCode: status.failureCode ?? existing.failureCode,
+                    isReady: false,
+                }
+                : {}),
+        };
+        if (next.provisioningStatus === existing.provisioningStatus &&
+            next.failureCode === existing.failureCode &&
+            next.isReady === existing.isReady) {
+            return false;
+        }
+        this._characters = [
+            ...this._characters.slice(0, index),
+            next,
+            ...this._characters.slice(index + 1),
+        ];
+        if (status.status === "failed")
+            this._partialDispatch = true;
+        return true;
+    }
+    /**
+     * Pick a member to take over routing when the active one is removed.
+     *
+     * The runtime refuses a replacement that has not sent `bot-ready`
+     * (`replacement_target_unavailable`), so ready survivors come first. Falling
+     * back to any survivor at least produces a nameable rejection rather than
+     * `replacement_target_required`.
+     */
+    pickReplacement(removing) {
+        const removed = new Set(removing);
+        const survivors = this._characters.filter((c) => !removed.has(c.membershipId));
+        return (survivors.find((c) => c.isReady)?.membershipId ?? survivors[0]?.membershipId);
+    }
+    /** Payload that switches the active member. */
+    buildInteractionTarget(membershipId, commandId) {
+        return {
+            room_session_id: this._roomSessionId,
+            target_membership_id: membershipId,
+            expected_route_epoch: this._routeEpoch,
+            command_id: commandId,
+        };
+    }
+    /** Payload that adds and removes members. */
+    buildRosterUpdate(options, commandId) {
+        const add = (options.add ?? []).map((spec) => ({
+            character_id: spec.characterId.trim(),
+            ...(spec.characterSessionId
+                ? { character_session_id: spec.characterSessionId }
+                : {}),
+        }));
+        return {
+            room_session_id: this._roomSessionId,
+            expected_roster_epoch: this._rosterEpoch,
+            command_id: commandId,
+            ...(add.length > 0 && { add }),
+            ...(options.remove?.length && { remove_membership_ids: options.remove }),
+            ...(options.replacementTarget && {
+                replacement_target_membership_id: options.replacementTarget,
+            }),
+        };
+    }
+    /**
+     * Adopt the server's authoritative epochs and active member from any
+     * response, errors included.
+     *
+     * A `stale_route_epoch` rejection carries the real epoch, and adopting it is
+     * precisely what makes the single retry meaningful rather than a repeat of
+     * the same losing bet.
+     */
+    adoptEpochs(extras) {
+        if (!extras)
+            return;
+        if (typeof extras.route_epoch === "number")
+            this._routeEpoch = extras.route_epoch;
+        if (typeof extras.roster_epoch === "number")
+            this._rosterEpoch = extras.roster_epoch;
+        if (extras.active_membership_id !== undefined) {
+            this._activeMembershipId = extras.active_membership_id ?? null;
+        }
+    }
+    /**
+     * Apply a successful `interaction-target` ack. Returns the change even when
+     * the target did not move, so a caller awaiting the promise always learns the
+     * authoritative state.
+     */
+    applyInteractionTarget(extras) {
+        const previous = extras?.previous_membership_id !== undefined
+            ? extras.previous_membership_id
+            : this._activeMembershipId;
+        this.adoptEpochs(extras);
+        return {
+            previous: previous ?? null,
+            active: this._activeMembershipId,
+            routeEpoch: this._routeEpoch,
+        };
+    }
+    /** Apply a successful `character-roster-update` ack, mutating the roster. */
+    applyRosterUpdate(extras) {
+        const added = (Array.isArray(extras?.added) ? extras.added : [])
+            .map((c) => toInstance(c))
+            .filter((c) => c !== null);
+        const removedIds = new Set(Array.isArray(extras?.removed_membership_ids)
+            ? extras.removed_membership_ids
+            : []);
+        // Prefer the roster's own record of a removed member: the ack echoes only
+        // its id, and the caller wants the instance it had been rendering.
+        const removed = [...removedIds].map((id) => this.find(id) ?? {
+            membershipId: id,
+            characterId: "",
+            sessionId: null,
+            characterSessionId: null,
+            participantIdentity: `character:${id}`,
+            isInitial: false,
+            provisioningStatus: "dispatch_failed",
+            displayName: null,
+            description: null,
+            failureCode: null,
+            isReady: false,
+        });
+        const addedIds = new Set(added.map((c) => c.membershipId));
+        this._characters = [
+            ...this._characters.filter((c) => !removedIds.has(c.membershipId) && !addedIds.has(c.membershipId)),
+            ...added,
+        ];
+        this.adoptEpochs(extras);
+        // A removal can retire the member that was active; the ack names the
+        // survivor, and adoptEpochs has already taken it.
+        if (this._activeMembershipId &&
+            !this.find(this._activeMembershipId)) {
+            this._activeMembershipId = this._characters[0]?.membershipId ?? null;
+        }
+        return {
+            added,
+            removed,
+            characters: this._characters,
+            rosterEpoch: this._rosterEpoch,
+            routeEpoch: this._routeEpoch,
+            activeMembershipId: this._activeMembershipId,
+        };
+    }
+    reset() {
+        this._characters = [];
+        this._activeMembershipId = null;
+        this._roomSessionId = null;
+        this._roomName = null;
+        this._requestTraceId = null;
+        this._routeEpoch = 0;
+        this._rosterEpoch = 0;
+        this._partialDispatch = false;
+    }
+    /**
+     * Seed the roster from a `/connect` response, for either a create or a join.
+     *
+     * Returns false for a response with no `characters` array — that is an
+     * ordinary single-character session, and the roster stays empty so
+     * `isMultiCharacter` keeps distinguishing the two.
+     */
+    applyConnectResponse(data) {
+        const raw = data?.characters;
+        if (!Array.isArray(raw) || raw.length === 0)
+            return false;
+        const characters = raw
+            .map((c) => toInstance(c))
+            .filter((c) => c !== null);
+        if (characters.length === 0)
+            return false;
+        this._characters = characters;
+        this._roomSessionId = asString(data.room_session_id);
+        this._roomName = asString(data.room_name);
+        this._requestTraceId = asString(data.request_trace_id);
+        // The server names the active member. Falling back to the initial entry,
+        // then to position zero, matches the rule that `characters[0]` is initial.
+        this._activeMembershipId =
+            asString(data.active_membership_id) ??
+                characters.find((c) => c.isInitial)?.membershipId ??
+                characters[0]?.membershipId ??
+                null;
+        this._routeEpoch = asNumber(data.route_epoch) ?? 0;
+        this._rosterEpoch = asNumber(data.roster_epoch) ?? 0;
+        this._partialDispatch =
+            data.partial_dispatch === true ||
+                characters.some((c) => c.provisioningStatus === "dispatch_failed");
+        return true;
+    }
+}
+function asString(value) {
+    return typeof value === "string" && value ? value : null;
+}
+function asNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+//# sourceMappingURL=CharacterRoster.js.map

package/dist/core/CharacterRoster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CharacterRoster.js","sourceRoot":"","sources":["../../src/core/CharacterRoster.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ActiveCharacterChange,\n  CharacterProvisioningStatus,\n  CharacterRosterChange,\n  ConvaiCharacterInstance,\n  ConvaiCharacterSpec,\n  ConvaiRoomSession,\n  ServerResponseExtras,\n  UpdateCharacterRosterOptions,\n} from \"./types\";\n\n/**\n * Roster state for a multi-character room: which character instances exist,\n * which one receives user turns, and the epochs that fence concurrent changes.\n *\n * Pure state — it owns no transport. `ConvaiClient` feeds it from the connect\n * response, from per-instance readiness events, and from server acks, and\n * publishes whatever commands it builds.\n *\n * Slice A populates the read half below. Roster mutation (`interaction-target`,\n * `character-roster-update`) grows this same class rather than a second home\n * for the same state.\n */\n\n/** A roster entry as it appears on the wire, in any of the places it appears. */\ninterface RawCharacter {\n  membership_id?: string;\n  character_id?: string;\n  session_id?: string | null;\n  character_session_id?: string | null;\n  participant_identity?: string;\n  is_initial?: boolean;\n  provisioning_status?: string;\n  failure_code?: string | null;\n  display_name?: string | null;\n  description?: string | null;\n}\n\nconst PROVISIONING_STATUSES: readonly string[] = [\n  \"dispatch_queued\",\n  \"dispatch_accepted\",\n  \"dispatch_failed\",\n];\n\n/**\n * Coerce a wire status into the closed union.\n *\n * An unrecognised value becomes `dispatch_queued`, the one state that promises\n * nothing: it means \"still working\", so a client waits for `bot-ready` rather\n * than acting. Mapping to `dispatch_accepted` would imply an actor exists, and\n * to `dispatch_failed` would hide a member that is actually coming up.\n */\nfunction toProvisioningStatus(value: unknown): CharacterProvisioningStatus {\n  return typeof value === \"string\" && PROVISIONING_STATUSES.includes(value)\n    ? (value as CharacterProvisioningStatus)\n    : \"dispatch_queued\";\n}\n\n/**\n * Convert a wire entry into an instance, or null when it cannot be attributed.\n *\n * A member with no `membership_id` is unaddressable: it cannot be targeted,\n * removed, or matched to a participant. The contract's rule throughout is to\n * fail closed rather than guess, so it is dropped instead of being given a\n * synthesised id that would later collide.\n */\nfunction toInstance(raw: RawCharacter | undefined): ConvaiCharacterInstance | null {\n  if (!raw?.membership_id) return null;\n  return {\n    membershipId: raw.membership_id,\n    characterId: raw.character_id ?? \"\",\n    sessionId: raw.session_id ?? null,\n    characterSessionId: raw.character_session_id ?? null,\n    // Identity is derivable and always `character:{membership_id}`. Falling\n    // back to it is safe; falling back to a positional name or a LiveKit SID\n    // would not be, so those are never used.\n    participantIdentity:\n      raw.participant_identity || `character:${raw.membership_id}`,\n    isInitial: raw.is_initial === true,\n    provisioningStatus: toProvisioningStatus(raw.provisioning_status),\n    displayName: raw.display_name ?? null,\n    description: raw.description ?? null,\n    failureCode: raw.failure_code ?? null,\n    isReady: false,\n  };\n}\n\nexport class CharacterRoster {\n  private _characters: ConvaiCharacterInstance[] = [];\n  private _activeMembershipId: string | null = null;\n  private _roomSessionId: string | null = null;\n  private _roomName: string | null = null;\n  private _requestTraceId: string | null = null;\n  private _routeEpoch = 0;\n  private _rosterEpoch = 0;\n  private _partialDispatch = false;\n\n  /** Character instances in roster order. Empty in single-character mode. */\n  get characters(): ConvaiCharacterInstance[] {\n    return this._characters;\n  }\n\n  /** Membership currently receiving user turns, or null. */\n  get activeMembershipId(): string | null {\n    return this._activeMembershipId;\n  }\n\n  get roomSessionId(): string | null {\n    return this._roomSessionId;\n  }\n\n  get routeEpoch(): number {\n    return this._routeEpoch;\n  }\n\n  get rosterEpoch(): number {\n    return this._rosterEpoch;\n  }\n\n  /** True once a multi-character connect response has been applied. */\n  get isMultiCharacter(): boolean {\n    return this._characters.length > 0;\n  }\n\n  /** The server-owned snapshot, or null for a single-character session. */\n  get roomSession(): ConvaiRoomSession | null {\n    if (!this._roomSessionId) return null;\n    return {\n      roomSessionId: this._roomSessionId,\n      roomName: this._roomName,\n      requestTraceId: this._requestTraceId,\n      activeMembershipId: this._activeMembershipId,\n      routeEpoch: this._routeEpoch,\n      rosterEpoch: this._rosterEpoch,\n      partialDispatch: this._partialDispatch,\n      characters: this._characters,\n    };\n  }\n\n  find(membershipId: string): ConvaiCharacterInstance | undefined {\n    return this._characters.find((c) => c.membershipId === membershipId);\n  }\n\n  /** Members that have sent their own `bot-ready`. */\n  get readyCharacters(): ConvaiCharacterInstance[] {\n    return this._characters.filter((c) => c.isReady);\n  }\n\n  /**\n   * Mark a member ready from its own `bot-ready`, filling in any detail the\n   * connect response did not yet have.\n   *\n   * Returns whether anything changed, so the caller only pushes state when it\n   * did. A single-character `bot-ready` also carries these fields, so nothing\n   * is tracked until a roster is actually seeded.\n   */\n  applyBotReady(about: Record<string, unknown> | undefined): boolean {\n    if (!about || !this.isMultiCharacter) return false;\n    const incoming = toInstance(about as RawCharacter);\n    if (!incoming) return false;\n\n    const index = this._characters.findIndex(\n      (c) => c.membershipId === incoming.membershipId,\n    );\n    if (index === -1) {\n      // A member added at runtime announces itself this way.\n      this._characters = [...this._characters, { ...incoming, isReady: true }];\n      return true;\n    }\n\n    const existing = this._characters[index]!;\n    const merged: ConvaiCharacterInstance = {\n      ...existing,\n      characterSessionId:\n        incoming.characterSessionId ?? existing.characterSessionId,\n      sessionId: incoming.sessionId ?? existing.sessionId,\n      displayName: incoming.displayName ?? existing.displayName,\n      participantIdentity:\n        incoming.participantIdentity || existing.participantIdentity,\n      isReady: true,\n    };\n    if (\n      existing.isReady &&\n      merged.characterSessionId === existing.characterSessionId &&\n      merged.sessionId === existing.sessionId &&\n      merged.participantIdentity === existing.participantIdentity\n    ) {\n      return false;\n    }\n    this._characters = [\n      ...this._characters.slice(0, index),\n      merged,\n      ...this._characters.slice(index + 1),\n    ];\n    return true;\n  }\n\n  /**\n   * Apply a `character-status` transition. Readiness recorded here is\n   * bookkeeping for replacement selection; `bot-ready` remains what gates\n   * interaction.\n   */\n  applyCharacterStatus(status: {\n    membershipId: string;\n    status: \"starting\" | \"ready\" | \"failed\";\n    failureCode: string | null;\n  }): boolean {\n    const index = this._characters.findIndex(\n      (c) => c.membershipId === status.membershipId,\n    );\n    if (index === -1) return false;\n    const existing = this._characters[index]!;\n\n    const next: ConvaiCharacterInstance = {\n      ...existing,\n      ...(status.status === \"failed\"\n        ? {\n            provisioningStatus: \"dispatch_failed\" as const,\n            failureCode: status.failureCode ?? existing.failureCode,\n            isReady: false,\n          }\n        : {}),\n    };\n    if (\n      next.provisioningStatus === existing.provisioningStatus &&\n      next.failureCode === existing.failureCode &&\n      next.isReady === existing.isReady\n    ) {\n      return false;\n    }\n    this._characters = [\n      ...this._characters.slice(0, index),\n      next,\n      ...this._characters.slice(index + 1),\n    ];\n    if (status.status === \"failed\") this._partialDispatch = true;\n    return true;\n  }\n\n  /**\n   * Pick a member to take over routing when the active one is removed.\n   *\n   * The runtime refuses a replacement that has not sent `bot-ready`\n   * (`replacement_target_unavailable`), so ready survivors come first. Falling\n   * back to any survivor at least produces a nameable rejection rather than\n   * `replacement_target_required`.\n   */\n  pickReplacement(removing: string[]): string | undefined {\n    const removed = new Set(removing);\n    const survivors = this._characters.filter(\n      (c) => !removed.has(c.membershipId),\n    );\n    return (\n      survivors.find((c) => c.isReady)?.membershipId ?? survivors[0]?.membershipId\n    );\n  }\n\n  /** Payload that switches the active member. */\n  buildInteractionTarget(\n    membershipId: string | null,\n    commandId: string,\n  ): Record<string, unknown> {\n    return {\n      room_session_id: this._roomSessionId,\n      target_membership_id: membershipId,\n      expected_route_epoch: this._routeEpoch,\n      command_id: commandId,\n    };\n  }\n\n  /** Payload that adds and removes members. */\n  buildRosterUpdate(\n    options: UpdateCharacterRosterOptions,\n    commandId: string,\n  ): Record<string, unknown> {\n    const add = (options.add ?? []).map((spec: ConvaiCharacterSpec) => ({\n      character_id: spec.characterId.trim(),\n      ...(spec.characterSessionId\n        ? { character_session_id: spec.characterSessionId }\n        : {}),\n    }));\n    return {\n      room_session_id: this._roomSessionId,\n      expected_roster_epoch: this._rosterEpoch,\n      command_id: commandId,\n      ...(add.length > 0 && { add }),\n      ...(options.remove?.length && { remove_membership_ids: options.remove }),\n      ...(options.replacementTarget && {\n        replacement_target_membership_id: options.replacementTarget,\n      }),\n    };\n  }\n\n  /**\n   * Adopt the server's authoritative epochs and active member from any\n   * response, errors included.\n   *\n   * A `stale_route_epoch` rejection carries the real epoch, and adopting it is\n   * precisely what makes the single retry meaningful rather than a repeat of\n   * the same losing bet.\n   */\n  adoptEpochs(extras: ServerResponseExtras | null | undefined): void {\n    if (!extras) return;\n    if (typeof extras.route_epoch === \"number\") this._routeEpoch = extras.route_epoch;\n    if (typeof extras.roster_epoch === \"number\") this._rosterEpoch = extras.roster_epoch;\n    if (extras.active_membership_id !== undefined) {\n      this._activeMembershipId = (extras.active_membership_id as string) ?? null;\n    }\n  }\n\n  /**\n   * Apply a successful `interaction-target` ack. Returns the change even when\n   * the target did not move, so a caller awaiting the promise always learns the\n   * authoritative state.\n   */\n  applyInteractionTarget(\n    extras: ServerResponseExtras | null | undefined,\n  ): ActiveCharacterChange {\n    const previous =\n      extras?.previous_membership_id !== undefined\n        ? (extras.previous_membership_id as string | null)\n        : this._activeMembershipId;\n    this.adoptEpochs(extras);\n    return {\n      previous: previous ?? null,\n      active: this._activeMembershipId,\n      routeEpoch: this._routeEpoch,\n    };\n  }\n\n  /** Apply a successful `character-roster-update` ack, mutating the roster. */\n  applyRosterUpdate(\n    extras: ServerResponseExtras | null | undefined,\n  ): CharacterRosterChange {\n    const added = (Array.isArray(extras?.added) ? extras!.added : [])\n      .map((c) => toInstance(c as RawCharacter))\n      .filter((c): c is ConvaiCharacterInstance => c !== null);\n\n    const removedIds = new Set<string>(\n      Array.isArray(extras?.removed_membership_ids)\n        ? (extras!.removed_membership_ids as string[])\n        : [],\n    );\n    // Prefer the roster's own record of a removed member: the ack echoes only\n    // its id, and the caller wants the instance it had been rendering.\n    const removed = [...removedIds].map(\n      (id) =>\n        this.find(id) ?? {\n          membershipId: id,\n          characterId: \"\",\n          sessionId: null,\n          characterSessionId: null,\n          participantIdentity: `character:${id}`,\n          isInitial: false,\n          provisioningStatus: \"dispatch_failed\" as const,\n          displayName: null,\n          description: null,\n          failureCode: null,\n          isReady: false,\n        },\n    );\n\n    const addedIds = new Set(added.map((c) => c.membershipId));\n    this._characters = [\n      ...this._characters.filter(\n        (c) => !removedIds.has(c.membershipId) && !addedIds.has(c.membershipId),\n      ),\n      ...added,\n    ];\n    this.adoptEpochs(extras);\n    // A removal can retire the member that was active; the ack names the\n    // survivor, and adoptEpochs has already taken it.\n    if (\n      this._activeMembershipId &&\n      !this.find(this._activeMembershipId)\n    ) {\n      this._activeMembershipId = this._characters[0]?.membershipId ?? null;\n    }\n    return {\n      added,\n      removed,\n      characters: this._characters,\n      rosterEpoch: this._rosterEpoch,\n      routeEpoch: this._routeEpoch,\n      activeMembershipId: this._activeMembershipId,\n    };\n  }\n\n  reset(): void {\n    this._characters = [];\n    this._activeMembershipId = null;\n    this._roomSessionId = null;\n    this._roomName = null;\n    this._requestTraceId = null;\n    this._routeEpoch = 0;\n    this._rosterEpoch = 0;\n    this._partialDispatch = false;\n  }\n\n  /**\n   * Seed the roster from a `/connect` response, for either a create or a join.\n   *\n   * Returns false for a response with no `characters` array — that is an\n   * ordinary single-character session, and the roster stays empty so\n   * `isMultiCharacter` keeps distinguishing the two.\n   */\n  applyConnectResponse(data: Record<string, unknown>): boolean {\n    const raw = data?.characters;\n    if (!Array.isArray(raw) || raw.length === 0) return false;\n\n    const characters = raw\n      .map((c) => toInstance(c as RawCharacter))\n      .filter((c): c is ConvaiCharacterInstance => c !== null);\n    if (characters.length === 0) return false;\n\n    this._characters = characters;\n    this._roomSessionId = asString(data.room_session_id);\n    this._roomName = asString(data.room_name);\n    this._requestTraceId = asString(data.request_trace_id);\n    // The server names the active member. Falling back to the initial entry,\n    // then to position zero, matches the rule that `characters[0]` is initial.\n    this._activeMembershipId =\n      asString(data.active_membership_id) ??\n      characters.find((c) => c.isInitial)?.membershipId ??\n      characters[0]?.membershipId ??\n      null;\n    this._routeEpoch = asNumber(data.route_epoch) ?? 0;\n    this._rosterEpoch = asNumber(data.roster_epoch) ?? 0;\n    this._partialDispatch =\n      data.partial_dispatch === true ||\n      characters.some((c) => c.provisioningStatus === \"dispatch_failed\");\n    return true;\n  }\n}\n\nfunction asString(value: unknown): string | null {\n  return typeof value === \"string\" && value ? value : null;\n}\n\nfunction asNumber(value: unknown): number | null {\n  return typeof value === \"number\" && Number.isFinite(value) ? value : null;\n}\n"]}

package/dist/core/ConvaiClient.d.ts

@@ -1,10 +1,28 @@
 import { Room } from "livekit-client";
-import { ConvaiConfig, ConvaiClientState, ChatMessage, IConvaiClient, AudioControls, VideoControls, ScreenShareControls, DynamicInfo, ContextUpdateOptions, UploadFileOptions, WebSocketSessionFactory, RespondModeUpdateOptions, UpdateSceneMetadataOptions, VisionStatusOptions, VisionTriggerOptions, ConnectionData, SendUserTextMessageOptions } from "./types.js";
+import { ConvaiConfig, ConvaiClientState, ChatMessage, IConvaiClient, PublishedChatConnectOptions, AudioControls, VideoControls, ScreenShareControls, DynamicInfo, ContextUpdateOptions, UploadFileOptions, ServerResponse, WebSocketSessionFactory, RespondModeUpdateOptions, UpdateSceneMetadataOptions, VisionStatusOptions, VisionTriggerOptions, ConnectionData, SendUserTextMessageOptions, ConvaiCharacterInstance, ConvaiRoomSession, JoinRoomOptions, ActiveCharacterChange, CharacterRosterChange, UpdateCharacterRosterOptions, AppendMessageOptions, ConvaiEventMap, ActionResult, ActionResultAck, ActionResultAckFailureReason, ActionResultAckOptions } from "./types.js";
 import { EventEmitter } from "./EventEmitter.js";
 import { BlendshapeQueue } from "./BlendshapeQueue.js";
 import { MemoryManager } from "./MemoryManager.js";
 import { CharacterVersionManager } from "./CharacterVersionManager.js";
 import { type CharacterVersionSelector } from "./characterReference.js";
+/**
+ * Rejection from {@link ConvaiClient.sendActionResultAndWait} after local
+ * validation succeeds. Inspect `reason` rather than parsing the message.
+ */
+export declare class ActionResultAckError extends Error {
+    readonly reason: ActionResultAckFailureReason;
+    readonly toolCallId: string;
+    readonly errorCode?: string;
+    readonly response?: ServerResponse;
+    readonly cause?: unknown;
+    constructor(message: string, options: {
+        reason: ActionResultAckFailureReason;
+        toolCallId: string;
+        errorCode?: string;
+        response?: ServerResponse;
+        cause?: unknown;
+    });
+}
 /**
  * Main Convai client class for managing AI voice assistant connections
  * Provides complete interface for connecting to Convai's voice assistants,
@@ -53,6 +71,12 @@ export declare class ConvaiClient extends EventEmitter implements IConvaiClient
     private _characterVersionManager;
     private _characterVersionManagerKey;
     private _characterSessionId;
+    /** Roster state for multi-character rooms. Empty for single-character sessions. */
+    private _roster;
+    /** Roster commands awaiting their ack, keyed by command id. */
+    private _pendingRosterCommands;
+    private _rosterCommandSeq;
+    private _requestTraceId;
     private _isBotReady;
     private _participantSid;
     private _audioSettings;
@@ -69,11 +93,14 @@ export declare class ConvaiClient extends EventEmitter implements IConvaiClient
     private _sseSession;
     private _logRtviMessages;
     private _isDisconnecting;
+    private _isPublishedChatSession;
     private _clientReadyRetryTimer;
     private _clientReadyTimeoutTimer;
     private _clientReadyMsgId;
+    private _pendingActionResultAcks;
     private static readonly CLIENT_READY_RETRY_MS;
     private static readonly CLIENT_READY_TIMEOUT_MS;
+    private static readonly ACTION_RESULT_ACK_TIMEOUT_MS;
     /**
      * Register the WebSocket transport factory. Called automatically as a side-effect
      * when you import `@convai/web-sdk/vanilla/websocket` (or the react equivalent).
@@ -90,7 +117,8 @@ export declare class ConvaiClient extends EventEmitter implements IConvaiClient
     private _memoryManager;
     constructor(config?: ConvaiConfig);
     get state(): ConvaiClientState;
-    get connectionType(): "audio" | "video" | null;
+    get connectionType(): "audio" | "video" | "text" | null;
+    get isPublishedChatSession(): boolean;
     get apiKey(): string | null;
     get authToken(): string | null;
     get characterId(): string | null;
@@ -107,6 +135,36 @@ export declare class ConvaiClient extends EventEmitter implements IConvaiClient
     get chatMessages(): ChatMessage[];
     get userTranscription(): string;
     get characterSessionId(): string | null;
+    /**
+     * Subscribe to a client event. Typed against {@link ConvaiEventMap}, so a
+     * listener for a known event gets its payload inferred instead of `any`.
+     * The plain-string form is kept so existing callers and dynamic event names
+     * still build -- which also means a misspelt literal is not a compile error.
+     */
+    on<E extends keyof ConvaiEventMap>(event: E, callback: (...args: ConvaiEventMap[E]) => void): () => void;
+    on(event: string, callback: (...args: any[]) => void): () => void;
+    /**
+     * Server-owned snapshot of a multi-character room, or null for a
+     * single-character session. Carries the room id, epochs and roster.
+     */
+    get roomSession(): ConvaiRoomSession | null;
+    /**
+     * Character instances in a multi-character room, in roster order. Empty for a
+     * single-character session, so `length` distinguishes the two.
+     */
+    get characters(): ConvaiCharacterInstance[];
+    /** Membership currently receiving user turns, or null. */
+    get activeMembershipId(): string | null;
+    /**
+     * Start or stop the server streaming per-turn usage/cost breakdowns as
+     * `usageUpdate` events. Informational only; server-side usage tracking and
+     * billing are unaffected either way.
+     */
+    toggleUsageUpdates(enabled: boolean): void;
+    /** Insert a transcript line locally. Nothing is sent; nothing is billed. */
+    appendMessage(message: AppendMessageOptions): ChatMessage;
+    /** Trace id of the /connect that produced this session; quote it to backend support. */
+    get requestTraceId(): string | null;
     get isBotReady(): boolean;
     get audioControls(): AudioControls;
     get videoControls(): VideoControls;
@@ -134,6 +192,11 @@ export declare class ConvaiClient extends EventEmitter implements IConvaiClient
      * For WebSocket: sends via PipecatClient.sendClientMessage (wrapped in {t,d} envelope).
      */
     private publishMessage;
+    /**
+     * Publish exactly one message while retaining the transport's local completion
+     * signal. Server acceptance is still proved separately by `serverResponse`.
+     */
+    private publishMessageAndWaitForLocalPublication;
     /**
      * Returns true when a message can be sent on the active transport.
      */
@@ -162,6 +225,74 @@ export declare class ConvaiClient extends EventEmitter implements IConvaiClient
      * await client.connectWithConnectionData(data)
      */
     connectWithConnectionData(data: ConnectionData, config?: ConvaiConfig): Promise<void>;
+    /**
+     * How long to wait for a roster command's ack.
+     *
+     * A timeout is *not* a failure. Every character participant observes the
+     * broadcast and duplicate forwards are response-suppressed after one actor
+     * answers, so a lost ack is an expected outcome. The contract's rule is to
+     * treat it as unknown and reconcile from the next authoritative snapshot,
+     * which is what the rejection below tells the caller to do.
+     */
+    private static readonly ROSTER_COMMAND_TIMEOUT_MS;
+    /** Correlate roster acks back to the promise that issued the command. */
+    private _handleRosterServerResponse;
+    /**
+     * Settle every in-flight roster command.
+     *
+     * Without this a caller who disconnects mid-command keeps a live 10s timer
+     * and gets a rejection long after the session ended -- an unhandled rejection
+     * if they stopped awaiting when they tore the client down. The roster is
+     * reset alongside, so the command could not be applied meaningfully anyway.
+     */
+    private _failPendingRosterCommands;
+    private _pushRosterState;
+    /** Publish a roster command and settle when its ack arrives. */
+    private _sendRosterCommand;
+    /**
+     * Route subsequent user turns to a different character instance.
+     *
+     * Pass null to close every gate, so no member consumes the user until a
+     * target is set again.
+     */
+    setInteractionTarget(membershipId: string | null): Promise<ActiveCharacterChange>;
+    /** Add or remove character instances on a live room, without reconnecting. */
+    updateCharacterRoster(options: UpdateCharacterRosterOptions): Promise<CharacterRosterChange>;
+    /** Default bounded retry while a roster room is still provisioning. */
+    private static readonly ROSTER_RETRY_ATTEMPTS;
+    private static readonly ROSTER_RETRY_INITIAL_MS;
+    /**
+     * Run a room request, retrying only the conflicts that mean "still working".
+     *
+     * The runtime answers a create that collides with an in-flight identical
+     * create with 409 `ROSTER_PROVISIONING_IN_PROGRESS`, and the documented
+     * recovery is to retry the same key with bounded backoff. Left to callers,
+     * every integration reimplements that, usually without a cap. The payload is
+     * replayed verbatim -- changing it would turn the retry into a fingerprint
+     * mismatch.
+     */
+    private _withProvisioningRetry;
+    /**
+     * Join a multi-character room that already exists.
+     *
+     * A join supplies a locator and the joining human, and nothing else: the
+     * roster is server-owned, so resending topology is rejected. It never spawns,
+     * removes or repairs a character -- only room creation does that.
+     *
+     * Capacity counts distinct speakers derived from `endUserId`, and defaults to
+     * one, so raise `maxNumParticipants` at creation before expecting a second
+     * human to get in.
+     *
+     * @example
+     * ```ts
+     * const client = new ConvaiClient({ apiKey: 'YOUR_API_KEY' })
+     * await client.joinRoom({
+     *   roomSessionId: 'the-room-session-id',
+     *   endUserId: 'player-99',
+     * })
+     * ```
+     */
+    joinRoom(options: JoinRoomOptions): Promise<void>;
     /**
      * Add default URL, apply RTVI-logging config, and validate that either an
      * API key or auth token plus a character ID are present.
@@ -182,6 +313,14 @@ export declare class ConvaiClient extends EventEmitter implements IConvaiClient
      */
     private consumeConnectionData;
     private cleanupWebSocketSessionAfterConnectFailure;
+    /**
+     * Connect to a published text-chat revision without publisher credentials.
+     *
+     * The launch grant is single-use and is never retained for reconnect. This
+     * path is LiveKit data-only: it does not enable microphone, camera, TTS,
+     * video, or lipsync.
+     */
+    connectWithPublicationGrant(launchToken: string, options?: PublishedChatConnectOptions): Promise<void>;
     /**
      * RTVI client-ready handshake. Server-side gates bot-ready emission on
      * receipt of client-ready (and re-emits bot-ready on every client-ready),
@@ -210,6 +349,17 @@ export declare class ConvaiClient extends EventEmitter implements IConvaiClient
      * Send a text message to the character
      */
     sendUserTextMessage(text: string, options?: SendUserTextMessageOptions): void;
+    /**
+     * Return a correlated terminal result for a client-executed tool call.
+     */
+    sendActionResult(result: ActionResult): void;
+    /**
+     * Publish one correlated terminal result and wait for Core's exact
+     * `server-response` acknowledgement. This method performs one publication;
+     * callers own any idempotent retry policy.
+     */
+    sendActionResultAndWait(result: ActionResult, options?: ActionResultAckOptions): Promise<ActionResultAck>;
+    private buildActionResultPayload;
     /**
      * Send a trigger message to invoke specific character actions
      */

package/dist/core/ConvaiClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConvaiClient.d.ts","sourceRoot":"","sources":["../../src/core/ConvaiClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ConvaiClient.d.ts","sourceRoot":"","sources":["../../src/core/ConvaiClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EAML,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,WAAW,EAEX,aAAa,EACb,2BAA2B,EAC3B,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EAGd,uBAAuB,EACvB,wBAAwB,EAExB,0BAA0B,EAC1B,mBAAmB,EACnB,oBAAoB,EAGpB,cAAc,EACd,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EAEf,qBAAqB,EACrB,qBAAqB,EACrB,4BAA4B,EAE5B,oBAAoB,EAEpB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,4BAA4B,EAC5B,sBAAsB,EAKvB,MAAM,SAAS,CAAC;AAgBjB,OAAO,EAAE,YAAY,EAAsB,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,sBAAsB,CAAC;AAwC9B;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;gBAGvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QACP,MAAM,EAAE,4BAA4B,CAAC;QACrC,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,cAAc,CAAC;QAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAeJ;AAyBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,qBAAa,YAAa,SAAQ,YAAa,YAAW,aAAa;IACrE,OAAO,CAAC,KAAK,CAAO;IACpB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,iBAAiB,CAAyC;IAClE,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,wBAAwB,CAAwC;IACxE,OAAO,CAAC,2BAA2B,CAAuB;IAC1D,OAAO,CAAC,mBAAmB,CAAuB;IAClD,mFAAmF;IACnF,OAAO,CAAC,OAAO,CAAyB;IACxC,+DAA+D;IAC/D,OAAO,CAAC,sBAAsB,CAO1B;IACJ,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,aAAa,CAA6B;IAElD;;;OAGG;IACH,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,gBAAgB,CAAwC;IAChE,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,gBAAgB,CAAgD;IACxE,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,gBAAgB,CAAiB;IACzC,OAAO,CAAC,gBAAgB,CAAkB;IAC1C,OAAO,CAAC,uBAAuB,CAAkB;IAGjD,OAAO,CAAC,sBAAsB,CAA8C;IAC5E,OAAO,CAAC,wBAAwB,CAA8C;IAC9E,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,wBAAwB,CAAkC;IAClE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAO;IACpD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAU;IACzD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,4BAA4B,CAAU;IAE9D;;;;OAIG;IACH,MAAM,CAAC,0BAA0B,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI;IAKzE,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,uBAAuB,CAAyB;IAGxD,OAAO,CAAC,sBAAsB,CAAa;IAC3C,OAAO,CAAC,sBAAsB,CAAa;IAG3C,OAAO,CAAC,cAAc,CAA8B;gBAExC,MAAM,CAAC,EAAE,YAAY;IAoFjC,IAAI,KAAK,IAAI,iBAAiB,CAE7B;IAED,IAAI,cAAc,IAAI,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAEtD;IAED,IAAI,sBAAsB,IAAI,OAAO,CAEpC;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,IAAI,CAE7B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED,IAAI,gBAAgB,IAAI,wBAAwB,GAAG,IAAI,CAEtD;IAED,IAAI,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAEtC;IAED;;;;;OAKG;IACH,IAAI,iBAAiB,IAAI,uBAAuB,GAAG,IAAI,CAuBtD;IAED,IAAI,IAAI,IAAI,IAAI,CAEf;IAED,IAAI,YAAY,IAAI,WAAW,EAAE,CAEhC;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,IAAI,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAEtC;IAED;;;;;OAKG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,cAAc,EAC/B,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,GAC7C,MAAM,IAAI;IACb,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI;IAKjE;;;OAGG;IACH,IAAI,WAAW,IAAI,iBAAiB,GAAG,IAAI,CAE1C;IAED;;;OAGG;IACH,IAAI,UAAU,IAAI,uBAAuB,EAAE,CAE1C;IAED,0DAA0D;IAC1D,IAAI,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAEtC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAK1C,4EAA4E;IAC5E,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,WAAW;IAOzD,wFAAwF;IACxF,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAElC;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,aAAa,IAAI,aAAa,CAEjC;IAED,IAAI,aAAa,IAAI,aAAa,CAEjC;IAED,IAAI,mBAAmB,IAAI,mBAAmB,CAE7C;IAED,IAAI,eAAe,IAAI,eAAe,CAErC;IAED,IAAI,qBAAqB,IAAI,MAAM,CAElC;IAED,IAAI,aAAa,IAAI,aAAa,GAAG,IAAI,CAExC;IAED;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuR3B;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IASjC;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAkBtB;;;OAGG;YACW,wCAAwC;IA4BtD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACG,OAAO,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiSnD;;;;;;;;;;;;;;;;;;OAkBG;IACG,yBAAyB,CAC7B,IAAI,EAAE,cAAc,EACpB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC;IA4ChB;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAS;IAE1D,yEAAyE;IACzE,OAAO,CAAC,2BAA2B;IAqDnC;;;;;;;OAOG;IACH,OAAO,CAAC,0BAA0B;IAQlC,OAAO,CAAC,gBAAgB;IAOxB,gEAAgE;IAChE,OAAO,CAAC,kBAAkB;IAgC1B;;;;;OAKG;IACG,oBAAoB,CACxB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC,qBAAqB,CAAC;IAuCjC,8EAA8E;IACxE,qBAAqB,CACzB,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,qBAAqB,CAAC;IAoCjC,uEAAuE;IACvE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAK;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAO;IAEtD;;;;;;;;;OASG;YACW,sBAAsB;IAgCpC;;;;;;;;;;;;;;;;;;;OAmBG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAyEvD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,mBAAmB;IA4D3B;;;;OAIG;YACW,qBAAqB;YA2RrB,0CAA0C;IAgBxD;;;;;;OAMG;IACG,2BAA2B,CAC/B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,IAAI,CAAC;IAsMhB;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAgDlC,OAAO,CAAC,yBAAyB;IAWjC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA+CjC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAOhC;;OAEG;IACH,YAAY,IAAI,IAAI;IAiBpB;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,0BAA+B,GAAG,IAAI;IAiFjF;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAK5C;;;;OAIG;IACG,uBAAuB,CAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,eAAe,CAAC;IA2I3B,OAAO,CAAC,wBAAwB;IAoChC;;OAEG;IACH,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI;IA2BvE;;;;OAIG;IACH,OAAO,CAAC,8BAA8B;IAmBtC,OAAO,CAAC,wBAAwB;IAkBhC;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAwB5B;;;;OAIG;IACH,kBAAkB,CAAC,YAAY,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,IAAI;IAUjE;;OAEG;IACH,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAkBjD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI;IAmDlD,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,GAAG,IAAI;IAU9D,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM,GAAG,IAAI;IAkBhE,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,GAAG,IAAI;IAYnE;;;OAGG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAmB/C;;;OAGG;IACH,mBAAmB,CACjB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,EACnD,OAAO,GAAE,0BAA+B,GACvC,IAAI;IAaP,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,qBAAqB;IAe7B;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB5E;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKjC;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKjC;;;;OAIG;IACH,cAAc,IAAI,IAAI;CASvB"}