summonpot 0.1.0__tar.gz

summonpot-0.1.0/.github/dependabot.yml

@@ -0,0 +1,41 @@
+# Keep dependencies up to date
+# https://docs.github.com/en/code-security/dependabot/dependabot-version-updates
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    commit-message:
+      prefix: "chore"
+      include: "scope"
+    labels:
+      - "dependencies"
+
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    commit-message:
+      prefix: "chore"
+      include: "scope"
+    labels:
+      - "dependencies"
+    groups:
+      dev-dependencies:
+        patterns:
+          - "pytest*"
+          - "ruff"
+          - "pyright"
+          - "pre-commit"
+          - "towncrier"
+      runtime-dependencies:
+        patterns:
+          - "httpx"
+          - "pydantic"
+          - "fastapi*"
+          - "uvicorn"
+          - "typer"

summonpot-0.1.0/.github/labeler.yml

@@ -0,0 +1,34 @@
+# Auto-label rules for pull requests.
+
+ci:
+  - changed-files:
+      - any-glob-to-any-file:
+          - ".github/**/*"
+          - "Makefile"
+
+documentation:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "README.md"
+          - "CONTRIBUTING.md"
+          - "CHANGELOG.md"
+          - "docs/**/*"
+
+source:
+  - changed-files:
+      - any-glob-to-any-file: "src/**/*"
+
+tests:
+  - changed-files:
+      - any-glob-to-any-file: "tests/**/*"
+
+dependencies:
+  - changed-files:
+      - any-glob-to-any-file:
+          - "pyproject.toml"
+          - "uv.lock"
+          - ".github/dependabot.yml"
+
+examples:
+  - changed-files:
+      - any-glob-to-any-file: "examples/**/*"

summonpot-0.1.0/.github/workflows/changelog.yml

