use-agent-os 2026.7.14.post1__tar.gz

use_agent_os-2026.7.14.post1/.dockerignore

@@ -0,0 +1,62 @@
+# Build-context exclusions — keep the image small and reproducible.
+# Anything listed here never enters the build context sent to the daemon.
+
+# --- VCS + editor + hidden local state -------------------------------------
+.*
+.vscode
+.idea
+.DS_Store
+
+# --- Python runtime state ---------------------------------------------------
+__pycache__
+*.pyc
+*.pyo
+*.pyd
+.pytest_cache
+.ruff_cache
+.mypy_cache
+.coverage
+.coverage.*
+htmlcov
+.tox
+.nox
+
+# --- Virtualenvs ------------------------------------------------------------
+.venv
+venv
+env
+
+# --- Local data / logs / caches --------------------------------------------
+data
+logs
+*.log
+*.db
+*.db-journal
+*.db-wal
+*.db-shm
+
+# --- Docs + tests NOT needed inside the runtime image -----------------------
+tests
+docs
+scripts
+CHANGELOG.md
+KNOWN_LIMITATIONS.md
+
+# --- Install scripts (shipped at repo root for host-side install) ----------
+install.sh
+install.ps1
+
+# --- Secrets + local config (never shipped) --------------------------------
+.env
+.env.*
+*.pem
+*.key
+
+# --- Build artefacts --------------------------------------------------------
+dist
+build
+*.egg-info
+
+# --- CI / local tooling -----------------------------------------------------
+uv.lock
+.pre-commit-config.yaml

use_agent_os-2026.7.14.post1/.env.example

@@ -0,0 +1,19 @@
+# AgentOS API Keys
+# Copy this file to .env and fill in your keys:
+#   cp .env.example .env
+
+# Required — LLM provider (OpenRouter)
+OPENROUTER_API_KEY=
+
+# Optional — Brave Search API (auto-selected over DuckDuckGo when set)
+# Get a key at https://brave.com/search/api/
+BRAVE_SEARCH_API_KEY=
+
+# Optional — Web search network proxy.
+# Use this when Brave/DuckDuckGo endpoints are not reachable directly.
+# This affects web_search only; LLM provider proxy is configured separately.
+AGENTOS_GATEWAY_SEARCH_PROXY=
+
+# Optional — allow web_search providers to use HTTP_PROXY/HTTPS_PROXY when no
+# explicit search proxy is set. Defaults to false for predictable behavior.
+AGENTOS_GATEWAY_SEARCH_USE_ENV_PROXY=false

use_agent_os-2026.7.14.post1/.gitattributes

