@remnic/core 1.0.0

package/dist/schemas.js

@@ -0,0 +1,51 @@
+import {
+  BehaviorLoopAdjustmentSchema,
+  BehaviorLoopPolicyStateSchema,
+  ConsolidationItemSchema,
+  ConsolidationResultSchema,
+  ContradictionVerificationSchema,
+  DaySummaryResultSchema,
+  EntityMentionSchema,
+  ExtractedFactSchema,
+  ExtractedQuestionSchema,
+  ExtractedRelationshipSchema,
+  ExtractionResultSchema,
+  IdentityConsolidationResultSchema,
+  MemoryActionEligibilityContextSchema,
+  MemoryActionTypeSchema,
+  MemoryLinkSchema,
+  MemorySummarySchema,
+  ProactiveExtractionResultSchema,
+  ProactiveQuestionsResultSchema,
+  ProfileConsolidationResultSchema,
+  SuggestedLinksSchema,
+  buildProfileConsolidationResultSchema,
+  parseMemoryActionEligibilityContext,
+  parseMemoryActionType
+} from "./chunk-MWGVGUIS.js";
+export {
+  BehaviorLoopAdjustmentSchema,
+  BehaviorLoopPolicyStateSchema,
+  ConsolidationItemSchema,
+  ConsolidationResultSchema,
+  ContradictionVerificationSchema,
+  DaySummaryResultSchema,
+  EntityMentionSchema,
+  ExtractedFactSchema,
+  ExtractedQuestionSchema,
+  ExtractedRelationshipSchema,
+  ExtractionResultSchema,
+  IdentityConsolidationResultSchema,
+  MemoryActionEligibilityContextSchema,
+  MemoryActionTypeSchema,
+  MemoryLinkSchema,
+  MemorySummarySchema,
+  ProactiveExtractionResultSchema,
+  ProactiveQuestionsResultSchema,
+  ProfileConsolidationResultSchema,
+  SuggestedLinksSchema,
+  buildProfileConsolidationResultSchema,
+  parseMemoryActionEligibilityContext,
+  parseMemoryActionType
+};
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/sdk-compat.d.ts

@@ -0,0 +1,21 @@
+interface SdkCapabilities {
+    /** api.on("before_prompt_build", ...) is available */
+    hasBeforePromptBuild: boolean;
+    /** api.registerMemoryPromptSection() exists */
+    hasRegisterMemoryPromptSection: boolean;
+    /** definePluginEntry from openclaw/plugin-sdk/plugin-entry is importable */
+    hasDefinePluginEntry: boolean;
+    /** api.runtime.* namespace exists */
+    hasRuntimeNamespace: boolean;
+    /** api.registrationMode is present */
+    hasRegistrationMode: boolean;
+    /** Hooks receive typed event/context objects */
+    hasTypedHooks: boolean;
+    /** Detected SDK version string, or "legacy" */
+    sdkVersion: string;
+    /** api.registrationMode value when present */
+    registrationMode: "full" | "setup-only" | "setup-runtime" | undefined;
+}
+declare function detectSdkCapabilities(api: Record<string, unknown>): SdkCapabilities;
+
+export { type SdkCapabilities, detectSdkCapabilities };

package/dist/sdk-compat.js

@@ -0,0 +1,28 @@
+import {
+  readEnvVar
+} from "./chunk-MARWOCVP.js";
+
+// src/sdk-compat.ts
+function detectSdkCapabilities(api) {
+  const hasRegisterMemoryPromptSection = typeof api.registerMemoryPromptSection === "function";
+  const hasRuntimeNamespace = typeof api.runtime === "object" && api.runtime !== null;
+  const hasRegistrationMode = typeof api.registrationMode === "string";
+  const sdkVersion = (hasRuntimeNamespace && typeof api.runtime?.version === "string" ? api.runtime.version : null) ?? readEnvVar("OPENCLAW_SERVICE_VERSION") ?? "legacy";
+  const isNewSdk = hasRegisterMemoryPromptSection || hasRuntimeNamespace || hasRegistrationMode;
+  const hasNewHookSystem = hasRegisterMemoryPromptSection || hasRegistrationMode;
+  return {
+    hasBeforePromptBuild: hasNewHookSystem,
+    hasRegisterMemoryPromptSection,
+    hasDefinePluginEntry: isNewSdk,
+    // entry point is less risky, keep broad detection
+    hasRuntimeNamespace,
+    hasRegistrationMode,
+    hasTypedHooks: hasNewHookSystem,
+    sdkVersion,
+    registrationMode: hasRegistrationMode ? api.registrationMode : void 0
+  };
+}
+export {
+  detectSdkCapabilities
+};
+//# sourceMappingURL=sdk-compat.js.map

