@belonguniverseai/react-sdk 0.6.30 → 0.6.32

package/dist/component/{yaml-OWfodT0f.js → yaml-Dz4nnVrC.js}

@@ -1,8 +1,8 @@
 globalThis.process = globalThis.process || { env: {} }, globalThis.global = globalThis.global || globalThis;
-import { r as e } from "./rolldown-runtime-Vo6tslS3.js";
+import { r as e } from "./rolldown-runtime-DlZaaczM.js";
 //#region ../../node_modules/.pnpm/@shikijs+langs@4.2.0/node_modules/@shikijs/langs/dist/yaml.mjs
 var t = /* @__PURE__ */ e({ default: () => n }), n = [Object.freeze(JSON.parse("{\"displayName\":\"YAML\",\"fileTypes\":[\"yaml\",\"yml\",\"rviz\",\"reek\",\"clang-format\",\"yaml-tmlanguage\",\"syntax\",\"sublime-syntax\"],\"firstLineMatch\":\"^%YAML( ?1.\\\\d+)?\",\"name\":\"yaml\",\"patterns\":[{\"include\":\"#comment\"},{\"include\":\"#property\"},{\"include\":\"#directive\"},{\"match\":\"^---\",\"name\":\"entity.other.document.begin.yaml\"},{\"match\":\"^\\\\.{3}\",\"name\":\"entity.other.document.end.yaml\"},{\"include\":\"#node\"}],\"repository\":{\"block-collection\":{\"patterns\":[{\"include\":\"#block-sequence\"},{\"include\":\"#block-mapping\"}]},\"block-mapping\":{\"patterns\":[{\"include\":\"#block-pair\"}]},\"block-node\":{\"patterns\":[{\"include\":\"#prototype\"},{\"include\":\"#block-scalar\"},{\"include\":\"#block-collection\"},{\"include\":\"#flow-scalar-plain-out\"},{\"include\":\"#flow-node\"}]},\"block-pair\":{\"patterns\":[{\"begin\":\"\\\\?\",\"beginCaptures\":{\"1\":{\"name\":\"punctuation.definition.key-value.begin.yaml\"}},\"end\":\"(?=\\\\?)|^ *(:)|(:)\",\"endCaptures\":{\"1\":{\"name\":\"punctuation.separator.key-value.mapping.yaml\"},\"2\":{\"name\":\"invalid.illegal.expected-newline.yaml\"}},\"name\":\"meta.block-mapping.yaml\",\"patterns\":[{\"include\":\"#block-node\"}]},{\"begin\":\"(?=(?:[^-\\\\]!\\\"#%\\\\&'*,:>?@\\\\[`{|}\\\\s]|[-:?]\\\\S)([^:\\\\s]|:\\\\S|\\\\s+(?![#\\\\s]))*\\\\s*:(\\\\s|$))\",\"end\":\"(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$))\",\"patterns\":[{\"include\":\"#flow-scalar-plain-out-implicit-type\"},{\"begin\":\"[^-\\\\]!\\\"#%\\\\&'*,:>?@\\\\[`{|}\\\\s]|[-:?]\\\\S\",\"beginCaptures\":{\"0\":{\"name\":\"entity.name.tag.yaml\"}},\"contentName\":\"entity.name.tag.yaml\",\"end\":\"(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$))\",\"name\":\"string.unquoted.plain.out.yaml\"}]},{\"match\":\":(?=\\\\s|$)\",\"name\":\"punctuation.separator.key-value.mapping.yaml\"}]},\"block-scalar\":{\"begin\":\"(?:(\\\\|)|(>))([1-9])?([-+])?(.*\\\\n?)\",\"beginCaptures\":{\"1\":{\"name\":\"keyword.control.flow.block-scalar.literal.yaml\"},\"2\":{\"name\":\"keyword.control.flow.block-scalar.folded.yaml\"},\"3\":{\"name\":\"constant.numeric.indentation-indicator.yaml\"},\"4\":{\"name\":\"storage.modifier.chomping-indicator.yaml\"},\"5\":{\"patterns\":[{\"include\":\"#comment\"},{\"match\":\".+\",\"name\":\"invalid.illegal.expected-comment-or-newline.yaml\"}]}},\"end\":\"^(?=\\\\S)|(?!\\\\G)\",\"patterns\":[{\"begin\":\"^( +)(?! )\",\"end\":\"^(?!\\\\1|\\\\s*$)\",\"name\":\"string.unquoted.block.yaml\"}]},\"block-sequence\":{\"match\":\"(-)(?!\\\\S)\",\"name\":\"punctuation.definition.block.sequence.item.yaml\"},\"comment\":{\"begin\":\"(?:^([\\\\t ]*)|[\\\\t ]+)(?=#\\\\p{print}*$)\",\"beginCaptures\":{\"1\":{\"name\":\"punctuation.whitespace.comment.leading.yaml\"}},\"end\":\"(?!\\\\G)\",\"patterns\":[{\"begin\":\"#\",\"beginCaptures\":{\"0\":{\"name\":\"punctuation.definition.comment.yaml\"}},\"end\":\"\\\\n\",\"name\":\"comment.line.number-sign.yaml\"}]},\"directive\":{\"begin\":\"^%\",\"beginCaptures\":{\"0\":{\"name\":\"punctuation.definition.directive.begin.yaml\"}},\"end\":\"(?=$|[\\\\t ]+($|#))\",\"name\":\"meta.directive.yaml\",\"patterns\":[{\"captures\":{\"1\":{\"name\":\"keyword.other.directive.yaml.yaml\"},\"2\":{\"name\":\"constant.numeric.yaml-version.yaml\"}},\"match\":\"\\\\G(YAML)[\\\\t ]+(\\\\d+\\\\.\\\\d+)\"},{\"captures\":{\"1\":{\"name\":\"keyword.other.directive.tag.yaml\"},\"2\":{\"name\":\"storage.type.tag-handle.yaml\"},\"3\":{\"name\":\"support.type.tag-prefix.yaml\"}},\"match\":\"\\\\G(TAG)(?:[\\\\t ]+(!(?:[-0-9A-Za-z]*!)?)(?:[\\\\t ]+(!(?:%\\\\h{2}|[]!#$\\\\&-;=?-\\\\[_a-z~])*|(?![]!,\\\\[{}])(?:%\\\\h{2}|[]!#$\\\\&-;=?-\\\\[_a-z~])+))?)?\"},{\"captures\":{\"1\":{\"name\":\"support.other.directive.reserved.yaml\"},\"2\":{\"name\":\"string.unquoted.directive-name.yaml\"},\"3\":{\"name\":\"string.unquoted.directive-parameter.yaml\"}},\"match\":\"\\\\G(\\\\w+)(?:[\\\\t ]+(\\\\w+)(?:[\\\\t ]+(\\\\w+))?)?\"},{\"match\":\"\\\\S+\",\"name\":\"invalid.illegal.unrecognized.yaml\"}]},\"flow-alias\":{\"captures\":{\"1\":{\"name\":\"keyword.control.flow.alias.yaml\"},\"2\":{\"name\":\"punctuation.definition.alias.yaml\"},\"3\":{\"name\":\"variable.other.alias.yaml\"},\"4\":{\"name\":\"invalid.illegal.character.anchor.yaml\"}},\"match\":\"((\\\\*))([^],/\\\\[{}\\\\s]+)([^],}\\\\s]\\\\S*)?\"},\"flow-collection\":{\"patterns\":[{\"include\":\"#flow-sequence\"},{\"include\":\"#flow-mapping\"}]},\"flow-mapping\":{\"begin\":\"\\\\{\",\"beginCaptures\":{\"0\":{\"name\":\"punctuation.definition.mapping.begin.yaml\"}},\"end\":\"}\",\"endCaptures\":{\"0\":{\"name\":\"punctuation.definition.mapping.end.yaml\"}},\"name\":\"meta.flow-mapping.yaml\",\"patterns\":[{\"include\":\"#prototype\"},{\"match\":\",\",\"name\":\"punctuation.separator.mapping.yaml\"},{\"include\":\"#flow-pair\"}]},\"flow-node\":{\"patterns\":[{\"include\":\"#prototype\"},{\"include\":\"#flow-alias\"},{\"include\":\"#flow-collection\"},{\"include\":\"#flow-scalar\"}]},\"flow-pair\":{\"patterns\":[{\"begin\":\"\\\\?\",\"beginCaptures\":{\"0\":{\"name\":\"punctuation.definition.key-value.begin.yaml\"}},\"end\":\"(?=[],}])\",\"name\":\"meta.flow-pair.explicit.yaml\",\"patterns\":[{\"include\":\"#prototype\"},{\"include\":\"#flow-pair\"},{\"include\":\"#flow-node\"},{\"begin\":\":(?=\\\\s|$|[],\\\\[{}])\",\"beginCaptures\":{\"0\":{\"name\":\"punctuation.separator.key-value.mapping.yaml\"}},\"end\":\"(?=[],}])\",\"patterns\":[{\"include\":\"#flow-value\"}]}]},{\"begin\":\"(?=(?:[^-\\\\]!\\\"#%\\\\&'*,:>?@\\\\[`{|}\\\\s]|[-:?][^],\\\\[{}\\\\s])([^],:\\\\[{}\\\\s]|:[^],\\\\[{}\\\\s]|\\\\s+(?![#\\\\s]))*\\\\s*:(\\\\s|$))\",\"end\":\"(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$)|\\\\s*:[],\\\\[{}]|\\\\s*[],\\\\[{}])\",\"name\":\"meta.flow-pair.key.yaml\",\"patterns\":[{\"include\":\"#flow-scalar-plain-in-implicit-type\"},{\"begin\":\"[^-\\\\]!\\\"#%\\\\&'*,:>?@\\\\[`{|}\\\\s]|[-:?][^],\\\\[{}\\\\s]\",\"beginCaptures\":{\"0\":{\"name\":\"entity.name.tag.yaml\"}},\"contentName\":\"entity.name.tag.yaml\",\"end\":\"(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$)|\\\\s*:[],\\\\[{}]|\\\\s*[],\\\\[{}])\",\"name\":\"string.unquoted.plain.in.yaml\"}]},{\"include\":\"#flow-node\"},{\"begin\":\":(?=\\\\s|$|[],\\\\[{}])\",\"captures\":{\"0\":{\"name\":\"punctuation.separator.key-value.mapping.yaml\"}},\"end\":\"(?=[],}])\",\"name\":\"meta.flow-pair.yaml\",\"patterns\":[{\"include\":\"#flow-value\"}]}]},\"flow-scalar\":{\"patterns\":[{\"include\":\"#flow-scalar-double-quoted\"},{\"include\":\"#flow-scalar-single-quoted\"},{\"include\":\"#flow-scalar-plain-in\"}]},\"flow-scalar-double-quoted\":{\"begin\":\"\\\"\",\"beginCaptures\":{\"0\":{\"name\":\"punctuation.definition.string.begin.yaml\"}},\"end\":\"\\\"\",\"endCaptures\":{\"0\":{\"name\":\"punctuation.definition.string.end.yaml\"}},\"name\":\"string.quoted.double.yaml\",\"patterns\":[{\"match\":\"\\\\\\\\([ \\\"/0LN\\\\\\\\_abefnprtv]|x\\\\d\\\\d|u\\\\d{4}|U\\\\d{8})\",\"name\":\"constant.character.escape.yaml\"},{\"match\":\"\\\\\\\\\\\\n\",\"name\":\"constant.character.escape.double-quoted.newline.yaml\"}]},\"flow-scalar-plain-in\":{\"patterns\":[{\"include\":\"#flow-scalar-plain-in-implicit-type\"},{\"begin\":\"[^-\\\\]!\\\"#%\\\\&'*,:>?@\\\\[`{|}\\\\s]|[-:?][^],\\\\[{}\\\\s]\",\"end\":\"(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$)|\\\\s*:[],\\\\[{}]|\\\\s*[],\\\\[{}])\",\"name\":\"string.unquoted.plain.in.yaml\"}]},\"flow-scalar-plain-in-implicit-type\":{\"patterns\":[{\"captures\":{\"1\":{\"name\":\"constant.language.null.yaml\"},\"2\":{\"name\":\"constant.language.boolean.yaml\"},\"3\":{\"name\":\"constant.numeric.integer.yaml\"},\"4\":{\"name\":\"constant.numeric.float.yaml\"},\"5\":{\"name\":\"constant.other.timestamp.yaml\"},\"6\":{\"name\":\"constant.language.value.yaml\"},\"7\":{\"name\":\"constant.language.merge.yaml\"}},\"match\":\"(?:(null|Null|NULL|~)|([Yy]|yes|Yes|YES|[Nn]|no|No|NO|true|True|TRUE|false|False|FALSE|on|On|ON|off|Off|OFF)|([-+]?0b[01_]+|[-+]?0[0-7_]+|[-+]?(?:0|[1-9][0-9_]*)|[-+]?0x[_\\\\h]+|[-+]?[1-9][0-9_]*(?::[0-5]?[0-9])+)|([-+]?(?:[0-9][0-9_]*)?\\\\.[.0-9]*(?:[Ee][-+][0-9]+)?|[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+\\\\.[0-9_]*|[-+]?\\\\.(?:inf|Inf|INF)|\\\\.(?:nan|NaN|NAN))|(\\\\d{4}-\\\\d{2}-\\\\d{2}|\\\\d{4}-\\\\d{1,2}-\\\\d{1,2}(?:[Tt]|[\\\\t ]+)\\\\d{1,2}:\\\\d{2}:\\\\d{2}(?:\\\\.\\\\d*)?(?:[\\\\t ]*Z|[-+]\\\\d{1,2}(?::\\\\d{1,2})?)?)|(=)|(<<))(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$)|\\\\s*:[],\\\\[{}]|\\\\s*[],\\\\[{}])\"}]},\"flow-scalar-plain-out\":{\"patterns\":[{\"include\":\"#flow-scalar-plain-out-implicit-type\"},{\"begin\":\"[^-\\\\]!\\\"#%\\\\&'*,:>?@\\\\[`{|}\\\\s]|[-:?]\\\\S\",\"end\":\"(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$))\",\"name\":\"string.unquoted.plain.out.yaml\"}]},\"flow-scalar-plain-out-implicit-type\":{\"patterns\":[{\"captures\":{\"1\":{\"name\":\"constant.language.null.yaml\"},\"2\":{\"name\":\"constant.language.boolean.yaml\"},\"3\":{\"name\":\"constant.numeric.integer.yaml\"},\"4\":{\"name\":\"constant.numeric.float.yaml\"},\"5\":{\"name\":\"constant.other.timestamp.yaml\"},\"6\":{\"name\":\"constant.language.value.yaml\"},\"7\":{\"name\":\"constant.language.merge.yaml\"}},\"match\":\"(?:(null|Null|NULL|~)|([Yy]|yes|Yes|YES|[Nn]|no|No|NO|true|True|TRUE|false|False|FALSE|on|On|ON|off|Off|OFF)|([-+]?0b[01_]+|[-+]?0[0-7_]+|[-+]?(?:0|[1-9][0-9_]*)|[-+]?0x[_\\\\h]+|[-+]?[1-9][0-9_]*(?::[0-5]?[0-9])+)|([-+]?(?:[0-9][0-9_]*)?\\\\.[.0-9]*(?:[Ee][-+][0-9]+)?|[-+]?[0-9][0-9_]*(?::[0-5]?[0-9])+\\\\.[0-9_]*|[-+]?\\\\.(?:inf|Inf|INF)|\\\\.(?:nan|NaN|NAN))|(\\\\d{4}-\\\\d{2}-\\\\d{2}|\\\\d{4}-\\\\d{1,2}-\\\\d{1,2}(?:[Tt]|[\\\\t ]+)\\\\d{1,2}:\\\\d{2}:\\\\d{2}(?:\\\\.\\\\d*)?(?:[\\\\t ]*Z|[-+]\\\\d{1,2}(?::\\\\d{1,2})?)?)|(=)|(<<))(?=\\\\s*$|\\\\s+#|\\\\s*:(\\\\s|$))\"}]},\"flow-scalar-single-quoted\":{\"begin\":\"'\",\"beginCaptures\":{\"0\":{\"name\":\"punctuation.definition.string.begin.yaml\"}},\"end\":\"'(?!')\",\"endCaptures\":{\"0\":{\"name\":\"punctuation.definition.string.end.yaml\"}},\"name\":\"string.quoted.single.yaml\",\"patterns\":[{\"match\":\"''\",\"name\":\"constant.character.escape.single-quoted.yaml\"}]},\"flow-sequence\":{\"begin\":\"\\\\[\",\"beginCaptures\":{\"0\":{\"name\":\"punctuation.definition.sequence.begin.yaml\"}},\"end\":\"]\",\"endCaptures\":{\"0\":{\"name\":\"punctuation.definition.sequence.end.yaml\"}},\"name\":\"meta.flow-sequence.yaml\",\"patterns\":[{\"include\":\"#prototype\"},{\"match\":\",\",\"name\":\"punctuation.separator.sequence.yaml\"},{\"include\":\"#flow-pair\"},{\"include\":\"#flow-node\"}]},\"flow-value\":{\"patterns\":[{\"begin\":\"\\\\G(?![],}])\",\"end\":\"(?=[],}])\",\"name\":\"meta.flow-pair.value.yaml\",\"patterns\":[{\"include\":\"#flow-node\"}]}]},\"node\":{\"patterns\":[{\"include\":\"#block-node\"}]},\"property\":{\"begin\":\"(?=[!\\\\&])\",\"end\":\"(?!\\\\G)\",\"name\":\"meta.property.yaml\",\"patterns\":[{\"captures\":{\"1\":{\"name\":\"keyword.control.property.anchor.yaml\"},\"2\":{\"name\":\"punctuation.definition.anchor.yaml\"},\"3\":{\"name\":\"entity.name.type.anchor.yaml\"},\"4\":{\"name\":\"invalid.illegal.character.anchor.yaml\"}},\"match\":\"\\\\G((&))([^],/\\\\[{}\\\\s]+)(\\\\S+)?\"},{\"match\":\"\\\\G!(?:<(?:%\\\\h{2}|[]!#$\\\\&-;=?-\\\\[_a-z~])+>|(?:[-0-9A-Za-z]*!)?(?:%\\\\h{2}|[#$\\\\&-+\\\\--;=?-Z_a-z~])+|)(?=[\\\\t ]|$)\",\"name\":\"storage.type.tag-handle.yaml\"},{\"match\":\"\\\\S+\",\"name\":\"invalid.illegal.tag-handle.yaml\"}]},\"prototype\":{\"patterns\":[{\"include\":\"#comment\"},{\"include\":\"#property\"}]}},\"scopeName\":\"source.yaml\",\"aliases\":[\"yml\"]}"))];
 //#endregion
 export { t as n, n as t };
 
