@steno-ai/engine 0.1.0

package/src/models/trigger.d.ts

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+export type TriggerCondition = {
+    topic_match?: string[];
+    entity_present?: string[];
+    keyword_any?: string[];
+    semantic_similarity?: {
+        text: string;
+        threshold: number;
+    };
+    AND?: TriggerCondition[];
+    OR?: TriggerCondition[];
+};
+export declare const TriggerConditionSchema: z.ZodType<TriggerCondition>;
+export declare const TriggerSchema: z.ZodObject<{
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    scope: z.ZodEnum<["user", "agent", "session", "hive"]>;
+    scopeId: z.ZodString;
+    condition: z.ZodType<TriggerCondition, z.ZodTypeDef, TriggerCondition>;
+    factIds: z.ZodArray<z.ZodString, "many">;
+    entityIds: z.ZodArray<z.ZodString, "many">;
+    queryTemplate: z.ZodNullable<z.ZodString>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    active: z.ZodDefault<z.ZodBoolean>;
+    timesFired: z.ZodDefault<z.ZodNumber>;
+    lastFiredAt: z.ZodNullable<z.ZodDate>;
+    createdAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    priority: number;
+    id: string;
+    active: boolean;
+    tenantId: string;
+    scope: "user" | "agent" | "session" | "hive";
+    scopeId: string;
+    createdAt: Date;
+    condition: TriggerCondition;
+    factIds: string[];
+    entityIds: string[];
+    queryTemplate: string | null;
+    timesFired: number;
+    lastFiredAt: Date | null;
+}, {
+    id: string;
+    tenantId: string;
+    scope: "user" | "agent" | "session" | "hive";
+    scopeId: string;
+    createdAt: Date;
+    condition: TriggerCondition;
+    factIds: string[];
+    entityIds: string[];
+    queryTemplate: string | null;
+    lastFiredAt: Date | null;
+    priority?: number | undefined;
+    active?: boolean | undefined;
+    timesFired?: number | undefined;
+}>;
+export type Trigger = z.infer<typeof TriggerSchema>;
+export declare const CreateTriggerSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    scope: z.ZodEnum<["user", "agent", "session", "hive"]>;
+    scopeId: z.ZodString;
+    condition: z.ZodType<TriggerCondition, z.ZodTypeDef, TriggerCondition>;
+    factIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    entityIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    queryTemplate: z.ZodOptional<z.ZodString>;
+    priority: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    priority: number;
+    tenantId: string;
+    scope: "user" | "agent" | "session" | "hive";
+    scopeId: string;
+    condition: TriggerCondition;
+    factIds: string[];
+    entityIds: string[];
+    queryTemplate?: string | undefined;
+}, {
+    tenantId: string;
+    scope: "user" | "agent" | "session" | "hive";
+    scopeId: string;
+    condition: TriggerCondition;
+    priority?: number | undefined;
+    factIds?: string[] | undefined;
+    entityIds?: string[] | undefined;
+    queryTemplate?: string | undefined;
+}>;
+export type CreateTrigger = z.infer<typeof CreateTriggerSchema>;
+//# sourceMappingURL=trigger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["trigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,mBAAmB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,GAAG,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACzB,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAc9D,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcxB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/src/models/trigger.js.map

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

package/src/models/trigger.ts

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+import { SCOPES } from '../config.js';
+
+export type TriggerCondition = {
+  topic_match?: string[];
+  entity_present?: string[];
+  keyword_any?: string[];
+  semantic_similarity?: { text: string; threshold: number };
+  AND?: TriggerCondition[];
+  OR?: TriggerCondition[];
+};
+
+export const TriggerConditionSchema: z.ZodType<TriggerCondition> = z.lazy(() =>
+  z.object({
+    topic_match: z.array(z.string()).optional(),
+    entity_present: z.array(z.string()).optional(),
+    keyword_any: z.array(z.string()).optional(),
+    semantic_similarity: z
+      .object({
+        text: z.string(),
+        threshold: z.number().min(0).max(1),
+      })
+      .optional(),
+    AND: z.array(TriggerConditionSchema).optional(),
+    OR: z.array(TriggerConditionSchema).optional(),
+  }),
+);
+
+export const TriggerSchema = z.object({
+  id: z.string().uuid(),
+  tenantId: z.string().uuid(),
+  scope: z.enum(SCOPES),
+  scopeId: z.string().min(1),
+  condition: TriggerConditionSchema,
+  factIds: z.array(z.string().uuid()),
+  entityIds: z.array(z.string().uuid()),
+  queryTemplate: z.string().nullable(),
+  priority: z.number().int().default(0),
+  active: z.boolean().default(true),
+  timesFired: z.number().int().nonnegative().default(0),
+  lastFiredAt: z.coerce.date().nullable(),
+  createdAt: z.coerce.date(),
+});
+
+export type Trigger = z.infer<typeof TriggerSchema>;
+
+export const CreateTriggerSchema = z.object({
+  tenantId: z.string().uuid(),
+  scope: z.enum(SCOPES),
+  scopeId: z.string().min(1),
+  condition: TriggerConditionSchema,
+  factIds: z.array(z.string().uuid()).default([]),
+  entityIds: z.array(z.string().uuid()).default([]),
+  queryTemplate: z.string().optional(),
+  priority: z.number().int().default(0),
+});
+
+export type CreateTrigger = z.infer<typeof CreateTriggerSchema>;

