@steno-ai/engine 0.1.0

package/src/feedback/tracker.ts

@@ -0,0 +1,119 @@
+import type { StorageAdapter } from '../adapters/storage.js';
+import type { SearchResult } from '../retrieval/types.js';
+import type { FeedbackType } from '../config.js';
+import { calculateDecayScore } from '../salience/decay.js';
+
+/**
+ * Record memory accesses after a search.
+ * Also updates last_accessed and frequency on accessed facts.
+ * This is called fire-and-forget from the search orchestrator.
+ */
+export async function recordAccesses(
+  storage: StorageAdapter,
+  tenantId: string,
+  query: string,
+  results: SearchResult[],
+  config?: { halfLifeDays?: number; normalizationK?: number },
+): Promise<void> {
+  const halfLifeDays = config?.halfLifeDays ?? 30;
+  const normalizationK = config?.normalizationK ?? 50;
+  const decayUpdates: Array<{ id: string; decayScore: number; lastAccessed: Date; frequency: number }> = [];
+
+  for (let i = 0; i < results.length; i++) {
+    const result = results[i]!;
+    const id = crypto.randomUUID();
+
+    // Create access record
+    await storage.createMemoryAccess({
+      id,
+      tenantId,
+      factId: result.fact.id,
+      query,
+      retrievalMethod: result.triggeredBy ? 'trigger' : 'fusion',
+      similarityScore: result.signals.vectorScore > 0 ? result.signals.vectorScore : undefined,
+      rankPosition: i + 1,
+      triggerId: result.triggeredBy,
+    });
+
+    // Recalculate decay score with updated access time and frequency
+    const newFrequency = result.fact.frequency + 1;
+    const newDecayScore = calculateDecayScore({
+      importance: result.fact.importance,
+      frequency: newFrequency,
+      lastAccessed: new Date(),
+      halfLifeDays,
+      normalizationK,
+    });
+
+    decayUpdates.push({
+      id: result.fact.id,
+      decayScore: newDecayScore,
+      lastAccessed: new Date(),
+      frequency: newFrequency,
+    });
+  }
+
+  // Batch update decay scores (also updates last_accessed and frequency on the fact)
+  if (decayUpdates.length > 0) {
+    await storage.updateDecayScores(tenantId, decayUpdates);
+  }
+}
+
+/**
+ * Submit user feedback for a retrieved memory.
+ * Adjusts the fact's importance score based on feedback.
+ */
+export async function submitFeedback(
+  storage: StorageAdapter,
+  tenantId: string,
+  factId: string,
+  feedback: {
+    wasUseful: boolean;
+    feedbackType: FeedbackType;
+    feedbackDetail?: string;
+  },
+  config?: { halfLifeDays?: number; normalizationK?: number },
+): Promise<void> {
+  // 1. Update the memory access record with feedback
+  await storage.updateFeedback(tenantId, factId, {
+    wasUseful: feedback.wasUseful,
+    feedbackType: feedback.feedbackType,
+    feedbackDetail: feedback.feedbackDetail,
+    wasCorrected: feedback.feedbackType === 'correction',
+  });
+
+  // 2. Adjust fact importance based on feedback
+  const fact = await storage.getFact(tenantId, factId);
+  if (!fact) return;
+
+  let newImportance = fact.importance;
+
+  switch (feedback.feedbackType) {
+    case 'explicit_positive':
+    case 'implicit_positive':
+      newImportance = Math.min(1.0, fact.importance + 0.05);
+      break;
+    case 'explicit_negative':
+    case 'implicit_negative':
+      newImportance = Math.max(0.1, fact.importance - 0.05);
+      break;
+    case 'correction':
+      newImportance = Math.max(0.1, fact.importance - 0.1);
+      break;
+  }
+
+  // 3. Update the fact's importance and recalculate decay score
+  if (newImportance !== fact.importance) {
+    const newDecayScore = calculateDecayScore({
+      importance: newImportance,
+      frequency: fact.frequency,
+      lastAccessed: fact.lastAccessed ?? new Date(),
+      halfLifeDays: config?.halfLifeDays ?? 30,
+      normalizationK: config?.normalizationK ?? 50,
+    });
+
+    await storage.updateDecayScores(tenantId, [
+      { id: factId, decayScore: newDecayScore, importance: newImportance },
+    ]);
+  }
+}

