kodelet-subagent 0.4.0__tar.gz

kodelet_subagent-0.4.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jingkai He
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kodelet_subagent-0.4.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: kodelet-subagent
+Version: 0.4.0
+Summary: Durable background-agent extension for Kodelet
+Keywords: kodelet,extension,agents,background-tasks
+Author: Jingkai He
+Author-email: Jingkai He <jingkai@hey.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: alembic>=1.16,<2
+Requires-Dist: kodelet-sdk>=0.1.21,<0.2
+Requires-Python: >=3.11
+Project-URL: Repository, https://github.com/jingkaihe/kodelet-subagent
+Project-URL: Issues, https://github.com/jingkaihe/kodelet-subagent/issues
+Description-Content-Type: text/markdown
+
+# Kodelet subagent
+
+Durable background agents for Kodelet, implemented as a normal Python library and exposed through a Kodelet extension.
+
+The extension provides six tools:
+
+- `spawn_agent` starts a named background agent from a fork of the current conversation or from fresh context.
+- `wait_agent` waits for a specific run while forwarding live child-tool progress when available.
+- `list_agents` reports persisted agents owned by the current conversation.
+- `followup_agent` resumes a completed, failed, or interrupted agent.
+- `steer_agent` queues guidance for a running agent.
+- `cancel_agent` persists cancellation and fences the active worker.
+
+Agent identity, run history, leases, and steering messages are stored in SQLite. The extension initializes and upgrades its database automatically before serving tools.
+
+## Installation
+
+Requirements: Kodelet with extension background-task support, Python 3.11 or newer, and `uv`.
+
+Run the package's installer directly with `uvx`:
+
+```bash
+uvx kodelet-subagent install
+```
+
+Or install directly from GitHub:
+
+```bash
+uvx --from git+https://github.com/jingkaihe/kodelet-subagent kodelet-subagent install
+```
+
+The GitHub form pins the resolved commit in the generated extension wrapper.
+
+This installs the extension wrapper at:
+
+```text
+~/.kodelet/plugins/jingkaihe@kodelet-subagent/extensions/subagent/kodelet-extension-subagent
+```
+
+Verify discovery after restarting Kodelet:
+
+```bash
+kodelet extension inspect jingkaihe@kodelet-subagent/subagent
+```
+
+## License
+
+Licensed under the MIT License. See `LICENSE`.

kodelet_subagent-0.4.0/README.md

@@ -0,0 +1,48 @@
+# Kodelet subagent
+
+Durable background agents for Kodelet, implemented as a normal Python library and exposed through a Kodelet extension.
+
+The extension provides six tools:
+
+- `spawn_agent` starts a named background agent from a fork of the current conversation or from fresh context.
+- `wait_agent` waits for a specific run while forwarding live child-tool progress when available.
+- `list_agents` reports persisted agents owned by the current conversation.
+- `followup_agent` resumes a completed, failed, or interrupted agent.
+- `steer_agent` queues guidance for a running agent.
+- `cancel_agent` persists cancellation and fences the active worker.
+
+Agent identity, run history, leases, and steering messages are stored in SQLite. The extension initializes and upgrades its database automatically before serving tools.
+
+## Installation
+
+Requirements: Kodelet with extension background-task support, Python 3.11 or newer, and `uv`.
+
+Run the package's installer directly with `uvx`:
+
+```bash
+uvx kodelet-subagent install
+```
+
+Or install directly from GitHub:
+
+```bash
+uvx --from git+https://github.com/jingkaihe/kodelet-subagent kodelet-subagent install
+```
+
+The GitHub form pins the resolved commit in the generated extension wrapper.
+
+This installs the extension wrapper at:
+
+```text
+~/.kodelet/plugins/jingkaihe@kodelet-subagent/extensions/subagent/kodelet-extension-subagent
+```
+
+Verify discovery after restarting Kodelet:
+
+```bash
+kodelet extension inspect jingkaihe@kodelet-subagent/subagent
+```
+
+## License
+
+Licensed under the MIT License. See `LICENSE`.

kodelet_subagent-0.4.0/pyproject.toml

