@anthropic-field/core 0.1.0

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

@@ -0,0 +1,99 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import { HookRegistry } from './hookRegistry.js';
+import { HookEventHandler } from './hookEventHandler.js';
+import type { HookRegistryEntry } from './hookRegistry.js';
+import type { SessionStartSource, SessionEndReason, PreCompressTrigger, DefaultHookOutput, McpToolContext } from './types.js';
+import type { AggregatedHookResult } from './hookAggregator.js';
+import type { GenerateContentParameters, GenerateContentResponse, GenerateContentConfig, ContentListUnion, ToolConfig, ToolListUnion } from '@google/genai';
+import type { ToolCallConfirmationDetails } from '../tools/tools.js';
+/**
+ * Main hook system that coordinates all hook-related functionality
+ */
+export interface BeforeModelHookResult {
+    /** Whether the model call was blocked */
+    blocked: boolean;
+    /** Whether the execution should be stopped entirely */
+    stopped?: boolean;
+    /** Reason for blocking (if blocked) */
+    reason?: string;
+    /** Synthetic response to return instead of calling the model (if blocked) */
+    syntheticResponse?: GenerateContentResponse;
+    /** Modified config (if not blocked) */
+    modifiedConfig?: GenerateContentConfig;
+    /** Modified contents (if not blocked) */
+    modifiedContents?: ContentListUnion;
+}
+/**
+ * Result from firing the BeforeToolSelection hook.
+ */
+export interface BeforeToolSelectionHookResult {
+    /** Modified tool config */
+    toolConfig?: ToolConfig;
+    /** Modified tools */
+    tools?: ToolListUnion;
+}
+/**
+ * Result from firing the AfterModel hook.
+ * Contains either a modified response or indicates to use the original chunk.
+ */
+export interface AfterModelHookResult {
+    /** The response to yield (either modified or original) */
+    response: GenerateContentResponse;
+    /** Whether the execution should be stopped entirely */
+    stopped?: boolean;
+    /** Whether the model call was blocked */
+    blocked?: boolean;
+    /** Reason for blocking or stopping */
+    reason?: string;
+}
+export declare class HookSystem {
+    private readonly hookRegistry;
+    private readonly hookRunner;
+    private readonly hookAggregator;
+    private readonly hookPlanner;
+    private readonly hookEventHandler;
+    constructor(config: Config);
+    /**
+     * Initialize the hook system
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the hook event bus for firing events
+     */
+    getEventHandler(): HookEventHandler;
+    /**
+     * Get hook registry for management operations
+     */
+    getRegistry(): HookRegistry;
+    /**
+     * Enable or disable a hook
+     */
+    setHookEnabled(hookName: string, enabled: boolean): void;
+    /**
+     * Get all registered hooks for display/management
+     */
+    getAllHooks(): HookRegistryEntry[];
+    /**
+     * Fire hook events directly
+     */
+    fireSessionStartEvent(source: SessionStartSource): Promise<DefaultHookOutput | undefined>;
+    fireSessionEndEvent(reason: SessionEndReason): Promise<AggregatedHookResult | undefined>;
+    firePreCompressEvent(trigger: PreCompressTrigger): Promise<AggregatedHookResult | undefined>;
+    fireBeforeAgentEvent(prompt: string): Promise<DefaultHookOutput | undefined>;
+    fireAfterAgentEvent(prompt: string, response: string, stopHookActive?: boolean): Promise<DefaultHookOutput | undefined>;
+    fireBeforeModelEvent(llmRequest: GenerateContentParameters): Promise<BeforeModelHookResult>;
+    fireAfterModelEvent(originalRequest: GenerateContentParameters, chunk: GenerateContentResponse): Promise<AfterModelHookResult>;
+    fireBeforeToolSelectionEvent(llmRequest: GenerateContentParameters): Promise<BeforeToolSelectionHookResult>;
+    fireBeforeToolEvent(toolName: string, toolInput: Record<string, unknown>, mcpContext?: McpToolContext): Promise<DefaultHookOutput | undefined>;
+    fireAfterToolEvent(toolName: string, toolInput: Record<string, unknown>, toolResponse: {
+        llmContent: unknown;
+        returnDisplay: unknown;
+        error: unknown;
+    }, mcpContext?: McpToolContext): Promise<DefaultHookOutput | undefined>;
+    fireToolNotificationEvent(confirmationDetails: ToolCallConfirmationDetails): Promise<void>;
+}