package/src/index.ts

@@ -0,0 +1,12 @@
+// Steno Engine - Core memory engine
+export * from './config.js';
+export * from './models/index.js';
+export * from './adapters/index.js';
+export * from './salience/index.js';
+export * from './auth/index.js';
+export * from './extraction/index.js';
+export * from './retrieval/index.js';
+export * from './sessions/index.js';
+export * from './feedback/index.js';
+export * from './profiles/index.js';
+export * from './scratchpad/index.js';

package/src/models/api-key.d.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+export declare const ApiKeySchema: z.ZodObject<{
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    keyHash: z.ZodString;
+    keyPrefix: z.ZodString;
+    name: z.ZodString;
+    scopes: z.ZodArray<z.ZodEnum<["read", "write", "admin"]>, "many">;
+    expiresAt: z.ZodNullable<z.ZodDate>;
+    lastUsedAt: z.ZodNullable<z.ZodDate>;
+    active: z.ZodBoolean;
+    createdAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    active: boolean;
+    tenantId: string;
+    createdAt: Date;
+    keyHash: string;
+    keyPrefix: string;
+    scopes: ("read" | "write" | "admin")[];
+    expiresAt: Date | null;
+    lastUsedAt: Date | null;
+}, {
+    name: string;
+    id: string;
+    active: boolean;
+    tenantId: string;
+    createdAt: Date;
+    keyHash: string;
+    keyPrefix: string;
+    scopes: ("read" | "write" | "admin")[];
+    expiresAt: Date | null;
+    lastUsedAt: Date | null;
+}>;
+export type ApiKey = z.infer<typeof ApiKeySchema>;
+export declare const CreateApiKeySchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    name: z.ZodDefault<z.ZodString>;
+    scopes: z.ZodDefault<z.ZodArray<z.ZodEnum<["read", "write", "admin"]>, "many">>;
+    expiresAt: z.ZodOptional<z.ZodDate>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    tenantId: string;
+    scopes: ("read" | "write" | "admin")[];
+    expiresAt?: Date | undefined;
+}, {
+    tenantId: string;
+    name?: string | undefined;
+    scopes?: ("read" | "write" | "admin")[] | undefined;
+    expiresAt?: Date | undefined;
+}>;
+export type CreateApiKey = z.infer<typeof CreateApiKeySchema>;
+//# sourceMappingURL=api-key.d.ts.map

package/src/models/api-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.d.ts","sourceRoot":"","sources":["api-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/src/models/api-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key.js","sourceRoot":"","sources":["api-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACtC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;CAC3B,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC"}

package/src/models/api-key.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import { API_KEY_SCOPES } from '../config.js';
+
+export const ApiKeySchema = z.object({
+  id: z.string().uuid(),
+  tenantId: z.string().uuid(),
+  keyHash: z.string(),
+  keyPrefix: z.string(),
+  name: z.string().max(100),
+  scopes: z.array(z.enum(API_KEY_SCOPES)),
+  expiresAt: z.coerce.date().nullable(),
+  lastUsedAt: z.coerce.date().nullable(),
+  active: z.boolean(),
+  createdAt: z.coerce.date(),
+});
+
+export type ApiKey = z.infer<typeof ApiKeySchema>;
+
+export const CreateApiKeySchema = z.object({
+  tenantId: z.string().uuid(),
+  name: z.string().max(100).default('Default'),
+  scopes: z.array(z.enum(API_KEY_SCOPES)).default(['read', 'write']),
+  expiresAt: z.coerce.date().optional(),
+});
+
+export type CreateApiKey = z.infer<typeof CreateApiKeySchema>;

