pi-harness-runtime 0.10.7 → 0.10.12

package/packages/checkpoint/README.md

@@ -1,206 +0,0 @@
-# @pi/checkpoint
-
-Enhanced checkpoint system with incremental snapshots, diff-based storage, compression, and intelligent recovery strategies.
-
-## Features
-
-- **Incremental Checkpoints** - Only store changes, reducing storage by 60%+
-- **Compression** - Optional gzip compression for large checkpoints
-- **Checksum Verification** - Detect corruption with SHA-256 checksums
-- **Multiple Recovery Strategies** - Latest, fullest, specific version, or by timestamp
-- **Auto-Pruning** - Automatically clean up old checkpoints
-- **State Diffing** - Efficient incremental updates
-
-## Installation
-
-```bash
-npm install @pi/checkpoint
-```
-
-## Quick Start
-
-### Basic Usage
-
-```typescript
-import { createCheckpointEngine } from "@pi/checkpoint";
-
-const engine = createCheckpointEngine({
-  rootDir: "./checkpoints",
-  compression: true,
-  incremental: true,
-  maxCheckpoints: 10,
-});
-
-// Save a checkpoint
-const state = {
-  version: 1,
-  jobId: "job-123",
-  status: "running",
-  requirement: "Build a web app",
-  tasks: [],
-  createdAt: new Date().toISOString(),
-  updatedAt: new Date().toISOString(),
-};
-
-await engine.save("job-123", state);
-
-// Load the latest checkpoint
-const recovered = await engine.load("job-123");
-console.log(recovered?.status); // "running"
-```
-
-### Recovery Strategies
-
-```typescript
-import { createCheckpointEngine, RecoveryStrategy } from "@pi/checkpoint";
-
-// Recover using latest checkpoint
-const result1 = await engine.recover("job-123", "latest");
-
-// Recover using checkpoint with most completed tasks
-const result2 = await engine.recover("job-123", "fullest");
-
-// Recover specific version
-const result3 = await engine.recover("job-123", "specific:5");
-
-// Recover closest to a timestamp
-const result4 = await engine.recover("job-123", "timestamp:2024-01-15T10:00:00Z");
-
-if (result.success) {
-  console.log(`Recovered state at version ${result.recoveredVersion}`);
-  console.log(`Recovery took ${result.recoveryTimeMs}ms`);
-}
-```
-
-### Incremental Checkpoints
-
-```typescript
-const engine = createCheckpointEngine({
-  rootDir: "./checkpoints",
-  incremental: true, // Enable incremental snapshots
-  compression: true,
-});
-
-// Save creates incremental or full checkpoint automatically
-await engine.save("job-123", updatedState);
-
-// Check metadata
-const metadata = await engine.getMetadata("job-123");
-console.log(metadata.map((m) => ({
-  version: m.version,
-  type: m.type, // "full" or "incremental"
-  sizeBytes: m.sizeBytes,
-  taskProgress: m.taskProgress,
-})));
-```
-
-### Verification & Pruning
-
-```typescript
-// Verify a checkpoint
-const verified = await engine.verify("job-123", 5);
-console.log(`Valid: ${verified.valid}, Checksum: ${verified.checksumMatch}`);
-
-// Prune old checkpoints (keep last 5)
-const pruneResult = await engine.prune("job-123", 5);
-console.log(`Deleted ${pruneResult.deletedCount} checkpoints`);
-console.log(`Freed ${pruneResult.freedBytes} bytes`);
-```
-
-## API Reference
-
-### CheckpointEngine
-
-```typescript
-const engine = createCheckpointEngine({
-  rootDir: string;           // Checkpoint storage directory
-  compression?: boolean;     // Enable gzip compression (default: true)
-  incremental?: boolean;     // Enable incremental snapshots (default: true)
-  maxCheckpoints?: number;  // Max checkpoints to keep (default: 10)
-  autoPrune?: boolean;       // Auto-prune on save (default: true)
-  checksumAlgorithm?: "md5" | "sha256"; // Checksum algorithm (default: "sha256")
-  parallelWrites?: boolean; // Parallel file I/O (default: true)
-});
-```
-
-### Methods
-
-```typescript
-// Save checkpoint (auto-selects full or incremental)
-await engine.save(jobId, state): Promise<CheckpointMetadata>;
-
-// Load latest checkpoint
-await engine.load(jobId): Promise<RuntimeState | null>;
-
-// Load specific version
-await engine.loadState(jobId, version): Promise<RuntimeState | null>;
-
-// Recover using strategy
-await engine.recover(jobId, strategy): Promise<RecoveryResult>;
-
-// Verify checkpoint integrity
-await engine.verify(jobId, version): Promise<VerificationResult>;
-
-// Prune old checkpoints
-await engine.prune(jobId, keepCount): Promise<PruneResult>;
-
-// Get metadata for all checkpoints
-await engine.getMetadata(jobId): Promise<CheckpointMetadata[]>;
-
-// Delete all checkpoints
-await engine.deleteAll(jobId): Promise<void>;
-```
-
-### Recovery Strategies
-
-```typescript
-type RecoveryStrategy =
-  | "latest"              // Most recent checkpoint
-  | "fullest"             // Checkpoint with most completed tasks
-  | "specific:number"     // Specific version number
-  | "timestamp:ISO"       // Checkpoint closest to timestamp
-  | "interactive";        // User selection (returns latest for now)
-```
-
-### Checkpoint Metadata
-
-```typescript
-interface CheckpointMetadata {
-  jobId: string;
-  version: number;
-  type: "full" | "incremental";
-  sizeBytes: number;
-  compressed: boolean;
-  checksum: string;
-  taskProgress: {
-    total: number;
-    completed: number;
-    failed: number;
-    running: number;
-  };
-  createdAt: string;
-  baseVersion?: number; // For incremental checkpoints
-}
-```
-
-## Storage Format
-
-Checkpoints are stored as JSON files:
-
-```
-checkpoints/
-+-- jobs/
-    +-- job-123/
-        +-- index.json              # Checkpoint index
-        +-- checkpoint-1.json      # Full checkpoint
-        +-- checkpoint-2.delta.json # Incremental checkpoint
-        +-- checkpoint-3.json      # Full checkpoint
-```
-
-## Performance
-
-| Metric | Full Checkpoint | Incremental |
-| -------- | ---------------- | ------------- |
-| Storage | Baseline | 60-80% reduction |
-| Write Speed | Baseline | 30-50% faster |
-| Read Speed | Baseline |

