agent-core-bus 0.9.0__tar.gz

agent_core_bus-0.9.0/.gitignore

@@ -0,0 +1,248 @@
+# Memory compiler runtime state
+memory-compiler/daily/
+memory-compiler/reports/
+memory-compiler/scripts/state.json
+memory-compiler/scripts/last-flush.json
+memory-compiler/scripts/flush.log
+memory-compiler/scripts/compile.log
+memory-compiler/scripts/session-flush-*.md
+memory-compiler/scripts/flush-context-*.md
+
+# Handoff writer state (placed alongside handoff files)
+**/handoff-state.json
+
+# Git worktrees (superpowers / parallel feature work)
+.worktrees/
+# Native (harness) worktrees
+.claude/worktrees/
+
+# Superpowers brainstorm mockups / scratch
+.superpowers/
+
+# Agent-core runtime state (handoffs, bus.sqlite, transcripts, etc.)
+.agent-core/
+
+# Local scratch / smoke-test artifacts
+.tmp/
+
+# Claude Code per-machine local overrides
+.claude/settings.local.json
+.claude/*.lock
+
+# 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 .venv 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
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+# ...but agent_core.venv is a SOURCE package, not a virtualenv — don't ignore it.
+!packages/core/src/agent_core/venv/
+!packages/core/src/agent_core/venv/**
+
+# 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
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+.gstack/
+
+# macOS Finder metadata (occasionally sneaks in via vendored sources)
+.DS_Store
+
+# Operational docs that must not live in source control
+pepper-vault-plan.txt

agent_core_bus-0.9.0/CHANGELOG.md

@@ -0,0 +1,70 @@
+# Changelog
+
+## [0.9.0](https://github.com/jeffrichley/agent_core/compare/v0.8.2...agent-core-v0.9.0) (2026-08-03)
+
+
+### Features
+
+* **bus:** add ASGI auth middleware with bus_auth_mode (off/warn/enforce) ([#544](https://github.com/jeffrichley/agent_core/issues/544)) ([d925501](https://github.com/jeffrichley/agent_core/commit/d9255013a0d50a8e694d0ba98e601970827fd3cf))
+* **bus:** add PubkeyRegistry loader for being → Ed25519 pubkey (Dβ-2a) ([#533](https://github.com/jeffrichley/agent_core/issues/533)) ([20e2f91](https://github.com/jeffrichley/agent_core/commit/20e2f91ae3eb766065964d260dc0e8eb372f4685))
+* **daemon:** add venv GC report engine and detectors to daemon doctor ([#540](https://github.com/jeffrichley/agent_core/issues/540)) ([0c30c78](https://github.com/jeffrichley/agent_core/commit/0c30c787b56e0f262f2464a7e93550869904f12b))
+* **daemon:** wire --fix to remove dead central corpse venvs (C2-3c) ([#550](https://github.com/jeffrichley/agent_core/issues/550)) ([3ee03b7](https://github.com/jeffrichley/agent_core/commit/3ee03b7b601acce0eea0c31013edc4d0c0d6cd16))
+* **qa:** session-scoped auto-start daemon fixture, replace skip-unless-live autouse ([#534](https://github.com/jeffrichley/agent_core/issues/534)) ([407c387](https://github.com/jeffrichley/agent_core/commit/407c3874a0636641b0b546a4c262408c839973d3))
+* **venv:** canonical .mcp.json generator (C2-2, [#316](https://github.com/jeffrichley/agent_core/issues/316)) ([#482](https://github.com/jeffrichley/agent_core/issues/482)) ([e376ab2](https://github.com/jeffrichley/agent_core/commit/e376ab2bf4e8130ca8654800a9b3c0034bf68dac))
+
+## [0.8.2](https://github.com/jeffrichley/agent_core/compare/v0.8.1...agent-core-v0.8.2) (2026-07-22)
+
+
+### Bug Fixes
+
+* republish package family to complete rate-limited first publish ([#477](https://github.com/jeffrichley/agent_core/issues/477)) ([32977ac](https://github.com/jeffrichley/agent_core/commit/32977ac78da4a15553329bb4e1fdaa9e894834ad))
+
+## [0.8.1](https://github.com/jeffrichley/agent_core/compare/v0.8.0...agent-core-v0.8.1) (2026-07-22)
+
+
+### Bug Fixes
+
+* rename flagship dist to agent-core-bus + bump inter-package pins to 0.8.x ([#474](https://github.com/jeffrichley/agent_core/issues/474)) ([48426e7](https://github.com/jeffrichley/agent_core/commit/48426e7ff753d8f35d4a4626308546e9d0f331f7))
+
+## [0.8.0](https://github.com/jeffrichley/agent_core/compare/v0.7.0...agent-core-v0.8.0) (2026-07-21)
+
+
+### Features
+
+* **bus:** add backup/restore — VACUUM INTO snapshots, retention, CLI ([#415](https://github.com/jeffrichley/agent_core/issues/415)) ([0a18681](https://github.com/jeffrichley/agent_core/commit/0a18681efa5fe444f716b46300f74c24eee690ba))
+* **bus:** add BusHandle.spawn() tracked-task API ([#290](https://github.com/jeffrichley/agent_core/issues/290)) ([#294](https://github.com/jeffrichley/agent_core/issues/294)) ([d0b0791](https://github.com/jeffrichley/agent_core/commit/d0b0791ef7b56783de5c44376eecf0bb739ce202))
+* **bus:** add delivery retry backoff with next_attempt_at (T5) ([#285](https://github.com/jeffrichley/agent_core/issues/285)) ([2169071](https://github.com/jeffrichley/agent_core/commit/21690717295e85327e6dff868d34ee8e7515095e))
+* **bus:** add EndpointSupervisor + circuit-breaker state machine ([#292](https://github.com/jeffrichley/agent_core/issues/292)) ([d1f3fb1](https://github.com/jeffrichley/agent_core/commit/d1f3fb14478c44d491117912f56c7f1e82cda3a7))
+* **bus:** add portable liveness watchdog (heartbeat + self-terminate) ([#343](https://github.com/jeffrichley/agent_core/issues/343)) ([628ffdb](https://github.com/jeffrichley/agent_core/commit/628ffdb418d126c95305dd54eb5cb0d062b74f38))
+* **bus:** add pydantic daemon-config schema and real validate_config ([#422](https://github.com/jeffrichley/agent_core/issues/422)) ([e3e1a8d](https://github.com/jeffrichley/agent_core/commit/e3e1a8d6c3555d2bcfc2394f59d91508d997633e))
+* **bus:** add SupervisorConfig block to BusConfig with boot logging ([#279](https://github.com/jeffrichley/agent_core/issues/279)) ([97a8522](https://github.com/jeffrichley/agent_core/commit/97a8522627205efcad41c19c7657f5b8ca48848d))
+* **bus:** degraded boot, wire supervisor, state-change events, bus status ([#313](https://github.com/jeffrichley/agent_core/issues/313)) ([24a8eb4](https://github.com/jeffrichley/agent_core/commit/24a8eb452bef85f1955f0f3a6df2483e395bee53))
+* **bus:** offload VoiceEndpoint construction to start() and add slow-deliver watchdog ([#331](https://github.com/jeffrichley/agent_core/issues/331)) ([57d98f5](https://github.com/jeffrichley/agent_core/commit/57d98f546d34afa250b69cc57256e2220a263228))
+* **bus:** per-being config-fragment isolation + degraded load + migrate Pepper ([#381](https://github.com/jeffrichley/agent_core/issues/381)) ([808a271](https://github.com/jeffrichley/agent_core/commit/808a2713c74d0216f523fa4fe79b6d4555de8d83))
+* **core:** hoist JsonlAuditLog base into core, subclass in briefs/voice/webcam ([#465](https://github.com/jeffrichley/agent_core/issues/465)) ([2c7843a](https://github.com/jeffrichley/agent_core/commit/2c7843afd278ed5732388ebb6a3b8350f4f14810))
+* **core:** replace hardcoded __version__ with importlib.metadata lookup ([#342](https://github.com/jeffrichley/agent_core/issues/342)) ([c0e5238](https://github.com/jeffrichley/agent_core/commit/c0e52386ca3d575845310f2a9a1e3ef6439b53cc))
+* **daemon:** add config hygiene / drift detection to daemon doctor (Cα-3) ([#379](https://github.com/jeffrichley/agent_core/issues/379)) ([38ae9c9](https://github.com/jeffrichley/agent_core/commit/38ae9c98ce3c617be8609cc9ca3973ac1a39821c))
+* **daemon:** add cross-platform autostart framework for Linux and macOS ([#340](https://github.com/jeffrichley/agent_core/issues/340)) ([b1d93d8](https://github.com/jeffrichley/agent_core/commit/b1d93d880848332f411e6190863cb2755505af95))
+* **daemon:** add Windows Service headless autostart with unbounded restart ([#337](https://github.com/jeffrichley/agent_core/issues/337)) ([5b1b8df](https://github.com/jeffrichley/agent_core/commit/5b1b8dff47a69cf7aa8d160a9dd0b36a7fb73316))
+* **deps:** version-pin sibling deps and remove qwen-tts from voice ([#430](https://github.com/jeffrichley/agent_core/issues/430)) ([3b173ee](https://github.com/jeffrichley/agent_core/commit/3b173eebd24fb8eab995785a9e154a0dda870f19))
+* **hatchery:** ungendered templates + .mcp.json generation ([#81](https://github.com/jeffrichley/agent_core/issues/81)/[#82](https://github.com/jeffrichley/agent_core/issues/82)) ([#357](https://github.com/jeffrichley/agent_core/issues/357)) ([f48762d](https://github.com/jeffrichley/agent_core/commit/f48762df78eb12cfa9524e9b5a277741534ea8a7)), closes [#311](https://github.com/jeffrichley/agent_core/issues/311)
+* **logging:** add structured JSON logging and correlation-id contextvar ([#462](https://github.com/jeffrichley/agent_core/issues/462)) ([b3397a2](https://github.com/jeffrichley/agent_core/commit/b3397a2b08aa2b083d26ba9d230bacfa07a23641))
+* mypy --strict for agent-core-discord + log CancelledError swallows (closes [#444](https://github.com/jeffrichley/agent_core/issues/444)) ([#470](https://github.com/jeffrichley/agent_core/issues/470)) ([3ca9419](https://github.com/jeffrichley/agent_core/commit/3ca94193c98d547acfe2cd5203b314cb134656d4))
+* **release:** configure release-please for 12-package synchronized version train ([#428](https://github.com/jeffrichley/agent_core/issues/428)) ([c1b4097](https://github.com/jeffrichley/agent_core/commit/c1b409765c61d09a6657b0e8b5e43a27cb235b3e))
+* **secrets:** add vault-API accessor and scrub subprocess env ([#399](https://github.com/jeffrichley/agent_core/issues/399)) ([adb404b](https://github.com/jeffrichley/agent_core/commit/adb404b046bd224b56d64188b2cb56eb134d99b7))
+* **venv:** add per-being pinned venv builder + absolute uv resolution ([#365](https://github.com/jeffrichley/agent_core/issues/365)) ([07ece11](https://github.com/jeffrichley/agent_core/commit/07ece113ddea8b111dece79588a74fc840864aea)), closes [#315](https://github.com/jeffrichley/agent_core/issues/315)
+
+
+### Bug Fixes
+
+* 6 HIGH findings from the adversarial review (leaks, fragility, footguns) ([#469](https://github.com/jeffrichley/agent_core/issues/469)) ([f546c54](https://github.com/jeffrichley/agent_core/commit/f546c548d2da6455e611c5b5820a21fa8c86211e))
+* **bus:** install signal handlers before announcing readiness (deflake test_cli_run) ([#283](https://github.com/jeffrichley/agent_core/issues/283)) ([08fd821](https://github.com/jeffrichley/agent_core/commit/08fd8214a7958a921d0a6216ced2a1e0183d40ca))
+* log or justify bare except-pass swallows + test get_client factory (closes [#408](https://github.com/jeffrichley/agent_core/issues/408)) ([#471](https://github.com/jeffrichley/agent_core/issues/471)) ([e67783c](https://github.com/jeffrichley/agent_core/commit/e67783ccb4dfab6f1783d6a67223f475f81526ea))
+* **scheduler:** dispose aiosqlite engine on stop + guard against connection leaks ([#468](https://github.com/jeffrichley/agent_core/issues/468)) ([d14421f](https://github.com/jeffrichley/agent_core/commit/d14421f769b62566b8759a541e401ea050c81c44))
+
+## Changelog
+
+All notable changes to `agent-core` are documented in this file. The format
+is generated by towncrier from fragments in `changelog.d/` at release time.
+
+<!-- towncrier release notes start -->

agent_core_bus-0.9.0/PKG-INFO

@@ -0,0 +1,27 @@
+Metadata-Version: 2.4
+Name: agent-core-bus
+Version: 0.9.0
+Summary: Core infrastructure for AI agents - memory, knowledge compilation, and tooling
+License-Expression: MIT
+Requires-Python: >=3.12
+Requires-Dist: agent-core-credentials<0.9,>=0.8
+Requires-Dist: agentmail>=0.4
+Requires-Dist: aiosqlite>=0.20
+Requires-Dist: apscheduler>=4.0.0a5
+Requires-Dist: claude-agent-sdk>=0.1.29
+Requires-Dist: cryptography>=42.0
+Requires-Dist: fastmcp>=2.0
+Requires-Dist: pluggy>=1.6
+Requires-Dist: psutil>=5.9
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyjwt[crypto]>=2.8
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pywin32>=300; sys_platform == 'win32'
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: sniffio>=1.3
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: starlette>=1.3.1
+Requires-Dist: typer>=0.12
+Requires-Dist: tzdata>=2024.1
+Requires-Dist: uvicorn>=0.30

agent_core_bus-0.9.0/VERSION

@@ -0,0 +1 @@
+0.9.0

agent_core_bus-0.9.0/docs/plugins.md

@@ -0,0 +1,106 @@
+# agent_core Plugin Hooks (v1)
+
+`agent_core` uses [Pluggy](https://pluggy.readthedocs.io/) for runtime extension points.
+Plugins are discovered through setuptools entry points in the `agent_core` group.
+
+## Register a plugin
+
+Add an entry point in your package's `pyproject.toml`:
+
+```toml
+[project.entry-points."agent_core"]
+my_plugin = "my_package.agent_core_plugin"
+```
+
+Then implement one or more hook functions with:
+
+```python
+import pluggy
+
+hookimpl = pluggy.HookimplMarker("agent_core")
+```
+
+## Hook surface
+
+- `register_endpoint_types()`  
+  Return endpoint type registrations used for YAML `endpoints[].type`.
+- `register_bus_hook_types()`  
+  Return bus-hook type registrations used for YAML `bus_hooks[].type`.
+- `register_hook_tool_types()`  
+  Return hook-tool type registrations used for pipeline tool ids.
+- `configure_endpoint_instance(instance, endpoint_name, endpoint_config, services)`  
+  Post-construction endpoint wiring.
+- `configure_bus_hook_instance(instance, stage, hook_config, services)`  
+  Post-construction bus hook wiring.
+- `validate_config(raw_config)`  
+  Validate runner config early; raise to block startup.
+
+## Resolution order
+
+Runtime resolution uses the plugin registry maps built at startup.
+Unknown type ids fail startup/config load immediately.
+
+## RunnerServices
+
+Wiring hooks receive a `RunnerServices` instance.
+
+Current fields:
+
+- `notify_broker`: shared notify broker used for push fan-out
+
+Treat this object as runtime-owned shared state; do not replace it.
+
+## Built-in behavior
+
+Core ships with a built-in runtime plugin that:
+
+- attaches `notify_broker` to endpoints implementing `NotificationBrokerAwareEndpoint`
+- keeps bus-hook wiring and config validation as no-op defaults
+
+Core also ships an entrypoint-loaded alias plugin:
+
+- endpoint aliases:
+  - `builtin.claude_code_mcp` -> `agent_core.endpoints.claude_code_mcp.ClaudeCodeMCPEndpoint`
+  - `builtin.discord` -> `agent_core_discord.endpoint.DiscordEndpoint`
+  - `builtin.stub` -> `agent_core.endpoints.stub.StubEndpoint`
+  - `builtin.scheduler` -> `agent_core.endpoints.scheduler.SchedulerEndpoint`
+  - `builtin.handoff_jobs` -> `agent_core.endpoints.handoff_jobs.HandoffJobsEndpoint`
+- hook tool aliases:
+  - `builtin.handoff_writer` -> `agent_core.hooks.tools.handoff_writer.HandoffWriter`
+  - `builtin.identity_injector` -> `agent_core.hooks.tools.identity_injector.IdentityInjector`
+  - `builtin.time_injector` -> `agent_core.hooks.tools.time_injector.TimeInjector`
+
+Your plugin hooks run alongside these defaults.
+
+## Handoff daemon setup (default pattern)
+
+Use `builtin.handoff_jobs` to host the enqueue endpoint, then point
+`builtin.handoff_writer` at that endpoint. The hook remains enqueue-only.
+
+```yaml
+http:
+  bind_host: 127.0.0.1
+  bind_port: 8788
+
+endpoints:
+  - type: builtin.handoff_jobs
+    name: handoff-jobs
+    params:
+      mount: /internal/handoff-jobs
+
+pipelines:
+  SessionEnd:
+    - type: builtin.handoff_writer
+      params:
+        output_path: "C:\\Users\\you\\Memory\\agent\\handoff.md"
+        vault_root: "C:\\Users\\you\\Memory\\agent"
+        handoff_status_path: "C:\\Users\\you\\Memory\\agent\\handoff-status.json"
+        handoff_jobs_url: "http://127.0.0.1:8788/internal/handoff-jobs"
+        agent_name: "YourAgent"
+```
+
+With this setup:
+
+- hook writes no handoff files and runs no LLM extraction
+- daemon worker writes `handoff.md`
+- daemon worker is the single writer of `handoff-status.json`

agent_core_bus-0.9.0/pyproject.toml

@@ -0,0 +1,53 @@
+[project]
+name = "agent-core-bus"
+dynamic = ["version"]
+description = "Core infrastructure for AI agents - memory, knowledge compilation, and tooling"
+license = "MIT"
+requires-python = ">=3.12"
+dependencies = [
+    "claude-agent-sdk>=0.1.29",
+    "agent-core-credentials>=0.8,<0.9",
+    "python-dotenv>=1.0.0",
+    "tzdata>=2024.1",
+    "pydantic>=2.0",
+    "typer>=0.12",
+    "rich>=13.0",
+    "pyyaml>=6.0",
+    "agentmail>=0.4",
+    "aiosqlite>=0.20",
+    "fastmcp>=2.0",
+    "starlette>=1.3.1",
+    "uvicorn>=0.30",
+    "cryptography>=42.0",
+    "PyJWT[crypto]>=2.8",
+    "psutil>=5.9",
+    "apscheduler>=4.0.0a5",
+    "sqlalchemy>=2.0",
+    "sniffio>=1.3",
+    "pluggy>=1.6",
+    "pywin32>=300; sys_platform == 'win32'",
+]
+
+[project.scripts]
+agent-core = "agent_core.cli:app"
+agent-core-daemon = "agent_core.daemon.cli:app"
+
+[project.entry-points."agent_core"]
+aliases = "agent_core.plugins.builtin_aliases"
+example = "agent_core.plugins.example_entrypoint"
+
+[build-system]
+requires = ["hatchling", "uv-dynamic-versioning"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agent_core"]
+
+[tool.hatch.version]
+source = "uv-dynamic-versioning"
+
+[tool.uv-dynamic-versioning]
+fallback-version = "0.0.0"
+
+[tool.uv]
+cache-keys = [{ file = "pyproject.toml" }, { git = { commit = true, tags = true } }]

agent_core_bus-0.9.0/skills/README.md

@@ -0,0 +1,31 @@
+# Canonical skills (packages/core/skills/)
+
+This directory holds the **canonical, shipped skills** for bus endpoints implemented in the `core` package. Each skill lives under `skills/<skill-name>/` co-located with the endpoint it documents and depends on.
+
+For the broader placement convention across all agent-core packages, see [`docs/skills/PLACEMENT.md`](../../../docs/skills/PLACEMENT.md).
+
+## Skills in this directory
+
+| Skill | Endpoint dependency | Endpoint source |
+|---|---|---|
+| `scheduler/` | `builtin.scheduler` | [`src/agent_core/endpoints/scheduler.py`](../src/agent_core/endpoints/scheduler.py) |
+
+## How beings install these
+
+Beings (Wren, Pepper, testbot, future beings) install these skills into their own `~/.<being>/.claude/skills/` directory via the **canonical-replacement-install pattern**:
+
+1. Rename the being's current skill file (if present) to `<original>.stale-bak-YYYYMMDD`
+2. Copy the new canonical version from this package into the being's vault using `cp -R src/. dst/` (the trailing `/.` matters on Git Bash — `cp -R src/ dst/` nests `src` inside `dst/` when `dst` already exists)
+3. Verify post-install via line-count cross-check or `grep` for expected new content
+4. After one auto-backup cycle, delete the `.stale-bak-YYYYMMDD` file
+
+Until a unified install tool ships (planned future work), beings perform this manually. The pattern is documented in detail in Wren's `feedback_stale_bak_retention_pattern` memory and Pepper's equivalent.
+
+## Adding a new endpoint-coupled skill to `core`
+
+1. Implement the endpoint in `src/agent_core/endpoints/<endpoint>.py`
+2. Author the skill in `skills/<skill-name>/SKILL.md` (+ optional `references/` subdir for deep-dive docs)
+3. Update this README's table to add the new skill
+4. Open a PR; criterion-check happens at PR review (see `docs/skills/PLACEMENT.md` for the criterion-check shape)
+
+Skills should be **readable without their endpoint installed** — they ship together but the skill itself is also a setup guide for a reader who's never run the endpoint.