@psiclawops/hypermem 0.1.0 → 0.5.0

package/dist/fact-store.js

@@ -1,175 +0,0 @@
-/**
- * HyperMem Fact Store
- *
- * CRUD operations for facts (extracted knowledge that spans sessions).
- * Facts live in the central library DB, tagged by agent_id.
- * Facts have scope (agent/session/user), confidence, and decay.
- */
-function nowIso() {
-    return new Date().toISOString();
-}
-function parseFactRow(row) {
-    return {
-        id: row.id,
-        agentId: row.agent_id,
-        scope: row.scope,
-        domain: row.domain || null,
-        content: row.content,
-        confidence: row.confidence,
-        visibility: row.visibility || 'private',
-        sourceType: row.source_type || 'conversation',
-        sourceSessionKey: row.source_session_key || null,
-        sourceRef: row.source_ref || null,
-        createdAt: row.created_at,
-        updatedAt: row.updated_at,
-        expiresAt: row.expires_at || null,
-        supersededBy: row.superseded_by || null,
-        decayScore: row.decay_score,
-    };
-}
-export class FactStore {
-    db;
-    constructor(db) {
-        this.db = db;
-    }
-    /**
-     * Add a new fact. Checks for duplicates by content.
-     */
-    addFact(agentId, content, opts) {
-        const now = nowIso();
-        const scope = opts?.scope || 'agent';
-        // Check for exact duplicate
-        const existing = this.db.prepare(`
-      SELECT * FROM facts WHERE agent_id = ? AND content = ? AND scope = ?
-    `).get(agentId, content, scope);
-        if (existing) {
-            this.db.prepare(`
-        UPDATE facts SET confidence = MAX(confidence, ?), updated_at = ? WHERE id = ?
-      `).run(opts?.confidence || 1.0, now, existing.id);
-            return parseFactRow({ ...existing, updated_at: now });
-        }
-        const result = this.db.prepare(`
-      INSERT INTO facts (agent_id, scope, domain, content, confidence,
-        visibility, source_type, source_session_key, source_ref,
-        created_at, updated_at, expires_at, decay_score)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 0.0)
-    `).run(agentId, scope, opts?.domain || null, content, opts?.confidence || 1.0, opts?.visibility || 'private', opts?.sourceType || 'conversation', opts?.sourceSessionKey || null, opts?.sourceRef || null, now, now, opts?.expiresAt || null);
-        const id = Number(result.lastInsertRowid);
-        return {
-            id,
-            agentId,
-            scope,
-            domain: opts?.domain || null,
-            content,
-            confidence: opts?.confidence || 1.0,
-            visibility: opts?.visibility || 'private',
-            sourceType: opts?.sourceType || 'conversation',
-            sourceSessionKey: opts?.sourceSessionKey || null,
-            sourceRef: opts?.sourceRef || null,
-            createdAt: now,
-            updatedAt: now,
-            expiresAt: opts?.expiresAt || null,
-            supersededBy: null,
-            decayScore: 0,
-        };
-    }
-    /**
-     * Get active facts for an agent.
-     */
-    getActiveFacts(agentId, opts) {
-        let sql = `
-      SELECT * FROM facts
-      WHERE agent_id = ?
-      AND superseded_by IS NULL
-      AND (expires_at IS NULL OR expires_at > datetime('now'))
-      AND decay_score < 0.8
-    `;
-        const params = [agentId];
-        if (opts?.scope) {
-            sql += ' AND scope = ?';
-            params.push(opts.scope);
-        }
-        if (opts?.domain) {
-            sql += ' AND domain = ?';
-            params.push(opts.domain);
-        }
-        if (opts?.minConfidence) {
-            sql += ' AND confidence >= ?';
-            params.push(opts.minConfidence);
-        }
-        sql += ' ORDER BY confidence DESC, decay_score ASC';
-        if (opts?.limit) {
-            sql += ' LIMIT ?';
-            params.push(opts.limit);
-        }
-        const rows = this.db.prepare(sql).all(...params);
-        return rows.map(parseFactRow);
-    }
-    /**
-     * Full-text search facts.
-     */
-    searchFacts(query, opts) {
-        const limit = opts?.limit || 20;
-        const hasFilters = !!(opts?.agentId || opts?.domain || opts?.visibility);
-        const innerLimit = hasFilters ? limit * 4 : limit;
-        // Two-phase: FTS in subquery, then filter on small set.  See hybrid-retrieval.ts.
-        let sql = `
-      SELECT f.* FROM (
-        SELECT rowid, rank FROM facts_fts WHERE facts_fts MATCH ? ORDER BY rank LIMIT ?
-      ) sub
-      JOIN facts f ON f.id = sub.rowid
-      WHERE f.superseded_by IS NULL
-      AND f.decay_score < 0.8
-    `;
-        const params = [query, innerLimit];
-        if (opts?.agentId) {
-            sql += ' AND f.agent_id = ?';
-            params.push(opts.agentId);
-        }
-        if (opts?.domain) {
-            sql += ' AND f.domain = ?';
-            params.push(opts.domain);
-        }
-        if (opts?.visibility) {
-            sql += ' AND f.visibility = ?';
-            params.push(opts.visibility);
-        }
-        sql += ' ORDER BY sub.rank LIMIT ?';
-        params.push(limit);
-        const rows = this.db.prepare(sql).all(...params);
-        return rows.map(parseFactRow);
-    }
-    /**
-     * Decay all facts by a fixed rate.
-     */
-    decayFacts(agentId, decayRate = 0.01) {
-        const result = this.db.prepare(`
-      UPDATE facts
-      SET decay_score = MIN(decay_score + ?, 1.0), updated_at = ?
-      WHERE agent_id = ? AND decay_score < 1.0
-    `).run(decayRate, nowIso(), agentId);
-        return result.changes;
-    }
-    /**
-     * Remove expired and fully decayed facts.
-     */
-    pruneFacts(agentId) {
-        const result = this.db.prepare(`
-      DELETE FROM facts
-      WHERE agent_id = ?
-      AND (
-        (expires_at IS NOT NULL AND expires_at < datetime('now'))
-        OR decay_score >= 1.0
-      )
-    `).run(agentId);
-        return result.changes;
-    }
-    /**
-     * Get fact count for an agent.
-     */
-    getFactCount(agentId) {
-        const row = this.db.prepare('SELECT COUNT(*) AS count FROM facts WHERE agent_id = ?').get(agentId);
-        return row.count;
-    }
-}
-//# sourceMappingURL=fact-store.js.map

