@vybestack/llxprt-code-core 0.8.0 → 0.9.0-nightly.260120.c5843db0e
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/src/auth/token-store.d.ts +57 -0
- package/dist/src/auth/token-store.js +137 -0
- package/dist/src/auth/token-store.js.map +1 -1
- package/dist/src/code_assist/oauth-credential-storage.js +9 -4
- package/dist/src/code_assist/oauth-credential-storage.js.map +1 -1
- package/dist/src/config/config.d.ts +53 -8
- package/dist/src/config/config.js +106 -10
- package/dist/src/config/config.js.map +1 -1
- package/dist/src/config/schedulerSingleton.js.map +1 -1
- package/dist/src/config/storage.d.ts +3 -0
- package/dist/src/config/storage.js +20 -0
- package/dist/src/config/storage.js.map +1 -1
- package/dist/src/core/client.d.ts +5 -0
- package/dist/src/core/client.js +18 -6
- package/dist/src/core/client.js.map +1 -1
- package/dist/src/core/geminiChat.js +0 -2
- package/dist/src/core/geminiChat.js.map +1 -1
- package/dist/src/core/nonInteractiveToolExecutor.js +6 -1
- package/dist/src/core/nonInteractiveToolExecutor.js.map +1 -1
- package/dist/src/hooks/hookPlanner.d.ts +46 -0
- package/dist/src/hooks/hookPlanner.js +109 -0
- package/dist/src/hooks/hookPlanner.js.map +1 -0
- package/dist/src/hooks/hookRegistry.d.ts +87 -0
- package/dist/src/hooks/hookRegistry.js +199 -0
- package/dist/src/hooks/hookRegistry.js.map +1 -0
- package/dist/src/hooks/hookTranslator.d.ts +113 -0
- package/dist/src/hooks/hookTranslator.js +232 -0
- package/dist/src/hooks/hookTranslator.js.map +1 -0
- package/dist/src/hooks/index.d.ts +12 -0
- package/dist/src/hooks/index.js +14 -0
- package/dist/src/hooks/index.js.map +1 -0
- package/dist/src/hooks/types.d.ts +384 -0
- package/dist/src/hooks/types.js +284 -0
- package/dist/src/hooks/types.js.map +1 -0
- package/dist/src/ide/ide-client.d.ts +5 -0
- package/dist/src/ide/ide-client.js +7 -0
- package/dist/src/ide/ide-client.js.map +1 -1
- package/dist/src/index.d.ts +8 -2
- package/dist/src/index.js +13 -3
- package/dist/src/index.js.map +1 -1
- package/dist/src/mcp/oauth-provider.d.ts +9 -9
- package/dist/src/mcp/oauth-provider.js +124 -42
- package/dist/src/mcp/oauth-provider.js.map +1 -1
- package/dist/src/mcp/sa-impersonation-provider.js.map +1 -1
- package/dist/src/mcp/token-storage/hybrid-token-storage.js.map +1 -1
- package/dist/src/models/hydration.d.ts +40 -0
- package/dist/src/models/hydration.js +148 -0
- package/dist/src/models/hydration.js.map +1 -0
- package/dist/src/models/index.d.ts +33 -0
- package/dist/src/models/index.js +46 -0
- package/dist/src/models/index.js.map +1 -0
- package/dist/src/models/profiles.d.ts +19 -0
- package/dist/src/models/profiles.js +83 -0
- package/dist/src/models/profiles.js.map +1 -0
- package/dist/src/models/provider-integration.d.ts +49 -0
- package/dist/src/models/provider-integration.js +162 -0
- package/dist/src/models/provider-integration.js.map +1 -0
- package/dist/src/models/registry.d.ts +137 -0
- package/dist/src/models/registry.js +321 -0
- package/dist/src/models/registry.js.map +1 -0
- package/dist/src/models/schema.d.ts +1173 -0
- package/dist/src/models/schema.js +166 -0
- package/dist/src/models/schema.js.map +1 -0
- package/dist/src/models/transformer.d.ts +21 -0
- package/dist/src/models/transformer.js +130 -0
- package/dist/src/models/transformer.js.map +1 -0
- package/dist/src/policy/config.d.ts +42 -38
- package/dist/src/policy/config.js +306 -93
- package/dist/src/policy/config.js.map +1 -1
- package/dist/src/policy/policies/discovered.toml +2 -2
- package/dist/src/policy/policies/read-only.toml +39 -16
- package/dist/src/policy/policies/write.toml +56 -45
- package/dist/src/policy/policies/yolo.toml +2 -1
- package/dist/src/policy/policy-engine.d.ts +7 -0
- package/dist/src/policy/policy-engine.js +11 -0
- package/dist/src/policy/policy-engine.js.map +1 -1
- package/dist/src/policy/toml-loader.d.ts +50 -24
- package/dist/src/policy/toml-loader.js +368 -137
- package/dist/src/policy/toml-loader.js.map +1 -1
- package/dist/src/policy/types.d.ts +49 -0
- package/dist/src/policy/types.js +11 -0
- package/dist/src/policy/types.js.map +1 -1
- package/dist/src/providers/IProviderManager.d.ts +7 -3
- package/dist/src/providers/ProviderManager.d.ts +2 -2
- package/dist/src/providers/ProviderManager.js +56 -1
- package/dist/src/providers/ProviderManager.js.map +1 -1
- package/dist/src/providers/anthropic/AnthropicProvider.js +15 -15
- package/dist/src/providers/anthropic/AnthropicProvider.js.map +1 -1
- package/dist/src/providers/gemini/GeminiProvider.js +27 -25
- package/dist/src/providers/gemini/GeminiProvider.js.map +1 -1
- package/dist/src/providers/openai/OpenAIProvider.js +15 -5
- package/dist/src/providers/openai/OpenAIProvider.js.map +1 -1
- package/dist/src/providers/openai-responses/OpenAIResponsesProvider.d.ts +28 -29
- package/dist/src/providers/openai-responses/OpenAIResponsesProvider.js +30 -100
- package/dist/src/providers/openai-responses/OpenAIResponsesProvider.js.map +1 -1
- package/dist/src/services/fileDiscoveryService.d.ts +1 -0
- package/dist/src/services/fileDiscoveryService.js +17 -3
- package/dist/src/services/fileDiscoveryService.js.map +1 -1
- package/dist/src/services/loopDetectionService.d.ts +2 -2
- package/dist/src/services/loopDetectionService.js +4 -4
- package/dist/src/services/loopDetectionService.js.map +1 -1
- package/dist/src/services/shellExecutionService.d.ts +24 -0
- package/dist/src/services/shellExecutionService.js +119 -13
- package/dist/src/services/shellExecutionService.js.map +1 -1
- package/dist/src/tools/ast-edit.d.ts +133 -0
- package/dist/src/tools/ast-edit.js +1833 -0
- package/dist/src/tools/ast-edit.js.map +1 -0
- package/dist/src/tools/delete_line_range.js +2 -2
- package/dist/src/tools/delete_line_range.js.map +1 -1
- package/dist/src/tools/diffOptions.d.ts +3 -3
- package/dist/src/tools/diffOptions.js +4 -4
- package/dist/src/tools/diffOptions.js.map +1 -1
- package/dist/src/tools/edit.js +3 -3
- package/dist/src/tools/edit.js.map +1 -1
- package/dist/src/tools/google-web-fetch.js +1 -5
- package/dist/src/tools/google-web-fetch.js.map +1 -1
- package/dist/src/tools/insert_at_line.js +2 -2
- package/dist/src/tools/insert_at_line.js.map +1 -1
- package/dist/src/tools/mcp-client-manager.d.ts +48 -12
- package/dist/src/tools/mcp-client-manager.js +191 -48
- package/dist/src/tools/mcp-client-manager.js.map +1 -1
- package/dist/src/tools/mcp-client.d.ts +1 -0
- package/dist/src/tools/mcp-client.js +5 -0
- package/dist/src/tools/mcp-client.js.map +1 -1
- package/dist/src/tools/memoryTool.js +2 -2
- package/dist/src/tools/memoryTool.js.map +1 -1
- package/dist/src/tools/modifiable-tool.js +2 -2
- package/dist/src/tools/modifiable-tool.js.map +1 -1
- package/dist/src/tools/tool-error.d.ts +1 -0
- package/dist/src/tools/tool-error.js +1 -0
- package/dist/src/tools/tool-error.js.map +1 -1
- package/dist/src/tools/tool-registry.d.ts +2 -21
- package/dist/src/tools/tool-registry.js +3 -81
- package/dist/src/tools/tool-registry.js.map +1 -1
- package/dist/src/tools/tools.d.ts +10 -1
- package/dist/src/tools/tools.js.map +1 -1
- package/dist/src/tools/write-file.js +3 -3
- package/dist/src/tools/write-file.js.map +1 -1
- package/dist/src/utils/channel.d.ts +18 -0
- package/dist/src/utils/channel.js +49 -0
- package/dist/src/utils/channel.js.map +1 -0
- package/dist/src/utils/extensionLoader.d.ts +79 -0
- package/dist/src/utils/extensionLoader.js +162 -0
- package/dist/src/utils/extensionLoader.js.map +1 -0
- package/dist/src/utils/fetch.js +1 -6
- package/dist/src/utils/fetch.js.map +1 -1
- package/dist/src/utils/gitIgnoreParser.d.ts +9 -3
- package/dist/src/utils/gitIgnoreParser.js +105 -12
- package/dist/src/utils/gitIgnoreParser.js.map +1 -1
- package/dist/src/utils/googleErrors.d.ts +104 -0
- package/dist/src/utils/googleErrors.js +165 -0
- package/dist/src/utils/googleErrors.js.map +1 -0
- package/dist/src/utils/googleQuotaErrors.d.ts +36 -0
- package/dist/src/utils/googleQuotaErrors.js +149 -0
- package/dist/src/utils/googleQuotaErrors.js.map +1 -0
- package/dist/src/utils/memoryDiscovery.d.ts +13 -0
- package/dist/src/utils/memoryDiscovery.js +137 -0
- package/dist/src/utils/memoryDiscovery.js.map +1 -1
- package/dist/src/utils/package.d.ts +12 -0
- package/dist/src/utils/package.js +15 -0
- package/dist/src/utils/package.js.map +1 -0
- package/dist/src/utils/shell-parser.js +37 -7
- package/dist/src/utils/shell-parser.js.map +1 -1
- package/dist/src/utils/shell-utils.js +16 -21
- package/dist/src/utils/shell-utils.js.map +1 -1
- package/package.json +17 -1
- package/dist/src/providers/openai-responses/CODEX_PROMPT.d.ts +0 -34
- package/dist/src/providers/openai-responses/CODEX_PROMPT.js +0 -346
- package/dist/src/providers/openai-responses/CODEX_PROMPT.js.map +0 -1
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
* Copyright 2025 Vybestack LLC
|
|
4
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
5
|
+
*/
|
|
6
|
+
import type { HookRegistry } from './hookRegistry.js';
|
|
7
|
+
import type { HookExecutionPlan } from './types.js';
|
|
8
|
+
import type { HookEventName } from './types.js';
|
|
9
|
+
/**
|
|
10
|
+
* Hook planner that selects matching hooks and creates execution plans
|
|
11
|
+
*/
|
|
12
|
+
export declare class HookPlanner {
|
|
13
|
+
private readonly hookRegistry;
|
|
14
|
+
constructor(hookRegistry: HookRegistry);
|
|
15
|
+
/**
|
|
16
|
+
* Create execution plan for a hook event
|
|
17
|
+
*/
|
|
18
|
+
createExecutionPlan(eventName: HookEventName, context?: HookEventContext): HookExecutionPlan | null;
|
|
19
|
+
/**
|
|
20
|
+
* Check if a hook entry matches the given context
|
|
21
|
+
*/
|
|
22
|
+
private matchesContext;
|
|
23
|
+
/**
|
|
24
|
+
* Match tool name against matcher pattern
|
|
25
|
+
*/
|
|
26
|
+
private matchesToolName;
|
|
27
|
+
/**
|
|
28
|
+
* Match trigger/source against matcher pattern
|
|
29
|
+
*/
|
|
30
|
+
private matchesTrigger;
|
|
31
|
+
/**
|
|
32
|
+
* Deduplicate identical hook configurations
|
|
33
|
+
*/
|
|
34
|
+
private deduplicateHooks;
|
|
35
|
+
/**
|
|
36
|
+
* Generate a unique key for a hook entry
|
|
37
|
+
*/
|
|
38
|
+
private getHookKey;
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* Context information for hook event matching
|
|
42
|
+
*/
|
|
43
|
+
export interface HookEventContext {
|
|
44
|
+
toolName?: string;
|
|
45
|
+
trigger?: string;
|
|
46
|
+
}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
* Copyright 2025 Vybestack LLC
|
|
4
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
5
|
+
*/
|
|
6
|
+
import { DebugLogger } from '../debug/index.js';
|
|
7
|
+
const debugLogger = DebugLogger.getLogger('llxprt:core:hooks:planner');
|
|
8
|
+
/**
|
|
9
|
+
* Hook planner that selects matching hooks and creates execution plans
|
|
10
|
+
*/
|
|
11
|
+
export class HookPlanner {
|
|
12
|
+
hookRegistry;
|
|
13
|
+
constructor(hookRegistry) {
|
|
14
|
+
this.hookRegistry = hookRegistry;
|
|
15
|
+
}
|
|
16
|
+
/**
|
|
17
|
+
* Create execution plan for a hook event
|
|
18
|
+
*/
|
|
19
|
+
createExecutionPlan(eventName, context) {
|
|
20
|
+
const hookEntries = this.hookRegistry.getHooksForEvent(eventName);
|
|
21
|
+
if (hookEntries.length === 0) {
|
|
22
|
+
return null;
|
|
23
|
+
}
|
|
24
|
+
// Filter hooks by matcher
|
|
25
|
+
const matchingEntries = hookEntries.filter((entry) => this.matchesContext(entry, context));
|
|
26
|
+
if (matchingEntries.length === 0) {
|
|
27
|
+
return null;
|
|
28
|
+
}
|
|
29
|
+
// Deduplicate identical hooks
|
|
30
|
+
const deduplicatedEntries = this.deduplicateHooks(matchingEntries);
|
|
31
|
+
// Extract hook configs
|
|
32
|
+
const hookConfigs = deduplicatedEntries.map((entry) => entry.config);
|
|
33
|
+
// Determine execution strategy - if ANY hook definition has sequential=true, run all sequentially
|
|
34
|
+
const sequential = deduplicatedEntries.some((entry) => entry.sequential === true);
|
|
35
|
+
const plan = {
|
|
36
|
+
eventName,
|
|
37
|
+
hookConfigs,
|
|
38
|
+
sequential,
|
|
39
|
+
};
|
|
40
|
+
debugLogger.debug(`Created execution plan for ${eventName}: ${hookConfigs.length} hook(s) to execute ${sequential ? 'sequentially' : 'in parallel'}`);
|
|
41
|
+
return plan;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Check if a hook entry matches the given context
|
|
45
|
+
*/
|
|
46
|
+
matchesContext(entry, context) {
|
|
47
|
+
if (!entry.matcher || !context) {
|
|
48
|
+
return true; // No matcher means match all
|
|
49
|
+
}
|
|
50
|
+
const matcher = entry.matcher.trim();
|
|
51
|
+
if (matcher === '' || matcher === '*') {
|
|
52
|
+
return true; // Empty string or wildcard matches all
|
|
53
|
+
}
|
|
54
|
+
// For tool events, match against tool name
|
|
55
|
+
if (context.toolName) {
|
|
56
|
+
return this.matchesToolName(matcher, context.toolName);
|
|
57
|
+
}
|
|
58
|
+
// For other events, match against trigger/source
|
|
59
|
+
if (context.trigger) {
|
|
60
|
+
return this.matchesTrigger(matcher, context.trigger);
|
|
61
|
+
}
|
|
62
|
+
return true;
|
|
63
|
+
}
|
|
64
|
+
/**
|
|
65
|
+
* Match tool name against matcher pattern
|
|
66
|
+
*/
|
|
67
|
+
matchesToolName(matcher, toolName) {
|
|
68
|
+
try {
|
|
69
|
+
// Attempt to treat the matcher as a regular expression.
|
|
70
|
+
const regex = new RegExp(matcher);
|
|
71
|
+
return regex.test(toolName);
|
|
72
|
+
}
|
|
73
|
+
catch {
|
|
74
|
+
// If it's not a valid regex, treat it as a literal string for an exact match.
|
|
75
|
+
return matcher === toolName;
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* Match trigger/source against matcher pattern
|
|
80
|
+
*/
|
|
81
|
+
matchesTrigger(matcher, trigger) {
|
|
82
|
+
return matcher === trigger;
|
|
83
|
+
}
|
|
84
|
+
/**
|
|
85
|
+
* Deduplicate identical hook configurations
|
|
86
|
+
*/
|
|
87
|
+
deduplicateHooks(entries) {
|
|
88
|
+
const seen = new Set();
|
|
89
|
+
const deduplicated = [];
|
|
90
|
+
for (const entry of entries) {
|
|
91
|
+
const key = this.getHookKey(entry);
|
|
92
|
+
if (!seen.has(key)) {
|
|
93
|
+
seen.add(key);
|
|
94
|
+
deduplicated.push(entry);
|
|
95
|
+
}
|
|
96
|
+
else {
|
|
97
|
+
debugLogger.debug(`Deduplicated hook: ${key}`);
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
return deduplicated;
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Generate a unique key for a hook entry
|
|
104
|
+
*/
|
|
105
|
+
getHookKey(entry) {
|
|
106
|
+
return `command:${entry.config.command}`;
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
//# sourceMappingURL=hookPlanner.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hookPlanner.js","sourceRoot":"","sources":["../../../src/hooks/hookPlanner.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
* Copyright 2025 Vybestack LLC
|
|
4
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
5
|
+
*/
|
|
6
|
+
import type { Config } from '../config/config.js';
|
|
7
|
+
import type { HookConfig } from './types.js';
|
|
8
|
+
import { HookEventName } from './types.js';
|
|
9
|
+
/**
|
|
10
|
+
* Error thrown when attempting to use HookRegistry before initialization
|
|
11
|
+
*/
|
|
12
|
+
export declare class HookRegistryNotInitializedError extends Error {
|
|
13
|
+
constructor(message?: string);
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Configuration source levels in precedence order (highest to lowest)
|
|
17
|
+
*/
|
|
18
|
+
export declare enum ConfigSource {
|
|
19
|
+
Project = "project",
|
|
20
|
+
User = "user",
|
|
21
|
+
System = "system",
|
|
22
|
+
Extensions = "extensions"
|
|
23
|
+
}
|
|
24
|
+
/**
|
|
25
|
+
* Hook registry entry with source information
|
|
26
|
+
*/
|
|
27
|
+
export interface HookRegistryEntry {
|
|
28
|
+
config: HookConfig;
|
|
29
|
+
source: ConfigSource;
|
|
30
|
+
eventName: HookEventName;
|
|
31
|
+
matcher?: string;
|
|
32
|
+
sequential?: boolean;
|
|
33
|
+
enabled: boolean;
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* Hook registry that loads and validates hook definitions from multiple sources
|
|
37
|
+
*/
|
|
38
|
+
export declare class HookRegistry {
|
|
39
|
+
private readonly config;
|
|
40
|
+
private entries;
|
|
41
|
+
private initialized;
|
|
42
|
+
constructor(config: Config);
|
|
43
|
+
/**
|
|
44
|
+
* Initialize the registry by processing hooks from config
|
|
45
|
+
*/
|
|
46
|
+
initialize(): Promise<void>;
|
|
47
|
+
/**
|
|
48
|
+
* Get all hook entries for a specific event
|
|
49
|
+
*/
|
|
50
|
+
getHooksForEvent(eventName: HookEventName): HookRegistryEntry[];
|
|
51
|
+
/**
|
|
52
|
+
* Get all registered hooks
|
|
53
|
+
*/
|
|
54
|
+
getAllHooks(): HookRegistryEntry[];
|
|
55
|
+
/**
|
|
56
|
+
* Enable or disable a specific hook
|
|
57
|
+
*/
|
|
58
|
+
setHookEnabled(hookName: string, enabled: boolean): void;
|
|
59
|
+
/**
|
|
60
|
+
* Get hook name for display purposes
|
|
61
|
+
*/
|
|
62
|
+
private getHookName;
|
|
63
|
+
/**
|
|
64
|
+
* Process hooks from the config that was already loaded by the CLI
|
|
65
|
+
*/
|
|
66
|
+
private processHooksFromConfig;
|
|
67
|
+
/**
|
|
68
|
+
* Process hooks configuration and add entries
|
|
69
|
+
*/
|
|
70
|
+
private processHooksConfiguration;
|
|
71
|
+
/**
|
|
72
|
+
* Process a single hook definition
|
|
73
|
+
*/
|
|
74
|
+
private processHookDefinition;
|
|
75
|
+
/**
|
|
76
|
+
* Validate a hook configuration
|
|
77
|
+
*/
|
|
78
|
+
private validateHookConfig;
|
|
79
|
+
/**
|
|
80
|
+
* Check if an event name is valid
|
|
81
|
+
*/
|
|
82
|
+
private isValidEventName;
|
|
83
|
+
/**
|
|
84
|
+
* Get source priority (lower number = higher priority)
|
|
85
|
+
*/
|
|
86
|
+
private getSourcePriority;
|
|
87
|
+
}
|
|
@@ -0,0 +1,199 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
* Copyright 2025 Vybestack LLC
|
|
4
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
5
|
+
*/
|
|
6
|
+
import { HookEventName } from './types.js';
|
|
7
|
+
import { DebugLogger } from '../debug/index.js';
|
|
8
|
+
const debugLogger = DebugLogger.getLogger('llxprt:core:hooks:registry');
|
|
9
|
+
/**
|
|
10
|
+
* Error thrown when attempting to use HookRegistry before initialization
|
|
11
|
+
*/
|
|
12
|
+
export class HookRegistryNotInitializedError extends Error {
|
|
13
|
+
constructor(message = 'Hook registry not initialized') {
|
|
14
|
+
super(message);
|
|
15
|
+
this.name = 'HookRegistryNotInitializedError';
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
/**
|
|
19
|
+
* Configuration source levels in precedence order (highest to lowest)
|
|
20
|
+
*/
|
|
21
|
+
export var ConfigSource;
|
|
22
|
+
(function (ConfigSource) {
|
|
23
|
+
ConfigSource["Project"] = "project";
|
|
24
|
+
ConfigSource["User"] = "user";
|
|
25
|
+
ConfigSource["System"] = "system";
|
|
26
|
+
ConfigSource["Extensions"] = "extensions";
|
|
27
|
+
})(ConfigSource || (ConfigSource = {}));
|
|
28
|
+
/**
|
|
29
|
+
* Hook registry that loads and validates hook definitions from multiple sources
|
|
30
|
+
*/
|
|
31
|
+
export class HookRegistry {
|
|
32
|
+
config;
|
|
33
|
+
entries = [];
|
|
34
|
+
initialized = false;
|
|
35
|
+
constructor(config) {
|
|
36
|
+
this.config = config;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Initialize the registry by processing hooks from config
|
|
40
|
+
*/
|
|
41
|
+
async initialize() {
|
|
42
|
+
if (this.initialized) {
|
|
43
|
+
return;
|
|
44
|
+
}
|
|
45
|
+
this.entries = [];
|
|
46
|
+
this.processHooksFromConfig();
|
|
47
|
+
this.initialized = true;
|
|
48
|
+
debugLogger.log(`Hook registry initialized with ${this.entries.length} hook entries`);
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* Get all hook entries for a specific event
|
|
52
|
+
*/
|
|
53
|
+
getHooksForEvent(eventName) {
|
|
54
|
+
if (!this.initialized) {
|
|
55
|
+
throw new HookRegistryNotInitializedError();
|
|
56
|
+
}
|
|
57
|
+
return this.entries
|
|
58
|
+
.filter((entry) => entry.eventName === eventName && entry.enabled)
|
|
59
|
+
.sort((a, b) => this.getSourcePriority(a.source) - this.getSourcePriority(b.source));
|
|
60
|
+
}
|
|
61
|
+
/**
|
|
62
|
+
* Get all registered hooks
|
|
63
|
+
*/
|
|
64
|
+
getAllHooks() {
|
|
65
|
+
if (!this.initialized) {
|
|
66
|
+
throw new HookRegistryNotInitializedError();
|
|
67
|
+
}
|
|
68
|
+
return [...this.entries];
|
|
69
|
+
}
|
|
70
|
+
/**
|
|
71
|
+
* Enable or disable a specific hook
|
|
72
|
+
*/
|
|
73
|
+
setHookEnabled(hookName, enabled) {
|
|
74
|
+
const updated = this.entries.filter((entry) => {
|
|
75
|
+
const name = this.getHookName(entry);
|
|
76
|
+
if (name === hookName) {
|
|
77
|
+
entry.enabled = enabled;
|
|
78
|
+
return true;
|
|
79
|
+
}
|
|
80
|
+
return false;
|
|
81
|
+
});
|
|
82
|
+
if (updated.length > 0) {
|
|
83
|
+
debugLogger.log(`${enabled ? 'Enabled' : 'Disabled'} ${updated.length} hook(s) matching "${hookName}"`);
|
|
84
|
+
}
|
|
85
|
+
else {
|
|
86
|
+
debugLogger.warn(`No hooks found matching "${hookName}"`);
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
/**
|
|
90
|
+
* Get hook name for display purposes
|
|
91
|
+
*/
|
|
92
|
+
getHookName(entry) {
|
|
93
|
+
return entry.config.command || 'unknown-command';
|
|
94
|
+
}
|
|
95
|
+
/**
|
|
96
|
+
* Process hooks from the config that was already loaded by the CLI
|
|
97
|
+
*/
|
|
98
|
+
processHooksFromConfig() {
|
|
99
|
+
// Get hooks from the main config (this comes from the merged settings)
|
|
100
|
+
const configHooks = this.config.getHooks();
|
|
101
|
+
if (configHooks) {
|
|
102
|
+
this.processHooksConfiguration(configHooks, ConfigSource.Project);
|
|
103
|
+
}
|
|
104
|
+
// Get hooks from extensions
|
|
105
|
+
const extensions = this.config.getExtensions() || [];
|
|
106
|
+
for (const extension of extensions) {
|
|
107
|
+
if (extension.isActive && extension.hooks) {
|
|
108
|
+
this.processHooksConfiguration(extension.hooks, ConfigSource.Extensions);
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
/**
|
|
113
|
+
* Process hooks configuration and add entries
|
|
114
|
+
*/
|
|
115
|
+
processHooksConfiguration(hooksConfig, source) {
|
|
116
|
+
for (const [eventName, definitions] of Object.entries(hooksConfig)) {
|
|
117
|
+
if (!this.isValidEventName(eventName)) {
|
|
118
|
+
debugLogger.warn(`Invalid hook event name: ${eventName}`);
|
|
119
|
+
continue;
|
|
120
|
+
}
|
|
121
|
+
const typedEventName = eventName;
|
|
122
|
+
if (!Array.isArray(definitions)) {
|
|
123
|
+
debugLogger.warn(`Hook definitions for event "${eventName}" from source "${source}" is not an array. Skipping.`);
|
|
124
|
+
continue;
|
|
125
|
+
}
|
|
126
|
+
for (const definition of definitions) {
|
|
127
|
+
this.processHookDefinition(definition, typedEventName, source);
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
}
|
|
131
|
+
/**
|
|
132
|
+
* Process a single hook definition
|
|
133
|
+
*/
|
|
134
|
+
processHookDefinition(definition, eventName, source) {
|
|
135
|
+
if (!definition ||
|
|
136
|
+
typeof definition !== 'object' ||
|
|
137
|
+
!Array.isArray(definition.hooks)) {
|
|
138
|
+
debugLogger.warn(`Discarding invalid hook definition for ${eventName} from ${source}:`, definition);
|
|
139
|
+
return;
|
|
140
|
+
}
|
|
141
|
+
for (const hookConfig of definition.hooks) {
|
|
142
|
+
if (hookConfig &&
|
|
143
|
+
typeof hookConfig === 'object' &&
|
|
144
|
+
this.validateHookConfig(hookConfig, eventName, source)) {
|
|
145
|
+
this.entries.push({
|
|
146
|
+
config: hookConfig,
|
|
147
|
+
source,
|
|
148
|
+
eventName,
|
|
149
|
+
matcher: definition.matcher,
|
|
150
|
+
sequential: definition.sequential,
|
|
151
|
+
enabled: true,
|
|
152
|
+
});
|
|
153
|
+
}
|
|
154
|
+
else {
|
|
155
|
+
// Invalid hooks are logged and discarded here, they won't reach HookRunner
|
|
156
|
+
debugLogger.warn(`Discarding invalid hook configuration for ${eventName} from ${source}:`, hookConfig);
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
/**
|
|
161
|
+
* Validate a hook configuration
|
|
162
|
+
*/
|
|
163
|
+
validateHookConfig(config, eventName, source) {
|
|
164
|
+
if (!config.type || !['command', 'plugin'].includes(config.type)) {
|
|
165
|
+
debugLogger.warn(`Invalid hook ${eventName} from ${source} type: ${config.type}`);
|
|
166
|
+
return false;
|
|
167
|
+
}
|
|
168
|
+
if (config.type === 'command' && !config.command) {
|
|
169
|
+
debugLogger.warn(`Command hook ${eventName} from ${source} missing command field`);
|
|
170
|
+
return false;
|
|
171
|
+
}
|
|
172
|
+
return true;
|
|
173
|
+
}
|
|
174
|
+
/**
|
|
175
|
+
* Check if an event name is valid
|
|
176
|
+
*/
|
|
177
|
+
isValidEventName(eventName) {
|
|
178
|
+
const validEventNames = Object.values(HookEventName);
|
|
179
|
+
return validEventNames.includes(eventName);
|
|
180
|
+
}
|
|
181
|
+
/**
|
|
182
|
+
* Get source priority (lower number = higher priority)
|
|
183
|
+
*/
|
|
184
|
+
getSourcePriority(source) {
|
|
185
|
+
switch (source) {
|
|
186
|
+
case ConfigSource.Project:
|
|
187
|
+
return 1;
|
|
188
|
+
case ConfigSource.User:
|
|
189
|
+
return 2;
|
|
190
|
+
case ConfigSource.System:
|
|
191
|
+
return 3;
|
|
192
|
+
case ConfigSource.Extensions:
|
|
193
|
+
return 4;
|
|
194
|
+
default:
|
|
195
|
+
return 999;
|
|
196
|
+
}
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
//# sourceMappingURL=hookRegistry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"hookRegistry.js","sourceRoot":"","sources":["../../../src/hooks/hookRegistry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license
|
|
3
|
+
* Copyright 2025 Vybestack LLC
|
|
4
|
+
* SPDX-License-Identifier: Apache-2.0
|
|
5
|
+
*/
|
|
6
|
+
import type { GenerateContentResponse, GenerateContentParameters, ToolConfig } from '@google/genai';
|
|
7
|
+
/**
|
|
8
|
+
* Decoupled LLM request format - stable across LLxprt CLI versions
|
|
9
|
+
*/
|
|
10
|
+
export interface LLMRequest {
|
|
11
|
+
model: string;
|
|
12
|
+
messages: Array<{
|
|
13
|
+
role: 'user' | 'model' | 'system';
|
|
14
|
+
content: string | Array<{
|
|
15
|
+
type: string;
|
|
16
|
+
[key: string]: unknown;
|
|
17
|
+
}>;
|
|
18
|
+
}>;
|
|
19
|
+
config?: {
|
|
20
|
+
temperature?: number;
|
|
21
|
+
maxOutputTokens?: number;
|
|
22
|
+
topP?: number;
|
|
23
|
+
topK?: number;
|
|
24
|
+
stopSequences?: string[];
|
|
25
|
+
candidateCount?: number;
|
|
26
|
+
presencePenalty?: number;
|
|
27
|
+
frequencyPenalty?: number;
|
|
28
|
+
[key: string]: unknown;
|
|
29
|
+
};
|
|
30
|
+
toolConfig?: HookToolConfig;
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Decoupled LLM response format - stable across LLxprt CLI versions
|
|
34
|
+
*/
|
|
35
|
+
export interface LLMResponse {
|
|
36
|
+
text?: string;
|
|
37
|
+
candidates: Array<{
|
|
38
|
+
content: {
|
|
39
|
+
role: 'model';
|
|
40
|
+
parts: string[];
|
|
41
|
+
};
|
|
42
|
+
finishReason?: 'STOP' | 'MAX_TOKENS' | 'SAFETY' | 'RECITATION' | 'OTHER';
|
|
43
|
+
index?: number;
|
|
44
|
+
safetyRatings?: Array<{
|
|
45
|
+
category: string;
|
|
46
|
+
probability: string;
|
|
47
|
+
blocked?: boolean;
|
|
48
|
+
}>;
|
|
49
|
+
}>;
|
|
50
|
+
usageMetadata?: {
|
|
51
|
+
promptTokenCount?: number;
|
|
52
|
+
candidatesTokenCount?: number;
|
|
53
|
+
totalTokenCount?: number;
|
|
54
|
+
};
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* Decoupled tool configuration - stable across LLxprt CLI versions
|
|
58
|
+
*/
|
|
59
|
+
export interface HookToolConfig {
|
|
60
|
+
mode?: 'AUTO' | 'ANY' | 'NONE';
|
|
61
|
+
allowedFunctionNames?: string[];
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Base class for hook translators - handles version-specific translation logic
|
|
65
|
+
*/
|
|
66
|
+
export declare abstract class HookTranslator {
|
|
67
|
+
abstract toHookLLMRequest(sdkRequest: GenerateContentParameters): LLMRequest;
|
|
68
|
+
abstract fromHookLLMRequest(hookRequest: LLMRequest, baseRequest?: GenerateContentParameters): GenerateContentParameters;
|
|
69
|
+
abstract toHookLLMResponse(sdkResponse: GenerateContentResponse): LLMResponse;
|
|
70
|
+
abstract fromHookLLMResponse(hookResponse: LLMResponse): GenerateContentResponse;
|
|
71
|
+
abstract toHookToolConfig(sdkToolConfig: ToolConfig): HookToolConfig;
|
|
72
|
+
abstract fromHookToolConfig(hookToolConfig: HookToolConfig): ToolConfig;
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* Hook translator for GenAI SDK v1.x
|
|
76
|
+
* Handles translation between GenAI SDK types and stable Hook API types
|
|
77
|
+
*/
|
|
78
|
+
export declare class HookTranslatorGenAIv1 extends HookTranslator {
|
|
79
|
+
/**
|
|
80
|
+
* Convert genai SDK GenerateContentParameters to stable LLMRequest
|
|
81
|
+
*
|
|
82
|
+
* Note: This implementation intentionally extracts only text content from parts.
|
|
83
|
+
* Non-text parts (images, function calls, etc.) are filtered out in v1 to provide
|
|
84
|
+
* a simplified, stable interface for hooks. This allows hooks to focus on text
|
|
85
|
+
* manipulation without needing to handle complex multimodal content.
|
|
86
|
+
* Future versions may expose additional content types if needed.
|
|
87
|
+
*/
|
|
88
|
+
toHookLLMRequest(sdkRequest: GenerateContentParameters): LLMRequest;
|
|
89
|
+
/**
|
|
90
|
+
* Convert stable LLMRequest to genai SDK GenerateContentParameters
|
|
91
|
+
*/
|
|
92
|
+
fromHookLLMRequest(hookRequest: LLMRequest, baseRequest?: GenerateContentParameters): GenerateContentParameters;
|
|
93
|
+
/**
|
|
94
|
+
* Convert genai SDK GenerateContentResponse to stable LLMResponse
|
|
95
|
+
*/
|
|
96
|
+
toHookLLMResponse(sdkResponse: GenerateContentResponse): LLMResponse;
|
|
97
|
+
/**
|
|
98
|
+
* Convert stable LLMResponse to genai SDK GenerateContentResponse
|
|
99
|
+
*/
|
|
100
|
+
fromHookLLMResponse(hookResponse: LLMResponse): GenerateContentResponse;
|
|
101
|
+
/**
|
|
102
|
+
* Convert genai SDK ToolConfig to stable HookToolConfig
|
|
103
|
+
*/
|
|
104
|
+
toHookToolConfig(sdkToolConfig: ToolConfig): HookToolConfig;
|
|
105
|
+
/**
|
|
106
|
+
* Convert stable HookToolConfig to genai SDK ToolConfig
|
|
107
|
+
*/
|
|
108
|
+
fromHookToolConfig(hookToolConfig: HookToolConfig): ToolConfig;
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* Default translator instance for current GenAI SDK version
|
|
112
|
+
*/
|
|
113
|
+
export declare const defaultHookTranslator: HookTranslatorGenAIv1;
|