@machina.ai/cell-cli-core 1.13.0-rc5 → 1.16.0-rc2

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/hookRunner.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { HookConfig } from './types.js';
+import { HookEventName } from './types.js';
+import type { HookInput, HookExecutionResult } from './types.js';
+/**
+ * Hook runner that executes command hooks
+ */
+export declare class HookRunner {
+    constructor();
+    /**
+     * Execute a single hook
+     */
+    executeHook(hookConfig: HookConfig, eventName: HookEventName, input: HookInput): Promise<HookExecutionResult>;
+    /**
+     * Execute multiple hooks in parallel
+     */
+    executeHooksParallel(hookConfigs: HookConfig[], eventName: HookEventName, input: HookInput): Promise<HookExecutionResult[]>;
+    /**
+     * Execute multiple hooks sequentially
+     */
+    executeHooksSequential(hookConfigs: HookConfig[], eventName: HookEventName, input: HookInput): Promise<HookExecutionResult[]>;
+    /**
+     * Apply hook output to modify input for the next hook in sequential execution
+     */
+    private applyHookOutputToInput;
+    /**
+     * Execute a command hook
+     */
+    private executeCommandHook;
+    /**
+     * Expand command with environment variables and input context
+     */
+    private expandCommand;
+    /**
+     * Convert plain text output to structured HookOutput
+     */
+    private convertPlainTextToHookOutput;
+}