ephia-protocol

Contrat universel EphiaAudioEvent - le cœur du systemme。

Rôle et consommateurs autoris郁闷

ephia-protocol 美国东部时间勒 签约有线互联网 d'Ephia：类型、模式、fixture等 更新日志protocolaire。看到 docs/wire-contract.md 等 docs/protocol-versioning.md 倒勒 实际不变量（协议v3）： segment.canonical， commandSeq， ephiaWireServerEventSchema）.

我将测试消费指导标准。

• @ephia/sdk （packages/ephia-sdk) -汉城运行时的客户端自动访问的转换器的电线；
• Les测试与包的收缩有关；
• le后端Python通过les fixture JSON de src/fixtures/。

我不会通过一个API客户端。 应用程序不需要通过导入器的模式连接 （ephiaWireServerEventSchema（等）倒解析器，你的贴花拉西拉西方向- elles consomment大 @ephia/sdk例如，qui / qui / qui / qui / qui / qui / qui / qui / qui / qui / qui

注：le restest de ce README(章节“信封公社”，“Événements par catsamgorie”， 为例 transcript.segment.committed(3)联合国第3号通讯议定书(联合国第3号通讯议定书 事实上，我们已经通过了一项调查，确定了我们的目标是通过一项调查，确定我们的目标是通过一项调查。

普林西比fondamental

Protocol > Framework

Ce封装测试 独立． 我将创建新的SDK，新的React，新的LiveKit，新的后端。

非洲大陆：

• types TypeScript des samvacimement public
• schsammas zold浇注验证运行时
• 消息客户端
• 会议期间的薪金
• 编码误差
• 版本du协议(3 线/ "3.0" 其他功能)

À quoi sert ce档案？

packages/protocol 对产品音频进行合同协议。Il避开缆车后端等用des SDK evoluent定义d 'evenements发散。

Concretement:

• 我们的后端doit sametree des payloads JSON符合我们的sametree包
• 让SDK导入所有类型、类型、reducer、处理程序和回调函数
• 让SDK生效的chaque samvacimement reactu avec ephiaAudioEventSchema.safeParse()
• 以下测试分别用于测试vsamrifier与兼容后端/SDK <s:1>组件的兼容性，并用于测试vsamriri<e:1>的源

让后端Python导入TypeScript代码。合同的约束条件是：所有的标准和所有的标准、所有的标准和所有的标准、所有的标准和所有的标准、所有的标准、所有的标准和所有的标准。

包膜公社（指其他的薪金）

{
  "protocolVersion": 3,
  "eventId": "550e8400-e29b-41d4-a716-446655440000",
  "sessionId": "sess_abc",
  "type": "transcript.segment.committed",
  "seq": 42,
  "timestampMs": 1716200000000,
  "payload": { "..." },
  "meta": { "provider": "voxtral-small", "latencyMs": 340 }
}

• seq ：严格的牛角面包
• eventId ： UUID唯一
• timestampMs ：时间戳服务器
• sessionId ：对某些事件负有义务
• meta ： optionnel -诊断，延迟，模式

r<e:1>协议

• 没有问题 preview/stable 它是联合国的一部分 committed
• committed 法语版法语版法语版法语版
• reviewing 信号一审查SMART无更改文本
• corrected 替换精确的le段 committed 代理行
• review.rejected 终止一次审查，不更改文本
• 命令为 seq

r<s:1> d' atomicite_des聚变

transcript.segment.committed Est l' s samvsamement atomique d'application documentation。

Lorsqu'un段吸收，d'autres段，载荷 mergedWith 大陆的IDs吸收了大量的化学物质。让客户做贴花，并提交最后的et la抑制吸收的数据 一个seule事务可视化原子 - jamais en deux薪金，薪金和薪金。

segment.absorbed 测试UN的生命周期/调试。我将测试一下。 然后 transcript.segment.committed 代理行。我要做的是，在我们承诺承诺之前，我们要做的是，在我们承诺承诺之前，我们要做得更好。

Événements par catsamgoorie

会话

音频/ VAD

管段（双）

转录-温度升高

转录-生命周期片段

文档

通量法向d'un段

segment.opened
  → transcript.preview         (texte interim, 1..N fois)
  → transcript.preview.stable  (texte stable, 0..N fois)
  → segment.audio.closed       (audio terminé, traitement en cours)
  → transcript.segment.committed  ← appliquer atomiquement
  → [transcript.segment.reviewing
     → transcript.segment.corrected | transcript.segment.review.rejected]

负载示例 committed

{
  "protocolVersion": 3,
  "eventId": "550e8400-e29b-41d4-a716-446655440000",
  "sessionId": "sess_abc",
  "type": "transcript.segment.committed",
  "seq": 42,
  "timestampMs": 1716200000000,
  "payload": {
    "segmentId": "seg_12",
    "segmentSeq": 12,
    "text": "Le foie est de taille normale.",
    "source": "voxtral-small",
    "tags": [{ "tag": "anatomy", "word": "foie" }]
  },
  "meta": {
    "provider": "voxtral-small",
    "latencyMs": 820,
    "audioDurationMs": 2300
  }
}

消息客户机→后端

用法

import {
  ephiaAudioEventSchema,
  type EphiaAudioEvent,
  type TranscriptSegmentCommittedEvent,
  PROTOCOL_VERSION,  // 4
} from "ephia-protocol";

// Validation runtime
const parsed = ephiaAudioEventSchema.safeParse(raw);
if (!parsed.success) {
  console.warn("Invalid event:", parsed.error.issues);
  return;
}

// Discrimination par type
const event: EphiaAudioEvent = parsed.data;
if (event.type === "transcript.segment.committed") {
  const { segmentId, text, tags, mergedWith } = event.payload;
  applyToEditor(segmentId, text, { absorbed: mergedWith ?? [] });
}