@claude-flow/cli 3.10.4 → 3.10.6

package/dist/src/benchmarks/gaia-tools/grounded_query.d.ts

@@ -0,0 +1,126 @@
+/**
+ * GAIA Tool: grounded_query — ADR-135 / iter-33
+ *
+ * Calls Gemini 2.5 Flash with the google_search grounding tool and returns
+ * a synthesised factual answer plus source citations in a single API call.
+ *
+ * Architectural advantage over web_search (Google Custom Search):
+ *   - web_search: raw snippets → agent reads + parses → 2-3 extra turns
+ *   - grounded_query: Gemini synthesises an answer + cites sources in 1 call
+ *
+ * This is Ruflo's cross-provider stack in action:
+ *   Gemini grounds (google_search tool) → Sonnet/Haiku reasons → answer
+ *
+ * Credential resolution (mirrors performance-capability.ts / web_search.ts):
+ *   1. process.env.GOOGLE_AI_API_KEY
+ *   2. gcloud secrets versions access latest --secret=GOOGLE_AI_API_KEY --project=ruv-dev
+ *   3. Throws with clear instructions if neither is available
+ *
+ * Free tier: 1500 grounded queries/day on Gemini 2.5 Flash.
+ * Pricing: ~$0.075/M input tokens, ~$0.30/M output tokens, grounding free <1500/day.
+ *
+ * Regression note (iter-47): this file was absent from feat/adr-135-integrate-tracks
+ * because the grounded-query-gemini branch was not cherry-picked during Track integration.
+ * The omission caused a 36-question empty-answer failure in iter-42 (13.2% vs 49.1% baseline).
+ *
+ * Refs: ADR-133, ADR-135, iter-30 research, iter-33, iter-47, #2156
+ * Live-tested 2026-05-27: Mercedes Sosa GAIA L1 question → HTTP 200, 4 sources.
+ */
+import { GaiaTool, ToolDefinition } from './types.js';
+export interface GroundedQueryInput {
+    query: string;
+    max_tokens?: number;
+}
+export interface GroundedQuerySource {
+    title: string;
+    uri: string;
+    snippet?: string;
+}
+export interface GroundedQueryResult {
+    /** Synthesised factual answer from Gemini. */
+    answer: string;
+    /** Web pages Gemini cited when composing its answer. */
+    sources: GroundedQuerySource[];
+    /** Auto-formulated search queries issued by Gemini. */
+    search_queries_used: string[];
+    /** True when grounding metadata was returned (sources or search_queries present). */
+    grounded: boolean;
+    /** Always 'gemini-2.5-flash' for this tool. */
+    model: string;
+    /** Estimated cost in USD. */
+    cost_usd: number;
+}
+interface GeminiPart {
+    text?: string;
+}
+interface GeminiGroundingChunk {
+    web?: {
+        title?: string;
+        uri?: string;
+    };
+}
+interface GeminiGroundingSupport {
+    groundingChunkIndices?: number[];
+    segment?: {
+        text?: string;
+    };
+}
+interface GeminiGroundingMetadata {
+    groundingChunks?: GeminiGroundingChunk[];
+    webSearchQueries?: string[];
+    groundingSupports?: GeminiGroundingSupport[];
+}
+interface GeminiCandidate {
+    content?: {
+        parts?: GeminiPart[];
+    };
+    groundingMetadata?: GeminiGroundingMetadata;
+}
+interface GeminiUsageMetadata {
+    promptTokenCount?: number;
+    candidatesTokenCount?: number;
+}
+interface GeminiGenerateContentResponse {
+    candidates?: GeminiCandidate[];
+    usageMetadata?: GeminiUsageMetadata;
+}
+export interface GroundedQueryTestHooks {
+    /** Override the API key resolver. */
+    resolveKey?: () => Promise<string>;
+    /** Override the actual HTTP fetch so tests never make live calls. */
+    fetchResponse?: (query: string, maxTokens: number, apiKey: string) => Promise<GeminiGenerateContentResponse>;
+}
+export declare const groundedQueryTestHooks: GroundedQueryTestHooks;
+/**
+ * Resolve a Google AI API key.
+ *
+ * Order: env var → gcloud secret → throw.
+ * Never returns null — throws with actionable guidance if no key is found.
+ */
+export declare function resolveGoogleAIApiKey(): Promise<string>;
+/**
+ * Call Gemini 2.5 Flash with google_search grounding and parse the response.
+ *
+ * Exported so smoke tests can exercise the parser without live HTTP (via
+ * groundedQueryTestHooks.fetchResponse).
+ */
+export declare function callGeminiGrounded(query: string, maxTokens: number, apiKey: string): Promise<GroundedQueryResult>;
+/**
+ * Parse a raw Gemini generateContent response into GroundedQueryResult.
+ * Exported for unit testing the parser independently.
+ */
+export declare function parseGeminiResponse(body: GeminiGenerateContentResponse): GroundedQueryResult;
+export declare class GroundedQueryTool implements GaiaTool {
+    readonly name = "grounded_query";
+    readonly definition: ToolDefinition;
+    private readonly apiKey?;
+    constructor(opts?: {
+        apiKey?: string;
+    });
+    execute(input: Record<string, unknown>): Promise<string>;
+}
+export declare function createGroundedQueryTool(opts?: {
+    apiKey?: string;
+}): GroundedQueryTool;
+export {};
+//# sourceMappingURL=grounded_query.d.ts.map

