@weave_protocol/domere 1.0.18 → 1.2.0

package/dist/orchestration/state.d.ts

@@ -0,0 +1,258 @@
+/**
+ * Dōmere - State Manager
+ *
+ * Distributed state management with locking, branching, and conflict resolution
+ * for multi-agent AI orchestration systems.
+ */
+export type ConflictResolution = 'last-write-wins' | 'first-write-wins' | 'merge' | 'manual';
+export type LockType = 'exclusive' | 'shared';
+export interface StateEntry {
+    key: string;
+    value: any;
+    version: number;
+    hash: string;
+    created_at: Date;
+    updated_at: Date;
+    updated_by: string;
+    branch: string;
+    metadata: Record<string, any>;
+}
+export interface Lock {
+    id: string;
+    key: string;
+    type: LockType;
+    holder: string;
+    acquired_at: Date;
+    expires_at: Date;
+    renewed_count: number;
+}
+export interface LockRequest {
+    key: string;
+    holder: string;
+    type?: LockType;
+    duration_ms?: number;
+    wait_ms?: number;
+}
+export interface LockResult {
+    acquired: boolean;
+    lock?: Lock;
+    reason?: string;
+    current_holder?: string;
+    retry_after_ms?: number;
+}
+export interface Branch {
+    name: string;
+    parent: string;
+    created_at: Date;
+    created_by: string;
+    head_version: number;
+    merged: boolean;
+    merged_at?: Date;
+}
+export interface MergeResult {
+    success: boolean;
+    conflicts: Conflict[];
+    merged_keys: string[];
+    source_branch: string;
+    target_branch: string;
+}
+export interface Conflict {
+    key: string;
+    source_value: any;
+    target_value: any;
+    source_version: number;
+    target_version: number;
+    base_value?: any;
+}
+export interface StateChange {
+    type: 'set' | 'delete' | 'merge';
+    key: string;
+    old_value?: any;
+    new_value?: any;
+    version: number;
+    timestamp: Date;
+    agent_id: string;
+    branch: string;
+}
+export interface StateSnapshot {
+    id: string;
+    branch: string;
+    timestamp: Date;
+    entries: Map<string, StateEntry>;
+    version: number;
+}
+export declare class StateManager {
+    private state;
+    private locks;
+    private branches;
+    private snapshots;
+    private changeLog;
+    private changeCallbacks;
+    private conflictResolution;
+    private defaultLockDuration;
+    constructor(options?: {
+        conflict_resolution?: ConflictResolution;
+        default_lock_duration_ms?: number;
+    });
+    /**
+     * Get a value
+     */
+    get(key: string, options?: {
+        branch?: string;
+    }): Promise<any | undefined>;
+    /**
+     * Get entry with metadata
+     */
+    getEntry(key: string, options?: {
+        branch?: string;
+    }): Promise<StateEntry | undefined>;
+    /**
+     * Set a value
+     */
+    set(key: string, value: any, options?: {
+        branch?: string;
+        agent_id?: string;
+        metadata?: Record<string, any>;
+        require_lock?: boolean;
+    }): Promise<StateEntry>;
+    /**
+     * Delete a value
+     */
+    delete(key: string, options?: {
+        branch?: string;
+        agent_id?: string;
+    }): Promise<boolean>;
+    /**
+     * List all keys
+     */
+    keys(options?: {
+        branch?: string;
+        prefix?: string;
+    }): Promise<string[]>;
+    /**
+     * Check if key exists
+     */
+    has(key: string, options?: {
+        branch?: string;
+    }): Promise<boolean>;
+    /**
+     * Acquire a lock
+     */
+    acquireLock(request: LockRequest): Promise<LockResult>;
+    /**
+     * Release a lock
+     */
+    releaseLock(key: string, holder: string): Promise<boolean>;
+    /**
+     * Renew a lock
+     */
+    renewLock(key: string, holder: string, duration_ms?: number): Promise<LockResult>;
+    /**
+     * Check if key is locked
+     */
+    isLocked(key: string): {
+        locked: boolean;
+        holder?: string;
+        expires_at?: Date;
+    };
+    /**
+     * Get all locks held by an agent
+     */
+    getLocksForHolder(holder: string): Lock[];
+    /**
+     * Release all locks held by an agent
+     */
+    releaseAllLocks(holder: string): Promise<number>;
+    /**
+     * Create a branch
+     */
+    createBranch(name: string, options?: {
+        parent?: string;
+        created_by?: string;
+    }): Promise<Branch>;
+    /**
+     * List branches
+     */
+    listBranches(): Branch[];
+    /**
+     * Get branch info
+     */
+    getBranch(name: string): Branch | undefined;
+    /**
+     * Merge branch into target
+     */
+    merge(source: string, target: string, options?: {
+        agent_id?: string;
+        resolution?: ConflictResolution;
+    }): Promise<MergeResult>;
+    /**
+     * Resolve conflicts manually
+     */
+    resolveConflicts(conflicts: Conflict[], resolutions: Map<string, 'source' | 'target' | any>, options?: {
+        source: string;
+        target: string;
+        agent_id?: string;
+    }): Promise<void>;
+    /**
+     * Delete a branch
+     */
+    deleteBranch(name: string): Promise<boolean>;
+    /**
+     * Create a snapshot
+     */
+    createSnapshot(options?: {
+        branch?: string;
+    }): Promise<StateSnapshot>;
+    /**
+     * Restore from snapshot
+     */
+    restoreSnapshot(snapshotId: string): Promise<void>;
+    /**
+     * List snapshots
+     */
+    listSnapshots(branch?: string): StateSnapshot[];
+    /**
+     * Delete a snapshot
+     */
+    deleteSnapshot(snapshotId: string): boolean;
+    /**
+     * Get change history
+     */
+    getChanges(options?: {
+        branch?: string;
+        key?: string;
+        agent_id?: string;
+        since?: Date;
+        limit?: number;
+    }): StateChange[];
+    /**
+     * Subscribe to changes
+     */
+    onChange(callback: (change: StateChange) => void): () => void;
+    private notifyChange;
+    private cleanupExpiredLocks;
+    /**
+     * Get state statistics
+     */
+    getStats(): {
+        branches: number;
+        total_keys: number;
+        active_locks: number;
+        snapshots: number;
+        changes_logged: number;
+    };
+    /**
+     * Export state for backup
+     */
+    exportState(branch?: string): Promise<string>;
+    /**
+     * Import state from backup
+     */
+    importState(data: string, options?: {
+        merge?: boolean;
+    }): Promise<{
+        imported_keys: number;
+    }>;
+}
+export default StateManager;
+//# sourceMappingURL=state.d.ts.map

