@redaksjon/protokoll-engine 0.1.3 → 0.1.4-dev.20260216151443.e1454c9

package/dist/weighting/provider.d.ts

@@ -0,0 +1,78 @@
+import { WeightModel, EntityPrediction, PredictionContext } from './types';
+/**
+ * WeightModelProvider
+ *
+ * Manages a weight model and provides entity prediction queries.
+ * Designed to be purely additive - when no model is available, returns empty results
+ * without breaking the enhancement pipeline.
+ */
+export declare class WeightModelProvider {
+    private model;
+    constructor(model?: WeightModel | null);
+    /**
+     * Check if a weight model is available
+     *
+     * @returns true if model is loaded, false otherwise
+     */
+    isAvailable(): boolean;
+    /**
+     * Load a weight model into the provider
+     *
+     * @param model - Weight model to load
+     */
+    loadModel(model: WeightModel): void;
+    /**
+     * Clear the current model
+     */
+    clearModel(): void;
+    /**
+     * Get the current model (for inspection/debugging)
+     *
+     * @returns Current weight model or null
+     */
+    getModel(): WeightModel | null;
+    /**
+     * Predict likely entities based on known context
+     *
+     * Combines two signals:
+     * 1. Co-occurrence: entities that appear with the known entities
+     * 2. Project-specific: entities common in the given project (boosted by 1.5x)
+     *
+     * @param context - Prediction context with known entities and project
+     * @returns Array of entity predictions sorted by score (descending)
+     */
+    predictLikelyEntities(context: PredictionContext): EntityPrediction[];
+    /**
+     * Determine the primary source of a prediction
+     *
+     * @param entityId - Entity being predicted
+     * @param knownEntityIds - Known entities in context
+     * @param projectId - Project ID if known
+     * @returns Source type
+     */
+    private determineSource;
+    /**
+     * Get project-specific entity frequencies
+     *
+     * Returns a map of entity IDs to their frequency counts for a given project.
+     * Used by the routing classifier to boost project confidence when entities match.
+     *
+     * @param projectId - Project identifier
+     * @returns Entity frequency map or null if project not in model
+     */
+    getProjectFrequencies(projectId: string): Record<string, number> | null;
+    /**
+     * Get statistics about the current model
+     *
+     * @returns Model statistics or null if no model loaded
+     */
+    getStatistics(): {
+        transcriptCount: number;
+        entityCount: number;
+        cooccurrenceCount: number;
+        projectCount: number;
+        builtAt: string;
+        lastUpdatedAt: string;
+    } | null;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/weighting/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/weighting/provider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE3E;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,KAAK,CAAqB;gBAEtB,KAAK,GAAE,WAAW,GAAG,IAAW;IAI5C;;;;OAIG;IACH,WAAW,IAAI,OAAO;IAItB;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAInC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACH,QAAQ,IAAI,WAAW,GAAG,IAAI;IAI9B;;;;;;;;;OASG;IACH,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,EAAE;IA2DrE;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;;;;;;OAQG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAOvE;;;;OAIG;IACH,aAAa,IAAI;QACb,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI;CAkBX"}

package/dist/weighting/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Weight Model Types
+ *
+ * Data structures for entity co-occurrence tracking and weight model management.
+ * The weight model tracks which entities appear together in transcripts to improve
+ * routing accuracy and LLM enhancement prepositioning.
+ */
+/**
+ * Per-entity co-occurrence counts: entityId -> cooccurringEntityId -> count
+ *
+ * Example:
+ * {
+ *   "protokoll": {
+ *     "redaksjon": 47,
+ *     "mcp": 31,
+ *     "tim": 22
+ *   },
+ *   "tim": {
+ *     "redaksjon": 58,
+ *     "brennpunkt": 12
+ *   }
+ * }
+ */
+export interface EntityCooccurrence {
+    [entityId: string]: {
+        [cooccurringEntityId: string]: number;
+    };
+}
+/**
+ * Per-project entity frequency counts: projectId -> entityId -> count
+ *
+ * Example:
+ * {
+ *   "redaksjon": {
+ *     "protokoll": 47,
+ *     "mcp": 29,
+ *     "tim": 22
+ *   }
+ * }
+ */
+export interface ProjectEntityFrequency {
+    [projectId: string]: {
+        [entityId: string]: number;
+    };
+}
+/**
+ * Per-transcript snapshot of which entities were present.
+ * Keyed by transcript UUID. Used for incremental updates:
+ * when a transcript's entities change, subtract the old snapshot
+ * and add the new one.
+ *
+ * Example:
+ * {
+ *   "a1b2c3d4-e5f6-7890-abcd-ef1234567890": {
+ *     "entityIds": ["protokoll", "mcp", "tim", "redaksjon"],
+ *     "projectId": "redaksjon"
+ *   }
+ * }
+ */
+export interface TranscriptEntitySnapshot {
+    [transcriptUuid: string]: {
+        entityIds: string[];
+        projectId?: string;
+    };
+}
+/**
+ * Complete weight model structure
+ */
+export interface WeightModel {
+    /** Entity-to-entity co-occurrence matrix */
+    cooccurrence: EntityCooccurrence;
+    /** Project-specific entity frequencies */
+    byProject: ProjectEntityFrequency;
+    /** Tracks which transcripts contributed to the model, keyed by UUID */
+    transcriptSnapshots: TranscriptEntitySnapshot;
+    /** Model metadata */
+    metadata: {
+        builtAt: string;
+        lastUpdatedAt: string;
+        transcriptCount: number;
+        entityCount: number;
+        version: string;
+    };
+}
+/**
+ * Configuration for weight model building
+ */
+export interface WeightModelConfig {
+    /** Maximum number of transcripts to scan (most recent) */
+    maxTranscripts: number;
+    /** Minimum co-occurrence count to include in output (noise filter) */
+    minCooccurrenceCount: number;
+    /** Path where the weight model JSON file should be written */
+    outputFilePath: string;
+}
+/**
+ * Entity prediction result for a given context
+ */
+export interface EntityPrediction {
+    entityId: string;
+    entityName?: string;
+    entityType?: 'person' | 'project' | 'term' | 'company';
+    score: number;
+    source: 'cooccurrence' | 'project' | 'global';
+}
+/**
+ * Context for making entity predictions
+ */
+export interface PredictionContext {
+    /** Known entity IDs in the current context */
+    knownEntityIds?: string[];
+    /** Project ID if known */
+    projectId?: string;
+    /** Maximum number of predictions to return */
+    maxPredictions?: number;
+    /** Minimum score threshold */
+    minScore?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/weighting/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/weighting/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,kBAAkB;IACjC,CAAC,QAAQ,EAAE,MAAM,GAAG;QAClB,CAAC,mBAAmB,EAAE,MAAM,GAAG,MAAM,CAAC;KACvC,CAAC;CACH;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,sBAAsB;IACrC,CAAC,SAAS,EAAE,MAAM,GAAG;QACnB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;KAC5B,CAAC;CACH;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,wBAAwB;IACvC,CAAC,cAAc,EAAE,MAAM,GAAG;QACxB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,YAAY,EAAE,kBAAkB,CAAC;IAEjC,0CAA0C;IAC1C,SAAS,EAAE,sBAAsB,CAAC;IAElC,uEAAuE;IACvE,mBAAmB,EAAE,wBAAwB,CAAC;IAE9C,qBAAqB;IACrB,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IAEvB,sEAAsE;IACtE,oBAAoB,EAAE,MAAM,CAAC;IAE7B,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redaksjon/protokoll-engine",
-  "version": "0.1.3",
+  "version": "0.1.4-dev.20260216151443.e1454c9",
   "description": "Processing engine for Protokoll - transcription pipeline, agentic execution, routing, and LLM integration",
   "type": "module",
   "main": "dist/index.js",
@@ -47,7 +47,7 @@
     "@google/generative-ai": "^0.24.1",
     "@kjerneverk/riotprompt": "^1.0.6",
     "@redaksjon/context": "^0.0.7",
-    "@redaksjon/protokoll-format": "^0.1.1",
+    "@redaksjon/protokoll-format": "^0.1.3",
     "@utilarium/cardigantime": "^0.0.26",
     "@utilarium/dreadcabinet": "^0.0.16",
     "dayjs": "^1.11.13",