@terminai/core 0.21.0

package/dist/src/hooks/hookTranslator.js

@@ -0,0 +1,233 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DEFAULT_GEMINI_FLASH_MODEL } from '../config/models.js';
+/**
+ * Base class for hook translators - handles version-specific translation logic
+ */
+export class HookTranslator {
+}
+/**
+ * Type guard to check if a value has a text property
+ */
+function hasTextProperty(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'text' in value &&
+        typeof value.text === 'string');
+}
+/**
+ * Type guard to check if content has role and parts properties
+ */
+function isContentWithParts(content) {
+    return (typeof content === 'object' &&
+        content !== null &&
+        'role' in content &&
+        'parts' in content);
+}
+/**
+ * Helper to safely extract generation config from SDK request
+ * The SDK uses a config field that contains generation parameters
+ */
+function extractGenerationConfig(request) {
+    // Access the config field which contains generation settings
+    // Use type assertion after checking the field exists
+    if (request.config && typeof request.config === 'object') {
+        const config = request.config;
+        return {
+            temperature: config.temperature,
+            maxOutputTokens: config.maxOutputTokens,
+            topP: config.topP,
+            topK: config.topK,
+        };
+    }
+    return undefined;
+}
+/**
+ * Hook translator for GenAI SDK v1.x
+ * Handles translation between GenAI SDK types and stable Hook API types
+ */
+export 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) {
+        const messages = [];
+        // Convert contents to messages format (simplified)
+        if (sdkRequest.contents) {
+            const contents = Array.isArray(sdkRequest.contents)
+                ? sdkRequest.contents
+                : [sdkRequest.contents];
+            for (const content of contents) {
+                if (typeof content === 'string') {
+                    messages.push({
+                        role: 'user',
+                        content,
+                    });
+                }
+                else if (isContentWithParts(content)) {
+                    const role = content.role === 'model'
+                        ? 'model'
+                        : content.role === 'system'
+                            ? 'system'
+                            : 'user';
+                    const parts = Array.isArray(content.parts)
+                        ? content.parts
+                        : [content.parts];
+                    // Extract only text parts - intentionally filtering out non-text content
+                    const textContent = parts
+                        .filter(hasTextProperty)
+                        .map((part) => part.text)
+                        .join('');
+                    // Only add message if there's text content
+                    if (textContent) {
+                        messages.push({
+                            role,
+                            content: textContent,
+                        });
+                    }
+                }
+            }
+        }
+        // Safely extract generation config using proper type access
+        const config = extractGenerationConfig(sdkRequest);
+        return {
+            model: sdkRequest.model || DEFAULT_GEMINI_FLASH_MODEL,
+            messages,
+            config: {
+                temperature: config?.temperature,
+                maxOutputTokens: config?.maxOutputTokens,
+                topP: config?.topP,
+                topK: config?.topK,
+            },
+        };
+    }
+    /**
+     * Convert stable LLMRequest to genai SDK GenerateContentParameters
+     */
+    fromHookLLMRequest(hookRequest, baseRequest) {
+        // Convert hook messages back to SDK Content format
+        const contents = hookRequest.messages.map((message) => ({
+            role: message.role === 'model' ? 'model' : message.role,
+            parts: [
+                {
+                    text: typeof message.content === 'string'
+                        ? message.content
+                        : String(message.content),
+                },
+            ],
+        }));
+        // Build the result with proper typing
+        const result = {
+            ...baseRequest,
+            model: hookRequest.model,
+            contents,
+        };
+        // Add generation config if it exists in the hook request
+        if (hookRequest.config) {
+            const baseConfig = baseRequest
+                ? extractGenerationConfig(baseRequest)
+                : undefined;
+            result.config = {
+                ...baseConfig,
+                temperature: hookRequest.config.temperature,
+                maxOutputTokens: hookRequest.config.maxOutputTokens,
+                topP: hookRequest.config.topP,
+                topK: hookRequest.config.topK,
+            };
+        }
+        return result;
+    }
+    /**
+     * Convert genai SDK GenerateContentResponse to stable LLMResponse
+     */
+    toHookLLMResponse(sdkResponse) {
+        return {
+            text: sdkResponse.text,
+            candidates: (sdkResponse.candidates || []).map((candidate) => {
+                // Extract text parts from the candidate
+                const textParts = candidate.content?.parts
+                    ?.filter(hasTextProperty)
+                    .map((part) => part.text) || [];
+                return {
+                    content: {
+                        role: 'model',
+                        parts: textParts,
+                    },
+                    finishReason: candidate.finishReason,
+                    index: candidate.index,
+                    safetyRatings: candidate.safetyRatings?.map((rating) => ({
+                        category: String(rating.category || ''),
+                        probability: String(rating.probability || ''),
+                    })),
+                };
+            }),
+            usageMetadata: sdkResponse.usageMetadata
+                ? {
+                    promptTokenCount: sdkResponse.usageMetadata.promptTokenCount,
+                    candidatesTokenCount: sdkResponse.usageMetadata.candidatesTokenCount,
+                    totalTokenCount: sdkResponse.usageMetadata.totalTokenCount,
+                }
+                : undefined,
+        };
+    }
+    /**
+     * Convert stable LLMResponse to genai SDK GenerateContentResponse
+     */
+    fromHookLLMResponse(hookResponse) {
+        // Build response object with proper structure
+        const response = {
+            text: hookResponse.text,
+            candidates: hookResponse.candidates.map((candidate) => ({
+                content: {
+                    role: 'model',
+                    parts: candidate.content.parts.map((part) => ({
+                        text: part,
+                    })),
+                },
+                finishReason: candidate.finishReason,
+                index: candidate.index,
+                safetyRatings: candidate.safetyRatings,
+            })),
+            usageMetadata: hookResponse.usageMetadata,
+        };
+        return response;
+    }
+    /**
+     * Convert genai SDK ToolConfig to stable HookToolConfig
+     */
+    toHookToolConfig(sdkToolConfig) {
+        return {
+            mode: sdkToolConfig.functionCallingConfig?.mode,
+            allowedFunctionNames: sdkToolConfig.functionCallingConfig?.allowedFunctionNames,
+        };
+    }
+    /**
+     * Convert stable HookToolConfig to genai SDK ToolConfig
+     */
+    fromHookToolConfig(hookToolConfig) {
+        const functionCallingConfig = hookToolConfig.mode || hookToolConfig.allowedFunctionNames
+            ? {
+                mode: hookToolConfig.mode,
+                allowedFunctionNames: hookToolConfig.allowedFunctionNames,
+            }
+            : undefined;
+        return {
+            functionCallingConfig,
+        };
+    }
+}
+/**
+ * Default translator instance for current GenAI SDK version
+ */
+export const defaultHookTranslator = new HookTranslatorGenAIv1();
+//# sourceMappingURL=hookTranslator.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/hooks/hookTranslator.test.js

