gnosys 4.0.0

package/dist/lib/lensing.js

@@ -0,0 +1,85 @@
+/**
+ * Gnosys Lensing — Filtered views of the memory store.
+ *
+ * A lens is a set of filter criteria applied to memories.
+ * Compound lenses combine multiple filters with AND/OR logic.
+ */
+/**
+ * Apply a single lens filter to an array of memories.
+ */
+export function applyLens(memories, lens) {
+    return memories.filter((m) => matchesLens(m, lens));
+}
+/**
+ * Apply a compound lens (multiple filters combined with AND/OR).
+ */
+export function applyCompoundLens(memories, compound) {
+    if (compound.filters.length === 0)
+        return memories;
+    if (compound.operator === "AND") {
+        // AND: memory must match ALL filters
+        return memories.filter((m) => compound.filters.every((f) => matchesLens(m, f)));
+    }
+    else {
+        // OR: memory must match ANY filter
+        return memories.filter((m) => compound.filters.some((f) => matchesLens(m, f)));
+    }
+}
+/**
+ * Check if a single memory matches a lens filter.
+ */
+function matchesLens(m, lens) {
+    const fm = m.frontmatter;
+    // Category filter
+    if (lens.category && fm.category !== lens.category)
+        return false;
+    // Status filter (array — memory must match one of the listed statuses)
+    if (lens.status && lens.status.length > 0) {
+        if (!lens.status.includes(fm.status))
+            return false;
+    }
+    // Author filter
+    if (lens.author && lens.author.length > 0) {
+        if (!lens.author.includes(fm.author))
+            return false;
+    }
+    // Authority filter
+    if (lens.authority && lens.authority.length > 0) {
+        if (!lens.authority.includes(fm.authority))
+            return false;
+    }
+    // Confidence range
+    if (lens.minConfidence !== undefined && fm.confidence < lens.minConfidence)
+        return false;
+    if (lens.maxConfidence !== undefined && fm.confidence > lens.maxConfidence)
+        return false;
+    // Tag matching
+    if (lens.tags && lens.tags.length > 0) {
+        const memTags = flattenTags(fm.tags);
+        const mode = lens.tagMatchMode ?? "any";
+        const matches = lens.tags.filter((t) => memTags.includes(t));
+        if (mode === "all" && matches.length !== lens.tags.length)
+            return false;
+        if (mode === "any" && matches.length === 0)
+            return false;
+    }
+    // Date filters
+    if (lens.createdAfter && fm.created < lens.createdAfter)
+        return false;
+    if (lens.createdBefore && fm.created > lens.createdBefore)
+        return false;
+    if (lens.modifiedAfter && fm.modified < lens.modifiedAfter)
+        return false;
+    if (lens.modifiedBefore && fm.modified > lens.modifiedBefore)
+        return false;
+    return true;
+}
+/**
+ * Flatten tags from either format to a simple string array.
+ */
+function flattenTags(tags) {
+    if (Array.isArray(tags))
+        return tags;
+    return Object.values(tags).flat();
+}
+//# sourceMappingURL=lensing.js.map

package/dist/lib/lensing.js.map

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

