agentseek-api 0.0.1__tar.gz

agentseek_api-0.0.1/.dockerignore

@@ -0,0 +1,8 @@
+.agentseek
+.git
+.github
+.pytest_cache
+.tmp
+.venv
+__pycache__
+*.pyc

agentseek_api-0.0.1/.env.example

@@ -0,0 +1,15 @@
+METADATA_DB_URL=
+METADATA_DB_BACKEND=auto
+SEEKDB_URL=mysql+aiomysql://root%40test:@localhost:2881/seekdb
+AGENTSEEK_GRAPHS=
+AUTH_TYPE=noop
+# AUTH_TYPE values:
+# - noop: always use default_user
+# - custom: load backend from AUTH_MODULE_PATH
+AUTH_MODULE_PATH=
+
+OCEANBASE_HOST=localhost
+OCEANBASE_PORT=2881
+OCEANBASE_USER=root@test
+OCEANBASE_PASSWORD=
+OCEANBASE_DB_NAME=seekdb

agentseek_api-0.0.1/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,13 @@
+## Summary
+
+- 
+
+## Test Plan
+
+- [ ] `uv run pytest -q`
+
+## Target Branch Check
+
+- [ ] `feature/*` PRs target `develop`
+- [ ] `release/*` PRs target `main`
+- [ ] `hotfix/*` PRs target `main`

