conductor-bridge 1.0.0

package/dist/sync/adhd-continuity.d.ts

@@ -0,0 +1,91 @@
+/**
+ * ADHD Continuity Module
+ *
+ * Handles session breaks, momentum penalties, and context restoration.
+ * Critical for ADHD users who need seamless session resumption.
+ *
+ * Break Types:
+ * - CONTINUOUS: < 5 min, resume seamlessly
+ * - SHORT_BREAK: 5-30 min, brief recap
+ * - LONG_BREAK: 30min - 4hr, momentum penalty
+ * - NEW_SESSION: > 4hr or new day, fresh context
+ */
+import type { ParsedPlan, ParsedState } from '../parsers/types.js';
+import type { SessionState } from '../schemas/cognitive-state.js';
+import { MomentumPhase, EnergyLevel } from '../schemas/enums.js';
+export declare enum SessionBreakType {
+    CONTINUOUS = "continuous",
+    SHORT_BREAK = "short_break",
+    LONG_BREAK = "long_break",
+    NEW_SESSION = "new_session"
+}
+export interface BreakAnalysis {
+    type: SessionBreakType;
+    durationMinutes: number;
+    momentumPenalty: number;
+    recommendation: string;
+    contextStale: boolean;
+}
+export interface ResumeSummary {
+    /** Short ADHD-friendly summary */
+    summary: string;
+    /** Current track/task */
+    whereYouWere: string;
+    /** What was accomplished */
+    whatYouDid: string;
+    /** What comes next */
+    whatComesNext: string;
+    /** Any parked ideas */
+    parkedIdeas: string[];
+    /** Warnings or blockers */
+    warnings: string[];
+    /** Suggested first action */
+    firstAction: string;
+}
+export interface MomentumState {
+    phase: MomentumPhase;
+    penaltyApplied: boolean;
+    originalPhase: MomentumPhase;
+    recoveryEstimate: string;
+}
+/**
+ * Detect the type of session break based on duration.
+ */
+export declare function detectBreakType(lastActivityTimestamp: string): BreakAnalysis;
+/**
+ * Apply momentum penalty based on break duration.
+ */
+export declare function applyMomentumPenalty(currentPhase: MomentumPhase, penaltyLevels: number): MomentumState;
+/**
+ * Generate an ADHD-friendly resume summary.
+ *
+ * Designed for quick context restoration:
+ * - Short, scannable format
+ * - Key information first
+ * - Clear next action
+ */
+export declare function generateResumeSummary(plan: ParsedPlan, state: ParsedState, breakAnalysis: BreakAnalysis): ResumeSummary;
+/**
+ * Create a session handoff for cross-agent transfer.
+ *
+ * Safety constraints:
+ * - Never persist RED burnout
+ * - Auto-expire after 24 hours
+ * - Include momentum penalty info
+ */
+export declare function createSessionHandoff(sessionState: SessionState, conductorState: ParsedState, plan: ParsedPlan): {
+    canHandoff: boolean;
+    reason?: string;
+    handoffData?: {
+        sessionState: SessionState;
+        resumeSummary: string;
+        parkedIdeas: string[];
+        momentum: MomentumState;
+        expiresAt: string;
+    };
+};
+/**
+ * Get recovery recommendations based on current state.
+ */
+export declare function getRecoveryRecommendations(energy: EnergyLevel, momentum: MomentumPhase, blockedCount: number): string[];
+//# sourceMappingURL=adhd-continuity.d.ts.map

package/dist/sync/adhd-continuity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adhd-continuity.d.ts","sourceRoot":"","sources":["../../src/sync/adhd-continuity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAMjE,oBAAY,gBAAgB;IAC1B,UAAU,eAAe;IACzB,WAAW,gBAAgB;IAC3B,UAAU,eAAe;IACzB,WAAW,gBAAgB;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,gBAAgB,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,qBAAqB,EAAE,MAAM,GAC5B,aAAa,CA8Cf;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,aAAa,EAC3B,aAAa,EAAE,MAAM,GACpB,aAAa,CAgCf;AAMD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,WAAW,EAClB,aAAa,EAAE,aAAa,GAC3B,aAAa,CAkFf;AAsBD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,WAAW,EAC3B,IAAI,EAAE,UAAU,GACf;IACD,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE;QACZ,YAAY,EAAE,YAAY,CAAC;QAC3B,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,QAAQ,EAAE,aAAa,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CA6CA;AAMD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,aAAa,EACvB,YAAY,EAAE,MAAM,GACnB,MAAM,EAAE,CAiCV"}

