polyvoice 0.6.1

Speaker diarization library for Rust — online and offline, ONNX-powered, ecosystem-agnostic
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

---
schema_version: 1
kind: module_contract
module: src/ffi
level: subsystem
layer: bindings
purpose: >
  Owns C FFI bindings for polyvoice (ABI v2). Exposes pipeline, model registry,
  and VAD configuration to C callers. Does NOT own the Rust pipeline internals.
status: stable
owners:
  - polyvoice-core
workcell:
  type: leaf
  parent: ""
  children: []
  owns_paths:
    - src/ffi/
    - include/polyvoice.h
  context_budget:
    max_files: 12
    max_source_lines: 1500
    max_contract_lines: 180
    max_readme_lines: 120
    max_todo_lines: 80
authority:
  write_policy: single_active_write_lease
  orchestrator: polyvoice-core
  read_agents: many_allowed
  migration_lease_required:
    - cross-workcell write
    - public surface migration
surface:
  - name: polyvoice_pipeline_create
    kind: function
    visibility: public
    contract: >
      C-visible constructor for Pipeline wrapper. Caller owns returned handle.
    proof:
      kind: integration-test
      target: tests/ffi_smoke_test.rs
      command: cargo test --test ffi_smoke_test --features ffi
  - name: polyvoice_pipeline_run
    kind: function
    visibility: public
    contract: >
      C-visible run function. Accepts raw audio buffer and sample rate.
    proof:
      kind: integration-test
      target: tests/ffi_smoke_test.rs
      command: cargo test --test ffi_smoke_test --features ffi
  - name: polyvoice_pipeline_free
    kind: function
    visibility: public
    contract: >
      C-visible destructor. Must be called for every created pipeline.
    proof:
      kind: integration-test
      target: tests/ffi_smoke_test.rs
      command: cargo test --test ffi_smoke_test --features ffi
  - name: PolyvoicePipeline
    kind: struct
    visibility: public
    contract: >
      Opaque C handle wrapping a Rust Pipeline.
    proof:
      kind: integration-test
      target: tests/ffi_smoke_test.rs
      command: cargo test --test ffi_smoke_test --features ffi
dependencies:
  internal:
    - module: pipeline
      scope: orchestration
      reason: Pipeline for diarization.
    - module: models
      scope: infrastructure
      reason: ModelRegistry for model downloads.
    - module: types
      scope: data-shape
      reason: DiarizationConfig, Profile.
    - module: vad
      scope: algorithm
      reason: VadConfig.
  external: []
consumers:
  - path: examples/ffi_usage.c
    uses:
      - polyvoice_pipeline_create
      - polyvoice_pipeline_run
      - polyvoice_pipeline_free
  - path: tests/ffi_smoke_test.rs
    uses:
      - PolyvoicePipeline
invariants:
  - id: memory-safety
    rule: Every create has exactly one free; no use-after-free.
    proof:
      kind: integration-test
      target: tests/ffi_smoke_test.rs
      command: cargo test --test ffi_smoke_test --features ffi
  - id: abi-stable
    rule: C-visible structs use #[repr(C)] and fixed-size types.
    proof:
      kind: static-check
      target: src/ffi/mod.rs
      command: cargo check --features ffi
verification:
  pre_change:
    - cargo check --features ffi
  full:
    - cargo test --test ffi_smoke_test --features ffi
    - cargo clippy --all-targets --all-features -- -D warnings
agent_policy:
  allowed_mutations:
    - Adding new FFI wrappers for existing Rust surfaces.
    - Documentation of SAFETY invariants.
  forbidden_mutations:
    - Changing existing C function signatures (breaks ABI).
    - Removing #[repr(C)] from public structs.
  escalation:
    - Any change to C-visible function signatures or struct layouts.
---

# src/ffi

C FFI bindings for polyvoice (ABI v2).