bos-ai 0.0.0__tar.gz

bos_ai-0.0.0/.dockerignore

@@ -0,0 +1,10 @@
+.git
+.github
+.local
+.omx
+.pytest_cache
+.ruff_cache
+.venv
+__pycache__
+dist
+tests

bos_ai-0.0.0/.github/workflows/pr-title.yml

@@ -0,0 +1,31 @@
+name: "PR Title Checker"
+
+on:
+  pull_request:
+    types:
+      - opened
+      - edited
+      - synchronize
+
+permissions:
+  contents: read
+  pull-requests: read
+
+jobs:
+  main:
+    name: Validate PR title
+    runs-on: ubuntu-latest
+    steps:
+      - uses: amannn/action-semantic-pull-request@v5
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          # Ensure PR titles follow conventional commits
+          # Example valid titles:
+          #   feat: added a new cli command
+          #   fix: resolved crash on startup
+          #   docs: updated readme
+          requireScope: false
+          subjectPattern: ^(?![A-Z]).+$
+          subjectPatternError: |
+            The subject (description) of the PR title must start with a lowercase letter.

bos_ai-0.0.0/.github/workflows/release.yml

@@ -0,0 +1,71 @@
+name: Release
+on:
+  workflow_dispatch:
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+  release:
+    if: github.ref == 'refs/heads/main'
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write       # Required for PyPI OIDC Trusted Publishing
+      contents: write       # Required for PSR to push commits/tags
+      packages: write       # Required to push container images to GHCR
+    
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0      # PSR needs full history to calculate versions
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: "pyproject.toml"
+
+      - name: Python Semantic Release
+        id: release
+        uses: python-semantic-release/python-semantic-release@v10.5.3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          verbosity: 1
+
+      # Publish to PyPI ONLY IF a new release was actually generated
+      - name: Publish package distributions to PyPI
+        if: steps.release.outputs.released == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Set up Docker Buildx
+        if: steps.release.outputs.released == 'true'
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GHCR
+        if: steps.release.outputs.released == 'true'
+        uses: docker/login-action@v3
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract Docker metadata
+        if: steps.release.outputs.released == 'true'
+        id: docker_meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+          tags: |
+            type=raw,value=${{ steps.release.outputs.version }}
+            type=raw,value=${{ steps.release.outputs.tag }}
+            type=raw,value=latest,enable=${{ steps.release.outputs.is_prerelease != 'true' }}
+
+      - name: Build and push Docker image to GHCR
+        if: steps.release.outputs.released == 'true'
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.docker_meta.outputs.tags }}
+          labels: ${{ steps.docker_meta.outputs.labels }}

bos_ai-0.0.0/.gitignore

@@ -0,0 +1,217 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+# uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .local directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.local
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
+#   that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer,
+#   you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml
+.omx/

bos_ai-0.0.0/AGENTS.md

@@ -0,0 +1,34 @@
+# Repository Guidance
+
+This `AGENTS.md` applies to the entire repository.
+
+## Toolchain
+
+- Use `uv run ...` for Python entrypoints, tests, and linting.
+- The project targets Python `>=3.13` via [pyproject.toml](/Users/jerry/Repo/workbench/bos-ai/pyproject.toml).
+- Do not assume the system `python3` is suitable. On this machine it is older and can fail on `tomllib`.
+- When you need the CLI locally, prefer `uv run bos ...`.
+
+## Common Commands
+
+- Run the full test suite: `uv run pytest -q`
+- Run a focused test file: `uv run pytest -q tests/test_workspace_runtime.py`
+- Run lint: `uv run ruff check src tests`
+- Run the CLI help: `uv run bos --help`
+
+## Repo Layout
+
+- `src/bos/config`: workspace discovery and TOML-backed config loading
+- `src/bos/core`: runtime primitives, contracts, harness, agent loop
+- `src/bos/extensions`: channels, tools, stores, and other extension implementations
+- `src/bos/runner`: runtime assembly and process/container lifecycle
+- `src/bos/protocol`: shared message contracts
+- `tests`: pytest coverage for config, runner, channels, harness, and CLI behavior
+
+## Working Notes
+
+- Keep package boundaries explicit. If you change config loading behavior, check whether `README.md` and `docs/architecture/*.md` also need updates.
+- Prefer small, reversible diffs and extend existing patterns before adding new abstractions.
+- If a change touches config/runtime behavior, add or update targeted pytest coverage in `tests/`.
+- `uv run ruff check src tests` is a useful signal, but the repo may already contain unrelated lint findings. Do not assume a lint failure came from your change without checking the reported files.
+- Pull request titles must follow semantic/conventional format, for example `feat(config): ...` or `fix(runner): ...`, because GitHub Actions validate the PR title.

