@jcmrs/opencode-vmem 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,301 @@
+export type ObservationType = 'tool_execution' | 'file_read' | 'file_write' | 'file_edit' | 'command_run' | 'search_query' | 'user_message' | 'agent_response' | 'decision' | 'error' | 'preference_expressed' | 'goal_stated' | 'constraint_identified' | 'workflow_step' | 'milestone' | 'external_event';
+export type ObservationSource = 'hook-automatic' | 'hook-manual' | 'extraction-derived' | 'import-external';
+export interface ObservationMetadata {
+    filePath?: string;
+    fileLine?: number;
+    fileRange?: [number, number];
+    projectPath?: string;
+    gitBranch?: string;
+    gitCommit?: string;
+    agentModel?: string;
+    agentProvider?: string;
+    isNoisy?: boolean;
+    isFlagged?: boolean;
+    flagReason?: string;
+    [key: string]: unknown;
+}
+export interface Observation {
+    id: string;
+    frameId: string;
+    type: ObservationType;
+    subtype?: string;
+    content: string;
+    tool: string;
+    input?: Record<string, unknown>;
+    output?: string;
+    timestamp: number;
+    sessionId: string;
+    sequenceNumber: number;
+    source: ObservationSource;
+    confidence: number;
+    parentId?: string;
+    relatedIds?: string[];
+    metadata: ObservationMetadata;
+}
+export type MemoryKind = 'fact' | 'preference' | 'goal' | 'profile';
+export type VersionRelation = 'replaces' | 'extends' | 'narrows';
+export interface MemoryCard {
+    id: string;
+    frameId: string;
+    entity: string;
+    slot: string;
+    value: string;
+    kind: MemoryKind;
+    confidence: number;
+    sourceObservationId?: string;
+    documentDate?: number;
+    versionRelation?: VersionRelation;
+    previousValue?: string;
+    metadata?: Record<string, unknown>;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface MemoryCardIndex {
+    byEntity: Map<string, Set<string>>;
+    bySlot: Map<string, Set<string>>;
+    byKind: Map<MemoryKind, Set<string>>;
+}
+export type TombstoneReason = 'user_request' | 'low_confidence' | 'contradicted' | 'outdated' | 'duplicate' | 'error';
+export type TombstoneSource = 'user' | 'review' | 'auto-confidence' | 'auto-contradict' | 'import' | 'migration';
+export type TombstoneStatus = 'pending' | 'confirmed' | 'reverted';
+export interface TombstoneEntry {
+    frameId: string;
+    reason: TombstoneReason;
+    source: TombstoneSource;
+    confidence?: number;
+    replacedBy?: string;
+    createdAt: number;
+    status: TombstoneStatus;
+    notes?: string;
+}
+export interface TombstoneIndex {
+    version: number;
+    entries: Record<string, TombstoneEntry>;
+    lastUpdated: number;
+}
+export type SessionStatus = 'active' | 'idle' | 'ended';
+export interface SessionStats {
+    totalObservations: number;
+    memoryCardsCreated: number;
+    memoryCardsUpdated: number;
+    tombstonesCreated: number;
+    errors: number;
+}
+export interface Session {
+    id: string;
+    status: SessionStatus;
+    startedAt: number;
+    endedAt?: number;
+    lastActivityAt: number;
+    summary?: SessionSummary;
+    stats: SessionStats;
+    metadata?: Record<string, unknown>;
+}
+export interface SessionSummary {
+    generatedAt: number;
+    observationCount: number;
+    topObservationTypes: Array<{
+        type: ObservationType;
+        count: number;
+    }>;
+    keyDecisions: string[];
+    preferencesLearned: string[];
+    goalsIdentified: string[];
+    filesModified: string[];
+    topics: string[];
+    confidence: number;
+}
+export interface ExtractionRule {
+    name: string;
+    priority: number;
+    enabled: boolean;
+    pattern: RegExp;
+    matchFields: MatchField[];
+    kind: MemoryKind;
+    entityTemplate: string;
+    slotTemplate: string;
+    valueTemplate: string;
+    polarity?: 'positive' | 'negative';
+    versionRelation?: VersionRelation;
+    validators?: RuleValidator[];
+    description?: string;
+    examples?: string[];
+}
+export type MatchField = 'content' | 'output' | 'input' | 'title';
+export interface RuleValidator {
+    type: 'regex' | 'enum' | 'range' | 'custom';
+    config: unknown;
+    errorMessage?: string;
+}
+export interface EnrichmentContext {
+    frameId: string;
+    sourceUri: string;
+    text: string;
+    title?: string;
+    input?: Record<string, unknown>;
+    output?: string;
+    metadata?: Record<string, unknown>;
+    timestamp?: number;
+}
+export interface EnrichmentResult {
+    cards: MemoryCard[];
+    matchedRules: string[];
+    skippedRules: string[];
+    errors: Array<{
+        rule: string;
+        error: string;
+    }>;
+    source: 'rules' | 'llm' | 'hybrid';
+    processingTimeMs: number;
+}
+export interface ConfidenceScore {
+    score: number;
+    factors: string[];
+    shouldFlag: boolean;
+    shouldTombstone: boolean;
+}
+export interface ContextOptions {
+    maxTokens: number;
+    prioritizeRecent: boolean;
+    prioritizeRelevant: boolean;
+    includeObservations: boolean;
+    includeMemoryCards: boolean;
+    includeEpisodes: boolean;
+    includeSessionSummary: boolean;
+    since?: number;
+    entity?: string;
+    types?: ObservationType[];
+    format: 'markdown' | 'json' | 'plain';
+}
+export interface ContextBlock {
+    content: string;
+    tokenCount: number;
+    included: {
+        observations: number;
+        memoryCards: number;
+        episodes: number;
+        sessionSummaries: number;
+    };
+    excluded: {
+        observations: number;
+        memoryCards: number;
+        episodes: number;
+    };
+    sources: string[];
+}
+export type Polarity = 'positive' | 'negative';
+export interface ProceduralState {
+    type: string;
+    data: Record<string, unknown>;
+    hash: string;
+}
+export interface ProceduralAction {
+    tool: string;
+    input: Record<string, unknown>;
+    summary: string;
+}
+export interface ProceduralResult {
+    success: boolean;
+    output?: string;
+    error?: string;
+}
+export interface SARTuple {
+    id: string;
+    sessionId: string;
+    timestamp: number;
+    state: ProceduralState;
+    action: ProceduralAction;
+    result: ProceduralResult;
+    confidence: number;
+    workflowId?: string;
+    sequenceNumber: number;
+}
+export interface WorkflowPattern {
+    id: string;
+    name: string;
+    description: string;
+    steps: Array<{
+        statePattern: ProceduralState;
+        suggestedAction: ProceduralAction;
+        expectedResult: Partial<ProceduralResult>;
+    }>;
+    occurrences: number;
+    lastTriggered?: number;
+    confidence: number;
+}
+export declare enum ErrorSeverity {
+    TRANSIENT = "transient",
+    RECOVERABLE = "recoverable",
+    DATA_LOSS = "data_loss",
+    PERMANENT = "permanent"
+}
+export declare enum ErrorCode {
+    MV2_OPEN_FAILED = "MV2_OPEN_FAILED",
+    MV2_WRITE_FAILED = "MV2_WRITE_FAILED",
+    MV2_CORRUPTED = "MV2_CORRUPTED",
+    MV2_LOCK_TIMEOUT = "MV2_LOCK_TIMEOUT",
+    RULES_MATCH_FAILED = "RULES_MATCH_FAILED",
+    LLM_TIMEOUT = "LLM_TIMEOUT",
+    LLM_RATE_LIMIT = "LLM_RATE_LIMIT",
+    LLM_INVALID_RESPONSE = "LLM_INVALID_RESPONSE",
+    EMBEDDING_LOAD_FAILED = "EMBEDDING_LOAD_FAILED",
+    EMBEDDING_TIMEOUT = "EMBEDDING_TIMEOUT",
+    CONTEXT_BUILD_FAILED = "CONTEXT_BUILD_FAILED",
+    TOKEN_BUDGET_EXCEEDED = "TOKEN_BUDGET_EXCEEDED",
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    FILE_PERMISSION = "FILE_PERMISSION",
+    FILE_LOCKED = "FILE_LOCKED",
+    CONFIG_INVALID = "CONFIG_INVALID",
+    CONFIG_MISSING = "CONFIG_MISSING",
+    HOOK_TIMEOUT = "HOOK_TIMEOUT",
+    HOOK_FAILED = "HOOK_FAILED"
+}
+export interface VmemError extends Error {
+    code: ErrorCode;
+    severity: ErrorSeverity;
+    recoverable: boolean;
+    recoveryHint?: string;
+    context?: Record<string, unknown>;
+}
+export interface VmemConfig {
+    memoryPath: string;
+    capture: {
+        enabled: boolean;
+        observedTools: string[];
+        skipPatterns: RegExp[];
+        minOutputLength: number;
+    };
+    extraction: {
+        rulesEnabled: boolean;
+        llmEnabled: boolean;
+        llmProvider: 'zai' | 'openai';
+        llmModel: string;
+        llmApiKey?: string;
+        batchSize: number;
+    };
+    confidence: {
+        acceptThreshold: number;
+        flagThreshold: number;
+        autoTombstone: boolean;
+    };
+    context: {
+        maxTokens: number;
+        format: 'markdown' | 'json';
+        includeObservations: boolean;
+        includeMemoryCards: boolean;
+        includeProcedures: boolean;
+    };
+    embedding: {
+        enabled: boolean;
+        model: string;
+        cacheDir: string;
+        dimension: number;
+    };
+    optimization: {
+        autoArchive: boolean;
+        archiveAfterDays: number;
+        keepBackups: number;
+    };
+}
+export declare const defaultConfig: VmemConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,69 @@
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["TRANSIENT"] = "transient";
+    ErrorSeverity["RECOVERABLE"] = "recoverable";
+    ErrorSeverity["DATA_LOSS"] = "data_loss";
+    ErrorSeverity["PERMANENT"] = "permanent";
+})(ErrorSeverity || (ErrorSeverity = {}));
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["MV2_OPEN_FAILED"] = "MV2_OPEN_FAILED";
+    ErrorCode["MV2_WRITE_FAILED"] = "MV2_WRITE_FAILED";
+    ErrorCode["MV2_CORRUPTED"] = "MV2_CORRUPTED";
+    ErrorCode["MV2_LOCK_TIMEOUT"] = "MV2_LOCK_TIMEOUT";
+    ErrorCode["RULES_MATCH_FAILED"] = "RULES_MATCH_FAILED";
+    ErrorCode["LLM_TIMEOUT"] = "LLM_TIMEOUT";
+    ErrorCode["LLM_RATE_LIMIT"] = "LLM_RATE_LIMIT";
+    ErrorCode["LLM_INVALID_RESPONSE"] = "LLM_INVALID_RESPONSE";
+    ErrorCode["EMBEDDING_LOAD_FAILED"] = "EMBEDDING_LOAD_FAILED";
+    ErrorCode["EMBEDDING_TIMEOUT"] = "EMBEDDING_TIMEOUT";
+    ErrorCode["CONTEXT_BUILD_FAILED"] = "CONTEXT_BUILD_FAILED";
+    ErrorCode["TOKEN_BUDGET_EXCEEDED"] = "TOKEN_BUDGET_EXCEEDED";
+    ErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    ErrorCode["FILE_PERMISSION"] = "FILE_PERMISSION";
+    ErrorCode["FILE_LOCKED"] = "FILE_LOCKED";
+    ErrorCode["CONFIG_INVALID"] = "CONFIG_INVALID";
+    ErrorCode["CONFIG_MISSING"] = "CONFIG_MISSING";
+    ErrorCode["HOOK_TIMEOUT"] = "HOOK_TIMEOUT";
+    ErrorCode["HOOK_FAILED"] = "HOOK_FAILED";
+})(ErrorCode || (ErrorCode = {}));
+export const defaultConfig = {
+    memoryPath: '.opencode/memory/mind.mv2',
+    capture: {
+        enabled: true,
+        observedTools: ['read', 'write', 'edit', 'bash', 'grep', 'glob'],
+        skipPatterns: [/^\s*$/],
+        minOutputLength: 50
+    },
+    extraction: {
+        rulesEnabled: true,
+        llmEnabled: true,
+        llmProvider: 'zai',
+        llmModel: 'glm-5',
+        batchSize: 10
+    },
+    confidence: {
+        acceptThreshold: 0.8,
+        flagThreshold: 0.4,
+        autoTombstone: true
+    },
+    context: {
+        maxTokens: 3000,
+        format: 'markdown',
+        includeObservations: true,
+        includeMemoryCards: true,
+        includeProcedures: true
+    },
+    embedding: {
+        enabled: true,
+        model: 'Xenova/nomic-embed-text-v1',
+        cacheDir: '.opencode/memory/models/',
+        dimension: 768
+    },
+    optimization: {
+        autoArchive: false,
+        archiveAfterDays: 30,
+        keepBackups: 5
+    }
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA0RA,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,wCAAuB,CAAA;IACvB,4CAA2B,CAAA;IAC3B,wCAAuB,CAAA;IACvB,wCAAuB,CAAA;AACzB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAED,MAAM,CAAN,IAAY,SAoBX;AApBD,WAAY,SAAS;IACnB,gDAAmC,CAAA;IACnC,kDAAqC,CAAA;IACrC,4CAA+B,CAAA;IAC/B,kDAAqC,CAAA;IACrC,sDAAyC,CAAA;IACzC,wCAA2B,CAAA;IAC3B,8CAAiC,CAAA;IACjC,0DAA6C,CAAA;IAC7C,4DAA+C,CAAA;IAC/C,oDAAuC,CAAA;IACvC,0DAA6C,CAAA;IAC7C,4DAA+C,CAAA;IAC/C,8CAAiC,CAAA;IACjC,gDAAmC,CAAA;IACnC,wCAA2B,CAAA;IAC3B,8CAAiC,CAAA;IACjC,8CAAiC,CAAA;IACjC,0CAA6B,CAAA;IAC7B,wCAA2B,CAAA;AAC7B,CAAC,EApBW,SAAS,KAAT,SAAS,QAoBpB;AAmDD,MAAM,CAAC,MAAM,aAAa,GAAe;IACvC,UAAU,EAAE,2BAA2B;IACvC,OAAO,EAAE;QACP,OAAO,EAAE,IAAI;QACb,aAAa,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAChE,YAAY,EAAE,CAAC,OAAO,CAAC;QACvB,eAAe,EAAE,EAAE;KACpB;IACD,UAAU,EAAE;QACV,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,OAAO;QACjB,SAAS,EAAE,EAAE;KACd;IACD,UAAU,EAAE;QACV,eAAe,EAAE,GAAG;QACpB,aAAa,EAAE,GAAG;QAClB,aAAa,EAAE,IAAI;KACpB;IACD,OAAO,EAAE;QACP,SAAS,EAAE,IAAI;QACf,MAAM,EAAE,UAAU;QAClB,mBAAmB,EAAE,IAAI;QACzB,kBAAkB,EAAE,IAAI;QACxB,iBAAiB,EAAE,IAAI;KACxB;IACD,SAAS,EAAE;QACT,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,4BAA4B;QACnC,QAAQ,EAAE,0BAA0B;QACpC,SAAS,EAAE,GAAG;KACf;IACD,YAAY,EAAE;QACZ,WAAW,EAAE,KAAK;QAClB,gBAAgB,EAAE,EAAE;QACpB,WAAW,EAAE,CAAC;KACf;CACF,CAAC"}

package/dist/utils/error.d.ts

@@ -0,0 +1,57 @@
+export declare enum ErrorSeverity {
+    TRANSIENT = "transient",
+    RECOVERABLE = "recoverable",
+    DATA_LOSS = "data_loss",
+    PERMANENT = "permanent"
+}
+export declare enum ErrorCode {
+    MV2_OPEN_FAILED = "MV2_OPEN_FAILED",
+    MV2_WRITE_FAILED = "MV2_WRITE_FAILED",
+    MV2_CORRUPTED = "MV2_CORRUPTED",
+    MV2_LOCK_TIMEOUT = "MV2_LOCK_TIMEOUT",
+    RULES_MATCH_FAILED = "RULES_MATCH_FAILED",
+    LLM_TIMEOUT = "LLM_TIMEOUT",
+    LLM_RATE_LIMIT = "LLM_RATE_LIMIT",
+    LLM_INVALID_RESPONSE = "LLM_INVALID_RESPONSE",
+    EMBEDDING_LOAD_FAILED = "EMBEDDING_LOAD_FAILED",
+    EMBEDDING_TIMEOUT = "EMBEDDING_TIMEOUT",
+    CONTEXT_BUILD_FAILED = "CONTEXT_BUILD_FAILED",
+    TOKEN_BUDGET_EXCEEDED = "TOKEN_BUDGET_EXCEEDED",
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    FILE_PERMISSION = "FILE_PERMISSION",
+    FILE_LOCKED = "FILE_LOCKED",
+    CONFIG_INVALID = "CONFIG_INVALID",
+    CONFIG_MISSING = "CONFIG_MISSING",
+    HOOK_TIMEOUT = "HOOK_TIMEOUT",
+    HOOK_FAILED = "HOOK_FAILED"
+}
+export declare class VmemError extends Error {
+    readonly code: ErrorCode;
+    readonly severity: ErrorSeverity;
+    readonly recoverable: boolean;
+    readonly recoveryHint?: string | undefined;
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, code: ErrorCode, severity?: ErrorSeverity, recoverable?: boolean, recoveryHint?: string | undefined, context?: Record<string, unknown> | undefined);
+    static transient(message: string, code: ErrorCode, context?: Record<string, unknown>): VmemError;
+    static recoverable(message: string, code: ErrorCode, hint?: string, context?: Record<string, unknown>): VmemError;
+    static dataLoss(message: string, code: ErrorCode, context?: Record<string, unknown>): VmemError;
+    static permanent(message: string, code: ErrorCode, hint?: string, context?: Record<string, unknown>): VmemError;
+    toJSON(): object;
+}
+export interface RecoveryStrategy {
+    errorCodes: ErrorCode[];
+    maxAttempts: number;
+    backoffMs: number;
+    recovery: (error: VmemError, attempt: number) => Promise<boolean>;
+}
+export declare function sleep(ms: number): Promise<void>;
+export declare function withRetry<T>(fn: () => Promise<T>, options?: {
+    maxAttempts?: number;
+    backoffMs?: number;
+    shouldRetry?: (error: Error) => boolean;
+}): Promise<T>;
+export declare function formatErrorForUser(error: VmemError): string;
+export declare const HOOK_TIMEOUTS: Record<string, number>;
+export declare function withTimeout<T>(fn: () => Promise<T>, timeoutMs: number, hookName?: string): Promise<T | undefined>;
+export declare function wrapHook<T extends (...args: any[]) => Promise<any>>(hookName: string, handler: T): T;
+//# sourceMappingURL=error.d.ts.map

