@steno-ai/engine 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,296 @@
+import { z } from 'zod';
+export declare const unitFloat: z.ZodNumber;
+export declare const EntityFieldSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<["string", "number", "boolean", "date"]>;
+    description: z.ZodString;
+    required: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    type: "string" | "number" | "boolean" | "date";
+    description: string;
+    required: boolean;
+}, {
+    name: string;
+    type: "string" | "number" | "boolean" | "date";
+    description: string;
+    required?: boolean | undefined;
+}>;
+export type EntityField = z.infer<typeof EntityFieldSchema>;
+export declare const DomainEntityTypeSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<["string", "number", "boolean", "date"]>;
+        description: z.ZodString;
+        required: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        type: "string" | "number" | "boolean" | "date";
+        description: string;
+        required: boolean;
+    }, {
+        name: string;
+        type: "string" | "number" | "boolean" | "date";
+        description: string;
+        required?: boolean | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    fields: {
+        name: string;
+        type: "string" | "number" | "boolean" | "date";
+        description: string;
+        required: boolean;
+    }[];
+}, {
+    name: string;
+    description: string;
+    fields?: {
+        name: string;
+        type: "string" | "number" | "boolean" | "date";
+        description: string;
+        required?: boolean | undefined;
+    }[] | undefined;
+}>;
+export type DomainEntityType = z.infer<typeof DomainEntityTypeSchema>;
+export declare const DomainSchemaSchema: z.ZodObject<{
+    entityTypes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodEnum<["string", "number", "boolean", "date"]>;
+            description: z.ZodString;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            type: "string" | "number" | "boolean" | "date";
+            description: string;
+            required: boolean;
+        }, {
+            name: string;
+            type: "string" | "number" | "boolean" | "date";
+            description: string;
+            required?: boolean | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description: string;
+        fields: {
+            name: string;
+            type: "string" | "number" | "boolean" | "date";
+            description: string;
+            required: boolean;
+        }[];
+    }, {
+        name: string;
+        description: string;
+        fields?: {
+            name: string;
+            type: "string" | "number" | "boolean" | "date";
+            description: string;
+            required?: boolean | undefined;
+        }[] | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    entityTypes: {
+        name: string;
+        description: string;
+        fields: {
+            name: string;
+            type: "string" | "number" | "boolean" | "date";
+            description: string;
+            required: boolean;
+        }[];
+    }[];
+}, {
+    entityTypes?: {
+        name: string;
+        description: string;
+        fields?: {
+            name: string;
+            type: "string" | "number" | "boolean" | "date";
+            description: string;
+            required?: boolean | undefined;
+        }[] | undefined;
+    }[] | undefined;
+}>;
+export type DomainSchema = z.infer<typeof DomainSchemaSchema>;
+export declare const StenoConfigSchema: z.ZodObject<{
+    embeddingModel: z.ZodDefault<z.ZodString>;
+    embeddingDim: z.ZodDefault<z.ZodNumber>;
+    decayHalfLifeDays: z.ZodDefault<z.ZodNumber>;
+    decayNormalizationK: z.ZodDefault<z.ZodNumber>;
+    maxFactsPerScope: z.ZodDefault<z.ZodNumber>;
+    retrievalWeights: z.ZodDefault<z.ZodObject<{
+        vector: z.ZodDefault<z.ZodNumber>;
+        keyword: z.ZodDefault<z.ZodNumber>;
+        graph: z.ZodDefault<z.ZodNumber>;
+        recency: z.ZodDefault<z.ZodNumber>;
+        salience: z.ZodDefault<z.ZodNumber>;
+        temporal: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        vector: number;
+        keyword: number;
+        graph: number;
+        recency: number;
+        salience: number;
+        temporal: number;
+    }, {
+        vector?: number | undefined;
+        keyword?: number | undefined;
+        graph?: number | undefined;
+        recency?: number | undefined;
+        salience?: number | undefined;
+        temporal?: number | undefined;
+    }>>;
+    domainSchema: z.ZodOptional<z.ZodObject<{
+        entityTypes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            fields: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodEnum<["string", "number", "boolean", "date"]>;
+                description: z.ZodString;
+                required: z.ZodDefault<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                type: "string" | "number" | "boolean" | "date";
+                description: string;
+                required: boolean;
+            }, {
+                name: string;
+                type: "string" | "number" | "boolean" | "date";
+                description: string;
+                required?: boolean | undefined;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description: string;
+            fields: {
+                name: string;
+                type: "string" | "number" | "boolean" | "date";
+                description: string;
+                required: boolean;
+            }[];
+        }, {
+            name: string;
+            description: string;
+            fields?: {
+                name: string;
+                type: "string" | "number" | "boolean" | "date";
+                description: string;
+                required?: boolean | undefined;
+            }[] | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        entityTypes: {
+            name: string;
+            description: string;
+            fields: {
+                name: string;
+                type: "string" | "number" | "boolean" | "date";
+                description: string;
+                required: boolean;
+            }[];
+        }[];
+    }, {
+        entityTypes?: {
+            name: string;
+            description: string;
+            fields?: {
+                name: string;
+                type: "string" | "number" | "boolean" | "date";
+                description: string;
+                required?: boolean | undefined;
+            }[] | undefined;
+        }[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    embeddingModel: string;
+    embeddingDim: number;
+    decayHalfLifeDays: number;
+    decayNormalizationK: number;
+    maxFactsPerScope: number;
+    retrievalWeights: {
+        vector: number;
+        keyword: number;
+        graph: number;
+        recency: number;
+        salience: number;
+        temporal: number;
+    };
+    domainSchema?: {
+        entityTypes: {
+            name: string;
+            description: string;
+            fields: {
+                name: string;
+                type: "string" | "number" | "boolean" | "date";
+                description: string;
+                required: boolean;
+            }[];
+        }[];
+    } | undefined;
+}, {
+    embeddingModel?: string | undefined;
+    embeddingDim?: number | undefined;
+    decayHalfLifeDays?: number | undefined;
+    decayNormalizationK?: number | undefined;
+    maxFactsPerScope?: number | undefined;
+    retrievalWeights?: {
+        vector?: number | undefined;
+        keyword?: number | undefined;
+        graph?: number | undefined;
+        recency?: number | undefined;
+        salience?: number | undefined;
+        temporal?: number | undefined;
+    } | undefined;
+    domainSchema?: {
+        entityTypes?: {
+            name: string;
+            description: string;
+            fields?: {
+                name: string;
+                type: "string" | "number" | "boolean" | "date";
+                description: string;
+                required?: boolean | undefined;
+            }[] | undefined;
+        }[] | undefined;
+    } | undefined;
+}>;
+export type StenoConfig = z.infer<typeof StenoConfigSchema>;
+export declare const SCOPES: readonly ["user", "agent", "session", "hive"];
+export type Scope = (typeof SCOPES)[number];
+export declare const SESSION_SCOPES: readonly ["user", "agent", "hive"];
+export type SessionScope = (typeof SESSION_SCOPES)[number];
+export declare const OPERATIONS: readonly ["create", "update", "invalidate"];
+export type Operation = (typeof OPERATIONS)[number];
+export declare const CONTRADICTION_STATUSES: readonly ["none", "active", "resolved", "superseded"];
+export type ContradictionStatus = (typeof CONTRADICTION_STATUSES)[number];
+export declare const SOURCE_TYPES: readonly ["conversation", "document", "url", "raw_text", "api", "agent_self"];
+export type SourceType = (typeof SOURCE_TYPES)[number];
+export declare const EXTRACTION_TIERS: readonly ["heuristic", "cheap_llm", "smart_llm"];
+export type ExtractionTier = (typeof EXTRACTION_TIERS)[number];
+export declare const EXTRACTION_TIERS_USED: readonly ["heuristic", "cheap_llm", "smart_llm", "multi_tier"];
+export type ExtractionTierUsed = (typeof EXTRACTION_TIERS_USED)[number];
+export declare const MODALITIES: readonly ["text", "image", "audio", "code", "document"];
+export type Modality = (typeof MODALITIES)[number];
+export declare const EDGE_TYPES: readonly ["associative", "causal", "temporal", "contradictory", "hierarchical", "updates", "extends", "derives"];
+export type EdgeType = (typeof EDGE_TYPES)[number];
+export declare const EXTRACTION_STATUSES: readonly ["queued", "processing", "completed", "failed", "deduped"];
+export type ExtractionStatus = (typeof EXTRACTION_STATUSES)[number];
+export declare const INPUT_TYPES: readonly ["conversation", "document", "url", "raw_text", "image", "audio", "code"];
+export type InputType = (typeof INPUT_TYPES)[number];
+export declare const PLANS: readonly ["free", "pro", "scale", "enterprise"];
+export type Plan = (typeof PLANS)[number];
+export declare const API_KEY_SCOPES: readonly ["read", "write", "admin"];
+export type ApiKeyScope = (typeof API_KEY_SCOPES)[number];
+export declare const FEEDBACK_TYPES: readonly ["implicit_positive", "implicit_negative", "explicit_positive", "explicit_negative", "correction"];
+export type FeedbackType = (typeof FEEDBACK_TYPES)[number];
+export declare const ENTITY_ROLES: readonly ["subject", "object", "mentioned"];
+export type EntityRole = (typeof ENTITY_ROLES)[number];
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,SAAS,aAA2B,CAAC;AAMlD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAK5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAG9D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiB5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,MAAM,+CAAgD,CAAC;AACpE,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAG5C,eAAO,MAAM,cAAc,oCAAqC,CAAC;AACjE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,eAAO,MAAM,UAAU,6CAA8C,CAAC;AACtE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD,eAAO,MAAM,sBAAsB,uDAAwD,CAAC;AAC5F,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,eAAO,MAAM,YAAY,+EAOf,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,gBAAgB,kDAAmD,CAAC;AACjF,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,eAAO,MAAM,qBAAqB,gEAA+C,CAAC;AAClF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,eAAO,MAAM,UAAU,yDAA0D,CAAC;AAClF,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,eAAO,MAAM,UAAU,kHASb,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,eAAO,MAAM,mBAAmB,qEAMtB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,WAAW,oFAQd,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,eAAO,MAAM,KAAK,iDAAkD,CAAC;AACrE,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1C,eAAO,MAAM,cAAc,qCAAsC,CAAC;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,eAAO,MAAM,cAAc,6GAMjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,eAAO,MAAM,YAAY,6CAA8C,CAAC;AACxE,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/config.js

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+// Shared Zod helpers
+export const unitFloat = z.number().min(0).max(1);
+// ---------------------------------------------------------------------------
+// Domain-scoped graph schemas — custom entity types with typed attributes
+// ---------------------------------------------------------------------------
+export const EntityFieldSchema = z.object({
+    name: z.string(),
+    type: z.enum(['string', 'number', 'boolean', 'date']),
+    description: z.string(),
+    required: z.boolean().default(false),
+});
+export const DomainEntityTypeSchema = z.object({
+    name: z.string(),
+    description: z.string(),
+    fields: z.array(EntityFieldSchema).default([]),
+});
+export const DomainSchemaSchema = z.object({
+    entityTypes: z.array(DomainEntityTypeSchema).default([]),
+});
+// Steno engine configuration schema
+export const StenoConfigSchema = z.object({
+    embeddingModel: z.string().default('text-embedding-3-small'),
+    embeddingDim: z.number().int().positive().default(1536),
+    decayHalfLifeDays: z.number().positive().default(30),
+    decayNormalizationK: z.number().positive().default(50),
+    maxFactsPerScope: z.number().int().positive().default(10000),
+    retrievalWeights: z
+        .object({
+        vector: z.number().min(0).max(1).default(0.35),
+        keyword: z.number().min(0).max(1).default(0.15),
+        graph: z.number().min(0).max(1).default(0.2),
+        recency: z.number().min(0).max(1).default(0.15),
+        salience: z.number().min(0).max(1).default(0.15),
+        temporal: z.number().min(0).max(1).default(0.20),
+    })
+        .default({}),
+    domainSchema: DomainSchemaSchema.optional(),
+});
+export const SCOPES = ['user', 'agent', 'session', 'hive'];
+// SESSION_SCOPES is a subset of SCOPES — sessions themselves cannot be scoped to another session
+export const SESSION_SCOPES = ['user', 'agent', 'hive'];
+export const OPERATIONS = ['create', 'update', 'invalidate'];
+export const CONTRADICTION_STATUSES = ['none', 'active', 'resolved', 'superseded'];
+export const SOURCE_TYPES = [
+    'conversation',
+    'document',
+    'url',
+    'raw_text',
+    'api',
+    'agent_self',
+];
+export const EXTRACTION_TIERS = ['heuristic', 'cheap_llm', 'smart_llm'];
+export const EXTRACTION_TIERS_USED = [...EXTRACTION_TIERS, 'multi_tier'];
+export const MODALITIES = ['text', 'image', 'audio', 'code', 'document'];
+export const EDGE_TYPES = [
+    'associative',
+    'causal',
+    'temporal',
+    'contradictory',
+    'hierarchical',
+    'updates', // new fact supersedes old one (knowledge chain)
+    'extends', // new fact adds detail to old one
+    'derives', // new fact is inferred from combining others
+];
+export const EXTRACTION_STATUSES = [
+    'queued',
+    'processing',
+    'completed',
+    'failed',
+    'deduped',
+];
+export const INPUT_TYPES = [
+    'conversation',
+    'document',
+    'url',
+    'raw_text',
+    'image',
+    'audio',
+    'code',
+];
+export const PLANS = ['free', 'pro', 'scale', 'enterprise'];
+export const API_KEY_SCOPES = ['read', 'write', 'admin'];
+export const FEEDBACK_TYPES = [
+    'implicit_positive',
+    'implicit_negative',
+    'explicit_positive',
+    'explicit_negative',
+    'correction',
+];
+export const ENTITY_ROLES = ['subject', 'object', 'mentioned'];
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/extraction/contradiction.d.ts

@@ -0,0 +1,15 @@
+import type { ExtractedFact } from './types.js';
+import type { ContradictionStatus } from '../config.js';
+export interface ContradictionResult {
+    fact: ExtractedFact;
+    contradictionStatus: ContradictionStatus;
+    contradictsId: string | null;
+}
+/**
+ * Process extracted facts and annotate contradictions.
+ * Facts with operation='contradict' get contradictionStatus='active'
+ * and contradictsId set to the fact they contradict.
+ * All other facts get contradictionStatus='none'.
+ */
+export declare function processContradictions(facts: ExtractedFact[]): ContradictionResult[];
+//# sourceMappingURL=contradiction.d.ts.map

package/dist/extraction/contradiction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contradiction.d.ts","sourceRoot":"","sources":["../../src/extraction/contradiction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,aAAa,EAAE,GACrB,mBAAmB,EAAE,CAevB"}

package/dist/extraction/contradiction.js

@@ -0,0 +1,23 @@
+/**
+ * Process extracted facts and annotate contradictions.
+ * Facts with operation='contradict' get contradictionStatus='active'
+ * and contradictsId set to the fact they contradict.
+ * All other facts get contradictionStatus='none'.
+ */
+export function processContradictions(facts) {
+    return facts.map(fact => {
+        if (fact.operation === 'contradict' && fact.contradictsFactId) {
+            return {
+                fact,
+                contradictionStatus: 'active',
+                contradictsId: fact.contradictsFactId,
+            };
+        }
+        return {
+            fact,
+            contradictionStatus: 'none',
+            contradictsId: null,
+        };
+    });
+}
+//# sourceMappingURL=contradiction.js.map

package/dist/extraction/contradiction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contradiction.js","sourceRoot":"","sources":["../../src/extraction/contradiction.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAsB;IAEtB,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACtB,IAAI,IAAI,CAAC,SAAS,KAAK,YAAY,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC9D,OAAO;gBACL,IAAI;gBACJ,mBAAmB,EAAE,QAAiB;gBACtC,aAAa,EAAE,IAAI,CAAC,iBAAiB;aACtC,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI;YACJ,mBAAmB,EAAE,MAAe;YACpC,aAAa,EAAE,IAAI;SACpB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/extraction/dedup.d.ts

@@ -0,0 +1,12 @@
+import type { EmbeddingAdapter } from '../adapters/embedding.js';
+import type { LLMAdapter } from '../adapters/llm.js';
+import type { StorageAdapter } from '../adapters/storage.js';
+import type { ExtractedFact } from './types.js';
+export interface DedupConfig {
+    storage: StorageAdapter;
+    embedding: EmbeddingAdapter;
+    llm: LLMAdapter;
+    similarityThreshold?: number;
+}
+export declare function deduplicateFacts(config: DedupConfig, facts: ExtractedFact[], tenantId: string, scope: string, scopeId: string): Promise<ExtractedFact[]>;
+//# sourceMappingURL=dedup.d.ts.map

package/dist/extraction/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../src/extraction/dedup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,GAAG,EAAE,UAAU,CAAC;IAChB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,aAAa,EAAE,EACtB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,EAAE,CAAC,CA+C1B"}

package/dist/extraction/dedup.js

@@ -0,0 +1,93 @@
+export async function deduplicateFacts(config, facts, tenantId, scope, scopeId) {
+    const threshold = config.similarityThreshold ?? 0.55;
+    const result = [];
+    for (const fact of facts) {
+        // If LLM already decided and it's not 'add', trust it
+        if (fact.operation && fact.operation !== 'add') {
+            result.push(fact);
+            continue;
+        }
+        // Embed the fact
+        const embedding = await config.embedding.embed(fact.content);
+        // Search for similar existing facts
+        const matches = await config.storage.vectorSearch({
+            embedding,
+            tenantId,
+            scope,
+            scopeId,
+            limit: 5,
+            minSimilarity: threshold,
+            validOnly: true,
+        });
+        if (matches.length === 0) {
+            // No similar facts — this is new
+            result.push({ ...fact, operation: 'add' });
+            continue;
+        }
+        // Similar facts found — ask LLM to classify
+        const decision = await classifyWithLLM(config.llm, fact.content, matches.map(m => ({
+            id: m.fact.id,
+            lineageId: m.fact.lineageId ?? '',
+            content: m.fact.content,
+            similarity: m.similarity,
+        })));
+        result.push({ ...fact, ...decision });
+    }
+    return result;
+}
+async function classifyWithLLM(llm, candidateContent, existingMatches) {
+    const messages = [
+        {
+            role: 'system',
+            content: `You are a memory deduplication classifier. Compare a NEW fact against EXISTING facts.
+
+RULES:
+- "noop" if the new fact says the SAME thing as an existing fact (even with different wording). Be AGGRESSIVE about noop — "User's name is Caroline" and "User is called Caroline" are NOOP.
+- "update" if the new fact adds detail or changes a value ("User likes cats" → "User loves cats and has 3")
+- "contradict" if the new fact directly conflicts ("User likes cats" vs "User hates cats")
+- "add" ONLY if genuinely new information not covered by ANY existing fact
+
+Return JSON:
+{"operation": "add|update|noop|contradict", "existing_lineage_id": "...", "contradicts_fact_id": "..."}
+
+Return ONLY valid JSON.`,
+        },
+        {
+            role: 'user',
+            content: `NEW FACT: "${candidateContent}"
+
+EXISTING FACTS:
+${existingMatches.map(m => `[id: ${m.id}, lineage_id: ${m.lineageId}, similarity: ${m.similarity.toFixed(3)}] ${m.content}`).join('\n')}
+
+Classify the new fact.`,
+        },
+    ];
+    try {
+        const response = await llm.complete(messages, { temperature: 0, responseFormat: 'json' });
+        const parsed = JSON.parse(response.content);
+        const operation = isValidDedupOp(parsed.operation) ? parsed.operation : 'add';
+        // Map dedup operations to relational versioning types
+        const relationType = operation === 'update' ? 'updates'
+            : operation === 'contradict' ? 'updates'
+                : undefined;
+        // Find the best matching existing fact for the relation
+        const relatedFactId = (operation === 'update' || operation === 'contradict') && existingMatches.length > 0
+            ? existingMatches[0].id
+            : undefined;
+        return {
+            operation,
+            existingLineageId: typeof parsed.existing_lineage_id === 'string' ? parsed.existing_lineage_id : undefined,
+            contradictsFactId: typeof parsed.contradicts_fact_id === 'string' ? parsed.contradicts_fact_id : undefined,
+            relationType,
+            relatedFactId,
+        };
+    }
+    catch {
+        // If LLM fails, default to 'add' (safe — might create a duplicate, but won't lose data)
+        return { operation: 'add' };
+    }
+}
+function isValidDedupOp(op) {
+    return typeof op === 'string' && ['add', 'update', 'noop', 'contradict', 'invalidate'].includes(op);
+}
+//# sourceMappingURL=dedup.js.map

package/dist/extraction/dedup.js.map

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

package/dist/extraction/entity-extractor.d.ts

@@ -0,0 +1,30 @@
+import type { StorageAdapter } from '../adapters/storage.js';
+import type { EmbeddingAdapter } from '../adapters/embedding.js';
+import type { ExtractedEntity, ExtractedEdge } from './types.js';
+export interface EntityPersistenceResult {
+    entitiesCreated: number;
+    edgesCreated: number;
+    entityIdMap: Map<string, string>;
+}
+/**
+ * Create or find all entities in the database.
+ * Does NOT link entities to any fact or create edges.
+ * Returns a map of canonicalName → entity.id for use in subsequent operations.
+ */
+export declare function buildEntityIdMap(storage: StorageAdapter, embedding: EmbeddingAdapter, tenantId: string, entities: ExtractedEntity[]): Promise<{
+    entityIdMap: Map<string, string>;
+    entitiesCreated: number;
+}>;
+export declare function persistEdges(storage: StorageAdapter, tenantId: string, factId: string, edges: ExtractedEdge[], entityIdMap: Map<string, string>): Promise<number>;
+/**
+ * Persist extracted entities and edges to the database.
+ * - Creates new entities if canonical name doesn't exist for this tenant
+ * - Reuses existing entities if canonical name matches
+ * - Links all entities to the fact via fact_entities junction
+ * - Creates edges between entities
+ *
+ * @deprecated Use buildEntityIdMap + persistEdges directly for better control.
+ * This function is kept for backward compatibility.
+ */
+export declare function persistEntitiesAndEdges(storage: StorageAdapter, embedding: EmbeddingAdapter, tenantId: string, factId: string, entities: ExtractedEntity[], edges: ExtractedEdge[]): Promise<EntityPersistenceResult>;
+//# sourceMappingURL=entity-extractor.d.ts.map

package/dist/extraction/entity-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-extractor.d.ts","sourceRoot":"","sources":["../../src/extraction/entity-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,eAAe,EAAE,GAC1B,OAAO,CAAC;IAAE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC,CAuCxE;AA8CD,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,aAAa,EAAE,EACtB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC,CA6CjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,EAAE,EAC3B,KAAK,EAAE,aAAa,EAAE,GACrB,OAAO,CAAC,uBAAuB,CAAC,CAiBlC"}