agentic-qe 2.7.3 → 2.8.0

package/dist/edge/p2p/crdt/types.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * CRDT Types for P2P Conflict Resolution
+ *
+ * Type definitions for Conflict-free Replicated Data Types (CRDTs)
+ * enabling automatic conflict resolution in distributed pattern storage.
+ *
+ * @module edge/p2p/crdt/types
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CRDTError = exports.CRDTErrorCode = exports.CRDTEventType = exports.DEFAULT_STORE_CONFIG = exports.DeltaOpType = exports.ResolutionStrategy = exports.ConflictType = exports.VectorClockComparison = exports.CRDTType = exports.MAX_MERGE_DEPTH = exports.DEFAULT_TOMBSTONE_TTL = exports.MAX_VECTOR_CLOCK_SIZE = exports.CRDT_PROTOCOL_VERSION = void 0;
+// ============================================
+// Constants
+// ============================================
+/**
+ * CRDT protocol version
+ */
+exports.CRDT_PROTOCOL_VERSION = '1.0.0';
+/**
+ * Maximum vector clock entries before compaction
+ */
+exports.MAX_VECTOR_CLOCK_SIZE = 1000;
+/**
+ * Default tombstone TTL in milliseconds (7 days)
+ */
+exports.DEFAULT_TOMBSTONE_TTL = 7 * 24 * 60 * 60 * 1000;
+/**
+ * Maximum merge depth for recursive structures
+ */
+exports.MAX_MERGE_DEPTH = 100;
+// ============================================
+// CRDT Type Enumeration
+// ============================================
+/**
+ * Types of CRDTs supported by the system
+ */
+var CRDTType;
+(function (CRDTType) {
+    /** Grow-only counter - can only increment */
+    CRDTType["GCounter"] = "g-counter";
+    /** Positive-Negative counter - supports increment and decrement */
+    CRDTType["PNCounter"] = "pn-counter";
+    /** Last-Writer-Wins Register - timestamp-based resolution */
+    CRDTType["LWWRegister"] = "lww-register";
+    /** Observed-Remove Set - handles concurrent add/remove */
+    CRDTType["ORSet"] = "or-set";
+    /** Multi-Value Register - preserves concurrent writes */
+    CRDTType["MVRegister"] = "mv-register";
+    /** Last-Writer-Wins Map - nested LWW registers */
+    CRDTType["LWWMap"] = "lww-map";
+    /** Pattern CRDT - specialized for SharedPattern objects */
+    CRDTType["PatternCRDT"] = "pattern-crdt";
+})(CRDTType || (exports.CRDTType = CRDTType = {}));
+/**
+ * Comparison result for vector clocks
+ */
+var VectorClockComparison;
+(function (VectorClockComparison) {
+    /** Clocks are equal */
+    VectorClockComparison["Equal"] = "equal";
+    /** First clock happened before second */
+    VectorClockComparison["Before"] = "before";
+    /** First clock happened after second */
+    VectorClockComparison["After"] = "after";
+    /** Clocks are concurrent (incomparable) */
+    VectorClockComparison["Concurrent"] = "concurrent";
+})(VectorClockComparison || (exports.VectorClockComparison = VectorClockComparison = {}));
+/**
+ * Types of conflicts that can occur
+ */
+var ConflictType;
+(function (ConflictType) {
+    /** Concurrent modifications to same field */
+    ConflictType["ConcurrentUpdate"] = "concurrent_update";
+    /** Concurrent add and remove of same element */
+    ConflictType["AddRemove"] = "add_remove";
+    /** Type mismatch between values */
+    ConflictType["TypeMismatch"] = "type_mismatch";
+    /** Schema version incompatibility */
+    ConflictType["SchemaVersion"] = "schema_version";
+    /** Clock divergence beyond threshold */
+    ConflictType["ClockDivergence"] = "clock_divergence";
+    /** Tombstone resurrection */
+    ConflictType["TombstoneResurrection"] = "tombstone_resurrection";
+})(ConflictType || (exports.ConflictType = ConflictType = {}));
+/**
+ * Strategies for resolving conflicts
+ */
+var ResolutionStrategy;
+(function (ResolutionStrategy) {
+    /** Last writer wins based on timestamp */
+    ResolutionStrategy["LastWriterWins"] = "lww";
+    /** First writer wins */
+    ResolutionStrategy["FirstWriterWins"] = "fww";
+    /** Prefer higher replica ID (deterministic) */
+    ResolutionStrategy["HigherReplicaWins"] = "higher_replica";
+    /** Merge values (for compatible types) */
+    ResolutionStrategy["Merge"] = "merge";
+    /** Keep both values (for multi-value types) */
+    ResolutionStrategy["KeepBoth"] = "keep_both";
+    /** Prefer local value */
+    ResolutionStrategy["PreferLocal"] = "prefer_local";
+    /** Prefer remote value */
+    ResolutionStrategy["PreferRemote"] = "prefer_remote";
+    /** Custom resolution function */
+    ResolutionStrategy["Custom"] = "custom";
+})(ResolutionStrategy || (exports.ResolutionStrategy = ResolutionStrategy = {}));
+/**
+ * Types of delta operations
+ */
+var DeltaOpType;
+(function (DeltaOpType) {
+    /** Set a value */
+    DeltaOpType["Set"] = "set";
+    /** Increment a counter */
+    DeltaOpType["Increment"] = "increment";
+    /** Decrement a counter */
+    DeltaOpType["Decrement"] = "decrement";
+    /** Add to a set */
+    DeltaOpType["Add"] = "add";
+    /** Remove from a set */
+    DeltaOpType["Remove"] = "remove";
+    /** Clear all values */
+    DeltaOpType["Clear"] = "clear";
+})(DeltaOpType || (exports.DeltaOpType = DeltaOpType = {}));
+/**
+ * Default store configuration
+ */
+exports.DEFAULT_STORE_CONFIG = {
+    replicaId: '',
+    maxInstances: 10000,
+    tombstoneTtl: exports.DEFAULT_TOMBSTONE_TTL,
+    autoGC: true,
+    gcInterval: 60000, // 1 minute
+    enableDeltas: true,
+    maxDeltaBuffer: 1000,
+    trackConflicts: true,
+    maxConflicts: 100,
+};
+// ============================================
+// Event Types
+// ============================================
+/**
+ * CRDT event types
+ */
+var CRDTEventType;
+(function (CRDTEventType) {
+    /** Value was updated */
+    CRDTEventType["Update"] = "update";
+    /** Merge was performed */
+    CRDTEventType["Merge"] = "merge";
+    /** Conflict was detected */
+    CRDTEventType["Conflict"] = "conflict";
+    /** Conflict was resolved */
+    CRDTEventType["ConflictResolved"] = "conflict_resolved";
+    /** GC was performed */
+    CRDTEventType["GarbageCollected"] = "gc";
+    /** Delta was generated */
+    CRDTEventType["DeltaGenerated"] = "delta";
+    /** Instance was created */
+    CRDTEventType["Created"] = "created";
+    /** Instance was deleted */
+    CRDTEventType["Deleted"] = "deleted";
+})(CRDTEventType || (exports.CRDTEventType = CRDTEventType = {}));
+// ============================================
+// Error Types
+// ============================================
+/**
+ * CRDT error codes
+ */
+var CRDTErrorCode;
+(function (CRDTErrorCode) {
+    /** Invalid CRDT type */
+    CRDTErrorCode["InvalidType"] = "INVALID_TYPE";
+    /** CRDT not found */
+    CRDTErrorCode["NotFound"] = "NOT_FOUND";
+    /** Merge failed */
+    CRDTErrorCode["MergeFailed"] = "MERGE_FAILED";
+    /** Serialization error */
+    CRDTErrorCode["SerializationError"] = "SERIALIZATION_ERROR";
+    /** Deserialization error */
+    CRDTErrorCode["DeserializationError"] = "DESERIALIZATION_ERROR";
+    /** Invalid state */
+    CRDTErrorCode["InvalidState"] = "INVALID_STATE";
+    /** Store full */
+    CRDTErrorCode["StoreFull"] = "STORE_FULL";
+    /** Clock error */
+    CRDTErrorCode["ClockError"] = "CLOCK_ERROR";
+    /** Schema mismatch */
+    CRDTErrorCode["SchemaMismatch"] = "SCHEMA_MISMATCH";
+    /** Operation not supported */
+    CRDTErrorCode["UnsupportedOperation"] = "UNSUPPORTED_OPERATION";
+})(CRDTErrorCode || (exports.CRDTErrorCode = CRDTErrorCode = {}));
+/**
+ * CRDT-specific error class
+ */
+class CRDTError extends Error {
+    constructor(message, code, crdtId, details) {
+        super(message);
+        this.code = code;
+        this.crdtId = crdtId;
+        this.details = details;
+        this.name = 'CRDTError';
+    }
+}
+exports.CRDTError = CRDTError;
+//# sourceMappingURL=types.js.map

