@steno-ai/engine 0.1.0

package/src/models/fact-entity.ts

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+import { ENTITY_ROLES } from '../config.js';
+
+export const FactEntitySchema = z.object({
+  factId: z.string().uuid(),
+  entityId: z.string().uuid(),
+  role: z.enum(ENTITY_ROLES),
+  createdAt: z.coerce.date(),
+});
+
+export type FactEntity = z.infer<typeof FactEntitySchema>;
+
+export const CreateFactEntitySchema = z.object({
+  factId: z.string().uuid(),
+  entityId: z.string().uuid(),
+  role: z.enum(ENTITY_ROLES).default('mentioned'),
+});
+
+export type CreateFactEntity = z.infer<typeof CreateFactEntitySchema>;

package/src/models/fact.ts

@@ -0,0 +1,85 @@
+import { z } from 'zod';
+import {
+  unitFloat,
+  SCOPES,
+  OPERATIONS,
+  CONTRADICTION_STATUSES,
+  SOURCE_TYPES,
+  EXTRACTION_TIERS,
+  MODALITIES,
+} from '../config.js';
+
+export const FactSchema = z.object({
+  id: z.string().uuid(),
+  tenantId: z.string().uuid(),
+  scope: z.enum(SCOPES),
+  scopeId: z.string().min(1),
+  sessionId: z.string().uuid().nullable(),
+  content: z.string().min(1).max(50000),
+  // embeddingModel and embeddingDim are nullable because facts can be created
+  // before their embeddings are computed (spec deviation: pragmatic)
+  embeddingModel: z.string().nullable(),
+  embeddingDim: z.number().int().positive().nullable(),
+  version: z.number().int().positive(),
+  lineageId: z.string().uuid(),
+  validFrom: z.coerce.date(),
+  validUntil: z.coerce.date().nullable(),
+  operation: z.enum(OPERATIONS),
+  parentId: z.string().uuid().nullable(),
+  importance: unitFloat,
+  frequency: z.number().int().nonnegative(),
+  lastAccessed: z.coerce.date().nullable(),
+  decayScore: unitFloat,
+  contradictionStatus: z.enum(CONTRADICTION_STATUSES),
+  contradictsId: z.string().uuid().nullable(),
+  sourceType: z.enum(SOURCE_TYPES),
+  sourceRef: z.record(z.unknown()).nullable(),
+  confidence: unitFloat,
+  originalContent: z.string().nullable(),
+  extractionId: z.string().uuid().nullable(),
+  extractionTier: z.enum(EXTRACTION_TIERS).nullable(),
+  modality: z.enum(MODALITIES),
+  tags: z.array(z.string().max(100)).max(20),
+  metadata: z.record(z.string(), z.unknown()),
+  /** When the event described in the fact actually occurred */
+  eventDate: z.coerce.date().nullable().optional(),
+  /** When the conversation/document was authored */
+  documentDate: z.coerce.date().nullable().optional(),
+  /** The original conversation chunk this fact was extracted from */
+  sourceChunk: z.string().max(10000).nullable().optional().default(null),
+  createdAt: z.coerce.date(),
+});
+
+export type Fact = z.infer<typeof FactSchema>;
+
+export const CreateFactSchema = z.object({
+  tenantId: z.string().uuid(),
+  scope: z.enum(SCOPES),
+  scopeId: z.string().min(1),
+  sessionId: z.string().uuid().optional(),
+  content: z.string().min(1).max(50000),
+  embeddingModel: z.string().optional(),
+  embeddingDim: z.number().int().positive().optional(),
+  lineageId: z.string().uuid().optional(),
+  parentId: z.string().uuid().optional(),
+  importance: unitFloat.default(0.5),
+  confidence: unitFloat.default(0.8),
+  operation: z.enum(OPERATIONS).default('create'),
+  contradictionStatus: z.enum(CONTRADICTION_STATUSES).default('none'),
+  contradictsId: z.string().uuid().optional(),
+  sourceType: z.enum(SOURCE_TYPES).optional(),
+  sourceRef: z.record(z.unknown()).optional(),
+  originalContent: z.string().optional(),
+  extractionId: z.string().uuid().optional(),
+  extractionTier: z.enum(EXTRACTION_TIERS).optional(),
+  modality: z.enum(MODALITIES).default('text'),
+  tags: z.array(z.string().max(100)).max(20).default([]),
+  metadata: z.record(z.string(), z.unknown()).default({}),
+  sourceChunk: z.string().max(10000).optional(),
+  /** When the event described in the fact actually occurred */
+  eventDate: z.coerce.date().optional(),
+  /** When the conversation/document was authored */
+  documentDate: z.coerce.date().optional(),
+});
+
+export type CreateFact = z.infer<typeof CreateFactSchema>;

