@elizaos/agent 2.0.0-alpha.358 → 2.0.0-alpha.376

package/packages/app-core/src/components/pages/database-utils.js

@@ -0,0 +1,133 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Badge, Button } from "@elizaos/ui";
+import { useEffect, useRef } from "react";
+import { useApp } from "../../state";
+/** Format a cell value for display. */
+export function formatCell(val) {
+    if (val === null || val === undefined)
+        return "NULL";
+    if (typeof val === "boolean")
+        return val ? "true" : "false";
+    if (typeof val === "object") {
+        try {
+            return JSON.stringify(val);
+        }
+        catch {
+            return String(val);
+        }
+    }
+    return String(val);
+}
+/** Abbreviated type label for column badges. */
+export function typeLabel(type) {
+    const t = type.toLowerCase();
+    if (t.includes("int"))
+        return "int";
+    if (t.includes("serial"))
+        return "serial";
+    if (t.includes("bool"))
+        return "bool";
+    if (t.includes("float") ||
+        t.includes("double") ||
+        t.includes("numeric") ||
+        t.includes("real"))
+        return "float";
+    if (t.includes("json"))
+        return "json";
+    if (t.includes("uuid"))
+        return "uuid";
+    if (t.includes("timestamp"))
+        return "time";
+    if (t.includes("date"))
+        return "date";
+    if (t.includes("text") || t.includes("char") || t.includes("varchar"))
+        return "text";
+    if (t.includes("vector"))
+        return "vector";
+    if (t.includes("bytea"))
+        return "bytes";
+    return type.slice(0, 6);
+}
+/** Color for column type badge. */
+export function typeBadgeColor(type) {
+    const t = type.toLowerCase();
+    if (t.includes("int") ||
+        t.includes("serial") ||
+        t.includes("float") ||
+        t.includes("numeric") ||
+        t.includes("real") ||
+        t.includes("double"))
+        return "text-accent-fg bg-accent/12";
+    if (t.includes("bool"))
+        return "text-ok bg-ok/10";
+    if (t.includes("json"))
+        return "text-warn bg-warn/10";
+    if (t.includes("uuid"))
+        return "text-accent bg-accent/10";
+    if (t.includes("timestamp") || t.includes("date"))
+        return "text-danger bg-danger/10";
+    if (t.includes("text") || t.includes("char"))
+        return "text-muted-strong bg-bg-hover";
+    if (t.includes("vector"))
+        return "text-accent bg-accent/12";
+    return "text-muted-strong bg-bg-hover";
+}
+// ── Shared display components ─────────────────────────────────────────
+export function CellPopover({ value, onClose, }) {
+    const { t } = useApp();
+    const ref = useRef(null);
+    useEffect(() => {
+        const handler = (e) => {
+            if (ref.current && !ref.current.contains(e.target))
+                onClose();
+        };
+        document.addEventListener("mousedown", handler);
+        return () => document.removeEventListener("mousedown", handler);
+    }, [onClose]);
+    return (_jsxs("div", { ref: ref, className: "fixed z-50 bg-card/60 backdrop-blur-md border border-border/40 shadow-[0_8px_30px_rgba(var(--accent-rgb),0.15)] rounded-xl p-4 max-w-[500px] max-h-[300px] overflow-auto", style: { top: "50%", left: "50%", transform: "translate(-50%, -50%)" }, children: [_jsxs("div", { className: "flex items-center justify-between mb-3 pb-2", children: [_jsx("span", { className: "text-xs text-muted uppercase font-bold tracking-wider", children: t("databaseview.CellValue") }), _jsx(Button, { variant: "ghost", size: "icon", className: "w-6 h-6 rounded-full transition-[background-color,color,box-shadow] hover:bg-bg-hover hover:text-txt hover:shadow-[0_0_10px_rgba(var(--accent-rgb),0.2)]", onClick: onClose, children: "\u00D7" })] }), _jsx("pre", { className: "text-xs text-txt font-mono whitespace-pre-wrap break-all m-0 bg-bg/40 p-3 rounded-lg border border-border/40", children: value })] }));
+}
+export function ResultsGrid({ columns, rows, columnMeta, sortCol, sortDir, onSort, onCellClick, }) {
+    const { t } = useApp();
+    return (_jsx("div", { className: "overflow-auto border border-border/40 bg-card/40 backdrop-blur-md rounded-2xl shadow-inner", style: { maxHeight: "calc(100vh - 340px)" }, children: _jsxs("table", { className: "w-full border-collapse text-xs font-mono", children: [_jsx("thead", { className: "sticky top-0 z-10 backdrop-blur-xl bg-bg/80 border-b border-border/40 shadow-sm", children: _jsxs("tr", { children: [_jsx("th", { className: "w-[50px] min-w-[50px] px-3 py-2.5 text-2xs text-muted font-medium text-right border-r border-border/40", children: "#" }), columns.map((col) => {
+                                const meta = columnMeta?.get(col);
+                                const isSorted = sortCol === col;
+                                return (_jsx("th", { className: "px-4 py-2.5 text-left border-r border-border/40 whitespace-nowrap cursor-pointer select-none hover:bg-bg-hover transition-colors group", onClick: () => onSort?.(col), children: _jsxs("div", { className: "flex items-center gap-2", children: [_jsx("span", { className: "text-xs-tight text-txt font-semibold group-hover:text-txt transition-colors", children: col }), meta && (_jsx(Badge, { variant: "outline", className: `text-3xs px-1.5 py-0 border-none font-medium ${typeBadgeColor(meta.type)}`, children: typeLabel(meta.type) })), meta?.isPrimaryKey && (_jsx(Badge, { variant: "outline", className: "border-none bg-accent/16 px-1.5 py-0 text-3xs font-bold text-accent-fg shadow-sm", children: "PK" })), isSorted && (_jsx("span", { className: "text-2xs text-accent", children: sortDir === "asc" ? "↑" : "↓" }))] }) }, col));
+                            })] }) }), _jsx("tbody", { children: rows.map((row, i) => (_jsxs("tr", { className: "border-b border-border/20 hover:bg-accent/10 transition-colors group", children: [_jsx("td", { className: "px-3 py-2 text-2xs text-muted text-right border-r border-border/30 bg-bg/20 tabular-nums group-hover:text-txt/70 transition-colors", children: i + 1 }), columns.map((col) => {
+                                const raw = row[col];
+                                const display = formatCell(raw);
+                                const isNull = raw === null || raw === undefined;
+                                const isExpandable = display.length > 40 && !!onCellClick;
+                                return (_jsx("td", { className: "px-4 py-2 border-r border-border/20 max-w-[280px] truncate cursor-default transition-colors", title: display, onClick: () => {
+                                        if (isExpandable)
+                                            onCellClick(display);
+                                    }, onKeyDown: (e) => {
+                                        if (!isExpandable)
+                                            return;
+                                        if (e.key === "Enter" || e.key === " ") {
+                                            e.preventDefault();
+                                            onCellClick(display);
+                                        }
+                                    }, role: isExpandable ? "button" : undefined, tabIndex: isExpandable ? 0 : undefined, children: isNull ? (_jsx("span", { className: "text-muted italic opacity-50", children: t("databaseview.NULL") })) : (_jsx("span", { className: "text-txt", children: display })) }, col));
+                            })] }, JSON.stringify(row)))) })] }) }));
+}
+export function PaginationBar({ total, offset, limit, onPrev, onNext, }) {
+    const { t } = useApp();
+    const start = offset + 1;
+    const end = Math.min(offset + limit, total);
+    const hasPrev = offset > 0;
+    const hasNext = offset + limit < total;
+    return (_jsxs("div", { className: "flex items-center justify-between px-4 py-2.5 bg-card/60 backdrop-blur-md rounded-b-2xl text-xs-tight text-muted", children: [_jsx("span", { className: "font-medium", children: t("databaseview.RowCountSummary", {
+                    count: total.toLocaleString(),
+                    rowLabel: total === 1
+                        ? t("databaseview.row")
+                        : t("common.rows", { defaultValue: "rows" }),
+                    range: total > 0
+                        ? t("databaseview.ShowingRange", {
+                            start,
+                            end,
+                            defaultValue: " · showing {{start}}-{{end}}",
+                        })
+                        : "",
+                    defaultValue: "{{count}} {{rowLabel}}{{range}}",
+                }) }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Button, { variant: "outline", size: "sm", className: "h-auto min-h-[1.75rem] whitespace-normal break-words rounded-lg border-border/50 bg-bg/50 py-1 text-left text-xs-tight backdrop-blur-sm transition-[border-color,color,box-shadow] hover:border-accent hover:text-txt hover:shadow-[0_0_10px_rgba(var(--accent-rgb),0.2)]", disabled: !hasPrev, onClick: onPrev, children: t("common.prev") }), _jsx(Button, { variant: "outline", size: "sm", className: "h-auto min-h-[1.75rem] whitespace-normal break-words rounded-lg border-border/50 bg-bg/50 py-1 text-left text-xs-tight backdrop-blur-sm transition-[border-color,color,box-shadow] hover:border-accent hover:text-txt hover:shadow-[0_0_10px_rgba(var(--accent-rgb),0.2)]", disabled: !hasNext, onClick: onNext, children: t("common.next") })] })] }));
+}

