@redaksjon/protokoll-engine 0.1.1-dev.0

package/dist/util/dates.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Yes, wrapping dayjs is a bit annoying and might seem overly paranoid. However, I feel strongly
+ * about not letting Dayjs instances leak into the rest of the codebase. Having Dayjs objects
+ * floating around the application leads to inconsistent timezone handling, makes testing more
+ * difficult, and creates subtle bugs that are hard to track down.
+ *
+ * By wrapping dayjs completely and only exposing plain JavaScript Date objects, we get several
+ * key benefits:
+ * 1. Consistent timezone handling through a single configuration point
+ * 2. Simpler testing since we only need to mock this one library
+ * 3. Type safety - the rest of the codebase only deals with standard Date objects
+ * 4. No risk of dayjs method chains creating unexpected timezone shifts
+ *
+ * The Library interface gives us full control over all date operations while keeping the messy
+ * details of timezone manipulation contained in one place. Yes it's more code, but the peace of
+ * mind is worth it.
+ */
+export interface Utility {
+    now: () => Date;
+    date: (date: string | number | Date | null | undefined) => Date;
+    parse: (date: string | number | Date | null | undefined, format: string) => Date;
+    addDays: (date: Date, days: number) => Date;
+    addMonths: (date: Date, months: number) => Date;
+    addYears: (date: Date, years: number) => Date;
+    format: (date: Date, format: string) => string;
+    subDays: (date: Date, days: number) => Date;
+    subMonths: (date: Date, months: number) => Date;
+    subYears: (date: Date, years: number) => Date;
+    startOfMonth: (date: Date) => Date;
+    endOfMonth: (date: Date) => Date;
+    startOfYear: (date: Date) => Date;
+    endOfYear: (date: Date) => Date;
+    isBefore: (date: Date, other: Date) => boolean;
+    isAfter: (date: Date, other: Date) => boolean;
+}
+export declare const create: (parameters: {
+    timezone: string;
+}) => {
+    now: () => Date;
+    date: (date: string | number | Date | null | undefined) => Date;
+    parse: (date: string | number | Date | null | undefined, format: string) => Date;
+    addDays: (date: Date, days: number) => Date;
+    addMonths: (date: Date, months: number) => Date;
+    addYears: (date: Date, years: number) => Date;
+    format: (date: Date, format: string) => string;
+    subDays: (date: Date, days: number) => Date;
+    subMonths: (date: Date, months: number) => Date;
+    subYears: (date: Date, years: number) => Date;
+    startOfMonth: (date: Date) => Date;
+    endOfMonth: (date: Date) => Date;
+    startOfYear: (date: Date) => Date;
+    endOfYear: (date: Date) => Date;
+    isBefore: (date: Date, other: Date) => boolean;
+    isAfter: (date: Date, other: Date) => boolean;
+};
+export declare const validTimezones: () => string[];
+//# sourceMappingURL=dates.d.ts.map

package/dist/util/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/util/dates.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,OAAO;IACpB,GAAG,EAAE,MAAM,IAAI,CAAC;IAChB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAChE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACjF,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACnC,UAAU,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACjC,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,OAAO,CAAC;IAC/C,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,OAAO,CAAC;CACjD;AAED,eAAO,MAAM,MAAM,GAAI,YAAY;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE;;iBAM/B,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS;kBAexC,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,UAAU,MAAM;oBAWvD,IAAI,QAAQ,MAAM;sBAIhB,IAAI,UAAU,MAAM;qBAIrB,IAAI,SAAS,MAAM;mBAIrB,IAAI,UAAU,MAAM;oBAInB,IAAI,QAAQ,MAAM;sBAIhB,IAAI,UAAU,MAAM;qBAIrB,IAAI,SAAS,MAAM;yBAIf,IAAI;uBAIN,IAAI;wBAIH,IAAI;sBAIN,IAAI;qBAIL,IAAI,SAAS,IAAI;oBAIlB,IAAI,SAAS,IAAI;CAK3C,CAAA;AAED,eAAO,MAAM,cAAc,gBAE1B,CAAA"}

package/dist/util/general.d.ts

@@ -0,0 +1,3 @@
+export declare function deepMerge(target: any, source: any): any;
+export declare const stringifyJSON: (obj: any) => string;
+//# sourceMappingURL=general.d.ts.map

