@belonguniverseai/react-sdk 0.6.0 → 0.6.1

package/dist/embed/voice/call-roster-store.d.ts

@@ -1,110 +0,0 @@
-/**
- * The voice call's agent ROSTER — the browser-side twin of the tenant
- * roster minted server-side (`buildCallRoster` in
- * apps/belong-cloud/src/features/voice/call-roster.ts) and threaded through
- * `POST /v1/voice/call-token`'s `agents` field (`callAgentSpecSchema`,
- * voice.schemas.ts). This is what lets the dock's rail, the call screen's
- * agent board, and every spoken announcement address an agent by ROLE
- * ("cli", "consulting") instead of a bare line number — and do so from the
- * moment the dock boots, before any call has ever been started: the rail
- * renders dock-wide with no call active, so it needs the LAST-KNOWN roster,
- * not only one handed to it live off a fresh mint.
- *
- * Persisted per workspace, exactly like `line-slots.ts` beside it
- * (`belong:voice-call-roster`, suffixed `:ws:<id>` when a workspace is in
- * effect via `peekWorkspaceId()`) — a host workspace switch must not hand
- * tenant A's roster (its titles, its CLI agent) to a rail rendering for
- * tenant B.
- *
- * localStorage is a perimeter: the persisted roster is zod-validated on read
- * and any junk (corrupted JSON, wrong shape, storage disabled) degrades to
- * an EMPTY roster — same as "no call minted yet". The schema below is a
- * deliberately independent, by-hand copy of the server's
- * `callAgentSpecSchema`: the two packages ship separately and share no type
- * module, so this is what keeps them honest (mirrors the existing
- * `CallAgentSpec`/`callAgentSpecSchema` split already living server-side in
- * `call-roster.ts` / `voice.schemas.ts`).
- *
- * Two fallback rules, and they are NOT the same rule:
- *
- *   - `lineForRole` / `roleForLine` on an EMPTY roster (nothing ever minted,
- *     or a mint whose body failed to parse) fall back to the POSITIONAL
- *     default that's been true since roles didn't exist: main=1, cli=2,
- *     consulting=3. This is what stops a parse failure from bricking role
- *     addressing mid-call — the switchboard still answers to
- *     main/cli/consulting by position.
- *   - On a NON-empty roster that simply doesn't have that role/line (a
- *     tenant with no CLI), the same lookups return `null` instead — the
- *     honest signal that THIS workspace has no such agent, which is what
- *     later produces an `unknown_role` tool response rather than silently
- *     addressing the wrong agent.
- *
- * `titleForRole` / `titleForLine` never return `null` — a title is always
- * needed for display/announcement, so THEIR fallback is a string, applied
- * uniformly regardless of whether the roster is empty or merely missing
- * that entry. The two fallbacks are deliberately DIFFERENT shapes, not the
- * same rule twice:
- *
- *   - `titleForRole` falls back to a ROLE-derived phrase ("the main agent" /
- *     "the CLI agent" / "the analyst") — never a switchboard
- *     number. Every voice tool call carries a role (it is the operator's
- *     entire addressing vocabulary — see `voice-call.ts`'s
- *     `resolveRoleLine`), so this fallback is always reachable from a role
- *     the model already said out loud, and it feeds prose the model
- *     SPEAKS: an empty roster (nothing minted yet, or a pre-roster backend
- *     mid rolling deploy — `callTokenResponseSchema`'s `agents` field
- *     legitimately defaults to `[]`) must not leak a bare "Agent 2" into
- *     that prose.
- *   - `titleForLine` falls back to `"the main agent"` for line 1 and
- *     `` `Agent ${line}` `` otherwise — the "Agent N" convention the
- *     switchboard used before roles existed. This one serves the UI's
- *     numbered rail, which genuinely displays a switchboard slot number, so
- *     a line-derived fallback is correct there and stays as-is.
- */
-export type CallAgentRole = "main" | "cli" | "consulting";
-export type CallAgentSpec = {
-    readonly role: CallAgentRole;
-    /** The durable switchboard line underneath (`line-slots.ts`). */
-    readonly line: number;
-    /** What the voice calls this agent out loud. */
-    readonly title: string;
-    /** One sentence describing what this agent is for. */
-    readonly purpose: string;
-};
-/** Persist the roster minted for the current call. A whole-roster replace —
- * never a per-entry patch — of whatever this workspace held before. */
-export declare const setCallRoster: (roster: readonly CallAgentSpec[]) => void;
-/** The current workspace's roster, or an empty array when nothing has been
- * minted yet (or storage held junk). */
-export declare const peekCallRoster: () => readonly CallAgentSpec[];
-/** Persist the tenant's product name minted alongside the roster (U2) — a
- * whole-value replace, same discipline as `setCallRoster`. */
-export declare const setProductName: (productName: string | null) => void;
-/** The current workspace's product name, or `null` when nothing has been
- * minted yet, the tenant has none, or storage held junk. Used ONLY to
- * localize the SDK's own UI copy (CallScreen's agent board, U2) — never fed
- * into any string the model speaks or receives. */
-export declare const peekProductName: () => string | null;
-/** Resolve a role to its switchboard line. See the module doc: `null` only
- * ever means "this NON-empty roster doesn't have that role" — an EMPTY
- * roster falls back to the positional default instead. */
-export declare const lineForRole: (role: CallAgentRole) => number | null;
-/** Resolve a switchboard line to its role — the inverse of `lineForRole`,
- * with the same two-rule fallback (EMPTY roster → positional; non-empty and
- * missing → `null`). */
-export declare const roleForLine: (line: number) => CallAgentRole | null;
-/** What the voice calls this role out loud. Always a string — falls back to
- * a ROLE-derived title (never a switchboard number, never `null`) when the
- * roster has no entry for this role, whether the roster is empty or just
- * missing it. */
-export declare const titleForRole: (role: CallAgentRole) => string;
-/** What the voice calls this line out loud. Always a string — falls back to
- * `"the main agent"` (line 1) or `` `Agent ${line}` `` otherwise when the
- * roster has no entry for this line, whether the roster is empty or just
- * missing it. */
-export declare const titleForLine: (line: number) => string;
-/** Test-only: drop the persisted roster AND product name for the current
- * workspace scope — they are minted together (the same call-token mint), so
- * a test resetting one without the other would leak a stale product name
- * (or roster) into the next case. */
-export declare const __clearCallRosterForTest: () => void;