package/dist/src/benchmarks/gaia-tools/grounded_query.d.ts.map

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

package/dist/src/benchmarks/gaia-tools/grounded_query.js

@@ -0,0 +1,225 @@
+/**
+ * GAIA Tool: grounded_query — ADR-135 / iter-33
+ *
+ * Calls Gemini 2.5 Flash with the google_search grounding tool and returns
+ * a synthesised factual answer plus source citations in a single API call.
+ *
+ * Architectural advantage over web_search (Google Custom Search):
+ *   - web_search: raw snippets → agent reads + parses → 2-3 extra turns
+ *   - grounded_query: Gemini synthesises an answer + cites sources in 1 call
+ *
+ * This is Ruflo's cross-provider stack in action:
+ *   Gemini grounds (google_search tool) → Sonnet/Haiku reasons → answer
+ *
+ * Credential resolution (mirrors performance-capability.ts / web_search.ts):
+ *   1. process.env.GOOGLE_AI_API_KEY
+ *   2. gcloud secrets versions access latest --secret=GOOGLE_AI_API_KEY --project=ruv-dev
+ *   3. Throws with clear instructions if neither is available
+ *
+ * Free tier: 1500 grounded queries/day on Gemini 2.5 Flash.
+ * Pricing: ~$0.075/M input tokens, ~$0.30/M output tokens, grounding free <1500/day.
+ *
+ * Regression note (iter-47): this file was absent from feat/adr-135-integrate-tracks
+ * because the grounded-query-gemini branch was not cherry-picked during Track integration.
+ * The omission caused a 36-question empty-answer failure in iter-42 (13.2% vs 49.1% baseline).
+ *
+ * Refs: ADR-133, ADR-135, iter-30 research, iter-33, iter-47, #2156
+ * Live-tested 2026-05-27: Mercedes Sosa GAIA L1 question → HTTP 200, 4 sources.
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const GEMINI_GENERATE_CONTENT_URL = 'https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent';
+const DEFAULT_MAX_TOKENS = 1024;
+const REQUEST_TIMEOUT_MS = 30_000;
+// Gemini 2.5 Flash pricing (USD per 1M tokens, grounding free under 1500/day)
+const PRICE_INPUT_PER_M = 0.075;
+const PRICE_OUTPUT_PER_M = 0.30;
+export const groundedQueryTestHooks = {};
+// ---------------------------------------------------------------------------
+// Credential resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a Google AI API key.
+ *
+ * Order: env var → gcloud secret → throw.
+ * Never returns null — throws with actionable guidance if no key is found.
+ */
+export async function resolveGoogleAIApiKey() {
+    // 1. Environment variable (fastest path, used in test mocks and CI)
+    const envKey = process.env['GOOGLE_AI_API_KEY'];
+    if (envKey)
+        return envKey;
+    // 2. GCP Secrets Manager (matches resolveApiKey pattern in gaia-bench.ts)
+    try {
+        const { execSync } = await import('node:child_process');
+        const key = execSync('gcloud secrets versions access latest --secret=GOOGLE_AI_API_KEY --project=ruv-dev 2>/dev/null', { encoding: 'utf-8', timeout: 5_000 }).trim();
+        if (key)
+            return key;
+    }
+    catch {
+        // gcloud not installed, project unreachable, or secret not yet created
+    }
+    throw new Error('grounded_query: No Google AI API key found.\n' +
+        'Set GOOGLE_AI_API_KEY env var, or ensure `gcloud` is authenticated and\n' +
+        'the secret GOOGLE_AI_API_KEY exists in GCP project ruv-dev.\n' +
+        'Get a free key at: https://aistudio.google.com/apikey');
+}
+// ---------------------------------------------------------------------------
+// Gemini Grounding API call
+// ---------------------------------------------------------------------------
+/**
+ * Call Gemini 2.5 Flash with google_search grounding and parse the response.
+ *
+ * Exported so smoke tests can exercise the parser without live HTTP (via
+ * groundedQueryTestHooks.fetchResponse).
+ */
+export async function callGeminiGrounded(query, maxTokens, apiKey) {
+    const url = `${GEMINI_GENERATE_CONTENT_URL}?key=${encodeURIComponent(apiKey)}`;
+    const requestBody = {
+        contents: [{ parts: [{ text: query }] }],
+        tools: [{ google_search: {} }],
+        generationConfig: { maxOutputTokens: maxTokens },
+    };
+    let rawBody;
+    if (groundedQueryTestHooks.fetchResponse) {
+        rawBody = await groundedQueryTestHooks.fetchResponse(query, maxTokens, apiKey);
+    }
+    else {
+        const resp = await fetch(url, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            body: JSON.stringify(requestBody),
+        });
+        if (!resp.ok) {
+            const errText = (await resp.text()).slice(0, 400);
+            throw new Error(`grounded_query: Gemini HTTP ${resp.status}: ${errText}`);
+        }
+        rawBody = (await resp.json());
+    }
+    return parseGeminiResponse(rawBody);
+}
+/**
+ * Parse a raw Gemini generateContent response into GroundedQueryResult.
+ * Exported for unit testing the parser independently.
+ */
+export function parseGeminiResponse(body) {
+    const candidate = body.candidates?.[0];
+    // Extract text answer
+    const answer = (candidate?.content?.parts ?? [])
+        .map((p) => p.text ?? '')
+        .join('');
+    // Extract grounding metadata
+    const meta = candidate?.groundingMetadata;
+    const chunks = meta?.groundingChunks ?? [];
+    const searchQueries = meta?.webSearchQueries ?? [];
+    // Build source list from grounding chunks (deduplicate by URI)
+    const seenUris = new Set();
+    const sources = [];
+    for (const chunk of chunks) {
+        const uri = chunk.web?.uri ?? '';
+        const title = chunk.web?.title ?? '';
+        if (uri && !seenUris.has(uri)) {
+            seenUris.add(uri);
+            sources.push({ title, uri });
+        }
+    }
+    // Estimate cost
+    const inputTokens = body.usageMetadata?.promptTokenCount ?? 0;
+    const outputTokens = body.usageMetadata?.candidatesTokenCount ?? 0;
+    const costUsd = (inputTokens / 1_000_000) * PRICE_INPUT_PER_M +
+        (outputTokens / 1_000_000) * PRICE_OUTPUT_PER_M;
+    return {
+        answer,
+        sources,
+        search_queries_used: searchQueries,
+        grounded: sources.length > 0 || searchQueries.length > 0,
+        model: 'gemini-2.5-flash',
+        cost_usd: costUsd,
+    };
+}
+// ---------------------------------------------------------------------------
+// Format output for Claude (mirrors web_search formatResults pattern)
+// ---------------------------------------------------------------------------
+function formatResult(result) {
+    const lines = [];
+    lines.push(`[grounded_query model: ${result.model}]`);
+    if (result.answer) {
+        lines.push('');
+        lines.push(result.answer.trim());
+    }
+    if (result.sources.length > 0) {
+        lines.push('');
+        lines.push('Sources:');
+        for (let i = 0; i < result.sources.length; i++) {
+            const s = result.sources[i];
+            lines.push(`[${i + 1}] ${s.title}`);
+            lines.push(`    ${s.uri}`);
+        }
+    }
+    if (result.search_queries_used.length > 0) {
+        lines.push('');
+        lines.push(`Search queries: ${result.search_queries_used.join('; ')}`);
+    }
+    if (!result.grounded) {
+        lines.push('');
+        lines.push('[Note: No grounding metadata returned — answer is unverified.]');
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// GaiaTool implementation
+// ---------------------------------------------------------------------------
+export class GroundedQueryTool {
+    name = 'grounded_query';
+    definition = {
+        name: 'grounded_query',
+        description: 'Query Google Search via Gemini 2.5 Flash grounding. ' +
+            'Returns a synthesised factual answer with source citations in a single call — ' +
+            'more efficient than web_search for factoid questions because Gemini pre-synthesises ' +
+            'the answer rather than returning raw snippets. ' +
+            'Use this for: factual lookups, "what year did X happen", "how many Y", ' +
+            '"who is Z", or any question requiring current web information with a clean answer. ' +
+            'Use web_search instead when you need to read a source page in full.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Question or factual lookup to ground via Google Search.',
+                },
+                max_tokens: {
+                    type: 'number',
+                    description: `Maximum response length in tokens (default: ${DEFAULT_MAX_TOKENS}).`,
+                },
+            },
+            required: ['query'],
+        },
+    };
+    apiKey;
+    constructor(opts) {
+        this.apiKey = opts?.apiKey;
+    }
+    async execute(input) {
+        const query = String(input['query'] ?? '').trim();
+        if (!query) {
+            throw new Error('grounded_query: `query` input is required and must be non-empty.');
+        }
+        const maxTokens = Math.min(Math.max(64, Number(input['max_tokens'] ?? DEFAULT_MAX_TOKENS)), 8192);
+        const resolveKeyFn = groundedQueryTestHooks.resolveKey ?? resolveGoogleAIApiKey;
+        const apiKey = this.apiKey ?? (await resolveKeyFn());
+        process.stderr.write(`[grounded_query] model=gemini-2.5-flash query=${JSON.stringify(query)}\n`);
+        const result = await callGeminiGrounded(query, maxTokens, apiKey);
+        process.stderr.write(`[grounded_query] grounded=${result.grounded} sources=${result.sources.length} ` +
+            `cost_usd=${result.cost_usd.toFixed(6)}\n`);
+        return formatResult(result);
+    }
+}
+// ---------------------------------------------------------------------------
+// Convenience factory
+// ---------------------------------------------------------------------------
+export function createGroundedQueryTool(opts) {
+    return new GroundedQueryTool(opts);
+}
+//# sourceMappingURL=grounded_query.js.map

