Files
ai-agent/web/app/dashboard/skill-definition/_components/edit.tsx
T

397 lines
11 KiB
TypeScript
Raw Normal View History

2026-04-09 10:01:23 +08:00
"use client";
import { zodResolver } from "@hookform/resolvers/zod";
import { useEffect, useMemo, useState } from "react";
import { Controller, type Resolver, useForm } from "react-hook-form";
2026-04-09 10:01:23 +08:00
import { z } from "zod/v4";
import { ContentEditor } from "@/components/content-editor";
import { OptionCombobox } from "@/components/option-combobox";
2026-04-09 10:01:23 +08:00
import { ProjectDialog } from "@/components/project-dialog";
import { Button } from "@/components/ui/button";
import {
Field,
FieldContent,
FieldError,
FieldLabel,
} from "@/components/ui/field";
import { Input } from "@/components/ui/input";
import { Textarea } from "@/components/ui/textarea";
import {
fetchMCPCatalog,
2026-04-09 10:01:23 +08:00
fetchSkillDefinition,
type CreateSkillDefinitionPayload,
type MCPToolCatalogItem,
2026-04-09 10:01:23 +08:00
type SkillDefinition,
} from "@/lib/api/admin";
2026-05-25 12:06:15 +08:00
import { useI18n } from "@/i18n/provider";
2026-04-09 10:01:23 +08:00
2026-05-25 12:06:15 +08:00
type TFunction = (key: string, values?: Record<string, string | number>) => string;
2026-04-09 10:01:23 +08:00
type SkillEditDialogProps = {
open: boolean;
saving: boolean;
itemId: number | null;
onOpenChange: (open: boolean) => void;
onSubmit: (payload: CreateSkillDefinitionPayload) => Promise<void>;
};
const emptyForm: EditForm = {
name: "",
description: "",
instruction: "",
examplesText: "",
2026-04-09 10:01:23 +08:00
remark: "",
};
2026-05-25 12:06:15 +08:00
function createSkillFormSchema(t: TFunction) {
return z.object({
name: z.string().trim().min(1, t("skillDefinition.nameRequired")),
description: z.string().trim(),
instruction: z.string().trim().min(1, t("skillDefinition.instructionRequired")),
examplesText: z.string().trim(),
remark: z.string().trim(),
2026-05-25 12:06:15 +08:00
});
}
2026-04-09 10:01:23 +08:00
2026-05-25 12:06:15 +08:00
type EditForm = {
name: string;
description: string;
instruction: string;
examplesText: string;
remark: string;
};
2026-04-09 10:01:23 +08:00
function buildForm(item: SkillDefinition | null): EditForm {
if (!item) {
return emptyForm;
}
return {
name: item.name,
description: item.description ?? "",
instruction: item.instruction ?? "",
examplesText: (item.examples ?? []).join("\n"),
2026-04-09 10:01:23 +08:00
remark: item.remark ?? "",
};
}
function buildPayload(
form: EditForm,
toolWhitelist: string[],
): CreateSkillDefinitionPayload {
2026-04-09 10:01:23 +08:00
return {
name: form.name.trim(),
description: form.description.trim(),
instruction: form.instruction.trim(),
examples: form.examplesText
.split("\n")
.map((item) => item.trim())
.filter(Boolean),
toolWhitelist,
2026-04-09 10:01:23 +08:00
remark: form.remark.trim(),
};
}
export function EditDialog({
open,
saving,
itemId,
onOpenChange,
onSubmit,
}: SkillEditDialogProps) {
if (!open) {
return null;
}
return (
<SkillEditDialogBody
key={itemId ? `edit-${itemId}` : "create"}
open={open}
saving={saving}
itemId={itemId}
onOpenChange={onOpenChange}
onSubmit={onSubmit}
/>
);
}
type SkillEditDialogBodyProps = SkillEditDialogProps;
function SkillEditDialogBody({
open,
saving,
itemId,
onOpenChange,
onSubmit,
}: SkillEditDialogBodyProps) {
2026-05-25 12:06:15 +08:00
const t = useI18n();
2026-04-09 10:01:23 +08:00
const formId = "skill-definition-edit-form";
const [loading, setLoading] = useState(false);
const [toolCatalog, setToolCatalog] = useState<MCPToolCatalogItem[]>([]);
const [selectedToolWhitelist, setSelectedToolWhitelist] = useState<
string[]
>([]);
const [toolCodeToAdd, setToolCodeToAdd] = useState("");
2026-05-25 12:06:15 +08:00
const skillFormSchema = useMemo(() => createSkillFormSchema(t), [t]);
const editFormResolver = useMemo(
() => zodResolver(skillFormSchema) as Resolver<EditForm>,
[skillFormSchema],
);
const form = useForm<EditForm>({
2026-04-09 10:01:23 +08:00
resolver: editFormResolver,
defaultValues: emptyForm,
});
const {
handleSubmit,
reset,
register,
control,
2026-04-09 10:01:23 +08:00
formState: { errors },
} = form;
useEffect(() => {
async function loadDetail() {
if (!itemId) {
reset(emptyForm);
setSelectedToolWhitelist([]);
setToolCodeToAdd("");
2026-04-09 10:01:23 +08:00
return;
}
setLoading(true);
try {
const data = await fetchSkillDefinition(itemId);
reset(buildForm(data));
setSelectedToolWhitelist(data.toolWhitelist ?? []);
setToolCodeToAdd("");
2026-04-09 10:01:23 +08:00
} catch (error) {
console.error("Failed to load skill definition:", error);
} finally {
setLoading(false);
}
}
void loadDetail();
}, [itemId, reset]);
useEffect(() => {
async function loadToolCatalog() {
try {
const data = await fetchMCPCatalog();
setToolCatalog(data);
} catch (error) {
console.error("Failed to load MCP tool catalog:", error);
}
}
void loadToolCatalog();
}, []);
2026-04-09 10:01:23 +08:00
async function onFormSubmit(values: EditForm) {
await onSubmit(buildPayload(values, selectedToolWhitelist));
}
const toolOptions = useMemo(
() =>
toolCatalog.map((item) => ({
value: item.toolCode,
label: `${item.title || item.toolName} · ${item.toolCode}`,
})),
[toolCatalog],
);
const addableToolOptions = useMemo(
() =>
toolOptions.filter(
(option) => !selectedToolWhitelist.includes(option.value),
),
[selectedToolWhitelist, toolOptions],
);
const selectedToolOptions = useMemo(
() =>
selectedToolWhitelist
.map((toolCode) => toolOptions.find((option) => option.value === toolCode))
.filter(
(option): option is { value: string; label: string } => !!option,
),
[selectedToolWhitelist, toolOptions],
);
function handleAddToolWhitelist(toolCode: string) {
if (!toolCode || selectedToolWhitelist.includes(toolCode)) {
return;
}
setSelectedToolWhitelist((prev) => [...prev, toolCode]);
setToolCodeToAdd("");
}
function handleRemoveToolWhitelist(toolCode: string) {
setSelectedToolWhitelist((prev) =>
prev.filter((item) => item !== toolCode),
);
2026-04-09 10:01:23 +08:00
}
return (
<ProjectDialog
open={open}
onOpenChange={onOpenChange}
2026-05-25 12:06:15 +08:00
title={itemId ? t("skillDefinition.editTitle") : t("skillDefinition.createTitle")}
2026-04-09 10:01:23 +08:00
size="xl"
allowFullscreen
footer={
<>
<Button
type="button"
variant="outline"
onClick={() => onOpenChange(false)}
disabled={saving}
>
2026-05-25 12:06:15 +08:00
{t("skillDefinition.cancel")}
2026-04-09 10:01:23 +08:00
</Button>
<Button type="submit" form={formId} disabled={saving || loading}>
2026-05-25 12:06:15 +08:00
{saving ? t("skillDefinition.saving") : itemId ? t("skillDefinition.save") : t("skillDefinition.create")}
2026-04-09 10:01:23 +08:00
</Button>
</>
}
>
{loading ? (
<div className="flex items-center justify-center py-12">
2026-05-25 12:06:15 +08:00
<div className="text-muted-foreground">{t("skillDefinition.loading")}</div>
2026-04-09 10:01:23 +08:00
</div>
) : (
<form
id={formId}
onSubmit={handleSubmit(onFormSubmit)}
className="space-y-4"
>
<Field data-invalid={!!errors.name}>
<FieldLabel htmlFor="skill-name">{t("skillDefinition.name")}</FieldLabel>
<FieldContent>
<Input
id="skill-name"
placeholder={t("skillDefinition.namePlaceholder")}
aria-invalid={!!errors.name}
{...register("name")}
/>
<FieldError errors={[errors.name]} />
</FieldContent>
</Field>
2026-04-09 10:01:23 +08:00
<Field data-invalid={!!errors.description}>
2026-05-25 12:06:15 +08:00
<FieldLabel htmlFor="skill-description">{t("skillDefinition.description")}</FieldLabel>
2026-04-09 10:01:23 +08:00
<FieldContent>
<Textarea
id="skill-description"
rows={3}
2026-05-25 12:06:15 +08:00
placeholder={t("skillDefinition.descriptionPlaceholder")}
2026-04-09 10:01:23 +08:00
aria-invalid={!!errors.description}
{...register("description")}
/>
<FieldError errors={[errors.description]} />
</FieldContent>
</Field>
<Field data-invalid={!!errors.instruction}>
<FieldLabel>{t("skillDefinition.instruction")}</FieldLabel>
2026-04-09 10:01:23 +08:00
<FieldContent>
<Controller
control={control}
name="instruction"
render={({ field }) => (
<ContentEditor
value={{ mode: "markdown", raw: field.value ?? "" }}
onChange={(next) => field.onChange(next.raw)}
placeholder={t("skillDefinition.instructionPlaceholder")}
disabled={saving || loading}
allowedModes={["markdown"]}
height={360}
/>
)}
2026-04-09 10:01:23 +08:00
/>
<FieldError errors={[errors.instruction]} />
</FieldContent>
</Field>
<Field data-invalid={!!errors.examplesText}>
2026-05-25 12:06:15 +08:00
<FieldLabel htmlFor="skill-examples">{t("skillDefinition.examples")}</FieldLabel>
<FieldContent>
<Textarea
id="skill-examples"
rows={5}
2026-05-25 12:06:15 +08:00
placeholder={t("skillDefinition.examplesPlaceholder")}
aria-invalid={!!errors.examplesText}
{...register("examplesText")}
/>
<FieldError errors={[errors.examplesText]} />
</FieldContent>
</Field>
<Field>
2026-05-25 12:06:15 +08:00
<FieldLabel>{t("skillDefinition.toolWhitelist")}</FieldLabel>
<FieldContent className="space-y-3">
<div className="flex items-center gap-2">
<div className="flex-1">
<OptionCombobox
value={toolCodeToAdd}
options={addableToolOptions}
2026-05-25 12:06:15 +08:00
placeholder={t("skillDefinition.selectTool")}
searchPlaceholder={t("skillDefinition.searchTool")}
emptyText={t("skillDefinition.emptyTool")}
onChange={handleAddToolWhitelist}
/>
</div>
<Button
type="button"
variant="outline"
disabled={!toolCodeToAdd}
onClick={() => handleAddToolWhitelist(toolCodeToAdd)}
>
2026-05-25 12:06:15 +08:00
{t("skillDefinition.add")}
</Button>
</div>
<div className="flex flex-wrap gap-2">
{selectedToolOptions.length === 0 ? (
<span className="text-sm text-muted-foreground">
2026-05-25 12:06:15 +08:00
{t("skillDefinition.inheritAgentTools")}
</span>
) : (
selectedToolOptions.map((option) => (
<Button
key={option.value}
type="button"
variant="outline"
size="sm"
onClick={() => handleRemoveToolWhitelist(option.value)}
className="justify-start"
>
{option.label}
</Button>
))
)}
</div>
2026-04-09 10:01:23 +08:00
</FieldContent>
</Field>
<Field data-invalid={!!errors.remark}>
2026-05-25 12:06:15 +08:00
<FieldLabel htmlFor="skill-remark">{t("skillDefinition.remark")}</FieldLabel>
2026-04-09 10:01:23 +08:00
<FieldContent>
<Textarea
id="skill-remark"
rows={3}
2026-05-25 12:06:15 +08:00
placeholder={t("skillDefinition.remarkPlaceholder")}
2026-04-09 10:01:23 +08:00
aria-invalid={!!errors.remark}
{...register("remark")}
/>
<FieldError errors={[errors.remark]} />
</FieldContent>
</Field>
</form>
)}
</ProjectDialog>
);
}