package/packages/app-core/src/components/pages/heartbeat-utils.d.ts

@@ -0,0 +1,105 @@
+/**
+ * heartbeat-utils.ts — Pure functions, types, and constants for the Heartbeats feature.
+ *
+ * Extracted from HeartbeatsView.tsx so tests and sibling components can
+ * import them directly instead of duplicating logic.
+ */
+import type { CreateTriggerRequest, TriggerSummary, TriggerType, TriggerWakeMode, UpdateTriggerRequest } from "../../api/client";
+export type TriggerKind = "text" | "workflow";
+import type { TranslateFn as AppTranslateFn } from "../../types";
+export type TranslateFn = AppTranslateFn;
+export declare const DURATION_UNITS: readonly [{
+    readonly unit: "seconds";
+    readonly ms: 1000;
+    readonly labelKey: "heartbeatsview.durationUnitSeconds";
+}, {
+    readonly unit: "minutes";
+    readonly ms: 60000;
+    readonly labelKey: "heartbeatsview.durationUnitMinutes";
+}, {
+    readonly unit: "hours";
+    readonly ms: 3600000;
+    readonly labelKey: "heartbeatsview.durationUnitHours";
+}, {
+    readonly unit: "days";
+    readonly ms: 86400000;
+    readonly labelKey: "heartbeatsview.durationUnitDays";
+}];
+export type DurationUnit = (typeof DURATION_UNITS)[number]["unit"];
+export declare function bestFitUnit(ms: number): {
+    value: number;
+    unit: DurationUnit;
+};
+export declare function durationToMs(value: number, unit: DurationUnit): number;
+export declare function durationUnitLabel(unit: DurationUnit, t: TranslateFn): string;
+export interface TriggerFormState {
+    displayName: string;
+    instructions: string;
+    kind: TriggerKind;
+    workflowId: string;
+    workflowName: string;
+    triggerType: TriggerType;
+    eventKind: string;
+    wakeMode: TriggerWakeMode;
+    scheduledAtIso: string;
+    cronExpression: string;
+    maxRuns: string;
+    enabled: boolean;
+    durationValue: string;
+    durationUnit: DurationUnit;
+}
+export declare const emptyForm: TriggerFormState;
+export interface HeartbeatTemplate {
+    id: string;
+    name: string;
+    instructions: string;
+    interval: string;
+    unit: DurationUnit;
+    nameKey?: string;
+    instructionsKey?: string;
+}
+export declare const TEMPLATES_STORAGE_KEY = "elizaos:heartbeat-templates";
+export declare const BUILT_IN_TEMPLATES: HeartbeatTemplate[];
+export declare function isValidTemplate(v: unknown): v is HeartbeatTemplate;
+export declare function loadUserTemplates(): HeartbeatTemplate[];
+export declare function saveUserTemplates(templates: HeartbeatTemplate[]): void;
+export declare function getTemplateName(template: HeartbeatTemplate, t: (key: string, options?: Record<string, unknown>) => string): string;
+export declare function getTemplateInstructions(template: HeartbeatTemplate, t: (key: string, options?: Record<string, unknown>) => string): string;
+export declare function railMonogram(label: string): string;
+export declare function parsePositiveInteger(value: string): number | undefined;
+export declare function scheduleLabel(trigger: TriggerSummary, t: TranslateFn, locale?: string): string;
+export declare function humanizeEventKind(value: string): string;
+export declare function formFromTrigger(trigger: TriggerSummary): TriggerFormState;
+export declare function buildCreateRequest(form: TriggerFormState): CreateTriggerRequest;
+export declare function buildUpdateRequest(form: TriggerFormState): UpdateTriggerRequest;
+/**
+ * Validate a 5-field cron expression using cron-parser.
+ * Returns `{ ok: true, message: null }` on success or
+ * `{ ok: false, message: string }` with the parser error message on failure.
+ */
+export declare function validateCronExpression(expr: string): {
+    ok: true;
+    message: null;
+} | {
+    ok: false;
+    message: string;
+};
+/**
+ * Compute the next N fire dates for an interval trigger (ms between fires).
+ * Returns an empty array when intervalMs is not positive.
+ */
+export declare function nextRunsForInterval(intervalMs: number, count: number, from?: Date): Date[];
+/**
+ * Compute the next N fire dates for a cron expression.
+ * Returns an empty array when parsing fails.
+ */
+export declare function nextRunsForCron(expr: string, count: number, from?: Date): Date[];
+/**
+ * Validates the kind-specific payload fields only (no schedule validation).
+ * Returns an error message when invalid, null when valid.
+ */
+export declare function validateTriggerKind(form: TriggerFormState, t: TranslateFn): string | null;
+export declare function validateForm(form: TriggerFormState, t: TranslateFn): string | null;
+export declare function toneForLastStatus(status?: string): "success" | "warning" | "danger" | "muted";
+export declare function localizedExecutionStatus(status: string, t: TranslateFn): string;
+//# sourceMappingURL=heartbeat-utils.d.ts.map

