clawvault 3.2.1 → 3.3.0

package/dist/ledger-B7g7jhqG.d.ts

@@ -1,44 +0,0 @@
-import { LedgerEntry, LedgerOp } from './workgraph/types.js';
-
-/**
- * Append-only event ledger.
- *
- * Every mutation to the workgraph is logged here. This is the source of truth
- * for coordination: who claimed what, when, and what's available.
- *
- * Format: one JSON object per line (.jsonl) in `.clawvault/ledger.jsonl`.
- * Agents read the ledger to know the state of the world.
- */
-
-declare function ledgerPath(vaultPath: string): string;
-declare function append(vaultPath: string, actor: string, op: LedgerOp, target: string, type?: string, data?: Record<string, unknown>): LedgerEntry;
-declare function readAll(vaultPath: string): LedgerEntry[];
-declare function readSince(vaultPath: string, since: string): LedgerEntry[];
-/** Get the current owner of a target (last claim without a subsequent release/done). */
-declare function currentOwner(vaultPath: string, target: string): string | null;
-/** Check if a target is currently claimed by any agent. */
-declare function isClaimed(vaultPath: string, target: string): boolean;
-/** Get all entries for a specific target. */
-declare function historyOf(vaultPath: string, target: string): LedgerEntry[];
-/** Get all entries by a specific actor. */
-declare function activityOf(vaultPath: string, actor: string): LedgerEntry[];
-/** Get all currently claimed targets and their owners. */
-declare function allClaims(vaultPath: string): Map<string, string>;
-/** Get recent ledger entries (last N). */
-declare function recent(vaultPath: string, count?: number): LedgerEntry[];
-
-declare const ledger_activityOf: typeof activityOf;
-declare const ledger_allClaims: typeof allClaims;
-declare const ledger_append: typeof append;
-declare const ledger_currentOwner: typeof currentOwner;
-declare const ledger_historyOf: typeof historyOf;
-declare const ledger_isClaimed: typeof isClaimed;
-declare const ledger_ledgerPath: typeof ledgerPath;
-declare const ledger_readAll: typeof readAll;
-declare const ledger_readSince: typeof readSince;
-declare const ledger_recent: typeof recent;
-declare namespace ledger {
-  export { ledger_activityOf as activityOf, ledger_allClaims as allClaims, ledger_append as append, ledger_currentOwner as currentOwner, ledger_historyOf as historyOf, ledger_isClaimed as isClaimed, ledger_ledgerPath as ledgerPath, ledger_readAll as readAll, ledger_readSince as readSince, ledger_recent as recent };
-}
-
-export { activityOf as a, allClaims as b, append as c, currentOwner as d, ledgerPath as e, readSince as f, recent as g, historyOf as h, isClaimed as i, ledger as l, readAll as r };

package/dist/plugin/index.d.ts

