mycohive-claw 4.0.0

package/dist/openclaw-api.js

@@ -0,0 +1,8 @@
+/**
+ * OpenClaw API 类型定义
+ * 版本: v4.0.0
+ *
+ * 来自 OpenClaw Plugin SDK 的 API 接口类型
+ */
+export {};
+//# sourceMappingURL=openclaw-api.js.map

package/dist/openclaw-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openclaw-api.js","sourceRoot":"","sources":["../src/openclaw-api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/rate-limiter.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Rate Limiter 模块
+ * 版本: v4.0.0
+ *
+ * 基于 Token Bucket 的限流器
+ */
+export interface RateLimiterConfig {
+    maxTokens: number;
+    refillRate: number;
+    windowMs: number;
+    maxRequestsPerWindow: number;
+}
+export declare class RateLimiter {
+    private config;
+    private tokens;
+    private lastRefill;
+    private requests;
+    private logger;
+    constructor(config?: Partial<RateLimiterConfig>);
+    /**
+     * 检查是否允许请求
+     * @param key 标识符（如 sessionKey）
+     * @returns 是否允许
+     */
+    tryAcquire(key: string): boolean;
+    /**
+     * 获取剩余请求次数
+     */
+    getRemaining(key: string): number;
+    /**
+     * 重置限流器
+     */
+    reset(key?: string): void;
+    /**
+     * 消耗令牌
+     */
+    private tryConsume;
+    /**
+     * 补充令牌
+     */
+    private refill;
+}
+export declare function getRateLimiter(key: string, config?: RateLimiterConfig): RateLimiter;
+export declare function resetAllRateLimiters(): void;
+export declare function disposeRateLimiters(): void;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../src/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAcD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,MAAM,CAAsC;gBAExC,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAM/C;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAsBhC;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAejC;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAUzB;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;OAEG;IACH,OAAO,CAAC,MAAM;CAUf;AAgCD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,WAAW,CAEnF;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/rate-limiter.js