package/dist/util/general.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"general.d.ts","sourceRoot":"","sources":["../../src/util/general.ts"],"names":[],"mappings":"AACA,wBAAgB,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,CAkBvD;AAGD,eAAO,MAAM,aAAa,GAAa,KAAK,GAAG,KAAG,MA+CjD,CAAC"}

package/dist/util/media.d.ts

@@ -0,0 +1,9 @@
+import { Logger } from 'winston';
+export interface Media {
+    getAudioCreationTime: (filePath: string) => Promise<Date | null>;
+    getFileSize: (filePath: string) => Promise<number>;
+    splitAudioFile: (filePath: string, outputDir: string, maxSizeBytes: number) => Promise<string[]>;
+    convertToSupportedFormat: (filePath: string, outputDir: string, forceConversion?: boolean) => Promise<string>;
+}
+export declare const create: (logger: Logger) => Media;
+//# sourceMappingURL=media.d.ts.map

package/dist/util/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/util/media.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAIjC,MAAM,WAAW,KAAK;IAClB,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACjE,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjG,wBAAwB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACjH;AAYD,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,KAAG,KAkKvC,CAAA"}

package/dist/util/metadata.d.ts

@@ -0,0 +1,138 @@
+import * as Routing from '@/routing';
+/**
+ * Transcript lifecycle status
+ * - initial: Whisper transcription complete
+ * - enhanced: Context-aware enhancement complete
+ * - reviewed: User has reviewed the transcript
+ * - in_progress: Has outstanding tasks to complete
+ * - closed: All work complete, no pending tasks
+ * - archived: Archived for long-term storage
+ */
+export type TranscriptStatus = 'initial' | 'enhanced' | 'reviewed' | 'in_progress' | 'closed' | 'archived';
+/**
+ * Record of a status transition with timestamp
+ */
+export interface StatusTransition {
+    from: TranscriptStatus;
+    to: TranscriptStatus;
+    at: string;
+}
+/**
+ * A follow-up task associated with a transcript
+ */
+export interface Task {
+    id: string;
+    description: string;
+    status: 'open' | 'done';
+    created: string;
+    changed?: string;
+    completed?: string;
+}
+export interface EntityReference {
+    id: string;
+    name: string;
+    type: 'person' | 'project' | 'term' | 'company';
+}
+export interface TranscriptMetadata {
+    title?: string;
+    project?: string;
+    projectId?: string;
+    routing?: RoutingMetadata;
+    tags?: string[];
+    date?: Date;
+    recordingTime?: string;
+    confidence?: number;
+    duration?: string;
+    status?: TranscriptStatus;
+    history?: StatusTransition[];
+    tasks?: Task[];
+    entities?: {
+        people?: EntityReference[];
+        projects?: EntityReference[];
+        terms?: EntityReference[];
+        companies?: EntityReference[];
+    };
+}
+export interface RoutingMetadata {
+    destination: string;
+    confidence: number;
+    signals: Routing.ClassificationSignal[];
+    reasoning: string;
+}
+/**
+ * Format metadata as Markdown heading section
+ */
+export declare const formatMetadataMarkdown: (metadata: TranscriptMetadata) => string;
+/**
+ * Format entity metadata as Markdown footer section
+ * This goes at the END of the transcript for machine readability
+ */
+export declare const formatEntityMetadataMarkdown: (metadata: TranscriptMetadata) => string;
+/**
+ * Parse entity metadata from a transcript
+ * Reads the Entity References section if present
+ */
+export declare const parseEntityMetadata: (content: string) => TranscriptMetadata["entities"] | undefined;
+/**
+ * Extract routing metadata from a RouteDecision
+ */
+export declare const createRoutingMetadata: (decision: Routing.RouteDecision) => RoutingMetadata;
+/**
+ * Format duration in seconds to readable format (e.g., "2m 30s")
+ */
+export declare const formatDuration: (seconds: number) => string;
+/**
+ * Format time as HH:MM AM/PM
+ */
+export declare const formatTime: (date: Date) => string;
+/**
+ * Extract topic from routing signals
+ */
+export declare const extractTopicFromSignals: (signals: Routing.ClassificationSignal[]) => string | undefined;
+/**
+ * Extract all tags from routing signals
+ * Tags are deduplicated to avoid duplicates from multiple signal sources
+ */
+export declare const extractTagsFromSignals: (signals: Routing.ClassificationSignal[]) => string[];
+/**
+ * Valid transcript statuses for validation
+ */
+export declare const VALID_STATUSES: TranscriptStatus[];
+/**
+ * Check if a string is a valid TranscriptStatus
+ */
+export declare const isValidStatus: (status: string) => status is TranscriptStatus;
+/**
+ * Generate a unique task ID
+ */
+export declare const generateTaskId: () => string;
+/**
+ * Create a new task
+ */
+export declare const createTask: (description: string) => Task;
+/**
+ * Update transcript status and record the transition in history
+ * Returns unchanged metadata if status is the same (no duplicate history)
+ */
+export declare const updateStatus: (metadata: TranscriptMetadata, newStatus: TranscriptStatus) => TranscriptMetadata;
+/**
+ * Apply default lifecycle fields to metadata
+ * Used during lazy migration of old-format transcripts
+ */
+export declare const applyLifecycleDefaults: (metadata: TranscriptMetadata) => TranscriptMetadata;
+/**
+ * Complete a task by ID
+ */
+export declare const completeTask: (metadata: TranscriptMetadata, taskId: string) => TranscriptMetadata;
+/**
+ * Delete a task by ID
+ */
+export declare const deleteTask: (metadata: TranscriptMetadata, taskId: string) => TranscriptMetadata;
+/**
+ * Add a task to metadata
+ */
+export declare const addTask: (metadata: TranscriptMetadata, description: string) => {
+    metadata: TranscriptMetadata;
+    task: Task;
+};
+//# sourceMappingURL=metadata.d.ts.map