package/dist/sync/adhd-continuity.js

@@ -0,0 +1,302 @@
+/**
+ * ADHD Continuity Module
+ *
+ * Handles session breaks, momentum penalties, and context restoration.
+ * Critical for ADHD users who need seamless session resumption.
+ *
+ * Break Types:
+ * - CONTINUOUS: < 5 min, resume seamlessly
+ * - SHORT_BREAK: 5-30 min, brief recap
+ * - LONG_BREAK: 30min - 4hr, momentum penalty
+ * - NEW_SESSION: > 4hr or new day, fresh context
+ */
+import { MomentumPhase, EnergyLevel } from '../schemas/enums.js';
+// ============================================================================
+// Types
+// ============================================================================
+export var SessionBreakType;
+(function (SessionBreakType) {
+    SessionBreakType["CONTINUOUS"] = "continuous";
+    SessionBreakType["SHORT_BREAK"] = "short_break";
+    SessionBreakType["LONG_BREAK"] = "long_break";
+    SessionBreakType["NEW_SESSION"] = "new_session";
+})(SessionBreakType || (SessionBreakType = {}));
+// ============================================================================
+// Break Detection
+// ============================================================================
+/**
+ * Detect the type of session break based on duration.
+ */
+export function detectBreakType(lastActivityTimestamp) {
+    const lastTime = new Date(lastActivityTimestamp);
+    const now = new Date();
+    const durationMs = now.getTime() - lastTime.getTime();
+    const durationMinutes = Math.round(durationMs / (1000 * 60));
+    // Check if new day
+    const isNewDay = lastTime.getDate() !== now.getDate() ||
+        lastTime.getMonth() !== now.getMonth() ||
+        lastTime.getFullYear() !== now.getFullYear();
+    let type;
+    let momentumPenalty;
+    let recommendation;
+    let contextStale;
+    if (durationMinutes < 5) {
+        type = SessionBreakType.CONTINUOUS;
+        momentumPenalty = 0;
+        recommendation = 'Resume seamlessly - you were just here!';
+        contextStale = false;
+    }
+    else if (durationMinutes < 30) {
+        type = SessionBreakType.SHORT_BREAK;
+        momentumPenalty = 1;
+        recommendation = 'Quick recap of where you left off';
+        contextStale = false;
+    }
+    else if (durationMinutes < 240 && !isNewDay) {
+        type = SessionBreakType.LONG_BREAK;
+        momentumPenalty = 2;
+        recommendation = 'Start with an easy win to rebuild momentum';
+        contextStale = true;
+    }
+    else {
+        type = SessionBreakType.NEW_SESSION;
+        momentumPenalty = 3;
+        recommendation = 'Fresh start - review goals before diving in';
+        contextStale = true;
+    }
+    return {
+        type,
+        durationMinutes,
+        momentumPenalty,
+        recommendation,
+        contextStale,
+    };
+}
+// ============================================================================
+// Momentum Penalties
+// ============================================================================
+/**
+ * Apply momentum penalty based on break duration.
+ */
+export function applyMomentumPenalty(currentPhase, penaltyLevels) {
+    const phases = [
+        MomentumPhase.CRASHED,
+        MomentumPhase.COLD_START,
+        MomentumPhase.BUILDING,
+        MomentumPhase.ROLLING,
+        MomentumPhase.PEAK,
+    ];
+    const currentIndex = phases.indexOf(currentPhase);
+    const newIndex = Math.max(0, currentIndex - penaltyLevels);
+    const newPhase = phases[newIndex];
+    let recoveryEstimate;
+    const levelsLost = currentIndex - newIndex;
+    if (levelsLost === 0) {
+        recoveryEstimate = 'No recovery needed';
+    }
+    else if (levelsLost === 1) {
+        recoveryEstimate = '1-2 tasks to recover';
+    }
+    else if (levelsLost === 2) {
+        recoveryEstimate = '3-5 tasks to recover';
+    }
+    else {
+        recoveryEstimate = 'Full warm-up needed';
+    }
+    return {
+        phase: newPhase,
+        penaltyApplied: penaltyLevels > 0 && levelsLost > 0,
+        originalPhase: currentPhase,
+        recoveryEstimate,
+    };
+}
+// ============================================================================
+// Resume Summary Generation
+// ============================================================================
+/**
+ * Generate an ADHD-friendly resume summary.
+ *
+ * Designed for quick context restoration:
+ * - Short, scannable format
+ * - Key information first
+ * - Clear next action
+ */
+export function generateResumeSummary(plan, state, breakAnalysis) {
+    // Where you were
+    const whereYouWere = state.currentAssignment
+        ? `Track: ${state.currentAssignment.track}, Task: ${state.currentAssignment.task}`
+        : 'No active assignment';
+    // What you did (completed tasks in current track)
+    const currentTrack = state.currentAssignment?.track;
+    const track = plan.tracks.find((t) => t.name === currentTrack);
+    const completedTasks = track?.tasks.filter((t) => t.state === 'complete').length ?? 0;
+    const totalTasks = track?.tasks.length ?? 0;
+    const whatYouDid = track
+        ? `Completed ${completedTasks}/${totalTasks} tasks in "${track.name}"`
+        : 'No tasks completed in current session';
+    // What comes next
+    const nextPending = track?.tasks.find((t) => t.state === 'pending');
+    const whatComesNext = nextPending
+        ? nextPending.content
+        : 'All tasks complete or blocked';
+    // Parked ideas from scratchpad
+    const parkedIdeas = [];
+    if (state.scratchpad) {
+        const parkedMatch = state.scratchpad.match(/PARKED?:?\s*\n?([\s\S]*?)(?=\n[A-Z]+:|$)/i);
+        if (parkedMatch?.[1]) {
+            parkedIdeas.push(...parkedMatch[1]
+                .split('\n')
+                .map((l) => l.replace(/^[-*]\s*/, '').trim())
+                .filter((l) => l.length > 0));
+        }
+    }
+    // Warnings
+    const warnings = [...state.warnings];
+    if (breakAnalysis.contextStale) {
+        warnings.push('Context may be stale - review recent activity');
+    }
+    // Blocked tasks
+    const blockedTasks = track?.tasks.filter((t) => t.state === 'blocked');
+    if (blockedTasks && blockedTasks.length > 0) {
+        warnings.push(`${blockedTasks.length} blocked task(s) need attention`);
+    }
+    // First action based on break type
+    let firstAction;
+    switch (breakAnalysis.type) {
+        case SessionBreakType.CONTINUOUS:
+            firstAction = nextPending
+                ? `Continue: ${nextPending.content}`
+                : 'Check for next available task';
+            break;
+        case SessionBreakType.SHORT_BREAK:
+            firstAction = 'Review current task, then continue';
+            break;
+        case SessionBreakType.LONG_BREAK:
+            firstAction = 'Start with a small, easy win to rebuild momentum';
+            break;
+        case SessionBreakType.NEW_SESSION:
+            firstAction = 'Review goals and plan before starting';
+            break;
+    }
+    // Build summary
+    const summaryParts = [
+        `Break: ${formatDuration(breakAnalysis.durationMinutes)}`,
+        `Progress: ${plan.metrics.progress}%`,
+        breakAnalysis.recommendation,
+    ];
+    return {
+        summary: summaryParts.join(' | '),
+        whereYouWere,
+        whatYouDid,
+        whatComesNext,
+        parkedIdeas,
+        warnings,
+        firstAction,
+    };
+}
+/**
+ * Format duration in human-readable form.
+ */
+function formatDuration(minutes) {
+    if (minutes < 60) {
+        return `${minutes}min`;
+    }
+    else if (minutes < 1440) {
+        const hours = Math.floor(minutes / 60);
+        const mins = minutes % 60;
+        return mins > 0 ? `${hours}h ${mins}m` : `${hours}h`;
+    }
+    else {
+        const days = Math.floor(minutes / 1440);
+        return `${days} day(s)`;
+    }
+}
+// ============================================================================
+// Session Handoff
+// ============================================================================
+/**
+ * Create a session handoff for cross-agent transfer.
+ *
+ * Safety constraints:
+ * - Never persist RED burnout
+ * - Auto-expire after 24 hours
+ * - Include momentum penalty info
+ */
+export function createSessionHandoff(sessionState, conductorState, plan) {
+    // Safety: Never handoff RED burnout
+    if (sessionState.burnout_level === 'RED') {
+        return {
+            canHandoff: false,
+            reason: 'Cannot create handoff with RED burnout level. User should recover first.',
+        };
+    }
+    // Detect break (using current time as "last activity")
+    const breakAnalysis = detectBreakType(new Date().toISOString());
+    // Generate resume summary
+    const resumeSummary = generateResumeSummary(plan, conductorState, breakAnalysis);
+    // Apply momentum penalty (assume some penalty for handoff)
+    const momentumState = applyMomentumPenalty(sessionState.momentum_phase, 1 // Handoffs always have at least 1 level penalty
+    );
+    // Set expiry (24 hours)
+    const expiresAt = new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString();
+    return {
+        canHandoff: true,
+        handoffData: {
+            sessionState: {
+                ...sessionState,
+                momentum_phase: momentumState.phase,
+            },
+            resumeSummary: [
+                resumeSummary.summary,
+                '',
+                `Where you were: ${resumeSummary.whereYouWere}`,
+                `What you did: ${resumeSummary.whatYouDid}`,
+                `Next: ${resumeSummary.whatComesNext}`,
+                '',
+                `First action: ${resumeSummary.firstAction}`,
+            ].join('\n'),
+            parkedIdeas: resumeSummary.parkedIdeas,
+            momentum: momentumState,
+            expiresAt,
+        },
+    };
+}
+// ============================================================================
+// Recovery Recommendations
+// ============================================================================
+/**
+ * Get recovery recommendations based on current state.
+ */
+export function getRecoveryRecommendations(energy, momentum, blockedCount) {
+    const recommendations = [];
+    // Energy-based recommendations
+    if (energy === EnergyLevel.DEPLETED) {
+        recommendations.push('Take a real break - rest is productive');
+        recommendations.push('Consider calling it a day');
+        recommendations.push("If continuing: only easy, familiar tasks");
+    }
+    else if (energy === EnergyLevel.LOW) {
+        recommendations.push('Switch to easier tasks');
+        recommendations.push('Consider a 15-minute break');
+        recommendations.push('Avoid starting complex new work');
+    }
+    // Momentum-based recommendations
+    if (momentum === MomentumPhase.CRASHED) {
+        recommendations.push('No judgment - momentum crashes happen');
+        recommendations.push("Tomorrow is fine if today isn't working");
+        recommendations.push('If continuing: start with smallest possible task');
+    }
+    else if (momentum === MomentumPhase.COLD_START) {
+        recommendations.push('Pick one small, clear task to start');
+        recommendations.push('Avoid context-heavy work until warmed up');
+    }
+    // Blocker-based recommendations
+    if (blockedCount > 0) {
+        recommendations.push(`${blockedCount} blocked task(s) - document blockers clearly`);
+        if (blockedCount > 2) {
+            recommendations.push('Consider if blockers indicate scope issues');
+        }
+    }
+    return recommendations;
+}
+//# sourceMappingURL=adhd-continuity.js.map

