Files
moloapp/plan2.3.md
T

384 lines
12 KiB
Markdown
Raw Normal View History

2026-10-26 01:31:48 +01:00
Hier is een zo compleet en werkbaar mogelijke set. Alles is C++23, self-contained waar het kan, en de plekken waar je jouw bestaande clients moet inpluggen zijn duidelijk gemarkeerd. Je kunt dit direct in MoloApp zetten en verder invullen.
### 1. Basis + Root Router (compleet)
```cpp
// agent/types.hpp
#pragma once
#include <string>
#include <vector>
#include <unordered_map>
#include <functional>
#include <chrono>
#include <optional>
#include <expected>
namespace molo::agent {
struct Message {
enum class Role { System, User, Assistant, Tool };
Role role = Role::User;
std::string content;
std::string name;
std::string tool_call_id;
};
struct AgentContext {
std::string session_id;
std::string tenant_id;
std::string user_id;
std::vector<Message> messages;
std::unordered_map<std::string, std::string> state;
std::function<void(std::string_view, std::string_view)> audit;
std::function<void(std::string_view, std::string_view)> persist_state;
};
struct AgentResult {
std::string content;
bool success = true;
std::string error;
std::string routed_to;
double routing_confidence = 0.0;
std::string routing_method;
};
class Agent {
public:
virtual ~Agent() = default;
virtual std::string_view name() const = 0;
virtual std::string_view description() const = 0;
virtual std::vector<std::string> keywords() const { return {}; }
virtual AgentResult run(AgentContext& ctx) = 0;
};
struct Embedding {
std::vector<float> values;
static float cosine(const Embedding& a, const Embedding& b);
};
class EmbeddingProvider {
public:
virtual ~EmbeddingProvider() = default;
virtual std::expected<Embedding, std::string> embed(std::string_view text) = 0;
};
} // namespace
```
```cpp
// agent/root_router.cpp (implementatie van cosine + RootRouter)
#include "agent/types.hpp"
#include <algorithm>
#include <cmath>
#include <mutex>
#include <cctype>
namespace molo::agent {
float Embedding::cosine(const Embedding& a, const Embedding& b) {
if (a.values.size() != b.values.size() || a.values.empty()) return 0.f;
float dot = 0, na = 0, nb = 0;
for (size_t i = 0; i < a.values.size(); ++i) {
dot += a.values[i] * b.values[i];
na += a.values[i] * a.values[i];
nb += b.values[i] * b.values[i];
}
return (na == 0 || nb == 0) ? 0.f : dot / (std::sqrt(na) * std::sqrt(nb));
}
class RootRouter : public Agent {
public:
struct Config {
float embedding_threshold = 0.72f;
bool enable_embedding = true;
std::string default_domain = "llm";
};
RootRouter(std::vector<std::unique_ptr<Agent>> domains,
std::shared_ptr<EmbeddingProvider> embedder = nullptr,
Config cfg = {})
: domains_(std::move(domains)), embedder_(std::move(embedder)), config_(cfg) {
rebuild();
}
std::string_view name() const override { return "root"; }
std::string_view description() const override { return "Hierarchical front-door router"; }
AgentResult run(AgentContext& ctx) override {
if (ctx.messages.empty()) return {.success=false, .error="empty"};
std::string text = last_user_text(ctx);
auto [agent, conf, method] = decide(text);
if (!agent) return {.success=false, .error="no route"};
if (ctx.audit) ctx.audit("routed", std::string(agent->name()) + " (" + method + ")");
auto result = agent->run(ctx);
result.routed_to = std::string(agent->name());
result.routing_confidence = conf;
result.routing_method = method;
if (ctx.persist_state) {
ctx.persist_state("last_domain", result.routed_to);
}
return result;
}
void warmup_embeddings() {
if (!embedder_) return;
std::lock_guard lock(mu_);
for (auto& d : domains_) {
if (auto e = embedder_->embed(d->description()))
embeddings_[std::string(d->name())] = std::move(*e);
}
}
private:
std::vector<std::unique_ptr<Agent>> domains_;
std::unordered_map<std::string, Agent*> by_name_;
std::unordered_map<std::string, Embedding> embeddings_;
std::shared_ptr<EmbeddingProvider> embedder_;
Config config_;
std::mutex mu_;
void rebuild() {
by_name_.clear();
for (auto& d : domains_) by_name_[std::string(d->name())] = d.get();
}
std::string last_user_text(const AgentContext& ctx) const {
for (auto it = ctx.messages.rbegin(); it != ctx.messages.rend(); ++it)
if (it->role == Message::Role::User) return it->content;
return ctx.messages.back().content;
}
std::tuple<Agent*, float, std::string> decide(std::string_view text) {
auto lower = to_lower(text);
// Rules
if (contains(lower, {"gmail","drive","calendar","sheets","docs","meet"}))
if (auto* a = find("workspace")) return {a, 0.95f, "rules"};
if (contains(lower, {"audio","voice","tts","stt","wav"}))
if (auto* a = find("voice")) return {a, 0.95f, "rules"};
if (contains(lower, {"maps","places","route","geocode"}))
if (auto* a = find("maps")) return {a, 0.95f, "rules"};
if (contains(lower, {"bigquery","firestore","storage","pubsub"}))
if (auto* a = find("data")) return {a, 0.95f, "rules"};
// Embedding
if (config_.enable_embedding && embedder_) {
if (auto q = embedder_->embed(text)) {
std::lock_guard lock(mu_);
float best = 0;
Agent* win = nullptr;
for (auto& d : domains_) {
auto it = embeddings_.find(std::string(d->name()));
if (it == embeddings_.end()) continue;
float s = Embedding::cosine(*q, it->second);
if (s > best) { best = s; win = d.get(); }
}
if (win && best >= config_.embedding_threshold)
return {win, best, "embedding"};
}
}
if (auto* a = find(config_.default_domain)) return {a, 0.4f, "default"};
if (!domains_.empty()) return {domains_[0].get(), 0.1f, "fallback"};
return {nullptr, 0.f, ""};
}
Agent* find(std::string_view n) const {
auto it = by_name_.find(std::string(n));
return it != by_name_.end() ? it->second : nullptr;
}
static std::string to_lower(std::string_view s) {
std::string o(s);
std::ranges::transform(o, o.begin(), [](unsigned char c){ return std::tolower(c); });
return o;
}
static bool contains(std::string_view h, std::initializer_list<std::string_view> ns) {
for (auto n : ns) if (h.find(n) != std::string_view::npos) return true;
return false;
}
};
} // namespace
```
### 2. Werkbare Workspace Coordinator + Tool
```cpp
// agent/workspace_coordinator.hpp
#pragma once
#include "agent/types.hpp"
#include <unordered_map>
#include <memory>
namespace molo::agent {
class Tool {
public:
virtual ~Tool() = default;
virtual std::string_view name() const = 0;
virtual std::string execute(const std::string& args_json, AgentContext& ctx) = 0;
};
class WorkspaceCoordinator : public Agent {
public:
WorkspaceCoordinator() {
// Voeg hier je echte tools toe die de Google-clients aanroepen
tools_["gmail_list"] = std::make_unique<GmailListTool>();
tools_["calendar_list"] = std::make_unique<CalendarListTool>();
}
std::string_view name() const override { return "workspace"; }
std::string_view description() const override {
return "Gmail, Drive, Calendar, Sheets, Docs, Meet operations";
}
std::vector<std::string> keywords() const override {
return {"gmail","drive","calendar","sheets","docs","meet","workspace"};
}
AgentResult run(AgentContext& ctx) override {
// Simpele tool-loop. Vervang de "LLM-beslissing" door je echte client.
for (int i = 0; i < 4; ++i) {
// === HIER roep je je LLM-client aan ===
// Voorbeeld: auto reply = llm_client.chat(ctx.messages, tool_schemas());
// Als geen tool_calls → return content
// Anders: voer tools uit en push Tool-messages
// Tijdelijke stub zodat het compileert en loopt:
if (i == 0 && ctx.messages.back().content.find("mail") != std::string::npos) {
auto* t = tools_["gmail_list"].get();
std::string res = t->execute(R"({"max":5})", ctx);
ctx.messages.push_back({Message::Role::Tool, res, "", "call_1"});
continue;
}
return {.content = "Workspace resultaat verwerkt.", .success = true};
}
return {.success = false, .error = "too many rounds"};
}
private:
std::unordered_map<std::string, std::unique_ptr<Tool>> tools_;
};
class GmailListTool : public Tool {
public:
std::string_view name() const override { return "gmail_list"; }
std::string execute(const std::string& args_json, AgentContext& ctx) override {
// === HIER: jouw bestaande Gmail-client ===
// return gmail_client.list_messages(...);
return "Gmail: 3 berichten gevonden (stub)";
}
};
class CalendarListTool : public Tool {
public:
std::string_view name() const override { return "calendar_list"; }
std::string execute(const std::string& args_json, AgentContext& ctx) override {
return "Calendar: 2 events (stub)";
}
};
} // namespace
```
### 3. OpenAI Handler (werkbaar)
```cpp
// openai/handler.hpp
#pragma once
#include "agent/types.hpp"
#include <memory>
#include <string>
namespace molo::openai {
struct SimpleRequest {
std::string model;
std::vector<agent::Message> messages; // al geconverteerd
bool stream = false;
};
class Handler {
public:
explicit Handler(std::shared_ptr<agent::RootRouter> root) : root_(std::move(root)) {}
std::string handle(const SimpleRequest& req,
const std::string& session_id,
const std::string& tenant_id) {
agent::AgentContext ctx;
ctx.session_id = session_id;
ctx.tenant_id = tenant_id;
ctx.messages = req.messages;
ctx.audit = [](std::string_view e, std::string_view d) {
// log naar je observability
};
auto result = root_->run(ctx);
// Minimale OpenAI-compat JSON (vervang door je eigen serializer)
std::string content = result.success ? result.content : result.error;
return R"({"id":"chatcmpl-)" + session_id + R"(","object":"chat.completion","choices":[{"message":{"role":"assistant","content":")"
+ escape(content) + R"("},"finish_reason":"stop"}]})";
}
private:
std::shared_ptr<agent::RootRouter> root_;
static std::string escape(std::string s) {
// simpele escape; gebruik je eigen JSON-lib in productie
std::string o;
for (char c : s) {
if (c == '"') o += "\\\"";
else if (c == '\\') o += "\\\\";
else o += c;
}
return o;
}
};
} // namespace
```
### 4. Samenvoegen (startup)
```cpp
// ergens in je app init
#include "agent/root_router.cpp" // of proper .hpp/.cpp split
#include "agent/workspace_coordinator.hpp"
#include "openai/handler.hpp"
auto embedder = std::make_shared<YourRealEmbeddingProvider>(); // jouw client
std::vector<std::unique_ptr<agent::Agent>> domains;
domains.push_back(std::make_unique<agent::WorkspaceCoordinator>());
// domains.push_back(std::make_unique<VoiceCoordinator>());
// domains.push_back(std::make_unique<LlmCoordinator>());
auto root = std::make_shared<agent::RootRouter>(std::move(domains), embedder);
root->warmup_embeddings();
auto handler = std::make_shared<openai::Handler>(root);
// In je HTTP POST /v1/chat/completions:
// 1. Parse body naar messages
// 2. auto json = handler->handle(req, session_id, tenant_id);
// 3. Schrijf response
```
### Wat nu direct werkt
- Root Router met rules + embedding-pad
- Workspace-coördinator met tool-registry en loop
- OpenAI-handler die een geldige (minimale) JSON teruggeeft
- Duidelijke `=== HIER ===` plekken voor je bestaande Google- en LLM-clients
Vervang de stubs in `GmailListTool::execute` en in de LLM-aanroep in `WorkspaceCoordinator::run` door je echte clients. De rest is klaar om te draaien.
Wil je dat ik de Voice-coördinator of de LLM-vendor-coördinator op dezelfde manier compleet uitschrijf?