feat(agent): add provider inference, memory persistence and DeepSeek support

- Infer provider from tool name when not explicitly provided (e.g., "expert.researcher" → "expert")
- Append tools to existing list instead of overwriting in UTC provider registration
- Add memory flush to PostgreSQL in example CLI for session persistence
- Add DeepSeek LLM provider support

Author: frank7791

.gitignore

@@ -0,0 +1,58 @@
+# Environment variables (contains secrets)
+.env
+.env.local
+.env.*.local
+
+# Build artifacts
+/bin/
+/dist/
+/validator
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Cache
+.agent_cache.json
+*.cache
+
+# Test coverage
+coverage.out
+coverage.html
+
+# Demo examples (experimental/test code)
+cmd/example/5ways_demo/
+cmd/example/hybrid_memory_test/
+cmd/example/shared_session_test/
+cmd/example/multi_agent_memory/
+
+# Orchestration and validator tools
+cmd/orchestrate/
+cmd/validator/
+
+# Documentation (external guides)
+docs/
+
+# Multi-agent memory (legacy test at root level - binary or directory)
+/multi_agent_memory
+/multi_agent_memory/
+
+# DeepSeek model helper (external - not part of core go-agent)
+# Note: src/models/deepseek.go should be committed separately if needed
+src/models/deepseek.go
+
+# Ignore all untracked files except core modifications
+# Core modifications to keep:
+# - agent_tool.go (UTCP tool registration fix)
+# - cmd/example/main.go (memory flush fix)
+# - src/models/helper.go (DeepSeek provider support)

agent_tool.go

@@ -103,6 +103,26 @@ func (t *agentCLITransport) DeregisterToolProvider(ctx context.Context, prov bas
 }
 
 func (t *agentCLITransport) CallTool(ctx context.Context, toolName string, args map[string]any, prov base.Provider, _ *string) (any, error) {
+	// 如果 prov 为空，尝试从 toolName 推断 provider（如 "expert.researcher" → "expert"）
+	if prov == nil {
+		if parts := strings.Split(toolName, "."); len(parts) > 1 {
+			providerName := parts[0]
+			if list, ok := t.tools[providerName]; ok {
+				for _, tool := range list {
+					if tool.Name == toolName {
+						if tool.Handler == nil {
+							return nil, fmt.Errorf("tool %s has no handler", toolName)
+						}
+						return tool.Handler(ctx, args)
+					}
+				}
+				return nil, fmt.Errorf("tool %s not found in provider %s", toolName, providerName)
+			}
+		}
+		return nil, fmt.Errorf("tool %s not found (no provider specified)", toolName)
+	}
+	
+	// 原有逻辑：使用提供的 Provider
 	if p, ok := prov.(*cli.CliProvider); ok {
 		if list, ok := t.tools[p.Name]; ok {
 			for _, tool := range list {
@@ -289,7 +309,8 @@ func (a *Agent) RegisterAsUTCPProvider(ctx context.Context, client utcp.UtcpClie
 	if shim.tools == nil {
 		shim.tools = make(map[string][]tools.Tool)
 	}
-	shim.tools[tp.Name] = []tools.Tool{tool}
+	// 追加工具到现有列表，而不是覆盖
+	shim.tools[tp.Name] = append(shim.tools[tp.Name], tool)
 
 	_, err := client.RegisterToolProvider(ctx, tp)
 	return err

cmd/example/main.go

@@ -128,6 +128,11 @@ func main() {
 		fail(err)
 	}
 
+	// Flush memories to PostgreSQL (persist short-term memory to long-term storage)
+	if err := ag.Flush(ctx, *flagSession); err != nil {
+		fmt.Fprintf(os.Stderr, "warning: failed to flush memories: %v\n", err)
+	}
+
 	// 6) Print
 	if *flagJSON {
 		enc := json.NewEncoder(os.Stdout)

src/models/helper.go

@@ -54,6 +54,8 @@ func NewLLMProvider(ctx context.Context, provider string, model string, promptPr
 	switch provider {
 	case "openai":
 		agent = NewOpenAILLM(model, promptPrefix)
+	case "deepseek":
+		agent = NewDeepSeekLLM(model, promptPrefix)
 	case "gemini", "google":
 		agent, err = NewGeminiLLM(ctx, model, promptPrefix)
 	case "ollama":