@agent-native/core 0.100.2 → 0.101.2

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

@@ -1,3 +1,58 @@
 import { messagesByLocale } from "../i18n-data";
 
-export default messagesByLocale["zh-CN"];
+const messages = {
+  ...messagesByLocale["zh-CN"],
+  review: {
+    comments: "评论",
+    commentsTab: "评论 · {{count}}",
+    commentsTitle: "审阅评论",
+    commentNumber: "审阅评论 {{count}}",
+    thisScreen: "当前画面",
+    allScreens: "所有画面",
+    signInToComment: "登录后评论",
+    panelTitle: "反馈",
+    placeholder: "留下反馈…",
+    emptyState: "暂无审阅评论。",
+    clickToPin: "点击任意位置固定反馈",
+    escToExit: "按 Esc 退出",
+    newComment: "新评论",
+    commentMode: "评论",
+    sendToAgent: "发送给智能体",
+    sendingToAgent: "正在发送给智能体…",
+    enterToPost: "按 Enter 发布 · 按 Shift+Enter 换行",
+    post: "发布",
+    posting: "正在发布…",
+    postFailed: "无法发布此评论",
+    loading: "正在加载评论",
+    replyPlaceholder: "回复此讨论…",
+    reply: "回复",
+    cancelReply: "取消回复",
+    replyFailed: "无法发布此回复",
+    resolve: "解决",
+    resolving: "正在解决…",
+    resolveFailed: "无法解决此讨论",
+    deleteComment: "删除评论",
+    moreActions: "更多操作",
+    resolved: "已解决",
+    reviewer: "审阅者",
+    applyFeedback: "应用反馈 ({{count}})",
+    applyingFeedback: "正在应用反馈…",
+    applyFeedbackFailed: "无法应用审阅反馈",
+    sendToAgentFailed: "无法将此讨论发送给智能体",
+    shareLinkDescription:
+      "任何获得此链接的人都可以查看设计。已登录的审阅者可以发表评论。",
+    presentComments: "评论",
+    presentCommentMode: "评论模式",
+    closeComments: "关闭评论",
+    status: {
+      draft: "草稿",
+      in_review: "审阅中",
+      approved: "已批准",
+      changes_requested: "已请求更改",
+      change: "更改审阅状态",
+      saveFailed: "无法更新审阅状态",
+    },
+  },
+};
+
+export default messages;

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

@@ -43,6 +43,57 @@ const messages = {
     notFoundBackToDesigns: "返回設計",
     teamCreateOrgDescription: "設定團隊，與同事共用設計。",
   },
