Metadata-Version: 2.4
Name: cjm-vad-adapter-interface
Version: 0.0.11
Summary: Typed voice-activity-detection task-adapter interface — VADAdapter ABC + GenericVADAdapter (cache/persist bookends around a pure-compute tool), the VADToolProtocol, and VAD persistence helpers. The VADResult data noun lives in cjm-capability-primitives.
Author-email: "Christian J. Mills" <9126128+cj-mills@users.noreply.github.com>
License: Apache-2.0
Project-URL: Repository, https://github.com/cj-mills/cjm-vad-adapter-interface
Project-URL: Documentation, https://cj-mills.github.io/cjm-vad-adapter-interface/
Keywords: vad,voice-activity-detection,adapter-interface
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: cjm-substrate>=0.0.51
Requires-Dist: cjm_capability_primitives>=0.0.10
Dynamic: license-file

# cjm-vad-adapter-interface

<!-- generated from the context graph by `cjm-context-graph readme` — do not edit by hand; edit the graph (the urge to hand-edit = move it on-graph) -->

_No purpose recorded on-graph yet — author it with_ `assert b841c358-3bb8-50cb-b461-fc4567b4f538 purpose "…"` _(or by the repo's entity key)._

## Modules

- **`cjm_vad_adapter_interface.__init__`**
- **`cjm_vad_adapter_interface.adapter`** — The typed voice-activity-detection task contract — the VADAdapter ABC + the VADToolProtocol structural contract (capability-unit Option C, pass-2 Thread 3).
- **`cjm_vad_adapter_interface.generic`** — The generic (tool-agnostic) VAD adapter — cache-check, invoke the bound tool's pure-compute detect_speech, persist; reused across every tool capability satisfying VADToolProtocol.
- **`cjm_vad_adapter_interface.storage`** — Standardized SQLite storage for voice-activity-detection results with content hashing — the cache/persistence bookend GenericVADAdapter wraps around the pure-compute VAD tool.

## API

### `cjm_vad_adapter_interface.adapter`

- `VADAdapter` _class_ — Typed voice-activity-detection task adapter: model-ready audio in,
- `VADToolProtocol` _class_ — Structural contract for voice-activity-detection tool capabilities

### `cjm_vad_adapter_interface.generic`

- `GenericVADAdapter` _class_ — Generic VAD adapter: cache-check -> pure-compute tool -> persist.

### `cjm_vad_adapter_interface.storage`

- `VADRow` _class_ — A single row from the vad_results table.
- `VADStorage` _class_ — Standardized SQLite storage for voice-activity-detection results.

## Dependencies

**Depends on:** `cjm-capability-primitives`, `cjm-substrate`