package/packages/app-core/src/components/pages/heartbeat-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-utils.d.ts","sourceRoot":"","sources":["../../../../../../../app-core/src/components/pages/heartbeat-utils.ts"],"names":[],"mappings":"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"}

package/packages/app-core/src/components/pages/heartbeat-utils.js

@@ -0,0 +1,368 @@
+/**
+ * heartbeat-utils.ts — Pure functions, types, and constants for the Heartbeats feature.
+ *
+ * Extracted from HeartbeatsView.tsx so tests and sibling components can
+ * import them directly instead of duplicating logic.
+ */
+import { CronExpressionParser } from "cron-parser";
+import { formatDurationMs } from "../../utils/format";
+// ── Duration units ─────────────────────────────────────────────────
+export const DURATION_UNITS = [
+    {
+        unit: "seconds",
+        ms: 1000,
+        labelKey: "heartbeatsview.durationUnitSeconds",
+    },
+    {
+        unit: "minutes",
+        ms: 60_000,
+        labelKey: "heartbeatsview.durationUnitMinutes",
+    },
+    {
+        unit: "hours",
+        ms: 3_600_000,
+        labelKey: "heartbeatsview.durationUnitHours",
+    },
+    {
+        unit: "days",
+        ms: 86_400_000,
+        labelKey: "heartbeatsview.durationUnitDays",
+    },
+];
+export function bestFitUnit(ms) {
+    for (let i = DURATION_UNITS.length - 1; i >= 0; i -= 1) {
+        const unit = DURATION_UNITS[i];
+        if (ms >= unit.ms && ms % unit.ms === 0) {
+            return { value: ms / unit.ms, unit: unit.unit };
+        }
+    }
+    return { value: ms / 1000, unit: "seconds" };
+}
+export function durationToMs(value, unit) {
+    const found = DURATION_UNITS.find((candidate) => candidate.unit === unit);
+    return value * (found?.ms ?? 1000);
+}
+export function durationUnitLabel(unit, t) {
+    const found = DURATION_UNITS.find((candidate) => candidate.unit === unit);
+    return found ? t(found.labelKey) : unit;
+}
+export const emptyForm = {
+    displayName: "",
+    instructions: "",
+    kind: "text",
+    workflowId: "",
+    workflowName: "",
+    triggerType: "interval",
+    eventKind: "message.received",
+    wakeMode: "inject_now",
+    scheduledAtIso: "",
+    cronExpression: "0 * * * *",
+    maxRuns: "",
+    enabled: true,
+    durationValue: "1",
+    durationUnit: "hours",
+};
+export const TEMPLATES_STORAGE_KEY = "elizaos:heartbeat-templates";
+export const BUILT_IN_TEMPLATES = [
+    {
+        id: "__builtin_crypto",
+        name: "Check crypto prices",
+        nameKey: "heartbeatsview.template.crypto.name",
+        instructions: "Check the current prices of BTC, ETH, and SOL. Summarize any significant moves in the last hour.",
+        instructionsKey: "heartbeatsview.template.crypto.instructions",
+        interval: "30",
+        unit: "minutes",
+    },
+    {
+        id: "__builtin_journal",
+        name: "Daily journal prompt",
+        nameKey: "heartbeatsview.template.journal.name",
+        instructions: "Write a brief, thoughtful journal prompt for the user based on current events or seasonal themes. Keep it under 2 sentences.",
+        instructionsKey: "heartbeatsview.template.journal.instructions",
+        interval: "24",
+        unit: "hours",
+    },
+    {
+        id: "__builtin_trending",
+        name: "Trending topics digest",
+        nameKey: "heartbeatsview.template.trending.name",
+        instructions: "Scan for trending topics on crypto Twitter and tech news. Give a 3-bullet summary of what's worth paying attention to.",
+        instructionsKey: "heartbeatsview.template.trending.instructions",
+        interval: "4",
+        unit: "hours",
+    },
+];
+export function isValidTemplate(v) {
+    if (typeof v !== "object" || v == null)
+        return false;
+    const t = v;
+    return (typeof t.id === "string" &&
+        typeof t.name === "string" &&
+        typeof t.instructions === "string" &&
+        typeof t.interval === "string" &&
+        typeof t.unit === "string");
+}
+export function loadUserTemplates() {
+    try {
+        const raw = localStorage.getItem(TEMPLATES_STORAGE_KEY);
+        if (!raw)
+            return [];
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed.filter(isValidTemplate);
+    }
+    catch {
+        return [];
+    }
+}
+export function saveUserTemplates(templates) {
+    try {
+        localStorage.setItem(TEMPLATES_STORAGE_KEY, JSON.stringify(templates));
+    }
+    catch {
+        // localStorage full or unavailable
+    }
+}
+export function getTemplateName(template, t) {
+    return template.nameKey
+        ? t(template.nameKey, { defaultValue: template.name })
+        : template.name;
+}
+export function getTemplateInstructions(template, t) {
+    return template.instructionsKey
+        ? t(template.instructionsKey, { defaultValue: template.instructions })
+        : template.instructions;
+}
+// ── Misc helpers ───────────────────────────────────────────────────
+export function railMonogram(label) {
+    const words = label.trim().split(/\s+/).filter(Boolean);
+    const initials = words
+        .slice(0, 2)
+        .map((word) => word[0]?.toUpperCase() ?? "")
+        .join("");
+    return (initials || label.slice(0, 1).toUpperCase() || "?").slice(0, 2);
+}
+export function parsePositiveInteger(value) {
+    const trimmed = value.trim();
+    if (!/^\d+$/.test(trimmed))
+        return undefined;
+    const parsed = Number.parseInt(trimmed, 10);
+    return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : undefined;
+}
+export function scheduleLabel(trigger, t, locale) {
+    if (trigger.triggerType === "interval") {
+        return `${t("heartbeatsview.every")} ${formatDurationMs(trigger.intervalMs, { t })}`;
+    }
+    if (trigger.triggerType === "once") {
+        return trigger.scheduledAtIso
+            ? t("heartbeatsview.onceAt", {
+                time: formatDateTime(trigger.scheduledAtIso, { locale }),
+            })
+            : t("heartbeatsview.once");
+    }
+    if (trigger.triggerType === "cron") {
+        return `${t("heartbeatsview.cronPrefix")} ${trigger.cronExpression ?? "\u2014"}`;
+    }
+    if (trigger.triggerType === "event") {
+        return `On ${humanizeEventKind(trigger.eventKind ?? "event")}`;
+    }
+    return trigger.triggerType;
+}
+export function humanizeEventKind(value) {
+    return value
+        .trim()
+        .replace(/[_-]+/g, ".")
+        .split(".")
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(" ");
+}
+export function formFromTrigger(trigger) {
+    const intervalMs = trigger.intervalMs ?? 3_600_000;
+    const { value, unit } = bestFitUnit(intervalMs);
+    return {
+        displayName: trigger.displayName,
+        instructions: trigger.instructions,
+        kind: trigger.kind ?? "text",
+        workflowId: trigger.workflowId ?? "",
+        workflowName: trigger.workflowName ?? "",
+        triggerType: trigger.triggerType,
+        eventKind: trigger.eventKind ?? "message.received",
+        wakeMode: trigger.wakeMode,
+        scheduledAtIso: trigger.scheduledAtIso ?? "",
+        cronExpression: trigger.cronExpression ?? "0 * * * *",
+        maxRuns: trigger.maxRuns ? String(trigger.maxRuns) : "",
+        enabled: trigger.enabled,
+        durationValue: String(value),
+        durationUnit: unit,
+    };
+}
+export function buildCreateRequest(form) {
+    const maxRuns = parsePositiveInteger(form.maxRuns);
+    return {
+        displayName: form.displayName.trim(),
+        instructions: form.kind === "text" ? form.instructions.trim() : undefined,
+        kind: form.kind,
+        workflowId: form.kind === "workflow" ? form.workflowId : undefined,
+        workflowName: form.kind === "workflow" ? form.workflowName || undefined : undefined,
+        triggerType: form.triggerType,
+        wakeMode: form.wakeMode,
+        enabled: form.enabled,
+        intervalMs: form.triggerType === "interval"
+            ? durationToMs(Number(form.durationValue) || 1, form.durationUnit)
+            : undefined,
+        scheduledAtIso: form.triggerType === "once" ? form.scheduledAtIso.trim() : undefined,
+        cronExpression: form.triggerType === "cron" ? form.cronExpression.trim() : undefined,
+        eventKind: form.triggerType === "event" ? form.eventKind.trim() : undefined,
+        maxRuns,
+    };
+}
+export function buildUpdateRequest(form) {
+    return { ...buildCreateRequest(form) };
+}
+// ── Cron validation ────────────────────────────────────────────────
+/**
+ * Validate a 5-field cron expression using cron-parser.
+ * Returns `{ ok: true, message: null }` on success or
+ * `{ ok: false, message: string }` with the parser error message on failure.
+ */
+export function validateCronExpression(expr) {
+    const trimmed = expr.trim();
+    if (!trimmed)
+        return { ok: false, message: "Expression is empty" };
+    try {
+        CronExpressionParser.parse(trimmed);
+        return { ok: true, message: null };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            message: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+// ── Schedule preview ───────────────────────────────────────────────
+/**
+ * Compute the next N fire dates for an interval trigger (ms between fires).
+ * Returns an empty array when intervalMs is not positive.
+ */
+export function nextRunsForInterval(intervalMs, count, from = new Date()) {
+    if (!Number.isFinite(intervalMs) || intervalMs <= 0)
+        return [];
+    const results = [];
+    for (let i = 1; i <= count; i++) {
+        results.push(new Date(from.getTime() + intervalMs * i));
+    }
+    return results;
+}
+/**
+ * Compute the next N fire dates for a cron expression.
+ * Returns an empty array when parsing fails.
+ */
+export function nextRunsForCron(expr, count, from = new Date()) {
+    const trimmed = expr.trim();
+    if (!trimmed)
+        return [];
+    try {
+        const schedule = CronExpressionParser.parse(trimmed, {
+            currentDate: from,
+        });
+        const results = [];
+        for (let i = 0; i < count; i++) {
+            results.push(schedule.next().toDate());
+        }
+        return results;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Validates the kind-specific payload fields only (no schedule validation).
+ * Returns an error message when invalid, null when valid.
+ */
+export function validateTriggerKind(form, t) {
+    if (form.kind === "workflow") {
+        if (!form.workflowId) {
+            return t("triggers.workflowPlaceholder");
+        }
+        return null;
+    }
+    // kind === "text"
+    if (!form.instructions.trim()) {
+        return t("heartbeatsview.validationInstructionsRequired");
+    }
+    return null;
+}
+export function validateForm(form, t) {
+    if (!form.displayName.trim()) {
+        return t("heartbeatsview.validationDisplayNameRequired");
+    }
+    const kindError = validateTriggerKind(form, t);
+    if (kindError)
+        return kindError;
+    if (form.triggerType === "interval") {
+        const value = Number(form.durationValue);
+        if (!Number.isFinite(value) || value <= 0) {
+            return t("heartbeatsview.validationIntervalPositive");
+        }
+    }
+    if (form.triggerType === "once") {
+        const raw = form.scheduledAtIso.trim();
+        if (!raw)
+            return t("heartbeatsview.validationScheduledTimeRequired");
+        if (!Number.isFinite(Date.parse(raw))) {
+            return t("heartbeatsview.validationScheduledTimeInvalid");
+        }
+    }
+    if (form.triggerType === "cron") {
+        const cronTrimmed = form.cronExpression.trim();
+        if (!cronTrimmed)
+            return t("heartbeatsview.validationCronRequired");
+        const cronResult = validateCronExpression(cronTrimmed);
+        if (!cronResult.ok) {
+            return `${t("triggers.cronError")} ${cronResult.message}`;
+        }
+    }
+    if (form.triggerType === "event" && !form.eventKind.trim()) {
+        return "Event is required.";
+    }
+    if (form.maxRuns.trim() && !parsePositiveInteger(form.maxRuns)) {
+        return t("heartbeatsview.validationMaxRunsPositive");
+    }
+    return null;
+}
+export function toneForLastStatus(status) {
+    if (!status)
+        return "muted";
+    if (status === "success" || status === "completed")
+        return "success";
+    if (status === "skipped" || status === "queued")
+        return "warning";
+    if (status === "error" || status === "failed")
+        return "danger";
+    return "muted";
+}
+export function localizedExecutionStatus(status, t) {
+    switch (status) {
+        case "success":
+            // Trigger "success" currently means the instruction was queued into the
+            // autonomy room, not that the autonomous action already completed.
+            return t("common.queued");
+        case "completed":
+            return t("common.completed");
+        case "skipped":
+            return t("heartbeatsview.statusSkipped");
+        case "queued":
+            return t("common.queued");
+        case "error":
+            return t("common.error");
+        case "failed":
+            return t("heartbeatsview.statusFailed");
+        default:
+            return status;
+    }
+}
+// ── Private import used by scheduleLabel ───────────────────────────
+import { formatDateTime } from "../../utils/format";

package/packages/app-core/src/components/pages/knowledge-detail.d.ts

@@ -0,0 +1,9 @@
+import type { KnowledgeDocument } from "../../api/client-types-chat";
+export declare function getKnowledgeTypeLabel(contentType?: string): string;
+export declare function getKnowledgeSourceLabel(source: string | undefined, t: (key: string, options?: Record<string, unknown>) => string): string;
+export declare function getKnowledgeDocumentSummary(doc: KnowledgeDocument, t: (key: string, options?: Record<string, unknown>) => string): string;
+export declare function DocumentViewer({ documentId, onUpdated, }: {
+    documentId: string | null;
+    onUpdated?: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=knowledge-detail.d.ts.map

package/packages/app-core/src/components/pages/knowledge-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-detail.d.ts","sourceRoot":"","sources":["../../../../../../../app-core/src/components/pages/knowledge-detail.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,6BAA6B,CAAC;AAIrC,wBAAgB,qBAAqB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAC5D,MAAM,CAQR;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,iBAAiB,EACtB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAC5D,MAAM,CAWR;AAgBD,wBAAgB,cAAc,CAAC,EAC7B,UAAU,EACV,SAAS,GACV,EAAE;IACD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB,2CA0SA"}