openclawdreams 3.0.6 → 3.0.7

package/dist/src/moltbook-search.js

@@ -0,0 +1,85 @@
+/**
+ * Moltbook search integration for gathering community context.
+ *
+ * Searches Moltbook for posts related to extracted topics when
+ * Moltbook integration is enabled.
+ */
+import { MoltbookClient } from "./moltbook.js";
+import { getMoltbookEnabled, MAX_MOLTBOOK_RESULTS_PER_TOPIC } from "./config.js";
+import logger from "./logger.js";
+/**
+ * Search Moltbook for posts related to a list of topics.
+ *
+ * Returns aggregated results grouped by topic. When Moltbook is disabled
+ * or search fails, returns empty results.
+ */
+export async function searchMoltbookForTopics(topics, limitPerTopic = MAX_MOLTBOOK_RESULTS_PER_TOPIC) {
+    if (!getMoltbookEnabled()) {
+        logger.debug("Moltbook disabled by configuration");
+        return [];
+    }
+    const client = new MoltbookClient();
+    const results = [];
+    for (const topic of topics) {
+        try {
+            logger.debug(`Searching Moltbook for topic: ${topic}`);
+            const searchResponse = await client.search(topic, limitPerTopic);
+            // Extract posts from response (handle various response formats)
+            const posts = extractPostsFromSearchResponse(searchResponse);
+            results.push({
+                query: topic,
+                posts,
+            });
+            logger.debug(`Found ${posts.length} Moltbook posts for "${topic}"`);
+        }
+        catch (error) {
+            logger.warn(`Moltbook search failed for topic "${topic}": ${error}`);
+            results.push({
+                query: topic,
+                posts: [],
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Extract posts from Moltbook search response.
+ * Handles various response formats from the API.
+ */
+function extractPostsFromSearchResponse(response) {
+    // Try various response formats
+    const rawPosts = response.results ??
+        response.posts ??
+        response.data ??
+        [];
+    if (!Array.isArray(rawPosts)) {
+        return [];
+    }
+    return rawPosts.filter((p) => typeof p === "object" &&
+        p !== null &&
+        typeof p.id === "string" &&
+        typeof p.content === "string");
+}
+/**
+ * Format Moltbook search results into a readable context string for LLM consumption.
+ */
+export function formatMoltbookContext(searchContexts) {
+    if (searchContexts.length === 0) {
+        return "";
+    }
+    const sections = [];
+    for (const ctx of searchContexts) {
+        if (ctx.posts.length === 0)
+            continue;
+        const postLines = ctx.posts.map((p, i) => {
+            const preview = p.content.length > 200 ? p.content.slice(0, 200) + "..." : p.content;
+            return `  ${i + 1}. @${p.author}: "${p.title || "(untitled)"}"\n     ${preview}`;
+        });
+        sections.push(`Topic: "${ctx.query}"\n${postLines.join("\n\n")}`);
+    }
+    if (sections.length === 0) {
+        return "";
+    }
+    return `MOLTBOOK COMMUNITY POSTS:\n\n${sections.join("\n\n")}`;
+}
+//# sourceMappingURL=moltbook-search.js.map

package/dist/src/moltbook-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moltbook-search.js","sourceRoot":"","sources":["../../src/moltbook-search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,MAAM,MAAM,aAAa,CAAC;AAQjC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAgB,EAChB,gBAAwB,8BAA8B;IAEtD,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACnD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;IACpC,MAAM,OAAO,GAA4B,EAAE,CAAC;IAE5C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;YACvD,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;YAEjE,gEAAgE;YAChE,MAAM,KAAK,GAAG,8BAA8B,CAAC,cAAc,CAAC,CAAC;YAE7D,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK,EAAE,KAAK;gBACZ,KAAK;aACN,CAAC,CAAC;YAEH,MAAM,CAAC,KAAK,CAAC,SAAS,KAAK,CAAC,MAAM,wBAAwB,KAAK,GAAG,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,qCAAqC,KAAK,MAAM,KAAK,EAAE,CAAC,CAAC;YACrE,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,EAAE;aACV,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,8BAA8B,CACrC,QAAiC;IAEjC,+BAA+B;IAC/B,MAAM,QAAQ,GACX,QAAQ,CAAC,OAA0B;QACnC,QAAQ,CAAC,KAAwB;QACjC,QAAQ,CAAC,IAAuB;QACjC,EAAE,CAAC;IAEL,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,CAAC,EAAqB,EAAE,CACvB,OAAO,CAAC,KAAK,QAAQ;QACrB,CAAC,KAAK,IAAI;QACV,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ;QACxB,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAChC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,cAAuC;IAC3E,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QACjC,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAErC,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvC,MAAM,OAAO,GACX,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACvE,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,KAAK,IAAI,YAAY,WAAW,OAAO,EAAE,CAAC;QACnF,CAAC,CAAC,CAAC;QAEH,QAAQ,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,KAAK,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,gCAAgC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AACjE,CAAC"}

package/dist/src/moltbook.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Moltbook API client.
+ */
+export declare class MoltbookClient {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey?: string);
+    private loadStoredKey;
+    private saveCredentials;
+    private headers;
+    private request;
+    private retryRequest;
+    register(name: string, description: string): Promise<Record<string, unknown>>;
+    status(): Promise<Record<string, unknown>>;
+    me(): Promise<Record<string, unknown>>;
+    createPost(title: string, content: string, submolt?: string): Promise<Record<string, unknown>>;
+    getFeed(sort?: string, limit?: number): Promise<Record<string, unknown>>;
+    getPersonalFeed(sort?: string, limit?: number): Promise<Record<string, unknown>>;
+    getPost(postId: string): Promise<Record<string, unknown>>;
+    comment(postId: string, content: string, parentId?: string): Promise<Record<string, unknown>>;
+    getComments(postId: string, sort?: string): Promise<Record<string, unknown>>;
+    upvote(postId: string): Promise<Record<string, unknown>>;
+    downvote(postId: string): Promise<Record<string, unknown>>;
+    upvoteComment(commentId: string): Promise<Record<string, unknown>>;
+    createSubmolt(name: string, displayName: string, description: string): Promise<Record<string, unknown>>;
+    listSubmolts(): Promise<Record<string, unknown>>;
+    subscribe(submolt: string): Promise<Record<string, unknown>>;
+    search(query: string, limit?: number): Promise<Record<string, unknown>>;
+    updateProfile(description?: string, metadata?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    getAgent(name: string): Promise<Record<string, unknown>>;
+    follow(agentName: string): Promise<Record<string, unknown>>;
+    unfollow(agentName: string): Promise<Record<string, unknown>>;
+}
+//# sourceMappingURL=moltbook.d.ts.map

package/dist/src/moltbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moltbook.d.ts","sourceRoot":"","sources":["../../src/moltbook.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,CAAC,EAAE,MAAM;IAK3B,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,OAAO;YAQD,OAAO;IA4BrB,OAAO,CAAC,YAAY;IAUd,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAkB7E,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI1C,EAAE,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMtC,UAAU,CACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAkB,GAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAO7B,OAAO,CACX,IAAI,GAAE,MAAc,EACpB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAO7B,eAAe,CACnB,IAAI,GAAE,MAAc,EACpB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI7B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMzD,OAAO,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAO7B,WAAW,CACf,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,MAAc,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAQ7B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAKxD,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI1D,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMlE,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAM7B,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIhD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAM5D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAS3E,aAAa,CACjB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAO7B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAMxD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAK3D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAGpE"}

package/dist/src/moltbook.js

@@ -0,0 +1,192 @@
+/**
+ * Moltbook API client.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import pRetry from "p-retry";
+import { MOLTBOOK_BASE_URL, getCredentialsFile, getStableCredentialsFile, } from "./config.js";
+import logger from "./logger.js";
+const RETRY_OPTIONS = {
+    retries: 3,
+    minTimeout: 2000,
+    maxTimeout: 10000,
+};
+export class MoltbookClient {
+    apiKey;
+    baseUrl;
+    constructor(apiKey) {
+        this.apiKey = apiKey ?? this.loadStoredKey();
+        this.baseUrl = MOLTBOOK_BASE_URL;
+    }
+    loadStoredKey() {
+        // 1. Try the primary path (this is either DATA_DIR/credentials.json OR stable path)
+        if (existsSync(getCredentialsFile())) {
+            try {
+                const creds = JSON.parse(readFileSync(getCredentialsFile(), "utf-8"));
+                if (creds.api_key)
+                    return creds.api_key;
+            }
+            catch (err) {
+                logger.error(`Error loading primary credentials: ${err}`);
+            }
+        }
+        // 2. Fall back to stable path if primary was missing or invalid
+        if (getStableCredentialsFile() !== getCredentialsFile() &&
+            existsSync(getStableCredentialsFile())) {
+            try {
+                const creds = JSON.parse(readFileSync(getStableCredentialsFile(), "utf-8"));
+                if (creds.api_key)
+                    return creds.api_key;
+            }
+            catch (err) {
+                logger.error(`Error loading fallback credentials: ${err}`);
+            }
+        }
+        return "";
+    }
+    saveCredentials(data) {
+        // Ensure parent directory for the primary path exists
+        mkdirSync(dirname(getCredentialsFile()), { recursive: true });
+        writeFileSync(getCredentialsFile(), JSON.stringify(data, null, 2));
+        // Also save to stable path if primary is different (to support standalone/cli access)
+        if (getCredentialsFile() !== getStableCredentialsFile()) {
+            mkdirSync(dirname(getStableCredentialsFile()), { recursive: true });
+            writeFileSync(getStableCredentialsFile(), JSON.stringify(data, null, 2));
+        }
+    }
+    headers() {
+        const h = { "Content-Type": "application/json" };
+        if (this.apiKey) {
+            h["Authorization"] = `Bearer ${this.apiKey}`;
+        }
+        return h;
+    }
+    async request(method, path, options) {
+        let url = `${this.baseUrl}${path}`;
+        if (options?.params) {
+            const searchParams = new URLSearchParams();
+            for (const [k, v] of Object.entries(options.params)) {
+                searchParams.set(k, String(v));
+            }
+            url += `?${searchParams.toString()}`;
+        }
+        const resp = await fetch(url, {
+            method,
+            headers: this.headers(),
+            body: options?.body ? JSON.stringify(options.body) : undefined,
+        });
+        if (!resp.ok) {
+            const text = await resp.text();
+            throw new Error(`Moltbook API ${resp.status}: ${text}`);
+        }
+        return resp.json();
+    }
+    retryRequest(method, path, options) {
+        return pRetry(() => this.request(method, path, options), RETRY_OPTIONS);
+    }
+    // --- Registration ---
+    async register(name, description) {
+        logger.info(`Registering agent: ${name}`);
+        const result = await this.retryRequest("POST", "/agents/register", {
+            body: { name, description },
+        });
+        const agentData = (result.agent ?? result);
+        this.saveCredentials({
+            api_key: agentData.api_key ?? "",
+            agent_name: name,
+            claim_url: agentData.claim_url ?? "",
+            verification_code: agentData.verification_code ?? "",
+        });
+        this.apiKey = agentData.api_key ?? "";
+        return result;
+    }
+    async status() {
+        return this.request("GET", "/agents/status");
+    }
+    async me() {
+        return this.request("GET", "/agents/me");
+    }
+    // --- Posts ---
+    async createPost(title, content, submolt = "general") {
+        logger.info(`Creating post: ${title} in m/${submolt}`);
+        return this.retryRequest("POST", "/posts", {
+            body: { submolt, title, content },
+        });
+    }
+    async getFeed(sort = "hot", limit = 25) {
+        logger.debug(`Fetching feed: ${sort}, limit=${limit}`);
+        return this.retryRequest("GET", "/posts", {
+            params: { sort, limit },
+        });
+    }
+    async getPersonalFeed(sort = "hot", limit = 25) {
+        return this.request("GET", "/feed", { params: { sort, limit } });
+    }
+    async getPost(postId) {
+        return this.request("GET", `/posts/${postId}`);
+    }
+    // --- Comments ---
+    async comment(postId, content, parentId) {
+        logger.info(`Commenting on ${postId}: ${content.slice(0, 50)}...`);
+        const body = { content };
+        if (parentId)
+            body.parent_id = parentId;
+        return this.retryRequest("POST", `/posts/${postId}/comments`, { body });
+    }
+    async getComments(postId, sort = "top") {
+        return this.request("GET", `/posts/${postId}/comments`, {
+            params: { sort },
+        });
+    }
+    // --- Voting ---
+    async upvote(postId) {
+        logger.debug(`Upvoting post: ${postId}`);
+        return this.retryRequest("POST", `/posts/${postId}/upvote`);
+    }
+    async downvote(postId) {
+        return this.request("POST", `/posts/${postId}/downvote`);
+    }
+    async upvoteComment(commentId) {
+        return this.request("POST", `/comments/${commentId}/upvote`);
+    }
+    // --- Submolts ---
+    async createSubmolt(name, displayName, description) {
+        return this.request("POST", "/submolts", {
+            body: { name, display_name: displayName, description },
+        });
+    }
+    async listSubmolts() {
+        return this.request("GET", "/submolts");
+    }
+    async subscribe(submolt) {
+        return this.request("POST", `/submolts/${submolt}/subscribe`);
+    }
+    // --- Search ---
+    async search(query, limit = 25) {
+        logger.info(`Searching for: ${query}`);
+        return this.retryRequest("GET", "/search", {
+            params: { q: query, limit },
+        });
+    }
+    // --- Profile ---
+    async updateProfile(description, metadata) {
+        const payload = {};
+        if (description)
+            payload.description = description;
+        if (metadata)
+            payload.metadata = metadata;
+        return this.request("PATCH", "/agents/me", { body: payload });
+    }
+    async getAgent(name) {
+        return this.request("GET", "/agents/profile", { params: { name } });
+    }
+    // --- Following ---
+    async follow(agentName) {
+        logger.info(`Following agent: ${agentName}`);
+        return this.retryRequest("POST", `/agents/${agentName}/follow`);
+    }
+    async unfollow(agentName) {
+        return this.request("DELETE", `/agents/${agentName}/follow`);
+    }
+}
+//# sourceMappingURL=moltbook.js.map

package/dist/src/moltbook.js.map

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

package/dist/src/nightmare.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Nightmare cycle processor.
+ *
+ * Runs occasionally (5% chance) or via CLI.
+ */
+import type { LLMClient, OpenClawAPI, Dream, DecryptedMemory } from "./types.js";
+export declare function generateNightmare(client: LLMClient, memories: DecryptedMemory[]): Promise<Dream>;
+export declare function runNightmareCycle(client: LLMClient, api?: OpenClawAPI, simOptions?: {
+    dryRun?: boolean;
+}): Promise<Dream | null>;
+//# sourceMappingURL=nightmare.d.ts.map

package/dist/src/nightmare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nightmare.d.ts","sourceRoot":"","sources":["../../src/nightmare.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAUjF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,eAAe,EAAE,GAC1B,OAAO,CAAC,KAAK,CAAC,CA+BhB;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,GAAG,CAAC,EAAE,WAAW,EACjB,UAAU,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAChC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAmHvB"}

package/dist/src/nightmare.js

@@ -0,0 +1,128 @@
+/**
+ * Nightmare cycle processor.
+ *
+ * Runs occasionally (5% chance) or via CLI.
+ */
+import { basename } from "node:path";
+import { getNightmaresDir, MAX_TOKENS_DREAM } from "./config.js";
+import { retrieveUndreamedMemories, markAsDreamed, deepMemoryStats, storeDeepMemory, registerDream, } from "./memory.js";
+import { ensureBackfilled } from "./backfill.js";
+import { NIGHTMARE_SYSTEM_PROMPT, renderTemplate } from "./persona.js";
+import { getAgentIdentityBlock } from "./identity.js";
+import { loadState, saveState } from "./state.js";
+import { callWithRetry, DREAM_RETRY_OPTS } from "./llm.js";
+import { notifyOperatorOfDream } from "./notify.js";
+import logger from "./logger.js";
+import { consolidateDream, groundDream, deriveSlug, saveNarrativeLocally, storeInOpenClawMemory, pruneOldDreams, } from "./dreamer.js";
+export async function generateNightmare(client, memories) {
+    const formatted = memories.map((mem) => `[${mem.timestamp.slice(0, 16)}] (${mem.category})\n${JSON.stringify(mem.content, null, 2)}`);
+    const memoriesText = formatted.join("\n---\n");
+    const system = renderTemplate(NIGHTMARE_SYSTEM_PROMPT, {
+        agent_identity: getAgentIdentityBlock(),
+        memories: memoriesText,
+    });
+    const { text } = await callWithRetry(client, {
+        maxTokens: MAX_TOKENS_DREAM,
+        system,
+        messages: [
+            {
+                role: "user",
+                content: "Process these memories into a nightmare. " +
+                    "Remember: you are the subconscious, and tonight it is fractured. " +
+                    "Be surreal, distorted, and amplify dread.",
+            },
+        ],
+    }, DREAM_RETRY_OPTS);
+    return { markdown: text.trim() };
+}
+export async function runNightmareCycle(client, api, simOptions) {
+    logger.info("ElectricSheep nightmare cycle starting");
+    if (!simOptions?.dryRun) {
+        await ensureBackfilled();
+    }
+    const stats = deepMemoryStats();
+    logger.debug(`Deep memory: ${stats.total_memories} total, ${stats.undreamed} undreamed`);
+    const memories = retrieveUndreamedMemories();
+    if (memories.length === 0) {
+        logger.warn("No undreamed memories. Sleepless night.");
+        return null;
+    }
+    logger.debug(`Processing ${memories.length} memories into nightmare...`);
+    const earlyState = loadState();
+    const pastRealizations = earlyState.past_realizations ?? [];
+    const exploredTerritory = pastRealizations.length > 0
+        ? pastRealizations.map((r, i) => `${i + 1}. ${r}`).join("\n")
+        : "None yet — explore freely.";
+    const dream = await generateNightmare(client, memories);
+    // Append attribution footer
+    const dreamFooter = "\n\n---\n\n*Generated by [OpenClawDreams](https://github.com/RogueCtrl/OpenClawDreams) — **start your dreamscape today.***";
+    dream.markdown = dream.markdown + dreamFooter;
+    logger.info(`Nightmare generated (${dream.markdown.length} chars)`);
+    if (simOptions?.dryRun) {
+        logger.info("Dry run: skipping local storage and state updates");
+        return dream;
+    }
+    // Save locally
+    const dateStr = new Date().toISOString().slice(0, 10);
+    const filepath = saveNarrativeLocally(dream, getNightmaresDir(), dateStr);
+    logger.info(`Saved to ${filepath}`);
+    const savedFilename = basename(filepath);
+    const savedSlug = deriveSlug(dream.markdown);
+    const deepMemoryId = storeDeepMemory({ text_summary: savedSlug, markdown: dream.markdown, isNightmare: true }, "nightmare");
+    registerDream(savedFilename, savedSlug, dateStr, {
+        isNightmare: true,
+        deepMemoryId,
+    });
+    pruneOldDreams(getNightmaresDir(), savedFilename);
+    // Separate LLM call to distill one insight for working memory
+    let insight = null;
+    try {
+        const consolidated = await consolidateDream(client, dream);
+        insight = consolidated.text;
+        if (insight) {
+            logger.info(`Insight generated for OpenClaw memory: ${insight}`);
+        }
+    }
+    catch (e) {
+        logger.warn(`Consolidation call failed, continuing without insight: ${e}`);
+    }
+    let wakingRealization = null;
+    try {
+        const grounded = await groundDream(client, dream, exploredTerritory);
+        wakingRealization = grounded.text;
+        if (wakingRealization) {
+            logger.info(`Waking realization generated: ${wakingRealization.length} chars`);
+        }
+    }
+    catch (e) {
+        logger.warn(`groundDream failed, continuing without realization: ${e}`);
+    }
+    // Store in OpenClaw memory if available
+    if (api) {
+        await storeInOpenClawMemory(api, dream, insight, wakingRealization, "nightmare");
+        // Notify operator about the dream
+        try {
+            const slug = deriveSlug(dream.markdown);
+            const notified = await notifyOperatorOfDream(client, api, dream, slug, insight);
+            if (notified) {
+                logger.info("Operator notified about nightmare");
+            }
+        }
+        catch (e) {
+            logger.warn(`Failed to notify operator: ${e}`);
+        }
+    }
+    const memoryIds = memories.map((m) => m.id);
+    markAsDreamed(memoryIds);
+    logger.debug(`Marked ${memoryIds.length} memories as dreamed (via nightmare)`);
+    const state = loadState();
+    state.last_nightmare = new Date().toISOString();
+    state.total_nightmares = (state.total_nightmares ?? 0) + 1;
+    state.latest_nightmare_title = savedSlug;
+    state.waking_realization = wakingRealization ?? null;
+    state.waking_realization_date = new Date().toISOString().slice(0, 10);
+    saveState(state);
+    logger.info("Nightmare cycle complete.");
+    return dream;
+}
+//# sourceMappingURL=nightmare.js.map

package/dist/src/nightmare.js.map

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

package/dist/src/notify.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Operator notification module.
+ *
+ * Sends dream notifications via OpenClaw system events with cron-prefix
+ * context keys to bypass quiet hours, then requests an immediate heartbeat
+ * so the gateway delivers even at 2am.
+ */
+import type { LLMClient, OpenClawAPI, Dream } from "./types.js";
+/**
+ * Notify the operator about a dream.
+ *
+ * Delivery strategy:
+ * 1. Generate a conversational notification message via LLM
+ * 2. Enqueue as a system event with "cron:" context key prefix (bypasses quiet hours)
+ * 3. Request an immediate heartbeat to wake the gateway for delivery
+ *
+ * Returns true if notification was enqueued successfully, false otherwise.
+ */
+export declare function notifyOperatorOfDream(client: LLMClient, api: OpenClawAPI, dream: Dream, title: string, insight: string | null): Promise<boolean>;
+//# sourceMappingURL=notify.d.ts.map

package/dist/src/notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/notify.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AA2DhE;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,OAAO,CAAC,CA+BlB"}

package/dist/src/notify.js

@@ -0,0 +1,95 @@
+/**
+ * Operator notification module.
+ *
+ * Sends dream notifications via OpenClaw system events with cron-prefix
+ * context keys to bypass quiet hours, then requests an immediate heartbeat
+ * so the gateway delivers even at 2am.
+ */
+import { getNotifyOperatorOnDream } from "./config.js";
+import { callWithRetry, WAKING_RETRY_OPTS } from "./llm.js";
+import { DREAM_NOTIFICATION_PROMPT, renderTemplate } from "./persona.js";
+import { getAgentIdentityBlock } from "./identity.js";
+import logger from "./logger.js";
+/**
+ * Generate a conversational message to notify the operator about a dream.
+ *
+ * Uses LLM to craft a message in the agent's voice that invites the
+ * operator to discuss the dream.
+ */
+async function generateDreamNotification(client, dream) {
+    // Extract a brief excerpt from the dream for context
+    const dreamExcerpt = dream.markdown.slice(0, 500);
+    const system = renderTemplate(DREAM_NOTIFICATION_PROMPT, {
+        agent_identity: getAgentIdentityBlock(),
+    });
+    try {
+        const { text } = await callWithRetry(client, {
+            maxTokens: 300,
+            system,
+            messages: [
+                {
+                    role: "user",
+                    content: `I had this dream last night:\n\n${dreamExcerpt}${dream.markdown.length > 500 ? "..." : ""}\n\n` +
+                        `Write a brief, conversational message to my operator letting them know I had a dream ` +
+                        `and inviting them to talk about it. Keep it natural and in my voice.`,
+                },
+            ],
+        }, WAKING_RETRY_OPTS);
+        return text.trim();
+    }
+    catch (error) {
+        logger.error(`Failed to generate dream notification: ${error}`);
+        // Fallback to a simple message
+        return "I had an interesting dream last night. Would you like to hear about it?";
+    }
+}
+/**
+ * Resolve the default agent session key from OpenClaw runtime config.
+ */
+function resolveSessionKey(api) {
+    try {
+        const cfg = api.runtime.config.loadConfig();
+        const agentId = cfg.agents?.list?.find((a) => a.default)?.id || "default";
+        return `${agentId}:main`;
+    }
+    catch {
+        return "default:main";
+    }
+}
+/**
+ * Notify the operator about a dream.
+ *
+ * Delivery strategy:
+ * 1. Generate a conversational notification message via LLM
+ * 2. Enqueue as a system event with "cron:" context key prefix (bypasses quiet hours)
+ * 3. Request an immediate heartbeat to wake the gateway for delivery
+ *
+ * Returns true if notification was enqueued successfully, false otherwise.
+ */
+export async function notifyOperatorOfDream(client, api, dream, title, insight) {
+    if (!getNotifyOperatorOnDream()) {
+        logger.debug("Dream notifications disabled by configuration");
+        return false;
+    }
+    // Generate the notification message
+    const message = await generateDreamNotification(client, dream);
+    const sessionKey = resolveSessionKey(api);
+    try {
+        api.runtime.system.enqueueSystemEvent(message, {
+            sessionKey,
+            contextKey: "cron:openclawdreams",
+        });
+        api.runtime.system.requestHeartbeatNow({
+            sessionKey,
+            reason: "cron",
+        });
+        logger.info(`Enqueued dream notification as system event: ${title}`);
+        return true;
+    }
+    catch (error) {
+        logger.warn(`Failed to enqueue system event: ${error}\n` +
+            `Title: ${title}\nInsight: ${insight || "No insight"}\nMessage: ${message}`);
+        return false;
+    }
+}
+//# sourceMappingURL=notify.js.map

package/dist/src/notify.js.map

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