ya-agent-platform 0.58.3__tar.gz

ya_agent_platform-0.58.3/.gitignore

@@ -0,0 +1,153 @@
+docs/source
+
+# From https://raw.githubusercontent.com/github/gitignore/main/Python.gitignore
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$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
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.pyright/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# Vscode config files
+# .vscode/
+
+# 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/
+
+TO-DO.json
+dev/
+ya_agent_sdk/sandbox/shell/templates/public
+
+# Sync automaticlly
+yaacli/yaacli/skills/building-agents
+
+# Frontend
+node_modules/
+apps/*/dist/
+*.tsbuildinfo

ya_agent_platform-0.58.3/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: ya-agent-platform
+Version: 0.58.3
+Summary: Cloud-ready agent platform built on top of ya-agent-sdk
+Project-URL: Repository, https://github.com/wh1isper/ya-mono
+Author-email: wh1isper <jizhongsheng957@gmail.com>
+Keywords: agent-platform,ai-agent,fastapi,python
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <3.14,>=3.11
+Requires-Dist: alembic>=1.16.0
+Requires-Dist: click>=8.0
+Requires-Dist: fastapi>=0.116.0
+Requires-Dist: psycopg[binary]>=3.2.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.12.0
+Requires-Dist: redis[hiredis]>=6.0.0
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: sse-starlette>=3.0.0
+Requires-Dist: uvicorn[standard]>=0.35.0
+Requires-Dist: ya-agent-sdk[all]==0.58.3
+Description-Content-Type: text/markdown
+
+# YA Agent Platform
+
+Cloud-ready agent platform package for the `ya-mono` workspace.
+
+## Scope
+
+This package initializes the backend service for a complete agent platform:
+
+- management API for platform and workspace administration
+- chat-facing API for first-party Chat UI
+- bridge-facing API surface for IM connectors
+- runtime integration points for `ya-agent-sdk`
+- persistence scaffold with PostgreSQL, Redis, packaged Alembic migrations, and startup auto-migration
+- specification documents that define the target architecture before full implementation
+
+## Current Layout
+
+```text
+packages/ya-agent-platform/
+├── README.md
+├── infra/
+│   ├── dev.env
+│   └── docker-compose.dev.yml
+├── pyproject.toml
+├── spec/
+├── start.sh
+├── tests/
+└── ya_agent_platform/
+    ├── alembic/
+    ├── alembic.ini
+    ├── api/
+    ├── app.py
+    ├── cli.py
+    ├── config.py
+    ├── db/
+    └── redis.py
+```
+
+## Quick Start
+
+From the workspace root:
+
+```bash
+uv sync --all-packages
+make platform-infra-up
+set -a && source packages/ya-agent-platform/infra/dev.env && set +a
+uv run --package ya-agent-platform ya-agent-platform serve --reload
+```
+
+The development server listens on `http://127.0.0.1:9042` by default.
+
+## Database and Redis Commands
+
+Use the package CLI directly:
+
+```bash
+uv run --package ya-agent-platform ya-agent-platform migrate
+uv run --package ya-agent-platform ya-agent-platform db current
+uv run --package ya-agent-platform ya-agent-platform db history
+uv run --package ya-agent-platform ya-agent-platform db migrate "add workspace tables"
+```
+
+Use the workspace Makefile wrappers:
+
+```bash
+make platform-db-upgrade
+make platform-db-current
+make platform-db-history
+make platform-db-migrate MSG="add workspace tables"
+```
+
+## Auto Migration
+
+`YA_PLATFORM_AUTO_MIGRATE=true` is the default behavior.
+
+- `ya-agent-platform serve` applies migrations before boot when `YA_PLATFORM_DATABASE_URL` is configured
+- `ya-agent-platform migrate` runs migrations separately
+- `start.sh` applies migrations before starting the server in container environments
+
+## Development Infrastructure
+
+The dev compose file starts PostgreSQL and Redis:
+
+```bash
+make platform-infra-up
+make platform-infra-status
+make platform-infra-down
+```
+
+Default development URLs live in `packages/ya-agent-platform/infra/dev.env`.
+
+## Combined Docker Image
+
+The repository root `Dockerfile` builds a single production image that contains:
+
+- the `ya-agent-platform` backend
+- the bundled `ya-agent-platform-web` frontend
+- FastAPI static serving for the built web assets
+- startup auto-migration support through `packages/ya-agent-platform/start.sh`
+
+Build locally from the repository root:
+
+```bash
+docker build -t ya-agent-platform:dev .
+```
+
+Run locally:
+
+```bash
+docker run --rm -p 9042:9042 ya-agent-platform:dev
+```
+
+The container serves the combined application on `http://127.0.0.1:9042`.
+
+## Initial API Surface
+
+- `GET /healthz` — service health probe with postgres and redis component status
+- `GET /api/v1/platform/info` — platform metadata and enabled surfaces
+- `GET /api/v1/platform/topology` — high-level component topology for the UI and tooling
+
+## Specification Set
+
+- [`spec/README.md`](spec/README.md)
+- [`spec/000-platform-overview.md`](spec/000-platform-overview.md)
+- [`spec/001-system-architecture.md`](spec/001-system-architecture.md)
+- [`spec/002-bridge-contract.md`](spec/002-bridge-contract.md)
+- [`spec/003-http-api.md`](spec/003-http-api.md)
+
+## Next Build Phase
+
+1. add persistence models and first migrations
+2. add runtime orchestration and worker execution
+3. add bridge registry and delivery guarantees
+4. connect the web app to live platform endpoints

ya_agent_platform-0.58.3/README.md

@@ -0,0 +1,134 @@
+# YA Agent Platform
+
+Cloud-ready agent platform package for the `ya-mono` workspace.
+
+## Scope
+
+This package initializes the backend service for a complete agent platform:
+
+- management API for platform and workspace administration
+- chat-facing API for first-party Chat UI
+- bridge-facing API surface for IM connectors
+- runtime integration points for `ya-agent-sdk`
+- persistence scaffold with PostgreSQL, Redis, packaged Alembic migrations, and startup auto-migration
+- specification documents that define the target architecture before full implementation
+
+## Current Layout
+
+```text
+packages/ya-agent-platform/
+├── README.md
+├── infra/
+│   ├── dev.env
+│   └── docker-compose.dev.yml
+├── pyproject.toml
+├── spec/
+├── start.sh
+├── tests/
+└── ya_agent_platform/
+    ├── alembic/
+    ├── alembic.ini
+    ├── api/
+    ├── app.py
+    ├── cli.py
+    ├── config.py
+    ├── db/
+    └── redis.py
+```
+
+## Quick Start
+
+From the workspace root:
+
+```bash
+uv sync --all-packages
+make platform-infra-up
+set -a && source packages/ya-agent-platform/infra/dev.env && set +a
+uv run --package ya-agent-platform ya-agent-platform serve --reload
+```
+
+The development server listens on `http://127.0.0.1:9042` by default.
+
+## Database and Redis Commands
+
+Use the package CLI directly:
+
+```bash
+uv run --package ya-agent-platform ya-agent-platform migrate
+uv run --package ya-agent-platform ya-agent-platform db current
+uv run --package ya-agent-platform ya-agent-platform db history
+uv run --package ya-agent-platform ya-agent-platform db migrate "add workspace tables"
+```
+
+Use the workspace Makefile wrappers:
+
+```bash
+make platform-db-upgrade
+make platform-db-current
+make platform-db-history
+make platform-db-migrate MSG="add workspace tables"
+```
+
+## Auto Migration
+
+`YA_PLATFORM_AUTO_MIGRATE=true` is the default behavior.
+
+- `ya-agent-platform serve` applies migrations before boot when `YA_PLATFORM_DATABASE_URL` is configured
+- `ya-agent-platform migrate` runs migrations separately
+- `start.sh` applies migrations before starting the server in container environments
+
+## Development Infrastructure
+
+The dev compose file starts PostgreSQL and Redis:
+
+```bash
+make platform-infra-up
+make platform-infra-status
+make platform-infra-down
+```
+
+Default development URLs live in `packages/ya-agent-platform/infra/dev.env`.
+
+## Combined Docker Image
+
+The repository root `Dockerfile` builds a single production image that contains:
+
+- the `ya-agent-platform` backend
+- the bundled `ya-agent-platform-web` frontend
+- FastAPI static serving for the built web assets
+- startup auto-migration support through `packages/ya-agent-platform/start.sh`
+
+Build locally from the repository root:
+
+```bash
+docker build -t ya-agent-platform:dev .
+```
+
+Run locally:
+
+```bash
+docker run --rm -p 9042:9042 ya-agent-platform:dev
+```
+
+The container serves the combined application on `http://127.0.0.1:9042`.
+
+## Initial API Surface
+
+- `GET /healthz` — service health probe with postgres and redis component status
+- `GET /api/v1/platform/info` — platform metadata and enabled surfaces
+- `GET /api/v1/platform/topology` — high-level component topology for the UI and tooling
+
+## Specification Set
+
+- [`spec/README.md`](spec/README.md)
+- [`spec/000-platform-overview.md`](spec/000-platform-overview.md)
+- [`spec/001-system-architecture.md`](spec/001-system-architecture.md)
+- [`spec/002-bridge-contract.md`](spec/002-bridge-contract.md)
+- [`spec/003-http-api.md`](spec/003-http-api.md)
+
+## Next Build Phase
+
+1. add persistence models and first migrations
+2. add runtime orchestration and worker execution
+3. add bridge registry and delivery guarantees
+4. connect the web app to live platform endpoints

ya_agent_platform-0.58.3/infra/dev.env

@@ -0,0 +1,7 @@
+# YA Agent Platform dev environment variables
+# Source this file or pass to your shell: set -a && source packages/ya-agent-platform/infra/dev.env && set +a
+
+YA_PLATFORM_DATABASE_URL=postgresql+psycopg://ya_platform:ya_platform@localhost:15433/ya_platform
+YA_PLATFORM_REDIS_URL=redis://localhost:16380/0
+YA_PLATFORM_AUTO_MIGRATE=true
+YA_PLATFORM_RELOAD=true

ya_agent_platform-0.58.3/infra/docker-compose.dev.yml

@@ -0,0 +1,34 @@
+services:
+  postgres:
+    image: postgres:17
+    container_name: ya-agent-platform-postgres
+    environment:
+      POSTGRES_USER: ya_platform
+      POSTGRES_PASSWORD: ya_platform
+      POSTGRES_DB: ya_platform
+    ports:
+      - "15433:5432"
+    volumes:
+      - ya-agent-platform-pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ya_platform -d ya_platform"]
+      interval: 5s
+      timeout: 3s
+      retries: 10
+
+  redis:
+    image: redis:7
+    container_name: ya-agent-platform-redis
+    ports:
+      - "16380:6379"
+    volumes:
+      - ya-agent-platform-redisdata:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 5s
+      timeout: 3s
+      retries: 10
+
+volumes:
+  ya-agent-platform-pgdata:
+  ya-agent-platform-redisdata:

ya_agent_platform-0.58.3/pyproject.toml

@@ -0,0 +1,78 @@
+[project]
+name = "ya-agent-platform"
+dynamic = ["version", "dependencies"]
+description = "Cloud-ready agent platform built on top of ya-agent-sdk"
+authors = [{ name = "wh1isper", email = "jizhongsheng957@gmail.com" }]
+readme = "README.md"
+keywords = ["python", "fastapi", "agent-platform", "ai-agent"]
+requires-python = ">=3.11,<3.14"
+classifiers = [
+    "Intended Audience :: Developers",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Framework :: FastAPI",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.urls]
+Repository = "https://github.com/wh1isper/ya-mono"
+
+[project.scripts]
+ya-agent-platform = "ya_agent_platform.cli:cli"
+
+[build-system]
+requires = ["hatchling", "uv-dynamic-versioning>=0.7.0"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "uv-dynamic-versioning"
+
+[tool.uv-dynamic-versioning]
+vcs = "git"
+style = "pep440"
+bump = true
+
+[tool.hatch.metadata.hooks.uv-dynamic-versioning]
+dependencies = [
+    "alembic>=1.16.0",
+    "click>=8.0",
+    "fastapi>=0.116.0",
+    "psycopg[binary]>=3.2.0",
+    "pydantic>=2.12.0",
+    "pydantic-settings>=2.0.0",
+    "redis[hiredis]>=6.0.0",
+    "sqlalchemy>=2.0.0",
+    "sse-starlette>=3.0.0",
+    "uvicorn[standard]>=0.35.0",
+    "ya-agent-sdk[all]=={{ version }}",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["ya_agent_platform"]
+include = [
+    "ya_agent_platform/alembic.ini",
+    "ya_agent_platform/alembic/**/*.py",
+    "ya_agent_platform/alembic/script.py.mako",
+]
+
+[tool.uv.sources]
+ya-agent-sdk = { workspace = true }
+
+[dependency-groups]
+dev = [
+    "deptry>=0.22.0",
+    "httpx>=0.28.1",
+    "pre-commit>=2.20.0",
+    "pyright>=1.1.0",
+    "pytest>=7.2.0",
+    "pytest-asyncio>=0.25.3",
+    "ruff>=0.9.2",
+]
+
+[tool.deptry]
+ignore = ["DEP001"]
+package_module_name_map = { "alembic" = "alembic", "click" = "click", "fastapi" = "fastapi", "httpx" = "httpx", "pre-commit" = "pre_commit", "psycopg" = "psycopg", "pydantic" = "pydantic", "pydantic-settings" = "pydantic_settings", "pytest" = "pytest", "pytest-asyncio" = "pytest_asyncio", "pyright" = "pyright", "redis" = "redis", "ruff" = "ruff", "sqlalchemy" = "sqlalchemy", "sse-starlette" = "sse_starlette", "uvicorn" = "uvicorn", "ya-agent-sdk" = "ya_agent_sdk" }
+per_rule_ignores = { DEP003 = ["alembic", "click", "fastapi", "psycopg", "pydantic", "pydantic_settings", "redis", "sqlalchemy", "uvicorn", "ya_agent_sdk", "ya_agent_platform"], DEP004 = ["pytest"] }

