@josharsh/demon 0.1.0

package/dist/memory/facts.js

@@ -0,0 +1,98 @@
+// ============================================================================
+// Bi-temporal facts store — pure JS, portable, persisted via KVStore.
+//
+// Research-backed (Zep/Graphiti, ATOM): contradictions are resolved as TEMPORAL
+// operations, not deletions. When a fact's value changes, the old fact's
+// validity interval is closed (valid_until set) and a new fact opened. History
+// is preserved; nothing drifts.
+//
+// No native dependency. For a demon tracking dozens of entities, an in-memory
+// array persisted as JSON is more than sufficient — and runs in any runtime.
+// ============================================================================
+let idCounter = 0;
+function generateId(now) {
+    // Deterministic-enough unique id without Date.now()/random (keeps core pure).
+    idCounter += 1;
+    return `${now}-${idCounter.toString(36)}`;
+}
+export async function createFactsStore(kv, key = 'facts.json') {
+    let facts = [];
+    const raw = await kv.read(key);
+    if (raw) {
+        try {
+            facts = JSON.parse(raw);
+        }
+        catch {
+            facts = [];
+        }
+    }
+    function persist() {
+        // Fire-and-forget; the demon re-persists every cycle so a dropped write
+        // self-heals on the next observation.
+        void kv.write(key, JSON.stringify(facts));
+    }
+    function upsert(fact) {
+        const now = Date.parse(fact.observed_at) || 0;
+        if (fact.confidence >= 0.5) {
+            const existing = facts.find(f => f.entity === fact.entity && f.relation === fact.relation && f.valid_until === null);
+            if (existing) {
+                if (existing.value === fact.value) {
+                    // Same fact observed again — reinforce confidence (cap 1.0).
+                    existing.confidence = Math.min(1.0, existing.confidence + 0.1);
+                    existing.observed_at = fact.observed_at;
+                    persist();
+                    return;
+                }
+                // Different value — close the existing fact (temporal invalidation).
+                existing.valid_until = fact.observed_at;
+                existing.invalidated_at = fact.observed_at;
+            }
+        }
+        facts.push({ id: generateId(now), ...fact });
+        persist();
+    }
+    function getCurrent(entity, relation) {
+        return facts
+            .filter(f => f.entity === entity &&
+            f.valid_until === null &&
+            (relation === undefined || f.relation === relation))
+            .sort((a, b) => b.confidence - a.confidence);
+    }
+    function getHistory(entity) {
+        return facts
+            .filter(f => f.entity === entity)
+            .sort((a, b) => (a.valid_from < b.valid_from ? 1 : -1));
+    }
+    function getAllCurrent() {
+        return facts
+            .filter(f => f.valid_until === null)
+            .sort((a, b) => {
+            if (a.entity !== b.entity)
+                return a.entity < b.entity ? -1 : 1;
+            if (a.relation !== b.relation)
+                return a.relation < b.relation ? -1 : 1;
+            return b.confidence - a.confidence;
+        });
+    }
+    function invalidate(entity, relation, value) {
+        const stamp = new Date(0).toISOString(); // placeholder; callers pass via upsert normally
+        let changed = false;
+        for (const f of facts) {
+            if (f.entity === entity &&
+                f.relation === relation &&
+                f.value === value &&
+                f.valid_until === null) {
+                f.valid_until = f.observed_at || stamp;
+                f.invalidated_at = f.observed_at || stamp;
+                changed = true;
+            }
+        }
+        if (changed)
+            persist();
+    }
+    function close() {
+        persist();
+    }
+    return { upsert, getCurrent, getHistory, getAllCurrent, invalidate, close };
+}
+//# sourceMappingURL=facts.js.map

package/dist/memory/facts.js.map

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

package/dist/memory/manager.d.ts

@@ -0,0 +1,14 @@
+import { LLMProvider, DemonManifest, MemoryEntry, Observation, Fact, KVStore } from '../types.js';
+export interface MemoryContext {
+    narrative: string;
+    recentEpisodes: string;
+    relevantFacts: string;
+}
+export interface MemoryManager {
+    recordCycle(entry: MemoryEntry): Promise<void>;
+    buildContext(currentObservations: Observation[]): Promise<MemoryContext>;
+    close(): void;
+}
+export declare function createMemoryManager(kv: KVStore, manifest: DemonManifest, llm: LLMProvider): Promise<MemoryManager>;
+export declare function extractFacts(observations: Observation[], cycleNumber: number): Array<Omit<Fact, 'id'>>;
+//# sourceMappingURL=manager.d.ts.map