@@ -0,0 +1,41 @@
+name: Changelog
+
+on:
+  pull_request:
+    branches: [main]
+    types: [opened, synchronize, reopened, labeled, unlabeled]
+
+permissions:
+  contents: read
+  pull-requests: read # Required to inspect the pull request's changed files.
+
+concurrency:
+  group: changelog-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  changelog:
+    name: changelog
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    env:
+      GH_TOKEN: ${{ github.token }}
+      PR_NUMBER: ${{ github.event.pull_request.number }}
+      REPOSITORY: ${{ github.repository }}
+    steps:
+      - name: Skip non-user-facing changes
+        if: contains(github.event.pull_request.labels.*.name, 'skip-changelog')
+        run: echo "skip-changelog label present"
+      - name: Require this PR's changelog fragment
+        if: ${{ !contains(github.event.pull_request.labels.*.name, 'skip-changelog') }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          pattern="^changelog\.d/${PR_NUMBER}\.(added|changed|deprecated|removed|fixed)\.md$"
+          if gh api "repos/${REPOSITORY}/pulls/${PR_NUMBER}/files" \
+            --paginate --jq '.[].filename' | grep -Eq "$pattern"; then
+            echo "changelog fragment found for PR #${PR_NUMBER}"
+            exit 0
+          fi
+          echo "::error::no changelog fragment for PR #${PR_NUMBER} — add changelog.d/${PR_NUMBER}.<type>.md (see changelog.d/README.md), or apply the 'skip-changelog' label if this change is not user-facing"
+          exit 1

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

@@ -0,0 +1,96 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_call:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: lint
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+      - run: uv sync --all-extras --locked
+      - run: uv run ruff check src/ tests/
+      - run: uv run ruff format --check src/ tests/
+
+  typecheck:
+    name: typecheck
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+      - run: uv sync --all-extras --locked
+      - run: uv run pyright src/ tests/
+
+  test:
+    name: test (py${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: uv sync --all-extras --locked
+      - run: >-
+          uv run pytest tests/ -v
+          --cov=src/summonpot
+          --cov-report=term-missing
+          --cov-fail-under=50
+
+  build:
+    name: build
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+      - run: uv build
+      - name: Verify distribution artifacts
+        run: |
+          python3 - <<'PY'
+          import glob
+          import tarfile
+          import zipfile
+
+          wheels = glob.glob("dist/*.whl")
+          sdists = glob.glob("dist/*.tar.gz")
+          assert len(wheels) == 1, f"expected one wheel, found {wheels}"
+          assert len(sdists) == 1, f"expected one sdist, found {sdists}"
+
+          with zipfile.ZipFile(wheels[0]) as archive:
+              names = archive.namelist()
+              assert "summonpot/__init__.py" in names, names
+
+          with tarfile.open(sdists[0]) as archive:
+              names = archive.getnames()
+              assert any(name.endswith("/src/summonpot/__init__.py") for name in names), names
+
+          print(f"verified {wheels[0]} and {sdists[0]}")
+          PY

summonpot-0.1.0/.github/workflows/labeler.yml

@@ -0,0 +1,26 @@
+name: Auto-label PRs
+
+on:
+  pull_request_target:
+    types: [opened, synchronize, reopened, ready_for_review]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: labeler-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  label:
+    name: label
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      contents: read
+      pull-requests: write # Required to apply labels to pull requests.
+    steps:
+      - uses: actions/labeler@bf12e9b00b37c5c0ca2b87b79b2daf7891dbda13 # v7.0.0
+        with:
+          repo-token: ${{ github.token }}
+          sync-labels: true

summonpot-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,176 @@
+name: Release
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  ci:
+    name: CI
+    uses: ./.github/workflows/ci.yml
+
+  verify-version:
+    name: verify version and changelog
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - name: Verify tag, package version, and changelog
+        env:
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: |
+          python3 - <<'PY'
+          import pathlib
+          import re
+          import sys
+          import tomllib
+          import os
+
+          tag = os.environ["RELEASE_TAG"]
+          if not tag.startswith("v") or len(tag) == 1:
+              print(f"::error::release tag must be v<version>, got {tag!r}")
+              sys.exit(1)
+
+          version = tag[1:]
+          package_version = tomllib.loads(
+              pathlib.Path("pyproject.toml").read_text()
+          )["project"]["version"]
+          if version != package_version:
+              print(
+                  f"::error::tag {tag} does not match pyproject.toml version "
+                  f"{package_version} — run 'uv version {version}' on main first"
+              )
+              sys.exit(1)
+
+          changelog = pathlib.Path("CHANGELOG.md").read_text()
+          heading = re.compile(
+              rf"^## \[{re.escape(version)}\](?:\s|$)", re.MULTILINE
+          )
+          if heading.search(changelog) is None:
+              print(
+                  f"::error::CHANGELOG.md has no exact '## [{version}]' section — "
+                  "run 'make changelog' and commit it before tagging"
+              )
+              sys.exit(1)
+
+          print(f"{tag} matches pyproject.toml and CHANGELOG.md")
+          PY
+
+  build:
+    name: build release artifacts
+    needs: [ci, verify-version]
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          enable-cache: false
+      - run: uv build
+      - name: Verify release artifacts
+        run: |
+          python3 - <<'PY'
+          import glob
+          import tarfile
+          import zipfile
+
+          wheels = glob.glob("dist/*.whl")
+          sdists = glob.glob("dist/*.tar.gz")
+          assert len(wheels) == 1, f"expected one wheel, found {wheels}"
+          assert len(sdists) == 1, f"expected one sdist, found {sdists}"
+          with zipfile.ZipFile(wheels[0]) as archive:
+              assert "summonpot/__init__.py" in archive.namelist()
+          with tarfile.open(sdists[0]) as archive:
+              assert any(
+                  name.endswith("/src/summonpot/__init__.py")
+                  for name in archive.getnames()
+              )
+          print(f"verified {wheels[0]} and {sdists[0]}")
+          PY
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: dist
+          path: dist/
+          if-no-files-found: error
+
+  publish:
+    name: publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write # Required for PyPI trusted publishing via OIDC.
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2
+        with:
+          attestations: true
+
+  github-release:
+    name: create GitHub Release
+    needs: publish
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      contents: write # Required to create the GitHub Release and upload assets.
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          name: dist
+          path: dist/
+      - name: Extract release notes from CHANGELOG
+        env:
+          RELEASE_VERSION: ${{ github.ref_name }}
+        run: |
+          python3 - <<'PY' > release-notes.md
+          import os
+          import pathlib
+          import re
+          import sys
+
+          version = os.environ["RELEASE_VERSION"].removeprefix("v")
+          text = pathlib.Path("CHANGELOG.md").read_text()
+          match = re.search(
+              rf"^## \[{re.escape(version)}\][^\n]*\n(.*?)(?=^## \[|\Z)",
+              text,
+              re.MULTILINE | re.DOTALL,
+          )
+          if match is None:
+              sys.exit(f"no exact '## [{version}]' section in CHANGELOG.md")
+          print(match.group(1).strip())
+          PY
+          cat release-notes.md
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: |
+          set -euo pipefail
+          version="${RELEASE_TAG#v}"
+          args=()
+          case "$version" in *-*) args+=(--prerelease) ;; esac
+          gh release create "$RELEASE_TAG" \
+            --title "$RELEASE_TAG" \
+            --notes-file release-notes.md \
+            --verify-tag \
+            "${args[@]}" \
+            dist/*

summonpot-0.1.0/.github/workflows/stale.yml

@@ -0,0 +1,44 @@
+name: Stale issue and PR management
+
+on:
+  schedule:
+    - cron: "30 1 * * *" # Daily at 1:30 UTC.
+  workflow_dispatch:
+
+permissions: {}
+
+concurrency:
+  group: stale-management
+  cancel-in-progress: false
+
+jobs:
+  stale:
+    name: stale
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    permissions:
+      issues: write # Required to label, comment on, and close stale issues.
+      pull-requests: write # Required to manage stale pull requests.
+    steps:
+      - uses: actions/stale@4391f3da665fdf50b6810c1a66712fb9ba21aa93 # v11.0.0
+        with:
+          stale-issue-message: >
+            This issue has been automatically marked as stale because it has not
+            had recent activity. It will be closed in 14 days if no further
+            activity occurs.
+          stale-pr-message: >
+            This pull request has been automatically marked as stale because it
+            has not had recent activity. It will be closed in 14 days if no
+            further activity occurs.
+          close-issue-message: >
+            This issue has been automatically closed due to inactivity.
+          close-pr-message: >
+            This pull request has been automatically closed due to inactivity.
+          stale-issue-label: stale
+          stale-pr-label: stale
+          days-before-stale: 60
+          days-before-close: 14
+          days-before-pr-stale: 30
+          days-before-pr-close: 14
+          exempt-issue-labels: enhancement,pinned,security
+          exempt-pr-labels: pinned,security,dependencies

summonpot-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+
+# Virtual environments
+.venv/
+venv/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Type checking / linting
+.mypy_cache/
+.ruff_cache/
+
+# OS
+.DS_Store
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~

summonpot-0.1.0/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+Unreleased changes live as fragment files in [`changelog.d/`](changelog.d/) until a
+release assembles them here — run `make changelog-draft` to preview them.
+
+<!-- towncrier release notes start -->
+
+## [0.1.0] - 2026-08-10
+
+### Added
+
+- Add continuous integration, packaging, changelog tooling, and developer Makefile targets. ([#1](https://github.com/tugrulguner/summonpot/pull/1))
+- Add the initial summonpot framework with agentic API endpoints, automatic request schemas, tool calling, OpenAI-compatible model providers, CLI serving, and generated OpenAPI documentation. ([#2](https://github.com/tugrulguner/summonpot/pull/2))
+
+### Changed
+
+- Add comprehensive framework documentation, quick-start instructions, and usage examples. ([#3](https://github.com/tugrulguner/summonpot/pull/3))
+- Add release automation, dependency updates, pull-request labeling, and stale issue management. ([#4](https://github.com/tugrulguner/summonpot/pull/4))
+
+### Fixed
+
+- OpenAPI metadata now derives its version from installed package metadata, keeping `pyproject.toml` as the single source updated by `uv version`. ([#5](https://github.com/tugrulguner/summonpot/pull/5))

summonpot-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing to summonpot
+
+Thanks for helping build summonpot.
+
+## Development setup
+
+```bash
+git clone https://github.com/tugrulguner/summonpot.git
+cd summonpot
+uv sync --all-extras
+make check
+```
+
+Use `make format` before committing. User-facing changes need a Towncrier fragment named after the pull request:
+
+```text
+changelog.d/<pr-number>.<type>.md
+```
+
+Supported types are `added`, `changed`, `deprecated`, `removed`, and `fixed`.
+
+## Pull requests
+
+1. Branch from the latest `main`.
+2. Keep each pull request focused on one concern.
+3. Add or update tests for behavior changes.
+4. Add a changelog fragment for user-facing changes, or use `skip-changelog` when the change is not user-facing.
+5. Run `make check` and ensure every required GitHub check passes.
+
+## Releasing
+
+The version lives in exactly one place: `version` in `pyproject.toml`. `summonpot.__version__`, `summonpot --version`, generated OpenAPI metadata, and `uv.lock` all derive from that package version. Never edit those derived values by hand.
+
+Use uv to update the single version source and lockfile together:
+
+```bash
+uv version 0.2.0
+# or
+uv version --bump patch
+uv version --bump minor
+uv version --bump major
+```
+
+Then prepare the release notes from the existing Towncrier fragments:
+
+```bash
+make changelog-draft
+make changelog
+make check
+```
+
+Open a release pull request containing the `pyproject.toml`, `uv.lock`, generated `CHANGELOG.md`, and fragment removals. After that pull request is reviewed, green, and merged, tag the exact version reported by uv:
+
+```bash
+version="$(uv version --short)"
+git tag "v${version}"
+git push origin "v${version}"
+```
+
+The tag triggers `.github/workflows/release.yml`. It reruns CI, verifies that the tag, package metadata, and changelog section all match, builds and inspects the wheel and source distribution, publishes them to PyPI through trusted publishing, and then creates the GitHub Release from the same changelog section with the same artifacts attached.
+
+Nothing in a release is hand-written twice: the version comes from `pyproject.toml`, the lockfile is updated by uv, runtime version surfaces read package metadata, and release notes come from Towncrier and `CHANGELOG.md`.

summonpot-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tugrul Guner
+
+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.

summonpot-0.1.0/Makefile

@@ -0,0 +1,34 @@
+.PHONY: install test lint format typecheck check changelog-draft changelog build clean
+
+install:
+	uv sync --all-extras
+
+test:
+	uv sync --all-extras --reinstall-package summonpot
+	uv run pytest tests/ -v
+
+lint:
+	uv run ruff check src/ tests/
+	uv run ruff format --check src/ tests/
+
+typecheck:
+	uv run pyright src/ tests/
+
+format:
+	uv run ruff check --fix src/ tests/
+	uv run ruff format src/ tests/
+
+check: lint typecheck test
+
+changelog-draft:
+	uv run towncrier build --draft --version $$(uv version --short)
+
+changelog:
+	uv run towncrier build --yes --version $$(uv version --short)
+
+build:
+	uv build
+
+clean:
+	rm -rf dist/ build/ *.egg-info .pytest_cache .ruff_cache
+	find . -type d -name __pycache__ -exec rm -rf {} +