package/dist/edge/p2p/crdt/types.js.map

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

package/dist/edge/p2p/crypto/Identity.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Ed25519 Identity Manager
+ *
+ * Generates and manages cryptographic identities for P2P agents.
+ * Uses @noble/ed25519 for browser-compatible Ed25519 operations.
+ *
+ * Features:
+ * - Ed25519 keypair generation
+ * - Agent ID derivation from public key hash
+ * - Identity persistence to IndexedDB
+ * - Seed phrase recovery (BIP39-style)
+ *
+ * @module edge/p2p/crypto/Identity
+ * @version 1.0.0
+ */
+import type { AgentIdentity, KeyPair, StoredIdentity, IdentityConfig, SeedPhrase, IdentityExport } from './types';
+/**
+ * IdentityManager - Creates and manages Ed25519 cryptographic identities
+ *
+ * @example
+ * ```typescript
+ * const identity = await IdentityManager.create({
+ *   displayName: 'My Agent',
+ *   password: 'secure-password'
+ * });
+ * console.log(identity.agentId); // "a1b2c3d4e5f6g7h8"
+ * ```
+ */
+export declare class IdentityManager {
+    private static readonly CURRENT_VERSION;
+    private static readonly DEFAULT_ITERATIONS;
+    /**
+     * Generate a new Ed25519 identity
+     *
+     * @param config - Identity configuration including password
+     * @returns Promise resolving to StoredIdentity
+     */
+    static create(config: IdentityConfig): Promise<StoredIdentity>;
+    /**
+     * Recover identity from seed phrase
+     *
+     * @param seedPhrase - BIP39-style seed phrase
+     * @param config - Identity configuration
+     * @returns Promise resolving to StoredIdentity
+     */
+    static fromSeedPhrase(seedPhrase: SeedPhrase, config: IdentityConfig): Promise<StoredIdentity>;
+    /**
+     * Generate a new seed phrase for identity recovery
+     *
+     * @param wordCount - Number of words (12 or 24)
+     * @returns SeedPhrase with generated mnemonic
+     */
+    static generateSeedPhrase(wordCount?: 12 | 24): SeedPhrase;
+    /**
+     * Validate a seed phrase
+     *
+     * @param seedPhrase - Seed phrase to validate
+     * @returns true if valid
+     */
+    static validateSeedPhrase(seedPhrase: SeedPhrase): boolean;
+    /**
+     * Export identity for backup
+     *
+     * @param identity - Stored identity to export
+     * @returns Encrypted export object
+     */
+    static exportIdentity(identity: StoredIdentity): Promise<IdentityExport>;
+    /**
+     * Import identity from export
+     *
+     * @param exported - Exported identity data
+     * @returns StoredIdentity if valid
+     */
+    static importIdentity(exported: IdentityExport): Promise<StoredIdentity>;
+    /**
+     * Get public identity (without encrypted keys)
+     *
+     * @param stored - Stored identity
+     * @returns Public identity info
+     */
+    static getPublicIdentity(stored: StoredIdentity): AgentIdentity;
+    /**
+     * Decrypt private key with password
+     *
+     * @param identity - Stored identity
+     * @param password - Password used to encrypt
+     * @returns Decrypted keypair
+     */
+    static decryptPrivateKey(identity: StoredIdentity, password: string): Promise<KeyPair>;
+    /**
+     * Generate Ed25519 keypair using Web Crypto API
+     */
+    private static generateKeyPair;
+    /**
+     * Generate keypair from 32-byte seed
+     * Implements Ed25519 key derivation using SHA-512
+     */
+    private static keyPairFromSeed;
+    /**
+     * Derive agent ID from public key
+     * Uses first 16 characters of SHA-256 hash
+     */
+    private static deriveAgentId;
+    /**
+     * Encrypt private key for storage
+     */
+    private static encryptPrivateKey;
+    /**
+     * Derive AES key from password using PBKDF2
+     */
+    private static deriveKeyFromPassword;
+    /**
+     * Convert mnemonic to seed bytes
+     */
+    private static mnemonicToSeed;
+    /**
+     * Convert Uint8Array to Base64 string
+     */
+    private static arrayToBase64;
+    /**
+     * Convert Base64 string to Uint8Array
+     */
+    private static base64ToArray;
+}
+/**
+ * Utility functions for base64 encoding/decoding
+ * Exported for use by other modules
+ */
+export declare const base64Utils: {
+    /**
+     * Encode Uint8Array to Base64
+     */
+    encode(array: Uint8Array): string;
+    /**
+     * Decode Base64 to Uint8Array
+     */
+    decode(base64: string): Uint8Array;
+};
+//# sourceMappingURL=Identity.d.ts.map

