tokenome 0.1.0__tar.gz

tokenome-0.1.0/.github/ISSUE_TEMPLATE/analysis.yml

@@ -0,0 +1,46 @@
+name: Investigation / analysis task
+description: Analyze SDK behavior/design before coding.
+title: "[analysis][sdk]: "
+labels: [analysis, needs-triage]
+body:
+  - type: textarea
+    id: question
+    attributes:
+      label: Question to answer
+      placeholder: "What is unknown?"
+    validations:
+      required: true
+  - type: textarea
+    id: context
+    attributes:
+      label: Context
+      placeholder: "provider/framework versions, sample payloads, prior attempts"
+    validations:
+      required: true
+  - type: textarea
+    id: constraints
+    attributes:
+      label: Constraints
+      placeholder: "backward compatibility, fail-open, metadata-only"
+  - type: textarea
+    id: analysis_plan
+    attributes:
+      label: Analysis plan (discussion first)
+      placeholder: |
+        - inspect code path
+        - run focused tests
+        - compare options
+    validations:
+      required: true
+  - type: textarea
+    id: decision
+    attributes:
+      label: Decision log
+      description: Fill after discussion. Chosen approach + trade-offs.
+  - type: textarea
+    id: execution
+    attributes:
+      label: Execution plan
+      placeholder: |
+        - [ ] implementation step
+        - [ ] tests/docs updates

tokenome-0.1.0/.github/ISSUE_TEMPLATE/bug.yml

@@ -0,0 +1,65 @@
+name: Bug report
+description: Report broken SDK behavior (instrumentation, transport, context, payload).
+title: "[bug][sdk]: "
+labels: [bug, needs-triage]
+body:
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Pre-flight
+      options:
+        - label: I searched existing issues.
+          required: true
+        - label: I tested on latest SDK version or Development branch.
+          required: true
+  - type: input
+    id: version
+    attributes:
+      label: SDK version
+      placeholder: "0.1.x / commit sha"
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem statement
+      placeholder: "instrument_openai does X instead of Y"
+    validations:
+      required: true
+  - type: textarea
+    id: repro
+    attributes:
+      label: Minimal reproduction
+      placeholder: |
+        ```python
+        # minimal script
+        ```
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected vs actual
+      placeholder: "Expected: ...\nActual: ..."
+    validations:
+      required: true
+  - type: textarea
+    id: analysis
+    attributes:
+      label: Analysis notes (we discuss here)
+      placeholder: "likely module/function and why"
+  - type: textarea
+    id: resolution
+    attributes:
+      label: Resolution plan (to be filled before coding)
+      placeholder: |
+        - patch area
+        - tests to add
+        - backward-compat check
+  - type: checkboxes
+    id: privacy
+    attributes:
+      label: Data safety
+      options:
+        - label: No prompt/completion text is required to reproduce.
+          required: false

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

@@ -0,0 +1 @@
+blank_issues_enabled: false

tokenome-0.1.0/.github/ISSUE_TEMPLATE/feature.yml

@@ -0,0 +1,55 @@
+name: Feature request
+description: Request SDK capability (new provider metadata, instrumentation, API ergonomics).
+title: "[feature][sdk]: "
+labels: [enhancement, needs-triage]
+body:
+  - type: textarea
+    id: outcome
+    attributes:
+      label: Desired outcome
+      placeholder: "What devs should be able to do after this feature"
+    validations:
+      required: true
+  - type: textarea
+    id: integration
+    attributes:
+      label: Integration context
+      placeholder: "framework/provider/runtime context"
+    validations:
+      required: true
+  - type: textarea
+    id: api
+    attributes:
+      label: Proposed API/usage shape
+      placeholder: |
+        ```python
+        # desired usage
+        ```
+    validations:
+      required: true
+  - type: textarea
+    id: compatibility
+    attributes:
+      label: Backward compatibility expectations
+      placeholder: "what must remain stable"
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+      placeholder: |
+        - [ ] criterion 1
+        - [ ] criterion 2
+    validations:
+      required: true
+  - type: textarea
+    id: analysis
+    attributes:
+      label: Analysis notes (we discuss here)
+      placeholder: "trade-offs, data safety, fail-open impact"
+  - type: textarea
+    id: resolution
+    attributes:
+      label: Resolution plan (to be filled before coding)
+      placeholder: |
+        - instrumentation/transport changes
+        - tests + docs

tokenome-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,32 @@
+## Summary
+- what changed
+- why now
+
+## Linked issue
+Closes #<issue-id>
+
+## Problem analysis (before code)
+- integration gap
+- SDK API constraints
+- backward-compatibility notes
+
+## Changes
+- [ ] event schema/payload updates
+- [ ] instrumentation updates (openai/anthropic/framework)
+- [ ] transport/retry behavior reviewed
+- [ ] tests added/updated
+- [ ] docs/examples updated
+
+## Validation
+- [ ] `uv run ruff format --check src tests`
+- [ ] `uv run ruff check src tests`
+- [ ] `PYTHONPATH=src uv run pytest -q`
+
+## Compatibility & safety
+- [ ] fail-open behavior preserved
+- [ ] no prompt/response leakage by default
+- [ ] no breaking API change without migration note
+
+## Notes for reviewer
+- focus areas
+- known follow-ups

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

