claude-flow
Version:
Ruflo - Enterprise AI agent orchestration for Claude Code. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration
53 lines • 2.21 kB
TypeScript
/**
* GAIA Agent Contrastive Wrapper — iter 49.5
*
* Thin wrapper around runGaiaAgent that adds three ruflo intelligence hooks:
* 1. PRE: memory_search_unified for relevant patterns
* 2. DURING: trajectory recording (start/step/end) via memory store
* 3. POST: memory_store of question+answer+verdict for future recall
*
* Purpose: measure whether ruflo's AgentDB intelligence (5,930 entries,
* 26,490 patterns) provides a measurable lift on GAIA L1 when injected
* as system context before the agent loop.
*
* Design constraints:
* - Does NOT change the underlying agent loop logic
* - Does NOT enable ADR-135 tracks (critic, decomposition, voting, MoE, KG)
* - Pure addition: memory before, trajectory during, store after
* - Graceful fallback: any hook failure is logged but does NOT fail the question
*
* Refs: ADR-133, iter 49.5, #2156
*/
import type { GaiaQuestion } from './gaia-loader.js';
import { type GaiaAgentOptions, type GaiaAgentResult } from './gaia-agent.js';
export interface ContrastiveStats {
memorySearchCalls: number;
memorySearchHits: number;
memoryStoreCount: number;
trajectoryCount: number;
totalPatternsInjected: number;
}
export interface ContrastiveAgentResult extends GaiaAgentResult {
/** Number of memory patterns injected as context for this question. */
patternsInjected?: number;
/** Whether a trajectory was recorded for this question. */
trajectoryRecorded?: boolean;
/** Whether the question+answer was stored in memory after completion. */
memoryStored?: boolean;
}
/**
* Wrap runGaiaAgent with ruflo intelligence hooks.
*
* Hook points:
* 1. memory_search before the agent loop (context injection)
* 2. trajectory-start/end records via memory store
* 3. memory_store after the final answer
*
* The underlying agent loop is called unchanged.
*/
export declare function runGaiaAgentContrastive(question: GaiaQuestion, options: GaiaAgentOptions, stats: ContrastiveStats): Promise<ContrastiveAgentResult>;
/**
* Create a fresh ContrastiveStats counter object.
*/
export declare function createContrastiveStats(): ContrastiveStats;
//# sourceMappingURL=gaia-agent-contrastive.d.ts.map