package/src/models/usage-record.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+export declare const UsageRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    periodStart: z.ZodDate;
+    periodEnd: z.ZodDate;
+    tokensUsed: z.ZodNumber;
+    queriesUsed: z.ZodNumber;
+    extractionsCount: z.ZodNumber;
+    costUsd: z.ZodNumber;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    tenantId: string;
+    createdAt: Date;
+    updatedAt: Date;
+    costUsd: number;
+    periodStart: Date;
+    periodEnd: Date;
+    tokensUsed: number;
+    queriesUsed: number;
+    extractionsCount: number;
+}, {
+    id: string;
+    tenantId: string;
+    createdAt: Date;
+    updatedAt: Date;
+    costUsd: number;
+    periodStart: Date;
+    periodEnd: Date;
+    tokensUsed: number;
+    queriesUsed: number;
+    extractionsCount: number;
+}>;
+export type UsageRecord = z.infer<typeof UsageRecordSchema>;
+//# sourceMappingURL=usage-record.d.ts.map

package/src/models/usage-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-record.d.ts","sourceRoot":"","sources":["usage-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/src/models/usage-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-record.js","sourceRoot":"","sources":["usage-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;IAC1B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAChD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;CAC3B,CAAC,CAAC"}

package/src/models/usage-record.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+
+export const UsageRecordSchema = z.object({
+  id: z.string().uuid(),
+  tenantId: z.string().uuid(),
+  periodStart: z.coerce.date(),
+  periodEnd: z.coerce.date(),
+  tokensUsed: z.number().int().nonnegative(),
+  queriesUsed: z.number().int().nonnegative(),
+  extractionsCount: z.number().int().nonnegative(),
+  costUsd: z.number().nonnegative(),
+  createdAt: z.coerce.date(),
+  updatedAt: z.coerce.date(),
+});
+
+export type UsageRecord = z.infer<typeof UsageRecordSchema>;

package/src/models/webhook.d.ts

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+export declare const WEBHOOK_EVENTS: readonly ["extraction.completed", "extraction.failed", "trigger.fired", "usage.limit_approaching", "usage.limit_exceeded"];
+export type WebhookEvent = (typeof WEBHOOK_EVENTS)[number];
+export declare const WebhookSchema: z.ZodObject<{
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    url: z.ZodString;
+    events: z.ZodArray<z.ZodEnum<["extraction.completed", "extraction.failed", "trigger.fired", "usage.limit_approaching", "usage.limit_exceeded"]>, "many">;
+    secretHash: z.ZodString;
+    signingKey: z.ZodString;
+    active: z.ZodDefault<z.ZodBoolean>;
+    createdAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    id: string;
+    active: boolean;
+    tenantId: string;
+    createdAt: Date;
+    events: ("extraction.completed" | "extraction.failed" | "trigger.fired" | "usage.limit_approaching" | "usage.limit_exceeded")[];
+    secretHash: string;
+    signingKey: string;
+}, {
+    url: string;
+    id: string;
+    tenantId: string;
+    createdAt: Date;
+    events: ("extraction.completed" | "extraction.failed" | "trigger.fired" | "usage.limit_approaching" | "usage.limit_exceeded")[];
+    secretHash: string;
+    signingKey: string;
+    active?: boolean | undefined;
+}>;
+export type Webhook = z.infer<typeof WebhookSchema>;
+export declare const CreateWebhookSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    url: z.ZodString;
+    events: z.ZodArray<z.ZodEnum<["extraction.completed", "extraction.failed", "trigger.fired", "usage.limit_approaching", "usage.limit_exceeded"]>, "many">;
+    secret: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    tenantId: string;
+    events: ("extraction.completed" | "extraction.failed" | "trigger.fired" | "usage.limit_approaching" | "usage.limit_exceeded")[];
+    secret: string;
+}, {
+    url: string;
+    tenantId: string;
+    events: ("extraction.completed" | "extraction.failed" | "trigger.fired" | "usage.limit_approaching" | "usage.limit_exceeded")[];
+    secret: string;
+}>;
+export type CreateWebhook = z.infer<typeof CreateWebhookSchema>;
+//# sourceMappingURL=webhook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,cAAc,4HAMjB,CAAC;AACX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;EASxB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAK9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/src/models/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["webhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,sBAAsB;IACtB,mBAAmB;IACnB,eAAe;IACf,yBAAyB;IACzB,sBAAsB;CACd,CAAC;AAGX,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,uEAAuE;IAC/F,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;CAC3B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC;CAC3B,CAAC,CAAC"}