package/dist/util/metadata.d.ts.map

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

package/dist/util/openai.d.ts

@@ -0,0 +1,22 @@
+import { ChatCompletionMessageParam } from 'openai/resources/chat/completions';
+export interface Transcription {
+    text: string;
+}
+export declare class OpenAIError extends Error {
+    constructor(message: string);
+}
+export declare function createCompletion(messages: ChatCompletionMessageParam[], options?: {
+    responseFormat?: any;
+    model?: string;
+    reasoningLevel?: 'none' | 'low' | 'medium' | 'high';
+    maxTokens?: number;
+    debug?: boolean;
+    debugFile?: string;
+    reason?: string;
+}): Promise<string | any>;
+export declare function transcribeAudio(filePath: string, options?: {
+    model?: string;
+    debug?: boolean;
+    debugFile?: string;
+}): Promise<Transcription>;
+//# sourceMappingURL=openai.d.ts.map

package/dist/util/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/util/openai.ts"],"names":[],"mappings":"AACA,OAAO,EAA0C,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAKvH,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,WAAY,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI9B;AAGD,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,0BAA0B,EAAE,EAAE,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,GAAG,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CA0E3R;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CA4CrJ"}

package/dist/util/sounds-like-database.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Sounds-Like Database
+ *
+ * Aggregates sounds_like mappings from multiple sources (projects, people, terms)
+ * and provides efficient lookup and collision detection for entity correction.
+ *
+ * Part of the simple-replace optimization (Phase 1).
+ */
+/**
+ * Represents a single sounds_like mapping entry
+ */
+export interface SoundsLikeMapping {
+    /** What Whisper typically hears (e.g., "protocol", "observation") */
+    soundsLike: string;
+    /** Correct text to replace with (e.g., "Protokoll", "Observasjon") */
+    correctText: string;
+    /** Type of entity (project, person, or term) */
+    entityType: 'project' | 'person' | 'term';
+    /** Unique identifier for the entity */
+    entityId: string;
+    /** Only apply replacement in these project contexts (null = apply everywhere) */
+    scopedToProjects?: string[] | null;
+    /** Collision risk level: none (Tier 1), low/medium (Tier 2), high (Tier 3) */
+    collisionRisk: 'none' | 'low' | 'medium' | 'high';
+    /** Tier classification (1 = always safe, 2 = project-scoped, 3 = ambiguous) */
+    tier: 1 | 2 | 3;
+    /** Minimum confidence required for Tier 2 replacements */
+    minConfidence?: number;
+}
+/**
+ * Collision information for a sounds_like value
+ */
+export interface Collision {
+    /** The sounds_like value that has collisions */
+    soundsLike: string;
+    /** All mappings that share this sounds_like value */
+    mappings: SoundsLikeMapping[];
+    /** Number of conflicting mappings */
+    count: number;
+}
+/**
+ * Database of sounds_like mappings with collision detection
+ */
+export interface SoundsLikeDatabase {
+    /** All loaded mappings */
+    mappings: SoundsLikeMapping[];
+    /** Tier 1 mappings (always safe to apply) */
+    tier1: SoundsLikeMapping[];
+    /** Tier 2 mappings (require project-scoping) */
+    tier2: Map<string, SoundsLikeMapping[]>;
+    /** Tier 3 mappings (too ambiguous, skip) */
+    tier3: SoundsLikeMapping[];
+    /** Detected collisions */
+    collisions: Map<string, Collision>;
+    /** Common terms that should not be replaced */
+    commonTerms: Set<string>;
+    /** Generic terms to always skip (Tier 3) */
+    genericTerms: Set<string>;
+}
+/**
+ * Configuration for the sounds-like database
+ */
+export interface DatabaseConfig {
+    /** Protokoll context directories to load from */
+    protokollContextPaths?: string[];
+    /** Confidence threshold for Tier 2 replacements */
+    tier2Confidence?: number;
+    /** Enable collision detection */
+    detectCollisions?: boolean;
+    /** Custom common terms list */
+    commonTerms?: string[];
+    /** Custom generic terms list */
+    genericTerms?: string[];
+}
+/**
+ * Instance interface for the sounds-like database
+ */
+export interface Instance {
+    /** Load all sounds_like mappings from sources */
+    load(): Promise<SoundsLikeDatabase>;
+    /** Get all Tier 1 (always safe) mappings */
+    getTier1Mappings(): SoundsLikeMapping[];
+    /** Get Tier 2 (project-scoped) mappings for a specific project */
+    getTier2MappingsForProject(projectId: string): SoundsLikeMapping[];
+    /** Check if a sounds_like value has collisions */
+    hasCollision(soundsLike: string): boolean;
+    /** Get collision info for a sounds_like value */
+    getCollision(soundsLike: string): Collision | undefined;
+    /** Get all collisions */
+    getAllCollisions(): Collision[];
+    /** Classify a mapping into a tier based on collision risk */
+    classifyTier(mapping: Partial<SoundsLikeMapping>): 1 | 2 | 3;
+}
+/**
+ * Create a sounds-like database instance
+ */
+export declare const create: (config?: DatabaseConfig) => Instance;
+//# sourceMappingURL=sounds-like-database.d.ts.map

