daemora 1.0.0-alpha.0

package/dist/embeddings/Embeddings.js

@@ -0,0 +1,252 @@
+/**
+ * Embeddings — provider-agnostic vector embedding for semantic search.
+ *
+ * Priority (first available wins):
+ *   1. OpenAI   (vault OPENAI_API_KEY)     → text-embedding-3-small
+ *   2. Google   (vault GOOGLE_AI_API_KEY)  → text-embedding-004
+ *   3. Ollama   (localhost:11434 probed)   → all-minilm
+ *   4. TF-IDF   (built-in, OPT-IN ONLY)    → keyword-weighted fallback
+ *
+ * If none of 1–3 are available, `provider()` returns `null` and
+ * `generate()` returns `null`. Callers should treat a null result as
+ * "no embedding available — fall back to non-embedding logic". TF-IDF
+ * is not a silent default because it isn't really semantic matching
+ * (it's weighted-keyword), and pretending otherwise leads to surprising
+ * behaviour. Use TF-IDF by explicit opt-in only:
+ *   - `EMBEDDING_PROVIDER=tfidf` env, or
+ *   - `generate(text, "tfidf")` at the call site.
+ *
+ * IMPORTANT: vectors from different providers are NOT comparable.
+ * Every stored embedding is tagged with `{ provider, dim }` so the
+ * consumer (skill matcher, memory recall) can skip vectors that don't
+ * match the currently-active provider.
+ */
+import { embed, embedMany } from "ai";
+import { createLogger } from "../util/logger.js";
+import { TfIdfEmbedder } from "./TfIdf.js";
+const log = createLogger("embeddings");
+const OLLAMA_DEFAULT_MODEL = "all-minilm";
+const OLLAMA_PROBE_TIMEOUT_MS = 2_000;
+const MAX_INPUT_CHARS = 8_000;
+export class Embeddings {
+    cfg;
+    /** TF-IDF fallback. Exported so callers can `fit` its vocab on boot. */
+    tfidf = new TfIdfEmbedder();
+    ollamaProbed = null;
+    ollamaModelReady = false;
+    constructor(cfg) {
+        this.cfg = cfg;
+    }
+    // ── Provider selection ────────────────────────────────────────────────
+    /**
+     * Pick the active provider, or `null` if no neural provider is
+     * available. TF-IDF is only returned when explicitly opted in.
+     * Async so we can probe Ollama on localhost the first time we're
+     * called (cached after that).
+     */
+    async provider() {
+        const override = process.env["EMBEDDING_PROVIDER"]?.toLowerCase();
+        if (override === "openai" && this.hasKey("OPENAI_API_KEY"))
+            return "openai";
+        if (override === "google" && this.hasKey("GOOGLE_AI_API_KEY"))
+            return "google";
+        if (override === "ollama")
+            return "ollama";
+        if (override === "tfidf")
+            return "tfidf";
+        if (this.hasKey("OPENAI_API_KEY"))
+            return "openai";
+        if (this.hasKey("GOOGLE_AI_API_KEY"))
+            return "google";
+        if (await this.probeOllama())
+            return "ollama";
+        return null;
+    }
+    /** Synchronous best-guess — used where we can't await (e.g. JSON encoders). */
+    providerSync() {
+        const override = process.env["EMBEDDING_PROVIDER"]?.toLowerCase();
+        if (override === "openai" && this.hasKey("OPENAI_API_KEY"))
+            return "openai";
+        if (override === "google" && this.hasKey("GOOGLE_AI_API_KEY"))
+            return "google";
+        if (override === "ollama")
+            return "ollama";
+        if (override === "tfidf")
+            return "tfidf";
+        if (this.hasKey("OPENAI_API_KEY"))
+            return "openai";
+        if (this.hasKey("GOOGLE_AI_API_KEY"))
+            return "google";
+        if (this.ollamaProbed === true)
+            return "ollama";
+        return null;
+    }
+    /** Quick check: do we have any provider at all (neural or TF-IDF opt-in)? */
+    async isAvailable() {
+        return (await this.provider()) !== null;
+    }
+    // ── Single + batch ────────────────────────────────────────────────────
+    async generate(text, forceProvider) {
+        const provider = forceProvider ?? await this.provider();
+        if (provider === null)
+            return null;
+        const trimmed = (text ?? "").slice(0, MAX_INPUT_CHARS);
+        if (provider === "tfidf") {
+            const v = this.tfidf.embed(trimmed);
+            return v ? { provider, vector: v, dim: v.length } : null;
+        }
+        try {
+            const model = await this.buildProviderModel(provider);
+            if (!model)
+                return null;
+            const { embedding } = await embed({ model, value: trimmed });
+            return { provider, vector: embedding, dim: embedding.length };
+        }
+        catch (e) {
+            // Neural provider failed mid-flight (429 / network / model missing).
+            // Return null so the caller falls back to its non-embedding path
+            // instead of silently swapping providers behind its back.
+            log.warn({ provider, err: e.message }, "embedding provider failed — returning null");
+            return null;
+        }
+    }
+    async generateBatch(texts, forceProvider) {
+        if (texts.length === 0)
+            return { provider: "tfidf", vectors: [], dim: 0 };
+        const provider = forceProvider ?? await this.provider();
+        if (provider === null)
+            return null;
+        const values = texts.map((t) => (t ?? "").slice(0, MAX_INPUT_CHARS));
+        if (provider === "tfidf") {
+            const vectors = values.map((v) => this.tfidf.embed(v) ?? []);
+            const dim = vectors.find((v) => v.length > 0)?.length ?? 0;
+            return { provider, vectors, dim };
+        }
+        try {
+            const model = await this.buildProviderModel(provider);
+            if (!model)
+                return null;
+            const { embeddings } = await embedMany({ model, values });
+            return { provider, vectors: embeddings, dim: embeddings[0]?.length ?? 0 };
+        }
+        catch (e) {
+            log.warn({ provider, err: e.message }, "batch embedding failed — returning null");
+            return null;
+        }
+    }
+    // ── Ollama readiness ──────────────────────────────────────────────────
+    /**
+     * Probe Ollama once on localhost. If reachable AND the embed model is
+     * missing, auto-pull it (non-blocking best-effort). Call once at boot
+     * so skill matching is live from the first task.
+     */
+    async ensureOllamaModel() {
+        const override = process.env["EMBEDDING_PROVIDER"]?.toLowerCase();
+        if (override && override !== "ollama")
+            return;
+        if (this.hasKey("OPENAI_API_KEY") || this.hasKey("GOOGLE_AI_API_KEY"))
+            return;
+        const up = await this.probeOllama();
+        if (!up) {
+            log.info("ollama not detected — TF-IDF will handle embeddings");
+            return;
+        }
+        const modelName = process.env["OLLAMA_EMBED_MODEL"] ?? OLLAMA_DEFAULT_MODEL;
+        await this.pullOllamaModelIfMissing(modelName);
+    }
+    // ── Internal ──────────────────────────────────────────────────────────
+    hasKey(key) {
+        return this.cfg.vault.isUnlocked() && this.cfg.vault.has(key);
+    }
+    apiKey(key) {
+        const s = this.cfg.vault.get(key);
+        return s?.reveal();
+    }
+    async buildProviderModel(provider) {
+        if (provider === "openai") {
+            const { createOpenAI } = await import("@ai-sdk/openai");
+            const key = this.apiKey("OPENAI_API_KEY");
+            if (!key)
+                return null;
+            return createOpenAI({ apiKey: key }).embedding("text-embedding-3-small");
+        }
+        if (provider === "google") {
+            const { createGoogleGenerativeAI } = await import("@ai-sdk/google");
+            const key = this.apiKey("GOOGLE_AI_API_KEY");
+            if (!key)
+                return null;
+            return createGoogleGenerativeAI({ apiKey: key }).textEmbeddingModel("text-embedding-004");
+        }
+        if (provider === "ollama") {
+            const { createOllama } = await import("ollama-ai-provider-v2");
+            const baseURL = this.cfg.setting("OLLAMA_BASE_URL") ?? "http://localhost:11434";
+            const modelName = process.env["OLLAMA_EMBED_MODEL"] ?? OLLAMA_DEFAULT_MODEL;
+            return createOllama({ baseURL: `${baseURL}/api` }).textEmbeddingModel(modelName);
+        }
+        return null;
+    }
+    async probeOllama() {
+        if (this.ollamaProbed !== null)
+            return this.ollamaProbed;
+        const baseUrl = process.env["OLLAMA_HOST"] ?? "http://localhost:11434";
+        try {
+            const ctrl = new AbortController();
+            const timer = setTimeout(() => ctrl.abort(), OLLAMA_PROBE_TIMEOUT_MS);
+            const res = await fetch(`${baseUrl}/api/tags`, { signal: ctrl.signal });
+            clearTimeout(timer);
+            this.ollamaProbed = res.ok;
+        }
+        catch {
+            this.ollamaProbed = false;
+        }
+        return this.ollamaProbed;
+    }
+    async pullOllamaModelIfMissing(modelName) {
+        if (this.ollamaModelReady)
+            return;
+        const baseUrl = process.env["OLLAMA_HOST"] ?? "http://localhost:11434";
+        try {
+            const tags = await fetch(`${baseUrl}/api/tags`).then((r) => r.ok ? r.json() : null);
+            const list = tags?.models ?? [];
+            const exists = list.some((m) => m.name === modelName || m.name.startsWith(`${modelName}:`));
+            if (exists) {
+                this.ollamaModelReady = true;
+                log.info({ model: modelName }, "ollama embedding model ready");
+                return;
+            }
+            log.info({ model: modelName }, "pulling ollama embedding model (one-time)");
+            const res = await fetch(`${baseUrl}/api/pull`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify({ name: modelName, stream: false }),
+            });
+            if (res.ok) {
+                this.ollamaModelReady = true;
+                log.info({ model: modelName }, "ollama embedding model pulled");
+            }
+            else {
+                log.warn({ model: modelName, status: res.status }, "ollama model pull failed");
+            }
+        }
+        catch (e) {
+            log.warn({ err: e.message }, "ollama model check crashed");
+        }
+    }
+}
+// ── shared utility ─────────────────────────────────────────────────────
+export function cosineSim(a, b) {
+    if (a.length !== b.length)
+        return 0;
+    let dot = 0, na = 0, nb = 0;
+    for (let i = 0; i < a.length; i++) {
+        const ai = a[i];
+        const bi = b[i];
+        dot += ai * bi;
+        na += ai * ai;
+        nb += bi * bi;
+    }
+    if (na === 0 || nb === 0)
+        return 0;
+    return dot / (Math.sqrt(na) * Math.sqrt(nb));
+}
+//# sourceMappingURL=Embeddings.js.map

