@agntk/core 0.3.5 → 1.1.0

package/dist/index.d.ts

@@ -1,15 +1,11 @@
 /**
- * @agntk/core — Main entry point.
- *
- * The essentials: createAgent + supporting types.
- * Advanced features live in sub-path imports:
- *   - @agntk/core/evals      — eval suite and assertions
- *   - @agntk/core/advanced   — guardrail runners, best-of-n, observability, streaming internals
+ * @fileoverview Main entry point for the SDK.
  */
 export { createAgent, AGENT_STATE_BASE, resolveAgentStatePath } from './agent.js';
 export type { AgentOptions, Agent, AgentStreamResult } from './types/agent.js';
+export type { SubAgentActivityChunk, SubAgentActivityHandler } from './tools/spawn-agent/index.js';
 export { resolveModel, models, setResolvedProvider, getResolvedProviderState } from './models.js';
-export type { ResolvedProvider } from './models.js';
+export type { ResolvedProvider, ResolvedModel } from './models.js';
 export { resolveProvider, getResolvedProvider, resetProviderCache } from './provider-resolver.js';
 export { detectSystem, recommendOllamaModels, getOllamaModels, hasOllamaModel, } from './system-detect.js';
 export type { SystemProfile, OllamaModelTier, OllamaModelRecommendation } from './system-detect.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAE/E,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAM5E,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAC/F,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAMjD,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAM/F,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAMjG,OAAO,EACL,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAMnG,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAMtD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMlE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAMvF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAMzE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAMpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAE/E,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC5E,YAAY,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE1F,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAC/F,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE/F,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAEjG,OAAO,EACL,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEnG,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAElE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEvF,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEzE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,YAAY,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,40 +1,14 @@
 /**
- * @agntk/core — Main entry point.
- *
- * The essentials: createAgent + supporting types.
- * Advanced features live in sub-path imports:
- *   - @agntk/core/evals      — eval suite and assertions
- *   - @agntk/core/advanced   — guardrail runners, best-of-n, observability, streaming internals
+ * @fileoverview Main entry point for the SDK.
  */
-// ═══════════════════════════════════════════════════════════════════════════════
-// Core — the essentials
-// ═══════════════════════════════════════════════════════════════════════════════
 export { createAgent, AGENT_STATE_BASE, resolveAgentStatePath } from './agent.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Models
-// ═══════════════════════════════════════════════════════════════════════════════
 export { resolveModel, models, setResolvedProvider, getResolvedProviderState } from './models.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Provider Resolution
-// ═══════════════════════════════════════════════════════════════════════════════
 export { resolveProvider, getResolvedProvider, resetProviderCache } from './provider-resolver.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// System Detection
-// ═══════════════════════════════════════════════════════════════════════════════
 export { detectSystem, recommendOllamaModels, getOllamaModels, hasOllamaModel, } from './system-detect.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Configuration
-// ═══════════════════════════════════════════════════════════════════════════════
 export { loadConfig, getConfig, configure, defineConfig, getModelForTier, DEFAULT_MODELS, DEFAULT_PROVIDER, } from './config/index.js';
 export { loadSkills, discoverSkills } from './skills/index.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Usage Limits
-// ═══════════════════════════════════════════════════════════════════════════════
 export { UsageLimitExceeded, usageLimitStop } from './usage-limits.js';
 export { MarkdownMemoryStore } from './memory/store.js';
 export { loadMemoryContext } from './memory/loader.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Observability
-// ═══════════════════════════════════════════════════════════════════════════════
 export { shutdownObservability } from './observability/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,kFAAkF;AAClF,wBAAwB;AACxB,kFAAkF;AAElF,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAI/E,kFAAkF;AAClF,SAAS;AACT,kFAAkF;AAElF,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAG/F,kFAAkF;AAClF,sBAAsB;AACtB,kFAAkF;AAElF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE/F,kFAAkF;AAClF,mBAAmB;AACnB,kFAAkF;AAElF,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,kFAAkF;AAClF,gBAAgB;AAChB,kFAAkF;AAElF,OAAO,EACL,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAQlB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEtD,kFAAkF;AAClF,eAAe;AACf,kFAAkF;AAElF,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAqBpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,kFAAkF;AAClF,gBAAgB;AAChB,kFAAkF;AAElF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAK/E,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAG/F,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE/F,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,eAAe,EACf,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAIlB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AASpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/memory/engine.d.ts