package/dist/orchestration/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/orchestration/state.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,OAAO,GAAG,QAAQ,CAAC;AAC7F,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;AAE9C,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,GAAG,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,IAAI,CAAC;IAClB,UAAU,EAAE,IAAI,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,GAAG,CAAC;IAClB,YAAY,EAAE,GAAG,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,GAAG,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAmD;IAChE,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,eAAe,CAAyC;IAEhE,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,mBAAmB,CAAS;gBAExB,OAAO,CAAC,EAAE;QACpB,mBAAmB,CAAC,EAAE,kBAAkB,CAAC;QACzC,wBAAwB,CAAC,EAAE,MAAM,CAAC;KACnC;IAuBD;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,GAAG,SAAS,CAAC;IAS/E;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAQ3F;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE;QAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GAAG,OAAO,CAAC,UAAU,CAAC;IA+DvB;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAClC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,OAAO,CAAC;IAkCpB;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAc7E;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAUvE;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAyD5D;;OAEG;IACG,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYhE;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBvF;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,IAAI,CAAA;KAAE;IAe9E;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE;IAIzC;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBtD;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QACzC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,MAAM,CAAC;IAmCnB;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI3C;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,kBAAkB,CAAC;KACjC,GAAG,OAAO,CAAC,WAAW,CAAC;IAoGxB;;OAEG;IACG,gBAAgB,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE;QAC3G,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgDjB;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBlD;;OAEG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAsB3E;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBxD;;OAEG;IACH,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAU/C;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAQ3C;;OAEG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,IAAI,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,WAAW,EAAE;IA0BjB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI;IAS7D,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,QAAQ,IAAI;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;KACxB;IAeD;;OAEG;IACG,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBnD;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CAuBnG;AAED,eAAe,YAAY,CAAC"}