openclaw-event-server-plugin 1.0.0

package/dist/hooks/session-hooks.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Session and identity tracking helpers.
+ */
+import { SessionEvent } from '../events/types';
+export declare function createSessionStartEvent(context: {
+    sessionId: string;
+    sessionKey?: string;
+    agentId?: string;
+    resumedFrom?: string;
+    correlationId?: string;
+    metadata?: Record<string, unknown>;
+}): SessionEvent;
+export declare function createSessionEndEvent(context: {
+    sessionId: string;
+    sessionKey?: string;
+    agentId?: string;
+    messageCount?: number;
+    durationMs?: number;
+    correlationId?: string;
+    metadata?: Record<string, unknown>;
+}): SessionEvent;
+export declare function createSessionSpawnedEvent(context: {
+    sessionKey: string;
+    parentSessionId?: string;
+    agentId?: string;
+    workspaceDir?: string;
+    channel?: string;
+    requester?: string;
+    sessionId?: string;
+    correlationId?: string;
+}): SessionEvent;
+export declare function createSessionCompletedEvent(context: {
+    sessionKey: string;
+    parentSessionId?: string;
+    agentId?: string;
+    sessionId?: string;
+    correlationId?: string;
+}): SessionEvent;
+export declare function createSessionErrorEvent(context: {
+    sessionKey: string;
+    error: string;
+    stackTrace?: string;
+    parentSessionId?: string;
+    agentId?: string;
+    sessionId?: string;
+    correlationId?: string;
+}): SessionEvent;
+/**
+ * Tracks active sessions and helper maps for identity resolution.
+ */
+export declare class SessionTracker {
+    private bySessionKey;
+    private bySessionId;
+    startSession(sessionKey: string, agentId?: string, parentSessionId?: string): void;
+    startSession(params: {
+        sessionId?: string;
+        sessionKey?: string;
+        agentId?: string;
+        parentSessionId?: string;
+    }): void;
+    touchSession(params: {
+        sessionId?: string;
+        sessionKey?: string;
+        agentId?: string;
+    }): void;
+    endSession(sessionIdentifier: string): {
+        durationMs: number;
+        agentId?: string;
+        sessionId?: string;
+        sessionKey?: string;
+        parentSessionId?: string;
+    } | null;
+    private getRecord;
+    getSession(sessionIdentifier?: string): {
+        agentId?: string;
+        parentSessionId?: string;
+        durationMs: number;
+        sessionId?: string;
+        sessionKey?: string;
+    } | null;
+    getAgentIdBySession(params: {
+        sessionId?: string;
+        sessionKey?: string;
+    }): string | undefined;
+    getActiveSessions(): string[];
+    getActiveSessionCount(): number;
+    clear(): void;
+}
+//# sourceMappingURL=session-hooks.d.ts.map

package/dist/hooks/session-hooks.d.ts.map

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

package/dist/hooks/session-hooks.js

