earshot-observability 0.1.0__tar.gz

earshot_observability-0.1.0/.dockerignore

@@ -0,0 +1,38 @@
+.git
+.github
+.env
+.env.*
+.npmrc
+.pypirc
+.aws
+.ssh
+*.key
+*.pem
+*.p12
+*.pfx
+id_rsa
+id_ed25519
+local
+local/**
+.venv
+.venv2
+.earshot
+**/.earshot
+docs/private
+node_modules
+**/node_modules
+dist
+**/dist
+packages/sdk-python/src/earshot/web
+coverage
+htmlcov
+*.sqlite3
+*.sqlite3-shm
+*.sqlite3-wal
+__pycache__
+**/__pycache__
+*.pyc
+.claude
+*.log
+earshot_pipecat_incident.json
+.DS_Store

earshot_observability-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,80 @@
+name: Bug report
+description: Report a reproducible Earshot defect using synthetic evidence.
+title: "[Bug]: "
+labels: [bug, triage]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for helping improve Earshot. Do not attach real recordings, transcripts,
+        phone numbers, credentials, signed URLs, or customer incident artifacts. Replace
+        every sensitive value with a unique synthetic sentinel.
+  - type: textarea
+    id: summary
+    attributes:
+      label: What happened?
+      description: Describe the observed behavior and why it is incorrect.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: What should have happened?
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Minimal synthetic reproduction
+      description: Include the smallest code or fixture that reproduces the problem.
+      render: shell
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Earshot version or commit
+      placeholder: 0.1.0 or git SHA
+    validations:
+      required: true
+  - type: dropdown
+    id: surface
+    attributes:
+      label: Affected surface
+      options:
+        - Python SDK lifecycle
+        - Incident contract or validation
+        - Export or delivery
+        - Storage or purge
+        - Local API or authentication
+        - Viewer
+        - Analysis or turn facts
+        - Pipecat adapter
+        - LiveKit adapter
+        - Provider connector
+        - Packaging or container
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: OS, Python/Node version, framework/provider SDK version, and deployment shape.
+    validations:
+      required: true
+  - type: textarea
+    id: diagnostics
+    attributes:
+      label: Sanitized diagnostics
+      description: Include synthetic logs or validation output only when useful.
+      render: text
+  - type: checkboxes
+    id: privacy
+    attributes:
+      label: Privacy confirmation
+      options:
+        - label: I removed all real voice-session content, credentials, and customer identifiers.
+          required: true
+        - label: I searched existing issues before filing this report.
+          required: true

earshot_observability-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/Kkartik14/Earshot/security/advisories/new
+    about: Report vulnerabilities privately. Never put secrets or real voice-session data in an issue.
+  - name: Documentation
+    url: https://github.com/Kkartik14/Earshot/tree/main/docs
+    about: Review the architecture, contracts, adapters, privacy model, and release guidance.

earshot_observability-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,46 @@
+name: Feature request
+description: Propose a capability grounded in a concrete voice-observability problem.
+title: "[Feature]: "
+labels: [enhancement, triage]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What voice-observability task cannot be completed today, and by whom?
+    validations:
+      required: true
+  - type: textarea
+    id: scenario
+    attributes:
+      label: Concrete scenario
+      description: Describe the runtime, evidence available, and expected operational decision.
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed behavior
+      description: Focus on the public behavior or contract, not only an implementation.
+    validations:
+      required: true
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Evidence and coverage implications
+      description: What is measured, inferred, unavailable, or not observed?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+  - type: checkboxes
+    id: scope
+    attributes:
+      label: Scope confirmation
+      options:
+        - label: This keeps Earshot an observability SDK rather than making it own the voice runtime.
+          required: true
+        - label: This request contains no real customer or voice-session data.
+          required: true

earshot_observability-0.1.0/.github/ISSUE_TEMPLATE/integration_request.yml

