@anthropic-field/core 0.1.0

package/dist/src/hooks/hookAggregator.js

@@ -0,0 +1,279 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { FunctionCallingConfigMode } from '@google/genai';
+import { DefaultHookOutput, BeforeToolHookOutput, BeforeModelHookOutput, BeforeToolSelectionHookOutput, AfterModelHookOutput, AfterAgentHookOutput, } from './types.js';
+import { HookEventName } from './types.js';
+/**
+ * Hook aggregator that merges results from multiple hooks using event-specific strategies
+ */
+export class HookAggregator {
+    /**
+     * Aggregate results from multiple hook executions
+     */
+    aggregateResults(results, eventName) {
+        const allOutputs = [];
+        const errors = [];
+        let totalDuration = 0;
+        // Collect all outputs and errors
+        for (const result of results) {
+            totalDuration += result.duration;
+            if (result.error) {
+                errors.push(result.error);
+            }
+            if (result.output) {
+                allOutputs.push(result.output);
+            }
+        }
+        // Merge outputs using event-specific strategy
+        const mergedOutput = this.mergeOutputs(allOutputs, eventName);
+        const finalOutput = mergedOutput
+            ? this.createSpecificHookOutput(mergedOutput, eventName)
+            : undefined;
+        return {
+            success: errors.length === 0,
+            finalOutput,
+            allOutputs,
+            errors,
+            totalDuration,
+        };
+    }
+    /**
+     * Merge hook outputs using event-specific strategies
+     *
+     * Note: We always use the merge logic even for single hooks to ensure
+     * consistent default behaviors (e.g., default decision='allow' for OR logic)
+     */
+    mergeOutputs(outputs, eventName) {
+        if (outputs.length === 0) {
+            return undefined;
+        }
+        switch (eventName) {
+            case HookEventName.BeforeTool:
+            case HookEventName.AfterTool:
+            case HookEventName.BeforeAgent:
+            case HookEventName.AfterAgent:
+            case HookEventName.SessionStart:
+                return this.mergeWithOrDecision(outputs);
+            case HookEventName.BeforeModel:
+            case HookEventName.AfterModel:
+                return this.mergeWithFieldReplacement(outputs);
+            case HookEventName.BeforeToolSelection:
+                return this.mergeToolSelectionOutputs(outputs);
+            default:
+                // For other events, use simple merge
+                return this.mergeSimple(outputs);
+        }
+    }
+    /**
+     * Merge outputs with OR decision logic and message concatenation
+     */
+    mergeWithOrDecision(outputs) {
+        const merged = {
+            continue: true,
+            suppressOutput: false,
+        };
+        const messages = [];
+        const reasons = [];
+        const systemMessages = [];
+        const additionalContexts = [];
+        let hasBlockDecision = false;
+        let hasContinueFalse = false;
+        for (const output of outputs) {
+            // Handle continue flag
+            if (output.continue === false) {
+                hasContinueFalse = true;
+                merged.continue = false;
+                if (output.stopReason) {
+                    messages.push(output.stopReason);
+                }
+            }
+            // Handle decision (OR logic for blocking)
+            const tempOutput = new DefaultHookOutput(output);
+            if (tempOutput.isBlockingDecision()) {
+                hasBlockDecision = true;
+                merged.decision = output.decision;
+            }
+            // Collect messages
+            if (output.reason) {
+                reasons.push(output.reason);
+            }
+            if (output.systemMessage) {
+                systemMessages.push(output.systemMessage);
+            }
+            // Handle suppress output (any true wins)
+            if (output.suppressOutput) {
+                merged.suppressOutput = true;
+            }
+            // Handle clearContext (any true wins) - for AfterAgent hooks
+            if (output.hookSpecificOutput?.['clearContext'] === true) {
+                merged.hookSpecificOutput = {
+                    ...(merged.hookSpecificOutput || {}),
+                    clearContext: true,
+                };
+            }
+            // Merge hookSpecificOutput (excluding clearContext which is handled above)
+            if (output.hookSpecificOutput) {
+                const { clearContext: _clearContext, ...restSpecificOutput } = output.hookSpecificOutput;
+                merged.hookSpecificOutput = {
+                    ...(merged.hookSpecificOutput || {}),
+                    ...restSpecificOutput,
+                };
+            }
+            // Collect additional context from hook-specific outputs
+            this.extractAdditionalContext(output, additionalContexts);
+        }
+        // Set final decision if no blocking decision was found
+        if (!hasBlockDecision && !hasContinueFalse) {
+            merged.decision = 'allow';
+        }
+        // Merge messages
+        if (messages.length > 0) {
+            merged.stopReason = messages.join('\n');
+        }
+        if (reasons.length > 0) {
+            merged.reason = reasons.join('\n');
+        }
+        if (systemMessages.length > 0) {
+            merged.systemMessage = systemMessages.join('\n');
+        }
+        // Add merged additional context
+        if (additionalContexts.length > 0) {
+            merged.hookSpecificOutput = {
+                ...(merged.hookSpecificOutput || {}),
+                additionalContext: additionalContexts.join('\n'),
+            };
+        }
+        return merged;
+    }
+    /**
+     * Merge outputs with later fields replacing earlier fields
+     */
+    mergeWithFieldReplacement(outputs) {
+        let merged = {};
+        for (const output of outputs) {
+            // Later outputs override earlier ones
+            merged = {
+                ...merged,
+                ...output,
+                hookSpecificOutput: {
+                    ...merged.hookSpecificOutput,
+                    ...output.hookSpecificOutput,
+                },
+            };
+        }
+        return merged;
+    }
+    /**
+     * Merge tool selection outputs with specific logic for tool config
+     *
+     * Tool Selection Strategy:
+     * - The intent is to provide a UNION of tools from all hooks
+     * - If any hook specifies NONE mode, no tools are available (most restrictive wins)
+     * - If any hook specifies ANY mode (and no NONE), ANY mode is used
+     * - Otherwise AUTO mode is used
+     * - Function names are collected from all hooks and sorted for deterministic caching
+     *
+     * This means hooks can only add/enable tools, not filter them out individually.
+     * If one hook restricts and another re-enables, the union takes the re-enabled tool.
+     */
+    mergeToolSelectionOutputs(outputs) {
+        const merged = {};
+        const allFunctionNames = new Set();
+        let hasNoneMode = false;
+        let hasAnyMode = false;
+        for (const output of outputs) {
+            const toolConfig = output.hookSpecificOutput?.toolConfig;
+            if (!toolConfig) {
+                continue;
+            }
+            // Check mode (using simplified HookToolConfig format)
+            if (toolConfig.mode === 'NONE') {
+                hasNoneMode = true;
+            }
+            else if (toolConfig.mode === 'ANY') {
+                hasAnyMode = true;
+            }
+            // Collect function names (union of all hooks)
+            if (toolConfig.allowedFunctionNames) {
+                for (const name of toolConfig.allowedFunctionNames) {
+                    allFunctionNames.add(name);
+                }
+            }
+        }
+        // Determine final mode and function names
+        let finalMode;
+        let finalFunctionNames = [];
+        if (hasNoneMode) {
+            // NONE mode wins - most restrictive
+            finalMode = FunctionCallingConfigMode.NONE;
+            finalFunctionNames = [];
+        }
+        else if (hasAnyMode) {
+            // ANY mode if present (and no NONE)
+            finalMode = FunctionCallingConfigMode.ANY;
+            // Sort for deterministic output to ensure consistent caching
+            finalFunctionNames = Array.from(allFunctionNames).sort();
+        }
+        else {
+            // Default to AUTO mode
+            finalMode = FunctionCallingConfigMode.AUTO;
+            // Sort for deterministic output to ensure consistent caching
+            finalFunctionNames = Array.from(allFunctionNames).sort();
+        }
+        merged.hookSpecificOutput = {
+            hookEventName: 'BeforeToolSelection',
+            toolConfig: {
+                mode: finalMode,
+                allowedFunctionNames: finalFunctionNames,
+            },
+        };
+        return merged;
+    }
+    /**
+     * Simple merge for events without special logic
+     */
+    mergeSimple(outputs) {
+        let merged = {};
+        for (const output of outputs) {
+            merged = { ...merged, ...output };
+        }
+        return merged;
+    }
+    /**
+     * Create the appropriate specific hook output class based on event type
+     */
+    createSpecificHookOutput(output, eventName) {
+        switch (eventName) {
+            case HookEventName.BeforeTool:
+                return new BeforeToolHookOutput(output);
+            case HookEventName.BeforeModel:
+                return new BeforeModelHookOutput(output);
+            case HookEventName.BeforeToolSelection:
+                return new BeforeToolSelectionHookOutput(output);
+            case HookEventName.AfterModel:
+                return new AfterModelHookOutput(output);
+            case HookEventName.AfterAgent:
+                return new AfterAgentHookOutput(output);
+            default:
+                return new DefaultHookOutput(output);
+        }
+    }
+    /**
+     * Extract additional context from hook-specific outputs
+     */
+    extractAdditionalContext(output, contexts) {
+        const specific = output.hookSpecificOutput;
+        if (!specific) {
+            return;
+        }
+        // Extract additionalContext from various hook types
+        if ('additionalContext' in specific &&
+            typeof specific['additionalContext'] === 'string') {
+            contexts.push(specific['additionalContext']);
+        }
+    }
+}
+//# sourceMappingURL=hookAggregator.js.map