package/dist/embeddings/Embeddings.js.map

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

package/dist/embeddings/TfIdf.d.ts

@@ -0,0 +1,26 @@
+/**
+ * TF-IDF embedder — pure JS, zero deps, always available.
+ *
+ * Builds a vocabulary from a corpus (call `fit` once at startup with
+ * every document you'll embed — skills, memory entries, etc.), then
+ * `embed(text)` returns a sparse L2-normalised vector with indices
+ * into the vocabulary.
+ *
+ * Quality is lower than neural embeddings but dramatically better
+ * than substring matching — synonyms still won't match, but frequent
+ * generic words are down-weighted so the "signal" terms dominate the
+ * cosine similarity.
+ */
+export declare class TfIdfEmbedder {
+    private readonly vocab;
+    private readonly vocabList;
+    private readonly idf;
+    private fitted;
+    get dim(): number;
+    get isFitted(): boolean;
+    /** Build the vocabulary from a corpus. Calling `fit` again replaces it. */
+    fit(docs: readonly string[]): void;
+    /** Embed a single text into an L2-normalised vector. */
+    embed(text: string): number[] | null;
+}
+//# sourceMappingURL=TfIdf.d.ts.map

package/dist/embeddings/TfIdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TfIdf.d.ts","sourceRoot":"","sources":["../../src/embeddings/TfIdf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA6B;IACjD,OAAO,CAAC,MAAM,CAAS;IAEvB,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,2EAA2E;IAC3E,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IA6BlC,wDAAwD;IACxD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;CAsBrC"}