package/dist/sdk-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sdk-compat.ts"],"sourcesContent":["/**\n * Runtime SDK capability detection.\n *\n * Probes the injected api object at registration time to determine which\n * OpenClaw SDK features are available. All hook registrations and entry-point\n * patterns branch on these flags so engram works on both old (≤2026.3.13)\n * and new (≥2026.3.22) runtimes.\n */\nimport { readEnvVar } from \"./runtime/env.js\";\n\nexport interface SdkCapabilities {\n  /** api.on(\"before_prompt_build\", ...) is available */\n  hasBeforePromptBuild: boolean;\n  /** api.registerMemoryPromptSection() exists */\n  hasRegisterMemoryPromptSection: boolean;\n  /** definePluginEntry from openclaw/plugin-sdk/plugin-entry is importable */\n  hasDefinePluginEntry: boolean;\n  /** api.runtime.* namespace exists */\n  hasRuntimeNamespace: boolean;\n  /** api.registrationMode is present */\n  hasRegistrationMode: boolean;\n  /** Hooks receive typed event/context objects */\n  hasTypedHooks: boolean;\n  /** Detected SDK version string, or \"legacy\" */\n  sdkVersion: string;\n  /** api.registrationMode value when present */\n  registrationMode: \"full\" | \"setup-only\" | \"setup-runtime\" | undefined;\n}\n\nexport function detectSdkCapabilities(api: Record<string, unknown>): SdkCapabilities {\n  const hasRegisterMemoryPromptSection =\n    typeof (api as any).registerMemoryPromptSection === \"function\";\n  const hasRuntimeNamespace =\n    typeof (api as any).runtime === \"object\" && (api as any).runtime !== null;\n  const hasRegistrationMode = typeof (api as any).registrationMode === \"string\";\n\n  const sdkVersion: string =\n    (hasRuntimeNamespace && typeof (api as any).runtime?.version === \"string\"\n      ? (api as any).runtime.version\n      : null) ??\n    readEnvVar(\"OPENCLAW_SERVICE_VERSION\") ??\n    \"legacy\";\n\n  // New SDK is indicated by any of the new API surfaces being present.\n  const isNewSdk =\n    hasRegisterMemoryPromptSection || hasRuntimeNamespace || hasRegistrationMode;\n\n  // New hook system requires registerMemoryPromptSection or registrationMode.\n  // Just having runtime.version is NOT sufficient — some legacy builds expose it.\n  const hasNewHookSystem = hasRegisterMemoryPromptSection || hasRegistrationMode;\n\n  return {\n    hasBeforePromptBuild: hasNewHookSystem,\n    hasRegisterMemoryPromptSection,\n    hasDefinePluginEntry: isNewSdk, // entry point is less risky, keep broad detection\n    hasRuntimeNamespace,\n    hasRegistrationMode,\n    hasTypedHooks: hasNewHookSystem,\n    sdkVersion,\n    registrationMode: hasRegistrationMode\n      ? ((api as any).registrationMode as SdkCapabilities[\"registrationMode\"])\n      : undefined,\n  };\n}\n"],"mappings":";;;;;AA6BO,SAAS,sBAAsB,KAA+C;AACnF,QAAM,iCACJ,OAAQ,IAAY,gCAAgC;AACtD,QAAM,sBACJ,OAAQ,IAAY,YAAY,YAAa,IAAY,YAAY;AACvE,QAAM,sBAAsB,OAAQ,IAAY,qBAAqB;AAErE,QAAM,cACH,uBAAuB,OAAQ,IAAY,SAAS,YAAY,WAC5D,IAAY,QAAQ,UACrB,SACJ,WAAW,0BAA0B,KACrC;AAGF,QAAM,WACJ,kCAAkC,uBAAuB;AAI3D,QAAM,mBAAmB,kCAAkC;AAE3D,SAAO;AAAA,IACL,sBAAsB;AAAA,IACtB;AAAA,IACA,sBAAsB;AAAA;AAAA,IACtB;AAAA,IACA;AAAA,IACA,eAAe;AAAA,IACf;AAAA,IACA,kBAAkB,sBACZ,IAAY,mBACd;AAAA,EACN;AACF;","names":[]}