@@ -0,0 +1,77 @@
+[project]
+name = "kodelet-subagent"
+version = "0.4.0"
+description = "Durable background-agent extension for Kodelet"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "kodelet",
+    "extension",
+    "agents",
+    "background-tasks",
+]
+dependencies = [
+    "alembic>=1.16,<2",
+    "kodelet-sdk>=0.1.21,<0.2",
+]
+
+[[project.authors]]
+name = "Jingkai He"
+email = "jingkai@hey.com"
+
+[project.urls]
+Repository = "https://github.com/jingkaihe/kodelet-subagent"
+Issues = "https://github.com/jingkaihe/kodelet-subagent/issues"
+
+[project.scripts]
+kodelet-extension-subagent = "kodelet_subagent.__main__:main"
+kodelet-subagent = "kodelet_subagent.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.9.18,<0.10.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio>=0.24",
+    "ruff>=0.14",
+    "ty>=0.0.1a21",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+src = [
+    "src",
+    "tests",
+]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+    "UP",
+    "B",
+    "ASYNC",
+    "C90",
+    "RUF",
+]
+ignore = [
+    "RUF001",
+    "RUF002",
+    "RUF003",
+]
+
+[tool.ty.environment]
+python-version = "3.11"
+root = [
+    "src",
+    "tests",
+]

kodelet_subagent-0.4.0/pyproject.toml.orig

@@ -0,0 +1,52 @@
+[project]
+name = "kodelet-subagent"
+version = "0.4.0"
+description = "Durable background-agent extension for Kodelet"
+readme = "README.md"
+authors = [
+    { name = "Jingkai He", email = "jingkai@hey.com" }
+]
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["kodelet", "extension", "agents", "background-tasks"]
+dependencies = [
+    "alembic>=1.16,<2",
+    "kodelet-sdk>=0.1.21,<0.2",
+]
+
+[project.urls]
+Repository = "https://github.com/jingkaihe/kodelet-subagent"
+Issues = "https://github.com/jingkaihe/kodelet-subagent/issues"
+
+[project.scripts]
+kodelet-extension-subagent = "kodelet_subagent.__main__:main"
+kodelet-subagent = "kodelet_subagent.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.9.18,<0.10.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio>=0.24",
+    "ruff>=0.14",
+    "ty>=0.0.1a21",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "ASYNC", "C90", "RUF"]
+ignore = ["RUF001", "RUF002", "RUF003"]
+
+[tool.ty.environment]
+python-version = "3.11"
+root = ["src", "tests"]

kodelet_subagent-0.4.0/src/kodelet_subagent/__init__.py

@@ -0,0 +1,13 @@
+"""Durable background-agent support for Kodelet."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("kodelet-subagent")
+except PackageNotFoundError:  # pragma: no cover - source tree without installation
+    __version__ = "0.4.0"
+
+from .persistence import AgentStore
+from .runtime import RuntimeState
+
+__all__ = ["AgentStore", "RuntimeState", "__version__"]

kodelet_subagent-0.4.0/src/kodelet_subagent/__main__.py

@@ -0,0 +1,13 @@
+"""Executable entry point for the Kodelet extension."""
+
+from __future__ import annotations
+
+
+def main() -> None:
+    from .extension import ext
+
+    ext.run_sync()
+
+
+if __name__ == "__main__":
+    main()

kodelet_subagent-0.4.0/src/kodelet_subagent/cli.py

@@ -0,0 +1,46 @@
+"""Maintenance commands for the subagent extension."""
+
+from __future__ import annotations
+
+import argparse
+from collections.abc import Sequence
+from pathlib import Path
+
+from .install import install_plugin
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="kodelet-subagent")
+    subcommands = parser.add_subparsers(dest="command", required=True)
+
+    install = subcommands.add_parser(
+        "install",
+        help="Install the Kodelet plugin wrapper in ~/.kodelet/plugins",
+    )
+    install.add_argument(
+        "--home",
+        type=Path,
+        help="Override the home directory used for installation",
+    )
+
+    migrate = subcommands.add_parser(
+        "migrate",
+        help="Upgrade a subagent SQLite database to the latest Alembic revision",
+    )
+    migrate.add_argument("database", type=Path)
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    args = build_parser().parse_args(argv)
+    if args.command == "install":
+        executable = install_plugin(home=args.home)
+        print(f"Installed Kodelet subagent extension at {executable}")
+        return 0
+
+    from .persistence import migrate_database
+
+    database = args.database.expanduser().resolve()
+    migrate_database(database)
+    print(f"Migrated {database}")
+    return 0