dsh-python-bridge

English | 中文

Python decorator library and runtime that exposes a Python module as a Cordis Service Provider, Tool Consumer, Event Listener, or capability seam Provider through the DeepSeek Harness Python Capability Bridge. Decorators are zero-side-effect at import time; the runtime is python -u -m dsh_bridge.runtime <module> and serves newline-delimited JSON-RPC 2.0 over stdio (matching @deepseek-ai/dsh-sdk-protocol JsonRpcLineTransport).

Installation

pip install dsh-python-bridge

Decorators

Each decorator returns the original callable (or class) unchanged — Python business code is unmodified at runtime.

Runtime

python -u -m dsh_bridge.runtime <module.path> [--class <ClassName>] [--function <func>]...

The runtime walks the bridge registry and dispatches JSON-RPC requests to the matching Python callables. Errors map to the JSON-RPC error vocabulary in dsh_bridge._errors (-32001/timeout, -32003/permission, etc.).

Runtime manifest

The initialize handshake returns serverInfo plus a manifest carrying every dynamically registered surface with the metadata a host needs to build the plugin without codegen. The client sends clientInfo: { name, version }; a client whose major version differs from the runtime's serverInfo.version is rejected with a protocol-mismatch error (wire version negotiation).

• tools[] — name, description, parameters (JSON Schema), outputSchema
• provideMethods[] — name, timeoutMs, concurrencySafe, parameters (PEP 484 annotation strings), return
• services[] — name, class, initFields (dataclass field name/annotation/default)
• listeners[] — event, mode, prepend, global, function

The full schema is documented in skill/dsh-python-plugin/references/manifest.md in the bridge repository.

Test

pip install -e .[test]
pytest

Release

Publishing is a GitHub Actions workflow (.github/workflows/publish-pypi.yml): pytest runs across supported Python versions, the wheel builds and smoke-tests, and a pushed v* tag publishes to PyPI via trusted publishing (OIDC). Until the PyPI publisher is configured, cut the first release manually from a local build:

cd python/sdk-dsl
python -m pip install build twine
python -m build --outdir dist
twine upload dist/*

License

MIT.