-//# sourceMappingURL=yaml-OWfodT0f.js.map
+//# sourceMappingURL=yaml-Dz4nnVrC.js.map

package/dist/components/ai-elements/dock-link.d.ts

@@ -15,7 +15,20 @@ export declare const DockLink: {
     ({ href, className, children }: DockLinkProps): import("react").JSX.Element;
     displayName: string;
 };
-type StreamdownComponents = NonNullable<ComponentProps<typeof Streamdown>["components"]>;
+/**
+ * The confirm-then-new-tab link every untrusted markdown link falls back to:
+ * Streamdown's button shape, the dock-styled confirm modal, then
+ * `window.open(url, "_blank", "noreferrer")`. Never navigates in place.
+ */
+export declare const ConfirmedLink: {
+    ({ href, className, children, }: {
+        readonly href: string;
+        readonly className?: string | undefined;
+        readonly children?: ReactNode;
+    }): import("react").JSX.Element;
+    displayName: string;
+};
+export type StreamdownComponents = NonNullable<ComponentProps<typeof Streamdown>["components"]>;
 /**
  * Module-level so the object identity is stable: Streamdown memoises its merged
  * component map on the `components` prop, and a fresh object every render would

package/dist/components/ai-elements/message.d.ts

@@ -42,8 +42,15 @@ export declare const MessageBranchPage: ({ className, ...props }: MessageBranchP
  * has already pre-resolved `./other.md` into `/other.md` — indistinguishable
  * from an app path. There is no href shape that separates the two, so the
  * SURFACE does, and a file's links keep the confirm-then-new-tab guard.
+ *
+ * `guide` is a Simetrik agent Guide article served by belong-cloud. Its
+ * `[text](guide:<article-id>)` links open that article inside the Guide tab
+ * ({@link GuideLink}); one to an article this deployment does not serve is
+ * plain text, and any other link keeps the confirm-then-new-tab guard. The
+ * sanitizer drops the `guide:` scheme, so this surface rewrites those targets
+ * to a fragment first ({@link withGuideLinkTargets}).
  */