@@ -0,0 +1,134 @@
+/**
+ * Rate Limiter 模块
+ * 版本: v4.0.0
+ *
+ * 基于 Token Bucket 的限流器
+ */
+import { getLogger } from "./logger.js";
+const DEFAULT_CONFIG = {
+    maxTokens: 100,
+    refillRate: 10, // 每秒10个
+    windowMs: 60000, // 1分钟
+    maxRequestsPerWindow: 100,
+};
+export class RateLimiter {
+    config;
+    tokens;
+    lastRefill;
+    requests = new Map();
+    logger = getLogger().child("[RateLimiter]");
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.tokens = this.config.maxTokens;
+        this.lastRefill = Date.now();
+    }
+    /**
+     * 检查是否允许请求
+     * @param key 标识符（如 sessionKey）
+     * @returns 是否允许
+     */
+    tryAcquire(key) {
+        this.refill();
+        // 检查窗口限流
+        const now = Date.now();
+        const entry = this.requests.get(key);
+        if (!entry || now - entry.windowStart >= this.config.windowMs) {
+            // 新窗口或新key
+            this.requests.set(key, { count: 1, windowStart: now });
+            return this.tryConsume();
+        }
+        if (entry.count >= this.config.maxRequestsPerWindow) {
+            this.logger.warn(`Rate limit exceeded for ${key}`);
+            return false;
+        }
+        entry.count++;
+        return this.tryConsume();
+    }
+    /**
+     * 获取剩余请求次数
+     */
+    getRemaining(key) {
+        this.refill();
+        const entry = this.requests.get(key);
+        if (!entry) {
+            return this.config.maxRequestsPerWindow;
+        }
+        const now = Date.now();
+        if (now - entry.windowStart >= this.config.windowMs) {
+            return this.config.maxRequestsPerWindow;
+        }
+        return Math.max(0, this.config.maxRequestsPerWindow - entry.count);
+    }
+    /**
+     * 重置限流器
+     */
+    reset(key) {
+        if (key) {
+            this.requests.delete(key);
+        }
+        else {
+            this.requests.clear();
+        }
+        this.tokens = this.config.maxTokens;
+        this.lastRefill = Date.now();
+    }
+    /**
+     * 消耗令牌
+     */
+    tryConsume() {
+        if (this.tokens > 0) {
+            this.tokens--;
+            return true;
+        }
+        this.logger.warn("Token bucket exhausted");
+        return false;
+    }
+    /**
+     * 补充令牌
+     */
+    refill() {
+        const now = Date.now();
+        const elapsed = now - this.lastRefill;
+        const tokensToAdd = Math.floor(elapsed * (this.config.refillRate / 1000));
+        if (tokensToAdd > 0) {
+            this.tokens = Math.min(this.config.maxTokens, this.tokens + tokensToAdd);
+            this.lastRefill = now;
+        }
+    }
+}
+/**
+ * 全局限流器管理器
+ */
+class RateLimiterManager {
+    limiters = new Map();
+    get(key, config) {
+        if (!this.limiters.has(key)) {
+            this.limiters.set(key, new RateLimiter(config));
+        }
+        return this.limiters.get(key);
+    }
+    reset(key) {
+        if (key) {
+            this.limiters.get(key)?.reset();
+        }
+        else {
+            for (const limiter of this.limiters.values()) {
+                limiter.reset();
+            }
+        }
+    }
+    dispose() {
+        this.limiters.clear();
+    }
+}
+const globalManager = new RateLimiterManager();
+export function getRateLimiter(key, config) {
+    return globalManager.get(key, config);
+}
+export function resetAllRateLimiters() {
+    globalManager.reset();
+}
+export function disposeRateLimiters() {
+    globalManager.dispose();
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../src/rate-limiter.ts"],"names":[],"mappings":"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"}

package/dist/result-cache.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Result Cache 模块
+ * 版本: v4.0.0
+ *
+ * 工具结果缓存，减少重复 LLM 调用。
+ * 基于内容 hash 的智能缓存，支持 TTL 和 LRU 淘汰。
+ */
+export interface CacheEntry<T> {
+    key: string;
+    value: T;
+    createdAt: number;
+    lastAccessedAt: number;
+    hits: number;
+}
+export interface CacheConfig {
+    maxSize: number;
+    maxAgeMs: number;
+    maxMemoryMB: number;
+}
+export declare class ResultCache<T = unknown> {
+    private cache;
+    private config;
+    private logger;
+    private totalHits;
+    private totalMisses;
+    constructor(config?: Partial<CacheConfig>);
+    /**
+     * 生成缓存 key
+     */
+    static generateKey(...parts: string[]): string;
+    /**
+     * 获取缓存值
+     */
+    get(key: string): T | null;
+    /**
+     * 设置缓存值
+     */
+    set(key: string, value: T): void;
+    /**
+     * 删除缓存项
+     */
+    delete(key: string): boolean;
+    /**
+     * 清空缓存
+     */
+    clear(): void;
+    /**
+     * 获取缓存统计
+     */
+    getStats(): {
+        size: number;
+        maxSize: number;
+        hitRate: number;
+        totalHits: number;
+        totalMisses: number;
+    };
+    /**
+     * LRU 淘汰：删除最久未访问的条目
+     */
+    private evictLRU;
+    /**
+     * 启动定期清理过期条目
+     */
+    private cleanupTimer;
+    private startCleanupTimer;
+    /**
+     * 清理过期条目
+     */
+    cleanup(): number;
+    /**
+     * 停止清理定时器
+     */
+    dispose(): void;
+}
+export declare function getResultCache<T = unknown>(): ResultCache<T>;
+//# sourceMappingURL=result-cache.d.ts.map

package/dist/result-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-cache.d.ts","sourceRoot":"","sources":["../src/result-cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAQD,qBAAa,WAAW,CAAC,CAAC,GAAG,OAAO;IAClC,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAK;gBAEZ,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAK7C;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM;IAK9C;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAuB1B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAiBhC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,QAAQ,IAAI;QACV,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB;IAaD;;OAEG;IACH,OAAO,CAAC,QAAQ;IAiBhB;;OAEG;IACH,OAAO,CAAC,YAAY,CAA+C;IAEnE,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,IAAI,MAAM;IAkBjB;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB;AAKD,wBAAgB,cAAc,CAAC,CAAC,GAAG,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,CAK5D"}

package/dist/result-cache.js

@@ -0,0 +1,158 @@
+/**
+ * Result Cache 模块
+ * 版本: v4.0.0
+ *
+ * 工具结果缓存，减少重复 LLM 调用。
+ * 基于内容 hash 的智能缓存，支持 TTL 和 LRU 淘汰。
+ */
+import { getLogger } from "./logger.js";
+import * as crypto from "crypto";
+const DEFAULT_CONFIG = {
+    maxSize: 1000,
+    maxAgeMs: 5 * 60 * 1000, // 5 分钟
+    maxMemoryMB: 50,
+};
+export class ResultCache {
+    cache = new Map();
+    config;
+    logger = getLogger().child("[ResultCache]");
+    totalHits = 0;
+    totalMisses = 0;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.startCleanupTimer();
+    }
+    /**
+     * 生成缓存 key
+     */
+    static generateKey(...parts) {
+        const content = parts.join("|");
+        return crypto.createHash("sha256").update(content).digest("hex").slice(0, 16);
+    }
+    /**
+     * 获取缓存值
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.totalMisses++;
+            return null;
+        }
+        // 检查是否过期
+        if (Date.now() - entry.createdAt > this.config.maxAgeMs) {
+            this.cache.delete(key);
+            this.totalMisses++;
+            return null;
+        }
+        // 更新访问信息
+        entry.lastAccessedAt = Date.now();
+        entry.hits++;
+        this.totalHits++;
+        return entry.value;
+    }
+    /**
+     * 设置缓存值
+     */
+    set(key, value) {
+        // 如果已满，执行 LRU 淘汰
+        if (this.cache.size >= this.config.maxSize) {
+            this.evictLRU();
+        }
+        const entry = {
+            key,
+            value,
+            createdAt: Date.now(),
+            lastAccessedAt: Date.now(),
+            hits: 0,
+        };
+        this.cache.set(key, entry);
+    }
+    /**
+     * 删除缓存项
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * 清空缓存
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * 获取缓存统计
+     */
+    getStats() {
+        const total = this.totalHits + this.totalMisses;
+        const hitRate = total > 0 ? (this.totalHits / total) * 100 : 0;
+        return {
+            size: this.cache.size,
+            maxSize: this.config.maxSize,
+            hitRate: Math.round(hitRate * 100) / 100,
+            totalHits: this.totalHits,
+            totalMisses: this.totalMisses,
+        };
+    }
+    /**
+     * LRU 淘汰：删除最久未访问的条目
+     */
+    evictLRU() {
+        let oldestKey = null;
+        let oldestTime = Infinity;
+        for (const [key, entry] of this.cache) {
+            if (entry.lastAccessedAt < oldestTime) {
+                oldestTime = entry.lastAccessedAt;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            this.cache.delete(oldestKey);
+            this.logger.debug(`Evicted LRU entry: ${oldestKey}`);
+        }
+    }
+    /**
+     * 启动定期清理过期条目
+     */
+    cleanupTimer = null;
+    startCleanupTimer() {
+        this.cleanupTimer = setInterval(() => {
+            this.cleanup();
+        }, 60000); // 每分钟清理一次
+    }
+    /**
+     * 清理过期条目
+     */
+    cleanup() {
+        const now = Date.now();
+        let removed = 0;
+        for (const [key, entry] of this.cache) {
+            if (now - entry.createdAt > this.config.maxAgeMs) {
+                this.cache.delete(key);
+                removed++;
+            }
+        }
+        if (removed > 0) {
+            this.logger.debug(`Cleaned up ${removed} expired entries`);
+        }
+        return removed;
+    }
+    /**
+     * 停止清理定时器
+     */
+    dispose() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        this.cache.clear();
+    }
+}
+// 全局缓存实例
+let globalCache = null;
+export function getResultCache() {
+    if (!globalCache) {
+        globalCache = new ResultCache();
+    }
+    return globalCache;
+}
+//# sourceMappingURL=result-cache.js.map