bos_ai-0.0.0/CHANGELOG.md

@@ -0,0 +1,97 @@
+# CHANGELOG
+
+<!-- version list -->
+
+## v0.0.0 (2026-04-27)
+
+
+## v0.2.0 (2026-04-27)
+
+### Bug Fixes
+
+- **config**: Anchor broadcast state under bos dir
+  ([#18](https://github.com/bos-agent/bos-ai/pull/18),
+  [`50879ab`](https://github.com/bos-agent/bos-ai/commit/50879ab3e458f607b5813c2e6fe711874be9f7fc))
+
+### Build System
+
+- **release**: Upgrade semantic-release v10 and tighten top-level docs
+  ([#8](https://github.com/bos-agent/bos-ai/pull/8),
+  [`d16da5c`](https://github.com/bos-agent/bos-ai/commit/d16da5cfef0a657a619d78940baa43f7279562e3))
+
+### Chores
+
+- Remove local OMX planning artifacts ([#18](https://github.com/bos-agent/bos-ai/pull/18),
+  [`50879ab`](https://github.com/bos-agent/bos-ai/commit/50879ab3e458f607b5813c2e6fe711874be9f7fc))
+
+### Documentation
+
+- **agents**: Require semantic PR titles ([#14](https://github.com/bos-agent/bos-ai/pull/14),
+  [`16fb4fb`](https://github.com/bos-agent/bos-ai/commit/16fb4fbb268053b31ee460bdfdf142c7c1e99aca))
+
+### Features
+
+- Enable image-first multimodal transport ([#12](https://github.com/bos-agent/bos-ai/pull/12),
+  [`78d02bc`](https://github.com/bos-agent/bos-ai/commit/78d02bc5c7a9d4ea8a96de9107db61405fcdca00))
+
+- Make turn events an explicit runtime output for frontend to consume
+  ([#11](https://github.com/bos-agent/bos-ai/pull/11),
+  [`5a4e2cb`](https://github.com/bos-agent/bos-ai/commit/5a4e2cb73b32f06b9e795fa54858a25aaecda57d))
+
+- **channel**: Support resumable multi-client HTTP sessions
+  ([#18](https://github.com/bos-agent/bos-ai/pull/18),
+  [`50879ab`](https://github.com/bos-agent/bos-ai/commit/50879ab3e458f607b5813c2e6fe711874be9f7fc))
+
+- **config**: Inject workspace context into channels
+  ([#18](https://github.com/bos-agent/bos-ai/pull/18),
+  [`50879ab`](https://github.com/bos-agent/bos-ai/commit/50879ab3e458f607b5813c2e6fe711874be9f7fc))
+
+- **config**: Refine BOS config loading and add explicit external agent definitions
+  ([#14](https://github.com/bos-agent/bos-ai/pull/14),
+  [`16fb4fb`](https://github.com/bos-agent/bos-ai/commit/16fb4fbb268053b31ee460bdfdf142c7c1e99aca))
+
+### Refactoring
+
+- **agent**: Make system_prompt string-only ([#16](https://github.com/bos-agent/bos-ai/pull/16),
+  [`6b3dbf8`](https://github.com/bos-agent/bos-ai/commit/6b3dbf898f3202107fac00a58ef6a6becb55b246))
+
+- **channel**: Unify actor-owned session resets and interactive channel takeover
+  ([#13](https://github.com/bos-agent/bos-ai/pull/13),
+  [`221047b`](https://github.com/bos-agent/bos-ai/commit/221047b18ba2edb5dd6d6df5f9fafbc439f2ecf5))
+
+- **config**: Resolve broadcast channel state options
+  ([#18](https://github.com/bos-agent/bos-ai/pull/18),
+  [`50879ab`](https://github.com/bos-agent/bos-ai/commit/50879ab3e458f607b5813c2e6fe711874be9f7fc))
+
+- **core**: Align interceptor APIs with turn terminology
+  ([#16](https://github.com/bos-agent/bos-ai/pull/16),
+  [`6b3dbf8`](https://github.com/bos-agent/bos-ai/commit/6b3dbf898f3202107fac00a58ef6a6becb55b246))
+
+- **core**: Rename conversations to chats ([#19](https://github.com/bos-agent/bos-ai/pull/19),
+  [`e5e8048`](https://github.com/bos-agent/bos-ai/commit/e5e8048167143595f4b2e948da413e7eb52f469e))
+
+- **harness**: Default agent mode. exam subagent orchstration.
+  ([#9](https://github.com/bos-agent/bos-ai/pull/9),
+  [`abd3c1c`](https://github.com/bos-agent/bos-ai/commit/abd3c1c06eba4922355b625672b7ef068c9b7b2a))
+
+
+## v0.1.0 (2026-04-19)
+
+### Features
+
+- mailbox redesign to mailroute + mailbox bound with address ([#5](https://github.com/bos-agent/bos-ai/pull/5), [`fb7dc69`](https://github.com/bos-agent/bos-ai/commit/fb7dc695f2d2c77d5bde4c09be0ec1b78d8f5980))
+- run agent in docker container ([`ba19b7a`](https://github.com/bos-agent/bos-ai/commit/ba19b7a2807e4610653456c174cf168fa7aa84c6))
+- run agentactor as a standalone process. support channels of http and telegram ([#3](https://github.com/bos-agent/bos-ai/pull/3), [`bcecf00`](https://github.com/bos-agent/bos-ai/commit/bcecf00c17c22a4f3c3d55512fbd422978da6c95))
+
+### Bug Fixes
+
+- skill loader and other bugs fix. update on the config template ([#2](https://github.com/bos-agent/bos-ai/pull/2), [`493864c`](https://github.com/bos-agent/bos-ai/commit/493864c57a28247949cb8df1643860bdc9b86265))
+
+### Refactoring
+
+- make channel routing explicit and stabilize primary actor address ([#6](https://github.com/bos-agent/bos-ai/pull/6), [`90573da`](https://github.com/bos-agent/bos-ai/commit/90573daf492aa5f505be8fc260ee3b3188d17a23))
+- **core**: code structure deep refactoring ([#4](https://github.com/bos-agent/bos-ai/pull/4), [`daea7d2`](https://github.com/bos-agent/bos-ai/commit/daea7d24c7ff0a2630c14d602b661299b23a48fd))
+
+### Chores
+
+- setup PSR and github flow ([#1](https://github.com/bos-agent/bos-ai/pull/1), [`1bcb8e2`](https://github.com/bos-agent/bos-ai/commit/1bcb8e2a2c68d63ad145b33aee4d6a45b9149d41))

bos_ai-0.0.0/Dockerfile

@@ -0,0 +1,37 @@
+FROM ghcr.io/astral-sh/uv:latest AS uv
+
+FROM node:22-bookworm-slim AS node
+
+FROM python:3.13-slim
+
+ENV DEBIAN_FRONTEND=noninteractive \
+    PIP_DISABLE_PIP_VERSION_CHECK=1 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONUNBUFFERED=1
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends \
+        ca-certificates \
+        tini \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY --from=uv /uv /usr/local/bin/uv
+COPY --from=uv /uvx /usr/local/bin/uvx
+COPY --from=node /usr/local/bin/node /usr/local/bin/node
+COPY --from=node /usr/local/lib/node_modules /usr/local/lib/node_modules
+
+RUN ln -s /usr/local/lib/node_modules/npm/bin/npm-cli.js /usr/local/bin/npm \
+    && ln -s /usr/local/lib/node_modules/npm/bin/npx-cli.js /usr/local/bin/npx \
+    && ln -s /usr/local/lib/node_modules/corepack/dist/corepack.js /usr/local/bin/corepack
+
+WORKDIR /app
+
+COPY LICENSE README.md pyproject.toml uv.lock /app/
+COPY src /app/src
+
+RUN python -m pip install --no-cache-dir .
+
+WORKDIR /workspace
+
+ENTRYPOINT ["tini", "--", "python", "-m", "bos.runner._main"]
+CMD ["--workspace", "/workspace"]

bos_ai-0.0.0/LICENSE

@@ -0,0 +1,24 @@
+BSD 2-Clause License
+
+Copyright (c) 2024-2026, bos-ai contributors
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.