+
+
+ {children}
+
+
-
-
-
-# Seata-go: Simple Extensible Autonomous Transaction Architecture(Go version)
-
-[](https://github.com/apache/incubator-seata-go/actions/workflows/build.yml) [](https://www.apache.org/licenses/LICENSE-2.0.html) [](https://codecov.io/gh/apache/incubator-seata-go) [简体中文 ZH](./README_ZH.md)
-
-## What is Seata-go?
-
-Apache Seata(incubating) is a very mature distributed transaction framework, and is the de facto standard platform for distributed transaction technology in the Java field. Seata-go is the implementation version of go language in Seata multilingual ecosystem, which realizes the interoperability between Java and Go, so that Go developers can also use seata-go to realize distributed transactions. Please visit the [official website of Seata](https://seata.apache.org/) to view the quick start and documentation.
-
-The principle of seata-go is consistent with that of Seata-java, which is composed of TM, RM and TC. The functions of TC are reused in Java, and the functions of TM and RM have been connected with Seata-java.
-### Distributed Transaction Problem in Microservices
-
-Let's imagine a traditional monolithic application. Its business is built up with 3 modules. They use a single local data source.
-
-Naturally, data consistency will be guaranteed by the local transaction.
-
-
-
-Things have changed in a microservices architecture. The 3 modules mentioned above are designed to be 3 services on top of 3 different data sources ([Pattern: Database per service](http://microservices.io/patterns/data/database-per-service.html)). Data consistency within every single service is naturally guaranteed by the local transaction.
-
-**But how about the whole business logic scope?**
-
-
-
-### How Seata-go do?
-
-Seata-go is just a solution to the problem mentioned above.
-
-
-
-Firstly, how to define a **Distributed Transaction**?
-
-We say, a **Distributed Transaction** is a **Global Transaction** which is made up with a batch of **Branch Transaction**, and normally **Branch Transaction** is just **Local Transaction**.
-
-
-
-There are three roles in Seata-go:
-
-- **Transaction Coordinator(TC):** Maintain status of global and branch transactions, drive the global commit or rollback.
-- **Transaction Manager(TM):** Define the scope of global transaction: begin a global transaction, commit or rollback a global transaction.
-- **Resource Manager(RM):** Manage resources that branch transactions working on, talk to TC for registering branch transactions and reporting status of branch transactions, and drive the branch transaction commit or rollback.
-
-
-
-A typical lifecycle of Seata-go managed distributed transaction:
-
-1. TM asks TC to begin a new global transaction. TC generates an XID representing the global transaction.
-2. XID is propagated through microservices' invoke chain.
-3. RM registers local transaction as a branch of the corresponding global transaction of XID to TC.
-4. TM asks TC for committing or rollbacking the corresponding global transaction of XID.
-5. TC drives all branch transactions under the corresponding global transaction of XID to finish branch committing or rollbacking.
-
-
-
-For more details about principle and design, please go to [Seata wiki page](https://github.com/apache/incubator-seata/wiki).
-
-### History
-
-##### Alibaba
-
-- **TXC**: Taobao Transaction Constructor. Alibaba middleware team started this project since 2014 to meet the distributed transaction problems caused by application architecture change from monolithic to microservices.
-- **GTS**: Global Transaction Service. TXC as an Aliyun middleware product with new name GTS was published since 2016.
-- **Fescar**: we started the open source project Fescar based on TXC/GTS since 2019 to work closely with the community in the future.
-
-
-##### Ant Financial
-
-- **XTS**: Extended Transaction Service. Ant Financial middleware team developed the distributed transaction middleware since 2007, which is widely used in Ant Financial and solves the problems of data consistency across databases and services.
-
-- **DTX**: Distributed Transaction Extended. Since 2013, XTS has been published on the Ant Financial Cloud, with the name of DTX .
-
-
-##### Seata Community
-
-- **Seata** :Simple Extensible Autonomous Transaction Architecture. Ant Financial joins Fescar, which make it to be a more neutral and open community for distributed transaction, and Fescar be renamed to Seata.
-
-
-
-## How to run？
-
-```go
-go get seata.apache.org/seata-go@v2.0.0
-
-```
-
-if you want to know how to use and integrate seata-go, please refer to [apache/seata-go-samples](https://github.com/apache/incubator-seata-go-samples)
-
-## How to find the latest version
-Visit Seata-Go's GitHub Releases page
-
-Open:
-https://github.com/seata/seata-go/releases
-
-The latest tag / release is the latest stable version.
-
-
-## Documentation
-
-
-You can view the full documentation from Seata Official Website: [Seata Website page](https://seata.apache.org/zh-cn/docs/overview/what-is-seata).
-
-## Reporting bugs
-
-Please follow the [template](.github/ISSUE_TEMPLATE/BUG_REPORT_TEMPLATE.md) for reporting any issues.
-
-## Security
-
-Please do not use our public issue tracker but refer to our [security policy](https://github.com/apache/incubator-seata/blob/2.x/SECURITY.md)
-
-## Contributing
-
-Seata-go is currently in the construction stage. Welcome colleagues in the industry to join the group and work with us to promote the construction of seata-go! If you want to contribute code to seata-go, you can refer to the [**code contribution Specification**](./CONTRIBUTING_CN.md) document to understand the specifications of the community, or you can join our community DingTalk group: 33069364 and communicate together!
-
-
-## Contact
-
-* Mailing list:
- * dev@seata.apache.org , for dev/user discussion. [subscribe](mailto:dev-subscribe@seata.apache.org), [unsubscribe](mailto:dev-unsubscribe@seata.apache.org), [archive](https://lists.apache.org/list.html?dev@seata.apache.org)
-* Online chat:
-
-| Dingtalk group | Wechat official account | QQ group | Wechat assistant |
-|:---------------------------------------------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------------------------:|
-|
-
| 
| 
| 
|
-
-## Seata ecosystem
-
-* [Seata Website](https://github.com/apache/incubator-seata.github.io) - Seata official website
-* [Seata](https://github.com/apache/incubator-seata)- Seata client and server
-* [Seata GoLang](https://github.com/apache/incubator-seata-go) - Seata GoLang client and server
-* [Seata Samples](https://github.com/apache/incubator-seata-samples) - Samples for Seata
-* [Seata GoLang Samples](https://github.com/apache/incubator-seata-go-samples) - Samples for Seata GoLang
-* [Seata K8s](https://github.com/apache/incubator-seata-k8s) - Seata integration with k8s
-* [Seata CLI](https://github.com/apache/incubator-seata-ctl) - CLI tool for Seata
-
-## Contributors
-
-This project exists thanks to all the people who contribute. [[Contributors](https://github.com/apache/incubator-seata-go/graphs/contributors)].
-
-## License
-
-Seata-go is under the Apache 2.0 license. See the [LICENSE](https://github.com/apache/incubator-seata-go/blob/master/LICENSE) file for details.
diff --git a/README_ZH.md b/README_ZH.md
deleted file mode 100644
index 818cb49f1..000000000
--- a/README_ZH.md
+++ /dev/null
@@ -1,164 +0,0 @@
-
-
-
-
-
-
-
-# Seata-go：简单可扩展的自主事务架构（Go 语言版本）
-
-[](https://github.com/apache/incubator-seata-go/actions/workflows/build.yml) [](https://www.apache.org/licenses/LICENSE-2.0.html) [](https://codecov.io/gh/apache/incubator-seata-go) [English](./README.md)
-
-
-## 什么是 Seata-go？
-
-
-Apache Seata（incubating）是一个非常成熟的分布式事务框架，是 Java 领域事实上的标准分布式事务平台。Seata-go 是其在多语言生态中 Go 语言的实现版本，实现了 Java 与 Go 之间的互操作，使得 Go 开发者也可以使用 seata-go 实现分布式事务。请访问 [Seata 官网](https://seata.apache.org/) 获取快速入门和文档。
-
-Seata-go 的原理与 Seata-java 一致，由 TM、RM 和 TC 三部分组成。其中 TC 功能复用 Java 的实现，而 TM 和 RM 则已与 Seata-java 对接。
-
-### 微服务中的分布式事务问题
-
-假设我们有一个传统的单体应用，其业务由三个模块组成，使用一个本地数据源，自然由本地事务保障数据一致性。
-
-但在微服务架构中，这三个模块被设计成了三个不同的服务，分别使用不同的数据源（[数据库每服务模式](http://microservices.io/patterns/data/database-per-service.html)）。单个服务内的数据一致性可以通过本地事务保障。
-
-但**整个业务范围的一致性如何保障？**
-
-
-
-### Seata-go 如何做？
-
-Seata-go 就是为了解决上述问题而生。
-
-首先，如何定义一个**分布式事务**？
-我们认为，分布式事务是一个**全局事务**，由一组**分支事务**组成，而**分支事务**通常就是**本地事务**。
-
-
-
-Seata-go 中有三个角色：
-
-- **事务协调器（TC）**：维护全局和分支事务的状态，驱动全局提交或回滚。
-
-- **事务管理器（TM）**：定义全局事务的范围，开始、提交或回滚全局事务。
-
-- **资源管理器（RM）**：管理分支事务所处理的资源，与 TC 通信注册分支事务并报告状态，驱动分支事务提交或回滚。
- 
-
-
-Seata-go 分布式事务的典型生命周期如下：
-
-
-
-1. TM 请求 TC 开启一个新的全局事务，TC 生成表示全局事务的 XID。
-
-2. XID 在微服务调用链中传播。
-
-3. RM 将本地事务注册为该 XID 对应的全局事务的分支事务。
-
-4. TM 请求 TC 提交或回滚该 XID 对应的全局事务。
-
-5. TC 驱动该 XID 对应的所有分支事务进行提交或回滚。
-
-
-
-更多原理和设计细节，请参阅 [Seata Wiki 页面](https://github.com/apache/incubator-seata/wiki)。
-
-
-
-### 历史背景
-
-##### 阿里巴巴
-
-- **TXC**：淘宝事务构建器。2014 年阿里中间件团队启动，用于应对从单体架构转向微服务带来的分布式事务问题。
-
-- **GTS**：全局事务服务。2016 年 TXC 在阿里云上线，更名为 GTS。
-
-- **Fescar**：2019 年开始基于 TXC/GTS 启动开源项目 Fescar，与社区合作。
-
-##### 蚂蚁金服
-
-- **XTS**：扩展事务服务。自 2007 年开始开发的分布式事务中间件，被广泛应用于蚂蚁金服，解决跨库跨服务数据一致性问题。
-
-- **DTX**：分布式事务扩展。2013 年起在蚂蚁金服云发布，命名为 DTX。
-##### Seata 社区
-
-- **Seata**：简单可扩展的自主事务架构。蚂蚁金服加入 Fescar，使其成为一个更加中立开放的社区，Fescar 更名为 Seata。
-
-## 如何运行？
-```go
-
-go get seata.apache.org/seata-go@2.0.0
-
-```
-如果你想了解如何使用和集成 seata-go，请参考 [apache/seata-go-samples](https://github.com/apache/incubator-seata-go-samples)
-## 如何查找最新版本
-访问 Seata-Go 的 GitHub Releases 页面
-
-打开：https://github.com/seata/seata-go/releases
-
-最新的 tag / release 就是目前的最新稳定版本。
-## 文档
-
-你可以访问 Seata 官方网站获取完整文档：[Seata 官网](https://seata.apache.org/zh-cn/docs/overview/what-is-seata)
-## 问题报告
-
-若有问题，请遵循 [模板](./.github/ISSUE_TEMPLATE/BUG_REPORT_TEMPLATE.md) 报告问题。
-
-## 安全
-
-请勿使用公开的问题跟踪器，详情请参阅我们的 [安全政策](https://github.com/apache/incubator-seata/blob/2.x/SECURITY.md)
-
-## 参与贡献
-Seata-go 当前处于建设阶段，欢迎业界同仁加入我们，共同推进 Seata-go 建设！如果你想为 Seata-go 贡献代码，请参考 [代码贡献规范](./CONTRIBUTING_CN.md)，也可以加入我们的社区钉钉群：33069364 一起交流！
-
-## 联系方式
-
-* 邮件列表：
-
- * dev@seata.apache.org - 用于开发/用户讨论 [订阅](mailto:dev-subscribe@seata.apache.org)、[取消订阅](mailto:dev-unsubscribe@seata.apache.org)、[归档](https://lists.apache.org/list.html?dev@seata.apache.org)
-
-* 在线交流：
-
-| 钉钉 | 微信公众号 | QQ | 微信助手 |
-|:---------------------------------------------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------------------------------------:|:---------------------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------------------------:|
-|
-
- | | | |
-
-
-## Seata 生态系统
-
-* [Seata 官网](https://github.com/apache/incubator-seata.github.io)- Seata官方网站
-
-* [Seata](https://github.com/apache/incubator-seata) - Seata 客户端和服务端
-
-* [Seata GoLang](https://github.com/apache/incubator-seata-go) - Seata Go 客户端和服务端
-
-* [Seata 示例](https://github.com/apache/incubator-seata-samples)- Seata 示例
-
-* [Seata Go 示例](https://github.com/apache/incubator-seata-go-samples)- Seata GoLang 示例
-
-* [Seata K8s 集成](https://github.com/apache/incubator-seata-k8s)- Seata 与 K8S 集成
-
-* [Seata 命令行工具](https://github.com/apache/incubator-seata-ctl)- Seata CLI 工具
-
-## 贡献者
-
-Seata-go感谢所有贡献者的付出。[[贡献者列表](https://github.com/apache/incubator-seata-go/graphs/contributors)]
-## 许可证
-
-Seata-go 使用 Apache 2.0 协议，详情请查看 [LICENSE 文件](https://github.com/apache/incubator-seata-go/blob/master/LICENSE)
diff --git a/a2a/api/proto/v1/a2a.proto b/a2a/api/proto/v1/a2a.proto
new file mode 100644
index 000000000..5c0538c27
--- /dev/null
+++ b/a2a/api/proto/v1/a2a.proto
@@ -0,0 +1,783 @@
+// Licensed to the Apache Software Foundation (ASF) under one or more
+// contributor license agreements. See the NOTICE file distributed with
+// this work for additional information regarding copyright ownership.
+// The ASF licenses this file to You under the Apache License, Version 2.0
+// (the "License"); you may not use this file except in compliance with
+// the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Older protoc compilers don't understand edition yet.
+
+
+syntax = "proto3";
+package a2a.v1;
+
+import "google/api/annotations.proto";
+import "google/api/client.proto";
+import "google/api/field_behavior.proto";
+import "google/protobuf/empty.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/timestamp.proto";
+
+option csharp_namespace = "A2a.V1";
+option go_package = "google.golang.org/a2a/v1";
+option java_multiple_files = true;
+option java_outer_classname = "A2A";
+option java_package = "com.google.a2a.v1";
+
+// A2AService defines the gRPC version of the A2A protocol. This has a slightly
+// different shape than the JSONRPC version to better conform to AIP-127,
+// where appropriate. The nouns are AgentCard, Message, Task and
+// TaskPushNotificationConfig.
+// - Messages are not a standard resource so there is no get/delete/update/list
+// interface, only a send and stream custom methods.
+// - Tasks have a get interface and custom cancel and subscribe methods.
+// - TaskPushNotificationConfig are a resource whose parent is a task.
+// They have get, list and create methods.
+// - AgentCard is a static resource with only a get method.
+service A2AService {
+ // Send a message to the agent. This is a blocking call that will return the
+ // task once it is completed, or a LRO if requested.
+ rpc SendMessage(SendMessageRequest) returns (SendMessageResponse) {
+ option (google.api.http) = {
+ post: "/v1/message:send"
+ body: "*"
+ };
+ }
+ // SendStreamingMessage is a streaming call that will return a stream of
+ // task update events until the Task is in an interrupted or terminal state.
+ rpc SendStreamingMessage(SendMessageRequest) returns (stream StreamResponse) {
+ option (google.api.http) = {
+ post: "/v1/message:stream"
+ body: "*"
+ };
+ }
+
+ // Get the current state of a task from the agent.
+ rpc GetTask(GetTaskRequest) returns (Task) {
+ option (google.api.http) = {
+ get: "/v1/{name=tasks/*}"
+ };
+ option (google.api.method_signature) = "name";
+ }
+ // Cancel a task from the agent. If supported one should expect no
+ // more task updates for the task.
+ rpc CancelTask(CancelTaskRequest) returns (Task) {
+ option (google.api.http) = {
+ post: "/v1/{name=tasks/*}:cancel"
+ body: "*"
+ };
+ }
+ // TaskSubscription is a streaming call that will return a stream of task
+ // update events. This attaches the stream to an existing in process task.
+ // If the task is complete the stream will return the completed task (like
+ // GetTask) and close the stream.
+ rpc TaskSubscription(TaskSubscriptionRequest)
+ returns (stream StreamResponse) {
+ option (google.api.http) = {
+ get: "/v1/{name=tasks/*}:subscribe"
+ };
+ }
+
+ // List tasks with optional filtering
+ rpc ListTasks(ListTasksRequest) returns (ListTasksResponse) {
+ option (google.api.http) = {
+ get: "/v1/tasks"
+ };
+ }
+
+ // Set a push notification config for a task.
+ rpc CreateTaskPushNotification(CreateTaskPushNotificationConfigRequest)
+ returns (TaskPushNotificationConfig) {
+ option (google.api.http) = {
+ post: "/v1/{parent=tasks/*/pushNotificationConfigs}"
+ body: "config"
+ };
+ option (google.api.method_signature) = "parent,config";
+ }
+ // Get a push notification config for a task.
+ rpc GetTaskPushNotification(GetTaskPushNotificationConfigRequest)
+ returns (TaskPushNotificationConfig) {
+ option (google.api.http) = {
+ get: "/v1/{name=tasks/*/pushNotificationConfigs/*}"
+ };
+ option (google.api.method_signature) = "name";
+ }
+ // Get a list of push notifications configured for a task.
+ rpc ListTaskPushNotification(ListTaskPushNotificationConfigRequest)
+ returns (ListTaskPushNotificationConfigResponse) {
+ option (google.api.http) = {
+ get: "/v1/{parent=tasks/*}/pushNotificationConfigs"
+ };
+ option (google.api.method_signature) = "parent";
+ }
+ // GetAgentCard returns the agent card for the agent.
+ rpc GetAgentCard(GetAgentCardRequest) returns (AgentCard) {
+ option (google.api.http) = {
+ get: "/v1/card"
+ };
+ }
+ // Delete a push notification config for a task.
+ rpc DeleteTaskPushNotification(DeleteTaskPushNotificationConfigRequest)
+ returns (google.protobuf.Empty) {
+ option (google.api.http) = {
+ delete: "/v1/{name=tasks/*/pushNotificationConfigs/*}"
+ };
+ option (google.api.method_signature) = "name";
+ }
+}
+
+///////// Data Model ////////////
+
+// Configuration of a send message request.
+message SendMessageConfiguration {
+ // The output modes that the agent is expected to respond with.
+ repeated string accepted_output_modes = 1;
+ // A configuration of a webhook that can be used to receive updates
+ PushNotificationConfig push_notification = 2;
+ // The maximum number of messages to include in the history. if 0, the
+ // history will be unlimited.
+ int32 history_length = 3;
+ // If true, the message will be blocking until the task is completed. If
+ // false, the message will be non-blocking and the task will be returned
+ // immediately. It is the caller's responsibility to check for any task
+ // updates.
+ bool blocking = 4;
+}
+
+// Task is the core unit of action for A2A. It has a current status
+// and when results are created for the task they are stored in the
+// artifact. If there are multiple turns for a task, these are stored in
+// history.
+message Task {
+ // Unique identifier (e.g. UUID) for the task, generated by the server for a
+ // new task.
+ string id = 1;
+ // Unique identifier (e.g. UUID) for the contextual collection of interactions
+ // (tasks and messages). Created by the A2A server.
+ string context_id = 2;
+ // The current status of a Task, including state and a message.
+ TaskStatus status = 3;
+ // A set of output artifacts for a Task.
+ repeated Artifact artifacts = 4;
+ // protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
+ // The history of interactions from a task.
+ repeated Message history = 5;
+ // protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
+ // Type identifier for A2A protocol, should be "task"
+ string kind = 6;
+ // A key/value object to store custom metadata about a task.
+ google.protobuf.Struct metadata = 7;
+}
+
+// The set of states a Task can be in.
+enum TaskState {
+ TASK_STATE_UNSPECIFIED = 0;
+ // Represents the status that acknowledges a task is created
+ TASK_STATE_SUBMITTED = 1;
+ // Represents the status that a task is actively being processed
+ TASK_STATE_WORKING = 2;
+ // Represents the status a task is finished. This is a terminal state
+ TASK_STATE_COMPLETED = 3;
+ // Represents the status a task is done but failed. This is a terminal state
+ TASK_STATE_FAILED = 4;
+ // Represents the status a task was cancelled before it finished.
+ // This is a terminal state.
+ TASK_STATE_CANCELLED = 5;
+ // Represents the status that the task requires information to complete.
+ // This is an interrupted state.
+ TASK_STATE_INPUT_REQUIRED = 6;
+ // Represents the status that the agent has decided to not perform the task.
+ // This may be done during initial task creation or later once an agent
+ // has determined it can't or won't proceed. This is a terminal state.
+ TASK_STATE_REJECTED = 7;
+ // Represents the state that some authentication is needed from the upstream
+ // client. Authentication is expected to come out-of-band thus this is not
+ // an interrupted or terminal state.
+ TASK_STATE_AUTH_REQUIRED = 8;
+}
+
+// A container for the status of a task
+message TaskStatus {
+ // The current state of this task
+ TaskState state = 1;
+ // A message associated with the status.
+ Message update = 2 [json_name = "message"];
+ // Timestamp when the status was recorded.
+ // Example: "2023-10-27T10:00:00Z"
+ google.protobuf.Timestamp timestamp = 3;
+}
+
+// Part represents a container for a section of communication content.
+// Parts can be purely textual, some sort of file (image, video, etc) or
+// a structured data blob (i.e. JSON).
+message Part {
+ oneof part {
+ string text = 1;
+ FilePart file = 2;
+ DataPart data = 3;
+ }
+ // Optional metadata associated with this part.
+ google.protobuf.Struct metadata = 4;
+}
+
+// FilePart represents the different ways files can be provided. If files are
+// small, directly feeding the bytes is supported via file_with_bytes. If the
+// file is large, the agent should read the content as appropriate directly
+// from the file_with_uri source.
+message FilePart {
+ oneof file {
+ string file_with_uri = 1;
+ bytes file_with_bytes = 2;
+ }
+ string mime_type = 3;
+ string name = 4;
+}
+
+// DataPart represents a structured blob. This is most commonly a JSON payload.
+message DataPart {
+ google.protobuf.Struct data = 1;
+}
+
+enum Role {
+ ROLE_UNSPECIFIED = 0;
+ // USER role refers to communication from the client to the server.
+ ROLE_USER = 1;
+ // AGENT role refers to communication from the server to the client.
+ ROLE_AGENT = 2;
+}
+
+// Message is one unit of communication between client and server. It is
+// associated with a context and optionally a task. Since the server is
+// responsible for the context definition, it must always provide a context_id
+// in its messages. The client can optionally provide the context_id if it
+// knows the context to associate the message to. Similarly for task_id,
+// except the server decides if a task is created and whether to include the
+// task_id.
+message Message {
+ // The unique identifier (e.g. UUID)of the message. This is required and
+ // created by the message creator.
+ string message_id = 1;
+ // The context id of the message. This is optional and if set, the message
+ // will be associated with the given context.
+ string context_id = 2;
+ // The task id of the message. This is optional and if set, the message
+ // will be associated with the given task.
+ string task_id = 3;
+ // A role for the message.
+ Role role = 4;
+ // protolint:disable REPEATED_FIELD_NAMES_PLURALIZED
+ // Parts is the container of the message content.
+ repeated Part content = 5;
+ // protolint:enable REPEATED_FIELD_NAMES_PLURALIZED
+ // Type identifier for A2A protocol, should be "message"
+ string kind = 6;
+ // Any optional metadata to provide along with the message.
+ google.protobuf.Struct metadata = 7;
+ // The URIs of extensions that are present or contributed to this Message.
+ repeated string extensions = 8;
+}
+
+// Artifacts are the container for task completed results. These are similar
+// to Messages but are intended to be the product of a task, as opposed to
+// point-to-point communication.
+message Artifact {
+ // Unique identifier (e.g. UUID) for the artifact. It must be at least unique
+ // within a task.
+ string artifact_id = 1;
+ // A human readable name for the artifact.
+ string name = 3;
+ // A human readable description of the artifact, optional.
+ string description = 4;
+ // The content of the artifact.
+ repeated Part parts = 5;
+ // Optional metadata included with the artifact.
+ google.protobuf.Struct metadata = 6;
+ // The URIs of extensions that are present or contributed to this Artifact.
+ repeated string extensions = 7;
+}
+
+// TaskStatusUpdateEvent is a delta even on a task indicating that a task
+// has changed.
+message TaskStatusUpdateEvent {
+ // The id of the task that is changed
+ string task_id = 1;
+ // The id of the context that the task belongs to
+ string context_id = 2;
+ // The new status of the task.
+ TaskStatus status = 3;
+ // Whether this is the last status update expected for this task.
+ bool final = 4;
+ // Optional metadata to associate with the task update.
+ google.protobuf.Struct metadata = 5;
+}
+
+// TaskArtifactUpdateEvent represents a task delta where an artifact has
+// been generated.
+message TaskArtifactUpdateEvent {
+ // The id of the task for this artifact
+ string task_id = 1;
+ // The id of the context that this task belongs too
+ string context_id = 2;
+ // The artifact itself
+ Artifact artifact = 3;
+ // Whether this should be appended to a prior one produced
+ bool append = 4;
+ // Whether this represents the last part of an artifact
+ bool last_chunk = 5;
+ // Optional metadata associated with the artifact update.
+ google.protobuf.Struct metadata = 6;
+}
+
+// Configuration for setting up push notifications for task updates.
+message PushNotificationConfig {
+ // A unique identifier (e.g. UUID) for this push notification.
+ string id = 1;
+ // Url to send the notification too
+ string url = 2;
+ // Token unique for this task/session
+ string token = 3;
+ // Information about the authentication to sent with the notification
+ AuthenticationInfo authentication = 4;
+}
+
+// Defines authentication details, used for push notifications.
+message AuthenticationInfo {
+ // Supported authentication schemes - e.g. Basic, Bearer, etc
+ repeated string schemes = 1;
+ // Optional credentials
+ string credentials = 2;
+}
+
+// Defines additional transport information for the agent.
+message AgentInterface {
+ // The url this interface is found at.
+ string url = 1;
+ // The transport supported this url. This is an open form string, to be
+ // easily extended for many transport protocols. The core ones officially
+ // supported are JSONRPC, GRPC and HTTP+JSON.
+ string transport = 2;
+}
+
+// AgentCard conveys key information:
+// - Overall details (version, name, description, uses)
+// - Skills; a set of actions/solutions the agent can perform
+// - Default modalities/content types supported by the agent.
+// - Authentication requirements
+// Next ID: 19
+message AgentCard {
+ // The version of the A2A protocol this agent supports.
+ string protocol_version = 16;
+ // A human readable name for the agent.
+ // Example: "Recipe Agent"
+ string name = 1;
+ // A description of the agent's domain of action/solution space.
+ // Example: "Agent that helps users with recipes and cooking."
+ string description = 2;
+ // A URL to the address the agent is hosted at. This represents the
+ // preferred endpoint as declared by the agent.
+ string url = 3;
+ // The transport of the preferred endpoint. If empty, defaults to JSONRPC.
+ string preferred_transport = 14;
+ // Announcement of additional supported transports. Client can use any of
+ // the supported transports.
+ repeated AgentInterface additional_interfaces = 15;
+ // The service provider of the agent.
+ AgentProvider provider = 4;
+ // The version of the agent.
+ // Example: "1.0.0"
+ string version = 5;
+ // A url to provide additional documentation about the agent.
+ string documentation_url = 6;
+ // A2A Capability set supported by the agent.
+ AgentCapabilities capabilities = 7;
+ // The security scheme details used for authenticating with this agent.
+ map
+ {/* Mobile sidebar */}
+
+
+
+
+);
\ No newline at end of file
diff --git a/agenthub/frontend/src/pages/AgentDetail.tsx b/agenthub/frontend/src/pages/AgentDetail.tsx
new file mode 100644
index 000000000..aafe9a5f8
--- /dev/null
+++ b/agenthub/frontend/src/pages/AgentDetail.tsx
@@ -0,0 +1,459 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React, {useEffect, useState} from 'react';
+import {useNavigate, useParams} from 'react-router-dom';
+import {
+ Activity,
+ ArrowLeft,
+ Clock,
+ Copy,
+ ExternalLink,
+ Globe,
+ Heart,
+ Pause,
+ Play,
+ Server,
+ Settings,
+ Tag,
+ Trash2,
+ User
+} from 'lucide-react';
+import AgentHubAPI from '../services/api';
+import {RegisteredAgent} from '../types';
+import {copyToClipboard, formatDateTime, formatRelativeTime, getStatusText, isAgentOnline} from '../utils';
+
+const AgentDetail: React.FC = () => {
+ const {id} = useParams<{ id: string }>();
+ const navigate = useNavigate();
+ const [agent, setAgent] = useState(null);
+ const [loading, setLoading] = useState(true);
+ const [error, setError] = useState(null);
+
+ useEffect(() => {
+ if (id) {
+ loadAgent(id);
+ }
+ }, [id]);
+
+ const loadAgent = async (agentId: string) => {
+ try {
+ setLoading(true);
+ const response = await AgentHubAPI.getAgent(agentId);
+ if (response.success && response.data) {
+ setAgent(response.data);
+ } else {
+ setError(response.error?.error || 'Agent not found');
+ }
+ } catch (err) {
+ setError('Network error while loading agent');
+ } finally {
+ setLoading(false);
+ }
+ };
+
+ const handleStatusChange = async (newStatus: string) => {
+ if (!agent) return;
+
+ try {
+ const response = await AgentHubAPI.updateAgentStatus(agent.id, newStatus);
+ if (response.success) {
+ setAgent(prev => prev ? {...prev, status: newStatus} : null);
+ } else {
+ alert('更新状态失败: ' + (response.error?.error || 'Unknown error'));
+ }
+ } catch (error) {
+ alert('更新状态失败: 网络错误');
+ }
+ };
+
+ const handleDelete = async () => {
+ if (!agent) return;
+
+ if (!window.confirm('确定要删除这个Agent吗？此操作无法撤销。')) {
+ return;
+ }
+
+ try {
+ const response = await AgentHubAPI.removeAgent(agent.id);
+ if (response.success) {
+ navigate('/agents');
+ } else {
+ alert('删除失败: ' + (response.error?.error || 'Unknown error'));
+ }
+ } catch (error) {
+ alert('删除失败: 网络错误');
+ }
+ };
+
+ const handleHeartbeat = async () => {
+ if (!agent) return;
+
+ try {
+ const response = await AgentHubAPI.sendHeartbeat(agent.id);
+ if (response.success) {
+ setAgent(prev => prev ? {
+ ...prev,
+ last_seen: new Date().toISOString()
+ } : null);
+ alert('心跳发送成功');
+ } else {
+ alert('发送心跳失败: ' + (response.error?.error || 'Unknown error'));
+ }
+ } catch (error) {
+ alert('发送心跳失败: 网络错误');
+ }
+ };
+
+ const handleCopy = async (text: string) => {
+ const success = await copyToClipboard(text);
+ if (success) {
+ alert('已复制到剪贴板');
+ }
+ };
+
+ if (loading) {
+ return (
+ (null);
+ const [error, setError] = useState(null);
+
+ const examples = [
+ {skill: 'sentiment_analysis', description: '情感分析技能'},
+ {skill: 'keyword_extraction', description: '关键词提取技能'},
+ {skill: 'data_visualization', description: '数据可视化技能'}
+ ];
+
+ const handleSearch = async (e: React.FormEvent) => {
+ e.preventDefault();
+
+ if (!query.trim()) {
+ setError('请输入技能ID');
+ return;
+ }
+
+ try {
+ setLoading(true);
+ setError(null);
+ setResult(null);
+
+ const response = await AgentHubAPI.discoverAgents({query: query.trim()});
+
+ if (response.success && response.data) {
+ setResult(response.data);
+ } else {
+ setError(response.error?.error || 'Discovery failed');
+ }
+ } catch (err) {
+ setError('Network error during discovery');
+ } finally {
+ setLoading(false);
+ }
+ };
+
+ const handleCopyUrl = async (url: string) => {
+ const success = await copyToClipboard(url);
+ if (success) {
+ alert('URL已复制到剪贴板');
+ }
+ };
+
+ return (
+ ([]);
+ const [filteredAgents, setFilteredAgents] = useState([]);
+ const [loading, setLoading] = useState(true);
+ const [searchQuery, setSearchQuery] = useState('');
+ const [statusFilter, setStatusFilter] = useState<'all' | 'active' | 'inactive'>('all');
+ const [error, setError] = useState(null);
+
+ const filterAgents = useCallback(() => {
+ let filtered = agents;
+
+ // 搜索过滤
+ if (searchQuery) {
+ const query = searchQuery.toLowerCase();
+ filtered = filtered.filter(agent =>
+ agent.agent_card.name.toLowerCase().includes(query) ||
+ agent.agent_card.description.toLowerCase().includes(query) ||
+ agent.id.toLowerCase().includes(query) ||
+ agent.agent_card.skills.some(skill =>
+ skill.name.toLowerCase().includes(query) ||
+ skill.description.toLowerCase().includes(query) ||
+ skill.tags.some(tag => tag.toLowerCase().includes(query))
+ )
+ );
+ }
+
+ // 状态过滤
+ if (statusFilter !== 'all') {
+ if (statusFilter === 'active') {
+ filtered = filtered.filter(isAgentOnline);
+ } else {
+ filtered = filtered.filter(agent => !isAgentOnline(agent));
+ }
+ }
+
+ setFilteredAgents(filtered);
+ }, [agents, searchQuery, statusFilter]);
+
+ const loadAgents = async () => {
+ try {
+ setLoading(true);
+ const response = await AgentHubAPI.listAgents();
+ if (response.success && response.data) {
+ setAgents(response.data);
+ } else {
+ setError(response.error?.error || 'Failed to load agents');
+ }
+ } catch (err) {
+ setError('Network error while loading agents');
+ } finally {
+ setLoading(false);
+ }
+ };
+
+ useEffect(() => {
+ loadAgents();
+ }, []);
+
+ useEffect(() => {
+ filterAgents();
+ }, [filterAgents]);
+
+ const handleStatusChange = async (agentId: string, newStatus: string) => {
+ try {
+ const response = await AgentHubAPI.updateAgentStatus(agentId, newStatus);
+ if (response.success) {
+ setAgents(prev => prev.map(agent =>
+ agent.id === agentId
+ ? {...agent, status: newStatus}
+ : agent
+ ));
+ } else {
+ alert('更新状态失败: ' + (response.error?.error || 'Unknown error'));
+ }
+ } catch (error) {
+ alert('更新状态失败: 网络错误');
+ }
+ };
+
+ const handleDelete = async (agentId: string) => {
+ if (!window.confirm('确定要删除这个Agent吗？此操作无法撤销。')) {
+ return;
+ }
+
+ try {
+ const response = await AgentHubAPI.removeAgent(agentId);
+ if (response.success) {
+ setAgents(prev => prev.filter(agent => agent.id !== agentId));
+ } else {
+ alert('删除失败: ' + (response.error?.error || 'Unknown error'));
+ }
+ } catch (error) {
+ alert('删除失败: 网络错误');
+ }
+ };
+
+ const handleHeartbeat = async (agentId: string) => {
+ try {
+ const response = await AgentHubAPI.sendHeartbeat(agentId);
+ if (response.success) {
+ // 更新最后心跳时间
+ setAgents(prev => prev.map(agent =>
+ agent.id === agentId
+ ? {...agent, last_seen: new Date().toISOString()}
+ : agent
+ ));
+ } else {
+ alert('发送心跳失败: ' + (response.error?.error || 'Unknown error'));
+ }
+ } catch (error) {
+ alert('发送心跳失败: 网络错误');
+ }
+ };
+
+ if (loading) {
+ return (
+ (null);
+ const [success, setSuccess] = useState(null);
+
+ const [formData, setFormData] = useState({
+ agent_card: {
+ name: '',
+ description: '',
+ url: '',
+ iconUrl: '',
+ version: '1.0.0',
+ documentationUrl: '',
+ capabilities: {
+ streaming: false,
+ pushNotifications: false,
+ stateTransitionHistory: false
+ },
+ defaultInputModes: ['text'],
+ defaultOutputModes: ['json'],
+ skills: []
+ },
+ host: 'localhost',
+ port: 8081
+ });
+
+ const [currentSkill, setCurrentSkill] = useState({
+ id: '',
+ name: '',
+ description: '',
+ tags: [],
+ examples: [],
+ inputModes: [],
+ outputModes: []
+ });
+
+ const [showSkillForm, setShowSkillForm] = useState(false);
+ const [editingSkillIndex, setEditingSkillIndex] = useState(null);
+
+ const handleInputChange = (path: string, value: any) => {
+ setFormData(prev => {
+ const keys = path.split('.');
+ const newData = {...prev};
+ let current: any = newData;
+
+ for (let i = 0; i < keys.length - 1; i++) {
+ current = current[keys[i]];
+ }
+ current[keys[keys.length - 1]] = value;
+
+ return newData;
+ });
+ };
+
+ const addSkill = () => {
+ if (!currentSkill.id || !currentSkill.name || !currentSkill.description) {
+ setError('请填写技能的ID、名称和描述');
+ return;
+ }
+
+ const skills = [...formData.agent_card.skills];
+
+ if (editingSkillIndex !== null) {
+ skills[editingSkillIndex] = {...currentSkill};
+ setEditingSkillIndex(null);
+ } else {
+ // 检查ID是否重复
+ if (skills.some(skill => skill.id === currentSkill.id)) {
+ setError('技能ID已存在，请使用不同的ID');
+ return;
+ }
+ skills.push({...currentSkill});
+ }
+
+ handleInputChange('agent_card.skills', skills);
+ setCurrentSkill({
+ id: '',
+ name: '',
+ description: '',
+ tags: [],
+ examples: [],
+ inputModes: [],
+ outputModes: []
+ });
+ setShowSkillForm(false);
+ setError(null);
+ };
+
+ const editSkill = (index: number) => {
+ setCurrentSkill({...formData.agent_card.skills[index]});
+ setEditingSkillIndex(index);
+ setShowSkillForm(true);
+ };
+
+ const removeSkill = (index: number) => {
+ const skills = formData.agent_card.skills.filter((_, i) => i !== index);
+ handleInputChange('agent_card.skills', skills);
+ };
+
+ const handleArrayInput = (value: string, setter: (arr: string[]) => void) => {
+ const items = value.split(',').map(item => item.trim()).filter(item => item);
+ setter(items);
+ };
+
+ const validateForm = (): string | null => {
+ const {agent_card, host, port} = formData;
+
+ if (!agent_card.name.trim()) return '请输入Agent名称';
+ if (!agent_card.description.trim()) return '请输入Agent描述';
+ if (!agent_card.url.trim()) return '请输入Agent URL';
+ if (!isValidUrl(agent_card.url)) return 'Agent URL格式不正确';
+ if (!agent_card.version.trim()) return '请输入版本号';
+ if (!host.trim()) return '请输入主机地址';
+ if (!isValidPort(port)) return '端口号必须在1-65535之间';
+
+ return null;
+ };
+
+ const handleSubmit = async (e: React.FormEvent) => {
+ e.preventDefault();
+
+ const validationError = validateForm();
+ if (validationError) {
+ setError(validationError);
+ return;
+ }
+
+ try {
+ setLoading(true);
+ setError(null);
+ setSuccess(null);
+
+ const response = await AgentHubAPI.registerAgent(formData);
+
+ if (response.success) {
+ setSuccess('Agent注册成功！');
+ setTimeout(() => {
+ navigate('/agents');
+ }, 2000);
+ } else {
+ setError(response.error?.error || 'Registration failed');
+ }
+ } catch (err) {
+ setError('Network error during registration');
+ } finally {
+ setLoading(false);
+ }
+ };
+
+ const loadTemplate = () => {
+ setFormData({
+ agent_card: {
+ name: 'text-analyzer',
+ description: '文本分析代理，提供情感分析和关键词提取服务',
+ url: 'http://localhost:8081',
+ iconUrl: '',
+ version: '1.0.0',
+ documentationUrl: '',
+ capabilities: {
+ streaming: true,
+ pushNotifications: false,
+ stateTransitionHistory: false
+ },
+ defaultInputModes: ['text'],
+ defaultOutputModes: ['json'],
+ skills: [
+ {
+ id: 'sentiment_analysis',
+ name: '情感分析',
+ description: '分析文本的情感倾向',
+ tags: ['nlp', 'sentiment', 'emotion'],
+ examples: ['分析评论情感', '判断文本正负面'],
+ inputModes: ['text'],
+ outputModes: ['json']
+ },
+ {
+ id: 'keyword_extraction',
+ name: '关键词提取',
+ description: '从文本中提取关键词',
+ tags: ['nlp', 'keywords', 'extraction'],
+ examples: ['提取文档关键词', '分析主题'],
+ inputModes: ['text'],
+ outputModes: ['json']
+ }
+ ]
+ },
+ host: 'localhost',
+ port: 8081
+ });
+ };
+
+ return (
+
+
+ );
+};
+
+const SidebarContent: React.FC<{
+ navigation: Array<{ name: string; href: string; icon: any }>;
+ isCurrentPath: (path: string) => boolean;
+}> = ({navigation, isCurrentPath}) => {
+ return (
+ setSidebarOpen(false)}/>
+
+
+ {/* Static sidebar for desktop */}
+
+
+
+
+
+
+
+
+
+
+ {/* Main content */}
+
+ {/* Top nav */}
+
+
+
+
+
+
+
+ {/* Page content */}
+
+
+
+
+ AgentHub
+
+ {/* System status indicator */}
+
+
+
+
+
+ );
+};
+
+export default Layout;
\ No newline at end of file
diff --git a/agenthub/frontend/src/index.css b/agenthub/frontend/src/index.css
new file mode 100644
index 000000000..16b43a919
--- /dev/null
+++ b/agenthub/frontend/src/index.css
@@ -0,0 +1,65 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+@layer base {
+ html, body {
+ @apply h-full;
+ }
+
+ body {
+ @apply bg-gray-50 text-gray-900 font-sans;
+ }
+}
+
+@layer components {
+ .btn-primary {
+ @apply bg-primary-500 hover:bg-primary-600 text-white px-4 py-2 rounded-lg font-medium transition-colors duration-200 disabled:opacity-50 disabled:cursor-not-allowed;
+ }
+
+ .btn-secondary {
+ @apply bg-gray-200 hover:bg-gray-300 text-gray-800 px-4 py-2 rounded-lg font-medium transition-colors duration-200;
+ }
+
+ .btn-success {
+ @apply bg-success-500 hover:bg-success-600 text-white px-4 py-2 rounded-lg font-medium transition-colors duration-200;
+ }
+
+ .btn-warning {
+ @apply bg-warning-500 hover:bg-warning-600 text-white px-4 py-2 rounded-lg font-medium transition-colors duration-200;
+ }
+
+ .btn-error {
+ @apply bg-error-500 hover:bg-error-600 text-white px-4 py-2 rounded-lg font-medium transition-colors duration-200;
+ }
+
+ .card {
+ @apply bg-white rounded-lg shadow-sm border border-gray-200 p-6;
+ }
+
+ .input-field {
+ @apply w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-primary-500 focus:border-transparent outline-none;
+ }
+
+ .textarea-field {
+ @apply w-full px-3 py-2 border border-gray-300 rounded-lg focus:ring-2 focus:ring-primary-500 focus:border-transparent outline-none;
+ resize: vertical;
+ }
+}
\ No newline at end of file
diff --git a/pkg/compressor/none_compressor.go b/agenthub/frontend/src/index.tsx
similarity index 67%
rename from pkg/compressor/none_compressor.go
rename to agenthub/frontend/src/index.tsx
index 0628dbf81..303aba62b 100644
--- a/pkg/compressor/none_compressor.go
+++ b/agenthub/frontend/src/index.tsx
@@ -15,19 +15,20 @@
* limitations under the License.
*/
-package compressor
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import {BrowserRouter} from 'react-router-dom';
+import './index.css';
+import App from './App';
-type NoneCompressor struct {
-}
+const root = ReactDOM.createRoot(
+ document.getElementById('root') as HTMLElement
+);
-func (n *NoneCompressor) Compress(data []byte) ([]byte, error) {
- return data, nil
-}
-
-func (n *NoneCompressor) Decompress(data []byte) ([]byte, error) {
- return data, nil
-}
-
-func (n *NoneCompressor) GetCompressorType() CompressorType {
- return CompressorNone
-}
+root.render(
+
+
+
+
+
+
+
+
+
+
+
+ AgentHub
+智能Agent平台
+
+
+ 加载中...
+
+ );
+ }
+
+ if (error || !agent) {
+ return (
+
+
+ );
+ }
+
+ const isOnline = isAgentOnline(agent);
+
+ return (
+ ⚠️
+ Agent未找到
+{error || 'The requested agent does not exist'}
+ +
+ {/* Header */}
+
+ );
+};
+
+export default AgentDetail;
\ No newline at end of file
diff --git a/agenthub/frontend/src/pages/AgentDiscover.tsx b/agenthub/frontend/src/pages/AgentDiscover.tsx
new file mode 100644
index 000000000..f77ddf001
--- /dev/null
+++ b/agenthub/frontend/src/pages/AgentDiscover.tsx
@@ -0,0 +1,303 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React, {useState} from 'react';
+import {AlertCircle, Copy, ExternalLink, Search, Zap} from 'lucide-react';
+import AgentHubAPI from '../services/api';
+import {DiscoverResponse} from '../types';
+import {copyToClipboard} from '../utils';
+
+const AgentDiscover: React.FC = () => {
+ const [query, setQuery] = useState('');
+ const [loading, setLoading] = useState(false);
+ const [result, setResult] = useState
+
+
+
+
+
+
+
+
+ {agent.agent_card.name}
+{agent.agent_card.description}
+
+
+
+
+
+
+ {/* Main info */}
+
+
+ {/* Status */}
+
+
+ {/* Sidebar */}
+
+
+
+ {/* Skills */}
+ 状态信息
+
+
+
+
+
+
+ 运行状态
+
+ {getStatusText(agent.status)}
+
+
+
+
+
+ 最后心跳
+
+ {formatRelativeTime(agent.last_seen)}
+
+
+
+
+
+ 注册时间
+
+ {formatRelativeTime(agent.registered_at)}
+
+
+
+
+
+ 版本
+
+ v{agent.agent_card.version}
+
+
+
+
+ {/* Capabilities */}
+ 技能列表
+ {agent.agent_card.skills.length === 0 ? ( +该Agent暂无注册技能
+ ) : ( +
+ {agent.agent_card.skills.map((skill) => (
+
+ )}
+
+
+ ))}
+
+
+ {skill.name}
+ +{skill.description}
+
+ ID:
+ {skill.tags.length > 0 && (
+ {skill.id}
+
+ {skill.tags.map((tag) => (
+
+
+ )}
+ {skill.examples && skill.examples.length > 0 && (
+
+ 示例: {skill.examples.join(', ')}
+
+ )}
+
+
+ 能力配置
+
+
+
+
+ 流式处理
+
+
+
+ 推送通知
+
+
+
+ 状态历史
+
+
+ {/* Connection info */}
+
+
+
+
+ {/* Additional info */}
+ 连接信息
+
+
+
+
+
+ Agent URL
+
+
+
+
+
+
+ {agent.agent_card.url}
+
+
+ 主机地址
+
+
+
+
+ Agent ID
+
+
+
+ {agent.id}
+
+
+
+
+ {/* Timestamps */}
+ 其他信息
+
+
+
+ 输入模式
+
+
+ {agent.agent_card.defaultInputModes.map((mode) => (
+
+ {mode}
+
+ ))}
+
+
+ 输出模式
+
+ {agent.agent_card.documentationUrl && (
+
+ {agent.agent_card.defaultOutputModes.map((mode) => (
+
+ {mode}
+
+ ))}
+
+
+ 文档链接
+
+ )}
+
+
+
+
+
+ 时间信息
+
+
+
+ 注册时间
+
+
+ {formatDateTime(agent.registered_at)}
+
+
+ 最后更新
+
+
+ {formatDateTime(agent.last_seen)}
+
+
+ 最后心跳
+
+
+ {formatDateTime(agent.last_seen)}
+
+
+ {/* Header */}
+
+ );
+};
+
+export default AgentDiscover;
\ No newline at end of file
diff --git a/agenthub/frontend/src/pages/AgentList.tsx b/agenthub/frontend/src/pages/AgentList.tsx
new file mode 100644
index 000000000..bfd9810fb
--- /dev/null
+++ b/agenthub/frontend/src/pages/AgentList.tsx
@@ -0,0 +1,363 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React, {useCallback, useEffect, useState} from 'react';
+import {Link} from 'react-router-dom';
+import {Activity, ExternalLink, Heart, Pause, Play, Plus, RefreshCw, Search, Trash2, Users} from 'lucide-react';
+import AgentHubAPI from '../services/api';
+import {RegisteredAgent} from '../types';
+import {formatDateTime, formatRelativeTime, getStatusColor, getStatusText, isAgentOnline} from '../utils';
+
+const AgentList: React.FC = () => {
+ const [agents, setAgents] = useState
+
+
+
+
+
+
+ 能力发现
+通过技能ID查找对应的Agent服务地址
+
+ {/* Search form */}
+
+
+
+
+ {/* Examples */}
+
+
+
+
+ {/* Results */}
+ {result && (
+
+
+ )}
+ 发现结果
+ + {result.agents.length === 0 ? ( +
+
+ ) : (
+ 未找到匹配的Agent
++ 技能 "{query}" 未在任何Agent中注册 +
+
+ {result.agents.map((agent, index) => (
+
+ )}
+
+
+ ))}
+
+
+
+
+
+
+ 找到匹配
+
+ + {agent.name} +
++ {agent.description} +
+
+
+
+ Agent URL:
+
+
+
+
+
+ {agent.url}
+
+
+
+
+ 版本:
+ v{agent.version}
+
+
+
+ 总技能数:
+ {agent.skills.length} 个
+
+
+ {agent.capabilities && (
+
+
+ )}
+
+ {/* Show matching skills */}
+
+ 支持能力:
+ {agent.capabilities.streaming && ' 流式处理'}
+ {agent.capabilities.pushNotifications && ' 推送通知'}
+ {agent.capabilities.stateTransitionHistory && ' 状态历史'}
+
+
+
+
+ 匹配的技能:
+
+
+ {agent.skills
+ .filter(skill => skill.id.toLowerCase().includes(query.toLowerCase()) ||
+ skill.name.toLowerCase().includes(query.toLowerCase()))
+ .map(skill => (
+
+
+
+ ))}
+
+ {skill.name}
+ ({skill.id})
+
+ {skill.description}
+ {skill.tags.length > 0 && ( +
+ {skill.tags.map(tag => (
+
+ {tag}
+
+ ))}
+
+ )}
+
+
+
+
+ 示例技能ID
+
+ {examples.map((example, index) => (
+
+ ))}
+
+
+
+
+ 使用说明
+-
+
- • 输入精确的技能ID进行查找 +
- • 系统返回提供该技能的Agent信息 +
- • 可直接使用返回的URL调用Agent服务 +
- • 支持复制URL到剪贴板 +
+
+ 加载中...
+
+ );
+ }
+
+ return (
+
+ {/* Header */}
+
+ );
+};
+
+export default AgentList;
\ No newline at end of file
diff --git a/agenthub/frontend/src/pages/AgentRegister.tsx b/agenthub/frontend/src/pages/AgentRegister.tsx
new file mode 100644
index 000000000..97c97cbc0
--- /dev/null
+++ b/agenthub/frontend/src/pages/AgentRegister.tsx
@@ -0,0 +1,595 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React, {useState} from 'react';
+import {useNavigate} from 'react-router-dom';
+import {AlertCircle, CheckCircle, FileText, Plus, Save, Upload} from 'lucide-react';
+import AgentHubAPI from '../services/api';
+import {AgentSkill, RegisterRequest} from '../types';
+import {isValidPort, isValidUrl} from '../utils';
+
+const AgentRegister: React.FC = () => {
+ const navigate = useNavigate();
+ const [loading, setLoading] = useState(false);
+ const [error, setError] = useState
+
+
+ {/* Filters */}
+
+
+ + Agent 管理 +
++ 管理所有注册的Agent，共 {agents.length} 个 +
+
+
+
+
+
+
+
+ {/* Error message */}
+ {error && (
+
+
+
+
+ setSearchQuery(e.target.value)}
+ />
+
+
+
+
+
+ )}
+
+ {/* Agent list */}
+ {filteredAgents.length === 0 ? (
+ {error}
+
+
+ ) : (
+ + {agents.length === 0 ? '暂无Agent' : '无匹配结果'} +
++ {agents.length === 0 ? '开始注册您的第一个Agent' : '尝试调整搜索条件'} +
+ {agents.length === 0 && ( +
+
+
+ )}
+
+
+ )}
+
+
+
+
+
+ | + Agent + | ++ 状态 + | ++ 技能 + | ++ 最后心跳 + | ++ 操作 + | +
|---|---|---|---|---|
|
+
+
+
+
+
+
+ {agent.agent_card.name.charAt(0).toUpperCase()}
+
+
+
+
+
+
+ {agent.agent_card.name}
+
+
+
+ {agent.agent_card.description}
+
+
+ {agent.host}:{agent.port} • v{agent.agent_card.version}
+
+ |
+
+
+
+ |
+
+
+ {agent.agent_card.skills.length} 个技能
+
+
+ {agent.agent_card.skills.slice(0, 2).map(skill => skill.name).join(', ')}
+ {agent.agent_card.skills.length > 2 && '...'}
+
+ |
+
+ {formatRelativeTime(agent.last_seen)}
+
+ {formatDateTime(agent.last_seen)}
+
+ |
+
+
+
+
+
+ |
+
+ {/* Header */}
+
+
+
+ {/* Messages */}
+ {error && (
+ 注册Agent
+向AgentHub注册一个新的智能Agent
+
+
+ )}
+
+ {success && (
+
+
+
+
+ {error}
+
+
+ )}
+
+ {/* Template button */}
+
+
+
+
+ {success}
+
+
+
+
+