package/dist/util/sounds-like-database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sounds-like-database.d.ts","sourceRoot":"","sources":["../../src/util/sounds-like-database.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IAEnB,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IAEpB,gDAAgD;IAChD,UAAU,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IAE1C,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IAEjB,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEnC,8EAA8E;IAC9E,aAAa,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IAElD,+EAA+E;IAC/E,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAEhB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IAEnB,qDAAqD;IACrD,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAE9B,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,0BAA0B;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAE9B,6CAA6C;IAC7C,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAE3B,gDAAgD;IAChD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAExC,4CAA4C;IAC5C,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAE3B,0BAA0B;IAC1B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEnC,+CAA+C;IAC/C,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEzB,4CAA4C;IAC5C,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,iDAAiD;IACjD,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjC,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,iDAAiD;IACjD,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAEpC,4CAA4C;IAC5C,gBAAgB,IAAI,iBAAiB,EAAE,CAAC;IAExC,kEAAkE;IAClE,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAAC;IAEnE,kDAAkD;IAClD,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;IAE1C,iDAAiD;IACjD,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAExD,yBAAyB;IACzB,gBAAgB,IAAI,SAAS,EAAE,CAAC;IAEhC,6DAA6D;IAC7D,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CAChE;AAaD;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,SAAS,cAAc,KAAG,QA6ThD,CAAC"}

package/dist/util/storage.d.ts

