@vybestack/llxprt-code-core 0.5.0-nightly.251108.557a0fe7 → 0.5.0-nightly.251110.c0116408

package/dist/src/providers/openai/ToolCallExecutor.js

@@ -0,0 +1,120 @@
+/**
+ * Copyright 2025 Vybestack LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * ToolCallExecutor - Execute tool calls
+ *
+ * Responsible for executing normalized tool calls and handling execution results.
+ */
+import { DebugLogger } from '../../debug/index.js';
+const logger = new DebugLogger('llxprt:providers:openai:toolCallExecutor');
+/**
+ * ToolCallExecutor - Responsible for executing tool calls
+ */
+export class ToolCallExecutor {
+    toolRegistry = new Map();
+    /**
+     * Register tool function
+     */
+    registerTool(name, fn) {
+        this.toolRegistry.set(name, fn);
+        logger.debug(`Registered tool: ${name}`);
+    }
+    /**
+     * Batch register tool functions
+     */
+    registerTools(tools) {
+        for (const [name, fn] of Object.entries(tools)) {
+            this.registerTool(name, fn);
+        }
+    }
+    /**
+     * Execute single tool call
+     */
+    async execute(normalizedCall) {
+        const startTime = Date.now();
+        try {
+            const toolFn = this.toolRegistry.get(normalizedCall.name);
+            if (!toolFn) {
+                throw new Error(`Tool '${normalizedCall.name}' is not registered`);
+            }
+            logger.debug(`Executing tool call ${normalizedCall.index}: ${normalizedCall.name}`);
+            const result = await toolFn(normalizedCall.args);
+            const executionTime = Date.now() - startTime;
+            logger.debug(`Tool call ${normalizedCall.index} completed in ${executionTime}ms`);
+            return {
+                index: normalizedCall.index,
+                name: normalizedCall.name,
+                success: true,
+                result,
+                executionTime,
+            };
+        }
+        catch (error) {
+            const executionTime = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.error(`Tool call ${normalizedCall.index} failed: ${errorMessage}`);
+            return {
+                index: normalizedCall.index,
+                name: normalizedCall.name,
+                success: false,
+                error: errorMessage,
+                executionTime,
+            };
+        }
+    }
+    /**
+     * Batch execute tool calls
+     */
+    async executeBatch(normalizedCalls) {
+        // Execute sequentially to avoid resource conflicts
+        const results = [];
+        for (const call of normalizedCalls) {
+            const result = await this.execute(call);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Check if tool is registered
+     */
+    isToolRegistered(name) {
+        return this.toolRegistry.has(name);
+    }
+    /**
+     * Get list of registered tool names
+     */
+    getRegisteredTools() {
+        return Array.from(this.toolRegistry.keys());
+    }
+    /**
+     * Remove registered tool
+     */
+    unregisterTool(name) {
+        const removed = this.toolRegistry.delete(name);
+        if (removed) {
+            logger.debug(`Unregistered tool: ${name}`);
+        }
+        return removed;
+    }
+    /**
+     * Clear all registered tools
+     */
+    clearTools() {
+        this.toolRegistry.clear();
+        logger.debug('Cleared all registered tools');
+    }
+}
+//# sourceMappingURL=ToolCallExecutor.js.map

package/dist/src/providers/openai/ToolCallExecutor.js.map

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

package/dist/src/providers/openai/ToolCallNormalizer.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Copyright 2025 Vybestack LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export interface NormalizedToolCall {
+    index: number;
+    name: string;
+    args: Record<string, unknown>;
+    originalArgs?: string;
+}
+/**
+ * ToolCallNormalizer - Responsible for normalizing tool calls
+ */
+export declare class ToolCallNormalizer {
+    /**
+     * Normalize tool calls
+     */
+    normalize(validatedCall: ValidatedToolCall): NormalizedToolCall | null;
+    /**
+     * Normalize tool calls in batch
+     */
+    normalizeBatch(validatedCalls: ValidatedToolCall[]): NormalizedToolCall[];
+    /**
+     * Normalize tool name
+     */
+    private normalizeToolName;
+    /**
+     * Parse arguments string to object
+     */
+    private parseArgs;
+    /**
+     * Validate normalization result
+     */
+    validateNormalized(call: NormalizedToolCall): boolean;
+}
+import { ValidatedToolCall } from './ToolCallValidator.js';

package/dist/src/providers/openai/ToolCallNormalizer.js

@@ -0,0 +1,101 @@
+/**
+ * Copyright 2025 Vybestack LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * ToolCallNormalizer - Normalizes tool calls
+ *
+ * Responsible for normalizing validated tool calls to standard format,
+ * preparing them for execution phase.
+ */
+import { DebugLogger } from '../../debug/index.js';
+const logger = new DebugLogger('llxprt:providers:openai:toolCallNormalizer');
+/**
+ * ToolCallNormalizer - Responsible for normalizing tool calls
+ */
+export class ToolCallNormalizer {
+    /**
+     * Normalize tool calls
+     */
+    normalize(validatedCall) {
+        if (!validatedCall.isValid) {
+            logger.error(`Cannot normalize invalid tool call ${validatedCall.index}`);
+            return null;
+        }
+        try {
+            const normalized = {
+                index: validatedCall.index,
+                name: this.normalizeToolName(validatedCall.name),
+                args: this.parseArgs(validatedCall.args),
+                originalArgs: validatedCall.args,
+            };
+            logger.debug(`Normalized tool call ${validatedCall.index}: ${normalized.name}`);
+            return normalized;
+        }
+        catch (error) {
+            logger.error(`Failed to normalize tool call ${validatedCall.index}: ${error}`);
+            return null;
+        }
+    }
+    /**
+     * Normalize tool calls in batch
+     */
+    normalizeBatch(validatedCalls) {
+        return validatedCalls
+            .map((call) => this.normalize(call))
+            .filter((call) => call !== null);
+    }
+    /**
+     * Normalize tool name
+     */
+    normalizeToolName(name) {
+        // Remove leading/trailing whitespace and convert to lowercase
+        return name.trim().toLowerCase();
+    }
+    /**
+     * Parse arguments string to object
+     */
+    parseArgs(args) {
+        if (!args || !args.trim()) {
+            return {};
+        }
+        try {
+            const parsed = JSON.parse(args);
+            if (typeof parsed === 'object' && parsed !== null) {
+                return parsed;
+            }
+            else {
+                logger.warn('Tool call args is not a valid object, wrapping in {value}');
+                return { value: parsed };
+            }
+        }
+        catch (error) {
+            logger.warn(`Failed to parse tool call args as JSON: ${error}, treating as string`);
+            return { value: args };
+        }
+    }
+    /**
+     * Validate normalization result
+     */
+    validateNormalized(call) {
+        if (!call.name || typeof call.name !== 'string') {
+            return false;
+        }
+        if (!call.args || typeof call.args !== 'object') {
+            return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=ToolCallNormalizer.js.map

package/dist/src/providers/openai/ToolCallNormalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolCallNormalizer.js","sourceRoot":"","sources":["../../../../src/providers/openai/ToolCallNormalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,4CAA4C,CAAC,CAAC;AAS7E;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAC7B;;OAEG;IACH,SAAS,CAAC,aAAgC;QACxC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YAC3B,MAAM,CAAC,KAAK,CAAC,sCAAsC,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC;YAC1E,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,MAAM,UAAU,GAAuB;gBACrC,KAAK,EAAE,aAAa,CAAC,KAAK;gBAC1B,IAAI,EAAE,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,IAAI,CAAC;gBAChD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC;gBACxC,YAAY,EAAE,aAAa,CAAC,IAAI;aACjC,CAAC;YAEF,MAAM,CAAC,KAAK,CACV,wBAAwB,aAAa,CAAC,KAAK,KAAK,UAAU,CAAC,IAAI,EAAE,CAClE,CAAC;YACF,OAAO,UAAU,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CACV,iCAAiC,aAAa,CAAC,KAAK,KAAK,KAAK,EAAE,CACjE,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,cAAmC;QAChD,OAAO,cAAc;aAClB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;aACnC,MAAM,CAAC,CAAC,IAAI,EAA8B,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,IAAY;QACpC,8DAA8D;QAC9D,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,IAAa;QAC7B,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBAClD,OAAO,MAAM,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CACT,2DAA2D,CAC5D,CAAC;gBACF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YAC3B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CACT,2CAA2C,KAAK,sBAAsB,CACvE,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,IAAwB;QACzC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/src/providers/openai/ToolCallPipeline.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Copyright 2025 Vybestack LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { ValidatedToolCall } from './ToolCallValidator.js';
+import { NormalizedToolCall } from './ToolCallNormalizer.js';
+import { ToolExecutionResult, ToolFunction } from './ToolCallExecutor.js';
+export interface PipelineResult {
+    executed: ToolExecutionResult[];
+    normalized: NormalizedToolCall[];
+    failed: ValidatedToolCall[];
+    stats: {
+        collected: number;
+        validated: number;
+        normalized: number;
+        executed: number;
+        failed: number;
+    };
+}
+/**
+ * ToolCallPipeline - Complete tool call processing pipeline
+ */
+export declare class ToolCallPipeline {
+    private collector;
+    private validator;
+    private normalizer;
+    private executor;
+    constructor(allowedToolNames?: string[]);
+    /**
+     * Add tool call fragment
+     */
+    addFragment(index: number, fragment: Partial<ToolCallFragment>): void;
+    /**
+     * Process all collected tool calls
+     */
+    process(): Promise<PipelineResult>;
+    /**
+     * Register tool function
+     */
+    registerTool(name: string, fn: ToolFunction): void;
+    /**
+     * Register tool functions in batch
+     */
+    registerTools(tools: Record<string, ToolFunction>): void;
+    /**
+     * Check if tool is registered
+     */
+    isToolRegistered(name: string): boolean;
+    /**
+     * Get pipeline statistics
+     */
+    getStats(): {
+        collector: {
+            totalCalls: number;
+            completedCalls: number;
+            pendingFragments: number;
+        };
+        registeredTools: number;
+    };
+    /**
+     * Normalize single tool name (for non-streaming path)
+     */
+    normalizeToolName(name: string, args?: string): string;
+    /**
+     * Reset pipeline state
+     */
+    reset(): void;
+}
+import { ToolCallFragment } from './ToolCallCollector.js';

package/dist/src/providers/openai/ToolCallPipeline.js

@@ -0,0 +1,137 @@
+/**
+ * Copyright 2025 Vybestack LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * ToolCallPipeline - Tool call processing pipeline
+ *
+ * Integrated solution for collection, validation, normalization, and execution phases.
+ * Replaces the original accumulation logic, providing reliable ToolCalls processing.
+ */
+import { DebugLogger } from '../../debug/index.js';
+import { ToolCallCollector } from './ToolCallCollector.js';
+import { ToolCallValidator } from './ToolCallValidator.js';
+import { ToolCallNormalizer, } from './ToolCallNormalizer.js';
+import { ToolCallExecutor, } from './ToolCallExecutor.js';
+const logger = new DebugLogger('llxprt:providers:openai:toolCallPipeline');
+/**
+ * ToolCallPipeline - Complete tool call processing pipeline
+ */
+export class ToolCallPipeline {
+    collector;
+    validator;
+    normalizer;
+    executor;
+    constructor(allowedToolNames = []) {
+        this.collector = new ToolCallCollector();
+        this.validator = new ToolCallValidator(allowedToolNames);
+        this.normalizer = new ToolCallNormalizer();
+        this.executor = new ToolCallExecutor();
+    }
+    /**
+     * Add tool call fragment
+     */
+    addFragment(index, fragment) {
+        this.collector.addFragment(index, fragment);
+    }
+    /**
+     * Process all collected tool calls
+     */
+    async process() {
+        logger.debug('Starting tool call pipeline processing');
+        // Phase 1: Collect complete calls
+        const candidates = this.collector.getCompleteCalls();
+        logger.debug(`Collected ${candidates.length} complete tool calls`);
+        // Phase 2: Validate calls
+        const validatedCalls = this.validator.validateBatch(candidates);
+        const validCalls = validatedCalls.filter((call) => call.isValid);
+        const invalidCalls = validatedCalls.filter((call) => !call.isValid);
+        logger.debug(`Validated ${validCalls.length} valid, ${invalidCalls.length} invalid tool calls`);
+        // Phase 3: Normalize calls
+        const normalizedCalls = this.normalizer.normalizeBatch(validCalls);
+        logger.debug(`Normalized ${normalizedCalls.length} tool calls`);
+        // Phase 4: Execute calls
+        const executionResults = await this.executor.executeBatch(normalizedCalls);
+        const successfulResults = executionResults.filter((result) => result.success);
+        const failedResults = executionResults.filter((result) => !result.success);
+        logger.debug(`Executed ${successfulResults.length} successful, ${failedResults.length} failed tool calls`);
+        // Reset collector for next batch
+        this.collector.reset();
+        const result = {
+            executed: executionResults,
+            normalized: normalizedCalls,
+            failed: invalidCalls,
+            stats: {
+                collected: candidates.length,
+                validated: validCalls.length,
+                normalized: normalizedCalls.length,
+                executed: successfulResults.length,
+                failed: invalidCalls.length + failedResults.length,
+            },
+        };
+        logger.debug(`Pipeline processing completed: ${JSON.stringify(result.stats)}`);
+        return result;
+    }
+    /**
+     * Register tool function
+     */
+    registerTool(name, fn) {
+        this.executor.registerTool(name, fn);
+        this.validator.updateAllowedTools(this.executor.getRegisteredTools());
+    }
+    /**
+     * Register tool functions in batch
+     */
+    registerTools(tools) {
+        this.executor.registerTools(tools);
+        this.validator.updateAllowedTools(this.executor.getRegisteredTools());
+    }
+    /**
+     * Check if tool is registered
+     */
+    isToolRegistered(name) {
+        return this.executor.isToolRegistered(name);
+    }
+    /**
+     * Get pipeline statistics
+     */
+    getStats() {
+        return {
+            collector: this.collector.getStats(),
+            registeredTools: this.executor.getRegisteredTools().length,
+        };
+    }
+    /**
+     * Normalize single tool name (for non-streaming path)
+     */
+    normalizeToolName(name, args) {
+        const mockValidatedCall = {
+            index: 0,
+            name: name || '',
+            args: args || '',
+            isValid: true,
+            validationErrors: [],
+        };
+        const normalized = this.normalizer.normalize(mockValidatedCall);
+        return normalized?.name || name || '';
+    }
+    /**
+     * Reset pipeline state
+     */
+    reset() {
+        this.collector.reset();
+        logger.debug('ToolCallPipeline reset');
+    }
+}
+//# sourceMappingURL=ToolCallPipeline.js.map

package/dist/src/providers/openai/ToolCallPipeline.js.map

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

package/dist/src/providers/openai/ToolCallValidator.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Copyright 2025 Vybestack LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export interface ValidatedToolCall {
+    index: number;
+    name: string;
+    args?: string;
+    isValid: boolean;
+    validationErrors: string[];
+}
+/**
+ * ToolCallValidator - The verification tool calls the candidates.
+ */
+export declare class ToolCallValidator {
+    private allowedToolNames;
+    constructor(allowedToolNames?: string[]);
+    /**
+     * Validate tool call candidate
+     */
+    validate(candidate: ToolCallCandidate): ValidatedToolCall;
+    /**
+     * Batch validate tool call candidates
+     */
+    validateBatch(candidates: ToolCallCandidate[]): ValidatedToolCall[];
+    /**
+     * Check if tool name is valid
+     */
+    private isValidToolName;
+    /**
+     * Check if parameters are valid JSON
+     */
+    private isValidArgs;
+    /**
+     * Update allowed tool names list
+     */
+    updateAllowedTools(allowedToolNames: string[]): void;
+}
+import { ToolCallCandidate } from './ToolCallCollector.js';

package/dist/src/providers/openai/ToolCallValidator.js

@@ -0,0 +1,108 @@
+/**
+ * Copyright 2025 Vybestack LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * ToolCallValidator - Validates tool call candidates
+ *
+ * Responsible for validating collected tool call candidates to ensure they are valid
+ * and meet execution requirements.
+ */
+import { DebugLogger } from '../../debug/index.js';
+const logger = new DebugLogger('llxprt:providers:openai:toolCallValidator');
+/**
+ * ToolCallValidator - The verification tool calls the candidates.
+ */
+export class ToolCallValidator {
+    allowedToolNames;
+    constructor(allowedToolNames = []) {
+        this.allowedToolNames = new Set(allowedToolNames);
+    }
+    /**
+     * Validate tool call candidate
+     */
+    validate(candidate) {
+        const result = {
+            index: candidate.index,
+            name: candidate.name || '',
+            args: candidate.args,
+            isValid: true,
+            validationErrors: [],
+        };
+        const errors = [];
+        // Check if name exists
+        if (!candidate.name || !candidate.name.trim()) {
+            errors.push('Tool call missing name');
+            result.isValid = false;
+        }
+        // Check if name is in allowed list
+        if (candidate.name &&
+            this.allowedToolNames.size > 0 &&
+            !this.allowedToolNames.has(candidate.name)) {
+            errors.push(`Tool name '${candidate.name}' is not in allowed list`);
+            result.isValid = false;
+        }
+        // Check name format
+        if (candidate.name && !this.isValidToolName(candidate.name)) {
+            errors.push(`Tool name '${candidate.name}' contains invalid characters`);
+            result.isValid = false;
+        }
+        // Check parameter format
+        if (candidate.args && !this.isValidArgs(candidate.args)) {
+            errors.push('Tool call arguments are not valid JSON');
+            result.isValid = false;
+        }
+        result.validationErrors = errors;
+        if (!result.isValid) {
+            logger.warn(`Tool call ${candidate.index} validation failed: ${errors.join(', ')}`);
+        }
+        else {
+            logger.debug(`Tool call ${candidate.index} validation passed`);
+        }
+        return result;
+    }
+    /**
+     * Batch validate tool call candidates
+     */
+    validateBatch(candidates) {
+        return candidates.map((candidate) => this.validate(candidate));
+    }
+    /**
+     * Check if tool name is valid
+     */
+    isValidToolName(name) {
+        // Allow letters, numbers, underscores and hyphens
+        return /^[a-zA-Z0-9_-]+$/.test(name);
+    }
+    /**
+     * Check if parameters are valid JSON
+     */
+    isValidArgs(args) {
+        try {
+            JSON.parse(args);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Update allowed tool names list
+     */
+    updateAllowedTools(allowedToolNames) {
+        this.allowedToolNames = new Set(allowedToolNames);
+        logger.debug(`Updated allowed tool names: ${allowedToolNames.join(', ')}`);
+    }
+}
+//# sourceMappingURL=ToolCallValidator.js.map

package/dist/src/providers/openai/ToolCallValidator.js.map

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