ya_agent_platform-0.58.3/spec/000-platform-overview.md

@@ -0,0 +1,86 @@
+# 000 Platform Overview
+
+## Goal
+
+`ya-agent-platform` is a cloud-ready agent platform built on top of `ya-agent-sdk`.
+It turns the SDK runtime model into an operated product surface with administration,
+chat delivery, and external bridge integration.
+
+## Why This Exists
+
+Netherbrain proved the core interaction loop:
+
+- persistent runtime
+- web chat
+- IM integration
+
+The next platform iteration targets stronger cloud assumptions:
+
+- multiple first-party surfaces instead of a single embedded UI
+- normalized bridge contracts instead of per-channel coupling
+- clearer control plane and execution plane boundaries
+- deployment topology that scales past homelab assumptions
+
+## Product Surfaces
+
+1. **Management Portal**
+   - manage workspaces, agents, presets, bridges, credentials, and policies
+2. **Chat UI**
+   - first-party browser interface for end users and operators
+3. **IM Bridges**
+   - adapters for Discord, Telegram, Slack, WeCom, email, and future channels
+4. **Runtime APIs**
+   - programmatic entry points for sessions, events, streaming, and tooling
+
+## Core Design Principles
+
+- keep the runtime contract compatible with `ya-agent-sdk`
+- separate control-plane concerns from conversation delivery
+- normalize ingress and egress through a shared bridge event model
+- prefer stateless edge adapters and durable central orchestration
+- write the spec before expanding implementation breadth
+
+## Initial Domain Language
+
+| Term          | Meaning                                                                  |
+| ------------- | ------------------------------------------------------------------------ |
+| Workspace     | Top-level tenant or project boundary                                     |
+| Agent Profile | Reusable agent configuration and capability bundle                       |
+| Session       | Long-lived conversation state anchored to a workspace and agent          |
+| Surface       | First-party interaction entry such as admin or chat                      |
+| Bridge        | Adapter that converts an external system into normalized platform events |
+| Delivery      | A single inbound or outbound message exchange across a surface or bridge |
+
+## System Context
+
+```mermaid
+flowchart LR
+    Operator[Operator] --> Admin[Management Portal]
+    User[End User] --> ChatUI[Chat UI]
+    ExternalIM[External IM Systems] --> Bridges[IM Bridges]
+    Admin --> Platform[YA Agent Platform]
+    ChatUI --> Platform
+    Bridges --> Platform
+    Platform --> Runtime[ya-agent-sdk Runtime]
+    Platform --> Data[(Postgres / Redis / Object Storage)]
+```
+
+## Phase 1 Scope
+
+Phase 1 establishes:
+
+- backend service skeleton and local run path
+- frontend shell for management and chat surfaces
+- platform terminology and boundaries
+- bridge protocol draft
+- first HTTP API draft
+
+## Phase 2 Scope
+
+Phase 2 adds:
+
+- persistence model
+- authn and authz model
+- session orchestration
+- streaming transport
+- first real bridge implementation