@just-every/ensemble 0.2.87 → 0.2.88

package/dist/cjs/utils/test_utils.cjs

@@ -0,0 +1,212 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamAssertions = exports.EnhancedRequestMock = void 0;
+exports.createMockContext = createMockContext;
+const vitest_1 = require("vitest");
+class EnhancedRequestMock {
+    responses;
+    callIndex = 0;
+    constructor(responses) {
+        this.responses = Array.isArray(responses) ? responses : [responses];
+    }
+    getMock() {
+        return (model, messages, options) => {
+            return this.createAsyncGenerator(options);
+        };
+    }
+    async *createAsyncGenerator(options) {
+        for (const response of this.responses) {
+            if (response.delay) {
+                await new Promise(resolve => setTimeout(resolve, response.delay));
+            }
+            if (response.error) {
+                const error = typeof response.error === 'string' ? new Error(response.error) : response.error;
+                yield {
+                    type: 'error',
+                    error: error.message,
+                    timestamp: new Date().toISOString(),
+                };
+                return;
+            }
+            if (response.thinking && options?.includeThinking) {
+                yield {
+                    type: 'thinking_start',
+                    timestamp: new Date().toISOString(),
+                };
+                const chunks = response.thinking.match(/.{1,10}/g) || [];
+                for (const chunk of chunks) {
+                    yield {
+                        type: 'thinking_delta',
+                        delta: chunk,
+                        timestamp: new Date().toISOString(),
+                    };
+                }
+                yield {
+                    type: 'thinking_complete',
+                    content: response.thinking,
+                    timestamp: new Date().toISOString(),
+                };
+            }
+            if (response.message) {
+                yield {
+                    type: 'message_start',
+                    timestamp: new Date().toISOString(),
+                };
+                const chunks = response.message.match(/.{1,5}/g) || [];
+                for (const chunk of chunks) {
+                    yield {
+                        type: 'text_delta',
+                        delta: chunk,
+                        timestamp: new Date().toISOString(),
+                    };
+                }
+                yield {
+                    type: 'message_complete',
+                    content: response.message,
+                    timestamp: new Date().toISOString(),
+                };
+            }
+            if (response.toolCalls && response.toolCalls.length > 0) {
+                const toolCallEvents = response.toolCalls.map((call, index) => ({
+                    id: `call_${Date.now()}_${index}`,
+                    type: 'function',
+                    function: {
+                        name: call.name,
+                        arguments: JSON.stringify(call.arguments),
+                    },
+                }));
+                yield {
+                    type: 'tool_start',
+                    tool_call: toolCallEvents,
+                    timestamp: new Date().toISOString(),
+                };
+                if (options?.onToolCall) {
+                    for (const call of toolCallEvents) {
+                        options.onToolCall(call);
+                    }
+                }
+            }
+        }
+        yield {
+            type: 'stream_end',
+            timestamp: new Date().toISOString(),
+        };
+    }
+    static success(message = 'Success', result = 'Task completed') {
+        return new EnhancedRequestMock({
+            message,
+            toolCalls: [{ name: 'task_complete', arguments: { result } }],
+        });
+    }
+    static error(message = 'Error occurred', error = 'Task failed') {
+        return new EnhancedRequestMock({
+            message,
+            toolCalls: [{ name: 'task_fatal_error', arguments: { error } }],
+        });
+    }
+    static throws(error) {
+        return new EnhancedRequestMock({
+            error: typeof error === 'string' ? new Error(error) : error,
+        });
+    }
+    static thinking(thinking, message) {
+        return new EnhancedRequestMock({
+            thinking,
+            message,
+        });
+    }
+    static toolCalls(...calls) {
+        return new EnhancedRequestMock({
+            message: '',
+            toolCalls: calls,
+        });
+    }
+    static sequence(...responses) {
+        return new EnhancedRequestMock(responses);
+    }
+}
+exports.EnhancedRequestMock = EnhancedRequestMock;
+function createMockContext(overrides = {}) {
+    return {
+        shouldContinue: true,
+        metadata: {},
+        toolCallCount: 0,
+        turnCount: 0,
+        startTime: Date.now(),
+        messages: [],
+        isPaused: false,
+        isHalted: false,
+        halt: vitest_1.vi.fn(function () {
+            this.shouldContinue = false;
+            this.isHalted = true;
+        }),
+        pause: vitest_1.vi.fn(function () {
+            this.isPaused = true;
+        }),
+        resume: vitest_1.vi.fn(function () {
+            this.isPaused = false;
+        }),
+        setMetadata: vitest_1.vi.fn(function (key, value) {
+            this.metadata[key] = value;
+        }),
+        getMetadata: vitest_1.vi.fn(function (key) {
+            return this.metadata[key];
+        }),
+        addMessage: vitest_1.vi.fn(function (message) {
+            this.messages.push(message);
+        }),
+        getHistory: vitest_1.vi.fn(function () {
+            return this.messages;
+        }),
+        ...overrides,
+    };
+}
+class StreamAssertions {
+    events = [];
+    constructor(eventGenerator) {
+        (async () => {
+            for await (const event of eventGenerator) {
+                this.events.push(event);
+            }
+        })();
+    }
+    async waitForCompletion() {
+        await new Promise(resolve => setTimeout(resolve, 100));
+    }
+    hasEvent(type) {
+        return this.events.some(e => e.type === type);
+    }
+    getEvents(type) {
+        return this.events.filter(e => e.type === type);
+    }
+    hasToolCall(name) {
+        const toolEvents = this.getEvents('tool_start');
+        return toolEvents.some(event => {
+            if ('tool_call' in event && event.tool_call) {
+                return event.tool_call.function.name === name;
+            }
+            return false;
+        });
+    }
+    getFinalMessage() {
+        const messageEvents = this.getEvents('message_complete');
+        if (messageEvents.length > 0) {
+            const lastEvent = messageEvents[messageEvents.length - 1];
+            return 'content' in lastEvent ? lastEvent.content : undefined;
+        }
+        return undefined;
+    }
+    hasError() {
+        return this.hasEvent('error');
+    }
+    getError() {
+        const errorEvents = this.getEvents('error');
+        if (errorEvents.length > 0) {
+            const errorEvent = errorEvents[0];
+            return 'error' in errorEvent ? errorEvent.error : undefined;
+        }
+        return undefined;
+    }
+}
+exports.StreamAssertions = StreamAssertions;
+//# sourceMappingURL=test_utils.js.map

