ya-claw 0.58.6__tar.gz

ya_claw-0.58.6/.env.example

@@ -0,0 +1,23 @@
+# YA Claw runtime environment variables
+# Copy this file to packages/ya-claw/.env and uncomment the variables you need.
+# SDK and tool environment variables live in packages/ya-agent-sdk/.env.example.
+
+# =============================================================================
+# YA Claw Configuration (YA_CLAW_ prefix)
+# =============================================================================
+
+# YA_CLAW_ENVIRONMENT=development
+# YA_CLAW_HOST=127.0.0.1
+# YA_CLAW_PORT=9042
+# YA_CLAW_PUBLIC_BASE_URL=http://127.0.0.1:9042
+# YA_CLAW_API_TOKEN=replace-with-a-long-random-token
+# YA_CLAW_AUTO_MIGRATE=true
+# YA_CLAW_DATA_DIR=~/.ya-claw/data
+# YA_CLAW_WORKSPACE_ROOT=~/.ya-claw/workspace
+# Default SQLite path: ~/.ya-claw/ya_claw.sqlite3
+# YA_CLAW_DATABASE_URL=postgresql+psycopg://ya_claw:ya_claw@localhost:15433/ya_claw
+# YA_CLAW_DATABASE_ECHO=false
+# YA_CLAW_DATABASE_POOL_SIZE=5
+# YA_CLAW_DATABASE_MAX_OVERFLOW=10
+# YA_CLAW_DATABASE_POOL_RECYCLE_SECONDS=3600
+# YA_CLAW_WEB_DIST_DIR=apps/ya-claw-web/dist

ya_claw-0.58.6/.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_claw-0.58.6/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: ya-claw
+Version: 0.58.6
+Summary: Workspace-native local-first agent runtime built on top of ya-agent-sdk
+Project-URL: Repository, https://github.com/wh1isper/ya-mono
+Author-email: wh1isper <jizhongsheng957@gmail.com>
+Keywords: agent-runtime,ai-agent,fastapi,python,workspace
+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: aiosqlite>=0.21.0
+Requires-Dist: alembic>=1.16.0
+Requires-Dist: click>=8.0
+Requires-Dist: fastapi>=0.116.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.12.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.6
+Description-Content-Type: text/markdown
+
+# YA Claw
+
+Workspace-native single-node agent runtime and web service for the `ya-mono` workspace.
+
+## Scope
+
+YA Claw packages a durable runtime shell around `ya-agent-sdk` with:
+
+- registered workspaces resolved through `WorkspaceProvider`
+- reusable agent profiles
+- resumable sessions and runs
+- in-process active state and async task coordination
+- session schedules for timed execution
+- SQLite-first durable state with optional PostgreSQL
+- local filesystem session continuity and exported state
+- a bundled web shell for local and self-hosted use
+- bridge adapters that connect IM channels to the YA Claw service
+
+## Current Direction
+
+The target single-node shape runs as one web service.
+The runtime keeps active session state, live delivery, async tasks, schedule dispatch, and bridge coordination inside one runtime process.
+SQLite is the default durable store.
+PostgreSQL remains an optional storage backend for deployments that prefer an external relational database.
+
+## Layout
+
+Key areas in this package:
+
+- `.env.example` — runtime environment example
+- `spec/` — architecture and runtime design documents
+- `tests/` — runtime tests
+- `ya_claw/api/` — HTTP API surface
+- `ya_claw/bridge/` — IM bridge adapters and relay logic
+- `ya_claw/app.py` and `ya_claw/cli.py` — application entrypoints
+- `ya_claw/config.py` — runtime configuration
+
+## Runtime Shape
+
+The runtime shape is:
+
+- one YA Claw web service
+- one in-process runtime state manager
+- one session scheduler
+- one bridge subsystem for external channels
+- one shared bearer token for HTTP access
+- one SQLite database by default
+- optional PostgreSQL
+- one runtime data directory for sensitive session continuity
+- one workspace root for project data
+- one bundled web shell
+
+## Quick Start
+
+From the workspace root, start the default runtime flow:
+
+```bash
+uv sync --all-packages
+cp packages/ya-claw/.env.example packages/ya-claw/.env
+uv run --package ya-claw ya-claw serve --reload
+```
+
+Set `YA_CLAW_API_TOKEN` before starting the service.
+The development server listens on `http://127.0.0.1:9042` by default.
+YA Claw loads `YA_CLAW_*` settings from `packages/ya-claw/.env` and the process environment.
+Use [`packages/ya-agent-sdk/.env.example`](../ya-agent-sdk/.env.example) for SDK and tool environment variables.
+
+Default local paths:
+
+- SQLite database: `~/.ya-claw/ya_claw.sqlite3`
+- runtime data root: `~/.ya-claw/data`
+- workspace root: `~/.ya-claw/workspace`
+
+## External Database
+
+Set `YA_CLAW_DATABASE_URL` in `packages/ya-claw/.env` when you want an external PostgreSQL database.
+The default SQLite file stays at `~/.ya-claw/ya_claw.sqlite3`.
+
+## Database Commands
+
+```bash
+uv run --package ya-claw ya-claw db upgrade
+uv run --package ya-claw ya-claw db current
+uv run --package ya-claw ya-claw db history
+uv run --package ya-claw ya-claw db revision "add session tables"
+```
+
+## Bridge Commands
+
+The CLI owns a top-level bridge command group.
+
+```bash
+uv run --package ya-claw ya-claw bridge ls
+uv run --package ya-claw ya-claw bridge run lark
+uv run --package ya-claw ya-claw bridge serve lark
+```
+
+### Bridge Relay Modes
+
+- `task relay` — a bridge submits work to YA Claw as an async session flow and delivers agent output back through the channel adapter or channel CLI
+- `stream relay` — a bridge opens a foreground run, consumes SSE from the YA Claw service, and streams channel-ready output directly
+
+## Web Shell
+
+Run the web shell from the repository root:
+
+```bash
+make web-dev
+```
+
+## Docker
+
+Build from the repository root:
+
+```bash
+docker build -f Dockerfile.ya-claw -t ya-claw:dev .
+```
+
+## Initial API Surface
+
+Every HTTP route except `/healthz` expects `Authorization: Bearer <YA_CLAW_API_TOKEN>`.
+
+- `GET /healthz` — service health probe with storage and runtime component status
+- `GET /api/v1/schedules` — session schedule inspection surface
+- `POST /api/v1/bridges/{bridge_id}/dispatch` — bridge ingress surface
+
+## Spec Set
+
+- [`spec/README.md`](spec/README.md)
+- [`spec/00-overview.md`](spec/00-overview.md)
+- [`spec/01-configuration-and-workspace-provider.md`](spec/01-configuration-and-workspace-provider.md)
+- [`spec/02-execution-and-session.md`](spec/02-execution-and-session.md)
+- [`spec/03-storage-and-streaming.md`](spec/03-storage-and-streaming.md)
+- [`spec/04-api.md`](spec/04-api.md)
+- [`spec/05-web-ui-and-operations.md`](spec/05-web-ui-and-operations.md)