package/src/models/webhook.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+
+export const WEBHOOK_EVENTS = [
+  'extraction.completed',
+  'extraction.failed',
+  'trigger.fired',
+  'usage.limit_approaching',
+  'usage.limit_exceeded',
+] as const;
+export type WebhookEvent = (typeof WEBHOOK_EVENTS)[number];
+
+export const WebhookSchema = z.object({
+  id: z.string().uuid(),
+  tenantId: z.string().uuid(),
+  url: z.string().url(),
+  events: z.array(z.enum(WEBHOOK_EVENTS)),
+  secretHash: z.string(),
+  signingKey: z.string(), // raw secret for HMAC signing — stored encrypted at rest in production
+  active: z.boolean().default(true),
+  createdAt: z.coerce.date(),
+});
+export type Webhook = z.infer<typeof WebhookSchema>;
+
+export const CreateWebhookSchema = z.object({
+  tenantId: z.string().uuid(),
+  url: z.string().url(),
+  events: z.array(z.enum(WEBHOOK_EVENTS)).min(1),
+  secret: z.string().min(16),
+});
+export type CreateWebhook = z.infer<typeof CreateWebhookSchema>;

package/src/profiles/index.ts

@@ -0,0 +1,2 @@
+export { getUserProfile, categorize } from './profile.js';
+export type { UserProfile, ProfileFact } from './profile.js';

package/src/profiles/profile.ts

@@ -0,0 +1,81 @@
+import type { StorageAdapter } from '../adapters/storage.js';
+
+export interface UserProfile {
+  userId: string;
+  static: ProfileFact[];   // Long-term stable facts (name, company, allergies)
+  dynamic: ProfileFact[];  // Recent/changing context (current project, mood)
+  lastUpdated: Date | null;
+}
+
+export interface ProfileFact {
+  id: string;
+  content: string;
+  importance: number;
+  category: string;  // 'identity', 'preference', 'health', 'work', 'location', 'other'
+  validFrom: Date;
+}
+
+/**
+ * Build a user profile from stored facts.
+ * Static = high importance (>0.7) + old (>7 days)
+ * Dynamic = recent (<7 days) OR low importance
+ */
+export async function getUserProfile(
+  storage: StorageAdapter,
+  tenantId: string,
+  userId: string,
+): Promise<UserProfile> {
+  const facts = await storage.getFactsByScope(tenantId, 'user', userId, { limit: 100 });
+  const validFacts = facts.data.filter(f => f.validUntil === null);
+
+  const now = Date.now();
+  const sevenDays = 7 * 24 * 60 * 60 * 1000;
+
+  const staticFacts: ProfileFact[] = [];
+  const dynamicFacts: ProfileFact[] = [];
+
+  for (const fact of validFacts) {
+    // Skip raw chunks — only use extracted facts for profiles
+    if (fact.tags?.includes('raw_chunk')) continue;
+
+    const age = now - new Date(fact.validFrom).getTime();
+    const category = categorize(fact.content, fact.importance);
+
+    const profileFact: ProfileFact = {
+      id: fact.id,
+      content: fact.content,
+      importance: fact.importance,
+      category,
+      validFrom: new Date(fact.validFrom),
+    };
+
+    if (fact.importance >= 0.7 && age > sevenDays) {
+      staticFacts.push(profileFact);
+    } else {
+      dynamicFacts.push(profileFact);
+    }
+  }
+
+  // Sort: static by importance desc, dynamic by recency desc
+  staticFacts.sort((a, b) => b.importance - a.importance);
+  dynamicFacts.sort((a, b) => b.validFrom.getTime() - a.validFrom.getTime());
+
+  return {
+    userId,
+    static: staticFacts,
+    dynamic: dynamicFacts,
+    lastUpdated: validFacts.length > 0
+      ? new Date(Math.max(...validFacts.map(f => new Date(f.createdAt).getTime())))
+      : null,
+  };
+}
+
+export function categorize(content: string, _importance: number): string {
+  const lower = content.toLowerCase();
+  if (lower.includes('allergic') || lower.includes('medication') || lower.includes('health')) return 'health';
+  if (lower.includes('name is') || lower.includes('age') || lower.includes('born')) return 'identity';
+  if (lower.includes('works at') || lower.includes('job') || lower.includes('engineer') || lower.includes('company')) return 'work';
+  if (lower.includes('lives in') || lower.includes('based in') || lower.includes('location') || lower.includes('from')) return 'location';
+  if (lower.includes('prefers') || lower.includes('likes') || lower.includes('loves') || lower.includes('hates') || lower.includes('favorite')) return 'preference';
+  return 'other';
+}

