@agent-native/core 0.194.0 → 0.195.0-nightly-20260927130129

package/corpus/README.md

@@ -31,4 +31,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 ## Generated Counts
 
-- template files: 10319
+- template files: 10327

package/corpus/templates/brain/actions/check-builder-embeddings.ts

@@ -0,0 +1,71 @@
+import { defineAction } from "@agent-native/core/action";
+import { readEmbeddingFamilyAvailability } from "@agent-native/core/embeddings";
+import { runWithRequestContext } from "@agent-native/core/server/request-context";
+import { assertAccess } from "@agent-native/core/sharing";
+import { eq } from "drizzle-orm";
+import { z } from "zod";
+
+import { getDb, schema } from "../server/db/index.js";
+
+export const checkBuilderEmbeddingsSchema = z.object({
+  sourceId: z.string().min(1),
+  confirmProviderCost: z.literal(true),
+});
+
+export default defineAction({
+  description:
+    "Check Builder embeddings for one Brain source with a single synthetic query; does not index or store data.",
+  schema: checkBuilderEmbeddingsSchema,
+  toolCallable: false,
+  needsApproval: true,
+  run: async ({ sourceId }) => {
+    await assertAccess("brain-source", sourceId, "admin");
+    const [source] = await getDb()
+      .select({
+        ownerEmail: schema.brainSources.ownerEmail,
+        orgId: schema.brainSources.orgId,
+      })
+      .from(schema.brainSources)
+      .where(eq(schema.brainSources.id, sourceId))
+      .limit(1);
+    if (!source) throw new Error("Brain source was not found.");
+
+    return runWithRequestContext(
+      {
+        userEmail: source.ownerEmail,
+        orgId: source.orgId ?? undefined,
+      },
+      async () => {
+        const availability = await readEmbeddingFamilyAvailability();
+        if (availability.unavailableProviders.includes("builder")) {
+          throw new Error(
+            "Builder embedding credential lookup is unavailable.",
+          );
+        }
+        const family = availability.families.find(
+          (candidate) => candidate.provider === "builder",
+        );
+        if (!family) throw new Error("Builder embeddings are not configured.");
+        const vectors = await family.embed(
+          [{ text: "Builder embedding connectivity check." }],
+          "query",
+        );
+        const [vector] = vectors;
+        if (
+          vectors.length !== 1 ||
+          !vector ||
+          vector.length !== family.dimensions ||
+          !vector.every(Number.isFinite)
+        ) {
+          throw new Error("Builder returned an invalid embedding.");
+        }
+        return {
+          provider: family.provider,
+          model: family.model,
+          dimensions: family.dimensions,
+          success: true,
+        };
+      },
+    );
+  },
+});

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