ya_claw-0.58.6/README.md

@@ -0,0 +1,135 @@
+# YA Claw
+
+Workspace-native single-node agent runtime and web service for the `ya-mono` workspace.
+
+## Scope
+
+YA Claw packages a durable runtime shell around `ya-agent-sdk` with:
+
+- registered workspaces resolved through `WorkspaceProvider`
+- reusable agent profiles
+- resumable sessions and runs
+- in-process active state and async task coordination
+- session schedules for timed execution
+- SQLite-first durable state with optional PostgreSQL
+- local filesystem session continuity and exported state
+- a bundled web shell for local and self-hosted use
+- bridge adapters that connect IM channels to the YA Claw service
+
+## Current Direction
+
+The target single-node shape runs as one web service.
+The runtime keeps active session state, live delivery, async tasks, schedule dispatch, and bridge coordination inside one runtime process.
+SQLite is the default durable store.
+PostgreSQL remains an optional storage backend for deployments that prefer an external relational database.
+
+## Layout
+
+Key areas in this package:
+
+- `.env.example` — runtime environment example
+- `spec/` — architecture and runtime design documents
+- `tests/` — runtime tests
+- `ya_claw/api/` — HTTP API surface
+- `ya_claw/bridge/` — IM bridge adapters and relay logic
+- `ya_claw/app.py` and `ya_claw/cli.py` — application entrypoints
+- `ya_claw/config.py` — runtime configuration
+
+## Runtime Shape
+
+The runtime shape is:
+
+- one YA Claw web service
+- one in-process runtime state manager
+- one session scheduler
+- one bridge subsystem for external channels
+- one shared bearer token for HTTP access
+- one SQLite database by default
+- optional PostgreSQL
+- one runtime data directory for sensitive session continuity
+- one workspace root for project data
+- one bundled web shell
+
+## Quick Start
+
+From the workspace root, start the default runtime flow:
+
+```bash
+uv sync --all-packages
+cp packages/ya-claw/.env.example packages/ya-claw/.env
+uv run --package ya-claw ya-claw serve --reload
+```
+
+Set `YA_CLAW_API_TOKEN` before starting the service.
+The development server listens on `http://127.0.0.1:9042` by default.
+YA Claw loads `YA_CLAW_*` settings from `packages/ya-claw/.env` and the process environment.
+Use [`packages/ya-agent-sdk/.env.example`](../ya-agent-sdk/.env.example) for SDK and tool environment variables.
+
+Default local paths:
+
+- SQLite database: `~/.ya-claw/ya_claw.sqlite3`
+- runtime data root: `~/.ya-claw/data`
+- workspace root: `~/.ya-claw/workspace`
+
+## External Database
+
+Set `YA_CLAW_DATABASE_URL` in `packages/ya-claw/.env` when you want an external PostgreSQL database.
+The default SQLite file stays at `~/.ya-claw/ya_claw.sqlite3`.
+
+## Database Commands
+
+```bash
+uv run --package ya-claw ya-claw db upgrade
+uv run --package ya-claw ya-claw db current
+uv run --package ya-claw ya-claw db history
+uv run --package ya-claw ya-claw db revision "add session tables"
+```
+
+## Bridge Commands
+
+The CLI owns a top-level bridge command group.
+
+```bash
+uv run --package ya-claw ya-claw bridge ls
+uv run --package ya-claw ya-claw bridge run lark
+uv run --package ya-claw ya-claw bridge serve lark
+```
+
+### Bridge Relay Modes
+
+- `task relay` — a bridge submits work to YA Claw as an async session flow and delivers agent output back through the channel adapter or channel CLI
+- `stream relay` — a bridge opens a foreground run, consumes SSE from the YA Claw service, and streams channel-ready output directly
+
+## Web Shell
+
+Run the web shell from the repository root:
+
+```bash
+make web-dev
+```
+
+## Docker
+
+Build from the repository root:
+
+```bash
+docker build -f Dockerfile.ya-claw -t ya-claw:dev .
+```
+
+## Initial API Surface
+
+Every HTTP route except `/healthz` expects `Authorization: Bearer <YA_CLAW_API_TOKEN>`.
+
+- `GET /healthz` — service health probe with storage and runtime component status
+- `GET /api/v1/schedules` — session schedule inspection surface
+- `POST /api/v1/bridges/{bridge_id}/dispatch` — bridge ingress surface
+
+## Spec Set
+
+- [`spec/README.md`](spec/README.md)
+- [`spec/00-overview.md`](spec/00-overview.md)
+- [`spec/01-configuration-and-workspace-provider.md`](spec/01-configuration-and-workspace-provider.md)
+- [`spec/02-execution-and-session.md`](spec/02-execution-and-session.md)
+- [`spec/03-storage-and-streaming.md`](spec/03-storage-and-streaming.md)
+- [`spec/04-api.md`](spec/04-api.md)
+- [`spec/05-web-ui-and-operations.md`](spec/05-web-ui-and-operations.md)

