@framers/agentos 0.1.181 → 0.1.183

package/dist/core/validation/extractJson.js

@@ -0,0 +1,179 @@
+/**
+ * @fileoverview Centralized JSON extraction from messy LLM output.
+ *
+ * LLMs return structured data in many formats: raw JSON, markdown-fenced
+ * blocks, JSON wrapped in prose, JSONL, or JSON preceded by chain-of-thought
+ * `<thinking>` blocks. This module handles all of them with a priority-ordered
+ * extraction pipeline.
+ *
+ * Replaces the ad-hoc `JSON.parse` + `match()` + `split('\n')` patterns
+ * duplicated across 30+ files in AgentOS and wilds-ai.
+ *
+ * @module agentos/core/validation/extractJson
+ */
+/**
+ * Extract JSON from raw LLM output text.
+ *
+ * Tries multiple extraction strategies in priority order:
+ * 1. Raw JSON (entire string is valid JSON)
+ * 2. Markdown fenced blocks (```json ... ``` or ``` ... ```)
+ * 3. Strip `<thinking>` blocks, then retry
+ * 4. First `{...}` or `[...]` via greedy brace/bracket matching
+ * 5. JSONL (multiple JSON objects on separate lines → array)
+ *
+ * @param rawText - Raw LLM output that may contain JSON
+ * @returns Extracted JSON string, or null if no valid JSON found
+ *
+ * @example
+ * ```ts
+ * extractJson('```json\n{"key": "value"}\n```') // '{"key": "value"}'
+ * extractJson('<thinking>hmm</thinking>\n{"a":1}') // '{"a":1}'
+ * extractJson('no json here') // null
+ * ```
+ */
+export function extractJson(rawText) {
+    if (!rawText || rawText.trim().length === 0)
+        return null;
+    const trimmed = rawText.trim();
+    // Strategy 1: Raw JSON — entire string is valid JSON
+    if ((trimmed.startsWith('{') && trimmed.endsWith('}')) ||
+        (trimmed.startsWith('[') && trimmed.endsWith(']'))) {
+        try {
+            JSON.parse(trimmed);
+            return trimmed;
+        }
+        catch {
+            // Not valid raw JSON — fall through to other strategies
+        }
+    }
+    // Strategy 2: Markdown fenced blocks — ```json ... ``` or ``` ... ```
+    const fencedMatch = trimmed.match(/```(?:json)?\s*\n([\s\S]*?)\n\s*```/);
+    if (fencedMatch) {
+        const content = fencedMatch[1].trim();
+        try {
+            JSON.parse(content);
+            return content;
+        }
+        catch {
+            // Fenced block wasn't valid JSON — fall through
+        }
+    }
+    // Strategy 3: Strip <thinking>...</thinking> blocks, then retry.
+    // Chain-of-thought reasoning often precedes the actual JSON output.
+    if (trimmed.includes('<thinking>')) {
+        const stripped = trimmed.replace(/<thinking>[\s\S]*?<\/thinking>/gi, '').trim();
+        if (stripped.length > 0 && stripped !== trimmed) {
+            const result = extractJson(stripped);
+            if (result)
+                return result;
+        }
+    }
+    // Strategy 4: JSONL — multiple JSON objects on separate lines.
+    // Common in MemoryObserver and MemoryReflector output where the LLM
+    // outputs one JSON object per observation/trace on its own line.
+    // Checked BEFORE brace matching so multi-line output isn't truncated
+    // to just the first object.
+    const lines = trimmed.split('\n').filter((l) => l.trim());
+    if (lines.length >= 2) {
+        const jsonObjects = [];
+        for (const line of lines) {
+            const clean = line.trim();
+            try {
+                const parsed = JSON.parse(clean);
+                if (typeof parsed === 'object' && parsed !== null) {
+                    jsonObjects.push(parsed);
+                }
+            }
+            catch {
+                // Skip non-JSON lines (common in LLM output with commentary)
+            }
+        }
+        if (jsonObjects.length >= 2) {
+            return JSON.stringify(jsonObjects);
+        }
+    }
+    // Strategy 5: First {...} or [...] via greedy brace/bracket matching.
+    // Handles JSON embedded in prose like "Here is the result: {...} done."
+    const braceResult = extractByBraceMatching(trimmed);
+    if (braceResult)
+        return braceResult;
+    return null;
+}
+/**
+ * Extract the first balanced JSON object or array from text using
+ * brace/bracket depth counting. Handles nested structures and
+ * string escaping correctly.
+ *
+ * @param text - Text that may contain embedded JSON
+ * @returns Extracted JSON string, or null if no balanced structure found
+ */
+function extractByBraceMatching(text) {
+    // Find the first { or [
+    const objectStart = text.indexOf('{');
+    const arrayStart = text.indexOf('[');
+    // Pick whichever comes first
+    let start;
+    let openChar;
+    let closeChar;
+    if (objectStart === -1 && arrayStart === -1)
+        return null;
+    if (objectStart === -1) {
+        start = arrayStart;
+        openChar = '[';
+        closeChar = ']';
+    }
+    else if (arrayStart === -1) {
+        start = objectStart;
+        openChar = '{';
+        closeChar = '}';
+    }
+    else if (objectStart <= arrayStart) {
+        start = objectStart;
+        openChar = '{';
+        closeChar = '}';
+    }
+    else {
+        start = arrayStart;
+        openChar = '[';
+        closeChar = ']';
+    }
+    // Walk forward counting depth, handling string escaping.
+    // This correctly handles nested {"a": {"b": [1, 2]}} structures
+    // and escaped quotes inside strings like {"content": "she said \"hello\""}.
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let i = start; i < text.length; i++) {
+        const ch = text[i];
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (ch === '\\' && inString) {
+            escaped = true;
+            continue;
+        }
+        if (ch === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (inString)
+            continue;
+        if (ch === openChar)
+            depth++;
+        if (ch === closeChar)
+            depth--;
+        if (depth === 0) {
+            const candidate = text.slice(start, i + 1);
+            try {
+                JSON.parse(candidate);
+                return candidate;
+            }
+            catch {
+                return null;
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=extractJson.js.map

package/dist/core/validation/extractJson.js.map

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

package/dist/core/validation/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview LLM output validation layer for AgentOS.
+ *
+ * Provides Zod-based validation, retry, and JSON extraction for
+ * structured LLM outputs. Use `createValidatedInvoker()` to wrap
+ * any LLM invoker with automatic validation and retry.
+ *
+ * @module agentos/core/validation
+ */
+export { extractJson } from './extractJson.js';
+export { LlmOutputValidationError, type ValidationRetryRecord } from './errors.js';
+export { createValidatedInvoker, type LlmInvokerWithCapabilities, type ValidatedInvokerOptions, } from './ValidatedLlmInvoker.js';
+export * from './schema-primitives.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EACL,sBAAsB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,GAC7B,MAAM,0BAA0B,CAAC;AAClC,cAAc,wBAAwB,CAAC"}

package/dist/core/validation/index.js

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview LLM output validation layer for AgentOS.
+ *
+ * Provides Zod-based validation, retry, and JSON extraction for
+ * structured LLM outputs. Use `createValidatedInvoker()` to wrap
+ * any LLM invoker with automatic validation and retry.
+ *
+ * @module agentos/core/validation
+ */
+export { extractJson } from './extractJson.js';
+export { LlmOutputValidationError } from './errors.js';
+export { createValidatedInvoker, } from './ValidatedLlmInvoker.js';
+export * from './schema-primitives.js';
+//# sourceMappingURL=index.js.map

package/dist/core/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAA8B,MAAM,aAAa,CAAC;AACnF,OAAO,EACL,sBAAsB,GAGvB,MAAM,0BAA0B,CAAC;AAClC,cAAc,wBAAwB,CAAC"}

package/dist/core/validation/schema-primitives.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @fileoverview Shared Zod building blocks for LLM output schemas.
+ *
+ * Call sites compose domain-specific schemas from these primitives
+ * rather than duplicating enum definitions and field validators.
+ * The primitives file is intentionally small — it provides reusable
+ * atoms, not complete schemas for every use case.
+ *
+ * @example
+ * ```ts
+ * import { MemoryTypeEnum, ConfidenceScore, EntityArray } from '../../core/validation';
+ *
+ * const MySchema = z.object({
+ *   type: MemoryTypeEnum,
+ *   confidence: ConfidenceScore,
+ *   entities: EntityArray,
+ *   myCustomField: z.string(),
+ * });
+ * ```
+ *
+ * @module agentos/core/validation/schema-primitives
+ */
+import { z } from 'zod';
+/**
+ * Tulving's LTM taxonomy extended with relational memory.
+ * - episodic: autobiographical events and experiences
+ * - semantic: general knowledge and facts
+ * - procedural: how-to knowledge and behavioral patterns
+ * - prospective: future intentions and triggered reminders
+ * - relational: trust signals, boundary events, emotional bonds
+ */
+export declare const MemoryTypeEnum: z.ZodEnum<{
+    semantic: "semantic";
+    episodic: "episodic";
+    procedural: "procedural";
+    prospective: "prospective";
+    relational: "relational";
+}>;
+/**
+ * Memory visibility/ownership scope.
+ * - user: about the user (persists across conversations)
+ * - thread: conversation-specific (ephemeral)
+ * - persona: about the agent itself
+ * - organization: shared across agents
+ */
+export declare const MemoryScopeEnum: z.ZodEnum<{
+    user: "user";
+    organization: "organization";
+    thread: "thread";
+    persona: "persona";
+}>;
+/** Confidence or strength score, clamped to [0, 1]. */
+export declare const ConfidenceScore: z.ZodNumber;
+/** Array of entity name strings, defaults to empty. */
+export declare const EntityArray: z.ZodDefault<z.ZodArray<z.ZodString>>;
+/** Array of tag strings, defaults to empty. */
+export declare const TagArray: z.ZodDefault<z.ZodArray<z.ZodString>>;
+/** Importance score, clamped to [0, 1], defaults to 0.5. */
+export declare const ImportanceScore: z.ZodDefault<z.ZodNumber>;
+/**
+ * Schema for a single observation note extracted by MemoryObserver.
+ * The Observer LLM produces these as JSONL (one per line).
+ */
+export declare const ObservationNoteOutput: z.ZodObject<{
+    type: z.ZodEnum<{
+        preference: "preference";
+        factual: "factual";
+        emotional: "emotional";
+        commitment: "commitment";
+        creative: "creative";
+        correction: "correction";
+    }>;
+    content: z.ZodString;
+    importance: z.ZodDefault<z.ZodNumber>;
+    entities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for a single reflection trace produced by MemoryReflector.
+ * The Reflector consolidates observation notes into typed long-term traces.
+ */
+export declare const ReflectionTraceOutput: z.ZodObject<{
+    reasoning: z.ZodOptional<z.ZodString>;
+    type: z.ZodEnum<{
+        semantic: "semantic";
+        episodic: "episodic";
+        procedural: "procedural";
+        prospective: "prospective";
+        relational: "relational";
+    }>;
+    scope: z.ZodEnum<{
+        user: "user";
+        organization: "organization";
+        thread: "thread";
+        persona: "persona";
+    }>;
+    scopeId: z.ZodDefault<z.ZodString>;
+    content: z.ZodString;
+    entities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    confidence: z.ZodNumber;
+    sourceType: z.ZodDefault<z.ZodEnum<{
+        observation: "observation";
+        reflection: "reflection";
+    }>>;
+    supersedes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    consumedNotes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for a compressed observation from ObservationCompressor.
+ * Compresses N raw notes into a dense summary.
+ */
+export declare const CompressedObservationOutput: z.ZodObject<{
+    summary: z.ZodString;
+    importance: z.ZodDefault<z.ZodNumber>;
+    entities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    noteIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for content feature detection (LLM strategy).
+ * Used by ContentFeatureDetector when `featureDetectionStrategy === 'llm'`.
+ */
+export declare const ContentFeaturesOutput: z.ZodObject<{
+    hasNovelty: z.ZodDefault<z.ZodBoolean>;
+    hasProcedure: z.ZodDefault<z.ZodBoolean>;
+    hasEmotion: z.ZodDefault<z.ZodBoolean>;
+    hasSocialContent: z.ZodDefault<z.ZodBoolean>;
+    hasCooperation: z.ZodDefault<z.ZodBoolean>;
+    hasEthicalContent: z.ZodDefault<z.ZodBoolean>;
+    hasContradiction: z.ZodDefault<z.ZodBoolean>;
+    topicRelevance: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+//# sourceMappingURL=schema-primitives.d.ts.map

package/dist/core/validation/schema-primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-primitives.d.ts","sourceRoot":"","sources":["../../../src/core/validation/schema-primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;EAMzB,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;;;;EAK1B,CAAC;AAIH,uDAAuD;AACvD,eAAO,MAAM,eAAe,aAA2B,CAAC;AAExD,uDAAuD;AACvD,eAAO,MAAM,WAAW,uCAAkC,CAAC;AAE3D,+CAA+C;AAC/C,eAAO,MAAM,QAAQ,uCAAkC,CAAC;AAExD,4DAA4D;AAC5D,eAAO,MAAM,eAAe,2BAAwC,CAAC;AAIrE;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;iBAShC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuBhC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;iBAStC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;iBAiBhC,CAAC"}

package/dist/core/validation/schema-primitives.js

@@ -0,0 +1,141 @@
+/**
+ * @fileoverview Shared Zod building blocks for LLM output schemas.
+ *
+ * Call sites compose domain-specific schemas from these primitives
+ * rather than duplicating enum definitions and field validators.
+ * The primitives file is intentionally small — it provides reusable
+ * atoms, not complete schemas for every use case.
+ *
+ * @example
+ * ```ts
+ * import { MemoryTypeEnum, ConfidenceScore, EntityArray } from '../../core/validation/index.js';
+ *
+ * const MySchema = z.object({
+ *   type: MemoryTypeEnum,
+ *   confidence: ConfidenceScore,
+ *   entities: EntityArray,
+ *   myCustomField: z.string(),
+ * });
+ * ```
+ *
+ * @module agentos/core/validation/schema-primitives
+ */
+import { z } from 'zod';
+// ── Memory type enums ────────────────────────────────────────────────────
+/**
+ * Tulving's LTM taxonomy extended with relational memory.
+ * - episodic: autobiographical events and experiences
+ * - semantic: general knowledge and facts
+ * - procedural: how-to knowledge and behavioral patterns
+ * - prospective: future intentions and triggered reminders
+ * - relational: trust signals, boundary events, emotional bonds
+ */
+export const MemoryTypeEnum = z.enum([
+    'episodic',
+    'semantic',
+    'procedural',
+    'prospective',
+    'relational',
+]);
+/**
+ * Memory visibility/ownership scope.
+ * - user: about the user (persists across conversations)
+ * - thread: conversation-specific (ephemeral)
+ * - persona: about the agent itself
+ * - organization: shared across agents
+ */
+export const MemoryScopeEnum = z.enum([
+    'user',
+    'thread',
+    'persona',
+    'organization',
+]);
+// ── Common field validators ──────────────────────────────────────────────
+/** Confidence or strength score, clamped to [0, 1]. */
+export const ConfidenceScore = z.number().min(0).max(1);
+/** Array of entity name strings, defaults to empty. */
+export const EntityArray = z.array(z.string()).default([]);
+/** Array of tag strings, defaults to empty. */
+export const TagArray = z.array(z.string()).default([]);
+/** Importance score, clamped to [0, 1], defaults to 0.5. */
+export const ImportanceScore = z.number().min(0).max(1).default(0.5);
+// ── Composite schemas for AgentOS memory pipeline ────────────────────────
+/**
+ * Schema for a single observation note extracted by MemoryObserver.
+ * The Observer LLM produces these as JSONL (one per line).
+ */
+export const ObservationNoteOutput = z.object({
+    /** Observation category. */
+    type: z.enum(['factual', 'emotional', 'commitment', 'preference', 'creative', 'correction']),
+    /** Brief summary of the observation (1-2 sentences max). */
+    content: z.string().min(1),
+    /** How important this observation is for future recall (0-1). */
+    importance: ImportanceScore,
+    /** Key entities mentioned in the observation. */
+    entities: EntityArray,
+});
+/**
+ * Schema for a single reflection trace produced by MemoryReflector.
+ * The Reflector consolidates observation notes into typed long-term traces.
+ */
+export const ReflectionTraceOutput = z.object({
+    /** Chain-of-thought reasoning for why this trace matters (devtools only). */
+    reasoning: z.string().optional(),
+    /** Memory type classification (Tulving's taxonomy + relational). */
+    type: MemoryTypeEnum,
+    /** Memory scope for access control. */
+    scope: MemoryScopeEnum,
+    /** Scope identifier (e.g., user ID, thread ID). */
+    scopeId: z.string().default(''),
+    /** Consolidated memory content. */
+    content: z.string().min(1),
+    /** Entities referenced in this memory. */
+    entities: EntityArray,
+    /** Descriptive tags for retrieval filtering. */
+    tags: TagArray,
+    /** Confidence in this memory's accuracy (0-1). */
+    confidence: ConfidenceScore,
+    /** How this trace was produced. */
+    sourceType: z.enum(['observation', 'reflection']).default('reflection'),
+    /** IDs of existing traces that this trace supersedes (conflict resolution). */
+    supersedes: z.array(z.string()).default([]),
+    /** IDs of observation notes consumed to produce this trace. */
+    consumedNotes: z.array(z.string()).default([]),
+});
+/**
+ * Schema for a compressed observation from ObservationCompressor.
+ * Compresses N raw notes into a dense summary.
+ */
+export const CompressedObservationOutput = z.object({
+    /** Dense summary of multiple observation notes. */
+    summary: z.string().min(1),
+    /** Aggregate importance of the compressed observations. */
+    importance: ImportanceScore,
+    /** Entities across all compressed notes. */
+    entities: EntityArray,
+    /** IDs of the raw notes that were compressed. */
+    noteIds: z.array(z.string()).default([]),
+});
+/**
+ * Schema for content feature detection (LLM strategy).
+ * Used by ContentFeatureDetector when `featureDetectionStrategy === 'llm'`.
+ */
+export const ContentFeaturesOutput = z.object({
+    /** Content contains novel or surprising information. */
+    hasNovelty: z.boolean().default(false),
+    /** Content contains procedural/how-to knowledge. */
+    hasProcedure: z.boolean().default(false),
+    /** Content has emotional charge or sentiment. */
+    hasEmotion: z.boolean().default(false),
+    /** Content involves social interactions or relationships. */
+    hasSocialContent: z.boolean().default(false),
+    /** Content involves cooperative or collaborative themes. */
+    hasCooperation: z.boolean().default(false),
+    /** Content involves ethical or moral considerations. */
+    hasEthicalContent: z.boolean().default(false),
+    /** Content contradicts previously known information. */
+    hasContradiction: z.boolean().default(false),
+    /** Relevance to current task or conversation (0-1). */
+    topicRelevance: z.number().min(0).max(1).default(0.5),
+});
+//# sourceMappingURL=schema-primitives.js.map

package/dist/core/validation/schema-primitives.js.map

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

package/dist/memory/AgentMemory.d.ts

@@ -30,7 +30,7 @@
  *
  * @module agentos/memory/AgentMemory
  */
-import type { MemoryTrace, MemoryType, MemoryScope, MemorySourceType, ScoredMemoryTrace, AssembledMemoryContext, MemoryHealthReport, CognitiveRetrievalResult } from './core/types.js';
+import type { MemoryTrace, MemoryType, MemoryScope, MemorySourceType, ScoredMemoryTrace, AssembledMemoryContext, MemoryHealthReport, CognitiveRetrievalResult, WorkingMemorySlot, MemoryGraphSnapshot, ObservationPipelineStats, CognitiveMemorySnapshot, MemoryTypeStats } from './core/types.js';
 import type { CognitiveMemoryConfig } from './core/config.js';
 import type { ICognitiveMemoryManager } from './CognitiveMemoryManager.js';
 import type { ObservationNote } from './pipeline/observation/MemoryObserver.js';
@@ -171,6 +171,123 @@ export declare class AgentMemory {
      * standalone SQLite-first Memory facade.
      */
     feedback(traceId: string, signal: 'used' | 'ignored', query?: string): void;
+    /**
+     * Get a serializable snapshot of the memory graph for visualization.
+     * Returns nodes (traces), edges (associations), clusters, and aggregate stats.
+     *
+     * @throws When backed by standalone SQLite (requires CognitiveMemoryManager)
+     * @returns Graph snapshot suitable for JSON serialization
+     */
+    getGraph(): Promise<MemoryGraphSnapshot>;
+    /**
+     * Get spreading activation results from seed memories.
+     * Returns memories that are associatively connected to the seeds.
+     *
+     * @param seedTraceIds - IDs of seed traces to activate from
+     * @param opts - Optional depth and limit controls
+     * @throws When backed by standalone SQLite
+     */
+    getAssociations(seedTraceIds: string[], opts?: {
+        maxDepth?: number;
+        limit?: number;
+    }): Promise<Array<{
+        memoryId: string;
+        activation: number;
+    }>>;
+    /**
+     * Get all traces filtered by memory type.
+     *
+     * @param type - Memory type to filter by (episodic, semantic, procedural, prospective, relational)
+     * @param opts - Optional limit and minimum strength filter
+     * @throws When backed by standalone SQLite
+     */
+    getTracesByType(type: MemoryType, opts?: {
+        limit?: number;
+        minStrength?: number;
+    }): Promise<ScoredMemoryTrace[]>;
+    /**
+     * Get relational memory traces (trust signals, boundaries, emotional bonds).
+     * Convenience wrapper around getTracesByType('relational').
+     */
+    getRelationalMemories(opts?: {
+        limit?: number;
+    }): Promise<ScoredMemoryTrace[]>;
+    /**
+     * Get memory strength distribution by type.
+     * Returns count, average strength, decaying count, and flashbulb count per type.
+     *
+     * @throws When backed by standalone SQLite
+     */
+    getStrengthDistribution(): Promise<Record<MemoryType, MemoryTypeStats>>;
+    /**
+     * Get pairs of contradicting memory traces.
+     *
+     * @throws When backed by standalone SQLite
+     */
+    getConflicts(): Promise<Array<{
+        traceA: string;
+        traceB: string;
+        type: string;
+    }>>;
+    /**
+     * Get clusters of strongly associated memories.
+     *
+     * @param minSize - Minimum cluster size (default 3)
+     * @throws When backed by standalone SQLite
+     */
+    getClusters(minSize?: number): Promise<Array<{
+        clusterId: string;
+        memberIds: string[];
+        density: number;
+    }>>;
+    /**
+     * Get working memory slots — what's currently "in focus".
+     *
+     * @throws When backed by standalone SQLite
+     */
+    getWorkingMemory(): Promise<WorkingMemorySlot[]>;
+    /**
+     * Get observation pipeline stats (pending notes, compression ratio, reflection count).
+     *
+     * @throws When backed by standalone SQLite
+     */
+    getObservationStats(): Promise<ObservationPipelineStats>;
+    /**
+     * Get active prospective memory items (reminders/intentions).
+     * Alias for `reminders()` with a more descriptive name.
+     */
+    getProspectiveItems(): Promise<ProspectiveMemoryItem[]>;
+    /**
+     * Force a reflection cycle (useful for testing / devtools).
+     * Triggers the Observer's note extraction and the Reflector's consolidation
+     * regardless of token thresholds.
+     *
+     * @throws When backed by standalone SQLite
+     * @returns Reflection result with typed traces, or empty result if no observer
+     */
+    forceReflection(): Promise<{
+        traces: number;
+        superseded: number;
+    }>;
+    /**
+     * Export full memory state as a serializable snapshot.
+     * Used for companion portability across worlds in wilds-ai.
+     *
+     * @throws When backed by standalone SQLite
+     */
+    exportSnapshot(): Promise<CognitiveMemorySnapshot>;
+    /**
+     * Import a memory snapshot (for character portability across worlds).
+     * Encodes each trace and registers prospective items.
+     *
+     * @param snapshot - Previously exported snapshot
+     * @throws When backed by standalone SQLite
+     * @returns Count of imported traces and conflicts detected
+     */
+    importSnapshot(snapshot: CognitiveMemorySnapshot): Promise<{
+        imported: number;
+        conflicts: number;
+    }>;
     get isInitialized(): boolean;
     /** Access the underlying manager for advanced usage. */
     get raw(): ICognitiveMemoryManager;

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

@@ -1 +1 @@
-{"version":3,"file":"AgentMemory.d.ts","sourceRoot":"","sources":["../../src/memory/AgentMemory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AgentMemory.d.ts","sourceRoot":"","sources":["../../src/memory/AgentMemory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,eAAe,EAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAY,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAE3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AACjG,OAAO,EAAE,MAAM,IAAI,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,EAEb,MAAM,sBAAsB,CAAC;AAO9B,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,sDAAsD;IACtD,OAAO,EAAE,wBAAwB,CAAC,oBAAoB,CAAC,CAAC;IACxD,6BAA6B;IAC7B,WAAW,EAAE,wBAAwB,CAAC,aAAa,CAAC,CAAC;CACtD;AAED,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,sCAAsC;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,KAAK,uBAAuB,GAAG,IAAI,CACjC,gBAAgB,EAChB,UAAU,GAAG,QAAQ,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,CAC7G,CAAC;AAYF;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAC,CAA0B;IAC1C,OAAO,CAAC,UAAU,CAAC,CAA0B;IAC7C,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,CAAC,EAAE,uBAAuB,GAAG,uBAAuB;IAUvE;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,uBAAuB,GAAG,WAAW;IAM1D;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,uBAAuB,GAAG,WAAW;IAI/D;;OAEG;WACU,MAAM,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAKhE;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9D;;;;;;OAMG;IACG,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,UAAU,CAAC;QAClB,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,gBAAgB,CAAC;QAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,OAAO,CAAC,cAAc,CAAC;IA2B1B;;;;;;;;OAQG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAmB3E;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAKlF;;;;;;;OAOG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,EAC9C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC;IAQpC;;OAEG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACjC,OAAO,CAAC,sBAAsB,CAAC;IAQlC;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC,GAAG;QACtF,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GACA,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAQxC,6BAA6B;IACvB,SAAS,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAQnD,+BAA+B;IACzB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IASlC,iCAAiC;IAC3B,MAAM,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAQ3C,sCAAsC;IAChC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAW/B;;;OAGG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAQ5E;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAQhF;;;OAGG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxE;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAY3E;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAsE9C;;;;;;;OAOG;IACG,eAAe,CACnB,YAAY,EAAE,MAAM,EAAE,EACtB,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAgB3D;;;;;;OAMG;IACG,eAAe,CACnB,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9C,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAc/B;;;OAGG;IACG,qBAAqB,CAAC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIpF;;;;;OAKG;IACG,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;IAsC7E;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA0BtF;;;;;OAKG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAYhH;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAStD;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAiB9D;;;OAGG;IACG,mBAAmB,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAI7D;;;;;;;OAOG;IACG,eAAe,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IA6BxE;;;;;OAKG;IACG,cAAc,IAAI,OAAO,CAAC,uBAAuB,CAAC;IA0DxD;;;;;;;OAOG;IACG,cAAc,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAiDzG,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,wDAAwD;IACxD,IAAI,GAAG,IAAI,uBAAuB,CAQjC;IAED,yEAAyE;IACzE,IAAI,SAAS,IAAI,uBAAuB,GAAG,SAAS,CAEnD;IAED,OAAO,CAAC,WAAW;YASL,oBAAoB;IA2DlC,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,6BAA6B;IAOrC,OAAO,CAAC,4BAA4B;CAMrC"}