@agent-native/core 0.154.5 → 0.157.0

package/corpus/templates/dispatch/app/i18n-data.ts

@@ -327,6 +327,8 @@ const enUS = {
     },
     pages: {
       adminDescription: "Workspace controls and operations",
+      simpleAgentsDescription:
+        "Create reusable agents in minutes, or import a setup you already made in Claude or another agent tool.",
       adminNavigation: "Admin navigation",
       adminWelcome: "Workspace control plane",
       adminChooseArea:
@@ -1209,6 +1211,8 @@ export const messagesByLocale = {
         pages: {
           ...chatFirstPageTranslations["zh-CN"],
           adminDescription: "工作区控制与运营",
+          simpleAgentsDescription:
+            "几分钟内创建可复用的代理，或导入你已在 Claude 或其他代理工具中创建的设置。",
           adminNavigation: "管理导航",
           adminWelcome: "工作区控制中心",
           adminChooseArea: "在一个地方管理应用、连接、自动化和运营工具。",
@@ -1623,6 +1627,8 @@ export const messagesByLocale = {
         pages: {
           ...chatFirstPageTranslations["es-ES"],
           adminDescription: "Controles y operaciones del espacio de trabajo",
+          simpleAgentsDescription:
+            "Crea agentes reutilizables en minutos o importa una configuración que ya hayas creado en Claude u otra herramienta de agentes.",
           adminNavigation: "Navegación de administración",
           adminWelcome: "Panel de control del espacio de trabajo",
           adminChooseArea:
@@ -2048,6 +2054,8 @@ export const messagesByLocale = {
         pages: {
           ...chatFirstPageTranslations["fr-FR"],
           adminDescription: "Contrôles et opérations de l’espace de travail",
+          simpleAgentsDescription:
+            "Créez des agents réutilisables en quelques minutes ou importez une configuration déjà créée dans Claude ou un autre outil d’agents.",
           adminNavigation: "Navigation d’administration",
           adminWelcome: "Centre de contrôle de l’espace de travail",
           adminChooseArea:
@@ -2463,6 +2471,8 @@ export const messagesByLocale = {
         pages: {
           ...chatFirstPageTranslations["de-DE"],
           adminDescription: "Arbeitsbereichssteuerung und -betrieb",
+          simpleAgentsDescription:
+            "Erstelle in wenigen Minuten wiederverwendbare Agents oder importiere eine Konfiguration, die du bereits in Claude oder einem anderen Agent-Tool erstellt hast.",
           adminNavigation: "Administrationsnavigation",
           adminWelcome: "Arbeitsbereichsleitstelle",
           adminChooseArea:
@@ -2873,6 +2883,8 @@ export const messagesByLocale = {
         pages: {
           ...chatFirstPageTranslations["ja-JP"],
           adminDescription: "ワークスペースの管理と運用",
+          simpleAgentsDescription:
+            "数分で再利用可能なエージェントを作成するか、Claude などのエージェントツールで作成済みの設定をインポートします。",
           adminNavigation: "管理ナビゲーション",
           adminWelcome: "ワークスペースのコントロールプレーン",
           adminChooseArea:
@@ -3277,6 +3289,8 @@ export const messagesByLocale = {
         pages: {
           ...chatFirstPageTranslations["ko-KR"],
           adminDescription: "워크스페이스 제어 및 운영",
+          simpleAgentsDescription:
+            "몇 분 만에 재사용 가능한 에이전트를 만들거나 Claude 또는 다른 에이전트 도구에서 만든 설정을 가져오세요.",
           adminNavigation: "관리 탐색",
           adminWelcome: "워크스페이스 제어 센터",
           adminChooseArea:
@@ -3691,6 +3705,8 @@ export const messagesByLocale = {
         pages: {
           ...chatFirstPageTranslations["pt-BR"],
           adminDescription: "Controles e operações do espaço de trabalho",
+          simpleAgentsDescription:
+            "Crie agentes reutilizáveis em minutos ou importe uma configuração que você já criou no Claude ou em outra ferramenta de agentes.",
           adminNavigation: "Navegação de administração",
           adminWelcome: "Central de controle do espaço de trabalho",
           adminChooseArea:
@@ -4096,6 +4112,8 @@ export const messagesByLocale = {
         pages: {
           ...chatFirstPageTranslations["hi-IN"],
           adminDescription: "वर्कस्पेस नियंत्रण और संचालन",
+          simpleAgentsDescription:
+            "कुछ ही मिनटों में दोबारा इस्तेमाल किए जा सकने वाले एजेंट बनाएं, या Claude या किसी अन्य एजेंट टूल में पहले से बनाई गई सेटअप इंपोर्ट करें।",
           adminNavigation: "व्यवस्थापक नेविगेशन",
           adminWelcome: "वर्कस्पेस नियंत्रण केंद्र",
           adminChooseArea:
@@ -4529,6 +4547,8 @@ export const messagesByLocale = {
         pages: {
           ...chatFirstPageTranslations["ar-SA"],
           adminDescription: "عناصر التحكم في مساحة العمل وعملياتها",
+          simpleAgentsDescription:
+            "أنشئ وكلاء قابلين لإعادة الاستخدام خلال دقائق، أو استورد إعدادًا أنشأته بالفعل في Claude أو أداة وكلاء أخرى.",
           adminNavigation: "تنقل الإدارة",
           adminWelcome: "مركز التحكم في مساحة العمل",
           adminChooseArea:

package/corpus/templates/dispatch/server/lib/identity-sso.ts

@@ -14,7 +14,15 @@
 
 import { createHash, randomBytes, timingSafeEqual } from "node:crypto";
 
-import { getDbExec, intType } from "@agent-native/core/db";
+import {
+  getDbExec,
+  intType,
+  isProductionServerlessFunctionRuntime,
+} from "@agent-native/core/db";
+import {
+  CANONICAL_WORKSPACE_SSO_APP_ORIGINS,
+  parseWorkspaceSsoAppRegistrations,
+} from "@agent-native/dispatch/shared/workspace-sso";
 
 const CONTROL_CHARS = /[\u0000-\u001f\u007f]/;
 const APP_ID = /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/;
@@ -62,22 +70,7 @@ export function normalizeIdentityAuthority(raw: unknown): string | null {
 
 /** Exact first-party app origins. Never replace this with a suffix check. */
 export const CANONICAL_IDENTITY_SSO_APP_ORIGINS = {
-  analytics: "https://analytics.agent-native.com",
-  assets: "https://assets.agent-native.com",
-  brain: "https://brain.agent-native.com",
-  calendar: "https://calendar.agent-native.com",
-  chat: "https://chat.agent-native.com",
-  clips: "https://clips.agent-native.com",
-  content: "https://content.agent-native.com",
-  crm: "https://crm.agent-native.com",
-  design: "https://design.agent-native.com",
-  dispatch: "https://dispatch.agent-native.com",
-  forms: "https://forms.agent-native.com",
-  macros: "https://macros.agent-native.com",
-  mail: "https://mail.agent-native.com",
-  plan: "https://plan.agent-native.com",
-  slides: "https://slides.agent-native.com",
-  tasks: "https://tasks.agent-native.com",
+  ...CANONICAL_WORKSPACE_SSO_APP_ORIGINS,
 } as const;
 
 export const DEFAULT_ALLOWED_ORIGINS: readonly string[] = Object.values(
@@ -102,82 +95,17 @@ function canonicalRegistrations(): IdentitySsoAppRegistration[] {
   );
 }
 
-function exactOrigin(raw: unknown): string | null {
-  if (typeof raw !== "string" || !raw || CONTROL_CHARS.test(raw)) return null;
-  try {
-    const url = new URL(raw);
-    if (
-      url.protocol !== "https:" &&
-      !(url.protocol === "http:" && LOCALHOST_HOSTS.has(url.hostname))
-    ) {
-      return null;
-    }
-    if (
-      url.username ||
-      url.password ||
-      url.pathname !== "/" ||
-      url.search ||
-      url.hash
-    ) {
-      return null;
-    }
-    return url.origin;
-  } catch (error) {
-    void error;
-    return null;
-  }
-}
-
 function parseCustomRegistrations(
   env: NodeJS.ProcessEnv,
 ): IdentitySsoAppRegistration[] {
-  const raw = env.IDENTITY_SSO_APP_REGISTRY_JSON?.trim();
-  if (!raw) return [];
-  let value: unknown;
-  try {
-    value = JSON.parse(raw);
-  } catch (error) {
-    void error;
-    return [];
-  }
-  if (!Array.isArray(value)) return [];
-
-  const registrations: IdentitySsoAppRegistration[] = [];
-  const seen = new Set<string>();
-  for (const entry of value) {
-    if (!entry || typeof entry !== "object") continue;
-    const candidate = entry as Record<string, unknown>;
-    const appId = candidate.appId;
-    const clientId = candidate.clientId;
-    const origin = exactOrigin(candidate.origin);
-    const callbackPath = candidate.callbackPath;
-    const capabilities = candidate.capabilities;
-    if (
-      typeof appId !== "string" ||
-      !APP_ID.test(appId) ||
-      typeof clientId !== "string" ||
-      !CLIENT_ID.test(clientId) ||
-      !origin ||
-      callbackPath !== IDENTITY_SSO_CALLBACK_PATH ||
-      !Array.isArray(capabilities) ||
-      !capabilities.includes("identity-sso") ||
-      seen.has(appId) ||
-      Object.prototype.hasOwnProperty.call(
-        CANONICAL_IDENTITY_SSO_APP_ORIGINS,
-        appId,
-      )
-    ) {
-      continue;
-    }
-    seen.add(appId);
-    registrations.push({
-      appId,
-      clientId,
-      origin,
-      callbackPath: IDENTITY_SSO_CALLBACK_PATH,
-    });
-  }
-  return registrations;
+  return parseWorkspaceSsoAppRegistrations(
+    env.IDENTITY_SSO_APP_REGISTRY_JSON,
+  ).map((registration) => ({
+    appId: registration.appId,
+    clientId: registration.clientId,
+    origin: registration.origin,
+    callbackPath: IDENTITY_SSO_CALLBACK_PATH,
+  }));
 }
 
 /**
@@ -390,6 +318,9 @@ function buildCodeTableSql(): string {
 }
 
 async function ensureCodeTable(): Promise<void> {
+  // The Dispatch release migration owns this table in production serverless
+  // deployments. Do not turn a missing release migration into request-time DDL.
+  if (isProductionServerlessFunctionRuntime()) return;
   if (!codeTableInitPromise) {
     codeTableInitPromise = getDbExec()
       .execute(buildCodeTableSql())

package/corpus/templates/dispatch/server/plugins/identity-sso.ts

@@ -17,9 +17,8 @@
 
 import { signA2AToken } from "@agent-native/core/a2a";
 import {
-  getFeatureFlagRules,
+  hasActiveFeatureFlagRollout,
   isFeatureFlagEnabled,
-  normalizeFeatureFlagRules,
 } from "@agent-native/core/feature-flags";
 import { getOrgDomain } from "@agent-native/core/org";
 import { getH3App, getSession } from "@agent-native/core/server";
@@ -103,16 +102,8 @@ async function resolveOrgDomain(
 }
 
 export async function canAttemptWorkspaceSso(): Promise<boolean> {
-  const stored = await getFeatureFlagRules(
-    DESKTOP_WORKSPACE_SSO_FLAG.key,
-    {},
-  ).catch(() => null);
-  if (!stored) return false;
-  const rules = normalizeFeatureFlagRules(stored);
-  if (rules.mode === "off") return false;
-  if (rules.mode === "on") return true;
-  return (
-    rules.emails.length > 0 || rules.orgIds.length > 0 || rules.percentage > 0
+  return hasActiveFeatureFlagRollout(DESKTOP_WORKSPACE_SSO_FLAG.key).catch(
+    () => false,
   );
 }
 

package/corpus/templates/dispatch/shared/feature-flags.ts

@@ -2,6 +2,9 @@ import {
   defineFeatureFlag,
   defineFeatureFlags,
 } from "@agent-native/core/feature-flags";
+import { DISPATCH_WORKSPACE_SSO_FLAG } from "@agent-native/dispatch/shared/feature-flags";
+
+export { DISPATCH_WORKSPACE_SSO_FLAG };
 
 export const DESKTOP_WORKSPACE_SSO_FLAG = defineFeatureFlag({
   key: "desktop.workspace-sso",
@@ -12,4 +15,5 @@ export const DESKTOP_WORKSPACE_SSO_FLAG = defineFeatureFlag({
 
 export const DISPATCH_FEATURE_FLAGS = defineFeatureFlags([
   DESKTOP_WORKSPACE_SSO_FLAG,
+  DISPATCH_WORKSPACE_SSO_FLAG,
 ]);

package/corpus/templates/factory/AGENTS.md

@@ -37,7 +37,7 @@ decisions, feedback, agent runs, and provider audit records.
 
 - `navigation.view`: `factory` when the workspace is open.
 - `navigation.factoryId`: selected Factory id when present.
-- `navigation.factoryTab`: `map` | `inbox` | `rules` | `automations` | `audit` | `settings`.
+- `navigation.factoryTab`: `map` | `inbox` | `rules` | `automations` | `agents` | `audit` | `settings`.
 - `navigation.factoryAuditRunId`: selected automation run in the audit view when present.
 - `navigation.factoryNodeId` / `navigation.factoryEdgeId`: selected graph item.
 - A selected graph node or edge is part of `navigation` context. Read
@@ -68,6 +68,10 @@ decisions, feedback, agent runs, and provider audit records.
 | `save-factory-graph` | Create or version a complete visual graph; never starts provider work. |
 | `list-factory-comments` / `add-factory-comment` | Read or attach comments to a canvas, node, or edge. |
 | `provider-api-catalog` / `provider-api-docs` / `provider-api-request` | Discover and use connected provider APIs with shared workspace credentials; never request raw keys. |
+| `list-workspace-apps` / `update-workspace-app-metadata` | Inventory and edit mounted agentic apps in the shared workspace. |
+| `list-workspace-resources` / `create-workspace-resource` / `update-workspace-resource` | Manage shared resource records used by agents and apps. |
+| `import-agent` / `import-agent-pack` / `list-agent-pack` | Import a simple profile or a Claude/Cowork-style folder-backed agent pack. |
+| `start-workspace-app-creation` | Promote an agent and all of its pack resource ids into an app-creation handoff. |
 
 Rules start in shadow mode; hard guards always apply. Organization automations
 execute stored prompts, and every external mutation needs a durable run,

package/corpus/templates/factory/README.md

@@ -74,6 +74,29 @@ signed callback secret belong in Dispatch workspace credentials and are
 resolved at runtime. The app remains observe-only until a human explicitly
 approves a Factory item.
 
+## Agents and agentic apps
+
+Factory's top-level Agents tab is a shared workspace surface, not a second
+registry. It reads mounted agentic apps and their editable Dispatch metadata,
+then embeds Dispatch's reusable-agent manager for create, chat, import, and
+folder-backed pack editing. A simple agent's profile lives at
+`agents/<slug>.md`; its optional context, references, and private skills live
+under `agents/<slug>/`. Use the folder import to bring in a Claude Project,
+Cowork-style folder, or another text-based agent setup. The importer strips
+credentials, hooks, shell commands, and local environment settings, and All-app
+imports remain subject to Dispatch approval policy.
+
+When editing a factory flow, an agent step can bind to either a shared reusable
+agent or a ready mounted agentic app from the same workspace database. The map
+stores the selected target type and id, while the graph remains a reviewable
+blueprint and does not silently change runtime routing.
+
+Use **Build app** on an agent row when the agent needs a full workspace face.
+The handoff carries the profile and every pack resource id into app creation;
+the original agent remains reusable after the app is created. Mounted apps and
+simple agents continue to use the same Dispatch actions, SQL resources, grants,
+and application-state navigation.
+
 ## Development
 
 ```bash

package/corpus/templates/factory/actions/view-screen.ts

@@ -9,6 +9,7 @@
 
 import { defineAction } from "@agent-native/core/action";
 import { readAppState } from "@agent-native/core/application-state";
+import { dispatchActions } from "@agent-native/dispatch/actions";
 import { z } from "zod";
 
 import {
@@ -22,6 +23,12 @@ import {
   workspaceMemberIdentityFromContext,
 } from "../server/lib/require-workspace-member.js";
 
+async function runDispatchAction(name: string, args: Record<string, unknown>) {
+  const action = dispatchActions[name];
+  if (!action) throw new Error(`Dispatch action not found: ${name}`);
+  return action.run(args);
+}
+
 export default defineAction({
   description:
     "See what the user is currently looking at on screen. Returns the current navigation state for chat or Factory. Always call this first when the visible selection matters.",
@@ -63,6 +70,16 @@ export default defineAction({
         selectedNode: graph.nodes.find((node) => node.id === selectedNodeId),
         selectedEdge: graph.edges.find((edge) => edge.id === selectedEdgeId),
       };
+
+      if (state.factoryTab === "agents") {
+        const [apps, agents] = await Promise.all([
+          runDispatchAction("list-workspace-apps", {
+            includeAgentCards: false,
+          }),
+          runDispatchAction("list-workspace-resources", { kind: "agent" }),
+        ]);
+        screen.factoryAgents = { apps, agents };
+      }
     }
 
     if (Object.keys(screen).length === 0) {

package/corpus/templates/factory/app/components/factory/FactoryAgentsView.tsx

@@ -0,0 +1,239 @@
+import {
+  useActionMutation,
+  useActionQuery,
+} from "@agent-native/core/client/hooks";
+import { useT } from "@agent-native/core/client/i18n";
+import { SimpleAgentsPanel } from "@agent-native/dispatch/components";
+import { ActionQueryError } from "@agent-native/dispatch/components";
+import { Badge } from "@agent-native/dispatch/components/ui/badge";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+  DialogTrigger,
+} from "@agent-native/dispatch/components/ui/dialog";
+import {
+  IconEdit,
+  IconExternalLink,
+  IconLayoutGrid,
+} from "@tabler/icons-react";
+import { useEffect, useState } from "react";
+import { toast } from "sonner";
+
+import { Button } from "@/components/ui/button";
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Textarea } from "@/components/ui/textarea";
+
+interface WorkspaceAppSummary {
+  id: string;
+  name: string;
+  description?: string;
+  path: string;
+  url: string | null;
+  isDispatch: boolean;
+  status?: "ready" | "pending";
+  statusLabel?: string;
+}
+
+function EditAppDialog({
+  app,
+  onSaved,
+  t,
+}: {
+  app: WorkspaceAppSummary;
+  onSaved: () => void;
+  t: ReturnType<typeof useT>;
+}) {
+  const [open, setOpen] = useState(false);
+  const [name, setName] = useState(app.name);
+  const [description, setDescription] = useState(app.description ?? "");
+  const update = useActionMutation("update-workspace-app-metadata", {
+    onSuccess: () => {
+      toast.success(t("factoryRoute.appDetailsUpdated"));
+      setOpen(false);
+      onSaved();
+    },
+    onError: (error) => toast.error(error.message),
+  });
+
+  useEffect(() => {
+    if (!open) return;
+    setName(app.name);
+    setDescription(app.description ?? "");
+  }, [app, open]);
+
+  return (
+    <Dialog open={open} onOpenChange={setOpen}>
+      <DialogTrigger asChild>
+        <Button variant="ghost" size="icon" aria-label={`Edit ${app.name}`}>
+          <IconEdit size={16} />
+        </Button>
+      </DialogTrigger>
+      <DialogContent>
+        <DialogHeader>
+          <DialogTitle>{t("factoryRoute.editAppDetails")}</DialogTitle>
+          <DialogDescription className="sr-only">
+            {t("factoryRoute.editAppDetailsDescription")}
+          </DialogDescription>
+        </DialogHeader>
+        <div className="space-y-4 py-2">
+          <div className="space-y-2">
+            <Label htmlFor={`factory-app-name-${app.id}`}>
+              {t("factoryRoute.appName")}
+            </Label>
+            <Input
+              id={`factory-app-name-${app.id}`}
+              value={name}
+              onChange={(event) => setName(event.target.value)}
+            />
+          </div>
+          <div className="space-y-2">
+            <Label htmlFor={`factory-app-description-${app.id}`}>
+              {t("factoryRoute.appDescription")}
+            </Label>
+            <Textarea
+              id={`factory-app-description-${app.id}`}
+              value={description}
+              onChange={(event) => setDescription(event.target.value)}
+              rows={4}
+            />
+          </div>
+        </div>
+        <DialogFooter>
+          <Button
+            onClick={() =>
+              update.mutate({
+                appId: app.id,
+                name: name.trim(),
+                description: description.trim(),
+              })
+            }
+            disabled={!name.trim() || update.isPending}
+          >
+            {update.isPending
+              ? t("factoryRoute.savingChanges")
+              : t("factoryRoute.saveChanges")}
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+}
+
+function AgenticAppsSection({ t }: { t: ReturnType<typeof useT> }) {
+  const query = useActionQuery<WorkspaceAppSummary[]>("list-workspace-apps", {
+    includeAgentCards: false,
+  });
+  const apps = (query.data ?? []).filter((app) => !app.isDispatch);
+
+  if (query.isError) {
+    return (
+      <ActionQueryError
+        error={query.error}
+        onRetry={() => void query.refetch()}
+      />
+    );
+  }
+
+  return (
+    <Card>
+      <CardHeader>
+        <CardTitle className="flex items-center gap-2 text-base">
+          <IconLayoutGrid className="size-4 text-muted-foreground" />
+          {t("factoryRoute.agenticAppsTitle")}
+        </CardTitle>
+      </CardHeader>
+      <CardContent>
+        {query.isLoading && apps.length === 0 ? (
+          <div className="space-y-3">
+            {[0, 1].map((item) => (
+              <div
+                key={item}
+                className="h-16 animate-pulse rounded-xl bg-muted"
+              />
+            ))}
+          </div>
+        ) : apps.length > 0 ? (
+          <div className="space-y-2">
+            {apps.map((app) => (
+              <div
+                key={app.id}
+                className="flex items-start gap-3 rounded-xl border px-4 py-3"
+              >
+                <div className="flex size-9 shrink-0 items-center justify-center rounded-lg bg-muted text-muted-foreground">
+                  <IconLayoutGrid size={18} />
+                </div>
+                <div className="min-w-0 flex-1">
+                  <div className="flex flex-wrap items-center gap-2">
+                    <span className="text-sm font-medium">{app.name}</span>
+                    {app.status ? (
+                      <Badge variant="outline">
+                        {app.statusLabel || app.status}
+                      </Badge>
+                    ) : null}
+                  </div>
+                  {app.description ? (
+                    <div className="mt-1 text-sm text-muted-foreground">
+                      {app.description}
+                    </div>
+                  ) : null}
+                  <div className="mt-1 font-mono text-[11px] text-muted-foreground/70">
+                    {app.path}
+                  </div>
+                </div>
+                <div className="flex shrink-0 items-center gap-1">
+                  {app.url ? (
+                    <Button variant="ghost" size="icon" asChild>
+                      <a
+                        href={app.url}
+                        target="_blank"
+                        rel="noreferrer"
+                        aria-label={t("factoryRoute.openApp")}
+                      >
+                        <IconExternalLink size={16} />
+                      </a>
+                    </Button>
+                  ) : null}
+                  <EditAppDialog
+                    app={app}
+                    t={t}
+                    onSaved={() => void query.refetch()}
+                  />
+                </div>
+              </div>
+            ))}
+          </div>
+        ) : (
+          <div className="rounded-xl border border-dashed px-6 py-10 text-center text-sm text-muted-foreground">
+            {t("factoryRoute.agenticAppsEmpty")}
+          </div>
+        )}
+      </CardContent>
+    </Card>
+  );
+}
+
+export function FactoryAgentsView() {
+  const t = useT();
+
+  return (
+    <div className="space-y-6 p-4 lg:p-6">
+      <AgenticAppsSection t={t} />
+      <Card>
+        <CardHeader>
+          <CardTitle className="text-base">
+            {t("factoryRoute.agentsTitle")}
+          </CardTitle>
+        </CardHeader>
+        <CardContent>
+          <SimpleAgentsPanel />
+        </CardContent>
+      </Card>
+    </div>
+  );
+}

package/corpus/templates/factory/app/components/factory/FactoryCanvas.tsx

@@ -44,6 +44,8 @@ export type FactoryCanvasNode = {
     | "human"
     | "factory";
   agent?: string;
+  agentTargetType?: "agent" | "app";
+  agentTargetId?: string;
   metricsKey?: string;
   position: { x: number; y: number };
 };