package/dist/semantic-consolidation.d.ts

@@ -0,0 +1,42 @@
+import { MemoryFile } from './types.js';
+
+/**
+ * semantic-consolidation.ts — Semantic Consolidation Engine
+ *
+ * Finds clusters of semantically similar memories using token overlap,
+ * synthesizes canonical versions via LLM, and archives the originals.
+ * Reduces memory store bloat while preserving all unique information.
+ */
+
+interface ConsolidationCluster {
+    category: string;
+    memories: MemoryFile[];
+    overlapScore: number;
+    canonicalContent?: string;
+}
+interface SemanticConsolidationResult {
+    clustersFound: number;
+    memoriesConsolidated: number;
+    memoriesArchived: number;
+    errors: number;
+    clusters: ConsolidationCluster[];
+}
+/**
+ * Find clusters of semantically similar memories using token overlap.
+ */
+declare function findSimilarClusters(memories: MemoryFile[], config: {
+    threshold: number;
+    minClusterSize: number;
+    excludeCategories: string[];
+    maxPerRun: number;
+}): ConsolidationCluster[];
+/**
+ * Build the LLM prompt for synthesizing a canonical memory from a cluster.
+ */
+declare function buildConsolidationPrompt(cluster: ConsolidationCluster): string;
+/**
+ * Parse the LLM response to extract the canonical content.
+ */
+declare function parseConsolidationResponse(response: string): string;
+
+export { type ConsolidationCluster, type SemanticConsolidationResult, buildConsolidationPrompt, findSimilarClusters, parseConsolidationResponse };

package/dist/semantic-consolidation.js

@@ -0,0 +1,12 @@
+import {
+  buildConsolidationPrompt,
+  findSimilarClusters,
+  parseConsolidationResponse
+} from "./chunk-2CJCWDMR.js";
+import "./chunk-DT5TVLJE.js";
+export {
+  buildConsolidationPrompt,
+  findSimilarClusters,
+  parseConsolidationResponse
+};
+//# sourceMappingURL=semantic-consolidation.js.map

package/dist/semantic-consolidation.js.map

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

package/dist/semantic-rule-promotion.d.ts

@@ -0,0 +1,28 @@
+interface SemanticRulePromotionCandidate {
+    id: string;
+    sourceMemoryId: string;
+    content: string;
+    confidence: number;
+    tags: string[];
+    memoryKind: "note";
+    lineage: string[];
+}
+interface SemanticRulePromotionSkip {
+    sourceMemoryId: string;
+    reason: "disabled" | "source-memory-missing" | "source-memory-not-episode" | "no-explicit-rule" | "duplicate-rule";
+    existingRuleId?: string;
+}
+interface SemanticRulePromotionReport {
+    enabled: boolean;
+    dryRun: boolean;
+    promoted: SemanticRulePromotionCandidate[];
+    skipped: SemanticRulePromotionSkip[];
+}
+declare function promoteSemanticRuleFromMemory(options: {
+    memoryDir: string;
+    enabled: boolean;
+    sourceMemoryId: string;
+    dryRun?: boolean;
+}): Promise<SemanticRulePromotionReport>;
+
+export { type SemanticRulePromotionCandidate, type SemanticRulePromotionReport, type SemanticRulePromotionSkip, promoteSemanticRuleFromMemory };

package/dist/semantic-rule-promotion.js

@@ -0,0 +1,17 @@
+import {
+  promoteSemanticRuleFromMemory
+} from "./chunk-L7WO3MZ4.js";
+import "./chunk-QWUUMMIK.js";
+import "./chunk-U4PV25RD.js";
+import "./chunk-ESSMF2FR.js";
+import "./chunk-TP4FZJIZ.js";
+import "./chunk-SCU65EZI.js";
+import "./chunk-BOUYNNYD.js";
+import "./chunk-DM2T26WE.js";
+import "./chunk-QSVPYQPG.js";
+import "./chunk-M62O4P4T.js";
+import "./chunk-KWBU5S5U.js";
+export {
+  promoteSemanticRuleFromMemory
+};
+//# sourceMappingURL=semantic-rule-promotion.js.map

package/dist/semantic-rule-promotion.js.map

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

package/dist/semantic-rule-verifier.d.ts

