modular-studio 1.0.4 → 1.0.6

package/dist-server/server/routes/skills-search.js

@@ -120,6 +120,36 @@ router.get('/audit/:owner/:repo/:skill', async (req, res) => {
         res.status(500).json({ error: message, gen: 'Pending', socket: 'Pending', snyk: 'Pending' });
     }
 });
+// Parse `npx skills find` output into structured results
+function parseSkillsFindOutput(output) {
+    const results = [];
+    // Each skill appears as: owner/repo@skillName followed by install count
+    // e.g. "vercel-labs/agent-skills@vercel-react-best-practices  226.6K installs"
+    //      "└ https://skills.sh/vercel-labs/agent-skills/vercel-react-best-practices"
+    const lines = output.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        // Strip ANSI escape codes
+        const clean = lines[i].replace(/\x1b\[[0-9;]*m/g, '').trim();
+        // Match: owner/repo@skillName  NNK installs
+        const m = clean.match(/^([a-z0-9_.-]+\/[a-z0-9_.-]+)@([a-z0-9_:.-]+)\s+([\d,.]+[KkMm]?)\s*installs?/i);
+        if (m) {
+            const repo = m[1];
+            const name = m[2];
+            const installs = m[3];
+            // Next line might have the URL
+            const nextClean = (lines[i + 1] || '').replace(/\x1b\[[0-9;]*m/g, '').trim();
+            const urlMatch = nextClean.match(/(https:\/\/skills\.sh\/[^\s]+)/);
+            results.push({
+                id: `${repo}@${name}`,
+                name,
+                repo,
+                installs,
+                url: urlMatch ? urlMatch[1] : `https://skills.sh/${repo}/${name}`,
+            });
+        }
+    }
+    return results;
+}
 // GET /api/skills/search?q=react
 router.get('/search', async (req, res) => {
     const query = req.query.q || '';
@@ -127,6 +157,23 @@ router.get('/search', async (req, res) => {
         res.json({ data: [], query });
         return;
     }
+    // Try `npx skills find <query>` first — uses the official skills.sh CLI
+    try {
+        const findCmd = `npx -y skills find ${query.replace(/[^a-z0-9_ -]/gi, '')}`;
+        const { stdout } = await exec(findCmd, [], {
+            timeout: 30000,
+            shell: true,
+        });
+        const cliResults = parseSkillsFindOutput(String(stdout));
+        if (cliResults.length > 0) {
+            res.json({ data: cliResults.slice(0, 10), query, source: 'skills-cli' });
+            return;
+        }
+    }
+    catch {
+        // CLI not available or failed — fall back to catalog scraping
+    }
+    // Fallback: scrape skills.sh catalog
     try {
         const catalog = await fetchCatalog();
         const q = query.toLowerCase();
@@ -168,7 +215,7 @@ router.get('/search', async (req, res) => {
                 url: entry.url,
             };
         });
-        res.json({ data: results, query });
+        res.json({ data: results, query, source: 'catalog-scrape' });
     }
     catch (err) {
         const message = err instanceof Error ? err.message : 'Search failed';
@@ -188,16 +235,159 @@ router.post('/install', async (req, res) => {
         return;
     }
     try {
-        const args = ['skills', 'add', skillId, '-y'];
-        if (scope === 'global')
-            args.push('-g');
-        const { stdout, stderr } = await exec('npx', args, { timeout: 60000 });
-        res.json({ status: 'ok', output: stdout + stderr });
+        // Try the skills CLI first: `npx skills add <skillId> -y -g`
+        try {
+            // Use single command string to avoid DEP0190 deprecation warning
+            const safeSkillId = skillId.replace(/[^a-z0-9@/_.-]/gi, '');
+            const addCmd = scope === 'global'
+                ? `npx -y skills add ${safeSkillId} -y -g`
+                : `npx -y skills add ${safeSkillId} -y`;
+            const { stdout, stderr } = await exec(addCmd, [], { timeout: 60000, shell: true });
+            res.json({ status: 'ok', output: String(stdout) + String(stderr) });
+            return;
+        }
+        catch (cliError) {
+            console.log('Skills CLI (npx skills add) failed, trying GitHub fallback:', cliError.message);
+        }
+        // Fallback: Download full skill directory from GitHub via API
+        // Repos like anthropics/knowledge-work-plugins nest skills deeply:
+        //   <category>/skills/<skillName>/SKILL.md
+        console.log('Using fallback: downloading skill from GitHub API');
+        const os = await import('os');
+        const path = await import('path');
+        const fs = await import('fs/promises');
+        // Extract repo and skill name from skillId (format: owner/repo@skillName)
+        const [repoPath, skillName] = skillId.includes('@') ? skillId.split('@') : [skillId, skillId.split('/').pop() || skillId];
+        const [owner, repo] = repoPath.split('/');
+        // Use the Git Trees API to find SKILL.md anywhere in the repo
+        // This handles arbitrarily nested structures like category/skills/name/SKILL.md
+        let treeData = [];
+        let treePath = '';
+        try {
+            const treeRes = await fetch(`https://api.github.com/repos/${owner}/${repo}/git/trees/HEAD?recursive=1`, {
+                headers: { 'User-Agent': 'modular-patchbay/1.0', 'Accept': 'application/vnd.github.v3+json' },
+                signal: AbortSignal.timeout(15000),
+            });
+            if (treeRes.ok) {
+                const treeJson = await treeRes.json();
+                const allFiles = treeJson.tree || [];
+                // Find SKILL.md in a directory matching the skill name
+                const skillMdEntries = allFiles.filter(f => f.type === 'blob' && f.path.endsWith('/SKILL.md'));
+                // Match: exact directory name, or directory ends with skillName
+                const match = skillMdEntries.find(f => {
+                    const dir = f.path.replace('/SKILL.md', '');
+                    const dirName = dir.split('/').pop();
+                    return dirName === skillName;
+                });
+                if (match) {
+                    treePath = match.path.replace('/SKILL.md', '');
+                    // Now fetch that directory's contents via Contents API
+                    const dirRes = await fetch(`https://api.github.com/repos/${owner}/${repo}/contents/${treePath}`, {
+                        headers: { 'User-Agent': 'modular-patchbay/1.0', 'Accept': 'application/vnd.github.v3+json' },
+                        signal: AbortSignal.timeout(10000),
+                    });
+                    if (dirRes.ok) {
+                        const dirData = await dirRes.json();
+                        if (Array.isArray(dirData)) {
+                            treeData = dirData;
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            // Tree API failed, continue to static path fallback
+        }
+        // Static path fallback if tree search didn't find it
+        if (treeData.length === 0) {
+            const candidatePaths = [skillName, `skills/${skillName}`, `src/${skillName}`];
+            for (const cp of candidatePaths) {
+                const apiUrl = `https://api.github.com/repos/${owner}/${repo}/contents/${cp}`;
+                const apiRes = await fetch(apiUrl, {
+                    headers: { 'User-Agent': 'modular-patchbay/1.0', 'Accept': 'application/vnd.github.v3+json' },
+                    signal: AbortSignal.timeout(10000),
+                });
+                if (apiRes.ok) {
+                    const data = await apiRes.json();
+                    if (Array.isArray(data) && data.some((f) => f.name === 'SKILL.md')) {
+                        treeData = data;
+                        treePath = cp;
+                        break;
+                    }
+                }
+            }
+        }
+        // Last resort: raw SKILL.md download
+        if (treeData.length === 0) {
+            const base = `https://raw.githubusercontent.com/${repoPath}`;
+            const rawCandidates = [
+                `${base}/main/${skillName}/SKILL.md`,
+                `${base}/main/SKILL.md`,
+                `${base}/master/${skillName}/SKILL.md`,
+                `${base}/master/SKILL.md`,
+            ];
+            let skillContent = null;
+            for (const url of rawCandidates) {
+                const r = await fetch(url);
+                if (r.ok) {
+                    skillContent = await r.text();
+                    break;
+                }
+            }
+            if (skillContent === null) {
+                throw new Error(`Skill "${skillName}" not found in ${repoPath}. Tried: skills CLI, GitHub tree search, static paths, and raw URLs.`);
+            }
+            const skillDir = path.join(os.homedir(), '.agents', 'skills', skillName);
+            await fs.mkdir(skillDir, { recursive: true });
+            await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillContent, 'utf8');
+            res.json({ status: 'ok', output: `Skill ${skillName} installed (SKILL.md only — directory listing unavailable)` });
+            return;
+        }
+        // Download all files in the skill directory (including subdirs like references/, scripts/)
+        const skillDir = path.join(os.homedir(), '.agents', 'skills', skillName);
+        await fs.mkdir(skillDir, { recursive: true });
+        const downloadDir = async (items, localDir) => {
+            let count = 0;
+            for (const item of items) {
+                if (item.type === 'file' && item.download_url) {
+                    const fileRes = await fetch(item.download_url);
+                    if (fileRes.ok) {
+                        const content = await fileRes.text();
+                        await fs.writeFile(path.join(localDir, item.name), content, 'utf8');
+                        count++;
+                    }
+                }
+                else if (item.type === 'dir') {
+                    const subDir = path.join(localDir, item.name);
+                    await fs.mkdir(subDir, { recursive: true });
+                    const subUrl = `https://api.github.com/repos/${owner}/${repo}/contents/${item.path}`;
+                    const subRes = await fetch(subUrl, {
+                        headers: { 'User-Agent': 'modular-patchbay/1.0', 'Accept': 'application/vnd.github.v3+json' },
+                        signal: AbortSignal.timeout(10000),
+                    });
+                    if (subRes.ok) {
+                        const subItems = await subRes.json();
+                        if (Array.isArray(subItems)) {
+                            count += await downloadDir(subItems, subDir);
+                        }
+                    }
+                }
+            }
+            return count;
+        };
+        const fileCount = await downloadDir(treeData, skillDir);
+        console.log(`Installed skill ${skillName}: ${fileCount} files from ${owner}/${repo}/${treePath}`);
+        res.json({
+            status: 'ok',
+            output: `Skill ${skillName} installed to ${skillDir} (${fileCount} files from GitHub)`
+        });
     }
     catch (err) {
         const message = err instanceof Error ? err.message : 'Install failed';
-        res.status(500).json({ error: message });
+        console.error('Skills install error:', message);
+        res.status(500).json({
+            error: `Install failed: ${message}. Please ensure the skills CLI is installed or the skill exists on GitHub.`
+        });
     }
 });
 export default router;
-//# sourceMappingURL=skills-search.js.map

package/dist-server/server/routes/worktrees.js

@@ -67,4 +67,3 @@ router.post('/merge', (req, res) => {
     }
 });
 export default router;
-//# sourceMappingURL=worktrees.js.map

package/dist-server/server/services/__tests__/embeddingService.test.js

@@ -238,4 +238,3 @@ describe('integration (with real model)', () => {
         // expect(similarity1).toBeGreaterThan(similarity2); // cat-dog more similar than cat-database
     });
 });
-//# sourceMappingURL=embeddingService.test.js.map

package/dist-server/server/services/adapters/hindsightAdapter.d.ts

@@ -0,0 +1,28 @@
+import type { Fact } from '../../../src/store/memoryStore.js';
+import type { StorageAdapter } from './storageAdapter.js';
+export declare class HindsightAdapter implements StorageAdapter {
+    private readonly client;
+    private readonly bank;
+    private lastWrite;
+    constructor(baseUrl: string, bank?: string);
+    initialize(): Promise<void>;
+    storeFact(fact: Fact): Promise<void>;
+    getFacts(options?: {
+        domain?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Fact[]>;
+    searchFacts(query: string, k?: number): Promise<Array<Fact & {
+        score: number;
+    }>>;
+    deleteFact(_id: string): Promise<void>;
+    updateFact(_id: string, _patch: Partial<Fact>): Promise<void>;
+    reflect(query: string): Promise<string>;
+    getHealth(): Promise<{
+        status: string;
+        factCount: number;
+        lastWrite?: number;
+    }>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=hindsightAdapter.d.ts.map

package/dist-server/server/services/adapters/hindsightAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hindsightAdapter.d.ts","sourceRoot":"","sources":["../../../../server/services/adapters/hindsightAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA8B1D,qBAAa,gBAAiB,YAAW,cAAc;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAK;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,SAAe;IAK1C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3B,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAMzF,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAM3E,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACtC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAE7D,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIvC,SAAS,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAS/E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAC7B"}

package/dist-server/server/services/adapters/hindsightAdapter.js

@@ -0,0 +1,63 @@
+import { ModularHindsightClient } from '../hindsightClient.js';
+const DEFAULT_BANK = 'modular-studio';
+const FALLBACK_SCORE = 0.8;
+function toFact(item) {
+    return {
+        id: item.id,
+        content: item.content,
+        tags: [],
+        type: 'fact',
+        timestamp: Date.now(),
+        domain: 'shared',
+        granularity: 'fact',
+    };
+}
+function buildFactMeta(fact) {
+    const meta = {
+        id: fact.id,
+        type: fact.type,
+        domain: fact.domain,
+        granularity: fact.granularity,
+    };
+    if (fact.ownerAgentId)
+        meta.ownerAgentId = fact.ownerAgentId;
+    return meta;
+}
+export class HindsightAdapter {
+    client;
+    bank;
+    lastWrite = 0;
+    constructor(baseUrl, bank = DEFAULT_BANK) {
+        this.client = new ModularHindsightClient(baseUrl);
+        this.bank = bank;
+    }
+    async initialize() { }
+    async storeFact(fact) {
+        await this.client.retain(this.bank, fact.content, buildFactMeta(fact));
+        this.lastWrite = Date.now();
+    }
+    async getFacts(options) {
+        const query = options?.domain ? `domain:${options.domain}` : '*';
+        const items = await this.client.recall(this.bank, query, options?.limit ?? 50);
+        return items.map(toFact);
+    }
+    async searchFacts(query, k = 5) {
+        const items = await this.client.recall(this.bank, query, k);
+        return items.map(item => ({ ...toFact(item), score: FALLBACK_SCORE }));
+    }
+    // Hindsight is append-only — delete and update are no-ops
+    async deleteFact(_id) { }
+    async updateFact(_id, _patch) { }
+    async reflect(query) {
+        return this.client.reflect(this.bank, query);
+    }
+    async getHealth() {
+        const ok = await this.client.healthCheck();
+        return {
+            status: ok ? 'healthy' : 'unavailable',
+            factCount: 0,
+            ...(this.lastWrite > 0 && { lastWrite: this.lastWrite }),
+        };
+    }
+    async close() { }
+}

package/dist-server/server/services/adapters/postgresAdapter.d.ts

@@ -0,0 +1,29 @@
+import type { Fact } from '../../../src/store/memoryStore.js';
+import type { StorageAdapter } from './storageAdapter.js';
+export declare class PostgresAdapter implements StorageAdapter {
+    private pool;
+    private connectionString;
+    private lastWrite;
+    constructor(connectionString: string);
+    initialize(): Promise<void>;
+    private createTables;
+    storeFact(fact: Fact): Promise<void>;
+    getFacts(options?: {
+        domain?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Fact[]>;
+    private rowToFact;
+    searchFacts(query: string, k?: number): Promise<Array<Fact & {
+        score: number;
+    }>>;
+    deleteFact(id: string): Promise<void>;
+    updateFact(id: string, patch: Partial<Fact>): Promise<void>;
+    getHealth(): Promise<{
+        status: string;
+        factCount: number;
+        lastWrite?: number;
+    }>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=postgresAdapter.d.ts.map

package/dist-server/server/services/adapters/postgresAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgresAdapter.d.ts","sourceRoot":"","sources":["../../../../server/services/adapters/postgresAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,qBAAa,eAAgB,YAAW,cAAc;IACpD,OAAO,CAAC,IAAI,CAAqB;IACjC,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,SAAS,CAAa;gBAElB,gBAAgB,EAAE,MAAM;IAI9B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAgBnB,YAAY;IA2BpB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCpC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IA4B/F,OAAO,CAAC,SAAS;IAeX,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAsC3E,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC3D,SAAS,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAsB/E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM7B"}

package/dist-server/server/services/adapters/postgresAdapter.js

@@ -0,0 +1,224 @@
+import { Pool } from 'pg';
+import { textSimilarity } from '../memoryScorer.js';
+export class PostgresAdapter {
+    pool = null;
+    connectionString;
+    lastWrite = 0;
+    constructor(connectionString) {
+        this.connectionString = connectionString;
+    }
+    async initialize() {
+        this.pool = new Pool({
+            connectionString: this.connectionString,
+            max: 10,
+            idleTimeoutMillis: 30000,
+            connectionTimeoutMillis: 2000,
+        });
+        const client = await this.pool.connect();
+        try {
+            await this.createTables(client);
+        }
+        finally {
+            client.release();
+        }
+    }
+    async createTables(client) {
+        await client.query(`CREATE TABLE IF NOT EXISTS facts (
+      id TEXT PRIMARY KEY,
+      content TEXT NOT NULL,
+      tags JSONB NOT NULL DEFAULT '[]'::jsonb,
+      type TEXT NOT NULL,
+      timestamp BIGINT NOT NULL,
+      domain TEXT NOT NULL,
+      granularity TEXT NOT NULL,
+      embedding BYTEA,
+      owner_agent_id TEXT,
+      created_at TIMESTAMP DEFAULT NOW()
+    )`);
+        // Create indexes for better performance
+        await client.query('CREATE INDEX IF NOT EXISTS idx_facts_domain ON facts(domain)');
+        await client.query('CREATE INDEX IF NOT EXISTS idx_facts_timestamp ON facts(timestamp)');
+        await client.query('CREATE INDEX IF NOT EXISTS idx_facts_type ON facts(type)');
+        // GIN index for tag queries
+        await client.query('CREATE INDEX IF NOT EXISTS idx_facts_tags ON facts USING gin(tags)');
+        // Full-text search index
+        await client.query(`CREATE INDEX IF NOT EXISTS idx_facts_content_fts 
+      ON facts USING gin(to_tsvector('english', content))`);
+    }
+    async storeFact(fact) {
+        if (!this.pool)
+            await this.initialize();
+        if (!this.pool)
+            throw new Error('Pool not initialized');
+        const embedding = fact.embedding ? Buffer.from(new Float32Array(fact.embedding).buffer) : null;
+        await this.pool.query(`
+      INSERT INTO facts (id, content, tags, type, timestamp, domain, granularity, embedding, owner_agent_id)
+      VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9)
+      ON CONFLICT (id) DO UPDATE SET
+        content = EXCLUDED.content,
+        tags = EXCLUDED.tags,
+        type = EXCLUDED.type,
+        timestamp = EXCLUDED.timestamp,
+        domain = EXCLUDED.domain,
+        granularity = EXCLUDED.granularity,
+        embedding = EXCLUDED.embedding,
+        owner_agent_id = EXCLUDED.owner_agent_id
+    `, [
+            fact.id,
+            fact.content,
+            JSON.stringify(fact.tags),
+            fact.type,
+            fact.timestamp,
+            fact.domain,
+            fact.granularity,
+            embedding,
+            fact.ownerAgentId || null
+        ]);
+        this.lastWrite = Date.now();
+    }
+    async getFacts(options) {
+        if (!this.pool)
+            await this.initialize();
+        if (!this.pool)
+            return [];
+        let query = 'SELECT * FROM facts';
+        const params = [];
+        let paramCount = 0;
+        if (options?.domain) {
+            query += ` WHERE domain = $${++paramCount}`;
+            params.push(options.domain);
+        }
+        query += ' ORDER BY timestamp DESC';
+        if (options?.limit) {
+            query += ` LIMIT $${++paramCount}`;
+            params.push(options.limit);
+            if (options.offset) {
+                query += ` OFFSET $${++paramCount}`;
+                params.push(options.offset);
+            }
+        }
+        const result = await this.pool.query(query, params);
+        return result.rows.map(row => this.rowToFact(row));
+    }
+    rowToFact(row) {
+        const embedding = row.embedding ? new Float32Array(new Uint8Array(row.embedding).buffer) : undefined;
+        return {
+            id: row.id,
+            content: row.content,
+            tags: JSON.parse(row.tags),
+            type: row.type,
+            timestamp: parseInt(row.timestamp),
+            domain: row.domain,
+            granularity: row.granularity,
+            embedding: embedding ? Array.from(embedding) : undefined,
+            ownerAgentId: row.owner_agent_id || undefined
+        };
+    }
+    async searchFacts(query, k = 5) {
+        if (!this.pool)
+            await this.initialize();
+        if (!this.pool)
+            return [];
+        // Try PostgreSQL full-text search first
+        try {
+            const result = await this.pool.query(`
+        SELECT *, ts_rank(to_tsvector('english', content), plainto_tsquery('english', $1)) as score
+        FROM facts
+        WHERE to_tsvector('english', content) @@ plainto_tsquery('english', $1)
+        ORDER BY score DESC
+        LIMIT $2
+      `, [query, k]);
+            if (result.rows.length > 0) {
+                return result.rows.map(row => ({
+                    ...this.rowToFact(row),
+                    score: parseFloat(row.score)
+                }));
+            }
+        }
+        catch (error) {
+            console.warn('Full-text search failed, falling back to similarity:', error);
+        }
+        // Fallback to similarity search
+        const allFacts = await this.getFacts({ limit: 1000 });
+        const scored = allFacts
+            .map(fact => ({
+            ...fact,
+            score: textSimilarity(fact.content, query)
+        }))
+            .filter(fact => fact.score > 0.1)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, k);
+        return scored;
+    }
+    async deleteFact(id) {
+        if (!this.pool)
+            await this.initialize();
+        if (!this.pool)
+            return;
+        await this.pool.query('DELETE FROM facts WHERE id = $1', [id]);
+        this.lastWrite = Date.now();
+    }
+    async updateFact(id, patch) {
+        if (!this.pool)
+            await this.initialize();
+        if (!this.pool)
+            return;
+        const updates = [];
+        const params = [];
+        let paramCount = 0;
+        if (patch.content !== undefined) {
+            updates.push(`content = $${++paramCount}`);
+            params.push(patch.content);
+        }
+        if (patch.tags !== undefined) {
+            updates.push(`tags = $${++paramCount}`);
+            params.push(JSON.stringify(patch.tags));
+        }
+        if (patch.type !== undefined) {
+            updates.push(`type = $${++paramCount}`);
+            params.push(patch.type);
+        }
+        if (patch.domain !== undefined) {
+            updates.push(`domain = $${++paramCount}`);
+            params.push(patch.domain);
+        }
+        if (patch.embedding !== undefined) {
+            updates.push(`embedding = $${++paramCount}`);
+            const embedding = patch.embedding ? Buffer.from(new Float32Array(patch.embedding).buffer) : null;
+            params.push(embedding);
+        }
+        if (updates.length === 0)
+            return;
+        params.push(id);
+        await this.pool.query(`UPDATE facts SET ${updates.join(', ')} WHERE id = $${++paramCount}`, params);
+        this.lastWrite = Date.now();
+    }
+    async getHealth() {
+        if (!this.pool)
+            await this.initialize();
+        if (!this.pool)
+            return { status: 'error', factCount: 0 };
+        try {
+            const result = await this.pool.query('SELECT COUNT(*) as count FROM facts');
+            const factCount = parseInt(result.rows[0].count);
+            return {
+                status: 'healthy',
+                factCount,
+                lastWrite: this.lastWrite || undefined
+            };
+        }
+        catch (error) {
+            return {
+                status: 'error',
+                factCount: 0,
+                lastWrite: this.lastWrite || undefined
+            };
+        }
+    }
+    async close() {
+        if (this.pool) {
+            await this.pool.end();
+            this.pool = null;
+        }
+    }
+}

package/dist-server/server/services/adapters/sqliteAdapter.d.ts

@@ -0,0 +1,28 @@
+import type { Fact } from '../../../src/store/memoryStore.js';
+import type { StorageAdapter } from './storageAdapter.js';
+export declare class SqliteAdapter implements StorageAdapter {
+    private db;
+    private lastWrite;
+    initialize(): Promise<void>;
+    private createTables;
+    private saveDb;
+    storeFact(fact: Fact): Promise<void>;
+    getFacts(options?: {
+        domain?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<Fact[]>;
+    private rowToFact;
+    searchFacts(query: string, k?: number): Promise<Array<Fact & {
+        score: number;
+    }>>;
+    deleteFact(id: string): Promise<void>;
+    updateFact(id: string, patch: Partial<Fact>): Promise<void>;
+    getHealth(): Promise<{
+        status: string;
+        factCount: number;
+        lastWrite?: number;
+    }>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=sqliteAdapter.d.ts.map

package/dist-server/server/services/adapters/sqliteAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteAdapter.d.ts","sourceRoot":"","sources":["../../../../server/services/adapters/sqliteAdapter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,SAAS,CAAa;IAExB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBjC,OAAO,CAAC,YAAY;IAuCpB,OAAO,CAAC,MAAM;IAQR,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBpC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IA6B/F,OAAO,CAAC,SAAS;IAeX,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAkC3E,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC3D,SAAS,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAc/E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}