@superblocksteam/vite-plugin-file-sync 2.0.43-next.12 → 2.0.43-next.14

package/dist/ai-service/llm/context/context-lock.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Thread-safe context ownership management.
+ *
+ * This module provides exclusive ownership semantics for contexts,
+ * ensuring that only one agent can own and modify a context at a time.
+ *
+ * Key features:
+ * - Exclusive ownership with owner ID tracking
+ * - Timeout mechanism to prevent stale locks
+ * - Try-acquire pattern for non-blocking acquisition
+ * - Automatic cleanup of expired locks
+ */
+import type { ContextId } from "./types.js";
+/**
+ * Represents a lock on a context.
+ */
+export interface ContextLock {
+    /** The ID of the context being locked */
+    contextId: ContextId;
+    /** Unique identifier of the lock owner */
+    ownerId: string;
+    /** Timestamp when the lock was acquired */
+    acquiredAt: number;
+    /** Optional timeout in milliseconds after which the lock expires */
+    timeoutMs?: number;
+}
+/**
+ * Error thrown when attempting to acquire a locked context.
+ */
+export declare class ContextLockError extends Error {
+    readonly contextId: ContextId;
+    readonly currentOwner: string;
+    readonly requestedOwner: string;
+    constructor(contextId: ContextId, currentOwner: string, requestedOwner: string);
+}
+/**
+ * Error thrown when attempting to release a context not owned by the requester.
+ */
+export declare class ContextNotOwnedError extends Error {
+    readonly contextId: ContextId;
+    readonly currentOwner: string | undefined;
+    readonly requestedOwner: string;
+    constructor(contextId: ContextId, currentOwner: string | undefined, requestedOwner: string);
+}
+/**
+ * Manages exclusive ownership of contexts.
+ *
+ * This class provides thread-safe context locking with support for:
+ * - Exclusive ownership semantics
+ * - Lock timeouts to prevent deadlocks
+ * - Owner ID tracking for debugging
+ * - Try-acquire pattern for non-blocking operations
+ */
+export declare class ContextLockManager {
+    private locks;
+    /** Default timeout for locks in milliseconds (5 minutes) */
+    private readonly defaultTimeoutMs;
+    /**
+     * Creates a unique key for a context ID.
+     */
+    private getContextKey;
+    /**
+     * Checks if a lock has expired.
+     */
+    private isLockExpired;
+    /**
+     * Cleans up expired locks.
+     */
+    private cleanupExpiredLocks;
+    /**
+     * Attempts to acquire exclusive ownership of a context.
+     *
+     * @param contextId - The context to acquire
+     * @param ownerId - Unique identifier of the entity acquiring the context
+     * @param options - Lock options
+     * @returns true if the lock was acquired, false if already locked
+     * @throws {ContextLockError} if force is false and context is already locked
+     */
+    acquire(contextId: ContextId, ownerId: string, options?: {
+        /** Force acquisition even if locked by another owner */
+        force?: boolean;
+        /** Custom timeout in milliseconds */
+        timeoutMs?: number;
+    }): boolean;
+    /**
+     * Tries to acquire a lock without throwing an error.
+     *
+     * @param contextId - The context to acquire
+     * @param ownerId - Unique identifier of the entity acquiring the context
+     * @param options - Lock options
+     * @returns true if the lock was acquired, false otherwise
+     */
+    tryAcquire(contextId: ContextId, ownerId: string, options?: {
+        timeoutMs?: number;
+    }): boolean;
+    /**
+     * Releases ownership of a context.
+     *
+     * @param contextId - The context to release
+     * @param ownerId - The owner releasing the context
+     * @throws {ContextNotOwnedError} if the context is not owned by the requester
+     */
+    release(contextId: ContextId, ownerId: string): void;
+    /**
+     * Checks if a context is currently locked.
+     *
+     * @param contextId - The context to check
+     * @returns true if the context is locked and not expired
+     */
+    isLocked(contextId: ContextId): boolean;
+    /**
+     * Gets the current owner of a context.
+     *
+     * @param contextId - The context to check
+     * @returns The owner ID if locked, undefined otherwise
+     */
+    getOwner(contextId: ContextId): string | undefined;
+    /**
+     * Checks if a specific owner owns a context.
+     *
+     * @param contextId - The context to check
+     * @param ownerId - The owner to check
+     * @returns true if the owner owns the context
+     */
+    isOwnedBy(contextId: ContextId, ownerId: string): boolean;
+    /**
+     * Gets information about all active locks.
+     * Useful for debugging and monitoring.
+     *
+     * @returns Array of active lock information
+     */
+    getActiveLocks(): ReadonlyArray<{
+        contextId: ContextId;
+        ownerId: string;
+        ageMs: number;
+        expiresInMs?: number;
+    }>;
+    /**
+     * Clears all locks. Use with caution!
+     * Primarily intended for testing and emergency recovery.
+     */
+    clearAllLocks(): void;
+}
+//# sourceMappingURL=context-lock.d.ts.map

