@psiclawops/hypermem 0.9.0 → 0.9.1

package/dist/db.js

@@ -1,410 +0,0 @@
-/**
- * hypermem Database Manager
- *
- * Three-file architecture per agent:
- *   agents/{agentId}/messages.db  — write-heavy conversation log (rotatable)
- *   agents/{agentId}/vectors.db   — search index (reconstructable)
- *   library.db                    — fleet-wide structured knowledge (crown jewel)
- *
- * Uses node:sqlite (built into Node 22+) for synchronous, zero-dependency access.
- */
-import { DatabaseSync } from 'node:sqlite';
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { migrate } from './schema.js';
-import { migrateLibrary } from './library-schema.js';
-import { ENGINE_VERSION } from './version.js';
-import { ensureContextSchema } from './context-store.js';
-import { backfillContexts } from './context-backfill.js';
-// sqlite-vec extension loading — optional dependency
-import { createRequire } from 'node:module';
-let sqliteVecAvailable = null;
-let sqliteVecLoad = null;
-function loadSqliteVec(db) {
-    if (sqliteVecAvailable === null) {
-        try {
-            const require = createRequire(import.meta.url);
-            const mod = require('sqlite-vec');
-            sqliteVecLoad = mod.load;
-            sqliteVecAvailable = true;
-        }
-        catch {
-            sqliteVecAvailable = false;
-            sqliteVecLoad = null;
-        }
-    }
-    if (!sqliteVecAvailable || !sqliteVecLoad)
-        return false;
-    try {
-        sqliteVecLoad(db);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-const DEFAULT_DATA_DIR = path.join(process.env.HOME || os.homedir(), '.openclaw', 'hypermem');
-/**
- * Validate agentId to prevent path traversal.
- * Must match [a-z0-9][a-z0-9-]* (lowercase alphanumeric + hyphens, no dots or slashes).
- */
-function validateAgentId(agentId) {
-    if (!agentId || !/^[a-z0-9][a-z0-9-]*$/.test(agentId)) {
-        throw new Error(`Invalid agentId: "${agentId}". Must match [a-z0-9][a-z0-9-]*`);
-    }
-}
-/**
- * Validate rotated DB filename to prevent path traversal.
- * Must match the expected rotation pattern: messages_YYYYQN(_N)?.db
- */
-function validateRotatedFilename(filename) {
-    if (!/^messages_\d{4}Q[1-4](_\d+)?\.db$/.test(filename)) {
-        throw new Error(`Invalid rotated DB filename: "${filename}". Must match messages_YYYYQN.db pattern`);
-    }
-}
-/**
- * Apply standard pragmas to a database connection.
- */
-function applyPragmas(db) {
-    db.exec('PRAGMA journal_mode = WAL');
-    db.exec('PRAGMA synchronous = NORMAL');
-    db.exec('PRAGMA foreign_keys = ON');
-    db.exec('PRAGMA busy_timeout = 5000');
-}
-/**
- * Get the directory for an agent's databases.
- */
-function agentDir(dataDir, agentId) {
-    return path.join(dataDir, 'agents', agentId);
-}
-export { validateAgentId, validateRotatedFilename };
-export class DatabaseManager {
-    dataDir;
-    messageDbs = new Map();
-    vectorDbs = new Map();
-    libraryDb = null;
-    _vecAvailable = null;
-    /** Whether sqlite-vec was successfully loaded on the most recent DB open. */
-    get vecAvailable() {
-        return this._vecAvailable === true;
-    }
-    constructor(config) {
-        this.dataDir = config?.dataDir || DEFAULT_DATA_DIR;
-        fs.mkdirSync(this.dataDir, { recursive: true });
-    }
-    /**
-     * Get or create the message database for an agent.
-     * This is the write-heavy, rotatable conversation log.
-     */
-    getMessageDb(agentId) {
-        validateAgentId(agentId);
-        let db = this.messageDbs.get(agentId);
-        if (db)
-            return db;
-        const dir = agentDir(this.dataDir, agentId);
-        fs.mkdirSync(dir, { recursive: true });
-        const dbPath = path.join(dir, 'messages.db');
-        db = new DatabaseSync(dbPath);
-        applyPragmas(db);
-        migrate(db);
-        ensureContextSchema(db);
-        // Backfill contexts for existing conversations on first run after migration
-        const contextCount = db.prepare('SELECT COUNT(*) as cnt FROM contexts').get();
-        if (contextCount.cnt === 0) {
-            backfillContexts(db);
-        }
-        this.messageDbs.set(agentId, db);
-        return db;
-    }
-    /**
-     * Get or create the vector database for an agent.
-     * This is the search index — fully reconstructable.
-     * Returns null if sqlite-vec is not available.
-     */
-    getVectorDb(agentId) {
-        validateAgentId(agentId);
-        let db = this.vectorDbs.get(agentId);
-        if (db)
-            return db;
-        const dir = agentDir(this.dataDir, agentId);
-        fs.mkdirSync(dir, { recursive: true });
-        const dbPath = path.join(dir, 'vectors.db');
-        db = new DatabaseSync(dbPath, { allowExtension: true });
-        applyPragmas(db);
-        const vecLoaded = loadSqliteVec(db);
-        this._vecAvailable = vecLoaded;
-        if (!vecLoaded) {
-            // Close and don't cache — no point without vec extension
-            try {
-                db.close();
-            }
-            catch { /* ignore */ }
-            return null;
-        }
-        // Create vector tables (managed by VectorStore, but we ensure the DB is ready)
-        this.vectorDbs.set(agentId, db);
-        return db;
-    }
-    /**
-     * Get or create the shared (fleet-wide) vector database.
-     * Unlike per-agent vector DBs, this is a single vectors.db at the root of dataDir,
-     * shared across all agents. Facts and episodes from all agents are indexed together,
-     * keyed by (source_table, source_id) in vec_index_map.
-     * Returns null if sqlite-vec is not available.
-     */
-    getSharedVectorDb() {
-        const sharedKey = '__shared__';
-        let db = this.vectorDbs.get(sharedKey);
-        if (db)
-            return db;
-        const dbPath = path.join(this.dataDir, 'vectors.db');
-        db = new DatabaseSync(dbPath, { allowExtension: true });
-        applyPragmas(db);
-        const vecLoaded = loadSqliteVec(db);
-        this._vecAvailable = vecLoaded;
-        if (!vecLoaded) {
-            try {
-                db.close();
-            }
-            catch { /* ignore */ }
-            return null;
-        }
-        this.vectorDbs.set(sharedKey, db);
-        return db;
-    }
-    /**
-     * Get or create the shared library database.
-     * This is the fleet-wide knowledge store — the crown jewel.
-     */
-    getLibraryDb() {
-        if (this.libraryDb)
-            return this.libraryDb;
-        const dbPath = path.join(this.dataDir, 'library.db');
-        this.libraryDb = new DatabaseSync(dbPath);
-        applyPragmas(this.libraryDb);
-        migrateLibrary(this.libraryDb, ENGINE_VERSION);
-        return this.libraryDb;
-    }
-    // ── Legacy compatibility ──────────────────────────────────────
-    /**
-     * @deprecated Use getMessageDb() instead. Kept for migration period.
-     * Maps to getMessageDb() for backward compatibility.
-     */
-    getAgentDb(agentId) {
-        return this.getMessageDb(agentId);
-    }
-    /**
-     * Ensure agent metadata exists in the message DB.
-     */
-    ensureAgent(agentId, meta) {
-        validateAgentId(agentId);
-        const db = this.getMessageDb(agentId);
-        const now = new Date().toISOString();
-        const existing = db
-            .prepare('SELECT id FROM agent_meta WHERE id = ?')
-            .get(agentId);
-        if (!existing) {
-            db.prepare(`
-        INSERT INTO agent_meta (id, display_name, tier, org, created_at, updated_at)
-        VALUES (?, ?, ?, ?, ?, ?)
-      `).run(agentId, meta?.displayName || agentId, meta?.tier || 'unknown', meta?.org || 'unknown', now, now);
-        }
-        // Also register in fleet registry (library)
-        this.ensureFleetAgent(agentId, meta);
-    }
-    /**
-     * Ensure agent exists in the fleet registry (library DB).
-     */
-    ensureFleetAgent(agentId, meta) {
-        const db = this.getLibraryDb();
-        const now = new Date().toISOString();
-        const existing = db
-            .prepare('SELECT id FROM fleet_agents WHERE id = ?')
-            .get(agentId);
-        if (!existing) {
-            db.prepare(`
-        INSERT INTO fleet_agents (id, display_name, tier, org_id, status, created_at, updated_at)
-        VALUES (?, ?, ?, ?, 'active', ?, ?)
-      `).run(agentId, meta?.displayName || agentId, meta?.tier || 'unknown', meta?.org || null, now, now);
-        }
-        else {
-            // Update last_seen
-            db.prepare('UPDATE fleet_agents SET last_seen = ?, updated_at = ? WHERE id = ?')
-                .run(now, now, agentId);
-        }
-    }
-    /**
-     * List all agents with message databases.
-     */
-    listAgents() {
-        const agentsDir = path.join(this.dataDir, 'agents');
-        if (!fs.existsSync(agentsDir))
-            return [];
-        const VALID_AGENT_ID = /^[a-z0-9][a-z0-9-]*$/;
-        return fs.readdirSync(agentsDir).filter(f => {
-            if (!VALID_AGENT_ID.test(f))
-                return false;
-            const stat = fs.statSync(path.join(agentsDir, f));
-            return stat.isDirectory();
-        });
-    }
-    /**
-     * Get the path to an agent's directory.
-     */
-    getAgentDir(agentId) {
-        validateAgentId(agentId);
-        return agentDir(this.dataDir, agentId);
-    }
-    /**
-     * List rotated message DB files for an agent.
-     */
-    listRotatedDbs(agentId) {
-        const dir = agentDir(this.dataDir, agentId);
-        if (!fs.existsSync(dir))
-            return [];
-        return fs.readdirSync(dir)
-            .filter(f => f.startsWith('messages_') && f.endsWith('.db'))
-            .sort();
-    }
-    /**
-     * Get the size of the active messages.db for an agent (in bytes).
-     */
-    getMessageDbSize(agentId) {
-        const dir = agentDir(this.dataDir, agentId);
-        const dbPath = path.join(dir, 'messages.db');
-        try {
-            const stat = fs.statSync(dbPath);
-            return stat.size;
-        }
-        catch {
-            return 0;
-        }
-    }
-    /**
-     * Rotate the message database for an agent.
-     *
-     * 1. Closes the active messages.db connection
-     * 2. Renames messages.db → messages_{YYYYQN}.db (e.g., messages_2026Q1.db)
-     * 3. Removes associated WAL/SHM files
-     * 4. Next call to getMessageDb() creates a fresh database
-     *
-     * The rotated file is read-only archive material. The vector index
-     * retains references to it via source_db in vec_index_map.
-     *
-     * Returns the path to the rotated file, or null if rotation wasn't needed.
-     */
-    rotateMessageDb(agentId) {
-        const dir = agentDir(this.dataDir, agentId);
-        const activePath = path.join(dir, 'messages.db');
-        if (!fs.existsSync(activePath))
-            return null;
-        // Close the active connection first
-        const existingDb = this.messageDbs.get(agentId);
-        if (existingDb) {
-            try {
-                // Checkpoint WAL into the main database before rotating
-                existingDb.exec('PRAGMA wal_checkpoint(TRUNCATE)');
-                existingDb.close();
-            }
-            catch { /* ignore */ }
-            this.messageDbs.delete(agentId);
-        }
-        // Generate rotation name: messages_YYYYQN.db
-        const now = new Date();
-        const year = now.getFullYear();
-        const quarter = Math.ceil((now.getMonth() + 1) / 3);
-        let rotatedName = `messages_${year}Q${quarter}.db`;
-        let rotatedPath = path.join(dir, rotatedName);
-        // Handle collision — append a suffix if this quarter already has a rotation
-        let suffix = 1;
-        while (fs.existsSync(rotatedPath)) {
-            rotatedName = `messages_${year}Q${quarter}_${suffix}.db`;
-            rotatedPath = path.join(dir, rotatedName);
-            suffix++;
-        }
-        // Rename the active DB to the rotated name
-        fs.renameSync(activePath, rotatedPath);
-        // Clean up WAL and SHM files
-        for (const ext of ['-wal', '-shm']) {
-            const walPath = activePath + ext;
-            if (fs.existsSync(walPath)) {
-                try {
-                    fs.unlinkSync(walPath);
-                }
-                catch { /* ignore */ }
-            }
-        }
-        return rotatedPath;
-    }
-    /**
-     * Check if an agent's message database needs rotation.
-     * Triggers on:
-     *   - Size exceeds threshold (default 100MB)
-     *   - Time since creation exceeds threshold (default 90 days)
-     *
-     * Returns the reason for rotation, or null if no rotation needed.
-     */
-    shouldRotate(agentId, opts) {
-        const maxSize = opts?.maxSizeBytes ?? 100 * 1024 * 1024; // 100MB
-        const maxAge = opts?.maxAgeDays ?? 90;
-        // Check size
-        const size = this.getMessageDbSize(agentId);
-        if (size > maxSize) {
-            return { reason: 'size', current: size, threshold: maxSize };
-        }
-        // Check age — look at the earliest conversation in the DB
-        const db = this.getMessageDb(agentId);
-        const oldest = db.prepare('SELECT MIN(created_at) as earliest FROM conversations').get();
-        if (oldest?.earliest) {
-            const created = new Date(oldest.earliest);
-            const ageMs = Date.now() - created.getTime();
-            const ageDays = ageMs / (1000 * 60 * 60 * 24);
-            if (ageDays > maxAge) {
-                return { reason: 'age', current: Math.round(ageDays), threshold: maxAge };
-            }
-        }
-        return null;
-    }
-    /**
-     * Open a rotated message database as read-only for querying.
-     */
-    openRotatedDb(agentId, filename) {
-        validateAgentId(agentId);
-        validateRotatedFilename(filename);
-        const dir = agentDir(this.dataDir, agentId);
-        const dbPath = path.join(dir, filename);
-        if (!fs.existsSync(dbPath)) {
-            throw new Error(`Rotated DB not found: ${dbPath}`);
-        }
-        const db = new DatabaseSync(dbPath, { readOnly: true });
-        return db;
-    }
-    /**
-     * Close all open database connections.
-     */
-    close() {
-        for (const [, db] of this.messageDbs) {
-            try {
-                db.close();
-            }
-            catch { /* ignore */ }
-        }
-        this.messageDbs.clear();
-        for (const [, db] of this.vectorDbs) {
-            try {
-                db.close();
-            }
-            catch { /* ignore */ }
-        }
-        this.vectorDbs.clear();
-        if (this.libraryDb) {
-            try {
-                this.libraryDb.close();
-            }
-            catch { /* ignore */ }
-            this.libraryDb = null;
-        }
-    }
-}
-//# sourceMappingURL=db.js.map

package/dist/degradation.d.ts

@@ -1,102 +0,0 @@
-/**
- * HyperMem Canonical Degradation Contracts, Phase C0.2
- *
- * Defines the typed surfaces, reason enum, and format builders for degraded
- * prompt-visible outputs. These shapes stay in volatile context and should not
- * cross the stable-prefix boundary.
- */
-/**
- * Closed set of reasons for any degradation decision.
- * Use these values in telemetry and tests instead of ad-hoc strings.
- */
-export type DegradationReason = 'gradient_t2_prose' | 'gradient_t3_stub' | 'eviction_oversize' | 'eviction_turn0_trim' | 'wave_guard_pressure_high' | 'wave_guard_pressure_elevated' | 'budget_cluster_drop' | 'artifact_oversize' | 'artifact_fetch_hint' | 'replay_cold_redis' | 'replay_stabilizing' | 'replay_exited' | 'pressure_mismatch' | 'unknown';
-/** All valid DegradationReason values as a readonly array. */
-export declare const DEGRADATION_REASONS: readonly ["gradient_t2_prose", "gradient_t3_stub", "eviction_oversize", "eviction_turn0_trim", "wave_guard_pressure_high", "wave_guard_pressure_elevated", "budget_cluster_drop", "artifact_oversize", "artifact_fetch_hint", "replay_cold_redis", "replay_stabilizing", "replay_exited", "pressure_mismatch", "unknown"];
-/** Field-length caps for canonical degraded strings. */
-export declare const DEGRADATION_LIMITS: {
-    readonly toolName: 64;
-    readonly toolId: 64;
-    readonly reason: 48;
-    readonly toolSummary: 120;
-    readonly toolArtifactId: 64;
-    readonly artifactId: 64;
-    readonly artifactPath: 160;
-    readonly artifactFetchHint: 80;
-    readonly replayState: 32;
-    readonly replaySummary: 120;
-};
-export declare function isDegradationReason(value: string): value is DegradationReason;
-/**
- * Canonical shape for a degraded tool call/result pair.
- *
- * Prompt-visible format:
- *   [tool:<name> id=<id> status=ejected reason=<reason> summary=<stub>]
- *
- * Optional artifact pointer (Phase 1 of tool_artifacts):
- *   [tool:<name> id=<id> status=ejected reason=<reason> artifact=<artifactId> summary=<stub>]
- *
- * The `artifact=` field is backwards-compatible and optional. When present, it
- * lets the compositor rehydrate the full tool result payload from the
- * tool_artifacts table without needing to rewrite the transcript.
- */
-export interface ToolChainStub {
-    name: string;
-    id: string;
-    status: 'ejected';
-    reason: DegradationReason;
-    summary: string;
-    /** Optional durable pointer into the tool_artifacts table. */
-    artifactId?: string;
-}
-export declare function formatToolChainStub(stub: ToolChainStub): string;
-export declare function parseToolChainStub(text: string): ToolChainStub | null;
-export declare function isToolChainStub(text: string): boolean;
-/**
- * Canonical shape for a degraded oversized artifact replaced by a pointer.
- *
- * Prompt-visible format:
- *   [artifact:<id> path=<path> size=<tokens> status=degraded fetch=<hint>]
- */
-export interface ArtifactRef {
-    id: string;
-    path: string;
-    sizeTokens: number;
-    status: 'degraded';
-    reason: DegradationReason;
-    fetchHint: string;
-}
-export declare function formatArtifactRef(ref: ArtifactRef): string;
-export declare function parseArtifactRef(text: string): ArtifactRef | null;
-export declare function isArtifactRef(text: string): boolean;
-/**
- * State of the replay recovery window.
- */
-export type ReplayState = 'entering' | 'stabilizing' | 'exited';
-export declare function isReplayState(value: string): value is ReplayState;
-/**
- * Canonical shape for a replay recovery mode marker.
- *
- * Prompt-visible format:
- *   [replay state=<state> status=bounded reason=<reason> summary=<stub>]
- */
-export interface ReplayMarker {
-    state: ReplayState;
-    status: 'bounded';
-    reason: DegradationReason;
-    summary: string;
-}
-export declare function formatReplayMarker(marker: ReplayMarker): string;
-export declare function parseReplayMarker(text: string): ReplayMarker | null;
-export declare function isReplayMarker(text: string): boolean;
-export declare function isDegradedContent(text: string): boolean;
-export interface DegradationEvent {
-    event: 'degradation';
-    ts: string;
-    agentId: string;
-    sessionKey: string;
-    degradationClass: 'tool_chain' | 'artifact' | 'replay';
-    reason: DegradationReason;
-    tokensSaved: number;
-    emittedText: string;
-}
-//# sourceMappingURL=degradation.d.ts.map

package/dist/degradation.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"degradation.d.ts","sourceRoot":"","sources":["../src/degradation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,mBAAmB,GACnB,kBAAkB,GAClB,mBAAmB,GACnB,qBAAqB,GACrB,0BAA0B,GAC1B,8BAA8B,GAC9B,qBAAqB,GACrB,mBAAmB,GACnB,qBAAqB,GACrB,mBAAmB,GACnB,oBAAoB,GACpB,eAAe,GACf,mBAAmB,GACnB,SAAS,CAAC;AAEd,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,2TAeiB,CAAC;AAElD,wDAAwD;AACxD,eAAO,MAAM,kBAAkB;;;;;;;;;;;CAWrB,CAAC;AAiBX,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAE7E;AAID;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAKD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAS/D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAQrE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAID;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAM1D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAajE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAID;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEhE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEjE;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAK/D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAWnE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD;AAID,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;IACvD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/degradation.js

@@ -1,141 +0,0 @@
-/**
- * HyperMem Canonical Degradation Contracts, Phase C0.2
- *
- * Defines the typed surfaces, reason enum, and format builders for degraded
- * prompt-visible outputs. These shapes stay in volatile context and should not
- * cross the stable-prefix boundary.
- */
-/** All valid DegradationReason values as a readonly array. */
-export const DEGRADATION_REASONS = [
-    'gradient_t2_prose',
-    'gradient_t3_stub',
-    'eviction_oversize',
-    'eviction_turn0_trim',
-    'wave_guard_pressure_high',
-    'wave_guard_pressure_elevated',
-    'budget_cluster_drop',
-    'artifact_oversize',
-    'artifact_fetch_hint',
-    'replay_cold_redis',
-    'replay_stabilizing',
-    'replay_exited',
-    'pressure_mismatch',
-    'unknown',
-];
-/** Field-length caps for canonical degraded strings. */
-export const DEGRADATION_LIMITS = {
-    toolName: 64,
-    toolId: 64,
-    reason: 48,
-    toolSummary: 120,
-    toolArtifactId: 64,
-    artifactId: 64,
-    artifactPath: 160,
-    artifactFetchHint: 80,
-    replayState: 32,
-    replaySummary: 120,
-};
-function sanitizeInline(value) {
-    return value
-        .replace(/[\r\n\t]+/g, ' ')
-        .replace(/\s+/g, ' ')
-        .replace(/]/g, ')')
-        .trim();
-}
-function clampInline(value, limit) {
-    const cleaned = sanitizeInline(value);
-    if (cleaned.length <= limit)
-        return cleaned;
-    if (limit <= 3)
-        return cleaned.slice(0, limit);
-    return cleaned.slice(0, limit - 3) + '...';
-}
-export function isDegradationReason(value) {
-    return DEGRADATION_REASONS.includes(value);
-}
-// Matches stubs with or without the optional artifact field.
-const TOOL_CHAIN_RE = /^\[tool:([^\s\]]+) id=([^\s\]]+) status=(ejected) reason=([^\s\]]+)(?: artifact=([^\s\]]+))? summary=(.*)\]$/s;
-export function formatToolChainStub(stub) {
-    const name = clampInline(stub.name, DEGRADATION_LIMITS.toolName);
-    const id = clampInline(stub.id, DEGRADATION_LIMITS.toolId);
-    const reason = clampInline(stub.reason, DEGRADATION_LIMITS.reason);
-    const summary = clampInline(stub.summary, DEGRADATION_LIMITS.toolSummary);
-    const artifactPart = stub.artifactId
-        ? ` artifact=${clampInline(stub.artifactId, DEGRADATION_LIMITS.toolArtifactId)}`
-        : '';
-    return `[tool:${name} id=${id} status=${stub.status} reason=${reason}${artifactPart} summary=${summary}]`;
-}
-export function parseToolChainStub(text) {
-    const match = text.match(TOOL_CHAIN_RE);
-    if (!match)
-        return null;
-    const [, name, id, status, reason, artifactId, summary] = match;
-    if (status !== 'ejected' || !isDegradationReason(reason))
-        return null;
-    const out = { name, id, status: 'ejected', reason, summary };
-    if (artifactId)
-        out.artifactId = artifactId;
-    return out;
-}
-export function isToolChainStub(text) {
-    return parseToolChainStub(text) !== null;
-}
-const ARTIFACT_REF_RE = /^\[artifact:(.+?) path=(.+?) size=(\d+) status=(degraded) reason=(.+?) fetch=(.*)\]$/s;
-export function formatArtifactRef(ref) {
-    const id = clampInline(ref.id, DEGRADATION_LIMITS.artifactId);
-    const path = clampInline(ref.path, DEGRADATION_LIMITS.artifactPath);
-    const reason = clampInline(ref.reason, DEGRADATION_LIMITS.reason);
-    const fetchHint = clampInline(ref.fetchHint, DEGRADATION_LIMITS.artifactFetchHint);
-    return `[artifact:${id} path=${path} size=${ref.sizeTokens} status=${ref.status} reason=${reason} fetch=${fetchHint}]`;
-}
-export function parseArtifactRef(text) {
-    const match = text.match(ARTIFACT_REF_RE);
-    if (!match)
-        return null;
-    const [, id, path, sizeTokens, status, reason, fetchHint] = match;
-    if (status !== 'degraded' || !isDegradationReason(reason))
-        return null;
-    return {
-        id,
-        path,
-        sizeTokens: parseInt(sizeTokens, 10),
-        status: 'degraded',
-        reason,
-        fetchHint,
-    };
-}
-export function isArtifactRef(text) {
-    return parseArtifactRef(text) !== null;
-}
-export function isReplayState(value) {
-    return value === 'entering' || value === 'stabilizing' || value === 'exited';
-}
-const REPLAY_MARKER_RE = /^\[replay state=([^\s\]]+) status=(bounded) reason=([^\s\]]+) summary=(.*)\]$/s;
-export function formatReplayMarker(marker) {
-    const state = clampInline(marker.state, DEGRADATION_LIMITS.replayState);
-    const reason = clampInline(marker.reason, DEGRADATION_LIMITS.reason);
-    const summary = clampInline(marker.summary, DEGRADATION_LIMITS.replaySummary);
-    return `[replay state=${state} status=${marker.status} reason=${reason} summary=${summary}]`;
-}
-export function parseReplayMarker(text) {
-    const match = text.match(REPLAY_MARKER_RE);
-    if (!match)
-        return null;
-    const [, state, status, reason, summary] = match;
-    if (status !== 'bounded' || !isReplayState(state) || !isDegradationReason(reason))
-        return null;
-    return {
-        state,
-        status: 'bounded',
-        reason,
-        summary,
-    };
-}
-export function isReplayMarker(text) {
-    return parseReplayMarker(text) !== null;
-}
-// ─── Shared helpers ───────────────────────────────────────────────────────────
-export function isDegradedContent(text) {
-    return isToolChainStub(text) || isArtifactRef(text) || isReplayMarker(text);
-}
-//# sourceMappingURL=degradation.js.map