@runcore-sh/runcore 0.1.2

package/dist/google/calendar-timer.js

@@ -0,0 +1,91 @@
+/**
+ * Background calendar polling timer.
+ * Checks for upcoming events every 5 minutes from the local CalendarStore.
+ * When an event is < 30 min away, pushes a notification.
+ * Also triggers Google sync on each tick (if available).
+ * Follows src/goals/timer.ts pattern: module-level state, idempotent start/stop.
+ */
+import { getCalendarStore } from "../calendar/store.js";
+import { getGoogleCalendarAdapter } from "../calendar/google-adapter.js";
+import { pushNotification } from "../goals/notifications.js";
+import { logActivity } from "../activity/log.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("calendar");
+const DEFAULT_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+const SOON_THRESHOLD_MS = 30 * 60 * 1000; // 30 minutes
+let timer = null;
+const notifiedEventIds = new Set(); // Avoid duplicate notifications
+/**
+ * Start the calendar polling timer. Idempotent.
+ */
+export function startCalendarTimer(intervalMs) {
+    if (timer)
+        return;
+    const interval = intervalMs ?? DEFAULT_INTERVAL_MS;
+    timer = setInterval(async () => {
+        const store = getCalendarStore();
+        if (!store)
+            return;
+        try {
+            // Sync from Google on each tick (if available)
+            const adapter = getGoogleCalendarAdapter();
+            if (adapter.isAvailable()) {
+                adapter.sync().catch((err) => {
+                    log.warn("Background Google Calendar sync failed", { error: err instanceof Error ? err.message : String(err) });
+                });
+            }
+            // Check upcoming events from local store
+            const events = await store.getUpcomingEvents(1); // Next hour
+            const now = Date.now();
+            for (const event of events) {
+                if (notifiedEventIds.has(event.id))
+                    continue;
+                const eventStart = new Date(event.start).getTime();
+                const minsAway = Math.round((eventStart - now) / 60_000);
+                if (eventStart > now && eventStart - now <= SOON_THRESHOLD_MS) {
+                    notifiedEventIds.add(event.id);
+                    const attendeeStr = event.attendees.length > 0
+                        ? ` with ${event.attendees.map((a) => a.name ?? a.email).join(", ")}`
+                        : "";
+                    const msg = `Upcoming in ${minsAway} min: ${event.title}${attendeeStr}`;
+                    pushNotification({
+                        timestamp: new Date().toISOString(),
+                        source: "calendar",
+                        message: msg,
+                    });
+                    logActivity({ source: "calendar", summary: msg });
+                }
+            }
+            // Clean up old event IDs (events that have passed)
+            for (const id of notifiedEventIds) {
+                const event = events.find((e) => e.id === id);
+                if (!event || new Date(event.end).getTime() < now) {
+                    notifiedEventIds.delete(id);
+                }
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logActivity({ source: "calendar", summary: `Poll error: ${msg}` });
+        }
+    }, interval);
+    const mins = Math.round(interval / 60_000);
+    log.info(`Calendar poll: every ${mins} min`);
+}
+/**
+ * Stop the calendar polling timer.
+ */
+export function stopCalendarTimer() {
+    if (timer) {
+        clearInterval(timer);
+        timer = null;
+    }
+    notifiedEventIds.clear();
+}
+/**
+ * Check if the calendar timer is running.
+ */
+export function isCalendarTimerRunning() {
+    return timer !== null;
+}
+//# sourceMappingURL=calendar-timer.js.map

package/dist/google/calendar-timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-timer.js","sourceRoot":"","sources":["../../src/google/calendar-timer.ts"],"names":[],"mappings":"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"}

package/dist/google/calendar.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Google Calendar API client.
+ * Raw fetch via googleGet/googlePost/googlePatch — no SDK.
+ * All functions return { ok, data?, message } — never throw.
+ */
+export interface CalendarEvent {
+    id: string;
+    summary: string;
+    description?: string;
+    start: string;
+    end: string;
+    location?: string;
+    attendees: string[];
+    htmlLink?: string;
+    status: string;
+}
+/**
+ * Check if Calendar is ready (Google authenticated).
+ */
+export declare function isCalendarAvailable(): boolean;
+/**
+ * Get today's events from the primary calendar.
+ */
+export declare function getTodaySchedule(): Promise<{
+    ok: boolean;
+    events?: CalendarEvent[];
+    message: string;
+}>;
+/**
+ * Get events in the next N hours.
+ */
+export declare function getUpcomingEvents(hours?: number): Promise<{
+    ok: boolean;
+    events?: CalendarEvent[];
+    message: string;
+}>;
+/**
+ * List events with flexible filtering.
+ * @param opts.timeMin - Start of range (ISO string). Defaults to now.
+ * @param opts.timeMax - End of range (ISO string). Defaults to 24h from timeMin.
+ * @param opts.query - Free text search (matches summary, description, location, attendees).
+ * @param opts.maxResults - Maximum events to return (default 50).
+ * @param opts.showDeleted - Include cancelled events (default false).
+ */
+export declare function listEvents(opts?: {
+    timeMin?: string;
+    timeMax?: string;
+    query?: string;
+    maxResults?: number;
+    showDeleted?: boolean;
+}): Promise<{
+    ok: boolean;
+    events?: CalendarEvent[];
+    message: string;
+}>;
+/**
+ * Get free/busy windows for a time range.
+ */
+export declare function getFreeBusy(start: string, end: string): Promise<{
+    ok: boolean;
+    busy?: Array<{
+        start: string;
+        end: string;
+    }>;
+    message: string;
+}>;
+/**
+ * Create a new calendar event.
+ */
+export declare function createEvent(title: string, start: string, end: string, opts?: {
+    description?: string;
+    location?: string;
+    attendees?: string[];
+    recurrence?: string[];
+    timeZone?: string;
+}): Promise<{
+    ok: boolean;
+    event?: CalendarEvent;
+    message: string;
+}>;
+/**
+ * Update an existing calendar event.
+ */
+export declare function updateEvent(eventId: string, changes: {
+    title?: string;
+    start?: string;
+    end?: string;
+    description?: string;
+    location?: string;
+    attendees?: string[];
+    recurrence?: string[];
+    timeZone?: string;
+}): Promise<{
+    ok: boolean;
+    event?: CalendarEvent;
+    message: string;
+}>;
+/**
+ * Delete a calendar event.
+ * Optionally send cancellation notifications to attendees.
+ */
+export declare function deleteEvent(eventId: string, opts?: {
+    sendUpdates?: "all" | "externalOnly" | "none";
+}): Promise<{
+    ok: boolean;
+    message: string;
+}>;
+/**
+ * Search events by text query across a wide time range.
+ * Searches summary, description, location, and attendees.
+ * Defaults to ±6 months from now if no range provided.
+ */
+export declare function searchEvents(query: string, opts?: {
+    timeMin?: string;
+    timeMax?: string;
+    maxResults?: number;
+}): Promise<{
+    ok: boolean;
+    events?: CalendarEvent[];
+    message: string;
+}>;
+/**
+ * Format events as a readable text block for LLM context injection.
+ */
+export declare function formatEventsForContext(events: CalendarEvent[]): string;
+//# sourceMappingURL=calendar.d.ts.map

package/dist/google/calendar.d.ts.map

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

package/dist/google/calendar.js

@@ -0,0 +1,270 @@
+/**
+ * Google Calendar API client.
+ * Raw fetch via googleGet/googlePost/googlePatch — no SDK.
+ * All functions return { ok, data?, message } — never throw.
+ */
+import { googleGet, googlePost, googlePatch, googleDelete, isGoogleAuthenticated } from "./auth.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("google.calendar");
+const CALENDAR_API = "https://www.googleapis.com/calendar/v3";
+// --- Helpers ---
+function parseEvent(e) {
+    return {
+        id: e.id,
+        summary: e.summary ?? "(no title)",
+        description: e.description,
+        start: e.start?.dateTime ?? e.start?.date ?? "",
+        end: e.end?.dateTime ?? e.end?.date ?? "",
+        location: e.location,
+        attendees: (e.attendees ?? []).map((a) => a.displayName ?? a.email ?? "unknown"),
+        htmlLink: e.htmlLink,
+        status: e.status ?? "confirmed",
+    };
+}
+function toISORange(hours) {
+    const now = new Date();
+    const later = new Date(now.getTime() + hours * 60 * 60 * 1000);
+    return {
+        timeMin: now.toISOString(),
+        timeMax: later.toISOString(),
+    };
+}
+function todayRange() {
+    const now = new Date();
+    const startOfDay = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+    const endOfDay = new Date(startOfDay.getTime() + 24 * 60 * 60 * 1000);
+    return {
+        timeMin: startOfDay.toISOString(),
+        timeMax: endOfDay.toISOString(),
+    };
+}
+// --- Public API ---
+/**
+ * Check if Calendar is ready (Google authenticated).
+ */
+export function isCalendarAvailable() {
+    return isGoogleAuthenticated();
+}
+/**
+ * Get today's events from the primary calendar.
+ */
+export async function getTodaySchedule() {
+    log.debug("Fetching today's schedule");
+    const range = todayRange();
+    const result = await googleGet(`${CALENDAR_API}/calendars/primary/events`, {
+        timeMin: range.timeMin,
+        timeMax: range.timeMax,
+        singleEvents: "true",
+        orderBy: "startTime",
+        maxResults: "50",
+    });
+    if (!result.ok) {
+        log.error("Failed to fetch today's schedule", { error: result.message });
+        return { ok: false, message: result.message };
+    }
+    const events = (result.data?.items ?? [])
+        .filter((e) => e.status !== "cancelled")
+        .map(parseEvent);
+    log.info("Fetched today's schedule", { count: events.length });
+    return { ok: true, events, message: `${events.length} events today` };
+}
+/**
+ * Get events in the next N hours.
+ */
+export async function getUpcomingEvents(hours = 4) {
+    log.debug("Fetching upcoming events", { hours });
+    const range = toISORange(hours);
+    const result = await googleGet(`${CALENDAR_API}/calendars/primary/events`, {
+        timeMin: range.timeMin,
+        timeMax: range.timeMax,
+        singleEvents: "true",
+        orderBy: "startTime",
+        maxResults: "20",
+    });
+    if (!result.ok) {
+        log.error("Failed to fetch upcoming events", { hours, error: result.message });
+        return { ok: false, message: result.message };
+    }
+    const events = (result.data?.items ?? [])
+        .filter((e) => e.status !== "cancelled")
+        .map(parseEvent);
+    log.debug("Fetched upcoming events", { hours, count: events.length });
+    return { ok: true, events, message: `${events.length} events in next ${hours}h` };
+}
+/**
+ * List events with flexible filtering.
+ * @param opts.timeMin - Start of range (ISO string). Defaults to now.
+ * @param opts.timeMax - End of range (ISO string). Defaults to 24h from timeMin.
+ * @param opts.query - Free text search (matches summary, description, location, attendees).
+ * @param opts.maxResults - Maximum events to return (default 50).
+ * @param opts.showDeleted - Include cancelled events (default false).
+ */
+export async function listEvents(opts) {
+    const now = new Date();
+    const params = {
+        timeMin: opts?.timeMin ?? now.toISOString(),
+        timeMax: opts?.timeMax ?? new Date(now.getTime() + 24 * 60 * 60 * 1000).toISOString(),
+        singleEvents: "true",
+        orderBy: "startTime",
+        maxResults: String(opts?.maxResults ?? 50),
+    };
+    if (opts?.query)
+        params.q = opts.query;
+    if (opts?.showDeleted)
+        params.showDeleted = "true";
+    log.debug("Listing events", { timeMin: params.timeMin, timeMax: params.timeMax, query: opts?.query });
+    const result = await googleGet(`${CALENDAR_API}/calendars/primary/events`, params);
+    if (!result.ok) {
+        log.error("Failed to list events", { error: result.message });
+        return { ok: false, message: result.message };
+    }
+    const events = (result.data?.items ?? [])
+        .filter((e) => opts?.showDeleted || e.status !== "cancelled")
+        .map(parseEvent);
+    log.debug("Listed events", { count: events.length });
+    return { ok: true, events, message: `${events.length} events` };
+}
+/**
+ * Get free/busy windows for a time range.
+ */
+export async function getFreeBusy(start, end) {
+    log.debug("Querying free/busy", { start, end });
+    const result = await googlePost(`${CALENDAR_API}/freeBusy`, {
+        timeMin: start,
+        timeMax: end,
+        items: [{ id: "primary" }],
+    });
+    if (!result.ok) {
+        log.error("Failed to query free/busy", { error: result.message });
+        return { ok: false, message: result.message };
+    }
+    const busy = result.data?.calendars?.primary?.busy ?? [];
+    log.debug("Free/busy query complete", { busyBlocks: busy.length });
+    return { ok: true, busy, message: `${busy.length} busy blocks` };
+}
+/**
+ * Create a new calendar event.
+ */
+export async function createEvent(title, start, end, opts) {
+    const body = {
+        summary: title,
+        start: { dateTime: start, ...(opts?.timeZone && { timeZone: opts.timeZone }) },
+        end: { dateTime: end, ...(opts?.timeZone && { timeZone: opts.timeZone }) },
+    };
+    if (opts?.description)
+        body.description = opts.description;
+    if (opts?.location)
+        body.location = opts.location;
+    if (opts?.attendees?.length) {
+        body.attendees = opts.attendees.map((email) => ({ email }));
+    }
+    if (opts?.recurrence?.length)
+        body.recurrence = opts.recurrence;
+    log.debug("Creating calendar event", { title, start, end });
+    const result = await googlePost(`${CALENDAR_API}/calendars/primary/events`, body);
+    if (!result.ok) {
+        log.error("Failed to create calendar event", { title, error: result.message });
+        return { ok: false, message: result.message };
+    }
+    log.info("Calendar event created", { title, eventId: result.data.id });
+    return {
+        ok: true,
+        event: parseEvent(result.data),
+        message: `Event created: ${title}`,
+    };
+}
+/**
+ * Update an existing calendar event.
+ */
+export async function updateEvent(eventId, changes) {
+    if (!eventId)
+        return { ok: false, message: "eventId is required" };
+    const body = {};
+    if (changes.title !== undefined)
+        body.summary = changes.title;
+    if (changes.start !== undefined) {
+        body.start = { dateTime: changes.start, ...(changes.timeZone && { timeZone: changes.timeZone }) };
+    }
+    if (changes.end !== undefined) {
+        body.end = { dateTime: changes.end, ...(changes.timeZone && { timeZone: changes.timeZone }) };
+    }
+    if (changes.description !== undefined)
+        body.description = changes.description;
+    if (changes.location !== undefined)
+        body.location = changes.location;
+    if (changes.attendees !== undefined) {
+        body.attendees = changes.attendees.map((email) => ({ email }));
+    }
+    if (changes.recurrence !== undefined)
+        body.recurrence = changes.recurrence;
+    log.debug("Updating calendar event", { eventId, changes: Object.keys(changes) });
+    const result = await googlePatch(`${CALENDAR_API}/calendars/primary/events/${eventId}`, body);
+    if (!result.ok) {
+        log.error("Failed to update calendar event", { eventId, error: result.message });
+        return { ok: false, message: result.message };
+    }
+    log.info("Calendar event updated", { eventId });
+    return {
+        ok: true,
+        event: parseEvent(result.data),
+        message: `Event updated: ${eventId}`,
+    };
+}
+/**
+ * Delete a calendar event.
+ * Optionally send cancellation notifications to attendees.
+ */
+export async function deleteEvent(eventId, opts) {
+    if (!eventId)
+        return { ok: false, message: "eventId is required" };
+    log.debug("Deleting calendar event", { eventId, sendUpdates: opts?.sendUpdates });
+    const sendUpdates = opts?.sendUpdates ?? "none";
+    const result = await googleDelete(`${CALENDAR_API}/calendars/primary/events/${eventId}?sendUpdates=${sendUpdates}`);
+    if (!result.ok) {
+        log.error("Failed to delete calendar event", { eventId, error: result.message });
+        return { ok: false, message: result.message };
+    }
+    log.info("Calendar event deleted", { eventId });
+    return { ok: true, message: `Event deleted: ${eventId}` };
+}
+/**
+ * Search events by text query across a wide time range.
+ * Searches summary, description, location, and attendees.
+ * Defaults to ±6 months from now if no range provided.
+ */
+export async function searchEvents(query, opts) {
+    if (!query)
+        return { ok: false, message: "query is required" };
+    log.debug("Searching calendar events", { query });
+    const now = new Date();
+    const sixMonthsAgo = new Date(now.getFullYear(), now.getMonth() - 6, now.getDate());
+    const sixMonthsAhead = new Date(now.getFullYear(), now.getMonth() + 6, now.getDate());
+    return listEvents({
+        timeMin: opts?.timeMin ?? sixMonthsAgo.toISOString(),
+        timeMax: opts?.timeMax ?? sixMonthsAhead.toISOString(),
+        query,
+        maxResults: opts?.maxResults ?? 25,
+    });
+}
+/**
+ * Format events as a readable text block for LLM context injection.
+ */
+export function formatEventsForContext(events) {
+    if (events.length === 0)
+        return "No events.";
+    return events
+        .map((e) => {
+        const startTime = e.start.includes("T")
+            ? new Date(e.start).toLocaleTimeString("en-US", { hour: "numeric", minute: "2-digit" })
+            : "All day";
+        const endTime = e.end.includes("T")
+            ? new Date(e.end).toLocaleTimeString("en-US", { hour: "numeric", minute: "2-digit" })
+            : "";
+        const timeStr = endTime ? `${startTime}–${endTime}` : startTime;
+        const attendeeStr = e.attendees.length > 0 ? ` (with: ${e.attendees.join(", ")})` : "";
+        const locationStr = e.location ? ` @ ${e.location}` : "";
+        return `- ${timeStr}: ${e.summary}${attendeeStr}${locationStr}`;
+    })
+        .join("\n");
+}
+//# sourceMappingURL=calendar.js.map

package/dist/google/calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../src/google/calendar.ts"],"names":[],"mappings":"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"}

package/dist/google/docs.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Google Docs & Sheets client.
+ * Raw fetch via googlePost/googleGet — no SDK.
+ * Follows same pattern as gmail.ts and calendar.ts.
+ *
+ * Uses drive.file scope — can only access files this app creates.
+ */
+/**
+ * Check if Docs/Sheets creation is available.
+ */
+export declare function isDocsAvailable(): boolean;
+interface DocCreateResult {
+    documentId: string;
+    title: string;
+    documentUrl: string;
+}
+/**
+ * Create a new Google Doc with the given title.
+ * Returns the document ID and URL.
+ */
+export declare function createDocument(title: string): Promise<{
+    ok: boolean;
+    data?: DocCreateResult;
+    message: string;
+}>;
+/**
+ * Batch-update a document with structured content requests.
+ * Uses the Google Docs batchUpdate API.
+ * Requests are applied in order — insert from bottom-up to avoid index shifting.
+ */
+export declare function batchUpdateDocument(documentId: string, requests: Record<string, any>[]): Promise<{
+    ok: boolean;
+    message: string;
+}>;
+interface BacklogItem {
+    identifier: string;
+    title: string;
+    description: string;
+    state: string;
+    priority: number;
+    assignee: string | null;
+    exchanges: Array<{
+        body: string;
+    }>;
+}
+/**
+ * Create a Google Doc populated with a backlog review.
+ * Returns the document URL.
+ */
+export declare function createBacklogReviewDoc(items: BacklogItem[]): Promise<{
+    ok: boolean;
+    url?: string;
+    message: string;
+}>;
+interface SheetCreateResult {
+    spreadsheetId: string;
+    title: string;
+    spreadsheetUrl: string;
+}
+/**
+ * Create a new Google Sheet with optional data.
+ * Data is an array of rows, each row an array of cell values.
+ */
+export declare function createSpreadsheet(title: string, data?: string[][], sheetName?: string): Promise<{
+    ok: boolean;
+    data?: SheetCreateResult;
+    message: string;
+}>;
+/**
+ * Read data from a Google Sheet.
+ */
+export declare function readSpreadsheet(spreadsheetId: string, range?: string): Promise<{
+    ok: boolean;
+    data?: string[][];
+    message: string;
+}>;
+/**
+ * Create a Google Doc with markdown-ish content in one call.
+ * Convenience wrapper: creates doc + inserts formatted content.
+ */
+export declare function createDocWithContent(title: string, content: string): Promise<{
+    ok: boolean;
+    url?: string;
+    message: string;
+}>;
+export {};
+//# sourceMappingURL=docs.d.ts.map

package/dist/google/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/google/docs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,UAAU,eAAe;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAsBnE;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,GAC9B,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAa3C;AAiDD,UAAU,WAAW;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpC;AAUD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,WAAW,EAAE,GACnB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAkIzD;AAID,UAAU,iBAAiB;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA6CrE;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB9D;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAqCzD"}