package/dist/memory/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/memory/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAejG,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,YAAY,CAAC,mBAAmB,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IACxE,KAAK,IAAI,IAAI,CAAA;CACd;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,OAAO,EACX,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,aAAa,CAAC,CAgExB;AAsBD,wBAAgB,YAAY,CAC1B,YAAY,EAAE,WAAW,EAAE,EAC3B,WAAW,EAAE,MAAM,GAClB,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CA2BzB"}

package/dist/memory/manager.js

@@ -0,0 +1,113 @@
+import { createFactsStore } from './facts.js';
+import { createNarrativeManager } from './narrative.js';
+import { createEpisodeStore } from './episodes.js';
+export async function createMemoryManager(kv, manifest, llm) {
+    const facts = await createFactsStore(kv);
+    const narrative = createNarrativeManager(kv);
+    const episodes = createEpisodeStore(kv);
+    const episodeBuffer = [];
+    async function recordCycle(entry) {
+        // 1. Episode layer — persist the raw cycle record.
+        await episodes.append(entry);
+        // 2. Facts layer — extract entity/relation/value facts generically.
+        for (const fact of extractFacts(entry.observations, entry.cycleNumber)) {
+            facts.upsert(fact);
+        }
+        // 3. Narrative layer — buffer for periodic compression.
+        episodeBuffer.push(entry);
+        if (narrative.shouldUpdate(entry.cycleNumber)) {
+            const batch = episodeBuffer.splice(0, episodeBuffer.length);
+            await narrative.update(llm, manifest, batch);
+        }
+    }
+    async function buildContext(currentObservations) {
+        const narrativeText = await narrative.read();
+        const recent = await episodes.getRecent(3);
+        let recentEpisodes = 'No prior history.';
+        if (recent.length > 0) {
+            recentEpisodes = recent
+                .map(e => {
+                const obs = e.observations.map(o => `  [${o.watcherType}] ${o.summary}`).join('\n');
+                const action = e.actionFired
+                    ? `  Action: ${e.actionFired.provider}.${e.actionFired.action}${e.actionFired.dryRun ? ' (dry-run)' : ''}${e.actionFired.error ? ' [FAILED]' : ' [OK]'}`
+                    : '  No action.';
+                return `Cycle #${e.cycleNumber} → ${e.decision.decision.toUpperCase()}: ${e.decision.reasoning.slice(0, 200)}\n${obs}\n${action}`;
+            })
+                .join('\n\n');
+        }
+        const entities = extractEntities(currentObservations);
+        let relevantFacts = 'No tracked entity states.';
+        const collected = entities.length > 0
+            ? entities.flatMap(e => facts.getCurrent(e))
+            : facts.getAllCurrent();
+        if (collected.length > 0) {
+            relevantFacts = collected
+                .map(f => `${f.entity}.${f.relation} = ${f.value} (confidence: ${f.confidence.toFixed(2)}, since: ${f.valid_from})`)
+                .join('\n');
+        }
+        return { narrative: narrativeText, recentEpisodes, relevantFacts };
+    }
+    function close() {
+        facts.close();
+    }
+    return { recordCycle, buildContext, close };
+}
+// ─── Generic fact extraction — no domain knowledge ───────────────────────────
+// Derives entity + scalar state from the SHAPE of an observation, never its
+// meaning. Works for any watcher: PRs, endpoints, paths, anything future.
+const ID_FIELDS = ['id', 'number', 'name', 'key', 'path', 'url', 'repo', 'sha', 'title'];
+function deriveEntityId(obs) {
+    const data = obs.data;
+    if (typeof data.owner === 'string' && typeof data.repo === 'string') {
+        const sub = data.number ?? data.id ?? data.sha;
+        return sub !== undefined ? `${data.owner}/${data.repo}#${sub}` : `${data.owner}/${data.repo}`;
+    }
+    for (const field of ID_FIELDS) {
+        const v = data[field];
+        if (typeof v === 'string' && v.trim() !== '')
+            return v;
+        if (typeof v === 'number')
+            return `${field}:${v}`;
+    }
+    return String(obs.watcherType);
+}
+export function extractFacts(observations, cycleNumber) {
+    const out = [];
+    for (const obs of observations) {
+        const entity = deriveEntityId(obs);
+        const now = obs.timestamp || new Date(0).toISOString();
+        for (const [relation, raw] of Object.entries(obs.data)) {
+            if (ID_FIELDS.includes(relation) || relation === 'owner')
+                continue;
+            let value;
+            if (typeof raw === 'string')
+                value = raw;
+            else if (typeof raw === 'number' || typeof raw === 'boolean')
+                value = String(raw);
+            else
+                continue;
+            if (value.trim() === '' || value.length > 500)
+                continue;
+            out.push({
+                entity,
+                relation,
+                value,
+                confidence: 1.0,
+                observed_at: now,
+                valid_from: now,
+                valid_until: null,
+                invalidated_at: null,
+                source_cycle: cycleNumber,
+                source_watcher: String(obs.watcherType),
+            });
+        }
+    }
+    return out;
+}
+function extractEntities(observations) {
+    const set = new Set();
+    for (const obs of observations)
+        set.add(deriveEntityId(obs));
+    return Array.from(set);
+}
+//# sourceMappingURL=manager.js.map