agentseek_api-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,387 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+      - develop
+      - "feature/**"
+      - "release/**"
+      - "hotfix/**"
+    paths-ignore:
+      - "**/*.md"
+  pull_request:
+    branches:
+      - develop
+      - main
+    paths-ignore:
+      - "**/*.md"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  fast-tests:
+    name: Fast Tests
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup UV
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          enable-cache: true
+          cache-python: true
+          python-version: "3.12"
+
+      - name: Sync dependencies
+        run: uv sync --dev
+
+      - name: Coverage-backed unit + integration suite
+        run: make test-cov
+
+  cli-compatibility:
+    name: CLI Compatibility (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - ubuntu-latest
+          - macos-latest
+          - windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup UV
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          enable-cache: true
+          cache-python: true
+          python-version: "3.12"
+
+      - name: Sync dependencies
+        run: uv sync --dev
+
+      - name: Installed CLI reports version
+        run: uv run agentseek-api version
+
+      - name: CLI auto-discovers agentseek.json for dockerfile
+        run: uv run python scripts/test_cli_config_autodiscovery.py
+
+      - name: Dockerfile command renders a runnable config
+        run: >-
+          uv run python -c
+          "from pathlib import Path; import subprocess; out = Path('.tmp/agentseek.Dockerfile'); out.parent.mkdir(exist_ok=True); subprocess.run(['uv', 'run', 'agentseek-api', 'dockerfile', '--config', 'examples/external_graph/manifest.json', str(out)], check=True); text = out.read_text(encoding='utf-8'); assert 'ENV PYTHONPATH=/deps/agent' in text; assert 'ENV AGENTSEEK_GRAPHS=/deps/agent/examples/external_graph/manifest.json' in text"
+
+      - name: Sync embedded SeekDB extra for serve smoke
+        if: runner.os == 'Linux' || (runner.os == 'macOS' && runner.arch == 'ARM64')
+        run: uv sync --dev --extra embedded
+
+      - name: CLI serve smoke boots a live API
+        if: runner.os == 'Linux' || (runner.os == 'macOS' && runner.arch == 'ARM64')
+        run: uv run python scripts/test_cli_serve_smoke.py
+
+      - name: CLI config and Docker planning tests
+        run: uv run pytest tests/unit/test_cli.py tests/unit/test_graph_manifest.py -q
+
+  cli-docker-runtime:
+    name: CLI Docker Runtime
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup UV
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          enable-cache: true
+          cache-python: true
+          python-version: "3.12"
+
+      - name: Sync dependencies
+        run: uv sync --dev
+
+      - name: CLI Docker smoke
+        run: make test-cli-docker
+
+  sample-graphs:
+    name: Sample Graphs
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup UV
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          enable-cache: true
+          cache-python: true
+          python-version: "3.12"
+
+      - name: Sync dependencies
+        run: uv sync --dev
+
+      - name: In-process sample graph validation
+        run: make test-samples
+
+  cli-dev-sample-graphs:
+    name: CLI Dev Sample Graphs
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    services:
+      mysql:
+        image: mysql:8.4
+        env:
+          MYSQL_ROOT_PASSWORD: root
+          MYSQL_DATABASE: seekdb
+        ports:
+          - 3306:3306
+        options: >-
+          --health-cmd="mysqladmin ping -h 127.0.0.1 -proot --silent"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=12
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup UV
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          enable-cache: true
+          cache-python: true
+          python-version: "3.12"
+
+      - name: Sync dependencies
+        run: uv sync --dev
+
+      - name: CLI dev smoke covers docs and Studio-style localhost auth
+        env:
+          OCEANBASE_HOST: 127.0.0.1
+          OCEANBASE_PORT: "3306"
+          OCEANBASE_USER: root
+          OCEANBASE_PASSWORD: root
+          OCEANBASE_DB_NAME: seekdb
+        run: uv run python scripts/test_cli_dev_studio_smoke.py
+
+      - name: Run sample graphs through agentseek-api dev
+        env:
+          MYSQL_HOST: 127.0.0.1
+          MYSQL_PORT: "3306"
+          MYSQL_USER: root
+          MYSQL_PASSWORD: root
+          MYSQL_DB: seekdb
+        run: make test-cli-dev-samples
+
+  mysql-family-checkpoint-validation:
+    name: MySQL-Family Checkpoint Validation
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    if: >-
+      github.event_name == 'pull_request' ||
+      github.ref_name == 'develop' ||
+      github.ref_name == 'main' ||
+      startsWith(github.ref_name, 'release/') ||
+      startsWith(github.ref_name, 'hotfix/')
+    strategy:
+      fail-fast: false
+      matrix:
+        backend:
+          - name: seekdb
+            docker_backend: seekdb
+            image: oceanbase/seekdb:latest
+            user: root
+            password: ""
+            port: "2881"
+            db_name: seekdb
+            url: mysql+aiomysql://root:@127.0.0.1:2881/seekdb
+          - name: oceanbase
+            docker_backend: oceanbase
+            image: oceanbase/oceanbase-ce:latest
+            mode: slim
+            user: root@test
+            password: ""
+            port: "2881"
+            db_name: seekdb
+            url: mysql+aiomysql://root%40test:@127.0.0.1:2881/seekdb
+          - name: mysql
+            docker_backend: mysql
+            image: mysql:8.4
+            user: root
+            password: root
+            port: "3306"
+            db_name: seekdb
+            url: mysql+aiomysql://root:root@127.0.0.1:3306/seekdb
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup UV
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          enable-cache: true
+          cache-python: true
+          python-version: "3.12"
+
+      - name: Sync dependencies
+        run: uv sync --dev
+
+      - name: MySQL-family checkpoint validation (${{ matrix.backend.name }})
+        env:
+          SEEKDB_MODE: docker
+          SEEKDB_DOCKER_BACKEND: ${{ matrix.backend.docker_backend }}
+          SEEKDB_DOCKER_IMAGE: ${{ matrix.backend.image }}
+          OCEANBASE_DOCKER_MODE: ${{ matrix.backend.mode || '' }}
+          OCEANBASE_USER: ${{ matrix.backend.user }}
+          OCEANBASE_PASSWORD: ${{ matrix.backend.password }}
+          OCEANBASE_PORT: ${{ matrix.backend.port }}
+          OCEANBASE_DB_NAME: ${{ matrix.backend.db_name }}
+          SEEKDB_URL: ${{ matrix.backend.url }}
+        run: make test-checkpoints
+
+  redis-durable-execution:
+    name: Redis Durable Execution (${{ matrix.backend.name }})
+    runs-on: ubuntu-latest
+    timeout-minutes: 40
+    if: >-
+      github.event_name == 'pull_request' ||
+      github.ref_name == 'develop' ||
+      github.ref_name == 'main' ||
+      startsWith(github.ref_name, 'release/') ||
+      startsWith(github.ref_name, 'hotfix/')
+    strategy:
+      fail-fast: false
+      matrix:
+        backend:
+          - name: seekdb
+            docker_backend: seekdb
+            image: oceanbase/seekdb:latest
+            user: root
+            password: ""
+            port: "2881"
+            db_name: seekdb
+          - name: oceanbase
+            docker_backend: oceanbase
+            image: oceanbase/oceanbase-ce:latest
+            mode: slim
+            user: root@test
+            password: ""
+            port: "2881"
+            db_name: seekdb
+          - name: mysql
+            docker_backend: mysql
+            image: mysql:8.4
+            user: root
+            password: root
+            port: "3306"
+            db_name: seekdb
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup UV
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          enable-cache: true
+          cache-python: true
+          python-version: "3.12"
+
+      - name: Sync dependencies
+        run: uv sync --dev
+
+      - name: Redis durable execution stack (${{ matrix.backend.name }})
+        env:
+          SEEKDB_DOCKER_BACKEND: ${{ matrix.backend.docker_backend }}
+          SEEKDB_DOCKER_IMAGE: ${{ matrix.backend.image }}
+          OCEANBASE_DOCKER_MODE: ${{ matrix.backend.mode || '' }}
+          OCEANBASE_USER: ${{ matrix.backend.user }}
+          OCEANBASE_PASSWORD: ${{ matrix.backend.password }}
+          OCEANBASE_PORT: ${{ matrix.backend.port }}
+          OCEANBASE_DB_NAME: ${{ matrix.backend.db_name }}
+        run: make test-redis-docker
+
+  pgsql-metadata-checkpoint-validation:
+    name: PostgreSQL Metadata + Checkpoint Validation
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    if: >-
+      github.event_name == 'pull_request' ||
+      github.ref_name == 'develop' ||
+      github.ref_name == 'main' ||
+      startsWith(github.ref_name, 'release/') ||
+      startsWith(github.ref_name, 'hotfix/')
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+          POSTGRES_DB: agentseek
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd "pg_isready -U postgres -d agentseek"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 6
+    strategy:
+      fail-fast: false
+      matrix:
+        backend:
+          - name: seekdb
+            docker_backend: seekdb
+            image: oceanbase/seekdb:latest
+            user: root
+            password: ""
+            port: "2881"
+            db_name: seekdb
+          - name: oceanbase
+            docker_backend: oceanbase
+            image: oceanbase/oceanbase-ce:latest
+            mode: slim
+            user: root@test
+            password: ""
+            port: "2881"
+            db_name: seekdb
+          - name: mysql
+            docker_backend: mysql
+            image: mysql:8.4
+            user: root
+            password: root
+            port: "3306"
+            db_name: seekdb
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup UV
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          enable-cache: true
+          cache-python: true
+          python-version: "3.12"
+
+      - name: Sync dependencies
+        run: uv sync --dev
+
+      - name: PostgreSQL metadata with checkpoint validation (${{ matrix.backend.name }})
+        env:
+          SEEKDB_MODE: docker
+          SEEKDB_DOCKER_BACKEND: ${{ matrix.backend.docker_backend }}
+          SEEKDB_DOCKER_IMAGE: ${{ matrix.backend.image }}
+          OCEANBASE_DOCKER_MODE: ${{ matrix.backend.mode || '' }}
+          OCEANBASE_USER: ${{ matrix.backend.user }}
+          OCEANBASE_PASSWORD: ${{ matrix.backend.password }}
+          OCEANBASE_PORT: ${{ matrix.backend.port }}
+          OCEANBASE_DB_NAME: ${{ matrix.backend.db_name }}
+          METADATA_DB_URL: postgresql://postgres:postgres@127.0.0.1:5432/agentseek
+          METADATA_DB_BACKEND: postgresql
+        run: make test-checkpoints

agentseek_api-0.0.1/.github/workflows/live-provider-streaming.yml

@@ -0,0 +1,160 @@
+name: Live Provider Streaming
+
+on:
+  workflow_dispatch:
+    inputs:
+      run_openai_compatible:
+        description: Run the OpenAI-compatible live provider suite
+        required: false
+        default: true
+        type: boolean
+      openai_model:
+        description: Optional override for the OpenAI-compatible model name
+        required: false
+        type: string
+      openai_base_url:
+        description: Optional override for the OpenAI-compatible base URL
+        required: false
+        type: string
+      run_anthropic_compatible:
+        description: Run the Anthropic-compatible live provider suite
+        required: false
+        default: true
+        type: boolean
+      anthropic_model:
+        description: Optional override for the Anthropic-compatible model name
+        required: false
+        type: string
+      anthropic_base_url:
+        description: Optional override for the Anthropic-compatible base URL
+        required: false
+        type: string
+      backend_tier:
+        description: Backend tier to run, or all four tiers
+        required: false
+        default: all
+        type: choice
+        options:
+          - all
+          - seekdb
+          - oceanbase
+          - mysql
+          - postgresql-metadata
+  schedule:
+    - cron: "0 3 * * *"
+
+permissions:
+  contents: read
+
+jobs:
+  prepare-matrix:
+    name: Prepare Matrix
+    runs-on: ubuntu-latest
+    outputs:
+      matrix: ${{ steps.matrix.outputs.matrix }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Build selected matrix
+        id: matrix
+        env:
+          BACKEND_TIER_INPUT: ${{ inputs.backend_tier || 'all' }}
+          RUN_OPENAI_COMPATIBLE: ${{ inputs.run_openai_compatible }}
+          RUN_ANTHROPIC_COMPATIBLE: ${{ inputs.run_anthropic_compatible }}
+        run: python3 scripts/build_live_provider_matrix.py
+
+  live-provider-suite:
+    name: ${{ matrix.provider_label }} / ${{ matrix.backend_name }}
+    needs: prepare-matrix
+    runs-on: ubuntu-latest
+    timeout-minutes: 75
+    strategy:
+      fail-fast: false
+      matrix: ${{ fromJson(needs.prepare-matrix.outputs.matrix) }}
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+          POSTGRES_DB: agentseek
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd "pg_isready -U postgres -d agentseek"
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 12
+    env:
+      LIVE_PROVIDER_KIND: ${{ matrix.provider_kind }}
+      LIVE_PROVIDER_REQUIRED: "1"
+      LIVE_OPENAI_COMPAT_MODEL: ${{ matrix.provider_kind == 'openai' && (inputs.openai_model != '' && inputs.openai_model || vars.OPENAI_COMPAT_MODEL) || '' }}
+      LIVE_OPENAI_COMPAT_BASE_URL: ${{ matrix.provider_kind == 'openai' && (inputs.openai_base_url != '' && inputs.openai_base_url || vars.OPENAI_COMPAT_BASE_URL) || '' }}
+      LIVE_OPENAI_COMPAT_API_KEY: ${{ matrix.provider_kind == 'openai' && secrets.OPENAI_COMPAT_API_KEY || '' }}
+      LIVE_ANTHROPIC_COMPAT_MODEL: ${{ matrix.provider_kind == 'anthropic' && (inputs.anthropic_model != '' && inputs.anthropic_model || vars.ANTHROPIC_COMPAT_MODEL) || '' }}
+      LIVE_ANTHROPIC_COMPAT_BASE_URL: ${{ matrix.provider_kind == 'anthropic' && (inputs.anthropic_base_url != '' && inputs.anthropic_base_url || vars.ANTHROPIC_COMPAT_BASE_URL) || '' }}
+      LIVE_ANTHROPIC_COMPAT_API_KEY: ${{ matrix.provider_kind == 'anthropic' && secrets.ANTHROPIC_COMPAT_API_KEY || '' }}
+      LIVE_PROVIDER_MATRIX_BACKEND: ${{ matrix.backend_name }}
+      SEEKDB_MODE: docker
+      SEEKDB_DOCKER_BACKEND: ${{ matrix.backend_name == 'oceanbase' && 'oceanbase' || matrix.backend_name == 'mysql' && 'mysql' || 'seekdb' }}
+      SEEKDB_DOCKER_IMAGE: ${{ matrix.backend_name == 'oceanbase' && 'oceanbase/oceanbase-ce:latest' || matrix.backend_name == 'mysql' && 'mysql:8.4' || 'oceanbase/seekdb:latest' }}
+      OCEANBASE_DOCKER_MODE: ${{ matrix.backend_name == 'oceanbase' && 'slim' || '' }}
+      OCEANBASE_HOST: 127.0.0.1
+      OCEANBASE_USER: ${{ matrix.backend_name == 'oceanbase' && 'root@test' || 'root' }}
+      OCEANBASE_PASSWORD: ${{ matrix.backend_name == 'mysql' && 'root' || '' }}
+      OCEANBASE_PORT: ${{ matrix.backend_name == 'mysql' && '3306' || '2881' }}
+      OCEANBASE_DB_NAME: seekdb
+      SEEKDB_URL: ${{ matrix.backend_name == 'oceanbase' && 'mysql+aiomysql://root%40test:@127.0.0.1:2881/seekdb' || matrix.backend_name == 'mysql' && 'mysql+aiomysql://root:root@127.0.0.1:3306/seekdb' || 'mysql+aiomysql://root:@127.0.0.1:2881/seekdb' }}
+      METADATA_DB_URL: ${{ matrix.backend_name == 'postgresql-metadata' && 'postgresql://postgres:postgres@127.0.0.1:5432/agentseek' || '' }}
+      METADATA_DB_BACKEND: ${{ matrix.backend_name == 'postgresql-metadata' && 'postgresql' || '' }}
+      LIVE_PROVIDER_CAPABILITIES: ${{ matrix.backend_name == 'mysql' && 'streaming,hitl' || matrix.backend_name == 'postgresql-metadata' && 'streaming,mcp' || 'streaming,store,mcp,hitl' }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup UV
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          enable-cache: true
+          cache-python: true
+          python-version: "3.12"
+
+      - name: Validate provider configuration
+        shell: bash
+        run: |
+          missing=()
+          if [[ "${LIVE_PROVIDER_KIND}" == "openai" ]]; then
+            for name in LIVE_PROVIDER_KIND LIVE_OPENAI_COMPAT_MODEL LIVE_OPENAI_COMPAT_BASE_URL LIVE_OPENAI_COMPAT_API_KEY; do
+              if [[ -z "${!name:-}" ]]; then
+                missing+=("$name")
+              fi
+            done
+          else
+            for name in LIVE_PROVIDER_KIND LIVE_ANTHROPIC_COMPAT_MODEL LIVE_ANTHROPIC_COMPAT_BASE_URL LIVE_ANTHROPIC_COMPAT_API_KEY; do
+              if [[ -z "${!name:-}" ]]; then
+                missing+=("$name")
+              fi
+            done
+          fi
+          if [[ ${#missing[@]} -gt 0 ]]; then
+            echo "::error::Missing live provider workflow config: ${missing[*]}"
+            exit 1
+          fi
+
+      - name: Sync dependencies
+        run: uv sync --dev
+
+      - name: Run live provider suite
+        run: bash ./scripts/test-live-provider.sh
+
+      - name: Upload live provider logs
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: live-provider-logs-${{ matrix.provider_kind }}-${{ matrix.backend_name }}
+          if-no-files-found: ignore
+          path: |
+            .tmp/e2e-server.log
+            /tmp/agentseek-live-provider-docker.log
+            /tmp/agentseek-live-provider-embed.log

agentseek_api-0.0.1/.github/workflows/release.yml

@@ -0,0 +1,83 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tooling
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build sdist and wheel
+        run: python -m build
+
+      - name: Check artifacts
+        run: twine check dist/*
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/agentseek-api
+    permissions:
+      id-token: write
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Attach artifacts to GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          if gh release view "${GITHUB_REF_NAME}" >/dev/null 2>&1; then
+            echo "Release ${GITHUB_REF_NAME} already exists (manual or prior run); uploading dist/*."
+            gh release upload "${GITHUB_REF_NAME}" dist/* --clobber
+          else
+            echo "No release found for ${GITHUB_REF_NAME}; creating one from README.md."
+            NOTES_FILE="$(mktemp)"
+            echo "AgentSeek API release ${GITHUB_REF_NAME}. See [README.md](README.md) for usage." > "${NOTES_FILE}"
+            gh release create "${GITHUB_REF_NAME}" \
+              --title "${GITHUB_REF_NAME}" \
+              --notes-file "${NOTES_FILE}" \
+              dist/*
+          fi

agentseek_api-0.0.1/.gitignore

@@ -0,0 +1,9 @@
+.DS_Store
+.coverage
+.agentseek/
+.pytest_cache/
+.tmp/
+.venv/
+__pycache__/
+*.pyc
+*.cover