pi-harness-runtime 0.5.0 → 0.6.3-beta.13

package/packages/session/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Session Manager
+ *
+ * Session management system with message history, token accounting,
+ * policy enforcement, and session persistence.
+ */
+export { SessionManager, createSessionManager } from "./manager.js";
+export { SessionStore, createSessionStore } from "./store.js";
+export { MessageHistory, MessageSearch, ContextWindowManager, } from "./history.js";
+export { PolicyEngine, RateLimiter, BudgetTracker, createPolicyEngine, } from "./policy.js";
+export { SDK_VERSION, type SessionStatus, type Session, type SessionContext, type Message, type ToolCall, type ToolResult, type TokenUsage, type SessionMetrics, type PolicyState, type SessionManagerConfig, type SessionStoreConfig, type PolicyEngineConfig, type SessionEventType, type SessionEvent, type MessageSearchFilter, type MessageSearchResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/session/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIpE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAI9D,OAAO,EACN,cAAc,EACd,aAAa,EACb,oBAAoB,GACpB,MAAM,cAAc,CAAC;AAItB,OAAO,EACN,YAAY,EACZ,WAAW,EACX,aAAa,EACb,kBAAkB,GAClB,MAAM,aAAa,CAAC;AAIrB,OAAO,EACN,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,GACxB,MAAM,YAAY,CAAC"}

package/packages/session/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * Session Manager
+ *
+ * Session management system with message history, token accounting,
+ * policy enforcement, and session persistence.
+ */
+// ─── Manager ────────────────────────────────────────────────────────────
+export { SessionManager, createSessionManager } from "./manager.js";
+// ─── Store ────────────────────────────────────────────────────────────
+export { SessionStore, createSessionStore } from "./store.js";
+// ─── History ─────────────────────────────────────────────────────────
+export { MessageHistory, MessageSearch, ContextWindowManager, } from "./history.js";
+// ─── Policy ──────────────────────────────────────────────────────────
+export { PolicyEngine, RateLimiter, BudgetTracker, createPolicyEngine, } from "./policy.js";
+// ─── Types ───────────────────────────────────────────────────────────
+export { SDK_VERSION, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/packages/session/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2EAA2E;AAE3E,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpE,yEAAyE;AAEzE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE9D,wEAAwE;AAExE,OAAO,EACN,cAAc,EACd,aAAa,EACb,oBAAoB,GACpB,MAAM,cAAc,CAAC;AAEtB,wEAAwE;AAExE,OAAO,EACN,YAAY,EACZ,WAAW,EACX,aAAa,EACb,kBAAkB,GAClB,MAAM,aAAa,CAAC;AAErB,wEAAwE;AAExE,OAAO,EACN,WAAW,GAiBX,MAAM,YAAY,CAAC"}

package/packages/session/dist/manager.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Session Manager - Manager
+ *
+ * Main session management class.
+ */
+import type { Message, Session, SessionContext, SessionEvent, SessionEventType, SessionManagerConfig, SessionMetrics, TokenUsage } from "./types.js";
+export declare class SessionManager {
+    private readonly config;
+    private readonly store;
+    private readonly policyEngine;
+    private readonly contextWindows;
+    private eventListeners;
+    private cleanupTimer?;
+    constructor(config?: SessionManagerConfig);
+    /**
+     * Generate unique session ID
+     */
+    private generateId;
+    /**
+     * Emit session event
+     */
+    private emit;
+    /**
+     * Add event listener
+     */
+    on(eventType: SessionEventType, listener: (event: SessionEvent) => void): void;
+    /**
+     * Remove event listener
+     */
+    off(eventType: SessionEventType, listener: (event: SessionEvent) => void): void;
+    /**
+     * Create a new session
+     */
+    create(userId: string, metadata?: Record<string, unknown>): Promise<Session>;
+    /**
+     * Get session
+     */
+    get(sessionId: string): Promise<Session | null>;
+    /**
+     * Get session with full context
+     */
+    getContext(sessionId: string): Promise<SessionContext | null>;
+    /**
+     * End a session (close it)
+     */
+    end(sessionId: string): Promise<void>;
+    /**
+     * Suspend session
+     */
+    suspend(sessionId: string, reason: string): Promise<void>;
+    /**
+     * Resume session
+     */
+    resume(sessionId: string): Promise<Session | null>;
+    /**
+     * Add message to session
+     */
+    addMessage(sessionId: string, message: Omit<Message, "id">): Promise<Message | null>;
+    /**
+     * Get messages for a session
+     */
+    getMessages(sessionId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<Message[]>;
+    /**
+     * Get messages fitting token budget
+     */
+    getMessagesForContext(sessionId: string, targetTokens: number): Promise<Message[]>;
+    /**
+     * Update token usage
+     */
+    updateTokenUsage(sessionId: string, usage: Partial<TokenUsage>): Promise<void>;
+    /**
+     * Get metrics for a session
+     */
+    getMetrics(sessionId: string): Promise<SessionMetrics | null>;
+    /**
+     * Get all sessions for a user
+     */
+    listByUser(userId: string): Promise<Session[]>;
+    /**
+     * Delete session
+     */
+    delete(sessionId: string): Promise<void>;
+    /**
+     * Cleanup expired sessions
+     */
+    cleanup(): Promise<number>;
+    /**
+     * Close manager
+     */
+    close(): Promise<void>;
+}
+/**
+ * Create a session manager
+ */
+export declare function createSessionManager(config?: SessionManagerConfig): SessionManager;
+//# sourceMappingURL=manager.d.ts.map

package/packages/session/dist/manager.d.ts.map

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

package/packages/session/dist/manager.js

@@ -0,0 +1,370 @@
+/**
+ * Session Manager - Manager
+ *
+ * Main session management class.
+ */
+import { randomBytes } from "node:crypto";
+import { ContextWindowManager } from "./history.js";
+import { PolicyEngine } from "./policy.js";
+import { SessionStore } from "./store.js";
+// ─── Default Configuration ─────────────────────────────────────────────────
+const DEFAULT_CONFIG = {
+    rootDir: "./sessions",
+    sessionTtlMs: 24 * 60 * 60 * 1000, // 24 hours
+    maxIdleMs: 30 * 60 * 1000, // 30 minutes
+    autoSaveIntervalMs: 5000, // 5 seconds
+    maxMessagesPerSession: 1000,
+    maxTokenBudget: 128000,
+    enableMetrics: true,
+    autoCleanup: true,
+    cleanupIntervalMs: 60 * 60 * 1000, // 1 hour
+};
+// ─── Session Manager ───────────────────────────────────────────────────────
+export class SessionManager {
+    config;
+    store;
+    policyEngine;
+    contextWindows = new Map();
+    eventListeners = new Map();
+    cleanupTimer;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.store = new SessionStore({
+            rootDir: this.config.rootDir,
+            autoSave: true,
+            autoSaveIntervalMs: this.config.autoSaveIntervalMs,
+        });
+        this.policyEngine = new PolicyEngine();
+        // Start cleanup timer
+        if (this.config.autoCleanup) {
+            this.cleanupTimer = setInterval(() => this.cleanup().catch(console.error), this.config.cleanupIntervalMs);
+        }
+    }
+    /**
+     * Generate unique session ID
+     */
+    generateId() {
+        return randomBytes(16).toString("hex");
+    }
+    /**
+     * Emit session event
+     */
+    emit(type, sessionId, data) {
+        const event = {
+            type,
+            sessionId,
+            timestamp: new Date().toISOString(),
+            data,
+        };
+        const listeners = this.eventListeners.get(type);
+        if (listeners) {
+            for (const listener of listeners) {
+                try {
+                    listener(event);
+                }
+                catch (err) {
+                    console.error("Event listener error:", err);
+                }
+            }
+        }
+    }
+    /**
+     * Add event listener
+     */
+    on(eventType, listener) {
+        let listeners = this.eventListeners.get(eventType);
+        if (!listeners) {
+            listeners = new Set();
+            this.eventListeners.set(eventType, listeners);
+        }
+        listeners.add(listener);
+    }
+    /**
+     * Remove event listener
+     */
+    off(eventType, listener) {
+        const listeners = this.eventListeners.get(eventType);
+        if (listeners) {
+            listeners.delete(listener);
+        }
+    }
+    /**
+     * Create a new session
+     */
+    async create(userId, metadata) {
+        const now = new Date().toISOString();
+        const expiresAt = new Date(Date.now() + this.config.sessionTtlMs).toISOString();
+        const session = {
+            id: this.generateId(),
+            userId,
+            status: "active",
+            createdAt: now,
+            updatedAt: now,
+            lastActivityAt: now,
+            expiresAt,
+            metadata,
+        };
+        // Create session context
+        const context = {
+            ...session,
+            messages: [],
+            tokenUsage: {
+                inputTokens: 0,
+                outputTokens: 0,
+                totalTokens: 0,
+                inputCost: 0,
+                outputCost: 0,
+                totalCost: 0,
+                tokenBudget: this.config.maxTokenBudget,
+            },
+            metrics: {
+                totalMessages: 0,
+                totalToolCalls: 0,
+                totalToolResults: 0,
+                totalTurns: 0,
+                averageLatencyMs: 0,
+                errorCount: 0,
+                retryCount: 0,
+            },
+            policyState: {
+                rateLimitRemaining: 60,
+                suspended: false,
+            },
+        };
+        // Save to store
+        await this.store.save(context);
+        // Initialize context window
+        this.contextWindows.set(session.id, new ContextWindowManager(this.config.maxTokenBudget));
+        this.emit("session:created", session.id, { userId, metadata });
+        return session;
+    }
+    /**
+     * Get session
+     */
+    async get(sessionId) {
+        return this.store.getSummary(sessionId);
+    }
+    /**
+     * Get session with full context
+     */
+    async getContext(sessionId) {
+        const context = await this.store.load(sessionId);
+        if (context) {
+            // Ensure context window exists
+            if (!this.contextWindows.has(sessionId)) {
+                const window = new ContextWindowManager(this.config.maxTokenBudget);
+                window.initialize(context.messages);
+                this.contextWindows.set(sessionId, window);
+            }
+        }
+        return context;
+    }
+    /**
+     * End a session (close it)
+     */
+    async end(sessionId) {
+        const context = await this.store.load(sessionId);
+        if (!context)
+            return;
+        context.status = "closed";
+        context.updatedAt = new Date().toISOString();
+        await this.store.save(context);
+        this.contextWindows.delete(sessionId);
+        this.policyEngine.resetState(sessionId);
+        this.emit("session:closed", sessionId);
+    }
+    /**
+     * Suspend session
+     */
+    async suspend(sessionId, reason) {
+        const context = await this.store.load(sessionId);
+        if (!context)
+            return;
+        context.status = "suspended";
+        context.updatedAt = new Date().toISOString();
+        this.policyEngine.suspend(sessionId, reason);
+        await this.store.save(context);
+        this.emit("session:suspended", sessionId, { reason });
+    }
+    /**
+     * Resume session
+     */
+    async resume(sessionId) {
+        const context = await this.store.load(sessionId);
+        if (!context)
+            return null;
+        if (context.status !== "suspended") {
+            return null;
+        }
+        context.status = "active";
+        context.updatedAt = new Date().toISOString();
+        context.lastActivityAt = new Date().toISOString();
+        this.policyEngine.resume(sessionId);
+        await this.store.save(context);
+        this.emit("session:resumed", sessionId);
+        return {
+            id: context.id,
+            userId: context.userId,
+            status: context.status,
+            createdAt: context.createdAt,
+            updatedAt: context.updatedAt,
+            lastActivityAt: context.lastActivityAt,
+            expiresAt: context.expiresAt,
+            metadata: context.metadata,
+        };
+    }
+    /**
+     * Add message to session
+     */
+    async addMessage(sessionId, message) {
+        // Check policy
+        if (!this.policyEngine.canProceed(sessionId, "message")) {
+            const violation = this.policyEngine.getViolationType(sessionId);
+            this.emit("policy:violation", sessionId, { violation });
+            return null;
+        }
+        const context = await this.store.load(sessionId);
+        if (!context)
+            return null;
+        // Get or create context window
+        let window = this.contextWindows.get(sessionId);
+        if (!window) {
+            window = new ContextWindowManager(this.config.maxTokenBudget);
+            window.initialize(context.messages);
+            this.contextWindows.set(sessionId, window);
+        }
+        // Add message
+        const fullMessage = window.add(message);
+        // Update context
+        context.messages = window.getAll();
+        context.metrics.totalMessages++;
+        context.updatedAt = new Date().toISOString();
+        context.lastActivityAt = new Date().toISOString();
+        // Record action
+        this.policyEngine.recordAction(sessionId, "message");
+        await this.store.save(context);
+        this.emit("message:added", sessionId, {
+            messageId: fullMessage.id,
+            role: fullMessage.role,
+        });
+        return fullMessage;
+    }
+    /**
+     * Get messages for a session
+     */
+    async getMessages(sessionId, options) {
+        const context = await this.store.load(sessionId);
+        if (!context)
+            return [];
+        const messages = context.messages;
+        if (options?.offset) {
+            return messages.slice(options.offset);
+        }
+        if (options?.limit) {
+            return messages.slice(-options.limit);
+        }
+        return messages;
+    }
+    /**
+     * Get messages fitting token budget
+     */
+    async getMessagesForContext(sessionId, targetTokens) {
+        let window = this.contextWindows.get(sessionId);
+        if (!window) {
+            const context = await this.store.load(sessionId);
+            if (!context)
+                return [];
+            window = new ContextWindowManager(this.config.maxTokenBudget);
+            window.initialize(context.messages);
+            this.contextWindows.set(sessionId, window);
+        }
+        return window.getMessagesForContext(targetTokens);
+    }
+    /**
+     * Update token usage
+     */
+    async updateTokenUsage(sessionId, usage) {
+        const context = await this.store.load(sessionId);
+        if (!context)
+            return;
+        context.tokenUsage = {
+            ...context.tokenUsage,
+            ...usage,
+        };
+        // Record in policy engine
+        this.policyEngine.recordTokenUsage(sessionId, context.tokenUsage);
+        // Check budget
+        if (context.tokenUsage.totalCost > this.config.maxTokenBudget / 1000) {
+            this.emit("budget:exceeded", sessionId, {
+                cost: context.tokenUsage.totalCost,
+            });
+        }
+        await this.store.save(context);
+    }
+    /**
+     * Get metrics for a session
+     */
+    async getMetrics(sessionId) {
+        const context = await this.store.load(sessionId);
+        return context?.metrics ?? null;
+    }
+    /**
+     * Get all sessions for a user
+     */
+    async listByUser(userId) {
+        return this.store.listByUser(userId);
+    }
+    /**
+     * Delete session
+     */
+    async delete(sessionId) {
+        await this.store.delete(sessionId);
+        this.contextWindows.delete(sessionId);
+        this.policyEngine.resetState(sessionId);
+    }
+    /**
+     * Cleanup expired sessions
+     */
+    async cleanup() {
+        const sessions = await this.store.listAll();
+        const now = Date.now();
+        let cleaned = 0;
+        for (const session of sessions) {
+            // Check if expired
+            if (session.expiresAt) {
+                const expiresAt = new Date(session.expiresAt).getTime();
+                if (now >= expiresAt) {
+                    await this.end(session.id);
+                    cleaned++;
+                    this.emit("session:expired", session.id);
+                }
+            }
+            // Check if idle too long
+            const lastActivity = new Date(session.lastActivityAt).getTime();
+            if (now - lastActivity > this.config.maxIdleMs) {
+                await this.suspend(session.id, "Idle timeout");
+                cleaned++;
+            }
+        }
+        // Cleanup policy engine
+        this.policyEngine.cleanup();
+        return cleaned;
+    }
+    /**
+     * Close manager
+     */
+    async close() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+        }
+        await this.store.close();
+    }
+}
+// ─── Factory Function ────────────────────────────────────────────────────
+/**
+ * Create a session manager
+ */
+export function createSessionManager(config) {
+    return new SessionManager(config);
+}
+//# sourceMappingURL=manager.js.map

