@josharsh/demon 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Harsh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# @josharsh/demon
+
+The portable engine behind [demon](https://demon.josharsh.com) — a persistent reasoning process that watches a domain and acts on its own judgment, instead of waiting to be called.
+
+This package is the platform-neutral core: the judgment loop, three-layer memory (event log + bi-temporal facts + compressed narrative), reasoning, and a fetch-based LLM layer. No native dependencies — it runs in Node, the browser, and at the edge. Host packages supply the `Clock` / `Logger` / `Storage` implementations via the platform seam.
+
+If you just want to run demons, install the CLI instead:
+
+```bash
+npm install -g @josharsh/demon-cli
+```
+
+## Embed the engine
+
+```bash
+npm install @josharsh/demon
+```
+
+```ts
+import { runLoop, createLLMProvider, createMemoryKV } from '@josharsh/demon'
+
+await runLoop({
+  manifest,            // name, purpose, watch, interval, actions, model, action_mode
+  watchers,            // your Watcher[] — observe a domain
+  llm: createLLMProvider('claude-sonnet-4-6', { ANTHROPIC_API_KEY: key }),
+  actions,             // Map<string, ActionProvider>
+  credentials: new Map(),
+  logger, clock,       // inject your platform's Logger + Clock
+  storage: createMemoryKV(),  // or a durable KVStore (fs / IndexedDB)
+})
+```
+
+You bring the watchers, actions, storage, and clock; the engine runs the observe → judge → act loop and keeps the memory.
+
+MIT licensed. See the [main repo](https://github.com/josharsh/demon) for docs, the CLI, and the concept (agents vs demons).

package/dist/actions/portable.d.ts

@@ -0,0 +1,4 @@
+import { ActionProvider, Logger } from '../types.js';
+export declare function createLogAction(logger: Logger): ActionProvider;
+export declare function createWebhookAction(): ActionProvider;
+//# sourceMappingURL=portable.d.ts.map

package/dist/actions/portable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable.d.ts","sourceRoot":"","sources":["../../src/actions/portable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqB,MAAM,EAAE,MAAM,aAAa,CAAA;AASvE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAW9D;AAGD,wBAAgB,mBAAmB,IAAI,cAAc,CAkBpD"}

package/dist/actions/portable.js

@@ -0,0 +1,40 @@
+// ============================================================================
+// Portable action providers — work in any runtime (Node + browser).
+// Node-only actions (notify/osascript, file/fs, script/child_process) live in
+// the host package. These cover the universal building blocks.
+// ============================================================================
+// `log` — write to the demon's logger. Always available, no credentials.
+export function createLogAction(logger) {
+    return {
+        provider: 'log',
+        getAvailableActions: () => ['info', 'warn', 'error'],
+        async execute(instruction) {
+            const msg = String(instruction.params.message ?? instruction.params.text ?? '');
+            const level = instruction.action === 'warn' ? 'warn' : instruction.action === 'error' ? 'error' : 'info';
+            logger[level](`[demon-action] ${msg}`);
+            return { logged: true, level };
+        },
+    };
+}
+// `webhook` — POST JSON to any URL. The universal escape hatch.
+export function createWebhookAction() {
+    return {
+        provider: 'webhook',
+        getAvailableActions: () => ['post'],
+        async execute(instruction) {
+            const url = String(instruction.params.url ?? '');
+            if (!url)
+                throw new Error('webhook.post requires a "url" param');
+            const method = String(instruction.params.method ?? 'POST');
+            const headers = {
+                'content-type': 'application/json',
+                'user-agent': 'demon/0.1',
+                ...instruction.params.headers,
+            };
+            const body = instruction.params.body ?? { from: 'demon', params: instruction.params };
+            const res = await fetch(url, { method, headers, body: JSON.stringify(body) });
+            return { status: res.status, ok: res.ok };
+        },
+    };
+}
+//# sourceMappingURL=portable.js.map

package/dist/actions/portable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"portable.js","sourceRoot":"","sources":["../../src/actions/portable.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,oEAAoE;AACpE,8EAA8E;AAC9E,+DAA+D;AAC/D,+EAA+E;AAE/E,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,mBAAmB,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QACpD,KAAK,CAAC,OAAO,CAAC,WAA8B;YAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAA;YAC/E,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAA;YACxG,MAAM,CAAC,KAAK,CAAC,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAA;YACtC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;QAChC,CAAC;KACF,CAAA;AACH,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,QAAQ,EAAE,SAAS;QACnB,mBAAmB,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC;QACnC,KAAK,CAAC,OAAO,CAAC,WAA8B;YAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,CAAA;YAChD,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;YAChE,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,CAAA;YAC1D,MAAM,OAAO,GAAG;gBACd,cAAc,EAAE,kBAAkB;gBAClC,YAAY,EAAE,WAAW;gBACzB,GAAI,WAAW,CAAC,MAAM,CAAC,OAA8C;aACtE,CAAA;YACD,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAA;YACrF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC7E,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAA;QAC3C,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export * from './types.js';
+export { parseInterval, formatInterval } from './util/time.js';
+export { buildDemonPrompt, splitPrompt, parseLLMDecision } from './reasoning.js';
+export { createMemoryManager, extractFacts } from './memory/manager.js';
+export type { MemoryManager, MemoryContext } from './memory/manager.js';
+export { createFactsStore } from './memory/facts.js';
+export { createEpisodeStore } from './memory/episodes.js';
+export type { EpisodeStore } from './memory/episodes.js';
+export { createNarrativeManager } from './memory/narrative.js';
+export type { NarrativeManager } from './memory/narrative.js';
+export { createLLMProvider } from './llm/providers.js';
+export type { KeyMap } from './llm/providers.js';
+export { runLoop } from './loop.js';
+export type { LoopConfig } from './loop.js';
+export { createLogAction, createWebhookAction } from './actions/portable.js';
+export { createMemoryKV } from './platform/memory-kv.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,cAAc,YAAY,CAAA;AAG1B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAGhF,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAG7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,YAAY,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAGhD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAG3C,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAG5E,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/index.js

@@ -0,0 +1,26 @@
+// ============================================================================
+// @josharsh/demon — the portable demon engine.
+//
+// A demon is a persistent reasoning process with a purpose: it observes,
+// judges, and acts on its own — it is not invoked like an agent. This package
+// is the platform-neutral core. Host packages (CLI, browser) supply the
+// Clock / Logger / Storage implementations via the platform seam in types.ts.
+// ============================================================================
+export * from './types.js';
+// reasoning
+export { parseInterval, formatInterval } from './util/time.js';
+export { buildDemonPrompt, splitPrompt, parseLLMDecision } from './reasoning.js';
+// memory
+export { createMemoryManager, extractFacts } from './memory/manager.js';
+export { createFactsStore } from './memory/facts.js';
+export { createEpisodeStore } from './memory/episodes.js';
+export { createNarrativeManager } from './memory/narrative.js';
+// llm
+export { createLLMProvider } from './llm/providers.js';
+// loop
+export { runLoop } from './loop.js';
+// portable actions
+export { createLogAction, createWebhookAction } from './actions/portable.js';
+// platform helpers
+export { createMemoryKV } from './platform/memory-kv.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,+CAA+C;AAC/C,EAAE;AACF,yEAAyE;AACzE,8EAA8E;AAC9E,wEAAwE;AACxE,8EAA8E;AAC9E,+EAA+E;AAE/E,cAAc,YAAY,CAAA;AAE1B,YAAY;AACZ,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEhF,SAAS;AACT,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAG9D,MAAM;AACN,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAGtD,OAAO;AACP,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGnC,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAE5E,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/llm/providers.d.ts

@@ -0,0 +1,4 @@
+import { LLMProvider } from '../types.js';
+export type KeyMap = Record<string, string | undefined>;
+export declare function createLLMProvider(model: string, keys: KeyMap): LLMProvider;
+//# sourceMappingURL=providers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/llm/providers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,aAAa,CAAA;AAYrD,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;AAuIvD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CA8B1E"}

package/dist/llm/providers.js

@@ -0,0 +1,163 @@
+function requireKey(keys, names, provider) {
+    for (const n of names) {
+        const v = keys[n];
+        if (v)
+            return v;
+    }
+    throw new Error(`No API key for ${provider}. Provide one of: ${names.join(', ')}`);
+}
+// ─── Anthropic (Claude) over fetch ────────────────────────────────────────────
+class AnthropicProvider {
+    model;
+    apiKey;
+    name = 'anthropic';
+    constructor(model, apiKey) {
+        this.model = model;
+        this.apiKey = apiKey;
+    }
+    headers() {
+        return {
+            'content-type': 'application/json',
+            'x-api-key': this.apiKey,
+            'anthropic-version': '2023-06-01',
+            'anthropic-dangerous-direct-browser-access': 'true',
+        };
+    }
+    async call(messages, systemPrompt) {
+        const res = await fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: this.headers(),
+            body: JSON.stringify({
+                model: this.model,
+                max_tokens: 2048,
+                system: systemPrompt,
+                messages: messages.map(m => ({ role: m.role, content: m.content })),
+            }),
+        });
+        if (!res.ok)
+            throw new Error(`Anthropic ${res.status}: ${(await res.text()).slice(0, 200)}`);
+        const data = (await res.json());
+        const block = data.content.find(b => b.type === 'text');
+        if (!block?.text)
+            throw new Error('Anthropic returned no text block');
+        return block.text;
+    }
+    async callStructured(schema, toolName, prompt) {
+        const res = await fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: this.headers(),
+            body: JSON.stringify({
+                model: this.model,
+                max_tokens: 1024,
+                tools: [{ name: toolName, description: 'Extract structured data matching the schema.', input_schema: schema }],
+                tool_choice: { type: 'tool', name: toolName },
+                messages: [{ role: 'user', content: prompt }],
+            }),
+        });
+        if (!res.ok)
+            throw new Error(`Anthropic ${res.status}: ${(await res.text()).slice(0, 200)}`);
+        const data = (await res.json());
+        const tool = data.content.find(b => b.type === 'tool_use');
+        if (!tool) {
+            const text = data.content.find(b => b.type === 'text')?.text ?? '';
+            throw new Error(`Model refused structured output: ${text.slice(0, 200)}`);
+        }
+        return tool.input;
+    }
+}
+// ─── OpenAI-compatible over fetch ─────────────────────────────────────────────
+class OpenAICompatProvider {
+    name;
+    model;
+    apiKey;
+    baseURL;
+    constructor(name, model, apiKey, baseURL = 'https://api.openai.com/v1') {
+        this.name = name;
+        this.model = model;
+        this.apiKey = apiKey;
+        this.baseURL = baseURL;
+    }
+    headers() {
+        return { 'content-type': 'application/json', authorization: `Bearer ${this.apiKey}` };
+    }
+    async call(messages, systemPrompt) {
+        const res = await fetch(`${this.baseURL}/chat/completions`, {
+            method: 'POST',
+            headers: this.headers(),
+            body: JSON.stringify({
+                model: this.model,
+                max_tokens: 2048,
+                messages: [{ role: 'system', content: systemPrompt }, ...messages.map(m => ({ role: m.role, content: m.content }))],
+            }),
+        });
+        if (!res.ok)
+            throw new Error(`${this.name} ${res.status}: ${(await res.text()).slice(0, 200)}`);
+        const data = (await res.json());
+        const content = data.choices[0]?.message?.content;
+        if (!content)
+            throw new Error(`Empty response from ${this.name}`);
+        return content;
+    }
+    async callStructured(schema, toolName, prompt) {
+        const strict = this.model.startsWith('gpt-4o') || /^o[1-9]/.test(this.model);
+        const body = {
+            model: this.model,
+            max_tokens: 1024,
+            messages: [{ role: 'user', content: prompt }],
+        };
+        if (strict) {
+            body.response_format = { type: 'json_schema', json_schema: { name: toolName, strict: true, schema } };
+        }
+        else {
+            body.response_format = { type: 'json_object' };
+            body.messages[0].content =
+                `${prompt}\n\nReturn ONLY JSON matching:\n${JSON.stringify(schema)}`;
+        }
+        const res = await fetch(`${this.baseURL}/chat/completions`, {
+            method: 'POST',
+            headers: this.headers(),
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw new Error(`${this.name} ${res.status}: ${(await res.text()).slice(0, 200)}`);
+        const data = (await res.json());
+        const choice = data.choices[0];
+        if (choice.finish_reason === 'length')
+            throw new Error('Response truncated by max_tokens');
+        if (choice.message.refusal)
+            throw new Error(`Model refused: ${choice.message.refusal}`);
+        return JSON.parse(choice.message.content);
+    }
+}
+// ─── Factory — model string → provider ────────────────────────────────────────
+export function createLLMProvider(model, keys) {
+    const lc = model.toLowerCase();
+    if (lc.startsWith('claude-') || lc.startsWith('anthropic/')) {
+        const m = lc.startsWith('anthropic/') ? model.slice('anthropic/'.length) : model;
+        return new AnthropicProvider(m, requireKey(keys, ['ANTHROPIC_API_KEY'], 'anthropic'));
+    }
+    if (lc.startsWith('openrouter/')) {
+        return new OpenAICompatProvider('openrouter', model.slice('openrouter/'.length), requireKey(keys, ['OPENROUTER_API_KEY'], 'openrouter'), 'https://openrouter.ai/api/v1');
+    }
+    if (lc.startsWith('groq/')) {
+        return new OpenAICompatProvider('groq', model.slice('groq/'.length), requireKey(keys, ['GROQ_API_KEY'], 'groq'), 'https://api.groq.com/openai/v1');
+    }
+    if (lc.startsWith('gemini/') || lc.startsWith('gemini-')) {
+        const m = lc.startsWith('gemini/') ? model.slice('gemini/'.length) : model;
+        return new OpenAICompatProvider('gemini', m, requireKey(keys, ['GEMINI_API_KEY', 'GOOGLE_API_KEY'], 'gemini'), 'https://generativelanguage.googleapis.com/v1beta/openai');
+    }
+    if (lc.startsWith('mistral/') || lc.startsWith('mistral-') || lc.startsWith('open-mistral')) {
+        const m = lc.startsWith('mistral/') ? model.slice('mistral/'.length) : model;
+        return new OpenAICompatProvider('mistral', m, requireKey(keys, ['MISTRAL_API_KEY'], 'mistral'), 'https://api.mistral.ai/v1');
+    }
+    if (lc.startsWith('ollama/') || lc.startsWith('ollama:')) {
+        const m = model.replace(/^ollama[/:]/i, '');
+        const base = keys.OLLAMA_BASE_URL ?? 'http://localhost:11434';
+        return new OpenAICompatProvider('ollama', m, 'ollama', `${base}/v1`);
+    }
+    if (lc.startsWith('gpt-') || /^o[1-9]/.test(lc)) {
+        return new OpenAICompatProvider('openai', model, requireKey(keys, ['OPENAI_API_KEY'], 'openai'));
+    }
+    return new OpenAICompatProvider('openai', model, requireKey(keys, ['OPENAI_API_KEY'], 'openai'));
+}
+//# sourceMappingURL=providers.js.map

package/dist/llm/providers.js.map

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

package/dist/loop.d.ts

@@ -0,0 +1,16 @@
+import { DemonManifest, DemonState, Watcher, LLMProvider, ActionProvider, Clock, Logger, KVStore } from './types.js';
+export interface LoopConfig {
+    manifest: DemonManifest;
+    watchers: Watcher[];
+    llm: LLMProvider;
+    actions: Map<string, ActionProvider>;
+    credentials: Map<string, Record<string, string>>;
+    logger: Logger;
+    clock: Clock;
+    storage: KVStore;
+    onState?: (updates: Partial<DemonState>) => void;
+    startCycle?: number;
+    maxCycles?: number;
+}
+export declare function runLoop(config: LoopConfig): Promise<void>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,UAAU,EACV,OAAO,EACP,WAAW,EACX,cAAc,EAMd,KAAK,EACL,MAAM,EACN,OAAO,EACR,MAAM,YAAY,CAAA;AAUnB,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,aAAa,CAAA;IACvB,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,GAAG,EAAE,WAAW,CAAA;IAChB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACpC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAChD,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,KAAK,CAAA;IAEZ,OAAO,EAAE,OAAO,CAAA;IAEhB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,IAAI,CAAA;IAEhD,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAkHD,wBAAsB,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAsD/D"}

package/dist/loop.js

@@ -0,0 +1,142 @@
+import { createMemoryManager } from './memory/manager.js';
+import { buildDemonPrompt, splitPrompt, parseLLMDecision } from './reasoning.js';
+import { parseInterval } from './util/time.js';
+function generateEntryId(now) {
+    return `${now}-${Math.floor(now % 1000).toString(36)}`;
+}
+function formatContext(ctx) {
+    return [
+        '=== WHAT I KNOW (accumulated over time) ===',
+        ctx.narrative || 'Nothing yet — this is early in my run.',
+        '',
+        '=== RECENT HISTORY ===',
+        ctx.recentEpisodes,
+        '',
+        '=== CURRENT ENTITY STATES ===',
+        ctx.relevantFacts,
+    ].join('\n');
+}
+async function collectObservations(watchers, logger, now) {
+    const results = await Promise.allSettled(watchers.map(w => w.collect()));
+    const observations = [];
+    for (let i = 0; i < results.length; i++) {
+        const r = results[i];
+        const w = watchers[i];
+        if (r.status === 'fulfilled') {
+            observations.push(...r.value);
+            logger.debug(`Watcher ${w.type} returned ${r.value.length} observation(s)`);
+        }
+        else {
+            const errMsg = r.reason?.message ?? String(r.reason);
+            logger.error(`Watcher ${w.type} failed`, { error: errMsg });
+            observations.push({ watcherType: w.type, data: { error: errMsg }, summary: `Watcher ${w.type} failed: ${errMsg}`, timestamp: now });
+        }
+    }
+    return observations;
+}
+async function callLLM(manifest, observations, contextSummary, cycleNum, llm, logger) {
+    const payload = observations.map(o => ({ watcherType: String(o.watcherType), summary: o.summary, data: o.data }));
+    const combined = buildDemonPrompt(manifest.purpose, contextSummary, payload);
+    const { systemPrompt, userContent } = splitPrompt(combined);
+    // List actions with provider/action as SEPARATE fields so the model fills the
+    // decision schema's action.provider and action.action correctly (not a single
+    // concatenated "provider.action" string).
+    const actionList = manifest.actions
+        .map(a => `- provider: "${a.provider}", action: "${a.action}"`)
+        .join('\n');
+    const user = `Demon: ${manifest.name}\nCycle: #${cycleNum}\nAction mode: ${manifest.action_mode}\n\nAvailable actions (when you act, set action.provider and action.action to one of these pairs exactly):\n${actionList}\n\n${userContent}`;
+    const raw = await llm.call([{ role: 'user', content: user }], systemPrompt);
+    logger.debug('Raw LLM response', { raw: raw.slice(0, 300) });
+    return parseLLMDecision(raw);
+}
+// Normalize an instruction's provider/action. Models sometimes return the
+// available action verbatim as "provider.action" (e.g. "log.info") in the
+// provider field. If the raw provider isn't registered but splits into a
+// known provider + action, recover it rather than failing the dispatch.
+function normalizeInstruction(instruction, actions) {
+    if (actions.has(instruction.provider))
+        return instruction;
+    const dot = instruction.provider.indexOf('.');
+    if (dot > 0) {
+        const provider = instruction.provider.slice(0, dot);
+        const action = instruction.provider.slice(dot + 1);
+        if (actions.has(provider)) {
+            return { provider, action: instruction.action || action, params: instruction.params };
+        }
+    }
+    return instruction;
+}
+async function executeInstruction(rawInstruction, actions, credentials, dryRun, logger, now) {
+    const instruction = normalizeInstruction(rawInstruction, actions);
+    // Dry-run short-circuits BEFORE requiring a registered provider — it only
+    // reports what *would* happen, so a missing provider must not error here.
+    if (dryRun) {
+        logger.info(`[DRY RUN] Would execute: ${instruction.provider}.${instruction.action}`, { params: instruction.params });
+        return { provider: instruction.provider, action: instruction.action, params: instruction.params, result: { dryRun: true }, dryRun: true, timestamp: now };
+    }
+    const provider = actions.get(instruction.provider);
+    if (!provider) {
+        const err = `No action provider registered for "${instruction.provider}". Available: ${[...actions.keys()].join(', ') || '(none)'}`;
+        logger.error(err);
+        return { provider: instruction.provider, action: instruction.action, params: instruction.params, error: err, dryRun, timestamp: now };
+    }
+    try {
+        const result = await provider.execute(instruction, credentials.get(instruction.provider) ?? {});
+        logger.info(`Action executed: ${instruction.provider}.${instruction.action}`, { result });
+        return { provider: instruction.provider, action: instruction.action, params: instruction.params, result, dryRun: false, timestamp: now };
+    }
+    catch (err) {
+        const errMsg = err.message;
+        logger.error(`Action failed: ${instruction.provider}.${instruction.action}`, { error: errMsg });
+        return { provider: instruction.provider, action: instruction.action, params: instruction.params, error: errMsg, dryRun: false, timestamp: now };
+    }
+}
+export async function runLoop(config) {
+    const { manifest, watchers, llm, actions, credentials, logger, clock, storage, onState } = config;
+    const intervalMs = parseInterval(manifest.interval);
+    const memory = await createMemoryManager(storage, manifest, llm);
+    let cycleNum = config.startCycle ?? 0;
+    logger.info('Observation loop started', { interval: manifest.interval, watcherCount: watchers.length, actionCount: manifest.actions.length, model: llm.model });
+    while (config.maxCycles === undefined || cycleNum < config.maxCycles) {
+        const cycleStart = clock.now();
+        cycleNum += 1;
+        const nowIso = new Date(cycleStart).toISOString();
+        logger.info(`Cycle #${cycleNum} starting`);
+        onState?.({ lastCheck: nowIso, status: 'running' });
+        const observations = await collectObservations(watchers, logger, nowIso);
+        logger.info(`Collected ${observations.length} observation(s)`, { cycleNum });
+        const contextSummary = formatContext(await memory.buildContext(observations));
+        let decision;
+        try {
+            decision = await callLLM(manifest, observations, contextSummary, cycleNum, llm, logger);
+            logger.info(`Decision: ${decision.decision}`, { reasoning: decision.reasoning });
+        }
+        catch (err) {
+            const errMsg = err.message;
+            logger.error('LLM call failed', { error: errMsg });
+            decision = { decision: 'wait', reasoning: `LLM error: ${errMsg}` };
+        }
+        let actionFired;
+        if (decision.decision === 'act' && decision.action) {
+            const dryRun = manifest.action_mode === 'dry_run';
+            actionFired = await executeInstruction(decision.action, actions, credentials, dryRun, logger, nowIso);
+            if (!actionFired.error && !actionFired.dryRun)
+                onState?.({ actionsCount: undefined });
+        }
+        else {
+            logger.debug(`Waiting: ${decision.reasoning}`);
+        }
+        const entry = { id: generateEntryId(cycleStart), timestamp: nowIso, cycleNumber: cycleNum, observations, decision, actionFired };
+        await memory.recordCycle(entry);
+        onState?.({ cycles: cycleNum, lastCheck: nowIso, status: 'running' });
+        const elapsed = clock.now() - cycleStart;
+        logger.info(`Cycle #${cycleNum} complete`, { durationMs: elapsed, decision: decision.decision, observations: observations.length });
+        if (config.maxCycles !== undefined && cycleNum >= config.maxCycles)
+            break;
+        const sleepMs = Math.max(0, intervalMs - elapsed);
+        if (sleepMs > 0)
+            await clock.sleep(sleepMs);
+    }
+    memory.close();
+}
+//# sourceMappingURL=loop.js.map

package/dist/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../src/loop.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,mBAAmB,EAAiB,MAAM,qBAAqB,CAAA;AACxE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAyB9C,SAAS,eAAe,CAAC,GAAW;IAClC,OAAO,GAAG,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAA;AACxD,CAAC;AAED,SAAS,aAAa,CAAC,GAAkB;IACvC,OAAO;QACL,6CAA6C;QAC7C,GAAG,CAAC,SAAS,IAAI,wCAAwC;QACzD,EAAE;QACF,wBAAwB;QACxB,GAAG,CAAC,cAAc;QAClB,EAAE;QACF,+BAA+B;QAC/B,GAAG,CAAC,aAAa;KAClB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,QAAmB,EAAE,MAAc,EAAE,GAAW;IACjF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;IACxE,MAAM,YAAY,GAAkB,EAAE,CAAA;IACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;QACpB,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;QACrB,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YAC7B,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAA;YAC7B,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,KAAK,CAAC,MAAM,iBAAiB,CAAC,CAAA;QAC7E,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAI,CAAC,CAAC,MAAgB,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;YAC/D,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;YAC3D,YAAY,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,IAAI,YAAY,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAA;QACrI,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAA;AACrB,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,QAAuB,EACvB,YAA2B,EAC3B,cAAsB,EACtB,QAAgB,EAChB,GAAgB,EAChB,MAAc;IAEd,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACjH,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,CAAA;IAC5E,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAA;IAC3D,8EAA8E;IAC9E,8EAA8E;IAC9E,0CAA0C;IAC1C,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO;SAChC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,QAAQ,eAAe,CAAC,CAAC,MAAM,GAAG,CAAC;SAC9D,IAAI,CAAC,IAAI,CAAC,CAAA;IACb,MAAM,IAAI,GAAG,UAAU,QAAQ,CAAC,IAAI,aAAa,QAAQ,kBAAkB,QAAQ,CAAC,WAAW,+GAA+G,UAAU,OAAO,WAAW,EAAE,CAAA;IAC5O,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,YAAY,CAAC,CAAA;IAC3E,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;IAC5D,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAA;AAC9B,CAAC;AAED,0EAA0E;AAC1E,0EAA0E;AAC1E,yEAAyE;AACzE,wEAAwE;AACxE,SAAS,oBAAoB,CAC3B,WAA8B,EAC9B,OAAoC;IAEpC,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC;QAAE,OAAO,WAAW,CAAA;IACzD,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC7C,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;QACnD,MAAM,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAA;QAClD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,IAAI,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAA;QACvF,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAA;AACpB,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,cAAiC,EACjC,OAAoC,EACpC,WAAgD,EAChD,MAAe,EACf,MAAc,EACd,GAAW;IAEX,MAAM,WAAW,GAAG,oBAAoB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IAEjE,0EAA0E;IAC1E,0EAA0E;IAC1E,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,CAAC,IAAI,CAAC,4BAA4B,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAA;QACrH,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,CAAA;IAC3J,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;IAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,sCAAsC,WAAW,CAAC,QAAQ,iBAAiB,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAA;QACnI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACjB,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAA;IACvI,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAA;QAC/F,MAAM,CAAC,IAAI,CAAC,oBAAoB,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;QACzF,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAA;IAC1I,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAI,GAAa,CAAC,OAAO,CAAA;QACrC,MAAM,CAAC,KAAK,CAAC,kBAAkB,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;QAC/F,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAA;IACjJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAkB;IAC9C,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;IACjG,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACnD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAA;IAChE,IAAI,QAAQ,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,CAAA;IAErC,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAA;IAE/J,OAAO,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,QAAQ,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QACrE,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,EAAE,CAAA;QAC9B,QAAQ,IAAI,CAAC,CAAA;QACb,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAA;QAEjD,MAAM,CAAC,IAAI,CAAC,UAAU,QAAQ,WAAW,CAAC,CAAA;QAC1C,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;QAEnD,MAAM,YAAY,GAAG,MAAM,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QACxE,MAAM,CAAC,IAAI,CAAC,aAAa,YAAY,CAAC,MAAM,iBAAiB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;QAE5E,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,MAAM,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAA;QAE7E,IAAI,QAAqB,CAAA;QACzB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;YACvF,MAAM,CAAC,IAAI,CAAC,aAAa,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAA;QAClF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAI,GAAa,CAAC,OAAO,CAAA;YACrC,MAAM,CAAC,KAAK,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAA;YAClD,QAAQ,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,MAAM,EAAE,EAAE,CAAA;QACpE,CAAC;QAED,IAAI,WAAoC,CAAA;QACxC,IAAI,QAAQ,CAAC,QAAQ,KAAK,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACnD,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAA;YACjD,WAAW,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;YACrG,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,MAAM;gBAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAA;QACvF,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,YAAY,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAA;QAChD,CAAC;QAED,MAAM,KAAK,GAAgB,EAAE,EAAE,EAAE,eAAe,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAA;QAC7I,MAAM,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QAE/B,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;QAErE,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,UAAU,CAAA;QACxC,MAAM,CAAC,IAAI,CAAC,UAAU,QAAQ,WAAW,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC,CAAA;QAEnI,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,QAAQ,IAAI,MAAM,CAAC,SAAS;YAAE,MAAK;QACzE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,CAAA;QACjD,IAAI,OAAO,GAAG,CAAC;YAAE,MAAM,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC7C,CAAC;IAED,MAAM,CAAC,KAAK,EAAE,CAAA;AAChB,CAAC"}

package/dist/memory/episodes.d.ts

@@ -0,0 +1,12 @@
+import { MemoryEntry, KVStore } from '../types.js';
+export interface EpisodeStore {
+    append(entry: MemoryEntry): Promise<void>;
+    getRecent(n?: number): Promise<MemoryEntry[]>;
+    buildContextSummary(n?: number): Promise<string>;
+    getDemonAge(): Promise<{
+        cycles: number;
+        startedAt: Date | null;
+    }>;
+}
+export declare function createEpisodeStore(kv: KVStore, key?: string): EpisodeStore;
+//# sourceMappingURL=episodes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"episodes.d.ts","sourceRoot":"","sources":["../../src/memory/episodes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAOlD,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IAC7C,mBAAmB,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAChD,WAAW,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC,CAAA;CACnE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,SAAoB,GAAG,YAAY,CAoDrF"}

package/dist/memory/episodes.js

@@ -0,0 +1,50 @@
+export function createEpisodeStore(kv, key = 'decisions.jsonl') {
+    function parseLines(lines) {
+        return lines.reduce((acc, line) => {
+            try {
+                acc.push(JSON.parse(line));
+            }
+            catch {
+                // skip corrupt
+            }
+            return acc;
+        }, []);
+    }
+    async function append(entry) {
+        await kv.append(key, JSON.stringify(entry));
+    }
+    async function getRecent(n = 10) {
+        return parseLines(await kv.readLines(key, n));
+    }
+    async function buildContextSummary(n = 10) {
+        const entries = await getRecent(n);
+        if (entries.length === 0) {
+            return 'No prior decisions recorded. This is the first cycle.';
+        }
+        const lines = entries.map(e => {
+            const decision = e.decision.decision.toUpperCase();
+            const reasoning = e.decision.reasoning.slice(0, 200);
+            const obsCount = e.observations.length;
+            const actionInfo = e.actionFired
+                ? ` | Action: ${e.actionFired.provider}.${e.actionFired.action}${e.actionFired.dryRun ? ' (dry-run)' : ''}${e.actionFired.error ? ` [FAILED: ${e.actionFired.error.slice(0, 80)}]` : ''}`
+                : '';
+            return `  Cycle #${e.cycleNumber} [${e.timestamp}] → ${decision}: ${reasoning}${actionInfo} (${obsCount} observation${obsCount !== 1 ? 's' : ''})`;
+        });
+        return `Recent decision history (last ${entries.length} cycle${entries.length !== 1 ? 's' : ''}):\n${lines.join('\n')}`;
+    }
+    async function getDemonAge() {
+        const lines = await kv.readLines(key);
+        if (lines.length === 0)
+            return { cycles: 0, startedAt: null };
+        let startedAt = null;
+        try {
+            startedAt = new Date(JSON.parse(lines[0]).timestamp);
+        }
+        catch {
+            // corrupt first entry
+        }
+        return { cycles: lines.length, startedAt };
+    }
+    return { append, getRecent, buildContextSummary, getDemonAge };
+}
+//# sourceMappingURL=episodes.js.map

package/dist/memory/episodes.js.map

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

package/dist/memory/facts.d.ts

@@ -0,0 +1,3 @@
+import { FactsStore, KVStore } from '../types.js';
+export declare function createFactsStore(kv: KVStore, key?: string): Promise<FactsStore>;
+//# sourceMappingURL=facts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"facts.d.ts","sourceRoot":"","sources":["../../src/memory/facts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAqBvD,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,OAAO,EACX,GAAG,SAAe,GACjB,OAAO,CAAC,UAAU,CAAC,CA6FrB"}