package/src/models/index.d.ts

@@ -0,0 +1,13 @@
+export * from './fact.js';
+export * from './entity.js';
+export * from './edge.js';
+export * from './trigger.js';
+export * from './memory-access.js';
+export * from './extraction.js';
+export * from './session.js';
+export * from './tenant.js';
+export * from './api-key.js';
+export * from './usage-record.js';
+export * from './fact-entity.js';
+export * from './webhook.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}

package/src/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC"}

package/src/models/index.ts

@@ -0,0 +1,12 @@
+export * from './fact.js';
+export * from './entity.js';
+export * from './edge.js';
+export * from './trigger.js';
+export * from './memory-access.js';
+export * from './extraction.js';
+export * from './session.js';
+export * from './tenant.js';
+export * from './api-key.js';
+export * from './usage-record.js';
+export * from './fact-entity.js';
+export * from './webhook.js';

package/src/models/memory-access.d.ts

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+export declare const MemoryAccessSchema: z.ZodObject<{
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    factId: z.ZodString;
+    query: z.ZodString;
+    retrievalMethod: z.ZodString;
+    similarityScore: z.ZodNullable<z.ZodNumber>;
+    rankPosition: z.ZodNullable<z.ZodNumber>;
+    wasUseful: z.ZodNullable<z.ZodBoolean>;
+    wasCorrected: z.ZodDefault<z.ZodBoolean>;
+    feedbackType: z.ZodNullable<z.ZodEnum<["implicit_positive", "implicit_negative", "explicit_positive", "explicit_negative", "correction"]>>;
+    feedbackDetail: z.ZodNullable<z.ZodString>;
+    triggerId: z.ZodNullable<z.ZodString>;
+    accessedAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    id: string;
+    tenantId: string;
+    factId: string;
+    retrievalMethod: string;
+    similarityScore: number | null;
+    rankPosition: number | null;
+    wasUseful: boolean | null;
+    wasCorrected: boolean;
+    feedbackType: "implicit_positive" | "implicit_negative" | "explicit_positive" | "explicit_negative" | "correction" | null;
+    feedbackDetail: string | null;
+    triggerId: string | null;
+    accessedAt: Date;
+}, {
+    query: string;
+    id: string;
+    tenantId: string;
+    factId: string;
+    retrievalMethod: string;
+    similarityScore: number | null;
+    rankPosition: number | null;
+    wasUseful: boolean | null;
+    feedbackType: "implicit_positive" | "implicit_negative" | "explicit_positive" | "explicit_negative" | "correction" | null;
+    feedbackDetail: string | null;
+    triggerId: string | null;
+    accessedAt: Date;
+    wasCorrected?: boolean | undefined;
+}>;
+export type MemoryAccess = z.infer<typeof MemoryAccessSchema>;
+export declare const CreateMemoryAccessSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    factId: z.ZodString;
+    query: z.ZodString;
+    retrievalMethod: z.ZodString;
+    similarityScore: z.ZodOptional<z.ZodNumber>;
+    rankPosition: z.ZodOptional<z.ZodNumber>;
+    triggerId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    tenantId: string;
+    factId: string;
+    retrievalMethod: string;
+    similarityScore?: number | undefined;
+    rankPosition?: number | undefined;
+    triggerId?: string | undefined;
+}, {
+    query: string;
+    tenantId: string;
+    factId: string;
+    retrievalMethod: string;
+    similarityScore?: number | undefined;
+    rankPosition?: number | undefined;
+    triggerId?: string | undefined;
+}>;
+export type CreateMemoryAccess = z.infer<typeof CreateMemoryAccessSchema>;
+export declare const SubmitFeedbackSchema: z.ZodObject<{
+    factId: z.ZodString;
+    wasUseful: z.ZodBoolean;
+    feedbackType: z.ZodEnum<["implicit_positive", "implicit_negative", "explicit_positive", "explicit_negative", "correction"]>;
+    feedbackDetail: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    factId: string;
+    wasUseful: boolean;
+    feedbackType: "implicit_positive" | "implicit_negative" | "explicit_positive" | "explicit_negative" | "correction";
+    feedbackDetail?: string | undefined;
+}, {
+    factId: string;
+    wasUseful: boolean;
+    feedbackType: "implicit_positive" | "implicit_negative" | "explicit_positive" | "explicit_negative" | "correction";
+    feedbackDetail?: string | undefined;
+}>;
+export type SubmitFeedback = z.infer<typeof SubmitFeedbackSchema>;
+//# sourceMappingURL=memory-access.d.ts.map