package/dist/result-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-cache.js","sourceRoot":"","sources":["../src/result-cache.ts"],"names":[],"mappings":"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"}

package/dist/router.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Router 模块
+ * 版本: v4.0.0
+ *
+ * 意图分析 + 自动路由的核心模块。
+ * 取消 @xxx/!! 标识，用户只需描述需求，系统自动分析并派发。
+ * 包含：dispatch 重试、熔断机制
+ */
+import { IntentAnalyzer, Intent } from "./intent-analyzer.js";
+import { EventBus } from "./event-bus.js";
+import { ContextTree } from "./context-tree.js";
+import { WorkspaceLoader } from "./workspace-loader.js";
+import type { OpenClawAPI } from "./openclaw-api.js";
+export interface RouterConfig {
+    defaultAgents: string[];
+    fallbackAgent: string;
+    confidenceThreshold: number;
+    maxRetries: number;
+    dispatchTimeoutMs: number;
+    dispatchRetries: number;
+}
+export declare class Router {
+    private sharedStateStore;
+    private analyzer;
+    private eventBus;
+    private contextTree;
+    private config;
+    private openclawApi;
+    private logger;
+    private circuitBreaker;
+    private workspaceLoader;
+    constructor(config?: Partial<RouterConfig>, eventBus?: EventBus, contextTree?: ContextTree);
+    /**
+     * 从内存 shared_state 读取（带 TTL 缓存）
+     */
+    private readSharedState;
+    /**
+     * 写入内存 shared_state（5秒 TTL）
+     */
+    private writeSharedState;
+    /**
+     * 检查是否有 route_error 并尝试 replan
+     */
+    private checkAndHandleRouteError;
+    setOpenClawAPI(api: OpenClawAPI): void;
+    setLLMClient(client: (prompt: string, context?: Record<string, unknown>) => Promise<Record<string, unknown> | string>): void;
+    setWorkspaceLoader(loader: WorkspaceLoader): void;
+    /**
+     * 核心路由方法
+     * 接收用户消息，自动分析意图并派发到对应 Agent
+     */
+    route(userMessage: string, sessionKey: string, context?: Record<string, unknown>): Promise<RoutingResult>;
+    private doRoute;
+    /**
+     * 带重试的派发
+     */
+    private dispatchWithRetry;
+    private sleep;
+    /**
+     * 派发执行计划到 Agent
+     */
+    private dispatch;
+    private dispatchSingle;
+    private getAgentConfig;
+    private getOrCreateTopic;
+    private createTopicId;
+    private createTaskId;
+    /**
+     * 确认路由（用于置信度不足时）
+     */
+    confirmAndRoute(userMessage: string, sessionKey: string, confirmedAgents: string[], context?: Record<string, unknown>): Promise<RoutingResult>;
+    /**
+     * 获取熔断器状态
+     */
+    getCircuitBreakerStats(): import("./circuit-breaker.js").CircuitBreakerStats;
+}
+export interface RoutingResult {
+    success: boolean;
+    intent: Intent;
+    plan?: ReturnType<IntentAnalyzer["generateExecutionPlan"]>;
+    topicId?: string;
+    taskId?: string;
+    reason?: string;
+    requiresConfirmation?: boolean;
+    suggestedAgents?: string[];
+    rejected?: boolean;
+}
+export declare function getRouter(): Router;
+export declare function setRouter(router: Router | null): void;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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"}