@agent-native/core 0.80.2 → 0.80.5

package/corpus/templates/clips/app/i18n/pt-BR.ts

@@ -867,6 +867,10 @@ Todas as mudanças visíveis para usuários do Clips são documentadas aqui. Voc
     replyingTo: "Respondendo a",
     commentAt: "Comentário em",
     writeReply: "Escreva uma resposta...",
+    commentButton: "Comentar",
+    composerPlaceholder: "Adicionar um comentário…",
+    mentionSomeone: "Mencionar alguém",
+    addEmoji: "Adicionar emoji",
   },
   shareMeeting: {
     pageTitle: "Notas da reunião · Clips",

package/corpus/templates/clips/app/i18n/zh-CN.ts

@@ -817,6 +817,10 @@ Clips 中所有面向用户的重要更改都会记录在这里。你可以随
     replyingTo: "正在回复",
     commentAt: "评论于",
     writeReply: "写回复...",
+    commentButton: "评论",
+    composerPlaceholder: "添加评论…",
+    mentionSomeone: "提及某人",
+    addEmoji: "添加表情",
   },
   shareMeeting: {
     pageTitle: "会议笔记 · Clips",

package/corpus/templates/clips/app/i18n/zh-TW.ts

@@ -810,6 +810,10 @@ const messages = {
     replyingTo: "正在回覆",
     commentAt: "評論於",
     writeReply: "寫回覆...",
+    commentButton: "留言",
+    composerPlaceholder: "新增留言…",
+    mentionSomeone: "提及某人",
+    addEmoji: "新增表情符號",
   },
   shareMeeting: {
     pageTitle: "會議筆記 · Clips",

package/corpus/templates/clips/app/routes/r.$recordingId.tsx

@@ -44,6 +44,10 @@ import { InsightsPanel } from "@/components/player/insights-panel";
 import { ReactionsTray } from "@/components/player/reactions-tray";
 import { SettingsPanel } from "@/components/player/settings-panel";
 import { ShareRecordingPopover } from "@/components/player/share-dialog";
+import {
+  TimestampedCommentButton,
+  TimestampedCommentBar,
+} from "@/components/player/timestamped-comment-button";
 import { TranscriptPanel } from "@/components/player/transcript-panel";
 import {
   VideoPlayer,
@@ -210,7 +214,25 @@ export default function RecordingPage() {
   const [theaterMode, setTheaterMode] = useState(false);
   const [editing, setEditing] = useState(false);
   const [currentMs, setCurrentMs] = useState(0);
+  const [commentOpen, setCommentOpen] = useState(false);
+  const [commentAtMs, setCommentAtMs] = useState(0);
   const isCompactLayout = useIsCompactRecordingLayout();
+  // Resolve the playback position for reactions/comments. Native <video> exposes
+  // a live `currentTime`; Loom embeds render in a cross-origin iframe with no
+  // live time bridge, so we fall back to the last position the player reported
+  // via onTimeUpdate (seek/initial start).
+  const resolvePlaybackMs = useCallback(() => {
+    const liveCt = playerRef.current?.video?.currentTime;
+    if (
+      typeof liveCt === "number" &&
+      Number.isFinite(liveCt) &&
+      liveCt >= 0 &&
+      liveCt < 1e7
+    ) {
+      return Math.floor(liveCt * 1000);
+    }
+    return currentMs;
+  }, [currentMs]);
   const transcriptKickedRef = useRef<string | null>(null);
   // When the recording lands in the processing state but never flips to
   // 'ready', stop spinning forever and surface an error banner so the user
@@ -1082,7 +1104,7 @@ export default function RecordingPage() {
             <EditorLayout recordingId={recording.id} className="flex-1" />
           ) : (
             <>
-              <div className="flex-1 min-h-0">
+              <div className="flex-1 min-h-0 relative">
                 <VideoPlayer
                   ref={playerRef}
                   recordingId={recording.id}
@@ -1107,6 +1129,18 @@ export default function RecordingPage() {
                   onTimeUpdate={(ms) => setCurrentMs(ms)}
                   className="h-full"
                 />
+                {commentOpen ? (
+                  <TimestampedCommentBar
+                    recordingId={recording.id}
+                    atMs={commentAtMs}
+                    onClose={() => setCommentOpen(false)}
+                    onAdded={() => {
+                      setPanel("comments");
+                      if (isCompactLayout) setSidePanelOpen(true);
+                      void playerDataQ.refetch();
+                    }}
+                  />
+                ) : null}
               </div>
 
               {/* Title + reactions row */}
@@ -1129,15 +1163,12 @@ export default function RecordingPage() {
                       </span>
                     </NavLink>
                   ) : null}
-                  <EditableRecordingTitle
-                    recordingId={recording.id}
-                    title={recording.title}
-                    canEdit={canEdit}
-                    displayTitle={visibleTitle}
-                    showPendingSkeleton={showTitleSkeleton}
-                    className="text-base font-semibold"
-                    inputClassName="h-8 text-base font-semibold"
-                    skeletonClassName="h-5 w-72 max-w-full"
+                  <TimestampedCommentButton
+                    enableComments={recording.enableComments}
+                    onOpen={() => {
+                      setCommentAtMs(resolvePlaybackMs());
+                      setCommentOpen(true);
+                    }}
                   />
                   {recording.description ? (
                     <p className="text-sm text-muted-foreground line-clamp-2">
@@ -1150,14 +1181,7 @@ export default function RecordingPage() {
                     disabled={!recording.enableReactions}
                     onReact={(emoji) => {
                       tracking.reportReaction(emoji);
-                      const liveCt = playerRef.current?.video?.currentTime;
-                      const liveMs =
-                        typeof liveCt === "number" &&
-                        Number.isFinite(liveCt) &&
-                        liveCt >= 0 &&
-                        liveCt < 1e7
-                          ? Math.floor(liveCt * 1000)
-                          : currentMs;
+                      const liveMs = resolvePlaybackMs();
                       fetch(
                         agentNativePath(
                           "/_agent-native/actions/react-to-recording",

package/corpus/templates/content/AGENTS.md

@@ -195,6 +195,18 @@ Content has two file workflows:
   `select` fields; selecting the component in the editor shows a corner edit
   button that rewrites the MDX props. JSX expression props are preserved in
   source but shown as an unsupported preview.
+- **Reusable MDX references:** local-file MDX can embed another local document
+  with `<ContentReference sourcePath="./shared/example.mdx" />`. The editor
+  resolves `sourcePath` relative to the current file, previews the referenced
+  MDX read-only in place, and preserves the original tag in source. Use this for
+  reusable docs fragments instead of copy/pasting shared content.
+- **Builder Symbols:** Builder MDX pulls preserve Symbol blocks as
+  `<BuilderSymbol ... />`. When Builder returns enriched symbol content, the
+  pull also writes a referenced `.builder.mdx` file under
+  `content/builder/symbols/` and sets the Symbol block's `source` attribute.
+  Edit reusable symbol content in that emitted source file; do not retarget
+  `entry`, `model`, or `source` in the parent MDX unless a dedicated Builder
+  retargeting workflow is added.
 - **Picked folders and components:** browser-picked folders can be the
   source of truth for `.md`/`.mdx` files, but the browser does not expose an
   absolute path that Vite can compile. Component previews from a picked

package/corpus/templates/content/app/blocks/BuilderDocsBlocks.tsx

@@ -26,6 +26,8 @@ import {
 } from "@tabler/icons-react";
 import { useState } from "react";
 
+import { ContentReferencePreview } from "@/components/editor/ContentReferencePreview";
+
 function SidecarBadge({ rawRef }: { rawRef: string }) {
   return (
     <div className="mt-2 truncate text-[11px] text-muted-foreground">
@@ -180,7 +182,15 @@ export function BuilderSymbolRead({
       </div>
       <div className="mt-1 text-xs text-muted-foreground">
         {data.model || "model unknown"} / {data.entry || "entry unknown"}
+        {data.dynamic ? " / dynamic" : ""}
       </div>
+      {data.source ? (
+        <ContentReferencePreview
+          sourcePath={data.source}
+          title="Symbol source"
+          className="mb-0"
+        />
+      ) : null}
       <SidecarBadge rawRef={data.rawRef} />
     </section>
   );

package/corpus/templates/content/app/components/editor/BubbleToolbar.tsx

@@ -47,6 +47,7 @@ const BUBBLE_TOOLBAR_EXCLUDED_NODE_TYPES = new Set([
   "image",
   "video",
   "audio",
+  "contentReference",
   "localMdxComponent",
 ]);
 

package/corpus/templates/content/app/components/editor/ContentReferencePreview.tsx

@@ -0,0 +1,185 @@
+import { useT } from "@agent-native/core/client";
+import { IconExternalLink, IconFileText } from "@tabler/icons-react";
+import { lazy, Suspense, useMemo } from "react";
+import { useNavigate } from "react-router";
+
+import { Button } from "@/components/ui/button";
+import { useDocument, useDocuments } from "@/hooks/use-documents";
+import { cn } from "@/lib/utils";
+
+const ReadonlyReferenceEditor = lazy(async () => {
+  const module = await import("./VisualEditor");
+  return { default: module.VisualEditor };
+});
+
+const MAX_CONTENT_REFERENCE_PREVIEW_DEPTH = 1;
+
+function trimSlashes(path: string) {
+  return path.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/+$/, "");
+}
+
+function dirname(path: string) {
+  const normalized = trimSlashes(path);
+  const index = normalized.lastIndexOf("/");
+  return index >= 0 ? normalized.slice(0, index) : "";
+}
+
+function normalizePathParts(path: string) {
+  const parts: string[] = [];
+  for (const part of path.split("/")) {
+    if (!part || part === ".") continue;
+    if (part === "..") {
+      if (parts.length === 0) return null;
+      parts.pop();
+      continue;
+    }
+    parts.push(part);
+  }
+  return parts.join("/");
+}
+
+export function resolveContentReferencePath(
+  sourcePath: string | null | undefined,
+  currentPath?: string | null,
+) {
+  if (typeof sourcePath !== "string" || !sourcePath.trim()) return null;
+  const normalized = sourcePath.replace(/\\/g, "/").trim();
+  if (/^[a-z][a-z0-9+.-]*:/i.test(normalized)) return null;
+  const base =
+    normalized.startsWith("./") || normalized.startsWith("../")
+      ? dirname(currentPath ?? "")
+      : "";
+  return normalizePathParts(base ? `${base}/${normalized}` : normalized);
+}
+
+export function ContentReferencePreview({
+  sourcePath,
+  currentPath,
+  title,
+  className,
+  referenceDepth = 0,
+}: {
+  sourcePath?: string | null;
+  currentPath?: string | null;
+  title?: string | null;
+  className?: string;
+  referenceDepth?: number;
+}) {
+  const t = useT();
+  const navigate = useNavigate();
+  const documentsQuery = useDocuments();
+  const resolvedPath = useMemo(
+    () => resolveContentReferencePath(sourcePath, currentPath),
+    [currentPath, sourcePath],
+  );
+  const document = useMemo(() => {
+    if (!resolvedPath) return null;
+    return (documentsQuery.data ?? []).find(
+      (candidate) =>
+        candidate.source?.mode === "local-files" &&
+        trimSlashes(candidate.source.path ?? "") === resolvedPath,
+    );
+  }, [documentsQuery.data, resolvedPath]);
+  const documentQuery = useDocument(document?.id ?? null);
+  const body = documentQuery.data?.content ?? "";
+  const displayTitle =
+    title?.trim() ||
+    documentQuery.data?.title ||
+    document?.title ||
+    t("editor.reference.defaultTitle");
+  const isSelfReference =
+    !!resolvedPath &&
+    !!currentPath &&
+    resolvedPath === trimSlashes(currentPath);
+  const isNestedTooDeep = referenceDepth >= MAX_CONTENT_REFERENCE_PREVIEW_DEPTH;
+
+  return (
+    <section
+      className={cn(
+        "content-reference-preview my-4 rounded-md border border-dashed bg-muted/20 text-sm",
+        className,
+      )}
+      data-content-reference={resolvedPath ?? sourcePath ?? ""}
+    >
+      <div className="flex min-h-10 items-center gap-2 border-b px-3 py-2">
+        <IconFileText className="size-4 shrink-0 text-muted-foreground" />
+        <div className="min-w-0 flex-1">
+          <div className="truncate font-medium text-foreground">
+            {displayTitle}
+          </div>
+          <div className="truncate text-xs text-muted-foreground">
+            {resolvedPath ?? sourcePath ?? t("editor.reference.pathMissing")}
+          </div>
+        </div>
+        {document ? (
+          <Button
+            type="button"
+            size="sm"
+            variant="ghost"
+            className="h-8 gap-1.5 px-2 text-xs"
+            onClick={() =>
+              navigate(`/page/${document.id}`, { flushSync: true })
+            }
+          >
+            <IconExternalLink className="size-3.5" />
+            {t("editor.reference.open")}
+          </Button>
+        ) : null}
+      </div>
+      <div className="max-h-[520px] overflow-auto px-3 py-3">
+        {!resolvedPath ? (
+          <div className="text-sm text-muted-foreground">
+            {t("editor.reference.missingPath")}
+          </div>
+        ) : isSelfReference ? (
+          <div className="text-sm text-muted-foreground">
+            {t("editor.reference.selfReference")}
+          </div>
+        ) : documentsQuery.isLoading ? (
+          <div className="text-sm text-muted-foreground">
+            {t("editor.reference.loading")}
+          </div>
+        ) : !document ? (
+          <div className="text-sm text-muted-foreground">
+            {t("editor.reference.notFound")}
+          </div>
+        ) : documentQuery.isLoading ? (
+          <div className="text-sm text-muted-foreground">
+            {t("editor.reference.loading")}
+          </div>
+        ) : documentQuery.isError ? (
+          <div className="text-sm text-muted-foreground">
+            {t("editor.reference.loadError")}
+          </div>
+        ) : isNestedTooDeep ? (
+          <div className="text-sm text-muted-foreground">
+            {t("editor.reference.nestedSkipped")}
+          </div>
+        ) : body.trim() ? (
+          <Suspense
+            fallback={
+              <div className="text-sm text-muted-foreground">
+                {t("editor.reference.loading")}
+              </div>
+            }
+          >
+            <ReadonlyReferenceEditor
+              key={document.id}
+              documentId={document.id}
+              content={body}
+              onChange={() => {}}
+              editable={false}
+              localFileMode
+              localFilePath={resolvedPath}
+              referenceDepth={referenceDepth + 1}
+            />
+          </Suspense>
+        ) : (
+          <div className="text-sm text-muted-foreground">
+            {t("editor.reference.empty")}
+          </div>
+        )}
+      </div>
+    </section>
+  );
+}

package/corpus/templates/content/app/components/editor/DocumentEditor.tsx

@@ -1162,6 +1162,9 @@ function DocumentEditorBody({ documentId, document }: DocumentEditorBodyProps) {
                         user={currentUser}
                         editable={canEdit}
                         localFileMode={isLocalFileDocument}
+                        localFilePath={
+                          isLocalFileDocument ? document.source?.path : null
+                        }
                         onComment={
                           canEdit && !isLocalFileDocument
                             ? handleComment

package/corpus/templates/content/app/components/editor/VisualEditor.tsx

@@ -52,6 +52,7 @@ import {
   commentHighlightKey,
   type CommentHighlightSpec,
 } from "./extensions/CommentHighlight";
+import { ContentReferenceNode } from "./extensions/ContentReferenceNode";
 import { DragHandle } from "./extensions/DragHandle";
 import { ImageNode } from "./extensions/ImageNode";
 import {
@@ -745,6 +746,10 @@ interface VisualEditorProps {
   editable?: boolean;
   /** Local-file docs should not persist mount-time/schema normalization echoes. */
   localFileMode?: boolean;
+  /** Workspace-relative local artifact path for resolving inline references. */
+  localFilePath?: string | null;
+  /** Current nested local-file reference preview depth. */
+  referenceDepth?: number;
   /** Called when user selects text and clicks "Comment" in bubble toolbar. */
   onComment?: (
     quotedText: string,
@@ -891,6 +896,8 @@ interface VisualEditorExtensionOptions {
   onJoinTitle?: (text: string) => void;
   resolveNotionPageLink?: (notionPageId: string) => NotionPageLink | null;
   onOpenNotionPageLink?: (documentId: string) => void;
+  localFilePath?: string | null;
+  referenceDepth?: number;
 }
 
 function hasAncestorType(
@@ -1214,6 +1221,8 @@ export function createVisualEditorExtensions({
   onJoinTitle,
   resolveNotionPageLink,
   onOpenNotionPageLink,
+  localFilePath,
+  referenceDepth = 0,
 }: VisualEditorExtensionOptions = {}): Extensions {
   // Build on the SHARED editor core (StarterKit base + the Collaboration /
   // CollaborationCaret wiring + collab undo/redo gating + ordering), then inject
@@ -1298,6 +1307,10 @@ export function createVisualEditorExtensions({
       // `VisualEditor` below. Mounted after the Notion nodes and before the
       // Markdown extension so the NFM <-> doc round-trip recognizes the node.
       RegistryBlockNode,
+      ContentReferenceNode.configure({
+        currentPath: localFilePath ?? null,
+        referenceDepth,
+      }),
       LocalMdxComponentNode,
       CommentHighlight,
       DragHandle,
@@ -1568,6 +1581,8 @@ export function VisualEditor({
   user,
   editable = true,
   localFileMode = false,
+  localFilePath,
+  referenceDepth,
   onComment,
   commentThreads,
   activeThreadId,
@@ -1636,6 +1651,8 @@ export function VisualEditor({
         onJoinTitle,
         resolveNotionPageLink,
         onOpenNotionPageLink,
+        localFilePath,
+        referenceDepth,
       }),
     [
       documentId,
@@ -1648,6 +1665,8 @@ export function VisualEditor({
       onJoinTitle,
       resolveNotionPageLink,
       onOpenNotionPageLink,
+      localFilePath,
+      referenceDepth,
     ],
   );
 

package/corpus/templates/content/app/components/editor/extensions/ContentReferenceNode.tsx

@@ -0,0 +1,82 @@
+import {
+  Node as TiptapNode,
+  NodeViewWrapper,
+  ReactNodeViewRenderer,
+  mergeAttributes,
+  type NodeViewProps,
+} from "@tiptap/react";
+
+import { ContentReferencePreview } from "../ContentReferencePreview";
+
+function ContentReferenceView({ node, extension }: NodeViewProps) {
+  const sourcePath =
+    typeof node.attrs.sourcePath === "string" ? node.attrs.sourcePath : null;
+  const title = typeof node.attrs.title === "string" ? node.attrs.title : null;
+  const currentPath =
+    typeof extension.options.currentPath === "string"
+      ? extension.options.currentPath
+      : null;
+  const referenceDepth =
+    typeof extension.options.referenceDepth === "number"
+      ? extension.options.referenceDepth
+      : 0;
+
+  return (
+    <NodeViewWrapper
+      className="my-4"
+      contentEditable={false}
+      data-content-reference={sourcePath ?? ""}
+    >
+      <ContentReferencePreview
+        sourcePath={sourcePath}
+        currentPath={currentPath}
+        title={title}
+        referenceDepth={referenceDepth}
+      />
+    </NodeViewWrapper>
+  );
+}
+
+export const ContentReferenceNode = TiptapNode.create<{
+  currentPath?: string | null;
+  referenceDepth?: number;
+}>({
+  name: "contentReference",
+  group: "block",
+  atom: true,
+  selectable: true,
+  draggable: true,
+
+  addOptions() {
+    return {
+      currentPath: null,
+      referenceDepth: 0,
+    };
+  },
+
+  addAttributes() {
+    return {
+      sourcePath: { default: "" },
+      title: { default: null },
+      __raw: { default: "" },
+      indent: { default: 0 },
+    };
+  },
+
+  parseHTML() {
+    return [{ tag: "div[data-content-reference]" }];
+  },
+
+  renderHTML({ HTMLAttributes }) {
+    return [
+      "div",
+      mergeAttributes(HTMLAttributes, {
+        "data-content-reference": HTMLAttributes.sourcePath,
+      }),
+    ];
+  },
+
+  addNodeView() {
+    return ReactNodeViewRenderer(ContentReferenceView);
+  },
+});

package/corpus/templates/content/app/global.css

@@ -305,6 +305,15 @@
   min-height: 6rem;
 }
 
+.content-reference-preview .visual-editor-wrapper,
+.content-reference-preview .visual-editor-wrapper .notion-editor {
+  min-height: 0;
+}
+
+.content-reference-preview .notion-editor {
+  font-size: 0.875rem;
+}
+
 .notion-editor > *:first-child {
   margin-top: 0;
 }

package/corpus/templates/content/app/i18n/zh-TW.ts

@@ -142,6 +142,18 @@ const messages = {
       "還原會替所有人取代目前內容，且無法復原。不過目前狀態會先儲存為一個版本。",
     versionRestored: "版本已還原。",
     versionSavedAutomatically: "編輯時會自動儲存版本。",
+    reference: {
+      defaultTitle: "引用",
+      empty: "引用的文件是空的。",
+      loadError: "無法載入引用的文件。",
+      loading: "正在載入引用...",
+      missingPath: "引用路徑缺失或不受支援。",
+      nestedSkipped: "已略過巢狀引用預覽。",
+      notFound: "找不到引用的文件。",
+      open: "開啟",
+      pathMissing: "引用路徑缺失",
+      selfReference: "此引用指向目前文件。",
+    },
     media: {
       addAltTextDescription: "新增替代文字來描述該圖片。",
       addAudio: "新增音訊",