package/dist/lib/llm.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Gnosys LLM Abstraction Layer — Provider-agnostic interface for LLM operations.
+ * Supports Anthropic (cloud) and Ollama (local). Clean factory pattern enables
+ * future providers (Groq, OpenAI, LM Studio) with zero changes to call sites.
+ */
+import { GnosysConfig, LLMProviderName } from "./config.js";
+export interface LLMGenerateOptions {
+    system?: string;
+    maxTokens?: number;
+    stream?: boolean;
+}
+export interface LLMStreamCallbacks {
+    onToken: (token: string) => void;
+}
+/**
+ * Core LLM provider interface. All providers must implement this.
+ */
+export interface LLMProvider {
+    readonly name: LLMProviderName;
+    readonly model: string;
+    /**
+     * Generate a response from a prompt.
+     * Returns the full response text (non-streaming) or streams via callbacks.
+     */
+    generate(prompt: string, options?: LLMGenerateOptions, streamCallbacks?: LLMStreamCallbacks): Promise<string>;
+    /**
+     * Test connectivity to the provider.
+     * Returns true if reachable, throws with descriptive error if not.
+     */
+    testConnection(): Promise<boolean>;
+}
+export declare class AnthropicProvider implements LLMProvider {
+    readonly name: LLMProviderName;
+    readonly model: string;
+    private client;
+    private config;
+    constructor(model: string, apiKey: string, config?: GnosysConfig);
+    generate(prompt: string, options?: LLMGenerateOptions, streamCallbacks?: LLMStreamCallbacks): Promise<string>;
+    private streamGenerate;
+    testConnection(): Promise<boolean>;
+}
+export declare class OllamaProvider implements LLMProvider {
+    readonly name: LLMProviderName;
+    readonly model: string;
+    private baseUrl;
+    private config;
+    constructor(model: string, baseUrl: string, config?: GnosysConfig);
+    generate(prompt: string, options?: LLMGenerateOptions, streamCallbacks?: LLMStreamCallbacks): Promise<string>;
+    private readStream;
+    testConnection(): Promise<boolean>;
+}
+/**
+ * Generic OpenAI-compatible provider. Works with any service that implements
+ * the OpenAI /v1/chat/completions API: OpenAI, Groq, LM Studio, etc.
+ */
+export declare class OpenAICompatibleProvider implements LLMProvider {
+    readonly name: LLMProviderName;
+    readonly model: string;
+    private baseUrl;
+    private apiKey;
+    private config;
+    constructor(name: LLMProviderName, model: string, baseUrl: string, apiKey: string, config?: GnosysConfig);
+    generate(prompt: string, options?: LLMGenerateOptions, streamCallbacks?: LLMStreamCallbacks): Promise<string>;
+    private readSSEStream;
+    testConnection(): Promise<boolean>;
+}
+/**
+ * Create an LLM provider for a specific task.
+ * Resolves provider + model from config's taskModels or defaultProvider.
+ */
+export declare function getLLMProvider(config: GnosysConfig, task?: "structuring" | "synthesis"): LLMProvider;
+/**
+ * Create a specific LLM provider instance.
+ */
+export declare function createProvider(provider: LLMProviderName, model: string, config: GnosysConfig): LLMProvider;
+/**
+ * Check if an LLM provider is available (has credentials / connectivity).
+ * Returns { available: boolean; error?: string }.
+ */
+export declare function isProviderAvailable(config: GnosysConfig, provider?: LLMProviderName): {
+    available: boolean;
+    error?: string;
+};
+//# sourceMappingURL=llm.d.ts.map

package/dist/lib/llm.d.ts.map

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

package/dist/lib/llm.js