package/dist/embeddings/TfIdf.js

@@ -0,0 +1,88 @@
+/**
+ * TF-IDF embedder — pure JS, zero deps, always available.
+ *
+ * Builds a vocabulary from a corpus (call `fit` once at startup with
+ * every document you'll embed — skills, memory entries, etc.), then
+ * `embed(text)` returns a sparse L2-normalised vector with indices
+ * into the vocabulary.
+ *
+ * Quality is lower than neural embeddings but dramatically better
+ * than substring matching — synonyms still won't match, but frequent
+ * generic words are down-weighted so the "signal" terms dominate the
+ * cosine similarity.
+ */
+export class TfIdfEmbedder {
+    vocab = new Map(); // word → index
+    vocabList = [];
+    idf = new Map();
+    fitted = false;
+    get dim() {
+        return this.vocabList.length;
+    }
+    get isFitted() {
+        return this.fitted;
+    }
+    /** Build the vocabulary from a corpus. Calling `fit` again replaces it. */
+    fit(docs) {
+        this.vocab.clear();
+        this.vocabList.length = 0;
+        this.idf.clear();
+        const N = docs.length;
+        if (N === 0) {
+            this.fitted = true;
+            return;
+        }
+        // Document frequency per word.
+        const df = new Map();
+        for (const doc of docs) {
+            for (const w of new Set(tokenize(doc))) {
+                df.set(w, (df.get(w) ?? 0) + 1);
+            }
+        }
+        // Smoothed IDF. Drop words that appear in every document (no signal).
+        let idx = 0;
+        for (const [word, count] of df) {
+            if (count < 1 || count === N)
+                continue;
+            this.idf.set(word, Math.log((N + 1) / (count + 1)) + 1);
+            this.vocabList.push(word);
+            this.vocab.set(word, idx++);
+        }
+        this.fitted = true;
+    }
+    /** Embed a single text into an L2-normalised vector. */
+    embed(text) {
+        if (this.vocabList.length === 0)
+            return null;
+        const tf = new Map();
+        for (const t of tokenize(text)) {
+            if (this.vocab.has(t))
+                tf.set(t, (tf.get(t) ?? 0) + 1);
+        }
+        const vec = new Float32Array(this.vocabList.length);
+        let norm = 0;
+        for (const [word, count] of tf) {
+            const i = this.vocab.get(word);
+            if (i === undefined)
+                continue;
+            const idf = this.idf.get(word) ?? 0;
+            const val = (1 + Math.log(count)) * idf;
+            vec[i] = val;
+            norm += val * val;
+        }
+        if (norm > 0) {
+            const inv = 1 / Math.sqrt(norm);
+            for (let i = 0; i < vec.length; i++)
+                vec[i] = (vec[i] ?? 0) * inv;
+        }
+        return Array.from(vec);
+    }
+}
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, " ")
+        .split(/\s+/)
+        .filter((w) => w.length > 1);
+}
+//# sourceMappingURL=TfIdf.js.map