package/src/models/edge.d.ts

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+export declare const EdgeSchema: z.ZodObject<{
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    sourceId: z.ZodString;
+    targetId: z.ZodString;
+    relation: z.ZodString;
+    edgeType: z.ZodEnum<["associative", "causal", "temporal", "contradictory", "hierarchical"]>;
+    weight: z.ZodDefault<z.ZodNumber>;
+    validFrom: z.ZodDate;
+    validUntil: z.ZodNullable<z.ZodDate>;
+    factId: z.ZodNullable<z.ZodString>;
+    confidence: z.ZodNumber;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    createdAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    tenantId: string;
+    validFrom: Date;
+    validUntil: Date | null;
+    confidence: number;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    sourceId: string;
+    targetId: string;
+    relation: string;
+    edgeType: "associative" | "causal" | "temporal" | "contradictory" | "hierarchical";
+    weight: number;
+    factId: string | null;
+}, {
+    id: string;
+    tenantId: string;
+    validFrom: Date;
+    validUntil: Date | null;
+    confidence: number;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    sourceId: string;
+    targetId: string;
+    relation: string;
+    edgeType: "associative" | "causal" | "temporal" | "contradictory" | "hierarchical";
+    factId: string | null;
+    weight?: number | undefined;
+}>;
+export type Edge = z.infer<typeof EdgeSchema>;
+export declare const CreateEdgeSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    sourceId: z.ZodString;
+    targetId: z.ZodString;
+    relation: z.ZodString;
+    edgeType: z.ZodEnum<["associative", "causal", "temporal", "contradictory", "hierarchical"]>;
+    weight: z.ZodDefault<z.ZodNumber>;
+    factId: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodDefault<z.ZodNumber>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    tenantId: string;
+    confidence: number;
+    metadata: Record<string, unknown>;
+    sourceId: string;
+    targetId: string;
+    relation: string;
+    edgeType: "associative" | "causal" | "temporal" | "contradictory" | "hierarchical";
+    weight: number;
+    factId?: string | undefined;
+}, {
+    tenantId: string;
+    sourceId: string;
+    targetId: string;
+    relation: string;
+    edgeType: "associative" | "causal" | "temporal" | "contradictory" | "hierarchical";
+    confidence?: number | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    weight?: number | undefined;
+    factId?: string | undefined;
+}>;
+export type CreateEdge = z.infer<typeof CreateEdgeSchema>;
+//# sourceMappingURL=edge.d.ts.map

package/src/models/edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.d.ts","sourceRoot":"","sources":["edge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcrB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/src/models/edge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.js","sourceRoot":"","sources":["edge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;IAC1B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,SAAS;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;CAC3B,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACxD,CAAC,CAAC"}

package/src/models/edge.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { unitFloat, EDGE_TYPES } from '../config.js';
+
+export const EdgeSchema = z.object({
+  id: z.string().uuid(),
+  tenantId: z.string().uuid(),
+  sourceId: z.string().uuid(),
+  targetId: z.string().uuid(),
+  relation: z.string(),
+  edgeType: z.enum(EDGE_TYPES),
+  weight: z.number().min(0).default(1.0),
+  validFrom: z.coerce.date(),
+  validUntil: z.coerce.date().nullable(),
+  factId: z.string().uuid().nullable(),
+  confidence: unitFloat,
+  metadata: z.record(z.string(), z.unknown()),
+  createdAt: z.coerce.date(),
+});
+
+export type Edge = z.infer<typeof EdgeSchema>;
+
+export const CreateEdgeSchema = z.object({
+  tenantId: z.string().uuid(),
+  sourceId: z.string().uuid(),
+  targetId: z.string().uuid(),
+  relation: z.string(),
+  edgeType: z.enum(EDGE_TYPES),
+  weight: z.number().min(0).default(1.0),
+  factId: z.string().uuid().optional(),
+  confidence: unitFloat.default(0.8),
+  metadata: z.record(z.string(), z.unknown()).default({}),
+});
+
+export type CreateEdge = z.infer<typeof CreateEdgeSchema>;