@@ -0,0 +1,386 @@
+/**
+ * Gnosys LLM Abstraction Layer — Provider-agnostic interface for LLM operations.
+ * Supports Anthropic (cloud) and Ollama (local). Clean factory pattern enables
+ * future providers (Groq, OpenAI, LM Studio) with zero changes to call sites.
+ */
+import { DEFAULT_CONFIG, resolveTaskModel, getAnthropicApiKey, getOllamaBaseUrl, getGroqApiKey, getOpenAIApiKey, getOpenAIBaseUrl, getLMStudioBaseUrl, getProviderModel, } from "./config.js";
+import { withRetry, isTransientError } from "./retry.js";
+// ─── Anthropic Provider ──────────────────────────────────────────────────
+export class AnthropicProvider {
+    name = "anthropic";
+    model;
+    client; // Anthropic SDK client
+    config;
+    constructor(model, apiKey, config) {
+        this.model = model;
+        this.config = config || DEFAULT_CONFIG;
+        // Dynamic import is handled in factory; here we just create the client
+        const Anthropic = require("@anthropic-ai/sdk").default || require("@anthropic-ai/sdk");
+        this.client = new Anthropic({ apiKey });
+        // Prevent apiKey from leaking in stack traces or serialization
+        Object.defineProperty(this, "_apiKey", { enumerable: false, value: undefined });
+    }
+    async generate(prompt, options, streamCallbacks) {
+        const maxTokens = options?.maxTokens || 4096;
+        if (options?.stream && streamCallbacks?.onToken) {
+            return this.streamGenerate(prompt, options, streamCallbacks);
+        }
+        const response = await withRetry(() => this.client.messages.create({
+            model: this.model,
+            max_tokens: maxTokens,
+            ...(options?.system ? { system: options.system } : {}),
+            messages: [{ role: "user", content: prompt }],
+        }), {
+            maxAttempts: this.config.llmRetryAttempts,
+            baseDelayMs: this.config.llmRetryBaseDelayMs,
+            isRetryable: isTransientError,
+        });
+        return response.content[0].type === "text" ? response.content[0].text || "" : "";
+    }
+    async streamGenerate(prompt, options, streamCallbacks) {
+        const maxTokens = options?.maxTokens || 4096;
+        const stream = this.client.messages.stream({
+            model: this.model,
+            max_tokens: maxTokens,
+            ...(options?.system ? { system: options.system } : {}),
+            messages: [{ role: "user", content: prompt }],
+        });
+        let fullText = "";
+        for await (const event of stream) {
+            if (event.type === "content_block_delta" &&
+                event.delta.type === "text_delta") {
+                const token = event.delta.text;
+                fullText += token;
+                streamCallbacks.onToken(token);
+            }
+        }
+        return fullText;
+    }
+    async testConnection() {
+        try {
+            const response = await this.client.messages.create({
+                model: this.model,
+                max_tokens: 10,
+                messages: [{ role: "user", content: "Say hi" }],
+            });
+            return response.content.length > 0;
+        }
+        catch (err) {
+            // Sanitize error message to prevent API key leakage
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`Anthropic connection failed: ${msg.replace(/sk-ant-[^\s"']+/g, "sk-ant-***")}`);
+        }
+    }
+}
+// ─── Ollama Provider ─────────────────────────────────────────────────────
+export class OllamaProvider {
+    name = "ollama";
+    model;
+    baseUrl;
+    config;
+    constructor(model, baseUrl, config) {
+        this.model = model;
+        this.baseUrl = baseUrl.replace(/\/$/, ""); // Strip trailing slash
+        this.config = config || DEFAULT_CONFIG;
+    }
+    async generate(prompt, options, streamCallbacks) {
+        const shouldStream = options?.stream && streamCallbacks?.onToken;
+        const body = {
+            model: this.model,
+            stream: !!shouldStream,
+        };
+        // Use /api/chat for system prompt support, /api/generate otherwise
+        if (options?.system) {
+            body.messages = [
+                { role: "system", content: options.system },
+                { role: "user", content: prompt },
+            ];
+        }
+        else {
+            body.messages = [{ role: "user", content: prompt }];
+        }
+        const url = `${this.baseUrl}/api/chat`;
+        const response = await withRetry(() => fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        }), {
+            maxAttempts: this.config.llmRetryAttempts,
+            baseDelayMs: this.config.llmRetryBaseDelayMs,
+            isRetryable: isTransientError,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Ollama request failed (${response.status}): ${errorText}`);
+        }
+        if (shouldStream && streamCallbacks) {
+            return this.readStream(response, streamCallbacks);
+        }
+        // Non-streaming: Ollama returns one JSON object with the full response
+        const data = await response.json();
+        return data.message?.content || data.response || "";
+    }
+    async readStream(response, callbacks) {
+        const reader = response.body?.getReader();
+        if (!reader)
+            throw new Error("No response body for streaming");
+        const decoder = new TextDecoder();
+        let fullText = "";
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            const chunk = decoder.decode(value, { stream: true });
+            // Ollama streams one JSON object per line
+            const lines = chunk.split("\n").filter(Boolean);
+            for (const line of lines) {
+                try {
+                    const parsed = JSON.parse(line);
+                    const token = parsed.message?.content || parsed.response || "";
+                    if (token) {
+                        fullText += token;
+                        callbacks.onToken(token);
+                    }
+                }
+                catch {
+                    // Skip malformed lines
+                }
+            }
+        }
+        return fullText;
+    }
+    async testConnection() {
+        try {
+            const response = await fetch(`${this.baseUrl}/api/tags`);
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}`);
+            }
+            const data = await response.json();
+            if (!data.models || !Array.isArray(data.models)) {
+                throw new Error("Unexpected response format");
+            }
+            // Check if the configured model is available
+            const modelNames = data.models.map((m) => m.name || m.model || "");
+            const hasModel = modelNames.some((name) => name === this.model ||
+                name.startsWith(`${this.model}:`) ||
+                name === `${this.model}:latest`);
+            if (!hasModel) {
+                const available = modelNames.slice(0, 10).join(", ");
+                throw new Error(`Model "${this.model}" not found. Available: ${available || "none"}. Run: ollama pull ${this.model}`);
+            }
+            return true;
+        }
+        catch (err) {
+            if (err instanceof Error && err.message.includes("Model")) {
+                throw err; // Re-throw model-not-found with helpful message
+            }
+            throw new Error(`Ollama connection failed at ${this.baseUrl}: ${err instanceof Error ? err.message : String(err)}. Is Ollama running?`);
+        }
+    }
+}
+// ─── OpenAI-Compatible Provider (Groq, OpenAI, LM Studio) ──────────────
+/**
+ * Generic OpenAI-compatible provider. Works with any service that implements
+ * the OpenAI /v1/chat/completions API: OpenAI, Groq, LM Studio, etc.
+ */
+export class OpenAICompatibleProvider {
+    name;
+    model;
+    baseUrl;
+    apiKey;
+    config;
+    constructor(name, model, baseUrl, apiKey, config) {
+        this.name = name;
+        this.model = model;
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+        this.apiKey = apiKey;
+        this.config = config || DEFAULT_CONFIG;
+    }
+    async generate(prompt, options, streamCallbacks) {
+        const shouldStream = options?.stream && streamCallbacks?.onToken;
+        const maxTokens = options?.maxTokens || 4096;
+        const messages = [];
+        if (options?.system) {
+            messages.push({ role: "system", content: options.system });
+        }
+        messages.push({ role: "user", content: prompt });
+        const body = {
+            model: this.model,
+            messages,
+            max_tokens: maxTokens,
+            stream: !!shouldStream,
+        };
+        const response = await withRetry(() => fetch(`${this.baseUrl}/chat/completions`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                ...(this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}),
+            },
+            body: JSON.stringify(body),
+        }), {
+            maxAttempts: this.config.llmRetryAttempts,
+            baseDelayMs: this.config.llmRetryBaseDelayMs,
+            isRetryable: isTransientError,
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            // Sanitize error text to prevent API key leakage
+            const safeText = errorText.replace(/(?:sk-|gsk_|Bearer\s+)[^\s"']+/g, "***");
+            throw new Error(`${this.name} request failed (${response.status}): ${safeText}`);
+        }
+        if (shouldStream && streamCallbacks) {
+            return this.readSSEStream(response, streamCallbacks);
+        }
+        const data = (await response.json());
+        return data.choices?.[0]?.message?.content || "";
+    }
+    async readSSEStream(response, callbacks) {
+        const reader = response.body?.getReader();
+        if (!reader)
+            throw new Error("No response body for streaming");
+        const decoder = new TextDecoder();
+        let fullText = "";
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            const chunk = decoder.decode(value, { stream: true });
+            const lines = chunk.split("\n").filter((l) => l.startsWith("data: "));
+            for (const line of lines) {
+                const data = line.slice(6).trim();
+                if (data === "[DONE]")
+                    continue;
+                try {
+                    const parsed = JSON.parse(data);
+                    const token = parsed.choices?.[0]?.delta?.content || "";
+                    if (token) {
+                        fullText += token;
+                        callbacks.onToken(token);
+                    }
+                }
+                catch {
+                    // Skip malformed SSE lines
+                }
+            }
+        }
+        return fullText;
+    }
+    async testConnection() {
+        try {
+            const response = await fetch(`${this.baseUrl}/models`, {
+                headers: {
+                    ...(this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {}),
+                },
+            });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}`);
+            }
+            return true;
+        }
+        catch (err) {
+            throw new Error(`${this.name} connection failed at ${this.baseUrl}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+}
+// ─── Factory ─────────────────────────────────────────────────────────────
+/**
+ * Create an LLM provider for a specific task.
+ * Resolves provider + model from config's taskModels or defaultProvider.
+ */
+export function getLLMProvider(config, task) {
+    const resolved = task
+        ? resolveTaskModel(config, task)
+        : { provider: config.llm.defaultProvider, model: getDefaultModel(config) };
+    return createProvider(resolved.provider, resolved.model, config);
+}
+/**
+ * Create a specific LLM provider instance.
+ */
+export function createProvider(provider, model, config) {
+    switch (provider) {
+        case "anthropic": {
+            const apiKey = getAnthropicApiKey(config);
+            if (!apiKey) {
+                throw new Error("No Anthropic API key found. Set ANTHROPIC_API_KEY environment variable or add llm.anthropic.apiKey to gnosys.json.");
+            }
+            return new AnthropicProvider(model, apiKey, config);
+        }
+        case "ollama": {
+            const baseUrl = getOllamaBaseUrl(config);
+            return new OllamaProvider(model, baseUrl, config);
+        }
+        case "groq": {
+            const apiKey = getGroqApiKey(config);
+            if (!apiKey) {
+                throw new Error("No Groq API key found. Set GROQ_API_KEY environment variable or add llm.groq.apiKey to gnosys.json.");
+            }
+            return new OpenAICompatibleProvider("groq", model, "https://api.groq.com/openai/v1", apiKey, config);
+        }
+        case "openai": {
+            const apiKey = getOpenAIApiKey(config);
+            if (!apiKey) {
+                throw new Error("No OpenAI API key found. Set OPENAI_API_KEY environment variable or add llm.openai.apiKey to gnosys.json.");
+            }
+            const baseUrl = getOpenAIBaseUrl(config);
+            return new OpenAICompatibleProvider("openai", model, baseUrl, apiKey, config);
+        }
+        case "lmstudio": {
+            const baseUrl = getLMStudioBaseUrl(config);
+            return new OpenAICompatibleProvider("lmstudio", model, baseUrl, "", config);
+        }
+        default:
+            throw new Error(`Unsupported LLM provider: "${provider}". Supported: anthropic, ollama, groq, openai, lmstudio.`);
+    }
+}
+/**
+ * Get the default model for the default provider.
+ */
+function getDefaultModel(config) {
+    return getProviderModel(config, config.llm.defaultProvider);
+}
+/**
+ * Check if an LLM provider is available (has credentials / connectivity).
+ * Returns { available: boolean; error?: string }.
+ */
+export function isProviderAvailable(config, provider) {
+    const target = provider || config.llm.defaultProvider;
+    switch (target) {
+        case "anthropic": {
+            const apiKey = getAnthropicApiKey(config);
+            if (!apiKey) {
+                return {
+                    available: false,
+                    error: "No ANTHROPIC_API_KEY set. Add to environment or gnosys.json.",
+                };
+            }
+            return { available: true };
+        }
+        case "groq": {
+            const apiKey = getGroqApiKey(config);
+            if (!apiKey) {
+                return {
+                    available: false,
+                    error: "No GROQ_API_KEY set. Add to environment or gnosys.json.",
+                };
+            }
+            return { available: true };
+        }
+        case "openai": {
+            const apiKey = getOpenAIApiKey(config);
+            if (!apiKey) {
+                return {
+                    available: false,
+                    error: "No OPENAI_API_KEY set. Add to environment or gnosys.json.",
+                };
+            }
+            return { available: true };
+        }
+        case "ollama":
+        case "lmstudio":
+            // Local providers: assume available if configured (network check requires async)
+            return { available: true };
+        default:
+            return { available: false, error: `Unknown provider: ${target}` };
+    }
+}
+//# sourceMappingURL=llm.js.map