@@ -0,0 +1,47 @@
+name: Integration request
+description: Request support for a voice runtime, provider, or finalized evidence surface.
+title: "[Integration]: "
+labels: [integration, triage]
+body:
+  - type: input
+    id: system
+    attributes:
+      label: Runtime or provider
+      placeholder: Provider and SDK/package name
+    validations:
+      required: true
+  - type: input
+    id: versions
+    attributes:
+      label: Versions in use
+      placeholder: Package version and relevant API version
+    validations:
+      required: true
+  - type: textarea
+    id: surface
+    attributes:
+      label: Available evidence surface
+      description: Describe native OTel spans, callbacks, finalized payloads, APIs, or documented hooks.
+    validations:
+      required: true
+  - type: textarea
+    id: semantics
+    attributes:
+      label: Voice semantics exposed
+      description: Identify turn boundaries, STT/LLM/TTS timing, interruption, transport, and coverage facts.
+    validations:
+      required: true
+  - type: textarea
+    id: references
+    attributes:
+      label: Primary documentation
+      description: Link official SDK/API documentation and public synthetic examples.
+    validations:
+      required: true
+  - type: checkboxes
+    id: data
+    attributes:
+      label: Data handling
+      options:
+        - label: I will not attach captured production payloads, recordings, transcripts, or credentials.
+          required: true

earshot_observability-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,24 @@
+## Summary
+
+<!-- What changes, and what user-visible or contract-level problem does it solve? -->
+
+## Evidence model
+
+- [ ] Measured, estimated, inferred, unavailable, and not-observed facts remain distinct.
+- [ ] No client render, playout, human-heard, network-quality, or global-clock claim is invented.
+- [ ] Contract/generated artifact changes are committed together, or this PR does not change them.
+
+## Privacy and security
+
+- [ ] Tests and fixtures use synthetic sentinel data only.
+- [ ] No transcript, recording, phone number, credential, signed URL, or customer identifier is committed.
+- [ ] New capture/export/storage paths have fail-closed privacy coverage.
+
+## Verification
+
+<!-- List exact commands and meaningful manual checks. -->
+
+## Compatibility and release
+
+- [ ] Public API, persisted schema, adapter, dependency-range, and migration impacts are documented.
+- [ ] Release notes or documentation are updated when users must act.

earshot_observability-0.1.0/.github/dependabot.yml

@@ -0,0 +1,65 @@
+version: 2
+
+updates:
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: "04:00"
+      timezone: Asia/Kolkata
+    open-pull-requests-limit: 5
+    versioning-strategy: increase-if-necessary
+    labels: [dependencies, python]
+    commit-message:
+      prefix: deps(python)
+    groups:
+      python-minor-and-patch:
+        patterns: ["*"]
+        update-types: [minor, patch]
+
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: "04:15"
+      timezone: Asia/Kolkata
+    open-pull-requests-limit: 5
+    labels: [dependencies, javascript]
+    commit-message:
+      prefix: deps(js)
+    groups:
+      javascript-minor-and-patch:
+        patterns: ["*"]
+        update-types: [minor, patch]
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: "04:30"
+      timezone: Asia/Kolkata
+    open-pull-requests-limit: 5
+    labels: [dependencies, github-actions]
+    commit-message:
+      prefix: deps(actions)
+    groups:
+      github-actions:
+        patterns: ["*"]
+
+  - package-ecosystem: docker
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: "04:45"
+      timezone: Asia/Kolkata
+    open-pull-requests-limit: 5
+    labels: [dependencies, docker]
+    commit-message:
+      prefix: deps(docker)
+    groups:
+      container-base-images:
+        patterns: ["*"]

earshot_observability-0.1.0/.github/release.yml

@@ -0,0 +1,24 @@
+changelog:
+  exclude:
+    labels:
+      - skip-changelog
+      - duplicate
+      - invalid
+      - question
+  categories:
+    - title: Breaking changes
+      labels: [breaking]
+    - title: Features
+      labels: [feature, enhancement]
+    - title: Fixes
+      labels: [bug, fix]
+    - title: Integrations
+      labels: [integration, adapter, connector]
+    - title: Security
+      labels: [security]
+    - title: Documentation
+      labels: [documentation]
+    - title: Dependencies
+      labels: [dependencies]
+    - title: Other changes
+      labels: ["*"]

