@taskless-app/shared 0.1.12 → 0.1.13

package/dist/index.d.ts

@@ -17,3 +17,4 @@ export * from "./userHue.js";
 export * from "./releaseSources.js";
 export * from "./designTokens.js";
 export * from "./callQuality.js";
+export * from "./transcriptCoverage.js";

package/dist/index.js

@@ -17,4 +17,5 @@ export * from "./userHue.js";
 export * from "./releaseSources.js";
 export * from "./designTokens.js";
 export * from "./callQuality.js";
+export * from "./transcriptCoverage.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

package/dist/transcriptCoverage.d.ts

@@ -0,0 +1,147 @@
+import { z } from "zod";
+/**
+ * Почему у участника ноль реплик. Классификацию делает агент — только он
+ * знает, была ли подписка и шли ли PCM-кадры; здесь мы её читаем.
+ *
+ * `not_subscribed` — публиковал аудио, а рекордера на дорожке не было ни разу;
+ * `no_audio`       — подписка была, но ни одного кадра не доехало;
+ * `suppressed`     — сегменты распознавались, но их выбрасывал анти-дубль
+ *                    «участник вышел» (собственно баг PRJ3-101).
+ *
+ * Молчавших и слушателей здесь НЕТ: их ноль объяснён, и сигналом он не
+ * является — иначе предупреждение висело бы на каждом созвоне.
+ */
+export declare const TranscriptCoverageGapReason: z.ZodEnum<["not_subscribed", "no_audio", "suppressed"]>;
+export type TranscriptCoverageGapReason = z.infer<typeof TranscriptCoverageGapReason>;
+/**
+ * Отчёт агента за одну сессию.
+ *
+ * Все поля со значением по умолчанию: отчёт пишет отдельный рантайм и его
+ * версии живут вразнобой (агент выкатывается образом, api — своим). Отсутствие
+ * поля должно давать «нет данных», а не отбрасывать весь отчёт целиком.
+ */
+export declare const TranscriptCoverage: z.ZodObject<{
+    /** Версия формата. Читателей будет больше одного — пусть будет с самого начала. */
+    v: z.ZodDefault<z.ZodNumber>;
+    /** Сколько людей агент видел в комнате, включая заглянувших на минуту. */
+    participants: z.ZodDefault<z.ZodNumber>;
+    /** Из них публиковали аудио — столько дорожек ДОЛЖНО было слушаться. */
+    audioTracks: z.ZodDefault<z.ZodNumber>;
+    /** А столько реально слушалось: подписка есть И звук доехал. */
+    recognized: z.ZodDefault<z.ZodNumber>;
+    /** Сколько человек попали в расшифровку хотя бы одной репликой. */
+    spoke: z.ZodDefault<z.ZodNumber>;
+    /** Звук шёл, распознавание работало, человек молчал — это не провал. */
+    silent: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        identity: z.ZodString;
+        name: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        identity: string;
+        name: string;
+    }, {
+        identity: string;
+        name?: string | undefined;
+    }>, "many">>;
+    /** Аудио не публиковал вовсе — слушатель, ноль реплик ожидаем. */
+    listeners: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        identity: z.ZodString;
+        name: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        identity: string;
+        name: string;
+    }, {
+        identity: string;
+        name?: string | undefined;
+    }>, "many">>;
+    /** Те, у кого речь могла потеряться. Список урезан, счётчик — нет. */
+    gaps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        identity: z.ZodString;
+        name: z.ZodDefault<z.ZodString>;
+    } & {
+        reason: z.ZodEnum<["not_subscribed", "no_audio", "suppressed"]>;
+    }, "strip", z.ZodTypeAny, {
+        identity: string;
+        name: string;
+        reason: "no_audio" | "not_subscribed" | "suppressed";
+    }, {
+        identity: string;
+        name?: string | undefined;
+        reason: "no_audio" | "not_subscribed" | "suppressed";
+    }>, "many">>;
+    gapCount: z.ZodDefault<z.ZodNumber>;
+    /** Сколько дорожек пришлось чинить реконсиляцией подписок. */
+    repairedSubscriptions: z.ZodDefault<z.ZodNumber>;
+    /** Сколько распознанных сегментов выброшено анти-дублем «вышедшего». */
+    suppressedSegments: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    v: number;
+    participants: number;
+    audioTracks: number;
+    recognized: number;
+    spoke: number;
+    silent: {
+        identity: string;
+        name: string;
+    }[];
+    listeners: {
+        identity: string;
+        name: string;
+    }[];
+    gaps: {
+        identity: string;
+        name: string;
+        reason: "no_audio" | "not_subscribed" | "suppressed";
+    }[];
+    gapCount: number;
+    repairedSubscriptions: number;
+    suppressedSegments: number;
+}, {
+    v?: number | undefined;
+    participants?: number | undefined;
+    audioTracks?: number | undefined;
+    recognized?: number | undefined;
+    spoke?: number | undefined;
+    silent?: {
+        identity: string;
+        name?: string | undefined;
+    }[] | undefined;
+    listeners?: {
+        identity: string;
+        name?: string | undefined;
+    }[] | undefined;
+    gaps?: {
+        identity: string;
+        name?: string | undefined;
+        reason: "no_audio" | "not_subscribed" | "suppressed";
+    }[] | undefined;
+    gapCount?: number | undefined;
+    repairedSubscriptions?: number | undefined;
+    suppressedSegments?: number | undefined;
+}>;
+export type TranscriptCoverage = z.infer<typeof TranscriptCoverage>;
+/**
+ * Разобрать значение JSON-колонки. Мусор и `null` дают `null` — «данных нет»,
+ * а это не то же самое, что «покрытие полное»: у сессий до PRJ3-101 отчёта нет
+ * вовсе, и рисовать по ним зелёный вердикт было бы враньём.
+ */
+export declare function parseTranscriptCoverage(raw: unknown): TranscriptCoverage | null;
+/**
+ * Есть ли расхождение, о котором стоит сказать человеку.
+ *
+ * Считаем по `gapCount`, а не по разнице `participants − recognized`: разница
+ * штатно ненулевая на любом созвоне со слушателями, и предупреждение по ней
+ * висело бы всегда, то есть не значило бы ничего. Провал — это только
+ * необъяснённый ноль.
+ */
+export declare function hasTranscriptCoverageGap(coverage: TranscriptCoverage | null): boolean;
+/**
+ * Строка «сколько дорожек из скольких участников» — то, что человек хотел
+ * увидеть, не разбирая базу руками.
+ */
+export declare function transcriptCoverageSummary(coverage: TranscriptCoverage): string;
+/** «1 дорожку», «2 дорожки», «5 дорожек» — винительный, как в «распознавали N». */
+export declare function pluralTracks(n: number): string;
+/** «из 1 участника», «из 13 участников» — родительный, как в «из N». */
+export declare function pluralPeople(n: number): string;
+/** Человеческая причина провала — одними словами в UI и в логах. */
+export declare const TRANSCRIPT_COVERAGE_GAP_LABEL: Record<TranscriptCoverageGapReason, string>;

