Skip to main content

LangBot Plugin Infra

Plugin SDK, CLI, Plugin Runtime and Box sandbox runtime for LangBot.

PyPI Python License

English / 简体中文

Documentation · Plugin Market · LangBot

Overview

This package is the shared infrastructure powering LangBot's plugin and sandbox subsystems. Its source lives in sdk/ of the LangBot repository. It is published to PyPI as the single langbot-plugin package and ships three things:

  • Plugin SDK & CLI (lbp) — Python APIs, base classes and the lbp command for scaffolding, building, debugging and publishing plugins.
  • Plugin Runtime (lbp rt) — the host process that discovers, installs and runs plugins, bridging them to LangBot over stdio or WebSocket.
  • Box Runtime (lbp box) — the code-sandbox service backing LangBot's Box subsystem, executing untrusted code via Docker / nsjail / E2B backends. An explicit, non-sandboxed host backend is available for trusted local development only.

LangBot depends on this package as the pinned langbot-plugin==<x.y.z> in its pyproject.toml; the canonical version lives in sdk/pyproject.toml.

The Runtime component (src/langbot_plugin/runtime/) is licensed separately under AGPL; everything else in this package is Apache 2.0. See src/langbot_plugin/runtime/README.md.

Install

pip install langbot-plugin
# or, recommended
uv tool install langbot-plugin

lbp --help

CLI at a glance

Command Purpose
lbp init <name> Scaffold a new plugin project
lbp comp <Type> Generate a component (Command / Tool / EventListener / KnowledgeEngine / Parser / Page)
lbp run Run / remote-debug a plugin against a running LangBot
lbp build Package the plugin into a distributable zip
lbp publish Publish to the LangBot Plugin Market
lbp login / lbp logout Authenticate with your LangBot account
lbp rt Launch a standalone Plugin Runtime (control 5400, debug 5401)
lbp box Launch a standalone Box sandbox runtime (default port 5410)
lbp ver Print the CLI / package version

Component types

Plugins extend LangBot through six component types, scaffolded with lbp comp <Type>:

  • Command — user-triggered actions (e.g. !weather tokyo)
  • Tool — LLM-callable functions for AI agents
  • EventListener — handlers for message-pipeline events
  • KnowledgeEngine — custom knowledge-base retrieval for RAG
  • Parser — custom message / content parsing
  • Page — custom web page embedded in the LangBot admin panel

Runner Runtime

The SDK provides Runner component definitions, protocol entities, runtime dispatch, run-scoped Host API helpers, and low-level daemon relay primitives used by runner/plugin packages that need an outbound user-side runtime process. This includes run-scoped pull APIs on RunnerAPIProxy (history, events, state, run ledger) and steering_pull for absorbing follow-up user input into an active run when the runner declares capabilities.steering in its manifest. The SDK does not provide a managed, generic remote Runner product: external harness execution policy, process launch details, authentication, workspace selection, and provider-specific behavior belong to the runner/plugin package or a deployment-owned remote daemon or managed agent platform.

Runner delivery remains backward compatible: steering_pull() consumes inputs by default; claim=True opts into leased delivery and requires steering_ack(). Acknowledgement and recovery control calls can finish after the source execution deadline, subject to Host authorization. run.cancelled is a terminal result.

Runners that implement checkpoint recovery declare spec.resume: true. Runtime advertises it through descriptor metadata, which older Hosts can ignore without rejecting the existing capability schema. A Host retry/resume returns a new run ID with a fresh deadline and current resource grants; an externally queued run retains requeue semantics. Resume receives bounded source events in ctx.runtime.metadata["recovery"]; it must restore committed work or fail rather than silently restart. The cursor fences the latest committed source result and does not rewind external effects. This is at-least-once delivery, not a promise of exactly-once tool execution.

ExecutionAPI 操作一览与作用域说明

LangBot Core 通过统一的 ExecutionAPI facade 暴露 80 项核心业务能力。插件与 Agent Runner 统一经由该 facade 与 SDK 入口访问。

  • 通用执行入口: api.execution.invoke(operation_id, **arguments) 与 api.execution.stream(...)。
  • Box 沙箱代理扩展: LangBotAPIProxy 现已提供 @run_scoped 的 bind_box, import_box_attachments, export_box_files。
  • 完整清单与作用域契约: 详见 docs/execution_api.md。

Documentation

License

Apache 2.0, except the Plugin Runtime (src/langbot_plugin/runtime/) which is AGPL. See LICENSE and the Runtime README.

Metadata

Release files for langbot-plugin 0.7.25

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for langbot-plugin 0.7.25
File Size Uploaded Provenance Actions
langbot_plugin-0.7.25.tar.gz 861.7 kB Without provenance Details for langbot_plugin-0.7.25.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for langbot-plugin 0.7.25
File Interpreter ABI Platform Actions
langbot_plugin-0.7.25-py3-none-any.whl Python 3 none any Details for langbot_plugin-0.7.25-py3-none-any.whl

Total release size: 1.4 MB

Release files / langbot_plugin-0.7.25.tar.gz

Download URL langbot_plugin-0.7.25.tar.gz
Size 861.7 kB
Tags Source
SHA-256 checksum
How to use checksums
f49ba1f7612d2f1422ddb503db8b90ffdd7a9dc7e47d0d0c5e66436dac9a29d4
BLAKE2b-256 checksum
How to use checksums
3ce398b2083130a8923a6bd0fa714df2d6f735ae86cfd998dcdc6f8e1479d0c3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / langbot_plugin-0.7.25-py3-none-any.whl

Download URL langbot_plugin-0.7.25-py3-none-any.whl
Size 533.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
355ab976b820805250637bc9a2c5e4e1f57aca11ca8a7d1640e5b24d35c4704c
BLAKE2b-256 checksum
How to use checksums
52e356a2b3d5afbe49b921818625390b7bb546d573fb7751b2a95d942d0b530b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for langbot-plugin 0.7.25

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.7.25 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page