package/src/models/entity.d.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+export declare const EntitySchema: z.ZodObject<{
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    name: z.ZodString;
+    entityType: z.ZodString;
+    canonicalName: z.ZodString;
+    properties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    embeddingModel: z.ZodNullable<z.ZodString>;
+    embeddingDim: z.ZodNullable<z.ZodNumber>;
+    mergeTargetId: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    embeddingModel: string | null;
+    embeddingDim: number | null;
+    tenantId: string;
+    createdAt: Date;
+    entityType: string;
+    canonicalName: string;
+    properties: Record<string, unknown>;
+    mergeTargetId: string | null;
+    updatedAt: Date;
+}, {
+    name: string;
+    id: string;
+    embeddingModel: string | null;
+    embeddingDim: number | null;
+    tenantId: string;
+    createdAt: Date;
+    entityType: string;
+    canonicalName: string;
+    properties: Record<string, unknown>;
+    mergeTargetId: string | null;
+    updatedAt: Date;
+}>;
+export type Entity = z.infer<typeof EntitySchema>;
+export declare const CreateEntitySchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    name: z.ZodString;
+    entityType: z.ZodString;
+    canonicalName: z.ZodString;
+    properties: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    tenantId: string;
+    entityType: string;
+    canonicalName: string;
+    properties: Record<string, unknown>;
+}, {
+    name: string;
+    tenantId: string;
+    entityType: string;
+    canonicalName: string;
+    properties?: Record<string, unknown> | undefined;
+}>;
+export type CreateEntity = z.infer<typeof CreateEntitySchema>;
+//# sourceMappingURL=entity.d.ts.map

package/src/models/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/src/models/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACpD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;CAC3B,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC1D,CAAC,CAAC"}

package/src/models/entity.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+
+export const EntitySchema = z.object({
+  id: z.string().uuid(),
+  tenantId: z.string().uuid(),
+  name: z.string().min(1).max(500),
+  entityType: z.string().min(1),
+  canonicalName: z.string().min(1),
+  properties: z.record(z.string(), z.unknown()),
+  embeddingModel: z.string().nullable(),
+  embeddingDim: z.number().int().positive().nullable(),
+  mergeTargetId: z.string().uuid().nullable(),
+  createdAt: z.coerce.date(),
+  updatedAt: z.coerce.date(),
+});
+
+export type Entity = z.infer<typeof EntitySchema>;
+
+export const CreateEntitySchema = z.object({
+  tenantId: z.string().uuid(),
+  name: z.string().min(1).max(500),
+  entityType: z.string().min(1),
+  canonicalName: z.string().min(1),
+  properties: z.record(z.string(), z.unknown()).default({}),
+});
+
+export type CreateEntity = z.infer<typeof CreateEntitySchema>;

package/src/models/extraction.d.ts