package/src/retrieval/compound-search.d.ts

@@ -0,0 +1,13 @@
+import type { StorageAdapter } from '../adapters/storage.js';
+import type { EmbeddingAdapter } from '../adapters/embedding.js';
+import type { Candidate } from './types.js';
+/**
+ * Compound search: embeds the query, then calls storage.compoundSearch
+ * (ONE database call for both vector + keyword), and splits results
+ * into Candidate format.
+ */
+export declare function compoundSearchSignal(storage: StorageAdapter, embedding: EmbeddingAdapter, query: string, tenantId: string, scope: string, scopeId: string, limit: number): Promise<{
+    vectorCandidates: Candidate[];
+    keywordCandidates: Candidate[];
+}>;
+//# sourceMappingURL=compound-search.d.ts.map

package/src/retrieval/compound-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compound-search.d.ts","sourceRoot":"","sources":["compound-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,YAAY,CAAC;AA2B3D;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,gBAAgB,EAAE,SAAS,EAAE,CAAC;IAAC,iBAAiB,EAAE,SAAS,EAAE,CAAA;CAAE,CAAC,CA2D5E"}

package/src/retrieval/compound-search.js.map

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

package/src/retrieval/compound-search.ts

@@ -0,0 +1,104 @@
+import type { StorageAdapter } from '../adapters/storage.js';
+import type { EmbeddingAdapter } from '../adapters/embedding.js';
+import type { SearchOptions, Candidate } from './types.js';
+
+/**
+ * Words to strip from search queries before keyword matching.
+ * Only question/function words that appear in queries but rarely in stored facts.
+ *
+ * NOTE: We intentionally do NOT strip "user" even though it appears in most facts.
+ * PostgreSQL's ts_rank uses IDF (inverse document frequency) weighting internally,
+ * so "user" gets near-zero weight when it appears in most documents. This is the
+ * correct behavior — ts_rank("user | hono") will score a fact containing "hono"
+ * much higher than one containing only "user", even though both match the tsquery.
+ */
+const QUERY_STOP_WORDS = new Set([
+  // Question words
+  'what', 'when', 'where', 'who', 'why', 'how', 'which',
+  // Auxiliary verbs from questions
+  'is', 'are', 'was', 'were', 'did', 'does', 'do', 'will', 'can', 'could', 'would', 'should',
+  'have', 'has', 'had', 'been', 'be',
+  // Articles and prepositions
+  'the', 'a', 'an', 'in', 'on', 'at', 'to', 'for', 'of', 'with',
+  // Conjunctions
+  'and', 'or', 'but', 'not', 'if', 'still',
+  // Pronouns
+  'it', 'its', 'her', 'his', 'she', 'he', 'they', 'them', 'their', 'my', 'your', 'our',
+  'that', 'this',
+]);
+
+/**
+ * Compound search: embeds the query, then calls storage.compoundSearch
+ * (ONE database call for both vector + keyword), and splits results
+ * into Candidate format.
+ */
+export async function compoundSearchSignal(
+  storage: StorageAdapter,
+  embedding: EmbeddingAdapter,
+  query: string,
+  tenantId: string,
+  scope: string,
+  scopeId: string,
+  limit: number,
+): Promise<{ vectorCandidates: Candidate[]; keywordCandidates: Candidate[] }> {
+  const queryEmbedding = await embedding.embed(query);
+
+  // Extract content words, join with OR for to_tsquery
+  // ts_rank handles IDF weighting — high-frequency terms get low scores automatically
+  const keywordQuery = query.toLowerCase()
+    .replace(/[^a-z0-9\s]/g, ' ')
+    .split(/\s+/)
+    .filter(w => w.length >= 2 && !QUERY_STOP_WORDS.has(w))
+    .join(' | ');
+
+  const results = await storage.compoundSearch({
+    embedding: queryEmbedding,
+    query: keywordQuery || query,
+    tenantId,
+    scope,
+    scopeId,
+    limit,
+    minSimilarity: 0.25,  // low threshold — let fusion scoring handle ranking, not hard cutoffs
+  });
+
+  const vectorCandidates: Candidate[] = [];
+  const keywordCandidates: Candidate[] = [];
+
+  for (const r of results) {
+    if (r.source === 'vector') {
+      vectorCandidates.push({
+        fact: r.fact,
+        vectorScore: r.relevanceScore,
+        keywordScore: 0,
+        graphScore: 0,
+        recencyScore: 0,
+        salienceScore: 0,
+        temporalScore: 0,
+        source: 'vector',
+      });
+    } else {
+      keywordCandidates.push({
+        fact: r.fact,
+        vectorScore: 0,
+        keywordScore: r.relevanceScore,
+        graphScore: 0,
+        recencyScore: 0,
+        salienceScore: 0,
+        temporalScore: 0,
+        source: 'keyword',
+      });
+    }
+  }
+
+  // Normalize keyword scores to [0, 1] range
+  if (keywordCandidates.length > 0) {
+    const maxRank = Math.max(...keywordCandidates.map(c => c.keywordScore));
+    if (maxRank > 0) {
+      for (const c of keywordCandidates) {
+        c.keywordScore = c.keywordScore / maxRank;
+      }
+    }
+  }
+
+  return { vectorCandidates, keywordCandidates };
+}