package/dist/memory/manager.js.map

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

package/dist/memory/narrative.d.ts

@@ -0,0 +1,8 @@
+import { LLMProvider, DemonManifest, MemoryEntry, KVStore } from '../types.js';
+export interface NarrativeManager {
+    read(): Promise<string>;
+    update(llm: LLMProvider, manifest: DemonManifest, newEpisodes: MemoryEntry[]): Promise<void>;
+    shouldUpdate(cycleNumber: number): boolean;
+}
+export declare function createNarrativeManager(kv: KVStore, key?: string): NarrativeManager;
+//# sourceMappingURL=narrative.d.ts.map

package/dist/memory/narrative.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrative.d.ts","sourceRoot":"","sources":["../../src/memory/narrative.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAc,OAAO,EAAE,MAAM,aAAa,CAAA;AAQ1F,MAAM,WAAW,gBAAgB;IAC/B,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IACvB,MAAM,CACJ,GAAG,EAAE,WAAW,EAChB,QAAQ,EAAE,aAAa,EACvB,WAAW,EAAE,WAAW,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC,CAAA;IAChB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3C;AAED,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,SAAkB,GAAG,gBAAgB,CAiD3F"}

package/dist/memory/narrative.js

@@ -0,0 +1,37 @@
+export function createNarrativeManager(kv, key = 'narrative.txt') {
+    async function read() {
+        return (await kv.read(key)) ?? '';
+    }
+    async function update(llm, manifest, newEpisodes) {
+        const current = await read();
+        const episodesSummary = newEpisodes
+            .map(e => {
+            const obsSummaries = e.observations.map(o => `  [${o.watcherType}] ${o.summary}`).join('\n');
+            const actionNote = e.actionFired
+                ? `  Action fired: ${e.actionFired.provider}.${e.actionFired.action}${e.actionFired.dryRun ? ' (dry-run)' : ''}${e.actionFired.error ? ` [FAILED: ${e.actionFired.error}]` : ''}`
+                : '  No action taken.';
+            return `Cycle #${e.cycleNumber} [${e.timestamp}]\n${obsSummaries}\n  Decision: ${e.decision.decision.toUpperCase()} — ${e.decision.reasoning}\n${actionNote}`;
+        })
+            .join('\n\n');
+        const prompt = `You are maintaining a running summary of your domain as a persistent daemon named ${manifest.name}.
+Your purpose: ${manifest.purpose}
+
+Current summary (update this, don't replace wholesale):
+${current || '(no summary yet — this is the first update)'}
+
+New observations from the last cycles:
+${episodesSummary || '(no new episodes)'}
+
+Update the summary to reflect new information. Keep it under 500 words.
+Structure: ENTITIES (current state of things you watch), PATTERNS (behavioral patterns you've noticed), LAST ACTED (when and why you last fired an action).
+Return ONLY the updated summary text, no preamble.`;
+        const messages = [{ role: 'user', content: prompt }];
+        const updated = await llm.call(messages, 'You are a concise summarizer maintaining a persistent daemon memory.');
+        await kv.write(key, updated.trim());
+    }
+    function shouldUpdate(cycleNumber) {
+        return cycleNumber > 0 && cycleNumber % 10 === 0;
+    }
+    return { read, update, shouldUpdate };
+}
+//# sourceMappingURL=narrative.js.map