@@ -0,0 +1,193 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach } from 'vitest';
+import { HookTranslatorGenAIv1, defaultHookTranslator, } from './hookTranslator.js';
+describe('HookTranslator', () => {
+    let translator;
+    beforeEach(() => {
+        translator = new HookTranslatorGenAIv1();
+    });
+    describe('defaultHookTranslator', () => {
+        it('should be an instance of HookTranslatorGenAIv1', () => {
+            expect(defaultHookTranslator).toBeInstanceOf(HookTranslatorGenAIv1);
+        });
+    });
+    describe('LLM Request Translation', () => {
+        it('should convert SDK request to hook format', () => {
+            const sdkRequest = {
+                model: 'gemini-1.5-flash',
+                contents: [
+                    {
+                        role: 'user',
+                        parts: [{ text: 'Hello world' }],
+                    },
+                ],
+                config: {
+                    temperature: 0.7,
+                    maxOutputTokens: 1000,
+                },
+            };
+            const hookRequest = translator.toHookLLMRequest(sdkRequest);
+            expect(hookRequest).toEqual({
+                model: 'gemini-1.5-flash',
+                messages: [
+                    {
+                        role: 'user',
+                        content: 'Hello world',
+                    },
+                ],
+                config: {
+                    temperature: 0.7,
+                    maxOutputTokens: 1000,
+                    topP: undefined,
+                    topK: undefined,
+                },
+            });
+        });
+        it('should handle string contents', () => {
+            const sdkRequest = {
+                model: 'gemini-1.5-flash',
+                contents: ['Simple string message'],
+            };
+            const hookRequest = translator.toHookLLMRequest(sdkRequest);
+            expect(hookRequest.messages).toEqual([
+                {
+                    role: 'user',
+                    content: 'Simple string message',
+                },
+            ]);
+        });
+        it('should handle conversion errors gracefully', () => {
+            const sdkRequest = {
+                model: 'gemini-1.5-flash',
+                contents: [null], // Invalid content
+            };
+            const hookRequest = translator.toHookLLMRequest(sdkRequest);
+            // When contents are invalid, the translator skips them and returns empty messages
+            expect(hookRequest.messages).toEqual([]);
+            expect(hookRequest.model).toBe('gemini-1.5-flash');
+        });
+        it('should convert hook request back to SDK format', () => {
+            const hookRequest = {
+                model: 'gemini-1.5-flash',
+                messages: [
+                    {
+                        role: 'user',
+                        content: 'Hello world',
+                    },
+                ],
+                config: {
+                    temperature: 0.7,
+                    maxOutputTokens: 1000,
+                },
+            };
+            const sdkRequest = translator.fromHookLLMRequest(hookRequest);
+            expect(sdkRequest.model).toBe('gemini-1.5-flash');
+            expect(sdkRequest.contents).toEqual([
+                {
+                    role: 'user',
+                    parts: [{ text: 'Hello world' }],
+                },
+            ]);
+        });
+    });
+    describe('LLM Response Translation', () => {
+        it('should convert SDK response to hook format', () => {
+            const sdkResponse = {
+                text: 'Hello response',
+                candidates: [
+                    {
+                        content: {
+                            role: 'model',
+                            parts: [{ text: 'Hello response' }],
+                        },
+                        finishReason: 'STOP',
+                        index: 0,
+                    },
+                ],
+                usageMetadata: {
+                    promptTokenCount: 10,
+                    candidatesTokenCount: 20,
+                    totalTokenCount: 30,
+                },
+            };
+            const hookResponse = translator.toHookLLMResponse(sdkResponse);
+            expect(hookResponse).toEqual({
+                text: 'Hello response',
+                candidates: [
+                    {
+                        content: {
+                            role: 'model',
+                            parts: ['Hello response'],
+                        },
+                        finishReason: 'STOP',
+                        index: 0,
+                        safetyRatings: undefined,
+                    },
+                ],
+                usageMetadata: {
+                    promptTokenCount: 10,
+                    candidatesTokenCount: 20,
+                    totalTokenCount: 30,
+                },
+            });
+        });
+        it('should convert hook response back to SDK format', () => {
+            const hookResponse = {
+                text: 'Hello response',
+                candidates: [
+                    {
+                        content: {
+                            role: 'model',
+                            parts: ['Hello response'],
+                        },
+                        finishReason: 'STOP',
+                    },
+                ],
+            };
+            const sdkResponse = translator.fromHookLLMResponse(hookResponse);
+            expect(sdkResponse.text).toBe('Hello response');
+            expect(sdkResponse.candidates).toHaveLength(1);
+            expect(sdkResponse.candidates?.[0]?.content?.parts?.[0]?.text).toBe('Hello response');
+        });
+    });
+    describe('Tool Config Translation', () => {
+        it('should convert SDK tool config to hook format', () => {
+            const sdkToolConfig = {
+                functionCallingConfig: {
+                    mode: 'ANY',
+                    allowedFunctionNames: ['tool1', 'tool2'],
+                },
+            };
+            const hookToolConfig = translator.toHookToolConfig(sdkToolConfig);
+            expect(hookToolConfig).toEqual({
+                mode: 'ANY',
+                allowedFunctionNames: ['tool1', 'tool2'],
+            });
+        });
+        it('should convert hook tool config back to SDK format', () => {
+            const hookToolConfig = {
+                mode: 'AUTO',
+                allowedFunctionNames: ['tool1', 'tool2'],
+            };
+            const sdkToolConfig = translator.fromHookToolConfig(hookToolConfig);
+            expect(sdkToolConfig.functionCallingConfig).toEqual({
+                mode: 'AUTO',
+                allowedFunctionNames: ['tool1', 'tool2'],
+            });
+        });
+        it('should handle undefined tool config', () => {
+            const sdkToolConfig = {};
+            const hookToolConfig = translator.toHookToolConfig(sdkToolConfig);
+            expect(hookToolConfig).toEqual({
+                mode: undefined,
+                allowedFunctionNames: undefined,
+            });
+        });
+    });
+});
+//# sourceMappingURL=hookTranslator.test.js.map