package/src/retrieval/contradiction-surfacer.d.ts

@@ -0,0 +1,18 @@
+import type { StorageAdapter } from '../adapters/storage.js';
+import type { FusionResult } from './fusion.js';
+import type { SearchResult } from './types.js';
+/**
+ * Enrich fusion results with contradiction context.
+ * For each result where the fact has an active contradiction,
+ * fetch the contradicted fact and build a timeline description.
+ */
+export declare function surfaceContradictions(storage: StorageAdapter, tenantId: string, results: FusionResult[]): Promise<SearchResult[]>;
+/**
+ * Build a human-readable timeline description of a contradiction.
+ * Examples:
+ * - "Opinion changed over ~2 months"
+ * - "Updated after 3 days"
+ * - "Superseded on the same day"
+ */
+export declare function buildTimeline(oldValidFrom: Date, _oldValidUntil: Date | null, newValidFrom: Date): string;
+//# sourceMappingURL=contradiction-surfacer.d.ts.map

package/src/retrieval/contradiction-surfacer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contradiction-surfacer.d.ts","sourceRoot":"","sources":["contradiction-surfacer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC,CAyCzB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,IAAI,EAClB,cAAc,EAAE,IAAI,GAAG,IAAI,EAC3B,YAAY,EAAE,IAAI,GACjB,MAAM,CAmBR"}

package/src/retrieval/contradiction-surfacer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contradiction-surfacer.js","sourceRoot":"","sources":["contradiction-surfacer.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAuB,EACvB,QAAgB,EAChB,OAAuB;IAEvB,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAExB,IAAI,aAAwD,CAAC;QAE7D,IACE,IAAI,CAAC,mBAAmB,KAAK,MAAM;YACnC,IAAI,CAAC,aAAa,EAClB,CAAC;YACD,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAE7E,IAAI,gBAAgB,EAAE,CAAC;gBACrB,MAAM,QAAQ,GAAG,aAAa,CAC5B,gBAAgB,CAAC,SAAS,EAC1B,gBAAgB,CAAC,UAAU,EAC3B,IAAI,CAAC,SAAS,CACf,CAAC;gBAEF,aAAa,GAAG;oBACd,WAAW,EAAE,gBAAgB;oBAC7B,MAAM,EAAE,IAAI,CAAC,mBAAmB;oBAChC,QAAQ;iBACT,CAAC;YACJ,CAAC;YACD,uFAAuF;QACzF,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,aAAa;YACb,mEAAmE;SACpE,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,YAAkB,EAClB,cAA2B,EAC3B,YAAkB;IAElB,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAEtE,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,4BAA4B,CAAC;IACxD,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,qBAAqB,CAAC;IACjD,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,iBAAiB,QAAQ,OAAO,CAAC;IAC1D,IAAI,QAAQ,GAAG,EAAE,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QACvC,OAAO,iBAAiB,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,QAAQ,GAAG,GAAG,EAAE,CAAC;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;QACzC,OAAO,iBAAiB,MAAM,SAAS,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IACnE,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;IACzC,OAAO,iBAAiB,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AAChE,CAAC"}