package/src/models/memory-access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-access.d.ts","sourceRoot":"","sources":["memory-access.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAc7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;EAQnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/src/models/memory-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-access.js","sourceRoot":"","sources":["memory-access.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,eAAe,EAAE,SAAS,CAAC,QAAQ,EAAE;IACrC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACvD,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACxC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE;IAC/C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACvC,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;CAC5B,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACzB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,eAAe,EAAE,SAAS,CAAC,QAAQ,EAAE;IACrC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACvD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACzB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE;IACtB,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IACpC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC"}

package/src/models/memory-access.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { unitFloat, FEEDBACK_TYPES } from '../config.js';
+
+export const MemoryAccessSchema = z.object({
+  id: z.string().uuid(),
+  tenantId: z.string().uuid(),
+  factId: z.string().uuid(),
+  query: z.string(),
+  retrievalMethod: z.string(),
+  similarityScore: unitFloat.nullable(),
+  rankPosition: z.number().int().nonnegative().nullable(),
+  wasUseful: z.boolean().nullable(),
+  wasCorrected: z.boolean().default(false),
+  feedbackType: z.enum(FEEDBACK_TYPES).nullable(),
+  feedbackDetail: z.string().nullable(),
+  triggerId: z.string().uuid().nullable(),
+  accessedAt: z.coerce.date(),
+});
+
+export type MemoryAccess = z.infer<typeof MemoryAccessSchema>;
+
+export const CreateMemoryAccessSchema = z.object({
+  tenantId: z.string().uuid(),
+  factId: z.string().uuid(),
+  query: z.string(),
+  retrievalMethod: z.string(),
+  similarityScore: unitFloat.optional(),
+  rankPosition: z.number().int().nonnegative().optional(),
+  triggerId: z.string().uuid().optional(),
+});
+
+export type CreateMemoryAccess = z.infer<typeof CreateMemoryAccessSchema>;
+
+export const SubmitFeedbackSchema = z.object({
+  factId: z.string().uuid(),
+  wasUseful: z.boolean(),
+  feedbackType: z.enum(FEEDBACK_TYPES),
+  feedbackDetail: z.string().optional(),
+});
+
+export type SubmitFeedback = z.infer<typeof SubmitFeedbackSchema>;