package/dist/lib/llm.js.map

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

package/dist/lib/lock.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Gnosys Lock — File-level locking for concurrent write safety.
+ *
+ * Prevents multiple agents (or agent + maintenance) from corrupting
+ * active markdown files during simultaneous writes. Uses a simple
+ * .gnosys/.config/write.lock file with PID tracking.
+ *
+ * Design: advisory lock with timeout + stale lock detection.
+ */
+/**
+ * Acquire a write lock for the given store path.
+ * Returns a release function that MUST be called when done.
+ *
+ * Usage:
+ *   const release = await acquireWriteLock(storePath, "maintain");
+ *   try {
+ *     // ... do writes ...
+ *   } finally {
+ *     release();
+ *   }
+ */
+export declare function acquireWriteLock(storePath: string, operation?: string): Promise<() => void>;
+/**
+ * Enable WAL mode on a better-sqlite3 database instance.
+ * WAL (Write-Ahead Logging) allows concurrent reads during writes.
+ */
+export declare function enableWAL(db: any): void;
+//# sourceMappingURL=lock.d.ts.map

package/dist/lib/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../src/lib/lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAgB,GAC1B,OAAO,CAAC,MAAM,IAAI,CAAC,CA4ErB;AAgCD;;;GAGG;AAEH,wBAAgB,SAAS,CAAC,EAAE,EAAE,GAAG,GAAG,IAAI,CAOvC"}