@belonguniverseai/react-sdk 0.1.2 → 0.1.4-beta

package/dist/stream/message-metadata.d.ts

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+export declare const belongMessageMetadataSchema: z.ZodObject<{
+    /** Producing task of an assistant turn — the reload-stable feedback key. */
+    taskId: z.ZodOptional<z.ZodString>;
+    /** The user's current 👍/👎 on that turn; `.nullish()` because the live
+     *  `start` chunk stamps no vote yet while history returns `null` for
+     *  "no vote" (requiring it would hide the thumbs on a fresh turn). */
+    feedback: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        sentiment: z.ZodEnum<["up", "down"]>;
+        reason: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        reason: string | null;
+        sentiment: "up" | "down";
+    }, {
+        reason: string | null;
+        sentiment: "up" | "down";
+    }>>>;
+    /** Server row creation time (ISO) — per-bubble clock, history only (§41). */
+    createdAt: z.ZodOptional<z.ZodString>;
+    /** Skill picked for this user message — renders the bubble's skill chip. */
+    skill: z.ZodOptional<z.ZodString>;
+    /** Set by `loadSessionHistory` on every restored message. Gates the
+     *  dispatch renderers' auto-fire: absent (live/replayed turn) → fire once;
+     *  true (restored history) → render settled, never re-dispatch. */
+    fromHistory: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    createdAt?: string | undefined;
+    taskId?: string | undefined;
+    skill?: string | undefined;
+    feedback?: {
+        reason: string | null;
+        sentiment: "up" | "down";
+    } | null | undefined;
+    fromHistory?: boolean | undefined;
+}, {
+    createdAt?: string | undefined;
+    taskId?: string | undefined;
+    skill?: string | undefined;
+    feedback?: {
+        reason: string | null;
+        sentiment: "up" | "down";
+    } | null | undefined;
+    fromHistory?: boolean | undefined;
+}>;
+export type BelongMessageMetadata = z.infer<typeof belongMessageMetadataSchema>;

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

@@ -30,9 +30,9 @@ declare const streamStateSchema: z.ZodObject<{
     lastEventId: string | null;
 }>;
 export type PersistedStreamState = z.infer<typeof streamStateSchema>;
-export declare const readStreamState: () => PersistedStreamState | null;
-export declare const writeStreamState: (state: Omit<PersistedStreamState, "updatedAt">) => void;
-export declare const clearStreamState: () => void;
+export declare const readStreamState: (workspaceId?: string | null) => PersistedStreamState | null;
+export declare const writeStreamState: (state: Omit<PersistedStreamState, "updatedAt">, workspaceId?: string | null) => void;
+export declare const clearStreamState: (workspaceId?: string | null) => void;
 /**
  * Like {@link readStreamState}, but only returns state fresh enough that its
  * run is worth reconnecting to. Returns null for stale state WITHOUT clearing
@@ -40,7 +40,7 @@ export declare const clearStreamState: () => void;
  * and history restore on reload — only the *run* is too old to resume. A new
  * message overwrites the cursor via {@link writeStreamState}.
  */
-export declare const readResumableStreamState: () => PersistedStreamState | null;
+export declare const readResumableStreamState: (workspaceId?: string | null) => PersistedStreamState | null;
 /**
  * Persist the chosen session as the active stream session (sessions menu
  * switch / new). Passing a session id points the next ChatRoute mount at that

package/dist/types/public.d.ts

@@ -82,15 +82,18 @@ export type PartialBelongTheme = {
 };
 /** Built-in theme presets selectable via `belong.applyPreset(name)`. */
 export type PresetName = "belong" | "simetrik" | "custom";
-/** Dock UI language. English is the default; Spanish is the localized option. */
+/** UI languages the dock ships. `setLocale` / `init({ locale })` accept these. */
 export type BelongLocale = "en" | "es";
 export type BelongInitInput = {
     /** Belong cloud base URL, e.g. `https://api.belong.host` or `http://localhost:8787`. */
     readonly apiBaseUrl: string;
     /**
-     * Dock UI language for first-run + onboarding copy. Defaults to `"en"`; a
-     * Spanish-first tenant can pass `"es"`. The end user can still override it
-     * with the in-dock language toggle. (BEL-onboarding-i18n)
+     * Dock UI language. When omitted the dock auto-detects: a stored user choice
+     * ▸ the browser language ▸ English. Set it to default the deployment's
+     * language (a Spanish-first tenant passes `"es"`); the end user can still
+     * switch with the in-dock toggle. Re-`init` (or `belong.setLocale`) with a
+     * DIFFERENT value relabels the dock live — the host's language switch wins
+     * over a stale in-dock choice (BEL-140).
      */
     readonly locale?: BelongLocale;
     /** Where to mount the dock. Defaults to `document.body`. */
@@ -172,6 +175,19 @@ export type UiActionHandler<I = unknown, O = unknown> = (input: I) => Promise<Ui
 export type BelongGlobal = {
     readonly init: (input: BelongInitInput) => Promise<void>;
     readonly setToken: (jwt: string) => void;
+    /** Switch the dock UI language at runtime (persisted; relabels live). */
+    readonly setLocale: (locale: BelongLocale) => void;
+    /**
+     * Switch the dock's workspace at runtime (workspace isolation). Re-scopes
+     * the whole dock synchronously — session list, Files tab, chat, and the
+     * agent's Simetrik CLI credential all follow the given workspace id (the
+     * same value `agentGrant.scopeExternalId` / the `scopeUrlParam` URL param
+     * carry). Wins over URL tracking until cleared with `null` (which falls
+     * back to the URL/static resolution). Invalid ids are ignored with a
+     * console warning. Hosts can use this standalone (no `scopeUrlParam`) or
+     * alongside URL tracking for instant switches.
+     */
+    readonly setWorkspace: (id: string | null) => void;
     readonly setTheme: (theme: PartialBelongTheme) => void;
     readonly applyPreset: (name: PresetName) => void;
     readonly open: () => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@belonguniverseai/react-sdk",
-  "version": "0.1.2",
+  "version": "0.1.4-beta",
   "description": "Belong — embeddable React AI assistant dock. Mount <BelongWidget> in your app tree with getToken dependency-injection auth.",
   "license": "UNLICENSED",
   "type": "module",
@@ -40,6 +40,6 @@
   "homepage": "https://github.com/Belong-Universe/agent-as-a-service/tree/main/packages/belong-sdk",
   "publishConfig": {
     "access": "public",
-    "provenance": true
+    "provenance": false
   }
 }