package/dist/src/benchmarks/gaia-tools/grounded_query.js.map

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

package/dist/src/benchmarks/gaia-tools/grounded_query.smoke.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Smoke tests for grounded_query.ts — ADR-135 / iter-33
+ *
+ * All tests are mock-based using groundedQueryTestHooks for ESM-safe injection.
+ * NO live API calls are made.
+ *
+ * Coverage:
+ *   1.  resolveGoogleAIApiKey — returns key from env var
+ *   2.  resolveGoogleAIApiKey — throws when env var absent and gcloud unavailable
+ *   3.  parseGeminiResponse — well-formed response → correct GroundedQueryResult shape
+ *   4.  parseGeminiResponse — empty grounding metadata → grounded=false, empty sources
+ *   5.  parseGeminiResponse — deduplicates sources by URI
+ *   6.  parseGeminiResponse — cost calculation uses token counts
+ *   7.  GroundedQueryTool.execute — happy path: answer + sources in output
+ *   8.  GroundedQueryTool.execute — HTTP 4xx surfaces useful error message
+ *   9.  GroundedQueryTool.execute — ungrounded response includes note in output
+ *  10.  GroundedQueryTool.execute — rejects empty query
+ *  11.  GroundedQueryTool.execute — max_tokens clamped to 8192
+ *  12.  GroundedQueryTool.execute — uses injected apiKey from constructor
+ *
+ * Run with: npx tsx grounded_query.smoke.ts  (from gaia-tools directory)
+ */
+export {};
+//# sourceMappingURL=grounded_query.smoke.d.ts.map

package/dist/src/benchmarks/gaia-tools/grounded_query.smoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grounded_query.smoke.d.ts","sourceRoot":"","sources":["../../../../src/benchmarks/gaia-tools/grounded_query.smoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}