package/dist/sync/adhd-continuity.js.map

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

package/dist/sync/convergence-tracker.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Convergence Tracker
+ *
+ * Tracks RC^+xi convergence in the Conductor context.
+ * Measures epistemic tension and detects attractor basins.
+ *
+ * Formula: xi_n = ||A_{n+1} - A_n||_2 (epistemic tension)
+ * Epsilon: 0.1 (convergence threshold)
+ * Stable: 3 exchanges at xi < epsilon = CONVERGED
+ *
+ * DETERMINISM GUARANTEES (ThinkingMachines [He2025] compliance):
+ *
+ * 1. FIXED STATE VECTOR ORDER: The 6-dimensional state vector is computed
+ *    in a hardcoded order: [progress, blocked, active, trackCompletion,
+ *    momentum, energy]. This order never changes.
+ *
+ * 2. FIXED REDUCTION SEQUENCE: L2 norm uses Array.reduce() which processes
+ *    elements left-to-right per ECMAScript spec. Same inputs → same output.
+ *
+ * 3. FIXED ATTRACTOR PRIORITY: Attractor detection evaluates conditions in
+ *    fixed order: RECOVERY > EXPLORING > TEACHING > FOCUSED.
+ *    First match wins, no dynamic reordering.
+ *
+ * 4. CONSTANT THRESHOLDS: EPSILON (0.1), STABLE_EXCHANGES_REQUIRED (3),
+ *    normalization divisors (5, 3) are compile-time constants.
+ *
+ * Reference: [He2025] "Defeating Nondeterminism in LLM Inference"
+ * https://thinkingmachines.ai/blog/defeating-nondeterminism-in-llm-inference/
+ */
+import type { ParsedPlan } from '../parsers/types.js';
+import type { SessionState, ConvergenceRecord } from '../schemas/cognitive-state.js';
+import { ConvergenceAttractor, ConvergenceStability } from '../schemas/enums.js';
+export interface StateVector {
+    /** Progress ratio (0-1) */
+    progress: number;
+    /** Blocked ratio (0-1) */
+    blocked: number;
+    /** Active ratio (0-1) */
+    active: number;
+    /** Track completion ratio (0-1) */
+    trackCompletion: number;
+    /** Momentum numeric (0-5) */
+    momentum: number;
+    /** Energy numeric (0-3) */
+    energy: number;
+}
+export interface ConvergenceState {
+    xi_n: number;
+    attractor: ConvergenceAttractor;
+    stability: ConvergenceStability;
+    stableExchangeCount: number;
+    isConverged: boolean;
+    trajectory: number[];
+}
+/**
+ * Extract state vector from plan and cognitive state.
+ */
+export declare function extractStateVector(plan: ParsedPlan, cognitiveState?: SessionState): StateVector;
+/**
+ * Compute L2 norm between two state vectors.
+ */
+export declare function computeL2Norm(v1: StateVector, v2: StateVector): number;
+/**
+ * Detect which attractor basin the current state is in.
+ *
+ * Attractors:
+ * - focused: High progress, low blocked, steady momentum
+ * - exploring: Active work, building momentum
+ * - recovery: Low energy, crashed momentum
+ * - teaching: (Not derived from tasks, set explicitly)
+ */
+export declare function detectAttractor(vector: StateVector, cognitiveState?: SessionState): ConvergenceAttractor;
+/**
+ * Convergence tracker class.
+ *
+ * Maintains state across exchanges and detects convergence.
+ */
+export declare class ConductorConvergenceTracker {
+    private previousVector;
+    private trajectory;
+    private stableCount;
+    private currentAttractor;
+    /**
+     * Record an exchange and compute convergence metrics.
+     */
+    recordExchange(plan: ParsedPlan, cognitiveState?: SessionState): ConvergenceState;
+    /**
+     * Get RC^+xi glyph for display.
+     *
+     * Format: RC^+xi[attractor:stability:xi]
+     * Example: RC^+xi[focused:stable:0.05]
+     */
+    getGlyph(): string;
+    /**
+     * Create a convergence record for persistence.
+     */
+    createRecord(sessionId: string, exchangeNumber: number, cognitiveState?: SessionState): ConvergenceRecord;
+    /**
+     * Reset tracker state.
+     */
+    reset(): void;
+}
+/**
+ * Analyze convergence trajectory for insights.
+ */
+export declare function analyzeTrajectory(trajectory: number[]): {
+    trend: 'improving' | 'stable' | 'degrading';
+    averageXi: number;
+    volatility: number;
+};
+//# sourceMappingURL=convergence-tracker.d.ts.map

package/dist/sync/convergence-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convergence-tracker.d.ts","sourceRoot":"","sources":["../../src/sync/convergence-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAwB,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAiB,MAAM,qBAAqB,CAAC;AAMhG,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,oBAAoB,CAAC;IAChC,SAAS,EAAE,oBAAoB,CAAC;IAChC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAgCD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,EAChB,cAAc,CAAC,EAAE,YAAY,GAC5B,WAAW,CAsCb;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,WAAW,GAAG,MAAM,CAYtE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,EACnB,cAAc,CAAC,EAAE,YAAY,GAC5B,oBAAoB,CA2BtB;AAMD;;;;GAIG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,gBAAgB,CAAsD;IAE9E;;OAEG;IACH,cAAc,CACZ,IAAI,EAAE,UAAU,EAChB,cAAc,CAAC,EAAE,YAAY,GAC5B,gBAAgB;IAwDnB;;;;;OAKG;IACH,QAAQ,IAAI,MAAM;IAWlB;;OAEG;IACH,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,YAAY,GAC5B,iBAAiB;IAsBpB;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG;IACvD,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAqCA"}