package/dist/embeddings/TfIdf.js.map

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

package/dist/events/eventBus.d.ts

@@ -0,0 +1,97 @@
+/**
+ * EventBus — typed pub/sub for task lifecycle events.
+ *
+ * The TaskRunner emits events while an agent turn runs; channel handlers
+ * (and anything else interested) subscribe by task id. Filter in the
+ * listener — the bus is global so late subscribers don't miss events
+ * from a task they care about.
+ */
+import type { ChannelMeta } from "../channels/BaseChannel.js";
+export interface TaskEventMap {
+    "task:state": {
+        taskId: string;
+        status: "running" | "completed" | "failed";
+        result?: string;
+        error?: string;
+    };
+    "task:text:delta": {
+        taskId: string;
+        delta: string;
+    };
+    "task:text:end": {
+        taskId: string;
+        finalText: string;
+    };
+    "task:tool:before": {
+        taskId: string;
+        name: string;
+        args: unknown;
+    };
+    "task:tool:after": {
+        taskId: string;
+        name: string;
+        result?: unknown;
+        error?: string;
+        durationMs?: number;
+    };
+    "task:reply:needed": {
+        taskId: string;
+        channel: string;
+        channelMeta: ChannelMeta;
+        text: string;
+        failed: boolean;
+    };
+    "compact:triggered": {
+        sessionId: string;
+        tokens: number;
+        threshold: number;
+    };
+    "compact:completed": {
+        sessionId: string;
+        newSessionId: string;
+        tokensBefore: number;
+        tokensAfter: number;
+        savingsPct: number;
+    };
+    "compact:skipped": {
+        sessionId: string;
+        reason: string;
+    };
+    "loop:detected": {
+        taskId: string;
+        toolName: string;
+        pattern: "exact_repeat" | "ping_pong" | "semantic_repeat" | "polling";
+        message: string;
+    };
+    "memory:written": {
+        target: "memory" | "user";
+        action: "add" | "replace" | "remove";
+    };
+    "skill:created": {
+        skillId: string;
+        path: string;
+    };
+    "skill:updated": {
+        skillId: string;
+    };
+    "skill:deleted": {
+        skillId: string;
+    };
+    "review:started": {
+        sessionId: string;
+        kind: "memory" | "skill" | "combined";
+    };
+    "review:completed": {
+        sessionId: string;
+        saves: number;
+    };
+}
+export type TaskEventName = keyof TaskEventMap;
+export declare class EventBus {
+    private readonly emitter;
+    constructor();
+    on<K extends TaskEventName>(event: K, listener: (payload: TaskEventMap[K]) => void): () => void;
+    off<K extends TaskEventName>(event: K, listener: (payload: TaskEventMap[K]) => void): void;
+    emit<K extends TaskEventName>(event: K, payload: TaskEventMap[K]): void;
+}
+//# sourceMappingURL=eventBus.d.ts.map