@@ -0,0 +1,253 @@
+"use strict";
+/**
+ * Session and identity tracking helpers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionTracker = void 0;
+exports.createSessionStartEvent = createSessionStartEvent;
+exports.createSessionEndEvent = createSessionEndEvent;
+exports.createSessionSpawnedEvent = createSessionSpawnedEvent;
+exports.createSessionCompletedEvent = createSessionCompletedEvent;
+exports.createSessionErrorEvent = createSessionErrorEvent;
+const event_factory_1 = require("./event-factory");
+function createSessionStartEvent(context) {
+    return (0, event_factory_1.createCanonicalEvent)({
+        type: 'session.start',
+        eventCategory: 'session',
+        eventName: 'session_start',
+        source: 'plugin-hook',
+        agentId: context.agentId,
+        sessionId: context.sessionId,
+        sessionKey: context.sessionKey,
+        correlationId: context.correlationId,
+        data: {
+            sessionId: context.sessionId,
+            sessionKey: context.sessionKey,
+            agentId: context.agentId,
+            resumedFrom: context.resumedFrom,
+            ...context.metadata,
+        },
+    });
+}
+function createSessionEndEvent(context) {
+    return (0, event_factory_1.createCanonicalEvent)({
+        type: 'session.end',
+        eventCategory: 'session',
+        eventName: 'session_end',
+        source: 'plugin-hook',
+        agentId: context.agentId,
+        sessionId: context.sessionId,
+        sessionKey: context.sessionKey,
+        correlationId: context.correlationId,
+        data: {
+            sessionId: context.sessionId,
+            sessionKey: context.sessionKey,
+            agentId: context.agentId,
+            messageCount: context.messageCount,
+            durationMs: context.durationMs,
+            ...context.metadata,
+        },
+    });
+}
+// Legacy compatibility aliases retained for existing consumers/tests.
+function createSessionSpawnedEvent(context) {
+    return (0, event_factory_1.createCanonicalEvent)({
+        type: 'session.spawned',
+        eventCategory: 'session',
+        eventName: 'session_start',
+        source: 'plugin-hook',
+        agentId: context.agentId,
+        sessionId: context.sessionId ?? context.sessionKey,
+        sessionKey: context.sessionKey,
+        correlationId: context.correlationId,
+        data: {
+            sessionKey: context.sessionKey,
+            parentSessionId: context.parentSessionId,
+            agentId: context.agentId,
+            metadata: {
+                workspaceDir: context.workspaceDir,
+                channel: context.channel,
+                requester: context.requester,
+            },
+        },
+    });
+}
+function createSessionCompletedEvent(context) {
+    return (0, event_factory_1.createCanonicalEvent)({
+        type: 'session.completed',
+        eventCategory: 'session',
+        eventName: 'session_end',
+        source: 'plugin-hook',
+        agentId: context.agentId,
+        sessionId: context.sessionId ?? context.sessionKey,
+        sessionKey: context.sessionKey,
+        correlationId: context.correlationId,
+        data: {
+            sessionKey: context.sessionKey,
+            parentSessionId: context.parentSessionId,
+            agentId: context.agentId,
+        },
+    });
+}
+function createSessionErrorEvent(context) {
+    return (0, event_factory_1.createCanonicalEvent)({
+        type: 'session.error',
+        eventCategory: 'session',
+        eventName: 'session_end',
+        source: 'plugin-hook',
+        agentId: context.agentId,
+        sessionId: context.sessionId ?? context.sessionKey,
+        sessionKey: context.sessionKey,
+        correlationId: context.correlationId,
+        error: {
+            message: context.error,
+            stack: context.stackTrace,
+            kind: 'agent',
+        },
+        data: {
+            sessionKey: context.sessionKey,
+            parentSessionId: context.parentSessionId,
+            agentId: context.agentId,
+            error: context.error,
+            stackTrace: context.stackTrace,
+        },
+    });
+}
+/**
+ * Tracks active sessions and helper maps for identity resolution.
+ */
+class SessionTracker {
+    bySessionKey = new Map();
+    bySessionId = new Map();
+    startSession(input, agentIdArg, parentSessionIdArg) {
+        if (typeof input !== 'string' && (!input || typeof input !== 'object')) {
+            throw new Error('Session key must be a non-empty string');
+        }
+        const params = (typeof input === 'string'
+            ? {
+                sessionKey: input,
+                sessionId: undefined,
+                agentId: agentIdArg,
+                parentSessionId: parentSessionIdArg,
+            }
+            : input);
+        const hasSessionKey = typeof params.sessionKey === 'string' && params.sessionKey.trim().length > 0;
+        const hasSessionId = typeof params.sessionId === 'string' && params.sessionId.trim().length > 0;
+        if (!hasSessionId && !hasSessionKey) {
+            throw new Error('Session key must be a non-empty string');
+        }
+        const record = {
+            startTime: Date.now(),
+            agentId: params.agentId,
+            sessionId: params.sessionId,
+            sessionKey: params.sessionKey,
+            parentSessionId: params.parentSessionId,
+        };
+        if (params.sessionKey) {
+            this.bySessionKey.set(params.sessionKey, record);
+        }
+        if (params.sessionId) {
+            this.bySessionId.set(params.sessionId, record);
+        }
+    }
+    touchSession(params) {
+        const current = this.getRecord(params.sessionId ?? params.sessionKey);
+        if (current) {
+            if (params.agentId && !current.agentId) {
+                current.agentId = params.agentId;
+            }
+            if (params.sessionId && !current.sessionId) {
+                current.sessionId = params.sessionId;
+                this.bySessionId.set(params.sessionId, current);
+            }
+            if (params.sessionKey && !current.sessionKey) {
+                current.sessionKey = params.sessionKey;
+                this.bySessionKey.set(params.sessionKey, current);
+            }
+            return;
+        }
+        if (params.sessionId !== undefined || params.sessionKey !== undefined) {
+            this.startSession({
+                sessionId: params.sessionId,
+                sessionKey: params.sessionKey,
+                agentId: params.agentId,
+            });
+        }
+    }
+    endSession(sessionIdentifier) {
+        const record = this.getRecord(sessionIdentifier);
+        if (!record) {
+            return null;
+        }
+        if (record.sessionId) {
+            this.bySessionId.delete(record.sessionId);
+        }
+        if (record.sessionKey) {
+            this.bySessionKey.delete(record.sessionKey);
+        }
+        return {
+            durationMs: Date.now() - record.startTime,
+            agentId: record.agentId,
+            sessionId: record.sessionId,
+            sessionKey: record.sessionKey,
+            parentSessionId: record.parentSessionId,
+        };
+    }
+    getRecord(sessionIdentifier) {
+        if (!sessionIdentifier) {
+            return null;
+        }
+        return this.bySessionId.get(sessionIdentifier) ?? this.bySessionKey.get(sessionIdentifier) ?? null;
+    }
+    getSession(sessionIdentifier) {
+        const record = this.getRecord(sessionIdentifier);
+        if (!record) {
+            return null;
+        }
+        return {
+            agentId: record.agentId,
+            parentSessionId: record.parentSessionId,
+            durationMs: Date.now() - record.startTime,
+            sessionId: record.sessionId,
+            sessionKey: record.sessionKey,
+        };
+    }
+    getAgentIdBySession(params) {
+        if (params.sessionId) {
+            const byId = this.bySessionId.get(params.sessionId);
+            if (byId?.agentId) {
+                return byId.agentId;
+            }
+        }
+        if (params.sessionKey) {
+            return this.bySessionKey.get(params.sessionKey)?.agentId;
+        }
+        return undefined;
+    }
+    getActiveSessions() {
+        const sessions = new Set();
+        for (const key of this.bySessionKey.keys()) {
+            sessions.add(key);
+        }
+        for (const key of this.bySessionId.keys()) {
+            sessions.add(key);
+        }
+        return Array.from(sessions);
+    }
+    getActiveSessionCount() {
+        const records = new Set();
+        for (const value of this.bySessionId.values()) {
+            records.add(value);
+        }
+        for (const value of this.bySessionKey.values()) {
+            records.add(value);
+        }
+        return records.size;
+    }
+    clear() {
+        this.bySessionId.clear();
+        this.bySessionKey.clear();
+    }
+}
+exports.SessionTracker = SessionTracker;
+//# sourceMappingURL=session-hooks.js.map