package/packages/checkpoint/dist/checkpoint-manager.d.ts

@@ -1,22 +0,0 @@
-/**
- * Legacy Checkpoint Manager
- *
- * @deprecated Use CheckpointEngine instead
- */
-export declare class JsonCheckpointManager {
-    private readonly rootDir;
-    constructor(rootDir: string);
-    /**
-     * Get the root directory
-     */
-    getRootDir(): string;
-    /**
-     * @deprecated Use CheckpointEngine.save() instead
-     */
-    save(_checkpoint: unknown): Promise<void>;
-    /**
-     * @deprecated Use CheckpointEngine.load() instead
-     */
-    load(_jobId: string): Promise<unknown | null>;
-}
-//# sourceMappingURL=checkpoint-manager.d.ts.map

package/packages/checkpoint/dist/checkpoint-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"checkpoint-manager.d.ts","sourceRoot":"","sources":["../src/checkpoint-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,qBAAqB;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAApC,YAA6B,OAAO,EAAE,MAAM,EAAI;IAEhD;;OAEG;IACH,UAAU,IAAI,MAAM,CAEnB;IAED;;OAEG;IACG,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9C;IAED;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAIlD;CACD"}

package/packages/checkpoint/dist/checkpoint-manager.js

@@ -1,30 +0,0 @@
-/**
- * Legacy Checkpoint Manager
- *
- * @deprecated Use CheckpointEngine instead
- */
-export class JsonCheckpointManager {
-    rootDir;
-    constructor(rootDir) {
-        this.rootDir = rootDir;
-    }
-    /**
-     * Get the root directory
-     */
-    getRootDir() {
-        return this.rootDir;
-    }
-    /**
-     * @deprecated Use CheckpointEngine.save() instead
-     */
-    async save(_checkpoint) {
-        throw new Error("Legacy JsonCheckpointManager is deprecated. Use CheckpointEngine instead.");
-    }
-    /**
-     * @deprecated Use CheckpointEngine.load() instead
-     */
-    async load(_jobId) {
-        throw new Error("Legacy JsonCheckpointManager is deprecated. Use CheckpointEngine instead.");
-    }
-}
-//# sourceMappingURL=checkpoint-manager.js.map