package/dist/cjs/utils/test_utils.d.ts

@@ -0,0 +1,58 @@
+import { ProviderStreamEvent, ToolCall } from "../types/types.cjs";
+export interface MockToolCall {
+    name: string;
+    arguments: Record<string, any>;
+}
+export interface MockResponse {
+    message?: string;
+    toolCalls?: MockToolCall[];
+    error?: Error | string;
+    delay?: number;
+    thinking?: string;
+}
+export interface MockStreamOptions {
+    onToolCall?: (call: ToolCall) => void;
+    includeThinking?: boolean;
+}
+export declare class EnhancedRequestMock {
+    private responses;
+    private callIndex;
+    constructor(responses: MockResponse | MockResponse[]);
+    getMock(): (model: string, messages: any, options: any) => AsyncGenerator<ProviderStreamEvent, any, any>;
+    private createAsyncGenerator;
+    static success(message?: string, result?: string): EnhancedRequestMock;
+    static error(message?: string, error?: string): EnhancedRequestMock;
+    static throws(error: Error | string): EnhancedRequestMock;
+    static thinking(thinking: string, message: string): EnhancedRequestMock;
+    static toolCalls(...calls: MockToolCall[]): EnhancedRequestMock;
+    static sequence(...responses: MockResponse[]): EnhancedRequestMock;
+}
+export declare function createMockContext(overrides?: Partial<any>): {
+    shouldContinue: boolean;
+    metadata: {};
+    toolCallCount: number;
+    turnCount: number;
+    startTime: number;
+    messages: any[];
+    isPaused: boolean;
+    isHalted: boolean;
+    halt: import("vitest").Mock<() => void>;
+    pause: import("vitest").Mock<() => void>;
+    resume: import("vitest").Mock<() => void>;
+    setMetadata: import("vitest").Mock<(key: string, value: any) => void>;
+    getMetadata: import("vitest").Mock<(key: string) => any>;
+    addMessage: import("vitest").Mock<(message: any) => void>;
+    getHistory: import("vitest").Mock<() => any>;
+};
+export declare class StreamAssertions {
+    private events;
+    constructor(eventGenerator: AsyncGenerator<ProviderStreamEvent>);
+    waitForCompletion(): Promise<void>;
+    hasEvent(type: string): boolean;
+    getEvents(type: string): ProviderStreamEvent[];
+    hasToolCall(name: string): boolean;
+    getFinalMessage(): string | undefined;
+    hasError(): boolean;
+    getError(): string | undefined;
+}
+//# sourceMappingURL=test_utils.d.ts.map

