dotmem 0.0.5 → 0.0.8

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dotmem",
   "codeName": "dotmem",
-  "version": "0.0.5",
+  "version": "0.0.8",
   "license": "MIT",
   "type": "module",
   "description": "The AI memory layer for agents and apps: acquired experience, discovery, context projection, continuity, and logic engine. Built on Memorio's state+store foundation.",
@@ -74,17 +74,15 @@
   "publishConfig": {
     "access": "public"
   },
-  "optionalDependencies": {
-    "@modelcontextprotocol/server": "^2.4.0",
-    "zod": "^4.6.7"
+  "dependencies": {
+    "@modelcontextprotocol/server": "2.4.0",
+    "memorio": "5.5.3",
+    "zod": "4.6.7"
   },
   "overrides": {
     "glob": "^14.0.2",
     "minimatch": "^11.0.1"
   },
-  "dependencies": {
-    "memorio": "5.5.3"
-  },
   "typings": "./index.d.ts",
   "scripts": {
     "prepack": "node -e \"['bin/cli.js','bin/cli.cjs','bin/mcp.js','bin/mcp.cjs'].forEach(f=>{try{require('fs').chmodSync(f,0o755)}catch{}})\""

package/types/exports.d.ts

@@ -1,304 +1,297 @@
-export * from './memory'
-export * from './agent'
-export * from './logic'
-export * from './policy'
-export * from './profile'
-export * from './llm-cache'
-
-// ── Memory facade type ───────────────────────────────────────────────────
-export interface MemoryFacade {
-  init(): Promise<void>
-  discover(situation: string | import('./memory').Situation, options?: import('./memory').DiscoveryOptions): Promise<import('./memory').DiscoveryResult>
-  context(options?: ContextQueryOptions): Promise<import('./memory').AcquiredContext>
-  project(discovery: import('./memory').DiscoveryResult, options?: import('./memory').ProjectionOptions): import('./memory').ContextProjection
-  acquire(opts: import('./memory').AcquireOptions): Promise<void>
-  acquireStaged(opts: import('./memory').AcquireOptions): Promise<void>
-  remember<T>(key: string, value: T, opts?: import('./memory').RememberOptions<T>): Promise<void>
-  recall<T = any>(query: string | number, opts?: import('./memory').RecallOptions): Promise<T | null>
-  update(key: string, value: any, opts?: Partial<import('./memory').RememberOptions>): Promise<void>
-  forget(key: string): Promise<void>
-  patch(key: string, patches: import('./memory').PatchOperation[]): Promise<void>
-  stats(): Promise<import('./memory').MemoryStats>
-  forgetExpired(): Promise<number>
-  clear(): Promise<void>
-  fingerprint(): Promise<string>
-  journal: MemoryJournal
-  profile: MemoryProfile
-  note: MemoryNotes
-  seed: MemorySeed
-  policy: MemoryPolicyAPI
-  brain: MemoryBrainAPI
-  configure(config: import('./memory').SyncConfig): void
-  configureSync(config: import('./memory').SyncConfig): void
-  resetBrainPathCache(): void
-  resetPolicyStoreCache(): void
-  _getEntry(key: string): Promise<import('./memory').MemoryEntry | null>
-  _loadAll(): Promise<import('./memory').MemoryEntry[]>
-  _save(entry: import('./memory').MemoryEntry): Promise<void>
-}
-
-export interface LlmCacheAPI {
-  llm<T>(opts: import('./llm-cache').LlmCacheOptions<T>): Promise<import('./llm-cache').LlmCacheResult<T>>
-  llmStats(): import('./llm-cache').LlmCacheStats
-  llmPurge(selector: import('./llm-cache').LlmCachePurgeSelector): number
-  [key: string]: any
-}
-
-type Situation = string
-
-export interface ContextQueryOptions {
-  tags?: string | string[]
-  types?: import('./memory').MemoryType | import('./memory').MemoryType[]
-  minConfidence?: number
-  maxEntries?: number
-  scopes?: import('./memory').MemoryScope[]
-  project?: boolean
-}
-
-export interface MemoryJournal {
-  read: (opts?: { limit?: number }) => Promise<JournalEntry[]>
-  write: (entry: JournalEntry | JournalEntry[]) => Promise<void>
-  clear: () => Promise<void>
-}
-
-export interface JournalEntry {
-  id: string
-  key: string
-  type: import('./memory').MemoryType
-  operation: string
-  hlc?: string
-  createdAt: number
-  payload?: unknown
-}
-
-export interface MemoryProfile {
-  get(): import('./profile').DotMemProfile
-}
-
-export interface MemoryNotes {
-  add(text: string, opts?: { id?: string; tags?: string[] }): Promise<void>
-  get(id: string): Promise<NoteContent | null>
-  list(): Promise<NoteEntry[]>
-  forget(id: string): Promise<void>
-}
-
-export interface NoteContent {
-  id: string
-  title: string
-  content: string
-  tags: string[]
-  createdAt: number
-  sha256: string
-}
-
-export interface NoteEntry {
-  id: string
-  title: string
-  size: number
-  sha256: string
-  origin: string
-  tag?: string
-  acquiredAt?: string
-  scope?: string
-  type?: import('./memory').MemoryType
-  version?: number
-  updatedAt?: number
-  previousId?: string | null
-  patches?: import('./memory').PatchOperation[]
-  hlc?: string
-  key?: string
-  value?: unknown
-  status?: string
-  createdAt?: number
-  lastConfirmedAt?: number
-  supersededId?: string | null
-  confidence?: number
-  source?: string
-  ttl?: number | null
-}
-
-export interface MemorySeed {
-  id: string
-  title: string
-  content: string
-  origin: string
-}
-
-// --- Foundation types from Memorio (re-exported) ---
-export type {
-  Operation,
-  Mutation,
-  Patch,
-  PatchOperation,
-  Transaction,
-  Commit,
-  MutateOptions
-} from 'memorio'
-// --- dotmem public runtime exports ---
-declare const memory: MemoryFacade
-declare const continuity: any
-declare const security: any
-
-// --- Dotmem-specific encryption envelope ---
-
-export interface EncryptedEnvelope {
-  id?: string
-  iv: string
-  data: string
-  tag?: string
-  algorithm?: string
-  keyId?: string
-}
-
-// --- User identity surface ---
-export interface UserIdentity {
-  id: string
-  name?: string
-  email?: string
-}
-declare function resolveUserIdentity(): UserIdentity | null
-declare function setUserIdentity(id: string, identity: UserIdentity): void
-declare function clearUserIdentity(): void
-
-// ── User paths surface ───────────────────────────────────────────────────
-declare function resolveUserDotMemPath(): string
-declare function resolveUserProjectMemoryPath(projectId?: string): string
-declare function resolveUserAnchor(): string
-declare function resolveUserBrainPath(): string
-declare function resolveUserContractPath(): string
-declare function resolveUserAgentMemoryPath(): string
-declare function resolveUserReadmePath(): string
-declare function resolveUserExperiencePath(): string
-
-// ── Storage location surface ─────────────────────────────────────────────
-export interface DotMemStorageLocationError extends Error {
-  readonly storageRoot: string
-  readonly source: string
-}
-declare const DOTMEM_STORAGE_ROOT_ENV_VAR: string
-declare const DOTMEM_USER_ANCHOR_DIR_NAME: string
-declare const DOTMEM_STORAGE_LOCATOR_FILE_NAME: string
-declare const DOTMEM_STORAGE_LOCATOR_VERSION: number
-declare function resolveDotMemStorageRoot(): string
-declare function describeDotMemStorage(): unknown
-declare function readDotMemStorageLocator(): unknown
-declare function relocateDotMemStorage(target: string): unknown
-declare function restoreDefaultDotMemStorage(): unknown
-
-// ── Project identity surface ─────────────────────────────────────────────
-declare function resolveProjectIdentity(id?: string): Promise<string>
-
-// ── Mem package inspection ──────────────────────────────────────────────
-declare function inspectMem(mem: unknown, opts?: Record<string, unknown>): unknown
-declare function signMemPackage(mem: unknown, key: unknown): unknown
-export interface MemInspection {
-  status: 'inspected'
-  version: number
-  entries: unknown[]
-}
-export interface MemInspectionStatus {
-  valid: boolean
-  errors?: string[]
-}
-
-// ── Profile ──────────────────────────────────────────────────────────────
-export interface DotMemProfileDocument {
-  readonly name: string
-  readonly content: string
-}
-export interface DotMemProfile {
-  readonly format: 'dotmem.profile'
-  readonly version: 1
-  readonly id: 'joy'
-  readonly name: 'Joy'
-  readonly alternative: ['Jo']
-  readonly documents: ReadonlyArray<DotMemProfileDocument>
-  readonly type: 'ai-persona'
-  readonly role: string
-  readonly immutable: true
-  readonly description: string
-}
-declare const JO_PROFILE: Readonly<DotMemProfile>
-
-// ── Mutation engine extras ──────────────────────────────────────────────
-declare function currentTimestamp(): string
-declare function activeTransactionId(): string | null
-
-// --- Foundation values from Memorio (ambient globals) ---declare const state: any
-declare const store: any
-declare const session: any
-declare const cache: LlmCacheAPI
-declare const idb: any
-declare const sqlite: any
-declare const observer: any
-declare const schema: any
-declare function registerSchema(path: string, schema: any): void
-declare function validate(path: string, value: any): { valid: boolean; errors?: string[] }
-declare function unregisterSchema(path: string): boolean
-declare function listSchemas(): string[]
-declare const typed: <T extends Record<string, any>>() => T
-declare const computed: any
-declare const broadcast: any
-declare const message: (...args: unknown[]) => void
-declare const logger: any
-declare const snapshot: () => Record<string, any>
-declare function diff(snap: Record<string, any>): Array<{ path: string; oldValue: any; newValue: any }>
-declare function undo(): any
-declare function redo(): any
-declare function canUndo(): boolean
-declare function canRedo(): boolean
-declare function rollback(snap: Record<string, any>): void
-declare function trace(): any[]
-declare function enableHistory(enabled?: boolean): void
-declare function clearHistory(): void
-declare function clearRedo(): void
-declare function createMutation(path: string, operation: any, before: any, after: any, opts?: { context?: string; source?: string; transactionId?: string }): unknown
-declare function recordMutation(mutation: unknown): void
-declare function toPatch(mutation: unknown): unknown | null
-declare function mutate(path: string, value: any, opts?: { source?: string; transactionId?: string }): unknown
-declare function beginTransaction(source?: string, message?: string, metadata?: Record<string, any>): unknown
-declare function commitTransaction(): unknown
-declare function abortTransaction(): unknown
-declare function currentTransaction(): unknown
-declare function listTransactions(): unknown[]
-declare const transaction: (source?: string, message?: string, metadata?: Record<string, any>) => unknown
-declare function generateMutationId(): string
-declare function generateTransactionId(): string
-declare function generateCommitId(): string
-declare function mutationToPatch(mutation: unknown): unknown | null
-declare function diffToPatch(path: string, before: any, after: any): unknown | null
-declare function canMerge(p1: unknown, p2: unknown): boolean
-declare function mergePatches(p1: unknown, p2: unknown): unknown
-declare function dispatch(event: string, payload?: unknown): Promise<void>
-declare function isDotMemCodename(value: string): boolean
-declare function codenameKeyFor(value: string): string | undefined
-declare function renderCodenames(): string
-declare const CODENAMES: Record<string, string>
-declare const CODENAME_DETAILS: Record<string, unknown>
-declare function propertyName(container: any, object: any): string | null
-declare const internal: any
-declare function setContext(id: string): void
-declare function getContext(): string | null
-declare const hlc: any
-declare const fractional: any
-declare const encryption: any
-declare const securityEncryption: any
-declare const devtools: any
-declare function help(): void
-declare const temporal: any
-declare const events: Record<string, any>
-declare const dotmem: any
-declare const DEV: boolean
-declare const PROD: boolean
-declare function isBrowser(): boolean
-declare function isNode(): boolean
-declare function isDeno(): boolean
-declare function isBun(): boolean
-declare function isEdge(): boolean
-declare function getCapabilities(): unknown
-declare function createContext(name?: string, opts?: { encryptionKey?: any }): unknown
-declare function listContexts(): unknown[]
-declare function deleteContext(id: string): void
-declare function isolate(name?: string, opts?: { encryptionKey?: any }): void
-
-export default dotmem
+export * from './memory'
+export * from './agent'
+export * from './logic'
+export * from './policy'
+export * from './profile'
+export * from './llm-cache'
+
+// ── Memory facade type ───────────────────────────────────────────────────
+export interface MemoryFacade {
+  init(): Promise<void>
+  discover(situation: string, options?: import('./memory').DiscoveryOptions): Promise<import('./memory').DiscoveryResult>
+  context(options?: ContextQueryOptions): Promise<import('./memory').AcquiredContext>
+  project(discovery: import('./memory').DiscoveryResult, options?: import('./memory').ProjectionOptions): import('./memory').ContextProjection
+  acquire(opts: import('./memory').AcquireOptions): Promise<void>
+  acquireStaged(opts: import('./memory').AcquireOptions): Promise<void>
+  remember<T>(key: string, value: T, opts?: import('./memory').RememberOptions<T>): Promise<void>
+  recall<T = any>(query: string | number, opts?: import('./memory').RecallOptions): Promise<T | null>
+  update(key: string, value: any, opts?: Partial<import('./memory').RememberOptions>): Promise<void>
+  forget(key: string): Promise<void>
+  patch(key: string, patches: import('./memory').PatchOperation[]): Promise<void>
+  stats(): Promise<import('./memory').MemoryStats>
+  forgetExpired(): Promise<number>
+  clear(): Promise<void>
+  fingerprint(): Promise<string>
+  journal: MemoryJournal
+  profile: MemoryProfile
+  note: MemoryNotes
+  seed: MemorySeed
+  policy: import('./policy').MemoryPolicyAPI
+  brain: import('./policy').MemoryBrainAPI
+  configure(config: import('./memory').SyncConfig): void
+  configureSync(config: import('./memory').SyncConfig): void
+  resetBrainPathCache(): void
+  resetPolicyStoreCache(): void
+  _getEntry(key: string): Promise<import('./memory').MemoryEntry | null>
+  _loadAll(): Promise<import('./memory').MemoryEntry[]>
+  _save(entry: import('./memory').MemoryEntry): Promise<void>
+}
+
+export interface LlmCacheAPI {
+  llm<T>(opts: import('./llm-cache').LlmCacheOptions<T>): Promise<import('./llm-cache').LlmCacheResult<T>>
+  llmStats(): import('./llm-cache').LlmCacheStats
+  llmPurge(selector: import('./llm-cache').LlmCachePurgeSelector): number
+  [key: string]: any
+}
+
+type Situation = string
+
+export interface ContextQueryOptions {
+  tags?: string | string[]
+  types?: import('./memory').MemoryType | import('./memory').MemoryType[]
+  minConfidence?: number
+  maxEntries?: number
+  scopes?: import('./memory').MemoryScope[]
+  project?: boolean
+}
+
+export interface MemoryJournal {
+  read: (opts?: { limit?: number }) => Promise<JournalEntry[]>
+  write: (entry: JournalEntry | JournalEntry[]) => Promise<void>
+  clear: () => Promise<void>
+}
+
+export interface JournalEntry {
+  id: string
+  key: string
+  type: import('./memory').MemoryType
+  operation: string
+  hlc?: string
+  createdAt: number
+  payload?: unknown
+}
+
+export interface MemoryProfile {
+  get(id: string): import('./profile').DotMemProfile
+}
+
+export interface MemoryNotes {
+  add(text: string, opts?: { id?: string; tags?: string[] }): Promise<void>
+  get(id: string): Promise<NoteContent | null>
+  list(): Promise<NoteEntry[]>
+  forget(id: string): Promise<void>
+}
+
+export interface NoteContent {
+  id: string
+  title: string
+  content: string
+  tags: string[]
+  createdAt: number
+  sha256: string
+}
+
+export interface NoteEntry {
+  id: string
+  title: string
+  size: number
+  sha256: string
+  origin: string
+  tag?: string
+  acquiredAt?: string
+  scope?: string
+  type?: import('./memory').MemoryType
+  version?: number
+  updatedAt?: number
+  previousId?: string | null
+  patches?: import('./memory').PatchOperation[]
+  hlc?: string
+  key?: string
+  value?: unknown
+  status?: string
+  createdAt?: number
+  lastConfirmedAt?: number
+  supersededId?: string | null
+  confidence?: number
+  source?: string
+  ttl?: number | null
+}
+
+export interface MemorySeed {
+  id: string
+  title: string
+  content: string
+  origin: string
+}
+
+// --- Foundation types from Memorio are runtime-only and intentionally not
+// re-exported through Dotmem's declaration surface: Memorio 5.5.3's published
+// type entry is incomplete, and exposing those aliases would force consumers
+// to enable skipLibCheck. Runtime callers may still use the underlying
+// Memorío module directly. ---
+// --- dotmem public runtime exports ---
+export declare const memory: MemoryFacade
+export declare const continuity: any
+export declare const security: any
+
+// --- Dotmem-specific encryption envelope ---
+
+export interface EncryptedEnvelope {
+  id?: string
+  iv: string
+  data: string
+  tag?: string
+  algorithm?: string
+  keyId?: string
+}
+
+// --- User identity surface ---
+export interface UserIdentity {
+  id: string
+  name?: string
+  email?: string
+}
+export declare function resolveUserIdentity(): UserIdentity | null
+export declare function setUserIdentity(id: string, identity: UserIdentity): void
+export declare function clearUserIdentity(): void
+
+// ── User paths surface ───────────────────────────────────────────────────
+export declare function resolveUserDotMemPath(): string
+export declare function resolveUserProjectMemoryPath(projectId?: string): string
+export declare function resolveUserAnchor(): string
+export declare function resolveUserBrainPath(): string
+export declare function resolveUserContractPath(): string
+export declare function resolveUserAgentMemoryPath(): string
+export declare function resolveUserReadmePath(): string
+export declare function resolveUserExperiencePath(): string
+
+// ── Storage location surface ─────────────────────────────────────────────
+export interface DotMemStorageLocationError extends Error {
+  readonly storageRoot: string
+  readonly source: string
+}
+export declare const DOTMEM_STORAGE_ROOT_ENV_VAR: string
+export declare const DOTMEM_USER_ANCHOR_DIR_NAME: string
+export declare const DOTMEM_STORAGE_LOCATOR_FILE_NAME: string
+export declare const DOTMEM_STORAGE_LOCATOR_VERSION: number
+export declare function resolveDotMemStorageRoot(): string
+export declare function describeDotMemStorage(): unknown
+export declare function readDotMemStorageLocator(): unknown
+export declare function relocateDotMemStorage(target: string): unknown
+export declare function restoreDefaultDotMemStorage(): unknown
+
+// ── Project identity surface ─────────────────────────────────────────────
+export declare function resolveProjectIdentity(id?: string): Promise<string>
+
+// ── Mem package inspection ──────────────────────────────────────────────
+export declare function inspectMem(mem: unknown, opts?: Record<string, unknown>): unknown
+export declare function signMemPackage(mem: unknown, key: unknown): unknown
+export interface MemInspection {
+  status: 'inspected'
+  version: number
+  entries: unknown[]
+}
+export interface MemInspectionStatus {
+  valid: boolean
+  errors?: string[]
+}
+
+// ── Profile ──────────────────────────────────────────────────────────────
+export interface DotMemProfileDocument {
+  readonly name: string
+  readonly content: string
+}
+export interface DotMemProfile {
+  readonly format: 'dotmem.profile'
+  readonly version: 1
+  readonly id: 'joy'
+  readonly name: 'Joy'
+  readonly alternative: ['Jo']
+  readonly documents: ReadonlyArray<DotMemProfileDocument>
+  readonly type: 'ai-persona'
+  readonly role: string
+  readonly immutable: true
+  readonly description: string
+}
+export declare const JO_PROFILE: Readonly<DotMemProfile>
+
+// ── Mutation engine extras ──────────────────────────────────────────────
+export declare function currentTimestamp(): string
+export declare function activeTransactionId(): string | null
+
+// --- Foundation values from Memorio (ambient globals) ---declare const state: any
+export declare const store: any
+export declare const session: any
+export declare const cache: LlmCacheAPI
+export declare const idb: any
+export declare const sqlite: any
+export declare const observer: any
+export declare const schema: any
+export declare function registerSchema(path: string, schema: any): void
+export declare function validate(path: string, value: any): { valid: boolean; errors?: string[] }
+export declare function unregisterSchema(path: string): boolean
+export declare function listSchemas(): string[]
+export declare const typed: <T extends Record<string, any>>() => T
+export declare const computed: any
+export declare const broadcast: any
+export declare const message: (...args: unknown[]) => void
+export declare const logger: any
+export declare const snapshot: () => Record<string, any>
+export declare function diff(snap: Record<string, any>): Array<{ path: string; oldValue: any; newValue: any }>
+export declare function undo(): any
+export declare function redo(): any
+export declare function canUndo(): boolean
+export declare function canRedo(): boolean
+export declare function rollback(snap: Record<string, any>): void
+export declare function trace(): any[]
+export declare function enableHistory(enabled?: boolean): void
+export declare function clearHistory(): void
+export declare function clearRedo(): void
+export declare function createMutation(path: string, operation: any, before: any, after: any, opts?: { context?: string; source?: string; transactionId?: string }): unknown
+export declare function recordMutation(mutation: unknown): void
+export declare function toPatch(mutation: unknown): unknown | null
+export declare function mutate(path: string, value: any, opts?: { source?: string; transactionId?: string }): unknown
+export declare function beginTransaction(source?: string, message?: string, metadata?: Record<string, any>): unknown
+export declare function commitTransaction(): unknown
+export declare function abortTransaction(): unknown
+export declare function currentTransaction(): unknown
+export declare function listTransactions(): unknown[]
+export declare const transaction: (source?: string, message?: string, metadata?: Record<string, any>) => unknown
+export declare function generateMutationId(): string
+export declare function generateTransactionId(): string
+export declare function generateCommitId(): string
+export declare function mutationToPatch(mutation: unknown): unknown | null
+export declare function diffToPatch(path: string, before: any, after: any): unknown | null
+export declare function canMerge(p1: unknown, p2: unknown): boolean
+export declare function mergePatches(p1: unknown, p2: unknown): unknown
+export declare function dispatch(event: string, payload?: unknown): Promise<void>
+export declare function isDotMemCodename(value: string): boolean
+export declare function codenameKeyFor(value: string): string | undefined
+export declare function renderCodenames(): string
+export declare const CODENAMES: Record<string, string>
+export declare const CODENAME_DETAILS: Record<string, unknown>
+export declare function propertyName(container: any, object: any): string | null
+export declare const internal: any
+export declare function setContext(id: string): void
+export declare function getContext(): string | null
+export declare const hlc: any
+export declare const fractional: any
+export declare const encryption: any
+export declare const securityEncryption: any
+export declare const devtools: any
+export declare function help(): void
+export declare const temporal: any
+export declare const events: Record<string, any>
+export declare const dotmem: any
+export declare function isBrowser(): boolean
+export declare function isNode(): boolean
+export declare function isDeno(): boolean
+export declare function isBun(): boolean
+export declare function isEdge(): boolean
+export declare function getCapabilities(): unknown
+export declare function createContext(name?: string, opts?: { encryptionKey?: any }): unknown
+export declare function listContexts(): unknown[]
+export declare function deleteContext(id: string): void
+export declare function isolate(name?: string, opts?: { encryptionKey?: any }): void
+
+export default dotmem