@belonguniverseai/react-sdk 0.5.0 → 0.6.1

package/dist/component/{mindmap-definition-RKZ34NQL-CErhrdm3.js → mindmap-definition-RKZ34NQL-DMC3vCUq.js}

@@ -1,6 +1,6 @@
-import { g as oe } from "./chunk-55IACEB6-Dg96dHvQ.js";
-import { s as ae } from "./chunk-2J33WTMH-Dkd9OyM1.js";
-import { _ as l, l as C, p as ce, r as le, G as he, K as G, c as B, i as F, b6 as de, af as ge, ag as ue, ah as pe } from "./mermaid-GHXKKRXX-CjZr9GWr.js";
+import { g as oe } from "./chunk-55IACEB6-C4M2cG_c.js";
+import { s as ae } from "./chunk-2J33WTMH-C6wmoOIl.js";
+import { _ as l, l as C, p as ce, r as le, G as he, K as G, c as B, i as F, b6 as de, af as ge, ag as ue, ah as pe } from "./mermaid-GHXKKRXX-j_0KsvYs.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 const b = [];
@@ -830,4 +830,4 @@ var _e = Y, ke = 12, N = {
 export {
   we as diagram
 };
-//# sourceMappingURL=mindmap-definition-RKZ34NQL-CErhrdm3.js.map
+//# sourceMappingURL=mindmap-definition-RKZ34NQL-DMC3vCUq.js.map

package/dist/component/{pieDiagram-4H26LBE5-Cno02n3_.js → pieDiagram-4H26LBE5-DmYi_D3l.js}

@@ -1,7 +1,7 @@
-import { a0 as S, S as R, b5 as J, g as Q, s as Y, a as tt, b as et, t as at, q as nt, _ as g, l as W, c as rt, I as it, N as st, a7 as lt, e as ot, B as ct, K as ut } from "./mermaid-GHXKKRXX-CjZr9GWr.js";
-import { p as gt } from "./chunk-4BX2VUAB-JbEXcQ3q.js";
+import { a0 as S, S as R, b5 as J, g as Q, s as Y, a as tt, b as et, t as at, q as nt, _ as g, l as W, c as rt, I as it, N as st, a7 as lt, e as ot, B as ct, K as ut } from "./mermaid-GHXKKRXX-j_0KsvYs.js";
+import { p as gt } from "./chunk-4BX2VUAB-DySNI9mv.js";
 import { p as dt } from "./wardley-L42UT6IY-HA1eSIS_.js";
-import { d as P } from "./arc-CtyXH_sw.js";
+import { d as P } from "./arc-BziuP1aB.js";
 import { o as pt } from "./ordinal-D0x7izaa.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
@@ -163,4 +163,4 @@ var vt = ut.pie, z = {
 export {
   Lt as diagram
 };
-//# sourceMappingURL=pieDiagram-4H26LBE5-Cno02n3_.js.map
+//# sourceMappingURL=pieDiagram-4H26LBE5-DmYi_D3l.js.map

package/dist/component/{quadrantDiagram-W4KKPZXB-DQV7ytCz.js → quadrantDiagram-W4KKPZXB-DMos-d69.js}

@@ -1,5 +1,5 @@
-import { s as Se, g as _e, t as ee, q as Ae, a as ke, b as Fe, _ as r, c as Et, l as qt, d as vt, e as Pe, B as ve, K as z, i as Ce, a4 as Le } from "./mermaid-GHXKKRXX-CjZr9GWr.js";
-import { l as te } from "./linear-B_oPUR6_.js";
+import { s as Se, g as _e, t as ee, q as Ae, a as ke, b as Fe, _ as r, c as Et, l as qt, d as vt, e as Pe, B as ve, K as z, i as Ce, a4 as Le } from "./mermaid-GHXKKRXX-j_0KsvYs.js";
+import { l as te } from "./linear-DondfmT2.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var Ct = (function() {
@@ -1030,4 +1030,4 @@ var Ve = /* @__PURE__ */ r(function() {
 export {
   We as diagram
 };
-//# sourceMappingURL=quadrantDiagram-W4KKPZXB-DQV7ytCz.js.map
+//# sourceMappingURL=quadrantDiagram-W4KKPZXB-DMos-d69.js.map

package/dist/component/{requirementDiagram-4Y6WPE33-DBORDX5u.js → requirementDiagram-4Y6WPE33-BpgIfnhZ.js}

@@ -1,6 +1,6 @@
-import { g as Ge } from "./chunk-55IACEB6-Dg96dHvQ.js";
-import { s as ze } from "./chunk-2J33WTMH-Dkd9OyM1.js";
-import { _ as h, G as Ye, b as Xe, a as Je, s as Ze, g as et, q as tt, t as st, c as ke, l as Ne, B as it, F as rt, p as nt, r as at, u as lt } from "./mermaid-GHXKKRXX-CjZr9GWr.js";
+import { g as Ge } from "./chunk-55IACEB6-C4M2cG_c.js";
+import { s as ze } from "./chunk-2J33WTMH-C6wmoOIl.js";
+import { _ as h, G as Ye, b as Xe, a as Je, s as Ze, g as et, q as tt, t as st, c as ke, l as Ne, B as it, F as rt, p as nt, r as at, u as lt } from "./mermaid-GHXKKRXX-j_0KsvYs.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var qe = (function() {
@@ -885,4 +885,4 @@ var mt = /* @__PURE__ */ h(async function(e, u, o, n) {
 export {
   Rt as diagram
 };
-//# sourceMappingURL=requirementDiagram-4Y6WPE33-DBORDX5u.js.map
+//# sourceMappingURL=requirementDiagram-4Y6WPE33-BpgIfnhZ.js.map

package/dist/component/{sankeyDiagram-5OEKKPKP-gNBaVNW1.js → sankeyDiagram-5OEKKPKP-xbJGp8Ms.js}

@@ -1,4 +1,4 @@
-import { q as kt, t as mt, s as xt, g as _t, b as vt, a as bt, _ as y, c as ot, C as St, d as G, ai as wt, B as Lt, k as Et } from "./mermaid-GHXKKRXX-CjZr9GWr.js";
+import { q as kt, t as mt, s as xt, g as _t, b as vt, a as bt, _ as y, c as ot, C as St, d as G, ai as wt, B as Lt, k as Et } from "./mermaid-GHXKKRXX-j_0KsvYs.js";
 import { o as Tt } from "./ordinal-D0x7izaa.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
@@ -859,4 +859,4 @@ var ge = {
 export {
   ge as diagram
 };
-//# sourceMappingURL=sankeyDiagram-5OEKKPKP-gNBaVNW1.js.map
+//# sourceMappingURL=sankeyDiagram-5OEKKPKP-xbJGp8Ms.js.map

package/dist/component/{sequenceDiagram-3UESZ5HK-BlxJztMa.js → sequenceDiagram-3UESZ5HK-Bnlm4mVO.js}

@@ -1,6 +1,6 @@
-import { _ as g, o as tr, c as $, d as Mt, l as at, j as Ce, e as er, f as rr, k as P, b as ke, s as ar, q as sr, a as ir, g as nr, t as or, v as cr, J as lr, B as hr, i as Bt, u as Z, a5 as Q, a6 as wt, a7 as Me, a8 as dr, G as Yt, a9 as Tr, aa as Be } from "./mermaid-GHXKKRXX-CjZr9GWr.js";
-import { a as pr, b as ee, g as dt, d as Er, e as re, f as ae } from "./chunk-ND2GUHAM-CEQj3so6.js";
-import { I as ur } from "./chunk-QZHKN3VN-BWgwT04-.js";
+import { _ as g, o as tr, c as $, d as Mt, l as at, j as Ce, e as er, f as rr, k as P, b as ke, s as ar, q as sr, a as ir, g as nr, t as or, v as cr, J as lr, B as hr, i as Bt, u as Z, a5 as Q, a6 as wt, a7 as Me, a8 as dr, G as Yt, a9 as Tr, aa as Be } from "./mermaid-GHXKKRXX-j_0KsvYs.js";
+import { a as pr, b as ee, g as dt, d as Er, e as re, f as ae } from "./chunk-ND2GUHAM-DfbE4oOG.js";
+import { I as ur } from "./chunk-QZHKN3VN-Y8mfHGtB.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var $t = (function() {
@@ -2894,4 +2894,4 @@ var ra = /* @__PURE__ */ g(async function(e, t, a) {
 export {
   Ta as diagram
 };
-//# sourceMappingURL=sequenceDiagram-3UESZ5HK-BlxJztMa.js.map
+//# sourceMappingURL=sequenceDiagram-3UESZ5HK-Bnlm4mVO.js.map

package/dist/component/{stateDiagram-AJRCARHV-2ziF_Zes.js → stateDiagram-AJRCARHV-BIooqMYf.js}

@@ -1,5 +1,5 @@
-import { s as R, a as W, S as N } from "./chunk-AQP2D5EJ-DLX62MPh.js";
-import { _ as f, c as t, d as M, l as S, e as P, k as z, ac as _, ad as U, a9 as C, u as F } from "./mermaid-GHXKKRXX-CjZr9GWr.js";
+import { s as R, a as W, S as N } from "./chunk-AQP2D5EJ-DiS4043D.js";
+import { _ as f, c as t, d as M, l as S, e as P, k as z, ac as _, ad as U, a9 as C, u as F } from "./mermaid-GHXKKRXX-j_0KsvYs.js";
 import { G as O } from "./graph-BZLHvygk.js";
 import { l as J } from "./layout-Bu6nRdWm.js";
 globalThis.process = globalThis.process || { env: {} };
@@ -263,4 +263,4 @@ var X = /* @__PURE__ */ f((e) => e.append("circle").attr("class", "start-state")
 export {
   ot as diagram
 };
-//# sourceMappingURL=stateDiagram-AJRCARHV-2ziF_Zes.js.map
+//# sourceMappingURL=stateDiagram-AJRCARHV-BIooqMYf.js.map

package/dist/component/{stateDiagram-v2-BHNVJYJU-BWmzKTMS.js → stateDiagram-v2-BHNVJYJU-C6WAOCCe.js}

@@ -1,5 +1,5 @@
-import { s as e, b as r, a as s, S as t } from "./chunk-AQP2D5EJ-DLX62MPh.js";
-import { _ as l } from "./mermaid-GHXKKRXX-CjZr9GWr.js";
+import { s as e, b as r, a as s, S as t } from "./chunk-AQP2D5EJ-DiS4043D.js";
+import { _ as l } from "./mermaid-GHXKKRXX-j_0KsvYs.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var b = {
@@ -16,4 +16,4 @@ var b = {
 export {
   b as diagram
 };
-//# sourceMappingURL=stateDiagram-v2-BHNVJYJU-BWmzKTMS.js.map
+//# sourceMappingURL=stateDiagram-v2-BHNVJYJU-C6WAOCCe.js.map

package/dist/component/{timeline-definition-PNZ67QCA-OcHhxXWM.js → timeline-definition-PNZ67QCA-lTe5jbcD.js}

@@ -1,5 +1,5 @@
-import { _ as o, G as gt, af as Rt, ag as Ct, ah as Wt, c as pt, l as E, N as Pt, a7 as Bt, ai as ft, d as U, F as Vt, aj as Ft, B as zt } from "./mermaid-GHXKKRXX-CjZr9GWr.js";
-import { d as ot } from "./arc-CtyXH_sw.js";
+import { _ as o, G as gt, af as Rt, ag as Ct, ah as Wt, c as pt, l as E, N as Pt, a7 as Bt, ai as ft, d as U, F as Vt, aj as Ft, B as zt } from "./mermaid-GHXKKRXX-j_0KsvYs.js";
+import { d as ot } from "./arc-BziuP1aB.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var tt = (function() {
@@ -1055,4 +1055,4 @@ var Qt = /* @__PURE__ */ o(function(e, t, n, i, r, h = !1) {
 export {
   me as diagram
 };
-//# sourceMappingURL=timeline-definition-PNZ67QCA-OcHhxXWM.js.map
+//# sourceMappingURL=timeline-definition-PNZ67QCA-lTe5jbcD.js.map

package/dist/component/{vennDiagram-CIIHVFJN-Fl9VlPVe.js → vennDiagram-CIIHVFJN-5RYbksB1.js}

@@ -1,4 +1,4 @@
-import { aX as Gt, s as Wt, g as Kt, t as Ht, q as Xt, a as Yt, b as Zt, _ as w, G as wt, N as Jt, d as ot, ao as Qt, af as $t, ag as te, ah as ee, e as ne, B as se, I as ie, K as oe } from "./mermaid-GHXKKRXX-CjZr9GWr.js";
+import { aX as Gt, s as Wt, g as Kt, t as Ht, q as Xt, a as Yt, b as Zt, _ as w, G as wt, N as Jt, d as ot, ao as Qt, af as $t, ag as te, ah as ee, e as ne, B as se, I as ie, K as oe } from "./mermaid-GHXKKRXX-j_0KsvYs.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 const kt = (t, n) => Gt(t, "a", -n), _t = 1e-10;
@@ -1557,4 +1557,4 @@ var qe = { draw: Ve }, Ge = {
 export {
   Ge as diagram
 };
-//# sourceMappingURL=vennDiagram-CIIHVFJN-Fl9VlPVe.js.map
+//# sourceMappingURL=vennDiagram-CIIHVFJN-5RYbksB1.js.map

package/dist/component/{wardleyDiagram-YWT4CUSO-BNHUW0Ex.js → wardleyDiagram-YWT4CUSO-BSz_UDND.js}

@@ -1,5 +1,5 @@
-import { s as St, g as Mt, t as Nt, q as Tt, a as zt, b as Lt, _ as u, a4 as At, G as Xt, I as U, l as K, N as Et, e as Yt, B as It, c as j } from "./mermaid-GHXKKRXX-CjZr9GWr.js";
-import { p as Bt } from "./chunk-4BX2VUAB-JbEXcQ3q.js";
+import { s as St, g as Mt, t as Nt, q as Tt, a as zt, b as Lt, _ as u, a4 as At, G as Xt, I as U, l as K, N as Et, e as Yt, B as It, c as j } from "./mermaid-GHXKKRXX-j_0KsvYs.js";
+import { p as Bt } from "./chunk-4BX2VUAB-DySNI9mv.js";
 import { p as Ft } from "./wardley-L42UT6IY-HA1eSIS_.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
@@ -678,4 +678,4 @@ var Dt = {
 export {
   Qt as diagram
 };
-//# sourceMappingURL=wardleyDiagram-YWT4CUSO-BNHUW0Ex.js.map
+//# sourceMappingURL=wardleyDiagram-YWT4CUSO-BSz_UDND.js.map

package/dist/component/{xychartDiagram-2RQKCTM6-Bog3Ddue.js → xychartDiagram-2RQKCTM6-BmzhiB0a.js}

@@ -1,7 +1,7 @@
-import { s as ei, g as si, t as Lt, q as ni, a as ai, b as oi, _ as a, l as Et, N as ri, e as hi, B as li, G as dt, i as ci, I as It, K as ui, a4 as gi, ap as xi, ac as Rt } from "./mermaid-GHXKKRXX-CjZr9GWr.js";
+import { s as ei, g as si, t as Lt, q as ni, a as ai, b as oi, _ as a, l as Et, N as ri, e as hi, B as li, G as dt, i as ci, I as It, K as ui, a4 as gi, ap as xi, ac as Rt } from "./mermaid-GHXKKRXX-j_0KsvYs.js";
 import { i as di } from "./init-BOu0eQYQ.js";
 import { o as fi } from "./ordinal-D0x7izaa.js";
-import { l as Dt } from "./linear-B_oPUR6_.js";
+import { l as Dt } from "./linear-DondfmT2.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 function pi(t, i, e) {
@@ -1372,4 +1372,4 @@ var Ti = /* @__PURE__ */ a(function() {
 export {
   Mi as diagram
 };
-//# sourceMappingURL=xychartDiagram-2RQKCTM6-Bog3Ddue.js.map
+//# sourceMappingURL=xychartDiagram-2RQKCTM6-BmzhiB0a.js.map

package/dist/components/embed/EmbedHeader.d.ts

@@ -1,8 +1,12 @@
 import { BelongThemeBrand, BelongThemePalette } from '../../types/public.ts';
 /**
- * Slim brand bar at the top of the chat: the mark + the brand/view title, with
- * a small "by Belong" tagline when a tenant brand is active. Action controls
- * live in the rail (EmbedRail), not here — with TWO exceptions:
+ * Slim brand bar at the top of the chat: the mark + the brand/view title, and
+ * a small second line under it — the name of the conversation on screen when
+ * the dock passes one (`subtitle`, chat view), otherwise the "by Belong"
+ * tagline when a tenant brand is active. Knowing WHICH chat is open beats the
+ * co-branding line on the one surface where both compete for the same slot.
+ * Action controls live in the rail (EmbedRail), not here — with TWO
+ * exceptions:
  *   • `onExportChat` — download the current conversation as JSON. Stateful:
  *     while the backend generates the export the button shows a spinner and
  *     is disabled; the label (aria + hover title) carries the timestamp of
@@ -13,8 +17,11 @@ import { BelongThemeBrand, BelongThemePalette } from '../../types/public.ts';
  *     is nothing to fall back to), so the single-chat header stays exactly as
  *     it always was.
  */
-export declare function EmbedHeader({ title, palette, brand, onExportChat, exportState, exportChatLabel, onCloseChat, closeChatLabel, }: {
+export declare function EmbedHeader({ title, subtitle, palette, brand, onExportChat, exportState, exportChatLabel, onCloseChat, closeChatLabel, }: {
     title: string;
+    /** Second header line — the current chat's name (chat view). Takes the slot
+     *  the "by Belong" tagline occupies when absent. */
+    subtitle?: string;
     palette: BelongThemePalette;
     brand: BelongThemeBrand;
     /** Request a chat export (rendered only when provided — chat view with a

package/dist/components/embed/rail-flags.d.ts

@@ -30,3 +30,13 @@
  * without touching anything else.
  */
 export declare const MULTI_AGENT_RAIL_ENABLED = true;
+/**
+ * The dial button (`CallButton`) in the desktop rail and the mobile nav bar.
+ *
+ * Currently `false`: the button is HIDDEN, the voice stack is not. Everything
+ * behind it — `startCall`/`endCall`, the CallScreen, push-to-talk, the
+ * reload-survival reconnect offer, the rail voice cue — is untouched and still
+ * reachable; only this entry point is off. Flip to `true` to bring the button
+ * back with no other change.
+ */
+export declare const VOICE_CALL_BUTTON_ENABLED = false;

package/dist/components/ui/badge.d.ts

@@ -1,7 +1,7 @@
 import { VariantProps } from 'class-variance-authority';
 import * as React from "react";
 declare const badgeVariants: (props?: ({
-    variant?: "default" | "link" | "destructive" | "outline" | "secondary" | "ghost" | "notice" | null | undefined;
+    variant?: "default" | "link" | "destructive" | "notice" | "outline" | "secondary" | "ghost" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 declare function Badge({ className, variant, asChild, ...props }: React.ComponentProps<"span"> & VariantProps<typeof badgeVariants> & {
     asChild?: boolean;

package/dist/embed/slash-commands.d.ts

@@ -1,12 +1,18 @@
 import { CommandSummary, SkillSummary } from '../api/skills.ts';
-/** The group label workspace-tree commands render under in the slash menu. */
+/** Fallback group label for a workspace command the backend could not
+ *  attribute to a plugin (flat project commands). Plugin-attributed commands
+ *  render under their own section instead — see `cmd.group` below. */
 export declare const COMMAND_GROUP = "Commands";
 /**
  * Map a workspace-tree command onto the `SkillSummary` shape the picker
- * renders — display only. At submit time a command token is deliberately NOT
- * matched by {@link parseSlashSubmission} (commands aren't in the skills
- * list), so the draft falls through and posts as RAW text: the worker-side
- * Agent SDK parses the leading-slash message against its command registry.
+ * renders — display only. A command the backend attributed to a discovered
+ * plugin (`cmd.group` set — e.g. "sk-data-lab", "implementation-playbook")
+ * renders under that plugin's own section; a flat command with no plugin
+ * falls back to the generic {@link COMMAND_GROUP}. At submit time a command
+ * token is deliberately NOT matched by {@link parseSlashSubmission} (commands
+ * aren't in the skills list), so the draft falls through and posts as RAW
+ * text: the worker-side Agent SDK parses the leading-slash message against
+ * its command registry.
  */
 export declare const commandOptions: (commands: readonly CommandSummary[]) => readonly SkillSummary[];
 /**
@@ -52,7 +58,10 @@ export declare const parseBuiltinCommand: (draft: string) => BuiltinCommand | nu
 /**
  * The slash menu's option list: built-ins merged ahead of the skills, ranked
  * by {@link filterSkills} (prefix matches first; input order — built-ins
- * before skills — breaks ties within each bucket).
+ * before skills — breaks ties within each bucket), then bucketed into
+ * contiguous per-group sections by {@link bucketByGroup} — see that
+ * function's comment for why grouping is a required SECOND pass over the
+ * ranked list, not something ranking alone gives you for free.
  *
  * Built-ins are offered for a token at ANY position (BEL-167). They used to be
  * withheld from a mid-message token because {@link parseBuiltinCommand} could
@@ -123,5 +132,13 @@ export declare const hoistCommandSubmission: (draft: string, commands: readonly
  * The argument-taking builtins ROTATE rather than splice — see below.
  */
 export declare const hoistBuiltinCommand: (draft: string) => string;
-/** Name-prefix matches first, then other name/description substring matches. */
+/**
+ * Name-prefix matches first, then other name/description substring matches,
+ * then GROUP word-prefix matches (plugin-section search, ≥3 chars — see
+ * {@link GROUP_MATCH_MIN_QUERY_LENGTH}): typing "impl", "data", or a plugin's
+ * name (e.g. "sk-data-lab") surfaces every entry in that section even when
+ * the query hits neither the name nor the description. Ranked last so an
+ * entry actually named after the query still takes the top slot — a query
+ * that happens to also be a group name doesn't bump a direct name match down.
+ */
 export declare const filterSkills: (skills: readonly SkillSummary[], query: string) => readonly SkillSummary[];

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

@@ -2,33 +2,81 @@ import { z } from 'zod';
 declare const callActiveMarkerSchema: z.ZodObject<{
     active: z.ZodLiteral<true>;
     startedAtMs: z.ZodNumber;
+    /** Last proof-of-life heartbeat — see the module doc comment above. Required:
+     * a marker written by a build that predates this field cannot prove the call
+     * was recently alive, so it must parse as absent rather than as "fresh". */
+    updatedAtMs: z.ZodNumber;
+    /** Consecutive auto-redial attempts with no healthy call since. Required for
+     * the same pre-upgrade reason as `updatedAtMs`. */
+    redialCount: z.ZodNumber;
     /** Recap of the call so far, same shape/cap as `buildCallContextDigest()`.
      * Empty until the first user/agent timeline row lands. */
     contextDigest: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     active: true;
     startedAtMs: number;
+    updatedAtMs: number;
+    redialCount: number;
     contextDigest: string;
 }, {
     active: true;
     startedAtMs: number;
+    updatedAtMs: number;
+    redialCount: number;
     contextDigest: string;
 }>;
 export type CallActiveMarker = z.infer<typeof callActiveMarkerSchema>;
 /** The tab's persisted call marker, or null when absent/malformed — a
  * corrupted or pre-this-feature record just means "nothing to redial". */
 export declare const readCallActiveMarker: () => CallActiveMarker | null;
-/** Mark the call live — called on the `in_call` transition. Starts with an
- * empty digest; {@link refreshCallActiveMarkerContext} fills it in as the
- * call progresses. */
-export declare const writeCallActiveMarker: () => void;
+/**
+ * Why the call that just reached `in_call` was dialled.
+ *
+ * `"user"` — a dial the user asked for outright, which is a fresh intent: it
+ * inherits nothing from an interrupted call, redial streak included.
+ * `"redial"` — a reconnect of an interrupted call, which CONTINUES that
+ * streak. `voice-call.ts` maps its `startCall({ isReconnect })` option
+ * straight onto this, so the rail's manual "Reconnect" click also continues
+ * the streak rather than resetting it: the count only ever gates the
+ * AUTOMATIC redial, so continuing it errs toward asking the user again rather
+ * than toward reopening the microphone on its own.
+ */
+export type CallDialOrigin = "user" | "redial";
+/** Mark the call live — called on the `in_call` transition. `updatedAtMs`
+ * starts equal to `startedAtMs` (no heartbeat has ticked yet). `redialCount`
+ * carries over from the interrupted call on a `"redial"` (see the module doc:
+ * reaching `in_call` is NOT proof a redial worked — only the 30s healthy-call
+ * timer's {@link resetRedialCount} is) and starts at zero on a `"user"` dial.
+ * Starts with an empty digest; {@link refreshCallActiveMarkerContext} fills it
+ * in as the call progresses. */
+export declare const writeCallActiveMarker: (origin: CallDialOrigin) => void;
 /** Update the persisted digest of an already-active marker. No-op when no
  * marker is active — a digest has nothing to attach itself to once the call
  * has ended. */
 export declare const refreshCallActiveMarkerContext: (contextDigest: string) => void;
+/** How often `voice-call.ts` re-stamps `updatedAtMs` while a call is
+ * `in_call` — the proof-of-life cadence a future reload's staleness check is
+ * accurate to. */
+export declare const MARKER_HEARTBEAT_MS = 10000;
+/** Refresh the marker's proof-of-life stamp. Called on a
+ * `MARKER_HEARTBEAT_MS` interval for as long as the call is live — see the
+ * module doc comment for why this can't just ride `refreshCallActiveMarkerContext`.
+ * No-op when no marker is active, mirroring `refreshCallActiveMarkerContext`:
+ * a heartbeat has nothing left to touch once the call has ended. */
+export declare const touchCallActiveMarker: () => void;
+/** Record one more auto-redial attempt against the persisted marker. No-op
+ * when no marker is active — mirrors `refreshCallActiveMarkerContext`. */
+export declare const noteRedialAttempt: () => void;
+/** Zero the redial counter — called once a (re)dialed call has stayed up long
+ * enough to call healthy, so it stops counting against the next drop. No-op
+ * when no marker is active — mirrors `refreshCallActiveMarkerContext`. */
+export declare const resetRedialCount: () => void;
 /** Call ended (explicit hangup or terminal error) — no reload should redial. */
 export declare const clearCallActiveMarker: () => void;
-export type ReconnectOfferDecision = "offer" | "skip";
+/** What the dock's boot effect should do about an interrupted call: dial it
+ * back automatically, put the one-click offer on the rail's call button, or
+ * leave the dock alone. */
+export type ReconnectAction = "redial" | "offer" | "skip";
 /**
  * How long after the interrupted call started we still OFFER to reconnect. A
  * reload lands in seconds; a tab the browser restored from a much older session
@@ -37,29 +85,37 @@ export type ReconnectOfferDecision = "offer" | "skip";
  */
 export declare const RECONNECT_OFFER_MAX_AGE_MS = 600000;
 /**
- * Whether the dock's boot effect should OFFER to reconnect an interrupted call.
- *
- * This deliberately decides an offer, never a dial. Auto-dialing on load opens
- * the MICROPHONE with no user gesture: the origin already holds mic permission
- * (a call was live moments ago), so the browser does not re-prompt and the mic
- * would come back silently on the next page load — on hosts that receive the
- * SDK through an unpinnable bundle, with no opt-in of their own. Requiring one
- * click to redial is both the honest consent story and what browsers' autoplay/
- * gesture rules expect; the marker is kept either way so the redial can still
- * carry the interrupted call's `contextDigest`.
+ * How stale the marker may be and still earn an AUTOMATIC redial. A reload
+ * lands within a couple of seconds; a tab the browser restored from a much
+ * older session must not silently reopen the microphone. Read against
+ * `updatedAtMs` (the heartbeat), never `startedAtMs` — a call that has been
+ * live for 20 minutes must still come back.
+ */
+export declare const REDIAL_MAX_STALENESS_MS = 120000;
+/** Consecutive automatic redials before falling back to the button. A host
+ * that crash-loops must not reopen the mic on every load. */
+export declare const MAX_CONSECUTIVE_REDIALS = 2;
+/**
+ * What the dock's boot effect should do about a call this tab was in when the
+ * page went away.
  *
  * Pure so the branching is unit-testable without React or WebRTC: a marker
  * means a call was live when the page went away; `tokenReady` mirrors the same
  * auth-readiness gate the login screen polls; `alreadyOffered` is the one-shot
- * guard (the offer is raised at most once per page load); and `startedAtMs` is
- * consumed against `nowMs` so a stale marker cannot offer forever.
+ * guard (the decision is acted on at most once per page load); and the
+ * marker's timestamps are consumed against `nowMs` so a stale marker can
+ * neither dial nor offer forever.
+ *
+ * The gates are what make an unattended `"redial"` acceptable — see the module
+ * doc. `"offer"` is the same one-click fallback this file has always decided,
+ * now reached only when a redial's gates say no.
  */
-export declare const decideReconnectOffer: (input: {
+export declare const decideReconnectAction: (input: {
     readonly marker: CallActiveMarker | null;
     readonly tokenReady: boolean;
     readonly alreadyOffered: boolean;
     readonly nowMs: number;
-}) => ReconnectOfferDecision;
+}) => ReconnectAction;
 export declare const peekReconnectOffered: () => boolean;
 export declare const markReconnectOffered: () => void;
 /** Test-only: forget the one-shot guard between test cases. */

package/dist/embed/voice/line-dispatch.d.ts

@@ -17,14 +17,14 @@
  * a workspace must land in THAT workspace, not the shared legacy root — so the
  * create body carries the effective `workspaceExternalId` (absent when the host
  * runs unscoped). The line's registry label seeds the session title when one
- * exists; otherwise (U4 — the common case for a freshly materialized line,
- * since `dispatchToBackgroundLine` no longer seeds the registry label with the
- * agent's own name) the REQUEST itself does, so the sessions list still names
- * the background conversation by what it's actually about ("Reconcile the
- * July invoices"), not the agent that happened to run it.
+ * exists; otherwise (U4 — the common case, since nothing seeds a freshly
+ * materialized line's registry label any more) the REQUEST itself does, so the
+ * sessions list still names the background conversation by what it's actually
+ * about ("Reconcile the July invoices"), not the agent that happened to run
+ * it.
  *
  * BOOT RE-ATTACH (F3/R4): `attachLineReader` below is the ONE seam that wires
- * a VOICE-dispatched line-run reader onto a line, shared by a fresh dispatch
+ * a SLOT-tracked line-run reader onto a line, shared by a fresh dispatch
  * (this module, right after a POST accepts a run) and `reattachPendingLineRuns`
  * (called once at boot, after `initAgentLines()` rehydrates the registry)
  * resuming a run that was still going when the page reloaded. Both paths
@@ -32,26 +32,28 @@
  * navigate/artifact/finish/error callbacks — a reload must behave exactly like
  * the live dispatch it is standing in for, not a parallel, easier-to-drift copy.
  *
- * TWO READER KINDS (BEL-90). This module now attaches two, and which callback
- * set a caller gets is a correctness question, not a style one:
+ * TWO READER KINDS (BEL-90). This module attaches two, and which callback set
+ * a caller gets is a correctness question, not a style one. NEITHER speaks —
+ * a background line never reaches the call (see voice-call.ts's agent-line
+ * section) — but they write different things:
  *
- *   - `attachLineReader` — the voice-NARRATION reader. Its callbacks are not
- *     plain setters: `deliverLineReply`/`deliverLineFailure` push
- *     `conversation.item.create` events into an active voice call and ask the
- *     model to respond, `notifyLinePhase` appends timeline rows and nudges
- *     spoken progress, `deliverLineArtifact` opens a preview panel. Correct
- *     for a run the operator dispatched BY VOICE.
+ *   - `attachLineReader` — the SLOT reader, for a run this module dispatched.
+ *     It owns the durable slot runId (`persistSlotRun`, set on dispatch and
+ *     cleared on terminal), writes the registry through
+ *     `deliverLineReply`/`deliverLineFailure`/`notifyLinePhase`/
+ *     `notifyLineApprovalNeeded`, and additionally opens an artifact preview
+ *     and dispatches host route navigation.
  *   - `attachLineProgressReader` — the plain-progress reader, for a run the
  *     user started by TYPING that was still in flight at reload. It goes
- *     through `reportRunLineProgress` and touches only the registry, so a
- *     typed run can never make the agent start talking about background
- *     progress mid-call.
+ *     through `reportRunLineProgress`, touches only the registry, and — see
+ *     its own doc — deliberately writes no slot runId, opens no panel, and
+ *     drives no navigation.
  */
 /** Abort every live line reader and invalidate their callbacks (call teardown).
  * Subscribed below to fire whenever a call leaves in_call/connecting. */
 export declare const abortAllLineReaders: () => void;
 /** Test-only: drop every plain-progress reader (and the active-session latch)
- * so a case never inherits either from the previous case. The narration
+ * so a case never inherits either from the previous case. The slot
  * readers have `abortAllLineReaders`; these deliberately do NOT ride on it — a
  * voice call ending has nothing to do with a typed run still streaming. */
 export declare const __detachLineProgressReadersForTest: () => void;
@@ -66,8 +68,8 @@ export declare const __detachLineProgressReadersForTest: () => void;
  * TWO paths, because the two dispatch kinds have genuinely different
  * contracts (BEL-90 / B1 — see `attachLineProgressReader`'s doc):
  *
- *  - F3/R4, UNCHANGED — a line whose durable SLOT carries a runId was
- *    dispatched by voice. It gets the narration reader, on every line that has
+ *  - F3/R4, UNCHANGED — a line whose durable SLOT carries a runId went
+ *    through `dispatchToLine`. It gets the slot reader, on every line that has
  *    one, INCLUDING when its session is the one on screen. That last part is
  *    load-bearing: `persistSlotRun(line, null)` in that reader's terminal
  *    callbacks is the durable slot's clearer, and skipping the on-screen line

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

@@ -26,6 +26,12 @@ export type RealtimeCallHandle = {
     readonly sendEvent: (event: Record<string, unknown>) => void;
     /** Toggle the local mic track without renegotiating. */
     readonly setMuted: (muted: boolean) => void;
+    /** Ask the browser to play the agent's audio again after it refused (see
+     * {@link ConnectRealtimeCallInput.onAudioBlocked}). Resolves true only when
+     * playback actually started. Call it STRAIGHT from the user's tap handler:
+     * the `play()` inside runs before the first await, so the gesture the
+     * browser is holding out for is still on the stack. */
+    readonly resumeAudio: () => Promise<boolean>;
     /** Tear down mic, peer connection, and audio playback. Idempotent. */
     readonly close: () => void;
 };
@@ -52,5 +58,11 @@ export type ConnectRealtimeCallInput = {
         readonly local: MediaStream;
         readonly remote: MediaStream;
     }) => void;
+    /** Fired when the browser REFUSES to play the agent's audio. `autoplay` is
+     * a request, not a guarantee — a page that reloaded mid-call has no fresh
+     * user gesture behind it — and a refusal we never asked about is completely
+     * silent: the call looks connected and says nothing. The store turns this
+     * into a one-tap "Tap to hear" control (`resumeAudio` above). */
+    readonly onAudioBlocked?: () => void;
 };
 export declare const connectRealtimeCall: (input: ConnectRealtimeCallInput) => Promise<ConnectRealtimeCallResult>;

package/dist/embed/voice/reconnect-offer.d.ts

@@ -2,12 +2,19 @@
  * "A call was interrupted — tap to reconnect" — the one-bit store that turns a
  * surviving call marker (`call-active-marker.ts`) into a USER-DRIVEN redial.
  *
- * The dock's boot effect raises the offer; the rail's CallButton reads it and,
- * while it stands, dials with `{ isReconnect: true }` (carrying the interrupted
+ * This is the FALLBACK half of reload survival: the dock's boot effect dials
+ * an interrupted call back on its own when the marker clears
+ * `decideReconnectAction`'s gates, and raises this offer when it does not —
+ * a marker too stale to prove the call was live moments ago, or one already
+ * redialed up to the consecutive-redial cap. It raises the offer again when a
+ * redial the gates DID allow fails to connect, so a flaky call-token endpoint
+ * costs the user one automatic attempt rather than the whole call (see
+ * `watchRedialForFallback` in BelongDock.tsx). Whenever it stands, the rail's
+ * CallButton dials with `{ isReconnect: true }` (carrying the interrupted
  * call's context digest) and labels itself "Reconnect" instead of "Start voice
  * call". That is the whole mechanism: ONE user click, on a control that is
- * already always visible in the rail — no new surface, and crucially no
- * microphone access without a gesture.
+ * already always visible in the rail — no new surface, and no microphone
+ * access without a gesture on exactly the marker the gates declined to trust.
  *
  * Why a separate store rather than a field on `CallState`: the call state is
  * rebuilt from `IDLE` on every dial and every terminal error, which would wipe
@@ -18,7 +25,9 @@
  */
 export declare const peekReconnectOffer: () => boolean;
 export declare const subscribeReconnectOffer: (listener: () => void) => (() => void);
-/** Raise the offer (dock boot, when `decideReconnectOffer` says so). */
+/** Raise the offer: at dock boot when `decideReconnectAction` says `"offer"`
+ * (a marker too stale, or too many redials deep, to dial back on its own), and
+ * when a redial it DID allow ends in `error` without ever reaching the call. */
 export declare const offerReconnect: () => void;
 /**
  * Take the offer down. Called when the user acts on it (the reconnect click),