pi-harness-runtime 0.10.12 → 0.10.13

package/packages/capability-registry/dist/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Capability Registry Types (RFC-0051)
+ */
+export type Capability = "code_generation" | "code_review" | "planning" | "test_generation" | "e2e_testing" | "refactoring" | "analysis" | "debugging" | "documentation" | "vision" | "function_calling" | "json_mode" | "streaming";
+export type Latency = "fast" | "medium" | "slow";
+export interface CapabilityProfile {
+    capability: Capability;
+    score: number;
+    latency: Latency;
+    contextWindow: number;
+    maxOutputTokens: number;
+}
+export interface CapabilityQuery {
+    minScore?: number;
+    maxLatency?: Latency;
+    requiresContextWindow?: number;
+    requiresMaxOutput?: number;
+}
+export interface ModelWithCapability {
+    providerId: string;
+    modelId: string;
+    profile: CapabilityProfile;
+}
+export interface CapabilityRegistry {
+    register(providerId: string, modelId: string, capabilities: CapabilityProfile[]): void;
+    unregister(providerId: string, modelId: string): void;
+    getCapabilities(providerId: string, modelId: string): CapabilityProfile[];
+    query(capability: Capability, requirements?: CapabilityQuery): ModelWithCapability[];
+    listProviders(): string[];
+    listModels(providerId: string): string[];
+}
+export type CapabilityRegistryEvent = {
+    type: "capability.registered";
+    providerId: string;
+    modelId: string;
+    count: number;
+} | {
+    type: "capability.unregistered";
+    providerId: string;
+    modelId: string;
+} | {
+    type: "capability.queried";
+    capability: Capability;
+    results: number;
+};
+export declare const LATENCY_RANK: Record<Latency, number>;
+//# sourceMappingURL=types.d.ts.map

package/packages/capability-registry/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,MAAM,UAAU,GACnB,iBAAiB,GACjB,aAAa,GACb,UAAU,GACV,iBAAiB,GACjB,aAAa,GACb,aAAa,GACb,UAAU,GACV,WAAW,GACX,eAAe,GACf,QAAQ,GACR,kBAAkB,GAClB,WAAW,GACX,WAAW,CAAC;AAEf,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,iBAAiB,CAAC;CAC3B;AAID,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CACP,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,iBAAiB,EAAE,GAC/B,IAAI,CAAC;IACR,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACtD,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAC;IAC1E,KAAK,CACJ,UAAU,EAAE,UAAU,EACtB,YAAY,CAAC,EAAE,eAAe,GAC5B,mBAAmB,EAAE,CAAC;IACzB,aAAa,IAAI,MAAM,EAAE,CAAC;IAC1B,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACzC;AAID,MAAM,MAAM,uBAAuB,GAChC;IACA,IAAI,EAAE,uBAAuB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACb,GACD;IAAE,IAAI,EAAE,yBAAyB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAI3E,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAIhD,CAAC"}

package/packages/capability-registry/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * Capability Registry Types (RFC-0051)
+ */
+// --- Latency Ranking -------------------------------------------------
+export const LATENCY_RANK = {
+    fast: 1,
+    medium: 2,
+    slow: 3,
+};
+//# sourceMappingURL=types.js.map

package/packages/capability-registry/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0EH,wEAAwE;AAExE,MAAM,CAAC,MAAM,YAAY,GAA4B;IACpD,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;CACP,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,30 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,48 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,197 @@
+/**
+ * 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

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

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

@@ -0,0 +1,74 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}