@agent-native/core 0.102.2 → 0.103.1

package/corpus/core/src/local-artifacts/index.ts

@@ -16,6 +16,14 @@ export interface AgentNativeManifestRoot {
   extensions?: string[];
   include?: string[];
   hide?: string[];
+  source?: {
+    type: "local-folder";
+    connectionId: string;
+    truthPolicy?:
+      | "database_primary"
+      | "source_primary"
+      | "reviewed_bidirectional";
+  };
 }
 
 export interface AgentNativeManifestApp {
@@ -73,6 +81,7 @@ export interface LoadedLocalArtifactRoot {
   extensions: string[];
   hide: string[];
   include: string[];
+  source?: AgentNativeManifestRoot["source"];
 }
 
 export interface LoadedLocalArtifactApp {
@@ -267,6 +276,26 @@ function rootNameFromPath(rootPath: string): string {
 function normalizeManifestRoot(value: unknown): AgentNativeManifestRoot | null {
   if (typeof value === "string") return { path: value };
   if (!isRecord(value) || typeof value.path !== "string") return null;
+  const truthPolicy:
+    | NonNullable<AgentNativeManifestRoot["source"]>["truthPolicy"]
+    | undefined =
+    value.source &&
+    isRecord(value.source) &&
+    (value.source.truthPolicy === "database_primary" ||
+      value.source.truthPolicy === "source_primary" ||
+      value.source.truthPolicy === "reviewed_bidirectional")
+      ? value.source.truthPolicy
+      : undefined;
+  const source =
+    isRecord(value.source) &&
+    value.source.type === "local-folder" &&
+    typeof value.source.connectionId === "string"
+      ? {
+          type: "local-folder" as const,
+          connectionId: value.source.connectionId,
+          ...(truthPolicy ? { truthPolicy } : {}),
+        }
+      : undefined;
   return {
     name: typeof value.name === "string" ? value.name : undefined,
     path: value.path,
@@ -275,6 +304,7 @@ function normalizeManifestRoot(value: unknown): AgentNativeManifestRoot | null {
     extensions: normalizeExtensions(value.extensions),
     include: asStringArray(value.include),
     hide: asStringArray(value.hide),
+    ...(source ? { source } : {}),
   };
 }
 
@@ -483,6 +513,7 @@ export async function getLocalArtifactApp(
       extensions,
       hide: [...DEFAULT_HIDE_PATTERNS, ...asStringArray(root.hide)],
       include: asStringArray(root.include),
+      source: root.source,
     };
   });
 
@@ -683,6 +714,16 @@ export async function listLocalArtifactFiles(
   return files.sort((a, b) => a.path.localeCompare(b.path));
 }
 
+export async function listConfiguredLocalArtifactFiles(
+  options: LocalArtifactOptions,
+): Promise<LocalArtifactFileMeta[]> {
+  const app = await getLocalArtifactApp(options);
+  const files = (await Promise.all(app.roots.map((root) => walkRoot(root))))
+    .flat()
+    .filter((file) => !matchesPatterns(file.path, app.hide));
+  return files.sort((a, b) => a.path.localeCompare(b.path));
+}
+
 function rootForArtifactPath(
   app: LoadedLocalArtifactApp,
   artifactPath: string,
@@ -758,6 +799,30 @@ export async function readLocalArtifactFile(
   }
 }
 
+export async function readConfiguredLocalArtifactFile(
+  options: LocalArtifactOptions & { path: string },
+): Promise<LocalArtifactFile | null> {
+  const app = await getLocalArtifactApp(options);
+  const { root, safePath, absolutePath } = await resolveArtifactPath(
+    app,
+    options.path,
+  );
+  try {
+    const { content, stat } = readTextFileWithoutSymlink(root, absolutePath);
+    const meta = await fileMetaForPath(
+      root,
+      safePath,
+      absolutePath,
+      content,
+      stat,
+    );
+    return { ...meta, content };
+  } catch (error) {
+    if (errorCode(error) === "ENOENT") return null;
+    throw error;
+  }
+}
+
 export async function writeLocalArtifactFile(
   options: WriteLocalArtifactFileOptions & { path: string },
 ): Promise<LocalArtifactFileMeta> {

package/corpus/core/src/vite/client.ts

@@ -1969,6 +1969,7 @@ function ssrStubPlugin(packages: string[]): Plugin | null {
     "FitAddon",
     "Fragment",
     "Image",
+    "InputRule",
     "Link",
     "Map",
     "Markdown",
@@ -2022,6 +2023,7 @@ function ssrStubPlugin(packages: string[]): Plugin | null {
     "useEditor",
     "useLocalRuntime",
     "useMessagePartReasoning",
+    "useMessagePartRuntime",
     "useMessagePartText",
     "useMessageRuntime",
     "useThread",

package/corpus/templates/assets/app/components/library/GenerationPresetsPanel.tsx

@@ -0,0 +1,325 @@
+import { useActionMutation, useT } from "@agent-native/core/client";
+import {
+  ASPECT_RATIOS,
+  IMAGE_CATEGORIES,
+  type AspectRatio,
+  type ImageCategory,
+} from "@shared/api";
+import { IconTrash } from "@tabler/icons-react";
+import { useState } from "react";
+import { Link } from "react-router";
+import { toast } from "sonner";
+
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from "@/components/ui/alert-dialog";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import { Checkbox } from "@/components/ui/checkbox";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select";
+import { Textarea } from "@/components/ui/textarea";
+
+export function GenerationPresetsPanel({
+  libraryId,
+  presets,
+}: {
+  libraryId: string;
+  presets: any[];
+}) {
+  const t = useT();
+  const createPreset = useActionMutation("create-generation-preset");
+  const deletePreset = useActionMutation("delete-generation-preset");
+  const [open, setOpen] = useState(false);
+  const [confirmPresetId, setConfirmPresetId] = useState<string | null>(null);
+  const [title, setTitle] = useState("");
+  const [category, setCategory] = useState<ImageCategory>("social");
+  const [aspectRatio, setAspectRatio] = useState<AspectRatio>("1:1");
+  const [promptTemplate, setPromptTemplate] = useState("");
+  const [textPolicy, setTextPolicy] = useState(t("library.defaultTextPolicy"));
+  const [includeLogo, setIncludeLogo] = useState(false);
+
+  function reset() {
+    setTitle("");
+    setCategory("social");
+    setAspectRatio("1:1");
+    setPromptTemplate("");
+    setTextPolicy(t("library.defaultTextPolicy"));
+    setIncludeLogo(false);
+  }
+
+  function submit() {
+    const trimmed = title.trim();
+    if (!trimmed) return;
+    createPreset.mutate(
+      {
+        libraryId,
+        title: trimmed,
+        category,
+        aspectRatio,
+        imageSize: "2K",
+        promptTemplate: promptTemplate.trim() || undefined,
+        textPolicy,
+        referencePolicy: "auto",
+        includeLogo,
+      },
+      {
+        onSuccess: () => {
+          toast.success(t("brandKitDetail.generationPresetCreated"));
+          reset();
+          setOpen(false);
+        },
+        onError: (error: Error) => {
+          toast.error(
+            error.message || t("brandKitDetail.couldNotCreatePreset"),
+          );
+        },
+      },
+    );
+  }
+
+  return (
+    <div className="rounded-lg border border-border p-4">
+      <div className="flex items-center justify-between gap-3">
+        <div>
+          <h3 className="text-sm font-semibold">
+            {t("brandKitDetail.generationPresets")}
+          </h3>
+          <p className="mt-1 text-sm text-muted-foreground">
+            {t("brandKitDetail.generationPresetsDescription")}
+          </p>
+        </div>
+        <Button variant="outline" size="sm" onClick={() => setOpen(true)}>
+          {t("brandKitDetail.new")}
+        </Button>
+      </div>
+      <div className="mt-3 space-y-2">
+        {presets.map((preset) => (
+          <div
+            key={preset.id}
+            className="flex items-start justify-between gap-3 rounded-md border border-border bg-background p-3"
+          >
+            <div className="min-w-0">
+              <div className="flex flex-wrap items-center gap-2">
+                <Link
+                  to={`/brand-kits/${libraryId}/presets/${preset.id}`}
+                  className="truncate text-sm font-medium underline-offset-4 hover:underline"
+                >
+                  {preset.title}
+                </Link>
+                <Badge variant="outline">{preset.aspectRatio}</Badge>
+                {preset.includeLogo ? (
+                  <Badge variant="secondary">{t("brandKitDetail.logo")}</Badge>
+                ) : null}
+              </div>
+              <p className="mt-1 line-clamp-2 text-xs text-muted-foreground">
+                {preset.textPolicy || preset.description || preset.category}
+              </p>
+            </div>
+            <div className="flex shrink-0 items-center gap-1">
+              <Button variant="ghost" size="sm" asChild>
+                <Link to={`/brand-kits/${libraryId}/presets/${preset.id}`}>
+                  {t("brandKitDetail.edit")}
+                </Link>
+              </Button>
+              <Button
+                variant="ghost"
+                size="icon"
+                className="h-8 w-8 text-muted-foreground hover:text-destructive"
+                aria-label={`${t("brandKitDetail.delete")} ${preset.title}`}
+                onClick={() => setConfirmPresetId(preset.id)}
+              >
+                <IconTrash className="h-4 w-4" />
+              </Button>
+            </div>
+          </div>
+        ))}
+        {!presets.length ? (
+          <p className="rounded-md border border-dashed border-border p-3 text-sm text-muted-foreground">
+            {t("brandKitDetail.noPresetsYet")}
+          </p>
+        ) : null}
+      </div>
+
+      <AlertDialog
+        open={confirmPresetId !== null}
+        onOpenChange={(isOpen) => {
+          if (!isOpen) setConfirmPresetId(null);
+        }}
+      >
+        <AlertDialogContent>
+          <AlertDialogHeader>
+            <AlertDialogTitle>
+              {t("brandKitDetail.deleteGenerationPreset")}
+            </AlertDialogTitle>
+            <AlertDialogDescription>
+              {t("brandKitDetail.deleteGenerationPresetDescription")}
+            </AlertDialogDescription>
+          </AlertDialogHeader>
+          <AlertDialogFooter>
+            <AlertDialogCancel>{t("brandKitDetail.cancel")}</AlertDialogCancel>
+            <AlertDialogAction
+              className="bg-destructive text-destructive-foreground hover:bg-destructive/90"
+              disabled={!confirmPresetId || deletePreset.isPending}
+              onClick={(event) => {
+                event.preventDefault();
+                if (!confirmPresetId) return;
+                deletePreset.mutate(
+                  { id: confirmPresetId },
+                  {
+                    onSuccess: () => {
+                      setConfirmPresetId(null);
+                      toast.success(
+                        t("brandKitDetail.generationPresetDeleted"),
+                      );
+                    },
+                    onError: (error: Error) => {
+                      toast.error(
+                        error.message ||
+                          t("brandKitDetail.couldNotDeletePreset"),
+                      );
+                    },
+                  },
+                );
+              }}
+            >
+              {t("assetDetail.delete")}
+            </AlertDialogAction>
+          </AlertDialogFooter>
+        </AlertDialogContent>
+      </AlertDialog>
+
+      <Dialog open={open} onOpenChange={setOpen}>
+        <DialogContent className="sm:max-w-lg">
+          <DialogHeader>
+            <DialogTitle>{t("brandKitDetail.newGenerationPreset")}</DialogTitle>
+            <DialogDescription>
+              {t("brandKitDetail.newGenerationPresetDescription")}
+            </DialogDescription>
+          </DialogHeader>
+          <div className="grid gap-4">
+            <div className="grid gap-2">
+              <Label htmlFor="preset-title">{t("brandKitDetail.name")}</Label>
+              <Input
+                id="preset-title"
+                value={title}
+                onChange={(event) => setTitle(event.target.value)}
+                placeholder={t("brandKitDetail.campaignLaunch")}
+              />
+            </div>
+            <div className="grid grid-cols-2 gap-3">
+              <div className="grid gap-2">
+                <Label>{t("brandKitDetail.category")}</Label>
+                <Select
+                  value={category}
+                  onValueChange={(value) => setCategory(value as ImageCategory)}
+                >
+                  <SelectTrigger>
+                    <SelectValue />
+                  </SelectTrigger>
+                  <SelectContent>
+                    {IMAGE_CATEGORIES.map((item) => (
+                      <SelectItem key={item} value={item}>
+                        {item}
+                      </SelectItem>
+                    ))}
+                  </SelectContent>
+                </Select>
+              </div>
+              <div className="grid gap-2">
+                <Label>{t("brandKitDetail.aspectRatio")}</Label>
+                <Select
+                  value={aspectRatio}
+                  onValueChange={(value) =>
+                    setAspectRatio(value as AspectRatio)
+                  }
+                >
+                  <SelectTrigger>
+                    <SelectValue />
+                  </SelectTrigger>
+                  <SelectContent>
+                    {ASPECT_RATIOS.map((ratio) => (
+                      <SelectItem key={ratio} value={ratio}>
+                        {ratio}
+                      </SelectItem>
+                    ))}
+                  </SelectContent>
+                </Select>
+              </div>
+            </div>
+            <div className="grid gap-2">
+              <Label htmlFor="preset-template">
+                {t("brandKitDetail.promptTemplate")}
+              </Label>
+              <Textarea
+                id="preset-template"
+                value={promptTemplate}
+                onChange={(event) => setPromptTemplate(event.target.value)}
+                placeholder={t("library.promptTemplatePlaceholder")}
+              />
+            </div>
+            <div className="grid gap-2">
+              <Label htmlFor="preset-text-policy">
+                {t("brandKitDetail.textPolicy")}
+              </Label>
+              <Textarea
+                id="preset-text-policy"
+                value={textPolicy}
+                onChange={(event) => setTextPolicy(event.target.value)}
+              />
+            </div>
+            <label
+              htmlFor="preset-include-logo"
+              className="flex items-start gap-3 rounded-md border border-border p-3"
+            >
+              <Checkbox
+                id="preset-include-logo"
+                checked={includeLogo}
+                onCheckedChange={(checked) => setIncludeLogo(checked === true)}
+                className="mt-0.5"
+              />
+              <span className="grid gap-1">
+                <span className="text-sm font-medium leading-none">
+                  {t("brandKitDetail.compositeCanonicalLogo")}
+                </span>
+                <span className="text-xs text-muted-foreground">
+                  {t("brandKitDetail.compositeCanonicalLogoHint")}
+                </span>
+              </span>
+            </label>
+          </div>
+          <DialogFooter>
+            <Button variant="outline" onClick={() => setOpen(false)}>
+              {t("brandKitDetail.cancel")}
+            </Button>
+            <Button disabled={!title.trim()} onClick={submit}>
+              {t("brandKitDetail.create")}
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
+    </div>
+  );
+}

package/corpus/templates/assets/app/hooks/use-navigation-state.ts

@@ -47,6 +47,15 @@ function navigationFromPath(pathname: string, search = "") {
       presetId: decodePathParam(preset[2]),
     };
   }
+  const brandKitSettings = pathname.match(/^\/brand-kits\/([^/]+)\/settings/);
+  if (brandKitSettings) {
+    return {
+      view: "library",
+      selection: decodePathParam(brandKitSettings[1]),
+      libraryId: decodePathParam(brandKitSettings[1]),
+      activeTab: "settings",
+    };
+  }
   // The "library" view is the unified Library workspace. Keep the internal
   // detail key stable for agent/MCP callers that already navigate by brand-kit
   // id, while the URL is now /library/:id.
@@ -115,6 +124,9 @@ function pathFromCommand(command: any): string | null {
   if (!command) return null;
   if (typeof command.path === "string") return command.path;
   if (command.view === "library" && command.libraryId) {
+    if (command.activeTab === "settings") {
+      return `/brand-kits/${encodeURIComponent(command.libraryId)}/settings`;
+    }
     const params = new URLSearchParams();
     if (typeof command.activeTab === "string") {
       params.set("tab", command.activeTab);

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

@@ -698,6 +698,27 @@ const messages = {
       "清除即時候選面板並刪除所有未儲存的候選行。",
     couldNotClearLiveCandidates: "無法清除即時候選項。",
     liveCandidatesActions: "即時候選項操作",
+    settingsTitle: "品牌套件設定",
+    unsavedChangesTitle: "未儲存的變更",
+    unsavedChangesDescription:
+      "此品牌套件有未儲存的變更。要放棄變更還是繼續編輯？",
+    discardChanges: "放棄變更",
+    keepEditing: "繼續編輯",
+    setupGuide: "設定指南",
+    setupGuideDescription:
+      "為了從此套件獲得最一致、最符合品牌調性的生成結果的建議。",
+    setupGuideReferences: "上傳參考素材",
+    setupGuideReferencesHint:
+      "將 3-5 個強而有力的範例標記為參考，讓分析品牌能從真實作品中學習調色板和視覺特徵，而非猜測。",
+    setupGuideStyleDescription: "撰寫具體的風格描述",
+    setupGuideStyleDescriptionHint:
+      "使用具體特徵（光線、構圖、質感）而非模糊的形容詞，讓每次生成都符合品牌調性。",
+    setupGuideInstructions: "使用自訂指令來設定硬性限制",
+    setupGuideInstructionsHint:
+      "將必須始終成立的事項（標誌位置、禁用顏色、法律文字）放在此處，讓代理永遠不會忘記。",
+    setupGuidePresets: "為每種常用格式建立一個預設",
+    setupGuidePresetsHint:
+      "將長寬比、模型和骨架/參考設定儲存為預設，讓每次都重複使用相同的輸出形式。",
   },
   brandKits: {
     title: "品牌套件",