package/dist/memory/narrative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrative.js","sourceRoot":"","sources":["../../src/memory/narrative.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,sBAAsB,CAAC,EAAW,EAAE,GAAG,GAAG,eAAe;IACvE,KAAK,UAAU,IAAI;QACjB,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IACnC,CAAC;IAED,KAAK,UAAU,MAAM,CACnB,GAAgB,EAChB,QAAuB,EACvB,WAA0B;QAE1B,MAAM,OAAO,GAAG,MAAM,IAAI,EAAE,CAAA;QAE5B,MAAM,eAAe,GAAG,WAAW;aAChC,GAAG,CAAC,CAAC,CAAC,EAAE;YACP,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC5F,MAAM,UAAU,GAAG,CAAC,CAAC,WAAW;gBAC9B,CAAC,CAAC,mBAAmB,CAAC,CAAC,WAAW,CAAC,QAAQ,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACjL,CAAC,CAAC,oBAAoB,CAAA;YACxB,OAAO,UAAU,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,SAAS,MAAM,YAAY,iBAAiB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,SAAS,KAAK,UAAU,EAAE,CAAA;QAC/J,CAAC,CAAC;aACD,IAAI,CAAC,MAAM,CAAC,CAAA;QAEf,MAAM,MAAM,GAAG,qFAAqF,QAAQ,CAAC,IAAI;gBACrG,QAAQ,CAAC,OAAO;;;EAG9B,OAAO,IAAI,6CAA6C;;;EAGxD,eAAe,IAAI,mBAAmB;;;;mDAIW,CAAA;QAE/C,MAAM,QAAQ,GAAiB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;QAClE,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAC5B,QAAQ,EACR,sEAAsE,CACvE,CAAA;QAED,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;IACrC,CAAC;IAED,SAAS,YAAY,CAAC,WAAmB;QACvC,OAAO,WAAW,GAAG,CAAC,IAAI,WAAW,GAAG,EAAE,KAAK,CAAC,CAAA;IAClD,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,CAAA;AACvC,CAAC"}

package/dist/platform/memory-kv.d.ts

@@ -0,0 +1,3 @@
+import { KVStore } from '../types.js';
+export declare function createMemoryKV(): KVStore;
+//# sourceMappingURL=memory-kv.d.ts.map

package/dist/platform/memory-kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-kv.d.ts","sourceRoot":"","sources":["../../src/platform/memory-kv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAKrC,wBAAgB,cAAc,IAAI,OAAO,CAmBxC"}

package/dist/platform/memory-kv.js

@@ -0,0 +1,24 @@
+// An in-memory KVStore. Zero dependencies, works everywhere. Used as the
+// default/ephemeral store and in tests. Hosts provide durable implementations
+// (CLI → filesystem, browser → IndexedDB) implementing the same interface.
+export function createMemoryKV() {
+    const store = new Map();
+    return {
+        async read(key) {
+            return store.has(key) ? store.get(key) : null;
+        },
+        async write(key, value) {
+            store.set(key, value);
+        },
+        async append(key, line) {
+            const prev = store.get(key) ?? '';
+            store.set(key, prev + line + '\n');
+        },
+        async readLines(key, lastN) {
+            const content = store.get(key) ?? '';
+            const lines = content.split('\n').filter(Boolean);
+            return typeof lastN === 'number' ? lines.slice(-lastN) : lines;
+        },
+    };
+}
+//# sourceMappingURL=memory-kv.js.map

package/dist/platform/memory-kv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-kv.js","sourceRoot":"","sources":["../../src/platform/memory-kv.ts"],"names":[],"mappings":"AAEA,yEAAyE;AACzE,8EAA8E;AAC9E,2EAA2E;AAC3E,MAAM,UAAU,cAAc;IAC5B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAA;IACvC,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,GAAW;YACpB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC,CAAC,CAAC,IAAI,CAAA;QAChD,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,KAAa;YACpC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACvB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,IAAY;YACpC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;YACjC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,CAAA;QACpC,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,KAAc;YACzC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;YACpC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;QAChE,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/reasoning.d.ts

@@ -0,0 +1,22 @@
+import { LLMDecision } from './types.js';
+/**
+ * Build the full demon reasoning prompt. Returns systemPrompt + separator +
+ * userPrompt joined; callers split on SEPARATOR to feed each part correctly.
+ */
+export declare function buildDemonPrompt(purpose: string, contextSummary: string, observations: Array<{
+    watcherType: string;
+    summary: string;
+    data: Record<string, unknown>;
+}>): string;
+/** Split a built prompt back into its system and user halves. */
+export declare function splitPrompt(combined: string): {
+    systemPrompt: string;
+    userContent: string;
+};
+/**
+ * Robustly parse an LLM response into an LLMDecision.
+ * Handles markdown code fences, leading/trailing prose, and malformed output
+ * (falls back to a safe "wait").
+ */
+export declare function parseLLMDecision(raw: string): LLMDecision;
+//# sourceMappingURL=reasoning.d.ts.map