@@ -0,0 +1,19 @@
+import { MemoryFile } from './types.js';
+
+type SemanticRuleVerificationStatus = "verified" | "source-memory-missing" | "source-memory-archived" | "source-memory-not-episode";
+interface VerifiedSemanticRuleResult {
+    rule: MemoryFile;
+    score: number;
+    sourceMemoryId: string;
+    verificationStatus: SemanticRuleVerificationStatus;
+    effectiveConfidence: number;
+    matchedFields: string[];
+}
+declare function searchVerifiedSemanticRules(options: {
+    memoryDir: string;
+    query: string;
+    maxResults: number;
+    minEffectiveConfidence?: number;
+}): Promise<VerifiedSemanticRuleResult[]>;
+
+export { type SemanticRuleVerificationStatus, type VerifiedSemanticRuleResult, searchVerifiedSemanticRules };

package/dist/semantic-rule-verifier.js

@@ -0,0 +1,18 @@
+import {
+  searchVerifiedSemanticRules
+} from "./chunk-J47FNDR7.js";
+import "./chunk-QWUUMMIK.js";
+import "./chunk-U4PV25RD.js";
+import "./chunk-ESSMF2FR.js";
+import "./chunk-TP4FZJIZ.js";
+import "./chunk-SCU65EZI.js";
+import "./chunk-BOUYNNYD.js";
+import "./chunk-DM2T26WE.js";
+import "./chunk-QSVPYQPG.js";
+import "./chunk-M62O4P4T.js";
+import "./chunk-DT5TVLJE.js";
+import "./chunk-KWBU5S5U.js";
+export {
+  searchVerifiedSemanticRules
+};
+//# sourceMappingURL=semantic-rule-verifier.js.map

package/dist/semantic-rule-verifier.js.map

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

package/dist/session-integrity.d.ts

@@ -0,0 +1,67 @@
+type SessionIntegrityIssueCode = "transcript_malformed_line" | "transcript_invalid_entry" | "transcript_duplicate_turn_id" | "transcript_broken_chain" | "transcript_incomplete_turn" | "checkpoint_missing" | "checkpoint_invalid_json" | "checkpoint_invalid_metadata" | "checkpoint_expired";
+interface SessionIntegrityIssue {
+    code: SessionIntegrityIssueCode;
+    severity: "info" | "warn" | "error";
+    message: string;
+    filePath?: string;
+    line?: number;
+    sessionKey?: string;
+}
+interface SessionTranscriptStats {
+    sessionKey: string;
+    entries: number;
+    malformedLines: number;
+    invalidEntries: number;
+    duplicateTurnIds: number;
+    brokenChains: number;
+    incompleteTurns: number;
+}
+interface SessionIntegrityReport {
+    generatedAt: string;
+    memoryDir: string;
+    healthy: boolean;
+    sessions: SessionTranscriptStats[];
+    checkpoint: {
+        present: boolean;
+        healthy: boolean;
+        path: string;
+        sessionKey?: string;
+        expiresAt?: string;
+    };
+    issues: SessionIntegrityIssue[];
+}
+interface SessionRepairAction {
+    kind: "rewrite_transcript" | "remove_checkpoint" | "repair_session_files";
+    description: string;
+    targetPath: string;
+    details?: string;
+}
+interface SessionRepairPlan {
+    generatedAt: string;
+    dryRun: boolean;
+    allowSessionFileRepair: boolean;
+    actions: SessionRepairAction[];
+}
+interface SessionRepairApplyResult {
+    applied: boolean;
+    actionsAttempted: number;
+    actionsApplied: number;
+    errors: string[];
+}
+interface AnalyzeSessionIntegrityOptions {
+    memoryDir: string;
+}
+interface PlanSessionRepairOptions {
+    report: SessionIntegrityReport;
+    dryRun: boolean;
+    allowSessionFileRepair?: boolean;
+    sessionFilesDir?: string;
+}
+interface ApplySessionRepairOptions {
+    plan: SessionRepairPlan;
+}
+declare function analyzeSessionIntegrity(options: AnalyzeSessionIntegrityOptions): Promise<SessionIntegrityReport>;
+declare function planSessionRepair(options: PlanSessionRepairOptions): SessionRepairPlan;
+declare function applySessionRepair(options: ApplySessionRepairOptions): Promise<SessionRepairApplyResult>;
+
+export { type AnalyzeSessionIntegrityOptions, type ApplySessionRepairOptions, type PlanSessionRepairOptions, type SessionIntegrityIssue, type SessionIntegrityIssueCode, type SessionIntegrityReport, type SessionRepairAction, type SessionRepairApplyResult, type SessionRepairPlan, type SessionTranscriptStats, analyzeSessionIntegrity, applySessionRepair, planSessionRepair };

