@utaba/deep-memory 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,121 @@
+import { v as ProvenanceContext, C as CreateEntityInput, x as Entity, U as UpdateEntityInput, r as CreateRelationshipInput, H as Relationship, V as VocabularyChangeRecord } from '../portability-DdlNYXGX.js';
+export { B as BulkImportResult, W as ConceptSearchOptions, D as DetailLevel, a7 as EnrichedRelationship, z as EntityBrief, a8 as EntityMap, y as EntitySummary, s as EntityTypeDefinition, a9 as EntityTypeInput, N as ExploreOptions, a0 as ExportArchive, E as ExportChunk, aa as ExportManifest, a3 as ExportStreamItem, F as FindEntitiesQuery, ab as GetEntitiesOptions, ac as GetEntityOptions, G as GovernanceConfig, ad as GovernanceMode, L as GraphResult, I as ImportChunk, a1 as ImportOptions, a2 as ImportResult, a4 as ImportStreamHeader, ae as ImportWarning, M as MemoryVocabulary, O as Neighbourhood, af as NeighbourhoodCentre, ag as NeighbourhoodGroup, ah as NeighbourhoodLayer, P as PaginatedResult, e as PaginationOptions, ai as Path, Q as PathOptions, T as PathResult, J as PropertyFilter, aj as PropertySchema, ak as PropertyType, w as Provenance, al as ProvenanceFilter, A as ReembedResult, am as RelationshipDirection, j as RelationshipQueryOptions, K as RelationshipSummary, an as RelationshipTypeDefinition, ao as RelationshipTypeInput, _ as RepositoryConfig, R as RepositoryFilter, ap as RepositoryMetadata, d as RepositoryStats, $ as RepositorySummary, c as RepositoryUpdate, q as ResolvedVocabulary, X as ScoredEntity, a6 as SearchHit, a5 as SearchOptions, k as StorageExploreOptions, h as StorageFindQuery, l as StorageNeighbourhood, aq as StorageNeighbourhoodGroup, ar as StorageNeighbourhoodLayer, as as StoragePath, m as StoragePathOptions, n as StoragePathResult, S as StorageRepositoryConfig, at as StorageTimelineEvent, o as StorageTimelineOptions, p as StorageTimelineResult, f as StoredEntity, g as StoredEntityUpdate, i as StoredRelationship, a as StoredRepository, b as StoredRepositorySummary, au as TimelineEntityRef, av as TimelineEvent, Y as TimelineOptions, aw as TimelineRelationshipDetail, Z as TimelineResult, ax as VocabularyInput, t as VocabularyProposal, u as VocabularyProposalResult } from '../portability-DdlNYXGX.js';
+
+/** All event types emitted by the Deep Memory engine */
+type DeepMemoryEventType = 'repository:created' | 'repository:opened' | 'repository:updated' | 'repository:deleted' | 'entity:creating' | 'entity:created' | 'entity:updating' | 'entity:updated' | 'entity:deleting' | 'entity:deleted' | 'relationship:creating' | 'relationship:created' | 'relationship:removing' | 'relationship:removed' | 'vocabulary:proposal' | 'vocabulary:approved' | 'vocabulary:rejected' | 'vocabulary:pending' | 'vocabulary:changed' | 'validation:failed' | 'search:executed' | 'reembed:started' | 'reembed:progress' | 'reembed:completed' | 'reembed:failed' | 'export:started' | 'export:progress' | 'export:completed' | 'import:started' | 'import:progress' | 'import:completed' | 'import:failed';
+/** Type-safe event payload mapping */
+type EventPayload<T extends DeepMemoryEventType> = T extends 'repository:created' ? {
+    repositoryId: string;
+    label: string;
+} : T extends 'repository:opened' ? {
+    repositoryId: string;
+} : T extends 'repository:updated' ? {
+    repositoryId: string;
+} : T extends 'repository:deleted' ? {
+    repositoryId: string;
+} : T extends 'entity:creating' ? {
+    input: CreateEntityInput;
+} : T extends 'entity:created' ? {
+    entity: Entity;
+} : T extends 'entity:updating' ? {
+    id: string;
+    updates: UpdateEntityInput;
+} : T extends 'entity:updated' ? {
+    entity: Entity;
+} : T extends 'entity:deleting' ? {
+    id: string;
+} : T extends 'entity:deleted' ? {
+    id: string;
+} : T extends 'relationship:creating' ? {
+    input: CreateRelationshipInput;
+} : T extends 'relationship:created' ? {
+    relationship: Relationship;
+} : T extends 'relationship:removing' ? {
+    id: string;
+} : T extends 'relationship:removed' ? {
+    id: string;
+} : T extends 'vocabulary:proposal' ? {
+    proposal: VocabularyChangeRecord;
+} : T extends 'vocabulary:approved' ? {
+    change: VocabularyChangeRecord;
+} : T extends 'vocabulary:rejected' ? {
+    reason: string;
+    duplicates?: Array<{
+        type: string;
+        similarity: number;
+    }>;
+} : T extends 'vocabulary:pending' ? {
+    proposalId: string;
+} : T extends 'vocabulary:changed' ? {
+    previousVersion: string;
+    newVersion: string;
+    change: VocabularyChangeRecord;
+} : T extends 'validation:failed' ? {
+    operation: string;
+    error: string;
+    suggestions?: string[];
+} : T extends 'search:executed' ? {
+    query: string;
+    resultCount: number;
+} : T extends 'reembed:started' ? {
+    repositoryId: string;
+    totalEntities: number;
+} : T extends 'reembed:progress' ? {
+    repositoryId: string;
+    processed: number;
+    totalEntities: number;
+    failed: number;
+} : T extends 'reembed:completed' ? {
+    repositoryId: string;
+    processed: number;
+    failed: number;
+    modelId: string;
+} : T extends 'reembed:failed' ? {
+    repositoryId: string;
+    error: string;
+} : T extends 'export:started' ? {
+    repositoryId: string;
+} : T extends 'export:progress' ? {
+    repositoryId: string;
+    entitiesExported: number;
+    totalEntities: number;
+} : T extends 'export:completed' ? {
+    repositoryId: string;
+    entityCount: number;
+    relationshipCount: number;
+} : T extends 'import:started' ? {
+    repositoryId: string;
+} : T extends 'import:progress' ? {
+    repositoryId: string;
+    entitiesImported: number;
+    totalEntities: number;
+} : T extends 'import:completed' ? {
+    repositoryId: string;
+    entitiesImported: number;
+    relationshipsImported: number;
+} : T extends 'import:failed' ? {
+    repositoryId: string;
+    error: string;
+} : Record<string, unknown>;
+/** A typed event emitted by the engine */
+interface DeepMemoryEvent<T extends DeepMemoryEventType> {
+    type: T;
+    timestamp: string;
+    repositoryId?: string;
+    provenance: ProvenanceContext;
+    payload: EventPayload<T>;
+}
+/** Event handler function */
+type EventHandler<T extends DeepMemoryEventType> = (event: DeepMemoryEvent<T>) => void | Promise<void>;
+/** Unsubscribe function returned by on() */
+type Unsubscribe = () => void;
+/**
+ * Result from a pre-mutation hook handler.
+ * Return `{ cancel: true, reason }` to abort the operation.
+ */
+interface HookResult {
+    cancel?: boolean;
+    reason?: string;
+}
+
+export { CreateEntityInput, CreateRelationshipInput, type DeepMemoryEvent, type DeepMemoryEventType, Entity, type EventHandler, type EventPayload, type HookResult, ProvenanceContext, Relationship, type Unsubscribe, UpdateEntityInput, VocabularyChangeRecord };

package/dist/types/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@utaba/deep-memory",
+  "version": "0.1.0",
+  "description": "Vocabulary-driven graph memory for AI agents",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./providers": {
+      "import": {
+        "types": "./dist/providers/index.d.ts",
+        "default": "./dist/providers/index.js"
+      },
+      "require": {
+        "types": "./dist/providers/index.d.cts",
+        "default": "./dist/providers/index.cjs"
+      }
+    },
+    "./types": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/types/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.cts",
+        "default": "./dist/types/index.cjs"
+      }
+    },
+    "./testing": {
+      "import": {
+        "types": "./dist/testing/conformance.d.ts",
+        "default": "./dist/testing/conformance.js"
+      },
+      "require": {
+        "types": "./dist/testing/conformance.d.cts",
+        "default": "./dist/testing/conformance.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "Apache-2.0",
+  "homepage": "https://utaba.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TjWheeler/deep-memory.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/TjWheeler/deep-memory/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "keywords": [
+    "ai",
+    "memory",
+    "graph",
+    "knowledge-graph",
+    "mcp",
+    "agents",
+    "vocabulary"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit"
+  }
+}