ya_claw-0.58.6/pyproject.toml

@@ -0,0 +1,77 @@
+[project]
+name = "ya-claw"
+dynamic = ["version", "dependencies"]
+description = "Workspace-native local-first agent runtime built on top of ya-agent-sdk"
+authors = [{ name = "wh1isper", email = "jizhongsheng957@gmail.com" }]
+readme = "README.md"
+keywords = ["python", "fastapi", "agent-runtime", "workspace", "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-claw = "ya_claw.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",
+    "aiosqlite>=0.21.0",
+    "pydantic>=2.12.0",
+    "pydantic-settings>=2.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_claw"]
+include = [
+    "ya_claw/alembic.ini",
+    "ya_claw/alembic/**/*.py",
+    "ya_claw/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 = { "aiosqlite" = "aiosqlite", "alembic" = "alembic", "click" = "click", "fastapi" = "fastapi", "httpx" = "httpx", "pre-commit" = "pre_commit", "pydantic" = "pydantic", "pydantic-settings" = "pydantic_settings", "pytest" = "pytest", "pytest-asyncio" = "pytest_asyncio", "pyright" = "pyright", "ruff" = "ruff", "sqlalchemy" = "sqlalchemy", "sse-starlette" = "sse_starlette", "uvicorn" = "uvicorn", "ya-agent-sdk" = "ya_agent_sdk" }
+per_rule_ignores = { DEP003 = ["aiosqlite", "alembic", "click", "fastapi", "pydantic", "pydantic_settings", "sqlalchemy", "uvicorn", "ya_agent_sdk", "ya_claw"], DEP004 = ["pytest"] }