package/dist/src/hooks/hookAggregator.js.map

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

package/dist/src/hooks/hookEventHandler.d.ts

@@ -0,0 +1,107 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { HookPlanner } from './hookPlanner.js';
+import type { HookRunner } from './hookRunner.js';
+import type { HookAggregator, AggregatedHookResult } from './hookAggregator.js';
+import type { NotificationType, SessionStartSource, SessionEndReason, PreCompressTrigger, McpToolContext } from './types.js';
+import type { GenerateContentParameters, GenerateContentResponse } from '@google/genai';
+/**
+ * Hook event bus that coordinates hook execution across the system
+ */
+export declare class HookEventHandler {
+    private readonly config;
+    private readonly hookPlanner;
+    private readonly hookRunner;
+    private readonly hookAggregator;
+    /**
+     * Track reported failures to suppress duplicate warnings during streaming.
+     * Uses a WeakMap with the original request object as a key to ensure
+     * failures are only reported once per logical model interaction.
+     */
+    private readonly reportedFailures;
+    constructor(config: Config, hookPlanner: HookPlanner, hookRunner: HookRunner, hookAggregator: HookAggregator);
+    /**
+     * Fire a BeforeTool event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    fireBeforeToolEvent(toolName: string, toolInput: Record<string, unknown>, mcpContext?: McpToolContext): Promise<AggregatedHookResult>;
+    /**
+     * Fire an AfterTool event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    fireAfterToolEvent(toolName: string, toolInput: Record<string, unknown>, toolResponse: Record<string, unknown>, mcpContext?: McpToolContext): Promise<AggregatedHookResult>;
+    /**
+     * Fire a BeforeAgent event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    fireBeforeAgentEvent(prompt: string): Promise<AggregatedHookResult>;
+    /**
+     * Fire a Notification event
+     */
+    fireNotificationEvent(type: NotificationType, message: string, details: Record<string, unknown>): Promise<AggregatedHookResult>;
+    /**
+     * Fire an AfterAgent event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    fireAfterAgentEvent(prompt: string, promptResponse: string, stopHookActive?: boolean): Promise<AggregatedHookResult>;
+    /**
+     * Fire a SessionStart event
+     */
+    fireSessionStartEvent(source: SessionStartSource): Promise<AggregatedHookResult>;
+    /**
+     * Fire a SessionEnd event
+     */
+    fireSessionEndEvent(reason: SessionEndReason): Promise<AggregatedHookResult>;
+    /**
+     * Fire a PreCompress event
+     */
+    firePreCompressEvent(trigger: PreCompressTrigger): Promise<AggregatedHookResult>;
+    /**
+     * Fire a BeforeModel event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    fireBeforeModelEvent(llmRequest: GenerateContentParameters): Promise<AggregatedHookResult>;
+    /**
+     * Fire an AfterModel event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    fireAfterModelEvent(llmRequest: GenerateContentParameters, llmResponse: GenerateContentResponse): Promise<AggregatedHookResult>;
+    /**
+     * Fire a BeforeToolSelection event
+     * Called by handleHookExecutionRequest - executes hooks directly
+     */
+    fireBeforeToolSelectionEvent(llmRequest: GenerateContentParameters): Promise<AggregatedHookResult>;
+    /**
+     * Execute hooks for a specific event (direct execution without MessageBus)
+     * Used as fallback when MessageBus is not available
+     */
+    private executeHooks;
+    /**
+     * Create base hook input with common fields
+     */
+    private createBaseInput;
+    /**
+     * Log hook execution for observability
+     */
+    private logHookExecution;
+    /**
+     * Process common hook output fields centrally
+     */
+    private processCommonHookOutputFields;
+    /**
+     * Get hook name from config for display or telemetry
+     */
+    private getHookName;
+    /**
+     * Get hook name from execution result for telemetry
+     */
+    private getHookNameFromResult;
+    /**
+     * Get hook type from execution result for telemetry
+     */
+    private getHookTypeFromResult;
+}