package/dist/src/hooks/hookSystem.js

@@ -0,0 +1,262 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { HookRegistry } from './hookRegistry.js';
+import { HookRunner } from './hookRunner.js';
+import { HookAggregator } from './hookAggregator.js';
+import { HookPlanner } from './hookPlanner.js';
+import { HookEventHandler } from './hookEventHandler.js';
+import { debugLogger } from '../utils/debugLogger.js';
+import { NotificationType } from './types.js';
+/**
+ * Converts ToolCallConfirmationDetails to a serializable format for hooks.
+ * Excludes function properties (onConfirm, ideConfirmation) that can't be serialized.
+ */
+function toSerializableDetails(details) {
+    const base = {
+        type: details.type,
+        title: details.title,
+    };
+    switch (details.type) {
+        case 'edit':
+            return {
+                ...base,
+                fileName: details.fileName,
+                filePath: details.filePath,
+                fileDiff: details.fileDiff,
+                originalContent: details.originalContent,
+                newContent: details.newContent,
+                isModifying: details.isModifying,
+            };
+        case 'exec':
+            return {
+                ...base,
+                command: details.command,
+                rootCommand: details.rootCommand,
+            };
+        case 'mcp':
+            return {
+                ...base,
+                serverName: details.serverName,
+                toolName: details.toolName,
+                toolDisplayName: details.toolDisplayName,
+            };
+        case 'info':
+            return {
+                ...base,
+                prompt: details.prompt,
+                urls: details.urls,
+            };
+        default:
+            return base;
+    }
+}
+/**
+ * Gets the message to display in the notification hook for tool confirmation.
+ */
+function getNotificationMessage(confirmationDetails) {
+    switch (confirmationDetails.type) {
+        case 'edit':
+            return `Tool ${confirmationDetails.title} requires editing`;
+        case 'exec':
+            return `Tool ${confirmationDetails.title} requires execution`;
+        case 'mcp':
+            return `Tool ${confirmationDetails.title} requires MCP`;
+        case 'info':
+            return `Tool ${confirmationDetails.title} requires information`;
+        default:
+            return `Tool requires confirmation`;
+    }
+}
+export class HookSystem {
+    hookRegistry;
+    hookRunner;
+    hookAggregator;
+    hookPlanner;
+    hookEventHandler;
+    constructor(config) {
+        // Initialize components
+        this.hookRegistry = new HookRegistry(config);
+        this.hookRunner = new HookRunner(config);
+        this.hookAggregator = new HookAggregator();
+        this.hookPlanner = new HookPlanner(this.hookRegistry);
+        this.hookEventHandler = new HookEventHandler(config, this.hookPlanner, this.hookRunner, this.hookAggregator);
+    }
+    /**
+     * Initialize the hook system
+     */
+    async initialize() {
+        await this.hookRegistry.initialize();
+        debugLogger.debug('Hook system initialized successfully');
+    }
+    /**
+     * Get the hook event bus for firing events
+     */
+    getEventHandler() {
+        return this.hookEventHandler;
+    }
+    /**
+     * Get hook registry for management operations
+     */
+    getRegistry() {
+        return this.hookRegistry;
+    }
+    /**
+     * Enable or disable a hook
+     */
+    setHookEnabled(hookName, enabled) {
+        this.hookRegistry.setHookEnabled(hookName, enabled);
+    }
+    /**
+     * Get all registered hooks for display/management
+     */
+    getAllHooks() {
+        return this.hookRegistry.getAllHooks();
+    }
+    /**
+     * Fire hook events directly
+     */
+    async fireSessionStartEvent(source) {
+        const result = await this.hookEventHandler.fireSessionStartEvent(source);
+        return result.finalOutput;
+    }
+    async fireSessionEndEvent(reason) {
+        return this.hookEventHandler.fireSessionEndEvent(reason);
+    }
+    async firePreCompressEvent(trigger) {
+        return this.hookEventHandler.firePreCompressEvent(trigger);
+    }
+    async fireBeforeAgentEvent(prompt) {
+        const result = await this.hookEventHandler.fireBeforeAgentEvent(prompt);
+        return result.finalOutput;
+    }
+    async fireAfterAgentEvent(prompt, response, stopHookActive = false) {
+        const result = await this.hookEventHandler.fireAfterAgentEvent(prompt, response, stopHookActive);
+        return result.finalOutput;
+    }
+    async fireBeforeModelEvent(llmRequest) {
+        try {
+            const result = await this.hookEventHandler.fireBeforeModelEvent(llmRequest);
+            const hookOutput = result.finalOutput;
+            if (hookOutput?.shouldStopExecution()) {
+                return {
+                    blocked: true,
+                    stopped: true,
+                    reason: hookOutput.getEffectiveReason(),
+                };
+            }
+            const blockingError = hookOutput?.getBlockingError();
+            if (blockingError?.blocked) {
+                const beforeModelOutput = hookOutput;
+                const syntheticResponse = beforeModelOutput.getSyntheticResponse();
+                return {
+                    blocked: true,
+                    reason: hookOutput?.getEffectiveReason() || 'Model call blocked by hook',
+                    syntheticResponse,
+                };
+            }
+            if (hookOutput) {
+                const beforeModelOutput = hookOutput;
+                const modifiedRequest = beforeModelOutput.applyLLMRequestModifications(llmRequest);
+                return {
+                    blocked: false,
+                    modifiedConfig: modifiedRequest?.config,
+                    modifiedContents: modifiedRequest?.contents,
+                };
+            }
+            return { blocked: false };
+        }
+        catch (error) {
+            debugLogger.debug(`BeforeModelHookEvent failed:`, error);
+            return { blocked: false };
+        }
+    }
+    async fireAfterModelEvent(originalRequest, chunk) {
+        try {
+            const result = await this.hookEventHandler.fireAfterModelEvent(originalRequest, chunk);
+            const hookOutput = result.finalOutput;
+            if (hookOutput?.shouldStopExecution()) {
+                return {
+                    response: chunk,
+                    stopped: true,
+                    reason: hookOutput.getEffectiveReason(),
+                };
+            }
+            const blockingError = hookOutput?.getBlockingError();
+            if (blockingError?.blocked) {
+                return {
+                    response: chunk,
+                    blocked: true,
+                    reason: hookOutput?.getEffectiveReason(),
+                };
+            }
+            if (hookOutput) {
+                const afterModelOutput = hookOutput;
+                const modifiedResponse = afterModelOutput.getModifiedResponse();
+                if (modifiedResponse) {
+                    return { response: modifiedResponse };
+                }
+            }
+            return { response: chunk };
+        }
+        catch (error) {
+            debugLogger.debug(`AfterModelHookEvent failed:`, error);
+            return { response: chunk };
+        }
+    }
+    async fireBeforeToolSelectionEvent(llmRequest) {
+        try {
+            const result = await this.hookEventHandler.fireBeforeToolSelectionEvent(llmRequest);
+            const hookOutput = result.finalOutput;
+            if (hookOutput) {
+                const toolSelectionOutput = hookOutput;
+                const modifiedConfig = toolSelectionOutput.applyToolConfigModifications({
+                    toolConfig: llmRequest.config?.toolConfig,
+                    tools: llmRequest.config?.tools,
+                });
+                return {
+                    toolConfig: modifiedConfig.toolConfig,
+                    tools: modifiedConfig.tools,
+                };
+            }
+            return {};
+        }
+        catch (error) {
+            debugLogger.debug(`BeforeToolSelectionEvent failed:`, error);
+            return {};
+        }
+    }
+    async fireBeforeToolEvent(toolName, toolInput, mcpContext) {
+        try {
+            const result = await this.hookEventHandler.fireBeforeToolEvent(toolName, toolInput, mcpContext);
+            return result.finalOutput;
+        }
+        catch (error) {
+            debugLogger.debug(`BeforeToolEvent failed for ${toolName}:`, error);
+            return undefined;
+        }
+    }
+    async fireAfterToolEvent(toolName, toolInput, toolResponse, mcpContext) {
+        try {
+            const result = await this.hookEventHandler.fireAfterToolEvent(toolName, toolInput, toolResponse, mcpContext);
+            return result.finalOutput;
+        }
+        catch (error) {
+            debugLogger.debug(`AfterToolEvent failed for ${toolName}:`, error);
+            return undefined;
+        }
+    }
+    async fireToolNotificationEvent(confirmationDetails) {
+        try {
+            const message = getNotificationMessage(confirmationDetails);
+            const serializedDetails = toSerializableDetails(confirmationDetails);
+            await this.hookEventHandler.fireNotificationEvent(NotificationType.ToolPermission, message, serializedDetails);
+        }
+        catch (error) {
+            debugLogger.debug(`NotificationEvent failed for ${confirmationDetails.title}:`, error);
+        }
+    }
+}
+//# sourceMappingURL=hookSystem.js.map

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

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

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

