@kybernesis/brain-contracts 0.1.0

package/dist/constants.d.ts

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+export declare const TierSchema: z.ZodEnum<["hot", "warm", "archive"]>;
+export type Tier = z.infer<typeof TierSchema>;
+export declare const EventTypeSchema: z.ZodEnum<["conversation", "idea", "file", "transcript", "note", "intake"]>;
+export type EventType = z.infer<typeof EventTypeSchema>;
+export declare const FactCategorySchema: z.ZodEnum<["biographical", "preference", "event", "relationship", "temporal", "opinion", "plan", "general"]>;
+export type FactCategory = z.infer<typeof FactCategorySchema>;
+export declare const EntityTypeSchema: z.ZodEnum<["person", "company", "project", "place", "topic"]>;
+export type EntityType = z.infer<typeof EntityTypeSchema>;
+export declare const RelationshipTypeSchema: z.ZodEnum<["co-occurred", "founded", "works_at", "invested_in", "met_with", "created", "manages", "partners_with", "located_in", "discussed", "related_to", "reports_to", "uses", "depends_on", "part_of"]>;
+export type RelationshipType = z.infer<typeof RelationshipTypeSchema>;
+export declare const DIRECTIONAL_RELATIONSHIPS: ReadonlySet<RelationshipType>;
+export declare const MemoryEdgeRelationSchema: z.ZodEnum<["related", "continuation", "referenced", "same_topic", "same_person"]>;
+export type MemoryEdgeRelation = z.infer<typeof MemoryEdgeRelationSchema>;
+export declare const MemoryEdgeMethodSchema: z.ZodEnum<["sleep-agent", "manual", "co-occurred", "ai-suggested"]>;
+export type MemoryEdgeMethod = z.infer<typeof MemoryEdgeMethodSchema>;
+export declare const InsightTypeSchema: z.ZodEnum<["inference", "pattern", "quality", "synthesis"]>;
+export type InsightType = z.infer<typeof InsightTypeSchema>;
+export declare const SleepStatusSchema: z.ZodEnum<["running", "completed", "failed", "paused"]>;
+export type SleepStatus = z.infer<typeof SleepStatusSchema>;
+export declare const SOURCE_CONFIDENCE: {
+    readonly 'user-correction': 1;
+    readonly 'user-direct': 0.95;
+    readonly chat: 0.85;
+    readonly heartbeat: 0.8;
+    readonly 'ai-extraction': 0.6;
+};
+export type SourceConfidenceKey = keyof typeof SOURCE_CONFIDENCE;
+export declare const CHANNEL_SOURCE_TYPE: Record<string, SourceConfidenceKey>;
+export declare function channelToSourceType(channel: string): SourceConfidenceKey;
+export declare const EMBEDDING_MODEL = "text-embedding-3-small";
+export declare const EMBEDDING_DIM = 1536;
+export declare const EMBEDDING_INPUT_CAP = 8192;
+export declare const RRF_K = 60;
+export declare const MAX_SEGMENTS_PER_PARENT = 3;
+export declare const CLAUDE_MODEL_ALIASES: {
+    readonly haiku: "claude-haiku-4-5-20251001";
+    readonly sonnet: "claude-sonnet-4-6";
+    readonly opus: "claude-opus-4-7";
+};
+export type ClaudeModelAlias = keyof typeof CLAUDE_MODEL_ALIASES;
+export declare const HOP_PENALTY: Record<number, number>;
+export declare const DEFAULT_SLEEP_CONFIG: {
+    readonly intervalMinutes: 60;
+    readonly initialDelayMinutes: 5;
+    readonly batchSize: 50;
+    readonly maxTagsPerRun: 5;
+    readonly maxLinksPerRun: 100;
+    readonly maxSummariesPerRun: 5;
+    readonly maxFactsPerRun: 5;
+    readonly maxContradictionChecksPerRun: 5;
+    readonly maxMergesPerRun: 10;
+    readonly maxReasoningPerRun: 5;
+    readonly maxDecay: 1;
+    readonly decayRatePerHour: 0.002;
+    readonly minConfidenceForLink: 0.15;
+    readonly maxEdgesPerMemory: 5;
+    readonly hotPriorityThreshold: 0.65;
+    readonly warmPriorityThreshold: 0.3;
+    readonly hotDecayThreshold: 0.25;
+    readonly hotAccessDays: 3;
+    readonly warmAccessDays: 21;
+    readonly hotEdgeCount: 6;
+    readonly warmEdgeCount: 3;
+    readonly tagStaleDays: 7;
+    readonly hotWarmSummarySentences: 5;
+    readonly archiveSummarySentences: 3;
+    readonly hygieneConfidenceThreshold: 0.8;
+    readonly pruneMinAgeDays: 30;
+    readonly profileRefreshMinutes: 60;
+    readonly repetitiveDecayMultiplier: 3;
+    readonly consolidationTitleThreshold: 3;
+};
+export type SleepConfig = typeof DEFAULT_SLEEP_CONFIG;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,UAAU,uCAAqC,CAAC;AAC7D,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,eAAO,MAAM,eAAe,6EAO1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,kBAAkB,8GAS7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,gBAAgB,+DAM3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,sBAAsB,6MAgBjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,gBAAgB,CAOlE,CAAC;AAEH,eAAO,MAAM,wBAAwB,mFAMnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,sBAAsB,qEAKjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,iBAAiB,6DAK5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,iBAAiB,yDAK5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAG5D,eAAO,MAAM,iBAAiB;;;;;;CAMpB,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAGjE,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAMnE,CAAC;AACF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAExE;AAGD,eAAO,MAAM,eAAe,2BAA2B,CAAC;AACxD,eAAO,MAAM,aAAa,OAAO,CAAC;AAClC,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAGxC,eAAO,MAAM,KAAK,KAAK,CAAC;AACxB,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAGzC,eAAO,MAAM,oBAAoB;;;;CAIvB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,oBAAoB,CAAC;AAGjE,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAsC,CAAC;AAGtF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BvB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,OAAO,oBAAoB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,145 @@
+import { z } from 'zod';
+export const TierSchema = z.enum(['hot', 'warm', 'archive']);
+export const EventTypeSchema = z.enum([
+    'conversation',
+    'idea',
+    'file',
+    'transcript',
+    'note',
+    'intake',
+]);
+export const FactCategorySchema = z.enum([
+    'biographical',
+    'preference',
+    'event',
+    'relationship',
+    'temporal',
+    'opinion',
+    'plan',
+    'general',
+]);
+export const EntityTypeSchema = z.enum([
+    'person',
+    'company',
+    'project',
+    'place',
+    'topic',
+]);
+export const RelationshipTypeSchema = z.enum([
+    'co-occurred',
+    'founded',
+    'works_at',
+    'invested_in',
+    'met_with',
+    'created',
+    'manages',
+    'partners_with',
+    'located_in',
+    'discussed',
+    'related_to',
+    'reports_to',
+    'uses',
+    'depends_on',
+    'part_of',
+]);
+// Relationships where source/target order is meaningful (asymmetric).
+export const DIRECTIONAL_RELATIONSHIPS = new Set([
+    'founded',
+    'works_at',
+    'invested_in',
+    'created',
+    'manages',
+    'located_in',
+]);
+export const MemoryEdgeRelationSchema = z.enum([
+    'related',
+    'continuation',
+    'referenced',
+    'same_topic',
+    'same_person',
+]);
+export const MemoryEdgeMethodSchema = z.enum([
+    'sleep-agent',
+    'manual',
+    'co-occurred',
+    'ai-suggested',
+]);
+export const InsightTypeSchema = z.enum([
+    'inference',
+    'pattern',
+    'quality',
+    'synthesis',
+]);
+export const SleepStatusSchema = z.enum([
+    'running',
+    'completed',
+    'failed',
+    'paused',
+]);
+// Source confidence values — never change without an ADR.
+export const SOURCE_CONFIDENCE = {
+    'user-correction': 1.0,
+    'user-direct': 0.95,
+    chat: 0.85,
+    heartbeat: 0.80,
+    'ai-extraction': 0.60,
+};
+// Channel → sourceType mapping (matches KAD store-conversation.ts).
+export const CHANNEL_SOURCE_TYPE = {
+    terminal: 'user-direct',
+    heartbeat: 'heartbeat',
+    telegram: 'chat',
+    whatsapp: 'chat',
+    web: 'chat',
+};
+export function channelToSourceType(channel) {
+    return CHANNEL_SOURCE_TYPE[channel] ?? 'chat';
+}
+// Embedding constants.
+export const EMBEDDING_MODEL = 'text-embedding-3-small';
+export const EMBEDDING_DIM = 1536;
+export const EMBEDDING_INPUT_CAP = 8192;
+// Hybrid search constants.
+export const RRF_K = 60;
+export const MAX_SEGMENTS_PER_PARENT = 3;
+// Claude model aliases.
+export const CLAUDE_MODEL_ALIASES = {
+    haiku: 'claude-haiku-4-5-20251001',
+    sonnet: 'claude-sonnet-4-6',
+    opus: 'claude-opus-4-7',
+};
+// Fact-retrieval hop-distance score penalty.
+export const HOP_PENALTY = { 0: 1.0, 1: 0.7, 2: 0.5, 3: 0.3 };
+// Default sleep config (matches KAD sleep/config.ts:61-119).
+export const DEFAULT_SLEEP_CONFIG = {
+    intervalMinutes: 60,
+    initialDelayMinutes: 5,
+    batchSize: 50,
+    maxTagsPerRun: 5,
+    maxLinksPerRun: 100,
+    maxSummariesPerRun: 5,
+    maxFactsPerRun: 5,
+    maxContradictionChecksPerRun: 5,
+    maxMergesPerRun: 10,
+    maxReasoningPerRun: 5,
+    maxDecay: 1.0,
+    decayRatePerHour: 0.002,
+    minConfidenceForLink: 0.15,
+    maxEdgesPerMemory: 5,
+    hotPriorityThreshold: 0.65,
+    warmPriorityThreshold: 0.3,
+    hotDecayThreshold: 0.25,
+    hotAccessDays: 3,
+    warmAccessDays: 21,
+    hotEdgeCount: 6,
+    warmEdgeCount: 3,
+    tagStaleDays: 7,
+    hotWarmSummarySentences: 5,
+    archiveSummarySentences: 3,
+    hygieneConfidenceThreshold: 0.8,
+    pruneMinAgeDays: 30,
+    profileRefreshMinutes: 60,
+    repetitiveDecayMultiplier: 3.0,
+    consolidationTitleThreshold: 3,
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;AAG7D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,cAAc;IACd,MAAM;IACN,MAAM;IACN,YAAY;IACZ,MAAM;IACN,QAAQ;CACT,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,cAAc;IACd,YAAY;IACZ,OAAO;IACP,cAAc;IACd,UAAU;IACV,SAAS;IACT,MAAM;IACN,SAAS;CACV,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC;IACrC,QAAQ;IACR,SAAS;IACT,SAAS;IACT,OAAO;IACP,OAAO;CACR,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,aAAa;IACb,SAAS;IACT,UAAU;IACV,aAAa;IACb,UAAU;IACV,SAAS;IACT,SAAS;IACT,eAAe;IACf,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,MAAM;IACN,YAAY;IACZ,SAAS;CACV,CAAC,CAAC;AAGH,sEAAsE;AACtE,MAAM,CAAC,MAAM,yBAAyB,GAAkC,IAAI,GAAG,CAAC;IAC9E,SAAS;IACT,UAAU;IACV,aAAa;IACb,SAAS;IACT,SAAS;IACT,YAAY;CACb,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC7C,SAAS;IACT,cAAc;IACd,YAAY;IACZ,YAAY;IACZ,aAAa;CACd,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,aAAa;IACb,QAAQ;IACR,aAAa;IACb,cAAc;CACf,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC;IACtC,WAAW;IACX,SAAS;IACT,SAAS;IACT,WAAW;CACZ,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC;IACtC,SAAS;IACT,WAAW;IACX,QAAQ;IACR,QAAQ;CACT,CAAC,CAAC;AAGH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,iBAAiB,EAAE,GAAG;IACtB,aAAa,EAAE,IAAI;IACnB,IAAI,EAAE,IAAI;IACV,SAAS,EAAE,IAAI;IACf,eAAe,EAAE,IAAI;CACb,CAAC;AAGX,oEAAoE;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAwC;IACtE,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,MAAM;IAChB,GAAG,EAAE,MAAM;CACZ,CAAC;AACF,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,mBAAmB,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC;AAChD,CAAC;AAED,uBAAuB;AACvB,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAC;AACxD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAClC,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,2BAA2B;AAC3B,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;AACxB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC,wBAAwB;AACxB,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,KAAK,EAAE,2BAA2B;IAClC,MAAM,EAAE,mBAAmB;IAC3B,IAAI,EAAE,iBAAiB;CACf,CAAC;AAGX,6CAA6C;AAC7C,MAAM,CAAC,MAAM,WAAW,GAA2B,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;AAEtF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,eAAe,EAAE,EAAE;IACnB,mBAAmB,EAAE,CAAC;IACtB,SAAS,EAAE,EAAE;IACb,aAAa,EAAE,CAAC;IAChB,cAAc,EAAE,GAAG;IACnB,kBAAkB,EAAE,CAAC;IACrB,cAAc,EAAE,CAAC;IACjB,4BAA4B,EAAE,CAAC;IAC/B,eAAe,EAAE,EAAE;IACnB,kBAAkB,EAAE,CAAC;IACrB,QAAQ,EAAE,GAAG;IACb,gBAAgB,EAAE,KAAK;IACvB,oBAAoB,EAAE,IAAI;IAC1B,iBAAiB,EAAE,CAAC;IACpB,oBAAoB,EAAE,IAAI;IAC1B,qBAAqB,EAAE,GAAG;IAC1B,iBAAiB,EAAE,IAAI;IACvB,aAAa,EAAE,CAAC;IAChB,cAAc,EAAE,EAAE;IAClB,YAAY,EAAE,CAAC;IACf,aAAa,EAAE,CAAC;IAChB,YAAY,EAAE,CAAC;IACf,uBAAuB,EAAE,CAAC;IAC1B,uBAAuB,EAAE,CAAC;IAC1B,0BAA0B,EAAE,GAAG;IAC/B,eAAe,EAAE,EAAE;IACnB,qBAAqB,EAAE,EAAE;IACzB,yBAAyB,EAAE,GAAG;IAC9B,2BAA2B,EAAE,CAAC;CACtB,CAAC"}

package/dist/entity.d.ts

@@ -0,0 +1,246 @@
+import { z } from 'zod';
+export declare const EntitySchema: z.ZodObject<{
+    id: z.ZodNumber;
+    name: z.ZodString;
+    normalizedName: z.ZodString;
+    aliases: z.ZodArray<z.ZodString, "many">;
+    type: z.ZodEnum<["person", "company", "project", "place", "topic"]>;
+    firstSeen: z.ZodString;
+    lastSeen: z.ZodString;
+    mentionCount: z.ZodNumber;
+    priority: z.ZodNumber;
+    decayScore: z.ZodNumber;
+    tier: z.ZodEnum<["hot", "warm", "archive"]>;
+    lastAccessed: z.ZodOptional<z.ZodString>;
+    accessCount: z.ZodNumber;
+    isPinned: z.ZodBoolean;
+    lastReasonedAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "person" | "company" | "project" | "place" | "topic";
+    id: number;
+    name: string;
+    normalizedName: string;
+    aliases: string[];
+    firstSeen: string;
+    lastSeen: string;
+    mentionCount: number;
+    priority: number;
+    decayScore: number;
+    tier: "hot" | "warm" | "archive";
+    accessCount: number;
+    isPinned: boolean;
+    lastAccessed?: string | undefined;
+    lastReasonedAt?: string | undefined;
+}, {
+    type: "person" | "company" | "project" | "place" | "topic";
+    id: number;
+    name: string;
+    normalizedName: string;
+    aliases: string[];
+    firstSeen: string;
+    lastSeen: string;
+    mentionCount: number;
+    priority: number;
+    decayScore: number;
+    tier: "hot" | "warm" | "archive";
+    accessCount: number;
+    isPinned: boolean;
+    lastAccessed?: string | undefined;
+    lastReasonedAt?: string | undefined;
+}>;
+export type Entity = z.infer<typeof EntitySchema>;
+export declare const EntityMentionSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    entityId: z.ZodNumber;
+    conversationId: z.ZodString;
+    sourcePath: z.ZodString;
+    context: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodString;
+    sourceType: z.ZodString;
+    confidence: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    entityId: number;
+    conversationId: string;
+    sourcePath: string;
+    timestamp: string;
+    sourceType: string;
+    confidence: number;
+    context?: string | undefined;
+}, {
+    id: number;
+    entityId: number;
+    conversationId: string;
+    sourcePath: string;
+    timestamp: string;
+    sourceType: string;
+    confidence: number;
+    context?: string | undefined;
+}>;
+export type EntityMention = z.infer<typeof EntityMentionSchema>;
+export declare const EntityRelationSchema: z.ZodObject<{
+    sourceId: z.ZodNumber;
+    targetId: z.ZodNumber;
+    relationship: z.ZodEnum<["co-occurred", "founded", "works_at", "invested_in", "met_with", "created", "manages", "partners_with", "located_in", "discussed", "related_to", "reports_to", "uses", "depends_on", "part_of"]>;
+    strength: z.ZodNumber;
+    confidence: z.ZodNumber;
+    method: z.ZodString;
+    rationale: z.ZodOptional<z.ZodString>;
+    lastVerified: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    relationship: "co-occurred" | "founded" | "works_at" | "invested_in" | "met_with" | "created" | "manages" | "partners_with" | "located_in" | "discussed" | "related_to" | "reports_to" | "uses" | "depends_on" | "part_of";
+    confidence: number;
+    sourceId: number;
+    targetId: number;
+    strength: number;
+    method: string;
+    rationale?: string | undefined;
+    lastVerified?: string | undefined;
+}, {
+    relationship: "co-occurred" | "founded" | "works_at" | "invested_in" | "met_with" | "created" | "manages" | "partners_with" | "located_in" | "discussed" | "related_to" | "reports_to" | "uses" | "depends_on" | "part_of";
+    confidence: number;
+    sourceId: number;
+    targetId: number;
+    strength: number;
+    method: string;
+    rationale?: string | undefined;
+    lastVerified?: string | undefined;
+}>;
+export type EntityRelation = z.infer<typeof EntityRelationSchema>;
+export declare const EntityMergeSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    keepId: z.ZodNumber;
+    removeId: z.ZodNumber;
+    keepName: z.ZodOptional<z.ZodString>;
+    removeName: z.ZodOptional<z.ZodString>;
+    keepType: z.ZodOptional<z.ZodString>;
+    removeType: z.ZodOptional<z.ZodString>;
+    reason: z.ZodString;
+    confidence: z.ZodOptional<z.ZodNumber>;
+    aiRationale: z.ZodOptional<z.ZodString>;
+    mentionsMoved: z.ZodNumber;
+    relationsMoved: z.ZodNumber;
+    mergedAt: z.ZodString;
+    mergedBy: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    keepId: number;
+    removeId: number;
+    reason: string;
+    mentionsMoved: number;
+    relationsMoved: number;
+    mergedAt: string;
+    mergedBy: string;
+    confidence?: number | undefined;
+    keepName?: string | undefined;
+    removeName?: string | undefined;
+    keepType?: string | undefined;
+    removeType?: string | undefined;
+    aiRationale?: string | undefined;
+}, {
+    id: number;
+    keepId: number;
+    removeId: number;
+    reason: string;
+    mentionsMoved: number;
+    relationsMoved: number;
+    mergedAt: string;
+    mergedBy: string;
+    confidence?: number | undefined;
+    keepName?: string | undefined;
+    removeName?: string | undefined;
+    keepType?: string | undefined;
+    removeType?: string | undefined;
+    aiRationale?: string | undefined;
+}>;
+export type EntityMerge = z.infer<typeof EntityMergeSchema>;
+export declare const EntityProfileSchema: z.ZodObject<{
+    entityId: z.ZodNumber;
+    profile: z.ZodString;
+    generatedAt: z.ZodString;
+    factCount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    entityId: number;
+    profile: string;
+    generatedAt: string;
+    factCount: number;
+}, {
+    entityId: number;
+    profile: string;
+    generatedAt: string;
+    factCount: number;
+}>;
+export type EntityProfile = z.infer<typeof EntityProfileSchema>;
+export declare const ContradictionStatusSchema: z.ZodEnum<["open", "resolved"]>;
+export type ContradictionStatus = z.infer<typeof ContradictionStatusSchema>;
+export declare const ContradictionSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    entityId: z.ZodOptional<z.ZodNumber>;
+    factAId: z.ZodOptional<z.ZodNumber>;
+    factBId: z.ZodOptional<z.ZodNumber>;
+    factA: z.ZodOptional<z.ZodString>;
+    factB: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["open", "resolved"]>;
+    resolvedBy: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "open" | "resolved";
+    id: number;
+    createdAt: string;
+    entityId?: number | undefined;
+    factAId?: number | undefined;
+    factBId?: number | undefined;
+    factA?: string | undefined;
+    factB?: string | undefined;
+    description?: string | undefined;
+    resolvedBy?: string | undefined;
+}, {
+    status: "open" | "resolved";
+    id: number;
+    createdAt: string;
+    entityId?: number | undefined;
+    factAId?: number | undefined;
+    factBId?: number | undefined;
+    factA?: string | undefined;
+    factB?: string | undefined;
+    description?: string | undefined;
+    resolvedBy?: string | undefined;
+}>;
+export type Contradiction = z.infer<typeof ContradictionSchema>;
+export declare const EntityInsightSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    entityId: z.ZodNumber;
+    insightType: z.ZodEnum<["inference", "pattern", "quality", "synthesis"]>;
+    insight: z.ZodString;
+    reasoning: z.ZodString;
+    confidence: z.ZodNumber;
+    sourceEntityIds: z.ZodArray<z.ZodNumber, "many">;
+    createdAt: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodString>;
+    isStale: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    entityId: number;
+    confidence: number;
+    createdAt: string;
+    insightType: "inference" | "pattern" | "quality" | "synthesis";
+    insight: string;
+    reasoning: string;
+    sourceEntityIds: number[];
+    isStale: boolean;
+    expiresAt?: string | undefined;
+}, {
+    id: number;
+    entityId: number;
+    confidence: number;
+    createdAt: string;
+    insightType: "inference" | "pattern" | "quality" | "synthesis";
+    insight: string;
+    reasoning: string;
+    sourceEntityIds: number[];
+    isStale: boolean;
+    expiresAt?: string | undefined;
+}>;
+export type EntityInsight = z.infer<typeof EntityInsightSchema>;
+//# sourceMappingURL=entity.d.ts.map