@@ -0,0 +1,35 @@
+import * as fs from 'node:fs';
+/**
+ * This module exists to isolate filesystem operations from the rest of the codebase.
+ * This makes testing easier by avoiding direct fs mocking in jest configuration.
+ *
+ * Additionally, abstracting storage operations allows for future flexibility -
+ * this export utility may need to work with storage systems other than the local filesystem
+ * (e.g. S3, Google Cloud Storage, etc).
+ */
+export interface Utility {
+    exists: (path: string) => Promise<boolean>;
+    isDirectory: (path: string) => Promise<boolean>;
+    isFile: (path: string) => Promise<boolean>;
+    isReadable: (path: string) => Promise<boolean>;
+    isWritable: (path: string) => Promise<boolean>;
+    isFileReadable: (path: string) => Promise<boolean>;
+    isDirectoryWritable: (path: string) => Promise<boolean>;
+    isDirectoryReadable: (path: string) => Promise<boolean>;
+    createDirectory: (path: string) => Promise<void>;
+    readFile: (path: string, encoding: string) => Promise<string>;
+    readStream: (path: string) => Promise<fs.ReadStream>;
+    writeFile: (path: string, data: string | Buffer, encoding: string) => Promise<void>;
+    forEachFileIn: (directory: string, callback: (path: string) => Promise<void>, options?: {
+        pattern: string;
+    }) => Promise<void>;
+    hashFile: (path: string, length: number) => Promise<string>;
+    listFiles: (directory: string) => Promise<string[]>;
+    deleteFile: (path: string) => Promise<void>;
+    deleteDirectory: (path: string) => Promise<void>;
+    getFileSize: (path: string) => Promise<number>;
+}
+export declare const create: (params: {
+    log?: (message: string, ...args: any[]) => void;
+}) => Utility;
+//# sourceMappingURL=storage.d.ts.map

package/dist/util/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/util/storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAI9B;;;;;;;GAOG;AAEH,MAAM,WAAW,OAAO;IACpB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9D,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;IACrD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpF,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9H,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,SAAS,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,MAAM,GAAI,QAAQ;IAAE,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;CAAE,KAAG,OA0IpF,CAAA"}

package/dist/util/text-replacer.d.ts

@@ -0,0 +1,56 @@
+import { SoundsLikeMapping } from './sounds-like-database';
+/**
+ * Replacement result for a single occurrence
+ */
+export interface ReplacementOccurrence {
+    /** Original text that was replaced */
+    original: string;
+    /** Replacement text */
+    replacement: string;
+    /** Position in the text where replacement occurred */
+    position: number;
+    /** The mapping that was used */
+    mapping: SoundsLikeMapping;
+}
+/**
+ * Result of applying replacements to text
+ */
+export interface ReplacementResult {
+    /** The text after replacements */
+    text: string;
+    /** Number of replacements made */
+    count: number;
+    /** Detailed information about each replacement */
+    occurrences: ReplacementOccurrence[];
+    /** Mappings that were applied */
+    appliedMappings: SoundsLikeMapping[];
+}
+/**
+ * Configuration for text replacer
+ */
+export interface TextReplacerConfig {
+    /** Preserve case of original text when replacing (default: true) */
+    preserveCase?: boolean;
+    /** Use word boundaries for matching (default: true) */
+    useWordBoundaries?: boolean;
+    /** Case-insensitive matching (default: true) */
+    caseInsensitive?: boolean;
+}
+/**
+ * Instance interface for text replacer
+ */
+export interface Instance {
+    /**
+     * Apply a set of replacements to text
+     */
+    applyReplacements(text: string, mappings: SoundsLikeMapping[]): ReplacementResult;
+    /**
+     * Apply a single replacement to text
+     */
+    applySingleReplacement(text: string, mapping: SoundsLikeMapping): ReplacementResult;
+}
+/**
+ * Create a text replacer instance
+ */
+export declare const create: (config?: TextReplacerConfig) => Instance;
+//# sourceMappingURL=text-replacer.d.ts.map

package/dist/util/text-replacer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-replacer.d.ts","sourceRoot":"","sources":["../../src/util/text-replacer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IAEjB,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IAEpB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC;IAEjB,gCAAgC;IAChC,OAAO,EAAE,iBAAiB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IAEb,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IAEd,kDAAkD;IAClD,WAAW,EAAE,qBAAqB,EAAE,CAAC;IAErC,iCAAiC;IACjC,eAAe,EAAE,iBAAiB,EAAE,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,uDAAuD;IACvD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,gDAAgD;IAChD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,CAAC;IAElF;;OAEG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAAC;CACvF;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,SAAS,kBAAkB,KAAG,QAsKpD,CAAC"}