package/dist/src/hooks/hookTranslator.test.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from './types.js';
+export { HookSystem } from './hookSystem.js';
+export { HookRegistry } from './hookRegistry.js';
+export { HookRunner } from './hookRunner.js';
+export { HookAggregator } from './hookAggregator.js';
+export { HookPlanner } from './hookPlanner.js';
+export { HookEventHandler } from './hookEventHandler.js';
+export type { HookRegistryEntry } from './hookRegistry.js';
+export { ConfigSource } from './hookRegistry.js';
+export type { AggregatedHookResult } from './hookAggregator.js';
+export type { HookEventContext } from './hookPlanner.js';
+export { fireSessionStartHook, fireSessionEndHook, firePreCompressHook, } from '../core/sessionHookTriggers.js';

package/dist/src/hooks/index.js

@@ -0,0 +1,19 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * Portions Copyright 2025 TerminaI Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// Export types
+export * from './types.js';
+// Export core components
+export { HookSystem } from './hookSystem.js';
+export { HookRegistry } from './hookRegistry.js';
+export { HookRunner } from './hookRunner.js';
+export { HookAggregator } from './hookAggregator.js';
+export { HookPlanner } from './hookPlanner.js';
+export { HookEventHandler } from './hookEventHandler.js';
+export { ConfigSource } from './hookRegistry.js';
+// Export hook trigger functions
+export { fireSessionStartHook, fireSessionEndHook, firePreCompressHook, } from '../core/sessionHookTriggers.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAe;AACf,cAAc,YAAY,CAAC;AAE3B,yBAAyB;AACzB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAIzD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIjD,gCAAgC;AAChC,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,gCAAgC,CAAC"}