@remnic/core 1.1.12 → 1.1.14

package/dist/skills-registry.js

@@ -2,14 +2,26 @@ import "./chunk-PZ5AY32C.js";
 
 // src/skills-registry.ts
 import { fileURLToPath } from "url";
+import { statSync } from "fs";
 import { dirname, resolve } from "path";
 function isValidSkillSlug(slug) {
   return /^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,63}$/.test(slug);
 }
 var HERE = dirname(fileURLToPath(import.meta.url));
+var PACKAGED_SKILLS_DIR = resolve(HERE, "..", "skills");
 var PLUGIN_CODEX_SKILLS_DIR = resolve(HERE, "..", "..", "plugin-codex", "skills");
+function isDirectory(pathname) {
+  try {
+    return statSync(pathname).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function builtinSkillsDir() {
+  return isDirectory(PACKAGED_SKILLS_DIR) ? PACKAGED_SKILLS_DIR : PLUGIN_CODEX_SKILLS_DIR;
+}
 function codexSkillPath(slug) {
-  return resolve(PLUGIN_CODEX_SKILLS_DIR, slug, "SKILL.md");
+  return resolve(builtinSkillsDir(), slug, "SKILL.md");
 }
 var BUILTIN_SKILLS = [
   {

package/dist/skills-registry.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/skills-registry.ts"],"sourcesContent":["/**\n * skills-registry.ts\n *\n * Built-in Remnic procedural memory skills — the canonical SKILL.md sources\n * shipped with the monorepo. Consumers (e.g. the Codex materializer in #378)\n * read this registry to discover which skills to materialize into\n * `~/.codex/memories/skills/<slug>/SKILL.md`.\n *\n * This module is intentionally free of Codex/Claude Code host coupling —\n * it only exposes the static metadata each host needs.\n */\n\nimport { fileURLToPath } from \"node:url\";\nimport { dirname, resolve } from \"node:path\";\n\n/**\n * A single procedural-memory skill source that Remnic ships.\n *\n * - `slug` is the canonical folder name under `skills/` and the file on disk\n *   must live at `<pluginRoot>/skills/<slug>/SKILL.md`.\n * - `staticPath`, when set, points at a pre-authored SKILL.md on disk.\n * - `generator`, when set, produces a SKILL.md body at materialization time.\n *   Exactly one of `staticPath` or `generator` should be provided.\n * - `disableModelInvocation` mirrors the `disable-model-invocation` frontmatter\n *   key and indicates a skill that writes or mutates state and therefore\n *   should not be auto-invoked by a model without explicit opt-in.\n */\nexport interface RemnicSkillSource {\n  slug: string;\n  staticPath?: string;\n  generator?: () => Promise<string>;\n  disableModelInvocation: boolean;\n}\n\n/**\n * Validate a Remnic skill slug. Rules:\n *\n * - lowercase letters, digits, and `-` only\n * - must start with a letter or digit\n * - 1–64 characters\n *\n * This is the same shape the Codex skills directory expects.\n */\nexport function isValidSkillSlug(slug: string): boolean {\n  // Must start with alphanumeric; each dash must be followed by alphanumeric\n  // (no trailing dashes, no consecutive dashes); 1–64 characters total.\n  return /^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,63}$/.test(slug);\n}\n\n// ---------------------------------------------------------------------------\n// Built-in skill paths — resolved relative to this source file.\n// ---------------------------------------------------------------------------\n//\n// This file lives at `packages/remnic-core/src/skills-registry.ts`.\n// After tsup build it lives at `packages/remnic-core/dist/skills-registry.js`.\n// In both cases, the shipped skill sources live four levels up at\n// `packages/plugin-codex/skills/<slug>/SKILL.md`.\n//\n// We compute the absolute path from the current module so that callers in any\n// cwd can resolve the files.\n\nconst HERE = dirname(fileURLToPath(import.meta.url));\nconst PLUGIN_CODEX_SKILLS_DIR = resolve(HERE, \"..\", \"..\", \"plugin-codex\", \"skills\");\n\nfunction codexSkillPath(slug: string): string {\n  return resolve(PLUGIN_CODEX_SKILLS_DIR, slug, \"SKILL.md\");\n}\n\n/**\n * The canonical list of Remnic procedural memory skills shipped with the\n * monorepo. The Codex materializer (#378) copies these into\n * `~/.codex/memories/skills/<slug>/SKILL.md`.\n */\nexport const BUILTIN_SKILLS: RemnicSkillSource[] = [\n  {\n    slug: \"remnic-memory-workflow\",\n    staticPath: codexSkillPath(\"remnic-memory-workflow\"),\n    disableModelInvocation: true,\n  },\n  {\n    slug: \"remnic-recall\",\n    staticPath: codexSkillPath(\"remnic-recall\"),\n    disableModelInvocation: false,\n  },\n  {\n    slug: \"remnic-remember\",\n    staticPath: codexSkillPath(\"remnic-remember\"),\n    disableModelInvocation: true,\n  },\n  {\n    slug: \"remnic-search\",\n    staticPath: codexSkillPath(\"remnic-search\"),\n    disableModelInvocation: false,\n  },\n  {\n    slug: \"remnic-entities\",\n    staticPath: codexSkillPath(\"remnic-entities\"),\n    disableModelInvocation: false,\n  },\n  {\n    slug: \"remnic-status\",\n    staticPath: codexSkillPath(\"remnic-status\"),\n    disableModelInvocation: false,\n  },\n];\n"],"mappings":";;;AAYA,SAAS,qBAAqB;AAC9B,SAAS,SAAS,eAAe;AA8B1B,SAAS,iBAAiB,MAAuB;AAGtD,SAAO,6CAA6C,KAAK,IAAI;AAC/D;AAcA,IAAM,OAAO,QAAQ,cAAc,YAAY,GAAG,CAAC;AACnD,IAAM,0BAA0B,QAAQ,MAAM,MAAM,MAAM,gBAAgB,QAAQ;AAElF,SAAS,eAAe,MAAsB;AAC5C,SAAO,QAAQ,yBAAyB,MAAM,UAAU;AAC1D;AAOO,IAAM,iBAAsC;AAAA,EACjD;AAAA,IACE,MAAM;AAAA,IACN,YAAY,eAAe,wBAAwB;AAAA,IACnD,wBAAwB;AAAA,EAC1B;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YAAY,eAAe,eAAe;AAAA,IAC1C,wBAAwB;AAAA,EAC1B;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YAAY,eAAe,iBAAiB;AAAA,IAC5C,wBAAwB;AAAA,EAC1B;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YAAY,eAAe,eAAe;AAAA,IAC1C,wBAAwB;AAAA,EAC1B;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YAAY,eAAe,iBAAiB;AAAA,IAC5C,wBAAwB;AAAA,EAC1B;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YAAY,eAAe,eAAe;AAAA,IAC1C,wBAAwB;AAAA,EAC1B;AACF;","names":[]}
+{"version":3,"sources":["../src/skills-registry.ts"],"sourcesContent":["/**\n * skills-registry.ts\n *\n * Built-in Remnic procedural memory skills — the canonical SKILL.md sources\n * shipped with the monorepo. Consumers (e.g. the Codex materializer in #378)\n * read this registry to discover which skills to materialize into\n * `~/.codex/memories/skills/<slug>/SKILL.md`.\n *\n * This module is intentionally free of Codex/Claude Code host coupling —\n * it only exposes the static metadata each host needs.\n */\n\nimport { fileURLToPath } from \"node:url\";\nimport { statSync } from \"node:fs\";\nimport { dirname, resolve } from \"node:path\";\n\n/**\n * A single procedural-memory skill source that Remnic ships.\n *\n * - `slug` is the canonical folder name under `skills/` and the file on disk\n *   must live at `<pluginRoot>/skills/<slug>/SKILL.md`.\n * - `staticPath`, when set, points at a pre-authored SKILL.md on disk.\n * - `generator`, when set, produces a SKILL.md body at materialization time.\n *   Exactly one of `staticPath` or `generator` should be provided.\n * - `disableModelInvocation` mirrors the `disable-model-invocation` frontmatter\n *   key and indicates a skill that writes or mutates state and therefore\n *   should not be auto-invoked by a model without explicit opt-in.\n */\nexport interface RemnicSkillSource {\n  slug: string;\n  staticPath?: string;\n  generator?: () => Promise<string>;\n  disableModelInvocation: boolean;\n}\n\n/**\n * Validate a Remnic skill slug. Rules:\n *\n * - lowercase letters, digits, and `-` only\n * - must start with a letter or digit\n * - 1–64 characters\n *\n * This is the same shape the Codex skills directory expects.\n */\nexport function isValidSkillSlug(slug: string): boolean {\n  // Must start with alphanumeric; each dash must be followed by alphanumeric\n  // (no trailing dashes, no consecutive dashes); 1–64 characters total.\n  return /^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){0,63}$/.test(slug);\n}\n\n// ---------------------------------------------------------------------------\n// Built-in skill paths — resolved relative to this module.\n// ---------------------------------------------------------------------------\n//\n// This file lives at `packages/remnic-core/src/skills-registry.ts`.\n// After tsup build it lives at `packages/remnic-core/dist/skills-registry.js`.\n// Packaged @remnic/core artifacts ship skill sources under\n// `packages/remnic-core/skills/<slug>/SKILL.md`; source checkouts can fall back\n// to the canonical monorepo copies in `packages/plugin-codex/skills`.\n//\n// We compute the absolute path from the current module so that callers in any\n// cwd can resolve the files.\n\nconst HERE = dirname(fileURLToPath(import.meta.url));\nconst PACKAGED_SKILLS_DIR = resolve(HERE, \"..\", \"skills\");\nconst PLUGIN_CODEX_SKILLS_DIR = resolve(HERE, \"..\", \"..\", \"plugin-codex\", \"skills\");\n\nfunction isDirectory(pathname: string): boolean {\n  try {\n    return statSync(pathname).isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nfunction builtinSkillsDir(): string {\n  return isDirectory(PACKAGED_SKILLS_DIR) ? PACKAGED_SKILLS_DIR : PLUGIN_CODEX_SKILLS_DIR;\n}\n\nfunction codexSkillPath(slug: string): string {\n  return resolve(builtinSkillsDir(), slug, \"SKILL.md\");\n}\n\n/**\n * The canonical list of Remnic procedural memory skills shipped with the\n * monorepo. The Codex materializer (#378) copies these into\n * `~/.codex/memories/skills/<slug>/SKILL.md`.\n */\nexport const BUILTIN_SKILLS: RemnicSkillSource[] = [\n  {\n    slug: \"remnic-memory-workflow\",\n    staticPath: codexSkillPath(\"remnic-memory-workflow\"),\n    disableModelInvocation: true,\n  },\n  {\n    slug: \"remnic-recall\",\n    staticPath: codexSkillPath(\"remnic-recall\"),\n    disableModelInvocation: false,\n  },\n  {\n    slug: \"remnic-remember\",\n    staticPath: codexSkillPath(\"remnic-remember\"),\n    disableModelInvocation: true,\n  },\n  {\n    slug: \"remnic-search\",\n    staticPath: codexSkillPath(\"remnic-search\"),\n    disableModelInvocation: false,\n  },\n  {\n    slug: \"remnic-entities\",\n    staticPath: codexSkillPath(\"remnic-entities\"),\n    disableModelInvocation: false,\n  },\n  {\n    slug: \"remnic-status\",\n    staticPath: codexSkillPath(\"remnic-status\"),\n    disableModelInvocation: false,\n  },\n];\n"],"mappings":";;;AAYA,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AACzB,SAAS,SAAS,eAAe;AA8B1B,SAAS,iBAAiB,MAAuB;AAGtD,SAAO,6CAA6C,KAAK,IAAI;AAC/D;AAeA,IAAM,OAAO,QAAQ,cAAc,YAAY,GAAG,CAAC;AACnD,IAAM,sBAAsB,QAAQ,MAAM,MAAM,QAAQ;AACxD,IAAM,0BAA0B,QAAQ,MAAM,MAAM,MAAM,gBAAgB,QAAQ;AAElF,SAAS,YAAY,UAA2B;AAC9C,MAAI;AACF,WAAO,SAAS,QAAQ,EAAE,YAAY;AAAA,EACxC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,mBAA2B;AAClC,SAAO,YAAY,mBAAmB,IAAI,sBAAsB;AAClE;AAEA,SAAS,eAAe,MAAsB;AAC5C,SAAO,QAAQ,iBAAiB,GAAG,MAAM,UAAU;AACrD;AAOO,IAAM,iBAAsC;AAAA,EACjD;AAAA,IACE,MAAM;AAAA,IACN,YAAY,eAAe,wBAAwB;AAAA,IACnD,wBAAwB;AAAA,EAC1B;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YAAY,eAAe,eAAe;AAAA,IAC1C,wBAAwB;AAAA,EAC1B;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YAAY,eAAe,iBAAiB;AAAA,IAC5C,wBAAwB;AAAA,EAC1B;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YAAY,eAAe,eAAe;AAAA,IAC1C,wBAAwB;AAAA,EAC1B;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YAAY,eAAe,iBAAiB;AAAA,IAC5C,wBAAwB;AAAA,EAC1B;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,YAAY,eAAe,eAAe;AAAA,IAC1C,wBAAwB;AAAA,EAC1B;AACF;","names":[]}

package/dist/state-store-VZU2IA53.js

@@ -0,0 +1,16 @@
+import {
+  _connectorStatePathForTest,
+  listConnectorStates,
+  readConnectorState,
+  writeConnectorState
+} from "./chunk-LPMVBPA3.js";
+import "./chunk-QRNI5JBH.js";
+import "./chunk-XIG5PDM7.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  _connectorStatePathForTest,
+  listConnectorStates,
+  readConnectorState,
+  writeConnectorState
+};
+//# sourceMappingURL=state-store-VZU2IA53.js.map

package/dist/state-store-VZU2IA53.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/storage-paths.d.ts

@@ -0,0 +1,9 @@
+declare function encodeStoragePathSegment(value: string, fallback?: string): string;
+declare function storagePathHash(value: string): string;
+declare function encodeStoragePathSegmentWithHash(value: string, fallback?: string): string;
+declare function isSafeLegacyPathSegment(value: string): boolean;
+declare function isPathInsideStorageRoot(rootAbs: string, targetAbs: string): boolean;
+declare function resolvePathInsideStorageRoot(root: string, ...parts: string[]): string;
+declare function resolveSafeStoragePath(root: string, ...parts: string[]): Promise<string>;
+
+export { encodeStoragePathSegment, encodeStoragePathSegmentWithHash, isPathInsideStorageRoot, isSafeLegacyPathSegment, resolvePathInsideStorageRoot, resolveSafeStoragePath, storagePathHash };

package/dist/storage-paths.js

@@ -0,0 +1,20 @@
+import {
+  encodeStoragePathSegment,
+  encodeStoragePathSegmentWithHash,
+  isPathInsideStorageRoot,
+  isSafeLegacyPathSegment,
+  resolvePathInsideStorageRoot,
+  resolveSafeStoragePath,
+  storagePathHash
+} from "./chunk-FF4KLI5W.js";
+import "./chunk-PZ5AY32C.js";
+export {
+  encodeStoragePathSegment,
+  encodeStoragePathSegmentWithHash,
+  isPathInsideStorageRoot,
+  isSafeLegacyPathSegment,
+  resolvePathInsideStorageRoot,
+  resolveSafeStoragePath,
+  storagePathHash
+};
+//# sourceMappingURL=storage-paths.js.map

package/dist/storage-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/storage.d.ts

@@ -1,8 +1,10 @@
 import { VersioningConfig } from './page-versioning.js';
 import { ConsolidationOperator } from './consolidation-operator.js';
 import { PluginConfig, MemoryCategory, ImportanceScore, MemoryLink, MemoryFrontmatter, MemoryStatus, MemoryFile, EntityStructuredSection, BufferState, MetaState, MemoryActionEvent, MemoryLifecycleEvent, BufferSurpriseEvent, BehaviorSignalEvent, CompressionGuidelineOptimizerState, ContinuityIncidentOpenInput, ContinuityIncidentRecord, ContinuityIncidentCloseInput, ContinuityImprovementLoop, ContinuityLoopUpsertInput, ContinuityLoopReviewInput, FileHygieneConfig, EntityRelationship, EntityActivityEntry, EntityFile, AccessTrackingEntry, MemoryProjectionCurrentState, MemorySummary, TopicScore } from './types.js';
-import { P as ProjectedMemoryBrowseOptions, a as ProjectedMemoryBrowsePage, b as readProjectedGovernanceRecord } from './memory-projection-store-CY8TU40w.js';
+import { ProjectedMemoryBrowseOptions, ProjectedMemoryBrowsePage, readProjectedGovernanceRecord } from './memory-projection-store.js';
 import './index-DJ9QWMw-.js';
+import './maintenance/memory-governance.js';
+import './runtime/better-sqlite.js';
 import 'better-sqlite3';
 
 interface ReextractJobRequest {

package/dist/storage.js

@@ -8,20 +8,23 @@ import {
   normalizeEntityName,
   parseEntityFile,
   serializeEntityFile
-} from "./chunk-3B6KIRBH.js";
+} from "./chunk-7AAT6G4Q.js";
+import "./chunk-5UZXUTVO.js";
 import "./chunk-YNJHCGDT.js";
+import "./chunk-P7FMDTKL.js";
 import "./chunk-NN2DKE4T.js";
-import "./chunk-23ZZK64Y.js";
+import "./chunk-Q7P4WJDP.js";
 import "./chunk-SCU65EZI.js";
-import "./chunk-XJKFSSDW.js";
+import "./chunk-3KW65B36.js";
+import "./chunk-3HPAPHUK.js";
 import "./chunk-PFV5C235.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-FVQJYWH7.js";
-import "./chunk-4DJQYKMN.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-FAAFWE4G.js";
+import "./chunk-4DJQYKMN.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-A6XUJE5D.js";
 import "./chunk-PZ5AY32C.js";

package/dist/summarizer.d.ts

@@ -16,6 +16,9 @@ declare class HourlySummarizer {
     private get shouldUseLocalLlm();
     private withGatewayAgent;
     initialize(): Promise<void>;
+    private summarySessionDir;
+    private legacySummarySessionDir;
+    private summaryDateString;
     generateSummary(sessionKey: string, hourStart: Date, entries: TranscriptEntry[]): Promise<HourlySummary | null>;
     private generateExtended;
     /**
@@ -26,10 +29,12 @@ declare class HourlySummarizer {
     saveSummary(summary: HourlySummary): Promise<void>;
     private formatHourSection;
     readRecent(sessionKey: string, hours: number): Promise<HourlySummary[]>;
+    private readSummaryDir;
     private parseSummaryFile;
     formatForRecall(summaries: HourlySummary[], maxCount: number): string;
     runHourly(): Promise<void>;
     private getActiveSessions;
+    private collectTranscriptSessionKeys;
     private getTranscriptEntries;
 }
 

package/dist/summarizer.js

@@ -1,18 +1,19 @@
 import {
   HourlySummarizer
-} from "./chunk-7V22HTMD.js";
-import "./chunk-ETOW6ACV.js";
+} from "./chunk-H3ME6L6D.js";
+import "./chunk-XJNBEDFE.js";
 import "./chunk-QR3C7BKQ.js";
-import "./chunk-HELQZFZO.js";
-import "./chunk-AQJNPMOA.js";
-import "./chunk-PH4C2U43.js";
+import "./chunk-EDTHC6UD.js";
+import "./chunk-FF4KLI5W.js";
+import "./chunk-DINWEURR.js";
+import "./chunk-FLTNHQK6.js";
 import "./chunk-7SI52C65.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-UZB5KHKX.js";
 import "./chunk-RK6F44Y6.js";
-import "./chunk-OR64ZGRZ.js";
-import "./chunk-IXEJRKCZ.js";
-import "./chunk-MARWOCVP.js";
+import "./chunk-NNVTUXEB.js";
+import "./chunk-QRNI5JBH.js";
+import "./chunk-XIG5PDM7.js";
 import "./chunk-2ODBA7MQ.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/summary-snapshot.js

@@ -3,7 +3,8 @@ import {
   summarySnapshotPath,
   upsertSummarySnapshot,
   writeSummarySnapshot
-} from "./chunk-ETOW6ACV.js";
+} from "./chunk-XJNBEDFE.js";
+import "./chunk-FF4KLI5W.js";
 import "./chunk-PZ5AY32C.js";
 export {
   readSummarySnapshot,

package/dist/surfaces/dreams.d.ts

@@ -0,0 +1,16 @@
+interface DreamEntry {
+    id: string;
+    timestamp: string;
+    title: string | null;
+    body: string;
+    tags: string[];
+    sourceOffset: number;
+}
+interface DreamsSurface {
+    read(path: string): Promise<DreamEntry[]>;
+    append(path: string, entry: Omit<DreamEntry, "id" | "sourceOffset">): Promise<DreamEntry>;
+    watch(path: string, onChange: (entries: DreamEntry[]) => void): () => void;
+}
+declare function createDreamsSurface(): DreamsSurface;
+
+export { type DreamEntry, type DreamsSurface, createDreamsSurface };

package/dist/surfaces/dreams.js

@@ -0,0 +1,282 @@
+import "../chunk-PZ5AY32C.js";
+
+// src/surfaces/dreams.ts
+import { createHash } from "crypto";
+import { statSync, watch } from "fs";
+import { mkdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+var DIARY_START_MARKER = "<!-- openclaw:dreaming:diary:start -->";
+var DIARY_END_MARKER = "<!-- openclaw:dreaming:diary:end -->";
+function stableDreamId(params) {
+  const digest = createHash("sha1").update(
+    JSON.stringify({
+      timestamp: params.timestamp,
+      occurrence: params.occurrence
+    })
+  ).digest("hex").slice(0, 12);
+  return `dream-${digest}`;
+}
+function normalizeBody(value) {
+  return value.replace(/\r\n/g, "\n").trim();
+}
+function parseTagsLine(line) {
+  const match = /^Tags:\s*(.*)$/i.exec(line.trim());
+  if (!match) return [];
+  return match[1].split(/\s+/).map((token) => token.trim()).filter(Boolean).map((token) => token.replace(/^#/, ""));
+}
+function buildDreamEntry(params) {
+  const title = params.title?.trim() || null;
+  return {
+    timestamp: params.timestamp.trim(),
+    title,
+    body: normalizeBody(params.body),
+    tags: params.tags,
+    sourceOffset: params.sourceOffset
+  };
+}
+function finalizeDreamEntries(entries) {
+  const seenByTimestamp = /* @__PURE__ */ new Map();
+  return entries.map((entry) => {
+    const occurrence = seenByTimestamp.get(entry.timestamp) ?? 0;
+    seenByTimestamp.set(entry.timestamp, occurrence + 1);
+    return {
+      ...entry,
+      id: stableDreamId({
+        timestamp: entry.timestamp,
+        occurrence
+      })
+    };
+  });
+}
+function splitDiaryBlocks(content) {
+  const results = [];
+  const starts = [...content.matchAll(/(^|\n)---\n(?=\n\*)/g)].map((match) => ({
+    blockStart: (match.index ?? 0) + (match[1]?.length ?? 0),
+    contentStart: (match.index ?? 0) + (match[1]?.length ?? 0) + "---\n".length
+  }));
+  for (let index = 0; index < starts.length; index += 1) {
+    const start = starts[index];
+    if (!start) continue;
+    const end = starts[index + 1]?.blockStart ?? content.length;
+    const block = content.slice(start.contentStart, end).trim();
+    if (!block) continue;
+    results.push({ block, sourceOffset: start.contentStart });
+  }
+  return results;
+}
+function parseDiaryBlock(block, sourceOffset) {
+  const lines = block.split("\n");
+  const first = lines.shift()?.trim() ?? "";
+  const italicMatch = /^\*(.+)\*$/.exec(first);
+  if (!italicMatch) return null;
+  const firstLine = italicMatch[1].trim();
+  const splitIndex = firstLine.indexOf(" \u2014 ");
+  const timestamp = splitIndex >= 0 ? firstLine.slice(0, splitIndex).trim() : firstLine;
+  const title = splitIndex >= 0 ? firstLine.slice(splitIndex + 3).trim() : null;
+  const tags = lines.length > 0 ? parseTagsLine(lines[lines.length - 1] ?? "") : [];
+  const bodyLines = tags.length > 0 ? lines.slice(0, Math.max(0, lines.length - 1)) : lines;
+  return buildDreamEntry({
+    timestamp,
+    title,
+    body: bodyLines.join("\n"),
+    tags,
+    sourceOffset
+  });
+}
+function parseLegacyHeadingEntries(content) {
+  const entries = [];
+  const headingRegex = /^##\s+(.+)$/gm;
+  const matches = [...content.matchAll(headingRegex)];
+  for (let index = 0; index < matches.length; index += 1) {
+    const match = matches[index];
+    const start = match.index ?? 0;
+    const end = index + 1 < matches.length ? matches[index + 1]?.index ?? content.length : content.length;
+    const heading = match[1]?.trim() ?? "";
+    const body = content.slice(start + match[0].length, end).replace(/^\s+/, "");
+    const dividerTrimmed = body.replace(/\n---\s*$/m, "").trim();
+    const bodyLines = dividerTrimmed.split("\n");
+    const tags = bodyLines.length > 0 ? parseTagsLine(bodyLines[bodyLines.length - 1] ?? "") : [];
+    const contentLines = tags.length > 0 ? bodyLines.slice(0, Math.max(0, bodyLines.length - 1)) : bodyLines;
+    const splitIndex = heading.indexOf(" \u2014 ");
+    const timestamp = splitIndex >= 0 ? heading.slice(0, splitIndex).trim() : heading;
+    const title = splitIndex >= 0 ? heading.slice(splitIndex + 3).trim() : null;
+    entries.push(
+      buildDreamEntry({
+        timestamp,
+        title,
+        body: contentLines.join("\n"),
+        tags,
+        sourceOffset: start
+      })
+    );
+  }
+  return entries;
+}
+function parseDreamEntries(content) {
+  const normalized = content.replace(/\r\n/g, "\n");
+  const start = normalized.indexOf(DIARY_START_MARKER);
+  const end = normalized.indexOf(DIARY_END_MARKER);
+  if (start >= 0 && end > start) {
+    const inner = normalized.slice(start + DIARY_START_MARKER.length, end);
+    return finalizeDreamEntries(
+      splitDiaryBlocks(inner).map(({ block, sourceOffset }) => parseDiaryBlock(block, start + DIARY_START_MARKER.length + sourceOffset)).filter((entry) => entry !== null)
+    );
+  }
+  return finalizeDreamEntries(parseLegacyHeadingEntries(normalized));
+}
+function renderDiary(entries) {
+  const blocks = entries.map((entry) => renderAppendBlock(entry)).join("\n").trimEnd();
+  return [
+    "# Dream Diary",
+    "",
+    DIARY_START_MARKER,
+    blocks,
+    "",
+    DIARY_END_MARKER,
+    ""
+  ].filter((line, index, lines) => !(line === "" && lines[index - 1] === "")).join("\n");
+}
+function ensureDiary(content) {
+  if (content.includes(DIARY_START_MARKER) && content.includes(DIARY_END_MARKER)) {
+    return content;
+  }
+  const legacyEntries = parseLegacyHeadingEntries(content.replace(/\r\n/g, "\n"));
+  if (legacyEntries.length > 0) {
+    return renderDiary(
+      legacyEntries.map((entry) => ({
+        timestamp: entry.timestamp,
+        title: entry.title,
+        body: entry.body,
+        tags: entry.tags
+      }))
+    );
+  }
+  return renderDiary([]);
+}
+function renderAppendBlock(entry) {
+  const titlePart = entry.title?.trim() ? ` \u2014 ${entry.title.trim()}` : "";
+  const tagsPart = entry.tags.length > 0 ? `
+
+Tags: ${entry.tags.map((tag) => `#${tag}`).join(" ")}` : "";
+  return `---
+
+*${entry.timestamp}${titlePart}*
+
+${entry.body.trim()}${tagsPart}
+`;
+}
+function createDreamsSurface() {
+  return {
+    async read(filePath) {
+      try {
+        const content = await readFile(filePath, "utf8");
+        return parseDreamEntries(content);
+      } catch (error) {
+        if (error.code === "ENOENT") {
+          return [];
+        }
+        throw error;
+      }
+    },
+    async append(filePath, entry) {
+      await mkdir(path.dirname(filePath), { recursive: true });
+      let content = "";
+      try {
+        content = await readFile(filePath, "utf8");
+      } catch (error) {
+        if (error.code !== "ENOENT") throw error;
+      }
+      const ensured = ensureDiary(content);
+      const endIndex = ensured.indexOf(DIARY_END_MARKER);
+      const block = renderAppendBlock(entry);
+      const updated = endIndex >= 0 ? `${ensured.slice(0, endIndex)}${block}
+${ensured.slice(endIndex)}` : `${ensureDiary("")}${block}`;
+      await writeFile(filePath, updated.endsWith("\n") ? updated : `${updated}
+`, "utf8");
+      const entries = parseDreamEntries(updated);
+      return entries[entries.length - 1];
+    },
+    watch(filePath, onChange) {
+      let fileWatcher = null;
+      let parentWatcher = null;
+      let timer = null;
+      const watchedName = path.basename(filePath);
+      const watchedDir = path.dirname(filePath);
+      const resolveParentWatchTarget = () => {
+        let candidateDir = watchedDir;
+        while (true) {
+          try {
+            if (statSync(candidateDir).isDirectory()) {
+              const relative = path.relative(candidateDir, watchedDir);
+              return {
+                dir: candidateDir,
+                expectedName: relative.length === 0 ? watchedName : relative.split(path.sep)[0] ?? watchedName
+              };
+            }
+          } catch {
+          }
+          const parentDir = path.dirname(candidateDir);
+          if (parentDir === candidateDir) {
+            return null;
+          }
+          candidateDir = parentDir;
+        }
+      };
+      const rearmFileWatcher = () => {
+        fileWatcher?.close();
+        fileWatcher = null;
+        try {
+          fileWatcher = watch(filePath, { persistent: false }, emit);
+        } catch {
+          fileWatcher = null;
+        }
+      };
+      const ensureParentWatcher = () => {
+        if (parentWatcher) return;
+        const target = resolveParentWatchTarget();
+        if (!target) return;
+        try {
+          parentWatcher = watch(
+            target.dir,
+            { persistent: false },
+            (_eventType, changed) => {
+              if (changed && String(changed) !== target.expectedName) return;
+              parentWatcher?.close();
+              parentWatcher = null;
+              ensureParentWatcher();
+              rearmFileWatcher();
+              if (target.expectedName === watchedName || fileWatcher) {
+                emit();
+              }
+            }
+          );
+        } catch {
+          parentWatcher = null;
+        }
+      };
+      const emit = () => {
+        if (timer) clearTimeout(timer);
+        timer = setTimeout(async () => {
+          timer = null;
+          try {
+            rearmFileWatcher();
+            onChange(await this.read(filePath));
+          } catch (error) {
+            console.warn("[remnic] dreams surface watch update failed", error);
+          }
+        }, 25);
+      };
+      rearmFileWatcher();
+      ensureParentWatcher();
+      return () => {
+        if (timer) clearTimeout(timer);
+        fileWatcher?.close();
+        parentWatcher?.close();
+      };
+    }
+  };
+}
+export {
+  createDreamsSurface
+};
+//# sourceMappingURL=dreams.js.map

package/dist/surfaces/dreams.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/surfaces/dreams.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { statSync, watch, type FSWatcher } from \"node:fs\";\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nexport interface DreamEntry {\n  id: string;\n  timestamp: string;\n  title: string | null;\n  body: string;\n  tags: string[];\n  sourceOffset: number;\n}\n\nexport interface DreamsSurface {\n  read(path: string): Promise<DreamEntry[]>;\n  append(\n    path: string,\n    entry: Omit<DreamEntry, \"id\" | \"sourceOffset\">,\n  ): Promise<DreamEntry>;\n  watch(path: string, onChange: (entries: DreamEntry[]) => void): () => void;\n}\n\nconst DIARY_START_MARKER = \"<!-- openclaw:dreaming:diary:start -->\";\nconst DIARY_END_MARKER = \"<!-- openclaw:dreaming:diary:end -->\";\n\nfunction stableDreamId(params: {\n  timestamp: string;\n  occurrence: number;\n}): string {\n  const digest = createHash(\"sha1\")\n    .update(\n      JSON.stringify({\n        timestamp: params.timestamp,\n        occurrence: params.occurrence,\n      }),\n    )\n    .digest(\"hex\")\n    .slice(0, 12);\n  return `dream-${digest}`;\n}\n\ntype ParsedDreamEntry = Omit<DreamEntry, \"id\">;\n\nfunction normalizeBody(value: string): string {\n  return value.replace(/\\r\\n/g, \"\\n\").trim();\n}\n\nfunction parseTagsLine(line: string): string[] {\n  const match = /^Tags:\\s*(.*)$/i.exec(line.trim());\n  if (!match) return [];\n  return match[1]\n    .split(/\\s+/)\n    .map((token) => token.trim())\n    .filter(Boolean)\n    .map((token) => token.replace(/^#/, \"\"));\n}\n\nfunction buildDreamEntry(params: {\n  timestamp: string;\n  title: string | null;\n  body: string;\n  tags: string[];\n  sourceOffset: number;\n}): ParsedDreamEntry {\n  const title = params.title?.trim() || null;\n  return {\n    timestamp: params.timestamp.trim(),\n    title,\n    body: normalizeBody(params.body),\n    tags: params.tags,\n    sourceOffset: params.sourceOffset,\n  };\n}\n\nfunction finalizeDreamEntries(entries: ParsedDreamEntry[]): DreamEntry[] {\n  const seenByTimestamp = new Map<string, number>();\n  return entries.map((entry) => {\n    const occurrence = seenByTimestamp.get(entry.timestamp) ?? 0;\n    seenByTimestamp.set(entry.timestamp, occurrence + 1);\n    return {\n      ...entry,\n      id: stableDreamId({\n        timestamp: entry.timestamp,\n        occurrence,\n      }),\n    };\n  });\n}\n\nfunction splitDiaryBlocks(content: string): Array<{ block: string; sourceOffset: number }> {\n  const results: Array<{ block: string; sourceOffset: number }> = [];\n  const starts = [...content.matchAll(/(^|\\n)---\\n(?=\\n\\*)/g)].map((match) => ({\n    blockStart: (match.index ?? 0) + (match[1]?.length ?? 0),\n    contentStart:\n      (match.index ?? 0) + (match[1]?.length ?? 0) + \"---\\n\".length,\n  }));\n\n  for (let index = 0; index < starts.length; index += 1) {\n    const start = starts[index];\n    if (!start) continue;\n    const end = starts[index + 1]?.blockStart ?? content.length;\n    const block = content.slice(start.contentStart, end).trim();\n    if (!block) continue;\n    results.push({ block, sourceOffset: start.contentStart });\n  }\n  return results;\n}\n\nfunction parseDiaryBlock(block: string, sourceOffset: number): ParsedDreamEntry | null {\n  const lines = block.split(\"\\n\");\n  const first = lines.shift()?.trim() ?? \"\";\n  const italicMatch = /^\\*(.+)\\*$/.exec(first);\n  if (!italicMatch) return null;\n  const firstLine = italicMatch[1].trim();\n  const splitIndex = firstLine.indexOf(\" — \");\n  const timestamp = splitIndex >= 0 ? firstLine.slice(0, splitIndex).trim() : firstLine;\n  const title = splitIndex >= 0 ? firstLine.slice(splitIndex + 3).trim() : null;\n  const tags = lines.length > 0 ? parseTagsLine(lines[lines.length - 1] ?? \"\") : [];\n  const bodyLines =\n    tags.length > 0\n      ? lines.slice(0, Math.max(0, lines.length - 1))\n      : lines;\n  return buildDreamEntry({\n    timestamp,\n    title,\n    body: bodyLines.join(\"\\n\"),\n    tags,\n    sourceOffset,\n  });\n}\n\nfunction parseLegacyHeadingEntries(content: string): ParsedDreamEntry[] {\n  const entries: ParsedDreamEntry[] = [];\n  const headingRegex = /^##\\s+(.+)$/gm;\n  const matches = [...content.matchAll(headingRegex)];\n  for (let index = 0; index < matches.length; index += 1) {\n    const match = matches[index];\n    const start = match.index ?? 0;\n    const end = index + 1 < matches.length ? (matches[index + 1]?.index ?? content.length) : content.length;\n    const heading = match[1]?.trim() ?? \"\";\n    const body = content.slice(start + match[0].length, end).replace(/^\\s+/, \"\");\n    const dividerTrimmed = body.replace(/\\n---\\s*$/m, \"\").trim();\n    const bodyLines = dividerTrimmed.split(\"\\n\");\n    const tags = bodyLines.length > 0 ? parseTagsLine(bodyLines[bodyLines.length - 1] ?? \"\") : [];\n    const contentLines =\n      tags.length > 0\n        ? bodyLines.slice(0, Math.max(0, bodyLines.length - 1))\n        : bodyLines;\n    const splitIndex = heading.indexOf(\" — \");\n    const timestamp = splitIndex >= 0 ? heading.slice(0, splitIndex).trim() : heading;\n    const title = splitIndex >= 0 ? heading.slice(splitIndex + 3).trim() : null;\n    entries.push(\n      buildDreamEntry({\n        timestamp,\n        title,\n        body: contentLines.join(\"\\n\"),\n        tags,\n        sourceOffset: start,\n      }),\n    );\n  }\n  return entries;\n}\n\nfunction parseDreamEntries(content: string): DreamEntry[] {\n  const normalized = content.replace(/\\r\\n/g, \"\\n\");\n  const start = normalized.indexOf(DIARY_START_MARKER);\n  const end = normalized.indexOf(DIARY_END_MARKER);\n  if (start >= 0 && end > start) {\n    const inner = normalized.slice(start + DIARY_START_MARKER.length, end);\n    return finalizeDreamEntries(\n      splitDiaryBlocks(inner)\n      .map(({ block, sourceOffset }) =>\n        parseDiaryBlock(block, start + DIARY_START_MARKER.length + sourceOffset))\n      .filter((entry): entry is ParsedDreamEntry => entry !== null),\n    );\n  }\n  return finalizeDreamEntries(parseLegacyHeadingEntries(normalized));\n}\n\nfunction renderDiary(entries: Array<Omit<DreamEntry, \"id\" | \"sourceOffset\">>): string {\n  const blocks = entries\n    .map((entry) => renderAppendBlock(entry))\n    .join(\"\\n\")\n    .trimEnd();\n  return [\n    \"# Dream Diary\",\n    \"\",\n    DIARY_START_MARKER,\n    blocks,\n    \"\",\n    DIARY_END_MARKER,\n    \"\",\n  ]\n    .filter((line, index, lines) => !(line === \"\" && lines[index - 1] === \"\"))\n    .join(\"\\n\");\n}\n\nfunction ensureDiary(content: string): string {\n  if (content.includes(DIARY_START_MARKER) && content.includes(DIARY_END_MARKER)) {\n    return content;\n  }\n  const legacyEntries = parseLegacyHeadingEntries(content.replace(/\\r\\n/g, \"\\n\"));\n  if (legacyEntries.length > 0) {\n    return renderDiary(\n      legacyEntries.map((entry) => ({\n        timestamp: entry.timestamp,\n        title: entry.title,\n        body: entry.body,\n        tags: entry.tags,\n      })),\n    );\n  }\n  return renderDiary([]);\n}\n\nfunction renderAppendBlock(entry: Omit<DreamEntry, \"id\" | \"sourceOffset\">): string {\n  const titlePart = entry.title?.trim() ? ` — ${entry.title.trim()}` : \"\";\n  const tagsPart = entry.tags.length > 0 ? `\\n\\nTags: ${entry.tags.map((tag) => `#${tag}`).join(\" \")}` : \"\";\n  return `---\\n\\n*${entry.timestamp}${titlePart}*\\n\\n${entry.body.trim()}${tagsPart}\\n`;\n}\n\nexport function createDreamsSurface(): DreamsSurface {\n  return {\n    async read(filePath: string): Promise<DreamEntry[]> {\n      try {\n        const content = await readFile(filePath, \"utf8\");\n        return parseDreamEntries(content);\n      } catch (error) {\n        if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n          return [];\n        }\n        throw error;\n      }\n    },\n\n    async append(\n      filePath: string,\n      entry: Omit<DreamEntry, \"id\" | \"sourceOffset\">,\n    ): Promise<DreamEntry> {\n      await mkdir(path.dirname(filePath), { recursive: true });\n      let content = \"\";\n      try {\n        content = await readFile(filePath, \"utf8\");\n      } catch (error) {\n        if ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n      }\n      const ensured = ensureDiary(content);\n      const endIndex = ensured.indexOf(DIARY_END_MARKER);\n      const block = renderAppendBlock(entry);\n      const updated =\n        endIndex >= 0\n          ? `${ensured.slice(0, endIndex)}${block}\\n${ensured.slice(endIndex)}`\n          : `${ensureDiary(\"\")}${block}`;\n      await writeFile(filePath, updated.endsWith(\"\\n\") ? updated : `${updated}\\n`, \"utf8\");\n      const entries = parseDreamEntries(updated);\n      return entries[entries.length - 1]!;\n    },\n\n    watch(filePath: string, onChange: (entries: DreamEntry[]) => void): () => void {\n      let fileWatcher: FSWatcher | null = null;\n      let parentWatcher: FSWatcher | null = null;\n      let timer: NodeJS.Timeout | null = null;\n      const watchedName = path.basename(filePath);\n      const watchedDir = path.dirname(filePath);\n\n      const resolveParentWatchTarget = (): { dir: string; expectedName: string } | null => {\n        let candidateDir = watchedDir;\n        while (true) {\n          try {\n            if (statSync(candidateDir).isDirectory()) {\n              const relative = path.relative(candidateDir, watchedDir);\n              return {\n                dir: candidateDir,\n                expectedName:\n                  relative.length === 0\n                    ? watchedName\n                    : (relative.split(path.sep)[0] ?? watchedName),\n              };\n            }\n          } catch {}\n          const parentDir = path.dirname(candidateDir);\n          if (parentDir === candidateDir) {\n            return null;\n          }\n          candidateDir = parentDir;\n        }\n      };\n\n      const rearmFileWatcher = () => {\n        fileWatcher?.close();\n        fileWatcher = null;\n        try {\n          fileWatcher = watch(filePath, { persistent: false }, emit);\n        } catch {\n          fileWatcher = null;\n        }\n      };\n\n      const ensureParentWatcher = () => {\n        if (parentWatcher) return;\n        const target = resolveParentWatchTarget();\n        if (!target) return;\n        try {\n          parentWatcher = watch(\n            target.dir,\n            { persistent: false },\n            (_eventType, changed) => {\n              if (changed && String(changed) !== target.expectedName) return;\n              parentWatcher?.close();\n              parentWatcher = null;\n              ensureParentWatcher();\n              rearmFileWatcher();\n              if (target.expectedName === watchedName || fileWatcher) {\n                emit();\n              }\n            },\n          );\n        } catch {\n          parentWatcher = null;\n        }\n      };\n\n      const emit = () => {\n        if (timer) clearTimeout(timer);\n        timer = setTimeout(async () => {\n          timer = null;\n          try {\n            rearmFileWatcher();\n            onChange(await this.read(filePath));\n          } catch (error) {\n            console.warn(\"[remnic] dreams surface watch update failed\", error);\n          }\n        }, 25);\n      };\n      rearmFileWatcher();\n      ensureParentWatcher();\n      return () => {\n        if (timer) clearTimeout(timer);\n        fileWatcher?.close();\n        parentWatcher?.close();\n      };\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/surfaces/heartbeat.d.ts

@@ -0,0 +1,17 @@
+interface HeartbeatEntry {
+    id: string;
+    slug: string;
+    title: string;
+    body: string;
+    schedule: string | null;
+    tags: string[];
+    sourceOffset: number;
+}
+interface HeartbeatSurface {
+    read(path: string): Promise<HeartbeatEntry[]>;
+    watch(path: string, onChange: (entries: HeartbeatEntry[]) => void): () => void;
+    findBySlug(entries: HeartbeatEntry[], slug: string): HeartbeatEntry | null;
+}
+declare function createHeartbeatSurface(): HeartbeatSurface;
+
+export { type HeartbeatEntry, type HeartbeatSurface, createHeartbeatSurface };