@@ -0,0 +1,130 @@
+/**
+ * @agntk/core - Unified Memory Engine
+ *
+ * Single write path: remember() → LLM extraction → parallel writes to Vectra + Graph.
+ * Implements Mem0 ADD/UPDATE/DELETE/NOOP pattern with Hindsight 4-network taxonomy.
+ *
+ * Architecture:
+ * - VectorStore: Semantic similarity search (Vectra)
+ * - GraphStore: Structural relationships (Graphology via QueryPort)
+ * - ExtractionModel: LLM-powered fact extraction
+ * - ContradictionDetector: Write-time conflict detection
+ */
+import type { LanguageModel } from 'ai';
+import type { MemoryStore, MemorySearchResult } from './vectra-store.js';
+import { type ExtractedFact, type MemoryOperation } from './extraction.js';
+/** Graph store interface — matches QueryPort episode/entity methods */
+export interface MemoryGraphStore {
+    upsertEpisode(episode: {
+        id: string;
+        timestamp: string;
+        type: 'conversation' | 'observation' | 'action' | 'decision' | 'learning';
+        summary: string;
+        content: string;
+        entities: string[];
+        relationships: string[];
+    }): Promise<void>;
+    linkEpisodeEntity(episodeId: string, entityName: string): Promise<void>;
+    getEpisodesByQuery(query: string, limit: number): Promise<Array<{
+        id?: string;
+        summary?: string;
+        content?: string;
+        timestamp?: string;
+        type?: string;
+        properties?: Record<string, unknown>;
+    }>>;
+    upsertContradiction(contradiction: {
+        id: string;
+        detectedAt: string;
+        resolution_winner: string | null;
+        resolution_reasoning: string | null;
+        factA_id: string;
+        factA_statement: string;
+        factA_source: string;
+        factA_timestamp: string;
+        factB_id: string;
+        factB_statement: string;
+        factB_source: string;
+        factB_timestamp: string;
+    }): Promise<void>;
+}
+/** Contradiction detector interface — matches brain's ContradictionDetector */
+export interface ContradictionDetectorPort {
+    detect(statementA: string, statementB: string, metadataA?: {
+        id: string;
+        source: string;
+        timestamp: string;
+    }, metadataB?: {
+        id: string;
+        source: string;
+        timestamp: string;
+    }): {
+        id: string;
+        factA: Record<string, string>;
+        factB: Record<string, string>;
+        detectedAt: string;
+    } | null;
+}
+/** Result of a unified remember() operation */
+export interface MemoryWriteResult {
+    id: string;
+    operation: MemoryOperation;
+    facts: ExtractedFact[];
+    vectorStoreId?: string;
+    graphStoreId?: string;
+    contradiction?: {
+        id: string;
+        existingFact: string;
+        newFact: string;
+    };
+}
+/** Configuration for the unified memory engine */
+export interface MemoryEngineConfig {
+    /** Vector store for semantic search (Vectra) */
+    vectorStore: MemoryStore;
+    /** Graph store for structural queries (Graphology via QueryPort) — optional */
+    graphStore?: MemoryGraphStore;
+    /** LLM for extraction pipeline — optional, extraction disabled without it */
+    extractionModel?: LanguageModel;
+    /** Contradiction detector — optional */
+    contradictionDetector?: ContradictionDetectorPort;
+    /** Default top-K for recall */
+    defaultTopK?: number;
+    /** Default similarity threshold */
+    defaultThreshold?: number;
+}
+/** The unified memory engine interface */
+export interface MemoryEngine {
+    /** Store text with LLM extraction → parallel writes to vector + graph */
+    remember(text: string, metadata?: Record<string, unknown>): Promise<MemoryWriteResult>;
+    /** Semantic search via vector store */
+    recall(query: string, options?: {
+        topK?: number;
+        threshold?: number;
+    }): Promise<MemorySearchResult[]>;
+    /** Graph-based knowledge query — returns episodes/entities matching query */
+    queryKnowledge(query: string, limit?: number): Promise<Array<Record<string, unknown>>>;
+    /** Remove a memory by ID from both stores */
+    forget(id: string): Promise<boolean>;
+    /** Get stats */
+    count(): Promise<number>;
+    /** Cleanup */
+    close(): Promise<void>;
+}
+/**
+ * Create a unified memory engine.
+ *
+ * @example
+ * ```typescript
+ * const engine = createMemoryEngine({
+ *   vectorStore: await createMemoryStore({ path: './.memory' }),
+ *   graphStore: new GraphologyAdapter(),
+ *   extractionModel: openai('gpt-4o-mini'),
+ * });
+ *
+ * // Single remember() does extraction + parallel writes
+ * const result = await engine.remember('TypeScript 5.3 supports import attributes');
+ * ```
+ */
+export declare function createMemoryEngine(config: MemoryEngineConfig): MemoryEngine;
+//# sourceMappingURL=engine.d.ts.map

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

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