package/dist/fleet-store.d.ts

@@ -1,144 +0,0 @@
-/**
- * HyperMem Fleet Registry Store
- *
- * Agent roster, org structure, roles, capabilities.
- * Lives in the central library DB.
- * The operational map of the fleet.
- */
-import type { DatabaseSync } from 'node:sqlite';
-export interface AgentCapability {
-    capType: 'skill' | 'tool' | 'mcp_server';
-    name: string;
-    version?: string;
-    source?: string;
-    config?: Record<string, unknown>;
-    status: string;
-    lastVerified?: string;
-}
-export interface FleetAgent {
-    id: string;
-    displayName: string;
-    tier: string;
-    orgId: string | null;
-    reportsTo: string | null;
-    domains: string[];
-    sessionKeys: string[];
-    status: string;
-    lastSeen: string | null;
-    createdAt: string;
-    updatedAt: string;
-    metadata: Record<string, unknown> | null;
-    capabilities: AgentCapability[] | null;
-}
-export interface FleetOrg {
-    id: string;
-    name: string;
-    leadAgentId: string | null;
-    mission: string | null;
-    createdAt: string;
-}
-export declare class FleetStore {
-    private readonly db;
-    constructor(db: DatabaseSync);
-    /**
-     * Register or update an agent.
-     */
-    upsertAgent(id: string, data: {
-        displayName?: string;
-        tier?: string;
-        orgId?: string;
-        reportsTo?: string;
-        domains?: string[];
-        sessionKeys?: string[];
-        status?: string;
-        metadata?: Record<string, unknown>;
-    }): FleetAgent;
-    /**
-     * Get an agent by ID.
-     */
-    getAgent(id: string): FleetAgent | null;
-    /**
-     * List all agents, optionally filtered.
-     */
-    listAgents(opts?: {
-        tier?: string;
-        orgId?: string;
-        status?: string;
-    }): FleetAgent[];
-    /**
-     * Update agent status and last_seen.
-     */
-    heartbeat(agentId: string, status?: string): void;
-    /**
-     * Find agents by domain.
-     */
-    findByDomain(domain: string): FleetAgent[];
-    /**
-     * Register or update an org.
-     */
-    upsertOrg(id: string, data: {
-        name: string;
-        leadAgentId?: string;
-        mission?: string;
-    }): FleetOrg;
-    /**
-     * Get an org by ID.
-     */
-    getOrg(id: string): FleetOrg | null;
-    /**
-     * List all orgs.
-     */
-    listOrgs(): FleetOrg[];
-    /**
-     * Get all agents in an org.
-     */
-    getOrgMembers(orgId: string): FleetAgent[];
-    /**
-     * Register or update a capability for an agent.
-     */
-    upsertCapability(agentId: string, cap: {
-        capType: AgentCapability['capType'];
-        name: string;
-        version?: string;
-        source?: string;
-        config?: Record<string, unknown>;
-        status?: string;
-    }): AgentCapability;
-    /**
-     * Bulk-sync capabilities for an agent (replace all of a given type).
-     */
-    syncCapabilities(agentId: string, capType: AgentCapability['capType'], caps: Array<{
-        name: string;
-        version?: string;
-        source?: string;
-        config?: Record<string, unknown>;
-    }>): void;
-    /**
-     * Get a specific capability.
-     */
-    getCapability(agentId: string, capType: string, name: string): AgentCapability | null;
-    /**
-     * List capabilities for an agent, optionally filtered by type.
-     */
-    getAgentCapabilities(agentId: string, capType?: string): AgentCapability[];
-    /**
-     * Find agents that have a specific capability.
-     */
-    findByCapability(capType: string, name: string): FleetAgent[];
-    /**
-     * Find agents that have ANY of the given capabilities.
-     */
-    findByAnyCapability(caps: Array<{
-        capType: string;
-        name: string;
-    }>): FleetAgent[];
-    /**
-     * Remove a capability from an agent.
-     */
-    removeCapability(agentId: string, capType: string, name: string): void;
-    /**
-     * Sync the denormalized capabilities JSON on fleet_agents.
-     */
-    private _syncCapabilitiesJson;
-}
-//# sourceMappingURL=fleet-store.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"fleet-store.d.ts","sourceRoot":"","sources":["../src/fleet-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAMhD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,YAAY,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AA0CD,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,YAAY;IAI7C;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,UAAU;IAyDd;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAOvC;;OAEG;IACH,UAAU,CAAC,IAAI,CAAC,EAAE;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,UAAU,EAAE;IAuBhB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAiB,GAAG,IAAI;IAO3D;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE;IAU1C;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QAC1B,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,QAAQ;IAeZ;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI;IAOnC;;OAEG;IACH,QAAQ,IAAI,QAAQ,EAAE;IAOtB;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE;IAU1C;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE;QACrC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,eAAe;IAgCnB;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC;QACjF,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC,GAAG,IAAI;IAyBT;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAQrF;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE;IAe1E;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE;IAW7D;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,UAAU,EAAE;IAgBjF;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAWtE;;OAEG;IACH,OAAO,CAAC,qBAAqB;CAQ9B"}

