@belonguniverseai/react-sdk 0.6.4 → 0.6.6

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

@@ -1,4 +1,5 @@
 import { CommandSummary, SkillSummary } from '../api/skills.ts';
+import { PrePromptSummary } from '../api/pre-prompts.ts';
 /** 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. */
@@ -93,6 +94,50 @@ export declare const applySlashCommand: (text: string, match: SlashTokenMatch, n
     readonly text: string;
     readonly caret: number;
 };
+/**
+ * Replace the matched `/query` token with the FULL saved body; returns the new
+ * draft + the caret at the end of the insert.
+ *
+ * Deliberately NOT the same splice as {@link applySlashCommand}: that one
+ * inserts `/name ` — with a trailing space — so it absorbs a space already at
+ * the splice point to avoid a double space. A body carries no trailing space,
+ * so absorbing one would glue the saved text to the following word. The token
+ * is replaced EXACTLY; prose on both sides survives untouched.
+ */
+export declare const applySlashPrompt: (text: string, match_: SlashTokenMatch, body: string) => {
+    readonly text: string;
+    readonly caret: number;
+};
+/**
+ * The section a saved pre-prompt renders under. A stable IDENTITY string (React
+ * keys + {@link bucketByGroup}'s tier), NOT the display label — SlashCommandMenu
+ * localizes "Your prompts" separately, the same split {@link COMMAND_GROUP}
+ * already has.
+ */
+export declare const PRE_PROMPT_GROUP = "Your prompts";
+/**
+ * Merge a user's saved pre-prompts into the composer's option list, and hand
+ * back the name → body map the composer splices from.
+ *
+ * THIS is where the ticket's precedence — builtins > skills > workspace
+ * commands > pre-prompts — is resolved: a prompt whose name is already claimed
+ * by a builtin or by anything in `skills` (which `paletteOptions` in chat.tsx
+ * has already ordered commands-then-skills) is DROPPED. Survivors append after
+ * the skills, and `bodyByName` is built from the SAME survivor set, so the
+ * rendered options and the bodies they insert can never disagree.
+ *
+ * A name shadowed AFTER the fact (the user saves `reconciliation`, the tenant
+ * later publishes a skill by that name) silently loses its menu row here. The
+ * save dialog blocks the collision at save time; surfacing a later shadow is a
+ * follow-up, not this slice.
+ */
+export declare const mergeSlashOptions: ({ skills, prompts, }: {
+    readonly skills: readonly SkillSummary[];
+    readonly prompts: readonly PrePromptSummary[];
+}) => {
+    readonly options: readonly SkillSummary[];
+    readonly bodyByName: ReadonlyMap<string, string>;
+};
 /**
  * Extract the FIRST `/name` token — anywhere in the draft — matching a known
  * skill. Returns the skill + the draft with the token spliced out, or null

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

@@ -0,0 +1,36 @@
+/**
+ * The dock's hidden VOICE unlock — a cheat code typed into the chat composer
+ * (`belong:call`) reveals the dial button for THIS browser while
+ * `VOICE_CALL_BUTTON_ENABLED` (components/embed/rail-flags.ts) keeps it hidden
+ * for everyone else.
+ *
+ * Deliberately the same shape as dev-mode.ts's `belong:dev`: same exact-match
+ * recognizer, same localStorage persistence, same tiny external store so a
+ * surface outside the chat route (the rail, the mobile nav) re-renders when the
+ * composer flips it. Someone who knows one code can guess how the other behaves.
+ *
+ * This unlocks an ENTRY POINT, nothing else. The voice stack — `startCall`, the
+ * CallScreen, push-to-talk, the reload-survival redial — is always live and
+ * unchanged; the flag only decided whether a button was drawn. So this is a
+ * visibility toggle, not a feature flag with behaviour behind it, and it grants
+ * no capability a user with the button showing would not already have.
+ *
+ * Toggling, not a one-way door: typing the code again hides the button. A user
+ * who turned voice on for a demo must be able to turn it off without clearing
+ * site data.
+ */
+export declare const VOICE_CHEAT_CODE = "belong:call";
+/** True when the typed text is the cheat code (trim + case-insensitive).
+ * EXACT match only — asking the agent "what is belong:call?" must reach the
+ * agent as a question, not vanish into a toggle. */
+export declare const isVoiceCheatCode: (text: string) => boolean;
+/** `useSyncExternalStore` subscribe — fires whenever the unlock changes. */
+export declare const subscribeVoiceUnlock: (listener: () => void) => (() => void);
+/**
+ * Whether this browser has opted into the dial button. Storage that throws
+ * (Safari private mode, cookies disabled) reads as LOCKED — the safe default,
+ * and the same best-effort idiom the rest of the embed layer uses.
+ */
+export declare const readVoiceUnlocked: () => boolean;
+/** Flip the unlock (the cheat code's only effect) and notify every surface. */
+export declare const toggleVoiceUnlocked: () => void;

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