package/dist/session-integrity.js

@@ -0,0 +1,11 @@
+import {
+  analyzeSessionIntegrity,
+  applySessionRepair,
+  planSessionRepair
+} from "./chunk-YRMVARQP.js";
+export {
+  analyzeSessionIntegrity,
+  applySessionRepair,
+  planSessionRepair
+};
+//# sourceMappingURL=session-integrity.js.map

package/dist/session-integrity.js.map

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

package/dist/session-observer-bands.d.ts

@@ -0,0 +1,6 @@
+import { SessionObserverBandConfig } from './types.js';
+
+declare const DEFAULT_SESSION_OBSERVER_BANDS: SessionObserverBandConfig[];
+declare function cloneDefaultSessionObserverBands(): SessionObserverBandConfig[];
+
+export { DEFAULT_SESSION_OBSERVER_BANDS, cloneDefaultSessionObserverBands };

package/dist/session-observer-bands.js

@@ -0,0 +1,9 @@
+import {
+  DEFAULT_SESSION_OBSERVER_BANDS,
+  cloneDefaultSessionObserverBands
+} from "./chunk-Z5LAYHGJ.js";
+export {
+  DEFAULT_SESSION_OBSERVER_BANDS,
+  cloneDefaultSessionObserverBands
+};
+//# sourceMappingURL=session-observer-bands.js.map

package/dist/session-observer-bands.js.map

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

package/dist/session-observer-state.d.ts

@@ -0,0 +1,40 @@
+import { SessionObserverBandConfig } from './types.js';
+
+interface SessionObservationInput {
+    sessionKey: string;
+    totalBytes: number;
+    totalTokens: number;
+    observedAt?: string;
+}
+interface SessionObservationDecision {
+    triggered: boolean;
+    deltaBytes: number;
+    deltaTokens: number;
+    band: SessionObserverBandConfig;
+    reason?: "threshold" | "debounced" | "baseline";
+}
+declare function normalizeObserverBands(bands: SessionObserverBandConfig[]): SessionObserverBandConfig[];
+declare class SessionObserverState {
+    private readonly statePath;
+    private readonly lockPath;
+    private readonly lockStaleMs;
+    private readonly debounceMs;
+    private readonly bands;
+    private sessions;
+    private saveQueue;
+    private readPersistedState;
+    private normalizePersistedSessions;
+    constructor(opts: {
+        memoryDir: string;
+        debounceMs: number;
+        bands: SessionObserverBandConfig[];
+    });
+    private withSaveLock;
+    load(): Promise<void>;
+    save(): Promise<void>;
+    private enqueueSave;
+    private bandForTotalBytes;
+    observe(input: SessionObservationInput): Promise<SessionObservationDecision>;
+}
+
+export { type SessionObservationDecision, type SessionObservationInput, SessionObserverState, normalizeObserverBands };

package/dist/session-observer-state.js

@@ -0,0 +1,11 @@
+import {
+  SessionObserverState,
+  normalizeObserverBands
+} from "./chunk-ZKYI7UVO.js";
+import "./chunk-Z5LAYHGJ.js";
+import "./chunk-KWBU5S5U.js";
+export {
+  SessionObserverState,
+  normalizeObserverBands
+};
+//# sourceMappingURL=session-observer-state.js.map

package/dist/session-observer-state.js.map

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

package/dist/signal.d.ts

@@ -0,0 +1,6 @@
+import { SignalScanResult } from './types.js';
+
+declare function isDisagreementPrompt(text: string): boolean;
+declare function scanSignals(text: string, customPatterns?: string[]): SignalScanResult;
+
+export { isDisagreementPrompt, scanSignals };

package/dist/signal.js

@@ -0,0 +1,9 @@
+import {
+  isDisagreementPrompt,
+  scanSignals
+} from "./chunk-XYIK4LF6.js";
+export {
+  isDisagreementPrompt,
+  scanSignals
+};
+//# sourceMappingURL=signal.js.map

package/dist/signal.js.map

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