package/packages/checkpoint/dist/checkpoint-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"checkpoint-manager.js","sourceRoot":"","sources":["../src/checkpoint-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,qBAAqB;IACJ,OAAO;IAApC,YAA6B,OAAe;uBAAf,OAAO;IAAW,CAAC;IAEhD;;OAEG;IACH,UAAU;QACT,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,WAAoB;QAC9B,MAAM,IAAI,KAAK,CACd,2EAA2E,CAC3E,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAAc;QACxB,MAAM,IAAI,KAAK,CACd,2EAA2E,CAC3E,CAAC;IACH,CAAC;CACD"}

package/packages/checkpoint/dist/differ.d.ts

@@ -1,48 +0,0 @@
-/**
- * Checkpoint Engine - Differ
- *
- * Calculate state diffs for incremental checkpoints.
- */
-import type { RuntimeState, StateDelta } from "./types.js";
-export declare class DiffCalculator {
-    /**
-     * Calculate diff between two states
-     */
-    calculateDiff(jobId: string, baseVersion: number, targetVersion: number, baseState: RuntimeState, targetState: RuntimeState): StateDelta;
-    /**
-     * Calculate task deltas
-     */
-    private calculateTaskDeltas;
-    /**
-     * Check if two tasks are different
-     */
-    private tasksAreDifferent;
-    /**
-     * Calculate checksum for delta
-     */
-    private calculateChecksum;
-    /**
-     * Apply delta to base state
-     */
-    applyDelta(baseState: RuntimeState, delta: StateDelta): RuntimeState;
-    /**
-     * Apply task deltas to task list
-     */
-    private applyTaskDeltas;
-    /**
-     * Reconstruct state from incremental checkpoints
-     */
-    reconstructState(fullCheckpoint: RuntimeState, deltas: StateDelta[]): Promise<RuntimeState>;
-    /**
-     * Estimate size of delta vs full checkpoint
-     */
-    estimateDeltaSavings(fullSize: number, baseState: RuntimeState, targetState: RuntimeState): {
-        deltaSize: number;
-        savingsPercent: number;
-    };
-}
-/**
- * Create a diff calculator
- */
-export declare function createDiffCalculator(): DiffCalculator;
-//# sourceMappingURL=differ.d.ts.map

package/packages/checkpoint/dist/differ.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"differ.d.ts","sourceRoot":"","sources":["../src/differ.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,YAAY,EACZ,UAAU,EAGV,MAAM,YAAY,CAAC;AAKpB,qBAAa,cAAc;IAC1B;;OAEG;IACH,aAAa,CACZ,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,YAAY,EACvB,WAAW,EAAE,YAAY,GACvB,UAAU,CAoDZ;IAED;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4C3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,GAAG,YAAY,CA6BnE;IAED;;OAEG;IACH,OAAO,CAAC,eAAe;IA6BvB;;OAEG;IACG,gBAAgB,CACrB,cAAc,EAAE,YAAY,EAC5B,MAAM,EAAE,UAAU,EAAE,GAClB,OAAO,CAAC,YAAY,CAAC,CAavB;IAED;;OAEG;IACH,oBAAoB,CACnB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,YAAY,EACvB,WAAW,EAAE,YAAY,GACvB;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAiB/C;CACD;AAID;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAErD"}

package/packages/checkpoint/dist/differ.js