package/dist/hooks/session-hooks.js.map

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

package/dist/hooks/status-reducer.d.ts

@@ -0,0 +1,30 @@
+import { AgentSyntheticStatus } from '../events/types';
+export type AgentStatusTransition = {
+    agentId: string;
+    status: AgentSyntheticStatus;
+    activity: string;
+    activityDetail: string;
+    reason: string;
+    activeSessionCount: number;
+    lastActiveAt?: string;
+};
+export declare class AgentStatusReducer {
+    private readonly workingWindowMs;
+    private readonly sleepingWindowMs;
+    private readonly agents;
+    constructor(params?: {
+        workingWindowMs?: number;
+        sleepingWindowMs?: number;
+    });
+    observeActivity(agentId: string, sessionRef?: string, atMs?: number): void;
+    removeSession(agentId: string, sessionRef?: string): void;
+    markAgentError(agentId: string, hasError: boolean): void;
+    markAgentOffline(agentId: string, isOffline: boolean): void;
+    markAllOffline(): void;
+    evaluateTransitions(nowMs?: number): AgentStatusTransition[];
+    clear(): void;
+    private ensureAgent;
+    private computeStatus;
+    private getLatestSessionActivity;
+}
+//# sourceMappingURL=status-reducer.d.ts.map

package/dist/hooks/status-reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-reducer.d.ts","sourceRoot":"","sources":["../../src/hooks/status-reducer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAuBvD,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;gBAEjD,MAAM,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE;IAK5E,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAY1E,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAWzD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAIxD,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAI3D,cAAc,IAAI,IAAI;IAMtB,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAgB5D,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,aAAa;IAyErB,OAAO,CAAC,wBAAwB;CASjC"}

