@belonguniverseai/react-sdk 0.4.3 → 0.6.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

@@ -44,6 +44,14 @@ export declare const en: {
         readonly toolGenericDone: "Finished {{tool}}";
         readonly toolGenericFailed: "{{tool}} didn't complete";
         readonly toolGenericDetail: "Used the {{tool}} capability.";
+        readonly toolRememberRunning: "Saving a note";
+        readonly toolRememberDone: "Saved a note";
+        readonly toolRememberFailed: "Couldn't save the note";
+        readonly toolRememberDetail: "Saved a note about you for future conversations.";
+        readonly toolForgetRunning: "Forgetting a note";
+        readonly toolForgetDone: "Forgot a note";
+        readonly toolForgetFailed: "Couldn't forget the note";
+        readonly toolForgetDetail: "Deleted a saved note about you.";
         readonly browserSnapshot: "Took a snapshot";
         readonly browserRead: "Read the page";
         readonly browserClick: "Clicked an element";
@@ -58,6 +66,13 @@ export declare const en: {
         readonly executingTasks: "Working on it…";
         readonly workedSteps_one: "Worked · {{count}} step";
         readonly workedSteps_other: "Worked · {{count}} steps";
+        readonly subagentRunning: "Subagent · {{description}}…";
+        readonly subagentDone: "Subagent · {{description}}";
+        readonly subagentDoneSteps_one: "Subagent · {{description}} · {{count}} step";
+        readonly subagentDoneSteps_other: "Subagent · {{description}} · {{count}} steps";
+        readonly subagentFailed: "Subagent · {{description}} · didn't finish";
+        readonly subagentTimedOut: "Subagent · {{description}} · ran out of time";
+        readonly subagentVia: "via {{name}}";
         readonly cliAuthStop: {
             readonly noGrant: "Connect to Simetrik to continue";
             readonly reconnectFailed: "Couldn't connect to Simetrik";
@@ -480,9 +495,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 +513,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 roleLabelCli: "{{product}} CLI agent";
+        readonly roleLabelTerminal: "Terminal 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/i18n/messages/surfaces/stream.d.ts

@@ -44,6 +44,14 @@ export declare const streamEn: {
         readonly toolGenericDone: "Finished {{tool}}";
         readonly toolGenericFailed: "{{tool}} didn't complete";
         readonly toolGenericDetail: "Used the {{tool}} capability.";
+        readonly toolRememberRunning: "Saving a note";
+        readonly toolRememberDone: "Saved a note";
+        readonly toolRememberFailed: "Couldn't save the note";
+        readonly toolRememberDetail: "Saved a note about you for future conversations.";
+        readonly toolForgetRunning: "Forgetting a note";
+        readonly toolForgetDone: "Forgot a note";
+        readonly toolForgetFailed: "Couldn't forget the note";
+        readonly toolForgetDetail: "Deleted a saved note about you.";
         readonly browserSnapshot: "Took a snapshot";
         readonly browserRead: "Read the page";
         readonly browserClick: "Clicked an element";
@@ -58,6 +66,14 @@ export declare const streamEn: {
         readonly executingTasks: "Working on it…";
         readonly workedSteps_one: "Worked · {{count}} step";
         readonly workedSteps_other: "Worked · {{count}} steps";
+        readonly subagentRunning: "Subagent · {{description}}…";
+        readonly subagentDone: "Subagent · {{description}}";
+        readonly subagentDoneSteps_one: "Subagent · {{description}} · {{count}} step";
+        readonly subagentDoneSteps_other: "Subagent · {{description}} · {{count}} steps";
+        readonly subagentFailed: "Subagent · {{description}} · didn't finish";
+        readonly subagentTimedOut: "Subagent · {{description}} · ran out of time";
+        /** Attribution chip on an inner tool card. Attribution, not nesting. */
+        readonly subagentVia: "via {{name}}";
         readonly cliAuthStop: {
             readonly noGrant: "Connect to Simetrik to continue";
             readonly reconnectFailed: "Couldn't connect to Simetrik";
@@ -109,6 +125,14 @@ export declare const streamEs: {
         toolGenericDone: string;
         toolGenericFailed: string;
         toolGenericDetail: string;
+        toolRememberRunning: string;
+        toolRememberDone: string;
+        toolRememberFailed: string;
+        toolRememberDetail: string;
+        toolForgetRunning: string;
+        toolForgetDone: string;
+        toolForgetFailed: string;
+        toolForgetDetail: string;
         browserSnapshot: string;
         browserRead: string;
         browserClick: string;
@@ -123,6 +147,13 @@ export declare const streamEs: {
         executingTasks: string;
         workedSteps_one: string;
         workedSteps_other: string;
+        subagentRunning: string;
+        subagentDone: string;
+        subagentDoneSteps_one: string;
+        subagentDoneSteps_other: string;
+        subagentFailed: string;
+        subagentTimedOut: string;
+        subagentVia: string;
         cliAuthStop: {
             noGrant: string;
             reconnectFailed: string;
@@ -174,6 +205,14 @@ export declare const streamPt: {
         toolGenericDone: string;
         toolGenericFailed: string;
         toolGenericDetail: string;
+        toolRememberRunning: string;
+        toolRememberDone: string;
+        toolRememberFailed: string;
+        toolRememberDetail: string;
+        toolForgetRunning: string;
+        toolForgetDone: string;
+        toolForgetFailed: string;
+        toolForgetDetail: string;
         browserSnapshot: string;
         browserRead: string;
         browserClick: string;
@@ -188,6 +227,13 @@ export declare const streamPt: {
         executingTasks: string;
         workedSteps_one: string;
         workedSteps_other: string;
+        subagentRunning: string;
+        subagentDone: string;
+        subagentDoneSteps_one: string;
+        subagentDoneSteps_other: string;
+        subagentFailed: string;
+        subagentTimedOut: string;
+        subagentVia: string;
         cliAuthStop: {
             noGrant: string;
             reconnectFailed: string;

package/dist/stream/ai-sdk-part-renderers.d.ts

@@ -1,4 +1,26 @@
-import { BelongDataParts, BelongUIMessage, SandboxCommandData, ToolCallData } from './belong-data-parts.ts';
+import { BelongDataParts, BelongUIMessage, SandboxCommandData, SubagentData, ToolCallData } from './belong-data-parts.ts';
+/** One tool call in an activity run, paired (for shell) with its same-id output. */
+export type ToolActivityItem = {
+    readonly tool: ToolCallData;
+    readonly output: SandboxCommandData | null;
+};
+/**
+ * BEL-199 — a delegated subagent in an activity run. It sits INSIDE the one
+ * collapsed line beside the tool items, never beside the group.
+ */
+export type SubagentActivityItem = {
+    readonly kind: "subagent";
+    readonly subagentId: string;
+    readonly data: SubagentData;
+};
+/**
+ * Deliberate shape note: the TOOL variant carries no `kind` discriminant. It is
+ * the shape every existing fixture and story already builds, and a subagent item
+ * is distinguishable without one (`"kind" in item`) — so this stays a sound
+ * union while a required discriminant would have churned ~25 unrelated call
+ * sites across four story files for no safety the guard below doesn't give.
+ */
+export type ActivityItem = ToolActivityItem | SubagentActivityItem;
 export declare const ActivityGroup: ({ items, live, }: {
     readonly items: readonly ActivityItem[];
     readonly live?: boolean | undefined;
@@ -44,11 +66,6 @@ export type PartRendererProps = {
  * `reasoning` parts.
  */
 export declare const PartRenderer: ({ part, onExecutePlan, historical }: PartRendererProps) => import("react").JSX.Element | null;
-/** One tool call in an activity run, paired (for shell) with its same-id output. */
-export type ActivityItem = {
-    readonly tool: ToolCallData;
-    readonly output: SandboxCommandData | null;
-};
 export type RenderGroup = {
     readonly kind: "part";
     readonly part: BelongMessagePart;

package/dist/stream/belong-chat-transport.d.ts

@@ -145,16 +145,19 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<"type", [z.Zo
         reason: z.ZodString;
         state: z.ZodEnum<["pending", "approved", "rejected", "amend_requested", "expired"]>;
         toolName: z.ZodOptional<z.ZodString>;
+        subagentId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         reason: string;
         approvalId: string;
         state: "pending" | "approved" | "rejected" | "amend_requested" | "expired";
         toolName?: string | undefined;
+        subagentId?: string | undefined;
     }, {
         reason: string;
         approvalId: string;
         state: "pending" | "approved" | "rejected" | "amend_requested" | "expired";
         toolName?: string | undefined;
+        subagentId?: string | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     id: string;
@@ -163,6 +166,7 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<"type", [z.Zo
         approvalId: string;
         state: "pending" | "approved" | "rejected" | "amend_requested" | "expired";
         toolName?: string | undefined;
+        subagentId?: string | undefined;
     };
     type: "data-approval-request";
 }, {
@@ -172,6 +176,7 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<"type", [z.Zo
         approvalId: string;
         state: "pending" | "approved" | "rejected" | "amend_requested" | "expired";
         toolName?: string | undefined;
+        subagentId?: string | undefined;
     };
     type: "data-approval-request";
 }>, z.ZodObject<{
@@ -195,6 +200,7 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<"type", [z.Zo
             code: string;
             severity?: "error" | "stop" | undefined;
         }>>;
+        subagentId: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         toolName: string;
         state: "completed" | "failed" | "started";
@@ -205,6 +211,7 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<"type", [z.Zo
         } | undefined;
         input?: Record<string, unknown> | undefined;
         output?: Record<string, unknown> | null | undefined;
+        subagentId?: string | undefined;
     }, {
         toolName: string;
         state: "completed" | "failed" | "started";
@@ -215,6 +222,7 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<"type", [z.Zo
         } | undefined;
         input?: Record<string, unknown> | undefined;
         output?: Record<string, unknown> | null | undefined;
+        subagentId?: string | undefined;
     }>;
 }, "strip", z.ZodTypeAny, {
     id: string;
@@ -228,6 +236,7 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<"type", [z.Zo
         } | undefined;
         input?: Record<string, unknown> | undefined;
         output?: Record<string, unknown> | null | undefined;
+        subagentId?: string | undefined;
     };
     type: "data-tool-call";
 }, {
@@ -242,8 +251,56 @@ export declare const wireStreamPartSchema: z.ZodDiscriminatedUnion<"type", [z.Zo
         } | undefined;
         input?: Record<string, unknown> | undefined;
         output?: Record<string, unknown> | null | undefined;
+        subagentId?: string | undefined;
     };
     type: "data-tool-call";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"data-subagent">;
+    id: z.ZodString;
+    data: z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        state: z.ZodEnum<["running", "finished", "failed"]>;
+        stepsUsed: z.ZodOptional<z.ZodNumber>;
+        summary: z.ZodOptional<z.ZodString>;
+        timedOut: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        state: "failed" | "running" | "finished";
+        description: string;
+        stepsUsed?: number | undefined;
+        summary?: string | undefined;
+        timedOut?: boolean | undefined;
+    }, {
+        name: string;
+        state: "failed" | "running" | "finished";
+        description: string;
+        stepsUsed?: number | undefined;
+        summary?: string | undefined;
+        timedOut?: boolean | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    data: {
+        name: string;
+        state: "failed" | "running" | "finished";
+        description: string;
+        stepsUsed?: number | undefined;
+        summary?: string | undefined;
+        timedOut?: boolean | undefined;
+    };
+    type: "data-subagent";
+}, {
+    id: string;
+    data: {
+        name: string;
+        state: "failed" | "running" | "finished";
+        description: string;
+        stepsUsed?: number | undefined;
+        summary?: string | undefined;
+        timedOut?: boolean | undefined;
+    };
+    type: "data-subagent";
 }>, z.ZodObject<{
     type: z.ZodLiteral<"data-sandbox-command">;
     id: z.ZodString;

package/dist/stream/belong-data-parts.d.ts

@@ -40,6 +40,12 @@ export type ApprovalRequestData = {
      * messages; render the generic label when undefined.
      */
     readonly toolName?: string | undefined;
+    /**
+     * BEL-199 attribution — the `data-subagent` part id whose gated call raised this
+     * card. The resolution event (`approval_state_changed`) carries no subagentId, so
+     * last-write-wins by part id drops it on resolve: pending-card-only by design.
+     */
+    readonly subagentId?: string | undefined;
 };
 /**
  * BEL-93 — a friendly question widget the agent emits instead of dumping a wall
@@ -105,6 +111,41 @@ export type ToolCallData = {
         readonly message: string;
         readonly severity?: ToolErrorSeverity | undefined;
     } | undefined;
+    /**
+     * BEL-199 — the `data-subagent` part id this call ran INSIDE. Absent on every
+     * main-loop call (and on every part emitted before BEL-199). The expanded
+     * activity group chips a matching item with a muted "via <name>" —
+     * attribution, not nesting.
+     */
+    readonly subagentId?: string | undefined;
+};
+/**
+ * BEL-199 — one delegated subagent. `running → finished | failed`, one part per
+ * subagent, reconciled by id like every other lifecycle part.
+ *
+ * It renders as an ACTIVITY ITEM: one thin line INSIDE the §42 collapsed
+ * activity line, never a card beside it. A failed subagent carries no
+ * `ToolErrorSeverity` — deliberately, so it can never reach the collapsed line:
+ * the parent agent reads the failure in its tool result and recovers, and
+ * surfacing it would read as breakage. Nothing about it is ever red.
+ */
+export type SubagentState = "running" | "finished" | "failed";
+export type SubagentData = {
+    /** Registry name, e.g. "general-purpose" — the "via <name>" chip's text. */
+    readonly name: string;
+    /** The model's own task label; this is what the line shows. */
+    readonly description: string;
+    readonly state: SubagentState;
+    readonly stepsUsed?: number | undefined;
+    readonly summary?: string | undefined;
+    /**
+     * The failure was the wall-clock budget, not an error — an optional EXTRA
+     * field rather than a fourth `state` (an unknown enum value would make an
+     * older dock drop the whole part; an unknown field it ignores). Lets the line
+     * say "ran out of time" in the reader's language instead of relaying English
+     * server prose.
+     */
+    readonly timedOut?: boolean | undefined;
 };
 export type SandboxCommandData = {
     readonly state: SandboxCommandState;
@@ -181,6 +222,8 @@ export type BelongDataParts = {
     "approval-request": ApprovalRequestData;
     "choice-request": ChoiceRequestData;
     "tool-call": ToolCallData;
+    /** BEL-199 — a delegated subagent, folded into the §42 activity line. */
+    subagent: SubagentData;
     "sandbox-command": SandboxCommandData;
     "ui-action": UiActionData;
     "cli-reconnect": CliReconnectData;
@@ -213,5 +256,5 @@ export type WireDataPart<NAME extends keyof BelongDataParts> = {
     readonly id: string;
     readonly data: BelongDataParts[NAME];
 };
-export type WireStreamPart = WireTextPart | WireDataPart<"reasoning"> | WireDataPart<"plan"> | WireDataPart<"approval-request"> | WireDataPart<"choice-request"> | WireDataPart<"tool-call"> | WireDataPart<"sandbox-command"> | WireDataPart<"ui-action"> | WireDataPart<"cli-reconnect"> | WireDataPart<"navigation"> | WireDataPart<"artifact"> | WireDataPart<"status"> | WireDataPart<"usage">;
+export type WireStreamPart = WireTextPart | WireDataPart<"reasoning"> | WireDataPart<"plan"> | WireDataPart<"approval-request"> | WireDataPart<"choice-request"> | WireDataPart<"tool-call"> | WireDataPart<"subagent"> | WireDataPart<"sandbox-command"> | WireDataPart<"ui-action"> | WireDataPart<"cli-reconnect"> | WireDataPart<"navigation"> | WireDataPart<"artifact"> | WireDataPart<"status"> | WireDataPart<"usage">;
 export type WireStreamPartType = WireStreamPart["type"];

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.6.0",
   "description": "Belong — embeddable React AI assistant dock. Mount <BelongWidget> in your app tree with getToken dependency-injection auth.",
   "license": "UNLICENSED",
   "type": "module",