package/dist/events/eventBus.d.ts.map

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

package/dist/events/eventBus.js

@@ -0,0 +1,26 @@
+/**
+ * EventBus — typed pub/sub for task lifecycle events.
+ *
+ * The TaskRunner emits events while an agent turn runs; channel handlers
+ * (and anything else interested) subscribe by task id. Filter in the
+ * listener — the bus is global so late subscribers don't miss events
+ * from a task they care about.
+ */
+import { EventEmitter } from "node:events";
+export class EventBus {
+    emitter = new EventEmitter();
+    constructor() {
+        this.emitter.setMaxListeners(100);
+    }
+    on(event, listener) {
+        this.emitter.on(event, listener);
+        return () => this.emitter.off(event, listener);
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+    }
+    emit(event, payload) {
+        this.emitter.emit(event, payload);
+    }
+}
+//# sourceMappingURL=eventBus.js.map

package/dist/events/eventBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventBus.js","sourceRoot":"","sources":["../../src/events/eventBus.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAsD3C,MAAM,OAAO,QAAQ;IACF,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IAE9C;QACE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,EAAE,CACA,KAAQ,EACR,QAA4C;QAE5C,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACjC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,GAAG,CACD,KAAQ,EACR,QAA4C;QAE5C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAA0B,KAAQ,EAAE,OAAwB;QAC9D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/goals/GoalStore.d.ts

@@ -0,0 +1,40 @@
+/**
+ * GoalStore — persistent goals with autonomous check scheduling.
+ *
+ * A goal is a high-level objective the agent tracks over time.
+ * The agent periodically checks if goals are met and reports progress.
+ */
+import type Database from "better-sqlite3";
+export interface GoalRow {
+    readonly id: string;
+    readonly title: string;
+    readonly description: string;
+    readonly status: "active" | "completed" | "paused" | "failed";
+    readonly checkCron: string | null;
+    readonly lastCheckedAt: number | null;
+    readonly completedAt: number | null;
+    readonly progress: number;
+    readonly notes: string;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+}
+export declare class GoalStore {
+    private readonly db;
+    private readonly insertStmt;
+    private readonly selectAll;
+    private readonly selectOne;
+    private readonly updateStmt;
+    private readonly deleteStmt;
+    constructor(db: Database.Database);
+    create(opts: {
+        title: string;
+        description?: string;
+        checkCron?: string;
+    }): GoalRow;
+    list(): readonly GoalRow[];
+    get(id: string): GoalRow | null;
+    update(id: string, opts: Partial<Pick<GoalRow, "title" | "description" | "status" | "checkCron" | "progress" | "notes">>, markChecked?: boolean): boolean;
+    delete(id: string): boolean;
+    activeGoals(): readonly GoalRow[];
+}
+//# sourceMappingURL=GoalStore.d.ts.map