-type MarkdownLinkSurface = "agent-reply" | "workspace-file";
+type MarkdownLinkSurface = "agent-reply" | "workspace-file" | "guide";
 /**
  * `components` is deliberately OMITTED from what a caller may pass. It is the
  * seam {@link DockLink} is installed through, so leaving it public would let a

package/dist/components/guide/GuideArticleView.d.ts

@@ -0,0 +1,7 @@
+import { GuideArticle } from '@belong/codec/guide';
+type GuideArticleViewProps = {
+    readonly article: GuideArticle;
+    readonly onBack: () => void;
+};
+export declare const GuideArticleView: ({ article, onBack }: GuideArticleViewProps) => import("react").JSX.Element;
+export {};

package/dist/components/guide/GuideHub.d.ts

@@ -0,0 +1,9 @@
+import { GuideResponse } from '@belong/codec/guide';
+type GuideHubProps = {
+    readonly guide: GuideResponse;
+    readonly query: string;
+    readonly onQueryChange: (query: string) => void;
+    readonly onOpen: (articleId: string) => void;
+};
+export declare const GuideHub: ({ guide, query, onQueryChange, onOpen }: GuideHubProps) => import("react").JSX.Element;
+export {};

package/dist/components/guide/GuideSettings.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Settings → Guide: the Simetrik agent Guide, a small help center about the
+ * agent in the dock's own language (spec decisions 1, 2, 11–14).
+ *
+ * The guide is fetched when this section opens (`useGuide`), already filtered
+ * by what the deployment has switched on. The view is the hub or one article.
+ * Its state lives here, above the fetch states, so a language switch refetches
+ * and comes back to whichever was open; an article that is no longer served
+ * falls back to the hub. Every hub ↔ article change calls `onNavigate`, so the
+ * settings panel can reset its scroll.
+ *
+ * Focus: an opened article focuses its title (`GuideArticleView`), and Back
+ * puts focus on the hub item that opened it — or on the search box when the
+ * reader got there through a `guide:` link.
+ *
+ * Quiet by design (§42): loading is one muted line, and a failed fetch is a
+ * calm "Couldn't load the guide" with a Retry that refetches. An older cloud
+ * without the route (404) says the guide isn't available here yet, with no
+ * Retry, since retrying could never help. Nothing here is red.
+ */
+export declare const GuideSettings: ({ onNavigate }: {
+    readonly onNavigate?: () => void;
+}) => import("react").JSX.Element;