package/dist/fleet-store.js

@@ -1,276 +0,0 @@
-/**
- * HyperMem Fleet Registry Store
- *
- * Agent roster, org structure, roles, capabilities.
- * Lives in the central library DB.
- * The operational map of the fleet.
- */
-function nowIso() {
-    return new Date().toISOString();
-}
-function parseAgentRow(row) {
-    return {
-        id: row.id,
-        displayName: row.display_name,
-        tier: row.tier,
-        orgId: row.org_id || null,
-        reportsTo: row.reports_to || null,
-        domains: row.domains ? JSON.parse(row.domains) : [],
-        sessionKeys: row.session_keys ? JSON.parse(row.session_keys) : [],
-        status: row.status,
-        lastSeen: row.last_seen || null,
-        createdAt: row.created_at,
-        updatedAt: row.updated_at,
-        metadata: row.metadata ? JSON.parse(row.metadata) : null,
-        capabilities: row.capabilities ? JSON.parse(row.capabilities) : null,
-    };
-}
-function parseCapabilityRow(row) {
-    return {
-        capType: row.cap_type,
-        name: row.name,
-        version: row.version || undefined,
-        source: row.source || undefined,
-        config: row.config ? JSON.parse(row.config) : undefined,
-        status: row.status,
-        lastVerified: row.last_verified || undefined,
-    };
-}
-function parseOrgRow(row) {
-    return {
-        id: row.id,
-        name: row.name,
-        leadAgentId: row.lead_agent_id || null,
-        mission: row.mission || null,
-        createdAt: row.created_at,
-    };
-}
-export class FleetStore {
-    db;
-    constructor(db) {
-        this.db = db;
-    }
-    // ── Agents ──────────────────────────────────────────────────
-    /**
-     * Register or update an agent.
-     */
-    upsertAgent(id, data) {
-        const now = nowIso();
-        const existing = this.db.prepare('SELECT * FROM fleet_agents WHERE id = ?')
-            .get(id);
-        if (existing) {
-            this.db.prepare(`
-        UPDATE fleet_agents SET
-          display_name = COALESCE(?, display_name),
-          tier = COALESCE(?, tier),
-          org_id = COALESCE(?, org_id),
-          reports_to = COALESCE(?, reports_to),
-          domains = COALESCE(?, domains),
-          session_keys = COALESCE(?, session_keys),
-          status = COALESCE(?, status),
-          metadata = COALESCE(?, metadata),
-          last_seen = ?,
-          updated_at = ?
-        WHERE id = ?
-      `).run(data.displayName || null, data.tier || null, data.orgId || null, data.reportsTo || null, data.domains ? JSON.stringify(data.domains) : null, data.sessionKeys ? JSON.stringify(data.sessionKeys) : null, data.status || null, data.metadata ? JSON.stringify(data.metadata) : null, now, now, id);
-        }
-        else {
-            this.db.prepare(`
-        INSERT INTO fleet_agents (id, display_name, tier, org_id, reports_to,
-          domains, session_keys, status, last_seen, created_at, updated_at, metadata)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-      `).run(id, data.displayName || id, data.tier || 'unknown', data.orgId || null, data.reportsTo || null, data.domains ? JSON.stringify(data.domains) : '[]', data.sessionKeys ? JSON.stringify(data.sessionKeys) : '[]', data.status || 'active', now, now, now, data.metadata ? JSON.stringify(data.metadata) : null);
-        }
-        return this.getAgent(id);
-    }
-    /**
-     * Get an agent by ID.
-     */
-    getAgent(id) {
-        const row = this.db.prepare('SELECT * FROM fleet_agents WHERE id = ?')
-            .get(id);
-        return row ? parseAgentRow(row) : null;
-    }
-    /**
-     * List all agents, optionally filtered.
-     */
-    listAgents(opts) {
-        let sql = 'SELECT * FROM fleet_agents WHERE 1=1';
-        const params = [];
-        if (opts?.tier) {
-            sql += ' AND tier = ?';
-            params.push(opts.tier);
-        }
-        if (opts?.orgId) {
-            sql += ' AND org_id = ?';
-            params.push(opts.orgId);
-        }
-        if (opts?.status) {
-            sql += ' AND status = ?';
-            params.push(opts.status);
-        }
-        sql += ' ORDER BY tier, id';
-        const rows = this.db.prepare(sql).all(...params);
-        return rows.map(parseAgentRow);
-    }
-    /**
-     * Update agent status and last_seen.
-     */
-    heartbeat(agentId, status = 'active') {
-        const now = nowIso();
-        this.db.prepare('UPDATE fleet_agents SET status = ?, last_seen = ?, updated_at = ? WHERE id = ?').run(status, now, now, agentId);
-    }
-    /**
-     * Find agents by domain.
-     */
-    findByDomain(domain) {
-        const rows = this.db.prepare("SELECT * FROM fleet_agents WHERE domains LIKE ? AND status = 'active'").all(`%"${domain}"%`);
-        return rows.map(parseAgentRow);
-    }
-    // ── Orgs ────────────────────────────────────────────────────
-    /**
-     * Register or update an org.
-     */
-    upsertOrg(id, data) {
-        const now = nowIso();
-        this.db.prepare(`
-      INSERT INTO fleet_orgs (id, name, lead_agent_id, mission, created_at)
-      VALUES (?, ?, ?, ?, ?)
-      ON CONFLICT(id) DO UPDATE SET
-        name = excluded.name,
-        lead_agent_id = COALESCE(excluded.lead_agent_id, lead_agent_id),
-        mission = COALESCE(excluded.mission, mission)
-    `).run(id, data.name, data.leadAgentId || null, data.mission || null, now);
-        return this.getOrg(id);
-    }
-    /**
-     * Get an org by ID.
-     */
-    getOrg(id) {
-        const row = this.db.prepare('SELECT * FROM fleet_orgs WHERE id = ?')
-            .get(id);
-        return row ? parseOrgRow(row) : null;
-    }
-    /**
-     * List all orgs.
-     */
-    listOrgs() {
-        const rows = this.db.prepare('SELECT * FROM fleet_orgs ORDER BY name')
-            .all();
-        return rows.map(parseOrgRow);
-    }
-    /**
-     * Get all agents in an org.
-     */
-    getOrgMembers(orgId) {
-        const rows = this.db.prepare("SELECT * FROM fleet_agents WHERE org_id = ? ORDER BY tier, id").all(orgId);
-        return rows.map(parseAgentRow);
-    }
-    // ── Capabilities ────────────────────────────────────────────
-    /**
-     * Register or update a capability for an agent.
-     */
-    upsertCapability(agentId, cap) {
-        const now = nowIso();
-        this.db.prepare(`
-      INSERT INTO agent_capabilities (agent_id, cap_type, name, version, source, config, status, last_verified, created_at, updated_at)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-      ON CONFLICT(agent_id, cap_type, name) DO UPDATE SET
-        version = COALESCE(excluded.version, version),
-        source = COALESCE(excluded.source, source),
-        config = COALESCE(excluded.config, config),
-        status = excluded.status,
-        last_verified = excluded.last_verified,
-        updated_at = excluded.updated_at
-    `).run(agentId, cap.capType, cap.name, cap.version || null, cap.source || null, cap.config ? JSON.stringify(cap.config) : null, cap.status || 'active', now, now, now);
-        // Also update the denormalized JSON on fleet_agents
-        this._syncCapabilitiesJson(agentId);
-        return this.getCapability(agentId, cap.capType, cap.name);
-    }
-    /**
-     * Bulk-sync capabilities for an agent (replace all of a given type).
-     */
-    syncCapabilities(agentId, capType, caps) {
-        const now = nowIso();
-        const capNames = caps.map(c => c.name);
-        // Mark missing ones as removed
-        const existing = this.db.prepare('SELECT name FROM agent_capabilities WHERE agent_id = ? AND cap_type = ? AND status = ?').all(agentId, capType, 'active');
-        for (const row of existing) {
-            if (!capNames.includes(row.name)) {
-                this.db.prepare('UPDATE agent_capabilities SET status = ?, updated_at = ? WHERE agent_id = ? AND cap_type = ? AND name = ?').run('removed', now, agentId, capType, row.name);
-            }
-        }
-        // Upsert current ones
-        for (const cap of caps) {
-            this.upsertCapability(agentId, { capType, ...cap });
-        }
-        this._syncCapabilitiesJson(agentId);
-    }
-    /**
-     * Get a specific capability.
-     */
-    getCapability(agentId, capType, name) {
-        const row = this.db.prepare('SELECT * FROM agent_capabilities WHERE agent_id = ? AND cap_type = ? AND name = ?').get(agentId, capType, name);
-        return row ? parseCapabilityRow(row) : null;
-    }
-    /**
-     * List capabilities for an agent, optionally filtered by type.
-     */
-    getAgentCapabilities(agentId, capType) {
-        let sql = 'SELECT * FROM agent_capabilities WHERE agent_id = ? AND status = ?';
-        const params = [agentId, 'active'];
-        if (capType) {
-            sql += ' AND cap_type = ?';
-            params.push(capType);
-        }
-        sql += ' ORDER BY cap_type, name';
-        const rows = this.db.prepare(sql).all(...params);
-        return rows.map(parseCapabilityRow);
-    }
-    /**
-     * Find agents that have a specific capability.
-     */
-    findByCapability(capType, name) {
-        const rows = this.db.prepare(`
-      SELECT fa.* FROM fleet_agents fa
-      INNER JOIN agent_capabilities ac ON ac.agent_id = fa.id
-      WHERE ac.cap_type = ? AND ac.name = ? AND ac.status = 'active' AND fa.status = 'active'
-      ORDER BY fa.tier, fa.id
-    `).all(capType, name);
-        return rows.map(parseAgentRow);
-    }
-    /**
-     * Find agents that have ANY of the given capabilities.
-     */
-    findByAnyCapability(caps) {
-        if (caps.length === 0)
-            return [];
-        const conditions = caps.map(() => '(ac.cap_type = ? AND ac.name = ?)').join(' OR ');
-        const params = caps.flatMap(c => [c.capType, c.name]);
-        const rows = this.db.prepare(`
-      SELECT DISTINCT fa.* FROM fleet_agents fa
-      INNER JOIN agent_capabilities ac ON ac.agent_id = fa.id
-      WHERE (${conditions}) AND ac.status = 'active' AND fa.status = 'active'
-      ORDER BY fa.tier, fa.id
-    `).all(...params);
-        return rows.map(parseAgentRow);
-    }
-    /**
-     * Remove a capability from an agent.
-     */
-    removeCapability(agentId, capType, name) {
-        const now = nowIso();
-        this.db.prepare('UPDATE agent_capabilities SET status = ?, updated_at = ? WHERE agent_id = ? AND cap_type = ? AND name = ?').run('removed', now, agentId, capType, name);
-        this._syncCapabilitiesJson(agentId);
-    }
-    // ── Internal ────────────────────────────────────────────────
-    /**
-     * Sync the denormalized capabilities JSON on fleet_agents.
-     */
-    _syncCapabilitiesJson(agentId) {
-        const caps = this.getAgentCapabilities(agentId);
-        const now = nowIso();
-        this.db.prepare('UPDATE fleet_agents SET capabilities = ?, updated_at = ? WHERE id = ?').run(JSON.stringify(caps), now, agentId);
-    }
-}
-//# sourceMappingURL=fleet-store.js.map

