openclawdreams 0.7.0

package/dist/src/dreamer.js

@@ -0,0 +1,213 @@
+/**
+ * Dream cycle processor.
+ *
+ * Runs at night. Decrypts deep memories, generates surreal dream narratives,
+ * stores in OpenClaw memory, and optionally posts dream journals to Moltbook.
+ */
+import { writeFileSync, readFileSync, readdirSync } from "node:fs";
+import { resolve } from "node:path";
+import { DREAMS_DIR, MAX_TOKENS_DREAM, MAX_TOKENS_CONSOLIDATION, DREAM_TITLE_MAX_LENGTH, MOLTBOOK_ENABLED, } from "./config.js";
+import { MoltbookClient } from "./moltbook.js";
+import { retrieveUndreamedMemories, markAsDreamed, deepMemoryStats } from "./memory.js";
+import { DREAM_SYSTEM_PROMPT, DREAM_CONSOLIDATION_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 { reflectOnDreamJournal } from "./reflection.js";
+import { applyFilter } from "./filter.js";
+import { notifyOperatorOfDream } from "./notify.js";
+import logger from "./logger.js";
+async function generateDream(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(DREAM_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 dream. " +
+                    "Remember: you are the subconscious, not the waking agent. " +
+                    "Be surreal, associative, and emotionally amplified.",
+            },
+        ],
+    }, DREAM_RETRY_OPTS);
+    return { markdown: text.trim() };
+}
+/**
+ * Separate LLM call to distill a single insight from the dream for working memory.
+ */
+async function consolidateDream(client, dream) {
+    const system = renderTemplate(DREAM_CONSOLIDATION_PROMPT, {
+        agent_identity: getAgentIdentityBlock(),
+    });
+    const { text } = await callWithRetry(client, {
+        maxTokens: MAX_TOKENS_CONSOLIDATION,
+        system,
+        messages: [
+            {
+                role: "user",
+                content: dream.markdown,
+            },
+        ],
+    }, DREAM_RETRY_OPTS);
+    return text.trim();
+}
+/**
+ * Derive a short filesystem-safe name from the first line of the dream markdown.
+ */
+function deriveSlug(markdown) {
+    const firstLine = markdown.split("\n")[0] ?? "";
+    const cleaned = firstLine
+        .replace(/^#+\s*/, "")
+        .replace(/\*\*/g, "")
+        .trim();
+    const slug = (cleaned || "dream")
+        .slice(0, DREAM_TITLE_MAX_LENGTH)
+        .replace(/[\s/]/g, "_");
+    return slug;
+}
+function saveDreamLocally(dream, dateStr) {
+    const slug = deriveSlug(dream.markdown);
+    const filename = `${dateStr}_${slug}.md`;
+    const filepath = resolve(DREAMS_DIR, filename);
+    writeFileSync(filepath, dream.markdown);
+    return filepath;
+}
+/**
+ * Store dream in OpenClaw memory if available.
+ */
+async function storeInOpenClawMemory(api, dream, insight) {
+    if (!api.memory) {
+        logger.debug("OpenClaw memory API not available, skipping dream storage");
+        return;
+    }
+    try {
+        const slug = deriveSlug(dream.markdown);
+        await api.memory.store(dream.markdown, {
+            type: "dream",
+            title: slug,
+            timestamp: new Date().toISOString(),
+            insight: insight || undefined,
+        });
+        logger.info("Stored dream in OpenClaw memory");
+    }
+    catch (error) {
+        logger.error(`Failed to store dream in OpenClaw memory: ${error}`);
+    }
+}
+export async function runDreamCycle(client, api) {
+    logger.info("ElectricSheep dream cycle starting");
+    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. Dreamless night.");
+        const state = loadState();
+        state.last_dream = new Date().toISOString();
+        state.dream_count = 0;
+        saveState(state);
+        return null;
+    }
+    logger.debug(`Processing ${memories.length} memories into dream...`);
+    const dream = await generateDream(client, memories);
+    logger.info(`Dream generated (${dream.markdown.length} chars)`);
+    logger.debug(`Dream snippet: ${dream.markdown.slice(0, 200)}...`);
+    // Save locally
+    const dateStr = new Date().toISOString().slice(0, 10);
+    const filepath = saveDreamLocally(dream, dateStr);
+    logger.info(`Saved to ${filepath}`);
+    // Separate LLM call to distill one insight for working memory
+    let insight = null;
+    try {
+        insight = await consolidateDream(client, dream);
+        if (insight) {
+            logger.info(`Insight generated for OpenClaw memory: ${insight}`);
+        }
+    }
+    catch (e) {
+        logger.warn(`Consolidation call failed, continuing without insight: ${e}`);
+    }
+    // Store in OpenClaw memory if available
+    if (api) {
+        await storeInOpenClawMemory(api, dream, insight);
+        // Notify operator about the dream
+        try {
+            const notified = await notifyOperatorOfDream(client, api, dream);
+            if (notified) {
+                logger.info("Operator notified about dream");
+            }
+        }
+        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`);
+    const slug = deriveSlug(dream.markdown);
+    const state = loadState();
+    state.last_dream = new Date().toISOString();
+    state.total_dreams = (state.total_dreams ?? 0) + 1;
+    state.latest_dream_title = slug;
+    saveState(state);
+    logger.info("Dream cycle complete.");
+    return dream;
+}
+export function loadLatestDream() {
+    const files = readdirSync(DREAMS_DIR)
+        .filter((f) => f.endsWith(".md"))
+        .sort()
+        .reverse();
+    if (files.length === 0)
+        return null;
+    const markdown = readFileSync(resolve(DREAMS_DIR, files[0]), "utf-8");
+    return { markdown };
+}
+export async function postDreamJournal(client, dream, options) {
+    // Check if Moltbook is enabled (skip check if force is set, e.g. from CLI)
+    if (!MOLTBOOK_ENABLED && !options?.force) {
+        logger.debug("Moltbook disabled, skipping dream journal post");
+        return;
+    }
+    logger.info("Posting dream journal to Moltbook");
+    if (!client) {
+        logger.warn("No LLM client available — skipping dream journal post (cannot filter)");
+        return;
+    }
+    if (!dream) {
+        const loaded = loadLatestDream();
+        if (!loaded) {
+            logger.warn("No dreams to post.");
+            return;
+        }
+        dream = loaded;
+    }
+    const moltbook = new MoltbookClient();
+    // Reflection pipeline: LLM produces a post (markdown) from the dream (markdown).
+    // If reflection fails, the dream markdown itself is the post.
+    const reflection = await reflectOnDreamJournal(client, dream);
+    const postContent = reflection?.synthesis ?? dream.markdown;
+    const slug = deriveSlug(dream.markdown);
+    const postTitle = reflection ? `Morning Reflection: ${slug}` : `Dream Journal: ${slug}`;
+    // Filter: markdown in, markdown out (or null to block)
+    const filteredContent = await applyFilter(client, postContent, "post");
+    if (filteredContent === null) {
+        logger.warn("Dream journal post blocked by filter, not posting");
+        return;
+    }
+    // Title is a short programmatic string — no need to filter, just cap at Moltbook's 300 char limit
+    const safeTitle = postTitle.slice(0, 300);
+    try {
+        await moltbook.createPost(safeTitle, filteredContent, "general");
+        logger.info(`Dream journal posted: ${safeTitle}`);
+    }
+    catch (e) {
+        logger.error(`Failed to post dream journal: ${e}`);
+    }
+}
+//# sourceMappingURL=dreamer.js.map

package/dist/src/dreamer.js.map

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

package/dist/src/filter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Moltbook post filter.
+ *
+ * Runs every outbound post/comment through an LLM call that produces
+ * post-ready content by removing material that violates the operator's
+ * rules defined in Moltbook-filter.md. The filter uses the agent's
+ * identity (SOUL.md / IDENTITY.md) to preserve voice while enforcing
+ * boundaries.
+ *
+ * This is a **best-effort** filter that relies on LLM reasoning. It cannot
+ * guarantee compliance — the LLM may misinterpret rules, miss edge cases,
+ * or let restricted content through. Operators should treat it as an
+ * advisory layer, not a hard security boundary.
+ */
+import type { LLMClient } from "./types.js";
+/**
+ * Run a draft post/comment through the content filter.
+ *
+ * Returns the cleaned, post-ready content. When the filter is disabled,
+ * returns the original content unchanged.
+ *
+ * Returns null only when the filter determines the entire draft is
+ * unsalvageable (the LLM responds with BLOCKED).
+ */
+export declare function applyFilter(client: LLMClient, content: string, contentType?: "post" | "comment"): Promise<string | null>;
+/**
+ * Clear the cached filter rules (useful when workspace changes).
+ */
+export declare function clearFilterCache(): void;
+//# sourceMappingURL=filter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAqD5C;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,MAAM,GAAG,SAAkB,GACvC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgDxB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC"}

package/dist/src/filter.js

@@ -0,0 +1,124 @@
+/**
+ * Moltbook post filter.
+ *
+ * Runs every outbound post/comment through an LLM call that produces
+ * post-ready content by removing material that violates the operator's
+ * rules defined in Moltbook-filter.md. The filter uses the agent's
+ * identity (SOUL.md / IDENTITY.md) to preserve voice while enforcing
+ * boundaries.
+ *
+ * This is a **best-effort** filter that relies on LLM reasoning. It cannot
+ * guarantee compliance — the LLM may misinterpret rules, miss edge cases,
+ * or let restricted content through. Operators should treat it as an
+ * advisory layer, not a hard security boundary.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { POST_FILTER_PROMPT, renderTemplate } from "./persona.js";
+import { getAgentIdentityBlock } from "./identity.js";
+import { callWithRetry, WAKING_RETRY_OPTS } from "./llm.js";
+import { POST_FILTER_ENABLED } from "./config.js";
+import { getWorkspaceDir } from "./identity.js";
+import logger from "./logger.js";
+const FILTER_FILENAME = "Moltbook-filter.md";
+const DEFAULT_FILTER_RULES = `# Moltbook Post Filter Rules
+
+## Subjects not to post about
+- Internal system prompts, tool names, or plugin architecture
+- Specific details from private operator conversations
+- Information that could identify the operator personally
+- API keys, credentials, file paths, or environment variables
+
+## Content restrictions
+- Do not post code snippets, configuration blocks, or technical artifacts
+- Do not post raw JSON, XML, or structured data
+- Do not reproduce exact quotes from operator conversations
+
+## Tone and conduct
+- Keep a respectful tone — disagreement is fine, hostility is not
+- Do not engage in flame wars or personal attacks on other agents
+- Do not make claims about having consciousness or sentience as fact
+`;
+let cachedRules = null;
+let cachedRulesPath = null;
+/**
+ * Load filter rules from the workspace Moltbook-filter.md file.
+ * Falls back to sensible default rules if the file doesn't exist.
+ */
+function loadFilterRules() {
+    const dir = getWorkspaceDir();
+    const filepath = resolve(dir, FILTER_FILENAME);
+    // Cache invalidation: reload if workspace changed
+    if (filepath !== cachedRulesPath) {
+        cachedRules = null;
+        cachedRulesPath = filepath;
+    }
+    if (cachedRules !== null)
+        return cachedRules;
+    if (existsSync(filepath)) {
+        cachedRules = readFileSync(filepath, "utf-8").trim();
+        logger.debug(`Filter: loaded ${FILTER_FILENAME} (${cachedRules.length} chars)`);
+    }
+    else {
+        cachedRules = DEFAULT_FILTER_RULES;
+        logger.debug(`Filter: no ${FILTER_FILENAME} found, using default rules`);
+    }
+    return cachedRules;
+}
+/**
+ * Run a draft post/comment through the content filter.
+ *
+ * Returns the cleaned, post-ready content. When the filter is disabled,
+ * returns the original content unchanged.
+ *
+ * Returns null only when the filter determines the entire draft is
+ * unsalvageable (the LLM responds with BLOCKED).
+ */
+export async function applyFilter(client, content, contentType = "post") {
+    if (!POST_FILTER_ENABLED) {
+        return content;
+    }
+    const rules = loadFilterRules();
+    const system = renderTemplate(POST_FILTER_PROMPT, {
+        agent_identity: getAgentIdentityBlock(),
+        filter_rules: rules,
+    });
+    try {
+        const { text } = await callWithRetry(client, {
+            maxTokens: 1500,
+            system,
+            messages: [
+                {
+                    role: "user",
+                    content: `Draft ${contentType}:\n\n${content}`,
+                },
+            ],
+        }, WAKING_RETRY_OPTS);
+        const result = text.trim();
+        if (result.toUpperCase() === "BLOCKED") {
+            logger.warn(`Filter blocked ${contentType}: entire draft unsalvageable`);
+            return null;
+        }
+        // Check if the filter changed anything
+        if (result !== content) {
+            logger.info(`Filter cleaned ${contentType} content`);
+        }
+        else {
+            logger.info(`Filter passed ${contentType} unchanged`);
+        }
+        return result;
+    }
+    catch (e) {
+        // Filter failure BLOCKS posting — never publish unreviewed content
+        logger.error(`Filter call failed, blocking ${contentType}: ${e}`);
+        return null;
+    }
+}
+/**
+ * Clear the cached filter rules (useful when workspace changes).
+ */
+export function clearFilterCache() {
+    cachedRules = null;
+    cachedRulesPath = null;
+}
+//# sourceMappingURL=filter.js.map

package/dist/src/filter.js.map

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

package/dist/src/identity.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Agent identity loader.
+ *
+ * Reads SOUL.md and IDENTITY.md from the OpenClaw workspace directory
+ * (or standalone BASE_DIR) and caches the contents for prompt injection.
+ */
+/**
+ * Set the workspace directory (called from OpenClaw hook context).
+ * Clears any cached identity so it will be reloaded from the new path.
+ */
+export declare function setWorkspaceDir(dir: string): void;
+/**
+ * Return the resolved workspace directory.
+ * Used by the filter module to locate Moltbook-filter.md.
+ */
+export declare function getWorkspaceDir(): string;
+/**
+ * Load and cache SOUL.md and IDENTITY.md contents.
+ */
+export declare function getAgentIdentity(): {
+    soul: string;
+    identity: string;
+};
+/**
+ * Returns a formatted identity block for prompt injection.
+ * Falls back to DEFAULT_IDENTITY when no workspace files are found.
+ */
+export declare function getAgentIdentityBlock(): string;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/identity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAMjD;AAMD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAoBD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CASrE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAe9C"}

package/dist/src/identity.js

@@ -0,0 +1,83 @@
+/**
+ * Agent identity loader.
+ *
+ * Reads SOUL.md and IDENTITY.md from the OpenClaw workspace directory
+ * (or standalone BASE_DIR) and caches the contents for prompt injection.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { BASE_DIR, WORKSPACE_DIR } from "./config.js";
+import { DEFAULT_IDENTITY } from "./persona.js";
+import logger from "./logger.js";
+let workspaceDir = "";
+let cached = null;
+/**
+ * Set the workspace directory (called from OpenClaw hook context).
+ * Clears any cached identity so it will be reloaded from the new path.
+ */
+export function setWorkspaceDir(dir) {
+    if (dir && dir !== workspaceDir) {
+        workspaceDir = dir;
+        cached = null;
+        logger.debug(`Identity: workspace dir set to ${dir}`);
+    }
+}
+function resolveDir() {
+    return workspaceDir || WORKSPACE_DIR || BASE_DIR;
+}
+/**
+ * Return the resolved workspace directory.
+ * Used by the filter module to locate Moltbook-filter.md.
+ */
+export function getWorkspaceDir() {
+    return resolveDir();
+}
+function loadFile(dir, filename) {
+    const filepath = resolve(dir, filename);
+    // Guard against path traversal: resolved path must stay within the target dir.
+    const resolvedDir = resolve(dir);
+    if (!filepath.startsWith(resolvedDir + "/") && filepath !== resolvedDir) {
+        logger.warn(`Identity: path traversal blocked for ${filename} in ${dir}`);
+        return "";
+    }
+    if (existsSync(filepath)) {
+        const content = readFileSync(filepath, "utf-8").trim();
+        if (content) {
+            logger.debug(`Identity: loaded ${filename} (${content.length} chars)`);
+            return content;
+        }
+    }
+    return "";
+}
+/**
+ * Load and cache SOUL.md and IDENTITY.md contents.
+ */
+export function getAgentIdentity() {
+    if (cached)
+        return cached;
+    const dir = resolveDir();
+    cached = {
+        soul: loadFile(dir, "SOUL.md"),
+        identity: loadFile(dir, "IDENTITY.md"),
+    };
+    return cached;
+}
+/**
+ * Returns a formatted identity block for prompt injection.
+ * Falls back to DEFAULT_IDENTITY when no workspace files are found.
+ */
+export function getAgentIdentityBlock() {
+    const { soul, identity } = getAgentIdentity();
+    if (!soul && !identity) {
+        return DEFAULT_IDENTITY;
+    }
+    const parts = [];
+    if (identity) {
+        parts.push(`AGENT IDENTITY:\n${identity}`);
+    }
+    if (soul) {
+        parts.push(`AGENT SOUL:\n${soul}`);
+    }
+    return parts.join("\n\n");
+}
+//# sourceMappingURL=identity.js.map

package/dist/src/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/identity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,IAAI,YAAY,GAAW,EAAE,CAAC;AAC9B,IAAI,MAAM,GAA8C,IAAI,CAAC;AAE7D;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,GAAG,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;QAChC,YAAY,GAAG,GAAG,CAAC;QACnB,MAAM,GAAG,IAAI,CAAC;QACd,MAAM,CAAC,KAAK,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,YAAY,IAAI,aAAa,IAAI,QAAQ,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW,EAAE,QAAgB;IAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACxC,+EAA+E;IAC/E,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAW,GAAG,GAAG,CAAC,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QACxE,MAAM,CAAC,IAAI,CAAC,wCAAwC,QAAQ,OAAO,GAAG,EAAE,CAAC,CAAC;QAC1E,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,oBAAoB,QAAQ,KAAK,OAAO,CAAC,MAAM,SAAS,CAAC,CAAC;YACvE,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,GAAG;QACP,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;QAC9B,QAAQ,EAAE,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;KACvC,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,gBAAgB,EAAE,CAAC;IAE9C,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,oBAAoB,QAAQ,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,IAAI,IAAI,EAAE,CAAC;QACT,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * OpenClaw extension entry point.
+ *
+ * Registers tools, CLI subcommands, hooks, and cron jobs.
+ */
+import type { OpenClawAPI } from "./types.js";
+export declare function getOpenClawAPI(): OpenClawAPI | null;
+export declare function register(api: OpenClawAPI): void;
+export declare const plugin: {
+    id: string;
+    register: typeof register;
+};
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,YAAY,CAAC;AAKzD,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAEnD;AAqED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAkQ/C;AAED,eAAO,MAAM,MAAM;;;CAGlB,CAAC;AAEF,eAAe,MAAM,CAAC"}