package/dist/cjs/utils/test_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_utils.d.ts","sourceRoot":"","sources":["../../../utils/test_utils.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlE,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAC9B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;IACtC,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAKD,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,SAAS,CAAK;gBAEV,SAAS,EAAE,YAAY,GAAG,YAAY,EAAE;IAOpD,OAAO,KACK,OAAO,MAAM,EAAE,UAAU,GAAG,EAAE,SAAS,GAAG;YAQvC,oBAAoB;IAoGnC,MAAM,CAAC,OAAO,CAAC,OAAO,SAAY,EAAE,MAAM,SAAmB;IAO7D,MAAM,CAAC,KAAK,CAAC,OAAO,SAAmB,EAAE,KAAK,SAAgB;IAO9D,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IAMnC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAOjD,MAAM,CAAC,SAAS,CAAC,GAAG,KAAK,EAAE,YAAY,EAAE;IAOzC,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS,EAAE,YAAY,EAAE;CAG/C;AAKD,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,OAAO,CAAC,GAAG,CAAM;;;;;;;;;;;;6CAwBpB,MAAM,SAAS,GAAG;6CAIlB,MAAM;gDAIH,GAAG;;EAU/C;AAKD,qBAAa,gBAAgB;IACzB,OAAO,CAAC,MAAM,CAA6B;gBAE/B,cAAc,EAAE,cAAc,CAAC,mBAAmB,CAAC;IAYzD,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAQxC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAO/B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,EAAE;IAO9C,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAalC,eAAe,IAAI,MAAM,GAAG,SAAS;IAYrC,QAAQ,IAAI,OAAO;IAOnB,QAAQ,IAAI,MAAM,GAAG,SAAS;CAQjC"}

package/dist/cjs/utils/test_utils.js.map

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