package/dist/hooks/status-reducer.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentStatusReducer = void 0;
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60) {
+        return `${seconds} second${seconds === 1 ? '' : 's'}`;
+    }
+    const minutes = Math.floor(seconds / 60);
+    return `${minutes} minute${minutes === 1 ? '' : 's'}`;
+}
+class AgentStatusReducer {
+    workingWindowMs;
+    sleepingWindowMs;
+    agents = new Map();
+    constructor(params) {
+        this.workingWindowMs = params?.workingWindowMs ?? 30_000;
+        this.sleepingWindowMs = params?.sleepingWindowMs ?? 10 * 60_000;
+    }
+    observeActivity(agentId, sessionRef, atMs) {
+        const state = this.ensureAgent(agentId);
+        if (!sessionRef) {
+            return;
+        }
+        state.sessions.set(sessionRef, {
+            sessionRef,
+            lastActiveAt: atMs ?? Date.now(),
+        });
+        state.isOffline = false;
+    }
+    removeSession(agentId, sessionRef) {
+        if (!sessionRef) {
+            return;
+        }
+        const state = this.agents.get(agentId);
+        if (!state) {
+            return;
+        }
+        state.sessions.delete(sessionRef);
+    }
+    markAgentError(agentId, hasError) {
+        this.ensureAgent(agentId).hasAgentError = hasError;
+    }
+    markAgentOffline(agentId, isOffline) {
+        this.ensureAgent(agentId).isOffline = isOffline;
+    }
+    markAllOffline() {
+        for (const state of this.agents.values()) {
+            state.isOffline = true;
+        }
+    }
+    evaluateTransitions(nowMs) {
+        const now = nowMs ?? Date.now();
+        const transitions = [];
+        for (const [agentId, state] of this.agents.entries()) {
+            const next = this.computeStatus(state, now);
+            if (state.lastStatus !== next.status) {
+                state.lastStatus = next.status;
+                transitions.push({
+                    agentId,
+                    ...next,
+                });
+            }
+        }
+        return transitions;
+    }
+    clear() {
+        this.agents.clear();
+    }
+    ensureAgent(agentId) {
+        const existing = this.agents.get(agentId);
+        if (existing) {
+            return existing;
+        }
+        const created = {
+            sessions: new Map(),
+            hasAgentError: false,
+            isOffline: false,
+        };
+        this.agents.set(agentId, created);
+        return created;
+    }
+    computeStatus(state, nowMs) {
+        const latestActive = this.getLatestSessionActivity(state);
+        const activeSessionCount = state.sessions.size;
+        if (state.isOffline) {
+            return {
+                status: 'offline',
+                activity: 'Offline',
+                activityDetail: 'Agent unreachable',
+                reason: 'offline',
+                activeSessionCount,
+                lastActiveAt: latestActive ? new Date(latestActive).toISOString() : undefined,
+            };
+        }
+        if (state.hasAgentError) {
+            return {
+                status: 'error',
+                activity: 'Error',
+                activityDetail: 'Agent reported an error state',
+                reason: 'agent-error',
+                activeSessionCount,
+                lastActiveAt: latestActive ? new Date(latestActive).toISOString() : undefined,
+            };
+        }
+        if (latestActive === undefined) {
+            return {
+                status: 'sleeping',
+                activity: 'Sleeping',
+                activityDetail: 'No active sessions',
+                reason: 'no-sessions',
+                activeSessionCount,
+                lastActiveAt: undefined,
+            };
+        }
+        const ageMs = nowMs - latestActive;
+        if (ageMs <= this.workingWindowMs) {
+            return {
+                status: 'working',
+                activity: 'Working',
+                activityDetail: 'Recent activity in one or more sessions',
+                reason: 'recent-activity',
+                activeSessionCount,
+                lastActiveAt: new Date(latestActive).toISOString(),
+            };
+        }
+        if (ageMs <= this.sleepingWindowMs) {
+            return {
+                status: 'idle',
+                activity: 'Idle',
+                activityDetail: `No recent events in the last ${formatDuration(this.workingWindowMs)}`,
+                reason: 'idle-window',
+                activeSessionCount,
+                lastActiveAt: new Date(latestActive).toISOString(),
+            };
+        }
+        return {
+            status: 'sleeping',
+            activity: 'Sleeping',
+            activityDetail: `No events in the last ${formatDuration(this.sleepingWindowMs)}`,
+            reason: 'sleeping-window',
+            activeSessionCount,
+            lastActiveAt: new Date(latestActive).toISOString(),
+        };
+    }
+    getLatestSessionActivity(state) {
+        let latest;
+        for (const session of state.sessions.values()) {
+            if (latest === undefined || session.lastActiveAt > latest) {
+                latest = session.lastActiveAt;
+            }
+        }
+        return latest;
+    }
+}
+exports.AgentStatusReducer = AgentStatusReducer;
+//# sourceMappingURL=status-reducer.js.map

