@steno-ai/engine 0.1.1 → 0.1.3

package/src/models/tenant.d.ts

@@ -15,18 +15,83 @@ export declare const TenantSchema: z.ZodObject<{
             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;
@@ -40,7 +105,20 @@ export declare const TenantSchema: z.ZodObject<{
             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;
@@ -53,6 +131,19 @@ export declare const TenantSchema: z.ZodObject<{
             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;
     }>;
     plan: z.ZodEnum<["free", "pro", "scale", "enterprise"]>;
@@ -64,6 +155,12 @@ export declare const TenantSchema: z.ZodObject<{
     createdAt: z.ZodDate;
     updatedAt: z.ZodDate;
 }, "strip", z.ZodTypeAny, {
+    name: string;
+    active: boolean;
+    id: string;
+    createdAt: Date;
+    updatedAt: Date;
+    slug: string;
     config: {
         embeddingModel: string;
         embeddingDim: number;
@@ -76,20 +173,33 @@ export declare const TenantSchema: z.ZodObject<{
             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;
     };
-    name: string;
-    id: string;
-    active: boolean;
-    createdAt: Date;
-    updatedAt: Date;
-    slug: string;
     plan: "free" | "pro" | "scale" | "enterprise";
     tokenLimitMonthly: number;
     queryLimitMonthly: number;
     stripeCustomerId: string | null;
     stripeSubscriptionId: string | null;
 }, {
+    name: string;
+    active: boolean;
+    id: string;
+    createdAt: Date;
+    updatedAt: Date;
+    slug: string;
     config: {
         embeddingModel?: string | undefined;
         embeddingDim?: number | undefined;
@@ -102,14 +212,21 @@ export declare const TenantSchema: z.ZodObject<{
             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;
     };
-    name: string;
-    id: string;
-    active: boolean;
-    createdAt: Date;
-    updatedAt: Date;
-    slug: string;
     plan: "free" | "pro" | "scale" | "enterprise";
     tokenLimitMonthly: number;
     queryLimitMonthly: number;
@@ -133,18 +250,83 @@ export declare const CreateTenantSchema: z.ZodObject<{
             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;
@@ -158,7 +340,20 @@ export declare const CreateTenantSchema: z.ZodObject<{
             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;
@@ -171,9 +366,24 @@ export declare const CreateTenantSchema: z.ZodObject<{
             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;
     }>>;
 }, "strip", z.ZodTypeAny, {
+    name: string;
+    slug: string;
     config: {
         embeddingModel: string;
         embeddingDim: number;
@@ -186,10 +396,21 @@ export declare const CreateTenantSchema: z.ZodObject<{
             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;
     };
-    name: string;
-    slug: string;
     plan: "free" | "pro" | "scale" | "enterprise";
 }, {
     name: string;
@@ -206,6 +427,19 @@ export declare const CreateTenantSchema: z.ZodObject<{
             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;
     } | undefined;
     plan?: "free" | "pro" | "scale" | "enterprise" | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"tenant.d.ts","sourceRoot":"","sources":["tenant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAavB,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"}
+{"version":3,"file":"tenant.d.ts","sourceRoot":"","sources":["tenant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAavB,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/tenant.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { StenoConfigSchema, PLANS } from '../config.js';
+export const TenantSchema = z.object({
+    id: z.string().uuid(),
+    name: z.string().max(100),
+    slug: z.string().max(50).regex(/^[a-z0-9-]+$/),
+    config: StenoConfigSchema,
+    plan: z.enum(PLANS),
+    tokenLimitMonthly: z.number().int().positive(),
+    queryLimitMonthly: z.number().int().positive(),
+    stripeCustomerId: z.string().nullable(),
+    stripeSubscriptionId: z.string().nullable(),
+    active: z.boolean(),
+    createdAt: z.coerce.date(),
+    updatedAt: z.coerce.date(),
+});
+export const CreateTenantSchema = z.object({
+    name: z.string().max(100),
+    slug: z.string().max(50).regex(/^[a-z0-9-]+$/),
+    plan: z.enum(PLANS).default('free'),
+    config: StenoConfigSchema.default({}),
+});
+//# sourceMappingURL=tenant.js.map

package/src/models/trigger.d.ts

@@ -26,9 +26,8 @@ export declare const TriggerSchema: z.ZodObject<{
     lastFiredAt: z.ZodNullable<z.ZodDate>;
     createdAt: z.ZodDate;
 }, "strip", z.ZodTypeAny, {
-    priority: number;
-    id: string;
     active: boolean;
+    id: string;
     tenantId: string;
     scope: "user" | "agent" | "session" | "hive";
     scopeId: string;
@@ -37,6 +36,7 @@ export declare const TriggerSchema: z.ZodObject<{
     factIds: string[];
     entityIds: string[];
     queryTemplate: string | null;
+    priority: number;
     timesFired: number;
     lastFiredAt: Date | null;
 }, {
@@ -50,8 +50,8 @@ export declare const TriggerSchema: z.ZodObject<{
     entityIds: string[];
     queryTemplate: string | null;
     lastFiredAt: Date | null;
-    priority?: number | undefined;
     active?: boolean | undefined;
+    priority?: number | undefined;
     timesFired?: number | undefined;
 }>;
 export type Trigger = z.infer<typeof TriggerSchema>;
@@ -65,23 +65,23 @@ export declare const CreateTriggerSchema: z.ZodObject<{
     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[];
+    priority: number;
     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;
+    priority?: number | undefined;
 }>;
 export type CreateTrigger = z.infer<typeof CreateTriggerSchema>;
 //# sourceMappingURL=trigger.d.ts.map

package/src/models/trigger.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { SCOPES } from '../config.js';
+export const TriggerConditionSchema = 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 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),
+});
+//# sourceMappingURL=trigger.js.map

package/src/models/usage-record.js

@@ -0,0 +1,14 @@
+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(),
+});
+//# sourceMappingURL=usage-record.js.map

package/src/models/webhook.d.ts

@@ -11,9 +11,9 @@ export declare const WebhookSchema: z.ZodObject<{
     active: z.ZodDefault<z.ZodBoolean>;
     createdAt: z.ZodDate;
 }, "strip", z.ZodTypeAny, {
+    active: boolean;
     url: string;
     id: string;
-    active: boolean;
     tenantId: string;
     createdAt: Date;
     events: ("extraction.completed" | "extraction.failed" | "trigger.fired" | "usage.limit_approaching" | "usage.limit_exceeded")[];

package/src/models/webhook.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+export const WEBHOOK_EVENTS = [
+    'extraction.completed',
+    'extraction.failed',
+    'trigger.fired',
+    'usage.limit_approaching',
+    'usage.limit_exceeded',
+];
+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 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),
+});
+//# sourceMappingURL=webhook.js.map

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

@@ -1 +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"}
+{"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,CA6D5E"}

package/src/retrieval/compound-search.js

@@ -0,0 +1,87 @@
+/**
+ * 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, embedding, query, tenantId, scope, scopeId, limit) {
+    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 = [];
+    const keywordCandidates = [];
+    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 };
+}
+//# sourceMappingURL=compound-search.js.map

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

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