@@ -0,0 +1,7 @@
+*.sh text eol=lf
+
+# Bundled BGE ONNX export for memory local embedding (relocated from the
+# removed agentos_router v4 bundle).
+src/agentos/memory/models/bge_onnx/*.onnx filter=lfs diff=lfs merge=lfs -text
+src/agentos/memory/models/bge_onnx/*.json text eol=lf
+src/agentos/memory/models/bge_onnx/*.txt text eol=lf

use_agent_os-2026.7.14.post1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,65 @@
+name: Bug report
+description: Report a reproducible AgentOS defect
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Do not include credentials, provider tokens, account identifiers, local paths, or vulnerability details. Use SECURITY.md for suspected vulnerabilities.
+  - type: input
+    id: version
+    attributes:
+      label: AgentOS version or commit
+      description: Use the release version or commit hash where the issue occurs.
+      placeholder: "0.0.1 or commit hash"
+    validations:
+      required: true
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - CLI
+        - Gateway
+        - Web UI
+        - Provider integration
+        - Channel integration
+        - Memory
+        - Scheduler
+        - Tools
+        - Packaging or install
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Reproduction steps
+      description: Provide the smallest public reproduction you can share.
+      placeholder: |
+        1. Run ...
+        2. Configure ...
+        3. Observe ...
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+      description: Paste minimal sanitized output if it helps.
+    validations:
+      required: true
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      placeholder: "Windows 11, Python 3.12+, uv version"
+    validations:
+      required: true

use_agent_os-2026.7.14.post1/.github/ISSUE_TEMPLATE/config.yml

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

use_agent_os-2026.7.14.post1/.github/ISSUE_TEMPLATE/docs_report.yml

@@ -0,0 +1,45 @@
+name: Documentation issue
+description: Report missing, confusing, or outdated AgentOS documentation
+title: "[Docs]: "
+labels: ["documentation"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for improving AgentOS's docs. Do not include credentials, provider tokens, private transcripts, account identifiers, or sensitive local paths.
+  - type: input
+    id: page
+    attributes:
+      label: Page or section
+      description: Link the page, heading, or command example that needs work.
+      placeholder: "docs/quickstart.md, docs/features/memory.md, or a GitHub URL"
+    validations:
+      required: true
+  - type: dropdown
+    id: issue_type
+    attributes:
+      label: Issue type
+      options:
+        - Incorrect command or option
+        - Missing setup step
+        - Confusing explanation
+        - Missing feature guide
+        - Broken link
+        - Screenshot or UI mismatch
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: What is wrong or missing?
+      description: Describe what you expected to learn and where the documentation fell short.
+    validations:
+      required: true
+  - type: textarea
+    id: suggestion
+    attributes:
+      label: Suggested fix
+      description: If you know the correction, include the command, wording, or link that would help.
+    validations:
+      required: false

use_agent_os-2026.7.14.post1/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,44 @@
+name: Feature request
+description: Propose a focused AgentOS improvement
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: Describe the user-facing problem or workflow gap.
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed behavior
+      description: Describe the smallest behavior change that would solve the problem.
+    validations:
+      required: true
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - CLI
+        - Gateway
+        - Web UI
+        - Provider integration
+        - Channel integration
+        - Memory
+        - Scheduler
+        - Tools
+        - Packaging or install
+        - Documentation
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Note any simpler workaround or existing AgentOS behavior you tried.
+    validations:
+      required: false

use_agent_os-2026.7.14.post1/.github/pull_request_template.md

@@ -0,0 +1,7 @@
+## Summary
+
+What does this change and why?
+
+## Tests
+
+How was this verified? Include the commands you ran and their results.

use_agent_os-2026.7.14.post1/.github/scripts/classify-ci-changes.sh

@@ -0,0 +1,109 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+changed_files="${1:?usage: classify-ci-changes.sh <changed-files-list>}"
+output_file="${GITHUB_OUTPUT:?GITHUB_OUTPUT must be set}"
+
+docs_only=true
+runtime_changed=false
+test_changed=false
+ci_changed=false
+dependency_changed=false
+release_changed=false
+seen_file=false
+
+mark_runtime_changed() {
+  docs_only=false
+  runtime_changed=true
+}
+
+mark_test_changed() {
+  docs_only=false
+  test_changed=true
+}
+
+mark_ci_changed() {
+  docs_only=false
+  ci_changed=true
+}
+
+mark_dependency_changed() {
+  mark_runtime_changed
+  dependency_changed=true
+  release_changed=true
+}
+
+mark_release_changed() {
+  docs_only=false
+  release_changed=true
+}
+
+while IFS= read -r path || [[ -n "${path}" ]]; do
+  path="${path%$'\r'}"
+  [[ -z "${path}" ]] && continue
+  seen_file=true
+
+  case "${path}" in
+    .ci/run-all)
+      docs_only=false
+      runtime_changed=true
+      test_changed=true
+      ci_changed=true
+      dependency_changed=true
+      release_changed=true
+      ;;
+    pyproject.toml | uv.lock)
+      mark_dependency_changed
+      ;;
+    .github/workflows/wheelhouse-release.yml)
+      mark_ci_changed
+      mark_release_changed
+      ;;
+    .github/workflows/*)
+      mark_ci_changed
+      ;;
+    .github/scripts/*)
+      mark_ci_changed
+      ;;
+    tests/test_scripts/test_build_wheelhouse_zip.py | tests/test_install_scripts.py | tests/test_root_start_scripts.py | tests/test_release_consistency.py | tests/test_public_release_hygiene.py)
+      mark_test_changed
+      mark_release_changed
+      ;;
+    tests/*)
+      mark_test_changed
+      ;;
+    scripts/build_wheelhouse_zip.py | scripts/install_source.sh | scripts/install_source.ps1)
+      mark_runtime_changed
+      mark_release_changed
+      ;;
+    install.sh | install.ps1 | start.sh | start.ps1 | README.release.md | RELEASES.md)
+      mark_release_changed
+      ;;
+    src/* | scripts/* | migrations/*)
+      mark_runtime_changed
+      ;;
+    docs/* | README.md | README.*.md | CHANGELOG.md | CODE_OF_CONDUCT.md | CONTRIBUTING.md | MIGRATION.md | SECURITY.md | SUPPORT.md | THIRD_PARTY_NOTICES.md | .github/pull_request_template.md | .github/ISSUE_TEMPLATE/*)
+      ;;
+    *)
+      mark_runtime_changed
+      ;;
+  esac
+done < "${changed_files}"
+
+if [[ "${seen_file}" == "false" ]]; then
+  docs_only=false
+  runtime_changed=true
+  test_changed=true
+  ci_changed=true
+  dependency_changed=true
+  release_changed=true
+fi
+
+{
+  printf 'docs_only=%s\n' "${docs_only}"
+  printf 'runtime_changed=%s\n' "${runtime_changed}"
+  printf 'test_changed=%s\n' "${test_changed}"
+  printf 'ci_changed=%s\n' "${ci_changed}"
+  printf 'dependency_changed=%s\n' "${dependency_changed}"
+  printf 'release_changed=%s\n' "${release_changed}"
+} >> "${output_file}"

use_agent_os-2026.7.14.post1/.github/workflows/ci.yml

@@ -0,0 +1,290 @@
+name: CI
+
+"on":
+  pull_request:
+  push:
+    branches: [main, dev]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  classify-changes:
+    name: Classify changed files
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    outputs:
+      docs_only: ${{ steps.classify.outputs.docs_only }}
+      runtime_changed: ${{ steps.classify.outputs.runtime_changed }}
+      test_changed: ${{ steps.classify.outputs.test_changed }}
+      ci_changed: ${{ steps.classify.outputs.ci_changed }}
+      dependency_changed: ${{ steps.classify.outputs.dependency_changed }}
+      release_changed: ${{ steps.classify.outputs.release_changed }}
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: List changed files
+        shell: bash
+        run: |
+          set -euo pipefail
+          changed_files="${RUNNER_TEMP}/changed-files.txt"
+
+          case "${{ github.event_name }}" in
+            pull_request)
+              git diff --name-only \
+                "${{ github.event.pull_request.base.sha }}" \
+                "${{ github.event.pull_request.head.sha }}" > "${changed_files}"
+              ;;
+            push)
+              printf '.ci/run-all\n' > "${changed_files}"
+              ;;
+            *)
+              printf '.ci/run-all\n' > "${changed_files}"
+              ;;
+          esac
+
+          echo "Changed files:"
+          sed 's/^/  /' "${changed_files}"
+          printf 'CHANGED_FILES=%s\n' "${changed_files}" >> "${GITHUB_ENV}"
+
+      - name: Classify changed files
+        id: classify
+        shell: bash
+        run: bash .github/scripts/classify-ci-changes.sh "${CHANGED_FILES}"
+
+  workflow-lint:
+    name: Validate GitHub Actions workflows
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Run actionlint
+        run: go run github.com/rhysd/actionlint/cmd/actionlint@v1.7.12 -color=false
+
+  ubuntu-quality:
+    name: Lint, test, and build (ubuntu-latest, 3.12)
+    needs: classify-changes
+    if: needs.classify-changes.outputs.docs_only != 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    env:
+      UV_PYTHON: "3.12"
+      PYTHONPATH: ${{ github.workspace }}
+      AGENTOS_TURN_CALL_LOG: "0"
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          lfs: true
+
+      - name: Configure runtime directories
+        shell: bash
+        run: |
+          printf 'AGENTOS_STATE_DIR=%s/agentos-state\n' "$RUNNER_TEMP" >> "$GITHUB_ENV"
+          printf 'AGENTOS_LOG_DIR=%s/agentos-logs\n' "$RUNNER_TEMP" >> "$GITHUB_ENV"
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        shell: bash
+        run: uv sync --extra dev --extra recommended --extra mcp --frozen
+
+      - name: Lint
+        shell: bash
+        run: uv run ruff check src tests
+
+      - name: Type check
+        shell: bash
+        run: uv run mypy src/agentos --show-error-codes
+
+      - name: Test
+        shell: bash
+        run: uv run pytest tests -q
+
+      - name: Verify metric counter names unchanged
+        shell: bash
+        run: |
+          set -e
+          for name in agentos_queue_depth in_flight_turns_total turn_cancellations_total queue_full_errors_total; do
+            count=$(grep -c "$name" src/agentos/gateway/task_runtime.py || echo 0)
+            if [ "$count" -lt 1 ]; then
+              echo "ERROR: metric name '$name' missing from task_runtime.py"
+              exit 1
+            fi
+          done
+
+      - name: tracemalloc leak smoke test
+        shell: bash
+        run: |
+          uv run python -m pytest tests/test_gateway/test_task_runtime_terminal_cleanup.py::test_no_leak_under_load -v
+
+      - name: Build wheel
+        shell: bash
+        run: uv build --wheel
+
+  windows-compat:
+    name: Lint, test, and build (windows-latest, 3.12)
+    needs: classify-changes
+    if: needs.classify-changes.outputs.docs_only != 'true'
+    runs-on: windows-latest
+    timeout-minutes: 20
+
+    env:
+      UV_PYTHON: "3.12"
+      PYTHONPATH: ${{ github.workspace }}
+      AGENTOS_TURN_CALL_LOG: "0"
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          lfs: true
+
+      - name: Configure runtime directories
+        shell: bash
+        run: |
+          printf 'AGENTOS_STATE_DIR=%s/agentos-state\n' "$RUNNER_TEMP" >> "$GITHUB_ENV"
+          printf 'AGENTOS_LOG_DIR=%s/agentos-logs\n' "$RUNNER_TEMP" >> "$GITHUB_ENV"
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        shell: bash
+        run: uv sync --extra dev --extra recommended --extra mcp --frozen
+
+      - name: Test
+        shell: bash
+        run: uv run pytest tests -q
+
+  release-packaging:
+    name: Release packaging contracts
+    needs: classify-changes
+    if: needs.classify-changes.outputs.release_changed == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    env:
+      UV_PYTHON: "3.12"
+      PYTHONPATH: ${{ github.workspace }}
+      AGENTOS_TURN_CALL_LOG: "0"
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          lfs: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install dependencies
+        shell: bash
+        run: uv sync --extra dev --extra recommended --extra mcp --frozen
+
+      - name: Run release packaging contract tests
+        shell: bash
+        run: |
+          uv run pytest \
+            tests/test_scripts/test_build_wheelhouse_zip.py \
+            tests/test_install_scripts.py \
+            tests/test_root_start_scripts.py \
+            tests/test_release_consistency.py \
+            tests/test_public_release_hygiene.py \
+            -q
+
+  ci-result:
+    name: CI result
+    needs:
+      - classify-changes
+      - workflow-lint
+      - ubuntu-quality
+      - windows-compat
+      - release-packaging
+    if: always()
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Check required CI results
+        shell: bash
+        run: |
+          set -euo pipefail
+
+          classify_result="${{ needs.classify-changes.result }}"
+          workflow_lint_result="${{ needs.workflow-lint.result }}"
+          ubuntu_result="${{ needs.ubuntu-quality.result }}"
+          windows_result="${{ needs.windows-compat.result }}"
+          release_result="${{ needs.release-packaging.result }}"
+          docs_only="${{ needs.classify-changes.outputs.docs_only }}"
+          runtime_changed="${{ needs.classify-changes.outputs.runtime_changed }}"
+          test_changed="${{ needs.classify-changes.outputs.test_changed }}"
+          ci_changed="${{ needs.classify-changes.outputs.ci_changed }}"
+          dependency_changed="${{ needs.classify-changes.outputs.dependency_changed }}"
+          release_changed="${{ needs.classify-changes.outputs.release_changed }}"
+
+          printf 'classify-changes: %s\n' "${classify_result}"
+          printf 'workflow-lint: %s\n' "${workflow_lint_result}"
+          printf 'ubuntu-quality: %s\n' "${ubuntu_result}"
+          printf 'windows-compat: %s\n' "${windows_result}"
+          printf 'release-packaging: %s\n' "${release_result}"
+          printf 'docs_only=%s runtime_changed=%s test_changed=%s ci_changed=%s dependency_changed=%s release_changed=%s\n' \
+            "${docs_only}" "${runtime_changed}" "${test_changed}" "${ci_changed}" "${dependency_changed}" "${release_changed}"
+
+          if [[ "${classify_result}" != "success" ]]; then
+            echo "Classify changed files must succeed."
+            exit 1
+          fi
+
+          if [[ "${workflow_lint_result}" != "success" ]]; then
+            echo "Workflow lint must succeed."
+            exit 1
+          fi
+
+          if [[ "${docs_only}" != "true" && "${ubuntu_result}" != "success" ]]; then
+            echo "Ubuntu quality gate must succeed for non-documentation changes."
+            exit 1
+          fi
+
+          if [[ "${docs_only}" != "true" && "${windows_result}" != "success" ]]; then
+            echo "Windows compatibility tests must succeed for non-documentation changes."
+            exit 1
+          fi
+
+          if [[ "${release_changed}" == "true" && "${release_result}" != "success" ]]; then
+            echo "Release packaging contracts must succeed for release-surface changes."
+            exit 1
+          fi