@office-ai/aioncli-core 0.2.3 → 0.18.4

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

@@ -0,0 +1,387 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach } from 'vitest';
+import { HookAggregator } from './hookAggregator.js';
+import { HookType, HookEventName } from './types.js';
+// Helper function to create proper HookExecutionResult objects
+function createHookExecutionResult(output, success = true, duration = 100, error) {
+    return {
+        success,
+        output,
+        duration,
+        error,
+        hookConfig: {
+            type: HookType.Command,
+            command: 'test-command',
+            timeout: 30000,
+        },
+        eventName: HookEventName.BeforeTool,
+    };
+}
+describe('HookAggregator', () => {
+    let aggregator;
+    beforeEach(() => {
+        aggregator = new HookAggregator();
+    });
+    describe('aggregateResults', () => {
+        it('should handle empty results', () => {
+            const results = [];
+            const aggregated = aggregator.aggregateResults(results, HookEventName.BeforeTool);
+            expect(aggregated.success).toBe(true);
+            expect(aggregated.allOutputs).toHaveLength(0);
+            expect(aggregated.errors).toHaveLength(0);
+            expect(aggregated.totalDuration).toBe(0);
+            expect(aggregated.finalOutput).toBeUndefined();
+        });
+        it('should aggregate successful results', () => {
+            const results = [
+                createHookExecutionResult({ decision: 'allow', reason: 'Hook 1 approved' }, true, 100),
+                createHookExecutionResult({ decision: 'allow', reason: 'Hook 2 approved' }, true, 150),
+            ];
+            const aggregated = aggregator.aggregateResults(results, HookEventName.BeforeTool);
+            expect(aggregated.success).toBe(true);
+            expect(aggregated.allOutputs).toHaveLength(2);
+            expect(aggregated.errors).toHaveLength(0);
+            expect(aggregated.totalDuration).toBe(250);
+            expect(aggregated.finalOutput?.decision).toBe('allow');
+            expect(aggregated.finalOutput?.reason).toBe('Hook 1 approved\nHook 2 approved');
+        });
+        it('should handle errors in results', () => {
+            const results = [
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.BeforeTool,
+                    success: false,
+                    error: new Error('Hook failed'),
+                    duration: 50,
+                },
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.BeforeTool,
+                    success: true,
+                    output: { decision: 'allow' },
+                    duration: 100,
+                },
+            ];
+            const aggregated = aggregator.aggregateResults(results, HookEventName.BeforeTool);
+            expect(aggregated.success).toBe(false);
+            expect(aggregated.allOutputs).toHaveLength(1);
+            expect(aggregated.errors).toHaveLength(1);
+            expect(aggregated.errors[0].message).toBe('Hook failed');
+            expect(aggregated.totalDuration).toBe(150);
+        });
+        it('should handle blocking decisions with OR logic', () => {
+            const results = [
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.BeforeTool,
+                    success: true,
+                    output: { decision: 'allow', reason: 'Hook 1 allowed' },
+                    duration: 100,
+                },
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.BeforeTool,
+                    success: true,
+                    output: { decision: 'block', reason: 'Hook 2 blocked' },
+                    duration: 150,
+                },
+            ];
+            const aggregated = aggregator.aggregateResults(results, HookEventName.BeforeTool);
+            expect(aggregated.success).toBe(true);
+            expect(aggregated.finalOutput?.decision).toBe('block');
+            expect(aggregated.finalOutput?.reason).toBe('Hook 1 allowed\nHook 2 blocked');
+        });
+        it('should handle continue=false with precedence', () => {
+            const results = [
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.BeforeTool,
+                    success: true,
+                    output: { decision: 'allow', continue: true },
+                    duration: 100,
+                },
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.BeforeTool,
+                    success: true,
+                    output: {
+                        decision: 'allow',
+                        continue: false,
+                        stopReason: 'Stop requested',
+                    },
+                    duration: 150,
+                },
+            ];
+            const aggregated = aggregator.aggregateResults(results, HookEventName.BeforeTool);
+            expect(aggregated.success).toBe(true);
+            expect(aggregated.finalOutput?.continue).toBe(false);
+            expect(aggregated.finalOutput?.stopReason).toBe('Stop requested');
+        });
+    });
+    describe('BeforeToolSelection merge strategy', () => {
+        it('should merge tool configurations with NONE mode precedence', () => {
+            const results = [
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.BeforeToolSelection,
+                    success: true,
+                    output: {
+                        hookSpecificOutput: {
+                            hookEventName: 'BeforeToolSelection',
+                            toolConfig: {
+                                mode: 'ANY',
+                                allowedFunctionNames: ['tool1', 'tool2'],
+                            },
+                        },
+                    },
+                    duration: 100,
+                },
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.BeforeToolSelection,
+                    success: true,
+                    output: {
+                        hookSpecificOutput: {
+                            hookEventName: 'BeforeToolSelection',
+                            toolConfig: {
+                                mode: 'NONE',
+                                allowedFunctionNames: [],
+                            },
+                        },
+                    },
+                    duration: 150,
+                },
+            ];
+            const aggregated = aggregator.aggregateResults(results, HookEventName.BeforeToolSelection);
+            expect(aggregated.success).toBe(true);
+            const output = aggregated.finalOutput;
+            const toolConfig = output.hookSpecificOutput?.toolConfig;
+            expect(toolConfig?.mode).toBe('NONE');
+            expect(toolConfig?.allowedFunctionNames).toEqual([]);
+        });
+        it('should merge tool configurations with ANY mode', () => {
+            const results = [
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.BeforeToolSelection,
+                    success: true,
+                    output: {
+                        hookSpecificOutput: {
+                            hookEventName: 'BeforeToolSelection',
+                            toolConfig: {
+                                mode: 'AUTO',
+                                allowedFunctionNames: ['tool1'],
+                            },
+                        },
+                    },
+                    duration: 100,
+                },
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.BeforeToolSelection,
+                    success: true,
+                    output: {
+                        hookSpecificOutput: {
+                            hookEventName: 'BeforeToolSelection',
+                            toolConfig: {
+                                mode: 'ANY',
+                                allowedFunctionNames: ['tool2', 'tool3'],
+                            },
+                        },
+                    },
+                    duration: 150,
+                },
+            ];
+            const aggregated = aggregator.aggregateResults(results, HookEventName.BeforeToolSelection);
+            expect(aggregated.success).toBe(true);
+            const output = aggregated.finalOutput;
+            const toolConfig = output.hookSpecificOutput?.toolConfig;
+            expect(toolConfig?.mode).toBe('ANY');
+            expect(toolConfig?.allowedFunctionNames).toEqual([
+                'tool1',
+                'tool2',
+                'tool3',
+            ]);
+        });
+        it('should merge tool configurations with AUTO mode when all are AUTO', () => {
+            const results = [
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.BeforeToolSelection,
+                    success: true,
+                    output: {
+                        hookSpecificOutput: {
+                            hookEventName: 'BeforeToolSelection',
+                            toolConfig: {
+                                mode: 'AUTO',
+                                allowedFunctionNames: ['tool1'],
+                            },
+                        },
+                    },
+                    duration: 100,
+                },
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.BeforeToolSelection,
+                    success: true,
+                    output: {
+                        hookSpecificOutput: {
+                            hookEventName: 'BeforeToolSelection',
+                            toolConfig: {
+                                mode: 'AUTO',
+                                allowedFunctionNames: ['tool2'],
+                            },
+                        },
+                    },
+                    duration: 150,
+                },
+            ];
+            const aggregated = aggregator.aggregateResults(results, HookEventName.BeforeToolSelection);
+            expect(aggregated.success).toBe(true);
+            const output = aggregated.finalOutput;
+            const toolConfig = output.hookSpecificOutput?.toolConfig;
+            expect(toolConfig?.mode).toBe('AUTO');
+            expect(toolConfig?.allowedFunctionNames).toEqual(['tool1', 'tool2']);
+        });
+    });
+    describe('BeforeModel/AfterModel merge strategy', () => {
+        it('should use field replacement strategy', () => {
+            const results = [
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.BeforeModel,
+                    success: true,
+                    output: {
+                        decision: 'allow',
+                        hookSpecificOutput: {
+                            hookEventName: 'BeforeModel',
+                            llm_request: { model: 'model1', config: {}, contents: [] },
+                        },
+                    },
+                    duration: 100,
+                },
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.BeforeModel,
+                    success: true,
+                    output: {
+                        decision: 'block',
+                        hookSpecificOutput: {
+                            hookEventName: 'BeforeModel',
+                            llm_request: { model: 'model2', config: {}, contents: [] },
+                        },
+                    },
+                    duration: 150,
+                },
+            ];
+            const aggregated = aggregator.aggregateResults(results, HookEventName.BeforeModel);
+            expect(aggregated.success).toBe(true);
+            expect(aggregated.finalOutput?.decision).toBe('block'); // Later value wins
+            const output = aggregated.finalOutput;
+            const llmRequest = output.hookSpecificOutput?.llm_request;
+            expect(llmRequest?.['model']).toBe('model2'); // Later value wins
+        });
+    });
+    describe('extractAdditionalContext', () => {
+        it('should extract additional context from hook outputs', () => {
+            const results = [
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.AfterTool,
+                    success: true,
+                    output: {
+                        hookSpecificOutput: {
+                            hookEventName: 'AfterTool',
+                            additionalContext: 'Context from hook 1',
+                        },
+                    },
+                    duration: 100,
+                },
+                {
+                    hookConfig: {
+                        type: HookType.Command,
+                        command: 'test-command',
+                        timeout: 30000,
+                    },
+                    eventName: HookEventName.AfterTool,
+                    success: true,
+                    output: {
+                        hookSpecificOutput: {
+                            hookEventName: 'AfterTool',
+                            additionalContext: 'Context from hook 2',
+                        },
+                    },
+                    duration: 150,
+                },
+            ];
+            const aggregated = aggregator.aggregateResults(results, HookEventName.AfterTool);
+            expect(aggregated.success).toBe(true);
+            expect(aggregated.finalOutput?.hookSpecificOutput?.['additionalContext']).toBe('Context from hook 1\nContext from hook 2');
+        });
+    });
+});
+//# sourceMappingURL=hookAggregator.test.js.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { HookRegistry } from './hookRegistry.js';
+import type { HookExecutionPlan } from './types.js';
+import type { HookEventName } from './types.js';
+/**
+ * Hook planner that selects matching hooks and creates execution plans
+ */
+export declare class HookPlanner {
+    private readonly hookRegistry;
+    constructor(hookRegistry: HookRegistry);
+    /**
+     * Create execution plan for a hook event
+     */
+    createExecutionPlan(eventName: HookEventName, context?: HookEventContext): HookExecutionPlan | null;
+    /**
+     * Check if a hook entry matches the given context
+     */
+    private matchesContext;
+    /**
+     * Match tool name against matcher pattern
+     */
+    private matchesToolName;
+    /**
+     * Match trigger/source against matcher pattern
+     */
+    private matchesTrigger;
+    /**
+     * Deduplicate identical hook configurations
+     */
+    private deduplicateHooks;
+    /**
+     * Generate a unique key for a hook entry
+     */
+    private getHookKey;
+}
+/**
+ * Context information for hook event matching
+ */
+export interface HookEventContext {
+    toolName?: string;
+    trigger?: string;
+}