package/src/retrieval/contradiction-surfacer.ts

@@ -0,0 +1,87 @@
+import type { StorageAdapter } from '../adapters/storage.js';
+import type { FusionResult } from './fusion.js';
+import type { SearchResult } from './types.js';
+
+/**
+ * Enrich fusion results with contradiction context.
+ * For each result where the fact has an active contradiction,
+ * fetch the contradicted fact and build a timeline description.
+ */
+export async function surfaceContradictions(
+  storage: StorageAdapter,
+  tenantId: string,
+  results: FusionResult[],
+): Promise<SearchResult[]> {
+  const enriched: SearchResult[] = [];
+
+  for (const result of results) {
+    const { fact } = result;
+
+    let contradiction: SearchResult['contradiction'] | undefined;
+
+    if (
+      fact.contradictionStatus !== 'none' &&
+      fact.contradictsId
+    ) {
+      const contradictedFact = await storage.getFact(tenantId, fact.contradictsId);
+
+      if (contradictedFact) {
+        const timeline = buildTimeline(
+          contradictedFact.validFrom,
+          contradictedFact.validUntil,
+          fact.validFrom,
+        );
+
+        contradiction = {
+          contradicts: contradictedFact,
+          status: fact.contradictionStatus,
+          timeline,
+        };
+      }
+      // If contradicted fact was deleted (GDPR purge), gracefully omit contradiction context
+    }
+
+    enriched.push({
+      fact: result.fact,
+      score: result.score,
+      signals: result.signals,
+      triggeredBy: result.triggeredBy,
+      contradiction,
+      // graph and history are filled in by the search orchestrator later
+    });
+  }
+
+  return enriched;
+}
+
+/**
+ * Build a human-readable timeline description of a contradiction.
+ * Examples:
+ * - "Opinion changed over ~2 months"
+ * - "Updated after 3 days"
+ * - "Superseded on the same day"
+ */
+export function buildTimeline(
+  oldValidFrom: Date,
+  _oldValidUntil: Date | null,
+  newValidFrom: Date,
+): string {
+  const oldDate = new Date(oldValidFrom);
+  const newDate = new Date(newValidFrom);
+  const diffMs = newDate.getTime() - oldDate.getTime();
+  const diffDays = Math.abs(Math.round(diffMs / (1000 * 60 * 60 * 24)));
+
+  if (diffDays === 0) return 'Superseded on the same day';
+  if (diffDays === 1) return 'Updated after 1 day';
+  if (diffDays < 7) return `Updated after ${diffDays} days`;
+  if (diffDays < 30) {
+    const weeks = Math.round(diffDays / 7);
+    return `Changed over ~${weeks} week${weeks === 1 ? '' : 's'}`;
+  }
+  if (diffDays < 365) {
+    const months = Math.round(diffDays / 30);
+    return `Changed over ~${months} month${months === 1 ? '' : 's'}`;
+  }
+  const years = Math.round(diffDays / 365);
+  return `Changed over ~${years} year${years === 1 ? '' : 's'}`;
+}

package/src/retrieval/embedding-cache.d.ts

@@ -0,0 +1,17 @@
+import type { EmbeddingAdapter } from '../adapters/embedding.js';
+import type { CacheAdapter } from '../adapters/cache.js';
+/**
+ * Wraps an EmbeddingAdapter with caching.
+ * Same query text -> cached embedding (skip OpenAI call).
+ */
+export declare class CachedEmbeddingAdapter implements EmbeddingAdapter {
+    private inner;
+    private cache;
+    private ttlSeconds;
+    readonly model: string;
+    readonly dimensions: number;
+    constructor(inner: EmbeddingAdapter, cache: CacheAdapter, ttlSeconds?: number);
+    embed(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<number[][]>;
+}
+//# sourceMappingURL=embedding-cache.d.ts.map