package/dist/edge/p2p/crypto/Identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Identity.d.ts","sourceRoot":"","sources":["../../../../src/edge/p2p/crypto/Identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,OAAO,EAEP,cAAc,EACd,cAAc,EACd,UAAU,EACV,cAAc,EACf,MAAM,SAAS,CAAC;AAwCjB;;;;;;;;;;;GAWG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAK;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAEpD;;;;;OAKG;WACU,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IA8BpE;;;;;;OAMG;WACU,cAAc,CACzB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,cAAc,GACrB,OAAO,CAAC,cAAc,CAAC;IAwC1B;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,SAAS,GAAE,EAAE,GAAG,EAAO,GAAG,UAAU;IAiB9D;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;IAY1D;;;;;OAKG;WACU,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAkB9E;;;;;OAKG;WACU,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IA2B9E;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa;IAU/D;;;;;;OAMG;WACU,iBAAiB,CAC5B,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC;IA+CnB;;OAEG;mBACkB,eAAe;IAUpC;;;OAGG;mBACkB,eAAe;IA2CpC;;;OAGG;mBACkB,aAAa;IAalC;;OAEG;mBACkB,iBAAiB;IAuCtC;;OAEG;mBACkB,qBAAqB;IAwC1C;;OAEG;mBACkB,cAAc;IAsCnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAQ5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;CAQ7B;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;kBACW,UAAU,GAAG,MAAM;IAOjC;;OAEG;mBACY,MAAM,GAAG,UAAU;CAQnC,CAAC"}