minutes-sdk 0.16.1 → 0.16.2

package/dist/index.d.ts

@@ -1 +1 @@
-export { type ActionItem, type Decision, type Intent, type Frontmatter, type MeetingFile, type SpeakerAttribution, type SpeakerConfirmation, defaultDir, splitFrontmatter, parseFrontmatter, listMeetings, searchMeetings, getMeeting, getMeetingWithOverlays, applySpeakerOverlays, humanizeTranscript, findOpenActions, findDecisions, getPersonProfile, listVoiceMemos, } from "./reader.js";
+export { type ActionItem, type Decision, type Intent, type Frontmatter, type MeetingFile, type SpeakerAttribution, type SpeakerConfirmation, type AttributionSource, type CaptureSource, type CaptureWarning, type DiagnosticConfidence, type DiarizationPath, type FailureKind, type RecordingHealth, defaultDir, splitFrontmatter, parseFrontmatter, parseAttributionSource, listMeetings, searchMeetings, getMeeting, getMeetingWithOverlays, applySpeakerOverlays, humanizeTranscript, findOpenActions, findDecisions, getPersonProfile, listVoiceMemos, } from "./reader.js";

package/dist/index.js

@@ -12,6 +12,6 @@ export {
 // Config
 defaultDir, 
 // Parsing
-splitFrontmatter, parseFrontmatter, 
+splitFrontmatter, parseFrontmatter, parseAttributionSource, 
 // Query API
 listMeetings, searchMeetings, getMeeting, getMeetingWithOverlays, applySpeakerOverlays, humanizeTranscript, findOpenActions, findDecisions, getPersonProfile, listVoiceMemos, } from "./reader.js";

package/dist/reader.d.ts