@@ -0,0 +1,111 @@
+import { z } from 'zod';
+export declare const ExtractionSchema: z.ZodObject<{
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    status: z.ZodEnum<["queued", "processing", "completed", "failed", "deduped"]>;
+    inputType: z.ZodEnum<["conversation", "document", "url", "raw_text", "image", "audio", "code"]>;
+    inputData: z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
+    inputHash: z.ZodString;
+    inputSize: z.ZodNullable<z.ZodNumber>;
+    scope: z.ZodEnum<["user", "agent", "session", "hive"]>;
+    scopeId: z.ZodString;
+    sessionId: z.ZodNullable<z.ZodString>;
+    tierUsed: z.ZodNullable<z.ZodEnum<["heuristic", "cheap_llm", "smart_llm", "multi_tier"]>>;
+    llmModel: z.ZodNullable<z.ZodString>;
+    factsCreated: z.ZodNumber;
+    factsUpdated: z.ZodNumber;
+    factsInvalidated: z.ZodNumber;
+    entitiesCreated: z.ZodNumber;
+    edgesCreated: z.ZodNumber;
+    costTokensInput: z.ZodNumber;
+    costTokensOutput: z.ZodNumber;
+    costUsd: z.ZodNumber;
+    durationMs: z.ZodNullable<z.ZodNumber>;
+    error: z.ZodNullable<z.ZodString>;
+    retryCount: z.ZodNumber;
+    createdAt: z.ZodDate;
+    completedAt: z.ZodNullable<z.ZodDate>;
+}, "strip", z.ZodTypeAny, {
+    status: "queued" | "processing" | "completed" | "failed" | "deduped";
+    id: string;
+    error: string | null;
+    tenantId: string;
+    scope: "user" | "agent" | "session" | "hive";
+    scopeId: string;
+    sessionId: string | null;
+    createdAt: Date;
+    inputType: "url" | "image" | "audio" | "code" | "conversation" | "document" | "raw_text";
+    inputData: string | Record<string, unknown> | null;
+    inputHash: string;
+    inputSize: number | null;
+    tierUsed: "heuristic" | "cheap_llm" | "smart_llm" | "multi_tier" | null;
+    llmModel: string | null;
+    factsCreated: number;
+    factsUpdated: number;
+    factsInvalidated: number;
+    entitiesCreated: number;
+    edgesCreated: number;
+    costTokensInput: number;
+    costTokensOutput: number;
+    costUsd: number;
+    durationMs: number | null;
+    retryCount: number;
+    completedAt: Date | null;
+}, {
+    status: "queued" | "processing" | "completed" | "failed" | "deduped";
+    id: string;
+    error: string | null;
+    tenantId: string;
+    scope: "user" | "agent" | "session" | "hive";
+    scopeId: string;
+    sessionId: string | null;
+    createdAt: Date;
+    inputType: "url" | "image" | "audio" | "code" | "conversation" | "document" | "raw_text";
+    inputData: string | Record<string, unknown> | null;
+    inputHash: string;
+    inputSize: number | null;
+    tierUsed: "heuristic" | "cheap_llm" | "smart_llm" | "multi_tier" | null;
+    llmModel: string | null;
+    factsCreated: number;
+    factsUpdated: number;
+    factsInvalidated: number;
+    entitiesCreated: number;
+    edgesCreated: number;
+    costTokensInput: number;
+    costTokensOutput: number;
+    costUsd: number;
+    durationMs: number | null;
+    retryCount: number;
+    completedAt: Date | null;
+}>;
+export type Extraction = z.infer<typeof ExtractionSchema>;
+export declare const CreateExtractionSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    inputType: z.ZodEnum<["conversation", "document", "url", "raw_text", "image", "audio", "code"]>;
+    inputData: z.ZodString;
+    inputHash: z.ZodString;
+    inputSize: z.ZodOptional<z.ZodNumber>;
+    scope: z.ZodEnum<["user", "agent", "session", "hive"]>;
+    scopeId: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    tenantId: string;
+    scope: "user" | "agent" | "session" | "hive";
+    scopeId: string;
+    inputType: "url" | "image" | "audio" | "code" | "conversation" | "document" | "raw_text";
+    inputData: string;
+    inputHash: string;
+    sessionId?: string | undefined;
+    inputSize?: number | undefined;
+}, {
+    tenantId: string;
+    scope: "user" | "agent" | "session" | "hive";
+    scopeId: string;
+    inputType: "url" | "image" | "audio" | "code" | "conversation" | "document" | "raw_text";
+    inputData: string;
+    inputHash: string;
+    sessionId?: string | undefined;
+    inputSize?: number | undefined;
+}>;
+export type CreateExtraction = z.infer<typeof CreateExtractionSchema>;
+//# sourceMappingURL=extraction.d.ts.map

