@belonguniverseai/react-sdk 0.1.4 → 0.1.6

package/dist/i18n/messages/surfaces/usage.d.ts

@@ -19,3 +19,13 @@ export declare const usageEs: {
         turnsThisSessionOther: string;
     };
 };
+export declare const usagePt: {
+    usage: {
+        tooltip: string;
+        context: string;
+        tokens: string;
+        lastTurn: string;
+        turnsThisSessionOne: string;
+        turnsThisSessionOther: string;
+    };
+};

package/dist/stream/stream-state-store.d.ts

@@ -30,8 +30,29 @@ declare const streamStateSchema: z.ZodObject<{
     lastEventId: string | null;
 }>;
 export type PersistedStreamState = z.infer<typeof streamStateSchema>;
+/**
+ * The tab's active stream state.
+ *
+ * Reads the AUTHORITATIVE per-tab record from `sessionStorage`. On a brand-new
+ * tab (no record yet AND this tab hasn't already decided), adopts the SHARED
+ * localStorage seed's `sessionId` — with a null run cursor, so the new tab opens
+ * the most-recent conversation from history rather than resuming another tab's
+ * live run. The adoption is one-time: it marks the tab "seeded" so a later
+ * read (e.g. after a New-chat clear) doesn't re-adopt.
+ *
+ * A record present at the FIRST read of this page realm is provenance-checked
+ * (see the duplicate-tab block above): a duplicated tab keeps the session but
+ * is demoted off the live run cursor.
+ */
 export declare const readStreamState: (workspaceId?: string | null) => PersistedStreamState | null;
 export declare const writeStreamState: (state: Omit<PersistedStreamState, "updatedAt">, workspaceId?: string | null) => void;
+/**
+ * Clear THIS TAB's pointer (New chat). Removes only the per-tab sessionStorage
+ * record and marks the tab "seeded" so a reload stays blank instead of
+ * re-adopting the shared seed. The localStorage seed is deliberately left
+ * intact: another tab's most-recent conversation, and the next brand-new tab's
+ * starting point, must not be wiped by one tab starting a fresh chat.
+ */
 export declare const clearStreamState: (workspaceId?: string | null) => void;
 /**
  * Like {@link readStreamState}, but only returns state fresh enough that its
@@ -64,4 +85,10 @@ export declare const subscribeStreamState: (listener: () => void) => (() => void
  * memo cache needed).
  */
 export declare const peekActiveSessionId: () => string | null;
+/** Test-only: forget the per-tab seed cache + provenance state (does NOT touch
+ * Web Storage — a test clears sessionStorage/localStorage itself). */
+export declare const __resetStreamStateStoreForTest: () => void;
+/** Test-only: pin the navigation type the duplicate-tab check sees (jsdom has
+ * no PerformanceNavigationTiming entry, so tests set it explicitly). */
+export declare const __setNavigationTypeForTest: (type: "reload" | "back_forward" | "navigate") => void;
 export {};

package/dist/types/public.d.ts

@@ -83,7 +83,7 @@ export type PartialBelongTheme = {
 /** Built-in theme presets selectable via `belong.applyPreset(name)`. */
 export type PresetName = "belong" | "simetrik" | "custom";
 /** UI languages the dock ships. `setLocale` / `init({ locale })` accept these. */
-export type BelongLocale = "en" | "es";
+export type BelongLocale = "en" | "es" | "pt";
 export type BelongInitInput = {
     /** Belong cloud base URL, e.g. `https://api.belong.host` or `http://localhost:8787`. */
     readonly apiBaseUrl: string;
@@ -131,10 +131,13 @@ export type BelongInitInput = {
         readonly ttsChunkGapMs?: number;
     };
     /**
-     * Agent-grant (delegated CLI session) host context. When `scopeExternalId`
-     * is set — the host's active workspace id on the provider's side — the dock
-     * offers the consent card ("allow the agent to act on my behalf") and shows
-     * the session state. Omit it and the grant surface stays hidden.
+     * Agent-grant (delegated CLI session) host context. The grant surface follows
+     * the ACTIVE WORKSPACE: whenever one is in scope — via `scopeExternalId` /
+     * `scopeUrlParam` here, or `setWorkspace` — the dock offers the consent card
+     * ("allow the agent to act on my behalf") for it, using the default provider.
+     * This object is OPTIONAL: set it only to pick a non-default `provider` or to
+     * track the workspace from a URL param. With no workspace in scope at all, the
+     * grant surface stays hidden.
      */
     readonly agentGrant?: {
         /** Grant provider key. Defaults to `"simetrik"`. */

package/package.json

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