package/dist/hooks/status-reducer.js.map

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

package/dist/hooks/subagent-hooks.d.ts

@@ -0,0 +1,37 @@
+import { SubagentEvent } from '../events/types';
+export declare function createSubagentSpawningEvent(context: {
+    agentId?: string;
+    sessionId?: string;
+    sessionKey?: string;
+    runId?: string;
+    childSessionKey?: string;
+    data?: Record<string, unknown>;
+}): SubagentEvent;
+export declare function createSubagentSpawnedEvent(context: {
+    agentId?: string;
+    sessionId?: string;
+    sessionKey?: string;
+    runId?: string;
+    childSessionKey?: string;
+    data?: Record<string, unknown>;
+}): SubagentEvent;
+export declare function createSubagentEndedEvent(context: {
+    agentId?: string;
+    sessionId?: string;
+    sessionKey?: string;
+    runId?: string;
+    childSessionKey?: string;
+    data?: Record<string, unknown>;
+}): SubagentEvent;
+export declare function createSubagentIdleEvent(context: {
+    parentAgentId?: string;
+    parentSessionId?: string;
+    parentSessionKey?: string;
+    childAgentId?: string;
+    childSessionKey: string;
+    runId?: string;
+    mode?: string;
+    idleForMs: number;
+    lastActiveAt: string;
+}): SubagentEvent;
+//# sourceMappingURL=subagent-hooks.d.ts.map

package/dist/hooks/subagent-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-hooks.d.ts","sourceRoot":"","sources":["../../src/hooks/subagent-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,aAAa,CAehB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,aAAa,CAehB;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,aAAa,CAehB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,aAAa,CAsBhB"}