package/dist/hybrid-retrieval.d.ts

@@ -1,60 +0,0 @@
-/**
- * HyperMem Hybrid Retrieval — FTS5 + KNN Score Fusion
- *
- * Merges keyword (FTS5/BM25) and semantic (KNN/vector) results into a
- * single ranked list using Reciprocal Rank Fusion (RRF). This avoids
- * vocabulary mismatch (KNN-only misses exact terms) and semantic gap
- * (FTS5-only misses paraphrases).
- *
- * Architecture:
- *   - FTS5 results from library.db (facts_fts, knowledge_fts, episodes_fts)
- *   - KNN results from vectors.db via VectorStore
- *   - RRF merges both ranked lists with configurable k constant
- *   - Deduplication by (sourceTable, sourceId)
- *   - Token-budgeted output for compositor consumption
- */
-import type { DatabaseSync } from 'node:sqlite';
-import type { VectorStore } from './vector-store.js';
-export interface HybridSearchResult {
-    sourceTable: string;
-    sourceId: number;
-    content: string;
-    domain?: string;
-    agentId?: string;
-    metadata?: string;
-    /** Combined RRF score (higher = more relevant) */
-    score: number;
-    /** Which retrieval paths contributed */
-    sources: ('fts' | 'knn')[];
-}
-export interface HybridSearchOptions {
-    /** Content types to search. Default: ['facts', 'knowledge', 'episodes'] */
-    tables?: string[];
-    /** Max results to return. Default: 10 */
-    limit?: number;
-    /** Max KNN distance (filters low-quality vectors). Default: 1.2 */
-    maxKnnDistance?: number;
-    /** RRF k constant. Higher = less weight to top ranks. Default: 60 */
-    rrfK?: number;
-    /** Agent ID filter for FTS queries */
-    agentId?: string;
-    /** Weight for FTS results in fusion. Default: 1.0 */
-    ftsWeight?: number;
-    /** Weight for KNN results in fusion. Default: 1.0 */
-    knnWeight?: number;
-    /** Minimum number of FTS terms to attempt a query (skip if fewer). Default: 1 */
-    minFtsTerms?: number;
-}
-/**
- * Build an FTS5 query from a natural language string.
- * Extracts meaningful words, removes stop words, uses OR conjunction.
- */
-export declare function buildFtsQuery(input: string): string;
-/**
- * Hybrid search combining FTS5 keyword search and KNN vector search.
- *
- * When vectorStore is null, falls back to FTS5-only.
- * When FTS5 query is empty (all stop words), falls back to KNN-only.
- */
-export declare function hybridSearch(libraryDb: DatabaseSync, vectorStore: VectorStore | null, query: string, opts?: HybridSearchOptions): Promise<HybridSearchResult[]>;
-//# sourceMappingURL=hybrid-retrieval.d.ts.map

package/dist/hybrid-retrieval.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hybrid-retrieval.d.ts","sourceRoot":"","sources":["../src/hybrid-retrieval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,mBAAmB,CAAC;AAIzE,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAqBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiBnD;AA2ND;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,YAAY,EACvB,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAwI/B"}