package/dist/cjs/utils/tool_execution_manager.cjs

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.timeoutPromise = timeoutPromise;
+exports.agentHasStatusTracking = agentHasStatusTracking;
+exports.executeToolWithLifecycle = executeToolWithLifecycle;
+exports.handleToolCall = handleToolCall;
+exports.prepareToolArguments = prepareToolArguments;
+const uuid_1 = require("uuid");
+const running_tool_tracker_js_1 = require("./running_tool_tracker.cjs");
+const sequential_queue_js_1 = require("./sequential_queue.cjs");
+const tool_parameter_utils_js_1 = require("./tool_parameter_utils.cjs");
+const tool_execution_js_1 = require("../config/tool_execution.cjs");
+function timeoutPromise(ms) {
+    return new Promise(resolve => {
+        setTimeout(() => resolve('TIMEOUT'), ms);
+    });
+}
+function agentHasStatusTracking(agent) {
+    if (!agent.tools)
+        return false;
+    return agent.tools.some(tool => tool_execution_js_1.STATUS_TRACKING_TOOLS.has(tool.definition.function.name));
+}
+async function executeToolWithLifecycle(toolCall, tool, agent, signal) {
+    const fnId = toolCall.id || (0, uuid_1.v4)();
+    const toolName = toolCall.function.name;
+    const argsString = toolCall.function.arguments || '{}';
+    let args;
+    try {
+        args = prepareToolArguments(argsString, tool);
+    }
+    catch (error) {
+        throw new Error(`Invalid JSON in tool arguments: ${error}`);
+    }
+    const runningTool = running_tool_tracker_js_1.runningToolTracker.addRunningTool(fnId, toolName, agent.agent_id || 'unknown', argsString);
+    const abortSignal = signal || runningTool.abortController?.signal;
+    try {
+        if (tool.injectAgentId) {
+            args.unshift(agent.agent_id || 'ensemble');
+        }
+        if (tool.injectAbortSignal && abortSignal) {
+            args.push(abortSignal);
+        }
+        const result = await tool.function(...args);
+        await running_tool_tracker_js_1.runningToolTracker.completeRunningTool(fnId, String(result), agent);
+        return String(result);
+    }
+    catch (error) {
+        await running_tool_tracker_js_1.runningToolTracker.failRunningTool(fnId, String(error), agent);
+        throw error;
+    }
+}
+async function handleToolCall(toolCall, tool, agent) {
+    const fnId = toolCall.id || (0, uuid_1.v4)();
+    const toolName = toolCall.function.name;
+    const executeFunction = async () => {
+        if (toolName === 'wait_for_running_tool') {
+            return executeToolWithLifecycle(toolCall, tool, agent);
+        }
+        return Promise.race([
+            executeToolWithLifecycle(toolCall, tool, agent),
+            new Promise((_, reject) => {
+                const runningTool = running_tool_tracker_js_1.runningToolTracker.getRunningTool(fnId);
+                if (runningTool?.abortController?.signal) {
+                    runningTool.abortController.signal.addEventListener('abort', () => reject(new Error('Operation was aborted')), { once: true });
+                }
+            }),
+        ]);
+    };
+    const sequential = !!agent.modelSettings?.sequential_tools;
+    const hasStatusTools = agentHasStatusTracking(agent);
+    const excludedFromTimeout = tool_execution_js_1.EXCLUDED_FROM_TIMEOUT_FUNCTIONS.has(toolName);
+    const shouldTimeout = !excludedFromTimeout && hasStatusTools && !sequential;
+    const execute = sequential ? () => (0, sequential_queue_js_1.runSequential)(agent.agent_id || 'unknown', executeFunction) : executeFunction;
+    if (!shouldTimeout) {
+        return execute();
+    }
+    const result = await Promise.race([
+        execute().catch(error => {
+            throw error;
+        }),
+        timeoutPromise(tool_execution_js_1.FUNCTION_TIMEOUT_MS),
+    ]);
+    if (result === 'TIMEOUT') {
+        running_tool_tracker_js_1.runningToolTracker.markTimedOut(fnId);
+        return `Tool ${toolName} is running in the background (RunningTool: ${fnId}).`;
+    }
+    return result;
+}
+function prepareToolArguments(argsString, tool) {
+    let args;
+    try {
+        if (!argsString || argsString.trim() === '') {
+            args = {};
+        }
+        else {
+            args = JSON.parse(argsString);
+        }
+    }
+    catch (error) {
+        throw new Error(`Invalid JSON in tool arguments: ${error}`);
+    }
+    if (typeof args === 'object' && args !== null && !Array.isArray(args)) {
+        const paramNames = Object.keys(tool.definition.function.parameters.properties);
+        Object.keys(args).forEach(key => {
+            if (!paramNames.includes(key)) {
+                console.warn(`Removing unknown parameter "${key}" for tool "${tool.definition.function.name}"`);
+                delete args[key];
+            }
+        });
+        if (paramNames.length > 0) {
+            return paramNames.map(param => {
+                const value = args[param];
+                const paramSpec = tool.definition.function.parameters.properties[param];
+                if ((value === undefined || value === '') &&
+                    !tool.definition.function.parameters.required?.includes(param)) {
+                    return undefined;
+                }
+                const [coercedValue, error] = (0, tool_parameter_utils_js_1.coerceValue)(value, paramSpec, param);
+                if (error && tool.definition.function.parameters.required?.includes(param)) {
+                    throw new Error(JSON.stringify({
+                        error: {
+                            param,
+                            expected: paramSpec.type + (paramSpec.items?.type ? `<${paramSpec.items.type}>` : ''),
+                            received: String(value),
+                            message: error,
+                        },
+                    }));
+                }
+                else if (error) {
+                    console.warn(`Parameter coercion warning for ${param}: ${error}`);
+                }
+                return coercedValue;
+            });
+        }
+        return Object.values(args);
+    }
+    return [args];
+}
+//# sourceMappingURL=tool_execution_manager.js.map