package/dist/goals/GoalStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoalStore.d.ts","sourceRoot":"","sources":["../../src/goals/GoalStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAM3C,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAkBD,qBAAa,SAAS;IAOR,OAAO,CAAC,QAAQ,CAAC,EAAE;IAN/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;gBAEnB,EAAE,EAAE,QAAQ,CAAC,QAAQ;IA4BlD,MAAM,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAQlF,IAAI,IAAI,SAAS,OAAO,EAAE;IAI1B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAI/B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC,CAAC,EAAE,WAAW,UAAQ,GAAG,OAAO;IAoBvJ,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B,WAAW,IAAI,SAAS,OAAO,EAAE;CAGlC"}

package/dist/goals/GoalStore.js

@@ -0,0 +1,82 @@
+/**
+ * GoalStore — persistent goals with autonomous check scheduling.
+ *
+ * A goal is a high-level objective the agent tracks over time.
+ * The agent periodically checks if goals are met and reports progress.
+ */
+import { randomUUID } from "node:crypto";
+import { createLogger } from "../util/logger.js";
+const log = createLogger("goals");
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS goals (
+  id              TEXT PRIMARY KEY,
+  title           TEXT NOT NULL,
+  description     TEXT NOT NULL DEFAULT '',
+  status          TEXT NOT NULL DEFAULT 'active',
+  check_cron      TEXT,
+  last_checked_at INTEGER,
+  completed_at    INTEGER,
+  progress        INTEGER NOT NULL DEFAULT 0,
+  notes           TEXT NOT NULL DEFAULT '',
+  created_at      INTEGER NOT NULL,
+  updated_at      INTEGER NOT NULL
+);
+`;
+export class GoalStore {
+    db;
+    insertStmt;
+    selectAll;
+    selectOne;
+    updateStmt;
+    deleteStmt;
+    constructor(db) {
+        this.db = db;
+        db.exec(SCHEMA);
+        this.insertStmt = db.prepare(`INSERT INTO goals (id, title, description, status, check_cron, progress, notes, created_at, updated_at)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+        this.selectAll = db.prepare(`SELECT id, title, description, status, check_cron AS checkCron,
+              last_checked_at AS lastCheckedAt, completed_at AS completedAt,
+              progress, notes, created_at AS createdAt, updated_at AS updatedAt
+       FROM goals ORDER BY created_at DESC`);
+        this.selectOne = db.prepare(`SELECT id, title, description, status, check_cron AS checkCron,
+              last_checked_at AS lastCheckedAt, completed_at AS completedAt,
+              progress, notes, created_at AS createdAt, updated_at AS updatedAt
+       FROM goals WHERE id = ?`);
+        this.updateStmt = db.prepare(`UPDATE goals SET title=?, description=?, status=?, check_cron=?, progress=?, notes=?, updated_at=?,
+              completed_at=CASE WHEN ?='completed' THEN ? ELSE completed_at END,
+              last_checked_at=CASE WHEN ?=1 THEN ? ELSE last_checked_at END
+       WHERE id=?`);
+        this.deleteStmt = db.prepare(`DELETE FROM goals WHERE id = ?`);
+    }
+    create(opts) {
+        const id = randomUUID();
+        const now = Date.now();
+        this.insertStmt.run(id, opts.title, opts.description ?? "", "active", opts.checkCron ?? null, 0, "", now, now);
+        log.info({ id, title: opts.title }, "goal created");
+        return this.get(id);
+    }
+    list() {
+        return this.selectAll.all();
+    }
+    get(id) {
+        return this.selectOne.get(id) ?? null;
+    }
+    update(id, opts, markChecked = false) {
+        const existing = this.get(id);
+        if (!existing)
+            return false;
+        const now = Date.now();
+        const newStatus = opts.status ?? existing.status;
+        this.updateStmt.run(opts.title ?? existing.title, opts.description ?? existing.description, newStatus, opts.checkCron !== undefined ? opts.checkCron : existing.checkCron, opts.progress ?? existing.progress, opts.notes ?? existing.notes, now, newStatus, now, // completed_at CASE
+        markChecked ? 1 : 0, now, // last_checked_at CASE
+        id);
+        return true;
+    }
+    delete(id) {
+        return this.deleteStmt.run(id).changes > 0;
+    }
+    activeGoals() {
+        return this.list().filter((g) => g.status === "active");
+    }
+}
+//# sourceMappingURL=GoalStore.js.map