package/src/models/session.d.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+export declare const SessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    scope: z.ZodEnum<["user", "agent", "hive"]>;
+    scopeId: z.ZodString;
+    startedAt: z.ZodDate;
+    endedAt: z.ZodNullable<z.ZodDate>;
+    summary: z.ZodNullable<z.ZodString>;
+    topics: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    messageCount: z.ZodDefault<z.ZodNumber>;
+    factCount: z.ZodDefault<z.ZodNumber>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    createdAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    tenantId: string;
+    scope: "user" | "agent" | "hive";
+    scopeId: string;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    startedAt: Date;
+    endedAt: Date | null;
+    summary: string | null;
+    topics: string[];
+    messageCount: number;
+    factCount: number;
+}, {
+    id: string;
+    tenantId: string;
+    scope: "user" | "agent" | "hive";
+    scopeId: string;
+    createdAt: Date;
+    startedAt: Date;
+    endedAt: Date | null;
+    summary: string | null;
+    metadata?: Record<string, unknown> | undefined;
+    topics?: string[] | undefined;
+    messageCount?: number | undefined;
+    factCount?: number | undefined;
+}>;
+export type Session = z.infer<typeof SessionSchema>;
+export declare const CreateSessionSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    scope: z.ZodEnum<["user", "agent", "hive"]>;
+    scopeId: z.ZodString;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    tenantId: string;
+    scope: "user" | "agent" | "hive";
+    scopeId: string;
+    metadata: Record<string, unknown>;
+}, {
+    tenantId: string;
+    scope: "user" | "agent" | "hive";
+    scopeId: string;
+    metadata?: Record<string, unknown> | undefined;
+}>;
+export type CreateSession = z.infer<typeof CreateSessionSchema>;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAaxB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAK9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/src/models/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,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,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;IAC1B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACvC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACvD,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;CAC3B,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,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/session.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { SESSION_SCOPES } from '../config.js';
+
+export const SessionSchema = z.object({
+  id: z.string().uuid(),
+  tenantId: z.string().uuid(),
+  scope: z.enum(SESSION_SCOPES),
+  scopeId: z.string().min(1),
+  startedAt: z.coerce.date(),
+  endedAt: z.coerce.date().nullable(),
+  summary: z.string().nullable(),
+  topics: z.array(z.string()).default([]),
+  messageCount: z.number().int().nonnegative().default(0),
+  factCount: z.number().int().nonnegative().default(0),
+  metadata: z.record(z.string(), z.unknown()).default({}),
+  createdAt: z.coerce.date(),
+});
+
+export type Session = z.infer<typeof SessionSchema>;
+
+export const CreateSessionSchema = z.object({
+  tenantId: z.string().uuid(),
+  scope: z.enum(SESSION_SCOPES),
+  scopeId: z.string().min(1),
+  metadata: z.record(z.string(), z.unknown()).default({}),
+});
+
+export type CreateSession = z.infer<typeof CreateSessionSchema>;

package/src/models/tenant.d.ts