@@ -1,352 +0,0 @@
-/**
- * ClawVault Plugin v2 — Type definitions
- */
-interface FieldDef {
-    type: 'string' | 'number' | 'boolean' | 'datetime' | 'date';
-    required?: boolean;
-    default?: string | number | boolean;
-    enum?: string[];
-    description?: string;
-}
-interface TemplateSchema {
-    primitive: string;
-    description?: string;
-    fields: Record<string, FieldDef>;
-    bodyTemplate?: string;
-    keywords?: string[];
-}
-interface TemplateRegistry {
-    schemas: Map<string, TemplateSchema>;
-    keywordIndex: Map<string, string[]>;
-    initialized: boolean;
-}
-interface ClassificationResult {
-    primitiveType: string;
-    confidence: number;
-    matchedKeywords: string[];
-}
-interface Observation {
-    text: string;
-    primitiveType: string;
-    confidence: number;
-    matchedKeywords: string[];
-    category: string;
-    tags: string[];
-    extractedAt: Date;
-}
-interface ObservationResult {
-    observations: Observation[];
-    skipped: number;
-    reason?: string;
-}
-interface VaultFile {
-    path: string;
-    relativePath: string;
-    primitiveType: string;
-    frontmatter: Record<string, unknown>;
-    content: string;
-    modifiedAt: Date;
-    createdAt: Date;
-}
-interface WriteResult {
-    success: boolean;
-    path: string;
-    primitiveType: string;
-    errors: string[];
-    created: boolean;
-    updated: boolean;
-}
-interface WriteOptions {
-    primitiveType?: string;
-    title?: string;
-    content?: string;
-    extraFields?: Record<string, unknown>;
-    source?: string;
-    sessionId?: string;
-    directory?: string;
-    filename?: string;
-    overwrite?: boolean;
-}
-interface LedgerEntry {
-    timestamp: Date;
-    category?: string;
-    actor?: string;
-    content: string;
-    primitiveType?: string;
-    tags?: string[];
-}
-interface BatchWriteOptions {
-    source?: string;
-    sessionId?: string;
-    actor?: string;
-    writeLedger?: boolean;
-    writeFiles?: boolean;
-}
-interface BatchWriteResult {
-    total: number;
-    successful: number;
-    failed: number;
-    results: WriteResult[];
-}
-interface ScanOptions {
-    maxAge?: number;
-    limit?: number;
-    primitiveTypes?: string[];
-}
-interface SessionRecapResult {
-    xml: string;
-    fileCount: number;
-    primitiveGroups: Record<string, number>;
-    timeRange: {
-        oldest: Date;
-        newest: Date;
-    } | null;
-}
-interface PreferenceContextResult {
-    xml: string;
-    preferenceCount: number;
-    categories: string[];
-}
-interface QmdResult {
-    file?: string;
-    title?: string;
-    snippet?: string;
-    score?: number;
-}
-type MemoryScope = 'global' | `agent:${string}` | `project:${string}` | `user:${string}`;
-interface RetrievalConfig {
-    /** BM25 weight in RRF fusion (default: 0.5) */
-    bm25Weight: number;
-    /** Semantic weight in RRF fusion (default: 0.5) */
-    semanticWeight: number;
-    /** RRF k parameter (default: 60) */
-    rrfK: number;
-    /** Max results to return (default: 10) */
-    topK: number;
-    /** Minimum score threshold (default: 0.01) */
-    minScore: number;
-    /** Recency boost half-life in days (default: 14, 0 = disabled) */
-    recencyHalfLifeDays: number;
-    /** Recency boost weight (default: 0.10) */
-    recencyWeight: number;
-    /** Time decay half-life in days (default: 60, 0 = disabled) */
-    decayHalfLifeDays: number;
-    /** Length normalization anchor in chars (default: 500, 0 = disabled) */
-    lengthNormAnchor: number;
-    /** MMR lambda for diversity (default: 0.7, 1.0 = no diversity) */
-    mmrLambda: number;
-    /** Reranker provider (default: none) */
-    rerankProvider?: 'jina' | 'voyage' | 'siliconflow' | 'pinecone';
-    /** Reranker API key */
-    rerankApiKey?: string;
-    /** Reranker model name */
-    rerankModel?: string;
-    /** Reranker endpoint URL */
-    rerankEndpoint?: string;
-    /** Reranker weight vs fused score (default: 0.6) */
-    rerankWeight: number;
-}
-interface PluginConfig {
-    vaultPath?: string;
-    agentVaults?: Record<string, string>;
-    collection?: string;
-    autoRecall?: boolean;
-    autoCapture?: boolean;
-    recallLimit?: number;
-    templatesDir?: string;
-    autoCheckpoint?: boolean;
-    contextProfile?: 'default' | 'planning' | 'incident' | 'handoff' | 'auto';
-    maxContextResults?: number;
-    observeOnHeartbeat?: boolean;
-    weeklyReflection?: boolean;
-    /** Retrieval pipeline config */
-    retrieval?: Partial<RetrievalConfig>;
-    /** Noise filter config */
-    noise?: {
-        enabled?: boolean;
-        minLength?: number;
-        maxLength?: number;
-    };
-    /** Adaptive retrieval config */
-    adaptive?: {
-        enabled?: boolean;
-        skipPatterns?: string[];
-    };
-    /** Default memory scope */
-    defaultScope?: MemoryScope;
-}
-interface PluginLogger {
-    info(msg: string): void;
-    warn(msg: string): void;
-    error(msg: string): void;
-    debug(msg: string): void;
-}
-interface ToolDefinition {
-    name: string;
-    label: string;
-    description: string;
-    parameters: unknown;
-    execute(id: string, params: Record<string, unknown>): Promise<ToolResult>;
-}
-interface ToolResult {
-    content: Array<{
-        type: string;
-        text: string;
-    }>;
-    details?: Record<string, unknown>;
-    isError?: boolean;
-}
-interface ServiceDefinition {
-    id: string;
-    start: () => void;
-    stop: () => void;
-}
-interface CommandDefinition {
-    name: string;
-    description: string;
-    acceptsArgs?: boolean;
-    requireAuth?: boolean;
-    handler: (ctx: {
-        args?: string;
-    }) => {
-        text: string;
-    };
-}
-type EventHandler = (event: Record<string, unknown>) => Promise<unknown>;
-interface PluginApi {
-    pluginConfig: PluginConfig;
-    logger: PluginLogger;
-    registerTool(tool: ToolDefinition): void;
-    registerService(service: ServiceDefinition): void;
-    registerCommand(command: CommandDefinition): void;
-    registerCli(fn: (ctx: {
-        program: unknown;
-    }) => void, opts?: {
-        commands: string[];
-    }): void;
-    on(event: string, handler: EventHandler, opts?: {
-        priority?: number;
-    }): void;
-}
-interface Plugin {
-    id: string;
-    name: string;
-    description: string;
-    version: string;
-    kind: string;
-    register(api: PluginApi): void;
-}
-
-/**
- * ClawVault Plugin v2 — Template engine
- *
- * Manages typed primitive schemas (memory_event, person, decision, task, etc.)
- * with keyword-based classification, frontmatter generation, and validation.
- */
-
-declare function getTemplateRegistry(): TemplateRegistry;
-declare function initializeTemplateRegistry(templatesDir?: string): TemplateRegistry;
-declare function classifyText(text: string): ClassificationResult;
-declare function getSchema(primitiveType: string): TemplateSchema | undefined;
-declare function getAllSchemas(): TemplateSchema[];
-declare function getSchemaNames(): string[];
-
-/**
- * ClawVault Plugin v2 — Noise Filter
- *
- * Filters low-quality content on both write and read paths:
- * - Refusals ("I can't help with that")
- * - Meta-questions ("How does it feel to be an AI?")
- * - Greetings ("Hello!", "Hi there")
- * - Low-information content (too short, too repetitive)
- * - System noise (heartbeats, tool calls, JSON blobs)
- */
-interface NoiseFilterConfig {
-    enabled: boolean;
-    minLength: number;
-    maxLength: number;
-}
-
-/**
- * ClawVault Plugin v2 — Observer / Session Parser
- *
- * Extracts observations from conversation messages:
- * - Detects preferences, decisions, facts, tasks, lessons
- * - Classifies against template schemas
- * - Generates tags and categories
- */
-
-/**
- * Check if text is worth observing (not system noise, not too short/long).
- */
-declare function isObservable(text: string, noiseConfig?: NoiseFilterConfig): boolean;
-declare function extractObservations(text: string): Observation[];
-declare function processMessageForObservations(content: string, _options?: Record<string, unknown>): ObservationResult;
-declare function detectCategory(text: string): string;
-declare function extractSearchTerms(input: string): string;
-
-/**
- * ClawVault Plugin v2 — Context Injection
- *
- * Scans vault files and builds context for session injection:
- * - Session recaps (recent activity)
- * - Preference context
- * - Memory formatting for LLM consumption
- */
-
-declare function scanVaultFiles(vaultPath: string, options?: ScanOptions): VaultFile[];
-declare function buildSessionRecap(vaultPath: string, options?: {
-    maxAge?: number;
-    limit?: number;
-    includeContent?: boolean;
-}): SessionRecapResult;
-declare function buildPreferenceContext(vaultPath: string, options?: {
-    maxAge?: number;
-    limit?: number;
-}): PreferenceContextResult;
-declare function formatMemoriesForContext(results: QmdResult[], collection: string): string;
-declare function formatSearchResults(results: QmdResult[], collection: string): string;
-declare function buildFullContext(vaultPath: string, options?: {
-    includeRecap?: boolean;
-    includePreferences?: boolean;
-    recapMaxAge?: number;
-    preferenceMaxAge?: number;
-}): string;
-
-/**
- * ClawVault Plugin v2 — Vault file operations
- *
- * Handles writing, updating, and managing vault markdown files:
- * - Template-based file creation
- * - Frontmatter merge on update
- * - Observation writing to individual files and ledger
- * - Scope tagging for multi-scope support
- */
-
-declare function writeVaultFile(vaultPath: string, options: WriteOptions): WriteResult;
-declare function writeObservation(vaultPath: string, observation: Observation, options?: {
-    source?: string;
-    sessionId?: string;
-    scope?: MemoryScope;
-}): WriteResult;
-declare function appendToLedger(vaultPath: string, entry: LedgerEntry): void;
-declare function batchWriteObservations(vaultPath: string, observations: Observation[], options?: BatchWriteOptions): BatchWriteResult;
-declare function ensureVaultStructure(vaultPath: string): void;
-
-/**
- * ClawVault Plugin v2 — Main Entry Point
- *
- * OpenClaw memory plugin with:
- * - Template-driven typed primitives
- * - In-process hybrid retrieval (BM25 + Semantic + RRF)
- * - Cross-encoder rerank (optional, API-based)
- * - Recency boost + time decay
- * - Length normalization + MMR diversity
- * - Noise filtering + adaptive retrieval
- * - Multi-scope support (global, agent, project, user)
- * - Management CLI (stats, export, import, reembed)
- */
-
-declare const clawvaultPlugin: Plugin;
-
-export { appendToLedger, batchWriteObservations, buildFullContext, buildPreferenceContext, buildSessionRecap, classifyText, clawvaultPlugin as default, detectCategory, ensureVaultStructure, extractObservations, extractSearchTerms, formatMemoriesForContext, formatSearchResults, getAllSchemas, getSchema, getSchemaNames, getTemplateRegistry, initializeTemplateRegistry, isObservable, processMessageForObservations, scanVaultFiles, writeObservation, writeVaultFile };