package/src/models/extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extraction.d.ts","sourceRoot":"","sources":["extraction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0B3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/src/models/extraction.js.map

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

package/src/models/extraction.ts

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { EXTRACTION_STATUSES, INPUT_TYPES, SCOPES, EXTRACTION_TIERS_USED } from '../config.js';
+
+export const ExtractionSchema = z.object({
+  id: z.string().uuid(),
+  tenantId: z.string().uuid(),
+  status: z.enum(EXTRACTION_STATUSES),
+  inputType: z.enum(INPUT_TYPES),
+  inputData: z.union([z.string(), z.record(z.unknown())]).nullable(),
+  inputHash: z.string(),
+  inputSize: z.number().int().nonnegative().nullable(),
+  scope: z.enum(SCOPES),
+  scopeId: z.string().min(1),
+  sessionId: z.string().uuid().nullable(),
+  tierUsed: z.enum(EXTRACTION_TIERS_USED).nullable(),
+  llmModel: z.string().nullable(),
+  factsCreated: z.number().int().nonnegative(),
+  factsUpdated: z.number().int().nonnegative(),
+  factsInvalidated: z.number().int().nonnegative(),
+  entitiesCreated: z.number().int().nonnegative(),
+  edgesCreated: z.number().int().nonnegative(),
+  costTokensInput: z.number().int().nonnegative(),
+  costTokensOutput: z.number().int().nonnegative(),
+  costUsd: z.number().nonnegative(),
+  durationMs: z.number().int().nonnegative().nullable(),
+  error: z.string().nullable(),
+  retryCount: z.number().int().nonnegative(),
+  createdAt: z.coerce.date(),
+  completedAt: z.coerce.date().nullable(),
+});
+
+export type Extraction = z.infer<typeof ExtractionSchema>;
+
+export const CreateExtractionSchema = z.object({
+  tenantId: z.string().uuid(),
+  inputType: z.enum(INPUT_TYPES),
+  inputData: z.string(),
+  inputHash: z.string(),
+  inputSize: z.number().int().nonnegative().optional(),
+  scope: z.enum(SCOPES),
+  scopeId: z.string().min(1),
+  sessionId: z.string().uuid().optional(),
+});
+
+export type CreateExtraction = z.infer<typeof CreateExtractionSchema>;

package/src/models/fact-entity.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+export declare const FactEntitySchema: z.ZodObject<{
+    factId: z.ZodString;
+    entityId: z.ZodString;
+    role: z.ZodEnum<["subject", "object", "mentioned"]>;
+    createdAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    createdAt: Date;
+    factId: string;
+    entityId: string;
+    role: "object" | "subject" | "mentioned";
+}, {
+    createdAt: Date;
+    factId: string;
+    entityId: string;
+    role: "object" | "subject" | "mentioned";
+}>;
+export type FactEntity = z.infer<typeof FactEntitySchema>;
+export declare const CreateFactEntitySchema: z.ZodObject<{
+    factId: z.ZodString;
+    entityId: z.ZodString;
+    role: z.ZodDefault<z.ZodEnum<["subject", "object", "mentioned"]>>;
+}, "strip", z.ZodTypeAny, {
+    factId: string;
+    entityId: string;
+    role: "object" | "subject" | "mentioned";
+}, {
+    factId: string;
+    entityId: string;
+    role?: "object" | "subject" | "mentioned" | undefined;
+}>;
+export type CreateFactEntity = z.infer<typeof CreateFactEntitySchema>;
+//# sourceMappingURL=fact-entity.d.ts.map

package/src/models/fact-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-entity.d.ts","sourceRoot":"","sources":["fact-entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/src/models/fact-entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-entity.js","sourceRoot":"","sources":["fact-entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;CAC3B,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACzB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;CAChD,CAAC,CAAC"}