@@ -0,0 +1,57 @@
+name: ci
+
+on:
+  pull_request:
+  push:
+    branches: [Development, Production]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  smoke-install:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+      - name: Clean install smoke checks
+        run: ./scripts/smoke_install.sh
+
+  test:
+    needs: smoke-install
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: uv sync --extra dev
+      - name: Wrapper + bootstrap ownership tests
+        run: >-
+          uv run pytest -q
+          tests/test_public_imports.py
+          tests/test_standalone_bootstrap.py
+          tests/test_init_from_env.py
+          tests/test_instrumentation_openai.py
+          tests/test_instrumentation_anthropic.py
+          tests/test_transport.py
+      - name: Full test suite
+        run: uv run pytest -q --json-report --json-report-file=pytest-report.json
+      - name: Upload pytest report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: pytest-report-${{ matrix.python-version }}
+          path: pytest-report.json
+          retention-days: 7

tokenome-0.1.0/.github/workflows/pr-ci-summary-comment.yml

@@ -0,0 +1,36 @@
+name: pr-ci-summary-comment
+
+on:
+  workflow_run:
+    workflows:
+      - ci
+      - quality
+      - security-supply-chain
+    types:
+      - completed
+
+permissions:
+  actions: read
+  contents: read
+  pull-requests: write
+  issues: write
+
+jobs:
+  pr-ci-summary-comment:
+    if: github.event.workflow_run.event == 'pull_request' && github.event.workflow_run.pull_requests[0].number != null
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+
+      - name: Post replace-on-rerun PR CI summary comment
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REQUIRED_WORKFLOW_FILES: ci.yml,quality.yml,security-supply-chain.yml
+          PR_CI_SUMMARY_MARKER: <!-- pr-ci-summary-comment:marker -->
+        run: uv run scripts/pr_ci_summary_comment.py

tokenome-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,81 @@
+name: publish
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+      - run: uv build
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          retention-days: 1
+
+  test:
+    needs: build
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: uv sync --extra dev
+      - run: uv run ruff format --check src tests
+      - run: uv run ruff check src tests
+      - run: uv run isort --check-only src tests
+      - run: uv run mypy src tests
+      - run: uv run pytest -q
+
+  testpypi:
+    needs: test
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/project/tokenome
+    permissions:
+      id-token: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          skip-existing: true
+
+  pypi:
+    needs: testpypi
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/tokenome
+    permissions:
+      id-token: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true

tokenome-0.1.0/.github/workflows/quality.yml

@@ -0,0 +1,63 @@
+name: quality
+
+on:
+  pull_request:
+  push:
+    branches:
+      - Development
+      - Production
+
+permissions:
+  contents: read
+
+jobs:
+  format:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+      - run: uv sync --extra dev
+      - run: uv run ruff format --check src tests
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+      - run: uv sync --extra dev
+      - run: uv run ruff check src tests
+
+  import-sort:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+      - run: uv sync --extra dev
+      - run: uv run isort --check-only src tests
+
+  mypy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+      - run: uv sync --extra dev
+      - run: uv run mypy src tests
+
+  check-added-large-files:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: pre-commit/action@v3.0.1
+        with:
+          extra_args: check-added-large-files --all-files

tokenome-0.1.0/.github/workflows/security-supply-chain.yml

@@ -0,0 +1,24 @@
+name: security-supply-chain
+
+on:
+  pull_request:
+  push:
+    branches:
+      - Development
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+jobs:
+  pip-audit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.12"
+      - run: uv sync --extra dev
+      - name: Run pip-audit
+        run: uv run pip-audit --desc --format=json

tokenome-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+.venv/
+__pycache__/
+*.pyc
+.pytest_cache/
+.ruff_cache/
+

tokenome-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,39 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-yaml
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+      - id: check-added-large-files
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.11.13
+    hooks:
+      - id: ruff-format
+        args: [--line-length=100]
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+
+  - repo: local
+    hooks:
+      - id: smoke-install
+        name: smoke install (wheel + imports)
+        entry: ./scripts/smoke_install.sh
+        language: system
+        pass_filenames: false
+        stages: [manual, pre-push]
+      - id: pytest-required-ownership
+        name: pytest (framework + standalone ownership)
+        entry: >-
+          bash -lc 'uv run pytest -q
+          tests/test_standalone_bootstrap.py
+          tests/test_init_from_env.py
+          tests/test_public_imports.py'
+        language: system
+        pass_filenames: false
+      - id: pytest
+        name: pytest (full suite)
+        entry: bash -lc 'uv run pytest -q'
+        language: system
+        pass_filenames: false

tokenome-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Khodex Rei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.