feat(agent-runner): prepare 4.11.x SDK protocol support#88
Open
huanghuoguoguo wants to merge 87 commits into
Open
feat(agent-runner): prepare 4.11.x SDK protocol support#88huanghuoguoguo wants to merge 87 commits into
huanghuoguoguo wants to merge 87 commits into
Conversation
- Add EBAEvent hierarchy with all unified events (message.*, group.*, friend.*, bot.*, platform.specific) - Add User, UserGroup, UserGroupMember, ChatType, MemberRole entities - Add AbstractPlatformAdapter with optional APIs and capability declaration - Add NotSupportedError for unimplemented optional APIs - All additions are backward-compatible; existing classes unchanged
# Conflicts: # pyproject.toml # src/langbot_plugin/version.py
Phase 0 integration complete - LangBot + SDK + runner repo minimal loop verified. Key changes: - Add RUN_AGENT action forwarding from runtime to plugin process - Add AgentRunner to preinitialize_component_classes for initialization - Implement Protocol v1 entities: AgentRunContext, AgentRunResult, capabilities, permissions - Add resp_message_id field to Message class for LangBot integration - Fix AgentInput.message_chain to accept list type (matches LangBot data) - Add comprehensive tests for AgentRunner protocol Integration verified: plugin:langbot/local-agent/default returns [stub] Echo response. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…support - Refactor AgentRunAPIProxy to inherit from LangBotAPIProxy, reducing code duplication - Pre-compute allowed resource IDs (frozenset) in __init__ for O(1) permission validation - Add STATE_SCOPE_LITERAL type annotation in AgentRunResult.state_updated() - Add AgentRunState TypedDict with 4 scopes (conversation, actor, subject, runner) - Remove unused base64 import from agent_run_api.py - Update documentation for params and state protocol Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- Improve AgentRunAPIProxy with state scope support (conversation/session/run) - Enhance plugin handler for agent run operations - Add better error handling and logging
Add record of all 7 runner plugins migration completed on 2026-05-13
- Add INVOKE_RERANK to PluginToRuntimeAction enum - Add invoke_rerank() method to AgentRunAPIProxy - Support reranking documents with relevance scores
Reduces code duplication by composing LangBotAPIProxy instead of directly calling plugin_runtime_handler. Adds get_tool_detail() for LLM function calling support. Changes: - Compose LangBotAPIProxy for delegated API calls - Add permission validation before each delegation - Add get_tool_detail() method for tool schema fetching - Reduce from ~460 lines to ~350 lines
Define Protocol v1 AgentRunContext with required fields: event, delivery, context (ContextAccess), bootstrap, compatibility, metadata. Add history and event pull APIs to AgentRunAPIProxy with run_id authorization. Key changes: - AgentRunContext: Protocol v1 structure with required event/delivery fields - AgentEventContext: event_id, event_type, source required - DeliveryContext: surface, streaming/edit/reaction capabilities - ContextAccess: inline_policy, available_apis for pull APIs - BootstrapContext: optional bootstrap messages (NOT core history) - CompatibilityContext: legacy Query/Pipeline fields for migration - AgentRunResult factories: all require run_id parameter - AgentRunAPIProxy: history_page, history_search, event_get, event_page - PluginToRuntimeAction: HISTORY_PAGE, HISTORY_SEARCH, EVENT_GET, EVENT_PAGE - Legacy helpers: to_v1_result(run_id), create_legacy_context with event/delivery Runner docs updated: use ctx.run_id in factories, ctx.bootstrap.messages instead of ctx.messages (demoted to bootstrap for Protocol v1).
Move the scoped type-check module list out of the test.yml workflow into a top-level mypy.ini ([mypy] files). The CI step becomes a generic `uv run mypy`, so the workflow no longer enumerates AgentRunner/MCP/daemon business modules; the scope is versioned with the source and reproducible locally with `uv run mypy`.
- ToolResource gains a parameters field (full JSON schema) so the host can prefill it and runners build LLM tools without get_tool_detail round-trips - langbot_list_assets exposes a 'skills' asset class so external harnesses can discover pipeline-visible skills under the unified tool model
# Conflicts: # pyproject.toml
# Conflicts: # pyproject.toml # src/langbot_plugin/version.py
This was referenced Jun 23, 2026
Closed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Scope
This PR prepares the SDK side of the 4.11.x AgentRunner / EBA integration branch.
Included in this branch:
RUN_AGENTforwarding for AgentRunner components.Current status
Done / unit covered:
Still intentionally out of scope for this PR:
Verification
311 passed, 10 warningsuv run python scripts/check_action_consistency.pypassed.CommonAction.HEARTBEATwarning, which is host-handled / not SDK-registered.