package/dist/src/hooks/hookPlanner.js

@@ -0,0 +1,108 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { debugLogger } from '../utils/debugLogger.js';
+/**
+ * Hook planner that selects matching hooks and creates execution plans
+ */
+export class HookPlanner {
+    hookRegistry;
+    constructor(hookRegistry) {
+        this.hookRegistry = hookRegistry;
+    }
+    /**
+     * Create execution plan for a hook event
+     */
+    createExecutionPlan(eventName, context) {
+        const hookEntries = this.hookRegistry.getHooksForEvent(eventName);
+        if (hookEntries.length === 0) {
+            return null;
+        }
+        // Filter hooks by matcher
+        const matchingEntries = hookEntries.filter((entry) => this.matchesContext(entry, context));
+        if (matchingEntries.length === 0) {
+            return null;
+        }
+        // Deduplicate identical hooks
+        const deduplicatedEntries = this.deduplicateHooks(matchingEntries);
+        // Extract hook configs
+        const hookConfigs = deduplicatedEntries.map((entry) => entry.config);
+        // Determine execution strategy - if ANY hook definition has sequential=true, run all sequentially
+        const sequential = deduplicatedEntries.some((entry) => entry.sequential === true);
+        const plan = {
+            eventName,
+            hookConfigs,
+            sequential,
+        };
+        debugLogger.debug(`Created execution plan for ${eventName}: ${hookConfigs.length} hook(s) to execute ${sequential ? 'sequentially' : 'in parallel'}`);
+        return plan;
+    }
+    /**
+     * Check if a hook entry matches the given context
+     */
+    matchesContext(entry, context) {
+        if (!entry.matcher || !context) {
+            return true; // No matcher means match all
+        }
+        const matcher = entry.matcher.trim();
+        if (matcher === '' || matcher === '*') {
+            return true; // Empty string or wildcard matches all
+        }
+        // For tool events, match against tool name
+        if (context.toolName) {
+            return this.matchesToolName(matcher, context.toolName);
+        }
+        // For other events, match against trigger/source
+        if (context.trigger) {
+            return this.matchesTrigger(matcher, context.trigger);
+        }
+        return true;
+    }
+    /**
+     * Match tool name against matcher pattern
+     */
+    matchesToolName(matcher, toolName) {
+        try {
+            // Attempt to treat the matcher as a regular expression.
+            const regex = new RegExp(matcher);
+            return regex.test(toolName);
+        }
+        catch {
+            // If it's not a valid regex, treat it as a literal string for an exact match.
+            return matcher === toolName;
+        }
+    }
+    /**
+     * Match trigger/source against matcher pattern
+     */
+    matchesTrigger(matcher, trigger) {
+        return matcher === trigger;
+    }
+    /**
+     * Deduplicate identical hook configurations
+     */
+    deduplicateHooks(entries) {
+        const seen = new Set();
+        const deduplicated = [];
+        for (const entry of entries) {
+            const key = this.getHookKey(entry);
+            if (!seen.has(key)) {
+                seen.add(key);
+                deduplicated.push(entry);
+            }
+            else {
+                debugLogger.debug(`Deduplicated hook: ${key}`);
+            }
+        }
+        return deduplicated;
+    }
+    /**
+     * Generate a unique key for a hook entry
+     */
+    getHookKey(entry) {
+        return `command:${entry.config.command}`;
+    }
+}
+//# sourceMappingURL=hookPlanner.js.map

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

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

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

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