package/dist/ai-service/llm/context/context-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-lock.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/llm/context/context-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,SAAS,EAAE,SAAS,CAAC;IACrB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;aAEvB,SAAS,EAAE,SAAS;aACpB,YAAY,EAAE,MAAM;aACpB,cAAc,EAAE,MAAM;gBAFtB,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM;CAOzC;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aAE3B,SAAS,EAAE,SAAS;aACpB,YAAY,EAAE,MAAM,GAAG,SAAS;aAChC,cAAc,EAAE,MAAM;gBAFtB,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,cAAc,EAAE,MAAM;CAOzC;AAED;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAkC;IAC/C,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiB;IAElD;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;;;;;;;OAQG;IACI,OAAO,CACZ,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,wDAAwD;QACxD,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,qCAAqC;QACrC,SAAS,CAAC,EAAE,MAAM,CAAC;KACf,GACL,OAAO;IAmCV;;;;;;;OAOG;IACI,UAAU,CACf,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;KACf,GACL,OAAO;IAWV;;;;;;OAMG;IACI,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAgB3D;;;;;OAKG;IACI,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO;IAO9C;;;;;OAKG;IACI,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS;IAOzD;;;;;;OAMG;IACI,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAIhE;;;;;OAKG;IACI,cAAc,IAAI,aAAa,CAAC;QACrC,SAAS,EAAE,SAAS,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAgBF;;;OAGG;IACI,aAAa,IAAI,IAAI;CAO7B"}

package/dist/ai-service/llm/context/context-lock.js