package/dist/reasoning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning.d.ts","sourceRoot":"","sources":["../src/reasoning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAmBxC;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,KAAK,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GAC3F,MAAM,CAkCR;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAY3F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAwCzD"}

package/dist/reasoning.js

@@ -0,0 +1,104 @@
+// ============================================================================
+// Reasoning — pure prompt construction + decision parsing.
+// No platform deps. This is the demon's "how do I think about a cycle" layer.
+// ============================================================================
+const LLM_DECISION_SCHEMA = `{
+  "decision": "act" | "wait",
+  "reasoning": string,  // 1-3 sentences, must reference specific observations
+  "action": {           // ONLY include when decision is "act"
+    "provider": string, // one of the available action providers
+    "action": string,   // provider-specific action name
+    "params": object    // complete, actionable params — no placeholders
+  }
+}`;
+const SEPARATOR = '\n\n===USER===\n';
+/**
+ * Build the full demon reasoning prompt. Returns systemPrompt + separator +
+ * userPrompt joined; callers split on SEPARATOR to feed each part correctly.
+ */
+export function buildDemonPrompt(purpose, contextSummary, observations) {
+    const systemPrompt = `You are a Demon — a persistent AI reasoning process with a defined purpose.
+You are NOT a task executor. You are a continuous observer and reasoner.
+You observe the world, reason about it in the context of your purpose, and decide whether to act.
+
+Your response MUST be valid JSON matching this exact schema:
+${LLM_DECISION_SCHEMA}
+
+Rules:
+- Prefer "wait" when nothing meaningful has changed relative to your purpose
+- Prefer "act" only when something genuinely warrants a response given your purpose
+- Your reasoning must reference specific observations, not be generic
+- Params must be complete and actionable — do not use placeholders
+- Respond ONLY with a single JSON object — no explanation, no code fences, no prose`;
+    const observationText = observations.length > 0
+        ? observations
+            .map(obs => `[${obs.watcherType}] ${obs.summary}\nData: ${JSON.stringify(obs.data, null, 2)}`)
+            .join('\n\n---\n\n')
+        : 'No observations available this cycle.';
+    const userPrompt = `Purpose: ${purpose}
+
+${contextSummary}
+
+Current observations:
+${observationText}
+
+Reason about whether to act based on your purpose and the observations above.`;
+    return [systemPrompt, userPrompt].join(SEPARATOR);
+}
+/** Split a built prompt back into its system and user halves. */
+export function splitPrompt(combined) {
+    const idx = combined.indexOf(SEPARATOR);
+    if (idx === -1) {
+        return {
+            systemPrompt: combined,
+            userContent: 'Reason about whether to act based on your purpose and the observations above.',
+        };
+    }
+    return {
+        systemPrompt: combined.slice(0, idx),
+        userContent: combined.slice(idx + SEPARATOR.length),
+    };
+}
+/**
+ * Robustly parse an LLM response into an LLMDecision.
+ * Handles markdown code fences, leading/trailing prose, and malformed output
+ * (falls back to a safe "wait").
+ */
+export function parseLLMDecision(raw) {
+    let cleaned = raw.trim();
+    const fenceMatch = cleaned.match(/^```(?:json)?\s*\n?([\s\S]*?)\n?```\s*$/m);
+    if (fenceMatch)
+        cleaned = fenceMatch[1].trim();
+    const jsonStart = cleaned.indexOf('{');
+    const jsonEnd = cleaned.lastIndexOf('}');
+    if (jsonStart !== -1 && jsonEnd !== -1 && jsonStart < jsonEnd) {
+        cleaned = cleaned.slice(jsonStart, jsonEnd + 1);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(cleaned);
+    }
+    catch {
+        return {
+            decision: 'wait',
+            reasoning: `LLM returned unparseable response: ${raw.slice(0, 200)}`,
+        };
+    }
+    const p = parsed;
+    const decision = p.decision === 'act' ? 'act' : 'wait';
+    const reasoning = typeof p.reasoning === 'string' ? p.reasoning : 'No reasoning provided.';
+    if (decision === 'act' && p.action && typeof p.action === 'object') {
+        const a = p.action;
+        return {
+            decision: 'act',
+            reasoning,
+            action: {
+                provider: String(a.provider ?? ''),
+                action: String(a.action ?? ''),
+                params: a.params ?? {},
+            },
+        };
+    }
+    return { decision: 'wait', reasoning };
+}
+//# sourceMappingURL=reasoning.js.map