package/dist/components/guide/figures/ComposerIndicatorsFigure.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The `composer-indicators` figure: a static drawing of the dock's message box
+ * with numbered callouts, placed by the `on-screen` article.
+ *
+ *   1 — the percentage ring just above the box, outside it (`UsageMeter`),
+ *       drawn at 25%;
+ *   2 — the execution-mode button inside the box, in its default mode;
+ *   3 — the activity line in the conversation ("Working on it…").
+ *
+ * The article's numbered list follows the same order. Every label the real
+ * dock shows comes from the dock's OWN catalog entry — the mode name, the
+ * activity line, the Simetrik composer placeholder — so the drawing relabels
+ * with the dock and cannot drift from the screen. Theme tokens only, no red
+ * (§42). Presentational: one `role="img"` with a spoken description.
+ */
+export declare const ComposerIndicatorsFigure: () => import("react").JSX.Element;

package/dist/components/guide/figures/SharedTaskCopiesFigure.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The `shared-task-copies` figure: why a shared scheduled task can run twice.
+ * The original task and the copy a second account enabled are each ACTIVE, and
+ * each active copy is its own schedule, so one time of day adds up to two runs.
+ * Placed by the `task-ran-twice` and `scheduled-tasks` articles.
+ *
+ * The status chip, the cadence line and the "Share" step read the Scheduled
+ * view's OWN catalog entries, and the time is formatted the way that view
+ * formats it, so the drawing cannot drift from the screen. Theme tokens only,
+ * no red (§42). Presentational: one `role="img"` with a spoken description.
+ */
+export declare const SharedTaskCopiesFigure: () => import("react").JSX.Element;

