@elizaos/ui 2.0.0-alpha.85 → 2.0.0-beta.2

package/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/components/pages/heartbeat-utils.d.ts.map

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

package/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.js";
+// ── 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.js";

package/components/pages/page-scoped-conversations.d.ts

@@ -0,0 +1,62 @@
+import type { Conversation, ConversationMetadata } from "../../api/client-types-chat";
+export type PageScope = "page-browser" | "page-character" | "page-automations" | "page-apps" | "page-connectors" | "page-phone" | "page-plugins" | "page-lifeops" | "page-settings" | "page-wallet";
+export declare const PAGE_SCOPES: readonly PageScope[];
+/**
+ * Bump when the per-scope brief, intro copy, or live-state shape changes
+ * meaningfully — so a future MIPRO/GEPA optimization pass can filter to a
+ * single prompt-regime cohort instead of mixing trajectories generated under
+ * different surface contracts.
+ */
+export declare const PAGE_SCOPE_VERSION = 13;
+export interface PageScopeIntroCopy {
+    /** Short user-facing intro card title shown when the conversation is empty. */
+    title: string;
+    /** Body shown to the user before they type. */
+    body: string;
+    /**
+     * System prompt addendum prepended to the FIRST user turn so the agent is
+     * grounded in the surface from message #1. Distinct from the user-facing
+     * intro and never persisted as a visible message.
+     */
+    systemAddendum: string;
+}
+export declare const PAGE_SCOPE_COPY: Record<PageScope, PageScopeIntroCopy>;
+export declare const PAGE_SCOPE_DEFAULT_TITLE: Record<PageScope, string>;
+/**
+ * Browser scope intro copy varies by Agent Browser Bridge companion state: when the
+ * extension is connected the agent can drive real tabs; when it isn't the
+ * intro has to walk the user through installing the extension instead of
+ * pretending real-browser control is available.
+ */
+export declare function getBrowserPageScopeCopy(state: {
+    browserBridgeConnected: boolean;
+    browserBridgeInstallAvailable?: boolean;
+    browserLabel?: string | null;
+    profileLabel?: string | null;
+}): PageScopeIntroCopy;
+export declare function isPageScopedConversation(conversation: Pick<Conversation, "metadata"> | null | undefined): boolean;
+export declare function isPageScopedConversationMetadata(metadata: ConversationMetadata | null | undefined): boolean;
+export declare function buildPageScopedConversationMetadata(scope: PageScope, options?: {
+    sourceConversationId?: string;
+    pageId?: string;
+}): ConversationMetadata;
+/**
+ * Routing metadata stamped on every page-scope send. The runtime persists this
+ * into the trajectory `metadata` column verbatim — every field here is a
+ * sortable dimension for later analysis or per-scope prompt optimization.
+ */
+export declare function buildPageScopedRoutingMetadata(scope: PageScope, options?: {
+    sourceConversationId?: string;
+    pageId?: string;
+}): Record<string, unknown>;
+export declare function resolvePageScopedConversation(params: {
+    scope: PageScope;
+    title?: string;
+    pageId?: string;
+}): Promise<Conversation>;
+export declare function resetPageScopedConversation(params: {
+    scope: PageScope;
+    title?: string;
+    pageId?: string;
+}): Promise<Conversation>;
+//# sourceMappingURL=page-scoped-conversations.d.ts.map

package/components/pages/page-scoped-conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-scoped-conversations.d.ts","sourceRoot":"","sources":["../../../../../../src/components/pages/page-scoped-conversations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACrB,MAAM,6BAA6B,CAAC;AAErC,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,gBAAgB,GAChB,kBAAkB,GAClB,WAAW,GACX,iBAAiB,GACjB,YAAY,GACZ,cAAc,GACd,cAAc,GACd,eAAe,GACf,aAAa,CAAC;AAElB,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAWlC,CAAC;AAiEX;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,SAAS,EAAE,kBAAkB,CA6DjE,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAW9D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,sBAAsB,EAAE,OAAO,CAAC;IAChC,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,kBAAkB,CAyBrB;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,GAC9D,OAAO,CAGT;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAChD,OAAO,CAGT;AAED,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/D,oBAAoB,CAStB;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/D,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBzB;AAqCD,wBAAsB,6BAA6B,CAAC,MAAM,EAAE;IAC1D,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,YAAY,CAAC,CA6BxB;AAED,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,YAAY,CAAC,CAsBxB"}