@@ -0,0 +1,113 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { GenerateContentResponse, GenerateContentParameters, ToolConfig } from '@google/genai';
+/**
+ * Decoupled LLM request format - stable across Gemini CLI versions
+ */
+export interface LLMRequest {
+    model: string;
+    messages: Array<{
+        role: 'user' | 'model' | 'system';
+        content: string | Array<{
+            type: string;
+            [key: string]: unknown;
+        }>;
+    }>;
+    config?: {
+        temperature?: number;
+        maxOutputTokens?: number;
+        topP?: number;
+        topK?: number;
+        stopSequences?: string[];
+        candidateCount?: number;
+        presencePenalty?: number;
+        frequencyPenalty?: number;
+        [key: string]: unknown;
+    };
+    toolConfig?: HookToolConfig;
+}
+/**
+ * Decoupled LLM response format - stable across Gemini CLI versions
+ */
+export interface LLMResponse {
+    text?: string;
+    candidates: Array<{
+        content: {
+            role: 'model';
+            parts: string[];
+        };
+        finishReason?: 'STOP' | 'MAX_TOKENS' | 'SAFETY' | 'RECITATION' | 'OTHER';
+        index?: number;
+        safetyRatings?: Array<{
+            category: string;
+            probability: string;
+            blocked?: boolean;
+        }>;
+    }>;
+    usageMetadata?: {
+        promptTokenCount?: number;
+        candidatesTokenCount?: number;
+        totalTokenCount?: number;
+    };
+}
+/**
+ * Decoupled tool configuration - stable across Gemini CLI versions
+ */
+export interface HookToolConfig {
+    mode?: 'AUTO' | 'ANY' | 'NONE';
+    allowedFunctionNames?: string[];
+}
+/**
+ * Base class for hook translators - handles version-specific translation logic
+ */
+export declare abstract class HookTranslator {
+    abstract toHookLLMRequest(sdkRequest: GenerateContentParameters): LLMRequest;
+    abstract fromHookLLMRequest(hookRequest: LLMRequest, baseRequest?: GenerateContentParameters): GenerateContentParameters;
+    abstract toHookLLMResponse(sdkResponse: GenerateContentResponse): LLMResponse;
+    abstract fromHookLLMResponse(hookResponse: LLMResponse): GenerateContentResponse;
+    abstract toHookToolConfig(sdkToolConfig: ToolConfig): HookToolConfig;
+    abstract fromHookToolConfig(hookToolConfig: HookToolConfig): ToolConfig;
+}
+/**
+ * Hook translator for GenAI SDK v1.x
+ * Handles translation between GenAI SDK types and stable Hook API types
+ */
+export declare class HookTranslatorGenAIv1 extends HookTranslator {
+    /**
+     * Convert genai SDK GenerateContentParameters to stable LLMRequest
+     *
+     * Note: This implementation intentionally extracts only text content from parts.
+     * Non-text parts (images, function calls, etc.) are filtered out in v1 to provide
+     * a simplified, stable interface for hooks. This allows hooks to focus on text
+     * manipulation without needing to handle complex multimodal content.
+     * Future versions may expose additional content types if needed.
+     */
+    toHookLLMRequest(sdkRequest: GenerateContentParameters): LLMRequest;
+    /**
+     * Convert stable LLMRequest to genai SDK GenerateContentParameters
+     */
+    fromHookLLMRequest(hookRequest: LLMRequest, baseRequest?: GenerateContentParameters): GenerateContentParameters;
+    /**
+     * Convert genai SDK GenerateContentResponse to stable LLMResponse
+     */
+    toHookLLMResponse(sdkResponse: GenerateContentResponse): LLMResponse;
+    /**
+     * Convert stable LLMResponse to genai SDK GenerateContentResponse
+     */
+    fromHookLLMResponse(hookResponse: LLMResponse): GenerateContentResponse;
+    /**
+     * Convert genai SDK ToolConfig to stable HookToolConfig
+     */
+    toHookToolConfig(sdkToolConfig: ToolConfig): HookToolConfig;
+    /**
+     * Convert stable HookToolConfig to genai SDK ToolConfig
+     */
+    fromHookToolConfig(hookToolConfig: HookToolConfig): ToolConfig;
+}
+/**
+ * Default translator instance for current GenAI SDK version
+ */
+export declare const defaultHookTranslator: HookTranslatorGenAIv1;