@@ -0,0 +1,221 @@
+/**
+ * Thread-safe context ownership management.
+ *
+ * This module provides exclusive ownership semantics for contexts,
+ * ensuring that only one agent can own and modify a context at a time.
+ *
+ * Key features:
+ * - Exclusive ownership with owner ID tracking
+ * - Timeout mechanism to prevent stale locks
+ * - Try-acquire pattern for non-blocking acquisition
+ * - Automatic cleanup of expired locks
+ */
+/**
+ * Error thrown when attempting to acquire a locked context.
+ */
+export class ContextLockError extends Error {
+    contextId;
+    currentOwner;
+    requestedOwner;
+    constructor(contextId, currentOwner, requestedOwner) {
+        super(`Context '${contextId.name}' is already locked by '${currentOwner}', cannot be acquired by '${requestedOwner}'`);
+        this.contextId = contextId;
+        this.currentOwner = currentOwner;
+        this.requestedOwner = requestedOwner;
+        this.name = "ContextLockError";
+    }
+}
+/**
+ * Error thrown when attempting to release a context not owned by the requester.
+ */
+export class ContextNotOwnedError extends Error {
+    contextId;
+    currentOwner;
+    requestedOwner;
+    constructor(contextId, currentOwner, requestedOwner) {
+        super(`Context '${contextId.name}' is not owned by '${requestedOwner}' (current owner: ${currentOwner ?? "none"})`);
+        this.contextId = contextId;
+        this.currentOwner = currentOwner;
+        this.requestedOwner = requestedOwner;
+        this.name = "ContextNotOwnedError";
+    }
+}
+/**
+ * Manages exclusive ownership of contexts.
+ *
+ * This class provides thread-safe context locking with support for:
+ * - Exclusive ownership semantics
+ * - Lock timeouts to prevent deadlocks
+ * - Owner ID tracking for debugging
+ * - Try-acquire pattern for non-blocking operations
+ */
+export class ContextLockManager {
+    locks = new Map();
+    /** Default timeout for locks in milliseconds (5 minutes) */
+    defaultTimeoutMs = 5 * 60 * 1000;
+    /**
+     * Creates a unique key for a context ID.
+     */
+    getContextKey(contextId) {
+        return `${contextId.userId}::${contextId.name}`;
+    }
+    /**
+     * Checks if a lock has expired.
+     */
+    isLockExpired(lock) {
+        if (!lock.timeoutMs)
+            return false;
+        return Date.now() - lock.acquiredAt > lock.timeoutMs;
+    }
+    /**
+     * Cleans up expired locks.
+     */
+    cleanupExpiredLocks() {
+        const now = Date.now();
+        for (const [key, lock] of this.locks.entries()) {
+            if (this.isLockExpired(lock)) {
+                console.warn(`Cleaning up expired lock for context '${lock.contextId.name}' (owner: ${lock.ownerId}, age: ${now - lock.acquiredAt}ms)`);
+                this.locks.delete(key);
+            }
+        }
+    }
+    /**
+     * Attempts to acquire exclusive ownership of a context.
+     *
+     * @param contextId - The context to acquire
+     * @param ownerId - Unique identifier of the entity acquiring the context
+     * @param options - Lock options
+     * @returns true if the lock was acquired, false if already locked
+     * @throws {ContextLockError} if force is false and context is already locked
+     */
+    acquire(contextId, ownerId, options = {}) {
+        this.cleanupExpiredLocks();
+        const key = this.getContextKey(contextId);
+        const existingLock = this.locks.get(key);
+        // Check if already locked by someone else
+        if (existingLock && !this.isLockExpired(existingLock)) {
+            if (existingLock.ownerId === ownerId) {
+                // Already owned by this owner, refresh the lock
+                existingLock.acquiredAt = Date.now();
+                return true;
+            }
+            if (!options.force) {
+                throw new ContextLockError(contextId, existingLock.ownerId, ownerId);
+            }
+            console.warn(`Force-acquiring context '${contextId.name}' from '${existingLock.ownerId}' to '${ownerId}'`);
+        }
+        // Acquire the lock
+        const lock = {
+            contextId,
+            ownerId,
+            acquiredAt: Date.now(),
+            timeoutMs: options.timeoutMs ?? this.defaultTimeoutMs,
+        };
+        this.locks.set(key, lock);
+        return true;
+    }
+    /**
+     * Tries to acquire a lock without throwing an error.
+     *
+     * @param contextId - The context to acquire
+     * @param ownerId - Unique identifier of the entity acquiring the context
+     * @param options - Lock options
+     * @returns true if the lock was acquired, false otherwise
+     */
+    tryAcquire(contextId, ownerId, options = {}) {
+        try {
+            return this.acquire(contextId, ownerId, { ...options, force: false });
+        }
+        catch (error) {
+            if (error instanceof ContextLockError) {
+                return false;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Releases ownership of a context.
+     *
+     * @param contextId - The context to release
+     * @param ownerId - The owner releasing the context
+     * @throws {ContextNotOwnedError} if the context is not owned by the requester
+     */
+    release(contextId, ownerId) {
+        const key = this.getContextKey(contextId);
+        const lock = this.locks.get(key);
+        if (!lock) {
+            // No lock exists, nothing to release
+            return;
+        }
+        if (lock.ownerId !== ownerId) {
+            throw new ContextNotOwnedError(contextId, lock.ownerId, ownerId);
+        }
+        this.locks.delete(key);
+    }
+    /**
+     * Checks if a context is currently locked.
+     *
+     * @param contextId - The context to check
+     * @returns true if the context is locked and not expired
+     */
+    isLocked(contextId) {
+        this.cleanupExpiredLocks();
+        const key = this.getContextKey(contextId);
+        const lock = this.locks.get(key);
+        return lock !== undefined && !this.isLockExpired(lock);
+    }
+    /**
+     * Gets the current owner of a context.
+     *
+     * @param contextId - The context to check
+     * @returns The owner ID if locked, undefined otherwise
+     */
+    getOwner(contextId) {
+        this.cleanupExpiredLocks();
+        const key = this.getContextKey(contextId);
+        const lock = this.locks.get(key);
+        return lock && !this.isLockExpired(lock) ? lock.ownerId : undefined;
+    }
+    /**
+     * Checks if a specific owner owns a context.
+     *
+     * @param contextId - The context to check
+     * @param ownerId - The owner to check
+     * @returns true if the owner owns the context
+     */
+    isOwnedBy(contextId, ownerId) {
+        return this.getOwner(contextId) === ownerId;
+    }
+    /**
+     * Gets information about all active locks.
+     * Useful for debugging and monitoring.
+     *
+     * @returns Array of active lock information
+     */
+    getActiveLocks() {
+        this.cleanupExpiredLocks();
+        const now = Date.now();
+        return Array.from(this.locks.values())
+            .filter((lock) => !this.isLockExpired(lock))
+            .map((lock) => ({
+            contextId: lock.contextId,
+            ownerId: lock.ownerId,
+            ageMs: now - lock.acquiredAt,
+            expiresInMs: lock.timeoutMs
+                ? lock.timeoutMs - (now - lock.acquiredAt)
+                : undefined,
+        }));
+    }
+    /**
+     * Clears all locks. Use with caution!
+     * Primarily intended for testing and emergency recovery.
+     */
+    clearAllLocks() {
+        const count = this.locks.size;
+        if (count > 0) {
+            console.warn(`Clearing ${count} active context locks`);
+            this.locks.clear();
+        }
+    }
+}
+//# sourceMappingURL=context-lock.js.map

package/dist/ai-service/llm/context/context-lock.js.map

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

package/dist/ai-service/llm/context/context.d.ts

@@ -34,7 +34,6 @@ export declare class Context {
     l1Turns: L1Turn[];
     private onPersist?;
     private activeTurnNumResponses;
-    private continuations;
     private turnStartMs;
     private _logger;
     private cacheStrategy;
@@ -76,7 +75,7 @@ export declare class Context {
      */
     get activeStep(): Step | undefined;
     /**
-     * All turn messages (L3 + L2 + L1), excluding continuation markers.
+     * All turn messages (L3 + L2 + L1).
      */
     get turnMessages(): TokenizedMessage[];
     /**
@@ -125,14 +124,17 @@ export declare class Context {
      * Recalculates all token counts with current estimate.
      */
     private recalculateTokenCounts;
+    /**
+     * Execute compaction if needed based on trigger threshold.
+     */
+    private compactIfNeeded;
     /**
      * Main compaction algorithm.
      *
      * Triggers when context exceeds compactionTrigger threshold.
-     * Demotes/drops turns to reach compactionTarget.
+     * Demotes/drops/trims turns to reach compactionTarget.
      * TODO(matt): add final AI summary level
      *
-     * @param maxTokens - Hard token limit
      * @param lastTurnIsActive - Whether last L1 turn is active (protected from demotion)
      */
     private compact;
@@ -153,32 +155,29 @@ export declare class Context {
      * Compacts L3 turns to fit within target budget by dropping oldest.
      */
     private compactL3ToTarget;
-    private patchContinuationBeforeDrop;
     /**
      * Performs aggressive compaction when still over target after level-based compaction.
      */
     private performAggressiveCompaction;
     /**
-     * Splits old steps from active turn into a completed L1 turn when appropriate.
+     * Trims content from older steps in the active turn to reduce token usage.
      *
      * Strategy:
-     * - Split when turn has more than `prioritizedSteps` steps
-     * - Merge with previous split turn if it exists (via continuations map)
+     * - Preserve the most recent `stepsToPreserve` steps at full fidelity
+     * - Compact content in older steps using compactContent()
+     * - Continue until token count is under target or all trimmable steps are processed
      *
-     * This keeps recent steps in the active turn while moving older steps
-     * to a completed turn that can be cached and potentially compacted.
+     * This keeps recent interactions detailed while reducing token usage from
+     * earlier steps in long-running turns.
      */
-    private splitActiveTurn;
-    /**
-     * Performs the actual split operation.
-     *
-     * If a previous split turn exists (linked via continuations), merges steps into it.
-     * Otherwise creates a new completed turn.
-     */
-    private performSplit;
+    private trimActiveTurn;
     private withTokenCount;
     private estimateTokenCount;
-    private toModelMessage;
+    /**
+     * Sanitizes outgoing messages into clean ModelMessages for LLM input.
+     * Performs any necessary repairs (e.g. removing orphaned tool calls).
+     */
+    private sanitize;
     /**
      * Removes tool-call parts from assistant messages if their results aren't present later in the context.
      * This can happen if a tool call was made but the tool result message was never added (e.g. due to an error).

package/dist/ai-service/llm/context/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/llm/context/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/llm/context/context.ts"],"names":[],"mappings":"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"}