@@ -0,0 +1,214 @@
+import { z } from 'zod';
+export declare const TenantSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    config: z.ZodObject<{
+        embeddingModel: z.ZodDefault<z.ZodString>;
+        embeddingDim: z.ZodDefault<z.ZodNumber>;
+        decayHalfLifeDays: z.ZodDefault<z.ZodNumber>;
+        decayNormalizationK: z.ZodDefault<z.ZodNumber>;
+        maxFactsPerScope: z.ZodDefault<z.ZodNumber>;
+        retrievalWeights: z.ZodDefault<z.ZodObject<{
+            vector: z.ZodDefault<z.ZodNumber>;
+            keyword: z.ZodDefault<z.ZodNumber>;
+            graph: z.ZodDefault<z.ZodNumber>;
+            recency: z.ZodDefault<z.ZodNumber>;
+            salience: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            vector: number;
+            keyword: number;
+            graph: number;
+            recency: number;
+            salience: number;
+        }, {
+            vector?: number | undefined;
+            keyword?: number | undefined;
+            graph?: number | undefined;
+            recency?: number | undefined;
+            salience?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        embeddingModel: string;
+        embeddingDim: number;
+        decayHalfLifeDays: number;
+        decayNormalizationK: number;
+        maxFactsPerScope: number;
+        retrievalWeights: {
+            vector: number;
+            keyword: number;
+            graph: number;
+            recency: number;
+            salience: number;
+        };
+    }, {
+        embeddingModel?: string | undefined;
+        embeddingDim?: number | undefined;
+        decayHalfLifeDays?: number | undefined;
+        decayNormalizationK?: number | undefined;
+        maxFactsPerScope?: number | undefined;
+        retrievalWeights?: {
+            vector?: number | undefined;
+            keyword?: number | undefined;
+            graph?: number | undefined;
+            recency?: number | undefined;
+            salience?: number | undefined;
+        } | undefined;
+    }>;
+    plan: z.ZodEnum<["free", "pro", "scale", "enterprise"]>;
+    tokenLimitMonthly: z.ZodNumber;
+    queryLimitMonthly: z.ZodNumber;
+    stripeCustomerId: z.ZodNullable<z.ZodString>;
+    stripeSubscriptionId: z.ZodNullable<z.ZodString>;
+    active: z.ZodBoolean;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    config: {
+        embeddingModel: string;
+        embeddingDim: number;
+        decayHalfLifeDays: number;
+        decayNormalizationK: number;
+        maxFactsPerScope: number;
+        retrievalWeights: {
+            vector: number;
+            keyword: number;
+            graph: number;
+            recency: number;
+            salience: number;
+        };
+    };
+    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;
+}, {
+    config: {
+        embeddingModel?: string | undefined;
+        embeddingDim?: number | undefined;
+        decayHalfLifeDays?: number | undefined;
+        decayNormalizationK?: number | undefined;
+        maxFactsPerScope?: number | undefined;
+        retrievalWeights?: {
+            vector?: number | undefined;
+            keyword?: number | undefined;
+            graph?: number | undefined;
+            recency?: number | undefined;
+            salience?: number | undefined;
+        } | 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;
+}>;
+export type Tenant = z.infer<typeof TenantSchema>;
+export declare const CreateTenantSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+    plan: z.ZodDefault<z.ZodEnum<["free", "pro", "scale", "enterprise"]>>;
+    config: z.ZodDefault<z.ZodObject<{
+        embeddingModel: z.ZodDefault<z.ZodString>;
+        embeddingDim: z.ZodDefault<z.ZodNumber>;
+        decayHalfLifeDays: z.ZodDefault<z.ZodNumber>;
+        decayNormalizationK: z.ZodDefault<z.ZodNumber>;
+        maxFactsPerScope: z.ZodDefault<z.ZodNumber>;
+        retrievalWeights: z.ZodDefault<z.ZodObject<{
+            vector: z.ZodDefault<z.ZodNumber>;
+            keyword: z.ZodDefault<z.ZodNumber>;
+            graph: z.ZodDefault<z.ZodNumber>;
+            recency: z.ZodDefault<z.ZodNumber>;
+            salience: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            vector: number;
+            keyword: number;
+            graph: number;
+            recency: number;
+            salience: number;
+        }, {
+            vector?: number | undefined;
+            keyword?: number | undefined;
+            graph?: number | undefined;
+            recency?: number | undefined;
+            salience?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        embeddingModel: string;
+        embeddingDim: number;
+        decayHalfLifeDays: number;
+        decayNormalizationK: number;
+        maxFactsPerScope: number;
+        retrievalWeights: {
+            vector: number;
+            keyword: number;
+            graph: number;
+            recency: number;
+            salience: number;
+        };
+    }, {
+        embeddingModel?: string | undefined;
+        embeddingDim?: number | undefined;
+        decayHalfLifeDays?: number | undefined;
+        decayNormalizationK?: number | undefined;
+        maxFactsPerScope?: number | undefined;
+        retrievalWeights?: {
+            vector?: number | undefined;
+            keyword?: number | undefined;
+            graph?: number | undefined;
+            recency?: number | undefined;
+            salience?: number | undefined;
+        } | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    config: {
+        embeddingModel: string;
+        embeddingDim: number;
+        decayHalfLifeDays: number;
+        decayNormalizationK: number;
+        maxFactsPerScope: number;
+        retrievalWeights: {
+            vector: number;
+            keyword: number;
+            graph: number;
+            recency: number;
+            salience: number;
+        };
+    };
+    name: string;
+    slug: string;
+    plan: "free" | "pro" | "scale" | "enterprise";
+}, {
+    name: string;
+    slug: string;
+    config?: {
+        embeddingModel?: string | undefined;
+        embeddingDim?: number | undefined;
+        decayHalfLifeDays?: number | undefined;
+        decayNormalizationK?: number | undefined;
+        maxFactsPerScope?: number | undefined;
+        retrievalWeights?: {
+            vector?: number | undefined;
+            keyword?: number | undefined;
+            graph?: number | undefined;
+            recency?: number | undefined;
+            salience?: number | undefined;
+        } | undefined;
+    } | undefined;
+    plan?: "free" | "pro" | "scale" | "enterprise" | undefined;
+}>;
+export type CreateTenant = z.infer<typeof CreateTenantSchema>;
+//# sourceMappingURL=tenant.d.ts.map

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

@@ -0,0 +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"}

package/src/models/tenant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant.js","sourceRoot":"","sources":["tenant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;IAC9C,MAAM,EAAE,iBAAiB;IACzB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IACnB,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC9C,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC9C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3C,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,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,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;CACtC,CAAC,CAAC"}

package/src/models/tenant.ts

@@ -0,0 +1,28 @@
+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 type Tenant = z.infer<typeof TenantSchema>;
+
+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({}),
+});
+
+export type CreateTenant = z.infer<typeof CreateTenantSchema>;