mirror of
https://gitcode.com/JianFeeeee/homeagent-sdk.git
synced 2026-09-20 17:08:01 +00:00
cb7999ca71
- sdk/plugin.go: ToolDef adds NoMemory/Cleaner fields - sdk/plugin_test.go: unit tests for NoMemory/Cleaner - all example plugins: NoMemory/Cleaner annotated for each tool - plugindev/templates.go: template shows NoMemory/Cleaner pattern - plugindev/cmd_build.go: fix ensureGoMod, buildBundle/buildTarget sdkPath param, NewPluginFactory - example/go.mod: add external dependency declarations (chromedp, gofeed) - add main.go stubs for all example plugins
467 lines
14 KiB
Go
467 lines
14 KiB
Go
package main
|
||
|
||
import (
|
||
"bytes"
|
||
"encoding/json"
|
||
"fmt"
|
||
"io"
|
||
"log"
|
||
"net"
|
||
"net/http"
|
||
"strings"
|
||
"time"
|
||
|
||
"gitcode.com/JianFeeeee/homeagent-sdk/sdk"
|
||
)
|
||
|
||
type Plugin struct {
|
||
name string
|
||
sdk *sdk.PluginSDK
|
||
server *http.Server
|
||
serverAddr string
|
||
}
|
||
|
||
func (p *Plugin) Name() string { return p.name }
|
||
|
||
func (p *Plugin) Start(s *sdk.PluginSDK) error {
|
||
s.SetAutoRestart(true)
|
||
p.sdk = s
|
||
tp := p.name + "_"
|
||
|
||
s.Settings().RegisterDef(sdk.ConfigDef{
|
||
Key: "listen", Default: "127.0.0.1:12000",
|
||
Type: "string", DisplayName: "监听地址",
|
||
Description: "A2A 服务端监听地址，设为空可禁用 HTTP 服务",
|
||
Category: p.name,
|
||
})
|
||
|
||
// Outbound: query + discover
|
||
s.RegisterTool(tp+"a2a_query", sdk.ToolDef{
|
||
Name: tp + "a2a_query", Description: "向另一个 A2A Agent 发送查询并获取回复",
|
||
Parameters: map[string]interface{}{
|
||
"type": "object",
|
||
"properties": map[string]interface{}{
|
||
"agent_url": map[string]interface{}{"type": "string", "description": "目标 Agent 的 A2A 端点 URL"},
|
||
"query": map[string]interface{}{"type": "string", "description": "发送给目标 Agent 的文本查询"},
|
||
"timeout": map[string]interface{}{"type": "integer", "description": "超时时间（秒），默认 60"},
|
||
},
|
||
"required": []string{"agent_url", "query"},
|
||
},
|
||
Cleaner: func(output string) string {
|
||
var r struct{ Content string }
|
||
if json.Unmarshal([]byte(output), &r) == nil && r.Content != "" {
|
||
return r.Content
|
||
}
|
||
return output
|
||
},
|
||
}, p.handleA2AQuery)
|
||
|
||
s.RegisterTool(tp+"a2a_discover", sdk.ToolDef{
|
||
Name: tp + "a2a_discover", Description: "获取另一个 A2A Agent 的能力描述（Agent Card）",
|
||
Parameters: map[string]interface{}{
|
||
"type": "object",
|
||
"properties": map[string]interface{}{
|
||
"agent_url": map[string]interface{}{"type": "string", "description": "目标 Agent 的 A2A 端点 URL"},
|
||
},
|
||
"required": []string{"agent_url"},
|
||
},
|
||
}, p.handleA2ADiscover)
|
||
|
||
// Management tools
|
||
s.RegisterTool(tp+"a2a_configure", sdk.ToolDef{
|
||
Name: tp + "a2a_configure", Description: "修改 A2A 插件配置并自动重启服务。支持动态更改监听地址等参数。",
|
||
Parameters: map[string]interface{}{
|
||
"type": "object",
|
||
"properties": map[string]interface{}{
|
||
"listen": map[string]interface{}{"type": "string", "description": "监听地址（如 0.0.0.0:12000，设为空字符串禁用 HTTP 服务）"},
|
||
},
|
||
},
|
||
}, p.handleConfigure)
|
||
|
||
s.RegisterTool(tp+"a2a_restart", sdk.ToolDef{
|
||
Name: tp + "a2a_restart", Description: "重启 A2A HTTP 服务端。当连接异常或配置变更后需要重新加载时使用。",
|
||
Parameters: map[string]interface{}{
|
||
"type": "object",
|
||
"properties": map[string]interface{}{},
|
||
},
|
||
}, p.handleRestart)
|
||
|
||
s.RegisterTool(tp+"a2a_status", sdk.ToolDef{
|
||
Name: tp + "a2a_status", Description: "查看 A2A 插件的运行状态，包括监听地址和当前配置。",
|
||
Parameters: map[string]interface{}{
|
||
"type": "object",
|
||
"properties": map[string]interface{}{},
|
||
},
|
||
}, p.handleStatus)
|
||
|
||
// Inbound HTTP server
|
||
if addr, _ := s.Settings().Get("listen"); addr != nil {
|
||
if addrStr, ok := addr.(string); ok && addrStr != "" {
|
||
p.startServer(addrStr)
|
||
}
|
||
}
|
||
|
||
log.Printf("[%s] started", p.name)
|
||
return nil
|
||
}
|
||
|
||
func (p *Plugin) Stop() error {
|
||
p.stopServer()
|
||
return nil
|
||
}
|
||
|
||
func (p *Plugin) stopServer() {
|
||
if p.server != nil {
|
||
p.server.Close()
|
||
p.server = nil
|
||
p.serverAddr = ""
|
||
}
|
||
}
|
||
|
||
// ---- Inbound HTTP Server ----
|
||
|
||
func (p *Plugin) startServer(addr string) {
|
||
mux := http.NewServeMux()
|
||
mux.HandleFunc("/agent-card", p.handleAgentCard)
|
||
mux.HandleFunc("/task", p.handleIncomingTask)
|
||
mux.HandleFunc("/a2a", p.handleIncomingA2A)
|
||
|
||
listener, err := net.Listen("tcp", addr)
|
||
if err != nil {
|
||
log.Printf("[%s] listen %s: %v", p.name, addr, err)
|
||
return
|
||
}
|
||
|
||
p.server = &http.Server{Handler: mux}
|
||
p.serverAddr = listener.Addr().String()
|
||
go func() {
|
||
log.Printf("[%s] A2A server on %s", p.name, p.serverAddr)
|
||
if err := p.server.Serve(listener); err != nil && err != http.ErrServerClosed {
|
||
log.Printf("[%s] serve: %v", p.name, err)
|
||
}
|
||
}()
|
||
}
|
||
|
||
func (p *Plugin) handleAgentCard(w http.ResponseWriter, r *http.Request) {
|
||
card := map[string]interface{}{
|
||
"name": p.name,
|
||
"description": "HomeAgent A2A Agent - 支持多工具调用与记忆管理",
|
||
"url": r.Host,
|
||
"version": "1.0.0",
|
||
"capabilities": []map[string]string{
|
||
{"id": "a2a_query", "name": "查询", "description": "接收并处理文本查询"},
|
||
{"id": "a2a_stream", "name": "流式响应", "description": "支持 SSE 流式回复"},
|
||
},
|
||
"skills": []map[string]string{
|
||
{"id": "chat", "name": "对话", "description": "通用对话与问题回答"},
|
||
},
|
||
}
|
||
w.Header().Set("Content-Type", "application/json")
|
||
json.NewEncoder(w).Encode(card)
|
||
}
|
||
|
||
func (p *Plugin) handleIncomingA2A(w http.ResponseWriter, r *http.Request) {
|
||
if r.Method == "GET" {
|
||
p.handleAgentCard(w, r)
|
||
return
|
||
}
|
||
body, _ := io.ReadAll(r.Body)
|
||
var req struct {
|
||
JSONRPC string `json:"jsonrpc"`
|
||
ID string `json:"id"`
|
||
Method string `json:"method"`
|
||
Params struct {
|
||
Query string `json:"query,omitempty"`
|
||
Message *struct {
|
||
Role string `json:"role"`
|
||
Parts []struct {
|
||
Text string `json:"text,omitempty"`
|
||
Type string `json:"type,omitempty"`
|
||
} `json:"parts"`
|
||
} `json:"message,omitempty"`
|
||
} `json:"params,omitempty"`
|
||
}
|
||
json.Unmarshal(body, &req)
|
||
|
||
switch req.Method {
|
||
case "tasks.send":
|
||
// Extract query text
|
||
queryText := req.Params.Query
|
||
if queryText == "" && req.Params.Message != nil {
|
||
for _, part := range req.Params.Message.Parts {
|
||
if part.Text != "" {
|
||
queryText += part.Text + "\n"
|
||
}
|
||
}
|
||
queryText = strings.TrimSpace(queryText)
|
||
}
|
||
|
||
// Inject into agent pipeline via interrupt (preempt current processing) or direct input
|
||
if queryText != "" {
|
||
p.sdk.InjectInterruptText("a2a", "webui", fmt.Sprintf("[来自A2A Agent的查询]\n%s", queryText))
|
||
}
|
||
|
||
// Respond with task accepted
|
||
resp := map[string]interface{}{
|
||
"jsonrpc": "2.0",
|
||
"id": req.ID,
|
||
"result": map[string]interface{}{
|
||
"id": fmt.Sprintf("task_%d", time.Now().UnixNano()),
|
||
"status": "submitted",
|
||
},
|
||
}
|
||
w.Header().Set("Content-Type", "application/json")
|
||
json.NewEncoder(w).Encode(resp)
|
||
|
||
case "tasks.get":
|
||
w.Header().Set("Content-Type", "application/json")
|
||
json.NewEncoder(w).Encode(map[string]interface{}{
|
||
"jsonrpc": "2.0", "id": req.ID,
|
||
"result": map[string]interface{}{"id": req.Params.Query, "status": "unknown"},
|
||
})
|
||
|
||
default:
|
||
http.Error(w, "unknown method", http.StatusBadRequest)
|
||
}
|
||
}
|
||
|
||
func (p *Plugin) handleIncomingTask(w http.ResponseWriter, r *http.Request) {
|
||
p.handleIncomingA2A(w, r)
|
||
}
|
||
|
||
// ---- A2A Protocol Types ----
|
||
|
||
type A2AAgentCard struct {
|
||
Name string `json:"name"`
|
||
Description string `json:"description,omitempty"`
|
||
URL string `json:"url"`
|
||
Version string `json:"version,omitempty"`
|
||
Capabilities []A2ACapability `json:"capabilities,omitempty"`
|
||
Skills []A2ASkill `json:"skills,omitempty"`
|
||
}
|
||
|
||
type A2ACapability struct {
|
||
ID string `json:"id"`
|
||
Name string `json:"name"`
|
||
Description string `json:"description,omitempty"`
|
||
}
|
||
|
||
type A2ASkill struct {
|
||
ID string `json:"id"`
|
||
Name string `json:"name"`
|
||
Description string `json:"description,omitempty"`
|
||
InputSchema string `json:"input_schema,omitempty"`
|
||
}
|
||
|
||
type A2ARequest struct {
|
||
JSONRPC string `json:"jsonrpc"`
|
||
ID string `json:"id"`
|
||
Method string `json:"method"`
|
||
Params A2AParams `json:"params,omitempty"`
|
||
}
|
||
|
||
type A2AParams struct {
|
||
Query string `json:"query,omitempty"`
|
||
Message *A2AMessage `json:"message,omitempty"`
|
||
TaskID string `json:"id,omitempty"`
|
||
}
|
||
|
||
type A2AResponse struct {
|
||
JSONRPC string `json:"jsonrpc"`
|
||
ID string `json:"id"`
|
||
Result *A2AResult `json:"result,omitempty"`
|
||
Error *A2AError `json:"error,omitempty"`
|
||
}
|
||
|
||
type A2AResult struct {
|
||
TaskID string `json:"id,omitempty"`
|
||
Status string `json:"status,omitempty"`
|
||
Message *A2AMessage `json:"message,omitempty"`
|
||
AgentCard *A2AAgentCard `json:"agent_card,omitempty"`
|
||
}
|
||
|
||
type A2AMessage struct {
|
||
Role string `json:"role"`
|
||
Parts []A2APart `json:"parts"`
|
||
}
|
||
|
||
type A2APart struct {
|
||
Text string `json:"text,omitempty"`
|
||
Data string `json:"data,omitempty"`
|
||
Type string `json:"type,omitempty"`
|
||
}
|
||
|
||
type A2AError struct {
|
||
Code int `json:"code"`
|
||
Message string `json:"message"`
|
||
}
|
||
|
||
// ---- Outbound Handlers ----
|
||
|
||
func (p *Plugin) handleA2ADiscover(args map[string]interface{}) (interface{}, error) {
|
||
agentURL, _ := args["agent_url"].(string)
|
||
agentURL = strings.TrimRight(agentURL, "/")
|
||
if !strings.HasPrefix(agentURL, "http://") && !strings.HasPrefix(agentURL, "https://") {
|
||
agentURL = "http://" + agentURL
|
||
}
|
||
|
||
cardURL := agentURL
|
||
if !strings.HasSuffix(cardURL, "/agent-card") {
|
||
cardURL = agentURL + "/agent-card"
|
||
}
|
||
|
||
client := &http.Client{Timeout: 15 * time.Second}
|
||
resp, err := client.Get(cardURL)
|
||
if err != nil {
|
||
return map[string]interface{}{"error": fmt.Sprintf("连接失败: %v", err)}, nil
|
||
}
|
||
defer resp.Body.Close()
|
||
|
||
body, _ := io.ReadAll(resp.Body)
|
||
if resp.StatusCode != http.StatusOK {
|
||
return map[string]interface{}{"error": fmt.Sprintf("状态码 %d", resp.StatusCode), "raw_body": string(body)}, nil
|
||
}
|
||
|
||
var card A2AAgentCard
|
||
if err := json.Unmarshal(body, &card); err != nil {
|
||
var fallback map[string]interface{}
|
||
if err2 := json.Unmarshal(body, &fallback); err2 == nil {
|
||
return map[string]interface{}{"agent_info": fallback, "format": "非标准格式"}, nil
|
||
}
|
||
return map[string]interface{}{"error": fmt.Sprintf("解析失败: %v", err), "raw_body": string(body)}, nil
|
||
}
|
||
|
||
return map[string]interface{}{
|
||
"name": card.Name, "description": card.Description,
|
||
"version": card.Version, "url": card.URL,
|
||
"capabilities": card.Capabilities, "skills": card.Skills,
|
||
}, nil
|
||
}
|
||
|
||
func (p *Plugin) handleA2AQuery(args map[string]interface{}) (interface{}, error) {
|
||
agentURL, _ := args["agent_url"].(string)
|
||
query, _ := args["query"].(string)
|
||
timeoutSec := 60
|
||
if v, ok := args["timeout"].(float64); ok && v > 0 {
|
||
timeoutSec = int(v)
|
||
}
|
||
|
||
agentURL = strings.TrimRight(agentURL, "/")
|
||
if !strings.HasPrefix(agentURL, "http://") && !strings.HasPrefix(agentURL, "https://") {
|
||
agentURL = "http://" + agentURL
|
||
}
|
||
|
||
taskURL := agentURL
|
||
if strings.HasSuffix(agentURL, "/agent-card") {
|
||
taskURL = strings.TrimSuffix(agentURL, "/agent-card")
|
||
}
|
||
taskURL = strings.TrimRight(taskURL, "/") + "/task"
|
||
|
||
reqBody := A2ARequest{
|
||
JSONRPC: "2.0",
|
||
ID: fmt.Sprintf("a2a_%d", time.Now().UnixNano()),
|
||
Method: "tasks.send",
|
||
Params: A2AParams{
|
||
Message: &A2AMessage{Role: "user", Parts: []A2APart{{Text: query, Type: "text"}}},
|
||
},
|
||
}
|
||
|
||
bodyData, _ := json.Marshal(reqBody)
|
||
client := &http.Client{Timeout: time.Duration(timeoutSec) * time.Second}
|
||
resp, err := client.Post(taskURL, "application/json", bytes.NewReader(bodyData))
|
||
if err != nil {
|
||
return map[string]interface{}{"error": fmt.Sprintf("请求失败(超时%d秒): %v", timeoutSec, err)}, nil
|
||
}
|
||
defer resp.Body.Close()
|
||
|
||
body, _ := io.ReadAll(resp.Body)
|
||
if resp.StatusCode != http.StatusOK {
|
||
return map[string]interface{}{"error": fmt.Sprintf("状态码 %d", resp.StatusCode), "raw_body": string(body)}, nil
|
||
}
|
||
|
||
var a2aResp A2AResponse
|
||
if err := json.Unmarshal(body, &a2aResp); err != nil {
|
||
return map[string]interface{}{"error": fmt.Sprintf("解析响应失败: %v", err), "raw_body": string(body)}, nil
|
||
}
|
||
|
||
if a2aResp.Error != nil {
|
||
return map[string]interface{}{"error": fmt.Sprintf("Agent错误 [%d]: %s", a2aResp.Error.Code, a2aResp.Error.Message)}, nil
|
||
}
|
||
if a2aResp.Result == nil {
|
||
return map[string]interface{}{"error": "空结果", "raw_body": string(body)}, nil
|
||
}
|
||
|
||
var replyText string
|
||
if a2aResp.Result.Message != nil {
|
||
for _, part := range a2aResp.Result.Message.Parts {
|
||
if part.Text != "" {
|
||
replyText += part.Text + "\n"
|
||
}
|
||
}
|
||
replyText = strings.TrimSpace(replyText)
|
||
}
|
||
|
||
return map[string]interface{}{
|
||
"task_id": a2aResp.Result.TaskID, "status": a2aResp.Result.Status,
|
||
"response": replyText,
|
||
}, nil
|
||
}
|
||
|
||
// ---- Management Handlers ----
|
||
|
||
func (p *Plugin) handleConfigure(args map[string]interface{}) (interface{}, error) {
|
||
listen, _ := args["listen"].(string)
|
||
if listen == "" {
|
||
return "参数 listen 不能为空。设为空字符串可禁用 HTTP 服务。", nil
|
||
}
|
||
|
||
if err := p.sdk.Settings().Set("listen", listen); err != nil {
|
||
return fmt.Sprintf("保存配置失败: %v", err), nil
|
||
}
|
||
|
||
p.stopServer()
|
||
if listen != "" {
|
||
p.startServer(listen)
|
||
}
|
||
|
||
status := "已启动"
|
||
if listen == "" {
|
||
status = "已禁用"
|
||
}
|
||
return fmt.Sprintf("A2A 配置已更新。监听地址: %s (%s)", listen, status), nil
|
||
}
|
||
|
||
func (p *Plugin) handleRestart(args map[string]interface{}) (interface{}, error) {
|
||
p.stopServer()
|
||
|
||
addr, _ := p.sdk.Settings().Get("listen")
|
||
addrStr, _ := addr.(string)
|
||
if addrStr == "" {
|
||
return "A2A 服务未配置监听地址（listen 为空），无法启动", nil
|
||
}
|
||
|
||
p.startServer(addrStr)
|
||
if p.server == nil {
|
||
return fmt.Sprintf("A2A 服务启动失败，请检查监听地址: %s", addrStr), nil
|
||
}
|
||
return fmt.Sprintf("A2A 服务已重启，监听: %s", p.serverAddr), nil
|
||
}
|
||
|
||
func (p *Plugin) handleStatus(args map[string]interface{}) (interface{}, error) {
|
||
addr, _ := p.sdk.Settings().Get("listen")
|
||
addrStr, _ := addr.(string)
|
||
|
||
serverRunning := p.server != nil
|
||
listening := p.serverAddr
|
||
if !serverRunning {
|
||
listening = "未运行"
|
||
}
|
||
|
||
return fmt.Sprintf("配置监听地址: %s\n当前监听: %s\n服务状态: %s",
|
||
addrStr, listening, map[bool]string{true: "运行中", false: "已停止"}[serverRunning]), nil
|
||
}
|
||
|
||
func NewPluginFactory(name string, config map[string]interface{}) (sdk.Plugin, error) {
|
||
return &Plugin{name: name}, nil
|
||
}
|