@psiclawops/hypermem 0.1.0 → 0.5.0

package/dist/types.d.ts

@@ -1,329 +0,0 @@
-/**
- * HyperMem Core Types
- *
- * Provider-neutral message format and compositor interfaces.
- * These types are the internal representation — never sent directly to an LLM.
- * Provider translators convert to/from provider-specific formats at the boundary.
- */
-export type MessageRole = 'user' | 'assistant' | 'system';
-/**
- * Provider-neutral tool call representation.
- * Stored as JSON in the tool_calls column.
- */
-export interface NeutralToolCall {
-    id: string;
-    name: string;
-    arguments: string;
-}
-/**
- * Provider-neutral tool result representation.
- * Stored as JSON in the tool_results column.
- */
-export interface NeutralToolResult {
-    callId: string;
-    name: string;
-    content: string;
-    isError?: boolean;
-}
-/**
- * Provider-neutral message — the canonical storage format.
- */
-export interface NeutralMessage {
-    role: MessageRole;
-    textContent: string | null;
-    toolCalls: NeutralToolCall[] | null;
-    toolResults: NeutralToolResult[] | null;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Stored message with database fields.
- */
-export interface StoredMessage extends NeutralMessage {
-    id: number;
-    conversationId: number;
-    agentId: string;
-    messageIndex: number;
-    tokenCount: number | null;
-    isHeartbeat: boolean;
-    createdAt: string;
-}
-export type ChannelType = 'webchat' | 'discord' | 'telegram' | 'signal' | 'subagent' | 'heartbeat' | 'other';
-export type ConversationStatus = 'active' | 'ended' | 'archived';
-export interface Conversation {
-    id: number;
-    sessionKey: string;
-    sessionId: string | null;
-    agentId: string;
-    channelType: ChannelType;
-    channelId: string | null;
-    provider: string | null;
-    model: string | null;
-    status: ConversationStatus;
-    messageCount: number;
-    tokenCountIn: number;
-    tokenCountOut: number;
-    createdAt: string;
-    updatedAt: string;
-    endedAt: string | null;
-}
-export type FactScope = 'agent' | 'session' | 'user';
-/**
- * Memory visibility levels:
- * - private:  Only the owning agent can read. Identity, SOUL, personal reflections.
- * - org:      Agents in the same org (e.g., Forge's directors: Pylon, Vigil, Plane).
- * - council:  All council seats can read.
- * - fleet:    Any agent in the fleet can read.
- */
-export type MemoryVisibility = 'private' | 'org' | 'council' | 'fleet';
-/**
- * Cross-agent query request. The requesting agent declares who they are;
- * the access layer filters results by visibility.
- */
-export interface CrossAgentQuery {
-    /** The agent making the request */
-    requesterId: string;
-    /** The agent whose memory is being queried */
-    targetAgentId: string;
-    /** What to search for */
-    query?: string;
-    /** Filter by domain */
-    domain?: string;
-    /** Filter by memory type */
-    memoryType?: 'facts' | 'knowledge' | 'topics' | 'episodes' | 'messages';
-    /** Max results */
-    limit?: number;
-}
-/**
- * Defines an agent's org and tier for visibility resolution.
- */
-export interface AgentIdentity {
-    agentId: string;
-    tier: 'council' | 'director' | 'specialist' | 'worker';
-    org?: string;
-    councilLead?: string;
-}
-export interface Fact {
-    id: number;
-    agentId: string;
-    scope: FactScope;
-    domain: string | null;
-    content: string;
-    confidence: number;
-    visibility: string;
-    sourceType: string;
-    sourceSessionKey: string | null;
-    sourceRef: string | null;
-    createdAt: string;
-    updatedAt: string;
-    expiresAt: string | null;
-    supersededBy: number | null;
-    decayScore: number;
-}
-export type TopicStatus = 'active' | 'dormant' | 'closed';
-export interface Topic {
-    id: number;
-    agentId: string;
-    name: string;
-    description: string | null;
-    status: TopicStatus;
-    visibility: string;
-    lastSessionKey: string | null;
-    messageCount: number;
-    createdAt: string;
-    updatedAt: string;
-}
-export interface Knowledge {
-    id: number;
-    agentId: string;
-    domain: string;
-    key: string;
-    content: string;
-    confidence: number;
-    sourceType: string;
-    sourceRef: string | null;
-    createdAt: string;
-    updatedAt: string;
-    expiresAt: string | null;
-    supersededBy: number | null;
-}
-export type EpisodeType = 'decision' | 'incident' | 'discovery' | 'interaction' | 'milestone' | 'deployment' | 'config_change';
-export interface Episode {
-    id: number;
-    agentId: string;
-    eventType: EpisodeType;
-    summary: string;
-    significance: number;
-    visibility: string;
-    participants: string[] | null;
-    sessionKey: string | null;
-    createdAt: string;
-    decayScore: number;
-}
-export interface ComposeRequest {
-    agentId: string;
-    sessionKey: string;
-    tokenBudget: number;
-    provider?: string;
-    model?: string;
-    /** Agent tier (council/director/specialist) — used for tier-scoped doc chunk retrieval */
-    tier?: string;
-    includeHistory?: boolean;
-    /** Whether to include demand-loaded doc chunks based on conversation triggers */
-    includeDocChunks?: boolean;
-    historyDepth?: number;
-    includeFacts?: boolean;
-    includeContext?: boolean;
-    includeLibrary?: boolean;
-    /**
-     * The current-turn prompt text. Used as the retrieval query for semantic recall
-     * and doc chunk trigger matching. When provided, this is preferred over reading
-     * the last user message from the assembled history (which is one turn stale).
-     *
-     * Without this, retrieval fires against the previously-recorded user message,
-     * meaning first-turn retrieval is blind and all retrieval lags by one turn.
-     */
-    prompt?: string;
-    /**
-     * When true, skip provider-specific translation and return NeutralMessage[]
-     * instead of ProviderMessage[]. Used by the context engine plugin, which
-     * returns messages to the OpenClaw runtime for its own provider translation.
-     */
-    skipProviderTranslation?: boolean;
-}
-export interface SlotTokenCounts {
-    system: number;
-    identity: number;
-    history: number;
-    facts: number;
-    context: number;
-    library: number;
-}
-export interface ComposeResult {
-    messages: ProviderMessage[];
-    tokenCount: number;
-    slots: SlotTokenCounts;
-    /** True only when token budget was exceeded (remaining < 0). */
-    truncated: boolean;
-    /** True when any non-fatal warnings were emitted (soft failures, truncated slots, etc.). */
-    hasWarnings: boolean;
-    warnings: string[];
-    /**
-     * The assembled context block (facts, recall, episodes) as a plain string.
-     * Used by the plugin to pass as systemPromptAddition to the OpenClaw runtime.
-     * Omitted when no context was assembled.
-     */
-    contextBlock?: string;
-}
-/**
- * Provider-specific message format (output of compositor).
- * This is what gets sent to the LLM API.
- * The exact shape depends on the provider translator.
- */
-export interface ProviderMessage {
-    role: string;
-    content: unknown;
-    [key: string]: unknown;
-}
-/**
- * Tracks the most recently composed submission window boundary.
- * Written by compose() after every assembly, read by the background indexer
- * to identify high-signal unprocessed messages.
- *
- * Stored in Redis (hm:{a}:s:{s}:cursor) with dual-write to SQLite for
- * durability across Redis eviction (Compass Gate 2).
- */
-export interface SessionCursor {
-    /** StoredMessage.id of the newest message included in the last window */
-    lastSentId: number;
-    /** messageIndex of the newest message — for ordering guarantees */
-    lastSentIndex: number;
-    /** ISO timestamp of when the window was composed */
-    lastSentAt: string;
-    /** Number of messages in the composed window */
-    windowSize: number;
-    /** Token count of the composed window */
-    tokenCount: number;
-}
-export interface SessionSlots {
-    system: string | null;
-    identity: string | null;
-    history: StoredMessage[];
-    context: string | null;
-    facts: string | null;
-    tools: string | null;
-    meta: SessionMeta;
-}
-export interface SessionMeta {
-    agentId: string;
-    sessionKey: string;
-    provider: string | null;
-    model: string | null;
-    channelType: ChannelType;
-    tokenCount: number;
-    lastActive: string;
-    status: ConversationStatus;
-}
-export interface HyperMemConfig {
-    enabled: boolean;
-    dataDir: string;
-    redis: RedisConfig;
-    compositor: CompositorConfig;
-    indexer: IndexerConfig;
-    embedding: EmbeddingProviderConfig;
-}
-export interface EmbeddingProviderConfig {
-    /** Ollama base URL. Default: http://localhost:11434 */
-    ollamaUrl: string;
-    /** Embedding model name. Default: nomic-embed-text */
-    model: string;
-    /** Embedding dimensions. Default: 768 */
-    dimensions: number;
-    /** Request timeout ms. Default: 10000 */
-    timeout: number;
-    /** Max texts per batch request. Default: 32 */
-    batchSize: number;
-}
-export interface RedisConfig {
-    host: string;
-    port: number;
-    password?: string;
-    keyPrefix: string;
-    sessionTTL: number;
-    historyTTL: number;
-    flushInterval: number;
-}
-export interface CompositorConfig {
-    defaultTokenBudget: number;
-    maxHistoryMessages: number;
-    maxFacts: number;
-    maxCrossSessionContext: number;
-    /**
-     * How many recent tool call/result pairs to keep verbatim in history.
-     * Tool call/result content beyond this threshold gets prose-stub treatment.
-     * Default: 3
-     */
-    maxRecentToolPairs: number;
-    /**
-     * How many tool pairs beyond the verbatim threshold to convert to heuristic
-     * prose stubs (e.g. "Read /src/foo.ts (1.2KB)"). Pairs beyond this are
-     * dropped entirely (text content preserved, tool payloads nulled).
-     * Default: 10
-     */
-    maxProseToolPairs: number;
-    /**
-     * Fraction of defaultTokenBudget to allocate for history during warm bootstrap.
-     * Replaces the old WARM_BOOTSTRAP_CAP message-count constant.
-     * Default: 0.4 (40% of defaultTokenBudget)
-     */
-    warmHistoryBudgetFraction: number;
-}
-export interface IndexerConfig {
-    enabled: boolean;
-    factExtractionMode: 'off' | 'pattern' | 'tiered';
-    topicDormantAfter: string;
-    topicClosedAfter: string;
-    factDecayRate: number;
-    episodeSignificanceThreshold: number;
-    periodicInterval: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,9 +0,0 @@
-/**
- * HyperMem Core Types
- *
- * Provider-neutral message format and compositor interfaces.
- * These types are the internal representation — never sent directly to an LLM.
- * Provider translators convert to/from provider-specific formats at the boundary.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/vector-store.d.ts

@@ -1,132 +0,0 @@
-/**
- * HyperMem Vector Store — Semantic Search via sqlite-vec
- *
- * Provides embedding-backed KNN search over facts, knowledge, episodes,
- * and session registry entries. Uses Ollama (local) for embeddings,
- * sqlite-vec for vector indexing, and coexists with existing FTS5.
- *
- * Architecture:
- *   - One vec0 virtual table per indexed content type
- *   - Embeddings generated via local Ollama (nomic-embed-text, 768d)
- *   - Vectors stored alongside content in the same agent DB
- *   - Embedding cache to avoid redundant API calls
- *   - Batch embedding support for bulk indexing
- */
-import type { DatabaseSync } from 'node:sqlite';
-export interface EmbeddingConfig {
-    /** Ollama base URL. Default: http://localhost:11434 */
-    ollamaUrl: string;
-    /** Embedding model name. Default: nomic-embed-text */
-    model: string;
-    /** Embedding dimensions. Default: 768 */
-    dimensions: number;
-    /** Request timeout ms. Default: 10000 */
-    timeout: number;
-    /** Max texts per batch request. Default: 32 */
-    batchSize: number;
-}
-export interface VectorSearchResult {
-    rowid: number;
-    distance: number;
-    sourceTable: string;
-    sourceId: number;
-    content: string;
-    domain?: string;
-    agentId?: string;
-    metadata?: string;
-}
-export interface VectorIndexStats {
-    totalVectors: number;
-    tableBreakdown: Record<string, number>;
-    lastIndexedAt: string | null;
-}
-/**
- * Generate embeddings via Ollama API.
- * Supports single and batch embedding.
- */
-export declare function generateEmbeddings(texts: string[], config?: EmbeddingConfig): Promise<Float32Array[]>;
-/**
- * VectorStore — manages vector indexes in an agent's vector database.
- *
- * The vector DB (vectors.db) stores vec0 virtual tables and the index map.
- * Source content (facts, knowledge, episodes) lives in the library DB.
- * The VectorStore needs both: vectorDb for indexes, libraryDb for content.
- */
-export declare class VectorStore {
-    private readonly db;
-    private readonly libraryDb;
-    private readonly config;
-    constructor(db: DatabaseSync, config?: Partial<EmbeddingConfig>, libraryDb?: DatabaseSync);
-    /**
-     * Create vector index tables if they don't exist.
-     * Safe to call multiple times (idempotent).
-     */
-    ensureTables(): void;
-    /**
-     * Index a single content item. Generates embedding and stores in vec table.
-     * Skips if content hasn't changed (based on hash).
-     */
-    /** Allowlisted source tables for vector indexing. Prevents SQL injection via table name interpolation. */
-    private static readonly ALLOWED_SOURCE_TABLES;
-    private validateSourceTable;
-    indexItem(sourceTable: string, sourceId: number, content: string, domain?: string): Promise<boolean>;
-    /**
-     * Batch index multiple items. More efficient than individual calls.
-     */
-    indexBatch(items: Array<{
-        sourceTable: string;
-        sourceId: number;
-        content: string;
-        domain?: string;
-    }>): Promise<{
-        indexed: number;
-        skipped: number;
-    }>;
-    /**
-     * Semantic KNN search across one or all vector tables.
-     */
-    search(query: string, opts?: {
-        tables?: string[];
-        limit?: number;
-        maxDistance?: number;
-    }): Promise<VectorSearchResult[]>;
-    /**
-     * Get content from a source table by id.
-     */
-    private getSourceContent;
-    /**
-     * Index all un-indexed content in the agent's database.
-     * Called by the background indexer.
-     */
-    indexAll(agentId: string): Promise<{
-        indexed: number;
-        skipped: number;
-    }>;
-    /**
-     * Remove vector index entries for deleted source rows.
-     */
-    pruneOrphans(): number;
-    /**
-     * Tombstone vector entries for superseded facts and knowledge.
-     *
-     * When fact A is superseded by fact B (facts.superseded_by = B.id), the old
-     * vector for A should not surface in semantic recall. Without this, recalled
-     * context can include contradicted/outdated facts alongside their replacements.
-     *
-     * Strategy: find all indexed facts/knowledge with superseded_by IS NOT NULL
-     * and delete their vec_index_map entries + vec table rows. The source row
-     * stays in library.db (audit trail) but disappears from recall.
-     *
-     * @returns Number of vector entries tombstoned.
-     */
-    tombstoneSuperseded(): number;
-    /**
-     * Get index statistics.
-     */
-    getStats(): VectorIndexStats;
-}
-/**
- * Create vector tables in a library database for session registry search.
- */
-export declare function ensureSessionVecTable(db: DatabaseSync, dimensions?: number): void;
-//# sourceMappingURL=vector-store.d.ts.map

package/dist/vector-store.d.ts.map

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