包package preview
agentscope-extensions-controlplane
AgentScope Java - Extensions - Control Plane SDK · 2.1.0-BETA1
Bypass-observation data plane SDK that reports a self-deployed AgentScope agent (session snapshots, event stream, effective context) to the Control Plane over ASDP gRPC, and serves the /agentscope/* HTTP contract in-process.
| groupIdGroupId | io.agentscope |
|---|---|
| 版本Version | 2.1.0-BETA1 |
| 版本线Line | preview |
| 分类Category | extension |
| 包Packages | 6 |
| 类型Types | 88 top-level / 142 total |
包Packages
类型Types
| 类型Type | 种类Kind | 包Package | 说明Description |
|---|---|---|---|
AgentDataPlaneServiceGrpc | 类class | io.agentscope.controlplane.proto | AgentDataPlaneService是ASDP gRPC 服务。 ```
AgentDataPlaneService is the ASDP gRPC service. |
AsdpProto | 类class | io.agentscope.controlplane.proto | ASDP 协议，承载智能体的部署、调度与服务化运行。 A class in io.agentscope.controlplane.proto that deploys, schedules and serves agents. |
ConfigAck | 类class | io.agentscope.controlplane.proto | 配置确认，承载智能体的部署、调度与服务化运行。 ```
Config acknowledgement (analogous to xDS ACK/NACK) |
ConfigAckOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义配置确认或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
ConfigPush | 类class | io.agentscope.controlplane.proto | 配置推送，承载智能体的部署、调度与服务化运行。 ```
Config push (analogous to xDS DiscoveryResponse) |
ConfigPushOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义配置推送或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
ConfigType | 枚举enum | io.agentscope.controlplane.proto | 定义配置类型的枚举。 ```
ConfigType identifies the type of configuration resource (analogous to xDS type_url). |
ConnectRequest | 类class | io.agentscope.controlplane.proto | 连接请求，承载智能体的部署、调度与服务化运行。 ```
Handshake (sent on connection establish, analogous to xDS initial DiscoveryRequest) |
ConnectRequestOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义连接请求或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
ConnectResponse | 类class | io.agentscope.controlplane.proto | 连接响应，承载智能体的部署、调度与服务化运行。 Protobuf type `agentscope.protocol.v1.ConnectResponse` |
ConnectResponseOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义连接响应或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
ContextReport | 类class | io.agentscope.controlplane.proto | 上下文报告，承载智能体的部署、调度与服务化运行。 ```
ContextReport is the Level-4 effective-context report, pushed on compaction
or when context_hash changes (debounced). |
ContextReportOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义上下文报告或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
ConversationTurnCommand | 类class | io.agentscope.controlplane.proto | 会话轮次命令，承载智能体的部署、调度与服务化运行。 ```
ConversationTurnCommand is the explicit online invocation protocol. |
ConversationTurnCommandOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义会话轮次命令或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
ConversationTurnReport | 类class | io.agentscope.controlplane.proto | 会话轮次报告，承载智能体的部署、调度与服务化运行。 Protobuf type `agentscope.protocol.v1.ConversationTurnReport` |
ConversationTurnReportOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义会话轮次报告或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
Downstream | 类class | io.agentscope.controlplane.proto | 下游，承载智能体的部署、调度与服务化运行。 Protobuf type `agentscope.protocol.v1.Downstream` |
DownstreamOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义下游或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
EventReport | 类class | io.agentscope.controlplane.proto | 事件报告，承载智能体的部署、调度与服务化运行。 ```
EventReport is the Level-2 event stream report (batched, e.g. |
EventReportAck | 类class | io.agentscope.controlplane.proto | 事件报告确认，承载智能体的部署、调度与服务化运行。 ```
EventReportAck is the durable commit acknowledgement for an EventReport. |
EventReportAckOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义事件报告确认或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
EventReportOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义事件报告或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
ExecutionAttemptCommand | 类class | io.agentscope.controlplane.proto | 执行尝试命令，承载智能体的部署、调度与服务化运行。 Protobuf type `agentscope.protocol.v1.ExecutionAttemptCommand` |
ExecutionAttemptCommandOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义执行尝试命令或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
ExecutionAttemptReport | 类class | io.agentscope.controlplane.proto | 执行尝试报告，承载智能体的部署、调度与服务化运行。 ```
ExecutionAttemptReport is fenced by attempt identity and dispatch generation. |
ExecutionAttemptReportOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义执行尝试报告或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
Heartbeat | 类class | io.agentscope.controlplane.proto | 心跳，承载智能体的部署、调度与服务化运行。 ```
Heartbeat (bidirectional keepalive) |
HeartbeatOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义心跳或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
InstanceHealth | 类class | io.agentscope.controlplane.proto | 实例健康状态，承载智能体的部署、调度与服务化运行。 ```
Instance health reported by data plane |
InstanceHealthOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义实例健康状态或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
InventoryReport | 类class | io.agentscope.controlplane.proto | 清单报告，承载智能体的部署、调度与服务化运行。 ```
InventoryReport carries the instance-level runtime inventory: subagents,
workspaces and health. |
InventoryReportOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义清单报告或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
SessionCommand | 类class | io.agentscope.controlplane.proto | 会话命令，承载智能体的部署、调度与服务化运行。 ```
SessionCommand is a control-plane → data-plane session instruction. |
SessionCommandOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义会话命令或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
SessionEventCursor | 类class | io.agentscope.controlplane.proto | 会话事件游标，承载智能体的部署、调度与服务化运行。 Protobuf type `agentscope.protocol.v1.SessionEventCursor` |
SessionEventCursorOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义会话事件游标或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
SessionEventMsg | 类class | io.agentscope.controlplane.proto | 会话事件消息，承载智能体的部署、调度与服务化运行。 Protobuf type `agentscope.protocol.v1.SessionEventMsg` |
SessionEventMsgOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义会话事件消息或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
SessionReport | 类class | io.agentscope.controlplane.proto | 会话报告，承载智能体的部署、调度与服务化运行。 ```
Session state report (periodic batch, e.g. |
SessionReportOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义会话报告或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
SessionSnapshot | 类class | io.agentscope.controlplane.proto | 会话快照，承载智能体的部署、调度与服务化运行。 Protobuf type `agentscope.protocol.v1.SessionSnapshot` |
SessionSnapshotOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义会话快照或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
SubagentInfo | 类class | io.agentscope.controlplane.proto | 子智能体信息，承载智能体的部署、调度与服务化运行。 Protobuf type `agentscope.protocol.v1.SubagentInfo` |
SubagentInfoOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义子智能体信息或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
Upstream | 类class | io.agentscope.controlplane.proto | 上游，承载智能体的部署、调度与服务化运行。 Protobuf type `agentscope.protocol.v1.Upstream` |
UpstreamMeta | 类class | io.agentscope.controlplane.proto | 上游元数据，承载智能体的部署、调度与服务化运行。 Protobuf type `agentscope.protocol.v1.UpstreamMeta` |
UpstreamMetaOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义上游元数据或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
UpstreamOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义上游或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
WorkspaceInfo | 类class | io.agentscope.controlplane.proto | 工作区信息，承载智能体的部署、调度与服务化运行。 Protobuf type `agentscope.protocol.v1.WorkspaceInfo` |
WorkspaceInfoOrBuilder | 接口interface | io.agentscope.controlplane.proto | 定义工作区信息或构建器契约的接口。 An interface in io.agentscope.controlplane.proto that defines the contract for components that deploys, schedules and serves agents. |
ControlPlane | 类class | io.agentscope.extensions.controlplane | 控制面，承载智能体的部署、调度与服务化运行。 Entry point for reporting a self-deployed agent to the controlplane control plane. |
ControlPlaneConfig | 记录record | io.agentscope.extensions.controlplane | 承载控制面配置数据的记录类型。 Connection and reporting settings for a `SessionBridge`. |
FrameworkAdapter | 接口interface | io.agentscope.extensions.controlplane | 定义 Framework 适配器契约的接口。 One adapter per agent framework, presenting a uniform view of that framework's sessions to `SessionBridge`. |
SessionBridge | 类class | io.agentscope.extensions.controlplane | 会话 Bridge，承载智能体的部署、调度与服务化运行。 The reporting engine that sits between a framework adapter and the controlplane control plane. |
AgentRuntimeSource | 接口interface | io.agentscope.extensions.controlplane.adapter | 定义智能体运行时来源契约的接口。 Optional harness-/app-specific hooks kept out of `agentscope-extensions-controlplane` so the
extension stays free of an `agentscope-harness` dependency. |
AgentScopeAdapter | 类class | io.agentscope.extensions.controlplane.adapter | AgentScope 适配器，承载智能体的部署、调度与服务化运行。 Bypass-observation adapter for a self-deployed AgentScope Java agent. |
AgentTaskOutcome | 记录record | io.agentscope.extensions.controlplane.adapter | 承载智能体任务 Outcome数据的记录类型。 A business outcome submitted by the model, independently of a physical model turn ending. |
AgentTaskOutcomeTool | 类class | io.agentscope.extensions.controlplane.adapter | 智能体任务 Outcome 工具，封装可被智能体调用的能力。 Captures intent. |
AgentTaskStarter | 接口interface | io.agentscope.extensions.controlplane.adapter | 定义智能体任务启动器契约的接口。 Starts an isolated framework execution for a durable AgentTask delivery. |
AgentTaskToolContext | 记录record | io.agentscope.extensions.controlplane.adapter | 承载智能体任务工具上下文数据的记录类型。 Per-call credentials used by task-scoped collaboration tools. |
ControlPlaneObserverMiddleware | 类class | io.agentscope.extensions.controlplane.adapter | 控制面观察者中间件，在智能体执行流程中提供横切扩展。 Middleware that copies conversation activity out to controlplane without touching it. |
HarnessAgentTaskStarter | 类class | io.agentscope.extensions.controlplane.adapter | Harness 智能体任务启动器，承载智能体的部署、调度与服务化运行。 Default Java external-agent executor for ASDP AgentTask deliveries. |
HarnessWorkspaceAgentFactory | 类class | io.agentscope.extensions.controlplane.adapter | Harness 工作区智能体工厂，承载智能体的部署、调度与服务化运行。 Loads a published definition into a fresh attempt workspace. |
SessionCompactor | 接口interface | io.agentscope.extensions.controlplane.adapter | 定义会话 Compactor契约的接口。 On-demand context compaction for a session, invoked when the control plane issues `
compress`. |
SessionHistorySource | 接口interface | io.agentscope.extensions.controlplane.adapter | 定义会话历史来源契约的接口。 Optional full-history reader for `GET /agentscope/sessions/{id}/messages`. |
WorkspaceAgentFactory | 接口interface | io.agentscope.extensions.controlplane.adapter | 定义工作区智能体工厂契约的接口。 Explicit application opt-in to consume the immutable control-plane definition per attempt. |
AgentTaskAssignment | 记录record | io.agentscope.extensions.controlplane.model | 承载智能体任务 Assignment数据的记录类型。 Immutable ASDP execution envelope for one durable AgentTask. |
ContextSnapshot | 类class | io.agentscope.extensions.controlplane.model | 上下文快照，与模型服务通信并返回生成或向量化结果。 Level-4 effective-context snapshot: what the agent's next model call will actually see. |
ContextTracker | 类class | io.agentscope.extensions.controlplane.model | 上下文 Tracker，与模型服务通信并返回生成或向量化结果。 Incrementally maintains one session's effective-context view and its `contextHash` from the
Level-2 event stream. |
Inventory | 记录record | io.agentscope.extensions.controlplane.model | 承载清单数据的记录类型。 Instance-level runtime inventory: subagents, workspaces and health, reported right after connect
and then at the Level-1 cadence. |
MessagePage | 记录record | io.agentscope.extensions.controlplane.model | 承载消息页码数据的记录类型。 A page of Level-3 full history, served by `GET /agentscope/sessions/{id}/messages`. |
SessionEvent | 类class | io.agentscope.extensions.controlplane.model | 会话事件，描述执行过程中的事件。 One Level-2 session event, mirroring the ASDP `SessionEventMsg`. |
ControlPlaneAsyncToolRegistry | 类class | io.agentscope.extensions.controlplane.store | 控制面异步工具注册表，承载智能体的部署、调度与服务化运行。 Control-plane hosted `AsyncToolRegistry` over `/api/v1/dp/async-tools/*`. |
ControlPlaneBaseStore | 类class | io.agentscope.extensions.controlplane.store | 控制面基类存储，负责持久化与读取数据。 Control-plane hosted `BaseStore` over `/api/v1/dp/kv/*`. |
ControlPlaneMessageBus | 类class | io.agentscope.extensions.controlplane.store | 控制面消息总线，承载智能体的部署、调度与服务化运行。 Control-plane hosted `MessageBus` over `/api/v1/dp/bus/*`. |
ControlPlaneSandboxExecutionGuard | 类class | io.agentscope.extensions.controlplane.store | 控制面沙箱执行守卫，承载智能体的部署、调度与服务化运行。 Control-plane hosted `SandboxExecutionGuard` over `/api/v1/dp/locks/*`. |
ControlPlaneSessionTurnGate | 类class | io.agentscope.extensions.controlplane.store | 控制面会话轮次 Gate，承载智能体的部署、调度与服务化运行。 Control-plane hosted `SessionTurnGate` over `/api/v1/dp/locks/*`. |
ControlPlaneSnapshotSpec | 类class | io.agentscope.extensions.controlplane.store | 控制面快照规格，承载智能体的部署、调度与服务化运行。 Control-plane hosted `RemoteSnapshotSpec` over `/api/v1/dp/snapshots/*`. |
ControlPlaneStores | 类class | io.agentscope.extensions.controlplane.store | 控制面 Stores，承载智能体的部署、调度与服务化运行。 Factory for control-plane hosted store components (`/api/v1/dp/*`). |
ControlPlaneTaskRepository | 类class | io.agentscope.extensions.controlplane.store | 控制面任务仓库，负责持久化与读取数据。 Control-plane hosted `TaskRepository` over `/api/v1/dp/tasks/*`. |
CollaborationClient | 类class | io.agentscope.extensions.controlplane.transport | Collaboration 客户端，封装与远端服务的连接和调用。 Issue/Comment/AgentTask client shared by Java external-agent runtimes. |
ContractHttpServer | 类class | io.agentscope.extensions.controlplane.transport | 契约 HTTP 服务端，承载智能体的部署、调度与服务化运行。 In-process HTTP server for the `/agentscope/*` contract, letting the control plane pull
on demand and issue session commands. |
ContractProvider | 接口interface | io.agentscope.extensions.controlplane.transport | 定义契约提供者契约的接口。 Backing data for the `/agentscope/*` HTTP contract, implemented by the bridge. |
ControlPlaneHttpClient | 类class | io.agentscope.extensions.controlplane.transport | 控制面 HTTP 客户端，封装与远端服务的连接和调用。 Shared JDK `HttpClient` wrapper for controlplane control-plane REST calls. |
GrpcTransport | 类class | io.agentscope.extensions.controlplane.transport | gRPC 传输层，承载智能体的部署、调度与服务化运行。 ASDP upstream channel: a single bidirectional gRPC stream multiplexing every report type, the
same shape the Go control plane and the Python SDK use. |
HttpSelfRegistration | 类class | io.agentscope.extensions.controlplane.transport | HTTP 自身注册，承载智能体的部署、调度与服务化运行。 v5 external-application registration against service-controlplane:
`POST /api/v1/agent-registrations` + periodic instance heartbeats. |
OrchestrationClient | 类class | io.agentscope.extensions.controlplane.transport | Orchestration 客户端，封装与远端服务的连接和调用。 Operator client for orchestration definitions, runs, attempts, and runtime policies. |