@steno-ai/engine 0.1.0 → 0.1.2

package/src/models/extraction.d.ts

@@ -28,13 +28,12 @@ export declare const ExtractionSchema: z.ZodObject<{
 }, "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";
+    inputType: "code" | "conversation" | "document" | "url" | "raw_text" | "image" | "audio";
     inputData: string | Record<string, unknown> | null;
     inputHash: string;
     inputSize: number | null;
@@ -49,18 +48,18 @@ export declare const ExtractionSchema: z.ZodObject<{
     costTokensOutput: number;
     costUsd: number;
     durationMs: number | null;
+    error: string | 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";
+    inputType: "code" | "conversation" | "document" | "url" | "raw_text" | "image" | "audio";
     inputData: string | Record<string, unknown> | null;
     inputHash: string;
     inputSize: number | null;
@@ -75,6 +74,7 @@ export declare const ExtractionSchema: z.ZodObject<{
     costTokensOutput: number;
     costUsd: number;
     durationMs: number | null;
+    error: string | null;
     retryCount: number;
     completedAt: Date | null;
 }>;
@@ -92,7 +92,7 @@ export declare const CreateExtractionSchema: z.ZodObject<{
     tenantId: string;
     scope: "user" | "agent" | "session" | "hive";
     scopeId: string;
-    inputType: "url" | "image" | "audio" | "code" | "conversation" | "document" | "raw_text";
+    inputType: "code" | "conversation" | "document" | "url" | "raw_text" | "image" | "audio";
     inputData: string;
     inputHash: string;
     sessionId?: string | undefined;
@@ -101,7 +101,7 @@ export declare const CreateExtractionSchema: z.ZodObject<{
     tenantId: string;
     scope: "user" | "agent" | "session" | "hive";
     scopeId: string;
-    inputType: "url" | "image" | "audio" | "code" | "conversation" | "document" | "raw_text";
+    inputType: "code" | "conversation" | "document" | "url" | "raw_text" | "image" | "audio";
     inputData: string;
     inputHash: string;
     sessionId?: string | undefined;

package/src/models/extraction.js

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

package/src/models/fact-entity.js

@@ -0,0 +1,14 @@
+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 const CreateFactEntitySchema = z.object({
+    factId: z.string().uuid(),
+    entityId: z.string().uuid(),
+    role: z.enum(ENTITY_ROLES).default('mentioned'),
+});
+//# sourceMappingURL=fact-entity.js.map

package/src/models/fact.d.ts

@@ -0,0 +1,191 @@
+import { z } from 'zod';
+export declare const FactSchema: z.ZodObject<{
+    id: z.ZodString;
+    tenantId: z.ZodString;
+    scope: z.ZodEnum<["user", "agent", "session", "hive"]>;
+    scopeId: z.ZodString;
+    sessionId: z.ZodNullable<z.ZodString>;
+    content: z.ZodString;
+    embeddingModel: z.ZodNullable<z.ZodString>;
+    embeddingDim: z.ZodNullable<z.ZodNumber>;
+    version: z.ZodNumber;
+    lineageId: z.ZodString;
+    validFrom: z.ZodDate;
+    validUntil: z.ZodNullable<z.ZodDate>;
+    operation: z.ZodEnum<["create", "update", "invalidate"]>;
+    parentId: z.ZodNullable<z.ZodString>;
+    importance: z.ZodNumber;
+    frequency: z.ZodNumber;
+    lastAccessed: z.ZodNullable<z.ZodDate>;
+    decayScore: z.ZodNumber;
+    contradictionStatus: z.ZodEnum<["none", "active", "resolved", "superseded"]>;
+    contradictsId: z.ZodNullable<z.ZodString>;
+    sourceType: z.ZodEnum<["conversation", "document", "url", "raw_text", "api", "agent_self"]>;
+    sourceRef: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    confidence: z.ZodNumber;
+    originalContent: z.ZodNullable<z.ZodString>;
+    extractionId: z.ZodNullable<z.ZodString>;
+    extractionTier: z.ZodNullable<z.ZodEnum<["heuristic", "cheap_llm", "smart_llm"]>>;
+    modality: z.ZodEnum<["text", "image", "audio", "code", "document"]>;
+    tags: z.ZodArray<z.ZodString, "many">;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    /** When the event described in the fact actually occurred */
+    eventDate: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    /** When the conversation/document was authored */
+    documentDate: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+    /** The original conversation chunk this fact was extracted from */
+    sourceChunk: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    createdAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    embeddingModel: string | null;
+    embeddingDim: number | null;
+    id: string;
+    tenantId: string;
+    scope: "user" | "agent" | "session" | "hive";
+    scopeId: string;
+    sessionId: string | null;
+    content: string;
+    version: number;
+    lineageId: string;
+    validFrom: Date;
+    validUntil: Date | null;
+    operation: "create" | "update" | "invalidate";
+    parentId: string | null;
+    importance: number;
+    frequency: number;
+    lastAccessed: Date | null;
+    decayScore: number;
+    contradictionStatus: "none" | "active" | "resolved" | "superseded";
+    contradictsId: string | null;
+    sourceType: "conversation" | "document" | "url" | "raw_text" | "api" | "agent_self";
+    sourceRef: Record<string, unknown> | null;
+    confidence: number;
+    originalContent: string | null;
+    extractionId: string | null;
+    extractionTier: "heuristic" | "cheap_llm" | "smart_llm" | null;
+    modality: "code" | "document" | "text" | "image" | "audio";
+    tags: string[];
+    metadata: Record<string, unknown>;
+    sourceChunk: string | null;
+    createdAt: Date;
+    eventDate?: Date | null | undefined;
+    documentDate?: Date | null | undefined;
+}, {
+    embeddingModel: string | null;
+    embeddingDim: number | null;
+    id: string;
+    tenantId: string;
+    scope: "user" | "agent" | "session" | "hive";
+    scopeId: string;
+    sessionId: string | null;
+    content: string;
+    version: number;
+    lineageId: string;
+    validFrom: Date;
+    validUntil: Date | null;
+    operation: "create" | "update" | "invalidate";
+    parentId: string | null;
+    importance: number;
+    frequency: number;
+    lastAccessed: Date | null;
+    decayScore: number;
+    contradictionStatus: "none" | "active" | "resolved" | "superseded";
+    contradictsId: string | null;
+    sourceType: "conversation" | "document" | "url" | "raw_text" | "api" | "agent_self";
+    sourceRef: Record<string, unknown> | null;
+    confidence: number;
+    originalContent: string | null;
+    extractionId: string | null;
+    extractionTier: "heuristic" | "cheap_llm" | "smart_llm" | null;
+    modality: "code" | "document" | "text" | "image" | "audio";
+    tags: string[];
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    eventDate?: Date | null | undefined;
+    documentDate?: Date | null | undefined;
+    sourceChunk?: string | null | undefined;
+}>;
+export type Fact = z.infer<typeof FactSchema>;
+export declare const CreateFactSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    scope: z.ZodEnum<["user", "agent", "session", "hive"]>;
+    scopeId: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+    content: z.ZodString;
+    embeddingModel: z.ZodOptional<z.ZodString>;
+    embeddingDim: z.ZodOptional<z.ZodNumber>;
+    lineageId: z.ZodOptional<z.ZodString>;
+    parentId: z.ZodOptional<z.ZodString>;
+    importance: z.ZodDefault<z.ZodNumber>;
+    confidence: z.ZodDefault<z.ZodNumber>;
+    operation: z.ZodDefault<z.ZodEnum<["create", "update", "invalidate"]>>;
+    contradictionStatus: z.ZodDefault<z.ZodEnum<["none", "active", "resolved", "superseded"]>>;
+    contradictsId: z.ZodOptional<z.ZodString>;
+    sourceType: z.ZodOptional<z.ZodEnum<["conversation", "document", "url", "raw_text", "api", "agent_self"]>>;
+    sourceRef: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    originalContent: z.ZodOptional<z.ZodString>;
+    extractionId: z.ZodOptional<z.ZodString>;
+    extractionTier: z.ZodOptional<z.ZodEnum<["heuristic", "cheap_llm", "smart_llm"]>>;
+    modality: z.ZodDefault<z.ZodEnum<["text", "image", "audio", "code", "document"]>>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    sourceChunk: z.ZodOptional<z.ZodString>;
+    /** When the event described in the fact actually occurred */
+    eventDate: z.ZodOptional<z.ZodDate>;
+    /** When the conversation/document was authored */
+    documentDate: z.ZodOptional<z.ZodDate>;
+}, "strip", z.ZodTypeAny, {
+    tenantId: string;
+    scope: "user" | "agent" | "session" | "hive";
+    scopeId: string;
+    content: string;
+    operation: "create" | "update" | "invalidate";
+    importance: number;
+    contradictionStatus: "none" | "active" | "resolved" | "superseded";
+    confidence: number;
+    modality: "code" | "document" | "text" | "image" | "audio";
+    tags: string[];
+    metadata: Record<string, unknown>;
+    embeddingModel?: string | undefined;
+    embeddingDim?: number | undefined;
+    sessionId?: string | undefined;
+    lineageId?: string | undefined;
+    parentId?: string | undefined;
+    contradictsId?: string | undefined;
+    sourceType?: "conversation" | "document" | "url" | "raw_text" | "api" | "agent_self" | undefined;
+    sourceRef?: Record<string, unknown> | undefined;
+    originalContent?: string | undefined;
+    extractionId?: string | undefined;
+    extractionTier?: "heuristic" | "cheap_llm" | "smart_llm" | undefined;
+    eventDate?: Date | undefined;
+    documentDate?: Date | undefined;
+    sourceChunk?: string | undefined;
+}, {
+    tenantId: string;
+    scope: "user" | "agent" | "session" | "hive";
+    scopeId: string;
+    content: string;
+    embeddingModel?: string | undefined;
+    embeddingDim?: number | undefined;
+    sessionId?: string | undefined;
+    lineageId?: string | undefined;
+    operation?: "create" | "update" | "invalidate" | undefined;
+    parentId?: string | undefined;
+    importance?: number | undefined;
+    contradictionStatus?: "none" | "active" | "resolved" | "superseded" | undefined;
+    contradictsId?: string | undefined;
+    sourceType?: "conversation" | "document" | "url" | "raw_text" | "api" | "agent_self" | undefined;
+    sourceRef?: Record<string, unknown> | undefined;
+    confidence?: number | undefined;
+    originalContent?: string | undefined;
+    extractionId?: string | undefined;
+    extractionTier?: "heuristic" | "cheap_llm" | "smart_llm" | undefined;
+    modality?: "code" | "document" | "text" | "image" | "audio" | undefined;
+    tags?: string[] | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    eventDate?: Date | undefined;
+    documentDate?: Date | undefined;
+    sourceChunk?: string | undefined;
+}>;
+export type CreateFact = z.infer<typeof CreateFactSchema>;
+//# sourceMappingURL=fact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fact.d.ts","sourceRoot":"","sources":["fact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAgCrB,6DAA6D;;IAE7D,kDAAkD;;IAElD,mEAAmE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGnE,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;IAwB3B,6DAA6D;;IAE7D,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAElD,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/src/models/fact.js

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

package/src/models/fact.js.map

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

package/src/models/index.js

@@ -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.js.map

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

@@ -14,10 +14,10 @@ export declare const MemoryAccessSchema: z.ZodObject<{
     triggerId: z.ZodNullable<z.ZodString>;
     accessedAt: z.ZodDate;
 }, "strip", z.ZodTypeAny, {
-    query: string;
     id: string;
     tenantId: string;
     factId: string;
+    query: string;
     retrievalMethod: string;
     similarityScore: number | null;
     rankPosition: number | null;
@@ -28,10 +28,10 @@ export declare const MemoryAccessSchema: z.ZodObject<{
     triggerId: string | null;
     accessedAt: Date;
 }, {
-    query: string;
     id: string;
     tenantId: string;
     factId: string;
+    query: string;
     retrievalMethod: string;
     similarityScore: number | null;
     rankPosition: number | null;
@@ -52,17 +52,17 @@ export declare const CreateMemoryAccessSchema: z.ZodObject<{
     rankPosition: z.ZodOptional<z.ZodNumber>;
     triggerId: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    query: string;
     tenantId: string;
     factId: string;
+    query: string;
     retrievalMethod: string;
     similarityScore?: number | undefined;
     rankPosition?: number | undefined;
     triggerId?: string | undefined;
 }, {
-    query: string;
     tenantId: string;
     factId: string;
+    query: string;
     retrievalMethod: string;
     similarityScore?: number | undefined;
     rankPosition?: number | undefined;

package/src/models/memory-access.js

@@ -0,0 +1,33 @@
+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 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 const SubmitFeedbackSchema = z.object({
+    factId: z.string().uuid(),
+    wasUseful: z.boolean(),
+    feedbackType: z.enum(FEEDBACK_TYPES),
+    feedbackDetail: z.string().optional(),
+});
+//# sourceMappingURL=memory-access.js.map

package/src/models/session.js

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