@belonguniverseai/react-sdk 0.4.3 → 0.5.0

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

@@ -12,8 +12,12 @@ export type CallTimelineEntry = {
     readonly atMs: number;
     readonly kind: "user" | "agent" | "step" | "success" | "error" | "skill" | "schedule";
     readonly text: string;
-    /** Agent tag for Operator-mode rows (e.g. "A2"); absent for foreground rows. */
-    readonly lineTag?: string;
+    /** The switchboard line this row concerns; `null` for a foreground (line 1)
+     * row. CallScreen's `labelFor` resolves `line ?? 1` to look up the agent's
+     * short board label for `step`/`success`/`error` rows (X2b) — the label
+     * column names the agent, so `text` itself never repeats a title prefix or
+     * an "A2"-style tag. */
+    readonly line: number | null;
 };
 export type CallState = {
     readonly status: CallStatus;
@@ -112,14 +116,55 @@ declare let lineDispatcher: ((req: {
     readonly isNewLine: boolean;
 }) => void) | null;
 export declare const registerCallLineDispatcher: (dispatcher: NonNullable<typeof lineDispatcher>) => (() => void);
+/**
+ * Last-resort delivery for `flushLineQueuesOnCallEnd` when no `lineDispatcher`
+ * is wired (the M7 gap — ChatRoute unmounted). Self-registered by
+ * line-dispatch.ts (see the bottom of that file) with the real
+ * `dispatchToLine` — deliberately NOT imported here directly. `line-dispatch.ts`
+ * already imports six functions FROM this module (buildCallContextDigest,
+ * the deliver/notify callbacks, peekCallState, subscribeCallState), so a
+ * static import the other way would close a two-way cycle between
+ * voice-call.ts and line-dispatch.ts — forbidden outright by
+ * `.dependency-cruiser.cjs`'s `no-circular` rule (severity: error, applies
+ * everywhere, not just the hexagonal backend layers). Registering FROM
+ * line-dispatch.ts, in the SAME direction its existing dependency already
+ * runs, avoids the cycle entirely; that file's own `subscribeCallState`
+ * self-subscribe (its module doc, right above `abortAllLineReaders`) is the
+ * identical idiom already established there.
+ *
+ * Investigated and confirmed SOUND as a fallback: chat.tsx's own
+ * `registerCallLineDispatcher` wrapper does nothing beyond routing line 1 to
+ * `sendCallText` and calling this exact function, unmodified, for any other
+ * line — see that effect in chat.tsx. Held/queued items only ever exist for
+ * background lines (line 1 never enqueues — see the busy-line branch above),
+ * so every item this fallback ever sees is exactly the shape ChatRoute's
+ * wrapper would have passed through unchanged. No ChatRoute-specific
+ * behavior is lost by calling it directly.
+ *
+ * Deliberately SEPARATE from `lineDispatcher` — not folded into
+ * `releaseHeldRequest` itself — so `pumpLineQueue`'s live-queue draining is
+ * UNAFFECTED: it must keep checking `lineDispatcher` and leaving an item
+ * queued (not popped) when nothing is wired, per its own doc. Only the
+ * end-of-call flush, which has nothing left to leave a drained item queued
+ * IN, reaches for this.
+ */
+declare let lineDispatchFallback: ((req: {
+    readonly line: number;
+    readonly request: string;
+    readonly isNewLine: boolean;
+}) => Promise<void>) | null;
+export declare const registerLineDispatchFallback: (dispatcher: NonNullable<typeof lineDispatchFallback>) => (() => void);
 export declare const registerCallLineViewSwitcher: (switcher: (sessionId: string) => void) => (() => void);
 export declare const registerCallClearNotifier: (notifier: (sessionId: string) => void) => (() => void);
 /**
  * ChatRoute calls this when a tool-approval card appears while a call is
  * live: the ask lands on the timeline and the voice model asks the user to
- * approve or reject out loud.
+ * approve or reject out loud. `reason` is the approval part's own `reason`
+ * field (via the approval bus's `PendingApproval.reason`) — on a phone call
+ * the user cannot see the card, so WHAT it wants to do has to travel in the
+ * prompt, not stay something only "open the chat view" could answer.
  */
-export declare const notifyCallApprovalRequired: (timelineText: string) => void;
+export declare const notifyCallApprovalRequired: (timelineText: string, reason: string) => void;
 /** Live speech level, 0..1 (max of agent voice + user mic). */
 export declare const peekCallAudioLevel: () => number;
 /** ChatRoute reports a tool-phase change on the delegated run — the strongest
@@ -129,7 +174,7 @@ export declare const notifyCallProgress: (hint: string) => void;
  * small work badge while the agent is busy. */
 export declare const setCallWorkPhase: (phase: CallState["workPhase"]) => void;
 /**
- * Click-path twin of `show_agent_line`: the lines strip chip on CallScreen
+ * Click-path twin of `show_agent`: the lines strip chip on CallScreen
  * calls this directly (no tool-call round trip, no ack). No-op when the line
  * is unknown, never bound to a session, or no view switcher is registered
  * (e.g. ChatRoute hasn't mounted).
@@ -173,7 +218,8 @@ export declare const deliverAgentReply: (text: string) => void;
  * must tell the user something went wrong and offer to retry.
  */
 export declare const deliverAgentFailure: (message: string) => void;
-/** A background line finished: relay its final text, naming the line. */
+/** A background line finished: relay its final text, naming the agent by
+ * role. */
 export declare const deliverLineReply: (line: number, text: string) => void;
 /**
  * A background line published an artifact: OPEN it on screen, mirroring
@@ -188,16 +234,26 @@ export declare const deliverLineArtifact: (line: number, artifact: {
     readonly title: string;
     readonly mimeType: string;
 }) => void;
-/** A background line failed: tell the user, naming the agent. */
+/** A background line failed: tell the user, naming the agent by role. */
 export declare const deliverLineFailure: (line: number, message: string) => void;
-/** A background line is blocked on a tool approval — steer the user to it. */
-export declare const notifyLineApprovalNeeded: (line: number, timelineText: string) => void;
+/** A background line is blocked on a tool approval — steer the user to it,
+ * by role, and tell the model WHAT it wants to do. W3: the old text asked
+ * the user to say a magic phrase ("show <title>") and never said what was
+ * being approved — unanswerable on a phone call, where there is no screen to
+ * "go look at". `reason` is the approval part's own `reason` field, threaded
+ * from the run stream via `onApprovalNeeded` (line-run-reader.ts). */
+export declare const notifyLineApprovalNeeded: (line: number, timelineText: string, reason: string) => void;
 /** A background line advanced a phase — record it as the line's live step
- * (CallScreen's agent board), land a tagged timeline row, and nudge a spoken
- * update. The registry write is unconditional (line-dispatch's own `isStale`
+ * (CallScreen's agent board reads `currentStepLabel`/`currentPhase` off the
+ * registry) and nudge a spoken update. X2a: deliberately NO timeline row per
+ * phase change any more — the board's own card already shows the identical
+ * string live, and a 12-step run used to write 12 near-identical Activity
+ * rows that buried the actual results; the durable Activity-log row for a
+ * background line's work is the ONE `dispatchToBackgroundLine` appends up
+ * front. The registry write is unconditional (line-dispatch's own `isStale`
  * guard already keeps a stale-call phase from ever reaching here); the
- * timeline/spoken half stays guarded like its delivery siblings so a phase
- * that DOES arrive with no live call just updates the board silently. */
+ * spoken nudge stays guarded like its delivery siblings so a phase that DOES
+ * arrive with no live call just updates the board silently. */
 export declare const notifyLinePhase: (line: number, phaseLabel: string, phase?: WorkPhase | null) => void;
 /** True while a call holds the audio path — ChatRoute gates TTS autoplay on it. */
 export declare const isCallActive: () => boolean;
@@ -209,7 +265,7 @@ export declare const isCallActive: () => boolean;
  */
 export declare const __forceCallState: (patch: Partial<CallState>) => void;
 /** TEST-ONLY companion: append a timeline row while in a forced state. */
-export declare const __forceCallTimelineEntry: (kind: CallTimelineEntry["kind"], text: string, lineTag?: string) => void;
+export declare const __forceCallTimelineEntry: (kind: CallTimelineEntry["kind"], text: string, line?: number | null) => void;
 /** TEST-ONLY companion: drive the orb's audio level without Web Audio. */
 export declare const __forceCallAudioLevel: (level: number) => void;
 /**

package/dist/i18n/messages/en.d.ts

@@ -480,9 +480,6 @@ export declare const en: {
         readonly muted: "Mic muted";
         readonly youSaid: "You said";
         readonly agentSaid: "Agent";
-        readonly step: "Working";
-        readonly done: "Done";
-        readonly failed: "Failed";
         readonly speakHint: "Speak to the agent…";
         readonly readyHint: "I'm listening — speak when you're ready.";
         readonly thinkingHint: "Thinking…";
@@ -501,22 +498,24 @@ export declare const en: {
         readonly skillNotFound: "No exact skill match for “{{query}}”";
         readonly skillCatalogUnavailable: "Skill catalog unavailable — retrying";
         readonly noSkillsConfigured: "No skills configured in this workspace";
-        readonly phaseCoding: "Writing code";
-        readonly phaseFiles: "Working with files";
-        readonly phaseActions: "Taking actions";
+        readonly phaseCoding: "Putting the steps together";
+        readonly phaseFiles: "Going through your data";
+        readonly phaseActions: "Running the steps";
         readonly lines: "Agents";
         readonly lineLabel: "Agent {{line}}";
         readonly mainAgentLabel: "Main agent";
-        readonly lineNeedsApproval: "needs approval";
-        readonly lineWorking: "working";
-        readonly lineReady: "ready";
-        readonly lineFailed: "failed";
-        readonly lineIdle: "idle";
-        readonly lineNotStarted: "not started";
-        readonly lineNoChat: "no chat yet";
+        readonly roleLabelMain: "Main agent";
+        readonly roleLabelData: "{{product}} data agent";
+        readonly roleLabelDataGeneric: "Data agent";
+        readonly roleLabelAnalyst: "Analyst";
+        readonly lineNeedsApproval: "Needs your OK";
+        readonly lineWorking: "Working…";
+        readonly lineReady: "Done";
+        readonly lineFailed: "Couldn't finish";
+        readonly lineIdle: "Ready";
         readonly activity: "Activity";
-        readonly showConversationLog: "Show conversation log";
-        readonly hideConversationLog: "Hide conversation log";
+        readonly showConversationLog: "Show what was said";
+        readonly hideConversationLog: "Hide what was said";
         readonly ambientTypingCode: "Typing code…";
         readonly ambientReviewingDiff: "Reviewing the diff…";
         readonly ambientRunningChecks: "Running checks…";

package/dist/types/public.d.ts

@@ -252,7 +252,7 @@ export type BelongGlobal = {
         errorMessage?: string;
     }) => void;
     /** TEST-ONLY: append a live-call timeline row. */
-    readonly __forceCallTimelineEntry?: (kind: "user" | "agent" | "step" | "success" | "error" | "skill" | "schedule", text: string, lineTag?: string) => void;
+    readonly __forceCallTimelineEntry?: (kind: "user" | "agent" | "step" | "success" | "error" | "skill" | "schedule", text: string, line?: number | null) => void;
     /** TEST-ONLY: drive the call orb's audio level (0..1) without Web Audio. */
     readonly __forceCallAudioLevel?: (level: number) => void;
     /** TEST-ONLY: force the agent-lines switchboard state without HTTP dispatch. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@belonguniverseai/react-sdk",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "description": "Belong — embeddable React AI assistant dock. Mount <BelongWidget> in your app tree with getToken dependency-injection auth.",
   "license": "UNLICENSED",
   "type": "module",