- 模板填充引擎 template_fill.py:模板注册表 + schema 骨架 + 结构校验 + 行级安全填充; 模板自带 DATA 即 schema 来源。no.1 可转换填充(含 MANIFEST 更新时间刷新), no.2 暂为「只展示」(convertible=False) 原样输出已有数据 - 内置 agent template-json-builder(seed + SOUL),随 lifespan 注入,自动出现在 定时任务「执行智能体」下拉 - 调度器新增模板填充执行分支 _run_template_fill_attempt:源 JSON→大模型转换→ 结构校验→失败回喂重试;空源/只展示模板直接用模板默认数据,绝不失败 - API:GET /api/scheduled-tasks/html-templates - 前端:选中该 agent 后条件渲染「HTML模板」下拉 + .json 上传,只展示型模板隐藏 JSON 输入 - 文档同步(前后端 CLAUDE.md) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
325 lines
9.8 KiB
TypeScript
325 lines
9.8 KiB
TypeScript
import {
|
|
keepPreviousData,
|
|
useMutation,
|
|
useQuery,
|
|
useQueryClient,
|
|
} from "@tanstack/react-query";
|
|
|
|
import {
|
|
adminDeleteScheduledTask,
|
|
adminListScheduledTaskRuns,
|
|
adminTriggerScheduledTask,
|
|
adminUpdateScheduledTask,
|
|
createHtmlPageFavorite,
|
|
createScheduledTask,
|
|
deleteHtmlPageFavorite,
|
|
deleteScheduledTask,
|
|
deleteScheduledTaskRun,
|
|
getSchedulerThread,
|
|
listHtmlTemplates,
|
|
getScheduledTaskDeliveryProfile,
|
|
getScheduledTaskRun,
|
|
getScheduledTaskRunHtml,
|
|
getScheduledTaskRunMessages,
|
|
listAllScheduledTasks,
|
|
listHtmlPageFavorites,
|
|
listPublishedScheduledTasks,
|
|
listScheduledTaskRuns,
|
|
listScheduledTasks,
|
|
pauseScheduledTask,
|
|
publishScheduledTask,
|
|
resumeScheduledTask,
|
|
subscribeScheduledTask,
|
|
triggerScheduledTask,
|
|
unpublishScheduledTask,
|
|
unsubscribeScheduledTask,
|
|
updateScheduledTaskDeliveryProfile,
|
|
updateScheduledTask,
|
|
updateScheduledTaskSubscription,
|
|
} from "./api";
|
|
|
|
export function useSchedulerThread() {
|
|
return useQuery({
|
|
queryKey: ["scheduled-tasks", "thread"],
|
|
queryFn: getSchedulerThread,
|
|
refetchOnWindowFocus: false,
|
|
});
|
|
}
|
|
|
|
/** 可选的 HTML 模板清单(模板数据转换器填充用)。模板是后端静态注册,长缓存即可。 */
|
|
export function useHtmlTemplates(enabled = true) {
|
|
return useQuery({
|
|
queryKey: ["scheduled-tasks", "html-templates"],
|
|
queryFn: listHtmlTemplates,
|
|
enabled,
|
|
staleTime: 5 * 60_000,
|
|
refetchOnWindowFocus: false,
|
|
});
|
|
}
|
|
|
|
/** A task is currently executing — used to drive live polling of the task list. */
|
|
function taskIsLive(status?: string | null): boolean {
|
|
return status === "running" || status === "pending";
|
|
}
|
|
|
|
export function useScheduledTasks(
|
|
params: { search?: string; tagIds?: string[] } = {},
|
|
) {
|
|
const search = params.search ?? "";
|
|
const tagIds = params.tagIds ?? [];
|
|
return useQuery({
|
|
queryKey: ["scheduled-tasks", "list", search, [...tagIds].sort()],
|
|
queryFn: () => listScheduledTasks({ search, tagIds }),
|
|
refetchOnWindowFocus: false,
|
|
placeholderData: keepPreviousData,
|
|
// Poll the list while any task is currently executing so its last_status
|
|
// and last_run_at refresh without a manual reload.
|
|
refetchInterval: (query) =>
|
|
(query.state.data ?? []).some((task) => taskIsLive(task.last_status))
|
|
? 5000
|
|
: false,
|
|
});
|
|
}
|
|
|
|
export function useScheduledTaskRuns(taskId?: string | null) {
|
|
return useQuery({
|
|
queryKey: ["scheduled-tasks", taskId, "runs"],
|
|
queryFn: () => listScheduledTaskRuns(taskId!),
|
|
enabled: !!taskId,
|
|
refetchOnWindowFocus: false,
|
|
// Poll the run list while any run is in flight so the user can watch
|
|
// status transitions (pending → running → succeeded/failed) without
|
|
// refreshing the page.
|
|
refetchInterval: (query) =>
|
|
(query.state.data ?? []).some((run) => runIsLive(run.status))
|
|
? 4000
|
|
: false,
|
|
});
|
|
}
|
|
|
|
/** A run still in flight — used to drive live polling of the run/messages. */
|
|
function runIsLive(status?: string | null): boolean {
|
|
return status === "running" || status === "pending";
|
|
}
|
|
|
|
export function useScheduledTaskRun(runId?: string | null) {
|
|
return useQuery({
|
|
queryKey: ["scheduled-tasks", "runs", runId],
|
|
queryFn: () => getScheduledTaskRun(runId!),
|
|
enabled: !!runId,
|
|
refetchOnWindowFocus: false,
|
|
// Keep refreshing while the run is still executing so the detail page
|
|
// reflects status / result changes without a manual reload.
|
|
refetchInterval: (query) => (runIsLive(query.state.data?.status) ? 5000 : false),
|
|
});
|
|
}
|
|
|
|
/** Agent messages for a run; polls every 4s while the run is still executing. */
|
|
export function useScheduledTaskRunMessages(
|
|
runId?: string | null,
|
|
options: { live?: boolean } = {},
|
|
) {
|
|
return useQuery({
|
|
queryKey: ["scheduled-tasks", "runs", runId, "messages"],
|
|
queryFn: () => getScheduledTaskRunMessages(runId!),
|
|
enabled: !!runId,
|
|
refetchOnWindowFocus: false,
|
|
refetchInterval: options.live ? 4000 : false,
|
|
});
|
|
}
|
|
|
|
/** Generated HTML for an ``html_page`` run; polls while the run is in flight. */
|
|
export function useScheduledTaskRunHtml(
|
|
runId?: string | null,
|
|
options: { enabled?: boolean; live?: boolean } = {},
|
|
) {
|
|
return useQuery({
|
|
queryKey: ["scheduled-tasks", "runs", runId, "html"],
|
|
queryFn: () => getScheduledTaskRunHtml(runId!),
|
|
enabled: !!runId && (options.enabled ?? true),
|
|
refetchOnWindowFocus: false,
|
|
retry: false,
|
|
refetchInterval: options.live ? 5000 : false,
|
|
});
|
|
}
|
|
|
|
/** The current user's bookmarked HTML pages. */
|
|
export function useHtmlPageFavorites(enabled: boolean = true) {
|
|
return useQuery({
|
|
queryKey: ["html-page-favorites"],
|
|
queryFn: listHtmlPageFavorites,
|
|
enabled,
|
|
refetchOnWindowFocus: false,
|
|
});
|
|
}
|
|
|
|
/** Create / delete HTML page favorites. */
|
|
export function useHtmlPageFavoriteActions() {
|
|
const queryClient = useQueryClient();
|
|
const invalidate = () =>
|
|
queryClient.invalidateQueries({ queryKey: ["html-page-favorites"] });
|
|
return {
|
|
create: useMutation({ mutationFn: createHtmlPageFavorite, onSuccess: invalidate }),
|
|
remove: useMutation({ mutationFn: deleteHtmlPageFavorite, onSuccess: invalidate }),
|
|
};
|
|
}
|
|
|
|
export function useScheduledTaskDeliveryProfile() {
|
|
return useQuery({
|
|
queryKey: ["scheduled-tasks", "delivery-profile"],
|
|
queryFn: getScheduledTaskDeliveryProfile,
|
|
refetchOnWindowFocus: false,
|
|
});
|
|
}
|
|
|
|
/** Admin: every scheduled task across all users. */
|
|
export function useAllScheduledTasks(
|
|
params: { search?: string; enabled?: boolean } = {},
|
|
) {
|
|
const search = params.search ?? "";
|
|
return useQuery({
|
|
queryKey: ["scheduled-tasks", "admin", "list", search],
|
|
queryFn: () => listAllScheduledTasks(search),
|
|
enabled: params.enabled ?? true,
|
|
refetchOnWindowFocus: false,
|
|
placeholderData: keepPreviousData,
|
|
// Mirror the user list polling so the admin view also refreshes live.
|
|
refetchInterval: (query) =>
|
|
(query.state.data ?? []).some((task) => taskIsLive(task.last_status))
|
|
? 5000
|
|
: false,
|
|
});
|
|
}
|
|
|
|
/** Admin: runs for any task regardless of owner. */
|
|
export function useAdminScheduledTaskRuns(taskId?: string | null) {
|
|
return useQuery({
|
|
queryKey: ["scheduled-tasks", "admin", taskId, "runs"],
|
|
queryFn: () => adminListScheduledTaskRuns(taskId!),
|
|
enabled: !!taskId,
|
|
refetchOnWindowFocus: false,
|
|
// Poll while any run is still executing so admins see live progress.
|
|
refetchInterval: (query) =>
|
|
(query.state.data ?? []).some((run) => runIsLive(run.status))
|
|
? 4000
|
|
: false,
|
|
});
|
|
}
|
|
|
|
/** Admin mutations: edit / delete / trigger any task. */
|
|
export function useAdminScheduledTaskActions() {
|
|
const queryClient = useQueryClient();
|
|
const invalidate = () =>
|
|
queryClient.invalidateQueries({ queryKey: ["scheduled-tasks"] });
|
|
|
|
return {
|
|
update: useMutation({
|
|
mutationFn: ({
|
|
taskId,
|
|
data,
|
|
}: {
|
|
taskId: string;
|
|
data: Parameters<typeof adminUpdateScheduledTask>[1];
|
|
}) => adminUpdateScheduledTask(taskId, data),
|
|
onSuccess: invalidate,
|
|
}),
|
|
remove: useMutation({
|
|
mutationFn: adminDeleteScheduledTask,
|
|
onSuccess: invalidate,
|
|
}),
|
|
// The DELETE /runs/{id} route is admin-aware, so the same call deletes
|
|
// any user's run when the caller is an admin.
|
|
removeRun: useMutation({
|
|
mutationFn: deleteScheduledTaskRun,
|
|
onSuccess: invalidate,
|
|
}),
|
|
trigger: useMutation({
|
|
mutationFn: adminTriggerScheduledTask,
|
|
onSuccess: invalidate,
|
|
}),
|
|
};
|
|
}
|
|
|
|
export function usePublishedScheduledTasks(enabled: boolean = true) {
|
|
return useQuery({
|
|
queryKey: ["scheduled-tasks", "published"],
|
|
queryFn: () => listPublishedScheduledTasks({ limit: 100 }),
|
|
enabled,
|
|
refetchOnWindowFocus: false,
|
|
});
|
|
}
|
|
|
|
export function useScheduledTaskActions() {
|
|
const queryClient = useQueryClient();
|
|
const invalidate = () =>
|
|
queryClient.invalidateQueries({ queryKey: ["scheduled-tasks"] });
|
|
const invalidateRuns = () =>
|
|
queryClient.invalidateQueries({ queryKey: ["scheduled-tasks"] });
|
|
|
|
return {
|
|
update: useMutation({
|
|
mutationFn: ({
|
|
taskId,
|
|
data,
|
|
}: {
|
|
taskId: string;
|
|
data: Parameters<typeof updateScheduledTask>[1];
|
|
}) => updateScheduledTask(taskId, data),
|
|
onSuccess: invalidate,
|
|
}),
|
|
create: useMutation({
|
|
mutationFn: createScheduledTask,
|
|
onSuccess: invalidate,
|
|
}),
|
|
remove: useMutation({
|
|
mutationFn: deleteScheduledTask,
|
|
onSuccess: invalidate,
|
|
}),
|
|
removeRun: useMutation({
|
|
mutationFn: deleteScheduledTaskRun,
|
|
onSuccess: invalidate,
|
|
}),
|
|
pause: useMutation({
|
|
mutationFn: pauseScheduledTask,
|
|
onSuccess: invalidate,
|
|
}),
|
|
resume: useMutation({
|
|
mutationFn: resumeScheduledTask,
|
|
onSuccess: invalidate,
|
|
}),
|
|
trigger: useMutation({
|
|
mutationFn: triggerScheduledTask,
|
|
onSuccess: invalidateRuns,
|
|
}),
|
|
updateDeliveryProfile: useMutation({
|
|
mutationFn: updateScheduledTaskDeliveryProfile,
|
|
onSuccess: () =>
|
|
queryClient.invalidateQueries({
|
|
queryKey: ["scheduled-tasks", "delivery-profile"],
|
|
}),
|
|
}),
|
|
publish: useMutation({
|
|
mutationFn: publishScheduledTask,
|
|
onSuccess: invalidate,
|
|
}),
|
|
unpublish: useMutation({
|
|
mutationFn: unpublishScheduledTask,
|
|
onSuccess: invalidate,
|
|
}),
|
|
subscribe: useMutation({
|
|
mutationFn: ({ taskId, notifyElement }: { taskId: string; notifyElement: boolean }) =>
|
|
subscribeScheduledTask(taskId, notifyElement),
|
|
onSuccess: invalidate,
|
|
}),
|
|
updateSubscription: useMutation({
|
|
mutationFn: ({ taskId, notifyElement }: { taskId: string; notifyElement: boolean }) =>
|
|
updateScheduledTaskSubscription(taskId, notifyElement),
|
|
onSuccess: invalidate,
|
|
}),
|
|
unsubscribe: useMutation({
|
|
mutationFn: unsubscribeScheduledTask,
|
|
onSuccess: invalidate,
|
|
}),
|
|
};
|
|
}
|