package/dist/transcriptCoverage.js

@@ -0,0 +1,122 @@
+// PRJ3-101 — покрытие расшифровки: контракт отчёта агента и его чтение.
+//
+// Дейли 10.08: пятеро участников из тринадцати с нулём реплик, трое из них
+// сидели в звонке 30–46 минут. Расшифровка при этом работала — 510 реплик, ни
+// одного провала. Проблема была не в распознавании, а в том, что до него
+// доезжали не все дорожки, и заметить это можно было единственным способом:
+// прочитать итог и удивиться, что человека там нет.
+//
+// Агент теперь считает покрытие по ходу звонка и кладёт отчёт в
+// `CallSession.transcriptCoverage` (см. agent/src/taskless_agent/coverage.py).
+// Здесь — схема этого отчёта и функция, отвечающая на единственный вопрос,
+// ради которого он есть: расходится ли число дорожек с числом участников.
+//
+// Разбор именно схемой, а не «привести as": колонка `Json`, писал её другой
+// рантайм (python), и мусор оттуда не должен ронять итог звонка.
+import { z } from "zod";
+/**
+ * Почему у участника ноль реплик. Классификацию делает агент — только он
+ * знает, была ли подписка и шли ли PCM-кадры; здесь мы её читаем.
+ *
+ * `not_subscribed` — публиковал аудио, а рекордера на дорожке не было ни разу;
+ * `no_audio`       — подписка была, но ни одного кадра не доехало;
+ * `suppressed`     — сегменты распознавались, но их выбрасывал анти-дубль
+ *                    «участник вышел» (собственно баг PRJ3-101).
+ *
+ * Молчавших и слушателей здесь НЕТ: их ноль объяснён, и сигналом он не
+ * является — иначе предупреждение висело бы на каждом созвоне.
+ */
+export const TranscriptCoverageGapReason = z.enum([
+    "not_subscribed",
+    "no_audio",
+    "suppressed",
+]);
+const Person = z.object({
+    identity: z.string(),
+    name: z.string().default(""),
+});
+/**
+ * Отчёт агента за одну сессию.
+ *
+ * Все поля со значением по умолчанию: отчёт пишет отдельный рантайм и его
+ * версии живут вразнобой (агент выкатывается образом, api — своим). Отсутствие
+ * поля должно давать «нет данных», а не отбрасывать весь отчёт целиком.
+ */
+export const TranscriptCoverage = z.object({
+    /** Версия формата. Читателей будет больше одного — пусть будет с самого начала. */
+    v: z.number().int().default(1),
+    /** Сколько людей агент видел в комнате, включая заглянувших на минуту. */
+    participants: z.number().int().min(0).default(0),
+    /** Из них публиковали аудио — столько дорожек ДОЛЖНО было слушаться. */
+    audioTracks: z.number().int().min(0).default(0),
+    /** А столько реально слушалось: подписка есть И звук доехал. */
+    recognized: z.number().int().min(0).default(0),
+    /** Сколько человек попали в расшифровку хотя бы одной репликой. */
+    spoke: z.number().int().min(0).default(0),
+    /** Звук шёл, распознавание работало, человек молчал — это не провал. */
+    silent: z.array(Person).default([]),
+    /** Аудио не публиковал вовсе — слушатель, ноль реплик ожидаем. */
+    listeners: z.array(Person).default([]),
+    /** Те, у кого речь могла потеряться. Список урезан, счётчик — нет. */
+    gaps: z.array(Person.extend({ reason: TranscriptCoverageGapReason })).default([]),
+    gapCount: z.number().int().min(0).default(0),
+    /** Сколько дорожек пришлось чинить реконсиляцией подписок. */
+    repairedSubscriptions: z.number().int().min(0).default(0),
+    /** Сколько распознанных сегментов выброшено анти-дублем «вышедшего». */
+    suppressedSegments: z.number().int().min(0).default(0),
+});
+/**
+ * Разобрать значение JSON-колонки. Мусор и `null` дают `null` — «данных нет»,
+ * а это не то же самое, что «покрытие полное»: у сессий до PRJ3-101 отчёта нет
+ * вовсе, и рисовать по ним зелёный вердикт было бы враньём.
+ */
+export function parseTranscriptCoverage(raw) {
+    if (raw === null || raw === undefined)
+        return null;
+    const parsed = TranscriptCoverage.safeParse(raw);
+    return parsed.success ? parsed.data : null;
+}
+/**
+ * Есть ли расхождение, о котором стоит сказать человеку.
+ *
+ * Считаем по `gapCount`, а не по разнице `participants − recognized`: разница
+ * штатно ненулевая на любом созвоне со слушателями, и предупреждение по ней
+ * висело бы всегда, то есть не значило бы ничего. Провал — это только
+ * необъяснённый ноль.
+ */
+export function hasTranscriptCoverageGap(coverage) {
+    return !!coverage && coverage.gapCount > 0;
+}
+/**
+ * Строка «сколько дорожек из скольких участников» — то, что человек хотел
+ * увидеть, не разбирая базу руками.
+ */
+export function transcriptCoverageSummary(coverage) {
+    return `Распознавали ${coverage.recognized} ${pluralTracks(coverage.recognized)} из ${coverage.participants} ${pluralPeople(coverage.participants)}`;
+}
+function plural(n, one, few, many) {
+    const mod100 = n % 100;
+    if (mod100 >= 11 && mod100 <= 14)
+        return many;
+    const mod10 = n % 10;
+    if (mod10 === 1)
+        return one;
+    if (mod10 >= 2 && mod10 <= 4)
+        return few;
+    return many;
+}
+/** «1 дорожку», «2 дорожки», «5 дорожек» — винительный, как в «распознавали N». */
+export function pluralTracks(n) {
+    return plural(n, "дорожку", "дорожки", "дорожек");
+}
+/** «из 1 участника», «из 13 участников» — родительный, как в «из N». */
+export function pluralPeople(n) {
+    return plural(n, "участника", "участников", "участников");
+}
+/** Человеческая причина провала — одними словами в UI и в логах. */
+export const TRANSCRIPT_COVERAGE_GAP_LABEL = {
+    not_subscribed: "дорожку не слушали",
+    no_audio: "звук не доехал",
+    suppressed: "речь распозналась, но не записалась",
+};
+//# sourceMappingURL=transcriptCoverage.js.map

package/dist/transcriptCoverage.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taskless-app/shared",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "type": "module",
   "description": "Shared types, Zod schemas and design tokens for the Taskless API contract — consumed by @taskless/api, @taskless/web and the Taskless mobile app.",
   "license": "MIT",