@@ -241,6 +241,47 @@ export declare const en: {
         readonly approveAndRun: "Approve & run";
         readonly reject: "Reject";
     };
+    readonly prompts: {
+        readonly saveAsPrompt: "Save as prompt";
+        readonly dialogTitle: "Save this as a prompt";
+        readonly dialogDescription: string;
+        readonly nameLabel: "Name";
+        readonly namePlaceholder: "monthly-recon";
+        readonly descriptionLabel: "Description (optional)";
+        readonly descriptionPlaceholder: "What this prompt does";
+        readonly bodyLabel: "What gets saved";
+        readonly save: "Save prompt";
+        readonly cancel: "Cancel";
+        readonly saving: "Saving…";
+        readonly errorNameEmpty: "Give your prompt a name.";
+        readonly errorNameInvalid: "Use lowercase letters, numbers and dashes — like monthly-recon.";
+        readonly errorNameBuiltin: "That name is already a built-in command. Pick another.";
+        readonly errorNameSkill: "A skill already uses that name. Pick another.";
+        readonly errorNameCommand: "A command already uses that name. Pick another.";
+        readonly errorNamePrompt: "You already have a prompt with that name.";
+        readonly errorSaveFailed: "Couldn't save your prompt — try again.";
+        readonly viewTitle: "Prompts";
+        readonly subtitle: "The prompts you saved. Type / in the message box to run one.";
+        readonly searchPlaceholder: "Search your prompts";
+        readonly loading: "Loading your prompts…";
+        readonly loadError: "Couldn't load your prompts.";
+        readonly empty: "No saved prompts yet.";
+        readonly emptyHint: "Write a message, then choose Save as prompt to keep it here.";
+        readonly noResults: "No prompts match “{{q}}”.";
+        readonly new: "New prompt";
+        readonly bodyPlaceholder: "The message that runs when you use it";
+        readonly actionsMenu: "Prompt actions";
+        readonly edit: "Edit";
+        readonly delete: "Delete";
+        readonly editTitle: "Edit prompt";
+        readonly editDescription: string;
+        readonly saveChanges: "Save changes";
+        readonly deleteConfirmTitle: "Delete this prompt?";
+        readonly deleteConfirmBody: "It disappears from the / menu. Your past messages are untouched.";
+        readonly deleteConfirm: "Delete prompt";
+        readonly errorEditFailed: "Couldn't save your changes — try again.";
+        readonly errorGone: "That prompt is no longer there.";
+    };
     readonly login: {
         readonly welcome: "Welcome to {{name}}";
         readonly byBelong: "by Belong";
@@ -252,6 +293,7 @@ export declare const en: {
         readonly navChat: "Chat";
         readonly navFiles: "Files";
         readonly navScheduled: "Scheduled";
+        readonly navPrompts: "Prompts";
         readonly chatPlanRunning: "Chat — plan running, {{completed}} of {{total}} steps done";
         readonly devMode: "Dev mode";
         readonly devModeTitle: "Dev mode (belong:dev)";
@@ -313,6 +355,7 @@ export declare const en: {
     };
     readonly embed: {
         readonly yourSkills: "Your skills";
+        readonly yourPrompts: "Your prompts";
         readonly skillsMenuLabel: "Skills";
         readonly minimizeSkills: "Minimize skills";
         readonly expandSkills: "Expand skills";

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

@@ -3,6 +3,7 @@
 export declare const embedMiscEn: {
     readonly embed: {
         readonly yourSkills: "Your skills";
+        readonly yourPrompts: "Your prompts";
         readonly skillsMenuLabel: "Skills";
         readonly minimizeSkills: "Minimize skills";
         readonly expandSkills: "Expand skills";
@@ -48,6 +49,7 @@ export declare const embedMiscEn: {
 export declare const embedMiscEs: {
     embed: {
         yourSkills: string;
+        yourPrompts: string;
         skillsMenuLabel: string;
         minimizeSkills: string;
         expandSkills: string;
@@ -93,6 +95,7 @@ export declare const embedMiscEs: {
 export declare const embedMiscPt: {
     embed: {
         yourSkills: string;
+        yourPrompts: string;
         skillsMenuLabel: string;
         minimizeSkills: string;
         expandSkills: string;

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

@@ -5,6 +5,7 @@ export declare const headerEn: {
         readonly navChat: "Chat";
         readonly navFiles: "Files";
         readonly navScheduled: "Scheduled";
+        readonly navPrompts: "Prompts";
         readonly chatPlanRunning: "Chat — plan running, {{completed}} of {{total}} steps done";
         readonly devMode: "Dev mode";
         readonly devModeTitle: "Dev mode (belong:dev)";
@@ -29,6 +30,7 @@ export declare const headerEs: {
         navChat: string;
         navFiles: string;
         navScheduled: string;
+        navPrompts: string;
         chatPlanRunning: string;
         devMode: string;
         devModeTitle: string;
@@ -53,6 +55,7 @@ export declare const headerPt: {
         navChat: string;
         navFiles: string;
         navScheduled: string;
+        navPrompts: string;
         chatPlanRunning: string;
         devMode: string;
         devModeTitle: string;

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

@@ -0,0 +1,164 @@
+/**
+ * Saved-prompt strings: the composer's Save-as-prompt affordance and its
+ * dialog (BEL-256), plus the Prompts rail surface that lists, renames, edits
+ * and deletes them (BEL-259).
+ *
+ * Copy names the PRODUCT, never the plumbing (§42): "prompt", never
+ * "pre-prompt", "the slash menu" or "the composer". A Simetrik user does not
+ * have our vocabulary, and our vocabulary tells them only that something they
+ * cannot name went wrong.
+ *
+ * "Prompts" stays "Prompts" in es and pt. The loanword is what
+ * `embed.yourPrompts` already ships in both, and a surface calling itself
+ * "Plantillas" while the `/` menu said "prompts" would read as two features.
+ *
+ * TEACHING `{{slot}}` (BEL-258). `dialogDescription` and `editDescription` are
+ * the ONLY places the product says that double braces mean anything — without
+ * that sentence every saved prompt carries zero blanks and the feature is
+ * unreachable. Both dialogs already render these two strings, so the copy
+ * lands at the moment a body is being written with no component change.
+ *
+ * Two things the copy has to get right:
+ *
+ *  • The EXAMPLE is a real slot. `prompt-slots.ts` matches
+ *    `{{`+1–64 of `[\p{L}\p{N}_-]`+`}}` — so `{{ two words }}` is prose, not a
+ *    blank. Spelling the syntax out as a literal "{{double braces}}" would
+ *    teach a form that silently never selects, so the sentence names the
+ *    braces in prose and shows a one-word slot the user can copy. Unicode
+ *    letters count, hence a translated `{{cuenta}}` / `{{conta}}`.
+ *  • The braces survive i18next. `{{account}}` looks exactly like the `{{q}}`
+ *    interpolation in `noResults` below, but with `skipOnVariables` (i18next's
+ *    default, and untouched by `i18n.ts`) a placeholder with no matching
+ *    option is left verbatim rather than blanked. Pinned in `i18n.test.ts` for
+ *    all three locales so an interpolation-config change cannot quietly eat
+ *    the one character the sentence exists to show.
+ */
+export declare const promptsEn: {
+    readonly prompts: {
+        readonly saveAsPrompt: "Save as prompt";
+        readonly dialogTitle: "Save this as a prompt";
+        readonly dialogDescription: string;
+        readonly nameLabel: "Name";
+        readonly namePlaceholder: "monthly-recon";
+        readonly descriptionLabel: "Description (optional)";
+        readonly descriptionPlaceholder: "What this prompt does";
+        readonly bodyLabel: "What gets saved";
+        readonly save: "Save prompt";
+        readonly cancel: "Cancel";
+        readonly saving: "Saving…";
+        readonly errorNameEmpty: "Give your prompt a name.";
+        readonly errorNameInvalid: "Use lowercase letters, numbers and dashes — like monthly-recon.";
+        readonly errorNameBuiltin: "That name is already a built-in command. Pick another.";
+        readonly errorNameSkill: "A skill already uses that name. Pick another.";
+        readonly errorNameCommand: "A command already uses that name. Pick another.";
+        readonly errorNamePrompt: "You already have a prompt with that name.";
+        readonly errorSaveFailed: "Couldn't save your prompt — try again.";
+        readonly viewTitle: "Prompts";
+        readonly subtitle: "The prompts you saved. Type / in the message box to run one.";
+        readonly searchPlaceholder: "Search your prompts";
+        readonly loading: "Loading your prompts…";
+        readonly loadError: "Couldn't load your prompts.";
+        readonly empty: "No saved prompts yet.";
+        readonly emptyHint: "Write a message, then choose Save as prompt to keep it here.";
+        readonly noResults: "No prompts match “{{q}}”.";
+        readonly new: "New prompt";
+        readonly bodyPlaceholder: "The message that runs when you use it";
+        readonly actionsMenu: "Prompt actions";
+        readonly edit: "Edit";
+        readonly delete: "Delete";
+        readonly editTitle: "Edit prompt";
+        readonly editDescription: string;
+        readonly saveChanges: "Save changes";
+        readonly deleteConfirmTitle: "Delete this prompt?";
+        readonly deleteConfirmBody: "It disappears from the / menu. Your past messages are untouched.";
+        readonly deleteConfirm: "Delete prompt";
+        readonly errorEditFailed: "Couldn't save your changes — try again.";
+        readonly errorGone: "That prompt is no longer there.";
+    };
+};
+export declare const promptsEs: {
+    prompts: {
+        saveAsPrompt: string;
+        dialogTitle: string;
+        dialogDescription: string;
+        nameLabel: string;
+        namePlaceholder: string;
+        descriptionLabel: string;
+        descriptionPlaceholder: string;
+        bodyLabel: string;
+        save: string;
+        cancel: string;
+        saving: string;
+        errorNameEmpty: string;
+        errorNameInvalid: string;
+        errorNameBuiltin: string;
+        errorNameSkill: string;
+        errorNameCommand: string;
+        errorNamePrompt: string;
+        errorSaveFailed: string;
+        viewTitle: string;
+        subtitle: string;
+        searchPlaceholder: string;
+        loading: string;
+        loadError: string;
+        empty: string;
+        emptyHint: string;
+        noResults: string;
+        new: string;
+        bodyPlaceholder: string;
+        actionsMenu: string;
+        edit: string;
+        delete: string;
+        editTitle: string;
+        editDescription: string;
+        saveChanges: string;
+        deleteConfirmTitle: string;
+        deleteConfirmBody: string;
+        deleteConfirm: string;
+        errorEditFailed: string;
+        errorGone: string;
+    };
+};
+export declare const promptsPt: {
+    prompts: {
+        saveAsPrompt: string;
+        dialogTitle: string;
+        dialogDescription: string;
+        nameLabel: string;
+        namePlaceholder: string;
+        descriptionLabel: string;
+        descriptionPlaceholder: string;
+        bodyLabel: string;
+        save: string;
+        cancel: string;
+        saving: string;
+        errorNameEmpty: string;
+        errorNameInvalid: string;
+        errorNameBuiltin: string;
+        errorNameSkill: string;
+        errorNameCommand: string;
+        errorNamePrompt: string;
+        errorSaveFailed: string;
+        viewTitle: string;
+        subtitle: string;
+        searchPlaceholder: string;
+        loading: string;
+        loadError: string;
+        empty: string;
+        emptyHint: string;
+        noResults: string;
+        new: string;
+        bodyPlaceholder: string;
+        actionsMenu: string;
+        edit: string;
+        delete: string;
+        editTitle: string;
+        editDescription: string;
+        saveChanges: string;
+        deleteConfirmTitle: string;
+        deleteConfirmBody: string;
+        deleteConfirm: string;
+        errorEditFailed: string;
+        errorGone: string;
+    };
+};

package/dist/routes/prompts.d.ts

@@ -0,0 +1,2 @@
+/** /prompts — the saved-prompts list view (rail tab). */
+export declare const PromptsRoute: () => import("react").JSX.Element;

package/dist/stream/queued-message-outbox.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+declare const queuedMessageOutboxEntrySchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    text: z.ZodString;
+    clientMessageId: z.ZodString;
+    submittedAt: z.ZodNumber;
+    mode: z.ZodEnum<{
+        plan: "plan";
+        approve: "approve";
+        balanced: "balanced";
+        bypass: "bypass";
+    }>;
+    skill: z.ZodOptional<z.ZodString>;
+    fileIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    runtime: z.ZodOptional<z.ZodString>;
+    llmProvider: z.ZodOptional<z.ZodString>;
+    llmModel: z.ZodOptional<z.ZodString>;
+    workspaceExternalId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type QueuedMessageOutboxEntry = Readonly<z.infer<typeof queuedMessageOutboxEntrySchema>>;
+export declare const readQueuedMessageOutbox: (sessionId: string) => readonly QueuedMessageOutboxEntry[];
+export declare const rememberQueuedMessage: (entry: QueuedMessageOutboxEntry) => void;
+export declare const forgetQueuedMessage: (sessionId: string, clientMessageId: string) => void;
+export declare const forgetQueuedMessages: (sessionId: string, clientMessageIds: ReadonlySet<string>) => void;
+export {};

package/package.json

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