package/dist/memory/engine.js

@@ -0,0 +1,227 @@
+/**
+ * @agntk/core - Unified Memory Engine
+ *
+ * Single write path: remember() → LLM extraction → parallel writes to Vectra + Graph.
+ * Implements Mem0 ADD/UPDATE/DELETE/NOOP pattern with Hindsight 4-network taxonomy.
+ *
+ * Architecture:
+ * - VectorStore: Semantic similarity search (Vectra)
+ * - GraphStore: Structural relationships (Graphology via QueryPort)
+ * - ExtractionModel: LLM-powered fact extraction
+ * - ContradictionDetector: Write-time conflict detection
+ */
+import { createLogger } from '@agntk/logger';
+import { extractFacts, } from './extraction.js';
+const log = createLogger('@agntk/core:memory-engine');
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Create a unified memory engine.
+ *
+ * @example
+ * ```typescript
+ * const engine = createMemoryEngine({
+ *   vectorStore: await createMemoryStore({ path: './.memory' }),
+ *   graphStore: new GraphologyAdapter(),
+ *   extractionModel: openai('gpt-4o-mini'),
+ * });
+ *
+ * // Single remember() does extraction + parallel writes
+ * const result = await engine.remember('TypeScript 5.3 supports import attributes');
+ * ```
+ */
+export function createMemoryEngine(config) {
+    const { vectorStore, graphStore, extractionModel, contradictionDetector, defaultTopK = 5, defaultThreshold = 0.7, } = config;
+    return {
+        async remember(text, metadata) {
+            const writeId = generateWriteId();
+            const timestamp = new Date().toISOString();
+            log.debug('remember() — unified write path', { writeId, textLength: text.length });
+            // Step 1: Extract facts via LLM (if model provided)
+            let facts = [];
+            if (extractionModel) {
+                try {
+                    const done = log.time('extraction');
+                    const result = await extractFacts(text, { model: extractionModel });
+                    facts = result.facts;
+                    done();
+                    log.info('Extraction complete', { factCount: facts.length });
+                }
+                catch (error) {
+                    log.warn('Extraction failed, continuing with raw text', { error: String(error) });
+                }
+            }
+            // Step 2: Check for contradictions against existing memories
+            let contradictionResult;
+            if (contradictionDetector && facts.length > 0) {
+                try {
+                    contradictionResult = await detectContradictions(facts, vectorStore, contradictionDetector, graphStore, defaultTopK, defaultThreshold);
+                }
+                catch (error) {
+                    log.warn('Contradiction detection failed, continuing', { error: String(error) });
+                }
+            }
+            // Step 3: Determine operation type
+            const operation = contradictionResult ? 'UPDATE' : 'ADD';
+            // Step 4: Parallel writes to vector store + graph store
+            const writePromises = [];
+            let vectorStoreId;
+            let graphStoreId;
+            // Vector store: store the raw text + extracted facts as metadata
+            writePromises.push(vectorStore.remember(text, {
+                ...metadata,
+                writeId,
+                timestamp,
+                operation,
+                networks: facts.map((f) => f.network),
+                factCount: facts.length,
+                facts: facts.map((f) => f.fact),
+            }).then((id) => { vectorStoreId = id; }));
+            // Graph store: create episode + link entities
+            if (graphStore && facts.length > 0) {
+                const episodeType = classifyEpisodeType(facts);
+                const entityNames = [...new Set(facts.flatMap((f) => f.entities.map((e) => e.name)))];
+                const relationshipStrings = facts.flatMap((f) => f.relationships.map((r) => `${r.from}-[${r.type}]->${r.to}`));
+                writePromises.push((async () => {
+                    await graphStore.upsertEpisode({
+                        id: writeId,
+                        timestamp,
+                        type: episodeType,
+                        summary: facts.map((f) => f.fact).join('; '),
+                        content: text,
+                        entities: entityNames,
+                        relationships: relationshipStrings,
+                    });
+                    graphStoreId = writeId;
+                    // Link entities to the episode
+                    for (const entityName of entityNames) {
+                        await graphStore.linkEpisodeEntity(writeId, entityName);
+                    }
+                })());
+            }
+            await Promise.all(writePromises);
+            log.info('Unified write complete', {
+                writeId,
+                operation,
+                factCount: facts.length,
+                vectorStoreId,
+                graphStoreId,
+                hasContradiction: !!contradictionResult,
+            });
+            return {
+                id: writeId,
+                operation,
+                facts,
+                vectorStoreId,
+                graphStoreId,
+                contradiction: contradictionResult,
+            };
+        },
+        async recall(query, options) {
+            return vectorStore.recall(query, {
+                topK: options?.topK ?? defaultTopK,
+                threshold: options?.threshold ?? defaultThreshold,
+            });
+        },
+        async queryKnowledge(query, limit = 10) {
+            if (!graphStore) {
+                log.debug('queryKnowledge called without graph store — returning empty');
+                return [];
+            }
+            const episodes = await graphStore.getEpisodesByQuery(query, limit);
+            return episodes.map((ep) => ({
+                id: ep.id ?? ep.properties?.id,
+                summary: ep.summary ?? ep.properties?.summary,
+                content: ep.content ?? ep.properties?.content,
+                timestamp: ep.timestamp ?? ep.properties?.timestamp,
+                type: ep.type ?? ep.properties?.type,
+            }));
+        },
+        async forget(id) {
+            return vectorStore.forget(id);
+        },
+        async count() {
+            return vectorStore.count();
+        },
+        async close() {
+            await vectorStore.close();
+        },
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function generateWriteId() {
+    return `mem_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+}
+/**
+ * Classify the episode type based on the dominant memory network.
+ */
+function classifyEpisodeType(facts) {
+    const counts = {
+        world_fact: 0,
+        experience: 0,
+        entity_summary: 0,
+        belief: 0,
+    };
+    for (const fact of facts) {
+        counts[fact.network]++;
+    }
+    // Map network types to episode types
+    if (counts.experience > 0)
+        return 'action';
+    if (counts.belief > 0)
+        return 'decision';
+    if (counts.entity_summary > counts.world_fact)
+        return 'observation';
+    return 'learning';
+}
+/**
+ * Check new facts against existing memories for contradictions.
+ */
+async function detectContradictions(newFacts, vectorStore, detector, graphStore, topK, threshold) {
+    // For each new world_fact or belief, check against similar existing memories
+    const checkableFacts = newFacts.filter((f) => f.network === 'world_fact' || f.network === 'belief');
+    for (const newFact of checkableFacts) {
+        const existing = await vectorStore.recall(newFact.fact, { topK, threshold });
+        for (const match of existing) {
+            const contradiction = detector.detect(match.item.text, newFact.fact, { id: match.item.id, source: 'memory', timestamp: match.item.timestamp.toISOString() }, { id: 'new', source: 'input', timestamp: new Date().toISOString() });
+            if (contradiction) {
+                log.info('Contradiction detected', {
+                    existing: match.item.text.slice(0, 80),
+                    new: newFact.fact.slice(0, 80),
+                });
+                // Store the contradiction in graph store if available
+                if (graphStore) {
+                    try {
+                        await graphStore.upsertContradiction({
+                            id: contradiction.id,
+                            detectedAt: contradiction.detectedAt,
+                            resolution_winner: null,
+                            resolution_reasoning: null,
+                            factA_id: match.item.id,
+                            factA_statement: match.item.text,
+                            factA_source: 'memory',
+                            factA_timestamp: match.item.timestamp.toISOString(),
+                            factB_id: 'new',
+                            factB_statement: newFact.fact,
+                            factB_source: 'input',
+                            factB_timestamp: new Date().toISOString(),
+                        });
+                    }
+                    catch (error) {
+                        log.warn('Failed to store contradiction in graph', { error: String(error) });
+                    }
+                }
+                return {
+                    id: contradiction.id,
+                    existingFact: match.item.text,
+                    newFact: newFact.fact,
+                };
+            }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=engine.js.map

package/dist/memory/engine.js.map

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

package/dist/memory/loader.d.ts

@@ -1,20 +1,3 @@
-/**
- * @agntk/core - Memory Loader
- *
- * Loads memory files from a MemoryStore and formats them as a string
- * for injection into the agent's system prompt.
- *
- * Load order (from PLAN.md):
- *   1. ~/.agntk/identity.md
- *   2. ~/.agntk/preferences.md
- *   3. .agntk/project.md (or CLAUDE.md / AGENTS.md)
- *   4. .agntk/memory.md
- *   5. .agntk/context.md
- */
 import type { MemoryStore } from './types.js';
-/**
- * Load all always-on memory files and format as a system prompt section.
- * Missing files are silently skipped.
- */
 export declare function loadMemoryContext(store: MemoryStore): Promise<string>;
 //# sourceMappingURL=loader.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/memory/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAQ3C;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAwD3E"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/memory/loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAO3C,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAyD3E"}

package/dist/memory/loader.js

@@ -1,48 +1,26 @@
-/**
- * @agntk/core - Memory Loader
- *
- * Loads memory files from a MemoryStore and formats them as a string
- * for injection into the agent's system prompt.
- *
- * Load order (from PLAN.md):
- *   1. ~/.agntk/identity.md
- *   2. ~/.agntk/preferences.md
- *   3. .agntk/project.md (or CLAUDE.md / AGENTS.md)
- *   4. .agntk/memory.md
- *   5. .agntk/context.md
- */
 import { createLogger } from '@agntk/logger';
 const log = createLogger('@agntk/core:memory-loader');
-/** Rough token estimate: ~4 chars per token */
 const CHARS_PER_TOKEN = 4;
 const TOKEN_WARNING_THRESHOLD = 2000;
-/**
- * Load all always-on memory files and format as a system prompt section.
- * Missing files are silently skipped.
- */
 export async function loadMemoryContext(store) {
     const sections = [];
-    // 1. Identity (global, human-authored)
     const identity = await store.loadIdentity();
     if (identity) {
         sections.push(formatSection('Identity', identity));
     }
-    // 2. Preferences (global, agent-curated)
     const preferences = await store.loadPreferences();
     if (preferences) {
         sections.push(formatSection('Preferences', preferences));
     }
-    // 3. Project (local, human-authored — falls back to CLAUDE.md / AGENTS.md)
     const project = await store.loadProject();
     if (project) {
         sections.push(formatSection('Project', project));
     }
-    // 4. Memory (local, agent-curated facts)
-    const memory = await store.loadMemory();
-    if (memory) {
-        sections.push(formatSection('Memory', memory));
+    const memoryFiles = await store.listMemoryFiles();
+    if (memoryFiles.length > 0) {
+        const listing = memoryFiles.map((f) => `- ${f}`).join('\n');
+        sections.push(formatSection('Memory Files', `Your memory/ directory contains these knowledge files:\n${listing}\n\nRead any file when you need its contents. Use grep to search across all files.`));
     }
-    // 5. Context (local, agent-rewritten each session)
     const context = await store.loadContext();
     if (context) {
         sections.push(formatSection('Current Context', context));
@@ -51,7 +29,6 @@ export async function loadMemoryContext(store) {
         return '';
     }
     const result = '# Persistent Memory\n\n' + sections.join('\n\n');
-    // Warn if memory context is large
     const estimatedTokens = Math.ceil(result.length / CHARS_PER_TOKEN);
     if (estimatedTokens > TOKEN_WARNING_THRESHOLD) {
         log.warn('Memory context is large', {
@@ -64,6 +41,7 @@ export async function loadMemoryContext(store) {
         sections: sections.length,
         chars: result.length,
         estimatedTokens,
+        memoryFileCount: memoryFiles.length,
     });
     return result;
 }

package/dist/memory/loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/memory/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,GAAG,GAAG,YAAY,CAAC,2BAA2B,CAAC,CAAC;AAEtD,+CAA+C;AAC/C,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAErC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAkB;IACxD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,uCAAuC;IACvC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;IAC5C,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,yCAAyC;IACzC,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;IAClD,IAAI,WAAW,EAAE,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,2EAA2E;IAC3E,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;IAC1C,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,yCAAyC;IACzC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;IACxC,IAAI,MAAM,EAAE,CAAC;QACX,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,mDAAmD;IACnD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;IAC1C,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,yBAAyB,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjE,kCAAkC;IAClC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;IACnE,IAAI,eAAe,GAAG,uBAAuB,EAAE,CAAC;QAC9C,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE;YAClC,eAAe;YACf,SAAS,EAAE,uBAAuB;YAClC,KAAK,EAAE,MAAM,CAAC,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE;QACjC,QAAQ,EAAE,QAAQ,CAAC,MAAM;QACzB,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,eAAe;KAChB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,KAAa,EAAE,OAAe;IACnD,OAAO,MAAM,KAAK,OAAO,OAAO,EAAE,CAAC;AACrC,CAAC"}
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/memory/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,GAAG,GAAG,YAAY,CAAC,2BAA2B,CAAC,CAAC;AAEtD,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAErC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAkB;IACxD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;IAC5C,IAAI,QAAQ,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;IAClD,IAAI,WAAW,EAAE,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;IAC1C,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;IAClD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,QAAQ,CAAC,IAAI,CACX,aAAa,CACX,cAAc,EACd,2DAA2D,OAAO,oFAAoF,CACvJ,CACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;IAC1C,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,yBAAyB,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjE,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;IACnE,IAAI,eAAe,GAAG,uBAAuB,EAAE,CAAC;QAC9C,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE;YAClC,eAAe;YACf,SAAS,EAAE,uBAAuB;YAClC,KAAK,EAAE,MAAM,CAAC,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE;QACjC,QAAQ,EAAE,QAAQ,CAAC,MAAM;QACzB,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,eAAe;QACf,eAAe,EAAE,WAAW,CAAC,MAAM;KACpC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,KAAa,EAAE,OAAe;IACnD,OAAO,MAAM,KAAK,OAAO,OAAO,EAAE,CAAC;AACrC,CAAC"}

package/dist/memory/store.d.ts

@@ -1,21 +1,9 @@
-/**
- * @agntk/core - MarkdownMemoryStore
- *
- * File-based MemoryStore implementation that reads/writes .agntk/ markdown files.
- * Zero dependencies beyond Node.js built-ins.
- */
 import type { MemoryStore } from './types.js';
 export interface MarkdownMemoryStoreOptions {
-    /** Project-local memory directory. Default: '.agntk' (relative to workspaceRoot) */
     projectDir?: string;
-    /** Global memory directory. Default: '~/.agntk' */
     globalDir?: string;
-    /** Workspace root for resolving project directory. Default: process.cwd() */
     workspaceRoot?: string;
 }
-/**
- * Reads/writes markdown memory files from .agntk/ and ~/.agntk/ directories.
- */
 export declare class MarkdownMemoryStore implements MemoryStore {
     private readonly projectPath;
     private readonly globalPath;
@@ -24,17 +12,21 @@ export declare class MarkdownMemoryStore implements MemoryStore {
     loadIdentity(): Promise<string | null>;
     loadPreferences(): Promise<string | null>;
     loadProject(): Promise<string | null>;
-    loadMemory(): Promise<string | null>;
     loadContext(): Promise<string | null>;
     loadDecisions(): Promise<string | null>;
     saveContext(content: string): Promise<void>;
-    saveMemory(content: string): Promise<void>;
     savePreferences(content: string): Promise<void>;
     appendDecision(entry: string): Promise<void>;
-    /** Get the resolved project directory path */
+    listMemoryFiles(): Promise<string[]>;
+    createTaskFolder(label: string): Promise<string>;
+    archiveTask(taskFolderName: string): Promise<void>;
+    getCurrentTaskPath(): Promise<string | null>;
     getProjectPath(): string;
-    /** Get the resolved global directory path */
     getGlobalPath(): string;
+    getMemoryPath(): string;
+    getWorkspacePath(): string;
+    getArchivePath(): string;
+    ensureDirectories(): Promise<void>;
     private readFileOrNull;
     private writeFileSafe;
     private ensureDir;

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

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AA2B3C,MAAM,WAAW,0BAA0B;IACzC,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,OAAO,GAAE,0BAA+B;IAQ9C,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAItC,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzC,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiBrC,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIpC,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIrC,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAMvC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlD,8CAA8C;IAC9C,cAAc,IAAI,MAAM;IAIxB,6CAA6C;IAC7C,aAAa,IAAI,MAAM;YAMT,cAAc;YASd,aAAa;YAOb,SAAS;CAMxB"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAyB3C,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAE3B,OAAO,GAAE,0BAA+B;IAM9C,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAItC,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzC,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAerC,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIrC,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIvC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5C,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAYpC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BhD,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BlD,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAalD,cAAc,IAAI,MAAM;IAIxB,aAAa,IAAI,MAAM;IAIvB,aAAa,IAAI,MAAM;IAIvB,gBAAgB,IAAI,MAAM;IAI1B,cAAc,IAAI,MAAM;IAIlB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;YAO1B,cAAc;YASd,aAAa;YAOb,SAAS;CAMxB"}