@@ -493,6 +493,15 @@ const enUS = {
     reviewRequired: "Review required",
     reviewRequiredDescription: "Queue extracted knowledge before approval",
     cancel: "Cancel",
+    close: "Close",
+    checkBuilder: "Check Builder embeddings",
+    checkBuilderDescription:
+      "Verify Builder with one synthetic request. No source content is sent or indexed.",
+    checkBuilderConfirm:
+      "Run one synthetic Builder embedding request for {{source}}? This may incur provider usage. No source content is sent, and the vector is not stored.",
+    runBuilderCheck: "Run one check",
+    checkBuilderSuccess:
+      "Builder check passed: {{provider}} / {{model}}, {{dimensions}} dimensions. No vector was stored.",
     saveSource: "Save source",
     createSource: "Create source",
     retryAfter: "Retry after {{date}}",
@@ -1006,6 +1015,15 @@ const baseMessagesByLocale = {
       provider: "提供方",
       notRequired: "不需要",
       cancel: "取消",
+      close: "关闭",
+      checkBuilder: "检查 Builder 嵌入服务",
+      checkBuilderDescription:
+        "发送一次模拟请求以验证 Builder。不会发送或索引来源内容。",
+      checkBuilderConfirm:
+        "要为 {{source}} 发送一次模拟的 Builder 嵌入请求吗？这可能产生服务费用。不会发送来源内容，也不会保存向量。",
+      runBuilderCheck: "运行一次检查",
+      checkBuilderSuccess:
+        "Builder 检查通过：{{provider}} / {{model}}，{{dimensions}} 维。未保存向量。",
       saveSource: "保存来源",
       createSource: "创建来源",
       retryAfter: "{{date}} 后重试",
@@ -1212,6 +1230,15 @@ const baseMessagesByLocale = {
       provider: "Proveedor",
       notRequired: "No requerido",
       cancel: "Cancelar",
+      close: "Cerrar",
+      checkBuilder: "Comprobar embeddings de Builder",
+      checkBuilderDescription:
+        "Verifica Builder con una solicitud de prueba. No se envía ni indexa contenido de la fuente.",
+      checkBuilderConfirm:
+        "¿Enviar una solicitud de prueba de embeddings de Builder para {{source}}? Puede generar costes del proveedor. No se envía contenido de la fuente ni se guarda el vector.",
+      runBuilderCheck: "Realizar una comprobación",
+      checkBuilderSuccess:
+        "Comprobación de Builder correcta: {{provider}} / {{model}}, {{dimensions}} dimensiones. No se guardó ningún vector.",
       saveSource: "Guardar fuente",
       createSource: "Crear fuente",
       retryAfter: "Reintentar después de {{date}}",
@@ -1428,6 +1455,15 @@ const baseMessagesByLocale = {
       provider: "Fournisseur",
       notRequired: "Non requis",
       cancel: "Annuler",
+      close: "Fermer",
+      checkBuilder: "Vérifier les embeddings Builder",
+      checkBuilderDescription:
+        "Vérifiez Builder avec une seule requête de test. Aucun contenu de la source n'est envoyé ni indexé.",
+      checkBuilderConfirm:
+        "Envoyer une requête de test d'embedding Builder pour {{source}} ? Cela peut entraîner des frais du fournisseur. Aucun contenu de la source n'est envoyé et le vecteur n'est pas stocké.",
+      runBuilderCheck: "Lancer une vérification",
+      checkBuilderSuccess:
+        "Vérification Builder réussie : {{provider}} / {{model}}, {{dimensions}} dimensions. Aucun vecteur n'a été stocké.",
       saveSource: "Enregistrer la source",
       createSource: "Créer une source",
       retryAfter: "Réessayer après {{date}}",
@@ -1643,6 +1679,15 @@ const baseMessagesByLocale = {
       provider: "Anbieter",
       notRequired: "Nicht erforderlich",
       cancel: "Abbrechen",
+      close: "Schließen",
+      checkBuilder: "Builder-Embeddings prüfen",
+      checkBuilderDescription:
+        "Builder mit einer Testanfrage prüfen. Quellinhalte werden weder gesendet noch indexiert.",
+      checkBuilderConfirm:
+        "Eine Testanfrage für Builder-Embeddings zu {{source}} senden? Dabei können Anbietergebühren anfallen. Quellinhalte werden nicht gesendet und der Vektor wird nicht gespeichert.",
+      runBuilderCheck: "Einmal prüfen",
+      checkBuilderSuccess:
+        "Builder-Prüfung erfolgreich: {{provider}} / {{model}}, {{dimensions}} Dimensionen. Kein Vektor wurde gespeichert.",
       saveSource: "Quelle speichern",
       createSource: "Quelle erstellen",
       retryAfter: "Erneut versuchen nach {{date}}",
@@ -1853,6 +1898,15 @@ const baseMessagesByLocale = {
       provider: "プロバイダー",
       notRequired: "不要",
       cancel: "キャンセル",
+      close: "閉じる",
+      checkBuilder: "Builder の埋め込みを確認",
+      checkBuilderDescription:
+        "テスト用のリクエストを 1 回送信して Builder を確認します。ソースの内容は送信もインデックス登録もされません。",
+      checkBuilderConfirm:
+        "{{source}} に対して Builder の埋め込みテストリクエストを 1 回送信しますか？プロバイダーの利用料金が発生する場合があります。ソースの内容は送信されず、ベクトルも保存されません。",
+      runBuilderCheck: "1 回確認する",
+      checkBuilderSuccess:
+        "Builder の確認に成功しました: {{provider}} / {{model}}、{{dimensions}} 次元。ベクトルは保存されていません。",
       saveSource: "ソースを保存",
       createSource: "ソースを作成",
       retryAfter: "{{date}} 後に再試行",
@@ -2063,6 +2117,15 @@ const baseMessagesByLocale = {
       provider: "제공자",
       notRequired: "필요 없음",
       cancel: "취소",
+      close: "닫기",
+      checkBuilder: "Builder 임베딩 확인",
+      checkBuilderDescription:
+        "테스트 요청 한 번으로 Builder를 확인합니다. 소스 내용은 전송하거나 인덱싱하지 않습니다.",
+      checkBuilderConfirm:
+        "{{source}}에 대해 Builder 임베딩 테스트 요청을 한 번 보내시겠습니까? 제공업체 사용 요금이 발생할 수 있습니다. 소스 내용은 전송하지 않으며 벡터도 저장하지 않습니다.",
+      runBuilderCheck: "한 번 확인하기",
+      checkBuilderSuccess:
+        "Builder 확인 성공: {{provider}} / {{model}}, {{dimensions}}차원. 벡터는 저장되지 않았습니다.",
       saveSource: "소스 저장",
       createSource: "소스 만들기",
       retryAfter: "{{date}} 후 다시 시도",
@@ -2273,6 +2336,15 @@ const baseMessagesByLocale = {
       provider: "Provedor",
       notRequired: "Não obrigatório",
       cancel: "Cancelar",
+      close: "Fechar",
+      checkBuilder: "Verificar embeddings do Builder",
+      checkBuilderDescription:
+        "Verifique o Builder com uma solicitação de teste. O conteúdo da fonte não é enviado nem indexado.",
+      checkBuilderConfirm:
+        "Enviar uma solicitação de teste de embeddings do Builder para {{source}}? Isso pode gerar custos do provedor. O conteúdo da fonte não é enviado e o vetor não é armazenado.",
+      runBuilderCheck: "Executar uma verificação",
+      checkBuilderSuccess:
+        "Verificação do Builder concluída: {{provider}} / {{model}}, {{dimensions}} dimensões. Nenhum vetor foi armazenado.",
       saveSource: "Salvar fonte",
       createSource: "Criar fonte",
       retryAfter: "Tentar novamente após {{date}}",
@@ -2487,6 +2559,15 @@ const baseMessagesByLocale = {
       provider: "प्रदाता",
       notRequired: "आवश्यक नहीं",
       cancel: "रद्द करें",
+      close: "बंद करें",
+      checkBuilder: "Builder एम्बेडिंग जाँचें",
+      checkBuilderDescription:
+        "एक परीक्षण अनुरोध से Builder की जाँच करें। स्रोत की सामग्री भेजी या इंडेक्स नहीं की जाती।",
+      checkBuilderConfirm:
+        "{{source}} के लिए Builder एम्बेडिंग का एक परीक्षण अनुरोध भेजें? प्रदाता का शुल्क लग सकता है। स्रोत की सामग्री नहीं भेजी जाएगी और वेक्टर सहेजा नहीं जाएगा।",
+      runBuilderCheck: "एक बार जाँचें",
+      checkBuilderSuccess:
+        "Builder जाँच सफल: {{provider}} / {{model}}, {{dimensions}} आयाम। कोई वेक्टर सहेजा नहीं गया।",
       saveSource: "स्रोत सहेजें",
       createSource: "स्रोत बनाएं",
       retryAfter: "{{date}} के बाद फिर कोशिश करें",
@@ -2695,6 +2776,15 @@ const baseMessagesByLocale = {
       provider: "المزوّد",
       notRequired: "غير مطلوب",
       cancel: "إلغاء",
+      close: "إغلاق",
+      checkBuilder: "التحقق من تضمينات Builder",
+      checkBuilderDescription:
+        "تحقّق من Builder بطلب اختباري واحد. لن يُرسل محتوى المصدر أو يُفهرس.",
+      checkBuilderConfirm:
+        "هل تريد إرسال طلب اختباري واحد لتضمينات Builder من أجل {{source}}؟ قد تترتب رسوم من المزوّد. لن يُرسل محتوى المصدر ولن يُحفظ المتجه.",
+      runBuilderCheck: "إجراء تحقق واحد",
+      checkBuilderSuccess:
+        "نجح التحقق من Builder: {{provider}} / {{model}}، {{dimensions}} بُعدًا. لم يُحفظ أي متجه.",
       saveSource: "حفظ المصدر",
       createSource: "إنشاء مصدر",
       retryAfter: "إعادة المحاولة بعد {{date}}",

package/corpus/templates/brain/app/routes/sources.tsx

@@ -10,6 +10,7 @@ import {
   IconArchive,
   IconBrandGithub,
   IconBrandSlack,
+  IconBolt,
   IconChecks,
   IconChevronDown,
   IconCircleCheck,
@@ -1803,6 +1804,21 @@ function SourceListItem({
 }) {
   const t = useT();
   const [expanded, setExpanded] = useState(false);
+  const [builderCheckOpen, setBuilderCheckOpen] = useState(false);
+  const sourceAccess = useActionQuery<{ accessRole?: string }>(
+    "get-source" as any,
+    { id: source.id } as any,
+    { enabled: expanded, retry: false },
+  );
+  const checkBuilder = useActionMutation<
+    { provider: string; model: string; dimensions: number; success: boolean },
+    { sourceId: string; confirmProviderCost: true }
+  >("check-builder-embeddings" as any, {
+    skipActionQueryInvalidation: true,
+  });
+  const canCheckBuilder =
+    sourceAccess.data?.accessRole === "admin" ||
+    sourceAccess.data?.accessRole === "owner";
   const Icon = sourceProviderIcon(source.provider);
   const retry = sourceRetryAfter(source);
   const hasSyncNotice = Boolean(
@@ -1979,6 +1995,25 @@ function SourceListItem({
                   </Button>
                 </div>
               ) : null}
+              {canCheckBuilder ? (
+                <div className="mt-3 flex flex-col gap-3 rounded-md border border-border bg-muted/25 p-3 sm:flex-row sm:items-center sm:justify-between">
+                  <p className="text-sm leading-6 text-muted-foreground">
+                    {t("sources.checkBuilderDescription")}
+                  </p>
+                  <Button
+                    size="sm"
+                    variant="outline"
+                    className="shrink-0"
+                    onClick={() => {
+                      checkBuilder.reset();
+                      setBuilderCheckOpen(true);
+                    }}
+                  >
+                    <IconBolt className="size-4" />
+                    {t("sources.checkBuilder")}
+                  </Button>
+                </div>
+              ) : null}
               {hasSyncNotice ? (
                 <div className="mt-3 flex gap-2 rounded-md border border-destructive/20 bg-destructive/5 px-3 py-2 text-sm">
                   <IconAlertTriangle className="mt-0.5 size-4 shrink-0 text-destructive" />
@@ -2017,6 +2052,66 @@ function SourceListItem({
           ) : null}
         </div>
       ) : null}
+
+      <Dialog
+        open={builderCheckOpen}
+        onOpenChange={(open) => {
+          if (!open && checkBuilder.isPending) return;
+          setBuilderCheckOpen(open);
+        }}
+      >
+        <DialogContent className="max-w-md gap-5">
+          <DialogHeader>
+            <DialogTitle>{t("sources.checkBuilder")}</DialogTitle>
+            <DialogDescription>
+              {t("sources.checkBuilderConfirm", { source: sourceName(source) })}
+            </DialogDescription>
+          </DialogHeader>
+          {checkBuilder.data ? (
+            <p role="status" className="text-sm text-foreground">
+              {t("sources.checkBuilderSuccess", {
+                provider: checkBuilder.data.provider,
+                model: checkBuilder.data.model,
+                dimensions: checkBuilder.data.dimensions.toLocaleString(),
+              })}
+            </p>
+          ) : null}
+          {checkBuilder.isError ? (
+            <p role="alert" className="text-sm text-destructive">
+              {checkBuilder.error.message}
+            </p>
+          ) : null}
+          <DialogFooter>
+            <Button
+              type="button"
+              variant="outline"
+              disabled={checkBuilder.isPending}
+              onClick={() => setBuilderCheckOpen(false)}
+            >
+              {checkBuilder.data ? t("sources.close") : t("sources.cancel")}
+            </Button>
+            {!checkBuilder.data ? (
+              <Button
+                type="button"
+                disabled={checkBuilder.isPending}
+                onClick={() =>
+                  checkBuilder.mutate({
+                    sourceId: source.id,
+                    confirmProviderCost: true,
+                  })
+                }
+              >
+                {checkBuilder.isPending ? (
+                  <IconLoader2 className="size-4 animate-spin" />
+                ) : (
+                  <IconBolt className="size-4" />
+                )}
+                {t("sources.runBuilderCheck")}
+              </Button>
+            ) : null}
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
     </div>
   );
 }