package/dist/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../src/entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBvB,CAAC;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAGlD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAGhE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAGlE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAG5D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAK9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAGhE,eAAO,MAAM,yBAAyB,iCAA+B,CAAC;AACtE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAGhE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/entity.js

@@ -0,0 +1,94 @@
+import { z } from 'zod';
+import { EntityTypeSchema, RelationshipTypeSchema, TierSchema, InsightTypeSchema } from './constants.js';
+// Maps to entities table in entity-graph.db.
+export const EntitySchema = z.object({
+    id: z.number().int(),
+    name: z.string(),
+    normalizedName: z.string(),
+    aliases: z.array(z.string()),
+    type: EntityTypeSchema,
+    firstSeen: z.string(),
+    lastSeen: z.string(),
+    mentionCount: z.number().int(),
+    priority: z.number(),
+    decayScore: z.number(),
+    tier: TierSchema,
+    lastAccessed: z.string().optional(),
+    accessCount: z.number().int(),
+    isPinned: z.boolean(),
+    lastReasonedAt: z.string().optional(),
+});
+// Maps to entity_mentions table.
+export const EntityMentionSchema = z.object({
+    id: z.number().int(),
+    entityId: z.number().int(),
+    conversationId: z.string(),
+    sourcePath: z.string(),
+    context: z.string().optional(),
+    timestamp: z.string(),
+    sourceType: z.string(),
+    confidence: z.number(),
+});
+// Maps to entity_relations table.
+export const EntityRelationSchema = z.object({
+    sourceId: z.number().int(),
+    targetId: z.number().int(),
+    relationship: RelationshipTypeSchema,
+    strength: z.number().int(),
+    confidence: z.number(),
+    method: z.string(),
+    rationale: z.string().optional(),
+    lastVerified: z.string().optional(),
+});
+// Maps to entity_merges table.
+export const EntityMergeSchema = z.object({
+    id: z.number().int(),
+    keepId: z.number().int(),
+    removeId: z.number().int(),
+    keepName: z.string().optional(),
+    removeName: z.string().optional(),
+    keepType: z.string().optional(),
+    removeType: z.string().optional(),
+    reason: z.string(),
+    confidence: z.number().optional(),
+    aiRationale: z.string().optional(),
+    mentionsMoved: z.number().int(),
+    relationsMoved: z.number().int(),
+    mergedAt: z.string(),
+    mergedBy: z.string(),
+});
+// Maps to entity_profiles table.
+export const EntityProfileSchema = z.object({
+    entityId: z.number().int(),
+    profile: z.string(),
+    generatedAt: z.string(),
+    factCount: z.number().int(),
+});
+// Maps to contradictions table.
+export const ContradictionStatusSchema = z.enum(['open', 'resolved']);
+export const ContradictionSchema = z.object({
+    id: z.number().int(),
+    entityId: z.number().int().optional(),
+    factAId: z.number().int().optional(),
+    factBId: z.number().int().optional(),
+    factA: z.string().optional(),
+    factB: z.string().optional(),
+    description: z.string().optional(),
+    status: ContradictionStatusSchema,
+    resolvedBy: z.string().optional(),
+    createdAt: z.string(),
+});
+// Maps to entity_insights table.
+export const EntityInsightSchema = z.object({
+    id: z.number().int(),
+    entityId: z.number().int(),
+    insightType: InsightTypeSchema,
+    insight: z.string(),
+    reasoning: z.string(),
+    confidence: z.number(),
+    sourceEntityIds: z.array(z.number().int()),
+    createdAt: z.string(),
+    expiresAt: z.string().optional(),
+    isStale: z.boolean(),
+});
+//# sourceMappingURL=entity.js.map

package/dist/entity.js.map

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