package/packages/session/dist/manager.js.map

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

package/packages/session/dist/policy.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Session Manager - Policy Engine
+ *
+ * Session policy enforcement and budget tracking.
+ */
+import type { PolicyEngineConfig, PolicyState, TokenUsage } from "./types.js";
+export declare class RateLimiter {
+    private entries;
+    private readonly requestsPerMinute;
+    constructor(requestsPerMinute: number);
+    /**
+     * Check if request is allowed
+     */
+    canMakeRequest(key: string): boolean;
+    /**
+     * Record a request
+     */
+    recordRequest(key: string): void;
+    /**
+     * Get remaining requests
+     */
+    getRemaining(key: string): number;
+    /**
+     * Clear expired entries
+     */
+    clearExpired(): void;
+}
+export declare class BudgetTracker {
+    private entries;
+    /**
+     * Set budget for a key
+     */
+    setBudget(key: string, limit: number, resetAtMs: number): void;
+    /**
+     * Check if budget allows spending
+     */
+    canSpend(key: string, amount: number): boolean;
+    /**
+     * Record spending
+     */
+    recordSpend(key: string, amount: number): void;
+    /**
+     * Get remaining budget
+     */
+    getRemaining(key: string): number | null;
+    /**
+     * Get reset time
+     */
+    getResetAt(key: string): number | null;
+}
+export declare class PolicyEngine {
+    private readonly config;
+    private readonly rateLimiter;
+    private readonly budgetTracker;
+    private sessionStates;
+    constructor(config?: PolicyEngineConfig);
+    /**
+     * Get policy state for a session
+     */
+    getPolicyState(sessionId: string): PolicyState;
+    /**
+     * Check if action is allowed
+     */
+    canProceed(sessionId: string, action: "message" | "tool_call" | "session_create"): boolean;
+    /**
+     * Record an action
+     */
+    recordAction(sessionId: string, action: "message" | "tool_call"): void;
+    /**
+     * Record token usage
+     */
+    recordTokenUsage(sessionId: string, usage: TokenUsage): void;
+    /**
+     * Suspend a session
+     */
+    suspend(sessionId: string, reason: string): void;
+    /**
+     * Resume a session
+     */
+    resume(sessionId: string): void;
+    /**
+     * Reset session policy state
+     */
+    resetState(sessionId: string): void;
+    /**
+     * Set session budget
+     */
+    setSessionBudget(sessionId: string, budget: number, periodMs: number): void;
+    /**
+     * Get violation type
+     */
+    getViolationType(sessionId: string): string | null;
+    /**
+     * Check if session exceeds cost limit
+     */
+    exceedsCostLimit(sessionId: string, additionalCost: number): boolean;
+    /**
+     * Get rate limit info
+     */
+    getRateLimitInfo(sessionId: string): {
+        remaining: number;
+        resetAt: string;
+    } | null;
+    /**
+     * Clean up expired state
+     */
+    cleanup(): void;
+}
+/**
+ * Create a policy engine
+ */
+export declare function createPolicyEngine(config?: PolicyEngineConfig): PolicyEngine;
+//# sourceMappingURL=policy.d.ts.map

package/packages/session/dist/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../src/policy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAS9E,qBAAa,WAAW;IACvB,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAE/B,iBAAiB,EAAE,MAAM;IAIrC;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAWpC;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAehC;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IASjC;;OAEG;IACH,YAAY,IAAI,IAAI;CAQpB;AAUD,qBAAa,aAAa;IACzB,OAAO,CAAC,OAAO,CAAuC;IAEtD;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAQ9D;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAY9C;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAa9C;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAWxC;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;CAMtC;AAID,qBAAa,YAAY;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,aAAa,CAAuC;gBAEhD,MAAM,GAAE,kBAAuB;IAa3C;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW;IAY9C;;OAEG;IACH,UAAU,CACT,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,gBAAgB,GAChD,OAAO;IAqBV;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,IAAI;IAatE;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI;IAmB5D;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAMhD;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAM/B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAS3E;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAkBlD;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO;IAUpE;;OAEG;IACH,gBAAgB,CACf,SAAS,EAAE,MAAM,GACf;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAYhD;;OAEG;IACH,OAAO,IAAI,IAAI;CAGf;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,YAAY,CAE5E"}