package/dist/components/guide/figures/index.d.ts

@@ -0,0 +1,3 @@
+import { ComponentType } from 'react';
+import { GuideFigureId } from '@belong/codec/guide';
+export declare const GUIDE_FIGURES: Readonly<Record<GuideFigureId, ComponentType>>;

package/dist/components/guide/guide-fixtures.d.ts

@@ -0,0 +1,3 @@
+import { GuideResponse } from '@belong/codec/guide';
+export declare const GUIDE_FIXTURE_EN: GuideResponse;
+export declare const GUIDE_FIXTURE_ES: GuideResponse;

package/dist/components/guide/guide-icons.d.ts

@@ -0,0 +1,3 @@
+import { LucideIcon } from 'lucide-react';
+import { GuideIconKey } from '@belong/codec/guide';
+export declare const GUIDE_ICONS: Readonly<Record<GuideIconKey, LucideIcon>>;

package/dist/components/guide/guide-link.d.ts

@@ -0,0 +1,12 @@
+import { StreamdownComponents } from '../ai-elements/dock-link.tsx';
+/** What a guide link can open: the served article ids, and how to open one. */
+export type GuideNavigation = {
+    readonly knownIds: ReadonlySet<string>;
+    readonly open: (articleId: string) => void;
+};
+/** Provided by the article view; `null` everywhere else (links read as text). */
+export declare const GuideNavigationContext: import('react').Context<GuideNavigation | null>;
+/** Rewrites each `](guide:<id>)` target to the sanitizer-safe `](#guide:<id>)`. */
+export declare const withGuideLinkTargets: (markdown: string) => string;
+/** Module-level, so the identity is stable across renders (Streamdown memoises on it). */
+export declare const guideMarkdownComponents: StreamdownComponents;

package/dist/components/guide/guide-search.d.ts

@@ -0,0 +1,15 @@
+import { GuideArticle } from '@belong/codec/guide';
+/** NFD, accents dropped, lowercased, whitespace collapsed and trimmed. */
+export declare const normalizeForSearch: (text: string) => string;
+/**
+ * What a reader sees of an article body: marker comments, heading hashes,
+ * emphasis and code ticks, and link targets removed (the link text is kept).
+ * Linear in the body's length, whatever the body holds.
+ */
+export declare const guidePlainText: (markdown: string) => string;
+/**
+ * Articles whose title or plain-text body contains the query. Title matches
+ * come first, then body-only matches; each group keeps the input order. A query
+ * that is empty once normalized (only spaces) is no query, and finds nothing.
+ */
+export declare const searchGuide: (articles: readonly GuideArticle[], query: string) => readonly GuideArticle[];

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