earshot_observability-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,184 @@
+name: ci
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  python:
+    name: Python contract, backend, and adapters
+    runs-on: ubuntu-latest
+    timeout-minutes: 25
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+          cache: pip
+      - name: Install backend and pinned framework lanes
+        run: python -m pip install -e '.[dev,pipecat-groq,livekit]'
+      - name: Smoke-import headless Pipecat providers
+        run: >-
+          python -c "from pipecat.services.groq.llm import GroqLLMService;
+          from pipecat.services.groq.stt import GroqSTTService;
+          from pipecat.services.groq.tts import GroqTTSService"
+      - name: Check generated contracts
+        run: |
+          python scripts/generate_contract.py --check
+          python scripts/generate_openapi.py --check
+          python scripts/check_semconv.py
+      - name: Lint
+        run: |
+          ruff check packages/sdk-python/src packages/sdk-python/tests apps/ingest scripts examples
+          ruff format --check packages/sdk-python/src packages/sdk-python/tests apps/ingest scripts examples
+      - name: Test with branch coverage
+        run: pytest --cov=earshot --cov-report=term-missing -q
+
+  python-compatibility:
+    name: Python ${{ matrix.python-version }} adapter conformance
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - name: Install dependency-free adapter test environment
+        run: python -m pip install -e '.[dev]'
+      - name: Exercise every raw and finalized adapter public seam
+        run: >-
+          pytest -q
+          packages/sdk-python/tests/test_adapter_conformance.py
+          apps/ingest/tests/test_finalized_adapter_conformance.py
+
+  framework-compatibility:
+    name: ${{ matrix.integration }} ${{ matrix.lane }} compatibility
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - integration: pipecat
+            lane: minimum
+            dependency: pipecat-ai[tracing]==1.5.0
+          - integration: pipecat
+            lane: current
+            dependency: pipecat-ai[tracing]>=1.5.0,<1.6
+          - integration: livekit
+            lane: minimum
+            dependency: livekit-agents==1.6.5
+          - integration: livekit
+            lane: current
+            dependency: livekit-agents>=1.6.5,<1.7
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+          cache: pip
+      - name: Install framework dependency lane
+        env:
+          FRAMEWORK_DEPENDENCY: ${{ matrix.dependency }}
+        run: |
+          python -m pip install -e '.[dev]'
+          python -m pip install --upgrade "$FRAMEWORK_DEPENDENCY"
+      - name: Exercise real framework objects and conformance fixtures
+        run: |
+          pytest -q apps/ingest/tests/test_framework_integrations.py \
+            -k '${{ matrix.integration }}'
+          pytest -q packages/sdk-python/tests/test_adapter_conformance.py \
+            -k '${{ matrix.integration }}'
+
+  macos-smoke:
+    name: macOS framework smoke
+    runs-on: macos-14
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: pip
+      - name: Install newest supported framework dependencies
+        run: python -m pip install --upgrade -e '.[dev,pipecat,livekit]'
+      - name: Exercise public seams and real dependency models
+        run: |
+          pytest -q packages/sdk-python/tests/test_adapter_conformance.py
+          pytest -q apps/ingest/tests/test_framework_integrations.py \
+            -k 'metric_models_are_consumed_as_real_objects or real_readable_spans_have_lifecycle_root_and_sibling_stages'
+
+  artifacts:
+    name: Clean wheel and source distribution
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+          cache: pip
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+      - name: Build viewer and release artifacts from a clean checkout
+        run: |
+          python -m pip install 'build>=1.2,<2'
+          pnpm install --frozen-lockfile
+          pnpm --filter @earshot/viewer bundle
+          python -m build --wheel --sdist --outdir dist
+      - name: Inspect artifact contents and dependency metadata
+        run: |
+          python scripts/check_wheel.py dist/*.whl
+          python scripts/check_sdist.py dist/*.tar.gz
+      - name: Install and smoke base and server variants
+        run: |
+          python scripts/smoke_artifact.py dist/*.whl
+          python scripts/smoke_artifact.py dist/*.tar.gz
+
+  typescript:
+    name: TypeScript compatibility packages
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v6
+      - uses: pnpm/action-setup@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version-file: .nvmrc
+          cache: pnpm
+      - name: Install locked dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Check generated viewer API types
+        run: |
+          pnpm --filter @earshot/viewer gen:api
+          git diff --exit-code -- apps/viewer/src/api/schema.d.ts
+      - name: Test, typecheck, build, and format
+        run: |
+          pnpm test
+          pnpm typecheck
+          pnpm build
+          pnpm format:check
+
+  container:
+    name: Single-image smoke test
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v6
+      - name: Build and exercise hardened container
+        run: sh scripts/smoke-container.sh