package/dist/cjs/utils/tool_execution_manager.d.ts

@@ -0,0 +1,7 @@
+import { ToolCall, ToolFunction, AgentDefinition } from "../types/types.cjs";
+export declare function timeoutPromise(ms: number): Promise<'TIMEOUT'>;
+export declare function agentHasStatusTracking(agent: AgentDefinition): boolean;
+export declare function executeToolWithLifecycle(toolCall: ToolCall, tool: ToolFunction, agent: AgentDefinition, signal?: AbortSignal): Promise<string>;
+export declare function handleToolCall(toolCall: ToolCall, tool: ToolFunction, agent: AgentDefinition): Promise<string>;
+export declare function prepareToolArguments(argsString: string, tool: ToolFunction): any[];
+//# sourceMappingURL=tool_execution_manager.d.ts.map

package/dist/cjs/utils/tool_execution_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_execution_manager.d.ts","sourceRoot":"","sources":["../../../utils/tool_execution_manager.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAa5E,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAI7D;AAKD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAItE;AAKD,wBAAsB,wBAAwB,CAC1C,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,eAAe,EACtB,MAAM,CAAC,EAAE,WAAW,GACrB,OAAO,CAAC,MAAM,CAAC,CAwCjB;AAKD,wBAAsB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAuDpH;AAKD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,GAAG,EAAE,CAmElF"}

package/dist/cjs/utils/tool_execution_manager.js.map

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

package/dist/cjs/utils/tool_parameter_utils.cjs