package/dist/utils/error.d.ts.map

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

package/dist/utils/error.js

@@ -0,0 +1,143 @@
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    ErrorSeverity["TRANSIENT"] = "transient";
+    ErrorSeverity["RECOVERABLE"] = "recoverable";
+    ErrorSeverity["DATA_LOSS"] = "data_loss";
+    ErrorSeverity["PERMANENT"] = "permanent";
+})(ErrorSeverity || (ErrorSeverity = {}));
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["MV2_OPEN_FAILED"] = "MV2_OPEN_FAILED";
+    ErrorCode["MV2_WRITE_FAILED"] = "MV2_WRITE_FAILED";
+    ErrorCode["MV2_CORRUPTED"] = "MV2_CORRUPTED";
+    ErrorCode["MV2_LOCK_TIMEOUT"] = "MV2_LOCK_TIMEOUT";
+    ErrorCode["RULES_MATCH_FAILED"] = "RULES_MATCH_FAILED";
+    ErrorCode["LLM_TIMEOUT"] = "LLM_TIMEOUT";
+    ErrorCode["LLM_RATE_LIMIT"] = "LLM_RATE_LIMIT";
+    ErrorCode["LLM_INVALID_RESPONSE"] = "LLM_INVALID_RESPONSE";
+    ErrorCode["EMBEDDING_LOAD_FAILED"] = "EMBEDDING_LOAD_FAILED";
+    ErrorCode["EMBEDDING_TIMEOUT"] = "EMBEDDING_TIMEOUT";
+    ErrorCode["CONTEXT_BUILD_FAILED"] = "CONTEXT_BUILD_FAILED";
+    ErrorCode["TOKEN_BUDGET_EXCEEDED"] = "TOKEN_BUDGET_EXCEEDED";
+    ErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    ErrorCode["FILE_PERMISSION"] = "FILE_PERMISSION";
+    ErrorCode["FILE_LOCKED"] = "FILE_LOCKED";
+    ErrorCode["CONFIG_INVALID"] = "CONFIG_INVALID";
+    ErrorCode["CONFIG_MISSING"] = "CONFIG_MISSING";
+    ErrorCode["HOOK_TIMEOUT"] = "HOOK_TIMEOUT";
+    ErrorCode["HOOK_FAILED"] = "HOOK_FAILED";
+})(ErrorCode || (ErrorCode = {}));
+export class VmemError extends Error {
+    code;
+    severity;
+    recoverable;
+    recoveryHint;
+    context;
+    constructor(message, code, severity = ErrorSeverity.RECOVERABLE, recoverable = true, recoveryHint, context) {
+        super(message);
+        this.code = code;
+        this.severity = severity;
+        this.recoverable = recoverable;
+        this.recoveryHint = recoveryHint;
+        this.context = context;
+        this.name = 'VmemError';
+    }
+    static transient(message, code, context) {
+        return new VmemError(message, code, ErrorSeverity.TRANSIENT, true, undefined, context);
+    }
+    static recoverable(message, code, hint, context) {
+        return new VmemError(message, code, ErrorSeverity.RECOVERABLE, true, hint, context);
+    }
+    static dataLoss(message, code, context) {
+        return new VmemError(message, code, ErrorSeverity.DATA_LOSS, true, 'Restore from backup', context);
+    }
+    static permanent(message, code, hint, context) {
+        return new VmemError(message, code, ErrorSeverity.PERMANENT, false, hint, context);
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            severity: this.severity,
+            recoverable: this.recoverable,
+            recoveryHint: this.recoveryHint,
+            context: this.context
+        };
+    }
+}
+export function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+export async function withRetry(fn, options = {}) {
+    const { maxAttempts = 3, backoffMs = 100, shouldRetry = () => true } = options;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt === maxAttempts || !shouldRetry(lastError)) {
+                throw lastError;
+            }
+            await sleep(backoffMs * attempt);
+        }
+    }
+    throw lastError;
+}
+export function formatErrorForUser(error) {
+    switch (error.code) {
+        case ErrorCode.LLM_TIMEOUT:
+            return 'Memory extraction timed out. Using fast extraction only.';
+        case ErrorCode.LLM_RATE_LIMIT:
+            return 'API rate limit reached. Using cached patterns only.';
+        case ErrorCode.EMBEDDING_LOAD_FAILED:
+            return 'Could not load embedding model. Keyword search only.';
+        case ErrorCode.MV2_CORRUPTED:
+            return 'Memory file corrupted. Attempting to restore from backup...';
+        case ErrorCode.FILE_PERMISSION:
+            return 'Permission denied. Check file permissions for .opencode/memory/';
+        case ErrorCode.CONFIG_INVALID:
+            return `Invalid configuration: ${error.message}`;
+        case ErrorCode.FILE_NOT_FOUND:
+            return `File not found: ${error.context?.path || 'unknown'}`;
+        default:
+            return `Memory system error: ${error.message}`;
+    }
+}
+export const HOOK_TIMEOUTS = {
+    'tool.execute.after': 50,
+    'session.idle': 5000,
+    'system.transform': 100,
+    'session.created': 500,
+    'session.compacting': 200
+};
+export async function withTimeout(fn, timeoutMs, hookName) {
+    try {
+        return await Promise.race([
+            fn(),
+            new Promise((_, reject) => setTimeout(() => reject(new VmemError(`Hook ${hookName || 'operation'} timed out`, ErrorCode.HOOK_TIMEOUT, ErrorSeverity.RECOVERABLE)), timeoutMs))
+        ]);
+    }
+    catch (error) {
+        if (error instanceof VmemError && error.code === ErrorCode.HOOK_TIMEOUT) {
+            console.warn(`[vmem] ${error.message}`);
+            return undefined;
+        }
+        throw error;
+    }
+}
+export function wrapHook(hookName, handler) {
+    const timeout = HOOK_TIMEOUTS[hookName] ?? 1000;
+    return (async (...args) => {
+        try {
+            return await withTimeout(() => handler(...args), timeout, hookName);
+        }
+        catch (error) {
+            console.error(`[vmem] Hook ${hookName} failed:`, error instanceof Error ? error.message : String(error));
+            return undefined;
+        }
+    });
+}
+//# sourceMappingURL=error.js.map

package/dist/utils/error.js.map

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

package/dist/utils/uuid.d.ts

@@ -0,0 +1,2 @@
+export declare function uuid(): string;
+//# sourceMappingURL=uuid.d.ts.map

package/dist/utils/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../src/utils/uuid.ts"],"names":[],"mappings":"AAEA,wBAAgB,IAAI,IAAI,MAAM,CAE7B"}

package/dist/utils/uuid.js

@@ -0,0 +1,5 @@
+import { randomUUID } from 'crypto';
+export function uuid() {
+    return randomUUID();
+}
+//# sourceMappingURL=uuid.js.map

package/dist/utils/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../src/utils/uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,MAAM,UAAU,IAAI;IAClB,OAAO,UAAU,EAAE,CAAC;AACtB,CAAC"}