@@ -2,7 +2,7 @@ import { VariantProps } from 'class-variance-authority';
 import * as React from "react";
 declare const buttonVariants: (props?: ({
     variant?: "default" | "link" | "destructive" | "secondary" | "outline" | "ghost" | null | undefined;
-    size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
+    size?: "default" | "icon" | "xs" | "sm" | "lg" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 type ButtonProps = React.ComponentProps<"button"> & VariantProps<typeof buttonVariants> & {
     asChild?: boolean;

package/dist/components/ui/input-group.d.ts

@@ -7,7 +7,7 @@ declare const inputGroupAddonVariants: (props?: ({
 declare function InputGroupAddon({ className, align, ...props }: React.ComponentProps<"div"> & VariantProps<typeof inputGroupAddonVariants>): React.JSX.Element;
 declare const InputGroupButton: React.ForwardRefExoticComponent<Omit<Omit<Omit<React.ClassAttributes<HTMLButtonElement> & React.ButtonHTMLAttributes<HTMLButtonElement> & VariantProps<(props?: ({
     variant?: "default" | "link" | "destructive" | "secondary" | "outline" | "ghost" | null | undefined;
-    size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
+    size?: "default" | "icon" | "xs" | "sm" | "lg" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
 } & import('class-variance-authority/types').ClassProp) | undefined) => string> & {
     asChild?: boolean;
 }, "ref"> & React.RefAttributes<HTMLButtonElement>, "size"> & VariantProps<(props?: ({

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

@@ -377,6 +377,8 @@ export declare const en: {
         aboutDescription: string;
         apiKeys: string;
         apiKeysDescription: string;
+        guide: string;
+        guideDescription: string;
         apiKeysName: string;
         apiKeysCreate: string;
         apiKeysRevoke: string;
@@ -502,6 +504,7 @@ export declare const en: {
         readonly sharedReadOnly: "You no longer have edit access. Your unsaved changes are still here.";
         readonly templateUnavailable: "The linked HTML template could not be read. Ask the owner to restore it, then resume this task.";
         readonly cliReconnectRequired: "Simetrik couldn't be reached during this run. It reconnects on its own the next time you open Simetrik.";
+        readonly deliveryFailed: "The task ran but couldn't send its result: every message or email it tried to send failed. Check that its Slack, Teams or email connection is still connected.";
         readonly cliUnavailable: "Simetrik didn't respond during this run, so nothing could be checked and no email was sent.";
         readonly emailNotPrepared: "This run ended before it finished its check, so no email was sent. Open the run to see what stopped it.";
         readonly viewTitle: "Scheduled";
@@ -534,6 +537,7 @@ export declare const en: {
         readonly customEmailDescription: "Each run reads the latest version of this template and sends an email only when its condition matches.";
         readonly customEmailTemplate: "HTML template";
         readonly emailNotificationLabel: "Completion email enabled";
+        readonly emailNotificationOffLabel: "Completion email off";
         readonly emailRecipients: "Recipients";
         readonly sharedRecipients: "Shared recipients";
         readonly sharedRecipientsHelp: "Sent only from the owner’s original task. Shared delivery pauses when that task is paused.";
@@ -545,6 +549,11 @@ export declare const en: {
         readonly emailBcc: "BCC";
         readonly emailReplyTo: "Reply-To";
         readonly emailCopiesHelp: "Everyone sees the CC addresses, BCC stays hidden, and replies go to Reply-To. Separate addresses with commas.";
+        readonly notifyOnLabel: "Email me";
+        readonly notifyOnAllRuns: "After every run";
+        readonly notifyOnFailuresOnly: "Only when a run fails";
+        readonly notifyOnOff: "Never";
+        readonly notifyOnHelp: "The email that says a run finished or failed. A custom email report is always sent.";
         readonly sharedEmailCopies: "Shared CC, BCC and Reply-To";
         readonly sharedEmailCopiesHelp: "Added only to the owner’s original task email, like shared recipients. Each person can also add their own.";
         readonly emailAccountRecipient: "Schedule owner's account email";
@@ -891,6 +900,34 @@ export declare const en: {
         readonly ageDays: "{{count}}d ago";
         readonly attachmentFallback: "attachment";
     };
+    readonly guide: {
+        readonly summaryTitle: "In 30 seconds";
+        readonly searchPlaceholder: "Search the guide";
+        readonly searchLabel: "Search the guide";
+        readonly commonQuestions: "Common questions";
+        readonly topics: "Topics";
+        readonly backToGuide: "Guide";
+        readonly backLabel: "Back to the guide";
+        readonly resultsCount_one: "{{count}} result";
+        readonly resultsCount_other: "{{count}} results";
+        readonly noResults: "Nothing in the guide matches “{{query}}”.";
+        readonly loading: "Loading the guide…";
+        readonly loadFailed: "Couldn't load the guide.";
+        readonly unavailable: "The guide isn't available here yet.";
+        readonly retry: "Try again";
+        readonly figures: {
+            readonly composer: {
+                readonly alt: "The message box with three numbered parts: 1, the percentage above the box; 2, the mode button; 3, the activity line in the conversation.";
+            };
+            readonly sharedTask: {
+                readonly alt: "The same scheduled task active in two accounts: the original and a shared copy. Each active copy runs on its own, so the task runs twice at the same time.";
+                readonly original: "Original task · first account";
+                readonly copy: "Shared copy · second account";
+                readonly total_one: "{{count}} run at {{time}}";
+                readonly total_other: "{{count}} runs at {{time}}";
+            };
+        };
+    };
     readonly feedback: {
         readonly goodResponse: "Good response";
         readonly badResponse: "Bad response";

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

@@ -0,0 +1,131 @@
+/**
+ * Settings → Guide chrome (the Simetrik agent Guide): the hub's headings, the
+ * search box, the article back button, the loading and failure lines, and the
+ * labels the two figures draw that the dock has no catalog entry for yet.
+ *
+ * The articles themselves are served by belong-cloud; only chrome lives here.
+ * A figure label that the real dock already shows (the mode name, the activity
+ * line, the composer placeholder, a schedule's status and cadence) is NOT
+ * repeated here: the figures read the dock's own entry, so they cannot drift.
+ * Quiet by design (§42): the failure line is calm and offers a retry.
+ */
+export declare const guideEn: {
+    readonly guide: {
+        readonly summaryTitle: "In 30 seconds";
+        readonly searchPlaceholder: "Search the guide";
+        readonly searchLabel: "Search the guide";
+        readonly commonQuestions: "Common questions";
+        readonly topics: "Topics";
+        readonly backToGuide: "Guide";
+        readonly backLabel: "Back to the guide";
+        readonly resultsCount_one: "{{count}} result";
+        readonly resultsCount_other: "{{count}} results";
+        readonly noResults: "Nothing in the guide matches “{{query}}”.";
+        readonly loading: "Loading the guide…";
+        readonly loadFailed: "Couldn't load the guide.";
+        readonly unavailable: "The guide isn't available here yet.";
+        readonly retry: "Try again";
+        readonly figures: {
+            readonly composer: {
+                readonly alt: "The message box with three numbered parts: 1, the percentage above the box; 2, the mode button; 3, the activity line in the conversation.";
+            };
+            readonly sharedTask: {
+                readonly alt: "The same scheduled task active in two accounts: the original and a shared copy. Each active copy runs on its own, so the task runs twice at the same time.";
+                readonly original: "Original task · first account";
+                readonly copy: "Shared copy · second account";
+                readonly total_one: "{{count}} run at {{time}}";
+                readonly total_other: "{{count}} runs at {{time}}";
+            };
+        };
+    };
+};
+export declare const guideEs: {
+    guide: {
+        summaryTitle: string;
+        searchPlaceholder: string;
+        searchLabel: string;
+        commonQuestions: string;
+        topics: string;
+        backToGuide: string;
+        backLabel: string;
+        resultsCount_one: string;
+        resultsCount_other: string;
+        noResults: string;
+        loading: string;
+        loadFailed: string;
+        unavailable: string;
+        retry: string;
+        figures: {
+            composer: {
+                alt: string;
+            };
+            sharedTask: {
+                alt: string;
+                original: string;
+                copy: string;
+                total_one: string;
+                total_other: string;
+            };
+        };
+    };
+};
+export declare const guidePt: {
+    guide: {
+        summaryTitle: string;
+        searchPlaceholder: string;
+        searchLabel: string;
+        commonQuestions: string;
+        topics: string;
+        backToGuide: string;
+        backLabel: string;
+        resultsCount_one: string;
+        resultsCount_other: string;
+        noResults: string;
+        loading: string;
+        loadFailed: string;
+        unavailable: string;
+        retry: string;
+        figures: {
+            composer: {
+                alt: string;
+            };
+            sharedTask: {
+                alt: string;
+                original: string;
+                copy: string;
+                total_one: string;
+                total_other: string;
+            };
+        };
+    };
+};
+export declare const guideIt: {
+    guide: {
+        summaryTitle: string;
+        searchPlaceholder: string;
+        searchLabel: string;
+        commonQuestions: string;
+        topics: string;
+        backToGuide: string;
+        backLabel: string;
+        resultsCount_one: string;
+        resultsCount_other: string;
+        noResults: string;
+        loading: string;
+        loadFailed: string;
+        unavailable: string;
+        retry: string;
+        figures: {
+            composer: {
+                alt: string;
+            };
+            sharedTask: {
+                alt: string;
+                original: string;
+                copy: string;
+                total_one: string;
+                total_other: string;
+            };
+        };
+    };
+};

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

@@ -58,6 +58,7 @@ export declare const scheduledEn: {
         readonly sharedReadOnly: "You no longer have edit access. Your unsaved changes are still here.";
         readonly templateUnavailable: "The linked HTML template could not be read. Ask the owner to restore it, then resume this task.";
         readonly cliReconnectRequired: "Simetrik couldn't be reached during this run. It reconnects on its own the next time you open Simetrik.";
+        readonly deliveryFailed: "The task ran but couldn't send its result: every message or email it tried to send failed. Check that its Slack, Teams or email connection is still connected.";
         readonly cliUnavailable: "Simetrik didn't respond during this run, so nothing could be checked and no email was sent.";
         readonly emailNotPrepared: "This run ended before it finished its check, so no email was sent. Open the run to see what stopped it.";
         readonly viewTitle: "Scheduled";
@@ -90,6 +91,7 @@ export declare const scheduledEn: {
         readonly customEmailDescription: "Each run reads the latest version of this template and sends an email only when its condition matches.";
         readonly customEmailTemplate: "HTML template";
         readonly emailNotificationLabel: "Completion email enabled";
+        readonly emailNotificationOffLabel: "Completion email off";
         readonly emailRecipients: "Recipients";
         readonly sharedRecipients: "Shared recipients";
         readonly sharedRecipientsHelp: "Sent only from the owner’s original task. Shared delivery pauses when that task is paused.";
@@ -101,6 +103,11 @@ export declare const scheduledEn: {
         readonly emailBcc: "BCC";
         readonly emailReplyTo: "Reply-To";
         readonly emailCopiesHelp: "Everyone sees the CC addresses, BCC stays hidden, and replies go to Reply-To. Separate addresses with commas.";
+        readonly notifyOnLabel: "Email me";
+        readonly notifyOnAllRuns: "After every run";
+        readonly notifyOnFailuresOnly: "Only when a run fails";
+        readonly notifyOnOff: "Never";
+        readonly notifyOnHelp: "The email that says a run finished or failed. A custom email report is always sent.";
         readonly sharedEmailCopies: "Shared CC, BCC and Reply-To";
         readonly sharedEmailCopiesHelp: "Added only to the owner’s original task email, like shared recipients. Each person can also add their own.";
         readonly emailAccountRecipient: "Schedule owner's account email";
@@ -328,6 +335,7 @@ export declare const scheduledEs: {
         sharedReadOnly: string;
         templateUnavailable: string;
         cliReconnectRequired: string;
+        deliveryFailed: string;
         cliUnavailable: string;
         emailNotPrepared: string;
         viewTitle: string;
@@ -360,6 +368,7 @@ export declare const scheduledEs: {
         customEmailDescription: string;
         customEmailTemplate: string;
         emailNotificationLabel: string;
+        emailNotificationOffLabel: string;
         emailRecipients: string;
         sharedRecipients: string;
         sharedRecipientsHelp: string;
@@ -371,6 +380,11 @@ export declare const scheduledEs: {
         emailBcc: string;
         emailReplyTo: string;
         emailCopiesHelp: string;
+        notifyOnLabel: string;
+        notifyOnAllRuns: string;
+        notifyOnFailuresOnly: string;
+        notifyOnOff: string;
+        notifyOnHelp: string;
         sharedEmailCopies: string;
         sharedEmailCopiesHelp: string;
         emailAccountRecipient: string;
@@ -598,6 +612,7 @@ export declare const scheduledPt: {
         sharedReadOnly: string;
         templateUnavailable: string;
         cliReconnectRequired: string;
+        deliveryFailed: string;
         cliUnavailable: string;
         emailNotPrepared: string;
         viewTitle: string;
@@ -630,6 +645,7 @@ export declare const scheduledPt: {
         customEmailDescription: string;
         customEmailTemplate: string;
         emailNotificationLabel: string;
+        emailNotificationOffLabel: string;
         emailRecipients: string;
         sharedRecipients: string;
         sharedRecipientsHelp: string;
@@ -641,6 +657,11 @@ export declare const scheduledPt: {
         emailBcc: string;
         emailReplyTo: string;
         emailCopiesHelp: string;
+        notifyOnLabel: string;
+        notifyOnAllRuns: string;
+        notifyOnFailuresOnly: string;
+        notifyOnOff: string;
+        notifyOnHelp: string;
         sharedEmailCopies: string;
         sharedEmailCopiesHelp: string;
         emailAccountRecipient: string;
@@ -868,6 +889,7 @@ export declare const scheduledIt: {
         sharedReadOnly: string;
         templateUnavailable: string;
         cliReconnectRequired: string;
+        deliveryFailed: string;
         cliUnavailable: string;
         emailNotPrepared: string;
         viewTitle: string;
@@ -900,6 +922,7 @@ export declare const scheduledIt: {
         customEmailDescription: string;
         customEmailTemplate: string;
         emailNotificationLabel: string;
+        emailNotificationOffLabel: string;
         emailRecipients: string;
         sharedRecipients: string;
         sharedRecipientsHelp: string;
@@ -911,6 +934,11 @@ export declare const scheduledIt: {
         emailBcc: string;
         emailReplyTo: string;
         emailCopiesHelp: string;
+        notifyOnLabel: string;
+        notifyOnAllRuns: string;
+        notifyOnFailuresOnly: string;
+        notifyOnOff: string;
+        notifyOnHelp: string;
         sharedEmailCopies: string;
         sharedEmailCopiesHelp: string;
         emailAccountRecipient: string;

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

@@ -20,6 +20,8 @@ export declare const settingsEn: {
         aboutDescription: string;
         apiKeys: string;
         apiKeysDescription: string;
+        guide: string;
+        guideDescription: string;
         apiKeysName: string;
         apiKeysCreate: string;
         apiKeysRevoke: string;
@@ -84,6 +86,8 @@ export declare const settingsEs: {
         aboutDescription: string;
         apiKeys: string;
         apiKeysDescription: string;
+        guide: string;
+        guideDescription: string;
         apiKeysName: string;
         apiKeysCreate: string;
         apiKeysRevoke: string;
@@ -148,6 +152,8 @@ export declare const settingsPt: {
         aboutDescription: string;
         apiKeys: string;
         apiKeysDescription: string;
+        guide: string;
+        guideDescription: string;
         apiKeysName: string;
         apiKeysCreate: string;
         apiKeysRevoke: string;
@@ -212,6 +218,8 @@ export declare const settingsIt: {
         aboutDescription: string;
         apiKeys: string;
         apiKeysDescription: string;
+        guide: string;
+        guideDescription: string;
         apiKeysName: string;
         apiKeysCreate: string;
         apiKeysRevoke: string;

package/package.json

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

package/dist/component/classDiagram-JCYQIIEL-DIJqG5ni.js

@@ -1,34 +0,0 @@
-globalThis.process = globalThis.process || { env: {} }, globalThis.global = globalThis.global || globalThis;
-import { n as e } from "./chunk-Y2CYZVJY-CiUSrfaV.js";
-import "./src-CIUIEWUq.js";
-import "./chunk-I66GZJ75-CgKKa90D.js";
-import "./chunk-NSK5VX7P-_QtiHZI5.js";
-import "./chunk-W5SLKNZC-D4nCOcBy.js";
-import "./chunk-UBXNYLIW-DkOJxqLu.js";
-import "./chunk-4I5QYGJK-BgRtJks4.js";
-import "./chunk-WRU74C26-CBqykecI.js";
-import "./chunk-QR6OTTB3-CXFJWTXS.js";
-import "./chunk-7BUUIJ7U-DJJ8ycYS.js";
-import "./chunk-7Z6QIM7H-DzOAKtZ-.js";
-import "./chunk-J7OUQ5F2-CX7R6Ww8.js";
-import "./chunk-5VM5RSS4-BuOiQaWo.js";
-import "./chunk-2GRJ4B5K-DiLdzExH.js";
-import "./chunk-XXDRQBXY-B6oSStBe.js";
-import "./chunk-KBJHAD2P-Cv7BYPkW.js";
-import { i as t, n, r, t as i } from "./chunk-GF5L2VYU-DMADozUU.js";
-//#region ../../node_modules/.pnpm/mermaid@11.16.1/node_modules/mermaid/dist/chunks/mermaid.core/classDiagram-JCYQIIEL.mjs
-var a = {
-	parser: n,
-	get db() {
-		return new i();
-	},
-	renderer: r,
-	styles: t,
-	init: /* @__PURE__ */ e((e) => {
-		e.class ||= {}, e.class.arrowMarkerAbsolute = e.arrowMarkerAbsolute;
-	}, "init")
-};
-//#endregion
-export { a as diagram };
-
-//# sourceMappingURL=classDiagram-JCYQIIEL-DIJqG5ni.js.map