package/dist/reasoning.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,144 @@
+export interface DemonManifest {
+    name: string;
+    purpose: string;
+    watch: WatcherConfig[];
+    interval: string;
+    actions: ActionConfig[];
+    model: string;
+    action_mode: ActionMode;
+    memory_path?: string;
+}
+export type ActionMode = 'dry_run' | 'cautious' | 'auto';
+export interface WatcherConfig {
+    type: WatcherType;
+    repo?: string;
+    url?: string;
+    path?: string;
+    headers?: Record<string, string>;
+    branch?: string;
+}
+export type WatcherType = 'github_prs' | 'github_ci' | 'github_commits' | 'http' | 'filesystem';
+export interface ActionConfig {
+    provider: string;
+    action: string;
+    on?: string;
+    channel?: string;
+    url?: string;
+    method?: string;
+    script?: string;
+    path?: string;
+    label?: string;
+}
+export type DemonStatus = 'running' | 'paused' | 'stopped' | 'error' | 'starting';
+export interface DemonState {
+    pid: number;
+    name: string;
+    manifestPath: string;
+    startedAt: string;
+    cycles: number;
+    actionsCount: number;
+    lastCheck: string | null;
+    status: DemonStatus;
+    model: string;
+    actionMode: ActionMode;
+}
+export interface Observation {
+    watcherType: WatcherType | string;
+    data: Record<string, unknown>;
+    summary: string;
+    timestamp: string;
+}
+export interface LLMDecision {
+    decision: 'act' | 'wait';
+    reasoning: string;
+    action?: ActionInstruction;
+}
+export interface ActionInstruction {
+    provider: string;
+    action: string;
+    params: Record<string, unknown>;
+}
+export interface ActionFired {
+    provider: string;
+    action: string;
+    params: Record<string, unknown>;
+    result?: unknown;
+    error?: string;
+    dryRun: boolean;
+    timestamp: string;
+}
+export interface MemoryEntry {
+    id: string;
+    timestamp: string;
+    cycleNumber: number;
+    observations: Observation[];
+    decision: LLMDecision;
+    actionFired?: ActionFired;
+}
+export interface LLMMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export interface LLMProvider {
+    name: string;
+    model: string;
+    call(messages: LLMMessage[], systemPrompt: string): Promise<string>;
+    callStructured?(schema: Record<string, unknown>, toolName: string, prompt: string): Promise<unknown>;
+}
+export interface Watcher {
+    type: WatcherType | string;
+    config: WatcherConfig;
+    collect(): Promise<Observation[]>;
+}
+export interface ActionProvider {
+    provider: string;
+    execute(instruction: ActionInstruction, credentials: Record<string, string>): Promise<unknown>;
+    getAvailableActions(): string[];
+}
+export interface Clock {
+    now(): number;
+    sleep(ms: number): Promise<void>;
+}
+export interface Logger {
+    debug(msg: string, meta?: Record<string, unknown>): void;
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+}
+export interface KVStore {
+    read(key: string): Promise<string | null>;
+    write(key: string, value: string): Promise<void>;
+    append(key: string, line: string): Promise<void>;
+    readLines(key: string, lastN?: number): Promise<string[]>;
+}
+export interface Fact {
+    id: string;
+    entity: string;
+    relation: string;
+    value: string;
+    confidence: number;
+    observed_at: string;
+    valid_from: string;
+    valid_until: string | null;
+    invalidated_at: string | null;
+    source_cycle: number;
+    source_watcher: string;
+}
+export interface FactsStore {
+    upsert(fact: Omit<Fact, 'id'>): void;
+    getCurrent(entity: string, relation?: string): Fact[];
+    getHistory(entity: string): Fact[];
+    getAllCurrent(): Fact[];
+    invalidate(entity: string, relation: string, value: string): void;
+    close(): void;
+}
+export interface Storage {
+    kv: KVStore;
+    facts: FactsStore;
+}
+export interface Platform {
+    clock: Clock;
+    logger: Logger;
+    storage: Storage;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,9 @@
+// ============================================================================
+// @josharsh/demon — core domain types
+//
+// This file has NO platform dependencies. The core engine depends only on the
+// interfaces declared here; concrete Node / browser implementations are
+// injected by the host (CLI, website, edge function).
+// ============================================================================
+export {};
+//# sourceMappingURL=types.js.map