@@ -1,197 +0,0 @@
-/**
- * Checkpoint Engine - Differ
- *
- * Calculate state diffs for incremental checkpoints.
- */
-import { createHash } from "node:crypto";
-// --- Diff Calculator -----------------------------------------------------
-export class DiffCalculator {
-    /**
-     * Calculate diff between two states
-     */
-    calculateDiff(jobId, baseVersion, targetVersion, baseState, targetState) {
-        const changes = {};
-        // Check status change
-        if (baseState.status !== targetState.status) {
-            changes.status = targetState.status;
-        }
-        // Calculate task changes
-        const taskDeltas = this.calculateTaskDeltas(baseState.tasks, targetState.tasks);
-        if (taskDeltas.length > 0) {
-            changes.tasks = taskDeltas;
-        }
-        // Check metadata changes
-        if (JSON.stringify(baseState.metadata) !==
-            JSON.stringify(targetState.metadata)) {
-            changes.metadata = targetState.metadata;
-        }
-        // Check for errors
-        if (baseState.lastError !== targetState.lastError) {
-            changes.errors = [
-                {
-                    error: targetState.lastError ?? "",
-                    timestamp: targetState.updatedAt,
-                    recoverable: targetState.status === "blocked",
-                },
-            ];
-        }
-        const timestamp = new Date().toISOString();
-        const checksum = this.calculateChecksum(jobId, baseVersion, targetVersion, changes);
-        return {
-            jobId,
-            baseVersion,
-            targetVersion,
-            changes,
-            timestamp,
-            checksum,
-        };
-    }
-    /**
-     * Calculate task deltas
-     */
-    calculateTaskDeltas(baseTasks, targetTasks) {
-        const deltas = [];
-        const baseMap = new Map(baseTasks.map((t) => [t.id, t]));
-        const targetMap = new Map(targetTasks.map((t) => [t.id, t]));
-        // Find added and updated tasks
-        for (const [taskId, targetTask] of targetMap) {
-            const baseTask = baseMap.get(taskId);
-            if (!baseTask) {
-                // Task was added
-                deltas.push({
-                    taskId,
-                    action: "added",
-                    after: targetTask,
-                });
-            }
-            else if (this.tasksAreDifferent(baseTask, targetTask)) {
-                // Task was updated
-                deltas.push({
-                    taskId,
-                    action: "updated",
-                    before: baseTask,
-                    after: targetTask,
-                });
-            }
-        }
-        // Find removed tasks
-        for (const [taskId, baseTask] of baseMap) {
-            if (!targetMap.has(taskId)) {
-                deltas.push({
-                    taskId,
-                    action: "removed",
-                    before: baseTask,
-                });
-            }
-        }
-        return deltas;
-    }
-    /**
-     * Check if two tasks are different
-     */
-    tasksAreDifferent(a, b) {
-        return (a.status !== b.status ||
-            a.title !== b.title ||
-            a.description !== b.description ||
-            a.assignedProvider !== b.assignedProvider ||
-            a.worktreePath !== b.worktreePath);
-    }
-    /**
-     * Calculate checksum for delta
-     */
-    calculateChecksum(jobId, baseVersion, targetVersion, changes) {
-        const data = JSON.stringify({
-            jobId,
-            baseVersion,
-            targetVersion,
-            changes,
-            timestamp: new Date().toISOString(),
-        });
-        return createHash("sha256").update(data).digest("hex");
-    }
-    /**
-     * Apply delta to base state
-     */
-    applyDelta(baseState, delta) {
-        const result = { ...baseState };
-        // Apply status change
-        if (delta.changes.status !== undefined) {
-            result.status = delta.changes.status;
-        }
-        // Apply task changes
-        if (delta.changes.tasks) {
-            result.tasks = this.applyTaskDeltas(baseState.tasks, delta.changes.tasks);
-        }
-        // Apply metadata changes
-        if (delta.changes.metadata !== undefined) {
-            result.metadata = delta.changes.metadata;
-        }
-        // Apply error changes
-        if (delta.changes.errors && delta.changes.errors.length > 0) {
-            const lastError = delta.changes.errors[delta.changes.errors.length - 1];
-            result.lastError = lastError.error;
-        }
-        // Update version and timestamp
-        result.version = delta.targetVersion;
-        result.updatedAt = new Date().toISOString();
-        return result;
-    }
-    /**
-     * Apply task deltas to task list
-     */
-    applyTaskDeltas(tasks, taskDeltas) {
-        const taskMap = new Map(tasks.map((t) => [t.id, { ...t }]));
-        for (const delta of taskDeltas) {
-            switch (delta.action) {
-                case "added":
-                    if (delta.after) {
-                        taskMap.set(delta.taskId, delta.after);
-                    }
-                    break;
-                case "updated":
-                    if (delta.after) {
-                        taskMap.set(delta.taskId, delta.after);
-                    }
-                    break;
-                case "removed":
-                    taskMap.delete(delta.taskId);
-                    break;
-            }
-        }
-        return Array.from(taskMap.values());
-    }
-    /**
-     * Reconstruct state from incremental checkpoints
-     */
-    async reconstructState(fullCheckpoint, deltas) {
-        // Sort deltas by version
-        const sortedDeltas = [...deltas].sort((a, b) => a.targetVersion - b.targetVersion);
-        // Apply each delta in order
-        let state = fullCheckpoint;
-        for (const delta of sortedDeltas) {
-            state = this.applyDelta(state, delta);
-        }
-        return state;
-    }
-    /**
-     * Estimate size of delta vs full checkpoint
-     */
-    estimateDeltaSavings(fullSize, baseState, targetState) {
-        const delta = this.calculateDiff(targetState.jobId, baseState.version, targetState.version, baseState, targetState);
-        const deltaJson = JSON.stringify(delta);
-        const deltaSize = Buffer.byteLength(deltaJson);
-        const savingsPercent = ((fullSize - deltaSize) / fullSize) * 100;
-        return {
-            deltaSize,
-            savingsPercent: Math.max(0, savingsPercent),
-        };
-    }
-}
-// --- Factory Function ----------------------------------------------------
-/**
- * Create a diff calculator
- */
-export function createDiffCalculator() {
-    return new DiffCalculator();
-}
-//# sourceMappingURL=differ.js.map

