Metadata-Version: 2.4
Name: cjm-transcription-adapter-interface
Version: 0.0.17
Summary: Typed transcription task-adapter interface — TranscriptionAdapter ABC + GenericTranscriptionAdapter (cache/persist bookends around a pure-compute tool), the TranscriptionToolProtocol, and transcription persistence helpers. The TranscriptionResult data noun lives in cjm-capability-primitives (re-exported here as a compat shim).
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-transcription-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-transcription-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) -->

Typed transcription task-adapter interface — TranscriptionAdapter ABC, the generic cache/persist adapter, the REMOVE-AFTER-OVERHAUL core shim, and transcription persistence helpers.

## Modules

- **`cjm_transcription_adapter_interface.__init__`**
- **`cjm_transcription_adapter_interface.adapter`** — The typed transcription task contract — TranscriptionAdapter ABC + the REAL structural tool protocol (capability-unit Option C, pass-2 Thread 3; protocol born real at stage 8).
- **`cjm_transcription_adapter_interface.core`** — REMOVE-AFTER-OVERHAUL(option-c-cascade): class-identical legacy import surface; TranscriptionResult relocated to cjm_capability_primitives.transcription at execution stage 8 (Option C / PILLAR 1c — pure-compute tool capabilities depend on the data noun, never the adapter machinery).
- **`cjm_transcription_adapter_interface.generic`** — The generic (tool-agnostic) transcription adapter — cache-check, invoke the bound tool's pure-compute transcribe, persist. Reused across every tool capability satisfying TranscriptionToolProtocol (whisper, voxtral, ...), exactly as GenericGraphStorageAdapter is reused across graph backends.
- **`cjm_transcription_adapter_interface.storage`** — Standardized SQLite storage for transcription results with content hashing.

## API

### `cjm_transcription_adapter_interface.adapter`

- `TranscriptionAdapter` _class_ — Typed transcription task adapter: model-ready audio in,
- `TranscriptionToolProtocol` _class_ — Structural contract for transcription tool capabilities (BORN REAL at

### `cjm_transcription_adapter_interface.generic`

- `GenericTranscriptionAdapter` _class_ — Generic transcription adapter: cache-check -> pure-compute tool -> persist.

### `cjm_transcription_adapter_interface.storage`

- `TranscriptionRow` _class_ — A single row from the transcriptions table.
- `TranscriptionStorage` _class_ — Standardized SQLite storage for transcription results.

## Dependencies

**Depends on:** `cjm-capability-primitives`, `cjm-substrate`
**Used by:** `cjm-transcription-core`