package/dist/utils/entityFinder.d.ts

@@ -0,0 +1,29 @@
+import { Person, Project, Company, Term, IgnoredTerm } from '@redaksjon/context';
+/**
+ * Resilient Entity Finder
+ *
+ * Provides case-insensitive and fuzzy matching for all entity types.
+ * Handles typos, capitalization differences, and matches by both ID and name.
+ */
+import * as Context from '@redaksjon/context';
+/**
+ * Find a project using resilient matching
+ */
+export declare function findProjectResilient(context: Context.ContextInstance, query: string): Project;
+/**
+ * Find a person using resilient matching
+ */
+export declare function findPersonResilient(context: Context.ContextInstance, query: string): Person;
+/**
+ * Find a company using resilient matching
+ */
+export declare function findCompanyResilient(context: Context.ContextInstance, query: string): Company;
+/**
+ * Find a term using resilient matching
+ */
+export declare function findTermResilient(context: Context.ContextInstance, query: string): Term;
+/**
+ * Find an ignored term using resilient matching
+ */
+export declare function findIgnoredResilient(context: Context.ContextInstance, query: string): IgnoredTerm;
+//# sourceMappingURL=entityFinder.d.ts.map

package/dist/utils/entityFinder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entityFinder.d.ts","sourceRoot":"","sources":["../../src/utils/entityFinder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAU,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA4H9F;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,OAAO,CAAC,eAAe,EAChC,KAAK,EAAE,MAAM,GACd,OAAO,CAGT;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,OAAO,CAAC,eAAe,EAChC,KAAK,EAAE,MAAM,GACd,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,OAAO,CAAC,eAAe,EAChC,KAAK,EAAE,MAAM,GACd,OAAO,CAGT;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,OAAO,CAAC,eAAe,EAChC,KAAK,EAAE,MAAM,GACd,IAAI,CAGN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,OAAO,EAAE,OAAO,CAAC,eAAe,EAChC,KAAK,EAAE,MAAM,GACd,WAAW,CAGb"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@redaksjon/protokoll-engine",
+  "version": "0.1.1-dev.0",
+  "description": "Processing engine for Protokoll - transcription pipeline, agentic execution, routing, and LLM integration",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/redaksjon/protokoll.git",
+    "directory": "protokoll-engine"
+  },
+  "keywords": [
+    "transcription",
+    "pipeline",
+    "agentic",
+    "llm",
+    "routing"
+  ],
+  "author": "Tim O'Brien <tobrien@discursive.com>",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "scripts": {
+    "build": "npm run lint && tsc --noEmit && vite build",
+    "dev": "vite",
+    "watch": "vite build --watch",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "clean": "rm -rf dist",
+    "precommit": "npm run lint && npm run build && npm run test:coverage",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.71.2",
+    "@google/generative-ai": "^0.24.1",
+    "@kjerneverk/riotprompt": "^1.0.6",
+    "@redaksjon/context": "file:../redaksjon-context",
+    "@redaksjon/protokoll-format": "file:../protokoll-format",
+    "@utilarium/cardigantime": "^0.0.26",
+    "@utilarium/dreadcabinet": "^0.0.16",
+    "dayjs": "^1.11.13",
+    "fluent-ffmpeg": "^2.1.3",
+    "glob": "^13.0.3",
+    "gray-matter": "^4.0.3",
+    "js-yaml": "^4.1.0",
+    "luxon": "^3.5.0",
+    "moment-timezone": "^0.5.46",
+    "openai": "^4.77.3",
+    "winston": "^3.17.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.18.0",
+    "@types/fluent-ffmpeg": "^2.1.27",
+    "@types/js-yaml": "^4.0.9",
+    "@types/luxon": "^3.4.2",
+    "@types/node": "^22.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.20.0",
+    "@typescript-eslint/parser": "^8.20.0",
+    "@vitest/coverage-v8": "^2.1.8",
+    "ajv": "^8.18.0",
+    "eslint": "^9.18.0",
+    "eslint-plugin-import": "^2.31.0",
+    "globals": "^15.14.0",
+    "typescript": "^5.5.0",
+    "vite": "^7.3.1",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^2.1.8"
+  }
+}