@@ -0,0 +1,168 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.coerceValue = coerceValue;
+exports.extractParameterNames = extractParameterNames;
+exports.mapNamedToPositionalArgs = mapNamedToPositionalArgs;
+function coerceValue(value, paramSpec, paramName) {
+    const expectedType = paramSpec.type || 'string';
+    if (value === undefined || value === null) {
+        if (paramSpec.default) {
+            return [paramSpec.default, null];
+        }
+        if (paramSpec.optional) {
+            return [undefined, null];
+        }
+        return [null, `Required parameter "${paramName}" is missing`];
+    }
+    if (value === '' && paramSpec.optional) {
+        return [undefined, null];
+    }
+    const actualType = Array.isArray(value) ? 'array' : typeof value;
+    switch (expectedType) {
+        case 'string':
+            if (actualType === 'string') {
+                return [value, null];
+            }
+            return [String(value), null];
+        case 'number':
+            if (actualType === 'number') {
+                return [value, null];
+            }
+            if (actualType === 'string') {
+                const num = Number(value);
+                if (!isNaN(num)) {
+                    return [num, null];
+                }
+                return [null, `Cannot convert "${value}" to number`];
+            }
+            return [null, `Expected number but got ${actualType}`];
+        case 'boolean':
+            if (actualType === 'boolean') {
+                return [value, null];
+            }
+            if (actualType === 'string') {
+                const lower = value.toLowerCase();
+                if (lower === 'true')
+                    return [true, null];
+                if (lower === 'false')
+                    return [false, null];
+                return [null, `Cannot convert "${value}" to boolean`];
+            }
+            if (actualType === 'number') {
+                return [value !== 0, null];
+            }
+            return [null, `Expected boolean but got ${actualType}`];
+        case 'array':
+            if (actualType === 'array') {
+                return [value, null];
+            }
+            if (actualType === 'string') {
+                try {
+                    const parsed = JSON.parse(value);
+                    if (Array.isArray(parsed)) {
+                        return [parsed, null];
+                    }
+                }
+                catch {
+                    if (value.includes(',')) {
+                        return [value.split(',').map(s => s.trim()), null];
+                    }
+                }
+                return [[value], null];
+            }
+            return [[value], null];
+        case 'object':
+            if (actualType === 'object' && !Array.isArray(value)) {
+                return [value, null];
+            }
+            if (actualType === 'string') {
+                try {
+                    const parsed = JSON.parse(value);
+                    if (typeof parsed === 'object' && !Array.isArray(parsed)) {
+                        return [parsed, null];
+                    }
+                }
+                catch {
+                    return [null, `Cannot parse "${value}" as object`];
+                }
+            }
+            return [null, `Expected object but got ${actualType}`];
+        case 'null':
+            return [null, null];
+        default:
+            return [value, null];
+    }
+}
+function extractParameterNames(func) {
+    const funcStr = func.toString();
+    const cleanFuncStr = funcStr.replaceAll(/\n\s*/g, ' ');
+    const paramMatch = cleanFuncStr.match(/\(([^)]*)\)/);
+    if (!paramMatch || !paramMatch[1]) {
+        return [];
+    }
+    const params = paramMatch[1]
+        .split(',')
+        .map(p => p.trim())
+        .filter(Boolean);
+    const paramNames = [];
+    for (const param of params) {
+        let paramName = param;
+        if (paramName.includes('=')) {
+            paramName = paramName.split('=')[0].trim();
+        }
+        if (paramName.includes(':')) {
+            paramName = paramName.split(':')[0].trim();
+        }
+        if (paramName.startsWith('...')) {
+            paramName = paramName.substring(3);
+        }
+        if (paramName === 'inject_agent_id' || paramName === 'abort_signal') {
+            continue;
+        }
+        paramNames.push(paramName);
+    }
+    return paramNames;
+}
+function mapNamedToPositionalArgs(namedArgs, tool, injectAgentId, abortSignal) {
+    const paramNames = extractParameterNames(tool.function);
+    const paramSpecs = tool.definition.function.parameters.properties || {};
+    const requiredParams = tool.definition.function.parameters.required || [];
+    Object.keys(namedArgs).forEach(key => {
+        if (!paramNames.includes(key)) {
+            console.warn(`Removing unknown parameter "${key}" for tool "${tool.definition.function.name}"`);
+            delete namedArgs[key];
+        }
+    });
+    const positionalArgs = [];
+    for (const paramName of paramNames) {
+        const value = namedArgs[paramName];
+        const paramSpec = paramSpecs[paramName] || { type: 'string' };
+        if ((value === undefined || value === '') && !requiredParams.includes(paramName)) {
+            positionalArgs.push(undefined);
+            continue;
+        }
+        const [coercedValue, error] = coerceValue(value, paramSpec, paramName);
+        if (error && requiredParams.includes(paramName)) {
+            throw new Error(JSON.stringify({
+                error: {
+                    param: paramName,
+                    expected: paramSpec.type + (paramSpec.items?.type ? `<${paramSpec.items.type}>` : ''),
+                    received: String(value),
+                    message: error,
+                },
+            }));
+        }
+        else if (error) {
+            console.warn(`Parameter coercion warning for ${paramName}: ${error}`);
+        }
+        positionalArgs.push(coercedValue);
+    }
+    if (tool.injectAgentId && injectAgentId) {
+        positionalArgs.unshift(injectAgentId);
+    }
+    if (tool.injectAbortSignal && abortSignal) {
+        positionalArgs.push(abortSignal);
+    }
+    return positionalArgs;
+}
+//# sourceMappingURL=tool_parameter_utils.js.map

package/dist/cjs/utils/tool_parameter_utils.d.ts

@@ -0,0 +1,5 @@
+import { ToolParameter } from "../types/types.cjs";
+export declare function coerceValue(value: any, paramSpec: ToolParameter, paramName: string): [any, string | null];
+export declare function extractParameterNames(func: (...args: any[]) => any): string[];
+export declare function mapNamedToPositionalArgs(namedArgs: Record<string, any>, tool: any, injectAgentId?: string, abortSignal?: AbortSignal): any[];
+//# sourceMappingURL=tool_parameter_utils.d.ts.map

package/dist/cjs/utils/tool_parameter_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool_parameter_utils.d.ts","sourceRoot":"","sources":["../../../utils/tool_parameter_utils.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAMlD,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC,CAsGzG;AAKD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,MAAM,EAAE,CA6C7E;AAKD,wBAAgB,wBAAwB,CACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC9B,IAAI,EAAE,GAAG,EACT,aAAa,CAAC,EAAE,MAAM,EACtB,WAAW,CAAC,EAAE,WAAW,GAC1B,GAAG,EAAE,CA0DP"}

package/dist/cjs/utils/tool_parameter_utils.js.map

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