@@ -19,7 +19,29 @@ export interface SpeakerAttribution {
     speaker_label: string;
     name: string;
     confidence: "high" | "medium" | "low";
-    source: "deterministic" | "llm" | "enrollment" | "manual";
+    source: AttributionSource;
+}
+export type AttributionSource = "deterministic" | "llm" | "enrollment" | "manual" | "ml-bleed-degraded" | "stem-recovery";
+export type DiagnosticConfidence = "high" | "inferred";
+export type CaptureSource = "voice" | "system" | "both" | "backend";
+export type DiarizationPath = "stem-energy" | "ml" | "ml-bleed-degraded" | "none";
+export type FailureKind = "silent" | "sparse" | "missing" | "backend-unavailable" | "stream-error" | "source-starved" | "unsupported-format" | "misconfigured-route" | "permission-denied" | "route-unavailable" | {
+    other: {
+        code: string;
+    };
+};
+export interface CaptureWarning {
+    kind: FailureKind;
+    source: CaptureSource;
+    message: string;
+    diagnostic_confidence: DiagnosticConfidence;
+}
+export interface RecordingHealth {
+    voice_stem_active_ratio?: number;
+    system_stem_active_ratio?: number;
+    system_dominant_ratio?: number;
+    capture_warnings: CaptureWarning[];
+    diarization_path?: DiarizationPath;
 }
 /**
  * A user-confirmed speaker correction stored in the sidecar overlay store
@@ -54,12 +76,14 @@ export interface Frontmatter {
     decisions: Decision[];
     intents: Intent[];
     speaker_map?: SpeakerAttribution[];
+    recording_health?: RecordingHealth;
 }
 export interface MeetingFile {
     frontmatter: Frontmatter;
     body: string;
     path: string;
 }
+export declare function parseAttributionSource(raw: string): AttributionSource;
 /**
  * Split markdown content into YAML frontmatter and body.
  * Returns null frontmatter string if no valid frontmatter found.

package/dist/reader.js

@@ -34,6 +34,79 @@ function parseRawAttendees(raw) {
     }
     return attendees;
 }
+export function parseAttributionSource(raw) {
+    if (raw === "deterministic" ||
+        raw === "llm" ||
+        raw === "enrollment" ||
+        raw === "manual" ||
+        raw === "ml-bleed-degraded" ||
+        raw === "stem-recovery") {
+        return raw;
+    }
+    return "llm";
+}
+function parseDiagnosticConfidence(raw) {
+    if (raw === "high" || raw === "inferred")
+        return raw;
+    throw new Error(`unknown diagnostic confidence: ${String(raw)}`);
+}
+function parseCaptureSource(raw) {
+    if (raw === "voice" || raw === "system" || raw === "both" || raw === "backend") {
+        return raw;
+    }
+    throw new Error(`unknown capture source: ${String(raw)}`);
+}
+function parseDiarizationPath(raw) {
+    if (raw === "stem-energy" || raw === "ml" || raw === "ml-bleed-degraded" || raw === "none") {
+        return raw;
+    }
+    throw new Error(`unknown diarization path: ${String(raw)}`);
+}
+function parseFailureKind(raw) {
+    if (raw === "silent" ||
+        raw === "sparse" ||
+        raw === "missing" ||
+        raw === "backend-unavailable" ||
+        raw === "stream-error" ||
+        raw === "source-starved" ||
+        raw === "unsupported-format" ||
+        raw === "misconfigured-route" ||
+        raw === "permission-denied" ||
+        raw === "route-unavailable") {
+        return raw;
+    }
+    if (raw &&
+        typeof raw === "object" &&
+        "other" in raw &&
+        raw.other &&
+        typeof raw.other === "object") {
+        return { other: { code: String(raw.other.code || "") } };
+    }
+    throw new Error(`unknown capture failure kind: ${String(raw)}`);
+}
+function optionalNumber(raw) {
+    return typeof raw === "number" && Number.isFinite(raw) ? raw : undefined;
+}
+function parseRecordingHealth(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    return {
+        voice_stem_active_ratio: optionalNumber(raw.voice_stem_active_ratio),
+        system_stem_active_ratio: optionalNumber(raw.system_stem_active_ratio),
+        system_dominant_ratio: optionalNumber(raw.system_dominant_ratio),
+        capture_warnings: Array.isArray(raw.capture_warnings)
+            ? raw.capture_warnings.map((warning) => ({
+                kind: parseFailureKind(warning?.kind),
+                source: parseCaptureSource(warning?.source),
+                message: String(warning?.message || ""),
+                diagnostic_confidence: parseDiagnosticConfidence(warning?.diagnostic_confidence),
+            }))
+            : [],
+        diarization_path: raw.diarization_path
+            ? parseDiarizationPath(raw.diarization_path)
+            : undefined,
+    };
+}
 // ── Parsing ──────────────────────────────────────────────────
 /**
  * Split markdown content into YAML frontmatter and body.
@@ -113,14 +186,10 @@ export function parseFrontmatter(content, filePath) {
                         s.confidence === "low"
                         ? s.confidence
                         : "medium"),
-                    source: (s.source === "deterministic" ||
-                        s.source === "llm" ||
-                        s.source === "enrollment" ||
-                        s.source === "manual"
-                        ? s.source
-                        : "llm"),
+                    source: parseAttributionSource(String(s.source || "")),
                 }))
                 : undefined,
+            recording_health: parseRecordingHealth(parsed.recording_health),
         };
         return { frontmatter: fm, body, path: filePath };
     }
@@ -376,12 +445,7 @@ export async function getMeetingWithOverlays(filePath, options = {}) {
                         attr.confidence === "low"
                         ? attr.confidence
                         : "medium"),
-                    source: (attr.source === "deterministic" ||
-                        attr.source === "llm" ||
-                        attr.source === "enrollment" ||
-                        attr.source === "manual"
-                        ? attr.source
-                        : "llm"),
+                    source: parseAttributionSource(String(attr.source || "")),
                 })),
             },
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minutes-sdk",
-  "version": "0.16.1",
+  "version": "0.16.2",
   "description": "Conversation memory SDK — query meeting transcripts, decisions, and action items from any AI agent or application",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",