+  review: {
+    comments: "評論",
+    commentsTab: "評論 · {{count}}",
+    commentsTitle: "審閱評論",
+    commentNumber: "審閱評論 {{count}}",
+    thisScreen: "目前畫面",
+    allScreens: "所有畫面",
+    signInToComment: "登入後評論",
+    panelTitle: "意見回饋",
+    placeholder: "留下意見…",
+    emptyState: "目前沒有審閱評論。",
+    clickToPin: "點選任意位置以固定意見",
+    escToExit: "按 Esc 退出",
+    newComment: "新增評論",
+    commentMode: "評論",
+    sendToAgent: "傳送給代理",
+    sendingToAgent: "正在傳送給代理…",
+    enterToPost: "按 Enter 發布 · 按 Shift+Enter 換行",
+    post: "發布",
+    posting: "正在發布…",
+    postFailed: "無法發布這則評論",
+    loading: "正在載入評論",
+    replyPlaceholder: "回覆此討論串…",
+    reply: "回覆",
+    cancelReply: "取消回覆",
+    replyFailed: "無法發布這則回覆",
+    resolve: "解決",
+    resolving: "正在解決…",
+    resolveFailed: "無法解決此討論串",
+    deleteComment: "刪除評論",
+    moreActions: "更多操作",
+    resolved: "已解決",
+    reviewer: "審閱者",
+    applyFeedback: "套用意見 ({{count}})",
+    applyingFeedback: "正在套用意見…",
+    applyFeedbackFailed: "無法套用審閱意見",
+    sendToAgentFailed: "無法將此討論串傳送給代理",
+    shareLinkDescription:
+      "任何取得此連結的人都能檢視設計。已登入的審閱者可以評論。",
+    presentComments: "評論",
+    presentCommentMode: "評論模式",
+    closeComments: "關閉評論",
+    status: {
+      draft: "草稿",
+      in_review: "審閱中",
+      approved: "已核准",
+      changes_requested: "已要求變更",
+      change: "變更審閱狀態",
+      saveFailed: "無法更新審閱狀態",
+    },
+  },
   chat: {
     emptyState: "描述要建立的設計",
     suggestionLandingPage: "為我的初創公司設計落地頁面",

package/corpus/templates/design/app/pages/Present.tsx

@@ -1,14 +1,36 @@
 import {
+  ReviewStatusBadge,
+  agentNativePath,
   injectSessionReplayIframeBootstrap,
   SESSION_REPLAY_IFRAME_ATTRIBUTE,
   useActionQuery,
+  useReviewComments,
+  useSession,
   useT,
 } from "@agent-native/core/client";
-import { useState, useEffect, useCallback } from "react";
+import { readDesignReviewSummary } from "@shared/review-summary";
+import { IconMessageCircle } from "@tabler/icons-react";
+import { useCallback, useEffect, useMemo, useState } from "react";
 import { Link, useParams, useNavigate } from "react-router";
 
+import { appendHitTestResponder } from "@/components/design/design-canvas/hit-test";
+import { ReviewCommentsPanel } from "@/components/design/ReviewCommentsPanel";
 import { QueryErrorState } from "@/components/QueryErrorState";
+import { Button } from "@/components/ui/button";
+import {
+  Sheet,
+  SheetContent,
+  SheetDescription,
+  SheetHeader,
+  SheetTitle,
+} from "@/components/ui/sheet";
 import { Skeleton } from "@/components/ui/skeleton";
+import { ReviewCanvasPins } from "@/components/visual-editor/ReviewCanvasPins";
+
+import {
+  resolvePresentEscapeAction,
+  shouldBlockPresentPageNavigation,
+} from "./present-review-state";
 
 interface DesignFile {
   id: string;
@@ -21,13 +43,17 @@ interface DesignData {
   id: string;
   title: string;
   files: DesignFile[];
+  accessRole?: "viewer" | "editor" | "admin" | "owner";
 }
 
 export default function Present() {
   const t = useT();
   const { id } = useParams<{ id: string }>();
   const navigate = useNavigate();
+  const { session } = useSession();
   const [currentPage, setCurrentPage] = useState(0);
+  const [commentMode, setCommentMode] = useState(false);
+  const [commentsOpen, setCommentsOpen] = useState(false);
 
   const {
     data: design,
@@ -38,14 +64,67 @@ export default function Present() {
   } = useActionQuery<DesignData>("get-design", { id: id! });
 
   const files: DesignFile[] = design?.files ?? [];
+  const activeFile = files[currentPage] ?? files[0];
+  const reviewQuery = useReviewComments(
+    {
+      resourceType: "design",
+      resourceId: id ?? "",
+      targetId: activeFile?.id ?? undefined,
+      includeResolved: false,
+      limit: 500,
+    },
+    { enabled: Boolean(id) },
+  );
+  const canPost = Boolean(session?.email);
+  const canResolve = Boolean(
+    design?.accessRole === "owner" ||
+    design?.accessRole === "admin" ||
+    design?.accessRole === "editor",
+  );
+  const reviewableContent = useMemo(
+    () =>
+      injectSessionReplayIframeBootstrap(
+        appendHitTestResponder(activeFile?.content ?? ""),
+      ),
+    [activeFile?.content],
+  );
+  const reviewCommentCount =
+    readDesignReviewSummary(reviewQuery.data)?.openCount ??
+    new Set(
+      (reviewQuery.data?.comments ?? [])
+        .filter(
+          (comment) =>
+            comment.status === "open" && comment.parentCommentId === null,
+        )
+        .map((comment) => comment.threadId),
+    ).size;
+  const signInHref = (() => {
+    const base = agentNativePath("/_agent-native/sign-in");
+    if (typeof window === "undefined") return base;
+    const returnUrl = new URL(window.location.href);
+    returnUrl.search = "";
+    returnUrl.hash = "";
+    return `${base}?return=${encodeURIComponent(returnUrl.pathname)}`;
+  })();
 
   // Keyboard navigation
   const handleKeyDown = useCallback(
     (e: KeyboardEvent) => {
       if (e.key === "Escape") {
-        navigate(`/design/${id}`);
+        const action = resolvePresentEscapeAction({
+          commentsOpen,
+          commentMode,
+        });
+        if (action === "close-comments") setCommentsOpen(false);
+        if (action === "exit-presentation") navigate(`/design/${id}`);
+        // ReviewCanvasPins owns "defer-to-comment-mode" so it can dismiss an
+        // active draft before it exits the tool.
         return;
       }
+      // Freeze slide navigation while review UI is active so typing a space
+      // or using arrow keys in the sheet cannot change the anchored screen.
+      if (shouldBlockPresentPageNavigation({ commentsOpen, commentMode }))
+        return;
       if (files.length <= 1) return;
       if (e.key === "ArrowRight" || e.key === "ArrowDown" || e.key === " ") {
         e.preventDefault();
@@ -56,7 +135,7 @@ export default function Present() {
         setCurrentPage((p) => Math.max(p - 1, 0));
       }
     },
-    [id, navigate, files.length],
+    [commentMode, commentsOpen, files.length, id, navigate],
   );
 
   useEffect(() => {
@@ -99,17 +178,96 @@ export default function Present() {
     );
   }
 
-  const activeFile = files[currentPage] ?? files[0];
-
   return (
-    <div className="h-screen w-screen bg-black overflow-hidden">
-      <iframe
-        {...{ [SESSION_REPLAY_IFRAME_ATTRIBUTE]: "" }}
-        srcDoc={injectSessionReplayIframeBootstrap(activeFile.content)}
-        sandbox="allow-scripts"
-        className="w-full h-full border-0"
-        title={`${design.title} — ${activeFile.filename}`}
-      />
+    <div className="relative h-screen w-screen overflow-hidden bg-black">
+      <div className="present-review-canvas h-full w-full">
+        <iframe
+          {...{ [SESSION_REPLAY_IFRAME_ATTRIBUTE]: "" }}
+          srcDoc={reviewableContent}
+          sandbox="allow-scripts"
+          data-design-preview-iframe
+          className="h-full w-full border-0"
+          title={`${design.title} — ${activeFile.filename}`}
+        />
+        <ReviewCanvasPins
+          active={commentMode}
+          onClose={() => setCommentMode(false)}
+          canvasSelector=".present-review-canvas"
+          resourceType="design"
+          resourceId={id}
+          targetId={activeFile.id}
+          canPost={canPost}
+          canResolve={canResolve}
+        />
+      </div>
+
+      <div className="fixed right-4 top-4 z-[70] flex items-center gap-2">
+        <ReviewStatusBadge
+          status={reviewQuery.data?.reviewStatus?.status ?? "draft"}
+        />
+        <Button
+          type="button"
+          variant="secondary"
+          size="sm"
+          className="gap-1.5 rounded-full bg-black/75 text-white shadow-lg hover:bg-black"
+          onClick={() => {
+            setCommentMode(false);
+            setCommentsOpen(true);
+          }}
+        >
+          <IconMessageCircle className="size-4" />
+          {t("review.presentComments")}
+          {reviewCommentCount > 0 ? ` · ${reviewCommentCount}` : ""}
+        </Button>
+      </div>
+
+      <Sheet open={commentsOpen} onOpenChange={setCommentsOpen}>
+        <SheetContent
+          side="right"
+          className="flex w-[min(92vw,380px)] flex-col overflow-hidden p-0"
+        >
+          <SheetHeader className="border-b border-border px-4 py-3">
+            <SheetTitle className="flex items-center gap-2 text-sm">
+              <IconMessageCircle className="size-4" />
+              {t("review.presentComments")}
+            </SheetTitle>
+            <SheetDescription className="sr-only">
+              {t("review.commentsTitle")}
+            </SheetDescription>
+          </SheetHeader>
+          <ReviewCommentsPanel
+            designId={id}
+            activeFileId={activeFile.id}
+            canComment={canPost}
+            canResolve={canResolve}
+            canDeleteComment={(comment) =>
+              canResolve ||
+              ("canDelete" in comment && comment.canDelete === true) ||
+              comment.authorEmail === session?.email
+            }
+            showComposer={false}
+            signInHref={signInHref}
+            className="min-h-0 flex-1"
+          />
+          {canPost ? (
+            <div className="shrink-0 border-t border-border p-3">
+              <Button
+                type="button"
+                variant="outline"
+                size="sm"
+                className="w-full gap-1.5"
+                onClick={() => {
+                  setCommentsOpen(false);
+                  setCommentMode(true);
+                }}
+              >
+                <IconMessageCircle className="size-3.5" />
+                {t("review.presentCommentMode")}
+              </Button>
+            </div>
+          ) : null}
+        </SheetContent>
+      </Sheet>
 
       {/* Page indicator */}
       {files.length > 1 && (
@@ -127,7 +285,7 @@ export default function Present() {
       )}
 
       {/* Exit hint */}
-      <div className="fixed top-4 right-4 text-xs text-white/20">
+      <div className="fixed left-4 top-4 text-xs text-white/20">
         {t("pages.presentExitHint")}
       </div>
     </div>

package/corpus/templates/design/app/pages/design-editor/overview-camera.ts

@@ -509,6 +509,29 @@ export function computeIframeLocalCanvasPoint(args: {
   };
 }
 
+export function resolveScreenDropPoint(args: {
+  clientX: number;
+  clientY: number;
+  screenId: string | null | undefined;
+  iframeRect:
+    | { left: number; top: number; right: number; bottom: number }
+    | null
+    | undefined;
+  zoomPercent: number;
+}): { screenId: string; x: number; y: number } | null {
+  if (!args.screenId || !args.iframeRect) return null;
+  if (
+    args.clientX < args.iframeRect.left ||
+    args.iframeRect.right < args.clientX ||
+    args.clientY < args.iframeRect.top ||
+    args.iframeRect.bottom < args.clientY
+  ) {
+    return null;
+  }
+  const point = computeIframeLocalCanvasPoint(args);
+  return point ? { screenId: args.screenId, ...point } : null;
+}
+
 /**
  * Reads MultiScreenCanvas's live imperative zoom from the exact inline
  * transform written by `applyViewToDom` while a wheel/pinch gesture is still

package/corpus/templates/design/app/pages/design-editor/tool-state.ts

@@ -92,6 +92,16 @@ export function getDesignToolActivationState(tool: DesignTool): {
   return { mode: "edit", drawMode: false, pinMode: false };
 }
 
+export function shouldAutoEnableDrawOverlay(args: {
+  mode: EditorMode;
+  activeTool: DesignTool;
+  pinMode: boolean;
+}): boolean {
+  return (
+    args.mode === "annotate" && args.activeTool === "draw" && !args.pinMode
+  );
+}
+
 export function getSingleScreenCreationTool(args: {
   activeTool: DesignTool;
   viewMode: "single" | "overview";

package/corpus/templates/design/app/pages/present-review-state.ts

@@ -0,0 +1,18 @@
+export interface PresentReviewState {
+  commentsOpen: boolean;
+  commentMode: boolean;
+}
+
+export function resolvePresentEscapeAction(
+  state: PresentReviewState,
+): "close-comments" | "defer-to-comment-mode" | "exit-presentation" {
+  if (state.commentsOpen) return "close-comments";
+  if (state.commentMode) return "defer-to-comment-mode";
+  return "exit-presentation";
+}
+
+export function shouldBlockPresentPageNavigation(
+  state: PresentReviewState,
+): boolean {
+  return state.commentsOpen || state.commentMode;
+}

package/corpus/templates/design/app/public-routes.ts

@@ -0,0 +1,8 @@
+export function isPublicDesignAppPath(pathname: string): boolean {
+  return (
+    pathname === "/visual-edit" ||
+    pathname === "/design" ||
+    pathname.startsWith("/design/") ||
+    pathname.startsWith("/present/")
+  );
+}

package/corpus/templates/design/app/root.tsx

@@ -33,10 +33,14 @@ import { AppToolkitProvider } from "@/components/ui/toolkit-provider";
 
 import changelog from "../CHANGELOG.md?raw";
 import { i18nCatalog } from "./i18n";
+import { isPublicDesignAppPath } from "./public-routes";
 
 import stylesheet from "./global.css?url";
 
 configureTracking({
+  llmConnectionStatus:
+    typeof window === "undefined" ||
+    !isPublicDesignAppPath(window.location.pathname),
   getDefaultProps: (_name, properties) => ({
     ...properties,
     app: "design",
@@ -182,16 +186,13 @@ function RootContent() {
 export default function Root() {
   const [queryClient] = useState(() => createAgentNativeQueryClient());
   const location = useLocation();
-  const sessionBypass =
-    location.pathname === "/visual-edit" ||
-    location.pathname === "/design" ||
-    location.pathname.startsWith("/design/");
+  const isPublicPath = isPublicDesignAppPath(location.pathname);
   return (
     <AppToolkitProvider>
       <AppProviders
         queryClient={queryClient}
-        sessionBypass={sessionBypass}
-        i18n={{ catalog: i18nCatalog }}
+        isPublicPath={isPublicPath}
+        i18n={{ catalog: i18nCatalog, persistPreference: !isPublicPath }}
       >
         <RootContent />
       </AppProviders>

package/corpus/templates/design/changelog/2026-07-13-dragged-design-assets-now-appear-at-the-visible-drop-locatio.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-13
+---
+
+Dragged Design assets now appear at the visible drop location inside the target screen.

package/corpus/templates/design/changelog/2026-07-13-reviewers-can-pin-comments-on-shared-designs-and-apply-verif.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-13
+---
+
+Reviewers can pin comments on shared designs and apply verified feedback through the agent

package/corpus/templates/design/server/plugins/agent-chat.ts

@@ -12,6 +12,14 @@ const DESIGN_BACKGROUND_RUN_NO_PROGRESS_TIMEOUT_MS = 12 * 60_000;
 
 const INITIAL_TOOL_NAMES = [
   "view-screen",
+  "list-review-comments",
+  "get-review-feedback",
+  "create-review-comment",
+  "reply-review-comment",
+  "send-review-thread-to-agent",
+  "resolve-review-thread",
+  "consume-review-feedback",
+  "set-review-status",
   "list-designs",
   "list-design-templates",
   "get-design",
@@ -60,6 +68,8 @@ When the user asks to start from a template, call list-design-templates and then
 
 When the user asks you to refine an existing design, call view-screen if the open design is unclear, then read the live current file with get-design-snapshot before editing. For small localized changes, call edit-design with exact search/replace edits. For broad copy-only changes such as translating all visible text, call edit-design in replace-file mode with the complete updated file content from the snapshot so the HTML structure, scripts, styles, and tweaks are preserved without dozens of fragile search blocks. Do not claim the design is updated until the mutating action succeeds.
 
+When open review feedback exists, call get-review-feedback and work one anchored thread at a time. Prefer the stable node anchor, verify each persisted edit before resolving its thread, pass resolutionNote with a one-line description of the persisted change, and call consume-review-feedback after applying agent-targeted feedback. If a reviewer selectively sends one thread to the agent, use that thread id as the scope and do not apply other open feedback. If a thread needs a human decision, reply with resolutionTarget "human" instead of resolving it; follow the design-review-feedback skill for the complete loop.
+
 When the user picks one direction from a set of presented variants, delete each unchosen variant screen at most once, then call get-design-snapshot exactly once for the kept screen's fileId and call edit-design on that same fileId. Use edit-design replace-file when expanding the placeholder into a complete but compact product UI in the chosen direction. Prioritize the primary workflow and render secondary details as visible controls, states, or affordances if the feature list is too large for one reliable edit. Do not call generate-design after a variant pick unless the user explicitly asks to create a separate new screen.
 
 When the user asks to visually inspect or edit a running local app, use open-visual-edit. It registers the localhost bridge, creates or reuses the Design project, places URL-backed iframe screens, stores the active visual-edit context, and navigates to overview mode in one authenticated step. For follow-ups like adding a mobile viewport or another route state, reuse the current designId and connectionId and call open-visual-edit or add-localhost-screens with explicit routes/paths and viewport sizes.

package/corpus/templates/design/server/plugins/auth.ts

@@ -2,10 +2,10 @@ import { createAuthPlugin } from "@agent-native/core/server";
 
 export default createAuthPlugin({
   workspaceAppAudience: "internal",
-  // The visual-edit entry route and public design editor links can load without
-  // a session. Creating, mutating, generating, and sharing designs still go
-  // through authenticated actions.
-  workspaceAppPublicPaths: ["/visual-edit", "/design"],
+  // Visual-edit, public design editor links, and presentation links can load
+  // without a session. Creating, mutating, generating, and sharing designs
+  // still go through authenticated actions.
+  workspaceAppPublicPaths: ["/visual-edit", "/design", "/present"],
   marketing: {
     appName: "Agent-Native Design",
     tagline:
@@ -23,11 +23,13 @@ export default createAuthPlugin({
   // server/routes/api/design-handoff/[id].get.ts — verifyShortLivedToken).
   // publicPaths uses prefix matching, so this covers
   // /api/design-handoff/<id>?token=... while keeping every other /api/* and
-  // /_agent-native/* route behind auth.
+  // /_agent-native/* route behind auth. The listed action routes are read-only;
+  // review comment mutations remain protected by action auth and resource ACLs.
   publicPaths: [
     "/api/design-handoff",
     "/__manifest",
     "/_agent-native/actions/get-design",
     "/_agent-native/actions/list-design-native-assets",
+    "/_agent-native/actions/list-review-comments",
   ],
 });

package/corpus/templates/design/server/plugins/review.ts

@@ -0,0 +1,9 @@
+import { registerReviewableResource } from "@agent-native/core/review";
+import { defineNitroPlugin } from "@agent-native/core/server";
+
+export default defineNitroPlugin(() => {
+  registerReviewableResource({
+    type: "design",
+    displayName: "Design",
+  });
+});

package/corpus/templates/design/shared/review-anchor.ts

@@ -0,0 +1,83 @@
+export interface ReviewAnchorPoint {
+  xPct: number;
+  yPct: number;
+}
+
+export interface DesignReviewAnchor {
+  nodeId?: string;
+  point: ReviewAnchorPoint;
+}
+
+export interface ResolvedReviewAnchor {
+  anchor: DesignReviewAnchor;
+  point: ReviewAnchorPoint;
+  source: "node" | "point";
+}
+
+function finitePercentage(value: unknown): number | null {
+  if (typeof value !== "number" || !Number.isFinite(value)) return null;
+  return Math.min(100, Math.max(0, value));
+}
+
+function inBoundsPercentage(value: unknown): number | null {
+  if (
+    typeof value !== "number" ||
+    !Number.isFinite(value) ||
+    value < 0 ||
+    value > 100
+  ) {
+    return null;
+  }
+  return value;
+}
+
+/**
+ * Parse the persisted anchor contract used by Design review comments.
+ * Malformed anchors intentionally return null so a thread remains visible in
+ * the panel without creating a misleading canvas pin.
+ */
+export function parseReviewAnchor(value: unknown): DesignReviewAnchor | null {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+  const record = value as Record<string, unknown>;
+  const point =
+    record.point &&
+    typeof record.point === "object" &&
+    !Array.isArray(record.point)
+      ? (record.point as Record<string, unknown>)
+      : null;
+  const xPct = finitePercentage(point?.xPct);
+  const yPct = finitePercentage(point?.yPct);
+  if (xPct === null || yPct === null) return null;
+
+  const nodeId = typeof record.nodeId === "string" ? record.nodeId.trim() : "";
+  return {
+    ...(nodeId ? { nodeId } : {}),
+    point: { xPct, yPct },
+  };
+}
+
+/** Resolve a node-id position first, then degrade to the stored click point. */
+export function resolveReviewAnchor(
+  value: unknown,
+  resolveNodePoint: (nodeId: string) => ReviewAnchorPoint | null,
+): ResolvedReviewAnchor | null {
+  const anchor = parseReviewAnchor(value);
+  if (!anchor) return null;
+  if (anchor.nodeId) {
+    const nodePoint = resolveNodePoint(anchor.nodeId);
+    if (nodePoint) {
+      const xPct = inBoundsPercentage(nodePoint.xPct);
+      const yPct = inBoundsPercentage(nodePoint.yPct);
+      if (xPct !== null && yPct !== null) {
+        return {
+          anchor,
+          point: { xPct, yPct },
+          source: "node",
+        };
+      }
+    }
+  }
+  return { anchor, point: anchor.point, source: "point" };
+}

package/corpus/templates/design/shared/review-summary.ts

@@ -0,0 +1,25 @@
+export interface DesignReviewSummary {
+  openCount: number;
+  agentQueueCount: number;
+}
+
+export function readDesignReviewSummary(
+  result: unknown,
+): DesignReviewSummary | null {
+  if (!result || typeof result !== "object") return null;
+  const summary = (result as { summary?: unknown }).summary;
+  if (!summary || typeof summary !== "object") return null;
+  const openCount = Number((summary as { openCount?: unknown }).openCount);
+  const agentQueueCount = Number(
+    (summary as { agentQueueCount?: unknown }).agentQueueCount,
+  );
+  if (
+    !Number.isInteger(openCount) ||
+    openCount < 0 ||
+    !Number.isInteger(agentQueueCount) ||
+    agentQueueCount < 0
+  ) {
+    return null;
+  }
+  return { openCount, agentQueueCount };
+}