package/packages/checkpoint/dist/differ.js.map

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

package/packages/checkpoint/dist/engine.d.ts

@@ -1,74 +0,0 @@
-/**
- * Checkpoint Engine - Engine
- *
- * Main checkpoint engine with recovery strategies.
- */
-import type { CheckpointEngineConfig, CheckpointMetadata, PruneResult, RecoveryResult, RecoveryStrategy, RuntimeState, StateDelta, VerificationResult } from "./types.js";
-export declare class CheckpointEngine {
-    private readonly config;
-    private readonly storage;
-    private readonly differ;
-    private lastStates;
-    constructor(config: CheckpointEngineConfig);
-    /**
-     * Get current version for a job
-     */
-    private getCurrentVersion;
-    /**
-     * Create metadata for a checkpoint
-     */
-    private createMetadata;
-    /**
-     * Save a checkpoint (full or incremental based on config)
-     */
-    save(jobId: string, state: RuntimeState): Promise<CheckpointMetadata>;
-    /**
-     * Decide if we should use a full checkpoint
-     */
-    private shouldUseFullCheckpoint;
-    /**
-     * Save an incremental checkpoint explicitly
-     */
-    saveIncremental(jobId: string, delta: StateDelta): Promise<CheckpointMetadata>;
-    /**
-     * Load the latest state for a job
-     */
-    load(jobId: string): Promise<RuntimeState | null>;
-    /**
-     * Load state at specific version
-     */
-    loadState(jobId: string, version: number): Promise<RuntimeState | null>;
-    /**
-     * Reconstruct state from incremental checkpoint
-     */
-    private reconstructFromIncremental;
-    /**
-     * Recover job state using specified strategy
-     */
-    recover(jobId: string, strategy: RecoveryStrategy): Promise<RecoveryResult>;
-    /**
-     * Verify a checkpoint
-     */
-    verify(jobId: string, version: number): Promise<VerificationResult>;
-    /**
-     * Prune old checkpoints
-     */
-    prune(jobId: string, keepCount: number): Promise<PruneResult>;
-    /**
-     * Get metadata for all checkpoints
-     */
-    getMetadata(jobId: string): Promise<CheckpointMetadata[]>;
-    /**
-     * Get cached last state
-     */
-    getLastState(jobId: string): RuntimeState | undefined;
-    /**
-     * Delete all checkpoints for a job
-     */
-    deleteAll(jobId: string): Promise<void>;
-}
-/**
- * Create a checkpoint engine
- */
-export declare function createCheckpointEngine(config?: CheckpointEngineConfig): CheckpointEngine;
-//# sourceMappingURL=engine.d.ts.map

package/packages/checkpoint/dist/engine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,sBAAsB,EACtB,kBAAkB,EAIlB,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,MAAM,YAAY,CAAC;AAmBpB,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,UAAU,CAAwC;IAE1D,YAAY,MAAM,EAAE,sBAAsB,EAOzC;IAED;;OAEG;YACW,iBAAiB;IAK/B;;OAEG;IACH,OAAO,CAAC,cAAc;IA0BtB;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAsF1E;IAED;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;OAEG;IACG,eAAe,CACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,UAAU,GACf,OAAO,CAAC,kBAAkB,CAAC,CAoB7B;IAED;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAKtD;IAED;;OAEG;IACG,SAAS,CACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAU9B;IAED;;OAEG;YACW,0BAA0B;IAoDxC;;OAEG;IACG,OAAO,CACZ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,gBAAgB,GACxB,OAAO,CAAC,cAAc,CAAC,CAkGzB;IAED;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8BxE;IAED;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwClE;IAED;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAE9D;IAED;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEpD;IAED;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5C;CACD;AAID;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,GAAE,sBAA2B,GACjC,gBAAgB,CAElB"}